From 2bee5b994f002776ea7718cb1c32e3cc36e22c38 Mon Sep 17 00:00:00 2001 From: Chiedo John <2156688+chiedo@users.noreply.github.com> Date: Fri, 16 Oct 2020 13:26:58 -0400 Subject: [PATCH] Crowdin translations (translation-batch-160285210) (#16087) * New Crowdin translations by Github Action * Remove bad translations * Remove broken translations * Remove more broken files * Remove broken translation * Remove broken translations * Remove broken translations * Add english versions of broken translations Co-authored-by: Crowdin Bot Co-authored-by: Chiedo --- .../actions/creating-actions/about-actions.md | 38 +- .../creating-a-composite-run-steps-action.md | 23 +- .../creating-a-docker-container-action.md | 2 +- .../creating-a-javascript-action.md | 12 +- .../content/actions/creating-actions/index.md | 3 +- .../metadata-syntax-for-github-actions.md | 10 +- .../setting-exit-codes-for-actions.md | 2 +- .../guides/about-continuous-integration.md | 63 + .../about-packaging-with-github-actions.md | 47 + .../guides/about-service-containers.md | 117 ++ .../building-and-testing-java-with-ant.md | 109 ++ .../building-and-testing-java-with-gradle.md | 134 ++ .../building-and-testing-java-with-maven.md | 135 ++ .../guides/building-and-testing-nodejs.md | 276 ++++ .../guides/building-and-testing-python.md | 427 ++++++ ...hing-dependencies-to-speed-up-workflows.md | 192 +++ .../creating-postgresql-service-containers.md | 335 +++++ .../creating-redis-service-containers.md | 325 +++++ .../de-DE/content/actions/guides/index.md | 60 + .../guides/publishing-docker-images.md | 158 ++ .../publishing-java-packages-with-gradle.md | 219 +++ .../publishing-java-packages-with-maven.md | 210 +++ .../guides/publishing-nodejs-packages.md | 210 +++ ...us-integration-using-workflow-templates.md | 43 + .../storing-workflow-data-as-artifacts.md | 249 ++++ .../about-self-hosted-runners.md | 9 + .../adding-self-hosted-runners.md | 5 +- ...-hosted-runner-application-as-a-service.md | 2 +- .../actions/hosting-your-own-runners/index.md | 2 +- ...and-troubleshooting-self-hosted-runners.md | 4 +- .../removing-self-hosted-runners.md | 5 +- translations/de-DE/content/actions/index.md | 58 +- .../essential-features-of-github-actions.md | 95 ++ .../finding-and-customizing-actions.md | 156 ++ .../actions/learn-github-actions/index.md | 42 + .../introduction-to-github-actions.md | 225 +++ .../managing-complex-workflows.md | 151 ++ ...-from-azure-pipelines-to-github-actions.md | 327 +++++ ...grating-from-circleci-to-github-actions.md | 447 ++++++ ...ting-from-gitlab-cicd-to-github-actions.md | 476 +++++++ ...igrating-from-jenkins-to-github-actions.md | 293 ++++ .../security-hardening-for-github-actions.md | 97 ++ ...haring-workflows-with-your-organization.md | 114 ++ .../adding-a-workflow-status-badge.md | 63 + .../canceling-a-workflow.md | 31 + .../deleting-a-workflow-run.md | 23 + .../disabling-and-enabling-a-workflow.md | 45 + .../downloading-workflow-artifacts.md | 22 + .../enabling-debug-logging.md | 38 + .../actions/managing-workflow-runs/index.md | 32 + .../manually-running-a-workflow.md | 31 + .../re-running-a-workflow.md | 19 + .../removing-workflow-artifacts.md | 41 + .../using-workflow-run-logs.md | 86 ++ .../viewing-job-execution-time.md | 24 + .../viewing-workflow-run-history.md | 18 + .../de-DE/content/actions/quickstart.md | 7 +- .../reference/authentication-in-a-workflow.md | 100 ++ ...nd-expression-syntax-for-github-actions.md | 90 +- .../actions/reference/encrypted-secrets.md | 221 +++ .../reference/environment-variables.md | 69 + .../events-that-trigger-workflows.md | 228 +-- .../de-DE/content/actions/reference/index.md | 40 +- ...pecifications-for-github-hosted-runners.md | 149 ++ ...usage-limits-billing-and-administration.md | 88 ++ .../workflow-commands-for-github-actions.md | 125 +- .../workflow-syntax-for-github-actions.md | 148 +- ...or-users-outside-your-identity-provider.md | 2 +- .../content/admin/authentication/using-cas.md | 6 +- .../admin/authentication/using-ldap.md | 20 +- .../admin/authentication/using-saml.md | 16 +- .../configuration/command-line-utilities.md | 7 +- .../configuration/configuring-a-hostname.md | 2 +- .../configuration/configuring-applications.md | 4 +- .../configuring-built-in-firewall-rules.md | 4 +- ...guring-code-scanning-for-your-appliance.md | 12 +- .../configuration/configuring-rate-limits.md | 2 +- ...dress-using-the-virtual-machine-console.md | 8 + .../admin/configuration/configuring-tls.md | 2 +- ...prise-server-to-github-enterprise-cloud.md | 6 +- ...ependencies-on-github-enterprise-server.md | 30 +- .../enabling-subdomain-isolation.md | 37 +- .../content/admin/configuration/index.md | 10 +- .../admin/configuration/network-ports.md | 22 +- .../configuration/site-admin-dashboard.md | 4 +- .../about-geo-replication.md | 2 +- .../about-high-availability-configuration.md | 11 +- .../accessing-the-monitor-dashboard.md | 12 +- .../cluster-network-configuration.md | 1 - .../creating-a-high-availability-replica.md | 2 +- .../admin/enterprise-management/index.md | 5 +- .../monitoring-cluster-nodes.md | 49 +- .../upgrading-a-cluster.md | 2 +- .../about-github-enterprise-support.md | 2 +- ...um-support-for-github-enterprise-server.md | 2 +- ...b-premium-support-for-github-enterprise.md | 2 +- .../about-support-for-advanced-security.md | 6 +- .../reaching-github-support.md | 2 +- ...com-actions-on-github-enterprise-server.md | 1 - ...ub-actions-policies-for-your-enterprise.md | 1 - ...-hosted-runners-without-internet-access.md | 2 +- ...erprise-server-on-google-cloud-platform.md | 3 +- ...thub-enterprise-server-on-openstack-kvm.md | 4 +- .../overview/about-enterprise-accounts.md | 4 +- .../about-the-github-enterprise-server-api.md | 4 +- ...managing-your-github-enterprise-license.md | 6 +- ...ing-github-packages-for-your-enterprise.md | 1 - .../de-DE/content/admin/packages/index.md | 1 - .../creating-a-pre-receive-hook-script.md | 6 +- .../enforcing-policies-for-your-enterprise.md | 1 - ...enforcing-policy-with-pre-receive-hooks.md | 2 +- ...-management-policies-in-your-enterprise.md | 89 +- .../admin/user-management/audit-logging.md | 2 +- .../admin/user-management/audited-actions.md | 44 +- .../configuring-email-for-notifications.md | 2 +- ...-visibility-for-organization-membership.md | 2 +- .../admin/user-management/creating-teams.md | 10 +- ...tomizing-user-messages-on-your-instance.md | 2 +- .../user-management/managing-dormant-users.md | 34 +- .../monitoring-activity-in-your-enterprise.md | 1 - ...moting-or-demoting-a-site-administrator.md | 4 +- .../rebuilding-contributions-data.md | 5 +- .../searching-the-audit-log.md | 30 +- .../suspending-and-unsuspending-users.md | 2 +- ...m-your-local-computer-to-github-desktop.md | 4 +- ...-project-to-github-using-github-desktop.md | 2 +- ...nging-a-remotes-url-from-github-desktop.md | 2 +- ...epository-from-github-to-github-desktop.md | 10 +- ...orking-repositories-from-github-desktop.md | 8 +- ...g-and-reviewing-changes-to-your-project.md | 4 +- .../creating-an-issue-or-pull-request.md | 10 +- ...ur-local-repository-in-sync-with-github.md | 2 +- .../managing-tags.md | 2 +- .../reverting-a-commit.md | 2 +- .../syncing-your-branch.md | 2 +- ...iewing-a-pull-request-in-github-desktop.md | 2 +- ...pository-on-github-or-github-enterprise.md | 2 +- .../authenticating-to-github.md | 10 +- .../keyboard-shortcuts.md | 110 +- .../setting-a-theme-for-github-desktop.md | 2 +- .../content/developers/apps/about-apps.md | 2 +- .../apps/activating-beta-features-for-apps.md | 3 +- .../developers/apps/authorizing-oauth-apps.md | 102 +- ...ating-a-custom-badge-for-your-oauth-app.md | 5 +- .../creating-a-github-app-from-a-manifest.md | 6 +- ...ating-a-github-app-using-url-parameters.md | 164 +-- .../creating-ci-tests-with-the-checks-api.md | 105 +- ...nces-between-github-apps-and-oauth-apps.md | 16 +- .../apps/editing-a-github-apps-permissions.md | 18 +- ...g-and-authorizing-users-for-github-apps.md | 149 +- .../migrating-oauth-apps-to-github-apps.md | 1 - .../developers/apps/modifying-an-oauth-app.md | 6 +- ...refreshing-user-to-server-access-tokens.md | 6 +- .../developers/apps/scopes-for-oauth-apps.md | 100 +- ...ment-environment-to-create-a-github-app.md | 1 - .../suspending-a-github-app-installation.md | 8 +- .../apps/using-the-github-api-in-your-app.md | 1 - .../drafting-a-listing-for-your-app.md | 5 +- .../viewing-metrics-for-your-listing.md | 3 +- .../viewing-transactions-for-your-listing.md | 3 +- ...k-events-for-the-github-marketplace-api.md | 6 +- .../overview/managing-deploy-keys.md | 1 - .../overview/replacing-github-services.md | 1 - .../overview/using-ssh-agent-forwarding.md | 2 +- .../webhooks-and-events/about-webhooks.md | 9 +- .../webhooks-and-events/github-event-types.md | 3 +- .../webhooks-and-events/issue-event-types.md | 1 - .../securing-your-webhooks.md | 27 +- .../webhooks-and-events/testing-webhooks.md | 1 - .../webhook-events-and-payloads.md | 85 +- .../about-branch-restrictions.md | 10 +- ...fications-for-pushes-to-your-repository.md | 9 +- ...about-github-dependabot-version-updates.md | 8 +- .../about-merge-methods-on-github.md | 4 +- .../about-protected-branches.md | 2 +- .../about-releases.md | 8 +- .../about-required-commit-signing.md | 6 +- ...bout-required-reviews-for-pull-requests.md | 2 +- .../about-required-status-checks.md | 4 +- .../about-securing-your-repository.md | 2 +- ...for-release-forms-with-query-parameters.md | 2 +- .../changing-the-default-branch.md | 53 + ...classifying-your-repository-with-topics.md | 40 +- .../comparing-releases.md | 2 +- ...guration-options-for-dependency-updates.md | 32 +- ...tolinks-to-reference-external-resources.md | 4 +- ...uring-commit-rebasing-for-pull-requests.md | 2 +- ...ring-commit-squashing-for-pull-requests.md | 2 +- .../configuring-pull-request-merges.md | 2 +- ...ecret-scanning-for-private-repositories.md | 2 +- ...s-artifacts-and-logs-in-your-repository.md | 18 + ...g-your-repositorys-social-media-preview.md | 4 +- .../deleting-a-repository.md | 2 +- ...nd-restoring-branches-in-a-pull-request.md | 3 +- ...imiting-github-actions-for-a-repository.md | 39 +- ...ing-a-sponsor-button-in-your-repository.md | 24 +- .../enabling-and-disabling-version-updates.md | 2 +- .../enabling-branch-restrictions.md | 4 +- ...enabling-deletion-of-a-protected-branch.md | 2 +- ...ling-force-pushes-to-a-protected-branch.md | 23 +- .../enabling-required-commit-signing.md | 2 +- ...ling-required-reviews-for-pull-requests.md | 2 +- .../enabling-required-status-checks.md | 2 +- .../administering-a-repository/index.md | 3 +- ...tions-up-to-date-with-github-dependabot.md | 2 +- .../linking-to-releases.md | 2 +- .../managing-alerts-from-secret-scanning.md | 2 +- .../managing-releases-in-a-repository.md | 9 +- ...ging-the-automatic-deletion-of-branches.md | 4 +- ...-the-forking-policy-for-your-repository.md | 4 +- .../renaming-a-repository.md | 2 +- .../requiring-a-linear-commit-history.md | 2 +- .../restoring-a-deleted-repository.md | 4 +- .../setting-repository-visibility.md | 6 +- .../transferring-a-repository.md | 8 +- .../types-of-required-status-checks.md | 2 +- .../about-anonymized-image-urls.md | 2 +- .../about-authentication-to-github.md | 1 - .../about-commit-signature-verification.md | 7 +- .../about-githubs-ip-addresses.md | 4 +- .../authenticating-to-github/about-ssh.md | 13 +- .../about-two-factor-authentication.md | 6 +- ...-github-using-two-factor-authentication.md | 10 +- ...ng-a-new-ssh-key-to-your-github-account.md | 12 +- .../associating-an-email-with-your-gpg-key.md | 6 +- ...authenticating-with-saml-single-sign-on.md | 2 +- .../authorizing-oauth-apps.md | 14 +- .../checking-for-existing-ssh-keys.md | 3 +- ...t-and-tag-signature-verification-status.md | 6 +- ...-factor-authentication-recovery-methods.md | 8 +- .../configuring-two-factor-authentication.md | 40 +- .../connecting-to-github-with-ssh.md | 2 +- ...onnecting-with-third-party-applications.md | 8 +- ...s-where-sms-authentication-is-supported.md | 4 +- .../creating-a-personal-access-token.md | 4 +- .../creating-a-strong-password.md | 6 +- ...uthentication-for-your-personal-account.md | 2 +- .../error-agent-admitted-failure-to-sign.md | 2 +- .../error-bad-file-number.md | 4 +- .../error-permission-denied-publickey.md | 134 +- ...ission-to-userrepo-denied-to-other-user.md | 2 +- ...e-problem-verify-that-the-ca-cert-is-ok.md | 6 +- .../error-were-doing-an-ssh-key-audit.md | 2 +- .../generating-a-new-gpg-key.md | 4 +- .../keeping-your-account-and-data-secure.md | 2 +- .../managing-commit-signature-verification.md | 2 +- .../preventing-unauthorized-access.md | 2 +- ...ccount-if-you-lose-your-2fa-credentials.md | 3 +- ...moving-sensitive-data-from-a-repository.md | 14 +- .../reviewing-your-authorized-integrations.md | 2 +- .../reviewing-your-deploy-keys.md | 2 +- .../reviewing-your-security-log.md | 363 ++--- .../reviewing-your-ssh-keys.md | 62 +- ...ount-with-two-factor-authentication-2fa.md | 2 +- .../signing-commits.md | 5 +- .../authenticating-to-github/sudo-mode.md | 2 +- .../telling-git-about-your-signing-key.md | 8 +- .../testing-your-ssh-connection.md | 2 +- .../troubleshooting-ssh.md | 2 +- .../updating-an-expired-gpg-key.md | 2 +- ...updating-your-github-access-credentials.md | 10 +- .../using-ssh-over-the-https-port.md | 4 +- .../working-with-ssh-key-passphrases.md | 7 +- ...munity-profiles-for-public-repositories.md | 2 +- .../about-issue-and-pull-request-templates.md | 2 +- .../about-team-discussions.md | 4 +- .../about-wikis.md | 4 +- .../accessing-a-projects-community-profile.md | 2 +- ...dding-a-code-of-conduct-to-your-project.md | 2 +- .../adding-a-license-to-a-repository.md | 2 +- .../adding-or-editing-wiki-pages.md | 2 +- ...dding-support-resources-to-your-project.md | 4 +- .../blocking-a-user-from-your-organization.md | 2 +- .../collaborating-with-your-team.md | 2 +- ...ing-issue-templates-for-your-repository.md | 4 +- ...reating-a-default-community-health-file.md | 28 +- ...ating-a-footer-or-sidebar-for-your-wiki.md | 2 +- ...ll-request-template-for-your-repository.md | 2 +- .../editing-wiki-content.md | 2 +- ...ntributions-to-your-project-with-labels.md | 2 +- .../locking-conversations.md | 42 +- .../managing-disruptive-comments.md | 83 +- ...-abuse-in-your-organizations-repository.md | 4 +- .../reporting-abuse-or-spam.md | 4 +- ...-guidelines-for-repository-contributors.md | 6 +- .../tracking-changes-in-a-comment.md | 2 +- ...nblocking-a-user-from-your-organization.md | 2 +- ...cking-a-user-from-your-personal-account.md | 2 +- ...courage-useful-issues-and-pull-requests.md | 2 +- ...ouve-blocked-from-your-personal-account.md | 4 +- .../about-branches.md | 16 +- .../about-collaborative-development-models.md | 2 +- ...out-comparing-branches-in-pull-requests.md | 6 +- .../about-conversations-on-github.md | 4 +- .../about-forks.md | 8 +- .../about-merge-conflicts.md | 6 +- .../about-pull-request-merges.md | 2 +- .../about-pull-request-reviews.md | 4 +- .../about-pull-requests.md | 2 +- .../about-status-checks.md | 2 +- ...pull-request-branch-created-from-a-fork.md | 4 +- .../changing-the-stage-of-a-pull-request.md | 2 +- .../checking-out-pull-requests-locally.md | 2 +- ...repositories-with-code-quality-features.md | 4 +- .../commenting-on-a-pull-request.md | 2 +- ...pull-request-branch-created-from-a-fork.md | 8 +- .../creating-a-pull-request-from-a-fork.md | 4 +- .../creating-a-pull-request.md | 2 +- ...eleting-branches-within-your-repository.md | 4 +- .../dismissing-a-pull-request-review.md | 6 +- .../filtering-files-in-a-pull-request.md | 4 +- ...corporating-changes-from-a-pull-request.md | 2 +- .../index.md | 2 +- .../merging-a-pull-request.md | 7 +- ...g-an-upstream-repository-into-your-fork.md | 4 +- .../requesting-a-pull-request-review.md | 2 +- .../resolving-a-merge-conflict-on-github.md | 60 +- ...a-merge-conflict-using-the-command-line.md | 10 +- .../reverting-a-pull-request.md | 2 +- .../reviewing-changes-in-pull-requests.md | 2 +- ...wing-proposed-changes-in-a-pull-request.md | 8 +- .../syncing-a-fork.md | 4 +- ...sitory-is-deleted-or-changes-visibility.md | 4 +- .../working-with-pre-receive-hooks.md | 4 +- .../changing-a-commit-message.md | 29 +- .../commit-branch-and-tag-labels.md | 4 +- ...sts-on-github-but-not-in-my-local-clone.md | 6 +- .../comparing-commits.md | 4 +- ...g-a-commit-on-behalf-of-an-organization.md | 2 +- ...creating-a-commit-with-multiple-authors.md | 61 +- .../differences-between-commit-views.md | 4 +- ...are-my-commits-linked-to-the-wrong-user.md | 2 +- ...ut-archiving-content-and-data-on-github.md | 4 +- .../about-archiving-repositories.md | 2 +- .../about-code-owners.md | 11 +- .../about-readmes.md | 4 +- .../about-repositories.md | 7 +- .../about-repository-languages.md | 5 +- .../about-repository-visibility.md | 23 +- .../archiving-a-github-repository.md | 2 +- .../archiving-repositories.md | 2 +- .../backing-up-a-repository.md | 39 +- .../cloning-a-repository.md | 4 +- .../creating-a-new-repository.md | 15 +- .../creating-a-repository-from-a-template.md | 4 +- .../creating-a-repository-on-github.md | 2 +- .../creating-a-template-repository.md | 15 +- .../creating-an-issues-only-repository.md | 2 +- ...s-to-nonexistent-ref-unable-to-checkout.md | 2 +- .../error-repository-not-found.md | 6 +- .../https-cloning-errors.md | 4 +- .../licensing-a-repository.md | 5 +- .../referencing-and-citing-content.md | 4 +- .../about-github-marketplace.md | 6 +- .../about-integrations.md | 12 +- .../exploring-integrations.md | 2 +- .../github-extensions-and-integrations.md | 2 +- .../installing-an-app-in-your-organization.md | 6 +- ...talling-an-app-in-your-personal-account.md | 6 +- .../about-billing-for-codespaces.md | 27 + .../about-codespaces.md | 2 +- ...configuring-codespaces-for-your-project.md | 10 +- .../creating-a-codespace.md | 2 +- .../deleting-a-codespace.md | 4 +- .../developing-in-a-codespace.md | 2 +- .../index.md | 4 +- .../troubleshooting-your-codespace.md | 2 +- .../using-codespaces-in-visual-studio-code.md | 45 + .../using-codespaces-in-visual-studio.md | 53 + .../github/extending-github/about-webhooks.md | 2 +- .../getting-started-with-the-api.md | 4 +- .../about-code-scanning.md | 2 +- .../about-integration-with-code-scanning.md | 16 +- ...our-code-for-vulnerabilities-and-errors.md | 1 + .../configuring-code-scanning.md | 159 ++- ...-codeql-code-scanning-in-your-ci-system.md | 165 +++ ...-codeql-workflow-for-compiled-languages.md | 116 ++ ...enabling-code-scanning-for-a-repository.md | 88 +- .../index.md | 14 +- .../integrating-with-code-scanning.md | 3 +- ...ode-scanning-alerts-for-your-repository.md | 63 + ...-codeql-code-scanning-in-your-ci-system.md | 161 +++ .../sarif-support-for-code-scanning.md | 169 +-- ...g-code-scanning-alerts-in-pull-requests.md | 48 + ...-codeql-code-scanning-in-your-ci-system.md | 52 + .../troubleshooting-the-codeql-workflow.md | 125 ++ .../uploading-a-sarif-file-to-github.md | 16 +- ...e-scanning-with-your-existing-ci-system.md | 11 + .../access-permissions-on-github.md | 2 +- .../getting-started-with-github/be-social.md | 10 +- .../create-a-repo.md | 8 +- ...ly-access-releases-with-feature-preview.md | 2 +- ...-to-contribute-to-open-source-on-github.md | 2 +- .../following-people.md | 4 +- .../fork-a-repo.md | 16 +- .../git-and-github-learning-resources.md | 10 +- .../getting-started-with-github/github-cli.md | 2 +- .../github-desktop.md | 2 +- .../github-for-mobile.md | 10 + .../githubs-products.md | 4 +- .../keyboard-shortcuts.md | 42 +- .../saving-repositories-with-stars.md | 13 +- .../getting-started-with-github/set-up-git.md | 10 +- ...g-up-a-trial-of-github-enterprise-cloud.md | 6 +- ...-up-a-trial-of-github-enterprise-server.md | 8 +- .../signing-up-for-a-new-github-account.md | 2 +- .../supported-browsers.md | 2 +- .../troubleshooting-connectivity-problems.md | 6 +- .../types-of-github-accounts.md | 9 +- .../verifying-your-email-address.md | 6 +- ...roject-to-github-using-the-command-line.md | 29 +- ...a-git-repository-using-the-command-line.md | 6 +- .../importing-source-code-to-github.md | 2 +- ...bversion-properties-supported-by-github.md | 2 +- .../support-for-subversion-clients.md | 4 +- ...author-attribution-with-github-importer.md | 2 +- ...-differences-between-subversion-and-git.md | 6 +- translations/de-DE/content/github/index.md | 2 +- .../3d-file-viewer.md | 2 +- ...-to-a-repository-using-the-command-line.md | 6 +- .../adding-a-file-to-a-repository.md | 6 +- .../creating-new-files.md | 6 +- .../deleting-files.md | 2 +- .../editing-files-in-your-repository.md | 2 +- .../getting-permanent-links-to-files.md | 14 +- .../managing-files-on-github.md | 2 +- .../mapping-geojson-files-on-github.md | 2 +- ...o-a-new-location-using-the-command-line.md | 2 +- .../navigating-code-on-github.md | 2 +- .../renaming-a-file.md | 2 +- .../rendering-and-diffing-images.md | 2 +- .../rendering-csv-and-tsv-data.md | 2 +- .../tracking-changes-in-a-file.md | 2 +- ...g-with-jupyter-notebook-files-on-github.md | 6 +- .../about-git-large-file-storage.md | 15 +- .../about-storage-and-bandwidth-usage.md | 9 +- ...llaboration-with-git-large-file-storage.md | 4 +- .../conditions-for-large-files.md | 2 +- .../configuring-git-large-file-storage.md | 8 +- .../installing-git-large-file-storage.md | 13 +- ...ur-repository-to-git-large-file-storage.md | 4 +- ...moving-files-from-a-repositorys-history.md | 4 +- ...oving-files-from-git-large-file-storage.md | 40 +- ...-git-large-file-storage-upload-failures.md | 2 +- .../working-with-large-files.md | 2 +- ...bout-alerts-for-vulnerable-dependencies.md | 6 +- ...g-a-collaborator-to-a-security-advisory.md | 2 +- ...ng-a-security-policy-to-your-repository.md | 4 +- ...ork-to-resolve-a-security-vulnerability.md | 4 +- ...ring-github-dependabot-security-updates.md | 16 +- .../creating-a-security-advisory.md | 2 +- .../editing-a-security-advisory.md | 2 +- ...abilities-in-your-projects-dependencies.md | 2 +- ...rmission-levels-for-security-advisories.md | 2 +- .../publishing-a-security-advisory.md | 2 +- .../withdrawing-a-security-advisory.md | 2 +- .../about-notifications.md | 3 +- .../configuring-notifications.md | 192 +-- .../managing-notifications-from-your-inbox.md | 3 +- .../managing-your-subscriptions.md | 2 +- ...and-pull-requests-with-query-parameters.md | 20 +- .../about-automation-for-project-boards.md | 4 +- ...bout-duplicate-issues-and-pull-requests.md | 2 +- .../about-issues.md | 14 +- .../about-labels.md | 24 +- .../about-project-boards.md | 6 +- ...es-and-pull-requests-to-a-project-board.md | 11 +- .../adding-notes-to-a-project-board.md | 2 +- ...ying-labels-to-issues-and-pull-requests.md | 5 +- .../archiving-cards-on-a-project-board.md | 2 +- ...and-pull-requests-to-other-github-users.md | 4 +- ...ilestones-with-issues-and-pull-requests.md | 2 +- .../changing-project-board-visibility.md | 2 +- ...nfiguring-automation-for-project-boards.md | 2 +- .../copying-a-project-board.md | 2 +- .../creating-a-label.md | 2 +- .../creating-a-project-board.md | 2 +- ...milestones-for-issues-and-pull-requests.md | 2 +- .../deleting-a-label.md | 2 +- .../deleting-a-project-board.md | 2 +- .../deleting-an-issue.md | 2 +- .../disabling-issues.md | 5 +- ...isabling-project-boards-in-a-repository.md | 2 +- .../editing-a-label.md | 2 +- ...attachments-on-issues-and-pull-requests.md | 29 +- .../filtering-cards-on-a-project-board.md | 10 +- .../filtering-issues-and-pull-requests.md | 2 +- ...iltering-pull-requests-by-review-status.md | 2 +- .../labeling-issues-and-pull-requests.md | 2 +- .../linking-a-pull-request-to-an-issue.md | 22 +- .../managing-your-work-with-issues.md | 2 +- ...e-progress-of-your-work-with-milestones.md | 2 +- ...ogress-of-your-work-with-project-boards.md | 2 +- ...sferring-an-issue-to-another-repository.md | 4 +- ...arch-to-filter-issues-and-pull-requests.md | 2 +- ...ng-all-of-your-issues-and-pull-requests.md | 2 +- .../about-email-notifications.md | 20 +- .../about-notifications.md | 9 +- .../about-web-notifications.md | 8 +- .../accessing-your-notifications.md | 2 +- ...-delivery-method-for-your-notifications.md | 2 +- .../getting-started-with-notifications.md | 2 +- ...listing-the-repositories-youre-watching.md | 2 +- ...to-and-unsubscribing-from-notifications.md | 13 +- ...nd-unwatching-releases-for-a-repository.md | 2 +- .../watching-and-unwatching-repositories.md | 8 +- ...atching-and-unwatching-team-discussions.md | 18 +- .../about-searching-on-github.md | 6 +- ...tory-search-in-github-enterprise-server.md | 6 +- .../searching-code.md | 6 +- .../searching-commits.md | 4 +- .../searching-for-packages.md | 11 +- .../searching-for-repositories.md | 6 +- .../searching-issues-and-pull-requests.md | 10 +- .../searching-topics.md | 8 +- .../searching-users.md | 4 +- .../searching-wikis.md | 4 +- .../sorting-search-results.md | 18 +- .../troubleshooting-search-queries.md | 2 +- .../understanding-the-search-syntax.md | 2 +- ...bout-billing-for-git-large-file-storage.md | 2 +- .../about-billing-for-github-accounts.md | 2 +- .../about-billing-for-github-actions.md | 6 +- .../about-billing-for-github-marketplace.md | 8 +- .../about-billing-for-github-packages.md | 4 +- .../about-billing-on-github.md | 6 +- .../about-per-user-pricing.md | 6 +- .../adding-information-to-your-receipts.md | 4 +- .../canceling-a-github-marketplace-app.md | 2 +- ...ging-the-duration-of-your-billing-cycle.md | 2 +- ...r-an-organization-on-behalf-of-a-client.md | 4 +- ...unted-subscriptions-for-github-accounts.md | 2 +- .../downgrading-git-large-file-storage.md | 2 +- ...lling-plan-for-a-github-marketplace-app.md | 2 +- ...-downgrading-affect-the-billing-process.md | 2 +- ...ging-billing-for-git-large-file-storage.md | 2 +- ...ing-billing-for-github-marketplace-apps.md | 2 +- ...-your-spending-limit-for-github-actions.md | 6 +- ...your-spending-limit-for-github-packages.md | 6 +- .../redeeming-a-coupon.md | 2 +- .../removing-a-payment-method.md | 4 +- ...organizations-for-procurement-companies.md | 2 +- .../setting-your-billing-email.md | 6 +- ...eshooting-a-declined-credit-card-charge.md | 2 +- .../unlocking-a-locked-account.md | 2 +- .../upgrading-git-large-file-storage.md | 2 +- ...lling-plan-for-a-github-marketplace-app.md | 2 +- .../upgrading-your-github-subscription.md | 6 +- ...ng-pending-changes-to-your-subscription.md | 2 +- ...ewing-your-git-large-file-storage-usage.md | 2 +- .../viewing-your-github-actions-usage.md | 6 +- .../viewing-your-github-packages-usage.md | 4 +- .../about-oauth-app-access-restrictions.md | 12 +- .../about-organizations.md | 3 +- .../about-scim.md | 2 +- .../about-ssh-certificate-authorities.md | 8 +- .../about-teams.md | 4 +- ...-authentication-and-saml-single-sign-on.md | 2 +- .../about-your-organization-dashboard.md | 2 +- .../about-your-organizations-news-feed.md | 8 +- ...to-a-project-board-in-your-organization.md | 6 +- ...ithub-app-managers-in-your-organization.md | 4 +- .../adding-organization-members-to-a-team.md | 13 +- .../adding-people-to-your-organization.md | 2 +- ...e-to-delete-issues-in-your-organization.md | 2 +- ...roving-oauth-apps-for-your-organization.md | 2 +- ...tside-collaborator-in-your-organization.md | 6 +- ...an-invitation-to-join-your-organization.md | 2 +- .../changing-team-visibility.md | 2 +- ...saml-single-sign-on-and-scim-using-okta.md | 4 +- ...artifacts-and-logs-in-your-organization.md | 16 + ...-identity-provider-to-your-organization.md | 2 +- ...ation-member-to-an-outside-collaborator.md | 2 +- ...-collaborator-to-an-organization-member.md | 19 +- ...reating-a-new-organization-from-scratch.md | 4 +- .../creating-a-team.md | 2 +- .../deleting-an-organization-account.md | 2 +- ...cess-restrictions-for-your-organization.md | 2 +- ...ng-github-actions-for-your-organization.md | 38 + ...ithub-pages-sites-for-your-organization.md | 8 +- ...ions-saml-single-sign-on-recovery-codes.md | 2 +- ...ml-single-sign-on-for-your-organization.md | 2 +- ...cess-restrictions-for-your-organization.md | 2 +- ...ml-single-sign-on-for-your-organization.md | 2 +- .../index.md | 4 +- ...nviting-users-to-join-your-organization.md | 6 +- ...ership-continuity-for-your-organization.md | 2 +- ...-project-board-for-organization-members.md | 2 +- ...aging-access-to-your-organizations-apps.md | 2 +- ...owed-ip-addresses-for-your-organization.md | 2 +- ...access-to-an-organization-project-board.md | 6 +- ...ls-access-to-an-organization-repository.md | 2 +- ...rvice-accounts-with-saml-single-sign-on.md | 2 +- ...ng-code-review-assignment-for-your-team.md | 2 +- ...s-for-repositories-in-your-organization.md | 2 +- ...cess-to-your-organizations-repositories.md | 4 +- ...anaging-membership-in-your-organization.md | 2 +- ...heduled-reminders-for-your-organization.md | 2 +- ...aging-scheduled-reminders-for-your-team.md | 2 +- ...access-to-an-organization-project-board.md | 2 +- ...e-for-repositories-in-your-organization.md | 9 +- ...ay-of-member-names-in-your-organization.md | 4 +- ...he-forking-policy-for-your-organization.md | 6 +- ...ganizations-ssh-certificate-authorities.md | 2 +- ...-a-team-in-your-organizations-hierarchy.md | 2 +- .../organizing-members-into-teams.md | 2 +- .../permission-levels-for-an-organization.md | 171 +-- ...tor-authentication-in-your-organization.md | 2 +- ...ng-a-former-member-of-your-organization.md | 4 +- ...llaborators-access-to-your-organization.md | 52 +- ...ator-from-an-organization-project-board.md | 2 +- ...hub-app-managers-from-your-organization.md | 4 +- .../renaming-an-organization.md | 4 +- ...y-permission-levels-for-an-organization.md | 204 +-- ...tor-authentication-in-your-organization.md | 30 +- ...cting-access-to-your-organizations-data.md | 2 +- ...epository-creation-in-your-organization.md | 8 +- ...visibility-changes-in-your-organization.md | 2 +- ...ing-the-audit-log-for-your-organization.md | 8 +- ...ur-organizations-installed-integrations.md | 19 +- ...ng-base-permissions-for-an-organization.md | 4 +- ...ssions-for-adding-outside-collaborators.md | 13 +- ...r-deleting-or-transferring-repositories.md | 2 +- ...eation-permissions-in-your-organization.md | 2 +- .../setting-your-teams-profile-picture.md | 2 +- .../transferring-organization-ownership.md | 2 +- ...ading-to-the-corporate-terms-of-service.md | 6 +- .../verifying-your-organizations-domain.md | 6 +- ...s-in-your-organization-have-2fa-enabled.md | 4 +- .../about-enterprise-accounts.md | 12 +- ...rganizations-to-your-enterprise-account.md | 4 +- ...cts-and-logs-in-your-enterprise-account.md | 19 + ...ons-policies-in-your-enterprise-account.md | 15 +- .../index.md | 2 + ...eople-to-manage-your-enterprise-account.md | 2 +- ...dio-subscription-with-github-enterprise.md | 42 + .../roles-for-an-enterprise-account.md | 2 +- ...ewing-people-in-your-enterprise-account.md | 4 +- ...rganizations-in-your-enterprise-account.md | 2 +- .../about-your-organizations-profile.md | 2 +- .../customizing-your-profile.md | 2 +- .../personalizing-your-profile.md | 20 +- .../pinning-items-to-your-profile.md | 2 +- ...r-private-contributions-on-your-profile.md | 2 +- ...contributions-to-your-githubcom-profile.md | 8 +- ...erview-of-your-activity-on-your-profile.md | 2 +- .../viewing-contributions-on-your-profile.md | 4 +- ...tributions-not-showing-up-on-my-profile.md | 8 +- .../about-organization-membership.md | 2 +- .../about-your-personal-dashboard.md | 6 +- ...an-email-address-to-your-github-account.md | 2 +- ...that-expose-your-personal-email-address.md | 2 +- .../changing-your-github-username.md | 58 +- .../changing-your-primary-email-address.md | 9 +- .../converting-a-user-into-an-organization.md | 8 +- .../deleting-your-user-account.md | 8 +- ...-collaborators-to-a-personal-repository.md | 4 +- ...uity-of-your-user-accounts-repositories.md | 2 +- ...ss-to-your-user-accounts-project-boards.md | 6 +- .../managing-email-preferences.md | 2 +- .../managing-marketing-emails-from-github.md | 2 +- ...fault-branch-name-for-your-repositories.md | 8 +- ...naging-your-membership-in-organizations.md | 4 +- .../managing-your-scheduled-reminders.md | 2 +- ...on-levels-for-a-user-account-repository.md | 91 +- ...membering-your-github-username-or-email.md | 8 +- .../removing-yourself-from-an-organization.md | 4 +- ...ng-organization-approval-for-oauth-apps.md | 2 +- .../setting-a-backup-email-address.md | 2 +- .../setting-your-commit-email-address.md | 18 +- .../types-of-emails-github-sends.md | 2 +- ...does-the-available-for-hire-checkbox-do.md | 2 +- ...plicable-to-us-federal-government-users.md | 2 +- .../github-additional-product-terms.md | 6 +- ...ub-bug-bounty-program-legal-safe-harbor.md | 2 +- ...thub-enterprise-service-level-agreement.md | 2 - ...d-data-protection-for-your-organization.md | 40 +- .../site-policy/github-privacy-statement.md | 2 +- .../github-subprocessors-and-cookies.md | 106 +- .../about-github-sponsors.md | 2 +- ...ks-for-events-in-your-sponsored-account.md | 2 +- .../contacting-your-sponsors.md | 2 +- ...our-profile-details-for-github-sponsors.md | 2 +- ...aging-your-payouts-from-github-sponsors.md | 2 +- .../managing-your-sponsorship-goal.md | 2 +- .../managing-your-sponsorship.md | 2 +- ...p-github-sponsors-for-your-organization.md | 2 +- ...p-github-sponsors-for-your-user-account.md | 2 +- .../sponsoring-an-open-source-contributor.md | 4 +- .../about-campus-advisors.md | 2 +- .../about-campus-experts.md | 2 +- .../about-github-education-for-students.md | 6 +- .../about-github-education.md | 6 +- .../applying-for-a-student-developer-pack.md | 6 +- ...-for-an-educator-or-researcher-discount.md | 2 +- ...-github-at-your-educational-institution.md | 2 +- ...ducator-or-researcher-discount-approved.md | 2 +- .../github/using-git/about-git-rebase.md | 2 +- .../using-git/about-git-subtree-merges.md | 14 +- .../associating-text-editors-with-git.md | 2 +- .../dealing-with-non-fast-forward-errors.md | 4 +- ...etting-changes-from-a-remote-repository.md | 4 +- .../de-DE/content/github/using-git/index.md | 2 +- .../pushing-commits-to-a-remote-repository.md | 2 +- .../github/using-git/removing-a-remote.md | 2 +- .../github/using-git/renaming-a-remote.md | 2 +- .../using-git/setting-your-username-in-git.md | 4 +- ...g-a-subfolder-out-into-a-new-repository.md | 4 +- ...ing-credentials-from-the-macos-keychain.md | 2 +- .../using-git-rebase-on-the-command-line.md | 2 +- .../which-remote-url-should-i-use.md | 4 +- ...hy-is-git-always-asking-for-my-password.md | 2 +- .../about-repository-graphs.md | 2 +- .../about-the-dependency-graph.md | 3 +- .../accessing-basic-repository-data.md | 2 +- ...loring-the-dependencies-of-a-repository.md | 11 +- .../listing-the-forks-of-a-repository.md | 2 +- ...anding-connections-between-repositories.md | 2 +- .../viewing-a-projects-contributors.md | 4 +- .../viewing-traffic-to-a-repository.md | 17 +- .../visualizing-commits-in-a-repository.md | 2 +- .../about-custom-domains-and-github-pages.md | 2 +- .../about-github-pages-and-jekyll.md | 15 +- .../about-github-pages.md | 38 +- ...yll-build-errors-for-github-pages-sites.md | 16 +- ...-to-your-github-pages-site-using-jekyll.md | 10 +- ...ithub-pages-site-with-the-theme-chooser.md | 4 +- ...-to-your-github-pages-site-using-jekyll.md | 4 +- ...ustom-domain-for-your-github-pages-site.md | 2 +- ...shing-source-for-your-github-pages-site.md | 12 +- ...tom-404-page-for-your-github-pages-site.md | 2 +- ...reating-a-github-pages-site-with-jekyll.md | 61 +- .../creating-a-github-pages-site.md | 8 +- .../getting-started-with-github-pages.md | 2 +- ...ustom-domain-for-your-github-pages-site.md | 9 +- ...uring-your-github-pages-site-with-https.md | 6 +- ...ting-up-a-github-pages-site-with-jekyll.md | 2 +- ...r-github-pages-site-locally-with-jekyll.md | 2 +- ...hooting-custom-domains-and-github-pages.md | 2 +- ...yll-build-errors-for-github-pages-sites.md | 150 +- .../unpublishing-a-github-pages-site.md | 8 +- .../using-submodules-with-github-pages.md | 6 +- ...ium-support-for-github-enterprise-cloud.md | 2 +- .../about-github-support.md | 16 +- .../github-enterprise-cloud-support.md | 12 +- .../github-marketplace-support.md | 4 +- .../submitting-a-ticket.md | 4 +- .../writing-on-github/about-saved-replies.md | 2 +- .../autolinked-references-and-urls.md | 7 +- .../basic-writing-and-formatting-syntax.md | 9 +- .../creating-and-highlighting-code-blocks.md | 2 +- .../writing-on-github/creating-gists.md | 15 +- .../guides/managing-enterprise-accounts.md | 2 +- translations/de-DE/content/index.md | 4 +- ...n-github-enterprise-and-github-insights.md | 2 +- ...n-github-insights-and-github-enterprise.md | 5 +- .../installing-github-insights.md | 3 +- ...ub-container-registry-for-docker-images.md | 12 +- ...cting-a-repository-to-a-container-image.md | 4 +- .../pushing-and-pulling-docker-images.md | 6 +- .../about-github-packages.md | 36 +- .../deleting-a-package.md | 1 - .../installing-a-package.md | 2 +- .../publishing-a-package.md | 5 +- ...ache-maven-for-use-with-github-packages.md | 24 +- ...ing-docker-for-use-with-github-packages.md | 46 +- ...dotnet-cli-for-use-with-github-packages.md | 44 +- ...ing-gradle-for-use-with-github-packages.md | 17 +- ...guring-npm-for-use-with-github-packages.md | 76 +- ...ing-github-packages-with-github-actions.md | 10 +- .../rest/guides/basics-of-authentication.md | 10 +- .../guides/best-practices-for-integrators.md | 1 - .../rest/guides/delivering-deployments.md | 2 +- .../getting-started-with-the-checks-api.md | 4 +- ...tting-started-with-the-git-database-api.md | 4 +- .../getting-started-with-the-rest-api.md | 5 +- .../content/rest/overview/api-previews.md | 30 +- .../endpoints-available-for-github-apps.md | 2 +- .../overview/other-authentication-methods.md | 4 +- .../overview/resources-in-the-rest-api.md | 2 - .../de-DE/content/rest/reference/actions.md | 14 +- .../de-DE/content/rest/reference/activity.md | 24 +- .../de-DE/content/rest/reference/apps.md | 2 - .../content/rest/reference/code-scanning.md | 14 + .../rest/reference/enterprise-admin.md | 21 +- .../content/rest/reference/interactions.md | 6 +- .../de-DE/content/rest/reference/licenses.md | 4 +- .../permissions-required-for-github-apps.md | 41 +- .../de-DE/content/rest/reference/repos.md | 8 +- .../de-DE/data/glossaries/external.yml | 2 +- .../de-DE/data/glossaries/internal.yml | 2 +- .../de-DE/data/graphql/graphql_previews.yml | 51 - translations/de-DE/data/products.yml | 11 +- .../actions/about-artifact-log-retention.md | 6 + .../data/reusables/actions/about-artifacts.md | 2 +- .../data/reusables/actions/about-secrets.md | 2 +- .../actions/about-self-hosted-runners.md | 2 +- .../reusables/actions/about-workflow-jobs.md | 2 +- .../reusables/actions/about-workflow-runs.md | 2 +- .../data/reusables/actions/about-workflows.md | 2 +- .../actions-app-actions-permissions-api.md | 2 +- .../actions/actions-authentication.md | 2 +- .../reusables/actions/actions-not-verified.md | 2 +- .../actions/actions-use-policy-settings.md | 3 + .../actions/allow-specific-actions-intro.md | 19 + .../actions/enterprise-actions-permissions.md | 2 +- .../data/reusables/actions/enterprise-beta.md | 2 +- .../enterprise-github-hosted-runners.md | 2 +- .../reusables/actions/registry-credentials.md | 1 + .../actions/scheduled-workflows-disabled.md | 1 + .../apps/general-apps-restrictions.md | 2 +- .../apps/maximum-github-apps-allowed.md | 2 +- .../apps/maximum-oauth-apps-allowed.md | 2 +- .../reusables/apps/metadata-permissions.md | 2 +- .../reusables/apps/oauth-apps-restrictions.md | 2 +- .../data/reusables/apps/state_description.md | 2 +- .../reusables/audit_log/audit-log-search.md | 4 +- .../branches/change-default-branch.md | 1 + ...efault-branch-automatically-base-branch.md | 3 +- .../branches/new-repo-default-branch.md | 3 +- .../reusables/branches/set-default-branch.md | 2 +- .../reusables/code-scanning/analyze-go.md | 1 + .../autobuild-add-build-steps.md | 2 +- .../autobuild-compiled-languages.md | 6 +- .../code-scanning/beta-codeql-runner.md | 9 + .../data/reusables/code-scanning/beta.md | 6 +- .../code-scanning/click-alert-in-list.md | 2 +- .../code-scanning/close-alert-examples.md | 1 + .../code-scanning/codeql-runner-license.md | 8 +- .../reusables/code-scanning/edit-workflow.md | 2 +- .../code-scanning/enabling-options.md | 2 +- .../false-positive-fix-codeql.md | 1 + ...eroperable-with-tools-that-output-sarif.md | 2 +- .../code-scanning/run-additional-queries.md | 2 +- .../specify-language-to-analyze.md | 2 +- .../about-billing-for-codespaces.md | 1 + .../click-remote-explorer-icon-vscode.md | 2 +- .../codespaces/codespaces-are-per-branch.md | 2 +- .../codespaces/codespaces-are-personal.md | 2 +- .../connect-to-codespace-from-vscode.md | 2 +- .../codespaces/devcontainer-location.md | 1 + .../codespaces/navigate-to-codespaces.md | 2 +- .../reusables/codespaces/release-stage.md | 2 +- .../reusables/codespaces/unsupported-repos.md | 2 +- .../codespaces/use-visual-studio-features.md | 2 +- .../you-can-see-all-your-codespaces.md | 2 +- .../reusables/command_line/git-clone-url.md | 2 +- .../command_line/manipulating_file_prereqs.md | 2 +- .../command_line/provide-an-access-token.md | 2 +- .../dashboard/access-org-dashboard.md | 2 +- .../dependabot/check-in-dependabot-yml.md | 2 +- .../dependabot/create-dependabot-yml.md | 2 +- .../default-dependencies-allow-ignore.md | 2 +- .../reusables/dependabot/dependabot-tos.md | 2 +- .../option-affects-security-updates.md | 2 +- .../dependabot/private-dependencies.md | 2 +- .../dependabot/supported-package-managers.md | 44 +- .../data/reusables/desktop/choose-a-theme.md | 2 +- .../data/reusables/desktop/confirm-tag.md | 2 +- .../data/reusables/desktop/create-tag.md | 2 +- .../data/reusables/desktop/get-an-account.md | 2 +- .../desktop/paste-email-git-config.md | 2 +- .../data/reusables/desktop/retrieve-2fa.md | 2 +- .../data/reusables/desktop/revert-commit.md | 2 +- .../reusables/desktop/select-base-branch.md | 2 +- .../reusables/desktop/windows_git_bash.md | 2 +- .../pull_request_forked_repos_link.md | 2 +- .../reusables/dotcom_billing/add-seats.md | 2 +- .../dotcom_billing/confirm-add-seats.md | 2 +- .../reusables/dotcom_billing/lfs-add-data.md | 2 +- .../dotcom_billing/number-of-seats.md | 2 +- .../reusables/dotcom_billing/upgrade_org.md | 2 +- .../education/about-github-education-link.md | 2 +- .../reusables/education/apply-for-team.md | 2 +- .../data/reusables/education/benefits-page.md | 2 +- .../reusables/education/plan-to-use-github.md | 2 +- .../enterprise-accounts/access-enterprise.md | 4 +- .../enterprise-accounts/github-connect-tab.md | 2 +- .../data/reusables/enterprise/rate_limit.md | 3 +- .../configuration-file-heading.md | 2 +- .../replacing-a-cluster-node-provision.md | 2 +- ...placing-a-cluster-node-replacement-name.md | 4 +- .../installing-releases.md | 2 +- .../submit-support-ticket-first-section.md | 16 +- .../submit-support-ticket-second-section.md | 3 +- .../use_ghe_cluster_support_bundle.md | 2 +- .../aws-supported-instance-types.md | 7 +- .../download-appliance.md | 2 +- .../download-package.md | 2 +- .../enterprise-download-procedural.md | 2 +- .../enterprise-download-upgrade-pkg.md | 2 +- .../hardware-rec-table.md | 10 +- .../hotpatching-explanation.md | 2 +- .../monitoring-replicas.md | 2 +- .../necessary_ports.md | 24 +- .../request-a-trial.md | 2 +- ...save-settings-in-web-based-mgmt-console.md | 2 +- .../software-license.md | 2 +- .../ssh-into-instance.md | 2 +- .../ssh-into-target-instance.md | 2 +- .../when-9418-necessary.md | 1 + .../advanced-security-tab.md | 2 +- .../badge_indicator.md | 2 +- .../support-link.md | 2 +- .../type-management-console-password.md | 2 +- .../updates-tab.md | 2 +- .../business.md | 2 +- .../packages-tab.md | 2 +- .../manage-global-webhooks-api.md | 2 +- .../files/commit-author-email-options.md | 3 +- .../data/reusables/gated-features/actions.md | 2 +- .../gated-features/branch-restrictions.md | 2 +- .../gated-features/code-review-assignment.md | 2 +- .../reusables/gated-features/code-scanning.md | 1 + .../gated-features/enterprise-accounts.md | 2 +- .../gated-features/github-insights.md | 2 +- .../gated-features/more-info-org-products.md | 2 +- .../reusables/gated-features/more-info.md | 2 +- .../data/reusables/gated-features/packages.md | 3 +- .../gated-features/protected-branches.md | 2 +- .../gated-features/repository-insights.md | 2 +- .../de-DE/data/reusables/git/git-push.md | 2 +- .../github-actions/actions-billing.md | 2 +- .../github-actions/actions-on-examples.md | 16 +- .../github-actions/actions-unused-labels.md | 2 +- .../artifact-log-retention-statement.md | 2 + .../github-actions/branch-requirement.md | 2 +- ...nge-retention-period-for-artifacts-logs.md | 2 + .../github-actions/contacting-support.md | 4 +- .../disabled-actions-description.md | 2 +- .../disabling-github-actions.md | 2 +- .../docker-container-os-support.md | 2 +- .../github-actions/dockerfile-guidelines.md | 2 +- .../enabled-actions-description.md | 2 +- .../enabled-local-github-actions.md | 2 +- .../github-actions/expression-syntax-if.md | 2 +- .../github-actions/gradle-workflow-steps.md | 2 +- .../permissions-statement-secrets-api.md | 2 +- ...missions-statement-secrets-organization.md | 2 +- ...ermissions-statement-secrets-repository.md | 2 +- .../private-repository-forks-overview.md | 2 +- .../publish-to-maven-workflow-step.md | 2 +- .../publish-to-packages-workflow-step.md | 2 +- .../publishing-java-packages-intro.md | 2 +- .../github-actions/run_id_description.md | 2 +- .../github-actions/run_number_description.md | 2 +- ...ed-runner-configure-runner-group-access.md | 2 +- .../self-hosted-runner-list-group.md | 2 +- .../github-actions/self-hosted-runner-list.md | 2 +- ...-runner-management-permissions-required.md | 2 +- ...elf-hosted-runner-navigate-repo-and-org.md | 2 +- .../self-hosted-runner-removal-impact.md | 2 +- .../self-hosted-runner-reusing.md | 2 +- .../github-actions/sidebar-secret.md | 2 +- .../spending-limit-enterprise-account.md | 2 +- .../github-actions/usage-api-requests.md | 1 + .../github-actions/usage-matrix-limits.md | 1 + .../github-actions/usage-workflow-run-time.md | 1 + .../access-dotcom-and-enterprise.md | 2 +- .../github-connect-tab-user-settings.md | 2 +- .../github-insights/choose-key-metric.md | 2 +- .../github-insights/enterprise-api-url.md | 2 +- .../navigate-to-key-metrics.md | 2 +- .../de-DE/data/reusables/gpg/private-email.md | 3 +- .../enable-team-sync-azure.md | 2 +- .../enable-team-sync-okta.md | 2 +- .../supported-idps-team-sync.md | 2 +- .../sync-team-with-idp-group.md | 2 +- .../team-sync-disable.md | 2 +- .../team-sync-okta-requirements.md | 2 +- .../collaborator-user-limit-definition.md | 2 +- .../contributor-user-limit-definition.md | 2 +- .../existing-user-limit-definition.md | 2 +- .../interactions/interactions-detail.md | 2 +- .../issue-events/assignee-properties.md | 2 +- .../issue-event-common-properties.md | 2 +- .../issue-events/label-properties.md | 2 +- .../issue-events/project-card-properties.md | 2 +- .../review-dismissed-properties.md | 2 +- .../issue-events/review-request-properties.md | 2 +- .../timeline_events_object_properties.md | 2 +- .../can-include-lfs-objects-archives.md | 2 +- .../marketplace/cancellation-clarification.md | 2 +- .../marketplace/downgrade-marketplace-only.md | 2 +- .../marketplace/github_apps_preferred.md | 2 +- .../reusables/marketplace/launch-with-free.md | 2 +- .../reusables/marketplace/unverified-apps.md | 2 +- .../email-notification-caveats.md | 2 +- .../notifications-v2/manage-notifications.md | 2 +- .../reusables/notifications/shared_state.md | 2 +- .../organizations/can-require-ssh-cert.md | 2 +- .../oauth_app_restrictions_default.md | 2 +- .../organizations/organization-name.md | 2 +- .../organizations/organizations_include.md | 2 +- .../outside-collaborators-use-seats.md | 2 +- .../organizations/repository-labels.md | 2 +- .../organizations/send-invitation.md | 2 +- .../organizations/team_maintainers_can.md | 4 +- .../admins-can-configure-package-types.md | 2 +- .../package_registry/authenticate-packages.md | 6 +- ...uthenticate-to-container-registry-steps.md | 25 + ...nticate_with_pat_for_container_registry.md | 9 + .../docker_registry_deprecation_status.md | 5 + .../package_registry/package-immutability.md | 4 +- .../public-or-private-packages.md | 2 +- .../spending-limit-enterprise-account.md | 2 +- .../data/reusables/pages/admin-must-push.md | 2 +- .../pages/best-with-supported-themes.md | 3 +- .../pages/decide-publishing-source.md | 2 +- .../pages/navigate-publishing-source.md | 2 +- .../reusables/pages/new-or-existing-repo.md | 2 +- .../pages/private_pages_are_public_warning.md | 2 +- .../de-DE/data/reusables/pages/visit-site.md | 2 +- .../de-DE/data/reusables/policies/abuse.md | 2 +- .../machine-man-preview.md | 2 +- .../suspend-installation-beta.md | 3 +- .../data/reusables/profile/profile-readme.md | 2 +- .../link-repos-to-project-board.md | 2 +- .../project-board-import-with-api.md | 2 +- .../reusables/projects/disabled-projects.md | 2 +- .../automatically-delete-branches.md | 2 - .../close-issues-using-keywords.md | 2 +- ...ollect-co-author-commit-git-config-info.md | 2 +- .../default-commit-message-squash-merge.md | 2 +- .../pull_requests/mark-ready-review.md | 2 +- .../pull_request_merges_and_contributions.md | 2 +- .../reusables/reminders/author-reviews.md | 2 +- .../reusables/reminders/ignored-labels.md | 2 +- .../data/reusables/reminders/ignored-terms.md | 2 +- .../de-DE/data/reusables/reminders/min-age.md | 2 +- .../data/reusables/reminders/min-staleness.md | 2 +- .../reusables/reminders/real-time-alerts.md | 2 +- .../reusables/reminders/required-labels.md | 2 +- .../about-github-archive-program.md | 2 +- .../repositories/about-internal-repos.md | 2 +- .../actions-workflow-status-badge-into.md | 2 +- .../repositories/blocked-passwords.md | 5 +- .../reusables/repositories/copy-clone-url.md | 6 +- .../repositories/default-issue-templates.md | 2 +- ...forks_from_private_repositories_warning.md | 6 +- .../repositories/enable-security-alerts.md | 2 +- .../navigate-to-job-superlinter.md | 5 + .../navigate-to-workflow-superlinter.md | 1 + .../repositories/open-with-github-desktop.md | 4 +- .../permissions-statement-read.md | 2 +- .../permissions-statement-write.md | 2 +- .../reusables/repositories/relative-links.md | 2 +- .../security-alert-delivery-options.md | 2 +- .../security-alerts-x-github-severity.md | 2 +- .../repositories/select-marketplace-apps.md | 4 +- .../repositories/sidebar-dependabot-alerts.md | 2 +- ...quash-and-rebase-linear-commit-hisitory.md | 2 +- .../repositories/start-line-comment.md | 2 +- .../reusables/repositories/suggest-changes.md | 2 +- .../view-failed-job-results-superlinter.md | 5 + .../repositories/view-run-superlinter.md | 1 + .../data/reusables/repositories/view-run.md | 2 +- .../view-specific-line-superlinter.md | 5 + .../reusables/repositories/you-can-fork.md | 4 +- .../reusables/saml/add-okta-application.md | 2 +- .../reusables/saml/assign-yourself-to-okta.md | 2 +- .../click-enterprise-account-application.md | 2 +- .../data/reusables/saml/okta-admin-button.md | 2 +- .../saml/okta-configure-api-integration.md | 2 +- .../reusables/saml/okta-edit-provisioning.md | 2 +- .../saml/okta-enable-api-integration.md | 2 +- .../reusables/saml/okta-provisioning-tab.md | 2 +- .../reusables/saml/okta-save-provisioning.md | 2 +- .../data/reusables/saml/okta-sign-on-tab.md | 2 +- .../saml/okta-view-setup-instructions.md | 2 +- .../data/reusables/saml/search-ghec-okta.md | 2 +- .../data/reusables/saml/use-classic-ui.md | 2 +- .../reusables/scim/enterprise-account-scim.md | 2 +- .../data/reusables/search/syntax_tips.md | 2 +- .../data/reusables/secret-scanning/beta.md | 2 +- ...-and-analysis-features-enable-read-only.md | 5 +- .../data/reusables/shortdesc/iso_8601.md | 2 +- .../reusables/sponsors/edit-featured-work.md | 2 +- .../data/reusables/sponsors/meet-the-team.md | 2 +- .../sponsors/navigate-to-your-goals-tab.md | 2 +- .../sponsors/opt-in-to-being-featured.md | 2 +- .../data/reusables/sponsors/publish-goal.md | 2 +- .../data/reusables/sponsors/retire-goal.md | 2 +- .../data/reusables/sponsors/save-profile.md | 2 +- .../data/reusables/sponsors/set-a-goal.md | 2 +- .../data/reusables/sponsors/short-bio.md | 2 +- .../sponsors/stripe-supported-regions.md | 2 +- .../you-can-be-a-sponsored-developer.md | 2 +- .../you-can-be-a-sponsored-organization.md | 2 +- .../de-DE/data/reusables/ssh/dsa-support.md | 2 +- .../reusables/support/about-premium-plans.md | 20 +- .../support/ghec-premium-priorities.md | 10 +- .../data/reusables/support/ghes-priorities.md | 10 +- .../support/priority-urgent-english-only.md | 2 +- .../reusables/support/receiving-credits.md | 6 +- .../reusables/support/scope-of-support.md | 2 +- .../service-level-agreement-response-times.md | 4 +- .../de-DE/data/reusables/two_fa/about-2fa.md | 1 + .../two_fa/after-2fa-add-security-key.md | 2 +- .../data/reusables/two_fa/auth_methods_2fa.md | 12 +- .../about-commit-email-addresses.md | 2 +- .../reusables/user_settings/export-data.md | 3 +- .../password-authentication-deprecation.md | 2 +- .../user_settings/personal_dashboard.md | 2 +- .../set_your_email_address_in_git.md | 2 +- .../user_settings/sudo-mode-popup.md | 2 +- .../reusables/webhooks/action_type_desc.md | 2 +- .../de-DE/data/reusables/webhooks/app_desc.md | 2 +- .../webhooks/check_run_properties.md | 18 +- .../webhooks/check_run_short_desc.md | 2 +- .../webhooks/check_suite_properties.md | 18 +- .../webhooks/check_suite_short_desc.md | 2 +- .../code_scanning_alert_event_short_desc.md | 2 +- .../webhooks/commit_comment_properties.md | 2 +- .../webhooks/commit_comment_short_desc.md | 2 +- .../webhooks/content_reference_short_desc.md | 2 +- .../reusables/webhooks/create_properties.md | 12 +- .../reusables/webhooks/create_short_desc.md | 2 +- .../reusables/webhooks/delete_properties.md | 8 +- .../reusables/webhooks/delete_short_desc.md | 2 +- .../webhooks/deploy_key_properties.md | 2 +- .../webhooks/deploy_key_short_desc.md | 2 +- .../webhooks/deployment_short_desc.md | 2 +- .../webhooks/deployment_status_short_desc.md | 2 +- .../webhooks/enterprise_short_desc.md | 2 +- .../reusables/webhooks/events_api_payload.md | 2 +- .../reusables/webhooks/fork_properties.md | 2 +- .../reusables/webhooks/fork_short_desc.md | 2 +- .../reusables/webhooks/gollum_properties.md | 2 +- .../reusables/webhooks/gollum_short_desc.md | 2 +- .../webhooks/installation_properties.md | 2 +- .../installation_repositories_properties.md | 2 +- .../installation_repositories_short_desc.md | 2 +- .../webhooks/installation_short_desc.md | 2 +- .../webhooks/issue_comment_properties.md | 2 +- .../webhooks/issue_comment_short_desc.md | 2 +- .../issue_comment_webhook_properties.md | 2 +- .../webhooks/issue_event_api_properties.md | 2 +- .../reusables/webhooks/issue_properties.md | 2 +- .../webhooks/issue_webhook_properties.md | 2 +- .../reusables/webhooks/issues_short_desc.md | 2 +- .../reusables/webhooks/label_short_desc.md | 2 +- .../webhooks/member_event_api_properties.md | 2 +- .../reusables/webhooks/member_properties.md | 2 +- .../reusables/webhooks/member_short_desc.md | 2 +- .../webhooks/member_webhook_properties.md | 2 +- .../webhooks/membership_properties.md | 2 +- .../webhooks/membership_short_desc.md | 2 +- .../webhooks/milestone_properties.md | 2 +- .../webhooks/milestone_short_desc.md | 2 +- .../webhooks/org_block_short_desc.md | 2 +- .../de-DE/data/reusables/webhooks/org_desc.md | 2 +- .../webhooks/organization_short_desc.md | 2 +- .../reusables/webhooks/package_properties.md | 2 +- .../webhooks/page_build_short_desc.md | 2 +- .../data/reusables/webhooks/payload_url.md | 2 +- .../reusables/webhooks/ping_short_desc.md | 2 +- .../webhooks/project_card_properties.md | 2 +- .../webhooks/project_card_short_desc.md | 2 +- .../webhooks/project_column_properties.md | 2 +- .../webhooks/project_column_short_desc.md | 2 +- .../reusables/webhooks/project_properties.md | 2 +- .../reusables/webhooks/project_short_desc.md | 2 +- .../reusables/webhooks/public_short_desc.md | 2 +- .../pull_request_event_api_properties.md | 2 +- .../webhooks/pull_request_properties.md | 2 +- ...est_review_comment_event_api_properties.md | 2 +- .../pull_request_review_comment_properties.md | 2 +- .../pull_request_review_comment_short_desc.md | 2 +- ...quest_review_comment_webhook_properties.md | 2 +- .../pull_request_review_properties.md | 2 +- .../pull_request_review_short_desc.md | 2 +- .../webhooks/pull_request_short_desc.md | 2 +- .../pull_request_webhook_properties.md | 2 +- .../reusables/webhooks/push_short_desc.md | 2 +- .../webhooks/release_event_api_properties.md | 2 +- .../reusables/webhooks/release_properties.md | 2 +- .../reusables/webhooks/release_short_desc.md | 2 +- .../webhooks/release_webhook_properties.md | 6 +- .../data/reusables/webhooks/repo_desc.md | 2 +- .../webhooks/repository_import_properties.md | 2 +- .../webhooks/repository_import_short_desc.md | 2 +- .../webhooks/repository_short_desc.md | 2 +- ...pository_vulnerability_alert_properties.md | 2 +- ...pository_vulnerability_alert_short_desc.md | 2 +- .../de-DE/data/reusables/webhooks/secret.md | 2 +- .../data/reusables/webhooks/sender_desc.md | 2 +- .../sponsorship_event_api_properties.md | 2 +- .../webhooks/sponsorship_properties.md | 2 +- .../webhooks/sponsorship_short_desc.md | 2 +- .../sponsorship_webhook_properties.md | 2 +- .../reusables/webhooks/star_properties.md | 8 +- .../reusables/webhooks/star_short_desc.md | 2 +- .../reusables/webhooks/status_short_desc.md | 2 +- .../reusables/webhooks/team_add_short_desc.md | 2 +- .../reusables/webhooks/team_short_desc.md | 2 +- .../reusables/webhooks/watch_properties.md | 2 +- .../reusables/webhooks/watch_short_desc.md | 2 +- .../data/reusables/webhooks/webhooks_ssl.md | 2 +- .../reusables/webhooks/workflow_run_desc.md | 2 +- .../de-DE/data/variables/command_line.yml | 4 +- translations/de-DE/data/variables/contact.yml | 11 +- translations/de-DE/data/variables/explore.yml | 6 +- translations/de-DE/data/variables/gists.yml | 6 +- .../de-DE/data/variables/notifications.yml | 4 +- translations/de-DE/data/variables/product.yml | 21 +- translations/de-DE/data/variables/search.yml | 10 +- .../developers/apps/authorizing-oauth-apps.md | 236 +-- ...ating-a-github-app-using-url-parameters.md | 190 +-- ...g-and-authorizing-users-for-github-apps.md | 1269 ++++++++--------- .../developers/apps/scopes-for-oauth-apps.md | 124 +- .../webhooks-and-events/about-webhooks.md | 23 +- ...classifying-your-repository-with-topics.md | 40 +- ...ling-force-pushes-to-a-protected-branch.md | 23 +- .../error-permission-denied-publickey.md | 126 +- .../reviewing-your-security-log.md | 363 ++--- .../reviewing-your-ssh-keys.md | 62 +- .../locking-conversations.md | 42 +- .../managing-disruptive-comments.md | 83 +- ...repositories-with-code-quality-features.md | 4 +- .../resolving-a-merge-conflict-on-github.md | 60 +- ...creating-a-commit-with-multiple-authors.md | 61 +- .../about-repository-visibility.md | 23 +- .../backing-up-a-repository.md | 41 +- .../creating-a-template-repository.md | 15 +- .../about-code-scanning.md | 2 +- .../configuring-code-scanning.md | 198 ++- ...enabling-code-scanning-for-a-repository.md | 88 +- ...-codeql-code-scanning-in-your-ci-system.md | 161 +++ .../troubleshooting-the-codeql-workflow.md | 125 ++ ...oving-files-from-git-large-file-storage.md | 40 +- ...bout-alerts-for-vulnerable-dependencies.md | 6 +- ...attachments-on-issues-and-pull-requests.md | 27 +- .../adding-organization-members-to-a-team.md | 13 +- ...-collaborator-to-an-organization-member.md | 19 +- ...ithub-pages-sites-for-your-organization.md | 10 +- ...llaborators-access-to-your-organization.md | 52 +- ...ing-the-audit-log-for-your-organization.md | 8 +- ...ur-organizations-installed-integrations.md | 19 +- ...ssions-for-adding-outside-collaborators.md | 12 +- .../changing-your-github-username.md | 58 +- ...on-levels-for-a-user-account-repository.md | 93 +- ...d-data-protection-for-your-organization.md | 40 +- .../about-the-dependency-graph.md | 3 +- .../viewing-traffic-to-a-repository.md | 17 +- ...reating-a-github-pages-site-with-jekyll.md | 51 +- ...yll-build-errors-for-github-pages-sites.md | 154 +- ...ache-maven-for-use-with-github-packages.md | 64 +- ...ing-docker-for-use-with-github-packages.md | 96 +- ...guring-npm-for-use-with-github-packages.md | 120 +- ...ing-github-packages-with-github-actions.md | 32 +- .../reusables/gated-features/draft-prs.md | 2 +- .../docker_registry_deprecation_status.md | 5 + .../pages/private_pages_are_public_warning.md | 2 +- .../repositories/about-internal-repos.md | 2 +- .../reusables/repositories/you-can-fork.md | 4 +- .../about-commit-email-addresses.md | 2 +- .../actions/creating-actions/about-actions.md | 60 +- .../creating-a-composite-run-steps-action.md | 37 +- .../creating-a-docker-container-action.md | 8 +- .../creating-a-javascript-action.md | 18 +- .../dockerfile-support-for-github-actions.md | 6 +- .../content/actions/creating-actions/index.md | 5 +- .../metadata-syntax-for-github-actions.md | 8 +- .../setting-exit-codes-for-actions.md | 4 +- .../guides/about-continuous-integration.md | 63 + .../about-packaging-with-github-actions.md | 47 + .../guides/about-service-containers.md | 117 ++ .../building-and-testing-java-with-ant.md | 109 ++ .../building-and-testing-java-with-gradle.md | 134 ++ .../building-and-testing-java-with-maven.md | 135 ++ .../guides/building-and-testing-nodejs.md | 276 ++++ .../guides/building-and-testing-python.md | 463 ++++++ ...hing-dependencies-to-speed-up-workflows.md | 192 +++ .../creating-postgresql-service-containers.md | 335 +++++ .../creating-redis-service-containers.md | 325 +++++ .../ja-JP/content/actions/guides/index.md | 60 + .../guides/publishing-docker-images.md | 158 ++ .../publishing-java-packages-with-gradle.md | 219 +++ .../publishing-java-packages-with-maven.md | 210 +++ .../guides/publishing-nodejs-packages.md | 210 +++ ...us-integration-using-workflow-templates.md | 43 + .../storing-workflow-data-as-artifacts.md | 248 ++++ .../about-self-hosted-runners.md | 11 +- .../adding-self-hosted-runners.md | 7 +- ...-hosted-runner-application-as-a-service.md | 2 +- .../actions/hosting-your-own-runners/index.md | 2 +- ...ess-to-self-hosted-runners-using-groups.md | 2 +- ...and-troubleshooting-self-hosted-runners.md | 4 +- .../removing-self-hosted-runners.md | 7 +- ...a-proxy-server-with-self-hosted-runners.md | 2 +- .../using-labels-with-self-hosted-runners.md | 2 +- ...using-self-hosted-runners-in-a-workflow.md | 4 +- translations/ja-JP/content/actions/index.md | 58 +- .../essential-features-of-github-actions.md | 95 ++ .../finding-and-customizing-actions.md | 156 ++ .../actions/learn-github-actions/index.md | 42 + .../introduction-to-github-actions.md | 225 +++ .../managing-complex-workflows.md | 151 ++ ...-from-azure-pipelines-to-github-actions.md | 327 +++++ ...grating-from-circleci-to-github-actions.md | 447 ++++++ ...ting-from-gitlab-cicd-to-github-actions.md | 476 +++++++ ...igrating-from-jenkins-to-github-actions.md | 293 ++++ .../security-hardening-for-github-actions.md | 97 ++ ...haring-workflows-with-your-organization.md | 112 ++ .../adding-a-workflow-status-badge.md | 60 + .../canceling-a-workflow.md | 31 + .../deleting-a-workflow-run.md | 23 + .../disabling-and-enabling-a-workflow.md | 45 + .../downloading-workflow-artifacts.md | 22 + .../enabling-debug-logging.md | 38 + .../actions/managing-workflow-runs/index.md | 32 + .../manually-running-a-workflow.md | 31 + .../re-running-a-workflow.md | 19 + .../removing-workflow-artifacts.md | 41 + .../using-workflow-run-logs.md | 86 ++ .../viewing-job-execution-time.md | 24 + .../viewing-workflow-run-history.md | 18 + .../ja-JP/content/actions/quickstart.md | 9 +- .../reference/authentication-in-a-workflow.md | 100 ++ ...nd-expression-syntax-for-github-actions.md | 92 +- .../actions/reference/encrypted-secrets.md | 221 +++ .../reference/environment-variables.md | 69 + .../events-that-trigger-workflows.md | 403 ++++-- .../ja-JP/content/actions/reference/index.md | 42 +- ...pecifications-for-github-hosted-runners.md | 149 ++ ...usage-limits-billing-and-administration.md | 88 ++ .../workflow-commands-for-github-actions.md | 125 +- .../workflow-syntax-for-github-actions.md | 138 +- ...or-users-outside-your-identity-provider.md | 4 +- .../disabling-unauthenticated-sign-ups.md | 2 +- .../content/admin/authentication/using-cas.md | 6 +- .../admin/authentication/using-ldap.md | 20 +- .../admin/authentication/using-saml.md | 20 +- .../configuration/command-line-utilities.md | 7 +- .../configuration/configuring-applications.md | 4 +- ...guring-code-scanning-for-your-appliance.md | 14 +- .../configuration/configuring-rate-limits.md | 2 +- ...dress-using-the-virtual-machine-console.md | 8 + .../admin/configuration/configuring-tls.md | 2 +- ...prise-server-to-github-enterprise-cloud.md | 6 +- ...ependencies-on-github-enterprise-server.md | 46 +- .../enabling-subdomain-isolation.md | 37 +- .../content/admin/configuration/index.md | 10 +- .../admin/configuration/network-ports.md | 24 +- .../configuration/site-admin-dashboard.md | 4 +- .../troubleshooting-ssl-errors.md | 2 +- .../about-geo-replication.md | 2 +- .../about-high-availability-configuration.md | 11 +- .../accessing-the-monitor-dashboard.md | 12 +- .../cluster-network-configuration.md | 1 - .../creating-a-high-availability-replica.md | 4 +- .../increasing-storage-capacity.md | 2 +- .../admin/enterprise-management/index.md | 7 +- .../initializing-the-cluster.md | 4 +- .../monitoring-cluster-nodes.md | 50 +- ...-virtual-machine-and-physical-resources.md | 2 +- .../upgrade-requirements.md | 2 +- .../upgrading-a-cluster.md | 2 +- .../upgrading-github-enterprise-server.md | 6 +- .../about-github-enterprise-support.md | 30 +- .../about-support-for-advanced-security.md | 4 +- ...com-actions-on-github-enterprise-server.md | 2 +- ...-githubcom-actions-using-github-connect.md | 2 +- ...-github-actions-and-configuring-storage.md | 2 +- ...ub-actions-policies-for-your-enterprise.md | 2 +- .../content/admin/github-actions/index.md | 2 +- ...naging-access-to-actions-from-githubcom.md | 2 - ...manually-syncing-actions-from-githubcom.md | 2 +- ...-hosted-runners-without-internet-access.md | 4 +- translations/ja-JP/content/admin/index.md | 2 +- ...erprise-server-on-google-cloud-platform.md | 3 +- ...thub-enterprise-server-on-openstack-kvm.md | 4 +- .../about-the-github-enterprise-server-api.md | 4 +- ...managing-your-github-enterprise-license.md | 6 +- ...ing-github-packages-for-your-enterprise.md | 17 +- ...creating-a-pre-receive-hook-environment.md | 2 +- .../creating-a-pre-receive-hook-script.md | 8 +- .../enforcing-policies-for-your-enterprise.md | 4 +- ...enforcing-policy-with-pre-receive-hooks.md | 2 +- ...-management-policies-in-your-enterprise.md | 115 +- .../ja-JP/content/admin/policies/index.md | 4 +- .../admin/user-management/audit-logging.md | 2 +- .../admin/user-management/audited-actions.md | 58 +- .../admin/user-management/creating-teams.md | 12 +- ...tomizing-user-messages-on-your-instance.md | 2 +- .../user-management/managing-dormant-users.md | 36 +- .../managing-global-webhooks.md | 2 +- ...naging-organizations-in-your-enterprise.md | 2 +- .../monitoring-activity-in-your-enterprise.md | 2 - ...moting-or-demoting-a-site-administrator.md | 4 +- .../rebuilding-contributions-data.md | 3 +- ...ving-users-from-teams-and-organizations.md | 2 +- ...ctor-authentication-for-an-organization.md | 2 +- .../searching-the-audit-log.md | 30 +- .../suspending-and-unsuspending-users.md | 2 +- .../troubleshooting-service-hooks.md | 2 +- ...epository-from-github-to-github-desktop.md | 8 +- ...orking-repositories-from-github-desktop.md | 8 +- .../creating-an-issue-or-pull-request.md | 10 +- .../index.md | 2 +- .../about-connections-to-github.md | 12 +- .../authenticating-to-github.md | 32 +- ...figuring-and-customizing-github-desktop.md | 2 +- .../configuring-basic-settings.md | 2 +- .../configuring-git-for-github-desktop.md | 14 +- .../getting-started-with-github-desktop.md | 4 +- .../index.md | 4 +- .../keyboard-shortcuts.md | 110 +- ...ng-github-desktop-from-the-command-line.md | 8 +- .../supported-operating-systems.md | 50 +- .../uninstalling-github-desktop.md | 18 +- .../content/developers/apps/about-apps.md | 2 +- .../apps/activating-beta-features-for-apps.md | 3 +- .../developers/apps/authorizing-oauth-apps.md | 114 +- ...ating-a-custom-badge-for-your-oauth-app.md | 5 +- .../creating-a-github-app-from-a-manifest.md | 6 +- ...ating-a-github-app-using-url-parameters.md | 164 +-- .../creating-ci-tests-with-the-checks-api.md | 105 +- ...nces-between-github-apps-and-oauth-apps.md | 16 +- .../apps/editing-a-github-apps-permissions.md | 18 +- ...g-and-authorizing-users-for-github-apps.md | 189 ++- .../migrating-oauth-apps-to-github-apps.md | 1 - .../developers/apps/modifying-an-oauth-app.md | 6 +- ...refreshing-user-to-server-access-tokens.md | 6 +- .../developers/apps/scopes-for-oauth-apps.md | 100 +- ...ment-environment-to-create-a-github-app.md | 1 - .../suspending-a-github-app-installation.md | 10 +- .../apps/using-the-github-api-in-your-app.md | 1 - .../drafting-a-listing-for-your-app.md | 5 +- .../viewing-metrics-for-your-listing.md | 3 +- .../viewing-transactions-for-your-listing.md | 3 +- ...k-events-for-the-github-marketplace-api.md | 6 +- .../overview/managing-deploy-keys.md | 1 - .../overview/replacing-github-services.md | 1 - .../webhooks-and-events/about-webhooks.md | 9 +- .../webhooks-and-events/github-event-types.md | 3 +- .../webhooks-and-events/issue-event-types.md | 1 - .../securing-your-webhooks.md | 27 +- .../webhooks-and-events/testing-webhooks.md | 1 - .../webhook-events-and-payloads.md | 85 +- .../about-branch-restrictions.md | 10 +- ...fications-for-pushes-to-your-repository.md | 7 +- ...about-github-dependabot-version-updates.md | 8 +- .../about-protected-branches.md | 4 +- .../about-releases.md | 10 +- .../about-required-commit-signing.md | 4 +- ...for-release-forms-with-query-parameters.md | 2 +- .../changing-the-default-branch.md | 53 + ...classifying-your-repository-with-topics.md | 40 +- ...guration-options-for-dependency-updates.md | 70 +- ...tolinks-to-reference-external-resources.md | 2 +- .../configuring-protected-branches.md | 2 +- ...s-artifacts-and-logs-in-your-repository.md | 18 + ...zing-how-changed-files-appear-on-github.md | 2 +- ...g-your-repositorys-social-media-preview.md | 2 +- ...ining-the-mergeability-of-pull-requests.md | 2 +- ...nd-restoring-branches-in-a-pull-request.md | 5 +- ...imiting-github-actions-for-a-repository.md | 43 +- ...ing-a-sponsor-button-in-your-repository.md | 22 +- .../enabling-and-disabling-version-updates.md | 2 +- ...nymous-git-read-access-for-a-repository.md | 2 +- .../enabling-branch-restrictions.md | 4 +- ...ling-force-pushes-to-a-protected-branch.md | 23 +- .../administering-a-repository/index.md | 3 +- ...tions-up-to-date-with-github-dependabot.md | 2 +- .../managing-releases-in-a-repository.md | 9 +- .../managing-repository-settings.md | 2 +- ...ging-the-automatic-deletion-of-branches.md | 2 +- ...-the-forking-policy-for-your-repository.md | 4 +- .../releasing-projects-on-github.md | 2 +- .../setting-repository-visibility.md | 20 +- .../transferring-a-repository.md | 8 +- .../types-of-required-status-checks.md | 2 +- ...deployment-activity-for-your-repository.md | 2 +- .../about-authentication-to-github.md | 3 +- ...authentication-with-saml-single-sign-on.md | 2 +- .../about-commit-signature-verification.md | 7 +- .../authenticating-to-github/about-ssh.md | 7 +- .../about-two-factor-authentication.md | 6 +- ...-github-using-two-factor-authentication.md | 2 +- ...ng-a-new-ssh-key-to-your-github-account.md | 6 +- .../associating-an-email-with-your-gpg-key.md | 2 +- ...-token-for-use-with-saml-single-sign-on.md | 2 +- ...sh-key-for-use-with-saml-single-sign-on.md | 2 +- .../authorizing-oauth-apps.md | 2 +- .../checking-for-existing-gpg-keys.md | 2 +- .../checking-for-existing-ssh-keys.md | 5 +- ...t-and-tag-signature-verification-status.md | 4 +- ...-factor-authentication-recovery-methods.md | 4 +- .../configuring-two-factor-authentication.md | 38 +- ...onnecting-with-third-party-applications.md | 2 +- .../creating-a-personal-access-token.md | 6 +- ...uthentication-for-your-personal-account.md | 4 +- .../error-key-already-in-use.md | 2 +- .../error-permission-denied-publickey.md | 132 +- ...on-to-userrepo-denied-to-userother-repo.md | 2 +- .../error-ssh-add-illegal-option----k.md | 2 +- ...e-problem-verify-that-the-ca-cert-is-ok.md | 4 +- .../generating-a-new-gpg-key.md | 6 +- ...-ssh-key-and-adding-it-to-the-ssh-agent.md | 2 +- .../github/authenticating-to-github/index.md | 2 +- .../managing-commit-signature-verification.md | 2 +- ...ccount-if-you-lose-your-2fa-credentials.md | 5 +- .../recovering-your-ssh-key-passphrase.md | 2 +- ...moving-sensitive-data-from-a-repository.md | 20 +- ...wing-your-authorized-applications-oauth.md | 2 +- .../reviewing-your-security-log.md | 363 ++--- .../reviewing-your-ssh-keys.md | 62 +- .../signing-commits.md | 5 +- .../telling-git-about-your-signing-key.md | 2 +- ...updating-your-github-access-credentials.md | 6 +- .../working-with-ssh-key-passphrases.md | 5 +- .../about-issue-and-pull-request-templates.md | 4 +- .../about-team-discussions.md | 6 +- .../about-wikis.md | 2 +- ...dding-a-code-of-conduct-to-your-project.md | 2 +- ...dding-support-resources-to-your-project.md | 2 +- ...cking-a-user-from-your-personal-account.md | 2 +- .../collaborating-with-your-team.md | 2 +- ...ing-issue-templates-for-your-repository.md | 2 +- ...reating-a-default-community-health-file.md | 31 +- ...ll-request-template-for-your-repository.md | 4 +- .../creating-a-team-discussion.md | 2 +- .../documenting-your-project-with-wikis.md | 2 +- .../editing-or-deleting-a-team-discussion.md | 2 +- .../editing-wiki-content.md | 2 +- .../building-a-strong-community/index.md | 2 +- ...iting-interactions-in-your-organization.md | 2 +- ...imiting-interactions-in-your-repository.md | 2 +- .../locking-conversations.md | 42 +- .../managing-disruptive-comments.md | 83 +- ...ontent-in-your-organizations-repository.md | 2 +- ...ngle-issue-template-for-your-repository.md | 2 +- .../moderating-comments-and-conversations.md | 2 +- .../pinning-a-team-discussion.md | 2 +- .../reporting-abuse-or-spam.md | 2 +- ...-guidelines-for-repository-contributors.md | 4 +- ...-your-project-for-healthy-contributions.md | 2 +- .../tracking-changes-in-a-comment.md | 2 +- ...nblocking-a-user-from-your-organization.md | 2 +- .../viewing-a-wikis-history-of-changes.md | 2 +- ...-who-are-blocked-from-your-organization.md | 2 +- .../about-branches.md | 18 +- ...out-comparing-branches-in-pull-requests.md | 4 +- .../about-conversations-on-github.md | 2 +- .../about-forks.md | 6 +- .../about-merge-conflicts.md | 2 +- .../about-pull-request-reviews.md | 6 +- .../about-status-checks.md | 2 +- .../addressing-merge-conflicts.md | 2 +- ...pull-request-branch-created-from-a-fork.md | 2 +- ...ng-a-pull-request-with-required-reviews.md | 2 +- ...nging-the-base-branch-of-a-pull-request.md | 2 +- .../changing-the-stage-of-a-pull-request.md | 2 +- .../checking-out-pull-requests-locally.md | 2 +- ...repositories-with-code-quality-features.md | 4 +- .../commenting-on-a-pull-request.md | 4 +- ...pull-request-branch-created-from-a-fork.md | 4 +- .../creating-a-pull-request.md | 2 +- ...eleting-branches-within-your-repository.md | 2 +- .../dismissing-a-pull-request-review.md | 6 +- .../filtering-files-in-a-pull-request.md | 6 +- .../github-flow.md | 2 +- ...rporating-feedback-in-your-pull-request.md | 2 +- .../merging-a-pull-request.md | 6 +- ...g-an-upstream-repository-into-your-fork.md | 2 +- ...changes-to-your-work-with-pull-requests.md | 2 +- .../requesting-a-pull-request-review.md | 4 +- .../resolving-a-merge-conflict-on-github.md | 60 +- ...a-merge-conflict-using-the-command-line.md | 4 +- .../reviewing-changes-in-pull-requests.md | 2 +- ...wing-proposed-changes-in-a-pull-request.md | 6 +- .../working-with-pre-receive-hooks.md | 2 +- .../changing-a-commit-message.md | 21 +- .../commit-branch-and-tag-labels.md | 2 +- .../comparing-commits.md | 6 +- ...creating-a-commit-with-multiple-authors.md | 61 +- .../about-archiving-repositories.md | 4 +- .../about-code-owners.md | 7 +- .../about-readmes.md | 4 +- .../about-repositories.md | 3 +- .../about-repository-languages.md | 3 +- .../about-repository-visibility.md | 23 +- .../backing-up-a-repository.md | 41 +- .../cloning-a-repository-from-github.md | 2 +- .../cloning-a-repository.md | 4 +- .../creating-a-new-repository.md | 13 +- .../creating-a-repository-from-a-template.md | 2 +- .../creating-a-template-repository.md | 15 +- .../duplicating-a-repository.md | 2 +- ...s-to-nonexistent-ref-unable-to-checkout.md | 12 +- .../error-repository-not-found.md | 2 +- .../https-cloning-errors.md | 2 +- .../index.md | 2 +- .../licensing-a-repository.md | 7 +- .../about-github-marketplace.md | 2 +- .../about-billing-for-codespaces.md | 27 + .../about-codespaces.md | 6 +- ...configuring-codespaces-for-your-project.md | 8 +- .../creating-a-codespace.md | 2 +- .../index.md | 4 +- .../troubleshooting-your-codespace.md | 2 +- .../using-codespaces-in-visual-studio-code.md | 45 + .../using-codespaces-in-visual-studio.md | 53 + .../getting-started-with-the-api.md | 2 +- .../about-code-scanning.md | 2 +- .../about-integration-with-code-scanning.md | 10 +- ...our-code-for-vulnerabilities-and-errors.md | 1 + .../configuring-code-scanning.md | 200 ++- ...-codeql-code-scanning-in-your-ci-system.md | 165 +++ ...-codeql-workflow-for-compiled-languages.md | 116 ++ ...enabling-code-scanning-for-a-repository.md | 88 +- .../index.md | 14 +- .../integrating-with-code-scanning.md | 3 +- ...ode-scanning-alerts-for-your-repository.md | 63 + ...-codeql-code-scanning-in-your-ci-system.md | 161 +++ .../sarif-support-for-code-scanning.md | 171 +-- ...g-code-scanning-alerts-in-pull-requests.md | 48 + ...-codeql-code-scanning-in-your-ci-system.md | 52 + .../troubleshooting-the-codeql-workflow.md | 125 ++ .../uploading-a-sarif-file-to-github.md | 16 +- ...e-scanning-with-your-existing-ci-system.md | 11 + .../access-permissions-on-github.md | 4 +- .../getting-started-with-github/be-social.md | 2 +- .../create-a-repo.md | 4 +- .../faq-about-changes-to-githubs-plans.md | 4 +- .../following-people.md | 4 +- .../fork-a-repo.md | 10 +- .../git-and-github-learning-resources.md | 2 +- .../getting-started-with-github/github-cli.md | 2 +- .../github-desktop.md | 2 +- .../github-for-mobile.md | 12 +- .../githubs-products.md | 2 +- .../keyboard-shortcuts.md | 72 +- .../saving-repositories-with-stars.md | 5 +- ...-up-a-trial-of-github-enterprise-server.md | 2 +- .../supported-browsers.md | 2 +- .../types-of-github-accounts.md | 7 +- .../about-github-importer.md | 2 +- ...roject-to-github-using-the-command-line.md | 27 +- ...a-git-repository-using-the-command-line.md | 2 +- ...rting-a-repository-with-github-importer.md | 2 +- .../importing-source-code-to-github.md | 2 +- .../support-for-subversion-clients.md | 2 +- ...author-attribution-with-github-importer.md | 2 +- ...-differences-between-subversion-and-git.md | 2 +- translations/ja-JP/content/github/index.md | 2 +- ...-to-a-repository-using-the-command-line.md | 4 +- .../getting-permanent-links-to-files.md | 10 +- .../managing-files-using-the-command-line.md | 2 +- .../moving-a-file-to-a-new-location.md | 2 +- ...g-with-jupyter-notebook-files-on-github.md | 4 +- .../about-git-large-file-storage.md | 12 +- .../about-storage-and-bandwidth-usage.md | 3 +- .../conditions-for-large-files.md | 2 +- .../configuring-git-large-file-storage.md | 4 +- .../distributing-large-binaries.md | 2 +- .../installing-git-large-file-storage.md | 3 +- ...oving-files-from-git-large-file-storage.md | 40 +- .../working-with-large-files.md | 2 +- ...bout-alerts-for-vulnerable-dependencies.md | 6 +- .../about-github-security-advisories.md | 2 +- ...ring-github-dependabot-security-updates.md | 19 +- ...ecurity-vulnerabilities-in-your-project.md | 2 +- ...abilities-in-your-projects-dependencies.md | 2 +- ...a-collaborator-from-a-security-advisory.md | 2 +- .../about-notifications.md | 7 +- .../configuring-notifications.md | 168 +-- ...orkflow-for-triaging-your-notifications.md | 2 +- .../managing-notifications-from-your-inbox.md | 5 +- ...ng-subscriptions-for-activity-on-github.md | 2 +- .../managing-your-subscriptions.md | 2 +- .../setting-up-notifications.md | 2 +- .../triaging-a-single-notification.md | 2 +- .../viewing-and-triaging-notifications.md | 2 +- .../viewing-your-subscriptions.md | 2 +- ...and-pull-requests-with-query-parameters.md | 18 +- .../about-automation-for-project-boards.md | 2 +- .../about-issues.md | 10 +- .../about-labels.md | 22 +- .../about-project-boards.md | 2 +- ...es-and-pull-requests-to-a-project-board.md | 11 +- ...ying-labels-to-issues-and-pull-requests.md | 5 +- .../archiving-cards-on-a-project-board.md | 2 +- ...and-pull-requests-to-other-github-users.md | 2 +- .../changing-project-board-visibility.md | 2 +- .../closing-a-project-board.md | 4 +- .../creating-a-label.md | 4 +- .../creating-a-project-board.md | 10 +- .../creating-an-issue.md | 4 +- .../deleting-a-label.md | 4 +- .../disabling-issues.md | 3 +- .../editing-a-label.md | 4 +- ...attachments-on-issues-and-pull-requests.md | 27 +- .../filtering-cards-on-a-project-board.md | 8 +- ...g-issues-and-pull-requests-by-milestone.md | 2 +- .../finding-information-in-a-repository.md | 2 +- .../linking-a-pull-request-to-an-issue.md | 22 +- ...linking-a-repository-to-a-project-board.md | 2 +- .../opening-an-issue-from-code.md | 2 +- .../sharing-filters.md | 2 +- ...tracking-progress-on-your-project-board.md | 2 +- ...sferring-an-issue-to-another-repository.md | 6 +- ...arch-to-filter-issues-and-pull-requests.md | 4 +- ...ng-all-of-your-issues-and-pull-requests.md | 4 +- .../viewing-your-milestones-progress.md | 2 +- .../about-email-notifications.md | 22 +- .../about-notifications.md | 11 +- .../about-web-notifications.md | 4 +- .../accessing-your-notifications.md | 2 +- ...-delivery-method-for-your-notifications.md | 2 +- ...s-and-pull-requests-youre-subscribed-to.md | 6 +- .../managing-your-notifications.md | 2 +- .../marking-notifications-as-read.md | 4 +- .../saving-notifications-for-later.md | 2 +- ...to-and-unsubscribing-from-notifications.md | 15 +- .../watching-and-unwatching-repositories.md | 10 +- ...atching-and-unwatching-team-discussions.md | 12 +- .../about-searching-on-github.md | 6 +- .../searching-code.md | 4 +- .../searching-for-packages.md | 9 +- .../searching-issues-and-pull-requests.md | 4 +- .../sorting-search-results.md | 16 +- .../about-billing-for-github-actions.md | 6 +- .../about-billing-for-github-packages.md | 4 +- .../about-billing-on-github.md | 2 +- ...organizations-for-procurement-companies.md | 2 +- .../about-per-user-pricing.md | 2 +- ...-downgrading-affect-the-billing-process.md | 4 +- .../managing-your-github-billing-settings.md | 2 +- ...-your-spending-limit-for-github-actions.md | 4 +- ...your-spending-limit-for-github-packages.md | 4 +- ...renewing-your-clients-paid-organization.md | 2 +- .../upgrading-your-github-subscription.md | 4 +- .../viewing-your-github-actions-usage.md | 6 +- .../viewing-your-github-packages-usage.md | 4 +- ...ing-your-subscriptions-and-billing-date.md | 2 +- .../about-organizations.md | 1 - .../about-scim.md | 2 +- .../about-ssh-certificate-authorities.md | 6 +- .../about-teams.md | 2 +- .../about-your-organization-dashboard.md | 4 +- .../about-your-organizations-news-feed.md | 2 +- .../accessing-your-organizations-settings.md | 2 +- ...to-a-project-board-in-your-organization.md | 6 +- ...ithub-app-managers-in-your-organization.md | 4 +- .../adding-organization-members-to-a-team.md | 13 +- ...-accounts-for-people-in-my-organization.md | 2 +- ...saml-single-sign-on-and-scim-using-okta.md | 4 +- ...artifacts-and-logs-in-your-organization.md | 16 + ...am-to-improved-organization-permissions.md | 2 +- .../converting-an-organization-into-a-user.md | 2 +- ...ation-member-to-an-outside-collaborator.md | 4 +- ...-collaborator-to-an-organization-member.md | 19 +- ...am-to-improved-organization-permissions.md | 2 +- ...reating-a-new-organization-from-scratch.md | 2 +- .../deleting-an-organization-account.md | 2 +- ...ng-github-actions-for-your-organization.md | 44 +- ...ithub-pages-sites-for-your-organization.md | 10 +- ...r-permissions-to-an-organization-member.md | 2 +- ...r-organization-with-saml-single-sign-on.md | 2 +- .../index.md | 2 +- ...ra-with-your-organization-project-board.md | 2 +- ...nviting-users-to-join-your-organization.md | 4 +- .../keeping-your-organization-secure.md | 2 +- ...-project-board-for-organization-members.md | 2 +- ...ss-to-your-organizations-project-boards.md | 2 +- ...access-to-an-organization-project-board.md | 6 +- ...ls-access-to-an-organization-repository.md | 2 +- ...cess-to-your-organizations-repositories.md | 2 +- ...anaging-membership-in-your-organization.md | 2 +- .../managing-organization-settings.md | 2 +- ...-access-to-your-organization-with-roles.md | 2 +- ...analysis-settings-for-your-organization.md | 2 +- ...access-to-an-organization-project-board.md | 2 +- ...am-access-to-an-organization-repository.md | 2 +- ...e-for-repositories-in-your-organization.md | 9 +- ...ay-of-member-names-in-your-organization.md | 2 +- ...he-forking-policy-for-your-organization.md | 6 +- ...ganizations-ssh-certificate-authorities.md | 4 +- ...ms-to-improved-organization-permissions.md | 2 +- ...ng-to-improved-organization-permissions.md | 2 +- ...-a-team-in-your-organizations-hierarchy.md | 2 +- .../permission-levels-for-an-organization.md | 171 +-- ...aml-single-sign-on-in-your-organization.md | 2 +- ...tor-authentication-in-your-organization.md | 4 +- ...t-board-permissions-for-an-organization.md | 2 +- ...ng-a-former-member-of-your-organization.md | 4 +- ...llaborators-access-to-your-organization.md | 52 +- ...emoving-a-member-from-your-organization.md | 2 +- ...ator-from-an-organization-project-board.md | 2 +- ...hub-app-managers-from-your-organization.md | 4 +- .../renaming-an-organization.md | 4 +- ...y-permission-levels-for-an-organization.md | 206 +-- .../requesting-to-add-a-child-team.md | 2 +- ...questing-to-add-or-change-a-parent-team.md | 2 +- ...tor-authentication-in-your-organization.md | 28 +- ...ail-notifications-to-an-approved-domain.md | 2 +- ...epository-creation-in-your-organization.md | 8 +- ...visibility-changes-in-your-organization.md | 2 +- ...ing-the-audit-log-for-your-organization.md | 8 +- ...ur-organizations-installed-integrations.md | 19 +- ...ng-base-permissions-for-an-organization.md | 2 +- ...ssions-for-adding-outside-collaborators.md | 13 +- ...r-deleting-or-transferring-repositories.md | 2 +- .../setting-your-teams-profile-picture.md | 2 +- .../transferring-organization-ownership.md | 2 +- ...ading-to-the-corporate-terms-of-service.md | 4 +- ...embers-saml-access-to-your-organization.md | 2 +- .../viewing-insights-for-your-organization.md | 2 +- ...s-in-your-organization-have-2fa-enabled.md | 4 +- .../about-enterprise-accounts.md | 2 - ...cts-and-logs-in-your-enterprise-account.md | 19 + ...ncy-insights-in-your-enterprise-account.md | 2 +- ...ons-policies-in-your-enterprise-account.md | 15 +- ...ard-policies-in-your-enterprise-account.md | 2 +- ...ent-policies-in-your-enterprise-account.md | 2 +- ...ity-settings-in-your-enterprise-account.md | 2 +- ...eam-policies-in-your-enterprise-account.md | 2 +- .../index.md | 2 + ...dio-subscription-with-github-enterprise.md | 42 + .../roles-for-an-enterprise-account.md | 2 +- ...-saml-access-to-your-enterprise-account.md | 2 +- ...ewing-people-in-your-enterprise-account.md | 6 +- ...n-and-usage-for-your-enterprise-account.md | 4 +- .../about-your-organizations-profile.md | 2 +- .../about-your-profile.md | 4 +- ...ing-contribution-graphs-on-your-profile.md | 2 +- .../personalizing-your-profile.md | 14 +- .../pinning-items-to-your-profile.md | 2 +- ...roubleshooting-commits-on-your-timeline.md | 2 +- .../viewing-contributions-on-your-profile.md | 2 +- ...tributions-not-showing-up-on-my-profile.md | 4 +- .../about-your-personal-dashboard.md | 4 +- .../accessing-an-organization.md | 2 +- ...best-practices-for-leaving-your-company.md | 2 +- ...that-expose-your-personal-email-address.md | 2 +- .../changing-your-github-username.md | 58 +- .../changing-your-primary-email-address.md | 9 +- .../converting-a-user-into-an-organization.md | 6 +- .../deleting-your-user-account.md | 6 +- ...rating-jira-with-your-personal-projects.md | 2 +- ...-collaborators-to-a-personal-repository.md | 4 +- ...ss-to-your-user-accounts-project-boards.md | 6 +- ...fault-branch-name-for-your-repositories.md | 8 +- .../managing-user-account-settings.md | 2 +- ...naging-your-membership-in-organizations.md | 2 +- .../merging-multiple-user-accounts.md | 2 +- ...on-levels-for-a-user-account-repository.md | 91 +- ...on-levels-for-user-owned-project-boards.md | 2 +- ...izing-or-hiding-organization-membership.md | 2 +- ...collaborator-from-a-personal-repository.md | 2 +- ...ourself-from-a-collaborators-repository.md | 2 +- .../removing-yourself-from-an-organization.md | 2 +- .../setting-your-commit-email-address.md | 6 +- ...does-the-available-for-hire-checkbox-do.md | 2 +- .../github-additional-product-terms.md | 6 +- ...thub-enterprise-service-level-agreement.md | 4 +- ...d-data-protection-for-your-organization.md | 4 +- .../site-policy/github-privacy-statement.md | 8 +- .../github-subprocessors-and-cookies.md | 106 +- ...b-sponsors-for-open-source-contributors.md | 2 +- .../changing-your-sponsorship-tiers.md | 2 +- ...p-github-sponsors-for-your-organization.md | 2 +- ...p-github-sponsors-for-your-user-account.md | 2 +- .../sponsoring-an-open-source-contributor.md | 2 +- .../viewing-your-sponsors-and-sponsorships.md | 2 +- .../using-git/about-git-subtree-merges.md | 16 +- .../using-git/about-remote-repositories.md | 2 +- .../github/using-git/adding-a-remote.md | 2 +- .../using-git/changing-a-remotes-url.md | 2 +- .../configuring-git-to-handle-line-endings.md | 2 +- .../dealing-with-non-fast-forward-errors.md | 6 +- ...etting-changes-from-a-remote-repository.md | 2 +- .../pushing-commits-to-a-remote-repository.md | 2 +- .../github/using-git/removing-a-remote.md | 2 +- .../github/using-git/renaming-a-remote.md | 4 +- .../using-git-rebase-on-the-command-line.md | 2 +- .../which-remote-url-should-i-use.md | 4 +- ...hy-is-git-always-asking-for-my-password.md | 2 +- .../about-repository-graphs.md | 2 +- .../about-the-dependency-graph.md | 3 +- .../accessing-basic-repository-data.md | 2 +- ...lyzing-changes-to-a-repositorys-content.md | 2 +- ...loring-the-dependencies-of-a-repository.md | 15 +- ...anding-connections-between-repositories.md | 2 +- .../viewing-a-projects-contributors.md | 4 +- .../viewing-a-repositorys-network.md | 2 +- .../viewing-traffic-to-a-repository.md | 17 +- .../about-github-pages-and-jekyll.md | 5 +- .../about-github-pages.md | 26 +- ...yll-build-errors-for-github-pages-sites.md | 4 +- ...-to-your-github-pages-site-using-jekyll.md | 6 +- ...shing-source-for-your-github-pages-site.md | 10 +- ...reating-a-github-pages-site-with-jekyll.md | 49 +- .../creating-a-github-pages-site.md | 4 +- ...ustom-domain-for-your-github-pages-site.md | 3 +- ...yll-build-errors-for-github-pages-sites.md | 112 +- .../unpublishing-a-github-pages-site.md | 8 +- .../about-github-support.md | 14 +- .../github-marketplace-support.md | 2 +- .../autolinked-references-and-urls.md | 7 +- .../basic-writing-and-formatting-syntax.md | 7 +- .../creating-a-saved-reply.md | 2 +- .../writing-on-github/creating-gists.md | 7 +- .../deleting-a-saved-reply.md | 2 +- .../forking-and-cloning-gists.md | 2 +- ...d-with-writing-and-formatting-on-github.md | 2 +- .../organizing-information-with-tables.md | 2 +- .../writing-on-github/using-saved-replies.md | 2 +- .../working-with-advanced-formatting.md | 2 +- .../working-with-saved-replies.md | 2 +- .../guides/forming-calls-with-graphql.md | 2 +- .../ja-JP/content/graphql/guides/index.md | 2 +- .../guides/managing-enterprise-accounts.md | 4 +- .../content/graphql/overview/changelog.md | 2 +- translations/ja-JP/content/index.md | 6 +- ...n-github-enterprise-and-github-insights.md | 2 +- .../about-github-insights.md | 4 +- ...n-github-insights-and-github-enterprise.md | 5 +- .../installing-github-insights.md | 3 +- ...managing-permissions-in-github-insights.md | 2 +- .../about-github-container-registry.md | 34 +- ...-concepts-for-github-container-registry.md | 18 +- ...ontainer-registry-for-your-organization.md | 14 +- .../index.md | 6 +- ...ub-container-registry-for-docker-images.md | 62 +- ...rol-and-visibility-for-container-images.md | 58 +- ...cting-a-repository-to-a-container-image.md | 32 +- .../deleting-a-container-image.md | 20 +- .../index.md | 4 +- .../pushing-and-pulling-docker-images.md | 52 +- .../about-github-packages.md | 86 +- .../deleting-a-package.md | 1 - .../installing-a-package.md | 2 +- .../publishing-a-package.md | 7 +- .../viewing-packages.md | 4 +- ...ache-maven-for-use-with-github-packages.md | 60 +- ...ing-docker-for-use-with-github-packages.md | 90 +- ...dotnet-cli-for-use-with-github-packages.md | 95 +- ...ing-gradle-for-use-with-github-packages.md | 73 +- ...guring-npm-for-use-with-github-packages.md | 120 +- ...ing-github-packages-with-github-actions.md | 32 +- .../rest/guides/basics-of-authentication.md | 16 +- .../guides/best-practices-for-integrators.md | 7 +- .../rest/guides/delivering-deployments.md | 4 +- .../getting-started-with-the-checks-api.md | 6 +- ...tting-started-with-the-git-database-api.md | 6 +- .../getting-started-with-the-rest-api.md | 9 +- .../ja-JP/content/rest/guides/index.md | 2 +- .../rest/guides/rendering-data-as-graphs.md | 2 +- .../rest/guides/traversing-with-pagination.md | 4 +- .../rest/guides/working-with-comments.md | 2 +- .../content/rest/overview/api-previews.md | 30 +- .../endpoints-available-for-github-apps.md | 2 +- .../overview/other-authentication-methods.md | 7 +- .../overview/resources-in-the-rest-api.md | 4 +- .../ja-JP/content/rest/reference/actions.md | 14 +- .../ja-JP/content/rest/reference/activity.md | 26 +- .../ja-JP/content/rest/reference/apps.md | 2 - .../content/rest/reference/code-scanning.md | 14 + .../rest/reference/enterprise-admin.md | 23 +- .../ja-JP/content/rest/reference/gists.md | 2 +- .../content/rest/reference/interactions.md | 6 +- .../ja-JP/content/rest/reference/licenses.md | 4 +- .../permissions-required-for-github-apps.md | 109 +- .../ja-JP/content/rest/reference/repos.md | 138 +- .../ja-JP/data/glossaries/external.yml | 2 +- .../ja-JP/data/glossaries/internal.yml | 2 +- .../ja-JP/data/graphql/graphql_previews.yml | 51 - translations/ja-JP/data/products.yml | 11 +- .../actions/about-artifact-log-retention.md | 6 + .../data/reusables/actions/about-artifacts.md | 2 +- .../data/reusables/actions/about-secrets.md | 2 +- .../actions/about-self-hosted-runners.md | 2 +- .../reusables/actions/about-workflow-jobs.md | 2 +- .../reusables/actions/about-workflow-runs.md | 2 +- .../data/reusables/actions/about-workflows.md | 2 +- .../actions-app-actions-permissions-api.md | 2 +- .../actions/actions-authentication.md | 2 +- .../reusables/actions/actions-not-verified.md | 2 +- .../actions/actions-use-policy-settings.md | 3 + .../actions/allow-specific-actions-intro.md | 19 + .../actions/enterprise-actions-permissions.md | 2 +- .../data/reusables/actions/enterprise-beta.md | 2 +- .../enterprise-github-hosted-runners.md | 2 +- .../reusables/actions/registry-credentials.md | 1 + .../actions/scheduled-workflows-disabled.md | 1 + .../deprecating_auth_with_query_parameters.md | 4 +- .../apps/deprecating_github_services_ghe.md | 2 +- .../apps/deprecating_password_auth.md | 2 +- .../apps/general-apps-restrictions.md | 2 +- .../apps/maximum-github-apps-allowed.md | 2 +- .../apps/maximum-oauth-apps-allowed.md | 2 +- .../reusables/apps/metadata-permissions.md | 2 +- .../reusables/apps/oauth-apps-restrictions.md | 2 +- .../data/reusables/apps/state_description.md | 2 +- .../reusables/audit_log/audit-log-search.md | 2 - .../branches/change-default-branch.md | 1 + ...efault-branch-automatically-base-branch.md | 3 +- .../branches/new-repo-default-branch.md | 3 +- .../reusables/branches/set-default-branch.md | 2 +- .../reusables/code-scanning/analyze-go.md | 1 + .../autobuild-add-build-steps.md | 2 +- .../autobuild-compiled-languages.md | 6 +- .../code-scanning/beta-codeql-runner.md | 9 + .../data/reusables/code-scanning/beta.md | 6 +- .../code-scanning/click-alert-in-list.md | 2 +- .../code-scanning/close-alert-examples.md | 1 + .../code-scanning/codeql-runner-license.md | 8 +- .../reusables/code-scanning/edit-workflow.md | 2 +- .../code-scanning/enabling-options.md | 2 +- .../false-positive-fix-codeql.md | 1 + ...eroperable-with-tools-that-output-sarif.md | 2 +- .../code-scanning/run-additional-queries.md | 2 +- .../specify-language-to-analyze.md | 2 +- .../about-billing-for-codespaces.md | 1 + .../click-remote-explorer-icon-vscode.md | 2 +- .../codespaces/codespaces-are-per-branch.md | 2 +- .../codespaces/codespaces-are-personal.md | 2 +- .../connect-to-codespace-from-vscode.md | 2 +- .../codespaces/devcontainer-location.md | 1 + .../codespaces/navigate-to-codespaces.md | 2 +- .../reusables/codespaces/release-stage.md | 4 +- .../reusables/codespaces/unsupported-repos.md | 2 +- .../codespaces/use-visual-studio-features.md | 2 +- .../you-can-see-all-your-codespaces.md | 2 +- .../reusables/command_line/git-clone-url.md | 2 +- .../command_line/provide-an-access-token.md | 2 +- .../dependabot/check-in-dependabot-yml.md | 2 +- .../dependabot/create-dependabot-yml.md | 2 +- .../default-dependencies-allow-ignore.md | 2 +- .../reusables/dependabot/dependabot-tos.md | 2 +- .../option-affects-security-updates.md | 2 +- .../dependabot/private-dependencies.md | 2 +- .../dependabot/supported-package-managers.md | 44 +- .../data/reusables/desktop/choose-a-theme.md | 2 +- .../data/reusables/desktop/confirm-tag.md | 2 +- .../data/reusables/desktop/create-tag.md | 2 +- .../data/reusables/desktop/revert-commit.md | 2 +- .../reusables/desktop/select-base-branch.md | 2 +- .../reusables/dotcom_billing/add-seats.md | 2 +- .../dotcom_billing/confirm-add-seats.md | 2 +- .../dotcom_billing/number-of-seats.md | 2 +- .../reusables/dotcom_billing/upgrade_org.md | 2 +- .../education/about-github-education-link.md | 2 +- .../enterprise-accounts/access-enterprise.md | 4 +- .../data/reusables/enterprise/rate_limit.md | 3 +- .../configuration-file-heading.md | 2 +- ...placing-a-cluster-node-replacement-name.md | 4 +- .../submit-support-ticket-first-section.md | 16 +- .../submit-support-ticket-second-section.md | 3 +- .../aws-supported-instance-types.md | 7 +- .../hardware-rec-table.md | 10 +- .../necessary_ports.md | 24 +- .../when-9418-necessary.md | 1 + .../badge_indicator.md | 2 +- .../business.md | 2 +- .../packages-tab.md | 2 +- .../manage-global-webhooks-api.md | 2 +- .../files/commit-author-email-options.md | 3 +- .../data/reusables/gated-features/actions.md | 2 +- .../gated-features/code-review-assignment.md | 2 +- .../reusables/gated-features/code-scanning.md | 1 + .../gated-features/enterprise-accounts.md | 2 +- .../gated-features/more-info-org-products.md | 2 +- .../reusables/gated-features/more-info.md | 2 +- .../data/reusables/gated-features/packages.md | 3 +- .../gated-features/repository-insights.md | 2 +- .../github-actions/actions-billing.md | 2 +- .../github-actions/actions-on-examples.md | 16 +- .../github-actions/actions-unused-labels.md | 2 +- .../artifact-log-retention-statement.md | 2 + .../github-actions/branch-requirement.md | 2 +- ...nge-retention-period-for-artifacts-logs.md | 2 + .../disabled-actions-description.md | 2 +- .../disabling-github-actions.md | 2 +- .../docker-container-os-support.md | 2 +- .../github-actions/dockerfile-guidelines.md | 2 +- .../enabled-actions-description.md | 2 +- .../enabled-local-github-actions.md | 2 +- .../github-actions/expression-syntax-if.md | 2 +- .../github-actions/gradle-workflow-steps.md | 2 +- .../permissions-statement-secrets-api.md | 2 +- ...missions-statement-secrets-organization.md | 2 +- ...ermissions-statement-secrets-repository.md | 2 +- .../private-repository-forks-overview.md | 2 +- .../publish-to-maven-workflow-step.md | 2 +- .../publish-to-packages-workflow-step.md | 2 +- .../publishing-java-packages-intro.md | 2 +- .../github-actions/run_id_description.md | 2 +- .../github-actions/run_number_description.md | 2 +- ...ed-runner-configure-runner-group-access.md | 2 +- .../self-hosted-runner-list-group.md | 2 +- .../github-actions/self-hosted-runner-list.md | 2 +- ...-runner-management-permissions-required.md | 2 +- ...elf-hosted-runner-navigate-repo-and-org.md | 2 +- .../self-hosted-runner-removal-impact.md | 2 +- .../self-hosted-runner-reusing.md | 2 +- .../github-actions/sidebar-secret.md | 2 +- .../github-actions/usage-api-requests.md | 1 + .../github-actions/usage-matrix-limits.md | 1 + .../github-actions/usage-workflow-run-time.md | 1 + .../github-insights/choose-key-metric.md | 2 +- .../github-insights/enterprise-api-url.md | 2 +- .../navigate-to-key-metrics.md | 2 +- .../ja-JP/data/reusables/gpg/private-email.md | 3 +- .../enable-team-sync-azure.md | 2 +- .../enable-team-sync-okta.md | 2 +- .../supported-idps-team-sync.md | 2 +- .../sync-team-with-idp-group.md | 2 +- .../team-sync-disable.md | 2 +- .../team-sync-okta-requirements.md | 2 +- .../collaborator-user-limit-definition.md | 2 +- .../contributor-user-limit-definition.md | 2 +- .../existing-user-limit-definition.md | 2 +- .../interactions/interactions-detail.md | 2 +- .../issue-events/assignee-properties.md | 2 +- .../issue-event-common-properties.md | 2 +- .../issue-events/label-properties.md | 2 +- .../issue-events/project-card-properties.md | 2 +- .../review-dismissed-properties.md | 2 +- .../issue-events/review-request-properties.md | 2 +- .../timeline_events_object_properties.md | 2 +- .../can-include-lfs-objects-archives.md | 2 +- .../marketplace/cancellation-clarification.md | 2 +- .../marketplace/github_apps_preferred.md | 2 +- .../reusables/marketplace/launch-with-free.md | 2 +- .../reusables/marketplace/unverified-apps.md | 2 +- .../email-notification-caveats.md | 2 +- .../notifications-v2/manage-notifications.md | 2 +- .../reusables/notifications/shared_state.md | 2 +- .../organizations/can-require-ssh-cert.md | 2 +- .../oauth_app_restrictions_default.md | 2 +- .../organizations/organization-name.md | 2 +- .../organizations/organizations_include.md | 2 +- .../outside-collaborators-use-seats.md | 2 +- .../organizations/repository-labels.md | 2 +- .../organizations/send-invitation.md | 2 +- .../organizations/team_maintainers_can.md | 4 +- .../admins-can-configure-package-types.md | 4 +- .../package_registry/authenticate-packages.md | 8 +- ...uthenticate-to-container-registry-steps.md | 25 + ...nticate_with_pat_for_container_registry.md | 9 + .../container-registry-beta.md | 2 +- .../docker_registry_deprecation_status.md | 5 + .../package_registry/package-immutability.md | 4 +- .../package-settings-from-org-level.md | 2 +- .../public-or-private-packages.md | 2 +- .../data/reusables/pages/admin-must-push.md | 2 +- .../pages/best-with-supported-themes.md | 3 +- .../pages/build-locally-download-cname.md | 2 +- .../pages/decide-publishing-source.md | 2 +- .../reusables/pages/new-or-existing-repo.md | 2 +- .../pages/private_pages_are_public_warning.md | 2 +- .../ja-JP/data/reusables/policies/abuse.md | 2 +- .../machine-man-preview.md | 2 +- .../suspend-installation-beta.md | 3 +- .../data/reusables/profile/profile-readme.md | 2 +- .../link-repos-to-project-board.md | 2 +- .../project-board-import-with-api.md | 2 +- .../reusables/projects/disabled-projects.md | 2 +- .../automatically-delete-branches.md | 2 - .../close-issues-using-keywords.md | 2 +- ...ollect-co-author-commit-git-config-info.md | 2 +- .../default-commit-message-squash-merge.md | 2 +- .../pull_requests/mark-ready-review.md | 2 +- .../pull_request_merges_and_contributions.md | 2 +- .../reusables/reminders/author-reviews.md | 2 +- .../reusables/reminders/ignored-labels.md | 2 +- .../data/reusables/reminders/ignored-terms.md | 2 +- .../ja-JP/data/reusables/reminders/min-age.md | 2 +- .../data/reusables/reminders/min-staleness.md | 2 +- .../reusables/reminders/real-time-alerts.md | 2 +- .../reusables/reminders/required-labels.md | 2 +- .../about-github-archive-program.md | 2 +- .../repositories/about-internal-repos.md | 2 +- .../actions-workflow-status-badge-into.md | 2 +- .../repositories/blocked-passwords.md | 3 +- .../reusables/repositories/copy-clone-url.md | 6 +- .../repositories/default-issue-templates.md | 2 +- ...forks_from_private_repositories_warning.md | 6 +- .../repositories/enable-security-alerts.md | 2 +- .../navigate-to-job-superlinter.md | 5 + .../navigate-to-workflow-superlinter.md | 1 + .../repositories/open-with-github-desktop.md | 6 +- .../permissions-statement-read.md | 2 +- .../permissions-statement-write.md | 2 +- .../security-alert-delivery-options.md | 2 +- .../security-alerts-x-github-severity.md | 2 +- .../repositories/select-marketplace-apps.md | 4 +- .../repositories/sidebar-dependabot-alerts.md | 2 +- ...quash-and-rebase-linear-commit-hisitory.md | 2 +- .../repositories/start-line-comment.md | 2 +- .../reusables/repositories/suggest-changes.md | 2 +- .../view-failed-job-results-superlinter.md | 5 + .../repositories/view-run-superlinter.md | 1 + .../data/reusables/repositories/view-run.md | 2 +- .../view-specific-line-superlinter.md | 5 + .../reusables/repositories/you-can-fork.md | 4 +- .../reusables/saml/add-okta-application.md | 2 +- .../reusables/saml/assign-yourself-to-okta.md | 2 +- .../click-enterprise-account-application.md | 2 +- .../data/reusables/saml/okta-admin-button.md | 2 +- .../saml/okta-configure-api-integration.md | 2 +- .../reusables/saml/okta-edit-provisioning.md | 2 +- .../saml/okta-enable-api-integration.md | 2 +- .../reusables/saml/okta-provisioning-tab.md | 2 +- .../reusables/saml/okta-save-provisioning.md | 2 +- .../data/reusables/saml/okta-sign-on-tab.md | 2 +- .../saml/okta-view-setup-instructions.md | 2 +- .../data/reusables/saml/search-ghec-okta.md | 2 +- .../data/reusables/saml/use-classic-ui.md | 2 +- .../reusables/scim/enterprise-account-scim.md | 2 +- .../data/reusables/search/syntax_tips.md | 2 +- .../data/reusables/secret-scanning/beta.md | 2 +- ...-and-analysis-features-enable-read-only.md | 5 +- .../data/reusables/shortdesc/iso_8601.md | 2 +- .../reusables/sponsors/edit-featured-work.md | 2 +- .../data/reusables/sponsors/meet-the-team.md | 2 +- .../navigate-to-dev-sponsors-dashboard.md | 2 +- .../navigate-to-org-sponsors-dashboard.md | 2 +- .../sponsors/navigate-to-your-goals-tab.md | 2 +- .../sponsors/opt-in-to-being-featured.md | 2 +- .../data/reusables/sponsors/publish-goal.md | 2 +- .../data/reusables/sponsors/retire-goal.md | 2 +- .../data/reusables/sponsors/save-profile.md | 2 +- .../data/reusables/sponsors/set-a-goal.md | 2 +- .../data/reusables/sponsors/short-bio.md | 2 +- .../sponsors/stripe-supported-regions.md | 2 +- .../you-can-be-a-sponsored-developer.md | 2 +- .../you-can-be-a-sponsored-organization.md | 2 +- .../ja-JP/data/reusables/ssh/dsa-support.md | 2 +- .../reusables/support/about-premium-plans.md | 20 +- .../support/ghec-premium-priorities.md | 10 +- .../data/reusables/support/ghes-priorities.md | 10 +- .../support/priority-urgent-english-only.md | 2 +- .../reusables/support/receiving-credits.md | 2 +- .../service-level-agreement-response-times.md | 4 +- .../ja-JP/data/reusables/two_fa/about-2fa.md | 1 + .../two_fa/after-2fa-add-security-key.md | 2 +- .../data/reusables/two_fa/auth_methods_2fa.md | 14 +- .../about-commit-email-addresses.md | 2 +- .../reusables/user_settings/export-data.md | 3 +- .../password-authentication-deprecation.md | 2 +- .../user_settings/personal_dashboard.md | 2 +- .../set_your_email_address_in_git.md | 2 +- .../user_settings/sudo-mode-popup.md | 2 +- .../reusables/webhooks/action_type_desc.md | 2 +- .../ja-JP/data/reusables/webhooks/app_desc.md | 2 +- .../webhooks/check_run_properties.md | 18 +- .../webhooks/check_run_short_desc.md | 2 +- .../webhooks/check_suite_properties.md | 18 +- .../webhooks/check_suite_short_desc.md | 2 +- .../code_scanning_alert_event_short_desc.md | 2 +- .../webhooks/commit_comment_properties.md | 2 +- .../webhooks/commit_comment_short_desc.md | 2 +- .../webhooks/content_reference_short_desc.md | 2 +- .../reusables/webhooks/create_properties.md | 12 +- .../reusables/webhooks/create_short_desc.md | 2 +- .../reusables/webhooks/delete_properties.md | 8 +- .../reusables/webhooks/delete_short_desc.md | 2 +- .../webhooks/deploy_key_properties.md | 2 +- .../webhooks/deploy_key_short_desc.md | 2 +- .../webhooks/deployment_short_desc.md | 2 +- .../webhooks/deployment_status_short_desc.md | 2 +- .../webhooks/enterprise_short_desc.md | 2 +- .../reusables/webhooks/events_api_payload.md | 2 +- .../reusables/webhooks/fork_properties.md | 2 +- .../reusables/webhooks/fork_short_desc.md | 2 +- .../reusables/webhooks/gollum_properties.md | 2 +- .../reusables/webhooks/gollum_short_desc.md | 2 +- .../webhooks/installation_properties.md | 2 +- .../installation_repositories_properties.md | 2 +- .../installation_repositories_short_desc.md | 2 +- .../webhooks/installation_short_desc.md | 2 +- .../webhooks/issue_comment_properties.md | 2 +- .../webhooks/issue_comment_short_desc.md | 2 +- .../issue_comment_webhook_properties.md | 2 +- .../webhooks/issue_event_api_properties.md | 2 +- .../reusables/webhooks/issue_properties.md | 2 +- .../webhooks/issue_webhook_properties.md | 2 +- .../reusables/webhooks/issues_short_desc.md | 2 +- .../reusables/webhooks/label_short_desc.md | 2 +- .../webhooks/member_event_api_properties.md | 2 +- .../reusables/webhooks/member_properties.md | 2 +- .../reusables/webhooks/member_short_desc.md | 2 +- .../webhooks/member_webhook_properties.md | 2 +- .../webhooks/membership_properties.md | 2 +- .../webhooks/membership_short_desc.md | 2 +- .../webhooks/milestone_properties.md | 2 +- .../webhooks/milestone_short_desc.md | 2 +- .../webhooks/org_block_short_desc.md | 2 +- .../ja-JP/data/reusables/webhooks/org_desc.md | 2 +- .../webhooks/organization_short_desc.md | 2 +- .../reusables/webhooks/package_properties.md | 2 +- .../webhooks/page_build_short_desc.md | 2 +- .../data/reusables/webhooks/payload_url.md | 2 +- .../reusables/webhooks/ping_short_desc.md | 2 +- .../webhooks/project_card_properties.md | 2 +- .../webhooks/project_card_short_desc.md | 2 +- .../webhooks/project_column_properties.md | 2 +- .../webhooks/project_column_short_desc.md | 2 +- .../reusables/webhooks/project_properties.md | 2 +- .../reusables/webhooks/project_short_desc.md | 2 +- .../reusables/webhooks/public_short_desc.md | 2 +- .../pull_request_event_api_properties.md | 2 +- .../webhooks/pull_request_properties.md | 2 +- ...est_review_comment_event_api_properties.md | 2 +- .../pull_request_review_comment_properties.md | 2 +- .../pull_request_review_comment_short_desc.md | 2 +- ...quest_review_comment_webhook_properties.md | 2 +- .../pull_request_review_properties.md | 2 +- .../pull_request_review_short_desc.md | 2 +- .../webhooks/pull_request_short_desc.md | 2 +- .../pull_request_webhook_properties.md | 2 +- .../reusables/webhooks/push_short_desc.md | 2 +- .../webhooks/release_event_api_properties.md | 2 +- .../reusables/webhooks/release_properties.md | 2 +- .../reusables/webhooks/release_short_desc.md | 2 +- .../webhooks/release_webhook_properties.md | 6 +- .../data/reusables/webhooks/repo_desc.md | 2 +- .../webhooks/repository_import_properties.md | 2 +- .../webhooks/repository_import_short_desc.md | 2 +- .../webhooks/repository_short_desc.md | 2 +- ...pository_vulnerability_alert_properties.md | 2 +- ...pository_vulnerability_alert_short_desc.md | 2 +- .../ja-JP/data/reusables/webhooks/secret.md | 2 +- .../data/reusables/webhooks/sender_desc.md | 2 +- .../sponsorship_event_api_properties.md | 2 +- .../webhooks/sponsorship_properties.md | 2 +- .../webhooks/sponsorship_short_desc.md | 2 +- .../sponsorship_webhook_properties.md | 2 +- .../reusables/webhooks/star_properties.md | 8 +- .../reusables/webhooks/star_short_desc.md | 2 +- .../reusables/webhooks/status_short_desc.md | 2 +- .../reusables/webhooks/team_add_short_desc.md | 2 +- .../reusables/webhooks/team_short_desc.md | 2 +- .../reusables/webhooks/watch_properties.md | 2 +- .../reusables/webhooks/watch_short_desc.md | 2 +- .../data/reusables/webhooks/webhooks_ssl.md | 2 +- .../reusables/webhooks/workflow_run_desc.md | 2 +- .../ja-JP/data/variables/command_line.yml | 2 +- translations/ja-JP/data/variables/contact.yml | 11 +- translations/ja-JP/data/variables/explore.yml | 6 +- translations/ja-JP/data/variables/gists.yml | 6 +- .../ja-JP/data/variables/notifications.yml | 4 +- translations/ja-JP/data/variables/product.yml | 21 +- translations/ja-JP/data/variables/search.yml | 10 +- .../actions/creating-actions/about-actions.md | 10 +- .../creating-a-composite-run-steps-action.md | 19 +- .../creating-a-docker-container-action.md | 2 +- .../creating-a-javascript-action.md | 10 +- .../content/actions/creating-actions/index.md | 1 + .../metadata-syntax-for-github-actions.md | 4 +- .../setting-exit-codes-for-actions.md | 2 +- .../guides/about-continuous-integration.md | 63 + .../about-packaging-with-github-actions.md | 48 + .../guides/about-service-containers.md | 117 ++ .../building-and-testing-java-with-ant.md | 109 ++ .../building-and-testing-java-with-gradle.md | 134 ++ .../building-and-testing-java-with-maven.md | 135 ++ .../guides/building-and-testing-nodejs.md | 276 ++++ .../guides/building-and-testing-python.md | 427 ++++++ ...hing-dependencies-to-speed-up-workflows.md | 192 +++ .../creating-postgresql-service-containers.md | 335 +++++ .../creating-redis-service-containers.md | 325 +++++ .../ko-KR/content/actions/guides/index.md | 60 + .../guides/publishing-docker-images.md | 158 ++ .../publishing-java-packages-with-gradle.md | 219 +++ .../publishing-java-packages-with-maven.md | 210 +++ .../guides/publishing-nodejs-packages.md | 210 +++ ...us-integration-using-workflow-templates.md | 43 + .../storing-workflow-data-as-artifacts.md | 249 ++++ .../about-self-hosted-runners.md | 9 + .../adding-self-hosted-runners.md | 3 +- .../removing-self-hosted-runners.md | 3 +- translations/ko-KR/content/actions/index.md | 58 +- .../essential-features-of-github-actions.md | 95 ++ .../finding-and-customizing-actions.md | 156 ++ .../actions/learn-github-actions/index.md | 42 + .../introduction-to-github-actions.md | 225 +++ .../managing-complex-workflows.md | 151 ++ ...-from-azure-pipelines-to-github-actions.md | 327 +++++ ...grating-from-circleci-to-github-actions.md | 447 ++++++ ...ting-from-gitlab-cicd-to-github-actions.md | 476 +++++++ ...igrating-from-jenkins-to-github-actions.md | 293 ++++ .../security-hardening-for-github-actions.md | 97 ++ ...haring-workflows-with-your-organization.md | 114 ++ .../adding-a-workflow-status-badge.md | 63 + .../canceling-a-workflow.md | 31 + .../deleting-a-workflow-run.md | 23 + .../disabling-and-enabling-a-workflow.md | 45 + .../downloading-workflow-artifacts.md | 22 + .../enabling-debug-logging.md | 38 + .../actions/managing-workflow-runs/index.md | 32 + .../manually-running-a-workflow.md | 31 + .../re-running-a-workflow.md | 19 + .../removing-workflow-artifacts.md | 41 + .../using-workflow-run-logs.md | 86 ++ .../viewing-job-execution-time.md | 24 + .../viewing-workflow-run-history.md | 18 + .../ko-KR/content/actions/quickstart.md | 7 +- .../reference/authentication-in-a-workflow.md | 100 ++ ...nd-expression-syntax-for-github-actions.md | 88 +- .../actions/reference/encrypted-secrets.md | 221 +++ .../reference/environment-variables.md | 69 + .../events-that-trigger-workflows.md | 218 +-- .../ko-KR/content/actions/reference/index.md | 40 +- ...pecifications-for-github-hosted-runners.md | 149 ++ ...usage-limits-billing-and-administration.md | 88 ++ .../workflow-commands-for-github-actions.md | 123 +- .../workflow-syntax-for-github-actions.md | 126 +- ...-your-github-enterprise-server-instance.md | 1 - .../content/admin/authentication/index.md | 1 - .../content/admin/authentication/using-cas.md | 4 +- .../admin/authentication/using-ldap.md | 20 +- .../admin/authentication/using-saml.md | 14 +- .../accessing-the-management-console.md | 1 - .../configuration/command-line-utilities.md | 5 +- .../configuring-advanced-security-features.md | 2 - .../configuration/configuring-applications.md | 4 +- .../configuring-built-in-firewall-rules.md | 1 - ...guring-code-scanning-for-your-appliance.md | 12 +- .../configuring-dns-nameservers.md | 1 - .../configuring-network-settings.md | 1 - ...dress-using-the-virtual-machine-console.md | 8 + .../configuring-your-enterprise.md | 1 - ...prise-server-to-github-enterprise-cloud.md | 6 +- ...ependencies-on-github-enterprise-server.md | 3 +- .../enabling-subdomain-isolation.md | 37 +- .../content/admin/configuration/index.md | 11 +- ...rise-server-and-github-enterprise-cloud.md | 1 - .../admin/configuration/network-ports.md | 22 +- .../troubleshooting-ssl-errors.md | 1 - .../enterprise-management/about-clustering.md | 1 - .../about-geo-replication.md | 2 +- .../about-high-availability-configuration.md | 11 +- .../accessing-the-monitor-dashboard.md | 12 +- .../cluster-network-configuration.md | 1 - .../configuring-clustering.md | 1 - .../configuring-high-availability.md | 1 - .../creating-a-high-availability-replica.md | 2 +- .../increasing-storage-capacity.md | 1 - .../admin/enterprise-management/index.md | 6 +- .../initializing-the-cluster.md | 4 +- ...o-github-enterprise-server-214-or-later.md | 1 - .../monitoring-your-appliance.md | 1 - .../removing-a-high-availability-replica.md | 1 - .../replacing-a-cluster-node.md | 1 - .../setting-up-external-monitoring.md | 1 - ...-virtual-machine-and-physical-resources.md | 1 - .../about-support-for-advanced-security.md | 4 +- .../content/admin/enterprise-support/index.md | 1 - .../preparing-to-submit-a-ticket.md | 1 - .../receiving-help-from-github-support.md | 1 - ...com-actions-on-github-enterprise-server.md | 3 - ...ub-actions-policies-for-your-enterprise.md | 2 - .../content/admin/github-actions/index.md | 1 - ...naging-access-to-actions-from-githubcom.md | 3 - ...-hosted-runners-without-internet-access.md | 2 +- translations/ko-KR/content/admin/index.md | 1 - .../ko-KR/content/admin/installation/index.md | 1 - ...erprise-server-on-google-cloud-platform.md | 3 +- ...thub-enterprise-server-on-openstack-kvm.md | 4 +- ...-up-a-github-enterprise-server-instance.md | 1 - .../overview/about-enterprise-accounts.md | 1 - .../about-the-github-enterprise-server-api.md | 5 +- ...managing-your-github-enterprise-license.md | 6 +- ...ng-packages-support-for-your-enterprise.md | 2 - ...guring-third-party-storage-for-packages.md | 2 - ...ing-github-packages-for-your-enterprise.md | 4 - .../ko-KR/content/admin/packages/index.md | 2 - .../admin/policies/about-pre-receive-hooks.md | 1 - .../creating-a-pre-receive-hook-script.md | 4 +- .../enforcing-policies-for-your-enterprise.md | 3 - ...enforcing-policy-with-pre-receive-hooks.md | 1 - ...-management-policies-in-your-enterprise.md | 3 +- .../ko-KR/content/admin/policies/index.md | 1 - .../user-management/adding-people-to-teams.md | 1 - .../admin/user-management/audit-logging.md | 1 - .../admin/user-management/audited-actions.md | 44 +- .../best-practices-for-user-security.md | 1 - .../admin/user-management/creating-teams.md | 4 +- ...exporting-migration-data-from-githubcom.md | 1 - ...ing-migration-data-from-your-enterprise.md | 1 - .../content/admin/user-management/index.md | 1 - ...naging-organizations-in-your-enterprise.md | 1 - .../managing-projects-using-jira.md | 1 - ...anaging-repositories-in-your-enterprise.md | 1 - .../managing-users-in-your-enterprise.md | 1 - ...rating-data-to-and-from-your-enterprise.md | 1 - .../monitoring-activity-in-your-enterprise.md | 3 - .../rebuilding-contributions-data.md | 3 +- .../searching-the-audit-log.md | 30 +- ...epository-from-github-to-github-desktop.md | 8 +- ...orking-repositories-from-github-desktop.md | 8 +- .../creating-an-issue-or-pull-request.md | 8 +- .../authenticating-to-github.md | 8 +- .../keyboard-shortcuts.md | 140 +- .../apps/activating-beta-features-for-apps.md | 3 +- .../developers/apps/authorizing-oauth-apps.md | 51 +- ...ating-a-custom-badge-for-your-oauth-app.md | 5 +- .../creating-a-github-app-from-a-manifest.md | 6 +- ...ating-a-github-app-using-url-parameters.md | 142 +- .../creating-ci-tests-with-the-checks-api.md | 103 +- ...nces-between-github-apps-and-oauth-apps.md | 16 +- .../apps/editing-a-github-apps-permissions.md | 2 + ...g-and-authorizing-users-for-github-apps.md | 93 +- .../migrating-oauth-apps-to-github-apps.md | 1 - .../developers/apps/modifying-an-oauth-app.md | 6 +- ...refreshing-user-to-server-access-tokens.md | 6 +- .../developers/apps/scopes-for-oauth-apps.md | 7 +- ...ment-environment-to-create-a-github-app.md | 1 - .../suspending-a-github-app-installation.md | 8 +- .../apps/using-the-github-api-in-your-app.md | 1 - .../drafting-a-listing-for-your-app.md | 5 +- .../viewing-metrics-for-your-listing.md | 3 +- .../viewing-transactions-for-your-listing.md | 3 +- ...k-events-for-the-github-marketplace-api.md | 6 +- .../overview/managing-deploy-keys.md | 1 - .../overview/replacing-github-services.md | 1 - .../webhooks-and-events/about-webhooks.md | 5 +- .../webhooks-and-events/github-event-types.md | 3 +- .../webhooks-and-events/issue-event-types.md | 1 - .../securing-your-webhooks.md | 27 +- .../webhooks-and-events/testing-webhooks.md | 1 - .../webhook-events-and-payloads.md | 85 +- .../about-branch-restrictions.md | 8 +- ...fications-for-pushes-to-your-repository.md | 3 +- ...about-github-dependabot-version-updates.md | 6 +- .../about-releases.md | 6 +- .../changing-the-default-branch.md | 53 + ...guration-options-for-dependency-updates.md | 32 +- ...tolinks-to-reference-external-resources.md | 2 +- ...s-artifacts-and-logs-in-your-repository.md | 18 + ...g-your-repositorys-social-media-preview.md | 2 +- ...nd-restoring-branches-in-a-pull-request.md | 3 +- ...imiting-github-actions-for-a-repository.md | 37 + ...ing-a-sponsor-button-in-your-repository.md | 22 +- .../enabling-branch-restrictions.md | 2 +- .../administering-a-repository/index.md | 3 +- ...tions-up-to-date-with-github-dependabot.md | 2 +- .../managing-releases-in-a-repository.md | 5 +- ...ging-the-automatic-deletion-of-branches.md | 2 +- .../about-authentication-to-github.md | 1 - .../about-commit-signature-verification.md | 3 +- .../authenticating-to-github/about-ssh.md | 5 +- .../about-two-factor-authentication.md | 2 +- ...ng-a-new-ssh-key-to-your-github-account.md | 2 +- .../authorizing-oauth-apps.md | 2 +- .../checking-for-existing-ssh-keys.md | 3 +- ...t-and-tag-signature-verification-status.md | 4 +- ...-factor-authentication-recovery-methods.md | 4 +- .../configuring-two-factor-authentication.md | 28 +- ...onnecting-with-third-party-applications.md | 2 +- .../error-bad-file-number.md | 2 +- .../error-permission-denied-publickey.md | 55 +- ...e-problem-verify-that-the-ca-cert-is-ok.md | 4 +- ...ccount-if-you-lose-your-2fa-credentials.md | 3 +- ...moving-sensitive-data-from-a-repository.md | 8 +- .../reviewing-your-security-log.md | 134 +- .../reviewing-your-ssh-keys.md | 41 +- .../signing-commits.md | 3 +- ...updating-your-github-access-credentials.md | 4 - .../working-with-ssh-key-passphrases.md | 5 +- ...reating-a-default-community-health-file.md | 16 +- .../about-branches.md | 14 +- ...out-comparing-branches-in-pull-requests.md | 4 +- .../about-forks.md | 2 +- .../about-status-checks.md | 2 +- ...pull-request-branch-created-from-a-fork.md | 4 +- .../creating-a-pull-request.md | 2 +- ...eleting-branches-within-your-repository.md | 2 +- .../dismissing-a-pull-request-review.md | 6 +- .../filtering-files-in-a-pull-request.md | 4 +- .../merging-a-pull-request.md | 4 +- ...g-an-upstream-repository-into-your-fork.md | 4 +- .../resolving-a-merge-conflict-on-github.md | 9 +- ...a-merge-conflict-using-the-command-line.md | 4 +- ...wing-proposed-changes-in-a-pull-request.md | 4 +- .../working-with-pre-receive-hooks.md | 2 +- .../changing-a-commit-message.md | 21 +- .../commit-branch-and-tag-labels.md | 2 +- .../comparing-commits.md | 2 +- .../about-archiving-repositories.md | 2 +- .../about-code-owners.md | 3 +- .../about-repositories.md | 3 +- .../about-repository-languages.md | 3 +- .../backing-up-a-repository.md | 15 +- .../cloning-a-repository.md | 4 +- .../creating-a-new-repository.md | 9 +- .../creating-a-repository-from-a-template.md | 2 +- .../creating-a-template-repository.md | 2 +- ...s-to-nonexistent-ref-unable-to-checkout.md | 10 +- .../licensing-a-repository.md | 1 + .../about-billing-for-codespaces.md | 27 + .../about-codespaces.md | 2 +- ...configuring-codespaces-for-your-project.md | 8 +- .../index.md | 4 +- .../using-codespaces-in-visual-studio-code.md | 45 + .../using-codespaces-in-visual-studio.md | 53 + .../about-code-scanning.md | 2 +- .../about-integration-with-code-scanning.md | 10 +- ...our-code-for-vulnerabilities-and-errors.md | 1 + .../configuring-code-scanning.md | 97 +- ...-codeql-code-scanning-in-your-ci-system.md | 165 +++ ...-codeql-workflow-for-compiled-languages.md | 116 ++ ...enabling-code-scanning-for-a-repository.md | 84 +- .../index.md | 14 +- .../integrating-with-code-scanning.md | 3 +- ...ode-scanning-alerts-for-your-repository.md | 63 + ...-codeql-code-scanning-in-your-ci-system.md | 162 +++ .../sarif-support-for-code-scanning.md | 171 +-- ...g-code-scanning-alerts-in-pull-requests.md | 48 + ...-codeql-code-scanning-in-your-ci-system.md | 52 + .../troubleshooting-the-codeql-workflow.md | 126 ++ .../uploading-a-sarif-file-to-github.md | 14 +- ...e-scanning-with-your-existing-ci-system.md | 11 + .../create-a-repo.md | 4 +- .../fork-a-repo.md | 8 +- .../github-for-mobile.md | 10 + .../githubs-products.md | 2 +- .../keyboard-shortcuts.md | 52 +- .../saving-repositories-with-stars.md | 3 +- .../types-of-github-accounts.md | 3 +- ...roject-to-github-using-the-command-line.md | 21 +- .../support-for-subversion-clients.md | 2 +- ...-to-a-repository-using-the-command-line.md | 4 +- .../getting-permanent-links-to-files.md | 4 +- ...g-with-jupyter-notebook-files-on-github.md | 4 +- .../about-git-large-file-storage.md | 11 +- .../about-storage-and-bandwidth-usage.md | 3 +- .../installing-git-large-file-storage.md | 3 +- ...bout-alerts-for-vulnerable-dependencies.md | 26 +- ...ring-github-dependabot-security-updates.md | 14 +- .../about-notifications.md | 3 +- .../configuring-notifications.md | 25 +- .../managing-notifications-from-your-inbox.md | 3 +- ...and-pull-requests-with-query-parameters.md | 18 +- .../about-issues.md | 6 +- .../about-labels.md | 22 +- ...es-and-pull-requests-to-a-project-board.md | 11 +- ...ying-labels-to-issues-and-pull-requests.md | 3 +- ...and-pull-requests-to-other-github-users.md | 2 +- .../disabling-issues.md | 3 +- .../filtering-cards-on-a-project-board.md | 6 +- .../linking-a-pull-request-to-an-issue.md | 14 +- ...sferring-an-issue-to-another-repository.md | 4 +- .../about-email-notifications.md | 18 +- .../about-notifications.md | 5 +- ...to-and-unsubscribing-from-notifications.md | 11 +- .../watching-and-unwatching-repositories.md | 2 - ...atching-and-unwatching-team-discussions.md | 12 +- .../about-searching-on-github.md | 4 +- .../searching-for-packages.md | 9 +- .../sorting-search-results.md | 16 +- .../about-billing-for-github-actions.md | 6 +- .../about-billing-for-github-packages.md | 4 +- ...-your-spending-limit-for-github-actions.md | 4 +- ...your-spending-limit-for-github-packages.md | 4 +- .../upgrading-your-github-subscription.md | 4 +- .../viewing-your-github-actions-usage.md | 6 +- .../viewing-your-github-packages-usage.md | 4 +- .../about-organizations.md | 1 - .../about-ssh-certificate-authorities.md | 2 +- ...to-a-project-board-in-your-organization.md | 4 +- ...ithub-app-managers-in-your-organization.md | 4 +- ...saml-single-sign-on-and-scim-using-okta.md | 4 +- ...artifacts-and-logs-in-your-organization.md | 16 + ...ng-github-actions-for-your-organization.md | 38 + .../index.md | 2 +- ...nviting-users-to-join-your-organization.md | 4 +- ...access-to-an-organization-project-board.md | 4 +- ...cess-to-your-organizations-repositories.md | 2 +- ...e-for-repositories-in-your-organization.md | 9 +- ...ay-of-member-names-in-your-organization.md | 2 +- ...ganizations-ssh-certificate-authorities.md | 2 +- .../permission-levels-for-an-organization.md | 169 +-- ...hub-app-managers-from-your-organization.md | 4 +- ...y-permission-levels-for-an-organization.md | 190 +-- ...tor-authentication-in-your-organization.md | 20 +- ...epository-creation-in-your-organization.md | 2 +- ...ing-the-audit-log-for-your-organization.md | 208 ++- ...ading-to-the-corporate-terms-of-service.md | 4 +- .../about-enterprise-accounts.md | 2 - ...cts-and-logs-in-your-enterprise-account.md | 19 + ...ons-policies-in-your-enterprise-account.md | 15 +- .../index.md | 2 + ...dio-subscription-with-github-enterprise.md | 42 + ...ewing-people-in-your-enterprise-account.md | 4 +- .../personalizing-your-profile.md | 12 +- ...tributions-not-showing-up-on-my-profile.md | 2 +- .../changing-your-primary-email-address.md | 9 +- .../converting-a-user-into-an-organization.md | 2 +- ...ss-to-your-user-accounts-project-boards.md | 4 +- ...fault-branch-name-for-your-repositories.md | 8 +- ...on-levels-for-a-user-account-repository.md | 7 +- .../github-additional-product-terms.md | 6 +- ...thub-enterprise-service-level-agreement.md | 4 +- .../site-policy/github-privacy-statement.md | 8 +- .../github-subprocessors-and-cookies.md | 106 +- ...p-github-sponsors-for-your-organization.md | 2 +- ...p-github-sponsors-for-your-user-account.md | 2 +- .../using-git/about-git-subtree-merges.md | 14 +- .../pushing-commits-to-a-remote-repository.md | 6 +- ...g-a-subfolder-out-into-a-new-repository.md | 2 +- .../using-git-rebase-on-the-command-line.md | 2 +- .../about-the-dependency-graph.md | 19 +- ...loring-the-dependencies-of-a-repository.md | 9 +- .../about-github-pages-and-jekyll.md | 3 +- .../about-github-pages.md | 12 +- ...yll-build-errors-for-github-pages-sites.md | 2 - ...-to-your-github-pages-site-using-jekyll.md | 6 +- ...shing-source-for-your-github-pages-site.md | 4 +- ...ustom-domain-for-your-github-pages-site.md | 3 +- .../unpublishing-a-github-pages-site.md | 4 +- .../about-github-support.md | 14 +- .../autolinked-references-and-urls.md | 5 +- .../basic-writing-and-formatting-syntax.md | 3 - .../writing-on-github/creating-gists.md | 3 - .../guides/managing-enterprise-accounts.md | 4 +- translations/ko-KR/content/index.md | 4 +- ...n-github-enterprise-and-github-insights.md | 2 +- ...n-github-insights-and-github-enterprise.md | 5 +- .../installing-github-insights.md | 3 +- ...ub-container-registry-for-docker-images.md | 12 +- ...cting-a-repository-to-a-container-image.md | 4 +- .../pushing-and-pulling-docker-images.md | 8 +- .../about-github-packages.md | 30 +- .../deleting-a-package.md | 1 - .../publishing-a-package.md | 3 +- ...ing-docker-for-use-with-github-packages.md | 19 +- ...dotnet-cli-for-use-with-github-packages.md | 1 - ...ing-gradle-for-use-with-github-packages.md | 65 +- ...guring-npm-for-use-with-github-packages.md | 4 +- ...ing-github-packages-with-github-actions.md | 7 +- .../rest/guides/basics-of-authentication.md | 10 +- .../guides/best-practices-for-integrators.md | 1 - .../rest/guides/delivering-deployments.md | 2 +- .../getting-started-with-the-checks-api.md | 4 +- ...tting-started-with-the-git-database-api.md | 4 +- .../getting-started-with-the-rest-api.md | 5 +- .../rest/guides/rendering-data-as-graphs.md | 2 +- .../content/rest/overview/api-previews.md | 30 +- .../endpoints-available-for-github-apps.md | 2 +- .../overview/other-authentication-methods.md | 4 +- .../overview/resources-in-the-rest-api.md | 2 - .../ko-KR/content/rest/reference/actions.md | 12 +- .../ko-KR/content/rest/reference/activity.md | 22 +- .../ko-KR/content/rest/reference/apps.md | 2 - .../content/rest/reference/code-scanning.md | 14 + .../rest/reference/enterprise-admin.md | 19 +- .../content/rest/reference/interactions.md | 6 +- .../ko-KR/content/rest/reference/licenses.md | 4 +- .../permissions-required-for-github-apps.md | 111 +- .../ko-KR/content/rest/reference/repos.md | 6 +- .../ko-KR/data/glossaries/external.yml | 2 +- .../ko-KR/data/graphql/graphql_previews.yml | 51 - translations/ko-KR/data/products.yml | 11 +- .../actions/about-artifact-log-retention.md | 6 + .../data/reusables/actions/about-artifacts.md | 2 +- .../data/reusables/actions/about-secrets.md | 2 +- .../actions/about-self-hosted-runners.md | 2 +- .../reusables/actions/about-workflow-jobs.md | 2 +- .../reusables/actions/about-workflow-runs.md | 2 +- .../data/reusables/actions/about-workflows.md | 2 +- .../actions-app-actions-permissions-api.md | 2 +- .../actions/actions-authentication.md | 2 +- .../reusables/actions/actions-not-verified.md | 2 +- .../actions/actions-use-policy-settings.md | 3 + .../actions/allow-specific-actions-intro.md | 19 + .../actions/enterprise-actions-permissions.md | 2 +- .../data/reusables/actions/enterprise-beta.md | 2 +- .../enterprise-github-hosted-runners.md | 2 +- .../reusables/actions/registry-credentials.md | 1 + .../actions/scheduled-workflows-disabled.md | 1 + .../apps/general-apps-restrictions.md | 2 +- .../apps/maximum-github-apps-allowed.md | 2 +- .../apps/maximum-oauth-apps-allowed.md | 2 +- .../reusables/apps/metadata-permissions.md | 2 +- .../reusables/apps/oauth-apps-restrictions.md | 2 +- .../data/reusables/apps/state_description.md | 2 +- .../reusables/audit_log/audit-log-search.md | 2 - .../branches/change-default-branch.md | 1 + ...efault-branch-automatically-base-branch.md | 3 +- .../branches/new-repo-default-branch.md | 3 +- .../reusables/branches/set-default-branch.md | 2 +- .../reusables/code-scanning/analyze-go.md | 1 + .../autobuild-add-build-steps.md | 2 +- .../autobuild-compiled-languages.md | 6 +- .../code-scanning/beta-codeql-runner.md | 9 + .../data/reusables/code-scanning/beta.md | 6 +- .../code-scanning/click-alert-in-list.md | 2 +- .../code-scanning/close-alert-examples.md | 1 + .../code-scanning/codeql-runner-license.md | 8 +- .../reusables/code-scanning/edit-workflow.md | 2 +- .../code-scanning/enabling-options.md | 2 +- .../false-positive-fix-codeql.md | 1 + ...eroperable-with-tools-that-output-sarif.md | 2 +- .../specify-language-to-analyze.md | 2 +- .../about-billing-for-codespaces.md | 1 + .../click-remote-explorer-icon-vscode.md | 2 +- .../codespaces/codespaces-are-per-branch.md | 2 +- .../codespaces/codespaces-are-personal.md | 2 +- .../connect-to-codespace-from-vscode.md | 2 +- .../codespaces/devcontainer-location.md | 1 + .../codespaces/navigate-to-codespaces.md | 2 +- .../reusables/codespaces/release-stage.md | 2 +- .../reusables/codespaces/unsupported-repos.md | 2 +- .../codespaces/use-visual-studio-features.md | 2 +- .../you-can-see-all-your-codespaces.md | 2 +- .../reusables/command_line/git-clone-url.md | 2 +- .../dependabot/check-in-dependabot-yml.md | 2 +- .../dependabot/create-dependabot-yml.md | 2 +- .../default-dependencies-allow-ignore.md | 2 +- .../reusables/dependabot/dependabot-tos.md | 2 +- .../option-affects-security-updates.md | 2 +- .../dependabot/private-dependencies.md | 2 +- .../dependabot/supported-package-managers.md | 44 +- .../data/reusables/desktop/choose-a-theme.md | 2 +- .../data/reusables/desktop/confirm-tag.md | 2 +- .../data/reusables/desktop/create-tag.md | 2 +- .../data/reusables/desktop/revert-commit.md | 2 +- .../reusables/desktop/select-base-branch.md | 2 +- .../reusables/dotcom_billing/add-seats.md | 2 +- .../dotcom_billing/confirm-add-seats.md | 2 +- .../dotcom_billing/number-of-seats.md | 2 +- .../reusables/dotcom_billing/upgrade_org.md | 2 +- .../enterprise-accounts/access-enterprise.md | 4 +- .../data/reusables/enterprise/rate_limit.md | 3 +- .../configuration-file-heading.md | 2 +- ...placing-a-cluster-node-replacement-name.md | 4 +- .../submit-support-ticket-first-section.md | 4 +- .../submit-support-ticket-second-section.md | 3 +- .../aws-supported-instance-types.md | 5 +- .../hardware-rec-table.md | 10 +- .../necessary_ports.md | 24 +- .../when-9418-necessary.md | 1 + .../packages-tab.md | 2 +- .../manage-global-webhooks-api.md | 2 +- .../files/commit-author-email-options.md | 3 +- .../reusables/gated-features/code-scanning.md | 1 + .../data/reusables/gated-features/packages.md | 3 +- .../github-actions/actions-billing.md | 2 +- .../github-actions/actions-on-examples.md | 10 +- .../github-actions/actions-unused-labels.md | 2 +- .../artifact-log-retention-statement.md | 2 + .../github-actions/branch-requirement.md | 2 +- ...nge-retention-period-for-artifacts-logs.md | 2 + .../disabled-actions-description.md | 2 +- .../docker-container-os-support.md | 2 +- .../github-actions/dockerfile-guidelines.md | 2 +- .../enabled-actions-description.md | 2 +- .../enabled-local-github-actions.md | 2 +- .../github-actions/expression-syntax-if.md | 2 +- .../github-actions/gradle-workflow-steps.md | 2 +- .../permissions-statement-secrets-api.md | 2 +- ...missions-statement-secrets-organization.md | 2 +- ...ermissions-statement-secrets-repository.md | 2 +- .../private-repository-forks-overview.md | 2 +- .../publish-to-maven-workflow-step.md | 2 +- .../publish-to-packages-workflow-step.md | 2 +- .../publishing-java-packages-intro.md | 2 +- .../github-actions/run_id_description.md | 2 +- .../github-actions/run_number_description.md | 2 +- ...ed-runner-configure-runner-group-access.md | 2 +- .../self-hosted-runner-list-group.md | 2 +- .../github-actions/self-hosted-runner-list.md | 2 +- ...elf-hosted-runner-navigate-repo-and-org.md | 2 +- .../self-hosted-runner-removal-impact.md | 2 +- .../self-hosted-runner-reusing.md | 2 +- .../github-actions/sidebar-secret.md | 2 +- .../github-actions/usage-api-requests.md | 1 + .../github-actions/usage-matrix-limits.md | 1 + .../github-actions/usage-workflow-run-time.md | 1 + .../github-insights/choose-key-metric.md | 2 +- .../navigate-to-key-metrics.md | 2 +- .../ko-KR/data/reusables/gpg/private-email.md | 3 +- .../enable-team-sync-azure.md | 2 +- .../enable-team-sync-okta.md | 2 +- .../supported-idps-team-sync.md | 2 +- .../sync-team-with-idp-group.md | 2 +- .../team-sync-disable.md | 2 +- .../team-sync-okta-requirements.md | 2 +- .../collaborator-user-limit-definition.md | 2 +- .../contributor-user-limit-definition.md | 2 +- .../existing-user-limit-definition.md | 2 +- .../interactions/interactions-detail.md | 2 +- .../issue-events/assignee-properties.md | 2 +- .../issue-event-common-properties.md | 2 +- .../issue-events/label-properties.md | 2 +- .../issue-events/project-card-properties.md | 2 +- .../review-dismissed-properties.md | 2 +- .../issue-events/review-request-properties.md | 2 +- .../timeline_events_object_properties.md | 2 +- .../can-include-lfs-objects-archives.md | 2 +- .../marketplace/cancellation-clarification.md | 2 +- .../marketplace/github_apps_preferred.md | 2 +- .../reusables/marketplace/launch-with-free.md | 2 +- .../reusables/marketplace/unverified-apps.md | 2 +- .../email-notification-caveats.md | 2 +- .../notifications-v2/manage-notifications.md | 2 +- .../organizations/can-require-ssh-cert.md | 2 +- .../organizations/organization-name.md | 2 +- .../organizations/repository-labels.md | 2 +- .../admins-can-configure-package-types.md | 2 +- .../package_registry/authenticate-packages.md | 6 +- ...uthenticate-to-container-registry-steps.md | 25 + ...nticate_with_pat_for_container_registry.md | 9 + .../docker_registry_deprecation_status.md | 5 + .../package_registry/package-immutability.md | 4 +- .../pages/best-with-supported-themes.md | 3 +- .../machine-man-preview.md | 2 +- .../suspend-installation-beta.md | 3 +- .../data/reusables/profile/profile-readme.md | 2 +- .../link-repos-to-project-board.md | 2 +- .../project-board-import-with-api.md | 2 +- .../reusables/projects/disabled-projects.md | 2 +- .../automatically-delete-branches.md | 2 - .../default-commit-message-squash-merge.md | 2 +- .../pull_requests/mark-ready-review.md | 2 +- .../reusables/reminders/author-reviews.md | 2 +- .../reusables/reminders/ignored-labels.md | 2 +- .../data/reusables/reminders/ignored-terms.md | 2 +- .../ko-KR/data/reusables/reminders/min-age.md | 2 +- .../data/reusables/reminders/min-staleness.md | 2 +- .../reusables/reminders/real-time-alerts.md | 2 +- .../reusables/reminders/required-labels.md | 2 +- .../about-github-archive-program.md | 2 +- .../actions-workflow-status-badge-into.md | 2 +- .../repositories/blocked-passwords.md | 3 +- .../reusables/repositories/copy-clone-url.md | 6 +- .../navigate-to-job-superlinter.md | 5 + .../navigate-to-workflow-superlinter.md | 1 + .../repositories/open-with-github-desktop.md | 4 +- .../permissions-statement-read.md | 2 +- .../permissions-statement-write.md | 2 +- .../security-alerts-x-github-severity.md | 2 +- .../repositories/select-marketplace-apps.md | 4 +- .../repositories/sidebar-dependabot-alerts.md | 2 +- .../view-failed-job-results-superlinter.md | 5 + .../repositories/view-run-superlinter.md | 1 + .../data/reusables/repositories/view-run.md | 2 +- .../view-specific-line-superlinter.md | 5 + .../reusables/saml/add-okta-application.md | 2 +- .../reusables/saml/assign-yourself-to-okta.md | 2 +- .../click-enterprise-account-application.md | 2 +- .../data/reusables/saml/okta-admin-button.md | 2 +- .../saml/okta-configure-api-integration.md | 2 +- .../reusables/saml/okta-edit-provisioning.md | 2 +- .../saml/okta-enable-api-integration.md | 2 +- .../reusables/saml/okta-provisioning-tab.md | 2 +- .../reusables/saml/okta-save-provisioning.md | 2 +- .../data/reusables/saml/okta-sign-on-tab.md | 2 +- .../saml/okta-view-setup-instructions.md | 2 +- .../data/reusables/saml/search-ghec-okta.md | 2 +- .../data/reusables/saml/use-classic-ui.md | 2 +- .../reusables/scim/enterprise-account-scim.md | 2 +- .../data/reusables/secret-scanning/beta.md | 2 +- ...-and-analysis-features-enable-read-only.md | 5 +- .../data/reusables/shortdesc/iso_8601.md | 2 +- .../reusables/sponsors/edit-featured-work.md | 2 +- .../data/reusables/sponsors/meet-the-team.md | 2 +- .../sponsors/navigate-to-your-goals-tab.md | 2 +- .../sponsors/opt-in-to-being-featured.md | 2 +- .../data/reusables/sponsors/publish-goal.md | 2 +- .../data/reusables/sponsors/retire-goal.md | 2 +- .../data/reusables/sponsors/save-profile.md | 2 +- .../data/reusables/sponsors/set-a-goal.md | 2 +- .../data/reusables/sponsors/short-bio.md | 2 +- .../sponsors/stripe-supported-regions.md | 2 +- .../you-can-be-a-sponsored-developer.md | 2 +- .../you-can-be-a-sponsored-organization.md | 2 +- .../ko-KR/data/reusables/ssh/dsa-support.md | 2 +- .../reusables/support/about-premium-plans.md | 20 +- .../support/ghec-premium-priorities.md | 10 +- .../data/reusables/support/ghes-priorities.md | 10 +- .../support/priority-urgent-english-only.md | 2 +- .../service-level-agreement-response-times.md | 4 +- .../ko-KR/data/reusables/two_fa/about-2fa.md | 1 + .../two_fa/after-2fa-add-security-key.md | 2 +- .../data/reusables/two_fa/auth_methods_2fa.md | 12 +- .../reusables/user_settings/export-data.md | 3 +- .../password-authentication-deprecation.md | 2 +- .../user_settings/sudo-mode-popup.md | 2 +- .../reusables/webhooks/action_type_desc.md | 2 +- .../ko-KR/data/reusables/webhooks/app_desc.md | 2 +- .../webhooks/check_run_properties.md | 18 +- .../webhooks/check_run_short_desc.md | 2 +- .../webhooks/check_suite_properties.md | 18 +- .../webhooks/check_suite_short_desc.md | 2 +- .../code_scanning_alert_event_short_desc.md | 2 +- .../webhooks/commit_comment_properties.md | 2 +- .../webhooks/commit_comment_short_desc.md | 2 +- .../webhooks/content_reference_short_desc.md | 2 +- .../reusables/webhooks/create_properties.md | 12 +- .../reusables/webhooks/create_short_desc.md | 2 +- .../reusables/webhooks/delete_properties.md | 8 +- .../reusables/webhooks/delete_short_desc.md | 2 +- .../webhooks/deploy_key_properties.md | 2 +- .../webhooks/deploy_key_short_desc.md | 2 +- .../webhooks/deployment_short_desc.md | 2 +- .../webhooks/deployment_status_short_desc.md | 2 +- .../webhooks/enterprise_short_desc.md | 2 +- .../reusables/webhooks/events_api_payload.md | 2 +- .../reusables/webhooks/fork_properties.md | 2 +- .../reusables/webhooks/fork_short_desc.md | 2 +- .../reusables/webhooks/gollum_properties.md | 2 +- .../reusables/webhooks/gollum_short_desc.md | 2 +- .../webhooks/installation_properties.md | 2 +- .../installation_repositories_properties.md | 2 +- .../installation_repositories_short_desc.md | 2 +- .../webhooks/installation_short_desc.md | 2 +- .../webhooks/issue_comment_properties.md | 2 +- .../webhooks/issue_comment_short_desc.md | 2 +- .../issue_comment_webhook_properties.md | 2 +- .../webhooks/issue_event_api_properties.md | 2 +- .../reusables/webhooks/issue_properties.md | 2 +- .../webhooks/issue_webhook_properties.md | 2 +- .../reusables/webhooks/issues_short_desc.md | 2 +- .../reusables/webhooks/label_short_desc.md | 2 +- .../webhooks/member_event_api_properties.md | 2 +- .../reusables/webhooks/member_properties.md | 2 +- .../reusables/webhooks/member_short_desc.md | 2 +- .../webhooks/member_webhook_properties.md | 2 +- .../webhooks/membership_properties.md | 2 +- .../webhooks/membership_short_desc.md | 2 +- .../webhooks/milestone_properties.md | 2 +- .../webhooks/milestone_short_desc.md | 2 +- .../webhooks/org_block_short_desc.md | 2 +- .../ko-KR/data/reusables/webhooks/org_desc.md | 2 +- .../webhooks/organization_short_desc.md | 2 +- .../reusables/webhooks/package_properties.md | 2 +- .../webhooks/page_build_short_desc.md | 2 +- .../data/reusables/webhooks/payload_url.md | 2 +- .../reusables/webhooks/ping_short_desc.md | 2 +- .../webhooks/project_card_properties.md | 2 +- .../webhooks/project_card_short_desc.md | 2 +- .../webhooks/project_column_properties.md | 2 +- .../webhooks/project_column_short_desc.md | 2 +- .../reusables/webhooks/project_properties.md | 2 +- .../reusables/webhooks/project_short_desc.md | 2 +- .../reusables/webhooks/public_short_desc.md | 2 +- .../pull_request_event_api_properties.md | 2 +- .../webhooks/pull_request_properties.md | 2 +- ...est_review_comment_event_api_properties.md | 2 +- .../pull_request_review_comment_properties.md | 2 +- .../pull_request_review_comment_short_desc.md | 2 +- ...quest_review_comment_webhook_properties.md | 2 +- .../pull_request_review_properties.md | 2 +- .../pull_request_review_short_desc.md | 2 +- .../webhooks/pull_request_short_desc.md | 2 +- .../pull_request_webhook_properties.md | 2 +- .../reusables/webhooks/push_short_desc.md | 2 +- .../webhooks/release_event_api_properties.md | 2 +- .../reusables/webhooks/release_properties.md | 2 +- .../reusables/webhooks/release_short_desc.md | 2 +- .../webhooks/release_webhook_properties.md | 6 +- .../data/reusables/webhooks/repo_desc.md | 2 +- .../webhooks/repository_import_properties.md | 2 +- .../webhooks/repository_import_short_desc.md | 2 +- .../webhooks/repository_short_desc.md | 2 +- ...pository_vulnerability_alert_properties.md | 2 +- ...pository_vulnerability_alert_short_desc.md | 2 +- .../ko-KR/data/reusables/webhooks/secret.md | 2 +- .../data/reusables/webhooks/sender_desc.md | 2 +- .../sponsorship_event_api_properties.md | 2 +- .../webhooks/sponsorship_properties.md | 2 +- .../webhooks/sponsorship_short_desc.md | 2 +- .../sponsorship_webhook_properties.md | 2 +- .../reusables/webhooks/star_properties.md | 8 +- .../reusables/webhooks/star_short_desc.md | 2 +- .../reusables/webhooks/status_short_desc.md | 2 +- .../reusables/webhooks/team_add_short_desc.md | 2 +- .../reusables/webhooks/team_short_desc.md | 2 +- .../reusables/webhooks/watch_properties.md | 2 +- .../reusables/webhooks/watch_short_desc.md | 2 +- .../data/reusables/webhooks/webhooks_ssl.md | 2 +- .../reusables/webhooks/workflow_run_desc.md | 2 +- .../ko-KR/data/variables/command_line.yml | 2 +- translations/ko-KR/data/variables/contact.yml | 1 - translations/ko-KR/data/variables/product.yml | 15 +- translations/ko-KR/data/variables/search.yml | 6 - .../actions/creating-actions/about-actions.md | 16 +- .../creating-a-composite-run-steps-action.md | 19 +- .../creating-a-docker-container-action.md | 4 +- .../creating-a-javascript-action.md | 10 +- .../content/actions/creating-actions/index.md | 1 + .../metadata-syntax-for-github-actions.md | 4 +- ...ublishing-actions-in-github-marketplace.md | 4 +- .../setting-exit-codes-for-actions.md | 2 +- .../guides/about-continuous-integration.md | 63 + .../about-packaging-with-github-actions.md | 47 + .../guides/about-service-containers.md | 117 ++ .../building-and-testing-java-with-ant.md | 109 ++ .../building-and-testing-java-with-gradle.md | 134 ++ .../building-and-testing-java-with-maven.md | 135 ++ .../guides/building-and-testing-nodejs.md | 276 ++++ .../guides/building-and-testing-python.md | 427 ++++++ ...hing-dependencies-to-speed-up-workflows.md | 192 +++ .../creating-postgresql-service-containers.md | 335 +++++ .../creating-redis-service-containers.md | 325 +++++ .../pt-BR/content/actions/guides/index.md | 60 + .../guides/publishing-docker-images.md | 158 ++ .../publishing-java-packages-with-gradle.md | 219 +++ .../publishing-java-packages-with-maven.md | 210 +++ .../guides/publishing-nodejs-packages.md | 210 +++ ...us-integration-using-workflow-templates.md | 49 + .../storing-workflow-data-as-artifacts.md | 249 ++++ .../about-self-hosted-runners.md | 9 + .../adding-self-hosted-runners.md | 5 +- ...and-troubleshooting-self-hosted-runners.md | 2 +- .../removing-self-hosted-runners.md | 5 +- translations/pt-BR/content/actions/index.md | 58 +- .../essential-features-of-github-actions.md | 95 ++ .../finding-and-customizing-actions.md | 156 ++ .../actions/learn-github-actions/index.md | 42 + .../introduction-to-github-actions.md | 225 +++ .../managing-complex-workflows.md | 151 ++ ...-from-azure-pipelines-to-github-actions.md | 327 +++++ ...grating-from-circleci-to-github-actions.md | 447 ++++++ ...ting-from-gitlab-cicd-to-github-actions.md | 476 +++++++ ...igrating-from-jenkins-to-github-actions.md | 293 ++++ .../security-hardening-for-github-actions.md | 97 ++ ...haring-workflows-with-your-organization.md | 114 ++ .../adding-a-workflow-status-badge.md | 63 + .../canceling-a-workflow.md | 31 + .../deleting-a-workflow-run.md | 23 + .../disabling-and-enabling-a-workflow.md | 45 + .../downloading-workflow-artifacts.md | 22 + .../enabling-debug-logging.md | 38 + .../actions/managing-workflow-runs/index.md | 32 + .../manually-running-a-workflow.md | 31 + .../re-running-a-workflow.md | 19 + .../removing-workflow-artifacts.md | 41 + .../using-workflow-run-logs.md | 86 ++ .../viewing-job-execution-time.md | 24 + .../viewing-workflow-run-history.md | 18 + .../pt-BR/content/actions/quickstart.md | 75 + .../reference/authentication-in-a-workflow.md | 100 ++ ...nd-expression-syntax-for-github-actions.md | 88 +- .../actions/reference/encrypted-secrets.md | 221 +++ .../reference/environment-variables.md | 69 + .../events-that-trigger-workflows.md | 224 +-- .../pt-BR/content/actions/reference/index.md | 40 +- ...pecifications-for-github-hosted-runners.md | 149 ++ ...usage-limits-billing-and-administration.md | 88 ++ .../workflow-commands-for-github-actions.md | 129 +- .../workflow-syntax-for-github-actions.md | 178 ++- ...or-users-outside-your-identity-provider.md | 2 +- .../content/admin/authentication/using-cas.md | 6 +- .../admin/authentication/using-ldap.md | 20 +- .../admin/authentication/using-saml.md | 20 +- .../configuration/command-line-utilities.md | 5 +- .../configuration/configuring-a-hostname.md | 2 +- .../configuration/configuring-applications.md | 4 +- ...guring-code-scanning-for-your-appliance.md | 12 +- .../configuration/configuring-rate-limits.md | 2 +- ...dress-using-the-virtual-machine-console.md | 8 + ...prise-server-to-github-enterprise-cloud.md | 8 +- ...ependencies-on-github-enterprise-server.md | 55 +- .../enabling-subdomain-isolation.md | 37 +- .../content/admin/configuration/index.md | 10 +- .../admin/configuration/network-ports.md | 22 +- .../configuration/site-admin-dashboard.md | 4 +- .../about-geo-replication.md | 2 +- .../about-high-availability-configuration.md | 11 +- .../accessing-the-monitor-dashboard.md | 12 +- .../cluster-network-configuration.md | 3 +- .../creating-a-high-availability-replica.md | 2 +- .../admin/enterprise-management/index.md | 13 +- .../initializing-the-cluster.md | 4 +- .../monitoring-cluster-nodes.md | 99 +- .../about-github-enterprise-support.md | 2 +- .../about-support-for-advanced-security.md | 4 +- ...-hosted-runners-without-internet-access.md | 2 +- translations/pt-BR/content/admin/index.md | 2 +- ...erprise-server-on-google-cloud-platform.md | 3 +- ...thub-enterprise-server-on-openstack-kvm.md | 4 +- .../overview/about-enterprise-accounts.md | 2 +- .../about-the-github-enterprise-server-api.md | 4 +- ...managing-your-github-enterprise-license.md | 6 +- ...-management-policies-in-your-enterprise.md | 116 +- .../admin/user-management/audit-logging.md | 2 +- .../admin/user-management/audited-actions.md | 44 +- .../configuring-email-for-notifications.md | 2 +- .../admin/user-management/creating-teams.md | 10 +- ...tomizing-user-messages-on-your-instance.md | 2 +- .../user-management/managing-dormant-users.md | 39 +- ...moting-or-demoting-a-site-administrator.md | 4 +- .../rebuilding-contributions-data.md | 3 +- ...ctor-authentication-for-an-organization.md | 2 +- .../searching-the-audit-log.md | 30 +- .../suspending-and-unsuspending-users.md | 2 +- ...epository-from-github-to-github-desktop.md | 8 +- ...orking-repositories-from-github-desktop.md | 8 +- .../creating-an-issue-or-pull-request.md | 8 +- .../authenticating-to-github.md | 8 +- .../keyboard-shortcuts.md | 142 +- .../content/developers/apps/about-apps.md | 8 +- .../apps/activating-beta-features-for-apps.md | 3 +- .../apps/authenticating-with-github-apps.md | 2 +- .../developers/apps/authorizing-oauth-apps.md | 240 ++-- ...ting-a-custom-badge-for-your-github-app.md | 4 +- ...ating-a-custom-badge-for-your-oauth-app.md | 9 +- .../creating-a-github-app-from-a-manifest.md | 6 +- ...ating-a-github-app-using-url-parameters.md | 190 +-- .../developers/apps/creating-a-github-app.md | 2 +- .../creating-ci-tests-with-the-checks-api.md | 105 +- ...nces-between-github-apps-and-oauth-apps.md | 22 +- .../apps/editing-a-github-apps-permissions.md | 22 +- ...g-and-authorizing-users-for-github-apps.md | 1267 ++++++++-------- .../developers/apps/installing-github-apps.md | 2 +- .../migrating-oauth-apps-to-github-apps.md | 1 - .../developers/apps/modifying-an-oauth-app.md | 6 +- ...refreshing-user-to-server-access-tokens.md | 6 +- .../developers/apps/scopes-for-oauth-apps.md | 124 +- ...ment-environment-to-create-a-github-app.md | 3 +- .../suspending-a-github-app-installation.md | 8 +- .../apps/using-the-github-api-in-your-app.md | 5 +- .../drafting-a-listing-for-your-app.md | 5 +- .../viewing-metrics-for-your-listing.md | 3 +- .../viewing-transactions-for-your-listing.md | 3 +- ...k-events-for-the-github-marketplace-api.md | 6 +- .../overview/managing-deploy-keys.md | 1 - .../overview/replacing-github-services.md | 1 - .../overview/using-ssh-agent-forwarding.md | 2 +- .../webhooks-and-events/about-webhooks.md | 23 +- .../webhooks-and-events/github-event-types.md | 1 - .../webhooks-and-events/issue-event-types.md | 1 - .../securing-your-webhooks.md | 27 +- .../webhooks-and-events/testing-webhooks.md | 1 - .../webhook-events-and-payloads.md | 75 +- .../about-branch-restrictions.md | 10 +- ...fications-for-pushes-to-your-repository.md | 8 +- ...about-github-dependabot-version-updates.md | 6 +- .../about-protected-branches.md | 2 +- .../about-releases.md | 9 +- .../about-required-commit-signing.md | 4 +- .../changing-the-default-branch.md | 53 + ...classifying-your-repository-with-topics.md | 40 +- ...guration-options-for-dependency-updates.md | 32 +- ...tolinks-to-reference-external-resources.md | 4 +- ...s-artifacts-and-logs-in-your-repository.md | 18 + ...g-your-repositorys-social-media-preview.md | 2 +- ...nd-restoring-branches-in-a-pull-request.md | 3 +- ...imiting-github-actions-for-a-repository.md | 39 +- ...ing-a-sponsor-button-in-your-repository.md | 22 +- .../enabling-and-disabling-version-updates.md | 2 +- .../enabling-branch-restrictions.md | 4 +- ...ling-force-pushes-to-a-protected-branch.md | 23 +- .../administering-a-repository/index.md | 3 +- ...tions-up-to-date-with-github-dependabot.md | 2 +- .../managing-releases-in-a-repository.md | 7 +- ...ging-the-automatic-deletion-of-branches.md | 2 +- ...-the-forking-policy-for-your-repository.md | 4 +- .../setting-repository-visibility.md | 6 +- .../transferring-a-repository.md | 8 +- ...deployment-activity-for-your-repository.md | 2 +- .../about-authentication-to-github.md | 3 +- .../about-commit-signature-verification.md | 7 +- .../authenticating-to-github/about-ssh.md | 7 +- .../about-two-factor-authentication.md | 6 +- ...-github-using-two-factor-authentication.md | 2 +- ...ng-a-new-ssh-key-to-your-github-account.md | 6 +- .../associating-an-email-with-your-gpg-key.md | 2 +- .../authorizing-oauth-apps.md | 2 +- .../checking-for-existing-ssh-keys.md | 3 +- ...t-and-tag-signature-verification-status.md | 4 +- ...-factor-authentication-recovery-methods.md | 4 +- .../configuring-two-factor-authentication.md | 38 +- ...onnecting-with-third-party-applications.md | 2 +- .../creating-a-personal-access-token.md | 4 +- ...uthentication-for-your-personal-account.md | 2 +- .../error-bad-file-number.md | 2 +- .../error-permission-denied-publickey.md | 160 ++- ...on-to-userrepo-denied-to-userother-repo.md | 2 +- ...e-problem-verify-that-the-ca-cert-is-ok.md | 4 +- .../generating-a-new-gpg-key.md | 4 +- .../managing-commit-signature-verification.md | 2 +- ...ccount-if-you-lose-your-2fa-credentials.md | 3 +- ...moving-sensitive-data-from-a-repository.md | 8 +- .../reviewing-your-security-log.md | 363 ++--- .../reviewing-your-ssh-keys.md | 62 +- .../signing-commits.md | 5 +- .../telling-git-about-your-signing-key.md | 2 +- ...updating-your-github-access-credentials.md | 6 +- .../working-with-ssh-key-passphrases.md | 5 +- .../about-issue-and-pull-request-templates.md | 2 +- .../about-team-discussions.md | 4 +- .../about-wikis.md | 2 +- ...dding-support-resources-to-your-project.md | 2 +- ...cking-a-user-from-your-personal-account.md | 2 +- ...ing-issue-templates-for-your-repository.md | 2 +- ...reating-a-default-community-health-file.md | 28 +- ...ll-request-template-for-your-repository.md | 2 +- .../documenting-your-project-with-wikis.md | 2 +- .../editing-wiki-content.md | 2 +- .../locking-conversations.md | 42 +- .../managing-disruptive-comments.md | 83 +- .../pinning-a-team-discussion.md | 2 +- .../reporting-abuse-or-spam.md | 2 +- ...-guidelines-for-repository-contributors.md | 4 +- ...-your-project-for-healthy-contributions.md | 2 +- .../tracking-changes-in-a-comment.md | 2 +- .../about-branches.md | 18 +- ...out-comparing-branches-in-pull-requests.md | 4 +- .../about-conversations-on-github.md | 2 +- .../about-forks.md | 4 +- .../about-merge-conflicts.md | 2 +- .../about-pull-request-reviews.md | 4 +- .../about-status-checks.md | 2 +- .../changing-the-stage-of-a-pull-request.md | 2 +- .../checking-out-pull-requests-locally.md | 2 +- ...repositories-with-code-quality-features.md | 4 +- .../commenting-on-a-pull-request.md | 2 +- ...pull-request-branch-created-from-a-fork.md | 4 +- .../creating-a-pull-request.md | 2 +- .../dismissing-a-pull-request-review.md | 6 +- .../filtering-files-in-a-pull-request.md | 4 +- .../merging-a-pull-request.md | 2 +- ...g-an-upstream-repository-into-your-fork.md | 4 +- .../requesting-a-pull-request-review.md | 2 +- .../resolving-a-merge-conflict-on-github.md | 60 +- ...wing-proposed-changes-in-a-pull-request.md | 4 +- .../working-with-pre-receive-hooks.md | 2 +- .../changing-a-commit-message.md | 21 +- .../commit-branch-and-tag-labels.md | 2 +- ...sts-on-github-but-not-in-my-local-clone.md | 2 +- .../comparing-commits.md | 6 +- ...creating-a-commit-with-multiple-authors.md | 63 +- .../about-archiving-repositories.md | 2 +- .../about-code-owners.md | 7 +- .../about-readmes.md | 2 +- .../about-repositories.md | 3 +- .../about-repository-languages.md | 3 +- .../about-repository-visibility.md | 25 +- .../backing-up-a-repository.md | 41 +- .../cloning-a-repository.md | 4 +- .../creating-a-new-repository.md | 11 +- .../creating-a-repository-from-a-template.md | 2 +- .../creating-a-template-repository.md | 15 +- ...s-to-nonexistent-ref-unable-to-checkout.md | 2 +- .../error-repository-not-found.md | 2 +- .../https-cloning-errors.md | 2 +- .../licensing-a-repository.md | 5 +- .../about-billing-for-codespaces.md | 27 + .../about-codespaces.md | 2 +- ...configuring-codespaces-for-your-project.md | 8 +- .../creating-a-codespace.md | 2 +- .../index.md | 4 +- .../troubleshooting-your-codespace.md | 2 +- .../using-codespaces-in-visual-studio-code.md | 45 + .../using-codespaces-in-visual-studio.md | 53 + .../getting-started-with-the-api.md | 2 +- .../about-code-scanning.md | 2 +- .../about-integration-with-code-scanning.md | 16 +- ...our-code-for-vulnerabilities-and-errors.md | 1 + .../configuring-code-scanning.md | 226 ++- ...-codeql-code-scanning-in-your-ci-system.md | 165 +++ ...-codeql-workflow-for-compiled-languages.md | 116 ++ ...enabling-code-scanning-for-a-repository.md | 88 +- .../index.md | 14 +- .../integrating-with-code-scanning.md | 3 +- ...ode-scanning-alerts-for-your-repository.md | 63 + ...-codeql-code-scanning-in-your-ci-system.md | 161 +++ .../sarif-support-for-code-scanning.md | 167 +-- ...g-code-scanning-alerts-in-pull-requests.md | 48 + ...-codeql-code-scanning-in-your-ci-system.md | 52 + .../troubleshooting-the-codeql-workflow.md | 125 ++ .../uploading-a-sarif-file-to-github.md | 18 +- ...e-scanning-with-your-existing-ci-system.md | 11 + .../access-permissions-on-github.md | 2 +- .../getting-started-with-github/be-social.md | 2 +- .../create-a-repo.md | 4 +- .../following-people.md | 4 +- .../fork-a-repo.md | 10 +- .../git-and-github-learning-resources.md | 2 +- .../github-for-mobile.md | 10 + .../githubs-products.md | 2 +- .../keyboard-shortcuts.md | 58 +- .../saving-repositories-with-stars.md | 5 +- .../getting-started-with-github/set-up-git.md | 2 +- ...-up-a-trial-of-github-enterprise-server.md | 2 +- .../supported-browsers.md | 2 +- .../types-of-github-accounts.md | 7 +- ...roject-to-github-using-the-command-line.md | 21 +- ...a-git-repository-using-the-command-line.md | 2 +- .../importing-source-code-to-github.md | 2 +- ...-differences-between-subversion-and-git.md | 4 +- ...-to-a-repository-using-the-command-line.md | 4 +- .../adding-a-file-to-a-repository.md | 4 +- .../getting-permanent-links-to-files.md | 4 +- ...o-a-new-location-using-the-command-line.md | 2 +- ...g-with-jupyter-notebook-files-on-github.md | 4 +- .../about-git-large-file-storage.md | 11 +- .../about-storage-and-bandwidth-usage.md | 3 +- .../conditions-for-large-files.md | 2 +- .../installing-git-large-file-storage.md | 3 +- ...oving-files-from-git-large-file-storage.md | 40 +- ...bout-alerts-for-vulnerable-dependencies.md | 6 +- ...ring-github-dependabot-security-updates.md | 16 +- ...abilities-in-your-projects-dependencies.md | 2 +- .../about-notifications.md | 13 +- .../configuring-notifications.md | 208 +-- .../managing-notifications-from-your-inbox.md | 5 +- .../managing-your-subscriptions.md | 2 +- ...and-pull-requests-with-query-parameters.md | 18 +- .../about-automation-for-project-boards.md | 2 +- .../about-issues.md | 10 +- .../about-labels.md | 22 +- ...es-and-pull-requests-to-a-project-board.md | 11 +- ...ying-labels-to-issues-and-pull-requests.md | 5 +- ...and-pull-requests-to-other-github-users.md | 2 +- .../disabling-issues.md | 5 +- ...attachments-on-issues-and-pull-requests.md | 25 +- .../filtering-cards-on-a-project-board.md | 8 +- ...g-issues-and-pull-requests-by-milestone.md | 2 +- .../linking-a-pull-request-to-an-issue.md | 20 +- ...sferring-an-issue-to-another-repository.md | 4 +- ...arch-to-filter-issues-and-pull-requests.md | 2 +- ...ng-all-of-your-issues-and-pull-requests.md | 2 +- .../about-email-notifications.md | 20 +- .../about-notifications.md | 9 +- .../about-web-notifications.md | 6 +- .../accessing-your-notifications.md | 2 +- ...s-and-pull-requests-youre-subscribed-to.md | 9 +- ...listing-the-repositories-youre-watching.md | 2 +- .../saving-notifications-for-later.md | 2 +- ...to-and-unsubscribing-from-notifications.md | 13 +- .../watching-and-unwatching-repositories.md | 8 +- ...atching-and-unwatching-team-discussions.md | 14 +- .../about-searching-on-github.md | 2 + .../searching-code.md | 4 +- .../searching-commits.md | 2 +- .../searching-for-packages.md | 11 +- .../searching-issues-and-pull-requests.md | 4 +- .../searching-users.md | 2 +- .../searching-wikis.md | 2 +- .../sorting-search-results.md | 16 +- .../about-billing-for-github-actions.md | 6 +- .../about-billing-for-github-packages.md | 4 +- ...ging-the-duration-of-your-billing-cycle.md | 2 +- ...-your-spending-limit-for-github-actions.md | 4 +- ...your-spending-limit-for-github-packages.md | 4 +- .../upgrading-your-github-subscription.md | 4 +- .../viewing-your-github-actions-usage.md | 6 +- .../viewing-your-github-packages-usage.md | 4 +- .../about-organizations.md | 1 - .../about-ssh-certificate-authorities.md | 4 +- .../about-teams.md | 2 +- .../about-your-organization-dashboard.md | 2 +- .../about-your-organizations-news-feed.md | 3 +- ...to-a-project-board-in-your-organization.md | 4 +- ...ithub-app-managers-in-your-organization.md | 4 +- .../adding-organization-members-to-a-team.md | 13 +- ...saml-single-sign-on-and-scim-using-okta.md | 4 +- ...artifacts-and-logs-in-your-organization.md | 16 + ...ation-member-to-an-outside-collaborator.md | 2 +- ...-collaborator-to-an-organization-member.md | 21 +- ...reating-a-new-organization-from-scratch.md | 2 +- .../deleting-an-organization-account.md | 2 +- ...ng-github-actions-for-your-organization.md | 38 + ...ithub-pages-sites-for-your-organization.md | 22 +- ...ml-single-sign-on-for-your-organization.md | 2 +- ...ml-single-sign-on-for-your-organization.md | 2 +- .../index.md | 2 +- ...nviting-users-to-join-your-organization.md | 4 +- ...access-to-an-organization-project-board.md | 4 +- ...ls-access-to-an-organization-repository.md | 2 +- ...cess-to-your-organizations-repositories.md | 4 +- ...anaging-membership-in-your-organization.md | 2 +- ...am-access-to-an-organization-repository.md | 2 +- ...e-for-repositories-in-your-organization.md | 15 +- ...ay-of-member-names-in-your-organization.md | 2 +- ...he-forking-policy-for-your-organization.md | 6 +- ...ganizations-ssh-certificate-authorities.md | 2 +- .../organizing-members-into-teams.md | 2 +- .../permission-levels-for-an-organization.md | 171 +-- ...tor-authentication-in-your-organization.md | 2 +- ...ng-a-former-member-of-your-organization.md | 4 +- ...llaborators-access-to-your-organization.md | 54 +- ...hub-app-managers-from-your-organization.md | 4 +- ...moving-organization-members-from-a-team.md | 2 +- .../renaming-an-organization.md | 2 +- ...y-permission-levels-for-an-organization.md | 204 +-- ...tor-authentication-in-your-organization.md | 28 +- ...epository-creation-in-your-organization.md | 6 +- ...ing-the-audit-log-for-your-organization.md | 8 +- ...ur-organizations-installed-integrations.md | 19 +- ...ng-base-permissions-for-an-organization.md | 2 +- ...ssions-for-adding-outside-collaborators.md | 13 +- .../transferring-organization-ownership.md | 2 +- ...ading-to-the-corporate-terms-of-service.md | 4 +- ...s-in-your-organization-have-2fa-enabled.md | 2 +- .../about-enterprise-accounts.md | 4 +- ...cts-and-logs-in-your-enterprise-account.md | 19 + ...ons-policies-in-your-enterprise-account.md | 15 +- ...ard-policies-in-your-enterprise-account.md | 2 +- ...ent-policies-in-your-enterprise-account.md | 2 +- ...eam-policies-in-your-enterprise-account.md | 2 +- .../index.md | 2 + ...dio-subscription-with-github-enterprise.md | 42 + ...ewing-people-in-your-enterprise-account.md | 4 +- .../about-your-organizations-profile.md | 2 +- .../about-your-profile.md | 2 +- .../personalizing-your-profile.md | 12 +- .../pinning-items-to-your-profile.md | 2 +- .../viewing-contributions-on-your-profile.md | 2 +- ...tributions-not-showing-up-on-my-profile.md | 4 +- .../about-your-personal-dashboard.md | 2 +- .../changing-your-github-username.md | 58 +- .../changing-your-primary-email-address.md | 9 +- .../converting-a-user-into-an-organization.md | 6 +- .../deleting-your-user-account.md | 6 +- ...-collaborators-to-a-personal-repository.md | 4 +- ...ss-to-your-user-accounts-project-boards.md | 4 +- ...analysis-settings-for-your-user-account.md | 2 +- ...fault-branch-name-for-your-repositories.md | 12 +- ...on-levels-for-a-user-account-repository.md | 95 +- .../setting-your-commit-email-address.md | 6 +- .../github-acceptable-use-policies.md | 4 +- .../github-additional-product-terms.md | 6 +- .../site-policy/github-and-trade-controls.md | 26 +- .../github-community-forum-code-of-conduct.md | 2 +- .../github-corporate-terms-of-service.md | 44 +- ...hub-enterprise-server-license-agreement.md | 2 +- ...thub-enterprise-service-level-agreement.md | 32 +- ...ithub-enterprise-subscription-agreement.md | 12 +- ...d-data-protection-for-your-organization.md | 40 +- .../github-marketplace-developer-agreement.md | 4 +- .../site-policy/github-pre-release-program.md | 6 +- .../site-policy/github-privacy-statement.md | 10 +- .../github-registered-developer-agreement.md | 6 +- .../github-sponsors-additional-terms.md | 2 +- ...-against-modern-slavery-and-child-labor.md | 2 +- .../github-subprocessors-and-cookies.md | 106 +- ...al-terms-for-microsoft-volume-licensing.md | 88 +- .../site-policy/github-terms-of-service.md | 18 +- ...out-the-california-consumer-privacy-act.md | 2 +- ...ide-to-submitting-a-dmca-counter-notice.md | 6 +- ...de-to-submitting-a-dmca-takedown-notice.md | 4 +- ...delines-for-legal-requests-of-user-data.md | 6 +- ...b-sponsors-for-open-source-contributors.md | 2 +- ...our-profile-details-for-github-sponsors.md | 2 +- ...p-github-sponsors-for-your-organization.md | 2 +- ...p-github-sponsors-for-your-user-account.md | 2 +- .../using-git/about-git-subtree-merges.md | 14 +- .../dealing-with-non-fast-forward-errors.md | 4 +- ...etting-changes-from-a-remote-repository.md | 4 +- .../pushing-commits-to-a-remote-repository.md | 6 +- ...g-a-subfolder-out-into-a-new-repository.md | 2 +- .../which-remote-url-should-i-use.md | 2 +- .../about-repository-graphs.md | 2 +- .../about-the-dependency-graph.md | 3 +- .../accessing-basic-repository-data.md | 2 +- ...loring-the-dependencies-of-a-repository.md | 11 +- ...anding-connections-between-repositories.md | 2 +- .../viewing-a-projects-contributors.md | 4 +- .../viewing-traffic-to-a-repository.md | 19 +- .../visualizing-commits-in-a-repository.md | 2 +- .../about-github-pages-and-jekyll.md | 5 +- .../about-github-pages.md | 26 +- ...yll-build-errors-for-github-pages-sites.md | 4 +- ...-to-your-github-pages-site-using-jekyll.md | 6 +- ...shing-source-for-your-github-pages-site.md | 10 +- ...reating-a-github-pages-site-with-jekyll.md | 63 +- .../creating-a-github-pages-site.md | 6 +- ...ustom-domain-for-your-github-pages-site.md | 3 +- ...yll-build-errors-for-github-pages-sites.md | 152 +- .../unpublishing-a-github-pages-site.md | 8 +- .../about-github-support.md | 14 +- .../autolinked-references-and-urls.md | 5 +- .../basic-writing-and-formatting-syntax.md | 7 +- .../writing-on-github/creating-gists.md | 5 +- .../guides/managing-enterprise-accounts.md | 4 +- translations/pt-BR/content/index.md | 6 +- ...n-github-enterprise-and-github-insights.md | 2 +- .../about-github-insights.md | 2 +- ...n-github-insights-and-github-enterprise.md | 5 +- .../installing-github-insights.md | 3 +- ...managing-permissions-in-github-insights.md | 2 +- ...ub-container-registry-for-docker-images.md | 12 +- ...cting-a-repository-to-a-container-image.md | 4 +- .../pushing-and-pulling-docker-images.md | 8 +- .../about-github-packages.md | 36 +- .../deleting-a-package.md | 1 - .../installing-a-package.md | 2 +- .../publishing-a-package.md | 5 +- .../viewing-packages.md | 2 +- ...ache-maven-for-use-with-github-packages.md | 60 +- ...ing-docker-for-use-with-github-packages.md | 75 +- ...dotnet-cli-for-use-with-github-packages.md | 69 +- ...ing-gradle-for-use-with-github-packages.md | 73 +- ...guring-npm-for-use-with-github-packages.md | 120 +- ...ing-github-packages-with-github-actions.md | 34 +- .../rest/guides/basics-of-authentication.md | 16 +- .../guides/best-practices-for-integrators.md | 5 +- .../rest/guides/delivering-deployments.md | 2 +- .../getting-started-with-the-checks-api.md | 4 +- ...tting-started-with-the-git-database-api.md | 6 +- .../getting-started-with-the-rest-api.md | 7 +- .../content/rest/overview/api-previews.md | 38 +- .../endpoints-available-for-github-apps.md | 2 +- .../overview/other-authentication-methods.md | 8 +- .../overview/resources-in-the-rest-api.md | 256 ++-- .../pt-BR/content/rest/reference/actions.md | 28 +- .../pt-BR/content/rest/reference/activity.md | 88 +- .../pt-BR/content/rest/reference/apps.md | 32 +- .../pt-BR/content/rest/reference/billing.md | 2 +- .../pt-BR/content/rest/reference/checks.md | 4 +- .../content/rest/reference/code-scanning.md | 14 + .../rest/reference/codes-of-conduct.md | 2 +- .../rest/reference/enterprise-admin.md | 121 +- .../pt-BR/content/rest/reference/gists.md | 22 +- .../pt-BR/content/rest/reference/git.md | 24 +- .../pt-BR/content/rest/reference/gitignore.md | 8 +- .../pt-BR/content/rest/reference/index.md | 2 +- .../content/rest/reference/interactions.md | 14 +- .../pt-BR/content/rest/reference/issues.md | 16 +- .../pt-BR/content/rest/reference/licenses.md | 16 +- .../content/rest/reference/migrations.md | 16 +- .../rest/reference/oauth-authorizations.md | 6 +- .../pt-BR/content/rest/reference/orgs.md | 26 +- .../permissions-required-for-github-apps.md | 203 ++- .../pt-BR/content/rest/reference/projects.md | 6 +- .../pt-BR/content/rest/reference/pulls.md | 52 +- .../content/rest/reference/rate-limit.md | 4 +- .../pt-BR/content/rest/reference/repos.md | 164 +-- .../pt-BR/content/rest/reference/scim.md | 34 +- .../pt-BR/content/rest/reference/search.md | 76 +- .../pt-BR/content/rest/reference/teams.md | 18 +- .../pt-BR/content/rest/reference/users.md | 10 +- .../pt-BR/data/glossaries/external.yml | 18 +- .../pt-BR/data/glossaries/internal.yml | 2 +- ...hql_upcoming_changes.public-enterprise.yml | 16 +- .../pt-BR/data/graphql/graphql_previews.yml | 51 - .../graphql_upcoming_changes.public.yml | 24 +- translations/pt-BR/data/products.yml | 11 +- .../actions/about-artifact-log-retention.md | 6 + .../data/reusables/actions/about-artifacts.md | 2 +- .../data/reusables/actions/about-secrets.md | 2 +- .../actions/about-self-hosted-runners.md | 2 +- .../reusables/actions/about-workflow-jobs.md | 2 +- .../reusables/actions/about-workflow-runs.md | 2 +- .../data/reusables/actions/about-workflows.md | 2 +- .../actions-app-actions-permissions-api.md | 2 +- .../actions/actions-authentication.md | 2 +- .../reusables/actions/actions-not-verified.md | 2 +- .../actions/actions-use-policy-settings.md | 3 + .../actions/allow-specific-actions-intro.md | 19 + .../actions/enterprise-actions-permissions.md | 2 +- .../data/reusables/actions/enterprise-beta.md | 4 +- .../enterprise-github-hosted-runners.md | 4 +- .../actions/enterprise-marketplace-actions.md | 2 +- .../actions/enterprise-no-internet-actions.md | 2 +- .../actions/enterprise-setup-prereq.md | 4 +- .../reusables/actions/registry-credentials.md | 1 + .../actions/scheduled-workflows-disabled.md | 1 + .../reusables/apps/beta_feature_activation.md | 4 +- .../deprecating_auth_with_query_parameters.md | 4 +- .../apps/deprecating_password_auth.md | 4 +- .../apps/general-apps-restrictions.md | 2 +- .../apps/maximum-github-apps-allowed.md | 2 +- .../apps/maximum-oauth-apps-allowed.md | 2 +- .../reusables/apps/metadata-permissions.md | 2 +- .../reusables/apps/oauth-apps-restrictions.md | 2 +- .../data/reusables/apps/state_description.md | 2 +- .../reusables/audit_log/audit-log-search.md | 2 - .../branches/change-default-branch.md | 1 + ...efault-branch-automatically-base-branch.md | 3 +- .../branches/new-repo-default-branch.md | 3 +- .../reusables/branches/set-default-branch.md | 2 +- .../filter-issues-and-pull-requests-tip.md | 2 +- .../reusables/code-scanning/analyze-go.md | 1 + .../autobuild-add-build-steps.md | 2 +- .../autobuild-compiled-languages.md | 6 +- .../code-scanning/beta-codeql-runner.md | 9 + .../data/reusables/code-scanning/beta.md | 6 +- .../code-scanning/click-alert-in-list.md | 2 +- .../code-scanning/close-alert-examples.md | 1 + .../code-scanning/codeql-query-suites.md | 4 +- .../code-scanning/codeql-runner-license.md | 8 +- .../reusables/code-scanning/edit-workflow.md | 2 +- .../code-scanning/enabling-options.md | 10 +- ...enterprise-enable-code-scanning-actions.md | 2 +- .../enterprise-enable-code-scanning.md | 2 +- .../example-configuration-files.md | 2 +- .../false-positive-fix-codeql.md | 1 + ...eroperable-with-tools-that-output-sarif.md | 2 +- .../code-scanning/run-additional-queries.md | 10 +- .../specify-language-to-analyze.md | 2 +- .../about-billing-for-codespaces.md | 1 + .../codespaces/about-configuration.md | 2 +- .../click-remote-explorer-icon-vscode.md | 2 +- .../codespaces/codespaces-are-per-branch.md | 2 +- .../codespaces/codespaces-are-personal.md | 2 +- .../codespaces/concurrent-codespace-limit.md | 2 +- .../connect-to-codespace-from-vscode.md | 2 +- .../codespaces/devcontainer-location.md | 1 + .../codespaces/navigate-to-codespaces.md | 2 +- .../reusables/codespaces/release-stage.md | 2 +- .../reusables/codespaces/unsupported-repos.md | 2 +- .../codespaces/use-visual-studio-features.md | 2 +- .../you-can-see-all-your-codespaces.md | 2 +- .../reusables/command_line/git-clone-url.md | 2 +- .../command_line/provide-an-access-token.md | 2 +- .../data/reusables/commits/about-commits.md | 2 +- .../dashboard/access-org-dashboard.md | 2 +- .../dependabot/check-in-dependabot-yml.md | 2 +- .../dependabot/create-dependabot-yml.md | 2 +- .../default-dependencies-allow-ignore.md | 2 +- .../reusables/dependabot/default-labels.md | 2 +- .../reusables/dependabot/dependabot-tos.md | 2 +- .../reusables/dependabot/initial-updates.md | 4 +- .../option-affects-security-updates.md | 2 +- .../dependabot/private-dependencies.md | 2 +- .../dependabot/supported-package-managers.md | 44 +- ...de-dependency-to-minimum-secure-version.md | 4 +- .../dependabot/version-updates-for-actions.md | 2 +- .../data/reusables/desktop/choose-a-theme.md | 2 +- .../desktop/click-base-branch-in-drop-down.md | 2 +- .../data/reusables/desktop/confirm-tag.md | 2 +- .../data/reusables/desktop/create-tag.md | 2 +- .../reusables/desktop/current-branch-menu.md | 2 +- .../reusables/desktop/delete-branch-mac.md | 2 +- .../reusables/desktop/delete-branch-win.md | 2 +- .../launch-desktop-from-command-line.md | 2 +- .../desktop/mac-select-desktop-menu.md | 2 +- .../desktop/preferences-options-tabs.md | 4 +- .../reusables/desktop/protected-branches.md | 2 +- .../data/reusables/desktop/push-origin.md | 2 +- .../data/reusables/desktop/revert-commit.md | 2 +- .../reusables/desktop/select-base-branch.md | 2 +- .../desktop/select-branch-to-delete.md | 2 +- .../reusables/desktop/update-email-address.md | 2 +- .../reusables/dotcom_billing/add-seats.md | 2 +- .../dotcom_billing/confirm-add-seats.md | 2 +- .../dotcom_billing/number-of-seats.md | 2 +- .../reusables/dotcom_billing/upgrade_org.md | 2 +- .../education/about-github-education-link.md | 2 +- .../enterprise-accounts/access-enterprise.md | 4 +- .../enterprise-accounts/administrators-tab.md | 2 +- .../enterprise-accounts/audit-log-tab.md | 2 +- .../enterprise-accounts/hooks-tab.md | 2 +- .../enterprise-accounts/messages-tab.md | 2 +- .../enterprise-accounts/options-tab.md | 2 +- .../enterprise-accounts/people-tab.md | 2 +- .../enterprise-accounts/projects-tab.md | 2 +- .../enterprise-accounts/security-tab.md | 2 +- .../data/reusables/enterprise/rate_limit.md | 3 +- .../reusables/enterprise/use-a-multiplexer.md | 2 +- .../apply-configuration.md | 2 +- .../configuration-file-heading.md | 2 +- .../configuration-finished.md | 4 +- .../key-value-pair-order-irrelevant.md | 2 +- .../open-configuration-file.md | 2 +- ...placing-a-cluster-node-replacement-name.md | 4 +- .../enterprise_clustering/ssh-to-a-node.md | 2 +- .../submit-support-ticket-first-section.md | 14 +- .../submit-support-ticket-second-section.md | 3 +- .../aws-supported-instance-types.md | 7 +- ...and-line-utilities-ghe-upgrade-rollback.md | 2 +- .../hardware-considerations-all-platforms.md | 46 +- .../hardware-rec-table.md | 20 +- .../increasing-cpus-req.md | 2 +- .../necessary_ports.md | 24 +- .../when-9418-necessary.md | 1 + .../badge_indicator.md | 2 +- .../enable-disable-code-scanning.md | 2 +- .../admin-top-tab.md | 2 +- .../business.md | 2 +- .../packages-tab.md | 2 +- .../manage-global-webhooks-api.md | 2 +- .../reusables/files/choose_commit_branch.md | 2 +- .../files/commit-author-email-options.md | 3 +- .../data/reusables/gated-features/actions.md | 2 +- .../gated-features/code-review-assignment.md | 2 +- .../reusables/gated-features/code-scanning.md | 1 + .../gated-features/enterprise-accounts.md | 2 +- .../gated-features/more-info-org-products.md | 2 +- .../reusables/gated-features/more-info.md | 2 +- .../data/reusables/gated-features/packages.md | 5 +- .../gated-features/repository-insights.md | 2 +- .../github-actions/actions-billing.md | 2 +- .../github-actions/actions-on-examples.md | 10 +- .../github-actions/actions-unused-labels.md | 2 +- .../artifact-log-retention-statement.md | 2 + .../github-actions/branch-requirement.md | 2 +- ...nge-retention-period-for-artifacts-logs.md | 2 + .../disabled-actions-description.md | 2 +- .../disabling-github-actions.md | 2 +- .../docker-container-os-support.md | 2 +- .../github-actions/dockerfile-guidelines.md | 2 +- .../enabled-actions-description.md | 2 +- .../enabled-local-github-actions.md | 2 +- .../github-actions/expression-syntax-if.md | 2 +- .../github-actions/gradle-workflow-steps.md | 2 +- .../permissions-statement-secrets-api.md | 2 +- ...missions-statement-secrets-organization.md | 2 +- ...ermissions-statement-secrets-repository.md | 2 +- .../private-repository-forks-configure.md | 4 +- .../private-repository-forks-overview.md | 8 +- .../publish-to-maven-workflow-step.md | 2 +- .../publish-to-packages-workflow-step.md | 2 +- .../publishing-java-packages-intro.md | 2 +- .../github-actions/run_id_description.md | 2 +- .../github-actions/run_number_description.md | 2 +- ...ed-runner-configure-runner-group-access.md | 2 +- .../self-hosted-runner-list-group.md | 2 +- .../github-actions/self-hosted-runner-list.md | 2 +- ...-runner-management-permissions-required.md | 4 +- ...elf-hosted-runner-navigate-repo-and-org.md | 2 +- ...-runner-navigate-to-repo-org-enterprise.md | 8 +- .../self-hosted-runner-removal-impact.md | 2 +- .../self-hosted-runner-reusing.md | 2 +- .../github-actions/sidebar-secret.md | 2 +- .../github-actions/usage-api-requests.md | 1 + .../github-actions/usage-matrix-limits.md | 1 + .../github-actions/usage-workflow-run-time.md | 1 + .../github-connect/access-profile-settings.md | 2 +- .../github-insights/choose-key-metric.md | 2 +- .../github-insights/enterprise-api-url.md | 2 +- .../navigate-to-key-metrics.md | 2 +- .../pt-BR/data/reusables/gpg/private-email.md | 3 +- .../enable-team-sync-azure.md | 2 +- .../enable-team-sync-okta.md | 2 +- .../supported-idps-team-sync.md | 2 +- .../sync-team-with-idp-group.md | 2 +- .../team-sync-disable.md | 2 +- .../team-sync-okta-requirements.md | 2 +- .../collaborator-user-limit-definition.md | 2 +- .../contributor-user-limit-definition.md | 2 +- .../existing-user-limit-definition.md | 2 +- .../interactions/interactions-detail.md | 2 +- .../issue-events/assignee-properties.md | 2 +- .../issue-event-common-properties.md | 2 +- .../issue-events/label-properties.md | 2 +- .../issue-events/project-card-properties.md | 2 +- .../review-dismissed-properties.md | 2 +- .../issue-events/review-request-properties.md | 2 +- .../timeline_events_object_properties.md | 2 +- .../can-include-lfs-objects-archives.md | 2 +- .../marketplace/cancellation-clarification.md | 2 +- .../marketplace/github_apps_preferred.md | 2 +- .../data/reusables/marketplace/install-buy.md | 2 +- .../reusables/marketplace/launch-with-free.md | 2 +- .../reusables/marketplace/unverified-apps.md | 2 +- .../email-notification-caveats.md | 2 +- .../notifications-v2/manage-notifications.md | 2 +- .../reusables/notifications/shared_state.md | 2 +- .../organizations/can-require-ssh-cert.md | 2 +- .../oauth_app_restrictions_default.md | 2 +- .../organizations/organization-name.md | 2 +- .../organizations/organizations_include.md | 2 +- .../outside-collaborators-use-seats.md | 2 +- .../organizations/repository-defaults.md | 2 +- .../organizations/repository-labels.md | 2 +- .../organizations/send-invitation.md | 2 +- .../organizations/team_maintainers_can.md | 4 +- .../admins-can-configure-package-types.md | 4 +- .../package_registry/authenticate-packages.md | 12 +- ...uthenticate-to-container-registry-steps.md | 25 + ...nticate_with_pat_for_container_registry.md | 9 + .../billing-for-container-registry.md | 4 +- .../container-registry-beta-billing-note.md | 2 +- .../container-registry-feature-highlights.md | 8 +- .../create-npmrc-owner-step.md | 4 +- .../docker_registry_deprecation_status.md | 5 + .../package_registry/package-immutability.md | 4 +- .../package-settings-from-org-level.md | 8 +- .../package-settings-from-user-level.md | 10 +- .../packages-ghes-release-stage.md | 2 +- .../public-or-private-packages.md | 2 +- .../repository_connection_steps.md | 4 +- .../package_registry/required-scopes.md | 2 +- .../verify_repository_field.md | 2 +- .../reusables/pages/about-front-matter.md | 2 +- .../data/reusables/pages/add-jekyll-theme.md | 2 +- .../data/reusables/pages/admin-must-push.md | 2 +- .../pages/best-with-supported-themes.md | 3 +- .../pages/build-failure-email-server.md | 2 +- .../pages/build-locally-download-cname.md | 2 +- .../pages/configure-publishing-source.md | 2 +- .../reusables/pages/contact-dns-provider.md | 2 +- .../data/reusables/pages/create-repo-name.md | 2 +- .../pages/decide-publishing-source.md | 2 +- .../pages/default-domain-information.md | 2 +- .../pages/enforce-https-custom-domain.md | 2 +- .../pages/jekyll-install-troubleshooting.md | 2 +- .../reusables/pages/must-have-repo-first.md | 2 +- .../pages/navigate-publishing-source.md | 2 +- .../reusables/pages/navigate-site-repo.md | 2 +- .../reusables/pages/new-or-existing-repo.md | 4 +- .../data/reusables/pages/recommend-bundler.md | 6 +- .../data/reusables/pages/remove-submodule.md | 4 +- .../reusables/pages/save-custom-domain.md | 2 +- .../reusables/pages/search-for-includes.md | 2 +- .../data/reusables/pages/test-locally.md | 2 +- .../pages/theme-customization-help.md | 2 +- .../pages/update_your_dns_settings.md | 2 +- .../pt-BR/data/reusables/pages/visit-site.md | 4 +- .../www-and-apex-domain-recommendation.md | 2 +- .../pt-BR/data/reusables/pages/yaml-linter.md | 2 +- .../pt-BR/data/reusables/pages/yaml-rules.md | 10 +- .../pt-BR/data/reusables/policies/abuse.md | 2 +- .../api-preview-warning.md | 2 +- .../content-attachments-public-beta.md | 2 +- .../pre-release-program/corsair-preview.md | 2 +- .../expiring-user-access-tokens-beta.md | 2 +- .../pre-release-program/fury-pre-release.md | 2 +- .../machine-man-preview.md | 4 +- .../pre-release-program/sailor-v-preview.md | 2 +- .../pre-release-program/starfox-preview.md | 4 +- .../suspend-installation-beta.md | 3 +- .../reusables/products/product-roadmap.md | 2 +- .../products/which-product-to-use.md | 4 +- .../data/reusables/profile/access_org.md | 2 +- .../data/reusables/profile/access_profile.md | 6 +- .../profile/activity-overview-summary.md | 2 +- .../profile/enterprise_access_profile.md | 2 +- .../data/reusables/profile/profile-readme.md | 2 +- .../user_profile_page_block_or_report.md | 2 +- .../access-collaboration-settings.md | 2 +- .../project-management/add-collaborator.md | 2 +- .../add-column-new-project.md | 2 +- .../automate-project-board-permissions.md | 2 +- .../project-management/choose-template.md | 2 +- .../project-management/click-create-column.md | 2 +- .../click-edit-sidebar-menu-project-board.md | 2 +- .../project-management/click-menu.md | 2 +- .../project-management/click-new-project.md | 2 +- .../project-management/collaborator-option.md | 2 +- .../collaborator-permissions.md | 2 +- .../confirm-label-deletion.md | 2 +- .../project-management/copy-project-boards.md | 2 +- .../create-project-button.md | 2 +- .../create-project-name-description.md | 2 +- .../project-management/delete-label.md | 2 +- .../project-management/edit-label.md | 2 +- .../edit-project-columns.md | 2 +- ...or-more-info-project-keyboard-shortcuts.md | 2 +- .../label-color-randomizer.md | 2 +- .../project-management/label-description.md | 2 +- .../reusables/project-management/labels.md | 2 +- .../link-repos-to-project-board.md | 2 +- .../project-management/linked-repositories.md | 2 +- .../project-management/milestones.md | 2 +- .../project-management/name-label.md | 2 +- .../name-project-board-column.md | 2 +- .../project-board-import-with-api.md | 2 +- .../project-board-permissions.md | 6 +- .../project-note-more-options.md | 2 +- .../project-management/remove-collaborator.md | 2 +- .../project-management/resync-automation.md | 2 +- .../select-column-preset.md | 2 +- .../project-management/select-project.md | 2 +- .../use-automated-template.md | 2 +- .../reusables/projects/disabled-projects.md | 2 +- .../automatically-delete-branches.md | 2 - .../close-issues-using-keywords.md | 2 +- ...ollect-co-author-commit-git-config-info.md | 2 +- .../commit-message-with-trailer-beginning.md | 4 +- .../configure_pull_request_merges_intro.md | 2 +- ...ve-competing-line-change-merge-conflict.md | 2 +- .../default-commit-message-squash-merge.md | 2 +- .../pull_requests/default_merge_option.md | 4 +- .../pull_requests/mark-ready-review.md | 2 +- .../perms-to-open-pull-request.md | 2 +- .../pull_request_merges_and_contributions.md | 6 +- .../pull_requests/rebase_and_merge_summary.md | 8 +- .../required-checks-must-pass-to-merge.md | 2 +- .../required-reviews-for-prs-summary.md | 4 +- .../pull_requests/resolving-conversations.md | 12 +- .../retargeted-on-branch-deletion.md | 2 +- .../pull_requests/squash_and_merge_summary.md | 6 +- .../about-scheduled-reminders-teams-orgs.md | 2 +- .../data/reusables/reminders/add-reminder.md | 2 +- .../data/reusables/reminders/approved-prs.md | 2 +- .../reusables/reminders/author-reviews.md | 2 +- .../reusables/reminders/authorize-slack.md | 2 +- .../reusables/reminders/create-reminder.md | 2 +- .../data/reusables/reminders/days-dropdown.md | 2 +- .../pt-BR/data/reusables/reminders/delete.md | 4 +- .../data/reusables/reminders/edit-existing.md | 2 +- .../data/reusables/reminders/edit-page.md | 2 +- .../data/reusables/reminders/ignore-drafts.md | 2 +- .../reusables/reminders/ignored-labels.md | 2 +- .../data/reusables/reminders/ignored-terms.md | 2 +- .../pt-BR/data/reusables/reminders/min-age.md | 2 +- .../data/reusables/reminders/min-staleness.md | 2 +- .../reusables/reminders/no-review-requests.md | 2 +- .../reusables/reminders/real-time-alerts.md | 2 +- .../reusables/reminders/required-labels.md | 2 +- .../reminders/scheduled-reminders.md | 2 +- .../data/reusables/reminders/slack-channel.md | 2 +- .../reusables/reminders/times-dropdowns.md | 2 +- .../data/reusables/reminders/tracked-repos.md | 8 +- .../reusables/reminders/update-buttons.md | 2 +- .../repositories/a-vulnerability-is.md | 2 +- .../repositories/about-github-actions.md | 2 +- .../about-github-archive-program.md | 2 +- .../accessing-repository-graphs.md | 2 +- .../accessing-repository-people.md | 2 +- .../repositories/action-root-user-required.md | 2 +- .../repositories/actions-env-var-note.md | 2 +- .../repositories/actions-matrix-builds-os.md | 2 +- .../actions-scheduled-workflow-example.md | 4 +- .../reusables/repositories/actions-tab.md | 2 +- .../actions-workflow-status-badge-into.md | 4 +- .../add-branch-protection-rules.md | 4 +- .../allow-maintainers-user-forks.md | 4 +- .../repositories/asking-for-review.md | 2 +- .../assign-an-issue-as-project-maintainer.md | 2 +- .../repositories/autolink-references.md | 2 +- .../repositories/blocked-passwords.md | 5 +- .../repositories/branch-rules-example.md | 2 +- .../reusables/repositories/changed-files.md | 2 +- .../repositories/choose-line-or-range.md | 6 +- .../repositories/choose-repo-visibility.md | 2 +- .../repositories/click-dependency-graph.md | 2 +- .../reusables/repositories/copy-clone-url.md | 18 +- .../create-issue-in-public-repository.md | 2 +- .../repositories/create-pull-request.md | 2 +- .../reusables/repositories/create-repo.md | 2 +- .../data/reusables/repositories/create_new.md | 2 +- .../repositories/default-issue-templates.md | 2 +- ...forks_from_private_repositories_warning.md | 6 +- .../reusables/repositories/deploy-keys.md | 2 +- .../reusables/repositories/desktop-fork.md | 2 +- .../repositories/edited-comment-list.md | 6 +- .../repositories/enable-security-alerts.md | 4 +- .../github-reviews-security-advisories.md | 4 +- .../repositories/github-security-lab.md | 2 +- .../repositories/include-administrators.md | 2 +- .../repositories/internal-repo-default.md | 2 +- .../repositories/issue-template-config.md | 2 +- .../repositories/legacy-issue-template-tip.md | 2 +- .../repositories/list-closed-pull-requests.md | 2 +- .../repositories/merge-all-pulls-together.md | 2 +- .../repositories/migrating-from-codeplex.md | 2 +- .../repositories/navigate-to-branches.md | 2 +- .../navigate-to-job-superlinter.md | 5 + .../repositories/navigate-to-manage-access.md | 2 +- .../navigate-to-security-and-analysis.md | 2 +- .../navigate-to-workflow-superlinter.md | 1 + .../repositories/navigate-to-workflow.md | 2 +- .../repositories/new-pull-request.md | 6 +- .../repositories/open-with-github-desktop.md | 10 +- .../reusables/repositories/owner-drop-down.md | 2 +- .../permissions-statement-read.md | 2 +- .../permissions-statement-write.md | 2 +- .../repositories/pr-title-description.md | 2 +- .../private_forks_inherit_permissions.md | 2 +- ...tected-branches-block-web-edits-uploads.md | 4 +- .../protected-branches-options.md | 2 +- .../reusables/repositories/relative-links.md | 10 +- .../data/reusables/repositories/releases.md | 4 +- .../data/reusables/repositories/repo-name.md | 2 +- .../reusables/repositories/repo-size-limit.md | 2 +- .../reported-content-resolved-tab.md | 2 +- .../repositories/repository-branches.md | 2 +- .../repositories/request-changes-tips.md | 8 +- .../request-security-advisory-cve-id.md | 2 +- .../repositories/required-status-merge-tip.md | 2 +- .../reusables/repositories/review-changes.md | 2 +- .../review-policy-overlapping-commits.md | 2 +- .../repositories/review-pr-commits.md | 2 +- .../repositories/review-summary-comment.md | 2 +- .../reusables/repositories/section-links.md | 4 +- .../security-advisories-republishing.md | 2 +- .../security-advisory-admin-permissions.md | 2 +- ...isory-collaborators-public-repositories.md | 2 +- .../security-advisory-edit-description.md | 2 +- .../security-advisory-edit-details.md | 2 +- .../security-alert-delivery-options.md | 2 +- .../security-alerts-x-github-severity.md | 2 +- .../repositories/security-guidelines.md | 2 +- .../select-items-in-issue-or-pr-list.md | 2 +- .../repositories/select-marketplace-apps.md | 4 +- .../repositories/sensitive-info-warning.md | 12 +- .../repositories/sidebar-advisories.md | 2 +- .../sidebar-code-scanning-alerts.md | 2 +- .../repositories/sidebar-dependabot-alerts.md | 2 +- .../repositories/sidebar-issue-pr.md | 2 +- .../reusables/repositories/sidebar-issues.md | 2 +- .../sidebar-moderation-reported-content.md | 2 +- .../repositories/sidebar-notifications.md | 2 +- .../data/reusables/repositories/sidebar-pr.md | 2 +- .../repositories/sidebar-security.md | 2 +- .../repositories/sidebar-settings.md | 2 +- .../reusables/repositories/sidebar-wiki.md | 2 +- ...quash-and-rebase-linear-commit-hisitory.md | 2 +- .../repositories/start-line-comment.md | 2 +- .../repositories/submit-new-issue.md | 2 +- .../reusables/repositories/submit-review.md | 2 +- .../reusables/repositories/suggest-changes.md | 2 +- .../repositories/task-list-markdown.md | 4 +- .../repositories/tracks-vulnerabilities.md | 14 +- .../repositories/transfer-repository-steps.md | 14 +- .../two-dot-diff-comparison-example-urls.md | 2 +- .../type-issue-title-and-description.md | 2 +- .../repositories/type-line-comment.md | 2 +- .../repositories/valid-community-issues.md | 2 +- .../view-failed-job-results-superlinter.md | 5 + .../repositories/view-run-superlinter.md | 1 + .../data/reusables/repositories/view-run.md | 2 +- .../view-specific-line-superlinter.md | 5 + .../repositories/workflow-notifications.md | 4 +- .../reusables/repositories/you-can-fork.md | 2 +- .../saml/about-authorized-credentials.md | 2 +- .../reusables/saml/about-linked-identities.md | 4 +- .../about-saml-access-enterprise-account.md | 2 +- ...ut-user-provisioning-enterprise-account.md | 2 +- .../reusables/saml/add-okta-application.md | 2 +- .../reusables/saml/assign-yourself-to-okta.md | 2 +- .../click-enterprise-account-application.md | 2 +- .../saml/click-person-revoke-credentials.md | 2 +- .../saml/click-person-revoke-identity.md | 2 +- .../saml/click-person-revoke-session.md | 2 +- .../saml/confirm-revoke-credentials.md | 2 +- .../reusables/saml/confirm-revoke-identity.md | 2 +- .../reusables/saml/dotcom-saml-explanation.md | 2 +- .../data/reusables/saml/okta-admin-button.md | 2 +- ...plications-click-ghec-application-label.md | 2 +- .../saml/okta-configure-api-integration.md | 2 +- .../saml/okta-dashboard-click-applications.md | 2 +- .../reusables/saml/okta-edit-provisioning.md | 10 +- .../saml/okta-enable-api-integration.md | 2 +- .../reusables/saml/okta-provisioning-tab.md | 2 +- .../reusables/saml/okta-save-provisioning.md | 2 +- .../data/reusables/saml/okta-sign-on-tab.md | 2 +- .../saml/okta-view-setup-instructions.md | 2 +- .../saml/outside-collaborators-exemption.md | 2 +- .../saml/revoke-authorized-credentials.md | 2 +- .../reusables/saml/revoke-saml-session.md | 2 +- .../reusables/saml/revoke-sso-identity.md | 2 +- .../reusables/saml/saml-identity-linked.md | 2 +- .../data/reusables/saml/saml-session-oauth.md | 2 +- .../saml/saml-single-logout-not-supported.md | 2 +- .../reusables/saml/saml-supported-idps.md | 2 +- .../data/reusables/saml/search-ghec-okta.md | 2 +- .../data/reusables/saml/testing-saml-sso.md | 2 +- .../data/reusables/saml/use-classic-ui.md | 4 +- .../saml/view-authorized-credentials.md | 2 +- .../data/reusables/saml/view-saml-sessions.md | 2 +- .../data/reusables/saml/view-sso-identity.md | 2 +- .../reusables/scim/enterprise-account-scim.md | 2 +- .../pt-BR/data/reusables/search/date_gt_lt.md | 2 +- .../search/requested_reviews_search.md | 2 +- .../search/requested_reviews_search_tip.md | 2 +- ...earch_issues_and_pull_requests_shortcut.md | 2 +- .../data/reusables/secret-scanning/beta.md | 4 +- ...urity-researcher-cannot-create-advisory.md | 2 +- ...-and-analysis-features-enable-read-only.md | 5 +- ...nalysis-features-are-enabled-by-default.md | 2 +- .../shortdesc/authenticating_github_app.md | 2 +- .../authenticating_with_github_apps.md | 2 +- .../shortdesc/authorizing_oauth_apps.md | 2 +- .../creating_custom_badges_github_apps.md | 2 +- .../creating_custom_badges_oauth_apps.md | 2 +- .../shortdesc/creating_github_apps.md | 2 +- .../shortdesc/creating_oauth_apps.md | 2 +- .../shortdesc/deleting_github_apps.md | 2 +- .../shortdesc/deleting_oauth_apps.md | 2 +- .../editing_permissions_for_github_apps.md | 2 +- ...identifying_and_authorizing_github_apps.md | 2 +- .../data/reusables/shortdesc/iso_8601.md | 2 +- .../making-a-github-app-public-or-private.md | 2 +- .../shortdesc/modifying_github_apps.md | 2 +- .../shortdesc/modifying_oauth_apps.md | 2 +- .../shortdesc/permissions_github_apps.md | 2 +- .../shortdesc/rate_limits_github_apps.md | 2 +- .../shortdesc/suspending_a_github_app.md | 2 +- .../transferring_ownership_of_github_apps.md | 2 +- .../transferring_ownership_of_oauth_apps.md | 2 +- ...g_access_token_reques_errors_oauth_apps.md | 2 +- ...authorization_request_errors_oauth_apps.md | 2 +- .../understanding_scopes_for_oauth_apps.md | 2 +- .../reusables/sponsors/accept-legal-terms.md | 2 +- .../reusables/sponsors/add-active-triggers.md | 2 +- .../reusables/sponsors/add-introduction.md | 2 +- .../data/reusables/sponsors/add-more-tiers.md | 2 +- .../data/reusables/sponsors/change-tier.md | 2 +- .../data/reusables/sponsors/click-add-tier.md | 2 +- .../reusables/sponsors/confirm-add-webhook.md | 2 +- .../sponsors/country-of-residence.md | 2 +- .../sponsors/create-stripe-account.md | 4 +- .../developer-sponsored-choose-updates.md | 2 +- .../reusables/sponsors/edit-featured-work.md | 6 +- .../data/reusables/sponsors/edit-goal.md | 2 +- .../data/reusables/sponsors/edit-tier.md | 2 +- .../sponsors/github-contact-applicants.md | 2 +- .../sponsors/legal-additional-terms.md | 2 +- .../sponsors/manage-developer-sponsorship.md | 4 +- .../sponsors/manage-existing-webhooks.md | 2 +- .../sponsors/manage-org-sponsorship.md | 4 +- .../sponsors/matching-fund-eligible.md | 2 +- .../data/reusables/sponsors/maximum-tier.md | 2 +- .../data/reusables/sponsors/meet-the-team.md | 10 +- .../navigate-to-dev-sponsors-dashboard.md | 2 +- .../sponsors/navigate-to-github-sponsors.md | 2 +- .../navigate-to-org-sponsors-dashboard.md | 2 +- .../sponsors/navigate-to-payouts-tab.md | 2 +- .../sponsors/navigate-to-profile-tab.md | 2 +- .../sponsors/navigate-to-sponsor-tiers-tab.md | 2 +- .../sponsors/navigate-to-sponsored-org.md | 2 +- .../sponsors/navigate-to-sponsors-tab.md | 2 +- .../sponsors/navigate-to-webhooks-tab.md | 2 +- .../sponsors/navigate-to-your-goals-tab.md | 2 +- .../pt-BR/data/reusables/sponsors/no-fees.md | 2 +- .../sponsors/opt-in-to-being-featured.md | 2 +- .../sponsors/org-sponsored-choose-updates.md | 2 +- .../data/reusables/sponsors/overview-tab.md | 2 +- .../data/reusables/sponsors/payout-info.md | 2 +- .../data/reusables/sponsors/publish-goal.md | 2 +- .../sponsors/publish-sponsor-update.md | 2 +- .../data/reusables/sponsors/retire-goal.md | 4 +- .../data/reusables/sponsors/retire-tier.md | 2 +- .../sponsors/review-and-publish-tier.md | 2 +- .../data/reusables/sponsors/save-profile.md | 2 +- .../reusables/sponsors/save-tier-draft.md | 2 +- .../data/reusables/sponsors/select-a-tier.md | 2 +- .../reusables/sponsors/select-goal-type.md | 8 +- .../data/reusables/sponsors/set-a-goal.md | 2 +- .../data/reusables/sponsors/settings-tab.md | 2 +- .../data/reusables/sponsors/short-bio.md | 2 +- .../reusables/sponsors/sponsorship-details.md | 2 +- .../sponsorships-not-tax-deductible.md | 2 +- .../sponsors/stripe-supported-regions.md | 2 +- .../sponsors/tax-form-information-dev.md | 6 +- .../sponsors/tax-form-information-org.md | 2 +- .../data/reusables/sponsors/tax-form-link.md | 4 +- .../data/reusables/sponsors/tier-details.md | 4 +- .../sponsors/tier-price-description.md | 2 +- .../reusables/sponsors/update-sponsorship.md | 2 +- .../sponsors/view-eligible-accounts.md | 2 +- .../sponsors/webhook-content-formatting.md | 2 +- .../sponsors/webhook-secret-token.md | 2 +- .../sponsors/who-can-see-your-sponsorship.md | 2 +- .../you-can-be-a-sponsored-developer.md | 2 +- .../you-can-be-a-sponsored-organization.md | 2 +- .../reusables/ssh/add-ssh-key-to-ssh-agent.md | 2 +- .../pt-BR/data/reusables/ssh/dsa-support.md | 2 +- .../reusables/support/about-premium-plans.md | 26 +- .../support/accessing-premium-content.md | 2 +- .../reusables/support/ask-and-answer-forum.md | 2 +- .../support/connect-in-the-forum-bootcamp.md | 2 +- .../support/contacting-premium-support.md | 2 +- .../support/data-protection-and-privacy.md | 2 +- ...nterprise-resolving-and-closing-tickets.md | 2 +- .../support/ghec-premium-priorities.md | 12 +- .../data/reusables/support/ghes-priorities.md | 12 +- .../github-can-modify-ticket-priority.md | 2 +- .../data/reusables/support/help_resources.md | 12 +- .../premium-resolving-and-closing-tickets.md | 2 +- .../support/priority-urgent-english-only.md | 2 +- .../reusables/support/scope-of-support.md | 8 +- .../service-level-agreement-response-times.md | 10 +- .../support/signing-up-for-premium-support.md | 2 +- .../data/reusables/time_date/date_format.md | 2 +- .../data/reusables/time_date/time_format.md | 2 +- .../2fa_not_supported_with_saml_and_cas.md | 2 +- .../pt-BR/data/reusables/two_fa/about-2fa.md | 1 + .../reusables/two_fa/about-recovery-codes.md | 2 +- .../two_fa/after-2fa-add-security-key.md | 2 +- .../data/reusables/two_fa/auth_methods_2fa.md | 16 +- .../enable-two-factor-authentication.md | 2 +- ...ve_your_recovery_codes_during_2fa_setup.md | 2 +- ...to-reinstate-user-before-2fa-is-enabled.md | 2 +- .../reusables/two_fa/show-recovery-codes.md | 2 +- .../reusables/two_fa/test_2fa_immediately.md | 2 +- .../reusables/two_fa/username-password.md | 2 +- .../user-settings/access_settings.md | 2 +- .../user-settings/edit_marketplace_listing.md | 2 +- .../reusables/user-settings/github_apps.md | 2 +- .../user-settings/github_apps_advanced.md | 2 +- .../user-settings/marketplace_apps.md | 2 +- .../user-settings/modify_github_app.md | 2 +- .../reusables/user-settings/oauth_apps.md | 2 +- .../user-settings/update_oauth_app.md | 2 +- .../user_settings/access_applications.md | 2 +- .../access_authorized_oauth_apps.md | 2 +- .../user_settings/access_settings.md | 2 +- .../user_settings/account_settings.md | 2 +- .../user_settings/add_and_verify_email.md | 4 +- .../user_settings/automatic_watching_box.md | 2 +- .../data/reusables/user_settings/billing.md | 2 +- .../reusables/user_settings/blocked_users.md | 2 +- .../reusables/user_settings/deleted-repos.md | 2 +- .../data/reusables/user_settings/emails.md | 2 +- .../reusables/user_settings/export-data.md | 3 +- .../reusables/user_settings/jira_help_docs.md | 2 +- .../keeping_your_email_address_private.md | 2 +- .../link_email_with_your_account.md | 2 +- .../no-verification-disposable-emails.md | 2 +- .../reusables/user_settings/notifications.md | 2 +- .../reusables/user_settings/organizations.md | 2 +- ...word-authentication-deprecation-desktop.md | 2 +- .../password-authentication-deprecation.md | 2 +- .../user_settings/payment-info-tab.md | 2 +- .../user_settings/personal_access_tokens.md | 2 +- .../user_settings/personal_dashboard.md | 2 +- .../user_settings/restore-confirmation.md | 2 +- .../reusables/user_settings/restore-repo.md | 2 +- .../user_settings/review-oauth-apps.md | 2 +- .../user_settings/review_oauth_tokens_tip.md | 2 +- .../reusables/user_settings/saved_replies.md | 2 +- .../user_settings/security-analysis.md | 2 +- .../data/reusables/user_settings/security.md | 6 +- .../user_settings/select_primary_email.md | 2 +- .../set_your_email_address_in_git.md | 2 +- .../pt-BR/data/reusables/user_settings/ssh.md | 2 +- .../user_settings/subscriptions-tab.md | 2 +- .../user_settings/sudo-mode-popup.md | 2 +- .../verify-org-approved-email-domain.md | 2 +- .../reusables/webhooks/action_type_desc.md | 2 +- .../pt-BR/data/reusables/webhooks/app_desc.md | 2 +- .../reusables/webhooks/authorization_event.md | 2 +- .../webhooks/check_run_properties.md | 18 +- .../webhooks/check_run_short_desc.md | 2 +- .../webhooks/check_suite_properties.md | 18 +- .../webhooks/check_suite_short_desc.md | 2 +- .../code_scanning_alert_event_properties.md | 12 +- .../code_scanning_alert_event_short_desc.md | 2 +- .../webhooks/commit_comment_properties.md | 8 +- .../webhooks/commit_comment_short_desc.md | 2 +- .../webhooks/content_reference_short_desc.md | 2 +- .../data/reusables/webhooks/content_type.md | 8 +- .../reusables/webhooks/create_properties.md | 12 +- .../reusables/webhooks/create_short_desc.md | 2 +- .../reusables/webhooks/delete_properties.md | 8 +- .../reusables/webhooks/delete_short_desc.md | 2 +- .../webhooks/deploy_key_properties.md | 8 +- .../webhooks/deploy_key_short_desc.md | 2 +- .../webhooks/deployment_short_desc.md | 2 +- .../webhooks/deployment_status_short_desc.md | 2 +- .../webhooks/enterprise_short_desc.md | 2 +- .../reusables/webhooks/events_api_payload.md | 2 +- .../reusables/webhooks/fork_properties.md | 2 +- .../reusables/webhooks/fork_short_desc.md | 2 +- .../reusables/webhooks/gollum_properties.md | 16 +- .../reusables/webhooks/gollum_short_desc.md | 2 +- .../webhooks/installation_properties.md | 4 +- .../installation_repositories_properties.md | 12 +- .../installation_repositories_short_desc.md | 2 +- .../webhooks/installation_short_desc.md | 2 +- .../webhooks/issue_comment_properties.md | 2 +- .../webhooks/issue_comment_short_desc.md | 2 +- .../issue_comment_webhook_properties.md | 6 +- .../webhooks/issue_event_api_properties.md | 6 +- .../reusables/webhooks/issue_properties.md | 2 +- .../webhooks/issue_webhook_properties.md | 6 +- .../reusables/webhooks/issues_short_desc.md | 2 +- .../reusables/webhooks/label_short_desc.md | 2 +- .../webhooks/member_event_api_properties.md | 6 +- .../reusables/webhooks/member_properties.md | 2 +- .../reusables/webhooks/member_short_desc.md | 2 +- .../webhooks/member_webhook_properties.md | 2 +- .../webhooks/membership_properties.md | 12 +- .../webhooks/membership_short_desc.md | 2 +- .../webhooks/milestone_properties.md | 16 +- .../webhooks/milestone_short_desc.md | 2 +- .../webhooks/org_block_short_desc.md | 2 +- .../pt-BR/data/reusables/webhooks/org_desc.md | 2 +- .../webhooks/organization_short_desc.md | 2 +- .../reusables/webhooks/package_properties.md | 8 +- .../webhooks/page_build_short_desc.md | 2 +- .../data/reusables/webhooks/payload_url.md | 2 +- .../reusables/webhooks/ping_short_desc.md | 2 +- .../webhooks/project_card_properties.md | 14 +- .../webhooks/project_card_short_desc.md | 2 +- .../webhooks/project_column_properties.md | 14 +- .../webhooks/project_column_short_desc.md | 2 +- .../reusables/webhooks/project_properties.md | 14 +- .../reusables/webhooks/project_short_desc.md | 2 +- .../reusables/webhooks/public_short_desc.md | 2 +- .../pull_request_event_api_properties.md | 6 +- .../webhooks/pull_request_properties.md | 2 +- ...est_review_comment_event_api_properties.md | 6 +- .../pull_request_review_comment_properties.md | 2 +- .../pull_request_review_comment_short_desc.md | 2 +- ...quest_review_comment_webhook_properties.md | 6 +- .../pull_request_review_properties.md | 8 +- .../pull_request_review_short_desc.md | 2 +- .../webhooks/pull_request_short_desc.md | 2 +- .../pull_request_webhook_properties.md | 6 +- .../reusables/webhooks/push_short_desc.md | 2 +- .../webhooks/release_event_api_properties.md | 6 +- .../reusables/webhooks/release_properties.md | 2 +- .../reusables/webhooks/release_short_desc.md | 2 +- .../webhooks/release_webhook_properties.md | 6 +- .../data/reusables/webhooks/repo_desc.md | 2 +- .../webhooks/repository_import_properties.md | 6 +- .../webhooks/repository_import_short_desc.md | 2 +- .../webhooks/repository_short_desc.md | 2 +- ...pository_vulnerability_alert_properties.md | 8 +- ...pository_vulnerability_alert_short_desc.md | 2 +- .../pt-BR/data/reusables/webhooks/secret.md | 2 +- .../data/reusables/webhooks/sender_desc.md | 2 +- .../sponsorship_event_api_properties.md | 6 +- .../webhooks/sponsorship_properties.md | 2 +- .../webhooks/sponsorship_short_desc.md | 2 +- .../sponsorship_webhook_properties.md | 6 +- .../reusables/webhooks/star_properties.md | 8 +- .../reusables/webhooks/star_short_desc.md | 2 +- .../reusables/webhooks/status_short_desc.md | 2 +- .../reusables/webhooks/team_add_short_desc.md | 2 +- .../reusables/webhooks/team_short_desc.md | 2 +- .../reusables/webhooks/watch_properties.md | 6 +- .../reusables/webhooks/watch_short_desc.md | 2 +- .../data/reusables/webhooks/webhooks_ssl.md | 2 +- .../reusables/webhooks/workflow_run_desc.md | 2 +- .../pt-BR/data/variables/command_line.yml | 2 +- translations/pt-BR/data/variables/contact.yml | 11 +- translations/pt-BR/data/variables/explore.yml | 6 +- translations/pt-BR/data/variables/gists.yml | 6 +- .../pt-BR/data/variables/notifications.yml | 4 +- translations/pt-BR/data/variables/product.yml | 21 +- translations/pt-BR/data/variables/search.yml | 10 +- .../actions/creating-actions/about-actions.md | 8 +- .../creating-a-composite-run-steps-action.md | 19 +- .../creating-a-docker-container-action.md | 2 +- .../creating-a-javascript-action.md | 10 +- .../content/actions/creating-actions/index.md | 1 + .../metadata-syntax-for-github-actions.md | 6 +- .../guides/about-continuous-integration.md | 63 + .../about-packaging-with-github-actions.md | 48 + .../guides/about-service-containers.md | 117 ++ .../building-and-testing-java-with-ant.md | 109 ++ .../building-and-testing-java-with-gradle.md | 134 ++ .../building-and-testing-java-with-maven.md | 135 ++ .../guides/building-and-testing-nodejs.md | 276 ++++ .../guides/building-and-testing-python.md | 427 ++++++ ...hing-dependencies-to-speed-up-workflows.md | 192 +++ .../creating-postgresql-service-containers.md | 335 +++++ .../creating-redis-service-containers.md | 325 +++++ .../ru-RU/content/actions/guides/index.md | 60 + .../guides/publishing-docker-images.md | 158 ++ .../publishing-java-packages-with-gradle.md | 219 +++ .../publishing-java-packages-with-maven.md | 210 +++ .../guides/publishing-nodejs-packages.md | 210 +++ ...us-integration-using-workflow-templates.md | 43 + .../storing-workflow-data-as-artifacts.md | 249 ++++ .../about-self-hosted-runners.md | 9 + .../adding-self-hosted-runners.md | 3 +- .../removing-self-hosted-runners.md | 3 +- translations/ru-RU/content/actions/index.md | 58 +- .../essential-features-of-github-actions.md | 95 ++ .../finding-and-customizing-actions.md | 156 ++ .../actions/learn-github-actions/index.md | 42 + .../introduction-to-github-actions.md | 225 +++ .../managing-complex-workflows.md | 151 ++ ...-from-azure-pipelines-to-github-actions.md | 327 +++++ ...grating-from-circleci-to-github-actions.md | 447 ++++++ ...ting-from-gitlab-cicd-to-github-actions.md | 476 +++++++ ...igrating-from-jenkins-to-github-actions.md | 293 ++++ .../security-hardening-for-github-actions.md | 97 ++ ...haring-workflows-with-your-organization.md | 114 ++ .../adding-a-workflow-status-badge.md | 63 + .../canceling-a-workflow.md | 31 + .../deleting-a-workflow-run.md | 23 + .../disabling-and-enabling-a-workflow.md | 45 + .../downloading-workflow-artifacts.md | 22 + .../enabling-debug-logging.md | 38 + .../actions/managing-workflow-runs/index.md | 32 + .../manually-running-a-workflow.md | 31 + .../re-running-a-workflow.md | 19 + .../removing-workflow-artifacts.md | 41 + .../using-workflow-run-logs.md | 86 ++ .../viewing-job-execution-time.md | 24 + .../viewing-workflow-run-history.md | 18 + .../ru-RU/content/actions/quickstart.md | 75 + .../reference/authentication-in-a-workflow.md | 100 ++ ...nd-expression-syntax-for-github-actions.md | 88 +- .../actions/reference/encrypted-secrets.md | 221 +++ .../reference/environment-variables.md | 69 + .../events-that-trigger-workflows.md | 228 +-- .../ru-RU/content/actions/reference/index.md | 40 +- ...pecifications-for-github-hosted-runners.md | 149 ++ ...usage-limits-billing-and-administration.md | 88 ++ .../workflow-commands-for-github-actions.md | 125 +- .../workflow-syntax-for-github-actions.md | 126 +- ...-your-github-enterprise-server-instance.md | 2 - .../changing-authentication-methods.md | 1 - .../disabling-unauthenticated-sign-ups.md | 1 - .../content/admin/authentication/index.md | 2 - .../using-built-in-authentication.md | 1 - .../content/admin/authentication/using-cas.md | 4 +- .../admin/authentication/using-ldap.md | 20 +- .../admin/authentication/using-saml.md | 14 +- .../accessing-the-administrative-shell-ssh.md | 1 - .../accessing-the-management-console.md | 2 - .../configuration/command-line-utilities.md | 5 +- .../configuration/configuring-a-hostname.md | 1 - .../configuring-advanced-security-features.md | 3 - ...onfiguring-an-outbound-web-proxy-server.md | 1 - .../configuration/configuring-applications.md | 5 +- .../configuring-built-in-firewall-rules.md | 2 - ...guring-code-scanning-for-your-appliance.md | 13 +- .../configuring-dns-nameservers.md | 2 - .../configuring-network-settings.md | 2 - .../configuration/configuring-rate-limits.md | 1 - ...dress-using-the-virtual-machine-console.md | 9 +- .../configuring-your-enterprise.md | 2 - ...prise-server-to-github-enterprise-cloud.md | 7 +- ...ependencies-on-github-enterprise-server.md | 4 +- ...nabling-and-scheduling-maintenance-mode.md | 1 - ...rise-server-and-github-enterprise-cloud.md | 1 - .../configuration/enabling-private-mode.md | 1 - .../enabling-subdomain-isolation.md | 37 +- ...-github-enterprise-server-and-githubcom.md | 1 - .../content/admin/configuration/index.md | 12 +- ...rise-server-and-github-enterprise-cloud.md | 2 - .../admin/configuration/network-ports.md | 22 +- .../troubleshooting-ssl-errors.md | 2 - ...-enterprise-server-with-a-load-balancer.md | 1 - .../validating-your-domain-settings.md | 1 - .../about-cluster-nodes.md | 1 - .../enterprise-management/about-clustering.md | 2 - .../about-geo-replication.md | 2 +- .../about-high-availability-configuration.md | 11 +- .../accessing-the-monitor-dashboard.md | 13 +- .../cluster-network-configuration.md | 1 - .../configuring-clustering.md | 2 - .../configuring-high-availability.md | 2 - .../creating-a-high-availability-replica.md | 2 +- .../enabling-automatic-update-checks.md | 1 - .../evacuating-a-cluster-node.md | 1 - .../increasing-cpu-or-memory-resources.md | 1 - .../increasing-storage-capacity.md | 2 - .../admin/enterprise-management/index.md | 8 +- .../initializing-the-cluster.md | 5 +- ...o-github-enterprise-server-214-or-later.md | 2 - ...ng-from-github-enterprise-1110x-to-2123.md | 1 - .../monitoring-your-appliance.md | 2 - ...ering-a-high-availability-configuration.md | 1 - .../removing-a-high-availability-replica.md | 2 - .../replacing-a-cluster-node.md | 2 - .../setting-up-external-monitoring.md | 2 - ...-virtual-machine-and-physical-resources.md | 2 - .../upgrading-a-cluster.md | 1 - .../about-support-for-advanced-security.md | 4 +- .../content/admin/enterprise-support/index.md | 2 - .../preparing-to-submit-a-ticket.md | 2 - .../reaching-github-support.md | 2 +- .../receiving-help-from-github-support.md | 2 - ...com-actions-on-github-enterprise-server.md | 4 - ...-githubcom-actions-using-github-connect.md | 1 - ...ub-actions-policies-for-your-enterprise.md | 3 - .../content/admin/github-actions/index.md | 2 - ...naging-access-to-actions-from-githubcom.md | 4 - ...-hosted-runners-without-internet-access.md | 2 +- translations/ru-RU/content/admin/index.md | 2 - .../ru-RU/content/admin/installation/index.md | 2 - ...erprise-server-on-google-cloud-platform.md | 3 +- ...thub-enterprise-server-on-openstack-kvm.md | 4 +- ...-up-a-github-enterprise-server-instance.md | 2 - .../setting-up-a-staging-instance.md | 1 - .../overview/about-enterprise-accounts.md | 2 - .../about-the-github-enterprise-server-api.md | 6 +- .../managing-billing-for-github-enterprise.md | 1 - ...managing-your-github-enterprise-license.md | 7 +- ...ng-packages-support-for-your-enterprise.md | 3 - ...guring-third-party-storage-for-packages.md | 3 - ...ing-github-packages-for-your-enterprise.md | 5 - .../ru-RU/content/admin/packages/index.md | 3 - .../admin/policies/about-pre-receive-hooks.md | 2 - .../creating-a-pre-receive-hook-script.md | 4 +- .../enforcing-policies-for-your-enterprise.md | 4 - ...enforcing-policy-with-pre-receive-hooks.md | 2 - ...-management-policies-in-your-enterprise.md | 4 +- .../ru-RU/content/admin/policies/index.md | 2 - ...-the-github-enterprise-server-appliance.md | 1 - .../user-management/activity-dashboard.md | 1 - .../user-management/adding-people-to-teams.md | 2 - .../admin/user-management/audit-logging.md | 4 +- .../admin/user-management/audited-actions.md | 44 +- .../user-management/auditing-ssh-keys.md | 1 - .../auditing-users-across-your-instance.md | 2 +- .../best-practices-for-user-security.md | 2 - .../configuring-email-for-notifications.md | 1 - ...-visibility-for-organization-membership.md | 1 - .../user-management/creating-organizations.md | 1 - .../admin/user-management/creating-teams.md | 4 +- ...tomizing-user-messages-on-your-instance.md | 1 - ...-ssh-access-on-github-enterprise-server.md | 1 - ...exporting-migration-data-from-githubcom.md | 2 - ...ing-migration-data-from-your-enterprise.md | 2 - .../content/admin/user-management/index.md | 2 - .../user-management/managing-dormant-users.md | 1 - .../managing-global-webhooks.md | 1 - ...naging-organizations-in-your-enterprise.md | 2 - .../managing-projects-using-jira.md | 2 - ...anaging-repositories-in-your-enterprise.md | 2 - .../managing-users-in-your-enterprise.md | 2 - ...rating-data-to-and-from-your-enterprise.md | 2 - .../migrating-data-to-your-enterprise.md | 4 +- .../monitoring-activity-in-your-enterprise.md | 4 - ...-a-legal-hold-on-a-user-or-organization.md | 1 - ...nting-users-from-creating-organizations.md | 1 - ...moting-or-demoting-a-site-administrator.md | 1 - .../rebuilding-contributions-data.md | 4 +- ...ving-users-from-teams-and-organizations.md | 1 - .../searching-the-audit-log.md | 30 +- .../troubleshooting-service-hooks.md | 1 - .../user-management/viewing-push-logs.md | 1 - ...epository-from-github-to-github-desktop.md | 8 +- ...orking-repositories-from-github-desktop.md | 8 +- .../creating-an-issue-or-pull-request.md | 8 +- .../authenticating-to-github.md | 8 +- .../keyboard-shortcuts.md | 140 +- .../apps/activating-beta-features-for-apps.md | 3 +- .../developers/apps/authorizing-oauth-apps.md | 51 +- ...ating-a-custom-badge-for-your-oauth-app.md | 5 +- .../creating-a-github-app-from-a-manifest.md | 6 +- ...ating-a-github-app-using-url-parameters.md | 142 +- .../creating-ci-tests-with-the-checks-api.md | 104 +- ...nces-between-github-apps-and-oauth-apps.md | 16 +- .../apps/editing-a-github-apps-permissions.md | 2 + ...g-and-authorizing-users-for-github-apps.md | 95 +- .../migrating-oauth-apps-to-github-apps.md | 1 - .../developers/apps/modifying-an-oauth-app.md | 6 +- ...refreshing-user-to-server-access-tokens.md | 6 +- .../developers/apps/scopes-for-oauth-apps.md | 7 +- ...ment-environment-to-create-a-github-app.md | 1 - .../suspending-a-github-app-installation.md | 8 +- .../apps/using-the-github-api-in-your-app.md | 1 - .../drafting-a-listing-for-your-app.md | 5 +- .../viewing-metrics-for-your-listing.md | 3 +- .../viewing-transactions-for-your-listing.md | 3 +- ...k-events-for-the-github-marketplace-api.md | 6 +- .../overview/managing-deploy-keys.md | 1 - .../overview/replacing-github-services.md | 1 - .../overview/using-ssh-agent-forwarding.md | 2 +- .../webhooks-and-events/about-webhooks.md | 5 +- .../webhooks-and-events/github-event-types.md | 1 - .../webhooks-and-events/issue-event-types.md | 1 - .../securing-your-webhooks.md | 27 +- .../webhooks-and-events/testing-webhooks.md | 1 - .../webhook-events-and-payloads.md | 83 +- .../about-branch-restrictions.md | 8 +- ...fications-for-pushes-to-your-repository.md | 3 +- ...about-github-dependabot-version-updates.md | 6 +- .../about-releases.md | 6 +- .../changing-the-default-branch.md | 53 + ...guration-options-for-dependency-updates.md | 30 +- ...tolinks-to-reference-external-resources.md | 2 +- ...s-artifacts-and-logs-in-your-repository.md | 18 + ...g-your-repositorys-social-media-preview.md | 2 +- ...nd-restoring-branches-in-a-pull-request.md | 3 +- ...imiting-github-actions-for-a-repository.md | 37 + ...ing-a-sponsor-button-in-your-repository.md | 22 +- .../enabling-branch-restrictions.md | 2 +- .../administering-a-repository/index.md | 3 +- ...tions-up-to-date-with-github-dependabot.md | 2 +- .../managing-releases-in-a-repository.md | 7 +- ...ging-the-automatic-deletion-of-branches.md | 2 +- .../about-authentication-to-github.md | 1 - .../about-commit-signature-verification.md | 3 +- .../authenticating-to-github/about-ssh.md | 5 +- .../about-two-factor-authentication.md | 2 +- ...ng-a-new-ssh-key-to-your-github-account.md | 2 +- .../authorizing-oauth-apps.md | 2 +- .../checking-for-existing-ssh-keys.md | 3 +- ...t-and-tag-signature-verification-status.md | 4 +- ...-factor-authentication-recovery-methods.md | 4 +- .../configuring-two-factor-authentication.md | 28 +- ...onnecting-with-third-party-applications.md | 2 +- .../error-permission-denied-publickey.md | 76 +- ...e-problem-verify-that-the-ca-cert-is-ok.md | 4 +- ...ccount-if-you-lose-your-2fa-credentials.md | 3 +- ...moving-sensitive-data-from-a-repository.md | 8 +- .../reviewing-your-security-log.md | 138 +- .../reviewing-your-ssh-keys.md | 31 +- .../signing-commits.md | 3 +- ...updating-your-github-access-credentials.md | 4 - .../working-with-ssh-key-passphrases.md | 5 +- ...ing-issue-templates-for-your-repository.md | 2 +- ...reating-a-default-community-health-file.md | 16 +- .../about-branches.md | 14 +- ...out-comparing-branches-in-pull-requests.md | 4 +- .../about-forks.md | 2 +- .../about-status-checks.md | 2 +- ...pull-request-branch-created-from-a-fork.md | 4 +- .../creating-a-pull-request.md | 2 +- ...eleting-branches-within-your-repository.md | 2 +- .../dismissing-a-pull-request-review.md | 6 +- .../filtering-files-in-a-pull-request.md | 4 +- .../merging-a-pull-request.md | 4 +- ...g-an-upstream-repository-into-your-fork.md | 4 +- .../resolving-a-merge-conflict-on-github.md | 9 +- ...a-merge-conflict-using-the-command-line.md | 4 +- ...wing-proposed-changes-in-a-pull-request.md | 4 +- .../working-with-pre-receive-hooks.md | 2 +- .../changing-a-commit-message.md | 21 +- .../commit-branch-and-tag-labels.md | 2 +- .../about-code-owners.md | 3 +- .../about-repositories.md | 3 +- .../about-repository-languages.md | 3 +- .../backing-up-a-repository.md | 15 +- .../cloning-a-repository.md | 4 +- .../creating-a-new-repository.md | 9 +- .../creating-a-repository-from-a-template.md | 2 +- .../creating-a-template-repository.md | 2 +- ...s-to-nonexistent-ref-unable-to-checkout.md | 10 +- .../licensing-a-repository.md | 1 + .../about-billing-for-codespaces.md | 27 + .../about-codespaces.md | 2 +- ...configuring-codespaces-for-your-project.md | 8 +- .../index.md | 4 +- .../using-codespaces-in-visual-studio-code.md | 45 + .../using-codespaces-in-visual-studio.md | 53 + .../about-code-scanning.md | 2 +- .../about-integration-with-code-scanning.md | 10 +- ...our-code-for-vulnerabilities-and-errors.md | 1 + .../configuring-code-scanning.md | 63 +- ...-codeql-code-scanning-in-your-ci-system.md | 165 +++ ...-codeql-workflow-for-compiled-languages.md | 116 ++ ...enabling-code-scanning-for-a-repository.md | 80 +- .../index.md | 14 +- .../integrating-with-code-scanning.md | 3 +- ...ode-scanning-alerts-for-your-repository.md | 63 + ...-codeql-code-scanning-in-your-ci-system.md | 162 +++ .../sarif-support-for-code-scanning.md | 169 +-- ...g-code-scanning-alerts-in-pull-requests.md | 48 + ...-codeql-code-scanning-in-your-ci-system.md | 52 + .../troubleshooting-the-codeql-workflow.md | 126 ++ .../uploading-a-sarif-file-to-github.md | 16 +- ...e-scanning-with-your-existing-ci-system.md | 11 + .../create-a-repo.md | 4 +- .../fork-a-repo.md | 8 +- .../github-for-mobile.md | 10 + .../githubs-products.md | 2 +- .../keyboard-shortcuts.md | 54 +- .../saving-repositories-with-stars.md | 3 +- .../types-of-github-accounts.md | 3 +- ...roject-to-github-using-the-command-line.md | 21 +- ...-differences-between-subversion-and-git.md | 4 +- ...-to-a-repository-using-the-command-line.md | 4 +- .../getting-permanent-links-to-files.md | 4 +- ...g-with-jupyter-notebook-files-on-github.md | 4 +- .../about-git-large-file-storage.md | 11 +- .../about-storage-and-bandwidth-usage.md | 3 +- .../configuring-git-large-file-storage.md | 2 +- .../installing-git-large-file-storage.md | 3 +- ...bout-alerts-for-vulnerable-dependencies.md | 26 +- ...ring-github-dependabot-security-updates.md | 14 +- .../about-notifications.md | 3 +- .../configuring-notifications.md | 25 +- .../managing-notifications-from-your-inbox.md | 1 - ...and-pull-requests-with-query-parameters.md | 18 +- .../about-issues.md | 4 +- .../about-labels.md | 22 +- ...es-and-pull-requests-to-a-project-board.md | 11 +- ...ying-labels-to-issues-and-pull-requests.md | 3 +- ...and-pull-requests-to-other-github-users.md | 2 +- .../creating-a-project-board.md | 2 +- .../disabling-issues.md | 3 +- .../filtering-cards-on-a-project-board.md | 6 +- .../linking-a-pull-request-to-an-issue.md | 16 +- ...sferring-an-issue-to-another-repository.md | 4 +- .../about-email-notifications.md | 18 +- .../about-notifications.md | 5 +- ...to-and-unsubscribing-from-notifications.md | 11 +- .../watching-and-unwatching-repositories.md | 2 - ...atching-and-unwatching-team-discussions.md | 12 +- .../about-searching-on-github.md | 4 +- .../searching-for-packages.md | 9 +- .../sorting-search-results.md | 16 +- .../about-billing-for-github-actions.md | 6 +- .../about-billing-for-github-packages.md | 4 +- ...-your-spending-limit-for-github-actions.md | 4 +- ...your-spending-limit-for-github-packages.md | 4 +- .../upgrading-your-github-subscription.md | 4 +- .../viewing-your-github-actions-usage.md | 6 +- .../viewing-your-github-packages-usage.md | 4 +- .../about-organizations.md | 1 - .../about-ssh-certificate-authorities.md | 2 +- ...to-a-project-board-in-your-organization.md | 4 +- ...ithub-app-managers-in-your-organization.md | 4 +- ...saml-single-sign-on-and-scim-using-okta.md | 4 +- ...artifacts-and-logs-in-your-organization.md | 16 + ...ng-github-actions-for-your-organization.md | 38 + .../index.md | 2 +- ...nviting-users-to-join-your-organization.md | 4 +- ...access-to-an-organization-project-board.md | 4 +- ...cess-to-your-organizations-repositories.md | 2 +- ...e-for-repositories-in-your-organization.md | 15 +- ...ay-of-member-names-in-your-organization.md | 2 +- ...ganizations-ssh-certificate-authorities.md | 2 +- .../permission-levels-for-an-organization.md | 169 +-- ...hub-app-managers-from-your-organization.md | 4 +- ...y-permission-levels-for-an-organization.md | 190 +-- ...tor-authentication-in-your-organization.md | 20 +- ...epository-creation-in-your-organization.md | 2 +- ...ing-the-audit-log-for-your-organization.md | 236 ++- ...ading-to-the-corporate-terms-of-service.md | 4 +- .../about-enterprise-accounts.md | 2 - ...cts-and-logs-in-your-enterprise-account.md | 19 + ...ons-policies-in-your-enterprise-account.md | 15 +- .../index.md | 2 + ...dio-subscription-with-github-enterprise.md | 42 + ...ewing-people-in-your-enterprise-account.md | 4 +- .../personalizing-your-profile.md | 12 +- .../changing-your-primary-email-address.md | 9 +- .../converting-a-user-into-an-organization.md | 2 +- ...ss-to-your-user-accounts-project-boards.md | 4 +- ...fault-branch-name-for-your-repositories.md | 12 +- ...on-levels-for-a-user-account-repository.md | 7 +- .../github-acceptable-use-policies.md | 2 +- .../github-additional-product-terms.md | 6 +- ...the-github-enterprise-license-agreement.md | 2 +- .../github-corporate-terms-of-service.md | 2 +- ...b-enterprise-cloud-evaluation-agreement.md | 2 +- ...thub-enterprise-service-level-agreement.md | 4 +- ...ource-applications-terms-and-conditions.md | 2 +- .../site-policy/github-pre-release-program.md | 2 +- .../site-policy/github-privacy-statement.md | 6 +- .../github-research-program-terms.md | 2 +- .../github-subprocessors-and-cookies.md | 106 +- ...p-github-sponsors-for-your-organization.md | 2 +- ...p-github-sponsors-for-your-user-account.md | 2 +- .../dealing-with-non-fast-forward-errors.md | 4 +- ...g-a-subfolder-out-into-a-new-repository.md | 2 +- .../about-the-dependency-graph.md | 19 +- ...loring-the-dependencies-of-a-repository.md | 11 +- ...nd-deletions-to-content-in-a-repository.md | 2 +- .../about-github-pages-and-jekyll.md | 3 +- .../about-github-pages.md | 12 +- ...yll-build-errors-for-github-pages-sites.md | 2 - ...-to-your-github-pages-site-using-jekyll.md | 6 +- ...shing-source-for-your-github-pages-site.md | 4 +- ...ustom-domain-for-your-github-pages-site.md | 3 +- .../unpublishing-a-github-pages-site.md | 4 +- .../about-github-support.md | 14 +- .../autolinked-references-and-urls.md | 5 +- .../basic-writing-and-formatting-syntax.md | 3 - .../writing-on-github/creating-gists.md | 3 - .../guides/managing-enterprise-accounts.md | 2 +- translations/ru-RU/content/index.md | 4 +- ...n-github-enterprise-and-github-insights.md | 2 +- ...n-github-insights-and-github-enterprise.md | 5 +- .../installing-github-insights.md | 3 +- ...ub-container-registry-for-docker-images.md | 12 +- ...cting-a-repository-to-a-container-image.md | 4 +- .../pushing-and-pulling-docker-images.md | 8 +- .../about-github-packages.md | 32 +- .../deleting-a-package.md | 1 - .../publishing-a-package.md | 3 +- .../viewing-packages.md | 2 +- ...ing-docker-for-use-with-github-packages.md | 19 +- ...dotnet-cli-for-use-with-github-packages.md | 1 - ...ing-gradle-for-use-with-github-packages.md | 65 +- ...guring-npm-for-use-with-github-packages.md | 4 +- ...ing-github-packages-with-github-actions.md | 7 +- .../rest/guides/basics-of-authentication.md | 10 +- .../guides/best-practices-for-integrators.md | 1 - .../getting-started-with-the-checks-api.md | 4 +- ...tting-started-with-the-git-database-api.md | 6 +- .../getting-started-with-the-rest-api.md | 5 +- .../rest/guides/rendering-data-as-graphs.md | 2 +- .../content/rest/overview/api-previews.md | 24 +- .../overview/other-authentication-methods.md | 4 +- .../overview/resources-in-the-rest-api.md | 1 - .../ru-RU/content/rest/reference/actions.md | 14 +- .../ru-RU/content/rest/reference/activity.md | 22 +- .../ru-RU/content/rest/reference/apps.md | 2 - .../ru-RU/content/rest/reference/checks.md | 2 +- .../content/rest/reference/code-scanning.md | 14 + .../rest/reference/enterprise-admin.md | 19 +- .../ru-RU/content/rest/reference/licenses.md | 4 +- .../permissions-required-for-github-apps.md | 111 +- .../ru-RU/content/rest/reference/pulls.md | 2 +- .../ru-RU/content/rest/reference/repos.md | 6 +- .../ru-RU/data/glossaries/candidates.yml | 40 +- .../ru-RU/data/glossaries/external.yml | 132 +- .../ru-RU/data/glossaries/internal.yml | 12 +- .../ru-RU/data/graphql/graphql_previews.yml | 51 - translations/ru-RU/data/products.yml | 11 +- .../actions/about-artifact-log-retention.md | 6 + .../data/reusables/actions/about-artifacts.md | 2 +- .../data/reusables/actions/about-secrets.md | 2 +- .../actions/about-self-hosted-runners.md | 2 +- .../reusables/actions/about-workflow-jobs.md | 2 +- .../reusables/actions/about-workflow-runs.md | 2 +- .../data/reusables/actions/about-workflows.md | 2 +- .../actions-app-actions-permissions-api.md | 2 +- .../actions/actions-authentication.md | 2 +- .../reusables/actions/actions-not-verified.md | 2 +- .../actions/actions-use-policy-settings.md | 3 + .../actions/allow-specific-actions-intro.md | 19 + .../actions/enterprise-actions-permissions.md | 2 +- .../data/reusables/actions/enterprise-beta.md | 2 +- .../enterprise-github-hosted-runners.md | 2 +- .../reusables/actions/registry-credentials.md | 1 + .../actions/scheduled-workflows-disabled.md | 1 + .../apps/general-apps-restrictions.md | 2 +- .../apps/maximum-github-apps-allowed.md | 2 +- .../apps/maximum-oauth-apps-allowed.md | 2 +- .../reusables/apps/metadata-permissions.md | 2 +- .../reusables/apps/oauth-apps-restrictions.md | 2 +- .../data/reusables/apps/state_description.md | 2 +- .../reusables/audit_log/audit-log-search.md | 2 - .../branches/change-default-branch.md | 1 + ...efault-branch-automatically-base-branch.md | 3 +- .../branches/new-repo-default-branch.md | 3 +- .../reusables/branches/set-default-branch.md | 2 +- .../reusables/code-scanning/analyze-go.md | 1 + .../autobuild-add-build-steps.md | 2 +- .../autobuild-compiled-languages.md | 6 +- .../code-scanning/beta-codeql-runner.md | 9 + .../data/reusables/code-scanning/beta.md | 6 +- .../code-scanning/click-alert-in-list.md | 2 +- .../code-scanning/close-alert-examples.md | 1 + .../code-scanning/codeql-runner-license.md | 8 +- .../reusables/code-scanning/edit-workflow.md | 2 +- .../code-scanning/enabling-options.md | 2 +- .../false-positive-fix-codeql.md | 1 + ...eroperable-with-tools-that-output-sarif.md | 2 +- .../specify-language-to-analyze.md | 2 +- .../about-billing-for-codespaces.md | 1 + .../click-remote-explorer-icon-vscode.md | 2 +- .../codespaces/codespaces-are-per-branch.md | 2 +- .../codespaces/codespaces-are-personal.md | 2 +- .../connect-to-codespace-from-vscode.md | 2 +- .../codespaces/devcontainer-location.md | 1 + .../codespaces/navigate-to-codespaces.md | 2 +- .../reusables/codespaces/release-stage.md | 2 +- .../reusables/codespaces/unsupported-repos.md | 2 +- .../codespaces/use-visual-studio-features.md | 2 +- .../you-can-see-all-your-codespaces.md | 2 +- .../reusables/command_line/git-clone-url.md | 2 +- .../dependabot/check-in-dependabot-yml.md | 2 +- .../dependabot/create-dependabot-yml.md | 2 +- .../default-dependencies-allow-ignore.md | 2 +- .../reusables/dependabot/dependabot-tos.md | 2 +- .../option-affects-security-updates.md | 2 +- .../dependabot/private-dependencies.md | 2 +- .../dependabot/supported-package-managers.md | 44 +- .../data/reusables/desktop/choose-a-theme.md | 2 +- .../data/reusables/desktop/confirm-tag.md | 2 +- .../data/reusables/desktop/create-tag.md | 2 +- .../data/reusables/desktop/revert-commit.md | 2 +- .../reusables/desktop/select-base-branch.md | 2 +- .../reusables/dotcom_billing/add-seats.md | 2 +- .../dotcom_billing/confirm-add-seats.md | 2 +- .../dotcom_billing/number-of-seats.md | 2 +- .../reusables/dotcom_billing/upgrade_org.md | 2 +- .../enterprise-accounts/access-enterprise.md | 4 +- .../data/reusables/enterprise/rate_limit.md | 3 +- .../configuration-file-heading.md | 2 +- ...placing-a-cluster-node-replacement-name.md | 4 +- .../submit-support-ticket-first-section.md | 4 +- .../submit-support-ticket-second-section.md | 3 +- .../aws-supported-instance-types.md | 5 +- .../hardware-rec-table.md | 10 +- .../necessary_ports.md | 24 +- .../when-9418-necessary.md | 1 + .../packages-tab.md | 2 +- .../manage-global-webhooks-api.md | 2 +- .../files/commit-author-email-options.md | 3 +- .../reusables/gated-features/code-scanning.md | 1 + .../data/reusables/gated-features/packages.md | 3 +- .../github-actions/actions-billing.md | 2 +- .../github-actions/actions-on-examples.md | 10 +- .../github-actions/actions-unused-labels.md | 2 +- .../artifact-log-retention-statement.md | 2 + .../github-actions/branch-requirement.md | 2 +- ...nge-retention-period-for-artifacts-logs.md | 2 + .../disabled-actions-description.md | 2 +- .../docker-container-os-support.md | 2 +- .../github-actions/dockerfile-guidelines.md | 2 +- .../enabled-actions-description.md | 2 +- .../enabled-local-github-actions.md | 2 +- .../github-actions/expression-syntax-if.md | 2 +- .../github-actions/gradle-workflow-steps.md | 2 +- .../permissions-statement-secrets-api.md | 2 +- ...missions-statement-secrets-organization.md | 2 +- ...ermissions-statement-secrets-repository.md | 2 +- .../private-repository-forks-overview.md | 2 +- .../publish-to-maven-workflow-step.md | 2 +- .../publish-to-packages-workflow-step.md | 2 +- .../publishing-java-packages-intro.md | 2 +- .../github-actions/run_id_description.md | 2 +- .../github-actions/run_number_description.md | 2 +- ...ed-runner-configure-runner-group-access.md | 2 +- .../self-hosted-runner-list-group.md | 2 +- .../github-actions/self-hosted-runner-list.md | 2 +- ...elf-hosted-runner-navigate-repo-and-org.md | 2 +- .../self-hosted-runner-removal-impact.md | 2 +- .../self-hosted-runner-reusing.md | 2 +- .../github-actions/sidebar-secret.md | 2 +- .../github-actions/usage-api-requests.md | 1 + .../github-actions/usage-matrix-limits.md | 1 + .../github-actions/usage-workflow-run-time.md | 1 + .../github-insights/choose-key-metric.md | 2 +- .../navigate-to-key-metrics.md | 2 +- .../ru-RU/data/reusables/gpg/private-email.md | 3 +- .../enable-team-sync-azure.md | 2 +- .../enable-team-sync-okta.md | 2 +- .../supported-idps-team-sync.md | 2 +- .../sync-team-with-idp-group.md | 2 +- .../team-sync-disable.md | 2 +- .../team-sync-okta-requirements.md | 2 +- .../collaborator-user-limit-definition.md | 2 +- .../contributor-user-limit-definition.md | 2 +- .../existing-user-limit-definition.md | 2 +- .../interactions/interactions-detail.md | 2 +- .../issue-events/assignee-properties.md | 2 +- .../issue-event-common-properties.md | 2 +- .../issue-events/label-properties.md | 2 +- .../issue-events/project-card-properties.md | 2 +- .../review-dismissed-properties.md | 2 +- .../issue-events/review-request-properties.md | 2 +- .../timeline_events_object_properties.md | 2 +- .../can-include-lfs-objects-archives.md | 2 +- .../marketplace/cancellation-clarification.md | 2 +- .../marketplace/github_apps_preferred.md | 2 +- .../reusables/marketplace/launch-with-free.md | 2 +- .../reusables/marketplace/unverified-apps.md | 2 +- .../email-notification-caveats.md | 2 +- .../notifications-v2/manage-notifications.md | 2 +- .../organizations/can-require-ssh-cert.md | 2 +- .../organizations/organization-name.md | 2 +- .../organizations/repository-labels.md | 2 +- .../admins-can-configure-package-types.md | 2 +- .../package_registry/authenticate-packages.md | 6 +- ...uthenticate-to-container-registry-steps.md | 25 + ...nticate_with_pat_for_container_registry.md | 9 + .../docker_registry_deprecation_status.md | 5 + .../package_registry/package-immutability.md | 4 +- .../pages/best-with-supported-themes.md | 3 +- .../machine-man-preview.md | 2 +- .../suspend-installation-beta.md | 3 +- .../data/reusables/profile/profile-readme.md | 2 +- .../link-repos-to-project-board.md | 2 +- .../project-board-import-with-api.md | 2 +- .../reusables/projects/disabled-projects.md | 2 +- .../automatically-delete-branches.md | 2 - .../default-commit-message-squash-merge.md | 2 +- .../pull_requests/mark-ready-review.md | 2 +- .../reusables/reminders/author-reviews.md | 2 +- .../reusables/reminders/ignored-labels.md | 2 +- .../data/reusables/reminders/ignored-terms.md | 2 +- .../ru-RU/data/reusables/reminders/min-age.md | 2 +- .../data/reusables/reminders/min-staleness.md | 2 +- .../reusables/reminders/real-time-alerts.md | 2 +- .../reusables/reminders/required-labels.md | 2 +- .../about-github-archive-program.md | 2 +- .../actions-workflow-status-badge-into.md | 2 +- .../repositories/blocked-passwords.md | 3 +- .../reusables/repositories/copy-clone-url.md | 6 +- .../navigate-to-job-superlinter.md | 5 + .../navigate-to-workflow-superlinter.md | 1 + .../repositories/open-with-github-desktop.md | 4 +- .../permissions-statement-read.md | 2 +- .../permissions-statement-write.md | 2 +- .../security-alerts-x-github-severity.md | 2 +- .../repositories/select-marketplace-apps.md | 4 +- .../repositories/sidebar-dependabot-alerts.md | 2 +- .../view-failed-job-results-superlinter.md | 5 + .../repositories/view-run-superlinter.md | 1 + .../data/reusables/repositories/view-run.md | 2 +- .../view-specific-line-superlinter.md | 5 + .../reusables/saml/add-okta-application.md | 2 +- .../reusables/saml/assign-yourself-to-okta.md | 2 +- .../click-enterprise-account-application.md | 2 +- .../data/reusables/saml/okta-admin-button.md | 2 +- .../saml/okta-configure-api-integration.md | 2 +- .../reusables/saml/okta-edit-provisioning.md | 2 +- .../saml/okta-enable-api-integration.md | 2 +- .../reusables/saml/okta-provisioning-tab.md | 2 +- .../reusables/saml/okta-save-provisioning.md | 2 +- .../data/reusables/saml/okta-sign-on-tab.md | 2 +- .../saml/okta-view-setup-instructions.md | 2 +- .../data/reusables/saml/search-ghec-okta.md | 2 +- .../data/reusables/saml/use-classic-ui.md | 2 +- .../reusables/scim/enterprise-account-scim.md | 2 +- .../data/reusables/secret-scanning/beta.md | 2 +- ...-and-analysis-features-enable-read-only.md | 5 +- .../data/reusables/shortdesc/iso_8601.md | 2 +- .../reusables/sponsors/edit-featured-work.md | 2 +- .../data/reusables/sponsors/meet-the-team.md | 2 +- .../sponsors/navigate-to-your-goals-tab.md | 2 +- .../sponsors/opt-in-to-being-featured.md | 2 +- .../data/reusables/sponsors/publish-goal.md | 2 +- .../data/reusables/sponsors/retire-goal.md | 2 +- .../data/reusables/sponsors/save-profile.md | 2 +- .../data/reusables/sponsors/set-a-goal.md | 2 +- .../data/reusables/sponsors/short-bio.md | 2 +- .../sponsors/stripe-supported-regions.md | 2 +- .../you-can-be-a-sponsored-developer.md | 2 +- .../you-can-be-a-sponsored-organization.md | 2 +- .../ru-RU/data/reusables/ssh/dsa-support.md | 2 +- .../reusables/support/about-premium-plans.md | 20 +- .../support/ghec-premium-priorities.md | 10 +- .../data/reusables/support/ghes-priorities.md | 10 +- .../support/priority-urgent-english-only.md | 2 +- .../service-level-agreement-response-times.md | 4 +- .../ru-RU/data/reusables/two_fa/about-2fa.md | 1 + .../two_fa/after-2fa-add-security-key.md | 2 +- .../data/reusables/two_fa/auth_methods_2fa.md | 12 +- .../reusables/user_settings/export-data.md | 3 +- .../password-authentication-deprecation.md | 2 +- .../user_settings/sudo-mode-popup.md | 2 +- .../reusables/webhooks/action_type_desc.md | 2 +- .../ru-RU/data/reusables/webhooks/app_desc.md | 2 +- .../webhooks/check_run_properties.md | 18 +- .../webhooks/check_run_short_desc.md | 2 +- .../webhooks/check_suite_properties.md | 18 +- .../webhooks/check_suite_short_desc.md | 2 +- .../code_scanning_alert_event_short_desc.md | 2 +- .../webhooks/commit_comment_properties.md | 2 +- .../webhooks/commit_comment_short_desc.md | 2 +- .../webhooks/content_reference_short_desc.md | 2 +- .../reusables/webhooks/create_properties.md | 12 +- .../reusables/webhooks/create_short_desc.md | 2 +- .../reusables/webhooks/delete_properties.md | 8 +- .../reusables/webhooks/delete_short_desc.md | 2 +- .../webhooks/deploy_key_properties.md | 2 +- .../webhooks/deploy_key_short_desc.md | 2 +- .../webhooks/deployment_short_desc.md | 2 +- .../webhooks/deployment_status_short_desc.md | 2 +- .../webhooks/enterprise_short_desc.md | 2 +- .../reusables/webhooks/events_api_payload.md | 2 +- .../reusables/webhooks/fork_properties.md | 2 +- .../reusables/webhooks/fork_short_desc.md | 2 +- .../reusables/webhooks/gollum_properties.md | 2 +- .../reusables/webhooks/gollum_short_desc.md | 2 +- .../webhooks/installation_properties.md | 2 +- .../installation_repositories_properties.md | 2 +- .../installation_repositories_short_desc.md | 2 +- .../webhooks/installation_short_desc.md | 2 +- .../webhooks/issue_comment_properties.md | 2 +- .../webhooks/issue_comment_short_desc.md | 2 +- .../issue_comment_webhook_properties.md | 2 +- .../webhooks/issue_event_api_properties.md | 2 +- .../reusables/webhooks/issue_properties.md | 2 +- .../webhooks/issue_webhook_properties.md | 2 +- .../reusables/webhooks/issues_short_desc.md | 2 +- .../reusables/webhooks/label_short_desc.md | 2 +- .../webhooks/member_event_api_properties.md | 2 +- .../reusables/webhooks/member_properties.md | 2 +- .../reusables/webhooks/member_short_desc.md | 2 +- .../webhooks/member_webhook_properties.md | 2 +- .../webhooks/membership_properties.md | 2 +- .../webhooks/membership_short_desc.md | 2 +- .../webhooks/milestone_properties.md | 2 +- .../webhooks/milestone_short_desc.md | 2 +- .../webhooks/org_block_short_desc.md | 2 +- .../ru-RU/data/reusables/webhooks/org_desc.md | 2 +- .../webhooks/organization_short_desc.md | 2 +- .../reusables/webhooks/package_properties.md | 2 +- .../webhooks/page_build_short_desc.md | 2 +- .../data/reusables/webhooks/payload_url.md | 2 +- .../reusables/webhooks/ping_short_desc.md | 2 +- .../webhooks/project_card_properties.md | 2 +- .../webhooks/project_card_short_desc.md | 2 +- .../webhooks/project_column_properties.md | 2 +- .../webhooks/project_column_short_desc.md | 2 +- .../reusables/webhooks/project_properties.md | 2 +- .../reusables/webhooks/project_short_desc.md | 2 +- .../reusables/webhooks/public_short_desc.md | 2 +- .../pull_request_event_api_properties.md | 2 +- .../webhooks/pull_request_properties.md | 2 +- ...est_review_comment_event_api_properties.md | 2 +- .../pull_request_review_comment_properties.md | 2 +- .../pull_request_review_comment_short_desc.md | 2 +- ...quest_review_comment_webhook_properties.md | 2 +- .../pull_request_review_properties.md | 2 +- .../pull_request_review_short_desc.md | 2 +- .../webhooks/pull_request_short_desc.md | 2 +- .../pull_request_webhook_properties.md | 2 +- .../reusables/webhooks/push_short_desc.md | 2 +- .../webhooks/release_event_api_properties.md | 2 +- .../reusables/webhooks/release_properties.md | 2 +- .../reusables/webhooks/release_short_desc.md | 2 +- .../webhooks/release_webhook_properties.md | 6 +- .../data/reusables/webhooks/repo_desc.md | 2 +- .../webhooks/repository_import_properties.md | 2 +- .../webhooks/repository_import_short_desc.md | 2 +- .../webhooks/repository_short_desc.md | 2 +- ...pository_vulnerability_alert_properties.md | 2 +- ...pository_vulnerability_alert_short_desc.md | 2 +- .../ru-RU/data/reusables/webhooks/secret.md | 2 +- .../data/reusables/webhooks/sender_desc.md | 2 +- .../sponsorship_event_api_properties.md | 2 +- .../webhooks/sponsorship_properties.md | 2 +- .../webhooks/sponsorship_short_desc.md | 2 +- .../sponsorship_webhook_properties.md | 2 +- .../reusables/webhooks/star_properties.md | 8 +- .../reusables/webhooks/star_short_desc.md | 2 +- .../reusables/webhooks/status_short_desc.md | 2 +- .../reusables/webhooks/team_add_short_desc.md | 2 +- .../reusables/webhooks/team_short_desc.md | 2 +- .../reusables/webhooks/watch_properties.md | 2 +- .../reusables/webhooks/watch_short_desc.md | 2 +- .../data/reusables/webhooks/webhooks_ssl.md | 2 +- .../reusables/webhooks/workflow_run_desc.md | 2 +- translations/ru-RU/data/ui.yml | 2 +- .../ru-RU/data/variables/command_line.yml | 2 +- translations/ru-RU/data/variables/contact.yml | 1 - translations/ru-RU/data/variables/product.yml | 23 +- translations/ru-RU/data/variables/search.yml | 6 - .../actions/creating-actions/about-actions.md | 20 +- .../creating-a-composite-run-steps-action.md | 21 +- .../creating-a-docker-container-action.md | 2 +- .../creating-a-javascript-action.md | 50 +- .../dockerfile-support-for-github-actions.md | 2 +- .../content/actions/creating-actions/index.md | 1 + .../metadata-syntax-for-github-actions.md | 4 +- .../setting-exit-codes-for-actions.md | 2 +- .../guides/about-continuous-integration.md | 63 + .../about-packaging-with-github-actions.md | 47 + .../guides/about-service-containers.md | 117 ++ .../building-and-testing-java-with-ant.md | 109 ++ .../building-and-testing-java-with-gradle.md | 134 ++ .../building-and-testing-java-with-maven.md | 135 ++ .../guides/building-and-testing-nodejs.md | 276 ++++ .../guides/building-and-testing-python.md | 500 +++++++ ...hing-dependencies-to-speed-up-workflows.md | 192 +++ .../creating-postgresql-service-containers.md | 335 +++++ .../creating-redis-service-containers.md | 325 +++++ .../zh-CN/content/actions/guides/index.md | 60 + .../guides/publishing-docker-images.md | 158 ++ .../publishing-java-packages-with-gradle.md | 219 +++ .../publishing-java-packages-with-maven.md | 210 +++ .../guides/publishing-nodejs-packages.md | 210 +++ ...us-integration-using-workflow-templates.md | 43 + .../storing-workflow-data-as-artifacts.md | 249 ++++ .../about-self-hosted-runners.md | 9 + .../adding-self-hosted-runners.md | 5 +- ...and-troubleshooting-self-hosted-runners.md | 2 +- .../removing-self-hosted-runners.md | 5 +- ...using-self-hosted-runners-in-a-workflow.md | 2 +- translations/zh-CN/content/actions/index.md | 58 +- .../essential-features-of-github-actions.md | 95 ++ .../finding-and-customizing-actions.md | 156 ++ .../actions/learn-github-actions/index.md | 42 + .../introduction-to-github-actions.md | 225 +++ .../managing-complex-workflows.md | 151 ++ ...-from-azure-pipelines-to-github-actions.md | 327 +++++ ...grating-from-circleci-to-github-actions.md | 447 ++++++ ...ting-from-gitlab-cicd-to-github-actions.md | 476 +++++++ ...igrating-from-jenkins-to-github-actions.md | 293 ++++ .../security-hardening-for-github-actions.md | 97 ++ ...haring-workflows-with-your-organization.md | 114 ++ .../adding-a-workflow-status-badge.md | 63 + .../canceling-a-workflow.md | 31 + .../deleting-a-workflow-run.md | 23 + .../disabling-and-enabling-a-workflow.md | 45 + .../downloading-workflow-artifacts.md | 22 + .../enabling-debug-logging.md | 38 + .../actions/managing-workflow-runs/index.md | 32 + .../manually-running-a-workflow.md | 31 + .../re-running-a-workflow.md | 19 + .../removing-workflow-artifacts.md | 41 + .../using-workflow-run-logs.md | 86 ++ .../viewing-job-execution-time.md | 24 + .../viewing-workflow-run-history.md | 18 + .../zh-CN/content/actions/quickstart.md | 75 + .../reference/authentication-in-a-workflow.md | 100 ++ ...nd-expression-syntax-for-github-actions.md | 88 +- .../actions/reference/encrypted-secrets.md | 221 +++ .../reference/environment-variables.md | 69 + .../events-that-trigger-workflows.md | 224 +-- .../zh-CN/content/actions/reference/index.md | 40 +- ...pecifications-for-github-hosted-runners.md | 149 ++ ...usage-limits-billing-and-administration.md | 88 ++ .../workflow-commands-for-github-actions.md | 125 +- .../workflow-syntax-for-github-actions.md | 136 +- ...or-users-outside-your-identity-provider.md | 4 +- .../disabling-unauthenticated-sign-ups.md | 2 +- .../content/admin/authentication/using-cas.md | 4 +- .../admin/authentication/using-ldap.md | 28 +- .../admin/authentication/using-saml.md | 56 +- .../accessing-the-management-console.md | 4 +- .../configuration/command-line-utilities.md | 15 +- .../configuring-advanced-security-features.md | 10 +- .../configuration/configuring-applications.md | 4 +- .../configuring-built-in-firewall-rules.md | 2 +- ...guring-code-scanning-for-your-appliance.md | 58 +- .../configuring-network-settings.md | 2 +- .../configuration/configuring-rate-limits.md | 4 +- ...dress-using-the-virtual-machine-console.md | 8 + .../configuring-your-enterprise.md | 2 +- ...prise-server-to-github-enterprise-cloud.md | 6 +- ...ependencies-on-github-enterprise-server.md | 56 +- .../enabling-subdomain-isolation.md | 37 +- .../content/admin/configuration/index.md | 16 +- .../admin/configuration/network-ports.md | 24 +- .../configuration/site-admin-dashboard.md | 6 +- .../troubleshooting-ssl-errors.md | 2 +- .../enterprise-management/about-clustering.md | 2 +- .../about-geo-replication.md | 2 +- .../about-high-availability-configuration.md | 11 +- .../accessing-the-monitor-dashboard.md | 12 +- .../cluster-network-configuration.md | 5 +- .../configuring-clustering.md | 2 +- .../configuring-collectd.md | 2 +- ...-availability-replication-for-a-cluster.md | 182 +-- .../configuring-high-availability.md | 2 +- .../creating-a-high-availability-replica.md | 4 +- ...een-clustering-and-high-availability-ha.md | 2 +- .../increasing-cpu-or-memory-resources.md | 6 +- .../increasing-storage-capacity.md | 2 +- .../admin/enterprise-management/index.md | 15 +- .../initializing-the-cluster.md | 4 +- ...ting-a-failover-to-your-replica-cluster.md | 24 +- ...o-github-enterprise-server-214-or-later.md | 2 +- ...ng-from-github-enterprise-1110x-to-2123.md | 2 +- .../monitoring-cluster-nodes.md | 49 +- .../monitoring-your-appliance.md | 2 +- ...-virtual-machine-and-physical-resources.md | 2 +- .../upgrading-github-enterprise-server.md | 6 +- .../about-github-enterprise-support.md | 8 +- .../about-support-for-advanced-security.md | 12 +- ...com-actions-on-github-enterprise-server.md | 27 +- ...-githubcom-actions-using-github-connect.md | 16 +- ...-github-actions-and-configuring-storage.md | 30 +- ...ub-actions-policies-for-your-enterprise.md | 18 +- .../content/admin/github-actions/index.md | 4 +- ...naging-access-to-actions-from-githubcom.md | 9 +- ...manually-syncing-actions-from-githubcom.md | 48 +- ...-hosted-runners-without-internet-access.md | 36 +- translations/zh-CN/content/admin/index.md | 4 +- .../zh-CN/content/admin/installation/index.md | 4 +- ...erprise-server-on-google-cloud-platform.md | 3 +- ...thub-enterprise-server-on-openstack-kvm.md | 6 +- ...ling-github-enterprise-server-on-vmware.md | 6 +- .../overview/about-enterprise-accounts.md | 2 +- .../about-the-github-enterprise-server-api.md | 6 +- .../zh-CN/content/admin/overview/index.md | 2 +- .../managing-billing-for-github-enterprise.md | 2 +- ...managing-your-github-enterprise-license.md | 6 +- .../content/admin/overview/system-overview.md | 2 +- ...ng-packages-support-for-your-enterprise.md | 14 +- ...guring-third-party-storage-for-packages.md | 32 +- ...ing-github-packages-for-your-enterprise.md | 20 +- .../zh-CN/content/admin/packages/index.md | 8 +- ...creating-a-pre-receive-hook-environment.md | 2 +- .../creating-a-pre-receive-hook-script.md | 8 +- .../enforcing-policies-for-your-enterprise.md | 7 +- ...enforcing-policy-with-pre-receive-hooks.md | 2 +- ...-management-policies-in-your-enterprise.md | 115 +- .../zh-CN/content/admin/policies/index.md | 4 +- .../admin/user-management/audit-logging.md | 4 +- .../admin/user-management/audited-actions.md | 54 +- .../configuring-email-for-notifications.md | 2 +- ...-large-file-storage-for-your-enterprise.md | 6 +- .../admin/user-management/creating-teams.md | 14 +- ...tomizing-user-messages-on-your-instance.md | 12 +- ...exporting-migration-data-from-githubcom.md | 6 +- ...ing-migration-data-from-your-enterprise.md | 8 +- .../content/admin/user-management/index.md | 4 +- .../user-management/managing-dormant-users.md | 42 +- .../managing-global-webhooks.md | 6 +- ...naging-organizations-in-your-enterprise.md | 4 +- ...anaging-repositories-in-your-enterprise.md | 2 +- .../managing-users-in-your-enterprise.md | 2 +- ...rating-data-to-and-from-your-enterprise.md | 2 +- .../migrating-data-to-your-enterprise.md | 12 +- .../monitoring-activity-in-your-enterprise.md | 7 +- ...ring-to-migrate-data-to-your-enterprise.md | 8 +- ...moting-or-demoting-a-site-administrator.md | 6 +- .../rebuilding-contributions-data.md | 3 +- ...ving-users-from-teams-and-organizations.md | 2 +- ...ctor-authentication-for-an-organization.md | 4 +- .../searching-the-audit-log.md | 30 +- .../suspending-and-unsuspending-users.md | 2 +- .../troubleshooting-service-hooks.md | 4 +- ...epository-from-github-to-github-desktop.md | 8 +- ...orking-repositories-from-github-desktop.md | 8 +- ...g-and-reviewing-changes-to-your-project.md | 4 +- .../creating-an-issue-or-pull-request.md | 10 +- .../index.md | 2 +- .../syncing-your-branch.md | 16 +- ...iewing-a-pull-request-in-github-desktop.md | 10 +- .../authenticating-to-github.md | 8 +- ...figuring-and-customizing-github-desktop.md | 2 +- .../configuring-basic-settings.md | 2 +- .../configuring-git-for-github-desktop.md | 2 +- ...r-first-repository-using-github-desktop.md | 54 +- .../getting-started-with-github-desktop.md | 84 +- .../index.md | 4 +- .../keyboard-shortcuts.md | 116 +- .../setting-up-github-desktop.md | 42 +- .../supported-operating-systems.md | 66 +- .../apps/activating-beta-features-for-apps.md | 3 +- .../apps/authenticating-with-github-apps.md | 2 +- .../developers/apps/authorizing-oauth-apps.md | 176 +-- ...ting-a-custom-badge-for-your-github-app.md | 4 +- ...ating-a-custom-badge-for-your-oauth-app.md | 7 +- .../creating-a-github-app-from-a-manifest.md | 6 +- ...ating-a-github-app-using-url-parameters.md | 164 +-- .../creating-ci-tests-with-the-checks-api.md | 105 +- ...nces-between-github-apps-and-oauth-apps.md | 16 +- .../apps/editing-a-github-apps-permissions.md | 18 +- ...g-and-authorizing-users-for-github-apps.md | 209 ++- .../migrating-oauth-apps-to-github-apps.md | 1 - .../developers/apps/modifying-an-oauth-app.md | 6 +- ...refreshing-user-to-server-access-tokens.md | 6 +- .../developers/apps/scopes-for-oauth-apps.md | 100 +- ...ment-environment-to-create-a-github-app.md | 1 - .../suspending-a-github-app-installation.md | 10 +- .../apps/using-the-github-api-in-your-app.md | 1 - .../drafting-a-listing-for-your-app.md | 5 +- .../viewing-metrics-for-your-listing.md | 3 +- .../viewing-transactions-for-your-listing.md | 3 +- ...k-events-for-the-github-marketplace-api.md | 6 +- .../developers/overview/about-githubs-apis.md | 2 +- .../overview/managing-deploy-keys.md | 9 +- .../overview/replacing-github-services.md | 1 - .../overview/using-ssh-agent-forwarding.md | 2 +- .../webhooks-and-events/about-webhooks.md | 9 +- .../webhooks-and-events/github-event-types.md | 3 +- .../webhooks-and-events/issue-event-types.md | 1 - .../securing-your-webhooks.md | 27 +- .../webhooks-and-events/testing-webhooks.md | 1 - .../webhook-events-and-payloads.md | 91 +- .../about-branch-restrictions.md | 10 +- ...fications-for-pushes-to-your-repository.md | 5 +- ...about-github-dependabot-version-updates.md | 8 +- .../about-protected-branches.md | 4 +- .../about-releases.md | 12 +- .../about-required-commit-signing.md | 4 +- .../about-required-status-checks.md | 2 +- .../about-secret-scanning.md | 2 +- .../about-securing-your-repository.md | 42 +- ...for-release-forms-with-query-parameters.md | 2 +- .../changing-the-default-branch.md | 53 + ...classifying-your-repository-with-topics.md | 40 +- ...guration-options-for-dependency-updates.md | 88 +- ...tolinks-to-reference-external-resources.md | 2 +- .../configuring-protected-branches.md | 2 +- ...s-artifacts-and-logs-in-your-repository.md | 18 + ...zing-how-changed-files-appear-on-github.md | 2 +- ...g-your-repositorys-social-media-preview.md | 4 +- ...ining-the-mergeability-of-pull-requests.md | 2 +- ...nd-restoring-branches-in-a-pull-request.md | 5 +- ...imiting-github-actions-for-a-repository.md | 43 +- ...ing-a-sponsor-button-in-your-repository.md | 22 +- .../enabling-and-disabling-version-updates.md | 8 +- ...nymous-git-read-access-for-a-repository.md | 2 +- .../enabling-branch-restrictions.md | 4 +- ...ling-force-pushes-to-a-protected-branch.md | 23 +- .../administering-a-repository/index.md | 3 +- ...tions-up-to-date-with-github-dependabot.md | 2 +- ...-objects-in-archives-of-your-repository.md | 18 +- ...ng-pull-requests-for-dependency-updates.md | 4 +- .../managing-releases-in-a-repository.md | 13 +- .../managing-repository-settings.md | 2 +- ...d-analysis-settings-for-your-repository.md | 4 +- ...ging-the-automatic-deletion-of-branches.md | 2 +- ...-the-forking-policy-for-your-repository.md | 4 +- .../releasing-projects-on-github.md | 2 +- .../restoring-a-deleted-repository.md | 2 +- .../setting-repository-visibility.md | 20 +- .../transferring-a-repository.md | 8 +- ...deployment-activity-for-your-repository.md | 2 +- ...wing-your-repositorys-releases-and-tags.md | 2 +- .../about-authentication-to-github.md | 3 +- ...authentication-with-saml-single-sign-on.md | 2 +- .../about-commit-signature-verification.md | 7 +- .../authenticating-to-github/about-ssh.md | 7 +- .../about-two-factor-authentication.md | 6 +- ...-github-using-two-factor-authentication.md | 2 +- ...ng-a-new-ssh-key-to-your-github-account.md | 2 +- .../associating-an-email-with-your-gpg-key.md | 2 +- ...-token-for-use-with-saml-single-sign-on.md | 4 +- ...sh-key-for-use-with-saml-single-sign-on.md | 4 +- .../authorizing-oauth-apps.md | 20 +- .../checking-for-existing-gpg-keys.md | 2 +- .../checking-for-existing-ssh-keys.md | 5 +- ...t-and-tag-signature-verification-status.md | 4 +- ...-factor-authentication-recovery-methods.md | 4 +- .../configuring-two-factor-authentication.md | 38 +- ...onnecting-with-third-party-applications.md | 2 +- .../creating-a-personal-access-token.md | 6 +- .../creating-a-strong-password.md | 2 +- .../deleted-or-missing-ssh-keys.md | 2 +- ...uthentication-for-your-personal-account.md | 6 +- .../error-agent-admitted-failure-to-sign.md | 2 +- .../error-bad-file-number.md | 4 +- .../error-key-already-in-use.md | 2 +- .../error-permission-denied-publickey.md | 126 +- ...ission-to-userrepo-denied-to-other-user.md | 2 +- ...on-to-userrepo-denied-to-userother-repo.md | 4 +- .../error-ssh-add-illegal-option----k.md | 4 +- ...e-problem-verify-that-the-ca-cert-is-ok.md | 6 +- .../error-were-doing-an-ssh-key-audit.md | 2 +- .../generating-a-new-gpg-key.md | 6 +- ...-ssh-key-and-adding-it-to-the-ssh-agent.md | 2 +- .../github/authenticating-to-github/index.md | 2 +- .../managing-commit-signature-verification.md | 2 +- ...ccount-if-you-lose-your-2fa-credentials.md | 5 +- .../recovering-your-ssh-key-passphrase.md | 2 +- ...moving-sensitive-data-from-a-repository.md | 10 +- ...wing-your-authorized-applications-oauth.md | 2 +- .../reviewing-your-security-log.md | 363 ++--- .../reviewing-your-ssh-keys.md | 62 +- .../signing-commits.md | 5 +- .../authenticating-to-github/signing-tags.md | 2 +- .../telling-git-about-your-signing-key.md | 2 +- ...updating-your-github-access-credentials.md | 6 +- .../working-with-ssh-key-passphrases.md | 5 +- .../about-issue-and-pull-request-templates.md | 6 +- .../about-team-discussions.md | 6 +- .../about-wikis.md | 2 +- ...dding-a-code-of-conduct-to-your-project.md | 2 +- .../adding-a-license-to-a-repository.md | 2 +- .../adding-or-editing-wiki-pages.md | 2 +- ...dding-support-resources-to-your-project.md | 2 +- ...cking-a-user-from-your-personal-account.md | 4 +- .../collaborating-with-your-team.md | 2 +- ...ing-issue-templates-for-your-repository.md | 2 +- ...reating-a-default-community-health-file.md | 30 +- ...ll-request-template-for-your-repository.md | 4 +- .../creating-a-team-discussion.md | 4 +- .../documenting-your-project-with-wikis.md | 2 +- .../editing-or-deleting-a-team-discussion.md | 4 +- .../editing-wiki-content.md | 4 +- .../building-a-strong-community/index.md | 2 +- ...iting-interactions-in-your-organization.md | 2 +- ...imiting-interactions-in-your-repository.md | 2 +- .../locking-conversations.md | 42 +- .../managing-disruptive-comments.md | 83 +- ...ontent-in-your-organizations-repository.md | 2 +- ...ngle-issue-template-for-your-repository.md | 2 +- .../moderating-comments-and-conversations.md | 2 +- .../pinning-a-team-discussion.md | 2 +- .../reporting-abuse-or-spam.md | 10 +- ...-guidelines-for-repository-contributors.md | 4 +- ...-your-project-for-healthy-contributions.md | 2 +- .../tracking-changes-in-a-comment.md | 2 +- ...nblocking-a-user-from-your-organization.md | 2 +- .../viewing-a-wikis-history-of-changes.md | 2 +- ...-who-are-blocked-from-your-organization.md | 2 +- .../about-branches.md | 26 +- ...out-comparing-branches-in-pull-requests.md | 4 +- .../about-conversations-on-github.md | 2 +- .../about-forks.md | 6 +- .../about-merge-conflicts.md | 2 +- .../about-pull-request-reviews.md | 6 +- .../about-pull-requests.md | 2 +- .../about-status-checks.md | 2 +- .../addressing-merge-conflicts.md | 2 +- ...pull-request-branch-created-from-a-fork.md | 2 +- ...ng-a-pull-request-with-required-reviews.md | 2 +- ...nging-the-base-branch-of-a-pull-request.md | 2 +- .../changing-the-stage-of-a-pull-request.md | 2 +- .../checking-out-pull-requests-locally.md | 4 +- ...repositories-with-code-quality-features.md | 4 +- .../commenting-on-a-pull-request.md | 4 +- ...pull-request-branch-created-from-a-fork.md | 6 +- .../creating-a-pull-request.md | 6 +- ...eleting-branches-within-your-repository.md | 4 +- .../dismissing-a-pull-request-review.md | 6 +- .../filtering-files-in-a-pull-request.md | 6 +- ...methods-and-functions-in-a-pull-request.md | 2 +- .../github-flow.md | 2 +- ...rporating-feedback-in-your-pull-request.md | 2 +- .../merging-a-pull-request.md | 10 +- ...g-an-upstream-repository-into-your-fork.md | 8 +- ...changes-to-your-work-with-pull-requests.md | 2 +- .../requesting-a-pull-request-review.md | 4 +- .../resolving-a-merge-conflict-on-github.md | 60 +- ...a-merge-conflict-using-the-command-line.md | 4 +- .../reviewing-changes-in-pull-requests.md | 2 +- ...wing-proposed-changes-in-a-pull-request.md | 6 +- .../working-with-pre-receive-hooks.md | 2 +- .../changing-a-commit-message.md | 17 +- .../commit-branch-and-tag-labels.md | 2 +- .../comparing-commits.md | 4 +- ...creating-a-commit-with-multiple-authors.md | 61 +- .../about-archiving-repositories.md | 4 +- .../about-code-owners.md | 11 +- .../about-readmes.md | 6 +- .../about-repositories.md | 3 +- .../about-repository-languages.md | 3 +- .../about-repository-visibility.md | 23 +- .../backing-up-a-repository.md | 41 +- .../cloning-a-repository-from-github.md | 2 +- .../cloning-a-repository.md | 14 +- .../creating-a-new-repository.md | 15 +- .../creating-a-repository-from-a-template.md | 6 +- .../creating-a-template-repository.md | 15 +- .../duplicating-a-repository.md | 2 +- ...s-to-nonexistent-ref-unable-to-checkout.md | 5 +- .../error-repository-not-found.md | 4 +- .../https-cloning-errors.md | 2 +- .../index.md | 2 +- .../licensing-a-repository.md | 7 +- .../about-billing-for-codespaces.md | 27 + .../about-codespaces.md | 6 +- ...configuring-codespaces-for-your-project.md | 14 +- .../creating-a-codespace.md | 2 +- .../developing-in-a-codespace.md | 24 +- .../index.md | 4 +- ...rsonalizing-codespaces-for-your-account.md | 2 +- .../using-codespaces-in-visual-studio-code.md | 45 + .../using-codespaces-in-visual-studio.md | 53 + .../getting-started-with-the-api.md | 2 +- .../git-automation-with-oauth-tokens.md | 4 +- .../about-code-scanning.md | 2 +- .../about-integration-with-code-scanning.md | 20 +- ...our-code-for-vulnerabilities-and-errors.md | 1 + .../configuring-code-scanning.md | 194 ++- ...-codeql-code-scanning-in-your-ci-system.md | 166 +++ ...-codeql-workflow-for-compiled-languages.md | 116 ++ ...enabling-code-scanning-for-a-repository.md | 88 +- .../index.md | 14 +- .../integrating-with-code-scanning.md | 7 +- ...ode-scanning-alerts-for-your-repository.md | 63 + ...-codeql-code-scanning-in-your-ci-system.md | 161 +++ .../sarif-support-for-code-scanning.md | 183 +-- ...g-code-scanning-alerts-in-pull-requests.md | 48 + ...-codeql-code-scanning-in-your-ci-system.md | 52 + .../troubleshooting-the-codeql-workflow.md | 125 ++ .../uploading-a-sarif-file-to-github.md | 28 +- ...e-scanning-with-your-existing-ci-system.md | 11 + .../access-permissions-on-github.md | 4 +- .../getting-started-with-github/be-social.md | 2 +- .../create-a-repo.md | 6 +- ...ly-access-releases-with-feature-preview.md | 2 +- .../faq-about-changes-to-githubs-plans.md | 8 +- .../following-people.md | 4 +- .../fork-a-repo.md | 16 +- .../git-and-github-learning-resources.md | 2 +- .../getting-started-with-github/github-cli.md | 14 +- .../github-desktop.md | 2 +- .../github-for-mobile.md | 16 +- .../githubs-products.md | 12 +- .../keyboard-shortcuts.md | 96 +- .../saving-repositories-with-stars.md | 7 +- .../getting-started-with-github/set-up-git.md | 4 +- ...-up-a-trial-of-github-enterprise-server.md | 4 +- .../signing-up-for-a-new-github-account.md | 2 +- .../supported-browsers.md | 2 +- .../types-of-github-accounts.md | 11 +- .../verifying-your-email-address.md | 2 +- .../about-github-importer.md | 2 +- ...roject-to-github-using-the-command-line.md | 15 +- ...a-git-repository-using-the-command-line.md | 2 +- ...rting-a-repository-with-github-importer.md | 2 +- .../importing-source-code-to-github.md | 2 +- .../support-for-subversion-clients.md | 2 +- ...author-attribution-with-github-importer.md | 2 +- ...-differences-between-subversion-and-git.md | 6 +- translations/zh-CN/content/github/index.md | 2 +- .../3d-file-viewer.md | 2 +- ...-to-a-repository-using-the-command-line.md | 4 +- .../deleting-files.md | 2 +- .../getting-permanent-links-to-files.md | 10 +- .../managing-files-using-the-command-line.md | 2 +- .../mapping-geojson-files-on-github.md | 2 +- .../moving-a-file-to-a-new-location.md | 4 +- .../navigating-code-on-github.md | 4 +- .../renaming-a-file.md | 2 +- ...endering-differences-in-prose-documents.md | 4 +- ...g-with-jupyter-notebook-files-on-github.md | 4 +- .../about-git-large-file-storage.md | 11 +- .../about-storage-and-bandwidth-usage.md | 5 +- ...llaboration-with-git-large-file-storage.md | 2 +- .../conditions-for-large-files.md | 2 +- .../configuring-git-large-file-storage.md | 4 +- .../distributing-large-binaries.md | 2 +- .../installing-git-large-file-storage.md | 3 +- ...oving-files-from-git-large-file-storage.md | 40 +- .../working-with-large-files.md | 2 +- ...bout-alerts-for-vulnerable-dependencies.md | 6 +- .../about-github-security-advisories.md | 4 +- ...ng-a-security-policy-to-your-repository.md | 2 +- ...ilities-in-the-github-advisory-database.md | 8 +- ...ring-github-dependabot-security-updates.md | 26 +- .../creating-a-security-advisory.md | 2 +- .../editing-a-security-advisory.md | 2 +- ...ecurity-vulnerabilities-in-your-project.md | 2 +- ...abilities-in-your-projects-dependencies.md | 2 +- .../publishing-a-security-advisory.md | 22 +- ...a-collaborator-from-a-security-advisory.md | 2 +- ...he-detection-of-vulnerable-dependencies.md | 98 +- ...nerable-dependencies-in-your-repository.md | 6 +- .../about-notifications.md | 7 +- .../configuring-notifications.md | 198 +-- ...orkflow-for-triaging-your-notifications.md | 26 +- .../managing-notifications-from-your-inbox.md | 37 +- ...ng-subscriptions-for-activity-on-github.md | 2 +- .../managing-your-subscriptions.md | 22 +- .../setting-up-notifications.md | 2 +- .../triaging-a-single-notification.md | 16 +- .../viewing-and-triaging-notifications.md | 2 +- .../viewing-your-subscriptions.md | 10 +- ...and-pull-requests-with-query-parameters.md | 18 +- .../about-automation-for-project-boards.md | 2 +- .../about-issues.md | 10 +- .../about-labels.md | 22 +- .../about-project-boards.md | 2 +- ...es-and-pull-requests-to-a-project-board.md | 11 +- ...ying-labels-to-issues-and-pull-requests.md | 7 +- .../archiving-cards-on-a-project-board.md | 2 +- ...and-pull-requests-to-other-github-users.md | 2 +- .../changing-project-board-visibility.md | 2 +- .../closing-a-project-board.md | 4 +- .../creating-a-label.md | 4 +- .../creating-a-project-board.md | 12 +- .../creating-an-issue.md | 4 +- .../deleting-a-label.md | 4 +- .../disabling-issues.md | 3 +- .../editing-a-label.md | 4 +- ...attachments-on-issues-and-pull-requests.md | 29 +- .../filtering-cards-on-a-project-board.md | 8 +- ...g-issues-and-pull-requests-by-milestone.md | 2 +- .../finding-information-in-a-repository.md | 2 +- .../linking-a-pull-request-to-an-issue.md | 22 +- ...linking-a-repository-to-a-project-board.md | 2 +- .../opening-an-issue-from-code.md | 2 +- .../sharing-filters.md | 2 +- ...tracking-progress-on-your-project-board.md | 2 +- ...sferring-an-issue-to-another-repository.md | 6 +- ...arch-to-filter-issues-and-pull-requests.md | 4 +- ...ng-all-of-your-issues-and-pull-requests.md | 4 +- .../viewing-your-milestones-progress.md | 2 +- .../about-email-notifications.md | 20 +- .../about-notifications.md | 5 +- .../about-web-notifications.md | 4 +- ...-delivery-method-for-your-notifications.md | 2 +- ...s-and-pull-requests-youre-subscribed-to.md | 4 +- .../managing-your-notifications.md | 2 +- .../marking-notifications-as-read.md | 2 +- .../saving-notifications-for-later.md | 2 +- ...to-and-unsubscribing-from-notifications.md | 13 +- .../watching-and-unwatching-repositories.md | 10 +- ...atching-and-unwatching-team-discussions.md | 12 +- .../about-searching-on-github.md | 6 +- .../searching-code.md | 2 +- .../searching-for-packages.md | 9 +- .../searching-issues-and-pull-requests.md | 30 +- .../sorting-search-results.md | 16 +- .../understanding-the-search-syntax.md | 8 +- .../about-billing-for-github-actions.md | 18 +- .../about-billing-for-github-packages.md | 6 +- ...organizations-for-procurement-companies.md | 2 +- .../about-per-user-pricing.md | 2 +- ...unted-subscriptions-for-github-accounts.md | 2 +- .../downgrading-your-github-subscription.md | 14 +- ...-downgrading-affect-the-billing-process.md | 2 +- .../managing-your-github-billing-settings.md | 2 +- ...-your-spending-limit-for-github-actions.md | 8 +- ...your-spending-limit-for-github-packages.md | 8 +- ...renewing-your-clients-paid-organization.md | 2 +- .../setting-your-billing-email.md | 28 +- ...ngrading-your-clients-paid-organization.md | 2 +- .../upgrading-your-github-subscription.md | 4 +- .../viewing-your-github-actions-usage.md | 12 +- .../viewing-your-github-packages-usage.md | 8 +- ...ing-your-subscriptions-and-billing-date.md | 2 +- .../about-organizations.md | 1 - .../about-ssh-certificate-authorities.md | 6 +- .../about-teams.md | 2 +- .../about-your-organization-dashboard.md | 4 +- .../about-your-organizations-news-feed.md | 4 +- ...f-your-identity-provider-is-unavailable.md | 2 +- .../accessing-your-organizations-settings.md | 2 +- ...to-a-project-board-in-your-organization.md | 6 +- ...ithub-app-managers-in-your-organization.md | 4 +- .../adding-organization-members-to-a-team.md | 13 +- .../adding-people-to-your-organization.md | 2 +- ...-accounts-for-people-in-my-organization.md | 2 +- ...saml-single-sign-on-and-scim-using-okta.md | 4 +- ...artifacts-and-logs-in-your-organization.md | 16 + ...am-to-improved-organization-permissions.md | 2 +- .../converting-an-organization-into-a-user.md | 2 +- ...ation-member-to-an-outside-collaborator.md | 4 +- ...-collaborator-to-an-organization-member.md | 19 +- ...am-to-improved-organization-permissions.md | 2 +- ...reating-a-new-organization-from-scratch.md | 2 +- .../deleting-an-organization-account.md | 2 +- ...ng-github-actions-for-your-organization.md | 46 +- ...ithub-pages-sites-for-your-organization.md | 10 +- ...cess-restrictions-for-your-organization.md | 4 +- ...r-permissions-to-an-organization-member.md | 2 +- ...r-organization-with-saml-single-sign-on.md | 2 +- .../index.md | 2 +- ...ra-with-your-organization-project-board.md | 2 +- ...nviting-users-to-join-your-organization.md | 6 +- .../keeping-your-organization-secure.md | 2 +- ...-project-board-for-organization-members.md | 2 +- ...ss-to-your-organizations-project-boards.md | 2 +- ...owed-ip-addresses-for-your-organization.md | 2 +- ...access-to-an-organization-project-board.md | 6 +- ...ls-access-to-an-organization-repository.md | 2 +- ...cess-to-your-organizations-repositories.md | 2 +- ...anaging-membership-in-your-organization.md | 2 +- .../managing-organization-settings.md | 2 +- ...-access-to-your-organization-with-roles.md | 2 +- ...access-to-an-organization-project-board.md | 2 +- ...am-access-to-an-organization-repository.md | 2 +- ...e-for-repositories-in-your-organization.md | 21 +- ...ay-of-member-names-in-your-organization.md | 2 +- ...he-forking-policy-for-your-organization.md | 6 +- ...ganizations-ssh-certificate-authorities.md | 2 +- ...ms-to-improved-organization-permissions.md | 2 +- ...ng-to-improved-organization-permissions.md | 2 +- ...-a-team-in-your-organizations-hierarchy.md | 4 +- .../permission-levels-for-an-organization.md | 175 +-- ...aml-single-sign-on-in-your-organization.md | 2 +- ...tor-authentication-in-your-organization.md | 4 +- ...t-board-permissions-for-an-organization.md | 2 +- ...ng-a-former-member-of-your-organization.md | 8 +- ...llaborators-access-to-your-organization.md | 52 +- ...-billing-manager-from-your-organization.md | 2 +- ...emoving-a-member-from-your-organization.md | 2 +- ...ator-from-an-organization-project-board.md | 2 +- ...hub-app-managers-from-your-organization.md | 4 +- ...moving-organization-members-from-a-team.md | 2 +- .../renaming-a-team.md | 2 +- .../renaming-an-organization.md | 4 +- ...y-permission-levels-for-an-organization.md | 206 +-- .../requesting-to-add-a-child-team.md | 2 +- ...questing-to-add-or-change-a-parent-team.md | 2 +- ...tor-authentication-in-your-organization.md | 28 +- ...ail-notifications-to-an-approved-domain.md | 2 +- ...epository-creation-in-your-organization.md | 10 +- ...visibility-changes-in-your-organization.md | 4 +- ...ing-the-audit-log-for-your-organization.md | 8 +- ...ur-organizations-installed-integrations.md | 19 +- ...ng-base-permissions-for-an-organization.md | 2 +- ...ssions-for-adding-outside-collaborators.md | 13 +- ...r-deleting-or-transferring-repositories.md | 2 +- .../setting-your-teams-profile-picture.md | 2 +- .../transferring-organization-ownership.md | 2 +- ...ading-to-the-corporate-terms-of-service.md | 4 +- ...embers-saml-access-to-your-organization.md | 2 +- .../viewing-insights-for-your-organization.md | 4 +- ...s-in-your-organization-have-2fa-enabled.md | 4 +- .../about-enterprise-accounts.md | 4 +- ...rganizations-to-your-enterprise-account.md | 2 +- ...cts-and-logs-in-your-enterprise-account.md | 19 + ...ncy-insights-in-your-enterprise-account.md | 2 +- ...ons-policies-in-your-enterprise-account.md | 19 +- ...ard-policies-in-your-enterprise-account.md | 2 +- ...ent-policies-in-your-enterprise-account.md | 12 +- ...ity-settings-in-your-enterprise-account.md | 6 +- ...eam-policies-in-your-enterprise-account.md | 2 +- .../index.md | 2 + ...dio-subscription-with-github-enterprise.md | 42 + .../roles-for-an-enterprise-account.md | 2 +- ...-saml-access-to-your-enterprise-account.md | 2 +- ...ewing-people-in-your-enterprise-account.md | 6 +- ...n-and-usage-for-your-enterprise-account.md | 4 +- .../about-your-organizations-profile.md | 2 +- .../about-your-profile.md | 8 +- ...ing-contribution-graphs-on-your-profile.md | 2 +- .../managing-your-profile-readme.md | 58 +- .../personalizing-your-profile.md | 16 +- .../pinning-items-to-your-profile.md | 4 +- ...roubleshooting-commits-on-your-timeline.md | 2 +- .../viewing-contributions-on-your-profile.md | 2 +- ...tributions-not-showing-up-on-my-profile.md | 8 +- .../about-your-personal-dashboard.md | 4 +- .../accessing-an-organization.md | 2 +- ...best-practices-for-leaving-your-company.md | 2 +- ...that-expose-your-personal-email-address.md | 2 +- .../changing-your-github-username.md | 58 +- .../changing-your-primary-email-address.md | 11 +- .../converting-a-user-into-an-organization.md | 6 +- .../deleting-your-user-account.md | 6 +- ...rating-jira-with-your-personal-projects.md | 2 +- ...-collaborators-to-a-personal-repository.md | 4 +- ...ss-to-your-user-accounts-project-boards.md | 6 +- ...analysis-settings-for-your-user-account.md | 12 +- ...fault-branch-name-for-your-repositories.md | 18 +- .../managing-user-account-settings.md | 2 +- ...naging-your-membership-in-organizations.md | 2 +- .../merging-multiple-user-accounts.md | 2 +- ...on-levels-for-a-user-account-repository.md | 91 +- ...on-levels-for-user-owned-project-boards.md | 2 +- ...izing-or-hiding-organization-membership.md | 2 +- ...membering-your-github-username-or-email.md | 2 +- ...collaborator-from-a-personal-repository.md | 4 +- ...ourself-from-a-collaborators-repository.md | 2 +- .../removing-yourself-from-an-organization.md | 2 +- .../setting-your-commit-email-address.md | 6 +- ...does-the-available-for-hire-checkbox-do.md | 2 +- ...plicable-to-us-federal-government-users.md | 12 +- .../site-policy/dmca-takedown-policy.md | 8 +- .../github-acceptable-use-policies.md | 4 +- .../github-additional-product-terms.md | 10 +- .../site-policy/github-and-trade-controls.md | 30 +- .../github-anti-bribery-statement.md | 6 +- .../github-community-forum-code-of-conduct.md | 2 +- .../github-corporate-terms-of-service.md | 14 +- .../github-data-protection-addendum.md | 234 +-- ...b-enterprise-cloud-evaluation-agreement.md | 2 +- ...hub-enterprise-server-license-agreement.md | 10 +- ...thub-enterprise-service-level-agreement.md | 30 +- ...ithub-enterprise-subscription-agreement.md | 24 +- .../github-gifts-and-entertainment-policy.md | 8 +- .../github-gpl-cooperation-commitment.md | 2 +- ...d-data-protection-for-your-organization.md | 40 +- .../github-marketplace-developer-agreement.md | 20 +- .../github-marketplace-terms-of-service.md | 2 +- .../site-policy/github-pre-release-program.md | 4 +- .../site-policy/github-privacy-statement.md | 86 +- .../github-registered-developer-agreement.md | 6 +- .../github-research-program-terms.md | 4 +- .../github-sensitive-data-removal-policy.md | 2 +- .../github-sponsors-additional-terms.md | 54 +- ...-against-modern-slavery-and-child-labor.md | 2 +- .../github-subprocessors-and-cookies.md | 144 +- ...al-terms-for-microsoft-volume-licensing.md | 104 +- .../site-policy/github-terms-of-service.md | 4 +- ...out-the-california-consumer-privacy-act.md | 4 +- .../site-policy/global-privacy-practices.md | 24 +- ...ide-to-submitting-a-dmca-counter-notice.md | 6 +- ...de-to-submitting-a-dmca-takedown-notice.md | 4 +- ...delines-for-legal-requests-of-user-data.md | 6 +- ...b-sponsors-for-open-source-contributors.md | 10 +- .../about-github-sponsors.md | 12 +- .../changing-your-sponsorship-tiers.md | 2 +- ...ks-for-events-in-your-sponsored-account.md | 4 +- .../contacting-your-sponsors.md | 2 +- ...our-profile-details-for-github-sponsors.md | 2 +- .../index.md | 2 +- .../managing-your-sponsorship.md | 2 +- ...ng-sponsorships-through-github-sponsors.md | 2 +- ...p-github-sponsors-for-your-organization.md | 8 +- ...p-github-sponsors-for-your-user-account.md | 4 +- .../sponsoring-an-open-source-contributor.md | 14 +- .../tax-information-for-github-sponsors.md | 2 +- .../viewing-your-sponsors-and-sponsorships.md | 4 +- ...-for-an-educator-or-researcher-discount.md | 6 +- ...se-settings-for-your-private-repository.md | 4 +- .../using-git/about-git-subtree-merges.md | 16 +- .../using-git/about-remote-repositories.md | 2 +- .../github/using-git/adding-a-remote.md | 2 +- .../using-git/changing-a-remotes-url.md | 2 +- .../configuring-git-to-handle-line-endings.md | 2 +- .../dealing-with-non-fast-forward-errors.md | 7 +- ...etting-changes-from-a-remote-repository.md | 4 +- .../pushing-commits-to-a-remote-repository.md | 6 +- .../github/using-git/removing-a-remote.md | 2 +- .../github/using-git/renaming-a-remote.md | 2 +- ...ving-merge-conflicts-after-a-git-rebase.md | 2 +- ...g-a-subfolder-out-into-a-new-repository.md | 2 +- ...ing-credentials-from-the-macos-keychain.md | 2 +- .../which-remote-url-should-i-use.md | 12 +- ...hy-is-git-always-asking-for-my-password.md | 2 +- .../about-repository-graphs.md | 2 +- .../about-the-dependency-graph.md | 3 +- .../accessing-basic-repository-data.md | 2 +- ...lyzing-changes-to-a-repositorys-content.md | 2 +- ...loring-the-dependencies-of-a-repository.md | 31 +- ...anding-connections-between-repositories.md | 2 +- .../viewing-a-projects-contributors.md | 6 +- .../viewing-a-repositorys-network.md | 2 +- .../viewing-traffic-to-a-repository.md | 15 +- .../about-github-pages-and-jekyll.md | 5 +- .../about-github-pages.md | 32 +- ...yll-build-errors-for-github-pages-sites.md | 4 +- ...-to-your-github-pages-site-using-jekyll.md | 6 +- ...ithub-pages-site-with-the-theme-chooser.md | 2 +- ...shing-source-for-your-github-pages-site.md | 18 +- ...reating-a-github-pages-site-with-jekyll.md | 47 +- .../creating-a-github-pages-site.md | 4 +- ...ustom-domain-for-your-github-pages-site.md | 3 +- ...yll-build-errors-for-github-pages-sites.md | 150 +- .../unpublishing-a-github-pages-site.md | 12 +- ...ium-support-for-github-enterprise-cloud.md | 2 +- .../about-github-support.md | 14 +- .../autolinked-references-and-urls.md | 7 +- .../basic-writing-and-formatting-syntax.md | 7 +- .../creating-a-saved-reply.md | 2 +- .../writing-on-github/creating-gists.md | 11 +- .../deleting-a-saved-reply.md | 2 +- .../forking-and-cloning-gists.md | 2 +- ...d-with-writing-and-formatting-on-github.md | 2 +- .../organizing-information-with-tables.md | 2 +- .../writing-on-github/using-saved-replies.md | 2 +- .../working-with-advanced-formatting.md | 2 +- .../working-with-saved-replies.md | 2 +- .../guides/forming-calls-with-graphql.md | 2 +- .../zh-CN/content/graphql/guides/index.md | 2 +- .../guides/managing-enterprise-accounts.md | 4 +- .../content/graphql/overview/changelog.md | 2 +- translations/zh-CN/content/index.md | 4 +- ...n-github-enterprise-and-github-insights.md | 2 +- .../about-github-insights.md | 2 +- ...n-github-insights-and-github-enterprise.md | 4 +- ...n-github-insights-and-github-enterprise.md | 9 +- .../installing-github-insights.md | 3 +- .../managing-organizations.md | 2 +- ...managing-permissions-in-github-insights.md | 2 +- .../about-github-container-registry.md | 34 +- ...-concepts-for-github-container-registry.md | 18 +- ...ontainer-registry-for-your-organization.md | 14 +- .../index.md | 6 +- ...ub-container-registry-for-docker-images.md | 62 +- ...rol-and-visibility-for-container-images.md | 58 +- ...cting-a-repository-to-a-container-image.md | 32 +- .../deleting-a-container-image.md | 20 +- .../index.md | 4 +- .../pushing-and-pulling-docker-images.md | 52 +- .../about-github-packages.md | 86 +- .../deleting-a-package.md | 3 +- .../installing-a-package.md | 2 +- .../publishing-a-package.md | 7 +- .../viewing-packages.md | 6 +- ...ache-maven-for-use-with-github-packages.md | 60 +- ...ing-docker-for-use-with-github-packages.md | 72 +- ...dotnet-cli-for-use-with-github-packages.md | 94 +- ...ing-gradle-for-use-with-github-packages.md | 92 +- ...guring-npm-for-use-with-github-packages.md | 120 +- ...ing-github-packages-with-github-actions.md | 32 +- .../rest/guides/basics-of-authentication.md | 16 +- .../guides/best-practices-for-integrators.md | 1 - .../rest/guides/delivering-deployments.md | 2 +- .../getting-started-with-the-checks-api.md | 6 +- ...tting-started-with-the-git-database-api.md | 6 +- .../getting-started-with-the-rest-api.md | 9 +- .../zh-CN/content/rest/guides/index.md | 2 +- .../rest/guides/working-with-comments.md | 2 +- .../content/rest/overview/api-previews.md | 30 +- .../endpoints-available-for-github-apps.md | 2 +- .../overview/other-authentication-methods.md | 7 +- .../overview/resources-in-the-rest-api.md | 4 +- .../zh-CN/content/rest/reference/actions.md | 14 +- .../zh-CN/content/rest/reference/activity.md | 24 +- .../zh-CN/content/rest/reference/apps.md | 2 - .../content/rest/reference/code-scanning.md | 14 + .../rest/reference/enterprise-admin.md | 21 +- .../content/rest/reference/interactions.md | 6 +- .../zh-CN/content/rest/reference/licenses.md | 4 +- .../permissions-required-for-github-apps.md | 111 +- .../zh-CN/content/rest/reference/repos.md | 8 +- .../zh-CN/data/glossaries/external.yml | 6 +- .../zh-CN/data/glossaries/internal.yml | 2 +- ...hql_upcoming_changes.public-enterprise.yml | 16 +- .../zh-CN/data/graphql/graphql_previews.yml | 51 - .../graphql_upcoming_changes.public.yml | 20 +- translations/zh-CN/data/products.yml | 11 +- .../actions/about-artifact-log-retention.md | 6 + .../data/reusables/actions/about-artifacts.md | 2 +- .../data/reusables/actions/about-secrets.md | 2 +- .../actions/about-self-hosted-runners.md | 2 +- .../reusables/actions/about-workflow-jobs.md | 2 +- .../reusables/actions/about-workflow-runs.md | 2 +- .../data/reusables/actions/about-workflows.md | 2 +- .../actions-app-actions-permissions-api.md | 2 +- .../actions/actions-authentication.md | 2 +- .../reusables/actions/actions-not-verified.md | 2 +- .../actions/actions-use-policy-settings.md | 3 + .../actions/allow-specific-actions-intro.md | 19 + .../actions/enterprise-actions-permissions.md | 2 +- .../data/reusables/actions/enterprise-beta.md | 4 +- .../enterprise-github-hosted-runners.md | 4 +- .../actions/enterprise-marketplace-actions.md | 2 +- .../actions/enterprise-no-internet-actions.md | 2 +- .../actions/enterprise-setup-prereq.md | 4 +- .../reusables/actions/registry-credentials.md | 1 + .../actions/scheduled-workflows-disabled.md | 1 + .../apps/accept_new_permissions_steps.md | 4 +- .../apps/api-rate-limits-non-ghec.md | 2 +- .../data/reusables/apps/app-ruby-guides.md | 2 +- .../data/reusables/apps/app_manager_role.md | 2 +- .../reusables/apps/beta_feature_activation.md | 4 +- .../reusables/apps/checks-availability.md | 2 +- .../data/reusables/apps/deletes_ssh_keys.md | 2 +- .../deprecating_auth_with_query_parameters.md | 4 +- .../apps/deprecating_password_auth.md | 4 +- .../deprecating_token_oauth_authorizations.md | 16 +- .../expiring_user_authorization_tokens.md | 2 +- .../apps/general-apps-restrictions.md | 2 +- .../apps/marketplace_revenue_share.md | 2 +- .../apps/maximum-github-apps-allowed.md | 2 +- .../apps/maximum-oauth-apps-allowed.md | 2 +- .../reusables/apps/metadata-permissions.md | 2 +- .../reusables/apps/oauth-apps-restrictions.md | 2 +- .../apps/sinatra_restart_instructions.md | 2 +- .../data/reusables/apps/state_description.md | 2 +- .../reusables/audit_log/audit-log-search.md | 2 - .../branches/change-default-branch.md | 1 + ...efault-branch-automatically-base-branch.md | 3 +- .../branches/new-repo-default-branch.md | 3 +- .../reusables/branches/set-default-branch.md | 2 +- .../reusables/code-scanning/analyze-go.md | 1 + .../autobuild-add-build-steps.md | 2 +- .../autobuild-compiled-languages.md | 6 +- .../code-scanning/beta-codeql-runner.md | 9 + .../data/reusables/code-scanning/beta.md | 6 +- .../code-scanning/click-alert-in-list.md | 2 +- .../code-scanning/close-alert-examples.md | 1 + .../code-scanning/codeql-query-suites.md | 4 +- .../code-scanning/codeql-runner-license.md | 8 +- .../reusables/code-scanning/edit-workflow.md | 2 +- .../code-scanning/enabling-options.md | 12 +- ...enterprise-enable-code-scanning-actions.md | 2 +- .../enterprise-enable-code-scanning.md | 2 +- .../example-configuration-files.md | 2 +- .../false-positive-fix-codeql.md | 1 + ...eroperable-with-tools-that-output-sarif.md | 2 +- .../code-scanning/run-additional-queries.md | 10 +- .../specify-language-to-analyze.md | 2 +- .../about-billing-for-codespaces.md | 1 + .../codespaces/about-configuration.md | 2 +- .../click-remote-explorer-icon-vscode.md | 2 +- .../codespaces/codespaces-are-per-branch.md | 2 +- .../codespaces/codespaces-are-personal.md | 2 +- .../codespaces/concurrent-codespace-limit.md | 2 +- .../connect-to-codespace-from-vscode.md | 2 +- .../codespaces/devcontainer-location.md | 1 + .../codespaces/navigate-to-codespaces.md | 2 +- .../reusables/codespaces/release-stage.md | 2 +- .../reusables/codespaces/unsupported-repos.md | 2 +- .../codespaces/use-visual-studio-features.md | 2 +- .../you-can-see-all-your-codespaces.md | 2 +- .../reusables/command_line/git-clone-url.md | 2 +- .../command_line/provide-an-access-token.md | 2 +- .../data/reusables/commits/about-commits.md | 2 +- .../dependabot/check-in-dependabot-yml.md | 2 +- .../dependabot/click-dependabot-tab.md | 2 +- .../dependabot/create-dependabot-yml.md | 2 +- .../default-dependencies-allow-ignore.md | 2 +- .../reusables/dependabot/default-labels.md | 2 +- .../reusables/dependabot/dependabot-tos.md | 2 +- .../reusables/dependabot/initial-updates.md | 4 +- .../option-affects-security-updates.md | 2 +- .../dependabot/private-dependencies.md | 2 +- .../dependabot/supported-package-managers.md | 44 +- ...de-dependency-to-minimum-secure-version.md | 4 +- .../dependabot/version-updates-for-actions.md | 2 +- .../data/reusables/desktop/2fa-in-browser.md | 4 +- .../desktop/authenticate-in-browser.md | 2 +- .../data/reusables/desktop/choose-a-theme.md | 2 +- .../desktop/choose-product-authenticate.md | 2 +- .../desktop/click-base-branch-in-drop-down.md | 2 +- .../data/reusables/desktop/confirm-tag.md | 2 +- .../data/reusables/desktop/create-tag.md | 2 +- .../reusables/desktop/current-branch-menu.md | 2 +- .../reusables/desktop/delete-branch-mac.md | 2 +- .../reusables/desktop/delete-branch-win.md | 2 +- .../desktop/download-desktop-page.md | 2 +- .../launch-desktop-from-command-line.md | 2 +- .../desktop/mac-select-desktop-menu.md | 2 +- .../reusables/desktop/protected-branches.md | 2 +- .../data/reusables/desktop/push-origin.md | 2 +- .../desktop/resolve-merge-conflicts.md | 2 +- .../data/reusables/desktop/retrieve-2fa.md | 2 +- .../data/reusables/desktop/revert-commit.md | 2 +- .../reusables/desktop/select-base-branch.md | 2 +- .../desktop/select-branch-to-delete.md | 2 +- .../reusables/desktop/update-email-address.md | 2 +- .../desktop/windows-choose-options.md | 2 +- .../reusables/dotcom_billing/add-seats.md | 2 +- .../dotcom_billing/confirm-add-seats.md | 2 +- .../dotcom_billing/number-of-seats.md | 2 +- .../reusables/dotcom_billing/upgrade_org.md | 2 +- .../enterprise-accounts/access-enterprise.md | 4 +- .../enterprise-accounts/actions-tab.md | 2 +- .../user-provisioning-release-stage.md | 2 +- .../data/reusables/enterprise/rate_limit.md | 3 +- .../reusables/enterprise/use-a-multiplexer.md | 2 +- .../apply-configuration.md | 2 +- .../configuration-file-heading.md | 2 +- .../configuration-finished.md | 4 +- .../key-value-pair-order-irrelevant.md | 2 +- .../open-configuration-file.md | 2 +- ...placing-a-cluster-node-replacement-name.md | 4 +- .../enterprise_clustering/ssh-to-a-node.md | 2 +- .../submit-support-ticket-first-section.md | 16 +- .../submit-support-ticket-second-section.md | 3 +- .../aws-supported-instance-types.md | 7 +- ...and-line-utilities-ghe-upgrade-rollback.md | 2 +- .../hardware-considerations-all-platforms.md | 46 +- .../hardware-rec-table.md | 16 +- .../increasing-cpus-req.md | 2 +- .../necessary_ports.md | 24 +- .../when-9418-necessary.md | 1 + .../advanced-security-tab.md | 2 +- .../badge_indicator.md | 2 +- .../enable-disable-code-scanning.md | 2 +- .../admin-top-tab.md | 2 +- .../business.md | 2 +- .../packages-tab.md | 2 +- .../repository-search.md | 2 +- .../search-user-or-org.md | 2 +- .../search-user.md | 2 +- .../manage-global-webhooks-api.md | 2 +- .../zh-CN/data/reusables/files/add-file.md | 4 +- .../reusables/files/choose_commit_branch.md | 2 +- .../files/commit-author-email-options.md | 3 +- .../data/reusables/gated-features/actions.md | 2 +- .../gated-features/code-review-assignment.md | 2 +- .../reusables/gated-features/code-scanning.md | 1 + .../gated-features/enterprise-accounts.md | 2 +- .../enterprise_account_webhooks.md | 2 +- .../gated-features/more-info-org-products.md | 2 +- .../reusables/gated-features/more-info.md | 2 +- .../data/reusables/gated-features/packages.md | 5 +- .../gated-features/repository-insights.md | 2 +- .../github-actions/actions-billing.md | 2 +- .../github-actions/actions-on-examples.md | 10 +- .../github-actions/actions-unused-labels.md | 2 +- .../artifact-log-retention-statement.md | 2 + .../github-actions/branch-requirement.md | 2 +- ...nge-retention-period-for-artifacts-logs.md | 2 + .../disabled-actions-description.md | 2 +- .../disabling-github-actions.md | 2 +- .../docker-container-os-support.md | 2 +- .../github-actions/dockerfile-guidelines.md | 2 +- .../enabled-actions-description.md | 2 +- .../enabled-local-github-actions.md | 2 +- .../github-actions/expression-syntax-if.md | 2 +- .../github-actions/gradle-workflow-steps.md | 2 +- .../permissions-statement-secrets-api.md | 2 +- ...missions-statement-secrets-organization.md | 2 +- ...ermissions-statement-secrets-repository.md | 2 +- .../private-repository-forks-configure.md | 4 +- .../private-repository-forks-overview.md | 8 +- .../publish-to-maven-workflow-step.md | 2 +- .../publish-to-packages-workflow-step.md | 2 +- .../publishing-java-packages-intro.md | 2 +- .../github-actions/run_id_description.md | 2 +- .../github-actions/run_number_description.md | 2 +- ...ed-runner-configure-runner-group-access.md | 4 +- ...sted-runner-labels-view-assigned-labels.md | 2 +- .../self-hosted-runner-list-group.md | 2 +- .../github-actions/self-hosted-runner-list.md | 2 +- ...-runner-management-permissions-required.md | 12 +- ...elf-hosted-runner-navigate-repo-and-org.md | 2 +- ...-runner-navigate-to-repo-org-enterprise.md | 12 +- .../self-hosted-runner-removal-impact.md | 2 +- .../self-hosted-runner-removing-a-runner.md | 4 +- .../self-hosted-runner-reusing.md | 2 +- .../github-actions/sidebar-secret.md | 2 +- .../github-actions/usage-api-requests.md | 1 + .../github-actions/usage-matrix-limits.md | 1 + .../github-actions/usage-workflow-run-time.md | 1 + .../github-insights/choose-key-metric.md | 2 +- .../github-insights/enterprise-api-url.md | 2 +- .../navigate-to-key-metrics.md | 2 +- .../zh-CN/data/reusables/gpg/private-email.md | 3 +- .../enable-team-sync-azure.md | 2 +- .../enable-team-sync-okta.md | 2 +- .../supported-idps-team-sync.md | 2 +- .../sync-team-with-idp-group.md | 2 +- .../team-sync-disable.md | 2 +- .../team-sync-okta-requirements.md | 2 +- .../collaborator-user-limit-definition.md | 2 +- .../contributor-user-limit-definition.md | 2 +- .../existing-user-limit-definition.md | 2 +- .../interactions/interactions-detail.md | 2 +- .../issue-events/assignee-properties.md | 2 +- .../issue-event-common-properties.md | 10 +- .../issue-events/label-properties.md | 2 +- .../issue-events/project-card-properties.md | 2 +- .../review-dismissed-properties.md | 2 +- .../issue-events/review-request-properties.md | 2 +- .../timeline_events_object_properties.md | 2 +- .../can-include-lfs-objects-archives.md | 4 +- .../marketplace/cancellation-clarification.md | 2 +- .../marketplace/free-apps-encouraged.md | 2 +- .../marketplace/github_apps_preferred.md | 2 +- .../reusables/marketplace/launch-with-free.md | 2 +- .../marketplace-billing-ui-requirements.md | 18 +- .../marketplace-double-purchases.md | 2 +- .../marketplace-failed-purchase-event.md | 2 +- .../marketplace-malicious-behavior.md | 2 +- .../marketplace-pricing-free-trials.md | 2 +- .../reusables/marketplace/unverified-apps.md | 2 +- .../email-notification-caveats.md | 2 +- .../notifications-v2/manage-notifications.md | 2 +- .../reusables/notifications/shared_state.md | 2 +- .../organizations/can-require-ssh-cert.md | 2 +- .../oauth_app_restrictions_default.md | 2 +- .../organizations/organization-name.md | 2 +- .../organizations/organizations_include.md | 2 +- .../outside-collaborators-use-seats.md | 2 +- .../organizations/repository-defaults.md | 2 +- .../organizations/repository-labels.md | 2 +- .../data/reusables/organizations/security.md | 4 +- .../organizations/send-invitation.md | 2 +- .../organizations/team_maintainers_can.md | 4 +- .../admins-can-configure-package-types.md | 4 +- .../package_registry/authenticate-packages.md | 12 +- ...uthenticate-to-container-registry-steps.md | 25 + ...nticate_with_pat_for_container_registry.md | 9 + .../billing-for-container-registry.md | 4 +- .../container-registry-beta-billing-note.md | 2 +- .../container-registry-beta.md | 2 +- .../container-registry-feature-highlights.md | 8 +- .../create-npmrc-owner-step.md | 4 +- .../docker_registry_deprecation_status.md | 5 + .../package_registry/package-immutability.md | 4 +- .../package-settings-from-org-level.md | 8 +- .../package-settings-from-user-level.md | 8 +- .../packages-from-code-tab.md | 2 +- .../packages-ghes-release-stage.md | 2 +- .../public-or-private-packages.md | 2 +- .../repository_connection_steps.md | 4 +- .../data/reusables/pages/admin-must-push.md | 2 +- .../pages/best-with-supported-themes.md | 3 +- .../pages/configure-publishing-source.md | 2 +- .../pages/decide-publishing-source.md | 2 +- .../reusables/pages/new-or-existing-repo.md | 2 +- .../pages/private_pages_are_public_warning.md | 2 +- .../zh-CN/data/reusables/policies/abuse.md | 2 +- .../api-preview-warning.md | 2 +- .../content-attachments-public-beta.md | 2 +- .../expiring-user-access-tokens-beta.md | 2 +- .../pre-release-program/fury-pre-release.md | 2 +- .../machine-man-preview.md | 4 +- .../pre-release-program/sailor-v-preview.md | 2 +- .../pre-release-program/starfox-preview.md | 4 +- .../suspend-installation-beta.md | 3 +- .../data/reusables/profile/profile-readme.md | 2 +- .../link-repos-to-project-board.md | 2 +- .../project-board-import-with-api.md | 2 +- .../reusables/projects/disabled-projects.md | 2 +- .../automatically-delete-branches.md | 2 - .../close-issues-using-keywords.md | 2 +- ...ollect-co-author-commit-git-config-info.md | 2 +- .../default-commit-message-squash-merge.md | 2 +- .../pull_requests/mark-ready-review.md | 2 +- .../pull_request_merges_and_contributions.md | 2 +- .../reusables/reminders/author-reviews.md | 2 +- .../reusables/reminders/ignored-labels.md | 2 +- .../data/reusables/reminders/ignored-terms.md | 2 +- .../zh-CN/data/reusables/reminders/min-age.md | 2 +- .../data/reusables/reminders/min-staleness.md | 2 +- .../reusables/reminders/real-time-alerts.md | 2 +- .../reusables/reminders/required-labels.md | 2 +- .../repositories/a-vulnerability-is.md | 2 +- .../about-github-archive-program.md | 2 +- .../repositories/about-internal-repos.md | 2 +- .../actions-scheduled-workflow-example.md | 2 +- .../actions-workflow-status-badge-into.md | 4 +- .../repositories/blocked-passwords.md | 3 +- .../repositories/choose-repo-visibility.md | 2 +- .../reusables/repositories/copy-clone-url.md | 16 +- .../repositories/default-issue-templates.md | 2 +- ...forks_from_private_repositories_warning.md | 6 +- .../reusables/repositories/deploy-keys.md | 2 +- .../repositories/enable-security-alerts.md | 4 +- .../navigate-to-job-superlinter.md | 5 + .../navigate-to-workflow-superlinter.md | 1 + .../repositories/new-pull-request.md | 8 +- .../repositories/open-with-github-desktop.md | 8 +- .../permissions-statement-read.md | 2 +- .../permissions-statement-write.md | 2 +- .../data/reusables/repositories/releases.md | 2 +- .../repositories/request-changes-tips.md | 2 +- .../request-security-advisory-cve-id.md | 2 +- .../security-alert-delivery-options.md | 2 +- .../security-alerts-x-github-severity.md | 2 +- .../repositories/select-marketplace-apps.md | 4 +- .../repositories/sidebar-dependabot-alerts.md | 2 +- ...quash-and-rebase-linear-commit-hisitory.md | 2 +- .../repositories/start-line-comment.md | 2 +- .../reusables/repositories/suggest-changes.md | 2 +- .../repositories/tracks-vulnerabilities.md | 2 +- .../view-failed-job-results-superlinter.md | 5 + .../repositories/view-run-superlinter.md | 1 + .../data/reusables/repositories/view-run.md | 2 +- .../view-specific-line-superlinter.md | 5 + .../reusables/repositories/you-can-fork.md | 4 +- ...ut-user-provisioning-enterprise-account.md | 2 +- .../reusables/saml/add-okta-application.md | 2 +- .../reusables/saml/assign-yourself-to-okta.md | 2 +- .../click-enterprise-account-application.md | 2 +- .../data/reusables/saml/okta-admin-button.md | 2 +- .../saml/okta-configure-api-integration.md | 2 +- .../reusables/saml/okta-edit-provisioning.md | 2 +- .../saml/okta-enable-api-integration.md | 2 +- .../reusables/saml/okta-provisioning-tab.md | 2 +- .../reusables/saml/okta-save-provisioning.md | 2 +- .../data/reusables/saml/okta-sign-on-tab.md | 2 +- .../saml/okta-view-setup-instructions.md | 2 +- .../data/reusables/saml/search-ghec-okta.md | 2 +- .../data/reusables/saml/use-classic-ui.md | 4 +- .../reusables/scim/enterprise-account-scim.md | 2 +- .../data/reusables/search/syntax_tips.md | 2 +- .../data/reusables/secret-scanning/beta.md | 2 +- ...urity-researcher-cannot-create-advisory.md | 2 +- ...-and-analysis-features-enable-read-only.md | 5 +- .../shortdesc/authenticating_github_app.md | 2 +- .../shortdesc/authorizing_oauth_apps.md | 2 +- .../creating_custom_badges_github_apps.md | 2 +- .../creating_custom_badges_oauth_apps.md | 2 +- .../shortdesc/creating_github_apps.md | 2 +- .../shortdesc/creating_oauth_apps.md | 2 +- .../shortdesc/deleting_github_apps.md | 2 +- .../shortdesc/deleting_oauth_apps.md | 2 +- .../editing_permissions_for_github_apps.md | 2 +- ...identifying_and_authorizing_github_apps.md | 2 +- .../data/reusables/shortdesc/iso_8601.md | 2 +- .../making-a-github-app-public-or-private.md | 2 +- .../shortdesc/modifying_github_apps.md | 2 +- .../shortdesc/modifying_oauth_apps.md | 2 +- .../shortdesc/permissions_github_apps.md | 2 +- .../shortdesc/rate_limits_github_apps.md | 2 +- .../transferring_ownership_of_github_apps.md | 2 +- .../transferring_ownership_of_oauth_apps.md | 2 +- ...g_access_token_reques_errors_oauth_apps.md | 2 +- ...authorization_request_errors_oauth_apps.md | 2 +- .../understanding_scopes_for_oauth_apps.md | 2 +- .../reusables/sponsors/edit-featured-work.md | 2 +- .../data/reusables/sponsors/meet-the-team.md | 2 +- .../navigate-to-dev-sponsors-dashboard.md | 2 +- .../navigate-to-org-sponsors-dashboard.md | 2 +- .../sponsors/navigate-to-your-goals-tab.md | 2 +- .../sponsors/opt-in-to-being-featured.md | 2 +- .../data/reusables/sponsors/publish-goal.md | 2 +- .../data/reusables/sponsors/retire-goal.md | 2 +- .../data/reusables/sponsors/save-profile.md | 2 +- .../data/reusables/sponsors/set-a-goal.md | 2 +- .../data/reusables/sponsors/short-bio.md | 2 +- .../sponsors/stripe-supported-regions.md | 2 +- .../you-can-be-a-sponsored-developer.md | 2 +- .../you-can-be-a-sponsored-organization.md | 2 +- .../zh-CN/data/reusables/ssh/dsa-support.md | 2 +- .../reusables/support/about-premium-plans.md | 20 +- .../support/ghec-premium-priorities.md | 10 +- .../data/reusables/support/ghes-priorities.md | 10 +- .../support/priority-urgent-english-only.md | 2 +- .../reusables/support/receiving-credits.md | 2 +- .../service-level-agreement-response-times.md | 4 +- .../zh-CN/data/reusables/two_fa/about-2fa.md | 1 + .../two_fa/after-2fa-add-security-key.md | 2 +- .../data/reusables/two_fa/auth_methods_2fa.md | 12 +- .../user-settings/edit_marketplace_listing.md | 2 +- .../reusables/user-settings/github_apps.md | 2 +- .../user-settings/github_apps_advanced.md | 2 +- .../user-settings/marketplace_apps.md | 2 +- .../user-settings/modify_github_app.md | 2 +- .../reusables/user-settings/oauth_apps.md | 2 +- .../user-settings/update_oauth_app.md | 2 +- .../about-commit-email-addresses.md | 2 +- .../reusables/user_settings/export-data.md | 3 +- ...word-authentication-deprecation-desktop.md | 2 +- .../password-authentication-deprecation.md | 2 +- .../user_settings/personal_dashboard.md | 2 +- .../user_settings/review_oauth_tokens_tip.md | 2 +- .../user_settings/security-analysis.md | 2 +- .../data/reusables/user_settings/security.md | 6 +- .../set_your_email_address_in_git.md | 2 +- .../user_settings/subscriptions-tab.md | 2 +- .../user_settings/sudo-mode-popup.md | 2 +- .../reusables/webhooks/action_type_desc.md | 2 +- .../zh-CN/data/reusables/webhooks/app_desc.md | 2 +- .../reusables/webhooks/authorization_event.md | 2 +- .../webhooks/check_run_properties.md | 20 +- .../webhooks/check_run_short_desc.md | 2 +- .../webhooks/check_suite_properties.md | 20 +- .../webhooks/check_suite_short_desc.md | 2 +- .../code_scanning_alert_event_properties.md | 12 +- .../code_scanning_alert_event_short_desc.md | 2 +- .../webhooks/commit_comment_properties.md | 8 +- .../webhooks/commit_comment_short_desc.md | 2 +- .../webhooks/content_reference_short_desc.md | 2 +- .../data/reusables/webhooks/content_type.md | 8 +- .../reusables/webhooks/create_properties.md | 12 +- .../reusables/webhooks/create_short_desc.md | 2 +- .../reusables/webhooks/delete_properties.md | 8 +- .../reusables/webhooks/delete_short_desc.md | 2 +- .../webhooks/deploy_key_properties.md | 8 +- .../webhooks/deploy_key_short_desc.md | 2 +- .../webhooks/deployment_short_desc.md | 2 +- .../webhooks/deployment_status_short_desc.md | 2 +- .../webhooks/enterprise_short_desc.md | 2 +- .../reusables/webhooks/events_api_payload.md | 2 +- .../reusables/webhooks/fork_properties.md | 6 +- .../reusables/webhooks/fork_short_desc.md | 2 +- .../reusables/webhooks/gollum_properties.md | 16 +- .../reusables/webhooks/gollum_short_desc.md | 2 +- .../webhooks/installation_properties.md | 8 +- .../installation_repositories_properties.md | 12 +- .../installation_repositories_short_desc.md | 2 +- .../webhooks/installation_short_desc.md | 2 +- .../webhooks/issue_comment_properties.md | 2 +- .../webhooks/issue_comment_short_desc.md | 2 +- .../issue_comment_webhook_properties.md | 6 +- .../webhooks/issue_event_api_properties.md | 6 +- .../reusables/webhooks/issue_properties.md | 2 +- .../webhooks/issue_webhook_properties.md | 6 +- .../reusables/webhooks/issues_short_desc.md | 2 +- .../reusables/webhooks/label_short_desc.md | 2 +- .../webhooks/member_event_api_properties.md | 6 +- .../reusables/webhooks/member_properties.md | 2 +- .../reusables/webhooks/member_short_desc.md | 2 +- .../webhooks/member_webhook_properties.md | 2 +- .../webhooks/membership_properties.md | 12 +- .../webhooks/membership_short_desc.md | 2 +- .../webhooks/milestone_properties.md | 16 +- .../webhooks/milestone_short_desc.md | 2 +- .../webhooks/org_block_short_desc.md | 2 +- .../zh-CN/data/reusables/webhooks/org_desc.md | 2 +- .../webhooks/organization_short_desc.md | 2 +- .../reusables/webhooks/package_properties.md | 8 +- .../webhooks/page_build_short_desc.md | 2 +- .../data/reusables/webhooks/payload_url.md | 2 +- .../reusables/webhooks/ping_short_desc.md | 2 +- .../webhooks/project_card_properties.md | 14 +- .../webhooks/project_card_short_desc.md | 2 +- .../webhooks/project_column_properties.md | 14 +- .../webhooks/project_column_short_desc.md | 2 +- .../reusables/webhooks/project_properties.md | 14 +- .../reusables/webhooks/project_short_desc.md | 2 +- .../reusables/webhooks/public_short_desc.md | 2 +- .../pull_request_event_api_properties.md | 6 +- .../webhooks/pull_request_properties.md | 2 +- ...est_review_comment_event_api_properties.md | 6 +- .../pull_request_review_comment_properties.md | 2 +- .../pull_request_review_comment_short_desc.md | 2 +- ...quest_review_comment_webhook_properties.md | 6 +- .../pull_request_review_properties.md | 12 +- .../pull_request_review_short_desc.md | 2 +- .../webhooks/pull_request_short_desc.md | 2 +- .../pull_request_webhook_properties.md | 6 +- .../reusables/webhooks/push_short_desc.md | 2 +- .../webhooks/release_event_api_properties.md | 6 +- .../reusables/webhooks/release_properties.md | 2 +- .../reusables/webhooks/release_short_desc.md | 2 +- .../webhooks/release_webhook_properties.md | 6 +- .../data/reusables/webhooks/repo_desc.md | 2 +- .../webhooks/repository_import_properties.md | 6 +- .../webhooks/repository_import_short_desc.md | 2 +- .../webhooks/repository_short_desc.md | 2 +- ...pository_vulnerability_alert_properties.md | 8 +- ...pository_vulnerability_alert_short_desc.md | 2 +- .../zh-CN/data/reusables/webhooks/secret.md | 2 +- .../data/reusables/webhooks/sender_desc.md | 2 +- .../sponsorship_event_api_properties.md | 6 +- .../webhooks/sponsorship_properties.md | 2 +- .../webhooks/sponsorship_short_desc.md | 2 +- .../sponsorship_webhook_properties.md | 6 +- .../reusables/webhooks/star_properties.md | 8 +- .../reusables/webhooks/star_short_desc.md | 2 +- .../reusables/webhooks/status_short_desc.md | 2 +- .../reusables/webhooks/team_add_short_desc.md | 2 +- .../reusables/webhooks/team_short_desc.md | 2 +- .../reusables/webhooks/watch_properties.md | 6 +- .../reusables/webhooks/watch_short_desc.md | 2 +- .../data/reusables/webhooks/webhooks_intro.md | 2 +- .../data/reusables/webhooks/webhooks_ssl.md | 2 +- .../reusables/webhooks/workflow_run_desc.md | 4 +- translations/zh-CN/data/ui.yml | 36 +- .../zh-CN/data/variables/command_line.yml | 4 +- translations/zh-CN/data/variables/contact.yml | 11 +- translations/zh-CN/data/variables/desktop.yml | 2 +- translations/zh-CN/data/variables/explore.yml | 6 +- translations/zh-CN/data/variables/gists.yml | 6 +- .../zh-CN/data/variables/migrations.yml | 6 +- .../zh-CN/data/variables/notifications.yml | 4 +- translations/zh-CN/data/variables/product.yml | 25 +- translations/zh-CN/data/variables/search.yml | 10 +- 6560 files changed, 80787 insertions(+), 28537 deletions(-) create mode 100644 translations/de-DE/content/actions/guides/about-continuous-integration.md create mode 100644 translations/de-DE/content/actions/guides/about-packaging-with-github-actions.md create mode 100644 translations/de-DE/content/actions/guides/about-service-containers.md create mode 100644 translations/de-DE/content/actions/guides/building-and-testing-java-with-ant.md create mode 100644 translations/de-DE/content/actions/guides/building-and-testing-java-with-gradle.md create mode 100644 translations/de-DE/content/actions/guides/building-and-testing-java-with-maven.md create mode 100644 translations/de-DE/content/actions/guides/building-and-testing-nodejs.md create mode 100644 translations/de-DE/content/actions/guides/building-and-testing-python.md create mode 100644 translations/de-DE/content/actions/guides/caching-dependencies-to-speed-up-workflows.md create mode 100644 translations/de-DE/content/actions/guides/creating-postgresql-service-containers.md create mode 100644 translations/de-DE/content/actions/guides/creating-redis-service-containers.md create mode 100644 translations/de-DE/content/actions/guides/index.md create mode 100644 translations/de-DE/content/actions/guides/publishing-docker-images.md create mode 100644 translations/de-DE/content/actions/guides/publishing-java-packages-with-gradle.md create mode 100644 translations/de-DE/content/actions/guides/publishing-java-packages-with-maven.md create mode 100644 translations/de-DE/content/actions/guides/publishing-nodejs-packages.md create mode 100644 translations/de-DE/content/actions/guides/setting-up-continuous-integration-using-workflow-templates.md create mode 100644 translations/de-DE/content/actions/guides/storing-workflow-data-as-artifacts.md create mode 100644 translations/de-DE/content/actions/learn-github-actions/essential-features-of-github-actions.md create mode 100644 translations/de-DE/content/actions/learn-github-actions/finding-and-customizing-actions.md create mode 100644 translations/de-DE/content/actions/learn-github-actions/index.md create mode 100644 translations/de-DE/content/actions/learn-github-actions/introduction-to-github-actions.md create mode 100644 translations/de-DE/content/actions/learn-github-actions/managing-complex-workflows.md create mode 100644 translations/de-DE/content/actions/learn-github-actions/migrating-from-azure-pipelines-to-github-actions.md create mode 100644 translations/de-DE/content/actions/learn-github-actions/migrating-from-circleci-to-github-actions.md create mode 100644 translations/de-DE/content/actions/learn-github-actions/migrating-from-gitlab-cicd-to-github-actions.md create mode 100644 translations/de-DE/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md create mode 100644 translations/de-DE/content/actions/learn-github-actions/security-hardening-for-github-actions.md create mode 100644 translations/de-DE/content/actions/learn-github-actions/sharing-workflows-with-your-organization.md create mode 100644 translations/de-DE/content/actions/managing-workflow-runs/adding-a-workflow-status-badge.md create mode 100644 translations/de-DE/content/actions/managing-workflow-runs/canceling-a-workflow.md create mode 100644 translations/de-DE/content/actions/managing-workflow-runs/deleting-a-workflow-run.md create mode 100644 translations/de-DE/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md create mode 100644 translations/de-DE/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md create mode 100644 translations/de-DE/content/actions/managing-workflow-runs/enabling-debug-logging.md create mode 100644 translations/de-DE/content/actions/managing-workflow-runs/index.md create mode 100644 translations/de-DE/content/actions/managing-workflow-runs/manually-running-a-workflow.md create mode 100644 translations/de-DE/content/actions/managing-workflow-runs/re-running-a-workflow.md create mode 100644 translations/de-DE/content/actions/managing-workflow-runs/removing-workflow-artifacts.md create mode 100644 translations/de-DE/content/actions/managing-workflow-runs/using-workflow-run-logs.md create mode 100644 translations/de-DE/content/actions/managing-workflow-runs/viewing-job-execution-time.md create mode 100644 translations/de-DE/content/actions/managing-workflow-runs/viewing-workflow-run-history.md create mode 100644 translations/de-DE/content/actions/reference/authentication-in-a-workflow.md create mode 100644 translations/de-DE/content/actions/reference/encrypted-secrets.md create mode 100644 translations/de-DE/content/actions/reference/environment-variables.md create mode 100644 translations/de-DE/content/actions/reference/specifications-for-github-hosted-runners.md create mode 100644 translations/de-DE/content/actions/reference/usage-limits-billing-and-administration.md create mode 100644 translations/de-DE/content/github/administering-a-repository/changing-the-default-branch.md create mode 100644 translations/de-DE/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md create mode 100644 translations/de-DE/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md create mode 100644 translations/de-DE/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md create mode 100644 translations/de-DE/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md create mode 100644 translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md create mode 100644 translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md create mode 100644 translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository.md create mode 100644 translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md create mode 100644 translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md create mode 100644 translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md create mode 100644 translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md create mode 100644 translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md create mode 100644 translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md create mode 100644 translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md create mode 100644 translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md create mode 100644 translations/de-DE/content/rest/reference/code-scanning.md create mode 100644 translations/de-DE/data/reusables/actions/about-artifact-log-retention.md create mode 100644 translations/de-DE/data/reusables/actions/actions-use-policy-settings.md create mode 100644 translations/de-DE/data/reusables/actions/allow-specific-actions-intro.md create mode 100644 translations/de-DE/data/reusables/actions/registry-credentials.md create mode 100644 translations/de-DE/data/reusables/actions/scheduled-workflows-disabled.md create mode 100644 translations/de-DE/data/reusables/branches/change-default-branch.md create mode 100644 translations/de-DE/data/reusables/code-scanning/analyze-go.md create mode 100644 translations/de-DE/data/reusables/code-scanning/beta-codeql-runner.md create mode 100644 translations/de-DE/data/reusables/code-scanning/close-alert-examples.md create mode 100644 translations/de-DE/data/reusables/code-scanning/false-positive-fix-codeql.md create mode 100644 translations/de-DE/data/reusables/codespaces/about-billing-for-codespaces.md create mode 100644 translations/de-DE/data/reusables/codespaces/devcontainer-location.md create mode 100644 translations/de-DE/data/reusables/enterprise_installation/when-9418-necessary.md create mode 100644 translations/de-DE/data/reusables/gated-features/code-scanning.md create mode 100644 translations/de-DE/data/reusables/github-actions/artifact-log-retention-statement.md create mode 100644 translations/de-DE/data/reusables/github-actions/change-retention-period-for-artifacts-logs.md create mode 100644 translations/de-DE/data/reusables/github-actions/usage-api-requests.md create mode 100644 translations/de-DE/data/reusables/github-actions/usage-matrix-limits.md create mode 100644 translations/de-DE/data/reusables/github-actions/usage-workflow-run-time.md create mode 100644 translations/de-DE/data/reusables/package_registry/authenticate-to-container-registry-steps.md create mode 100644 translations/de-DE/data/reusables/package_registry/authenticate_with_pat_for_container_registry.md create mode 100644 translations/de-DE/data/reusables/package_registry/docker_registry_deprecation_status.md create mode 100644 translations/de-DE/data/reusables/repositories/navigate-to-job-superlinter.md create mode 100644 translations/de-DE/data/reusables/repositories/navigate-to-workflow-superlinter.md create mode 100644 translations/de-DE/data/reusables/repositories/view-failed-job-results-superlinter.md create mode 100644 translations/de-DE/data/reusables/repositories/view-run-superlinter.md create mode 100644 translations/de-DE/data/reusables/repositories/view-specific-line-superlinter.md create mode 100644 translations/de-DE/data/reusables/two_fa/about-2fa.md create mode 100644 translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md create mode 100644 translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md create mode 100644 translations/es-XL/data/reusables/package_registry/docker_registry_deprecation_status.md create mode 100644 translations/ja-JP/content/actions/guides/about-continuous-integration.md create mode 100644 translations/ja-JP/content/actions/guides/about-packaging-with-github-actions.md create mode 100644 translations/ja-JP/content/actions/guides/about-service-containers.md create mode 100644 translations/ja-JP/content/actions/guides/building-and-testing-java-with-ant.md create mode 100644 translations/ja-JP/content/actions/guides/building-and-testing-java-with-gradle.md create mode 100644 translations/ja-JP/content/actions/guides/building-and-testing-java-with-maven.md create mode 100644 translations/ja-JP/content/actions/guides/building-and-testing-nodejs.md create mode 100644 translations/ja-JP/content/actions/guides/building-and-testing-python.md create mode 100644 translations/ja-JP/content/actions/guides/caching-dependencies-to-speed-up-workflows.md create mode 100644 translations/ja-JP/content/actions/guides/creating-postgresql-service-containers.md create mode 100644 translations/ja-JP/content/actions/guides/creating-redis-service-containers.md create mode 100644 translations/ja-JP/content/actions/guides/index.md create mode 100644 translations/ja-JP/content/actions/guides/publishing-docker-images.md create mode 100644 translations/ja-JP/content/actions/guides/publishing-java-packages-with-gradle.md create mode 100644 translations/ja-JP/content/actions/guides/publishing-java-packages-with-maven.md create mode 100644 translations/ja-JP/content/actions/guides/publishing-nodejs-packages.md create mode 100644 translations/ja-JP/content/actions/guides/setting-up-continuous-integration-using-workflow-templates.md create mode 100644 translations/ja-JP/content/actions/guides/storing-workflow-data-as-artifacts.md create mode 100644 translations/ja-JP/content/actions/learn-github-actions/essential-features-of-github-actions.md create mode 100644 translations/ja-JP/content/actions/learn-github-actions/finding-and-customizing-actions.md create mode 100644 translations/ja-JP/content/actions/learn-github-actions/index.md create mode 100644 translations/ja-JP/content/actions/learn-github-actions/introduction-to-github-actions.md create mode 100644 translations/ja-JP/content/actions/learn-github-actions/managing-complex-workflows.md create mode 100644 translations/ja-JP/content/actions/learn-github-actions/migrating-from-azure-pipelines-to-github-actions.md create mode 100644 translations/ja-JP/content/actions/learn-github-actions/migrating-from-circleci-to-github-actions.md create mode 100644 translations/ja-JP/content/actions/learn-github-actions/migrating-from-gitlab-cicd-to-github-actions.md create mode 100644 translations/ja-JP/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md create mode 100644 translations/ja-JP/content/actions/learn-github-actions/security-hardening-for-github-actions.md create mode 100644 translations/ja-JP/content/actions/learn-github-actions/sharing-workflows-with-your-organization.md create mode 100644 translations/ja-JP/content/actions/managing-workflow-runs/adding-a-workflow-status-badge.md create mode 100644 translations/ja-JP/content/actions/managing-workflow-runs/canceling-a-workflow.md create mode 100644 translations/ja-JP/content/actions/managing-workflow-runs/deleting-a-workflow-run.md create mode 100644 translations/ja-JP/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md create mode 100644 translations/ja-JP/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md create mode 100644 translations/ja-JP/content/actions/managing-workflow-runs/enabling-debug-logging.md create mode 100644 translations/ja-JP/content/actions/managing-workflow-runs/index.md create mode 100644 translations/ja-JP/content/actions/managing-workflow-runs/manually-running-a-workflow.md create mode 100644 translations/ja-JP/content/actions/managing-workflow-runs/re-running-a-workflow.md create mode 100644 translations/ja-JP/content/actions/managing-workflow-runs/removing-workflow-artifacts.md create mode 100644 translations/ja-JP/content/actions/managing-workflow-runs/using-workflow-run-logs.md create mode 100644 translations/ja-JP/content/actions/managing-workflow-runs/viewing-job-execution-time.md create mode 100644 translations/ja-JP/content/actions/managing-workflow-runs/viewing-workflow-run-history.md create mode 100644 translations/ja-JP/content/actions/reference/authentication-in-a-workflow.md create mode 100644 translations/ja-JP/content/actions/reference/encrypted-secrets.md create mode 100644 translations/ja-JP/content/actions/reference/environment-variables.md create mode 100644 translations/ja-JP/content/actions/reference/specifications-for-github-hosted-runners.md create mode 100644 translations/ja-JP/content/actions/reference/usage-limits-billing-and-administration.md create mode 100644 translations/ja-JP/content/github/administering-a-repository/changing-the-default-branch.md create mode 100644 translations/ja-JP/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md create mode 100644 translations/ja-JP/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md create mode 100644 translations/ja-JP/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md create mode 100644 translations/ja-JP/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md create mode 100644 translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md create mode 100644 translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md create mode 100644 translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository.md create mode 100644 translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md create mode 100644 translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md create mode 100644 translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md create mode 100644 translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md create mode 100644 translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md create mode 100644 translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md create mode 100644 translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md create mode 100644 translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md create mode 100644 translations/ja-JP/content/rest/reference/code-scanning.md create mode 100644 translations/ja-JP/data/reusables/actions/about-artifact-log-retention.md create mode 100644 translations/ja-JP/data/reusables/actions/actions-use-policy-settings.md create mode 100644 translations/ja-JP/data/reusables/actions/allow-specific-actions-intro.md create mode 100644 translations/ja-JP/data/reusables/actions/registry-credentials.md create mode 100644 translations/ja-JP/data/reusables/actions/scheduled-workflows-disabled.md create mode 100644 translations/ja-JP/data/reusables/branches/change-default-branch.md create mode 100644 translations/ja-JP/data/reusables/code-scanning/analyze-go.md create mode 100644 translations/ja-JP/data/reusables/code-scanning/beta-codeql-runner.md create mode 100644 translations/ja-JP/data/reusables/code-scanning/close-alert-examples.md create mode 100644 translations/ja-JP/data/reusables/code-scanning/false-positive-fix-codeql.md create mode 100644 translations/ja-JP/data/reusables/codespaces/about-billing-for-codespaces.md create mode 100644 translations/ja-JP/data/reusables/codespaces/devcontainer-location.md create mode 100644 translations/ja-JP/data/reusables/enterprise_installation/when-9418-necessary.md create mode 100644 translations/ja-JP/data/reusables/gated-features/code-scanning.md create mode 100644 translations/ja-JP/data/reusables/github-actions/artifact-log-retention-statement.md create mode 100644 translations/ja-JP/data/reusables/github-actions/change-retention-period-for-artifacts-logs.md create mode 100644 translations/ja-JP/data/reusables/github-actions/usage-api-requests.md create mode 100644 translations/ja-JP/data/reusables/github-actions/usage-matrix-limits.md create mode 100644 translations/ja-JP/data/reusables/github-actions/usage-workflow-run-time.md create mode 100644 translations/ja-JP/data/reusables/package_registry/authenticate-to-container-registry-steps.md create mode 100644 translations/ja-JP/data/reusables/package_registry/authenticate_with_pat_for_container_registry.md create mode 100644 translations/ja-JP/data/reusables/package_registry/docker_registry_deprecation_status.md create mode 100644 translations/ja-JP/data/reusables/repositories/navigate-to-job-superlinter.md create mode 100644 translations/ja-JP/data/reusables/repositories/navigate-to-workflow-superlinter.md create mode 100644 translations/ja-JP/data/reusables/repositories/view-failed-job-results-superlinter.md create mode 100644 translations/ja-JP/data/reusables/repositories/view-run-superlinter.md create mode 100644 translations/ja-JP/data/reusables/repositories/view-specific-line-superlinter.md create mode 100644 translations/ja-JP/data/reusables/two_fa/about-2fa.md create mode 100644 translations/ko-KR/content/actions/guides/about-continuous-integration.md create mode 100644 translations/ko-KR/content/actions/guides/about-packaging-with-github-actions.md create mode 100644 translations/ko-KR/content/actions/guides/about-service-containers.md create mode 100644 translations/ko-KR/content/actions/guides/building-and-testing-java-with-ant.md create mode 100644 translations/ko-KR/content/actions/guides/building-and-testing-java-with-gradle.md create mode 100644 translations/ko-KR/content/actions/guides/building-and-testing-java-with-maven.md create mode 100644 translations/ko-KR/content/actions/guides/building-and-testing-nodejs.md create mode 100644 translations/ko-KR/content/actions/guides/building-and-testing-python.md create mode 100644 translations/ko-KR/content/actions/guides/caching-dependencies-to-speed-up-workflows.md create mode 100644 translations/ko-KR/content/actions/guides/creating-postgresql-service-containers.md create mode 100644 translations/ko-KR/content/actions/guides/creating-redis-service-containers.md create mode 100644 translations/ko-KR/content/actions/guides/index.md create mode 100644 translations/ko-KR/content/actions/guides/publishing-docker-images.md create mode 100644 translations/ko-KR/content/actions/guides/publishing-java-packages-with-gradle.md create mode 100644 translations/ko-KR/content/actions/guides/publishing-java-packages-with-maven.md create mode 100644 translations/ko-KR/content/actions/guides/publishing-nodejs-packages.md create mode 100644 translations/ko-KR/content/actions/guides/setting-up-continuous-integration-using-workflow-templates.md create mode 100644 translations/ko-KR/content/actions/guides/storing-workflow-data-as-artifacts.md create mode 100644 translations/ko-KR/content/actions/learn-github-actions/essential-features-of-github-actions.md create mode 100644 translations/ko-KR/content/actions/learn-github-actions/finding-and-customizing-actions.md create mode 100644 translations/ko-KR/content/actions/learn-github-actions/index.md create mode 100644 translations/ko-KR/content/actions/learn-github-actions/introduction-to-github-actions.md create mode 100644 translations/ko-KR/content/actions/learn-github-actions/managing-complex-workflows.md create mode 100644 translations/ko-KR/content/actions/learn-github-actions/migrating-from-azure-pipelines-to-github-actions.md create mode 100644 translations/ko-KR/content/actions/learn-github-actions/migrating-from-circleci-to-github-actions.md create mode 100644 translations/ko-KR/content/actions/learn-github-actions/migrating-from-gitlab-cicd-to-github-actions.md create mode 100644 translations/ko-KR/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md create mode 100644 translations/ko-KR/content/actions/learn-github-actions/security-hardening-for-github-actions.md create mode 100644 translations/ko-KR/content/actions/learn-github-actions/sharing-workflows-with-your-organization.md create mode 100644 translations/ko-KR/content/actions/managing-workflow-runs/adding-a-workflow-status-badge.md create mode 100644 translations/ko-KR/content/actions/managing-workflow-runs/canceling-a-workflow.md create mode 100644 translations/ko-KR/content/actions/managing-workflow-runs/deleting-a-workflow-run.md create mode 100644 translations/ko-KR/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md create mode 100644 translations/ko-KR/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md create mode 100644 translations/ko-KR/content/actions/managing-workflow-runs/enabling-debug-logging.md create mode 100644 translations/ko-KR/content/actions/managing-workflow-runs/index.md create mode 100644 translations/ko-KR/content/actions/managing-workflow-runs/manually-running-a-workflow.md create mode 100644 translations/ko-KR/content/actions/managing-workflow-runs/re-running-a-workflow.md create mode 100644 translations/ko-KR/content/actions/managing-workflow-runs/removing-workflow-artifacts.md create mode 100644 translations/ko-KR/content/actions/managing-workflow-runs/using-workflow-run-logs.md create mode 100644 translations/ko-KR/content/actions/managing-workflow-runs/viewing-job-execution-time.md create mode 100644 translations/ko-KR/content/actions/managing-workflow-runs/viewing-workflow-run-history.md create mode 100644 translations/ko-KR/content/actions/reference/authentication-in-a-workflow.md create mode 100644 translations/ko-KR/content/actions/reference/encrypted-secrets.md create mode 100644 translations/ko-KR/content/actions/reference/environment-variables.md create mode 100644 translations/ko-KR/content/actions/reference/specifications-for-github-hosted-runners.md create mode 100644 translations/ko-KR/content/actions/reference/usage-limits-billing-and-administration.md create mode 100644 translations/ko-KR/content/github/administering-a-repository/changing-the-default-branch.md create mode 100644 translations/ko-KR/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md create mode 100644 translations/ko-KR/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md create mode 100644 translations/ko-KR/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md create mode 100644 translations/ko-KR/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md create mode 100644 translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md create mode 100644 translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md create mode 100644 translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository.md create mode 100644 translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md create mode 100644 translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md create mode 100644 translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md create mode 100644 translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md create mode 100644 translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md create mode 100644 translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md create mode 100644 translations/ko-KR/content/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md create mode 100644 translations/ko-KR/content/github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md create mode 100644 translations/ko-KR/content/rest/reference/code-scanning.md create mode 100644 translations/ko-KR/data/reusables/actions/about-artifact-log-retention.md create mode 100644 translations/ko-KR/data/reusables/actions/actions-use-policy-settings.md create mode 100644 translations/ko-KR/data/reusables/actions/allow-specific-actions-intro.md create mode 100644 translations/ko-KR/data/reusables/actions/registry-credentials.md create mode 100644 translations/ko-KR/data/reusables/actions/scheduled-workflows-disabled.md create mode 100644 translations/ko-KR/data/reusables/branches/change-default-branch.md create mode 100644 translations/ko-KR/data/reusables/code-scanning/analyze-go.md create mode 100644 translations/ko-KR/data/reusables/code-scanning/beta-codeql-runner.md create mode 100644 translations/ko-KR/data/reusables/code-scanning/close-alert-examples.md create mode 100644 translations/ko-KR/data/reusables/code-scanning/false-positive-fix-codeql.md create mode 100644 translations/ko-KR/data/reusables/codespaces/about-billing-for-codespaces.md create mode 100644 translations/ko-KR/data/reusables/codespaces/devcontainer-location.md create mode 100644 translations/ko-KR/data/reusables/enterprise_installation/when-9418-necessary.md create mode 100644 translations/ko-KR/data/reusables/gated-features/code-scanning.md create mode 100644 translations/ko-KR/data/reusables/github-actions/artifact-log-retention-statement.md create mode 100644 translations/ko-KR/data/reusables/github-actions/change-retention-period-for-artifacts-logs.md create mode 100644 translations/ko-KR/data/reusables/github-actions/usage-api-requests.md create mode 100644 translations/ko-KR/data/reusables/github-actions/usage-matrix-limits.md create mode 100644 translations/ko-KR/data/reusables/github-actions/usage-workflow-run-time.md create mode 100644 translations/ko-KR/data/reusables/package_registry/authenticate-to-container-registry-steps.md create mode 100644 translations/ko-KR/data/reusables/package_registry/authenticate_with_pat_for_container_registry.md create mode 100644 translations/ko-KR/data/reusables/package_registry/docker_registry_deprecation_status.md create mode 100644 translations/ko-KR/data/reusables/repositories/navigate-to-job-superlinter.md create mode 100644 translations/ko-KR/data/reusables/repositories/navigate-to-workflow-superlinter.md create mode 100644 translations/ko-KR/data/reusables/repositories/view-failed-job-results-superlinter.md create mode 100644 translations/ko-KR/data/reusables/repositories/view-run-superlinter.md create mode 100644 translations/ko-KR/data/reusables/repositories/view-specific-line-superlinter.md create mode 100644 translations/ko-KR/data/reusables/two_fa/about-2fa.md create mode 100644 translations/pt-BR/content/actions/guides/about-continuous-integration.md create mode 100644 translations/pt-BR/content/actions/guides/about-packaging-with-github-actions.md create mode 100644 translations/pt-BR/content/actions/guides/about-service-containers.md create mode 100644 translations/pt-BR/content/actions/guides/building-and-testing-java-with-ant.md create mode 100644 translations/pt-BR/content/actions/guides/building-and-testing-java-with-gradle.md create mode 100644 translations/pt-BR/content/actions/guides/building-and-testing-java-with-maven.md create mode 100644 translations/pt-BR/content/actions/guides/building-and-testing-nodejs.md create mode 100644 translations/pt-BR/content/actions/guides/building-and-testing-python.md create mode 100644 translations/pt-BR/content/actions/guides/caching-dependencies-to-speed-up-workflows.md create mode 100644 translations/pt-BR/content/actions/guides/creating-postgresql-service-containers.md create mode 100644 translations/pt-BR/content/actions/guides/creating-redis-service-containers.md create mode 100644 translations/pt-BR/content/actions/guides/index.md create mode 100644 translations/pt-BR/content/actions/guides/publishing-docker-images.md create mode 100644 translations/pt-BR/content/actions/guides/publishing-java-packages-with-gradle.md create mode 100644 translations/pt-BR/content/actions/guides/publishing-java-packages-with-maven.md create mode 100644 translations/pt-BR/content/actions/guides/publishing-nodejs-packages.md create mode 100644 translations/pt-BR/content/actions/guides/setting-up-continuous-integration-using-workflow-templates.md create mode 100644 translations/pt-BR/content/actions/guides/storing-workflow-data-as-artifacts.md create mode 100644 translations/pt-BR/content/actions/learn-github-actions/essential-features-of-github-actions.md create mode 100644 translations/pt-BR/content/actions/learn-github-actions/finding-and-customizing-actions.md create mode 100644 translations/pt-BR/content/actions/learn-github-actions/index.md create mode 100644 translations/pt-BR/content/actions/learn-github-actions/introduction-to-github-actions.md create mode 100644 translations/pt-BR/content/actions/learn-github-actions/managing-complex-workflows.md create mode 100644 translations/pt-BR/content/actions/learn-github-actions/migrating-from-azure-pipelines-to-github-actions.md create mode 100644 translations/pt-BR/content/actions/learn-github-actions/migrating-from-circleci-to-github-actions.md create mode 100644 translations/pt-BR/content/actions/learn-github-actions/migrating-from-gitlab-cicd-to-github-actions.md create mode 100644 translations/pt-BR/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md create mode 100644 translations/pt-BR/content/actions/learn-github-actions/security-hardening-for-github-actions.md create mode 100644 translations/pt-BR/content/actions/learn-github-actions/sharing-workflows-with-your-organization.md create mode 100644 translations/pt-BR/content/actions/managing-workflow-runs/adding-a-workflow-status-badge.md create mode 100644 translations/pt-BR/content/actions/managing-workflow-runs/canceling-a-workflow.md create mode 100644 translations/pt-BR/content/actions/managing-workflow-runs/deleting-a-workflow-run.md create mode 100644 translations/pt-BR/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md create mode 100644 translations/pt-BR/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md create mode 100644 translations/pt-BR/content/actions/managing-workflow-runs/enabling-debug-logging.md create mode 100644 translations/pt-BR/content/actions/managing-workflow-runs/index.md create mode 100644 translations/pt-BR/content/actions/managing-workflow-runs/manually-running-a-workflow.md create mode 100644 translations/pt-BR/content/actions/managing-workflow-runs/re-running-a-workflow.md create mode 100644 translations/pt-BR/content/actions/managing-workflow-runs/removing-workflow-artifacts.md create mode 100644 translations/pt-BR/content/actions/managing-workflow-runs/using-workflow-run-logs.md create mode 100644 translations/pt-BR/content/actions/managing-workflow-runs/viewing-job-execution-time.md create mode 100644 translations/pt-BR/content/actions/managing-workflow-runs/viewing-workflow-run-history.md create mode 100644 translations/pt-BR/content/actions/quickstart.md create mode 100644 translations/pt-BR/content/actions/reference/authentication-in-a-workflow.md create mode 100644 translations/pt-BR/content/actions/reference/encrypted-secrets.md create mode 100644 translations/pt-BR/content/actions/reference/environment-variables.md create mode 100644 translations/pt-BR/content/actions/reference/specifications-for-github-hosted-runners.md create mode 100644 translations/pt-BR/content/actions/reference/usage-limits-billing-and-administration.md create mode 100644 translations/pt-BR/content/github/administering-a-repository/changing-the-default-branch.md create mode 100644 translations/pt-BR/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md create mode 100644 translations/pt-BR/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md create mode 100644 translations/pt-BR/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md create mode 100644 translations/pt-BR/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md create mode 100644 translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md create mode 100644 translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md create mode 100644 translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository.md create mode 100644 translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md create mode 100644 translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md create mode 100644 translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md create mode 100644 translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md create mode 100644 translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md create mode 100644 translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md create mode 100644 translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md create mode 100644 translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md create mode 100644 translations/pt-BR/content/rest/reference/code-scanning.md create mode 100644 translations/pt-BR/data/reusables/actions/about-artifact-log-retention.md create mode 100644 translations/pt-BR/data/reusables/actions/actions-use-policy-settings.md create mode 100644 translations/pt-BR/data/reusables/actions/allow-specific-actions-intro.md create mode 100644 translations/pt-BR/data/reusables/actions/registry-credentials.md create mode 100644 translations/pt-BR/data/reusables/actions/scheduled-workflows-disabled.md create mode 100644 translations/pt-BR/data/reusables/branches/change-default-branch.md create mode 100644 translations/pt-BR/data/reusables/code-scanning/analyze-go.md create mode 100644 translations/pt-BR/data/reusables/code-scanning/beta-codeql-runner.md create mode 100644 translations/pt-BR/data/reusables/code-scanning/close-alert-examples.md create mode 100644 translations/pt-BR/data/reusables/code-scanning/false-positive-fix-codeql.md create mode 100644 translations/pt-BR/data/reusables/codespaces/about-billing-for-codespaces.md create mode 100644 translations/pt-BR/data/reusables/codespaces/devcontainer-location.md create mode 100644 translations/pt-BR/data/reusables/enterprise_installation/when-9418-necessary.md create mode 100644 translations/pt-BR/data/reusables/gated-features/code-scanning.md create mode 100644 translations/pt-BR/data/reusables/github-actions/artifact-log-retention-statement.md create mode 100644 translations/pt-BR/data/reusables/github-actions/change-retention-period-for-artifacts-logs.md create mode 100644 translations/pt-BR/data/reusables/github-actions/usage-api-requests.md create mode 100644 translations/pt-BR/data/reusables/github-actions/usage-matrix-limits.md create mode 100644 translations/pt-BR/data/reusables/github-actions/usage-workflow-run-time.md create mode 100644 translations/pt-BR/data/reusables/package_registry/authenticate-to-container-registry-steps.md create mode 100644 translations/pt-BR/data/reusables/package_registry/authenticate_with_pat_for_container_registry.md create mode 100644 translations/pt-BR/data/reusables/package_registry/docker_registry_deprecation_status.md create mode 100644 translations/pt-BR/data/reusables/repositories/navigate-to-job-superlinter.md create mode 100644 translations/pt-BR/data/reusables/repositories/navigate-to-workflow-superlinter.md create mode 100644 translations/pt-BR/data/reusables/repositories/view-failed-job-results-superlinter.md create mode 100644 translations/pt-BR/data/reusables/repositories/view-run-superlinter.md create mode 100644 translations/pt-BR/data/reusables/repositories/view-specific-line-superlinter.md create mode 100644 translations/pt-BR/data/reusables/two_fa/about-2fa.md create mode 100644 translations/ru-RU/content/actions/guides/about-continuous-integration.md create mode 100644 translations/ru-RU/content/actions/guides/about-packaging-with-github-actions.md create mode 100644 translations/ru-RU/content/actions/guides/about-service-containers.md create mode 100644 translations/ru-RU/content/actions/guides/building-and-testing-java-with-ant.md create mode 100644 translations/ru-RU/content/actions/guides/building-and-testing-java-with-gradle.md create mode 100644 translations/ru-RU/content/actions/guides/building-and-testing-java-with-maven.md create mode 100644 translations/ru-RU/content/actions/guides/building-and-testing-nodejs.md create mode 100644 translations/ru-RU/content/actions/guides/building-and-testing-python.md create mode 100644 translations/ru-RU/content/actions/guides/caching-dependencies-to-speed-up-workflows.md create mode 100644 translations/ru-RU/content/actions/guides/creating-postgresql-service-containers.md create mode 100644 translations/ru-RU/content/actions/guides/creating-redis-service-containers.md create mode 100644 translations/ru-RU/content/actions/guides/index.md create mode 100644 translations/ru-RU/content/actions/guides/publishing-docker-images.md create mode 100644 translations/ru-RU/content/actions/guides/publishing-java-packages-with-gradle.md create mode 100644 translations/ru-RU/content/actions/guides/publishing-java-packages-with-maven.md create mode 100644 translations/ru-RU/content/actions/guides/publishing-nodejs-packages.md create mode 100644 translations/ru-RU/content/actions/guides/setting-up-continuous-integration-using-workflow-templates.md create mode 100644 translations/ru-RU/content/actions/guides/storing-workflow-data-as-artifacts.md create mode 100644 translations/ru-RU/content/actions/learn-github-actions/essential-features-of-github-actions.md create mode 100644 translations/ru-RU/content/actions/learn-github-actions/finding-and-customizing-actions.md create mode 100644 translations/ru-RU/content/actions/learn-github-actions/index.md create mode 100644 translations/ru-RU/content/actions/learn-github-actions/introduction-to-github-actions.md create mode 100644 translations/ru-RU/content/actions/learn-github-actions/managing-complex-workflows.md create mode 100644 translations/ru-RU/content/actions/learn-github-actions/migrating-from-azure-pipelines-to-github-actions.md create mode 100644 translations/ru-RU/content/actions/learn-github-actions/migrating-from-circleci-to-github-actions.md create mode 100644 translations/ru-RU/content/actions/learn-github-actions/migrating-from-gitlab-cicd-to-github-actions.md create mode 100644 translations/ru-RU/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md create mode 100644 translations/ru-RU/content/actions/learn-github-actions/security-hardening-for-github-actions.md create mode 100644 translations/ru-RU/content/actions/learn-github-actions/sharing-workflows-with-your-organization.md create mode 100644 translations/ru-RU/content/actions/managing-workflow-runs/adding-a-workflow-status-badge.md create mode 100644 translations/ru-RU/content/actions/managing-workflow-runs/canceling-a-workflow.md create mode 100644 translations/ru-RU/content/actions/managing-workflow-runs/deleting-a-workflow-run.md create mode 100644 translations/ru-RU/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md create mode 100644 translations/ru-RU/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md create mode 100644 translations/ru-RU/content/actions/managing-workflow-runs/enabling-debug-logging.md create mode 100644 translations/ru-RU/content/actions/managing-workflow-runs/index.md create mode 100644 translations/ru-RU/content/actions/managing-workflow-runs/manually-running-a-workflow.md create mode 100644 translations/ru-RU/content/actions/managing-workflow-runs/re-running-a-workflow.md create mode 100644 translations/ru-RU/content/actions/managing-workflow-runs/removing-workflow-artifacts.md create mode 100644 translations/ru-RU/content/actions/managing-workflow-runs/using-workflow-run-logs.md create mode 100644 translations/ru-RU/content/actions/managing-workflow-runs/viewing-job-execution-time.md create mode 100644 translations/ru-RU/content/actions/managing-workflow-runs/viewing-workflow-run-history.md create mode 100644 translations/ru-RU/content/actions/quickstart.md create mode 100644 translations/ru-RU/content/actions/reference/authentication-in-a-workflow.md create mode 100644 translations/ru-RU/content/actions/reference/encrypted-secrets.md create mode 100644 translations/ru-RU/content/actions/reference/environment-variables.md create mode 100644 translations/ru-RU/content/actions/reference/specifications-for-github-hosted-runners.md create mode 100644 translations/ru-RU/content/actions/reference/usage-limits-billing-and-administration.md create mode 100644 translations/ru-RU/content/github/administering-a-repository/changing-the-default-branch.md create mode 100644 translations/ru-RU/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md create mode 100644 translations/ru-RU/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md create mode 100644 translations/ru-RU/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md create mode 100644 translations/ru-RU/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md create mode 100644 translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md create mode 100644 translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md create mode 100644 translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository.md create mode 100644 translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md create mode 100644 translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md create mode 100644 translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md create mode 100644 translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md create mode 100644 translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md create mode 100644 translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md create mode 100644 translations/ru-RU/content/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md create mode 100644 translations/ru-RU/content/github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md create mode 100644 translations/ru-RU/content/rest/reference/code-scanning.md create mode 100644 translations/ru-RU/data/reusables/actions/about-artifact-log-retention.md create mode 100644 translations/ru-RU/data/reusables/actions/actions-use-policy-settings.md create mode 100644 translations/ru-RU/data/reusables/actions/allow-specific-actions-intro.md create mode 100644 translations/ru-RU/data/reusables/actions/registry-credentials.md create mode 100644 translations/ru-RU/data/reusables/actions/scheduled-workflows-disabled.md create mode 100644 translations/ru-RU/data/reusables/branches/change-default-branch.md create mode 100644 translations/ru-RU/data/reusables/code-scanning/analyze-go.md create mode 100644 translations/ru-RU/data/reusables/code-scanning/beta-codeql-runner.md create mode 100644 translations/ru-RU/data/reusables/code-scanning/close-alert-examples.md create mode 100644 translations/ru-RU/data/reusables/code-scanning/false-positive-fix-codeql.md create mode 100644 translations/ru-RU/data/reusables/codespaces/about-billing-for-codespaces.md create mode 100644 translations/ru-RU/data/reusables/codespaces/devcontainer-location.md create mode 100644 translations/ru-RU/data/reusables/enterprise_installation/when-9418-necessary.md create mode 100644 translations/ru-RU/data/reusables/gated-features/code-scanning.md create mode 100644 translations/ru-RU/data/reusables/github-actions/artifact-log-retention-statement.md create mode 100644 translations/ru-RU/data/reusables/github-actions/change-retention-period-for-artifacts-logs.md create mode 100644 translations/ru-RU/data/reusables/github-actions/usage-api-requests.md create mode 100644 translations/ru-RU/data/reusables/github-actions/usage-matrix-limits.md create mode 100644 translations/ru-RU/data/reusables/github-actions/usage-workflow-run-time.md create mode 100644 translations/ru-RU/data/reusables/package_registry/authenticate-to-container-registry-steps.md create mode 100644 translations/ru-RU/data/reusables/package_registry/authenticate_with_pat_for_container_registry.md create mode 100644 translations/ru-RU/data/reusables/package_registry/docker_registry_deprecation_status.md create mode 100644 translations/ru-RU/data/reusables/repositories/navigate-to-job-superlinter.md create mode 100644 translations/ru-RU/data/reusables/repositories/navigate-to-workflow-superlinter.md create mode 100644 translations/ru-RU/data/reusables/repositories/view-failed-job-results-superlinter.md create mode 100644 translations/ru-RU/data/reusables/repositories/view-run-superlinter.md create mode 100644 translations/ru-RU/data/reusables/repositories/view-specific-line-superlinter.md create mode 100644 translations/ru-RU/data/reusables/two_fa/about-2fa.md create mode 100644 translations/zh-CN/content/actions/guides/about-continuous-integration.md create mode 100644 translations/zh-CN/content/actions/guides/about-packaging-with-github-actions.md create mode 100644 translations/zh-CN/content/actions/guides/about-service-containers.md create mode 100644 translations/zh-CN/content/actions/guides/building-and-testing-java-with-ant.md create mode 100644 translations/zh-CN/content/actions/guides/building-and-testing-java-with-gradle.md create mode 100644 translations/zh-CN/content/actions/guides/building-and-testing-java-with-maven.md create mode 100644 translations/zh-CN/content/actions/guides/building-and-testing-nodejs.md create mode 100644 translations/zh-CN/content/actions/guides/building-and-testing-python.md create mode 100644 translations/zh-CN/content/actions/guides/caching-dependencies-to-speed-up-workflows.md create mode 100644 translations/zh-CN/content/actions/guides/creating-postgresql-service-containers.md create mode 100644 translations/zh-CN/content/actions/guides/creating-redis-service-containers.md create mode 100644 translations/zh-CN/content/actions/guides/index.md create mode 100644 translations/zh-CN/content/actions/guides/publishing-docker-images.md create mode 100644 translations/zh-CN/content/actions/guides/publishing-java-packages-with-gradle.md create mode 100644 translations/zh-CN/content/actions/guides/publishing-java-packages-with-maven.md create mode 100644 translations/zh-CN/content/actions/guides/publishing-nodejs-packages.md create mode 100644 translations/zh-CN/content/actions/guides/setting-up-continuous-integration-using-workflow-templates.md create mode 100644 translations/zh-CN/content/actions/guides/storing-workflow-data-as-artifacts.md create mode 100644 translations/zh-CN/content/actions/learn-github-actions/essential-features-of-github-actions.md create mode 100644 translations/zh-CN/content/actions/learn-github-actions/finding-and-customizing-actions.md create mode 100644 translations/zh-CN/content/actions/learn-github-actions/index.md create mode 100644 translations/zh-CN/content/actions/learn-github-actions/introduction-to-github-actions.md create mode 100644 translations/zh-CN/content/actions/learn-github-actions/managing-complex-workflows.md create mode 100644 translations/zh-CN/content/actions/learn-github-actions/migrating-from-azure-pipelines-to-github-actions.md create mode 100644 translations/zh-CN/content/actions/learn-github-actions/migrating-from-circleci-to-github-actions.md create mode 100644 translations/zh-CN/content/actions/learn-github-actions/migrating-from-gitlab-cicd-to-github-actions.md create mode 100644 translations/zh-CN/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md create mode 100644 translations/zh-CN/content/actions/learn-github-actions/security-hardening-for-github-actions.md create mode 100644 translations/zh-CN/content/actions/learn-github-actions/sharing-workflows-with-your-organization.md create mode 100644 translations/zh-CN/content/actions/managing-workflow-runs/adding-a-workflow-status-badge.md create mode 100644 translations/zh-CN/content/actions/managing-workflow-runs/canceling-a-workflow.md create mode 100644 translations/zh-CN/content/actions/managing-workflow-runs/deleting-a-workflow-run.md create mode 100644 translations/zh-CN/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md create mode 100644 translations/zh-CN/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md create mode 100644 translations/zh-CN/content/actions/managing-workflow-runs/enabling-debug-logging.md create mode 100644 translations/zh-CN/content/actions/managing-workflow-runs/index.md create mode 100644 translations/zh-CN/content/actions/managing-workflow-runs/manually-running-a-workflow.md create mode 100644 translations/zh-CN/content/actions/managing-workflow-runs/re-running-a-workflow.md create mode 100644 translations/zh-CN/content/actions/managing-workflow-runs/removing-workflow-artifacts.md create mode 100644 translations/zh-CN/content/actions/managing-workflow-runs/using-workflow-run-logs.md create mode 100644 translations/zh-CN/content/actions/managing-workflow-runs/viewing-job-execution-time.md create mode 100644 translations/zh-CN/content/actions/managing-workflow-runs/viewing-workflow-run-history.md create mode 100644 translations/zh-CN/content/actions/quickstart.md create mode 100644 translations/zh-CN/content/actions/reference/authentication-in-a-workflow.md create mode 100644 translations/zh-CN/content/actions/reference/encrypted-secrets.md create mode 100644 translations/zh-CN/content/actions/reference/environment-variables.md create mode 100644 translations/zh-CN/content/actions/reference/specifications-for-github-hosted-runners.md create mode 100644 translations/zh-CN/content/actions/reference/usage-limits-billing-and-administration.md create mode 100644 translations/zh-CN/content/github/administering-a-repository/changing-the-default-branch.md create mode 100644 translations/zh-CN/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md create mode 100644 translations/zh-CN/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md create mode 100644 translations/zh-CN/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md create mode 100644 translations/zh-CN/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md create mode 100644 translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md create mode 100644 translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md create mode 100644 translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository.md create mode 100644 translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md create mode 100644 translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md create mode 100644 translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md create mode 100644 translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md create mode 100644 translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md create mode 100644 translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md create mode 100644 translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md create mode 100644 translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md create mode 100644 translations/zh-CN/content/rest/reference/code-scanning.md create mode 100644 translations/zh-CN/data/reusables/actions/about-artifact-log-retention.md create mode 100644 translations/zh-CN/data/reusables/actions/actions-use-policy-settings.md create mode 100644 translations/zh-CN/data/reusables/actions/allow-specific-actions-intro.md create mode 100644 translations/zh-CN/data/reusables/actions/registry-credentials.md create mode 100644 translations/zh-CN/data/reusables/actions/scheduled-workflows-disabled.md create mode 100644 translations/zh-CN/data/reusables/branches/change-default-branch.md create mode 100644 translations/zh-CN/data/reusables/code-scanning/analyze-go.md create mode 100644 translations/zh-CN/data/reusables/code-scanning/beta-codeql-runner.md create mode 100644 translations/zh-CN/data/reusables/code-scanning/close-alert-examples.md create mode 100644 translations/zh-CN/data/reusables/code-scanning/false-positive-fix-codeql.md create mode 100644 translations/zh-CN/data/reusables/codespaces/about-billing-for-codespaces.md create mode 100644 translations/zh-CN/data/reusables/codespaces/devcontainer-location.md create mode 100644 translations/zh-CN/data/reusables/enterprise_installation/when-9418-necessary.md create mode 100644 translations/zh-CN/data/reusables/gated-features/code-scanning.md create mode 100644 translations/zh-CN/data/reusables/github-actions/artifact-log-retention-statement.md create mode 100644 translations/zh-CN/data/reusables/github-actions/change-retention-period-for-artifacts-logs.md create mode 100644 translations/zh-CN/data/reusables/github-actions/usage-api-requests.md create mode 100644 translations/zh-CN/data/reusables/github-actions/usage-matrix-limits.md create mode 100644 translations/zh-CN/data/reusables/github-actions/usage-workflow-run-time.md create mode 100644 translations/zh-CN/data/reusables/package_registry/authenticate-to-container-registry-steps.md create mode 100644 translations/zh-CN/data/reusables/package_registry/authenticate_with_pat_for_container_registry.md create mode 100644 translations/zh-CN/data/reusables/package_registry/docker_registry_deprecation_status.md create mode 100644 translations/zh-CN/data/reusables/repositories/navigate-to-job-superlinter.md create mode 100644 translations/zh-CN/data/reusables/repositories/navigate-to-workflow-superlinter.md create mode 100644 translations/zh-CN/data/reusables/repositories/view-failed-job-results-superlinter.md create mode 100644 translations/zh-CN/data/reusables/repositories/view-run-superlinter.md create mode 100644 translations/zh-CN/data/reusables/repositories/view-specific-line-superlinter.md create mode 100644 translations/zh-CN/data/reusables/two_fa/about-2fa.md diff --git a/translations/de-DE/content/actions/creating-actions/about-actions.md b/translations/de-DE/content/actions/creating-actions/about-actions.md index c581d8604960..0812f22bbb9f 100644 --- a/translations/de-DE/content/actions/creating-actions/about-actions.md +++ b/translations/de-DE/content/actions/creating-actions/about-actions.md @@ -1,6 +1,6 @@ --- title: Informationen zu Aktionen -intro: 'Aktionen sind einzelne Aufgaben, die Du kombinieren kannst, um Aufträge zu erstellen und Deinen Workflow anzupassen. Sie können eigene Aktionen erstellen oder Aktionen verwenden und anpassen, die von der {% data variables.product.prodname_dotcom %} -Community gemeinsam genutzt werden.' +intro: 'Aktionen sind einzelne Aufgaben, die Du kombinieren kannst, um Aufträge zu erstellen und Deinen Workflow anzupassen. You can create your own actions, or use and customize actions shared by the {% data variables.product.prodname_dotcom %} community.' product: '{% data reusables.gated-features.actions %}' redirect_from: - /articles/about-actions @@ -20,7 +20,8 @@ versions: Zum Erstellen von Aktionen können Sie benutzerdefinierten Code schreiben, der mit Ihrem Repository auf die gewünschte Weise interagiert und sich dabei beispielsweise in die APIs von {% data variables.product.prodname_dotcom %} und in öffentlich zugängliche Drittanbieter-APIs integriert. Mit einer Aktion können Sie beispielsweise npm-Module veröffentlichen, SMS-Nachrichten bei dringenden Problemen senden oder produktionsreifen Code bereitstellen. {% if currentVersion == "free-pro-team@latest" %} -Sie können eigene Aktionen schreiben und ausschließlich in Ihrem Workflow verwenden oder auch Ihre erstellten Aktionen mit der {% data variables.product.prodname_dotcom %}-Community schreiben. Die erstellten Aktionen können nur dann freigegeben werden, wenn das Repository öffentlich ist. +You can write your own actions to use in your workflow or share the actions you build with the +{% data variables.product.prodname_dotcom %} community. Die erstellten Aktionen können nur dann freigegeben werden, wenn das Repository öffentlich ist. {% endif %} Aktionen können direkt auf einem Computer oder in einem Docker-Container laufen. Sie können die Eingabe, die Ausgabe und die Umgebungsvariablen für eine Aktion definieren. @@ -53,42 +54,43 @@ Wenn Sie ein Node.js Projekt entwickeln, bietet das {% data variables.product.pr #### Zusammengesetzte Ausführungsschritte Aktionen -Ein _zusammengesetzten Ausführungsschritte_ Aktion ermöglicht es Ihnen, mehrere Workflowausführungsschritte innerhalb einer Aktion zu kombinieren. Sie können diese Funktion beispielsweise verwenden, um mehrere Ausführungsbefehle in einer Aktion zu bündeln, und dann einen Workflow haben, der die gebündelten Befehle in einem einzigen Schritt mit dieser Aktion ausführt. Um ein Beispiel anzuzeigen, sehen Sie sich "[Erstellen einer zusammengesetzten Ausführungsschritteaktion](/actions/creating-actions/creating-a-composite-run-steps-action)" an. +A _composite run steps_ action allows you to combine multiple workflow run steps within one action. For example, you can use this feature to bundle together multiple run commands into an action, and then have a workflow that executes the bundled commands a single step using that action. To see an example, check out "[Creating a composite run steps action](/actions/creating-actions/creating-a-composite-run-steps-action)". ### Ort für eine Aktion auswählen Wenn Du eine Aktion entwickelst, die von anderen Personen genutzt werden soll, empfehlen wir, die Aktion in ihrem eigenen Repository zu belassen, also nicht mit anderem Anwendungscode zu einem Bundle zusammenzufassen. Damit kannst Du die Aktion wie jede andere Software versionieren, nachverfolgen und veröffentlichen. {% if currentVersion == "free-pro-team@latest" %} -Wenn Du eine Aktion in einem eigenen Repository speicherst, kann die {% data variables.product.prodname_dotcom %}-Community die Aktion eher entdecken. Außerdem wird damit die Codebasis begrenzt, auf die die Entwickler bei der Fehlerbehebung und bei der Erweiterung der Aktion angewiesen sind, und die Versionierung der Aktion wird von der Versionierung des anderen Anwendungscodes getrennt. +Storing an action in its own repository makes it easier for the +{% data variables.product.prodname_dotcom %} community to discover the action, narrows the scope of the code base for developers fixing issues and extending the action, and decouples the action's versioning from the versioning of other application code. {% endif %} -Wenn Du eine Aktion erstellst, die nicht öffentlich zugänglich sein soll, kannst Du die Dateien für die Aktion an einem beliebigen Speicherort in Deinem Repository ablegen. Wenn der Aktions-, der Workflow- und der Anwendungscode in einem einzigen Repository abgelegt werden sollen, empfehlen wir, die Aktionen im Verzeichnis `.github` zu speichern. Beispiel: `.github/actions/action-a` und `.github/actions/action-b`. +{% if currentVersion == "free-pro-team@latest" %}If you're building an action that you don't plan to make available to the public, you {% else %} You{% endif %} can store the action's files in any location in your repository. Wenn der Aktions-, der Workflow- und der Anwendungscode in einem einzigen Repository abgelegt werden sollen, empfehlen wir, die Aktionen im Verzeichnis `.github` zu speichern. Beispiel: `.github/actions/action-a` und `.github/actions/action-b`. -### Kompatibilität mit {% data variables.product.prodname_ghe_server %} +### Compatibility with {% data variables.product.prodname_ghe_server %} -Um sicherzustellen, dass Ihre Aktion mit {% data variables.product.prodname_ghe_server %}kompatibel ist, sollten Sie sicherstellen, dass Sie keine hartcodierten Verweise auf {% data variables.product.prodname_dotcom %} API-URLs verwenden. Sie sollten stattdessen Umgebungsvariablen verwenden, um auf die {% data variables.product.prodname_dotcom %} -API zu verweisen: +To ensure that your action is compatible with {% data variables.product.prodname_ghe_server %}, you should make sure that you do not use any hard-coded references to {% data variables.product.prodname_dotcom %} API URLs. You should instead use environment variables to refer to the {% data variables.product.prodname_dotcom %} API: - Verwenden Sie für die REST-API die `GITHUB_API_URL` -Umgebungsvariable. - Verwenden Sie für GraphQL die Umgebungsvariable `GITHUB_GRAPHQL_URL` . -Weitere Informationen finden Sie unter "[Standardumgebungsvariablen](/actions/configuring-and-managing-workflows/using-environment-variables#default-environment-variables)". +For more information, see "[Default environment variables](/actions/configuring-and-managing-workflows/using-environment-variables#default-environment-variables)." ### Verwenden der Releaseverwaltung für Aktionen -In diesem Abschnitt wird erläutert, wie Sie die Releaseverwaltung verwenden können, um Aktualisierungen auf vorhersehbare Weise an Ihre Aktionen zu verteilen. +This section explains how you can use release management to distribute updates to your actions in a predictable way. #### Bewährte Verfahren für das Release-Management -Wenn Sie eine Aktion für andere Benutzer entwickeln, empfehlen wir die Verwendung der Releaseverwaltung, um zu steuern, wie Sie Updates verteilen. Benutzer können erwarten, dass die Hauptversion einer Aktion die erforderlichen kritischen Korrekturen und Sicherheitspatches enthält, während sie weiterhin mit ihren vorhandenen Workflows kompatibel bleiben. Sie sollten die Veröffentlichung einer neuen Hauptversion in Betracht ziehen, wenn sich Ihre Änderungen auf die Kompatibilität auswirken. +If you're developing an action for other people to use, we recommend using release management to control how you distribute updates. Users can expect an action's major version to include necessary critical fixes and security patches, while still remaining compatible with their existing workflows. You should consider releasing a new major version whenever your changes affect compatibility. -Bei diesem Releaseverwaltungsansatz sollten Benutzer nicht auf den `Master` Zweig einer Aktion verweisen, da dieser wahrscheinlich den neuesten Code enthält und daher möglicherweise instabil ist. Stattdessen können Sie den Benutzern empfehlen, bei der Verwendung Ihrer Aktion eine Hauptversion anzugeben und sie nur dann an eine bestimmte Version weiterzuleiten, wenn Probleme auftreten. +Bei diesem Releaseverwaltungsansatz sollten Benutzer nicht auf den `Master` Zweig einer Aktion verweisen, da dieser wahrscheinlich den neuesten Code enthält und daher möglicherweise instabil ist. Instead, you can recommend that your users specify a major version when using your action, and only direct them to a more specific version if they encounter issues. -Um eine bestimmte Aktionsversion zu verwenden, können Benutzer ihre {% data variables.product.prodname_actions %} Workflow so konfigurieren, dass sie auf ein Tag, die SHA eines Commits oder einen Zweig abzielen, der nach einer Version benannt ist. +To use a specific action version, users can configure their {% data variables.product.prodname_actions %} workflow to target a tag, a commit's SHA, or a branch named for a release. #### Verwenden von Tags für die Releaseverwaltung -Es wird empfohlen, Tags für die Releaseverwaltung von Aktionen zu verwenden. Mit diesem Ansatz können Ihre Benutzer leicht zwischen Haupt- und Nebenversionen unterscheiden: +We recommend using tags for actions release management. Using this approach, your users can easily distinguish between major and minor versions: - Erstellen und überprüfen Sie eine Version auf einem Release-Zweig (z. B. `release/v1`), bevor Sie das Release-Tag erstellen (z. B. `v1.0.2`). - Erstellen Sie eine Version mit semantischer Versionierung. Weitere Informationen finden Sie unter „[Veröffentlichungen erstellen](/articles/creating-releases)“. @@ -96,14 +98,14 @@ Es wird empfohlen, Tags für die Releaseverwaltung von Aktionen zu verwenden. Mi - Führen Sie ein neues Hauptversions-Tag (`v2`) für Änderungen ein, die vorhandene Workflows unterbrechen. Eine störende Änderung liegt beispielsweise vor, wenn die Eingabe einer Aktion geändert wird. - Hauptversionen können zunächst mit einem `Beta-` -Tag veröffentlicht werden, um ihren Status anzugeben, z. B. `v2-beta`. Das `-beta-` -Tag kann dann entfernt werden, wenn es fertig ist. -In diesem Beispiel wird veranschaulicht, wie ein Benutzer auf ein Hauptversions-Tag verweisen kann: +This example demonstrates how a user can reference a major release tag: ```yaml Schritte: - verwendet: actions/javascript-action@v1 ``` -In diesem Beispiel wird veranschaulicht, wie ein Benutzer auf ein bestimmtes Patch-Release-Tag verweisen kann: +This example demonstrates how a user can reference a specific patch release tag: ```yaml Schritte: @@ -112,7 +114,7 @@ Schritte: #### Verwenden von Zweigen für die Releaseverwaltung -Wenn Sie Zweigstellennamen für die Releaseverwaltung verwenden möchten, wird in diesem Beispiel veranschaulicht, wie Sie auf eine benannte Zweigstelle verweisen: +If you prefer to use branch names for release management, this example demonstrates how to reference a named branch: ```yaml Schritte: @@ -121,7 +123,7 @@ Schritte: #### Verwenden des SHA eines Commits für die Releaseverwaltung -Jeder Git-Commit erhält einen berechneten SHA-Wert, der eindeutig und unveränderlich ist. Die Benutzer Ihrer Aktion möchten sich möglicherweise auf den SHA-Wert eines Commits verlassen, da dieser Ansatz zuverlässiger sein kann als die Angabe eines Tags, das gelöscht oder verschoben werden könnte. Dies bedeutet jedoch, dass die Benutzer keine weiteren Aktualisierungen der Aktion erhalten. Die Verwendung des vollständigen SHA-Werts eines Commits anstelle des abgekürzten Werts kann dazu beitragen, dass Personen einen böswilligen Commit verwenden, der dieselbe Abkürzung verwendet. +Each Git commit receives a calculated SHA value, which is unique and immutable. Your action's users might prefer to rely on a commit's SHA value, as this approach can be more reliable than specifying a tag, which could be deleted or moved. However, this means that users will not receive further updates made to the action. Using a commit's full SHA value instead of the abbreviated value can help prevent people from using a malicious commit that uses the same abbreviation. ```yaml Schritte: @@ -141,7 +143,7 @@ Wenn Du Deine Aktion öffentlich bereitstellen möchten, empfehlen wir, eine REA ### Unterschiede zwischen {% data variables.product.prodname_actions %} und {% data variables.product.prodname_github_apps %} -{% data variables.product.prodname_marketplace %} bietet Tools, um Deinen Workflow zu verbessern. Wenn Du die Unterschiede und die Vorteile der einzelnen Tools verstehst, kannst Du das beste Tool für Deinen Auftrag auswählen. Weitere Informationen zum Erstellen von Aktionen und Apps finden Sie unter "[über GitHub-Aktionen](/actions/getting-started-with-github-actions/about-github-actions)" und "[über Apps](/apps/about-apps/)". +{% data variables.product.prodname_marketplace %} bietet Tools, um Deinen Workflow zu verbessern. Wenn Du die Unterschiede und die Vorteile der einzelnen Tools verstehst, kannst Du das beste Tool für Deinen Auftrag auswählen. For more information about building apps, see "[About apps](/apps/about-apps/)." #### Stärken von GitHub Aktionen und GitHub Apps diff --git a/translations/de-DE/content/actions/creating-actions/creating-a-composite-run-steps-action.md b/translations/de-DE/content/actions/creating-actions/creating-a-composite-run-steps-action.md index b14e2a0251ff..a8e127b61a9e 100644 --- a/translations/de-DE/content/actions/creating-actions/creating-a-composite-run-steps-action.md +++ b/translations/de-DE/content/actions/creating-actions/creating-a-composite-run-steps-action.md @@ -18,9 +18,9 @@ Nachdem Sie dieses Projekt abgeschlossen haben, sollten Sie verstehen, wie Sie I ### Vorrausetzungen -Bevor Sie beginnen, erstellen Sie ein {% data variables.product.product_name %} Repository. +Before you begin, you'll create a {% data variables.product.product_name %} repository. -1. Erstellen Sie ein neues öffentliches Repository auf {% data variables.product.product_location %}. Sie können einen beliebigen Repository-Namen auswählen oder die folgenden `hello-world-composite-run-steps-action` Beispiel verwenden. Sie können diese Dateien hinzufügen, nachdem Ihr Projekt per Push an {% data variables.product.product_name %} übergeben wurde. Weitere Informationen finden Sie unter „[Neues Repository erstellen](/articles/creating-a-new-repository)“. +1. Create a new public repository on {% data variables.product.product_location %}. Sie können einen beliebigen Repository-Namen auswählen oder die folgenden `hello-world-composite-run-steps-action` Beispiel verwenden. Du kannst diese Dateien hinzufügen, nachdem Dein Projekt per Push an {% data variables.product.product_name %} übergeben wurde. Weitere Informationen finden Sie unter „[Neues Repository erstellen](/articles/creating-a-new-repository)“. 1. Clone Dein Repository auf Deinen Computer. Weitere Informationen findest Du unter „[Ein Repository clonen](/articles/cloning-a-repository)“. @@ -36,7 +36,7 @@ Bevor Sie beginnen, erstellen Sie ein {% data variables.product.product_name %} echo "Auf Wiedersehen" ``` -1. Machen Sie von Ihrem Terminal aus `goodbye.sh` ausführbare Datei und checken Sie sie in Ihr Repository ein. +3. From your terminal, make `goodbye.sh` executable. ```shell chmod +x goodbye.sh @@ -85,13 +85,26 @@ Bevor Sie beginnen, erstellen Sie ein {% data variables.product.product_name %} Weitere Informationen zur Verwendung von `github.action_path`finden Sie unter "[`github context`](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)". -1. Erstellen Sie eine neue Bezeichnung. In diesem Beispiel wird eine Bezeichnung mit dem Namen `v1` für den Hauptzweig verwendet. Weitere Informationen finden Sie unter "[Erstellen einer Bezeichnung ](/github/managing-your-work-on-github/creating-a-label)." +1. From your terminal, check in your `action.yml` file. + + ```shell + git add action.yml + git commit -m "Add action" + git push + ``` + +1. From your terminal, add a tag. This example uses a tag called `v1`. Weitere Informationen finden Sie unter „[Informationen zu Aktionen](/actions/creating-actions/about-actions#using-release-management-for-actions)“. + + ```shell + git tag -a -m "Description of this release" v1 + git push --follow-tags + ``` ### Deine Aktion in einem Workflow testen Der folgende Workflowcode verwendet die abgeschlossene Hello-World-Aktion, die Sie in "[Erstellen einer Aktionsmetadatendatei](/actions/creating-actions/creating-a-composite-run-steps-action#creating-an-action-metadata-file)" ausgeführt haben. -Kopieren Sie den Workflowcode in eine `.github/workflows/main.yml` Datei in einem anderen Repository, ersetzen Sie jedoch `actions/hello-world-composite-run-steps-action@v1` durch das Repository und die Von Ihnen erstellte Bezeichnung. Darüber hinaus können Sie die Eingabe `who-to-greet` durch Ihren Namen ersetzen. +Copy the workflow code into a `.github/workflows/main.yml` file in another repository, but replace `actions/hello-world-composite-run-steps-action@v1` with the repository and tag you created. Darüber hinaus können Sie die Eingabe `who-to-greet` durch Ihren Namen ersetzen. {% raw %} **.github/workflows/main.yml** diff --git a/translations/de-DE/content/actions/creating-actions/creating-a-docker-container-action.md b/translations/de-DE/content/actions/creating-actions/creating-a-docker-container-action.md index c3f44e9b28b3..c399dd557cc5 100644 --- a/translations/de-DE/content/actions/creating-actions/creating-a-docker-container-action.md +++ b/translations/de-DE/content/actions/creating-actions/creating-a-docker-container-action.md @@ -1,6 +1,6 @@ --- title: Eine Docker-Container-Aktion erstellen -intro: In diesem Leitfaden werden die mindestens erforderlichen Schritte zum Erstellen einer Docker-Container-Aktion beschrieben. +intro: 'In diesem Leitfaden werden die mindestens erforderlichen Schritte zum Erstellen einer Docker-Container-Aktion beschrieben.' product: '{% data reusables.gated-features.actions %}' redirect_from: - /articles/creating-a-docker-container-action diff --git a/translations/de-DE/content/actions/creating-actions/creating-a-javascript-action.md b/translations/de-DE/content/actions/creating-actions/creating-a-javascript-action.md index 5d683d655aef..d97b91537339 100644 --- a/translations/de-DE/content/actions/creating-actions/creating-a-javascript-action.md +++ b/translations/de-DE/content/actions/creating-actions/creating-a-javascript-action.md @@ -33,7 +33,7 @@ Als Erstes müssen Sie die Anwendung Node.js herunterladen und ein GitHub-Reposi https://nodejs.org/de/download/current/ -1. Erstellen Sie ein neues Repository auf {% data variables.product.product_location %}. Du kannst einen beliebigen Repository-Namen auswählen oder wie in diesem Beispiel „hello-world-javascript-action“ verwenden. Sie können diese Dateien hinzufügen, nachdem Ihr Projekt per Push an {% data variables.product.product_name %} übergeben wurde. Weitere Informationen finden Sie unter „[Neues Repository erstellen](/articles/creating-a-new-repository)“. +1. Erstellen Sie ein neues Repository auf {% data variables.product.product_location %}. Du kannst einen beliebigen Repository-Namen auswählen oder wie in diesem Beispiel „hello-world-javascript-action“ verwenden. Du kannst diese Dateien hinzufügen, nachdem Dein Projekt per Push an {% data variables.product.product_name %} übergeben wurde. Weitere Informationen finden Sie unter „[Neues Repository erstellen](/articles/creating-a-new-repository)“. 1. Clone Dein Repository auf Deinen Computer. Weitere Informationen findest Du unter „[Ein Repository clonen](/articles/cloning-a-repository)“. @@ -77,9 +77,9 @@ Diese Datei definiert die Eingabe `who-to-greet` und die Ausgabe `time`. Sie gib Das Toolkit für Aktionen ist eine Node.js-Paketsammlung, mit der Sie JavaScript-Aktionen schnell und konsistenter erstellen können. -Das Toolkit-Paket [`@actions/core`](https://github.com/actions/toolkit/tree/master/packages/core) enthält eine Schnittstelle für die Workflow-Befehle, Eingabe- und Ausgabevariablen, Exit-Status und Debugging-Meldungen. +Das Toolkit-Paket [`@actions/core`](https://github.com/actions/toolkit/tree/main/packages/core) enthält eine Schnittstelle für die Workflow-Befehle, Eingabe- und Ausgabevariablen, Exit-Status und Debugging-Meldungen. -Das Toolkit enthält zudem das Paket [`@actions/github`](https://github.com/actions/toolkit/tree/master/packages/github), das einen authentifizierten Octokit REST-Client und Zugriff auf GitHub Aktions-Kontexte bietet. +Das Toolkit enthält zudem das Paket [`@actions/github`](https://github.com/actions/toolkit/tree/main/packages/github), das einen authentifizierten Octokit REST-Client und Zugriff auf GitHub Aktions-Kontexte bietet. Das Toolkit bietet mehr als die Pakete `core` und `github`. Weitere Informationen findest Du im Repository [actions/toolkit](https://github.com/actions/toolkit). @@ -119,7 +119,7 @@ try { } ``` -Wenn im o. g. `index.js`-Beispiel ein Fehler ausgegeben wird, nutzt `core.setFailed(error.message);` das Aktions-Toolkit-Paket [`@actions/core`](https://github.com/actions/toolkit/tree/master/packages/core), um eine Meldung zu protokollieren und einen Fehler-Exit-Code festzulegen. Weitere Informationen findest Du unter "[Exit Codes für Aktionen setzen](/actions/creating-actions/setting-exit-codes-for-actions)." +Wenn im o. g. `index.js`-Beispiel ein Fehler ausgegeben wird, nutzt `core.setFailed(error.message);` das Aktions-Toolkit-Paket [`@actions/core`](https://github.com/actions/toolkit/tree/main/packages/core), um eine Meldung zu protokollieren und einen Fehler-Exit-Code festzulegen. Weitere Informationen findest Du unter "[Exit Codes für Aktionen setzen](/actions/creating-actions/setting-exit-codes-for-actions)." ### Eine README erstellen @@ -258,4 +258,8 @@ Jobs: Klicke in Deinem Repository auf die Registerkarte **Actions** (Aktionen), und wähle die neueste Workflow-Ausführung aus. Es sollten „Hello Mona the Octocat“ oder der von Dir für die Eingabe `who-to-greet` verwendete Name und der im Protokoll ausgegebene Zeitstempel angezeigt werden. +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +![Ein Screenshot zur Verwendung Deiner Aktion in einem Workflow](/assets/images/help/repository/javascript-action-workflow-run-updated.png) +{% else %} ![Ein Screenshot zur Verwendung Deiner Aktion in einem Workflow](/assets/images/help/repository/javascript-action-workflow-run.png) +{% endif %} \ No newline at end of file diff --git a/translations/de-DE/content/actions/creating-actions/index.md b/translations/de-DE/content/actions/creating-actions/index.md index 1394f3e22e38..edbc1c44fff6 100644 --- a/translations/de-DE/content/actions/creating-actions/index.md +++ b/translations/de-DE/content/actions/creating-actions/index.md @@ -5,7 +5,8 @@ redirect_from: - /articles/building-actions - /github/automating-your-workflow-with-github-actions/building-actions - /actions/automating-your-workflow-with-github-actions/building-actions - - /aktionen/Building-Aktionen + - /actions/building-actions + - /articles/creating-a-github-action/ versions: free-pro-team: '*' enterprise-server: '>=2.22' diff --git a/translations/de-DE/content/actions/creating-actions/metadata-syntax-for-github-actions.md b/translations/de-DE/content/actions/creating-actions/metadata-syntax-for-github-actions.md index 76f6ef1d7cc7..a7da6feb63c6 100644 --- a/translations/de-DE/content/actions/creating-actions/metadata-syntax-for-github-actions.md +++ b/translations/de-DE/content/actions/creating-actions/metadata-syntax-for-github-actions.md @@ -1,7 +1,7 @@ --- title: Metadaten-Syntax für GitHub-Aktionen shortTitle: Metadaten-Syntax -intro: 'Du kannst Aktionen erstellen, um Aufgaben in Ihrem Repository zu erledigen. Für Aktionen ist eine Metadaten-Datei erforderlich, welche die YAML-Syntax verwendet.' +intro: Du kannst Aktionen erstellen, um Aufgaben in Ihrem Repository zu erledigen. Für Aktionen ist eine Metadaten-Datei erforderlich, welche die YAML-Syntax verwendet. product: '{% data reusables.gated-features.actions %}' redirect_from: - /articles/metadata-syntax-for-github-actions @@ -42,7 +42,6 @@ Aktionsmetadatendateien verwenden die YAML-Syntax. Wenn Sie bislang noch nicht m In diesem Beispiel werden zwei Eingaben konfiguriert: „numOctocats“ und „octocatEyeColor“. Die Eingabe „numOctocats“ ist nicht erforderlich und entspricht standardmäßig dem Wert „1“. Die Eingabe „octocatEyeColor“ ist erforderlich und weist keinen Standardwert auf. Workflow-Dateien, die diese Aktion einsetzen, müssen das Stichwort `with` verwenden, um für „octocatEyeColor“ einen Eingabewert festzulegen. Weitere Informationen zu `with`-Syntax finden Sie unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepswith)“. - ```yaml inputs: numOctocats: @@ -54,7 +53,6 @@ inputs: required: true ``` - Wenn Sie eine Eingabe für eine Aktion in einer Workflow-Datei angeben oder einen Standardeingabewert verwenden, erstellt {% data variables.product.prodname_dotcom %} eine Umgebungsvariable für die Eingabe mit dem Namen `INPUT_`. Die erstellte Umgebungsvariable wandelt Eingabenamen in Großbuchstaben um und ersetzt Leerzeichen durch `_`-Zeichen. Wenn beispielsweise ein Workflow die Eingaben „numOctocats“ und „octocatEyeColor“ definiert hat, kann der Aktionscode die Werte für die Eingaben mithilfe der Umgebungsvariablen `INPUT_NUMOCTOCATS` and `INPUT_OCTOCATEYECOLOR` lesen. @@ -99,7 +97,7 @@ outputs: ### **`-Ausgaben`** für Aktionen mit zusammengesetzten Ausführungsschritten -**Optionale** `-Ausgänge verwenden` die gleichen Parameter wie `-Ausgänge.` und `Ausgänge..description` (siehe "[`Ausgaben` für {% data variables.product.prodname_actions %}](/actions/creating-actions/metadata-syntax-for-github-actions#outputs)"), enthält aber auch den `-Wert` Token. +**Optional** `outputs` use the same parameters as `outputs.` and `outputs..description` (see "[`outputs` for {% data variables.product.prodname_actions %}](/actions/creating-actions/metadata-syntax-for-github-actions#outputs)"), but also includes the `value` token. #### Beispiel @@ -121,7 +119,7 @@ läuft: #### **`outputs.`** **Erforderliche** Der Wert, dem der Ausgabeparameter zugeordnet wird. Sie können dies auf eine `Zeichenfolge` oder einen Ausdruck mit Kontext festlegen. Sie können z. B. die `Schritte` Kontext verwenden, um den `Wert` einer Ausgabe auf den Ausgabewert eines Schritts festzulegen. -Weitere Informationen zur Verwendung von Kontext- und Ausdruckssyntax finden Sie unter "[Kontext- und Ausdruckssyntax für {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)". +For more information on how to use context and expression syntax, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)". ### **`runs`** für JavaScript-Aktionen @@ -243,7 +241,7 @@ Weitere Informationen finden Sie unter "[`github context`](/actions/reference/co ##### **`runs.steps.env`** -**Optionale** Legt eine `Zuordnung` von Umgebungsvariablen nur für diesen Schritt fest. Wenn Sie die im Workflow gespeicherte Umgebungsvariable ändern möchten, verwenden Sie `Echo "::set-env name={name}::{value}"` in einem zusammengesetzten Ausführungsschritt. +**Optionale** Legt eine `Zuordnung` von Umgebungsvariablen nur für diesen Schritt fest. If you want to modify the environment variable stored in the workflow, use {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}`echo "{name}={value}" >> $GITHUB_ENV`{% else %}`echo "::set-env name={name}::{value}"`{% endif %} in a composite run step. ##### **`runs.steps.working-directory`** diff --git a/translations/de-DE/content/actions/creating-actions/setting-exit-codes-for-actions.md b/translations/de-DE/content/actions/creating-actions/setting-exit-codes-for-actions.md index 1ad22e5f4153..6d1b3974b91f 100644 --- a/translations/de-DE/content/actions/creating-actions/setting-exit-codes-for-actions.md +++ b/translations/de-DE/content/actions/creating-actions/setting-exit-codes-for-actions.md @@ -24,7 +24,7 @@ versions: ### Fehler-Exit-Code in einer JavaScript-Aktion festlegen -Wenn Sie eine JavaScript-Aktion erstellen, können Sie mit dem Aktions-Toolkit [`@actions/core`](https://github.com/actions/toolkit/tree/master/packages/core) eine Meldung protokollieren und einen Fehler-Exit-Code festlegen. Ein Beispiel: +Wenn Sie eine JavaScript-Aktion erstellen, können Sie mit dem Aktions-Toolkit [`@actions/core`](https://github.com/actions/toolkit/tree/main/packages/core) eine Meldung protokollieren und einen Fehler-Exit-Code festlegen. Ein Beispiel: ```javascript try { diff --git a/translations/de-DE/content/actions/guides/about-continuous-integration.md b/translations/de-DE/content/actions/guides/about-continuous-integration.md new file mode 100644 index 000000000000..93a553fdf4e7 --- /dev/null +++ b/translations/de-DE/content/actions/guides/about-continuous-integration.md @@ -0,0 +1,63 @@ +--- +title: Informationen zur fortlaufenden Integration +intro: 'Sie können benutzerdefinierte Continuous Integration (CI) und Continuous Deployment (CD)-Workflows direkt in Ihrem {% data variables.product.prodname_dotcom %} Repository mit {% data variables.product.prodname_actions %}erstellen.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /articles/about-continuous-integration + - /github/automating-your-workflow-with-github-actions/about-continuous-integration + - /actions/automating-your-workflow-with-github-actions/about-continuous-integration + - /actions/building-and-testing-code-with-continuous-integration/about-continuous-integration +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Informationen zur fortlaufenden Integration + +Bei der Softwarepraktik der fortlaufenden Integration (CI) erfolgen häufige Code-Commits an ein gemeinsames Repository. Code-Commits in kurzen Abständen tragen dazu bei, Fehler frühzeitiger aufzudecken, und verringern die Codemenge, die ein Entwickler auf der Suche nach der Fehlerursache debuggen muss. Durch häufige Code-Aktualisierungen lassen sich zudem Änderungen von verschiedenen Mitgliedern eines Software-Entwicklungsteams leichter zusammenführen. Dies bedeutet einen erheblichen Vorteil für die Entwickler, die sich damit stärker auf das Schreiben des Codes konzentrieren können, statt Fehler debuggen oder Mergekonflikte beheben zu müssen. + +Durch einen Code-Commit an das Repository können Sie den Code fortlaufend erstellen und testen, sodass gewährleistet ist, dass der Commit keine Fehler einbringt. Die Tests können beispielsweise Code-Linters (überprüfen Stilformatierungen), Sicherheitsprüfungen, Code-Abdeckung, Funktionstests und andere benutzerdefinierte Prüfungen umfassen. + +Zum Erstellen und Testen des Codes ist ein Server erforderlich. Sie können Aktualisierungen lokal erstellen und testen, bevor Sie den Code per Push an ein Repository senden, oder auch einen CI-Server heranziehen, der neue Code-Commits in einem Repository prüft. + +### Informationen zur kontinuierlichen Integration mit {% data variables.product.prodname_actions %} + +CI mit {% data variables.product.prodname_actions %} bietet Workflows, die den Code in Ihrem Repository erstellen und Ihre Tests ausführen können. Workflows können auf {% data variables.product.prodname_dotcom %}gehosteten virtuellen Maschinen oder auf Computern ausgeführt werden, die Sie selbst hosten. Weitere Informationen finden Sie unter "[Virtuelle Umgebungen für {% data variables.product.prodname_dotcom %}gehostete Läufer](/actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)" und "[über selbst gehostete Läufer](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)". + +Sie können Ihren CI-Workflow so konfigurieren, dass er ausgeführt wird, wenn ein {% data variables.product.product_name %} Ereignis auftritt (z. B. wenn neuer Code an Ihr Repository übertragen wird), nach einem festgelegten Zeitplan oder wenn ein externes Ereignis mithilfe des Repository-Dispatch-Webhooks auftritt. + +{% data variables.product.product_name %} führt die CI-Tests aus und stellt die Ergebnisse jedes Tests in der Pullanforderung bereit, sodass Sie sehen können, ob die Änderung in Ihrem Zweig einen Fehler verursacht. Sobald alle CI-Tests in einem Workflow bestanden wurden, können die per Push übermittelten Änderungen von einem Teammitglied geprüft oder zusammengeführt werden. Wenn ein Test nicht bestanden wird, liegt die Ursache eventuell in einer Ihrer Änderungen. + +Wenn Sie CI in Ihrem Repository einrichten, analysiert {% data variables.product.product_name %} den Code in Ihrem Repository und empfiehlt CI-Workflows basierend auf der Sprache und dem Framework in Ihrem Repository. Wenn Sie beispielsweise [Node.js](https://nodejs.org/en/)verwenden, schlägt {% data variables.product.product_name %} eine Vorlagendatei vor, die Ihre Node.js-Pakete installiert und Ihre Tests ausführt. Sie können die von {% data variables.product.product_name %}vorgeschlagene CI-Workflowvorlage verwenden, die vorgeschlagene Vorlage anpassen oder eine eigene benutzerdefinierte Workflowdatei zum Ausführen der CI-Tests erstellen. + +![Screenshot mit vorgeschlagenen Vorlagen für die fortlaufende Integration](/assets/images/help/repository/ci-with-actions-template-picker.png) + +Sie können nicht nur ci-Workflows für Ihr Projekt einrichten, sondern auch {% data variables.product.prodname_actions %} verwenden, um Workflows über den gesamten Softwareentwicklungslebenszyklus hinweg zu erstellen. Sie können Ihr Projekt beispielsweise mithilfe von Aktionen bereitstellen, packen oder veröffentlichen. Weitere Informationen finden Sie unter "[über {% data variables.product.prodname_actions %}](/articles/about-github-actions)". + +Eine Definition von gebräuchliche Begriffe finden Sie unter "[Kernkonzepte für {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)". + +### Unterstützte Sprachen + +{% data variables.product.product_name %} bietet CI-Workflowvorlagen für eine Vielzahl von Sprachen und Frameworks. + +Browse the complete list of CI workflow templates offered by {% data variables.product.product_name %} in the {% if currentVersion == "free-pro-team@latest" %}[actions/starter-workflows](https://github.com/actions/starter-workflows/tree/main/ci) repository{% else %} `actions/starter-workflows` repository on {% data variables.product.product_location %}{% endif %}. + +### Benachrichtigungen für Workflow-Läufe + +{% data reusables.repositories.workflow-notifications %} + +### Status-Badges für Workflow-Läufe + +{% data reusables.repositories.actions-workflow-status-badge-into %} + +Weitere Informationen finden Sie unter „[Einen Workflow konfigurieren](/articles/configuring-a-workflow)“. + +### Weiterführende Informationen + +- "[Einrichtung einer kontinuierlichen Integration mit {% data variables.product.prodname_actions %}](/articles/setting-up-continuous-integration-using-github-actions)" +{% if currentVersion == "free-pro-team@latest" %} +- „[Abrechnung für {{ site.data.variables.product.prodname_actions }} verwalten](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)“ +{% endif %} diff --git a/translations/de-DE/content/actions/guides/about-packaging-with-github-actions.md b/translations/de-DE/content/actions/guides/about-packaging-with-github-actions.md new file mode 100644 index 000000000000..fb128bd6d528 --- /dev/null +++ b/translations/de-DE/content/actions/guides/about-packaging-with-github-actions.md @@ -0,0 +1,47 @@ +--- +title: Informationen zum Paketieren mit GitHub-Aktionen +intro: 'In {% data variables.product.prodname_actions %}kannst Du Workflows einrichten, um Pakete zu erstellen und sie zu {% data variables.product.prodname_registry %} oder einem anderen Paket-Hosting-Anbieter hochzuladen.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /actions/automating-your-workflow-with-github-actions/about-packaging-with-github-actions + - /actions/publishing-packages-with-github-actions/about-packaging-with-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Informationen zu Paketierungsschritten + +Die Paket-Erstellung ist ein üblicher Bestandteil des Workflows bei der kontinuierlichen Integration oder bei der kontinuierlichen Auslieferung. Nach dem Erstellen und Testen der Anwendung wird ein lauf- oder bereitstellungsfähiges Artefakt als Paket erstellt. Beispielsweise kann ein Workflow zur kontinuierlichen Integration für ein Java-Projekt `mvn package` ausführen, um eine JAR-Datei zu erstellen. Oder ein CI-Workflow für eine Node.js-Anwendung kann einen Docker-Container erzeugen. + +Je nach Art der Anwendung, die Du erstellst, kann dieses Paket für manuelle Tests lokal heruntergeladen, Benutzern zum Herunterladen zur Verfügung gestellt oder in einer Staging- oder Produktionsumgebung bereitgestellt werden. + +### Paket-Erstellung in Workflows zur kontinuierlichen Integration + +Das Erstellen eines Pakets am Ende eines Workflows zur kontinuierlichen Integration kann während des Code-Reviews bei einem Pull-Request hilfreich sein. Nach dem Erstellen und Testen Deines Codes kann ein Paketierungsschritt ein lauf- oder bereitstellungsfähiges Artefakt erzeugen. Dein Workflow kann dieses Artefakt dann übernehmen und als Teil des Workflows hochladen. + +Wenn Du nun einen Pull-Request überprüfst, kannst Du Dir den Ablauf des Workflows ansehen und das erzeugte Artefakt herunterladen. + +![Dropdown-Menü zum Herunterladen von Artefakten](/assets/images/help/repository/artifact-drop-down.png) + +Dadurch kannst Du den Code im Pull-Request auf Deinem Rechner ausführen, was beim Debuggen oder Testen des Pull-Requests helfen kann. + +### Workflows zum Veröffentlichen von Paketen + +Außer Paket-Artefakte zum Testen in einem Workflow zur kontinuierlichen Integration zum Testen hochzuladen, kannst Du auch Workflows erstellen, die Dein Projekt bauen und Pakete in einer Paket-Registry veröffentlichen. + +* **Publish packages to {% data variables.product.prodname_registry %}** + {% data variables.product.prodname_registry %} can act as a package hosting service for many types of packages. Du kannst Deine Pakete entweder mit allen {% data variables.product.prodname_dotcom %} oder private Pakete nur mit Mitarbeitern oder einer Organisation teilen. Weitere Informationen findest Du unter „[Informationen zu {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/about-github-packages)“. + + You may want to publish packages to {% data variables.product.prodname_registry %} on every push into the default branch. Auf diese Weise können Entwickler in Deinem Projekt immer den neuesten Build aus Master ausführen und testen, indem sie ihn von {% data variables.product.prodname_registry %} installieren. + +* **Pakete in einer Paket-Registry veröffentlichen** Bei vielen Projekten werden neue Versionen immer in einer Paket-Registry veröffentlicht. Beispielsweise kann ein Projekt, das eine JAR-Datei erstellt, neue Versionen in das Zentral-Repository von Maven hochladen. Oder ein .NET-Projekt kann ein NuGet-Paket erzeugen und es in die NuGet-Galerie hochladen. + + Du kannst dies automatisieren, indem Du einen Workflow erstellst, der bei jeder Release-Erstellung Pakete in einer Paket-Registry veröffentlicht. Weitere Informationen findest Du unter „[Releases erstellen](/github/administering-a-repository/creating-releases)“. + +### Weiterführende Informationen + +- „[Node.js-Pakete veröffentlichen](/actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages)“ diff --git a/translations/de-DE/content/actions/guides/about-service-containers.md b/translations/de-DE/content/actions/guides/about-service-containers.md new file mode 100644 index 000000000000..5c98fde1e6c3 --- /dev/null +++ b/translations/de-DE/content/actions/guides/about-service-containers.md @@ -0,0 +1,117 @@ +--- +title: Informationen zu Service-Containern +intro: 'Du kannst Service-Container verwenden, um Datenbanken, Webdienste, Speicher-Caches und andere Tools mit Deinem Workflow zu verbinden.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /actions/automating-your-workflow-with-github-actions/about-service-containers + - /actions/configuring-and-managing-workflows/about-service-containers +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Informationen zu Service-Containern + +Service-Container sind Docker-Container, die Dir eine einfache und portable Möglichkeit bieten, Dienste zu hosten, um Deine Anwendung in einem Workflow zu testen oder zu betreiben. Beispielsweise muss Dein Workflow möglicherweise Integrationstests ausführen, die Zugriff auf eine Datenbank und einen Speicher-Cache erfordern. + +Du kannst Service-Container für jeden Job in einem Workflow konfigurieren. Für jeden Service, der im Workflow konfiguriert ist, erstellt {% data variables.product.prodname_dotcom %} einen neuen Docker-Container und löscht den Service Container, wenn der Auftrag abgeschlossen ist. Steps (Schritte) in einem Job können mit allen Service-Containern kommunizieren, die Teil des gleichen Jobs sind. + +{% data reusables.github-actions.docker-container-os-support %} + +### Mit Service-Containern kommunizieren + +Du kannst Jobs in einem Workflow so konfigurieren, dass sie direkt auf einer Runner-Maschine oder in einem Docker-Container laufen. Die Kommunikation zwischen einem Job und seinen Service-Containern ist unterscherschiedlich, je nachdem, ob ein Job direkt auf der Runner-Maschine oder in einem Container läuft. + +#### Jobs in einem Container ausführen + +Wenn Du Jobs in einem Container ausführst, verbindet {% data variables.product.prodname_dotcom %} die Service-Container mit dem Job über die benutzerdefinierten Bridge-Netzwerke von Docker. Weitere Informationen findest Du unter "[Bridge-Netzwerke verwenden](https://docs.docker.com/network/bridge/)" in der Docker-Dokumentation. + +Jobs und der Services in einem Container laufen zu lassen, vereinfacht den Netzwerkzugriff. Du kannst auf einen Service-Container mittels des Labels (Bezeichnung) zugreifen, den Du im Workflow konfigurierst. Der Hostname des Service-Containers wird automatisch dem Labelnamen zugeordnet. Wenn Du z.B. einen Service-Container mit der Bezeichnung `Redis` erstellst, ist auch der Hostname des Service-Containers `Redis`. + +Du brauchst für Service-Container keine Ports zu konfigurieren. Standardmäßig machen alle Container, die Teil desselben Docker-Netzwerks sind, alle Ports füreinander verfügbar, und außerhalb des Docker-Netzwerks werden keine Ports verfügbar gemacht. + +#### Jobs auf der Runner-Maschine ausführen + +Wenn Du Jobs direkt auf der Runner-Maschine ausführst, kannst Du auf Service-Container mit `localhost:` oder `127.0.0.1:` zugreifen. {% data variables.product.prodname_dotcom %} konfiguriert das Container-Netzwerk, um die Kommunikation vom Service-Container zum Docker-Host zu ermöglichen. + +Wenn ein Job direkt auf einer Runner-Maschine läuft, macht der im Docker-Container laufende Dienst seine Ports nicht standardmäßig dem Job auf dem Runner verfügbar. Du musst Ports auf dem Service-Container dem Docker Host zuordnen. Weitere Informationen findest Du unter "[Ports auf Docker-Host und Service-Container zuordnen](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)." + +### Service-Container erstellen + +Du kannst das Schlüsselwort `Services` verwenden, um Service-Container zu erstellen, die Teil eines Jobs in Deinem Workflow sind. Weitere Informationen findest Du unter [`jobs..services`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idservices). + +Dieses Beispiel erstellt einen Dienst namens `redis` in einem Job namens `container-job`. Der Docker-Host in diesem Beispiel ist der Container `node:10.18-jessie`. + +{% raw %} +```yaml +name: Redis container example +on: push + +jobs: + # Label des Container-Jobs + container-job: + # Container müssen in Linux-basierten Betriebssystemen laufen + runs-on: ubuntu-latest + # Docker-Hub-Image in dem `container-job` laeuft + container: node:10.18-jessie + + # Service-Container, mit denen `container-job` laeuft + services: + # Label zum Zugriff auf den Service--Container + redis: + # Docker-Hub-Image + image: redis +``` +{% endraw %} + +### Ports von Docker-Host und Service-Container zuordnen + +Wenn Dein Job in einem Docker-Container läuft, brauchst Du keine Ports auf dem Host oder dem Service-Container zuzuordnen. Wenn Dein Job direkt auf der Runner-Maschine läuft, musst Du alle benötigten Service-Container-Ports zu Ports der Host-Runner-Maschine zuordnen. + +Du kannst Service-Container-Ports mit Hilfe des Schlüsseworts `ports` dem Docker-Host zuordnen. Weitere Informationen findest Du unter [`jobs..services`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idservices). + +| Wert von `ports` | Beschreibung | +| ---------------- | ----------------------------------------------------------------------------------------------- | +| `8080:80` | Ordnet TCP-Port 80 im Container dem Port 8080 auf dem Docker-Host zu. | +| `8080:80/udp` | Ordnet UDP-Port 80 im Container dem Port 8080 auf dem Docker-Host zu. | +| `8080/udp` | Ordnet einen zufällig gewählten UDP-Port im Container dem UDP-Port 8080 auf dem Docker-Host zu. | + +Wenn Du Ports mittels `ports` zuordnest, publiziert {% data variables.product.prodname_dotcom %} die Ports des Containers auf dem Docker-Host mit dem Befehl `--publish`. Weitere Informationen findest Du unter "[Vernetzung von Docker-Containern](https://docs.docker.com/config/containers/container-networking/)" in der Docker Dokumentation. + +Wenn Du den Port des Docker-Hosts angibst, aber nicht den des Containers, dann wird der Container-Port zufällig einem freien Port zugewiesen. {% data variables.product.prodname_dotcom %} setzt den zugewiesenen Container-Port im Kontext des Service-Containers. Wenn Du beispielsweise den Port 5432 für den Docker-Host konfiguriert hast, kannst Du für einen Service Container `redis` mit dem Kontext code>job.services.redis.ports[5432] auf den entsprechenden Port des Containers zugreifen. Weitere Informationen findest Du unter "[Kontext- und Ausdrucks-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions#job-context)." + +#### Beispiel zur Zuordnung von Redis-Ports + +Dieses Beispiel ordnet den Port 6379 des Service-Containers `redis` dem Port 6379 des Docker-Hosts zu. + +{% raw %} +```yaml +name: Redis Service Example +on: push + +jobs: + # Label des Container-Jobs + runner-job: + # Fuer Service-Containers oder Container-Jobs musst Du eine Linux-Umgebung benutzen + runs-on: ubuntu-latest + + # Service-Container, die mit `runner-job` laufen sollen + services: + # Label zum Zugriff auf den Service-Container + redis: + # Docker-Hub-Image + image: redis + # + ports: + # Oeffnet TCP-Port 6379 auf dem Host und Service-Container + - 6379:6379 +``` +{% endraw %} + +### Weiterführende Informationen + +- "[Redis-Service-Container erstellen](/actions/automating-your-workflow-with-github-actions/creating-redis-service-containers)" +- "[PostgreSQL-Service-Container erstellen](/actions/automating-your-workflow-with-github-actions/creating-postgresql-service-containers)" diff --git a/translations/de-DE/content/actions/guides/building-and-testing-java-with-ant.md b/translations/de-DE/content/actions/guides/building-and-testing-java-with-ant.md new file mode 100644 index 000000000000..dce32aa29859 --- /dev/null +++ b/translations/de-DE/content/actions/guides/building-and-testing-java-with-ant.md @@ -0,0 +1,109 @@ +--- +title: Java bauen und testen mit Ant +intro: Du kannst einen Workflow für kontinuierliche Integration (CI) in GitHub-Aktionen erstellen, um Dein Java-Projekt mit Ant zu bauen und zu testen. +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /actions/language-and-framework-guides/building-and-testing-java-with-ant +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Einführung + +Dieser Leitfaden zeigt Dir, wie Du einen Workflow erstellen kannst, der eine kontinuierliche Integration (CI) für Dein Java-Projekt mit Hilfe des Build-Systems Ant durchführt. Der Workflow, den Du erstellst, zeigt Dir, wenn Commits zu einem Pull-Request zu Build- oder Testfehlern für deinen Standard-Zweig führen. Dieser Ansatz kann dazu beitragen, dass Dein Code immer brauchbar ist. Du kannst Deinen CI-Workflow so erweitern, dass er Artefakte von einem Workflow-Lauf hochlädt. + +{% data variables.product.prodname_dotcom %}-gehostete Runnner haben einen Tools-Cache mit vorinstallierter Software, einschließlich Java Development Kits (JDKs) und Ant. For a list of software and the pre-installed versions for JDK and Ant, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". + +### Vorrausetzungen + +Du solltest mit YAML und der Syntax für {% data variables.product.prodname_actions %} vertraut sein. Weitere Informationen findest Du unter: +- „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)“ +- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)" + +Du solltest ein grundlegendes Verständnis von Java und dem Framework Ant haben. Weitere Informationen findest Du im [Handbuch zu Apache Ant](https://ant.apache.org/manual/). + +{% data reusables.actions.enterprise-setup-prereq %} + +### Einstieg mit einer Ant-Workflow-Vorlage + +{% data variables.product.prodname_dotcom %} bietet eine Ant-Workflow-Vorlage, die für die meisten Ant-basierten Java-Projekte funktionieren wird. For more information, see the [Ant workflow template](https://github.com/actions/starter-workflows/blob/main/ci/ant.yml). + +Um schnell loszulegen, kannst Du beim Erstellen eines neuen Workflows die vorkonfigurierte Ant-Vorlage auswählen. For more information, see the "[{% data variables.product.prodname_actions %} quickstart](/actions/quickstart)." + +Du kannst auch manuell diesen Workflow hinzufügen, indem Du eine neue Datei im Verzeichnis `.github/workflows` Deines Reporitorys erstellst. + +{% raw %} +```yaml +name: Java CI + +on: [push] + +jobs: + build: + runs-on: ubuntu-latest + + steps: + - uses: actions/checkout@v2 + - name: Set up JDK 1.8 + uses: actions/setup-java@v1 + with: + java-version: 1.8 + - name: Build with Ant + run: ant -noinput -buildfile build.xml +``` +{% endraw %} + +Dieser Workflow führt die folgenden Schritte aus: + +1. Der Schritt `checkout` lädt eine Kopie Deines Repositorys auf den Runner herunter. +2. Der Schritt `setup-java` konfiguriert das Java 1.8 JDK. +3. Der Schritt „Build with Ant“ (mittels Ant bauen) führt das standardmäßige „Target“ (Ziel) in Deiner `build.xml` im nicht-interaktiven Modus aus. + +Die Standard-Workflow-Vorlagen sind ausgezeichnete Ausgangspunkte beim Erstellen des Build- und Testworkflows, und Du kannst die Vorlage an die Anforderungen Deines Projekts anpassen. + +{% data reusables.github-actions.example-github-runner %} + +{% data reusables.github-actions.java-jvm-architecture %} + +### Deinen Code bauen und testen + +Du kannst die gleichen Befehle verwenden, die Du auch lokal verwendest, um Deinen Code zu erstellen und zu testen. + +Der Starter-Workflow führt das in der Datei _build.xml_ angegebene „default target“ (Standardziel) aus. Dein Standard-Ziel wird normalerweise eingestellt, um Klassen zu bauen, Tests durchzuführen und Klassen in ihr verteilbares Format (z.B . eine JAR-Datei) zu paketieren. + +Wenn Du zum Bauen Deines Projekts andere Befehle verwenden oder ein anderes Ziel auszuführen möchtest, kannst Du dies angeben. Vielleicht möchtest Du beispielsweise das Ziel `jar` ausführen, das in Deiner Datei _build-ci.xml_ konfiguriert ist. + +{% raw %} +```yaml +steps: + - uses: actions/checkout@v2 + - uses: actions/setup-java@v1 + with: + java-version: 1.8 + - name: Run the Ant jar target + run: ant -noinput -buildfile build-ci.xml jar +``` +{% endraw %} + +### Workflow-Daten als Artefakte paketieren + +Nachdem sowohl Build erfolgreich war und Deine Tests bestanden hat, wirst Du die resultierenden Java-Pakete als Build-Artefakt hochladen wollen. Dies speichert die gebauten Pakete als Teil der Workflow-Ausführung und ermöglicht Dir, sie herunterzuladen. Artefakte können Dir helfen, Pull-Requests in Deiner lokalen Umgebung zu testen und zu debuggen, bevor sie zusammengeführt werden („merge“). Weitere Informationen findest Du unter „[Workflow-Daten mittels Artefakten persistieren](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)“. + +Ant erstellt normalerweise Ausgabedateien wie JARs, EARs oder WARs im Verzeichnis `build/jar`. Du kannst den Inhalt dieses Verzeichnisses mit der Aktion `upload-artifact` hochladen. + +{% raw %} +```yaml +steps: + - uses: actions/checkout@v2 + - uses: actions/setup-java@v1 + - run: ant -noinput -buildfile build.xml + - uses: actions/upload-artifact@v2 + with: + name: Package + path: build/jar +``` +{% endraw %} diff --git a/translations/de-DE/content/actions/guides/building-and-testing-java-with-gradle.md b/translations/de-DE/content/actions/guides/building-and-testing-java-with-gradle.md new file mode 100644 index 000000000000..04ab50478378 --- /dev/null +++ b/translations/de-DE/content/actions/guides/building-and-testing-java-with-gradle.md @@ -0,0 +1,134 @@ +--- +title: Java bauen und testen mit Gradle +intro: Du kannst einen Workflow für kontinuierliche Integration (CI) in GitHub-Aktionen erstellen, um Dein Java-Projekt mit Gradle zu bauen und zu testen. +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /actions/language-and-framework-guides/building-and-testing-java-with-gradle +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Einführung + +Dieser Leitfaden zeigt Dir, wie Du einen Workflow erstellen kannst, der eine kontinuierliche Integration (CI) für Dein Java-Projekt mit Hilfe des Build-Systems Gradle durchführt. Der Workflow, den Du erstellst, zeigt Dir, wenn Commits zu einem Pull-Request zu Build- oder Testfehlern für deinen Standard-Zweig führen. Dieser Ansatz kann dazu beitragen, dass Dein Code immer brauchbar ist. Du kannst Deinen CI-Workflow so erweitern, dass er Dateien im Cache zwischenspeichert und Artefakte von einem Workflow-Lauf hochlädt. + +{% data variables.product.prodname_dotcom %}-gehostete Runnner haben einen Tools-Cache mit vorinstallierter Software, einschließlich Java Development Kits (JDKs) und Gradle. For a list of software and the pre-installed versions for JDK and Gradle, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". + +### Vorrausetzungen + +Du solltest mit YAML und der Syntax für {% data variables.product.prodname_actions %} vertraut sein. Weitere Informationen findest Du unter: +- „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)“ +- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)" + +Du solltest ein grundlegendes Verständnis von Java und dem Framework Gradle haben. Weitere Informationen findest Du unter [Erste Schritte](https://docs.gradle.org/current/userguide/getting_started.html) in der Gradle-Dokumentation. + +{% data reusables.actions.enterprise-setup-prereq %} + +### Einstieg mit einer Gradle-Workflow-Vorlage + +{% data variables.product.prodname_dotcom %} bietet eine Gradle-Workflow-Vorlage, die für die meisten Gradle-basierten Java-Projekte funktionieren wird. For more information, see the [Gradle workflow template](https://github.com/actions/starter-workflows/blob/main/ci/gradle.yml). + +Um schnell loszulegen, kannst Du beim Erstellen eines neuen Workflows die vorkonfigurierte Gradle-Vorlage auswählen. For more information, see the "[{% data variables.product.prodname_actions %} quickstart](/actions/quickstart)." + +Du kannst auch manuell diesen Workflow hinzufügen, indem Du eine neue Datei im Verzeichnis `.github/workflows` Deines Reporitorys erstellst. + +{% raw %} +```yaml +name: Java CI + +on: [push] + +jobs: + build: + runs-on: ubuntu-latest + + steps: + - uses: actions/checkout@v2 + - name: Set up JDK 1.8 + uses: actions/setup-java@v1 + with: + java-version: 1.8 + - name: Build with Gradle + run: ./gradlew build +``` +{% endraw %} + +Dieser Workflow führt die folgenden Schritte aus: + +1. Der Schritt `checkout` lädt eine Kopie Deines Repositorys auf den Runner herunter. +2. Der Schritt `setup-java` konfiguriert das Java 1.8 JDK. +3. Der Schritt "Build with Gradle" führt das Wrapper-Skript `gradlew` aus, um sicherzustellen, dass dein Code gebaut, Tests bestanden und ein Paket erstellt werden kann. + +Die Standard-Workflow-Vorlagen sind ausgezeichnete Ausgangspunkte beim Erstellen des Build- und Testworkflows, und Du kannst die Vorlage an die Anforderungen Deines Projekts anpassen. + +{% data reusables.github-actions.example-github-runner %} + +{% data reusables.github-actions.java-jvm-architecture %} + +### Deinen Code bauen und testen + +Du kannst die gleichen Befehle verwenden, die Du auch lokal verwendest, um Deinen Code zu erstellen und zu testen. + +Der Starter-Workflow führt standardmäßig den Task `build` aus. In der Standard-Gradle-Konfiguration lädt dieser Befehl Abhängigkeiten herunter, baut Klassen, führt Tests durch und paketiert Klassen in ihr verteilbares Format, zum Beispiel eine JAR-Datei. + +Wenn Du zum Bauen Deines Projekts andere Befehle verwenden oder einen anderen Task auszuführen möchtest, kannst Du dies angeben. Vielleicht möchtest Du beispielsweise den Task `package` ausführen, der in Deiner Datei _ci.gradle_ konfiguriert ist. + +{% raw %} +```yaml +steps: + - uses: actions/checkout@v2 + - uses: actions/setup-java@v1 + with: + java-version: 1.8 + - name: Run the Gradle package task + run: ./gradlew -b ci.gradle package +``` +{% endraw %} + +### Abhängigkeiten „cachen“ (zwischenspeichern) + +Du kannst Deine Abhängigkeiten zwischenspeichern, um die Workflow-Ausführungen zu beschleunigen. Nach einem erfolgreichen Lauf wird Dein lokaler Paket-Cache von Gradle in der Aktions-Infrastruktur auf GitHub gespeichert. Bei zukünftigen Workflow-Ausführungen wird der Cache wiederhergestellt, so dass Abhängigkeiten nicht aus entfernten Paket-Repositories heruntergeladen werden müssen. Weitere Informationen findest Du unter „[Caching-Abhängigkeiten zur Beschleunigung von Workflows](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)“ und der [Aktion `cache`](https://github.com/marketplace/actions/cache). + +{% raw %} +```yaml +steps: + - uses: actions/checkout@v2 + - name: Set up JDK 1.8 + uses: actions/setup-java@v1 + with: + java-version: 1.8 + - name: Cache Gradle packages + uses: actions/cache@v2 + with: + path: ~/.gradle/caches + key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle') }} + restore-keys: ${{ runner.os }}-gradle + - name: Build with Gradle + run: ./gradlew build +``` +{% endraw %} + +Dieser Workflow speichert den Inhalt Deines lokalen Gradle-Package-Caches im Verzeichnis `.gradle/caches` des Home-Verzeichnisses auf dem Runner. Der Cache-Schlüssel wird der gehashte Inhalt der Gradle-Build-Dateien sein, so dass Änderungen an ihnen den Cache ungültig machen. + +### Workflow-Daten als Artefakte paketieren + +Nachdem sowohl Build erfolgreich war und Deine Tests bestanden hat, wirst Du die resultierenden Java-Pakete als Build-Artefakt hochladen wollen. Dies speichert die gebauten Pakete als Teil der Workflow-Ausführung und ermöglicht Dir, sie herunterzuladen. Artefakte können Dir helfen, Pull-Requests in Deiner lokalen Umgebung zu testen und zu debuggen, bevor sie zusammengeführt werden („merge“). Weitere Informationen findest Du unter „[Workflow-Daten mittels Artefakten persistieren](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)“. + +Gradle erstellt normalerweise Ausgabedateien wie JARs, EARs oder WARs im Verzeichnis `build/libs`. Du kannst den Inhalt dieses Verzeichnisses mit der Aktion `upload-artifact` hochladen. + +{% raw %} +```yaml +steps: + - uses: actions/checkout@v2 + - uses: actions/setup-java@v1 + - run: ./gradlew build + - uses: actions/upload-artifact@v2 + with: + name: Package + path: build/libs +``` +{% endraw %} diff --git a/translations/de-DE/content/actions/guides/building-and-testing-java-with-maven.md b/translations/de-DE/content/actions/guides/building-and-testing-java-with-maven.md new file mode 100644 index 000000000000..15f2f8d495b5 --- /dev/null +++ b/translations/de-DE/content/actions/guides/building-and-testing-java-with-maven.md @@ -0,0 +1,135 @@ +--- +title: Java bauen und testen mit Maven +intro: Du kannst einen Workflow für kontinuierliche Integration (CI) in GitHub-Aktionen erstellen, um Dein Java-Projekt mit Maven zu bauen und zu testen. +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /actions/language-and-framework-guides/building-and-testing-java-with-maven +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Einführung + +Dieser Leitfaden zeigt Dir, wie Du einen Workflow erstellen kannst, der eine kontinuierliche Integration (CI) für Dein Java-Projekt mit Hilfe des Software-Projektmanagement-Tools Maven durchführt. Der Workflow, den Du erstellst, zeigt Dir, wenn Commits zu einem Pull-Request zu Build- oder Testfehlern für deinen Standard-Zweig führen. Dieser Ansatz kann dazu beitragen, dass Dein Code immer brauchbar ist. Du kannst Deinen CI-Workflow so erweitern, dass er Dateien im Cache zwischenspeichert und Artefakte von einem Workflow-Lauf hochlädt. + +{% data variables.product.prodname_dotcom %}-gehostete Runnner haben einen Tools-Cache mit vorinstallierter Software, einschließlich Java Development Kits (JDKs) und Maven. For a list of software and the pre-installed versions for JDK and Maven, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". + +### Vorrausetzungen + +Du solltest mit YAML und der Syntax für {% data variables.product.prodname_actions %} vertraut sein. Weitere Informationen findest Du unter: +- „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)“ +- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)" + +Du solltest ein grundlegendes Verständnis von Java und dem Framework Maven haben. Weitere Informationen findest Du in der [Anleitung für erste Schritte mit Maven](http://maven.apache.org/guides/getting-started/index.html) in der Maven-Dokumentation. + +{% data reusables.actions.enterprise-setup-prereq %} + +### Einstieg mit einer Maven-Workflow-Vorlage + +{% data variables.product.prodname_dotcom %} bietet eine Maven-Workflow-Vorlage, die für die meisten Maven-basierten Java-Projekte funktionieren wird. Weitere Informationen findest Du im [Workflow-Template für Maven](https://github.com/actions/starter-workflows/blob/main/ci/maven.yml). + +Um schnell loszulegen, kannst Du beim Erstellen eines neuen Workflows die vorkonfigurierte Maven-Vorlage auswählen. For more information, see the "[{% data variables.product.prodname_actions %} quickstart](/actions/quickstart)." + +Du kannst auch manuell diesen Workflow hinzufügen, indem Du eine neue Datei im Verzeichnis `.github/workflows` Deines Reporitorys erstellst. + +{% raw %} +```yaml +name: Java CI + +on: [push] + +jobs: + build: + runs-on: ubuntu-latest + + steps: + - uses: actions/checkout@v2 + - name: Set up JDK 1.8 + uses: actions/setup-java@v1 + with: + java-version: 1.8 + - name: Build with Maven + run: mvn -B package --file pom.xml +``` +{% endraw %} + +Dieser Workflow führt die folgenden Schritte aus: + +1. Der Schritt `checkout` lädt eine Kopie Deines Repositorys auf den Runner herunter. +2. Der Schritt `setup-java` konfiguriert das Java 1.8 JDK. +3. Der Schritt "Build with Maven" führt das Maven-„Target“ (Ziel) `package` im nicht-interaktiven Modus aus, um sicherzustellen, dass der Code gebaut, Tests bestanden und ein Paket erstellt werden kann. + +Die Standard-Workflow-Vorlagen sind ausgezeichnete Ausgangspunkte beim Erstellen des Build- und Testworkflows, und Du kannst die Vorlage an die Anforderungen Deines Projekts anpassen. + +{% data reusables.github-actions.example-github-runner %} + +{% data reusables.github-actions.java-jvm-architecture %} + +### Deinen Code bauen und testen + +Du kannst die gleichen Befehle verwenden, die Du auch lokal verwendest, um Deinen Code zu erstellen und zu testen. + +Der Starter-Workflow führt standardmäßig das „target“ (Ziel) `package` aus. In der Standard-Maven-Konfiguration lädt dieser Befehl Abhängigkeiten herunter, baut Klassen, führt Tests durch und paketiert Klassen in ihr verteilbares Format, zum Beispiel eine JAR-Datei. + +Wenn Du zum Bauen Deines Projekts andere Befehle verwenden oder ein anderes Ziel auszuführen möchtest, kannst Du dies angeben. Vielleicht möchtest Du beispielsweise das Ziel `verify` ausführen, das in Deiner Datei _pom-ci.xml_ konfiguriert ist. + +{% raw %} +```yaml +steps: + - uses: actions/checkout@v2 + - uses: actions/setup-java@v1 + with: + java-version: 1.8 + - name: Run the Maven verify phase + run: mvn -B verify --file pom-ci.xml +``` +{% endraw %} + +### Abhängigkeiten „cachen“ (zwischenspeichern) + +Du kannst Deine Abhängigkeiten zwischenspeichern, um die Workflow-Ausführungen zu beschleunigen. Nach einem erfolgreichen Lauf wird Dein lokales Maven-Repository in der Aktions-Infrastruktur auf GitHub gespeichert. Bei zukünftigen Workflow-Ausführungen wird der Cache wiederhergestellt, so dass Abhängigkeiten nicht aus entfernten Maven-Repositories heruntergeladen werden müssen. Weitere Informationen findest Du unter „[Caching-Abhängigkeiten zur Beschleunigung von Workflows](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)“ und der [Aktion `cache`](https://github.com/marketplace/actions/cache). + +{% raw %} +```yaml +steps: + - uses: actions/checkout@v2 + - name: Set up JDK 1.8 + uses: actions/setup-java@v1 + with: + java-version: 1.8 + - name: Cache Maven packages + uses: actions/cache@v2 + with: + path: ~/.m2 + key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }} + restore-keys: ${{ runner.os }}-m2 + - name: Build with Maven + run: mvn -B package --file pom.xml +``` +{% endraw %} + +Dieser Workflow speichert den Inhalt Deines lokalen Maven-Repositiorys im Verzeichnis `.m2` des Home-Verzeichnisses auf dem Runner. Der Cache-Schlüssel wird der gehashte Inhalt von _pom.xml_sein, so dass Änderungen an _pom.xml_ den Cache ungültig machen. + +### Workflow-Daten als Artefakte paketieren + +Nachdem sowohl Build erfolgreich war und Deine Tests bestanden hat, wirst Du die resultierenden Java-Pakete als Build-Artefakt hochladen wollen. Dies speichert die gebauten Pakete als Teil der Workflow-Ausführung und ermöglicht Dir, sie herunterzuladen. Artefakte können Dir helfen, Pull-Requests in Deiner lokalen Umgebung zu testen und zu debuggen, bevor sie zusammengeführt werden („merge“). Weitere Informationen findest Du unter „[Workflow-Daten mittels Artefakten persistieren](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)“. + +Maven erstellt normalerweise Ausgabedateien wie JARs, EARs oder WARs im Verzeichnis `target`. Um diese als Artefakte hochzuladen, kannst du sie in ein neues Verzeichnis kopieren, welches Artefakte zum Hochladen enthält. Zum Beispiel kannst Du ein Verzeichnis namens `staging` erstellen. Dann kannst Du den Inhalt dieses Verzeichnisses mit der Aktion `upload-artifact` hochladen. + +{% raw %} +```yaml +steps: + - uses: actions/checkout@v2 + - uses: actions/setup-java@v1 + - run: mvn -B package --file pom.xml + - run: mkdir staging && cp target/*.jar staging + - uses: actions/upload-artifact@v2 + with: + name: Package + path: staging +``` +{% endraw %} diff --git a/translations/de-DE/content/actions/guides/building-and-testing-nodejs.md b/translations/de-DE/content/actions/guides/building-and-testing-nodejs.md new file mode 100644 index 000000000000..d3d0625e64c0 --- /dev/null +++ b/translations/de-DE/content/actions/guides/building-and-testing-nodejs.md @@ -0,0 +1,276 @@ +--- +title: Building and testing Node.js +intro: Du kannst einen Workflow für kontinuierliche Integration (CI) erstellen, um Dein Node.js-Projekt zu bauen und zu testen. +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions + - /actions/language-and-framework-guides/using-nodejs-with-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Einführung + +Diese Anleitung zeigt Dir, wie Du einen Workflow für fortlaufende Integration (CI) erstellen kannst, der Node.js-Code baut und testet. Wenn Deine CI-Tests erfolgreich durchlaufen, kannst Du Deinen Code deployen (bereitstellen) oder ein Paket veröffentlichen. + +### Vorrausetzungen + +Wir empfehlen, dass Du ein grundlegendes Verständnis von Node.js, YAML, Workflowkonfigurations-Optionen und die Erstellung einer Workflow-Datei hast. Weitere Informationen findest Du unter: + +- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)" +- "[Getting started with Node.js](https://nodejs.org/en/docs/guides/getting-started-guide/)" + +{% data reusables.actions.enterprise-setup-prereq %} + +### Einstieg mit einer Node.js-Workflow-Vorlage + +{% data variables.product.prodname_dotcom %} bietet eine Node.js-Workflow-Vorlage, die für die meisten Node.js-basierten Projekte funktionieren wird. Diese Anleitung enthält npm und Yarn Beispiele, mit denen Du die Vorlage anpassen kannst. Weitere Informationen findest Du in der [Node.js-Workflow-Vorlage](https://github.com/actions/starter-workflows/blob/main/ci/node.js.yml). + +Um schnell loszulegen, füge die Vorlage in das Verzeichnis `.github/workflows` Deines Repositorys ein. + +{% raw %} +```yaml +name: Node.js CI + +on: [push] + +jobs: + build: + + runs-on: ubuntu-latest + + strategy: + matrix: + node-version: [8.x, 10.x, 12.x] + + steps: + - uses: actions/checkout@v2 + - name: Use Node.js ${{ matrix.node-version }} + uses: actions/setup-node@v1 + with: + node-version: ${{ matrix.node-version }} + - run: npm install + - run: npm run build --if-present + - run: npm test + env: + CI: true +``` +{% endraw %} + +{% data reusables.github-actions.example-github-runner %} + +### Die Node.js-Version angeben + +Der einfachste Weg, eine Node.js-Version anzugeben, ist die Aktion `setup-node` von {% data variables.product.prodname_dotcom %} zu verwenden. Weitere Informationen findest Du unter [`setup-node`](https://github.com/actions/setup-node/). + +Die Aktion `setup-node` nimmt eine Node.js-Version als Eingabe und konfiguriert diese Version auf dem Runner. Die Aktion `setup-node` findet auf jedem Runner eine bestimmte Version von Node.js aus dem Tools-Cache und legt die notwendigen Binärdateien im `PATH` ab, wo sie für den Rest des Jobs bestehen bleiben. Für Node.js mit {% data variables.product.prodname_actions %} wird empfohlen, die Aktion `setup-node` zu verwenden, weil dadurch über verschiedenen Runner und verschiedenen Versionen von Node.js hinweg ein konsistentes Verhalten sicherstellt wird. Wenn Du einen selbst gehosteten Runner verwendest, musst Du Node.js installieren und zum `PATH` hinzufügen. + +Die Vorlage enthält eine Matrix-Strategie, die Deinen Code mit drei Node.js-Versionen baut und testet: 8.x, 10.x und 12.x. Das 'x' ist ein Platzhalterzeichen, für das neueste Minor- und Patch-Release des jeweiligen Major-Releases steht. The 'x' is a wildcard character that matches the latest minor and patch release available for a version. Jede Version von Node.js, die im Array `node-version` festgelegt ist, erstellt einen Job, der die gleichen Schritte ausführt. + +Jeder Job in der Matrix kann mithilfe des `Matrix`-Kontexts auf den im Array `node-version` definierten Wert zugreifen. Die Aktion `setup-node` verwendet den Kontext als Eingabe für `node-version`. Die Aktion `setup-node` konfiguriert jeden Job mit einer anderen Node.js-Version bevor sie den Code baut und testet. Weitere Informationen zu Matrix-Strategien und Kontexten findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix)“ und „[Kontext- und Ausdruckssyntax für {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)“. + +{% raw %} +```yaml +strategy: + matrix: + node-version: [8.x, 10.x, 12.x] + +steps: +- uses: actions/checkout@v2 +- name: Use Node.js ${{ matrix.node-version }} + uses: actions/setup-node@v1 + with: + node-version: ${{ matrix.node-version }} +``` +{% endraw %} + +Alternativ kannnst Du auch mit genauen Node.js-Versionen bauen und testen. + +```yaml +strategy: + matrix: + node-version: [8.16.2, 10.17.0] +``` + +Oder Du kannst auch mithilfe einer einzelnen Version von Node.js bauen und testen. + +{% raw %} +```yaml +name: Node.js CI + +on: [push] + +jobs: + build: + + runs-on: ubuntu-latest + + steps: + - uses: actions/checkout@v2 + - name: Use Node.js + uses: actions/setup-node@v1 + with: + node-version: '12.x' + - run: npm install + - run: npm run build --if-present + - run: npm test + env: + CI: true +``` +{% endraw %} + +Wenn Du keine Node.js Version festlegst, verwendet {% data variables.product.prodname_dotcom %} die standardmäßige Node.js Version der Umgebung. For more information, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". + +### Abhängigkeiten installieren + +Auf {% data variables.product.prodname_dotcom %}-gehosteten Runnern sind die Abhängigkeitsmanager npm und Yarn installiert. Du kannst npm und Yarn verwenden, um in Ihrem Workflow Abhängigkeiten zu installieren, bevor Du Deinen Code baust und testest. Die auf {% data variables.product.prodname_dotcom %} gehosteten Windows- und Linux-Runner haben auch Grunt, Gulp und Bower installiert. + +Du kannst Abhängigkeiten auch im Cache zwischenspeichern, um Deinen Workflow zu beschleunigen. Weitere Informationen findest Du unter „[Abhängigkeiten im Cache zwischenspeichern, um Deinen Workflow zu beschleunigen](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)“. + +#### Beispiel mit npm + +Dieses Beispiel installiert die Abhängigkeiten, die in der Datei *package.json* definiert sind. Weitere Informationen findest Du unter [`npm install`](https://docs.npmjs.com/cli/install). + +```yaml +steps: +- uses: actions/checkout@v2 +- name: Use Node.js + uses: actions/setup-node@v1 + with: + node-version: '12.x' +- name: Install dependencies + run: npm install +``` + +Du kannst mithilfe `npm ci` die Versionen in der Datei *package-lock.json* oder *npm-shrinkwrap.json* installieren und Aktualisierungen der Sperrdatei verhindern. `npm ci` zu verwenden ist gewöhnlich schneller als `npm install` laufen zu lassen. Weitere Informationen findest Du unter [`npm ci`](https://docs.npmjs.com/cli/ci.html) und „[Einführung in `npm ci` für schnellere und zuverlässigere Builds](https://blog.npmjs.org/post/171556855892/introducing-npm-ci-for-faster-more-reliable)“. + +{% raw %} +```yaml +steps: +- uses: actions/checkout@v2 +- name: Use Node.js + uses: actions/setup-node@v1 + with: + node-version: '12.x' +- name: Install dependencies + run: npm ci +``` +{% endraw %} + +#### Beispiel mit Yarn + +Dieses Beispiel installiert die Abhängigkeiten, die in der Datei *package.json* definiert sind. Weitere Informationen findest Du unter [`Yarn-Installation`](https://yarnpkg.com/en/docs/cli/install). + +```yaml +steps: +- uses: actions/checkout@v2 +- name: Use Node.js + uses: actions/setup-node@v1 + with: + node-version: '12.x' +- name: Install dependencies + run: yarn +``` + +Alternativ kannst Du `--frozen-lockfile` übergeben, um die Versionen in der Datei *yarn.lock* zu installieren und Aktualisierungen der Datei *yarn.lock* zu verhindern. + +```yaml +steps: +- uses: actions/checkout@v2 +- name: Use Node.js + uses: actions/setup-node@v1 + with: + node-version: '12.x' +- name: Install dependencies + run: yarn --frozen-lockfile +``` + +#### Beispiel mit einer privaten Registry und Erstellung der Datei .npmrc + +{% data reusables.github-actions.setup-node-intro %} + +Um Dich bei Deiner privaten Registry zu authentifizieren, musst Du in Deinen Repository-Einstellungen Dein npm-Authentifizierungs-Token als Geheimnis ablegen. Erstelle z.B. ein Geheimnis namens `NPM_TOKEN`. Weitere Informationen findest Du unter „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“. + +Im folgenden Beispiel enthält das Geheimnis `NPM_TOKEN` den npm-Authentifizierungs-Token. Die Aktion `setup-node` konfiguriert die Datei *.npmrc*, um den npm-Authentifizierung-Token aus der Umgebungsvariablen `NODE_AUTH_TOKEN` zu lesen. Wenn Du die Aktion `setup-node` verwendest, um eine Datei *.npmrc* zu erstellen, musst Du die Umgebungsvariable `NPM_AUTH_TOKEN` auf das Geheimnis setzen, das Deinen npm-Authentifizierungs-Token enthält. + +Bevor Du Abhängigkeiten installierst, verwende die Aktion `setup-node`, um die Datei *.npmrc* zu erstellen. Die Aktion hat zwei Eingabeparameter. Der Parameter `node-version` legt die Version von Node.js fest und der Parameter `registry-url` bestimmt die Standard-Registry. Wenn Deine Paket-Registry Geltungsbereiche verwendet, musst Du den Parameter `scope` verwenden. Weitere Informationen findest Du unter [`npm-scope`](https://docs.npmjs.com/misc/scope). + +{% raw %} +```yaml +steps: +- uses: actions/checkout@v2 +- name: Use Node.js + uses: actions/setup-node@v1 + with: + always-auth: true + node-version: '12.x' + registry-url: https://registry.npmjs.org + scope: '@octocat' +- name: Install dependencies + run: npm ci + env: + NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}} +``` +{% endraw %} + +Das obige Beispiel erzeugt eine *.npmrc* Datei mit folgendem Inhalt: + +``` +//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN} +@octocat:registry=https://registry.npmjs.org/ +always-auth=true +``` + +#### Beispiel zum Zwischenspeichern von Abhängigkeiten im Cache + +Du kannst Abhängigkeiten mit einem eindeutigen Schlüssel im Cache zwischenspeichern und sie später wiederherstellen, wenn Du zukünftige Workflows mit der Aktion `-cache-` ausführst. Weitere Informationen findest Du unter „[Caching-Abhängigkeiten zur Beschleunigung von Workflows](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)“ und der [Aktion `cache`](https://github.com/marketplace/actions/cache). + +{% raw %} +```yaml +steps: +- uses: actions/checkout@v2 +- name: Use Node.js + uses: actions/setup-node@v1 + with: + node-version: '12.x' +- name: Cache Node.js modules + uses: actions/cache@v2 + with: + # npm cache files are stored in `~/.npm` on Linux/macOS + path: ~/.npm + key: ${{ runner.OS }}-node-${{ hashFiles('**/package-lock.json') }} + restore-keys: | + ${{ runner.OS }}-node- + ${{ runner.OS }}- +- name: Install dependencies + run: npm ci +``` +{% endraw %} + +### Deinen Code bauen und testen + +Du kannst die gleichen Befehle verwenden, die Du auch lokal verwendest, um Deinen Code zu erstellen und zu testen. Wenn Du beispielsweise `npm run build` ausführst, um die in Deinem *package.json* definierten Build-Schritte zu durchlaufen, und `npm test`, um Deine Testsuite laufen zu lassen, dann fügst Di diese Befehle in Deine Workflow-Datei ein. + +```yaml +steps: +- uses: actions/checkout@v2 +- name: Use Node.js + uses: actions/setup-node@v1 + with: + node-version: '12.x' +- run: npm install +- run: npm run build --if-present +- run: npm test +``` + +### Workflow-Daten als Artefakte paketieren + +Du kannst Artefakte aus deinen Build- und Testschritten speichern, um sie nach dem Abschluss eines Jobs anzuzeigen. Zum Beispiel kann es notwendig sein, Logdateien, Core Dumps, Testergebnisse oder Screenshots zu speichern. Weitere Informationen findest Du unter „[Workflow-Daten mittels Artefakten persistieren](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)“. + +### In Paket-Registries veröffentlichen + +Du kannst Deinen Workflow so konfigurieren, dass Dein Node.js-Paket nach Bestehen Deiner CI-Tests in einer Paket-Registry veröffentlicht wird. Weitere Informationen zum Veröffentlichen in npm und {% data variables.product.prodname_registry %} findest Du unter „[Node.js Pakete veröffentlichen](/actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages)“. diff --git a/translations/de-DE/content/actions/guides/building-and-testing-python.md b/translations/de-DE/content/actions/guides/building-and-testing-python.md new file mode 100644 index 000000000000..5f0e1d404ade --- /dev/null +++ b/translations/de-DE/content/actions/guides/building-and-testing-python.md @@ -0,0 +1,427 @@ +--- +title: Building and testing Python +intro: Du kannst einen Workflow für kontinuierliche Integration (CI) erstellen, um Dein Python-Projekt zu bauen und zu testen. +redirect_from: + - /actions/automating-your-workflow-with-github-actions/using-python-with-github-actions + - /actions/language-and-framework-guides/using-python-with-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Einführung + +Diese Anleitung zeigt Dir, wie Du ein Python-Paket baust, testest und veröffentlichst. + +{% data variables.product.prodname_dotcom %}-gehostete Runner haben einen Tools-Cache mit vorinstallierter Software, einschließlich Python und PyPy. Du brauchst nichts zu installieren! For a full list of up-to-date software and the pre-installed versions of Python and PyPy, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". + +### Vorrausetzungen + +Du solltest mit YAML und der Syntax für {% data variables.product.prodname_actions %} vertraut sein. For more information, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." + +Du solltest ein grundlegendes Verständnis von Python, PyPy und pip haben. Weitere Informationen findest Du unter: +- [Erste Schritte mit Python](https://www.python.org/about/gettingstarted/) +- [PyPy](https://pypy.org/) +- [Paketmanager pip](https://pypi.org/project/pip/) + +{% data reusables.actions.enterprise-setup-prereq %} + +### Einstieg mit der Python-Workflow-Vorlage + +{% data variables.product.prodname_dotcom %} bietet eine Python-Workflow-Vorlage, die für die meisten Python-Projekte funktionieren sollte. Diese Anleitung enthält Beispiele, mit denen Du die Vorlage anpassen kannst. Weitere Informationen findest Du in der [Python-Workflow-Vorlage](https://github.com/actions/starter-workflows/blob/main/ci/python-package.yml). + +Um schnell loszulegen, füge die Vorlage in das Verzeichnis `.github/workflows` Deines Repositorys ein. + +{% raw %} +```yaml +name: Python package + +on: [push] + +jobs: + build: + + runs-on: ubuntu-latest + strategy: + matrix: + python-version: [2.7, 3.5, 3.6, 3.7, 3.8] + + steps: + - uses: actions/checkout@v2 + - name: Set up Python ${{ matrix.python-version }} + uses: actions/setup-python@v2 + with: + python-version: ${{ matrix.python-version }} + - name: Install dependencies + run: | + python -m pip install --upgrade pip + pip install flake8 pytest + if [ -f requirements.txt ]; then pip install -r requirements.txt; fi + - name: Lint with flake8 + run: | + # stop the build if there are Python syntax errors or undefined names + flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics + # exit-zero behandelt alle Fehler als Warnungen. Der GitHub-Editor ist 127 Zeichen breit + flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics + - name: Test with pytest + run: | + pytest +``` +{% endraw %} + +### Eine Python-Version angeben + +Benutze die Aktion `setup-python`, um eine vorinstallierte Version von Python oder PyPy auf einem {% data variables.product.prodname_dotcom %}-gehosteten Runner zu verwenden. Diese Aktion findet aus dem Tool-Cache auf jedem Runner eine bestimmte Version von Python oder PyPy und fügt die benötigten Binärdateien zum `PATH`hinzu, der für den Rest des Jobs bestehen bleibt. Wenn eine bestimmte Version von Python nicht im Tools-Cache vorinstalliert ist, lädt die Aktion `setup-python` die entsprechende Version vom [Repository `python-versions`](https://github.com/actions/python-versions) herunter und richtet sie ein. + +Die `setup-action` ist die empfohlene Methode, Python mit {% data variables.product.prodname_actions %} zu verwenden, da dadurch ein einheitliches Verhalten der verschiedenen Runner und verschiedenen Versionen von Python gewährleistet wird. Wenn Du einen selbst gehosteten Runner verwendest, musst Du Python installieren und zum `PATH` hinzufügen. Weitere Informationen findest Du in der [Aktion `setup-python`](https://github.com/marketplace/actions/setup-python). + +Die folgende Tabelle zeigt für jeden {% data variables.product.prodname_dotcom %}-gehosteten Runner, wo der Tools-Cache liegt. + +| | Ubuntu | Mac | Windows | +| -------------------------- | ------------------------------- | ---------------------------------------- | ------------------------------------------ | +| **Tool-Cache-Verzeichnis** | `/opt/hostedtoolcache/*` | `/Users/runner/hostedtoolcache/*` | `C:\hostedtoolcache\windows\*` | +| **Tool-Cache für Python** | `/opt/hostedtoolcache/Python/*` | `/Users/runner/hostedtoolcache/Python/*` | `C:\hostedtoolcache\windows\Python\*` | +| **Tool-Cache für PyPy** | `/opt/hostedtoolcache/PyPy/*` | `/Users/runner/hostedtoolcache/PyPy/*` | `C:\hostedtoolcache\windows\PyPy\*` | + +Wenn Du einen selbst gehosteten Runner verwendest, kannst Du den Runner so konfigurieren, dass er mithilfe der Aktion `setup-python` Deine Abhängigkeiten verwaltet. Weitere Informationen findest Du unter [setup-python mit einem selbst-gehosteten Runner verwenden](https://github.com/actions/setup-python#using-setup-python-with-a-self-hosted-runner) in der README von `setup-python`. + +{% data variables.product.prodname_dotcom %} unterstützt dir Syntax für semantische Versionierung. Weitere Informationen findest Du unter „[Semantische Versionierung verwenden](https://docs.npmjs.com/about-semantic-versioning#using-semantic-versioning-to-specify-update-types-your-package-can-accept)“ und „[Spezifikation für semantische Versionierung](https://semver.org/)“. + +#### Mehrere Python-Versionen verwenden + +{% raw %} +```yaml +name: Python package + +on: [push] + +jobs: + build: + + runs-on: ubuntu-latest + strategy: + # Du kannst in python-version die PyPy-Versionen angeben, + # For example, pypy2 and pypy3 + matrix: + python-version: [2.7, 3.5, 3.6, 3.7, 3.8] + + steps: + - uses: actions/checkout@v2 + - name: Set up Python ${{ matrix.python-version }} + uses: actions/setup-python@v2 + with: + python-version: ${{ matrix.python-version }} + # Du kannst Deine Matrix durch Ausgabe der aktuellen Python-Version testen + - name: Display Python version + run: python -c "import sys; print(sys.version)" +``` +{% endraw %} + +#### Eine bestimmten Python-Version verwenden + +Du kannst eine bestimmte Version von Python konfigurieren, For example, 3.8. Alternativ kannst Du auch Syntax für semantische Versionierung verwenden, um das neuste Minor Release zu erhalten. Dieses Beispiel verwendet das neueste Minor Release von Python 3. + +{% raw %} +```yaml +name: Python package + +on: [push] + +jobs: + build: + + runs-on: ubuntu-latest + + steps: + - uses: actions/checkout@v2 + - name: Set up Python 3.x + uses: actions/setup-python@v2 + with: + # Semantic version range syntax or exact version of a Python version + python-version: '3.x' + # Optional - x64 or x86 architecture, defaults to x64 + architecture: 'x64' + # You can test your matrix by printing the current Python version + - name: Display Python version + run: python -c "import sys; print(sys.version)" +``` +{% endraw %} + +#### Eine Version ausschließen + +Wenn du eine Version von Python angibst, die nicht verfügbar ist, schlägt `setup-python` fehl und meldet in etwa: `##[error]Version 3.4 with arch x64 not found`. Die Fehlermeldung enthält die verfügbaren Versionen. + +Du kannst in Deinem Workflow auch das Schlüsselwort `exclude` verwenden, wenn Du eine bestimmte Konfiguration von Python nicht laufen lassen möchtest. Weitere Informationen findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategy)“. + +{% raw %} +```yaml +name: Python package + +on: [push] + +jobs: + build: + + runs-on: ${{ matrix.os }} + strategy: + matrix: + os: [ubuntu-latest, macos-latest, windows-latest] + python-version: [2.7, 3.6, 3.7, 3.8, pypy2, pypy3] + exclude: + - os: macos-latest + python-version: 3.6 + - os: windows-latest + python-version: 3.6 +``` +{% endraw %} + +#### Die Standard-Version von Python verwenden + +Wir empfehlen, `setup-python` zu verwenden, um die Version von Python zu konfigurieren, die in deinen Workflows verwendet wird, da es hilft, deine Abhängigkeiten explizit zu machen. Wenn du `setup-python` nicht verwendest, wird in jeder Shell, wenn Du `python` aufrufst, die Standardversion von Python verwendet, die in `PATH` gesetzt wurde. Die Standardversion von Python variiert zwischen den {% data variables.product.prodname_dotcom %}-gehosteten Runnern. Dies kann zu unerwarteten Abweichungen führen oder es kann unerwartet eine ältere Version verwendet werden. + +| {% data variables.product.prodname_dotcom %}-gehostete Runner | Beschreibung | +| ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| Ubuntu | Auf Ubuntu-Runnern sind mehrere Versionen von System-Python unter `/usr/bin/python` und `/usr/bin/python3` installiert. Die Python-Versionen, die mit Ubuntu mitgeliefert werden, sind zusätzlich zu den Versionen, die {% data variables.product.prodname_dotcom %} im Tools-Cache installiert. | +| Windows | Neben den Python-Versionen, die sich im Tools-Cache befinden, kommt Windows nicht mit einer entsprechenden Version von System-Python. Um das mit anderen Runnern konsistente Verhalten sicherzustellen und um Python „out-of-the-box“ ohne die Aktion `setup-python` nutzen zu können fügt {% data variables.product.prodname_dotcom %} ein paar Versionen aus dem Tools-Cache zum `PATH` hinzu. | +| macOS | Auf macOS-Runnern sind zusätzlich zu den Versionen im Tool-Cache noch mehrere Versionen von System-Python installiert. Die Python-Versionen des Systems befinden sich im Verzeichnis `/usr/local/Cellar/python/*`. | + +### Abhängigkeiten installieren + +Auf {% data variables.product.prodname_dotcom %}-gehosteten Runnern ist der Paketmanager pip installiert. Du kannst pip verwenden, um Abhängigkeiten von der PyPI-Paket-Registry zu installieren, bevor Du Deinen Code baust und testest. Zum Beispiel installiert oder aktualisiert der folgende YAML den Paket-Installierer `pip` sowie die Pakete `setuptools` und `wheel`. + +Du kannst Abhängigkeiten auch im Cache zwischenspeichern, um Deinen Workflow zu beschleunigen. Weitere Informationen findest Du unter „[Abhängigkeiten im Cache zwischenspeichern, um Deinen Workflow zu beschleunigen](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)“. + +{% raw %} +```yaml +steps: +- uses: actions/checkout@v2 +- name: Set up Python + uses: actions/setup-python@v2 + with: + python-version: '3.x' +- name: Install dependencies + run: python -m pip install --upgrade pip setuptools wheel +``` +{% endraw %} + +#### Datei für „Requirements“ (Anforderungen) + +Nach dem Update von `pip` werden üblicherweise im nächsten Schritt die Abhängigkeiten aus *requirements.txt* installiert. + +{% raw %} +```yaml +steps: +- uses: actions/checkout@v2 +- name: Set up Python + uses: actions/setup-python@v2 + with: + python-version: '3.x' +- name: Install dependencies + run: | + python -m pip install --upgrade pip + pip install -r requirements.txt +``` +{% endraw %} + +#### Abhängigkeiten im Cache zwischenspeichern + +You can cache pip dependencies using a unique key, and restore the dependencies when you run future workflows using the [`cache`](https://github.com/marketplace/actions/cache) action. For more information, see "[Caching dependencies to speed up workflows](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)." + +Pip caches dependencies in different locations, depending on the operating system of the runner. The path you'll need to cache may differ from the Ubuntu example below depending on the operating system you use. For more information, see [Python caching examples](https://github.com/actions/cache/blob/main/examples.md#python---pip). + +{% raw %} +```yaml +steps: +- uses: actions/checkout@v2 +- name: Setup Python + uses: actions/setup-python@v2 + with: + python-version: '3.x' +- name: Cache pip + uses: actions/cache@v2 + with: + # This path is specific to Ubuntu + path: ~/.cache/pip + # Look to see if there is a cache hit for the corresponding requirements file + key: ${{ runner.os }}-pip-${{ hashFiles('requirements.txt') }} + restore-keys: | + ${{ runner.os }}-pip- + ${{ runner.os }}- +- name: Install dependencies + run: pip install -r requirements.txt +``` +{% endraw %} + +{% note %} + +**Note:** Depending on the number of dependencies, it may be faster to use the dependency cache. Projects with many large dependencies should see a performance increase as it cuts down the time required for downloading. Projects with fewer dependencies may not see a significant performance increase and may even see a slight decrease due to how pip installs cached dependencies. The performance varies from project to project. + +{% endnote %} + +### Deinen Code testen + +Du kannst die gleichen Befehle verwenden, die Du auch lokal verwendest, um Deinen Code zu erstellen und zu testen. + +#### Mit pytest und pytest-cov testen + +This example installs or upgrades `pytest` and `pytest-cov`. Tests are then run and output in JUnit format while code coverage results are output in Cobertura. For more information, see [JUnit](https://junit.org/junit5/) and [Cobertura](https://cobertura.github.io/cobertura/). + +{% raw %} +```yaml +steps: +- uses: actions/checkout@v2 +- name: Set up Python + uses: actions/setup-python@v2 + with: + python-version: '3.x' +- name: Install dependencies + run: | + python -m pip install --upgrade pip + pip install -r requirements.txt +- name: Test with pytest + run: | + pip install pytest + pip install pytest-cov + pytest tests.py --doctest-modules --junitxml=junit/test-results.xml --cov=com --cov-report=xml --cov-report=html +``` +{% endraw %} + +#### Mit Flake8 den Code von „Fusseln“ reinigen + +The following example installs or upgrades `flake8` and uses it to lint all files. For more information, see [Flake8](http://flake8.pycqa.org/en/latest/). + +{% raw %} +```yaml +steps: +- uses: actions/checkout@v2 +- name: Set up Python + uses: actions/setup-python@v2 + with: + python-version: '3.x' +- name: Install dependencies + run: | + python -m pip install --upgrade pip + pip install -r requirements.txt +- name: Lint with flake8 + run: | + pip install flake8 + flake8 . +``` +{% endraw %} + +#### Tests mit Tox ausführen + +With {% data variables.product.prodname_actions %}, you can run tests with tox and spread the work across multiple jobs. You'll need to invoke tox using the `-e py` option to choose the version of Python in your `PATH`, rather than specifying a specific version. For more information, see [tox](https://tox.readthedocs.io/en/latest/). + +{% raw %} +```yaml +name: Python package + +on: [push] + +jobs: + build: + + runs-on: ubuntu-latest + strategy: + matrix: + python: [2.7, 3.7, 3.8] + + steps: + - uses: actions/checkout@v2 + - name: Setup Python + uses: actions/setup-python@v2 + with: + python-version: ${{ matrix.python }} + - name: Install Tox and any other packages + run: pip install tox + - name: Run Tox + # Run tox using the version of Python in `PATH` + run: tox -e py +``` +{% endraw %} + +### Workflow-Daten als Artefakte paketieren + +You can upload artifacts to view after a workflow completes. Zum Beispiel kann es notwendig sein, Logdateien, Core Dumps, Testergebnisse oder Screenshots zu speichern. Weitere Informationen findest Du unter "[Workflow-Daten mittels Artefakten persistieren](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)." + +The following example demonstrates how you can use the `upload-artifact` action to archive test results from running `pytest`. For more information, see the [`upload-artifact` action](https://github.com/actions/upload-artifact). + +{% raw %} +```yaml +name: Python package + +on: [push] + +jobs: + build: + + runs-on: ubuntu-latest + strategy: + matrix: + python-version: [2.7, 3.5, 3.6, 3.7, 3.8] + + steps: + - uses: actions/checkout@v2 + - name: Setup Python # Set Python version + uses: actions/setup-python@v2 + with: + python-version: ${{ matrix.python-version }} + # Install pip and pytest + - name: Install dependencies + run: | + python -m pip install --upgrade pip + pip install pytest + - name: Test with pytest + run: pytest tests.py --doctest-modules --junitxml=junit/test-results-${{ matrix.python-version }}.xml + - name: Upload pytest test results + uses: actions/upload-artifact@v2 + with: + name: pytest-results-${{ matrix.python-version }} + path: junit/test-results-${{ matrix.python-version }}.xml + # Use always() to always run this step to publish test results when there are test failures + if: ${{ always() }} +``` +{% endraw %} + +### In Paket-Registries veröffentlichen + +You can configure your workflow to publish your Python package to any package registry you'd like when your CI tests pass. + +You can store any access tokens or credentials needed to publish your package using repository secrets. The following example creates and publishes a package to PyPI using `twine` and `dist`. Weitere Informationen findest Du unter "[Verschlüsselte Geheimnisse erstellen und verwenden](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". + +{% raw %} +```yaml +name: Upload Python Package + +on: + release: + types: [created] + +jobs: + deploy: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Set up Python + uses: actions/setup-python@v2 + with: + python-version: '3.x' + - name: Install dependencies + run: | + python -m pip install --upgrade pip + pip install setuptools wheel twine + - name: Build and publish + env: + TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }} + TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }} + run: | + python setup.py sdist bdist_wheel + twine upload dist/* +``` +{% endraw %} + +For more information about the template workflow, see [`python-publish`](https://github.com/actions/starter-workflows/blob/main/ci/python-publish.yml). diff --git a/translations/de-DE/content/actions/guides/caching-dependencies-to-speed-up-workflows.md b/translations/de-DE/content/actions/guides/caching-dependencies-to-speed-up-workflows.md new file mode 100644 index 000000000000..9c5646ca31a1 --- /dev/null +++ b/translations/de-DE/content/actions/guides/caching-dependencies-to-speed-up-workflows.md @@ -0,0 +1,192 @@ +--- +title: Abhängigkeiten zwischenspeichern um Workflows zu beschleunigen +shortTitle: Abhängigkeiten „cachen“ (zwischenspeichern) +intro: 'Um Deine Workflows schneller und effizienter zu gestalten, kannst Du Caches für Abhängigkeiten und andere häufig wiederverwendete Dateien erstellen und verwenden.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /github/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows + - /actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows + - /actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows +versions: + free-pro-team: '*' +--- + +### Informationen zum Zwischenspeichern von Workflow-Abhängigkeiten + +Workflow-Läufe verwenden häufig dieselben Ausgaben oder heruntergeladenen Abhängigkeiten in aufeinanderfolgenden Durchläufen. Tools zur Verwaltung von Paketen und Abhängigkeiten wie beispielsweise Maven, Gradle, npm und Yarn halten einen lokalen Cache mit heruntergeladenen Abhängigkeiten. + +Jobs bei {% data variables.product.prodname_dotcom %}-gehosteten Läufern beginnen in einer sauberen virtuellen Umgebung und müssen Abhängigkeiten jedes Mal herunterladen. Dies führt zu erhöhter Netzwerkauslastung, längerer Laufzeit und erhöhten Kosten. Um die Zeit zum Neuerstellen dieser Dateien einzusparen, kann {% data variables.product.prodname_dotcom %} in Workflows häufig verwendete Abhängigkeiten zwischenspeichern. + +Um Abhängigkeiten für einen Job zu cachen, musst du die `Cache`-Aktion von {% data variables.product.prodname_dotcom %} verwenden. Die Aktion ruft einen Cache ab, der durch einen eindeutigen Schlüssel identifiziert wurde. Weitere Informationen findest Du unter [`Aktionen/Cache`](https://github.com/actions/cache). + +{% warning %} + +**Warnung**: Wir empfehlen Ihnen, keine sensiblen Informationen im Cache von öffentlichen Repositories zu speichern. Sensible Informationen umfassen beispielsweise Zugriffstoken oder Anmeldedaten, die in einer Datei im Cache-Pfad gespeichert sind. Auch Kommandozeilen-Programme (CLI) wie `docker login` können Zugangsdaten in einer Konfigurationsdatei speichern. Jeder mit Lesezugriff kann einen Pull-Request auf ein Repository erstellen und auf den Inhalt des Caches zugreifen. Forks eines Repositorys können auch Pull-Requests auf den base branch (Basiszweig) erstellen und auf Caches im Basiszweig zugreifen. + +{% endwarning %} + +### Vergleich: Artefakte v/s Zwischenspeicherung von Abhängigkeiten + +Artefakte und Caching sind ähnlich, da sie die Möglichkeit bieten, Dateien auf {% data variables.product.prodname_dotcom %} zu speichern, aber die beiden Funktionalitäten bieten verschiedene Anwendungsfälle und dürfen nicht miteinander verwechselt werden. + +- Verwende Caching, wenn Du Dateien wiederverwenden willst, die sich zwischen Jobs oder Workflow-Läufen nicht oft ändern. +- Verwende Artefakte, wenn Du die von einem Job erzeugten Dateien speichern willst, um sie nach dem Ende eines Workflows anzuzeigen. Weitere Informationen findest Du unter "[Workflow-Daten mittels Artefakten persistieren](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)." + +### Einschränkungen für den Zugriff auf einen Cache + +Mit `v2-` der `Cache-` -Aktion können Sie in Workflows auf den Cache zugreifen, die von jedem Ereignis ausgelöst werden, das über eine `GITHUB_REF`verfügt. Wenn Sie `v1-` der `-Cache-` -Aktion verwenden, können Sie nur in Workflows auf den Cache zugreifen, `durch pushen` - und `pull_request` -Ereignisse ausgelöst werden, mit Ausnahme des `pull_request` `` -Ereignis geschlossen. Weitere Informationen findest Du unter "[Ereignisse, die Workflows auslösen](/actions/reference/events-that-trigger-workflows)." + +A workflow can access and restore a cache created in the current branch, the base branch (including base branches of forked repositories), or the default branch (usually `main`). For example, a cache created on the default branch would be accessible from any pull request. Also, if the branch `feature-b` has the base branch `feature-a`, a workflow triggered on `feature-b` would have access to caches created in the default branch (`main`), `feature-a`, and `feature-b`. + +Zugriffsbeschränkungen bieten Cache-Isolation und Sicherheit durch Ziehen einer logischen Grenze zwischen verschiedenen Workflows und Zweigen. For example, a cache created for the branch `feature-a` (with the base `main`) would not be accessible to a pull request for the branch `feature-b` (with the base `main`). + +### Verwenden der `-Cache-` -Aktion + +Die Aktion `-cache-` wird versuchen, einen Cache basierend auf dem `key` (Schlüssel), den Du angibst, wiederherzustellen. Wenn die Aktion einen Cache findet, stellt die Aktion die zwischengespeicherten Dateien in dem `path` wieder her, den Du konfigurierst. + +Wenn es keine exakte Übereinstimmung gibt, erzeugt die Aktion einen neuen Cache-Eintrag, wenn der Job erfolgreich abgeschlossen wird. Der neue Cache wird den `key` verwenden, den Du angegeben hast, und enthält die Dateien im Verzeichnis `path`. + +Optional kannst Du eine Liste von `restore-keys` angeben, die verwendet werden sollen, wenn der `key` nicht mit einem vorhandenen Cache übereinstimmt. Eine Liste der `restore-keys` ist nützlich, wenn Du einen Cache aus einem anderen Zweig wiederherstellst, da `restore-keys` auch teilweise mit Cache-Schlüsseln übereinstimmen dürfen. Weitere Informationen zum Abgleich von `restore-keys`, siehe "[Einen Cache-Schlüssel abgleichen](#matching-a-cache-key)." + +Weitere Informationen findest Du unter [`Aktionen/Cache`](https://github.com/actions/cache). + +#### Eingabeparameter für die `-Cache-` -Aktion + +- `key`: **Erforderlich** Der Schlüssel, der beim Speichern eines Caches erstellt wurde, und der Schlüssel, der zum Suchen nach einem Cache verwendet wird. Kann eine beliebige Kombination von Variablen, Kontextwerten, statischen Strings und Funktionen sein. Schlüssel haben eine maximale Länge von 512 Zeichen und Schlüssel, die die maximale Länge überschreiten, lassen die Aktion fehlschlagen. +- `path`: **Erforderlich** Der Dateipfad auf dem Runner zum Anlegen oder Wiederherstellen des Caches. Der Pfad kann ein absoluter Pfad oder relativ zum Arbeitsverzeichnis sein. + - Mit `v2-` der `-Cache-` -Aktion können Sie einen einzelnen Pfad oder mehrere Pfade als Liste angeben. Pfade können entweder Verzeichnisse oder einzelne Dateien sein, und Glob-Muster werden unterstützt. + - Bei `v1-` der `-Cache-` -Aktion wird nur ein einzelner Pfad unterstützt, und es muss sich um ein Verzeichnis handeln. Eine einzelne Datei kannst Du nicht cachen. +- `restore-keys`: **Optional** Eine geordnete Liste der alternativen Schlüssel, die zum Finden des Caches verwendet werden sollen, falls `key` keinen Treffer gebracht hat. + +#### Ausgangsparameter für die Cache-Aktion + +- `Cache-Treffer`: Ein boolescher Wert, um eine genaue Übereinstimmung für den Schlüssel anzugeben. + +#### Beispiel für die Verwendung der `-Cache-` -Aktion + +Dieses Beispiel erzeugt einen neuen Cache, wenn sich die Pakete in `package-lock.json` ändern oder wenn das Betriebssystem des Runners wechselt. Das folgende Beispiel verwendet Kontexte und Ausdrücke, um einen Schlüssel zu erzeugen, der eine Kennung des Runner-Betriebssystems und einen SHA-256-Hash der Datei `package-lock.json` enthält. + +{% raw %} +```yaml +name: Caching mit npm + +on: push + +jobs: + build: + runs-on: ubuntu-latest + + schritte: + - verwendet: actions/checkout@v2 + + - name: Cache node modules + uses: actions/cache@v2 + env: + cache-name: cache-node-modules + with: + -npm-Cache-Dateien werden in ''/.npm' auf dem Linux/macOS- + -Pfad gespeichert: '/.npm + -Schlüssel: '{{ runner.os }}-build-'{{ env.cache-name }}-' hashFiles('**/package-lock.json') ' + Restore-Keys: | + -{{ runner.os }}-build--{{ env.cache-name }}- + -{{ runner.os }}-build- + -{{ runner.os }}- + + - Name: Installieren sie abhängigkeiten + ausführen: npm install + + - Name: Build + ausführen: npm build + + - Name: Test + -Test: npm-Test + +``` +{% endraw %} + +Wenn `key` mit einem existierenden Cache übereinstimmt, wird das als „cache hit“ (Cache-Treffer) bezeichnet, und die Aktion stellt die zwischengespeicherten Dateien wieder her und legt sie in den `path`. + +Wenn `key` nicht mit einem existierenden Cache übereinstimmt, wird das als „cache miss“ (Cache-Fehlschlag) bezeichnet. Wenn der Job erfolgreich abgeschlossen ist, wird ein neuer Cache erstellt. Wenn ein Cache-Fehlschlag auftritt, sucht die Aktion mittels der alternativen Schlüssel gemäß `restore-keys` weiter. + +1. Wenn du `restore-keys` bereitstellst, sucht die `cache`-Aktion sequentiell nach Caches, die mit der Liste `restore-keys` übereinstimmen. + - Wenn es eine exakte Übereinstimmung gibt, stellt die Aktion die Dateien aus dem Cache in das Verzeichnis `path` wieder her. + - Wenn es keine exakten Übereinstimmungen gibt, sucht die Aktion nach partiellen Übereinstimmungen der „restore keys“ (Wiederherstellungs-Scvhlüssel). Wenn die Aktion eine partielle Übereinstimmung findet, wird der aktuellste Cache in das Verzeichnis `path` wiederhergestellt. +1. Die `Cache-` Aktion abgeschlossen wird, und der nächste Workflowschritt im Auftrag wird ausgeführt. +1. Wenn der Job erfolgreich abgeschlossen ist, erstellt die Aktion einen neuen Cache mit dem Inhalt des Verzeichnisses `path`. + +Um Dateien in mehr als einem Verzeichnis zu cachen, benötigst Du einen step (Schritt), der die Aktion [`cache`](https://github.com/actions/cache) für jedes Verzeichnis verwendet. Sobald Du einen Cache erstellt hast, kannst Du den Inhalt eines bereits existierenden Caches nicht ändern, aber Du kannst einen neuen Cache mit einem neuen key (Schlüssel) erstellen. + +#### Cache-Keys aus Kontexten erstellen + +Ein Cache-Key (Cache-Schlüssel) kann Kontexte, Funktionen, Literale und Operatoren enthalten, die von {% data variables.product.prodname_actions %} unterstützt werden. Weitere Informationen findest Du unter „[Kontext- und Ausdrucks-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)“. + +Wenn Du zum Erstellen eines `key`s Ausdrücke verwendest, kannst Du automatisch einen neuen Cache zu erstellen, sobald sich die Abhängigkeiten geändert haben. Zum Beispiel kannst Du einen `key` mittels eines Ausdrucks erstellen, der den Hash-Code einer npm-Datei `package-lock.json` errechnet. + +{% raw %} +``` +npm-${{ hashFiles('package-lock.json') }} +``` +{% endraw %} + +{% data variables.product.prodname_dotcom %} wertet den Ausdruck aus `hash "package-lock.json"` um daraus den endgültigen `key` abzuleiten. + +``` +npm-d5ea0750 +``` + +### Einen Cache-Key abgleichen + +Der `-Cache` Aktion sucht zuerst nach Cachetreffern nach `Schlüssel` und `Wiederherstellungsschlüssel n` in der Verzweigung, die die Workflowausführung enthält. Wenn in der aktuellen Verzweigung keine Treffer vorhanden sind, sucht der `-Cache` Aktion nach `Schlüssel` und `Wiederherstellungsschlüssel, die in den übergeordneten Zweigen und vorgelagerten Zweigen` . + +Du kannst eine Liste der `restore-keys` angeben, die verwendet werden sollen, wenn auf `key` ein Cache-Fehler auftritt. Du kannst mehrere `restore-keys` erstellen, die von den spezifischsten zum am wenigsten spezifischen sortiert sind. Die Aktion `cache` sucht nach `restore-keys` in sequenzieller Reihenfolge. Wenn ein Schlüssel nicht direkt übereinstimmt, sucht die Aktion nach Schlüsseln denen der Restore-Key vorangestellt ist. Wenn mehrere Teiltreffer für einen Restore-Key vorhanden sind, gibt die Aktion den zuletzt erstellten Cache zurück. + +#### Beispiel für die Verwendung mehrerer Restore-Keys + +{% raw %} +``` +restore-keys: | + npm-foobar-${{ hashFiles('package-lock.json') }} + npm-foobar- + npm- +``` +{% endraw %} + +Der Runner bewertet die Ausdrücke, die sich in folgende `restore-keys` auflösen lassen: + +{% raw %} +``` +restore-keys: | + npm-foobar-d5ea0750 + npm-foobar- + npm- +``` +{% endraw %} + +Der Restore-Key `npm-foobar-` passt auf jeden Schlüssel, der mit dem String `npm-foobar-` beginnt. Zum Beispiel passen zu ihm die beiden Schlüssel `npm-foobar-fd3052de` und `npm-foobar-a9b253ff`. Der Cache mit dem neuesten Erstellungsdatum wird verwendet. Die Schlüssel in diesem Beispiel werden in der folgenden Reihenfolge durchsucht: + +1. **`npm-foobar-d5ea0750`** passt zu einem bestimmten Hash. +1. **`npm-foobar-`** deckt alle Cache-Schlüssel ab, die mit `npm-foobar-` beginnen. +1. **`npm-`** deckt alle Cache-Schlüssel ab, die mit `npm-` beginnen. + +##### Beispiel für die Suchpriorität + +```yaml +key: + npm-feature-d5ea0750 +restore-keys: | + npm-feature- + npm- +``` + +For example, if a pull request contains a `feature` branch (the current scope) and targets the default branch (`main`), the action searches for `key` and `restore-keys` in the following order: + +1. Schlüssel `npm-feature-d5eaa0750` im Zweig `feature` +1. Schlüssel `npm-feature-` im Zweig `feature` +2. Schlüssel `npm-` im Zweig `feature` +1. Key `npm-feature-d5ea0750` in the `main` branch scope +3. Key `npm-feature-` in the `main` branch scope +4. Key `npm-` in the `main` branch scope + +### Nutzungsbeschränkungen und Räumungsrichtlinien + +{% data variables.product.prodname_dotcom %} wird alle Cache-Einträge entfernen, auf die seit mehr als 7 Tagen nicht zugegriffen wurde. Es gibt keine Grenze für die Anzahl der Caches, die du speichern kannst, aber die Gesamtgröße aller Caches in einem Repository ist auf 5 GB begrenzt. Wenn du dieses Limit überschreitest, wird {% data variables.product.prodname_dotcom %} deinen Cache speichern, aber damit beginnen, Caches zu löschen, bis die Gesamtgröße kleiner als 5 GB ist. diff --git a/translations/de-DE/content/actions/guides/creating-postgresql-service-containers.md b/translations/de-DE/content/actions/guides/creating-postgresql-service-containers.md new file mode 100644 index 000000000000..11f08f5217d6 --- /dev/null +++ b/translations/de-DE/content/actions/guides/creating-postgresql-service-containers.md @@ -0,0 +1,335 @@ +--- +title: PostgreSQL-Service-Container erstellen +shortTitle: PostgreSQL service containers +intro: Du kannst einen PostgreSQL-Service-Container zur Verwendung in Deinem Workflow erstellen. Dieser Leitfaden zeigt Beispiele für die Erstellung eines PostgreSQL-Dienstes für Jobs, die in Containern oder direkt auf der Runner-Maschine laufen. +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /actions/automating-your-workflow-with-github-actions/creating-postgresql-service-containers + - /actions/configuring-and-managing-workflows/creating-postgresql-service-containers +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Einführung + +Diese Anleitung zeigt Dir Workflow-Beispiele, die einen Service-Container mit dem `postgres`-Bild vom Docker-Hub konfigurieren. Der Workflow führt ein Skript aus, um einen PostgreSQL-Client zu erstellen und den Client mit Daten zu füllen. Um zu testen, ob der Workflow den PostgreSQL-Client erstellt und mit Daten füllt, gibt das Skript die Daten des Clients in der Konsole aus. + +{% data reusables.github-actions.docker-container-os-support %} + +### Vorrausetzungen + +{% data reusables.github-actions.service-container-prereqs %} + +Es kann Dir auch helfen, YAML, die Syntax für {% data variables.product.prodname_actions %} und PostgreSQL grundlegende zu verstehen. Weitere Informationen findest Du unter: + +- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)" +- "[PostgreSQL-Tutorial](https://www.postgresqltutorial.com/)" in der PostgreSQL-Dokumentation + +### Jobs in Containern ausführen + +{% data reusables.github-actions.container-jobs-intro %} + +{% data reusables.github-actions.copy-workflow-file %} + +{% raw %} +```yaml +name: PostgreSQL service example +on: push + +jobs: + # Label des Container-Jobs + container-job: + # Container muessen auf Linux-basierten Betriebssystemen laufen + runs-on: ubuntu-latest + # Docker-Hub-Image, welches `container-job` in + container: node:10.18-jessie ausfuehrt + + # Service-Containers, der mit Diensten von `container-job` + laufen soll: + # Label fuer den Zugrieff auf den Service-Container + postgres: + # Docker-Hub-Image + image: postgres + # Das Passwort fuer Postgres bereitstellen + env: + POSTGRES_PASSWORD: postgres + # health checks (Gesundheitstests) so einstellen, dass sie warten, bis Postgres gestarted ist + options: >- + --health-cmd pg_isready + --health-interval 10s + --health-timeout 5s + --health-retries 5 + + steps: + # Laedt eine Kopie des Codes in Dein Repository herunter, bevor CI-Tests starten + - name: Check out repository code + uses: actions/checkout@v2 + + # Fuehrt eine saubere Installation aller Abhaengigkeiten in der Datei `package.json` durch + # Weitere Information findest Du unter https://docs.npmjs.com/cli/ci.html + - name: Install dependencies + run: npm ci + + - name: Connect to PostgreSQL + # Startet ein Skript, das einen PostgreSQL-Client erzeugt, + # Den Client mit Daten befuellt, und Daten abruft + run: node client.js + # Umgebungsvariable, die vom Skript `client.js` benutzt wird, um einen neuen PostgreSQL-Client zu erzeugen. + env: + # Der Name des Hosts fuer die Kommunikation mit dem PostgreSQL-Servicecontainer + POSTGRES_HOST: postgres + # The default PostgreSQL port + POSTGRES_PORT: 5432 +``` +{% endraw %} + +#### Runner-Job konfigurieren + +{% data reusables.github-actions.service-container-host %} + +{% data reusables.github-actions.postgres-label-description %} + +```yaml +jobs: + # Label des Container-Jobs + container-job: + # Container muessen in Linux-basierten Betriebssystemen laufen + runs-on: ubuntu-latest + # Docker-Hub-Image, das `container-job` in + container: node:10.18-jessie ausfuehrt + + # Service-Container, die mit `container-job` laufen sollen + services: + # Label fuer den Zugriff auf den Service-Container + postgres: + # Docker-Hub-Image + image: postgres + # Passwort fuer postgres bereitstellen + env: + POSTGRES_PASSWORD: postgres + # Health checks so einstellen, dass sie warten, bis Postgres gestarted ist + options: >- + --health-cmd pg_isready + --health-interval 10s + --health-timeout 5s + --health-retries 5 +``` + +#### „Steps“ (Schritte) konfigurieren + +{% data reusables.github-actions.service-template-steps %} + +```yaml +steps: + # Laedt eine Kopie des Codes in Dein Repository herunter, bevor CI-Tests starten + - name: Check out repository code + uses: actions/checkout@v2 + + # Fuehrt eine saubere Installation aller Anhängigkeiten in der Datei `package.json` durch + # Weitere Informationen findest Du unter https://docs.npmjs.com/cli/ci.html + - name: Install dependencies + run: npm ci + + - name: Connect to PostgreSQL + # Startet ein Skript, das einen PostgreSQL-Client erzeugt, + # den Client mit Daten befuellt und Daten abruft + run: node client.js + # Environment variable used by the `client.js` script to create + # a new PostgreSQL client. + env: + # Der Name des Hosts fuer die Kommunikation mit dem PostgreSQL-Servicecontainer + POSTGRES_HOST: postgres + # Der standardmaessige PostgreSQL-Port + POSTGRES_PORT: 5432 +``` + +{% data reusables.github-actions.postgres-environment-variables %} + +Der Hostname des PostgreSQL-Dienstes ist der Label, den Du in Deinem Workflow konfiguriert hast, in diesem Fall `postgres`. Da Docker-Container im gleichen benutzerdefinierten Bridge-Netzwerk standardmäßig alle Ports öffnen, kannst Du auf den Service-Container durch den standardmäßigen PostgreSQL-Port 5432 zugreifen. + +### Jobs direkt auf der Runner-Maschine ausführen + +Wenn Du einen Job direkt auf der Runner-Maschine ausführst, musst Du die Ports des Service-Containers den Ports des Docker-Hosts zuordnen. Du kannst über den Docker-Host auf den Service-Container zugreifen, indem Du `localhost` und die Port-Nummer des Docker-Hosts verwendest. + +{% data reusables.github-actions.copy-workflow-file %} + +{% raw %} +```yaml +name: PostgreSQL Service Example +on: push + +jobs: + # Label des Runner-Jobs + runner-job: + # Du musst fuer Service-Container oder Container-Jobs eine Linux-Umgebung verwenden + runs-on: ubuntu-latest + + # Service-Container zum Betrieb mit `runner-job` + services: + # Label fuer den Zugriff auf den Service-Container + postgres: + # Docker-Hub-Image + image: postgres + # Das Passwort fuer Postgres bereitstellen + env: + POSTGRES_PASSWORD: postgres + # Health checks einstellen, dass sie warten, bis Postgres gestarted ist + options: >- + --health-cmd pg_isready + --health-interval 10s + --health-timeout 5s + --health-retries 5 + ports: + # Maps tcp port 5432 on service container to the host + - 5432:5432 + + steps: + # Laedt eine Kopie des Codes in Dein Repository herunter, bevor CI tests laufen + - name: Check out repository code + uses: actions/checkout@v2 + + # Fuehrt eine saubere Installation aller Abhaengigkeiten in der Datei `package.json` durch + # Weitere Information finsest Du unter https://docs.npmjs.com/cli/ci.html + - name: Install dependencies + run: npm ci + + - name: Connect to PostgreSQL + # Startet ein Skript, das einen PostgreSQL-Client erzeugt, + # den client mit Daten befuellt und Daten abruft + run: node client.js + # Umgebungsvariable, die das Skript `client.js` benutzt, um + # einen neuen PostgreSQL-Client zu erzeugen. + env: + # Der Hostname fuer die Kommunikation mit dem PostgreSQL-Service-Container + POSTGRES_HOST: localhost + # Standardmaessiger PostgreSQL-Port + POSTGRES_PORT: 5432 +``` +{% endraw %} + +#### Runner-Job konfigurieren + +{% data reusables.github-actions.service-container-host-runner %} + +{% data reusables.github-actions.postgres-label-description %} + +Der Workflow ordnet Port 5432 des PostgreSQL-Service-Containers dem Docker-Host zu. Weitere Informationen über das Schlüsselwort `ports` findest Du unter "[Informationen über Service-Container](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)." + +```yaml +jobs: + # Label des Runner-Jobs + runner-job: + # Du musst fuer Service-Containers oder Container-Jobs eine Linux-Umgebung verwenden + runs-on: ubuntu-latest + + # Service-Containers zum Betrieb mit `runner-job` + services: + # Label fier den Zugriff auf den Service-Container + postgres: + # Docker-Hub-Image + image: postgres + # Das Passwort fuer Postgres bereitstellen + env: + POSTGRES_PASSWORD: postgres + # Health-Checks einstellen, dass sie warten, bis Postgres gestarted ist + options: >- + --health-cmd pg_isready + --health-interval 10s + --health-timeout 5s + --health-retries 5 + ports: + # Ordnet TCP-Port 5432 des Service-Containers dem Host zu + - 5432:5432 +``` + +#### „Steps“ (Schritte) konfigurieren + +{% data reusables.github-actions.service-template-steps %} + +```yaml +steps: + # Laedt eine Kopie des Codes in Dein Repository herunter, bevor CI-Tests starten + - name: Check out repository code + uses: actions/checkout@v2 + + # Fuehrt eine saubere Installation aller Anhängigkeiten in der Datei `package.json` durch + # Weitere Informationen findest Du unter https://docs.npmjs.com/cli/ci.html + - name: Install dependencies + run: npm ci + + - name: Connect to PostgreSQL + # Startet ein Skript, das einen PostgreSQL-Client erzeugt, + # den Client mit Daten befuellt und Daten abruft + run: node client.js + # Environment variable used by the `client.js` script to create + # a new PostgreSQL client. + env: + # Der Hostname zur Kommunikation with the PostgreSQL-Service-Container + POSTGRES_HOST: localhost + # Der standardmaessige PostgreSQL-Port + POSTGRES_PORT: 5432 +``` + +{% data reusables.github-actions.postgres-environment-variables %} + +{% data reusables.github-actions.service-container-localhost %} + +### Den PostgreSQL-Service-Container testen + +Du kannst Deinen Workflow mit dem folgenden Skript testen, das einen PostgreSQL-Client erstellt und eine neue Tabelle mit Platzhalter-Daten hinzufügt. Das Skript gibt dann die im PostgreSQL-Client gespeicherten Werte auf dem Terminal aus. Dein Skript kann jede beliebige Sprache verwenden, aber in diesem Beispiel wird Node.js mit dem npm-Modul `pg` genutzt. Weitere Informationen findest Du unter [npm-Modul pg](https://www.npmjs.com/package/pg). + +Du kannst *client.js* anpassen, um alle PostgreSQL-Vorgänge einzuschließen, die für Deinen Workflow erforderlich sind. In diesem Beispiel erstellt das Skript die Instanz des PostgreSQL-Clients, erstellt eine Tabelle, fügt Platzhalter-Daten hinzu und ruft dann die Daten ab. + +{% data reusables.github-actions.service-container-add-script %} + +```javascript +const { Client } = require('pg'); + +const pgclient = new Client({ + host: process.env.POSTGRES_HOST, + port: process.env.POSTGRES_PORT, + user: 'postgres', + password: 'postgres', + database: 'postgres' +}); + +pgclient.connect(); + +const table = 'CREATE TABLE student(id SERIAL PRIMARY KEY, firstName VARCHAR(40) NOT NULL, lastName VARCHAR(40) NOT NULL, age INT, address VARCHAR(80), email VARCHAR(40))' +const text = 'INSERT INTO student(firstname, lastname, age, address, email) VALUES($1, $2, $3, $4, $5) RETURNING *' +const values = ['Mona the', 'Octocat', 9, '88 Colin P Kelly Jr St, San Francisco, CA 94107, United States', 'octocat@github.com'] + +pgclient.query(table, (err, res) => { + if (err) throw err +}); + +pgclient.query(text, values, (err, res) => { + if (err) throw err +}); + +pgclient.query('SELECT * FROM student', (err, res) => { + if (err) throw err + console.log(err, res.rows) // Print the data in student table + pgclient.end() +}); +``` + +Das Skript erstellt einen neuen PostgreSQL-`Client`, der einen `host`- und einen `port`-Parameter akzeptiert. Das Skript verwendet die Umgebungsvariablen `POSTGRES_HOST` und `POSTGRES_PORT`, um die IP-Adresse und den Port des Clients festzulegen. Wenn `host` Und `port` nicht definiert sind, ist der Standard-Host `localhost` und der Standard-Port 5432. + +Das Skript erstellt eine Tabelle und füllt sie mit Platzhalterdaten auf. Um zu testen, ob die PostgreSQL-Datenbank die Daten enthält, gibt das Skript den Inhalt der Tabelle in das Konsolenprotokoll aus. + +Wenn Du diesen Workflow ausführst, solltest Du im Schritt „Mit PostgreSQL verbinden“ die folgende Ausgabe sehen, welche zeigt, dass Du den PostgreSQL-Client erstellt und Daten hinzugefügt hast: + +``` +null [ { id: 1, + firstname: 'Mona the', + lastname: 'Octocat', + age: 9, + address: + '88 Colin P Kelly Jr St, San Francisco, CA 94107, United States', + email: 'octocat@github.com' } ] +``` diff --git a/translations/de-DE/content/actions/guides/creating-redis-service-containers.md b/translations/de-DE/content/actions/guides/creating-redis-service-containers.md new file mode 100644 index 000000000000..dc950efcda0a --- /dev/null +++ b/translations/de-DE/content/actions/guides/creating-redis-service-containers.md @@ -0,0 +1,325 @@ +--- +title: Redis-Service-Container erstellen +shortTitle: Redis service containers +intro: Du kannst Service-Container verwenden, um einen Redis-Client in Deinem Workflow zu erstellen. Dieser Leitfaden zeigt Beispiele für die Erstellung eines Redis-Dienstes für Jobs, die in Containern oder direkt auf der Runner-Maschine ausgeführt werden. +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /actions/automating-your-workflow-with-github-actions/creating-redis-service-containers + - /actions/configuring-and-managing-workflows/creating-redis-service-containers +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Einführung + +Diese Anleitung zeigt Dir Workflow-Beispiele, die einen Service-Container mit dem Docker-Hub-`redis`-Image konfigurieren. Der Workflow führt ein Skript aus, um einen Redis-Client zu erstellen und den Client mit Daten zu füllen. Um zu testen, ob der Workflow den Redis-Client erstellt und mit Daten füllt, gibt das Skript die Daten des Clients auf der Konsole aus. + +{% data reusables.github-actions.docker-container-os-support %} + +### Vorrausetzungen + +{% data reusables.github-actions.service-container-prereqs %} + +Es kannst Dir helfen, wenn Du ein grundlegendes Verständnis von YAML, der Syntax für {% data variables.product.prodname_actions %} und Redis hast. Weitere Informationen findest Du unter: + +- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)" +- „[Erste Schritte mit Redis](https://redislabs.com/get-started-with-redis/)“ in der Redis-Dokumentation + +### Jobs in Containern ausführen + +{% data reusables.github-actions.container-jobs-intro %} + +{% data reusables.github-actions.copy-workflow-file %} + +{% raw %} +```yaml +name: Redis container example +on: push + +jobs: + # Label des Container-Jobs + container-job: + # Container muessen in Linux-basierten Betriebssystemen laufen + runs-on: ubuntu-latest + # Docker-Hub-Image, in dem der `container-job` laeuft + container: node:10.18-jessie + + # Service-Container, die mit dem `container-job` laufen + services: + # Label zum Zugriff auf den Service-Container + redis: + # Docker-Hub-Image + image: redis + # Health-Checks so einstellen, dass sie warten, bis redis gestarted ist + options: >- + --health-cmd "redis-cli ping" + --health-interval 10s + --health-timeout 5s + --health-retries 5 + + steps: + # Laedt eine Kopie des Codes in Dein Repository herunter, bevor CI tests gestartet werden + - name: Check out repository code + uses: actions/checkout@v2 + + # Fuehrt eine saubere Installation aller abhaengigkeiten in der Datei `package.json` aus + # Weitere Informationen findest Du unter https://docs.npmjs.com/cli/ci.html + - name: Install dependencies + run: npm ci + + - name: Connect to Redis + # fuehrt ein Skript aus, das einen Redis-Cient erzeugt, + # Den Client mit Daten fuellt, und Daten abruft + run: node client.js + # Umgebungsvariable, mittels der das Skript `client.js` einen neuen Redis-Client erzeugt. + env: + # Der Hostname fuer die Kommunikation mit dem Redis-Service-Container + REDIS_HOST: redis + # Standarmaessiger Redis-Port + REDIS_PORT: 6379 +``` +{% endraw %} + +#### Den Container-Job konfigurieren + +{% data reusables.github-actions.service-container-host %} + +{% data reusables.github-actions.redis-label-description %} + +```yaml +jobs: + # Label des Container-Jobs + container-job: + # Container muessen in Linux-basierten Betriebssystemen laufen + runs-on: ubuntu-latest + # Docker-Hub-Image, in dem der `container-job` laeuft + container: node:10.18-jessie + + # Service-Container, die mit dem `container-job` laufen + services: + # Label zum Zugriff auf den Service-Container + redis: + # Docker-Hub-Image + image: redis + # Health-Checks so einstellen, dass sie warten, bis redis gestarted ist + options: >- + --health-cmd "redis-cli ping" + --health-interval 10s + --health-timeout 5s + --health-retries 5 +``` + +#### „Steps“ (Schritte) konfigurieren + +{% data reusables.github-actions.service-template-steps %} + +```yaml +steps: + # Laedt eine Kopie des Codes in Dein Repository herunter, bevor CI tests gestartet werden + - name: Check out repository code + uses: actions/checkout@v2 + + # Fuehrt eine saubere Installation aller abhaengigkeiten in der Datei `package.json` aus + # Weitere Informationen findest Du unter https://docs.npmjs.com/cli/ci.html + - name: Install dependencies + run: npm ci + + - name: Connect to Redis + # Fuehrt ein Skript aus, das einen Redis-Cient erzeugt, + # den Client mit Daten fuellt, und Daten abruft + run: node client.js + # Umgebungsvariable, mittels der das Skript `client.js` einen neuen Redis-Client erzeugt. + env: + # Der Hostname fuer die Kommunikation mit dem Redis-Service-Container + REDIS_HOST: redis + # Standarmaessiger Redis-Port + REDIS_PORT: 6379 +``` + +{% data reusables.github-actions.redis-environment-variables %} + +Der Hostname des Redis-Dienstes ist das Label, das Du in Deinem Workflow konfiguriert hast, in diesem Fall `redis`. Da Docker-Container im selben benutzerdefinierten Bridge-Netzwerk standardmäßig alle Ports öffnen, kannst Du auf den Service-Container über den Standard-Redis-Port 6379 zugreifen. + +### Jobs direkt auf der Runner-Maschine ausführen + +Wenn Du einen Job direkt auf der Runner-Maschine ausführst, musst Du die Ports des Service-Containers den Ports des Docker-Hosts zuordnen. Du kannst über den Docker-Host auf den Service-Container zugreifen, indem Du `localhost` und die Port-Nummer des Docker-Hosts verwendest. + +{% data reusables.github-actions.copy-workflow-file %} + +{% raw %} +```yaml +name: Redis runner example +on: push + +jobs: + # Label des Runner-Jobs + runner-job: + # Du brauchst eine Linux-Umgebung fuer Service-Container oder Container-Jobs + runs-on: ubuntu-latest + + # Service-Container, die mit dem `runner-job` laufen + services: + # Label zum Zugriff auf den Service-Container + redis: + # Docker-Hub-Image + image: redis + # Health-Checks so einstellen, dass sie warten, bis redis gestarted ist + options: >- + --health-cmd "redis-cli ping" + --health-interval 10s + --health-timeout 5s + --health-retries 5 + ports: + # Ordnet Port 6379 des Service-Containers dem Host zu + - 6379:6379 + + steps: + # Laedt eine Kopie des Codes in Dein Repository herunter, bevor CI tests gestartet werden + - name: Check out repository code + uses: actions/checkout@v2 + + # Fuehrt eine saubere Installation aller abhaengigkeiten in der Datei `package.json` aus + # Weitere Informationen findest Du unter https://docs.npmjs.com/cli/ci.html + - name: Install dependencies + run: npm ci + + - name: Connect to Redis + # Fuehrt ein Skript aus, das einen Redis-Cient erzeugt, + # den Client mit Daten fuellt, und Daten abruft + run: node client.js + # Umgebungsvariable, mittels der das Skript `client.js` + # einen neuen Redis-Client erzeugt. + env: + # Der Hostname fuer die Kommunikation mit dem Redis-Service-Container + REDIS_HOST: localhost + # Standarmaessiger Redis-Port + REDIS_PORT: 6379 +``` +{% endraw %} + +#### Runner-Job konfigurieren + +{% data reusables.github-actions.service-container-host-runner %} + +{% data reusables.github-actions.redis-label-description %} + +Der Workflow ordnet Port 6379 des Redis-Service-Containers dem Docker-Host zu. Weitere Informationen über das Schlüsselwort `ports` findest Du unter "[Informationen über Service-Container](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)." + +```yaml +jobs: + # Label des Runner-Jobs + runner-job: + # Fuer Service-Containers oder Container-Jobs brauchst Du eine Linux-Umgebung + runs-on: ubuntu-latest + + # Service-Container, die mit dem `runner-job` laufen + services: + # Label zum Zugriff auf den Service-Container + redis: + # Docker-Hub-Image + image: redis + # Health-Checks so einstellen, dass sie warten, bis redis gestarted ist + options: >- + --health-cmd "redis-cli ping" + --health-interval 10s + --health-timeout 5s + --health-retries 5 + ports: + # Ordnet Port 6379 des Service-Containers dem Host zu + - 6379:6379 +``` + +#### „Steps“ (Schritte) konfigurieren + +{% data reusables.github-actions.service-template-steps %} + +```yaml +steps: + # Laedt eine Kopie des Codes in Dein Repository herunter, bevor CI tests gestartet werden + - name: Check out repository code + uses: actions/checkout@v2 + + # Fuehrt eine saubere Installation aller abhaengigkeiten in der Datei `package.json` durch + # Weitere Informationen findest Du unter https://docs.npmjs.com/cli/ci.html + - name: Install dependencies + run: npm ci + + - name: Connect to Redis + # Fuehrt ein Skript aus, das einen Redis-Cient erzeugt, + # den Client mit Daten fuellt, und Daten abruft + run: node client.js + # Umgebungsvariable, mittels der das Skript `client.js` + # einen neuen Redis-Client erzeugt. + env: + # Der Hostname fuer die Kommunikation mit dem Redis-Service-Container + REDIS_HOST: localhost + # Standarmaessiger Redis-Port + REDIS_PORT: 6379 +``` + +{% data reusables.github-actions.redis-environment-variables %} + +{% data reusables.github-actions.service-container-localhost %} + +### Redis-Sercive-Container testen + +Du kannst Deinen Workflow mit dem folgenden Skript testen, das einen Redis-Client erstellt und den Client mit Platzhalter-Daten füllt. Das Skript gibt dann die im Redis-Client gespeicherten Werte auf dem Terminal aus. Dein Skript kann jede beliebige Sprache verwenden, aber dieses Beispiel verwendet Node.js und das `redis`-npm-Modul. Weitere Informationen findest Du unter [npm-Redis-Modul](https://www.npmjs.com/package/redis). + +Du kannst *client.js* anpassen, um alle Redis-Operationen abzudecken, die Dein Workflow braucht. In diesem Beispiel erstellt das Skript die Redis-Client-Instanz, fügt Platzhalter-Daten hinzu und ruft dann die Daten ab. + +{% data reusables.github-actions.service-container-add-script %} + +```javascript +const redis = require("redis"); + +// Erzeugt einen neuen Redis-Client +// Falls REDIS_HOST nicht definiert ist, ist der Host standarmaessig localhost +// Falls REDIS_PORT nicht definiert ist, ist der Standard-Port 6379 +const redisClient = redis.createClient({ + host: process.env.REDIS_HOST, + port: process.env.REDIS_PORT +}); + +redisClient.on("error", function(err) { + console.log("Error " + err); +}); + +// Setzt den Schluessel "octocat" auf den Wert "Mona the octocat" +redisClient.set("octocat", "Mona the Octocat", redis.print); +// Setzt einen Schluessel auf "octocat", Feld auf "species", und "value" auf "Cat and Octopus" +redisClient.hset("species", "octocat", "Cat and Octopus", redis.print); +// Setzt einen Schluessel auf "octocat", Feld auf "species", und "value" auf "Dinosaur and Octopus" +redisClient.hset("species", "dinotocat", "Dinosaur and Octopus", redis.print); +// Setzt einen Schluessel auf "octocat", Feld auf "species", und "value" auf "Cat and Robot" +redisClient.hset(["species", "robotocat", "Cat and Robot"], redis.print); +// Holt alle Felder vom Schluessel "species" + +redisClient.hkeys("species", function (err, replies) { + console.log(replies.length + " replies:"); + replies.forEach(function (reply, i) { + console.log(" " + i + ": " + reply); + }); + redisClient.quit(); +}); +``` + +Das Skript erstellt einen neuen Redis-Client mit der Methode `createClient`, welche die Parameter `host` und `port` akzeptiert. Das Skript verwendet die Umgebungsvariablen `REDIS_HOST` und `REDIS_PORT`, um die IP-Adresse und den Port des Clients festzulegen. Wenn `host` und `port` nicht definiert sind, ist der Standard-Host `localhost` und der Standard-Port 6379. + +Das Skript verwendet die Methoden `set` und `hset`, um die Datenbank mit einigen Schlüsseln, Feldern und Werten zu füllen. Um zu bestätigen, dass der Redis-Client die Daten enthält, gibt das Skript den Inhalt der Datenbank in das Konsolen-Log aus. + +Wenn Du diesen Workflow ausführst, solltest Du im Schritt „Mit Redis verbinden“ die folgende Ausgabe sehen, welche zeigt, dass Du den Redis-Client erstellt und Daten hinzugefügt hast: + +``` +Reply: OK +Reply: 1 +Reply: 1 +Reply: 1 +3 replies: + 0: octocat + 1: dinotocat + 2: robotocat +``` diff --git a/translations/de-DE/content/actions/guides/index.md b/translations/de-DE/content/actions/guides/index.md new file mode 100644 index 000000000000..b9c81382af92 --- /dev/null +++ b/translations/de-DE/content/actions/guides/index.md @@ -0,0 +1,60 @@ +--- +title: Leitfäden +shortTitle: Leitfäden +intro: 'These guides for {% data variables.product.prodname_actions %} include specific use cases and examples to help you configure workflows.' +redirect_from: + - /actions/guides/caching-and-storing-workflow-data + - /actions/automating-your-workflow-with-github-actions/using-databases-and-services + - /actions/configuring-and-managing-workflows/using-databases-and-service-containers + - /actions/guides/using-databases-and-service-containers + - /actions/language-and-framework-guides + - /actions/language-and-framework-guides/github-actions-for-docker + - /actions/language-and-framework-guides/github-actions-for-java + - /actions/language-and-framework-guides/github-actions-for-javascript-and-typescript + - /actions/language-and-framework-guides/github-actions-for-python + - /actions/publishing-packages-with-github-actions + - /actions/building-and-testing-code-with-continuous-integration +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Creating custom continuous integration workflows + +You can use {% data variables.product.prodname_actions %} to create custom continuous integration (CI) workflows that build and test projects written in different programming languages. + +{% link_in_list /about-continuous-integration %} +{% link_in_list /setting-up-continuous-integration-using-workflow-templates %} +{% link_in_list /building-and-testing-nodejs %} +{% link_in_list /building-and-testing-python %} +{% link_in_list /building-and-testing-java-with-maven %} +{% link_in_list /building-and-testing-java-with-gradle %} +{% link_in_list /building-and-testing-java-with-ant %} + +### Publishing software packages + +You can automate publishing software packages as part your continuous delivery (CD) workflow. Packages can be published to any package host and to {% data reusables.gated-features.packages %}. + +{% link_in_list /about-packaging-with-github-actions %} +{% link_in_list /publishing-nodejs-packages %} +{% link_in_list /publishing-java-packages-with-maven %} +{% link_in_list /publishing-java-packages-with-gradle %} +{% link_in_list /publishing-docker-images %} + +### Workflow-Daten speichern und zwischenspeichern + +Abhängigkeiten zwischenspeichern und Artefakte speichern, um Deinen Workflow effizienter ablaufen zu lassen. + +{% link_in_list /storing-workflow-data-as-artifacts %} +{% link_in_list /caching-dependencies-to-speed-up-workflows %} + +### Using service containers in a workflow + +Connect services to your workflow using service containers. + +{% link_in_list /about-service-containers %} +{% link_in_list /creating-redis-service-containers %} +{% link_in_list /creating-postgresql-service-containers %} diff --git a/translations/de-DE/content/actions/guides/publishing-docker-images.md b/translations/de-DE/content/actions/guides/publishing-docker-images.md new file mode 100644 index 000000000000..2f09b1a6ed0f --- /dev/null +++ b/translations/de-DE/content/actions/guides/publishing-docker-images.md @@ -0,0 +1,158 @@ +--- +title: Docker-Images veröffentlichen +intro: 'Du kannst Docker-Images im Rahmen Deines Workflows zur kontinuierlichen Integration (CI) in einer Registry wie zum Beispiel „Docker Hub“ oder {% data variables.product.prodname_registry %} veröffentlichen.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /actions/language-and-framework-guides/publishing-docker-images +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Einführung + +Diese Anleitung zeigt Dir, wie Du einen Workflow erstellen kannst, der einen Docker-Build ausführt und dann Docker-Images auf „Docker Hub“ oder {% data variables.product.prodname_registry %} veröffentlicht. Mit einem einzelnen Workflow kannst Du Images in einer einzigen Registry oder in mehreren Registries veröffentlichen. + +{% note %} + +**Hinweis:** Wenn Du auf eine andere Docker-Registriery eines Drittanbieters pushen möchtest, kann das Beispiel im Abschnitt [Veröffentlichen von Images auf {% data variables.product.prodname_registry %}](#publishing-images-to-github-packages)" als gute Vorlage dienen. + +{% endnote %} + +### Vorrausetzungen + +Wir empfehlen, dass Du ein grundlegendes Verständnis von Workflowkonfigurations-Optionen hast und darüber, wie Du eine Workflow-Datei erstellst. For more information, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." + +Vielleicht findest Du es auch hilfreich, ein grundlegendes Verständnis von Folgendem zu haben: + +- "[Encrypted secrets](/actions/reference/encrypted-secrets)" +- "[Authentication in a workflow](/actions/reference/authentication-in-a-workflow)" +- „[Docker für den Einsatz mit {% data variables.product.prodname_registry %} konfigurieren](/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)“ + +### Informationen zur Image-Konfiguration + +In dieser Anleitung wird davon ausgegangen, dass Du eine vollständige Definition für ein Docker-Image in einem {% data variables.product.prodname_dotcom %}-Repository gespeichert hast. Dein Projektarchiv muss beispielsweise eine _Dockerdatei_ und alle anderen Dateien enthalten, die benötigt werden, um einen Docker-Build zum Erstellen eines Images durchzuführen. + +In dieser Anleitung wir werden die Docker-Aktion `build-push-action` verwenden, um das Docker-Image zu bauen und es auf eine oder mehrere Docker-Registries zu übertragen. Weitere Informationen findest Du unter [`build-push-action`](https://github.com/marketplace/actions/build-and-push-docker-images). + +{% data reusables.actions.enterprise-marketplace-actions %} + +### Images auf dem „Docker Hub“ veröffentlichen + +{% data reusables.github-actions.release-trigger-workflow %} + +Im folgenden Beispiel-Workflow verwenden wir die Docker-Aktion `build-push-action`, um das Docker-Image zu bauen und, wenn der Build erfolgreich ist, das gebaute Image auf „Docker Hub“ zu übertragen. + +Um zum „Docker Hub“ zu pushen, benötigst Du ein Benutzerkonto auf „Docker Hub“ und musst ein „Docker Hub“-Repository erstellt haben. Weitere Informationen findest Du unter „[Images auf ‚Docker Hub‘ freigeben](https://docs.docker.com/get-started/part3/)“ in der Docker-Dokumentation. + +„Docker Hub“ benötigt für `build-push-action` die folgenden Optionen: + +* `username` und `password`: Dies ist Dein Benutzername und Passwort auf „Docker Hub“. Wir empfehlen Dir, Deinen „Docker Hub“-Benutzernamen und das -Passwort als verschlüsselte Geheimnisse in Deinem {% data variables.product.prodname_dotcom %}-Repository zu speichern, damit diese nicht in Deiner Workflow-Datei enthüllt werden. Weitere Informationen findest Du unter „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“. +* `repository`: Dein „Docker Hub“-Repository im Format `DOCKER-HUB-NAMESPACE/DOCKER-HUB-REPOSITORY`. + +{% raw %} +```yaml +name: Publish Docker image +on: + release: + types: [published] +jobs: + push_to_registry: + name: Push Docker image to Docker Hub + runs-on: ubuntu-latest + steps: + - name: Check out the repo + uses: actions/checkout@v2 + - name: Push to Docker Hub + uses: docker/build-push-action@v1 + with: + username: ${{ secrets.DOCKER_USERNAME }} + password: ${{ secrets.DOCKER_PASSWORD }} + repository: my-docker-hub-namespace/my-docker-hub-repository + tag_with_ref: true +``` +{% endraw %} + +{% data reusables.github-actions.docker-tag-with-ref %} + +### Images in {% data variables.product.prodname_registry %} veröffentlichen + +{% data reusables.github-actions.release-trigger-workflow %} + +Im folgenden Beispiel-Workflow verwenden wir die Docker-Aktion `build-push-action`, um das Docker-Image zu bauen und, wenn der Build erfolgreich ist, das gebaute Image nach {% data variables.product.prodname_registry %} zu übertragen. + +Die für {% data variables.product.prodname_registry %} erforderlichen `build-push-action`-Optionen sind: + +* `username`: Du kannst mithilfe des Kontexts von {% raw %}`${{ github.actor }}`{% endraw %} automatisch den Benutzernamen des Benutzers zu verwenden, der die Workflow-Ausführung angestoßen hat. Weitere Informationen findest Du unter „[Kontext- und Ausdrucks-Syntax für GitHub-Aktionen](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)“. +* `password`: Du kannst das automatisch generierte Geheimnis `GITHUB_TOKEN` als Passwort verwenden. Weitere Informationen findest Du unter „[Authentifizierung mit dem GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)". +* `registry`: Muss auf `docker.pkg.github.com` gesetzt werden. +* `repository`: Muss im Format `OWNER/REPOSITORY/IMAGE_NAME` gesetzt werden. Beispiel: Für ein Bild namens `octo-image` auf {% data variables.product.prodname_dotcom %} unter `http://github. om/octo-org/octo-repo` sollte die Option `repository` auf `octo-org/octo-repo/octo-image` gesetzt werden. + +{% raw %} +```yaml +name: Publish Docker image +on: + release: + types: [published] +jobs: + push_to_registry: + name: Push Docker image to GitHub Packages + runs-on: ubuntu-latest + steps: + - name: Check out the repo + uses: actions/checkout@v2 + - name: Push to GitHub Packages + uses: docker/build-push-action@v1 + with: + username: ${{ github.actor }} + password: ${{ secrets.GITHUB_TOKEN }} + registry: docker.pkg.github.com + repository: my-org/my-repo/my-image + tag_with_ref: true + +``` +{% endraw %} + +{% data reusables.github-actions.docker-tag-with-ref %} + +### Images auf dem „Docker Hub“ und in der {% data variables.product.prodname_registry %} veröffentlichen + +In einem einzigen Workflow kannst Du Dein Docker-Image in mehreren Registries veröffentlichen, indem Du die Aktion `build-push-action` auf jede Registry anwendest. + +Der folgende Beispiel-Workflow verwendet die Schritte der `build-push-action` aus den vorherigen Abschnitten („[Veröffentlichung von Bildern auf ‚Docker Hub‘](#publishing-images-to-docker-hub)“ und „[Veröffentlichung von Bildern in {% data variables.product.prodname_registry %}](#publishing-images-to-github-packages)“), um einen einzigen Workflow zu erstellen, der in beide Registries pusht. + +{% raw %} +```yaml +name: Publish Docker image +on: + release: + types: [published] +jobs: + push_to_registries: + name: Push Docker image to multiple registries + runs-on: ubuntu-latest + steps: + - name: Check out the repo + uses: actions/checkout@v2 + - name: Push to Docker Hub + uses: docker/build-push-action@v1 + with: + username: ${{ secrets.DOCKER_USERNAME }} + password: ${{ secrets.DOCKER_PASSWORD }} + repository: my-docker-hub-namespace/my-docker-hub-repository + tag_with_ref: true + - name: Push to GitHub Packages + uses: docker/build-push-action@v1 + with: + username: ${{ github.actor }} + password: ${{ secrets.GITHUB_TOKEN }} + registry: docker.pkg.github.com + repository: my-org/my-repo/my-image + tag_with_ref: true +``` +{% endraw %} + +Der obige Workflow checkt das {% data variables.product.prodname_dotcom %}-Repository aus und verwendet die Aktion `build-push-action` zweimal, um das Docker-Image zu erstellen und sowohl auf den „Docker Hub“ als auch in die {% data variables.product.prodname_registry %} zu übertragen. Für beide Schritte, setzt er die Option `build-push-action` auf [`tag_with_ref`](https://github.com/marketplace/actions/build-and-push-docker-images#tag_with_ref) um das gebaute Docker-Image automatisch mit der Git-Referenz des Workflow-Ereignisses zu kennzeichnen. Dieser Workflow wird bei der Veröffentlichung eines {% data variables.product.prodname_dotcom %}-Releases ausgelöst, so dass die Referenz für beide Registries das Git-Tag des Releases ist. diff --git a/translations/de-DE/content/actions/guides/publishing-java-packages-with-gradle.md b/translations/de-DE/content/actions/guides/publishing-java-packages-with-gradle.md new file mode 100644 index 000000000000..d2478ac17e95 --- /dev/null +++ b/translations/de-DE/content/actions/guides/publishing-java-packages-with-gradle.md @@ -0,0 +1,219 @@ +--- +title: Java-Pakete mit Gradle veröffentlichen +intro: Du kannst Gradle verwenden, um Java-Pakete als Teil Deines Workflows zur kontinuierlichen Integration (CI) in einer Registry zu veröffentlichen. +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /actions/language-and-framework-guides/publishing-java-packages-with-gradle +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Einführung + +{% data reusables.github-actions.publishing-java-packages-intro %} + +### Vorrausetzungen + +Wir empfehlen Dir, ein grundlegendes Verständnis von Workflow-Dateien und Konfigurationsoptionen zu haben. For more information, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." + +Weitere Informationen zum Erstellen eines CI-Workflows für Dein Java-Projekt mit Gradle findest Du unter „[Java bauen und testen mit Gradle](/actions/language-and-framework-guides/building-and-testing-java-with-gradle)“. + +Vielleicht findest Du es auch hilfreich, ein grundlegendes Verständnis von Folgendem zu haben: + +- „[Konfiguration von npm für die Verwendung mit {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)“ +- "[Environment variables](/actions/reference/environment-variables)" +- "[Encrypted secrets](/actions/reference/encrypted-secrets)" +- "[Authentication in a workflow](/actions/reference/authentication-in-a-workflow)" + +### Informationen zur Paketkonfiguration + +Die Felder `groupId` und `artifactId` im Abschnitt `MavenPublication` der Datei _build.gradle_ bilden eine eindeutige Kennung für Dein Paket. Registries verwenden diese Kennung, um Dein Paket mit einer Registry zu verknüpfen. Dies ist so ähnlich wie bei den Feldern `groupId` und `artifactId` der Maven-Datei _pom.xml_. Weitere Informationen findest Du unter „[‚Maven Publish Plugin‘](https://docs.gradle.org/current/userguide/publishing_maven.html)“ in der Gradle-Dokumentation. + +Die Datei _build.gradle_ enthält auch die Konfiguration für die Distributionsverwaltungs-Repositories, zu denen Gradle dann Pakete veröffentlicht. Jedes Repository braucht einen Namen, eine Deployment-URL und Anmeldeinformationen zur Authentifizierung. + +### Pakete im „Maven Central Repository“ veröffentlichen + +Jedes Mal, wenn Du ein neues Release erstellst, kannst Du einen Workflow anstoßen, um Dein Paket zu veröffentlichen. Der Workflow im folgenden Beispiel wird von dem Ereignis `release` vom Typ `created` angestoßen. Der Workflow veröffentlicht das Paket im „Maven Central Repository“, sofern es die CI-Tests besteht. Weitere Informationen zum Ereignis `release` findest Du unter „[Ereignisse, die Workflows anstoßen](/actions/reference/events-that-trigger-workflows#release)“. + +Du kannst ein neues Maven-Repository im Block `publishing` Deiner Datei _build.gradle_ definieren, das auf Dein Paket-Repository verweist. Wenn Du zum Beispiel über das OSSRH-Hosting-Projekt in das „Maven Central Repository“ deployst, kann Deine _build.gradle_ ein Repository mit dem Namen `"OSSRH"` bestimmen. + +{% raw %} +```groovy +publishing { + ... + + repositories { + maven { + name = "OSSRH" + url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/" + credentials { + username = System.getenv("MAVEN_USERNAME") + password = System.getenv("MAVEN_PASSWORD") + } + } + } +} +``` +{% endraw %} + +Mit dieser Konfiguration kannst Du einen Workflow erstellen, der mithilfe des Befehls `gradle publish` Dein Paket im „Maven Central Repository“ veröffentlicht. Du musst auch Umgebungsvariablen bereitstellen, die den Benutzernamen und das Kennwort enthalten, um Dich im Repository zu authentifizieren. + +Im Deploy-Schritt musst Du Umgebungsvariablen für den Benutzernamen und das Passwort oder für den Token festlegen, mit dem Du Dich im Maven-Repository authentifizierst. Weitere Informationen findest Du unter "[Verschlüsselte Geheimnisse erstellen und verwenden](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". + + +{% raw %} +```yaml +name: Publish package to the Maven Central Repository +on: + release: + types: [created] +jobs: + publish: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Set up Java + uses: actions/setup-java@v1 + with: + java-version: 1.8 + - name: Publish package + run: gradle publish + env: + MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }} + MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }} +``` +{% endraw %} + +{% data reusables.github-actions.gradle-workflow-steps %} +1. Führt den Befehl `gradle publish` aus, um im Maven-Repository `OSSRH` zu veröffentlichen. Die Umgebungsvariable `MAVEN_USERNAME` wird mit dem Inhalt Deines Geheimnisses `OSSRH_USERNAME` gefüllt, und die Umgebungsvariable `MAVEN_PASSWORD` wird mit dem Inhalt Deines Geheimnisses `OSSRH_TOKEN` gefüllt. + + Weitere Informationen zur Verwendung von Geheimnissen in Deinem Workflow findest Du unter „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“. + +### Pakete in der {% data variables.product.prodname_registry %} veröffentlichen + +Jedes Mal, wenn Du ein neues Release erstellst, kannst Du einen Workflow anstoßen, um Dein Paket zu veröffentlichen. Der Workflow im folgenden Beispiel wird von dem Ereignis `release` vom Typ `created` angestoßen. Der Workflow veröffentlicht das Paket in {% data variables.product.prodname_registry %} , wenn die CI-Tests bestanden wurden. Weitere Informationen zum Ereignis `release` findest Du unter „[Ereignisse, die Workflows anstoßen](/actions/reference/events-that-trigger-workflows#release)“. + +Du kannst ein neues Maven-Repository im Block `publishing` Deiner Datei _build.gradle_ definieren, das auf {% data variables.product.prodname_registry %} verweist. In dieser Repository-Konfiguration kannst Du auch die in Deinem CI-Workflow-Lauf eingestellten Umgebungsvariablen nutzen. Du kannst die Umgebungsvariable `GITHUB_ACTOR` als Benutzernamen verwenden und die Umgebungsvariable `GITHUB_TOKEN` auf Dein `GITHUB_TOKEN`-Geheimnis setzen. + +Der `GITHUB_TOKEN` existiert standardmäßig in Deinem Repository und hat Lese- und Schreibrechte für Pakete in dem Repository, in dem der Workflow läuft. Weitere Informationen findest Du unter „[Authentifizierung mit dem GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." + +Wenn beispielsweise Deine Organisation „octocat“ und Dein Repository „hello-world“ heißt, sieht die {% data variables.product.prodname_registry %}-Konfiguration in _build.gradle_ so ähnlich wie im folgenden Beispiel aus. + +{% raw %} +```groovy +publishing { + ... + + repositories { + maven { + name = "GitHubPackages" + url = "https://maven.pkg.github.com/octocat/hello-world" + credentials { + username = System.getenv("GITHUB_ACTOR") + password = System.getenv("GITHUB_TOKEN") + } + } + } +} +``` +{% endraw %} + +Mit dieser Konfiguration kannst Du einen Workflow erstellen, der mithilfe des Befehls `gradle publish` Dein Paket im „Maven Central Repository“ veröffentlicht. + +{% raw %} +```yaml +name: Publish package to GitHub Packages +on: + release: + types: [created] +jobs: + publish: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - uses: actions/setup-java@v1 + with: + java-version: 1.8 + - name: Publish package + run: gradle publish + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} +``` +{% endraw %} + +{% data reusables.github-actions.gradle-workflow-steps %} +1. Führt den Befehl `gradle publish` aus, um in {% data variables.product.prodname_registry %} zu veröffentlichen. Die Umgebungsvariable `GITHUB_TOKEN` wird mit dem Inhalt des `GITHUB_TOKEN`-Geheimnisses gefüllt. + + Weitere Informationen zur Verwendung von Geheimnissen in Deinem Workflow findest Du unter „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“. + +### Pakete im Maven Central Repository und in der {% data variables.product.prodname_registry %} veröffentlichen + +Du kannst Deine Pakete sowohl im Maven Central Repository als auch in der {% data variables.product.prodname_registry %} veröffentlichen, indem Du beides in Deiner Datei _build.gradle_ konfigurierst. + +Stelle sicher, dass Deine Datei _build.gradle_ ein Repository sowohl für Dein {% data variables.product.prodname_dotcom %}-Repository als auch Deinen „Maven Central Repository“-Provider enthält. + +Wenn Du beispielsweise über das OSSRH-Hosting-Projekt in das Central Repository deployen willst, kannst Du das in einem Distributionsverwaltungs-Repository angeben, wobei Du den `-name` auf `OSSRH` setzt. Wenn Du in die {% data variables.product.prodname_registry %} deployen willst, kannst Du das in einem Distributionsverwaltungs-Repository angeben, wobei Du den `-name` auf `GitHubPackages` setzt. + +Wenn Deine Organisation „octocat“ und Dein Repository „hello-world“ heißt, sieht die {% data variables.product.prodname_registry %}-Konfiguration in _build.gradle_ so ähnlich wie im folgenden Beispiel aus. + +{% raw %} +```groovy +publishing { + ... + + repositories { + maven { + name = "OSSRH" + url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/" + credentials { + username = System.getenv("MAVEN_USERNAME") + password = System.getenv("MAVEN_PASSWORD") + } + } + maven { + name = "GitHubPackages" + url = "https://maven.pkg.github.com/octocat/hello-world" + credentials { + username = System.getenv("GITHUB_ACTOR") + password = System.getenv("GITHUB_TOKEN") + } + } + } +} +``` +{% endraw %} + +Mit dieser Konfiguration kannst Du einen Workflow erstellen, der mithilfe des Befehls `gradle publish` Dein Paket sowohl im „Maven Central Repository“ als auch in der {% data variables.product.prodname_registry %} veröffentlicht. + +{% raw %} +```yaml +name: Publish package to the Maven Central Repository and GitHub Packages +on: + release: + types: [created] +jobs: + publish: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Set up Java + uses: actions/setup-java@v1 + with: + java-version: 1.8 + - name: Publish to the Maven Central Repository + run: gradle publish + env: + MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }} + MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }} + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} +``` +{% endraw %} + +{% data reusables.github-actions.gradle-workflow-steps %} +1. Führt den Befehl `gradle publish` aus, um im Maven-Repository `OSSRH` und in der {% data variables.product.prodname_registry %} zu veröffentlichen. Die Umgebungsvariable `MAVEN_USERNAME` wird mit dem Inhalt Deines Geheimnisses `OSSRH_USERNAME` gefüllt, und die Umgebungsvariable `MAVEN_PASSWORD` wird mit dem Inhalt Deines Geheimnisses `OSSRH_TOKEN` gefüllt. Die Umgebungsvariable `GITHUB_TOKEN` wird mit dem Inhalt des `GITHUB_TOKEN`-Geheimnisses gefüllt. + + Weitere Informationen zur Verwendung von Geheimnissen in Deinem Workflow findest Du unter „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“. diff --git a/translations/de-DE/content/actions/guides/publishing-java-packages-with-maven.md b/translations/de-DE/content/actions/guides/publishing-java-packages-with-maven.md new file mode 100644 index 000000000000..0e085f18c0a0 --- /dev/null +++ b/translations/de-DE/content/actions/guides/publishing-java-packages-with-maven.md @@ -0,0 +1,210 @@ +--- +title: Java-Pakete mit Maven veröffentlichen +intro: Du kannst Maven verwenden, um Java-Pakete als Teil Deines Workflows zur kontinuierlichen Integrations (CI) in eine Registry zu veröffentlichen. +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /actions/language-and-framework-guides/publishing-java-packages-with-maven +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Einführung + +{% data reusables.github-actions.publishing-java-packages-intro %} + +### Vorrausetzungen + +Wir empfehlen Dir, ein grundlegendes Verständnis von Workflow-Dateien und Konfigurationsoptionen zu haben. For more information, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." + +Weitere Informationen zum Erstellen eines CI-Workflows für Dein Java-Projekt mit Maven findest Du unter "[Java mit Maven erstellen und testen](/actions/language-and-framework-guides/building-and-testing-java-with-maven)." + +Vielleicht findest Du es auch hilfreich, ein grundlegendes Verständnis von Folgendem zu haben: + +- „[Konfiguration von npm für die Verwendung mit {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)“ +- "[Environment variables](/actions/reference/environment-variables)" +- "[Encrypted secrets](/actions/reference/encrypted-secrets)" +- "[Authentication in a workflow](/actions/reference/authentication-in-a-workflow)" + +### Informationen zur Paketkonfiguration + +Die Felder `groupId` und `artifactId` in der Datei _pom.xml_ bilden eine eindeutige Kennung für Dein Paket. Registries verwenden diese Kennung, um Dein Paket mit einer Registry zu verknüpfen. Weitere Informationen findest Du unter [Leitfaden zum Hochladen von Artefakten in das Central Repository](http://maven.apache.org/repository/guide-central-repository-upload.html) in der „Apache Maven“-Dokumentation. + +Die Datei _pom.xml_ enthält auch die Konfiguration für die Distributionsverwaltungs-Repositories, in denen Maven Pakete veröffentlicht. Jedes Repository braucht einen Namen und eine „Deployment-URL“ (Bereitstellungs-URL). Die Authentifizierung für diese Repositories kann in der Datei _.m2/settings.xml_ im Home-Verzeichnis des Benutzers konfiguriert werden, der Maven verwendet. + +Du kannst die Aktion `setup-java` verwenden, um das Deployment-Repository sowie die Authentifizierung für dieses Repository zu konfigurieren. Weitere Informationen findest Du unter [`setup-java`](https://github.com/actions/setup-java). + +### Pakete im „Maven Central Repository“ veröffentlichen + +Jedes Mal, wenn Du ein neues Release erstellst, kannst Du einen Workflow anstoßen, um Dein Paket zu veröffentlichen. Der Workflow im folgenden Beispiel wird von dem Ereignis `release` vom Typ `created` angestoßen. Der Workflow veröffentlicht das Paket im „Maven Central Repository“, sofern es die CI-Tests besteht. Weitere Informationen zum Ereignis `release` findest Du unter „[Ereignisse, die Workflows anstoßen](/actions/reference/events-that-trigger-workflows#release)“. + +In diesem Workflow kannst Du die Aktion `setup-java` verwenden. Diese Aktion installiert die angegebene JDK-Version in den `PATH`, aber sie konfiguriert auch eine _settings.xml_ für Maven, um Pakete zu veröffentlichen. Standardmäßig wird die Settings-Datei für {% data variables.product.prodname_registry %} konfiguriert, aber sie kann dazu konfiguriert werden, in eine andere Paket-Registry wie z.B. das „Maven Central Repository“ zu deployen. Wenn Du bereits ein Distributions-Management-Repository im _pom.xml_ konfiguriert hast, dann kannst Du beim Aufruf der Aktion `setup-java` diese `id` angeben. + +Wenn Du zum Beispiel über das OSSRH-Hosting-Projekt ins „Maven Central Repository“ deployst, kann Deine _pom.xml_ ein Distributions-Management-Repository mit `ossrh` als `id` angeben. + +{% raw %} +```xml + + ... + + + ossrh + Central Repository OSSRH + https://oss.sonatype.org/service/local/staging/deploy/maven2/ + + + +``` +{% endraw %} + +Mit dieser Konfiguration kannst Du einen Workflow erstellen, der Dein Paket im „Maven Central Repository“ veröffentlicht, indem Du die Repository-Verwaltungs-`id` in der Aktion `setup-java` angibst. Du musst auch Umgebungsvariablen bereitstellen, die den Benutzernamen und das Kennwort enthalten, um Dich im Repository zu authentifizieren. + +Im Deploy-Schritt musst Du die Umgebungsvariablen auf den Benutzernamen setzen, mit dem Du Dich im Repository anmeldest, und auf ein Geheimnis, das Du mit dem Passwort oder dem Token konfiguriert hast, mit dem Du Dich authentifizierst. Weitere Informationen findest Du unter "[Verschlüsselte Geheimnisse erstellen und verwenden](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". + + +{% raw %} +```yaml +name: Publish package to the Maven Central Repository +on: + release: + types: [created] +jobs: + publish: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Set up Maven Central Repository + uses: actions/setup-java@v1 + with: + java-version: 1.8 + server-id: ossrh + server-username: MAVEN_USERNAME + server-password: MAVEN_PASSWORD + - name: Publish package + run: mvn -B deploy + env: + MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }} + MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }} +``` +{% endraw %} + +Dieser Workflow führt die folgenden Schritte aus: + +1. Checkt eine Kopie des Projekt-Repositorys aus. +1. Richtet das „Java JDK“ ein und konfiguriert die Maven-Datei _settings.xml_, um die Authentifizierung für das Repository `ossrh` mit den Umgebungsvariablen `MAVEN_USERNAME` und `MAVEN_PASSWORD` hinzuzufügen. +1. {% data reusables.github-actions.publish-to-maven-workflow-step %} + + Weitere Informationen zur Verwendung von Geheimnissen in Deinem Workflow findest Du unter „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“. + +### Pakete in der {% data variables.product.prodname_registry %} veröffentlichen + +Jedes Mal, wenn Du ein neues Release erstellst, kannst Du einen Workflow anstoßen, um Dein Paket zu veröffentlichen. Der Workflow im folgenden Beispiel wird von dem Ereignis `release` vom Typ `created` angestoßen. Der Workflow veröffentlicht das Paket in {% data variables.product.prodname_registry %} , wenn die CI-Tests bestanden wurden. Weitere Informationen zum Ereignis `release` findest Du unter „[Ereignisse, die Workflows anstoßen](/actions/reference/events-that-trigger-workflows#release)“. + +In diesem Workflow kannst Du die Aktion `setup-java` verwenden. Diese Aktion installiert die angegebene JDK-Version in den `PATH` und stellt auch Maven- _settings.xml_ ein, um Paket in der {% data variables.product.prodname_registry %} zu veröffentlichen. Die generierte _settings.xml_ definiert die Authentifizierung für einen Server mit einer `id` von `github` und verwendet die Umgebungsvariable `GITHUB_ACTOR` als Benutzername und die Umgebungsvariable `GITHUB_TOKEN` als Passwort. + +Der `GITHUB_TOKEN` existiert standardmäßig in Deinem Repository und hat Lese- und Schreibrechte für Pakete in dem Repository, in dem der Workflow läuft. Weitere Informationen findest Du unter „[Authentifizierung mit dem GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." + +Für ein Maven-basiertes Projekt kannst Du diese Einstellungen nutzen, indem Du ein Distributions-Repository in Deiner Datei _pom.xml_ mit einer `id` von `Github` erstellst, das auf Deinen {% data variables.product.prodname_registry %}-Endpunkt zeigt. + +Wenn beispielsweise Deine Organisation „octocat“ und Dein Repository „hello-world“ heißt, sieht die {% data variables.product.prodname_registry %}-Konfiguration in _pom.xml_ so ähnlich wie im folgenden Beispiel aus. + +{% raw %} +```xml + + ... + + + github + GitHub Packages + https://maven.pkg.github.com/octocat/hello-world + + + +``` +{% endraw %} + +Mit dieser Konfiguration kannst Du einen Workflow erstellen, der Dein Paket in der {% data variables.product.prodname_registry %} veröffentlicht, indem Du die automatisch generierte _settings.xml_ verwendest. + +{% raw %} +```yaml +name: Publish package to GitHub Packages +on: + release: + types: [created] +jobs: + publish: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - uses: actions/setup-java@v1 + with: + java-version: 1.8 + - name: Publish package + run: mvn -B deploy + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} +``` +{% endraw %} + +Dieser Workflow führt die folgenden Schritte aus: + +1. Checkt eine Kopie des Projekt-Repositorys aus. +1. Richtet das Java JDK ein und konfiguriert auch automatisch die Maven-Datei _settings.xml_, um Authentifizierung für das `github`-Maven-Repository hinzuzufügen, um die Umgebungsvariable `GITHUB_TOKEN` zu verwenden. +1. {% data reusables.github-actions.publish-to-packages-workflow-step %} + + Weitere Informationen zur Verwendung von Geheimnissen in Deinem Workflow findest Du unter „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“. + +### Pakete im Maven Central Repository und in der {% data variables.product.prodname_registry %} veröffentlichen + +Du kannst Deine Pakete sowohl im Maven Central Repository als auch in der {% data variables.product.prodname_registry %} veröffentlichen, indem Du die Aktion `setup-java` für jede Registry verwendest. + +Stelle sicher, dass Deine Datei _pom.xml_ ein Distributionsmanagement-Repository sowohl für Dein {% data variables.product.prodname_dotcom %}-Repository als auch Deinen „Maven Central Repository“-Provider enthält. Wenn Du z.B. über das Hosting-Projekt OSSRH in das Central Repository deployst, solltest Du es vielleicht in einem Distributionsverwaltungs-Repository mit `ossrh` als `id` angeben, und Du solltest {% data variables.product.prodname_registry %} in einem Distributionsverwaltungs-Repository mit `github` als `id` setzen. + +{% raw %} +```yaml +name: Publish package to the Maven Central Repository and GitHub Packages +on: + release: + types: [created] +jobs: + publish: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Set up Java for publishing to Maven Central Repository + uses: actions/setup-java@v1 + with: + java-version: 1.8 + server-id: ossrh + server-username: MAVEN_USERNAME + server-password: MAVEN_PASSWORD + - name: Publish to the Maven Central Repository + run: mvn -B deploy + env: + MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }} + MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }} + - name: Set up Java for publishing to GitHub Packages + uses: actions/setup-java@v1 + with: + java-version: 1.8 + - name: Publish to GitHub Packages + run: mvn -B deploy + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} +``` +{% endraw %} + +Dieser Workflow ruft die Aktion `setup-java` zweimal auf. Jedes Mal, wenn die Aktion `setup-java` ausgeführt wird, überschriebt sie die Maven-Datei _settings.xml_ zum Publizieren von Paketen. Für die Authentifizierung im Repository verweist die Datei _settings.xml_ auf die `id` des Distributionsverwaltungs-Repositorys sowie den Benutzernamen und das Kennwort. + +Dieser Workflow führt die folgenden Schritte aus: + +1. Checkt eine Kopie des Projekt-Repositorys aus. +1. Ruft `setup-java` zum ersten Mal auf. Dies konfiguriert die Maven-Datei _settings.xml_ für das Repository `ossrh` und setzt die Authentifizierungsoptionen auf Umgebungsvariablen, die im nächsten Schritt definiert werden. +1. {% data reusables.github-actions.publish-to-maven-workflow-step %} +1. Ruft `setup-java` zum zweiten Mal auf. Dies konfiguriert automatisch die Maven-Datei _settings.xml_ für {% data variables.product.prodname_registry %}. +1. {% data reusables.github-actions.publish-to-packages-workflow-step %} + + Weitere Informationen zur Verwendung von Geheimnissen in Deinem Workflow findest Du unter „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“. diff --git a/translations/de-DE/content/actions/guides/publishing-nodejs-packages.md b/translations/de-DE/content/actions/guides/publishing-nodejs-packages.md new file mode 100644 index 000000000000..944534e21d85 --- /dev/null +++ b/translations/de-DE/content/actions/guides/publishing-nodejs-packages.md @@ -0,0 +1,210 @@ +--- +title: Node.js-Pakete veröffentlichen +intro: Du kannst Node.js-Pakete als Teil Deines Workflows zur kontinuierlichen Integrations (CI) in einer Registry veröffentlichen. +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages + - /actions/language-and-framework-guides/publishing-nodejs-packages +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Einführung + +Dieser Leitfaden zeigt Dir, wie Du einen Workflow erstellen kannst, der Node.js Pakete nach den Tests der fortlaufenden Integration (CI) in die {% data variables.product.prodname_registry %} und npm Registrierungen veröffentlicht. Mit einem einzigen Workflow kannst Du Pakete in einer einzigen Registry oder in mehreren Registries veröffentlichen. + +### Vorrausetzungen + +Wir empfehlen, dass Du ein grundlegendes Verständnis von Workflowkonfigurations-Optionen hast und darüber, wie Du eine Workflow-Datei erstellst. For more information, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." + +Weitere Informationen zum Erstellen eines CI-Workflows für Dein Node.js-Projekt findest Du unter „[Node.js mit {% data variables.product.prodname_actions %} verwenden](/actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions)“. + +Vielleicht findest Du es auch hilfreich, ein grundlegendes Verständnis von Folgendem zu haben: + +- „[Konfiguration von npm für die Verwendung mit {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)“ +- "[Environment variables](/actions/reference/environment-variables)" +- "[Encrypted secrets](/actions/reference/encrypted-secrets)" +- "[Authentication in a workflow](/actions/reference/authentication-in-a-workflow)" + +### Informationen zur Paketkonfiguration + + Die Felder `name` und `version` in der Datei *package.json* bilden eine eindeutige Kennung. Registries verwenden diese Kennung, um Dein Paket mit einer Registry zu verknüpfen. Du kannst eine Zusammenfassung für die Paketlisten-Seite hinzufügen, indem Du in die Datei *package.json* ein Feld `description` einfügst. Weitere Informationen findest Du unter „[Eine Datei package.json erstellen](https://docs.npmjs.com/creating-a-package-json-file)“ und „[Node.js-Module erstellen](https://docs.npmjs.com/creating-node-js-modules)“ in der npm-Dokumentation. + +Wenn eine lokale Datei *.npmrc* existiert, in der ein Wert `registry` angegeben ist, dann verwendet der Befehl `npm publish` die in der Datei *.npmrc* konfigurierte Registry. {% data reusables.github-actions.setup-node-intro %} + +Du kannst die auf dem Runner installierte Node.js-Version mit der Aktion `setup-node` angeben. + +Wenn Du Schritte in Deinen Workflow einfügst, um die `publishConfig`-Felder in Deiner *package.json*-Datei zu konfigurieren, brauchst Du die Registry-URL nicht mittels der Aktion `setup-node` anzugeben, aber Du kannst das Paket in nur einer einzigen Registry veröffentlichen. Weitere Informationen finden Sie unter „[publishConfig](https://docs.npmjs.com/files/package.json#publishconfig)“ in der NPM-Dokumentation. + +### Pakete in der npm-Registry veröffentlichen + +Jedes Mal, wenn Du ein neues Release erstellst, kannst Du einen Workflow anstoßen, um Dein Paket zu veröffentlichen. Der Workflow im folgenden Beispiel wird von dem Ereignis `release` vom Typ `created` angestoßen. Der Workflow veröffentlicht das Paket im npm-Registry sofern es die CI-Tests besteht. + +Um in Deinem Workflow authentifizierte Operationen gegenüber der npm-Registry durchzuführen, musst Du Dein npm-Authentifizierungstoken als Geheimnis in Deinen Repository-Einstellungen ablegen. Erstelle z.B. ein Geheimnis namens `NPM_TOKEN`. Weitere Informationen findest Du unter „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“. + +Standardmäßig verwendet npm das Feld `name` der Datei *package.json*, um die npm-Registry zu ermitteln. Wenn Du in einem globalen Namespace veröffentlichst, brauchst Du nur den Paketnamen anzugeben. Zum Beispiel würdest Du ein Paket namens `npm-hello-world-test` auf `https://www.npmjs.com/package/npm-hello-world-test` veröffentlichen. + +Wenn Du ein Paket veröffentlichst, das einen Präfix für den „scope“ (Geltungsbereich) enthält, dann füge den Geltungsbereich als `name` in Deine Datei *package.json* ein. Wenn beispielsweise Dein Präfix für den npm-scope „octocat“ und der Paketname „hello-world“ ist, dann sollte der `name` in Deiner Datei *package.json* auf `@octocat/hallo-world` gesetzt sein. Wenn Dein npm-Paket einen Scope-Präfix verwendet und das Paket öffentlich ist, musst Du die Option `npm publish --access public` verwenden. Dies ist eine Option, die npm verlangt, um zu verhindern, dass jemand versehentlich ein privates Paket veröffentlicht. + +Dieses Beispiel speichert das Geheimnis `NPM_TOKEN` in der Umgebungsvariablen `NODE_AUTH_TOKEN`. Wenn die Aktion `setup-node` eine Datei *.npmrc* erzeugt, referenziert sie das Token aus der Umgebungsvariable `NODE_AUTH_TOKEN`. + +{% raw %} +```yaml +name: Node.js Package +on: + release: + types: [created] +jobs: + build: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + # Datei .npmrc zur Veroeffentlichung auf npm einrichten + - uses: actions/setup-node@v1 + with: + node-version: '12.x' + registry-url: 'https://registry.npmjs.org' + - run: npm install + - run: npm publish + env: + NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} +``` +{% endraw %} + +Im obigen Beispiel erzeugt die Aktion `setup-node` auf dem Runner eine Datei *.npmrc* mit folgendem Inhalt: + +``` +//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN} +registry=https://registry.npmjs.org/ +always-auth=true +``` + +### Pakete in der {% data variables.product.prodname_registry %} veröffentlichen + +Jedes Mal, wenn Du ein neues Release erstellst, kannst Du einen Workflow anstoßen, um Dein Paket zu veröffentlichen. Der Workflow im folgenden Beispiel läuft jedes Mal, wenn das Ereignis `release` vom Typ `created` auftritt. Der Workflow veröffentlicht das Paket in {% data variables.product.prodname_registry %} , wenn die CI-Tests bestanden wurden. + +Standardmäßig veröffentlicht die {% data variables.product.prodname_registry %} ein Paket in dem Repository auf {% data variables.product.prodname_dotcom %}, das Du im Feld `name` der Datei *package.json* angibst. Ein Paket namens `@my-org/test` würde beispielsweise im Repository `my-org/test` auf {% data variables.product.prodname_dotcom %} veröffentlicht. Weitere Informationen finden Sie unter [„`npm-scope`“ (npm-Gültigkeitsbereich)](https://docs.npmjs.com/misc/scope) in der npm-Dokumentation. + +Um authentifizierte Vorgänge für die Registry {% data variables.product.prodname_registry %} in Deinem Workflow kannst Du den `GITHUB_TOKEN` verwenden. Der `GITHUB_TOKEN` existiert standardmäßig in Deinem Repository und hat Lese- und Schreibrechte für Pakete in dem Repository, in dem der Workflow läuft. Weitere Informationen findest Du unter „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“. + +Dieses Beispiel speichert das Geheimnis `GITHUB_TOKEN` in der Umgebungsvariablen `NODE_AUTH_TOKEN`. Wenn die Aktion `setup-node` eine Datei *.npmrc* erzeugt, referenziert sie das Token aus der Umgebungsvariable `NODE_AUTH_TOKEN`. + +{% raw %} +```yaml +name: Node.js Package +on: + release: + types: [created] +jobs: + build: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + # Setup .npmrc file to publish to GitHub Packages + - uses: actions/setup-node@v1 + with: + node-version: '12.x' + registry-url: 'https://npm.pkg.github.com' + # Defaults to the user or organization that owns the workflow file + scope: '@octocat' + - run: npm install + - run: npm publish + env: + NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }} +``` +{% endraw %} + +Die Aktion `setup-node` erzeugt eine Datei *.npmrc* auf dem Runner. Wenn Du für die Aktion `setup-node` die Eingabe `scope` verwendest, enthält die Datei *.npmrc* das Präfix „scope“. Standardmäßig legt die Aktion `setup-node` den „Scope“ (Geltungsbereich) in der Datei *.npmrc* auf das Konto fest, das diese Workflow-Datei enthält. + +``` +//npm.pkg.github.com/:_authToken=${NODE_AUTH_TOKEN} +@octocat:registry=https://npm.pkg.github.com +always-auth=true +``` + +### Pakete mittels „Yarn“ veröffentlichen + +Wenn Du den Paketmanager „Yarn“ verwendest, kannst Du mit Yarn Pakete installieren und veröffentlichen. + +{% raw %} +```yaml +name: Node.js Package +on: + release: + types: [created] +jobs: + build: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + # Setup .npmrc file to publish to npm + - uses: actions/setup-node@v1 + with: + node-version: '12.x' + registry-url: 'https://registry.npmjs.org' + # Defaults to the user or organization that owns the workflow file + scope: '@octocat' + - run: yarn + - run: yarn publish + env: + NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} +``` +{% endraw %} + +### Pakete auf npm und in der {% data variables.product.prodname_registry %} veröffentlichen + +{% note %} + +**Hinweis:** Wenn Du in Registries mit unterschiedlichen „Scope“-Präfixen publizieren musst, dann musst Du die Datei *package.json* auf dem Runner anpassen, um das „Scope“-Präfix zu ändern. Wenn Du beispielsweise ein Paket im Geltungsbereich `@mona` für npm und `@octocat` für {% data variables.product.prodname_registry %}veröffentlichst, kannst Du nach der Veröffentlichung auf npm und vor der Veröffentlichung in der {% data variables.product.prodname_registry %} auf dem Runner in der Datei *package.json* den Geltungsbereich `@mona` durch `@octocat` ersetzen. + +{% endnote %} + +Du kannst Deine Pakete sowohl in der npm-Registry als auch in {% data variables.product.prodname_registry %} veröffentlichen, indem Du die Aktion `setup-node` für jede Registry verwendest. + +Wenn Du ein Paket in beiden Registries veröffentlichst, musst Du sicherstellen, dass Dein „Scope“-Präfix auf npm mit Deinem Benutzer- oder Organisationsnamen in {% data variables.product.prodname_dotcom %} übereinstimmt. Um Pakete in einer öffentlichen Registry mit einem „Scope“-Präfix zu veröffentlichen, kannst Du den Befehl `npm publish --access public` verwenden. Weitere Informationen findest Du unter [`npm-scope`](https://docs.npmjs.com/misc/scope) und „[Öffentliche Pakete mit „Scope“ (Geltungsbereich) anlegen und veröffentlichen](https://docs.npmjs.com/creating-and-publishing-scoped-public-packages)“ in der npm-Dokumentation. + +Stelle sicher, dass in Deiner Datei *package.json* den Geltungsbereich Deines {% data variables.product.prodname_dotcom %}-Repositorys und der npm-Registry angegeben ist. Wenn Du beispielsweise ein Paket im Repository `octocat/npm-hello-world-test` auf {% data variables.product.prodname_dotcom %} und https://www.npmjs.com/package/@octocat/npm-hello-world-test veröffentlichen willst, dann sollte in Deiner Datei *package.json* der Name `"name": "@octocat/npm-hello-world-test"` stehen. + +Um authentifizierte Vorgänge für die Registry {% data variables.product.prodname_registry %} in Deinem Workflow kannst Du den `GITHUB_TOKEN` verwenden. Der `GITHUB_TOKEN` existiert standardmäßig in Deinem Repository und hat Lese- und Schreibrechte für Pakete in dem Repository, in dem der Workflow läuft. Weitere Informationen findest Du unter „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“. + +Wenn Du für die Aktion `setup-node` die Eingabe `scope` verwendest, erstellt die Aktion eine Datei *.npmrc* mit dem Präfix „scope“. Standardmäßig legt die Aktion `setup-node` den Geltungsbereich in der Datei *.npmrc* auf den Benutzer oder die Organisation fest, der die Workflow-Datei gehört. + +Dieser Workflow ruft die Aktion `setup-node` zweimal auf. Jedes Mal, wenn die Aktion `setup-node` ausgeführt wird, überschreibt sie die Datei *.npmrc*. Die Datei *.npmrc* referenziert den Token, mit dem Du authentifizierte Operationen in der Paket-Registry durchführen kannst, durch die Umgebungsvariable `NODE_AUTH_TOKEN`. Der Workflow setzt die Umgebungsvariable `NODE_AUTH_TOKEN` jedes Mal, wenn der Befehl `npm publish` ausgeführt wird; zuerst mit einem Token zum Veröffentlichen auf npm (`NPM_TOKEN`) und dann mit einem Token zum Veröffentlichen in der {% data variables.product.prodname_registry %} (`GITHUB_TOKEN`). + +{% raw %} +```yaml +name: Node.js Package +on: + release: + types: [created] +jobs: + build: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + # Setup .npmrc file to publish to npm + - uses: actions/setup-node@v1 + with: + node-version: '10.x' + registry-url: 'https://registry.npmjs.org' + - run: npm install + # Publish to npm + - run: npm publish --access public + env: + NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} + # Setup .npmrc file to publish to GitHub Packages + - uses: actions/setup-node@v1 + with: + registry-url: 'https://npm.pkg.github.com' + # Defaults to the user or organization that owns the workflow file + scope: '@octocat' + # Publish to GitHub Packages + - run: npm publish + env: + NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }} +``` +{% endraw %} diff --git a/translations/de-DE/content/actions/guides/setting-up-continuous-integration-using-workflow-templates.md b/translations/de-DE/content/actions/guides/setting-up-continuous-integration-using-workflow-templates.md new file mode 100644 index 000000000000..3e47530f79a9 --- /dev/null +++ b/translations/de-DE/content/actions/guides/setting-up-continuous-integration-using-workflow-templates.md @@ -0,0 +1,43 @@ +--- +title: Setting up continuous integration using workflow templates +shortTitle: Setting up CI using templates +intro: Du kannst die fortlaufende Integration für Dein Projekt mithilfe einer Workflow-Vorlage einrichten, die der Sprache und den Tools entspricht, die Du verwenden möchtest. +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /articles/setting-up-continuous-integration-using-github-actions + - /github/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions + - /actions/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions + - /actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +Jeder Benutzer mit Schreibberechtigung für ein Repository kann mit {% data variables.product.prodname_actions %} eine fortlaufende Integration (CI) einrichten. + +Nach der Einrichtung der CI können Sie den Workflow an Ihre Bedürfnisse anpassen. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. Wähle die Vorlage aus, die der Sprache und den Tools entspricht, die Du verwenden möchtest, und klicke dann auf **Set up this workflow** (Diesen Workflow einrichten). ![Schaltfläche „Setup workflow“ (Workflow einrichten)](/assets/images/help/repository/setup-workflow-button.png) +5. Klicke auf **Start commit** (Commit starten). ![Schaltfläche „Start commit“ (Commit starten)](/assets/images/help/repository/start-commit.png) +{% data reusables.files.write_commit_message %} +{% data reusables.files.choose_commit_branch %} +{% data reusables.files.propose_new_file %} + +Sobald ein Push an Ihr Repository erfolgt ist, können Sie den Status und die detaillierten Protokolle Ihres fortlaufenden Integrationsworkflows verfolgen, der auf {% data variables.product.prodname_dotcom %} ausgeführt wird, und angepasste Benachrichtigungen erhalten. Weitere Informationen findest Du unter „[Benachrichtigungen konfigurieren](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)“ und „[Workflowausführung verwalten](/articles/managing-a-workflow-run)“. + +{% data reusables.repositories.actions-workflow-status-badge-into %} + +For more information, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." + +### Weiterführende Informationen + +- „[Informationen zur kontinuierlichen Integration](/articles/about-continuous-integration)“ +- „[Einen Workflow-Lauf verwalten](/articles/managing-a-workflow-run)“ +{% if currentVersion == "free-pro-team@latest" %} +- „[Abrechnung für {{ site.data.variables.product.prodname_actions }} verwalten](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)“ +{% endif %} diff --git a/translations/de-DE/content/actions/guides/storing-workflow-data-as-artifacts.md b/translations/de-DE/content/actions/guides/storing-workflow-data-as-artifacts.md new file mode 100644 index 000000000000..de50a668f6d4 --- /dev/null +++ b/translations/de-DE/content/actions/guides/storing-workflow-data-as-artifacts.md @@ -0,0 +1,249 @@ +--- +title: Storing workflow data as artifacts +shortTitle: Storing workflow artifacts +intro: Mit Artefakten kannst Du Daten zwischen Aufträgen in einem Workflow freigeben und Daten nach Abschluss des Workflows speichern. +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /articles/persisting-workflow-data-using-artifacts + - /github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts + - /actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts + - /actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Informationen zu Workflow-Artefakten + +Artefakte erlauben es dir, Daten nach dem Job-Abschluss abzuspeichern und diese Daten an einen anderen Job im selben Workflow weiterzugeben. Ein Artefakt ist eine Datei oder eine Dateisammlung, die während einer Workflow-Ausführung erstellt wird. Zum Beispiel kannst Du Artefakte verwenden, um Deine Build- und Testausgabe zu speichern, nachdem ein Workflow-Lauf beendet ist. + +{% data reusables.github-actions.artifact-log-retention-statement %} The retention period for a pull request restarts each time someone pushes a new commit to the pull request. + +Dies sind einige der gängigen Artefakte, die du hochladen kannst: + +- Protokolldateien und Coredumps +- Testergebnisse, Fehler und Screenshots +- Binäre oder komprimierte Dateien +- Ergebnisse zur Stresstest-Leistungsausgabe und Codeabdeckung + +{% if currentVersion == "free-pro-team@latest" %} + +Das Speichern von Artefakten verwendet Speicherplatz auf {% data variables.product.product_name %}. {% data reusables.github-actions.actions-billing %} Weitere Informationen findest Du unter „[Abrechnung für {% data variables.product.prodname_actions %} verwalten](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)“. + +{% else %} + +Artefakte verfallen automatisch nach 90 Tagen, aber du kannst jederzeit den verwendeten Speicher auf {% data variables.product.prodname_actions %} wieder verfügbar machen, indem du Artefakte löschst, bevor sie auf {% data variables.product.product_name %} ablaufen. + +{% endif %} + +Artefakte werden während eines Workflow-Laufs hochgeladen und Du kannst den Namen und die Größe eines Artefakts in der Benutzeroberfläche anzeigen. Wenn ein Artefakt mit der {% data variables.product.product_name %}-Oberfläche heruntergeladen wird, werden alle Dateien, die als Teil des Artefakts einzeln hochgeladen wurden, zusammen in eine einzige Datei gezippt. Die Abrechnung erfolgt anhand der Größe des hochgeladenen Artefakts und nicht der Größe der Zip-Datei erfolgt. + +{% data variables.product.product_name %} bietet zwei Aktionen, über die Sie Build-Artefakte hoch- und herunterladen können. For more information, see the {% if currentVersion == "free-pro-team@latest" %}[actions/upload-artifact](https://github.com/actions/upload-artifact) and [download-artifact](https://github.com/actions/download-artifact) actions{% else %} `actions/upload-artifact` and `download-artifact` actions on {% data variables.product.product_location %}{% endif %}. + +Daten zwischen Aufträgen freigeben: + +* **Dateien hochladen**: Gib der hochgeladenen Datei einen Namen und lade die Daten hoch, bevor der Job endet. +* **Dateien herunterladen**: Du kannst nur Artefakte herunterladen, die während des gleichen Workflow-Laufs hochgeladen wurden. Wenn Du eine Datei herunterlädst, kannst Du sie mit Namen referenzieren. + +Die Steps („Schritte“) eines Jobs teilen sich die selbe Umgebung auf der Runner-Maschine, laufen aber in ihren eigenen individuellen Prozessen. Mithilfe von Ein- und Ausgaben können Sie Daten zwischen den Schritten in einem Auftrag weitergeben. Weitere Informationen zu Ein- und Ausgaben finden Sie unter „[Metadatensyntax für {% data variables.product.prodname_actions %}](/articles/metadata-syntax-for-github-actions)“. + +### Build- und Testartefakte hochladen + +Du kannst einen Workflow für kontinuierliche Integration (CI) erstellen, um Deinen Code zu bauen und zu testen. For more information about using {% data variables.product.prodname_actions %} to perform CI, see "[About continuous integration](/articles/about-continuous-integration)." + +Durch die Ergebnisse der Erstellung und des Tests Deines Codes werden oft zum Debuggen von Testfehlern einsetzbare Dateien und bereitstellbarer Produktionscode erstellt. Du kannst einen Workflow konfigurieren, um den per Push-Vorgang an Dein Repository übertragenen Code zu erstellen und zu testen und um einen erfolgreichen oder fehlerhaften Status zu melden. Du kannst die Build- und Testausgabe hochladen, um sie für Bereitstellungen, zum Debuggen fehlerhafter Tests oder von Abstürzen und zum Anzeigen der Testsuite-Abdeckung zu verwenden. + +Du kannst die Aktion `upload-artifact` verwenden um Artefakte hochzuladen. Beim Hochladen eines Artefakts können Sie eine einzelne Datei oder ein Verzeichnis oder mehrere Dateien oder Verzeichnisse angeben. Sie können auch bestimmte Dateien oder Verzeichnisse ausschließen und Platzhaltermuster verwenden. Es wird empfohlen, einen Namen für ein Artefakt bereitzustellen, aber wenn kein Name angegeben wird, wird `Artefakt` als Standardname verwendet. For more information on syntax, see the {% if currentVersion == "free-pro-team@latest" %}[actions/upload-artifact](https://github.com/actions/upload-artifact) action{% else %} `actions/upload-artifact` action on {% data variables.product.product_location %}{% endif %}. + +#### Beispiel + +Zum Beispiel kann Dein Projektarchiv oder eine Webanwendung SASS- und TypeScript-Dateien enthalten, die Du in CSS und JavaScript konvertieren musst. Falls Dein Build-Konfiguration die kompilierten Dateien im Verzeichnis `dist` ausgibt, würdest Du die im Verzeichnis `dist` enthaltenen Dateien auf Deinem Webanwendungsserver bereitstellen, sofern alle Tests erfolgreich abgeschlossen werden. + +``` +|-- hello-world (repository) +| └── dist +| └── tests +| └── src +| └── sass/app.scss +| └── app.ts +| └── output +| └── test +| +``` + +In diesem Beispiel wird gezeigt, wie Du einen Workflow für ein Node.js-Projekt erstellst, das den Code im `src`-Verzeichnis `erstellt` und die Tests im `tests`-Verzeichnis ausführt. Wenn `npm test` ausgeführt wird, wird im Verzeichnis `output/test/` ein Bericht zur Codeabdeckung mit dem Namen `code-coverage.html` erstellt und gespeichert. + +Der Workflow lädt die Produktionsartefakte in das `dist` Verzeichnis, schließt jedoch alle Markdowndateien aus. Es lädt auch die `code-coverage.html` Bericht als ein weiteres Artefakt. + +```yaml +Name: Node CI + +on: [push] + +jobs: + build_and_test: + läuft auf: ubuntu-latest + schritte: + - name: Checkout repository + verwendet: actions/checkout@v2 + - name: npm install, build, and test + run: | + npm installieren sie + npm run build --if-present + npm test + - name: Archiv production artifacts + uses: actions/upload-artifact@v2 + with: + name: dist-without-markdown + path: | + dist + !dist/**/*md + - Name: Archivcodeabdeckungsergebnisse + verwendet: Aktionen/Upload-artifact@v2 + mit: + Name: code-coverage-report + pfad: output/test/code-coverage.html +``` + +![Bild mit Workflow-Ausführung des Workflow-Upload-Artefakts](/assets/images/help/repository/upload-build-test-artifact.png) + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +### Configuring a custom artifact retention period + +You can define a custom retention period for individual artifacts created by a workflow. When using a workflow to create a new artifact, you can use `retention-days` with the `upload-artifact` action. This example demonstrates how to set a custom retention period of 5 days for the artifact named `my-artifact`: + +``` + - name: 'Upload Artifact' + uses: actions/upload-artifact@v2 + with: + name: my-artifact + path: my_file.txt + retention-days: 5 +``` + +The `retention-days` value cannot exceed the retention limit set by the repository, organization, or enterprise. +{% endif %} + +### Artefakte herunterladen oder löschen + +During a workflow run, you can use the [`download-artifact`](https://github.com/actions/download-artifact)action to download artifacts that were previously uploaded in the same workflow run. + +After a workflow run has been completed, you can download or delete artifacts on {% data variables.product.prodname_dotcom %} or using the REST API. For more information, see "[Downloading workflow artifacts](/actions/managing-workflow-runs/downloading-workflow-artifacts)," "[Removing workflow artifacts](/actions/managing-workflow-runs/removing-workflow-artifacts)," and the "[Artifacts REST API](/v3/actions/artifacts/)." + +#### Herunterladen von Artefakten während einer Workflowausführung + +The [`actions/download-artifact`](https://github.com/actions/download-artifact) action can be used to download previously uploaded artifacts during a workflow run. + +{% note %} + +**Hinweis:** Sie können nur Artefakte in einem Workflow herunterladen, die während desselben Workflowlaufs hochgeladen wurden. + +{% endnote %} + +Geben Sie den Namen eines Artefakts an, um ein einzelnes Artefakt herunterzuladen. Wenn Sie ein Artefakt hochgeladen haben, ohne einen Namen anzugeben, lautet der Standardname `Artefakt`. + +```yaml +- Name: Laden Sie ein einzelnes Artefakt + verwendet: Aktionen/Download-artifact@v2 + mit: + Name: my-artifact +``` + +Sie können auch alle Artefakte in einem Workflow herunterladen, der ausgeführt wird, indem Sie keinen Namen angeben. Dies kann nützlich sein, wenn Sie mit vielen Artefakten arbeiten. + +```yaml +- Name: Laden Sie alle Workflow-Ausführungsartefakte + verwendet: Aktionen/Download-artifact@v2 +``` + +Wenn Sie alle Artefakte einer Workflowausführung herunterladen, wird ein Verzeichnis für jedes Artefakt mit seinem Namen erstellt. + +For more information on syntax, see the {% if currentVersion == "free-pro-team@latest" %}[actions/download-artifact](https://github.com/actions/download-artifact) action{% else %} `actions/download-artifact` action on {% data variables.product.product_location %}{% endif %}. + +### Daten zwischen Aufträgen in einem Workflow weitergeben + +Du kannst die Aktionen `upload-artifact` und `download-artifact` verwenden, um innerhalb eines Workflows Daten zwischen Jobs auszutauschen. In diesem Beispiel-Workflow wird veranschaulicht, wie Daten zwischen Aufträgen im selben Workflow weitergegeben werden. For more information, see the {% if currentVersion == "free-pro-team@latest" %}[actions/upload-artifact](https://github.com/actions/upload-artifact) and [download-artifact](https://github.com/actions/download-artifact) actions{% else %} `actions/upload-artifact` and `download-artifact` actions on {% data variables.product.product_location %}{% endif %}. + +Von den Artefakten eines vorherigen Auftrags abhängige Aufträge müssen auf den erfolgreichen Abschluss des abhängigen Auftrags warten. Bei diesem Workflow kommt das Stichwort `needs` zum Einsatz, um sicherzustellen, dass `job_1`, `job_2` und `job_3` sequenziell ausgeführt werden. Beispielsweise schreibt `job_2` vor, dass `job_1` die Syntax `needs: job_1` verwendet. + +Auftrag 1 führt die folgenden Schritte durch: +- Führt eine mathematische Berechnung aus und speichert das Ergebnis in einer Textdatei namens `math-homework.txt`. +- Verwendet die Aktion `upload-artifact`, um die Datei `math-homework.txt` mit dem Namen `homework` hochzuladen. Die Aktion platziert die Datei in einem Verzeichnis mit dem Namen `homework`. + +Auftrag 2 verwendet das Ergebnis des vorherigen Auftrags: +- Lädt das im vorherigen Auftrag hochgeladene `homework`-Artefakt herunter. Die Aktion `download-artifact` lädt die Artefakte standardmäßig in das Verzeichnis der Arbeitsoberfläche, in dem der Schritt ausgeführt wird. Du kannst den Eingabeparameter `path` verwenden, um ein anderes Download-Verzeichnis anzugeben. +- Liest den Wert in der Datei `homework/math-homework.txt`, führt eine mathematische Berechnung durch und speichert das Ergebnis in `math-homework.txt`. +- Lädt die Datei `math-homework.txt` hoch. Dieser Upload überschreibt den vorherigen Upload, da beide Uploads den gleichen Namen haben. + +Auftrag 3 zeigt das im vorherigen Auftrag hochgeladene Ergebnis an: +- Lädt das `homework`-Artefakt herunter. +- Gibt das Ergebnis der mathematischen Gleichung im Protokoll aus. + +Die vollständige, in diesem Workflow-Beispiel durchgeführte mathematische Operation lautet `(3 + 7) x 9 = 90`. + +```yaml +name: Daten zwischen Jobs + +teilen: [push] + +Jobs: + job_1: + Name: Hinzufügen von 3 und 7 + -Runs-on: ubuntu-latest + Schritte: + - shell: bash + run: | + expr 3 + 7 > math-homework.txt + - Name: Math-Ergebnis für Job 1 + verwendet: Aktionen/Upload-artifact@v2 + mit: + Name: Hausaufgaben + Pfad: math-homework.txt + + job_2: + Name: Multiplizieren mit 9 + benötigt: job_1 + -Run-on: Windows-neueste + Schritte: + - Name: Download Mathe-Ergebnis für Job 1 + verwendet: Aktionen + + + artifact@v2 + / + value='cat math-homework.txt' + expr $value '* 9 > math-homework.txt + - Name: Math-Ergebnis für Job 2 + verwendet: aktionen/upload-artifact@v2 + mit: + Name: Hausaufgaben + Pfad: math-homework.txt + + job_3: + Name: Anzeigeergebnisse + Bedürfnisse: job_2 + -Auslauf: macOS-neueste + Schritte: + - Name: Mathematisches Ergebnis für Job 2 + verwendet: Aktionen/Download-artifact@v2 + mit: + Name: Hausaufgaben + - Name: Drucken sie das Endergebnis + Shell: bash + run: | + value='cat math-homework.txt' + echo Das Ergebnis ist $value +``` + +![Workflow, der zum Durchführen mathematischer Operationen Daten zwischen Aufträgen weitergibt](/assets/images/help/repository/passing-data-between-jobs-in-a-workflow.png) + +{% if currentVersion == "free-pro-team@latest" %} + +### Weiterführende Informationen + +- "[ Abrechnung für {% data variables.product.prodname_actions %} verwalten](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)". + +{% endif %} diff --git a/translations/de-DE/content/actions/hosting-your-own-runners/about-self-hosted-runners.md b/translations/de-DE/content/actions/hosting-your-own-runners/about-self-hosted-runners.md index bfa2f84ca882..8b0d0b02399b 100644 --- a/translations/de-DE/content/actions/hosting-your-own-runners/about-self-hosted-runners.md +++ b/translations/de-DE/content/actions/hosting-your-own-runners/about-self-hosted-runners.md @@ -53,6 +53,15 @@ You can use any machine as a self-hosted runner as long at it meets these requir * Der Rechner verfügt über genügend Hardwareressourcen für den Typ der Workflows, den Du ausführen möchtest. Die Anwendung für selbst-gehostete Runner selbst erfordert nur minimale Ressourcen. * Wenn Du Workflows ausführen willst, die Docker-Container-Aktionen oder Service-Container verwenden, brauchst Du eine Linux-Maschine und Docker muss installiert sein. +### Nutzungseinschränkungen + +There are some limits on {% data variables.product.prodname_actions %} usage when using self-hosted runners. Die Einschränkungen können sich jederzeit ändern. + +{% data reusables.github-actions.usage-workflow-run-time %} +- **Job queue time** (Job-Warteschlangenzeit) - Jeder Auftrag für selbst-gehostete Läufer kann maximal 24 Stunden lang in die Warteschlange gestellt werden. Wenn ein selbst-gehosteter Läufer die Ausführung des Auftrags nicht innerhalb dieses Limits startet, wird der Auftrag beendet und kann nicht abgeschlossen werden. +{% data reusables.github-actions.usage-api-requests %} +- **Auftrags-Matrix** - {% data reusables.github-actions.usage-matrix-limits %} + ### Unterstützte Betriebssysteme für selbst-gehostete Runner The following operating systems are supported for the self-hosted runner application. diff --git a/translations/de-DE/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md b/translations/de-DE/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md index f405667f2a64..eb0edcf9d292 100644 --- a/translations/de-DE/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md +++ b/translations/de-DE/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md @@ -1,6 +1,6 @@ --- title: Selbst-gehostete Runner hinzufügen -intro: 'Du kannst einen selbst-gehosteten Runner zu {% data variables.product.prodname_actions %} hinzufügen.' +intro: 'Du kannst einen selbst-gehosteten Runner zu {{ site.data.variables.product.prodname_actions }} hinzufügen.' redirect_from: - /github/automating-your-workflow-with-github-actions/adding-self-hosted-runners - /actions/automating-your-workflow-with-github-actions/adding-self-hosted-runners @@ -51,7 +51,8 @@ You can add self-hosted runners to an enterprise, where they can be assigned to {% if currentVersion == "free-pro-team@latest" %} To add a self-hosted runner to an enterprise account, you must be an enterprise owner. {% else if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21"%} -To add a self-hosted runner at the enterprise level of {% data variables.product.product_location %}, you must be a site administrator. +To add a self-hosted runner at the enterprise level of +{% data variables.product.product_location %}, you must be a site administrator. {% endif %} {% if currentVersion == "free-pro-team@latest" %} diff --git a/translations/de-DE/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md b/translations/de-DE/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md index 9d8890d5d63f..145f8346ebc7 100644 --- a/translations/de-DE/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md +++ b/translations/de-DE/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md @@ -1,6 +1,6 @@ --- title: Die Anwendung für selbst-gehostete Runner als Dienst konfigurieren -intro: 'Du kannst die Anwendung für selbst-gehostete Runner als Dienst konfigurieren, um die Runner-Anwendung automatisch zu starten, wenn der Rechner hochfährt.' +intro: Du kannst die Anwendung für selbst-gehostete Runner als Dienst konfigurieren, um die Runner-Anwendung automatisch zu starten, wenn der Rechner hochfährt. redirect_from: - /actions/automating-your-workflow-with-github-actions/configuring-the-self-hosted-runner-application-as-a-service versions: diff --git a/translations/de-DE/content/actions/hosting-your-own-runners/index.md b/translations/de-DE/content/actions/hosting-your-own-runners/index.md index ccfcf1c4c6b0..2fff691548e4 100644 --- a/translations/de-DE/content/actions/hosting-your-own-runners/index.md +++ b/translations/de-DE/content/actions/hosting-your-own-runners/index.md @@ -1,6 +1,6 @@ --- title: Deinen eigenen Runner hosten -intro: 'Du kannst selbst-gehostete Runner erstellen, um Workflows in einer hochgradig anpassbaren Umgebung zu betreiben.' +intro: Du kannst selbst-gehostete Runner erstellen, um Workflows in einer hochgradig anpassbaren Umgebung zu betreiben. redirect_from: - /github/automating-your-workflow-with-github-actions/hosting-your-own-runners - /actions/automating-your-workflow-with-github-actions/hosting-your-own-runners diff --git a/translations/de-DE/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md b/translations/de-DE/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md index ca2b788daee6..8796228a26c7 100644 --- a/translations/de-DE/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md +++ b/translations/de-DE/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md @@ -1,6 +1,6 @@ --- title: Überwachung und Fehlerbehebung selbst-gehosteter Runner -intro: 'Du kannst Deine selbst gehosteten Runner überwachen, um ihre Aktivität zu sehen und gewöhnliche Probleme zu diagnostizieren.' +intro: Du kannst Deine selbst gehosteten Runner überwachen, um ihre Aktivität zu sehen und gewöhnliche Probleme zu diagnostizieren. redirect_from: - /actions/hosting-your-own-runners/checking-the-status-of-self-hosted-runners - /github/automating-your-workflow-with-github-actions/checking-the-status-of-self-hosted-runners @@ -13,7 +13,7 @@ versions: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -### Den Status eines selbst-gehosteten Runners mittels {% data variables.product.prodname_dotcom %} überprüfen +### Den Status eines selbst-gehosteten Runners mittels {{ site.data.variables.product.prodname_dotcom }} überprüfen {% data reusables.github-actions.self-hosted-runner-management-permissions-required %} diff --git a/translations/de-DE/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md b/translations/de-DE/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md index 9122615f4231..e2a86b7df42d 100644 --- a/translations/de-DE/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md +++ b/translations/de-DE/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md @@ -1,6 +1,6 @@ --- title: Selbst-gehostete Runner entfernen -intro: 'Du kannst einen selbst-gehosteten Runner dauerhaft von {% data variables.product.prodname_actions %} entfernen.' +intro: 'Du kannst einen selbst-gehosteten Runner dauerhaft von {{ site.data.variables.product.prodname_actions }} entfernen.' redirect_from: - /github/automating-your-workflow-with-github-actions/removing-self-hosted-runners - /actions/automating-your-workflow-with-github-actions/removing-self-hosted-runners @@ -63,7 +63,8 @@ Um einen selbst-gehosteten Runner aus einer Organisation zu entfernen, musst Du {% if currentVersion == "free-pro-team@latest" %} To remove a self-hosted runner from an enterprise account, you must be an enterprise owner. We recommend that you also have access to the self-hosted runner machine. {% else if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21"%} -Um einen selbst-gehosteten Runner aus einer Organisation zu entfernen, musst Du ein Organisationsinhaber sein. We recommend that you also have access to the self-hosted runner machine. +To remove a self-hosted runner at the enterprise level of +{% data variables.product.product_location %}, you must be a site administrator. We recommend that you also have access to the self-hosted runner machine. {% endif %} {% data reusables.github-actions.self-hosted-runner-reusing %} diff --git a/translations/de-DE/content/actions/index.md b/translations/de-DE/content/actions/index.md index 45d96c5f3ce2..7d6700497d35 100644 --- a/translations/de-DE/content/actions/index.md +++ b/translations/de-DE/content/actions/index.md @@ -33,8 +33,8 @@ versions: -
-
+
+

{% data ui.toc.getting_started %}

@@ -45,7 +45,7 @@ versions:
-
+

{% data ui.toc.popular_articles %}

@@ -56,7 +56,7 @@ versions:
-
+

Manage workflows

@@ -68,22 +68,28 @@ versions:
-
- -
{% octicon "bookmark" width="24" %}
-

Create actions

-

A complete guide to creating and sharing actions with the community.

- - -
{% octicon "rocket" width="24" %}
-

Starter workflows

-

A collection of workflow files to help you get started with GitHub Actions.

- - -
{% octicon "light-bulb" width="24" %}
-

GitHub Actions Marketplace

-

Explore community actions and supercharge your workflow.

- +
+
+ +
{% octicon "bookmark" width="24" %}
+

Create actions

+

A complete guide to creating and sharing actions with the community.

+ +
+
+ +
{% octicon "rocket" width="24" %}
+

Starter workflows

+

A collection of workflow files to help you get started with GitHub Actions.

+ +
+
+ +
{% octicon "light-bulb" width="24" %}
+

GitHub Actions Marketplace

+

Explore community actions and supercharge your workflow.

+ +
@@ -91,7 +97,7 @@ versions:

Leitfäden

-
+

Building and testing Node.js

@@ -107,7 +113,7 @@ versions:
-
+

Building and testing Python

@@ -123,7 +129,7 @@ versions:
-
+

Building and testing Java with Maven

@@ -139,7 +145,7 @@ versions:
-
+

Building and testing Java with Gradle

@@ -155,7 +161,7 @@ versions:
-
+

Building and testing Java with Ant

@@ -171,7 +177,7 @@ versions:
-
+

Publishing Node.js packages

diff --git a/translations/de-DE/content/actions/learn-github-actions/essential-features-of-github-actions.md b/translations/de-DE/content/actions/learn-github-actions/essential-features-of-github-actions.md new file mode 100644 index 000000000000..eaaa18463e91 --- /dev/null +++ b/translations/de-DE/content/actions/learn-github-actions/essential-features-of-github-actions.md @@ -0,0 +1,95 @@ +--- +title: Essential features of GitHub Actions +shortTitle: Essential features +intro: '{% data variables.product.prodname_actions %} are designed to help you build robust and dynamic automations. This guide will show you how to craft {% data variables.product.prodname_actions %} workflows that include environment variables, customized scripts, and more.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Übersicht + +{% data variables.product.prodname_actions %} allow you to customize your workflows to meet the unique needs of your application and team. In this guide, we'll discuss some of the essential customization techniques such as using variables, running scripts, and sharing data and artifacts between jobs. + +### Using variables in your workflows + +{% data variables.product.prodname_actions %} include default environment variables for each workflow run. If you need to use custom environment variables, you can set these in your YAML workflow file. This example demonstrates how to create custom variables named `POSTGRES_HOST` and `POSTGRES_PORT`. These variables are then available to the `node client.js` script. + +```yaml +jobs: + example-job: + steps: + - name: Connect to PostgreSQL + run: node client.js + env: + POSTGRES_HOST: postgres + POSTGRES_PORT: 5432 +``` + +Weitere Informationen findest Du unter „[Umgebungsvariablen verwenden](/actions/configuring-and-managing-workflows/using-environment-variables)“. + +### Adding scripts to your workflow + +You can use actions to run scripts and shell commands, which are then executed on the assigned runner. This example demonstrates how an action can use the `run` keyword to execute `npm install -g bats` on the runner. + +```yaml +jobs: + example-job: + steps: + - run: npm install -g bats +``` + +For example, to run a script as an action, you can store the script in your repository and supply the path and shell type. + +```yaml +jobs: + example-job: + steps: + - name: Run build script + run: ./.github/scripts/build.sh + shell: bash +``` + +Weitere Informationen findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)“. + +### Sharing data between jobs + +If your job generates files that you want to share with another job in the same workflow, or if you want to save the files for later reference, you can store them in {% data variables.product.prodname_dotcom %} as _artifacts_. Artefakte sind die Dateien, die erstellt werden, wenn Sie Ihren Code erstellen und testen. Artefakte können beispielsweise Binär- oder Paketdateien, Testergebnisse, Screenshots oder Protokolldateien sein. Artifacts are associated with the workflow run where they were created and can be used by another job. + +For example, you can create a file and then upload it as an artifact. + +```yaml +jobs: + example-job: + name: Save output + steps: + - shell: bash + run: | + expr 1 + 1 > output.log + - name: Upload output file + uses: actions/upload-artifact@v1 + with: + name: output-log-file + path: output.log +``` + +To download an artifact from a separate workflow run, you can use the `actions/download-artifact` action. For example, you can download the artifact named `output-log-file`. + +```yaml +jobs: + example-job: + steps: + - name: Download a single artifact + uses: actions/download-artifact@v2 + with: + name: output-log-file +``` + +For more information about artifacts, see "[Persisting workflow data using artifacts](/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts)." + +### Nächste Schritte: + +To continue learning about {% data variables.product.prodname_actions %}, see "[Managing complex workflows](/actions/learn-github-actions/managing-complex-workflows)." diff --git a/translations/de-DE/content/actions/learn-github-actions/finding-and-customizing-actions.md b/translations/de-DE/content/actions/learn-github-actions/finding-and-customizing-actions.md new file mode 100644 index 000000000000..6fe5b07a53eb --- /dev/null +++ b/translations/de-DE/content/actions/learn-github-actions/finding-and-customizing-actions.md @@ -0,0 +1,156 @@ +--- +title: Finding and customizing actions +shortTitle: Finding and customizing actions +intro: 'Actions are the building blocks that power your workflow. A workflow can contain actions created by the community, or you can create your own actions directly within your application''s repository. This guide will show you how to discover, use, and customize actions.' +redirect_from: + - /actions/automating-your-workflow-with-github-actions/using-github-marketplace-actions + - /actions/automating-your-workflow-with-github-actions/using-actions-from-github-marketplace-in-your-workflow + - /actions/getting-started-with-github-actions/using-actions-from-github-marketplace + - /actions/getting-started-with-github-actions/using-community-workflows-and-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Übersicht + +The actions you use in your workflow can be defined in: + +- Ein öffentliches Repository +- The same repository where your workflow file references the action +- Ein veröffentlichtes Docker-Containerimage auf Docker Hub + +{% data variables.product.prodname_marketplace %} ist eine zentrale Stelle, an der Du Aktionen findest, die von der {% data variables.product.prodname_dotcom %}-Community erstellt wurden. [{% data variables.product.prodname_marketplace %} page](https://github.com/marketplace/actions/) enables you to filter for actions by category. + +{% data reusables.actions.enterprise-marketplace-actions %} + +### Browsing Marketplace actions in the workflow editor + +Direkt im Workflow-Editor Deines Repositorys kannst Du Aktionen suchen und durchstöbern und auch suchen. In der Seitenleiste kannst Du nach einer bestimmten Aktion suchen, vorgestellte Aktionen anzeigen und vorgestellte Kategorien durchsuchen. Du kannst auch nach der Anzahl der Sterne schauen, die eine Aktion von der {% data variables.product.prodname_dotcom %}-Community erhalten hat. + +1. Navigiere in Deinem Repository zu der Workflow-Datei, die Du bearbeiten möchtest. +1. Um den Workflow-Editor zu öffnen, klickst Du in der oberen rechten Ecke der Dateiansicht auf {% octicon "pencil" aria-label="The edit icon" %}. ![Schaltfläche zum Editieren der Workflow-Datei](/assets/images/help/repository/actions-edit-workflow-file.png) +1. Rechts vom Editor befindet sich die Sidebar {% data variables.product.prodname_marketplace %} , um Aktionen zu durchsuchen. Actions with the {% octicon "verified" aria-label="The verified badge" %} badge indicate {% data variables.product.prodname_dotcom %} has verified the creator of the action as a partner organization. ![Seitenleiste für den Marktplatz-Workflow](/assets/images/help/repository/actions-marketplace-sidebar.png) + +### Adding an action to your workflow + +Die Listing-Seite einer Aktion enthält die Version der Aktion und die erforderliche Workflow-Syntax, um die Aktion zu benutzen. To keep your workflow stable even when updates are made to an action, you can reference the version of the action to use by specifying the Git or Docker tag number in your workflow file. + +1. Navigiere zu der Aktion, die Du in Deinem Workflow verwenden möchtest. +1. Klicke unter „Installation“ auf {% octicon "clippy" aria-label="The edit icon" %} , um die Workflow-Syntax zu kopieren. ![Aktionsliste anzeigen](/assets/images/help/repository/actions-sidebar-detailed-view.png) +1. Füge die Syntax als neuen Schritt in Deinen Workflow ein. Weitere Informationen findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idsteps)“. +1. If the action requires you to provide inputs, set them in your workflow. For information on inputs an action might require, see "[Using inputs and outputs with an action](/actions/learn-github-actions/finding-and-customizing-actions#using-inputs-and-outputs-with-an-action)." + +{% if currentVersion == "free-pro-team@latest" %} + +{% data reusables.dependabot.version-updates-for-actions %} + +{% endif %} + +### Using release management for your custom actions + +The creators of a community action have the option to use tags, branches, or SHA values to manage releases of the action. Similar to any dependency, you should indicate the version of the action you'd like to use based on your comfort with automatically accepting updates to the action. + +You will designate the version of the action in your workflow file. Check the action's documentation for information on their approach to release management, and to see which tag, branch, or SHA value to use. + +#### Using tags + +Tags are useful for letting you decide when to switch between major and minor versions, but these are more ephemeral and can be moved or deleted by the maintainer. This example demonstrates how to target an action that's been tagged as `v1.0.1`: + +```yaml +Schritte: + - verwendet: actions/javascript-action@v1.0.1 +``` + +#### Using SHAs + +If you need more reliable versioning, you should use the SHA value associated with the version of the action. SHAs are immutable and therefore more reliable than tags or branches. However this approach means you will not automatically receive updates for an action, including important bug fixes and security updates. This example targets an action's SHA: + +```yaml +Schritte: + - verwendet: actions/javascript-action@172239021f7ba04fe7327647b213799853a9eb89 +``` + +#### Using branches + +Referring to a specific branch means that the action will always use include the latest updates on the target branch, but can create problems if those updates include breaking changes. This example targets a branch named `@main`: + +```yaml +steps: + - uses: actions/javascript-action@main +``` + +For more information, see "[Using release management for actions](/actions/creating-actions/about-actions#using-release-management-for-actions)." + +### Using inputs and outputs with an action + +An action often accepts or requires inputs and generates outputs that you can use. For example, an action might require you to specify a path to a file, the name of a label, or other data it will uses as part of the action processing. + +To see the inputs and outputs of an action, check the `action.yml` or `action.yaml` in the root directory of the repository. + +In this example `action.yml`, the `inputs` keyword defines a required input called `file-path`, and includes a default value that will be used if none is specified. The `outputs` keyword defines an output called `results-file`, which tells you where to locate the results. + +```yaml +name: 'Example' +description: 'Receives file and generates output' +inputs: + file-path: # id of input + description: "Path to test script" + required: true + default: 'test-file.js' +outputs: + results-file: # id of output + description: "Path to results file" +``` + +### Verweisen auf eine Aktion im selben Repository, in dem eine Workflowdatei die Aktion verwendet + +Wenn eine Aktion im selben Repository definiert ist, in dem Ihre Workflowdatei die Aktion verwendet, können Sie auf die Aktion mit der`{owner}/{repo}-{ref}` oder `./path/to/dir-` Syntax in ihrer Workflowdatei verweisen. + +Beispiel-Repository-Dateistruktur: + +``` +|-- hello-world (Repository) +| |__ .github +| Workflows +| My-First-Workflow.yml +| • Maßnahmen +| |__ hello-world-action +| • action.yml +``` + +Beispiel-Workflowdatei: + +```yaml +jobs: + build: + läuft auf: ubuntu-latest + Schritte: + - Dieser Schritt checkt eine Kopie Ihres Repositorys aus. + - verwendet: actions/checkout@v2 + - Dieser Schritt verweist auf das Verzeichnis, das die Aktion enthält. + - verwendet: ./.github/actions/hello-world-action +``` + +The `action.yml` file is used to provide metadata for the action. Learn about the content of this file in "[Metadata syntax for GitHub Actions](/actions/creating-actions/metadata-syntax-for-github-actions)" + +### Verweisen auf einen Container auf Docker Hub + +Wenn eine Aktion in einem veröffentlichten Docker-Containerimage auf Docker Hub definiert ist, müssen Sie auf die Aktion mit der `docker://{image}:{tag}` Syntax in Ihrer Workflowdatei verweisen. Zum Schutz Ihres Codes und Ihrer Daten wird dringend empfohlen, die Integrität des Docker-Containerimages von Docker Hub zu überprüfen, bevor Sie es in Ihrem Workflow verwenden. + +```yaml +jobs: + my_first_job: + Schritte: + - Name: Mein erster Schritt + verwendet: docker://alpine:3.8 +``` + +Einige Beispiele für Docker-Aktionen findest Du im [Docker-image.yml-Workflow](https://github.com/actions/starter-workflows/blob/main/ci/docker-image.yml) oder unter „[Eine Docker-Container-Aktion erstellen](/articles/creating-a-docker-container-action)“. + +### Nächste Schritte: + +To continue learning about {% data variables.product.prodname_actions %}, see "[Essential features of {% data variables.product.prodname_actions %}](/actions/learn-github-actions/essential-features-of-github-actions)." diff --git a/translations/de-DE/content/actions/learn-github-actions/index.md b/translations/de-DE/content/actions/learn-github-actions/index.md new file mode 100644 index 000000000000..50778b673ac4 --- /dev/null +++ b/translations/de-DE/content/actions/learn-github-actions/index.md @@ -0,0 +1,42 @@ +--- +title: Learn GitHub Actions +shortTitle: Learn GitHub Actions +intro: 'Whether you are new to {% data variables.product.prodname_actions %} or interested in learning all they have to offer, this guide will help you use {% data variables.product.prodname_actions %} to accelerate your application development workflows.' +redirect_from: + - /articles/about-github-actions + - /github/automating-your-workflow-with-github-actions/about-github-actions + - /actions/automating-your-workflow-with-github-actions/about-github-actions + - /actions/getting-started-with-github-actions + - /actions/getting-started-with-github-actions/about-github-actions + - /actions/getting-started-with-github-actions/overview + - /actions/getting-started-with-github-actions/getting-started-with-github-actions + - /articles/migrating-github-actions-from-hcl-syntax-to-yaml-syntax/ + - /actions/configuring-and-managing-workflows/configuring-a-workflow + - /articles/creating-a-workflow-with-github-actions/ + - /articles/configuring-a-workflow + - /github/automatisieren-ihren-workflow-mit-github-aktionen/configuring-a-workflow + - /actions/automating-your-workflow-with-github-actions/configuring-a-workflow + - /actions/creating-workflows/workflow-configuration-options + - /articles/configuring-workflows + - /github/automating-your-workflow-with-github-actions/configuring-workflows + - /actions/automating-your-workflow-with-github-actions/configuring-workflows + - /github/automating-your-workflow-with-github-actions/getting-started-with-github-actions + - /actions/automating-your-workflow-with-github-actions/getting-started-with-github-actions + - /actions/configuring-and-managing-workflows + - /articles/getting-started-with-github-actions + - /actions/migrating-to-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% link_with_intro /introduction-to-github-actions %} +{% link_with_intro /finding-and-customizing-actions %} +{% link_with_intro /essential-features-of-github-actions %} +{% link_with_intro /managing-complex-workflows %} +{% link_with_intro /sharing-workflows-with-your-organization %} +{% link_with_intro /security-hardening-for-github-actions %} +{% link_with_intro /migrating-from-circleci-to-github-actions %} +{% link_with_intro /migrating-from-gitlab-cicd-to-github-actions %} +{% link_with_intro /migrating-from-azure-pipelines-to-github-actions %} +{% link_with_intro /migrating-from-jenkins-to-github-actions %} diff --git a/translations/de-DE/content/actions/learn-github-actions/introduction-to-github-actions.md b/translations/de-DE/content/actions/learn-github-actions/introduction-to-github-actions.md new file mode 100644 index 000000000000..0b01b9e93884 --- /dev/null +++ b/translations/de-DE/content/actions/learn-github-actions/introduction-to-github-actions.md @@ -0,0 +1,225 @@ +--- +title: Introduction to GitHub Actions +shortTitle: Introduction to GitHub Actions +intro: 'Learn about the core concepts and various components of {% data variables.product.prodname_actions %}, and see an example that shows you how to add automation to your repository.' +redirect_from: + - /github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions + - /actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions + - /actions/getting-started-with-github-actions/core-concepts-for-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Übersicht + +{% data variables.product.prodname_actions %} help you automate tasks within your software development life cycle. {% data variables.product.prodname_actions %} are event-driven, meaning that you can run a series of commands after a specified event has occurred. For example, every time someone creates a pull request for a repository, you can automatically run a command that executes a software testing script. + +This diagram demonstrates how you can use {% data variables.product.prodname_actions %} to automatically run your software testing scripts. An event automatically triggers the _workflow_, which contains a _job_. The job then uses _steps_ to control the order in which _actions_ are run. These actions are the commands that automate your software testing. + +![Workflow overview](/assets/images/help/images/overview-actions-simple.png) + +### The components of {% data variables.product.prodname_actions %} + +Below is a list of the multiple {% data variables.product.prodname_actions %} components that work together to run jobs. You can see how these components interact with each other. + +![Component and service overview](/assets/images/help/images/overview-actions-design.png) + +#### Workflows + +The workflow is an automated procedure that you add to your repository. Workflows are made up of one or more jobs and can be scheduled or triggered by an event. The workflow can be used to build, test, package, release, or deploy a project on {% data variables.product.prodname_dotcom %}. + +#### Ereignisse + +An event is a specific activity that triggers a workflow. Die Aktivität kann beispielsweise von {% data variables.product.prodname_dotcom %} stammen, wenn ein Commit an Repository gepusht oder wenn ein Issue oder ein Pull Request erstellt wird. You can also use the repository dispatch webhook to trigger a workflow when an external event occurs. For a complete list of events that can be used to trigger workflows, see [Events that trigger workflows](/actions/reference/events-that-trigger-workflows). + +#### Jobs + +A job is a set of steps that execute on the same runner. By default, a workflow with multiple jobs will run those jobs in parallel. You can also configure a workflow to run jobs sequentially. Ein Workflow kann beispielsweise zwei sequentielle Aufträge umfassen, in denen der Code erstellt und getestet wird, wobei der Testauftrag vom Status des Build-Auftrags abhängig ist. Wenn der Build-Auftrag fehlschlägt, wird der Testauftrag nicht ausgeführt. + +#### Steps + +A step is an individual task that can run commands (known as _actions_). Each step in a job executes on the same runner, allowing the actions in that job to share data with each other. + +#### Actions + +_Actions_ are standalone commands that are combined into _steps_ to create a _job_. Aktionen sind der kleinste portable Baustein eines Workflows. You can create your own actions, or use actions created by the {% data variables.product.prodname_dotcom %} community. Soll eine Aktion in einem Workflow verwendet werden, müssen Sie sie als Schritt einfügen. + +#### Runners + +A runner is a server that has the {% data variables.product.prodname_actions %} runner application installed. You can use a runner hosted by {% data variables.product.prodname_dotcom %}, or you can host your own. A runner listens for available jobs, runs one job at a time, and reports the progress, logs, and results back to {% data variables.product.prodname_dotcom %}. For {% data variables.product.prodname_dotcom %}-hosted runners, each job in a workflow runs in a fresh virtual environment. + +{% data variables.product.prodname_dotcom %}-hosted runners are based on Ubuntu Linux, Microsoft Windows, and macOS. For information on {% data variables.product.prodname_dotcom %}-hosted runners, see "[Virtual environments for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/virtual-environments-for-github-hosted-runners)." If you need a different operating system or require a specific hardware configuration, you can host your own runners. For information on self-hosted runners, see "[Hosting your own runners](/actions/hosting-your-own-runners)." + +### Create an example workflow + +{% data variables.product.prodname_actions %} uses YAML syntax to define the events, jobs, and steps. These YAML files are stored in your code repository, in a directory called `.github/workflows`. + +You can create an example workflow in your repository that automatically triggers a series of commands whenever code is pushed. In this workflow, {% data variables.product.prodname_actions %} checks out the pushed code, installs the software dependencies, and runs `bats -v`. + +1. In your repository, create the `.github/workflows/` directory to store your workflow files. +1. In the `.github/workflows/` directory, create a new file called `learn-github-actions.yml` and add the following code. + ```yaml + name: learn-github-actions + on: [push] + jobs: + check-bats-version: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - uses: actions/setup-node@v1 + - run: npm install -g bats + - run: bats -v + ``` +1. Commit these changes and push them to your {% data variables.product.prodname_dotcom %} repository. + +Your new {% data variables.product.prodname_actions %} workflow file is now installed in your repository and will run automatically each time someone pushes a change to the repository. For details about a job's execution history, see "[Viewing the workflow's activity](/actions/learn-github-actions/introduction-to-github-actions#viewing-the-jobs-activity)." + +### Understanding the workflow file + +To help you understand how YAML syntax is used to create a workflow file, this section explains each line of the introduction's example: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + ```yaml + name: learn-github-actions + ``` + + Optional - The name of the workflow as it will appear in the Actions tab of the {% data variables.product.prodname_dotcom %} repository. +
+ + ```yaml + on: [push] + ``` + + Specify the event that automatically triggers the workflow file. This example uses the push event, so that the jobs run every time someone pushes a change to the repository. You can set up the workflow to only run on certain branches, paths, or tags. For syntax examples including or excluding branches, paths, or tags, see "Workflow syntax for {% data variables.product.prodname_actions %}." +
+ + ```yaml + jobs: + ``` + + Groups together all the jobs that run in the learn-github-actions workflow file. +
+ + ```yaml + check-bats-version: + ``` + + Defines the name of the check-bats-version job stored within the jobs section. +
+ + ```yaml + runs-on: ubuntu-latest + ``` + + Configures the job to run on an Ubuntu Linux runner. This means that the job will execute on a fresh virtual machine hosted by GitHub. For syntax examples using other runners, see "Workflow syntax for {% data variables.product.prodname_actions %}." +
+ + ```yaml + steps: + ``` + + Groups together all the steps that run in the check-bats-version job. Each line nested under this section is a separate action. +
+ + ```yaml + - uses: actions/checkout@v2 + ``` + + The uses keyword tells the job to retrieve v2 of the community action named actions/checkout@v2. This is an action that checks out your repository and downloads it to the runner, allowing you to run actions against your code (such as testing tools). You must use the checkout action any time your workflow will run against the repository's code or you are using an action defined in the repository. +
+ + ```yaml + - uses: actions/setup-node@v1 + ``` + + This action installs the node software package on the runner, giving you access to the npm command. +
+ + ```yaml + - run: npm install -g bats + ``` + + The run keyword tells the job to execute a command on the runner. In this case, you are using npm to install the bats software testing package. +
+ + ```yaml + - run: bats -v + ``` + + Finally, you'll run the bats command with a parameter that outputs the software version. +
+ +#### Visualizing the workflow file + +In this diagram, you can see the workflow file you just created and how the {% data variables.product.prodname_actions %} components are organized in a hierarchy. Each step executes a single action. Steps 1 and 2 use prebuilt community actions. To find more prebuilt actions for your workflows, see "[Finding and customizing actions](/actions/learn-github-actions/finding-and-customizing-actions)." + +![Workflow overview](/assets/images/help/images/overview-actions-event.png) + + +### Viewing the job's activity + +Once your job has started running, you can view each step's activity on {% data variables.product.prodname_dotcom %}. + +{% data reusables.repositories.navigate-to-repo %} +1. Klicke unter Deinem Repository-Namen auf **Actions** (Aktionen). ![Navigate to repository](/assets/images/help/images/learn-github-actions-repository.png) +1. In the left sidebar, click the workflow you want to see. ![Screenshot of workflow results](/assets/images/help/images/learn-github-actions-workflow.png) +1. Under "Workflow runs", click the name of the run you want to see. ![Screenshot of workflow runs](/assets/images/help/images/learn-github-actions-run.png) +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +1. Click on the job name to see the results of each step. ![Screenshot of workflow run details](/assets/images/help/images/overview-actions-result-updated.png) +{% else %} +1. Click on the job name to see the results of each step. ![Screenshot of workflow run details](/assets/images/help/images/overview-actions-result.png) +{% endif %} + +### Nächste Schritte: + +To continue learning about {% data variables.product.prodname_actions %}, see "[Finding and customizing actions](/actions/learn-github-actions/finding-and-customizing-actions)." + +### Support kontaktieren + +{% data reusables.github-actions.contacting-support %} diff --git a/translations/de-DE/content/actions/learn-github-actions/managing-complex-workflows.md b/translations/de-DE/content/actions/learn-github-actions/managing-complex-workflows.md new file mode 100644 index 000000000000..2b440ca7a302 --- /dev/null +++ b/translations/de-DE/content/actions/learn-github-actions/managing-complex-workflows.md @@ -0,0 +1,151 @@ +--- +title: Managing complex workflows +shortTitle: Managing complex workflows +intro: 'This guide shows you how to use the advanced features of {% data variables.product.prodname_actions %}, with secret management, dependent jobs, caching, build matrices, and labels.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Übersicht + +This article describes some of the advanced features of {% data variables.product.prodname_actions %} that help you work create more complex workflows. + +### Storing secrets + +If your workflows use sensitive data, such as passwords or certificates, you can save these in {% data variables.product.prodname_dotcom %} as _secrets_ and then use them in your workflows as environment variables. This means that you will be able to create and share workflows without having to embed sensitive values directly in the YAML workflow. + +This example action demonstrates how to reference an existing secret as an environment variable, and send it as a parameter to an example command. + +{% raw %} +```yaml +jobs: + example-job: + steps: + - name: Retrieve secret + env: + super_secret: ${{ secrets.SUPERSECRET }} + run: | + example-command "$SUPER_SECRET" +``` +{% endraw %} + +Weitere Informationen findest Du unter „[Verschlüsselte Geheimnisse erstellen und speichern](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)“. + +### Creating dependent jobs + +By default, the jobs in your workflow all run in parallel at the same time. So if you have a job that must only run after another job has completed, you can use the `needs` keyword to create this dependency. If one of the jobs fails, all dependent jobs are skipped; however, if you need the jobs to continue, you can define this using the [`if`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idif) conditional statement. + +In this example, the `setup`, `build`, and `test` jobs run in series, with `build` and `test` being dependent on the successful completion of the job that precedes them: + +```yaml +jobs: + setup: + runs-on: ubuntu-latest + steps: + - run: ./setup_server.sh + build: + needs: setup + steps: + - run: ./build_server.sh + test: + needs: build + runs-on: ubuntu-latest + steps: + - run: ./test_server.sh +``` + +For more information, see [`jobs..needs`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds). + +### Using a build matrix + +You can use a build matrix if you want your workflow to run tests across multiple combinations of operating systems, platforms, and languages. The build matrix is created using the `strategy` keyword, which receives the build options as an array. For example, this build matrix will run the job multiple times, using different versions of Node.js: + +{% raw %} +```yaml +jobs: + build: + runs-on: ubuntu-latest + strategy: + matrix: + node: [6, 8, 10] + steps: + - uses: actions/setup-node@v1 + with: + node-version: ${{ matrix.node }} +``` +{% endraw %} + +For more information, see [`jobs..strategy.matrix`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix). + +### Abhängigkeiten „cachen“ (zwischenspeichern) + +{% data variables.product.prodname_dotcom %}-hosted runners are started as fresh environments for each job, so if your jobs regularly reuse dependencies, you can consider caching these files to help improve performance. Once the cache is created, it is available to all workflows in the same repository. + +This example demonstrates how to cache the `~/.npm` directory: + +{% raw %} +```yaml +jobs: + example-job: + steps: + - name: Cache node modules + uses: actions/cache@v2 + env: + cache-name: cache-node-modules + with: + path: ~/.npm + key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }} + restore-keys: | + ${{ runner.os }}-build-${{ env.cache-name }}- +``` +{% endraw %} + +Weitere Informationen findest Du unter „[Abhängigkeiten zur Beschleunigung von Workflows im Cache zwischenspeichern](/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows)“. + +### Datenbanken und Service-Container verwenden + +If your job requires a database or cache service, you can use the [`services`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idservices) keyword to create an ephemeral container to host the service; the resulting container is then available to all steps in that job and is removed when the job has completed. This example demonstrates how a job can use `services` to create a `postgres` container, and then use `node` to connect to the service. + +```yaml +jobs: + container-job: + runs-on: ubuntu-latest + container: node:10.18-jessie + services: + postgres: + image: postgres + steps: + - name: Check out repository code + uses: actions/checkout@v2 + - name: Install dependencies + run: npm ci + - name: Connect to PostgreSQL + run: node client.js + env: + POSTGRES_HOST: postgres + POSTGRES_PORT: 5432 +``` + +For more information, see "[Using databases and service containers](/actions/configuring-and-managing-workflows/using-databases-and-service-containers)." + +### Using labels to route workflows + +This feature helps you assign jobs to a specific self-hosted runner. If you want to be sure that a particular type of runner will process your job, you can use labels to control where jobs are executed. You can assign labels to a self-hosted runner, and then refer to these labels in your YAML workflow, ensuring that the job is routed in a predictable way. + +This example shows how a workflow can use labels to specify the required runner: + +```yaml +jobs: + example-job: + runs-on: [self-hosted, linux, x64, gpu] +``` + +For more information, see ["Using labels with self-hosted runners](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners)." + +### Nächste Schritte: + +To continue learning about {% data variables.product.prodname_actions %}, see "[Sharing workflows with your organization](/actions/learn-github-actions/sharing-workflows-with-your-organization)." diff --git a/translations/de-DE/content/actions/learn-github-actions/migrating-from-azure-pipelines-to-github-actions.md b/translations/de-DE/content/actions/learn-github-actions/migrating-from-azure-pipelines-to-github-actions.md new file mode 100644 index 000000000000..f4fde469865a --- /dev/null +++ b/translations/de-DE/content/actions/learn-github-actions/migrating-from-azure-pipelines-to-github-actions.md @@ -0,0 +1,327 @@ +--- +title: Von Azure-Pipelines zu GitHub-Aktionen migrieren +intro: '{% data variables.product.prodname_actions %} und Azure-Pipelines haben mehrere Ähnlichkeiten in der Konfiguration, was die Migration zu {% data variables.product.prodname_actions %} relativ einfach macht.' +redirect_from: + - /actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Einführung + +Azure-Pipelines und {% data variables.product.prodname_actions %} ermöglichen es Dir, Workflows zu erstellen, die automatisch Code bauen, testen, publizieren, freigeben und bereitstellen. Azure-Pipelines und {% data variables.product.prodname_actions %} haben einige Ähnlichkeiten in der Workflow-Konfiguration: + +- Workflow-Konfigurationsdateien werden in YAML geschrieben und im Code-Repository gespeichert. +- Workflows umfassen einen oder mehrere Jobs. +- Jobs beinhalten einen oder mehrere Schritte oder einzelne Befehle. +- Schritte oder Aufgaben können wiederverwendet und in der Community gemeinsam genutzt werden. + +Weitere Informationen findest Du unter „[Kernkonzepte für {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)“. + +### Wesentliche Unterschiede + +Bei der Migration von Azure-Pipelines sollten die folgenden Unterschiede beachtet werden: + +- Azure Pipelines unterstützt einen veralteten _klassischen Editor_, mit dem Du Deine CI-Konfiguration in einem GUI-Editor definieren kannst, anstatt die Pipeline-Definition in einer YAML-Datei zu erstellen. {% data variables.product.prodname_actions %} verwendet YAML-Dateien, um Workflows zu definieren, und unterstützt keinen grafischen Editor. +- Azure Pipelines erlaubt Dir, einige Strukturen in Job-Definitionen zu weglassen. Wenn Du zum Beispiel nur einen einzigen Job hast, brauchst Du den Job an sich nicht zu definieren, sondern nur seine Schritte. {% data variables.product.prodname_actions %} erfordert eine explizite Konfiguration und die YAML-Struktur kann nicht weggelassen werden. +- Azure Pipelines unterstützt _„stages“ (Phasen)_ die in der YAML-Datei definiert sind, welche verwendet werden kann, um Workflows für die Bereitstellung zu erstellen. {% data variables.product.prodname_actions %} erfordert, die Phasen in separate YAML-Workflowdateien zu aufzuteilen. +- Bei Azure-Pipelines können lokale Build-Agenten nach Funktionalität ausgewählt werden. Bei {% data variables.product.prodname_actions %} können selbst-gehostete Runner nach Labels ausgewählt werden. + +### Jobs und Schritte migrieren + +Jobs und Schritte in Azure-Pipelines sind sehr ähnlich zu Jobs und Schritten in {% data variables.product.prodname_actions %}. In beiden Systemen haben Jobs folgende Merkmale: + +* Jobs enthalten eine Reihe von Schritten, die nacheinander ausgeführt werden. +* Jobs laufen auf separaten virtuellen Maschinen oder in separaten Containern. +* Jobs werden standardmäßig parallel ausgeführt, können aber so konfiguriert werden, dass sie sequentiell laufen. + +### Skriptschritte migrieren + +Du kannst in einem Workflow ein Skript oder einen Shell-Befehl als Schritt ausführen. In Azure-Pipelines können Skriptschritte mit dem Schlüssel `script`, `bash`, `powershell` oder `pwsh` festgelegt werden. Skripte können auch als Eingabe für den [Bash-Task](https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/utility/bash?view=azure-devops) oder den [PowerShell-Task](https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/utility/powershell?view=azure-devops) angegeben werden. + +In {% data variables.product.prodname_actions %} sind alle Skripte mit dem Schlüssel `run` spezifiziert. Um eine bestimmte Shell auszuwählen, kannst Du den Schlüssel `shell` angeben, wenn Du das Skript zur Verfügung stellst. Weitere Informationen findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)“. + +Nachfolgend ein Beispiel für die Syntax in jedem System: + + + + + + + + + + +
+Azure-Pipelines + +{% data variables.product.prodname_actions %} +
+{% raw %} +```yaml +jobs: +- job: scripts + pool: + vmImage: 'windows-latest' + steps: + - script: echo "This step runs in the default shell" + - bash: echo "This step runs in bash" + - pwsh: Write-Host "This step runs in PowerShell Core" + - task: PowerShell@2 + inputs: + script: Write-Host "This step runs in PowerShell" +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + scripts: + runs-on: windows-latest + steps: + - run: echo "This step runs in the default shell" + - run: echo "This step runs in bash" + shell: bash + - run: Write-Host "This step runs in PowerShell Core" + shell: pwsh + - run: Write-Host "This step runs in PowerShell" + shell: powershell +``` +{% endraw %} +
+ +### Unterschiede in der Behandlung von Skriptfehlern + +In Azure-Pipelines können Skripte dazu konfiguriert werden, fehlzuschlagen, wenn irgendeine Ausgabe an `stderr` gesendet wird. {% data variables.product.prodname_actions %} unterstützt diese Konfiguration nicht. + +{% data variables.product.prodname_actions %} konfiguriert Shells zum "schnellen Scheitern" wann immer möglich , was das Skript sofort beendet, wenn einer der Befehle in einem Skript mit einem Fehlercode endet. Im Gegensatz dazu erfordern Azure-Pipelines explizite Konfiguration, um bei einem Fehler sofort abzubrechen. Weitere Informationen findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#exit-codes-and-error-action-preference)“. + +### Unterschiede in der Standard-Shell unter Windows + +In Azure-Pipelines ist die Standard-Shell für Skripte auf Windows-Plattformen die Command-Shell (_cmd.exe_). In {% data variables.product.prodname_actions %} ist die Standard-Shell für Skripte auf Windows-Plattformen die PowerShell. PowerShell hat mehrere Unterschiede in internen Befehlen, Auswertung von Variablen und Flusssteuerung. + +Wenn Du einen einfachen Befehl ausführst, kannst Du in PowerShell möglicherweise ein Skript der Command Shell ohne Änderungen laufen lassen. Aber in den meisten Fällen musst Du entweder Dein Skript zur Syntax der PowerShell aktualisieren oder {% data variables.product.prodname_actions %} anweisen, das Skript mit der Command Shell statt mit PowerShell auszuführen. Dies kannst Du tun, indem Du unter `shell` den Wert `cmd` angibst. + +Nachfolgend ein Beispiel für die Syntax in jedem System: + + + + + + + + + + +
+Azure-Pipelines + +{% data variables.product.prodname_actions %} +
+{% raw %} +```yaml +jobs: +- job: run_command + pool: + vmImage: 'windows-latest' + steps: + - script: echo "This step runs in CMD on Windows by default" +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + run_command: + runs-on: windows-latest + steps: + - run: echo "This step runs in PowerShell on Windows by default" + - run: echo "This step runs in CMD on Windows explicitly" + shell: cmd +``` +{% endraw %} +
+ +Weitere Informationen findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#using-a-specific-shell)“. + +### Syntax für Bedingungen und Ausdrücke migrieren + +Sowohl Azure-Pipelines als auch {% data variables.product.prodname_actions %} können Schritte bedingt ausführen. In Azure-Pipelines werden bedingte Ausdrücke mit dem Schlüssel `condition` angegeben. In {% data variables.product.prodname_actions %} werden bedingte Ausdrücke mit dem Schlüssel `if` angegeben. + +Azure-Pipelines verwenden Funktionen innerhalb von Ausdrücken, um Schritte bedingt auszuführen. Im Gegensatz dazu verwenden {% data variables.product.prodname_actions %} eine Infix-Notation. Zum Beispiel musst Du die Funktion `eq` in Azure-Pipelines durch den Operator `==` in {% data variables.product.prodname_actions %} ersetzen. + +Nachfolgend ein Beispiel für die Syntax in jedem System: + + + + + + + + + + +
+Azure-Pipelines + +{% data variables.product.prodname_actions %} +
+{% raw %} +```yaml +jobs: +- job: conditional + pool: + vmImage: 'ubuntu-latest' + steps: + - script: echo "This step runs with str equals 'ABC' and num equals 123" + condition: and(eq(variables.str, 'ABC'), eq(variables.num, 123)) +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + conditional: + runs-on: ubuntu-latest + steps: + - run: echo "This step runs with str equals 'ABC' and num equals 123" + if: ${{ env.str == 'ABC' && env.num == 123 }} +``` +{% endraw %} +
+ +Weitere Informationen findest Du unter „[Kontext- und Ausdrucks-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)“. + +### Abhängigkeiten zwischen Jobs + +Sowohl bei Azure-Pipelines als auch bei {% data variables.product.prodname_actions %} kannst Du Abhängigkeiten für einen Job festlegen. In beiden Systemen laufen Jobs standardmäßig parallel, aber Jobabhängigkeiten können explizit angegeben werden. In Azure-Pipelines erfolgt dies mit dem Schlüssel `dependsOn`. In {% data variables.product.prodname_actions %}wird dies mit dem Schlüssel `needs` getan. + +Nachfolgend ein Beispiel für die Syntax in jedem System. Die Workflows starten einen ersten Job namens `initial` und wenn dieser Job beendet ist, laufen zwei Jobs namens `fanout1` und `fanout2`. Schließlich, wenn diese Jobs abgeschlossen sind, läuft der Job `fanin`. + + + + + + + + + + +
+Azure-Pipelines + +{% data variables.product.prodname_actions %} +
+{% raw %} +```yaml +jobs: +- job: initial + pool: + vmImage: 'ubuntu-latest' + steps: + - script: echo "This job will be run first." +job: fanout1 + pool: + vmImage: 'ubuntu-latest' + dependsOn: initial + steps: + - script: echo "This job will run after the initial job, in parallel with fanout2." +job: fanout2 + pool: + vmImage: 'ubuntu-latest' + dependsOn: initial + steps: + - script: echo "This job will run after the initial job, in parallel with fanout1." +job: fanin: + pool: + vmImage: 'ubuntu-latest' + dependsOn: [fanout1, fanout2] + steps: + - script: echo "This job will run after fanout1 and fanout2 have finished." +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + initial: + runs-on: ubuntu-latest + steps: + - run: echo "This job will be run first." + fanout1: + runs-on: ubuntu-latest + needs: initial + steps: + - run: echo "This job will run after the initial job, in parallel with fanout2." + fanout2: + runs-on: ubuntu-latest + needs: initial + steps: + - run: echo "This job will run after the initial job, in parallel with fanout1." + fanin: + runs-on: ubuntu-latest + needs: [fanout1, fanout2] + steps: + - run: echo "This job will run after fanout1 and fanout2 have finished." +``` +{% endraw %} +
+ +Weitere Informationen findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)“. + +### „Tasks“ (Aufgaben) zu Aktionen migrieren + +Azure-Pipelines verwenden _tasks_. Das sind Anwendungskomponenten, die in mehreren Workflows wiederverwendet werden können. {% data variables.product.prodname_actions %} verwenden _Aktionen_, Diese können verwendet werden, um Aufgaben auszuführen und Ihren Workflow anzupassen. In beiden Systemen kannst Du den Namen der zu ausführenden Aufgabe oder Aktion sowie alle erforderlichen Eingaben als Schlüssel/Wert-Paare angeben. + +Nachfolgend ein Beispiel für die Syntax in jedem System: + + + + + + + + + + +
+Azure-Pipelines + +{% data variables.product.prodname_actions %} +
+{% raw %} +```yaml +jobs: +- job: run_python + pool: + vmImage: 'ubuntu-latest' + steps: + - task: UsePythonVersion@0 + inputs: + versionSpec: '3.7' + architecture: 'x64' + - script: python script.py +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + run_python: + runs-on: ubuntu-latest + steps: + - uses: actions/setup-python@v2 + with: + python-version: '3.7' + architecture: 'x64' + - run: python script.py +``` +{% endraw %} +
+ +Aktionen zur Verwendung in Deinem Workflow findest du entweder auf dem [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=actions) oder Du kannst eigene Aktionen erstellen. For more information, see "[Creating actions](/actions/creating-actions)." + diff --git a/translations/de-DE/content/actions/learn-github-actions/migrating-from-circleci-to-github-actions.md b/translations/de-DE/content/actions/learn-github-actions/migrating-from-circleci-to-github-actions.md new file mode 100644 index 000000000000..10a49d4a7888 --- /dev/null +++ b/translations/de-DE/content/actions/learn-github-actions/migrating-from-circleci-to-github-actions.md @@ -0,0 +1,447 @@ +--- +title: Von CircleCI zu GitHub-Aktionen migrieren +intro: 'GitHub-Aktionen und CircleCI haben mehrere Ähnlichkeiten in der Konfiguration, was die Migration zu GitHub-Aktionen relativ einfach macht.' +redirect_from: + - /actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Einführung + +CircleCI und {% data variables.product.prodname_actions %} ermöglichen es Dir, Workflows zu erstellen, die Code automatisch bauen, testen, veröffentlichen, freigeben und bereitstellen. CircleCI und {% data variables.product.prodname_actions %} haben einige Ähnlichkeiten in der Workflow-Konfiguration: + +- Workflow-Konfigurationsdateien werden in YAML geschrieben und im Repository gespeichert. +- Workflows umfassen einen oder mehrere Jobs. +- Jobs beinhalten einen oder mehrere Schritte oder einzelne Befehle. +- Schritte oder Aufgaben können wiederverwendet und in der Community gemeinsam genutzt werden. + +Weitere Informationen findest Du unter „[Kernkonzepte für {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)“. + +### Wesentliche Unterschiede + +Betrachte bei der Migration von CircleCI folgende Unterschiede: + +- Die automatische Testparallelität des CircleCI gruppiert die Tests automatisch nach benutzerdefinierten Regeln oder historischen Zeitinformationen. Diese Funktionalität ist in {% data variables.product.prodname_actions %} nicht eingebaut. +- Aktionen, die in Docker-Containern ausgeführt werden, sind sensibel für Berechtigungsprobleme, da Container eine andere Zuordnung von Benutzern haben. Du kannst viele dieser Probleme vermeiden, indem Du die Anweisung `USER` in Deinem *Dockerfile* nicht verwendest. Weitere Informationen über das Docker-Dateisystem findest Du unter „[Virtuelle Umgebungen für {% data variables.product.product_name %}-gehostete Runner](/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem)“. + +### Workflows und Jobs migrieren + +CircleCI definiert `Workflows` in der Datei *config.yml*, wodurch Du mehrere Workflows konfigurieren kannst. {% data variables.product.product_name %} benötigt pro Workflow eine Workflow-Datei und erfordert daher nicht `Workflows` zu deklarieren. Du musst für jeden Workflow, der in *config.yml* konfiguriert ist, eine neue Workflow-Datei erstellen. + +Sowohl CircleCI als auch {% data variables.product.prodname_actions %} konfigurieren `Jobs` in der Konfigurationsdatei, und das mit ähnlicher Syntax. Wenn Du Abhängigkeiten zwischen Jobs in Deinem CircleCI-Workflow mit `requires` konfigurierst, kannst Du in {% data variables.product.prodname_actions %} die äquivalente Syntax `needs` verwenden. Weitere Informationen findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)“. + +### „Orbs“ (Gestirne) zu Aktionen migrieren + +Sowohl CircleCI als auch {% data variables.product.prodname_actions %} bieten einen Mechanismus, um Aufgaben in einem Workflow wiederzuverwenden und weiterzugeben. CircleCI verwendet ein Konzept namens „Orbs“ (Gestirne), das in YAML geschrieben ist, um Aufgaben bereitzustellen, die man in einem Workflow wiederverwenden kann. {% data variables.product.prodname_actions %} hat mächtige und flexible wiederverwendbare Komponenten namens Aktionen, die man entweder mit JavaScript-Dateien oder mit Docker-Images erstellt. Um Aktionen zu erstellen, kannst Du eigenen Code schreiben, der mit Deinem Repository auf die gewünschte Weise interagiert und dabei beispielsweise in die APIs von {% data variables.product.product_name %} und beliebige öffentlich zugänglichen Drittanbieter-APIs integriert. Mit einer Aktion können Sie beispielsweise npm-Module veröffentlichen, SMS-Nachrichten bei dringenden Problemen senden oder produktionsreifen Code bereitstellen. For more information, see "[Creating actions](/actions/creating-actions)." + +CircleCI kann Workflows mit YAML-Ankern und Aliasen wiederverwenden. {% data variables.product.prodname_actions %} unterstützen den üblichen Bedarf an Wiederverwendbarkeit durch Build-Matrizen. For more information about build matrixes, see "[Managing complex workflows](/actions/learn-github-actions/managing-complex-workflows/#using-a-build-matrix)." + +### Docker-Images verwenden + + +Sowohl CircleCI als auch {% data variables.product.prodname_actions %} können Schritte innerhalb eines Docker-Images ausführen. + +CircleCI stellt eine Reihe von vordefinierten Images mit üblichen Abhängigkeiten zur Verfügung. Diese Images haben `circleci` als `USER` gesetzt, was zu Konflikten mit {% data variables.product.prodname_actions %} führt. + +Wir empfehlen Dir, von vordefinierten CircleCI-Images zu wegzugehen, wenn Du zu {% data variables.product.prodname_actions %} migrierst. In vielen Fällen kannst Du die zusätzlich benötigten Abhängigkeiten mithilfe von Aktionen installieren. + +Weitere Informationen über das Docker-Dateisystem findest Du unter „[Virtuelle Umgebungen für {% data variables.product.product_name %}-gehostete Runner](/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem)“. + +For more information about the tools and packages available on {% data variables.product.prodname_dotcom %}-hosted virtual environments, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". + +### Variablen und Geheimnisse verwenden + +CircleCI und {% data variables.product.prodname_actions %} unterstützen das Setzen von Umgebungsvariablen in der Konfigurationsdatei und das Erstellen von Geheimnissen mit der Benutzeroberfläche von entweder CircleCI oder {% data variables.product.product_name %}. + +Weitere Informationen findest Du unter „[Umgebungsvariablen verwenden](/actions/configuring-and-managing-workflows/using-environment-variables)“ und „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)“. + +### Im Cache zwischenspeichern + +CircleCI und {% data variables.product.prodname_actions %} bieten in der Konfigurationsdatei eine Methode an, um Dateien manuell im Cache zwischenzuspeichern. + +Nachfolgend ein Beispiel für die Syntax in jedem System. + + + + + + + + + + +
+CircleCI + +GitHub Actions +
+{% raw %} +```yaml +- restore_cache: + keys: + - v1-npm-deps-{{ checksum "package-lock.json" }} + - v1-npm-deps- +``` +{% endraw %} + +{% raw %} +```yaml +- name: Cache node modules + uses: actions/cache@v2 + with: + path: ~/.npm + key: v1-npm-deps-${{ hashFiles('**/package-lock.json') }} + restore-keys: v1-npm-deps- +``` +{% endraw %} +
+ +Weitere Informationen findest Du unter „[Abhängigkeiten zur Beschleunigung von Workflows im Cache zwischenspeichern](/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows)“. + +{% data variables.product.prodname_actions %} hat kein Äquivalent zum „Docker Layer Caching“ („DLC“, im Cache auf Docker-Ebene zwischenspeichern). + +### Daten zwischen Jobs persistieren + +Sowohl CircleCI als auch {% data variables.product.prodname_actions %} bieten Mechanismen für die Persistierung von Daten zwischen Jobs. + +Nachfolgend siehst Du ein Beispiel in der Konfigurationssyntax von CircleCI und {% data variables.product.prodname_actions %}. + + + + + + + + + + +
+CircleCI + +GitHub Actions +
+{% raw %} +```yaml +- persist_to_workspace: + root: workspace + paths: + - math-homework.txt + +... + +- attach_workspace: + at: /tmp/workspace +``` +{% endraw %} + +{% raw %} +```yaml +- name: Upload math result for job 1 + uses: actions/upload-artifact@v2 + with: + name: homework + path: math-homework.txt + +... + +- name: Download math result for job 1 + uses: actions/download-artifact@v2 + with: + name: homework +``` +{% endraw %} +
+ +Weitere Informationen findest Du unter „[Workflow-Daten mittels Artefakten persistieren](/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts)“. + +### Datenbanken und Service-Container verwenden + +Mit beiden Systemen kannst Du zusätzliche Container für Datenbanken, Zwischenspeicherung im Cache oder andere Abhängigkeiten einbinden. + +In CircleCI ist das erste in der *config.yaml* aufgelistete Image, das primäre Image, welches benutzt wird, um Befehle auszuführen. {% data variables.product.prodname_actions %} verwendet explizite Abschnitte: `container` für den primären Container und zusätzliche Container aufgelistet in `services`. + +Nachfolgend siehst Du ein Beispiel in der Konfigurationssyntax von CircleCI und {% data variables.product.prodname_actions %}. + + + + + + + + + + +
+CircleCI + +GitHub Actions +
+{% raw %} +```yaml +--- +version: 2.1 + +jobs: + + ruby-26: + docker: + - image: circleci/ruby:2.6.3-node-browsers-legacy + environment: + PGHOST: localhost + PGUSER: administrate + RAILS_ENV: test + - image: postgres:10.1-alpine + environment: + POSTGRES_USER: administrate + POSTGRES_DB: ruby26 + POSTGRES_PASSWORD: "" + + working_directory: ~/administrate + + steps: + - checkout + + # Abhaengigkeiten gebuendelt installieren + - run: bundle install --path vendor/bundle + + # auf DB warten + - run: dockerize -wait tcp://localhost:5432 -timeout 1m + + # Umgebung einrichten + - run: cp .sample.env .env + + # Datenbank einrichten + - run: bundle exec rake db:setup + + # Tests durchfuehren + - run: bundle exec rake + + +workflows: + version: 2 + build: + jobs: + - ruby-26 +... + +- attach_workspace: + at: /tmp/workspace +``` +{% endraw %} + +{% raw %} +```yaml +name: Containers + +on: [push] + +jobs: + build: + + runs-on: ubuntu-latest + container: circleci/ruby:2.6.3-node-browsers-legacy + + env: + PGHOST: postgres + PGUSER: administrate + RAILS_ENV: test + + services: + postgres: + image: postgres:10.1-alpine + env: + POSTGRES_USER: administrate + POSTGRES_DB: ruby25 + POSTGRES_PASSWORD: "" + ports: + - 5432:5432 + # einen Gesundheitscheck zufuegen + options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5 + + steps: + # Diese Docker-Datei Setzt USER auf circleci statt dem Standardbenutzer, daher muessen wir die Datei-Berechtigungen fuer dieses Image aktualisieren, um auf GH-Aktionen arbeiten zu koennen. + # See https://docs.github.com/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem + - name: Setup file system permissions + run: sudo chmod -R 777 $GITHUB_WORKSPACE /github /__w/_temp + - uses: actions/checkout@v2 + - name: Install dependencies + run: bundle install --path vendor/bundle + - name: Setup environment configuration + run: cp .sample.env .env + - name: Setup database + run: bundle exec rake db:setup + - name: Run tests + run: bundle exec rake +``` +{% endraw %} +
+ +Weitere Informationen findest Du unter „[Informationen zu Servicecontainern](/actions/configuring-and-managing-workflows/about-service-containers)“. + +### Vollständiges Beispiel + +Nachfolgend siehst Du ein Beispiel aus der realen Welt. Die linke Seite zeigt die tatsächliche *config.yml* unter CircleCI für das Repository [thoughtbot/administrator](https://github.com/thoughtbot/administrate). Die rechte Seite zeigt das Äquivalent unter {% data variables.product.prodname_actions %}. + + + + + + + + + + +
+CircleCI + +GitHub Actions +
+{% raw %} +```yaml +--- +version: 2.1 + +commands: + shared_steps: + steps: + - checkout + + # Abhaengigkeiten aus dem Cache wiederherstellen + - restore_cache: + name: Restore bundle cache + key: administrate-{{ checksum "Gemfile.lock" }} + + # Abhaengigkeiten gebuendelt installieren + - run: bundle install --path vendor/bundle + + # Abhaengigkeiten im Cache zwischenspeichern + - save_cache: + name: Store bundle cache + key: administrate-{{ checksum "Gemfile.lock" }} + paths: + - vendor/bundle + + # auf DB warten + - run: dockerize -wait tcp://localhost:5432 -timeout 1m + + # Umgebung einrichten + - run: cp .sample.env .env + + # Datenbank einrichten + - run: bundle exec rake db:setup + + # Tests durchfuehren + - run: bundle exec rake + +default_job: &default_job + working_directory: ~/administrate + steps: + - shared_steps + # Test mit verschiedenen Versionen von Rails durchfuehren + - run: bundle exec appraisal install + - run: bundle exec appraisal rake + +jobs: + ruby-25: + <<: *default_job + docker: + - image: circleci/ruby:2.5.0-node-browsers + environment: + PGHOST: localhost + PGUSER: administrate + RAILS_ENV: test + - image: postgres:10.1-alpine + environment: + POSTGRES_USER: administrate + POSTGRES_DB: ruby25 + POSTGRES_PASSWORD: "" + + ruby-26: + <<: *default_job + docker: + - image: circleci/ruby:2.6.3-node-browsers-legacy + environment: + PGHOST: localhost + PGUSER: administrate + RAILS_ENV: test + - image: postgres:10.1-alpine + environment: + POSTGRES_USER: administrate + POSTGRES_DB: ruby26 + POSTGRES_PASSWORD: "" + + +workflows: + version: 2 + multiple-rubies: + jobs: + - ruby-26 + - ruby-25 +``` +{% endraw %} + +{% raw %} +```yaml +name: Containers + +on: [push] + +jobs: + build: + + strategy: + matrix: + ruby: [2.5, 2.6.3] + + runs-on: ubuntu-latest + + env: + PGHOST: localhost + PGUSER: administrate + RAILS_ENV: test + + services: + postgres: + image: postgres:10.1-alpine + env: + POSTGRES_USER: administrate + POSTGRES_DB: ruby25 + POSTGRES_PASSWORD: "" + ports: + - 5432:5432 + # Add a health check + options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5 + + steps: + - uses: actions/checkout@v2 + - name: Setup Ruby + uses: eregon/use-ruby-action@master + with: + ruby-version: ${{ matrix.ruby }} + - name: Cache dependencies + uses: actions/cache@v2 + with: + path: vendor/bundle + key: administrate-${{ matrix.image }}-${{ hashFiles('Gemfile.lock') }} + - name: Install postgres headers + run: sudo apt-get install libpq-dev + - name: Install dependencies + run: bundle install --path vendor/bundle + - name: Setup environment configuration + run: cp .sample.env .env + - name: Setup database + run: bundle exec rake db:setup + - name: Run tests + run: bundle exec rake + - name: Install appraisal + run: bundle exec appraisal install + - name: Run appraisal + run: bundle exec appraisal rake +``` +{% endraw %} +
diff --git a/translations/de-DE/content/actions/learn-github-actions/migrating-from-gitlab-cicd-to-github-actions.md b/translations/de-DE/content/actions/learn-github-actions/migrating-from-gitlab-cicd-to-github-actions.md new file mode 100644 index 000000000000..8d389fccd891 --- /dev/null +++ b/translations/de-DE/content/actions/learn-github-actions/migrating-from-gitlab-cicd-to-github-actions.md @@ -0,0 +1,476 @@ +--- +title: Migrating from GitLab CI/CD to GitHub Actions +intro: '{% data variables.product.prodname_actions %} and GitLab CI/CD share several configuration similarities, which makes migrating to {% data variables.product.prodname_actions %} relatively straightforward.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Einführung + +GitLab CI/CD and {% data variables.product.prodname_actions %} both allow you to create workflows that automatically build, test, publish, release, and deploy code. GitLab CI/CD and {% data variables.product.prodname_actions %} share some similarities in workflow configuration: + +- Workflow-Konfigurationsdateien werden in YAML geschrieben und im Code-Repository gespeichert. +- Workflows umfassen einen oder mehrere Jobs. +- Jobs beinhalten einen oder mehrere Schritte oder einzelne Befehle. +- Jobs can run on either managed or self-hosted machines. + +There are a few differences, and this guide will show you the important differences so that you can migrate your workflow to {% data variables.product.prodname_actions %}. + +### Jobs + +Jobs in GitLab CI/CD are very similar to jobs in {% data variables.product.prodname_actions %}. In beiden Systemen haben Jobs folgende Merkmale: + +* Jobs contain a series of steps or scripts that run sequentially. +* Jobs can run on separate machines or in separate containers. +* Jobs werden standardmäßig parallel ausgeführt, können aber so konfiguriert werden, dass sie sequentiell laufen. + +You can run a script or a shell command in a job. In GitLab CI/CD, script steps are specified using the `script` key. In {% data variables.product.prodname_actions %} sind alle Skripte mit dem Schlüssel `run` spezifiziert. + +Nachfolgend ein Beispiel für die Syntax in jedem System: + + + + + + + + + + +
+GitLab CI/CD + +{% data variables.product.prodname_actions %} +
+{% raw %} +```yaml +job1: + variables: + GIT_CHECKOUT: "true" + script: + - echo "Run your script here" +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + job1: + steps: + - uses: actions/checkout@v2 + - run: echo "Run your script here" +``` +{% endraw %} +
+ +### Runners + +Runners are machines on which the jobs run. Both GitLab CI/CD and {% data variables.product.prodname_actions %} offer managed and self-hosted variants of runners. In GitLab CI/CD, `tags` are used to run jobs on different platforms, while in {% data variables.product.prodname_actions %} it is done with the `runs-on` key. + +Nachfolgend ein Beispiel für die Syntax in jedem System: + + + + + + + + + + +
+GitLab CI/CD + +{% data variables.product.prodname_actions %} +
+{% raw %} +```yaml +windows_job: + tags: + - windows + script: + - echo Hello, %USERNAME%! + +linux_job: + tags: + - linux + script: + - echo "Hello, $USER!" +``` +{% endraw %} + +{% raw %} +```yaml +windows_job: + runs-on : windows-latest + steps: + - run: echo Hello, %USERNAME%! + +linux_job: + runs-on: ubuntu-latest + steps: + - run: echo "Hello, $USER!" +``` +{% endraw %} +
+ +For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on)." + +### Docker images + +Both GitLab CI/CD and {% data variables.product.prodname_actions %} support running jobs in a Docker image. In GitLab CI/CD, Docker images are defined with a `image` key, while in {% data variables.product.prodname_actions %} it is done with the `container` key. + +Nachfolgend ein Beispiel für die Syntax in jedem System: + + + + + + + + + + +
+GitLab CI/CD + +{% data variables.product.prodname_actions %} +
+{% raw %} +```yaml +my_job: + image: node:10.16-jessie +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + my_job: + container: node:10.16-jessie +``` +{% endraw %} +
+ +For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idcontainer)." + +### Condition and expression syntax + +GitLab CI/CD uses `rules` to determine if a job will run for a specific condition. {% data variables.product.prodname_actions %} uses the `if` keyword to prevent a job from running unless a condition is met. + +Nachfolgend ein Beispiel für die Syntax in jedem System: + + + + + + + + + + +
+GitLab CI/CD + +{% data variables.product.prodname_actions %} +
+{% raw %} +```yaml +deploy_prod: + stage: deploy + script: + - echo "Deply to production server" + rules: + - if: '$CI_COMMIT_BRANCH == "master"' +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + deploy_prod: + if: contains( github.ref, 'master') + runs-on: ubuntu-latest + steps: + - run: echo "Deply to production server" +``` +{% endraw %} +
+ +Weitere Informationen findest Du unter „[Kontext- und Ausdrucks-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)“. + +### Dependencies between Jobs + +Both GitLab CI/CD and {% data variables.product.prodname_actions %} allow you to set dependencies for a job. In both systems, jobs run in parallel by default, but job dependencies in {% data variables.product.prodname_actions %} can be specified explicitly with the `needs` key. GitLab CI/CD also has a concept of `stages`, where jobs in a stage run concurrently, but the next stage will start when all the jobs in the previous stage have completed. You can recreate this scenario in {% data variables.product.prodname_actions %} with the `needs` key. + +Nachfolgend ein Beispiel für die Syntax in jedem System. The workflows start with two jobs named `build_a` and `build_b` running in parallel, and when those jobs complete, another job called `test_ab` will run. Finally, when `test_ab` completes, the `deploy_ab` job will run. + + + + + + + + + + +
+GitLab CI/CD + +{% data variables.product.prodname_actions %} +
+{% raw %} +```yaml +stages: + - build + - test + - deploy + +build_a: + stage: build + script: + - echo "This job will run first." + +build_b: + stage: build + script: + - echo "This job will run first, in parallel with build_a." + +test_ab: + stage: test + script: + - echo "This job will run after build_a and build_b have finished." + +deploy_ab: + stage: deploy + script: + - echo "This job will run after test_ab is complete" +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + build_a: + runs-on: ubuntu-latest + steps: + - run: echo "This job will be run first." + + build_b: + runs-on: ubuntu-latest + steps: + - run: echo "This job will be run first, in parallel with build_a" + + test_ab: + runs-on: ubuntu-latest + needs: [build_a,build_b] + steps: + - run: echo "This job will run after build_a and build_b have finished" + + deploy_ab: + runs-on: ubuntu-latest + needs: [test_ab] + steps: + - run: echo "This job will run after test_ab is complete" +``` +{% endraw %} +
+ +Weitere Informationen findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)“. + +### Scheduling workflows + +Both GitLab CI/CD and {% data variables.product.prodname_actions %} allow you to run workflows at a specific interval. In GitLab CI/CD, pipeline schedules are configured with the UI, while in {% data variables.product.prodname_actions %} you can trigger a workflow on a scheduled interval with the "on" key. + +For more information, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows#scheduled-events)." + +### Variables and secrets + +GitLab CI/CD and {% data variables.product.prodname_actions %} support setting environment variables in the pipeline or workflow configuration file, and creating secrets using the GitLab or {% data variables.product.product_name %} UI. + +For more information, see "[Environment variables](/actions/reference/environment-variables)" and "[Encrypted secrets](/actions/reference/encrypted-secrets)." + +### Im Cache zwischenspeichern + +GitLab CI/CD and {% data variables.product.prodname_actions %} provide a method in the configuration file to manually cache workflow files. + +Nachfolgend ein Beispiel für die Syntax in jedem System: + + + + + + + + + + +
+GitLab CI/CD + +{% data variables.product.prodname_actions %} +
+{% raw %} +```yaml +image: node:latest + +cache: + key: $CI_COMMIT_REF_SLUG + paths: + - .npm/ + +before_script: + - npm ci --cache .npm --prefer-offline + +test_async: + script: + - node ./specs/start.js ./specs/async.spec.js +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + test_async: + - name: Cache node modules + uses: actions/cache@v2 + with: + path: ~/.npm + key: v1-npm-deps-${{ hashFiles('**/package-lock.json') }} + restore-keys: v1-npm-deps- +``` +{% endraw %} +
+ +For more information, see "[Caching dependencies to speed up workflows](/actions/guides/caching-dependencies-to-speed-up-workflows)." + +### Artifacts + +Both GitLab CI/CD and {% data variables.product.prodname_actions %} can upload files and directories created by a job as artifacts. In {% data variables.product.prodname_actions %}, artifacts can be used to persist data across multiple jobs. + +Nachfolgend ein Beispiel für die Syntax in jedem System: + + + + + + + + + + +
+GitLab CI/CD + +{% data variables.product.prodname_actions %} +
+{% raw %} +```yaml +script: +artifacts: + paths: + - math-homework.txt +``` +{% endraw %} + +{% raw %} +```yaml +- name: Upload math result for job 1 + uses: actions/upload-artifact@v2 + with: + name: homework + path: math-homework.txt +``` +{% endraw %} +
+ +For more information, see "[Storing workflow data as artifacts](/actions/guides/storing-workflow-data-as-artifacts)." + +### Databases and service containers + +Mit beiden Systemen kannst Du zusätzliche Container für Datenbanken, Zwischenspeicherung im Cache oder andere Abhängigkeiten einbinden. + +In GitLab CI/CD, a container for the job is specified with the `image` key, while {% data variables.product.prodname_actions %} uses the `container` key. In both systems, additional service containers are specified with the `services` key. + +Nachfolgend ein Beispiel für die Syntax in jedem System: + + + + + + + + + + +
+GitLab CI/CD + +{% data variables.product.prodname_actions %} +
+{% raw %} +```yaml +container-job: + variables: + POSTGRES_PASSWORD: postgres + # The hostname used to communicate with the + # PostgreSQL service container + POSTGRES_HOST: postgres + # The default PostgreSQL port + POSTGRES_PORT: 5432 + image: node:10.18-jessie + services: + - postgres + script: + # Performs a clean installation of all dependencies + # in the `package.json` file + - npm ci + # Runs a script that creates a PostgreSQL client, + # populates the client with data, and retrieves data + - node client.js + tags: + - docker +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + container-job: + runs-on: ubuntu-latest + container: node:10.18-jessie + + services: + postgres: + image: postgres + env: + POSTGRES_PASSWORD: postgres + + steps: + - name: Check out repository code + uses: actions/checkout@v2 + + # Performs a clean installation of all dependencies + # in the `package.json` file + - name: Install dependencies + run: npm ci + + - name: Connect to PostgreSQL + # Runs a script that creates a PostgreSQL client, + # populates the client with data, and retrieves data + run: node client.js + env: + # The hostname used to communicate with the + # PostgreSQL service container + POSTGRES_HOST: postgres + # The default PostgreSQL port + POSTGRES_PORT: 5432 +``` +{% endraw %} +
+ +For more information, see "[About service containers](/actions/guides/about-service-containers)." diff --git a/translations/de-DE/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md b/translations/de-DE/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md new file mode 100644 index 000000000000..aede01bab1b3 --- /dev/null +++ b/translations/de-DE/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md @@ -0,0 +1,293 @@ +--- +title: Von Jenkins zu GitHub-Aktionen migrieren +intro: '{% data variables.product.prodname_actions %} und Jenkins haben mehrere Ähnlichkeiten, was die Migration zu {% data variables.product.prodname_actions %} relativ einfach macht.' +redirect_from: + - /actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Einführung + +Jenkins und {% data variables.product.prodname_actions %} ermöglichen es Dir, Workflows zu erstellen, die automatisch Code bauen, testen, publizieren, freigeben und bereitstellen. Jenkins und {% data variables.product.prodname_actions %} haben einige Ähnlichkeiten in der Workflow-Konfiguration: + +- Jenkins erstellt Workflows mit _Deklarativen Pipelines_, die den Workflow-Dateien in {% data variables.product.prodname_actions %} ähnlich sind. +- Jenkins verwendet _„Stages“ (Phasen)_, um eine Gruppe von Schritten auszuführen, während {% data variables.product.prodname_actions %} Jobs verwenden, um einen oder mehrere Schritte oder einzelne Befehle zu gruppieren. +- Jenkins und {% data variables.product.prodname_actions %} unterstützen Container-basierte Builds. Weitere Informationen finden Sie unter „[Eine Docker-Container-Aktion erstellen](/articles/creating-a-docker-container-action)“. +- Schritte oder Aufgaben können wiederverwendet und in der Community gemeinsam genutzt werden. + +Weitere Informationen findest Du unter „[Kernkonzepte für {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)“. + +### Wesentliche Unterschiede + +- Jenkins hat zwei Arten von Syntax zur Erzeugung von Pipelines: Deklarative Pipeline und „Scripted“ (Skript-basierte) Pipeline. {% data variables.product.prodname_actions %} verwendet YAML, um Workflows und Konfigurationsdateien zu erstellen. Weitere Informationen findest Du unter „[Workflow-Syntax für GitHub-Aktionen](/actions/reference/workflow-syntax-for-github-actions)." +- Die Deployments von Jenkins ist üblicherweise selbst-gehosted, wobei die Benutzer die Server in ihren eigenen Rechenzentren betreuen. {% data variables.product.prodname_actions %} bieten einen hybriden Cloud-Ansatz, indem sie ihre eigenen Runner betreiben, die du zum Ausführen von Jobs verwenden kannst, während sie auch selbst-gehostete Läufer unterstützen. Weitere Informationen findest Du unter [Informationen zu selbst-gehosteten Runnnern](/actions/hosting-your-own-runners/about-self-hosted-runners). + +### Funktionaltäten im Vergleich + +#### Deine Builds verteilen + +Mit Jenkins kannst Du Builds an einen einzelnen Build-Agenten senden oder sie über mehrere Agenten verteilen. Du kannst diese Agenten auch nach verschiedenen Attributen klassifizieren, wie zum Beispiel Arten von Betriebssystemen. + +Similarly, {% data variables.product.prodname_actions %} can send jobs to {% data variables.product.prodname_dotcom %}-hosted or self-hosted runners, and you can use labels to classify runners according to various attributes. Die folgende Tabelle vergleicht, wie das Konzept für verteilte Builds sowohl bei Jenkins als auch bei {% data variables.product.prodname_actions %} umgesetzt ist. + +| Jenkins | {% data variables.product.prodname_actions %} +| ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`Agenten`](https://wiki.jenkins.io/display/JENKINS/Distributed+builds) | [`Runner`](/actions/learn-github-actions/introduction-to-github-actions#runners)
[`selbst-gehostete Runner`](/actions/hosting-your-own-runners/about-self-hosted-runners) | + +#### Sektionen verwenden, um Pipelines zu organisieren + +Jenkins teilt seine Deklarative Pipelines in mehrere Sektionen auf. Similarly, {% data variables.product.prodname_actions %} organizes its workflows into separate sections. Die folgende Tabelle vergleicht Sektionen bei Jenkins mit dem Workflow bei {% data variables.product.prodname_actions %}. + +| Anweisungen in Jenkins | {% data variables.product.prodname_actions %} +| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| [`agent`](https://jenkins.io/doc/book/pipeline/syntax/#agent) | [`jobs..runs-on`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idruns-on)
[`jobs..container`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idcontainer) | +| [`Beitrag`](https://jenkins.io/doc/book/pipeline/syntax/#post) | | +| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#stages) | [`jobs`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobs) | +| [`steps`](https://jenkins.io/doc/book/pipeline/syntax/#steps) | [`jobs..steps`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idsteps) | + + +### Anweisungen verwenden + +Jenkins verwendet Anweisungen um _Deklarative Pipelines_ zu verwalten. Diese Anweisungen definieren die Merkmale Deines Workflows und die Art und weise, wie dieser ausgeführt wird. Die folgende Tabelle zeigt, wie diese Anweisungen den Konzepten innerhalb von {% data variables.product.prodname_actions %} entsprechen. + +| Anweisungen in Jenkins | {% data variables.product.prodname_actions %} +| ------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`environment`](https://jenkins.io/doc/book/pipeline/syntax/#environment) | [`jobs..env`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env)
[`jobs..steps.env`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv) | +| [`options`](https://jenkins.io/doc/book/pipeline/syntax/#parameters) | [`jobs..strategy`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategy)
[`jobs..strategy.fail-fast`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategyfail-fast)
[`jobs..timeout-minutes`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idtimeout-minutes) | +| [`parameters`](https://jenkins.io/doc/book/pipeline/syntax/#parameters) | [`inputs`](/actions/creating-actions/metadata-syntax-for-github-actions#inputs)
[`outputs`](/actions/creating-actions/metadata-syntax-for-github-actions#outputs) | +| [`triggers`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`on`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#on)
[`on..types`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onevent_nametypes)
[on..](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)
[on..paths](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpushpull_requestpaths) | +| [`triggers { upstreamprojects() }`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`jobs..needs`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idneeds) | +| [Cron-Syntax in Jenkins](https://jenkins.io/doc/book/pipeline/syntax/#cron-syntax) | [`on.schedule`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onschedule) | +| [`Phase`](https://jenkins.io/doc/book/pipeline/syntax/#stage) | [`jobs.`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_id)
[`jobs..name`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idname) | +| [`tools`](https://jenkins.io/doc/book/pipeline/syntax/#tools) | [Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software) | +| [`input`](https://jenkins.io/doc/book/pipeline/syntax/#input) | [`inputs`](/actions/automating-your-workflow-with-github-actions/metadata-syntax-for-github-actions#inputs) | +| [`when`](https://jenkins.io/doc/book/pipeline/syntax/#when) | [`jobs..if`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idif) | + + +### Sequenzielle „Stages“ (Phasen) verwenden + +#### Parallele Verarbeitungvon Jobs + +Jenkins kann die `Phasen` und `Schritte` parallel ausführen, wohingegen {% data variables.product.prodname_actions %} derzeit nur Jobs parallel ausführen. + +| Jenkins Parallel | {% data variables.product.prodname_actions %} +| ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`parallel`](https://jenkins.io/doc/book/pipeline/syntax/#parallel) | [`jobs..strategy.max-parallel`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymax-parallel) | + +#### Build-Matrix + +Sowohl {% data variables.product.prodname_actions %} als auch Jenkins lassen Dich eine Build-Matrix verwenden, um verschiedene Systemkombinationen zu definieren. + +| Jenkins | {% data variables.product.prodname_actions %} +| ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`axis`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-axes) | [`strategy/matrix`](/actions/learn-github-actions/managing-complex-workflows/#using-a-build-matrix)
[`context`](/actions/reference/context-and-expression-syntax-for-github-actions) | +| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages) | [`steps-context`](/actions/reference/context-and-expression-syntax-for-github-actions#steps-context) | +| [`excludes`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages) | | + +#### Schritte verwenden, um „Tasks“ (Aufgaben) auszuführen + +Jenkins gruppiert `„Steps“ (Schritte)` zusammen in `„Stages“ (Phasen)`. Jeder dieser Schritte kann unter anderem ein Skript, eine Funktion oder ein Befehl sein. In ähnlicher Weise verwenden {% data variables.product.prodname_actions %} `Jobs`, um bestimmte Gruppen von `Schritten` auszuführen. + +| Jenkins-Schritte | {% data variables.product.prodname_actions %} +| --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | +| [`script`](https://jenkins.io/doc/book/pipeline/syntax/#script) | [`jobs..steps`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idsteps) | + +### Beispiele für häufige Aufgaben + +#### Zeitplanung einer Pipeline mit `cron` + + + + + + + + + + +
+Jenkins-Pipeline + +{% data variables.product.prodname_actions %}-Workflow +
+ + ```yaml + pipeline { + agent any + triggers { + cron('H/15 * * * 1-5') + } + } + ``` + + + + ```yaml + on: + schedule: + - cron: '*/15 * * * 1-5' + ``` + +
+ +#### Umgebungsvariablen in einer Pipeline konfigurieren + + + + + + + + + + +
+Jenkins-Pipeline + +{% data variables.product.prodname_actions %}-Workflow +
+ + ```yaml + pipeline { + agent any + environment { + MAVEN_PATH = '/usr/local/maven' + } + } + ``` + + + + ```yaml + jobs: + maven-build: + env: + MAVEN_PATH: '/usr/local/maven' + + ``` + +
+ +#### Aus „Upstream“ (vorgelagerten) Projekten bauen + + + + + + + + + + +
+Jenkins-Pipeline + +{% data variables.product.prodname_actions %}-Workflow +
+ + ```yaml + pipeline { + triggers { + upstream( + upstreamProjects: 'job1,job2', + threshold: hudson.model.Result.SUCCESS) + } + } + } + + ``` + + + + ```yaml + jobs: + job1: + job2: + needs: job1 + job3: + needs: [job1, job2] + + ``` + +
+ +#### Mit mehreren Betriebssystemen bauen + + + + + + + + + + +
+Jenkins-Pipeline + +{% data variables.product.prodname_actions %}-Workflow +
+ + ```yaml +pipeline { + agent none + stages { + stage('Run Tests') { + parallel { + stage('Test On MacOS') { + agent { label "macos" } + tools { nodejs "node-12" } + steps { + dir("scripts/myapp") { + sh(script: "npm install -g bats") + sh(script: "bats tests") + } + } + } + stage('Test On Linux') { + agent { label "linux" } + tools { nodejs "node-12" } + steps { + dir("script/myapp") { + sh(script: "npm install -g bats") + sh(script: "bats tests") + } + } + } + } + } + } +} + ``` + + + +{% raw %} + ```yaml + name: demo-workflow + on: + push: + jobs: + test: + runs-on: ${{ matrix.os }} + strategy: + fail-fast: false + matrix: + os: [macos-latest, ubuntu-latest] + steps: + - uses: actions/checkout@v1 + - uses: actions/setup-node@v1 + with: + node-version: 12 + - run: npm install -g bats + - run: bats tests + working-directory: scripts/myapp + ``` +{% endraw %} + +
diff --git a/translations/de-DE/content/actions/learn-github-actions/security-hardening-for-github-actions.md b/translations/de-DE/content/actions/learn-github-actions/security-hardening-for-github-actions.md new file mode 100644 index 000000000000..c63522aa45b1 --- /dev/null +++ b/translations/de-DE/content/actions/learn-github-actions/security-hardening-for-github-actions.md @@ -0,0 +1,97 @@ +--- +title: Security hardening for GitHub Actions +shortTitle: Security hardening +intro: 'Good security practices for using {% data variables.product.prodname_actions %} features.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /actions/getting-started-with-github-actions/security-hardening-for-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Übersicht + +This guide explains how to configure security hardening for certain {% data variables.product.prodname_actions %} features. If the {% data variables.product.prodname_actions %} concepts are unfamiliar, see "[Core concepts for GitHub Actions](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)." + +### Using secrets + +Sensitive values should never be stored as plaintext in workflow files, but rather as secrets. [Secrets](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets) can be configured at the organization or repository level, and allow you to store sensitive information in {% data variables.product.product_name %}. + +Secrets use [Libsodium sealed boxes](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes), so that they are encrypted before reaching {% data variables.product.product_name %}. This occurs when the secret is submitted [using the UI](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets#creating-encrypted-secrets-for-a-repository) or through the [REST API](/rest/reference/actions#secrets). This client-side encryption helps the minimize risks related to accidental logging (for example, exception logs and request logs, among others) within {% data variables.product.product_name %}'s infrastructure. Once the secret is uploaded, {% data variables.product.product_name %} is then able to decrypt it so that it can be injected into the workflow runtime. + +To help prevent accidental disclosure, {% data variables.product.product_name %} uses a mechanism that attempts to redact any secrets that appear in run logs. This redaction looks for exact matches of any configured secrets, as well as common encodings of the values, such as Base64. However, because there are multiple ways a secret value can be transformed, this redaction is not guaranteed. As a result, there are certain proactive steps and good practices you should follow to help ensure secrets are redacted, and to limit other risks associated with secrets: + +- **Never use structured data as a secret** + - Unstructured data can cause secret redaction within logs to fail, because redaction largely relies on finding an exact match for the specific secret value. For example, do not use a blob of JSON, XML, or YAML (or similar) to encapsulate a secret value, as this significantly reduces the probability the secrets will be properly redacted. Instead, create individual secrets for each sensitive value. +- **Register all secrets used within workflows** + - If a secret is used to generate another sensitive value within a workflow, that generated value should be formally [registered as a secret](https://github.com/actions/toolkit/tree/main/packages/core#setting-a-secret), so that it will be redacted if it ever appears in the logs. For example, if using a private key to generate a signed JWT to access a web API, be sure to register that JWT as a secret or else it won’t be redacted if it ever enters the log output. + - Registering secrets applies to any sort of transformation/encoding as well. If your secret is transformed in some way (such as Base64 or URL-encoded), be sure to register the new value as a secret too. +- **Audit how secrets are handled** + - Audit how secrets are used, to help ensure they’re being handled as expected. You can do this by reviewing the source code of the repository executing the workflow, and checking any actions used in the workflow. For example, check that they’re not sent to unintended hosts, or explicitly being printed to log output. + - View the run logs for your workflow after testing valid/invalid inputs, and check that secrets are properly redacted, or not shown. It's not always obvious how a command or tool you’re invoking will send errors to `STDOUT` and `STDERR`, and secrets might subsequently end up in error logs. As a result, it is good practice to manually review the workflow logs after testing valid and invalid inputs. +- **Use credentials that are minimally scoped** + - Make sure the credentials being used within workflows have the least privileges required, and be mindful that any user with write access to your repository has read access to all secrets configured in your repository. +- **Audit and rotate registered secrets** + - Periodically review the registered secrets to confirm they are still required. Remove those that are no longer needed. + - Rotate secrets periodically to reduce the window of time during which a compromised secret is valid. + +### Using third-party actions + +The individual jobs in a workflow can interact with (and compromise) other jobs. For example, a job querying the environment variables used by a later job, writing files to a shared directory that a later job processes, or even more directly by interacting with the Docker socket and inspecting other running containers and executing commands in them. + +This means that a compromise of a single action within a workflow can be very significant, as that compromised action would have access to all secrets configured on your repository, and can use the `GITHUB_TOKEN` to write to the repository. Consequently, there is significant risk in sourcing actions from third-party repositories on {% data variables.product.prodname_dotcom %}. You can help mitigate this risk by following these good practices: + +* **Pin actions to a full length commit SHA** + + Pinning an action to a full length commit SHA is currently the only way to use an action as an immutable release. Pinning to a particular SHA helps mitigate the risk of a bad actor adding a backdoor to the action's repository, as they would need to generate a SHA-1 collision for a valid Git object payload. + + {% warning %} + + **Warning:** The short version of the commit SHA is insecure and should never be used for specifying an action's Git reference. Because of how repository networks work, any user can fork the repository and push a crafted commit to it that collides with the short SHA. This causes subsequent clones at that SHA to fail because it becomes an ambiguous commit. As a result, any workflows that use the shortened SHA will immediately fail. + + {% endwarning %} +* **Audit the source code of the action** + + Ensure that the action is handling the content of your repository and secrets as expected. For example, check that secrets are not sent to unintended hosts, or are not inadvertently logged. + +* **Pin actions to a tag only if you trust the creator** + + Although pinning to a commit SHA is the most secure option, specifying a tag is more convenient and is widely used. If you’d like to specify a tag, then be sure that you trust the action's creators. The ‘Verified creator’ badge on {% data variables.product.prodname_marketplace %} is a useful signal, as it indicates that the action was written by a team whose identity has been verified by {% data variables.product.prodname_dotcom %}. Note that there is risk to this approach even if you trust the author, because a tag can be moved or deleted if a bad actor gains access to the repository storing the action. + +### Considering cross-repository access + +{% data variables.product.product_name %} is intentionally scoped for a single repository at a time. The `GITHUB_TOKEN` used in the workflow environment grants the same level of access as a write-access user, because any write-access user can access this token by creating or modifying workflow files. Users have specific permissions for each repository, so having the `GITHUB_TOKEN` for one repository grant access to another would impact the {% data variables.product.prodname_dotcom %} permission model if not implemented carefully. Similarly, caution must be taken when adding {% data variables.product.prodname_dotcom %} authentication tokens to the workflow environment, because this can also affect the {% data variables.product.prodname_dotcom %} permission model by inadvertently granting broad access to collaborators. + +We have [a plan on the {% data variables.product.prodname_dotcom %} roadmap](https://github.com/github/roadmap/issues/74) to support a flow that allows cross-repository access within {% data variables.product.product_name %}, but this is not yet a supported feature. Currently, the only way to perform privileged cross-repository interactions is to place a {% data variables.product.prodname_dotcom %} authentication token or SSH key as a secret within the workflow environment. Because many authentication token types do not allow for granular access to specific resources, there is significant risk in using the wrong token type, as it can grant much broader access than intended. + +This list describes the recommended approaches for accessing repository data within a workflow, in descending order of preference: + +1. **The `GITHUB_TOKEN` in the workflow environment** + - This token is intentionally scoped to the single repository that invoked the workflow, and has the same level of access as a write-access user on the repository. The token is created before each job begins and expires when the job is finished. Weitere Informationen findest Du unter „[Authentifizierung mit dem GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." + - The `GITHUB_TOKEN` should be used whenever possible. +2. **Repository deploy key** + - Deploy keys are one of the only credential types that grant read or write access to a single repository, and can be used to interact with another repository within a workflow. For more information, see "[Managing deploy keys](/developers/overview/managing-deploy-keys#deploy-keys)." + - Note that deploy keys can only clone and push to the repository using Git, and cannot be used to interact with the REST or GraphQL API, so they may not be appropriate for your requirements. +3. **{% data variables.product.prodname_github_app %} tokens** + - {% data variables.product.prodname_github_apps %} can be installed on select repositories, and even have granular permissions on the resources within them. You could create a {% data variables.product.prodname_github_app %} internal to your organization, install it on the repositories you need access to within your workflow, and authenticate as the installation within your workflow to access those repositories. +4. **Persönliche Zugriffsstokens** + - You should never use personal access tokens from your own account. These tokens grant access to all repositories within the organizations that you have access to, as well as all personal repositories in your user account. This indirectly grants broad access to all write-access users of the repository the workflow is in. In addition, if you later leave an organization, workflows using this token will immediately break, and debugging this issue can be challenging. + - If a personal access token is used, it should be one that was generated for a new account that is only granted access to the specific repositories that are needed for the workflow. Note that this approach is not scalable and should be avoided in favor of alternatives, such as deploy keys. +5. **SSH keys on a user account** + - Workflows should never use the SSH keys on a user account. Similar to personal access tokens, they grant read/write permissions to all of your personal repositories as well as all the repositories you have access to through organization membership. This indirectly grants broad access to all write-access users of the repository the workflow is in. If you're intending to use an SSH key because you only need to perform repository clones or pushes, and do not need to interact with public APIs, then you should use individual deploy keys instead. + +### Hardening for self-hosted runners + +**{% data variables.product.prodname_dotcom %}-hosted** runners execute code within ephemeral and clean isolated virtual machines, meaning there is no way to persistently compromise this environment, or otherwise gain access to more information than was placed in this environment during the bootstrap process. + +**Self-hosted** runners on {% data variables.product.product_name %} do not have guarantees around running in ephemeral clean virtual machines, and can be persistently compromised by untrusted code in a workflow. + +As a result, self-hosted runners should almost [never be used for public repositories](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories) on {% data variables.product.product_name %}, because any user can open pull requests against the repository and compromise the environment. Similarly, be cautious when using self-hosted runners on private repositories, as anyone who can fork the repository and open a PR (generally those with read-access to the repository) are able to compromise the self-hosted runner environment, including gaining access to secrets and the more privileged `GITHUB_TOKEN` which grants write-access permissions on the repository. + +You should also consider the environment of the self-hosted runner machines: +- What sensitive information resides on the machine configured as a self-hosted runner? For example, private SSH keys, API access tokens, among others. +- Does the machine have network access to sensitive services? For example, Azure or AWS metadata services. The amount of sensitive information in this environment should be kept to a minimum, and you should always be mindful that any user capable of invoking workflows has access to this environment. diff --git a/translations/de-DE/content/actions/learn-github-actions/sharing-workflows-with-your-organization.md b/translations/de-DE/content/actions/learn-github-actions/sharing-workflows-with-your-organization.md new file mode 100644 index 000000000000..5bf46b535400 --- /dev/null +++ b/translations/de-DE/content/actions/learn-github-actions/sharing-workflows-with-your-organization.md @@ -0,0 +1,114 @@ +--- +title: Sharing workflows with your organization +shortTitle: Sharing workflows with your organization +intro: 'Learn how you can use organization features to collaborate with your team, by sharing workflow templates, secrets, and self-hosted runners.' +redirect_from: + - /actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Übersicht + +If you need to share workflows and other {% data variables.product.prodname_actions %} features with your team, then consider collaborating within a {% data variables.product.prodname_dotcom %} organization. An organization allows you to centrally store and and manage secrets, artifacts, and self-hosted runners. You can also create workflow templates in the `.github` repository and share them with other users in your organization. + +### Erstellen einer Workflowvorlage + +Workflowvorlagen können von Benutzern mit Schreibzugriff auf die `.github` Repository der Organisation erstellt werden. Die Vorlagen können dann von Organisationsmitgliedern verwendet werden, die über die Berechtigung zum Erstellen von Workflows verfügen. Workflowvorlagen können verwendet werden, um neue Workflows in öffentlichen Repositorys einer Organisation zu erstellen. Um Vorlagen zum Erstellen von Workflows in privaten Repositorys zu verwenden, muss die Organisation Teil eines Unternehmens- oder GitHub One-Plans sein. + +In diesem Verfahren wird veranschaulicht, wie eine Workflowvorlage und eine Metadatendatei erstellt werden. Die Metadatendatei beschreibt, wie die Vorlage benutzern beim Erstellen eines neuen Workflows angezeigt wird. + +1. Wenn es noch nicht vorhanden ist, erstellen Sie ein neues öffentliches Repository mit dem Namen `.github` in Ihrer Organisation. +1. Erstellen Sie ein Verzeichnis mit dem Namen `Workflowvorlagen`. +1. Erstellen Sie Ihre neue Workflowdatei im `Workflow-Vorlagen` Verzeichnis. + + Wenn Sie auf den Standardzweig eines Repositorys verweisen müssen, können Sie den `$default-branch` Platzhalter verwenden. Wenn ein Workflow mit Ihrer Vorlage erstellt wird, wird der Platzhalter automatisch durch den Namen der Standardverzweigung des Repositorys ersetzt. + + Diese Datei mit dem Namen `octo-organization-ci.yml` veranschaulicht beispielsweise einen grundlegenden Workflow. + + ```yaml + Name: Octo Organization CI + + on: + push: + branch: [ $default-branch ] + pull_request: + branches: [ $default-branch ] + + jobs: + build: + runs-on: ubuntu-latest + + steps: + - uses: actions/checkout@v2 + + - name: Run a one-line script + run: echo Hello from Octo Organization + ``` +1. Erstellen Sie eine Metadatendatei im `Workflow-Vorlagen` Verzeichnis. Die Metadatendatei muss denselben Namen wie die Workflowdatei haben, aber anstelle der Erweiterung `.yml` muss sie mit `.properties.json`angehängt werden. Diese Datei mit dem Namen `octo-organization-ci.properties.json enthält` beispielsweise die Metadaten für eine Workflowdatei mit dem Namen `octo-organization-ci.yml`: + ```yaml + • + "Name": "Octo Organization Workflow", + "beschreibung": "Octo Organization CI workflow template.", + "iconName": "example-icon", + "categories": [ + "Go" + ], + "filePatterns": [ + "package.json + + + + " + ``` + * `Name` - **erforderlich.** Der Name der Workflowvorlage. Dies wird in der Liste der verfügbaren Vorlagen angezeigt. + * `Beschreibung` - **erforderlich.** Die Beschreibung der Workflowvorlage. Dies wird in der Liste der verfügbaren Vorlagen angezeigt. + * `iconName` - **Erforderlich.** Definiert ein Symbol für den Eintrag des Workflows in der Vorlagenliste. Der `iconName` muss ein SVG-Symbol mit demselben Namen sein und in den `Workflow-Vorlagen` Verzeichnis gespeichert werden. Beispielsweise wird eine SVG-Datei mit dem Namen `example-icon.svg` als `Beispielsymbol`referenziert. + * `Kategorien` - **Optional.** Definiert die Sprachkategorie des Workflows. Wenn ein Benutzer die verfügbaren Vorlagen anzeigt, werden die Vorlagen, die derselben Sprache entsprechen, stärker in den Vordergrund gerückt. Informationen zu den verfügbaren Sprachkategorien finden Sie unter https://github.com/github/linguist/blob/master/lib/linguist/languages.yml. + * `filePatterns` - **Optional.** Ermöglicht die Verwendung der Vorlage, wenn das Repository des Benutzers eine Datei im Stammverzeichnis enthält, die einem definierten regulären Ausdruck entspricht. + +Um eine weitere Workflowvorlage hinzuzufügen, fügen Sie Ihre Dateien `Workflow-Vorlagen` -Verzeichnis hinzu. Ein Beispiel: + +![Workflow-Vorlagendateien](/assets/images/help/images/workflow-template-files.png) + +### Verwenden einer Workflowvorlage + +In diesem Verfahren wird veranschaulicht, wie ein Mitglied Ihrer Organisation eine Workflowvorlage finden und verwenden kann, um einen neuen Workflow zu erstellen. Die Workflowvorlagen einer Organisation können von jedem Benutzer verwendet werden, der Mitglied der Organisation ist. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. Wenn Ihr Repository bereits über vorhandene Workflows verfügt: Klicken Sie in der linken oberen Ecke auf **Neuer Workflow**. ![Erstelle einen neuen Workflow](/assets/images/help/repository/actions-new-workflow.png) +1. Die Workflowvorlagen Ihrer Organisation befinden sich in ihrem eigenen Abschnitt mit dem Titel "Workflows, die von _Organisationsnamen_erstellt wurden". Klicke unter dem Namen der zu verwendenden Vorlage auf **Set up this workflow** (Workflow einrichten). ![Einrichten dieses Workflows](/assets/images/help/settings/actions-create-starter-workflow.png) + + +### Sharing secrets within an organization + +You can centrally manage your secrets within an organization, and then make them available to selected repositories. This also means that you can update a secret in one location, and have the change apply to all repository workflows that use the secret. + +Beim Erstellen eines geheimen Schlüssels in einer Organisation können Sie eine Richtlinie verwenden, um einzuschränken, welche Repositorys auf diesen geheimen Schlüssel zugreifen können. Sie können z. B. Zugriff auf alle Repositorys gewähren oder den Zugriff auf nur private Repositorys oder eine angegebene Liste von Repositorys beschränken. + +{% data reusables.github-actions.permissions-statement-secrets-organization %} + +{% data reusables.organizations.navigate-to-org %} +{% data reusables.organizations.org_settings %} +{% data reusables.github-actions.sidebar-secret %} +1. Klicken Sie auf **Neue geheime**. +1. Geben Sie einen Namen für Ihr Geheimnis in das Eingabefeld **Name** ein. +1. Geben Sie den **Value** für Ihr Geheimnis ein. +1. Wählen Sie im **Repository-Zugriff** Dropdownliste eine Zugriffsrichtlinie aus. +1. Klicken Sie auf **Add secret** (Geheimnis hinzufügen). + +### Share self-hosted runners within an organization + +Organization admins can add their self-hosted runners to groups, and then create policies that control which repositories can access the group. + +For more information, see "[Managing access to self-hosted runners using groups](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups)." + + +### Nächste Schritte: + +To continue learning about {% data variables.product.prodname_actions %}, see "[Security hardening for {% data variables.product.prodname_actions %}](/actions/learn-github-actions/security-hardening-for-github-actions)." diff --git a/translations/de-DE/content/actions/managing-workflow-runs/adding-a-workflow-status-badge.md b/translations/de-DE/content/actions/managing-workflow-runs/adding-a-workflow-status-badge.md new file mode 100644 index 000000000000..a708a029aa44 --- /dev/null +++ b/translations/de-DE/content/actions/managing-workflow-runs/adding-a-workflow-status-badge.md @@ -0,0 +1,63 @@ +--- +title: Adding a workflow status badge +intro: You can display a status badge in your repository to indicate the status of your workflows. +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% data reusables.repositories.actions-workflow-status-badge-into %} + +Wenn Ihr Workflow den `Namen` Schlüsselwort verwendet, müssen Sie auf den Workflow anhand des Namens verweisen. Wenn der Name Ihres Workflows Leerraum enthält, müssen Sie das Leerzeichen durch die URL codierte Zeichenfolge `%20`ersetzen. Weitere Informationen zum Schlüsselwort `name` findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#name)“. + +``` +https://github.com///Workflows//badge.svg +``` + +Wenn Ihr Workflow keinen `Namen`hat, müssen Sie auch auf die Workflowdatei verweisen, indem Sie den Dateipfad relativ zum Stammverzeichnis des Repositorys verwenden. + +{% note %} + +**Hinweis:** Verweisen auf die Workflowdatei mithilfe des Dateipfads funktioniert nicht, wenn der Workflow einen `Namen`hat. + +{% endnote %} + +``` +https://github.com///Workflows//badge.svg +``` + +### Using a workflow name + +In diesem Markdown-Beispiel wird ein Status-Badge für einen Workflow mit dem Namen "Greet Everyone" hinzugefügt. Die `owner` des Repositorys sind die `Aktionen` Organisation, und der name `REPOSITORY` ist `hello-world`. + +``` +! [Beispiel-Workflowname] (https://github.com/actions/hello-world/workflows/Greet%20Everyone/badge.svg) +``` + +### Using a workflow file path + +In diesem Markdown-Beispiel wird ein Status-Badge für einen Workflow mit dem Dateipfad `.github/workflows/main.yml`hinzugefügt. Die `owner` des Repositorys sind die `Aktionen` Organisation, und der name `REPOSITORY` ist `hello-world`. + +``` +! [Beispiel Workflowdateipfad] (https://github.com/actions/hello-world/workflows/.github/workflows/main.yml/badge.svg) +``` + +### Using the `branch` parameter + +In diesem Markdown-Beispiel wird ein Status-Badge für eine Verzweigung mit dem Namen `Feature-1-`hinzugefügt. + +``` +! [Beispiel-Zweigparameter] (https://github.com/actions/hello-world/workflows/Greet%20Everyone/badge.svg?branch=feature-1) +``` + +### Using the `event` parameter + +In diesem Markdown-Beispiel wird ein Badge hinzugefügt, das den Status von Workflowausführungen anzeigt, die durch das `pull_request` -Ereignis ausgelöst werden. + +``` +! [Beispielereignisparameter] (https://github.com/actions/hello-world/workflows/Greet%20Everyone/badge.svg?event=pull_request) +``` diff --git a/translations/de-DE/content/actions/managing-workflow-runs/canceling-a-workflow.md b/translations/de-DE/content/actions/managing-workflow-runs/canceling-a-workflow.md new file mode 100644 index 000000000000..f7c90bf8eb56 --- /dev/null +++ b/translations/de-DE/content/actions/managing-workflow-runs/canceling-a-workflow.md @@ -0,0 +1,31 @@ +--- +title: Canceling a workflow +intro: 'You can cancel a workflow run that is in progress. When you cancel a workflow run, {% data variables.product.prodname_dotcom %} cancels all jobs and steps that are a part of that workflow.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% data reusables.repositories.permissions-statement-write %} + +### Einen Workflow-Lauf abbrechen + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. In the upper-right corner of the workflow, click **Cancel workflow**. ![Schaltfläche zum Abbrechen der Prüfsuite](/assets/images/help/repository/cancel-check-suite.png) + +### Steps {% data variables.product.prodname_dotcom %} takes to cancel a workflow run + +Beim Abbrechen der Workflowausführung führen Sie möglicherweise andere Software aus, die Ressourcen verwendet, die mit der Workflowausführung zusammenhängen. To help you free up resources related to the workflow run, it may help to understand the steps {% data variables.product.prodname_dotcom %} performs to cancel a workflow run. + +1. Um die Workflowausführung abzubrechen, wertet der Server `neu aus, wenn` Bedingungen für alle derzeit ausgeführten Aufträge. Wenn die Bedingung als true`wird, wird der Auftrag nicht abgebrochen. Beispielsweise die Bedingung, ob: always()` als true ausgewertet wird und der Auftrag weiterhin ausgeführt wird. Wenn keine Bedingung vorhanden ist, entspricht dies der Bedingung `wenn: success()`, die nur ausgeführt wird, wenn der vorherige Schritt erfolgreich abgeschlossen wurde. +2. Bei Aufträgen, die abgebrochen werden müssen, sendet der Server eine Abbruchnachricht an alle Läufercomputer mit Aufträgen, die abgebrochen werden müssen. +3. Bei Aufträgen, die weiterhin ausgeführt werden, wertet der Server `neu aus, ob` Bedingungen für die unvollendeten Schritte. Wenn die Bedingung als true`wird, wird der Schritt weiterhin ausgeführt. +
  • Für Schritte, die abgebrochen werden müssen, sendet die Läufermaschine SIGINT/Ctrl-C-` an den Schritteingabeprozess (`Knoten` für Javascript-Aktion, `docker` für Containeraktion und `bash/cmd/pwd` , wenn sie in einem Schritt verwenden `ausführen). Wenn der Prozess nicht innerhalb von 7500 ms beendet wird, sendet der Läufer SIGTERM/Ctrl-Break-` an den Prozess, und wartet dann 2500 ms, bis der Prozess beendet wird. Wenn der Prozess noch ausgeführt wird, tötet der Läufer den Prozessbaum. +5. Nach ablaufen 5 Minuten Abbruchzeit zeitoutt der Server das Beenden aller Aufträge und Schritte, die die Ausführung nicht beenden oder den Abbruchvorgang nicht abschließen können. diff --git a/translations/de-DE/content/actions/managing-workflow-runs/deleting-a-workflow-run.md b/translations/de-DE/content/actions/managing-workflow-runs/deleting-a-workflow-run.md new file mode 100644 index 000000000000..3c16ba4969bd --- /dev/null +++ b/translations/de-DE/content/actions/managing-workflow-runs/deleting-a-workflow-run.md @@ -0,0 +1,23 @@ +--- +title: Löschen einer Workflowausführung +intro: 'You can delete a workflow run that has been completed, or is more than two weeks old.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% data reusables.repositories.permissions-statement-write %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +1. Um eine Workflowausführung zu löschen, verwenden Sie das Dropdownmenü {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} , und wählen Sie **Workflow löschen**. + + ![Löschen einer Workflowausführung](/assets/images/help/settings/workflow-delete-run.png) +2. Überprüfen Sie die Bestätigungsaufforderung, und klicken Sie auf **Ja, löschen Sie diesen Workflow, der**ausgeführt wird. + + ![Löschen einer Workflowausführungsbestätigung](/assets/images/help/settings/workflow-delete-run-confirmation.png) diff --git a/translations/de-DE/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md b/translations/de-DE/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md new file mode 100644 index 000000000000..37f4a8ab31d4 --- /dev/null +++ b/translations/de-DE/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md @@ -0,0 +1,45 @@ +--- +title: Disabling and enabling a workflow +intro: You can disable and re-enable a workflow using {% data variables.product.prodname_dotcom %} or the REST API. +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.23' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +Disabling a workflow allows you to stop a workflow from being triggered without having to delete the file from the repo. You can easily re-enable the workflow again on {% data variables.product.prodname_dotcom %}. You can also disable and enable a workflow using the REST API. For more information, see the "[Actions REST API](/rest/reference/actions#workflows)." + +Temporarily disabling a workflow can be useful in many scenarios. These are a few examples where disabling a workflow might be helpful: + +- A workflow error that produces too many or wrong requests, impacting external services negatively. +- A workflow that is not critical and is consuming too many minutes on your account. +- A workflow that sends requests to a service that is down. +- Workflows on a forked repository that aren't needed (for example, scheduled workflows). + +{% warning %} + +**Warning:** {% data reusables.actions.scheduled-workflows-disabled %} + +{% endwarning %} + +### Disabling a workflow + +You can manually disable a workflow so that it won't execute any workflow runs. A disabled workflow is not deleted, and can be re-enabled. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. In the left sidebar, click the workflow you want to disable. ![Aktionen auswählen Workflow](/assets/images/actions-select-workflow.png) +1. Click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}. ![actions kebab menu](/assets/images/help/repository/actions-workflow-menu-kebab.png) +1. Click **Disable workflow**. ![actions disable workflow](/assets/images/help/repository/actions-disable-workflow.png) The disabled workflow is marked {% octicon "stop" aria-label="The stop icon" %} to indicate its status. ![actions list disabled workflow](/assets/images/help/repository/actions-find-disabled-workflow.png) + +### Enabling a workflow + +You can re-enable a workflow that was previously disabled. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. In the left sidebar, click the workflow you want to enable. ![actions select disabled workflow](/assets/images/help/repository/actions-select-disabled-workflow.png) +1. Click **Enable workflow**. ![actions enable workflow](/assets/images/help/repository/actions-enable-workflow.png) diff --git a/translations/de-DE/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md b/translations/de-DE/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md new file mode 100644 index 000000000000..0ca6879bf75b --- /dev/null +++ b/translations/de-DE/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md @@ -0,0 +1,22 @@ +--- +title: Downloading workflow artifacts +intro: You can download archived artifacts before they automatically expire. +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} By default, {% data variables.product.product_name %} stores build logs and artifacts for 90 days, and you can customize this retention period, depending on the type of repository. For more information, see "[Configuring the retention period for GitHub Actions artifacts and logs in your repository](/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository)."{% endif %} +{% if currentVersion == "enterprise-server@2.22" %} {% data variables.product.product_name %} stores full build logs and artifacts for 90 days.{% endif %} + +{% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. Under **Artifacts**, click the artifact you want to download. ![Dropdown-Menü zum Herunterladen von Artefakten](/assets/images/help/repository/artifact-drop-down.png) diff --git a/translations/de-DE/content/actions/managing-workflow-runs/enabling-debug-logging.md b/translations/de-DE/content/actions/managing-workflow-runs/enabling-debug-logging.md new file mode 100644 index 000000000000..587f33749464 --- /dev/null +++ b/translations/de-DE/content/actions/managing-workflow-runs/enabling-debug-logging.md @@ -0,0 +1,38 @@ +--- +title: Debug-Protokollierung aktivieren +intro: 'Wenn die Workflow-Logs nicht genügend Details zur Diagnose enthalten, warum ein Workflow, ein Job oder ein Schritt nicht wie erwartet abläuft, können Sie die zusätzliche Debug-Protokollierung aktivieren.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +Diese zusätzlichen Protokolle werden aktiviert, indem Geheimnisse im Repository, die den Workflow enthalten, gesetzt werden, sodass die gleichen Berechtigungsanforderungen gelten: + +- {% data reusables.github-actions.permissions-statement-secrets-repository %} +- {% data reusables.github-actions.permissions-statement-secrets-organization %} +- {% data reusables.github-actions.permissions-statement-secrets-api %} + +Weitere Informationen zum Festlegen von Geheimnissen finden Sie unter "[Erstellen und Verwenden verschlüsselter Geheimnisse](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". + +### Diagnose-Protokollierung des Runners aktivieren + +Die Runner-Diagnoseprotokollierung stellt zusätzliche Protokolldateien bereit, die Informationen darüber enthalten, wie ein Läufer einen Auftrag ausführt. In das Protokollarchiv werden zwei weitere Protokolldateien aufgenommen: + +* das Runner-Prozessprotokoll mit Informationen zur Koordinierung und Einrichtung von Runnern für die Ausführung von Aufträgen +* das Worker-Prozessprotokoll, in dem die Ausführung eines Auftrags protokolliert wird + +1. Zum Aktivieren der Runner-Diagnoseprotokollierung legen Sie das folgende Geheimnis im Repository fest, in dem sich der Workflow befindet: `ACTIONS_RUNNER_DEBUG` auf `true`. + +1. Sollen die Runner-Diagnoseprotokolle heruntergeladen werden, laden Sie das Protokollarchiv des Workflow-Laufs herunter. Die Runner-Diagnoseprotokolle befinden sich im Ordner `runner-diagnostic-logs`. For more information on downloading logs, see "[Downloading logs](/actions/managing-workflow-runs/using-workflow-run-logs/#downloading-logs)." + +### Debug-Schrittprotokollierung aktivieren + +Bei der Debug-Schrittprotokollierung werden ausführlichere Protokolle während und nach der Ausführung eines Auftrags erstellt. + +1. Zum Aktivieren der Debug-Schrittprotokollierung legen Sie das folgende Geheimnis im Repository fest, in dem sich der Workflow befindet: `ACTIONS_STEP_DEBUG` auf `true`. + +1. Sobald Sie das Geheimnis festgelegt haben, werden weitere Debug-Ereignisse in den Schrittprotokollen aufgeführt. Weitere Informationen finden Sie unter [„Protokolle zur Fehlerdiagnose anzeigen“](/actions/managing-workflow-runs/using-workflow-run-logs/#viewing-logs-to-diagnose-failures). diff --git a/translations/de-DE/content/actions/managing-workflow-runs/index.md b/translations/de-DE/content/actions/managing-workflow-runs/index.md new file mode 100644 index 000000000000..67e6b68e26c9 --- /dev/null +++ b/translations/de-DE/content/actions/managing-workflow-runs/index.md @@ -0,0 +1,32 @@ +--- +title: Managing workflow runs +shortTitle: Managing workflow runs +intro: 'Sie können den Status und die Ergebnisse der einzelnen Schritte in Ihrem Workflow anzeigen, einen ausstehenden Workflow abbrechen, fakturierbare Auftragsausführungsminuten anzeigen, einen fehlgeschlagenen Workflow debuggen und erneut ausführen, Protokolle suchen und herunterladen und Artefakte herunterladen.' +redirect_from: + - /actions/configuring-and-managing-workflows/managing-a-workflow-run + - /articles/viewing-your-repository-s-workflows + - /articles/viewing-your-repositorys-workflows + - /articles/managing-a-workflow-run + - /github/automating-your-workflow-with-github-actions/managing-a-workflow-run + - /actions/automating-your-workflow-with-github-actions/managing-a-workflow-run + - /actions/configuring-and-managing-workflows/configuring-and-managing-workflow-files-and-runs +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% link_in_list /viewing-workflow-run-history %} +{% link_in_list /using-workflow-run-logs %} +{% link_in_list /manually-running-a-workflow %} +{% link_in_list /re-running-a-workflow %} +{% link_in_list /canceling-a-workflow %} +{% link_in_list /disabling-and-enabling-a-workflow %} +{% link_in_list /deleting-a-workflow-run %} +{% link_in_list /viewing-job-execution-time %} +{% link_in_list /downloading-workflow-artifacts %} +{% link_in_list /removing-workflow-artifacts %} +{% link_in_list /enabling-debug-logging %} +{% link_in_list /adding-a-workflow-status-badge %} diff --git a/translations/de-DE/content/actions/managing-workflow-runs/manually-running-a-workflow.md b/translations/de-DE/content/actions/managing-workflow-runs/manually-running-a-workflow.md new file mode 100644 index 000000000000..81404760ac5e --- /dev/null +++ b/translations/de-DE/content/actions/managing-workflow-runs/manually-running-a-workflow.md @@ -0,0 +1,31 @@ +--- +title: Manuelle Ausführung eines Workflows +intro: 'When a workflow is configured to run on the `workflow_dispatch` event, you can run the workflow using the REST API or from the Actions tab on {% data variables.product.prodname_dotcom %}.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +To run a workflow manually, the workflow must be configured to run on the `workflow_dispatch` event. Weitere Informationen findest Du unter "[Ereignisse, die Workflows auslösen](/actions/reference/events-that-trigger-workflows)." + +### Running a workflow on {% data variables.product.prodname_dotcom %} + +To trigger the `workflow_dispatch` event on {% data variables.product.prodname_dotcom %}, your workflow must be in the default branch. Führen Sie die folgenden Schritte aus, um eine Workflowausführung manuell auszulösen. + +{% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. Klicken Sie in der linken Seitenleiste auf den Workflow, den Sie ausführen möchten. ![Aktionen auswählen Workflow](/assets/images/actions-select-workflow.png) +1. Wählen Sie über der Liste der Workflowausführungen **Workflow ausführen**. ![Aktionsworkflow-Dispatch](/assets/images/actions-workflow-dispatch.png) +1. Wählen Sie die Verzweigung aus, in der der Workflow ausgeführt wird, und geben Sie die Eingabeparameter ein, die vom Workflow verwendet werden. Klicken Sie auf **Workflow ausführen**. ![Aktionen manuell ausgeführt Workflow](/assets/images/actions-manually-run-workflow.png) + +### Running a workflow using the REST API + +Wenn Sie die REST-API verwenden, konfigurieren Sie die `eingaben` und `ref` als Anforderungstextparameter. Wenn die Eingaben weggelassen werden, werden die in der Workflowdatei definierten Standardwerte verwendet. + +Weitere Informationen zur Verwendung der REST-API finden Sie unter "[Erstellen eines Workflow-Dispatch-Ereignisses](/rest/reference/actions/#create-a-workflow-dispatch-event)." diff --git a/translations/de-DE/content/actions/managing-workflow-runs/re-running-a-workflow.md b/translations/de-DE/content/actions/managing-workflow-runs/re-running-a-workflow.md new file mode 100644 index 000000000000..11dee1a075dc --- /dev/null +++ b/translations/de-DE/content/actions/managing-workflow-runs/re-running-a-workflow.md @@ -0,0 +1,19 @@ +--- +title: Re-running a workflow +intro: You can re-run an instance of a workflow. Re-running a workflow uses the same `GITHUB_SHA` (commit SHA) and `GITHUB_REF` (Git ref) of the original event that triggered the workflow run. +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. In the upper-right corner of the workflow, use the **Re-run jobs** drop-down menu, and select **Re-run all jobs**. ![Dropdownmenü zum erneuten Durchführen der Prüfungen](/assets/images/help/repository/rerun-checks-drop-down.png) diff --git a/translations/de-DE/content/actions/managing-workflow-runs/removing-workflow-artifacts.md b/translations/de-DE/content/actions/managing-workflow-runs/removing-workflow-artifacts.md new file mode 100644 index 000000000000..74f559eb570d --- /dev/null +++ b/translations/de-DE/content/actions/managing-workflow-runs/removing-workflow-artifacts.md @@ -0,0 +1,41 @@ +--- +title: Removing workflow artifacts +intro: 'You can reclaim used {% data variables.product.prodname_actions %} storage by deleting artifacts before they expire on {% data variables.product.product_name %}.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Deleting an artifact + +{% warning %} + +**Warnung:** Sobald Du ein Artefakt löschst, kann es nicht wiederhergestellt werden. + +{% endwarning %} + +{% data reusables.repositories.permissions-statement-write %} + +{% data reusables.github-actions.artifact-log-retention-statement %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. Under **Artifacts**, click {% octicon "trashcan" aria-label="The trashcan icon" %} next to the artifact you want to remove. ![Dropdown-Menü zum Löschen von Artefakten](/assets/images/help/repository/actions-delete-artifact.png) + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +### Setting the retention period for an artifact + +Retention periods for artifacts and logs can be configured at the repository, organization, and enterprise level. For more information, see "[Usage limits, billing, and administration](/actions/reference/usage-limits-billing-and-administration#artifact-and-log-retention-policy)." + +You can also define a custom retention period for individual artifacts using the `actions/upload-artifact` action in a workflow. For more information, see "[Storing workflow data as artifacts](/actions/guides/storing-workflow-data-as-artifacts#configuring-a-custom-artifact-retention-period)." + +### Finding the expiration date of an artifact + +You can use the API to confirm the date that an artifact is scheduled to be deleted. For more information, see the `expires_at` value returned by "[List artifacts for a repository](/rest/reference/actions#artifacts)." +{% endif %} \ No newline at end of file diff --git a/translations/de-DE/content/actions/managing-workflow-runs/using-workflow-run-logs.md b/translations/de-DE/content/actions/managing-workflow-runs/using-workflow-run-logs.md new file mode 100644 index 000000000000..93a46763d3c6 --- /dev/null +++ b/translations/de-DE/content/actions/managing-workflow-runs/using-workflow-run-logs.md @@ -0,0 +1,86 @@ +--- +title: Using workflow run logs +intro: 'You can view, search, and download the logs for each job in a workflow run.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +Auf der Workflow-Lauf-Seite können sie sehen, ob ein Workflow-Lauf ausgeführt wird oder abgeschlossen ist. Sie müssen mit einem {% data variables.product.prodname_dotcom %}-Konto angemeldet sein, um Workflow-Informationen anzuzeigen, auch für öffentliche Repositories. Weitere Informationen finden Sie unter „[Zugriffsberechtigungen auf GitHub](/articles/access-permissions-on-github)“. + +Wenn der Lauf abgeschlossen ist, können Sie sehen, ob das Ergebnis erfolgreich, fehlerhaft, abgebrochen oder neutral war. Wenn der Lauf fehlgeschlagen ist, können Sie die Build-Protokolle anzeigen und durchsuchen, um den Fehler zu diagnostizieren und den Workflow erneut auszuführen. Sie können auch fakturierbare Auftragsausführungsminuten anzeigen oder Protokolle herunterladen und Artefakte erstellen. + +{% data variables.product.prodname_actions %} verwenden die Checks API, um Status, Ergebnisse und Protokolle für einen Workflow auszugeben. {% data variables.product.prodname_dotcom %} erstellt eine neue Prüfsuite für jeden Workflow-Lauf. Die Prüfsuite enthält einen Prüflauf für jeden Auftrag im Workflow, und jeder Auftrag enthält Schritte. {% data variables.product.prodname_actions %} werden als Schritt in einem Workflow ausgeführt. Weitere Informationen zur Prüf-API finden Sie unter "[](/v3/checks/)". + +{% data reusables.github-actions.invalid-workflow-files %} + +### Protokolle zur Fehlerdiagnose anzeigen + +Wenn Ihr Workflow-Lauf fehlschlägt, können Sie sehen, welcher Schritt den Fehler verursacht hat, und die Build-Protokolle des fehlgeschlagenen Schrittes zur Fehlerbehebung überprüfen. Sie sehen, wie lange es gedauert hat, bis jeder Schritt ausgeführt wurde. Sie können außerdem einen Permalink in eine bestimmte Zeile in der Protokolldatei kopieren, um ihn mit Ihrem Team zu teilen. {% data reusables.repositories.permissions-statement-read %} + +In addition to the steps configured in the workflow file, {% data variables.product.prodname_dotcom %} adds two additional steps to each job to set up and complete the job's execution. These steps are logged in the workflow run with the names "Set up job" and "Complete job". + +For jobs run on {% data variables.product.prodname_dotcom %}-hosted runners, "Set up job" records details of the runner's virtual environment, and includes a link to the list of preinstalled tools that were present on the runner machine. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +{% data reusables.repositories.navigate-to-job-superlinter %} +{% data reusables.repositories.view-failed-job-results-superlinter %} +{% data reusables.repositories.view-specific-line-superlinter %} + +### Protokolle durchsuchen + +Sie können die Build-Protokolle für einen bestimmten Schritt durchsuchen. Beim Durchsuchen von Protokollen werden nur eingeblendete Schritte in die Ergebnisse einbezogen. {% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +{% data reusables.repositories.navigate-to-job-superlinter %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +1. Gib in der oberen rechten Ecke der Protokollausgabe im Suchfeld **Search logs** (Protokolle durchsuchen) eine Suchanfrage ein. ![Suchfeld zum Durchsuchen von Protokollen](/assets/images/help/repository/search-log-box-updated.png) +{% else %} +1. Um jeden Schritt, den Sie in Ihre Suche einbeziehen möchten, einzublenden, klicken Sie auf den Schritt. ![Name des Schrittes](/assets/images/help/repository/failed-check-step.png) +1. Gib in der oberen rechten Ecke der Protokollausgabe im Suchfeld **Search logs** (Protokolle durchsuchen) eine Suchanfrage ein. ![Suchfeld zum Durchsuchen von Protokollen](/assets/images/help/repository/search-log-box.png) +{% endif %} + +### Herunterladen von Protokollen + +Sie können die Protokolldateien von Ihrem Workflowlauf herunterladen. Sie können auch die Artefakte eines Workflows herunterladen. Weitere Informationen findest Du unter „[Workflow-Daten mittels Artefakten persistieren](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)“. {% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +{% data reusables.repositories.navigate-to-job-superlinter %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +1. In the upper right corner, click +{% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} and select **Download log archive**. + ![Dropdownmenü zum Herunterladen von Protokollen](/assets/images/help/repository/download-logs-drop-down-updated.png) +{% else %} +1. In the upper right corner, click +{% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} and select **Download log archive**. + ![Dropdownmenü zum Herunterladen von Protokollen](/assets/images/help/repository/download-logs-drop-down.png) +{% endif %} + +### Logs löschen + +Du kannst die Logdateien aus Deiner Workflow-Ausführung löschen. {% data reusables.repositories.permissions-statement-write %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +1. In the upper right corner, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}. ![Kebab-horizontal icon](/assets/images/help/repository/workflow-run-kebab-horizontal-icon-updated.png) +2. Um die Logdateien zu löschen, klicke auf **Delete all logs** (Alle Logs löschen) und überprüfe die Bestätigungsanfrage. ![Delete all logs](/assets/images/help/repository/delete-all-logs-updated.png) Nach die Protokolle gelöscht sind, verschwindet die Schaltfläche **Delete all logs**, um anzuzeigen, dass keine Protokolldateien mehr im Workflowlauf verbleiben. +{% else %} +1. In the upper right corner, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}. ![Kebab-horizontal icon](/assets/images/help/repository/workflow-run-kebab-horizontal-icon.png) +2. Um die Logdateien zu löschen, klicke auf **Delete all logs** (Alle Logs löschen) und überprüfe die Bestätigungsanfrage. ![Delete all logs](/assets/images/help/repository/delete-all-logs.png) After the logs have been deleted, the **Delete all logs** button is removed to indicate that no log files remain in the workflow run. +{% endif %} diff --git a/translations/de-DE/content/actions/managing-workflow-runs/viewing-job-execution-time.md b/translations/de-DE/content/actions/managing-workflow-runs/viewing-job-execution-time.md new file mode 100644 index 000000000000..e6df60d0ecad --- /dev/null +++ b/translations/de-DE/content/actions/managing-workflow-runs/viewing-job-execution-time.md @@ -0,0 +1,24 @@ +--- +title: Viewing job execution time +intro: 'Sie können die Ausführungszeit eines Auftrags anzeigen, einschließlich der fakturierbaren Minuten, die ein Einzelvorgang angesammelt hat.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +Billable job execution minutes are only shown for jobs run on private repositories that use {% data variables.product.prodname_dotcom %}-hosted runners. There are no billable minutes when using {% data variables.product.prodname_actions %} in public repositories or for jobs run on self-hosted runners. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. Under the job summary, you can view the job's execution time. To view the billable job execution time, click **Run and billable time details**. ![Link zu Den Ausführungs- und Abrechnungsdetails](/assets/images/help/repository/view-run-billable-time.png) + + {% note %} + + **Hinweis:** Die angezeigte Abrechnungszeit enthält keine Rundungen oder Minutenmultiplikatoren. To view your total {% data variables.product.prodname_actions %} usage, including rounding and minute multipliers, see "[Viewing your {% data variables.product.prodname_actions %} usage](/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage)." + + {% endnote %} diff --git a/translations/de-DE/content/actions/managing-workflow-runs/viewing-workflow-run-history.md b/translations/de-DE/content/actions/managing-workflow-runs/viewing-workflow-run-history.md new file mode 100644 index 000000000000..47ca04068ef3 --- /dev/null +++ b/translations/de-DE/content/actions/managing-workflow-runs/viewing-workflow-run-history.md @@ -0,0 +1,18 @@ +--- +title: Viewing workflow run history +intro: You can view logs for each run of a workflow. Logs include the status for each job and step in a workflow. +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} diff --git a/translations/de-DE/content/actions/quickstart.md b/translations/de-DE/content/actions/quickstart.md index d2ca1e16457c..612ccf4cd08d 100644 --- a/translations/de-DE/content/actions/quickstart.md +++ b/translations/de-DE/content/actions/quickstart.md @@ -55,11 +55,12 @@ Committing the workflow file in your repository triggers the `push` event and ru ### Viewing your workflow results +{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.actions-tab %} -1. Klicke in der linken Seitenleiste auf den Workflow, den Du sehen willst. ![Workflow-Liste in der linken Seitenleiste](/assets/images/help/repository/superlinter-workflow-sidebar.png) -1. From the list of workflow runs, click the name of the run you want to see. ![Name der Workflow-Ausführung](/assets/images/help/repository/superlinter-run-name.png) +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} 1. In the left sidebar, click the **Lint code base** job. ![Lint code base job](/assets/images/help/repository/superlinter-lint-code-base-job.png) -2. Expand the **Run Super-Linter** step to view the results. ![Super linter workflow results](/assets/images/help/repository/super-linter-workflow-results.png) +{% data reusables.repositories.view-failed-job-results-superlinter %} ### More starter workflows diff --git a/translations/de-DE/content/actions/reference/authentication-in-a-workflow.md b/translations/de-DE/content/actions/reference/authentication-in-a-workflow.md new file mode 100644 index 000000000000..c177ed9772dc --- /dev/null +++ b/translations/de-DE/content/actions/reference/authentication-in-a-workflow.md @@ -0,0 +1,100 @@ +--- +title: Authentication in a workflow +intro: '{% data variables.product.prodname_dotcom %} stellt ein Token zur Verfügung, mit dem Du Dich im Namen von {% data variables.product.prodname_actions %} authentifizieren kannst.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /github/automating-your-workflow-with-github-actions/authenticating-with-the-github_token + - /actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token + - /actions/configuring-and-managing-workflows/authenticating-with-the-github_token +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +Jeder mit `write`(schreiben)-Zugriff auf ein Repository kann Geheimnisse erstellen, lesen und verwenden. + +### Informationen zum `GITHUB_TOKEN`-Geheimnis + +{% data variables.product.prodname_dotcom %} erstellt automatisch ein `GITHUB_TOKEN`-Geheimnis für den Workflow. Du kannst den `GITHUB_TOKEN` verwenden, um Dich in einem Workflow zu authentifizieren. + +Wenn Du {% data variables.product.prodname_actions %} aktivierst, installiert {% data variables.product.prodname_dotcom %} eine {% data variables.product.prodname_github_app %} in Deinem Repository. Das `GITHUB_TOKEN`-Geheimnis ist ein {% data variables.product.prodname_github_app %}-Token für Installations-Zugriff. Du kannst das Installationszugriffs-Token verwenden, um Dich im Namen der auf Deinem Repository installierten {% data variables.product.prodname_github_app %} zu authentifizieren. Die Berechtigungen des Tokens sind auf das Repository beschränkt, in dem sich der Workflow befindet. Weitere Informationen findest Du unter "[Berechtigungen für das `GITHUB_TOKEN`](#permissions-for-the-github_token)." + +Before each job begins, {% data variables.product.prodname_dotcom %} fetches an installation access token for the job. Das Token läuft ab, wenn der Auftrag abgeschlossen ist. + +Das Token ist auch im `github.token`-Kontext verfügbar. Weitere Informationen findest Du unter "[Kontext- und Ausdrucks-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)". + +### Das `GITHUB_TOKEN` in einem Workflow verwenden + +Um das `GITHUB_TOKEN`-Geheimnis zu verwenden, musst Du es in Deiner Workflow-Datei referenzieren. Hierbei musst Du das Token ggf. als Eingabe für eine Aktion übergeben, für die dieses Token erforderlich ist, oder authentifizierte Aufrufe der {% data variables.product.prodname_dotcom %}-API ausführen. + +{% data reusables.github-actions.actions-do-not-trigger-workflows %} + +#### Beispiel: Das `GITHUB_TOKEN` als Eingabe übergeben + +Dieser Beispielworkflow verwendet die [Labeler-Aktion](https://github.com/actions/labeler), wofür das `GITHUB_TOKEN` als Wert für den Eingabeparameter `repo-token` benötigt wird: + + {% raw %} + ```yaml + name: Pull request labeler + on: + - pull_request + jobs: + triage: + runs-on: ubuntu-latest + steps: + - uses: actions/labeler@v2 + with: + repo-token: ${{ secrets.GITHUB_TOKEN }} + ``` + {% endraw %} + +#### Beispiel zum Aufrufen der REST-API + +Du kannst das `GITHUB_TOKEN` verwenden, um authentifizierte API-Aufrufe durchzuführen. Dieser Beispiel-Workflow erzeugt eine Lieferung („issue“) mittels der {% data variables.product.prodname_dotcom %}-REST-API: + + {% raw %} + ```yaml + name: Create issue on commit + on: + - push + jobs: + create_commit: + runs-on: ubuntu-latest + steps: + - name: Create issue using REST API + run: | + curl --request POST \ + --url https://api.github.com/repos/${{ github.repository }}/issues \ + --header 'authorization: Bearer ${{ secrets.GITHUB_TOKEN }}' \ + --header 'content-type: application/json' \ + --data '{ + "title": "Automated issue for commit: ${{ github.sha }}", + "body": "This issue was automatically created by the GitHub Action workflow **${{ github.workflow }}**. \n\n Der Commit-Hash lautete: _'{{ github.sha }}_." + }' + ``` + {% endraw %} + +### Berechtigungen für das `GITHUB_TOKEN` + +For information about the API endpoints {% data variables.product.prodname_github_apps %} can access with each permission, see "[{% data variables.product.prodname_github_app %} Permissions](/v3/apps/permissions/)." + +| Berechtigung | Zugriffstyp | Zugriff durch geforktes Repository | +| ------------------------ | --------------- | ---------------------------------- | +| actions | Lesen/Schreiben | Lesen | +| checks (Prüfungen) | Lesen/Schreiben | Lesen | +| contents (Inhalte) | Lesen/Schreiben | Lesen | +| deployments | Lesen/Schreiben | Lesen | +| Issues (Lieferungen) | Lesen/Schreiben | Lesen | +| Metadaten | Lesen | Lesen | +| Pakete | Lesen/Schreiben | Lesen | +| pull requests | Lesen/Schreiben | Lesen | +| repository projects | Lesen/Schreiben | Lesen | +| statuses (Statusangaben) | Lesen/Schreiben | Lesen | + +Wenn Du ein Token benötigst, für das Berechtigungen erforderlich sind, die nicht im `GITHUB_TOKEN`-Geheimnis vorhanden sind, kannst Du ein persönliches Zugangstoken erstellen und als Geheimnis im Repository festlegen: + +1. Verwende oder erstelle ein Token mit den entsprechenden Berechtigungen für dieses Repository. Weitere Informationen finden Sie unter "[Erstellen eines persönlichen Zugriffstokens](/github/authenticating-to-github/creating-a-personal-access-token)." +1. Füge das Token als Geheimnis in das Repository Deines Workflows ein, und verweise darauf mit der Syntax {%raw%}`${{ secrets.SECRET_NAME }}`{% endraw %}. Weitere Informationen findest Du unter "[Verschlüsselte Geheimnisse erstellen und verwenden](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". diff --git a/translations/de-DE/content/actions/reference/context-and-expression-syntax-for-github-actions.md b/translations/de-DE/content/actions/reference/context-and-expression-syntax-for-github-actions.md index 8e1da3170e46..8cf27ab82a27 100644 --- a/translations/de-DE/content/actions/reference/context-and-expression-syntax-for-github-actions.md +++ b/translations/de-DE/content/actions/reference/context-and-expression-syntax-for-github-actions.md @@ -81,27 +81,27 @@ Der `github`-Kontext enthält Informationen zum Workflow-Lauf und zu dem Ereigni {% data reusables.github-actions.github-context-warning %} -| Name der Eigenschaft | Typ | Beschreibung | -| ------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `github` | `Objekt` | Der Top-Level-Kontext, der bei jedem Job oder Schritt im Workflow verfügbar ist. | -| `github.event` | `Objekt` | Die vollständige Nutzlast des Ereignis-Webhooks. Weitere Informationen findest Du unter „[Ereignisse, die Workflows auslösen](/articles/events-that-trigger-workflows)“. You can access individual properties of the event using this context. | -| `github.event_path` | `string` | Der Pfad zur vollständigen Event-Webhook-Nutzlast auf dem Runner. | -| `github.workflow` | `string` | Der Name des Workflows. Wenn in der Workflow-Datei kein `name` festgelegt ist, entspricht der Wert dieser Eigenschaft dem vollständigen Pfad der Workflow-Datei im Repository. | -| `github.job` | `string` | Die [`job_id`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_id) des aktuellen Jobs. | -| `github.run_id` | `string` | {% data reusables.github-actions.run_id_description %} | -| `github.run_number` | `string` | {% data reusables.github-actions.run_number_description %} | -| `github.actor` | `string` | Der Anmeldename des Benutzers, der den Workflow-Lauf initiiert hat. | -| `github.repository` | `string` | Der Inhaber- und Repository-Name, Beispielsweise `Codertocat/Hello-World`. | -| `github.repository_owner` | `string` | Der Name des Repository-Besitzers. Beispielsweise `Codertocat`. | -| `github.event_name` | `string` | Der Name des Ereignisses, das den Workflow-Lauf ausgelöst hat. | -| `github.sha` | `string` | Die Commit-SHA, die den Workflow-Lauf ausgelöst hat. | -| `github.ref` | `string` | Das Branch- oder Tag-Ref, das den Workflow-Lauf ausgelöst hat. | -| `github.head_ref` | `string` | Das `head_ref` oder der Quell-Branch des Pull Requests in einem Workflow-Lauf. Diese Eigenschaft ist nur verfügbar, wenn das Ereignis, das einen Workflow auslöst, ein `pull_request` (Pull Request) ist. | -| `github.base_ref` | `string` | Das `base_ref` oder der Ziel-Branch des Pull Requests in einem Workflow-Lauf. Diese Eigenschaft ist nur verfügbar, wenn das Ereignis, das einen Workflow auslöst, ein `pull_request` (Pull Request) ist. | -| `github.token` | `string` | Ein Token zum Authentifizieren im Namen der in Deinem Repository installierten GitHub-App. Funktionell entspricht dies dem Geheimnis `GITHUB_TOKEN`. Weitere Informationen findest Du unter „[Authentifizierung mit dem GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)". | -| `github.workspace` | `string` | Das Standardarbeitsverzeichnis für Schritte und der Standardspeicherort Deines Repositorys bei Verwendung der Aktion [ `checkout`](https://github.com/actions/checkout). | +| Name der Eigenschaft | Typ | Beschreibung | +| ------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `github` | `Objekt` | Der Top-Level-Kontext, der bei jedem Job oder Schritt im Workflow verfügbar ist. | | `github.action` | `string` | Der Name der aktuell laufenden Aktion. {% data variables.product.prodname_dotcom %} entfernt Sonderzeichen oder verwendet den Namen `run` wenn der aktuelle Schritt ein Skript ausführt. Wenn Du dieselbe Aktion mehr als einmal im selben Job verwendest, enthält der Name ein Suffix mit der Sequenznummer. Zum Beispiel wird das erste Skript, das Du ausführst, den Namen `run1`haben, und das zweite Skript heißt `run2`. Ebenso wird die zweite Anrufung von `actions/checkout` `actionscheckout2` sein. | -| `github.action_path` | `string` | The path where your action is located. You can use this path to easily access files located in the same repository as your action. This attribute is only supported in composite run steps actions. | +| `github.action_path` | `string` | The path where your action is located. You can use this path to easily access files located in the same repository as your action. This attribute is only supported in composite run steps actions. | +| `github.actor` | `string` | Der Anmeldename des Benutzers, der den Workflow-Lauf initiiert hat. | +| `github.base_ref` | `string` | Das `base_ref` oder der Ziel-Branch des Pull Requests in einem Workflow-Lauf. Diese Eigenschaft ist nur verfügbar, wenn das Ereignis, das einen Workflow auslöst, ein `pull_request` (Pull Request) ist. | +| `github.event` | `Objekt` | Die vollständige Nutzlast des Ereignis-Webhooks. Weitere Informationen findest Du unter „[Ereignisse, die Workflows auslösen](/articles/events-that-trigger-workflows)“. You can access individual properties of the event using this context. | +| `github.event_name` | `string` | Der Name des Ereignisses, das den Workflow-Lauf ausgelöst hat. | +| `github.event_path` | `string` | Der Pfad zur vollständigen Event-Webhook-Nutzlast auf dem Runner. | +| `github.head_ref` | `string` | Das `head_ref` oder der Quell-Branch des Pull Requests in einem Workflow-Lauf. Diese Eigenschaft ist nur verfügbar, wenn das Ereignis, das einen Workflow auslöst, ein `pull_request` (Pull Request) ist. | +| `github.job` | `string` | Die [`job_id`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_id) des aktuellen Jobs. | +| `github.ref` | `string` | Das Branch- oder Tag-Ref, das den Workflow-Lauf ausgelöst hat. | +| `github.repository` | `string` | Der Inhaber- und Repository-Name, Beispielsweise `Codertocat/Hello-World`. | +| `github.repository_owner` | `string` | Der Name des Repository-Besitzers. Beispielsweise `Codertocat`. | +| `github.run_id` | `string` | {% data reusables.github-actions.run_id_description %} +| `github.run_number` | `string` | {% data reusables.github-actions.run_number_description %} +| `github.sha` | `string` | Die Commit-SHA, die den Workflow-Lauf ausgelöst hat. | +| `github.token` | `string` | Ein Token zum Authentifizieren im Namen der in Deinem Repository installierten GitHub-App. Funktionell entspricht dies dem Geheimnis `GITHUB_TOKEN`. Weitere Informationen findest Du unter „[Authentifizierung mit dem GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)". | +| `github.workflow` | `string` | Der Name des Workflows. Wenn in der Workflow-Datei kein `name` festgelegt ist, entspricht der Wert dieser Eigenschaft dem vollständigen Pfad der Workflow-Datei im Repository. | +| `github.workspace` | `string` | Das Standardarbeitsverzeichnis für Schritte und der Standardspeicherort Deines Repositorys bei Verwendung der Aktion [ `checkout`](https://github.com/actions/checkout). | #### **`env`-Kontext** @@ -121,17 +121,17 @@ Du kannst den `env`-Kontext nur im Wert der Schlüssel `with` und `name` verwend Der `job`-Kontext enthält Informationen zum gerade ausgeführten Auftrag. -| Name der Eigenschaft | Typ | Beschreibung | -| ----------------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `Auftrag` | `Objekt` | Dieser Kontext ändert sich bei jedem Auftrag in einem Workflow-Lauf. Du kannst bei jedem Schritt in einem Auftrag auf diesen Kontext zugreifen. | -| `job.status` | `string` | Der aktuelle Status des Auftrags. Mögliche Werte sind `success` (erfolgreich), `failure` (fehlgeschlagen) oder `cancelled` (abgebrochen). | +| Name der Eigenschaft | Typ | Beschreibung | +| ----------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `Auftrag` | `Objekt` | Dieser Kontext ändert sich bei jedem Auftrag in einem Workflow-Lauf. Du kannst bei jedem Schritt in einem Auftrag auf diesen Kontext zugreifen. | | `job.container` | `Objekt` | Informationen zum Container des Auftrags. Weitere Informationen zu Containern findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idcontainer)“. | -| `job.container.network` | `string` | Die ID des Container-Netzwerks. Der Runner erstellt das Netzwerk, das von allen Containern in einem Auftrag genutzt wird. | -| `job.container.id` | `string` | Die ID des Containers | +| `job.container.id` | `string` | Die ID des Containers | +| `job.container.network` | `string` | Die ID des Container-Netzwerks. Der Runner erstellt das Netzwerk, das von allen Containern in einem Auftrag genutzt wird. | | `job.services` | `Objekt` | Die für einen Auftrag erstellten Dienstcontainer. Weitere Informationen zu Dienstcontainern findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idservices)“. | -| `job.services..id` | `string` | Die ID des Service-Containers. | -| `job.services..ports` | `Objekt` | Die offengelegten Ports des Service-Containers | -| `job.services..network` | `string` | Die ID des Dienstcontainer-Netzwerks. Der Runner erstellt das Netzwerk, das von allen Containern in einem Auftrag genutzt wird. | +| `job.services..id` | `string` | Die ID des Service-Containers. | +| `job.services..network` | `string` | Die ID des Dienstcontainer-Netzwerks. Der Runner erstellt das Netzwerk, das von allen Containern in einem Auftrag genutzt wird. | +| `job.services..ports` | `Objekt` | Die offengelegten Ports des Service-Containers | +| `job.status` | `string` | Der aktuelle Status des Auftrags. Mögliche Werte sind `success` (erfolgreich), `failure` (fehlgeschlagen) oder `cancelled` (abgebrochen). | #### **`steps`-Kontext** @@ -140,31 +140,31 @@ Der `steps`-Kontext enthält Informationen zu den Schritten im aktuellen Auftrag | Name der Eigenschaft | Typ | Beschreibung | | --------------------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `steps` | `Objekt` | Dieser Kontext ändert sich bei jedem Schritt in einem Auftrag. Du kannst bei jedem Schritt in einem Auftrag auf diesen Kontext zugreifen. | -| `steps..outputs` | `Objekt` | Der Satz an Ausgaben, die für diesen Schritt definiert wurden. Weitere Informationen findest Du unter „[Metadaten-Syntax für {% data variables.product.prodname_actions %}](/articles/metadata-syntax-for-github-actions#outputs)“. | -| `steps..outputs.` | `string` | Der Wert einer bestimmten Ausgabe | -| `steps..outcome` | `string` | Das Ergebnis eines abgeschlossenen Schritts bevor [`continue-on-error` (bei Fehler weitermachen)](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepscontinue-on-error) angewendet wird. Mögliche Werte sind `success` (erfolgreich), `failure` (fehlgeschlagen), `cancelled` (abgebrochen) oder `skipped` (übersprungen). Wenn ein Schritt mit `continue-on-error` (bei Fehler weitermachen) fehlschlägt, ist `outcome` (Ergebnis) `failure` zwar (Fehler), aber `conclusion` (Schlussfolgerung) ist am Ende `success` (Erfolg). | +| `steps..outputs` | `Objekt` | Der Satz an Ausgaben, die für diesen Schritt definiert wurden. Weitere Informationen findest Du unter „[Metadaten-Syntax für {% data variables.product.prodname_actions %}](/articles/metadata-syntax-for-github-actions#outputs)“. | | `steps..conclusion` | `string` | Das Ergebnis eines abgeschlossenen Schritts nachdem[`continue-on-error` (bei Fehler weitermachen)](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepscontinue-on-error) angewendet wurde. Mögliche Werte sind `success` (erfolgreich), `failure` (fehlgeschlagen), `cancelled` (abgebrochen) oder `skipped` (übersprungen). Wenn ein Schritt mit `continue-on-error` (bei Fehler weitermachen) fehlschlägt, ist `outcome` (Ergebnis) `failure` zwar (Fehler), aber `conclusion` (Schlussfolgerung) ist am Ende `success` (Erfolg). | +| `steps..outcome` | `string` | Das Ergebnis eines abgeschlossenen Schritts bevor [`continue-on-error` (bei Fehler weitermachen)](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepscontinue-on-error) angewendet wird. Mögliche Werte sind `success` (erfolgreich), `failure` (fehlgeschlagen), `cancelled` (abgebrochen) oder `skipped` (übersprungen). Wenn ein Schritt mit `continue-on-error` (bei Fehler weitermachen) fehlschlägt, ist `outcome` (Ergebnis) `failure` zwar (Fehler), aber `conclusion` (Schlussfolgerung) ist am Ende `success` (Erfolg). | +| `steps..outputs.` | `string` | Der Wert einer bestimmten Ausgabe | #### **`runner`-Kontext** Der `runner`-Kontext enthält Informationen über den Runner, der den aktuellen Job ausführt. -| Name der Eigenschaft | Typ | Beschreibung | -| -------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `runner.os` | `string` | Das Betriebssystem des Runners, der den Job ausführt. Mögliche Werte sind `Linux`, `Windows` oder `macOS`. | -| `runner.temp` | `string` | Der Pfad des temporären Verzeichnisses für den Runner. Dieses Verzeichnis ist zu Beginn jedes Auftrags garantiert leer, sogar bei selbst-gehosteten Runnern. | -| `runner.tool_cache` | `string` | Der Pfad des Verzeichnisses, das einige der vorinstallierten Tools für {% data variables.product.prodname_dotcom %}-gehostete Runner enthält. Weitere Informationen findest Du unter „[Auf GitHub-gehosteten Runnern installierte Software](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)". | +| Name der Eigenschaft | Typ | Beschreibung | +| -------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `runner.os` | `string` | Das Betriebssystem des Runners, der den Job ausführt. Mögliche Werte sind `Linux`, `Windows` oder `macOS`. | +| `runner.temp` | `string` | Der Pfad des temporären Verzeichnisses für den Runner. Dieses Verzeichnis ist zu Beginn jedes Auftrags garantiert leer, sogar bei selbst-gehosteten Runnern. | +| `runner.tool_cache` | `string` | Der Pfad des Verzeichnisses, das einige der vorinstallierten Tools für {% data variables.product.prodname_dotcom %}-gehostete Runner enthält. For more information, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". | #### **`needs`-Kontext** Der `needs`-Kontext enthält Ausgaben von allen Jobs, die als Abhängigkeit des aktuellen Jobs definiert sind. Weitere Informationen zur Definition von Jobabhängigkeiten findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)“. -| Name der Eigenschaft | Typ | Beschreibung | -| -------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `needs.` | `Objekt` | Ein einzelner Job, von dem der aktuelle Job abhängt. | -| `needs..result` | `string` | Das Ergebnis eines Jobs, von dem der aktuelle Job abhängt. Mögliche Werte sind `success` (erfolgreich), `failure` (fehlgeschlagen) oder `cancelled` (abgebrochen). | -| `needs..outputs` | `Objekt` | Die Menge aller Ausgaben eines Jobs, von dem der aktuelle Job abhängt. | -| `needs..outputs.` | `string` | Der Wert einer bestimmten Ausgabe für einen Job, von dem der aktuelle Job abhängt. | +| Name der Eigenschaft | Typ | Beschreibung | +| -------------------------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `needs.` | `Objekt` | Ein einzelner Job, von dem der aktuelle Job abhängt. | +| `needs..outputs` | `Objekt` | Die Menge aller Ausgaben eines Jobs, von dem der aktuelle Job abhängt. | +| `needs..outputs.` | `string` | Der Wert einer bestimmten Ausgabe für einen Job, von dem der aktuelle Job abhängt. | +| `needs..result` | `string` | Das Ergebnis eines Jobs, von dem der aktuelle Job abhängt. Mögliche Werte sind `success` (erfolgreich), `failure` (fehlgeschlagen), `cancelled` (abgebrochen) oder `skipped` (übersprungen). | #### Beispiel für die Ausgabe von Kontextinformationen in der Protokolldatei @@ -179,7 +179,7 @@ on: push jobs: one: - runs-on: ubuntu-16.04 + runs-on: ubuntu-latest steps: - name: Dump GitHub context env: @@ -252,7 +252,7 @@ env: | `&&` | Und | | \|\| | Oder | -{% data variables.product.prodname_dotcom %} führt einen nicht strengen Gleichheitsvergleich aus. +{% data variables.product.prodname_dotcom %} vergleicht auf Gleichheit in toleranter Weise. * Wenn die Typen nicht übereinstimmen, wandelt {% data variables.product.prodname_dotcom %} den Typ in eine Zahl um. {% data variables.product.prodname_dotcom %} wandelt Daten verschiedener Typen folgendermaßen in eine Zahl um: diff --git a/translations/de-DE/content/actions/reference/encrypted-secrets.md b/translations/de-DE/content/actions/reference/encrypted-secrets.md new file mode 100644 index 000000000000..ad3bf96e4dba --- /dev/null +++ b/translations/de-DE/content/actions/reference/encrypted-secrets.md @@ -0,0 +1,221 @@ +--- +title: Encrypted secrets +intro: Verschlüsselte Geheimnisse ermöglichen es Ihnen, vertrauliche Informationen in Ihrem Repository oder Ihrer Organisation zu speichern. +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets + - /actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets + - /actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Informationen zu verschlüsselten Geheimnissen + +Geheimnisse sind verschlüsselte Umgebungsvariablen, die Sie in einem Repository oder einer Organisation erstellen. The secrets you create are available to use in {% data variables.product.prodname_actions %} workflows. {% data variables.product.prodname_dotcom %} verwendet eine [versiegelte Libsodium-Box](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes) um sicherzustellen, dass Geheimnisse verschlüsselt werden, bevor sie {% data variables.product.prodname_dotcom %} erreichen, und verschlüsselt bleiben, bis Du sie in einem Workflow verwendest. + +{% data reusables.github-actions.secrets-org-level-overview %} + +#### Benennen Ihrer Geheimnisse + +Die folgenden Regeln gelten für geheime Namen: + +* Geheime Namen dürfen nur alphanumerische Zeichen (`[a-z]`, `[A-Z]`, `[0-9]`) oder Unterstriche (`_`) enthalten. Leerzeichen sind nicht zulässig. +* Geheime Namen dürfen nicht mit dem `GITHUB_` -Präfix beginnen. +* Geheime Namen dürfen nicht mit einer Zahl beginnen. +* Geheime Namen müssen auf der Ebene eindeutig sein, auf der sie erstellt werden. Beispielsweise muss ein geheimer Schlüssel, der auf Organisationsebene erstellt wird, einen eindeutigen Namen auf dieser Ebene haben, und ein geheimer Schlüssel, der auf Repository-Ebene erstellt wird, muss einen eindeutigen Namen in diesem Repository haben. Wenn ein Geheimschlüssel auf Organisationsebene denselben Namen wie ein Geheimschlüssel auf Repository-Ebene hat, hat der geheime Schlüssel auf Repository-Ebene Vorrang. + +To help ensure that {% data variables.product.prodname_dotcom %} redacts your secret in logs, avoid using structured data as the values of secrets. Vermeide beispielsweise Geheimnisse zu erstellen, die JSON oder codierte Git-Blobs enthalten. + +#### Zugriff auf Ihre Geheimnisse + +Um ein Geheimnis für eine Aktion verfügbar zu machen, legen Sie das Geheimnis als Eingabe oder Umgebungsvariable in der Workflow-Datei fest. In der README-Datei der Aktion erfahren Sie, welche Eingaben und Umgebungsvariablen die Aktion erwartet. Weitere Informationen finden Sie unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)“. + +Du kannst verschlüsselte Geheimnisse in einer Workflow-Datei verwenden und lesen, wenn Du auf die Datei Bearbeitungs-Zugriff hast. Weitere Informationen findest Du unter „[Zugriffsberechtigungen auf {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/access-permissions-on-github)“. + +{% warning %} + +**Warnung:** {% data variables.product.prodname_dotcom %} redigiert Geheimnisse zwar automatisch bei Ausgabe ins Log, aber Du solltest nicht vorsätzlich Geheimnisse ins Log schreiben. + +{% endwarning %} + +Sie können Geheimnisse auch mit der REST-API verwalten. Weitere Informationen finden Sie unter "[Secrets](/v3/actions/secrets/)". + +#### Einschränken von Anmeldeinformationsberechtigungen + +Beim Generieren von Anmeldeinformationen wird empfohlen, möglichst geringe Berechtigungen zu erteilen. Anstatt z.B. persönliche Anmeldeinformationen zu verwenden, solltest Du [Bereitstellen von Schlüsseln](/v3/guides/managing-deploy-keys/#deploy-keys) oder einen „Service-Account“ (Dienstkonto) benuzen. Ziehe in Erwägung, Nur-Lese-Berechtigungen zu gewähren, wenn dies ausreicht, und schränke den Zugriff so weit wie möglich ein. Wähle beim Generieren eines persönlichen Zugriffstokens („personal access token“, PAT) die geringsmöglichen Anwendungsbereiche („scopes“) aus. + +### Erstellen verschlüsselter Geheimnisse für ein Repository + +{% data reusables.github-actions.permissions-statement-secrets-repository %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.github-actions.sidebar-secret %} +1. Klicken Sie auf **Add a new secret** (Neues Geheimnis hinzufügen). +1. Geben Sie einen Namen für Ihr Geheimnis in das Eingabefeld **Name** ein. +1. Geben Sie den Wert für Ihr Geheimnis ein. +1. Klicken Sie auf **Add secret** (Geheimnis hinzufügen). + +Wenn Ihr Repository auf Geheimnisse der übergeordneten Organisation zugreifen kann, werden diese Geheimnisse auch auf dieser Seite aufgeführt. + +### Erstellen verschlüsselter Geheimnisse für eine Organisation + +Beim Erstellen eines geheimen Schlüssels in einer Organisation können Sie eine Richtlinie verwenden, um einzuschränken, welche Repositorys auf diesen geheimen Schlüssel zugreifen können. Sie können z. B. Zugriff auf alle Repositorys gewähren oder den Zugriff auf nur private Repositorys oder eine angegebene Liste von Repositorys beschränken. + +{% data reusables.github-actions.permissions-statement-secrets-organization %} + +{% data reusables.organizations.navigate-to-org %} +{% data reusables.organizations.org_settings %} +{% data reusables.github-actions.sidebar-secret %} +1. Klicken Sie auf **Neue geheime**. +1. Geben Sie einen Namen für Ihr Geheimnis in das Eingabefeld **Name** ein. +1. Geben Sie den **Value** für Ihr Geheimnis ein. +1. Wählen Sie im **Repository-Zugriff** Dropdownliste eine Zugriffsrichtlinie aus. +1. Klicken Sie auf **Add secret** (Geheimnis hinzufügen). + +### Überprüfen des Zugriffs auf Geheimnisse auf Organisationsebene + +Sie können überprüfen, welche Zugriffsrichtlinien auf einen geheimen Schlüssel in Ihrer Organisation angewendet werden. + +{% data reusables.organizations.navigate-to-org %} +{% data reusables.organizations.org_settings %} +{% data reusables.github-actions.sidebar-secret %} +1. Die Liste der Geheimnisse enthält alle konfigurierten Berechtigungen und Richtlinien. Ein Beispiel: ![Geheimliste](/assets/images/help/settings/actions-org-secrets-list.png) +1. Weitere Informationen zu den konfigurierten Berechtigungen für jeden geheimen Schlüssel finden Sie unter **Aktualisieren**. + +### Verschlüsselte Geheimnisse in einem Workflow verwenden + +Mit Ausnahme von `GITHUB_TOKEN` werden Geheimnisse nicht an den Runner übergeben, wenn ein Workflow von einem geforkten Repository aus ausgelöst wird. + +Um eine Aktion mit einem Geheimnis als Eingabe- oder Umgebungsvariable zu versehen, kannst Du den `secrets` Kontext verwenden, um auf Geheimnisse zuzugreifen, die Du in Deinem Repository erstellt hast. Weitere Informationen findest Du unter "[Kontext und Ausdrucks-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)" und "[Workflow-Syntax für {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)." + +{% raw %} +```yaml +steps: + - name: Hello world action + with: # Das Geheimnis als Eingabe setzen + super_secret: ${{ secrets.SuperSecret }} + env: # Oder als Umgebunsvariable ("environment variable") + super_secret: ${{ secrets.SuperSecret }} +``` +{% endraw %} + +Wann immer dies möglich ist, vermeide die Übergabe von Geheimnissen zwischen Prozessen von der Befehlszeile aus. Befehlszeilen-Prozesse können für andere Benutzer (mithilfe des Befehls `ps`) sichtbar sein oder von [„security audit events“ (Ereignissen zur Sicherheits-Überprüfung)](https://docs.microsoft.com/en-us/windows-server/identity/ad-ds/manage/component-updates/command-line-process-auditing) erfasst werden. Um den Schutz von Geheimnissen zu unterstützen, solltest Du die Verwendung von Umgebungsvariablen, `STDIN` oder andere vom Zielprozess unterstützte Mechanismen in Betracht ziehen. + +Wenn Sie Geheimnisse innerhalb einer Kommandozeile übergeben müssen, umschließe sie im Rahmen der gültigen Quotierungsregeln. Geheimnisse enthalten oft Sonderzeichen, die in Deiner Shell unbeabsichtigte Wirkungen entfalten können. Um diese Sonderzeichen zu vermeiden, verwende Deine Umgebungsvariablen mit Anführungszeichen. Ein Beispiel: + +#### Beispiel mit Bash + +{% raw %} +```yaml +steps: + - shell: bash + env: + SUPER_SECRET: ${{ secrets.SuperSecret }} + run: | + example-command "$SUPER_SECRET" +``` +{% endraw %} + +#### Beispiel mit PowerShell + +{% raw %} +```yaml +steps: + - shell: pwsh + env: + SUPER_SECRET: ${{ secrets.SuperSecret }} + run: | + example-command "$env:SUPER_SECRET" +``` +{% endraw %} + +#### Beispiel mit Cmd.exe + +{% raw %} +```yaml +steps: + - shell: cmd + env: + SUPER_SECRET: ${{ secrets.SuperSecret }} + run: | + example-command "%SUPER_SECRET%" +``` +{% endraw %} + +### Einschränkungen für Geheimnisse + +Dein Workflow kann bis zu 100 Geheimnisse haben. Die Namen von Geheimnis-Umgebungsvariablen müssen Repository-weit eindeutig sein. + +Geheimnisse sind auf 64 KB beschränkt. Um Geheimnisse zu verwenden, die größer als 64 KB sind, können Sie verschlüsselte Geheimnisse in Ihrem Repository speichern und die Passphrase zur Entschlüsselung als Geheimnis auf {% data variables.product.prodname_dotcom %} speichern. Sie können beispielsweise `gpg` verwenden, um Ihre Anmeldeinformationen lokal zu verschlüsseln, bevor Sie die Datei in Ihrem Repository auf {% data variables.product.prodname_dotcom %} einchecken. Weitere Informationen finden Sie auf der „[gpg-Manpage](https://www.gnupg.org/gph/de/manual/r1023.html)“. + +{% warning %} + +**Warnung**: Achte darauf, dass Deine Geheimnisse nicht gedruckt werden, wenn Deine Aktion ausgeführt wird. Wenn Sie diesen Workaround verwenden, redigiert {% data variables.product.prodname_dotcom %} keine Geheimnisse, die in Protokollen gedruckt werden. + +{% endwarning %} + +1. Führe den folgenden Befehl von Deinem Terminal aus, um die Datei `my_secret.json` mit `gpg` und dem Verschlüsselungs-Algorithmus AES256 zu verschlüsseln. + + ``` shell + $ gpg --symmetric --cipher-algo AES256 my_secret.json + ``` + +1. Du wirst aufgefordert, eine Passphrase einzugeben. Merken Sie sich die Passphrase, denn Sie müssen ein neues Geheimnis auf {% data variables.product.prodname_dotcom %} mit der Passphrase als Wert erstellen. + +1. Erstellen Sie einen neuen Geheimschlüssel, der die Passphrase enthält. Erstelle beispielsweise ein neues Geheimnis mit dem Namen `LARGE_SECRET_PASSPHRASE` und setze den Wert des Geheimnisses auf die Passphrase, die Du im obigen Schritt ausgewählt hast. + +1. Kopiere Deine verschlüsselte Datei in Dein Repository und committe sie. In diesem Beispiel ist die verschlüsselte Datei `my_secret.json.gpg`. + +1. Erstellen Sie ein Shell-Skript, um das Passwort zu entschlüsseln. Speichern Sie diese Datei als `decrypt_secret.sh`. + + ``` shell + + + Die Datei + mkdir $HOME/secrets + --batch entschlüsseln, um den interaktiven Befehl + zu verhindern - --ja, um "Ja" für Fragen + gpg --quiet --batch --yes --decrypt --passphrase="$LARGE_SECRET_PASSPHRASE" + --output $HOME/secrets/my_secret.json my_secret.json.gp + ``` + +1. Stellen Sie sicher, dass Ihr Shell-Skript ausführbar ist, bevor Sie es in Ihrem Repository einchecken. + + ``` shell + $ chmod +x decrypt_secret.sh + $ git add decrypt_secret.sh + $ git commit -m "Add new decryption script" + $ git push + ``` + +1. Verwenden Sie in Ihrem Workflow einen `step`, um das Shell-Skript aufzurufen und das Geheimnis zu entschlüsseln. Um in der Umgebung, in der Dein Workflow läuft, eine Kopie Deines Projektarchivs zu haben, musst Du die Aktion [`actions/checkout`](https://github.com/actions/checkout) verwenden. Referenzieren Sie Ihr Shell-Skript mit dem Befehl `run` relativ zum Root Ihres Repositorys. + +{% raw %} + ```yaml + name: Workflows with large secrets + + on: push + + jobs: + my-job: + name: My Job + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Decrypt large secret + run: ./.github/scripts/decrypt_secret.sh + env: + LARGE_SECRET_PASSPHRASE: ${{ secrets.LARGE_SECRET_PASSPHRASE }} + # Dieser Befehl ist nur ein Beispiel, um zu zeigen, dass Dein Geheimnis ausgegeben wird + # Stelle sicher, dass Du alle Druckanweisungen Deiner Geheimnisse entfernst. Github + # verbirgt keine Geheimnisse, die diese Umgehung verwenden. + - name: Test printing your secret (Remove this step in production) + run: cat $HOME/secrets/my_secret.json + ``` +{% endraw %} diff --git a/translations/de-DE/content/actions/reference/environment-variables.md b/translations/de-DE/content/actions/reference/environment-variables.md new file mode 100644 index 000000000000..dca6e7c31a2e --- /dev/null +++ b/translations/de-DE/content/actions/reference/environment-variables.md @@ -0,0 +1,69 @@ +--- +title: Umgebungsvariablen +intro: '{% data variables.product.prodname_dotcom %} setzt Standard-Umgebungsvariablen für jeden {% data variables.product.prodname_actions %}-Workflow-Lauf. Du kannst auch benutzerdefinierte Umgebungsvariablen in Deiner Workflow-Datei festlegen.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /github/automating-your-workflow-with-github-actions/using-environment-variables + - /actions/automating-your-workflow-with-github-actions/using-environment-variables + - /actions/configuring-and-managing-workflows/using-environment-variables +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Informationen zu Umgebungsvariablen + +{% data variables.product.prodname_dotcom %} setzt Standard-Umgebungsvariablen, die für jeden Schritt in einem Workflow-Lauf verfügbar sind. Bei Umgebungsvariablen wird die Groß-/Kleinschreibung berücksichtigt. Befehle, die in Aktionen oder „Steps“ (Schritten) ausgeführt werden, können Umgebungsvariablen erstellen, lesen und ändern. + +Um benutzerdefinierte Umgebungsvariablen festzulegen, musst Du die Variablen in der Workflow-Datei angeben. Du kannst Umgebungsvariablen für einen „Step“ (Schritt), Job, oder ganzen Workflow festlegen, indem Du die Schlüsselworte [`jobs..steps.env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv), [`jobs..env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idenv) oder [`env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env) verwendest. Weitere Informationen finden Sie unter „[Workflow-Syntax für {% data variables.product.prodname_dotcom %}](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)“. + +```yaml +steps: + - name: Hello world + run: echo Hello world $FIRST_NAME $middle_name $Last_Name! + env: + FIRST_NAME: Mona + middle_name: The + Last_Name: Octocat +``` + +You can also use the {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}`GITHUB_ENV` environment file{% else %} `set-env` workflow command{% endif %} to set an environment variable that the following steps in a workflow can use. The {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}environment file{% else %} `set-env` command{% endif %} can be used directly by an action or as a shell command in a workflow file using the `run` keyword. Weitere Informationen findest Du unter „[Workflow-Befehle für {% data variables.product.prodname_actions %}](/actions/reference/workflow-commands-for-github-actions/#setting-an-environment-variable)“. + +### Standard-Umgebungsvariablen + +Es wird dringend empfohlen, dass Aktionen Umgebungsvariablen verwenden, um auf das Dateisystem zuzugreifen, anstatt hartcodierte Dateipfade zu verwenden. {% data variables.product.prodname_dotcom %} legt Umgebungsvariablen für Aktionen fest, die in allen Runner-Umgebungen verwendet werden sollen. + +| Umgebungsvariable | Beschreibung | +| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `CI` | Immer auf `true` gesetzt. | +| `HOME` | Pfad zum {% data variables.product.prodname_dotcom %}-Startverzeichnis, in dem die Benutzerdaten gespeichert werden. Beispiel: `/github/home`. | +| `GITHUB_WORKFLOW` | Der Name des Workflows. | +| `GITHUB_RUN_ID` | {% data reusables.github-actions.run_id_description %} +| `GITHUB_RUN_NUMBER` | {% data reusables.github-actions.run_number_description %} +| `GITHUB_ACTION` | Die eindeutige Kennung (`id`) der Aktion. | +| `GITHUB_ACTIONS` | Immer auf `true` gesetzt, wenn {% data variables.product.prodname_actions %} den Workflow ausführt. Du kannst diese Variable verwenden, um zu differenzieren, wann Tests lokal oder von {% data variables.product.prodname_actions %} durchgeführt werden. | +| `GITHUB_ACTOR` | Name der Person oder App, die den Workflow initiiert hat. Beispiel: `octocat`. | +| `GITHUB_REPOSITORY` | Der Inhaber- und Repository-Name, Beispiel: `octocat/Hello-World`. | +| `GITHUB_EVENT_NAME` | Name des Webhook-Ereignisses, das den Workflow ausgelöst hat. | +| `GITHUB_EVENT_PATH` | Pfad der Datei mit der gesamten Nutzlast des Webhook-Ereignisses. Beispiel: `/github/workflow/event.json`. | +| `GITHUB_WORKSPACE` | Pfad zum Verzeichnis der Arbeitsoberfläche von {% data variables.product.prodname_dotcom %}. The workspace directory is a copy of your repository if your workflow uses the [actions/checkout](https://github.com/actions/checkout) action. Wenn Du die Aktion `actions/checkout` nicht verwendest, ist das Verzeichnis leer. Beispiel: `/home/runner/work/my-repo-name/my-repo-name`. | +| `GITHUB_SHA` | Commit-SHA, die den Workflow ausgelöst hat. Beispiel: `ffac537e6cbbf934b08745a378932722df287a53`. | +| `GITHUB_REF` | Branch- oder Tag-Ref, das den Workflow ausgelöst hat. Beispiel: `refs/heads/feature-branch-1`. Wenn für den Ereignistyp weder ein Branch noch ein Tag vorliegt, ist die Variable nicht vorhanden. | +| `GITHUB_HEAD_REF` | Nur für geforkte Repositorys festgelegt. Der Branch des Head-Repositorys. | +| `GITHUB_BASE_REF` | Nur für geforkte Repositorys festgelegt. Der Branch des Basis-Repositorys. | +| `GITHUB_SERVER_URL` | Returns the URL of the {% data variables.product.product_name %} server. For example: `https://github.com`. | +| `GITHUB_API_URL` | Gibt die API-URL zurück. For example: `https://api.github.com`. | +| `GITHUB_GRAPHQL_URL` | Gibt die GraphQL-API-URL zurück. For example: `https://api.github.com/graphql`. | + +### Namens-Konventionen für Umgebungsvariablen + +{% note %} + +**Hinweis:** In {% data variables.product.prodname_dotcom %} ist das Umgebungsvariablen-Präfix `GITHUB_` für den internen Gebrauch durch {% data variables.product.prodname_dotcom %} reserviert. Wenn Sie eine Umgebungsvariable oder ein Geheimnis mit dem Präfix `GITHUB_` anlegen, tritt ein Fehler auf. + +{% endnote %} + +Alle neuen Umgebungsvariablen, die auf einen Speicherort im Dateisystem verweisen, müssen das Suffix `_PATH` erhalten. Die Standardvariablen `HOME` und `GITHUB_WORKSPACE` sind von dieser Konvention ausgenommen, da die Bezeichnungen „home“ und „workspace“ bereits einen Speicherort implizieren. diff --git a/translations/de-DE/content/actions/reference/events-that-trigger-workflows.md b/translations/de-DE/content/actions/reference/events-that-trigger-workflows.md index faa2c7f5ee14..074d1c90db0b 100644 --- a/translations/de-DE/content/actions/reference/events-that-trigger-workflows.md +++ b/translations/de-DE/content/actions/reference/events-that-trigger-workflows.md @@ -1,6 +1,6 @@ --- -title: 'Ereignisse, die Workflows auslösen' -intro: 'Du kannst Deine Workflows so konfigurieren, dass sie zu einem geplanten Zeitpunkt ausgeführt werden oder dann, wenn eine bestimmte Aktivität auf {% data variables.product.product_name %} stattfindet oder ein Ereignis außerhalb von {% data variables.product.product_name %} eintrifft.' +title: Ereignisse, die Workflows auslösen +intro: 'Sie können konfigurieren, dass Ihre Workflows zu einem geplanten Zeitpunkt ausgeführt werden oder dann, wenn eine bestimmte Aktivität auf {% data variables.product.product_name %} stattfindet oder ein Ereignis außerhalb von {% data variables.product.product_name %} auftritt.' product: '{% data reusables.gated-features.actions %}' miniTocMaxHeadingLevel: 4 redirect_from: @@ -15,31 +15,142 @@ versions: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -### Informationen zu Workflow-Ereignissen +### Configuring workflow events -Sie können Ihren Workflow so konfigurieren, dass er ausgeführt wird, wenn Webhook-Ereignisse anhand von Aktivitäten auf {% data variables.product.product_name %} erstellt werden. Workflows können mehrere Webhook-Ereignisse verwenden, um einen Workflow-Lauf auszulösen. For more information, see "[Webhooks](/webhooks)." Weitere Informationen zur Syntax für `on` finden Sie unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#on)“. +You can configure workflows to run for one or more events using the `on` workflow syntax. Weitere Informationen finden Sie unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#on)“. + +{% data reusables.github-actions.actions-on-examples %} + +{% note %} + +**Hinweis:** Du kannst einen neuen Workflow-Lauf nicht mithilfe des `GITHUB_TOKEN` anstoßen. Weitere Informationen findest Du unter „[Neue Workflows mit einem persönlichen Zugriffstoken anstoßen](#triggering-new-workflows-using-a-personal-access-token)“. + +{% endnote %} Die folgenden Schritte laufen ab, um einen Workflow-Lauf auszulösen: -1. In Deinem Repository tritt ein Ereignis auf und zum dem daraus resultierenden Webhook gehören ein Commit-SHA und eine Git Ref. -1. Das Verzeichnis `.github/workflows` in Deinem Repository wird nach Workflow-Dateien des zugehörigen Commit-SHA oder der zugehörigen Git Ref durchsucht. Die Workflow-Dateien müssen in diesem Commit-SHA oder dieser Git Ref vorhanden sein, um berücksichtigt zu werden. +1. An event occurs on your repository, and the resulting event has an associated commit SHA and Git ref. +2. Das Verzeichnis `.github/workflows` in Deinem Repository wird nach Workflow-Dateien des zugehörigen Commit-SHA oder der zugehörigen Git Ref durchsucht. Die Workflow-Dateien müssen in diesem Commit-SHA oder dieser Git Ref vorhanden sein, um berücksichtigt zu werden. Wenn zum Beispiel das Ereignis in einem bestimmten Repository-Zweig aufgetreten ist, müssen die Workflow-Dateien im Repository dieses Zweiges vorhanden sein. 1. Die Workflow-Dateien für diesen Commit-SHA und diese Git Ref werden überprüft und für alle Workflows, deren `on:`-Werte zu dem auslösenden Ereignis passen, wird ein neuer Workflow-Lauf angestoßen. Der Workflow läuft auf dem Code Deines Repositorys mit dem selben Commit-SHA und derselben Git Ref wie das auslösende Ereignis. Wenn ein Workflow läuft, setzt {% data variables.product.product_name %} die Umgebungsvariablen `GITHUB_SHA` (Commit-SHA) und `GITHUB_REF` (Git Ref) in der Umgebung auf dem Runner. Weitere Informationen findest Du unter „[Umgebungsvariablen verwenden](/actions/automating-your-workflow-with-github-actions/using-environment-variables)“. +### Geplante Ereignisse + +The `schedule` event allows you to trigger a workflow at a scheduled time. + +#### `Zeitplan` + +| Nutzlast des Webhook-Ereignisses | Aktivitätstypen | `GITHUB_SHA` | `GITHUB_REF` | +| -------------------------------- | --------------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| – | – | Letzter Commit im Standard-Branch | Standardbranch | Zeitpunkt, zu dem der geplante Workflow ausgeführt werden soll. Für einen geplanten Workflow gilt die [POSIX-Cron-Syntax](https://pubs.opengroup.org/onlinepubs/9699919799/utilities/crontab.html#tag_20_25_07). Weitere Informationen finden Sie unter „[Einen Workflow mit Ereignissen auslösen](/articles/configuring-a-workflow/#triggering-a-workflow-with-events)“. | + +{% data reusables.repositories.actions-scheduled-workflow-example %} + +Die Cron-Syntax umfasst fünf durch Leerzeichen getrennte Felder, die jeweils eine Zeiteinheit darstellen. + +``` +┌───────────── Minute (0–59) +│ ┌───────────── Stunde (0–23) +│ │ ┌───────────── Tag (1–31) +│ │ │ ┌───────────── Monat (1–12 oder JAN–DEZ) +│ │ │ │ ┌───────────── Wochentag (0–6 oder SON–SAM) +│ │ │ │ │ +│ │ │ │ │ +│ │ │ │ │ +* * * * * +``` + +In den fünf Feldern stehen die folgenden Operatoren zur Auswahl: + +| Operator | Beschreibung | Beispiel | +| -------- | -------------------------- | ------------------------------------------------------------------------------------------------------------- | +| * | Beliebiger Wert | `* * * * *` wird jeden Tag jede Minute ausgeführt. | +| , | Trennzeichen in Werteliste | `2,10 4,5 * * *` wird jeden Tag bei Minute 2 und 10 der 4. und 5. Stunde ausgeführt. | +| - | Wertebereich | `0 4-6 * * *` wird bei Minute 0 der 4., 5. und 6. Stunde ausgeführt. | +| / | Schrittwerte | `20/15 * * * *` wird alle 15 Minuten ausgeführt, von Minute 20 bis Minute 59 (also bei Minute 20, 35 und 50). | + {% note %} -**Hinweis:** Du kannst einen neuen Workflow-Lauf nicht mithilfe des `GITHUB_TOKEN` anstoßen. Weitere Informationen findest Du unter „[Neue Workflows mit einem persönlichen Zugriffstoken anstoßen](#triggering-new-workflows-using-a-personal-access-token)“. +**Hinweis:** {% data variables.product.prodname_actions %} bietet keine Unterstützung für die nicht standardmäßige Syntax `@yearly`, `@monthly`, `@weekly`, `@daily`, `@hourly` und `@reboot`. {% endnote %} -{% data reusables.github-actions.actions-on-examples %} +Mit [crontab guru](https://crontab.guru/) können Sie die Cron-Syntax erzeugen und den Ausführungszeitpunkt bestätigen. Als Einstiegshilfe steht eine Liste mit [crontab-guru-Beispielen](https://crontab.guru/examples.html) bereit. + +### Manual events + +You can manually trigger workflow runs. To trigger specific workflows in a repository, use the `workflow_dispatch` event. To trigger more than one workflow in a repository and create custom events and event types, use the `repository_dispatch` event. + +#### `workflow_dispatch` + +| Nutzlast des Webhook-Ereignisses | Aktivitätstypen | `GITHUB_SHA` | `GITHUB_REF` | +| ---------------------------------------------------------------- | --------------- | ------------------------------------- | -------------------------------------- | +| [workflow_dispatch](/webhooks/event-payloads/#workflow_dispatch) | – | Letzter Commit im Branch `GITHUB_REF` | Branch, der den Dispatch empfangen hat | + +You can configure custom-defined input properties, default input values, and required inputs for the event directly in your workflow. Wenn der Workflow ausgeführt wird, können Sie auf die Eingabewerte im `github.event.inputs` Kontextzugreifen. Weitere Informationen findest Du unter "[Kontext- und Ausdrucks-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)". + +You can manually trigger a workflow run using the {% data variables.product.prodname_dotcom %} API and from {% data variables.product.prodname_dotcom %}. For more information, see "[Manually running a workflow](/actions/managing-workflow-runs/manually-running-a-workflow)." + + When you trigger the event on {% data variables.product.prodname_dotcom %}, you can provide the `ref` and any `inputs` directly on {% data variables.product.prodname_dotcom %}. For more information, see "[Using inputs and outputs with an action](/actions/learn-github-actions/finding-and-customizing-actions#using-inputs-and-outputs-with-an-action)." + + To trigger the custom `workflow_dispatch` webhook event using the REST API, you must send a `POST` request to a {% data variables.product.prodname_dotcom %} API endpoint and provide the `ref` and any required `inputs`. For more information, see the "[Create a workflow dispatch event](/rest/reference/actions/#create-a-workflow-dispatch-event)" REST API endpoint. + +##### Example workflow configuration + +In diesem Beispiel wird der `Name` definiert und ein- und `zu Hause verwendet, und sie werden mit den Kontexten github.event.inputs.name` und `github.event.inputs.home` gedruckt. Wenn ein `Name` nicht angegeben wird, wird der Standardwert 'Mona the Octocat' gedruckt. + +{% raw %} +```yaml +Name: Manuell ausgelöster Workflow +auf: + workflow_dispatch: + Eingaben: + Name: + Beschreibung: 'Person zu grüßen' + erforderlich: true + Standard: 'Mona the Octocat' + Home: + Beschreibung: 'Standort' + erforderlich: falsche + +Jobs: + say_hello: + läuft auf: ubuntu-latest + Schritte: + - laufen: | + Echo "Hallo{{ github.event.inputs.name }}!" + echo "- in{{ github.event.inputs.home }}!" +``` +{% endraw %} + +#### `repository_dispatch` + +| Nutzlast des Webhook-Ereignisses | Aktivitätstypen | `GITHUB_SHA` | `GITHUB_REF` | +| -------------------------------------------------------------------- | --------------- | ------------------------------------- | -------------------------------------- | +| [repository_dispatch](/webhooks/event-payloads/#repository_dispatch) | – | Letzter Commit im Branch `GITHUB_REF` | Branch, der den Dispatch empfangen hat | + +{% data reusables.github-actions.branch-requirement %} + +Mit der {% data variables.product.product_name %}-API können Sie das Webhook-Ereignis [`repository_dispatch`](/webhooks/event-payloads/#repository_dispatch) auslösen, wenn ein Workflow für eine Aktivität ausgelöst werden soll, die außerhalb von {% data variables.product.prodname_dotcom %} abläuft. Weitere Informationen finden Sie unter "[Erstellen eines Repository-Dispatchereignisses](/v3/repos/#create-a-repository-dispatch-event)." + +Soll das benutzerdefinierte Webhook-Ereignis `repository_dispatch` ausgelöst werden, senden Sie eine `POST`-Anfrage an einen {% data variables.product.product_name %}-API-Endpunkt, und geben Sie den Namen für einen `event_type` als Beschreibung für den Aktivitätstyp an. Soll ein Workflow-Lauf ausgelöst werden, konfigurieren Sie außerdem den Workflow für die Verwendung des Ereignisses `repository_dispatch`. + +##### Beispiel + +Standardmäßig lösen alle `event_types` einen Workflow aus. Du kannst Deinen Workflow darauf beschränken, zu laufen, wenn ein bestimmter Wert als `event_type` in der Webhoo-Nutzlast des `repository_dispatch` gesendet wird. Du definierst die Ereignistypen, die in der Nutzlast des `repository_dispatch` gesendet werden, wenn Du das Repositorydispatch-Ereignis erstellst. + +```yaml +on: + repository_dispatch: + types: [opened, deleted] +``` ### Webhook-Ereignisse -Du kannst Deinen Workflow so konfigurieren, dass er ausgeführt wird, sobald Webhook-Ereignisse in GitHub erstellt werden. Einige Ereignisse werden von mehreren Aktivitätstypen ausgelöst. Wird ein Ereignis von mehreren Aktivitätstypen ausgelöst, können Sie die Aktivitätstypen angeben, die die Ausführung des Workflows auslösen sollen. +Du kannst Deinen Workflow so konfigurieren, dass er ausgeführt wird, sobald Webhook-Ereignisse in GitHub erstellt werden. Einige Ereignisse werden von mehreren Aktivitätstypen ausgelöst. Wird ein Ereignis von mehreren Aktivitätstypen ausgelöst, können Sie die Aktivitätstypen angeben, die die Ausführung des Workflows auslösen sollen. For more information, see "[Webhooks](/webhooks)." #### `check_run` @@ -121,7 +232,7 @@ on: #### `deployment` -Führt den Workflow aus, wenn ein Benutzer eine Bereitstellung erstellt, wodurch das Ereignis `deployment` ausgelöst wird. Bereitstellungen, die mit einer Commit-SHA erstellt wurden, umfassen ggf. keinen Git-Ref. For information about the REST API, see "[Deployments](/v3/repos/deployments/)." +Führt den Workflow aus, wenn ein Benutzer eine Bereitstellung erstellt, wodurch das Ereignis `deployment` ausgelöst wird. Bereitstellungen, die mit einer Commit-SHA erstellt wurden, umfassen ggf. keinen Git-Ref. For information about the REST API, see "[Deployments](/rest/reference/repos#deployments)." | Nutzlast des Webhook-Ereignisses | Aktivitätstypen | `GITHUB_SHA` | `GITHUB_REF` | | ---------------------------------------------------- | --------------- | ------------------------- | ---------------------------------------------------- | @@ -136,7 +247,7 @@ on: #### `deployment_status` -Führt den Workflow aus, wenn ein Dritter einen Bereitstellungsstatus angibt, wodurch das Ereignis `deployment_status` ausgelöst wird. Bereitstellungen, die mit einer Commit-SHA erstellt wurden, umfassen ggf. keinen Git-Ref. For information about the REST API, see "[Create a deployment status](/v3/repos/deployments/#create-a-deployment-status)." +Führt den Workflow aus, wenn ein Dritter einen Bereitstellungsstatus angibt, wodurch das Ereignis `deployment_status` ausgelöst wird. Bereitstellungen, die mit einer Commit-SHA erstellt wurden, umfassen ggf. keinen Git-Ref. For information about the REST API, see "[Create a deployment status](/rest/reference/repos#create-a-deployment-status)." | Nutzlast des Webhook-Ereignisses | Aktivitätstypen | `GITHUB_SHA` | `GITHUB_REF` | | ------------------------------------------------------------------ | --------------- | ------------------------- | ---------------------------------------------------- | @@ -185,13 +296,13 @@ on: #### `issue_comment` -Führt den Workflow aus, wenn das Ereignis `issue_comment` eintritt. {% data reusables.developer-site.multiple_activity_types %} For information about the REST API, see "[Issue comments](/v3/issues/comments/)." +Führt den Workflow aus, wenn das Ereignis `issue_comment` eintritt. {% data reusables.developer-site.multiple_activity_types %} For information about the REST API, see "[Issue comments](/developers/webhooks-and-events/webhook-events-and-payloads#issue_comment)." {% data reusables.github-actions.branch-requirement %} -| Nutzlast des Webhook-Ereignisses | Aktivitätstypen | `GITHUB_SHA` | `GITHUB_REF` | -| ---------------------------------------------------------- | ----------------------------------------------------------------- | --------------------------------- | --------------- | -| [`issue_comment`](/v3/activity/event_types/#issue_comment) | - `created`
    - `edited`
    - `deleted`
    | Letzter Commit im Standard-Branch | Standard-Branch | +| Nutzlast des Webhook-Ereignisses | Aktivitätstypen | `GITHUB_SHA` | `GITHUB_REF` | +| --------------------------------------------------------- | ----------------------------------------------------------------- | --------------------------------- | --------------- | +| [`issue_comment`](/rest/reference/activity#issue_comment) | - `created`
    - `edited`
    - `deleted`
    | Letzter Commit im Standard-Branch | Standard-Branch | {% data reusables.developer-site.limit_workflow_to_activity_types %} @@ -265,7 +376,7 @@ on: #### `page_build` -Führt den Workflow aus, wenn ein Benutzer einen Push an einen {% data variables.product.product_name %}-Pages-fähigen Branch vornimmt, wodurch das Ereignis `page_build` ausgelöst wird. For information about the REST API, see "[Pages](/v3/repos/pages/)." +Führt den Workflow aus, wenn ein Benutzer einen Push an einen {% data variables.product.product_name %}-Pages-fähigen Branch vornimmt, wodurch das Ereignis `page_build` ausgelöst wird. For information about the REST API, see "[Pages](/rest/reference/repos#pages)." {% data reusables.github-actions.branch-requirement %} @@ -489,9 +600,9 @@ on: Führt den Workflow aus, wenn das Ereignis `release` eintritt. {% data reusables.developer-site.multiple_activity_types %} For information about the REST API, see "[Releases](/v3/repos/releases/)." -| Nutzlast des Webhook-Ereignisses | Aktivitätstypen | `GITHUB_SHA` | `GITHUB_REF` | -| ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ | --------------------- | -| [`Release`](/webhooks/event-payloads/#release) | - `published`{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}
    - `unpublished`
    - `created`
    - `edited`
    - `deleted`
    - `prereleased`
    - `released`{% endif %} | Letzter Commit in der Tag-Veröffentlichung | Veröffentlichungs-Tag | +| Nutzlast des Webhook-Ereignisses | Aktivitätstypen | `GITHUB_SHA` | `GITHUB_REF` | +| ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ | --------------------- | +| [`Release`](/webhooks/event-payloads/#release) | - `published`
    - `unpublished`
    - `created`
    - `edited`
    - `deleted`
    - `prereleased`
    - `released` | Letzter Commit in der Tag-Veröffentlichung | Veröffentlichungs-Tag | {% data reusables.developer-site.limit_workflow_to_activity_types %} @@ -558,85 +669,6 @@ on: - requested ``` -### Geplante Ereignisse - -The `schedule` event allows you to trigger a workflow at a scheduled time. - -#### `Zeitplan` - -| Nutzlast des Webhook-Ereignisses | Aktivitätstypen | `GITHUB_SHA` | `GITHUB_REF` | -| -------------------------------- | --------------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| – | – | Letzter Commit im Standard-Branch | Standardbranch | Zeitpunkt, zu dem der geplante Workflow ausgeführt werden soll. Für einen geplanten Workflow gilt die [POSIX-Cron-Syntax](https://pubs.opengroup.org/onlinepubs/9699919799/utilities/crontab.html#tag_20_25_07). Weitere Informationen finden Sie unter „[Einen Workflow mit Ereignissen auslösen](/articles/configuring-a-workflow/#triggering-a-workflow-with-events)“. | - -{% data reusables.repositories.actions-scheduled-workflow-example %} - -Die Cron-Syntax umfasst fünf durch Leerzeichen getrennte Felder, die jeweils eine Zeiteinheit darstellen. - -``` -┌───────────── Minute (0–59) -│ ┌───────────── Stunde (0–23) -│ │ ┌───────────── Tag (1–31) -│ │ │ ┌───────────── Monat (1–12 oder JAN–DEZ) -│ │ │ │ ┌───────────── Wochentag (0–6 oder SON–SAM) -│ │ │ │ │ -│ │ │ │ │ -│ │ │ │ │ -* * * * * -``` - -In den fünf Feldern stehen die folgenden Operatoren zur Auswahl: - -| Operator | Beschreibung | Beispiel | -| -------- | -------------------------- | ------------------------------------------------------------------------------------------------------------- | -| * | Beliebiger Wert | `* * * * *` wird jeden Tag jede Minute ausgeführt. | -| , | Trennzeichen in Werteliste | `2,10 4,5 * * *` wird jeden Tag bei Minute 2 und 10 der 4. und 5. Stunde ausgeführt. | -| - | Wertebereich | `0 4-6 * * *` wird bei Minute 0 der 4., 5. und 6. Stunde ausgeführt. | -| / | Schrittwerte | `20/15 * * * *` wird alle 15 Minuten ausgeführt, von Minute 20 bis Minute 59 (also bei Minute 20, 35 und 50). | - -{% note %} - -**Hinweis:** {% data variables.product.prodname_actions %} bietet keine Unterstützung für die nicht standardmäßige Syntax `@yearly`, `@monthly`, `@weekly`, `@daily`, `@hourly` und `@reboot`. - -{% endnote %} - -Mit [crontab guru](https://crontab.guru/) können Sie die Cron-Syntax erzeugen und den Ausführungszeitpunkt bestätigen. Als Einstiegshilfe steht eine Liste mit [crontab-guru-Beispielen](https://crontab.guru/examples.html) bereit. - -### Manual events - -You can manually trigger workflow runs. To trigger specific workflows in a repository, use the `workflow_dispatch` event. To trigger more than one workflow in a repository and create custom events and event types, use the `repository_dispatch` event. - -#### `workflow_dispatch` - -| Nutzlast des Webhook-Ereignisses | Aktivitätstypen | `GITHUB_SHA` | `GITHUB_REF` | -| ---------------------------------------------------------------- | --------------- | ------------------------------------- | -------------------------------------- | -| [workflow_dispatch](/webhooks/event-payloads/#workflow_dispatch) | – | Letzter Commit im Branch `GITHUB_REF` | Branch, der den Dispatch empfangen hat | - -You can manually trigger a workflow run using the {% data variables.product.prodname_dotcom %} API and from {% data variables.product.prodname_dotcom %}. To trigger the custom `workflow_dispatch` webhook event using the REST API, you must send a `POST` request to a {% data variables.product.prodname_dotcom %} API endpoint and provide the `ref` and any required `inputs`. For more information, see the "[Create a workflow dispatch event](/rest/reference/actions/#create-a-workflow-dispatch-event)" REST API endpoint. - - When you trigger the event on {% data variables.product.prodname_dotcom %}, you can provide the `ref` and any `inputs` directly on {% data variables.product.prodname_dotcom %}. Weitere Informationen findest Du unter „[Einen Workflow konfigurieren](/actions/configuring-and-managing-workflows/configuring-a-workflow#manually-running-a-workflow)“. - -#### `repository_dispatch` - -| Nutzlast des Webhook-Ereignisses | Aktivitätstypen | `GITHUB_SHA` | `GITHUB_REF` | -| -------------------------------------------------------------------- | --------------- | ------------------------------------- | -------------------------------------- | -| [repository_dispatch](/webhooks/event-payloads/#repository_dispatch) | – | Letzter Commit im Branch `GITHUB_REF` | Branch, der den Dispatch empfangen hat | - -{% data reusables.github-actions.branch-requirement %} - -Mit der {% data variables.product.product_name %}-API können Sie das Webhook-Ereignis [`repository_dispatch`](/webhooks/event-payloads/#repository_dispatch) auslösen, wenn ein Workflow für eine Aktivität ausgelöst werden soll, die außerhalb von {% data variables.product.prodname_dotcom %} abläuft. Weitere Informationen finden Sie unter "[Erstellen eines Repository-Dispatchereignisses](/v3/repos/#create-a-repository-dispatch-event)." - -Soll das benutzerdefinierte Webhook-Ereignis `repository_dispatch` ausgelöst werden, senden Sie eine `POST`-Anfrage an einen {% data variables.product.product_name %}-API-Endpunkt, und geben Sie den Namen für einen `event_type` als Beschreibung für den Aktivitätstyp an. Soll ein Workflow-Lauf ausgelöst werden, konfigurieren Sie außerdem den Workflow für die Verwendung des Ereignisses `repository_dispatch`. - -##### Beispiel - -Standardmäßig lösen alle `event_types` einen Workflow aus. Du kannst Deinen Workflow darauf beschränken, zu laufen, wenn ein bestimmter Wert als `event_type` in der Webhoo-Nutzlast des `repository_dispatch` gesendet wird. Du definierst die Ereignistypen, die in der Nutzlast des `repository_dispatch` gesendet werden, wenn Du das Repositorydispatch-Ereignis erstellst. - -```yaml -on: - repository_dispatch: - types: [opened, deleted] -``` - ### Neue Workflows mit einem persönlichen Zugangs-Token auslösen {% data reusables.github-actions.actions-do-not-trigger-workflows %} weitere Informationen findest Du unter „[Authentifizierung mit dem GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)“. diff --git a/translations/de-DE/content/actions/reference/index.md b/translations/de-DE/content/actions/reference/index.md index 450ac5d8f1aa..f2d5d6b2469f 100644 --- a/translations/de-DE/content/actions/reference/index.md +++ b/translations/de-DE/content/actions/reference/index.md @@ -1,6 +1,8 @@ --- title: Referenz -intro: 'Referenzdokumentation zum Bauen von Aktionen, zum Erstellen von Workflows und zu anderen Tools sowie weitere Informationen zu {% data variables.product.prodname_actions %}.' +intro: 'Reference documentation for creating workflows, using GitHub-hosted runners, and authentication.' +redirect_from: + - /actions/configuring-and-managing-workflows/using-variables-and-secrets-in-a-workflow versions: free-pro-team: '*' enterprise-server: '>=2.22' @@ -9,9 +11,39 @@ versions: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} +### Syntax für Workflows + +The workflow file is written in YAML. In the YAML workflow file, you can use expression syntax to evaluate contextual information, literals, operators, and functions. Contextual information includes workflow, environment variables, secrets, and the events that triggered the workflow. When you use [`run`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun) in a workflow step to run shell commands, you can use specific workflow command syntax to set environment variables, set output parameters for subsequent steps, and set error or debug messages. + {% link_in_list /workflow-syntax-for-github-actions %} -{% link_in_list /events-that-trigger-workflows %} {% link_in_list /context-and-expression-syntax-for-github-actions %} {% link_in_list /workflow-commands-for-github-actions %} -{% link_in_list /virtual-environments-for-github-hosted-runners %} -{% link_in_list /software-installed-on-github-hosted-runners %} + +### Ereignisse + +You can configure workflows to run when specific GitHub events occur, at a scheduled time, manually, or when events outside of GitHub occur. + +{% link_in_list /events-that-trigger-workflows %} + +### Authentication and secrets + +{% data variables.product.prodname_dotcom %} stellt ein Token zur Verfügung, mit dem Du Dich im Namen von {% data variables.product.prodname_actions %} authentifizieren kannst. You can also store sensitive information as a secret in your organization or repository. {% data variables.product.prodname_dotcom %} encrypts all secrets. + +{% link_in_list /authentication-in-a-workflow %} +{% link_in_list /encrypted-secrets %} + +### {% data variables.product.prodname_dotcom %}-gehostete Runner + +GitHub offers hosted virtual machines to run workflows. The virtual machine contains an environment with tools, packages, and environment variables for GitHub Actions to use. + +{% link_in_list /environment-variables %} +{% link_in_list /specifications-for-github-hosted-runners %} + +{% if currentVersion == "free-pro-team@latest" %} +### Administration + +When you run workflows on {% data variables.product.prodname_dotcom %}-hosted runners, there are usage limits and potential usage charges. You can also disable or restrict the usage of {% data variables.product.prodname_actions %} in a repository and organization. + +{% link_in_list /usage-limits-billing-and-administration %} + +{% endif %} diff --git a/translations/de-DE/content/actions/reference/specifications-for-github-hosted-runners.md b/translations/de-DE/content/actions/reference/specifications-for-github-hosted-runners.md new file mode 100644 index 000000000000..edb3413aeb11 --- /dev/null +++ b/translations/de-DE/content/actions/reference/specifications-for-github-hosted-runners.md @@ -0,0 +1,149 @@ +--- +title: Specifications for GitHub-hosted runners +intro: '{% data variables.product.prodname_dotcom %} bietet gehostete virtuelle Maschinen, um Workflows auszuführen. Die virtuelle Maschine umfasst eine Umgebung mit Tools, Paketen und Einstellungen für {% data variables.product.prodname_actions %}.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /articles/virtual-environments-for-github-actions + - /github/automating-your-workflow-with-github-actions/virtual-environments-for-github-actions + - /github/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners + - /actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners + - /actions/reference/virtual-environments-for-github-hosted-runners + - /actions/reference/software-installed-on-github-hosted-runners +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Informationen zu {% data variables.product.prodname_dotcom %}-gehosteten Runnern + +Ein {% data variables.product.prodname_dotcom %}-gehosteter Runner ist eine virtuelle Maschine, die von {% data variables.product.prodname_dotcom %} gehostet wird und auf der die Runner-Anwendung der {% data variables.product.prodname_actions %} installiert ist. {% data variables.product.prodname_dotcom %} bietet Runner mit den Betriebssystemen Linux, Windows und MacOS. + +Wenn Du einen {% data variables.product.prodname_dotcom %}-gehosteten Runner verwendest, werden Wartung und Upgrade der Maschine für Dich erledigt. Sie können Workflows direkt auf der virtuellen Maschine oder in einem Docker-Container ausführen. + +Du kannst in einem Workflow für jeden Job die Art des Runners festlegen. Jeder Job in einem Workflow wird in einer neuen Instanz der virtuellen Maschine ausgeführt. Alle Schritte des Jobs werden in derselben Instanz der virtuellen Maschine ausgeführt, sodass die Aktionen in diesem Job über das Dateisystem Informationen austauschen können. + +{% data reusables.github-actions.runner-app-open-source %} + +#### Cloud-Hosts für {% data variables.product.prodname_dotcom %}-gehostete Runner + +{% data variables.product.prodname_dotcom %} betreibt Linux- und Windows-Runner auf den virtuellen Maschinen nach Standard_DS2_v2 in Microsoft Azure, auf denen die Runner-Anwendung der {% data variables.product.prodname_actions %} installiert ist. Die Runner-Anwendung auf {% data variables.product.prodname_dotcom %}-gehosteten Runnern ist eine Fork-Kopie des Azure-Pipelines-Agenten. Bei Azure werden eingehende ICMP-Pakete werden für alle virtuellen Maschinen blockiert, so dass die Befehle ping und traceroute möglicherweise nicht funktionieren. Weitere Informationen zu den Ressourcen der Standard_DS2_v2-Maschinen findest Du unter „[Serien Dv2 und DSv2](https://docs.microsoft.com/en-us/azure/virtual-machines/dv2-dsv2-series#dsv2-series)“ in der Dokumentation zu Microsoft Azure. + +{% data variables.product.prodname_dotcom %} verwendet [MacStadium](https://www.macstadium.com/), um die virtuellen macOS-Runner zu betreiben. + +#### Administrative Rechte von {% data variables.product.prodname_dotcom %}-gehosteten Runnern + +Die virtuellen Maschinen unter Linux und macOS werden beide mit dem passwortlosen Befehl `sudo` ausgeführt. Wenn Sie Befehle ausführen oder Tools installieren müssen, die höhere Berechtigungen als der aktuelle Benutzer erfordern, können Sie `sudo` verwenden, ohne ein Passwort angeben zu müssen. Weitere Informationen findest Du im „[Sudo-Handbuch](https://www.sudo.ws/man/1.8.27/sudo.man.html)“. + +Die virtuellen Windows-Maschinen sind so konfiguriert, dass sie als Administratoren laufen, wobei die Benutzerkonten-Steuerung (UAC) deaktiviert ist. Weitere Informationen findest Du unter „[Funktionsweise der Benutzerkonten-Steuerung](https://docs.microsoft.com/de-de/windows/security/identity-protection/user-account-control/how-user-account-control-works)“ in der Dokumentation zu Windows. + +### Unterstützte Runner und Hardwareressourcen + +Für jede virtuelle Maschine stehen die gleichen Hardware-Ressourcen zur Verfügung. + +- CPU mit 2 Kernen +- 7 GB RAM-Speicher +- 14 GB SSD-Festplattenspeicher + +{% data reusables.github-actions.supported-github-runners %} + +{% data reusables.github-actions.ubuntu-runner-preview %} + +Workflow logs list the runner used to run a job. For more information, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)." + +### Supported software + +The software tools included in {% data variables.product.prodname_dotcom %}-hosted runners are updated weekly. Die neueste Liste der mitgelieferten Werkzeuge für jedes Runner-Betriebssystem findest Du unter den folgenden Links: + +* [Ubuntu 20.04 LTS](https://github.com/actions/virtual-environments/blob/main/images/linux/Ubuntu2004-README.md) +* [Ubuntu 18.04 LTS](https://github.com/actions/virtual-environments/blob/main/images/linux/Ubuntu1804-README.md) +* [Ubuntu 16.04 LTS](https://github.com/actions/virtual-environments/blob/main/images/linux/Ubuntu1604-README.md) +* [Windows Server 2019](https://github.com/actions/virtual-environments/blob/main/images/win/Windows2019-Readme.md) +* [Windows Server 2016](https://github.com/actions/virtual-environments/blob/main/images/win/Windows2016-Readme.md) +* [MacOS 10.15](https://github.com/actions/virtual-environments/blob/main/images/macos/macos-10.15-Readme.md) + +{% data reusables.github-actions.ubuntu-runner-preview %} + +{% data variables.product.prodname_dotcom %}-gehostete Runner enthalten zusätzlich zu den oben aufgeführten Paketen die standardmäßig integrierten Tools des Betriebssystems. Zum Beispiel beinhalten Ubuntu und macOS Läufer `grep`, `find`, und `which` neben anderen Standard-Tools. + +Workflow logs include a link to the preinstalled tools on the runner. For more information, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)." + +Wenn Sie ein bestimmtes Tool anfordern möchten, öffnen Sie bitte einen Issue unter [actions/virtual-environments](https://github.com/actions/virtual-environments). + +### IP addresses + +{% note %} + +**Notiz:** Wenn Du eine Liste mit erlaubten IP-Adressen für Dein Organisations- oder Unternehmenskonto auf {% data variables.product.prodname_dotcom %} verwendest, kannst Du keine {% data variables.product.prodname_dotcom %}-gehosteten Runner verwenden, sondern benötigst stattdessen selbst-gehostete Runner. Weitere Informationen findest Du unter „[Informationen zu selbst-gehosteten Runnern](/actions/hosting-your-own-runners/about-self-hosted-runners)“. + +{% endnote %} + +Windows- und Ubuntu-Runner werden in Azure gehostet und haben die gleichen IP-Adressbereiche wie Azure-Rechenzentren. Derzeit befinden sich alle {% data variables.product.prodname_dotcom %}-gehosteten Windows- und Ubuntu-Runner in den folgenden Azure-Regionen: + +- Ost-USA (`eastus`) +- Ost-USA 2 (`eastus`) +- West-US 2 (`westus2`) +- Zentral-USA (`centralus`) +- Süd-Zentral-USA (`southcentralus`) + +Microsoft aktualisiert die Azure-IP-Adressbereiche wöchentlich in einer JSON-Datei. Diese können Sie auf der Website [Azure IP Ranges and Service Tags - Public Cloud](https://www.microsoft.com/en-us/download/details.aspx?id=56519) herunterladen. Sie können diesen IP-Adressbereich verwenden, falls Sie eine Positivliste vorschreiben, um den nicht autorisierten Zugriff auf Ihre internen Ressourcen zu verhindern. + +Die JSON-Datei enthält einen Array mit der Bezeichnung `values`. Innerhalb dieses Arrays findest Du die unterstützten IP-Adressen in einem Objekt mit `name` und `id` der Azure-Region, z.B. `"AzureCloud.eastus2"`. + +Die unterstützten IP-Adressbereiche befinden sich im Objekt `"addressPrefixes"`. Dies ist ein komprimiertes Beispiel der JSON-Datei. + +```json +{ + "changeNumber": 84, + "cloud": "Public", + "values": [ + { + "name": "AzureCloud.eastus2", + "id": "AzureCloud.eastus2", + "properties": { + "changeNumber": 33, + "region": "eastus2", + "platform": "Azure", + "systemService": "", + "addressPrefixes": [ + "13.68.0.0/17", + "13.77.64.0/18", + "13.104.147.0/25", + ... + ] + } + } + ] +} +``` + +### File systems + +{% data variables.product.prodname_dotcom %} führt Aktionen und Shell-Befehle in bestimmten Verzeichnissen auf der virtuellen Maschine aus. Die Dateipfade auf virtuellen Maschinen sind nicht statisch. Verwende die von {% data variables.product.prodname_dotcom %} bereitgestellten Umgebungsvariablen zum Erstellen von Dateipfaden für die Verzeichnisse `home`, `workspace`und `workflow`. + +| Verzeichnis | Umgebungsvariable | Beschreibung | +| --------------------- | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `home` | `HOME` | Enthält benutzerbezogene Daten. In diesem Verzeichnis können sich beispielsweise die Anmeldeinformation aus einem Anmeldeversuch befinden. | +| `workspace` | `GITHUB_WORKSPACE` | Aktionen und Shell-Befehle werden in diesem Verzeichnis ausgeführt. Eine Aktion kann den Inhalt dieses Verzeichnisses ändern, auf den dann nachfolgende Aktionen zugreifen können. | +| `workflow/event.json` | `GITHUB_EVENT_PATH` | Die `POST`-Nutzlast des Webhook-Ereignisses, das den Workflow ausgelöst hat. {% data variables.product.prodname_dotcom %} schreibt dies bei jeder ausgeführten Aktion neu, sodass der Dateiinhalt zwischen den Aktionen isoliert wird. | + +Eine Liste der von {% data variables.product.prodname_dotcom %} für jeden Workflow erstellten Umgebungsvariablen findest Du unter „[Umgebungsvariablen verwenden](/github/automating-your-workflow-with-github-actions/using-environment-variables)“. + +#### Docker-Container-Dateisystem + +Für Aktionen, die in Docker-Containern ausgeführt werden, befinden sich statische Verzeichnisse im Pfad `/github`. Wir empfehlen jedoch dringend, die Standard-Umgebungsvariablen zu verwenden, um Dateipfade in Docker-Containern zu erstellen. + +In {% data variables.product.prodname_dotcom %} wird das Pfadpräfix `/github` reserviert, und es werden drei Verzeichnisse für Aktionen erstellt. + +- `/github/home` +- `/github/workspace` - {% data reusables.repositories.action-root-user-required %} +- `/github/workflow` + +{% if currentVersion == "free-pro-team@latest" %} + +### Weiterführende Informationen +- „[Abrechnung für {{ site.data.variables.product.prodname_actions }} verwalten](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)“ + +{% endif %} diff --git a/translations/de-DE/content/actions/reference/usage-limits-billing-and-administration.md b/translations/de-DE/content/actions/reference/usage-limits-billing-and-administration.md new file mode 100644 index 000000000000..f8e212f33525 --- /dev/null +++ b/translations/de-DE/content/actions/reference/usage-limits-billing-and-administration.md @@ -0,0 +1,88 @@ +--- +title: 'Usage limits, billing, and administration' +intro: 'There are usage limits for {% data variables.product.prodname_actions %} workflows. Usage charges apply to repositories that go beyond the amount of free minutes and storage for a repository.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /actions/getting-started-with-github-actions/usage-and-billing-information-for-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Informationen zur Abrechnung für {% data variables.product.prodname_actions %} + +{% if currentVersion == "free-pro-team@latest" %} +{% data reusables.github-actions.actions-billing %} Weitere Informationen findest Du unter „[Informationen zur Abrechnung für {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions)“. +{% else %} +GitHub Actions usage is free for +{% data variables.product.prodname_ghe_server %} that use self-hosted runners. +{% endif %} + +### Nutzungseinschränkungen + +{% if currentVersion == "free-pro-team@latest" %} +There are some limits on +{% data variables.product.prodname_actions %} usage when using {% data variables.product.prodname_dotcom %}-hosted runners. Die Einschränkungen können sich jederzeit ändern. + +{% note %} + +**Note:** For self-hosted runners, different usage limits apply. Weitere Informationen findest Du unter „[Informationen zu selbst-gehosteten Runnern](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)“. + +{% endnote %} + +- **Job execution time** (Auftrags-Ausführungszeit) - Jeder Job in einem Workflow kann bis zu 6 Stunden Ausführungszeit laufen. Wenn ein Auftrag dieses Limit erreicht, wird der Auftrag beendet und kann nicht abgeschlossen werden. +{% data reusables.github-actions.usage-workflow-run-time %} +{% data reusables.github-actions.usage-api-requests %} +- **Concurrent Jobs** (parallele Aufträge) - Die Anzahl paralleler Aufträge, die Du in Ihrem Konto ausführen kannst, hängt von Deinem GitHub-Plan ab, wie in der folgenden Tabelle ersichtlich. Bei Überschreitung werden alle zusätzlichen Aufträge in die Warteschlange gestellt. + + | GitHub Plan | Total parallele Aufträge | Maximal parallele macOS-Aufträge | + | ----------- | ------------------------ | -------------------------------- | + | Kostenlos | 20 | 5 | + | Pro | 40 | 5 | + | Team | 60 | 5 | + | Enterprise | 180 | 50 | +- **Auftrags-Matrix** - {% data reusables.github-actions.usage-matrix-limits %} +{% else %} +Usage limits apply to self-hosted runners. Weitere Informationen findest Du unter „[Informationen zu selbst-gehosteten Runnern](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)“. +{% endif %} + +{% if currentVersion == "free-pro-team@latest" %} +### Nutzungsrichtlinien +In addition to the usage limits, you must ensure that you use + +{% data variables.product.prodname_actions %} within the [GitHub Terms of Service](/articles/github-terms-of-service/). Weitere Informationen zu {% data variables.product.prodname_actions %}-spezifischen Bedingungen findest Du unter [Zusätzliche Produktbedingungen für GitHub](/github/site-policy/github-additional-product-terms#a-actions-usage). +{% endif %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +### Artifact and log retention policy + +You can configure the artifact and log retention period for your repository, organization, or enterprise account. + +{% data reusables.actions.about-artifact-log-retention %} + +Weitere Informationen findest Du unter: + +- [Configuring the retention period for {% data variables.product.prodname_actions %} for artifacts and logs in your repository](/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository) +- [Configuring the retention period for {% data variables.product.prodname_actions %} for artifacts and logs in your organization](/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization) +- [Configuring the retention period for {% data variables.product.prodname_actions %} for artifacts and logs in your enterprise](/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account) +{% endif %} + +### {% data variables.product.prodname_actions %} für Dein Repository oder Deine Organisation deaktivieren oder beschränken + +{% data reusables.github-actions.disabling-github-actions %} + +Weitere Informationen findest Du unter: +- "[Disabling or limiting {% data variables.product.prodname_actions %} for a repository](/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository)" +- "[Disabling or limiting {% data variables.product.prodname_actions %} for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization)"{% if currentVersion == "free-pro-team@latest" %} +- "[Enforcing {% data variables.product.prodname_actions %} policies in your enterprise account](/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account)" for {% data variables.product.prodname_ghe_cloud %}{% endif %} + +### Disabling and enabling workflows + +You can enable and disable individual workflows in your repository on {% data variables.product.prodname_dotcom %}. + +{% data reusables.actions.scheduled-workflows-disabled %} + +For more information, see "[Disabling and enabling a workflow](/actions/managing-workflow-runs/disabling-and-enabling-a-workflow)." diff --git a/translations/de-DE/content/actions/reference/workflow-commands-for-github-actions.md b/translations/de-DE/content/actions/reference/workflow-commands-for-github-actions.md index e509a8a5b91c..86916dd1ce38 100644 --- a/translations/de-DE/content/actions/reference/workflow-commands-for-github-actions.md +++ b/translations/de-DE/content/actions/reference/workflow-commands-for-github-actions.md @@ -1,7 +1,7 @@ --- title: Workflow-Befehle für GitHub-Aktionen shortTitle: Workflow-Befehle -intro: 'Du kannst Workflow-Befehle verwenden, wenn Du Shell-Befehle in einem Workflow oder im Code einer Aktion ausführst.' +intro: Du kannst Workflow-Befehle verwenden, wenn Du Shell-Befehle in einem Workflow oder im Code einer Aktion ausführst. product: '{% data reusables.gated-features.actions %}' redirect_from: - /articles/development-tools-for-github-actions @@ -21,7 +21,11 @@ versions: Aktionen können mit dem Runner-Rechner kommunizieren, um Umgebungsvariablen zu setzen, Werte zur Verwendung in anderen Aktionen auszugeben, Debug-Meldungen zu den Ausgabeprotokollen zuzufügen und für andere Zwecke. +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +Most workflow commands use the `echo` command in a specific format, while others are invoked by writing to a file. For more information, see ["Environment files".](#environment-files) +{% else %} Workflow-Befehle verwenden den Befehl `echo` in einem bestimmten Format. +{% endif %} ``` bash echo "::workflow-command parameter1={data},parameter2={data}::{command value}" @@ -41,40 +45,46 @@ echo "::workflow-command parameter1={data},parameter2={data}::{command value}" ### Workflow-Befehle verwenden, um auf Funktionen des Toolkits zuzugreifen -Das [actions/toolkit](https://github.com/actions/toolkit) enthält eine Reihe von Funktionen, die als Workflow-Befehle ausgeführt werden können. Verwende die Syntax `::`, um die Workflow-Befehle in Deiner YAML-Datei auszuführen. Diese Befehle werden dann über `stdout` an den Runner gesandt. Anstatt beispielsweise zum Setzen einer Umgebungsvariablen Code folgendermaßen zu verwenden: +Das [actions/toolkit](https://github.com/actions/toolkit) enthält eine Reihe von Funktionen, die als Workflow-Befehle ausgeführt werden können. Verwende die Syntax `::`, um die Workflow-Befehle in Deiner YAML-Datei auszuführen. Diese Befehle werden dann über `stdout` an den Runner gesandt. For example, instead of using code to set an output, as below: ```javascript -core.exportVariable('SELECTED_COLOR', 'green'); +core.setOutput('SELECTED_COLOR', 'green'); ``` -kannst Du den Befehl `set-env` in Deinem Workflow verwenden, um den gleichen Wert zu setzen: +You can use the `set-output` command in your workflow to set the same value: ``` yaml - name: Set selected color - run: echo '::set-env name=SELECTED_COLOR::green' + run: echo '::set-output name=SELECTED_COLOR::green' + id: random-color-generator - name: Get color - run: echo 'The selected color is' $SELECTED_COLOR + run: echo 'The selected color is' ${steps.random-color-generator.outputs.SELECTED_COLOR} ``` Die folgende Tabelle zeigt, welche Toolkit-Funktionen innerhalb eines Workflows verfügbar sind: -| Toolkit-Funktion | Äquivalenter Workflow-Befehl | -| --------------------- | ------------------------------------------------------- | -| `core.addPath` | `add-path` | -| `core.debug` | `debug` | -| `core.error` | `error` | -| `core.endGroup` | `endgroup` | -| `core.exportVariable` | `set-env` | -| `core.getInput` | Zugänglich durch Umgebungsvariable `INPUT_{NAME}` | -| `core.getState` | Zugänglich durch Umgebungsvariable `STATE_{NAME}` | -| `core.isDebug` | Zugänglich durch Umgebungsvariable `RUNNER_DEBUG` | -| `core.saveState` | `save-state` | -| `core.setFailed` | Wird als Abkürzung für `::error` und `exit 1` verwendet | -| `core.setOutput` | `set-output` | -| `core.setSecret` | `add-mask` | -| `core.startGroup` | `Gruppe` | -| `core.warning` | `warning file` | - +| Toolkit-Funktion | Äquivalenter Workflow-Befehl | +| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | +| `core.addPath` | | +| {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}Accessible using environment file `GITHUB_PATH`{% else %} `add-path` {% endif %} | | +| | | +| `core.debug` | `debug` | +| `core.error` | `error` | +| `core.endGroup` | `endgroup` | +| `core.exportVariable` | | +| {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}Accessible using environment file `GITHUB_ENV`{% else %} `set-env` {% endif %} | | +| | | +| `core.getInput` | Zugänglich durch Umgebungsvariable `INPUT_{NAME}` | +| `core.getState` | Zugänglich durch Umgebungsvariable `STATE_{NAME}` | +| `core.isDebug` | Zugänglich durch Umgebungsvariable `RUNNER_DEBUG` | +| `core.saveState` | `save-state` | +| `core.setFailed` | Wird als Abkürzung für `::error` und `exit 1` verwendet | +| `core.setOutput` | `set-output` | +| `core.setSecret` | `add-mask` | +| `core.startGroup` | `Gruppe` | +| `core.warning` | `warning file` | + +{% if currentVersion ver_lt "enterprise-server@2.23" %} ### Setting an environment variable `::set-env name={name}::{value}` @@ -86,6 +96,7 @@ Erstellt oder aktualisiert eine Umgebungsvariable für alle Aktionen, die als n ``` bash echo "::set-env name=action_state::yellow" ``` +{% endif %} ### Setting an output parameter @@ -101,6 +112,7 @@ Optional kannst Du auch Ausgabeparameter in der Metadaten-Datei einer Aktion dek echo "::set-output name=action_fruit::strawberry" ``` +{% if currentVersion ver_lt "enterprise-server@2.23" %} ### Adding a system path `::add-path::{path}` @@ -112,12 +124,13 @@ Fügt für alle nachfolgenden Aktionen im aktuellen Auftrag vor der Systemvariab ``` bash echo "::add-path::/path/to/dir" ``` +{% endif %} ### Setting a debug message `::debug::{message}` -Gibt eine Debugging-Meldung im Protokoll aus. Sie müssen ein Geheimnis mit dem Namen `ACTIONS_STEP_DEBUG` und dem Wert `true` erstellen, um die durch diesen Befehl festgelegten Debugging-Meldungen im Protokoll zu sehen. Weitere Informationen findest Du unter „[Eine Workflow-Ausführung verwalten](/actions/configuring-and-managing-workflows/managing-a-workflow-run#enabling-debug-logging)“. +Gibt eine Debugging-Meldung im Protokoll aus. Sie müssen ein Geheimnis mit dem Namen `ACTIONS_STEP_DEBUG` und dem Wert `true` erstellen, um die durch diesen Befehl festgelegten Debugging-Meldungen im Protokoll zu sehen. For more information, see "[Enabling debug logging](/actions/managing-workflow-runs/enabling-debug-logging)." #### Beispiel @@ -213,3 +226,67 @@ Die Variable `STATE_processID` ist dann exklusiv für das Bereinigungsskript ver ``` javascript console.log("The running PID from the main action is: " + process.env.STATE_processID); ``` + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +## Environment Files + +During the execution of a workflow, the runner generates temporary files that can be used to perform certain actions. The path to these files are exposed via environment variables. You will need to use UTF-8 encoding when writing to these files to ensure proper processing of the commands. Multiple commands can be written to the same file, separated by newlines. + +{% warning %} + +**Warning:** Powershell does not use UTF-8 by default. Make sure you write files using the correct encoding. For example, you need to set UTF-8 encoding when you set the path: + +``` +steps: + - run: echo "mypath" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append +``` + +{% endwarning %} + +### Setting an environment variable + +`echo "{name}={value}" >> $GITHUB_ENV` + +Erstellt oder aktualisiert eine Umgebungsvariable für alle Aktionen, die als nächstes in einem Auftrag ausgeführt werden. Die Aktion, die die Umgebungsvariable erstellt oder aktualisiert, kann nicht auf den neuen Wert zugreifen; alle nachfolgenden Aktionen in einem Auftrag haben dagegen Zugriff auf den neuen Wert. Bei Umgebungsvariablen wird die Groß- und Kleinschreibung berücksichtigt. Sie können auch Satzzeichen enthalten. + +#### Beispiel + +```bash +echo "action_state=yellow" >> $GITHUB_ENV +``` + +Running `$action_state` in a future step will now return `yellow` + +#### Multline strings +For multiline strings, you may use a delimiter with the following syntax. + +``` +{name}<<{delimiter} +{value} +{delimiter} +``` + +#### Beispiel +In this example, we use `EOF` as a delimiter and set the `JSON_RESPONSE` environment variable to the value of the curl response. +``` +steps: + - name: Set the value + id: step_one + run: | + echo 'JSON_RESPONSE<> $GITHUB_ENV + curl https://httpbin.org/json >> $GITHUB_ENV + echo 'EOF' >> $GITHUB_ENV +``` + +### Adding a system path + +`echo "{path}" >> $GITHUB_PATH` + +Fügt für alle nachfolgenden Aktionen im aktuellen Auftrag vor der Systemvariablen `PATH` ein Verzeichnis hinzu. Die gerade ausgeführte Aktion kann nicht auf die neue Pfadvariable zugreifen. + +#### Beispiel + +``` bash +echo "/path/to/dir" >> $GITHUB_PATH +``` +{% endif %} diff --git a/translations/de-DE/content/actions/reference/workflow-syntax-for-github-actions.md b/translations/de-DE/content/actions/reference/workflow-syntax-for-github-actions.md index 112a0983ada3..a7de591baf01 100644 --- a/translations/de-DE/content/actions/reference/workflow-syntax-for-github-actions.md +++ b/translations/de-DE/content/actions/reference/workflow-syntax-for-github-actions.md @@ -1,7 +1,7 @@ --- title: Workflow-Syntax für GitHub Actions shortTitle: Syntax für Workflows -intro: 'Ein Workflow ist ein konfigurierbarer automatisierter Prozess, der aus einem oder mehreren Jobs besteht. Du musst eine YAML-Datei erstellen, um Deine Workflow-Konfiguration zu definieren.' +intro: Ein Workflow ist ein konfigurierbarer automatisierter Prozess, der aus einem oder mehreren Jobs besteht. Du musst eine YAML-Datei erstellen, um Deine Workflow-Konfiguration zu definieren. product: '{% data reusables.gated-features.actions %}' redirect_from: - /articles/workflow-syntax-for-github-actions @@ -21,10 +21,6 @@ Workflow-Dateien verwenden die YAML-Syntax und müssen die Dateierweiterung `.ym Workflow-Dateien müssen im Verzeichnis `.github/workflows` im Repository gespeichert werden. -### Nutzungseinschränkungen - -{% data reusables.github-actions.github-actions-usage-limits %} - ### **`name`** Name des Workflows. {% data variables.product.prodname_dotcom %} zeigt die Namen der Workflows auf der Repository-Seite der Aktionen an. Wenn Du `name`weglässt, setzt {% data variables.product.prodname_dotcom %} den Pfad der Workflow-Datei relativ zum Stammverzeichnis des Repositorys. @@ -62,18 +58,18 @@ Die in `branches` und `tags` definierten Muster werden anhand des Namens des Git ```yaml on: push: - # Folge von Mustern zum Abgleich mit refs/heads + # Sequence of patterns matched against refs/heads branches: - # Push-Ereignisse auf den Master-Branch - - master - # Push-Ereignisse auf Branches, die zu refs/heads/mona/octocat passen + # Push events on main branch + - main + # Push events to branches matching refs/heads/mona/octocat - 'mona/octocat' - # Push-Ereignisse auf Branches, die zu refs/heads/releases/10 passen + # Push events to branches matching refs/heads/releases/10 - 'releases/**' - # Folge von Mustern zum Abgleich mit refs/tags + # Sequence of patterns matched against refs/tags tags: - - v1 # Push-Ereignisse auf den Tag v1 - - v1.* # Push-Ereignisse auf die Tags v1.0, v1.1 und v1.9 + - v1 # Push events to v1 tag + - v1.* # Push events to v1.0, v1.1, and v1.9 tags ``` #### Beispiel zum Ignorieren von Branches und Tags @@ -229,7 +225,7 @@ Ein Workflow-Lauf besteht aus mindestens einem Auftrag. Die Aufträge werden sta Jeder Job läuft in einer Umgebung, die mit `runs-on` angegeben wird. -Innerhalb der Nutzungsbeschränkungen des Workflows kannst Du unbegrenzt viele Jobs ausführen. Weitere Informationen finden Sie unter „[Nutzungseinschränkungen](#usage-limits)“. +Innerhalb der Nutzungsbeschränkungen des Workflows kannst Du unbegrenzt viele Jobs ausführen. For more information, see "[Usage limits and billing](/actions/reference/usage-limits-billing-and-administration)" for {% data variables.product.prodname_dotcom %}-hosted runners and "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)" for self-hosted runner usage limits. Wenn Du den eindeutigen Bezeichner eines Jobs finden musst, der in einem Workflowlauf ausgeführt wird, kannst Du die API von {% data variables.product.prodname_dotcom %} verwenden. For more information, see "[Workflow Jobs](/v3/actions/workflow-jobs)." @@ -310,7 +306,7 @@ runs-on: [self-hosted, linux] Weitere Informationen findest Du unter „[Informationen zu selbst-gehosteten Runnern](/github/automating-your-workflow-with-github-actions/about-self-hosted-runners)“ und „[Selbst-gehostete Runner in einem Workflow verwenden](/github/automating-your-workflow-with-github-actions/using-self-hosted-runners-in-a-workflow)“. -### **`jobs..outputs`** +### **`jobs..outputs`** Eine `map` der Ausgaben eines Jobs. Ausgaben eines Jobs stehen allen nachgelagerten Jobs zur Verfügung, die von diesem Job abhängen. Weitere Informationen zur Definition von Abhängigkeiten zwischen Jobs findest Du unter [`Jobs..needs`](#jobsjob_idneeds). @@ -393,7 +389,7 @@ Mit der `if`-Bedingung geben Sie an, dass ein Auftrag nur dann ausgeführt werde Ein Auftrag enthält eine Sequenz von Aufgaben, sogenannten `steps`. Mit Schritten können Befehle oder Einrichtungsaufgaben ausgeführt werden, und außerdem Aktionen, die sich in Ihrem Repository oder in einem öffentlichen Repository befinden oder in einer Docker Registry veröffentlicht sind. Nicht alle Schritte führen eine Aktion aus, doch alle Aktionen werden als Schritt ausgeführt. Jeder Schritt wird in einem eigenen Prozess in der Runner-Umgebung ausgeführt. Er hat Zugriff auf den Arbeitsbereich und das Dateisystem. Da die Schritte jeweils in einem eigenen Prozess ausgeführt werden, werden Änderungen an den Umgebungsvariablen nicht von Schritt zu Schritt beibehalten. {% data variables.product.prodname_dotcom %} umfasst integrierte Schritte zum Einrichten und Ausführen eines Auftrags. -Innerhalb der Nutzungseinschränkungen des Workflows können Sie unbegrenzt viele Schritte ausführen. Weitere Informationen finden Sie unter „[Nutzungseinschränkungen](#usage-limits)“. +Innerhalb der Nutzungseinschränkungen des Workflows können Sie unbegrenzt viele Schritte ausführen. For more information, see "[Usage limits and billing](/actions/reference/usage-limits-billing-and-administration)" for {% data variables.product.prodname_dotcom %}-hosted runners and "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)" for self-hosted runner usage limits. #### Beispiel @@ -421,7 +417,7 @@ jobs: #### **`jobs..steps.id`** -Eindeutige Kennung für den Schritt. Anhand der `id` können Sie in Kontexten auf den Schritt verweisen. Weitere Informationen findest Du unter "[Kontext- und Ausdrucks-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)". +Eindeutige Kennung für den Schritt. Anhand der `id` können Sie in Kontexten auf den Schritt verweisen. Weitere Informationen findest Du unter „[Kontext- und Ausdrucks-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)“. #### **`jobs..steps.if`** @@ -447,7 +443,7 @@ steps: ```yaml steps: - name: My first step - uses: monacorp/action-name@master + uses: monacorp/action-name@main - name: My backup step if: {% raw %}${{ failure() }}{% endraw %} uses: actions/heroku@master @@ -464,7 +460,7 @@ Wählt eine Aktion aus, die als Teil eines Schritts im Auftrag ausgeführt wird. Es wird dringend empfohlen, die verwendete Version der Aktion zu nennen (Git-Ref, SHA oder Docker-Tag-Nummer angeben). Wenn Sie keine Version angeben, könnten damit die Workflows gestört werden, oder es wird ein unerwartetes Verhalten hervorgerufen, wenn der Inhaber der Aktion eine Aktualisierung veröffentlicht. - Am besten in Hinblick auf Stabilität und Sicherheit ist es, die Commit-SHA einer freigegebenen Version einer Aktion zu verwenden. - Wenn Du Dich auf die Hauptversion der Aktion beziehst, kannst Du kritische Fehlerbehebungen und Sicherheits-Patches erhalten und gleichzeitig die Kompatibilität wahren. Außerdem ist damit sichergestellt, dass der Workflow weiterhin problemlos arbeiteten sollte. -- Die Verwendung des `master`-Branches einer Aktion ist zwar auf den ersten Blick komfortabel, doch wenn eine neue Hauptversion mit einer bahnbrechenden Änderung veröffentlicht wird, könnte damit Dein Workflow gestört werden. +- Using the default branch of an action may be convenient, but if someone releases a new major version with a breaking change, your workflow could break. Für einige Aktionen sind Eingaben erforderlich, die Sie mit dem Stichwort [`with`](#jobsjob_idstepswith) festlegen müssen. Die erforderlichen Eingaben finden Sie in der README-Datei der Aktion. @@ -474,14 +470,14 @@ Aktionen sind entweder JavaScript-Dateien oder Docker-Container. Bei Docker-Cont ```yaml steps: - # Verweis auf einen bestimmten Commit + # Reference a specific commit - uses: actions/setup-node@74bc508 - # Verweis auf die Hauptversion eines Release + # Reference the major version of a release - uses: actions/setup-node@v1 - #Verweis auf eine Unterversion eines Release + # Reference a minor version of a release - uses: actions/setup-node@v1.2 - # Verweis auf einen Branch - - uses: actions/setup-node@master + # Reference a branch + - uses: actions/setup-node@main ``` ##### Beispiel mit einer öffentlichen Aktion @@ -495,10 +491,10 @@ jobs: my_first_job: steps: - name: My first step - # Verwendet den Master-Branch eines oeffentlichen Repositorys + # Uses the default branch of a public repository uses: actions/heroku@master - name: My second step - # Verwendet eine bestimmte Versionsbezeichnung eines oeffentlichen Repositorys + # Uses a specific version tag of a public repository uses: actions/aws@v2.0.1 ``` @@ -513,7 +509,7 @@ jobs: my_first_job: steps: - name: My first step - uses: actions/aws/ec2@master + uses: actions/aws/ec2@main ``` ##### Beispiel mit einer Aktion im selben Repository wie der Workflow @@ -599,11 +595,11 @@ Du kannst die Einstellungen zur Standard-Shell im Betriebssystem des Läufers mi | Unterstützte Plattform | Parameter `shell` | Beschreibung | Intern ausgeführter Befehl | | ---------------------- | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- | | Alle | `bash` | Die standardmäßige Shell für alle Plattformen außer Windows mit einem Fallback zu `sh`. Wenn eine Bash-Shell für Windows angegeben wird, wird die in Git für Windows enthaltene Bash-Shell verwendet. | `bash --noprofile --norc -eo pipefail {0}` | -| Alle | `pwsh` | Der PowerShell Core. {% data variables.product.prodname_dotcom %} hängt die Erweiterung `.ps1` an den Skriptnamen an. | `pwsh -command "& '{0}'"` | +| Alle | `pwsh` | Der PowerShell Core. {% data variables.product.prodname_dotcom %} hängt die Erweiterung `.ps1` an Deinen Skriptnamen an. | `pwsh -command ". '{0}'"` | | Alle | `python` | Führt den Befehl Python aus. | `python {0}` | | Linux / macOS | `sh` | Das Fallback-Verhalten für alle Betriebssystem-Plattformen außer Windows, falls keine Shell angegeben ist und `bash` nicht im Pfad gefunden wird. | `sh -e {0}` | -| Windows | `cmd` | {% data variables.product.prodname_dotcom %} hängt die Erweiterung `.cmd` an Deinen Skriptnamen an und ersetzt `{0}`. | `%ComSpec% /D /E:ON /V:OFF /S /C "CALL "{0}""`. | -| Windows | `powershell` | Dies ist die standardmäßig für Windows verwendete Shell. Die Desktop PowerShell. {% data variables.product.prodname_dotcom %} hängt die Erweiterung `.ps1` an den Skriptnamen an. | `powershell -command "& '{0}'"`. | +| Windows | `cmd` | {% data variables.product.prodname_dotcom %} hängt die Erweiterung `.cmd` an Deinen Skriptnamen an und ersetzt `{0}`. | `%ComSpec% /D /E:ON /V:OFF /S /C "CALL "{0}""`. | +| Windows | `powershell` | Dies ist die standardmäßig für Windows verwendete Shell. Die Desktop PowerShell. {% data variables.product.prodname_dotcom %} hängt die Erweiterung `.ps1` an Deinen Skriptnamen an. | `powershell -command ". '{0}'"`. | ##### Beispiel zur Ausführung eines Skripts mittels Bash @@ -678,7 +674,7 @@ jobs: my_first_job: steps: - name: My first step - uses: actions/hello_world@master + uses: actions/hello_world@main with: first_name: Mona middle_name: The @@ -695,7 +691,7 @@ Ein `string`, der die Eingaben für einen Docker-Container definiert. Beim Start ```yaml steps: - name: Explain why this job ran - uses: monacorp/action-name@master + uses: monacorp/action-name@main with: entrypoint: /bin/echo args: The ${{ github.event_name }} event triggered this step. @@ -708,7 +704,6 @@ Die `args`-Anweisungen werden anstelle der `CMD`-Anweisung in einem `Dockerfile` 1. Verwenden Sie Standardwerte, die die Verwendung der Aktion ohne Angabe von `args` erlauben. 1. Wenn die Aktion einen Schalter `--help` oder Ähnliches anbietet, verwende diesen als Standard, um eine selbstständige Dokumentation der Aktion herbeizuführen. - #### **`jobs..steps.with.entrypoint`** Überschreibt den Docker-`ENTRYPOINT` im `Dockerfile` oder legt ihn fest, sofern er noch nicht angegeben wurde. Im Gegensatz zur Docker `ENTRYPOINT`-Anweisung, die eine Shell- und eine ausführbare Form aufweist, akzeptiert das Stichwort `entrypoint` nur einen einzigen Schritt, der die entsprechende ausführbare Datei definiert. @@ -718,7 +713,7 @@ Die `args`-Anweisungen werden anstelle der `CMD`-Anweisung in einem `Dockerfile` ```yaml steps: - name: Run a custom command - uses: monacorp/action-name@master + uses: monacorp/action-name@main with: entrypoint: /a/different/executable ``` @@ -766,9 +761,9 @@ Mit einer Strategie wird eine Build-Matrix für die Aufträge erstellt. Sie kön Du kannst eine Matrix aus verschiedenen Job-Konfigurationen definieren. Mit einer Matrix kannst Du mehrere Jobs erstellen, indem Du in einer einzigen Jobdefinition Variablen substituierst. Zum Beispiel kannst Du eine Matrix verwenden, um Jobs für mehrere unterstützte Versionen einer Programmiersprache, eines Betriebssystems oder eines Tools zu erstellen. Eine Matrix verwendet die Job-Konfiguration mehrfach und erstellt einen Job für jeden Eintrag in der Matrix, die Du konfigurierst. -{% data reusables.github-actions.matrix-limits %} +{% data reusables.github-actions.usage-matrix-limits %} -Jede Option, die Du in der `Matrix` definierst, hat einen Schlüssel und einen Wert. Die Schlüssel, die Du definierst, werden zu Eigenschaften im Kontext `Matrix` und Du kannst diese Eigenschaften in anderen Bereichen Ihrer Workflow-Datei referenzieren. Wenn Du zum Beispiel den Schlüssel `os` definierst, der ein Array von Betriebssystemen enthält, kannst Du die Eigenschaft `matrix.os` als Wert für das Schlüsselwort `runs-on` verwenden, um einen Job für jedes Betriebssystem zu erstellen. Weitere Informationen findest Du unter "[Kontext- und Ausdrucks-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)". +Jede Option, die Du in der `Matrix` definierst, hat einen Schlüssel und einen Wert. Die Schlüssel, die Du definierst, werden zu Eigenschaften im Kontext `Matrix` und Du kannst diese Eigenschaften in anderen Bereichen Ihrer Workflow-Datei referenzieren. Wenn Du zum Beispiel den Schlüssel `os` definierst, der ein Array von Betriebssystemen enthält, kannst Du die Eigenschaft `matrix.os` als Wert für das Schlüsselwort `runs-on` verwenden, um einen Job für jedes Betriebssystem zu erstellen. Weitere Informationen findest Du unter „[Kontext- und Ausdrucks-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)“. Die Reihenfolge, in der Du eine `Matrix` definierst, ist wichtig. Die erste Option, die Du definierst, ist der erste Job, der im Workflow ausgeführt wird. @@ -843,7 +838,6 @@ strategy: Du kannst `include` verwenden, um neue Jobs zu einer Build-Matrix hinzuzufügen. Alle Include-Konfigurationen, die nicht passen, werden zur Matrix hinzugefügt. Wenn Du beispielsweise `node` Version 12 verwenden willst, um auf mehreren Betriebssystemen zu bauen, aber Du willst einen zusätzlichen experimentellen Job mit Node Version 13 auf Ubuntu, kannst Du `include` verwenden, um diesen zusätzlichen Job anzugeben. - {% raw %} ```yaml runs-on: ${{ matrix.os }} @@ -952,7 +946,25 @@ jobs: #### **`jobs..container.image`** -Docker-Image, das beim Ausführen der Aktion als Container herangezogen wird. Als Wert kann der Name des Docker Hub-Images oder einer öffentlichen Docker Registry angegeben werden. +Docker-Image, das beim Ausführen der Aktion als Container herangezogen wird. The value can be the Docker Hub image name or a {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.23" %}public{% endif %} registry name. + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +#### **`jobs..container.credentials`** + +{% data reusables.actions.registry-credentials %} + +##### Beispiel + +{% raw %} +```yaml +container: + image: ghcr.io/owner/image + credentials: + username: ${{ github.actor }} + password: ${{ secrets.ghcr_token }} +``` +{% endraw %} +{% endif %} #### **`jobs..container.env`** @@ -997,7 +1009,7 @@ Wenn Du den Job so konfigurierst, dass er direkt auf der Runner-Maschine läuft Weitere Informationen über die Unterschiede zwischen Netzwerk-Servicecontainern finden Sie unter „[Informationen zu Servicecontainern](/actions/automating-your-workflow-with-github-actions/about-service-containers)“. -#### Beispiel für die Verwendung von localhost +#### Beispiel für die Verwendung von „localhost“ Dieses Beispiel erzeugt zwei Dienste: nginx und redis. Wenn Du den Port des Docker-Hosts angibst, aber nicht den des Containers, dann wird der Container-Port zufällig einem freien Port zugewiesen. {% data variables.product.prodname_dotcom %} setzt den zugewiesenen Containerport im Kontext {% raw %}`${{job.services..ports}}`{% endraw %} . In diesem Beispiel kannst Du über die Kontexte {% raw %}`${{ job.services.nginx.ports['8080'] }}`{% endraw %} und {% raw %}`${{ job.services.redis.ports['6379'] }}`{% endraw %} auf die Ports des Servicecontainers zugreifen. @@ -1015,19 +1027,43 @@ services: - 6379/tcp ``` -#### **`jobs..services.image`** +#### **`jobs..services..image`** + +Docker-Image, das beim Ausführen der Aktion als Dienstcontainer herangezogen wird. The value can be the Docker Hub image name or a {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.23" %}public{% endif %} registry name. + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +#### **`jobs..services..credentials`** + +{% data reusables.actions.registry-credentials %} + +##### Beispiel -Docker-Image, das beim Ausführen der Aktion als Dienstcontainer herangezogen wird. Als Wert kann der Name des Docker-Basis-Images, eines öffentlichen Docker Hub oder einer öffentlichen Docker Registry angegeben werden. +{% raw %} +```yaml +services: + myservice1: + image: ghcr.io/owner/myservice1 + credentials: + username: ${{ github.actor }} + password: ${{ secrets.ghcr_token }} + myservice2: + image: dockerhub_org/myservice2 + credentials: + username: ${{ secrets.DOCKER_USER }} + password: ${{ secrets.DOCKER_PASSWORD }} +``` +{% endraw %} +{% endif %} -#### **`jobs..services.env`** +#### **`jobs..services..env`** Legt eine `map` mit Umgebungsvariablen im Servicecontainer fest. -#### **`jobs..services.ports`** +#### **`jobs..services..ports`** Legt ein `array` mit Ports fest, die im Dienstcontainer offengelegt werden. -#### **`jobs..services.volumes`** +#### **`jobs..services..volumes`** Legt ein `array` mit Volumes für den Dienstcontainer fest. Mithilfe von Volumes können Sie Daten zwischen Diensten oder anderen Schritten in einem Auftrag austauschen. Sie können benannte Docker-Volumes, anonyme Docker-Volumes oder Bind-Mounts auf dem Host angegeben. @@ -1046,11 +1082,11 @@ volumes: - /source/directory:/destination/directory ``` -#### **`jobs..services.options`** +#### **`jobs..services..options`** Zusätzliche Optionen für die Docker-Containerressource. Eine Liste der Optionen finden Sie unter „[Optionen für `docker create`](https://docs.docker.com/engine/reference/commandline/create/#options)“. -### Spickzettel zu Filtermustern +### Merkzettel zu Filtermustern Die Pfad-, Branch- und Tag-Filter können bestimmte Sonderzeichen umfassen. @@ -1076,16 +1112,16 @@ Weitere Informationen zur Syntax für Branch-, Tag- und Pfadfilter finden Sie un #### Muster für den Abgleich von Branches und Tags -| Muster | Beschreibung | Beispiele für Übereinstimmungen | -| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -| `feature/*` | Das Platzhalterzeichen `*` steht für ein beliebiges Zeichen, nicht jedoch für den Schrägstrich (`/`). | -`feature/my-branch`
    -`feature/your-branch` | -| `feature/**` | Das Platzhalterzeichen `**` steht für ein beliebiges Zeichen, also auch für den Schrägstrich (`/`), in Branch- und Tag-Namen. | -`feature/beta-a/my-branch`
    -`feature/your-branch`
    -`feature/mona/the/octocat` | -| -`master`
    -`releases/mona-the-octcat` | Abgleich mit dem exakten Branch- oder Tag-Namen. | -`master`
    -`releases/mona-the-octocat` | -| `'*'` | Abgleich mit allen Branch- und Tag-Namen, die keinen Schrägstrich (`/`) enthalten. Das Zeichen `*` ist ein Sonderzeichen in YAML. Wenn ein Muster mit `*` beginnen soll, sind Anführungszeichen erforderlich. | -`master`
    -`releases` | -| `'**'` | Abgleich mit allen Branch- und Tag-Namen. Dies ist das Standardverhalten, wenn Sie keinen `branches`- oder `tags`-Filter angeben. | -`all/the/branches`
    -`every/tag` | -| `'*feature'` | Das Zeichen `*` ist ein Sonderzeichen in YAML. Wenn ein Muster mit `*` beginnen soll, sind Anführungszeichen erforderlich. | -`mona-feature`
    -`feature`
    -`ver-10-feature` | -| `v2*` | Abgleich mit Branch- und Tag-Namen, die mit `v2` beginnen. | -`v2`
    -`v2.0`
    -`v2.9` | -| `v[12].[0-9]+.[0-9]+` | Abgleich mit allen semantischen Versions-Tags mit der Hauptversion 1 oder 2. | -`v1.10.1`
    -`v2.0.0` | +| Muster | Beschreibung | Beispiele für Übereinstimmungen | +| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | +| `feature/*` | Das Platzhalterzeichen `*` steht für ein beliebiges Zeichen, nicht jedoch für den Schrägstrich (`/`). | -`feature/my-branch`
    -`feature/your-branch` | +| `feature/**` | Das Platzhalterzeichen `**` steht für ein beliebiges Zeichen, also auch für den Schrägstrich (`/`), in Branch- und Tag-Namen. | -`feature/beta-a/my-branch`
    -`feature/your-branch`
    -`feature/mona/the/octocat` | +| -`main`
    -`releases/mona-the-octcat` | Abgleich mit dem exakten Branch- oder Tag-Namen. | -`main`
    -`releases/mona-the-octocat` | +| `'*'` | Abgleich mit allen Branch- und Tag-Namen, die keinen Schrägstrich (`/`) enthalten. Das Zeichen `*` ist ein Sonderzeichen in YAML. Wenn ein Muster mit `*` beginnen soll, sind Anführungszeichen erforderlich. | -`main`
    -`releases` | +| `'**'` | Abgleich mit allen Branch- und Tag-Namen. Dies ist das Standardverhalten, wenn Sie keinen `branches`- oder `tags`-Filter angeben. | -`all/the/branches`
    -`every/tag` | +| `'*feature'` | Das Zeichen `*` ist ein Sonderzeichen in YAML. Wenn ein Muster mit `*` beginnen soll, sind Anführungszeichen erforderlich. | -`mona-feature`
    -`feature`
    -`ver-10-feature` | +| `v2*` | Abgleich mit Branch- und Tag-Namen, die mit `v2` beginnen. | -`v2`
    -`v2.0`
    -`v2.9` | +| `v[12].[0-9]+.[0-9]+` | Abgleich mit allen semantischen Versions-Tags mit der Hauptversion 1 oder 2. | -`v1.10.1`
    -`v2.0.0` | #### Muster für den Abgleich von Dateinamen diff --git a/translations/de-DE/content/admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider.md b/translations/de-DE/content/admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider.md index a3138a2d16c0..720b9fcb315d 100644 --- a/translations/de-DE/content/admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider.md +++ b/translations/de-DE/content/admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider.md @@ -45,6 +45,6 @@ Wenn ein Benutzer die Einladung akzeptiert, kann er sich anstatt über den IdP m ### Weiterführende Informationen -- „[LDAP verwenden](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap)“ +- „[LDAP verwenden](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap)“ - „[SAML verwenden](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-saml)“ - „[CAS verwenden](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-cas)“ diff --git a/translations/de-DE/content/admin/authentication/using-cas.md b/translations/de-DE/content/admin/authentication/using-cas.md index 3762deadf682..5c7c21343d09 100644 --- a/translations/de-DE/content/admin/authentication/using-cas.md +++ b/translations/de-DE/content/admin/authentication/using-cas.md @@ -5,7 +5,7 @@ redirect_from: - /enterprise/admin/articles/about-cas-authentication/ - /enterprise/admin/user-management/using-cas - /enterprise/admin/authentication/using-cas -intro: 'CAS ist ein Single Sign-On-Protokoll (SSO) für mehrere Webanwendungen. Ein CAS-Benutzerkonto übernimmt eine(n) {% if currentVersion ver_gt "enterprise-server@2.16" %}Benutzerlizenz{% else %}Benutzer{% endif %} erst nach Anmeldung des Benutzers.' +intro: 'CAS ist ein Single Sign-On-Protokoll (SSO) für mehrere Webanwendungen. A CAS user account does not take up a {% if currentVersion ver_gt "enterprise-server@2.16" %}user license{% else %}seat{% endif %} until the user signs in.' versions: enterprise-server: '*' --- @@ -25,8 +25,8 @@ versions: Die folgenden Attribute sind verfügbar. -| Attributname | Typ | Beschreibung | -| -------------- | ------------ | ------------------------------------------------------------------------- | +| Attributname | Typ | Beschreibung | +| -------------- | ------------ | -------------------------------------------------------------------- | | `Benutzername` | Erforderlich | Der {% data variables.product.prodname_ghe_server %}-Benutzername. | ### CAS konfigurieren diff --git a/translations/de-DE/content/admin/authentication/using-ldap.md b/translations/de-DE/content/admin/authentication/using-ldap.md index bd5fac811915..df5052660bdd 100644 --- a/translations/de-DE/content/admin/authentication/using-ldap.md +++ b/translations/de-DE/content/admin/authentication/using-ldap.md @@ -59,19 +59,19 @@ Verwenden Sie die folgenden Attribute, um die Konfiguration von LDAP für {% dat | Attributname | Typ | Beschreibung | | ------------------------------------------------ | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `Host` | Erforderlich | Der LDAP-Host, z. B. `ldap.example.com` oder `10.0.0.30`. Wenn der Hostnamen nur in Ihrem internen Netzwerk verfügbar ist, müssen Sie möglicherweise zunächst den DNS von {% data variables.product.product_location_enterprise %} konfigurieren, damit der Hostname mithilfe Ihrer internen Nameserver aufgelöst werden kann. | +| `Host` | Erforderlich | Der LDAP-Host, z. B. `ldap.example.com` oder `10.0.0.30`. Wenn der Hostnamen nur in Ihrem internen Netzwerk verfügbar ist, müssen Sie möglicherweise zunächst den DNS von {% data variables.product.product_location_enterprise %} konfigurieren, damit der Hostname mithilfe Ihrer internen Nameserver aufgelöst werden kann. | | `Port` | Erforderlich | Der Port, der von den LDAP-Diensten des Hosts überwacht wird. Beispiele: 389 und 636 (für LDAPS). | | `Encryption` | Erforderlich | Die Verschlüsselungsmethode, die verwendet wird, um Kommunikationen zum LDAP-Server zu schützen. Dazu zählen beispielsweise Nur-Text (keine Verschlüsselung), SSL/LDAPS (von Anfang an verschlüsselt) und StartTLS (Upgrade auf verschlüsselte Kommunikation nach dem Herstellen der Verbindung). | | `Domain search user` | Optional | Der LDAP-Benutzer, der Benutzernachschlagevorgänge durchführt, um andere Benutzer bei ihrer Anmeldung zu authentifizieren. In der Regel handelt es sich dabei um ein Dienstkonto, das speziell für Drittanbieterintegrationen erstellt wird. Verwenden Sie einen vollqualifizierten Namen, beispielsweise `cn=Administrator,cn=Users,dc=Example,dc=com`. Mit Active Directory können Sie zudem die Syntax `[DOMAIN]\[USERNAME]` (z. B. `WINDOWS\Administrator`) für den Benutzer der Domain-Suche mit Active Directory verwenden. | | `Domain search password` | Optional | Das Passwort für den Benutzer der Domain-Suche. | | `Administrators group` | Optional | Benutzer in dieser Gruppe werden auf Websiteadministratoren hochgestuft, wenn sie sich bei Ihrer Appliance anmelden. Wenn Sie keine Gruppe für LDAP-Administratoren konfigurieren, wird das erste LDAP-Benutzerkonto, das sich bei Ihrer Appliance anmeldet, automatisch auf einen Websiteadministrator hochgestuft. | | `Domain base` | Erforderlich | Der vollqualifizierte `Distinguished Name` (DN) einer LDAP-Unterstruktur, die auf Benutzer und Gruppen durchsucht werden soll. Sie können beliebig viele hinzufügen. Jede Gruppe muss jedoch in derselben Domain-Basis definiert sein wie die zugehörigen Benutzer. Wenn Sie eingeschränkte Benutzergruppen angeben, befinden sich nur die diesen Gruppen zugehörigen Benutzer im Geltungsbereich. Zum Steuern des Zugriffs sollten Sie die oberste Ebene Ihrer LDAP-Verzeichnisstruktur als Ihre Domain-Basis angeben und eingeschränkte Benutzergruppen verwenden. | -| `Restricted user groups` | Optional | Wenn diese Option angegeben ist, können sich nur die Benutzer dieser Gruppen anmelden. Sie müssen nur die allgemeinen Namen (Common Names, CNs) der Gruppen angeben. Zudem können Sie beliebig viele Gruppen hinzufügen. Sind keine Gruppen angegeben, können sich *alle* Benutzer im Geltungsbereich der angegebenen Domain-Basis bei Ihrer {% data variables.product.prodname_ghe_server %}-Instanz anmelden. | -| `User ID` | Erforderlich | Das LDAP-Attribut, das den LDAP-Benutzer identifiziert, der versucht, sich zu authentifizieren. Nach dem Herstellen einer Zuordnung können Benutzer ihre {% data variables.product.prodname_ghe_server %}-Benutzernamen ändern. Dieses Feld sollte für die meisten Active Directory-Installationen `sAMAccountName` lauten. Für andere LDAP-Lösungen wie OpenLDAP lautet es ggf. `uid`. Der Standardwert lautet `uid`. | -| `Profilname` | Optional | Der Name, der auf der {% data variables.product.prodname_ghe_server %}-Profilseite des Benutzers angezeigt wird. Sofern die LDAP-Synchronisierung nicht aktiviert ist, können Benutzer ihre Profilnamen ändern. | -| `Emails` | Optional | Die E-Mail-Adressen für das {% data variables.product.prodname_ghe_server %}-Konto eines Benutzers. | -| `SSH keys` | Optional | Die öffentlichen SSH-Schlüssel, die an das {% data variables.product.prodname_ghe_server %}-Konto eines Benutzers angehängt sind. Die Schlüssel müssen im OpenSSH-Format vorliegen. | -| `GPG keys` | Optional | Die GPG-Schlüssel, die an das {% data variables.product.prodname_ghe_server %}-Konto eines Benutzers angehängt sind. | +| `Restricted user groups` | Optional | Wenn diese Option angegeben ist, können sich nur die Benutzer dieser Gruppen anmelden. Sie müssen nur die allgemeinen Namen (Common Names, CNs) der Gruppen angeben. Zudem können Sie beliebig viele Gruppen hinzufügen. Sind keine Gruppen angegeben, können sich *alle* Benutzer im Geltungsbereich der angegebenen Domain-Basis bei Ihrer {% data variables.product.prodname_ghe_server %}-Instanz anmelden. | +| `User ID` | Erforderlich | Das LDAP-Attribut, das den LDAP-Benutzer identifiziert, der versucht, sich zu authentifizieren. Nach dem Herstellen einer Zuordnung können Benutzer ihre {% data variables.product.prodname_ghe_server %}-Benutzernamen ändern. Dieses Feld sollte für die meisten Active Directory-Installationen `sAMAccountName` lauten. Für andere LDAP-Lösungen wie OpenLDAP lautet es ggf. `uid`. Der Standardwert lautet `uid`. | +| `Profilname` | Optional | Der Name, der auf der {% data variables.product.prodname_ghe_server %}-Profilseite des Benutzers angezeigt wird. Sofern die LDAP-Synchronisierung nicht aktiviert ist, können Benutzer ihre Profilnamen ändern. | +| `Emails` | Optional | Die E-Mail-Adressen für das {% data variables.product.prodname_ghe_server %}-Konto eines Benutzers. | +| `SSH keys` | Optional | Die öffentlichen SSH-Schlüssel, die an das {% data variables.product.prodname_ghe_server %}-Konto eines Benutzers angehängt sind. Die Schlüssel müssen im OpenSSH-Format vorliegen. | +| `GPG keys` | Optional | Die GPG-Schlüssel, die an das {% data variables.product.prodname_ghe_server %}-Konto eines Benutzers angehängt sind. | | `Disable LDAP authentication for Git operations` | Optional | Wenn diese Option ausgewählt ist, wird die Möglichkeit der Benutzer [deaktiviert](#disabling-password-authentication-for-git-operations), LDAP-Passwörter zur Authentifizierung von Git-Vorgängen zu verwenden. | | `Enable LDAP certificate verification` | Optional | Wenn diese Option ausgewählt ist, wird die LDAP-Zertifikatsverifizierung [aktiviert](#enabling-ldap-certificate-verification). | | `Synchronization` | Optional | Wenn diese Option ausgewählt ist, wird die LDAP-Synchronisierung [aktiviert](#enabling-ldap-sync). | @@ -97,6 +97,12 @@ Wenn diese Option ausgewählt ist, wird das Zertifikat validiert, um Folgendes s #### LDAP-Synchronisierung aktivieren +{% note %} + +**Note:** Teams using LDAP Sync are limited to a maximum 1499 members. + +{% endnote %} + Mithilfe der LDAP-Synchronisierung können Sie {% data variables.product.prodname_ghe_server %}-Benutzer und die -Teammitgliedschaft mit Ihren festgelegten LDAP-Gruppen synchronisieren. Dadurch können Sie eine rollenbasierte Zugriffskontrolle (Role-Based Access Control, RBAC) für Benutzer von Ihrem LDAP-Server aus einrichten, anstatt manuell innerhalb von {% data variables.product.prodname_ghe_server %}. Weitere Informationen finden Sie unter „[Teams erstellen](/enterprise/{{ currentVersion }}/admin/guides/user-management/creating-teams#creating-teams-with-ldap-sync-enabled)“. Wählen Sie **Synchronize Emails** (E-Mails synchronisieren), **Synchronize SSH Keys** (SSH-Schlüssel synchronisieren) oder **Synchronize GPG Keys** (GPG-Schlüssel synchronisieren) aus, um die LDAP-Synchronisierung zu aktivieren. diff --git a/translations/de-DE/content/admin/authentication/using-saml.md b/translations/de-DE/content/admin/authentication/using-saml.md index 7d70daf93bb2..b92b8a0346fa 100644 --- a/translations/de-DE/content/admin/authentication/using-saml.md +++ b/translations/de-DE/content/admin/authentication/using-saml.md @@ -54,15 +54,15 @@ Wenn Sie Ihren Identity Provider manuell konfigurieren möchten, lautet die Asse Die folgenden Attribute sind verfügbar. Mit Ausnahme der `administrator`-Attribute können Sie die Attributnamen in der [Managementkonsole](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-management-console/) ändern. -| Standardmäßiger Attributname | Typ | Beschreibung | -| ---------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| Standardmäßiger Attributname | Typ | Beschreibung | +| ---------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `NameID` | Erforderlich | Ein persistenter Benutzerkennzeichner. Es kann ein beliebiges Format für persistente Namenskennzeichner verwendet werden. Das Element `NameID` wird für einen {% data variables.product.prodname_ghe_server %}-Benutzernamen verwendet, sofern keine der alternativen Assertions bereitgestellt wird. | -| `Administrator` | Optional | Wenn der Wert „true“ lautet, wird der Benutzer automatisch zu einem Administrator hochgestuft. Bei anderen oder nicht vorhandenen Werten wird der Benutzer auf ein normales Benutzerkonto zurückgestuft. | +| `Administrator` | Optional | Wenn der Wert „true“ lautet, wird der Benutzer automatisch zu einem Administrator hochgestuft. Bei anderen oder nicht vorhandenen Werten wird der Benutzer auf ein normales Benutzerkonto zurückgestuft. | | `Benutzername` | Optional | Der {% data variables.product.prodname_ghe_server %}-Benutzername. | -| `full_name` | Optional | Der Name des Benutzers, der auf seiner Profilseite angezeigt wird. Nach der Bereitstellung können Benutzer ihre Namen ändern. | -| `emails` | Optional | Die E-Mail-Adressen für den Benutzer. Es können mehrere angegeben werden. | -| `public_keys` | Optional | Die öffentlichen SSH-Schlüssel für den Benutzer. Es können mehrere angegeben werden. | -| `gpg_keys` | Optional | Die GPG-Schlüssel für den Benutzer. Es können mehrere angegeben werden. | +| `full_name` | Optional | Der Name des Benutzers, der auf seiner Profilseite angezeigt wird. Nach der Bereitstellung können Benutzer ihre Namen ändern. | +| `emails` | Optional | Die E-Mail-Adressen für den Benutzer. Es können mehrere angegeben werden. | +| `public_keys` | Optional | Die öffentlichen SSH-Schlüssel für den Benutzer. Es können mehrere angegeben werden. | +| `gpg_keys` | Optional | Die GPG-Schlüssel für den Benutzer. Es können mehrere angegeben werden. | ### SAML-Einstellungen konfigurieren @@ -88,7 +88,7 @@ Die folgenden Attribute sind verfügbar. Mit Ausnahme der `administrator`-Attrib {% if currentVersion ver_gt "enterprise-server@2.21" %} -### Zugriff auf {% data variables.product.product_location_enterprise %} widerrufen +### Zugriff auf {{ site.data.variables.product.product_location_enterprise }} widerrufen {% data reusables.enterprise_site_admin_settings.access-settings %} 2. Wählen Sie **SAML** aus. !["All users" sidebar item in site administrator settings](/assets/images/enterprise/site-admin-settings/all-users.png) diff --git a/translations/de-DE/content/admin/configuration/command-line-utilities.md b/translations/de-DE/content/admin/configuration/command-line-utilities.md index 5659ff6c3b6c..f4757845eab1 100644 --- a/translations/de-DE/content/admin/configuration/command-line-utilities.md +++ b/translations/de-DE/content/admin/configuration/command-line-utilities.md @@ -20,7 +20,8 @@ Sie können diese Befehle überall in der VM ausführen, nachdem Sie sich als ei Dieses Dienstprogramm liegt im oberen Bereich jeder {% data variables.product.prodname_enterprise %}-Seite einen Banner fest. Diesen können Sie verwenden, um Ihren Benutzer eine Mitteilung zu übermitteln. {% if currentVersion ver_gt "enterprise-server@2.21" %} -You can also set an announcement banner using the enterprise settings on {% data variables.product.product_name %}. Weitere Informationen finden Sie unter „[Benutzermeldungen auf Ihrer Instanz anpassen](/enterprise/admin/user-management/customizing-user-messages-on-your-instance#creating-a-global-announcement-banner)“. +You can also set an announcement banner using the enterprise settings on +{% data variables.product.product_name %}. Weitere Informationen finden Sie unter „[Benutzermeldungen auf Ihrer Instanz anpassen](/enterprise/admin/user-management/customizing-user-messages-on-your-instance#creating-a-global-announcement-banner)“. {% endif %} ```shell @@ -80,7 +81,7 @@ Dadurch können Sie den UUID Ihres Knotens in `cluster.conf` ermitteln. ``` {% if currentVersion ver_gt "enterprise-server@2.21" %} -Allows you to exempt a list of users from API rate limits. For more information, see "[Rate Limiting](/enterprise/{{ currentVersion }}/v3/#rate-limiting)." +Allows you to exempt a list of users from API rate limits. For more information, see "[Rate Limiting](/enterprise/{{ page.version }}/v3/#rate-limiting)." ``` shell $ ghe-config app.github.rate_limiting_exempt_users "hubot github-actions" @@ -181,7 +182,6 @@ Mit diesem Dienstprogramm können Sie den Wartungsmoduszustand der Installation ghe-maintenance -h ``` -{% if currentVersion ver_gt "enterprise-server@2.17" %} #### ghe-motd Dieses Dienstprogramm zeigt die Meldung des Tages (MOTD) an, die Administratoren sehen, wenn sie über die administrative Shell auf die Instanz zugreifen. Die Ausgabe enthält einen Überblick über den Status der Instanz. @@ -189,7 +189,6 @@ Dieses Dienstprogramm zeigt die Meldung des Tages (MOTD) an, die Administratoren ```shell ghe-motd ``` -{% endif %} #### ghe-nwo diff --git a/translations/de-DE/content/admin/configuration/configuring-a-hostname.md b/translations/de-DE/content/admin/configuration/configuring-a-hostname.md index b16691a7d608..077b56023863 100644 --- a/translations/de-DE/content/admin/configuration/configuring-a-hostname.md +++ b/translations/de-DE/content/admin/configuration/configuring-a-hostname.md @@ -1,6 +1,6 @@ --- title: Hostname konfigurieren -intro: 'Es wird empfohlen, dass Sie einen Hostnamen für Ihre Appliance festlegen, anstatt eine hartcodierte IP-Adresse zu verwenden.' +intro: Es wird empfohlen, dass Sie einen Hostnamen für Ihre Appliance festlegen, anstatt eine hartcodierte IP-Adresse zu verwenden. redirect_from: - /enterprise/admin/guides/installation/configuring-hostnames/ - /enterprise/admin/installation/configuring-a-hostname diff --git a/translations/de-DE/content/admin/configuration/configuring-applications.md b/translations/de-DE/content/admin/configuration/configuring-applications.md index b873f8b2fddd..1bf3e2fca151 100644 --- a/translations/de-DE/content/admin/configuration/configuring-applications.md +++ b/translations/de-DE/content/admin/configuration/configuring-applications.md @@ -15,5 +15,7 @@ Sie können auswählen, wie lange {% data variables.product.product_location_ent {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} 3. Klicke in der linken Seitenleiste auf **Applications** (Anwendungen). ![Registerkarte „Applications“ (Anwendungen) auf der Seitenleiste mit den Einstellungen](/assets/images/enterprise/management-console/sidebar-applications.png) -4. Geben Sie unter „Avatar image cache time (seconds)“ (Avatarbild-Cache-Zeit (Sekunden)) ein, wie viele Sekunden {% data variables.product.product_location_enterprise %} Avatarbilder zwischenspeichern soll. ![Formularfeld für die Zwischenspeicherung von Avatarbildern](/assets/images/enterprise/management-console/add-image-caching-value-field.png) +4. Under "Avatar image cache time (seconds)", type the number of seconds that you would like +{% data variables.product.product_location_enterprise %} to cache avatar images. +![Formularfeld für die Zwischenspeicherung von Avatarbildern](/assets/images/enterprise/management-console/add-image-caching-value-field.png) {% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/de-DE/content/admin/configuration/configuring-built-in-firewall-rules.md b/translations/de-DE/content/admin/configuration/configuring-built-in-firewall-rules.md index e8eb2e5a4e9c..70d8f39332ca 100644 --- a/translations/de-DE/content/admin/configuration/configuring-built-in-firewall-rules.md +++ b/translations/de-DE/content/admin/configuration/configuring-built-in-firewall-rules.md @@ -52,7 +52,7 @@ Die UWF-Firewall öffnet zudem verschiedene Ports, die für die ordnungsgemäße {% warning %} -**Warning:** Before you add custom firewall rules, back up your current rules in case you need to reset to a known working state. Falls Ihr Server für Sie gesperrt ist, kontaktieren Sie {% data variables.contact.contact_ent_support %}, um die ursprünglichen Firewallregeln neu zu konfigurieren. Die Wiederherstellung der ursprünglichen Firewallregeln führt zu Ausfallzeiten für Ihren Server. +**Warnung:** Bevor Sie benutzerdefinierte Firewallregeln hinzufügen, sollten Sie Ihre aktuellen Regeln sichern, falls Sie in einen bekannten Betriebszustand zurückkehren müssen. Falls Ihr Server für Sie gesperrt ist, kontaktieren Sie {% data variables.contact.contact_ent_support %}, um die ursprünglichen Firewallregeln neu zu konfigurieren. Die Wiederherstellung der ursprünglichen Firewallregeln führt zu Ausfallzeiten für Ihren Server. {% endwarning %} @@ -74,7 +74,7 @@ Wenn nach dem Ändern der Firewallregeln ein Fehler auftritt, können Sie die Re {% warning %} -**Warning:** If you didn't back up the original rules before making changes to the firewall, contact {% data variables.contact.contact_ent_support %} for further assistance. +**Warnung:** Falls Sie die ursprünglichen Regeln nicht gesichert haben, bevor Sie Änderungen an der Firewall vorgenommen haben, kontaktieren Sie {% data variables.contact.contact_ent_support %}, um weitere Unterstützung zu erhalten. {% endwarning %} diff --git a/translations/de-DE/content/admin/configuration/configuring-code-scanning-for-your-appliance.md b/translations/de-DE/content/admin/configuration/configuring-code-scanning-for-your-appliance.md index 000a16b944f3..7bfa6d36c740 100644 --- a/translations/de-DE/content/admin/configuration/configuring-code-scanning-for-your-appliance.md +++ b/translations/de-DE/content/admin/configuration/configuring-code-scanning-for-your-appliance.md @@ -37,7 +37,9 @@ If you can't see **{% data variables.product.prodname_advanced_security %}** in {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_management_console.advanced-security-tab %} -1. Under "{% data variables.product.prodname_advanced_security %}," click **{% data variables.product.prodname_code_scanning_capc %}**. ![Checkbox to enable or disable {% data variables.product.prodname_code_scanning %}](/assets/images/enterprise/management-console/enable-code-scanning-checkbox.png) +1. Under " +{% data variables.product.prodname_advanced_security %}," click **{% data variables.product.prodname_code_scanning_capc %}**. +![Checkbox to enable or disable {% data variables.product.prodname_code_scanning %}](/assets/images/enterprise/management-console/enable-code-scanning-checkbox.png) {% data reusables.enterprise_management_console.save-settings %} @@ -47,6 +49,8 @@ If you can't see **{% data variables.product.prodname_advanced_security %}** in If you are enrolled in the {% data variables.product.prodname_actions %} beta, then {% data variables.product.prodname_ghe_server %} can run {% data variables.product.prodname_code_scanning %} using a {% data variables.product.prodname_actions %} workflow. First, you need to provision one or more self-hosted {% data variables.product.prodname_actions %} runners in your environment. You can provision self-hosted runners at the repository, organization, or enterprise account level. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners)" and "[Adding self-hosted runners](/actions/hosting-your-own-runners/adding-self-hosted-runners)." +You must ensure that Git is in the PATH variable on any self-hosted runners you use to run {% data variables.product.prodname_codeql %} actions. + #### Provisioning the action To run {% data variables.product.prodname_code_scanning %} on {% data variables.product.prodname_ghe_server %} with {% data variables.product.prodname_actions %}, the appropriate action must be available locally. You can make the action available in three ways. @@ -67,7 +71,7 @@ After you configure a self-hosted runner, users can enable {% data variables.pro ### Running {% data variables.product.prodname_code_scanning %} using the {% data variables.product.prodname_codeql_runner %} If your organization isn't taking part in the beta for {% data variables.product.prodname_actions %}, or if you don't want to use {% data variables.product.prodname_actions %}, you can run {% data variables.product.prodname_code_scanning %} using the {% data variables.product.prodname_codeql_runner %}. -The {% data variables.product.prodname_codeql_runner %} is a command-line tool that you can add to your third-party CI/CD system. The tool runs {% data variables.product.prodname_codeql %} analysis on a checkout of a {% data variables.product.prodname_dotcom %} repository. For more information, see "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)." +The {% data variables.product.prodname_codeql_runner %} is a command-line tool that you can add to your third-party CI/CD system. The tool runs {% data variables.product.prodname_codeql %} analysis on a checkout of a {% data variables.product.prodname_dotcom %} repository. For more information, see "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)." ### Disabling {% data variables.product.prodname_code_scanning %} @@ -76,5 +80,7 @@ The {% data variables.product.prodname_codeql_runner %} is a command-line tool t {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_management_console.advanced-security-tab %} -1. Under "{% data variables.product.prodname_advanced_security %}", unselect **{% data variables.product.prodname_code_scanning_capc %}**. ![Checkbox to enable or disable {% data variables.product.prodname_code_scanning %}](/assets/images/enterprise/management-console/code-scanning-disable.png) +1. Under " +{% data variables.product.prodname_advanced_security %}", unselect **{% data variables.product.prodname_code_scanning_capc %}**. +![Checkbox to enable or disable {% data variables.product.prodname_code_scanning %}](/assets/images/enterprise/management-console/code-scanning-disable.png) {% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/de-DE/content/admin/configuration/configuring-rate-limits.md b/translations/de-DE/content/admin/configuration/configuring-rate-limits.md index 3b4eb5b8b716..e542319ed0da 100644 --- a/translations/de-DE/content/admin/configuration/configuring-rate-limits.md +++ b/translations/de-DE/content/admin/configuration/configuring-rate-limits.md @@ -10,7 +10,7 @@ versions: ### Begrenzungen für {% data variables.product.prodname_enterprise_api %} aktivieren -Die Aktivierung von Begrenzungen auf {% data variables.product.prodname_enterprise_api %} kann verhindern, dass einzelne oder nicht authentifizierte Benutzer Ressourcen übermäßig verwenden. For more information, see "[Rate Limiting](/enterprise/{{ currentVersion }}/v3/#rate-limiting)." +Die Aktivierung von Begrenzungen auf {% data variables.product.prodname_enterprise_api %} kann verhindern, dass einzelne oder nicht authentifizierte Benutzer Ressourcen übermäßig verwenden. For more information, see "[Rate Limiting](/enterprise/{{ page.version }}/v3/#rate-limiting)." {% if currentVersion ver_gt "enterprise-server@2.21" %} You can exempt a list of users from API rate limits using the `ghe-config` utility in the administrative shell. For more information, see "[Command-line utilities](/enterprise/admin/configuration/command-line-utilities#ghe-config)." diff --git a/translations/de-DE/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md b/translations/de-DE/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md index 63a22b08b5c4..422f24092252 100644 --- a/translations/de-DE/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md +++ b/translations/de-DE/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md @@ -8,7 +8,15 @@ versions: enterprise-server: '*' --- +{% note %} + +**Note:** We do not support adding additional network adapters to {% data variables.product.prodname_ghe_server %}. + +{% endnote %} + {% data reusables.enterprise_installation.open-vm-console-start %} 3. Wählen Sie aus, dass `IPv4`- oder `IPv6`-Protokoll zu konfigurieren. ![Auswahloptionen für das IPv4- oder für das IPv6-Protokoll](/assets/images/enterprise/network-configuration/IPv4-or-IPv6-protocol.png) 4. Konfigurieren Sie die Optionen für das gewünschte Protokoll. ![Menü mit IP-Protokolloptionen](/assets/images/enterprise/network-configuration/network-settings-selection.png) {% data reusables.enterprise_installation.vm-console-done %} + + diff --git a/translations/de-DE/content/admin/configuration/configuring-tls.md b/translations/de-DE/content/admin/configuration/configuring-tls.md index 2e5db82c9a99..28fc5bb68c51 100644 --- a/translations/de-DE/content/admin/configuration/configuring-tls.md +++ b/translations/de-DE/content/admin/configuration/configuring-tls.md @@ -26,7 +26,7 @@ Um TLS in der Produktion zu verwenden, müssen Sie über ein Zertifikat verfüge Darüber hinaus schreibt Ihr Zertifikat Subject Alternative Names vor, die für die in „[Subdomain-Isolation aktivieren](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-subdomain-isolation#about-subdomain-isolation)“ aufgelisteten Subdomains konfiguriert sind, und es muss die gesamte Zertifikatskette enthalten, wenn es von einer zwischengeschalteten Zertifizierungsstelle signiert wurde. Weitere Informationen finden Sie unter „[Subject Alternative Name](http://en.wikipedia.org/wiki/SubjectAltName)“ auf Wikipedia. -Du kannst mit dem Befehl `ghe-ssl-generate-csr` eine Anfrage zur Signierung des Zertifikats (CSR) für Deine Instanz erzeugen. Weitere Informationen findest Du unter „[Befehlszeilen-Hilfsprogramme](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#ghe-ssl-generate-csr)“. +Du kannst mit dem Befehl `ghe-ssl-generate-csr` eine Anfrage zur Signierung des Zertifikats (CSR) für Deine Instanz erzeugen. Weitere Informationen finden Sie unter „[Befehlszeilenprogramme](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#ghe-ssl-generate-csr)“. ### Benutzerdefiniertes TLS-Zertifikat hochladen diff --git a/translations/de-DE/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md b/translations/de-DE/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md index c12368fef449..9a4bf731aaa9 100644 --- a/translations/de-DE/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md +++ b/translations/de-DE/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md @@ -37,12 +37,12 @@ Wenn Du {% data variables.product.prodname_github_connect %} aktivierst, wird zu Wenn {% data variables.product.prodname_github_connect %} aktiviert wird, können {% data variables.product.prodname_dotcom_the_website %}-Benutzer keine Änderungen an {% data variables.product.prodname_ghe_server %} vornehmen. -{% if currentVersion ver_gt "enterprise-server@2.18" %} For more information about managing enterprise accounts using the GraphQL API, see "[Enterprise accounts](/v4/guides/managing-enterprise-accounts)." -{% endif %} ### {% data variables.product.prodname_github_connect %} aktivieren -1. Melden Sie sich bei {% data variables.product.product_location_enterprise %} und {% data variables.product.prodname_dotcom_the_website %} an. +1. Sign in to + +{% data variables.product.product_location_enterprise %} and {% data variables.product.prodname_dotcom_the_website %}. {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.settings-tab %} diff --git a/translations/de-DE/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md b/translations/de-DE/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md index 9421b96b245f..75b38a5fe45b 100644 --- a/translations/de-DE/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md +++ b/translations/de-DE/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md @@ -5,7 +5,6 @@ redirect_from: - /enterprise/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server - /enterprise/admin/configuration/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server - /enterprise/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server - - /enterprise/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server permissions: 'Site administrators for {% data variables.product.prodname_ghe_server %} who are also owners of the connected {% data variables.product.prodname_ghe_cloud %} organization or enterprise account can enable {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %}.' versions: enterprise-server: '*' @@ -17,23 +16,23 @@ versions: You can connect {% data variables.product.product_location_enterprise %} to {% data variables.product.prodname_dotcom_the_website %}, then sync vulnerability data to your instance and generate {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts in repositories with a vulnerable dependency. -After connecting {% data variables.product.product_location_enterprise %} to {% data variables.product.prodname_dotcom_the_website %} and enabling {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies, vulnerability data is synced from {% data variables.product.prodname_dotcom_the_website %} to your instance once every hour. You can also choose to manually sync vulnerability data at any time. No code or information about code from {% data variables.product.product_location_enterprise %} is uploaded to {% data variables.product.prodname_dotcom_the_website %}. +After connecting {% data variables.product.product_location_enterprise %} to {% data variables.product.prodname_dotcom_the_website %} and enabling {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies, vulnerability data is synced from {% data variables.product.prodname_dotcom_the_website %} to your instance once every hour. Sie können die Schwachstellendaten auch jederzeit manuell synchronisieren. Es werden weder Code noch Informationen zu Code von {% data variables.product.product_location_enterprise %} auf {% data variables.product.prodname_dotcom_the_website %} hochgeladen. -{% if currentVersion ver_gt "enterprise-server@2.21" %}When {% data variables.product.product_location_enterprise %} receives information about a vulnerability, it will identify repositories in your instance that use the affected version of the dependency and send {% data variables.product.prodname_dependabot_short %} alerts to owners and people with admin access in those repositories. They can customize how they receive {% data variables.product.prodname_dependabot_short %} alerts. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/#configuring-notifications-for-github-dependabot-alerts)." +{% if currentVersion ver_gt "enterprise-server@2.21" %}When {% data variables.product.product_location_enterprise %} receives information about a vulnerability, it will identify repositories in your instance that use the affected version of the dependency and send {% data variables.product.prodname_dependabot_short %} alerts to owners and people with admin access in those repositories. They can customize how they receive {% data variables.product.prodname_dependabot_short %} alerts. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/#configuring-notifications-for-github-dependabot-alerts)." | {% endif %} -{% if currentVersion ver_lt "enterprise-server@2.21" or currentVersion == "enterprise-server@2.21" %}When {% data variables.product.product_location_enterprise %} receives information about a vulnerability, it will identify repositories in your instance that use the affected version of the dependency and send security alerts to owners and people with admin access in those repositories. They can customize how they receive security alerts. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/#configuring-notifications-for-security-alerts)." +{% if currentVersion ver_lt "enterprise-server@2.21" or currentVersion == "enterprise-server@2.21" %}When {% data variables.product.product_location_enterprise %} receives information about a vulnerability, it will identify repositories in your instance that use the affected version of the dependency and send security alerts to owners and people with admin access in those repositories. Sie können anpassen, wie sie Sicherheitsmeldungen empfangen möchten. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/#configuring-notifications-for-security-alerts)." | {% endif %} {% if currentVersion ver_gt "enterprise-server@2.21" %} ### Enabling {% data variables.product.prodname_dependabot_short %} alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %} {% else %} -### Enabling security alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %} +### Sicherheitsmeldungen für angreifbare Abhängigkeiten auf {% data variables.product.prodname_ghe_server %} aktivieren {% endif %} -Before enabling {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies on {% data variables.product.product_location_enterprise %}, you must connect {% data variables.product.product_location_enterprise %} to {% data variables.product.prodname_dotcom_the_website %}. For more information, see "[Connecting {% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_ghe_cloud %}](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)." +Before enabling {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies on {% data variables.product.product_location_enterprise %}, you must connect {% data variables.product.product_location_enterprise %} to {% data variables.product.prodname_dotcom_the_website %}. Weitere Informationen finden Sie unter „[{% data variables.product.prodname_ghe_server %} mit {% data variables.product.prodname_ghe_cloud %} verbinden](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)“. -{% if currentVersion ver_gt "enterprise-server@2.20" %} +{% if currentVersion ver_gt "enterprise-server@2.20" %} {% if currentVersion ver_gt "enterprise-server@2.21" %}We recommend configuring {% data variables.product.prodname_dependabot_short %} alerts without notifications for the first few days to avoid an overload of emails. After a few days, you can enable notifications to receive {% data variables.product.prodname_dependabot_short %} alerts as usual.{% endif %} @@ -46,22 +45,21 @@ Before enabling {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data v ``` shell $ ghe-dep-graph-enable ``` -3. Return to {% data variables.product.prodname_ghe_server %}. +3. Return to +{% data variables.product.prodname_ghe_server %}. {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.github-connect-tab %}{% if currentVersion ver_gt "enterprise-server@2.20" %} 5. Under "Repositories can be scanned for vulnerabilities", use the drop-down menu and select **Enabled without notifications**. Optionally, to enable alerts with notifications, select **Enabled with notifications**.{% else %} -5. Under "Repositories can be scanned for vulnerabilities", use the drop-down menu and select **Enabled**. +5. Verwenden Sie unter „Repositories can be scanned for vulnerabilities“ (Repositorys können auf Schwachstellen überprüft werden) das Dropdownmenü, und wählen Sie **Enabled** (Aktiviert) aus. {% endif %} - ![Drop-down menu to enable scanning repositories for vulnerabilities](/assets/images/enterprise/site-admin-settings/enable-vulnerability-scanning-in-repositories.png) + ![Dropdownmenü zum Aktivieren der Überprüfung von Repositorys auf Schwachstellen](/assets/images/enterprise/site-admin-settings/enable-vulnerability-scanning-in-repositories.png) -### Viewing vulnerable dependencies on {% data variables.product.prodname_ghe_server %} +### Angreifbare Abhängigkeiten auf {% data variables.product.prodname_ghe_server %} anzeigen -You can view all vulnerabilities in {% data variables.product.product_location_enterprise %} and manually sync vulnerability data from {% data variables.product.prodname_dotcom_the_website %} to update the list. +Sie können alle Schwachstellen in {% data variables.product.product_location_enterprise %} anzeigen und Schwachstellendaten von {% data variables.product.prodname_dotcom_the_website %} manuell synchronisieren, um die Liste zu aktualisieren. {% data reusables.enterprise_site_admin_settings.access-settings %} -2. In the left sidebar, click **Vulnerabilities**. - ![Vulnerabilities tab in the site admin sidebar](/assets/images/enterprise/business-accounts/vulnerabilities-tab.png) -3. To sync vulnerability data, click **Sync Vulnerabilities now**. - ![Sync vulnerabilities now button](/assets/images/enterprise/site-admin-settings/sync-vulnerabilities-button.png) +2. Klicken Sie auf der linken Seitenleiste auf **Vulnerabilities** (Schwachstellen). ![Registerkarte „Vulnerabilities“ (Schwachstellen) auf der Seitenleiste für Websiteadministratoren](/assets/images/enterprise/business-accounts/vulnerabilities-tab.png) +3. Klicken Sie zum Synchronisieren von Schwachstellendaten auf **Sync Vulnerabilities now** (Schwachstellen jetzt synchronisieren). ![Schaltfläche „Sync vulnerabilities now“ (Schwachstellen jetzt synchronisieren)](/assets/images/enterprise/site-admin-settings/sync-vulnerabilities-button.png) diff --git a/translations/de-DE/content/admin/configuration/enabling-subdomain-isolation.md b/translations/de-DE/content/admin/configuration/enabling-subdomain-isolation.md index 80344584923f..855032e5c8d6 100644 --- a/translations/de-DE/content/admin/configuration/enabling-subdomain-isolation.md +++ b/translations/de-DE/content/admin/configuration/enabling-subdomain-isolation.md @@ -16,28 +16,29 @@ Die Subdomain-Isolation mindert Cross-Site-Scripting und andere verwandte Schwac Bei aktivierter Subdomain-Isolation ersetzt {% data variables.product.prodname_ghe_server %} verschiedene Pfade durch Subdomains. {% if currentVersion ver_gt "enterprise-server@2.21" %} -To use Docker with {% data variables.product.prodname_registry %}, you must also enable subdomain isolation. For more information, see "[Configuring Docker for use with {% data variables.product.prodname_registry %}](/enterprise/{{ currentVersion }}/user/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)." +To use Docker with +{% data variables.product.prodname_registry %}, you must also enable subdomain isolation. For more information, see "[Configuring Docker for use with {% data variables.product.prodname_registry %}](/enterprise/{{ currentVersion }}/user/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)." {% data reusables.package_registry.packages-ghes-release-stage %} | {% endif %} -| Pfad ohne Subdomain-Isolation | Pfad mit Subdomain-Isolation | -| --------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- | -| `http(s)://HOSTNAME/assets/` | `http(s)://assets.HOSTNAME/` | -| `http(s)://HOSTNAME/avatars/` | `http(s)://avatars.HOSTNAME/` | -| `http(s)://HOSTNAME/codeload/` | `http(s)://codeload.HOSTNAME/` | -| `http(s)://HOSTNAME/gist/` | `http(s)://gist.HOSTNAME/` | -| `http(s)://HOSTNAME/media/` | `http(s)://media.HOSTNAME/` | -| `http(s)://HOSTNAME/pages/` | `http(s)://pages.HOSTNAME/` | -| `http(s)://HOSTNAME/raw/` | `http(s)://raw.HOSTNAME/` | -| `http(s)://HOSTNAME/render/` | `http(s)://render.HOSTNAME/` | -| `http(s)://HOSTNAME/reply/` | `http(s)://reply.HOSTNAME/` | -| `http(s)://HOSTNAME/uploads/` | `http(s)://uploads.HOSTNAME/` |{% if currentVersion ver_gt "enterprise-server@2.21" %} -| N/A, Docker with {% data variables.product.prodname_registry %} will not work with subdomain isolation disabled. | `http(s)://uploads.HOSTNAME/` | -| `https://HOSTNAME/_registry/npm/` | `https://npm.HOSTNAME/` | -| `https://HOSTNAME/_registry/rubygems/` | `https://rubygems.HOSTNAME/` | -| `https://HOSTNAME/_registry/maven/` | `https://maven.HOSTNAME/` | -| `https://HOSTNAME/_registry/nuget/` | `https://nuget.HOSTNAME/`{% endif %} +| Pfad ohne Subdomain-Isolation | Pfad mit Subdomain-Isolation | +| ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | +| `http(s)://HOSTNAME/assets/` | `http(s)://assets.HOSTNAME/` | +| `http(s)://HOSTNAME/avatars/` | `http(s)://avatars.HOSTNAME/` | +| `http(s)://HOSTNAME/codeload/` | `http(s)://codeload.HOSTNAME/` | +| `http(s)://HOSTNAME/gist/` | `http(s)://gist.HOSTNAME/` | +| `http(s)://HOSTNAME/media/` | `http(s)://media.HOSTNAME/` | +| `http(s)://HOSTNAME/pages/` | `http(s)://pages.HOSTNAME/` | +| `http(s)://HOSTNAME/raw/` | `http(s)://raw.HOSTNAME/` | +| `http(s)://HOSTNAME/render/` | `http(s)://render.HOSTNAME/` | +| `http(s)://HOSTNAME/reply/` | `http(s)://reply.HOSTNAME/` | +| `http(s)://HOSTNAME/uploads/` | `http(s)://uploads.HOSTNAME/` |{% if currentVersion ver_gt "enterprise-server@2.21" %} +| N/A, Docker with {% data variables.product.prodname_registry %} will not work with subdomain isolation disabled. | `http(s)://uploads.HOSTNAME/` | +| `https://HOSTNAME/_registry/npm/` | `https://npm.HOSTNAME/` | +| `https://HOSTNAME/_registry/rubygems/` | `https://rubygems.HOSTNAME/` | +| `https://HOSTNAME/_registry/maven/` | `https://maven.HOSTNAME/` | +| `https://HOSTNAME/_registry/nuget/` | `https://nuget.HOSTNAME/`{% endif %} ### Vorrausetzungen diff --git a/translations/de-DE/content/admin/configuration/index.md b/translations/de-DE/content/admin/configuration/index.md index 6f28feda41b7..4f14e525826e 100644 --- a/translations/de-DE/content/admin/configuration/index.md +++ b/translations/de-DE/content/admin/configuration/index.md @@ -40,7 +40,7 @@ versions: {% topic_link_in_list /managing-connections-between-github-enterprise-server-and-github-enterprise-cloud %} {% link_in_list /connecting-github-enterprise-server-to-github-enterprise-cloud %} {% link_in_list /enabling-unified-search-between-github-enterprise-server-and-githubcom %} - {% link_in_list /enabling-unified-contributions-between-github-enterprise-server-and-githubcom %} + {% link_in_list /enabling-unified-contributions-between-github-enterprise-server-and-githubcom %} {% link_in_list /enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server %} {% link_in_list /enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud %} @@ -49,3 +49,11 @@ versions: {% topic_link_in_list /configuring-advanced-security-features %} {% link_in_list /configuring-code-scanning-for-your-appliance %} + +{% if currentVersion ver_gt "enterprise-server@2.21" %} +{% note %} + +**Note:** To configure {% data variables.product.prodname_actions %} or {% data variables.product.prodname_registry %} for your enterprise, see "[Managing GitHub Actions for your enterprise](/admin/github-actions)" or "[Managing GitHub Packages for your enterprise](/admin/packages)." + +{% endnote %} +{% endif %} diff --git a/translations/de-DE/content/admin/configuration/network-ports.md b/translations/de-DE/content/admin/configuration/network-ports.md index 60f55405bcea..dd894fa83777 100644 --- a/translations/de-DE/content/admin/configuration/network-ports.md +++ b/translations/de-DE/content/admin/configuration/network-ports.md @@ -16,25 +16,25 @@ versions: Einige Verwaltungsports sind zum Konfigurieren von {% data variables.product.product_location_enterprise %} und zum Ausführen bestimmter Features erforderlich. Verwaltungsports sind für die einfache Verwendung von Anwendungen durch Endbenutzer nicht erforderlich. -| Port | Dienst | Beschreibung | -| -------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Port | Dienst | Beschreibung | +| -------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 8443 | HTTPS | Sichere webbasierte {% data variables.enterprise.management_console %}. Für die grundlegende Installation und Konfiguration erforderlich. | | 8080 | HTTP | Webbasierte {% data variables.enterprise.management_console %} im Nur-Text-Format. Nur erforderlich, wenn SSL manuell deaktiviert wird. | | 122 | SSH | Shellzugriff für {% data variables.product.product_location_enterprise %}. Muss für eingehende Verbindungen von allen anderen Knoten in einer Hochverfügbarkeitskonfiguration geöffnet sein. Der standardmäßige SSH-Port (22) ist für den Git- und SSH-Netzwerk-Traffic der Anwendung vorgesehen. | -| 1194/UDP | VPN | Sicherer Replikationsnetzwerktunnel in einer hochverfügbaren Konfiguration. Muss für alle anderen Knoten in der Konfiguration geöffnet sein. | -| 123/UDP | NTP | Für Zeitprotokollvorgänge erforderlich. | -| 161/UDP | SNMP | Für Netzwerküberwachungs-Protokollvorgänge erforderlich. | +| 1194/UDP | VPN | Sicherer Replikationsnetzwerktunnel in einer hochverfügbaren Konfiguration. Muss für alle anderen Knoten in der Konfiguration geöffnet sein. | +| 123/UDP | NTP | Für Zeitprotokollvorgänge erforderlich. | +| 161/UDP | SNMP | Für Netzwerküberwachungs-Protokollvorgänge erforderlich. | ### Anwendungsports für Endbenutzer Mit Anwendungsports können Endbenutzer auf Webanwendungen und Git zugreifen. -| Port | Dienst | Beschreibung | -| ---- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------- | -| 443 | HTTPS | Zugriff auf die Webanwendung und Git über HTTPS. | -| 80 | HTTP | Webanwendungszugriff. Alle Anforderungen werden an den HTTPS-Port weitergeleitet, wenn SSL aktiviert ist. | -| 22 | SSH | Zugriff auf Git über SSH. Unterstützt das Klonen, Abrufen und Übertragen von Vorgängen an öffentliche/private Repositorys. | -| 9418 | Git | Der Git-Protokollport unterstützt das Klonen und Abrufen von Vorgängen für öffentliche Repositorys mit unverschlüsselter Netzwerkkommunikation. | +| Port | Dienst | Beschreibung | +| ---- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 443 | HTTPS | Zugriff auf die Webanwendung und Git über HTTPS. | +| 80 | HTTP | Webanwendungszugriff. Alle Anforderungen werden an den HTTPS-Port weitergeleitet, wenn SSL aktiviert ist. | +| 22 | SSH | Zugriff auf Git über SSH. Unterstützt das Klonen, Abrufen und Übertragen von Vorgängen an öffentliche/private Repositorys. | +| 9418 | Git | Der Git-Protokollport unterstützt das Klonen und Abrufen von Vorgängen für öffentliche Repositorys mit unverschlüsselter Netzwerkkommunikation. {% data reusables.enterprise_installation.when-9418-necessary %} {% data reusables.enterprise_installation.terminating-tls %} diff --git a/translations/de-DE/content/admin/configuration/site-admin-dashboard.md b/translations/de-DE/content/admin/configuration/site-admin-dashboard.md index dd40b2867754..b614b0bd3662 100644 --- a/translations/de-DE/content/admin/configuration/site-admin-dashboard.md +++ b/translations/de-DE/content/admin/configuration/site-admin-dashboard.md @@ -15,7 +15,7 @@ Klicken Sie in der oberen rechten Ecke einer beliebigen Seite auf {% octicon "ro ### Suche -Hier können Sie die {% data variables.enterprise.management_console %} starten, um die Einstellungen der virtuellen Appliance zu verwalten, also beispielsweise die Domain, die Authentifizierung und SSL. +Hier können Sie die {{ site.data.variables.enterprise.management_console }} starten, um die Einstellungen der virtuellen Appliance zu verwalten, also beispielsweise die Domain, die Authentifizierung und SSL. {% else %} @@ -162,7 +162,7 @@ Dadurch wird gesteuert, wie der [Issues][]-Index repariert wird. Sie können ### Alle Benutzer -Hier können Sie alle Benutzer anzeigen, die auf {% data variables.product.product_location_enterprise %} gesperrt wurden, und [eine SSH-Schlüsselüberwachung initiieren](/enterprise/{{ currentVersion }}/admin/guides/user-management/auditing-ssh-keys). +Hier können Sie alle Benutzer anzeigen, die auf {{ site.data.variables.product.product_location_enterprise }} gesperrt wurden, und [eine SSH-Schlüsselüberwachung initiieren](/enterprise/{{ page.version }}/admin/guides/user-management/auditing-ssh-keys). {% endif %} diff --git a/translations/de-DE/content/admin/enterprise-management/about-geo-replication.md b/translations/de-DE/content/admin/enterprise-management/about-geo-replication.md index 50f677fb6846..0c1e3718fe0f 100644 --- a/translations/de-DE/content/admin/enterprise-management/about-geo-replication.md +++ b/translations/de-DE/content/admin/enterprise-management/about-geo-replication.md @@ -18,7 +18,7 @@ Damit die Geo-Replikation ordnungsgemäß funktioniert, ist Geo DNS, beispielswe ### Einschränkungen -Zum Senden von Anforderungen an das Replikat müssen die Daten an die primäre Instanz und an alle Replikate gesendet werden. Folglich ist die Leistung sämtlicher Schreibvorgänge auf das langsamste Replikat begrenzt{% if currentVersion ver_gt "enterprise-server@2.17" %}, wobei neue Geo-Replikate ein Seeding für den Großteil ihrer Daten von bestehenden Geo-Replikaten mit gleichem Speicherort aus anstatt von der primären Instanz aus ausführen können{% endif %}. Von der Geo-Replikation werden einer {% data variables.product.prodname_ghe_server %}-Instanz weder Kapazitäten hinzugefügt noch werden Leistungsprobleme in Bezug auf unzureichende CPU- oder Arbeitsspeicherressourcen behoben. Wenn die primäre Appliance offline ist, können aktive Replikate keine Lese- oder Schreibanforderungen verarbeiten. +Zum Senden von Anforderungen an das Replikat müssen die Daten an die primäre Instanz und an alle Replikate gesendet werden. This means that the performance of all writes are limited by the slowest replica, although new geo-replicas can seed the majority of their data from existing co-located geo-replicas, rather than from the primary. Von der Geo-Replikation werden einer {% data variables.product.prodname_ghe_server %}-Instanz weder Kapazitäten hinzugefügt noch werden Leistungsprobleme in Bezug auf unzureichende CPU- oder Arbeitsspeicherressourcen behoben. Wenn die primäre Appliance offline ist, können aktive Replikate keine Lese- oder Schreibanforderungen verarbeiten. ### Geo-Replikationskonfiguration überwachen diff --git a/translations/de-DE/content/admin/enterprise-management/about-high-availability-configuration.md b/translations/de-DE/content/admin/enterprise-management/about-high-availability-configuration.md index 662baed64cfe..a79548889e60 100644 --- a/translations/de-DE/content/admin/enterprise-management/about-high-availability-configuration.md +++ b/translations/de-DE/content/admin/enterprise-management/about-high-availability-configuration.md @@ -52,7 +52,7 @@ Verwenden Sie zum Verwalten der Replikation auf {% data variables.product.prodna Der Befehl `ghe-repl-setup` versetzt eine {% data variables.product.prodname_ghe_server %}-Appliance in den Replikat-Standbymodus. - - Ein verschlüsselter {% if currentVersion ver_gt "enterprise-server@2.17" %}WireGuard-VPN{% else %}Open-VPN{% endif %}-Tunnel ist für die Kommunikation zwischen den beiden Appliances konfiguriert. + - An encrypted WireGuard VPN tunnel is configured for communication between the two appliances. - Datenbankdienste werden für die Replikation konfiguriert und gestartet. - Anwendungsdienste werden deaktiviert. Wenn versucht wird, über HTTP, Git oder über andere unterstützte Protokolle auf die Replikat-Appliance zuzugreifen, wird die Wartungsseite „appliance in replica mode“ (Appliance im Replikatmodus) oder eine Fehlermeldung angezeigt. @@ -71,8 +71,7 @@ Run `ghe-repl-start' to start replicating against the newly configured primary. Der Befehl `ghe-repl-start` aktiviert die aktive Replikation sämtlicher Datenspeicher. ```shell -admin@169-254-1-2:~$ ghe-repl-start{% if currentVersion ver_lt "enterprise-server@2.18" %} -Starting OpenVPN tunnel ... {% endif %} +admin@169-254-1-2:~$ ghe-repl-start Starting MySQL replication ... Starting Redis replication ... Starting Elasticsearch replication ... @@ -144,8 +143,7 @@ Stopping Pages replication ... Stopping Git replication ... Stopping MySQL replication ... Stopping Redis replication ... -Stopping Elasticsearch replication ...{% if currentVersion ver_lt "enterprise-server@2.18" %} -Stopping OpenVPN tunnel ...{% endif %} +Stopping Elasticsearch replication ... Success: replication was stopped for all services. ``` @@ -163,8 +161,7 @@ Stopping replication ... | Stopping Git replication ... | Stopping MySQL replication ... | Stopping Redis replication ... - | Stopping Elasticsearch replication ...{% if currentVersion ver_lt "enterprise-server@2.18" %} - | Stopping OpenVPN tunnel ...{% endif %} + | Stopping Elasticsearch replication ... | Success: replication was stopped for all services. Switching out of replica mode ... | Success: Replication configuration has been removed. diff --git a/translations/de-DE/content/admin/enterprise-management/accessing-the-monitor-dashboard.md b/translations/de-DE/content/admin/enterprise-management/accessing-the-monitor-dashboard.md index 4390eb6ba978..c113c2c7cfbe 100644 --- a/translations/de-DE/content/admin/enterprise-management/accessing-the-monitor-dashboard.md +++ b/translations/de-DE/content/admin/enterprise-management/accessing-the-monitor-dashboard.md @@ -24,10 +24,10 @@ versions: Mit dem Überwachungs-Dashboard können Sie in Bezug auf den Ressourcenzustand Ihrer Appliance auf dem Laufenden bleiben und Entscheidungen treffen, wie Sie Probleme hinsichtlich hoher Nutzungen beheben können. -| Problem | Mögliche Ursache(n) | Empfehlungen | -| ----------------------------------------- | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Hohe CPU-Auslastung | VM-Konflikte von anderen auf demselben Host ausgeführten Diensten oder Programmen | Konfigurieren Sie nach Möglichkeit andere Dienste oder Programme so neu, dass sie weniger CPU-Ressourcen beanspruchen. Informationen zum Erhöhen der CPU-Gesamtressourcen für die VM finden Sie unter „[CPU- und Arbeitsspeicherressourcen erhöhen](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)“. | -| Hohe Arbeitsspeicherauslastung | VM-Konflikte von anderen auf demselben Host ausgeführten Diensten oder Programmen | Konfigurieren Sie nach Möglichkeit andere Dienste oder Programme so, dass sie weniger Arbeitsspeicher beanspruchen. Informationen zum Erhöhen des insgesamt auf der VM verfügbaren Arbeitsspeichers finden Sie unter „[CPU- und Arbeitsspeicherressourcen erhöhen](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)“. | -| Niedrige Festplattenspeicherverfügbarkeit | Große Binärdateien oder Protokolldateien, die Festplattenspeicher nutzen | Hosten Sie große Binärdateien nach Möglichkeit auf einem separaten Server, und komprimieren oder archivieren Sie Protokolldateien. Erhöhen Sie ggf. den Festplattenspeicher auf der VM. Befolgen Sie dazu die unter „[Speicherkapazität erhöhen](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity/)“ für Ihre Plattform angegebenen Schritte. | -| Ungewöhnlich hohe Antwortzeiten | Wird oft durch einen der obigen Issues verursacht | Identifizieren und beheben Sie die zugrunde liegenden Issues. Kontaktieren Sie {% data variables.contact.contact_ent_support %}, falls die Antwortzeiten hoch bleiben. | +| Problem | Mögliche Ursache(n) | Empfehlungen | +| ----------------------------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| Hohe CPU-Auslastung | VM-Konflikte von anderen auf demselben Host ausgeführten Diensten oder Programmen | Konfigurieren Sie nach Möglichkeit andere Dienste oder Programme so neu, dass sie weniger CPU-Ressourcen beanspruchen. Informationen zum Erhöhen der CPU-Gesamtressourcen für die VM finden Sie unter „[CPU- und Arbeitsspeicherressourcen erhöhen](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)“. | +| Hohe Arbeitsspeicherauslastung | VM-Konflikte von anderen auf demselben Host ausgeführten Diensten oder Programmen | Konfigurieren Sie nach Möglichkeit andere Dienste oder Programme so, dass sie weniger Arbeitsspeicher beanspruchen. Informationen zum Erhöhen des insgesamt auf der VM verfügbaren Arbeitsspeichers finden Sie unter „[CPU- und Arbeitsspeicherressourcen erhöhen](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)“. | +| Niedrige Festplattenspeicherverfügbarkeit | Große Binärdateien oder Protokolldateien, die Festplattenspeicher nutzen | Hosten Sie große Binärdateien nach Möglichkeit auf einem separaten Server, und komprimieren oder archivieren Sie Protokolldateien. Erhöhen Sie ggf. den Festplattenspeicher auf der VM. Befolgen Sie dazu die unter „[Speicherkapazität erhöhen](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity/)“ für Ihre Plattform angegebenen Schritte. | +| Ungewöhnlich hohe Antwortzeiten | Wird oft durch einen der obigen Issues verursacht | Identifizieren und beheben Sie die zugrunde liegenden Issues. Kontaktieren Sie {% data variables.contact.contact_ent_support %}, falls die Antwortzeiten hoch bleiben. | | Erhöhte Fehlerraten | Software-Issues | Kontaktieren Sie {% data variables.contact.contact_ent_support %}, und fügen Sie Ihr Support-Bundle hinzu. Weitere Informationen finden Sie unter „[Daten für den {% data variables.product.prodname_enterprise %}-Support bereitstellen](/enterprise/{{ currentVersion}}/admin/guides/enterprise-support/providing-data-to-github-support#creating-and-sharing-support-bundles)“. | diff --git a/translations/de-DE/content/admin/enterprise-management/cluster-network-configuration.md b/translations/de-DE/content/admin/enterprise-management/cluster-network-configuration.md index 4eda612b8742..0358b5d25d22 100644 --- a/translations/de-DE/content/admin/enterprise-management/cluster-network-configuration.md +++ b/translations/de-DE/content/admin/enterprise-management/cluster-network-configuration.md @@ -71,7 +71,6 @@ Wenn sich zwischen Knoten eine Firewall auf Netzwerkebene befindet, müssen dies | 8302/UDP | Consul | | 25827/UDP | Collectd | - ### Load-Balancer konfigurieren Sie sollten einen externen TCP-basierten Load-Balancer verwenden, der das PROXY-Protokoll unterstützt, um den Traffic auf die Knoten zu verteilen. Beachten Sie die folgenden Load-Balancer-Konfigurationen: diff --git a/translations/de-DE/content/admin/enterprise-management/creating-a-high-availability-replica.md b/translations/de-DE/content/admin/enterprise-management/creating-a-high-availability-replica.md index bbc26aa0edb1..f7229dee62c9 100644 --- a/translations/de-DE/content/admin/enterprise-management/creating-a-high-availability-replica.md +++ b/translations/de-DE/content/admin/enterprise-management/creating-a-high-availability-replica.md @@ -49,7 +49,7 @@ Diese Beispielkonfiguration verwendet eine primäre Instanz und zwei Replikate, (replica2)$ ghe-repl-setup --add PRIMARY IP (replica2)$ ghe-repl-start ``` -3. Standardmäßig sind Replikate für das gleiche Rechenzentrum konfiguriert{% if currentVersion ver_gt "enterprise-server@2.17" %} und versuchen nun, ein Seeding von einem vorhandenen Knoten im gleichen Rechenzentrum aus auszuführen{% endif %}. Konfigurieren Sie die Replikate für unterschiedliche Rechenzentren, indem Sie für die Rechenzentrumsoption einen anderen Wert festlegen. Die entsprechenden Werte sind beliebig, sie müssen sich nur voneinander unterscheiden. Führen Sie den Befehl `ghe-repl-node` auf jedem Knoten aus, und geben Sie das Rechenzentrum an. +3. By default, replicas are configured to the same datacenter, and will now attempt to seed from an existing node in the same datacenter. Konfigurieren Sie die Replikate für unterschiedliche Rechenzentren, indem Sie für die Rechenzentrumsoption einen anderen Wert festlegen. Die entsprechenden Werte sind beliebig, sie müssen sich nur voneinander unterscheiden. Führen Sie den Befehl `ghe-repl-node` auf jedem Knoten aus, und geben Sie das Rechenzentrum an. Auf der primären Instanz: ```shell diff --git a/translations/de-DE/content/admin/enterprise-management/index.md b/translations/de-DE/content/admin/enterprise-management/index.md index 8e6b0121bb25..ace035553669 100644 --- a/translations/de-DE/content/admin/enterprise-management/index.md +++ b/translations/de-DE/content/admin/enterprise-management/index.md @@ -8,7 +8,7 @@ versions: --- -### Table of Contents +### Inhaltsverzeichnis {% topic_link_in_list /monitoring-your-appliance %} {% link_in_list /accessing-the-monitor-dashboard %} @@ -16,8 +16,7 @@ versions: {% link_in_list /setting-up-external-monitoring %} {% link_in_list /configuring-collectd %} {% link_in_list /log-forwarding %} - {% link_in_list /monitoring-using-snmp %}{% if currentVersion ver_gt "enterprise-server@2.21" %} - {% link_in_list /monitoring-using-analytics %}{% endif %} + {% link_in_list /monitoring-using-snmp %} {% topic_link_in_list /updating-the-virtual-machine-and-physical-resources %} {% link_in_list /upgrade-requirements %} {% link_in_list /upgrading-github-enterprise-server %} diff --git a/translations/de-DE/content/admin/enterprise-management/monitoring-cluster-nodes.md b/translations/de-DE/content/admin/enterprise-management/monitoring-cluster-nodes.md index 6d6c8ba3409d..3195e5f048d2 100644 --- a/translations/de-DE/content/admin/enterprise-management/monitoring-cluster-nodes.md +++ b/translations/de-DE/content/admin/enterprise-management/monitoring-cluster-nodes.md @@ -1,15 +1,16 @@ --- -title: Monitoring cluster nodes -intro: 'A {% data variables.product.prodname_ghe_server %} cluster is comprised of redundant services that are distributed across two or more nodes. If an individual service or an entire node were to fail, it should not be immediately apparent to users of the cluster. However since performance and redundancy are affected, it is important to monitor the health of a {% data variables.product.prodname_ghe_server %} cluster.' +title: Clusterknoten überwachen +intro: 'Ein {% data variables.product.prodname_ghe_server %}-Cluster besteht aus redundanten Diensten, die auf mindestens zwei Knoten verteilt sind. Wenn ein einzelner Dienst oder ein gesamter Knoten fehlschlägt, sollte dies den Benutzern des Clusters sofort auffallen. Da jedoch Leistung und Redundanz betroffen sind, ist es wichtig, den Zustand eines {% data variables.product.prodname_ghe_server %}-Clusters zu überwachen.' redirect_from: - /enterprise/admin/clustering/monitoring-cluster-nodes - /enterprise/admin/enterprise-management/monitoring-cluster-nodes versions: enterprise-server: '*' --- -### Manually checking cluster status -{% data variables.product.prodname_ghe_server %} has a built-in command line utility for monitoring the health of the cluster. From the administrative shell, running the `ghe-cluster-status` command executes a series of health checks on each node including verification of connectivity and service status. The output shows all test results including the text `ok` or `error`. For example, to only display failing tests, run: +### Clusterstatus manuell überprüfen + +{% data variables.product.prodname_ghe_server %} besitzt ein integriertes Befehlszeilendienstprogramm zum Überwachen des Clusterzustands. Wenn in der Verwaltungsshell der Befehl `ghe-cluster-status` ausgeführt wird, werden einige Zustandsprüfungen auf jedem Knoten ausgeführt, darunter die Verifizierung der Konnektivität und des Dienststatus. Die Ausgabe enthält alle Testergebnisse, darunter der Text `ok` oder `error`. Führen Sie beispielsweise Folgendes aus, um nur fehlgeschlagene Tests anzuzeigen: ```shell admin@ghe-data-node-0:~$ ghe-cluster-status | grep error @@ -18,20 +19,20 @@ admin@ghe-data-node-0:~$ ghe-cluster-status | grep error ``` {% note %} -**Note:** If there are no failing tests, this command produces no output. This indicates the cluster is healthy. +**Hinweis:** Wenn keine fehlgeschlagenen Tests vorliegen, gibt dieser Befehl nichts aus. Dies gibt an, dass der Cluster fehlerfrei ist. {% endnote %} -### Monitoring cluster status with Nagios +### Clusterstatus mit Nagios überwachen -You can configure [Nagios](https://www.nagios.org/) to monitor {% data variables.product.prodname_ghe_server %}. In addition to monitoring basic connectivity to each of the cluster nodes, you can check the cluster status by configuring Nagios to use the `ghe-cluster-status -n` command. This returns output in a format that Nagios understands. +Sie können [Nagios](https://www.nagios.org/) für die Überwachung von {% data variables.product.prodname_ghe_server %} konfigurieren. Zusätzlich zur Überwachung der grundlegenden Konnektivität jedes Clusterknotens können Sie den Clusterstatus überprüfen, indem Sie Nagios für die Verwendung des Befehls `ghe-cluster-status -n` konfigurieren. Dadurch wird eine für Nagios verständliche Ausgabe zurückgegeben. -#### Prerequisites -* Linux host running Nagios. -* Network access to the {% data variables.product.prodname_ghe_server %} cluster. +#### Vorrausetzungen +* Linux-Host, auf dem Nagios ausgeführt wird. +* Netzwerkzugriff auf den {% data variables.product.prodname_ghe_server %}-Cluster. -#### Configuring the Nagios host -1. Generate an SSH key with a blank passphrase. Nagios uses this to authenticate to the {% data variables.product.prodname_ghe_server %} cluster. +#### Nagios-Host konfigurieren +1. Generieren Sie einen SSH-Schlüssel mit einer leeren Passphrase. Nagios verwendet diese, um sich beim {% data variables.product.prodname_ghe_server %}-Cluster zu authentifizieren. ```shell nagiosuser@nagios:~$ ssh-keygen -t rsa -b 4096 > Generating public/private rsa key pair. @@ -43,18 +44,18 @@ You can configure [Nagios](https://www.nagios.org/) to monitor {% data variables ``` {% danger %} - **Security Warning:** An SSH key without a passphrase can pose a security risk if authorized for full access to a host. Limit this key's authorization to a single read-only command. + **Sicherheitswarnung:** Ein SSH-Schlüssel ohne eine Passphrase kann ein Sicherheitsrisiko darstellen, wenn er für den vollen Zugriff auf einen Host berechtigt ist. Begrenzen Sie die Autorisierung dieses Schlüssels auf einen einzelnen schreibgeschützten Befehl. {% enddanger %} -2. Copy the private key (`id_rsa`) to the `nagios` home folder and set the appropriate ownership. +2. Kopieren Sie den privaten Schlüssel (`id_rsa`) in den Startordner `nagios`, und legen Sie die entsprechende Inhaberschaft fest. ```shell nagiosuser@nagios:~$ sudo cp .ssh/id_rsa /var/lib/nagios/.ssh/ nagiosuser@nagios:~$ sudo chown nagios:nagios /var/lib/nagios/.ssh/id_rsa ``` -3. To authorize the public key to run *only* the `ghe-cluster-status -n` command, use a `command=` prefix in the `/data/user/common/authorized_keys` file. From the administrative shell on any node, modify this file to add the public key generated in step 1. For example: `command="/usr/local/bin/ghe-cluster-status -n" ssh-rsa AAAA....` +3. Verwenden Sie das Präfix `command=` in der Datei `/data/user/common/authorized_keys`, um den öffentlichen Schlüssel *nur* für den Befehl `ghe-cluster-status -n` zu autorisieren. Ändern Sie in der Verwaltungsshell oder auf einem beliebigen Knoten diese Datei, um den in Schritt 1 generierten öffentlichen Schlüssel hinzuzufügen. Zum Beispiel: `command="/usr/local/bin/ghe-cluster-status -n" ssh-rsa AAAA....` -4. Validate and copy the configuration to each node in the cluster by running `ghe-cluster-config-apply` on the node where you modified the `/data/user/common/authorized_keys` file. +4. Validieren und kopieren Sie die Konfiguration auf jeden Knoten im Cluster. Führen Sie dazu `ghe-cluster-config-apply` auf dem Knoten aus, auf dem Sie die Datei `/data/user/common/authorized_keys` geändert haben. ```shell admin@ghe-data-node-0:~$ ghe-cluster-config-apply @@ -63,14 +64,15 @@ You can configure [Nagios](https://www.nagios.org/) to monitor {% data variables > Finished cluster configuration ``` -5. To test that the Nagios plugin can successfully execute the command, run it interactively from Nagios host. +5. Um zu testen, ob das Nagios-Plug-in den Befehl erfolgreich ausführen kann, führen Sie es auf dem Nagios-Host interaktiv aus. ```shell nagiosuser@nagios:~$ /usr/lib/nagios/plugins/check_by_ssh -l admin -p 122 -H hostname -C "ghe-cluster-status -n" -t 30 > OK - No errors detected ``` -6. Create a command definition in your Nagios configuration. - ###### Example definition +6. Erstellen Sie eine Befehlsdefinition in Ihrer Nagios-Konfiguration. + + ###### Beispieldefinition ``` define command { @@ -78,9 +80,10 @@ You can configure [Nagios](https://www.nagios.org/) to monitor {% data variables command_line $USER1$/check_by_ssh -H $HOSTADDRESS$ -C "ghe-cluster-status -n" -l admin -p 122 -t 30 } ``` -7. Add this command to a service definition for a node in the {% data variables.product.prodname_ghe_server %} cluster. +7. Fügen Sie diesen Befehl zu einer Dienstdefinition für einen Knoten im {% data variables.product.prodname_ghe_server %}-Cluster hinzu. + - ###### Example definition + ###### Beispieldefinition ``` define host{ @@ -98,6 +101,6 @@ You can configure [Nagios](https://www.nagios.org/) to monitor {% data variables } ``` -Once you add the definition to Nagios, the service check executes according to your configuration. You should be able to see the newly configured service in the Nagios web interface. +Nachdem Sie Nagios die Definition hinzugefügt haben, wird die Dienstüberprüfung entsprechend Ihrer Konfiguration ausgeführt. Sie sollten den neu konfigurierten Dienst auf der Nagios-Weboberfläche anzeigen können. -![Nagios Example](/assets/images/enterprise/cluster/nagios-example.png) +![Nagios-Beispiel](/assets/images/enterprise/cluster/nagios-example.png) diff --git a/translations/de-DE/content/admin/enterprise-management/upgrading-a-cluster.md b/translations/de-DE/content/admin/enterprise-management/upgrading-a-cluster.md index c59bd47811ec..452b4f7e9758 100644 --- a/translations/de-DE/content/admin/enterprise-management/upgrading-a-cluster.md +++ b/translations/de-DE/content/admin/enterprise-management/upgrading-a-cluster.md @@ -50,7 +50,7 @@ Verwenden Sie ein Upgrade-Paket, um ein Upgrade eines {% data variables.product. #### Clusterknoten upgraden 1. Aktivieren Sie den Wartungsmodus entsprechend Ihrem geplanten Fenster. Verbinden Sie sich dazu mit der Verwaltungsshell auf einem beliebigen Clusterknoten, und führen Sie `ghe-cluster-maintenance -s` aus. -2. **With the exception of the primary MySQL node**, connect to the administrative shell of each of the {% data variables.product.prodname_ghe_server %} nodes. Führen Sie den Befehl `ghe-upgrade` aus, und geben Sie den Namen der Paketdatei an, die Sie in Schritt 4 [Upgrade vorbereiten](#preparing-to-upgrade) heruntergeladen haben: +2. Stellen Sie **mit Ausnahme des primären MySQL-Knotens** eine Verbindung zur Verwaltungsshell der jeweiligen {% data variables.product.prodname_ghe_server %}-Knoten her. Führen Sie den Befehl `ghe-upgrade` aus, und geben Sie den Namen der Paketdatei an, die Sie in Schritt 4 [Upgrade vorbereiten](#preparing-to-upgrade) heruntergeladen haben: ```shell $ ghe-upgrade PACKAGE-FILENAME.pkg > *** verifying upgrade package signature... diff --git a/translations/de-DE/content/admin/enterprise-support/about-github-enterprise-support.md b/translations/de-DE/content/admin/enterprise-support/about-github-enterprise-support.md index 531834a0ee2f..81266f687ceb 100644 --- a/translations/de-DE/content/admin/enterprise-support/about-github-enterprise-support.md +++ b/translations/de-DE/content/admin/enterprise-support/about-github-enterprise-support.md @@ -29,7 +29,7 @@ Zusätzlich zu den Vorteilen des {% data variables.contact.enterprise_support %} - Geplante Zustandsprüfungen - Verwaltete Dienste -Weitere Informationen finden Sie unter „[Informationen zum {% data variables.contact.premium_support %} für {% data variables.product.prodname_ghe_server %}](/enterprise/admin/guides/enterprise-support/about-github-premium-support-for-github-enterprise-server)“. +Weitere Informationen finden Sie unter „[Informationen zum {{ site.data.variables.contact.premium_support }} für {% data variables.product.prodname_ghe_server %}](/enterprise/admin/guides/enterprise-support/about-github-premium-support-for-github-enterprise-server)“. {% data reusables.support.scope-of-support %} diff --git a/translations/de-DE/content/admin/enterprise-support/about-github-premium-support-for-github-enterprise-server.md b/translations/de-DE/content/admin/enterprise-support/about-github-premium-support-for-github-enterprise-server.md index fa4fda28cb39..f781a17e831b 100644 --- a/translations/de-DE/content/admin/enterprise-support/about-github-premium-support-for-github-enterprise-server.md +++ b/translations/de-DE/content/admin/enterprise-support/about-github-premium-support-for-github-enterprise-server.md @@ -51,7 +51,7 @@ Sie müssen die mindestens unterstützte Version von {% data variables.product.p ### Einem Support-Ticket eine Priorität zuweisen -Wenn Du den {% data variables.contact.premium_support %} kontaktierst, kannst Du eine von vier Prioritäten für das Ticket auswählen: „{% data variables.product.support_ticket_priority_urgent %}“ (dringend), „{% data variables.product.support_ticket_priority_high %}“ (hoch), „{% data variables.product.support_ticket_priority_normal %}“ (normal) oder „{% data variables.product.support_ticket_priority_low %}“ (niedrig). +Wenn Du {% data variables.contact.premium_support %}kontaktierst, kannst Du eine von vier Prioritäten für das Ticket auswählen: {% data variables.product.support_ticket_priority_urgent %}, {% data variables.product.support_ticket_priority_high %}, {% data variables.product.support_ticket_priority_normal %} oder {% data variables.product.support_ticket_priority_low %}. {% data reusables.support.github-can-modify-ticket-priority %} diff --git a/translations/de-DE/content/admin/enterprise-support/about-github-premium-support-for-github-enterprise.md b/translations/de-DE/content/admin/enterprise-support/about-github-premium-support-for-github-enterprise.md index 75c1569318ff..310d2e73ab09 100644 --- a/translations/de-DE/content/admin/enterprise-support/about-github-premium-support-for-github-enterprise.md +++ b/translations/de-DE/content/admin/enterprise-support/about-github-premium-support-for-github-enterprise.md @@ -49,7 +49,7 @@ Sie müssen die mindestens unterstützte Version von {% data variables.product.p ### Einem Support-Ticket eine Priorität zuweisen -Wenn Du den {% data variables.contact.premium_support %} kontaktierst, kannst Du eine von vier Prioritäten für das Ticket auswählen: „{% data variables.product.support_ticket_priority_urgent %}“ (dringend), „{% data variables.product.support_ticket_priority_high %}“ (hoch), „{% data variables.product.support_ticket_priority_normal %}“ (normal) oder „{% data variables.product.support_ticket_priority_low %}“ (niedrig). +Wenn Du {% data variables.contact.premium_support %}kontaktierst, kannst Du eine von vier Prioritäten für das Ticket auswählen: {% data variables.product.support_ticket_priority_urgent %}, {% data variables.product.support_ticket_priority_high %}, {% data variables.product.support_ticket_priority_normal %} oder {% data variables.product.support_ticket_priority_low %}. - [Ticket-Prioritäten für {% data variables.product.prodname_ghe_cloud %}](#ticket-priorities-for-github-enterprise-cloud) - [Ticket-Prioritäten für {% data variables.product.prodname_ghe_server %}](#ticket-priorities-for-github-enterprise-server) diff --git a/translations/de-DE/content/admin/enterprise-support/about-support-for-advanced-security.md b/translations/de-DE/content/admin/enterprise-support/about-support-for-advanced-security.md index 128b3453e701..26dd60512799 100644 --- a/translations/de-DE/content/admin/enterprise-support/about-support-for-advanced-security.md +++ b/translations/de-DE/content/admin/enterprise-support/about-support-for-advanced-security.md @@ -19,7 +19,7 @@ versions: ### Supportumfang -Wenn Deine Supportanfrage außerhalb des Bereichs liegt, in dem unser Team Dir helfen kann, können wir weiter Schritte empfehlen, damit Du Deinen Issue außerhalb von {% data variables.contact.enterprise_support %} beheben kannst. Deine Supportanfrage liegt möglicherweise nicht im Bereich von {% data variables.contact.enterprise_support %}, wenn sie sich primär auf Folgendes bezieht: +Wenn Ihre Supportanfrage außerhalb des Geltungsbereichs liegt, bei dem unser Team Ihnen helfen kann, können wir Ihnen die nächsten Schritte empfehlen, damit Sie Ihren Issue außerhalb von {% data variables.contact.enterprise_support %} beheben können. Ihre Supportanfrage liegt möglicherweise nicht im Umfang von {% data variables.contact.enterprise_support %}, wenn sie sich primär auf Folgendes bezieht: - Integration von Drittanbietern - Hardware-Einstellungen - Konfiguration externer Systeme @@ -70,8 +70,8 @@ Wenn Du den {% data variables.contact.enterprise_support %} um Hilfe mit {% data {% data reusables.support.github-can-modify-ticket-priority %} -| Priorität | Beschreibung | -|:------------------------------------------------------------------:| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Priorität | Beschreibung | +|:-------------------------------------------------------------:| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | {% data variables.product.support_ticket_priority_high %} | {% data variables.product.prodname_advanced_security %} funktioniert nicht oder bricht ab oder ist stark beeinträchtigt, so dass der Endbenutzer die Software nicht vernünftig nutzen kann und es gibt keine Möglichkeit, das Problem zu umgehen. | | {% data variables.product.support_ticket_priority_normal %} | {% data variables.product.prodname_advanced_security %} funktioniert inkonsistent, was die Nutzung und Produktivität für den Endbenutzer beeinträchtigt. | | {% data variables.product.support_ticket_priority_low %} | {% data variables.product.prodname_advanced_security %} funktioniert beständig, aber der Endbenutzer bittet um geringfügige Änderungen in der Software, wie z.B. Dokumentationsaktualisierungen, Behebung kosmetischer Fehler oder Erweiterungen. | diff --git a/translations/de-DE/content/admin/enterprise-support/reaching-github-support.md b/translations/de-DE/content/admin/enterprise-support/reaching-github-support.md index ce41bd38365f..bbbf8b52ef50 100644 --- a/translations/de-DE/content/admin/enterprise-support/reaching-github-support.md +++ b/translations/de-DE/content/admin/enterprise-support/reaching-github-support.md @@ -37,7 +37,7 @@ Weitere Informationen zu den Weiterbildungsmöglichkeiten, einschließlich indiv {% note %} -**Hinweis:** Schulungen sind im Leistungsumfang des {% data variables.product.premium_plus_support_plan %}s enthalten. Weitere Informationen finden Sie unter „[Informationen zum {% data variables.contact.premium_support %} für {% data variables.product.prodname_ghe_server %}](/enterprise/admin/guides/enterprise-support/about-github-premium-support-for-github-enterprise-server)“. +**Hinweis:** Schulungen sind im Leistungsumfang des {% data variables.product.premium_plus_support_plan %}s enthalten. Weitere Informationen finden Sie unter „[Informationen zum {{ site.data.variables.contact.premium_support }} für {% data variables.product.prodname_ghe_server %}](/enterprise/admin/guides/enterprise-support/about-github-premium-support-for-github-enterprise-server)“. {% endnote %} diff --git a/translations/de-DE/content/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server.md b/translations/de-DE/content/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server.md index 0a593d7c63ab..5c89f88a10d3 100644 --- a/translations/de-DE/content/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server.md +++ b/translations/de-DE/content/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server.md @@ -3,7 +3,6 @@ title: About using GitHub.com actions on GitHub Enterprise Server intro: '{% data variables.product.prodname_ghe_server %} includes most {% data variables.product.prodname_dotcom %}-authored actions, and has options for enabling access to other actions from {% data variables.product.prodname_dotcom_the_website %} and {% data variables.product.prodname_marketplace %}.' redirect_from: - /enterprise/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server - - /enterprise/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server versions: enterprise-server: '>=2.22' --- diff --git a/translations/de-DE/content/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise.md b/translations/de-DE/content/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise.md index 9ed25f049984..0ad89a74ace7 100644 --- a/translations/de-DE/content/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise.md +++ b/translations/de-DE/content/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise.md @@ -3,7 +3,6 @@ title: Enforcing GitHub Actions policies for your enterprise intro: 'Enterprise administrators can manage access to {% data variables.product.prodname_actions %} in an enterprise.' redirect_from: - /enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise - - /enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise versions: enterprise-server: '>=2.22' --- diff --git a/translations/de-DE/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md b/translations/de-DE/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md index 95b47736b792..3fb5f51521e1 100644 --- a/translations/de-DE/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md +++ b/translations/de-DE/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md @@ -69,7 +69,7 @@ You can populate the runner tool cache by running a {% data variables.product.pr path: ${{runner.tool_cache}}/tool_cache.tar.gz ``` {% endraw %} -1. Download the tool cache artifact from the workflow run. For instructions on downloading artifacts, see "[Persisting workflow data using artifacts](/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts#downloading-and-deleting-artifacts-after-a-workflow-run-is-complete)." +1. Download the tool cache artifact from the workflow run. For instructions on downloading artifacts, see "[Downloading workflow artifacts](/actions/managing-workflow-runs/downloading-workflow-artifacts)." 1. Transfer the tool cache artifact to your self hosted runner and extract it to the local tool cache directory. The default tool cache directory is `RUNNER_DIR/_work/_tool`. If the runner hasn't processed any jobs yet, you might need to create the `_work/_tool` directories. After extracting the tool cache artifact uploaded in the above example, you should have a directory structure on your self-hosted runner that is similar to the following example: diff --git a/translations/de-DE/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md b/translations/de-DE/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md index c8ae3fbc9eac..a7a135e45298 100644 --- a/translations/de-DE/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md +++ b/translations/de-DE/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md @@ -24,7 +24,8 @@ Bevor Sie {% data variables.product.product_location_enterprise %} auf Google Cl #### Unterstützte Maschinentypen -{% data variables.product.prodname_ghe_server %} wird auf den folgenden Google Compute Engine-Maschinentypen (GCE) unterstützt. Weitere Informationen finden Sie im Google Cloud Platform-Artikel zu den „[Maschinentypen](https://cloud.google.com/compute/docs/machine-types)“. | +{% data variables.product.prodname_ghe_server %} wird auf den folgenden Google Compute Engine-Maschinentypen (GCE) unterstützt. Weitere Informationen finden Sie im Google Cloud Platform-Artikel zu den „[Maschinentypen](https://cloud.google.com/compute/docs/machine-types)“. +| {% if currentVersion != "free-pro-team@latest" %} | | Oberer Speicher | | | --------------- | diff --git a/translations/de-DE/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md b/translations/de-DE/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md index d32ea9f5c551..5a02640ce049 100644 --- a/translations/de-DE/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md +++ b/translations/de-DE/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md @@ -29,7 +29,9 @@ versions: {% data reusables.enterprise_installation.create-ghe-instance %} -1. Laden Sie in OpenStack Horizon das von Ihnen heruntergeladene {% data variables.product.prodname_ghe_server %}-Image hoch. For instructions, see the "Upload an image" section of the OpenStack guide "[Upload and manage images](https://docs.openstack.org/horizon/latest/user/manage-images.html)." +1. In OpenStack Horizon, upload the + +{% data variables.product.prodname_ghe_server %} image you downloaded. For instructions, see the "Upload an image" section of the OpenStack guide "[Upload and manage images](https://docs.openstack.org/horizon/latest/user/manage-images.html)." {% data reusables.enterprise_installation.create-attached-storage-volume %} For instructions, see the OpenStack guide "[Create and manage volumes](https://docs.openstack.org/horizon/latest/user/manage-volumes.html)." 3. Erstellen Sie eine Sicherheitsgruppe, und fügen Sie für jeden in der Tabelle aufgelisteten Port eine neue Sicherheitsgruppenregel hinzu. Anweisungen finden Sie im OpenStack-Leitfaden „[Configure access and security for instances](https://docs.openstack.org/horizon/latest/user/configure-access-and-security-for-instances.html)“. diff --git a/translations/de-DE/content/admin/overview/about-enterprise-accounts.md b/translations/de-DE/content/admin/overview/about-enterprise-accounts.md index daa20693c5fc..038f4fe8745a 100644 --- a/translations/de-DE/content/admin/overview/about-enterprise-accounts.md +++ b/translations/de-DE/content/admin/overview/about-enterprise-accounts.md @@ -10,12 +10,12 @@ versions: ### Informationen zu Unternehmenskonten auf {% data variables.product.prodname_ghe_server %} -Mit einem Unternehmens-Konto kannst Du mehrere {% data variables.product.prodname_dotcom %}-Organisationen und {% data variables.product.prodname_ghe_server %}-Instanzen verwalten. Dein Enterprise-Konto benötigt einen Anker, wie zum Beispiel eine Organisation oder ein persönliches Konto auf {% data variables.product.prodname_dotcom %}. Enterprise-Administratoren können Einstellungen und Voreinstellungen verwalten, darunter folgende: +Mit einem Unternehmens-Konto kannst Du mehrere {% data variables.product.prodname_dotcom %}-Organisationen und {% data variables.product.prodname_ghe_server %}-Instanzen verwalten. Ihr Enterprise-Konto benötigt einen Handle, beispielsweise eine Organisation oder ein persönliches Konto auf {% data variables.product.prodname_dotcom %}. Enterprise-Administratoren können Einstellungen und Voreinstellungen verwalten, darunter folgende: - Mitgliederzugang und -verwaltung (Organisationsmitglieder, externe Mitarbeiter) - Abrechnung und Nutzung ({% data variables.product.prodname_ghe_server %}-Instanzen, Benutzerlizenzen, {% data variables.large_files.product_name_short %}-Pakete) - Sicherheit (Single-Sign-On, Zwei-Faktor-Authentifizierung) -- Anfragen und Support-Paket-Einreichung bei {% data variables.contact.enterprise_support %} +- Anfragen und Unterstützen von Bundle-Sharing mit {% data variables.contact.enterprise_support %} {% data reusables.enterprise-accounts.enterprise-accounts-billing %} diff --git a/translations/de-DE/content/admin/overview/about-the-github-enterprise-server-api.md b/translations/de-DE/content/admin/overview/about-the-github-enterprise-server-api.md index c4a755153233..19ceddf9c306 100644 --- a/translations/de-DE/content/admin/overview/about-the-github-enterprise-server-api.md +++ b/translations/de-DE/content/admin/overview/about-the-github-enterprise-server-api.md @@ -15,5 +15,5 @@ For the complete documentation for {% data variables.product.prodname_enterprise - Änderungen in der {% data variables.enterprise.management_console %} durchführen. For more information, see "[{% data variables.enterprise.management_console %}](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#management-console)." - Statistiken zu Ihrer Instanz erfassen. For more information, see "[Admin stats](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#admin-stats)." -- Die LDAP-Synchronisierung konfigurieren. For more information, see "[LDAP](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#ldap)."{% if currentVersion ver_gt "enterprise-server@2.18" %} -- Verwalte Dein Unternehmenskonto. Weitere Informationen findest Du unter „[Unternehmenskonten](/v4/guides/managing-enterprise-accounts).“{% endif %} +- Die LDAP-Synchronisierung konfigurieren. For more information, see "[LDAP](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#ldap)." +- Verwalte Dein Unternehmenskonto. Weitere Informationen findest Du unter „[Unternehmenskonten](/v4/guides/managing-enterprise-accounts).“ diff --git a/translations/de-DE/content/admin/overview/managing-your-github-enterprise-license.md b/translations/de-DE/content/admin/overview/managing-your-github-enterprise-license.md index 5a9a5b25f0d4..4982cb0787b7 100644 --- a/translations/de-DE/content/admin/overview/managing-your-github-enterprise-license.md +++ b/translations/de-DE/content/admin/overview/managing-your-github-enterprise-license.md @@ -34,7 +34,8 @@ Wenn Du Benutzerlizenzen erneuern oder zu {% data variables.product.prodname_ent {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.enterprise-licensing-tab %} 4. Under "Enterprise Server Instances", click {% octicon "download" aria-label="The download icon" %} to download your license file. ![GitHub Enterprise Server-Lizenz herunterladen](/assets/images/help/business-accounts/download-ghes-license.png) -5. Log into your {% data variables.product.prodname_ghe_server %} instance as a site administrator. +5. Log into your +{% data variables.product.prodname_ghe_server %} instance as a site administrator. {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.settings-tab %} @@ -63,7 +64,8 @@ Auf {% data variables.product.prodname_ghe_server %} können Sie eine JSON-Datei {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.license-tab %} 5. Klicken Sie unter „Quick links“ (Schnellzugriff) auf **Export license usage** (Lizenznutzung exportieren), um eine Datei herunterzuladen, in der Ihre aktuelle Lizenznutzung auf {% data variables.product.prodname_ghe_server %} enthalten ist. ![Link zum Exportieren der Lizenznutzung](/assets/images/enterprise/business-accounts/export-license-usage-link.png) -6. Navigieren Sie zu {% data variables.product.prodname_ghe_cloud %} +6. Navigate to +{% data variables.product.prodname_ghe_cloud %}. {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.enterprise-licensing-tab %} diff --git a/translations/de-DE/content/admin/packages/enabling-github-packages-for-your-enterprise.md b/translations/de-DE/content/admin/packages/enabling-github-packages-for-your-enterprise.md index a4fa6bdb63a1..55856d7cb0a0 100644 --- a/translations/de-DE/content/admin/packages/enabling-github-packages-for-your-enterprise.md +++ b/translations/de-DE/content/admin/packages/enabling-github-packages-for-your-enterprise.md @@ -3,7 +3,6 @@ title: Enabling GitHub Packages for your enterprise intro: 'You can start using {% data variables.product.prodname_registry %} on your instance by enabling the feature, configuring third-party storage, configuring the ecosystems you want to support, and updating your TLS certificate.' redirect_from: - /enterprise/admin/packages/enabling-github-packages-for-your-enterprise - - /enterprise/admin/packages/enabling-github-packages-for-your-enterprise versions: enterprise-server: '>=2.22' --- diff --git a/translations/de-DE/content/admin/packages/index.md b/translations/de-DE/content/admin/packages/index.md index f17495b79941..d677721898a2 100644 --- a/translations/de-DE/content/admin/packages/index.md +++ b/translations/de-DE/content/admin/packages/index.md @@ -4,7 +4,6 @@ shortTitle: GitHub Packages intro: 'You can enable {% data variables.product.prodname_registry %} for your enterprise and manage {% data variables.product.prodname_registry %} settings and allowed packaged types.' redirect_from: - /enterprise/admin/packages - - /enterprise/admin/packages versions: enterprise-server: '>=2.22' --- diff --git a/translations/de-DE/content/admin/policies/creating-a-pre-receive-hook-script.md b/translations/de-DE/content/admin/policies/creating-a-pre-receive-hook-script.md index 5f9f81da5d9d..659b79cbb3c2 100644 --- a/translations/de-DE/content/admin/policies/creating-a-pre-receive-hook-script.md +++ b/translations/de-DE/content/admin/policies/creating-a-pre-receive-hook-script.md @@ -1,6 +1,6 @@ --- title: Pre-Receive-Hook-Skript erstellen -intro: 'Verwenden Sie Pre-Receive-Hook-Skripts, um Anforderungen zum Akzeptieren oder Ablehnen eines Push-Vorgangs anhand der Inhalte zu erstellen.' +intro: Verwenden Sie Pre-Receive-Hook-Skripts, um Anforderungen zum Akzeptieren oder Ablehnen eines Push-Vorgangs anhand der Inhalte zu erstellen. redirect_from: - /enterprise/admin/developer-workflow/creating-a-pre-receive-hook-script - /enterprise/admin/policies/creating-a-pre-receive-hook-script @@ -182,7 +182,7 @@ Sie können ein Pre-Receive-Hook-Skript lokal testen, bevor Sie es auf Ihrer {% $ git clone git@github.com:octocat/Hello-World.git $ cd Hello-World $ git remote add test git@127.0.0.1:test.git - $ GIT_SSH_COMMAND="ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no -p 52311 -i ../id_rsa" git push -u test master + $ GIT_SSH_COMMAND="ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no -p 52311 -i ../id_rsa" git push -u test main > Warning: Permanently added '[192.168.99.100]:52311' (ECDSA) to the list of known hosts. > Counting objects: 7, done. > Delta compression using up to 4 threads. @@ -191,7 +191,7 @@ Sie können ein Pre-Receive-Hook-Skript lokal testen, bevor Sie es auf Ihrer {% > Total 7 (delta 0), reused 7 (delta 0) > remote: error: rejecting all pushes > To git@192.168.99.100:test.git - > ! [remote rejected] master -> master (pre-receive hook declined) + > ! [remote rejected] main -> main (pre-receive hook declined) > error: failed to push some refs to 'git@192.168.99.100:test.git' ``` diff --git a/translations/de-DE/content/admin/policies/enforcing-policies-for-your-enterprise.md b/translations/de-DE/content/admin/policies/enforcing-policies-for-your-enterprise.md index 68a168bda556..6d8a1b6daf81 100644 --- a/translations/de-DE/content/admin/policies/enforcing-policies-for-your-enterprise.md +++ b/translations/de-DE/content/admin/policies/enforcing-policies-for-your-enterprise.md @@ -3,7 +3,6 @@ title: Enforcing policies for your enterprise mapTopic: true redirect_from: - /enterprise/admin/policies/enforcing-policies-for-your-enterprise - - /enterprise/admin/policies/enforcing-policies-for-your-enterprise versions: enterprise-server: '*' --- diff --git a/translations/de-DE/content/admin/policies/enforcing-policy-with-pre-receive-hooks.md b/translations/de-DE/content/admin/policies/enforcing-policy-with-pre-receive-hooks.md index fe165808b3c8..724db7cb835d 100644 --- a/translations/de-DE/content/admin/policies/enforcing-policy-with-pre-receive-hooks.md +++ b/translations/de-DE/content/admin/policies/enforcing-policy-with-pre-receive-hooks.md @@ -1,6 +1,6 @@ --- title: Enforcing policy with pre-receive hooks -intro: 'Mithilfe von Pre-Receive-Hooks können Sie Workflow-Standards in Ihrer Organisation erzwingen. Zum Verwenden von Pre-Receive-Hooks muss der Code einen vordefinierten Satz an Qualitätsprüfungen bestehen, bevor der Push in das Repository akzeptiert wird.' +intro: Mithilfe von Pre-Receive-Hooks können Sie Workflow-Standards in Ihrer Organisation erzwingen. Zum Verwenden von Pre-Receive-Hooks muss der Code einen vordefinierten Satz an Qualitätsprüfungen bestehen, bevor der Push in das Repository akzeptiert wird. mapTopic: true redirect_from: - /enterprise/admin/developer-workflow/using-pre-receive-hooks-to-enforce-policy diff --git a/translations/de-DE/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md b/translations/de-DE/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md index b4cb64b269f9..c47ed60e08e5 100644 --- a/translations/de-DE/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md +++ b/translations/de-DE/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md @@ -1,6 +1,6 @@ --- title: Enforcing repository management policies in your enterprise -intro: 'Enterprise owners can enforce certain repository management policies for all organizations owned by an enterprise account, or allow policies to be set in each organization.' +intro: 'Enterprise-Inhaber können bestimmte Richtlinien zur Repository-Verwaltung für alle Organisationen erzwingen, die einem Enterprise-Konto gehören, oder zulassen, dass Richtlinien in jeder Organisation festgelegt werden.' redirect_from: - /enterprise/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance - /enterprise/admin/guides/user-management/preventing-users-from-changing-a-repository-s-visibility @@ -29,15 +29,15 @@ versions: enterprise-server: '*' --- -### Configuring the default visibility of new repositories on your appliance +### Standardmäßige Sichtbarkeit neuer Repositorys auf Ihrer Appliance konfigurieren -Each time someone creates a new repository on {% data variables.product.product_location_enterprise %}, that person must choose a visibility for the repository. When you configure a default visibility setting for the instance, you choose which visibility is selected by default. For more information on repository visibility, see "[About repository visibility](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)." +Jedes Mal, wenn jemand ein neues Repository auf {% data variables.product.product_location_enterprise %} anlegt, muss diese Person eine Sichtbarkeit für das Repository auswählen. Wenn Du eine Standard-Sichtbarkeitseinstellung für die Instanz einstellst, wählst Du aus, welche Sichtbarkeit standardmäßig gilt. Weitere Informationen zu Repository-Sichtbarkeiten findest Du unter „[Informationen zur Sichtbarkeit eines Repositorys](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)“. -If a site administrator disallows members from creating certain types of repositories, members will not be able to create that type of repository even if the visibility setting defaults to that type. For more information, see "[Restricting repository creation in your instance](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)." +Wenn ein Site-Administrator Mitgliedern das Erstellen bestimmter Arten Repositorys verwehrt, werden Mitglieder nicht in der Lage sein, ein Repository dieser Art zu erstellen, selbst wenn die Einstellung zur Sichtbarkeit diesen Typ als Standard vorgibt. Weitere Informationen finden Sie unter „[Repository-Erstellung auf Ihrer Instanz einschränken](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)“. {% tip %} -**Tip:** You can restrict the ability to change repository visibility to site administrators only. For more information, see "[Preventing users from changing a repository's visibility](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-a-repository-s-visibility)." +**Tipp:** Sie können festlegen, dass nur die Websiteadministratoren die Sichtbarkeit des Repositorys ändern können. Weitere Informationen finden Sie unter „[Benutzerbedingte Änderung der Sichtbarkeit eines Repositorys verhindern](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-a-repository-s-visibility)“. {% endtip %} @@ -49,22 +49,21 @@ If a site administrator disallows members from creating certain types of reposit {% data reusables.enterprise-accounts.settings-tab %} {% endif %} {% data reusables.enterprise-accounts.options-tab %} -1. Under "Default repository visibility", use the drop-down menu and select a default visibility. - ![Drop-down menu to choose the default repository visibility for your instance](/assets/images/enterprise/site-admin-settings/default-repository-visibility-settings.png) +1. Verwende unter „Default repository visibility“ (Standardmäßige Sichtbarkeit für Repositorys) das Dropdown-Menü und wähle eine Standardsichtbarkeit. ![Dropdownmenü zum Auswählen der standardmäßigen Repository-Sichtbarkeit für Ihre Instanz](/assets/images/enterprise/site-admin-settings/default-repository-visibility-settings.png) {% data reusables.enterprise_installation.image-urls-viewable-warning %} ### Setting a policy for changing a repository's visibility -When you prevent members from changing repository visibility, only site administrators have the ability to make public repositories private or make private repositories public. +Wenn Sie Mitglieder daran hindern, die Sichtbarkeit des Repositorys zu ändern, können nur Websiteadministratoren öffentliche Repositorys als privat oder private Repositorys als öffentlich festlegen. -If a site administrator has restricted repository creation to organization owners only, then members will not be able to change repository visibility. If a site administrator has restricted member repository creation to private repositories only, then members will only be able to change repositories from public to private. For more information, see "[Setting a policy for repository creation](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)." +Falls ein Websiteadministrator die Möglichkeit der Repository-Erstellung auf Organisationsinhaber beschränkt hat, können Mitglieder die Sichtbarkeit eines Repositorys nicht ändern. Hat ein Websiteadministrator dagegen die Möglichkeit von Mitgliedern auf die Erstellung privater Repositorys beschränkt, können Mitglieder die Sichtbarkeit eines Repositorys von öffentlich auf privat festlegen. For more information, see "[Setting a policy for repository creation](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)." {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.repositories-tab %} -5. Under "Repository visibility change", review the information about changing the setting. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} +5. Überprüfen Sie unter „Repository visibility change“ (Änderung der Repository-Sichtbarkeit) die Informationen zum Ändern der Einstellung. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} {% data reusables.enterprise-accounts.repository-visibility-policy %} @@ -76,13 +75,12 @@ If a site administrator has restricted repository creation to organization owner {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.repositories-tab %} -5. Under "Repository creation", review the information about changing the setting. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} +5. Überprüfen Sie unter „Repository creation“ (Repository-Erstellung) die Informationen zum Ändern der Einstellung. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} {% if currentVersion ver_gt "enterprise-server@2.19" %} {% data reusables.enterprise-accounts.repo-creation-policy %} {% data reusables.enterprise-accounts.repo-creation-types %} {% else %} -6. Under "Repository creation", use the drop-down menu and choose a policy. - ![Drop-down menu with repository creation policies](/assets/images/enterprise/site-admin-settings/repository-creation-drop-down.png) +6. Wählen Sie im Dropdownmenü unter „Repository creation“ (Repository-Erstellung) eine Richtlinie aus. ![Dropdownmenü mit Richtlinien zur Repository-Erstellung](/assets/images/enterprise/site-admin-settings/repository-creation-drop-down.png) {% endif %} ### Setting a policy for repository deletion and transfer @@ -91,20 +89,20 @@ If a site administrator has restricted repository creation to organization owner {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.repositories-tab %} -5. Under "Repository deletion and transfer", review the information about changing the setting. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} +5. Überprüfen Sie unter „Repository deletion and transfer“ (Repository-Löschung und -Übertragung) die Informationen zum Ändern der Einstellung. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} {% data reusables.enterprise-accounts.repository-deletion-policy %} ### Setting a policy for Git push limits -To keep your repository size manageable and prevent performance issues, you can configure a file size limit for repositories on your instance. +Um die Größe Deines Repositorys handhabbar zu halten und Performance-Probleme zu vermeiden, konfiguriere ein Dateigrößenlimit für Repositorys auf Deiner Instanz. -By default, when you enforce repository upload limits, people cannot add or update files larger than 100 MB. +Wenn Du Repository-Uploadlimits erzwingst, können Benutzer standardmäßig keine Dateien hinzufügen oder aktualisieren, die größer als 100 MB sind. {% if currentVersion ver_lt "enterprise-server@2.20" %} {% tip %} -**Note:** Only files larger than {% data variables.large_files.warning_size %} will be checked against the Git push limit. If you need to set a lower push limit, contact {% data variables.contact.contact_ent_support %} for assistance. +**Hinweis:** Nur Dateien, die größer sind als {% data variables.large_files.warning_size %}, werden mit der Git-Push-Begrenzung abgeglichen. Kontaktieren Sie {% data variables.contact.contact_ent_support %}, wenn Sie eine niedrigere Push-Begrenzung festlegen müssen. {% endtip %} {% endif %} @@ -117,14 +115,12 @@ By default, when you enforce repository upload limits, people cannot add or upda {% data reusables.enterprise-accounts.settings-tab %} {% endif %} {% data reusables.enterprise-accounts.options-tab %} -4. Under "Repository upload limit", use the drop-down menu and click a maximum object size. -![Drop-down menu with maximum object size options](/assets/images/enterprise/site-admin-settings/repo-upload-limit-dropdown.png) -5. Optionally, to enforce a maximum upload limit for all repositories on {% data variables.product.product_location_enterprise %}, select **Enforce on all repositories** -![Enforce maximum object size on all repositories option](/assets/images/enterprise/site-admin-settings/all-repo-upload-limit-option.png) +4. Verwenden Sie unter „Repository upload limit“ (Upload-Begrenzung für Repository) das Dropdownmenü, und klicken Sie auf eine maximale Objektgröße.![Dropdownmenü mit Optionen für die maximale Objektgröße](/assets/images/enterprise/site-admin-settings/repo-upload-limit-dropdown.png) +5. Optional kannst Du **Für alle Repositorys erzwingen** auswählen, um ein maximales Upload-Limit für alle Repositorys auf {% data variables.product.product_location_enterprise %} zu erzwingen. ![Option zur zwangsweisen Begrenzung der Objektgröße für alle Repositorys](/assets/images/enterprise/site-admin-settings/all-repo-upload-limit-option.png) ### Configuring the merge conflict editor for pull requests between repositories -Requiring users to resolve merge conflicts locally on their computer can prevent people from inadvertently writing to an upstream repository from a fork. +Indem Sie festlegen, dass Benutzer Mergekonflikte lokal auf ihren Computern auflösen müssen, können Sie verhindern, dass sie über ein Fork versehentlich in ein vorgelagertes Repository schreiben. {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} @@ -134,12 +130,11 @@ Requiring users to resolve merge conflicts locally on their computer can prevent {% data reusables.enterprise-accounts.settings-tab %} {% endif %} {% data reusables.enterprise-accounts.options-tab %} -1. Under "Conflict editor for pull requests between repositories", use the drop-down menu, and click **Disabled**. - ![Drop-down menu with option to disable the merge conflict editor](/assets/images/enterprise/settings/conflict-editor-settings.png) +1. Verwenden Sie unter „Merge Conflict editor for pull requests between repositories“ (Editor für Mergekonflikte für Pull Requests zwischen Repositorys) das Dropdownmenü, und klicken Sie auf **Disabled** (Deaktiviert). ![Dropdownmenü mit der Option zum Deaktivieren des Editors für Mergekonflikte](/assets/images/enterprise/settings/conflict-editor-settings.png) ### Configuring force pushes -Each repository inherits a default force push setting from the settings of the user account or organization to which it belongs. Likewise, each organization and user account inherits a default force push setting from the force push setting for the entire appliance. If you change the force push setting for the appliance, it will change for all repositories owned by any user or organization. +Jedes Repository übernimmt eine standardmäßige Einstellung für erzwungene Push-Vorgänge des Benutzerkontos oder der Organisation, zu dem bzw. zu der es gehört. Entsprechend übernimmt jede Organisation und jedes Benutzerkonto eine standardmäßige Einstellung für erzwungene Push-Vorgänge aus der Einstellung für erzwungene Push-Vorgänge für die gesamte Appliance. Wenn Sie die Einstellung für erzwungene Push-Vorgänge für die Appliance ändern, wird sie für alle Repositorys für jeden Benutzer in der Organisation geändert. #### Blocking all force pushes on your appliance @@ -151,9 +146,8 @@ Each repository inherits a default force push setting from the settings of the u {% data reusables.enterprise-accounts.settings-tab %} {% endif %} {% data reusables.enterprise-accounts.options-tab %} -4. Under "Force pushes", use the drop-down menu, and click **Allow**, **Block** or **Block to the default branch**. -![Force pushes dropdown](/assets/images/enterprise/site-admin-settings/force-pushes-dropdown.png) -5. Optionally, select **Enforce on all repositories**, which will override organization and repository level settings for force pushes. +4. Verwenden Sie unter „Force pushes“ (Erzwungene Push-Vorgänge) das Dropdownmenü, und klicken Sie auf **Allow** (Zulassen), **Block** (Blockieren) oder **Block to the default branch** (Übertragungen an Standardbranch blockieren). ![Dropdownmenü „Force pushes“ (Erzwungene Push-Vorgänge)](/assets/images/enterprise/site-admin-settings/force-pushes-dropdown.png) +5. Wählen Sie optional **Enforce on all repositories** (Auf allen Repositorys erzwungen) aus, wodurch die Einstellungen für erzwungene Push-Vorgänge auf Organisations- und Repository-Ebene überschrieben werden. #### Blocking force pushes to a specific repository @@ -165,14 +159,13 @@ Each repository inherits a default force push setting from the settings of the u {% data reusables.enterprise_site_admin_settings.click-repo %} {% data reusables.enterprise_site_admin_settings.admin-top-tab %} {% data reusables.enterprise_site_admin_settings.admin-tab %} -4. Select **Block** or **Block to the default branch** under **Push and Pull**. - ![Block force pushes](/assets/images/enterprise/site-admin-settings/repo/repo-block-force-pushes.png) +4. Wählen Sie **Block** (Blockieren) oder **Block to the default branch** (Übertragung an Standardbranch blockieren) unter **Push and Pull** (Übertragen und abrufen) aus. ![Erzwungene Push-Vorgänge blockieren](/assets/images/enterprise/site-admin-settings/repo/repo-block-force-pushes.png) -#### Blocking force pushes to repositories owned by a user account or organization +#### Erzwungene Push-Vorgänge an Repositorys blockieren, die einem Benutzerkonto oder einer Organisation gehören -Repositories inherit force push settings from the user account or organization to which they belong. User accounts and organizations in turn inherit their force push settings from the force push settings for the entire appliance. +Repositorys übernehmen die Einstellungen für erzwungene Push-Vorgänge vom Benutzerkonto oder von der Organisation, zu dem bzw. zu der sie gehören. Benutzerkonten und Organisationen übernehmen wiederum die Einstellungen für erzwungene Push-Vorgänge von den Einstellungen für erzwungene Push-Vorgänge der gesamten Appliance. -You can override the default inherited settings by configuring the settings for a user account or organization. +Sie können die standardmäßig übernommenen Einstellungen überschreiben, indem Sie die Einstellungen für ein Benutzerkonto oder für eine Organisation konfigurieren. {% data reusables.enterprise_site_admin_settings.sign-in %} {% data reusables.enterprise_site_admin_settings.access-settings %} @@ -180,12 +173,10 @@ You can override the default inherited settings by configuring the settings for {% data reusables.enterprise_site_admin_settings.click-user-or-org %} {% data reusables.enterprise_site_admin_settings.admin-top-tab %} {% data reusables.enterprise_site_admin_settings.admin-tab %} -5. Under "Repository default settings" in the "Force pushes" section, select - - **Block** to block force pushes to all branches. - - **Block to the default branch** to only block force pushes to the default branch. - ![Block force pushes](/assets/images/enterprise/site-admin-settings/user/user-block-force-pushes.png) -6. Optionally, select **Enforce on all repositories** to override repository-specific settings. Note that this will **not** override an appliance-wide policy. - ![Block force pushes](/assets/images/enterprise/site-admin-settings/user/user-block-all-force-pushes.png) +5. Wählen Sie unter „Repository default settings“ (Repository-Standardeinstellungen) im Abschnitt in the „Force pushes“ (Erzwungene Push-Vorgänge) Folgendes aus: + - **Block** (Blockieren), um alle erzwungenen Push-Vorgänge an alle Branches zu blockieren. + - **Block to the default branch** (Übertragung an den Standardbranch blockieren), damit die an den Standardbranch übertragenen erzwungenen Push-Vorgänge blockiert werden. ![Erzwungene Push-Vorgänge blockieren](/assets/images/enterprise/site-admin-settings/user/user-block-force-pushes.png) +6. Wählen Sie optional **Enforce on all repositories** (Auf allen Repositorys erzwingen) aus, um Repository-spezifische Einstellungen zu überschreiben. Appliance-weite Richtlinien werden dadurch **nicht** überschrieben. ![Erzwungene Push-Vorgänge blockieren](/assets/images/enterprise/site-admin-settings/user/user-block-all-force-pushes.png) ### Configuring anonymous Git read access @@ -193,9 +184,9 @@ You can override the default inherited settings by configuring the settings for If you have [enabled private mode](/enterprise/admin/configuration/enabling-private-mode) on your instance, you can allow repository administrators to enable anonymous Git read access to public repositories. -Enabling anonymous Git read access allows users to bypass authentication for custom tools on your instance. When you or a repository administrator enable this access setting for a repository, unauthenticated Git operations (and anyone with network access to {% data variables.product.prodname_ghe_server %}) will have read access to the repository without authentication. +Enabling anonymous Git read access allows users to bypass authentication for custom tools on your instance. Wenn Sie oder ein Repository-Administrator diese Zugriffseinstellung für ein Repository aktiviert, verfügen nicht authentifizierte Git-Vorgänge (und jeder mit Netzwerkzugriff auf {% data variables.product.prodname_ghe_server %}) über Lesezugriff auf das Repository, ohne dass eine Authentifizierung erforderlich ist. -If necessary, you can prevent repository administrators from changing anonymous Git access settings for repositories on {% data variables.product.product_location_enterprise %} by locking the repository's access settings. After you lock a repository's Git read access setting, only a site administrator can change the setting. +If necessary, you can prevent repository administrators from changing anonymous Git access settings for repositories on {% data variables.product.product_location_enterprise %} by locking the repository's access settings. Nachdem Sie die Einstellung für den Git-Lesezugriff eines Repositorys gesperrt haben, kann nur ein Websiteadministrator die Einstellung ändern. {% data reusables.enterprise_site_admin_settings.list-of-repos-with-anonymous-git-read-access-enabled %} @@ -211,10 +202,8 @@ If necessary, you can prevent repository administrators from changing anonymous {% data reusables.enterprise-accounts.settings-tab %} {% endif %} {% data reusables.enterprise-accounts.options-tab %} -4. Under "Anonymous Git read access", use the drop-down menu, and click **Enabled**. -![Anonymous Git read access drop-down menu showing menu options "Enabled" and "Disabled"](/assets/images/enterprise/site-admin-settings/enable-anonymous-git-read-access.png) -3. Optionally, to prevent repository admins from changing anonymous Git read access settings in all repositories on your instance, select **Prevent repository admins from changing anonymous Git read access**. -![Select checkbox to prevent repository admins from changing anonymous Git read access settings for all repositories on your instance](/assets/images/enterprise/site-admin-settings/globally-lock-repos-from-changing-anonymous-git-read-access.png) +4. Klicken Sie unter „Anonymous Git read access“ (Anonymer Git-Lesezugriff) auf das Dropdownmenü, und klicken Sie auf **Enabled** (Aktiviert). ![Dropdownmenü „Anonymous Git read access“ (Anonymer Git-Lesezugriff) mit den angezeigten Menüoptionen „Enabled“ (Aktiviert) und „Disabled“ (Deaktiviert)](/assets/images/enterprise/site-admin-settings/enable-anonymous-git-read-access.png) +3. Aktivieren Sie optional **Prevent repository admins from changing anonymous Git read access** (Repository-Administratoren daran hindern, den anonymen Git-Lesezugriff zu ändern), um Repository-Administratoren daran zu hindern, die Einstellungen für den anonymen Git-Lesezugriff in allen Repositorys auf Ihrer Instanz zu ändern. ![Durch die Aktivierung des Kontrollkästchens werden Repository-Administratoren daran gehindert, die Einstellungen für den anonymen Git-Lesezugriff für alle Repositorys auf Ihrer Instanz zu ändern](/assets/images/enterprise/site-admin-settings/globally-lock-repos-from-changing-anonymous-git-read-access.png) #### Setting anonymous Git read access for a specific repository @@ -223,11 +212,7 @@ If necessary, you can prevent repository administrators from changing anonymous {% data reusables.enterprise_site_admin_settings.click-repo %} {% data reusables.enterprise_site_admin_settings.admin-top-tab %} {% data reusables.enterprise_site_admin_settings.admin-tab %} -6. Under "Danger Zone", next to "Enable Anonymous Git read access", click **Enable**. -!["Enabled" button under "Enable anonymous Git read access" in danger zone of a repository's site admin settings ](/assets/images/enterprise/site-admin-settings/site-admin-enable-anonymous-git-read-access.png) -7. Review the changes. To confirm, click **Yes, enable anonymous Git read access.** -![Confirm anonymous Git read access setting in pop-up window](/assets/images/enterprise/site-admin-settings/confirm-anonymous-git-read-access-for-specific-repo-as-site-admin.png) -8. Optionally, to prevent repository admins from changing this setting for this repository, select **Prevent repository admins from changing anonymous Git read access**. -![Select checkbox to prevent repository admins from changing anonymous Git read access for this repository](/assets/images/enterprise/site-admin-settings/lock_anonymous_git_access_for_specific_repo.png) - +6. Klicken Sie unter „Danger Zone“ (Gefahrenzone) neben „Enable Anonymous Git read access“ (Anonymen Git-Lesezugriff aktivieren) auf **Enable** (Aktivieren). ![Schaltfläche „Enabled“ (Aktiviert) unter „Enable anonymous Git read access“ (Anonymen Git-Lesezugriff aktivieren) in der „Danger Zone“ (Gefahrenzone) der Websiteadministratoreinstellungen eines Repositorys ](/assets/images/enterprise/site-admin-settings/site-admin-enable-anonymous-git-read-access.png) +7. Überprüfen Sie die Änderungen. Klicken Sie zur Bestätigung auf **Yes, enable anonymous Git read access** (Ja, anonymen Git-Lesezugriff aktivieren). ![Bestätigung der Einstellung für anonymen Git-Lesezugriff in einem Popup-Fenster](/assets/images/enterprise/site-admin-settings/confirm-anonymous-git-read-access-for-specific-repo-as-site-admin.png) +8. Aktivieren Sie optional **Prevent repository admins from changing anonymous Git read access** (Repository-Administratoren daran hindern, den anonymen Git-Lesezugriff zu ändern), um Repository-Administratoren daran zu hindern, diese Einstellung für dieses Repository zu ändern. ![Durch die Aktivierung des Kontrollkästchens werden Repository-Administratoren daran gehindert, den anonymen Git-Lesezugriff für dieses Repository zu ändern](/assets/images/enterprise/site-admin-settings/lock_anonymous_git_access_for_specific_repo.png) diff --git a/translations/de-DE/content/admin/user-management/audit-logging.md b/translations/de-DE/content/admin/user-management/audit-logging.md index 7b819593219a..03429c738270 100644 --- a/translations/de-DE/content/admin/user-management/audit-logging.md +++ b/translations/de-DE/content/admin/user-management/audit-logging.md @@ -34,5 +34,5 @@ Oct 26 01:42:08 github-ent github_audit: {:created_at=>1351215728326, :actor_ip= Dieses Beispiel zeigt, dass Commits per Push-Vorgang an ein Repository übertragen wurden. ``` -Oct 26 02:19:31 github-ent github_audit: { "pid":22860, "ppid":22859, "program":"receive-pack", "git_dir":"/data/repositories/some-user/some-repository.git", "hostname":"github-ent", "pusher":"some-user", "real_ip":"10.0.0.51", "user_agent":"git/1.7.10.4", "repo_id":1, "repo_name":"some-user/some-repository", "transaction_id":"b031b7dc7043c87323a75f7a92092ef1456e5fbaef995c68", "frontend_ppid":1, "repo_public":true, "user_name":"some-user", "user_login":"some-user", "frontend_pid":18238, "frontend":"github-ent", "user_email":"some-user@github.example.com", "user_id":2, "pgroup":"github-ent_22860", "status":"post_receive_hook", "features":" report-status side-band-64k", "received_objects":3, "receive_pack_size":243, "non_fast_forward":false, "current_ref":"refs/heads/master" } +Oct 26 02:19:31 github-ent github_audit: { "pid":22860, "ppid":22859, "program":"receive-pack", "git_dir":"/data/repositories/some-user/some-repository.git", "hostname":"github-ent", "pusher":"some-user", "real_ip":"10.0.0.51", "user_agent":"git/1.7.10.4", "repo_id":1, "repo_name":"some-user/some-repository", "transaction_id":"b031b7dc7043c87323a75f7a92092ef1456e5fbaef995c68", "frontend_ppid":1, "repo_public":true, "user_name":"some-user", "user_login":"some-user", "frontend_pid":18238, "frontend":"github-ent", "user_email":"some-user@github.example.com", "user_id":2, "pgroup":"github-ent_22860", "status":"post_receive_hook", "features":" report-status side-band-64k", "received_objects":3, "receive_pack_size":243, "non_fast_forward":false, "current_ref":"refs/heads/main" } ``` diff --git a/translations/de-DE/content/admin/user-management/audited-actions.md b/translations/de-DE/content/admin/user-management/audited-actions.md index e316938a5137..9161a529c73c 100644 --- a/translations/de-DE/content/admin/user-management/audited-actions.md +++ b/translations/de-DE/content/admin/user-management/audited-actions.md @@ -35,8 +35,8 @@ versions: #### Instanzkonfigurationseinstellungen -| Name | Beschreibung | -| -------------------------------------------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Name | Beschreibung | +| -------------------------------------------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `business.update_member_repository_creation_permission` | Ein Websiteadministrator schränkt die Repository-Erstellungen in Organisationen auf der Instanz ein. Weitere Informationen finden Sie unter „[Repository-Erstellung auf Ihrer Instanz einschränken](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)“. | | `business.clear_members_can_create_repos` | Ein Websiteadministrator löscht eine Einschränkung für die Repository-Erstellung in Organisationen auf der Instanz. Weitere Informationen finden Sie unter „[Repository-Erstellung auf Ihrer Instanz einschränken](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)“. | | `enterprise.config.lock_anonymous_git_access` | Ein Websiteadministrator sperrt den anonymen Git-Lesezugriff, um Repository-Administratoren daran zu hindern, die vorhandenen Einstellungen für den anonymen Git-Lesezugriff für Repositorys auf der Instanz zu ändern. Weitere Informationen finden Sie unter „[Änderung des anonymen Git-Lesezugriffs durch Benutzer verhindern](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)“. | @@ -44,19 +44,19 @@ versions: #### Issues und Pull Requests -| Name | Beschreibung | -| ------------------------------------:| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `issue.update` | Der Text eines Issues (erster Kommentar) wurde geändert. | -| `issue_comment.update` | Ein Kommentar zu einem Issue (nicht der ursprüngliche) wurde geändert. | -| `pull_request_review_comment.delete` | A comment on a pull request was deleted. | +| Name | Beschreibung | +| ------------------------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `issue.update` | Der Text eines Issues (erster Kommentar) wurde geändert. | +| `issue_comment.update` | Ein Kommentar zu einem Issue (nicht der ursprüngliche) wurde geändert. | +| `pull_request_review_comment.delete` | A comment on a pull request was deleted. | | `issue.destroy` | Ein Issue wurde aus dem Repository gelöscht. Weitere Informationen finden Sie unter „[Issue löschen](/enterprise/{{ currentVersion }}/user/articles/deleting-an-issue)“. | #### Organisationen -| Name | Beschreibung | -| ------------------:| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `org.async_delete` | Ein Benutzer hat einen Hintergrundauftrag zum Löschen einer Organisation initiiert. | -| `org.delete` | Eine Organisation wurde durch einen von einem Benutzer initiierten Hintergrundauftrag gelöscht. | +| Name | Beschreibung | +| ------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `org.async_delete` | Ein Benutzer hat einen Hintergrundauftrag zum Löschen einer Organisation initiiert. | +| `org.delete` | Eine Organisation wurde durch einen von einem Benutzer initiierten Hintergrundauftrag gelöscht. | | `org.transform` | Ein Benutzerkonto wurde in eine Organisation umgewandelt. Weitere Informationen finden Sie unter „[Benutzer in eine Organisation umwandeln](/enterprise/{{ currentVersion}}/user/articles/converting-a-user-into-an-organization/)“. | #### geschützte Branches @@ -76,18 +76,18 @@ versions: #### Repositorys -| Name | Beschreibung | -| ------------------------------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `repo.access` | Ein privates Repository wurde als öffentlich festgelegt, oder ein öffentliches Repository wurde als privat festgelegt. | +| Name | Beschreibung | +| ------------------------------------------:| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `repo.access` | Ein privates Repository wurde als öffentlich festgelegt, oder ein öffentliches Repository wurde als privat festgelegt. | | `repo.archive` | Ein Repository wurde archiviert. Weitere Informationen finden Sie unter „[Repositorys archivieren und deren Archivierung aufheben](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/)“. | -| `repo.add_member` | Einem Repository wurde ein Mitarbeiter hinzugefügt. | +| `repo.add_member` | Einem Repository wurde ein Mitarbeiter hinzugefügt. | | `repo.config` | Ein Websiteadministrator hat erzwungene Push-Vorgänge blockiert. Weitere Informationen finden Sie unter „[Erzwungene Push-Vorgänge an ein Repository blockieren](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository/)“. | -| `repo.create` | Ein Repository wurde erstellt. | -| `repo.destroy` | Ein Repository wurde gelöscht. | -| `repo.remove_member` | Ein Mitarbeiter wurde aus einem Repository entfernt. | -| `repo.rename` | Ein Repository wurde umbenannt. | -| `repo.transfer` | Ein Benutzer hat eine Anfrage akzeptiert, ein übertragenes Repository zu empfangen. | -| `repo.transfer_start` | Ein Benutzer hat eine Anfrage gesendet, ein Repository an einen anderen Benutzer oder an eine andere Organisation zu übertragen. | +| `repo.create` | Ein Repository wurde erstellt. | +| `repo.destroy` | Ein Repository wurde gelöscht. | +| `repo.remove_member` | Ein Mitarbeiter wurde aus einem Repository entfernt. | +| `repo.rename` | Ein Repository wurde umbenannt. | +| `repo.transfer` | Ein Benutzer hat eine Anfrage akzeptiert, ein übertragenes Repository zu empfangen. | +| `repo.transfer_start` | Ein Benutzer hat eine Anfrage gesendet, ein Repository an einen anderen Benutzer oder an eine andere Organisation zu übertragen. | | `repo.unarchive` | Die Archivierung eines Repositorys wurde aufgehoben. Weitere Informationen finden Sie unter „[Repositorys archivieren und deren Archivierung aufheben](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/)“. | | `repo.config.disable_anonymous_git_access` | Der anonyme Git-Lesezugriff ist für ein öffentliches Repository deaktiviert. Weitere Informationen finden Sie unter „[Anonymen Git-Lesezugriff für ein Repository aktivieren](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)“. | | `repo.config.enable_anonymous_git_access` | Der anonyme Git-Lesezugriff ist für ein öffentliches Repository aktiviert. Weitere Informationen finden Sie unter „[Anonymen Git-Lesezugriff für ein Repository aktivieren](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)“. | @@ -100,7 +100,7 @@ versions: | --------------------:| -------------------------------------------------------------------------------------------------------------------------------------- | | `staff.disable_repo` | Ein Websiteadministrator hat den Zugriff auf ein Repository und auf alle zugehörigen Forks deaktiviert. | | `staff.enable_repo` | Ein Websiteadministrator hat den Zugriff auf ein Repository und auf alle zugehörigen Forks wieder aktiviert. | -| `staff.fake_login` | Ein Websiteadministrator hat sich als ein anderer Benutzer bei {% data variables.product.prodname_enterprise %} angemeldet. | +| `staff.fake_login` | Ein Websiteadministrator hat sich als ein anderer Benutzer bei {% data variables.product.prodname_enterprise %} angemeldet. | | `staff.repo_unlock` | Ein Websiteadministrator hat eines der privaten Repositorys eines Benutzers entsperrt (temporär vollständigen Zugriff darauf erlangt). | | `staff.unlock` | Ein Websiteadministrator hat alle der privaten Repositorys eines Benutzers entsperrt (temporär vollständigen Zugriff darauf erlangt). | diff --git a/translations/de-DE/content/admin/user-management/configuring-email-for-notifications.md b/translations/de-DE/content/admin/user-management/configuring-email-for-notifications.md index b2cd4e0d631b..0664b16e0c67 100644 --- a/translations/de-DE/content/admin/user-management/configuring-email-for-notifications.md +++ b/translations/de-DE/content/admin/user-management/configuring-email-for-notifications.md @@ -44,7 +44,7 @@ Wenn Sie E-Mail-Antworten auf Benachrichtigungen zulassen möchten, müssen Sie 1. Stellen Sie sicher, dass Port 25 auf der Instanz für Ihren SMTP-Server erreichbar ist. 2. Erstellen Sie einen Datensatz, der auf `reply.[hostname]` verweist. In Abhängigkeit Ihres DNS-Providers und Ihrer Instanz-Host-Konfiguration können Sie ggf. stattdessen einen einzelnen A-Datensatz erstellen, der auf `*.[hostname]` verweist. 3. Erstellen Sie einen MX-Datensatz, der auf `reply.[hostname]` verweist, sodass an diese Domain gesendete E-Mails zur Instanz weitergeleitet werden. -4. Erstellen Sie einen MX-Datensatz, wodurch `noreply.[hostname]` auf `[hostname]` verweist, damit an die in Benachrichtigungs-E-Mails enthaltene `cc`-Adresse gesendete Antworten an die Instanz weitergeleitet werden. Weitere Informationen findest Du unter {% if currentVersion ver_gt "enterprise-server@2.20" %}„[Benachrichtigungen konfigurieren](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications){% else %}„[Informationen zu E-Mail-Benachrichtigungen](/github/receiving-notifications-about-activity-on-github/about-email-notifications){% endif %}“. +4. Erstellen Sie einen MX-Datensatz, wodurch `noreply.[hostname]` auf `[hostname]` verweist, damit an die in Benachrichtigungs-E-Mails enthaltene `cc`-Adresse gesendete Antworten an die Instanz weitergeleitet werden. For more information, see {% if currentVersion ver_gt "enterprise-server@2.20" %}"[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications){% else %}"[About email notifications](/github/receiving-notifications-about-activity-on-github/about-email-notifications){% endif %}." In Ihrer DNS-Konfigurationseinrichtung können Sie nun testen, ob die Einrichtung funktioniert. diff --git a/translations/de-DE/content/admin/user-management/configuring-visibility-for-organization-membership.md b/translations/de-DE/content/admin/user-management/configuring-visibility-for-organization-membership.md index 7c1ad40811c2..b473de048cfa 100644 --- a/translations/de-DE/content/admin/user-management/configuring-visibility-for-organization-membership.md +++ b/translations/de-DE/content/admin/user-management/configuring-visibility-for-organization-membership.md @@ -1,6 +1,6 @@ --- title: Sichtbarkeit für die Organisationsmitgliedschaft konfigurieren -intro: 'Sie können die Sichtbarkeit für neue Organisationsmitglieder auf Ihrer gesamten Instanz auf öffentlich oder auf privat festlegen. Darüber hinaus können Sie Mitglieder daran hindern, die für sie standardmäßig festgelegte Sichtbarkeit zu ändern.' +intro: Sie können die Sichtbarkeit für neue Organisationsmitglieder auf Ihrer gesamten Instanz auf öffentlich oder auf privat festlegen. Darüber hinaus können Sie Mitglieder daran hindern, die für sie standardmäßig festgelegte Sichtbarkeit zu ändern. redirect_from: - /enterprise/admin/user-management/configuring-visibility-for-organization-membership versions: diff --git a/translations/de-DE/content/admin/user-management/creating-teams.md b/translations/de-DE/content/admin/user-management/creating-teams.md index 489d38d53c85..b16f3feaabf9 100644 --- a/translations/de-DE/content/admin/user-management/creating-teams.md +++ b/translations/de-DE/content/admin/user-management/creating-teams.md @@ -28,7 +28,7 @@ Eine umsichtige Kombination von Teams ist ein wirksames Mittel, um den Zugriff a ### Teams mit aktivierter LDAP-Synchronisierung erstellen -Instanzen, die LDAP für die Benutzerauthentifizierung verwenden, können die LDAP-Synchronisierung zum Verwalten der Mitglieder eines Teams verwenden. Wenn Sie den **Distinguished Name** (DN) der Gruppe im Feld **LDAP group** (LDAP-Gruppe) festlegen, wird einer LDAP-Gruppe auf Ihrem LDAP-Server ein Team zugeordnet. Wenn Sie die LDAP-Synchronisierung zum Verwalten der Mitglieder eines Teams verwenden, können Sie Ihr Team in {% data variables.product.product_location_enterprise %} nicht verwalten. Das zugeordnete Team synchronisiert seine Mitglieder im Hintergrund und regelmäßig in dem Intervall, das bei aktivierter LDAP-Synchronisierung konfiguriert wurde. Weitere Informationen finden Sie unter „[LDAP-Synchronisierung aktivieren](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)“. +Instanzen, die LDAP für die Benutzerauthentifizierung verwenden, können die LDAP-Synchronisierung zum Verwalten der Mitglieder eines Teams verwenden. Wenn Sie den **Distinguished Name** (DN) der Gruppe im Feld **LDAP group** (LDAP-Gruppe) festlegen, wird einer LDAP-Gruppe auf Ihrem LDAP-Server ein Team zugeordnet. Wenn Sie die LDAP-Synchronisierung zum Verwalten der Mitglieder eines Teams verwenden, können Sie Ihr Team in {% data variables.product.product_location_enterprise %} nicht verwalten. Das zugeordnete Team synchronisiert seine Mitglieder im Hintergrund und regelmäßig in dem Intervall, das bei aktivierter LDAP-Synchronisierung konfiguriert wurde. Weitere Informationen finden Sie unter „[LDAP-Synchronisierung aktivieren](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)“. {% data reusables.enterprise_user_management.ldap-sync-nested-teams %} @@ -36,17 +36,19 @@ Instanzen, die LDAP für die Benutzerauthentifizierung verwenden, können die LD **Hinweise:** - Die LDAP-Synchronisierung verwaltet nur die Mitgliederliste des Teams. Sie müssen die Repositorys und Berechtigungen des Teams auf {% data variables.product.prodname_ghe_server %} verwalten. -- Wenn eine LDAP-Gruppenzuordnung zu einem DN entfernt wird, beispielsweise wenn die LDAP-Gruppe gelöscht wird, dann wird jedes Mitglied aus dem synchronisierten {% data variables.product.prodname_ghe_server %}-Team entfernt. Um dies zu beheben, ordnen Sie das Team einem neuen DN zu, fügen Sie die Teammitglieder erneut hinzu, und [synchronisieren Sie die Zuordnung manuell](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap/#manually-syncing-ldap-accounts). +- Wenn eine LDAP-Gruppenzuordnung zu einem DN entfernt wird, beispielsweise wenn die LDAP-Gruppe gelöscht wird, dann wird jedes Mitglied aus dem synchronisierten {% data variables.product.prodname_ghe_server %}-Team entfernt. Um dies zu beheben, ordnen Sie das Team einem neuen DN zu, fügen Sie die Teammitglieder erneut hinzu, und [synchronisieren Sie die Zuordnung manuell](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap/#manually-syncing-ldap-accounts). - Falls bei aktivierter LDAP-Synchronisierung eine Person aus einem Repository entfernt wird, verliert diese den Zugriff, ihre Forks werden jedoch nicht gelöscht. Wenn die Person innerhalb von drei Monaten zu einem Team mit Zugriff auf das ursprüngliche Organisations-Repository hinzugefügt wird, wird ihr Zugriff auf die Forks bei der nächsten Synchronisierung automatisch wiederhergestellt. {% endwarning %} -1. Stellen Sie sicher, dass die [LDAP-Synchronisierung aktiviert ist](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#enabling-ldap-sync). +1. Stellen Sie sicher, dass die [LDAP-Synchronisierung aktiviert ist](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#enabling-ldap-sync). {% data reusables.profile.enterprise_access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.new_team %} {% data reusables.organizations.team_name %} -6. Suchen Sie nach dem DN einer LDAP-Gruppe, um diesem das Team zuzuordnen. Falls Sie den DN nicht kennen, geben Sie den Namen der LDAP-Gruppe ein. {% data variables.product.prodname_ghe_server %} sucht nach Übereinstimmungen und vervollständigt diese automatisch. ![Zuordnung zum LDAP-Gruppen-DN](/assets/images/enterprise/orgs-and-teams/ldap-group-mapping.png) +6. Suchen Sie nach dem DN einer LDAP-Gruppe, um diesem das Team zuzuordnen. Falls Sie den DN nicht kennen, geben Sie den Namen der LDAP-Gruppe ein. +{% data variables.product.prodname_ghe_server %} sucht nach Übereinstimmungen und vervollständigt diese automatisch. +![Zuordnung zum LDAP-Gruppen-DN](/assets/images/enterprise/orgs-and-teams/ldap-group-mapping.png) {% data reusables.organizations.team_description %} {% data reusables.organizations.team_visibility %} {% data reusables.organizations.create-team-choose-parent %} diff --git a/translations/de-DE/content/admin/user-management/customizing-user-messages-on-your-instance.md b/translations/de-DE/content/admin/user-management/customizing-user-messages-on-your-instance.md index a8ed9543ec8c..09c889a178da 100644 --- a/translations/de-DE/content/admin/user-management/customizing-user-messages-on-your-instance.md +++ b/translations/de-DE/content/admin/user-management/customizing-user-messages-on-your-instance.md @@ -3,7 +3,7 @@ title: Benutzermeldungen auf Ihrer Instanz anpassen redirect_from: - /enterprise/admin/user-management/creating-a-custom-sign-in-message/ - /enterprise/admin/user-management/customizing-user-messages-on-your-instance -intro: 'Sie können {% if currentVersion ver_gt "enterprise-server@2.15" %}benutzerdefinierte Meldungen erstellen, die Benutzern auf An- und Abmeldeseiten angezeigt werden{% else %}eine benutzerdefinierte Meldung erstellen, die Benutzern auf der Anmeldeseite angezeigt wird{% endif %}.' +intro: 'You can create custom messages that users will see on the sign in and sign out pages{% if currentVersion ver_gt "enterprise-server@2.21" %} or in an announcement banner at the top of every page{% endif %}.' versions: enterprise-server: '*' --- diff --git a/translations/de-DE/content/admin/user-management/managing-dormant-users.md b/translations/de-DE/content/admin/user-management/managing-dormant-users.md index b44f1edda511..6e8c34291fbb 100644 --- a/translations/de-DE/content/admin/user-management/managing-dormant-users.md +++ b/translations/de-DE/content/admin/user-management/managing-dormant-users.md @@ -1,43 +1,38 @@ --- -title: Managing dormant users +title: Inaktive Benutzer verwalten redirect_from: - /enterprise/admin/articles/dormant-users/ - /enterprise/admin/articles/viewing-dormant-users/ - /enterprise/admin/articles/determining-whether-a-user-account-is-dormant/ - /enterprise/admin/user-management/managing-dormant-users - - /enterprise/admin/user-management/managing-dormant-users -intro: A user account is considered to be dormant if it has not been active for at least a month. You may choose to suspend dormant users to free up user licenses. +intro: Ein Benutzerkonto wird als inaktiv angesehen, wenn es mindestens einen Monat lang nicht aktiv war. You may choose to suspend dormant users to free up user licenses. versions: enterprise-server: '*' --- -"Activity" includes, but is not limited to: -- Signing in to {% data variables.product.prodname_ghe_server %}. -- Commenting on issues and pull requests. -- Creating, deleting, watching, and starring repositories. +Zu den „Aktivitäten“ zählen u. a. +- die Anmeldung bei {% data variables.product.prodname_ghe_server %}, +- das Kommentieren von Issues und Pull Requests, +- das Erstellen, Löschen, Beobachten und Darstellen von Repositorys, - Pushing commits.{% if currentVersion ver_gt "enterprise-server@2.21" %} - Accessing resources by using a personal access token or SSH key.{% endif %} -### Viewing dormant users +### Inaktive Benutzer anzeigen -You can view a list of all dormant users who have not been suspended and who are not site administrators. +Sie können eine Liste sämtlicher inaktiver Benutzer anzeigen, die nicht gesperrt wurden und keine Websiteadministratoren sind. {% data reusables.enterprise_site_admin_settings.access-settings %} -3. In the left sidebar, click **Dormant users**. -![Dormant users tab](/assets/images/enterprise/site-admin-settings/dormant-users-tab.png) -4. To suspend all the dormant users in this list, at the top of the page, click **Suspend all**. -![Suspend all button](/assets/images/enterprise/site-admin-settings/suspend-all.png) +3. Klicken Sie auf der linken Seitenleiste auf **Dormant users** (Inaktive Benutzer). ![Registerkarte „Dormant users“ (Inaktive Benutzer)](/assets/images/enterprise/site-admin-settings/dormant-users-tab.png) +4. Um alle inaktiven Benutzer in dieser Liste zu sperren, klicken Sie im oberen Bereich der Seite auf **Suspend all** (Alle sperren). ![Schaltfläche „Suspend all“ (Alle sperren)](/assets/images/enterprise/site-admin-settings/suspend-all.png) -### Determining whether a user account is dormant +### Bestimmen, ob ein Benutzerkonto inaktiv ist {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.search-user %} {% data reusables.enterprise_site_admin_settings.click-user %} -5. In the **User info** section, a red dot with the word "Dormant" indicates the user account is dormant, and a green dot with the word "Active" indicates the user account is active. -![Dormant user account](/assets/images/enterprise/stafftools/dormant-user.png) -![Active user account](/assets/images/enterprise/stafftools/active-user.png) +5. Im Abschnitt **User info** (Benutzerinformationen) gibt ein roter Punkt mit dem Wort „Dormant“ (Inaktiv) an, dass das Benutzerkonto inaktiv ist. Demgegenüber gibt ein grüner Punkt mit dem Wort „Active“ (Aktiv) an, dass das Benutzerkonto aktiv ist. ![Inaktives Benutzerkonto](/assets/images/enterprise/stafftools/dormant-user.png) ![Aktives Benutzerkonto](/assets/images/enterprise/stafftools/active-user.png) -### Configuring the dormancy threshold +### Inaktivitätsschwelle konfigurieren {% data reusables.enterprise_site_admin_settings.dormancy-threshold %} @@ -49,5 +44,4 @@ You can view a list of all dormant users who have not been suspended and who are {% data reusables.enterprise-accounts.settings-tab %} {% endif %} {% data reusables.enterprise-accounts.options-tab %} -4. Under "Dormancy threshold", use the drop-down menu, and click the desired dormancy threshold. -![The Dormancy threshold drop-down menu](/assets/images/enterprise/site-admin-settings/dormancy-threshold-menu.png) +4. Verwenden Sie unter „Dormancy threshold“ (Inaktivitätsschwelle) das Dropdownmenü, und klicken Sie auf die gewünschte Inaktivitätsschwelle.![Dropdownmenü „Dormancy threshold“ (Inaktivitätsschwelle)](/assets/images/enterprise/site-admin-settings/dormancy-threshold-menu.png) diff --git a/translations/de-DE/content/admin/user-management/monitoring-activity-in-your-enterprise.md b/translations/de-DE/content/admin/user-management/monitoring-activity-in-your-enterprise.md index 7f3c2b749df5..991fef7abca5 100644 --- a/translations/de-DE/content/admin/user-management/monitoring-activity-in-your-enterprise.md +++ b/translations/de-DE/content/admin/user-management/monitoring-activity-in-your-enterprise.md @@ -4,7 +4,6 @@ mapTopic: true redirect_from: - /enterprise/admin/installation/monitoring-activity-on-your-github-enterprise-server-instance - /enterprise/admin/user-management/monitoring-activity-in-your-enterprise - - /enterprise/admin/user-management/monitoring-activity-in-your-enterprise versions: enterprise-server: '*' --- diff --git a/translations/de-DE/content/admin/user-management/promoting-or-demoting-a-site-administrator.md b/translations/de-DE/content/admin/user-management/promoting-or-demoting-a-site-administrator.md index 98ca41ed9fff..f5533dc0de47 100644 --- a/translations/de-DE/content/admin/user-management/promoting-or-demoting-a-site-administrator.md +++ b/translations/de-DE/content/admin/user-management/promoting-or-demoting-a-site-administrator.md @@ -4,14 +4,14 @@ redirect_from: - /enterprise/admin/articles/promoting-a-site-administrator/ - /enterprise/admin/articles/demoting-a-site-administrator/ - /enterprise/admin/user-management/promoting-or-demoting-a-site-administrator -intro: Websiteadministratoren können normale Benutzerkonten auf einen Websiteadministrator hochstufen und andere Websiteadministratoren auf normale Benutzer zurückstufen. +intro: 'Websiteadministratoren können normale Benutzerkonten auf einen Websiteadministrator hochstufen und andere Websiteadministratoren auf normale Benutzer zurückstufen.' versions: enterprise-server: '*' --- {% tip %} -**Hinweis:** Wenn die [LDAP-Synchronisierung aktiviert ist](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#enabling-ldap-sync) und das Attribut `Administrators group` festgelegt ist, wenn [der LDAP-Zugriff für Benutzer konfiguriert wird](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#configuring-ldap-with-your-github-enterprise-server-instance), besitzen diese Benutzer automatisch Websiteadministratorzugriff auf Ihre Instanz. In diesem Fall ist es nicht möglich, Benutzer mit den folgenden Schritten manuell hochzustufen. Sie müssen sie zur Gruppe mit den LDAP-Administratoren hinzufügen. +**Hinweis:** Wenn die [LDAP-Synchronisierung aktiviert ist](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#enabling-ldap-sync) und das Attribut `Administrators group` festgelegt ist, wenn [der LDAP-Zugriff für Benutzer konfiguriert wird](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#configuring-ldap-with-your-github-enterprise-server-instance), besitzen diese Benutzer automatisch Websiteadministratorzugriff auf Ihre Instanz. In diesem Fall ist es nicht möglich, Benutzer mit den folgenden Schritten manuell hochzustufen. Sie müssen sie zur Gruppe mit den LDAP-Administratoren hinzufügen. {% endtip %} diff --git a/translations/de-DE/content/admin/user-management/rebuilding-contributions-data.md b/translations/de-DE/content/admin/user-management/rebuilding-contributions-data.md index b135de72d7cf..b5bb632742bb 100644 --- a/translations/de-DE/content/admin/user-management/rebuilding-contributions-data.md +++ b/translations/de-DE/content/admin/user-management/rebuilding-contributions-data.md @@ -1,6 +1,6 @@ --- title: Beitragsdaten erneut erstellen -intro: 'Es ist ggf. erforderlich, Beitragsdaten neu zu erstellen, um vorhandene Commits mit einem Benutzerkonto zu verknüpfen.' +intro: Es ist ggf. erforderlich, Beitragsdaten neu zu erstellen, um vorhandene Commits mit einem Benutzerkonto zu verknüpfen. redirect_from: - /enterprise/admin/articles/rebuilding-contributions-data/ - /enterprise/admin/user-management/rebuilding-contributions-data @@ -15,4 +15,5 @@ Wenn ein Commit per Push-Vorgang an {% data variables.product.prodname_enterpris 3. Klicken Sie links auf der Seite auf **Admin** (Administrator). ![Registerkarte „Admin“ (Administrator)](/assets/images/enterprise/site-admin-settings/admin-tab.png) 4. Klicken Sie unter **Contributions data** (Beitragsdaten) auf **Rebuild** (Neu erstellen). ![Schaltfläche „Rebuild“ (Neu erstellen)](/assets/images/enterprise/site-admin-settings/rebuild-button.png) -{% data variables.product.prodname_enterprise %} startet nun Hintergrundaufträge, um Commits mit dem Konto dieses Benutzers neu zu verknüpfen. ![In die Warteschlange versetzte Neuerstellungsaufträge](/assets/images/enterprise/site-admin-settings/rebuild-jobs.png) +{% data variables.product.prodname_enterprise %} startet nun Hintergrundaufträge, um Commits mit dem Konto dieses Benutzers neu zu verknüpfen. + ![In die Warteschlange versetzte Neuerstellungsaufträge](/assets/images/enterprise/site-admin-settings/rebuild-jobs.png) diff --git a/translations/de-DE/content/admin/user-management/searching-the-audit-log.md b/translations/de-DE/content/admin/user-management/searching-the-audit-log.md index 258df80295c0..9dc5718cab46 100644 --- a/translations/de-DE/content/admin/user-management/searching-the-audit-log.md +++ b/translations/de-DE/content/admin/user-management/searching-the-audit-log.md @@ -13,22 +13,22 @@ versions: Erstellen Sie eine Suchabfrage aus mindestens einem Schlüsselwertpaar, das durch die logischen Operatoren AND/OR getrennt ist. -| Schlüssel | Wert | -| --------------:| ------------------------------------------------------------------------------------------------------- | -| `actor_id` | ID des Benutzerkontos, das die Aktion initiiert hat | -| `actor` | Name des Benutzerkontos, der die Aktion initiiert hat | -| `oauth_app_id` | ID der mit der Aktion verknüpften OAuth-Anwendung | +| Schlüssel | Wert | +| --------------:| --------------------------------------------------------------------------------------------------------- | +| `actor_id` | ID des Benutzerkontos, das die Aktion initiiert hat | +| `actor` | Name des Benutzerkontos, der die Aktion initiiert hat | +| `oauth_app_id` | ID der mit der Aktion verknüpften OAuth-Anwendung | | `action` | Name der [überwachten Aktion](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions) | -| `user_id` | ID des von der Aktion betroffenen Benutzers | -| `Benutzer` | Name des von der Aktion betroffenen Benutzers | -| `repo_id` | ID des von der Aktion betroffenen Repositorys (sofern zutreffend) | -| `repo` | Name des von der Aktion betroffenen Repositorys (sofern zutreffend) | -| `actor_ip` | IP-Adresse, über welche die Aktion initiiert wurde | -| `created_at` | Zeitpunkt, an dem die Aktion aufgetreten ist | -| `from` | Ansicht, von wem die Aktion initiiert wurde | -| `note` | Verschiedene ereignisspezifische Informationen (im Nur-Text- oder JSON-Format) | -| `org` | Name der von der Aktion betroffenen Organisation (sofern zutreffend) | -| `org_id` | ID der von der Aktion betroffenen Organisation (sofern zutreffend) | +| `user_id` | ID des von der Aktion betroffenen Benutzers | +| `Benutzer` | Name des von der Aktion betroffenen Benutzers | +| `repo_id` | ID des von der Aktion betroffenen Repositorys (sofern zutreffend) | +| `repo` | Name des von der Aktion betroffenen Repositorys (sofern zutreffend) | +| `actor_ip` | IP-Adresse, über welche die Aktion initiiert wurde | +| `created_at` | Zeitpunkt, an dem die Aktion aufgetreten ist | +| `from` | Ansicht, von wem die Aktion initiiert wurde | +| `note` | Verschiedene ereignisspezifische Informationen (im Nur-Text- oder JSON-Format) | +| `org` | Name der von der Aktion betroffenen Organisation (sofern zutreffend) | +| `org_id` | ID der von der Aktion betroffenen Organisation (sofern zutreffend) | So können Sie beispielsweise alle Aktionen anzeigen, die sich seit Anfang 2017 auf das Repository `octocat/Spoon-Knife` ausgewirkt haben: diff --git a/translations/de-DE/content/admin/user-management/suspending-and-unsuspending-users.md b/translations/de-DE/content/admin/user-management/suspending-and-unsuspending-users.md index 5226a6e4de49..129276e2350e 100644 --- a/translations/de-DE/content/admin/user-management/suspending-and-unsuspending-users.md +++ b/translations/de-DE/content/admin/user-management/suspending-and-unsuspending-users.md @@ -27,7 +27,7 @@ Vor dem Sperren von Websiteadministratoren müssen Sie diese auf gewöhnliche Be {% tip %} -**Hinweis:** Bei [aktivierter LDAP-Synchronisierung](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#enabling-ldap-sync) für {% data variables.product.product_location_enterprise %} werden Benutzer automatisch gesperrt, wenn sie aus dem LDAP-Verzeichnisserver entfernt werden. Wenn die LDAP-Synchronisierung für Ihre Instanz aktiviert wird, werden die normalen Methoden zur Benutzersperrung deaktiviert. +**Hinweis:** Bei [aktivierter LDAP-Synchronisierung](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#enabling-ldap-sync) für {% data variables.product.product_location_enterprise %} werden Benutzer automatisch gesperrt, wenn sie aus dem LDAP-Verzeichnisserver entfernt werden. Wenn die LDAP-Synchronisierung für Ihre Instanz aktiviert wird, werden die normalen Methoden zur Benutzersperrung deaktiviert. {% endtip %} diff --git a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/adding-a-repository-from-your-local-computer-to-github-desktop.md b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/adding-a-repository-from-your-local-computer-to-github-desktop.md index 552b78117af6..d2bb06af20bc 100644 --- a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/adding-a-repository-from-your-local-computer-to-github-desktop.md +++ b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/adding-a-repository-from-your-local-computer-to-github-desktop.md @@ -1,6 +1,6 @@ --- title: GitHub Desktop ein Repository von Deinem lokalen Computer hinzufügen -intro: 'Du kannst {% data variables.product.prodname_desktop %} jedes beliebige Git-Repository hinzufügen, selbst wenn es sich nicht um ein {% data variables.product.prodname_dotcom %}-Repository handelt.' +intro: 'Sie können {% data variables.product.prodname_desktop %} jedes beliebige Git-Repository hinzufügen, selbst wenn es sich nicht um ein {% data variables.product.prodname_dotcom %}-Repository handelt.' redirect_from: - /desktop/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop versions: @@ -9,7 +9,7 @@ versions: {% tip %} -**Tipp:** Du kannst von Deinem lokalen Computer ein Git-Repository auf den GitHub Desktop hinzufügen. Ziehe dazu den Ordner in das {% data variables.product.prodname_desktop %}-Fenster. Wenn Du mehrere Git-Ordner gleichzeitig auf den {% data variables.product.prodname_desktop %} ziehst, wird jeder Ordner als ein separates Git-Repository hinzugefügt. +**Tipp:** Du kannst von Deinem lokalen Computer ein Git-Repository auf den GitHub Desktop hinzufügen. Ziehe dazu den Ordner in das {% data variables.product.prodname_desktop %}-Fenster. Wenn Sie mehrere Git-Ordner gleichzeitig nach {% data variables.product.prodname_desktop %} ziehen, wird jeder Ordner als ein separates Git-Repository hinzugefügt. {% endtip %} diff --git a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/adding-an-existing-project-to-github-using-github-desktop.md b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/adding-an-existing-project-to-github-using-github-desktop.md index 585e925937ce..d945ba7199ff 100644 --- a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/adding-an-existing-project-to-github-using-github-desktop.md +++ b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/adding-an-existing-project-to-github-using-github-desktop.md @@ -1,6 +1,6 @@ --- title: GitHub mithilfe von GitHub Desktop ein vorhandenes Projekt hinzufügen -intro: 'Mithilfe von {% data variables.product.prodname_desktop %} kannst Du {% data variables.product.prodname_dotcom %} ein vorhandenes Git-Repository hinzufügen.' +intro: 'Mithilfe von {% data variables.product.prodname_desktop %} können Sie {% data variables.product.prodname_dotcom %} ein vorhandenes Git-Repository hinzufügen.' redirect_from: - /desktop/contributing-to-projects/adding-an-existing-project-to-github-using-github-desktop versions: diff --git a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/changing-a-remotes-url-from-github-desktop.md b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/changing-a-remotes-url-from-github-desktop.md index f97f8ad9eb80..ab1383d5e4c3 100644 --- a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/changing-a-remotes-url-from-github-desktop.md +++ b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/changing-a-remotes-url-from-github-desktop.md @@ -1,6 +1,6 @@ --- title: Remote-URL auf GitHub Desktop ändern -intro: 'Du kannst die Remote-URL für ein von Dir verwendetes Repository in {% data variables.product.prodname_desktop %} ändern. Dies ist möglicherweise erforderlich, wenn das Repository umbenannt oder der Benutzername oder die Organisation, dem bzw. der das Repository gehört, geändert wurde.' +intro: 'Sie können die Remote-URL für ein von Ihnen verwendetes Repository in {% data variables.product.prodname_desktop %} ändern. Dies ist möglicherweise erforderlich, wenn das Repository umbenannt oder der Benutzername oder die Organisation, dem bzw. der das Repository gehört, geändert wurde.' redirect_from: - /desktop/contributing-to-projects/changing-a-remotes-url-from-github-desktop - /desktop/contributing-to-projects/changing-a-remote-s-url-from-github-desktop diff --git a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-a-repository-from-github-to-github-desktop.md b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-a-repository-from-github-to-github-desktop.md index 3f807462aee0..0d7e17cde38c 100644 --- a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-a-repository-from-github-to-github-desktop.md +++ b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-a-repository-from-github-to-github-desktop.md @@ -1,6 +1,6 @@ --- title: Repository von GitHub in GitHub Desktop klonen -intro: 'Mit {% data variables.product.prodname_dotcom %} kannst Du Remote-Repositorys zum {% data variables.product.prodname_desktop %} klonen.' +intro: 'Mit {% data variables.product.prodname_dotcom %} können Sie Remote-Repositorys in {% data variables.product.prodname_desktop %} klonen.' redirect_from: - /desktop/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop versions: @@ -15,7 +15,9 @@ versions: {% mac %} -1. Melden Sie sich bei {% data variables.product.product_location %} und {% data variables.product.prodname_desktop %} an, bevor Sie den Klonvorgang starten. +1. Sign in to + +{% data variables.product.product_location %} and {% data variables.product.prodname_desktop %} before you start to clone. {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.open-with-github-desktop %} 5. Klicke auf **Choose...** (Auswählen), und navigiere mithilfe des Finder-Fensters zu einem lokalen Pfad, wo Du das Repository klonen möchtest. ![Die Schaltfläche „choose“ (Auswählen) auf der URL-Registerkarte](/assets/images/help/desktop/clone-choose-button-url-mac.png) @@ -32,7 +34,9 @@ versions: {% windows %} -1. Melden Sie sich bei {% data variables.product.product_location %} und {% data variables.product.prodname_desktop %} an, bevor Sie den Klonvorgang starten. +1. Sign in to + +{% data variables.product.product_location %} and {% data variables.product.prodname_desktop %} before you start to clone. {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.open-with-github-desktop %} 5. Klicke auf **Choose...** (Auswählen), und navigiere mithilfe des Windows-Explorers zu einem lokalen Pfad, wohin Du das Repository klonen möchtest. ![Die Schaltfläche „choose“ (Auswählen)](/assets/images/help/desktop/clone-choose-button-url-win.png) diff --git a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop.md b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop.md index 330cdd0c5796..39f4fa5cc235 100644 --- a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop.md +++ b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop.md @@ -19,8 +19,8 @@ Darüber hinaus kannst Du ein Repository direkt über {% data variables.product. ![Menüoption zum Klonen in der Mac-App](/assets/images/help/desktop/clone-file-menu-mac.png) {% data reusables.desktop.cloning-location-tab %} ![Standort-Registerkarten im Menü „Clone a repository“ (Repository klonen)](/assets/images/help/desktop/choose-repository-location-mac.png) -{% data reusables.desktop.cloning-repository-list %} -![Repository-Liste klonen](/assets/images/help/desktop/clone-a-repository-list-mac.png) +{% data reusables.desktop.cloning-repository-list %} + ![Repository-Liste klonen](/assets/images/help/desktop/clone-a-repository-list-mac.png) 4. Klicke auf **Choose...** (Auswählen), und navigiere mithilfe des Finder-Fensters zu einem lokalen Pfad, wo Du das Repository klonen möchtest. ![Die Schaltfläche „choose“ (Auswählen)](/assets/images/help/desktop/clone-choose-button-mac.png) 5. Klicke auf **Clone** (Klonen). ![Die Schaltfläche „clone“ (Klonen)](/assets/images/help/desktop/clone-button-mac.png) @@ -32,8 +32,8 @@ Darüber hinaus kannst Du ein Repository direkt über {% data variables.product. ![Menüoption zum Klonen in der Windows-App](/assets/images/help/desktop/clone-file-menu-windows.png) {% data reusables.desktop.cloning-location-tab %} ![Standort-Registerkarten im Menü „Clone a repository“ (Repository klonen)](/assets/images/help/desktop/choose-repository-location-win.png) -{% data reusables.desktop.cloning-repository-list %} -![Repository-Liste klonen](/assets/images/help/desktop/clone-a-repository-list-win.png) +{% data reusables.desktop.cloning-repository-list %} + ![Repository-Liste klonen](/assets/images/help/desktop/clone-a-repository-list-win.png) 4. Klicke auf **Choose...** (Auswählen), und navigiere mithilfe des Windows-Explorers zu einem lokalen Pfad, wohin Du das Repository klonen möchtest. ![Die Schaltfläche „choose“ (Auswählen)](/assets/images/help/desktop/clone-choose-button-win.png) 5. Klicke auf **Clone** (Klonen). ![Die Schaltfläche „clone“ (Klonen)](/assets/images/help/desktop/clone-button-win.png) diff --git a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/committing-and-reviewing-changes-to-your-project.md b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/committing-and-reviewing-changes-to-your-project.md index 9709c474242b..6ef05edbb3c2 100644 --- a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/committing-and-reviewing-changes-to-your-project.md +++ b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/committing-and-reviewing-changes-to-your-project.md @@ -1,6 +1,6 @@ --- title: Änderungen an Deinem Projekt sowohl per Commit übertragen als auch überprüfen -intro: '{% data variables.product.prodname_desktop %} verfolgt alle Änderungen an allen Dateien, während Du sie bearbeitest. Du kannst festlegen, wie die Änderungen gruppiert werden sollen, um aussagekräftige Commits zu erstellen.' +intro: '{% data variables.product.prodname_desktop %} verfolgt alle Änderungen an allen Dateien, während Sie sie bearbeiten. Du kannst festlegen, wie die Änderungen gruppiert werden sollen, um aussagekräftige Commits zu erstellen.' redirect_from: - /desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project versions: @@ -23,7 +23,7 @@ versions: ### 2. Die in einen Commit einzubeziehenden Änderungen auswählen -Wenn Du in Deinem Texteditor Änderungen an Dateien vornimmst und Du diese lokal speicherst, werden die Änderungen auch in {% data variables.product.prodname_desktop %} angezeigt. +Wenn Sie in Ihrem Texteditor Änderungen an Dateien vornehmen und Sie diese lokal speichern, werden die Änderungen auch in {% data variables.product.prodname_desktop %} angezeigt. * Das rote {% octicon "diff-removed" aria-label="The diff removed icon color-red" %}-Symbol weist auf entfernte Dateien hin. * Das gelbe {% octicon "diff-modified" aria-label="The diff modified icon color-yellow" %}-Symbol weist auf geänderte Dateien hin. diff --git a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request.md b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request.md index 51df10eb9a21..e74c35e2ccda 100644 --- a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request.md +++ b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request.md @@ -1,6 +1,6 @@ --- title: Ein „Issue“ (Problem) oder einen Pull-Request erstellen -intro: 'Du kannst ein „Issue“ (Problem) oder einen Pull-Request erstellen, um Änderungen an einem Projektarchiv vorzuschlagen und gemeinsam daran zu arbeiten.' +intro: Du kannst ein „Issue“ (Problem) oder einen Pull-Request erstellen, um Änderungen an einem Projektarchiv vorzuschlagen und gemeinsam daran zu arbeiten. permissions: 'Anyone can create an issue in a public repository that has issues enabled. Jeder, der Leseberechtigungen für ein Repository besitzt, kann einen Pull Request erstellen. Du benötigst jedoch Schreibberechtigungen, um einen Branch zu erstellen.' redirect_from: - /desktop/contributing-to-projects/creating-an-issue-or-pull-request @@ -50,7 +50,9 @@ Before you create a pull request, you'll need to push changes to a branch on {% 1. Switch to the branch that you want to create a pull request for. For more information, see "[Switching between branches](/desktop/contributing-and-collaborating-using-github-desktop/managing-branches#switching-between-branches)." 2. Klicke auf **Create Pull Request** (Pull-Request erstellen). {% data variables.product.prodname_desktop %} will open your default browser to take you to {% data variables.product.prodname_dotcom %}. ![The Create Pull Request button](/assets/images/help/desktop/mac-create-pull-request.png) -4. On {% data variables.product.prodname_dotcom %}, confirm that the branch in the **base:** drop-down menu is the branch where you want to merge your changes. Confirm that the branch in the **compare:** drop-down menu is the topic branch where you made your changes. ![Dropdown-Menüs zur Auswahl von Basis- und Vergleichs-Branches](/assets/images/help/desktop/base-and-compare-branches.png) +4. On +{% data variables.product.prodname_dotcom %}, confirm that the branch in the **base:** drop-down menu is the branch where you want to merge your changes. Confirm that the branch in the **compare:** drop-down menu is the topic branch where you made your changes. + ![Dropdown-Menüs zur Auswahl von Basis- und Vergleichs-Branches](/assets/images/help/desktop/base-and-compare-branches.png) {% data reusables.repositories.pr-title-description %} {% data reusables.repositories.create-pull-request %} @@ -60,7 +62,9 @@ Before you create a pull request, you'll need to push changes to a branch on {% 1. Switch to the branch that you want to create a pull request for. For more information, see "[Switching between branches](/desktop/contributing-and-collaborating-using-github-desktop/managing-branches#switching-between-branches)." 2. Klicke auf **Create Pull Request** (Pull-Request erstellen). {% data variables.product.prodname_desktop %} will open your default browser to take you to {% data variables.product.prodname_dotcom %}. ![The Create Pull Request button](/assets/images/help/desktop/windows-create-pull-request.png) -3. On {% data variables.product.prodname_dotcom %}, confirm that the branch in the **base:** drop-down menu is the branch where you want to merge your changes. Confirm that the branch in the **compare:** drop-down menu is the topic branch where you made your changes. ![Dropdown-Menüs zur Auswahl von Basis- und Vergleichs-Branches](/assets/images/help/desktop/base-and-compare-branches.png) +3. On +{% data variables.product.prodname_dotcom %}, confirm that the branch in the **base:** drop-down menu is the branch where you want to merge your changes. Confirm that the branch in the **compare:** drop-down menu is the topic branch where you made your changes. + ![Dropdown-Menüs zur Auswahl von Basis- und Vergleichs-Branches](/assets/images/help/desktop/base-and-compare-branches.png) {% data reusables.repositories.pr-title-description %} {% data reusables.repositories.create-pull-request %} diff --git a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/keeping-your-local-repository-in-sync-with-github.md b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/keeping-your-local-repository-in-sync-with-github.md index 2d7efabb492b..724e0048dccc 100644 --- a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/keeping-your-local-repository-in-sync-with-github.md +++ b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/keeping-your-local-repository-in-sync-with-github.md @@ -1,6 +1,6 @@ --- title: Keeping your local repository in sync with GitHub -intro: 'You can keep your local repository in sync with your remote repository as you make changes to either one. In Git ist eine *Remote*-Instanz der Server, auf dem Dein Code gespeichert ist. In Deinem Fall ist dieser Server ein Repository auf {% data variables.product.prodname_dotcom %} oder {% data variables.product.prodname_enterprise %}.' +intro: 'You can keep your local repository in sync with your remote repository as you make changes to either one. In Git ist eine *Remote*-Instanz der Server, auf dem Dein Code gespeichert ist. In Ihrem Fall ist dieser Server ein Repository auf {% data variables.product.prodname_dotcom %} oder {% data variables.product.prodname_enterprise %}.' mapTopic: true versions: free-pro-team: '*' diff --git a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/managing-tags.md b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/managing-tags.md index b782e251dda2..c452b397514c 100644 --- a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/managing-tags.md +++ b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/managing-tags.md @@ -1,5 +1,5 @@ --- -title: „Tags“ (Schlagworte) verwalten +title: '„Tags“ (Schlagworte) verwalten' intro: 'Du kannst {% data variables.product.prodname_desktop %} für die Erstellung, den Push-Zugriff und die Anzeige von „Tags“ (Schlagworten) verwenden.' redirect_from: - /desktop/contributing-to-projects/managing-tags diff --git a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/reverting-a-commit.md b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/reverting-a-commit.md index 35ac15548f24..a0ac723b6c30 100644 --- a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/reverting-a-commit.md +++ b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/reverting-a-commit.md @@ -1,6 +1,6 @@ --- title: Einen Commit rückgängig machen -intro: 'Du kannst einen bestimmten Commit zurücksetzen, um dessen Änderungen aus deinem Branch zu entfernen.' +intro: Du kannst einen bestimmten Commit zurücksetzen, um dessen Änderungen aus deinem Branch zu entfernen. redirect_from: - /desktop/contributing-to-projects/reverting-a-commit versions: diff --git a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/syncing-your-branch.md b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/syncing-your-branch.md index 2c536d025bef..afac06e60412 100644 --- a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/syncing-your-branch.md +++ b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/syncing-your-branch.md @@ -32,7 +32,7 @@ Some workflows require or benefit from rebasing instead of merging. Durch das Re {% note %} - **Hinweis:** Bei Merge-Konflikten wirst Du oberhalb der Schaltfläche **Merge BRANCH into BRANCH** (BRANCH per Merge in BRANCH fusionieren) von {% data variables.product.prodname_desktop %} gewarnt. Sie können die Branches erst mergen, nachdem Sie alle Konflikte behoben haben. + **Hinweis:** Bei Mergekonflikten werden Sie oberhalb der Schaltfläche **Merge BRANCH into BRANCH** (Branch in Branch mergen) von {% data variables.product.prodname_desktop %} gewarnt. Sie können die Branches erst mergen, nachdem Sie alle Konflikte behoben haben. {% endnote %} diff --git a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/viewing-a-pull-request-in-github-desktop.md b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/viewing-a-pull-request-in-github-desktop.md index a74dd598070e..84cee2002891 100644 --- a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/viewing-a-pull-request-in-github-desktop.md +++ b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/viewing-a-pull-request-in-github-desktop.md @@ -1,7 +1,7 @@ --- title: Viewing a pull request in GitHub Desktop shortTitle: Viewing a pull request -intro: 'Du kannst die vorgeschlagenen Änderungen in offenen Pull Requests auf {% data variables.product.prodname_desktop %} anzeigen.' +intro: 'Sie können die vorgeschlagenen Änderungen in offenen Pull Requests auf {% data variables.product.prodname_desktop %} anzeigen.' redirect_from: - /desktop/contributing-to-projects/accessing-a-pull-request-locally - /desktop/contributing-and-collaborating-using-github-desktop/accessing-a-pull-request-locally diff --git a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise.md b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise.md index 903a5a93a217..ee11664abf43 100644 --- a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise.md +++ b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise.md @@ -1,6 +1,6 @@ --- title: Mit Deinem Remote-Repository auf GitHub oder GitHub Enterprise arbeiten -intro: 'Während Du Änderungen an Deinem Projekt lokal vornimmst, kannst Du diese mit Deinem Remote-Repository abgeglichen halten. In Git ist eine *Remote*-Instanz der Server, auf dem Dein Code gespeichert ist. In Deinem Fall ist dieser Server ein Repository auf {% data variables.product.prodname_dotcom %} oder {% data variables.product.prodname_enterprise %}.' +intro: 'Während Du Änderungen an Deinem Projekt lokal vornimmst, kannst Du diese mit Deinem Remote-Repository abgeglichen halten. In Git ist eine *Remote*-Instanz der Server, auf dem Dein Code gespeichert ist. In Ihrem Fall ist dieser Server ein Repository auf {% data variables.product.prodname_dotcom %} oder {% data variables.product.prodname_enterprise %}.' mapTopic: true redirect_from: - /desktop/contributing-to-projects/working-with-your-remote-repository-on-github-or-github-enterprise diff --git a/translations/de-DE/content/desktop/installing-and-configuring-github-desktop/authenticating-to-github.md b/translations/de-DE/content/desktop/installing-and-configuring-github-desktop/authenticating-to-github.md index fcb01d67c438..b0b8b1b447e0 100644 --- a/translations/de-DE/content/desktop/installing-and-configuring-github-desktop/authenticating-to-github.md +++ b/translations/de-DE/content/desktop/installing-and-configuring-github-desktop/authenticating-to-github.md @@ -13,7 +13,7 @@ versions: To keep your account secure, you must authenticate before you can use {% data variables.product.prodname_desktop %} to access resources on {% data variables.product.prodname_dotcom %}. -Vor Deiner Authentifizierung: {% data reusables.desktop.get-an-account %} +Vor Ihrer Authentifizierung {% data reusables.desktop.get-an-account %} {% mac %} @@ -37,7 +37,9 @@ Vor Deiner Authentifizierung: {% data reusables.desktop.get-an-account %} {% data reusables.desktop.mac-select-desktop-menu %} {% data reusables.desktop.mac-select-accounts %} {% data reusables.desktop.choose-product-authenticate %} -4. To add a {% data variables.product.prodname_enterprise %} account, type your credentials under "Enterprise server address," then click **Continue**. ![Die Schaltfläche „Sign In“ (Anmelden) für GitHub Enterprise](/assets/images/help/desktop/mac-sign-in-button-enterprise.png) +4. To add a +{% data variables.product.prodname_enterprise %} account, type your credentials under "Enterprise server address," then click **Continue**. + ![Die Schaltfläche „Sign In“ (Anmelden) für GitHub Enterprise](/assets/images/help/desktop/mac-sign-in-button-enterprise.png) {% data reusables.desktop.retrieve-2fa %} {% endmac %} @@ -65,7 +67,9 @@ Vor Deiner Authentifizierung: {% data reusables.desktop.get-an-account %} {% data reusables.desktop.windows-choose-options %} {% data reusables.desktop.windows-select-accounts %} {% data reusables.desktop.choose-product-authenticate %} -4. To add a {% data variables.product.prodname_enterprise %} account, type your credentials under "Enterprise server address," then click **Continue**. ![Die Schaltfläche „Sign In“ (Anmelden) für GitHub Enterprise](/assets/images/help/desktop/windows-sign-in-button-enterprise.png) +4. To add a +{% data variables.product.prodname_enterprise %} account, type your credentials under "Enterprise server address," then click **Continue**. + ![Die Schaltfläche „Sign In“ (Anmelden) für GitHub Enterprise](/assets/images/help/desktop/windows-sign-in-button-enterprise.png) {% data reusables.desktop.retrieve-2fa %} {% endwindows %} diff --git a/translations/de-DE/content/desktop/installing-and-configuring-github-desktop/keyboard-shortcuts.md b/translations/de-DE/content/desktop/installing-and-configuring-github-desktop/keyboard-shortcuts.md index bbb7f0f9cadc..7eafa957d76c 100644 --- a/translations/de-DE/content/desktop/installing-and-configuring-github-desktop/keyboard-shortcuts.md +++ b/translations/de-DE/content/desktop/installing-and-configuring-github-desktop/keyboard-shortcuts.md @@ -14,51 +14,51 @@ GitHub Desktop-Tastenkürzel auf macOS ### Seitenweite Tastenkürzel -| Tastenkürzel | Beschreibung | -| ------------------------------------ | ----------------------------------------------------------------------- | -| ⌘, | Zu „Preferences“ (Voreinstellungen) navigieren | +| Tastenkürzel | Beschreibung | +| ------------------------------------ | ------------------------------------------------------------------ | +| ⌘, | Zu „Preferences“ (Voreinstellungen) navigieren | | ⌘H | {% data variables.product.prodname_desktop %}-Anwendung ausblenden | -| ⌥⌘H | Alle anderen Anwendungen ausblenden | +| ⌥⌘H | Alle anderen Anwendungen ausblenden | | ⌘Q | {% data variables.product.prodname_desktop %} beenden | -| ⌃⌘F | Vollbildansicht umschalten | -| ⌘0 | Zoom auf Standardtextgröße zurücksetzen | -| ⌘= | Für größere Texte und Grafiken vergrößern | -| ⌘- | Für kleinere Texte und Grafiken verkleinern | -| ⌥⌘I | Entwicklertools umschalten | +| ⌃⌘F | Vollbildansicht umschalten | +| ⌘0 | Zoom auf Standardtextgröße zurücksetzen | +| ⌘= | Für größere Texte und Grafiken vergrößern | +| ⌘- | Für kleinere Texte und Grafiken verkleinern | +| ⌥⌘I | Entwicklertools umschalten | ### Repositorys -| Tastenkürzel | Beschreibung | -| ------------------------------------ | ------------------------------------------------------------------------------------------------ | -| ⌘N | Neues Repository hinzufügen | -| ⌘O | Lokales Repository hinzufügen | +| Tastenkürzel | Beschreibung | +| ------------------------------------ | ------------------------------------------------------------------------------------------- | +| ⌘N | Neues Repository hinzufügen | +| ⌘O | Lokales Repository hinzufügen | | ⇧⌘O | Repository in {% data variables.product.prodname_dotcom %} klonen | -| ⌘T | Liste Ihrer Repositorys anzeigen | +| ⌘T | Liste Ihrer Repositorys anzeigen | | ⌘P | Neueste Commits per Push-Vorgang an {% data variables.product.prodname_dotcom %} übertragen | | ⇧⌘P | Neueste Änderungen von {% data variables.product.prodname_dotcom %} abrufen | -| ⌘⌫ | Vorhandenes Repository entfernen | +| ⌘⌫ | Vorhandenes Repository entfernen | | ⇧⌘G | Repository auf {% data variables.product.prodname_dotcom %} anzeigen | -| ⌃` | Repository in Ihrem bevorzugten Terminaltool öffnen | -| ⇧⌘F | Repository im Finder anzeigen | -| ⇧⌘A | Repository in Ihrem bevorzugten Editor-Tool öffnen | +| ⌃` | Repository in Ihrem bevorzugten Terminaltool öffnen | +| ⇧⌘F | Repository im Finder anzeigen | +| ⇧⌘A | Repository in Ihrem bevorzugten Editor-Tool öffnen | | ⌘I | Ein „Issue“ (Problemticket) auf {% data variables.product.prodname_dotcom %} erstellen | ### Branches -| Tastenkürzel | Beschreibung | -| ------------------------------------ | ------------------------------------------------------------------------------------- | -| ⌘1 | Alle Ihre Änderungen vor dem Committen anzeigen | -| ⌘2 | Commit-Verlauf anzeigen | -| ⌘B | Alle Ihre Branches anzeigen | -| ⌘G | Zum Commit-Zusammenfassungsfeld navigieren | -| space (Leerzeichen) | Select or deselect all highlighted files | -| ⇧⌘N | Neuen Branch erstellen | -| ⇧⌘R | Aktuellen Branch umbenennen | -| ⇧⌘D | Aktuellen Branch löschen | -| ⇧⌘U | Über Standardbranch aktualisieren | -| ⇧⌘B | Mit einem vorhandenen Branch vergleichen | -| ⇧⌘M | In aktuellen Branch mergen | -| ⌃H | Gestashte Änderungen anzeigen oder ausblenden | +| Tastenkürzel | Beschreibung | +| ------------------------------------ | -------------------------------------------------------------------------------- | +| ⌘1 | Alle Ihre Änderungen vor dem Committen anzeigen | +| ⌘2 | Commit-Verlauf anzeigen | +| ⌘B | Alle Ihre Branches anzeigen | +| ⌘G | Zum Commit-Zusammenfassungsfeld navigieren | +| space (Leerzeichen) | Select or deselect all highlighted files | +| ⇧⌘N | Neuen Branch erstellen | +| ⇧⌘R | Aktuellen Branch umbenennen | +| ⇧⌘D | Aktuellen Branch löschen | +| ⇧⌘U | Über Standardbranch aktualisieren | +| ⇧⌘B | Mit einem vorhandenen Branch vergleichen | +| ⇧⌘M | In aktuellen Branch mergen | +| ⌃H | Gestashte Änderungen anzeigen oder ausblenden | | ⇧⌘C | Branches auf {% data variables.product.prodname_dotcom %} vergleichen | | ⌘R | Aktuellen Pull Request auf {% data variables.product.prodname_dotcom %} anzeigen | @@ -81,37 +81,37 @@ GitHub Desktop-Tastenkürzel auf Windows ### Repositorys -| Tastenkürzel | Beschreibung | -| ---------------------------------------------- | ------------------------------------------------------------------------------------------------ | -| STRGN | Neues Repository hinzufügen | -| STRGO | Lokales Repository hinzufügen | +| Tastenkürzel | Beschreibung | +| ---------------------------------------------- | ------------------------------------------------------------------------------------------- | +| STRGN | Neues Repository hinzufügen | +| STRGO | Lokales Repository hinzufügen | | STRGUMSCHALTO | Repository in {% data variables.product.prodname_dotcom %} klonen | -| STRGT | Liste Ihrer Repositorys anzeigen | +| STRGT | Liste Ihrer Repositorys anzeigen | | STRGP | Neueste Commits per Push-Vorgang an {% data variables.product.prodname_dotcom %} übertragen | | STRGUMSCHALTP | Neueste Änderungen von {% data variables.product.prodname_dotcom %} abrufen | -| STRGENTF | Vorhandenes Repository entfernen | +| STRGENTF | Vorhandenes Repository entfernen | | STRGUMSCHALTG | Repository auf {% data variables.product.prodname_dotcom %} anzeigen | -| STRG` | Repository in Ihrem bevorzugten Befehlszeilentool öffnen | -| STRGUMSCHALTF | Repository im Explorer anzeigen | -| STRGUMSCHALTA | Repository in Ihrem bevorzugten Editor-Tool öffnen | +| STRG` | Repository in Ihrem bevorzugten Befehlszeilentool öffnen | +| STRGUMSCHALTF | Repository im Explorer anzeigen | +| STRGUMSCHALTA | Repository in Ihrem bevorzugten Editor-Tool öffnen | | CtrlI | Ein „Issue“ (Problemticket) auf {% data variables.product.prodname_dotcom %} erstellen | ### Branches -| Tastenkürzel | Beschreibung | -| ---------------------------------------------- | ------------------------------------------------------------------------------------- | -| STRG1 | Alle Ihre Änderungen vor dem Committen anzeigen | -| STRG2 | Commit-Verlauf anzeigen | -| STRGB | Alle Ihre Branches anzeigen | -| STRGG | Zum Commit-Zusammenfassungsfeld navigieren | -| space (Leerzeichen) | Select or deselect all highlighted files | -| STRGUMSCHALTN | Neuen Branch erstellen | -| STRGUMSCHALTR | Aktuellen Branch umbenennen | -| STRGUMSCHALTD | Aktuellen Branch löschen | -| STRGUMSCHALTU | Über Standardbranch aktualisieren | -| STRGUMSCHALTB | Mit einem vorhandenen Branch vergleichen | -| STRGUMSCHALTM | In aktuellen Branch mergen | -| STRGH | Gestashte Änderungen anzeigen oder ausblenden | +| Tastenkürzel | Beschreibung | +| ---------------------------------------------- | -------------------------------------------------------------------------------- | +| STRG1 | Alle Ihre Änderungen vor dem Committen anzeigen | +| STRG2 | Commit-Verlauf anzeigen | +| STRGB | Alle Ihre Branches anzeigen | +| STRGG | Zum Commit-Zusammenfassungsfeld navigieren | +| space (Leerzeichen) | Select or deselect all highlighted files | +| STRGUMSCHALTN | Neuen Branch erstellen | +| STRGUMSCHALTR | Aktuellen Branch umbenennen | +| STRGUMSCHALTD | Aktuellen Branch löschen | +| STRGUMSCHALTU | Über Standardbranch aktualisieren | +| STRGUMSCHALTB | Mit einem vorhandenen Branch vergleichen | +| STRGUMSCHALTM | In aktuellen Branch mergen | +| STRGH | Gestashte Änderungen anzeigen oder ausblenden | | STRGUMSCHALTC | Branches auf {% data variables.product.prodname_dotcom %} vergleichen | | STRGR | Aktuellen Pull Request auf {% data variables.product.prodname_dotcom %} anzeigen | diff --git a/translations/de-DE/content/desktop/installing-and-configuring-github-desktop/setting-a-theme-for-github-desktop.md b/translations/de-DE/content/desktop/installing-and-configuring-github-desktop/setting-a-theme-for-github-desktop.md index 33ef9c4b6348..7472df951c06 100644 --- a/translations/de-DE/content/desktop/installing-and-configuring-github-desktop/setting-a-theme-for-github-desktop.md +++ b/translations/de-DE/content/desktop/installing-and-configuring-github-desktop/setting-a-theme-for-github-desktop.md @@ -1,6 +1,6 @@ --- title: Design für GitHub Desktop festlegen -intro: 'Sie können ein Design festlegen, um das Erscheinungsbild von GitHub-Desktop anzupassen.' +intro: Sie können ein Design festlegen, um das Erscheinungsbild von GitHub-Desktop anzupassen. redirect_from: - /desktop/getting-started-with-github-desktop/setting-a-theme-for-github-desktop versions: diff --git a/translations/de-DE/content/developers/apps/about-apps.md b/translations/de-DE/content/developers/apps/about-apps.md index c06984a5a00f..401164488979 100644 --- a/translations/de-DE/content/developers/apps/about-apps.md +++ b/translations/de-DE/content/developers/apps/about-apps.md @@ -19,7 +19,7 @@ Apps on {% data variables.product.prodname_dotcom %} allow you to automate and i For a walkthrough of the process of building a {% data variables.product.prodname_github_app %}, see "[Building Your First {% data variables.product.prodname_github_app %}](/apps/building-your-first-github-app)." -### Informationen zu {% data variables.product.prodname_github_apps %} +### Informationen zum {% data variables.product.prodname_github_apps %} {% data variables.product.prodname_github_apps %} are first-class actors within GitHub. A {% data variables.product.prodname_github_app %} acts on its own behalf, taking actions via the API directly using its own identity, which means you don't need to maintain a bot or service account as a separate user. diff --git a/translations/de-DE/content/developers/apps/activating-beta-features-for-apps.md b/translations/de-DE/content/developers/apps/activating-beta-features-for-apps.md index 389ecf6690b1..f349501d5f0c 100644 --- a/translations/de-DE/content/developers/apps/activating-beta-features-for-apps.md +++ b/translations/de-DE/content/developers/apps/activating-beta-features-for-apps.md @@ -15,7 +15,8 @@ versions: {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} -3. Select the {% data variables.product.prodname_github_app %} you want to enable a beta feature for. +3. Select the +{% data variables.product.prodname_github_app %} you want to enable a beta feature for. {% data reusables.apps.beta_feature_activation %} ### Activating beta features for {% data variables.product.prodname_oauth_app %}s diff --git a/translations/de-DE/content/developers/apps/authorizing-oauth-apps.md b/translations/de-DE/content/developers/apps/authorizing-oauth-apps.md index f8e672201145..87f8be697567 100644 --- a/translations/de-DE/content/developers/apps/authorizing-oauth-apps.md +++ b/translations/de-DE/content/developers/apps/authorizing-oauth-apps.md @@ -1,5 +1,5 @@ --- -title: OAuth-Apps autorisieren +title: Authorizing OAuth Apps intro: '{% data reusables.shortdesc.authorizing_oauth_apps %}' redirect_from: - /apps/building-integrations/setting-up-and-registering-oauth-apps/about-authorization-options-for-oauth-apps/ @@ -52,14 +52,14 @@ When your GitHub App specifies a `login` parameter, it prompts users with a spec ##### Parameters -| Name | Typ | Beschreibung | -| -------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `client_id` | `string` | **Required**. The client ID you received from GitHub when you {% if currentVersion == "free-pro-team@latest" %}[registered](https://github.com/settings/applications/new){% else %}registered{% endif %}. | -| `redirect_uri` | `string` | The URL in your application where users will be sent after authorization. See details below about [redirect urls](#redirect-urls). | -| `login` | `string` | Suggests a specific account to use for signing in and authorizing the app. | -| `Umfang` | `string` | A space-delimited list of [scopes](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/). If not provided, `scope` defaults to an empty list for users that have not authorized any scopes for the application. For users who have authorized scopes for the application, the user won't be shown the OAuth authorization page with the list of scopes. Instead, this step of the flow will automatically complete with the set of scopes the user has authorized for the application. For example, if a user has already performed the web flow twice and has authorized one token with `user` scope and another token with `repo` scope, a third web flow that does not provide a `scope` will receive a token with `user` and `repo` scope. | -| `state` | `string` | {% data reusables.apps.state_description %} | -| `allow_signup` | `string` | Whether or not unauthenticated users will be offered an option to sign up for GitHub during the OAuth flow. The default is `true`. Use `false` when a policy prohibits signups. | +Name | Type | Description +-----|------|-------------- +`client_id`|`string` | **Required**. The client ID you received from GitHub when you {% if currentVersion == "free-pro-team@latest" %}[registered](https://github.com/settings/applications/new){% else %}registered{% endif %}. +`redirect_uri`|`string` | The URL in your application where users will be sent after authorization. See details below about [redirect urls](#redirect-urls). +`login` | `string` | Suggests a specific account to use for signing in and authorizing the app. +`scope`|`string` | A space-delimited list of [scopes](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/). If not provided, `scope` defaults to an empty list for users that have not authorized any scopes for the application. For users who have authorized scopes for the application, the user won't be shown the OAuth authorization page with the list of scopes. Instead, this step of the flow will automatically complete with the set of scopes the user has authorized for the application. For example, if a user has already performed the web flow twice and has authorized one token with `user` scope and another token with `repo` scope, a third web flow that does not provide a `scope` will receive a token with `user` and `repo` scope. +`state` | `string` | {% data reusables.apps.state_description %} +`allow_signup`|`string` | Whether or not unauthenticated users will be offered an option to sign up for GitHub during the OAuth flow. The default is `true`. Use `false` when a policy prohibits signups. #### 2. Users are redirected back to your site by GitHub @@ -71,13 +71,13 @@ Exchange this `code` for an access token: ##### Parameters -| Name | Typ | Beschreibung | -| --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `client_id` | `string` | **Required.** The client ID you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_github_app %}. | -| `client_secret` | `string` | **Required.** The client secret you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_github_app %}. | -| `Code` | `string` | **Required.** The code you received as a response to Step 1. | -| `redirect_uri` | `string` | The URL in your application where users are sent after authorization. | -| `state` | `string` | The unguessable random string you provided in Step 1. | +Name | Type | Description +-----|------|-------------- +`client_id` | `string` | **Required.** The client ID you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_github_app %}. +`client_secret` | `string` | **Required.** The client secret you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_github_app %}. +`code` | `string` | **Required.** The code you received as a response to Step 1. +`redirect_uri` | `string` | The URL in your application where users are sent after authorization. +`state` | `string` | The unguessable random string you provided in Step 1. ##### Response @@ -85,11 +85,12 @@ By default, the response takes the following form: access_token=e72e16c7e42f292c6912e7710c838347ae178b4a&token_type=bearer -You can also receive the content in different formats depending on the Accept header: +You can also receive the content in different formats depending on the Accept +header: Accept: application/json {"access_token":"e72e16c7e42f292c6912e7710c838347ae178b4a", "scope":"repo,gist", "token_type":"bearer"} - + Accept: application/xml bearer @@ -135,14 +136,13 @@ Your app must request a user verification code and verification URL that the app ##### Input Parameters -| Name | Typ | Beschreibung | -| ----------- | -------- | ---------------------------------------------------------------------------------------------------------- | -| `client_id` | `string` | **Required.** The client ID you received from {% data variables.product.product_name %} for your app. | -| `Umfang` | `string` | The scope that your app is requesting access to. | +Name | Type | Description +-----|------|-------------- +`client_id` | `string` | **Required.** The client ID you received from {% data variables.product.product_name %} for your app. +`scope` | `string` | The scope that your app is requesting access to. ##### Response - {% if currentVersion == "free-pro-team@latest" %} ```JSON { @@ -167,13 +167,13 @@ Your app must request a user verification code and verification URL that the app ##### Response parameters -| Name | Typ | Beschreibung | -| ------------------ | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `device_code` | `string` | The device verification code is 40 characters and used to verify the device. | -| `user_code` | `string` | The user verification code is displayed on the device so the user can enter the code in a browser. This code is 8 characters with a hyphen in the middle. | -| `verification_uri` | `string` | The verification URL where users need to enter the `user_code`: {% data variables.product.device_authorization_url %}. | -| `expires_in` | `integer` | The number of seconds before the `device_code` and `user_code` expire. The default is 900 seconds or 15 minutes. | -| `interval` | `integer` | The minimum number of seconds that must pass before you can make a new access token request (`POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`) to complete the device authorization. For example, if the interval is 5, then you cannot make a new request until 5 seconds pass. If you make more than one request over 5 seconds, then you will hit the rate limit and receive a `slow_down` error. | +Name | Type | Description +-----|------|-------------- +`device_code` | `string` | The device verification code is 40 characters and used to verify the device. +`user_code` | `string` | The user verification code is displayed on the device so the user can enter the code in a browser. This code is 8 characters with a hyphen in the middle. +`verification_uri` | `string` | The verification URL where users need to enter the `user_code`: {% data variables.product.device_authorization_url %}. +`expires_in` | `integer`| The number of seconds before the `device_code` and `user_code` expire. The default is 900 seconds or 15 minutes. +`interval` | `integer` | The minimum number of seconds that must pass before you can make a new access token request (`POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`) to complete the device authorization. For example, if the interval is 5, then you cannot make a new request until 5 seconds pass. If you make more than one request over 5 seconds, then you will hit the rate limit and receive a `slow_down` error. #### Step 2: Prompt the user to enter the user code in a browser @@ -193,11 +193,11 @@ Once the user has authorized, the app will receive an access token that can be u ##### Input parameters -| Name | Typ | Beschreibung | -| ------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `client_id` | `string` | **Required.** The client ID you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_oauth_app %}. | -| `device_code` | `string` | **Required.** The device verification code you received from the `POST {% data variables.product.oauth_host_code %}/login/device/code` request. | -| `grant_type` | `string` | **Required.** The grant type must be `urn:ietf:params:oauth:grant-type:device_code`. | +Name | Type | Description +-----|------|-------------- +`client_id` | `string` | **Required.** The client ID you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_oauth_app %}. +`device_code` | `string` | **Required.** The device verification code you received from the `POST {% data variables.product.oauth_host_code %}/login/device/code` request. +`grant_type` | `string` | **Required.** The grant type must be `urn:ietf:params:oauth:grant-type:device_code`. ##### Response @@ -217,15 +217,15 @@ If you make more than one access token request (`POST {% data variables.product. #### Error codes for the device flow -| Error code | Beschreibung | -| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `authorization_pending` | This error occurs when the authorization request is pending and the user hasn't entered the user code yet. The app is expected to keep polling the `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token` request without exceeding the [`interval`](#response-parameters), which requires a minimum number of seconds between each request. | -| `slow_down` | When you receive the `slow_down` error, 5 extra seconds are added to the minimum `interval` or timeframe required between your requests using `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`. For example, if the starting interval required at least 5 seconds between requests and you get a `slow_down` error response, you must now wait a minimum of 10 seconds before making a new request for an OAuth access token. The error response includes the new `interval` that you must use. | -| `expired_token` | If the device code expired, then you will see the `token_expired` error. You must make a new request for a device code. | -| `unsupported_grant_type` | The grant type must be `urn:ietf:params:oauth:grant-type:device_code` and included as an input parameter when you poll the OAuth token request `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`. | -| `incorrect_client_credentials` | For the device flow, you must pass your app's client ID, which you can find on your app settings page. The `client_secret` is not needed for the device flow. | -| `incorrect_device_code` | The device_code provided is not valid. | -| `access_denied` | When a user clicks cancel during the authorization process, you'll receive a `access_denied` error and the user won't be able to use the verification code again. | +| Error code | Description | +|----|----| +| `authorization_pending`| This error occurs when the authorization request is pending and the user hasn't entered the user code yet. The app is expected to keep polling the `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token` request without exceeding the [`interval`](#response-parameters), which requires a minimum number of seconds between each request. | +| `slow_down` | When you receive the `slow_down` error, 5 extra seconds are added to the minimum `interval` or timeframe required between your requests using `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`. For example, if the starting interval required at least 5 seconds between requests and you get a `slow_down` error response, you must now wait a minimum of 10 seconds before making a new request for an OAuth access token. The error response includes the new `interval` that you must use. +| `expired_token` | If the device code expired, then you will see the `token_expired` error. You must make a new request for a device code. +| `unsupported_grant_type` | The grant type must be `urn:ietf:params:oauth:grant-type:device_code` and included as an input parameter when you poll the OAuth token request `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`. +| `incorrect_client_credentials` | For the device flow, you must pass your app's client ID, which you can find on your app settings page. The `client_secret` is not needed for the device flow. +| `incorrect_device_code` | The device_code provided is not valid. +| `access_denied` | When a user clicks cancel during the authorization process, you'll receive a `access_denied` error and the user won't be able to use the verification code again. For more information, see the "[OAuth 2.0 Device Authorization Grant](https://tools.ietf.org/html/rfc8628#section-3.5)." @@ -237,16 +237,22 @@ Non-web authentication is available for limited situations like testing. If you {% note %} -**Note:** When using the non-web application flow to create an OAuth2 token, make sure to understand how to [work with two-factor authentication](/v3/auth/#working-with-two-factor-authentication) if you or your users have two-factor authentication enabled. +**Note:** When using the non-web application flow to create an OAuth2 token, make sure to understand how to [work with +two-factor authentication](/v3/auth/#working-with-two-factor-authentication) if +you or your users have two-factor authentication enabled. {% endnote %} ### Redirect URLs -The `redirect_uri` parameter is optional. If left out, GitHub will redirect users to the callback URL configured in the OAuth Application settings. If provided, the redirect URL's host and port must exactly match the callback URL. The redirect URL's path must reference a subdirectory of the callback URL. +The `redirect_uri` parameter is optional. If left out, GitHub will +redirect users to the callback URL configured in the OAuth Application +settings. If provided, the redirect URL's host and port must exactly +match the callback URL. The redirect URL's path must reference a +subdirectory of the callback URL. CALLBACK: http://example.com/path - + GOOD: http://example.com/path GOOD: http://example.com/path/subdir/other BAD: http://example.com/bar @@ -289,7 +295,7 @@ To build this link, you'll need your OAuth Apps `client_id` that you received fr {% endtip %} -### Problemlösungen +### Troubleshooting * "[Troubleshooting authorization request errors](/apps/managing-oauth-apps/troubleshooting-authorization-request-errors)" * "[Troubleshooting OAuth App access token request errors](/apps/managing-oauth-apps/troubleshooting-oauth-app-access-token-request-errors)" diff --git a/translations/de-DE/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md b/translations/de-DE/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md index 6e4e542d6044..195da4b29284 100644 --- a/translations/de-DE/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md +++ b/translations/de-DE/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md @@ -8,9 +8,6 @@ versions: enterprise-server: '*' --- - - - By default, a new OAuth App will have an automatically generated [identicon](https://github.com/blog/1586-identicons). An identicon badge looks something like this: ![Identicon](/assets/images/identicon.png) @@ -31,7 +28,7 @@ To create a custom badge: {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.oauth_apps %} {% data reusables.user-settings.modify_oauth_app %} -5. In "Application logo", drag-and-drop an image from a local folder or click **Upload new logo** to select an image from your computer. ![Upload a logo](/assets/images/oauth-apps/oauth_apps_upload_logo.png) +1. In "Application logo", drag-and-drop an image from a local folder or click **Upload new logo** to select an image from your computer. ![Upload a logo](/assets/images/oauth-apps/oauth_apps_upload_logo.png) 6. Schneiden Sie das Bild zu. When you're done, click **Set new application logo**. ![Crop and set logo](/assets/images/oauth-apps/oauth_apps_crop_and_set_logo.png) 7. In "Badge background color", type the [hexadecimal color code](http://www.color-hex.com/) of the background color for your badge. {% if currentVersion == "free-pro-team@latest" %}**Note:** The "Badge background color" input field will be visible after an application logo has been uploaded.{% endif %} diff --git a/translations/de-DE/content/developers/apps/creating-a-github-app-from-a-manifest.md b/translations/de-DE/content/developers/apps/creating-a-github-app-from-a-manifest.md index 72b1df24c00a..a9eea1a0df1c 100644 --- a/translations/de-DE/content/developers/apps/creating-a-github-app-from-a-manifest.md +++ b/translations/de-DE/content/developers/apps/creating-a-github-app-from-a-manifest.md @@ -71,9 +71,9 @@ The `hook_attributes` object has the following key: ##### Parameters - | Name | Typ | Beschreibung | - | ------- | -------- | ------------------------------------------------ | - | `state` | `string` | {% data reusables.apps.state_description %} | + | Name | Typ | Beschreibung | + | ------- | -------- | ------------------------------------------- | + | `state` | `string` | {% data reusables.apps.state_description %} ##### Beispiele diff --git a/translations/de-DE/content/developers/apps/creating-a-github-app-using-url-parameters.md b/translations/de-DE/content/developers/apps/creating-a-github-app-using-url-parameters.md index 6edcb580fce1..d718d3f89bdd 100644 --- a/translations/de-DE/content/developers/apps/creating-a-github-app-using-url-parameters.md +++ b/translations/de-DE/content/developers/apps/creating-a-github-app-using-url-parameters.md @@ -27,93 +27,93 @@ The complete list of available query parameters, permissions, and events is list ### {% data variables.product.prodname_github_app %} configuration parameters - | Name | Typ | Beschreibung | - | -------------------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - | `name` | `string` | The name of the {% data variables.product.prodname_github_app %}. Give your app a clear and succinct name. Your app cannot have the same name as an existing GitHub user, unless it is your own user or organization name. A slugged version of your app's name will be shown in the user interface when your integration takes an action. | - | `Beschreibung` | `string` | A description of the {% data variables.product.prodname_github_app %}. | - | `url` | `string` | The full URL of your {% data variables.product.prodname_github_app %}'s website homepage. | - | `callback_url` | `string` | The full URL to redirect to after someone authorizes an installation. This URL is used if your app needs to identify and authorize user-to-server requests. | - | `request_oauth_on_install` | `boolean` | If your app authorizes users using the OAuth flow, you can set this option to `true` to allow people to authorize the app when they install it, saving a step. If you select this option, the `setup_url` becomes unavailable and users will be redirected to your `callback_url` after installing the app. | - | `setup_url` | `string` | The full URL to redirect to after someone installs the {% data variables.product.prodname_github_app %} if the app requires additional setup after installation. | - | `setup_on_update` | `boolean` | Set to `true` to redirect people to the setup URL when installations have been updated, for example, after repositories are added or removed. | - | `public` | `boolean` | Set to `true` when your {% data variables.product.prodname_github_app %} is available to the public or `false` when it is only accessible to the owner of the app. | - | `webhook_url` | `string` | The full URL that you would like to send webhook event payloads to. | - | `webhook_secret` | `string` | You can specify a secret to secure your webhooks. See "[Securing your webhooks](/webhooks/securing/)" for more details. | - | `ereignisse` | `array of strings` | Webhook-Ereignisse. Some webhook events require `read` or `write` permissions for a resource before you can select the event when registering a new {% data variables.product.prodname_github_app %}. See the "[{% data variables.product.prodname_github_app %} webhook events](#github-app-webhook-events)" section for available events and their required permissions. You can select multiple events in a query string. For example, `events[]=public&events[]=label`. | - | `Domäne` | `string` | The URL of a content reference. | - | `single_file_name` | `string` | When you grant `read` or `write` access to the `single_file` permission, this field provides the path to the single file your {% data variables.product.prodname_github_app %} will manage. | + Name | Type | Description +-----|------|------------- +`name` | `string` | The name of the {% data variables.product.prodname_github_app %}. Give your app a clear and succinct name. Your app cannot have the same name as an existing GitHub user, unless it is your own user or organization name. A slugged version of your app's name will be shown in the user interface when your integration takes an action. +`description` | `string` | A description of the {% data variables.product.prodname_github_app %}. +`url` | `string` | The full URL of your {% data variables.product.prodname_github_app %}'s website homepage. +`callback_url` | `string` | The full URL to redirect to after someone authorizes an installation. This URL is used if your app needs to identify and authorize user-to-server requests. +`request_oauth_on_install` | `boolean` | If your app authorizes users using the OAuth flow, you can set this option to `true` to allow people to authorize the app when they install it, saving a step. If you select this option, the `setup_url` becomes unavailable and users will be redirected to your `callback_url` after installing the app. +`setup_url` | `string` | The full URL to redirect to after someone installs the {% data variables.product.prodname_github_app %} if the app requires additional setup after installation. +`setup_on_update` | `boolean` | Set to `true` to redirect people to the setup URL when installations have been updated, for example, after repositories are added or removed. +`public` | `boolean` | Set to `true` when your {% data variables.product.prodname_github_app %} is available to the public or `false` when it is only accessible to the owner of the app. +`webhook_url` | `string` | The full URL that you would like to send webhook event payloads to. +`webhook_secret` | `string` | You can specify a secret to secure your webhooks. See "[Securing your webhooks](/webhooks/securing/)" for more details. +`events` | `array of strings` | Webhook events. Some webhook events require `read` or `write` permissions for a resource before you can select the event when registering a new {% data variables.product.prodname_github_app %}. See the "[{% data variables.product.prodname_github_app %} webhook events](#github-app-webhook-events)" section for available events and their required permissions. You can select multiple events in a query string. For example, `events[]=public&events[]=label`. +`domain` | `string` | The URL of a content reference. +`single_file_name` | `string` | When you grant `read` or `write` access to the `single_file` permission, this field provides the path to the single file your {% data variables.product.prodname_github_app %} will manage. ### {% data variables.product.prodname_github_app %} permissions You can select permissions in a query string using the permission name in the following table as the query parameter name and the permission type as the query value. For example, to select `Read & write` permissions in the user interface for `contents`, your query string would include `&contents=write`. To select `Read-only` permissions in the user interface for `blocking`, your query string would include `&blocking=read`. To select `no-access` in the user interface for `checks`, your query string would not include the `checks` permission. -| Berechtigung | Beschreibung | -| -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`administration`](/rest/reference/permissions-required-for-github-apps/#permission-on-administration) | Grants access to various endpoints for organization and repository administration. Can be one of: `none`, `read`, or `write`.{% if currentVersion == "free-pro-team@latest" %} -| [`blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-blocking) | Grants access to the [Blocking Users API](/v3/users/blocking/). Can be one of: `none`, `read`, or `write`.{% endif %} -| [`checks (Prüfungen)`](/rest/reference/permissions-required-for-github-apps/#permission-on-checks) | Grants access to the [Checks API](/v3/checks/). Can be one of: `none`, `read`, or `write`. | -| `content_references` | Grants access to the "[Create a content attachment](/v3/apps/installations/#create-a-content-attachment)" endpoint. Can be one of: `none`, `read`, or `write`. | -| [`contents (Inhalte)`](/rest/reference/permissions-required-for-github-apps/#permission-on-contents) | Grants access to various endpoints that allow you to modify repository contents. Can be one of: `none`, `read`, or `write`. | -| [`deployments`](/rest/reference/permissions-required-for-github-apps/#permission-on-deployments) | Grants access to the [Deployments API](/v3/repos/deployments/). Can be one of: `none`, `read`, or `write`. | -| [`emails`](/rest/reference/permissions-required-for-github-apps/#permission-on-emails) | Grants access to the [Emails API](/v3/users/emails/). Can be one of: `none`, `read`, or `write`. | -| [`follower`](/rest/reference/permissions-required-for-github-apps/#permission-on-followers) | Grants access to the [Followers API](/v3/users/followers/). Can be one of: `none`, `read`, or `write`. | -| [`gpg_keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-gpg-keys) | Grants access to the [GPG Keys API](/v3/users/gpg_keys/). Can be one of: `none`, `read`, or `write`. | -| [`Issues (Lieferungen)`](/rest/reference/permissions-required-for-github-apps/#permission-on-issues) | Grants access to the [Issues API](/v3/issues/). Can be one of: `none`, `read`, or `write`. | -| [`keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-keys) | Grants access to the [Public Keys API](/v3/users/keys/). Can be one of: `none`, `read`, or `write`. | -| [`members`](/rest/reference/permissions-required-for-github-apps/#permission-on-members) | Grants access to manage an organization's members. Can be one of: `none`, `read`, or `write`.{% if currentVersion == "free-pro-team@latest" %} -| [`Metadaten`](/rest/reference/permissions-required-for-github-apps/#metadata-permissions) | Grants access to read-only endpoints that do not leak sensitive data. Can be `read` or `none`. Defaults to `read` when you set any permission, or defaults to `none` when you don't specify any permissions for the {% data variables.product.prodname_github_app %}. | -| [`organization_administration`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-administration) | Grants access to "[Update an organization](/v3/orgs/#update-an-organization)" endpoint and the [Organization Interaction Restrictions API](/v3/interactions/orgs/#set-interaction-restrictions-for-an-organization). Can be one of: `none`, `read`, or `write`.{% endif %} -| [`organization_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-hooks) | Grants access to the [Organization Webhooks API](/v3/orgs/hooks/). Can be one of: `none`, `read`, or `write`. | -| `organization_plan` | Grants access to get information about an organization's plan using the "[Get an organization](/v3/orgs/#get-an-organization)" endpoint. Can be one of: `none` or `read`. | -| [`organization_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects) | Grants access to the [Projects API](/v3/projects/). Can be one of: `none`, `read`, `write`, or `admin`.{% if currentVersion == "free-pro-team@latest" %} -| [`organization_user_blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects) | Grants access to the [Blocking Organization Users API](/v3/orgs/blocking/). Can be one of: `none`, `read`, or `write`.{% endif %} -| [`Seiten`](/rest/reference/permissions-required-for-github-apps/#permission-on-pages) | Grants access to the [Pages API](/v3/repos/pages/). Can be one of: `none`, `read`, or `write`. | -| `plan` | Grants access to get information about a user's GitHub plan using the "[Get a user](/v3/users/#get-a-user)" endpoint. Can be one of: `none` or `read`. | -| [`pull_requests`](/rest/reference/permissions-required-for-github-apps/#permission-on-pull-requests) | Grants access to various pull request endpoints. Can be one of: `none`, `read`, or `write`. | -| [`repository_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-hooks) | Grants access to the [Repository Webhooks API](/v3/repos/hooks/). Can be one of: `none`, `read`, or `write`. | -| [`repository_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-projects) | Grants access to the [Projects API](/v3/projects/). Can be one of: `none`, `read`, `write`, or `admin`. | -| [`single_file`](/rest/reference/permissions-required-for-github-apps/#permission-on-single-file) | Grants access to the [Contents API](/v3/repos/contents/). Can be one of: `none`, `read`, or `write`. | -| [`starring`](/rest/reference/permissions-required-for-github-apps/#permission-on-starring) | Grants access to the [Starring API](/v3/activity/starring/). Can be one of: `none`, `read`, or `write`. | -| [`statuses (Statusangaben)`](/rest/reference/permissions-required-for-github-apps/#permission-on-statuses) | Grants access to the [Statuses API](/v3/repos/statuses/). Can be one of: `none`, `read`, or `write`. | -| [`team_discussions`](/rest/reference/permissions-required-for-github-apps/#permission-on-team-discussions) | Grants access to the [Team Discussions API](/v3/teams/discussions/) and the [Team Discussion Comments API](/v3/teams/discussion_comments/). Can be one of: `none`, `read`, or `write`. | -| `vulnerability_alerts` | Grants access to receive security alerts for vulnerable dependencies in a repository. See "[About security alerts for vulnerable dependencies](/articles/about-security-alerts-for-vulnerable-dependencies)" to learn more. Can be one of: `none` or `read`. | -| `beobachten` | Grants access to list and change repositories a user is subscribed to. Can be one of: `none`, `read`, or `write`. | +Permission | Description +---------- | ----------- +[`administration`](/rest/reference/permissions-required-for-github-apps/#permission-on-administration) | Grants access to various endpoints for organization and repository administration. Can be one of: `none`, `read`, or `write`.{% if currentVersion == "free-pro-team@latest" %} +[`blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-blocking) | Grants access to the [Blocking Users API](/v3/users/blocking/). Can be one of: `none`, `read`, or `write`.{% endif %} +[`checks`](/rest/reference/permissions-required-for-github-apps/#permission-on-checks) | Grants access to the [Checks API](/v3/checks/). Can be one of: `none`, `read`, or `write`. +`content_references` | Grants access to the "[Create a content attachment](/v3/apps/installations/#create-a-content-attachment)" endpoint. Can be one of: `none`, `read`, or `write`. +[`contents`](/rest/reference/permissions-required-for-github-apps/#permission-on-contents) | Grants access to various endpoints that allow you to modify repository contents. Can be one of: `none`, `read`, or `write`. +[`deployments`](/rest/reference/permissions-required-for-github-apps/#permission-on-deployments) | Grants access to the [Deployments API](/rest/reference/repos#deployments). Can be one of: `none`, `read`, or `write`. +[`emails`](/rest/reference/permissions-required-for-github-apps/#permission-on-emails) | Grants access to the [Emails API](/v3/users/emails/). Can be one of: `none`, `read`, or `write`. +[`followers`](/rest/reference/permissions-required-for-github-apps/#permission-on-followers) | Grants access to the [Followers API](/v3/users/followers/). Can be one of: `none`, `read`, or `write`. +[`gpg_keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-gpg-keys) | Grants access to the [GPG Keys API](/v3/users/gpg_keys/). Can be one of: `none`, `read`, or `write`. +[`issues`](/rest/reference/permissions-required-for-github-apps/#permission-on-issues) | Grants access to the [Issues API](/v3/issues/). Can be one of: `none`, `read`, or `write`. +[`keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-keys) | Grants access to the [Public Keys API](/v3/users/keys/). Can be one of: `none`, `read`, or `write`. +[`members`](/rest/reference/permissions-required-for-github-apps/#permission-on-members) | Grants access to manage an organization's members. Can be one of: `none`, `read`, or `write`.{% if currentVersion == "free-pro-team@latest" %} +[`metadata`](/rest/reference/permissions-required-for-github-apps/#metadata-permissions) | Grants access to read-only endpoints that do not leak sensitive data. Can be `read` or `none`. Defaults to `read` when you set any permission, or defaults to `none` when you don't specify any permissions for the {% data variables.product.prodname_github_app %}. +[`organization_administration`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-administration) | Grants access to "[Update an organization](/v3/orgs/#update-an-organization)" endpoint and the [Organization Interaction Restrictions API](/v3/interactions/orgs/#set-interaction-restrictions-for-an-organization). Can be one of: `none`, `read`, or `write`.{% endif %} +[`organization_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-hooks) | Grants access to the [Organization Webhooks API](/rest/reference/orgs#webhooks/). Can be one of: `none`, `read`, or `write`. +`organization_plan` | Grants access to get information about an organization's plan using the "[Get an organization](/v3/orgs/#get-an-organization)" endpoint. Can be one of: `none` or `read`. +[`organization_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects) | Grants access to the [Projects API](/v3/projects/). Can be one of: `none`, `read`, `write`, or `admin`.{% if currentVersion == "free-pro-team@latest" %} +[`organization_user_blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects) | Grants access to the [Blocking Organization Users API](/v3/orgs/blocking/). Can be one of: `none`, `read`, or `write`.{% endif %} +[`pages`](/rest/reference/permissions-required-for-github-apps/#permission-on-pages) | Grants access to the [Pages API](/rest/reference/repos#pages). Can be one of: `none`, `read`, or `write`. +`plan` | Grants access to get information about a user's GitHub plan using the "[Get a user](/v3/users/#get-a-user)" endpoint. Can be one of: `none` or `read`. +[`pull_requests`](/rest/reference/permissions-required-for-github-apps/#permission-on-pull-requests) | Grants access to various pull request endpoints. Can be one of: `none`, `read`, or `write`. +[`repository_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-hooks) | Grants access to the [Repository Webhooks API](/v3/repos/hooks/). Can be one of: `none`, `read`, or `write`. +[`repository_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-projects) | Grants access to the [Projects API](/v3/projects/). Can be one of: `none`, `read`, `write`, or `admin`. +[`single_file`](/rest/reference/permissions-required-for-github-apps/#permission-on-single-file) | Grants access to the [Contents API](/v3/repos/contents/). Can be one of: `none`, `read`, or `write`. +[`starring`](/rest/reference/permissions-required-for-github-apps/#permission-on-starring) | Grants access to the [Starring API](/v3/activity/starring/). Can be one of: `none`, `read`, or `write`. +[`statuses`](/rest/reference/permissions-required-for-github-apps/#permission-on-statuses) | Grants access to the [Statuses API](/v3/repos/statuses/). Can be one of: `none`, `read`, or `write`. +[`team_discussions`](/rest/reference/permissions-required-for-github-apps/#permission-on-team-discussions) | Grants access to the [Team Discussions API](/v3/teams/discussions/) and the [Team Discussion Comments API](/v3/teams/discussion_comments/). Can be one of: `none`, `read`, or `write`. +`vulnerability_alerts`| Grants access to receive security alerts for vulnerable dependencies in a repository. See "[About security alerts for vulnerable dependencies](/articles/about-security-alerts-for-vulnerable-dependencies)" to learn more. Can be one of: `none` or `read`. +`watching` | Grants access to list and change repositories a user is subscribed to. Can be one of: `none`, `read`, or `write`. ### {% data variables.product.prodname_github_app %} webhook events -| Name von Webhook-Ereignis | Required permission | Beschreibung | -| -------------------------------------------------------------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------ | -| [`check_run`](/webhooks/event-payloads/#check_run) | `checks (Prüfungen)` | {% data reusables.webhooks.check_run_short_desc %} | -| [`check_suite`](/webhooks/event-payloads/#check_suite) | `checks (Prüfungen)` | {% data reusables.webhooks.check_suite_short_desc %} | -| [`commit_comment`](/webhooks/event-payloads/#commit_comment) | `contents (Inhalte)` | {% data reusables.webhooks.commit_comment_short_desc %} | -| [`content_reference`](/webhooks/event-payloads/#content_reference) | `content_references` | {% data reusables.webhooks.content_reference_short_desc %} | -| [`create`](/webhooks/event-payloads/#create) | `contents (Inhalte)` | {% data reusables.webhooks.create_short_desc %} | -| [`delete`](/webhooks/event-payloads/#delete) | `contents (Inhalte)` | {% data reusables.webhooks.delete_short_desc %} | -| [`deployment`](/webhooks/event-payloads/#deployment) | `deployments` | {% data reusables.webhooks.deployment_short_desc %} | -| [`deployment_status`](/webhooks/event-payloads/#deployment_status) | `deployments` | {% data reusables.webhooks.deployment_status_short_desc %} | -| [`Fork`](/webhooks/event-payloads/#fork) | `contents (Inhalte)` | {% data reusables.webhooks.fork_short_desc %} | -| [`gollum`](/webhooks/event-payloads/#gollum) | `contents (Inhalte)` | {% data reusables.webhooks.gollum_short_desc %} | -| [`Issues (Lieferungen)`](/webhooks/event-payloads/#issues) | `Issues (Lieferungen)` | {% data reusables.webhooks.issues_short_desc %} | -| [`issue_comment`](/webhooks/event-payloads/#issue_comment) | `Issues (Lieferungen)` | {% data reusables.webhooks.issue_comment_short_desc %} | -| [`Kennzeichnung`](/webhooks/event-payloads/#label) | `Metadaten` | {% data reusables.webhooks.label_short_desc %} | -| [`Mitglied`](/webhooks/event-payloads/#member) | `members` | {% data reusables.webhooks.member_short_desc %} | -| [`membership`](/webhooks/event-payloads/#membership) | `members` | {% data reusables.webhooks.membership_short_desc %} | -| [`Meilensteine`](/webhooks/event-payloads/#milestone) | `pull_request` | {% data reusables.webhooks.milestone_short_desc %}{% if currentVersion == "free-pro-team@latest" %} -| [`org_block`](/webhooks/event-payloads/#org_block) | `organization_administration` | {% data reusables.webhooks.org_block_short_desc %}{% endif %} -| [`Organisation`](/webhooks/event-payloads/#organization) | `members` | {% data reusables.webhooks.organization_short_desc %} | -| [`page_build`](/webhooks/event-payloads/#page_build) | `Seiten` | {% data reusables.webhooks.page_build_short_desc %} | -| [`project (Projekt)`](/webhooks/event-payloads/#project) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_short_desc %} | -| [`project_card`](/webhooks/event-payloads/#project_card) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_card_short_desc %} | -| [`project_column`](/webhooks/event-payloads/#project_column) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_column_short_desc %} | -| [`public`](/webhooks/event-payloads/#public) | `Metadaten` | {% data reusables.webhooks.public_short_desc %} | -| [`pull_request`](/webhooks/event-payloads/#pull_request) | `pull_requests` | {% data reusables.webhooks.pull_request_short_desc %} | -| [`pull_request_review`](/webhooks/event-payloads/#pull_request_review) | `pull_request` | {% data reusables.webhooks.pull_request_review_short_desc %} | -| [`pull_request_review_comment`](/webhooks/event-payloads/#pull_request_review_comment) | `pull_request` | {% data reusables.webhooks.pull_request_review_comment_short_desc %} | -| [`Push`](/webhooks/event-payloads/#push) | `contents (Inhalte)` | {% data reusables.webhooks.push_short_desc %} | -| [`Release`](/webhooks/event-payloads/#release) | `contents (Inhalte)` | {% data reusables.webhooks.release_short_desc %} | -| [`Repository`](/webhooks/event-payloads/#repository) | `Metadaten` | {% data reusables.webhooks.repository_short_desc %}{% if currentVersion == "free-pro-team@latest"%} -| [`repository_dispatch`](/webhooks/event-payloads/#repository_dispatch) | `contents (Inhalte)` | Allows integrators using GitHub Actions to trigger custom events.{% endif %} -| [`Status`](/webhooks/event-payloads/#status) | `statuses (Statusangaben)` | {% data reusables.webhooks.status_short_desc %} | -| [`Team`](/webhooks/event-payloads/#team) | `members` | {% data reusables.webhooks.team_short_desc %} | -| [`team_add`](/webhooks/event-payloads/#team_add) | `members` | {% data reusables.webhooks.team_add_short_desc %} | -| [`beobachten`](/webhooks/event-payloads/#watch) | `Metadaten` | {% data reusables.webhooks.watch_short_desc %} | +Webhook event name | Required permission | Description +------------------ | ------------------- | ----------- +[`check_run`](/webhooks/event-payloads/#check_run) |`checks` | {% data reusables.webhooks.check_run_short_desc %} +[`check_suite`](/webhooks/event-payloads/#check_suite) |`checks` | {% data reusables.webhooks.check_suite_short_desc %} +[`commit_comment`](/webhooks/event-payloads/#commit_comment) | `contents` | {% data reusables.webhooks.commit_comment_short_desc %} +[`content_reference`](/webhooks/event-payloads/#content_reference) |`content_references` | {% data reusables.webhooks.content_reference_short_desc %} +[`create`](/webhooks/event-payloads/#create) | `contents` | {% data reusables.webhooks.create_short_desc %} +[`delete`](/webhooks/event-payloads/#delete) | `contents` | {% data reusables.webhooks.delete_short_desc %} +[`deployment`](/webhooks/event-payloads/#deployment) | `deployments` | {% data reusables.webhooks.deployment_short_desc %} +[`deployment_status`](/webhooks/event-payloads/#deployment_status) | `deployments` | {% data reusables.webhooks.deployment_status_short_desc %} +[`fork`](/webhooks/event-payloads/#fork) | `contents` | {% data reusables.webhooks.fork_short_desc %} +[`gollum`](/webhooks/event-payloads/#gollum) | `contents` | {% data reusables.webhooks.gollum_short_desc %} +[`issues`](/webhooks/event-payloads/#issues) | `issues` | {% data reusables.webhooks.issues_short_desc %} +[`issue_comment`](/webhooks/event-payloads/#issue_comment) | `issues` | {% data reusables.webhooks.issue_comment_short_desc %} +[`label`](/webhooks/event-payloads/#label) | `metadata` | {% data reusables.webhooks.label_short_desc %} +[`member`](/webhooks/event-payloads/#member) | `members` | {% data reusables.webhooks.member_short_desc %} +[`membership`](/webhooks/event-payloads/#membership) | `members` | {% data reusables.webhooks.membership_short_desc %} +[`milestone`](/webhooks/event-payloads/#milestone) | `pull_request` | {% data reusables.webhooks.milestone_short_desc %}{% if currentVersion == "free-pro-team@latest" %} +[`org_block`](/webhooks/event-payloads/#org_block) | `organization_administration` | {% data reusables.webhooks.org_block_short_desc %}{% endif %} +[`organization`](/webhooks/event-payloads/#organization) | `members` | {% data reusables.webhooks.organization_short_desc %} +[`page_build`](/webhooks/event-payloads/#page_build) | `pages` | {% data reusables.webhooks.page_build_short_desc %} +[`project`](/webhooks/event-payloads/#project) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_short_desc %} +[`project_card`](/webhooks/event-payloads/#project_card) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_card_short_desc %} +[`project_column`](/webhooks/event-payloads/#project_column) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_column_short_desc %} +[`public`](/webhooks/event-payloads/#public) | `metadata` | {% data reusables.webhooks.public_short_desc %} +[`pull_request`](/webhooks/event-payloads/#pull_request) | `pull_requests` | {% data reusables.webhooks.pull_request_short_desc %} +[`pull_request_review`](/webhooks/event-payloads/#pull_request_review) | `pull_request` | {% data reusables.webhooks.pull_request_review_short_desc %} +[`pull_request_review_comment`](/webhooks/event-payloads/#pull_request_review_comment) | `pull_request` | {% data reusables.webhooks.pull_request_review_comment_short_desc %} +[`push`](/webhooks/event-payloads/#push) | `contents` | {% data reusables.webhooks.push_short_desc %} +[`release`](/webhooks/event-payloads/#release) | `contents` | {% data reusables.webhooks.release_short_desc %} +[`repository`](/webhooks/event-payloads/#repository) |`metadata` | {% data reusables.webhooks.repository_short_desc %}{% if currentVersion == "free-pro-team@latest"%} +[`repository_dispatch`](/webhooks/event-payloads/#repository_dispatch) | `contents` | Allows integrators using GitHub Actions to trigger custom events.{% endif %} +[`status`](/webhooks/event-payloads/#status) | `statuses` | {% data reusables.webhooks.status_short_desc %} +[`team`](/webhooks/event-payloads/#team) | `members` | {% data reusables.webhooks.team_short_desc %} +[`team_add`](/webhooks/event-payloads/#team_add) | `members` | {% data reusables.webhooks.team_add_short_desc %} +[`watch`](/webhooks/event-payloads/#watch) | `metadata` | {% data reusables.webhooks.watch_short_desc %} diff --git a/translations/de-DE/content/developers/apps/creating-ci-tests-with-the-checks-api.md b/translations/de-DE/content/developers/apps/creating-ci-tests-with-the-checks-api.md index 5665765e567f..718e1483a9bd 100644 --- a/translations/de-DE/content/developers/apps/creating-ci-tests-with-the-checks-api.md +++ b/translations/de-DE/content/developers/apps/creating-ci-tests-with-the-checks-api.md @@ -9,7 +9,6 @@ versions: --- - ### Einführung This guide will introduce you to [Github Apps](/apps/) and the [Checks API](/v3/checks/), which you'll use to build a continuous integration (CI) server that runs tests. @@ -134,6 +133,26 @@ The `requested` action requests a check run each time code is pushed to the repo You'll add this new method as a [Sinatra helper](https://github.com/sinatra/sinatra#helpers) in case you want other routes to use it too. Under `helpers do`, add this `create_check_run` method: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +``` ruby +# Create a new check run with the status queued +def create_check_run + # # At the time of writing, Octokit does not support the Checks API yet, but + # it does provide generic HTTP methods you can use: + # /v3/checks/runs/#create-a-check-run + check_run = @installation_client.post( + "repos/#{@payload['repository']['full_name']}/check-runs", + { + accept: 'application/vnd.github.v3+json', + # The name of your check run. + name: 'Octo RuboCop', + # The payload structure differs depending on whether a check run or a check suite event occurred. + head_sha: @payload['check_run'].nil? ? @payload['check_suite']['head_sha'] : @payload['check_run']['head_sha'] + } + ) +end +``` +{% else %} ``` ruby # Create a new check run with the status queued def create_check_run @@ -153,6 +172,7 @@ def create_check_run ) end ``` +{% endif %} This code calls the "[Create a check run](/v3/checks/runs/#create-a-check-run)" endpoint using the generic [HTTP `POST` method](http://octokit.github.io/octokit.rb/Octokit/Connection.html#post-instance_method). This method takes two parameters: the URL of the endpoint and the input parameters to the method. @@ -180,7 +200,7 @@ If you see other apps in the Checks tab, it means you have other apps installed Great! You've told GitHub to create a check run. You can see the check run status is set to `queued` next to a yellow icon. Next, you'll want to wait for GitHub to create the check run and update its status. -### Step 1.4. Updating a check run +### Schritt 1.4. Updating a check run When your `create_check_run` method runs, it asks GitHub to create a new check run. When Github finishes creating the check run, you'll receive the `check_run` webhook event with the `created` action. That event is your signal to begin running the check. @@ -209,6 +229,43 @@ In this section, you're not going to kick off the CI test yet, but you'll walk t Let's create the `initiate_check_run` method and update the status of the check run. Add the following code to the helpers section: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +``` ruby +# Start the CI process +def initiate_check_run + # Once the check run is created, you'll update the status of the check run + # to 'in_progress' and run the CI process. When the CI finishes, you'll + # update the check run status to 'completed' and add the CI results. + + # Octokit doesn't yet support the Checks API, but it does provide generic + # HTTP methods you can use: + # /v3/checks/runs/#update-a-check-run + updated_check_run = @installation_client.patch( + "repos/#{@payload['repository']['full_name']}/check-runs/#{@payload['check_run']['id']}", + { + accept: 'application/vnd.github.v3+json', + name: 'Octo RuboCop', + status: 'in_progress', + started_at: Time.now.utc.iso8601 + } + ) + + # ***** RUN A CI TEST ***** + + # Mark the check run as complete! + updated_check_run = @installation_client.patch( + "repos/#{@payload['repository']['full_name']}/check-runs/#{@payload['check_run']['id']}", + { + accept: 'application/vnd.github.v3+json', + name: 'Octo RuboCop', + status: 'completed', + conclusion: 'success', + completed_at: Time.now.utc.iso8601 + } + ) +end +``` +{% else %} ``` ruby # Start the CI process def initiate_check_run @@ -245,6 +302,7 @@ def initiate_check_run ) end ``` +{% endif %} The code above calls the "[Update a check run](/v3/checks/runs/#update-a-check-run)" API endpoint using the generic [`patch` HTTP method](http://octokit.github.io/octokit.rb/Octokit/Connection.html#patch-instance_method) to update the check run that you already created. @@ -549,6 +607,21 @@ text = "Octo RuboCop version: #{@output['metadata']['rubocop_version']}" Now you've got all the information you need to update your check run. In the [first half of this quickstart](#step-14-updating-a-check-run), you added this code to set the status of the check run to `success`: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +``` ruby +# Mark the check run as complete! +updated_check_run = @installation_client.patch( + "repos/#{@payload['repository']['full_name']}/check-runs/#{@payload['check_run']['id']}", + { + accept: 'application/vnd.github.v3+json', + name: 'Octo RuboCop', + status: 'completed', + conclusion: 'success', + completed_at: Time.now.utc.iso8601 + } +) +``` +{% else %} ``` ruby # Mark the check run as complete! updated_check_run = @installation_client.patch( @@ -562,9 +635,36 @@ updated_check_run = @installation_client.patch( } ) ``` +{% endif %} You'll need to update that code to use the `conclusion` variable you set based on the RuboCop results (to `success` or `neutral`). You can update the code with the following: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +``` ruby +# Mark the check run as complete! And if there are warnings, share them. +updated_check_run = @installation_client.patch( + "repos/#{@payload['repository']['full_name']}/check-runs/#{@payload['check_run']['id']}", + { + accept: 'application/vnd.github.v3+json', + name: 'Octo RuboCop', + status: 'completed', + conclusion: conclusion, + completed_at: Time.now.utc.iso8601, + output: { + title: 'Octo RuboCop', + summary: summary, + text: text, + annotations: annotations + }, + actions: [{ + label: 'Fix this', + description: 'Automatically fix all linter notices.', + identifier: 'fix_rubocop_notices' + }] + } +) +``` +{% else %} ``` ruby # Mark the check run as complete! And if there are warnings, share them. updated_check_run = @installation_client.patch( @@ -589,6 +689,7 @@ updated_check_run = @installation_client.patch( } ) ``` +{% endif %} Now that you're setting a conclusion based on the status of the CI test and you've added the output from the RuboCop results, you've created a CI test! Congratulations. 🙌 diff --git a/translations/de-DE/content/developers/apps/differences-between-github-apps-and-oauth-apps.md b/translations/de-DE/content/developers/apps/differences-between-github-apps-and-oauth-apps.md index ee79fcf86465..24cd9906ab1f 100644 --- a/translations/de-DE/content/developers/apps/differences-between-github-apps-and-oauth-apps.md +++ b/translations/de-DE/content/developers/apps/differences-between-github-apps-and-oauth-apps.md @@ -50,13 +50,13 @@ An _authorized_ OAuth App has access to all of the user's or organization owner' {% endnote %} -| GitHub Apps | OAuth Apps | -| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| A GitHub App can request an installation access token by using a private key with a JSON web token format out-of-band. | An OAuth app can exchange a request token for an access token after a redirect via a web request. | -| An installation token identifies the app as the GitHub Apps bot, such as @jenkins-bot. | An access token identifies the app as the user who granted the token to the app, such as @octocat. | -| Installation tokens expire after a predefined amount of time (currently 1 hour). | OAuth tokens remain active until they're revoked by the customer. | -| {% data reusables.apps.api-rate-limits-non-ghec %}{% if currentVersion == "free-pro-team@latest" %} Higher rate limits apply for {% data variables.product.prodname_ghe_cloud %}. For more information, see "[Rate limits for GitHub Apps](/developers/apps/rate-limits-for-github-apps)."{% endif %} | OAuth tokens use the user's rate limit of 5,000 requests per hour. | -| Rate limit increases can be granted both at the GitHub Apps level (affecting all installations) and at the individual installation level. | Rate limit increases are granted per OAuth App. Every token granted to that OAuth App gets the increased limit. |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} +| GitHub Apps | OAuth Apps | +| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| A GitHub App can request an installation access token by using a private key with a JSON web token format out-of-band. | An OAuth app can exchange a request token for an access token after a redirect via a web request. | +| An installation token identifies the app as the GitHub Apps bot, such as @jenkins-bot. | An access token identifies the app as the user who granted the token to the app, such as @octocat. | +| Installation tokens expire after a predefined amount of time (currently 1 hour). | OAuth tokens remain active until they're revoked by the customer. | +| {% data reusables.apps.api-rate-limits-non-ghec %}{% if currentVersion == "free-pro-team@latest" %} Higher rate limits apply for {% data variables.product.prodname_ghe_cloud %}. For more information, see "[Rate limits for GitHub Apps](/developers/apps/rate-limits-for-github-apps)."{% endif %} | OAuth tokens use the user's rate limit of 5,000 requests per hour. | +| Rate limit increases can be granted both at the GitHub Apps level (affecting all installations) and at the individual installation level. | Rate limit increases are granted per OAuth App. Every token granted to that OAuth App gets the increased limit. |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} | {% data variables.product.prodname_github_app %}s can authenticate on behalf of the user, which is called user-to-server requests. The flow to authorize is the same as the OAuth App authorization flow. User-to-server tokens can expire and be renewed with a refresh token. For more information, see "[Refreshing user-to-server access tokens](/apps/building-github-apps/refreshing-user-to-server-access-tokens/)" and "[Identifying and authorizing users for GitHub Apps](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/)." | The OAuth flow used by {% data variables.product.prodname_oauth_app %}s authorizes an {% data variables.product.prodname_oauth_app %} on behalf of the user. This is the same flow used in {% data variables.product.prodname_github_app %} user-to-server authorization. |{% endif %} ### Requesting permission levels for resources @@ -102,5 +102,5 @@ Bot accounts are specific to GitHub Apps and are built into every GitHub App. | GitHub Apps | OAuth Apps | | --------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | -| GitHub App bots do not consume a {% data variables.product.prodname_enterprise %} seat. | A machine user account consumes a {% data variables.product.prodname_enterprise %} seat. | +| GitHub App bots do not consume a {% data variables.product.prodname_enterprise %} seat. | A machine user account consumes a {% data variables.product.prodname_enterprise %} seat. | | Because a GitHub App bot is never granted a password, a customer can't sign into it directly. | A machine user account is granted a username and password to be managed and secured by the customer. | diff --git a/translations/de-DE/content/developers/apps/editing-a-github-apps-permissions.md b/translations/de-DE/content/developers/apps/editing-a-github-apps-permissions.md index 81fff7a88b35..db8fe290c376 100644 --- a/translations/de-DE/content/developers/apps/editing-a-github-apps-permissions.md +++ b/translations/de-DE/content/developers/apps/editing-a-github-apps-permissions.md @@ -18,15 +18,9 @@ versions: {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.github_apps %} -4. Select the GitHub App whose permissions you want to change. -![App selection](/assets/images/github-apps/github_apps_select-app.png) -5. In the left sidebar, click **Permissions & webhooks**. -![Permissions and webhooks](/assets/images/github-apps/github_apps_permissions_and_webhooks.png) -6. Modify the permissions you'd like to change. For each type of permission, select either "Read-only", "Read & write", or "No access" from the dropdown. -![Permissions selections for your GitHub App](/assets/images/github-apps/github_apps_permissions_post2dot13.png) -7. In "Subscribe to events", select any events to which you'd like to subscribe your app. -![Permissions selections for subscribing your GitHub App to events](/assets/images/github-apps/github_apps_permissions_subscribe_to_events.png) -8. Optionally, in "Add a note to users", add a note telling your users why you are changing the permissions that your GitHub App requests. -![Input box to add a note to users explaining why your GitHub App permissions have changed](/assets/images/github-apps/github_apps_permissions_note_to_users.png) -9. Click **Save changes**. -![Button to save permissions changes](/assets/images/github-apps/github_apps_save_changes.png) +4. Select the GitHub App whose permissions you want to change. ![App selection](/assets/images/github-apps/github_apps_select-app.png) +5. Klicken Sie auf der linken Seitenleiste auf **Permissions & webhooks** (Berechtigungen und Webhooks). ![Permissions and webhooks](/assets/images/github-apps/github_apps_permissions_and_webhooks.png) +6. Modify the permissions you'd like to change. For each type of permission, select either "Read-only", "Read & write", or "No access" from the dropdown. ![Permissions selections for your GitHub App](/assets/images/github-apps/github_apps_permissions_post2dot13.png) +7. In "Subscribe to events", select any events to which you'd like to subscribe your app. ![Permissions selections for subscribing your GitHub App to events](/assets/images/github-apps/github_apps_permissions_subscribe_to_events.png) +8. Optionally, in "Add a note to users", add a note telling your users why you are changing the permissions that your GitHub App requests. ![Input box to add a note to users explaining why your GitHub App permissions have changed](/assets/images/github-apps/github_apps_permissions_note_to_users.png) +9. Klicke auf **Save changes** (Änderungen speichern). ![Button to save permissions changes](/assets/images/github-apps/github_apps_save_changes.png) diff --git a/translations/de-DE/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md b/translations/de-DE/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md index f5af47f5d3a8..95d7ec2ffca2 100644 --- a/translations/de-DE/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md +++ b/translations/de-DE/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md @@ -43,12 +43,12 @@ When your GitHub App specifies a `login` parameter, it prompts users with a spec ##### Parameters -| Name | Typ | Beschreibung | -| -------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `client_id` | `string` | **Required.** The client ID for your GitHub App. You can find this in your [GitHub App settings](https://github.com/settings/apps) when you select your app. | -| `redirect_uri` | `string` | The URL in your application where users will be sent after authorization. This must be an exact match to the URL you provided in the **User authorization callback URL** field when setting up your GitHub App and can't contain any additional parameters. | -| `state` | `string` | This should contain a random string to protect against forgery attacks and could contain any other arbitrary data. | -| `login` | `string` | Suggests a specific account to use for signing in and authorizing the app. | +Name | Type | Description +-----|------|------------ +`client_id` | `string` | **Required.** The client ID for your GitHub App. You can find this in your [GitHub App settings](https://github.com/settings/apps) when you select your app. +`redirect_uri` | `string` | The URL in your application where users will be sent after authorization. This must be an exact match to the URL you provided in the **User authorization callback URL** field when setting up your GitHub App and can't contain any additional parameters. +`state` | `string` | This should contain a random string to protect against forgery attacks and could contain any other arbitrary data. +`login` | `string` | Suggests a specific account to use for signing in and authorizing the app. {% note %} @@ -74,13 +74,13 @@ Expiring user tokens are currently part of the user-to-server token expiration b ##### Parameters -| Name | Typ | Beschreibung | -| --------------- | -------- | --------------------------------------------------------------------- | -| `client_id` | `string` | **Required.** The client ID for your GitHub App. | -| `client_secret` | `string` | **Required.** The client secret for your GitHub App. | -| `Code` | `string` | **Required.** The code you received as a response to Step 1. | -| `redirect_uri` | `string` | The URL in your application where users are sent after authorization. | -| `state` | `string` | The unguessable random string you provided in Step 1. | +Name | Type | Description +-----|------|------------ +`client_id` | `string` | **Required.** The client ID for your GitHub App. +`client_secret` | `string` | **Required.** The client secret for your GitHub App. +`code` | `string` | **Required.** The code you received as a response to Step 1. +`redirect_uri` | `string` | The URL in your application where users are sent after authorization. +`state` | `string` | The unguessable random string you provided in Step 1. ##### Response @@ -226,7 +226,7 @@ While most of your API interaction should occur using your server-to-server inst * [List check runs in a check suite](/v3/checks/runs/#list-check-runs-in-a-check-suite) * [List check runs for a Git reference](/v3/checks/runs/#list-check-runs-for-a-git-reference) -##### Prüfsuiten +##### Check Suites * [Create a check suite](/v3/checks/suites/#create-a-check-suite) * [Get a check suite](/v3/checks/suites/#get-a-check-suite) @@ -241,25 +241,25 @@ While most of your API interaction should occur using your server-to-server inst ##### Deployment Statuses -* [List deployment statuses](/v3/repos/deployments/#list-deployment-statuses) -* [Create a deployment status](/v3/repos/deployments/#create-a-deployment-status) -* [Get a deployment status](/v3/repos/deployments/#get-a-deployment-status) +* [List deployment statuses](/rest/reference/repos#list-deployment-statuses) +* [Create a deployment status](/rest/reference/repos#create-a-deployment-status) +* [Get a deployment status](/rest/reference/repos#get-a-deployment-status) -##### Bereitstellungen +##### Deployments -* [List deployments](/v3/repos/deployments/#list-deployments) -* [Create a deployment](/v3/repos/deployments/#create-a-deployment) -* [Get a deployment](/v3/repos/deployments/#get-a-deployment){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -* [Delete a deployment](/v3/repos/deployments/#delete-a-deployment){% endif %} +* [List deployments](/rest/reference/repos#list-deployments) +* [Create a deployment](/rest/reference/repos#create-a-deployment) +* [Get a deployment](/rest/reference/repos#get-a-deployment){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +* [Delete a deployment](/rest/reference/repos#delete-a-deployment){% endif %} -##### Ereignisse +##### Events -* [List public events for a network of repositories](/v3/activity/events/#list-public-events-for-a-network-of-repositories) -* [List public organization events](/v3/activity/events/#list-public-organization-events) +* [List public events for a network of repositories](/rest/reference/activity#list-public-events-for-a-network-of-repositories) +* [List public organization events](/rest/reference/activity#list-public-organization-events) ##### Feeds -* [Get feeds](/v3/activity/feeds/#get-feeds) +* [Get feeds](/rest/reference/activity#get-feeds) ##### Git Blobs @@ -273,11 +273,8 @@ While most of your API interaction should occur using your server-to-server inst ##### Git Refs -* [Create a reference](/v3/git/refs/#create-a-reference){% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -* [List references](/v3/git/refs/#list-references) -* [Get a reference](/v3/git/refs/#get-a-reference){% else %} -* [Get a reference](/v3/git/refs/#get-a-reference) -* [List matching references](/v3/git/refs/#list-matching-references){% endif %} +* [Create a reference](/v3/git/refs/#create-a-reference)* [Get a reference](/v3/git/refs/#get-a-reference) +* [List matching references](/v3/git/refs/#list-matching-references) * [Update a reference](/v3/git/refs/#update-a-reference) * [Delete a reference](/v3/git/refs/#delete-a-reference) @@ -339,7 +336,7 @@ While most of your API interaction should occur using your server-to-server inst * [List assignees](/v3/issues/assignees/#list-assignees) * [Check if a user can be assigned](/v3/issues/assignees/#check-if-a-user-can-be-assigned) * [List repository issues](/v3/issues/#list-repository-issues) -* [Hiermit wird ein Issue erstellt.](/v3/issues/#create-an-issue) +* [Create an issue](/v3/issues/#create-an-issue) * [Get an issue](/v3/issues/#get-an-issue) * [Update an issue](/v3/issues/#update-an-issue) * [Lock an issue](/v3/issues/#lock-an-issue) @@ -353,7 +350,7 @@ While most of your API interaction should occur using your server-to-server inst * [List jobs for a workflow run](/v3/actions/workflow-jobs/#list-jobs-for-a-workflow-run) {% endif %} -##### Kennzeichnungen +##### Labels * [List labels for an issue](/v3/issues/labels/#list-labels-for-an-issue) * [Add labels to an issue](/v3/issues/labels/#add-labels-to-an-issue) @@ -381,7 +378,7 @@ While most of your API interaction should occur using your server-to-server inst * [Meta](/v3/meta/#meta) -##### Meilensteine +##### Milestones * [List milestones](/v3/issues/milestones/#list-milestones) * [Create a milestone](/v3/issues/milestones/#create-a-milestone) @@ -391,12 +388,12 @@ While most of your API interaction should occur using your server-to-server inst ##### Organization Hooks -* [List organization webhooks](/v3/orgs/hooks/#list-organization-webhooks) -* [Create an organization webhook](/v3/orgs/hooks/#create-an-organization-webhook) -* [Get an organization webhook](/v3/orgs/hooks/#get-an-organization-webhook) -* [Update an organization webhook](/v3/orgs/hooks/#update-an-organization-webhook) -* [Delete an organization webhook](/v3/orgs/hooks/#delete-an-organization-webhook) -* [Ping an organization webhook](/v3/orgs/hooks/#ping-an-organization-webhook) +* [List organization webhooks](/rest/reference/orgs#webhooks/#list-organization-webhooks) +* [Create an organization webhook](/rest/reference/orgs#webhooks/#create-an-organization-webhook) +* [Get an organization webhook](/rest/reference/orgs#webhooks/#get-an-organization-webhook) +* [Update an organization webhook](/rest/reference/orgs#webhooks/#update-an-organization-webhook) +* [Delete an organization webhook](/rest/reference/orgs#webhooks/#delete-an-organization-webhook) +* [Ping an organization webhook](/rest/reference/orgs#webhooks/#ping-an-organization-webhook) {% if currentVersion == "free-pro-team@latest" %} ##### Organization Invitations @@ -478,7 +475,7 @@ While most of your API interaction should occur using your server-to-server inst * [List child teams](/v3/teams/#list-child-teams) * [List teams for the authenticated user](/v3/teams/#list-teams-for-the-authenticated-user) -##### Organisationen +##### Organizations * [List organizations](/v3/orgs/#list-organizations) * [Get an organization](/v3/orgs/#get-an-organization) @@ -527,7 +524,7 @@ While most of your API interaction should occur using your server-to-server inst * [Remove project collaborator](/v3/projects/collaborators/#remove-project-collaborator) * [Get project permission for a user](/v3/projects/collaborators/#get-project-permission-for-a-user) -##### Projekte +##### Projects * [List organization projects](/v3/projects/#list-organization-projects) * [Create an organization project](/v3/projects/#create-an-organization-project) @@ -610,16 +607,16 @@ While most of your API interaction should occur using your server-to-server inst * [Delete team discussion reaction](/v3/reactions/#delete-team-discussion-reaction) * [Delete team discussion comment reaction](/v3/reactions/#delete-team-discussion-comment-reaction){% endif %} -##### Repositorys +##### Repositories -* [Repositorys einer Organisation auflisten](/v3/repos/#list-organization-repositories) +* [List organization repositories](/v3/repos/#list-organization-repositories) * [Create a repository for the authenticated user](/v3/repos/#create-a-repository-for-the-authenticated-user) * [Get a repository](/v3/repos/#get-a-repository) * [Update a repository](/v3/repos/#update-a-repository) * [Delete a repository](/v3/repos/#delete-a-repository) * [Compare two commits](/v3/repos/commits/#compare-two-commits) * [List repository contributors](/v3/repos/#list-repository-contributors) -* [List forks](/v3/repos/forks/#list-forks) +* [List forks](/rest/reference/repos#list-forks) * [Create a fork](/v3/repos/forks/#create-a-fork) * [List repository languages](/v3/repos/#list-repository-languages) * [List repository tags](/v3/repos/#list-repository-tags) @@ -632,13 +629,13 @@ While most of your API interaction should occur using your server-to-server inst ##### Repository Activity -* [List stargazers](/v3/activity/starring/#list-stargazers) -* [List watchers](/v3/activity/watching/#list-watchers) -* [List repositories starred by a user](/v3/activity/starring/#list-repositories-starred-by-a-user) -* [Check if a repository is starred by the authenticated user](/v3/activity/starring/#check-if-a-repository-is-starred-by-the-authenticated-user) -* [Star a repository for the authenticated user](/v3/activity/starring/#star-a-repository-for-the-authenticated-user) -* [Unstar a repository for the authenticated user](/v3/activity/starring/#unstar-a-repository-for-the-authenticated-user) -* [List repositories watched by a user](/v3/activity/watching/#list-repositories-watched-by-a-user) +* [List stargazers](/rest/reference/activity#list-stargazers) +* [List watchers](/rest/reference/activity#list-watchers) +* [List repositories starred by a user](/rest/reference/activity#list-repositories-starred-by-a-user) +* [Check if a repository is starred by the authenticated user](/rest/reference/activity#check-if-a-repository-is-starred-by-the-authenticated-user) +* [Star a repository for the authenticated user](/rest/reference/activity#star-a-repository-for-the-authenticated-user) +* [Unstar a repository for the authenticated user](/rest/reference/activity#unstar-a-repository-for-the-authenticated-user) +* [List repositories watched by a user](/rest/reference/activity#list-repositories-watched-by-a-user) {% if currentVersion == "free-pro-team@latest" %} ##### Repository Automated Security Fixes @@ -756,14 +753,14 @@ While most of your API interaction should occur using your server-to-server inst ##### Repository Pages -* [Get a GitHub Pages site](/v3/repos/pages/#get-a-github-pages-site) -* [Create a GitHub Pages site](/v3/repos/pages/#create-a-github-pages-site) -* [Update information about a GitHub Pages site](/v3/repos/pages/#update-information-about-a-github-pages-site) -* [Delete a GitHub Pages site](/v3/repos/pages/#delete-a-github-pages-site) -* [List GitHub Pages builds](/v3/repos/pages/#list-github-pages-builds) -* [Request a GitHub Pages build](/v3/repos/pages/#request-a-github-pages-build) -* [Get GitHub Pages build](/v3/repos/pages/#get-github-pages-build) -* [Get latest pages build](/v3/repos/pages/#get-latest-pages-build) +* [Get a GitHub Pages site](/rest/reference/repos#get-a-github-pages-site) +* [Create a GitHub Pages site](/rest/reference/repos#create-a-github-pages-site) +* [Update information about a GitHub Pages site](/rest/reference/repos#update-information-about-a-github-pages-site) +* [Delete a GitHub Pages site](/rest/reference/repos#delete-a-github-pages-site) +* [List GitHub Pages builds](/rest/reference/repos#list-github-pages-builds) +* [Request a GitHub Pages build](/rest/reference/repos#request-a-github-pages-build) +* [Get GitHub Pages build](/rest/reference/repos#get-github-pages-build) +* [Get latest pages build](/rest/reference/repos#get-latest-pages-build) {% if currentVersion != "free-pro-team@latest" %} ##### Repository Pre Receive Hooks @@ -776,17 +773,17 @@ While most of your API interaction should occur using your server-to-server inst ##### Repository Releases -* [Veröffentlichungen auflisten](/v3/repos/releases/#list-releases) -* [Create a release](/v3/repos/releases/#create-a-release) -* [Get a release](/v3/repos/releases/#get-a-release) -* [Einen Release aktualisieren](/v3/repos/releases/#update-a-release) -* [Delete a release](/v3/repos/releases/#delete-a-release) -* [List release assets](/v3/repos/releases/#list-release-assets) -* [Get a release asset](/v3/repos/releases/#get-a-release-asset) -* [Update a release asset](/v3/repos/releases/#update-a-release-asset) -* [Delete a release asset](/v3/repos/releases/#delete-a-release-asset) -* [Get the latest release](/v3/repos/releases/#get-the-latest-release) -* [Get a release by tag name](/v3/repos/releases/#get-a-release-by-tag-name) +* [List releases](/rest/reference/repos/#list-releases) +* [Create a release](/rest/reference/repos/#create-a-release) +* [Get a release](/rest/reference/repos/#get-a-release) +* [Update a release](/rest/reference/repos/#update-a-release) +* [Delete a release](/rest/reference/repos/#delete-a-release) +* [List release assets](/rest/reference/repos/#list-release-assets) +* [Get a release asset](/rest/reference/repos/#get-a-release-asset) +* [Update a release asset](/rest/reference/repos/#update-a-release-asset) +* [Delete a release asset](/rest/reference/repos/#delete-a-release-asset) +* [Get the latest release](/rest/reference/repos/#get-the-latest-release) +* [Get a release by tag name](/rest/reference/repos/#get-a-release-by-tag-name) ##### Repository Stats @@ -809,16 +806,16 @@ While most of your API interaction should occur using your server-to-server inst * [Emojis](/v3/emojis/#emojis) * [Get rate limit status for the authenticated user](/v3/rate_limit/#get-rate-limit-status-for-the-authenticated-user) -##### Suche +##### Search * [Search code](/v3/search/#search-code) * [Search commits](/v3/search/#search-commits) * [Search labels](/v3/search/#search-labels) -* [Repositorys suchen](/v3/search/#search-repositories) +* [Search repositories](/v3/search/#search-repositories) * [Search topics](/v3/search/#search-topics) * [Search users](/v3/search/#search-users) -##### Status +##### Statuses * [Get the combined status for a specific reference](/v3/repos/statuses/#get-the-combined-status-for-a-specific-reference) * [List commit statuses for a reference](/v3/repos/statuses/#list-commit-statuses-for-a-reference) @@ -837,7 +834,7 @@ While most of your API interaction should occur using your server-to-server inst * [Update a discussion comment](/v3/teams/discussion_comments/#update-a-discussion-comment) * [Delete a discussion comment](/v3/teams/discussion_comments/#delete-a-discussion-comment) -##### Themen +##### Topics * [Get all repository topics](/v3/repos#get-all-repository-topics) * [Replace all repository topics](/v3/repos/#replace-all-repository-topics) @@ -899,7 +896,7 @@ While most of your API interaction should occur using your server-to-server inst * [Delete a public SSH key for the authenticated user](/v3/users/keys/#delete-a-public-ssh-key-for-the-authenticated-user) * [List public keys for a user](/v3/users/keys/#list-public-keys-for-a-user) -##### Benutzer +##### Users * [Get the authenticated user](/v3/users/#get-the-authenticated-user) * [List app installations accessible to the user access token](/v3/apps/installations/#list-app-installations-accessible-to-the-user-access-token) diff --git a/translations/de-DE/content/developers/apps/migrating-oauth-apps-to-github-apps.md b/translations/de-DE/content/developers/apps/migrating-oauth-apps-to-github-apps.md index 8f5358a9b5db..26925e8506f6 100644 --- a/translations/de-DE/content/developers/apps/migrating-oauth-apps-to-github-apps.md +++ b/translations/de-DE/content/developers/apps/migrating-oauth-apps-to-github-apps.md @@ -11,7 +11,6 @@ versions: This article provides guidelines for existing integrators who are considering migrating from an OAuth App to a GitHub App. - ### Reasons for switching to GitHub Apps [GitHub Apps](/apps/) are the officially recommended way to integrate with GitHub because they offer many advantages over a pure OAuth-based integration: diff --git a/translations/de-DE/content/developers/apps/modifying-an-oauth-app.md b/translations/de-DE/content/developers/apps/modifying-an-oauth-app.md index 869475ce85bd..3e45db618208 100644 --- a/translations/de-DE/content/developers/apps/modifying-an-oauth-app.md +++ b/translations/de-DE/content/developers/apps/modifying-an-oauth-app.md @@ -9,12 +9,10 @@ versions: enterprise-server: '*' --- - - - {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.oauth_apps %} {% data reusables.user-settings.modify_oauth_app %} -5. Modify the {% data variables.product.prodname_oauth_app %} information that you'd like to change. +1. Modify the +{% data variables.product.prodname_oauth_app %} information that you'd like to change. {% data reusables.user-settings.update_oauth_app %} diff --git a/translations/de-DE/content/developers/apps/refreshing-user-to-server-access-tokens.md b/translations/de-DE/content/developers/apps/refreshing-user-to-server-access-tokens.md index c7cb608bd585..92532cfd7edf 100644 --- a/translations/de-DE/content/developers/apps/refreshing-user-to-server-access-tokens.md +++ b/translations/de-DE/content/developers/apps/refreshing-user-to-server-access-tokens.md @@ -28,10 +28,10 @@ This callback request will send you a new access token and a new refresh token. #### Parameters -| Name | Typ | Beschreibung | -| --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Name | Typ | Beschreibung | +| --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `refresh_token` | `string` | **Required.** The token generated when the {% data variables.product.prodname_github_app %} owner enables expiring tokens and issues a new user access token. | -| `grant_type` | `string` | **Required.** Value must be `refresh_token` (required by the OAuth specification). | +| `grant_type` | `string` | **Required.** Value must be `refresh_token` (required by the OAuth specification). | | `client_id` | `string` | **Required.** The client ID for your {% data variables.product.prodname_github_app %}. | | `client_secret` | `string` | **Required.** The client secret for your {% data variables.product.prodname_github_app %}. | diff --git a/translations/de-DE/content/developers/apps/scopes-for-oauth-apps.md b/translations/de-DE/content/developers/apps/scopes-for-oauth-apps.md index 62caf6805ac6..ff5b4dc33152 100644 --- a/translations/de-DE/content/developers/apps/scopes-for-oauth-apps.md +++ b/translations/de-DE/content/developers/apps/scopes-for-oauth-apps.md @@ -36,46 +36,47 @@ X-Accepted-OAuth-Scopes: user ### Available scopes -| Name | Beschreibung | -| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| **`(no scope)`** | Grants read-only access to public information (includes public user profile info, public repository info, and gists){% if currentVersion != "free-pro-team@latest" %} -| **`site_admin`** | Grants site administrators access to [{% data variables.product.prodname_ghe_server %} Administration API endpoints](/v3/enterprise-admin).{% endif %} -| **`repo`** | Grants full access to private and public repositories. That includes read/write access to code, commit statuses, repository and organization projects, invitations, collaborators, adding team memberships, deployment statuses, and repository webhooks for public and private repositories and organizations. Also grants ability to manage user projects. | -|  `repo:status` | Grants read/write access to public and private repository commit statuses. This scope is only necessary to grant other users or services access to private repository commit statuses *without* granting access to the code. | -|  `repo_deployment` | Grants access to [deployment statuses](/v3/repos/deployments) for public and private repositories. This scope is only necessary to grant other users or services access to deployment statuses, *without* granting access to the code. | -|  `public_repo` | Limits access to public repositories. That includes read/write access to code, commit statuses, repository projects, collaborators, and deployment statuses for public repositories and organizations. Also required for starring public repositories. | -|  `repo:invite` | Grants accept/decline abilities for invitations to collaborate on a repository. This scope is only necessary to grant other users or services access to invites *without* granting access to the code.{% if currentVersion == "free-pro-team@latest" %} -|  `security_events` | Grants read and write access to security events in the [{% data variables.product.prodname_code_scanning %} API](/v3/code-scanning).{% endif %} -| **`admin:repo_hook`** | Grants read, write, ping, and delete access to repository hooks in public and private repositories. The `repo` and `public_repo` scopes grants full access to repositories, including repository hooks. Use the `admin:repo_hook` scope to limit access to only repository hooks. | -|  `write:repo_hook` | Grants read, write, and ping access to hooks in public or private repositories. | -|  `read:repo_hook` | Grants read and ping access to hooks in public or private repositories. | -| **`admin:org`** | Fully manage the organization and its teams, projects, and memberships. | -|  `write:org` | Read and write access to organization membership, organization projects, and team membership. | -|  `read:org` | Read-only access to organization membership, organization projects, and team membership. | -| **`admin:public_key`** | Fully manage public keys. | -|  `write:public_key` | Create, list, and view details for public keys. | -|  `read:public_key` | List and view details for public keys. | -| **`admin:org_hook`** | Grants read, write, ping, and delete access to organization hooks. **Note:** OAuth tokens will only be able to perform these actions on organization hooks which were created by the OAuth App. Personal access tokens will only be able to perform these actions on organization hooks created by a user. | -| **`gist`** | Grants write access to gists. | -| **`benachrichtigungen`** | Grants:
    * read access to a user's notifications
    * mark as read access to threads
    * watch and unwatch access to a repository, and
    * read, write, and delete access to thread subscriptions. | -| **`Benutzer`** | Grants read/write access to profile info only. Note that this scope includes `user:email` and `user:follow`. | -|  `read:user` | Grants access to read a user's profile data. | -|  `user:email` | Grants read access to a user's email addresses. | -|  `user:follow` | Grants access to follow or unfollow other users. | -| **`delete_repo`** | Grants access to delete adminable repositories. | -| **`write:discussion`** | Allows read and write access for team discussions. | -|  `read:discussion` | Allows read access for team discussions.{% if currentVersion == "free-pro-team@latest" %} -| **`write:packages`** | Grants access to upload or publish a package in {% data variables.product.prodname_registry %}. For more information, see "[Publishing a package](/github/managing-packages-with-github-packages/publishing-a-package)". | -| **`read:packages`** | Grants access to download or install packages from {% data variables.product.prodname_registry %}. For more information, see "[Installing a package](/github/managing-packages-with-github-packages/installing-a-package)". | -| **`delete:packages`** | Grants access to delete packages from {% data variables.product.prodname_registry %}. For more information, see "[Deleting packages](/github/managing-packages-with-github-packages/deleting-a-package)".{% endif %} -| **`admin:gpg_key`** | Fully manage GPG keys. | -|  `write:gpg_key` | Create, list, and view details for GPG keys. | -|  `read:gpg_key` | List and view details for GPG keys.{% if currentVersion == "free-pro-team@latest" %} -| **`Workflow`** | Grants the ability to add and update {% data variables.product.prodname_actions %} workflow files. Workflow files can be committed without this scope if the same file (with both the same path and contents) exists on another branch in the same repository.{% endif %} +Name | Description +-----|-----------| +**`(no scope)`** | Grants read-only access to public information (includes public user profile info, public repository info, and gists){% if currentVersion != "free-pro-team@latest" %} +**`site_admin`** | Grants site administrators access to [{% data variables.product.prodname_ghe_server %} Administration API endpoints](/v3/enterprise-admin).{% endif %} +**`repo`** | Grants full access to private and public repositories. That includes read/write access to code, commit statuses, repository and organization projects, invitations, collaborators, adding team memberships, deployment statuses, and repository webhooks for public and private repositories and organizations. Also grants ability to manage user projects. + `repo:status`| Grants read/write access to public and private repository commit statuses. This scope is only necessary to grant other users or services access to private repository commit statuses *without* granting access to the code. + `repo_deployment`| Grants access to [deployment statuses](/v3/repos/deployments) for public and private repositories. This scope is only necessary to grant other users or services access to deployment statuses, *without* granting access to the code. + `public_repo`| Limits access to public repositories. That includes read/write access to code, commit statuses, repository projects, collaborators, and deployment statuses for public repositories and organizations. Also required for starring public repositories. + `repo:invite` | Grants accept/decline abilities for invitations to collaborate on a repository. This scope is only necessary to grant other users or services access to invites *without* granting access to the code.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21"%} + `security_events` | Grants read and write access to security events in the [{% data variables.product.prodname_code_scanning %} API](/v3/code-scanning).{% endif %} +**`admin:repo_hook`** | Grants read, write, ping, and delete access to repository hooks in public and private repositories. The `repo` and `public_repo` scopes grants full access to repositories, including repository hooks. Use the `admin:repo_hook` scope to limit access to only repository hooks. + `write:repo_hook` | Grants read, write, and ping access to hooks in public or private repositories. + `read:repo_hook`| Grants read and ping access to hooks in public or private repositories. +**`admin:org`** | Fully manage the organization and its teams, projects, and memberships. + `write:org`| Read and write access to organization membership, organization projects, and team membership. + `read:org`| Read-only access to organization membership, organization projects, and team membership. +**`admin:public_key`** | Fully manage public keys. + `write:public_key`| Create, list, and view details for public keys. + `read:public_key`| List and view details for public keys. +**`admin:org_hook`** | Grants read, write, ping, and delete access to organization hooks. **Note:** OAuth tokens will only be able to perform these actions on organization hooks which were created by the OAuth App. Personal access tokens will only be able to perform these actions on organization hooks created by a user. +**`gist`** | Grants write access to gists. +**`notifications`** | Grants:
    * read access to a user's notifications
    * mark as read access to threads
    * watch and unwatch access to a repository, and
    * read, write, and delete access to thread subscriptions. +**`user`** | Grants read/write access to profile info only. Note that this scope includes `user:email` and `user:follow`. + `read:user`| Grants access to read a user's profile data. + `user:email`| Grants read access to a user's email addresses. + `user:follow`| Grants access to follow or unfollow other users. +**`delete_repo`** | Grants access to delete adminable repositories. +**`write:discussion`** | Allows read and write access for team discussions. + `read:discussion` | Allows read access for team discussions.{% if currentVersion == "free-pro-team@latest" %} +**`write:packages`** | Grants access to upload or publish a package in {% data variables.product.prodname_registry %}. For more information, see "[Publishing a package](/github/managing-packages-with-github-packages/publishing-a-package)". +**`read:packages`** | Grants access to download or install packages from {% data variables.product.prodname_registry %}. For more information, see "[Installing a package](/github/managing-packages-with-github-packages/installing-a-package)". +**`delete:packages`** | Grants access to delete packages from {% data variables.product.prodname_registry %}. For more information, see "[Deleting packages](/github/managing-packages-with-github-packages/deleting-a-package)".{% endif %} +**`admin:gpg_key`** | Fully manage GPG keys. + `write:gpg_key`| Create, list, and view details for GPG keys. + `read:gpg_key`| List and view details for GPG keys.{% if currentVersion == "free-pro-team@latest" %} +**`workflow`** | Grants the ability to add and update {% data variables.product.prodname_actions %} workflow files. Workflow files can be committed without this scope if the same file (with both the same path and contents) exists on another branch in the same repository.{% endif %} {% note %} -**Note:** Your OAuth App can request the scopes in the initial redirection. You can specify multiple scopes by separating them with a space: +**Note:** Your OAuth App can request the scopes in the initial redirection. You +can specify multiple scopes by separating them with a space: https://github.com/login/oauth/authorize? client_id=...& @@ -85,14 +86,29 @@ X-Accepted-OAuth-Scopes: user ### Requested scopes and granted scopes -The `scope` attribute lists scopes attached to the token that were granted by the user. Normally, these scopes will be identical to what you requested. However, users can edit their scopes, effectively granting your application less access than you originally requested. Also, users can edit token scopes after the OAuth flow is completed. You should be aware of this possibility and adjust your application's behavior accordingly. +The `scope` attribute lists scopes attached to the token that were granted by +the user. Normally, these scopes will be identical to what you requested. +However, users can edit their scopes, effectively +granting your application less access than you originally requested. Also, users +can edit token scopes after the OAuth flow is completed. +You should be aware of this possibility and adjust your application's behavior +accordingly. -It's important to handle error cases where a user chooses to grant you less access than you originally requested. For example, applications can warn or otherwise communicate with their users that they will see reduced functionality or be unable to perform some actions. +It's important to handle error cases where a user chooses to grant you +less access than you originally requested. For example, applications can warn +or otherwise communicate with their users that they will see reduced +functionality or be unable to perform some actions. -Also, applications can always send users back through the flow again to get additional permission, but don’t forget that users can always say no. +Also, applications can always send users back through the flow again to get +additional permission, but don’t forget that users can always say no. -Check out the [Basics of Authentication guide](/guides/basics-of-authentication/), which provides tips on handling modifiable token scopes. +Check out the [Basics of Authentication guide](/guides/basics-of-authentication/), which +provides tips on handling modifiable token scopes. ### Normalized scopes -When requesting multiple scopes, the token is saved with a normalized list of scopes, discarding those that are implicitly included by another requested scope. For example, requesting `user,gist,user:email` will result in a token with `user` and `gist` scopes only since the access granted with `user:email` scope is included in the `user` scope. +When requesting multiple scopes, the token is saved with a normalized list +of scopes, discarding those that are implicitly included by another requested +scope. For example, requesting `user,gist,user:email` will result in a +token with `user` and `gist` scopes only since the access granted with +`user:email` scope is included in the `user` scope. diff --git a/translations/de-DE/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md b/translations/de-DE/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md index 9269ed1fcda8..10c0ed839fb3 100644 --- a/translations/de-DE/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md +++ b/translations/de-DE/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md @@ -9,7 +9,6 @@ versions: --- - ### Einführung This guide will walk through the steps needed to configure a GitHub App and run it on a server. GitHub Apps require some setup steps to manage webhook events and connect the app registration on GitHub to your code. The app in this guide serves as a foundation that you can use to extend and build new GitHub Apps. diff --git a/translations/de-DE/content/developers/apps/suspending-a-github-app-installation.md b/translations/de-DE/content/developers/apps/suspending-a-github-app-installation.md index e964d827d9ae..caf739366085 100644 --- a/translations/de-DE/content/developers/apps/suspending-a-github-app-installation.md +++ b/translations/de-DE/content/developers/apps/suspending-a-github-app-installation.md @@ -17,13 +17,15 @@ versions: ### Suspending a GitHub App -To suspend a {% data variables.product.prodname_github_app %}, you must be an account owner or have admin permissions in the repository or organization where the app you want to suspend is installed. +The integrator who owns and maintains a GitHub app, also called a GitHub App owner, can suspend or unsuspend a GitHub App installation using REST API endpoints with a JWT. For more information, see the [GitHub Apps REST API](/rest/reference/apps). -You can also suspend and unsuspend {% data variables.product.prodname_github_app %} installations using the REST API. For more information, see the [GitHub Apps REST API](/v3/apps/). +People who have installed a GitHub App, also called installation owners, can only suspend or unsuspend a GitHub App through their app's installation settings. Installation owners cannot use the API to suspend or unsuspend their app installation. Before people can suspend a GitHub app installation, the GitHub App owner must opt-in to the beta release. For more information, see "[Suspending a GitHub App installation](/apps/managing-github-apps/suspending-a-github-app-installation/)." {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.github_apps %} -4. Select the {% data variables.product.prodname_github_app %} you want to suspend. ![App selection](/assets/images/github-apps/github_apps_select-app.png) +4. Select the +{% data variables.product.prodname_github_app %} you want to suspend. +![App selection](/assets/images/github-apps/github_apps_select-app.png) {% data reusables.user-settings.github_apps_advanced %} 6. Next to the suspension settings for the installation, click **Suspend** or **Unsuspend**. ![Suspend a GitHub App](/assets/images/github-apps/suspend-a-github-app.png) diff --git a/translations/de-DE/content/developers/apps/using-the-github-api-in-your-app.md b/translations/de-DE/content/developers/apps/using-the-github-api-in-your-app.md index bab8cb700ff3..52568d57251b 100644 --- a/translations/de-DE/content/developers/apps/using-the-github-api-in-your-app.md +++ b/translations/de-DE/content/developers/apps/using-the-github-api-in-your-app.md @@ -10,7 +10,6 @@ versions: --- - ### Einführung This guide will help you build a GitHub App and run it on a server. The app you build will add a label to all new issues opened in the repository where the app is installed. diff --git a/translations/de-DE/content/developers/github-marketplace/drafting-a-listing-for-your-app.md b/translations/de-DE/content/developers/github-marketplace/drafting-a-listing-for-your-app.md index 0da8b2f8d741..7bc6b6e54221 100644 --- a/translations/de-DE/content/developers/github-marketplace/drafting-a-listing-for-your-app.md +++ b/translations/de-DE/content/developers/github-marketplace/drafting-a-listing-for-your-app.md @@ -40,7 +40,10 @@ To create a {% data variables.product.prodname_marketplace %} listing: ![App type selection](/assets/images/settings/apps_choose_app.png) -4. Select the app you'd like to add to {% data variables.product.prodname_marketplace %}. ![App selection for {% data variables.product.prodname_marketplace %} listing](/assets/images/github-apps/github_apps_select-app.png) +4. Select the app you'd like to add to + +{% data variables.product.prodname_marketplace %}. +![App selection for {% data variables.product.prodname_marketplace %} listing](/assets/images/github-apps/github_apps_select-app.png) {% data reusables.user-settings.edit_marketplace_listing %} 5. Once you've created a new draft listing, you'll see an overview of the sections that you'll need to visit before your {% data variables.product.prodname_marketplace %} listing will be complete. ![GitHub Marketplace listing](/assets/images/marketplace/marketplace_listing_overview.png) diff --git a/translations/de-DE/content/developers/github-marketplace/viewing-metrics-for-your-listing.md b/translations/de-DE/content/developers/github-marketplace/viewing-metrics-for-your-listing.md index fe55776d9baa..045237bda979 100644 --- a/translations/de-DE/content/developers/github-marketplace/viewing-metrics-for-your-listing.md +++ b/translations/de-DE/content/developers/github-marketplace/viewing-metrics-for-your-listing.md @@ -47,7 +47,8 @@ To access {% data variables.product.prodname_marketplace %} Insights: {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.marketplace_apps %} -4. Select the {% data variables.product.prodname_github_app %} that you'd like to view Insights for. +4. Select the +{% data variables.product.prodname_github_app %} that you'd like to view Insights for. {% data reusables.user-settings.edit_marketplace_listing %} 6. Click the **Insights** tab. 7. Optionally, select a different time period by clicking the Period dropdown in the upper-right corner of the Insights page. ![Marketplace time period](/assets/images/marketplace/marketplace_insights_time_period.png) diff --git a/translations/de-DE/content/developers/github-marketplace/viewing-transactions-for-your-listing.md b/translations/de-DE/content/developers/github-marketplace/viewing-transactions-for-your-listing.md index 5f87adff43f0..15ede21ee304 100644 --- a/translations/de-DE/content/developers/github-marketplace/viewing-transactions-for-your-listing.md +++ b/translations/de-DE/content/developers/github-marketplace/viewing-transactions-for-your-listing.md @@ -39,7 +39,8 @@ To access {% data variables.product.prodname_marketplace %} transactions: {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.marketplace_apps %} -4. Select the {% data variables.product.prodname_github_app %} that you'd like to view transactions for. +4. Select the +{% data variables.product.prodname_github_app %} that you'd like to view transactions for. {% data reusables.user-settings.edit_marketplace_listing %} 6. Click the **Transactions** tab. 7. Optionally, select a different time period by clicking the Period dropdown in the upper-right corner of the Transactions page. ![Marketplace time period](/assets/images/marketplace/marketplace_insights_time_period.png) diff --git a/translations/de-DE/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md b/translations/de-DE/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md index b687921b78d2..4cda848ec14d 100644 --- a/translations/de-DE/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md +++ b/translations/de-DE/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md @@ -27,18 +27,18 @@ Each `marketplace_purchase` webhook payload will have the following information: | `action` | `string` | The action performed to generate the webhook. Can be `purchased`, `cancelled`, `pending_change`, `pending_change_cancelled`, or `changed`. For more information, see the example webhook payloads below. **Note:** The `pending_change` and `pending_change_cancelled` payloads contain the same keys as shown in the [`changed` payload example](#example-webhook-payload-for-a-changed-event). | | `effective_date` | `string` | The date the `action` becomes effective. | | `sender` | `Objekt` | The person who took the `action` that triggered the webhook. | -| `marketplace_purchase` | `Objekt` | The {% data variables.product.prodname_marketplace %} purchase information. | +| `marketplace_purchase` | `Objekt` | The {% data variables.product.prodname_marketplace %} purchase information. | The `marketplace_purchase` object has the following keys: | Schlüssel | Typ | Beschreibung | | -------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Konto` | `Objekt` | The `organization` or `user` account associated with the subscription. Organization accounts will include `organization_billing_email`, which is the organization's administrative email address. To find email addresses for personal accounts, you can use the [Get the authenticated user](/v3/users/#get-the-authenticated-user) endpoint. | -| `billing_cycle` | `string` | Can be `yearly` or `monthly`. When the `account` owner has a free GitHub plan and has purchased a free {% data variables.product.prodname_marketplace %} plan, `billing_cycle` will be `nil`. | +| `billing_cycle` | `string` | Can be `yearly` or `monthly`. When the `account` owner has a free GitHub plan and has purchased a free {% data variables.product.prodname_marketplace %} plan, `billing_cycle` will be `nil`. | | `unit_count` | `integer` | Number of units purchased. | | `on_free_trial` | `boolean` | `true` when the `account` is on a free trial. | | `free_trial_ends_on` | `string` | The date the free trial will expire. | -| `next_billing_date` | `string` | The date that the next billing cycle will start. When the `account` owner has a free GitHub.com plan and has purchased a free {% data variables.product.prodname_marketplace %} plan, `next_billing_date` will be `nil`. | +| `next_billing_date` | `string` | The date that the next billing cycle will start. When the `account` owner has a free GitHub.com plan and has purchased a free {% data variables.product.prodname_marketplace %} plan, `next_billing_date` will be `nil`. | | `plan` | `Objekt` | The plan purchased by the `user` or `organization`. | The `plan` object has the following keys: diff --git a/translations/de-DE/content/developers/overview/managing-deploy-keys.md b/translations/de-DE/content/developers/overview/managing-deploy-keys.md index 0796897d6ad5..0dc5a58f2471 100644 --- a/translations/de-DE/content/developers/overview/managing-deploy-keys.md +++ b/translations/de-DE/content/developers/overview/managing-deploy-keys.md @@ -10,7 +10,6 @@ versions: --- - You can manage SSH keys on your servers when automating deployment scripts using SSH agent forwarding, HTTPS with OAuth tokens, deploy keys, or machine users. ### SSH agent forwarding diff --git a/translations/de-DE/content/developers/overview/replacing-github-services.md b/translations/de-DE/content/developers/overview/replacing-github-services.md index 13ea935a867a..eb1925fc9e60 100644 --- a/translations/de-DE/content/developers/overview/replacing-github-services.md +++ b/translations/de-DE/content/developers/overview/replacing-github-services.md @@ -19,7 +19,6 @@ As an alternative to the email service, you can now start using email notificati {% endnote %} - ### Deprecation timeline - **October 1, 2018**: GitHub discontinued allowing users to install services. We removed GitHub Services from the GitHub.com user interface. diff --git a/translations/de-DE/content/developers/overview/using-ssh-agent-forwarding.md b/translations/de-DE/content/developers/overview/using-ssh-agent-forwarding.md index bf7f696feeff..aa7d8c9e59e7 100644 --- a/translations/de-DE/content/developers/overview/using-ssh-agent-forwarding.md +++ b/translations/de-DE/content/developers/overview/using-ssh-agent-forwarding.md @@ -93,7 +93,7 @@ Sometimes, system configurations disallow SSH agent forwarding. You can check if ```shell $ ssh -v example.com # Connect to example.com with verbose debug output -> OpenSSH_5.6p1, OpenSSL 0.9.8r 8 Feb 2011 +> OpenSSH_8.1p1, LibreSSL 2.7.3 > debug1: Reading configuration data /Users/you/.ssh/config > debug1: Applying options for example.com > debug1: Reading configuration data /etc/ssh_config diff --git a/translations/de-DE/content/developers/webhooks-and-events/about-webhooks.md b/translations/de-DE/content/developers/webhooks-and-events/about-webhooks.md index fdc784525455..64b973bcf586 100644 --- a/translations/de-DE/content/developers/webhooks-and-events/about-webhooks.md +++ b/translations/de-DE/content/developers/webhooks-and-events/about-webhooks.md @@ -1,5 +1,5 @@ --- -title: Informationen zu Webhooks +title: About webhooks intro: Learn the basics of how webhooks work to help you build and set up integrations. redirect_from: - /webhooks @@ -9,14 +9,13 @@ versions: --- - Webhooks allow you to build or set up integrations, such as [{% data variables.product.prodname_github_app %}s](/apps/building-github-apps/) or [{% data variables.product.prodname_oauth_app %}s](/apps/building-oauth-apps/), which subscribe to certain events on GitHub.com. When one of those events is triggered, we'll send a HTTP POST payload to the webhook's configured URL. Webhooks can be used to update an external issue tracker, trigger CI builds, update a backup mirror, or even deploy to your production server. You're only limited by your imagination. -Webhooks can be installed on{% if currentVersion != "free-pro-team@latest" %} a [{% data variables.product.prodname_ghe_server %} instance](/v3/enterprise-admin/global_webhooks/),{% endif %} an [organization][org-hooks], a specific [repository][repo-hooks], or a {% data variables.product.prodname_github_app %}. Once installed, the webhook will be sent each time one or more subscribed events occurs. +Webhooks can be installed on{% if currentVersion != "free-pro-team@latest" %} a [{% data variables.product.prodname_ghe_server %} instance](/rest/reference/enterprise-admin#global-webhooks/),{% endif %} an [organization][org-hooks], a specific [repository][repo-hooks], or a {% data variables.product.prodname_github_app %}. Once installed, the webhook will be sent each time one or more subscribed events occurs. You can create up to {% if currentVersion != "free-pro-team@latest" %}250{% else %}20{% endif %} webhooks for each event on each installation target {% if currentVersion != "free-pro-team@latest" %}({% data variables.product.prodname_ghe_server %} instance, specific organization, or specific repository).{% else %}(specific organization or specific repository).{% endif %} -### Ereignisse +### Events {% data reusables.webhooks.webhooks_intro %} @@ -30,5 +29,5 @@ See "[Webhook event payloads](/webhooks/event-payloads)" for the list of availab For more information about the `ping` event webhook payload, see the [`ping`](/webhooks/event-payloads/#ping) event. -[org-hooks]: /v3/orgs/hooks/ +[org-hooks]: /rest/reference/orgs#webhooks/ [repo-hooks]: /v3/repos/hooks/ diff --git a/translations/de-DE/content/developers/webhooks-and-events/github-event-types.md b/translations/de-DE/content/developers/webhooks-and-events/github-event-types.md index 5ff8038d2a14..8cecb61cebd6 100644 --- a/translations/de-DE/content/developers/webhooks-and-events/github-event-types.md +++ b/translations/de-DE/content/developers/webhooks-and-events/github-event-types.md @@ -16,7 +16,6 @@ The Events API can return different types of events triggered by activity on Git {% endif %} - ### Event object common properties The event objects returned from the Events API endpoints have the same structure. @@ -203,7 +202,7 @@ This event returns an empty `payload` object. | `push_id` | `integer` | Unique identifier for the push. | | `size` | `integer` | The number of commits in the push. | | `distinct_size` | `integer` | The number of distinct commits in the push. | -| `ref` | `string` | The full [`git ref`](/v3/git/refs/) that was pushed. Example: `refs/heads/master`. | +| `ref` | `string` | The full [`git ref`](/v3/git/refs/) that was pushed. Example: `refs/heads/main`. | | `Head` | `string` | The SHA of the most recent commit on `ref` after the push. | | `before` | `string` | The SHA of the most recent commit on `ref` before the push. | | `commits` | `array` | An array of commit objects describing the pushed commits. (The array includes a maximum of 20 commits. If necessary, you can use the [Commits API](/v3/repos/commits/) to fetch additional commits. This limit is applied to timeline events only and isn't applied to webhook deliveries.) | diff --git a/translations/de-DE/content/developers/webhooks-and-events/issue-event-types.md b/translations/de-DE/content/developers/webhooks-and-events/issue-event-types.md index eeed5e7bfe0c..80c4264671aa 100644 --- a/translations/de-DE/content/developers/webhooks-and-events/issue-event-types.md +++ b/translations/de-DE/content/developers/webhooks-and-events/issue-event-types.md @@ -11,7 +11,6 @@ versions: Issue events are triggered by activity in issues and pull requests and are available in the [Issue Events API](/v3/issues/events) and the [Timeline Events API](/v3/issues/timeline). Each event type specifies whether the event is available in the Issue Events or Timeline Events APIs. - GitHub's REST API considers every pull request to be an issue, but not every issue is a pull request. For this reason, the Issue Events and Timeline Events endpoints may return both issues and pull requests in the response. Pull requests have a `pull_request` property in the `issue` object. Because pull requests are issues, issue and pull request numbers do not overlap in a repository. For example, if you open your first issue in a repository, the number will be 1. If you then open a pull request, the number will be 2. Each event type specifies if the event occurs in pull request, issues, or both. ### Issue event object common properties diff --git a/translations/de-DE/content/developers/webhooks-and-events/securing-your-webhooks.md b/translations/de-DE/content/developers/webhooks-and-events/securing-your-webhooks.md index 7f135f37bdae..0a5ed843591b 100644 --- a/translations/de-DE/content/developers/webhooks-and-events/securing-your-webhooks.md +++ b/translations/de-DE/content/developers/webhooks-and-events/securing-your-webhooks.md @@ -33,9 +33,17 @@ $ export SECRET_TOKEN=your_token ### Validating payloads from GitHub -When your secret token is set, GitHub uses it to create a hash signature with each payload. +When your secret token is set, {% data variables.product.product_name %} uses it to create a hash signature with each payload. This hash signature is included with the headers of each request as {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %}`X-Hub-Signature-256`{% else if currentVersion ver_lt "enterprise-server@2.23" %}`X-Hub-Signature`{% endif %}. -This hash signature is passed along with each request in the headers as `X-Hub-Signature`. Suppose you have a basic server listening to webhooks that looks like this: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %} +{% note %} + +**Note:** For backward-compatibility, we also include the `X-Hub-Signature` header that is generated using the SHA-1 hash function. If possible, we recommend that you use the `X-Hub-Signature-256` header for improved security. The example below demonstrate using the `X-Hub-Signature-256` header. + +{% endnote %} +{% endif %} + +For example, if you have a basic server that listens for webhooks, it might be configured similar to this: ``` ruby require 'sinatra' @@ -47,7 +55,7 @@ post '/payload' do end ``` -The goal is to compute a hash using your `SECRET_TOKEN`, and ensure that the hash from GitHub matches. GitHub uses an HMAC hexdigest to compute the hash, so you could change your server to look a little like this: +The intention is to calculate a hash using your `SECRET_TOKEN`, and ensure that the result matches the hash from {% data variables.product.product_name %}. {% data variables.product.product_name %} uses an HMAC hex digest to compute the hash, so you could reconfigure your server to look a little like this: ``` ruby post '/payload' do @@ -58,16 +66,21 @@ post '/payload' do "I got some JSON: #{push.inspect}" end +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %} +def verify_signature(payload_body) + signature = 'sha256=' + OpenSSL::HMAC.hexdigest(OpenSSL::Digest.new('sha256'), ENV['SECRET_TOKEN'], payload_body) + return halt 500, "Signatures didn't match!" unless Rack::Utils.secure_compare(signature, request.env['HTTP_X_HUB_SIGNATURE_2']) +end{% else if currentVersion ver_lt "enterprise-server@2.23" %} def verify_signature(payload_body) signature = 'sha1=' + OpenSSL::HMAC.hexdigest(OpenSSL::Digest.new('sha1'), ENV['SECRET_TOKEN'], payload_body) return halt 500, "Signatures didn't match!" unless Rack::Utils.secure_compare(signature, request.env['HTTP_X_HUB_SIGNATURE']) -end +end{% endif %} ``` -Obviously, your language and server implementations may differ than this code. There are a couple of very important things to point out, however: +Your language and server implementations may differ from this example code. However, there are a number of very important things to point out: -* No matter which implementation you use, the hash signature starts with `sha1=`, using the key of your secret token and your payload body. +* No matter which implementation you use, the hash signature starts with {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or "private-instances@latest" %}`sha256=`{% else if currentVersion ver_lt "enterprise-server@2.23" %}`sha1=`{% endif %}, using the key of your secret token and your payload body. -* Using a plain `==` operator is **not advised**. A method like [`secure_compare`][secure_compare] performs a "constant time" string comparison, which renders it safe from certain timing attacks against regular equality operators. +* Using a plain `==` operator is **not advised**. A method like [`secure_compare`][secure_compare] performs a "constant time" string comparison, which helps mitigate certain timing attacks against regular equality operators. [secure_compare]: http://rubydoc.info/github/rack/rack/master/Rack/Utils.secure_compare diff --git a/translations/de-DE/content/developers/webhooks-and-events/testing-webhooks.md b/translations/de-DE/content/developers/webhooks-and-events/testing-webhooks.md index d58d672aa61a..459c8bc69b0b 100644 --- a/translations/de-DE/content/developers/webhooks-and-events/testing-webhooks.md +++ b/translations/de-DE/content/developers/webhooks-and-events/testing-webhooks.md @@ -9,7 +9,6 @@ versions: --- - Now that you've [configured your local server](/webhooks/configuring/), you might be interested in pushing your code to the limits. To that end, GitHub's webhooks view provides some tooling for testing your deployed payloads. ### Listing recent deliveries diff --git a/translations/de-DE/content/developers/webhooks-and-events/webhook-events-and-payloads.md b/translations/de-DE/content/developers/webhooks-and-events/webhook-events-and-payloads.md index 4db92903ee02..458467a17387 100644 --- a/translations/de-DE/content/developers/webhooks-and-events/webhook-events-and-payloads.md +++ b/translations/de-DE/content/developers/webhooks-and-events/webhook-events-and-payloads.md @@ -20,7 +20,6 @@ versions: You can create webhooks that subscribe to the events listed on this page. Each webhook event includes a description of the webhook properties and an example payload. Weitere Informationen finden Sie unter „[Webhooks erstellen](/webhooks/creating/)“. - ### Webhook payload object common properties Each webhook event payload also contains properties unique to the event. You can find the unique properties in the individual event type sections. @@ -28,11 +27,8 @@ Each webhook event payload also contains properties unique to the event. You can | Schlüssel | Typ | Beschreibung | | --------- | -------- | ---------------------------------------------------------------------------------------------------------------- | | `action` | `string` | Most webhook payloads contain an `action` property that contains the specific activity that triggered the event. | - {% data reusables.webhooks.sender_desc %} This property is included in every webhook payload. -{% data reusables.webhooks.repo_desc %} Webhook payloads contain the - -`repository` property when the event occurs from activity in a repository. +{% data reusables.webhooks.repo_desc %} Webhook payloads contain the `repository` property when the event occurs from activity in a repository. {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} For more information, see "[Building {% data variables.product.prodname_github_app %}](/apps/building-github-apps/)." @@ -48,13 +44,14 @@ The unique properties for a webhook event are the same properties you'll find in HTTP POST payloads that are delivered to your webhook's configured URL endpoint will contain several special headers: -| Header | Beschreibung | -| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `X-GitHub-Event` | Name of the event that triggered the delivery. | +| Header | Beschreibung | +| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `X-GitHub-Event` | Name of the event that triggered the delivery. | | `X-GitHub-Delivery` | A [GUID](http://en.wikipedia.org/wiki/Globally_unique_identifier) to identify the delivery.{% if currentVersion != "free-pro-team@latest" %} -| `X-GitHub-Enterprise-Version` | The version of the {% data variables.product.prodname_ghe_server %} instance that sent the HTTP POST payload. | -| `X-GitHub-Enterprise-Host` | The hostname of the {% data variables.product.prodname_ghe_server %} instance that sent the HTTP POST payload.{% endif %} -| `X-Hub-Signature` | The HMAC hex digest of the response body. This header will be sent if the webhook is configured with a [`secret`](/v3/repos/hooks/#create-hook-config-params). The HMAC hex digest is generated using the `sha1` hash function and the `secret` as the HMAC `key`. | +| `X-GitHub-Enterprise-Version` | The version of the {% data variables.product.prodname_ghe_server %} instance that sent the HTTP POST payload. | +| `X-GitHub-Enterprise-Host` | The hostname of the {% data variables.product.prodname_ghe_server %} instance that sent the HTTP POST payload.{% endif %}{% if currentVersion != "private-instances@latest" %} +| `X-Hub-Signature` | This header is sent if the webhook is configured with a [`secret`](/v3/repos/hooks/#create-hook-config-params). This is the HMAC hex digest of the request body, and is generated using the SHA-1 hash function and the `secret` as the HMAC `key`.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} `X-Hub-Signature` is provided for compatibility with existing integrations, and we recommend that you use the more secure `X-Hub-Signature-256` instead.{% endif %}{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %} +| `X-Hub-Signature-256` | This header is sent if the webhook is configured with a [`secret`](/v3/repos/hooks/#create-hook-config-params). This is the HMAC hex digest of the request body, and is generated using the SHA-256 hash function and the `secret` as the HMAC `key`.{% endif %} Also, the `User-Agent` for the requests will have the prefix `GitHub-Hookshot/`. @@ -66,8 +63,9 @@ Also, the `User-Agent` for the requests will have the prefix `GitHub-Hookshot/`. > Host: localhost:4567 > X-GitHub-Delivery: 72d3162e-cc78-11e3-81ab-4c9367dc0958{% if currentVersion != "free-pro-team@latest" %} > X-GitHub-Enterprise-Version: 2.15.0 -> X-GitHub-Enterprise-Host: example.com{% endif %} -> X-Hub-Signature: sha1=7d38cdd689735b008b3c702edd92eea23791c5f6 +> X-GitHub-Enterprise-Host: example.com{% endif %}{% if currentVersion != "private-instances@latest" %} +> X-Hub-Signature: sha1=7d38cdd689735b008b3c702edd92eea23791c5f6{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %} +> X-Hub-Signature-256: sha256=d57c68ca6f92289e6987922ff26938930f6e66a2d161ef06abdf1859230aa23c{% endif %} > User-Agent: GitHub-Hookshot/044aadd > Content-Type: application/json > Content-Length: 6615 @@ -292,10 +290,10 @@ Only {% data variables.product.prodname_github_app %}s can receive this event. { #### Webhook payload object -| Schlüssel | Typ | Beschreibung | -| ------------ | --------------------------------------------------------------- | ---------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -| `action` | `string` | The action performed. Can be `created`.{% endif %} -| `deployment` | `Objekt` | The [deployment](/v3/repos/deployments/#list-deployments). | +| Schlüssel | Typ | Beschreibung | +| ------------ | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +| `action` | `string` | The action performed. Can be `created`.{% endif %} +| `deployment` | `Objekt` | The [deployment](/rest/reference/repos#list-deployments). | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} @@ -317,14 +315,14 @@ Only {% data variables.product.prodname_github_app %}s can receive this event. { #### Webhook payload object -| Schlüssel | Typ | Beschreibung | -| ---------------------------------- | --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -| `action` | `string` | The action performed. Can be `created`.{% endif %} -| `deployment_status` | `Objekt` | The [deployment status](/v3/repos/deployments/#list-deployment-statuses). | -| `deployment_status["state"]` | `string` | The new state. Can be `pending`, `success`, `failure`, or `error`. | -| `deployment_status["target_url"]` | `string` | The optional link added to the status. | -| `deployment_status["description"]` | `string` | The optional human-readable description added to the status. | -| `deployment` | `Objekt` | The [deployment](/v3/repos/deployments/#list-deployments) that this status is associated with. | +| Schlüssel | Typ | Beschreibung | +| ---------------------------------- | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +| `action` | `string` | The action performed. Can be `created`.{% endif %} +| `deployment_status` | `Objekt` | The [deployment status](/rest/reference/repos#list-deployment-statuses). | +| `deployment_status["state"]` | `string` | The new state. Can be `pending`, `success`, `failure`, or `error`. | +| `deployment_status["target_url"]` | `string` | The optional link added to the status. | +| `deployment_status["description"]` | `string` | The optional human-readable description added to the status. | +| `deployment` | `Objekt` | The [deployment](/rest/reference/repos#list-deployments) that this status is associated with. | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} @@ -342,7 +340,7 @@ Only {% data variables.product.prodname_github_app %}s can receive this event. { #### Availability -- GitHub Enterprise webhooks. For more information, "[Global webhooks](/v3/enterprise-admin/global_webhooks/)." +- GitHub Enterprise webhooks. For more information, "[Global webhooks](/rest/reference/enterprise-admin#global-webhooks/)." #### Webhook payload object @@ -670,17 +668,17 @@ The webhook this event is configured on was deleted. This event will only listen #### Availability {% if currentVersion != "free-pro-team@latest" %} -- GitHub Enterprise webhooks only receive `created` and `deleted` events. For more information, "[Global webhooks](/v3/enterprise-admin/global_webhooks/).{% endif %} +- GitHub Enterprise webhooks only receive `created` and `deleted` events. For more information, "[Global webhooks](/rest/reference/enterprise-admin#global-webhooks/).{% endif %} - Organization webhooks only receive the `deleted`, `added`, `removed`, `renamed`, and `invited` events - {% data variables.product.prodname_github_app %}s with the `members` permission #### Webhook payload object -| Schlüssel | Typ | Beschreibung | -| ------------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Schlüssel | Typ | Beschreibung | +| ------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `action` | `string` | die Aktion, die durchgeführt wurde. Can be one of:{% if currentVersion != "free-pro-team@latest" %} `created`,{% endif %} `deleted`, `renamed`, `member_added`, `member_removed`, or `member_invited`. | -| `Einladung` | `Objekt` | The invitation for the user or email if the action is `member_invited`. | -| `membership` | `Objekt` | The membership between the user and the organization. Not present when the action is `member_invited`. | +| `Einladung` | `Objekt` | The invitation for the user or email if the action is `member_invited`. | +| `membership` | `Objekt` | The membership between the user and the organization. Not present when the action is `member_invited`. | {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} @@ -747,10 +745,10 @@ Activity related to {% data variables.product.prodname_registry %}. {% data reus #### Webhook payload object -| Schlüssel | Typ | Beschreibung | -| --------- | --------- | --------------------------------------------------------------------------------- | -| `id` | `integer` | The unique identifier of the page build. | -| `build` | `Objekt` | The [List GitHub Pages builds](/v3/repos/pages/#list-github-pages-builds) itself. | +| Schlüssel | Typ | Beschreibung | +| --------- | --------- | -------------------------------------------------------------------------------------- | +| `id` | `integer` | The unique identifier of the page build. | +| `build` | `Objekt` | The [List GitHub Pages builds](/rest/reference/repos#list-github-pages-builds) itself. | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} @@ -772,11 +770,11 @@ Activity related to {% data variables.product.prodname_registry %}. {% data reus #### Webhook payload object -| Schlüssel | Typ | Beschreibung | -| -------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `zen` | `string` | Random string of GitHub zen. | -| `hook_id` | `integer` | The ID of the webhook that triggered the ping. | -| `Hook` | `Objekt` | The [webhook configuration](/v3/repos/hooks/#get-a-repository-webhook). | +| Schlüssel | Typ | Beschreibung | +| -------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `zen` | `string` | Random string of GitHub zen. | +| `hook_id` | `integer` | The ID of the webhook that triggered the ping. | +| `Hook` | `Objekt` | The [webhook configuration](/v3/repos/hooks/#get-a-repository-webhook). | | `hook[app_id]` | `integer` | When you register a new {% data variables.product.prodname_github_app %}, {% data variables.product.product_name %} sends a ping event to the **webhook URL** you specified during registration. The event contains the `app_id`, which is required for [authenticating](/apps/building-integrations/setting-up-and-registering-github-apps/about-authentication-options-for-github-apps/) an app. | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} @@ -972,7 +970,7 @@ Deliveries for `review_requested` and `review_request_removed` events will have | Schlüssel | Typ | Beschreibung | | -------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `ref` | `string` | The full [`git ref`](/v3/git/refs/) that was pushed. Example: `refs/heads/master`. | +| `ref` | `string` | The full [`git ref`](/v3/git/refs/) that was pushed. Example: `refs/heads/main`. | | `before` | `string` | The SHA of the most recent commit on `ref` before the push. | | `after` | `string` | The SHA of the most recent commit on `ref` after the push. | | `commits` | `array` | An array of commit objects describing the pushed commits. (The array includes a maximum of 20 commits. If necessary, you can use the [Commits API](/v3/repos/commits/) to fetch additional commits. This limit is applied to timeline events only and isn't applied to webhook deliveries.) | @@ -1044,7 +1042,7 @@ This event occurs when a {% data variables.product.prodname_github_app %} sends | Schlüssel | Typ | Beschreibung | | --------- | -------- | -------------------------------------------------------------------------------- | -| `action` | `string` | die Aktion, die durchgeführt wurde. This can be one of:
    • `created` - A repository is created.
    • `deleted` - A repository is deleted. This event type is only available to [organization hooks](/v3/orgs/hooks/)
    • `archived` - A repository is archived.
    • `unarchived` - A repository is unarchived.
      • {% if currentVersion != "free-pro-team@latest" %}
    • `anonymous_access_enabled` - A repository is [enabled for anonymous Git access](/v3/previews/#anonymous-git-access-to-repositories), `anonymous_access_disabled` - A repository is [disabled for anonymous Git access](/v3/previews/#anonymous-git-access-to-repositories)
      • {% endif %}
    • `edited` - A repository's information is edited.
    • `renamed` - A repository is renamed.
    • `transferred` - A repository is transferred.
    • `publicized` - A repository is made public.
    • `privatized` - A repository is made private.
    | +| `action` | `string` | die Aktion, die durchgeführt wurde. This can be one of:
    • `created` - A repository is created.
    • `deleted` - A repository is deleted. This event type is only available to [organization hooks](/rest/reference/orgs#webhooks/)
    • `archived` - A repository is archived.
    • `unarchived` - A repository is unarchived.
      • {% if currentVersion != "free-pro-team@latest" %}
    • `anonymous_access_enabled` - A repository is [enabled for anonymous Git access](/v3/previews/#anonymous-git-access-to-repositories), `anonymous_access_disabled` - A repository is [disabled for anonymous Git access](/v3/previews/#anonymous-git-access-to-repositories)
      • {% endif %}
    • `edited` - A repository's information is edited.
    • `renamed` - A repository is renamed.
    • `transferred` - A repository is transferred.
    • `publicized` - A repository is made public.
    • `privatized` - A repository is made private.
    | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} @@ -1253,7 +1251,7 @@ You can only create a sponsorship webhook on {% data variables.product.prodname_ When a user is `created` or `deleted`. #### Availability -- GitHub Enterprise webhooks. For more information, "[Global webhooks](/v3/enterprise-admin/global_webhooks/)." +- GitHub Enterprise webhooks. For more information, "[Global webhooks](/rest/reference/enterprise-admin#global-webhooks/)." #### Webhook payload example @@ -1299,7 +1297,6 @@ This event occurs when someone triggers a workflow run on GitHub or sends a `POS {{ webhookPayloadsForCurrentVersion.workflow_dispatch }} {% endif %} - ### workflow_run When a {% data variables.product.prodname_actions %} workflow run is requested or completed. Weitere Informationen findest Du unter "[Ereignisse, die Workflows auslösen](/actions/reference/events-that-trigger-workflows#workflow_run)." diff --git a/translations/de-DE/content/github/administering-a-repository/about-branch-restrictions.md b/translations/de-DE/content/github/administering-a-repository/about-branch-restrictions.md index c1ab6a6218f6..4741f5161829 100644 --- a/translations/de-DE/content/github/administering-a-repository/about-branch-restrictions.md +++ b/translations/de-DE/content/github/administering-a-repository/about-branch-restrictions.md @@ -1,6 +1,6 @@ --- title: Informationen zu Branch-Einschränkungen -intro: 'Branches innerhalb von Repositorys, die zu Organisationen gehören, können so konfiguriert werden, dass nur bestimmte Benutzer{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %} oder{% endif %} Teams{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} oder Apps{% endif %} Pushes an den Branch durchführen können.' +intro: 'Branches within repositories that belong to organizations can be configured so that only certain users{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %} or{% endif %} teams{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, or apps{% endif %} can push to the branch.' product: '{% data reusables.gated-features.branch-restrictions %}' redirect_from: - /articles/about-branch-restrictions @@ -9,15 +9,15 @@ versions: enterprise-server: '*' --- -Wenn Du Branch-Einschränkungen aktivierst, können nur berechtigte Benutzer{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %} oder{% endif %} Teams{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} oder Apps{% endif %} Pushes an den geschützten Branch durchführen. Weitere Informationen findest Du unter „[Branch-Einschränkungen aktivieren](/articles/enabling-branch-restrictions)" und „[Über geschützte Branches](/articles/about-protected-branches)." Sie können die Benutzer{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}{% else %} oder{% endif %} Teams{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} oder Apps{% endif %} mit Push-Zugriff auf einen geschützten Branch in den Einstellungen des geschützten Branches anzeigen und bearbeiten. +When you enable branch restrictions, only users, teams, or apps that have been given permission can push to the protected branch. Weitere Informationen findest Du unter „[Branch-Einschränkungen aktivieren](/articles/enabling-branch-restrictions)" und „[Über geschützte Branches](/articles/about-protected-branches)." You can view and edit the users, teams, or apps with push access to a protected branch in the protected branch's settings. -Den Push-Zugriff auf einen geschützten Branch kannst du nur Benutzern{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %} oder{% endif %} Teams{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} oder installierten {% data variables.product.prodname_github_apps %}{% endif %} gewähren, die Schreibzugriff (`write`) auf ein Repository haben. +You can only give push access to a protected branch to users, teams, or installed {% data variables.product.prodname_github_apps %} with `write` access to a repository. -Benutzer{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} und Apps{% endif %} mit Administratorberechtigungen für ein Repository können immer Pushes an einen geschützten Branch durchführen. +People and apps with admin permissions to a repository are always able to push to a protected branch. {% tip %} -**Hinweis:** Wenn „Include administrators“ (Administratoren einbeziehen) aktiviert ist und Du die erforderlichen Statuschecks für den Branch aktiviert hast und irgendeiner dieser Statuschecks fehlschlägt, schlägt auch jeder Versuch fehl, Änderungen an den geschützten Branch zu übertragen, selbst für Benutzer{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} und Apps{% endif %} mit Administratorberechtigungen. Weitere Informationen findest Du unter „[Erforderlicher Statuschecks aktivieren](/articles/enabling-required-status-checks)." +**Note:** If "Include administrators" is selected, you've enabled required status checks on the branch, and if any status checks fail, any attempt to push changes to the protected branch will also fail, even for people and apps with admin permissions. Weitere Informationen findest Du unter „[Erforderlicher Statuschecks aktivieren](/articles/enabling-required-status-checks)." {% endtip %} diff --git a/translations/de-DE/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md b/translations/de-DE/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md index 55847b22fa0e..684719ea5832 100644 --- a/translations/de-DE/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md +++ b/translations/de-DE/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md @@ -1,6 +1,6 @@ --- title: Informationen zu E-Mail-Benachrichtigungen für Pushes an Dein Repository -intro: 'Du kannst festlegen, dass E-Mail-Benachrichtigungen automatisch an eine bestimmte E-Mail-Adresse gesendet werden, wenn jemand an das Repository überträgt.' +intro: Du kannst festlegen, dass E-Mail-Benachrichtigungen automatisch an eine bestimmte E-Mail-Adresse gesendet werden, wenn jemand an das Repository überträgt. permissions: Personen mit Administratorberechtigung in einem Repository können E-Mail-Benachrichtigungen für Pushes in Dein Repository aktivieren. redirect_from: - /articles/managing-notifications-for-pushes-to-a-repository/ @@ -18,13 +18,13 @@ In jeder E-Mail-Benachrichtigung für einen Push an ein Repository werden die ne - Den Namen des Repositorys, in dem der Commit erstellt wurde - Den Branch, in dem der Commit erstellt wurde -- Den SHA1 des Commits, einschließlich einer Verknüpfung zum Diff in {% data variables.product.product_name %} +- Den SHA1 des Commits, einschließlich eines Links zum Diff in {% data variables.product.product_name %} - Den Autor des Commits - Das Erstellungsdatum des Commits - Die Dateien, die im Rahmen des Commits geändert wurden - Die Commit-Mitteilung -Du kannst E-Mail-Benachrichtigungen filtern, die Du für Pushes an ein Repository erhältst. Weitere Informationen findest Du unter {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}„[Benachrichtigungen konfigurieren](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#filtering-email-notifications){% else %}„[Über E-Mail-Benachrichtigungen](/github/receiving-notifications-about-activity-on-github/about-email-notifications)." Du kannst auch E-Mail-Benachrichtigungen für Pushes ausschalten. Weitere Informationen findest Du unter „[Auslieferungsmethode für Deine Benachrichtigungen wählen](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications){% endif %}.“ +Du kannst E-Mail-Benachrichtigungen filtern, die Du für Pushes an ein Repository erhältst. For more information, see {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#filtering-email-notifications){% else %}"[About notification emails](/github/receiving-notifications-about-activity-on-github/about-email-notifications)." Du kannst auch E-Mail-Benachrichtigungen für Pushes ausschalten. Weitere Informationen findest Du unter „[Auslieferungsmethode für Deine Benachrichtigungen wählen](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications){% endif %}.“ ### E-Mail-Benachrichtigungen für Pushes in Dein Repository aktivieren @@ -33,8 +33,7 @@ Du kannst E-Mail-Benachrichtigungen filtern, die Du für Pushes an ein Repositor {% data reusables.repositories.sidebar-notifications %} 5. Gib bis zu zwei E-Mail-Adressen (getrennt durch Leerzeichen) ein, an die Du Benachrichtigungen senden möchtest. Wenn Du E-Mails an mehr als zwei Konten senden möchtest, legst Du eine der E-Mail-Adressen als Gruppen-E-Mail-Adresse fest. ![Textfeld für die E-Mail-Adresse](/assets/images/help/settings/email_services_addresses.png) 6. Wenn Du Deinen eigenen Server verwendest, kannst Du die Integrität von E-Mails über das Token **Secret** (Geheim) überprüfen. Dieses Token wird mit der E-Mail als `Approved`-Header (Genehmigt) gesendet. Wenn der `Approved`-Header (Genehmigt) mit dem von Dir gesendeten Token übereinstimmt, kannst Du darauf vertrauen, dass die E-Mail von {% data variables.product.product_name %} stammt. ![Textfeld für das E-Mail-Geheimnis](/assets/images/help/settings/email_services_token.png) -7. Wähle optional **Send from author** (Senden vom Autor), damit E-Mails mit der E-Mail-Adresse des Freigebenden zugestellt werden. Andernfalls werden E-Mails von {% data variables.notifications.no_reply_address %} gesendet. ![Kontrollkästchen für E-Mail-Autor](/assets/images/help/settings/email_services_author.png) -8. Klicke auf **Save settings** (Einstellungen speichern). ![Schaltfläche „Save settings“ (Einstellungen speichern)](/assets/images/help/settings/save_notification_settings.png) +7. Klicke auf **Save settings** (Einstellungen speichern). ![Schaltfläche „Save settings“ (Einstellungen speichern)](/assets/images/help/settings/save_notification_settings.png) ### Weiterführende Informationen {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} diff --git a/translations/de-DE/content/github/administering-a-repository/about-github-dependabot-version-updates.md b/translations/de-DE/content/github/administering-a-repository/about-github-dependabot-version-updates.md index fc587dd02053..b70d5e7e98d7 100644 --- a/translations/de-DE/content/github/administering-a-repository/about-github-dependabot-version-updates.md +++ b/translations/de-DE/content/github/administering-a-repository/about-github-dependabot-version-updates.md @@ -9,11 +9,13 @@ versions: {% data reusables.dependabot.beta-note %} -### Informationen zu {% data variables.product.prodname_dependabot_version_updates %} +### Informationen zum {% data variables.product.prodname_dependabot_version_updates %} {% data variables.product.prodname_dependabot %} takes the effort out of maintaining your dependencies. You can use it to ensure that your repository automatically keeps up with the latest releases of the packages and applications it depends on. -You enable {% data variables.product.prodname_dependabot_version_updates %} by checking a configuration file in to your repository. The configuration file specifies the location of the manifest, or other package definition files, stored in your repository. {% data variables.product.prodname_dependabot_short %} uses this information to check for outdated packages and applications. {% data variables.product.prodname_dependabot_short %} determines if there is a new version of a dependency by looking at the semantic versioning ([semver](https://semver.org/)) of the dependency to decide whether it should update to that version. When {% data variables.product.prodname_dependabot_short %} identifies an outdated dependency, it raises a pull request to update the manifest to the latest version of the dependency. You check that your tests pass, review the changelog and release notes included in the pull request summary, and then merge it. For more information, see "[Enabling and disabling version updates](/github/administering-a-repository/enabling-and-disabling-version-updates)." +You enable {% data variables.product.prodname_dependabot_version_updates %} by checking a configuration file in to your repository. The configuration file specifies the location of the manifest, or other package definition files, stored in your repository. {% data variables.product.prodname_dependabot_short %} uses this information to check for outdated packages and applications. {% data variables.product.prodname_dependabot_short %} determines if there is a new version of a dependency by looking at the semantic versioning ([semver](https://semver.org/)) of the dependency to decide whether it should update to that version. For certain package managers, {% data variables.product.prodname_dependabot_version_updates %} also supports vendoring. Vendored (or cached) dependencies are dependencies that are checked in to a specific directory in a repository, rather than referenced in a manifest. Vendored dependencies are available at build time even if package servers are unavailable. {% data variables.product.prodname_dependabot_version_updates %} can be configured to check vendored dependencies for new versions and update them if necessary. + +When {% data variables.product.prodname_dependabot_short %} identifies an outdated dependency, it raises a pull request to update the manifest to the latest version of the dependency. For vendored dependencies, {% data variables.product.prodname_dependabot_short %} raises a pull request to directly replace the outdated dependency with the new version. You check that your tests pass, review the changelog and release notes included in the pull request summary, and then merge it. For more information, see "[Enabling and disabling version updates](/github/administering-a-repository/enabling-and-disabling-version-updates)." If you enable security updates, {% data variables.product.prodname_dependabot %} also raises pull requests to update vulnerable dependencies. For more information, see "[Configuring {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)." @@ -35,7 +37,7 @@ If you've enabled security updates, you'll sometimes see extra pull requests for {% endnote %} -You can configure version updates for repositories that contain a dependency manifest or lock file for one of the supported package managers. +You can configure version updates for repositories that contain a dependency manifest or lock file for one of the supported package managers. For some package managers, you can also configure vendoring for dependencies. For more information, see "[Configuration options for dependency updates](/github/administering-a-repository/configuration-options-for-dependency-updates#vendor)." {% data reusables.dependabot.supported-package-managers %} diff --git a/translations/de-DE/content/github/administering-a-repository/about-merge-methods-on-github.md b/translations/de-DE/content/github/administering-a-repository/about-merge-methods-on-github.md index 3c0174016170..a290189b5803 100644 --- a/translations/de-DE/content/github/administering-a-repository/about-merge-methods-on-github.md +++ b/translations/de-DE/content/github/administering-a-repository/about-merge-methods-on-github.md @@ -1,6 +1,6 @@ --- title: Informationen zu Merge-Methoden auf GitHub -intro: 'Du kannst Mitarbeitern mit Push-Zugriff auf Dein Repository erlauben, ihre Pull Requests auf {% data variables.product.product_location %} mit verschiedenen Merge-Optionen zusammenzuführen, oder eine bestimmte Merge-Methode für alle Pull Requests Deines Repositorys erzwingen.' +intro: 'Sie können Mitarbeitern mit Push-Zugriff auf Ihr Repository erlauben, ihre Pull Requests auf {% data variables.product.product_location %} mit verschiedenen Merge-Optionen zu mergen, oder eine bestimmte Merge-Methode für alle Pull Requests Ihres Repositorys erzwingen.' redirect_from: - /articles/about-merge-methods-on-github versions: @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -{% data reusables.pull_requests.configure_pull_request_merges_intro %} Du kannst eine Art von Merge-Methode erzwingen, beispielsweise Commit-Squashing oder -Rebasing, indem Du nur die gewünschte Methode für Dein Repository aktivierst. +{% data reusables.pull_requests.configure_pull_request_merges_intro %} Sie können eine Art von Merge-Methode, beispielsweise Commit-Squashing oder Rebasing, erzwingen, indem Sie nur die gewünschte Methode für Ihr Repository aktivieren. {% data reusables.pull_requests.default_merge_option %} diff --git a/translations/de-DE/content/github/administering-a-repository/about-protected-branches.md b/translations/de-DE/content/github/administering-a-repository/about-protected-branches.md index 0dcca1fb3528..f1f03cc87a56 100644 --- a/translations/de-DE/content/github/administering-a-repository/about-protected-branches.md +++ b/translations/de-DE/content/github/administering-a-repository/about-protected-branches.md @@ -24,7 +24,7 @@ Branch-Schutzregeln mit einem Sonderzeichen, wie `*`, `?` oder `]` werden in der ### Einstellungen für geschützte Branches -Wenn Du eine Branch-Schutzregel in einem Repository erstellst, können Mitarbeiter weder einen Push auf den geschützten Branch erzwingen noch den Branch{% if currentVersion == "free-pro-team@latest" %} standardmäßig{% endif %} löschen. Du kannst andere Branch-Schutzeinstellungen aktivieren. Weitere Informationen findest Du unter „[Definieren der Zusammenführbarkeit von Pull Requests](/github/administering-a-repository/defining-the-mergeability-of-pull-requests)." +When you create a branch protection rule in a repository, collaborators cannot force push to the protected branch or delete the branch{% if currentVersion == "free-pro-team@latest" %} by default{% endif %}. Du kannst andere Branch-Schutzeinstellungen aktivieren. Weitere Informationen findest Du unter „[Definieren der Zusammenführbarkeit von Pull Requests](/github/administering-a-repository/defining-the-mergeability-of-pull-requests)." ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/administering-a-repository/about-releases.md b/translations/de-DE/content/github/administering-a-repository/about-releases.md index c44081fb45b5..bfb13addcba6 100644 --- a/translations/de-DE/content/github/administering-a-repository/about-releases.md +++ b/translations/de-DE/content/github/administering-a-repository/about-releases.md @@ -20,16 +20,18 @@ Releases sind einsetzbare Software-Iterationen, die Du paketieren und für ein b Releases basieren auf [Git-Tags](https://git-scm.com/book/en/Git-Basics-Tagging), die einen bestimmten Punkt im Verlauf Deines Repositorys kennzeichnen. Ein Tag kann ein anderes Datum haben als ein Release, da sie zu unterschiedlichen Zeiten erstellt wurden. Weitere Informationen zum Anzeigen Deiner vorhandenen Tags findest Du unter „[Anzeigen der Releases und Tags Deines Repositorys](/github/administering-a-repository/viewing-your-repositorys-releases-and-tags)." -Du kannst Benachrichtigungen erhalten, wenn neue Releases in einem Repository verfügbar sind, ohne Benachrichtigungen über andere Updates des gleichen Repositorys zu erhalten. Weitere Informationen findest Du unter {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}„[Anzeigen Deiner Abonnements](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions){% else %}„[Anzeige von Releases für ein Repository aktivieren oder deaktivieren](/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-releases-for-a-repository){% endif %}." +Du kannst Benachrichtigungen erhalten, wenn neue Releases in einem Repository verfügbar sind, ohne Benachrichtigungen über andere Updates des gleichen Repositorys zu erhalten. 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 releases for a repository](/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-releases-for-a-repository){% endif %}." Alle Personen mit Lesezugriff auf ein Repository können Releases anzeigen und vergleichen, aber nur Personen mit Schreibberechtigungen für ein Repository können Releases verwalten. Weitere Informationen findest Du unter „[Verwalten von Releases in einem Repository](/github/administering-a-repository/managing-releases-in-a-repository)." {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -People with admin permissions to a repository can choose whether {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in the ZIP files and tarballs that {% data variables.product.product_name %} creates for each release. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)." +People with admin permissions to a repository can choose whether +{% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in the ZIP files and tarballs that {% data variables.product.product_name %} creates for each release. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)." {% endif %} {% if currentVersion == "free-pro-team@latest" %} -If a release fixes a security vulnerability, you should publish a security advisory in your repository. {% data variables.product.prodname_dotcom %} reviews each published security advisory and may use it to send {% data variables.product.prodname_dependabot_short %} alerts to affected repositories. For more information, see "[About GitHub Security Advisories](/github/managing-security-vulnerabilities/about-github-security-advisories)." +If a release fixes a security vulnerability, you should publish a security advisory in your repository. +{% data variables.product.prodname_dotcom %} reviews each published security advisory and may use it to send {% data variables.product.prodname_dependabot_short %} alerts to affected repositories. For more information, see "[About GitHub Security Advisories](/github/managing-security-vulnerabilities/about-github-security-advisories)." You can view the **Dependents** tab of the dependency graph to see which repositories and packages depend on code in your repository, and may therefore be affected by a new release. For more information, see "[About the dependency graph](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)." {% endif %} diff --git a/translations/de-DE/content/github/administering-a-repository/about-required-commit-signing.md b/translations/de-DE/content/github/administering-a-repository/about-required-commit-signing.md index c91f5cc29aa4..ca40db4f35a6 100644 --- a/translations/de-DE/content/github/administering-a-repository/about-required-commit-signing.md +++ b/translations/de-DE/content/github/administering-a-repository/about-required-commit-signing.md @@ -1,6 +1,6 @@ --- title: Informationen zur erforderlichen Commit-Signatur -intro: 'Mit der obligatorischen Commit-Signatur wird sichergestellt, dass Mitarbeiter nur verifizierte und signierte Commits an einen geschützten Branch übertragen können.' +intro: Mit der obligatorischen Commit-Signatur wird sichergestellt, dass Mitarbeiter nur verifizierte und signierte Commits an einen geschützten Branch übertragen können. product: '{% data reusables.gated-features.protected-branches %}' redirect_from: - /articles/about-required-commit-signing @@ -11,9 +11,9 @@ versions: Wenn Du in Deinem Repository Branch-Schutzmaßnahmen erzwungen hast, kannst Du die obligatorische Commit-Signatur einrichten. Weitere Informationen findest Du unter „[Geschützte Branches konfigurieren](/articles/configuring-protected-branches/).“ -Wenn du die obligatorische Commit-Signatur in einem Branch aktivierst, können Mitarbeiter {% if currentVersion == "free-pro-team@latest" %}und bots{% endif %} nur Commits übertragen, die für den Branch signiert und verifiziert wurden. Weitere Informationen findest Du unter „[Über die Verifikation von Commit-Signaturen](/articles/about-commit-signature-verification)." +When you enable required commit signing on a branch, contibutors {% if currentVersion == "free-pro-team@latest" %}and bots{% endif %} can only push commits that have been signed and verified to the branch. Weitere Informationen findest Du unter „[Über die Verifikation von Commit-Signaturen](/articles/about-commit-signature-verification)." -Du kannst jederzeit lokale Commits zum Branch übertragen, wenn die Commits signiert und verifiziert sind. {% if currentVersion == "free-pro-team@latest" %}Du kannst signierte und verifizierte Commits auch mittels Pull Request auf {% data variables.product.product_name %} in einen Branch zusammenführen . Du kannst jedoch auf {% data variables.product.product_name %} keinen Pull Request in einen Branch squashen und zusammenführen, außer wenn Du der Autor des Pull Request bist.{% else %} Du kannst jedoch auf {% data variables.product.product_name %} keinen Pull Request in den Branch zusammenführen.{% endif %} Du kannst Pull Requests lokal {% if currentVersion == "free-pro-team@latest" %}squashen und {% endif %}zusammenführen. Weitere Informationen findest Du unter „[Pull Requests lokal auschecken](/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally)."{% if currentVersion == "free-pro-team@latest" %} Weitere Informationen zu Merge-Methoden findest Du unter „[Über Merge-Methoden auf {% data variables.product.prodname_dotcom %}](/github/administering-a-repository/about-merge-methods-on-github)."{% endif %} +Du kannst jederzeit lokale Commits zum Branch übertragen, wenn die Commits signiert und verifiziert sind. {% if currentVersion == "free-pro-team@latest" %}You can also merge signed and verified commits into the branch using a pull request on {% data variables.product.product_name %}. However, you cannot squash and merge a pull request into the branch on {% data variables.product.product_name %} unless you are the author of the pull request.{% else %} However, you cannot merge pull requests into the branch on {% data variables.product.product_name %}.{% endif %} You can {% if currentVersion == "free-pro-team@latest" %}squash and {% endif %}merge pull requests locally. For more information, see "[Checking out pull requests locally](/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally)."{% if currentVersion == "free-pro-team@latest" %} For more information about merge methods, see "[About merge methods on {% data variables.product.prodname_dotcom %}](/github/administering-a-repository/about-merge-methods-on-github)."{% endif %} {% note %} diff --git a/translations/de-DE/content/github/administering-a-repository/about-required-reviews-for-pull-requests.md b/translations/de-DE/content/github/administering-a-repository/about-required-reviews-for-pull-requests.md index 6be5014ac376..51f03b494e8e 100644 --- a/translations/de-DE/content/github/administering-a-repository/about-required-reviews-for-pull-requests.md +++ b/translations/de-DE/content/github/administering-a-repository/about-required-reviews-for-pull-requests.md @@ -1,6 +1,6 @@ --- title: Informationen zu erforderlichen Reviews für Pull-Requests -intro: 'Erforderlichen Reviews stellen sicher, dass Pull Requests eine bestimmte Anzahl von genehmigenden Reviews erhalten, bevor Mitarbeiter Änderungen an einem geschützten Branch vornehmen können.' +intro: Erforderlichen Reviews stellen sicher, dass Pull Requests eine bestimmte Anzahl von genehmigenden Reviews erhalten, bevor Mitarbeiter Änderungen an einem geschützten Branch vornehmen können. product: '{% data reusables.gated-features.protected-branches %}' redirect_from: - /articles/about-required-reviews-for-pull-requests diff --git a/translations/de-DE/content/github/administering-a-repository/about-required-status-checks.md b/translations/de-DE/content/github/administering-a-repository/about-required-status-checks.md index 7b4f96cf59a7..1d5f0ead6ba5 100644 --- a/translations/de-DE/content/github/administering-a-repository/about-required-status-checks.md +++ b/translations/de-DE/content/github/administering-a-repository/about-required-status-checks.md @@ -1,6 +1,6 @@ --- title: Informationen zu erforderlichen Statuschecks -intro: 'Mithilfe von erforderlichen Statuschecks wird sichergestellt, dass alle erforderlichen CI-Tests bestanden werden, bevor Mitarbeiter Änderungen an einem geschützten Branch vornehmen können.' +intro: Mithilfe von erforderlichen Statuschecks wird sichergestellt, dass alle erforderlichen CI-Tests bestanden werden, bevor Mitarbeiter Änderungen an einem geschützten Branch vornehmen können. product: '{% data reusables.gated-features.protected-branches %}' redirect_from: - /articles/about-required-status-checks @@ -19,7 +19,7 @@ Nach der Aktivierung der erforderlichen Statuschecks müssen alle erforderlichen {% tip %} -**Hinweis:** Jede Person oder Integration mit Schreibberechtigungen auf ein Repository kann den Zustand von Statuschecks im Repository festlegen. {% data variables.product.product_name %} verifiziert nicht, dass der Autor einer Prüfung autorisiert ist, eine Prüfung mit einem bestimmten Namen zu erstellen oder einen vorhandenen Status zu ändern. Vor dem Zusammenführen eines Pull Request solltest Du überprüfen, dass der Autor jedes im Merge-Feld aufgeführten Status erwartet wird. +**Hinweis:** Jede Person oder Integration mit Schreibberechtigungen auf ein Repository kann den Zustand von Statuschecks im Repository festlegen. {% data variables.product.product_name %} verifiziert nicht, dass der Autor eines Checks autorisiert ist, einen Check mit einem bestimmten Namen zu erstellen oder einen vorhandenen Status zu ändern. Vor dem Zusammenführen eines Pull Request solltest Du überprüfen, dass der Autor jedes im Merge-Feld aufgeführten Status erwartet wird. {% endtip %} diff --git a/translations/de-DE/content/github/administering-a-repository/about-securing-your-repository.md b/translations/de-DE/content/github/administering-a-repository/about-securing-your-repository.md index 14bfd3be4858..ea5782b898fa 100644 --- a/translations/de-DE/content/github/administering-a-repository/about-securing-your-repository.md +++ b/translations/de-DE/content/github/administering-a-repository/about-securing-your-repository.md @@ -19,7 +19,7 @@ The first step to securing a repository is to set up who can see and modify your - **Security advisories** - Privately discuss and fix security vulnerabilities in your repository's code. You can then publish a security advisory to alert your community to the vulnerability and encourage them to upgrade. Weitere Informationen findest Du unter „[Über {% data variables.product.prodname_security_advisories %}](/github/managing-security-vulnerabilities/about-github-security-advisories)." + Privately discuss and fix security vulnerabilities in your repository's code. You can then publish a security advisory to alert your community to the vulnerability and encourage them to upgrade. Weitere Informationen findest Du unter „[ Über {% data variables.product.prodname_security_advisories %}](/github/managing-security-vulnerabilities/about-github-security-advisories)." - **{% data variables.product.prodname_dependabot_short %} alerts** diff --git a/translations/de-DE/content/github/administering-a-repository/automation-for-release-forms-with-query-parameters.md b/translations/de-DE/content/github/administering-a-repository/automation-for-release-forms-with-query-parameters.md index 9d5c0884afc7..3c320797752f 100644 --- a/translations/de-DE/content/github/administering-a-repository/automation-for-release-forms-with-query-parameters.md +++ b/translations/de-DE/content/github/administering-a-repository/automation-for-release-forms-with-query-parameters.md @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -Abfrageparameter sind optionale Bestandteile einer URL, die Du anpassen kannst, um eine bestimmte Ansicht einer Webseite weiterzugeben, beispielsweise gefilterte Suchergebnisse, eine Issuevorlage oder die Seite mit dem Releaseformular auf {% data variables.product.prodname_dotcom %}. Um eigene Abfrageparameter zu erstellen, musst Du Schlüssel- und Wertepaar abgleichen. +Abfrageparameter sind optionale Bestandteile einer URL, die Sie anpassen können, um eine bestimmte Ansicht einer Webseite weiterzugeben, z. B. gefilterte Suchergebnisse, eine Issue-Vorlage oder die Seite mit dem Veröffentlichungsformular auf {% data variables.product.prodname_dotcom %}. Um eigene Abfrageparameter zu erstellen, musst Du Schlüssel- und Wertepaar abgleichen. Du musst die erforderlichen Berechtigungen für jede Aktion haben, um den entsprechenden Abfrageparameter zu verwenden. Du benötigst beispielsweise die Berechtigung zum Erstellen von Releases, um das Releaseformular vorab auszufüllen. Weitere Informationen findest Du unter „[Verwalten von Releases in einem Repository](/github/administering-a-repository/managing-releases-in-a-repository)." diff --git a/translations/de-DE/content/github/administering-a-repository/changing-the-default-branch.md b/translations/de-DE/content/github/administering-a-repository/changing-the-default-branch.md new file mode 100644 index 000000000000..41e38a85e25e --- /dev/null +++ b/translations/de-DE/content/github/administering-a-repository/changing-the-default-branch.md @@ -0,0 +1,53 @@ +--- +title: Changing the default branch +intro: 'If you have more than one branch in your repository, you can configure any branch as the default branch.' +permissions: People with admin permissions to a repository can change the default branch for the repository. +versions: + free-pro-team: '*' + enterprise-server: '*' +redirect_from: + - /github/administering-a-repository/setting-the-default-branch + - /articles/setting-the-default-branch +--- + +### About changing the default branch + +You can choose the default branch for a repository. The default branch is the base branch for pull requests and code commits. For more information about the default branch, see "[About branches](/github/collaborating-with-issues-and-pull-requests/about-branches#about-the-default-branch)." + +{% note %} + +**Note**: If you use the Git-Subversion bridge, changing the default branch will affect your `trunk` branch contents and the `HEAD` you see when you list references for the remote repository. For more information, see "[Support for Subversion clients](/github/importing-your-projects-to-github/support-for-subversion-clients)" and [git-ls-remote](https://git-scm.com/docs/git-ls-remote.html) in the Git documentation. + +{% endnote %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} + +{% data reusables.branches.set-default-branch %} + +{% endif %} + +### Vorrausetzungen + +To change the default branch, your repository must have more than one branch. Weitere Informationen findest Du unter „[Branches in Deinem Repository erstellen und löschen](/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository#creating-a-branch).“ + +### Changing the default branch + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.repository-branches %} +1. Under "Default branch", to the right of the default branch name, click {% octicon "arrow-switch" aria-label="The switch icon with two arrows" %}. ![Switch icon with two arrows to the right of current default branch name](/assets/images/help/repository/repository-options-defaultbranch-change.png) +1. Use the drop-down, then click a branch name. ![Drop-down to choose new default branch](/assets/images/help/repository/repository-options-defaultbranch-drop-down.png) +1. Klicke auf **Update** (Aktualisieren). !["Update" button after choosing a new default branch](/assets/images/help/repository/repository-options-defaultbranch-update.png) +1. Read the warning, then click **I understand, update the default branch.** !["Update" button after choosing a new default branch](/assets/images/help/repository/repository-options-defaultbranch-i-understand.png) + +{% else %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.repository-branches %} +1. In the default branch drop-down, choose the new default branch. ![Dropdown-Auswahl für Standardbranch](/assets/images/help/repository/repository-options-defaultbranch.png) +1. Klicke auf **Update** (Aktualisieren). + +{% endif %} diff --git a/translations/de-DE/content/github/administering-a-repository/classifying-your-repository-with-topics.md b/translations/de-DE/content/github/administering-a-repository/classifying-your-repository-with-topics.md index f8cb8ca05801..1adf59df661f 100644 --- a/translations/de-DE/content/github/administering-a-repository/classifying-your-repository-with-topics.md +++ b/translations/de-DE/content/github/administering-a-repository/classifying-your-repository-with-topics.md @@ -1,6 +1,6 @@ --- -title: Repository mit Themen klassifizieren -intro: 'Damit andere Personen Dein Projekt leichter finden und Beiträge dazu leisten können, kannst Du zu Deinem Repository Themen hinzufügen, die in Zusammenhang mit dem beabsichtigten Zweck, dem Themenbereich, verbundenen Gruppen oder anderen wichtigen Eigenschaften des Projekts stehen.' +title: Classifying your repository with topics +intro: 'To help other people find and contribute to your project, you can add topics to your repository related to your project''s intended purpose, subject area, affinity groups, or other important qualities.' redirect_from: - /articles/about-topics/ - /articles/classifying-your-repository-with-topics @@ -9,30 +9,36 @@ versions: enterprise-server: '*' --- -### Informationen zu Themen +### About topics -Mithilfe von Themen kannst Du Repositorys zu einem bestimmten Themenbereich erkunden, Projekte finden, zu denen Du einen Beitrag leisten kannst, und neue Lösungen für ein bestimmtes Problem entdecken. Themen werden auf der Hauptseite eines Repositorys angezeigt. Du kannst auf den Namen eines Themas klicken, um {% if currentVersion == "free-pro-team@latest" %}ähnliche Themen und eine Liste anderer Repositorys mit demselben Thema anzuzeigen{% else %}nach anderen Repositorys mit demselben Thema zu suchen{% endif %}. +With topics, you can explore repositories in a particular subject area, find projects to contribute to, and discover new solutions to a specific problem. Topics appear on the main page of a repository. You can click a topic name to {% if currentVersion == "free-pro-team@latest" %}see related topics and a list of other repositories classified with that topic{% else %}search for other repositories with that topic{% endif %}. -![Hauptseite des Test-Repositorys, auf der Themen angezeigt werden](/assets/images/help/repository/os-repo-with-topics.png) +![Main page of the test repository showing topics](/assets/images/help/repository/os-repo-with-topics.png) -Rufe https://github.com/topics/ auf, um die am häufigsten verwendeten Themen zu durchsuchen. +To browse the most used topics, go to https://github.com/topics/. -{% if currentVersion == "free-pro-team@latest" %}Du kannst im [github/exlore](https://github.com/github/explore)-Repository zu allen vorgestellten Themen von {% data variables.product.product_name %} beitragen. {% endif %} +{% if currentVersion == "free-pro-team@latest" %}You can contribute to {% data variables.product.product_name %}'s set of featured topics in the [github/explore](https://github.com/github/explore) repository. {% endif %} -Repository-Administratoren können beliebige Themen zu einem Repository hinzufügen. Hilfreiche Themen, mit denen Du ein Repository klassifizieren kannst, sind beispielsweise der beabsichtigte Zweck, der Themenbereich, die Community oder die Sprache des Repositorys.{% if currentVersion == "free-pro-team@latest" %} Zusätzlich analysiert {% data variables.product.product_name %} Inhalte öffentlicher Repositorys und erzeugt Themenvorschläge, die Repository-Administratoren annehmen oder ablehnen können. Die Inhalte privater Repositorys werden nicht analysiert, und es gibt keine Themenvorschläge für private Repositorys.{% endif %} +Repository admins can add any topics they'd like to a repository. Helpful topics to classify a repository include the repository's intended purpose, subject area, community, or language.{% if currentVersion == "free-pro-team@latest" %} Additionally, {% data variables.product.product_name %} analyzes public repository content and generates suggested topics that repository admins can accept or reject. Private repository content is not analyzed and does not receive topic suggestions.{% endif %} -Öffentliche und private Repositorys können Themen haben, aber in den Resultaten der Themensuche wirst Du nur die privaten Repositorys sehen, auf die Du Zugriff hast. +Public and private repositories can have topics, although you will only see private repositories that you have access to in topic search results. -Du kannst nach Repositorys suchen, die mit einem bestimmten Thema verknüpft sind. Weitere Informationen finden Sie unter „[Nach Repositorys suchen](/articles/searching-for-repositories/#search-by-topic)“. Sie können auch nach einer Liste von Themen auf {% data variables.product.product_name %} suchen. Weitere Informationen findest Du unter „[Themen suchen](/articles/searching-topics).“ +You can search for repositories that are associated with a particular topic. For more information, see "[Searching for repositories](/articles/searching-for-repositories#search-by-topic)." You can also search for a list of topics on {% data variables.product.product_name %}. For more information, see "[Searching topics](/articles/searching-topics)." -### Themen zum Repository hinzufügen +### Adding topics to your repository {% data reusables.repositories.navigate-to-repo %}{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %} -2. Klicke unter der Beschreibung des Repositorys auf **Add topics** (Themen hinzufügen). ![Link „Add topics“ (Themen hinzufügen) auf der Hauptseite eines Repositorys](/assets/images/help/repository/add-topics-link.png) -3. Gib das Thema ein, das Du zum Repository hinzufügen möchtest, gefolgt von einem Leerzeichen. ![Formular zur Eingabe von Themen](/assets/images/help/repository/add-topic-form.png) -4. Wenn Du mit dem Hinzufügen von Themen fertig bist, klicke auf **Done** (Fertig). ![Formular mit einer Liste an Themen und Schaltfläche „Done“ (Fertig)](/assets/images/help/repository/add-topics-done-button.png) +2. Under your repository description, click **Add topics**. + ![Add topics link on a repository's main page](/assets/images/help/repository/add-topics-link.png) +3. Type the topic you want to add to your repository, then type a space. + ![Form to enter topics](/assets/images/help/repository/add-topic-form.png) +4. After you've finished adding topics, click **Done**. + ![Form with a list of topics and Done button](/assets/images/help/repository/add-topics-done-button.png) {% else %} -2. To the right of "About", click {% octicon "gear" aria-label="The Gear icon" %}. ![Gear icon on main page of a repository](/assets/images/help/repository/edit-repository-details-gear.png) -3. Under "Topics", type the topic you want to add to your repository, then type a space. ![Formular zur Eingabe von Themen](/assets/images/help/repository/add-topic-form.png) -4. After you've finished adding topics, click **Save changes**. !["Save changes" button in "Edit repository details"](/assets/images/help/repository/edit-repository-details-save-changes-button.png) +2. To the right of "About", click {% octicon "gear" aria-label="The Gear icon" %}. + ![Gear icon on main page of a repository](/assets/images/help/repository/edit-repository-details-gear.png) +3. Under "Topics", type the topic you want to add to your repository, then type a space. + ![Form to enter topics](/assets/images/help/repository/add-topic-form.png) +4. After you've finished adding topics, click **Save changes**. + !["Save changes" button in "Edit repository details"](/assets/images/help/repository/edit-repository-details-save-changes-button.png) {% endif %} diff --git a/translations/de-DE/content/github/administering-a-repository/comparing-releases.md b/translations/de-DE/content/github/administering-a-repository/comparing-releases.md index 7cc0a515a0ba..334d9ae18545 100644 --- a/translations/de-DE/content/github/administering-a-repository/comparing-releases.md +++ b/translations/de-DE/content/github/administering-a-repository/comparing-releases.md @@ -1,6 +1,6 @@ --- title: Releases vergleichen -intro: 'Du kannst die Release-Tags vergleichen, um Änderungen an Deinem Repository zwischen verschiedenen Releases zu sehen.' +intro: Du kannst die Release-Tags vergleichen, um Änderungen an Deinem Repository zwischen verschiedenen Releases zu sehen. permissions: Personen mit Lesezugriff auf ein Repository können Releases ansehen und vergleichen. versions: free-pro-team: '*' diff --git a/translations/de-DE/content/github/administering-a-repository/configuration-options-for-dependency-updates.md b/translations/de-DE/content/github/administering-a-repository/configuration-options-for-dependency-updates.md index cca362bfd892..4e52277f6c6b 100644 --- a/translations/de-DE/content/github/administering-a-repository/configuration-options-for-dependency-updates.md +++ b/translations/de-DE/content/github/administering-a-repository/configuration-options-for-dependency-updates.md @@ -37,13 +37,14 @@ The *dependabot.yml* file must start with `version: 2` followed by an array of ` | [`schedule.time`](#scheduletime) | | Time of day to check for updates (hh:mm) | | [`schedule.timezone`](#scheduletimezone) | | Timezone for time of day (zone identifier) | | [`target-branch`](#target-branch) | | Branch to create pull requests against | +| [`vendor`](#vendor) | | Update vendored or cached dependencies | | [`versioning-strategy`](#versioning-strategy) | | How to update manifest version requirements | These options fit broadly into the following categories. - Essential set up options that you must include in all configurations: [`package-ecosystem`](#package-ecosystem), [`directory`](#directory),[`schedule.interval`](#scheduleinterval). - Options to customize the update schedule: [`schedule.time`](#scheduletime), [`schedule.timezone`](#scheduletimezone), [`schedule.day`](#scheduleday). -- Options to control which dependencies are updated: [`allow`](#allow), [`ignore`](#ignore). +- Options to control which dependencies are updated: [`allow`](#allow), [`ignore`](#ignore), [`vendor`](#vendor). - Options to add metadata to pull requests: [`reviewers`](#reviewers), [`assignees`](#assignees), [`labels`](#labels), [`milestone`](#milestone). - Options to change the behavior of the pull requests: [`target-branch`](#target-branch), [`versioning-strategy`](#versioning-strategy), [`commit-message`](#commit-message), [`rebase-strategy`](#rebase-strategy), [`pull-request-branch-name.separator`](#pull-request-branch-nameseparator). @@ -61,7 +62,7 @@ In general, security updates use any configuration options that affect pull requ ### `package-ecosystem` -**Required** You add one `package-ecosystem` element for each one package manager that you want {% data variables.product.prodname_dependabot %} to monitor for new versions. The repository must also contain a dependency manifest or lock file each of these package managers. +**Required** You add one `package-ecosystem` element for each package manager that you want {% data variables.product.prodname_dependabot_short %} to monitor for new versions. The repository must also contain a dependency manifest or lock file for each of these package managers. If you want to enable vendoring for a package manager that supports it, the vendored dependencies must be located in the required directory. For more information, see [`vendor`](#vendor) below. {% data reusables.dependabot.supported-package-managers %} @@ -307,7 +308,7 @@ updates: {% note %} -{% data variables.product.prodname_dependabot_version_updates %} can't run version updates for any dependencies in manifests containing private git dependencies or private git registries, even if you add the private dependencies to the `ignore` option of your configuration file. For more information, see "[About {% data variables.product.prodname_dependabot_version_updates %}](/github/administering-a-repository/about-github-dependabot#supported-repositories-and-ecosystems)." +**Note**: {% data variables.product.prodname_dependabot_version_updates %} can't run version updates for any dependencies in manifests containing private git dependencies or private git registries, even if you add the private dependencies to the `ignore` option of your configuration file. For more information, see "[About {% data variables.product.prodname_dependabot_version_updates %}](/github/administering-a-repository/about-github-dependabot#supported-repositories-and-ecosystems)." {% endnote %} @@ -540,6 +541,31 @@ updates: - "npm dependencies" ``` +### `vendor` + +Use the `vendor` option to tell {% data variables.product.prodname_dependabot_short %} to vendor dependencies when updating them. + +{% note %} + +Currently, {% data variables.product.prodname_dependabot_short %} only supports vendoring dependencies for Bundler. + +{% endnote %} + +```yaml +# Configure version updates for both dependencies defined in manifests and vendored dependencies + +version: 2 +updates: + - package-ecosystem: "bundler" + # Raise pull requests to update vendored dependencies that are checked in to the repository + vendor: true + directory: "/" + schedule: + interval: "weekly" +``` + +{% data variables.product.prodname_dependabot_short %} only updates the vendored dependencies located in specific directories in a repository. For Bundler, the dependencies must be in the _vendor/cache_ directory. Other file paths are not supported. For more information, see the [`bundle cache` documentation](https://bundler.io/man/bundle-cache.1.html). + ### `versioning-strategy` When {% data variables.product.prodname_dependabot %} edits a manifest file to update a version, it uses the following overall strategies: diff --git a/translations/de-DE/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md b/translations/de-DE/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md index 1a0eaf6f1df7..ec4cb356d4e9 100644 --- a/translations/de-DE/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md +++ b/translations/de-DE/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md @@ -1,12 +1,12 @@ --- title: Automatische Links von externen Ressourcen konfigurieren -intro: 'Du kannst automatische Links von externen Ressourcen, wie JIRA-Issues oder Zendesk-Tickets, hinzufügen, um Deinen Workflow zu optimieren.' +intro: Du kannst automatische Links von externen Ressourcen, wie JIRA-Issues oder Zendesk-Tickets, hinzufügen, um Deinen Workflow zu optimieren. product: '{% data reusables.gated-features.autolinks %}' redirect_from: - /articles/configuring-autolinks-to-reference-external-resources versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- Anyone with admin permissions to a repository can configure autolink references to link issues, pull requests,{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} commit messages, and release descriptions{% else %} and commit messages{% endif %} to external third-party services. diff --git a/translations/de-DE/content/github/administering-a-repository/configuring-commit-rebasing-for-pull-requests.md b/translations/de-DE/content/github/administering-a-repository/configuring-commit-rebasing-for-pull-requests.md index 2ec38d9db803..d10c040229ca 100644 --- a/translations/de-DE/content/github/administering-a-repository/configuring-commit-rebasing-for-pull-requests.md +++ b/translations/de-DE/content/github/administering-a-repository/configuring-commit-rebasing-for-pull-requests.md @@ -1,6 +1,6 @@ --- title: Commit-Rebasing für Pull-Requests konfigurieren -intro: 'Du kannst Commit-Rebasing für alle Pull-Request-Merges auf {% data variables.product.product_location %} in Deinem Repository erzwingen, zulassen oder deaktivieren.' +intro: 'Sie können Commit-Rebasing für alle Pull-Request-Merges auf {% data variables.product.product_location %} in Ihrem Repository erzwingen, zulassen oder deaktivieren.' redirect_from: - /articles/configuring-commit-rebasing-for-pull-requests versions: diff --git a/translations/de-DE/content/github/administering-a-repository/configuring-commit-squashing-for-pull-requests.md b/translations/de-DE/content/github/administering-a-repository/configuring-commit-squashing-for-pull-requests.md index 967b6a23e057..b34895e181f8 100644 --- a/translations/de-DE/content/github/administering-a-repository/configuring-commit-squashing-for-pull-requests.md +++ b/translations/de-DE/content/github/administering-a-repository/configuring-commit-squashing-for-pull-requests.md @@ -1,6 +1,6 @@ --- title: Commit-Squashing für Pull-Requests konfigurieren -intro: 'Du kannst Commit-Squashing für alle Pull-Request-Merges auf {% data variables.product.product_location %} in Deinem Repository erzwingen, zulassen oder deaktivieren.' +intro: 'Sie können der Commit-Squashing für alle Pull-Request-Merges auf {% data variables.product.product_location %} in Ihrem Repository erzwingen, zulassen oder deaktivieren.' redirect_from: - /articles/configuring-commit-squashing-for-pull-requests versions: diff --git a/translations/de-DE/content/github/administering-a-repository/configuring-pull-request-merges.md b/translations/de-DE/content/github/administering-a-repository/configuring-pull-request-merges.md index fb0d09ae8ed0..eac3ef913642 100644 --- a/translations/de-DE/content/github/administering-a-repository/configuring-pull-request-merges.md +++ b/translations/de-DE/content/github/administering-a-repository/configuring-pull-request-merges.md @@ -1,6 +1,6 @@ --- title: Pull-Request-Merges konfigurieren -intro: 'Du kannst Pull-Request-Merges auf {% data variables.product.product_location %} so konfigurieren, dass ein Abgleich an Deinen Workflow und Deine Voreinstellungen für die Verwaltung des Git-Verlaufs erfolgt, indem Du standardmäßige Merge-Commits, Squash-Commits oder Rebase-Commits an alle Pull Requests in Deinem Repository aktivierst, deaktivierst oder erzwingst.' +intro: 'Sie können Pull-Request-Merges auf {% data variables.product.product_location %} so konfigurieren, dass eine Angleichung an Ihren Workflow und Ihre Voreinstellungen für die Verwaltung des Git-Verlaufs erfolgt, indem Sie standardmäßige Merge-Commits, Squash-Commits oder Rebase-Commits an alle Pull Requests in Ihrem Repository aktivieren, deaktivieren oder erzwingen.' mapTopic: true redirect_from: - /articles/configuring-pull-request-merges diff --git a/translations/de-DE/content/github/administering-a-repository/configuring-secret-scanning-for-private-repositories.md b/translations/de-DE/content/github/administering-a-repository/configuring-secret-scanning-for-private-repositories.md index 7e3860e20a64..bff3221e784c 100644 --- a/translations/de-DE/content/github/administering-a-repository/configuring-secret-scanning-for-private-repositories.md +++ b/translations/de-DE/content/github/administering-a-repository/configuring-secret-scanning-for-private-repositories.md @@ -1,5 +1,5 @@ --- -title: „Secret scanning" (Durchsuchung nach Geheimnissen) für private Repositorys konfigurieren +title: '„Secret scanning" (Durchsuchung nach Geheimnissen) für private Repositorys konfigurieren' intro: 'Du kannst konfigurieren, wie {% data variables.product.product_name %} Deine privaten Repositories nach Geheimnissen durchsucht.' permissions: 'Personen mit Administratorberechtigungen für ein privates Repository können {% data variables.product.prodname_secret_scanning %} für das Repository aktivieren.' versions: diff --git a/translations/de-DE/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md b/translations/de-DE/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md new file mode 100644 index 000000000000..c759845dad4e --- /dev/null +++ b/translations/de-DE/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md @@ -0,0 +1,18 @@ +--- +title: Configuring the retention period for GitHub Actions artifacts and logs in your repository +intro: 'You can configure the retention period for {% data variables.product.prodname_actions %} artifacts and logs in your repository.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.23' +--- + +{% data reusables.actions.about-artifact-log-retention %} + +You can also define a custom retention period for a specific artifact created by a workflow. For more information, see "[Setting the retention period for an artifact](/actions/managing-workflow-runs/removing-workflow-artifacts#setting-the-retention-period-for-an-artifact)." + +## Setting the retention period for a repository + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.settings-sidebar-actions %} +{% data reusables.github-actions.change-retention-period-for-artifacts-logs %} diff --git a/translations/de-DE/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md b/translations/de-DE/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md index 5c873810ad5f..378662c32f77 100644 --- a/translations/de-DE/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md +++ b/translations/de-DE/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md @@ -1,11 +1,11 @@ --- title: Social-Media-Vorschau Deines Repositorys anpassen -intro: 'Du kannst das Bild anpassen, das auf Social-Media-Plattformen angezeigt wird, wenn jemand auf Dein Repository verknüpft.' +intro: Du kannst das Bild anpassen, das auf Social-Media-Plattformen angezeigt wird, wenn jemand auf Dein Repository verknüpft. redirect_from: - /articles/customizing-your-repositorys-social-media-preview versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- Wenn Du noch kein Bild hinzugefügt hast, werden sich Repository-Links erweitern, um grundlegende Informationen zum Repository sowie den Avatar des Inhabers anzeigen. Durch das Hinzufügen eines Bildes zu Deinem Repository vereinfachst Du die Identifizierung Deines Projekts auf den verschiedenen Social-Media-Kanälen. diff --git a/translations/de-DE/content/github/administering-a-repository/deleting-a-repository.md b/translations/de-DE/content/github/administering-a-repository/deleting-a-repository.md index 9cf6f3dd8926..7229dc427e35 100644 --- a/translations/de-DE/content/github/administering-a-repository/deleting-a-repository.md +++ b/translations/de-DE/content/github/administering-a-repository/deleting-a-repository.md @@ -1,6 +1,6 @@ --- title: Repository löschen -intro: 'Du kannst ein Repository oder einen Fork löschen, wenn Du Organisationsinhaber bist oder über Administratorberechtigungen für das Repository oder den Fork verfügst. Durch das Löschen eines geforkten Repositorys wird das vorgelagerte Repository nicht gelöscht.' +intro: Du kannst ein Repository oder einen Fork löschen, wenn Du Organisationsinhaber bist oder über Administratorberechtigungen für das Repository oder den Fork verfügst. Durch das Löschen eines geforkten Repositorys wird das vorgelagerte Repository nicht gelöscht. redirect_from: - /delete-a-repo/ - /deleting-a-repo/ diff --git a/translations/de-DE/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md b/translations/de-DE/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md index d64d01f4e52f..083751d41a21 100644 --- a/translations/de-DE/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md +++ b/translations/de-DE/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md @@ -35,6 +35,5 @@ Sie können den Head-Branch eines geschlossenen Pull Requests wiederherstellen. ### Weiterführende Informationen -- „[Erstellen und Löschen von Branches innerhalb Deines Repositorys](/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository)"{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} +- „[Erstellen und Löschen von Branches innerhalb Deines Repositorys](/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository)" - „[Automatisches Löschen von Branches verwalten](/github/administering-a-repository/managing-the-automatic-deletion-of-branches)" -{% endif %} diff --git a/translations/de-DE/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md b/translations/de-DE/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md index fc6a841336c6..a48d92319d4b 100644 --- a/translations/de-DE/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md +++ b/translations/de-DE/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md @@ -17,11 +17,13 @@ Du kannst {% data variables.product.prodname_actions %} für Dein Repository akt Alternativ kannst Du {% data variables.product.prodname_actions %} in Deinem Repository aktivieren, aber die Aktionen limitieren, die ein Workflow ausführen kann. {% data reusables.github-actions.enabled-local-github-actions %} +{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.23" %} + ### {% data variables.product.prodname_actions %}-Berechtigungen für Dein Repository verwalten {% note %} -**Note:** You might not be able to manage these settings if your organization has an overriding policy or is managed by an enterprise account that has overriding policy. For more information, see "[Disabling or limiting {% data variables.product.prodname_actions %} for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization)" or "[Enforcing {% data variables.product.prodname_actions %} policies in your enterprise account](/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account)." +**Note:** You might not be able to manage these settings if your organization has an overriding policy or is managed by an enterprise account that has overriding policy. For more information, see "[Disabling or limiting {% data variables.product.prodname_actions %} for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization)" or {% if currentVersion == "free-pro-team@latest" %}"[Enforcing {% data variables.product.prodname_actions %} policies in your enterprise account](/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account)."{% else if currentVersion ver_gt "enterprise-server@2.21"%}"[Enforcing {% data variables.product.prodname_actions %} policies for your enterprise](/enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise)."{% endif %} {% endnote %} @@ -30,6 +32,41 @@ Alternativ kannst Du {% data variables.product.prodname_actions %} in Deinem Rep {% data reusables.repositories.settings-sidebar-actions %} 4. Wähle unter „Actions permissions" (Berechtigungen für Aktionen) eine Option aus. ![Aktiviere, deaktiviere oder limitiere die Aktionen für dieses Repository](/assets/images/help/repository/enable-repo-actions.png) +{% endif %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} + +### {% data variables.product.prodname_actions %}-Berechtigungen für Dein Repository verwalten + +You can disable all workflows for a repository or set a policy that configures which actions can be used in a repository. + +{% data reusables.actions.actions-use-policy-settings %} + +{% note %} + +**Note:** You might not be able to manage these settings if your organization has an overriding policy or is managed by an enterprise account that has overriding policy. For more information, see "[Disabling or limiting {% data variables.product.prodname_actions %} for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization)" or {% if currentVersion == "free-pro-team@latest" %}"[Enforcing {% data variables.product.prodname_actions %} policies in your enterprise account](/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account)."{% else if currentVersion ver_gt "enterprise-server@2.21" %}"[Enforcing {% data variables.product.prodname_actions %} policies for your enterprise](/enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise)." + +{% endif %} + +{% endnote %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.settings-sidebar-actions %} +1. Under **Actions permissions**, select an option. ![Set actions policy for this organization](/assets/images/help/repository/actions-policy.png) +1. Klicke auf **Save** (Speichern). + +### Allowing specific actions to run + +{% data reusables.actions.allow-specific-actions-intro %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.settings-sidebar-actions %} +1. Under **Actions permissions**, select **Allow specific actions** and add your required actions to the list. ![Add actions to allow list](/assets/images/help/repository/actions-policy-allow-list.png) +2. Klicke auf **Save** (Speichern). +{% endif %} + {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} ### Enabling workflows for private repository forks diff --git a/translations/de-DE/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md b/translations/de-DE/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md index 5d0ee793eee7..29402c063511 100644 --- a/translations/de-DE/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md +++ b/translations/de-DE/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md @@ -1,6 +1,6 @@ --- title: Sponsorenschaltfläche in Deinem Repository anzeigen -intro: 'Du kannst eine Sponsorenschaltfläche zu Deinem Repository hinzufügen, um die Sichtbarkeit von Finanzierungsmöglichkeiten für Dein Open-Source-Projekt zu erhöhen.' +intro: Du kannst eine Sponsorenschaltfläche zu Deinem Repository hinzufügen, um die Sichtbarkeit von Finanzierungsmöglichkeiten für Dein Open-Source-Projekt zu erhöhen. redirect_from: - /github/building-a-strong-community/displaying-a-sponsor-button-in-your-repository - /articles/displaying-a-sponsor-button-in-your-repository @@ -14,18 +14,18 @@ Du kannst Deine Sponsorenschaltfläche konfigurieren, indem Du die Datei _FUNDIN Du kannst einen Benutzernamen, Paketnamen oder Projektnamen pro externer Finanzierungsplattform und bis zu vier benutzerdefinierte URLs hinzufügen. Du kannst bis zu vier unterstützten Entwickler oder Organisationen in {% data variables.product.prodname_sponsors %} hinzufügen. Füge jede Plattform auf einer neuen Zeile hinzu, und verwende dabei die folgende Syntax: -| Plattform | Syntax | -| ---------------------------------------------------------------------------------- | -------------------------------------------------------------------------- | -| [CommunityBridge](https://communitybridge.org) | `community_bridge: PROJECT-NAME` | +| Plattform | Syntax | +| ----------------------------------------------------------------------------- | -------------------------------------------------------------------------- | +| [CommunityBridge](https://communitybridge.org) | `community_bridge: PROJECT-NAME` | | [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors) | `github: USERNAME` oder `github: [USERNAME, USERNAME, USERNAME, USERNAME]` | -| [IssueHunt](https://issuehunt.io/) | `issuehunt: USERNAME` | -| [Ko-fi](https://ko-fi.com/) | `ko_fi: USERNAME` | -| [Liberapay](https://en.liberapay.com/) | `liberapay: USERNAME` | -| [Open Collective](https://opencollective.com/) | `open_collective: USERNAME` | -| [Otechie](https://otechie.com/) | `otechie: USERNAME` | -| [Patreon](https://www.patreon.com/) | `patreon: USERNAME` | -| [Tidelift](https://tidelift.com/) | `tidelift: PLATFORM-NAME/PACKAGE-NAME` | -| Benutzerdefinierte URL | `custom: LINK1` oder `custom: [LINK1, LINK2, LINK3, LINK4]` | +| [IssueHunt](https://issuehunt.io/) | `issuehunt: USERNAME` | +| [Ko-fi](https://ko-fi.com/) | `ko_fi: USERNAME` | +| [Liberapay](https://en.liberapay.com/) | `liberapay: USERNAME` | +| [Open Collective](https://opencollective.com/) | `open_collective: USERNAME` | +| [Otechie](https://otechie.com/) | `otechie: USERNAME` | +| [Patreon](https://www.patreon.com/) | `patreon: USERNAME` | +| [Tidelift](https://tidelift.com/) | `tidelift: PLATFORM-NAME/PACKAGE-NAME` | +| Benutzerdefinierte URL | `custom: LINK1` oder `custom: [LINK1, LINK2, LINK3, LINK4]` | Verwende bei Tidelift die Syntax `platform-name/package-name` mit den folgenden Plattform-Namen: diff --git a/translations/de-DE/content/github/administering-a-repository/enabling-and-disabling-version-updates.md b/translations/de-DE/content/github/administering-a-repository/enabling-and-disabling-version-updates.md index a24d87ce3886..0dbede3caf21 100644 --- a/translations/de-DE/content/github/administering-a-repository/enabling-and-disabling-version-updates.md +++ b/translations/de-DE/content/github/administering-a-repository/enabling-and-disabling-version-updates.md @@ -14,7 +14,7 @@ You enable {% data variables.product.prodname_dependabot_version_updates %} by c {% data reusables.dependabot.initial-updates %} For more information, see "[Customizing dependency updates](/github/administering-a-repository/customizing-dependency-updates)." -### {% data variables.product.prodname_dependabot_version_updates %} aktivieren +### Enabling {% data variables.product.prodname_dependabot_version_updates %} {% note %} diff --git a/translations/de-DE/content/github/administering-a-repository/enabling-branch-restrictions.md b/translations/de-DE/content/github/administering-a-repository/enabling-branch-restrictions.md index 058492291574..d92df8abc6d2 100644 --- a/translations/de-DE/content/github/administering-a-repository/enabling-branch-restrictions.md +++ b/translations/de-DE/content/github/administering-a-repository/enabling-branch-restrictions.md @@ -1,6 +1,6 @@ --- title: Branch-Einschränkungen aktivieren -intro: 'Du kannst Branch-Einschränkungen erzwingend, sodass nur bestimmte Benutzer{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %} oder{% endif %} Teams{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} oder Apps{% endif %} einen Push zu einem geschützten Branch in Repositorys Deiner Organisation machen können.' +intro: 'You can enforce branch restrictions so that only certain users{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %} or{% endif %} teams{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, or apps{% endif %} can push to a protected branch in repositories owned by your organization.' product: '{% data reusables.gated-features.branch-restrictions %}' redirect_from: - /articles/enabling-branch-restrictions @@ -19,7 +19,7 @@ Jeder Benutzer mit Administratorberechtigungen für ein Repository im Besitz der {% data reusables.repositories.add-branch-protection-rules %} {% data reusables.repositories.include-administrators %} 6. Wähle unter „Protect matching Branches" (Schütze übereinstimmende Branches) **Einschränken, wer an übereinstimmende Branches übertragen kann**. ![Kontrollkästchen „Branch restriction" (Branch-Einschränkung)](/assets/images/help/repository/restrict-branch.png) -8. Suche und wähle Personen {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %} oder{% endif %} Teams{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} oder Apps{% endif %} aus, welche die Berechtigung zum übertragen zu geschützten Branches haben. ![Suche für die Branch-Einschränkung](/assets/images/help/repository/restrict-branch-search.png) +8. Search for and select the people, teams, or apps who will have permission to push to the protected branch. ![Suche für die Branch-Einschränkung](/assets/images/help/repository/restrict-branch-search.png) 9. Klicke auf **Create** (Erstellen). ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/administering-a-repository/enabling-deletion-of-a-protected-branch.md b/translations/de-DE/content/github/administering-a-repository/enabling-deletion-of-a-protected-branch.md index bff5c7a1640b..c38baaa0cfd0 100644 --- a/translations/de-DE/content/github/administering-a-repository/enabling-deletion-of-a-protected-branch.md +++ b/translations/de-DE/content/github/administering-a-repository/enabling-deletion-of-a-protected-branch.md @@ -1,6 +1,6 @@ --- title: Löschen eines geschützten Branch aktivieren -intro: 'Du kannst jedem Benutzer mit Schreibzugriff auf ein Repository erlauben, einen geschützten Branch zu löschen.' +intro: Du kannst jedem Benutzer mit Schreibzugriff auf ein Repository erlauben, einen geschützten Branch zu löschen. product: '{% data reusables.gated-features.protected-branches %}' versions: free-pro-team: '*' diff --git a/translations/de-DE/content/github/administering-a-repository/enabling-force-pushes-to-a-protected-branch.md b/translations/de-DE/content/github/administering-a-repository/enabling-force-pushes-to-a-protected-branch.md index b9cf744a1108..3cb9b4f7ebf3 100644 --- a/translations/de-DE/content/github/administering-a-repository/enabling-force-pushes-to-a-protected-branch.md +++ b/translations/de-DE/content/github/administering-a-repository/enabling-force-pushes-to-a-protected-branch.md @@ -1,31 +1,32 @@ --- -title: Erzwungene Pushes zu einem geschützten Branch aktivieren -intro: Du kannst erzwungene Pushes in einen geschützten Branch erlauben. +title: Enabling force pushes to a protected branch +intro: You can allow force pushes to a protected branch. product: '{% data reusables.gated-features.protected-branches %}' versions: free-pro-team: '*' enterprise-server: '>=2.20' --- -Jeder Benutzer mit Administratorberechtigungen in einem Repository kann erzwungene Pushes aktivieren. +Anyone with admin permissions to a repository can enable force pushes. -### Über erzwungene Pushes zu geschützten Branches +### About force pushes to protected branches -Standardmäßig sind erzwungene Pushes auf allen geschützten Branches blockiert. Wenn Du erzwungene Pushes zu einem geschützten Branch aktivierst, kann jeder Benutzer mit mindestens Schreibberechtigungen im Repository Pushes zum Branch erzwingen, inbegriffen Benutzer mit Administratorberechtigungen. +By default, force pushes are blocked on all protected branches. When you enable force pushes to a protected branch, anyone with at least write permissions to the repository can force push to the branch, including those with admin permissions. -Das Aktivieren erzwungener Pushes wird keine anderen Branch-Schutzregeln überschreiben. Wenn ein Branch beispielsweise einen linearen Commit-Verlauf verlangt, kannst Du keine Merge-Commit-Pushes zu diesem Branch erzwingen. +Enabling force pushes will not override any other branch protection rules. For example, if a branch requires a linear commit history, you cannot force push merge commits to that branch. -{% if currentVersion != "free-pro-team@latest" %}Du kannst keine erzwungenen Pushes für einen geschützten Branch aktivieren, wenn ein Websiteadministrator erzwungene Pushes auf alle Branches in Deinem Repository blockiert hat. Weitere Informationen findest Du unter „[Blockieren von erzwungenen Pushes zu Repositorys, die einem Benutzerkonto oder einer Organisation gehören](/enterprise/{{ currentVersion }}/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization)." +{% if currentVersion != "free-pro-team@latest" %}You cannot enable force pushes for a protected branch if a site administrator has blocked force pushes to all branches in your repository. For more information, see "[Blocking force pushes to repositories owned by a user account or organization](/enterprise/{{ currentVersion }}/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization)." -Wenn ein Websiteadministrator erzwungene Pushes nur auf den Standardbranch blockiert hat, kannst Du erzwungene Pushes trotzdem für jeden anderen geschützten Branch aktivieren.{% endif %} +If a site administrator has blocked force pushes to the default branch only, you can still enable force pushes for any other protected branch.{% endif %} {% data reusables.repositories.protected-branches-options %} -### Erzwungene Pushes aktivieren +### Enabling force pushes {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.repositories.repository-branches %} {% data reusables.repositories.add-branch-protection-rules %} -6. Wähle unter „Rules applied to everyone including administrators" (Regeln für jedermann, Administratoren inbegriffen) **Allow force pushes** (Erlaube erzwungene Pushes). ![Option „Allow force pushes" (Erlaube erzwungene Pushes)](/assets/images/help/repository/allow-force-pushes.png) -7. Klicke auf **Create** (Erstellen). +6. Under "Rules applied to everyone including administrators", select **Allow force pushes**. +![Allow force pushes option](/assets/images/help/repository/allow-force-pushes.png) +7. Click **Create**. diff --git a/translations/de-DE/content/github/administering-a-repository/enabling-required-commit-signing.md b/translations/de-DE/content/github/administering-a-repository/enabling-required-commit-signing.md index 2ace8dfef6e2..e1e6b8e95726 100644 --- a/translations/de-DE/content/github/administering-a-repository/enabling-required-commit-signing.md +++ b/translations/de-DE/content/github/administering-a-repository/enabling-required-commit-signing.md @@ -1,6 +1,6 @@ --- title: Obligatorische Commit-Signatur aktivieren -intro: 'Repository-Administratoren können die obligatorische Commit-Signatur auf einem Branch erzwingen, um alle Commits zu blockieren, die nicht signiert und verifiziert sind.' +intro: Repository-Administratoren können die obligatorische Commit-Signatur auf einem Branch erzwingen, um alle Commits zu blockieren, die nicht signiert und verifiziert sind. product: '{% data reusables.gated-features.protected-branches %}' redirect_from: - /articles/enabling-required-commit-signing diff --git a/translations/de-DE/content/github/administering-a-repository/enabling-required-reviews-for-pull-requests.md b/translations/de-DE/content/github/administering-a-repository/enabling-required-reviews-for-pull-requests.md index 320bdeff6262..d00adeba8dec 100644 --- a/translations/de-DE/content/github/administering-a-repository/enabling-required-reviews-for-pull-requests.md +++ b/translations/de-DE/content/github/administering-a-repository/enabling-required-reviews-for-pull-requests.md @@ -1,6 +1,6 @@ --- title: Erforderliche Reviews für Pull-Requests aktivieren -intro: 'Repository-Administratoren können erforderliche Reviews vorschreiben, sodass Pull Requests eine bestimmte Anzahl an genehmigenden Reviews aufweisen müssen, bevor sie zusammengeführt werden.' +intro: Repository-Administratoren können erforderliche Reviews vorschreiben, sodass Pull Requests eine bestimmte Anzahl an genehmigenden Reviews aufweisen müssen, bevor sie zusammengeführt werden. product: '{% data reusables.gated-features.protected-branches %}' redirect_from: - /articles/enabling-required-reviews-for-pull-requests diff --git a/translations/de-DE/content/github/administering-a-repository/enabling-required-status-checks.md b/translations/de-DE/content/github/administering-a-repository/enabling-required-status-checks.md index edba43e84e7c..067c6cb617ae 100644 --- a/translations/de-DE/content/github/administering-a-repository/enabling-required-status-checks.md +++ b/translations/de-DE/content/github/administering-a-repository/enabling-required-status-checks.md @@ -1,6 +1,6 @@ --- title: Erforderliche Statuschecks aktivieren -intro: 'Repository-Administratoren können erforderliche Statuschecks erzwingen, bevor ein Branch in einen Pull Request zusammengeführt wird oder bevor Commits auf einem lokalen Branch an den geschützten Remote-Branch übertragen werden können.' +intro: Repository-Administratoren können erforderliche Statuschecks erzwingen, bevor ein Branch in einen Pull Request zusammengeführt wird oder bevor Commits auf einem lokalen Branch an den geschützten Remote-Branch übertragen werden können. product: '{% data reusables.gated-features.protected-branches %}' redirect_from: - /articles/enabling-required-status-checks diff --git a/translations/de-DE/content/github/administering-a-repository/index.md b/translations/de-DE/content/github/administering-a-repository/index.md index 104373a01cc4..f664019edb2a 100644 --- a/translations/de-DE/content/github/administering-a-repository/index.md +++ b/translations/de-DE/content/github/administering-a-repository/index.md @@ -27,6 +27,7 @@ versions: {% link_in_list /managing-the-forking-policy-for-your-repository %} + {% link_in_list /configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository %} {% link_in_list /disabling-or-limiting-github-actions-for-a-repository %} {% link_in_list /managing-git-lfs-objects-in-archives-of-your-repository %} {% link_in_list /enabling-anonymous-git-read-access-for-a-repository %} @@ -41,8 +42,8 @@ versions: {% link_in_list /restoring-a-deleted-repository %} {% topic_link_in_list /managing-branches-in-your-repository %} - {% link_in_list /setting-the-default-branch %} {% link_in_list /viewing-branches-in-your-repository %} + {% link_in_list /changing-the-default-branch %} {% link_in_list /deleting-and-restoring-branches-in-a-pull-request %} {% topic_link_in_list /configuring-pull-request-merges %} {% link_in_list /about-merge-methods-on-github %} diff --git a/translations/de-DE/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot.md b/translations/de-DE/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot.md index 4f1804684cc4..14dc16b8f23b 100644 --- a/translations/de-DE/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot.md +++ b/translations/de-DE/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot.md @@ -9,7 +9,7 @@ versions: ### About {% data variables.product.prodname_dependabot_version_updates %} for actions -Actions are often updated with bug fixes and new features to make automated processes more reliable, faster, and safer. When you enable {% data variables.product.prodname_dependabot_version_updates %} for {% data variables.product.prodname_actions %}, {% data variables.product.prodname_dependabot %} will help ensure that references to actions in a repository's *workflow.yml* file are kept up to date. For each action in the file, {% data variables.product.prodname_dependabot_short %} checks the action's reference (typically a version number or commit identifier associated with the action) against the latest version. If a more recent version of the action is available, {% data variables.product.prodname_dependabot_short %} will send you a pull request that updates the reference in the workflow file to the latest version. For more information about {% data variables.product.prodname_dependabot_version_updates %}, see "[About {% data variables.product.prodname_dependabot_version_updates %}](/github/administering-a-repository/about-github-dependabot-version-updates)." For more information about configuring workflows for {% data variables.product.prodname_actions %}, see "[Configuring a workflow](/actions/configuring-and-managing-workflows/configuring-a-workflow)." +Actions are often updated with bug fixes and new features to make automated processes more reliable, faster, and safer. When you enable {% data variables.product.prodname_dependabot_version_updates %} for {% data variables.product.prodname_actions %}, {% data variables.product.prodname_dependabot %} will help ensure that references to actions in a repository's *workflow.yml* file are kept up to date. For each action in the file, {% data variables.product.prodname_dependabot_short %} checks the action's reference (typically a version number or commit identifier associated with the action) against the latest version. If a more recent version of the action is available, {% data variables.product.prodname_dependabot_short %} will send you a pull request that updates the reference in the workflow file to the latest version. For more information about {% data variables.product.prodname_dependabot_version_updates %}, see "[About {% data variables.product.prodname_dependabot_version_updates %}](/github/administering-a-repository/about-github-dependabot-version-updates)." For more information about configuring workflows for {% data variables.product.prodname_actions %}, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." ### Enabling {% data variables.product.prodname_dependabot_version_updates %} for actions diff --git a/translations/de-DE/content/github/administering-a-repository/linking-to-releases.md b/translations/de-DE/content/github/administering-a-repository/linking-to-releases.md index 7366f5202f60..711de98491e0 100644 --- a/translations/de-DE/content/github/administering-a-repository/linking-to-releases.md +++ b/translations/de-DE/content/github/administering-a-repository/linking-to-releases.md @@ -1,6 +1,6 @@ --- title: Zu Releases verknüpfen -intro: 'Du kannst jeden Release, den Du auf GitHub erstellst, mit einer eindeutigen URL teilen.' +intro: Du kannst jeden Release, den Du auf GitHub erstellst, mit einer eindeutigen URL teilen. redirect_from: - /articles/linking-to-releases versions: diff --git a/translations/de-DE/content/github/administering-a-repository/managing-alerts-from-secret-scanning.md b/translations/de-DE/content/github/administering-a-repository/managing-alerts-from-secret-scanning.md index 0dc4d5f01cff..2af823c49d66 100644 --- a/translations/de-DE/content/github/administering-a-repository/managing-alerts-from-secret-scanning.md +++ b/translations/de-DE/content/github/administering-a-repository/managing-alerts-from-secret-scanning.md @@ -1,6 +1,6 @@ --- title: Warnungen von „secret scanning" (Durchsuchen nach Geheimnissen) verwalten -intro: 'Du kannst Warnungen für Geheimnisse, welche in Deinem Repository geprüft wurden, anschauen und schließen.' +intro: Du kannst Warnungen für Geheimnisse, welche in Deinem Repository geprüft wurden, anschauen und schließen. versions: free-pro-team: '*' --- diff --git a/translations/de-DE/content/github/administering-a-repository/managing-releases-in-a-repository.md b/translations/de-DE/content/github/administering-a-repository/managing-releases-in-a-repository.md index b7d593aba561..a0b9f8b1f7c9 100644 --- a/translations/de-DE/content/github/administering-a-repository/managing-releases-in-a-repository.md +++ b/translations/de-DE/content/github/administering-a-repository/managing-releases-in-a-repository.md @@ -1,6 +1,6 @@ --- title: Releases in einem Repository verwalten -intro: 'Du kennst Releases erstellen, um Iterationen eines Projektes zu bündeln und an Benutzer zu liefern.' +intro: Du kennst Releases erstellen, um Iterationen eines Projektes zu bündeln und an Benutzer zu liefern. redirect_from: - /articles/creating-releases - /articles/listing-and-editing-releases/ @@ -16,10 +16,11 @@ versions: ### About release management -You can also publish an action from a specific release in {% data variables.product.prodname_marketplace %}. For more information, see "[Publishing an action in the {% data variables.product.prodname_marketplace %}](/actions/creating-actions/publishing-actions-in-github-marketplace)." +You can also publish an action from a specific release in {% data variables.product.prodname_marketplace %}. For more information, see "    Publishing an action in the {% data variables.product.prodname_marketplace %}." {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -You can choose whether {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in the ZIP files and tarballs that {% data variables.product.product_name %} creates for each release. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)." +You can choose whether +{% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in the ZIP files and tarballs that {% data variables.product.product_name %} creates for each release. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)." {% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} @@ -42,7 +43,7 @@ You can choose whether {% data variables.large_files.product_name_long %} ({% da 8. Um Benutzer darüber zu informieren, dass der Release nicht produktionsbereit und möglicherweise instabil ist, wähle **This is a pre-release** (Dies ist eine Vorabversion). ![Kontrollkästchen für die Markierung eines Release als Vorab-Release](/assets/images/help/releases/prerelease_checkbox.png) 9. Wenn Du Deinen Release publizieren möchtest, klicke auf **Publish release** (Release publizieren). Um den Release später zu bearbeiten, klicke auf **Save draft** (Entwurf speichern). ![Schaltfläche „Publish release“ (Release veröffentlichen) und Schaltfläche zum Speichern als Entwurf](/assets/images/help/releases/release_buttons.png) -Du kannst auch automatisch einem Release aus der Kommandozeile oder in einem Skript erstellen. For more information, see "[Releases](/v3/repos/releases/#create-a-release)." +Du kannst auch automatisch einem Release aus der Kommandozeile oder in einem Skript erstellen. For more information, see "[Releases](/rest/reference/repos/#create-a-release)." ### Eine Veröffentlichung bearbeiten diff --git a/translations/de-DE/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md b/translations/de-DE/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md index c7d30886b1f0..ddd9d5199858 100644 --- a/translations/de-DE/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md +++ b/translations/de-DE/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md @@ -1,11 +1,11 @@ --- title: Automatische Löschung von Branches verwalten -intro: 'Du kannst festlegen, dass Head-Branches automatisch gelöscht werden, nachdem die Pull Requests in Deinem Repository zusammengeführt sind.' +intro: Du kannst festlegen, dass Head-Branches automatisch gelöscht werden, nachdem die Pull Requests in Deinem Repository zusammengeführt sind. redirect_from: - /articles/managing-the-automatic-deletion-of-branches versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- Personen mit Administratorberechtigungen für ein Repository können die automatische Löschung von Branches aktivieren oder deaktivieren. diff --git a/translations/de-DE/content/github/administering-a-repository/managing-the-forking-policy-for-your-repository.md b/translations/de-DE/content/github/administering-a-repository/managing-the-forking-policy-for-your-repository.md index c08904e8fc0e..8d1d403c65cc 100644 --- a/translations/de-DE/content/github/administering-a-repository/managing-the-forking-policy-for-your-repository.md +++ b/translations/de-DE/content/github/administering-a-repository/managing-the-forking-policy-for-your-repository.md @@ -1,6 +1,6 @@ --- title: Verwalten der Forking-Richtlinie für Dein Repository -intro: 'Du kannst das Forken eines bestimmten privaten{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} oder internen{% endif %} Repositorys einer Organisation erlauben oder verhindern.' +intro: 'You can allow or prevent the forking of a specific private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %} repository owned by an organization.' redirect_from: - /articles/allowing-people-to-fork-a-private-repository-owned-by-your-organization - /github/administering-a-repository/allowing-people-to-fork-a-private-repository-owned-by-your-organization @@ -10,7 +10,7 @@ versions: enterprise-server: '*' --- -Ein Organisationsinhaber muss Forks von privaten{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} und internen{% endif %} Repositorys auf der Organisationsebene erlauben, bevor Du Forks für ein bestimmtes Repository erlauben oder verbieten kannst. Weitere Informationen findest Du unter „[Die Forking-Richtlinie für Deine Organisation verwalten](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization)." +An organization owner must allow forks of private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and internal{% endif %} repositories on the organization level before you can allow or disallow forks for a specific repository. Weitere Informationen findest Du unter „[Die Forking-Richtlinie für Deine Organisation verwalten](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization)." {% data reusables.organizations.internal-repos-enterprise %} diff --git a/translations/de-DE/content/github/administering-a-repository/renaming-a-repository.md b/translations/de-DE/content/github/administering-a-repository/renaming-a-repository.md index 283ed9371ac7..c1baed344a51 100644 --- a/translations/de-DE/content/github/administering-a-repository/renaming-a-repository.md +++ b/translations/de-DE/content/github/administering-a-repository/renaming-a-repository.md @@ -1,6 +1,6 @@ --- title: Repository umbenennen -intro: 'Du kannst ein Repository umbenennen, wenn Du Organisationsinhaber bist oder über Administratorberechtigungen für das Repository verfügst.' +intro: Du kannst ein Repository umbenennen, wenn Du Organisationsinhaber bist oder über Administratorberechtigungen für das Repository verfügst. redirect_from: - /articles/renaming-a-repository versions: diff --git a/translations/de-DE/content/github/administering-a-repository/requiring-a-linear-commit-history.md b/translations/de-DE/content/github/administering-a-repository/requiring-a-linear-commit-history.md index a0ad3c6dba4f..8dbd9dc4b4c4 100644 --- a/translations/de-DE/content/github/administering-a-repository/requiring-a-linear-commit-history.md +++ b/translations/de-DE/content/github/administering-a-repository/requiring-a-linear-commit-history.md @@ -1,6 +1,6 @@ --- title: Einen linearen Commit-Verlauf verlangen -intro: 'Du kannst einen linearen Commit-Verlauf verlangen, um alle Merge-Commits eines geschützten Branches zu blockieren.' +intro: Du kannst einen linearen Commit-Verlauf verlangen, um alle Merge-Commits eines geschützten Branches zu blockieren. product: '{% data reusables.gated-features.protected-branches %}' versions: free-pro-team: '*' diff --git a/translations/de-DE/content/github/administering-a-repository/restoring-a-deleted-repository.md b/translations/de-DE/content/github/administering-a-repository/restoring-a-deleted-repository.md index b701fafc2c34..e2b3afe54a6b 100644 --- a/translations/de-DE/content/github/administering-a-repository/restoring-a-deleted-repository.md +++ b/translations/de-DE/content/github/administering-a-repository/restoring-a-deleted-repository.md @@ -1,6 +1,6 @@ --- title: Restoring a deleted repository -intro: 'Bestimmte gelöschte Repositorys können wiederhergestellt werden, sodass ihr Inhalt wieder zur Verfügung steht.' +intro: Bestimmte gelöschte Repositorys können wiederhergestellt werden, sodass ihr Inhalt wieder zur Verfügung steht. redirect_from: - /articles/restoring-a-deleted-repository versions: @@ -13,7 +13,7 @@ Alle Benutzer können gelöschte Repositorys wiederherstellen, die zu ihrem eige Ein gelöschte Repository kann innerhalb von 90 Tagen wiederhergestellt werden. Dies gilt allerdings nicht, wenn das Repository Teil eines Fork-Netzwerks war, das derzeit nicht leer ist. Ein Fork-Netzwerk besteht aus einem übergeordneten Repository, den Forks des Repositorys und den Forks dieser Repository-Forks. Wenn Dein Repository Teil eines Fork-Netzwerks war, kann es nur dann wiederhergestellt werden, wenn alle anderen Repositorys im Netzwerk gelöscht oder vom Netzwerk getrennt wurden. Weitere Informationen zu Forks findest Du unter „[Informationen zu Forks](/articles/about-forks).“ -Soll ein Repository wiederhergestellt werden, das Teil eines derzeit nicht leeren Fork-Netzwerks war, wende Dich an {% data variables.contact.contact_support %}. +Soll ein Repository wiederhergestellt werden, das Teil eines derzeit nicht leeren Fork-Netzwerks war, wenden Sie sich an {% data variables.contact.contact_support %}. Wenn Du ein Repository löschst, kann es bis zu einer Stunde dauern, bis dieses Repository wiederhergestellt werden kann. diff --git a/translations/de-DE/content/github/administering-a-repository/setting-repository-visibility.md b/translations/de-DE/content/github/administering-a-repository/setting-repository-visibility.md index c25e2ae87790..41e916b277f5 100644 --- a/translations/de-DE/content/github/administering-a-repository/setting-repository-visibility.md +++ b/translations/de-DE/content/github/administering-a-repository/setting-repository-visibility.md @@ -1,6 +1,6 @@ --- title: Sichtbarkeit eines Repositorys festlegen -intro: 'Du kannst festlegen, wer Dein Repository anzeigen kann.' +intro: Du kannst festlegen, wer Dein Repository anzeigen kann. redirect_from: - /articles/making-a-private-repository-public/ - /articles/making-a-public-repository-private/ @@ -21,14 +21,14 @@ We recommend reviewing the following caveats before you change the visibility of * {% data variables.product.prodname_dotcom %} will detach public forks of the public repository and put them into a new network. Öffentliche Forks werden nicht in private Forks umgewandelt. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}If you change a repository's visibility from internal to private, {% data variables.product.prodname_dotcom %} will remove forks that belong to any user without access to the newly private repository.{% endif %} For more information, see "[What happens to forks when a repository is deleted or changes visibility?](/articles/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility#changing-a-public-repository-to-a-private-repository)" {% if currentVersion == "free-pro-team@latest" %}* If you're using {% data variables.product.prodname_free_user %} for user accounts or organizations, some features won't be available in the repository after you change the visibility to private. {% data reusables.gated-features.more-info %} - * Jede veröffentlichte {% data variables.product.prodname_pages %}-Website wird automatisch zurückgezogen. Wenn Du eine benutzerdefinierte Domäne zur {% data variables.product.prodname_pages %}-Website hinzugefügt hast, solltest Du Deine DNS-Einträge entfernen oder aktualisieren, bevor Du das Repository als privat markierst, um das Risiko einer Domänenübernahme auszuschließen. Weitere Informationen findest Du unter „[Eine benutzerdefinierte Domäne für Deine {% data variables.product.prodname_pages %}-Website verwalten](/articles/managing-a-custom-domain-for-your-github-pages-site).“ + * Jede veröffentlichte {% data variables.product.prodname_pages %}-Website wird automatisch zurückgezogen. Wenn Sie Ihrer {% data variables.product.prodname_pages %}-Website eine benutzerdefinierte Domain hinzugefügt hatten, sollten Sie Ihre DNS-Einträge vor der Umschaltung des Repositorys in ein privates Repository entfernen oder aktualisieren, um das Risiko eines Domain-Takeovers auszuschließen. Weitere Informationen findest Du unter „[Eine benutzerdefinierte Domäne für Deine {% data variables.product.prodname_pages %}-Website verwalten](/articles/managing-a-custom-domain-for-your-github-pages-site).“ * {% data variables.product.prodname_dotcom %} will no longer included the repository in the {% data variables.product.prodname_archive %}. For more information, see "[About archiving content and data on {% data variables.product.prodname_dotcom %}](/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github#about-the-github-archive-program)."{% endif %} {% if currentVersion != "free-pro-team@latest" %}* Anonymous Git read access is no longer available. For more information, see "[Enabling anonymous Git read access for a repository](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)."{% endif %} #### Repository als öffentlich festlegen * {% data variables.product.prodname_dotcom %} will detach private forks and turn them into a standalone private repository. Weitere Informationen findest Du unter „[Was geschieht mit Forks, wenn ein Repository gelöscht wird oder sich dessen Sichtbarkeit ändert?](/articles/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility#changing-a-private-repository-to-a-public-repository).“ - * Wenn Du im Zuge der Erstellung eines Open-Source-Projekts ein privates Repository in ein öffentliches Repository konvertieren möchtest, findest Du in den [Open-Source-Leitfäden](http://opensource.guide) nützliche Tipps und Richtlinien.{% if currentVersion == "free-pro-team@latest" %} Gerne kannst Du Dich auf [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}) auch zu einem kostenlosen Kurs zur Verwaltung eines Open-Source-Projekts anmelden. Sobald Dein Repository der Öffentlichkeit zugänglich ist, kannst Du im Community-Profil des Repositorys überprüfen, ob Dein Projekt die Best Practices zur Unterstützung von Mitarbeitern erfüllt. Weitere Informationen finden Sie unter „[Community-Profil anzeigen](/articles/viewing-your-community-profile)“.{% endif %} + * If you're converting your private repository to a public repository as part of a move toward creating an open source project, see the [Open Source Guides](http://opensource.guide) for helpful tips and guidelines.{% if currentVersion == "free-pro-team@latest" %} You can also take a free course on managing an open source project with [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}). Sobald Dein Repository der Öffentlichkeit zugänglich ist, kannst Du im Community-Profil des Repositorys überprüfen, ob Dein Projekt die Best Practices zur Unterstützung von Mitarbeitern erfüllt. Weitere Informationen finden Sie unter „[Community-Profil anzeigen](/articles/viewing-your-community-profile)“.{% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} diff --git a/translations/de-DE/content/github/administering-a-repository/transferring-a-repository.md b/translations/de-DE/content/github/administering-a-repository/transferring-a-repository.md index 3465f4de0faa..5deb25ef1178 100644 --- a/translations/de-DE/content/github/administering-a-repository/transferring-a-repository.md +++ b/translations/de-DE/content/github/administering-a-repository/transferring-a-repository.md @@ -21,14 +21,14 @@ versions: Wenn Du ein Repository auf einen neuen Inhaber überträgst, kann dieser die Inhalte, Issues, Pull Requests, Releases, Projektboards und Einstellungen des Repositorys sofort verwalten. -Voraussetzungen für die Übertragung eines Repositorys: {% if currentVersion == "free-pro-team@latest" %} +Prerequisites for repository transfers: {% if currentVersion == "free-pro-team@latest" %} - Wenn Du ein Dir gehörendes Repository auf ein anderes Benutzerkonto überträgst, erhält der neue Inhaber eine Bestätigungs-E-Mail. Die Bestätigungs-E-Mail enthält Anweisungen zum Annehmen dieser Übertragung. Nimmt der neue Inhaber die Übertragung nicht innerhalb eines Tages an, läuft die Einladung ab.{% endif %} - Wenn Du ein Dir gehörendes Repository einer Organisation überträgst, musst Du die Berechtigung besitzen, ein Repository in der Zielorganisation zu erstellen. - Unter dem Zielkonto darf kein Repository mit gleichem Namen und kein Fork im gleichen Netzwerk vorhanden sein. - Der ursprüngliche Inhaber des Repositorys wird dem übertragenen Repository als Mitarbeiter hinzugefügt. Andere Mitarbeiter des übertragenen Repositorys bleiben unverändert. - Private Forks können nicht übertragen werden. -{% if currentVersion == "free-pro-team@latest" %}Wenn Du ein privates Repository auf ein {% data variables.product.prodname_free_user %}-Benutzer- oder -Organisationskonto überträgst, verliert das Repository den Zugriff auf Funktionen wie beispielsweise geschützte Branches und {% data variables.product.prodname_pages %}. {% data reusables.gated-features.more-info %}{% endif %} +{% if currentVersion == "free-pro-team@latest" %}If you transfer a private repository to a {% data variables.product.prodname_free_user %} user or organization account, the repository will lose access to features like protected branches and {% data variables.product.prodname_pages %}. {% data reusables.gated-features.more-info %}{% endif %} #### Was wird mit einem Repository übertragen? @@ -36,7 +36,7 @@ Bei der Übertragung eines Repositorys werden auch seine Issues, Pull Requests, - Wenn das übertragene Repository ein Fork ist, bleibt es mit dem vorgelagerten Repository verknüpft. - Wenn zu dem übertragenen Repository Forks gehören, bleiben diese Forks auch nach der Übertragung mit dem Repository verknüpft. -- Wenn das übertragene Repository {% data variables.large_files.product_name_long %} verwendet, werden alle {% data variables.large_files.product_name_short %}-Objekte automatisch verschoben. Diese Übertragung findet im Hintergrund statt. Falls Du also sehr viele {% data variables.large_files.product_name_short %}-Objekte hast, oder wenn die {% data variables.large_files.product_name_short %}-Objekte selber sehr gross sind, kann die Übertragung eine Weile dauern.{% if currentVersion == "free-pro-team@latest" %} Wenn ein Repository {% data variables.large_files.product_name_short %} verwendet, stelle vor der Übertragung sicher, dass das empfangende Konto über ausreichend Datenpakete zum Speichern der verschobenen {% data variables.large_files.product_name_short %}-Objekte verfügt. Informationen zum Hinzufügen von Speicher zu Benutzerkonten findest Du unter „[Upgrade von {% data variables.large_files.product_name_long %}](/articles/upgrading-git-large-file-storage).“{% endif %} +- Wenn das übertragene Repository {% data variables.large_files.product_name_long %} verwendet, werden alle {% data variables.large_files.product_name_short %}-Objekte automatisch verschoben. This transfer occurs in the background, so if you have a large number of {% data variables.large_files.product_name_short %} objects or if the {% data variables.large_files.product_name_short %} objects themselves are large, it may take some time for the transfer to occur.{% if currentVersion == "free-pro-team@latest" %} Before you transfer a repository that uses {% data variables.large_files.product_name_short %}, make sure the receiving account has enough data packs to store the {% data variables.large_files.product_name_short %} objects you'll be moving over. Informationen zum Hinzufügen von Speicher zu Benutzerkonten findest Du unter „[Upgrade von {% data variables.large_files.product_name_long %}](/articles/upgrading-git-large-file-storage).“{% endif %} - Bei der Übertragung eines Repositorys zwischen zwei Benutzerkonten bleiben die Issuezuweisungen erhalten. Bei der Übertragung eines Repositorys von einem Benutzerkonto zu einer Organisation bleiben Issues, die Organisationsmitgliedern zugewiesen sind, erhalten, während alle anderen Issuebearbeiter entfernt werden. Nur die Inhaber der Organisation dürfen neue Issuezuweisungen erstellen. Bei der Übertragung eines Repositorys von einer Organisation auf ein Benutzerkonto bleiben nur die dem Repository-Inhaber zugewiesenen Issues erhalten, während alle anderen Issuebearbeiter entfernt werden. - Wenn das übertragene Repository eine {% data variables.product.prodname_pages %}-Website enthält, werden Links zum Git-Repository im Web und Links über Git-Aktivitäten weitergeleitet. Mit dem Repository verknüpfte {% data variables.product.prodname_pages %} werden hingegen nicht weitergeleitet. - Alle Links zum früheren Repository-Standort werden automatisch zum neuen Standort weitergeleitet. Wenn Du die Befehle `git clone`, `git fetch` oder `git push` für ein übertragenes Repository ausführst, werden diese Befehle an den neuen Standort oder die neue URL des Repositorys weitergeleitet. Um Verwirrung zu vermeiden, empfehlen wir jedoch, alle bestehenden lokalen Klone entsprechend zu aktualisieren, so dass sie auf die neue Repository-URL verweisen. Hierzu verwendest Du den Befehl `git remote` in der Befehlszeile: @@ -57,7 +57,7 @@ Für ein in eine Organisation übertragenes Repository gelten die in der Organis Du kannst Dein Repository an jedes Benutzerkonto übertragen, das die Übertragung annimmt. Wenn ein Repository zwischen zwei Benutzerkonten übertragen wird, werden der bisherige Inhaber und die Mitarbeiter des Repositorys dem neuen Repository automatisch als Mitarbeiter hinzugefügt. -{% if currentVersion == "free-pro-team@latest" %}Wenn Du in einem privaten Repository eine {% data variables.product.prodname_pages %}-Website mit einer benutzerdefinierten Domäne veröffentlicht hast, solltest Du Deine DNS-Einträge vor der Übertragung des Repositorys entfernen oder aktualisieren, um das Risiko einer Domänenübernahme auszuschließen. Weitere Informationen finden Sie unter „[Eine benutzerdefinierte Domain für Ihre {% data variables.product.prodname_pages %}-Website verwalten](/articles/managing-a-custom-domain-for-your-github-pages-site)“.{% endif %} +{% if currentVersion == "free-pro-team@latest" %}If you published a {% data variables.product.prodname_pages %} site in a private repository and added a custom domain, before transferring the repository, you may want to remove or update your DNS records to avoid the risk of a domain takeover. Weitere Informationen findest Du unter „[Eine benutzerdefinierte Domäne für Deine {% data variables.product.prodname_pages %}-Website verwalten](/articles/managing-a-custom-domain-for-your-github-pages-site)“.{% endif %} {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} diff --git a/translations/de-DE/content/github/administering-a-repository/types-of-required-status-checks.md b/translations/de-DE/content/github/administering-a-repository/types-of-required-status-checks.md index fad57efa4fab..22b7de165dab 100644 --- a/translations/de-DE/content/github/administering-a-repository/types-of-required-status-checks.md +++ b/translations/de-DE/content/github/administering-a-repository/types-of-required-status-checks.md @@ -1,6 +1,6 @@ --- title: Arten erforderlicher Statuschecks -intro: 'Du kannst die erforderlichen Statusprüfungen entweder als "loose" (locker) oder als "strict" (streng) einrichten. Die Art der erforderlichen Statuschecks bestimmt, ob Dein Branch vor dem Zusammenführen auf dem aktuellen Stand mit dem Basisbranch sein muss.' +intro: Du kannst die erforderlichen Statusprüfungen entweder als "loose" (locker) oder als "strict" (streng) einrichten. Die Art der erforderlichen Statuschecks bestimmt, ob Dein Branch vor dem Zusammenführen auf dem aktuellen Stand mit dem Basisbranch sein muss. product: '{% data reusables.gated-features.protected-branches %}' redirect_from: - /articles/types-of-required-status-checks diff --git a/translations/de-DE/content/github/authenticating-to-github/about-anonymized-image-urls.md b/translations/de-DE/content/github/authenticating-to-github/about-anonymized-image-urls.md index 0d49ea2fa949..eb03fbcb3571 100644 --- a/translations/de-DE/content/github/authenticating-to-github/about-anonymized-image-urls.md +++ b/translations/de-DE/content/github/authenticating-to-github/about-anonymized-image-urls.md @@ -1,6 +1,6 @@ --- title: Informationen zu anonymisierten Bild-URLs -intro: 'Wenn Du ein Bild auf {% data variables.product.product_name %} hochlädst, wird die URL des Bildes geändert, sodass Deine Informationen nicht rückverfolgbar sind.' +intro: 'Wenn Sie ein Bild auf {% data variables.product.product_name %} hochladen, wird die URL des Bildes geändert, sodass Ihre Informationen nicht rückverfolgbar sind.' redirect_from: - /articles/why-do-my-images-have-strange-urls/ - /articles/about-anonymized-image-urls diff --git a/translations/de-DE/content/github/authenticating-to-github/about-authentication-to-github.md b/translations/de-DE/content/github/authenticating-to-github/about-authentication-to-github.md index 9c0732841d73..6243603d93c4 100644 --- a/translations/de-DE/content/github/authenticating-to-github/about-authentication-to-github.md +++ b/translations/de-DE/content/github/authenticating-to-github/about-authentication-to-github.md @@ -16,7 +16,6 @@ You can access your resources in {% data variables.product.product_name %} in a - Personal access token - SSH-Schlüssel - ### Authenticating in your browser You can authenticate to {% data variables.product.product_name %} in your browser in different ways. diff --git a/translations/de-DE/content/github/authenticating-to-github/about-commit-signature-verification.md b/translations/de-DE/content/github/authenticating-to-github/about-commit-signature-verification.md index 8e87b9246eea..013df4138eba 100644 --- a/translations/de-DE/content/github/authenticating-to-github/about-commit-signature-verification.md +++ b/translations/de-DE/content/github/authenticating-to-github/about-commit-signature-verification.md @@ -1,6 +1,6 @@ --- title: Informationen zur Verifizierung einer Commit-Signatur -intro: 'Mit GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} oder S/MIME{% endif %} kannst Du Tags und Commits lokal signieren. Diese Tags oder Commits werden auf {% data variables.product.product_name %} als verifiziert gekennzeichnet, sodass andere Personen darauf vertrauen können, dass die Änderungen aus einer vertrauenswürdigen Quelle stammen.' +intro: 'Using GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} or S/MIME{% endif %}, you can sign tags and commits locally. Diese Tags oder Commits werden auf {% data variables.product.product_name %} als verifiziert gekennzeichnet, sodass andere Personen darauf vertrauen können, dass die Änderungen aus einer vertrauenswürdigen Quelle stammen.' redirect_from: - /articles/about-gpg-commit-and-tag-signatures/ - /articles/about-gpg/ @@ -22,7 +22,7 @@ Repository-Administratoren können die obligatorische Commit-Signatur auf einem Du kannst den Verifizierungsstatus Deines signierten Commits oder Tags auf {% data variables.product.product_name %} überprüfen und sehen, warum Deine Commit-Signaturen möglicherweise nicht verifiziert sind. Weitere Informationen findest Du unter „[Verifizierungsstatus Deiner Commit- und Tag-Signaturen überprüfen](/articles/checking-your-commit-and-tag-signature-verification-status).“ -{% if currentVersion == "free-pro-team@latest" %} {% data variables.product.product_name %} wird automatisch GPG verwenden, um Commits zu signieren, die Du über das {% data variables.product.product_name %} Web-Interface machst, ausgenommen wenn Du einen Pull Request squashen und zusammenführen willst, für den Du nicht der Autor bist. Commits, die von {% data variables.product.product_name %} signiert sind, werden auf {% data variables.product.product_name %} einen verifizierten Status haben. Du kannst die Signatur lokal mit dem unter https://github.com/web-flow.gpg verfügbaren öffentlichen Schlüssel verifizieren.{% endif %} +{% if currentVersion == "free-pro-team@latest" %} {% data variables.product.product_name %} will automatically use GPG to sign commits you make using the {% data variables.product.product_name %} web interface, except for when you squash and merge a pull request that you are not the author of. Commits, die von {% data variables.product.product_name %} signiert sind, werden auf {% data variables.product.product_name %} einen verifizierten Status haben. Du kannst die Signatur lokal mit dem unter https://github.com/web-flow.gpg verfügbaren öffentlichen Schlüssel verifizieren.{% endif %} ### GPG-Verifizierung einer Commit-Signatur @@ -59,8 +59,9 @@ Du musst Deinen öffentlichen Schlüssel nicht auf {% data variables.product.pro ### Signaturverifizierung für Bots Organisationen und {% data variables.product.prodname_github_app %}s, bei denen Commit-Signaturen vorgeschrieben sind, können Bots für das Signieren von Commits verwenden. Wenn ein Commit oder Tag eine Bot-Signatur hat, die kryptografisch verifiziert werden kann, wird der Commit oder das Tag von {% data variables.product.product_name %} als verifiziert gekennzeichnet. +Signature verification for bots will only work if the request is verified and authenticated as the -Die Signaturverifizierung für Bots funktioniert nur, wenn die Anforderung als {% data variables.product.prodname_github_app %} oder Bot verifiziert und authentifiziert ist und keine benutzerdefinierten Informationen zum Autor, zum Beitragenden oder zur Signatur aufweist, wie zum Beispiel Commits-API. +{% data variables.product.prodname_github_app %} or bot and contains no custom author information, custom committer information, and no custom signature information, such as Commits API. {% endif %} ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/authenticating-to-github/about-githubs-ip-addresses.md b/translations/de-DE/content/github/authenticating-to-github/about-githubs-ip-addresses.md index 3d7528bfee17..03535272573d 100644 --- a/translations/de-DE/content/github/authenticating-to-github/about-githubs-ip-addresses.md +++ b/translations/de-DE/content/github/authenticating-to-github/about-githubs-ip-addresses.md @@ -1,6 +1,6 @@ --- title: Informationen zu den IP-Adressen von GitHub -intro: '{% data variables.product.product_name %} dient Anwendungen aus mehreren IP-Adressbereichen, die über die API verfügbar sind.' +intro: '{% data variables.product.product_name %} versorgt Anwendungen aus mehreren IP-Adressbereichen, die über die API verfügbar sind.' redirect_from: - /articles/what-ip-addresses-does-github-use-that-i-should-whitelist/ - /categories/73/articles/ @@ -12,7 +12,7 @@ versions: free-pro-team: '*' --- -Du kannst eine Liste der IP-Adressen von {% data variables.product.prodname_dotcom %} über den [meta](https://api.github.com/meta)-API-Endpunkt abrufen. For more information, see "[Meta](/v3/meta/)." +Sie können eine Liste der IP-Adressen von {% data variables.product.prodname_dotcom %} über den [meta](https://api.github.com/meta)-API-Endpunkt abrufen. For more information, see "[Meta](/v3/meta/)." Diese Bereiche sind in [CIDR-Notation](https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing#CIDR_notation). Mit einem Online-Konvertierungstool wie zum Beispiel [CIDR/VLSM Supernet Calculator](http://www.subnet-calculator.com/cidr.php) kannst Du eine Konvertierung von CIDR-Notation in IP-Adressbereiche durchführen. diff --git a/translations/de-DE/content/github/authenticating-to-github/about-ssh.md b/translations/de-DE/content/github/authenticating-to-github/about-ssh.md index 4b64e420d42d..57f0c8216a54 100644 --- a/translations/de-DE/content/github/authenticating-to-github/about-ssh.md +++ b/translations/de-DE/content/github/authenticating-to-github/about-ssh.md @@ -1,6 +1,6 @@ --- title: Informationen zu SSH -intro: 'Mithilfe des SSH-Protokolls kannst Du eine Verbindung herstellen und Dich bei Remote-Servern und -Diensten authentifizieren. Mit SSH-Schlüsseln kannst Du Dich mit {% data variables.product.product_name %} verbinden, ohne jedes Mal Deinen Benutzernamen oder Dein Passwort angeben zu müssen.' +intro: 'Mithilfe des SSH-Protokolls kannst Du eine Verbindung herstellen und Dich bei Remote-Servern und -Diensten authentifizieren. Mit SSH-Schlüsseln können Sie sich mit {% data variables.product.product_name %} verbinden, ohne jedes Mal Ihren Benutzernamen oder Ihr Passwort angeben zu müssen.' redirect_from: - /articles/about-ssh versions: @@ -8,19 +8,18 @@ versions: enterprise-server: '*' --- -Wenn Du SSH einrichtest, wirst Du [einen SSH-Schlüssel generieren und ihn dem SSH-Agenten hinzufügen](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent). Danach [füge den Schlüssel zu Deinem {% data variables.product.product_name %}-Konto hinzu](/articles/adding-a-new-ssh-key-to-your-github-account). Durch das Hinzufügen des SSH-Schlüssels zum SSH-Agenten wird sichergestellt, dass Dein SSH-Schlüssel durch die Verwendung einer Passphrase eine zusätzliche Sicherheitsebene hat. Weitere Informationen findest Du unter „[SSH-Schlüssel-Passphrasen verwenden](/articles/working-with-ssh-key-passphrases).“ +Wenn Sie die SSH einrichten, [generieren Sie einen SSH-Schlüssel und fügen ihn zu ssh-agent hinzu](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent). Dann [fügen Sie den Schlüssel zu Ihrem {% data variables.product.product_name %}-Konto hinzu](/articles/adding-a-new-ssh-key-to-your-github-account). Durch das Hinzufügen des SSH-Schlüssels zum SSH-Agenten wird sichergestellt, dass Dein SSH-Schlüssel durch die Verwendung einer Passphrase eine zusätzliche Sicherheitsebene hat. Weitere Informationen findest Du unter „[SSH-Schlüssel-Passphrasen verwenden](/articles/working-with-ssh-key-passphrases).“ -{% if currentVersion == "free-pro-team@latest" %}Um Deinen SSH-Schlüssel in einem Repository zu verwenden, das sich im Besitz einer SAML Single Sign-On verwendenden Organisation befindet, musst Du ihn zuerst autorisieren. Weitere Informationen findest Du unter „[Einen SSH-Schlüssel für die Verwendung in einer Organisation mit SAML Single Sign-On autorisieren](/articles/authorizing-an-ssh-key-for-use-with-saml-single-sign-on)“.{% endif %} +{% if currentVersion == "free-pro-team@latest" %}To use your SSH key with a repository owned by an organization that uses SAML single sign-on, you'll need to authorize it first. Weitere Informationen findest Du unter „[Einen SSH-Schlüssel für die Verwendung in einer Organisation mit SAML Single Sign-On autorisieren](/articles/authorizing-an-ssh-key-for-use-with-saml-single-sign-on)“.{% endif %} Du solltest regelmäßig [Deine Liste mit SSH-Schlüsseln überprüfen](/articles/reviewing-your-ssh-keys) und ungültige oder kompromittierte Schlüssel widerrufen. {% if currentVersion == "free-pro-team@latest" %} -Wenn Du Deinen SSH-Schlüssel seit einem Jahr nicht mehr verwendet hast, löscht {% data variables.product.prodname_dotcom %} aus Sicherheitsgründen automatisch Deinen inaktiven SSH-Schlüssel. Weitere Informationen findest Du unter „[Gelöschte oder fehlende SSH-Schlüssel](/articles/deleted-or-missing-ssh-keys).“ +If you haven't used your SSH key for a year, then +{% data variables.product.prodname_dotcom %} will automatically delete your inactive SSH key as a security precaution. Weitere Informationen findest Du unter „[Gelöschte oder fehlende SSH-Schlüssel](/articles/deleted-or-missing-ssh-keys).“ {% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -Wenn Du Mitglied einer Organisation bist, die SSH-Zertifikate bereitstellt, kannst Du mit Deinem Zertifikat auf die Repositorys dieser Organisation zugreifen, ohne das Zertifikat zu Deinem {% data variables.product.product_name %}-Konto hinzuzufügen. Weitere Informationen findest Du unter „[Informationen zu SSH-Zertifizierungsstellen](/articles/about-ssh-certificate-authorities).“ -{% endif %} +Wenn Sie Mitglied einer Organisation sind, die SSH-Zertifikate bereitstellt, können Sie mit Ihrem Zertifikat auf die Repositorys dieser Organisation zugreifen, ohne das Zertifikat zu Ihrem {% data variables.product.product_name %}-Konto hinzuzufügen. Weitere Informationen findest Du unter „[Informationen zu SSH-Zertifizierungsstellen](/articles/about-ssh-certificate-authorities).“ ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/authenticating-to-github/about-two-factor-authentication.md b/translations/de-DE/content/github/authenticating-to-github/about-two-factor-authentication.md index 88fb4f80a170..f9cb1e168c68 100644 --- a/translations/de-DE/content/github/authenticating-to-github/about-two-factor-authentication.md +++ b/translations/de-DE/content/github/authenticating-to-github/about-two-factor-authentication.md @@ -1,6 +1,6 @@ --- title: Informationen zur Zwei-Faktor-Authentifizierung -intro: 'Die Zwei-Faktor-Authentifizierung (oder 2FA) ist eine zusätzliche Sicherheitsebene, die bei der Anmeldung bei Websites oder Apps verwendet wird. Mit 2FA musst Du Dich mit Deinem Benutzernamen und Passwort anmelden und eine weitere Form der Authentifizierung bereitstellen, die nur Du kennst oder auf die nur Du Zugriff hast.' +intro: '{% data reusables.two_fa.about-2fa %} With 2FA, you have to log in with your username and password and provide another form of authentication that only you know or have access to.' redirect_from: - /articles/about-two-factor-authentication versions: @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -Bei {% data variables.product.product_name %} ist die zweite Form der Authentifizierung ein Code, der von einer Anwendung auf Deinem mobilen Gerät generiert{% if currentVersion == "free-pro-team@latest" %} oder Dir als Textnachricht (SMS) gesendet{% endif %} wird. Nachdem Du die 2FA aktiviert hast, generiert {% data variables.product.product_name %} jedes Mal einen Authentifizierungscode, wenn sich jemand bei Deinem {% data variables.product.product_name %}-Konto anmelden möchte. Eine Anmeldung bei Deinem Konto ist nur möglich, wenn jemand sowohl Dein Passwort kennt als auch Zugriff auf den Authentifizierungscode auf Deinem Telefon hat. +For {% data variables.product.product_name %}, the second form of authentication is a code that's generated by an application on your mobile device{% if currentVersion == "free-pro-team@latest" %} or sent as a text message (SMS){% endif %}. Nachdem Sie die Zwei-Faktor-Authentifizierung aktiviert haben, generiert {% data variables.product.product_name %} einen Authentifizierungscode, wenn sich jemand bei Ihrem {% data variables.product.product_name %}-Konto anmelden möchte. Eine Anmeldung bei Deinem Konto ist nur möglich, wenn jemand sowohl Dein Passwort kennt als auch Zugriff auf den Authentifizierungscode auf Deinem Telefon hat. {% data reusables.two_fa.after-2fa-add-security-key %} @@ -34,6 +34,6 @@ Weitere Informationen findest Du unter „[Mit Zwei-Faktor-Authentifizierung auf ### Zwei-Faktor-Authentifizierung in Deiner Organisation erzwingen -Organisationsinhaber könnnen verlangen, dass Organisationsmitglieder{% if currentVersion == "free-pro-team@latest" %}, Abrechnungsmanager,{% endif %} und externe Mitarbeiter die Zwei-Faktor-Authentifizierung verwenden, um ihre persönlichen Konten zu schützen. Weitere Informationen finden Sie unter „[Zwei-Faktor-Authentifizierung in Ihrer Organisation erzwingen](/articles/requiring-two-factor-authentication-in-your-organization)“. +Organization owners can require that organization members{% if currentVersion == "free-pro-team@latest" %}, billing managers,{% endif %} and outside collaborators use two-factor authentication to secure their personal accounts. Weitere Informationen finden Sie unter „[Zwei-Faktor-Authentifizierung in Ihrer Organisation erzwingen](/articles/requiring-two-factor-authentication-in-your-organization)“. {% data reusables.two_fa.auth_methods_2fa %} diff --git a/translations/de-DE/content/github/authenticating-to-github/accessing-github-using-two-factor-authentication.md b/translations/de-DE/content/github/authenticating-to-github/accessing-github-using-two-factor-authentication.md index 344645b24340..c37580e11162 100644 --- a/translations/de-DE/content/github/authenticating-to-github/accessing-github-using-two-factor-authentication.md +++ b/translations/de-DE/content/github/authenticating-to-github/accessing-github-using-two-factor-authentication.md @@ -15,13 +15,13 @@ With two-factor authentication enabled, you'll need to provide an authentication ### Einen 2FA-Code bei der Anmeldung in die Website bereitstellen -Nachdem Du Dich mit Deinem Passwort bei {% data variables.product.product_name %} angemeldet hast, wirst Du aufgefordert, einen Authentifizierungscode aus {% if currentVersion == "free-pro-team@latest" %}einer SMS oder {% endif %}Deiner TOTP-App einzugeben. +After you sign in to {% data variables.product.product_name %} using your password, you'll be prompted to provide an authentication code from {% if currentVersion == "free-pro-team@latest" %}a text message or{% endif %} your TOTP app. -Nachdem Du Dich mit Deinem Passwort bei {% data variables.product.product_name %} angemeldet hast, wirst Du erst dann wieder aufgefordert, Deinen 2FA-Authentifizierungscode anzugeben, wenn Du Dich abgemeldet hast, ein neues Gerät verwendest oder Deine Sitzung abläuft. +Nachdem Sie sich mit Ihrem Passwort bei {% data variables.product.product_name %} angemeldet haben, werden Sie erst dann wieder aufgefordert, Ihren Authentifizierungscode für die Zwei-Faktor-Authentifizierung anzugeben, wenn Sie sich abgemeldet haben, ein neues Gerät verwenden oder Ihre Sitzung abläuft. #### Einen Code über eine TOTP-Anwendung generieren -Wenn Du Dich dafür entschieden hast, die Zwei-Faktor-Authentifizierung mit einer TOTP-Anwendung auf Deinem Smartphone einzurichten, kannst Du jederzeit einen Authentifizierungscode für {% data variables.product.product_name %} generieren. In den meisten Fällen wird beim bloßen Starten der Anwendung ein neuer Code generiert. Spezifische Anweisungen findest Du in der Dokumentation Deiner Anwendung. +Wenn Sie sich dafür entschieden haben, die Zwei-Faktor-Authentifizierung mit einer TOTP-Anwendung auf Ihrem Smartphone einzurichten, können Sie jederzeit einen Authentifizierungscode für {% data variables.product.product_name %} generieren. In den meisten Fällen wird beim bloßen Starten der Anwendung ein neuer Code generiert. Spezifische Anweisungen findest Du in der Dokumentation Deiner Anwendung. Wenn Du die mobile Anwendung nach der Konfiguration der Zwei-Faktor-Authentifizierung löschst, musst Du Deinen Wiederherstellungscode angeben, um Zugriff auf Dein Konto zu erhalten. Weitere Informationen findest Du unter „[Dein Konto beim Verlust der Anmeldeinformationen für die Zwei-Faktor-Authentifizierung wiederherstellen](/articles/recovering-your-account-if-you-lose-your-2fa-credentials),“ @@ -29,7 +29,7 @@ Wenn Du die mobile Anwendung nach der Konfiguration der Zwei-Faktor-Authentifizi #### Eine SMS empfangen -Wenn Du die Zwei-Faktor-Authentifizierung per SMS einrichtest, sendet Dir {% data variables.product.product_name %} eine SMS mit Deinem Authentifizierungscode. +Wenn Sie die Zwei-Faktor-Authentifizierung per SMS einrichten, sendet Ihnen {% data variables.product.product_name %} eine SMS mit Ihrem Authentifizierungscode. {% endif %} @@ -41,7 +41,7 @@ Nachdem Sie die Zwei-Faktor-Authentifizierung aktiviert haben, müssen Sie beim Nachdem Sie die Zwei-Faktor-Authentifizierung aktiviert haben, müssen Sie bei der Authentifizierung bei {% data variables.product.product_name %} in der Befehlszeile über HTTPS-URLs ein persönliches Zugriffstoken erstellen, das Sie als Passwort verwenden können. -Wenn Sie in der Befehlszeile nach einem Benutzernamen und einem Passwort gefragt werden, verwenden Sie Ihren {% data variables.product.product_name %}-Benutzernamen und Ihr persönliches Zugriffstoken. In der Eingabeaufforderung wird nicht angegeben, dass Sie Ihr persönliches Zugriffstoken eingeben sollen, wenn Sie nach Ihrem Passwort gefragt werden. +Wenn Du in der Befehlszeile nach einem Benutzernamen und einem Passwort gefragt wirst, verwende Deinen {% data variables.product.product_name %}-Benutzernamen und Dein persönliches Zugriffstoken. In der Eingabeaufforderung wird nicht angegeben, dass Sie Ihr persönliches Zugriffstoken eingeben sollen, wenn Sie nach Ihrem Passwort gefragt werden. Weitere Informationen finden Sie unter "[Erstellen eines persönlichen Zugriffstokens](/github/authenticating-to-github/creating-a-personal-access-token)." diff --git a/translations/de-DE/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md b/translations/de-DE/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md index 6854fb690eb2..6db1912f0f16 100644 --- a/translations/de-DE/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md +++ b/translations/de-DE/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md @@ -1,6 +1,6 @@ --- title: Einen neuen SSH-Schlüssel zum GitHub-Konto hinzufügen -intro: 'Um Dein {% data variables.product.product_name %}-Konto für die Verwendung Deines neuen (oder vorhandenen) SSH-Schlüssels zu konfigurieren, musst Du diesen Schlüssel auch zu Deinem {% data variables.product.product_name %}-Konto hinzufügen.' +intro: 'Um Ihr {% data variables.product.product_name %}-Konto für die Verwendung eines neuen (oder vorhandenen) SSH-Schlüssels zu konfigurieren, müssen Sie diesen Schlüssel auch zu Ihrem {% data variables.product.product_name %}-Konto hinzufügen.' redirect_from: - /articles/adding-a-new-ssh-key-to-your-github-account versions: @@ -8,11 +8,11 @@ versions: enterprise-server: '*' --- -Bevor Du einen neuen SSH-Schlüssel zu Deinem {% data variables.product.product_name %}-Konto hinzufügst, solltest Du: +Bevor Sie einen neuen SSH-Schlüssel zu Ihrem {% data variables.product.product_name %}-Konto hinzufügen, sollten Sie * [nach vorhandenen SSH-Schlüsseln gesucht haben](/articles/checking-for-existing-ssh-keys) * [einen neuen SSH-Schlüssel erzeugt und ihn zum SSH-Agenten hinzugefügt haben](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) -Nachdem Du einen neuen SSH-Schlüssel zu Deinem {% data variables.product.product_name %}-Konto hinzugefügt hast, kannst Du alle lokalen Repositorys für die Verwendung von SSH konfigurieren. Weitere Informationen findest Du unter „[Remote-URLs von HTTPS auf SSH umstellen](/articles/changing-a-remote-s-url/#switching-remote-urls-from-https-to-ssh).“ +Nachdem Sie einen neuen SSH-Schlüssel zu Ihrem {% data variables.product.product_name %}-Konto hinzugefügt haben, können Sie alle lokalen Repositorys für die Verwendung von SSH konfigurieren. Weitere Informationen findest Du unter „[Remote-URLs von HTTPS auf SSH umstellen](/articles/changing-a-remote-s-url/#switching-remote-urls-from-https-to-ssh).“ {% data reusables.ssh.dsa-support %} @@ -78,10 +78,10 @@ Nachdem Du einen neuen SSH-Schlüssel zu Deinem {% data variables.product.produc ```shell $ sudo apt-get install xclip - # Herunterladen und installieren von xclip. Wenn Du 'apt-get' nicht hast, musst Du eventuell ein anderes Installationsprogramm (wie 'yum') verwenden + # Herunterladen und installieren von xclip. If you don't have `apt-get`, you might need to use another installer (like `yum`) - $ xclip -sel clip < ~/.ssh/id_rsa.pub - # Kopiert den Inhalt der Datei id_rsa.pub in die Zwischenablage + $ xclip -selection clipboard < ~/.ssh/id_rsa.pub + # Copies the contents of the id_rsa.pub file to your clipboard ``` {% tip %} diff --git a/translations/de-DE/content/github/authenticating-to-github/associating-an-email-with-your-gpg-key.md b/translations/de-DE/content/github/authenticating-to-github/associating-an-email-with-your-gpg-key.md index a82287008bf3..07410f597cdb 100644 --- a/translations/de-DE/content/github/authenticating-to-github/associating-an-email-with-your-gpg-key.md +++ b/translations/de-DE/content/github/authenticating-to-github/associating-an-email-with-your-gpg-key.md @@ -1,6 +1,6 @@ --- title: Eine E-Mail-Adresse mit Deinem GPG-Schlüssel verknüpfen -intro: 'Dein GPG-Schlüssel muss mit einer {% data variables.product.product_name %}-verifizierten E-Mail-Adresse verknüpft werden, die mit Deiner Beitragender-Identität übereinstimmt.' +intro: 'Ihr GPG-Schlüssel muss mit einer {% data variables.product.product_name %}-verifizierten E-Mail-Adresse verknüpft werden, die mit Ihrer Beitragendenidentität übereinstimmt.' redirect_from: - /articles/associating-an-email-with-your-gpg-key versions: @@ -10,7 +10,7 @@ versions: {% note %} -Wenn Du einen GPG-Schlüssel verwendest, der mit Deiner Beitragender-Identität und Deiner verifizierten und mit Deinem {% data variables.product.product_name %}-Konto verknüpften E-Mail-Adresse übereinstimmt, kannst Du beginnen, Commits und Tags zu signieren. +Wenn Sie einen GPG-Schlüssel verwenden, der mit Ihrer Beitragenderidentität und Ihrer verifizierten und mit Ihrem {% data variables.product.product_name %}-Konto verknüpften E-Mail-Adresse übereinstimmt, können Sie beginnen, Commits und Tags zu signieren. {% endnote %} @@ -25,7 +25,7 @@ Wenn Du einen GPG-Schlüssel verwendest, der mit Deiner Beitragender-Identität ```shell $ gpg> adduid ``` -6. Folge den Aufforderungen, Deinen echten Namen, Deine E-Mail-Adresse und allenfalls Kommentare anzugeben. Du kannst Deine Einträge ändern, indem Du `N`, `C` oder `E` auswählst. {% data reusables.gpg.private-email %} {% if currentVersion == "free-pro-team@latest" %} Weitere Informationen findest Du unter „[Deine Commit-E-Mail-Adresse festlegen](/articles/setting-your-commit-email-address)“.{% endif %} +6. Folge den Aufforderungen, Deinen echten Namen, Deine E-Mail-Adresse und allenfalls Kommentare anzugeben. Du kannst Deine Einträge ändern, indem Du `N`, `C` oder `E` auswählst. {% data reusables.gpg.private-email %} {% if currentVersion == "free-pro-team@latest" %} For more information, see "[Setting your commit email address](/articles/setting-your-commit-email-address)."{% endif %} ```shell Real Name: Octocat Email address: octocat@github.com diff --git a/translations/de-DE/content/github/authenticating-to-github/authenticating-with-saml-single-sign-on.md b/translations/de-DE/content/github/authenticating-to-github/authenticating-with-saml-single-sign-on.md index 4afd37e5c85c..dfb28acf3552 100644 --- a/translations/de-DE/content/github/authenticating-to-github/authenticating-with-saml-single-sign-on.md +++ b/translations/de-DE/content/github/authenticating-to-github/authenticating-with-saml-single-sign-on.md @@ -1,6 +1,6 @@ --- title: Authentifizierung mit SAML Single Sign-On -intro: 'Du kannst Dich bei einer {% data variables.product.product_name %}-Organisation mit SAML Single Sign-On (SSO) authentifizieren und Deine aktiven Sitzungen anzeigen.' +intro: 'Sie können sich bei einer {% data variables.product.product_name %}-Organisation mit SAML Single Sign-On (SSO) authentifizieren und Ihre aktiven Sitzungen anzeigen.' mapTopic: true redirect_from: - /articles/authenticating-to-a-github-organization-with-saml-single-sign-on/ diff --git a/translations/de-DE/content/github/authenticating-to-github/authorizing-oauth-apps.md b/translations/de-DE/content/github/authenticating-to-github/authorizing-oauth-apps.md index 0bded0043ae7..ced1194c3f4f 100644 --- a/translations/de-DE/content/github/authenticating-to-github/authorizing-oauth-apps.md +++ b/translations/de-DE/content/github/authenticating-to-github/authorizing-oauth-apps.md @@ -1,6 +1,6 @@ --- title: OAuth-Apps autorisieren -intro: 'Du kannst Deine {% data variables.product.product_name %}-Identität zu Drittanbieter-Anwendungen verbinden, die OAuth verwenden. Wenn Du eine {% data variables.product.prodname_oauth_app %} autorisierst, solltest Du sicherstellen, dass die Anwendung vertrauenswürdig ist, und überprüfen, von wem sie entwickelt wurde und auf welche Daten sie zugreifen will.' +intro: 'Sie können Ihre {% data variables.product.product_name %}-Identität über OAuth mit Drittanbieter-Anwendungen verbinden. Wenn Sie eine {% data variables.product.prodname_oauth_app %} autorisieren, sollten Sie sicherstellen, dass die Anwendung vertrauenswürdig ist, und überprüfen, von wem sie entwickelt wurde und auf welche Daten sie zugreifen will.' redirect_from: - /articles/authorizing-oauth-apps versions: @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -Wenn eine {% data variables.product.prodname_oauth_app %} Dich anhand Deines {% data variables.product.product_name %}-Kontos identifizieren möchte, wird eine Seite mit den Kontaktdaten des Anwendungsentwicklers und einer Liste der Daten angezeigt, die angefordert werden. +Wenn eine {% data variables.product.prodname_oauth_app %} Sie anhand Ihres {% data variables.product.product_name %}-Kontos identifizieren möchte, wird eine Seite mit den Kontaktdaten des Anwendungsentwicklers und einer Liste der Daten angezeigt, die angefordert werden. {% if currentVersion == "free-pro-team@latest" %} @@ -22,7 +22,7 @@ Wenn eine {% data variables.product.prodname_oauth_app %} Dich anhand Deines {% ### {% data variables.product.prodname_oauth_app %}-Zugriff -{% data variables.product.prodname_oauth_app %}s können *Lese*- oder *Schreib*zugriff auf Deine {% data variables.product.product_name %}-Daten haben. +{% data variables.product.prodname_oauth_app %}s können *Lese*- oder *Schreib*zugriff auf Ihre {% data variables.product.product_name %}-Daten haben. - Bei einem **Lesezugriff** kann eine App Deine Daten nur *anzeigen*. - Bei einem **Schreibzugriff** kann eine App Deine Daten auch *ändern*. @@ -37,7 +37,7 @@ Wenn eine {% data variables.product.prodname_oauth_app %} Dich anhand Deines {% *Scopes* sind benannte Gruppen von Berechtigungen, die eine {% data variables.product.prodname_oauth_app %} anfordern kann, um auf öffentliche wie nicht öffentliche Daten zuzugreifen. -Wenn Du eine {% data variables.product.prodname_oauth_app %} verwenden möchtest, die in {% data variables.product.product_name %} integriert ist, teilt die App Dir mit, welche Art von Zugriff auf Deine Daten benötigt wird. Wenn Du der App Zugriff erteilen, kann sie Aktionen für Dich durchführen, beispielsweise das Lesen oder Ändern von Daten. Wenn Du beispielsweise eine App verwenden möchtest, die den Scope `user:email` fordert, hat die App Lesezugriff auf Deine privaten E-Mail-Adressen. For more information, see "[About scopes for {% data variables.product.prodname_oauth_app %}s](//apps/building-integrations/setting-up-and-registering-oauth-apps/about-scopes-for-oauth-apps)." +Wenn Sie eine {% data variables.product.prodname_oauth_app %} verwenden möchten, die in {% data variables.product.product_name %} integriert ist, teilt die App Ihnen mit, welche Art von Zugriff auf Ihre Daten benötigt wird. Wenn Du der App Zugriff erteilen, kann sie Aktionen für Dich durchführen, beispielsweise das Lesen oder Ändern von Daten. Wenn Du beispielsweise eine App verwenden möchtest, die den Scope `user:email` fordert, hat die App Lesezugriff auf Deine privaten E-Mail-Adressen. For more information, see "[About scopes for {% data variables.product.prodname_oauth_app %}s](//apps/building-integrations/setting-up-and-registering-oauth-apps/about-scopes-for-oauth-apps)." {% tip %} @@ -55,7 +55,7 @@ Wenn Du eine {% data variables.product.prodname_oauth_app %} verwenden möchtest | Bereitstellungen | Mit dem Zugriff auf den Bereitstellungsstatus können Apps anhand eines bestimmten Commits für öffentliche und private Repositorys ermitteln, ob eine Bereitstellung erfolgreich ist. Apps können nicht auf Deinen Code zugreifen. | | Gists | Der [Gist](https://gist.github.com)-Zugriff gewährt Apps den Lese- oder Schreibzugriff auf Deine öffentlichen wie geheimen Gists. | | Hooks | Der [Webhooks](/webhooks)-Zugriff gewährt Apps den Lese- oder Schreibzugriff auf Hook-Konfigurationen auf von Dir verwalteten Repositorys. | -| Benachrichtigungen | Der Benachrichtigungszugriff erlaubt es Apps, Deine {% data variables.product.product_name %}-Benachrichtigungen wie Kommentare zu Issues und Pull Requests zu lesen. Die Apps können jedoch auf keine Elemente in Deinem Repositorys zugreifen. | +| Benachrichtigungen | Der Benachrichtigungszugriff erlaubt es Apps, Ihre {% data variables.product.product_name %}-Benachrichtigungen wie Kommentare zu Issues und Pull Requests zu lesen. Die Apps können jedoch auf keine Elemente in Deinem Repositorys zugreifen. | | Organisationen und Teams | Mit dem Organisations- und Teamzugriff können Apps auf Organisations- und Teammitglieder zugreifen und sie verwalten. | | Persönliche Benutzerdaten | Zu Benutzerdaten gehören die Angaben in Deinem Benutzerprofil, beispielsweise Dein Name, Deine E-Mail-Adresse und Dein Standort. | | Repositorys | Repository-Informationen umfassen die Namen der Mitarbeiter, die von Dir erstellten Branches und die effektiven Dateien in Deinem Repository. Apps können den Zugriff für öffentliche oder private Repositorys auf benutzerweiter Ebene anfordern. | @@ -63,13 +63,13 @@ Wenn Du eine {% data variables.product.prodname_oauth_app %} verwenden möchtest ### Aktualisierte Berechtigungen anfordern -Wenn {% data variables.product.prodname_oauth_app %}s neue Zugriffsrechte anfordern, informieren sie Dich über die Unterschiede zwischen den aktuellen und den neuen Berechtigungen. +Wenn {% data variables.product.prodname_oauth_app %}s neue Zugriffsrechte anfordern, informieren sie Sie über die Unterschiede zwischen den aktuellen und den neuen Berechtigungen. {% if currentVersion == "free-pro-team@latest" %} ### {% data variables.product.prodname_oauth_app %}s und Organisationen -Wenn Du eine {% data variables.product.prodname_oauth_app %} für Dein persönliches Benutzerkonto autorisierst, siehst Du auch, wie sich die Autorisierung auf jede Organisation auswirkt, bei der Du Mitglied bist. +Wenn Sie eine {% data variables.product.prodname_oauth_app %} für Ihr persönliches Benutzerkonto autorisieren, sehen Sie auch, wie sich die Autorisierung auf jede Organisation auswirkt, bei der Sie Mitglied sind. - **Für Organisationen *mit* eingeschränktem {% data variables.product.prodname_oauth_app %}-Zugriff kannst Du verlangen, dass die Organisationsadministratoren die Verwendung der Anwendung in der Organisation genehmigen.** Wenn die Organisation die Anwendung nicht genehmigt, kann die Anwendung nur auf die öffentlichen Ressourcen der Organisation zugreifen. Wenn Du ein Organisationsadministrator bist, kannst Du [die Anwendung selbst genehmigen](/articles/approving-oauth-apps-for-your-organization). diff --git a/translations/de-DE/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md b/translations/de-DE/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md index df1293635c05..6f84ac3d3c7a 100644 --- a/translations/de-DE/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md +++ b/translations/de-DE/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md @@ -20,8 +20,7 @@ versions: 3. Überprüfe die Verzeichnisliste, um zu ermitteln, ob Du bereits einen öffentlichen SSH-Schlüssel besitzen. Standardmäßig lauten die Dateinamen der öffentlichen Schlüssel: - *id_rsa.pub* - *id_ecdsa.pub* - - *id_ed25519.pub*{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} - - *id_dsa.pub*{% endif %} + - *id_ed25519.pub* Wenn Du kein öffentliches und privates Schlüsselpaar besitzt oder wenn Du kein vorhandenes Schlüsselpaar für die Verbindung zu {% data variables.product.product_name %} verwenden möchtest, dann [erzeuge einen neuen SSH-Schlüssel](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent). diff --git a/translations/de-DE/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md b/translations/de-DE/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md index 69bebc9a9d15..edfe3e6767b7 100644 --- a/translations/de-DE/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md +++ b/translations/de-DE/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md @@ -1,6 +1,6 @@ --- title: Verifizierungsstatus der Commit- und Tag-Signaturen prüfen -intro: 'Du kannst den Verifizierungsstatus Deiner Commit- und Tag-Signaturen auf {% data variables.product.product_name %} überprüfen.' +intro: 'Sie können den Verifizierungsstatus Ihrer Commit- und Tag-Signaturen auf {% data variables.product.product_name %} überprüfen.' redirect_from: - /articles/checking-your-gpg-commit-and-tag-signature-verification-status/ - /articles/checking-your-commit-and-tag-signature-verification-status @@ -11,7 +11,9 @@ versions: ### Den Verifizierungsstatus Deiner Commit-Signatur prüfen -1. Navigieren Sie auf {% data variables.product.product_name %} zu Ihrem Pull Request. +1. On + +{% data variables.product.product_name %}, navigate to your pull request. {% data reusables.repositories.review-pr-commits %} 3. Das Feld neben dem verkürzten Commit-Hash Deines Commits zeigt, ob die Commit-Signatur verifiziert ist oder nicht. ![Signierter Commit](/assets/images/help/commits/gpg-signed-commit-verified-without-details.png) 4. Um detailliertere Informationen zur Commit-Signatur anzuzeigen, klicke auf **Verified** (Verifiziert) oder **Unverified** (Nicht verifiziert). ![Verifizierter signierter Commit](/assets/images/help/commits/gpg-signed-commit_verified_details.png) diff --git a/translations/de-DE/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md b/translations/de-DE/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md index 960c2a17fb7f..18352b11a4c1 100644 --- a/translations/de-DE/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md +++ b/translations/de-DE/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md @@ -1,6 +1,6 @@ --- title: Wiederherstellungsmethoden bei der Zwei-Faktor-Authentifizierung konfigurieren -intro: 'Du kannst verschiedene Wiederherstellungsmethoden einrichten, um auf Dein Konto zuzugreifen, wenn Du Deine Anmeldeinformation für die Zwei-Faktor-Authentifizierung verloren hast.' +intro: Du kannst verschiedene Wiederherstellungsmethoden einrichten, um auf Dein Konto zuzugreifen, wenn Du Deine Anmeldeinformation für die Zwei-Faktor-Authentifizierung verloren hast. redirect_from: - /articles/downloading-your-two-factor-authentication-recovery-codes/ - /articles/setting-a-fallback-authentication-number/ @@ -17,7 +17,7 @@ Neben der sicheren Speicherung Deiner Wiederherstellungscodes für die Zwei-Fakt ### Wiederherstellungscode für die Zwei-Faktor-Authentifizierung herunterladen -{% data reusables.two_fa.about-recovery-codes %} Du kannst nach der Aktivierung der Zwei-Faktor-Authentifizierung Deine Wiederherstellungscodes auch jederzeit herunterladen. +{% data reusables.two_fa.about-recovery-codes %} Sie können nach der Aktivierung der Zwei-Faktor-Authentifizierung Ihre Wiederherstellungscodes auch jederzeit herunterladen. Um Dein Konto zu schützen, solltest Du diese Wiederherstellungscode nicht öffentlich machen und nicht weitergeben. Wir empfehlen, die Codes mit einem sicheren Passwort-Manager zu speichern, beispielsweise mit: - [1Password](https://1password.com/) @@ -91,7 +91,9 @@ Wenn Du ein Kontowiederherstellungstoken erzeugst oder abrufst, wird ein Ereigni Du kannst ein Kontowiederherstellungstoken erzeugen und bei einem Partner-Wiederherstellungsanbieter speichern. -1. Melde Dich bei Deinem Facebook-Konto an, und kehre dann zu {% data variables.product.product_name %} zurück. +1. Sign in to your Facebook account, then return to + +{% data variables.product.product_name %}. {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.security %} 4. Um ein neues Token zu erzeugen, klicke unter „Recovery tokens“ (Wiederherstellungstoken) auf **Store new token** (Neues Token speichern). ![Schaltfläche zum Speichern eines neuen Wiederherstellungstokens](/assets/images/help/settings/store-new-recovery-token.png) diff --git a/translations/de-DE/content/github/authenticating-to-github/configuring-two-factor-authentication.md b/translations/de-DE/content/github/authenticating-to-github/configuring-two-factor-authentication.md index c312c932d724..df94dc7ee8fa 100644 --- a/translations/de-DE/content/github/authenticating-to-github/configuring-two-factor-authentication.md +++ b/translations/de-DE/content/github/authenticating-to-github/configuring-two-factor-authentication.md @@ -1,6 +1,6 @@ --- title: Zwei-Faktor-Authentifizierung konfigurieren -intro: 'Du kannst zwischen mehreren Optionen wählen, um eine zweite Authentifizierungsquelle Deinem Konto hinzuzufügen.' +intro: Du kannst zwischen mehreren Optionen wählen, um eine zweite Authentifizierungsquelle Deinem Konto hinzuzufügen. redirect_from: - /articles/configuring-two-factor-authentication-via-a-totp-mobile-app/ - /articles/configuring-two-factor-authentication-via-text-message/ @@ -11,14 +11,14 @@ versions: enterprise-server: '*' --- -Du kannst die Zwei-Faktor-Authentifizierung per Mobilanwendung{% if currentVersion == "free-pro-team@latest" %} oder per SMS konfigurieren{% endif %}. Du kannst auch einen Sicherheitsschlüssel hinzufügen. +You can configure two-factor authentication using a mobile app{% if currentVersion == "free-pro-team@latest" %} or via text message{% endif %}. Du kannst auch einen Sicherheitsschlüssel hinzufügen. -Wir empfehlen dringend, eine TOTP-Anwendung (Time-based One-Time Password) zu verwenden, um die Zwei-Faktor-Authentifizierung (2FA) zu konfigurieren.{% if currentVersion == "free-pro-team@latest" %} TOTP-Anwendungen sind zuverlässiger als SMS, besonders bei Standorten außerhalb der USA.{% endif %} TOTP-Anwendungen unterstützen das sichere Backup Deiner Authentifizierungscodes in der Cloud und sie können wiederhergestellt werden, wenn Du den Zugriff auf Dein Gerät verlierst. +We strongly recommend using a time-based one-time password (TOTP) application to configure 2FA.{% if currentVersion == "free-pro-team@latest" %} TOTP applications are more reliable than SMS, especially for locations outside the United States.{% endif %} TOTP apps support the secure backup of your authentication codes in the cloud and can be restored if you lose access to your device. {% warning %} **Warnung:** -- Wenn Du ein Mitglied{% if currentVersion == "free-pro-team@latest" %}, Abrechnungsmanager,{% endif %} oder externer Mitarbeiter eines privaten Repositorys einer Organisation bist, die die Zwei-Faktor-Authentifizierung voraussetzt, musst Du die Organisation verlassen, bevor Du die 2FA auf {% data variables.product.product_location %} deaktivieren kannst. +- If you're a member{% if currentVersion == "free-pro-team@latest" %}, billing manager,{% endif %} or outside collaborator to a private repository of an organization that requires two-factor authentication, you must leave the organization before you can disable 2FA on {% data variables.product.product_location %}. - Wenn Du die 2FA deaktivierst, verlierst Du automatisch den Zugriff auf die Organisation und alle privaten Forks, die Du in den privaten Repositorys der Organisation hast. Um wieder auf die Organisation und Deine Forks zuzugreifen, aktiviere die Zwei-Faktor-Authentifizierung erneut und wende Dich an einen Organisationsinhaber. {% endwarning %} @@ -45,7 +45,9 @@ Eine TOTP-Anwendung (Time-based One-Time Password) erzeugt automatisch einen Aut 8. Führe auf der Seite zur Zwei-Faktor-Authentifizierung eine der folgenden Aktionen durch: - Scanne den QR-Code mit der App Deines Mobilgeräts. Nach dem Scannen zeigt die App einen sechsstelligen Code an, den Du auf {% data variables.product.product_name %} eingeben kannst. - Wenn Du den QR-Code nicht scannen kannst, klicke auf **enter this text code** (Diesen Textcode eingeben), um einen Code anzuzeigen, den Du kopieren und manuell auf{% data variables.product.product_name %} eingeben kannst. ![Klicke auf „enter this text code“ (Diesen Code eingeben)](/assets/images/help/2fa/totp-click-enter-code.png) -9. Die TOTP-Mobilanwendung speichert Dein {% data variables.product.product_name %}-Konto und erzeugt alle paar Sekunden einen neuen Authentifizierungscode. Gib auf der 2FA-Seite auf {% data variables.product.product_name %} den Code ein, und klicke auf **Enable** (Aktivieren). ![Feld zum Aktivieren von TOTP](/assets/images/help/2fa/totp-enter-code.png) +9. The TOTP mobile application saves your +{% data variables.product.product_name %} account and generates a new authentication code every few seconds. Gib auf der 2FA-Seite auf {% data variables.product.product_name %} den Code ein, und klicke auf **Enable** (Aktivieren). + ![Feld zum Aktivieren von TOTP](/assets/images/help/2fa/totp-enter-code.png) {% data reusables.two_fa.test_2fa_immediately %} {% if currentVersion == "free-pro-team@latest" %} @@ -79,32 +81,16 @@ Bevor Du diese Methode verwendest, stelle sicher, dass Du SMS empfangen kannst. Auf den meisten Geräten und Browsern kannst Du einen physikalischen Sicherheitsschlüssel über USB oder NFC verwenden. Einige Browser können Fingerabdruckleser, Gesichtserkennung oder Passwort / PIN als Sicherheitsschlüssel auf Deinem Gerät verwenden. -Die Authentifizierung mit einem Sicherheitsschlüssel ist *zweitrangig* gegenüber der Authentifizierung mit einer TOTP-Anwendung{% if currentVersion == "free-pro-team@latest" %} oder SMS{% endif %}. Wenn Du Deinen Sicherheitsschlüssel verlierst, kannst Du immer noch den Code Deines Telefons für die Anmeldung verwenden. +Authentication with a security key is *secondary* to authentication with a TOTP application{% if currentVersion == "free-pro-team@latest" %} or a text message{% endif %}. Wenn Du Deinen Sicherheitsschlüssel verlierst, kannst Du immer noch den Code Deines Telefons für die Anmeldung verwenden. -1. Du musst die 2FA bereits mit einer TOTP-Mobilanwendung{% if currentVersion == "free-pro-team@latest" %} oder SMS{% endif %} konfiguriert haben. -2. Stelle sicher, dass Du einen -mit {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}WebAuthn{% else %}FIDO U2F{% endif %} kompatiblen Sicherheitsschlüssel in Deinen Computer eingesteckt hast. +1. You must have already configured 2FA via a TOTP mobile app{% if currentVersion == "free-pro-team@latest" %} or via SMS{% endif %}. +2. Ensure that you have a WebAuthn compatible security key inserted into your computer. {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.security %} 5. Klicke neben „Security keys“ (Sicherheitsschlüssel) auf **Add** (Hinzufügen). ![Option „Add security keys" (Hinzufügen von Sicherheitsschlüsseln)](/assets/images/help/2fa/add-security-keys-option.png) -6. Klicke unter „Security keys“ (Sicherheitsschlüssel) auf **Register new security key** (Neuen Sicherheitsschlüssel registrieren). - {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - ![Einen neuen Sicherheitsschlüssel registrieren](/assets/images/help/2fa/security-key-register.png) - {% else %} - ![Ein neues FIDO U2F-Gerät registrieren](/assets/images/help/2fa/register_new_fido_u2f_device.png) - {% endif %} -7. Gib einen Nicknamen für den Sicherheitsschlüssel ein, und klicke dann auf **Add** (Hinzufügen). - {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - ![Einen Nickname für einen Sicherheitsschlüssel angeben](/assets/images/help/2fa/security-key-nickname.png) - {% else %} - ![Einen Nickname für ein FIDO U2F-Gerät angeben](/assets/images/help/2fa/fido_u2f_nickname.png) - {% endif %} -8. Aktiviere Deinen Sicherheitsschlüssel gemäß den Anweisungen in der Dokumentation des Schlüssels. - {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - ![Eingabeaufforderung für einen Sicherheitsschlüssel](/assets/images/help/2fa/security-key-prompt.png) - {% else %} - ![Aufforderung für ein FIDO U2F-Gerät](/assets/images/help/2fa/fido_u2f_prompt_key.png) - {% endif %} +6. Klicke unter „Security keys“ (Sicherheitsschlüssel) auf **Register new security key** (Neuen Sicherheitsschlüssel registrieren). ![Einen neuen Sicherheitsschlüssel registrieren](/assets/images/help/2fa/security-key-register.png) +7. Gib einen Nicknamen für den Sicherheitsschlüssel ein, und klicke dann auf **Add** (Hinzufügen). ![Einen Nickname für einen Sicherheitsschlüssel angeben](/assets/images/help/2fa/security-key-nickname.png) +8. Aktivieren Sie Ihren Sicherheitsschlüssel gemäß den Anweisungen in der Dokumentation des Schlüssels. ![Eingabeaufforderung für einen Sicherheitsschlüssel](/assets/images/help/2fa/security-key-prompt.png) 9. Bestätige, dass Du Deine Wiederherstellungscodes heruntergeladen hast und auf sie zugreifen kannst. Wenn Du das noch nicht getan hast oder einen anderen Satz an Codes verwenden möchtest, lade Deine Codes herunter und speichere sie an einem sicheren Ort. Wenn Du nicht mehr auf Dein Konto zugreifen kannst, kannst Du mit den Wiederherstellungscodes erneut Zugriff auf Dein Konto erlangen. Weitere Informationen findest Du unter „[Dein Konto beim Verlust der 2FA-Anmeldeinformationen wiederherstellen](/articles/recovering-your-account-if-you-lose-your-2fa-credentials).“ ![Schaltfläche „Download recovery codes" (Herunterladen der Wiederherstellungscodes)](/assets/images/help/2fa/2fa-recover-during-setup.png) {% data reusables.two_fa.test_2fa_immediately %} diff --git a/translations/de-DE/content/github/authenticating-to-github/connecting-to-github-with-ssh.md b/translations/de-DE/content/github/authenticating-to-github/connecting-to-github-with-ssh.md index 3f200e8497a3..dae4bfab9efc 100644 --- a/translations/de-DE/content/github/authenticating-to-github/connecting-to-github-with-ssh.md +++ b/translations/de-DE/content/github/authenticating-to-github/connecting-to-github-with-ssh.md @@ -1,6 +1,6 @@ --- title: Verbindung zu GitHub mit SSH herstellen -intro: 'Du kannst mit SSH eine Verbindung zu {% data variables.product.product_name %} herstellen.' +intro: 'Sie können mit SSH eine Verbindung zu {% data variables.product.product_name %} herstellen.' redirect_from: - /key-setup-redirect/ - /linux-key-setup/ diff --git a/translations/de-DE/content/github/authenticating-to-github/connecting-with-third-party-applications.md b/translations/de-DE/content/github/authenticating-to-github/connecting-with-third-party-applications.md index 93c5de08b1ea..9e59285e5184 100644 --- a/translations/de-DE/content/github/authenticating-to-github/connecting-with-third-party-applications.md +++ b/translations/de-DE/content/github/authenticating-to-github/connecting-with-third-party-applications.md @@ -1,6 +1,6 @@ --- title: Mit Anwendungen von Drittanbietern verbinden -intro: 'Du kannst Deine {% data variables.product.product_name %}-Identität zu Drittanbieter-Anwendungen verbinden, die OAuth verwenden. Wenn Du eine dieser Anwendungen autorisierst, solltest Du sicherstellen, dass es sich um eine vertrauenswürdige Anwendung handelt, und prüfen, von wem sie entwickelt wurde und auf welche Informationen sie zugreifen will.' +intro: 'Sie können Ihre {% data variables.product.product_name %}-Identität über OAuth mit Drittanbieter-Anwendungen verbinden. Wenn Du eine dieser Anwendungen autorisierst, solltest Du sicherstellen, dass es sich um eine vertrauenswürdige Anwendung handelt, und prüfen, von wem sie entwickelt wurde und auf welche Informationen sie zugreifen will.' redirect_from: - /articles/connecting-with-third-party-applications versions: @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -Wenn eine Drittanbieter-Anwendung Dich mit Deiner {% data variables.product.product_name %}-Anmeldung identifizieren möchte, wird eine Seite mit den Kontaktdaten des Entwicklers und einer Liste der angeforderten Daten angezeigt. +Wenn Sie eine Drittanbieter-Anwendung mit Ihrer {% data variables.product.product_name %}-Anmeldung identifizieren möchte, wird eine Seite mit den Kontaktdaten des Entwicklers und einer Liste der angeforderten Daten angezeigt. ### Den Anwendungsentwickler kontaktieren @@ -31,7 +31,7 @@ Anwendungen können *Lese*- oder *Schreib*zugriff auf Deine {% data variables.pr *Scopes* sind benannte Gruppen von Berechtigungen, die eine Anwendung anfordern kann, um auf öffentliche und nicht öffentliche Daten zuzugreifen. -Wenn Du eine Drittanbieter-Anwendung verwenden möchtest, die in {% data variables.product.product_name %} integriert ist, teilt diese Anwendung Dir mit, welche Art von Zugriff auf Deine Daten benötigt wird. Wenn Du der App Zugriff erteilst, kann sie Aktionen in Deinem Namen durchführen, beispielsweise das Lesen oder Ändern von Daten. Wenn Du beispielsweise eine App verwenden möchtest, die den Scope `user:email` fordert, hat die App Lesezugriff auf Deine privaten E-Mail-Adressen. For more information, see "[About scopes for {% data variables.product.prodname_oauth_app %}s](//apps/building-integrations/setting-up-and-registering-oauth-apps/about-scopes-for-oauth-apps)." +Wenn Sie eine Drittanbieter-Anwendung verwenden möchten, die in {% data variables.product.product_name %} integriert ist, teilt diese Anwendung Ihnen mit, welche Art von Zugriff auf Ihre Daten benötigt wird. Wenn Du der App Zugriff erteilst, kann sie Aktionen in Deinem Namen durchführen, beispielsweise das Lesen oder Ändern von Daten. Wenn Du beispielsweise eine App verwenden möchtest, die den Scope `user:email` fordert, hat die App Lesezugriff auf Deine privaten E-Mail-Adressen. For more information, see "[About scopes for {% data variables.product.prodname_oauth_app %}s](//apps/building-integrations/setting-up-and-registering-oauth-apps/about-scopes-for-oauth-apps)." {% tip %} @@ -57,7 +57,7 @@ Es gibt mehrere Typen von Daten, die Anwendungen anfordern können. | Bereitstellungen | Der Zugriff auf den Bereitstellungsstatus ermöglicht es Anwendungen, zu ermitteln, ob eine Bereitstellung erfolgreich ist für einen bestimmten Commit für öffentliche und private Repositorys. Anwendungen erhalten keinen Zugriff auf Deinen Code. | | Gists | Der [Gist](https://gist.github.com)-Zugriff ermöglicht es Anwendungen, in Deine öffentlichen wie geheimen Gists zu schreiben oder sie zu lesen. | | Hooks | Der [Webhooks](/webhooks)-Zugriff ermöglicht es Anwendungen, Hook-Konfigurationen auf von Dir verwalteten Repositorys zu lesen oder zu schreiben. | -| Benachrichtigungen | Der Benachrichtungszugriff ermöglicht es Anwendungen, Deine {% data variables.product.product_name %}-Benachrichtigungen zu lesen, beispielsweise Kommentare zu Issues und Pull Requests. Die Anwendungen können jedoch auf keine Inhalte Deiner Repositorys zugreifen. | +| Benachrichtigungen | Der Benachrichtungszugriff ermöglicht es Anwendungen, Ihre {% data variables.product.product_name %}-Benachrichtigungen zu lesen, z. B. Kommentare zu Issues und Pull Requests. Die Anwendungen können jedoch auf keine Inhalte Deiner Repositorys zugreifen. | | Organisationen und Teams | Mit dem Organisations- und Teamzugriff können Apps auf Organisations- und Teammitglieder zugreifen und sie verwalten. | | Persönliche Benutzerdaten | Zu Benutzerdaten gehören die Angaben in Deinem Benutzerprofil, beispielsweise Dein Name, Deine E-Mail-Adresse und Dein Standort. | | Repositorys | Repository-Informationen umfassen die Namen der Mitarbeiter, die von Dir erstellten Branches und die effektiven Dateien in Deinem Repository. Anwendungen können den Zugriff auf öffentliche oder private Repositorys auf benutzerweiter Ebene anfordern. | diff --git a/translations/de-DE/content/github/authenticating-to-github/countries-where-sms-authentication-is-supported.md b/translations/de-DE/content/github/authenticating-to-github/countries-where-sms-authentication-is-supported.md index b400463094ce..738cf91040b4 100644 --- a/translations/de-DE/content/github/authenticating-to-github/countries-where-sms-authentication-is-supported.md +++ b/translations/de-DE/content/github/authenticating-to-github/countries-where-sms-authentication-is-supported.md @@ -1,6 +1,6 @@ --- -title: 'Länder, in denen die SMS-Authentifizierung unterstützt wird' -intro: 'Wegen den Auslieferungs-Erfolgsquoten für SMS unterstützt {% data variables.product.product_name %} die Zwei-Faktor-Authentifizierung per SMS nur in bestimmten Ländern.' +title: Länder, in denen die SMS-Authentifizierung unterstützt wird +intro: 'Wegen der Auslieferungserfolgsquoten unterstützt {% data variables.product.product_name %} die Zwei-Faktor-Authentifizierung per SMS nur in bestimmten Ländern.' redirect_from: - /articles/countries-where-sms-authentication-is-supported versions: diff --git a/translations/de-DE/content/github/authenticating-to-github/creating-a-personal-access-token.md b/translations/de-DE/content/github/authenticating-to-github/creating-a-personal-access-token.md index fb756eb4b1b5..463e2fd40ce1 100644 --- a/translations/de-DE/content/github/authenticating-to-github/creating-a-personal-access-token.md +++ b/translations/de-DE/content/github/authenticating-to-github/creating-a-personal-access-token.md @@ -27,8 +27,8 @@ Personal access tokens (PATs) are an alternative to using passwords for authenti 5. Gib dem Token einen beschreibenden Namen. ![Feld „Token description“ (Token-Beschreibung)](/assets/images/help/settings/token_description.png) 6. Wähle die Scopes oder Berechtigungen aus, die Du diesem Token zuweisen möchtest. Um das Token für den Zugriff auf Repositorys über die Befehlszeile zu verwenden, wähle **repo** aus. ![Token-Scopes auswählen](/assets/images/help/settings/token_scopes.gif) 7. Klicke auf **Generate token** (Token erzeugen). ![Schaltfläche „Generate token“ (Token erzeugen)](/assets/images/help/settings/generate_token.png) -8. Klicke auf {% octicon "clippy" aria-label="The copy to clipboard icon" %}, um das Token in die Zwischenablage zu kopieren. Nachdem Du die Seite verlassen haben, kannst Du das Token aus Sicherheitsgründen nicht mehr sehen.{% if currentVersion == "free-pro-team@latest" %} ![Neu erstellten Token](/assets/images/help/settings/personal_access_tokens.png){% else %} -![Neu erstellten Token](/assets/images/help/settings/personal_access_tokens_ghe.png){% endif %} +8. Klicke auf {% octicon "clippy" aria-label="The copy to clipboard icon" %}, um das Token in die Zwischenablage zu kopieren. For security reasons, after you navigate off the page, you will not be able to see the token again.{% if currentVersion == "free-pro-team@latest" %} ![Newly created token](/assets/images/help/settings/personal_access_tokens.png){% else %} +![Newly created token](/assets/images/help/settings/personal_access_tokens_ghe.png){% endif %} {% warning %} diff --git a/translations/de-DE/content/github/authenticating-to-github/creating-a-strong-password.md b/translations/de-DE/content/github/authenticating-to-github/creating-a-strong-password.md index 799799f35680..3b65522121d5 100644 --- a/translations/de-DE/content/github/authenticating-to-github/creating-a-strong-password.md +++ b/translations/de-DE/content/github/authenticating-to-github/creating-a-strong-password.md @@ -1,6 +1,6 @@ --- title: Ein sicheres Passwort erstellen -intro: 'Schütze Dein {% data variables.product.product_name %}-Konto mit einem sicheren und spezifischen Passwort über einen Passwort-Manager.' +intro: 'Schützen Sie Ihr {% data variables.product.product_name %}-Konto mit einem sicheren und eindeutigen Passwort mit einem Passwort-Manager.' redirect_from: - /articles/what-is-a-strong-password/ - /articles/creating-a-strong-password @@ -9,13 +9,13 @@ versions: enterprise-server: '*' --- -Du musst ein Passwort für Dein {% data variables.product.product_name %}-Konto auswählen oder erstellen, das: +Sie müssen ein Passwort für Ihr {% data variables.product.product_name %}-Konto auswählen oder erstellen, das - 8 Zeichen lang ist, wenn es eine Zahl und einen Kleinbuchstaben enthält, oder - 16 Zeichen lang ist, bei einer beliebigen Kombination an Zeichen. Für den Schutz Deines Kontos empfehlen wir Dir die folgenden Best Practices: - Benutze einen Passwort-Manager wie zum Beispiel [LastPass](https://lastpass.com/) oder [1Password](https://1password.com/), um ein Passwort mit mehr als 16 Zeichen zu erstellen. -- Erzeuge ein spezifisches Passwort für {% data variables.product.product_name %}. Wenn Du Dein {% data variables.product.product_name %}-Passwort auch an anderer Stelle verwendest und dieser Dienst kompromittiert wird, könnten die Angreifer oder andere Personen mit böswilliger Absicht diese Informationen nutzen, um auf Dein {% data variables.product.product_name %}-Konto zuzugreifen. +- Erzeugen Sie ein eindeutiges Passwort für {% data variables.product.product_name %}. Wenn Sie Ihr {% data variables.product.product_name %}-Passwort auch an anderer Stelle verwenden und dieser Dienst kompromittiert wird, könnten die Angreifer oder andere Personen mit böswilliger Absicht diese Informationen nutzen, um auf Ihr {% data variables.product.product_name %}-Konto zuzugreifen. - Konfiguriere die Zwei-Faktor-Authentifizierung für Dein persönliches Konto. Weitere Informationen findest Du unter „[Informationen zur Zwei-Faktor-Authentifizierung](/articles/about-two-factor-authentication).“ - Gib Dein Passwort niemals an andere weiter, auch nicht an potenzielle Mitarbeiter. Jede Person sollte ihr eigenes persönliches Konto bei {% data variables.product.product_name %} nutzen. Weitere Informationen zu Möglichkeiten der Zusammenarbeit findest Du unter „[Mitarbeiter in ein persönliches Repository einladen](/articles/inviting-collaborators-to-a-personal-repository)“, „[Informationen über gemeinschaftliche Entwicklungsmodelle](/articles/about-collaborative-development-models/)“ oder „[Mit Gruppen in Organisationen zusammenarbeiten](/articles/collaborating-with-groups-in-organizations/).“ diff --git a/translations/de-DE/content/github/authenticating-to-github/disabling-two-factor-authentication-for-your-personal-account.md b/translations/de-DE/content/github/authenticating-to-github/disabling-two-factor-authentication-for-your-personal-account.md index 4f50622f8bc0..8fb377d1399c 100644 --- a/translations/de-DE/content/github/authenticating-to-github/disabling-two-factor-authentication-for-your-personal-account.md +++ b/translations/de-DE/content/github/authenticating-to-github/disabling-two-factor-authentication-for-your-personal-account.md @@ -12,7 +12,7 @@ Wir empfehlen dringend, Dein Konto mit der Zwei-Faktor-Authentifizierung zu sch {% warning %} -**Warnung:** Wenn Du ein Mitglied{% if currentVersion == "free-pro-team@latest" %}, Abrechnungsmanager{% endif %} oder externer Mitarbeiter eines öffentlichen Repositorys einer Organisation bist, die die Zwei-Faktor-Authentifizierung voraussetzt, und Du die 2FA deaktivierst, wirst Du automatisch aus der Organisation entfernt und verlierst den Zugriff auf deren Repositorys. Um wieder auf die Organisation zugreifen zu können, aktiviere die Zwei-Faktor-Authentifizierung erneut und wende Dich an einen Organisationsinhaber. +**Warning:** If you're a member{% if currentVersion == "free-pro-team@latest" %}, billing manager,{% endif %} or outside collaborator to a public repository of an organization that requires two-factor authentication and you disable 2FA, you'll be automatically removed from the organization, and you'll lose your access to their repositories. Um wieder auf die Organisation zugreifen zu können, aktiviere die Zwei-Faktor-Authentifizierung erneut und wende Dich an einen Organisationsinhaber. {% endwarning %} diff --git a/translations/de-DE/content/github/authenticating-to-github/error-agent-admitted-failure-to-sign.md b/translations/de-DE/content/github/authenticating-to-github/error-agent-admitted-failure-to-sign.md index a0f7694988f4..0c8226e4ffaf 100644 --- a/translations/de-DE/content/github/authenticating-to-github/error-agent-admitted-failure-to-sign.md +++ b/translations/de-DE/content/github/authenticating-to-github/error-agent-admitted-failure-to-sign.md @@ -9,7 +9,7 @@ versions: enterprise-server: '*' --- -Wenn Du auf einem Linux-Computer versuchst, eine SSH-Verbindung mit {% data variables.product.product_location %} herzustellen, wird möglicherweise die folgende Meldung im Terminal angezeigt: +Wenn Sie auf einem Linux-Computer versuchen, eine SSH-Verbindung mit {% data variables.product.product_location %} herzustellen, wird möglicherweise die folgende Meldung im Terminal angezeigt: ```shell $ ssh -vT git@{% data variables.command_line.codeblock %} diff --git a/translations/de-DE/content/github/authenticating-to-github/error-bad-file-number.md b/translations/de-DE/content/github/authenticating-to-github/error-bad-file-number.md index 497dacc480c5..f5f7598c33d1 100644 --- a/translations/de-DE/content/github/authenticating-to-github/error-bad-file-number.md +++ b/translations/de-DE/content/github/authenticating-to-github/error-bad-file-number.md @@ -1,6 +1,6 @@ --- title: 'Fehler: „Bad file number“ (Ungültige Dateinummer)' -intro: 'Diese Fehlermeldung bedeutet normalerweise, dass Du keine Verbindung zum Server herstellen konntest. Häufig wird der Fehler durch Firewalls und Proxy-Server verursacht.' +intro: Diese Fehlermeldung bedeutet normalerweise, dass Du keine Verbindung zum Server herstellen konntest. Häufig wird der Fehler durch Firewalls und Proxy-Server verursacht. redirect_from: - /articles/error-bad-file-number versions: @@ -36,7 +36,7 @@ $ git clone https://{% data variables.command_line.codeblock %}/username OpenSSH_5.6p1, OpenSSL 0.9.8r 8 Feb 2011 +> OpenSSH_8.1p1, LibreSSL 2.7.3 > debug1: Reading configuration data /Users/you/.ssh/config -> debug1: Reading configuration data /etc/ssh_config -> debug1: Applying options for * -> debug1: Connecting to {% data variables.command_line.codeblock %} [IP ADDRESS] port 22. +> debug1: Reading configuration data /etc/ssh/ssh_config +> debug1: /etc/ssh/ssh_config line 47: Applying options for * +> debug1: Connecting to {% data variables.command_line.codeblock %} port 22. ``` -Die Verbindung sollte über Port 22 hergestellt werden{% if currentVersion == "free-pro-team@latest" %}, es sei denn, Du überschreibst die Einstellungen, um [SSH über HTTPS](/articles/using-ssh-over-the-https-port) zu verwenden{% endif %}. +The connection should be made on port 22{% if currentVersion == "free-pro-team@latest" %}, unless you're overriding settings to use [SSH over HTTPS](/articles/using-ssh-over-the-https-port){% endif %}. -### Immer den „git“-Benutzer verwenden +### Always use the "git" user -Alle Verbindungen, auch die zu Remote-URLs, müssen als „git“-Benutzer hergestellt werden. Wenn Du versuchst, die Verbindung unter Deinem {% data variables.product.product_name %}-Benutzernamen herzustellen, tritt ein Fehler auf: +All connections, including those for remote URLs, must be made as the "git" user. If you try to connect with your {% data variables.product.product_name %} username, it will fail: ```shell $ ssh -T GITHUB-USERNAME@{% data variables.command_line.codeblock %} > Permission denied (publickey). ``` -Wenn Deine Verbindung fehlgeschlagen ist und Du eine Remote-URL mit Deinem {% data variables.product.product_name %}-Benutzernamen verwendest, kannst Du [die Remote-URL für die Verwendung des „git“-Benutzers ändern](/articles/changing-a-remote-s-url/). +If your connection failed and you're using a remote URL with your {% data variables.product.product_name %} username, you can [change the remote URL to use the "git" user](/articles/changing-a-remote-s-url/). -Du solltest Deine Verbindung mit der folgenden Eingabe überprüfen: +You should verify your connection by typing: ```shell $ ssh -T git@{% data variables.command_line.codeblock %} > Hi username! You've successfully authenticated... ``` -### Stelle sicher, dass Du einen Schlüssel hast, der verwendet wird +### Make sure you have a key that is being used {% mac %} {% data reusables.command_line.open_the_multi_os_terminal %} -2. Überprüfen Sie, dass Sie einen privaten Schlüssel erzeugt und in SSH geladen haben. Bei Verwendung von OpenSSH 6.7 oder älter: +2. Verify that you have a private key generated and loaded into SSH. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell - # starte den ssh-agent im Hintergrund + # start the ssh-agent in the background $ eval "$(ssh-agent -s)" > Agent pid 59566 $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` - Bei Verwendung von OpenSSH 6.8 oder neuer: + If you're using OpenSSH 6.8 or newer: ```shell - # starte den ssh-agent im Hintergrund + # start the ssh-agent in the background $ eval "$(ssh-agent -s)" > Agent pid 59566 $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + # start the ssh-agent in the background + $ eval "$(ssh-agent -s)" + > Agent pid 59566 + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} {% endmac %} @@ -78,54 +86,65 @@ $ ssh -T git@{% data variables.command_line.codeblock %} 1. {% data reusables.desktop.windows_git_bash_turn_on_ssh_agent %} {% data reusables.desktop.windows_git_for_windows_turn_on_ssh_agent %} -2. Überprüfen Sie, dass Sie einen privaten Schlüssel erzeugt und in SSH geladen haben. Bei Verwendung von OpenSSH 6.7 oder älter: +2. Verify that you have a private key generated and loaded into SSH. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` - Bei Verwendung von OpenSSH 6.8 oder neuer: + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} {% endwindows %} {% linux %} {% data reusables.command_line.open_the_multi_os_terminal %} -2. Überprüfen Sie, dass Sie einen privaten Schlüssel erzeugt und in SSH geladen haben. Bei Verwendung von OpenSSH 6.7 oder älter: +2. Verify that you have a private key generated and loaded into SSH. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell - # starte den ssh-agent im Hintergrund + # start the ssh-agent in the background $ eval "$(ssh-agent -s)" > Agent pid 59566 $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` - Bei Verwendung von OpenSSH 6.8 oder neuer: + If you're using OpenSSH 6.8 or newer: ```shell - # starte den ssh-agent im Hintergrund + # start the ssh-agent in the background $ eval "$(ssh-agent -s)" > Agent pid 59566 $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} + {% endlinux %} -Der Befehl `ssh-add` *sollte* eine lange Zeichenfolge an Ziffern und Buchstaben ausgeben. Wenn der Befehl nichts ausgibt, musst Du [einen neuen SSH-Schlüssel erzeugen](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) und ihn mit {% data variables.product.product_name %} verknüpfen. +The `ssh-add` command *should* print out a long string of numbers and letters. If it does not print anything, you will need to [generate a new SSH key](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) and associate it with {% data variables.product.product_name %}. {% tip %} -**Tipp**: Auf den meisten Systemen werden die standardmäßigen privaten Schlüssel (`~/.ssh/id_rsa`{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}, `~/.ssh/id_dsa`{% endif %} und `~/.ssh/identity`) automatisch zum SSH-Authentifizierungs-Agenten hinzugefügt. Normalerweise musst Du den Befehl `ssh-add path/to/key` nicht ausführen, es sei denn, Du überschreibst den Dateinamen, wenn Du einen Schlüssel erzeugst. +**Tip**: On most systems the default private keys (`~/.ssh/id_rsa` and `~/.ssh/identity`) are automatically added to the SSH authentication agent. You shouldn't need to run `ssh-add path/to/key` unless you override the file name when you generate a key. {% endtip %} -#### Weitere Informationen abrufen +#### Getting more details -Um zu prüfen, ob der Schlüssel verwendet wird, kannst Du auch versuchen, eine Verbindung zu `git@{% data variables.command_line.backticks %}` herzustellen: +You can also check that the key is being used by trying to connect to `git@{% data variables.command_line.backticks %}`: ```shell $ ssh -vT git@{% data variables.command_line.codeblock %} @@ -143,7 +162,7 @@ $ ssh -vT git@{% data variables.command_line.codeblock %} > Permission denied (publickey). ``` -In diesem Beispiel hatten wir keine Schlüssel, die SSH verwenden konnte. Die „-1“ am Ende der „identitiy file“-Zeilen bedeutet, dass SSH keine entsprechende Datei finden konnte. Weiter unten weisen auch die „Trying private key“-Zeilen darauf hin, dass keine Datei gefunden wurde. Wenn eine Datei vorhanden wäre, würde dort „1“ respektive „Offering public key“ (öffentlicher Schlüssel angeboten) stehen: +In that example, we did not have any keys for SSH to use. The "-1" at the end of the "identity file" lines means SSH couldn't find a file to use. Later on, the "Trying private key" lines also indicate that no file was found. If a file existed, those lines would be "1" and "Offering public key", respectively: ```shell $ ssh -vT git@{% data variables.command_line.codeblock %} @@ -155,77 +174,89 @@ $ ssh -vT git@{% data variables.command_line.codeblock %} > debug1: Offering RSA public key: /Users/you/.ssh/id_rsa ``` -### Überprüfen, ob der öffentliche Schlüssel an Dein Konto angehängt ist +### Verify the public key is attached to your account -Du musst Deinen öffentlichen Schlüssel für {% data variables.product.product_name %} bereitstellen, um eine sichere Verbindung herzustellen. +You must provide your public key to {% data variables.product.product_name %} to establish a secure connection. {% mac %} -1. Öffne das Terminal. -2. Starten Sie den SSH-Agenten im Hintergrund. +1. Open Terminal. +2. Start SSH agent in the background. ```shell $ eval "$(ssh-agent -s)" > Agent pid 59566 ``` -3. Suchen und notieren Sie Ihren öffentlichen Schlüssel-Fingerprint. Bei Verwendung von OpenSSH 6.7 oder älter: +3. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` - Bei Verwendung von OpenSSH 6.8 oder neuer: + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -6. Vergleichen Sie die Liste der SSH-Schlüssel mit der Ausgabe des Befehls `ssh-add`. ![SSH-Schlüssel-Auflistung in {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png) +6. Compare the list of SSH keys with the output from the `ssh-add` command. +![SSH key listing in {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png) {% endmac %} {% windows %} -1. Öffne die Befehlszeile. -2. Starten Sie den SSH-Agenten im Hintergrund. +1. Open the command line. +2. Start SSH agent in the background. ```shell $ ssh-agent -s > Agent pid 59566 ``` -3. Suchen und notieren Sie Ihren öffentlichen Schlüssel-Fingerprint. Bei Verwendung von OpenSSH 6.7 oder älter: +3. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` - Bei Verwendung von OpenSSH 6.8 oder neuer: + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -6. Vergleichen Sie die Liste der SSH-Schlüssel mit der Ausgabe des Befehls `ssh-add`. ![SSH-Schlüssel-Auflistung in {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png) +6. Compare the list of SSH keys with the output from the `ssh-add` command. +![SSH key listing in {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png) {% endwindows %} {% linux %} -1. Öffne das Terminal. -2. Starten Sie den SSH-Agenten im Hintergrund. +1. Open Terminal. +2. Start SSH agent in the background. ```shell $ eval "$(ssh-agent -s)" > Agent pid 59566 ``` -3. Suchen und notieren Sie Ihren öffentlichen Schlüssel-Fingerprint. Bei Verwendung von OpenSSH 6.7 oder älter: +3. Find and take a note of your public key fingerprint. If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` - Bei Verwendung von OpenSSH 6.8 oder neuer: + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) @@ -233,14 +264,15 @@ Du musst Deinen öffentlichen Schlüssel für {% data variables.product.product_ {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -6. Vergleichen Sie die Liste der SSH-Schlüssel mit der Ausgabe des Befehls `ssh-add`. ![SSH-Schlüssel-Auflistung in {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png) +6. Compare the list of SSH keys with the output from the `ssh-add` command. +![SSH key listing in {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png) {% endlinux %} -Wenn Du Deinen öffentlichen Schlüssel in {% data variables.product.product_name %} nicht siehst, musst Du [Deinen SSH-Schlüssel zu {% data variables.product.product_name %} hinzufügen](/articles/adding-a-new-ssh-key-to-your-github-account), um ihn mit Deinem Computer zu verknüpfen. +If you don't see your public key in {% data variables.product.product_name %}, you'll need to [add your SSH key to {% data variables.product.product_name %}](/articles/adding-a-new-ssh-key-to-your-github-account) to associate it with your computer. {% warning %} -**Warnung:** Wenn Du einen SSH-Schlüssel siehst, der Dir auf {% data variables.product.product_name %} unbekannt ist, solltest Du ihn sofort löschen und Dich für weitere Hilfe an den {% data variables.contact.contact_support %} wenden. Ein Dir unbekannter öffentlicher Schlüssel kann ein Hinweis auf ein Sicherheitsproblem sein. Weitere Informationen findest Du unter „[SSH-Schlüssel überprüfen](/articles/reviewing-your-ssh-keys).“ +**Warning**: If you see an SSH key you're not familiar with on {% data variables.product.product_name %}, delete it immediately and contact {% data variables.contact.contact_support %}, for further help. An unidentified public key may indicate a possible security concern. For more information, see "[Reviewing your SSH keys](/articles/reviewing-your-ssh-keys)." {% endwarning %} diff --git a/translations/de-DE/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-other-user.md b/translations/de-DE/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-other-user.md index a513ba6adb6b..bd68a511a565 100644 --- a/translations/de-DE/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-other-user.md +++ b/translations/de-DE/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-other-user.md @@ -1,6 +1,6 @@ --- title: 'Fehler: „Permission to user/repo denied to other-user“ (Berechtigung für „user/repo" für „other-user" verweigert)' -intro: 'Diese Fehlermeldung bedeutet, dass der Schlüssel, den Du beim Push verwendest, an ein Konto angehängt ist, das keinen Zugriff auf das Repository hat.' +intro: Diese Fehlermeldung bedeutet, dass der Schlüssel, den Du beim Push verwendest, an ein Konto angehängt ist, das keinen Zugriff auf das Repository hat. redirect_from: - /articles/error-permission-to-user-repo-denied-to-other-user - /articles/error-permission-to-userrepo-denied-to-other-user diff --git a/translations/de-DE/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md b/translations/de-DE/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md index 29f977aa5eef..4794a07accd8 100644 --- a/translations/de-DE/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md +++ b/translations/de-DE/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md @@ -1,6 +1,6 @@ --- title: 'Fehler: „SSL certificate problem, verify that the CA cert is OK“ (SSL-Zertifikatsproblem, verifiziere, dass das CA-Zertifikat OK ist)' -intro: 'Diese Fehlermeldung bedeutet, dass Dein CA-Root-Zertifikat veraltet ist. Wenn Dein CA-Root-Zertifikat aktualisiert werden muss, kannst Du keine Inhalte von {% data variables.product.product_name %}-Repositorys abrufen oder dorthin übertragen.' +intro: 'Diese Fehlermeldung bedeutet, dass Dein CA-Root-Zertifikat veraltet ist. Wenn Ihr CA-Root-Zertifikat aktualisiert werden muss, können Sie keine Inhalte von {% data variables.product.product_name %}-Repositorys abrufen oder dorthin pushen.' redirect_from: - /articles/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok versions: @@ -10,8 +10,8 @@ versions: Die angezeigte Fehlermeldung sieht ähnlich wie die folgende aus: ```shell -$ git push -u github.master -> fatal: 'github.master' does not appear to be a git repository +$ git push -u github.main +> fatal: 'github.main' does not appear to be a git repository > fatal: The remote end hung up unexpectedly $ git pull -u github diff --git a/translations/de-DE/content/github/authenticating-to-github/error-were-doing-an-ssh-key-audit.md b/translations/de-DE/content/github/authenticating-to-github/error-were-doing-an-ssh-key-audit.md index cb3209f3c4a3..d965ce681176 100644 --- a/translations/de-DE/content/github/authenticating-to-github/error-were-doing-an-ssh-key-audit.md +++ b/translations/de-DE/content/github/authenticating-to-github/error-were-doing-an-ssh-key-audit.md @@ -1,6 +1,6 @@ --- title: 'Fehler: „We''re doing an SSH key audit“ (Es wird ein SSH-Schlüsselaudit durchgeführt)' -intro: 'Diese Fehlermeldung bedeutet, dass der SSH-Schlüssel, den Du für die Ausführung eines Git-Vorgangs verwendest, nicht verifiziert ist.' +intro: Diese Fehlermeldung bedeutet, dass der SSH-Schlüssel, den Du für die Ausführung eines Git-Vorgangs verwendest, nicht verifiziert ist. redirect_from: - /articles/error-we-re-doing-an-ssh-key-audit - /articles/error-were-doing-an-ssh-key-audit diff --git a/translations/de-DE/content/github/authenticating-to-github/generating-a-new-gpg-key.md b/translations/de-DE/content/github/authenticating-to-github/generating-a-new-gpg-key.md index 0721d7fc35ea..c9cc24b220cc 100644 --- a/translations/de-DE/content/github/authenticating-to-github/generating-a-new-gpg-key.md +++ b/translations/de-DE/content/github/authenticating-to-github/generating-a-new-gpg-key.md @@ -14,7 +14,7 @@ versions: {% note %} -**Hinweis:** Bevor Du einen neuen GPG-Schlüssel erzeugst, musst Du unbedingt Deine E-Mail-Adresse verifizieren. Wenn Du Deine E-Mail-Adresse noch nicht verifiziert hast, kannst Du keine Commits und Tags mit GPG signieren.{% if currentVersion == "free-pro-team@latest" %} Weitere Informationen findest Du unter „[E-Mail-Adresse verifizieren](/articles/verifying-your-email-address)“.{% endif %} +**Hinweis:** Bevor Du einen neuen GPG-Schlüssel erzeugst, musst Du unbedingt Deine E-Mail-Adresse verifizieren. If you haven't verified your email address, you won't be able to sign commits and tags with GPG.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[Verifying your email address](/articles/verifying-your-email-address)."{% endif %} {% endnote %} @@ -37,7 +37,7 @@ versions: {% note %} - **Hinweis:** Wenn Du zur Eingabe Deiner E-Mail-Adresse aufgefordert wirst, stelle sicher, dass Du die verifizierte E-Mail-Adresse für Dein GitHub-Konto eingibst. {% data reusables.gpg.private-email %} {% if currentVersion == "free-pro-team@latest" %} Weitere Informationen findest Du unter „[Deine E-Mail-Adresse verifizieren](/articles/verifying-your-email-address)“ und „[Deine Commit-E-Mail-Adresse festlegen](/articles/setting-your-commit-email-address)“.{% endif %} + **Hinweis:** Wenn Du zur Eingabe Deiner E-Mail-Adresse aufgefordert wirst, stelle sicher, dass Du die verifizierte E-Mail-Adresse für Dein GitHub-Konto eingibst. {% data reusables.gpg.private-email %} {% if currentVersion == "free-pro-team@latest" %} For more information, see "[Verifying your email address](/articles/verifying-your-email-address)" and "[Setting your commit email address](/articles/setting-your-commit-email-address)."{% endif %} {% endnote %} diff --git a/translations/de-DE/content/github/authenticating-to-github/keeping-your-account-and-data-secure.md b/translations/de-DE/content/github/authenticating-to-github/keeping-your-account-and-data-secure.md index bfff7b163a72..db6eaeaa589a 100644 --- a/translations/de-DE/content/github/authenticating-to-github/keeping-your-account-and-data-secure.md +++ b/translations/de-DE/content/github/authenticating-to-github/keeping-your-account-and-data-secure.md @@ -1,6 +1,6 @@ --- title: Dein Konto und Deine Daten schützen -intro: 'Zur Sicherheit Deiner persönlichen Daten solltest Du Dein {% data variables.product.product_name %}-Konto und die dazugehörigen Daten schützen.' +intro: 'Zur Sicherheit Ihrer persönlichen Daten sollten Sie Ihr {% data variables.product.product_name %}-Konto und die dazugehörigen Daten schützen.' mapTopic: true redirect_from: - /articles/keeping-your-account-and-data-secure diff --git a/translations/de-DE/content/github/authenticating-to-github/managing-commit-signature-verification.md b/translations/de-DE/content/github/authenticating-to-github/managing-commit-signature-verification.md index 7449ce44389d..57ebdec1de81 100644 --- a/translations/de-DE/content/github/authenticating-to-github/managing-commit-signature-verification.md +++ b/translations/de-DE/content/github/authenticating-to-github/managing-commit-signature-verification.md @@ -1,6 +1,6 @@ --- title: Verifizierung einer Commit-Signatur verwalten -intro: 'Du kannst Deine Arbeit lokal mit GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} oder S/MIME{% endif %} signieren. {% data variables.product.product_name %} verifiziert diese Signaturen, damit andere Personen wissen, dass Deine Commits aus einer vertrauenswürdigen Quelle stammen.{% if currentVersion == "free-pro-team@latest" %} {% data variables.product.product_name %} signiert Commits automatisch, wenn Du sie über die {% data variables.product.product_name %}-Weboberfläche erstellt hast.{% endif %}' +intro: 'You can sign your work locally using GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} or S/MIME{% endif %}. {% data variables.product.product_name %} will verify these signatures so other people will know that your commits come from a trusted source.{% if currentVersion == "free-pro-team@latest" %} {% data variables.product.product_name %} will automatically sign commits you make using the {% data variables.product.product_name %} web interface.{% endif %}' redirect_from: - /articles/generating-a-gpg-key/ - /articles/signing-commits-with-gpg/ diff --git a/translations/de-DE/content/github/authenticating-to-github/preventing-unauthorized-access.md b/translations/de-DE/content/github/authenticating-to-github/preventing-unauthorized-access.md index a7a9fe91b9a4..390c462878ea 100644 --- a/translations/de-DE/content/github/authenticating-to-github/preventing-unauthorized-access.md +++ b/translations/de-DE/content/github/authenticating-to-github/preventing-unauthorized-access.md @@ -1,6 +1,6 @@ --- title: Nicht autorisierten Zugriff verhindern -intro: 'Du wirst allenfalls durch die Medien auf einen Sicherheitsvorfall aufmerksam gemacht, beispielsweise auf die Entdeckung des [Heartbleed bug](http://heartbleed.com/), oder Dein Computer könnte gestohlen werden, während Du bei {% data variables.product.product_location %} angemeldet bist. In solchen Fällen kannst Du durch das Ändern Deines Passworts den unerwünschten zukünftigen Zugriff auf Dein Konto und Deine Projekte verhindern.' +intro: 'Sie könnten durch die Medien auf einen Sicherheitsvorfall aufmerksam gemacht werden, z. B. auf die Entdeckung des [Heartbleed-Bugs](http://heartbleed.com/), oder Ihr Computer könnte gestohlen werden, während Sie bei {% data variables.product.product_location %} angemeldet sind. In solchen Fällen kannst Du durch das Ändern Deines Passworts den unerwünschten zukünftigen Zugriff auf Dein Konto und Deine Projekte verhindern.' redirect_from: - /articles/preventing-unauthorized-access versions: diff --git a/translations/de-DE/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md b/translations/de-DE/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md index d756d17c8f8b..82ee0da253b9 100644 --- a/translations/de-DE/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md +++ b/translations/de-DE/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md @@ -81,7 +81,8 @@ Wenn Du nicht in der Lage bist, den Zugang zu Deinem Konto wieder herzustellen, 1. Rufe auf Facebook die Seite [Security Settings](https://www.facebook.com/settings?tab=security) (Sicherheitseinstellungen) auf, und klicke dann auf **Recover Accounts Elsewhere**. ![Facebook-Seite mit Sicherheitseinstellungen und Link zu „Recover Accounts Elsewhere"](/assets/images/help/settings/security-facebook-security-settings-page.png) 2. Klicke auf das Wiederherstellungstoken, das mit Deinem {% data variables.product.product_name %}-Konto verknüpft ist. ![Liste der auf Facebook gespeicherten Wiederherstellungstoken](/assets/images/help/settings/security-github-rae-token-on-facebook.png) 3. Um Dein Kontowiederherstellungstoken einzulösen, klicke auf **Recover This Account** (Dieses Konto wiederherstellen). Ein neues Fenster wird geöffnet, das Dich auf {% data variables.product.product_name %} zurückführt. ![Modales Feld mit Informationen zu Deinem Wiederherstellungstoken und Schaltfläche „Recover This Account“ (Dieses Konto wiederherstellen)](/assets/images/help/settings/security-recover-account-facebook.png) -4. Benachrichtige den {% data variables.contact.contact_support %}, dass Dein Kontowiederherstellungstoken bereit für den Review ist. +4. Kontakt +{% data variables.contact.contact_support %} to let them know that your account recovery token is ready for review. {% endif %} ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md b/translations/de-DE/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md index 43379ae00e70..0d470f1c1084 100644 --- a/translations/de-DE/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md +++ b/translations/de-DE/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md @@ -19,7 +19,7 @@ Die Datei aus dem letzten Commit kannst Du auch mit `git rm` entfernen. Informat **Warnung: Wenn Du einen Commit per Push auf {% data variables.product.product_name %} überträgst, solltest Du alle darin enthaltenen Daten als kompromittiert betrachten.** Falls Du ein Passwort mitgegeben hast, ändere es! Falls Du einen Schlüssel mitgegeben hast, generiere einen neuen. -In diesem Artikel erfährst Du, wie Du Commits mit vertraulichen Daten für alle Branches und Tags Deines {% data variables.product.product_name %}-Repositorys unzugänglich machst. Nicht verhindern lässt sich dadurch jedoch, dass diese Commits nach wie vor in Klonen oder Forks Deines Repositorys zugänglich sind, entweder direkt über ihre SHA-1-Hashes in zwischengespeicherten Ansichten auf {% data variables.product.product_name %} oder über alle referenzierten Pull Requests. An bestehenden Klonen oder Forks Deines Repositorys kannst Du nichts ändern. Zwischengespeicherte Ansichten und Referenzen auf vertrauliche Daten in Pull Requests auf {% data variables.product.product_name %} kannst Du jedoch dauerhaft durch den {% data variables.contact.contact_support %} entfernen lassen. +In diesem Artikel erfährst Du, wie Du Commits mit vertraulichen Daten für alle Branches und Tags Deines {% data variables.product.product_name %}-Repositorys unzugänglich machst. Nicht verhindern lässt sich dadurch jedoch, dass diese Commits nach wie vor in Klonen oder Forks Ihres Repositorys, in zwischengespeicherten Ansichten auf {% data variables.product.product_name %} direkt über ihre SHA-1-Hashes und über alle referenzierten Pull Requests zugänglich sind. An bestehenden Klonen oder Forks Ihres Repositorys können Sie nichts ändern. Zwischengespeicherte Ansichten und Referenzen auf sensible Daten in Pull Requests auf {% data variables.product.product_name %} können Sie jedoch dauerhaft durch den {% data variables.contact.contact_support %} entfernen lassen. {% endwarning %} @@ -74,7 +74,7 @@ Zur Veranschaulichung der Funktionsweise von `git filter-branch` zeigen wir Dir, "git rm --cached --ignore-unmatch PATH-TO-YOUR-FILE-WITH-SENSITIVE-DATA" \ --prune-empty --tag-name-filter cat -- --all > Rewrite 48dc599c80e20527ed902928085e7861e6b3cbe6 (266/266) - > Ref 'refs/heads/master' was rewritten + > Ref 'refs/heads/main' was rewritten ``` {% note %} @@ -89,7 +89,7 @@ Zur Veranschaulichung der Funktionsweise von `git filter-branch` zeigen wir Dir, $ echo "YOUR-FILE-WITH-SENSITIVE-DATA" >> .gitignore $ git add .gitignore $ git commit -m "Add YOUR-FILE-WITH-SENSITIVE-DATA to .gitignore" - > [master 051452f] Add YOUR-FILE-WITH-SENSITIVE-DATA to .gitignore + > [main 051452f] Add YOUR-FILE-WITH-SENSITIVE-DATA to .gitignore > 1 files changed, 1 insertions(+), 0 deletions(-) ``` 5. Vergewissere Dich, dass Du alles aus Deinem Repository-Verlauf entfernt hast, was Du entfernen wolltest, und dass alle Deine Branches ausgecheckt wurden. @@ -102,7 +102,7 @@ Zur Veranschaulichung der Funktionsweise von `git filter-branch` zeigen wir Dir, > Writing objects: 100% (1058/1058), 148.85 KiB, done. > Total 1058 (delta 590), reused 602 (delta 378) > To https://{% data variables.command_line.codeblock %}/YOUR-USERNAME/YOUR-REPOSITORY.git - > + 48dc599...051452f master -> master (forced update) + > + 48dc599...051452f main -> main (forced update) ``` 7. Um die Datei mit vertraulichen Daten aus [Deinen getaggten Releases](/articles/about-releases) zu entfernen, musst Du auch einen „force-push“ an Deine Git-Tags ausführen: ```shell @@ -113,7 +113,7 @@ Zur Veranschaulichung der Funktionsweise von `git filter-branch` zeigen wir Dir, > Writing objects: 100% (321/321), 331.74 KiB | 0 bytes/s, done. > Total 321 (delta 124), reused 269 (delta 108) > To https://{% data variables.command_line.codeblock %}/YOUR-USERNAME/YOUR-REPOSITORY.git - > + 48dc599...051452f master -> master (forced update) + > + 48dc599...051452f main -> main (forced update) ``` 8. Kontaktiere den {% data variables.contact.contact_support %}, um ihn zu bitten, zwischengespeicherte Ansichten und Referenzen auf die vertraulichen Daten in Pull Requests auf {% data variables.product.product_name %} zu entfernen. 9. Weise Deine Mitarbeiter an, ein [Rebase](https://git-scm.com/book/en/Git-Branching-Rebasing), *kein* Merge, aller Branches auszuführen, die sie aus Deinem alten (unbrauchbaren) Repository-Verlauf erstellt haben. Durch einen Merge-Commit würde womöglich der gesamte unbrauchbare Verlauf wiederhergestellt, den zu entfernen Du Dir gerade so viel Mühe gemacht hast. @@ -130,7 +130,7 @@ Zur Veranschaulichung der Funktionsweise von `git filter-branch` zeigen wir Dir, ``` {% note %} - **Hinweis:** Alternativ kannst Du den gefilterten Verlauf per Push in ein neues, noch leeres Repository übertragen und dann einen neuen Klon aus {% data variables.product.product_name %} erstellen. + **Hinweis:** Alternativ können Sie den gefilterten Verlauf per Push in ein neues, noch leeres Repository übertragen und dann einen neuen Klon aus {% data variables.product.product_name %} erstellen. {% endnote %} @@ -138,7 +138,7 @@ Zur Veranschaulichung der Funktionsweise von `git filter-branch` zeigen wir Dir, Durch einige einfache Tricks vermeidest Du den versehentlichen Commit von Änderungen, die nicht festgeschrieben werden sollen: -- Verwende zum Committen von Änderungen ein visuelles Programm wie [{% data variables.product.prodname_desktop %}](https://desktop.github.com/) oder [gitk](https://git-scm.com/docs/gitk). In visuellen Programmen ist meist leichter erkennbar, welche Dateien durch einen Commit hinzugefügt, gelöscht und geändert werden. +- Verwenden Sie zum Festschreiben von Änderungen ein visuelles Programm wie [{% data variables.product.prodname_desktop %}](https://desktop.github.com/) oder [gitk](https://git-scm.com/docs/gitk). In visuellen Programmen ist meist leichter erkennbar, welche Dateien durch einen Commit hinzugefügt, gelöscht und geändert werden. - Vermeide in der Befehlszeile möglichst die Verwendung der catch-all-Befehle `git add .` und `git commit -a` – verwende stattdessen die Befehle `git add filename` und `git rm filename` für das Staging einzelner Dateien. - Verwende `git add --interactive`, um die Änderungen jeder Datei einzeln zu überprüfen und per Staging für den Commit bereitzustellen. - Verwende `git diff --cached`, um die Änderungen zu überprüfen, die Du per Staging für den Commit bereitgestellt hast. Du siehst dadurch die exakte Differenz, die `git commit` generieren wird, sofern Du nicht das Flag `-a` verwendest. diff --git a/translations/de-DE/content/github/authenticating-to-github/reviewing-your-authorized-integrations.md b/translations/de-DE/content/github/authenticating-to-github/reviewing-your-authorized-integrations.md index a05f79e8a188..c7fb14e1ed65 100644 --- a/translations/de-DE/content/github/authenticating-to-github/reviewing-your-authorized-integrations.md +++ b/translations/de-DE/content/github/authenticating-to-github/reviewing-your-authorized-integrations.md @@ -1,6 +1,6 @@ --- title: Deine autorisierten Integrationen überprüfen -intro: 'Du kannst Deine autorisierten Integrationen überprüfen, um den Zugriff der einzelnen Integrationen auf Dein Konto und Deine Daten zu prüfen.' +intro: Du kannst Deine autorisierten Integrationen überprüfen, um den Zugriff der einzelnen Integrationen auf Dein Konto und Deine Daten zu prüfen. redirect_from: - /articles/reviewing-your-authorized-integrations versions: diff --git a/translations/de-DE/content/github/authenticating-to-github/reviewing-your-deploy-keys.md b/translations/de-DE/content/github/authenticating-to-github/reviewing-your-deploy-keys.md index 861e50083449..c1cf0d2e9770 100644 --- a/translations/de-DE/content/github/authenticating-to-github/reviewing-your-deploy-keys.md +++ b/translations/de-DE/content/github/authenticating-to-github/reviewing-your-deploy-keys.md @@ -1,6 +1,6 @@ --- title: Deine Deployment-Schlüssel überprüfen -intro: 'Du solltest Deine Deployment-Schlüssel überprüfen, um sicherzustellen, dass keine unautorisierten (und möglicherweise kompromittierten) Schlüssel vorhanden sind. Vorhandene Deployment-Schlüssel, die gültig sind, kannst Du auch genehmigen.' +intro: Du solltest Deine Deployment-Schlüssel überprüfen, um sicherzustellen, dass keine unautorisierten (und möglicherweise kompromittierten) Schlüssel vorhanden sind. Vorhandene Deployment-Schlüssel, die gültig sind, kannst Du auch genehmigen. redirect_from: - /articles/reviewing-your-deploy-keys versions: diff --git a/translations/de-DE/content/github/authenticating-to-github/reviewing-your-security-log.md b/translations/de-DE/content/github/authenticating-to-github/reviewing-your-security-log.md index e64472f4e9fe..38e933477191 100644 --- a/translations/de-DE/content/github/authenticating-to-github/reviewing-your-security-log.md +++ b/translations/de-DE/content/github/authenticating-to-github/reviewing-your-security-log.md @@ -1,6 +1,6 @@ --- -title: Dein Sicherheitsprotokoll überprüfen -intro: 'Du kannst das Sicherheitsprotokoll für Dein Benutzerkonto überprüfen, um Dich betreffende Aktionen besser zu verstehen, die von Dir oder anderen Benutzern durchgeführt wurden.' +title: Reviewing your security log +intro: You can review the security log for your user account to better understand actions you've performed and actions others have performed that involve you. redirect_from: - /articles/reviewing-your-security-log versions: @@ -8,233 +8,238 @@ versions: enterprise-server: '*' --- -### Zugriff auf Dein Sicherheitsprotokoll +### Accessing your security log -Das Sicherheitsprotokoll listet alle in den letzten 90 Tagen durchgeführten Aktionen auf{% if currentVersion ver_lt "enterprise-server@2.20" %}, maximal 50{% endif %}. +The security log lists all actions performed within the last 90 days{% if currentVersion ver_lt "enterprise-server@2.20" %}, up to 50{% endif %}. {% data reusables.user_settings.access_settings %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -2. Klicke in der Seitenleiste für Benutzereinstellungen auf **Security log** (Sicherheitsprotokoll). ![Registerkarte „Security log" (Sicherheitsprotokoll)](/assets/images/help/settings/audit-log-tab.png) +2. In the user settings sidebar, click **Security log**. + ![Security log tab](/assets/images/help/settings/audit-log-tab.png) {% else %} {% data reusables.user_settings.security %} -3. Dein Protokoll wird unter dem Eintrag „Security history“ (Sicherheitsverlauf) angezeigt. ![Sicherheitsprotokoll](/assets/images/help/settings/user_security_log.png) -4. Klicken Sie auf einen Eintrag, um weitere Informationen zum betreffenden Ereignis anzuzeigen. ![Sicherheitsprotokoll](/assets/images/help/settings/user_security_history_action.png) +3. Under "Security history," your log is displayed. + ![Security log](/assets/images/help/settings/user_security_log.png) +4. Click on an entry to see more information about the event. + ![Security log](/assets/images/help/settings/user_security_history_action.png) {% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -### Dein Sicherheitsprotokoll durchsuchen +### Searching your security log {% data reusables.audit_log.audit-log-search %} -#### Suche nach der Art der durchgeführten Aktion +#### Search based on the action performed {% else %} -### Ereignisse im Sicherheitsprotokoll verstehen - -Die Aktionen in Deinem Sicherheitsprotokoll sind nach folgenden Kategorien gruppiert:{% endif %} -| Kategoriename | Beschreibung | -| --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |{% if currentVersion == "free-pro-team@latest" %} -| `account_recovery_token` | Umfasst alle Aktivitäten in Verbindung mit dem [Hinzufügen eines Wiederherstellungstokens](/articles/configuring-two-factor-authentication-recovery-methods). | -| `Abrechnung` | Umfasst alle Aktivitäten in Verbindung mit Deinen Abrechnungsinformationen. | -| `marketplace_agreement_signature (Unterzeichnung Marketplace-Vereinbarung)` | Umfasst alle Aktivitäten in Verbindung mit der Unterzeichnung der {% data variables.product.prodname_marketplace %}-Entwicklervereinbarung. | -| `marketplace_listing (Eintrag auf Marketplace)` | Umfasst alle Aktivitäten in Verbindung mit dem Eintragen von Apps auf {% data variables.product.prodname_marketplace %}.{% endif %} -| `oauth_access` | Umfasst alle Aktivitäten in Verbindung mit [{% data variables.product.prodname_oauth_app %}s](/articles/authorizing-oauth-apps), zu denen Du eine Verbindung hergestellt hast.{% if currentVersion == "free-pro-team@latest" %} -| `payment_method` | Umfasst alle Aktivitäten in Verbindung mit der Bezahlung Deines {% data variables.product.prodname_dotcom %}-Abonnements.{% endif %} -| `profile_picture` | Umfasst alle Aktivitäten in Verbindung mit Deinem Profilbild. | -| `project (Projekt)` | Umfasst alle Aktivitäten in Verbindung mit Projektboards. | -| `public_key` | Umfasst alle Aktivitäten in Verbindung mit [Deinen öffentlichen SSH-Schlüsseln](/articles/adding-a-new-ssh-key-to-your-github-account). | -| `repo` | Umfasst alle Aktivitäten in Verbindung mit den Repositorys, deren Inhaber Du bist.{% if currentVersion == "free-pro-team@latest" %} -| `sponsors` | Umfasst alle Ereignisse in Verbindung mit {% data variables.product.prodname_sponsors %} und Sponsorenschaltflächen (siehe „[Informationen zu {% data variables.product.prodname_sponsors %}](/articles/about-github-sponsors)“ und „[Sponsorenschaltfläche in Deinem Repository anzeigen](/articles/displaying-a-sponsor-button-in-your-repository)“){% endif %}{% if currentVersion != "free-pro-team@latest" %} -| `Team` | Umfasst alle Aktivitäten in Verbindung mit Teams, deren Mitglied Du bist.{% endif %} -| `two_factor_authentication` | Umfasst alle Aktivitäten in Verbindung mit der [Zwei-Faktor-Authentifizierung](/articles/securing-your-account-with-two-factor-authentication-2fa). | -| `Benutzer` | Umfasst alle Aktivitäten in Verbindung mit Deinem Konto. | - -Eine Beschreibung der Ereignisse dieser Kategorien findest Du nachfolgend. +### Understanding events in your security log + +Actions listed in your security log are grouped within the following categories: +{% endif %} + +| Category Name | Description +|------------------|-------------------{% if currentVersion == "free-pro-team@latest" %} +| `account_recovery_token` | Contains all activities related to [adding a recovery token](/articles/configuring-two-factor-authentication-recovery-methods). +| `billing` | Contains all activities related to your billing information. +| `marketplace_agreement_signature` | Contains all activities related to signing the {% data variables.product.prodname_marketplace %} Developer Agreement. +| `marketplace_listing` | Contains all activities related to listing apps in {% data variables.product.prodname_marketplace %}.{% endif %} +| `oauth_access` | Contains all activities related to [{% data variables.product.prodname_oauth_app %}s](/articles/authorizing-oauth-apps) you've connected with.{% if currentVersion == "free-pro-team@latest" %} +| `payment_method` | Contains all activities related to paying for your {% data variables.product.prodname_dotcom %} subscription.{% endif %} +| `profile_picture` | Contains all activities related to your profile picture. +| `project` | Contains all activities related to project boards. +| `public_key` | Contains all activities related to [your public SSH keys](/articles/adding-a-new-ssh-key-to-your-github-account). +| `repo` | Contains all activities related to the repositories you own.{% if currentVersion == "free-pro-team@latest" %} +| `sponsors` | Contains all events related to {% data variables.product.prodname_sponsors %} and sponsor buttons (see "[About {% data variables.product.prodname_sponsors %}](/articles/about-github-sponsors)" and "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)"){% endif %}{% if currentVersion != "free-pro-team@latest" %} +| `team` | Contains all activities related to teams you are a part of.{% endif %} +| `two_factor_authentication` | Contains all activities related to [two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa). +| `user` | Contains all activities related to your account. + +A description of the events within these categories is listed below. {% if currentVersion == "free-pro-team@latest" %} -#### Kategorie `account_recovery_token` +#### The `account_recovery_token` category -| Aktion | Beschreibung | -| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| confirm | Wird ausgelöst, wenn Du [ein neues Token erfolgreich bei einem Wiederherstellungsanbieter speicherst](/articles/configuring-two-factor-authentication-recovery-methods). | -| recover | Wird ausgelöst, wenn Du [ein Kontowiederherstellungstoken erfolgreich einlöst](/articles/recovering-your-account-if-you-lose-your-2fa-credentials). | -| recover_error | Wird ausgelöst, wenn ein Token verwendet wird, {% data variables.product.prodname_dotcom %} dieses aber nicht validieren kann. | +| Action | Description +|------------------|------------------- +| confirm | Triggered when you successfully [store a new token with a recovery provider](/articles/configuring-two-factor-authentication-recovery-methods). +| recover | Triggered when you successfully [redeem an account recovery token](/articles/recovering-your-account-if-you-lose-your-2fa-credentials). +| recover_error | Triggered when a token is used but {% data variables.product.prodname_dotcom %} is not able to validate it. -#### Kategorie `billing` (Abrechnung) +#### The `billing` category -| Aktion | Beschreibung | -| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| change_billing_type | Wird ausgelöst, wenn Du [Deine Zahlungsmethode](/articles/adding-or-editing-a-payment-method) für {% data variables.product.prodname_dotcom %} änderst. | -| change_email | Wird ausgelöst, wenn Du [Deine E-Mail-Adresse änderst](/articles/changing-your-primary-email-address). | +| Action | Description +|------------------|------------------- +| change_billing_type | Triggered when you [change how you pay](/articles/adding-or-editing-a-payment-method) for {% data variables.product.prodname_dotcom %}. +| change_email | Triggered when you [change your email address](/articles/changing-your-primary-email-address). -#### Kategorie `marketplace_agreement_signature` +#### The `marketplace_agreement_signature` category -| Aktion | Beschreibung | -| ------ | -------------------------------------------------------------------------------------------------------------------- | -| create | Wird ausgelöst, wenn Du die {% data variables.product.prodname_marketplace %}-Entwicklervereinbarung signierst. | +| Action | Description +|------------------|------------------- +| create | Triggered when you sign the {% data variables.product.prodname_marketplace %} Developer Agreement. -#### Kategorie `marketplace_listing` (Eintrag auf Marketplace) +#### The `marketplace_listing` category -| Aktion | Beschreibung | -| ---------- | ---------------------------------------------------------------------------------------------------------------------------------- | -| genehmigen | Wird ausgelöst, wenn Dein Eintrag für die Aufnahme in {% data variables.product.prodname_marketplace %} genehmigt wird. | -| create | Wird ausgelöst, wenn Du einen Eintrag für Deine App in {% data variables.product.prodname_marketplace %} erstellst. | -| delist | Wird ausgelöst, wenn Dein Eintrag von {% data variables.product.prodname_marketplace %} entfernt wird. | -| redraft | Wird ausgelöst, wenn Dein Eintrag in den Entwurfsstatus zurückversetzt wird. | -| reject | Wird ausgelöst, wenn Dein Eintrag für die Aufnahme in {% data variables.product.prodname_marketplace %} nicht genehmigt wird. | +| Action | Description +|------------------|------------------- +| approve | Triggered when your listing is approved for inclusion in {% data variables.product.prodname_marketplace %}. +| create | Triggered when you create a listing for your app in {% data variables.product.prodname_marketplace %}. +| delist | Triggered when your listing is removed from {% data variables.product.prodname_marketplace %}. +| redraft | Triggered when your listing is sent back to draft state. +| reject | Triggered when your listing is not accepted for inclusion in {% data variables.product.prodname_marketplace %}. {% endif %} -#### Kategorie `oauth_access` +#### The `oauth_access` category -| Aktion | Beschreibung | -| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| create | Wird ausgelöst, wenn Du [einer {% data variables.product.prodname_oauth_app %} Zugriff erteilst](/articles/authorizing-oauth-apps). | -| destroy | Wird ausgelöst, wenn Du [einer {% data variables.product.prodname_oauth_app %} den Zugriff auf Dein Konto entziehst](/articles/reviewing-your-authorized-integrations). | +| Action | Description +|------------------|------------------- +| create | Triggered when you [grant access to an {% data variables.product.prodname_oauth_app %}](/articles/authorizing-oauth-apps). +| destroy | Triggered when you [revoke an {% data variables.product.prodname_oauth_app %}'s access to your account](/articles/reviewing-your-authorized-integrations). {% if currentVersion == "free-pro-team@latest" %} -#### Kategorie `payment_method` +#### The `payment_method` category -| Aktion | Beschreibung | -| ------------- | ------------------------------------------------------------------------------------------------------------------- | -| clear | Wird ausgelöst, wenn eine [registrierte Zahlungsmethode](/articles/removing-a-payment-method) entfernt wird. | -| create | Wird ausgelöst, wenn eine Zahlungsmethode, beispielsweise eine Kreditkarte oder ein PayPal-Konto, hinzugefügt wird. | -| aktualisieren | Wird ausgelöst, wenn eine vorhandene Zahlungsmethode geändert wird. | +| Action | Description +|------------------|------------------- +| clear | Triggered when [a payment method](/articles/removing-a-payment-method) on file is removed. +| create | Triggered when a new payment method is added, such as a new credit card or PayPal account. +| update | Triggered when an existing payment method is updated. {% endif %} -#### Kategorie `profile_picture` - -| Aktion | Beschreibung | -| ------------- | ---------------------------------------------------------------------------------------------------------- | -| aktualisieren | Wird ausgelöst, wenn Du [Dein Profilbild festlegst oder änderst](/articles/setting-your-profile-picture/). | - -#### Kategorie `project` - -| Aktion | Beschreibung | -| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- | -| `create` | Wird bei der Erstellung eines Projektboards ausgelöst. | -| `rename` | Wird ausgelöst, wenn ein Projektboard umbenannt wird. | -| `aktualisieren` | Wird ausgelöst, wenn ein Projektboard geändert wird. | -| `delete` | Wird ausgelöst, wenn ein Projektboard gelöscht wird. | -| `link` | Wird ausgelöst, wenn ein Repository mit einem Projektboard verknüpft wird. | -| `unlink` | Wird ausgelöst, wenn die Verknüpfung eines Repositorys mit einem Projektboard aufgehoben wird. | -| `project.access` | Wird ausgelöst, wenn die Sichtbarkeit eines Projektboards geändert wird. | -| `update_user_permission` | Wird ausgelöst, wenn ein externer Mitarbeiter einem Projektboard hinzugefügt oder entfernt wird oder wenn sich seine Berechtigungsebene verändert. | - -#### Kategorie `public_key` - -| Aktion | Beschreibung | -| ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| create | Wird ausgelöst, wenn Du [Deinem {% data variables.product.product_name %}-Konto einen neuen öffentlichen SSH-Schlüssel hinzufügst](/articles/adding-a-new-ssh-key-to-your-github-account). | -| delete | Wird ausgelöst, wenn Du [einen öffentlichen SSH-Schlüssel aus Deinem {% data variables.product.product_name %}-Konto entfernst](/articles/reviewing-your-ssh-keys). | - -#### Kategorie `repo` - -| Aktion | Beschreibung | -| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| access | Wird ausgelöst, wenn die Sichtbarkeit eines Repositorys, dessen Inhaber Du bist, [von „privat“ auf „öffentlich“ gesetzt wird](/articles/making-a-private-repository-public) (oder umgekehrt). | -| add_member | Wird ausgelöst, wenn ein {% data variables.product.product_name %}-Benutzer für ein Repository {% if currentVersion == "free-pro-team@latest" %}[zum Zugriff als Mitarbeiter eingeladen wird](/articles/inviting-collaborators-to-a-personal-repository){% else %}[Zugriff als Mitarbeiter erhält](/articles/inviting-collaborators-to-a-personal-repository){% endif %}. | -| add_topic | Wird ausgelöst, wenn ein Repository-Inhaber einem Repository [ein Thema hinzufügt](/articles/classifying-your-repository-with-topics). | -| archived | Wird ausgelöst, wenn ein Repository-Inhaber ein [Repository archiviert](/articles/about-archiving-repositories).{% if currentVersion != "free-pro-team@latest" %} -| config.disable_anonymous_git_access | Wird ausgelöst, wenn für ein öffentliches Repository der [anonyme Git-Lesezugriff deaktiviert](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) wird. | -| config.enable_anonymous_git_access | Wird ausgelöst, wenn für ein öffentliches Repository der [anonyme Git-Lesezugriff aktiviert](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) wird. | -| config.lock_anonymous_git_access | Wird ausgelöst, wenn für ein Repository die [Einstellung für den anonymen Git-Lesezugriff gesperrt](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access) wird. | -| config.unlock_anonymous_git_access | Wird ausgelöst, wenn für ein Repository die [Einstellungssperre für den anonymen Git-Lesezugriff aufgehoben](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access) wird.{% endif %} -| create | Wird ausgelöst, wenn [ein neues Repository erstellt](/articles/creating-a-new-repository) wird. | -| destroy | Wird ausgelöst, wenn ein [Repository gelöscht](/articles/deleting-a-repository) wird.{% if currentVersion == "free-pro-team@latest" %} -| deaktivieren | Wird ausgelöst, wenn ein Repository deaktiviert wird (zum Beispiel aufgrund [unzureichender Deckung](/articles/unlocking-a-locked-account)).{% endif %}{% if currentVersion == "free-pro-team@latest" %} -| aktivieren | Wird ausgelöst, wenn ein Repository wieder aktiviert wird.{% endif %} -| remove_member | Wird ausgelöst, wenn ein {% data variables.product.product_name %}-Benutzer [als Mitarbeiter aus einem Repository entfernt wird](/articles/removing-a-collaborator-from-a-personal-repository). | -| remove_topic | Wird ausgelöst, wenn ein Repository-Inhaber ein Thema aus einem Repository entfernt. | -| rename | Wird ausgelöst, wenn ein [Repository umbenannt](/articles/renaming-a-repository) wird. | -| übertragen | Wird ausgelöst, wenn ein [Repository übertragen](/articles/how-to-transfer-a-repository) wird. | -| transfer_start | Wird ausgelöst, wenn die Übertragung eines Repositorys initiiert wurde. | -| unarchived | Wird ausgelöst, wenn ein Repository-Inhaber die Archivierung eines Repositorys aufhebt. | +#### The `profile_picture` category + +| Action | Description +|------------------|------------------- +| update | Triggered when you [set or update your profile picture](/articles/setting-your-profile-picture/). + +#### The `project` category + +| Action | Description +|--------------------|--------------------- +| `create` | Triggered when a project board is created. +| `rename` | Triggered when a project board is renamed. +| `update` | Triggered when a project board is updated. +| `delete` | Triggered when a project board is deleted. +| `link` | Triggered when a repository is linked to a project board. +| `unlink` | Triggered when a repository is unlinked from a project board. +| `project.access` | Triggered when a project board's visibility is changed. +| `update_user_permission` | Triggered when an outside collaborator is added to or removed from a project board or has their permission level changed. + +#### The `public_key` category + +| Action | Description +|------------------|------------------- +| create | Triggered when you [add a new public SSH key to your {% data variables.product.product_name %} account](/articles/adding-a-new-ssh-key-to-your-github-account). +| delete | Triggered when you [remove a public SSH key to your {% data variables.product.product_name %} account](/articles/reviewing-your-ssh-keys). + +#### The `repo` category + +| Action | Description +|------------------|------------------- +| access | Triggered when you a repository you own is [switched from "private" to "public"](/articles/making-a-private-repository-public) (or vice versa). +| add_member | Triggered when a {% data variables.product.product_name %} user is {% if currentVersion == "free-pro-team@latest" %}[invited to have collaboration access](/articles/inviting-collaborators-to-a-personal-repository){% else %}[given collaboration access](/articles/inviting-collaborators-to-a-personal-repository){% endif %} to a repository. +| add_topic | Triggered when a repository owner [adds a topic](/articles/classifying-your-repository-with-topics) to a repository. +| archived | Triggered when a repository owner [archives a repository](/articles/about-archiving-repositories).{% if currentVersion != "free-pro-team@latest" %} +| config.disable_anonymous_git_access | Triggered when [anonymous Git read access is disabled](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) in a public repository. +| config.enable_anonymous_git_access | Triggered when [anonymous Git read access is enabled](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) in a public repository. +| config.lock_anonymous_git_access | Triggered when a repository's [anonymous Git read access setting is locked](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access). +| config.unlock_anonymous_git_access | Triggered when a repository's [anonymous Git read access setting is unlocked](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access).{% endif %} +| create | Triggered when [a new repository is created](/articles/creating-a-new-repository). +| destroy | Triggered when [a repository is deleted](/articles/deleting-a-repository).{% if currentVersion == "free-pro-team@latest" %} +| disable | Triggered when a repository is disabled (e.g., for [insufficient funds](/articles/unlocking-a-locked-account)).{% endif %}{% if currentVersion == "free-pro-team@latest" %} +| enable | Triggered when a repository is re-enabled.{% endif %} +| remove_member | Triggered when a {% data variables.product.product_name %} user is [removed from a repository as a collaborator](/articles/removing-a-collaborator-from-a-personal-repository). +| remove_topic | Triggered when a repository owner removes a topic from a repository. +| rename | Triggered when [a repository is renamed](/articles/renaming-a-repository). +| transfer | Triggered when [a repository is transferred](/articles/how-to-transfer-a-repository). +| transfer_start | Triggered when a repository transfer is about to occur. +| unarchived | Triggered when a repository owner unarchives a repository. {% if currentVersion == "free-pro-team@latest" %} -#### Kategorie `sponsors` - -| Aktion | Beschreibung | -| ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| repo_funding_link_button_toggle | Wird ausgelöst, wenn Du eine Sponsorenschaltfläche in Deinem Repository aktivierst oder deaktivierst (siehe „[Sponsorenschaltfläche in Deinem Repository anzeigen](/articles/displaying-a-sponsor-button-in-your-repository)“) | -| repo_funding_links_file_action | Wird ausgelöst, wenn Du die FUNDING-Datei in Deinem Repository änderst (siehe „[Sponsorenschaltfläche in Deinem Repository anzeigen](/articles/displaying-a-sponsor-button-in-your-repository)“) | -| sponsor_sponsorship_cancel | Wird ausgelöst, wenn Du ein Sponsoring beendest (siehe „[Sponsoring herabstufen](/articles/downgrading-a-sponsorship)“) | -| sponsor_sponsorship_create | Wird ausgelöst, wenn Du einen Entwickler unterstützt (siehe „[Unterstützen eines Open-Source-Mitarbeiters](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor#sponsoring-a-developer)") | -| sponsor_sponsorship_preference_change | Wird ausgelöst, wenn Du Deine Einstellung zum Empfangen von E-Mail-Updates von einem unterstützten Entwickler änderst (siehe „[Dein Sponsoring verwalten](/articles/managing-your-sponsorship)“) | -| sponsor_sponsorship_tier_change | Wird ausgelöst, wenn Du Dein Sponsoring herauf- oder herabstufst (siehe „[Sponsoring heraufstufen](/articles/upgrading-a-sponsorship)“ und „[Sponsoring herabstufen](/articles/downgrading-a-sponsorship)“) | -| sponsored_developer_approve | Wird ausgelöst, wenn Dein {% data variables.product.prodname_sponsors %}-Konto genehmigt ist (siehe „[{% data variables.product.prodname_sponsors %} für Dein Benutzerkonto aufsetzen](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") | -| sponsored_developer_create | Wird aufgelöst, wenn Dein {% data variables.product.prodname_sponsors %}-Konto erstellt wird (siehe „[{% data variables.product.prodname_sponsors %} für Dein Benutzerkonto aufsetzen](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") | -| sponsored_developer_profile_update | Wird ausgelöst, wenn Du Dein „unterstützter Benutzer"-Profil veränderst (siehe „[Deine Profildetails für {% data variables.product.prodname_sponsors %} verändern](/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors)") | -| sponsored_developer_request_approval | Wird ausgelöst, wenn Du Deine Bewerbung für {% data variables.product.prodname_sponsors %} für die Bewilligung einreichst (siehe „[{% data variables.product.prodname_sponsors %} für Dein Benutzerkonto aufsetzen](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") | -| sponsored_developer_tier_description_update | Wird ausgelöst, wenn Du die Beschreibung einer Sponsoring-Stufe änderst (siehe „[Sponsoring-Stufen ändern](/articles/changing-your-sponsorship-tiers)“) | -| sponsored_developer_update_newsletter_send | Wird ausgelöst, wenn Du Deinen Sponsoren einen E-Mail-Update sendest (siehe „[Sponsoren kontaktieren](/articles/contacting-your-sponsors)“) | -| waitlist_invite_sponsored_developer | Wird ausgelöst, wenn Du eingeladen wirst, {% data variables.product.prodname_sponsors %} von der Warteliste her beizutreten (siehe „[{% data variables.product.prodname_sponsors %} für Dein Benutzerkonto aufsetzen](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") | -| waitlist_join | Wird ausgelöst, wenn Du der Warteliste beitrittst, um ein „unterstützter Entwickler" zu werden (siehe [{% data variables.product.prodname_sponsors %} für Dein Benutzerkonto aufsetzen](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") | +#### The `sponsors` category + +| Action | Description +|------------------|------------------- +| repo_funding_link_button_toggle | Triggered when you enable or disable a sponsor button in your repository (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)") +| repo_funding_links_file_action | Triggered when you change the FUNDING file in your repository (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)") +| sponsor_sponsorship_cancel | Triggered when you cancel a sponsorship (see "[Downgrading a sponsorship](/articles/downgrading-a-sponsorship)") +| sponsor_sponsorship_create | Triggered when you sponsor a developer (see "[Sponsoring an open source contributor](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor#sponsoring-a-developer)") +| sponsor_sponsorship_preference_change | Triggered when you change whether you receive email updates from a sponsored developer (see "[Managing your sponsorship](/articles/managing-your-sponsorship)") +| sponsor_sponsorship_tier_change | Triggered when you upgrade or downgrade your sponsorship (see "[Upgrading a sponsorship](/articles/upgrading-a-sponsorship)" and "[Downgrading a sponsorship](/articles/downgrading-a-sponsorship)") +| sponsored_developer_approve | Triggered when your {% data variables.product.prodname_sponsors %} account is approved (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") +| sponsored_developer_create | Triggered when your {% data variables.product.prodname_sponsors %} account is created (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") +| sponsored_developer_profile_update | Triggered when you edit your sponsored developer profile (see "[Editing your profile details for {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors)") +| sponsored_developer_request_approval | Triggered when you submit your application for {% data variables.product.prodname_sponsors %} for approval (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") +| sponsored_developer_tier_description_update | Triggered when you change the description for a sponsorship tier (see "[Changing your sponsorship tiers](/articles/changing-your-sponsorship-tiers)") +| sponsored_developer_update_newsletter_send | Triggered when you send an email update to your sponsors (see "[Contacting your sponsors](/articles/contacting-your-sponsors)") +| waitlist_invite_sponsored_developer | Triggered when you are invited to join {% data variables.product.prodname_sponsors %} from the waitlist (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") +| waitlist_join | Triggered when you join the waitlist to become a sponsored developer (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") {% endif %} {% if currentVersion == "free-pro-team@latest" %} -#### Kategorie `successor_invitation` - -| Aktion | Beschreibung | -| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| accept | Wird ausgelöst, wenn du eine Erneuerungseinladung annimmst (siehe „[Inhaber-Kontinuität Deiner Benutzerkonto-Repositorys aufrechterhalten](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") | -| cancel | Wird ausgelöst, wenn du eine Erneuerungseinladung kündigst (siehe „[Inhaber-Kontinuität Deiner Benutzerkonto-Repositorys aufrechterhalten](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") | -| create | Wird ausgelöst, wenn du eine Erneuerungseinladung erstellst (siehe „[Inhaber-Kontinuität Deiner Benutzerkonto-Repositorys aufrechterhalten](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") | -| decline | Wird ausgelöst, wenn du eine Erneuerungseinladung ablehnst (siehe „[Inhaber-Kontinuität Deiner Benutzerkonto-Repositorys aufrechterhalten](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") | -| revoke | Wird ausgelöst, wenn du eine Erneuerungseinladung zurückziehst (siehe „[Inhaber-Kontinuität Deiner Benutzerkonto-Repositorys aufrechterhalten](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") | +#### The `successor_invitation` category + +| Action | Description +|------------------|------------------- +| accept | Triggered when you accept a succession invitation (see "[Maintaining ownership continuity of your user account's repositories](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") +| cancel | Triggered when you cancel a succession invitation (see "[Maintaining ownership continuity of your user account's repositories](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") +| create | Triggered when you create a succession invitation (see "[Maintaining ownership continuity of your user account's repositories](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") +| decline | Triggered when you decline a succession invitation (see "[Maintaining ownership continuity of your user account's repositories](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") +| revoke | Triggered when you revoke a succession invitation (see "[Maintaining ownership continuity of your user account's repositories](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") {% endif %} {% if currentVersion != "free-pro-team@latest" %} -#### Kategorie `team` +#### The `team` category -| Aktion | Beschreibung | -| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| add_member | Wird ausgelöst, wenn ein Mitglied einer Organisation, zu der Du gehörst, [Dich zu einem Team hinzufügt](/articles/adding-organization-members-to-a-team). | -| add_repository | Wird ausgelöst, wenn ein Team, dessen Mitglied Du bist, die Kontrolle über ein Repository erhält. | -| create | Wird ausgelöst, wenn in einer Organisation, zu der Du gehörst, ein neues Team erstellt wird. | -| destroy | Wird ausgelöst, wenn ein Team, dessen Mitglied Du bist, aus einer Organisation gelöscht wird. | -| remove_member | Wird ausgelöst, wenn ein Mitglied einer Organisation [aus einem Team entfernt wird](/articles/removing-organization-members-from-a-team), dessen Mitglied Du bist. | -| remove_repository | Wird ausgelöst, wenn ein Repository nicht mehr unter der Kontrolle eines Teams steht. | +| Action | Description +|------------------|------------------- +| add_member | Triggered when a member of an organization you belong to [adds you to a team](/articles/adding-organization-members-to-a-team). +| add_repository | Triggered when a team you are a member of is given control of a repository. +| create | Triggered when a new team in an organization you belong to is created. +| destroy | Triggered when a team you are a member of is deleted from the organization. +| remove_member | Triggered when a member of an organization is [removed from a team](/articles/removing-organization-members-from-a-team) you are a member of. +| remove_repository | Triggered when a repository is no longer under a team's control. {% endif %} -#### Kategorie `two_factor_authentication` - -| Aktion | Beschreibung | -| -------- | ------------------------------------------------------------------------------------------------------------------------------------------- | -| enabled | Wird bei der Aktivierung der [Zwei-Faktor-Authentifizierung](/articles/securing-your-account-with-two-factor-authentication-2fa) ausgelöst. | -| disabled | Wird bei der Deaktivierung der Zwei-Faktor-Authentifizierung ausgelöst. | - -#### Kategorie `user` - -| Aktion | Beschreibung | -| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| add_email | Wird ausgelöst, wenn Du [eine neue E-Mail-Adresse hinzufügst](/articles/changing-your-primary-email-address). | -| create | Wird ausgelöst, wenn Du ein neues Benutzerkonto erstellst. | -| remove_email | Wird ausgelöst, wenn Du eine E-Mail-Adresse entfernst. | -| rename | Wird ausgelöst, wenn Du Dein Konto umbenennst. | -| change_password | Wird ausgelöst, wenn Du Dein Passwort änderst. | -| forgot_password | Wird ausgelöst, wenn Du die [Zurücksetzung Deines Passworts anforderst](/articles/how-can-i-reset-my-password). | -| login | Wird ausgelöst, wenn Du Dich bei {% data variables.product.product_location %} anmeldest. | -| failed_login | Wird ausgelöst, wenn Deine Anmeldung fehlschlägt. | -| two_factor_requested | Wird ausgelöst, wenn Du von {% data variables.product.product_name %} nach [Deinem Code für die Zwei-Faktor-Authentifizierung](/articles/accessing-github-using-two-factor-authentication) gefragt wirst. | -| show_private_contributions_count | Wird ausgelöst, wenn Du [private Beiträge in Deinem Profil veröffentlichst](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile). | -| hide_private_contributions_count | Wird ausgelöst, wenn Du [private Beiträge in Deinem Profil verbirgst](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile).{% if currentVersion == "free-pro-team@latest" %} -| report_content | Wird ausgelöst, wenn Du [einen Issue oder Pull Request, oder einen Kommentar zu einem Issue, einem Pull Request oder einem Commit meldest](/articles/reporting-abuse-or-spam).{% endif %} - -#### Kategorie `user_status` - -| Aktion | Beschreibung | -| ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| aktualisieren | Wird ausgelöst, wenn Du den Status Deines Profils festlegst oder änderst. Weitere Informationen findest Du unter „[Status festlegen](/articles/personalizing-your-profile/#setting-a-status).“ | -| destroy | Wird ausgelöst, wenn Du den Status Deines Profils löschst. | +#### The `two_factor_authentication` category + +| Action | Description +|------------------|------------------- +| enabled | Triggered when [two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa) is enabled. +| disabled | Triggered when two-factor authentication is disabled. + +#### The `user` category + +| Action | Description +|--------------------|--------------------- +| add_email | Triggered when you [add a new email address](/articles/changing-your-primary-email-address). +| create | Triggered when you create a new user account. +| remove_email | Triggered when you remove an email address. +| rename | Triggered when you rename your account. +| change_password | Triggered when you change your password. +| forgot_password | Triggered when you ask for [a password reset](/articles/how-can-i-reset-my-password). +| login | Triggered when you log in to {% data variables.product.product_location %}. +| failed_login | Triggered when you failed to log in successfully. +| two_factor_requested | Triggered when {% data variables.product.product_name %} asks you for [your two-factor authentication code](/articles/accessing-github-using-two-factor-authentication). +| show_private_contributions_count | Triggered when you [publicize private contributions on your profile](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile). +| hide_private_contributions_count | Triggered when you [hide private contributions on your profile](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile).{% if currentVersion == "free-pro-team@latest" %} +| report_content | Triggered when you [report an issue or pull request, or a comment on an issue, pull request, or commit](/articles/reporting-abuse-or-spam).{% endif %} + +#### The `user_status` category + +| Action | Description +|--------------------|--------------------- +| update | Triggered when you set or change the status on your profile. For more information, see "[Setting a status](/articles/personalizing-your-profile/#setting-a-status)." +| destroy | Triggered when you clear the status on your profile. {% if currentVersion == "free-pro-team@latest" %} -### Dein Sicherheitsprotokoll exportieren +### Exporting your security log {% data reusables.audit_log.export-log %} {% data reusables.audit_log.exported-log-keys-and-values %} diff --git a/translations/de-DE/content/github/authenticating-to-github/reviewing-your-ssh-keys.md b/translations/de-DE/content/github/authenticating-to-github/reviewing-your-ssh-keys.md index c15cbf8694aa..71ea5e3d0586 100644 --- a/translations/de-DE/content/github/authenticating-to-github/reviewing-your-ssh-keys.md +++ b/translations/de-DE/content/github/authenticating-to-github/reviewing-your-ssh-keys.md @@ -1,6 +1,6 @@ --- -title: SSH-Schlüssel überprüfen -intro: 'Zum Schutz Deiner Anmeldeinformationen solltest Du Deine SSH- und Deployment-Schlüssel regelmäßig überprüfen. Dabei solltest Du auch die für den Zugriff auf Dein {% data variables.product.product_name %}-Konto autorisierten Anwendungen überprüfen.' +title: Reviewing your SSH keys +intro: 'To keep your credentials secure, you should regularly audit your SSH keys, deploy keys, and review authorized applications that access your {% data variables.product.product_name %} account.' redirect_from: - /articles/keeping-your-application-access-tokens-safe/ - /articles/keeping-your-ssh-keys-and-application-access-tokens-safe/ @@ -10,37 +10,43 @@ versions: enterprise-server: '*' --- -Nicht autorisierte (oder möglicherweise kompromittierte) SSH-Schlüssel solltest Du löschen, um möglichen Angreifern den Zugriff auf Deine Repositorys zu verwehren. Vorhandene SSH-Schlüssel, die gültig sind, kannst Du genehmigen. +You can delete unauthorized (or possibly compromised) SSH keys to ensure that an attacker no longer has access to your repositories. You can also approve existing SSH keys that are valid. {% mac %} {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -3. Überprüfe auf der Seite mit den SSH-Einstellungen die Deinem Konto zugeordneten SSH-Schlüssel. Klicke bei Dir unbekannten oder veralteten Schlüsseln auf **Delete** (Löschen). Bei gültigen SSH-Schlüsseln, die Du behalten möchtest, klicke auf **Approve** (Genehmigen). ![Liste mit SSH-Schlüsseln](/assets/images/help/settings/settings-ssh-key-review.png) +3. On the SSH Settings page, take note of the SSH keys associated with your account. For those that you don't recognize, or that are out-of-date, click **Delete**. If there are valid SSH keys you'd like to keep, click **Approve**. + ![SSH key list](/assets/images/help/settings/settings-ssh-key-review.png) {% tip %} - **Hinweis:** Falls Du Deine SSH-Schlüssel aufgrund einer fehlgeschlagenen Git-Operation überprüfst, ist der nicht verifizierte Schlüssel, der den [SSH-Schlüssel-Auditfehler](/articles/error-we-re-doing-an-ssh-key-audit) verursacht hat, in der Liste der SSH-Schlüssel hervorgehoben. ![Nicht verifizierter SSH-Schlüssel](/assets/images/help/settings/settings-ssh-key-review-highlight.png) + **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys. {% endtip %} -4. Öffne das Terminal. +4. Open Terminal. 5. {% data reusables.command_line.start_ssh_agent %} -6. Suchen und notieren Sie Ihren öffentlichen Schlüssel-Fingerprint. Bei Verwendung von OpenSSH 6.7 oder älter: +6. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` - Bei Verwendung von OpenSSH 6.8 oder neuer: + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} -7. Die SSH-Schlüssel auf {% data variables.product.product_name %} *sollten* den zugehörigen Schlüsseln auf Deinem Computer entsprechen. +7. The SSH keys on {% data variables.product.product_name %} *should* match the same keys on your computer. {% endmac %} @@ -48,33 +54,39 @@ Nicht autorisierte (oder möglicherweise kompromittierte) SSH-Schlüssel solltes {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -3. Überprüfe auf der Seite mit den SSH-Einstellungen die Deinem Konto zugeordneten SSH-Schlüssel. Klicke bei Dir unbekannten oder veralteten Schlüsseln auf **Delete** (Löschen). Bei gültigen SSH-Schlüsseln, die Du behalten möchtest, klicke auf **Approve** (Genehmigen). ![Liste mit SSH-Schlüsseln](/assets/images/help/settings/settings-ssh-key-review.png) +3. On the SSH Settings page, take note of the SSH keys associated with your account. For those that you don't recognize, or that are out-of-date, click **Delete**. If there are valid SSH keys you'd like to keep, click **Approve**. + ![SSH key list](/assets/images/help/settings/settings-ssh-key-review.png) {% tip %} - **Hinweis:** Falls Du Deine SSH-Schlüssel aufgrund einer fehlgeschlagenen Git-Operation überprüfst, ist der nicht verifizierte Schlüssel, der den [SSH-Schlüssel-Auditfehler](/articles/error-we-re-doing-an-ssh-key-audit) verursacht hat, in der Liste der SSH-Schlüssel hervorgehoben.![Nicht verifizierter SSH-Schlüssel](/assets/images/help/settings/settings-ssh-key-review-highlight.png) + **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys. {% endtip %} -4. Öffne Git Bash. Wenn Du das in {% data variables.product.prodname_desktop %} integrierte Git Shell verwendest, öffne Git Shell, und fahre mit Schritt 6 fort. +4. Open Git Bash. If you're using Git Shell, which is included in {% data variables.product.prodname_desktop %}, open Git Shell and skip to step 6. 5. {% data reusables.desktop.windows_git_bash_turn_on_ssh_agent %} {% data reusables.desktop.windows_git_for_windows_turn_on_ssh_agent %} -6. Suchen und notieren Sie Ihren öffentlichen Schlüssel-Fingerprint. Bei Verwendung von OpenSSH 6.7 oder älter: +6. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` - Bei Verwendung von OpenSSH 6.8 oder neuer: + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} -7. Die SSH-Schlüssel auf {% data variables.product.product_name %} *sollten* den zugehörigen Schlüsseln auf Deinem Computer entsprechen. +7. The SSH keys on {% data variables.product.product_name %} *should* match the same keys on your computer. {% endwindows %} @@ -82,36 +94,42 @@ Nicht autorisierte (oder möglicherweise kompromittierte) SSH-Schlüssel solltes {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -3. Überprüfe auf der Seite mit den SSH-Einstellungen die Deinem Konto zugeordneten SSH-Schlüssel. Klicke bei Dir unbekannten oder veralteten Schlüsseln auf **Delete** (Löschen). Bei gültigen SSH-Schlüsseln, die Du behalten möchtest, klicke auf **Approve** (Genehmigen). ![Liste mit SSH-Schlüsseln](/assets/images/help/settings/settings-ssh-key-review.png) +3. On the SSH Settings page, take note of the SSH keys associated with your account. For those that you don't recognize, or that are out-of-date, click **Delete**. If there are valid SSH keys you'd like to keep, click **Approve**. + ![SSH key list](/assets/images/help/settings/settings-ssh-key-review.png) {% tip %} - **Hinweis:** Falls Du Deine SSH-Schlüssel aufgrund einer fehlgeschlagenen Git-Operation überprüfst, ist der nicht verifizierte Schlüssel, der den [SSH-Schlüssel-Auditfehler](/articles/error-we-re-doing-an-ssh-key-audit) verursacht hat, in der Liste der SSH-Schlüssel hervorgehoben. ![Nicht verifizierter SSH-Schlüssel](/assets/images/help/settings/settings-ssh-key-review-highlight.png) + **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys. {% endtip %} -4. Öffne das Terminal. +4. Open Terminal. 5. {% data reusables.command_line.start_ssh_agent %} -6. Suchen und notieren Sie Ihren öffentlichen Schlüssel-Fingerprint. Bei Verwendung von OpenSSH 6.7 oder älter: +6. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` - Bei Verwendung von OpenSSH 6.8 oder neuer: + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} -7. Die SSH-Schlüssel auf {% data variables.product.product_name %} *sollten* den zugehörigen Schlüsseln auf Deinem Computer entsprechen. +7. The SSH keys on {% data variables.product.product_name %} *should* match the same keys on your computer. {% endlinux %} {% warning %} -**Warnung**: Wenn Du einen SSH-Schlüssel siehst, der Dir auf {% data variables.product.product_name %} unbekannt ist, solltest Du ihn sofort löschen und Dich für weitere Anweisungen an den {% data variables.contact.contact_support %} wenden. Ein Dir unbekannter öffentlicher Schlüssel kann ein Hinweis auf ein Sicherheitsproblem sein. +**Warning**: If you see an SSH key you're not familiar with on {% data variables.product.product_name %}, delete it immediately and contact {% data variables.contact.contact_support %} for further help. An unidentified public key may indicate a possible security concern. {% endwarning %} diff --git a/translations/de-DE/content/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa.md b/translations/de-DE/content/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa.md index 73ab55343718..155d7373f7b4 100644 --- a/translations/de-DE/content/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa.md +++ b/translations/de-DE/content/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa.md @@ -1,6 +1,6 @@ --- title: Dein Konto durch Zwei-Faktor-Authentifizierung (2FA) schützen -intro: 'Du kannst Dein {% data variables.product.product_name %}-Konto so einrichten, dass zur Anmeldung neben dem Passwort auch ein Authentifizierungscode erforderlich ist.' +intro: 'Sie können Ihr {% data variables.product.product_name %}-Konto so einrichten, dass zur Anmeldung neben dem Passwort auch ein Authentifizierungscode erforderlich ist.' redirect_from: - /categories/84/articles/ - /categories/two-factor-authentication-2fa/ diff --git a/translations/de-DE/content/github/authenticating-to-github/signing-commits.md b/translations/de-DE/content/github/authenticating-to-github/signing-commits.md index 4d7e0f2d4b2e..5bd3d8ee228e 100644 --- a/translations/de-DE/content/github/authenticating-to-github/signing-commits.md +++ b/translations/de-DE/content/github/authenticating-to-github/signing-commits.md @@ -1,6 +1,6 @@ --- title: Commits signieren -intro: 'Du kannst Commits lokal mit GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} oder S/MIME{% endif %} signieren.' +intro: 'You can sign commits locally using GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} or S/MIME{% endif %}.' redirect_from: - /articles/signing-commits-and-tags-using-gpg/ - /articles/signing-commits-using-gpg/ @@ -39,7 +39,8 @@ Wenn Du über mehrere Schlüssel verfügst oder versuchst, Commits oder Tags mit $ git push # lokale Commits zum remote Repository pushen ``` -4. Navigieren Sie auf {% data variables.product.product_name %} zu Ihrem Pull Request. +4. On +{% data variables.product.product_name %}, navigate to your pull request. {% data reusables.repositories.review-pr-commits %} 5. Wenn Du ausführliche Informationen zur verifizierten Signatur sehen möchtest, klicke auf „Verified“ (Verifiziert). ![Signierter Commit](/assets/images/help/commits/gpg-signed-commit-verified-without-details.png) diff --git a/translations/de-DE/content/github/authenticating-to-github/sudo-mode.md b/translations/de-DE/content/github/authenticating-to-github/sudo-mode.md index c7eb1b941bc8..1b608363f99b 100644 --- a/translations/de-DE/content/github/authenticating-to-github/sudo-mode.md +++ b/translations/de-DE/content/github/authenticating-to-github/sudo-mode.md @@ -1,6 +1,6 @@ --- title: Sudo-Modus -intro: '{% data variables.product.product_name %} fragt nach Deinem Passwort, wenn Du Deine E-Mail-Adresse ändern, Drittanbieteranwendungen autorisieren, neue öffentliche Schlüssel hinzufügen oder andere *durch sudo geschützte* Aktionen ausführen möchtest.' +intro: '{% data variables.product.product_name %} fragt Sie nach Ihrem Passwort, wenn Sie Ihre E-Mail-Adresse ändern, Drittanbieteranwendungen autorisieren, neue öffentliche Schlüssel hinzufügen oder andere *durch Sudo geschützte* Aktionen ausführen möchten.' redirect_from: - /articles/sudo-mode versions: diff --git a/translations/de-DE/content/github/authenticating-to-github/telling-git-about-your-signing-key.md b/translations/de-DE/content/github/authenticating-to-github/telling-git-about-your-signing-key.md index 30ed42d4bec8..b80d05de2ce3 100644 --- a/translations/de-DE/content/github/authenticating-to-github/telling-git-about-your-signing-key.md +++ b/translations/de-DE/content/github/authenticating-to-github/telling-git-about-your-signing-key.md @@ -1,6 +1,6 @@ --- title: Git Deinen Signaturschlüssel mitteilen -intro: 'Für die lokale Signatur von Commits musst Du Git den für die Signatur verwendeten GPG-{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} oder X.509-{% endif %}Schlüssel mitteilen.' +intro: 'To sign commits locally, you need to inform Git that there''s a GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} or X.509{% endif %} key you''d like to use.' redirect_from: - /articles/telling-git-about-your-gpg-key/ - /articles/telling-git-about-your-signing-key @@ -13,7 +13,7 @@ versions: ### Git Deinen GPG-Schlüssel mitteilen -Wenn Du einen GPG-Schlüssel verwendest, der mit Deiner Beitragender-Identität und Deiner verifizierten und mit Deinem {% data variables.product.product_name %}-Konto verknüpften E-Mail-Adresse übereinstimmt, kannst Du beginnen, Commits und Tags zu signieren. +Wenn Sie einen GPG-Schlüssel verwenden, der mit Ihrer Beitragenderidentität und Ihrer verifizierten und mit Ihrem {% data variables.product.product_name %}-Konto verknüpften E-Mail-Adresse übereinstimmt, können Sie beginnen, Commits und Tags zu signieren. {% note %} @@ -46,7 +46,7 @@ Wenn Du mehrere GPG-Schlüssel hast, musst Du Git mitteilen, welcher zu verwende ### Git Deinen GPG-Schlüssel mitteilen -Wenn Du einen GPG-Schlüssel verwendest, der mit Deiner Beitragender-Identität und Deiner verifizierten und mit Deinem {% data variables.product.product_name %}-Konto verknüpften E-Mail-Adresse übereinstimmt, kannst Du beginnen, Commits und Tags zu signieren. +Wenn Sie einen GPG-Schlüssel verwenden, der mit Ihrer Beitragenderidentität und Ihrer verifizierten und mit Ihrem {% data variables.product.product_name %}-Konto verknüpften E-Mail-Adresse übereinstimmt, können Sie beginnen, Commits und Tags zu signieren. {% note %} @@ -75,7 +75,7 @@ Wenn Du mehrere GPG-Schlüssel hast, musst Du Git mitteilen, welcher zu verwende ### Git Deinen GPG-Schlüssel mitteilen -Wenn Du einen GPG-Schlüssel verwendest, der mit Deiner Beitragender-Identität und Deiner verifizierten und mit Deinem {% data variables.product.product_name %}-Konto verknüpften E-Mail-Adresse übereinstimmt, kannst Du beginnen, Commits und Tags zu signieren. +Wenn Sie einen GPG-Schlüssel verwenden, der mit Ihrer Beitragenderidentität und Ihrer verifizierten und mit Ihrem {% data variables.product.product_name %}-Konto verknüpften E-Mail-Adresse übereinstimmt, können Sie beginnen, Commits und Tags zu signieren. {% note %} diff --git a/translations/de-DE/content/github/authenticating-to-github/testing-your-ssh-connection.md b/translations/de-DE/content/github/authenticating-to-github/testing-your-ssh-connection.md index 345259f6afe5..5aefc509ff32 100644 --- a/translations/de-DE/content/github/authenticating-to-github/testing-your-ssh-connection.md +++ b/translations/de-DE/content/github/authenticating-to-github/testing-your-ssh-connection.md @@ -1,6 +1,6 @@ --- title: SSH-Verbindung testen -intro: 'Wenn Du Deinen SSH-Schlüssel eingerichtet und Deinem {% data variables.product.product_name %}-Konto hinzugefügt hast, kannst Du die Verbindung testen.' +intro: 'Wenn Sie Ihren SSH-Schlüssel eingerichtet und Ihrem {% data variables.product.product_name %}-Konto hinzugefügt haben, können Sie die Verbindung testen.' redirect_from: - /articles/testing-your-ssh-connection versions: diff --git a/translations/de-DE/content/github/authenticating-to-github/troubleshooting-ssh.md b/translations/de-DE/content/github/authenticating-to-github/troubleshooting-ssh.md index 4071bef7af6b..9d6458bfce65 100644 --- a/translations/de-DE/content/github/authenticating-to-github/troubleshooting-ssh.md +++ b/translations/de-DE/content/github/authenticating-to-github/troubleshooting-ssh.md @@ -1,6 +1,6 @@ --- title: Fehlerbehebung bei Verwendung von SSH -intro: 'Wenn Du SSH zur Authentifizierung und Verbindung mit {% data variables.product.product_name %} verwendest, treten eventuell unerwartete Fehler auf, die Du beheben musst.' +intro: 'Wenn Sie SSH zur Authentifizierung und Verbindung mit {% data variables.product.product_name %} verwenden, treten eventuell unerwartete Fehler auf, die Sie beheben müssen.' mapTopic: true redirect_from: - /articles/troubleshooting-ssh diff --git a/translations/de-DE/content/github/authenticating-to-github/updating-an-expired-gpg-key.md b/translations/de-DE/content/github/authenticating-to-github/updating-an-expired-gpg-key.md index 8ef9f6cc9c26..7adb18ee018b 100644 --- a/translations/de-DE/content/github/authenticating-to-github/updating-an-expired-gpg-key.md +++ b/translations/de-DE/content/github/authenticating-to-github/updating-an-expired-gpg-key.md @@ -1,6 +1,6 @@ --- title: Abgelaufenen GPG-Schlüssel aktualisieren -intro: 'Bei der Verifizierung einer Signatur überprüft {% data variables.product.product_name %}, ob der Schlüssel widerrufen wurde oder abgelaufen ist. Bei Widerruf oder Ablauf Deines Signaturschlüssel kann {% data variables.product.product_name %} Deine Signaturen nicht verifizieren. Wenn Dein Schlüssel widerrufen wurde, verwende den primären Schlüssel oder einen anderen, nicht widerrufenen Schlüssel zum signieren Deiner Commits.' +intro: 'Bei der Verifizierung einer Signatur überprüft {% data variables.product.product_name %}, ob der Schlüssel widerrufen wurde oder abgelaufen ist. Bei Widerruf oder Ablauf des Signaturschlüssels kann {% data variables.product.product_name %} Ihre Signaturen nicht verifizieren. Wenn Dein Schlüssel widerrufen wurde, verwende den primären Schlüssel oder einen anderen, nicht widerrufenen Schlüssel zum signieren Deiner Commits.' redirect_from: - /articles/updating-an-expired-gpg-key versions: diff --git a/translations/de-DE/content/github/authenticating-to-github/updating-your-github-access-credentials.md b/translations/de-DE/content/github/authenticating-to-github/updating-your-github-access-credentials.md index 489781ff0df4..9bc63ff24130 100644 --- a/translations/de-DE/content/github/authenticating-to-github/updating-your-github-access-credentials.md +++ b/translations/de-DE/content/github/authenticating-to-github/updating-your-github-access-credentials.md @@ -1,6 +1,6 @@ --- title: Anmeldeinformationen für den Zugriff auf GitHub aktualisieren -intro: 'Die Anmeldeinformationen von {% data variables.product.product_name %} umfassen nicht nur Dein Passwort, sondern auch Deine Zugriffstokens, SSH-Schlüssel und Anwendungs-API-Tokens für die Kommunikation mit {% data variables.product.product_name %}. Bei Bedarf kannst Du alle diese Anmeldeinformationen selber zurücksetzen.' +intro: 'Die Anmeldeinformationen von {% data variables.product.product_name %} umfassen nicht nur Ihr Passwort, sondern auch Ihre Zugriffstoken, SSH-Schlüssel und Anwendungs-API-Token für die Kommunikation mit {% data variables.product.product_name %}. Bei Bedarf kannst Du alle diese Anmeldeinformationen selber zurücksetzen.' redirect_from: - /articles/rolling-your-credentials/ - /articles/how-can-i-reset-my-password/ @@ -12,7 +12,7 @@ versions: ### Neues Passwort anfordern -1. Rufe zur Anforderung eines neuen Passworts {% if currentVersion == "free-pro-team@latest" %}https://{% data variables.product.product_url %}/password_reset{% else %}`https://{% data variables.product.product_url %}/password_reset`{% endif %} auf. +1. To request a new password, visit {% if currentVersion == "free-pro-team@latest" %}https://{% data variables.product.product_url %}/password_reset{% else %}`https://{% data variables.product.product_url %}/password_reset`{% endif %}. 2. Gib die Deinem persönlichen {% data variables.product.product_name %}-Konto zugeordnete E-Mail-Adresse ein, und klicke auf **Send password reset email** (E-Mail für Passwortzurücksetzung anfordern). Die E-Mail wird an die Backup-E-Mail-Adresse gesendet, sofern Du diese konfiguriert hast. ![Dialogfeld zum Anfordern einer E-Mail für die Passwortzurücksetzung](/assets/images/help/settings/password-recovery-email-request.png) 3. Die E-Mail enthält einen Link, über den Du Dein Passwort zurücksetzen kannst. Auf diesen Link musst Du innerhalb von drei Stunden nach Erhalt der E-Mail klicken. Falls Du keine E-Mail von uns erhalten hast, siehe in Deinem Spam-Ordner nach. 4. Nach dem Klicken auf den Link in Deiner E-Mail wirst Du zur Eingabe eines neuen Passworts aufgefordert. ![Feld für Passwortwiederherstellung](/assets/images/help/settings/password_recovery_page.png) @@ -29,11 +29,7 @@ Um Dein Passwort in Zukunft nicht mehr zu verlieren, empfehlen wir die Verwendun 1. {% data variables.product.signin_link %} für {% data variables.product.product_name %}. {% data reusables.user_settings.access_settings %} -{%- if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} {% data reusables.user_settings.security %} -{%- else %} -{% data reusables.user_settings.account_settings %} -{%- endif %} 4. Gib unter „Change password“ (Passwort ändern) Dein altes Passwort und ein sicheres neues Passwort ein, und bestätige das neue Passwort. Details zur Erstellung eines sicheren Passworts findest Du unter „[Sicheres Passwort erstellen](/articles/creating-a-strong-password).“ 5. Klicke auf **Update password** (Passwort aktualisieren). @@ -53,7 +49,7 @@ Anweisungen zum Überprüfen und Löschen von SSH-Schlüsseln findest Du unter ### API-Token zurücksetzen -Wenn Du bei {% data variables.product.product_name %} Anwendungen registriert hast, musst Du eventuell deren OAuth-Tokens zurücksetzen. For more information, see the "[Reset an authorization](/rest/reference/apps#reset-an-authorization)" endpoint. +Wenn Sie bei {% data variables.product.product_name %} Anwendungen registriert haben, müssen Sie eventuell OAuth-Token zurücksetzen. For more information, see the "[Reset an authorization](/rest/reference/apps#reset-an-authorization)" endpoint. ### Nicht autorisierten Zugriff verhindern diff --git a/translations/de-DE/content/github/authenticating-to-github/using-ssh-over-the-https-port.md b/translations/de-DE/content/github/authenticating-to-github/using-ssh-over-the-https-port.md index b06819db9bd6..62e9cd641346 100644 --- a/translations/de-DE/content/github/authenticating-to-github/using-ssh-over-the-https-port.md +++ b/translations/de-DE/content/github/authenticating-to-github/using-ssh-over-the-https-port.md @@ -25,7 +25,7 @@ Falls das funktioniert hat, prima! Falls nicht, musst Du allenfalls [unserem Lei ### SSH-Verbindungen über HTTPS aktivieren -Wenn Du über Port 443 eine SSH-Verbindung zu `git@ssh.{% data variables.command_line.backticks %}` herstellen kannst, kannst Du Deine SSH-Einstellungen überschreiben, um zu erzwingen, dass Verbindungen zu {% data variables.product.product_location %} durch diesen Server und Port laufen. +Wenn Sie über Port 443 eine SSH-Verbindung zu `git@ssh.{% data variables.command_line.backticks %}` herstellen können, können Sie Ihre SSH-Einstellungen überschreiben, um zu erzwingen, dass Verbindungen zu {% data variables.product.product_location %} diesen Server und Port durchlaufen. Um dies in Deiner SSH-Konfiguration festzulegen, bearbeite die Datei unter `~/.ssh/config`, und füge den folgenden Abschnitt hinzu: @@ -35,7 +35,7 @@ Host {% data variables.command_line.codeblock %} Port 443 ``` -Du kannst testen, ob dies funktioniert, indem Du erneut eine Verbindung zu {% data variables.product.product_location %} herstellst: +Sie können testen, ob dies funktioniert, indem Sie erneut eine Verbindung zu {% data variables.product.product_location %} herstellen: ```shell $ ssh -T git@{% data variables.command_line.codeblock %} diff --git a/translations/de-DE/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md b/translations/de-DE/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md index 3f71cdaa82c4..bbc3f89b4ecb 100644 --- a/translations/de-DE/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md +++ b/translations/de-DE/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md @@ -1,6 +1,6 @@ --- title: SSH-Schlüssel-Passphrasen verwenden -intro: 'Du kannst Deine SSH-Schlüssel schützen und einen Authentifizierungsagenten konfigurieren, damit Du beim Verwenden Deiner SSH-Schlüssel nicht jedes Mal Deine Passphrase neu eingeben musst.' +intro: Du kannst Deine SSH-Schlüssel schützen und einen Authentifizierungsagenten konfigurieren, damit Du beim Verwenden Deiner SSH-Schlüssel nicht jedes Mal Deine Passphrase neu eingeben musst. redirect_from: - /ssh-key-passphrases/ - /working-with-key-passphrases/ @@ -73,7 +73,7 @@ fi unset env ``` -Wenn Dein privater Schlüssel nicht in einem der Standardorte gespeichert wird (z.B. `~/.ssh/id_rsa`{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} oder `~/. sh/id_dsa`{% endif %}), musst Du Deinem SSH-Authentifizierungsagenten mitteilen, wo er gefunden werden kann. Gib `ssh-add ~/path/to/my_key` ein, um dem SSH-Agenten Deinen Schlüssel hinzuzufügen. Weitere Informationen findest Du unter „[Einen neuen SSH-Schlüssel generieren und zum SSH-Agenten hinzufügen](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/).“ +If your private key is not stored in one of the default locations (like `~/.ssh/id_rsa`), you'll need to tell your SSH authentication agent where to find it. Gib `ssh-add ~/path/to/my_key` ein, um dem SSH-Agenten Deinen Schlüssel hinzuzufügen. Weitere Informationen findest Du unter „[Einen neuen SSH-Schlüssel generieren und zum SSH-Agenten hinzufügen](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/).“ {% tip %} @@ -104,8 +104,7 @@ Die Ausführung des `ssh-agent`-Prozesses wird fortgesetzt, bis Du Dich abmeldes In OS X Leopard bis OS X El Capitan werden folgende standardmäßigen Privatschlüssel-Dateien automatisch verarbeitet: -- *.ssh/id_rsa*{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -- *.ssh/id_dsa*{% endif %} +- *.ssh/id_rsa* - *.ssh/identity* Bei der ersten Nutzung Deines Schlüssels wirst Du zur Eingabe Deiner Passphrase aufgefordert. Falls Du die Passphrase mit Deiner Schlüsselkette speicherst, musst Du sie nicht erneut eingeben. diff --git a/translations/de-DE/content/github/building-a-strong-community/about-community-profiles-for-public-repositories.md b/translations/de-DE/content/github/building-a-strong-community/about-community-profiles-for-public-repositories.md index 12f073cd4043..2ddd38c77aed 100644 --- a/translations/de-DE/content/github/building-a-strong-community/about-community-profiles-for-public-repositories.md +++ b/translations/de-DE/content/github/building-a-strong-community/about-community-profiles-for-public-repositories.md @@ -1,6 +1,6 @@ --- title: Informationen zu Community-Profilen für öffentliche Repositorys -intro: 'Repository-Betreuer können einen Review des Community-Profils ihres öffentlichen Repositorys durchführen, um zu erfahren, wie sie dazu beitragen können, ihre Community zu vergrößern und Mitarbeiter zu unterstützen. Mitarbeiter können das Community-Profil eines öffentlichen Repositorys einsehen, um zu überprüfen, ob sie an dem Projekt mitwirken möchten.' +intro: Repository-Betreuer können einen Review des Community-Profils ihres öffentlichen Repositorys durchführen, um zu erfahren, wie sie dazu beitragen können, ihre Community zu vergrößern und Mitarbeiter zu unterstützen. Mitarbeiter können das Community-Profil eines öffentlichen Repositorys einsehen, um zu überprüfen, ob sie an dem Projekt mitwirken möchten. redirect_from: - /articles/viewing-your-community-profile/ - /articles/about-community-profiles-for-public-repositories diff --git a/translations/de-DE/content/github/building-a-strong-community/about-issue-and-pull-request-templates.md b/translations/de-DE/content/github/building-a-strong-community/about-issue-and-pull-request-templates.md index 191ba894d281..1b116296e5b9 100644 --- a/translations/de-DE/content/github/building-a-strong-community/about-issue-and-pull-request-templates.md +++ b/translations/de-DE/content/github/building-a-strong-community/about-issue-and-pull-request-templates.md @@ -10,7 +10,7 @@ versions: Nachdem Du in Deinem Repository Vorlagen für Issues und Pull Requests erstellt hast, können Mitarbeiter die Vorlagen verwenden, um Issues zu öffnen oder vorgeschlagene Änderungen in ihren Pull Requests gemäß den Beitragsrichtlinien des Repositorys zu beschreiben. Weitere Informationen zum Hinzufügen von Beitragsrichtlinien zu einem Repository findest Du unter „[Richtlinien für Repository-Mitarbeiter festlegen](/articles/setting-guidelines-for-repository-contributors).“ -Du kannst Standardvorlagen für Issues und Pull Request für Deine Organisation{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} oder Dein Benutzerkonto{% endif %} erstellen. Weitere Informationen findest Du unter „[Eine Standard Community-Unterstützungsdatei erstellen](/github/building-a-strong-community/creating-a-default-community-health-file)." +You can create default issue and pull request templates for your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %}. Weitere Informationen findest Du unter „[Eine Standard Community-Unterstützungsdatei erstellen](/github/building-a-strong-community/creating-a-default-community-health-file)." ### Vorlagen für Issues diff --git a/translations/de-DE/content/github/building-a-strong-community/about-team-discussions.md b/translations/de-DE/content/github/building-a-strong-community/about-team-discussions.md index 5acad20ca013..7ac295a002f8 100644 --- a/translations/de-DE/content/github/building-a-strong-community/about-team-discussions.md +++ b/translations/de-DE/content/github/building-a-strong-community/about-team-discussions.md @@ -26,7 +26,7 @@ Wenn jemand eine öffentliche Diskussion auf der Seite eines Teams veröffentlic {% tip %} -**Tipp:** Abhängig von Deinen Benachrichtigungseinstellungen erhältst Du Updates per E-Mail, über die Seite mit den Webbenachrichtigungen auf {% data variables.product.product_name %} oder beide. Weitere Informationen findest Du auf {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}„[Benachrichtigungen konfigurieren](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications){% else %}„[Über E-Mail-Benachrichtigungen](/github/receiving-notifications-about-activity-on-github/about-email-notifications)" und „[Über Webbenachrichtigungen](/github/receiving-notifications-about-activity-on-github/about-web-notifications){% endif %}." +**Tipp:** Abhängig von Deinen Benachrichtigungseinstellungen erhältst Du Updates per E-Mail, über die Seite mit den Webbenachrichtigungen auf {% data variables.product.product_name %} oder beide. For more information, see {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications){% else %}"[About email notifications](/github/receiving-notifications-about-activity-on-github/about-email-notifications)" and "[About web notifications](/github/receiving-notifications-about-activity-on-github/about-web-notifications){% endif %}." {% endtip %} @@ -34,7 +34,7 @@ Wenn Dein Benutzername in einer Teamdiskussion erwähnt wird, erhältst Du stand Um Benachrichtigungen für Teamdiskussionen zu deaktivieren, kannst Du einen bestimmten Diskussionsbeitrag kündigen oder Deine Benachrichtigungseinstellungen so ändern, dass Du die Diskussionen eines bestimmten Teams nicht mehr beobachtest oder vollständig ignorierst. Du kannst Benachrichtigungen für einen bestimmten Diskussionsbeitrag abonnieren, auch wenn Du die Diskussionen dieses Teams nicht beobachtest. -Weitere Informationen findest Du auf {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}„[Deine Abonnements anschauen](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions)"{% else %}„[Benachrichtigungen abonnieren oder kündigen](/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)"{% endif %} und „[Verschachtelte Teams](/articles/about-teams/#nested-teams)." +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 %}"[Subscribing to and unsubscribing from notifications](/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications){% endif %}" and "[Nested teams](/articles/about-teams/#nested-teams)." ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/building-a-strong-community/about-wikis.md b/translations/de-DE/content/github/building-a-strong-community/about-wikis.md index c38ce7a1a110..6b1b96326774 100644 --- a/translations/de-DE/content/github/building-a-strong-community/about-wikis.md +++ b/translations/de-DE/content/github/building-a-strong-community/about-wikis.md @@ -12,11 +12,11 @@ versions: Jedes {% data variables.product.product_name %}-Repository enthält einen Abschnitt für das Verwalten von Dokumentationen, ein so genanntes Wiki. Du kannst das Wiki Deines Repositorys verwenden, um ausführliche Informationen über Dein Projekt auszutauschen, beispielsweise über seine Verwendung, seine Gestaltung und seine Kernprinzipien. Eine README-Datei zeigt schnell, was Dein Projekt bezweckt, wohingegen Du ein Wiki verwenden kannst, um zusätzliche Dokumentation bereitzustellen. Weitere Informationen finden Sie unter „[Informationen zu README-Dateien](/articles/about-readmes/)“. -Mit Wikis kannst Du Inhalte wie überall sonst auf {% data variables.product.product_name %} verfassen. Weitere Informationen findest Du unter „[Erste Schritte zum Schreiben und Formatieren auf {% data variables.product.prodname_dotcom %}](/articles/getting-started-with-writing-and-formatting-on-github)“. Wir verwenden [unsere Open-Source Markup-Bibliothek](https://github.com/github/markup), um verschiedene Formate in HTML zu konvertieren, sodass Du entscheiden kannst, in Markdown oder jedem anderen unterstützten Format zu schreiben. +Mit Wikis können Sie Inhalte wie überall sonst auf {% data variables.product.product_name %} verfassen. Weitere Informationen findest Du unter „[Erste Schritte zum Schreiben und Formatieren auf {% data variables.product.prodname_dotcom %}](/articles/getting-started-with-writing-and-formatting-on-github)“. Wir verwenden [unsere Open-Source Markup-Bibliothek](https://github.com/github/markup), um verschiedene Formate in HTML zu konvertieren, sodass Du entscheiden kannst, in Markdown oder jedem anderen unterstützten Format zu schreiben. Wikis sind in öffentlichen Repositorys für die Öffentlichkeit zugänglich und in privaten Repositorys auf Personen mit Zugriff auf das Repository beschränkt. Weitere Informationen findest Du unter „[Sichtbarkeit eines Repositorys festlegen](/articles/setting-repository-visibility).“ -Du kannst Wikis direkt auf {% data variables.product.product_name %} bearbeiten, oder Du kannst Wiki-Dateien lokal bearbeiten. Standardmäßig können nur Personen mit Schreibzugriff auf Dein Repository Änderungen an Wikis vornehmen, jedoch kannst Du jedermann auf {% data variables.product.product_name %} erlauben, an einem Wiki in einem öffentlichen Repository mitzuwirken. Weitere Informationen findest Du unter „[Zugriffsberechtigungen für Wikis ändern](/articles/changing-access-permissions-for-wikis)“. +Sie können Wikis direkt auf {% data variables.product.product_name %} bearbeiten, oder Sie können Wiki-Dateien lokal bearbeiten. Standardmäßig können nur Personen mit Schreibzugriff auf Ihr Repository Änderungen an Wikis vornehmen, jedoch können Sie jedem auf {% data variables.product.product_name %} erlauben, an einem Wiki in einem öffentlichen Repository mitzuwirken. Weitere Informationen findest Du unter „[Zugriffsberechtigungen für Wikis ändern](/articles/changing-access-permissions-for-wikis)“. ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/building-a-strong-community/accessing-a-projects-community-profile.md b/translations/de-DE/content/github/building-a-strong-community/accessing-a-projects-community-profile.md index 075b565fef74..7b416c56ffa1 100644 --- a/translations/de-DE/content/github/building-a-strong-community/accessing-a-projects-community-profile.md +++ b/translations/de-DE/content/github/building-a-strong-community/accessing-a-projects-community-profile.md @@ -1,6 +1,6 @@ --- title: Auf das Community-Profil eines Projekts zugreifen -intro: 'Sieh Dir das Community-Profil eines öffentlichen Repositorys an, um den Zustand eines Projekts zu überprüfen und zu entscheiden, ob Du einen Beitrag leisten möchtest.' +intro: Sieh Dir das Community-Profil eines öffentlichen Repositorys an, um den Zustand eines Projekts zu überprüfen und zu entscheiden, ob Du einen Beitrag leisten möchtest. redirect_from: - /articles/accessing-a-project-s-community-profile - /articles/accessing-a-projects-community-profile diff --git a/translations/de-DE/content/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project.md b/translations/de-DE/content/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project.md index 0032a869b22a..0a176775054f 100644 --- a/translations/de-DE/content/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project.md +++ b/translations/de-DE/content/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project.md @@ -20,7 +20,7 @@ Du kannst einen Standard-Verhaltenskodex für Deine Organisation oder Dein Benut ### Einen Verhaltenskodex über eine Vorlage hinzufügen -{% data variables.product.product_name %} bietet Vorlagen für gängige Verhaltenskodizes. So kannst Du rasch einen Verhaltenskodex zu Deinem Projekt hinzufügen. +{% data variables.product.product_name %} bietet Vorlagen für gängige Verhaltenskodizes. So können Sie rasch einen Verhaltenskodex zu Ihrem Projekt hinzufügen. {% data reusables.repositories.navigate-to-repo %} {% data reusables.files.add-file %} diff --git a/translations/de-DE/content/github/building-a-strong-community/adding-a-license-to-a-repository.md b/translations/de-DE/content/github/building-a-strong-community/adding-a-license-to-a-repository.md index 4680df80d337..6c8aab53cc91 100644 --- a/translations/de-DE/content/github/building-a-strong-community/adding-a-license-to-a-repository.md +++ b/translations/de-DE/content/github/building-a-strong-community/adding-a-license-to-a-repository.md @@ -1,6 +1,6 @@ --- title: Eine Lizenz zu einem Repository hinzufügen -intro: 'Du kannst eine Open-Source-Lizenz zu Deinem Repository hinzufügen, um anderen die Mitarbeit zu vereinfachen.' +intro: Du kannst eine Open-Source-Lizenz zu Deinem Repository hinzufügen, um anderen die Mitarbeit zu vereinfachen. redirect_from: - /articles/adding-a-license-to-a-repository versions: diff --git a/translations/de-DE/content/github/building-a-strong-community/adding-or-editing-wiki-pages.md b/translations/de-DE/content/github/building-a-strong-community/adding-or-editing-wiki-pages.md index 5bcd2a01de7e..d0ac3c22b66e 100644 --- a/translations/de-DE/content/github/building-a-strong-community/adding-or-editing-wiki-pages.md +++ b/translations/de-DE/content/github/building-a-strong-community/adding-or-editing-wiki-pages.md @@ -1,6 +1,6 @@ --- title: Wiki-Seiten hinzufügen oder bearbeiten -intro: 'Du kannst Wiki-Seiten direkt auf {% data variables.product.product_name %} oder lokal über die Befehlszeile hinzufügen und bearbeiten.' +intro: 'Sie können Wiki-Seiten direkt auf {% data variables.product.product_name %} oder lokal über die Befehlszeile hinzufügen und bearbeiten.' redirect_from: - /articles/adding-wiki-pages-via-the-online-interface/ - /articles/editing-wiki-pages-via-the-online-interface/ diff --git a/translations/de-DE/content/github/building-a-strong-community/adding-support-resources-to-your-project.md b/translations/de-DE/content/github/building-a-strong-community/adding-support-resources-to-your-project.md index 4f8b5f8cc022..1d4d23439999 100644 --- a/translations/de-DE/content/github/building-a-strong-community/adding-support-resources-to-your-project.md +++ b/translations/de-DE/content/github/building-a-strong-community/adding-support-resources-to-your-project.md @@ -1,6 +1,6 @@ --- title: Support-Ressourcen zu Deinem Projekt hinzufügen -intro: 'Du kannst eine SUPPORT-Datei erstellen, um anderen mitzuteilen, wie sie Unterstützung in Deinem Projekt erhalten.' +intro: Du kannst eine SUPPORT-Datei erstellen, um anderen mitzuteilen, wie sie Unterstützung in Deinem Projekt erhalten. redirect_from: - /articles/adding-support-resources-to-your-project versions: @@ -12,7 +12,7 @@ Um Personen auf bestimmte Support-Ressourcen zu verweisen, kannst Du eine SUPPOR ![Support-Richtlinien](/assets/images/help/issues/support_guidelines_in_issue.png) -Du kannst Standard-Supportressourcen für Deine Organisation{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} oder Dein Benutzerkonto{% endif %} erstellen. Weitere Informationen findest Du unter „[Eine Standard Community-Unterstützungsdatei erstellen](/github/building-a-strong-community/creating-a-default-community-health-file)." +You can create default support resources for your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %}. Weitere Informationen findest Du unter „[Eine Standard Community-Unterstützungsdatei erstellen](/github/building-a-strong-community/creating-a-default-community-health-file)." {% tip %} diff --git a/translations/de-DE/content/github/building-a-strong-community/blocking-a-user-from-your-organization.md b/translations/de-DE/content/github/building-a-strong-community/blocking-a-user-from-your-organization.md index 2380ff9f5f3c..1095a94e72f7 100644 --- a/translations/de-DE/content/github/building-a-strong-community/blocking-a-user-from-your-organization.md +++ b/translations/de-DE/content/github/building-a-strong-community/blocking-a-user-from-your-organization.md @@ -1,6 +1,6 @@ --- title: Einen Benutzer für Deine Organisation blockieren -intro: 'Organisationsinhaber können einen Benutzer blockieren, damit dieser nicht mehr an den Repositorys der Organisation mitarbeiten kann.' +intro: Organisationsinhaber können einen Benutzer blockieren, damit dieser nicht mehr an den Repositorys der Organisation mitarbeiten kann. redirect_from: - /articles/blocking-a-user-from-your-organization versions: diff --git a/translations/de-DE/content/github/building-a-strong-community/collaborating-with-your-team.md b/translations/de-DE/content/github/building-a-strong-community/collaborating-with-your-team.md index 3e70fd49b29c..b7e7abfe2688 100644 --- a/translations/de-DE/content/github/building-a-strong-community/collaborating-with-your-team.md +++ b/translations/de-DE/content/github/building-a-strong-community/collaborating-with-your-team.md @@ -1,6 +1,6 @@ --- title: Mit Deinem Team zusammenarbeiten -intro: Innerhalb einer Organisation kann Dein Team mithilfe von Teamdiskussionen über mehrere Projekte hinweg zusammenarbeiten. +intro: 'Innerhalb einer Organisation kann Dein Team mithilfe von Teamdiskussionen über mehrere Projekte hinweg zusammenarbeiten.' mapTopic: true redirect_from: - /articles/collaborating-with-your-team diff --git a/translations/de-DE/content/github/building-a-strong-community/configuring-issue-templates-for-your-repository.md b/translations/de-DE/content/github/building-a-strong-community/configuring-issue-templates-for-your-repository.md index 5c43b78629b3..279239b76c32 100644 --- a/translations/de-DE/content/github/building-a-strong-community/configuring-issue-templates-for-your-repository.md +++ b/translations/de-DE/content/github/building-a-strong-community/configuring-issue-templates-for-your-repository.md @@ -1,6 +1,6 @@ --- title: Issuevorlagen für Dein Repository konfigurieren -intro: 'Du kannst die Vorlagen anpassen, die für Mitarbeiter zur Verfügung stehen, wenn sie neue Issues in Deinem Repository eröffnen.' +intro: Du kannst die Vorlagen anpassen, die für Mitarbeiter zur Verfügung stehen, wenn sie neue Issues in Deinem Repository eröffnen. redirect_from: - /github/building-a-strong-community/creating-issue-templates-for-your-repository - /articles/configuring-issue-templates-for-your-repository @@ -24,7 +24,7 @@ versions: 7. Um automatisch einen standardmäßigen Issuetitel einzurichten, weise den Issue an Benutzern mit Lesezugriff auf das Repository zu. Du kannst auch Kennzeichnungen zur Issuevorlage hinzufügen und diese Details unter „Optional additional Information“ (Optionale zusätzliche Informationen) eingeben. Außerdem kannst Du diese Details auch in der Issuevorlage mit `title`, `labels` oder `assignees` im YAML-Titelei-Format hinzufügen. ![Zusätzliche Informationen für Issuevorlagen](/assets/images/help/repository/additional-issue-template-info.png) 8. Wenn mit der Vorschau und Bearbeitung der Vorlage fertig bist, klicke in der oberen rechten Ecke der Seite auf **Propose changes** (Änderungen vorschlagen). ![Schaltfläche „Propose changes“ (Änderungen vorschlagen)](/assets/images/help/repository/propose-changes-button.png) 9. Gib eine Commit-Mitteilung ein, in der Du Deine Änderungen beschreibst. ![Feld „Issue template commit message" (Commit-Mitteilung für Issuevorlage)](/assets/images/help/repository/issue-template-commit-message-field.png) -10. Lege unterhalb der Commit-Mitteilungsfelder fest, ob Du Deine Vorlage direkt an den Standardbranch freigeben oder einen neuen Branch erstellen und einen Pull Request öffnen möchtest. Weitere Informationen zu Pull Requests findest Du unter „[Informationen zu Pull Requests](/articles/about-pull-requests).“ ![Auswahl zwischen Commit der Issuevorlage an Master oder Öffnen eines Pull Requests](/assets/images/help/repository/issue-template-commit-to-master-or-open-pull-request.png) +10. Lege unterhalb der Commit-Mitteilungsfelder fest, ob Du Deine Vorlage direkt an den Standardbranch freigeben oder einen neuen Branch erstellen und einen Pull Request öffnen möchtest. Weitere Informationen zu Pull Requests findest Du unter „[Informationen zu Pull Requests](/articles/about-pull-requests).“ ![Issue template commit to main or open pull request choice](/assets/images/help/repository/issue-template-commit-to-master-or-open-pull-request.png) 11. Klicke auf **Commit changes** (Änderungen freigeben). Sobald diese Änderungen in den Standardbranch zusammengeführt wurden, steht die Vorlage für Mitarbeiter zur Verfügung, wenn sie neue Issues im Repository erstellen. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} diff --git a/translations/de-DE/content/github/building-a-strong-community/creating-a-default-community-health-file.md b/translations/de-DE/content/github/building-a-strong-community/creating-a-default-community-health-file.md index 6a8418fa6a05..8d17477a9764 100644 --- a/translations/de-DE/content/github/building-a-strong-community/creating-a-default-community-health-file.md +++ b/translations/de-DE/content/github/building-a-strong-community/creating-a-default-community-health-file.md @@ -11,38 +11,38 @@ versions: ### Informationen zu Standard-Community-Unterstützungsdateien -Du kannst Standard-Community-Unterstützungsdateien dem Stammverzeichnis eines öffentlichen Repositorys mit Namen `.github` hinzufügen, welches einer Organisation{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} oder einem Benutzerkonto{% endif %} gehört. +You can add default community health files to the root of a public repository called `.github` that is owned by an organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %}. {% data variables.product.product_name %} wird Standarddateien für ein öffentliches Repository benutzen und anzeigen, sofern das Konto, dem das Repository gehört, über keine eigenen Dateien dieses Typs an den folgenden Stellen verfügt: - im Root des Repositorys - im Ordner `.github` - im Ordner `docs` -Wenn z. B. jemand einen Issue oder Pull Request in einem öffentlichen Repository erstellt, das keine eigene CONTRIBUTING-Datei enthält, wird ein Link zur standardmäßigen CONTRIBUTING-Datei angezeigt. Wenn ein Repository solche Dateien in seinem eigenen `.github/ISSUE_TEMPLATE`-Verzeichnis hat{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}, inbegriffen Issuevorlagen oder eine *config.yml*-Datei{% endif %}, werden keine Inhalte des Standard `.github/ISSUE_TEMPLATE`-Verzeichnisses verwendet. +Wenn z. B. jemand einen Issue oder Pull Request in einem öffentlichen Repository erstellt, das keine eigene CONTRIBUTING-Datei enthält, wird ein Link zur standardmäßigen CONTRIBUTING-Datei angezeigt. If a repository has any files in its own `.github/ISSUE_TEMPLATE` folder{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}, including issue templates or a *config.yml* file,{% endif %} none of the contents of the default `.github/ISSUE_TEMPLATE` folder will be used. Standarddateien sind nicht in Klonen, Paketen oder Downloads von einzelnen Repositorys enthalten, da sie nur im `.github`-Repository gespeichert sind. ### Unterstützte Dateitypen -Du kannst Standards in Deiner Organisation{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} oder Deinem Benutzerkonto{% endif %} für die folgenden Community-Unterstützungsdateien erstellen: +You can create defaults in your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %} for the following community health files: -| Community-Unterstützungsdatei | Beschreibung | -| --------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" %} -| *CODE_OF_CONDUCT.md* | Eine CODE_OF_CONDUCT-Datei legt die Standards für die Interaktion in einer Community fest. Weitere Informationen findest Du unter „[Deinem Projekt einen Verhaltenskodex hinzufügen](/articles/adding-a-code-of-conduct-to-your-project/)“.{% endif %} -| *CONTRIBUTING.md* | Eine CONTRIBUTING-Datei erläutert, wie zu Deinem Projekt beigetragen werden soll. Weitere Informationen findest Du unter „[Richtlinien für Repository-Mitarbeiter festlegen](/articles/setting-guidelines-for-repository-contributors/)“.{% if currentVersion == "free-pro-team@latest" %} -| *FUNDING.yml* | Eine FUNDING-Datei zeigt eine Sponsorenschaltfläche in Deinem Repository an, um die Sichtbarkeit von Finanzierungsoptionen für Dein Open-Source-Projekt zu erhöhen. Weitere Informationen findest Du unter „[Sponsorenschaltfläche in Deinem Repository anzeigen](/articles/displaying-a-sponsor-button-in-your-repository)“{% endif %} -| Issue- und Pull-Request-Vorlagen{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} und *config.yml*{% endif %} | Mit den Vorlagen für Issues und Pull Requests kannst Du die Informationen anpassen und standardisieren, die Mitarbeiter beim Öffnen von Issues und Pull Requests in Deinem Repository berücksichtigen sollen. Weitere Informationen finden Sie unter „[Informationen zu Vorlagen für Issues und Pull Requests](/articles/about-issue-and-pull-request-templates/)“.{% if currentVersion == "free-pro-team@latest" %} -| *SECURITY.md* | Eine SECURITY-Datei enthält Anweisungen zum verantwortungsvollen Melden einer Sicherheitslücke in Ihrem Projekt. Weitere Informationen findest Du unter „[Eine Sicherheitsrichtlinie zum Repository hinzufügen](/articles/adding-a-security-policy-to-your-repository)“.{% endif %} -| *SUPPORT.md* | Mit einer SUPPORT-Datei kannst Du anderen mitteilen, wie sie Unterstützung bei Deinem Projekt erhalten können. Weitere Informationen findest Du unter „[Support-Ressourcen zu Deinem Projekt hinzufügen](/articles/adding-support-resources-to-your-project/).“ | +| Community-Unterstützungsdatei | Beschreibung | +| --------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" %} +| *CODE_OF_CONDUCT.md* | Eine CODE_OF_CONDUCT-Datei legt die Standards für die Interaktion in einer Community fest. Weitere Informationen findest Du unter „[Deinem Projekt einen Verhaltenskodex hinzufügen](/articles/adding-a-code-of-conduct-to-your-project/)“.{% endif %} +| *CONTRIBUTING.md* | Eine CONTRIBUTING-Datei erläutert, wie zu Deinem Projekt beigetragen werden soll. For more information, see "[Setting guidelines for repository contributors](/articles/setting-guidelines-for-repository-contributors/)."{% if currentVersion == "free-pro-team@latest" %} +| *FUNDING.yml* | Eine FUNDING-Datei zeigt eine Sponsorenschaltfläche in Deinem Repository an, um die Sichtbarkeit von Finanzierungsoptionen für Dein Open-Source-Projekt zu erhöhen. Weitere Informationen findest Du unter „[Sponsorenschaltfläche in Deinem Repository anzeigen](/articles/displaying-a-sponsor-button-in-your-repository)“{% endif %} +| Issue and pull request templates{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and *config.yml*{% endif %} | Mit den Vorlagen für Issues und Pull Requests kannst Du die Informationen anpassen und standardisieren, die Mitarbeiter beim Öffnen von Issues und Pull Requests in Deinem Repository berücksichtigen sollen. For more information, see "[About issue and pull request templates](/articles/about-issue-and-pull-request-templates/)."{% if currentVersion == "free-pro-team@latest" %} +| *SECURITY.md* | Eine SECURITY-Datei enthält Anweisungen zum verantwortungsvollen Melden einer Sicherheitslücke in Ihrem Projekt. Weitere Informationen findest Du unter „[Eine Sicherheitsrichtlinie zum Repository hinzufügen](/articles/adding-a-security-policy-to-your-repository)“.{% endif %} +| *SUPPORT.md* | Mit einer SUPPORT-Datei kannst Du anderen mitteilen, wie sie Unterstützung bei Deinem Projekt erhalten können. Weitere Informationen findest Du unter „[Support-Ressourcen zu Deinem Projekt hinzufügen](/articles/adding-support-resources-to-your-project/).“ | Du kannst keine Standard-Lizenzdatei erstellen. Lizenzdateien müssen zu individuellen Repositorys hinzugefügt werden, damit die Datei bei Klonen, Paketieren und Herunterladen des Projekts enthalten ist. ### Ein Repository für Standarddateien erstellen {% data reusables.repositories.create_new %} -2. Benutze das **Owner** (Inhaber) Dropdownmenü und wähle die Organisation{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} oder das Benutzerkonto{% endif %}, für welche Du Standarddateien erstellen willst. ![Dropdownmenü „Owner" (Inhaber)](/assets/images/help/repository/create-repository-owner.png) +2. Use the **Owner** drop-down menu, and select the organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %} you want to create default files for. ![Dropdownmenü „Owner" (Inhaber)](/assets/images/help/repository/create-repository-owner.png) 3. Gib **.github** als Namen für Dein Repository sowie optional eine Beschreibung ein. ![Feld „Create repository" (Erstellen eines Repositorys)](/assets/images/help/repository/default-file-repository-name.png) -4. Wähle, dass das Repository öffentlich sein soll. ![Optionsfelder zum Auswählen des privaten oder öffentlichen Status](/assets/images/help/repository/create-repository-public-private.png) +4. Make sure the repository status is set to **Public** (a repository for default files cannot be private). ![Optionsfelder zum Auswählen des privaten oder öffentlichen Status](/assets/images/help/repository/create-repository-public-private.png) {% data reusables.repositories.initialize-with-readme %} {% data reusables.repositories.create-repo %} -7. Erstelle im Repository eine der möglichen Community-Unterstützungsdateien. Issuevorlagen{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} und ihre Konfigurationsdateien{% endif %} müssen sich in einem Verzeichnis namens `.github/ISSUE_TEMPLATE` befinden. Alle anderen unterstützten Dateien müssen sich im Root des Repositorys befinden. Weitere Informationen findest Du unter „[Neue Dateien erstellen](/articles/creating-new-files/).“ +7. Erstelle im Repository eine der möglichen Community-Unterstützungsdateien. Issue templates{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and their configuration file{% endif %} must be in a folder called `.github/ISSUE_TEMPLATE`. Alle anderen unterstützten Dateien müssen sich im Root des Repositorys befinden. Weitere Informationen findest Du unter „[Neue Dateien erstellen](/articles/creating-new-files/).“ diff --git a/translations/de-DE/content/github/building-a-strong-community/creating-a-footer-or-sidebar-for-your-wiki.md b/translations/de-DE/content/github/building-a-strong-community/creating-a-footer-or-sidebar-for-your-wiki.md index 6796f0fa0d56..e93065dbea15 100644 --- a/translations/de-DE/content/github/building-a-strong-community/creating-a-footer-or-sidebar-for-your-wiki.md +++ b/translations/de-DE/content/github/building-a-strong-community/creating-a-footer-or-sidebar-for-your-wiki.md @@ -1,6 +1,6 @@ --- title: Eine Fußzeile oder Seitenleiste für Dein Wiki erstellen -intro: 'Du kannst eine benutzerdefinierte Seitenleiste oder Fußzeile für Dein Wiki erstellen, um zusätzliche kontextbezogene Informationen für die Leser bereitzustellen.' +intro: Du kannst eine benutzerdefinierte Seitenleiste oder Fußzeile für Dein Wiki erstellen, um zusätzliche kontextbezogene Informationen für die Leser bereitzustellen. redirect_from: - /articles/creating-a-footer/ - /articles/creating-a-sidebar/ diff --git a/translations/de-DE/content/github/building-a-strong-community/creating-a-pull-request-template-for-your-repository.md b/translations/de-DE/content/github/building-a-strong-community/creating-a-pull-request-template-for-your-repository.md index 8fd20cc28394..9d29f36c66ef 100644 --- a/translations/de-DE/content/github/building-a-strong-community/creating-a-pull-request-template-for-your-repository.md +++ b/translations/de-DE/content/github/building-a-strong-community/creating-a-pull-request-template-for-your-repository.md @@ -12,7 +12,7 @@ Weitere Informationen findest Du unter „[Informationen zu Vorlagen für Issues Du kannst in einem der unterstützten Ordner ein Unterverzeichnis *PULL_REQUEST_TEMPLATE* erstellen, um mehrere Pull-Request-Vorlagen zu speichern. Mit dem Abfrageparameter `template` kannst Du die Vorlage wählen, mit der der Pull-Request-Text ausgefüllt werden soll. Weitere Informationen findest Du unter „[Informationen zur Automatisierung für Issues und Pull Requests mit Abfrageparametern](/articles/about-automation-for-issues-and-pull-requests-with-query-parameters).“ -Du kannst Standardvorlagen für Pull Request für Deine Organisation{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} oder Dein Benutzerkonto{% endif %} erstellen. Weitere Informationen findest Du unter „[Eine Standard Community-Unterstützungsdatei erstellen](/github/building-a-strong-community/creating-a-default-community-health-file)." +You can create default pull request templates for your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %}. Weitere Informationen findest Du unter „[Eine Standard Community-Unterstützungsdatei erstellen](/github/building-a-strong-community/creating-a-default-community-health-file)." ### Eine Pull-Request-Vorlage hinzufügen diff --git a/translations/de-DE/content/github/building-a-strong-community/editing-wiki-content.md b/translations/de-DE/content/github/building-a-strong-community/editing-wiki-content.md index 8b4f0fb447cb..d7869ae034ec 100644 --- a/translations/de-DE/content/github/building-a-strong-community/editing-wiki-content.md +++ b/translations/de-DE/content/github/building-a-strong-community/editing-wiki-content.md @@ -1,6 +1,6 @@ --- title: Wiki-Inhalte bearbeiten -intro: Du kannst Bilder und Links zu Inhalten zu Deinem Wiki hinzufügen und unterstützte MediaWiki-Formate verwenden. +intro: 'Du kannst Bilder und Links zu Inhalten zu Deinem Wiki hinzufügen und unterstützte MediaWiki-Formate verwenden.' redirect_from: - /articles/adding-links-to-wikis/ - /articles/how-do-i-add-links-to-my-wiki/ diff --git a/translations/de-DE/content/github/building-a-strong-community/encouraging-helpful-contributions-to-your-project-with-labels.md b/translations/de-DE/content/github/building-a-strong-community/encouraging-helpful-contributions-to-your-project-with-labels.md index 4aa3ce0b7438..0952098fdc12 100644 --- a/translations/de-DE/content/github/building-a-strong-community/encouraging-helpful-contributions-to-your-project-with-labels.md +++ b/translations/de-DE/content/github/building-a-strong-community/encouraging-helpful-contributions-to-your-project-with-labels.md @@ -1,6 +1,6 @@ --- title: Hilfreiche Beiträge zu Deinem Projekt über Kennzeichnungen ermutigen -intro: 'Nutze die Kennzeichnung „good first issue“ (guter erster Issue) für Issues in Deinem Repository, um Möglichkeiten hervorzuheben, wie sich andere an Deinem Projekt beteiligen können.' +intro: Nutze die Kennzeichnung „good first issue“ (guter erster Issue) für Issues in Deinem Repository, um Möglichkeiten hervorzuheben, wie sich andere an Deinem Projekt beteiligen können. redirect_from: - /github/building-a-strong-community/helping-new-contributors-find-your-project-with-labels - /articles/helping-new-contributors-find-your-project-with-labels diff --git a/translations/de-DE/content/github/building-a-strong-community/locking-conversations.md b/translations/de-DE/content/github/building-a-strong-community/locking-conversations.md index 1d65094cc782..5e86b60383ee 100644 --- a/translations/de-DE/content/github/building-a-strong-community/locking-conversations.md +++ b/translations/de-DE/content/github/building-a-strong-community/locking-conversations.md @@ -1,6 +1,6 @@ --- -title: Unterhaltungen sperren -intro: 'Repository-Inhaber und -Mitarbeiter sowie Personen mit Schreibzugriff auf ein Repository können Unterhaltungen zu Issues, Pull-Requests und Commits dauerhaft oder temporär sperren, um eine hitzige Diskussion zu entschärfen.' +title: Locking conversations +intro: 'Repository owners and collaborators, and people with write access to a repository, can lock conversations on issues, pull requests, and commits permanently or temporarily to defuse a heated interaction.' redirect_from: - /articles/locking-conversations versions: @@ -8,28 +8,32 @@ versions: enterprise-server: '*' --- -Es ist angemessen, eine Unterhaltung zu sperren, wenn die gesamte Unterhaltung nicht konstruktiv ist oder den Verhaltenskodex Deiner Community{% if currentVersion == "free-pro-team@latest" %} oder die [Community-Richtlinien](/articles/github-community-guidelines) von GitHub{% endif %} verletzen. Wenn Du eine Unterhaltung sperrst, kannst Du auch einen Grund dafür angeben, der dann öffentlich sichtbar ist. +It's appropriate to lock a conversation when the entire conversation is not constructive or violates your community's code of conduct{% if currentVersion == "free-pro-team@latest" %} or GitHub's [Community Guidelines](/articles/github-community-guidelines){% endif %}. When you lock a conversation, you can also specify a reason, which is publicly visible. -Das Sperren einer Unterhaltung erstellt ein Zeitleistenereignis, das für alle Benutzer mit Lesezugriff auf das Repository sichtbar ist. Der Benutzername der Person, die die Unterhaltung gesperrt hat, ist jedoch nur für Benutzer mit Schreibzugriff auf das Repository zu sehen. Für Personen ohne Schreibzugriff ist das Zeitleistenereignis anonymisiert. +Locking a conversation creates a timeline event that is visible to anyone with read access to the repository. However, the username of the person who locked the conversation is only visible to people with write access to the repository. For anyone without write access, the timeline event is anonymized. -![Anonymisiertes Zeitleistenereignis für eine gesperrte Unterhaltung](/assets/images/help/issues/anonymized-timeline-entry-for-locked-conversation.png) +![Anonymized timeline event for a locked conversation](/assets/images/help/issues/anonymized-timeline-entry-for-locked-conversation.png) -Solange eine Unterhaltung gesperrt ist, können nur [Personen mit Schreibzugriff](/articles/repository-permission-levels-for-an-organization/) und [Repository-Inhaber und -Mitarbeiter](/articles/permission-levels-for-a-user-account-repository/#collaborator-access-on-a-repository-owned-by-a-user-account) Kommentare hinzufügen, ausblenden und löschen. +While a conversation is locked, only [people with write access](/articles/repository-permission-levels-for-an-organization/) and [repository owners and collaborators](/articles/permission-levels-for-a-user-account-repository/#collaborator-access-on-a-repository-owned-by-a-user-account) can add, hide, and delete comments. -Um nach gesperrten Unterhaltungen in einem nicht archivierten Repository zu suchen, kannst Du die Qualifizierer `is:locked` und `archived:false` verwenden. In archivierten Repositorys sind Unterhaltungen automatisch gesperrt. Weitere Informationen findest Du unter „[Issues und Pull Requests durchsuchen](/articles/searching-issues-and-pull-requests#search-based-on-whether-a-conversation-is-locked).“ +To search for locked conversations in a repository that is not archived, you can use the search qualifiers `is:locked` and `archived:false`. Conversations are automatically locked in archived repositories. For more information, see "[Searching issues and pull requests](/articles/searching-issues-and-pull-requests#search-based-on-whether-a-conversation-is-locked)." -1. Verfasse optional einen Kommentar, in dem Du erklärst, weshalb Du die Unterhaltung sperrst. -2. Klicke am rechten Rand des Issues respektive Pull Requests oder oberhalb des Kommentarfelds auf der Commit-Seite auf **Lock conversation** (Unterhaltung sperren). ![Link „Lock conversation“ (Unterhaltung sperren)](/assets/images/help/repository/lock-conversation.png) -3. Optional kannst Du einen Grund für das Sperren der Unterhaltung auswählen. ![Menü „Reason for locking a conversation" (Grund für das Sperren einer Unterhaltung)](/assets/images/help/repository/locking-conversation-reason-menu.png) -4. Lies die Informationen zum Sperren von Unterhaltungen, und klicke auf **Lock conversation on this issue** (Unterhaltung zu diesem Issue sperren), **Lock conversation on this pull request** (Unterhaltung zu diesem Pull Request sperren) oder **Lock conversation on this commit** (Unterhaltung zu diesem Commit sperren). ![Dialogfeld „Confirm lock with a reason" (Bestätigen der Sperre mit Begründung)](/assets/images/help/repository/lock-conversation-confirm-with-reason.png) -5. Wenn Du die Sperre der Unterhaltung beenden möchtest, klicke auf **Unlock conversation** (Unterhaltung entsperren). ![Link „Unlock conversation“ (Unterhaltung entsperren)](/assets/images/help/repository/unlock-conversation.png) +1. Optionally, write a comment explaining why you're locking the conversation. +2. In the right margin of the issue or pull request, or above the comment box on the commit page, click **Lock conversation**. +![Lock conversation link](/assets/images/help/repository/lock-conversation.png) +3. Optionally, choose a reason for locking the conversation. +![Reason for locking a conversation menu](/assets/images/help/repository/locking-conversation-reason-menu.png) +4. Read the information about locking conversations and click **Lock conversation on this issue**, **Lock conversation on this pull request**, or **Lock conversation on this commit**. +![Confirm lock with a reason dialog box](/assets/images/help/repository/lock-conversation-confirm-with-reason.png) +5. When you're ready to unlock the conversation, click **Unlock conversation**. +![Unlock conversation link](/assets/images/help/repository/unlock-conversation.png) -### Weiterführende Informationen +### Further reading -- „[Dein Projekt für sinnvolle Beiträge einrichten](/articles/setting-up-your-project-for-healthy-contributions)“ -- „[Vorlagen benutzen, um hilfreiche Issues und Pull Requests zu ermutigen](/github/building-a-strong-community/using-templates-to-encourage-useful-issues-and-pull-requests)" -- „[Störende Kommentare verwalten](/articles/managing-disruptive-comments)"{% if currentVersion == "free-pro-team@latest" %} -- „[Deine Sicherheit auf {% data variables.product.prodname_dotcom %} aufrechterhalten](/github/building-a-strong-community/maintaining-your-safety-on-github)" -- „[Missbrauch oder Spam melden](/articles/reporting-abuse-or-spam)“ -- „[Interaktionen in Deinem Repository einschränken](/github/building-a-strong-community/limiting-interactions-in-your-repository)" +- "[Setting up your project for healthy contributions](/articles/setting-up-your-project-for-healthy-contributions)" +- "[Using templates to encourage useful issues and pull requests](/github/building-a-strong-community/using-templates-to-encourage-useful-issues-and-pull-requests)" +- "[Managing disruptive comments](/articles/managing-disruptive-comments)"{% if currentVersion == "free-pro-team@latest" %} +- "[Maintaining your safety on {% data variables.product.prodname_dotcom %}](/github/building-a-strong-community/maintaining-your-safety-on-github)" +- "[Reporting abuse or spam](/articles/reporting-abuse-or-spam)" +- "[Limiting interactions in your repository](/github/building-a-strong-community/limiting-interactions-in-your-repository)" {% endif %} diff --git a/translations/de-DE/content/github/building-a-strong-community/managing-disruptive-comments.md b/translations/de-DE/content/github/building-a-strong-community/managing-disruptive-comments.md index 38fba44c7807..809825ccfb66 100644 --- a/translations/de-DE/content/github/building-a-strong-community/managing-disruptive-comments.md +++ b/translations/de-DE/content/github/building-a-strong-community/managing-disruptive-comments.md @@ -1,6 +1,6 @@ --- -title: Störende Kommentare verwalten -intro: 'Du kannst Kommentare zu Issues, Pull Requests und Commits {% if currentVersion == "free-pro-team@latest" %}ausblenden, bearbeiten{% else %}bearbeiten{% endif %} oder löschen.' +title: Managing disruptive comments +intro: 'You can {% if currentVersion == "free-pro-team@latest" %}hide, edit,{% else %}edit{% endif %} or delete comments on issues, pull requests, and commits.' redirect_from: - /articles/editing-a-comment/ - /articles/deleting-a-comment/ @@ -10,69 +10,76 @@ versions: enterprise-server: '*' --- -### Einen Kommentar ausblenden +### Hiding a comment -Jeder mit Schreibzugriff auf ein Repository kann Kommentare zu Issues, Pull Requests und Commits ausblenden. +Anyone with write access to a repository can hide comments on issues, pull requests, and commits. -Wenn ein Kommentar nicht zum Thema passt, veraltet oder gelöst ist, kannst Du ihn ausblenden, damit die Diskussion zielgerichtet bleibt oder die Navigation sowie der Review eines Pull Requests vereinfacht wird. Ausgeblendete Kommentare werden minimiert, aber Personen mit Lesezugriff auf das Repository können sie einblenden. +If a comment is off-topic, outdated, or resolved, you may want to hide a comment to keep a discussion focused or make a pull request easier to navigate and review. Hidden comments are minimized but people with read access to the repository can expand them. -![Minimierter Kommentar](/assets/images/help/repository/hidden-comment.png) +![Minimized comment](/assets/images/help/repository/hidden-comment.png) -1. Navigiere zum Kommentar, den Du ausblenden möchtest. -2. Klicke oben rechts im Kommentar auf {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} und anschließend auf **Hide** (Ausblenden). ![Horizontales 3-Punkte-Symbol und Menü zum Moderieren der Unterhaltung mit den Optionen zum Bearbeiten, Ausblenden und Löschen](/assets/images/help/repository/comment-menu.png) -3. Wähle im Dropdownmenü „Choose a reason" (Grund auswählen) einen Grund für das Ausblenden des Kommentars aus. Klicke anschließend auf **Hide comment** (Kommentar ausblenden). +1. Navigate to the comment you'd like to hide. +2. In the upper-right corner of the comment, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Hide**. + ![The horizontal kebab icon and comment moderation menu showing the edit, hide, delete options](/assets/images/help/repository/comment-menu.png) +3. Using the "Choose a reason" drop-down menu, click a reason to hide the comment. Then click, **Hide comment**. {% if currentVersion == "free-pro-team@latest" %} - ![Dropdownmenü zur Auswahl des Grundes für das Ausblenden des Kommentars](/assets/images/help/repository/choose-reason-for-hiding-comment.png) + ![Choose reason for hiding comment drop-down menu](/assets/images/help/repository/choose-reason-for-hiding-comment.png) {% else %} - ![Dropdownmenü zur Auswahl des Grundes für das Ausblenden des Kommentars](/assets/images/help/repository/choose-reason-for-hiding-comment-ghe.png) + ![Choose reason for hiding comment drop-down menu](/assets/images/help/repository/choose-reason-for-hiding-comment-ghe.png) {% endif %} -### Einen ausgeblendeten Kommentar wieder anzeigen +### Unhiding a comment -Jeder mit Schreibzugriff auf ein Repository kann Kommentare zu Issues, Pull Requests und Commits wieder anzeigen. +Anyone with write access to a repository can unhide comments on issues, pull requests, and commits. -1. Navigiere zu dem Kommentar, den Du wieder anzeigen möchten. -2. Klicke in der oberen rechten Ecke des Kommentars auf **{% octicon "fold" aria-label="The fold icon" %} Show comment** (Kommentar anzeigen). ![Text „Show comment“ (Kommentar anzeigen)](/assets/images/help/repository/hidden-comment-show.png) -3. Klicke auf der rechten Seite des angezeigten Kommentars auf {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} und anschließend auf **Unhide** (Wieder anzeigen). ![Horizontales 3-Punkte-Symbol und Menü zum Moderieren der Unterhaltung mit den Optionen zum Bearbeiten, Wiederanzeigen und Löschen](/assets/images/help/repository/comment-menu-hidden.png) +1. Navigate to the comment you'd like to unhide. +2. In the upper-right corner of the comment, click **{% octicon "fold" aria-label="The fold icon" %} Show comment**. + ![Show comment text](/assets/images/help/repository/hidden-comment-show.png) +3. On the right side of the expanded comment, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then **Unhide**. + ![The horizontal kebab icon and comment moderation menu showing the edit, unhide, delete options](/assets/images/help/repository/comment-menu-hidden.png) -### Einen Kommentar bearbeiten +### Editing a comment -Jeder mit Schreibzugriff auf ein Repository kann Kommentare zu Issues, Pull Requests und Commits bearbeiten. +Anyone with write access to a repository can edit comments on issues, pull requests, and commits. -Es ist angemessen, einen Kommentar zu bearbeiten und Inhalte zu entfernen, wenn der Kommentar nicht zu einer sachlichen Unterhaltung beiträgt oder den Verhaltenskodex Deiner Community{% if currentVersion == "free-pro-team@latest" %} oder die [Community-Richtlinien](/articles/github-community-guidelines) von GitHub{% endif %} verletzt. +It's appropriate to edit a comment and remove content that doesn't contribute to the conversation and violates your community's code of conduct{% if currentVersion == "free-pro-team@latest" %} or GitHub's [Community Guidelines](/articles/github-community-guidelines){% endif %}. -Wenn Du einen Kommentar bearbeitest, notiere den Ort, von dem der Inhalt entfernt wurde, und optional den Grund für das Entfernen. +When you edit a comment, note the location that the content was removed from and optionally, the reason for removing it. -Jede Person mit Lesezugriff auf ein Repository kann den Änderungsverlauf eines Kommentars anzeigen. Das Dropdownmenü **edited** (Bearbeitet) oben im Kommentar enthält einen Verlauf der Bearbeitungen mit dem Benutzer und dem Zeitstempel für jede Bearbeitung. +Anyone with read access to a repository can view a comment's edit history. The **edited** dropdown at the top of the comment contains a history of edits showing the user and timestamp for each edit. -![Kommentar mit hinzugefügtem Hinweis, dass Inhalte redigiert wurden](/assets/images/help/repository/content-redacted-comment.png) +![Comment with added note that content was redacted](/assets/images/help/repository/content-redacted-comment.png) -Verfasser von Kommentaren und Personen mit Schreibzugriff auf ein Repository können auch vertrauliche Informationen aus dem Änderungsverlauf eines Kommentars löschen. Weitere Informationen findest Du unter „[Änderungen in einem Kommentar verfolgen](/github/building-a-strong-community/tracking-changes-in-a-comment)." +Comment authors and anyone with write access to a repository can also delete sensitive information from a comment's edit history. For more information, see "[Tracking changes in a comment](/github/building-a-strong-community/tracking-changes-in-a-comment)." -1. Navigiere zu dem Kommentar, den Du bearbeiten möchtest. -2. Klicke oben rechts im Kommentar auf {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} und anschließend auf **Edit** (Bearbeiten). ![Horizontales 3-Punkte-Symbol und Menü zum Moderieren der Unterhaltung mit den Optionen zum Bearbeiten, Ausblenden, Löschen und Melden](/assets/images/help/repository/comment-menu.png) -3. Lösche im Kommentarfenster den Inhalt, den Du entfernen möchtest, und gib dann `[REDACTED]` ein, um ihn zu ersetzen. ![Kommentarfenster mit redigiertem Inhalt](/assets/images/help/issues/redacted-content-comment.png) -4. Gib unten im Kommentar eine Notiz ein, in der Du auf die Bearbeitung hinweist und optional den Grund dafür nennst. ![Kommentarfenster mit hinzugefügtem Hinweis, dass Inhalte redigiert wurden](/assets/images/help/issues/note-content-redacted-comment.png) -5. Klicke auf **Update comment** (Kommentar aktualisieren). +1. Navigate to the comment you'd like to edit. +2. In the upper-right corner of the comment, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Edit**. + ![The horizontal kebab icon and comment moderation menu showing the edit, hide, delete, and report options](/assets/images/help/repository/comment-menu.png) +3. In the comment window, delete the content you'd like to remove, then type `[REDACTED]` to replace it. + ![Comment window with redacted content](/assets/images/help/issues/redacted-content-comment.png) +4. At the bottom of the comment, type a note indicating that you have edited the comment, and optionally, why you edited the comment. + ![Comment window with added note that content was redacted](/assets/images/help/issues/note-content-redacted-comment.png) +5. Click **Update comment**. -### Einen Kommentar löschen +### Deleting a comment -Personen mit Schreibzugriff auf ein Repository können Kommentare zu Issues, Pull Requests und Commits löschen. Organisationsinhaber, Team-Betreuer und die Verfasser des Kommentars können auch einen Kommentar auf einer Teamseite löschen. +Anyone with write access to a repository can delete comments on issues, pull requests, and commits. Organization owners, team maintainers, and the comment author can also delete a comment on a team page. -Das Löschen eines Kommentars ist die letzte Option für Dich als Moderator. Es ist angemessen, einen Kommentar zu löschen, wenn er nicht zu einer sachlichen Unterhaltung beiträgt oder den Verhaltenskodex Deiner Community{% if currentVersion == "free-pro-team@latest" %} oder die [Community-Richtlinien](/articles/github-community-guidelines) von GitHub{% endif %} verletzt. +Deleting a comment is your last resort as a moderator. It's appropriate to delete a comment if the entire comment adds no constructive content to a conversation and violates your community's code of conduct{% if currentVersion == "free-pro-team@latest" %} or GitHub's [Community Guidelines](/articles/github-community-guidelines){% endif %}. -Das Löschen eines Kommentars erstellt ein Zeitleistenereignis, das für alle Benutzer mit Lesezugriff auf das Repository sichtbar ist. Der Benutzername der Person, die den Kommentar gelöscht hat, ist jedoch nur für Benutzer mit Schreibzugriff auf das Repository zu sehen. Für Personen ohne Schreibzugriff ist das Zeitleistenereignis anonymisiert. +Deleting a comment creates a timeline event that is visible to anyone with read access to the repository. However, the username of the person who deleted the comment is only visible to people with write access to the repository. For anyone without write access, the timeline event is anonymized. -![Anonymisiertes Zeitleistenereignis für einen gelöschten Kommentar](/assets/images/help/issues/anonymized-timeline-entry-for-deleted-comment.png) +![Anonymized timeline event for a deleted comment](/assets/images/help/issues/anonymized-timeline-entry-for-deleted-comment.png) -Wenn ein Kommentar auch Inhalte aufweist, die einen konstruktiven Beitrag zur Unterhaltung im Issue oder Pull Request darstellen, kannst Du den Kommentar bearbeiten, anstatt ihn komplett zu löschen. +If a comment contains some constructive content that adds to the conversation in the issue or pull request, you can edit the comment instead. {% note %} -**Hinweis:** Der anfängliche Kommentar (oder Text) eines Issues oder Pull Requests kann nicht gelöscht werden. Stattdessen kannst Du den Text von Issues und Pull Requests bearbeiten und dabei unerwünschte Inhalte entfernen. +**Note:** The initial comment (or body) of an issue or pull request can't be deleted. Instead, you can edit issue and pull request bodies to remove unwanted content. {% endnote %} -1. Navigiere zu dem Kommentar, den Du löschen möchtest. -2. Klicke oben rechts im Kommentar auf {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} und anschließend auf **Delete** (Löschen). ![Horizontales 3-Punkte-Symbol und Menü zum Moderieren der Unterhaltung mit den Optionen zum Bearbeiten, Ausblenden, Löschen und Melden](/assets/images/help/repository/comment-menu.png) -3. Verfasse optional einen Kommentar mit dem Hinweis, dass und warum Du einen Kommentar gelöscht hast. +1. Navigate to the comment you'd like to delete. +2. In the upper-right corner of the comment, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Delete**. + ![The horizontal kebab icon and comment moderation menu showing the edit, hide, delete, and report options](/assets/images/help/repository/comment-menu.png) +3. Optionally, write a comment noting that you deleted a comment and why. diff --git a/translations/de-DE/content/github/building-a-strong-community/managing-how-contributors-report-abuse-in-your-organizations-repository.md b/translations/de-DE/content/github/building-a-strong-community/managing-how-contributors-report-abuse-in-your-organizations-repository.md index 224e5c046102..ed2ab20e55b4 100644 --- a/translations/de-DE/content/github/building-a-strong-community/managing-how-contributors-report-abuse-in-your-organizations-repository.md +++ b/translations/de-DE/content/github/building-a-strong-community/managing-how-contributors-report-abuse-in-your-organizations-repository.md @@ -1,6 +1,6 @@ --- -title: 'Verwalten, wie Mitwirkende Missbrauch im Repository Deiner Organisation melden' -intro: 'Du kannst Mitwirkenden erlauben, störendes Verhalten direkt an die Repository-Betreuer zu melden.' +title: Verwalten, wie Mitwirkende Missbrauch im Repository Deiner Organisation melden +intro: Du kannst Mitwirkenden erlauben, störendes Verhalten direkt an die Repository-Betreuer zu melden. versions: free-pro-team: '*' --- diff --git a/translations/de-DE/content/github/building-a-strong-community/reporting-abuse-or-spam.md b/translations/de-DE/content/github/building-a-strong-community/reporting-abuse-or-spam.md index 3d58700ff396..6e3e25891822 100644 --- a/translations/de-DE/content/github/building-a-strong-community/reporting-abuse-or-spam.md +++ b/translations/de-DE/content/github/building-a-strong-community/reporting-abuse-or-spam.md @@ -1,6 +1,6 @@ --- title: Missbrauch oder Spam melden -intro: 'Du kannst Verhalten und Inhalte melden, die die Community-Richtlinien und -Bedingungen verletzen.' +intro: Du kannst Verhalten und Inhalte melden, die die Community-Richtlinien und -Bedingungen verletzen. redirect_from: - /articles/reporting-abuse-or-spam versions: @@ -58,7 +58,7 @@ Wenn „gemeldeter Inhalt" für ein öffentliches Repository aktiviert ist, kann - „[Dein Projekt für sinnvolle Beiträge einrichten](/articles/setting-up-your-project-for-healthy-contributions)“ - „[Vorlagen benutzen, um hilfreiche Issues und Pull Requests zu ermutigen](/github/building-a-strong-community/using-templates-to-encourage-useful-issues-and-pull-requests)" -- „[Störende Kommentare verwalten](/articles/managing-disruptive-comments)"{% if currentVersion == "free-pro-team@latest" %} +- "[Managing disruptive comments](/articles/managing-disruptive-comments)"{% if currentVersion == "free-pro-team@latest" %} - „[Deine Sicherheit auf {% data variables.product.prodname_dotcom %} aufrechterhalten](/github/building-a-strong-community/maintaining-your-safety-on-github)" - „[Interaktionen in Deinem Repository einschränken](/github/building-a-strong-community/limiting-interactions-in-your-repository)“{% endif %} - „[Änderungen an einem Kommentar verfolgen](/articles/tracking-changes-in-a-comment)“ diff --git a/translations/de-DE/content/github/building-a-strong-community/setting-guidelines-for-repository-contributors.md b/translations/de-DE/content/github/building-a-strong-community/setting-guidelines-for-repository-contributors.md index 84dd19ab5000..e4a8797e477e 100644 --- a/translations/de-DE/content/github/building-a-strong-community/setting-guidelines-for-repository-contributors.md +++ b/translations/de-DE/content/github/building-a-strong-community/setting-guidelines-for-repository-contributors.md @@ -3,7 +3,7 @@ title: Richtlinien für Repository-Mitarbeiter festlegen redirect_from: - /articles/how-do-i-set-up-guidelines-for-contributors/ - /articles/setting-guidelines-for-repository-contributors -intro: 'Du kannst Richtlinien erstellen, wie Personen zu Deinem Projekt beitragen sollten.' +intro: Du kannst Richtlinien erstellen, wie Personen zu Deinem Projekt beitragen sollten. versions: free-pro-team: '*' enterprise-server: '*' @@ -19,7 +19,7 @@ Mitarbeitern helfen die Richtlinien, korrekt formulierte Pull Requests einzureic Sowohl Inhaber als auch Mitarbeiter sparen dank Beitragsrichtlinien Zeit und Mühen, die durch fehlerhaft formulierte Pull Requests oder Issues entstehen, die abgelehnt und erneut eingereicht werden müssen. -Du kannst Standard-Beitragsrichtlinien für Deine Organisation{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} oder Dein Benutzerkonto{% endif %} erstellen. Weitere Informationen findest Du unter „[Eine Standard Community-Unterstützungsdatei erstellen](/github/building-a-strong-community/creating-a-default-community-health-file)." +You can create default contribution guidelines for your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %}. Weitere Informationen findest Du unter „[Eine Standard Community-Unterstützungsdatei erstellen](/github/building-a-strong-community/creating-a-default-community-health-file)." {% tip %} @@ -51,6 +51,6 @@ Wenn Du nun nicht sicher bist, was Du hier festlegen sollst, findest Du nachfolg - [Beitragsrichtlinien](https://github.com/opengovernment/opengovernment/blob/master/CONTRIBUTING.md) des Open Government. ### Weiterführende Informationen -- Abschnitt „[Starting an Open Source Project](https://opensource.guide/starting-a-project/)“ (Open-Source-Projekt starten) der Open-Source-Leitfäden{% if currentVersion == "free-pro-team@latest" %} +- The Open Source Guides' section "[Starting an Open Source Project](https://opensource.guide/starting-a-project/)"{% if currentVersion == "free-pro-team@latest" %} - [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}){% endif %} - „[Eine Lizenz zu einem Repository hinzufügen](/articles/adding-a-license-to-a-repository)“ diff --git a/translations/de-DE/content/github/building-a-strong-community/tracking-changes-in-a-comment.md b/translations/de-DE/content/github/building-a-strong-community/tracking-changes-in-a-comment.md index b5b5944f8d54..dece7a91dcc9 100644 --- a/translations/de-DE/content/github/building-a-strong-community/tracking-changes-in-a-comment.md +++ b/translations/de-DE/content/github/building-a-strong-community/tracking-changes-in-a-comment.md @@ -28,5 +28,5 @@ Wenn Du sensible Informationen aus dem Änderungsverlauf eines Kommentars lösch ### Weiterführende Informationen -{% if currentVersion == "free-pro-team@latest" %}- „[Missbrauch oder Spam melden](/articles/reporting-abuse-or-spam)“{% endif %} +{% if currentVersion == "free-pro-team@latest" %}- "[Reporting abuse or spam](/articles/reporting-abuse-or-spam)"{% endif %} - „[Kommentar bearbeiten](/articles/editing-a-comment)“ diff --git a/translations/de-DE/content/github/building-a-strong-community/unblocking-a-user-from-your-organization.md b/translations/de-DE/content/github/building-a-strong-community/unblocking-a-user-from-your-organization.md index d398e99e4868..88405cd291c7 100644 --- a/translations/de-DE/content/github/building-a-strong-community/unblocking-a-user-from-your-organization.md +++ b/translations/de-DE/content/github/building-a-strong-community/unblocking-a-user-from-your-organization.md @@ -1,6 +1,6 @@ --- title: Sperre eines Benutzers für Deine Organisation aufheben -intro: Organisationsinhaber können die Sperre eines zuvor blockierten Benutzers aufheben. Damit wird dessen Zugriff auf die Repositorys der Organisation wiederhergestellt. +intro: 'Organisationsinhaber können die Sperre eines zuvor blockierten Benutzers aufheben. Damit wird dessen Zugriff auf die Repositorys der Organisation wiederhergestellt.' redirect_from: - /articles/unblocking-a-user-from-your-organization versions: diff --git a/translations/de-DE/content/github/building-a-strong-community/unblocking-a-user-from-your-personal-account.md b/translations/de-DE/content/github/building-a-strong-community/unblocking-a-user-from-your-personal-account.md index b4c7f99f787c..6224f52da060 100644 --- a/translations/de-DE/content/github/building-a-strong-community/unblocking-a-user-from-your-personal-account.md +++ b/translations/de-DE/content/github/building-a-strong-community/unblocking-a-user-from-your-personal-account.md @@ -1,6 +1,6 @@ --- title: Sperre eines Benutzers für Dein persönliches Konto aufheben -intro: 'Wenn Du den Konflikt mit einem von Dir gesperrten {% data variables.product.prodname_dotcom %}-Benutzer gelöst hast, kannst Du sein Konto entsperren.' +intro: 'Wenn Sie einen {% data variables.product.prodname_dotcom %}-Benutzer blockiert haben, um dessen Benachrichtigungen, Einladungen und Beiträge abzuwehren, können Sie die Blockierung dieses Benutzers wieder aufheben.' redirect_from: - /articles/unblocking-a-user-from-your-personal-account versions: diff --git a/translations/de-DE/content/github/building-a-strong-community/using-templates-to-encourage-useful-issues-and-pull-requests.md b/translations/de-DE/content/github/building-a-strong-community/using-templates-to-encourage-useful-issues-and-pull-requests.md index b157abbff1a8..6b3509d94011 100644 --- a/translations/de-DE/content/github/building-a-strong-community/using-templates-to-encourage-useful-issues-and-pull-requests.md +++ b/translations/de-DE/content/github/building-a-strong-community/using-templates-to-encourage-useful-issues-and-pull-requests.md @@ -1,6 +1,6 @@ --- title: Verwenden von Vorlagen zur Förderung nützlicher Issues und Pull Requests -intro: 'Repository-Betreuer können Vorlagen in einem Repository hinzufügen, damit Mitarbeiter hochwertige Issues und Pull Requests erstellen können.' +intro: Repository-Betreuer können Vorlagen in einem Repository hinzufügen, damit Mitarbeiter hochwertige Issues und Pull Requests erstellen können. mapTopic: true redirect_from: - /github/building-a-strong-community/using-issue-and-pull-request-templates diff --git a/translations/de-DE/content/github/building-a-strong-community/viewing-users-youve-blocked-from-your-personal-account.md b/translations/de-DE/content/github/building-a-strong-community/viewing-users-youve-blocked-from-your-personal-account.md index 47e02034e47b..8dcdf726cb6a 100644 --- a/translations/de-DE/content/github/building-a-strong-community/viewing-users-youve-blocked-from-your-personal-account.md +++ b/translations/de-DE/content/github/building-a-strong-community/viewing-users-youve-blocked-from-your-personal-account.md @@ -1,6 +1,6 @@ --- -title: 'Benutzer anzeigen, die Du für Dein persönliches Konto blockiert hast' -intro: 'Du kannst eine Liste sämtlicher Benutzer anzeigen, die Du in Deinem persönlichen Konto blockiert hast.' +title: Benutzer anzeigen, die Du für Dein persönliches Konto blockiert hast +intro: Du kannst eine Liste sämtlicher Benutzer anzeigen, die Du in Deinem persönlichen Konto blockiert hast. redirect_from: - /articles/viewing-users-you-ve-blocked-from-your-personal-account - /articles/viewing-users-youve-blocked-from-your-personal-account diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-branches.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-branches.md index 74382f1e7aa9..db8da409feda 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-branches.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-branches.md @@ -10,28 +10,30 @@ versions: --- -### Einführung in Branches +### Informationen zu Branches Branches allow you to develop features, fix bugs, or safely experiment with new ideas in a contained area of your repository. Du erstellst einen Branch immer aus einem existierenden Branch. Typically, you might create a new branch from the default branch of your repository. Da kannst dann in diesem Branch unabhängig von Änderungen arbeiten, die andere Personen im Repository machen. Ein Branch, den Du zur Erstellung einer Funktion aufbaust, wird häufig als Funktions-Branch oder Themen-Branch bezeichnet. Weitere Informationen findest Du unter „[Branches in Deinem Repository erstellen und löschen](/articles/creating-and-deleting-branches-within-your-repository/).“ -Du kannst einen Branch auch verwenden, um eine {% data variables.product.prodname_pages %}-Website zu veröffentlichen. Weitere Informationen findest Du unter „[Was sind {% data variables.product.prodname_dotcom %}-Pages?](/articles/what-is-github-pages).“ +Sie können einen Branch auch verwenden, um eine {% data variables.product.prodname_pages %}-Website zu veröffentlichen. Weitere Informationen findest Du unter „[Über {% data variables.product.prodname_pages %}](/articles/what-is-github-pages)." -Du benötigst Schreibzugriff auf ein Repository, um einen Branch zu erstellen, einen Pull Request zu öffnen oder Branches in einem Pull Request zu löschen und wiederherzustellen. Weitere Informationen findest Du unter „[Zugriffsberechtigungen auf {% data variables.product.product_name %}](/articles/access-permissions-on-github).“ +Du benötigst Schreibzugriff auf ein Repository, um einen Branch zu erstellen, einen Pull Request zu öffnen oder Branches in einem Pull Request zu löschen und wiederherzustellen. Weitere Informationen findest Du unter „[Zugriffsberechtigungen auf {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/access-permissions-on-github)“. ### About the default branch {% data reusables.branches.new-repo-default-branch %} The default branch is the branch that {% data variables.product.prodname_dotcom %} displays when anyone visits your repository. The default branch is also the initial branch that Git checks out locally out when someone clones the repository. {% data reusables.branches.default-branch-automatically-base-branch %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +By default, {% data variables.product.product_name %} names the default branch {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.23" %}`main`{% else %}`master`{% endif %} in any new repository. -By default, the default branch name is `master`, but you can set the name to anything that makes sense for your workflow. For more information on the default branch name, see "[Managing the default branch name for your repositories](/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories)." +{% data reusables.branches.set-default-branch %} -{% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} {% data reusables.branches.set-default-branch %} +{% endif %} + ### Mit Branches arbeiten Sobald Du mit Deiner Arbeit zufrieden bist, kannst Du einen Pull Request eröffnen, um die Änderungen im aktuellen Branch (dem *Head*-Branch) in einem anderen Branch (den *Basis*-Branch) zusammenzuführen. Weitere Informationen findest Du unter „[Informationen zu Pull Requests](/articles/about-pull-requests).“ @@ -71,7 +73,7 @@ Wenn ein Branch geschützt ist, trifft Folgendes zu: - Wenn die erforderlichen Statuschecks für den Branch aktiviert sind, kannst Du Änderungen erst dann in den Branch zusammenführen, wenn alle erforderlichen CI-Tests bestanden sind. Weitere Informationen findest Du unter „[Informationen zu Statuschecks](/articles/about-status-checks).“ - Wenn erforderliche Pull-Request-Reviews auf dem Branch aktiviert sind, kannst Du Änderungen erst dann in den Branch zusammenführen, wenn alle Anforderungen der Richtlinie für Pull-Request-Reviews erfüllt sind. Weitere Informationen findest Du unter „[Einen Pull Request zusammenführen](/articles/merging-a-pull-request).“ - Wenn der erforderliche Review von einem Codeinhaber auf einem Branch aktiviert ist und der Code mit einem Inhaber durch einen Pull Request geändert wird, muss ein Codeinhaber den Pull Request genehmigen, bevor er zusammengeführt werden kann. Weitere Informationen findest Du unter „[Informationen zu Codeinhabern](/articles/about-code-owners).“ -- Wenn die obligatorische Commit-Signatur auf einem Branch aktiviert ist, kannst Du keine Commits an den Branch übertragen, die nicht signiert und verifiziert sind. Weitere Informationen findest Du unter „[Informationen zur Verifizierung der Commit-Signatur](/articles/about-commit-signature-verification)“ und „[Informationen zur obligatorischen Commit-Signatur](/articles/about-required-commit-signing).“{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} +- Wenn die obligatorische Commit-Signatur auf einem Branch aktiviert ist, kannst Du keine Commits an den Branch übertragen, die nicht signiert und verifiziert sind. For more information, see "[About commit signature verification](/articles/about-commit-signature-verification)" and "[About required commit signing](/articles/about-required-commit-signing)."{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} - Wenn du den Konflikt-Editor von {% data variables.product.prodname_dotcom %} benutzt, um Konflikte für eine Pull Request zu beheben, die Du aus einem geschützten Branch erstellt hast, wird Dir {% data variables.product.prodname_dotcom %} helfen, einen alternativen Branch für den Pull-Request zu erstellen, so dass Deine Auflösung der Konflikte zusammengeführt werden kann. Weitere Informationen findest Du unter „[Einen Mergekonflikt auf {% data variables.product.prodname_dotcom %} beheben](/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github).“{% endif %} ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-collaborative-development-models.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-collaborative-development-models.md index 5dce1ffda3db..c866c321f317 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-collaborative-development-models.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-collaborative-development-models.md @@ -1,6 +1,6 @@ --- title: Informationen zu gemeinschaftlichen Entwicklungsmodellen -intro: 'Die Art und Weise, wie Du Pull Requests verwendest, hängt von der Art des Entwicklungsmodells in Deinem Projekt ab.' +intro: Die Art und Weise, wie Du Pull Requests verwendest, hängt von der Art des Entwicklungsmodells in Deinem Projekt ab. redirect_from: - /articles/types-of-collaborative-development-models/ - /articles/about-collaborative-development-models diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md index 3062753b5d72..5265d4e5a0c7 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md @@ -1,6 +1,6 @@ --- title: Informationen zum Vergleich von Branches in Pull Requests -intro: 'In Pull Requests werden Diffs angezeigt, um die Änderungen, die Du in Deinem Themen-Branch vorgenommen hast, mit dem Basis-Branch zu vergleichen, in den du Deine Änderungen zusammenführen möchtest.' +intro: In Pull Requests werden Diffs angezeigt, um die Änderungen, die Du in Deinem Themen-Branch vorgenommen hast, mit dem Basis-Branch zu vergleichen, in den du Deine Änderungen zusammenführen möchtest. redirect_from: - /articles/about-comparing-branches-in-pull-requests versions: @@ -38,7 +38,7 @@ Du kannst außerdem Leerzeichenänderungen ignorieren, um eine genauere Ansicht ![Menü „Diff viewing options" (Diff-Anzeigeoptionen)](/assets/images/help/pull_requests/diff-settings-menu.png) -Um das Überprüfen von Änderungen in einem großen Pull-Request zu vereinfachen, kannst du den Diff so filtern, dass gelöschte Dateien ausgeblendet oder nur ausgewählte Dateitypen angezeigt werden{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}, sowie Dateien angezeigt werden, bei denen Du ein CODEOWNER bist, und Dateien verstecken werden, die Du bereits angesehen hast{% endif %}. Weitere Informationen findest Du unter „[Dateien in einem Pull Request nach Dateityp filtern](/articles/filtering-files-in-a-pull-request).“ +To simplify reviewing changes in a large pull request, you can filter the diff to only show selected file types, show files you are a CODEOWNER of, hide files you have already viewed, or hide deleted files. Weitere Informationen findest Du unter „[Dateien in einem Pull Request nach Dateityp filtern](/articles/filtering-files-in-a-pull-request).“ ![Dropdownmenü „File filter" (Dateifilter)](/assets/images/help/pull_requests/file-filter-menu.png) @@ -54,7 +54,7 @@ Ein Two-Dot-Diff (Zweipunkte-Diff) vergleicht zwei Git-Committish-Referenzen, wi Wenn Du einen Two-Dot-Diff in einem Pull Request simulieren und einen Vergleich zwischen den neuesten Versionen jedes Branch sehen möchtest, kannst Du den Basis-Branch in Deinen Themen-Branch zusammenführen, wodurch der letzte gemeinsame Vorgänger Deiner Branches aktualisiert wird. -Weitere Informationen zu Git-Befehlen zum Vergleich von Änderungen findest Du unter „[Git-Diff-Optionen](https://git-scm.com/docs/git-diff#git-diff-emgitdiffemltoptionsgtltcommitgtltcommitgt--ltpathgt82308203)“ auf der Buchseite _Pro Git_. +For more information about Git commands to compare changes, see "[Git diff options](https://git-scm.com/docs/git-diff#git-diff-emgitdiffemltoptionsgtltcommitgtltcommitgt--ltpathgt82308203)" from the _Pro Git_ book site. ### Gründe für Anzeigefehler bei Diffs - Du hast die maximale Anzahl von Dateien oder bestimmten Dateitypen überschritten. Weitere Informationen findest Du unter „[Begrenzungen für die Anzeige von Inhalten und Diffs in einem Repository](/articles/limits-for-viewing-content-and-diffs-in-a-repository/#diff-limits).“ diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github.md index 6b160039e132..97ec6ed73715 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github.md @@ -1,6 +1,6 @@ --- title: Informationen zu Unterhaltungen auf GitHub -intro: 'Du kannst spezifische Projekte und Änderungen sowie umfassendere Projekte oder Teamziele mithilfe verschiedener Arten von Diskussionen auf {% data variables.product.product_name %} besprechen.' +intro: 'Sie können spezifische Projekte und Änderungen sowie umfassendere Projekte oder Teamziele mithilfe verschiedener Arten von Diskussionen auf {% data variables.product.product_name %} besprechen.' redirect_from: - /articles/about-discussions-in-issues-and-pull-requests/ - /articles/about-conversations-on-github @@ -19,7 +19,7 @@ Issues sind nützlich bei der Diskussion spezifischer Details eines Projekts, be ### Auf Ideen in Kommentaren reagieren -Du kannst Deine Unterstützung oder Ablehnung für eine Idee in einer Unterhaltung zeigen. Wenn Du eine Reaktion auf einen Kommentar oder den Inhalt einer Teamdiskussion, eines Issues oder Pull-Requests hinzufügst, werden Personen, die die Unterhaltung abonniert haben, keine Benachrichtigung erhalten. Weitere Informationen über Abonnements findest Du unter {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}„[Über Benachrichtigungen](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}„[Benachrichtigungen abonnieren und kündigen](/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications){% endif %}." +Du kannst Deine Unterstützung oder Ablehnung für eine Idee in einer Unterhaltung zeigen. Wenn Du eine Reaktion auf einen Kommentar oder den Inhalt einer Teamdiskussion, eines Issues oder Pull-Requests hinzufügst, werden Personen, die die Unterhaltung abonniert haben, keine Benachrichtigung erhalten. For more information about subscriptions, 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 %}"[Subscribing to and unsubscribing from notifications](/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications){% endif %}." ![Beispiel für einen Issue mit Reaktionen](/assets/images/help/repository/issue-reactions.png) diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-forks.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-forks.md index a7678cfbbdca..212f37f2c150 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-forks.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-forks.md @@ -1,6 +1,6 @@ --- title: Informationen zu Forks -intro: 'Ein Fork ist eine Kopie eines Repositorys, das Du verwaltest. Mit Forks kannst Du Änderungen an einem Projekt vornehmen, ohne dass sich dies auf das ursprüngliche Repository auswirkt. Du kannst Updates aus dem ursprünglichen Repository abrufen oder Änderungen mit Pull Requests an das Repository senden.' +intro: Ein Fork ist eine Kopie eines Repositorys, das Du verwaltest. Mit Forks kannst Du Änderungen an einem Projekt vornehmen, ohne dass sich dies auf das ursprüngliche Repository auswirkt. Du kannst Updates aus dem ursprünglichen Repository abrufen oder Änderungen mit Pull Requests an das Repository senden. redirect_from: - /articles/about-forks versions: @@ -17,17 +17,17 @@ Das Forking eines Repositorys ist ähnlich wie das Kopieren eines Repositorys, m {% data reusables.repositories.desktop-fork %} -Das Löschen eines Forks wird das ursprüngliche vorgelagerte Repository nicht löschen. Du kannst beliebige Änderungen an Deiner Fork vornehmen – Mitarbeiter hinzufügen, Dateien umbenennen, {% data variables.product.prodname_pages %} generieren –, ohne Auswirkungen auf das Original.{% if currentVersion == "free-pro-team@latest" %} Du kannst ein geforktes Repository nach dem Löschen nicht wiederherstellen. Weitere Informationen findest Du unter „[Ein gelöschtes Repository wiederherstellen](/articles/restoring-a-deleted-repository)“.{% endif %} +Das Löschen eines Forks wird das ursprüngliche vorgelagerte Repository nicht löschen. You can make any changes you want to your fork—add collaborators, rename files, generate {% data variables.product.prodname_pages %}—with no effect on the original.{% if currentVersion == "free-pro-team@latest" %} You cannot restore a deleted forked repository. Weitere Informationen findest Du unter „[Ein gelöschtes Repository wiederherstellen](/articles/restoring-a-deleted-repository)“.{% endif %} In Open-Source-Projekten werden Forks oft verwendet, um mehrfach Ideen oder Änderungen durchzuspielen, bevor sie an das vorgelagerte Repository zurückgesendet werden. Wenn Du Änderungen in Deiner benutzereigenen Fork vornimmst und einen Pull Request öffnest, die Deine Arbeit mit dem vorgelagerten Repository vergleicht, kannst Du jedem mit Push-Zugriff auf das vorgelagerte Repository die Erlaubnis geben, Änderungen in deinen Pull-Request-Branch zu übertragen. Dies beschleunigt die Zusammenarbeit, indem es den Repository-Betreuern erlaubt, Commits zu erstellen oder Tests vor dem Zusammenführen lokal aus einer benutzereigenen Fork zu Deinem Pull-Request-Branch auszuführen. Du kannst keine Push-Berechtigungen an eine Fork geben, die einer Organisation gehört. {% data reusables.repositories.private_forks_inherit_permissions %} -Wenn Du ein neues Repository aus dem Inhalt eines bestehenden Repositorys erstellen möchtest, Deine Änderungen aber in Zukunft nicht mit dem vorgelagerten Repository zusammenführen möchtest, kannst Du das Repository duplizieren{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} oder, wenn das Repository eine Vorlage ist, das Repository als Vorlage verwenden{% endif %}. Weitere Informationen findest Du unter „[Ein Repository duplizieren](/articles/duplicating-a-repository)“{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} und „[Ein Repository anhand einer Vorlage erstellen](/articles/creating-a-repository-from-a-template)“{% endif %}. +If you want to create a new repository from the contents of an existing repository but don't want to merge your changes upstream in the future, you can duplicate the repository or, if the repository is a template, use the repository as a template. Weitere Informationen finden Sie unter „[Ein Repository duplizieren](/articles/duplicating-a-repository)“ und „[Ein Repository anhand einer Vorlage erstellen](/articles/creating-a-repository-from-a-template)“. ### Weiterführende Informationen - „[Informationen zu gemeinschaftlichen Entwicklungsmodellen](/articles/about-collaborative-development-models)“ - „[Einen Pull Request von einem Fork erstellen](/articles/creating-a-pull-request-from-a-fork)“ -- [Open-Source-Leitfäden](https://opensource.guide/){% if currentVersion == "free-pro-team@latest" %} +- [Open Source Guides](https://opensource.guide/){% if currentVersion == "free-pro-team@latest" %} - [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}){% endif %} diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-merge-conflicts.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-merge-conflicts.md index 133c3a019a21..707f1e207c0e 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-merge-conflicts.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-merge-conflicts.md @@ -10,7 +10,7 @@ versions: Oft kann Git Unterschiede zwischen Branches beheben und diese automatisch zusammenführen. In der Regel liegen die Änderungen in verschiedenen Zeilen oder sogar in verschiedenen Dateien vor, was das Zusammenführen für Computer leicht verständlich macht. Manchmal gibt es jedoch konkurrierende Änderungen, die Git ohne Deine Hilfe nicht bewältigen kann. Häufig treten Mergekonflikte auf, wenn Personen unterschiedliche Änderungen an derselben Zeile derselben Datei vornehmen, oder wenn eine Person eine Datei bearbeitet und eine andere Person dieselbe Datei löscht. -Du musst alle Mergekonflikte lösen, bevor Du einen Pull Request auf {% data variables.product.product_name %} zusammenführen kannst. Wenn Du in Deinem Pull Request einen Mergekonflikt zwischen dem Vergleichsbranch und dem Basisbranch hast, kannst Du eine Liste der Dateien mit in Konflikt stehenden Änderungen oberhalb der Schaltfläche **Merge pull request** (Pull Request zusammenführen) ansehen. Die Schaltfläche **Merge pull request** (Pull Request zusammenführen) wird erst aktiviert, wenn Du alle Konflikte zwischen dem Vergleichsbranch und dem Basisbranch gelöst hast. +Sie müssen alle Mergekonflikte lösen, bevor Sie einen Pull Request auf {% data variables.product.product_name %} mergen können. Wenn Du in Deinem Pull Request einen Mergekonflikt zwischen dem Vergleichsbranch und dem Basisbranch hast, kannst Du eine Liste der Dateien mit in Konflikt stehenden Änderungen oberhalb der Schaltfläche **Merge pull request** (Pull Request zusammenführen) ansehen. Die Schaltfläche **Merge pull request** (Pull Request zusammenführen) wird erst aktiviert, wenn Du alle Konflikte zwischen dem Vergleichsbranch und dem Basisbranch gelöst hast. ![Fehlermeldung bei Mergekonflikten](/assets/images/help/pull_requests/merge_conflict_error_on_github.png) @@ -18,10 +18,10 @@ Du musst alle Mergekonflikte lösen, bevor Du einen Pull Request auf {% data var Um einen Mergekonflikt zu beheben, musst Du die Konfliktdatei manuell bearbeiten, um die Änderungen auszuwählen, die Du beim endgültigen Merge beibehalten möchtest. Es gibt verschiedene Möglichkeiten, einen Mergekonflikt zu beheben: -- Wenn Dein Mergekonflikt durch konkurrierende Zeilenänderungen verursacht wird, z. B. wenn Personen unterschiedliche Änderungen an derselben Zeile derselben Datei auf verschiedenen Branches in Deinem Git-Repository vornehmen, kannst Du ihn mit dem Konflikteditor von {% data variables.product.product_name %} beheben. Weitere Informationen findest Du unter „[Einen Mergekonflikt auf {% data variables.product.prodname_dotcom %} beheben](/articles/resolving-a-merge-conflict-on-github).“ +- Wenn Ihr Mergekonflikt durch konkurrierende Zeilenänderungen verursacht wird, z. B. wenn Personen unterschiedliche Änderungen an derselben Zeile derselben Datei auf verschiedenen Branches in Ihrem Git-Repository vornehmen, können Sie ihn mit dem Konflikteditor von {% data variables.product.product_name %} beheben. Weitere Informationen findest Du unter „[Einen Mergekonflikt auf {% data variables.product.prodname_dotcom %} beheben](/articles/resolving-a-merge-conflict-on-github).“ - Bei allen anderen Arten von Mergekonflikten musst Du den Mergekonflikt in einem lokalen Klon des Repositorys beheben und die Änderung an Deinen Branch auf {% data variables.product.product_name %} übertragen. Zum Übertragen der Änderung kannst Du die Befehlszeile oder ein Tool wie [{% data variables.product.prodname_desktop %}](https://desktop.github.com/) verwenden. Weitere Informationen findest Du unter „[Einen Mergekonflikt in der Befehlszeile beheben](/articles/resolving-a-merge-conflict-using-the-command-line).“ -Wenn Du einen Mergekonflikt in der Befehlszeile hast, kannst Du Deine lokalen Änderungen erst dann an {% data variables.product.product_name %} übertragen, wenn Du den Mergekonflikt lokal auf Deinem Computer behoben hast. Wenn Du versuchst, Branches mit einem Mergekonflikt in der Befehlszeile zusammenzuführen, wird Ihnen eine Fehlermeldung angezeigt. Weitere Informationen findest Du unter „[Einen Mergekonflikt in der Befehlszeile beheben](/articles/resolving-a-merge-conflict-using-the-command-line/).“ +Wenn Sie einen Mergekonflikt in der Befehlszeile haben, können Sie Ihre lokalen Änderungen erst an {% data variables.product.product_name %} pushen, wenn Sie den Mergekonflikt lokal auf Ihrem Computer behoben haben. Wenn Du versuchst, Branches mit einem Mergekonflikt in der Befehlszeile zusammenzuführen, wird Ihnen eine Fehlermeldung angezeigt. Weitere Informationen findest Du unter „[Einen Mergekonflikt in der Befehlszeile beheben](/articles/resolving-a-merge-conflict-using-the-command-line/).“ ```shell $ git merge BRANCH-NAME > Auto-merging styleguide.md diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-merges.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-merges.md index e1744c9e251a..b6b2c9647605 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-merges.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-merges.md @@ -41,7 +41,7 @@ In folgenden Fällen ist kein automatisches Rebasing und Zusammenführen auf {% - Beim Rebasing der Commits vom Basis-Branch in den Head-Branch kommt es zu Konflikten. - Das Rebasing der Commits gilt als „unsicher“, beispielsweise wenn ein Rebase ohne Mergekonflikte möglich ist, jedoch ein anderes Ergebnis liefern würde als ein Merge. -Wenn Du trotzdem ein Rebasing der Commits durchführen möchtest, aber kein automatischer Rebase auf {% data variables.product.product_location %} möglich ist, musst Du folgendermaßen vorgehen: +Wenn Sie trotzdem ein Rebasing der Commits durchführen möchten, aber kein automatischer Rebase auf {% data variables.product.product_location %} möglich ist, müssen Sie folgendermaßen vorgehen: - Führe ein Rebasing des Themen-Branches (oder Head-Branches) auf den Basis-Branch lokal in der Befehlszeile durch. - [Behebe Mergekonflikte in der Befehlszeile](/articles/resolving-a-merge-conflict-using-the-command-line/). - Erzwinge den Push der Rebase-Commits an den Themen-Branch (oder Remote-Head-Branch) des Pull Requests. diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-reviews.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-reviews.md index 7a31bf6f5fae..4500c185b5e5 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-reviews.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-reviews.md @@ -12,11 +12,11 @@ versions: Nachdem ein Pull-Request geöffnet wurde, kann jeder mit *Lese*-Zugriff die vorgeschlagenen Änderungen überprüfen und kommentieren. Du kannst auch spezifische Änderungen an Codezeilen vorschlagen, die der Autor direkt aus dem Pull-Request anwenden kann. Weitere Informationen findest Du unter „[Vorgeschlagene Änderungen in einem Pull Request überprüfen](/articles/reviewing-proposed-changes-in-a-pull-request).“ -Repository-Inhaber und -Mitarbeiter können von einer bestimmten Person einen Review des Pull Requests anfordern. Organisationsmitglieder können auch einen Review eines Pull Requests von einem Team mit Lesezugriff auf das Repository anfordern. Weitere Informationen findest Du unter „[Einen Pull-Request-Review anfordern](/articles/requesting-a-pull-request-review).“ {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}Du kannst anstelle des gesamten Teams auch nur eine Teilmenge von Teammitgliedern angeben, die automatisch zugewiesen werden sollen. Weitere Informationen findest Du unter „[Code Review-Zuweisung für Dein Team verwalten](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)."{% endif %} +Repository-Inhaber und -Mitarbeiter können von einer bestimmten Person einen Review des Pull Requests anfordern. Organisationsmitglieder können auch einen Review eines Pull Requests von einem Team mit Lesezugriff auf das Repository anfordern. Weitere Informationen findest Du unter „[Einen Pull-Request-Review anfordern](/articles/requesting-a-pull-request-review).“ {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}You can specify a subset of team members to be automatically assigned in the place of the whole team. Weitere Informationen findest Du unter „[Code Review-Zuweisung für Dein Team verwalten](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)."{% endif %} Reviews ermöglichen eine Diskussion der vorgeschlagenen Änderungen und tragen dazu bei, dass die Änderungen den Beitragsrichtlinien des Repositorys wie auch anderen Qualitätsstandards entsprechen. Du kannst definieren, welche Personen oder Teams bestimmte Codetypen oder -bereiche in einer CODEOWNERS-Datei besitzen. Wenn durch einen Pull Request Code mit einem definierten Inhaber geändert wird, wird diese Person oder dieses Team automatisch als Reviewer angefordert. Weitere Informationen finden Sie unter „[Informationen zu Codeinhabern](/articles/about-code-owners/)“. -{% if currentVersion == "free-pro-team@latest" %}Du kannst Erinnerungen für Pull Requests planen, die überprüft werden müssen. Weitere Informationen findest Du unter „[Geplante Erinnerungen für Pull-Requests verwalten](/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests)."{% endif %} +{% if currentVersion == "free-pro-team@latest" %}You can schedule reminders for pull requests that need to be reviewed. Weitere Informationen findest Du unter „[Geplante Erinnerungen für Pull-Requests verwalten](/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests)."{% endif %} ![Header eines Reviews, der Änderungen mit Zeilenkommentaren anfordert](/assets/images/help/pull_requests/review-header-with-line-comment.png) diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-pull-requests.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-pull-requests.md index 3e1a2d95a777..f025565c2c39 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-pull-requests.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-pull-requests.md @@ -1,6 +1,6 @@ --- title: Informationen zu Pull Requests -intro: 'Mit Pull Requests kannst Du andere Benutzer über Änderungen informieren, die Du an einen Branch in einem Repository auf {% data variables.product.product_name %} übertragen hast. Sobald ein Pull Request geöffnet ist, kannst Du die potenziellen Änderungen mit Mitarbeitern diskutieren und überprüfen und Follow-up-Commits hinzufügen, bevor Deine Änderungen in den Basis-Branch übertragen werden.' +intro: 'Mit Pull Requests können Sie andere Benutzer über Änderungen informieren, die Sie an einen Branch in einem Repository auf {% data variables.product.product_name %} gepusht haben. Sobald ein Pull Request geöffnet ist, kannst Du die potenziellen Änderungen mit Mitarbeitern diskutieren und überprüfen und Follow-up-Commits hinzufügen, bevor Deine Änderungen in den Basis-Branch übertragen werden.' redirect_from: - /articles/using-pull-requests/ - /articles/about-pull-requests diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md index a19ba85e4e3d..c1c2b28d028e 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md @@ -1,6 +1,6 @@ --- title: Informationen zu Statuschecks -intro: 'Statuschecks informieren Dich darüber, ob Deine Commits die festgelegten Bedingungen erfüllen, die für das Repository gelten, an dem Du mitwirkst.' +intro: Statuschecks informieren Dich darüber, ob Deine Commits die festgelegten Bedingungen erfüllen, die für das Repository gelten, an dem Du mitwirkst. redirect_from: - /articles/about-statuses/ - /articles/about-status-checks diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/allowing-changes-to-a-pull-request-branch-created-from-a-fork.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/allowing-changes-to-a-pull-request-branch-created-from-a-fork.md index 0addc845f75a..673aa4700d41 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/allowing-changes-to-a-pull-request-branch-created-from-a-fork.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/allowing-changes-to-a-pull-request-branch-created-from-a-fork.md @@ -1,5 +1,5 @@ --- -title: 'Änderungen an einem Pull-Request-Branch zulassen, der von einem Fork erstellt wurde' +title: Änderungen an einem Pull-Request-Branch zulassen, der von einem Fork erstellt wurde intro: 'Für eine bessere Zusammenarbeit kannst Du Commits für Branches erlauben, die Du aus Forks in Deinem Benutzerkonto erstellt hast.' redirect_from: - /articles/allowing-changes-to-a-pull-request-branch-created-from-a-fork @@ -17,7 +17,7 @@ Du kannst Commit-Berechtigungen festlegen, wenn Du erstmalig einen Pull Request ### Repository-Betreuer-Berechtigungen auf vorhandene Pull Requests aktivieren -1. Navigiere auf {% data variables.product.product_name %} zur Hauptseite des vorgelagerten Repositorys Deines Pull Requests. +1. Navigieren Sie auf {% data variables.product.product_name %} zur Hauptseite des vorgelagerten Repositorys Ihres Pull Requests. 2. Klicke unter dem Namen des vorgelagerten Repositorys auf {% octicon "git-pull-request" aria-label="The pull request icon" %} **Pull requests** (Pull Requests). ![Auswahl der Issue- und Pull-Request-Registerkarten](/assets/images/help/repository/repo-tabs-pull-requests.png) 3. Navigiere in der Liste der Pull Requests zu dem Pull Request, für den Du Commits zulassen möchtest. {% data reusables.repositories.allow-maintainers-user-forks %} diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/changing-the-stage-of-a-pull-request.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/changing-the-stage-of-a-pull-request.md index 54136fa2c9d9..cd4ea8377d10 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/changing-the-stage-of-a-pull-request.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/changing-the-stage-of-a-pull-request.md @@ -1,6 +1,6 @@ --- title: Die Zustand eines Pull Requests ändern -intro: 'Du kannst einen Pull-Request-Review als bereit zur Überprüfung markieren{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} oder einen Pull Request in einen Entwurf umwandeln{% endif %}.' +intro: 'You can mark a draft pull request as ready for review{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} or convert a pull request to a draft{% endif %}.' permissions: Personen mit Schreibberechtigungen in ein Repository sowie Pull-Request-Autoren können den Zustand eines Pull-Requests ändern. product: '{% data reusables.gated-features.draft-prs %}' redirect_from: diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally.md index e6b501f87888..2c1b00ea2ca4 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally.md @@ -18,7 +18,7 @@ versions: ### Einen aktiven Pull Request lokal ändern {% data reusables.repositories.sidebar-pr %} -2. Klicke in der Liste der Pull-Requests auf die Pull-Requests, die Du ändern möchtest.{% if currentVersion == "free-pro-team@latest" %} +2. In the list of pull requests, click the pull request you'd like to modify.{% if currentVersion == "free-pro-team@latest" %} 3. Um auszuwählen, wo Du den Pull Request öffnen willst, wähle das Dropdownmenü „**Open with {% octicon "triangle-down" aria-label="The down triangle icon" %}**" und klicke auf eine der Registerkarten. ![Link um auf die Pull-Request-Anweisungen in der Befehlszeile zuzugreifen](/assets/images/help/pull_requests/open-with-button.png){% else %} 3. Klicke im Merge-Feld auf **Befehlszeilenanweisungen**. Führen Sie nacheinander die Schritte durch, um den vorgeschlagenen Pull Request herunterzuladen. ![Links zum Zugriff auf Anleitungen zu Befehlszeilen-Pull-Requests](/assets/images/help/pull_requests/pull_request_show_command_line_merge.png) 4. Klicke optional zur Ansicht der vorgeschlagenen Änderungen mit {% data variables.product.prodname_desktop %} auf **öffne dies mit {% data variables.product.prodname_desktop %}**. ![Link to open a pull request locally in Desktop](/assets/images/help/desktop/open-pr-in-desktop.png){% endif %} diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/collaborating-on-repositories-with-code-quality-features.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/collaborating-on-repositories-with-code-quality-features.md index 1c5afcb364ae..95ca378e1e12 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/collaborating-on-repositories-with-code-quality-features.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/collaborating-on-repositories-with-code-quality-features.md @@ -1,6 +1,6 @@ --- -title: An Repositorys mit Codequalität-Funktionen zusammenarbeiten -intro: 'Workflow-Qualitätsfunktionen wie Status, {% if currentVersion != "free-pro-team@latest" %}Pre-Receive-Hooks, {% endif %}geschützte Branches und erforderliche Statuschecks helfen Mitarbeitern dabei, Beiträge zu leisten, die den Bedingungen der Organisations- und Repository-Administratoren entsprechen.' +title: Collaborating on repositories with code quality features +intro: 'Workflow quality features like statuses, {% if currentVersion != "free-pro-team@latest" %}pre-receive hooks, {% endif %}protected branches, and required status checks help collaborators make contributions that meet conditions set by organization and repository administrators.' mapTopic: true redirect_from: - /articles/collaborating-on-repositories-with-code-quality-features-enabled/ diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request.md index 4f81ce7ecc81..12e3d10d8e4f 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request.md @@ -54,5 +54,5 @@ Alle, die den Pull Request oder das Repository beobachten, erhalten eine Benachr ### Weiterführende Informationen - „[Einen Permalink zu einem Code-Ausschnitt erstellen](/articles/creating-a-permanent-link-to-a-code-snippet/)“ -{% if currentVersion == "free-pro-team@latest" %}- „[Missbrauch oder Spam melden](/articles/reporting-abuse-or-spam)“ +{% if currentVersion == "free-pro-team@latest" %}- "[Reporting abuse or spam](/articles/reporting-abuse-or-spam)" {% endif %} diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md index 1727d92416b7..43c46751b34a 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md @@ -1,6 +1,6 @@ --- -title: 'Änderungen an einen Pull-Request-Branch freigeben, der von einem Fork erstellt wurde' -intro: 'Du kannst Änderungen an einen Pull-Request-Branch freigeben, der von einem Fork Deines Repositorys erstellt wurde, wenn die Erlaubnis des Pull-Request-Erstellers vorliegt.' +title: Änderungen an einen Pull-Request-Branch freigeben, der von einem Fork erstellt wurde +intro: Du kannst Änderungen an einen Pull-Request-Branch freigeben, der von einem Fork Deines Repositorys erstellt wurde, wenn die Erlaubnis des Pull-Request-Erstellers vorliegt. redirect_from: - /articles/committing-changes-to-a-pull-request-branch-created-from-a-fork versions: @@ -22,7 +22,9 @@ Nur der Benutzer, der den Pull Request erstellt hat, kann Dir die Erlaubnis erte {% endnote %} -1. Navigiere auf {% data variables.product.product_name %} zur Hauptseite des Forks (oder der Kopie Deines Repositorys), auf dem der Pull-Request-Branch erstellt wurde. +1. On + +{% data variables.product.product_name %}, navigate to the main page of the fork (or copy of your repository) where the pull request branch was created. {% data reusables.repositories.copy-clone-url %} {% data reusables.command_line.open_the_multi_os_terminal %} {% tip %} diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork.md index c35f1e53d728..9839fe2d2b9c 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork.md @@ -1,9 +1,9 @@ --- title: Einen Pull Request von einem Fork erstellen -intro: 'Du kannst einen Pull Request erstellen, um Änderungen vorzuschlagen, die Du an einer Fork eines vorgelagerten Repositorys vorgenommen hast.' +intro: Du kannst einen Pull Request erstellen, um Änderungen vorzuschlagen, die Du an einer Fork eines vorgelagerten Repositorys vorgenommen hast. redirect_from: - /articles/creating-a-pull-request-from-a-fork -permissions: 'Jeder, der Schreibzugriff auf ein Repository hat, kann einen Pull-Request von einer benutzereigenen Fork erstellen.' +permissions: Jeder, der Schreibzugriff auf ein Repository hat, kann einen Pull-Request von einer benutzereigenen Fork erstellen. versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md index d8f583c6f508..f9516565b82b 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md @@ -21,7 +21,7 @@ Du kannst festlegen, in welchen Branch Du Deine Änderungen zusammenführen möc ### Branch-Bereich und Ziel-Repository ändern -Standardmäßig basieren Pull Requests auf dem [Standardbranch](/articles/setting-the-default-branch) des übergeordneten Repositorys. +By default, pull requests are based on the parent repository's default branch. Weitere Informationen finden Sie unter „[Informationen zu Branches](/github/collaborating-with-issues-and-pull-requests/about-branches#about-the-default-branch)“. Wenn das standardmäßige übergeordnete Repository nicht korrekt ist, kannst Du über die Dropdownlisten sowohl das übergeordnete Repository als auch den Branch ändern. Du kannst über die Dropdownlisten auch Head- und Basis-Branches untereinander austauschen, um Diffs zwischen Referenzpunkten zu erstellen. Referenzen müssen hier Branch-Namen in Deinem GitHub-Repository sein. diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md index 1202dc93be9a..296b79b8e59e 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md @@ -1,6 +1,6 @@ --- title: Branches in Deinem Repository erstellen und löschen -intro: 'Du kannst Branches direkt auf {% data variables.product.product_name %} erstellen oder löschen.' +intro: 'Sie können Branches direkt auf {% data variables.product.product_name %} erstellen oder löschen.' redirect_from: - /articles/deleting-branches-in-a-pull-request/ - /articles/creating-and-deleting-branches-within-your-repository @@ -21,7 +21,7 @@ versions: {% data reusables.pull_requests.automatically-delete-branches %} -If the branch you want to delete is the repository's default branch, you must choose a new default branch before deleting the branch. For more information, see "[Setting the default branch](/github/administering-a-repository/setting-the-default-branch)." +If the branch you want to delete is the repository's default branch, you must choose a new default branch before deleting the branch. For more information, see "[Changing the default branch](/github/administering-a-repository/changing-the-default-branch)." If the branch you want to delete is associated with an open pull request, you must merge or close the pull request before deleting the branch. For more information, see "[Merging a pull request](/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request)" or "[Closing a pull request](/github/collaborating-with-issues-and-pull-requests/closing-a-pull-request)." diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md index c415b39d9184..fd2f16e0fc74 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md @@ -14,14 +14,10 @@ Dies ändert den Status des Reviews zu einem Review-Kommentar. Wenn Du einen Rev {% data reusables.search.requested_reviews_search %} {% data reusables.repositories.sidebar-pr %} -{% data reusables.repositories.choose-pr-review %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} +{% data reusables.repositories.choose-pr-review %} 3. Scrolle auf der Registerkarte „Conversation“ (Unterhaltung) zu dem Review, den Du verwerfen möchtest, und klicke dann auf {% octicon "chevron-down" aria-label="The down button" %}. ![Chevron-Symbol (spitze Klammer) im Merge-Feld](/assets/images/help/pull_requests/merge_box/pull-request-open-menu.png) 4. Klicke auf {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} und anschließend auf **Dismiss review** (Review verwerfen). ![3-Punkte-Symbol im Merge-Feld](/assets/images/help/pull_requests/merge_box/pull-request-dismiss-review.png) 5. Gib den Grund für das Verwerfen des Reviews ein, und klicke dann auf **Dismiss review** (Review verwerfen). ![Schaltfläche „Dismiss review" (Verwerfen eines Reviews)](/assets/images/help/pull_requests/merge_box/pull-request-dismiss-review-button.png) -{% else %} -3. Scrolle auf der Registerkarte „Conversation“ (Unterhaltung) zum Review, den Du sehen möchtest, dann klicke auf **Dismiss review** (Review verwerfen). ![Option zum Verwerfen eines Reviews](/assets/images/help/pull_requests/merge_box/pull-request-dismiss-review.png) -4. Gib den Grund für das Verwerfen des Reviews ein, und klicke dann auf **Dismiss review** (Review verwerfen). ![Schaltfläche „Dismiss review" (Verwerfen eines Reviews)](/assets/images/help/pull_requests/merge_box/pull-request-dismiss-review-button.png) -{% endif %} ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md index fb5faf61c616..426eb35897ef 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md @@ -9,11 +9,11 @@ versions: enterprise-server: '*' --- -Du kannst Dateien in einem Pull-Request nach Dateierweiterungstyp filtern, wie zum Beispiel `.html` oder `.js`, keine Erweiterung,{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} Code Inhaberschaft, {% endif %} oder Punktdateien. +You can filter files in a pull request by file extension type, such as `.html` or `.js`, lack of an extension, code ownership, or dotfiles. {% tip %} -**Tipp:** Um die Ansicht Deines Pull-Requests-Diffs zu vereinfachen, kannst Du temporär auch gelöschte Dateien{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} oder Dateien, die Du bereits angezeigt hast, {% endif %}in dem Pull-Request-Diff über das Dateifilter-Dropdownmenü ausblenden. +**Tip:** To simplify your pull request diff view, you can also temporarily hide deleted files or files you have already viewed in the pull request diff from the file filter drop-down menu. {% endtip %} diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/incorporating-changes-from-a-pull-request.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/incorporating-changes-from-a-pull-request.md index 76b6a28b0166..402d142a86e4 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/incorporating-changes-from-a-pull-request.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/incorporating-changes-from-a-pull-request.md @@ -1,6 +1,6 @@ --- title: Änderungen aus einem Pull Request implementieren -intro: 'Über Pull Requests kannst Du Änderungen für Deine Arbeit auf {% data variables.product.product_name %} vorschlagen. Erfahre, wie Du Pull Requests erstellst, verwaltest und zusammenführst.' +intro: 'Über Pull Requests können Sie Änderungen für Ihre Arbeit auf {% data variables.product.product_name %} vorschlagen. Erfahre, wie Du Pull Requests erstellst, verwaltest und zusammenführst.' mapTopic: true redirect_from: - /articles/incorporating-changes-from-a-pull-request diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/index.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/index.md index 6b4fd53deca6..44e594fadfd0 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/index.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/index.md @@ -1,6 +1,6 @@ --- title: Mithilfe von Issues und Pull Requests zusammenarbeiten -intro: 'Mit dem {% data variables.product.prodname_dotcom %}-Flow kannst Du Änderungen in Issues verfolgen und diskutieren und dann Änderungen in Pull Requests vorschlagen und überprüfen.' +intro: 'Mit dem {% data variables.product.prodname_dotcom %}-Flow können Sie Issues nachverfolgen und Änderungen diskutieren sowie Änderungen vorschlagen und in Pull Requests überprüfen.' redirect_from: - /categories/63/articles/ - /categories/collaborating/ diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md index 38f15ba169f7..0790534ced63 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md @@ -1,6 +1,6 @@ --- title: Einen Pull Request zusammenführen -intro: 'Führe einen Pull Request in den vorgelagerten Branch zusammen, wenn die Arbeit abgeschlossen ist. Jede Person mit Push-Zugriff auf das Repository kann den Merge abschließen.' +intro: Führe einen Pull Request in den vorgelagerten Branch zusammen, wenn die Arbeit abgeschlossen ist. Jede Person mit Push-Zugriff auf das Repository kann den Merge abschließen. redirect_from: - /articles/merging-a-pull-request versions: @@ -45,12 +45,13 @@ Wenn Du die Änderungen in einem Themen-Branch nicht in den vorgelagerten Branch 6. Klicke auf **Confirm merge** (Merge bestätigen), **Confirm squash and merge** (Squash und Merge bestätigen) oder **Confirm rebase and merge** (Rebase und Merge bestätigen). 6. Optional kannst Du auch [den Branch löschen](/articles/deleting-unused-branches). So bleibt die Liste der Branches in Ihrem Repository ordentlich. - {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}Dein Repository könnte so konfiguriert sein, dass der Head-Branch eines Pull Requests automatisch gelöscht wird, wenn Du den Pull Request zusammenführst. Weitere Informationen findest Du unter „[Verwalten des automatischen Löschens von Branches](/github/administering-a-repository/managing-the-automatic-deletion-of-branches)."{% endif %} +The repository may be configured so that the head branch for a pull request is automatically deleted when you merge a pull request. Weitere Informationen findest Du unter „[Verwalten des automatischen Löschens von Branches](/github/administering-a-repository/managing-the-automatic-deletion-of-branches)." {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} {% note %} - **Hinweis:** {% data reusables.pull_requests.retargeted-on-branch-deletion %} Weitere Informationen findest Du unter „[Über Branches](/github/collaborating-with-issues-and-pull-requests/about-branches#working-with-branches)." + **Note:** {% data reusables.pull_requests.retargeted-on-branch-deletion %} + For more information, see "[About branches](/github/collaborating-with-issues-and-pull-requests/about-branches#working-with-branches)." {% endnote %} {% endif %} diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md index 87e8fec641d0..10f20f9d4663 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md @@ -12,7 +12,7 @@ versions: 2. Wechsle Dein aktuelles Arbeitsverzeichnis in das lokale Projekt. 3. Checke den Branch aus, in den Du zusammenführen möchtest. Usually, you will merge into the default branch. ```shell - $ git checkout master + $ git checkout DEFAULT_BRANCH_NAME ``` 4. Rufe den gewünschten Branch aus dem vorgelagerten Repository ab. Auf diese Weise wird der Commit-Verlauf unverändert beibehalten. ```shell @@ -23,5 +23,5 @@ versions: 7. Überprüfe die Änderungen, und stelle sicher, dass alles in Ordnung ist. 8. Übertrage den Merge in Dein GitHub-Repository. ```shell - $ git push origin master + $ git push origin DEFAULT_BRANCH_NAME ``` diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/requesting-a-pull-request-review.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/requesting-a-pull-request-review.md index 49c6cfe630ec..0cd818c98ad3 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/requesting-a-pull-request-review.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/requesting-a-pull-request-review.md @@ -10,7 +10,7 @@ versions: Inhaber und Mitarbeiter eines Repositorys, das einem Benutzerkonto angehört, können Pull Requests zuweisen. Organisationsmitglieder mit Triage-Berechtigungen für ein Repository können einen Pull-Request-Review zuweisen. -Inhaber oder Mitarbeiter können jeder Person, der explizit [Lesezugriff](/articles/access-permissions-on-github) auf ein benutzereigenes Repository gewährt wurde, einen Pull-Request-Review zuweisen. Organisationsmitglieder können jeder Person oder jedem Team mit Lesezugriff auf das Repository einen Pull-Request-Review zuweisen. Der angeforderte Reviewer respektive das angeforderte Team erhält eine Benachrichtigung, dass Du einen Pull-Request-Review von ihm angefordert hast. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}Wenn Du einen Review von einem Team angefordert hast und wenn Code-Review-Zuweisung aktiviert ist, werden spezifische Mitglieder angefordert und das Team wird als Reviewer entfernt werden. Weitere Informationen findest Du unter „[Code Review-Zuweisung für Dein Team verwalten](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)."{% endif %} +Inhaber oder Mitarbeiter können jeder Person, der explizit [Lesezugriff](/articles/access-permissions-on-github) auf ein benutzereigenes Repository gewährt wurde, einen Pull-Request-Review zuweisen. Organisationsmitglieder können jeder Person oder jedem Team mit Lesezugriff auf das Repository einen Pull-Request-Review zuweisen. Der angeforderte Reviewer respektive das angeforderte Team erhält eine Benachrichtigung, dass Du einen Pull-Request-Review von ihm angefordert hast. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}If you request a review from a team and code review assignment is enabled, specific members will be requested and the team will be removed as a reviewer. Weitere Informationen findest Du unter „[Code Review-Zuweisung für Dein Team verwalten](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)."{% endif %} {% note %} diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md index 9d38c69184dd..1b9ed3f8d809 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md @@ -1,6 +1,6 @@ --- -title: Mergekonflikt auf GitHub beheben -intro: 'Einfache Mergekonflikte auf GitHub, bei denen Zeilenänderungen in Konflikt stehen, kannst Du mit dem Konflikteditor beheben.' +title: Resolving a merge conflict on GitHub +intro: 'You can resolve simple merge conflicts that involve competing line changes on GitHub, using the conflict editor.' redirect_from: - /articles/resolving-a-merge-conflict-on-github versions: @@ -8,50 +8,56 @@ versions: enterprise-server: '*' --- -Auf {% data variables.product.product_name %} kannst Du nur Mergekonflikte beheben, die durch konkurrierende Zeilenänderungen verursacht werden, beispielsweise, wenn mehrere Personen unterschiedliche Änderungen an der gleichen Zeile in der gleichen Datei in verschiedenen Branches Deines Git-Repositorys vornehmen. Alle anderen Mergekonflikte musst Du lokal in der Befehlszeile beheben. Weitere Informationen findest Du unter „[Einen Mergekonflikt in der Befehlszeile beheben](/articles/resolving-a-merge-conflict-using-the-command-line/).“ +You can only resolve merge conflicts on {% data variables.product.product_name %} that are caused by competing line changes, such as when people make different changes to the same line of the same file on different branches in your Git repository. For all other types of merge conflicts, you must resolve the conflict locally on the command line. For more information, see "[Resolving a merge conflict using the command line](/articles/resolving-a-merge-conflict-using-the-command-line/)." {% if currentVersion != "free-pro-team@latest" %} -Wenn ein Websiteadministrator den Editor für Mergekonflikte für Pull Requests zwischen Repositorys deaktiviert, kannst Du den Konflikteditor auf {% data variables.product.product_name %} nicht verwenden und musst Mergekonflikte auf der Befehlszeile beheben. Beispielsweise kannst du den Mergekonflikt-Editor, wenn er deaktiviert ist, nicht für Pull Requests zwischen einem Fork und einem vorgelagerten Repository verwenden. +If a site administrator disables the merge conflict editor for pull requests between repositories, you cannot use the conflict editor on {% data variables.product.product_name %} and must resolve merge conflicts on the command line. For example, if the merge conflict editor is disabled, you cannot use it on a pull request between a fork and upstream repository. {% endif %} {% warning %} {% if currentVersion ver_lt "enterprise-server@2.22" %} -**Warning:** When you resolve a merge conflict on {% data variables.product.product_name %}, the entire [base branch](/github/getting-started-with-github/github-glossary#base-branch) of your pull request is merged into the [head branch](/github/getting-started-with-github/github-glossary#head-branch), even if the head branch is the default branch of your repository or a protected branch. Vergewissern Sie sich, dass es wirklich dieser Branch ist, den Sie festschreiben möchten. +**Warning:** When you resolve a merge conflict on {% data variables.product.product_name %}, the entire [base branch](/github/getting-started-with-github/github-glossary#base-branch) of your pull request is merged into the [head branch](/github/getting-started-with-github/github-glossary#head-branch), even if the head branch is the default branch of your repository or a protected branch. Make sure you really want to commit to this branch. {% else %} -**Warnung:** Wenn Du einen Mergekonflikt auf {% data variables.product.product_name %} auflöst, wird der gesamte [Basis-Branch](/github/getting-started-with-github/github-glossary#base-branch) Deines Pull Requests in den [Head-Branch](/github/getting-started-with-github/github-glossary#head-branch) zusammengeführt. Vergewissern Sie sich, dass es wirklich dieser Branch ist, den Sie festschreiben möchten. If the head branch is the default branch of your repository, you'll be given the option of creating a new branch to serve as the head branch for your pull request. Wenn der Head-Branch geschützt ist, kannst Du Deine Konflikt-Auflösung nicht zusammenführen, deshalb wirst Du aufgefordert werden, einen neuen Head-Branch zu erstellen. Weitere Informationen findest Du unter „[Informationen zu geschützten Branches](/github/administering-a-repository/about-protected-branches).“ +**Warning:** When you resolve a merge conflict on {% data variables.product.product_name %}, the entire [base branch](/github/getting-started-with-github/github-glossary#base-branch) of your pull request is merged into the [head branch](/github/getting-started-with-github/github-glossary#head-branch). Make sure you really want to commit to this branch. If the head branch is the default branch of your repository, you'll be given the option of creating a new branch to serve as the head branch for your pull request. If the head branch is protected you won't be able to merge your conflict resolution into it, so you'll be prompted to create a new head branch. For more information, see "[About protected branches](/github/administering-a-repository/about-protected-branches)." {% endif %} {% endwarning %} {% data reusables.repositories.sidebar-pr %} -1. Klicke in der Liste der Pull Requests auf den Pull Request mit dem Mergekonflikt, den Du beheben möchtest. -1. Klicke im unteren Teil Deines Pull Requests auf **Resolve conflicts** (Konflikte beheben). ![Schaltfläche „Resolve merge conflicts" (Mergekonflikte beheben)](/assets/images/help/pull_requests/resolve-merge-conflicts-button.png) +1. In the "Pull Requests" list, click the pull request with a merge conflict that you'd like to resolve. +1. Near the bottom of your pull request, click **Resolve conflicts**. +![Resolve merge conflicts button](/assets/images/help/pull_requests/resolve-merge-conflicts-button.png) {% tip %} - **Tipp:** Wenn die Schaltfläche **Resolve conflicts** (Konflikte beheben) deaktiviert ist, ist der Mergekonflikt Deines Pull Requests für eine Behebung auf {% data variables.product.product_name %} zu komplex{% if currentVersion != "free-pro-team@latest" %} oder der Konflikteditor wurde vom Websiteadministrator für Pull Requests zwischen Repositorys deaktiviert{% endif %}. Du musst den Mergekonflikt mit einem alternativen Git-Client auflösen, oder durch Verwendung von Git auf der Befehlszeile. Weitere Informationen findest Du unter „[Mergekonflikt in der Befehlszeile beheben](/articles/resolving-a-merge-conflict-using-the-command-line).“ + **Tip:** If the **Resolve conflicts** button is deactivated, your pull request's merge conflict is too complex to resolve on {% data variables.product.product_name %}{% if currentVersion != "free-pro-team@latest" %} or the site administrator has disabled the conflict editor for pull requests between repositories{% endif %}. You must resolve the merge conflict using an alternative Git client, or by using Git on the command line. For more information see "[Resolving a merge conflict using the command line](/articles/resolving-a-merge-conflict-using-the-command-line)." {% endtip %} {% data reusables.pull_requests.decide-how-to-resolve-competing-line-change-merge-conflict %} - ![Beispiel für die Anzeige eines Mergekonflikts mit Konflikthinweisen](/assets/images/help/pull_requests/view-merge-conflict-with-markers.png) -1. Wenn Deine Datei mehrere Mergekonflikte enthält, scrolle nach unten zum nächsten Konflikthinweis, und wiederhole dort die Schritte 4 und 5, um auch diesen Mergekonflikt zu beheben. -1. Wenn Du alle Konflikte in der Datei behoben hast, klicke auf **Mark as resolved** (Als behoben markieren). ![Klicke die Schaltfläche „Mark as resolved“ (Als behoben markieren)](/assets/images/help/pull_requests/mark-as-resolved-button.png) -1. Wenn mehrere Dateien Konflikte enthalten, wähle auf der linken Seite unter „Conflicting files“ (Dateien mit Konflikten) die nächste Datei aus, und wiederhole die Schritte 4 bis 7, bis Du alle Mergekonflikte Deines Pull Request behoben hast. ![Wähle die nächste Datei mit Konflikten aus, sofern zutreffend](/assets/images/help/pull_requests/resolve-merge-conflict-select-conflicting-file.png) -1. Wenn alle Mergekonflikte behoben sind, klicke auf **Commit merge** (Merge freigeben). Dadurch wird der gesamte Basis-Branch in Deinen Head-Branch zusammengeführt. ![Resolve merge conflicts button](/assets/images/help/pull_requests/merge-conflict-commit-changes.png){% if currentVersion ver_lt "enterprise-server@2.22" %} -1. Sofern Du eine entsprechende Aufforderung erhältst, überprüfe den Branch, in den der Commit erfolgt. Wenn Du den Commit in diesen Branch durchführen möchtest, klicke auf **I understand, update _BRANCH_** (Ich habe verstanden und möchte *BRANCH* aktualisieren). ![Bestätigungsfenster zum Beheben von Mergekonflikten](/assets/images/help/pull_requests/merge-conflict-confirmation.png){% else %} -1. Sofern Du eine entsprechende Aufforderung erhältst, überprüfe den Branch, in den der Commit erfolgt. - - Wenn der Head-Branch der Standardbranch Deines Repositorys ist, kannst Du wählen, entweder diesen Branch mit den Änderungen zu aktualisieren, die Du zur Auflösung des Konfliktes gemacht hast, oder einen neuen Branch zu erstellen und diesen als Head-Branch des Pull Requests zu verwenden. ![Aufforderung zum Überprüfen des Branch, der aktualisiert wird](/assets/images/help/pull_requests/conflict-resolution-merge-dialog-box.png) - - Wenn Du Dich für einen neuen Branch entscheidest, gib den Namen für den Branch ein. - - Wenn der Head-Branch Deines Pull-Requests geschützt ist, musst Du einen neuen Branch erstellen. Du hast keine Möglichkeit, den geschützten Branch zu aktualisieren. - - Klicke auf **Create branch and update my pull request** (Erstelle den Branch und aktualisiere meinen Pull Request) oder **I understand, continue updating _BRANCH_** (Ich verstehe, bitte mit der Aktualisierung des BRANCH fortfahren). Der Text der Schaltfläche entspricht der Aktion, die Du durchführst. + ![View merge conflict example with conflict markers](/assets/images/help/pull_requests/view-merge-conflict-with-markers.png) +1. If you have more than one merge conflict in your file, scroll down to the next set of conflict markers and repeat steps four and five to resolve your merge conflict. +1. Once you've resolved all the conflicts in the file, click **Mark as resolved**. + ![Click mark as resolved button](/assets/images/help/pull_requests/mark-as-resolved-button.png) +1. If you have more than one file with a conflict, select the next file you want to edit on the left side of the page under "conflicting files" and repeat steps four through seven until you've resolved all of your pull request's merge conflicts. + ![Select next conflicting file if applicable](/assets/images/help/pull_requests/resolve-merge-conflict-select-conflicting-file.png) +1. Once you've resolved all your merge conflicts, click **Commit merge**. This merges the entire base branch into your head branch. + ![Resolve merge conflicts button](/assets/images/help/pull_requests/merge-conflict-commit-changes.png){% if currentVersion ver_lt "enterprise-server@2.22" %} +1. If prompted, review the branch that you are committing to. If you want to commit to this branch, click **I understand, update _BRANCH_**. +![Merge conflict confirmation window](/assets/images/help/pull_requests/merge-conflict-confirmation.png){% else %} +1. If prompted, review the branch that you are committing to. + + If the head branch is the default branch of the repository, you can choose either to update this branch with the changes you made to resolve the conflict, or to create a new branch and use this as the head branch of the pull request. + ![Prompt to review the branch that will be updated](/assets/images/help/pull_requests/conflict-resolution-merge-dialog-box.png) + + If you choose to create a new branch, enter a name for the branch. + + If the head branch of your pull request is protected you must create a new branch. You won't get the option to update the protected branch. + + Click **Create branch and update my pull request** or **I understand, continue updating _BRANCH_**. The button text corresponds to the action you are performing. {% endif %} -1. Zum Zusammenführen Deines Pull Requests klicke auf **Merge pull request** (Pull Request zusammenführen). Weitere Informationen finden Sie unter „[Pull Request mergen](/articles/merging-a-pull-request/)“. +1. To merge your pull request, click **Merge pull request**. For more information about other pull request merge options, see "[Merging a pull request](/articles/merging-a-pull-request/)." -### Weiterführende Informationen +### Further reading -- „[Informationen zum Mergen von Pull Requests](/articles/about-pull-request-merges)“ +- "[About pull request merges](/articles/about-pull-request-merges)" diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-using-the-command-line.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-using-the-command-line.md index d31fbb1c9ed1..407c93b7dcae 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-using-the-command-line.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-using-the-command-line.md @@ -67,11 +67,11 @@ ask your question in IRC. $ git commit -m "Resolved merge conflict by incorporating both suggestions." ``` -Du kannst die Branches nun in der Befehlszeile zusammenführen oder [die Änderungen mittels Push an Dein Remote-Repository auf {% data variables.product.product_name %} übertragen](/articles/pushing-commits-to-a-remote-repository/) und [Deine Änderungen mit einem Pull Request zusammenführen](/articles/merging-a-pull-request/). +Sie können die Branches nun in der Befehlszeile mergen oder [die Änderungen mittels Push an Ihr Remote-Repository auf {% data variables.product.product_name %} übertragen](/articles/pushing-commits-to-a-remote-repository/) und [Ihre Änderungen mit einem Pull Request mergen](/articles/merging-a-pull-request/). ### Mergekonflikte durch das Entfernen einer Datei -Zur Behebung eines Mergekonflikts, der entsteht, wenn eine Person eine Datei in einem Branch löscht und eine andere Person die gleiche Datei in einem anderen Branch bearbeitet, musst Du entscheiden, ob die Datei in einem neuen Commit gelöscht oder beibehalten werden soll. +Zur Behebung eines Mergekonflikts, der entsteht, wenn eine Person eine Datei in einem Branch löscht und eine andere Person die gleiche Datei in einem anderen Branch bearbeitet, müssen Sie entscheiden, ob die Datei in einem neuen Commit gelöscht oder beibehalten werden soll. Ein Beispiel: Du hast eine Datei bearbeitet, beispielsweise die Datei *README.md*, und eine andere Person hat die gleiche Datei in einem anderen Branch des gleichen Git-Repositorys gelöscht. Beim Zusammenführen beider Branches erhältst Du einen Mergekonflikt. Diesen Mergekonflikt musst Du durch einen neuen Commit beheben, um die beiden Branches zusammenführen zu können. @@ -83,8 +83,8 @@ Ein Beispiel: Du hast eine Datei bearbeitet, beispielsweise die Datei *README.md 2. Generiere eine Liste der Dateien, die von diesem Mergekonflikt betroffen sind. In diesem Beispiel enthält die Datei *README.md* einen Mergekonflikt. ```shell $ git status - > # On branch master - > # Your branch and 'origin/master' have diverged, + > # On branch main + > # Your branch and 'origin/main' have diverged, > # and have 1 and 2 different commits each, respectively. > # (use "git pull" to merge the remote branch into yours) > # You have unmerged paths. @@ -116,7 +116,7 @@ Ein Beispiel: Du hast eine Datei bearbeitet, beispielsweise die Datei *README.md > [branch-d 6f89e49] Merge branch 'branch-c' into branch-d ``` -Du kannst die Branches nun in der Befehlszeile zusammenführen oder [die Änderungen mittels Push an Dein Remote-Repository auf {% data variables.product.product_name %} übertragen](/articles/pushing-commits-to-a-remote-repository/) und [Deine Änderungen mit einem Pull Request zusammenführen](/articles/merging-a-pull-request/). +Sie können die Branches nun in der Befehlszeile mergen oder [die Änderungen mittels Push an Ihr Remote-Repository auf {% data variables.product.product_name %} übertragen](/articles/pushing-commits-to-a-remote-repository/) und [Ihre Änderungen mit einem Pull Request mergen](/articles/merging-a-pull-request/). ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/reverting-a-pull-request.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/reverting-a-pull-request.md index e400420dcebe..6902011d8164 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/reverting-a-pull-request.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/reverting-a-pull-request.md @@ -1,6 +1,6 @@ --- title: Pull Request rückgängig machen -intro: 'Du kannst einen Pull Request rückgängig machen, der in den vorgelagerten Branch zusammengeführt wurde.' +intro: Du kannst einen Pull Request rückgängig machen, der in den vorgelagerten Branch zusammengeführt wurde. redirect_from: - /articles/reverting-a-pull-request versions: diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/reviewing-changes-in-pull-requests.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/reviewing-changes-in-pull-requests.md index e455d8824ef8..203f969928f8 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/reviewing-changes-in-pull-requests.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/reviewing-changes-in-pull-requests.md @@ -3,7 +3,7 @@ title: Änderungen in Pull Requests überprüfen redirect_from: - /articles/reviewing-and-discussing-changes-in-pull-requests/ - /articles/reviewing-changes-in-pull-requests -intro: Nach dem Öffnen eines Pull Requests kannst Du die darin vorgeschlagenen Änderungen überprüfen und diskutieren. +intro: 'Nach dem Öffnen eines Pull Requests kannst Du die darin vorgeschlagenen Änderungen überprüfen und diskutieren.' mapTopic: true versions: free-pro-team: '*' diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md index 85fb6527a577..20d647d0473c 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md @@ -10,7 +10,7 @@ versions: ### Informationen zum Review von Pull Requests -Du kannst die Änderungen in einem Pull Request eine Datei nach der anderen überprüfen. Während des Reviews der Dateien eines Pull Requests kannst Du einzelne Änderungen kommentieren.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} Wenn Du den Review einer Datei abgeschlossen hast, kannst Du die Datei als „gesehen“ markieren. Dadurch wird die Datei ausgeblendet, so dass Du die noch nicht geprüften Dateien leichter findest. In einer Fortschrittsanzeige im Header des Pull Requests wird die Anzahl der gesehenen Dateien angezeigt.{% endif %} Nachdem Du alle oder einzelne Dateien überprüft hast, kannst Du den Pull Request genehmigen oder durch Absenden Deines Reviews mit einem zusammenfassenden Kommentar weitere Änderungen anfordern. +Du kannst die Änderungen in einem Pull Request eine Datei nach der anderen überprüfen. While reviewing the files in a pull request, you can leave individual comments on specific changes. After you finish reviewing each file, you can mark the file as viewed. Dadurch wird die Datei ausgeblendet, so dass Du die noch nicht geprüften Dateien leichter findest. A progress bar in the pull request header shows the number of files you've viewed. After reviewing as many files as you want, you can approve the pull request or request additional changes by submitting your review with a summary comment. {% data reusables.search.requested_reviews_search_tip %} @@ -28,18 +28,16 @@ Vor dem Absenden Deines Reviews haben Deine Zeilenkommentare den Status _Aussteh ![Schaltfläche „Cancel review“ (Review abbrechen)](/assets/images/help/pull_requests/cancel-review-button.png) -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} ### Datei als „gesehen“ markieren -Wenn Du den Review einer Datei abgeschlossen hast, kannst Du sie als „gesehen“ markieren, um sie auszublenden. Falls die Datei nach Deiner Überprüfung geändert wird, wird die Markierung aufgehoben. +Wenn Sie den Review einer Datei abgeschlossen haben, können Sie sie als „gesehen“ markieren, um sie auszublenden. Falls die Datei nach Ihrer Überprüfung geändert wird, wird die Markierung aufgehoben und die Datei wird wieder eingeblendet. {% data reusables.repositories.changed-files %} 2. Aktiviere rechts neben dem Header der überprüften Datei das Kontrollkästchen **Viewed** (Gesehen). ![Kontrollkästchen „Viewed“ (Gesehen)](/assets/images/help/pull_requests/viewed-checkbox.png) -{% endif %} ### Review absenden -Wenn Du den Review aller von Dir im Pull Request einzuschließenden Dateien abgeschlossen hast, sende den Review ab. +Wenn Sie den Review der Dateien des Pull Requesta abgeschlossen haben, senden Sie den Review ab. {% data reusables.repositories.changed-files %} {% data reusables.repositories.review-changes %} diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/syncing-a-fork.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/syncing-a-fork.md index 749f23c8dac1..90f5febcc589 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/syncing-a-fork.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/syncing-a-fork.md @@ -1,6 +1,6 @@ --- title: Fork synchronisieren -intro: 'Synchronisiere den Fork eines Repositorys, um ihn auf dem aktuellen Stand mit dem vorgelagerten Repository zu halten.' +intro: Synchronisiere den Fork eines Repositorys, um ihn auf dem aktuellen Stand mit dem vorgelagerten Repository zu halten. redirect_from: - /articles/syncing-a-fork versions: @@ -48,6 +48,6 @@ Bevor Du einen Fork mit dem ihm vorgelagerten Repository synchronisieren kannst, {% tip %} -**Tipp**: Das Synchronisieren Deiner Fork wird nur die lokale Kopie Deines Repositorys aktualisiert. Für eine Aktualisierung Deiner Fork auf {% data variables.product.product_location %} musst Du [Deine Änderungen per Push übertragen](/articles/pushing-commits-to-a-remote-repository/). +**Tipp**: Das Synchronisieren Deiner Fork wird nur die lokale Kopie Deines Repositorys aktualisiert. Für eine Aktualisierung Ihres Forks auf {% data variables.product.product_location %} müssen Sie [Ihre Änderungen per Push übertragen](/articles/pushing-commits-to-a-remote-repository/). {% endtip %} diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility.md index 2e603ec6b984..844e403d8d82 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility.md @@ -1,6 +1,6 @@ --- -title: 'Was geschieht mit Forks, wenn ein Repository gelöscht wird oder sich dessen Sichtbarkeit ändert?' -intro: 'Wenn Du Dein Repository löschst oder dessen Sichtbarkeit änderst, wirkt sich dies auf die Forks dieses Repositorys aus.' +title: Was geschieht mit Forks, wenn ein Repository gelöscht wird oder sich dessen Sichtbarkeit ändert? +intro: Wenn Du Dein Repository löschst oder dessen Sichtbarkeit änderst, wirkt sich dies auf die Forks dieses Repositorys aus. redirect_from: - /articles/changing-the-visibility-of-a-network/ - /articles/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/working-with-pre-receive-hooks.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/working-with-pre-receive-hooks.md index 93111cb38cda..409373a00a57 100644 --- a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/working-with-pre-receive-hooks.md +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/working-with-pre-receive-hooks.md @@ -21,10 +21,10 @@ Total 3 (delta 0), reused 0 (delta 0) remote: always_reject.sh: failed with exit status 1 remote: error: rejecting all pushes To https://54.204.174.51/hodor/nope.git - ! [remote rejected] master -> master (pre-receive hook declined) + ! [remote rejected] main -> main (pre-receive hook declined) error: failed to push some refs to 'https://54.204.174.51/hodor/nope.git' ``` ![Fehlermeldung für fehlgeschlagenen Pre-Receive-Hook](/assets/images/help/pull_requests/pre-receive-hook-failed-error.png) -Dein {% data variables.product.product_name %}-Websiteadministrator kann Pre-Receive-Hooks für Deine Organisation oder für Dein Repository erstellen und entfernen. Zudem kann er Organisations- oder Repository-Administratoren erlauben, Pre-Receive-Hooks zu aktivieren oder zu deaktivieren. Weitere Informationen findest Du unter „[Pre-Receive-Hooks zum Erzwingen der Richtlinie verwenden](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/using-pre-receive-hooks-to-enforce-policy).“ +Ihr {% data variables.product.product_name %}-Websiteadministrator kann Pre-Receive-Hooks für Ihre Organisation oder für Ihr Repository erstellen und entfernen. Zudem kann er Organisations- oder Repository-Administratoren erlauben, Pre-Receive-Hooks zu aktivieren oder zu deaktivieren. Weitere Informationen findest Du unter „[Pre-Receive-Hooks zum Erzwingen der Richtlinie verwenden](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/using-pre-receive-hooks-to-enforce-policy).“ diff --git a/translations/de-DE/content/github/committing-changes-to-your-project/changing-a-commit-message.md b/translations/de-DE/content/github/committing-changes-to-your-project/changing-a-commit-message.md index e6291f252917..802836e8eb05 100644 --- a/translations/de-DE/content/github/committing-changes-to-your-project/changing-a-commit-message.md +++ b/translations/de-DE/content/github/committing-changes-to-your-project/changing-a-commit-message.md @@ -3,7 +3,7 @@ title: Eine Commit-Mitteilung ändern redirect_from: - /articles/can-i-delete-a-commit-message/ - /articles/changing-a-commit-message -intro: 'Wenn eine Commit-Mitteilung unklare, falsche oder vertrauliche Informationen enthält, kannst Du sie lokal ändern und einen neuen Commit mit einer neuen Mitteilung zu {% data variables.product.product_name %} übertragen. Du kannst auch fehlende Informationen zu einer Commit-Mitteilung hinzufügen.' +intro: 'Wenn eine Commit-Mitteilung unklare, falsche oder vertrauliche Informationen enthält, können Sie sie lokal ändern und einen neuen Commit mit einer neuen Mitteilung zu {% data variables.product.product_name %} pushen. Du kannst auch fehlende Informationen zu einer Commit-Mitteilung hinzufügen.' versions: free-pro-team: '*' enterprise-server: '*' @@ -13,15 +13,11 @@ versions: Die letzte Commit-Mitteilung kannst Du mit dem Befehl `git commit --amend` ändern. -{% warning %} - In Git ist der Text der Commit-Mitteilung Teil des Commits. Durch das Ändern der Commit-Mitteilung ändert sich auch die Commit-ID, also die SHA1-Prüfsumme, die den Commit benennt. Effektiv erstellst Du einen neuen Commit, der den alten ersetzt. -{% endwarning %} - -#### Commit wurde nicht online veröffentlicht +### Commit wurde nicht online veröffentlicht -Wenn der Commit nur in Deinem lokalen Repository vorhanden ist und nicht zu {% data variables.product.product_location %} übertragen wurde, kannst Du die Commit-Mitteilung mit dem Befehl `git comimt --amend` ändern. +Wenn der Commit nur in Ihrem lokalen Repository vorhanden ist und nicht zu {% data variables.product.product_location %} gepusht wurde, können Sie die Commit-Mitteilung mit dem Befehl `git comimt --amend` ändern. 1. Navigiere in der Befehlszeile zu dem Repository, das den Commit enthält, den Du ändern möchtest. 2. Gib `git commit --amend` ein, und drücke die **Eingabetaste**. @@ -39,9 +35,9 @@ Du kannst den standardmäßigen Texteditor für Git ändern, indem Du die Einste {% endtip %} -#### Ältere oder mehrere Commit-Mitteilungen ändern +### Ältere oder mehrere Commit-Mitteilungen ändern -Wenn Du den Commit bereits zu {% data variables.product.product_location %} übertragen hast, musst Du den Push eines Commits mit einer geänderten Mitteilung erzwingen. +Wenn Sie den Commit bereits zu {% data variables.product.product_location %} gepusht haben, müssen Sie den Push des Commits mit einer geänderten Mitteilung erzwingen. {% warning %} @@ -49,7 +45,7 @@ Wir raten dringend von einem erzwungenen Push ab, da sich dadurch der Verlauf De {% endwarning %} -**Die Mitteilung des zuletzt übertragenen Commits ändern** +**Changing the message of the most recently pushed commit** 1. Führe die [obigen Schritte](/articles/changing-a-commit-message#commit-has-not-been-pushed-online) aus, um die Commit-Mitteilung zu ändern. 2. Erzwinge mit dem Befehl `push --force` den Push über den alten Commit hinweg. @@ -57,7 +53,7 @@ Wir raten dringend von einem erzwungenen Push ab, da sich dadurch der Verlauf De $ git push --force example-branch ``` -**Die Mitteilung älterer oder mehrerer Commit-Mitteilungen ändern** +**Changing the message of older or multiple commit messages** Wenn Du die Mitteilungen für mehrere Commits oder für ältere Commits ändern musst, kannst Du den interaktive Rebase nutzen und anschließend den Push zum Ändern des Commit-Verlaufs erzwingen. @@ -93,7 +89,6 @@ Wenn Du die Mitteilungen für mehrere Commits oder für ältere Commits ändern # # Note that empty commits are commented out ``` - 3. Ersetze vor jeder Commit-Mitteilung, die Du ändern möchtest, `pick` durch `reword`. ```shell pick e499d89 Delete CNAME @@ -102,10 +97,10 @@ Wenn Du die Mitteilungen für mehrere Commits oder für ältere Commits ändern ``` 4. Speichere und schließe die Datei mit der Commit-Liste. 5. Gib in jeder resultierenden Commit-Datei die neue Commit-Mitteilung ein, speichere die Datei, und schließe sie. -6. Erzwinge den Push der geänderten Commits. - ```shell - $ git push --force - ``` +6. When you're ready to push your changes to GitHub, use the push --force command to force push over the old commit. +```shell +$ git push --force example-branch +``` Weitere Informationen zur interaktiven Rebase findest Du unter „[Interaktiver Modus](https://git-scm.com/docs/git-rebase#_interactive_mode)“ im Git-Handbuch. @@ -117,7 +112,7 @@ Auch hier gilt: Das Ändern der Commit-Mitteilung führt zu einem neuen Commit m {% warning %} -Wenn eine Commit-Mitteilung vertrauliche Informationen enthält, wird beim erzwungenen Push eines Commits mit geändertem Commit der ursprüngliche Commit möglicherweise nicht von {% data variables.product.product_name %} entfernt. Der alte Commit wird nicht Teil eines nachfolgenden Klons, kann aber noch auf {% data variables.product.product_name %} zwischengespeichert und über die Commit-ID zugänglich sein. Wende Dich mit der alten Commit-ID an {% data variables.contact.contact_support %}, um ihn vom Remote-Repository löschen zu lassen. +Wenn eine Commit-Mitteilung vertrauliche Informationen enthält, wird beim erzwungenen Push eines Commits mit geändertem Commit der ursprüngliche Commit möglicherweise nicht von {% data variables.product.product_name %} entfernt. Der alte Commit wird nicht Teil eines nachfolgenden Klons, kann aber noch auf {% data variables.product.product_name %} zwischengespeichert und über die Commit-ID zugänglich sein. Wenden Sie sich mit der alten Commit-ID an {% data variables.contact.contact_support %}, um ihn vom Remote-Repository löschen zu lassen. {% endwarning %} diff --git a/translations/de-DE/content/github/committing-changes-to-your-project/commit-branch-and-tag-labels.md b/translations/de-DE/content/github/committing-changes-to-your-project/commit-branch-and-tag-labels.md index 692093ef5706..7c5d1638c7cd 100644 --- a/translations/de-DE/content/github/committing-changes-to-your-project/commit-branch-and-tag-labels.md +++ b/translations/de-DE/content/github/committing-changes-to-your-project/commit-branch-and-tag-labels.md @@ -1,6 +1,6 @@ --- title: Commit-Branch und Tag-Kennzeichnungen -intro: 'Anhand der Kennzeichnungen unter dem Commit auf der Commit-Seite kannst Du leicht erkennen, zu welchem Branch ein Commit gehört.' +intro: Anhand der Kennzeichnungen unter dem Commit auf der Commit-Seite kannst Du leicht erkennen, zu welchem Branch ein Commit gehört. redirect_from: - /articles/commit-branch-and-tag-labels versions: @@ -14,7 +14,7 @@ Wenn sich Dein Commit nicht auf dem Standardbranch befindet, zeigt ein Indikator Sobald sich der Commit auf dem Standardbranch befindet, werden alle Tags angezeigt, die den Commit enthalten, und der Standardbranch wird als einziger Branch aufgeführt. -![Commit-Master-Kennzeichnung](/assets/images/help/commits/Commit-master-label.png) +![Commit-main-label](/assets/images/help/commits/Commit-master-label.png) ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/committing-changes-to-your-project/commit-exists-on-github-but-not-in-my-local-clone.md b/translations/de-DE/content/github/committing-changes-to-your-project/commit-exists-on-github-but-not-in-my-local-clone.md index 55a0b79fe928..0ec1faeab255 100644 --- a/translations/de-DE/content/github/committing-changes-to-your-project/commit-exists-on-github-but-not-in-my-local-clone.md +++ b/translations/de-DE/content/github/committing-changes-to-your-project/commit-exists-on-github-but-not-in-my-local-clone.md @@ -1,5 +1,5 @@ --- -title: 'Commit ist auf GitHub vorhanden, aber nicht in meinem lokalen Klon' +title: Commit ist auf GitHub vorhanden, aber nicht in meinem lokalen Klon intro: 'Manchmal kann ein Commit auf {% data variables.product.product_name %} angezeigt werden, befindet sich aber nicht im lokalen Klon des Repositorys.' redirect_from: - /articles/commit-exists-on-github-but-not-in-my-local-clone @@ -17,7 +17,7 @@ $ git show 1095ff3d0153115e75b7bca2c09e5136845b5592 > fatal: bad object 1095ff3d0153115e75b7bca2c09e5136845b5592 ``` -Wenn Du den Commit jedoch auf {% data variables.product.product_location %} anzeigst, kannst Du ihn ohne Probleme sehen: +Wenn Sie den Commit jedoch auf {% data variables.product.product_location %} anzeigen, können Sie ihn ohne Probleme sehen: `github.com/$account/$repository/commit/1095ff3d0153115e75b7bca2c09e5136845b5592` @@ -47,7 +47,7 @@ Dadurch werden die Informationen vom Remote-Repository sicher auf Deinen lokalen Wenn ein Mitarbeiter des Repositorys den Branch mit dem Commit gelöscht oder einen Push über den Branch erzwungen hat, ist der fehlende Commit möglicherweise verwaist (das heißt, er kann über keine Referenz mehr erreicht aufgerufen werden) und wird daher nicht in Deinen lokalen Klon abgerufen. -Wenn aber irgendein Mitarbeiter noch einen lokalen Klon des Repositorys mit dem fehlenden Commit besitzt, kann er ihn zurück zu {% data variables.product.product_name %} übertragen. Dabei muss er sicherstellen, dass von einem lokalen Branch auf den Commit verwiesen wird, und ihn dann als neuen Branch zu {% data variables.product.product_name %} pushen. +Wenn irgendein Mitarbeiter jedoch einen lokalen Klon des Repositorys mit dem fehlenden Commit besitzt, kann er ihn glücklicherweise zurück zu {% data variables.product.product_name %} pushen. Dabei muss er sicherstellen, dass von einem lokalen Branch auf den Commit verwiesen wird, und ihn dann als neuen Branch zu {% data variables.product.product_name %} pushen. Nehmen wir an, diese Person hat noch einen lokalen Branch (nennen wir ihn `B`), der den Commit enthält. Dieser verfolgt vielleicht den Branch, dessen Push erzwungen oder der gelöscht wurde, und es wurde einfach noch keine Aktualisierung durchgeführt. Um den Commit zu bewahren, kann er diesen lokalen Branch zu einem neuen Branch (nennen wir ihn `recover-B`) auf {% data variables.product.product_name %} pushen. Für dieses Beispiel nehmen wir an, dass die Person ein Remote-Repository namens `upstream` besitzt, über das sie Push-Zugriff auf `github.coom/$account/$repository` hat. diff --git a/translations/de-DE/content/github/committing-changes-to-your-project/comparing-commits.md b/translations/de-DE/content/github/committing-changes-to-your-project/comparing-commits.md index 154ed49f08bf..e45dd5adddce 100644 --- a/translations/de-DE/content/github/committing-changes-to-your-project/comparing-commits.md +++ b/translations/de-DE/content/github/committing-changes-to-your-project/comparing-commits.md @@ -26,9 +26,9 @@ Hier siehst Du ein Beispiel für einen [Vergleich zwischen zwei Branches](https: ### Tags vergleichen -Ein Vergleich der Release-Tags zeigt Dir die Änderungen an Deinem Repository seit dem letzten Release. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}Weitere Informationen findest Du unter „[Releases vergleichen](/github/administering-a-repository/comparing-releases)."{% endif %} +Ein Vergleich der Release-Tags zeigt Dir die Änderungen an Deinem Repository seit dem letzten Release. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} For more information, see "[Comparing releases](/github/administering-a-repository/comparing-releases)."{% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}Um Tags zu vergleichen, kannst Du einen Tagnamen aus dem Dropdownmenü `compare` (vergleichen) oben auf der Seite auswählen.{% else %} Anstatt einen Branchnamen einzugeben, gib den Namen Deines Tags im Dropdownmenü `compare` (vergleichen) ein.{% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}To compare tags, you can select a tag name from the `compare` drop-down menu at the top of the page.{% else %} Instead of typing a branch name, type the name of your tag in the `compare` drop down menu.{% endif %} Hier siehst Du ein Beispiel für einen [Vergleich zwischen zwei Tags](https://github.com/octocat/linguist/compare/v2.2.0...octocat:v2.3.3). diff --git a/translations/de-DE/content/github/committing-changes-to-your-project/creating-a-commit-on-behalf-of-an-organization.md b/translations/de-DE/content/github/committing-changes-to-your-project/creating-a-commit-on-behalf-of-an-organization.md index 2a9192cdcb04..46a73a0c89b8 100644 --- a/translations/de-DE/content/github/committing-changes-to-your-project/creating-a-commit-on-behalf-of-an-organization.md +++ b/translations/de-DE/content/github/committing-changes-to-your-project/creating-a-commit-on-behalf-of-an-organization.md @@ -41,7 +41,7 @@ Beim nächsten Push wird der neue Commit samt Mitteilung und Badge auf {% data v ### Commits mit einem `on-behalf-of`-Badge auf {% data variables.product.product_name %} erstellen -Wenn Du mit dem Web-Editor Änderungen an einer Datei auf {% data variables.product.product_name %} vorgenommen hast, kannst Du einen Commit im Namen Deiner Organisation erstellen, indem Du den Trailer `on-behalf-of:` zur Commit-Mitteilung hinzufügst. +Wenn Sie mit dem Web-Editor Änderungen an einer Datei auf {% data variables.product.product_name %} vorgenommen haben, können Sie einen Commit im Namen Ihrer Organisation erstellen, indem Sie den Trailer `on-behalf-of:` zur Commit-Mitteilung hinzufügen. 1. Nachdem Du Deine Änderungen gemacht hast, gib unten auf der Seite eine kurze, aussagekräftige Commit-Mitteilung ein, die die von Dir gemachten Änderungen beschreibt. ![Commit-Mitteilung für Deine Änderung](/assets/images/help/repository/write-commit-message-quick-pull.png) diff --git a/translations/de-DE/content/github/committing-changes-to-your-project/creating-a-commit-with-multiple-authors.md b/translations/de-DE/content/github/committing-changes-to-your-project/creating-a-commit-with-multiple-authors.md index 232158050981..079e81663f51 100644 --- a/translations/de-DE/content/github/committing-changes-to-your-project/creating-a-commit-with-multiple-authors.md +++ b/translations/de-DE/content/github/committing-changes-to-your-project/creating-a-commit-with-multiple-authors.md @@ -1,6 +1,6 @@ --- -title: Einen Commit mit mehreren Autoren erstellen -intro: 'Du kannst einen Commit mehreren Autoren zuordnen, indem Du einen oder mehrere `Co-authored-by`-Trailer zur Commit-Mitteilung hinzufügst. Commits mit Co-Autor sind auf {% data variables.product.product_name %} sichtbar{% if currentVersion != "free-pro-team@latest" %} und können in das Beteiligungsdiagramm des Profils sowie in die Statistik des Repositorys aufgenommen werden{% endif %}.' +title: Creating a commit with multiple authors +intro: 'You can attribute a commit to more than one author by adding one or more `Co-authored-by` trailers to the commit''s message. Co-authored commits are visible on {% data variables.product.product_name %}{% if currentVersion != "free-pro-team@latest" %} and can be included in the profile contributions graph and the repository''s statistics{% endif %}.' redirect_from: - /articles/creating-a-commit-with-multiple-authors versions: @@ -8,41 +8,41 @@ versions: enterprise-server: '*' --- -### Erforderliche Co-Autor-Informationen +### Required co-author information -Bevor Du einen Co-Autor zu einem Commit hinzufügen kannst, musst Du die richtige E-Mail-Adresse für jeden Co-Autor kennen. Damit der Commit des Co-Autors als Beitrag zählt, musst Du die E-Mail-Adresse verwenden, die mit seinem {% data variables.product.product_name %}-Konto verknüpft ist. +Before you can add a co-author to a commit, you must know the appropriate email to use for each co-author. For the co-author's commit to count as a contribution, you must use the email associated with their {% data variables.product.product_name %} account. {% if currentVersion == "free-pro-team@latest" %} -Wenn ein Co-Autor seine E-Mail-Adresse als privat festgelegt hat, musst Du die von {% data variables.product.product_name %} bereitgestellte `no-reply`-E-Mail-Adresse verwenden, um die Daten des Co-Autors zu schützen. Andernfalls ist die E-Mail-Adresse des Co-Autors in der Commit-Mitteilung öffentlich einsehbar. Wenn Du Deine E-Mail-Adresse privat halten möchtest, kannst Du die von {% data variables.product.product_name %} bereitgestellte `no-reply`-E-Mail-Adresse für Git-Vorgänge verwenden und andere Co-Autoren bitten, Deine `no-reply`-Adresse in Commit-Trailern zu verwenden. +If a person chooses to keep their email address private, you should use their {% data variables.product.product_name %}-provided `no-reply` email to protect their privacy. Otherwise, the co-author's email will be available to the public in the commit message. If you want to keep your email private, you can choose to use a {% data variables.product.product_name %}-provided `no-reply` email for Git operations and ask other co-authors to list your `no-reply` email in commit trailers. -Weitere Informationen findest Du unter „[Deine Commit-E-Mail-Adresse festlegen](/articles/setting-your-commit-email-address).“ +For more information, see "[Setting your commit email address](/articles/setting-your-commit-email-address)." {% tip %} - **Tipp:** Um Co-Autoren dabei zu helfen, die bevorzugte E-Mail-Adresse zu finden, gib die folgenden Informationen weiter: - - Die von {% data variables.product.product_name %} bereitgestellte `no-reply`-E-Mail-Adresse findest Du auf der Seite mit Deinen E-Mail-Einstellungen unter „Keep my email address private“ (E-Mail-Adresse privat halten). - - Um die E-Mail-Adresse zu ermitteln, die Du bei der Git-Konfiguration auf Deinem Computer verwendet hast, führe in der Befehlszeile `git config user.email` aus. + **Tip:** You can help a co-author find their preferred email address by sharing this information: + - To find your {% data variables.product.product_name %}-provided `no-reply` email, navigate to your email settings page under "Keep my email address private." + - To find the email you used to configure Git on your computer, run `git config user.email` on the command line. {% endtip %} {% endif %} -### Commits mit Co-Autor mit {% data variables.product.prodname_desktop %} erstellen +### Creating co-authored commits using {% data variables.product.prodname_desktop %} -Du kannst mit {% data variables.product.prodname_desktop %} einen Commit mit einem Co-Autor erstellen. Weitere Informationen findest Du unter „[Commit-Mitteilung schreiben und Deine Änderungen via Push übertragen](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project#3-write-a-commit-message-and-push-your-changes)“ und „[{% data variables.product.prodname_desktop %}](https://desktop.github.com)“. +You can use {% data variables.product.prodname_desktop %} to create a commit with a co-author. For more information, see "[Write a commit message and push your changes](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project#3-write-a-commit-message-and-push-your-changes)" and [{% data variables.product.prodname_desktop %}](https://desktop.github.com). -![Einen Co-Autor zur Commit-Mitteilung hinzufügen](/assets/images/help/desktop/co-authors-demo-hq.gif) +![Add a co-author to the commit message](/assets/images/help/desktop/co-authors-demo-hq.gif) -### Commits mit Co-Autor in der Befehlszeile erstellen +### Creating co-authored commits on the command line {% data reusables.pull_requests.collect-co-author-commit-git-config-info %} {% data reusables.pull_requests.commit-message-with-trailer-beginning %} -3. Gib in der nächsten Zeile der Commit-Mitteilung `Co-authored-by: name ` mit spezifischen Informationen zu jedem Co-Autor ein. Füge nach den Angaben zu den Co-Autoren ein abschließendes Anführungszeichen ein. +3. On the next line of the commit message, type `Co-authored-by: name ` with specific information for each co-author. After the co-author information, add a closing quotation mark. - Wenn Sie mehrere Co-Autoren hinzufügen, fügen Sie für jeden Co-Autor eine eigene Zeile und einen eigenen `Co-authored-by:`-Commit-Trailer hinzu. + If you're adding multiple co-authors, give each co-author their own line and `Co-authored-by:` commit trailer. ```shell $ git commit -m "Refactor usability tests. > @@ -51,26 +51,27 @@ Du kannst mit {% data variables.product.prodname_desktop %} einen Commit mit ein Co-authored-by: another-name <another-name@example.com>" ``` -Der neue Commit und die neue Commit-Mitteilung werden beim nächsten Push auf {% data variables.product.product_location %} angezeigt. Weitere Informationen findest Du unter „[Änderungen zu einem Remote-Repository übertragen](/articles/pushing-commits-to-a-remote-repository/).“ +The new commit and message will appear on {% data variables.product.product_location %} the next time you push. For more information, see "[Pushing changes to a remote repository](/articles/pushing-commits-to-a-remote-repository/)." -### Commits mit Co-Autor auf {% data variables.product.product_name %} erstellen +### Creating co-authored commits on {% data variables.product.product_name %} -Wenn Du mit dem Web-Editor Änderungen an einer Datei auf {% data variables.product.product_name %} vorgenommen hast, kannst Du einen Commit mit Co-Autor erstellen, indem Du den Trailer `Co-authored-by:` zur Commit-Mitteilung hinzufügst. +After you've made changes in a file using the web editor on {% data variables.product.product_name %}, you can create a co-authored commit by adding a `Co-authored-by:` trailer to the commit's message. {% data reusables.pull_requests.collect-co-author-commit-git-config-info %} -2. Nachdem Du alle Deine Änderungen vorgenommen hast, gib unten auf der Seite eine kurze, aussagekräftige Commit-Mitteilung ein, die die von Dir gemachten Änderungen beschreibt. ![Commit-Mitteilung für Deine Änderung](/assets/images/help/repository/write-commit-message-quick-pull.png) -3. Füge im Textfeld unter Deiner Commit-Mitteilung `Co-authored-by: name ` mit spezifischen Informationen für jeden Co-Autor ein. Wenn Sie mehrere Co-Autoren hinzufügen, fügen Sie für jeden Co-Autor eine eigene Zeile und einen eigenen `Co-authored-by:`-Commit-Trailer hinzu. +2. After making your changes together, at the bottom of the page, type a short, meaningful commit message that describes the changes you made. + ![Commit message for your change](/assets/images/help/repository/write-commit-message-quick-pull.png) +3. In the text box below your commit message, add `Co-authored-by: name ` with specific information for each co-author. If you're adding multiple co-authors, give each co-author their own line and `Co-authored-by:` commit trailer. - ![Beispiel für Co-Autor-Trailer in Commit-Mitteilung im Textfeld der zweiten Commit-Mitteilung](/assets/images/help/repository/write-commit-message-co-author-trailer.png) -4. Klicken Sie auf **Commit changes** (Änderungen committen) oder **Propose changes** (Änderungen vorschlagen). + ![Commit message co-author trailer example in second commit message text box](/assets/images/help/repository/write-commit-message-co-author-trailer.png) +4. Click **Commit changes** or **Propose changes**. -Der neue Commit samt Mitteilung wird auf {% data variables.product.product_location %} angezeigt. +The new commit and message will appear on {% data variables.product.product_location %}. -### Weiterführende Informationen +### Further reading {% if currentVersion != "free-pro-team@latest" %} -- „"[Beiträge auf Deinem Profil anzeigen](/articles/viewing-contributions-on-your-profile)“ -- „[Warum werden meine Beiträge nicht in meinem Profil angezeigt?](/articles/why-are-my-contributions-not-showing-up-on-my-profile)“{% endif %} -- „[Eine Zusammenfassung der Repository-Aktivitäten anzeigen](/articles/viewing-a-summary-of-repository-activity)“ -- „[Die Mitarbeiter eines Projekts anzeigen](/articles/viewing-a-projects-contributors)“ -- „[Eine Commit-Mitteilung ändern](/articles/changing-a-commit-message)“ -- „[Änderungen an Deinem Projekt freigeben und überprüfen](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project#3-write-a-commit-message-and-push-your-changes)“ in der {% data variables.product.prodname_desktop %}-Dokumentation +- "[Viewing contributions on your profile](/articles/viewing-contributions-on-your-profile)" +- "[Why are my contributions not showing up on my profile?](/articles/why-are-my-contributions-not-showing-up-on-my-profile)"{% endif %} +- "[Viewing a summary of repository activity](/articles/viewing-a-summary-of-repository-activity)" +- "[Viewing a project's contributors](/articles/viewing-a-projects-contributors)" +- "[Changing a commit message](/articles/changing-a-commit-message)" +- "[Committing and reviewing changes to your project](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project#3-write-a-commit-message-and-push-your-changes)" in the {% data variables.product.prodname_desktop %} documentation diff --git a/translations/de-DE/content/github/committing-changes-to-your-project/differences-between-commit-views.md b/translations/de-DE/content/github/committing-changes-to-your-project/differences-between-commit-views.md index e202ddbd79ef..68960833f1b9 100644 --- a/translations/de-DE/content/github/committing-changes-to-your-project/differences-between-commit-views.md +++ b/translations/de-DE/content/github/committing-changes-to-your-project/differences-between-commit-views.md @@ -7,7 +7,7 @@ versions: enterprise-server: '*' --- -Auf {% data variables.product.product_name %} kannst Du den Commit-Verlauf eines Repositorys anzeigen, indem Du: +Auf {% data variables.product.product_name %} können Sie den Commit-Verlauf eines Repositorys anzeigen, indem Sie - Direkt zur [Commit-Seite](https://github.com/mozilla/rust/commits/master) eines Repositorys nagivierst - Auf eine Datei und dann auf **History** (Verlauf) klickst, um zum [Commit-Verlauf für eine bestimmte Datei ](https://github.com/mozilla/rust/commits/master/README.md) zu gelangen @@ -18,7 +18,7 @@ Bei Git gibt es mehrere Möglichkeiten, den Verlauf eines Repositorys anzuzeigen Für den Commit-Verlauf einer Datei nutzt {% data variables.product.product_name %} explizit diese einfache Strategie. So wird der Verlauf vereinfacht, indem Commits, die sich nicht auf das endgültige Ergebnis ausgewirkt haben, weggelassen werden. Wenn beispielsweise ein Nebenbranch eine Änderung vorgenommen und sie dann rückgängig gemacht hat, wird dieser Commit nicht im Branch-Verlauf aufgeführt. Damit erhöht sich die Effizienz bei Branch-Reviews, da nur Commits angezeigt werden, die sich auf die Datei auswirken. -Diese gekürzte Ansicht enthält möglicherweise nicht immer alle Informationen, die Du benötigst. Wenn Du den gesamten Verlauf einsehen willst, bietet {% data variables.product.product_name %} eine Ansicht mit mehr Informationen auf der Commit-Seite eines Repositorys. +Diese gekürzte Ansicht enthält möglicherweise nicht immer alle Informationen, die Du benötigst. Wenn Sie den gesamten Verlauf einsehen möchten, bietet {% data variables.product.product_name %} eine Ansicht mit weiteren Informationen auf der Commit-Seite eines Repositorys. Weitere Informationen zum Umgang von Git mit Commit-Verläufen findest Du im Abschnitt „[Vereinfachter Verlauf](https://git-scm.com/docs/git-log#_history_simplification)“ im Hilfe-Artikel `git log`. diff --git a/translations/de-DE/content/github/committing-changes-to-your-project/why-are-my-commits-linked-to-the-wrong-user.md b/translations/de-DE/content/github/committing-changes-to-your-project/why-are-my-commits-linked-to-the-wrong-user.md index eed8d1098827..bb7ada1a7c8c 100644 --- a/translations/de-DE/content/github/committing-changes-to-your-project/why-are-my-commits-linked-to-the-wrong-user.md +++ b/translations/de-DE/content/github/committing-changes-to-your-project/why-are-my-commits-linked-to-the-wrong-user.md @@ -18,7 +18,7 @@ versions: ### Mit einem anderen Benutzer verknüpfte Commits -Wenn Deine Commits mit einem anderen Benutzer verknüpft sind, bedeutet dies, dass der Benutzer seinem {% data variables.product.product_name %}-Konto die in Deinen Einstellungen für die lokale Git-Konfiguration hinterlegte E-Mail-Adresse hinzugefügt hat. In diesem Fall kannst Du die E-Mail-Adresse in den Einstellungen für Deine lokale Git-Konfiguration ändern und Deinem {% data variables.product.product_name %}-Konto die neue E-Mail-Adresse hinzufügen, damit künftige Commits mit Deinem Konto verknüpft werden. +Wenn Ihre Commits mit einem anderen Benutzer verknüpft sind, bedeutet dies, dass der Benutzer seinem {% data variables.product.product_name %}-Konto die in Ihren Einstellungen für die lokale Git-Konfiguration hinterlegte E-Mail-Adresse hinzugefügt hat. In diesem Fall können Sie die E-Mail-Adresse in den Einstellungen für Ihre lokale Git-Konfiguration ändern und Ihrem {% data variables.product.product_name %}-Konto die neue E-Mail-Adresse hinzufügen, damit künftige Commits mit Ihrem Konto verknüpft werden. 1. Führe die unter „[E-Mail-Adresse für Commits in Git festlegen](/articles/setting-your-commit-email-address)“ beschrieben Schritte aus, um die E-Mail-Adresse in Deiner lokalen Git-Konfiguration zu ändern. Falls Du mehrere Maschinen verwendest, musst Du diese Einstellung auf jeder ändern. 2. Füge Deinen Kontoeinstellungen die E-Mail-Adresse aus Schritt 2 hinzu. Führe dazu die unter „[Eine E-Mail-Adresse zum GitHub-Konto hinzufügen](/articles/adding-an-email-address-to-your-github-account)“ beschriebenen Schritte durch. diff --git a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github.md b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github.md index ca1573a2398b..0e049e870576 100644 --- a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github.md +++ b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github.md @@ -1,6 +1,6 @@ --- title: Informationen zur Archivierung von Inhalten und Daten auf GitHub -intro: 'Du kannst Inhalte und Daten auf {% data variables.product.product_name %} archivieren, damit andere Personen sie ansehen und darauf verweisen können.' +intro: 'Sie können Inhalte und Daten auf {% data variables.product.product_name %} archivieren, damit andere Personen sie ansehen und darauf verweisen können.' redirect_from: - /articles/about-archiving-content-and-data-on-github versions: @@ -9,7 +9,7 @@ versions: ### Dauerhaftigkeit von öffentlichen Repositorys -{% data variables.product.product_name %} beabsichtigt, Deine öffentlichen Repositorys verfügbar zu lassen, es sei denn, Du entfernst sie. In einigen Fällen entfernen wir möglicherweise öffentliche Inhalte, beispielsweise in folgenden Fällen: +{% data variables.product.product_name %} beabsichtigt, Ihre öffentlichen Repositorys verfügbar zu lassen, es sei denn, Sie entfernen sie. In einigen Fällen entfernen wir möglicherweise öffentliche Inhalte, beispielsweise in folgenden Fällen: - Wir erhalten einen [Aufruf zum Entfernen gemäß DMCA](/articles/dmca-takedown-policy) für Inhalte in einem Repository. - Wir stellen fest, dass der Inhalt eines Repositorys gegen unsere [Community-Richtlinien](/articles/github-community-guidelines) oder [Nutzungsbedingungen](/articles/github-terms-of-service/) verstößt. diff --git a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-archiving-repositories.md b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-archiving-repositories.md index 34a737300496..af55c8231cd9 100644 --- a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-archiving-repositories.md +++ b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-archiving-repositories.md @@ -20,7 +20,7 @@ versions: Nach der Archivierung eines Repositorys kannst Du keine Mitarbeiter oder Teams mehr hinzufügen oder entfernen. Mitarbeiter, die Zugriff auf das Repository haben, können Dein Projekt nur forken oder mit einem Stern versehen. -Wenn ein Repository archiviert wird, werden seine Issues, Pull Requests, Codes, Kennzeichnungen, Meilensteine, Projekte, Wikis, Versionen, Commits, Tags, Branches, Reaktionen und Kommentare schreibgeschützt. Um Änderungen in einem archivierten Repository vorzunehmen, musst Du das Repository zunächst aus dem Archiv herausnehmen. +When a repository is archived, its issues, pull requests, code, labels, milestones, projects, wiki, releases, commits, tags, branches, reactions, code scanning alerts, and comments become read-only. Um Änderungen in einem archivierten Repository vorzunehmen, musst Du das Repository zunächst aus dem Archiv herausnehmen. Du kannst nach archivierten Repositorys suchen. Weitere Informationen findest Du unter „[Nach Repositorys suchen](/articles/searching-for-repositories/#search-based-on-whether-a-repository-is-archived).“ Weitere Informationen findest Du unter „[Nach Repositorys suchen](/articles/searching-for-repositories/#search-based-on-whether-a-repository-is-archived)“. Weitere Informationen findest Du unter „[Nach Issues und Pull Requests suchen](/articles/searching-issues-and-pull-requests/#search-based-on-whether-a-repository-is-archived).“ diff --git a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md index 34401fc86beb..8279f23e2dba 100644 --- a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md +++ b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md @@ -1,6 +1,6 @@ --- title: Informationen zu Codeinhabern -intro: 'Du kannst eine CODEOWNERS-Datei verwenden, um Personen oder Teams zu definieren, die für den Code in einem Repository verantwortlich sind.' +intro: Du kannst eine CODEOWNERS-Datei verwenden, um Personen oder Teams zu definieren, die für den Code in einem Repository verantwortlich sind. redirect_from: - /articles/about-codeowners/ - /articles/about-code-owners @@ -20,7 +20,7 @@ Code-Besitzer werden automatisch zur Überprüfung aufgefordert, wenn jemand ein Wenn ein Benutzer mit Administrator- oder Inhaberberechtigungen die erforderlichen Reviews aktiviert hat, kann er optional auch die Genehmigung von einem Codeinhaber anfordern, bevor der Autor einen Pull Request im Repository zusammenführen kann. Weitere Informationen findest Du unter „[Erforderliche Reviews für Pull Requests aktivieren](/github/administering-a-repository/enabling-required-reviews-for-pull-requests).“ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}Wenn ein Team die Zuweisung zur Code-Überprüfung aktiviert hat, werden die individuellen Genehmigungen alleine nicht die Anforderung für die Genehmigung des Codeinhabers in einem geschützten Zweig erfüllen. Weitere Informationen findest Du unter „[Code Review-Zuweisung für Dein Team verwalten](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)."{% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}If a team has enabled code review assignments, the individual approvals won't satisfy the requirement for code owner approval in a protected branch. Weitere Informationen findest Du unter „[Code Review-Zuweisung für Dein Team verwalten](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)."{% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} Wenn eine Datei einen Codeinhaber hat, kannst Du sehen, wer der Codeinhaber ist, bevor Du einen Pull Request öffnest. In the repository, you can browse to the file and hover over @@ -39,7 +39,7 @@ Damit Codeinhaber Review-Anfragen erhalten können, muss sich die CODEINHABER-Da ### CODEOWNERS-Syntax -Eine CODEINHABER-Datei verwendet ein Muster, das den gleichen Regeln folgt wie in [gitignore](https://git-scm.com/docs/gitignore#_pattern_format)-Dateien. Dem Muster folgen ein oder mehrere {% data variables.product.prodname_dotcom %}-Benutzernamen oder Teamnamen im Standardformat `@benutzername` oder `@org/teamname`. Sie können auf einen Benutzer auch über eine E-Mail-Adresse verweisen, die zu dessen {% data variables.product.product_name %}-Konto hinzugefügt wurde, z. B. `benutzer@beispiel.com`. +Eine CODEINHABER-Datei verwendet ein Muster, das den gleichen Regeln folgt wie in [gitignore](https://git-scm.com/docs/gitignore#_pattern_format)-Dateien. Dem Muster folgen ein oder mehrere {% data variables.product.prodname_dotcom %}-Benutzernamen oder Teamnamen im Standardformat `@benutzername` oder `@org/teamname`. Du kannst auf einen Benutzer auch über eine E-Mail-Adresse verweisen, die zu dessen {% data variables.product.product_name %}-Konto hinzugefügt wurde, z. B. `benutzer@beispiel.com`. If any line in your CODEOWNERS file contains invalid syntax, the file will not be detected and will not be used to request reviews. Invalid syntax includes inline comments and user or team names that do not exist on {% data variables.product.product_name %}. #### Beispiel für eine CODEOWNERS-Datei @@ -78,8 +78,9 @@ docs/* docs@beispiel.com # in einem Apps-Verzeichnis irgendwo in Ihrem Repository. apps/ @octocat -# In diesem Beispiel ist @doctocat Inhaber irgendeiner Datei -# im Verzeichnis `/docs` im Stammverzeichnis Ihres Repositorys. +# In this example, @doctocat owns any file in the `/docs` +# directory in the root of your repository and any of its +# subdirectories. /docs/ @doctocat ``` diff --git a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-readmes.md b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-readmes.md index f5a382dba847..fcd81da39f8a 100644 --- a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-readmes.md +++ b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-readmes.md @@ -10,7 +10,7 @@ versions: enterprise-server: '*' --- -Eine README-Datei zusammen mit {% if currentVersion == "free-pro-team@latest" %}einer [Repository-Lizenz](/articles/licensing-a-repository), [Beitragsrichtlinien](/articles/setting-guidelines-for-repository-contributors) und einem [Verhaltenskodex](/articles/adding-a-code-of-conduct-to-your-project){% else %}einer [Repository-Lizenz](/articles/licensing-a-repository) und [Beitragsrichtlinien](/articles/setting-guidelines-for-repository-contributors){% endif %} hilft Dir, die Erwartungen an Dein Projekt zu kommunizieren und die Beiträge zu Deinem Projekt zu verwalten. +A README file, along with {% if currentVersion == "free-pro-team@latest" %}a [repository license](/articles/licensing-a-repository), [contribution guidelines](/articles/setting-guidelines-for-repository-contributors), and a [code of conduct](/articles/adding-a-code-of-conduct-to-your-project){% else %}a [repository license](/articles/licensing-a-repository) and [contribution guidelines](/articles/setting-guidelines-for-repository-contributors){% endif %}, helps you communicate expectations for and manage contributions to your project. Die README-Datei ist oft das erste Element, das ein Benutzer beim Besuch Deines Repositorys sieht. README-Dateien enthalten in der Regel folgende Informationen: - Was ist die Aufgabe des Projekts? @@ -19,7 +19,7 @@ Die README-Datei ist oft das erste Element, das ein Benutzer beim Besuch Deines - Wo erhalten Benutzer Hilfe zu Ihrem Projekt? - Wer verwaltet das Projekt und trägt dazu bei? -Wenn Du Deine README-Datei im root-, `docs`- oder im verborgenen `.github`-Verzeichnis Deines Repositorys ablegst, erkennt {% data variables.product.product_name %} Deine README-Datei und stellt sie automatisch den Besuchern des Repositorys zur Verfügung. +Wenn Sie Ihre README-Datei im Stammverzeichnis, im Ordner `docs` oder im verborgenen Verzeichnis `.github` Ihres Repositorys ablegen, erkennt {% data variables.product.product_name %} Ihre README-Datei und stellt sie automatisch den Besuchern des Repositorys zur Verfügung. ![Hauptseite des github/scientist-Repositorys und seiner README-Datei](/assets/images/help/repository/repo-with-readme.png) diff --git a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-repositories.md b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-repositories.md index 17764c60755c..ec1dcb3e5cd0 100644 --- a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-repositories.md +++ b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-repositories.md @@ -15,12 +15,13 @@ Du kannst einschränken, wer Zugriff auf ein Repository hat, indem Du die Sichtb Bei benutzereigenen Repositorys kannst du anderen Personen Mitarbeiterzugriff geben, damit sie an Deinem Projekt mitarbeiten können. Wenn ein Repository im Besitz einer Organisation ist, kannst Du den Mitgliedern der Organisation Zugriffsberechtigungen für die Mitarbeit in Deinem Repository erteilen. Weitere Informationen findest Du unter „[Berechtigungsebenen für ein Repository eines Benutzerkontos](/articles/permission-levels-for-a-user-account-repository/)“ und „[Berechtigungsebenen für die Repositorys einer Organisation](/articles/repository-permission-levels-for-an-organization/).“ {% if currentVersion == "free-pro-team@latest" %} -Mit {% data variables.product.prodname_free_team %} für Benutzerkonten und Organisationen kannst Du mit einer unbegrenzten Anzahl von Mitarbeitern an unbegrenzten öffentlichen Repositorys mit einem vollen Funktionsumfang arbeiten oder an unbegrenzten privaten Repositorys mit einem begrenzten Funktionsumfang. Um erweiterte Werkzeuge für private Repositorys zu erhalten, kannst Du auf {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %} oder{% data variables.product.prodname_ghe_cloud %} upgraden. {% data reusables.gated-features.more-info %} +With +{% data variables.product.prodname_free_team %} for user accounts and 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. Um erweiterte Werkzeuge für private Repositorys zu erhalten, kannst Du auf {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %} oder{% data variables.product.prodname_ghe_cloud %} upgraden. {% data reusables.gated-features.more-info %} {% else %} Jede Person und Organisation kann unbegrenzte Repositorys besitzen und eine unbegrenzte Anzahl von Mitarbeitern in alle Repositorys einladen. {% endif %} -Mithilfe der Issues, Pull Requests und Projektboards Deines Repositorys kannst Du mit anderen an Deinem Projekt zusammenarbeiten. +Mithilfe der Issues, Pull Requests und Projektboards Ihres Repositorys können Sie mit anderen an Ihrem Projekt zusammenarbeiten. ![Hauptseite des Octocat-/Hello-World-Repositorys](/assets/images/help/repository/repo-main-page.png) @@ -30,7 +31,7 @@ Mithilfe der Issues, Pull Requests und Projektboards Deines Repositorys kannst D - „[Ein neues Repository erstellen](/articles/creating-a-new-repository)“ - „[Mithilfe von Issues und Pull Requests zusammenarbeiten](/categories/collaborating-with-issues-and-pull-requests)“ -- „[Deine Arbeit auf {% data variables.product.prodname_dotcom %} verwalten](/categories/managing-your-work-on-github/)“ +- „[Ihre Arbeit auf {% data variables.product.prodname_dotcom %} verwalten](/categories/managing-your-work-on-github/)“ - „[Ein Repository verwalten](/categories/administering-a-repository)“ - „[Repository-Daten mit Diagrammen visualisieren](/categories/visualizing-repository-data-with-graphs/)“ - „[Informationen zu Wikis](/articles/about-wikis)“ diff --git a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md index e1ccd342c2f2..1e6ec6deaa52 100644 --- a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md +++ b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md @@ -1,6 +1,6 @@ --- title: Informationen zu Repository-Sprachen -intro: 'Die Dateien und Verzeichnisse innerhalb eines Repositorys bestimmen die Sprachen des Repositorys. Du kannst die Sprachen eines Repositorys anzeigen, um Dir einen schnellen Überblick über das Repository zu verschaffen.' +intro: Die Dateien und Verzeichnisse innerhalb eines Repositorys bestimmen die Sprachen des Repositorys. Du kannst die Sprachen eines Repositorys anzeigen, um Dir einen schnellen Überblick über das Repository zu verschaffen. redirect_from: - /articles/my-repository-is-marked-as-the-wrong-language/ - /articles/why-isn-t-my-favorite-language-recognized/ @@ -13,7 +13,8 @@ versions: enterprise-server: '*' --- -{% data variables.product.product_name %} verwendet die Open-Source-Bibliothek [Linguist](https://github.com/github/linguist), um Dateisprachen für Syntaxmarkierung und Repository-Statistiken zu bestimmen. Language statistics will update after you push changes to your default branch. +{% data variables.product.product_name %} uses the open source [Linguist library](https://github.com/github/linguist) to +determine file languages for syntax highlighting and repository statistics. Language statistics will update after you push changes to your default branch. Einige Dateien sind schwer zu identifizieren, und manchmal enthalten Projekte mehr Bibliotheks- und Anbieterdateien als eigenen Primärcode. Wenn Du falsche Ergebnisse erhältst, lies bitte den [Leitfaden zur Fehlerbehebung](https://github.com/github/linguist#troubleshooting) für Linguist. diff --git a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-repository-visibility.md b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-repository-visibility.md index 8ce60c9cc7f2..d8c3f2ea37c5 100644 --- a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-repository-visibility.md +++ b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/about-repository-visibility.md @@ -1,23 +1,23 @@ --- -title: Informationen zur Sichtbarkeit eines Repositorys -intro: 'Du kannst einschränken, wer Zugriff auf ein Repository hat, indem Du die Sichtbarkeit eines Repositorys auswählst: {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}öffentlich, intern oder privat{% else %}öffentlich oder privat{% endif %}.' +title: About repository visibility +intro: 'You can restrict who has access to a repository by choosing a repository''s visibility: {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}public, internal, or private{% else %} public or private{% endif %}.' versions: free-pro-team: '*' enterprise-server: '*' --- -### Informationen zur Sichtbarkeit eines Repositorys +### About repository visibility -Wenn Du ein Repository erstellst, kannst Du es öffentlich oder privat machen. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}Wenn Du das Repository in einer Organisation erstellst{% if currentVersion == "free-pro-team@latest" %} die sich im Besitz eines Enterprise-Kontos befindet{% endif %}, kannst Du das Repository auch intern machen.{% endif %} +When you create a repository, you can choose to make the repository public or private. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}If you're creating the repository in an organization{% if currentVersion == "free-pro-team@latest" %} that is owned by an enterprise account{% endif %}, you can also choose to make the repository internal.{% endif %} -{% if currentVersion != "free-pro-team@latest" %}If {% data variables.product.product_location_enterprise %} is not in private mode or behind a firewall, p{% else %}P{% endif %}ublic repositories are accessible to everyone on the internet.{% if currentVersion != "free-pro-team@latest" %} Otherwise, public repositories are available to everyone using {% data variables.product.product_location_enterprise %}, including outside collaborators.{% endif %} Private repositories are only accessible to you, people you explicitly share access with, and, for organization repositories, [certain organization members](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization). {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}Interne Repositorys sind für {% if currentVersion == "free-pro-team@latest" %}Mitglieder Deines Enterprise-Kontos{% else %}Mitglieder einer beliebigen Organisation auf Deiner Instanz{% endif %} zugänglich. Weitere Informationen findest Du unter "[Über interne Repositorys](#about-internal-repositories)."{% endif %} +{% if currentVersion != "free-pro-team@latest" %}If {% data variables.product.product_location_enterprise %} is not in private mode or behind a firewall, p{% else %}P{% endif %}ublic repositories are accessible to everyone on the internet.{% if currentVersion != "free-pro-team@latest" %} Otherwise, public repositories are available to everyone using {% data variables.product.product_location_enterprise %}, including outside collaborators.{% endif %} Private repositories are only accessible to you, people you explicitly share access with, and, for organization repositories, [certain organization members](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization). {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}Internal repositories are accessible to {% if currentVersion == "free-pro-team@latest" %}members of your enterprise account{% else %}members of any organization on your instance{% endif %}. For more information, see "[About internal repositories](#about-internal-repositories)."{% endif %} -Organisationsinhaber haben immer Zugriff auf jedes Repository, das in einer Organisation erstellt wurde. Weitere Informationen findest Du unter„[Berechtigungsebenen für die Repositorys einer Organisation](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization).“ +Organization owners always have access to every repository created in an organization. For more information, see "[Repository permission levels for an organization](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization)." -Personen mit Administratorberechtigungen für ein Repository können die Sichtbarkeit eines vorhandenen Repositorys ändern. Weitere Informationen findest Du unter „[Sichtbarkeit eines Repositorys festlegen](/github/administering-a-repository/setting-repository-visibility).“ +People with admin permissions for a repository can change an existing repository's visibility. For more information, see "[Setting repository visibility](/github/administering-a-repository/setting-repository-visibility)." {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -### Informationen zu internen Repositorys +### About internal repositories {% note %} @@ -25,12 +25,11 @@ Personen mit Administratorberechtigungen für ein Repository können die Sichtba {% endnote %} -{% data reusables.repositories.about-internal-repos %} Weitere Informationen zu innersource findest Du im Whitepaper von {% data variables.product.prodname_dotcom %} „[Eine Einführung zu innersource](https://resources.github.com/whitepapers/introduction-to-innersource/)." +{% data reusables.repositories.about-internal-repos %} For more information on innersource, see {% data variables.product.prodname_dotcom %}'s whitepaper "[An introduction to innersource](https://resources.github.com/whitepapers/introduction-to-innersource/)." -Alle {% if currentVersion == "free-pro-team@latest" %}Unternehmensmitglieder{% else %}Organisationsmitglieder{% endif %} haben Leseberechtigung auf das interne Repository, aber interne Repositorys sind nicht sichtbar für Personen{% if currentVersion == "free-pro-team@latest" %} außerhalb des Enterprise-Kontos{% else %}, die keine Mitglieder einer Organisation sind{% endif %}, einschließlich externer Mitarbeiter auf Organisations-Repositorys. Weitere Informationen findest Du unter {% if currentVersion == "free-pro-team@latest" %}„[Rollen für ein Enterprise-Konto](/articles/roles-for-an-enterprise-account#enterprise-members)" und {% endif %}„[Berechtigungsebenen für die Repositorys einer Organisation](/articles/repository-permission-levels-for-an-organization).“ +All {% if currentVersion == "free-pro-team@latest" %}enterprise members{% else %}organization members{% endif %} have read permissions to the internal repository, but internal repositories are not visible to people {% if currentVersion == "free-pro-team@latest" %}outside of the enterprise account{% else %}who are not members of an organization{% endif %}, including outside collaborators on organization repositories. For more information, see {% if currentVersion == "free-pro-team@latest" %}"[Roles for an enterprise account](/articles/roles-for-an-enterprise-account#enterprise-members)" and {% endif %}"[Repository permission levels for an organization](/articles/repository-permission-levels-for-an-organization)." {% data reusables.repositories.internal-repo-default %} -Wenn ein Benutzer entfernt wird von -{% if currentVersion == "free-pro-team@latest" %}einem Enterprise-Konto{% else %}allen Organisationen auf der Instanz{% endif %}, werden die Forks dieses Benutzers auf den internen Repositorys automatisch entfernt. +If a user is removed from {% if currentVersion == "free-pro-team@latest" %}an enterprise account{% else %}all organizations on the instance{% endif %}, that user's forks of internal repositories are removed automatically. {% endif %} diff --git a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/archiving-a-github-repository.md b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/archiving-a-github-repository.md index 729c9cf496a4..3d3987c00095 100644 --- a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/archiving-a-github-repository.md +++ b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/archiving-a-github-repository.md @@ -1,6 +1,6 @@ --- title: Ein GitHub-Repository archivieren -intro: 'Du kannst Deine Arbeit mit {% data variables.product.product_name %}, der API oder Werkzeugen und Diensten von Drittanbietern archivieren, sichern und zitieren.' +intro: 'Sie können Ihre Arbeit mit {% data variables.product.product_name %}, der API oder Tools und Diensten von Drittanbietern archivieren, sichern und zitieren.' redirect_from: - /articles/can-i-archive-a-repository/ - /articles/archiving-a-github-repository diff --git a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/archiving-repositories.md b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/archiving-repositories.md index 048a875f62c7..34cd7c244c29 100644 --- a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/archiving-repositories.md +++ b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/archiving-repositories.md @@ -1,6 +1,6 @@ --- title: Repositorys archivieren -intro: 'Du kannst ein Repository archivieren, damit es allen Benutzern nur mit Lesezugriff zur Verfügung steht und damit klar ist, dass es nicht mehr aktiv unterhalten wird. Du kannst die Archivierung eines Repository auch wieder aufheben.' +intro: Du kannst ein Repository archivieren, damit es allen Benutzern nur mit Lesezugriff zur Verfügung steht und damit klar ist, dass es nicht mehr aktiv unterhalten wird. Du kannst die Archivierung eines Repository auch wieder aufheben. redirect_from: - /articles/archiving-repositories versions: diff --git a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md index 0788119c871e..5364873fbeb0 100644 --- a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md +++ b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md @@ -1,42 +1,41 @@ --- -title: Sicherung eines Repositorys durchführen -intro: 'Du kannst{% if currentVersion != "free-pro-team@latest" %} Git und{% endif %} die API {% if currentVersion == "free-pro-team@latest" %}oder ein Drittanbieter-Werkzeug {% endif %}für die Sicherung Deines Repositorys verwenden.' +title: Backing up a repository +intro: 'You can use{% if currentVersion != "free-pro-team@latest" %} Git and{% endif %} the API {% if currentVersion == "free-pro-team@latest" %}or a third-party tool {% endif %}to back up your repository.' redirect_from: - /articles/backing-up-a-repository versions: free-pro-team: '*' enterprise-server: '*' --- - {% if currentVersion == "free-pro-team@latest" %} -Um ein Archiv Deines Repositorys herunterzuladen, kannst du die API für die Migration von Benutzern oder Organisationen verwenden. For more information, see "[Migrations](/v3/migrations/)." +To download an archive of your repository, you can use the API for user or organization migrations. For more information, see "[Migrations](/v3/migrations/)." {% else %} -Du kannst Deine Repositorys manuell herunterladen und sichern: +You can download and back up your repositories manually: -- Um die Git-Daten eines Repositorys auf Deinen lokalen Computer herunterzuladen, musst Du das Repository klonen. Weitere Informationen findest Du unter „[Ein Repository clonen](/articles/cloning-a-repository)“. -- Du kannst auch das Wiki Deines Repositorys herunterladen. Weitere Informationen findest Du unter „[Wiki-Seiten hinzufügen oder bearbeiten](/articles/adding-or-editing-wiki-pages).“ +- To download a repository's Git data to your local machine, you'll need to clone the repository. For more information, see "[Cloning a repository](/articles/cloning-a-repository)." +- You can also download your repository's wiki. For more information, see "[Adding or editing wiki pages](/articles/adding-or-editing-wiki-pages)." -Wenn Du ein Repository oder Wiki klonst, werden nur Git-Daten wie Projektdateien und der Commit-Verlauf heruntergeladen. Mithilfe unserer API kannst Du andere Elemente Deines {% data variables.product.product_name %}-Repositorys auf Deinen lokalen Computer herunterladen: +When you clone a repository or wiki, only Git data, such as project files and commit history, is downloaded. You can use our API to export other elements of your {% data variables.product.product_name %} repository to your local machine: - [Issues](/v3/issues/#list-issues-for-a-repository) -- [Pull Requests](/v3/pulls/#list-pull-requests) -- [Forks](/v3/repos/forks/#list-forks) -- [Kommentare](/v3/issues/comments/#list-comments-in-a-repository) -- [Meilensteine](/v3/issues/milestones/#list-milestones-for-a-repository) -- [Kennzeichnungen](/v3/issues/labels/#list-all-labels-for-this-repository) -- [Watcher](/v3/activity/watching/#list-watchers) -- [Stargazers](/v3/activity/starring/#list-stargazers) -- [Projekte](/v3/projects/#list-repository-projects) +- [Pull requests](/v3/pulls/#list-pull-requests) +- [Forks](/rest/reference/repos#list-forks) +- [Comments](/rest/reference/issues#list-issue-comments-for-a-repository) +- [Milestones](/rest/reference/issues#list-milestones) +- [Labels](/rest/reference/issues#list-labels-for-a-repository) +- [Watchers](/rest/reference/activity#list-watchers) +- [Stargazers](/rest/reference/activity#list-stargazers) +- [Projects](/v3/projects/#list-repository-projects) {% endif %} -Sobald Du {% if currentVersion != "free-pro-team@latest" %}eine lokale Version aller Inhalte hast, die Du sichern möchtest, kannst Du ein ZIP-Archiv erstellen und {% else %}Dein Archiv heruntergeladen hast, kannst Du {% endif %}es auf eine externe Festplatte kopieren und/oder auf einen Cloud-basierten Dienst wie [Google Drive](https://www.google.com/drive/) oder [Dropbox](https://www.dropbox.com/) hochladen. +Once you have {% if currentVersion != "free-pro-team@latest" %}a local version of all the content you want to back up, you can create a zip archive and {% else %}downloaded your archive, you can {% endif %}copy it to an external hard drive and/or upload it to a cloud-based backup service such as [Google Drive](https://www.google.com/drive/) or [Dropbox](https://www.dropbox.com/). {% if currentVersion == "free-pro-team@latest" %} -### Backup-Tools (Sicherungswerkzeuge) von Drittanbietern +### Third-party backup tools -Es sind mehrere Self-Service-Tools verfügbar, mit denen Du die Sicherung von Repositorys automatisieren kannst. Im Gegensatz zu Archivierungsprojekten, welche _alle_ nicht ausgeschlossenen öffentlichen Repositorys auf {% data variables.product.product_name %} archivieren und ihre Daten für jedermann zugänglich machen, werden Sicherungswerkzeuge die Daten von _spezifischen_ Repositorys herunterladen und sie in einem neuen Branch oder Verzeichnis organisieren. Weitere Informationen zu Archivierungsprojekten findest Du unter „[Über die Archivierung von Inhalt und Daten auf {% data variables.product.prodname_dotcom %}](/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github#about-the-github-archive-program)." +A number of self-service tools exist that automate backups of repositories. Unlike archival projects, which archive _all_ public repositories on {% data variables.product.product_name %} that have not opted out and make the data accessible to anyone, backup tools will download data from _specific_ repositories and organize it within a new branch or directory. For more information about archival projects, see "[About archiving content and data on {% data variables.product.prodname_dotcom %}](/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github#about-the-github-archive-program)." -Du kannst alle Git-Daten eines Repositorys (wie Projektdateien und den Commit-Verlauf) sowie viele Daten von {% data variables.product.product_name %} (wie Issues und Pull Requests) mit [BackHub](https://github.com/marketplace/backhub) sichern. Dieses Werkzeug erstellt täglich wiederkehrend eine Sicherung Deiner Repositorys, mit Snapshots bis zu 30 Tagen in die Vergangenheit. BackHub ist auf {% data variables.product.prodname_marketplace %} verfügbar. +You can back up all of a repository's Git data (such as project files and commit history), as well as much data from {% data variables.product.product_name %} (such as issues and pull requests), with [BackHub](https://github.com/marketplace/backhub), which creates daily recurring backups of your repositories with snapshots up to 30 days back in time. BackHub is available in {% data variables.product.prodname_marketplace %}. {% endif %} diff --git a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md index 7b28c39c5a4a..2b1a6398d210 100644 --- a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md +++ b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md @@ -46,7 +46,7 @@ Weitere Informationen finden Sie unter „[Ein Repository von {% data variables. Ein leeres Repository enthält keine Dateien. Dies geschieht öfters, wenn Du das Repository bei der Erstellung nicht mit einer README-Datei initialisierst. {% data reusables.repositories.navigate-to-repo %} -2. Um Dein Repository über die Befehlszeile mit HTTPS zu klonen, klicke unter „Quick setup" (Schnelleinrichtung) auf {% octicon "clippy" aria-label="The clipboard icon" %}. Um das Repository mittels SSH-Schlüssel zu klonen{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, einschließlich einem durch die SSH-Zertifizierungsstelle Deiner Organisation herausgegebenen Zertifikat,{% endif %} klicke auf **SSH** und dann auf {% octicon "clippy" aria-label="The clipboard icon" %}. ![Schaltfläche „Empty repository clone URL" (Leeres-Repository-Klonen-URL)](/assets/images/help/repository/empty-https-url-clone-button.png) +2. Um Dein Repository über die Befehlszeile mit HTTPS zu klonen, klicke unter „Quick setup" (Schnelleinrichtung) auf {% octicon "clippy" aria-label="The clipboard icon" %}. To clone the repository using an SSH key, including a certificate issued by your organization's SSH certificate authority, click **SSH**, then click {% octicon "clippy" aria-label="The clipboard icon" %}. ![Schaltfläche „Empty repository clone URL" (Leeres-Repository-Klonen-URL)](/assets/images/help/repository/empty-https-url-clone-button.png) Um Dein Repository alternativ in Desktop zu klonen, klicke {% octicon "desktop-download" aria-label="The desktop download button" %} **Set up in Desktop** (In Desktop aufsetzen) und folge den Anweisungen, um den Klon zu vervollständigen. ![Schaltfläche „Empty repository desktop" (Leeres-Repository-Klonen-Desktop)](/assets/images/help/repository/empty-desktop-clone-button.png) @@ -55,7 +55,6 @@ Ein leeres Repository enthält keine Dateien. Dies geschieht öfters, wenn Du da {% data reusables.command_line.git-clone-url %} {% data reusables.command_line.local-clone-created %} - ### Beheben von Fehlern beim Klonen Beim Klonen eines Repositorys wirst Du allenfalls Fehlern begegnen. @@ -66,7 +65,6 @@ Wenn Du ein Repository nicht klonen kannst, überprüfe Folgendes: - Du hast die Berechtigung zum Zugriff auf das Repository, das Du klonen willst. Weitere Informationen findest du auf „[Error: Repository not found](/github/creating-cloning-and-archiving-repositories/error-repository-not-found)" (Fehler: Repository nicht gefunden). - Der Standardbranch, den Du klonen willst, existiert immer noch. Für weitere Informationen, prüfe, ob Du die Berechtigungen zum Zugriff auf das zu klonende Repository hast. Weitere Informationen findest Du unter „[Error: Remote HEAD refers to nonexistent ref, unable to checkout](/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout)" (Fehler: HEAD des Remote enthält eine nicht existierende Referenz, auschecken nicht möglich). - {% if currentVersion == "free-pro-team@latest" %} ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md index 3482de271c06..3fb52575d36e 100644 --- a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md +++ b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md @@ -1,6 +1,6 @@ --- title: Ein neues Repository erstellen -intro: 'Du kannst ein neues Repository in Deinem persönlichen Konto oder in jeder Organisation erstellen, für die Du ausreichend Berechtigungen hast.' +intro: Du kannst ein neues Repository in Deinem persönlichen Konto oder in jeder Organisation erstellen, für die Du ausreichend Berechtigungen hast. redirect_from: - /creating-a-repo/ - /articles/creating-a-repository-in-an-organization/ @@ -28,15 +28,15 @@ versions: {% endtip %} {% endif %} -{% data reusables.repositories.create_new %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} +{% data reusables.repositories.create_new %} 2. Um optional ein Repository mit der Verzeichnisstruktur und den Dateien eines vorhandenen Repositorys zu erstellen, verwende eine Repository-Vorlage aus dem Dropdownmenü **Choose a template** (Eine Vorlage auswählen). Angezeigt werden Repository-Vorlagen, die im Besitz von Dir und von Organisationen sind, bei denen Du Mitglied bist, oder die Du bereits früher verwendet hast. Weitere Informationen finden Sie unter „[Ein Repository anhand einer Vorlage erstellen](/articles/creating-a-repository-from-a-template)“. ![Template drop-down menu](/assets/images/help/repository/template-drop-down.png){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -3. Optional, wenn Du eine Vorlage verwendest, um die Verzeichnisstruktur und die Dateien aller Branches in der Vorlage einzubinden, und nicht nur den Standard-Branch, wähle **Alle Branches einbeziehen**. ![Include all branches checkbox](/assets/images/help/repository/include-all-branches.png){% endif %}{% endif %} +3. Optional, wenn Du eine Vorlage verwendest, um die Verzeichnisstruktur und die Dateien aller Branches in der Vorlage einzubinden, und nicht nur den Standard-Branch, wähle **Alle Branches einbeziehen**. ![Include all branches checkbox](/assets/images/help/repository/include-all-branches.png){% endif %} 3. Wähle im Dropdownmenü „Owner“ (Inhaber) das Konto aus, unter dem Du das Repository erstellen möchtest. ![Dropdownmenü „Owner" (Inhaber)](/assets/images/help/repository/create-repository-owner.png) {% data reusables.repositories.repo-name %} {% data reusables.repositories.choose-repo-visibility %} -6. Es sind etliche optionale Elemente verfügbar, mit denen Du Dein Repository vorab füllen kannst{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}, wenn Du keine Vorlage verwendest{% endif %}. Wenn Du ein vorhandenes Repository in {% data variables.product.product_name %} importierst, wähle keine dieser Optionen aus, da dies zu Mergekonflikten führen könnte. Du kannst {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.15" %}neue Dateien über die Benutzeroberfläche hinzufügen oder erstellen oder {% endif %}neue Dateien später über die Befehlszeile hinzufügen. Weitere Informationen findest Du unter „[Ein Git-Repository über die Befehlszeile importieren](/articles/importing-a-git-repository-using-the-command-line/)“, „[Eine Datei über die Befehlszeile zu einem Repository hinzufügen](/articles/adding-a-file-to-a-repository-using-the-command-line)“ und „[Mergekonflikte beheben](/articles/addressing-merge-conflicts/).“ +6. If you're not using a template, there are a number of optional items you can pre-populate your repository with. Wenn Du ein vorhandenes Repository in {% data variables.product.product_name %} importierst, wähle keine dieser Optionen aus, da dies zu Mergekonflikten führen könnte. Sie können neue Dateien über die Benutzeroberfläche hinzufügen oder erstellen oder neue Dateien später über die Befehlszeile hinzufügen. Weitere Informationen findest Du unter „[Ein Git-Repository über die Befehlszeile importieren](/articles/importing-a-git-repository-using-the-command-line/)“, „[Eine Datei über die Befehlszeile zu einem Repository hinzufügen](/articles/adding-a-file-to-a-repository-using-the-command-line)“ und „[Mergekonflikte beheben](/articles/addressing-merge-conflicts/).“ - Sie kannst eine README-Datei erstellen, die eine Beschreibung Deines Projekts enthält. Weitere Informationen findest Du unter „[Informationen zu README-Dateien](/articles/about-readmes/).“ - - Du kannst eine *.gitignore*-Datei erstellen, die einen Satz an Regeln für das Ignorieren enthält. Weitere Informationen findest Du unter „[Dateien ignorieren](/articles/ignoring-files)“.{% if currentVersion == "free-pro-team@latest" %} + - Du kannst eine *.gitignore*-Datei erstellen, die einen Satz an Regeln für das Ignorieren enthält. For more information, see "[Ignoring files](/articles/ignoring-files)."{% if currentVersion == "free-pro-team@latest" %} - Du kannst bei Bedarf eine Softwarelizenz zu Deinem Projekt hinzufügen. Weitere Informationen findest Du unter „[Ein Repository lizenzieren](/articles/licensing-a-repository)“.{% endif %} {% data reusables.repositories.select-marketplace-apps %} {% data reusables.repositories.create-repo %} @@ -47,6 +47,5 @@ versions: ### Weiterführende Informationen - „[Zugriff auf die Repositorys Deiner Organisation verwalten](/articles/managing-access-to-your-organization-s-repositories)“ -- [Open-Source-Leitfäden](https://opensource.guide/){% if currentVersion == "free-pro-team@latest" %} -- [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}){% endif %}{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.16" %} -- „[Ein leeres Repository mit einer README-Datei initialisieren](/articles/initializing-an-empty-repository-with-a-readme)“{% endif %} +- [Open Source Guides](https://opensource.guide/){% if currentVersion == "free-pro-team@latest" %} +- [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}){% endif %} diff --git a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md index 4a1ef2cad247..c6a3a9c5326d 100644 --- a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md +++ b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md @@ -1,11 +1,11 @@ --- title: Ein Repository anhand einer Vorlage erstellen -intro: 'Du kannst ein neues Repository mit derselben Verzeichnisstruktur und denselben Dateien erstellen, die ein vorhandenes Repository aufweist.' +intro: Du kannst ein neues Repository mit derselben Verzeichnisstruktur und denselben Dateien erstellen, die ein vorhandenes Repository aufweist. redirect_from: - /articles/creating-a-repository-from-a-template versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- ### About repository templates diff --git a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github.md b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github.md index 84f46df663d0..cc2b5413c18d 100644 --- a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github.md +++ b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github.md @@ -1,6 +1,6 @@ --- title: Ein Repository auf GitHub erstellen -intro: 'Wenn Du ein Repository auf {% data variables.product.product_name %} erstellt hast, kannst Du seine Einstellungen und seinen Inhalt anpassen.' +intro: 'Wenn Sie ein Repository auf {% data variables.product.product_name %} erstellt haben, können Sie die Einstellungen und den Inhalt anpassen.' mapTopic: true redirect_from: - /articles/creating-a-repository-on-github diff --git a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md index 88250884443a..985918901d8d 100644 --- a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md +++ b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md @@ -1,19 +1,20 @@ --- -title: Eine Repository-Vorlage erstellen -intro: 'Du kannst ein vorhandenes Repository zu einer Vorlage machen, sodass Du wie auch andere Personen neue Repositorys mit derselben Verzeichnisstruktur{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}, Branches{% endif %} und Dateien generieren können.' +title: Creating a template repository +intro: 'You can make an existing repository a template, so you and others can generate new repositories with the same directory structure{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}, branches,{% endif %} and files.' redirect_from: - /articles/creating-a-template-repository versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- -Jeder, der über Administratorberechtigungen für ein Repository verfügt, kann das Repository zu einer Vorlage machen. +Anyone with admin permissions to a repository can make the repository a template. -Um eine Repository-Vorlage zu erstellen, musst Du ein Repository erstellen und es anschließend zu einer Vorlage machen. Weitere Informationen zum Erstellen eines Repositorys findest Du unter „[Ein neues Repository erstellen](/articles/creating-a-new-repository).“ +To create a template repository, you must create a repository, then make the repository a template. For more information about creating a repository, see "[Creating a new repository](/articles/creating-a-new-repository)." -Nachdem Du Dein Repository zu einer Vorlage gemacht hast, kann jeder Benutzer mit Zugriff auf das Repository ein neues Repository mit derselben Verzeichnisstruktur und Dateien wie Dein Standardbranch generieren.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} Sie können auch alle anderen Branches Deines Repositorys einbinden.{% endif %} Weitere Informationen findest Du unter "[Erstellen eines Repositorys aus einer Vorlage](/articles/creating-a-repository-from-a-template)." +After you make your repository a template, anyone with access to the repository can generate a new repository with the same directory structure and files as your default branch.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} They can also choose to include all the other branches in your repository.{% endif %} For more information, see "[Creating a repository from a template](/articles/creating-a-repository-from-a-template)." {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} -3. Wähle **Template repository** (Repository-Vorlage) aus. ![Kontrollkästchen zum Umwandeln eines Repositorys in eine Vorlage](/assets/images/help/repository/template-repository-checkbox.png) +3. Select **Template repository**. + ![Checkbox to make a repository a template](/assets/images/help/repository/template-repository-checkbox.png) diff --git a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/creating-an-issues-only-repository.md b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/creating-an-issues-only-repository.md index ced757c7fd79..b1ccf64c7691 100644 --- a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/creating-an-issues-only-repository.md +++ b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/creating-an-issues-only-repository.md @@ -1,6 +1,6 @@ --- title: Ein Repository nur für Issues erstellen -intro: '{% data variables.product.product_name %} bietet keine Berechtigungen für den Zugriff ausschließlich auf Issues. Du kannst zu diesem Zweck aber ein zweites Repository erstellen, das nur die Issues enthält.' +intro: '{% data variables.product.product_name %} bietet keine Berechtigungen für den Zugriff ausschließlich auf Issues. Sie können zu diesem Zweck aber ein zweites Repository erstellen, das nur die Issues enthält.' redirect_from: - /articles/issues-only-access-permissions/ - /articles/is-there-issues-only-access-to-organization-repositories/ diff --git a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md index 2ea0d60832cb..1f11966b169f 100644 --- a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md +++ b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md @@ -22,7 +22,7 @@ $ git clone https://{% data variables.command_line.codeblock %}/user/ warning: remote HEAD refers to nonexistent ref, unable to checkout. ``` -Um das Problem zu beheben, musst Du ein Administrator des Repositorys auf {% data variables.product.product_location %} sein. [Ändere den Standardbranch](/articles/setting-the-default-branch) des Repositorys. +Um das Problem zu beheben, musst Du ein Administrator des Repositorys auf {% data variables.product.product_location %} sein. [Ändere den Standardbranch](/github/administering-a-repository/changing-the-default-branch) des Repositorys. Anschließend kannst Du über die Befehlszeile eine Liste aller verfügbaren Branches abrufen: diff --git a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/error-repository-not-found.md b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/error-repository-not-found.md index 53141bff3118..bb6a246c3b5a 100644 --- a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/error-repository-not-found.md +++ b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/error-repository-not-found.md @@ -1,6 +1,6 @@ --- title: 'Fehler: „Repository not found“ (Repository wurde nicht gefunden)' -intro: '{% if currentVersion == "free-pro-team@latest" %}Wenn Dir beim Klonen eines Repositorys diese Fehlermeldung angezeigt wird, ist das Repository nicht vorhanden oder Du hast keinen Zugriff darauf. Es gibt mehrere Möglichkeiten, dieses Problem zu lösen, je nach Ursache.{% else %}Wenn Dir beim Klonen eines Repositorys diese Fehlermeldung angezeigt wird, ist das Repository nicht vorhanden, Du hast keinen Zugriff darauf oder Deine GitHub Enterprise-Instanz befindet sich im privaten Modus. Es gibt mehrere Möglichkeiten, dieses Problem zu lösen, je nach Ursache.{% endif %}' +intro: '{% if currentVersion == "free-pro-team@latest" %}If you see this error when cloning a repository, it means that the repository does not exist or you do not have permission to access it. Es gibt mehrere Möglichkeiten, dieses Problem zu lösen, je nach Ursache.{% else %}Wenn Dir beim Klonen eines Repositorys diese Fehlermeldung angezeigt wird, ist das Repository nicht vorhanden, Du hast keinen Zugriff darauf oder Deine GitHub Enterprise-Instanz befindet sich im privaten Modus. Es gibt mehrere Möglichkeiten, dieses Problem zu lösen, je nach Ursache.{% endif %}' redirect_from: - /articles/error-repository-not-found versions: @@ -10,7 +10,7 @@ versions: ### Schreibweise überprüfen -Tippfehler kommen immer wieder vor, und bei den Namen von Repositorys muss die Groß- und Kleinschreibung beachtet werden. Wenn Du versuchst, `git@{% data variables.command_line.codeblock %}:user/repo.git` zu klonen, das Repository aber in Wirklichkeit `User/Repo` heißt, wird diese Fehlermeldung angezeigt. +Tippfehler kommen immer wieder vor, und bei den Namen von Repositorys muss die Groß- und Kleinschreibung beachtet werden. Wenn Sie versuchen, `git@{% data variables.command_line.codeblock %}:user/repo.git` zu klonen, das Repository aber in Wirklichkeit `User/Repo` heißt, wird diese Fehlermeldung angezeigt. Um diesen Fehler beim Klonen zu verhindern, solltest Du die Klon-URL immer von der Repository-Seite kopieren und einfügen. Weitere Informationen findest Du unter „[Ein Repository clonen](/articles/cloning-a-repository)“. @@ -30,7 +30,7 @@ Stelle sicher, dass Du in einer der folgenden Rollen Zugriff auf das Repository In seltenen Fällen kann Dir der richtige SSH-Zugriff auf ein Repository fehlen. -Du solltest sicherstellen, dass der von Dir verwendete SSH-Schlüssel an Dein {% data variables.product.product_name %}-Benutzerkonto angehängt ist. Um zu prüfen, ob dies bei Dir der Fall ist, gib Folgendes in die Befehlszeile ein: +Sie sollten sicherstellen, dass der von Ihnen verwendete SSH-Schlüssel an Ihr {% data variables.product.product_name %}-Benutzerkonto angehängt ist. Um zu prüfen, ob dies bei Dir der Fall ist, gib Folgendes in die Befehlszeile ein: ```shell $ ssh -T git@{% data variables.command_line.codeblock %} diff --git a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/https-cloning-errors.md b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/https-cloning-errors.md index fe3b701bce6c..90eae58cbf40 100644 --- a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/https-cloning-errors.md +++ b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/https-cloning-errors.md @@ -37,7 +37,7 @@ Für die Interaktion mit {% data variables.product.product_name %} ist keine Min ### Überprüfen, ob das Remote-Repository korrekt ist -Das Repository, von dem Du etwas abrufen möchtest, muss auf {% data variables.product.product_location %} vorhanden sein. Bei der URL musst Du die Groß- und Kleinschreibung beachten. +Das Repository, von dem Sie etwas abrufen möchten, muss auf {% data variables.product.product_location %} vorhanden sein. Bei der URL müssen Sie die Groß- und Kleinschreibung beachten. Um die URL des lokalen Repositorys zu ermitteln, öffne die Befehlszeile und gib `git remote -v` ein: @@ -56,7 +56,7 @@ $ git remote -v > origin https://github.com/github/ReactiveCocoa.git (push) ``` -Alternativ kannst Du die URL auch über unsere [{% data variables.product.prodname_desktop %}](https://desktop.github.com/)-Anwendung ändern. +Alternativ können Sie die URL auch über unsere [{% data variables.product.prodname_desktop %}](https://desktop.github.com/)-Anwendung ändern. ### Zugriffstoken angeben diff --git a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md index 7053507b07b0..24f880ea6826 100644 --- a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md +++ b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md @@ -17,7 +17,7 @@ Du bist nicht dazu verpflichtet, eine Lizenz auszuwählen. Bedenke jedoch, dass {% note %} -**Hinweis:** Wenn Du Deinen Quellcode in einem öffentlichen Repository auf GitHub veröffentlichst, haben {% if currentVersion == "free-pro-team@latest" %}gemäß den [Nutzungsbedingungen](/articles/github-terms-of-service) {% endif %}andere GitHub-Benutzer das Recht, Dein Repository innerhalb der GitHub-Website anzuzeigen und zu forken. Wenn Du bereits ein öffentliches Repository erstellt hast und nicht mehr möchtest, dass andere Benutzer darauf zugreifen, kannst Du festlegen, dass Dein Repository privat ist. Wenn Du ein öffentliches Repository in ein privates umwandelst, bleiben vorhandene Forks oder lokale Kopien bestehen, die andere Benutzer erstellt haben. Weitere Informationen findest Du unter „[Ein öffentliches Repository in ein privates umwandeln](/articles/making-a-public-repository-private).“ +**Note:** If you publish your source code in a public repository on GitHub, {% if currentVersion == "free-pro-team@latest" %}according to the [Terms of Service](/articles/github-terms-of-service), {% endif %}other GitHub users have the right to view and fork your repository within the GitHub site. Wenn Du bereits ein öffentliches Repository erstellt hast und nicht mehr möchtest, dass andere Benutzer darauf zugreifen, kannst Du festlegen, dass Dein Repository privat ist. Wenn Du ein öffentliches Repository in ein privates umwandelst, bleiben vorhandene Forks oder lokale Kopien bestehen, die andere Benutzer erstellt haben. Weitere Informationen findest Du unter „[Ein öffentliches Repository in ein privates umwandeln](/articles/making-a-public-repository-private).“ {% endnote %} @@ -49,6 +49,7 @@ Du kannst Repositorys basierend auf ihrer Lizenz oder Lizenzfamilie filtern. Ver | | WTFPL-Lizenz (Do What The F*ck You Want To Public License) | `wtfpl` | | | Educational Community License v2.0 | `ecl-2.0` | | | Eclipse Public License 1.0 | `epl-1.0` | +| | Eclipse Public License 2.0 | `epl-2.0` | | | European Union Public License 1.1 | `eupl-1.1` | | | GNU Affero General Public License v3.0 | `agpl-3.0` | | | GNU General Public License (GPL)-Lizenzfamilie | `gpl` | @@ -89,5 +90,5 @@ Das Ziel der Bemühungen von GitHub zur Open-Source-Lizenzierung ist es, Dir ein ### Weiterführende Informationen -- Der Abschnitt „[The Legal Side of Open Source](https://opensource.guide/legal/)“ (Die rechtlichen Aspekte von Open Source) in den Open-Source-Leitfäden{% if currentVersion == "free-pro-team@latest" %} +- The Open Source Guides' section "[The Legal Side of Open Source](https://opensource.guide/legal/)"{% if currentVersion == "free-pro-team@latest" %} - [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}){% endif %} diff --git a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/referencing-and-citing-content.md b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/referencing-and-citing-content.md index 087f85336ed1..f5ef4171cc6b 100644 --- a/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/referencing-and-citing-content.md +++ b/translations/de-DE/content/github/creating-cloning-and-archiving-repositories/referencing-and-citing-content.md @@ -9,7 +9,7 @@ versions: ### Permanente Identifizierung für Dein Repository mit Zenodo ausgeben -Mit permanenten Identifizierungen, auch als Digital Object Identifiers (DOIs; deutsch digitale Objektkennungen) bezeichnet, lassen sich Deine Repositorys in akademischer Literatur leichter referenzieren. Du kannst das Datenarchivierungstool [Zenodo](https://zenodo.org/about) zur Archivierung eines {% data variables.product.product_name %}-Repositorys und zur Ausgabe einer DOI für das Archiv verwenden. +Mit permanenten Identifizierungen, auch als Digital Object Identifiers (DOIs; deutsch digitale Objektkennungen) bezeichnet, lassen sich Deine Repositorys in akademischer Literatur leichter referenzieren. Sie können das Datenarchivierungstool [Zenodo](https://zenodo.org/about) zur Archivierung eines {% data variables.product.product_name %}-Repositorys und zur Ausgabe einer DOI für das Archiv verwenden. {% tip %} @@ -27,7 +27,7 @@ Mit permanenten Identifizierungen, auch als Digital Object Identifiers (DOIs; de 5. Navigiere zur [GitHub-Seite von Zenodo](https://zenodo.org/account/settings/github/). ![GitHub-Seite von Zenodo](/assets/images/help/repository/zenodo_github_page.png) 6. Bewege die Schaltfläche rechts neben dem Namen des zu archivierenden Repositorys von **Off** (Aus) auf **On** (Ein), um die Archivierung des Repositorys zu aktivieren. ![Für ein Repository Archivierung durch Zenodo aktivieren](/assets/images/help/repository/zenodo_toggle_on.png) -Zenodo archiviert Dein Repository und gibt bei jeder Erstellung eines neuen {% data variables.product.product_name %}-[Releases](/articles/about-releases/) eine DOI aus. Folge zur Erstellung eines neuen Releases den Schritten unter „[Releases erstellen](/articles/creating-releases/)". +Zenodo archiviert Ihr Repository und gibt bei jeder Erstellung eines neuen {% data variables.product.product_name %}-[Releases](/articles/about-releases/) eine DOI aus. Folge zur Erstellung eines neuen Releases den Schritten unter „[Releases erstellen](/articles/creating-releases/)". ### Forschungsarbeiten mit Figshare veröffentlichen und zitieren diff --git a/translations/de-DE/content/github/customizing-your-github-workflow/about-github-marketplace.md b/translations/de-DE/content/github/customizing-your-github-workflow/about-github-marketplace.md index cfe4abee3887..25bb385ca8e5 100644 --- a/translations/de-DE/content/github/customizing-your-github-workflow/about-github-marketplace.md +++ b/translations/de-DE/content/github/customizing-your-github-workflow/about-github-marketplace.md @@ -1,15 +1,15 @@ --- title: Informationen zu GitHub Marketplace -intro: '{% data variables.product.prodname_marketplace %} umfasst Tools zur Erweiterung der Funktionalität und Verbesserung Deines Workflows.' +intro: '{% data variables.product.prodname_marketplace %} umfasst Tools zur Erweiterung der Funktionalität und Verbesserung Ihres Workflows.' redirect_from: - /articles/about-github-marketplace versions: free-pro-team: '*' --- -Auf [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace) kannst Du kostenlose wie kostenpflichtige Tools entdecken, durchsuchen und installieren, darunter [{% data variables.product.prodname_github_app %}s, {% data variables.product.prodname_oauth_app %}s](/apps/differences-between-apps/) und {% data variables.product.prodname_actions %}. +Auf [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace) können Sie kostenlose und kostenpflichtige Tools entdecken, durchsuchen und installieren, darunter [{% data variables.product.prodname_github_app %}s, {% data variables.product.prodname_oauth_app %}s](/apps/differences-between-apps/) und {% data variables.product.prodname_actions %}. -Wenn Du ein kostenpflichtiges Tool erwirbst, bezahlst Du für Dein Tool-Abonnement mit den gleichen Abrechnungsinformationen, mit denen Du für Dein {% data variables.product.product_name %}-Abonnement bezahlst, und erhältst an Deinem regulären Abrechnungsdatum nur eine Rechnung. Weitere Informationen findest Du unter „[Informationen zur Abrechnung für {% data variables.product.prodname_marketplace %}](/articles/about-billing-for-github-marketplace).“ +Wenn Sie ein kostenpflichtiges Tool erwerben, bezahlen Sie für Ihr Tool-Abonnement mit den gleichen Abrechnungsinformationen, mit denen Sie für Ihr {% data variables.product.product_name %}-Abonnement bezahlen, und erhalten an Ihrem regulären Abrechnungsdatum eine Rechnung. Weitere Informationen findest Du unter „[Informationen zur Abrechnung für {% data variables.product.prodname_marketplace %}](/articles/about-billing-for-github-marketplace).“ Unter Umständen hast Du auch die Möglichkeit, eine kostenlose 14-tägige Testversion für ausgewählte Tools zu nutzen. Du kannst während der Testphase jederzeit kündigen, und es wird Dir nichts in Rechnung gestellt, aber Du verlierst automatisch den Zugriff auf das Tool. Dein kostenpflichtiges Abonnement beginnt am Ende der 14-tägigen Testphase. Weitere Informationen findest Du unter „[Informationen zur Abrechnung für {% data variables.product.prodname_marketplace %}](/articles/about-billing-for-github-marketplace).“ diff --git a/translations/de-DE/content/github/customizing-your-github-workflow/about-integrations.md b/translations/de-DE/content/github/customizing-your-github-workflow/about-integrations.md index 87ac9a92e305..1e691551128a 100644 --- a/translations/de-DE/content/github/customizing-your-github-workflow/about-integrations.md +++ b/translations/de-DE/content/github/customizing-your-github-workflow/about-integrations.md @@ -1,13 +1,13 @@ --- title: Informationen zu Integrationen -intro: 'Integrationen sind Werkzeuge und Dienste, die mit {% data variables.product.product_name %} verbunden werden, um Deinen Workflow zu ergänzen und zu erweitern.' +intro: 'Integrationen sind Werkzeuge und Dienste, die mit {% data variables.product.product_name %} verbunden werden, um Ihren Workflow zu ergänzen und zu erweitern.' redirect_from: - /articles/about-integrations versions: free-pro-team: '*' --- -Du kannst Integrationen in Deinem persönlichen Konto oder in Deinen eigenen Organisation installieren. Du kannst auch {% data variables.product.prodname_github_app %}s von einem Drittanbieter in einem bestimmten Repository installieren, für das Du Administratorberechtigungen hast oder das sich im Besitz Deiner Organisation befindet. +Du kannst Integrationen in Deinem persönlichen Konto oder in Deinen eigenen Organisation installieren. Sie können auch {% data variables.product.prodname_github_app %}s von einem Drittanbieter in einem bestimmten Repository installieren, für das Sie Administratorrechte haben oder das sich im Besitz Ihrer Organisation befindet. ### Unterschiede zwischen {% data variables.product.prodname_github_app %}s und {% data variables.product.prodname_oauth_app %}s @@ -22,19 +22,19 @@ Weitere Informationen findest Du unter: - „[{% data variables.product.prodname_oauth_app %}s autorisieren](/articles/authorizing-oauth-apps/)“ - „[Autorisierte Integrationen überprüfen](/articles/reviewing-your-authorized-integrations/)“ -Du kannst eine vorkonfigurierte {% data variables.product.prodname_github_app %} installieren, wenn die Integratoren oder App-Entwickler ihre App mit dem {% data variables.product.prodname_github_app %}-Manifest-Flow erstellt haben. Weitere Informationen zum Ausführen Deiner {% data variables.product.prodname_github_app %} mit automatisierter Konfiguration erhältst Du vom Integrator oder App-Entwickler. +Sie können eine vorkonfigurierte {% data variables.product.prodname_github_app %} installieren, wenn die Integratoren oder App-Entwickler ihre App mit dem {% data variables.product.prodname_github_app %}-Manifest-Flow erstellt haben. Weitere Informationen zum Ausführen Ihrer {% data variables.product.prodname_github_app %} mit automatisierter Konfiguration erhalten Sie vom Integrator oder App-Entwickler. -Du kannst eine {% data variables.product.prodname_github_app %} mit vereinfachter Konfiguration erstellen, wenn Du Deine App mit Probot erstellst. Weitere Informationen findest Du auf der [Probot Docs](https://probot.github.io/docs/)-Website. +Sie können eine {% data variables.product.prodname_github_app %} mit vereinfachter Konfiguration erstellen, wenn Sie Ihre App mit Probot erstellen. Weitere Informationen findest Du auf der [Probot Docs](https://probot.github.io/docs/)-Website. ### Integrationen auf {% data variables.product.prodname_marketplace %} entdecken -Auf {% data variables.product.prodname_marketplace %} kannst Du eine Integration zur Installation finden oder Deine eigene Integration veröffentlichen. +Auf {% data variables.product.prodname_marketplace %} können Sie eine Integration zur Installation finden oder Ihre eigene Integration veröffentlichen. [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace) enthält {% data variables.product.prodname_github_app %}s und {% data variables.product.prodname_oauth_app %}s. Weitere Informationen zum Finden einer Integration oder zum Erstellen einer eigenen Integration findest Du unter „[Informationen zu {% data variables.product.prodname_marketplace %}](/articles/about-github-marketplace).“ ### Direkt von Integratoren bezogene Integrationen -Einige Integrationen kannst Du auch direkt von Integratoren beziehen. Wenn Du als Organisationsmitglied eine {% data variables.product.prodname_github_app %} findest, die Du verwenden möchtest, kannst Du beantragen, dass die Organisation die App für die Organisation genehmigt und installiert. +Einige Integrationen kannst Du auch direkt von Integratoren beziehen. Wenn Sie als Organisationsmitglied eine {% data variables.product.prodname_github_app %} finden, die Sie verwenden möchten, können Sie beantragen, dass eine Organisation die App für die Organisation genehmigt und installiert. Wenn Du über Administratorberechtigungen für alle organisationseigenen Repositorys verfügst, auf denen die App installiert ist, kannst Du {% data variables.product.prodname_github_app %}s mit Berechtigungen auf Repository-Ebene installieren, ohne einen Organisationsinhaber um die Genehmigung der App bitten zu müssen. Wenn ein Integrator die Berechtigungen einer App ändert und die Berechtigungen nur für ein Repository gelten, können Organisationsinhaber und Personen mit Administratorberechtigungen für ein Repository, in dem diese App installierte ist, die neuen Berechtigungen überprüfen und akzeptieren. diff --git a/translations/de-DE/content/github/customizing-your-github-workflow/exploring-integrations.md b/translations/de-DE/content/github/customizing-your-github-workflow/exploring-integrations.md index 2d982aade4a1..48b2d121ae38 100644 --- a/translations/de-DE/content/github/customizing-your-github-workflow/exploring-integrations.md +++ b/translations/de-DE/content/github/customizing-your-github-workflow/exploring-integrations.md @@ -1,6 +1,6 @@ --- title: Integrationen erkunden -intro: 'Du kannst Deinen {% data variables.product.product_name %}-Workflow mit den Tools und Diensten der {% data variables.product.product_name %}-Community anpassen und erweitern.' +intro: 'Sie können Ihren {% data variables.product.product_name %}-Workflow mit den Tools und Diensten der {% data variables.product.product_name %}-Community anpassen und erweitern.' mapTopic: true redirect_from: - /articles/exploring-integrations diff --git a/translations/de-DE/content/github/customizing-your-github-workflow/github-extensions-and-integrations.md b/translations/de-DE/content/github/customizing-your-github-workflow/github-extensions-and-integrations.md index 33ada1f892d3..cc8fb610157e 100644 --- a/translations/de-DE/content/github/customizing-your-github-workflow/github-extensions-and-integrations.md +++ b/translations/de-DE/content/github/customizing-your-github-workflow/github-extensions-and-integrations.md @@ -1,6 +1,6 @@ --- title: GitHub-Erweiterungen und -Integrationen -intro: 'Mit {% data variables.product.product_name %}-Erweiterungen kannst Du problemlos in {% data variables.product.product_name %}-Repositorys mit Anwendungen von Drittanbietern zusammenarbeiten.' +intro: 'Mit {% data variables.product.product_name %}-Erweiterungen können Sie problemlos in {% data variables.product.product_name %}-Repositorys mit Anwendungen von Drittanbietern zusammenarbeiten.' redirect_from: - /articles/about-github-extensions-for-third-party-applications/ - /articles/github-extensions-and-integrations diff --git a/translations/de-DE/content/github/customizing-your-github-workflow/installing-an-app-in-your-organization.md b/translations/de-DE/content/github/customizing-your-github-workflow/installing-an-app-in-your-organization.md index 69341eee1e5b..ebf5b8eae15a 100644 --- a/translations/de-DE/content/github/customizing-your-github-workflow/installing-an-app-in-your-organization.md +++ b/translations/de-DE/content/github/customizing-your-github-workflow/installing-an-app-in-your-organization.md @@ -1,6 +1,6 @@ --- title: Eine App in Deiner Organisation installieren -intro: 'Du kannst Apps von {% data variables.product.prodname_marketplace %} zur Verwendung in Deiner Organisation installieren.' +intro: 'Sie können Apps von {% data variables.product.prodname_marketplace %} zur Verwendung in Ihrer Organisation installieren.' redirect_from: - /articles/installing-an-app-in-your-organization versions: @@ -15,7 +15,7 @@ Wenn Du einen kostenpflichtigen Plan auswählst, bezahlst Du für das App-Abonne {% data reusables.marketplace.free-trials %} -### Eine {% data variables.product.prodname_github_app %} in Deiner Organisation installieren +### Eine {% data variables.product.prodname_github_app %} in Ihrer Organisation installieren {% data reusables.marketplace.visit-marketplace %} {% data reusables.marketplace.browse-to-app %} @@ -28,7 +28,7 @@ Wenn Du einen kostenpflichtigen Plan auswählst, bezahlst Du für das App-Abonne {% data reusables.marketplace.select-installation-repos %} {% data reusables.marketplace.review-app-perms-install %} -### Eine {% data variables.product.prodname_oauth_app %} in Deiner Organisation erstellen +### Eine {% data variables.product.prodname_oauth_app %} in Ihrer Organisation erstellen {% data reusables.saml.saml-session-oauth %} diff --git a/translations/de-DE/content/github/customizing-your-github-workflow/installing-an-app-in-your-personal-account.md b/translations/de-DE/content/github/customizing-your-github-workflow/installing-an-app-in-your-personal-account.md index 682d67239709..9e964c879aa0 100644 --- a/translations/de-DE/content/github/customizing-your-github-workflow/installing-an-app-in-your-personal-account.md +++ b/translations/de-DE/content/github/customizing-your-github-workflow/installing-an-app-in-your-personal-account.md @@ -1,6 +1,6 @@ --- title: Eine App in Deinem persönlichen Konto installieren -intro: 'Du kannst Apps von {% data variables.product.prodname_marketplace %} zur Verwendung in Deinem persönlichen Konto installieren.' +intro: 'Sie können Apps von {% data variables.product.prodname_marketplace %} zur Verwendung in Ihrem persönlichen Konto installieren.' redirect_from: - /articles/installing-an-app-in-your-personal-account versions: @@ -13,7 +13,7 @@ Wenn Du einen kostenpflichtigen Plan auswählst, bezahlst Du für das App-Abonne {% data reusables.marketplace.free-trials %} -### Eine {% data variables.product.prodname_github_app %} in Deinem persönlichen Konto erstellen +### Eine {% data variables.product.prodname_github_app %} in Ihrem persönlichen Konto erstellen {% data reusables.marketplace.visit-marketplace %} {% data reusables.marketplace.browse-to-app %} @@ -26,7 +26,7 @@ Wenn Du einen kostenpflichtigen Plan auswählst, bezahlst Du für das App-Abonne {% data reusables.marketplace.select-installation-repos %} {% data reusables.marketplace.review-app-perms-install %} -### Eine {% data variables.product.prodname_oauth_app %} in Deinem persönlichen Konto installieren +### Eine {% data variables.product.prodname_oauth_app %} in Ihrem persönlichen Konto installieren {% data reusables.saml.saml-session-oauth %} diff --git a/translations/de-DE/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md b/translations/de-DE/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md new file mode 100644 index 000000000000..0871503bf376 --- /dev/null +++ b/translations/de-DE/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md @@ -0,0 +1,27 @@ +--- +title: About billing for Codespaces +intro: 'When {% data variables.product.prodname_codespaces %} becomes generally available, you will be billed for storage and compute usage.' +product: '{% data reusables.gated-features.codespaces %}' +versions: + free-pro-team: '*' +--- + +{% data reusables.codespaces.release-stage %} + +{% data reusables.codespaces.about-billing-for-codespaces %} + +Compute costs are incurred only when a codespace is active. When you're using a codespace, the codespace is active. After 30 minutes of inactivity, a codespace becomes suspended automatically. + +Compute usage is billed per hour, at a rate that depends on your codespace's instance type. During the beta, {% data variables.product.prodname_codespaces %} offers a single, Linux instance type. At general availability, we'll support three Linux instance types. + +| Instance Type (Linux) | Per-hour rate | +| --------------------------------------- | ------------- | +| Basic (2 cores, 4GB RAM, 32 GB SSD) | $0.085 | +| Standard (4 cores, 8 GB RAM, 32 GB SSD) | $0.169 | +| Premium (8 cores, 16 GB RAM, 32 GB SSD) | $0.339 | + +Compute pricing may vary for additional instance types and operating systems supported in the future. + +Each codespace also incurs monthly storage costs until you delete the codespace. Storage costs for all instance types are $0.10/GB-month. + +We'll share more information about any compute and storage usage included in each plan at general availability. diff --git a/translations/de-DE/content/github/developing-online-with-codespaces/about-codespaces.md b/translations/de-DE/content/github/developing-online-with-codespaces/about-codespaces.md index 1c0f704aed6a..d7c5252b3575 100644 --- a/translations/de-DE/content/github/developing-online-with-codespaces/about-codespaces.md +++ b/translations/de-DE/content/github/developing-online-with-codespaces/about-codespaces.md @@ -44,7 +44,7 @@ Jeder Entwickler kann ein oder mehrere Codespaces für jedes öffentliche Reposi ### Informationen zur Abrechnung für {% data variables.product.prodname_codespaces %} -During the limited public beta, {% data variables.product.prodname_codespaces %} is free to use and users are limited to 2 codespaces. Die Pläne und Preise werden vor der allgemeinen Verfügbarkeit bekannt gegeben. +{% data reusables.codespaces.about-billing-for-codespaces %} Weitere Informationen findest Du unter „[Informationen zur Abrechnung für {% data variables.product.prodname_codespaces %}](/github/developing-online-with-codespaces/about-billing-for-codespaces)“. ### Der Beta-Phase beitreten diff --git a/translations/de-DE/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md b/translations/de-DE/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md index 8f8cc2b14a98..334febbf88a6 100644 --- a/translations/de-DE/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md +++ b/translations/de-DE/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md @@ -1,6 +1,6 @@ --- title: Codespace für Dein Projekt konfigurieren -intro: 'Du kannst für jeden neuen Codespace in Deinem Repository eine Standardkonfiguration einrichten, um sicherzustellen, dass die Mitwirkenden alle Werkzeuge und Einstellung haben, die sie für ihre Online-Entwicklungsumgebung benötigen.' +intro: Du kannst für jeden neuen Codespace in Deinem Repository eine Standardkonfiguration einrichten, um sicherzustellen, dass die Mitwirkenden alle Werkzeuge und Einstellung haben, die sie für ihre Online-Entwicklungsumgebung benötigen. product: '{% data reusables.gated-features.codespaces %}' permissions: Personen mit Schreibberechtigung in einem Repository können die Standard-Codespace-Konfiguration erstellen oder bearbeiten. redirect_from: @@ -21,7 +21,9 @@ If you don't define a configuration in your repository, {% data variables.produc Du kannst mittels einer vordefinierten Container-Konfiguration für Deinen Projekttyp eine Standard-Codespace-Konfiguration erstellen, oder Du kannst eine benutzerdefinierte Konfiguration erstellen, die auf die Bedürfnisse Deines Projektes zugeschnitten ist. -{% data variables.product.prodname_codespaces %} verwendet Einstellungen in einer Datei namens `devcontainer.json` im Stammverzeichnis des Repositorys oder in einem `.devcontainer`-Ordner. Du kannst `devcontainer.json` verwenden, um Standardeinstellungen für die gesamte Codespace-Umgebung zu setzen, einschließlich dem {% data variables.product.prodname_vscode %}-Editor, oder Du setzt spezifische Editor-Einstellungen in einer Datei namens `.vscode/settings.json`. +{% data variables.product.prodname_codespaces %} uses settings contained in a configuration file named `devcontainer.json`. {% data reusables.codespaces.devcontainer-location %} + +You can use your `devcontainer.json` to set default settings for the entire codespace environment, including the {% data variables.product.prodname_vscode %} editor, but you can also set editor-specific settings in a file named `.vscode/settings.json`. Änderungen an der Codespace-Konfiguration eines Repository gelten nur für für alle neuen Codespaces und beeinflussen die bereits vorhandenen Codespaces nicht. @@ -38,7 +40,9 @@ Jeder neue Codespace, der aus einem Branch mit einem `.devcontainer`-Verzeichnis ### Erstellen einer benutzerdefinierten Codespace-Konfiguration -Wenn keine der vorgefertigten Konfigurationen Deine Bedürfnisse abdeckt, kannst Du eine benutzerdefinierte Konfiguration erstellen, indem Du die `devcontainer.json`-Datei ins Stammverzeichnis Deines Repositorys oder in ein `.devcontainer`-Verzeichnis hinzufügst. In der Datei kannst Du unterstützte Konfigurationsschlüssel verwenden, um Aspekte der Codespace-Umgebung festzulegen, beispielsweise welche {% data variables.product.prodname_vscode %}-Erweiterungen installiert werden sollen. +If none of the pre-built configurations meet your needs, you can create a custom configuration by adding a `devcontainer.json` file. {% data reusables.codespaces.devcontainer-location %} + +In der Datei kannst Du unterstützte Konfigurationsschlüssel verwenden, um Aspekte der Codespace-Umgebung festzulegen, beispielsweise welche {% data variables.product.prodname_vscode %}-Erweiterungen installiert werden sollen. {% data reusables.codespaces.vscode-settings-order %} diff --git a/translations/de-DE/content/github/developing-online-with-codespaces/creating-a-codespace.md b/translations/de-DE/content/github/developing-online-with-codespaces/creating-a-codespace.md index 027d9ef56035..feee8156fc26 100644 --- a/translations/de-DE/content/github/developing-online-with-codespaces/creating-a-codespace.md +++ b/translations/de-DE/content/github/developing-online-with-codespaces/creating-a-codespace.md @@ -1,6 +1,6 @@ --- title: Erstellen eines Codespace -intro: 'Du kannst einen Codespace in einem Repository-Branch erstellen, um Online zu entwickeln.' +intro: Du kannst einen Codespace in einem Repository-Branch erstellen, um Online zu entwickeln. product: '{% data reusables.gated-features.codespaces %}' permissions: 'Jeder kann einen Codespace für jedes öffentliche Repository erstellen, oder für jedes Repository, das seinem Benutzerkonto gehört.' redirect_from: diff --git a/translations/de-DE/content/github/developing-online-with-codespaces/deleting-a-codespace.md b/translations/de-DE/content/github/developing-online-with-codespaces/deleting-a-codespace.md index 8eadfc66cf59..deeb5652839c 100644 --- a/translations/de-DE/content/github/developing-online-with-codespaces/deleting-a-codespace.md +++ b/translations/de-DE/content/github/developing-online-with-codespaces/deleting-a-codespace.md @@ -1,8 +1,8 @@ --- title: Einen Codespace löschen -intro: 'Du kannst einen Codespace löschen, wenn Du ihn nicht länger benötigst.' +intro: Du kannst einen Codespace löschen, wenn Du ihn nicht länger benötigst. product: '{% data reusables.gated-features.codespaces %}' -permissions: 'Jeder kann einen Codespace löschen, der seinem Benutzerkonto gehört.' +permissions: Jeder kann einen Codespace löschen, der seinem Benutzerkonto gehört. redirect_from: - /github/developing-online-with-github-codespaces/deleting-a-codespace versions: diff --git a/translations/de-DE/content/github/developing-online-with-codespaces/developing-in-a-codespace.md b/translations/de-DE/content/github/developing-online-with-codespaces/developing-in-a-codespace.md index 4eb25a5c9889..a35feec1a46a 100644 --- a/translations/de-DE/content/github/developing-online-with-codespaces/developing-in-a-codespace.md +++ b/translations/de-DE/content/github/developing-online-with-codespaces/developing-in-a-codespace.md @@ -2,7 +2,7 @@ title: In einem Codespace entwickeln intro: 'Du kannst einen Codespace auf {% data variables.product.product_name %} eröffnen und dann mithilfe der {% data variables.product.prodname_vscode %}-Funktionen entwickeln.' product: '{% data reusables.gated-features.codespaces %}' -permissions: 'Jeder kann in einem Codespace entwickeln, der seinem Benutzerkonto gehört.' +permissions: Jeder kann in einem Codespace entwickeln, der seinem Benutzerkonto gehört. redirect_from: - /github/developing-online-with-github-codespaces/developing-in-a-codespace versions: diff --git a/translations/de-DE/content/github/developing-online-with-codespaces/index.md b/translations/de-DE/content/github/developing-online-with-codespaces/index.md index 21df57fd4a66..1497ebfb4efd 100644 --- a/translations/de-DE/content/github/developing-online-with-codespaces/index.md +++ b/translations/de-DE/content/github/developing-online-with-codespaces/index.md @@ -14,10 +14,12 @@ versions: ### Inhaltsverzeichnis {% link_in_list /about-codespaces %} +{% link_in_list /about-billing-for-codespaces %} {% link_in_list /configuring-codespaces-for-your-project %} {% link_in_list /creating-a-codespace %} {% link_in_list /developing-in-a-codespace %} {% link_in_list /personalizing-codespaces-for-your-account %} {% link_in_list /deleting-a-codespace %} {% link_in_list /troubleshooting-your-codespace %} -{% link_in_list /connecting-to-your-codespace-from-visual-studio-code %} +{% link_in_list /using-codespaces-in-visual-studio-code %} +{% link_in_list /using-codespaces-in-visual-studio %} diff --git a/translations/de-DE/content/github/developing-online-with-codespaces/troubleshooting-your-codespace.md b/translations/de-DE/content/github/developing-online-with-codespaces/troubleshooting-your-codespace.md index e055f6fcd2b7..73af67b6f50f 100644 --- a/translations/de-DE/content/github/developing-online-with-codespaces/troubleshooting-your-codespace.md +++ b/translations/de-DE/content/github/developing-online-with-codespaces/troubleshooting-your-codespace.md @@ -1,6 +1,6 @@ --- title: Fehlerbehebung Deines Codespace -intro: 'Du kannst die Fehler in einem Codespace suchen und beheben, indem Du nach bekannten Issues im `microsoft/vscode`-Repository suchst.' +intro: Du kannst die Fehler in einem Codespace suchen und beheben, indem Du nach bekannten Issues im `microsoft/vscode`-Repository suchst. product: '{% data reusables.gated-features.codespaces %}' redirect_from: - /github/developing-online-with-github-codespaces/troubleshooting-your-codespace diff --git a/translations/de-DE/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md b/translations/de-DE/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md new file mode 100644 index 000000000000..6274df0b2847 --- /dev/null +++ b/translations/de-DE/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md @@ -0,0 +1,45 @@ +--- +title: Using Codespaces in Visual Studio Code +intro: 'Du kannst über {% data variables.product.prodname_vscode %} direkt in Deinem Codespace entwickeln, indem Du die {% data variables.product.prodname_vs_codespaces %}-Erweiterung mit Deinem Konto auf {% data variables.product.product_name %} verbindest.' +product: '{% data reusables.gated-features.codespaces %}' +redirect_from: + - /github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code +versions: + free-pro-team: '*' +--- + +{% data reusables.codespaces.release-stage %} + +### Vorrausetzungen + +Bevor Du über {% data variables.product.prodname_vscode %} direkt in einem Codespace entwickeln kannst, musst Du die {% data variables.product.prodname_vs_codespaces %}-Erweiterung so konfigurieren, dass sie sich zu Deinem {% data variables.product.product_name %}-Konto verbindet. + +1. Du kannst {% data variables.product.prodname_vs %}-Marketplace verwenden, um die [{% data variables.product.prodname_vs_codespaces %}](https://marketplace.visualstudio.com/items?itemName=ms-vsonline.vsonline)-Erweiterung zu installieren. Weitere Informationen findest Du unter „[Marketplace-Erweiterung](https://code.visualstudio.com/docs/editor/extension-gallery)" in der {% data variables.product.prodname_vscode %}-Dokumentation. +2. Klicke in der linken Seitenleiste in {% data variables.product.prodname_vscode %} auf das Symbol „Extensions" (Erweiterungen). ![Das Symbol „Extensions" (Erweiterungen) in {% data variables.product.prodname_vscode %}](/assets/images/help/codespaces/click-extensions-icon-vscode.png) +3. Klicke unterhalb von {% data variables.product.prodname_vs_codespaces %} auf das Symbol „Manage" (Verwalten), und klicke dann auf **Extension Settings** (Erweiterungseinstellungen). ![Option „Extension Settings" (Erweiterungseinstellungen)](/assets/images/help/codespaces/select-extension-settings.png) +4. Verwende das Dropdownmenü „Vsonline: Account Provider" (Vsonline: Kontoanbieter) und wähle {% data variables.product.prodname_dotcom %}. ![Den Kontoanbieter auf {% data variables.product.prodname_dotcom %} setzen](/assets/images/help/codespaces/select-account-provider-vscode.png) +{% data reusables.codespaces.click-remote-explorer-icon-vscode %} +6. Wenn {% data variables.product.prodname_codespaces %} in der Kopfzeile noch nicht ausgewählt ist, klicke auf **{% data variables.product.prodname_codespaces %}**. ![Die {% data variables.product.prodname_codespaces %}-Kopfzeile](/assets/images/help/codespaces/codespaces-header-vscode.png) +7. Klicke auf **Sign in to view {% data variables.product.prodname_codespaces %}...** (Anmelden zur Anzeige von...). ![Anmelden, um {% data variables.product.prodname_codespaces %} anzuzeigen](/assets/images/help/codespaces/sign-in-to-view-codespaces-vscode.png) +8. Um {% data variables.product.prodname_vscode %} für den Zugriff zu Deinem Konto auf {% data variables.product.product_name %} zu autorisieren, klicke auf **Allow** (Genehmigen). +9. Melde Dich bei {% data variables.product.product_name %} an, um die Erweiterung zu genehmigen. + +### Creating a codespace in {% data variables.product.prodname_vscode %} + +After you connect your {% data variables.product.product_name %} account to the {% data variables.product.prodname_vs_codespaces %} extension, you can develop in a codespace that you created on {% data variables.product.product_name %} or in {% data variables.product.prodname_vscode %}. + +{% data reusables.codespaces.click-remote-explorer-icon-vscode %} +2. Click the Add icon, then click **Create New Codespace**. ![The Create new Codespace option in {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/create-codespace-vscode.png) +3. Type, then click the repository's name you want to develop in. ![Searching for repository to create a new {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/choose-repository-vscode.png) +4. Click the branch you want to develop in. ![Searching for a branch to create a new {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/choose-branch-vscode.png) + +### Einen Codespace in {% data variables.product.prodname_vscode %} eröffnen + +{% data reusables.codespaces.click-remote-explorer-icon-vscode %} +2. Klicke unter „Codespaces" auf den Codespace, in dem Du entwickeln willst. +3. Klicke auf das Symbol „Connect to Codespace" (Verbinde zu Codespace). ![Symbol „Connect to Codespace" (Verbinde mit Codespace) in {% data variables.product.prodname_vscode %}](/assets/images/help/codespaces/click-connect-to-codespace-icon-vscode.png) + +### Deleting a codespace in {% data variables.product.prodname_vscode %} + +1. Under Codespaces, right-click the codespace you want to delete. +2. In the drop-down menu, click **Delete Codespace**. ![Deleting a codespace in {% data variables.product.prodname_dotcom %}](/assets/images/help/codespaces/delete-codespace-vscode.png) diff --git a/translations/de-DE/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md b/translations/de-DE/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md new file mode 100644 index 000000000000..2f7d40e74ca1 --- /dev/null +++ b/translations/de-DE/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md @@ -0,0 +1,53 @@ +--- +title: Using Codespaces in Visual Studio +intro: 'You can develop in your codespace directly in {% data variables.product.prodname_vs %} by connecting with your account on {% data variables.product.product_name %}.' +product: '{% data reusables.gated-features.codespaces %}' +versions: + free-pro-team: '*' +--- + +{% note %} + +**Hinweis:** {% data variables.product.prodname_codespaces %} befindet sich derzeit in der eingeschränkten Beta-Phase und kann sich jederzeit verändern. Während der Beta-Phase gibt {% data variables.product.prodname_dotcom %} keine Garantie für die Verfügbarkeit von {% data variables.product.prodname_codespaces %} ab. [Sign up for the limited public beta](https://github.com/features/codespaces/signup-vs). Weitere Informationen zum Beitritt zur Beta-Phase findest Du unter „[Über {% data variables.product.prodname_codespaces %}](/github/developing-online-with-codespaces/about-codespaces#joining-the-beta)." + +{% endnote %} + +### About Codespaces in {% data variables.product.prodname_vs %} + +You can create a codespace in {% data variables.product.prodname_vs %} to develop applications in a Windows environment. When you use a codespace in {% data variables.product.prodname_vs %}, you can browse source code, build solutions, and commit changes to your repository. + +You must create a codespace in {% data variables.product.prodname_vs %} to use it with the application. Codespaces created outside of {% data variables.product.prodname_vs %} can not currently be used with {% data variables.product.prodname_vs %}. + +### Vorrausetzungen + +Before you configure a codespace in {% data variables.product.prodname_vs %}, you must download the latest version of [{% data variables.product.prodname_vs %} Preview](https://aka.ms/vspreview). + +#### Enabling the connection between {% data variables.product.prodname_vs %} and {% data variables.product.prodname_github_codespaces %} + +Connecting to {% data variables.product.prodname_github_codespaces %} with the {% data variables.product.prodname_vs %} Preview is not enabled by default, so you will first need to enable the Preview Features option. + +1. In {% data variables.product.prodname_vs %} Preview, use the Tools drop-down menu, then click **Options**. +2. Under **Environment**, select **Preview Features** and check the **Connect to {% data variables.product.prodname_github_codespaces %}** preview feature. ![Check the Connect to {% data variables.product.prodname_github_codespaces %} preview feature](/assets/images/help/codespaces/connect-to-github-codespaces-preview-feature.png) +3. You will need to restart {% data variables.product.prodname_vs %} for the feature to be available. + +### Creating a codespace in {% data variables.product.prodname_vs %} + +1. When you launch {% data variables.product.prodname_vs %}, the Start Window will show a **Connect to a codespace** button under "Get started". ![Visual Studio Start window with Connect to a codespace](/assets/images/help/codespaces/visual-studio-start-window.png) +2. Click **Connect to a codespace**. +3. Click **Sign in to {% data variables.product.prodname_dotcom %}** and follow the prompts, or click **Create one!** to create a new {% data variables.product.prodname_dotcom %} account and sign into the account. ![Visual Studio sign in to {% data variables.product.prodname_dotcom %}](/assets/images/help/codespaces/visual-studio-sign-in-to-github.png) +4. Under "Codespace details", type the repository's URL you want {% data variables.product.prodname_github_codespaces %} to clone into your codespace. +5. Optionally, use the Instance type and Suspend after drop-down menus to configure more codespace details. ![Visual Studio codespace details](/assets/images/help/codespaces/visual-studio-codespace-details.png) +6. Click **Create and Connect**. {% data variables.product.prodname_github_codespaces %} will begin preparing the codespace and open {% data variables.product.prodname_vs %} after the codespace is ready. The codespace name will appear in the remote indicator in the menu. ![Visual Studio connected to eShopOnWeb repository codespace](/assets/images/help/codespaces/visual-studio-eshoponweb-codespace.png) + +### Einen Codespace in {% data variables.product.prodname_vs %} eröffnen + +1. Use the File drop-down menu, and click **Connect to a Codespace**. ![Visual Studio File Connect to a codespace menu item](/assets/images/help/codespaces/visual-studio-file-connect-to-codespace.png) +2. Under "{% data variables.product.prodname_github_codespaces %}", click the codespace you want to connect to, then click **Connect**. ![Visual Studio displaying available codespaces and details](/assets/images/help/codespaces/visual-studio-connect-codespace.png) + +### Configuring a codespace for {% data variables.product.prodname_vs %} + +The default codespace environment created by {% data variables.product.prodname_vs %} includes popular frameworks and tools such as .NET Core, Microsoft SQL Server, Python, and the Windows SDK. {% data variables.product.prodname_github_codespaces %} created with {% data variables.product.prodname_vs %} can be customized through a subset of `devcontainers.json` properties and a new tool called devinit, included with {% data variables.product.prodname_vs %}. + +#### devinit + +The [devinit](https://docs.microsoft.com/visualstudio/devinit/getting-started-with-devinit) command-line tool lets you install additional frameworks and tools into your Windows development codespaces, as well as run PowerShell scripts or modify environment variables. devinit supports a configuration file called [devinit.json](https://docs.microsoft.com/visualstudio/devinit/devinit-json), which can be added to your project for creating customized and repeatable development environments. For more information about Windows codespace configuration and devinit, see [Customize a codespace](https://docs.microsoft.com/visualstudio/ide/codespaces/customize-codespaces) in the {% data variables.product.prodname_vs %} documentation. diff --git a/translations/de-DE/content/github/extending-github/about-webhooks.md b/translations/de-DE/content/github/extending-github/about-webhooks.md index 1a52c4f7ed7e..be534c7e9681 100644 --- a/translations/de-DE/content/github/extending-github/about-webhooks.md +++ b/translations/de-DE/content/github/extending-github/about-webhooks.md @@ -5,7 +5,7 @@ redirect_from: - /articles/post-receive-hooks/ - /articles/creating-webhooks/ - /articles/about-webhooks -intro: 'Webhooks bieten die Möglichkeit, Benachrichtigungen an einen externen Webserver zu senden, wenn bestimmte Aktionen in einem Repository oder in einer Organisation auftreten.' +intro: Webhooks bieten die Möglichkeit, Benachrichtigungen an einen externen Webserver zu senden, wenn bestimmte Aktionen in einem Repository oder in einer Organisation auftreten. versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/de-DE/content/github/extending-github/getting-started-with-the-api.md b/translations/de-DE/content/github/extending-github/getting-started-with-the-api.md index 61d0ab5db87b..353de4ad01b9 100644 --- a/translations/de-DE/content/github/extending-github/getting-started-with-the-api.md +++ b/translations/de-DE/content/github/extending-github/getting-started-with-the-api.md @@ -9,9 +9,9 @@ versions: Du kannst das {% data variables.product.product_name %}-API einsetzen, um allgemeine Aufgaben zu automatisieren, Deine Daten zu sichern oder Integrationen zu erstellen, welche {% data variables.product.product_name %} erweitern. -For more information about the API, see the [GitHub REST API](/rest) and [GitHub GraphQL API](/graphql). Um aktuelle Informationen zu APIs zu erhalten, kannst Du auch dem [{% data variables.product.prodname_dotcom %}-Entwicklerblog](https://developer.github.com/changes/) folgen. +For more information about the API, see the [GitHub REST API](/rest) and [GitHub GraphQL API](/graphql). Um aktuelle Informationen zu APIs zu erhalten, können Sie auch auch dem [{% data variables.product.prodname_dotcom %}-Entwicklerblog](https://developer.github.com/changes/) folgen. ### Weiterführende Informationen -- „[Ein Repository sichern](/articles/backing-up-a-repository)"{% if currentVersion == "free-pro-team@latest" %} +- "[Backing up a repository](/articles/backing-up-a-repository)"{% if currentVersion == "free-pro-team@latest" %} - „[Informationen zu Integrationen](/articles/about-integrations)“{% endif %} diff --git a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md index defb7d667560..ff27712b4928 100644 --- a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md +++ b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md @@ -18,7 +18,7 @@ versions: You can use {% data variables.product.prodname_code_scanning %} to find, triage, and prioritize fixes for existing problems in your code. {% data variables.product.prodname_code_scanning_capc %} also prevents developers from introducing new problems. You can schedule scans for specific days and times, or trigger scans when a specific event occurs in the repository, such as a push. -If {% data variables.product.prodname_code_scanning %} finds a potential vulnerability or error in your code, {% data variables.product.prodname_dotcom %} displays an alert in the repository. After you fix the code that triggered the alert, {% data variables.product.prodname_dotcom %} closes the alert. For more information, see "[Managing alerts from {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." +If {% data variables.product.prodname_code_scanning %} finds a potential vulnerability or error in your code, {% data variables.product.prodname_dotcom %} displays an alert in the repository. After you fix the code that triggered the alert, {% data variables.product.prodname_dotcom %} closes the alert. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." To monitor results from {% data variables.product.prodname_code_scanning %} across your repositories or your organization, you can use the {% data variables.product.prodname_code_scanning %} API. For more information about API endpoints, see "[{% data variables.product.prodname_code_scanning_capc %}](/v3/code-scanning)." diff --git a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md index f635bd8d2a46..fdbab9030d3b 100644 --- a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md +++ b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md @@ -1,7 +1,7 @@ --- title: About integration with code scanning shortTitle: About integration -intro: 'You can perform {% data variables.product.prodname_code_scanning %} externally and then display the results in {% data variables.product.prodname_dotcom %}.' +intro: 'You can perform {% data variables.product.prodname_code_scanning %} externally and then display the results in {% data variables.product.prodname_dotcom %}, or set up webhooks that listen to {% data variables.product.prodname_code_scanning %} activity in your repository.' product: '{% data reusables.gated-features.code-scanning %}' versions: free-pro-team: '*' @@ -11,14 +11,16 @@ versions: {% data reusables.code-scanning.beta %} {% data reusables.code-scanning.enterprise-enable-code-scanning %} -As an alternative to running {% data variables.product.prodname_code_scanning %} within {% data variables.product.prodname_dotcom %}, you can perform analysis elsewhere and then upload the results. Alerts for {% data variables.product.prodname_code_scanning %} that you run externally are displayed in the same way as those for {% data variables.product.prodname_code_scanning %} that you run within {% data variables.product.prodname_dotcom %}. For more information, see "[Managing alerts from code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." - -You can use your continuous integration or continuous delivery/deployment (CI/CD) system to run {% data variables.product.prodname_dotcom %}'s {% data variables.product.prodname_codeql %} analysis and upload the results to {% data variables.product.prodname_dotcom %}. This is an alternative to using {% data variables.product.prodname_actions %} to run {% data variables.product.prodname_codeql %} analysis. For more information, see "[Running code scanning in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)." +As an alternative to running {% data variables.product.prodname_code_scanning %} within {% data variables.product.prodname_dotcom %}, you can perform analysis elsewhere and then upload the results. Alerts for {% data variables.product.prodname_code_scanning %} that you run externally are displayed in the same way as those for {% data variables.product.prodname_code_scanning %} that you run within {% data variables.product.prodname_dotcom %}. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." If you use a third-party static analysis tool that can produce results as Static Analysis Results Interchange Format (SARIF) 2.1.0 data, you can upload this to {% data variables.product.prodname_dotcom %}. For more information, see "[Uploading a SARIF file to GitHub](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)." +### Integrations with webhooks + +You can use {% data variables.product.prodname_code_scanning %} webhooks to build or set up integrations, such as [{% data variables.product.prodname_github_app %}s](/apps/building-github-apps/) or [{% data variables.product.prodname_oauth_app %}s](/apps/building-oauth-apps/), that subscribe to {% data variables.product.prodname_code_scanning %} events in your repository. For example, you could build an integration that creates an issue on {% data variables.product.product_location %} or sends you a Slack notification when a new {% data variables.product.prodname_code_scanning %} alert is added in your repository. For more information, see "[Creating webhooks](/developers/webhooks-and-events/creating-webhooks)" and "[Webhook events and payloads](/developers/webhooks-and-events/webhook-events-and-payloads#code_scanning_alert)." + ### Weiterführende Informationen -* "[About code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)" -* "[Configuring code scanning in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-in-your-ci-system)" -* "[SARIF support for code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning)" +* "[About {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)" +* "[Using {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} with your existing CI system +* "[SARIF support for {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning)" diff --git a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md index 4535465abcb6..e226912fd50a 100644 --- a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md +++ b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md @@ -3,6 +3,7 @@ title: Automatically scanning your code for vulnerabilities and errors shortTitle: Scanning automatically intro: 'You can find vulnerabilities and errors in your project''s code on {% data variables.product.prodname_dotcom %}.' mapTopic: true +product: '{% data reusables.gated-features.code-scanning %}' versions: free-pro-team: '*' enterprise-server: '>=2.22' diff --git a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md index 7b2d59c7afa9..af2300e7a3c5 100644 --- a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md +++ b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md @@ -12,48 +12,49 @@ versions: {% data reusables.code-scanning.beta %} {% data reusables.code-scanning.enterprise-enable-code-scanning-actions %} - ### About {% data variables.product.prodname_code_scanning %} configuration -You can run {% data variables.product.prodname_code_scanning %} within {% data variables.product.product_location %}, using {% data variables.product.prodname_actions %}, or from your continuous integration (CI) system, using the {% data variables.product.prodname_codeql_runner %}. Before you can configure {% data variables.product.prodname_code_scanning %} for a repository, you must enable {% data variables.product.prodname_code_scanning %} by adding a {% data variables.product.prodname_actions %} workflow to the repository. For more information about the {% data variables.product.prodname_codeql_runner %}, see "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)." +You can run {% data variables.product.prodname_code_scanning %} within {% data variables.product.product_location %}, using {% data variables.product.prodname_actions %}, or from your continuous integration (CI) system, using the {% data variables.product.prodname_codeql_runner %}. For more information about {% data variables.product.prodname_actions %}, see "[About {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)." For more information about the {% data variables.product.prodname_codeql_runner %}, see "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)." -The following query suites are built into {% data variables.product.prodname_code_scanning %} and available for use in your configuration file. +This article is about running {% data variables.product.prodname_code_scanning %} within {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_ghe_server %}{% else %}{% data variables.product.prodname_dotcom %}{% endif %}. -Before you can configure {% data variables.product.prodname_code_scanning %} for a repository, you must enable {% data variables.product.prodname_code_scanning %} by adding a {% data variables.product.prodname_actions %} workflow to the repository. The default {% data variables.product.prodname_code_scanning %} workflow uses the `on.push` event to trigger a code scan on every push to any branch containing the workflow file. +Before you can configure {% data variables.product.prodname_code_scanning %} for a repository, you must enable {% data variables.product.prodname_code_scanning %} by adding a {% data variables.product.prodname_actions %} workflow to the repository. For more information, see "[Enabling {% data variables.product.prodname_code_scanning %} for a repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository)." {% data reusables.code-scanning.edit-workflow %} -You can write a configuration file for {% data variables.product.prodname_code_scanning %}. {% data variables.product.prodname_marketplace %}{% if currentVersion ver_gt "enterprise-server@2.21" %} on {% data variables.product.prodname_dotcom_the_website %}{% endif %} contains other {% data variables.product.prodname_code_scanning %} workflows you can use. {% if currentVersion == "free-pro-team@latest" %}You can find a selection of these on the "Get started with {% data variables.product.prodname_code_scanning %}" page, which you can access from the **{% octicon "shield" aria-label="The shield symbol" %} Security** tab.{% endif %} The specific examples given in this article relate to the {% data variables.product.prodname_codeql_workflow %} file. +{% data variables.product.prodname_codeql %} analysis is just one type of {% data variables.product.prodname_code_scanning %} you can do in {% data variables.product.prodname_dotcom %}. {% data variables.product.prodname_marketplace %}{% if currentVersion ver_gt "enterprise-server@2.21" %} on {% data variables.product.prodname_dotcom_the_website %}{% endif %} contains other {% data variables.product.prodname_code_scanning %} workflows you can use. {% if currentVersion == "free-pro-team@latest" %}You can find a selection of these on the "Get started with {% data variables.product.prodname_code_scanning %}" page, which you can access from the **{% octicon "shield" aria-label="The shield symbol" %} Security** tab.{% endif %} The specific examples given in this article relate to the {% data variables.product.prodname_codeql_workflow %} file. -### Editing a code scanning workflow +### Editing a {% data variables.product.prodname_code_scanning %} workflow -{% data variables.product.prodname_dotcom %} saves workflow files in the `.github/workflows` directory of your repository. You can find the workflow by searching for its file name. For example, the default workflow file for CodeQL code scanning is called `codeql-analysis.yml`. +{% data variables.product.prodname_dotcom %} saves workflow files in the _.github/workflows_ directory of your repository. You can find a workflow you have enabled by searching for its file name. For example, by default, the workflow file for {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} is called _codeql-analysis.yml_. -1. Navigiere in Deinem Repository zu der Workflow-Datei, die Du bearbeiten möchtest. -1. Um den Workflow-Editor zu öffnen, klickst Du in der oberen rechten Ecke der Dateiansicht auf {% octicon "pencil" aria-label="The edit icon" %}. ![Schaltfläche zum Editieren der Workflow-Datei](/assets/images/help/repository/code-scanning-edit-workflow-button.png) -1. After you have edited the file, click **Start commit** and complete the "Commit changes" form. You can choose to commit directly to the current branch, or create a new branch and start a pull request. ![Commit update to codeql.yml workflow](/assets/images/help/repository/code-scanning-workflow-update.png) +1. In your repository, browse to the workflow file you want to edit. +1. In the upper right corner of the file view, to open the workflow editor, click {% octicon "pencil" aria-label="The edit icon" %}. +![Edit workflow file button](/assets/images/help/repository/code-scanning-edit-workflow-button.png) +1. After you have edited the file, click **Start commit** and complete the "Commit changes" form. You can choose to commit directly to the current branch, or create a new branch and start a pull request. +![Commit update to codeql.yml workflow](/assets/images/help/repository/code-scanning-workflow-update.png) -For more information about editing workflow files, see "[Configuring a workflow](/actions/configuring-and-managing-workflows/configuring-a-workflow)." +For more information about editing workflow files, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." ### Configuring frequency -You can scan code on a schedule or when specific events occur in a repository. +You can configure the {% data variables.product.prodname_codeql_workflow %} to scan code on a schedule or when specific events occur in a repository. -Scanning code on every push to the repository, and every time a pull request is created, prevents developers from introducing new vulnerabilities and errors into the code. Scanning code on a schedule informs you about the latest vulnerabilities and errors that {% data variables.product.company_short %}, security researchers, and the community discover, even when developers aren't actively maintaining the repository. +Scanning code when someone pushes a change, and whenever a pull request is created, prevents developers from introducing new vulnerabilities and errors into the code. Scanning code on a schedule informs you about the latest vulnerabilities and errors that {% data variables.product.company_short %}, security researchers, and the community discover, even when developers aren't actively maintaining the repository. #### Scanning on push -If you use the default workflow, {% data variables.product.prodname_code_scanning %} will scan the code in your repository once a week, in addition to the scans triggered by events. To adjust this schedule, edit the `cron` value in the workflow. Weitere Informationen findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#on)“. +By default, the {% data variables.product.prodname_codeql_workflow %} uses the `on.push` event to trigger a code scan on every push to the default branch of the repository and any protected branches. For {% data variables.product.prodname_code_scanning %} to be triggered on a specified branch, the workflow must exist in that branch. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#on)." #### Scanning pull requests -**Note**: The `paths` and `paths-ignore` keywords, used in the context of the {% data variables.product.prodname_code_scanning %} configuration file, should not be confused with the same keywords when used for `on..paths`. When they are used to modify `on.` in a workflow file, they determine whether the actions will be run when someone modifies code in the specified directories. Weitere Informationen findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)“. +The default {% data variables.product.prodname_codeql_workflow %} uses the `pull_request` event to trigger a code scan on the `HEAD` commit of a pull request against the default branch. {% if currentVersion ver_gt "enterprise-server@2.21" %}The `pull_request` event is not triggered if the pull request was opened from a private fork.{% else %}If a pull request is from a private fork, the `pull_request` event will only be triggered if you've selected the "Run workflows from fork pull requests" option in the repository settings. For more information, see "[Disabling or limiting {% data variables.product.prodname_actions %} for a repository](/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository#enabling-workflows-for-private-repository-forks)."{% endif %} For more information about the `pull_request` event, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)." #### Scanning on a schedule -The default {% data variables.product.prodname_code_scanning %} workflow uses the `pull_request` event to trigger a code scan on the `HEAD` commit of a pull request. To adjust this schedule, edit the `cron` value in the workflow. Weitere Informationen findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onschedule)“. +If you use the default {% data variables.product.prodname_codeql_workflow %}, the workflow will scan the code in your repository once a week, in addition to the scans triggered by events. To adjust this schedule, edit the `cron` value in the workflow. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onschedule)." {% note %} @@ -61,14 +62,16 @@ The default {% data variables.product.prodname_code_scanning %} workflow uses th {% endnote %} -#### Beispiel +#### Example The following example shows a {% data variables.product.prodname_codeql_workflow %} for a particular repository that has a default branch called `main` and one protected branch called `protected`. ``` yaml on: push: + branches: [main, protected] pull_request: + branches: [main] schedule: - cron: '0 15 * * 0' ``` @@ -80,7 +83,9 @@ This workflow scans: ### Specifying an operating system -If your code requires a specific operating system to compile, you can configure this in your workflow. Edit the value of `jobs..runs-on` to specify the operating system for the machine that runs your {% data variables.product.prodname_code_scanning %} actions. {% if currentVersion ver_gt "enterprise-server@2.21" %}You specify the operating system by using an appropriate label as the second element in a two-element array, after `self-hosted`. +If your code requires a specific operating system to compile, you can configure the operating system in your {% data variables.product.prodname_codeql_workflow %}. Edit the value of `jobs.analyze.runs-on` to specify the operating system for the machine that runs your {% data variables.product.prodname_code_scanning %} actions. {% if currentVersion ver_gt "enterprise-server@2.21" %}You specify the operating system by using an appropriate label as the second element in a two-element array, after `self-hosted`.{% else %} + +If you choose to use a self-hosted runner for code scanning, you can specify an operating system by using an appropriate label as the second element in a two-element array, after `self-hosted`.{% endif %} ``` yaml jobs: @@ -88,56 +93,118 @@ jobs: name: Analyze runs-on: [self-hosted, ubuntu-latest] ``` -{% endif %} -{% data variables.product.prodname_code_scanning_capc %} supports the latest versions of macOS, Ubuntu, and Windows. Typical values for this setting are therefore: `ubuntu-latest`, `windows-latest`, and `macos-latest`. For more information, see {% if currentVersion ver_gt "enterprise-server@2.21" %}"[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#self-hosted-runners)" and "[Using labels with self-hosted runners](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners){% else %}"[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on){% endif %}." +{% if currentVersion == "free-pro-team@latest" %}For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners)" and "[Adding self-hosted runners](/actions/hosting-your-own-runners/adding-self-hosted-runners)."{% endif %} -### Overriding automatic language detection +{% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} supports the latest versions of Ubuntu, Windows, and macOS. Typical values for this setting are therefore: `ubuntu-latest`, `windows-latest`, and `macos-latest`. For more information, see {% if currentVersion ver_gt "enterprise-server@2.21" %}"[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#self-hosted-runners)" and "[Using labels with self-hosted runners](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners){% else %}"[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on){% endif %}." -{% data reusables.code-scanning.autobuild-add-build-steps %} For more information about how to configure {% data variables.product.prodname_code_scanning %} for compiled languages, see "[Configuring {% data variables.product.prodname_code_scanning %} for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages)." +{% if currentVersion ver_gt "enterprise-server@2.21" %}You must ensure that Git is in the PATH variable on your self-hosted runners.{% else %}If you use a self-hosted runner, you must ensure that Git is in the PATH variable.{% endif %} + +### Changing the languages that are analyzed + +{% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} automatically detects code written in the supported languages. {% data reusables.code-scanning.supported-languages %} -{% data variables.product.prodname_code_scanning_capc %} automatically detects and scans code written in the supported languages. +The default {% data variables.product.prodname_codeql_workflow %} file contains a build matrix called `language` which lists the languages in your repository that are analyzed. {% data variables.product.prodname_codeql %} automatically populates this matrix when you add {% data variables.product.prodname_code_scanning %} to a repository. Using the `language` matrix optimizes {% data variables.product.prodname_codeql %} to run each analysis in parallel. We recommend that all workflows adopt this configuration due to the performance benefits of parallelizing builds. For more information about build matrices, see "[Managing complex workflows](/actions/learn-github-actions/managing-complex-workflows#using-a-build-matrix)." -To override automatic language detection, add `with:languages:` to the `init` action in your workflow. The keywords for the supported languages are `cpp`, `csharp`, `go`, `java`, `javascript`, and `python`. +{% data reusables.code-scanning.specify-language-to-analyze %} -For example, the following configuration limits {% data variables.product.prodname_code_scanning %} to C/C++, C#, and Python. +If your workflow uses the `language` matrix then {% data variables.product.prodname_codeql %} is hardcoded to analyze only the languages in the matrix. To change the languages you want to analyze, edit the value of the matrix variable. You can remove a language to prevent it being analyzed or you can add a language that was not present in the repository when {% data variables.product.prodname_code_scanning %} was enabled. For example, if the repository initially only contained JavaScript when {% data variables.product.prodname_code_scanning %} was enabled, and you later added Python code, you will need to add `python` to the matrix. -``` yaml +```yaml +jobs: + analyze: + name: Analyze + ... + strategy: + fail-fast: false + matrix: + language: ['javascript', 'python'] +``` + +If your workflow does not contain a matrix called `language`, then {% data variables.product.prodname_codeql %} is configured to run analysis sequentially. If you don't specify languages in the workflow, {% data variables.product.prodname_codeql %} automatically detects, and attempts to analyze, any supported languages in the repository. If you want to choose which languages to analyze, without using a matrix, you can use the `languages` parameter under the `init` action. + +```yaml - uses: github/codeql-action/init@v1 with: languages: cpp, csharp, python -``` +``` +{% if currentVersion == "free-pro-team@latest" %} +### Analyzing Python dependencies + +For GitHub-hosted runners that use Linux only, the {% data variables.product.prodname_codeql_workflow %} will try to auto-install Python dependencies to give more results for the CodeQL analysis. You can control this behavior by specifying the `setup-python-dependencies` parameter for the action called by the "Initialize CodeQL" step. By default, this parameter is set to `true`: + +- If the repository contains code written in Python, the "Initialize CodeQL" step installs the necessary dependencies on the GitHub-hosted runner. If the auto-install succeeds, the action also sets the environment variable `CODEQL_PYTHON` to the Python executable file that includes the dependencies. + +- If the repository doesn't have any Python dependencies, or the dependencies are specified in an unexpected way, you'll get a warning and the action will continue with the remaining jobs. The action can run successfully even when there are problems interpreting dependencies, but the results may be incomplete. + +Alternatively, you can install Python dependencies manually on any operating system. You will need to add `setup-python-dependencies` and set it to `false`, as well as set `CODEQL_PYTHON` to the Python executable that includes the dependencies, as shown in this workflow extract: + +```yaml +jobs: + CodeQL-Build: + + runs-on: ubuntu-latest + + steps: + - name: Checkout repository + uses: actions/checkout@v2 + with: + fetch-depth: 2 + - name: Set up Python + uses: actions/setup-python@v2 + with: + python-version: '3.x' + - name: Install dependencies + run: | + python -m pip install --upgrade pip + if [ -f requirements.txt ]; + then pip install -r requirements.txt; + fi + # Set the `CODEQL-PYTHON` environment variable to the Python executable + # that includes the dependencies + echo "::set-env name=CODEQL_PYTHON::$(which python)" + - run: git checkout HEAD^2 + if: ${{ github.event_name == 'pull_request' }} + - name: Initialize CodeQL + uses: github/codeql-action/init@v1 + with: + languages: python + # Override the default behavior so that the action doesn't attempt + # to auto-install Python dependencies + setup-python-dependencies: false +``` +{% endif %} ### Running additional queries {% data reusables.code-scanning.run-additional-queries %} -To add one or more query suites, add a `queries` section to your configuration file. +To add one or more queries, add a `with: queries:` entry within the `uses: github/codeql-action/init@v1` section of the workflow. ``` yaml - uses: github/codeql-action/init@v1 with: - - queries: COMMA-SEPARATED LIST OF PATHS + queries: COMMA-SEPARATED LIST OF PATHS ``` -You can also run additional query suites by specifying these in a configuration file. Query suites are collections of queries, usually grouped by purpose or language. +You can also specify query suites in the value of `queries`. Query suites are collections of queries, usually grouped by purpose or language. {% data reusables.code-scanning.codeql-query-suites %} -You can run additional queries by specifying these in a configuration file. If you want to run the combined set of additional queries specified here and in the configuration file, prefix the value of `queries` in the workflow with the `+` symbol. For examples of configuration files, see "[Example configuration files](#example-configuration-files)." +If you are also using a configuration file for custom settings, any additional queries specified in your workflow are used instead of any specified in the configuration file. If you want to run the combined set of additional queries specified here and in the configuration file, prefix the value of `queries` in the workflow with the `+` symbol. For more information, see "[Using a custom configuration file](#using-a-custom-configuration-file)." In the following example, the `+` symbol ensures that the specified additional queries are used together with any queries specified in the referenced configuration file. ``` yaml - uses: github/codeql-action/init@v1 with: - - config-file: ./.github/codeql/codeql-config.yml - - queries: +security-and-quality,octo-org/python-qlpack/show_ifs.ql@main + config-file: ./.github/codeql/codeql-config.yml + queries: +security-and-quality,octo-org/python-qlpack/show_ifs.ql@main ``` -### Using a third-party code scanning tool +### Using a custom configuration file As an alternative to specifying which queries to run in the workflow file, you can do this in a separate configuration file. You can also use a configuration file to disable the default queries and to specify which directories to scan during analysis. @@ -150,7 +217,7 @@ In the workflow file, use the `config-file` parameter of the `init` action to sp ``` The configuration file can be located within the local repository, or in a public, remote repository. For remote repositories, you can use the _owner/repository/file.yml@branch_ syntax. The settings in the file are written in YAML format. - + #### Specifying additional queries You specify additional queries in a `queries` array. Each element of the array contains a `uses` parameter with a value that identifies a single query file, a directory containing query files, or a query suite definition file. @@ -168,7 +235,7 @@ For more information about additional queries, see "[Running additional queries] #### Disabling the default queries -If you only want to run custom queries, you can disable the default security queries by adding `disable-default-queries: true` to your configuration file. +If you only want to run custom queries, you can disable the default security queries by using `disable-default-queries: true`. #### Specifying directories to scan @@ -184,16 +251,16 @@ paths-ignore: {% note %} -**Note**: +**Note**: -* The `paths` and `paths-ignore` keywords, used in the context of the {% data variables.product.prodname_code_scanning %} configuration file, should not be confused with the same keywords when used for `on..paths` in a workflow. When they are used to modify `on.` in a workflow, they determine whether the actions will be run when someone modifies code in the specified directories. Weitere Informationen findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)“. -* `**` **Note**: `**` characters can only be at the start or end of a line, or surrounded by slashes, and you can't mix `**` and other characters. For example, `foo/**`, `**/foo`, and `foo/**/bar` are all allowed syntax, but `**foo` isn't. However you can use single stars along with other characters, as shown in the example. You'll need to quote anything that contains a `*` character. +* The `paths` and `paths-ignore` keywords, used in the context of the {% data variables.product.prodname_code_scanning %} configuration file, should not be confused with the same keywords when used for `on..paths` in a workflow. When they are used to modify `on.` in a workflow, they determine whether the actions will be run when someone modifies code in the specified directories. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)." +* `**` characters can only be at the start or end of a line, or surrounded by slashes, and you can't mix `**` and other characters. For example, `foo/**`, `**/foo`, and `foo/**/bar` are all allowed syntax, but `**foo` isn't. However you can use single stars along with other characters, as shown in the example. You'll need to quote anything that contains a `*` character. {% endnote %} -For C/C++, C#, and Java, if you want to limit {% data variables.product.prodname_code_scanning %} to specific directories in your project, you must specify appropriate build steps in the workflow. The commands you need to use to exclude a directory from the build will depend on your build system. For more information, see "[Configuring the {% data variables.product.prodname_codeql %} action for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages#adding-build-steps-for-a-compiled-language)." +For C/C++, C#, and Java, if you want to limit {% data variables.product.prodname_code_scanning %} to specific directories in your project, you must specify appropriate build steps in the workflow. The commands you need to use to exclude a directory from the build will depend on your build system. For more information, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." -You can quickly analyze small portions of a monorepo when you modify code in specific directories. You'll need to both exclude directories in your build steps and use the `paths-ignore` and `paths` keywords for [`on.`](https://help.github.com/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths) in your workflow file. +You can quickly analyze small portions of a monorepo when you modify code in specific directories. You'll need to both exclude directories in your build steps and use the `paths-ignore` and `paths` keywords for [`on.`](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths) in your workflow. #### Example configuration files @@ -201,20 +268,20 @@ You can quickly analyze small portions of a monorepo when you modify code in spe ### Configuring {% data variables.product.prodname_code_scanning %} for compiled languages -{% data reusables.code-scanning.autobuild-compiled-languages %} +{% data reusables.code-scanning.autobuild-compiled-languages %} {% data reusables.code-scanning.analyze-go %} -{% data reusables.code-scanning.autobuild-add-build-steps %} For more information about how to configure {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} for compiled languages, see "[Configuring the {% data variables.product.prodname_codeql %} action for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages)." +{% data reusables.code-scanning.autobuild-add-build-steps %} For more information about how to configure {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} for compiled languages, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages)." ### Accessing private repositories -If your workflow for {% data variables.product.prodname_code_scanning %} accesses private repositories on {% data variables.product.prodname_dotcom %}, you'll need to configure Git to authenticate with a personal access token. Define the secret in the runner environment by using `jobs..steps.env` in your workflow before any {% data variables.product.prodname_codeql %} actions. For more information, see "[Creating a personal access token for the command line](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)" and "[Creating and storing encrypted secrets](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)." +If your workflow for {% data variables.product.prodname_code_scanning %} accesses a private repository, other than the repository that contains the workflow, you'll need to configure Git to authenticate with a personal access token. Define the secret in the runner environment by using `jobs..steps.env` in your workflow before any {% data variables.product.prodname_codeql %} actions. For more information, see "[Creating a personal access token for the command line](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)" and "[Creating and storing encrypted secrets](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)." For example, the following configuration has Git replace the full URLs to the `github/foo`, `github/bar`, and `github/baz` repositories on {% data variables.product.prodname_dotcom_the_website %} with URLs that include the personal access token that you store in the `ACCESS_TOKEN` environment variable. {% raw %} ```yaml steps: -- name: Configure access to private repository on GitHub.com +- name: Configure access to private repositories env: TOKEN: ${{ secrets.ACCESS_TOKEN }} run: | @@ -226,4 +293,4 @@ steps: ### Uploading {% data variables.product.prodname_code_scanning %} data to {% data variables.product.prodname_dotcom %} -You can display code analysis from a third-party tool in {% data variables.product.prodname_dotcom %} by adding the `upload-sarif` action to your workflow. You can upload code analysis data with the `upload-sarif` action. For more information, see "[Uploading a SARIF file to GitHub](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)." +{% data variables.product.prodname_dotcom %} can display code analysis data generated externally by a third-party tool. You can upload code analysis data with the `upload-sarif` action. For more information, see "[Uploading a SARIF file to GitHub](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)." diff --git a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md new file mode 100644 index 000000000000..bd1b1f43ac7c --- /dev/null +++ b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md @@ -0,0 +1,165 @@ +--- +title: Configuring CodeQL code scanning in your CI system +shortTitle: Configuring in your CI +intro: 'You can configure how the {% data variables.product.prodname_codeql_runner %} scans the code in your project and uploads the results to {% data variables.product.prodname_dotcom %}.' +product: '{% data reusables.gated-features.code-scanning %}' +miniTocMaxHeadingLevel: 4 +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-in-your-ci-system +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta-codeql-runner %} +{% data reusables.code-scanning.beta %} +{% data reusables.code-scanning.enterprise-enable-code-scanning %} + +### About configuring {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in your CI system + +To integrate {% data variables.product.prodname_code_scanning %} into your CI system, you can use the {% data variables.product.prodname_codeql_runner %}. For more information, see "[Running {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)." + +In general, you invoke the {% data variables.product.prodname_codeql_runner %} as follows. + +``` +$ /path/to-runner/codeql-runner-OS +``` + +`/path/to-runner/` depends on where you've downloaded the {% data variables.product.prodname_codeql_runner %} on your CI system. `codeql-runner-OS` depends on the operating system you use. There are three versions of the {% data variables.product.prodname_codeql_runner %}, `codeql-runner-linux`, `codeql-runner-macos`, and `codeql-runner-win`, for Linux, macOS, and Windows systems respectively. + +To customize the way the {% data variables.product.prodname_codeql_runner %} scans your code, you can use flags, such as `--languages` and `--queries`, or you can specify custom settings in a separate configuration file. + +### Overriding automatic language detection + +The {% data variables.product.prodname_codeql_runner %} automatically detects and scans code written in the supported languages. + +{% data reusables.code-scanning.supported-languages %} + +{% data variables.product.prodname_code_scanning_capc %} automatically detects and scans code written in the supported languages. + +To override automatic language detection, run the `init` command with the `--languages` flag, followed by a comma-separated list of language keywords. The keywords for the supported languages are `cpp`, `csharp`, `go`, `java`, `javascript`, and `python`. + +``` +$ /path/to-runner/codeql-runner-linux init --languages cpp,java +``` + +### Running additional queries + +{% data reusables.code-scanning.run-additional-queries %} + +{% data reusables.code-scanning.codeql-query-suites %} + +To add one or more queries, pass a comma-separated list of paths to the `--queries` flag of the `init` command. You can also specify additional queries in a configuration file. + +If you also are using a configuration file for custom settings, and you are also specifying additional queries with the `--queries` flag, the {% data variables.product.prodname_codeql_runner %} uses the additional queries specified with the `--queries` flag instead of any in the configuration file. If you want to run the combined set of additional queries specified with the flag and in the configuration file, prefix the value passed to `--queries` with the `+` symbol. For examples of configuration files, see "[Example configuration files](#example-configuration-files)." + +In the following example, the `+` symbol ensures that the {% data variables.product.prodname_codeql_runner %} uses the additional queries together with any queries specified in the referenced configuration file. + +``` +$ /path/to-runner/codeql-runner-linux init --config-file .github/codeql/codeql-config.yml + --queries +security-and-quality,octo-org/python-qlpack/show_ifs.ql@main +``` + +### Using a third-party code scanning tool + +Instead of passing additional information to the {% data variables.product.prodname_codeql_runner %} commands, you can specify custom settings in a separate configuration file. + +The configuration file is a YAML file. It uses syntax similar to the workflow syntax for {% data variables.product.prodname_actions %}, as illustrated in the examples below. Weitere Informationen findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions)“. + +Use the `--config-file` flag of the `init` command to specify the configuration file. The value of `--config-file` is the path to the configuration file that you want to use. This example loads the configuration file _.github/codeql/codeql-config.yml_. + +``` +$ /path/to-runner/codeql-runner-linux init --config-file .github/codeql/codeql-config.yml +``` + +#### Example configuration files + +{% data reusables.code-scanning.example-configuration-files %} + +### Configuring {% data variables.product.prodname_code_scanning %} for compiled languages + +For the compiled languages C/C++, C#, and Java, {% data variables.product.prodname_codeql %} builds the code before analyzing it. {% data reusables.code-scanning.analyze-go %} + +For many common build systems, the {% data variables.product.prodname_codeql_runner %} can build the code automatically. To attempt to build the code automatically, run `autobuild` between the `init` and `analyze` steps. Note that if your repository requires a specific version of a build tool, you may need to install the build tool manually first. + +The `autobuild` process only ever attempts to build _one_ compiled language for a repository. The language automatically selected for analysis is the language with the most files. If you want to choose a language explicitly, use the `--language` flag of the `autobuild` command. + +``` +$ /path/to-runner/codeql-runner-linux autobuild --language csharp +``` + +If the `autobuild` command can't build your code, you can run the build steps yourself, between the `init` and `analyze` steps. For more information, see "[Running {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system#compiled-language-example)." + +### Uploading {% data variables.product.prodname_code_scanning %} data to {% data variables.product.prodname_dotcom %} + +By default, the {% data variables.product.prodname_codeql_runner %} uploads results from {% data variables.product.prodname_code_scanning %} when you run the `analyze` command. You can also upload SARIF files separately, by using the `upload` command. + +Once you've uploaded the data, {% data variables.product.prodname_dotcom %} displays the alerts in your repository. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository#viewing-an-alert)." + +### {% data variables.product.prodname_codeql_runner %} command reference + +The {% data variables.product.prodname_codeql_runner %} supports the following commands and flags. + +#### `init` + +Initializes the {% data variables.product.prodname_codeql_runner %} and creates a {% data variables.product.prodname_codeql %} database for each language to be analyzed. + +| Flag | Erforderlich | Input value | +| -------------------------------- |:------------:| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `--repository` | ✓ | Name of the repository to initialize. | +| `--github-url` | ✓ | URL of the {% data variables.product.prodname_dotcom %} instance where your repository is hosted. | +| `--github-auth` | ✓ | A {% data variables.product.prodname_github_apps %} token or personal access token. | +| `--languages` | | Comma-separated list of languages to analyze. By default, the {% data variables.product.prodname_codeql_runner %} detects and analyzes all supported languages in the repository. | +| `--queries` | | Comma-separated list of additional queries to run, in addition to the default suite of security queries. | +| `--config-file` | | Path to custom configuration file. | +| `--codeql-path` | | Path to a copy of the {% data variables.product.prodname_codeql %} CLI executable to use. By default, the {% data variables.product.prodname_codeql_runner %} downloads a copy. | +| `--temp-dir` | | Directory where temporary files are stored. The default is _./codeql-runner_. | +| `--tools-dir` | | Directory where {% data variables.product.prodname_codeql %} tools and other files are stored between runs. The default is a subdirectory of the home directory. | +| `--checkout-path` | | The path to the checkout of your repository. The default is the current working directory. | +| `--debug` | | None. Prints more verbose output. | +| `-h`, `--help` | | None. Displays help for the command. | + +#### `autobuild` + +Attempts to build the code for the compiled languages C/C++, C#, and Java. For those languages, {% data variables.product.prodname_codeql %} builds the code before analyzing it. Run `autobuild` between the `init` and `analyze` steps. + +| Flag | Erforderlich | Input value | +| --------------------------- |:------------:| ---------------------------------------------------------------------------------------------------------------------------------------------- | +| `--language` | | The language to build. By default, the {% data variables.product.prodname_codeql_runner %} builds the compiled language with the most files. | +| `--temp-dir` | | Directory where temporary files are stored. The default is _./codeql-runner_. | +| `--debug` | | None. Prints more verbose output. | +| `-h`, `--help` | | None. Displays help for the command. | + +#### `analyze` + +Analyzes the code in the {% data variables.product.prodname_codeql %} databases and uploads results to {% data variables.product.product_location %}. + +| Flag | Erforderlich | Input value | +| -------------------------------- |:------------:| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `--repository` | ✓ | Name of the repository to analyze. | +| `--commit` | ✓ | SHA of the commit to analyze. In Git and in Azure DevOps, this corresponds to the value of `git rev-parse HEAD`. In Jenkins, this corresponds to `$GIT_COMMIT`. | +| `--ref` | ✓ | Name of the reference to analyze, for example `refs/heads/main`. In Git and in Jenkins, this corresponds to the value of `git symbolic-ref HEAD`. In Azure DevOps, this corresponds to `$(Build.SourceBranch)`. | +| `--github-url` | ✓ | URL of the {% data variables.product.prodname_dotcom %} instance where your repository is hosted. | +| `--github-auth` | ✓ | A {% data variables.product.prodname_github_apps %} token or personal access token. | +| `--checkout-path` | | The path to the checkout of your repository. The default is the current working directory. | +| `--no-upload` | | None. Stops the {% data variables.product.prodname_codeql_runner %} from uploading the results to {% data variables.product.product_location %}. | +| `--output-dir` | | Directory where the output SARIF files are stored. The default is in the directory of temporary files. | +| `--temp-dir` | | Directory where temporary files are stored. The default is _./codeql-runner_. | +| `--debug` | | None. Prints more verbose output. | +| `-h`, `--help` | | None. Displays help for the command. | + +#### `hochladen` + +Uploads SARIF files to {% data variables.product.product_location %}. + +| Flag | Erforderlich | Input value | +| -------------------------------- |:------------:| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `--sarif-file` | ✓ | SARIF file to upload, or a directory containing multiple SARIF files. | +| `--repository` | ✓ | Name of the repository that was analyzed. | +| `--commit` | ✓ | SHA of the commit that was analyzed. In Git and in Azure DevOps, this corresponds to the value of `git rev-parse HEAD`. In Jenkins, this corresponds to `$GIT_COMMIT`. | +| `--ref` | ✓ | Name of the reference that was analyzed, for example `refs/heads/main`. In Git and in Jenkins, this corresponds to the value of `git symbolic-ref HEAD`. In Azure DevOps, this corresponds to `$(Build.SourceBranch)`. | +| `--github-url` | ✓ | URL of the {% data variables.product.prodname_dotcom %} instance where your repository is hosted. | +| `--github-auth` | ✓ | A {% data variables.product.prodname_github_apps %} token or personal access token. | +| `--checkout-path` | | The path to the checkout of your repository. The default is the current working directory. | +| `--debug` | | None. Prints more verbose output. | +| `-h`, `--help` | | None. Displays help for the command. | diff --git a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md new file mode 100644 index 000000000000..adbc820dafda --- /dev/null +++ b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md @@ -0,0 +1,116 @@ +--- +title: Configuring the CodeQL workflow for compiled languages +shortTitle: Configuring for compiled languages +intro: 'You can configure how {% data variables.product.prodname_dotcom %} uses the {% data variables.product.prodname_codeql_workflow %} to scan code written in compiled languages for vulnerabilities and errors.' +product: '{% data reusables.gated-features.code-scanning %}' +permissions: 'People with write permissions to a repository can configure {% data variables.product.prodname_code_scanning %} for the repository.' +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages + - /github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta %} +{% data reusables.code-scanning.enterprise-enable-code-scanning-actions %} + +### About the {% data variables.product.prodname_codeql_workflow %} and compiled languages + +You enable {% data variables.product.prodname_dotcom %} to run {% data variables.product.prodname_code_scanning %} for your repository by adding a {% data variables.product.prodname_actions %} workflow to the repository. **Note**: This article refers to {% data variables.product.prodname_code_scanning %} powered by {% data variables.product.prodname_codeql %}, not to {% data variables.product.prodname_code_scanning %} resulting from the upload of third-party static analysis tools. The default {% data variables.product.prodname_code_scanning %} workflow uses the `on.push` event to trigger a code scan on every push to any branch containing the workflow file. + +{% data reusables.code-scanning.edit-workflow %} +For general information about configuring +{% data variables.product.prodname_code_scanning %} and editing workflow files, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" and "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." + +### About autobuild for {% data variables.product.prodname_codeql %} + +Code scanning works by running queries against one or more databases. Each database contains a representation of all of the code in a single language in your repository. For the compiled languages C/C++, C#, and Java, the process of populating this database involves building the code and extracting data. {% data reusables.code-scanning.analyze-go %} + +{% data reusables.code-scanning.autobuild-compiled-languages %} + +If your workflow uses a `language` matrix, `autobuild` attempts to build each of the compiled languages listed in the matrix. Without a matrix `autobuild` attempts to build the supported compiled language that has the most source files in the repository. With the exception of Go, analysis of other compiled languages in your repository will fail unless you supply explicit build commands. + +{% note %} + +**Note**: If you use self-hosted runners for {% data variables.product.prodname_actions %}, you may need to install additional software to use the `autobuild` process. Additionally, if your repository requires a specific version of a build tool, you may need to install it manually. For more information, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". + +{% endnote %} + +#### C/C++ + +| Supported system type | System name | +| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | +| Betriebssystem | Windows, macOS, and Linux | +| Build system | Windows: MSbuild and build scripts
    Linux and macOS: Autoconf, Make, CMake, qmake, Meson, Waf, SCons, Linux Kbuild, and build scripts | + +The behavior of the `autobuild` step varies according to the operating system that the extraction runs on. On Windows, the `autobuild` step attempts to autodetect a suitable build method for C/C++ using the following approach: + +1. Invoke `MSBuild.exe` on the solution (`.sln`) or project (`.vcxproj`) file closest to the root. If `autobuild` detects multiple solution or project files at the same (shortest) depth from the top level directory, it will attempt to build all of them. +2. Invoke a script that looks like a build script—_build.bat_, _build.cmd_, _and build.exe_ (in that order). + +On Linux and macOS, the `autobuild` step reviews the files present in the repository to determine the build system used: + +1. Look for a build system in the root directory. +2. If none are found, search subdirectories for a unique directory with a build system for C/C++. +3. Run an appropriate command to configure the system. + +#### C + +| Supported system type | System name | +| --------------------- | ------------------------------------------ | +| Betriebssystem | Windows and Linux | +| Build system | .NET and MSbuild, as well as build scripts | + +The `autobuild` process attempts to autodetect a suitable build method for C# using the following approach: + +1. Invoke `dotnet build` on the solution (`.sln`) or project (`.csproj`) file closest to the root. +2. Invoke `MSbuild` (Linux) or `MSBuild.exe` (Windows) on the solution or project file closest to the root. If `autobuild` detects multiple solution or project files at the same (shortest) depth from the top level directory, it will attempt to build all of them. +3. Invoke a script that looks like a build script—_build_ and _build.sh_ (in that order, for Linux) or _build.bat_, _build.cmd_, _and build.exe_ (in that order, for Windows). + +#### Java + +| Supported system type | System name | +| --------------------- | ------------------------------------------ | +| Betriebssystem | Windows, macOS, and Linux (no restriction) | +| Build system | Gradle, Maven and Ant | + +The `autobuild` process tries to determine the build system for Java codebases by applying this strategy: + +1. Search for a build file in the root directory. Check for Gradle then Maven then Ant build files. +2. Run the first build file found. If both Gradle and Maven files are present, the Gradle file is used. +3. Otherwise, search for build files in direct subdirectories of the root directory. If only one subdirectory contains build files, run the first file identified in that subdirectory (using the same preference as for 1). If more than one subdirectory contains build files, report an error. + +### Adding build steps for a compiled language + +{% data reusables.code-scanning.autobuild-add-build-steps %} For information on how to edit the workflow file, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)." + +After removing the `autobuild` step, uncomment the `run` step and add build commands that are suitable for your repository. The workflow `run` step runs command-line programs using the operating system's shell. You can modify these commands and add more commands to customize the build process. + +``` yaml +- run: | + make bootstrap + make release +``` + +For more information about the `run` keyword, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)." + +If your repository contains multiple compiled languages, you can specify language-specific build commands. For example, if your repository contains C/C++, C# and Java, and `autobuild` correctly builds C/C++ and C# but fails to build Java, you could use the following configuration in your workflow, after the `init` step. This specifies build steps for Java while still using `autobuild` for C/C++ and C#: + +```yaml +- if: matrix.language == 'cpp' || matrix.language == 'csharp' + name: Autobuild + uses: github/codeql-action/autobuild@v1 + +- if: matrix.language == 'java' + name: Build Java + run: | + make bootstrap + make release +``` + +For more information about the `if` conditional, see "[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsif)." + +For more tips and tricks about why `autobuild` won't build your code, see "[Troubleshooting the {% data variables.product.prodname_codeql %} workflow](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow)." + +If you added manual build steps for compiled languages and {% data variables.product.prodname_code_scanning %} is still not working on your repository, contact {% data variables.contact.contact_support %}. diff --git a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md index 14a835f18f1a..f4cabb2462b7 100644 --- a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md +++ b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md @@ -27,23 +27,91 @@ You decide how you generate {% data variables.product.prodname_code_scanning %} {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-security %} -3. To the right of "Code scanning", click **Set up code scanning**. - !["Set up code scanning" button to the right of "Code scanning" in the Security Overview](/assets/images/help/security/overview-set-up-code-scanning.png) -4. Under "Get started with code scanning", click **Set up this workflow** on the {% data variables.product.prodname_codeql_workflow %} or on a third-party workflow. - !["Set up this workflow" button under "Get started with code scanning" heading](/assets/images/help/repository/code-scanning-set-up-this-workflow.png) -5. Optionally, to customize how {% data variables.product.prodname_code_scanning %} scans your code, edit the workflow. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." +3. To the right of "{% data variables.product.prodname_code_scanning_capc %}", click **Set up {% data variables.product.prodname_code_scanning %}**. + !["Set up {% data variables.product.prodname_code_scanning %}" button to the right of "{% data variables.product.prodname_code_scanning_capc %}" in the Security Overview](/assets/images/help/security/overview-set-up-code-scanning.png) +4. Under "Get started with {% data variables.product.prodname_code_scanning %}", click **Set up this workflow** on the {% data variables.product.prodname_codeql_workflow %} or on a third-party workflow. + !["Set up this workflow" button under "Get started with {% data variables.product.prodname_code_scanning %}" heading](/assets/images/help/repository/code-scanning-set-up-this-workflow.png) +5. To customize how {% data variables.product.prodname_code_scanning %} scans your code, edit the workflow. + + Generally you can commit the {% data variables.product.prodname_codeql_workflow %} without making any changes to it. However, many of the third-party workflows require additional configuration, so read the comments in the workflow before committing. + + For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." 6. Use the **Start commit** drop-down, and type a commit message. ![Start commit](/assets/images/help/repository/start-commit-commit-new-file.png) 7. Choose whether you'd like to commit directly to the default branch, or create a new branch and start a pull request. ![Choose where to commit](/assets/images/help/repository/start-commit-choose-where-to-commit.png) 8. Click **Commit new file** or **Propose new file**. -After you commit the workflow file or create a pull request, {% data variables.product.prodname_code_scanning %} will analyze your code according to the frequency you specified in your workflow file. If you created a pull request, {% data variables.product.prodname_code_scanning %} will only analyze the code on the pull request's topic branch until you merge the pull request into the default branch of the repository. +In the default {% data variables.product.prodname_codeql_workflow %}, {% data variables.product.prodname_code_scanning %} is configured to analyze your code each time you either push a change to the default branch or any protected branches, or raise a pull request against the default branch or any protected branches. As a result, {% data variables.product.prodname_code_scanning %} will now commence. + +### Viewing the logging output from {% data variables.product.prodname_code_scanning %} + +After enabling {% data variables.product.prodname_code_scanning %} for your repository, you can watch the output of the actions as they run. + +{% data reusables.repositories.actions-tab %} + + You'll see a list that includes an entry for running the {% data variables.product.prodname_code_scanning %} workflow. + + ![Actions list showing {% data variables.product.prodname_code_scanning %} workflow](/assets/images/help/repository/code-scanning-actions-list.png) + +1. Click the entry for the {% data variables.product.prodname_code_scanning %} workflow. + +1. Click the job name on the left. For example, **Analyze (LANGUAGE)**. + + ![Log output from the {% data variables.product.prodname_code_scanning %} workflow](/assets/images/help/repository/code-scanning-logging-analyze-action.png) + +1. Review the logging output from the actions in this workflow as they run. + +1. Once all jobs are complete, you can view the details of any {% data variables.product.prodname_code_scanning %} alerts that were identified. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository#viewing-an-alert)." + +{% note %} + +**Note:** If you raised a pull request to add the {% data variables.product.prodname_code_scanning %} workflow to the repository, alerts from that pull request aren't displayed directly on the {% data variables.product.prodname_code_scanning_capc %} page until the pull request is merged. If any alerts were found you can view these, before the pull request is merged, by clicking the **_n_ alerts found** link in the banner on the {% data variables.product.prodname_code_scanning_capc %} page. + + ![Click the "n alerts found" link](/assets/images/help/repository/code-scanning-alerts-found-link.png) + +{% endnote %} + +### Understanding the pull request checks + +Each {% data variables.product.prodname_code_scanning %} workflow you enable to run on pull requests always has at least two entries listed in the checks section of a pull request. There is one entry for each of the analysis jobs in the workflow, and a final one for the results of the analysis. + +The names of the {% data variables.product.prodname_code_scanning %} analysis checks take the form: "TOOL NAME / JOB NAME (TRIGGER)." For example, for {% data variables.product.prodname_codeql %}, analysis of C++ code has the entry "{% data variables.product.prodname_codeql %} / Analyze (cpp) (pull_request)." You can click **Details** on a {% data variables.product.prodname_code_scanning %} analysis entry to see logging data. This allows you to debug a problem if the analysis job failed. For example, for {% data variables.product.prodname_code_scanning %} analysis of compiled languages, this can happen if the action can't build the code. + + ![{% data variables.product.prodname_code_scanning %} pull request checks](/assets/images/help/repository/code-scanning-pr-checks.png) + +When the {% data variables.product.prodname_code_scanning %} jobs complete, {% data variables.product.prodname_dotcom %} works out whether any alerts were added by the pull request and adds the "{% data variables.product.prodname_code_scanning_capc %} results / TOOL NAME" entry to the list of checks. After {% data variables.product.prodname_code_scanning %} has been performed at least once, you can click **Details** to view the results of the analysis. If you used a pull request to add {% data variables.product.prodname_code_scanning %} to the repository, you will initially see a "Missing analysis" message when you click **Details** on the "{% data variables.product.prodname_code_scanning_capc %} results / TOOL NAME" check. + + ![Missing analysis for commit message](/assets/images/help/repository/code-scanning-missing-analysis.png) + +#### Reasons for the "missing analysis" message + +After {% data variables.product.prodname_code_scanning %} has analyzed the code in a pull request, it needs to compare the analysis of the topic branch (the branch you used to create the pull request) with the analysis of the base branch (the branch into which you want to merge the pull request). This allows {% data variables.product.prodname_code_scanning %} to compute which alerts are newly introduced by the pull request, which alerts were already present in the base branch, and whether any existing alerts are fixed by the changes in the pull request. Initially, if you use a pull request to add {% data variables.product.prodname_code_scanning %} to a repository, the base branch has not yet been analyzed, so it's not possible to compute these details. In this case, when you click through from the results check on the pull request you will see the "Missing analysis for base commit SHA-HASH" message. + +There are other situations where there may be no analysis for the latest commit to the base branch for a pull request. These include: + +* The pull request has been raised against a branch other than the default branch or a protected branch, and this branch hasn't been analyzed. + + To check whether a branch has been scanned, go to the {% data variables.product.prodname_code_scanning_capc %} page, click the **Branch** drop-down and select the relevant branch. + + ![Choose a branch from the Branch drop-down menu](/assets/images/help/repository/code-scanning-branch-dropdown.png) + + The solution in this situation is to add the name of the base branch to the `on:push` and `on:pull_request` specification in the {% data variables.product.prodname_code_scanning %} workflow on that branch and then make a change that updates the open pull request that you want to scan. + +* The latest commit on the base branch for the pull request is currently being analyzed and analysis is not yet available. + + Wait a few minutes and then push a change to the pull request to retrigger {% data variables.product.prodname_code_scanning %}. + +* An error occurred while analyzing the latest commit on the base branch and analysis for that commit isn't available. + + Merge a trivial change into the base branch to trigger {% data variables.product.prodname_code_scanning %} on this latest commit, then push a change to the pull request to retrigger {% data variables.product.prodname_code_scanning %}. ### Next steps -After you enable {% data variables.product.prodname_code_scanning %}, you can monitor analysis, view results, and further customize how you scan your code. +After enabling {% data variables.product.prodname_code_scanning %}, and allowing its actions to complete, you can: -- You can view the run status of {% data variables.product.prodname_code_scanning %} and get notifications for completed runs. For more information, see "[Managing a workflow run](/actions/configuring-and-managing-workflows/managing-a-workflow-run)" and "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)." -- After a scan completes, you can view alerts from a completed scan. For more information, see "[Managing alerts from {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." -- You can customize how {% data variables.product.prodname_code_scanning %} scans the code in your repository. For more information, see "[Configuring code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." +- View all of the {% data variables.product.prodname_code_scanning %} alerts generated for this repository. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." +- View any alerts generated for a pull request submitted after you enabled {% data variables.product.prodname_code_scanning %}. For more information, see "[Triaging {% data variables.product.prodname_code_scanning %} alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests)." +- Set up notifications for completed runs. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)." +- Investigate any problems that occur with the initial setup of {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %}. For more information, see "[Troubleshooting the {% data variables.product.prodname_codeql %} workflow](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow)." +- Customize how {% data variables.product.prodname_code_scanning %} scans the code in your repository. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." diff --git a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md index b7a0ed4813be..75179c6a8f9b 100644 --- a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md +++ b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md @@ -1,5 +1,6 @@ --- title: Finding security vulnerabilities and errors in your code +product: '{% data reusables.gated-features.code-scanning %}' redirect_from: - /github/managing-security-vulnerabilities/finding-security-vulnerabilities-in-your-projects-code versions: @@ -11,14 +12,17 @@ versions: {% topic_link_in_list /automatically-scanning-your-code-for-vulnerabilities-and-errors %} {% link_in_list /about-code-scanning %} + {% link_in_list /triaging-code-scanning-alerts-in-pull-requests %} {% link_in_list /enabling-code-scanning %} - {% link_in_list /managing-alerts-from-code-scanning %} + {% link_in_list /managing-code-scanning-alerts-for-your-repository %} {% link_in_list /configuring-code-scanning %} - {% link_in_list /configuring-the-codeql-action-for-compiled-languages %} - {% link_in_list /troubleshooting-code-scanning %} + {% link_in_list /configuring-the-codeql-workflow-for-compiled-languages %} + {% link_in_list /troubleshooting-the-codeql-workflow %} {% topic_link_in_list /managing-results-from-code-scanning %} {% link_in_list /about-integration-with-code-scanning %} - {% link_in_list /running-code-scanning-in-your-ci-system %} - {% link_in_list /configuring-code-scanning-in-your-ci-system %} {% link_in_list /uploading-a-sarif-file-to-github %} {% link_in_list /sarif-support-for-code-scanning %} +{% link_in_list /running-code-scanning-in-your-ci-system %} + {% link_in_list /configuring-code-scanning-in-your-ci-system %} + {% link_in_list /configuring-the-codeql-action-for-compiled-languages %} + {% link_in_list /troubleshooting-codeql-code-scanning-in-your-ci-system %} diff --git a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md index 9caa80f45c73..01a082e5015f 100644 --- a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md +++ b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md @@ -1,8 +1,9 @@ --- title: Integrating with code scanning shortTitle: Integration -intro: 'You can integrate {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} with your existing CI systems or upload results from other tools.' +intro: 'You can integrate third-party code analysis tools with {% data variables.product.prodname_dotcom %} {% data variables.product.prodname_code_scanning %} by uploading data as SARIF files.' mapTopic: true +product: '{% data reusables.gated-features.code-scanning %}' redirect_from: - /github/finding-security-vulnerabilities-and-errors-in-your-code/managing-results-from-code-scanning versions: diff --git a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository.md b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository.md new file mode 100644 index 000000000000..1a9ed7c53ae6 --- /dev/null +++ b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository.md @@ -0,0 +1,63 @@ +--- +title: Managing code scanning alerts for your repository +shortTitle: Warnungen verwalten +intro: 'You can view, fix, and close alerts for potential vulnerabilities or errors in your project''s code.' +product: '{% data reusables.gated-features.code-scanning %}' +permissions: 'People with write permission to a repository can manage {% data variables.product.prodname_code_scanning %} alerts for the repository.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +redirect_from: + - /github/managing-security-vulnerabilities/managing-alerts-from-automated-code-scanning + - /github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning +--- + +{% data reusables.code-scanning.beta %} + +### About alerts from {% data variables.product.prodname_code_scanning %} + +You can set up {% data variables.product.prodname_code_scanning %} to check the code in a repository using the default {% data variables.product.prodname_codeql %} analysis, a third-party analysis, or multiple types of analysis. When the analysis is complete, the resulting alerts are displayed alongside each other in the security view of the repository. Results from third-party tools or from custom queries may not include all of the properties that you see for alerts detected by {% data variables.product.company_short %}'s default {% data variables.product.prodname_codeql %} analysis. The default {% data variables.product.prodname_code_scanning %} workflow uses the `on.push` event to trigger a code scan on every push to any branch containing the workflow file. + +By default, {% data variables.product.prodname_code_scanning %} analyzes your code periodically on the default branch and during pull requests. For information about managing alerts on a pull request, see "[Triaging {% data variables.product.prodname_code_scanning %} alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests)." + +### About alerts details + +Each alert highlights a problem with the code and the name of the tool that identified it. You can see the line of code that triggered the alert, as well as properties of the alert, such as the severity and the nature of the problem. Alerts also tell you when the issue was first introduced. For alerts identified by {% data variables.product.prodname_codeql %} analysis, you will also see information on how to fix the problem. + +![Example alert from {% data variables.product.prodname_code_scanning %}](/assets/images/help/repository/code-scanning-alert.png) + +If you enable {% data variables.product.prodname_code_scanning %} using {% data variables.product.prodname_codeql %}, this can also detect data-flow problems in your code. Data-flow analysis finds potential security issues in code, such as: using data insecurely, passing dangerous arguments to functions, and leaking sensitive information. + +When {% data variables.product.prodname_code_scanning %} reports data-flow alerts, {% data variables.product.prodname_dotcom %} shows you how data moves through the code. {% data variables.product.prodname_code_scanning_capc %} allows you to identify the areas of your code that leak sensitive information, and that could be the entry point for attacks by malicious users. + +### Viewing an alert + +Anyone with read permission for a repository can see {% data variables.product.prodname_code_scanning %} alerts on pull requests. However, you need write permission to view a summary of alerts for repository on the **Security** tab. By default, alerts are shown for the default branch. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-security %} +{% data reusables.repositories.sidebar-code-scanning-alerts %} +{% data reusables.code-scanning.click-alert-in-list %} +5. Optionally, if the alert highlights a problem with data flow, click **Show paths** to display the path from the data source to the sink where it's used. ![Example data-flow alert](/assets/images/help/repository/code-scanning-show-paths.png) + +### Fixing an alert + +Anyone with write permission for a repository can fix an alert by committing a correction to the code. If the repository has {% data variables.product.prodname_code_scanning %} scheduled to run on pull requests, it's best to raise a pull request with your correction. This will trigger {% data variables.product.prodname_code_scanning %} analysis of the changes and test that your fix doesn't introduce any new problems. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" and "[Triaging {% data variables.product.prodname_code_scanning %} alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests)." + +### Closing an alert + +Closing an alert is a way to resolve an alert that you don't think needs to be fixed. {% data reusables.code-scanning.close-alert-examples %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-security %} +{% data reusables.repositories.sidebar-code-scanning-alerts %} +{% data reusables.code-scanning.click-alert-in-list %} +5. Select the Close drop-down menu and click a reason for closing the alert. ![Choosing reason for closing the alert via the Close drop-down](/assets/images/help/repository/code-scanning-alert-close-drop-down.png) + +{% data reusables.code-scanning.false-positive-fix-codeql %} + +### Weiterführende Informationen + +- "[Triaging {% data variables.product.prodname_code_scanning %} alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests)" +- "[Enabling {% data variables.product.prodname_code_scanning %} for a repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository)" +- "[About integration with {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning)" diff --git a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md new file mode 100644 index 000000000000..5b7faf0e62b0 --- /dev/null +++ b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md @@ -0,0 +1,161 @@ +--- +title: Running CodeQL code scanning in your CI system +shortTitle: Running in your CI +intro: 'You can use the {% data variables.product.prodname_codeql_runner %} to perform {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in a third-party continuous integration system.' +product: '{% data reusables.gated-features.code-scanning %}' +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta-codeql-runner %} +{% data reusables.code-scanning.beta %} +{% data reusables.code-scanning.enterprise-enable-code-scanning %} + +### Using {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} with your existing CI system + +If you use a continuous integration or continuous delivery/deployment (CI/CD) system other than {% data variables.product.prodname_actions %}, you can use your existing system to run {% data variables.product.prodname_dotcom %}'s {% data variables.product.prodname_codeql %} analysis and upload the results to {% data variables.product.prodname_dotcom %}. To do this, use the {% data variables.product.prodname_codeql_runner %}. + +### About the {% data variables.product.prodname_codeql_runner %} + +{% data reusables.code-scanning.about-code-scanning %} For information, see "[About {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)." + +You can use the {% data variables.product.prodname_codeql_runner %} to run {% data variables.product.prodname_code_scanning %} on code that you're processing in a third-party continuous integration (CI) system. Alternatively, you can use {% data variables.product.prodname_actions %} to run {% data variables.product.prodname_code_scanning %} on {% data variables.product.product_location %}. For information, see "[Enabling {% data variables.product.prodname_code_scanning %} for a repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository)." + +The {% data variables.product.prodname_codeql_runner %} is a command-line tool that runs {% data variables.product.prodname_codeql %} analysis on a checkout of a {% data variables.product.prodname_dotcom %} repository. You add the runner to your third-party system, then call the runner to analyze code and upload the results to {% data variables.product.product_location %}. These results are displayed as {% data variables.product.prodname_code_scanning %} alerts in the repository. + +{% data reusables.code-scanning.codeql-runner-license %} + +### Downloading the {% data variables.product.prodname_codeql_runner %} + +You can download the {% data variables.product.prodname_codeql_runner %} from https://github.com/github/codeql-action/releases. On some operating systems, you may need to change permissions for the downloaded file before you can run it. + +On Linux: + +```shell +chmod +x codeql-runner-linux +``` + +On MacOS: + +```shell +chmod +x codeql-runner-macos +sudo xattr -d com.apple.quarantine codeql-runner-macos +``` + +On Windows, the `codeql-runner-win.exe` file usually requires no change to permissions. + +### Adding the {% data variables.product.prodname_codeql_runner %} to your CI system + +Once you have downloaded the {% data variables.product.prodname_codeql_runner %} and verified that it can be executed, you should make the runner available to each CI server that you intend to use for {% data variables.product.prodname_code_scanning %}. It is important to notice that each CI server that you intend to use for {% data variables.product.prodname_code_scanning %} needs to have the {% data variables.product.prodname_codeql_runner %}. You might configure each server to copy the runner from a central, internal location, or you could use the REST API to get the runner direct from GitHub, for example: + +```shell +wget https://github.com/github/codeql-action/releases/download/codeql-bundle-20200826/codeql-runner-linux +chmod +x codeql-runner-linux +``` + +In addition to this, each CI server also needs: + +- A {% data variables.product.prodname_github_apps %} or personal access token for the {% data variables.product.prodname_codeql_runner %} to use. For private repositories the token must have the `repo` scope. For public the token needs only the `public_repo` and `repo:security_events` scopes. For information, see "[Building {% data variables.product.prodname_github_apps %}](/developers/apps/building-github-apps)" and "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token)." +- Access to the {% data variables.product.prodname_codeql %} bundle associated with this release of the {% data variables.product.prodname_codeql_runner %}. This package contains the {% data variables.product.prodname_codeql %} CLI, queries, and libraries needed for {% data variables.product.prodname_codeql %} analysis. For information, see "[{% data variables.product.prodname_codeql %} CLI](https://help.semmle.com/codeql/codeql-cli.html)." + +The options for providing access to the {% data variables.product.prodname_codeql %} bundle are: + +1. Allow the CI servers access to {% data variables.product.prodname_dotcom_the_website %} so that the {% data variables.product.prodname_codeql_runner %} can download the bundle automatically. +1. Manually download/extract the bundle, store it with other central resources, and use the `--codeql-path` flag to specify the location of the bundle in calls to initialize the {% data variables.product.prodname_codeql_runner %}. +{% if currentVersion != "free-pro-team@latest" %} +1. You can mirror the `github/codeql-action` repository on {% data variables.product.product_location %}. Unless you specify the `--codeql-path` flag, the runner automatically checks for the bundle in this location and on {% data variables.product.prodname_dotcom_the_website %}.{% endif %} + +### Calling the {% data variables.product.prodname_codeql_runner %} + +You should call the {% data variables.product.prodname_codeql_runner %} from the checkout location of the repository you want to analyze. The two main commands are: + +1. `init` required to initialize the runner and create a {% data variables.product.prodname_codeql %} database for each language to be analyzed. These databases are populated and analyzed by subsequent commands. +1. `analyze` required to populate the {% data variables.product.prodname_codeql %} databases, analyze them, and upload results to {% data variables.product.product_location %}. + +For both commands, you must specify the URL of {% data variables.product.product_location %}, the repository *OWNER/NAME*, and the GitHub Apps or personal access token to use for authentication. You also need to specify the location of the CodeQL bundle unless the CI server has access to download it directly from the `github/codeql-action` repository on {% data variables.product.prodname_dotcom_the_website %}{% if currentVersion != "free-pro-team@latest" %} or mirrored on {% data variables.product.product_location %}{% endif %}. + +You can configure where the {% data variables.product.prodname_codeql_runner %} stores the CodeQL bundle for future analysis on a server using the `--tools-dir` flag and where it stores temporary files during analysis using `--temp-dir`. + +To view the command-line reference for the runner, use the `-h` flag. For example, to list all commands run: `codeql-runner-OS -h`, or to list all the flags available for the `init` command run: `codeql-runner-OS init -h` (where `OS` varies according to the executable that you are using). For more information, see "[Configuring {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system#codeql-runner-command-reference)." + +#### Basic example + +This example runs {% data variables.product.prodname_codeql %} analysis on a Linux CI server for the `octo-org/example-repo` repository hosted on `{% data variables.command_line.git_url_example %}`. The process is very simple because the repository contains only languages that can be analyzed by {% data variables.product.prodname_codeql %} directly, without being built (that is, Go, JavaScript, Python, and TypeScript). + +1. Check out the repository to analyze. +1. Move into the directory where the repository is checked out. +1. Initialize the {% data variables.product.prodname_codeql_runner %} and create {% data variables.product.prodname_codeql %} databases for the languages detected. + + ```shell + $ /path/to-runner/codeql-runner-linux init --repository octo-org/example-repo + --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN + > Cleaning temp directory /srv/checkout/example-repo/codeql-runner + > ... + > Created CodeQL database at /srv/checkout/example-repo/codeql-runner/codeql_databases/javascript. + ``` + +1. Populate the {% data variables.product.prodname_codeql_runner %} databases, analyze them, and upload the results to {% data variables.product.product_name %}. + + ```shell + $ /path/to-runner/codeql-runner-linux analyze --repository octo-org/example-repo + --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN + --commit 5b6a3078b31dc346e5ce7b86837d6abbe7a18bbd --ref refs/heads/main + > Finalizing database creation + > ... + > POST /repos/octo-org/example-repo/code-scanning/sarifs - 202 in 786ms + > Successfully uploaded results + ``` + +The server has access to download the {% data variables.product.prodname_codeql %} bundle directly from the `github/codeql-action` repository on {% data variables.product.prodname_dotcom_the_website %}{% if currentVersion != "free-pro-team@latest" %} or mirrored on {% data variables.product.product_location %}{% endif %}, so there is no need to use the `--codeql-path` flag. When the analysis is complete, the {% data variables.product.prodname_codeql_runner %} uploads the results to the {% data variables.product.prodname_code_scanning %} view. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." + +#### Compiled language example + +This example is similar to the previous example, however this time the repository has code in C/C++, C#, or Java. To create a {% data variables.product.prodname_codeql %} database for these languages, the CLI needs to monitor the build. At the end of the initialization process, the runner reports the command you need to set up the environment before building the code. You need to run this command, before calling the normal CI build process, and then running the `analyze` command. + +1. Check out the repository to analyze. +1. Move into the directory where the repository is checked out. +1. Initialize the {% data variables.product.prodname_codeql_runner %} and create {% data variables.product.prodname_codeql %} databases for the languages detected. + + ```shell + $ /path/to-runner/codeql-runner-linux init --repository octo-org/example-repo-2 + --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN + > Cleaning temp directory /srv/checkout/example-repo-2/codeql-runner + > ... + > CodeQL environment output to "/srv/checkout/example-repo-2/codeql-runner/codeql-env.json" + and "/srv/checkout/example-repo-2/codeql-runner/codeql-env.sh". + Please export these variables to future processes so the build can be traced, for example by running " + . /srv/checkout/example-repo-2/codeql-runner/codeql-env.sh". + ``` + +1. Run the script generated by the `init` action to set up the environment to monitor the build. + + ```shell + $ . /srv/checkout/example-repo-2/codeql-runner/codeql-env.sh + ``` + +1. Build the code. +1. Populate the {% data variables.product.prodname_codeql %} databases, analyze them, and upload the results to GitHub. + + ```shell + $ /path/to-runner/codeql-runner-linux analyze --repository octo-org/example-repo-2 + --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN + --commit ae7b655ef30b50fb726ae7b3daa79571a39d194d --ref refs/heads/main + > Finalizing database creation + > ... + > POST /repos/octo-org/example-repo-2/code-scanning/sarifs - 202 in 573ms + > Successfully uploaded results + ``` + +{% note %} + +**Note:** If you use a containerized build, you need to run the {% data variables.product.prodname_codeql_runner %} in the container where your build task takes place. + +{% endnote %} + +### Further reading + +- "[Configuring {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system)" +- "[Troubleshooting {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system)" diff --git a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md index d88ba7ca83de..8c1b98ee4848 100644 --- a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md +++ b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md @@ -11,27 +11,32 @@ versions: --- {% data reusables.code-scanning.beta %} -{% data reusables.code-scanning.enterprise-enable-code-scanning %} ### About SARIF support SARIF (Static Analysis Results Interchange Format) is an [OASIS Standard](https://docs.oasis-open.org/sarif/sarif/v2.1.0/sarif-v2.1.0.html) that defines an output file format. The SARIF standard is used to streamline how static analysis tools share their results. {% data variables.product.prodname_code_scanning_capc %} supports a subset of the SARIF 2.1.0 JSON schema. -To upload a SARIF file from a third-party static code analysis engine, you'll need to ensure that uploaded files use the SARIF 2.1.0 version. {% data variables.product.prodname_dotcom %} will parse the SARIF file and show alerts using the results in your repository as a part of the code scanning experience. For more information, see "[Uploading a SARIF file to {% data variables.product.prodname_dotcom %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)." For more information about the SARIF 2.1.0 JSON schema, see [`sarif-schema-2.1.0.json`](https://github.com/oasis-tcs/sarif-spec/blob/master/Schemata/sarif-schema-2.1.0.json). +To upload a SARIF file from a third-party static code analysis engine, you'll need to ensure that uploaded files use the SARIF 2.1.0 version. To upload a SARIF file from a third-party static code analysis engine, you'll need to ensure that uploaded files use the SARIF 2.1.0 version. For more information, see "[Uploading a SARIF file to {% data variables.product.prodname_dotcom %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)." For more information about the SARIF 2.1.0 JSON schema, see [`sarif-schema-2.1.0.json`](https://github.com/oasis-tcs/sarif-spec/blob/master/Schemata/sarif-schema-2.1.0.json). -If your SARIF file doesn't include `partialFingerprints`, the `partialFingerprints` field will be calculated when you upload the SARIF file using {% data variables.product.prodname_actions %}. For more information, see "[Uploading a SARIF file to {% data variables.product.prodname_dotcom %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github#uploading-a-code-scanning-analysis-with-github-actions)." +If your SARIF file doesn't include `partialFingerprints`, the `partialFingerprints` field will be calculated when you upload the SARIF file using {% data variables.product.prodname_actions %}. For more information, see "[Enabling {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning)" or "[Running {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)." -{% data variables.product.prodname_dotcom %} uses properties in the SARIF file to display alerts. For example, the `shortDescription` and `fullDescription` appear at the top of a {% data variables.product.prodname_code_scanning %} alert. The `location` allows {% data variables.product.prodname_dotcom %} to show annotations in your code file. Weitere Informationen findest Du unter „[Warnungen von {% data variables.product.prodname_code_scanning %} verwalten](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." +{% data variables.product.prodname_dotcom %} uses properties in the SARIF file to display alerts. For example, the `shortDescription` and `fullDescription` appear at the top of a {% data variables.product.prodname_code_scanning %} alert. The `location` allows {% data variables.product.prodname_dotcom %} to show annotations in your code file. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." If you're new to SARIF and want to learn more, see Microsoft's [`SARIF tutorials`](https://github.com/microsoft/sarif-tutorials) repository. ### Preventing duplicate alerts using fingerprints -Each time a {% data variables.product.prodname_actions %} workflow runs a new code scan, the results for each run are processed and alerts are added to the repository. To prevent duplicate alerts for the same problem, {% data variables.product.prodname_code_scanning %} uses fingerprints to match results across various runs so they only appear once in the latest run for the selected branch. +Each time a {% data variables.product.prodname_actions %} workflow runs a new code scan, the results for each run are processed and alerts are added to the repository. To prevent duplicate alerts for the same problem, {% data variables.product.prodname_code_scanning %} uses fingerprints to match results across various runs so they only appear once in the latest run for the selected branch. This makes it possible to match alerts to the right line of code when files are edited. {% data variables.product.prodname_dotcom %} uses the `partialFingerprints` property in the OASIS standard to detect when two results are logically identical. For more information, see the "[partialFingerprints property](https://docs.oasis-open.org/sarif/sarif/v2.1.0/cs01/sarif-v2.1.0-cs01.html#_Toc16012611)" entry in the OASIS documentation. -SARIF files created by the {% data variables.product.prodname_codeql_workflow %} or using the {% data variables.product.prodname_codeql_runner %} include fingerprint data. If your SARIF file doesn't include `partialFingerprints`, the `partialFingerprints` field will be calculated if you upload the SARIF file using {% data variables.product.prodname_actions %}. For more information, see "[Uploading a SARIF file to {% data variables.product.prodname_dotcom %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github#uploading-a-code-scanning-analysis-with-github-actions)." +SARIF files created by the {% data variables.product.prodname_codeql_workflow %} or using the {% data variables.product.prodname_codeql_runner %} include fingerprint data. If you upload a SARIF file using the `upload-sarif` action and this data is missing, {% data variables.product.prodname_dotcom %} attempts to populate the `partialFingerprints` field from the source files. For more information about uploading results, see "[Uploading a SARIF file to {% data variables.product.prodname_dotcom %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github#uploading-a-code-scanning-analysis-with-github-actions)." + +If you upload a SARIF file without fingerprint data using the `/code-scanning/sarifs` API endpoint, the {% data variables.product.prodname_code_scanning %} alerts will be processed and displayed, but users may see duplicate alerts. To avoid seeing duplicate alerts, you should calculate fingerprint data and populate the `partialFingerprints` property before you upload the SARIF file. You may find the script that the `upload-sarif` action uses a helpful starting point: https://github.com/github/codeql-action/blob/main/src/fingerprints.ts. For more information about the API, see "[Upload a SARIF file](/rest/reference/code-scanning#upload-a-sarif-file)." + +### Validating your SARIF file + +If your SARIF file doesn't include `partialFingerprints`, the `partialFingerprints` field will be calculated when you upload the SARIF file using {% data variables.product.prodname_actions %}. For more information, visit the [Microsoft SARIF validator](https://sarifweb.azurewebsites.net/). ### Supported SARIF output file properties @@ -44,49 +49,49 @@ Any valid SARIF 2.1.0 output file can be uploaded, however, {% data variables.pr | Name | Beschreibung | | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `$schema` | **Required.** The URI of the SARIF JSON schema for version 2.1.0. For example, `https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json`. | -| `version` | **Required.** {% data variables.product.prodname_code_scanning_capc %} only supports SARIF version `2.1.0`. | +| `version` | **Required.** {% data variables.product.prodname_code_scanning_capc %} only supports SARIF version `2.1.0`. | | `runs[]` | **Required.** A SARIF file contains an array of one or more runs. Each run represents a single run of an analysis tool. For more information about a `run`, see the [`run` object](#run-object). | #### `run` object {% data variables.product.prodname_code_scanning_capc %} uses the `run` object to filter results by tool and provide information about the source of a result. The `run` object contains the `tool.driver` tool component object, which contains information about the tool that generated the results. Each `run` can only have results for one analysis tool. -| Name | Beschreibung | -| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Name | Beschreibung | +| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `tool.driver.name` | **Required.** The name of the analysis tool. {% data variables.product.prodname_code_scanning_capc %} displays the name on {% data variables.product.prodname_dotcom %} to allow you to filter results by tool. | | `tool.driver.version` | **Optional.** The version of the analysis tool. {% data variables.product.prodname_code_scanning_capc %} uses the version number to track when results may have changed due to a tool version change rather than a change in the code being analyzed. If the SARIF file includes the `semanticVersion` field, `version` is not used by {% data variables.product.prodname_code_scanning %}. | | `tool.driver.semanticVersion` | **Optional.** The version of the analysis tool, specified by the Semantic Versioning 2.0 format. {% data variables.product.prodname_code_scanning_capc %} uses the version number to track when results may have changed due to a tool version change rather than a change in the code being analyzed. If the SARIF file includes the `semanticVersion` field, `version` is not used by {% data variables.product.prodname_code_scanning %}. For more information, see "[Semantic Versioning 2.0.0](https://semver.org/)" in the Semantic Versioning documentation. | -| `tool.driver.rules[]` | **Required.** An array of `reportingDescriptor` objects that represent rules. The analysis tool uses rules to find problems in the code being analyzed. For more information, see the [`reportingDescriptor` object](#reportingdescriptor-object). | +| `tool.driver.rules[]` | **Required.** An array of `reportingDescriptor` objects that represent rules. The analysis tool uses rules to find problems in the code being analyzed. For more information, see the [`reportingDescriptor` object](#reportingdescriptor-object). | | `results[]` | **Required.** The results of the analysis tool. {% data variables.product.prodname_code_scanning_capc %} displays the results on {% data variables.product.prodname_dotcom %}. For more information, see the [`result` object](#result-object). | #### `reportingDescriptor` object -| Name | Beschreibung | -| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Name | Beschreibung | +| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | **Required.** A unique identifier for the rule. The `id` is referenced from other parts of the SARIF file and may be used by {% data variables.product.prodname_code_scanning %} to display URLs on {% data variables.product.prodname_dotcom %}. | | `name` | **Optional.** The name of the rule. {% data variables.product.prodname_code_scanning_capc %} displays the name to allow results to be filtered by rule on {% data variables.product.prodname_dotcom %}. | | `shortDescription.text` | **Required.** A concise description of the rule. {% data variables.product.prodname_code_scanning_capc %} displays the short description on {% data variables.product.prodname_dotcom %} next to the associated results. | | `fullDescription.text` | **Required.** A description of the rule. {% data variables.product.prodname_code_scanning_capc %} displays the full description on {% data variables.product.prodname_dotcom %} next to the associated results. The max number of characters is limited to 1000. | -| `defaultConfiguration.level` | **Optional.** Default severity level of the rule. {% data variables.product.prodname_code_scanning_capc %} uses severity levels to help you understand how critical the result is for a given rule. This value can be overridden by the `level` attribute in the `result` object. For more information, see the [`result` object](#result-object). Default: `warning`. | -| `help.text` | **Required.** Documentation for the rule using text format. {% data variables.product.prodname_code_scanning_capc %} displays this help documentation next to the associated results. | -| `help.markdown` | **Recommended.** Documentation for the rule using Markdown format. {% data variables.product.prodname_code_scanning_capc %} displays this help documentation next to the associated results. When `help.markdown` is available, it is displayed instead of `help.text`. | +| `defaultConfiguration.level` | **Optional.** Default severity level of the rule. {% data variables.product.prodname_code_scanning_capc %} uses severity levels to help you understand how critical the result is for a given rule. This value can be overridden by the `level` attribute in the `result` object. For more information, see the [`result` object](#result-object). Default: `warning`. | +| `help.text` | **Required.** Documentation for the rule using text format. {% data variables.product.prodname_code_scanning_capc %} displays this help documentation next to the associated results. | +| `help.markdown` | **Recommended.** Documentation for the rule using Markdown format. {% data variables.product.prodname_code_scanning_capc %} displays this help documentation next to the associated results. When `help.markdown` is available, it is displayed instead of `help.text`. | | `properties.tags[]` | **Optional.** An array of strings. {% data variables.product.prodname_code_scanning_capc %} uses `tags` to allow you to filter results on {% data variables.product.prodname_dotcom %}. For example, it is possible to filter to all results that have the tag `security`. | | `properties.precision` | **Recommended.** A string that indicates how often the results indicated by this rule are true. For example, if a rule has a known high false-positive rate, the precision should be `low`. {% data variables.product.prodname_code_scanning_capc %} orders results by precision on {% data variables.product.prodname_dotcom %} so that the results with the highest `level`, and highest `precision` are shown first. Can be one of: `very-high`, `high`, `medium`, or `low`. | #### `result` object -| Name | Beschreibung | -| --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `ruleId` | **Optional.** The unique identifier of the rule (`reportingDescriptor.id`). For more information, see the [`reportingDescriptor` object](#reportingdescriptor-object). {% data variables.product.prodname_code_scanning_capc %} uses the rule identifier to filter results by rule on {% data variables.product.prodname_dotcom %}. | -| `ruleIndex` | **Optional.** The index of the associated rule (`reportingDescriptor` object) in the tool component `rules` array. For more information, see the [`run` object](#run-object). | -| `rule` | **Optional.** A reference used to locate the rule (reporting descriptor) for this result. For more information, see the [`reportingDescriptor` object](#reportingdescriptor-object). | -| `level` | **Optional.** The severity of the result. This level overrides the default severity defined by the rule. {% data variables.product.prodname_code_scanning_capc %} uses the level to filter results by severity on {% data variables.product.prodname_dotcom %}. | -| `message.text` | **Required.** A message that describes the result. {% data variables.product.prodname_code_scanning_capc %} displays the message text as the title of the result. Only the first sentence of the message will be displayed when visible space is limited. | -| `locations[]` | **Required.** The set of locations where the result was detected. Only one location should be included unless the problem can only be corrected by making a change at every specified location. **Note:** At least one location is required for {% data variables.product.prodname_code_scanning %} to display a result. {% data variables.product.prodname_code_scanning_capc %} will use this property to decide which file to annotate with the result. Only the first value of this array is used. All other values are ignored. | +| Name | Beschreibung | +| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `ruleId` | **Optional.** The unique identifier of the rule (`reportingDescriptor.id`). For more information, see the [`reportingDescriptor` object](#reportingdescriptor-object). {% data variables.product.prodname_code_scanning_capc %} uses the rule identifier to filter results by rule on {% data variables.product.prodname_dotcom %}. | +| `ruleIndex` | **Optional.** The index of the associated rule (`reportingDescriptor` object) in the tool component `rules` array. For more information, see the [`run` object](#run-object). | +| `rule` | **Optional.** A reference used to locate the rule (reporting descriptor) for this result. For more information, see the [`reportingDescriptor` object](#reportingdescriptor-object). | +| `level` | **Optional.** The severity of the result. This level overrides the default severity defined by the rule. {% data variables.product.prodname_code_scanning_capc %} uses the level to filter results by severity on {% data variables.product.prodname_dotcom %}. | +| `message.text` | **Required.** A message that describes the result. {% data variables.product.prodname_code_scanning_capc %} displays the message text as the title of the result. Only the first sentence of the message will be displayed when visible space is limited. | +| `locations[]` | **Required.** The set of locations where the result was detected. Only one location should be included unless the problem can only be corrected by making a change at every specified location. **Note:** At least one location is required for {% data variables.product.prodname_code_scanning %} to display a result. {% data variables.product.prodname_code_scanning_capc %} will use this property to decide which file to annotate with the result. Only the first value of this array is used. All other values are ignored. | | `partialFingerprints` | **Required.** A set of strings used to track the unique identity of the result. {% data variables.product.prodname_code_scanning_capc %} uses `partialFingerprints` to accurately identify which results are the same across commits and branches. {% data variables.product.prodname_code_scanning_capc %} will attempt to use `partialFingerprints` if they exist. If you are uploading third-party SARIF files with the `upload-action`, the action will create `partialFingerprints` for you when they are not included in the SARIF file. For more information, see "[Preventing duplicate alerts using fingerprints](#preventing-duplicate-alerts-using-fingerprints)." **Note:** {% data variables.product.prodname_code_scanning_capc %} only uses the `primaryLocationLineHash`. | -| `codeFlows[].threadFlows[].locations[]` | **Optional.** An array of `location` objects for a `threadFlow` object, which describes the progress of a program through a thread of execution. A `codeFlow` object describes a pattern of code execution used to detect a result. If code flows are provided, {% data variables.product.prodname_code_scanning %} will expand code flows on {% data variables.product.prodname_dotcom %} for the relevant result. For more information, see the [`location` object](#location-object). | -| `relatedLocations[]` | A set of locations relevant to this result. {% data variables.product.prodname_code_scanning_capc %} will link to related locations when they are embedded in the result message. For more information, see the [`location` object](#location-object). | -| `suppressions[].state` | **Optional.** When the `state` is set to `accepted`, {% data variables.product.prodname_code_scanning %} will update the state of the result to `Closed` on {% data variables.product.prodname_dotcom %}. | +| `codeFlows[].threadFlows[].locations[]` | **Optional.** An array of `location` objects for a `threadFlow` object, which describes the progress of a program through a thread of execution. A `codeFlow` object describes a pattern of code execution used to detect a result. If code flows are provided, {% data variables.product.prodname_code_scanning %} will expand code flows on {% data variables.product.prodname_dotcom %} for the relevant result. For more information, see the [`location` object](#location-object). | +| `relatedLocations[]` | A set of locations relevant to this result. {% data variables.product.prodname_code_scanning_capc %} will link to related locations when they are embedded in the result message. For more information, see the [`location` object](#location-object). | +| `suppressions[].state` | **Optional.** When the `state` is set to `accepted`, {% data variables.product.prodname_code_scanning %} will update the state of the result to `Closed` on {% data variables.product.prodname_dotcom %}. | #### `location` object @@ -100,13 +105,13 @@ A location within a programming artifact, such as a file in the repository or a #### `physicalLocation` object -| Name | Beschreibung | -| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Name | Beschreibung | +| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `artifactLocation.uri` | **Required.** A URI indicating the location of an artifact, usually a file either in the repository or generated during a build. If the URI is relative, it should be relative to the root of the {% data variables.product.prodname_dotcom %} repository being analyzed. For example, main.js or src/script.js are relative to the root of the repository. If the URI is absolute, {% data variables.product.prodname_code_scanning %} can use the URI to checkout the artifact and match up files in the repository. For example, `https://github.com/github/example/blob/00/src/promiseUtils.js`. | -| `region.startLine` | **Required.** The line number of the first character in the region. | -| `region.startColumn` | **Required.** The column number of the first character in the region. | -| `region.endLine` | **Required.** The line number of the last character in the region. | -| `region.endColumn` | **Required.** The column number of the character following the end of the region. | +| `region.startLine` | **Required.** The line number of the first character in the region. | +| `region.startColumn` | **Required.** The column number of the first character in the region. | +| `region.endLine` | **Required.** The line number of the last character in the region. | +| `region.endColumn` | **Required.** The column number of the character following the end of the region. | ### SARIF output file examples @@ -119,38 +124,47 @@ This SARIF output file has example values to show the minimum required propertie ```json { - "$schema" : "https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json", - "version" : "2.1.0", - "runs" : - [ + "$schema": "https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json", + "version": "2.1.0", + "runs": [ { - "tool" : { - "driver" : { - "name" : "Tool Name" - } - }, - "results" : [ { - "message" : { - "text" : "Result text. This result does not have a rule associated." - }, - "locations" : [ { - "physicalLocation" : { - "artifactLocation" : { - "uri" : "src/build.cmd" - }, - "region" : { - "startLine" : 2, - "startColumn" : 7, - "endColumn" : 10 + "tool": { + "driver": { + "name": "Tool Name", + "rules": [ + { + "id": "R01" } + ] + } + }, + "results": [ + { + "ruleId": "R01", + "message": { + "text": "Result text. This result does not have a rule associated." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "fileURI" + }, + "region": { + "startLine": 2, + "startColumn": 7, + "endColumn": 10 + } + } } - } ], - "partialFingerprints" : { - "primaryLocationLineHash" : "39fa2ee980eb94b0:1" + ], + "partialFingerprints": { + "primaryLocationLineHash": "39fa2ee980eb94b0:1" + } } - }] - } - ] + ] + } + ] } ``` @@ -170,7 +184,7 @@ This SARIF output file has example values to show all supported SARIF properties "semanticVersion": "2.0.0", "rules": [ { - "id": "js/unused-local-variable", + "id": "3f292041e51d22005ce48f39df3585d44ce1b0ad", "name": "js/unused-local-variable", "shortDescription": { "text": "Unused variable, import, function or class" @@ -189,7 +203,7 @@ This SARIF output file has example values to show all supported SARIF properties } }, { - "id": "js/inconsistent-use-of-new", + "id": "d5b664aefd5ca4b21b52fdc1d744d7d6ab6886d0", "name": "js/inconsistent-use-of-new", "shortDescription": { "text": "Inconsistent use of 'new'" @@ -197,7 +211,6 @@ This SARIF output file has example values to show all supported SARIF properties "fullDescription": { "text": "If a function is intended to be a constructor, it should always be invoked with 'new'. Otherwise, it should always be invoked as a normal function, that is, without 'new'." }, - "defaultConfiguration": null, "properties": { "tags": [ "reliability", @@ -206,13 +219,16 @@ This SARIF output file has example values to show all supported SARIF properties ], "precision": "very-high" } + }, + { + "id": "R01" } ] } }, "results": [ { - "ruleId": "js/unused-local-variable", + "ruleId": "3f292041e51d22005ce48f39df3585d44ce1b0ad", "ruleIndex": 0, "message": { "text": "Unused variable foo." @@ -222,8 +238,7 @@ This SARIF output file has example values to show all supported SARIF properties "physicalLocation": { "artifactLocation": { "uri": "main.js", - "uriBaseId": "%SRCROOT%", - "index": 0 + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 2, @@ -239,7 +254,7 @@ This SARIF output file has example values to show all supported SARIF properties } }, { - "ruleId": "js/inconsistent-use-of-new", + "ruleId": "d5b664aefd5ca4b21b52fdc1d744d7d6ab6886d0", "ruleIndex": 1, "message": { "text": "Function resolvingPromise is sometimes invoked as a constructor (for example [here](1)), and sometimes as a normal function (for example [here](2))." @@ -248,8 +263,8 @@ This SARIF output file has example values to show all supported SARIF properties { "physicalLocation": { "artifactLocation": { - "uri": "https://github.com/github/example/blob/0000000000000000000000000000000000000000/src/promiseUtils.js", - "index": 1 + "uri": "src/promises.js", + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 2 @@ -267,8 +282,7 @@ This SARIF output file has example values to show all supported SARIF properties "physicalLocation": { "artifactLocation": { "uri": "src/ParseObject.js", - "uriBaseId": "%SRCROOT%", - "index": 3 + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 2281, @@ -285,8 +299,7 @@ This SARIF output file has example values to show all supported SARIF properties "physicalLocation": { "artifactLocation": { "uri": "src/LiveQueryClient.js", - "uriBaseId": "%SRCROOT%", - "index": 2 + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 166 @@ -299,6 +312,7 @@ This SARIF output file has example values to show all supported SARIF properties ] }, { + "ruleId": "R01", "message": { "text": "Specifying both [ruleIndex](1) and [ruleID](2) might lead to inconsistencies." }, @@ -308,8 +322,7 @@ This SARIF output file has example values to show all supported SARIF properties "physicalLocation": { "artifactLocation": { "uri": "full.sarif", - "uriBaseId": "%SRCROOT%", - "index": 0 + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 54, @@ -403,12 +416,6 @@ This SARIF output file has example values to show all supported SARIF properties } } ], - "newlineSequences": [ - "\r\n", - "\n", - "", - "
 " - ], "columnKind": "utf16CodeUnits" } ] diff --git a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md new file mode 100644 index 000000000000..88dcad87f002 --- /dev/null +++ b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md @@ -0,0 +1,48 @@ +--- +title: Triaging code scanning alerts in pull requests +shortTitle: Triaging alerts in pull requests +intro: 'When {% data variables.product.prodname_code_scanning %} identifies a problem in a pull request, you can review the highlighted code and resolve the alert.' +product: '{% data reusables.gated-features.code-scanning %}' +permissions: 'People with write permission to a repository can resolve {% data variables.product.prodname_code_scanning %} alerts.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta %} + +### About {% data variables.product.prodname_code_scanning %} results on pull requests + +In repositories where {% data variables.product.prodname_code_scanning %} is configured as a pull request check, {% data variables.product.prodname_code_scanning %} checks the code in the pull request. By default, this is limited to pull requests that target the default branch or protected branches, but you can change this configuration within {% data variables.product.prodname_actions %} or in a third-party CI/CD system. If merging the changes would introduce new {% data variables.product.prodname_code_scanning %} alerts to the target branch, these are reported as check results in the pull request. The alerts are also shown as annotations in the **Files changed** tab of the pull request. If you have write permission for the repository, you can see any existing {% data variables.product.prodname_code_scanning %} alerts on the **Security** tab. For information about repository alerts, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." + +If {% data variables.product.prodname_code_scanning %} has any results with a severity of `error`, the check fails and the error is reported in the check results. If all the results found by {% data variables.product.prodname_code_scanning %} have lower severities, the alerts are treated as warnings or notices and the check succeeds. If your pull request targets a protected branch, and the repository owner has configured required status checks, then you must either fix or close any error alerts before the pull request can be merged. Weitere Informationen finden Sie unter „[Informationen zu erforderlichen Statuschecks](/github/administering-a-repository/about-required-status-checks)“. + +![Example pull request check status with {% data variables.product.prodname_code_scanning %} alert](/assets/images/help/repository/code-scanning-check-failure.png) + +### About {% data variables.product.prodname_code_scanning %} as a pull request check + +There are many options for configuring {% data variables.product.prodname_code_scanning %} as a pull request check, so the exact setup of each repository will vary and some will have more than one check. The check that contains the results of {% data variables.product.prodname_code_scanning %} is: **Code scanning results**. + +If the repository uses the {% data variables.product.prodname_codeql_workflow %} a **{% data variables.product.prodname_codeql %} / Analyze (LANGUAGE)** check is run for each language before the results check runs. The analysis check may fail if there are configuration problems, or if the pull request breaks the build for a language that the analysis needs to compile (for example, C/C++, C#, or Java). As with other pull request checks, you can see full details of the check failure on the **Checks** tab. For more information about configuring and troubleshooting, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" or "[Troubleshooting {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning)." + +### Triaging an alert on your pull request + +When you look at the **Files changed** tab for a pull request, you see annotations for any lines of code that triggered the alert. + +![Example {% data variables.product.prodname_code_scanning %} alert shown as an annotation in the "Files changed" view of a pull request](/assets/images/help/repository/code-scanning-pr-annotation.png) + +Some annotations contain links with extra context for the alert. In the example above, from {% data variables.product.prodname_codeql %} analysis, you can click **user-provided value** to see where the untrusted data enters the data flow (this is referred to as the source). In this case you can view the full path from the source to the code that uses the data (the sink) by clicking **Show paths**. This makes it easy to check whether the data is untrusted or if the analysis failed to recognize a data sanitization step between the source and the sink. For information about analyzing data flow using {% data variables.product.prodname_codeql %}, see "[About data flow analysis](https://help.semmle.com/QL/learn-ql/intro-to-data-flow.html)." + +For more information about an alert, click **Show more details** on the annotation. This allows you to see all of the context and metadata provided by the tool in an alert view. In the example below, you can see tags showing the severity, type, and relevant common weakness enumerations (CWEs) for the problem. The view also shows which commit introduced the problem. + +Alerts from some tools, like {% data variables.product.prodname_codeql %}, also include a description and a **Show more** link for guidance on how to fix the problem in the code. + +![Example of "Show more details" for a {% data variables.product.prodname_code_scanning %} alert in a pull request](/assets/images/help/repository/code-scanning-pr-alert.png) + +### Resolving an alert on your pull request + +Anyone with write permission for a repository can resolve alerts on a pull request. If you commit changes to the pull request this triggers a new run of the pull request checks. If your changes fix the problem, the alert is resolved and the annotation removed. + +If you don't think that an alert needs to be fixed, you can close the alert manually. {% data reusables.code-scanning.close-alert-examples %} The **Close** button is available in annotations and in the alerts view if you have write permission for the repository. + +{% data reusables.code-scanning.false-positive-fix-codeql %} diff --git a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md new file mode 100644 index 000000000000..317698c3e0b0 --- /dev/null +++ b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md @@ -0,0 +1,52 @@ +--- +title: Troubleshooting CodeQL code scanning in your CI system +shortTitle: Troubleshooting in your CI +intro: 'If you''re having problems with the {% data variables.product.prodname_codeql_runner %}, you can troubleshoot by using these tips.' +product: '{% data reusables.gated-features.code-scanning %}' +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning-in-your-ci-system +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta-codeql-runner %} +{% data reusables.code-scanning.beta %} + +### The `init` command takes too long + +Before the {% data variables.product.prodname_codeql_runner %} can build and analyze code, it needs access to the {% data variables.product.prodname_codeql %} bundle, which contains the {% data variables.product.prodname_codeql %} CLI and the {% data variables.product.prodname_codeql %} libraries. + +When you use the {% data variables.product.prodname_codeql_runner %} for the first time on your machine, the `init` command downloads the {% data variables.product.prodname_codeql %} bundle to your machine. This download can take a few minutes. The {% data variables.product.prodname_codeql %} bundle is cached between runs, so if you use the {% data variables.product.prodname_codeql_runner %} again on the same machine, it won't download the {% data variables.product.prodname_codeql %} bundle again. + +To avoid this automatic download, you can manually download the {% data variables.product.prodname_codeql %} bundle to your machine and specify the path using the `--codeql-path` flag of the `init` command. + +### No code found during the build + +If the `analyze` command for the {% data variables.product.prodname_codeql_runner %} fails with an error `No source code was seen during the build`, this indicates that {% data variables.product.prodname_codeql %} was unable to monitor your code. Several reasons can explain such a failure. + +1. Automatic language detection identified a supported language, but there is no analyzable code of that language in the repository. A typical example is when our language detection service finds a file associated with a particular programming language like a `.h`, or `.gyp` file, but no corresponding executable code is present in the repository. To solve the problem, you can manually define the languages you want to analyze by using the `--languages` flag of the `init` command. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system)." + +1. You're analyzing a compiled language without using the `autobuild` command and you run the build steps yourself after the `init` step. For the build to work, you must set up the environment such that the {% data variables.product.prodname_codeql_runner %} can monitor the code. The `init` command generates instructions for how to export the required environment variables, so you can copy and run the script after you've run the `init` command. + - On macOS and Linux: + ```shell + $ . codeql-runner/codeql-env.sh + ``` + - On Windows, using the Command shell (`cmd`) or a batch file (`.bat`): + ```shell + > call codeql-runner\codeql-env.bat + ``` + - On Windows, using PowerShell: + ```shell + > cat codeql-runner\codeql-env.sh | Invoke-Expression + ``` + + The environment variables are also stored in the file `codeql-runner/codeql-env.json`. This file contains a single JSON object which maps environment variable keys to values. If you can't run the script generated by the `init` command, then you can use the data in JSON format instead. + + {% note %} + + **Note:** If you used the `--temp-dir` flag of the `init` command to specify a custom directory for temporary files, the path to the `codeql-env` files might be different. + + {% endnote %} + +1. The code is built in a container or on a separate machine. If you use a containerized build or if you outsource the build to another machine, make sure to run the {% data variables.product.prodname_codeql_runner %} in the container or on the machine where your build task takes place. diff --git a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md new file mode 100644 index 000000000000..f42dbb3db617 --- /dev/null +++ b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md @@ -0,0 +1,125 @@ +--- +title: Troubleshooting the CodeQL workflow +shortTitle: Troubleshooting CodeQL +intro: 'If you''re having problems with {% data variables.product.prodname_code_scanning %}, you can troubleshoot by using these tips for resolving issues.' +product: '{% data reusables.gated-features.code-scanning %}' +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta %} + +### Automatic build for a compiled language fails + +If an automatic build of code for a compiled language within your project fails, try the following troubleshooting steps. + +- Remove the `autobuild` step from your {% data variables.product.prodname_code_scanning %} workflow and add specific build steps. For information about editing the workflow, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)." For more information about replacing the `autobuild` step, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." + +- If your workflow doesn't explicitly specify the languages to analyze, {% data variables.product.prodname_codeql %} implicitly detects the supported languages in your code base. In this configuration, out of the compiled languages C/C++, C#, and Java, {% data variables.product.prodname_codeql %} only analyzes the language with the most source files. Edit the workflow and add a build matrix specifying the languages you want to analyze. The default CodeQL analysis workflow uses such a matrix. + + The following extracts from a workflow show how you can use a matrix within the job strategy to specify languages, and then reference each language within the "Initialize {% data variables.product.prodname_codeql %}" step: + + ```yaml + jobs: + analyze: + ... + strategy: + fail-fast: false + matrix: + language: ['csharp', 'cpp', 'javascript'] + + ... + + - name: Initialize {% data variables.product.prodname_codeql %} + uses: github/codeql-action/init@v1 + with: + languages: {% raw %}${{ matrix.language }}{% endraw %} + ``` + + For more information about editing the workflow, see "[Configuring code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." + +### No code found during the build + +If your workflow fails with an error `No source code was seen during the build` or `The process '/opt/hostedtoolcache/CodeQL/0.0.0-20200630/x64/codeql/codeql' failed with exit code 32`, this indicates that {% data variables.product.prodname_codeql %} was unable to monitor your code. Several reasons can explain such a failure: + +1. Automatic language detection identified a supported language, but there is no analyzable code of that language in the repository. A typical example is when our language detection service finds a file associated with a particular programming language like a `.h`, or `.gyp` file, but no corresponding executable code is present in the repository. To solve the problem, you can manually define the languages you want to analyze by updating the list of languages in the `language` matrix. For example, the following configuration will analyze only Go, and JavaScript. + + ```yaml + strategy: + fail-fast: false + matrix: + # Override automatic language detection by changing the list below + # Supported options are: + # ['csharp', 'cpp', 'go', 'java', 'javascript', 'python'] + language: ['go', 'javascript'] + ``` +For more information, see the workflow extract in "[Automatic build for a compiled language fails](#automatic-build-for-a-compiled-language-fails)" above. +1. Your {% data variables.product.prodname_code_scanning %} workflow is analyzing a compiled language (C, C++, C#, or Java), but the code was not compiled. By default, the {% data variables.product.prodname_codeql %} analysis workflow contains an `autobuild` step, however, this step represents a best effort process, and may not succeed in building your code, depending on your specific build environment. Compilation may also fail if you have removed the `autobuild` step and did not include build steps manually. For more information about specifying build steps, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." +1. Your workflow is analyzing a compiled language (C, C++, C#, or Java), but portions of your build are cached to improve performance (most likely to occur with build systems like Gradle or Bazel). Since {% data variables.product.prodname_codeql %} observes the activity of the compiler to understand the data flows in a repository, {% data variables.product.prodname_codeql %} requires a complete build to take place in order to perform analysis. +1. Your workflow is analyzing a compiled language (C, C++, C#, or Java), but compilation does not occur between the `init` and `analyze` steps in the workflow. {% data variables.product.prodname_codeql %} requires that your build happens in between these two steps in order to observe the activity of the compiler and perform analysis. +1. Your compiled code (in C, C++, C#, or Java) was compiled successfully, but {% data variables.product.prodname_codeql %} was unable to detect the compiler invocations. The most common causes are certain configuration options like running your build process in a container, if you're building using a distributed build system external to {% data variables.product.prodname_actions %} using a daemon process, or if {% data variables.product.prodname_codeql %} isn't aware of the specific compiler you are using. + + For C# projects using either `dotnet build` or `msbuild` which target .NET Core 2, you should specify `/p:UseSharedCompilation=false` in your workflow's `run` step, when you build your code. The `UseSharedCompilation` flag isn't necessary for .NET Core 3.0 and later. + + For example, the following configuration for C# will pass the flag during the first build step. + + ``` yaml + - run: | + dotnet build /p:UseSharedCompilation=false + ``` + + If you encounter another problem with your specific compiler or configuration, contact {% data variables.contact.contact_support %}. + +For more information about specifying build steps, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." + +### Portions of my repository were not analyzed using `autobuild` + +The {% data variables.product.prodname_codeql %} `autobuild` feature uses heuristics to build the code in a repository, however, sometimes this approach results in incomplete analysis of a repository. For example, when multiple `build.sh` commands exist in a single repository, the analysis may not complete since the `autobuild` step will only execute one of the commands. The solution is to replace the `autobuild` step with build steps which build all of the source code which you wish to analyze. For more information, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." + +### Error: "Server error" + +If the run of a workflow for {% data variables.product.prodname_code_scanning %} fails due to a server error, try running the workflow again. If the problem persists, contact {% data variables.contact.contact_support %}. + +### Error: "Out of disk" or "Out of memory" + +On very large projects, {% data variables.product.prodname_codeql %} may run out of disk or memory on the runner. +{% if currentVersion == "free-pro-team@latest" %}If you encounter this issue on a hosted {% data variables.product.prodname_actions %} runner, contact {% data variables.contact.contact_support %} so that we can investigate the problem. +{% else %}If you encounter this issue, try increasing the memory on the runner.{% endif %} + +### The build takes too long + +If your build with {% data variables.product.prodname_codeql %} analysis takes too long to run, there are several approaches you can try to reduce the build time. + +#### Increase the memory or cores + +If you use self-hosted runners to run {% data variables.product.prodname_codeql %} analysis, you can increase the memory or the number of cores on those runners. + +#### Use matrix builds to parallelize the analysis + +The default {% data variables.product.prodname_codeql_workflow %} uses a build matrix of languages, which causes the analysis of each language to run in parallel. If you have specified the languages you want to analyze directly in the "Initialize CodeQL" step, analysis of each language will happen sequentially. To speed up analysis of multiple languages, modify your workflow to use a matrix. For more information, see the workflow extract in "[Automatic build for a compiled language fails](#automatic-build-for-a-compiled-language-fails)" above. + +#### Reduce the amount of code being analyzed in a single workflow + +Analysis time is typically proportional to the amount of code being analyzed. You can reduce the analysis time by reducing the amount of code being analyzed at once, for example, by excluding test code, or breaking analysis into multiple workflows that analyze only a subset of your code at a time. + +For compiled languages like Java, C, C++, and C#, {% data variables.product.prodname_codeql %} analyzes all of the code which was built during the workflow run. To limit the amount of code being analyzed, build only the code which you wish to analyze by specifying your own build steps in a `run` block. You can combine specifying your own build steps with using the `paths` or `paths-ignore` filters on the `pull_request` and `push` events to ensure that your workflow only runs when specific code is changed. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)." + +For interpreted languages like Go, JavaScript, Python, and TypeScript, that {% data variables.product.prodname_codeql %} analyzes without a specific build, you can specify additional configuration options to limit the amount of code to analyze. For more information, see "[Specifying directories to scan](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#specifying-directories-to-scan)." + +If you split your analysis into multiple workflows as described above, we still recommend that you have at least one workflow which runs on a `schedule` which analyzes all of the code in your repository. Because {% data variables.product.prodname_codeql %} analyzes data flows between components, some complex security behaviors may only be detected on a complete build. + +#### Run only during a `schedule` event + +If your analysis is still too slow to be run during `push` or `pull_request` events, then you may want to only trigger analysis on the `schedule` event. For more information, see "[Events](/actions/learn-github-actions/introduction-to-github-actions#events)." + +{% if currentVersion == "free-pro-team@latest" %} +### Results differ between analysis platforms + +If you are analyzing code written in Python, you may see different results depending on whether you run the {% data variables.product.prodname_codeql_workflow %} on Linux, macOS, or Windows. + +On GitHub-hosted runners that use Linux, the {% data variables.product.prodname_codeql_workflow %} tries to install and analyze Python dependencies, which could lead to more results. To disable the auto-install, add `setup-python-dependencies: false` to the "Initialize CodeQL" step of the workflow. For more information about configuring the analysis of Python dependencies, see "[Analyzing Python dependencies](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#analyzing-python-dependencies)." + +{% endif %} \ No newline at end of file diff --git a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md index a787e5643b52..08bef6406185 100644 --- a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md +++ b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md @@ -16,7 +16,7 @@ versions: ### About SARIF file uploads for {% data variables.product.prodname_code_scanning %} -If your SARIF file doesn't include `partialFingerprints`, the `upload-sarif` action will calculate the `partialFingerprints` field for you and attempt to prevent duplicate alerts. {% data variables.product.prodname_dotcom %} can only create `partialFingerprints` when the repository contains both the SARIF file and the source code used in the static analysis. Weitere Informationen findest Du unter „[Warnungen von {% data variables.product.prodname_code_scanning %} verwalten](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." +If your SARIF file doesn't include `partialFingerprints`, the `upload-sarif` action will calculate the `partialFingerprints` field for you and attempt to prevent duplicate alerts. {% data variables.product.prodname_dotcom %} can only create `partialFingerprints` when the repository contains both the SARIF file and the source code used in the static analysis. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." You can generate SARIF files using many static analysis security testing tools, including {% data variables.product.prodname_codeql %}. To upload results from third-party tools, you must use the Static Analysis Results Interchange Format (SARIF) 2.1.0 format. For more information, see "[About SARIF support for code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-sarif-support-for-code-scanning)." @@ -24,12 +24,12 @@ You can upload the results using {% data variables.product.prodname_actions %}{% - {% data variables.product.prodname_actions %} to run the {% data variables.product.prodname_codeql %} action, there is no further action required. The {% data variables.product.prodname_codeql %} action uploads the SARIF file automatically when it completes analysis. - „[Einen Workflow-Lauf verwalten](/actions/configuring-and-managing-workflows/managing-a-workflow-run#viewing-your-workflow-history)“ -- {% data variables.product.prodname_dotcom %} will display {% data variables.product.prodname_code_scanning %} alerts from the uploaded SARIF file in your repository. Weitere Informationen findest Du unter „[Warnungen von {% data variables.product.prodname_code_scanning %} verwalten](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." +- {% data variables.product.prodname_dotcom %} will display {% data variables.product.prodname_code_scanning %} alerts from the uploaded SARIF file in your repository. If you block the automatic upload, when you are ready to upload results you can use the `upload` command (for more information, see "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)"). - The SARIF file can be generated from a SARIF-compatible analysis tool that you run in the same {% data variables.product.prodname_actions %} workflow used to upload the file. Alternatively, when the file is generated as an artifact outside of your repository, you can push the SARIF file directly to a repository and use a workflow to upload the SARIF file. ### Uploading a {% data variables.product.prodname_code_scanning %} analysis with {% data variables.product.prodname_actions %} -To upload a third-party SARIF file to {% data variables.product.prodname_dotcom %}, you'll need a {% data variables.product.prodname_actions %} workflow. For more information, see "[About {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)" and "[Configuring a workflow](/actions/configuring-and-managing-workflows/configuring-a-workflow)". +To upload a third-party SARIF file to {% data variables.product.prodname_dotcom %}, you'll need a {% data variables.product.prodname_actions %} workflow. For more information, see "[Learn {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)" and "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." Your workflow will need to use the `upload-sarif` action, which has input parameters that you can use to configure the upload. It has input parameters that you can use to configure the upload. The main input parameter you'll use is `sarif-file`, which configures the file or directory of SARIF files to be uploaded. The directory or file path is relative to the root of the repository. For more information see the [`upload-sarif` action](https://github.com/github/codeql-action/tree/HEAD/upload-sarif). @@ -43,7 +43,7 @@ You can create a new workflow that uploads SARIF files after you commit them to This example workflow runs anytime commits are pushed to the repository. The action uses the `partialFingerprints` property to determine if changes have occurred. In addition to running when commits are pushed, the workflow is scheduled to run once per week. Weitere Informationen findest Du unter "[Ereignisse, die Workflows auslösen](/actions/reference/events-that-trigger-workflows)." -This workflow uploads the `results.sarif` file located in the root of the repository. For more information about creating a workflow file, see "[Configuring a workflow](/actions/configuring-and-managing-workflows/configuring-a-workflow)." +This workflow uploads the `results.sarif` file located in the root of the repository. For more information about creating a workflow file, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." Alternatively, you could modify this workflow to upload a directory of SARIF files. For example, you could place all SARIF files in a directory in the root of your repository called `sarif-output` and set the action's input parameter `sarif_file` to `sarif-output`. @@ -73,11 +73,11 @@ jobs: #### Example workflow that runs the ESLint analysis tool -If you generate your third-party SARIF file as part of a continuous integration (CI) workflow, you can add the `upload-sarif` action as a step after running your CI tests. If you don't already have a CI workflow, you can create one using a {% data variables.product.prodname_actions %} template. Weitere Informationen findest Du unter „[Mit vorkonfigurierten Workflow-Vorlagen beginnen](/actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates)“. +If you generate your third-party SARIF file as part of a continuous integration (CI) workflow, you can add the `upload-sarif` action as a step after running your CI tests. If you don't already have a CI workflow, you can create one using a {% data variables.product.prodname_actions %} template. For more information, see the "[{% data variables.product.prodname_actions %} quickstart](/actions/quickstart)." This example workflow runs anytime commits are pushed to the repository. The action uses the `partialFingerprints` property to determine if changes have occurred. In addition to running when commits are pushed, the workflow is scheduled to run once per week. Weitere Informationen findest Du unter "[Ereignisse, die Workflows auslösen](/actions/reference/events-that-trigger-workflows)." -The workflow shows an example of running the ESLint static analysis tool as a step in a workflow. The `Run ESLint` step runs the ESLint tool and outputs the `results.sarif` file. The workflow then uploads the `results.sarif` file to {% data variables.product.prodname_dotcom %} using the `upload-sarif` action. For more information about creating a workflow file, see "[Configuring a workflow](/actions/configuring-and-managing-workflows/configuring-a-workflow)." +The workflow shows an example of running the ESLint static analysis tool as a step in a workflow. The `Run ESLint` step runs the ESLint tool and outputs the `results.sarif` file. The workflow then uploads the `results.sarif` file to {% data variables.product.prodname_dotcom %} using the `upload-sarif` action. For more information about creating a workflow file, see "[Introduction to GitHub Actions](/actions/learn-github-actions/introduction-to-github-actions)." ```yml name: "ESLint analysis" @@ -109,6 +109,6 @@ jobs: ### Weiterführende Informationen - "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions)" -- "[Managing a workflow run](/actions/configuring-and-managing-workflows/managing-a-workflow-run#viewing-your-workflow-history)" -- „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions)“ +- "[Viewing your workflow history](/actions/managing-workflow-runs/viewing-workflow-run-history)" +- "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)" - "[Upload a SARIF file](/rest/reference/code-scanning#upload-a-sarif-file)" diff --git a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md new file mode 100644 index 000000000000..af71f4047d5b --- /dev/null +++ b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md @@ -0,0 +1,11 @@ +--- +title: Using CodeQL code scanning with your existing CI system +shortTitle: CodeQL CI system support +intro: 'The {% data variables.product.prodname_codeql_runner %} allows you to use your existing CI system to run {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %}.' +mapTopic: true +product: '{% data reusables.gated-features.code-scanning %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + diff --git a/translations/de-DE/content/github/getting-started-with-github/access-permissions-on-github.md b/translations/de-DE/content/github/getting-started-with-github/access-permissions-on-github.md index 873ee09c037a..b3d63404b30d 100644 --- a/translations/de-DE/content/github/getting-started-with-github/access-permissions-on-github.md +++ b/translations/de-DE/content/github/getting-started-with-github/access-permissions-on-github.md @@ -17,7 +17,7 @@ Ein Repository, das einem Benutzerkonto gehört, hat zwei Berechtigungsebenen: d ### Organisations-Konten -Organisationsmitglieder können folgende Rollen haben: *Inhaber*{% if currentVersion == "free-pro-team@latest" %}, *Abrechnungsmanager*,{% endif %} oder *Mitglied*. Inhaber haben vollständigen administrativen Zugriff auf Deine Organisation{% if currentVersion == "free-pro-team@latest" %}, wohingegen Abrechnungsmanager die Abrechnungseinstellungen verwalten können{% endif %}. Die Standardrolle für alle übrigen Personen lautet „Mitglied“. Du kannst die Zugriffsberechtigungen für mehrere Mitglieder gleichzeitig in Teams verwalten. Weitere Informationen findest Du unter: +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 %}. Die Standardrolle für alle übrigen Personen lautet „Mitglied“. Du kannst die Zugriffsberechtigungen für mehrere Mitglieder gleichzeitig in Teams verwalten. Weitere Informationen findest Du unter: - „[Berechtigungsebenen für eine Organisation](/articles/permission-levels-for-an-organization)" - „[Projektboardberechtigungen für eine Organisation](/articles/project-board-permissions-for-an-organization)“ - „[Berechtigungsebenen für die Repositorys einer Organisation](/articles/repository-permission-levels-for-an-organization)“ diff --git a/translations/de-DE/content/github/getting-started-with-github/be-social.md b/translations/de-DE/content/github/getting-started-with-github/be-social.md index bb074c15f175..4f39a4171271 100644 --- a/translations/de-DE/content/github/getting-started-with-github/be-social.md +++ b/translations/de-DE/content/github/getting-started-with-github/be-social.md @@ -3,7 +3,7 @@ title: Soziale Interaktion redirect_from: - /be-social/ - /articles/be-social -intro: 'Du kannst mit Personen, Repositorys und Organisationen auf {% data variables.product.prodname_dotcom %} interagieren. Auf Deinem persönlichen Dashboard kannst Du sehen, woran andere gerade arbeiten und mit wem sie sich vernetzen.' +intro: 'Sie können mit Personen, Repositorys und Organisationen auf {% data variables.product.prodname_dotcom %} interagieren. Auf Deinem persönlichen Dashboard kannst Du sehen, woran andere gerade arbeiten und mit wem sie sich vernetzen.' versions: free-pro-team: '*' enterprise-server: '*' @@ -13,7 +13,7 @@ Informationen zum Zugriff auf Dein persönliches Dashboard findest Du unter „[ ### Personen folgen -Wenn Du jemandem auf {% data variables.product.product_location %} folgst, wirst Du auf Deinem persönlichen Dashboard über die Aktivitäten dieser Person benachrichtigt. Weitere Informationen findest Du unter „[Informationen zum persönlichen Dashboard](/articles/about-your-personal-dashboard).“ +Wenn Sie jemandem auf {% data variables.product.product_location %} folgen, werden Sie auf Ihrem persönlichen Dashboard über die Aktivitäten dieser Person benachrichtigt. Weitere Informationen findest Du unter „[Informationen zum persönlichen Dashboard](/articles/about-your-personal-dashboard).“ Klicke auf der Profilseite einer Person auf **Follow** (Folgen), um ihr zu folgen. @@ -21,7 +21,7 @@ Klicke auf der Profilseite einer Person auf **Follow** (Folgen), um ihr zu folge ### Ein Repository beobachten -Du kannst ein Repository beobachten, um über neue Pull Requests und Issues benachrichtigt zu werden. Wenn der Inhaber das Repository aktualisiert, siehst Du die Änderungen auf Deinem persönlichen Dashboard. Weitere Informationen findest Du auf {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}„[Deine Abonnements ansehen](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions){% else %}[Benachrichtigungen von Repositorys aktivieren und deaktivieren](/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories){% endif %}." +Du kannst ein Repository beobachten, um über neue Pull Requests und Issues benachrichtigt zu werden. Wenn der Inhaber das Repository aktualisiert, siehst Du die Änderungen auf Deinem persönlichen 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 %}." Klicke oben bei einem Repository, das Du beobachten möchtest, auf **Watch** (Beobachten). @@ -53,11 +53,11 @@ Organisationen sind gemeinsame Konten, in denen Unternehmen und Open-Source-Proj #### Andere Projekte auf {% data variables.product.prodname_dotcom %} entdecken -Entdecke interessante Projekte durch {% data variables.explore.explore_github %}, [Repositories entdecken](https://github.com/explore) und der {% data variables.explore.trending_page %}. Markiere interessante Projekte mit einem Stern, um sie zu einem späteren Zeitpunkt erneut anzuschauen. Auf Deiner {% data variables.explore.your_stars_page %} kannst Du alle Projekte sehen, die Du mit einem Stern markiert hast. Weitere Informationen finden Sie unter „[Informationen zum persönlichen Dashboard](/articles/about-your-personal-dashboard/)“. +Entdecke interessante Projekte durch {% data variables.explore.explore_github %}, [Repositories entdecken](https://github.com/explore) und der {% data variables.explore.trending_page %}. Markiere interessante Projekte mit einem Stern, um sie zu einem späteren Zeitpunkt erneut anzuschauen. Auf Ihrer {% data variables.explore.your_stars_page %} können Sie alle Projekte sehen, die Sie mit einem Stern markiert haben. Weitere Informationen finden Sie unter „[Informationen zum persönlichen Dashboard](/articles/about-your-personal-dashboard/)“. ### Geschafft! -Du bist jetzt mit der {% data variables.product.product_name %}-Community verbunden. Was möchtest Du als Nächstes tun? +Sie sind jetzt mit der {% data variables.product.product_name %}-Community verbunden. Was möchtest Du als Nächstes tun? ![Ein Projekt mit Stern markieren](/assets/images/help/stars/star-a-project.png) diff --git a/translations/de-DE/content/github/getting-started-with-github/create-a-repo.md b/translations/de-DE/content/github/getting-started-with-github/create-a-repo.md index e31ab484201e..ce140e075989 100644 --- a/translations/de-DE/content/github/getting-started-with-github/create-a-repo.md +++ b/translations/de-DE/content/github/getting-started-with-github/create-a-repo.md @@ -3,13 +3,13 @@ title: Ein Repository erstellen redirect_from: - /create-a-repo/ - /articles/create-a-repo -intro: 'Um Dein Projekt auf {% data variables.product.product_location %} aufzubauen, benötigst Du ein Repository, in dem Du das Projekt speichern kannst.' +intro: 'Um Ihr Projekt auf {% data variables.product.product_location %} aufzubauen, benötigen Sie ein Repository, in dem Sie das Projekt speichern können.' versions: free-pro-team: '*' enterprise-server: '*' --- -Du kannst die unterschiedlichsten Projekte in {% data variables.product.product_name %}-Repositorys speichern, darunter auch Open-Source-Projekte. Mit [Open-Source-Projekten](http://opensource.org/about) kannst Du Code leichter für andere zugänglich machen, um eine bessere, zuverlässigere Software zu entwickeln. +Sie können die unterschiedlichsten Projekte in {% data variables.product.product_name %}-Repositorys speichern, darunter auch Open-Source-Projekte. Mit [Open-Source-Projekten](http://opensource.org/about) kannst Du Code leichter für andere zugänglich machen, um eine bessere, zuverlässigere Software zu entwickeln. {% note %} @@ -19,7 +19,9 @@ Du kannst die unterschiedlichsten Projekte in {% data variables.product.product_ {% data reusables.repositories.create_new %} 2. Gib einen kurzen, leicht merkbaren Namen für Dein Repository ein. Beispiel: „hello world“. ![Feld zum Eingeben eines Repository-Namens](/assets/images/help/repository/create-repository-name.png) -3. Optional kannst Du auch eine Beschreibung des Repositorys hinzufügen. Beispiel: „Mein erstes Repository auf {% data variables.product.product_name %}“. ![Feld zum Eingeben einer Repository-Beschreibung](/assets/images/help/repository/create-repository-desc.png) +3. Optional kannst Du auch eine Beschreibung des Repositorys hinzufügen. For example, "My first repository on +{% data variables.product.product_name %}." + ![Feld zum Eingeben einer Repository-Beschreibung](/assets/images/help/repository/create-repository-desc.png) {% data reusables.repositories.choose-repo-visibility %} {% data reusables.repositories.initialize-with-readme %} {% data reusables.repositories.create-repo %} diff --git a/translations/de-DE/content/github/getting-started-with-github/exploring-early-access-releases-with-feature-preview.md b/translations/de-DE/content/github/getting-started-with-github/exploring-early-access-releases-with-feature-preview.md index 0d1f8c492675..e7e66aab9def 100644 --- a/translations/de-DE/content/github/getting-started-with-github/exploring-early-access-releases-with-feature-preview.md +++ b/translations/de-DE/content/github/getting-started-with-github/exploring-early-access-releases-with-feature-preview.md @@ -1,6 +1,6 @@ --- title: Early-Access-Versionen mit Funktionsvorschau erkunden -intro: 'Du kannst die Funktions-Vorschau benutzen, um Produkte oder Funktionen zu sehen, die sich in der Beta-Version befinden und um jede der Funktionen für Dein Konto zu aktivieren oder zu deaktivieren.' +intro: Du kannst die Funktions-Vorschau benutzen, um Produkte oder Funktionen zu sehen, die sich in der Beta-Version befinden und um jede der Funktionen für Dein Konto zu aktivieren oder zu deaktivieren. redirect_from: - /articles/exploring-early-access-releases-with-feature-preview versions: diff --git a/translations/de-DE/content/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github.md b/translations/de-DE/content/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github.md index 5de882bfdd5a..72c7cae93ac6 100644 --- a/translations/de-DE/content/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github.md +++ b/translations/de-DE/content/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github.md @@ -1,5 +1,5 @@ --- -title: 'Möglichkeiten finden, um zu Open-Source auf GitHub beizutragen' +title: Möglichkeiten finden, um zu Open-Source auf GitHub beizutragen intro: 'Du kannst Möglichkeiten finden, um zu Open-Source-Projekten auf {% data variables.product.product_name %} beizutragen, die für Dich relevant sind.' redirect_from: - /articles/where-can-i-find-open-source-projects-to-work-on/ diff --git a/translations/de-DE/content/github/getting-started-with-github/following-people.md b/translations/de-DE/content/github/getting-started-with-github/following-people.md index 9af63b620681..59aaee3e491b 100644 --- a/translations/de-DE/content/github/getting-started-with-github/following-people.md +++ b/translations/de-DE/content/github/getting-started-with-github/following-people.md @@ -1,6 +1,6 @@ --- title: Personen folgen -intro: 'Du kannst Personen auf {% data variables.product.product_name %} folgen, um Benachrichtigungen über ihre Aktivitäten zu erhalten{% if currentVersion == "free-pro-team@latest" %} und Projekte in ihren Communitys zu entdecken{% endif %}.' +intro: 'You can follow people on {% 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: @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -Wenn Du Personen folgst, siehst Du deren öffentliche Aktivitäten in der Aktivitätsansicht Deines News-Feeds.{% if currentVersion == "free-pro-team@latest" %} Wenn jemand, dem Du folgst, ein öffentliches Repository mit einem Stern markiert, empfiehlt Dir {% data variables.product.product_name %} möglicherweise dieses Repository in der Entdecken-Ansicht Deines Newsfeed.{% endif %} Um einem Benutzer zu folgen, rufe seine Profilseite auf und klicke unter dem Profilbild auf **Follow** (Folgen). +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, {% 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. ![Schaltfläche „Follow user" (Benutzer folgen)](/assets/images/help/profile/follow-user-button.png) diff --git a/translations/de-DE/content/github/getting-started-with-github/fork-a-repo.md b/translations/de-DE/content/github/getting-started-with-github/fork-a-repo.md index d4293fa5a7ef..e10e1cb7f0f0 100644 --- a/translations/de-DE/content/github/getting-started-with-github/fork-a-repo.md +++ b/translations/de-DE/content/github/getting-started-with-github/fork-a-repo.md @@ -4,7 +4,7 @@ redirect_from: - /fork-a-repo/ - /forking/ - /articles/fork-a-repo -intro: 'Ein Fork ist eine Kopie eines Repositorys. Durch das Forken eines Repositorys kannst Du Änderungen uneingeschränkt testen, ohne Auswirkungen auf das Originalprojekt.' +intro: Ein Fork ist eine Kopie eines Repositorys. Durch das Forken eines Repositorys kannst Du Änderungen uneingeschränkt testen, ohne Auswirkungen auf das Originalprojekt. versions: free-pro-team: '*' enterprise-server: '*' @@ -46,7 +46,7 @@ Wenn Du ein öffentliches Repository von einem Fork eines Projekts eines anderen Das Forken eines Repositorys ist ein einfacher Vorgang, bestehend aus zwei Schritten. Wir haben ein Repository erstellt, mit dem Du das Forken üben kannst. -1. Navigiere auf {% data variables.product.product_location %} zum Repository [octocat/Spoon-Knife](https://github.com/octocat/Spoon-Knife). +1. Navigieren Sie auf {% data variables.product.product_location %} zum Repository [octocat/Spoon-Knife](https://github.com/octocat/Spoon-Knife). 2. Klicke in der oberen rechte Ecke der Seite auf **Fork**. ![Schaltfläche „Fork“ (Fork)](/assets/images/help/repository/fork_button.jpg) ### Deinen Fork regelmäßig synchronisieren @@ -55,13 +55,15 @@ Du forkst vielleicht ein Projekt, um Änderungen an das vorgelagerte - oder orig #### Schritt 1: Git einrichten -Wenn Sie es noch nicht getan haben, müssen Sie zunächst [Git einrichten](/articles/set-up-git). Denken Sie auch daran, die [Authentifizierung bei {% data variables.product.product_location %} über Git einzurichten](/articles/set-up-git#next-steps-authenticating-with-github-from-git). +Wenn Sie es noch nicht getan haben, müssen Sie zunächst [Git einrichten](/articles/set-up-git). Denke auch daran, [Authentifizierungen zu {% data variables.product.product_location %} über Git einzurichten](/articles/set-up-git#next-steps-authenticating-with-github-from-git). #### Schritt 2: einen lokalen Klon Deines Forks erstellen Momentan besitzen Sie einen Fork des Repositorys „Spoon-Knife“, aber Sie haben nicht die Dateien dieses Repositorys auf Ihrem Computer. Deswegen erstellen wir nun einen Klon Deines Forks lokal auf Deinem Computer. -1. Navigiere auf {% data variables.product.product_name %} zu **Deinem Fork** des Repositorys „Spoon-Knife“. +1. On + +{% data variables.product.product_name %}, navigate to **your fork** of the Spoon-Knife repository. {% data reusables.repositories.copy-clone-url %} {% data reusables.command_line.open_the_multi_os_terminal %} {% data reusables.command_line.change-current-directory-clone %} @@ -86,7 +88,9 @@ Jetzt hast Du eine lokale Kopie Deiner Fork des Spoon-Knife-Repositorys. Wenn Du ein Projekt forkst, um Änderungen für das Original-Repository vorzuschlagen, kannst Du Git so konfigurieren, dass Änderungen am vorgelagerten (originalen) Repository in den lokalen Klon Deiner Fork abgerufen werden. -1. Navigiere auf {% data variables.product.product_name %} zum Repository [octocat/Spoon-Knife](https://github.com/octocat/Spoon-Knife). +1. On + +{% data variables.product.product_name %}, navigate to the [octocat/Spoon-Knife](https://github.com/octocat/Spoon-Knife) repository. {% data reusables.repositories.copy-clone-url %} {% data reusables.command_line.open_the_multi_os_terminal %} 4. Wechsle das Verzeichnis zum Speicherort des Forks, den Du bei [Schritt 2: einen lokalen Klon Deines Forks erstellen](#step-2-create-a-local-clone-of-your-fork) geklont hast. @@ -128,7 +132,7 @@ Du kannst nun jede Änderung am Fork vornehmen, einschließlich: Forken Sie ein Repository, um an einem Projekt mitzuarbeiten. {% data reusables.repositories.you-can-fork %} -{% if currentVersion == "free-pro-team@latest" %}Sie können [Explore](https://github.com/explore) durchsuchen, um Projekte zu finden und an Open-Source-Repositorys mitzuarbeiten. Weitere Informationen findest Du unter „[Möglichkeiten finden, um Beiträge zu Open-Source auf {% data variables.product.prodname_dotcom %} zu leisten](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github) ." +{% if currentVersion == "free-pro-team@latest" %}You can browse [Explore](https://github.com/explore) to find projects and start contributing to open source repositories. Weitere Informationen findest du unter „[Möglichkeiten finden, Beiträge an Open-Source auf {% data variables.product.prodname_dotcom %} zu leisten](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)." {% endif %} diff --git a/translations/de-DE/content/github/getting-started-with-github/git-and-github-learning-resources.md b/translations/de-DE/content/github/getting-started-with-github/git-and-github-learning-resources.md index d5ebaf4249a8..621c96db3c34 100644 --- a/translations/de-DE/content/github/getting-started-with-github/git-and-github-learning-resources.md +++ b/translations/de-DE/content/github/getting-started-with-github/git-and-github-learning-resources.md @@ -18,19 +18,19 @@ Mache Dich mit Git vertraut: Besuche die [offizielle Git-Projekt-Website](https: {% if currentVersion == "free-pro-team@latest" %} -{% data variables.product.prodname_learning %} bietet kostenlose interaktive Kurse, die in {% data variables.product.prodname_dotcom %} integriert sind und automatisch sofort Feedback und Hilfestellungen geben. Lerne, wie Du Deinen ersten Pull Request erstellst, Deinen ersten Open-Source-Beitrag leistest, eine {% data variables.product.prodname_pages %}-Website erstellst und vieles mehr. Weitere Informationen zu den angebotenen Kursen findest Du unter [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}). +{% data variables.product.prodname_learning %} bietet kostenlose interaktive Kurse, die in {% data variables.product.prodname_dotcom %} integriert sind und automatisch sofort Feedback und Hilfestellungen geben. Lernen Sie, wie Sie Ihren ersten Pull Request erstellen, Ihren ersten Open-Source-Beitrag leisten, eine {% data variables.product.prodname_pages %}-Website erstellen und vieles mehr. Weitere Informationen zu den angebotenen Kursen findest Du unter [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}). {% endif %} -Lerne {% data variables.product.product_name %} mithilfe unserer [Bootcamp](/categories/bootcamp/)-Artikel besser kennen. Eine Prozesseinführung findest Du unter [{% data variables.product.prodname_dotcom %}-Ablauf](https://guides.github.com/introduction/flow). In unseren [Übersichtsleitfäden](https://guides.github.com) stellen wir Dir Schritt für Schritt die grundlegenden Konzepte vor. +Lernen Sie {% data variables.product.product_name %} mithilfe unserer [Bootcamp](/categories/bootcamp/)-Artikel besser kennen. Eine Prozesseinführung findest Du unter [{% data variables.product.prodname_dotcom %}-Ablauf](https://guides.github.com/introduction/flow). In unseren [Übersichtsleitfäden](https://guides.github.com) stellen wir Dir Schritt für Schritt die grundlegenden Konzepte vor. {% data reusables.support.ask-and-answer-forum %} #### Branches, Forks und Pull Requests -Lerne mit einem interaktiven Tool alles über [Branches bei Git](http://learngitbranching.js.org/). Informiere Dich über [Forks](/articles/about-forks), [Pull Requests](/articles/using-pull-requests) und [die Verwendung von Pull Requests](https://github.com/blog/1124-how-we-use-pull-requests-to-build-github) auf {% data variables.product.prodname_dotcom %}. +Lerne mit einem interaktiven Tool alles über [Branches bei Git](http://learngitbranching.js.org/). Informieren Sie sich über [Forks](/articles/about-forks), [Pull Requests](/articles/using-pull-requests) und [die Verwendung von Pull Requests](https://github.com/blog/1124-how-we-use-pull-requests-to-build-github) auf {% data variables.product.prodname_dotcom %}. -Außerdem stehen Dir Kurzanleitungen zur [Befehlszeile](https://hub.github.com) sowie [Checklisten, Merkzettel etc.](https://services.github.com/on-demand/resources) zu {% data variables.product.prodname_dotcom %} zur Verfügung. +Außerdem stehen Ihnen Kurzanleitungen zur [Befehlszeile](https://hub.github.com) sowie [Checklisten, Merkzettel etc.](https://services.github.com/on-demand/resources) zu {% data variables.product.prodname_dotcom %} zur Verfügung. #### Reinschauen @@ -54,6 +54,6 @@ Auf unserem {% data variables.product.prodname_dotcom %} [YouTube-Kanal „GitHu Ein interaktiver [Online-Git-Kurs](http://www.codeschool.com/courses/git-real) von [Code School](http://codeschool.com) bietet Dutzende von Übungen in mehreren Leveln in einem unterhaltsamen Spieleformat. Gerne kannst Du unsere [.gitignore-Vorlagen](https://github.com/github/gitignore) an Deine Anforderungen anpassen. -Erweitere Deine {% data variables.product.prodname_dotcom %}-Reichweite durch {% if currentVersion == "free-pro-team@latest" %}[Integrationen](/articles/about-integrations){% else %}Integrationen{% endif %} oder die Installation von [{% data variables.product.prodname_desktop %}](https://desktop.github.com) und dem robusten Texteditor [Atom](https://atom.io). +Extend your {% data variables.product.prodname_dotcom %} reach through {% if currentVersion == "free-pro-team@latest" %}[integrations](/articles/about-integrations){% else %}integrations{% endif %}, or by installing [{% data variables.product.prodname_desktop %}](https://desktop.github.com) and the robust [Atom](https://atom.io) text editor. Erfahre in den [Open-Source-Leitfäden](https://opensource.guide/), wie Du Open-Source-Projekte starten und weiterentwickeln kannst. diff --git a/translations/de-DE/content/github/getting-started-with-github/github-cli.md b/translations/de-DE/content/github/getting-started-with-github/github-cli.md index 2dcf3ce7a08c..30174218b8c0 100644 --- a/translations/de-DE/content/github/getting-started-with-github/github-cli.md +++ b/translations/de-DE/content/github/getting-started-with-github/github-cli.md @@ -6,7 +6,7 @@ versions: enterprise-server: '>2.19' --- -### Informationen zu {% data variables.product.prodname_cli %} +### Informationen zum {% data variables.product.prodname_cli %} {% data variables.product.prodname_cli %} is an open source tool for using {% data variables.product.product_name %} from your computer's command line. When you're working from the command line, you can use the {% data variables.product.prodname_cli %} to save time and avoid switching context. diff --git a/translations/de-DE/content/github/getting-started-with-github/github-desktop.md b/translations/de-DE/content/github/getting-started-with-github/github-desktop.md index 52aed6ad4305..6234312c8973 100644 --- a/translations/de-DE/content/github/getting-started-with-github/github-desktop.md +++ b/translations/de-DE/content/github/getting-started-with-github/github-desktop.md @@ -6,7 +6,7 @@ versions: enterprise-server: '*' --- -### Informationen zu {% data variables.product.prodname_desktop %} +### Informationen zum {% data variables.product.prodname_desktop %} {% data reusables.desktop.about-github-desktop %} diff --git a/translations/de-DE/content/github/getting-started-with-github/github-for-mobile.md b/translations/de-DE/content/github/getting-started-with-github/github-for-mobile.md index 898576f030fb..d2eae51d165d 100644 --- a/translations/de-DE/content/github/getting-started-with-github/github-for-mobile.md +++ b/translations/de-DE/content/github/getting-started-with-github/github-for-mobile.md @@ -23,6 +23,16 @@ Weitere Informationen über Benachrichtigungen für {% data variables.product.pr Für die Installation von {% data variables.product.prodname_mobile %} für Android oder iOS findest Du weitere Informationen auf [{% data variables.product.prodname_mobile %}](https://github.com/mobile). +### Supported languages for {% data variables.product.prodname_mobile %} + +{% data variables.product.prodname_mobile %} is available in the following languages. + +- Japanisch +- Brazilian Portuguese +- Spanisch + +If you configure the language on your device to a supported language, {% data variables.product.prodname_mobile %} will default to the language. You can change the language for {% data variables.product.prodname_mobile %} in {% data variables.product.prodname_mobile %}'s **Settings** menu. + ### Universal Links für {% data variables.product.prodname_mobile %} auf iOS verwalten {% data variables.product.prodname_mobile %} aktiviert automatisch Universal Links für iOS. Wenn Du auf einen {% data variables.product.product_name %}-Link tippst, wird die Ziel-URL in {% data variables.product.prodname_mobile %} anstatt in Safari geöffnet. Weitere Informationen findest Du unter [Universal Links](https://developer.apple.com/ios/universal-links/) auf der Apple Entwickler Website. diff --git a/translations/de-DE/content/github/getting-started-with-github/githubs-products.md b/translations/de-DE/content/github/getting-started-with-github/githubs-products.md index e4b3a04d7068..7a3eda9b05f2 100644 --- a/translations/de-DE/content/github/getting-started-with-github/githubs-products.md +++ b/translations/de-DE/content/github/getting-started-with-github/githubs-products.md @@ -86,7 +86,7 @@ Zusätzlich zu den mit {% data variables.product.prodname_team %} verfügbaren F - Ein Service Level Agreement über eine monatliche Verfügbarkeit von 99,95 %, - Die Option, die Richtlinien und Abrechnungen für mehrere {% data variables.product.prodname_dotcom_the_website %}-Organisationen mit Enterprise-Konto zentral zu verwalten. Weitere Informationen findest Du unter "About enterprise accounts" (Über Enterprise-Konten). -Du kannst eine Testversion einrichten, um {% data variables.product.prodname_ghe_cloud %} zu testen. Weitere Informationen finden Sie unter „[Eine Testversion von {% data variables.product.prodname_ghe_cloud %} einrichten](/articles/setting-up-a-trial-of-github-enterprise-cloud)“. +Du kannst eine Testversion einrichten, um {% data variables.product.prodname_ghe_cloud %} zu testen. Weitere Informationen findest Du unter „[Eine Testversion von {% data variables.product.prodname_ghe_cloud %} einrichten](/articles/setting-up-a-trial-of-github-enterprise-cloud).“ Um weitere Informationen über das Hosten Deiner eigenen [{% data variables.product.prodname_ghe_server %}](https://enterprise.github.com)-Instanz zu erhalten, kontaktiere bitte {% data variables.contact.contact_enterprise_sales %}. {% data reusables.enterprise_installation.request-a-trial %} @@ -96,7 +96,7 @@ Um weitere Informationen über das Hosten Deiner eigenen [{% data variables.prod - {% data variables.contact.github_support %} {% data variables.product.premium_plus_support_plan %} - {% data variables.product.prodname_insights %} -- {% data variables.product.prodname_advanced_security %} +- {% data variables.product.prodname_advanced_security %}{% if currentVersion == "free-pro-team@latest" %}. For more information, see "[About {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)" and "[About {% data variables.product.prodname_secret_scanning %}](/github/administering-a-repository/about-secret-scanning) (beta)."{% endif %}{% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %}. For more information, see "[About {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning) (beta)."{% endif %} - [{% data variables.product.prodname_learning %} für Organisationen](https://lab.github.com/organizations) Weitere Informationen zur Anmeldung für {% data variables.product.prodname_ghe_one %} erhältst Du beim [{% data variables.product.product_name %}-Vertriebsteam](https://enterprise.github.com/contact). diff --git a/translations/de-DE/content/github/getting-started-with-github/keyboard-shortcuts.md b/translations/de-DE/content/github/getting-started-with-github/keyboard-shortcuts.md index 2995e028c647..52a8e7414892 100644 --- a/translations/de-DE/content/github/getting-started-with-github/keyboard-shortcuts.md +++ b/translations/de-DE/content/github/getting-started-with-github/keyboard-shortcuts.md @@ -20,11 +20,11 @@ Im Folgenden findest Du eine Liste mit einigen der verfügbaren Tastenkürzel. ### Seitenweite Tastenkürzel -| Tastenkürzel | Beschreibung | -| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| s oder / | Hiermit fokussierst Du die Suchleiste. Weitere Informationen findest Du unter „[Informationen zur Suche auf {% data variables.product.company_short %}](/articles/about-searching-on-github).“ | -| g n | Gehe zu Deinen Benachrichtigungen. Weitere Informationen findest Du unter {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}„[Über Benachrichtigungen](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}„[Über Benachrichtigungen](/github/receiving-notifications-about-activity-on-github/about-notifications){% endif %}." | -| esc | Wenn auf eine Benutzer-, Issue- oder Pull-Request-Hovercard (Informationskarte) konzentriert, schließt das Kürzel die Hovercard und konzentriert sich erneut auf das Element, in dem sich die Hovercard befindet | +| Tastenkürzel | Beschreibung | +| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| s oder / | Hiermit fokussierst Du die Suchleiste. Weitere Informationen findest Du unter „[Informationen zur Suche auf {% data variables.product.company_short %}](/articles/about-searching-on-github).“ | +| g n | Gehe zu Deinen Benachrichtigungen. 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 %}." | +| esc | Wenn auf eine Benutzer-, Issue- oder Pull-Request-Hovercard (Informationskarte) konzentriert, schließt das Kürzel die Hovercard und konzentriert sich erneut auf das Element, in dem sich die Hovercard befindet | ### Repositorys @@ -67,16 +67,16 @@ Weitere Tastenkürzel findest Du in der [CodeMirror-Dokumentation](https://codem ### Kommentare -| Tastenkürzel | Beschreibung | -| ----------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Steuertaste + b oder Befehlstaste + b | Hiermit wird die Markdown-Formatierung für den Fettdruck von Text eingefügt. | -| Steuertaste + i oder Befehlstaste + i | Hiermit wird die Markdown-Formatierung für die Kursivsetzung von Text eingefügt. | -| Steuertaste + k oder Befehlstaste + k | Hiermit wird die Markdown-Formatierung zum Erstellen eines Links eingefügt. | -| Steuertaste + Umschalttaste + p oder Befehlstaste + Umschalttaste + p | Hiermit wird zwischen den Kommentar-Registerkarten **Write** (Schreiben) und **Preview** (Vorschau) umgeschaltet | -| Steuertaste + Eingabetaste | Hiermit wird ein Kommentar abgesendet. | -| Steuertaste + . und dann Steuertaste + [Nummer der gespeicherten Antwort] | Hiermit wird das Menü für gespeicherte Antworten geöffnet und im Kommentarfeld automatisch eine gespeicherte Antwort eingetragen. Weitere Informationen finden Sie unter „[Informationen zu gespeicherten Antworten](/articles/about-saved-replies)“.{% if currentVersion == "free-pro-team@latest" %} +| Tastenkürzel | Beschreibung | +| ----------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Steuertaste + b oder Befehlstaste + b | Hiermit wird die Markdown-Formatierung für den Fettdruck von Text eingefügt. | +| Steuertaste + i oder Befehlstaste + i | Hiermit wird die Markdown-Formatierung für die Kursivsetzung von Text eingefügt. | +| Steuertaste + k oder Befehlstaste + k | Hiermit wird die Markdown-Formatierung zum Erstellen eines Links eingefügt. | +| Steuertaste + Umschalttaste + p oder Befehlstaste + Umschalttaste + p | Hiermit wird zwischen den Kommentar-Registerkarten **Write** (Schreiben) und **Preview** (Vorschau) umgeschaltet | +| Steuertaste + Eingabetaste | Hiermit wird ein Kommentar abgesendet. | +| Steuertaste + . und dann Steuertaste + [Nummer der gespeicherten Antwort] | Hiermit wird das Menü für gespeicherte Antworten geöffnet und im Kommentarfeld automatisch eine gespeicherte Antwort eingetragen. For more information, see "[About saved replies](/articles/about-saved-replies)."{% if currentVersion == "free-pro-team@latest" %} | Steuertaste + g oder Befehlstaste + g | Hiermit wird ein Vorschlag eingefügt. Weitere Informationen findest Du unter „[Vorgeschlagene Änderungen in einem Pull Request überprüfen](/articles/reviewing-proposed-changes-in-a-pull-request).“ |{% endif %} -| r | Hiermit wird der ausgewählte Text in Deiner Antwort zitiert. Weitere Informationen findest Du unter „[Grundlegende Schreib- und Formatierungssyntax](/articles/basic-writing-and-formatting-syntax#quoting-text).“ | +| r | Hiermit wird der ausgewählte Text in Deiner Antwort zitiert. Weitere Informationen findest Du unter „[Grundlegende Schreib- und Formatierungssyntax](/articles/basic-writing-and-formatting-syntax#quoting-text).“ | ### Issue- und Pull-Request-Listen @@ -92,13 +92,13 @@ Weitere Tastenkürzel findest Du in der [CodeMirror-Dokumentation](https://codem | o oder Eingabetaste | Hiermit wird ein Issue geöffnet. | ### Issues und Pull Requests -| Tastenkürzel | Beschreibung | -| ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| q | Hiermit wird ein Reviewer angefordert. Weitere Informationen findest Du unter „[Pull-Request-Review anfordern](/articles/requesting-a-pull-request-review/).“ | -| m | Hiermit wird ein Meilenstein festgelegt. Weitere Informationen findest Du unter „[Meilensteine mit Issues und Pull Requests verknüpfen](/articles/associating-milestones-with-issues-and-pull-requests/).“ | -| l | Hiermit wird eine Kennzeichnung angewendet. Weitere Informationen findest Du unter „[Kennzeichnungen auf Issues und Pull Requests anwenden](/articles/applying-labels-to-issues-and-pull-requests/).“ | +| Tastenkürzel | Beschreibung | +| ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| q | Hiermit wird ein Reviewer angefordert. Weitere Informationen findest Du unter „[Pull-Request-Review anfordern](/articles/requesting-a-pull-request-review/).“ | +| m | Hiermit wird ein Meilenstein festgelegt. Weitere Informationen findest Du unter „[Meilensteine mit Issues und Pull Requests verknüpfen](/articles/associating-milestones-with-issues-and-pull-requests/).“ | +| l | Hiermit wird eine Kennzeichnung angewendet. Weitere Informationen findest Du unter „[Kennzeichnungen auf Issues und Pull Requests anwenden](/articles/applying-labels-to-issues-and-pull-requests/).“ | | a | Hiermit wird ein Bearbeiter festgelegt. Weitere Informationen findest Du unter „[Issues und Pull Requests anderen {% data variables.product.company_short %}-Benutzern zuweisen](/articles/assigning-issues-and-pull-requests-to-other-github-users/).“ | -| Befehlstaste + Umschalttaste+p oder Steuertaste + Umschalttaste + p | Hiermit wird zwischen den Registerkarten **Write** (Schreiben) und **Preview** (Vorschau) umgeschaltet. | +| Befehlstaste + Umschalttaste+p oder Steuertaste + Umschalttaste + p | Hiermit wird zwischen den Registerkarten **Write** (Schreiben) und **Preview** (Vorschau) umgeschaltet. | ### Änderungen in Pull Requests @@ -109,7 +109,7 @@ Weitere Tastenkürzel findest Du in der [CodeMirror-Dokumentation](https://codem | j | Hiermit verschiebt sich die Auswahl in der Liste nach unten | | k | Hiermit verschiebt sich die Auswahl in der Liste nach oben | | Befehlstaste + Umschalttaste + Eingabetaste | Hiermit fügst Du einen einzelnen Kommentar zu einer Pull-Request-Diff hinzu | -| Alt und klicken | Umschalten zwischen Reduzieren und Erweitern aller veralteten Review-Kommentare in einem Pull Request durch das Drücken von `alt` und klicken auf **Show outdated** (zeige veraltete) oder **Hide outdated** (blende veraltete aus).|{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +| Alt und klicken | 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" %} | Klicke, dann Shift und klicke | Kommentiere mehrere Zeilen eines Pull-Requests, indem Du auf eine Zeilennummer klickst, shift gedrückt hältst und dann auf eine andere Zeilennummer klickst. Weitere Informationen findest Du unter „[Einen Pull Request kommentieren](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request#adding-line-comments-to-a-pull-request)."|{% endif %} ### Projektboards diff --git a/translations/de-DE/content/github/getting-started-with-github/saving-repositories-with-stars.md b/translations/de-DE/content/github/getting-started-with-github/saving-repositories-with-stars.md index e04e34298094..2892d2111e61 100644 --- a/translations/de-DE/content/github/getting-started-with-github/saving-repositories-with-stars.md +++ b/translations/de-DE/content/github/getting-started-with-github/saving-repositories-with-stars.md @@ -1,6 +1,6 @@ --- title: Repositorys mit Sternen speichern -intro: 'Repositorys{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.16" %} und Themen{% endif %} kannst Du durch Sterne kennzeichnen, um für Dich interessante Projekte zu verfolgen{% if currentVersion == "free-pro-team@latest" %} und in Deinem News-Feed für Dich relevante Inhalte präsentiert zu bekommen{% endif %}.' +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/ @@ -19,10 +19,11 @@ Du kannst Deine mit Stern versehene Repositorys und Themen auf Deiner {% data va Mit Stern zu versehen macht es einfacher, Repositorys oder Themen später wieder zu finden. Du kannst alle Repositorys und Themen, die Du mit Stern versehen hast, auf Deiner {% data variables.explore.your_stars_page %} sehen. {% if currentVersion == "free-pro-team@latest" %} -Du kannst Repositorys und Themen mit Sternen versehen, um auf {% data variables.product.product_name %} auf für Dich relevante Projekte hingewiesen zu werden. Sofern verfügbar, schlägt Dir {% data variables.product.product_name %} in diesem Fall in der Entdecken-Ansicht Deines News-Feeds ähnliche Inhalte vor. Weitere Informationen findest Du unter „[Möglichkeiten finden, um Beiträge zu Open-Source auf {% data variables.product.prodname_dotcom %} zu leisten](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github) ." +You can star repositories and topics to discover similar projects on +{% data variables.product.product_name %}. Sofern verfügbar, schlägt Ihnen {% data variables.product.product_name %} in diesem Fall in der Erkennungsansicht Ihres News-Feeds ähnliche Inhalte vor. Weitere Informationen findest du unter „[Möglichkeiten finden, Beiträge an Open-Source auf {% data variables.product.prodname_dotcom %} zu leisten](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)." {% endif %} -Mit der Auszeichnung durch einen Stern zeigst Du dem Repository-Betreuer auch Deine Wertschätzung für seine Arbeit. Verschiedene Repository-Rankings von {% data variables.product.prodname_dotcom %} basieren auf der Anzahl der Sterne, die für ein Repository vergeben wurden. Auch [Explore](https://github.com/explore) (Erkunden) stuft die Beliebtheit von Repositorys nach der Anzahl der erhaltenen Sterne ein. +Mit der Auszeichnung durch einen Stern zeigen Sie dem Repository-Maintainer auch Ihre Wertschätzung für seine Arbeit. Verschiedene Repository-Rankings von {% data variables.product.prodname_dotcom %} basieren auf der Anzahl der Sterne, die für ein Repository vergeben wurden. Auch [Explore](https://github.com/explore) (Erkunden) stuft die Beliebtheit von Repositorys nach der Anzahl der erhaltenen Sterne ein. ### Sterne durchsuchen @@ -36,15 +37,15 @@ Du kannst die Suchleiste benutzen, um schnell Repositorys und Themen zu finden, In der oberen rechten Ecke Deiner Sterne-Seite kannst Du Deine markierten Repositories und Themen nach kürzlich markiert, kürzlich aktiv oder die meisten Sternen sortieren. -Auf der rechten Seite kannst Du Deine Liste der mit Sternen versehenen Repositorys nach ihrer Sprache filtern. +Auf der rechten Seite können Sie Ihre Liste der mit Sternen versehenen Repositorys nach ihrer Sprache filtern. ![Sterne nach Sprache filtern](/assets/images/help/stars/stars_filter_language.png) ### Sterne Deiner Freunde durchsuchen - Rechts unten auf der Seite kannst Du auch die Sterne Deiner Freunde durchsuchen. Diese bieten Dir eventuell Anregungen für neue Repositorys und Themen, für die Du Sterne vergeben möchtest. + Rechts unten auf der Seite können Sie auch die Sterne Ihrer Freunde durchsuchen. Diese bieten Dir eventuell Anregungen für neue Repositorys und Themen, für die Du Sterne vergeben möchtest. -![Sterne Deiner Freunde anzeigen](/assets/images/help/stars/stars_jump_to_a_friend.png) +![Sterne Ihrer Freunde anzeigen](/assets/images/help/stars/stars_jump_to_a_friend.png) ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/getting-started-with-github/set-up-git.md b/translations/de-DE/content/github/getting-started-with-github/set-up-git.md index 5f5b85b41c52..a4cf8c3ee164 100644 --- a/translations/de-DE/content/github/getting-started-with-github/set-up-git.md +++ b/translations/de-DE/content/github/getting-started-with-github/set-up-git.md @@ -10,7 +10,7 @@ redirect_from: - /win-git-installation/ - /win-set-up-git/ - /articles/set-up-git -intro: 'Im Zentrum von {% data variables.product.product_name %} ist das Open-Source-Versionskontrollsystem (VCS) namens Git. Git ist für alle {% data variables.product.product_name %}-Ereignisse zuständig, die lokal auf Deinem Computer stattfinden.' +intro: 'Im Zentrum von {% data variables.product.product_name %} ist das Open-Source-Versionskontrollsystem (VCS) namens Git. Git ist für alle {% data variables.product.product_name %}-Ereignisse zuständig, die lokal auf Ihrem Computer stattfinden.' versions: free-pro-team: '*' enterprise-server: '*' @@ -20,7 +20,7 @@ Um Git in der Befehlszeile verwenden zu können, musst Du es auf Deinem Computer Möchtest Du Git lokal, aber ohne Befehlszeile verwenden, kannst Du stattdessen den [{% data variables.product.prodname_desktop %}-Client]({% data variables.product.desktop_link %}) herunterladen und installieren. For more information, see "[Installing and configuring {% data variables.product.prodname_desktop %}](/desktop/installing-and-configuring-github-desktop/)." -Wenn Du keine Dateien lokal bearbeiten musst, kannst Du mit {% data variables.product.product_name %} auch viele Git-Aktionen direkt im Browser ausführen, so auch: +Wenn Sie keine Dateien lokal bearbeiten müssen, können Sie mit {% data variables.product.product_name %} auch viele Git-Aktionen direkt im Browser ausführen. Zum Beispiel: - [Repository erstellen](/articles/create-a-repo) - [Repository forken](/articles/fork-a-repo) @@ -35,7 +35,7 @@ Wenn Du keine Dateien lokal bearbeiten musst, kannst Du mit {% data variables.pr ### Nächste Schritte: Authentifizierung bei {% data variables.product.prodname_dotcom %} aus Git -Wenn Du aus Git eine Verbindung mit einem {% data variables.product.product_name %}-Repository herstellen willst, musst Du Dich über HTTPS oder SSH bei {% data variables.product.product_name %} authentifizieren. +Wenn Sie aus Git eine Verbindung mit einem {% data variables.product.product_name %}-Repository herstellen wollen, müssen Sie sich über HTTPS oder SSH bei {% data variables.product.product_name %} authentifizieren. #### Verbindung über HTTPS (empfohlen) @@ -43,11 +43,11 @@ If you [clone with HTTPS](/articles/which-remote-url-should-i-use/#cloning-with- #### Verbindung über SSH -Wenn Du [mit SSH klonst](/articles/which-remote-url-should-i-use#cloning-with-ssh-urls), musst Du auf allen Computern, die Du für Push- oder Pull-Aktionen mit {% data variables.product.product_name %} verwendest, [SSH-Schlüssel generieren](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent). +Wenn Sie [mit SSH klonen](/articles/which-remote-url-should-i-use#cloning-with-ssh-urls), müssen Sie auf allen Computern, die Sie für Push- oder Pull-Aktionen mit {% data variables.product.product_name %} verwenden, [SSH-Schlüssel generieren](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent). ### Geschafft! -Glückwunsch! Du hast Git und {% data variables.product.product_name %} vollständig eingerichtet! Was möchtest Du als Nächstes tun? +Glückwunsch! Sie haben Git und {% data variables.product.product_name %} vollständig eingerichtet. Was möchtest Du als Nächstes tun? - **Git einrichten** - „[Repository erstellen](/articles/create-a-repo)“ diff --git a/translations/de-DE/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-cloud.md b/translations/de-DE/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-cloud.md index be18612c1ff2..2f480ef33143 100644 --- a/translations/de-DE/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-cloud.md +++ b/translations/de-DE/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-cloud.md @@ -1,6 +1,6 @@ --- title: Eine Testversion von GitHub Enterprise einrichten -intro: 'Du kannst {% data variables.product.prodname_ghe_cloud %} kostenlos testen.' +intro: 'Sie können {% data variables.product.prodname_ghe_cloud %} kostenlos testen.' redirect_from: - /articles/setting-up-a-trial-of-github-enterprise-cloud versions: @@ -10,7 +10,7 @@ versions: ### Informationen zu {% data variables.product.prodname_ghe_cloud %}-Testversionen -Du kannst eine 14-tägige Testversion einrichten, um {% data variables.product.prodname_ghe_cloud %} in einem neuen Organisationskonto zu testen. Während des Testzeitraums muss Du keine Zahlungsmethode angeben, sofern Du Deiner Organisation keine {% data variables.product.prodname_marketplace %}-Apps hinzufügst, welche eine Zahlungsmethode verlangen. Weitere Informationen findest Du unter „Informationen zur Abrechnung für {% data variables.product.prodname_marketplace %}.“ +Sie können eine 14-tägige Testversion einrichten, um {% data variables.product.prodname_ghe_cloud %} in einem neuen Organisationskonto zu testen. Während des Testzeitraums müssen Sie keine Zahlungsmethode angeben, sofern Sie Ihrer Organisation keine {% data variables.product.prodname_marketplace %}-Apps hinzufügen, die eine Zahlungsmethode vorschreiben. Weitere Informationen findest Du unter „Informationen zur Abrechnung für {% data variables.product.prodname_marketplace %}.“ Deine Testversion umfasst 50 Benutzer. Wenn Du mehr Sitze (Benutzer) benötigst, um {% data variables.product.prodname_ghe_cloud %} zu evaluieren, kontaktiere bitte {% data variables.contact.contact_enterprise_sales %}. Am Ende des Testzeitraums kannst Du eine andere Anzahl an Benutzern auswählen. @@ -20,7 +20,7 @@ Testversionen sind auch für {% data variables.product.prodname_ghe_server %} ve ### Deine {% data variables.product.prodname_ghe_cloud %}-Testversion einrichten -Du musst über ein Benutzerkonto verfügen oder ein neues Benutzerkonto erstellen, bevor Du mit Deiner {% data variables.product.prodname_ghe_cloud %}-Testversion loslegen kannst. Weitere Informationen findest Du unter „Neues {% data variables.product.prodname_dotcom %}-Konto registrieren.“ +Sie müssen über ein Benutzerkonto verfügen oder ein neues Benutzerkonto erstellen, bevor Sie mit Ihrer {% data variables.product.prodname_ghe_cloud %}-Testversion loslegen können. Weitere Informationen findest Du unter „Neues {% data variables.product.prodname_dotcom %}-Konto registrieren.“ {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.organizations %} diff --git a/translations/de-DE/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-server.md b/translations/de-DE/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-server.md index 4eff2d854754..431491751971 100644 --- a/translations/de-DE/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-server.md +++ b/translations/de-DE/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-server.md @@ -1,6 +1,6 @@ --- title: Eine Testversion von GitHub Enterprise Server einrichten -intro: 'Du kannst {% data variables.product.prodname_ghe_server %} kostenlos testen.' +intro: 'Sie können {% data variables.product.prodname_ghe_server %} kostenlos testen.' redirect_from: - /articles/requesting-a-trial-of-github-enterprise/ - /articles/setting-up-a-trial-of-github-enterprise-server @@ -11,11 +11,11 @@ versions: ### Informationen zu {% data variables.product.prodname_ghe_server %}-Testversionen -Du kannst eine Testversion anfordern und {% data variables.product.prodname_ghe_server %} 45 Tage lang kostenlos testen. Deine Testversion wird als virtuelle Appliance installiert, wobei Du wählen kannst, ob sie lokal oder in der Cloud bereitgestellt wird. Eine Liste der unterstützten Visualisierungsplattformen findest Du unter „[GitHub Enterprise Server-Instanz einrichten](/enterprise/admin/installation/setting-up-a-github-enterprise-server-instance).“ +Sie können eine Testversion anfordern und {% data variables.product.prodname_ghe_server %} 45 Tage lang kostenlos testen. Deine Testversion wird als virtuelle Appliance installiert, wobei Du wählen kannst, ob sie lokal oder in der Cloud bereitgestellt wird. Eine Liste der unterstützten Visualisierungsplattformen findest Du unter „[GitHub Enterprise Server-Instanz einrichten](/enterprise/admin/installation/setting-up-a-github-enterprise-server-instance).“ -Sicherheitsmeldungen und {% data variables.product.prodname_github_connect %} stehen in Testversionen von {% data variables.product.prodname_ghe_server %} derzeit nicht zur Verfügung. Kontaktiere {% data variables.contact.contact_enterprise_sales %} für eine Vorstellung dieser Funktionen. For more information about these features, see "About alerts for vulnerable dependencies" and "[Connecting {% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_dotcom_the_website %}](/enterprise/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)." +{% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}Security{% endif %} alerts and {% data variables.product.prodname_github_connect %} are not currently available in trials of {% data variables.product.prodname_ghe_server %}. Kontaktiere {% data variables.contact.contact_enterprise_sales %} für eine Vorstellung dieser Funktionen. For more information about these features, see "About alerts for vulnerable dependencies" and "[Connecting {% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_dotcom_the_website %}](/enterprise/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)." -Testversionen sind auch für {% data variables.product.prodname_ghe_cloud %} verfügbar. Weitere Informationen finden Sie unter „[Eine Testversion von {% data variables.product.prodname_ghe_cloud %} einrichten](/articles/setting-up-a-trial-of-github-enterprise-cloud)“. +Testversionen sind auch für {% data variables.product.prodname_ghe_cloud %} verfügbar. Weitere Informationen findest Du unter „[Eine Testversion von {% data variables.product.prodname_ghe_cloud %} einrichten](/articles/setting-up-a-trial-of-github-enterprise-cloud).“ {% data reusables.products.which-product-to-use %} diff --git a/translations/de-DE/content/github/getting-started-with-github/signing-up-for-a-new-github-account.md b/translations/de-DE/content/github/getting-started-with-github/signing-up-for-a-new-github-account.md index 26e649e8a644..0e34a4eec2b0 100644 --- a/translations/de-DE/content/github/getting-started-with-github/signing-up-for-a-new-github-account.md +++ b/translations/de-DE/content/github/getting-started-with-github/signing-up-for-a-new-github-account.md @@ -9,7 +9,7 @@ versions: Weitere Informationen zu den verschiedenen Konto- und Produkttypen findest Du unter „[Arten von {% data variables.product.prodname_dotcom %}-Konten](/articles/types-of-github-accounts)“ und „[Produkte von {% data variables.product.product_name %}](/articles/github-s-products).“ -1. Rufe die [Preisübersicht]({% data variables.product.pricing_url %}) von {% data variables.product.product_name %} auf. +1. Rufen Sie die [Preisübersicht]({% data variables.product.pricing_url %}) von {% data variables.product.product_name %} auf. 2. Lies die Informationen zu den von {% data variables.product.product_name %} angebotenen Produkten und Abonnements, und klicke dann unter dem Abonnement, das Dich interessiert, auf die Schaltfläche „Upgrade“. 3. Folge den Eingabeaufforderungen, um Dein persönliches Konto oder Deine Organisation zu erstellen. diff --git a/translations/de-DE/content/github/getting-started-with-github/supported-browsers.md b/translations/de-DE/content/github/getting-started-with-github/supported-browsers.md index 6602115df5f1..f83a69407790 100644 --- a/translations/de-DE/content/github/getting-started-with-github/supported-browsers.md +++ b/translations/de-DE/content/github/getting-started-with-github/supported-browsers.md @@ -4,7 +4,7 @@ redirect_from: - /articles/why-doesn-t-graphs-work-with-ie-8/ - /articles/why-don-t-graphs-work-with-ie8/ - /articles/supported-browsers -intro: '{% data variables.product.product_name %} wird ständig weiterentwickelt, um auch die neuesten Webbrowser zu unterstützen. Wir unterstützen die aktuellen Versionen von [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 %} und [Microsoft Edge](https://www.microsoft.com/en-us/windows/microsoft-edge).' +intro: '{% data variables.product.product_name %} wird ständig weiterentwickelt, um auch die neuesten Webbrowser zu unterstützen. 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: '*' diff --git a/translations/de-DE/content/github/getting-started-with-github/troubleshooting-connectivity-problems.md b/translations/de-DE/content/github/getting-started-with-github/troubleshooting-connectivity-problems.md index 649b63d06d89..7c9ebed8c949 100644 --- a/translations/de-DE/content/github/getting-started-with-github/troubleshooting-connectivity-problems.md +++ b/translations/de-DE/content/github/getting-started-with-github/troubleshooting-connectivity-problems.md @@ -1,6 +1,6 @@ --- title: Fehlerbehebung bei Verbindungsproblemen -intro: 'Wenn Du mit {% data variables.product.prodname_dotcom %} Verbindungsprobleme hast, solltest Du zunächst versuchen, das Problem zu beheben, indem Du den typischen Fehlerursachen auf den Grund gehst. Danach kannst Du das Problem mit dem {% data variables.product.prodname_debug %}-Tool diagnostizieren und dem Support einen Bericht senden.' +intro: 'Wenn Sie mit {% data variables.product.prodname_dotcom %} Verbindungsprobleme haben, sollten Sie zunächst versuchen, das Problem zu beheben, indem Sie den typischen Fehlerursachen auf den Grund gehen. Danach können Sie das Problem mit dem {% data variables.product.prodname_debug %}-Tool diagnostizieren und dem Support einen Bericht senden.' redirect_from: - /articles/troubleshooting-connectivity-problems versions: @@ -36,8 +36,8 @@ Bei Zeitüberschreitungen bei der Verwendung von SSH findest Du Details unter {% data variables.product.prodname_dotcom %} drosselt die Bandbreite nicht für einzelne Benutzer. -Wenn sich die Verbindung nur zu gewissen Tageszeiten verlangsamt, wird dies ziemlich sicher durch Netzwerk-Überlastung verursacht. Da {% data variables.product.prodname_dotcom %} Netzwerk-Überlastung nicht beheben kann, solltest Du dieses Problem bei Deinem Internet-Serviceprovider eskalieren. +Wenn sich die Verbindung nur zu gewissen Tageszeiten verlangsamt, wird dies ziemlich sicher durch Netzwerk-Überlastung verursacht. Leider kann {% data variables.product.prodname_dotcom %} Netzwerkstaus jedoch nicht beheben. Sie sollten sich daher mit diesem Problem an Ihren Internet Service Provider (ISP) wenden. ### Fehlerbehebung mit {% data variables.product.prodname_debug %} -Wenn Du alle oben genannten Empfehlungen zur Fehlerbehebung befolgt hast, Dein Verbindungsproblem aber weiterhin besteht, folge den Anweisungen auf der {% data variables.product.prodname_debug %}-Website, um Tests durchzuführen und dem {% data variables.product.prodname_dotcom %}-Support einen Problembericht zu senden. Weitere Informationen findest Du unter „[{% data variables.product.prodname_debug %}](https://github-debug.com/)“. +Wenn Sie alle oben genannten Empfehlungen zur Fehlerbehebung befolgt haben, Ihr Verbindungsproblem aber weiterhin besteht, folgen Sie den Anweisungen auf der {% data variables.product.prodname_debug %}-Website, um Tests auszuführen und dem {% data variables.product.prodname_dotcom %} Support einen Problembericht zu senden. Weitere Informationen findest Du unter „[{% data variables.product.prodname_debug %}](https://github-debug.com/)“. diff --git a/translations/de-DE/content/github/getting-started-with-github/types-of-github-accounts.md b/translations/de-DE/content/github/getting-started-with-github/types-of-github-accounts.md index 88361a048278..1ee8870cd5e1 100644 --- a/translations/de-DE/content/github/getting-started-with-github/types-of-github-accounts.md +++ b/translations/de-DE/content/github/getting-started-with-github/types-of-github-accounts.md @@ -1,6 +1,6 @@ --- title: Arten von GitHub-Konten -intro: 'Dein Benutzerkonto ist Deine Identität auf {% data variables.product.product_location %}. Dein Benutzerkonto kann Mitglied einer beliebigen Anzahl von Organisationen sein.{% if currentVersion == "free-pro-team@latest" %} Organisationen können zu Enterprise-Konten gehören.{% endif %}' +intro: 'Ihr Benutzerkonto ist Ihre Identität auf {% 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/ @@ -13,7 +13,8 @@ versions: --- {% if currentVersion == "free-pro-team@latest" %} -Eine vollständige Liste der Funktionen für jedes {% data variables.product.product_name %}-Produkt findest Du auf „[{% data variables.product.prodname_dotcom %}-Produkte](/github/getting-started-with-github/githubs-products)." +For a full list of features for each +{% data variables.product.product_name %} product, see "[{% data variables.product.prodname_dotcom %}'s products](/github/getting-started-with-github/githubs-products)." {% endif %} ### Persönliche Benutzerkonten @@ -65,12 +66,12 @@ Organisationen sind gemeinsame Konten, in denen Personengruppen projektübergrei ### Enterprise-Konten -Mit Enterprise-Konten kannst Du die Richtlinien und Abrechnungen mehrerer {% data variables.product.prodname_dotcom_the_website %}-Organisationen zentral verwalten. {% data reusables.gated-features.enterprise-accounts %} +Mit Enterprise-Konten können Sie die Richtlinien und Abrechnungen mehrerer {% data variables.product.prodname_dotcom_the_website %}-Organisationen zentral verwalten. {% data reusables.gated-features.enterprise-accounts %} {% endif %} ### Weiterführende Informationen -{% if currentVersion == "free-pro-team@latest" %}- „[Für ein neues {% data variables.product.prodname_dotcom %}-Konto anmelden](/articles/signing-up-for-a-new-github-account)“ +{% if currentVersion == "free-pro-team@latest" %}- "[Signing up for a new {% data variables.product.prodname_dotcom %} account](/articles/signing-up-for-a-new-github-account)" - „[Produkte von {% data variables.product.prodname_dotcom %}](/articles/githubs-products)"{% endif %} - „[Neues Organisationskonto erstellen](/articles/creating-a-new-organization-account)“ diff --git a/translations/de-DE/content/github/getting-started-with-github/verifying-your-email-address.md b/translations/de-DE/content/github/getting-started-with-github/verifying-your-email-address.md index 72a76d7b7f26..644c331b16dc 100644 --- a/translations/de-DE/content/github/getting-started-with-github/verifying-your-email-address.md +++ b/translations/de-DE/content/github/getting-started-with-github/verifying-your-email-address.md @@ -1,6 +1,6 @@ --- title: Deine E-Mail-Adresse verifizieren -intro: 'Das Verifizieren Deiner primären E-Mail-Adresse gewährleistet eine bessere Sicherheit, ermöglicht dem {% data variables.product.prodname_dotcom %}-Personal, Dich besser zu unterstützen, falls Du Dein Passwort vergessen hast, und ermöglicht Dir den Zugriff auf weitere Funktionen auf {% data variables.product.prodname_dotcom %}.' +intro: 'Das Verifizieren Ihrer primären E-Mail-Adresse gewährleistet eine bessere Sicherheit, ermöglicht dem {% data variables.product.prodname_dotcom %}-Personal, Sie besser zu unterstützen, falls Sie Ihr Passwort vergessen haben, und ermöglicht Ihnen den Zugriff auf weitere Features auf {% data variables.product.prodname_dotcom %}.' redirect_from: - /articles/troubleshooting-email-verification/ - /articles/setting-up-email-verification/ @@ -54,9 +54,9 @@ Der Verifizierungslink läuft nach 24 Stunden ab. Wenn Du Deine E-Mail-Adresse n Wenn Du innerhalb von 24 Stunden auf den Link in der Bestätigungs-E-Mail klickst und Du auf eine Fehlerseite umgeleitet wirst, solltest Du sicherstellen, dass Du Dich beim richtigen {% data variables.product.prodname_dotcom %}-Konto angemeldet hast. -1. {% data variables.product.signout_link %} aus Deinem persönlichen {% data variables.product.prodname_dotcom %}-Konto. +1. {% data variables.product.signout_link %} von Ihrem persönliche {% data variables.product.prodname_dotcom %}-Konto. 2. Beende Deinen Browser, und starte ihn neu. -3. {% data variables.product.signin_link %} bei Deinem persönlichen {% data variables.product.prodname_dotcom %}-Konto. +3. {% data variables.product.signin_link %} bei Ihrem persönlichen {% data variables.product.prodname_dotcom %}-Konto. 4. Klicke auf den Verifizierungslink in der E-Mail, die wir Dir gesendet haben. ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line.md b/translations/de-DE/content/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line.md index 308d64f5653c..ecf02f620b78 100644 --- a/translations/de-DE/content/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line.md +++ b/translations/de-DE/content/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line.md @@ -1,6 +1,6 @@ --- title: Ein vorhandenes Projekt über die Befehlszeile zu GitHub hinzufügen -intro: 'Wenn Du Dein vorhandenes Projekt zu {% data variables.product.product_name %} hinzufügst, stehen Dir großartige Möglichkeiten zum Teilen und zur Zusammenarbeit zur Verfügung.' +intro: 'Wenn Sie Ihr vorhandenes Projekt zu {% data variables.product.product_name %} hinzufügen, stehen Ihnen großartige Möglichkeiten zur Freigabe und Zusammenarbeit zur Verfügung.' redirect_from: - /articles/add-an-existing-project-to-github/ - /articles/adding-an-existing-project-to-github-using-the-command-line @@ -21,7 +21,10 @@ versions: {% mac %} -1. [Erstellen Sie ein neues Repository](/articles/creating-a-new-repository) auf {% data variables.product.product_location %}. Um Fehler zu vermeiden, initialisiere das neue Repository nicht mit *README*-, Lizenz- oder `gitignore`-Dateien. Sie können diese Dateien hinzufügen, nachdem Ihr Projekt per Push an {% data variables.product.product_name %} übergeben wurde. ![Dropdownmenü „Create New Repository" (Erstelle neues Repository)](/assets/images/help/repository/repo-create.png) +1. [Erstellen Sie ein neues Repository](/articles/creating-a-new-repository) auf + +{% data variables.product.product_location %}. Um Fehler zu vermeiden, initialisiere das neue Repository nicht mit *README*-, Lizenz- oder `gitignore`-Dateien. Du kannst diese Dateien hinzufügen, nachdem Dein Projekt per Push an {% data variables.product.product_name %} übergeben wurde. + ![Dropdownmenü „Create New Repository" (Erstelle neues Repository)](/assets/images/help/repository/repo-create.png) {% data reusables.command_line.open_the_multi_os_terminal %} 3. Wechsle Dein aktuelles Arbeitsverzeichnis in das lokale Projekt. 4. Initialisiere das lokale Verzeichnis als Git-Repository. @@ -38,7 +41,7 @@ versions: $ git commit -m "First commit" # Gibt die verfolgten Aenderungen frei und bereitet sie fuer den Push in ein Remote-Repository vor. {% data reusables.git.reset-head-to-previous-commit-codeblock %} ``` -7. Klicke oben auf der Seite zur Schnelleinrichtung Deines {% data variables.product.product_name %}-Repositorys auf {% octicon "clippy" aria-label="The copy to clipboard icon" %}, um die URL des Remote-Repositorys zu kopieren. ![Feld zum Kopieren der Remote-Repository-URL](/assets/images/help/repository/copy-remote-repository-url-quick-setup.png) +7. Klicken Sie oben auf der Seite zur Schnelleinrichtung Ihres {% data variables.product.product_name %}-Repositorys auf {% octicon "clippy" aria-label="The copy to clipboard icon" %}, um die URL des Remote-Repositorys zu kopieren. ![Feld zum Kopieren der Remote-Repository-URL](/assets/images/help/repository/copy-remote-repository-url-quick-setup.png) 8. [Füge in Terminal die URL für das Remote-Repository hinzu](/articles/adding-a-remote), an das Dein lokales Repository per Push übergeben werden soll. ```shell $ git remote add origin remote repository URL @@ -46,7 +49,7 @@ versions: $ git remote -v # Verifiziert die neue Remote-Repository URL ``` -9. [Übergeben Sie die Änderungen](/articles/pushing-commits-to-a-remote-repository/) in Ihrem lokalen Repository per Push an {% data variables.product.product_location %}. +9. [Übergib die Änderungen](/articles/pushing-commits-to-a-remote-repository/) in Deinem lokalen Repository per Push an {% data variables.product.product_location %}. ```shell $ git push -u origin master # Pusht die Aenderungen Deines lokalen Repositorys hinauf zum Remote-Repository, das Du als Ursprung festgelegt hast @@ -56,7 +59,10 @@ versions: {% windows %} -1. [Erstellen Sie ein neues Repository](/articles/creating-a-new-repository) auf {% data variables.product.product_location %}. Um Fehler zu vermeiden, initialisiere das neue Repository nicht mit *README*-, Lizenz- oder `gitignore`-Dateien. Sie können diese Dateien hinzufügen, nachdem Ihr Projekt per Push an {% data variables.product.product_name %} übergeben wurde. ![Dropdownmenü „Create New Repository" (Erstelle neues Repository)](/assets/images/help/repository/repo-create.png) +1. [Erstellen Sie ein neues Repository](/articles/creating-a-new-repository) auf + +{% data variables.product.product_location %}. Um Fehler zu vermeiden, initialisiere das neue Repository nicht mit *README*-, Lizenz- oder `gitignore`-Dateien. Du kannst diese Dateien hinzufügen, nachdem Dein Projekt per Push an {% data variables.product.product_name %} übergeben wurde. + ![Dropdownmenü „Create New Repository" (Erstelle neues Repository)](/assets/images/help/repository/repo-create.png) {% data reusables.command_line.open_the_multi_os_terminal %} 3. Wechsle Dein aktuelles Arbeitsverzeichnis in das lokale Projekt. 4. Initialisiere das lokale Verzeichnis als Git-Repository. @@ -73,7 +79,7 @@ versions: $ git commit -m "First commit" # Gibt die verfolgten Aenderungen frei und bereitet sie fuer den Push in ein Remote-Repository vor. {% data reusables.git.reset-head-to-previous-commit-codeblock %} ``` -7. Klicke oben auf der Seite zur Schnelleinrichtung Deines {% data variables.product.product_name %}-Repositorys auf {% octicon "clippy" aria-label="The copy to clipboard icon" %}, um die URL des Remote-Repositorys zu kopieren. ![Feld zum Kopieren der Remote-Repository-URL](/assets/images/help/repository/copy-remote-repository-url-quick-setup.png) +7. Klicken Sie oben auf der Seite zur Schnelleinrichtung Ihres {% data variables.product.product_name %}-Repositorys auf {% octicon "clippy" aria-label="The copy to clipboard icon" %}, um die URL des Remote-Repositorys zu kopieren. ![Feld zum Kopieren der Remote-Repository-URL](/assets/images/help/repository/copy-remote-repository-url-quick-setup.png) 8. Gib in der Eingabeaufforderung [die URL für das Remote-Repository](/articles/adding-a-remote) ein, an das Dein lokales Repository per Push übergeben werden soll. ```shell $ git remote add origin remote repository URL @@ -81,7 +87,7 @@ versions: $ git remote -v # Verifiziert die neue Remote-Repository URL ``` -9. [Übergeben Sie die Änderungen](/articles/pushing-commits-to-a-remote-repository/) in Ihrem lokalen Repository per Push an {% data variables.product.product_location %}. +9. [Übergib die Änderungen](/articles/pushing-commits-to-a-remote-repository/) in Deinem lokalen Repository per Push an {% data variables.product.product_location %}. ```shell $ git push origin master # Pusht die Aenderungen Deines lokalen Repositorys hinauf zum Remote-Repository, das Du als Ursprung festgelegt hast @@ -91,7 +97,10 @@ versions: {% linux %} -1. [Erstellen Sie ein neues Repository](/articles/creating-a-new-repository) auf {% data variables.product.product_location %}. Um Fehler zu vermeiden, initialisiere das neue Repository nicht mit *README*-, Lizenz- oder `gitignore`-Dateien. Sie können diese Dateien hinzufügen, nachdem Ihr Projekt per Push an {% data variables.product.product_name %} übergeben wurde. ![Dropdownmenü „Create New Repository" (Erstelle neues Repository)](/assets/images/help/repository/repo-create.png) +1. [Erstellen Sie ein neues Repository](/articles/creating-a-new-repository) auf + +{% data variables.product.product_location %}. Um Fehler zu vermeiden, initialisiere das neue Repository nicht mit *README*-, Lizenz- oder `gitignore`-Dateien. Du kannst diese Dateien hinzufügen, nachdem Dein Projekt per Push an {% data variables.product.product_name %} übergeben wurde. + ![Dropdownmenü „Create New Repository" (Erstelle neues Repository)](/assets/images/help/repository/repo-create.png) {% data reusables.command_line.open_the_multi_os_terminal %} 3. Wechsle Dein aktuelles Arbeitsverzeichnis in das lokale Projekt. 4. Initialisiere das lokale Verzeichnis als Git-Repository. @@ -108,7 +117,7 @@ versions: $ git commit -m "First commit" # Gibt die verfolgten Aenderungen frei und bereitet sie fuer den Push in ein Remote-Repository vor. {% data reusables.git.reset-head-to-previous-commit-codeblock %} ``` -7. Klicke oben auf der Seite zur Schnelleinrichtung Deines {% data variables.product.product_name %}-Repositorys auf {% octicon "clippy" aria-label="The copy to clipboard icon" %}, um die URL des Remote-Repositorys zu kopieren. ![Feld zum Kopieren der Remote-Repository-URL](/assets/images/help/repository/copy-remote-repository-url-quick-setup.png) +7. Klicken Sie oben auf der Seite zur Schnelleinrichtung Ihres {% data variables.product.product_name %}-Repositorys auf {% octicon "clippy" aria-label="The copy to clipboard icon" %}, um die URL des Remote-Repositorys zu kopieren. ![Feld zum Kopieren der Remote-Repository-URL](/assets/images/help/repository/copy-remote-repository-url-quick-setup.png) 8. [Füge in Terminal die URL für das Remote-Repository hinzu](/articles/adding-a-remote), an das Dein lokales Repository per Push übergeben werden soll. ```shell $ git remote add origin remote repository URL @@ -116,7 +125,7 @@ versions: $ git remote -v # Verifiziert die neue Remote-Repository URL ``` -9. [Übergeben Sie die Änderungen](/articles/pushing-commits-to-a-remote-repository/) in Ihrem lokalen Repository per Push an {% data variables.product.product_location %}. +9. [Übergib die Änderungen](/articles/pushing-commits-to-a-remote-repository/) in Deinem lokalen Repository per Push an {% data variables.product.product_location %}. ```shell $ git push origin master # Pusht die Aenderungen Deines lokalen Repositorys hinauf zum Remote-Repository, das Du als Ursprung festgelegt hast diff --git a/translations/de-DE/content/github/importing-your-projects-to-github/importing-a-git-repository-using-the-command-line.md b/translations/de-DE/content/github/importing-your-projects-to-github/importing-a-git-repository-using-the-command-line.md index de0305707cf8..ddc8ba1e9a7e 100644 --- a/translations/de-DE/content/github/importing-your-projects-to-github/importing-a-git-repository-using-the-command-line.md +++ b/translations/de-DE/content/github/importing-your-projects-to-github/importing-a-git-repository-using-the-command-line.md @@ -1,6 +1,6 @@ --- title: Ein Git-Repository über die Befehlszeile importieren -intro: '{% if currentVersion == "free-pro-team@latest" %}Wenn [GitHub Importer](/articles/importing-a-repository-with-github-importer) nicht für Deine Zwecke geeignet ist, z. B. wenn Dein vorhandener Code in einem privaten Netzwerk verwaltet wird, dann empfehlen wir, den Import über die Befehlszeile vorzunehmen.{% else %}Das Importieren von Git-Projekten über die Befehlszeile ist eine geeignete Methode, wenn Dein vorhandener Code in einem privaten Netzwerk verwaltet wird.{% endif %}' +intro: '{% if currentVersion == "free-pro-team@latest" %}If [GitHub Importer](/articles/importing-a-repository-with-github-importer) is not suitable for your purposes, such as if your existing code is hosted on a private network, then we recommend importing using the command line.{% else %}Importing Git projects using the command line is suitable when your existing code is hosted on a private network.{% endif %}' redirect_from: - /articles/importing-a-git-repository-using-the-command-line versions: @@ -10,7 +10,7 @@ versions: Bevor Du startest, stelle sicher, dass Dir Folgendes vorliegt: -- Deinen {% data variables.product.product_name %}-Benutzername +- Ihr {% data variables.product.product_name %}-Benutzername - Die Klon-URL des externen Repositorys, z. B. `https://external-host.com/user/repo.git` oder `git://external-host.com/user/repo.git` (vielleicht mit einem `user@` vor dem Domänen-Namen `external-host.com`) {% tip %} @@ -24,7 +24,7 @@ Um die Methode vorzuführen und zu erläutern, verwenden wir {% endtip %} -1. [Erstelle ein neues Repository auf {% data variables.product.product_name %}](/articles/creating-a-new-repository). Du wirst Dein externes Git-Repository in dieses neue Repository importieren. +1. [Erstellen Sie ein neues Repository auf {% data variables.product.product_name %}](/articles/creating-a-new-repository). Du wirst Dein externes Git-Repository in dieses neue Repository importieren. 2. Erstelle in der Befehlszeile einen „leeren“ Klon des Repositorys mit der externen Klon-URL. Dadurch wird eine vollständige Kopie der Daten angelegt, aber ohne Arbeitsverzeichnis für die Bearbeitung von Dateien. Außerdem wird der saubere Export aller alten Daten gewährleistet. ```shell $ git clone --bare https://external-host.com/extuser/repo.git diff --git a/translations/de-DE/content/github/importing-your-projects-to-github/importing-source-code-to-github.md b/translations/de-DE/content/github/importing-your-projects-to-github/importing-source-code-to-github.md index f9ae7c37060e..8ccc24a00784 100644 --- a/translations/de-DE/content/github/importing-your-projects-to-github/importing-source-code-to-github.md +++ b/translations/de-DE/content/github/importing-your-projects-to-github/importing-source-code-to-github.md @@ -1,6 +1,6 @@ --- title: Quellcode in GitHub importieren -intro: 'Du kannst Repositorys über {% if currentVersion == "free-pro-team@latest" %}GitHub Importer, die Befehlszeile{% else %}die Befehlszeile{% endif %} oder mit externen Migrationstools nach GitHub importieren.' +intro: 'You can import repositories to GitHub using {% if currentVersion == "free-pro-team@latest" %}GitHub Importer, the command line,{% else %}the command line{% endif %} or external migration tools.' redirect_from: - /articles/importing-an-external-git-repository/ - /articles/importing-from-bitbucket/ diff --git a/translations/de-DE/content/github/importing-your-projects-to-github/subversion-properties-supported-by-github.md b/translations/de-DE/content/github/importing-your-projects-to-github/subversion-properties-supported-by-github.md index 01b60d524233..23a218ae9074 100644 --- a/translations/de-DE/content/github/importing-your-projects-to-github/subversion-properties-supported-by-github.md +++ b/translations/de-DE/content/github/importing-your-projects-to-github/subversion-properties-supported-by-github.md @@ -18,7 +18,7 @@ versions: ### Ignorieren nicht versionierter Elemente (svn:ignore) -Dateien und Verzeichnisse, die Du in Subversion auf „Ignorieren“ gesetzt hast, verfolgt {% data variables.product.product_name %} intern. Von Subversion-Clients ignorierte Dateien sind völlig unterschiedlich zu den Einträgen in einer *.gitignore*-Datei. +Dateien und Verzeichnisse, die Sie in Subversion auf „Ignorieren“ gesetzt haben, zeichnet {% data variables.product.product_name %} intern auf. Von Subversion-Clients ignorierte Dateien sind völlig unterschiedlich zu den Einträgen in einer *.gitignore*-Datei. ### Derzeit nicht unterstützte Eigenschaften diff --git a/translations/de-DE/content/github/importing-your-projects-to-github/support-for-subversion-clients.md b/translations/de-DE/content/github/importing-your-projects-to-github/support-for-subversion-clients.md index 8f4e7daa22cb..1de53c25a567 100644 --- a/translations/de-DE/content/github/importing-your-projects-to-github/support-for-subversion-clients.md +++ b/translations/de-DE/content/github/importing-your-projects-to-github/support-for-subversion-clients.md @@ -1,6 +1,6 @@ --- title: Unterstützung für Subversion-Clients -intro: 'Der Zugriff auf GitHub-Repositorys kann von Git- und Subversion (SVN)-Clients erfolgen. In diesem Artikel erhältst Du Informationen zur Ausführung eines Subversion-Clients auf GitHub sowie zu einigen häufigen Problemen, die in Verbindung mit Subversion auftreten können.' +intro: Der Zugriff auf GitHub-Repositorys kann von Git- und Subversion (SVN)-Clients erfolgen. In diesem Artikel erhältst Du Informationen zur Ausführung eines Subversion-Clients auf GitHub sowie zu einigen häufigen Problemen, die in Verbindung mit Subversion auftreten können. redirect_from: - /articles/support-for-subversion-clients versions: @@ -47,7 +47,7 @@ Subversion-Checkouts unterscheiden sich hier: In Subversion sind die Repository- Zur Erstellung der Branches kannst Du auch die Subversion-Bridge für GitHub verwenden. -Stelle auf Deinem SVN-Client sicher, dass „master“ der aktuelle Branch ist. Aktualisiere hierzu `trunk`: +From your svn client, make sure the default branch is current by updating `trunk`: ```shell $ svn up trunk > At revision 1. diff --git a/translations/de-DE/content/github/importing-your-projects-to-github/updating-commit-author-attribution-with-github-importer.md b/translations/de-DE/content/github/importing-your-projects-to-github/updating-commit-author-attribution-with-github-importer.md index 882bcbcaddcc..d82a5672a68e 100644 --- a/translations/de-DE/content/github/importing-your-projects-to-github/updating-commit-author-attribution-with-github-importer.md +++ b/translations/de-DE/content/github/importing-your-projects-to-github/updating-commit-author-attribution-with-github-importer.md @@ -1,6 +1,6 @@ --- title: Zuordnung von Commit-Autoren mit GitHub Importer aktualisieren -intro: Während eines Imports kannst Du die Commits in Deinem Repository mit den GitHub-Konten der Commit-Autoren abgleichen. +intro: 'Während eines Imports kannst Du die Commits in Deinem Repository mit den GitHub-Konten der Commit-Autoren abgleichen.' redirect_from: - /articles/updating-commit-author-attribution-with-github-importer versions: diff --git a/translations/de-DE/content/github/importing-your-projects-to-github/what-are-the-differences-between-subversion-and-git.md b/translations/de-DE/content/github/importing-your-projects-to-github/what-are-the-differences-between-subversion-and-git.md index 22cf3f7e4575..429bd86662e6 100644 --- a/translations/de-DE/content/github/importing-your-projects-to-github/what-are-the-differences-between-subversion-and-git.md +++ b/translations/de-DE/content/github/importing-your-projects-to-github/what-are-the-differences-between-subversion-and-git.md @@ -1,6 +1,6 @@ --- title: Unterschiede zwischen Subversion und Git -intro: SVN-Repositorys (Subversion) ähneln Git-Repositorys. In Bezug auf die Architektur Deiner Projekte bestehen jedoch mehrere Unterschiede. +intro: 'SVN-Repositorys (Subversion) ähneln Git-Repositorys. In Bezug auf die Architektur Deiner Projekte bestehen jedoch mehrere Unterschiede.' redirect_from: - /articles/what-are-the-differences-between-svn-and-git/ - /articles/what-are-the-differences-between-subversion-and-git @@ -35,9 +35,9 @@ Git-Projekte werden zudem in einem einzelnen Verzeichnis gespeichert. Git verbir Ein Git-Workflow sieht wie folgt aus: * Ein Git-Repository speichert den vollständigen Verlauf all seiner Branches und Tags im *.git*-Verzeichnis. -* Der `master`-Branch enthält die neueste stabile Veröffentlichung. +* The latest stable release is contained within the default branch. * Aktive Funktionsarbeiten werden auf separaten Branches entwickelt. -* Nach Abschluss einer Funktion wird der Feature-Branch in `master` überführt und gelöscht. +* When a feature is finished, the feature branch is merged into the default branch and deleted. Im Gegensatz zu SVN bleibt die Verzeichnisstruktur mit Git identisch. Basierend auf Deinem Branch ändern sich jedoch die Dateiinhalte. diff --git a/translations/de-DE/content/github/index.md b/translations/de-DE/content/github/index.md index e0aa066e8935..9da5ca146af1 100644 --- a/translations/de-DE/content/github/index.md +++ b/translations/de-DE/content/github/index.md @@ -4,7 +4,7 @@ redirect_from: - /articles/ - /common-issues-and-questions/ - /troubleshooting-common-issues/ -intro: 'Dokumentationen, Leitfäden und Hilfethemen für Softwareentwickler, Designer und Projektleiter. Beschreibt die Verwendung von Git, Pull Requests, Issues, Wikis, Gists und alles weitere, das Du benötigst, um GitHub für die Entwicklung bestmöglich zu nutzen.' +intro: 'Dokumentationen, Leitfäden und Hilfethemen für Softwareentwickler, Designer und Projektleiter. Darin wird die Verwendung von Git, Pull Requests, Issues, Wikis und Gists beschrieben und enthält zudem alles, was Sie benötigen, um von GitHub für die Entwicklung bestmöglich zu profitieren.' versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/de-DE/content/github/managing-files-in-a-repository/3d-file-viewer.md b/translations/de-DE/content/github/managing-files-in-a-repository/3d-file-viewer.md index e91aaa18cbb5..c7f6dc3d228e 100644 --- a/translations/de-DE/content/github/managing-files-in-a-repository/3d-file-viewer.md +++ b/translations/de-DE/content/github/managing-files-in-a-repository/3d-file-viewer.md @@ -10,7 +10,7 @@ versions: {% data variables.product.product_name %} kann 3D-Dateien mit der Erweiterung *.stl* hosten und rendern. -Wenn Du eine STL-Datei direkt auf {% data variables.product.product_name %} betrachtest, kannst Du Folgendes tun: +Wenn Sie eine STL-Datei direkt auf {% data variables.product.product_name %} betrachten, können Sie Folgendes tun: * Modell durch Anklicken und Ziehen drehen * Ansicht durch Rechtsklick und Ziehen verschieben diff --git a/translations/de-DE/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md b/translations/de-DE/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md index 3f7a97be30f0..5b9b25328662 100644 --- a/translations/de-DE/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md +++ b/translations/de-DE/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md @@ -1,6 +1,6 @@ --- title: Eine Datei über die Befehlszeile zu einem Repository hinzufügen -intro: 'Du kannst eine vorhandene Datei über die Befehlszeile in ein {% data variables.product.product_name %}-Repository hochladen.' +intro: 'Sie können eine vorhandene Datei über die Befehlszeile in ein {% data variables.product.product_name %}-Repository hochladen.' redirect_from: - /articles/adding-a-file-to-a-repository-from-the-command-line/ - /articles/adding-a-file-to-a-repository-using-the-command-line @@ -19,7 +19,9 @@ versions: {% data reusables.repositories.sensitive-info-warning %} -1. Verschiebe auf Deinem Computer die Datei, die Du zu {% data variables.product.product_name %} hochladen möchtest, in das lokale Verzeichnis, das beim Klonen des Repositorys erstellt wurde. +1. On your computer, move the file you'd like to upload to + +{% data variables.product.product_name %} into the local directory that was created when you cloned the repository. {% data reusables.command_line.open_the_multi_os_terminal %} {% data reusables.command_line.switching_directories_procedural %} {% data reusables.git.stage_for_commit %} diff --git a/translations/de-DE/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository.md b/translations/de-DE/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository.md index 56ea77960432..9cbc184bef28 100644 --- a/translations/de-DE/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository.md +++ b/translations/de-DE/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository.md @@ -1,6 +1,6 @@ --- title: Eine Datei zu einem Repository hinzufügen -intro: 'Du kannst eine vorhandene Datei in ein {% data variables.product.product_name %}-Repository hochladen und committen. Ziehe eine Datei per Drag-and-Drop in ein beliebiges Verzeichnis in der Dateistruktur, oder lade Dateien von der Hauptseite des Repositorys hoch.' +intro: 'Sie können eine vorhandene Datei in ein {% data variables.product.product_name %}-Repository hochladen und committen. Ziehe eine Datei per Drag-and-Drop in ein beliebiges Verzeichnis in der Dateistruktur, oder lade Dateien von der Hauptseite des Repositorys hoch.' redirect_from: - /articles/adding-a-file-to-a-repository versions: @@ -8,12 +8,12 @@ versions: enterprise-server: '*' --- -Für Dateien, die Du über einen Browser zu einem Repository hinzufügst, gilt eine Beschränkung von {% data variables.large_files.max_github_browser_size %} pro Datei. Größere Dateien mit bis zu jeweils {% data variables.large_files.max_github_size %} kannst Du über die Befehlszeile hinzufügen. Weitere Informationen findest Du unter „[Eine Datei über die Befehlszeile zu einem Repository hinzufügen](/articles/adding-a-file-to-a-repository-using-the-command-line).“ +Für Dateien, die Sie über einen Browser zu einem Repository hinzufügen, gilt eine Beschränkung von {% data variables.large_files.max_github_browser_size %} pro Datei. Größere Dateien mit bis zu jeweils {% data variables.large_files.max_github_size %} können Sie über die Befehlszeile hinzufügen. Weitere Informationen findest Du unter „[Eine Datei über die Befehlszeile zu einem Repository hinzufügen](/articles/adding-a-file-to-a-repository-using-the-command-line).“ {% tip %} **Tipps:** -- Du kannst mehrere Dateien gleichzeitig zu {% data variables.product.product_name %} hochladen. +- Sie können mehrere Dateien gleichzeitig zu {% data variables.product.product_name %} hochladen. - {% data reusables.repositories.protected-branches-block-web-edits-uploads %} {% endtip %} diff --git a/translations/de-DE/content/github/managing-files-in-a-repository/creating-new-files.md b/translations/de-DE/content/github/managing-files-in-a-repository/creating-new-files.md index 5d17d74d9bf7..c5ea9853dbaa 100644 --- a/translations/de-DE/content/github/managing-files-in-a-repository/creating-new-files.md +++ b/translations/de-DE/content/github/managing-files-in-a-repository/creating-new-files.md @@ -1,6 +1,6 @@ --- title: Neue Dateien erstellen -intro: 'Du kannst neue Dateien direkt auf {% data variables.product.product_name %} in jedem Repository erstellen, auf das Du Schreibzugriff hast.' +intro: 'Sie können neue Dateien direkt auf {% data variables.product.product_name %} in jedem Repository erstellen, auf das Sie Schreibzugriff haben.' redirect_from: - /articles/creating-new-files versions: @@ -8,10 +8,10 @@ versions: enterprise-server: '*' --- -Wenn Du eine Datei auf {% data variables.product.product_name %} erstellst, beachte Folgendes: +Wenn Sie eine Datei auf {% data variables.product.product_name %} erstellen, beachten Sie Folgendes: - Wenn Du versuchst, eine neue Datei in einem Repository zu erstellen, auf das Du keinen Zugriff hast, erstellen wir einen Fork des Projekts unter Deinem Benutzerkonto und helfen Dir nach dem Commit Deiner Änderung, einen [Pull Request](/articles/about-pull-requests) an das ursprüngliche Repository zu senden. -- Dateinamen, die in der Weboberfläche erstellt werden, dürfen nur alphanumerische Zeichen und Bindestriche (`-`) enthalten. Um andere Zeichen zu verwenden, [erstelle die Dateien lokal, gib sie mit Commit frei und übertrage sie mit Push zum Repository auf {% data variables.product.product_name %}](/articles/adding-a-file-to-a-repository-using-the-command-line). +- Dateinamen, die in der Weboberfläche erstellt werden, dürfen nur alphanumerische Zeichen und Bindestriche (`-`) enthalten. Um andere Zeichen zu verwenden, [erstellen und committen Sie die Dateien lokal und pushen Sie sie zum Repository auf {% data variables.product.product_name %}](/articles/adding-a-file-to-a-repository-using-the-command-line). {% data reusables.repositories.sensitive-info-warning %} diff --git a/translations/de-DE/content/github/managing-files-in-a-repository/deleting-files.md b/translations/de-DE/content/github/managing-files-in-a-repository/deleting-files.md index 65e33a0dad30..ab6164388e37 100644 --- a/translations/de-DE/content/github/managing-files-in-a-repository/deleting-files.md +++ b/translations/de-DE/content/github/managing-files-in-a-repository/deleting-files.md @@ -1,6 +1,6 @@ --- title: Dateien löschen -intro: 'Du kannst jede beliebige Datei in Deinen Repositorys auf {% data variables.product.product_name %} löschen.' +intro: 'Sie können jede beliebige Datei in Ihren Repositorys auf {% data variables.product.product_name %} löschen.' redirect_from: - /articles/deleting-files versions: diff --git a/translations/de-DE/content/github/managing-files-in-a-repository/editing-files-in-your-repository.md b/translations/de-DE/content/github/managing-files-in-a-repository/editing-files-in-your-repository.md index 0742b1341f31..c45050d20062 100644 --- a/translations/de-DE/content/github/managing-files-in-a-repository/editing-files-in-your-repository.md +++ b/translations/de-DE/content/github/managing-files-in-a-repository/editing-files-in-your-repository.md @@ -1,6 +1,6 @@ --- title: Dateien in Deinem Repository bearbeiten -intro: 'Du kannst Dateien direkt auf {% data variables.product.product_name %} in jedem Deiner Repositorys mit dem Datei-Editor bearbeiten.' +intro: 'Sie können Dateien direkt auf {% data variables.product.product_name %} in jedem Ihrer Repositorys mit dem Datei-Editor bearbeiten.' redirect_from: - /articles/editing-files/ - /articles/editing-files-in-your-repository diff --git a/translations/de-DE/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md b/translations/de-DE/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md index c00953b5bb7e..81642bc5c65a 100644 --- a/translations/de-DE/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md +++ b/translations/de-DE/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md @@ -1,6 +1,6 @@ --- title: Permalinks zu Dateien abrufen -intro: 'Wenn Du eine Datei auf {% data variables.product.product_location %} anzeigst, kannst Du die Taste „y" drücken, um aus der URL einen Permalink zu genau der angezeigten Version der Datei zu erstellen.' +intro: 'Wenn Sie eine Datei auf {% data variables.product.product_location %} anzeigen, können Sie die Taste Y drücken, um aus der URL einen Permalink zu genau der angezeigten Version der Datei zu erstellen.' redirect_from: - /articles/getting-a-permanent-link-to-a-file/ - /articles/how-do-i-get-a-permanent-link-from-file-view-to-permanent-blob-url/ @@ -18,21 +18,21 @@ versions: ### Dateiansichten zeigen die aktuelle Version auf einem Branch -Wenn Du eine Datei auf {% data variables.product.product_location %} anzeigst, siehst Du in der Regel die Version am aktuellen Head eines Branches. Ein Beispiel: +Wenn Sie eine Datei auf {% data variables.product.product_location %} anzeigen, sehen Sie in der Regel die Version am aktuellen Head eines Branches. Ein Beispiel: -* [https://github.com/github/hubot/blob/**master**/README.md](https://github.com/github/hubot/blob/master/README.md) +* [https://github.com/github/codeql/blob/**main**/README.md](https://github.com/github/codeql/blob/main/README.md) -bezieht sich auf das GitHub-Repository `hubot` und zeigt die aktuelle Version der `README.md`-Datei des `master`-Branches. +refers to GitHub's `codeql` repository, and shows the `main` branch's current version of the `README.md` file. Die Version einer Datei am Head eines Branches kann sich durch neue Commits ändern. Wenn Du also die normale URL kopierst und jemand die Datei später über diese URL aufruft, ist der Inhalt der Datei möglicherweise nicht mehr derselbe. ### Mit der Taste y einen Permalink zu einer Datei in einem spezifischen Commit erstellen -Um einen Permalink zu der angezeigten spezifischen Version einer Datei zu erhalten, verwende in der URL statt des Branch-Namen (z. B. `master` im Beispiel oben) eine Commit-ID. Dadurch entsteht ein Permalink zu der genauen Version der Datei in diesem Commit. Ein Beispiel: +For a permanent link to the specific version of a file that you see, instead of using a branch name in the URL (i.e. the `main` part in the example above), put a commit id. Dadurch entsteht ein Permalink zu der genauen Version der Datei in diesem Commit. Ein Beispiel: -* [https://github.com/github/hubot/blob/**ed25584f5ac2520a6c28547ffd0961c7abd7ea49**/README.md](https://github.com/github/hubot/blob/ed25584f5ac2520a6c28547ffd0961c7abd7ea49/README.md) +* [https://github.com/github/codeql/blob/**b212af08a6cffbb434f3c8a2795a579e092792fd**/README.md](https://github.com/github/codeql/blob/b212af08a6cffbb434f3c8a2795a579e092792fd/README.md) -ersetzt `master` durch eine spezifische Commit-ID, wodurch sich der Inhalt der Datei nicht ändert. +replaces `main` with a specific commit id and the file content will not change. Die manuelle Suche der Commit-SHA ist unpraktisch. Drücke stattdessen einfach auf y, um die URL automatisch in die Permalink-Version zu ändern. Dann kannst Du die URL kopieren und sicher sein, dass jeder, der die Datei über diesen Link aufruft, dieselben Inhalte sieht wie Du. diff --git a/translations/de-DE/content/github/managing-files-in-a-repository/managing-files-on-github.md b/translations/de-DE/content/github/managing-files-in-a-repository/managing-files-on-github.md index dc71746c07a3..999df69b5f6a 100644 --- a/translations/de-DE/content/github/managing-files-in-a-repository/managing-files-on-github.md +++ b/translations/de-DE/content/github/managing-files-in-a-repository/managing-files-on-github.md @@ -1,6 +1,6 @@ --- title: Dateien auf GitHub verwalten -intro: 'Auf {% data variables.product.product_name %} kannst Du Dateien in einem Repository erstellen, bearbeiten, verschieben und löschen.' +intro: 'Auf {% data variables.product.product_name %} können Sie Dateien in einem Repository erstellen, bearbeiten, verschieben und löschen.' mapTopic: true redirect_from: - /articles/managing-files-on-github diff --git a/translations/de-DE/content/github/managing-files-in-a-repository/mapping-geojson-files-on-github.md b/translations/de-DE/content/github/managing-files-in-a-repository/mapping-geojson-files-on-github.md index 8ee9c4a7932c..7a0de42ebbfb 100644 --- a/translations/de-DE/content/github/managing-files-in-a-repository/mapping-geojson-files-on-github.md +++ b/translations/de-DE/content/github/managing-files-in-a-repository/mapping-geojson-files-on-github.md @@ -34,7 +34,7 @@ Weitere Informationen findest Du in [Version 1.1.0 der Open-Simplestyle-Spezifik ### Deine Karte an anderer Stelle einbinden -Möchtest Du Deine geoJSON-Karte an anderer Stelle als {% data variables.product.product_name %} bereitstellen? Passe einfach diese Vorlage an, und integriere sie in eine HTML-Seite, die JavaScript unterstützt (z. B. [{% data variables.product.prodname_pages %}](http://pages.github.com)): +Möchtest Du Deine geoJSON-Karte an anderer Stelle als {% data variables.product.product_name %} bereitstellen? Passen Sie einfach diese Vorlage an, und integrieren Sie sie in eine HTML-Seite, die JavaScript unterstützt (z. B. [{% data variables.product.prodname_pages %}](http://pages.github.com)): ```html diff --git a/translations/de-DE/content/github/managing-files-in-a-repository/moving-a-file-to-a-new-location-using-the-command-line.md b/translations/de-DE/content/github/managing-files-in-a-repository/moving-a-file-to-a-new-location-using-the-command-line.md index bc964182852e..22880fd67180 100644 --- a/translations/de-DE/content/github/managing-files-in-a-repository/moving-a-file-to-a-new-location-using-the-command-line.md +++ b/translations/de-DE/content/github/managing-files-in-a-repository/moving-a-file-to-a-new-location-using-the-command-line.md @@ -1,6 +1,6 @@ --- title: Datei über die Befehlszeile an einen neuen Speicherort verschieben -intro: 'Du kannst über die Befehlszeile Dateien innerhalb eines Repositorys verschieben, indem Du die Datei vom alten Speicherort entfernst und am neuen Speicherort hinzufügst.' +intro: Du kannst über die Befehlszeile Dateien innerhalb eines Repositorys verschieben, indem Du die Datei vom alten Speicherort entfernst und am neuen Speicherort hinzufügst. redirect_from: - /articles/moving-a-file-to-a-new-location-using-the-command-line versions: diff --git a/translations/de-DE/content/github/managing-files-in-a-repository/navigating-code-on-github.md b/translations/de-DE/content/github/managing-files-in-a-repository/navigating-code-on-github.md index af873796ebc7..aa7ff134aae3 100644 --- a/translations/de-DE/content/github/managing-files-in-a-repository/navigating-code-on-github.md +++ b/translations/de-DE/content/github/managing-files-in-a-repository/navigating-code-on-github.md @@ -1,6 +1,6 @@ --- title: Code-Navigation auf GitHub -intro: 'Du kannst die Beziehungen innerhalb von Repositorys wie auch Repository-übergreifend durch die Code-Navigation direkt in {% data variables.product.product_name %} nachvollziehen.' +intro: 'Sie können die Beziehungen in Repositorys und Repository-übergreifend durch die Code-Navigation direkt in {% data variables.product.product_name %} nachvollziehen.' redirect_from: - /articles/navigating-code-on-github versions: diff --git a/translations/de-DE/content/github/managing-files-in-a-repository/renaming-a-file.md b/translations/de-DE/content/github/managing-files-in-a-repository/renaming-a-file.md index 261bab30292c..9b9bd2bf6b8c 100644 --- a/translations/de-DE/content/github/managing-files-in-a-repository/renaming-a-file.md +++ b/translations/de-DE/content/github/managing-files-in-a-repository/renaming-a-file.md @@ -1,6 +1,6 @@ --- title: Datei umbenennen -intro: 'Du kannst jede Datei Deines Repositorys direkt in {% data variables.product.product_name %} umbenennen. Dabei kannst Du die Datei nicht nur umbenennen, sondern auch [an einen anderen Speicherort verschieben](/articles/moving-a-file-to-a-new-location).' +intro: 'Sie können jede Datei Ihrer Repositorys direkt in {% data variables.product.product_name %} umbenennen. Dabei kannst Du die Datei nicht nur umbenennen, sondern auch [an einen anderen Speicherort verschieben](/articles/moving-a-file-to-a-new-location).' redirect_from: - /articles/renaming-a-file versions: diff --git a/translations/de-DE/content/github/managing-files-in-a-repository/rendering-and-diffing-images.md b/translations/de-DE/content/github/managing-files-in-a-repository/rendering-and-diffing-images.md index b76b5b5344a3..c61c4d72b45f 100644 --- a/translations/de-DE/content/github/managing-files-in-a-repository/rendering-and-diffing-images.md +++ b/translations/de-DE/content/github/managing-files-in-a-repository/rendering-and-diffing-images.md @@ -16,7 +16,7 @@ versions: ### Bilder anzeigen -Du kannst Bilder direkt in Deinem {% data variables.product.product_name %}-Repository suchen und aus dem Repository anzeigen: +Sie können Bilder direkt in Ihrem {% data variables.product.product_name %}-Repository suchen und aus dem Repository anzeigen: ![Inline-Bild](/assets/images/help/images/view.png) diff --git a/translations/de-DE/content/github/managing-files-in-a-repository/rendering-csv-and-tsv-data.md b/translations/de-DE/content/github/managing-files-in-a-repository/rendering-csv-and-tsv-data.md index 5d6cfc78adef..941c30e8816f 100644 --- a/translations/de-DE/content/github/managing-files-in-a-repository/rendering-csv-and-tsv-data.md +++ b/translations/de-DE/content/github/managing-files-in-a-repository/rendering-csv-and-tsv-data.md @@ -11,7 +11,7 @@ GitHub unterstützt das Rendering von Tabellendaten in den Formaten *.csv* (komm ![Beispiel für eine gerenderte CSV-Datei](/assets/images/help/repository/rendered_csv.png) -In der Anzeige wird jede _.csv_- oder _.tsv_-Datei, die in einem {% data variables.product.product_name %}-Repository freigegeben ist, automatisch als interaktive Tabelle mit Kopfzeile und Zeilennummerierung wiedergegeben. Standardmäßig wird davon ausgegangen, dass die erste Zeile die Kopfzeile mit den Spaltenüberschriften ist. +In der Anzeige wird jede _CSV_- oder _TSV_-Datei, die in einem {% data variables.product.product_name %}-Repository festgeschrieben ist, automatisch als interaktive Tabelle mit Kopfzeile und Zeilennummerierung wiedergegeben. Standardmäßig wird davon ausgegangen, dass die erste Zeile die Kopfzeile mit den Spaltenüberschriften ist. Durch Klicken auf die Zeilennummer kannst Du eine bestimmte Zeile verknüpfen, oder durch drücken der Umschalttaste mehrere Zeilen auswählen. Kopiere einfach die URL, und sende sie einem anderen Benutzer. diff --git a/translations/de-DE/content/github/managing-files-in-a-repository/tracking-changes-in-a-file.md b/translations/de-DE/content/github/managing-files-in-a-repository/tracking-changes-in-a-file.md index ce08eac84c78..f4f12621b917 100644 --- a/translations/de-DE/content/github/managing-files-in-a-repository/tracking-changes-in-a-file.md +++ b/translations/de-DE/content/github/managing-files-in-a-repository/tracking-changes-in-a-file.md @@ -1,6 +1,6 @@ --- title: Änderungen an einer Datei verfolgen -intro: 'Du kannst die Änderungen an den einzelnen Zeilen einer Datei verfolgen und so feststellen, wie sich die Datei im Lauf der Zeit entwickelt hat.' +intro: Du kannst die Änderungen an den einzelnen Zeilen einer Datei verfolgen und so feststellen, wie sich die Datei im Lauf der Zeit entwickelt hat. redirect_from: - /articles/using-git-blame-to-trace-changes-in-a-file/ - /articles/tracing-changes-in-a-file/ diff --git a/translations/de-DE/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md b/translations/de-DE/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md index 0938e5d8ae71..10e1f375d159 100644 --- a/translations/de-DE/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md +++ b/translations/de-DE/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md @@ -1,6 +1,6 @@ --- title: Mit Jupyter Notebook-Dateien auf GitHub arbeiten -intro: 'Wenn Du Jupyter Notebook- oder iPython Notebook-Dateien mit einer *.ipynb*-Erweiterung auf {% data variables.product.product_location %} hinzufügst, werden sie in Deinem Repository als statische HTML-Dateien gerendert.' +intro: 'Wenn Sie Jupyter Notebook- oder iPython Notebook-Dateien mit einer *.ipynb*-Erweiterung auf {% data variables.product.product_location %} hinzufügen, werden sie in Ihrem Repository als statische HTML-Dateien gerendert.' redirect_from: - /articles/working-with-jupyter-notebook-files-on-github versions: @@ -9,9 +9,9 @@ versions: --- -Die interaktiven Features des Notebooks, beispielsweise benutzerdefinierte JavaScript-Plots, funktionieren in Deinem Repository auf {% data variables.product.product_location %} nicht. Ein Beispiel findest Du unter [*Linking and Interactions.ipynb*](https://github.com/bokeh/bokeh-notebooks/blob/master/tutorial/06%20-%20Linking%20and%20Interactions.ipynb). +Die interaktiven Features des Notebooks, beispielsweise benutzerdefinierte JavaScript-Plots, funktionieren in Ihrem Repository auf {% data variables.product.product_location %} nicht. Ein Beispiel findest Du unter [*Linking and Interactions.ipynb*](https://github.com/bokeh/bokeh-notebooks/blob/main/tutorial/06%20-%20Linking%20and%20Interactions.ipynb). -Du kannst [nbviewer](https://nbviewer.jupyter.org/) verwenden, um Dein Jupyter Notebook mit dargestelltem JavaScript-Inhalt anzuzeigen oder um Deine Notebook-Dateien mit anderen zu teilen. Ein Beispiel zu auf nbviewer gerenderten Elementen findest Du unter [*Linking and Interactions.ipynb*](https://nbviewer.jupyter.org/github/bokeh/bokeh-notebooks/blob/master/tutorial/06%20-%20Linking%20and%20Interactions.ipynb). +Du kannst [nbviewer](https://nbviewer.jupyter.org/) verwenden, um Dein Jupyter Notebook mit dargestelltem JavaScript-Inhalt anzuzeigen oder um Deine Notebook-Dateien mit anderen zu teilen. Ein Beispiel zu auf nbviewer gerenderten Elementen findest Du unter [*Linking and Interactions.ipynb*](https://nbviewer.jupyter.org/github/bokeh/bokeh-notebooks/blob/main/tutorial/06%20-%20Linking%20and%20Interactions.ipynb). Wenn Du eine vollständig interaktive Version Deines Jupyter Notebook anzeigen möchtest, kannst Du einen Notebook-Server lokal einrichten. Weitere Informationen findest Du in der [offiziellen Dokumentation von Jupyter](http://jupyter.readthedocs.io/en/latest/index.html). diff --git a/translations/de-DE/content/github/managing-large-files/about-git-large-file-storage.md b/translations/de-DE/content/github/managing-large-files/about-git-large-file-storage.md index af1bdfb4df9b..df0be247d65b 100644 --- a/translations/de-DE/content/github/managing-large-files/about-git-large-file-storage.md +++ b/translations/de-DE/content/github/managing-large-files/about-git-large-file-storage.md @@ -9,22 +9,23 @@ versions: enterprise-server: '*' --- -{% data variables.large_files.product_name_short %} verarbeitet große Dateien, indem Referenzen auf die Datei im Repository gespeichert werden, nicht aber die Datei an sich. Um die Architektur von Git zu umgehen, erstellt {% data variables.large_files.product_name_short %} eine Pointer-Datei, die als Referenz auf die aktuelle Datei (die an einem anderen Ort gespeichert ist) dient. {% data variables.product.product_name %} verwaltet diese Pointer-Datei in Deinem Repository. Wenn Du das Repository klonst, verwendet {% data variables.product.product_name %} die Pointer-Datei als Karte, um die große Datei für Dich zu finden. +{% data variables.large_files.product_name_short %} verarbeitet große Dateien, indem Referenzen auf die Datei im Repository gespeichert werden, nicht aber die Datei an sich. Um die Architektur von Git zu umgehen, erstellt {% data variables.large_files.product_name_short %} eine Pointer-Datei, die als Referenz auf die aktuelle Datei (die an einem anderen Ort gespeichert ist) dient. {% data variables.product.product_name %} verwaltet diese Pointer-Datei in Ihrem Repository. Wenn Sie das Repository klonen, verwendet {% data variables.product.product_name %} die Pointer-Datei als Karte, um die große Datei für Sie zu finden. {% if currentVersion == "free-pro-team@latest" %} -Mit {% data variables.large_files.product_name_short %} kannst Du Dateien speichern bis zu einer Größe von: +Using +{% data variables.large_files.product_name_short %}, you can store files up to: -| Produkt | Maximale Dateigröße | -| ------------------------------------------------------ | ------------------- | +| Produkt | Maximale Dateigröße | +| ------------------------------------------------- | ------------------- | | {% data variables.product.prodname_free_user %} | 2 GB | | {% data variables.product.prodname_pro %} | 2 GB | | {% data variables.product.prodname_team %} | 4 GB | | {% data variables.product.prodname_ghe_cloud %} | 5 GB |{% else %} - Mit {% data variables.large_files.product_name_short %} kannst Du Dateien speichern bis zu einer Größe von -{% if currentVersion ver_lt "enterprise-server@2.21" %}{% data variables.large_files.max_lfs_size %}{% else %}5GB{% endif %} in Deinem Repository. + Using +{% data variables.large_files.product_name_short %}, you can store files up to {% if currentVersion ver_lt "enterprise-server@2.21" %}{% data variables.large_files.max_lfs_size %}{% else %}5 GB{% endif %} in your repository. {% endif %} -Du kannst {% data variables.large_files.product_name_short %} auch mit {% data variables.product.prodname_desktop %} verwenden. Weitere Informationen zum Klonen von Git-LFS-Repositorys in {% data variables.product.prodname_desktop %} findest Du unter „[Ein Repository von GitHub in GitHub Desktop klonen](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop).“ +Du kannst {% data variables.large_files.product_name_short %} auch mit {% data variables.product.prodname_desktop %} verwenden. Weitere Informationen zum Klonen von Git-LFS-Repositorys in {% data variables.product.prodname_desktop %} finden Sie unter „[Ein Repository von GitHub in GitHub Desktop klonen](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop)“. {% data reusables.large_files.can-include-lfs-objects-archives %} diff --git a/translations/de-DE/content/github/managing-large-files/about-storage-and-bandwidth-usage.md b/translations/de-DE/content/github/managing-large-files/about-storage-and-bandwidth-usage.md index 7bab7c3ea43c..214d52fbe726 100644 --- a/translations/de-DE/content/github/managing-large-files/about-storage-and-bandwidth-usage.md +++ b/translations/de-DE/content/github/managing-large-files/about-storage-and-bandwidth-usage.md @@ -13,14 +13,15 @@ versions: ### Speicher- und Bandbreitennutzung verfolgen -Wenn Du eine Änderung an einer Datei, die mit {% data variables.large_files.product_name_short %} verfolgt wird, freigibst und überträgst, wird eine neue Version der gesamten Datei übertragen und die gesamte Dateigröße wird auf die Speicherbegrenzung des Repository-Inhabers angerechnet. Wenn Du eine Datei herunterlädst, die mit {% data variables.large_files.product_name_short %} verfolgt wird, wird die gesamte Dateigröße auf die Bandbreitenbegrenzung des Repository-Inhabers angerechnet. {% data variables.large_files.product_name_short %}-Uploads werden nicht auf die Bandbreitenbegrenzung angerechnet. +Wenn Sie eine Änderung an einer Datei, die mit {% data variables.large_files.product_name_short %} verfolgt wird, committen und pushen, wird eine neue Version der gesamten Datei gepusht und die gesamte Dateigröße wird auf die Speicherbegrenzung des Repository-Inhabers angerechnet. Wenn Sie eine Datei herunterladen, die mit {% data variables.large_files.product_name_short %} verfolgt wird, wird die gesamte Dateigröße auf die Bandbreitenbegrenzung des Repository-Besitzers angerechnet. {% data variables.large_files.product_name_short %}-Uploads werden nicht auf die Bandbreitenbegrenzung angerechnet. Ein Beispiel: -- Wenn Du eine 500-MB-Datei an {% data variables.large_files.product_name_short %} überträgst, nutzt Du 500 MB Deines verfügbaren Speichers und keine Bandbreite. Wenn Du eine Änderung von 1 Byte vornimmst und die Datei erneut überträgst, nutzt Du weitere 500 MB Speicherplatz und keine Bandbreite, wodurch Deine Gesamtnutzung für diese beiden Pushes bei 1 GB Speicherplatz und Null Bandbreite liegt. +- Wenn Sie eine 500-MB-Datei an {% data variables.large_files.product_name_short %} pushen, nutzen Sie 500 MB Ihres verfügbaren Speichers und keine Bandbreite. Wenn Du eine Änderung von 1 Byte vornimmst und die Datei erneut überträgst, nutzt Du weitere 500 MB Speicherplatz und keine Bandbreite, wodurch Deine Gesamtnutzung für diese beiden Pushes bei 1 GB Speicherplatz und Null Bandbreite liegt. - Wenn Du eine 500-MB-Datei herunterlädst, die mit LFS verfolgt wird, verwendest Du 500 MB der vom Repository-Inhaber zur Verfügung gestellten Bandbreite. Wenn ein Mitarbeiter eine Änderung an eine Datei überträgt und Du die neue Version in Dein lokales Repository lädst, verwendest Du weitere 500 MB Bandbreite, wodurch die Gesamtnutzung für diese beiden Downloads bei 1 GB Bandbreite liegt. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -If {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in source code archives for your repository, downloads of those archives will count towards bandwidth usage for the repository. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)." +If +{% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in source code archives for your repository, downloads of those archives will count towards bandwidth usage for the repository. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)." {% endif %} {% tip %} @@ -37,7 +38,7 @@ Wenn Du mehr als {% data variables.large_files.initial_storage_quota %} des Spei ### Bandbreiten-Kontingent -Wenn Du mehr als {% data variables.large_files.initial_bandwidth_quota %} der monatlichen Bandbreite nutzt, ohne ein Datenpaket zu kaufen, wird der {% data variables.large_files.product_name_short %}-Support für Dein Konto bis zum nächsten Monat deaktiviert. +Wenn Sie mehr als {% data variables.large_files.initial_bandwidth_quota %} der monatlichen Bandbreite nutzen, ohne ein Datenpaket zu kaufen, wird die {% data variables.large_files.product_name_short %}-Unterstützung für Ihr Konto bis zum nächsten Monat deaktiviert. ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/managing-large-files/collaboration-with-git-large-file-storage.md b/translations/de-DE/content/github/managing-large-files/collaboration-with-git-large-file-storage.md index ab4e4db4a4d5..0b3087b2e230 100644 --- a/translations/de-DE/content/github/managing-large-files/collaboration-with-git-large-file-storage.md +++ b/translations/de-DE/content/github/managing-large-files/collaboration-with-git-large-file-storage.md @@ -1,6 +1,6 @@ --- title: Mit Git Large File Storage (Git Große Dateien Speicher) zusammenarbeiten -intro: 'Wenn {% data variables.large_files.product_name_short %} aktiviert ist, kannst Du große Dateien abrufen, ändern und übertragen, wie Du es von jeder von Git verwalteten Datei erwartest. Benutzer, die nicht über {% data variables.large_files.product_name_short %} verfügen, erfahren dagegen einen anderen Workflow.' +intro: 'Wenn {% data variables.large_files.product_name_short %} aktiviert ist, können Sie große Dateien abrufen, ändern und pushen wie jede große, von Git verwaltete Datei. Benutzer, die nicht über {% data variables.large_files.product_name_short %} verfügen, erleben dagegen einen anderen Workflow.' redirect_from: - /articles/collaboration-with-large-file-storage/ - /articles/collaboration-with-git-large-file-storage @@ -9,7 +9,7 @@ versions: enterprise-server: '*' --- -Wenn Mitarbeiter an Deinem Repository {% data variables.large_files.product_name_short %} nicht installiert haben, haben sie keinen Zugriff auf die große Originaldatei. Wenn sie versuchen, Dein Repository zu klonen, rufen sie nur die Pointer-Dateien ab und haben keinen Zugriff auf die tatsächlichen Daten. +Wenn Mitarbeiter an Ihrem Repository {% data variables.large_files.product_name_short %} nicht installiert haben, haben sie keinen Zugriff auf die große Originaldatei. Wenn sie versuchen, Dein Repository zu klonen, rufen sie nur die Pointer-Dateien ab und haben keinen Zugriff auf die tatsächlichen Daten. {% tip %} diff --git a/translations/de-DE/content/github/managing-large-files/conditions-for-large-files.md b/translations/de-DE/content/github/managing-large-files/conditions-for-large-files.md index 074aa7ff2dc8..1ec6ea4a96d6 100644 --- a/translations/de-DE/content/github/managing-large-files/conditions-for-large-files.md +++ b/translations/de-DE/content/github/managing-large-files/conditions-for-large-files.md @@ -16,4 +16,4 @@ Wenn Du versuchst, eine Datei größer als {% data variables.large_files.warning ### Blockierte Pushs für große Dateien -{% data variables.product.product_name %} blockiert {% if currentVersion != "free-pro-team@latest" %}standardmäßig {% endif %}Übertragungen, welche {% data variables.large_files.max_github_size %} übersteigen. {% if currentVersion != "free-pro-team@latest" %}Ein Website-Administrator kann jedoch für Deine {% data variables.product.prodname_ghe_server %}-Instanz eine andere Limite konfigurieren. Weitere Informationen findest Du unter „[Push-Begrenzungen für Git festlegen](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-git-push-limits).“{% endif %} +{% if currentVersion != "free-pro-team@latest" %}By default, {% endif %}{% data variables.product.product_name %} blocks pushes that exceed {% data variables.large_files.max_github_size %}. {% if currentVersion != "free-pro-team@latest" %}However, a site administrator can configure a different limit for your {% data variables.product.prodname_ghe_server %} instance. Weitere Informationen findest Du unter „[Push-Begrenzungen für Git festlegen](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-git-push-limits).“{% endif %} diff --git a/translations/de-DE/content/github/managing-large-files/configuring-git-large-file-storage.md b/translations/de-DE/content/github/managing-large-files/configuring-git-large-file-storage.md index 1bf4779e2478..282c1bd09be4 100644 --- a/translations/de-DE/content/github/managing-large-files/configuring-git-large-file-storage.md +++ b/translations/de-DE/content/github/managing-large-files/configuring-git-large-file-storage.md @@ -9,7 +9,7 @@ versions: enterprise-server: '*' --- -Wenn in Deinem Repository bereits Dateien vorhanden sind, für die Du {% data variables.product.product_name %} verwenden möchtest, musst Du sie zuerst aus dem Repository entfernen und sie dann lokal zu {% data variables.large_files.product_name_short %} hinzufügen. Weitere Informationen findest Du unter „[Eine Datei in Deinem Repository zu {% data variables.large_files.product_name_short %} verschieben](/articles/moving-a-file-in-your-repository-to-git-large-file-storage).“ +Wenn in Ihrem Repository bereits Dateien vorhanden sind, für die Sie {% data variables.product.product_name %} verwenden möchten, müssen Sie sie zunächst aus dem Repository entfernen und lokal zu {% data variables.large_files.product_name_short %} hinzufügen. Weitere Informationen findest Du unter „[Eine Datei in Deinem Repository zu {% data variables.large_files.product_name_short %} verschieben](/articles/moving-a-file-in-your-repository-to-git-large-file-storage).“ {% data reusables.large_files.resolving-upload-failures %} @@ -24,8 +24,8 @@ Wenn in Deinem Repository bereits Dateien vorhanden sind, für die Du {% data va {% endif %} {% data reusables.command_line.open_the_multi_os_terminal %} -2. Ändere das aktuelle Arbeitsverzeichnis in ein vorhandenes Repository, das Du mit {% data variables.large_files.product_name_short %} verwenden möchtest. -3. Um eine Datei in Deinem Repository mit {% data variables.large_files.product_name_short %} zu verknüpfen, gib `git {% data variables.large_files.command_name %} track` ein, gefolgt vom Namen der Dateierweiterung, die Du automatisch zu {% data variables.large_files.product_name_short %} hochladen möchtest. +2. Ändern Sie das aktuelle Arbeitsverzeichnis in ein vorhandenes Repository, das Sie mit {% data variables.large_files.product_name_short %} verwenden möchten. +3. Um eine Datei in Ihrem Repository mit {% data variables.large_files.product_name_short %} zu verknüpfen, geben Sie `git {% data variables.large_files.command_name %} track` gefolgt vom Namen der Dateierweiterung ein, die Sie automatisch zu {% data variables.large_files.product_name_short %} hochladen möchten. Um beispielsweise eine _.psd_-Datei zu verknüpfen, gib den folgenden Befehl ein: ```shell @@ -47,7 +47,7 @@ Wenn in Deinem Repository bereits Dateien vorhanden sind, für die Du {% data va 5. Gib die Datei frei und übertrage sie zu {% data variables.product.product_name %}: ```shell $ git commit -m "add file.psd" - $ git push origin master + $ git push ``` Du solltest Diagnoseinformationen zum Hochladen der Datei sehen: ```shell diff --git a/translations/de-DE/content/github/managing-large-files/installing-git-large-file-storage.md b/translations/de-DE/content/github/managing-large-files/installing-git-large-file-storage.md index 2a28a2ad1138..e84ed894bde8 100644 --- a/translations/de-DE/content/github/managing-large-files/installing-git-large-file-storage.md +++ b/translations/de-DE/content/github/managing-large-files/installing-git-large-file-storage.md @@ -11,11 +11,11 @@ versions: {% mac %} -1. Navigiere zu [git-lfs.github.com](https://git-lfs.github.com), und klicke auf **Download** (Herunterladen). Alternativ kannst Du {% data variables.large_files.product_name_short %} auch mit einem Paketmanager installieren: +1. Navigiere zu [git-lfs.github.com](https://git-lfs.github.com), und klicke auf **Download** (Herunterladen). Alternativ können Sie {% data variables.large_files.product_name_short %} auch mit einem Paketmanager installieren: - Um [Homebrew](http://brew.sh/) zu verwenden, führe `brew install git-lfs` aus. - Um [MacPorts](https://www.macports.org/) zu verwenden, führe `port install git-lfs` aus. - Wenn Du {% data variables.large_files.product_name_short %} mit Homebrew oder MacPorts installierst, fahre mit Schritt 6 fort. + Wenn Sie {% data variables.large_files.product_name_short %} mit Homebrew oder MacPorts installieren, fahren Sie mit Schritt 6 fort. 2. Suche und entpacke auf Deinem Computer die heruntergeladene Datei. {% data reusables.command_line.open_the_multi_os_terminal %} @@ -43,7 +43,7 @@ versions: $ git {% data variables.large_files.command_name %} install > {% data variables.large_files.product_name_short %} initialized. ``` -6. Wenn keine Nachricht angezeigt wird, die angibt, dass `git {% data variables.large_files.command_name %} install` erfolgreich war, wenden Sie sich an {% data variables.contact.contact_support %}. Denken Sie daran, den Namen Ihres Betriebssystems anzugeben. +6. Wenn keine Nachricht angezeigt wird, die angibt, dass `git {% data variables.large_files.command_name %} install` erfolgreich war, wende Dich an {% data variables.contact.contact_support %}. Denken Sie daran, den Namen Ihres Betriebssystems anzugeben. {% endmac %} @@ -57,14 +57,15 @@ versions: {% endtip %} 2. Suche auf Deinem Computer die heruntergeladene Datei. -3. Doppelklicke auf die Datei namens *git-lfs-windows-1.X.X.exe*, wobei 1.X.X durch die Version von Git LFS ersetzt wird, die Du heruntergeladen hast. Wenn Du diese Datei öffnest, führt Windows einen Einrichtungsassistenten für die Installation von {% data variables.large_files.product_name_short %} aus. +3. Doppelklicke auf die Datei namens *git-lfs-windows-1.X.X.exe*, wobei 1.X.X durch die Version von Git LFS ersetzt wird, die Du heruntergeladen hast. When you open this file Windows will run a setup wizard to install +{% data variables.large_files.product_name_short %}. {% data reusables.command_line.open_the_multi_os_terminal %} 5. Überprüfen Sie, ob die Installation erfolgreich war: ```shell $ git {% data variables.large_files.command_name %} install > {% data variables.large_files.product_name_short %} initialized. ``` -6. Wenn keine Nachricht angezeigt wird, die angibt, dass `git {% data variables.large_files.command_name %} install` erfolgreich war, wenden Sie sich an {% data variables.contact.contact_support %}. Denken Sie daran, den Namen Ihres Betriebssystems anzugeben. +6. Wenn keine Nachricht angezeigt wird, die angibt, dass `git {% data variables.large_files.command_name %} install` erfolgreich war, wende Dich an {% data variables.contact.contact_support %}. Denken Sie daran, den Namen Ihres Betriebssystems anzugeben. {% endwindows %} @@ -103,7 +104,7 @@ versions: $ git {% data variables.large_files.command_name %} install > {% data variables.large_files.product_name_short %} initialized. ``` -6. Wenn keine Nachricht angezeigt wird, die angibt, dass `git {% data variables.large_files.command_name %} install` erfolgreich war, wenden Sie sich an {% data variables.contact.contact_support %}. Denken Sie daran, den Namen Ihres Betriebssystems anzugeben. +6. Wenn keine Nachricht angezeigt wird, die angibt, dass `git {% data variables.large_files.command_name %} install` erfolgreich war, wende Dich an {% data variables.contact.contact_support %}. Denken Sie daran, den Namen Ihres Betriebssystems anzugeben. {% endlinux %} diff --git a/translations/de-DE/content/github/managing-large-files/moving-a-file-in-your-repository-to-git-large-file-storage.md b/translations/de-DE/content/github/managing-large-files/moving-a-file-in-your-repository-to-git-large-file-storage.md index 2354b84cc89e..3eae7b5cea8b 100644 --- a/translations/de-DE/content/github/managing-large-files/moving-a-file-in-your-repository-to-git-large-file-storage.md +++ b/translations/de-DE/content/github/managing-large-files/moving-a-file-in-your-repository-to-git-large-file-storage.md @@ -1,6 +1,6 @@ --- title: Eine Datei in Deinem Repository zu Git Large File Storage verschieben -intro: 'Wenn Du {% data variables.large_files.product_name_short %} eingerichtet hast und eine vorhandene Datei in Deinem Repository in {% data variables.large_files.product_name_short %} nachverfolgt werden muss, musst Du sie zunächst aus Deinem Repository entfernen.' +intro: 'Wenn Sie {% data variables.large_files.product_name_short %} eingerichtet haben und eine vorhandene Datei in Ihrem Repository in {% data variables.large_files.product_name_short %} nachverfolgt werden muss, müssen Sie sie zunächst aus Ihrem Repository entfernen.' redirect_from: - /articles/moving-a-file-in-your-repository-to-git-large-file-storage versions: @@ -19,7 +19,7 @@ Nach der Installation von {% data variables.large_files.product_name_short %} un {% endtip %} 1. Entferne die Datei mit dem Befehl `filter-branch` oder mit BFG Repo-Cleaner aus dem Git-Verlauf des Repositorys. Weitere Informationen zur Verwendung dieser Werkzeuge findest Du unter „[Vertrauliche Daten aus einem Repository entfernen](/articles/removing-sensitive-data-from-a-repository).“ -2. Konfiguriere die Nachverfolgung für die Datei, und übertrage sie zu {% data variables.large_files.product_name_short %}. Weitere Informationen zu diesem Vorgang findest Du unter „[{% data variables.large_files.product_name_long %} konfigurieren](/articles/configuring-git-large-file-storage).“ +2. Konfigurieren Sie die Nachverfolgung für die Datei, und pushen Sie sie zu {% data variables.large_files.product_name_short %}. Weitere Informationen zu diesem Vorgang findest Du unter „[{% data variables.large_files.product_name_long %} konfigurieren](/articles/configuring-git-large-file-storage).“ ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/managing-large-files/removing-files-from-a-repositorys-history.md b/translations/de-DE/content/github/managing-large-files/removing-files-from-a-repositorys-history.md index e40fd462fb99..643b5232e4a0 100644 --- a/translations/de-DE/content/github/managing-large-files/removing-files-from-a-repositorys-history.md +++ b/translations/de-DE/content/github/managing-large-files/removing-files-from-a-repositorys-history.md @@ -1,6 +1,6 @@ --- title: Dateien aus dem Verlauf eines Repositorys entfernen -intro: 'Um eine große Datei aus Deinem Repository zu löschen, musst Du sie vollständig aus Deinem lokalen Repository und von {% data variables.product.product_location %} löschen.' +intro: 'Um eine große Datei aus Ihrem Repository zu löschen, müssen Sie sie vollständig aus Ihrem lokalen Repository und von {% data variables.product.product_location %} löschen.' redirect_from: - /articles/removing-files-from-a-repository-s-history - /articles/removing-files-from-a-repositorys-history @@ -21,7 +21,7 @@ Wenn Du eine Datei in einem früheren Commit hinzugefügt hast, musst Du sie aus ### Datei entfernen, die beim letzten noch nicht übertragenen Commit hinzugefügt wurde -Wenn eine Datei bei Deinem letzten Commit hinzugefügt, aber noch nicht per Push auf {% data variables.product.product_location %} übertragen wurde, kannst Du die Datei löschen und den Commit anpassen: +Wenn eine Datei bei Ihrem letzten Commit hinzugefügt wurde und dieses noch nicht per Push auf {% data variables.product.product_location %} übertragen wurde, können Sie die Datei löschen und den Commit ändern: {% data reusables.command_line.open_the_multi_os_terminal %} {% data reusables.command_line.switching_directories_procedural %} diff --git a/translations/de-DE/content/github/managing-large-files/removing-files-from-git-large-file-storage.md b/translations/de-DE/content/github/managing-large-files/removing-files-from-git-large-file-storage.md index a968ebef5f23..9290d04394dc 100644 --- a/translations/de-DE/content/github/managing-large-files/removing-files-from-git-large-file-storage.md +++ b/translations/de-DE/content/github/managing-large-files/removing-files-from-git-large-file-storage.md @@ -1,6 +1,6 @@ --- -title: Dateien aus dem Git Large File Storage entfernen -intro: 'Wenn Du für Dein Repository {% data variables.large_files.product_name_short %} eingerichtet hast, kannst Du alle oder einen Teil der Dateien aus {% data variables.large_files.product_name_short %} entfernen.' +title: Removing files from Git Large File Storage +intro: 'If you''ve set up {% data variables.large_files.product_name_short %} for your repository, you can remove all files or a subset of files from {% data variables.large_files.product_name_short %}.' redirect_from: - /articles/removing-files-from-git-large-file-storage versions: @@ -8,45 +8,45 @@ versions: enterprise-server: '*' --- -### Einzelne Datei entfernen +### Removing a single file -1. Entferne die Datei mit dem Befehl `filter-branch` oder mit BFG Repo-Cleaner aus dem Git-Verlauf des Repositorys. Weitere Informationen zur Verwendung dieser Werkzeuge findest Du unter „[Vertrauliche Daten aus einem Repository entfernen](/articles/removing-sensitive-data-from-a-repository).“ -2. Navigiere zu Deiner *.gitattributes*-Datei. +1. Remove the file from the repository's Git history using either the `filter-branch` command or BFG Repo-Cleaner. For detailed information on using these, see "[Removing sensitive data from a repository](/articles/removing-sensitive-data-from-a-repository)." +2. Navigate to your *.gitattributes* file. {% note %} - **Hinweis:** Die *.gitattributes*-Datei wird im Allgemeinen im lokalen Repository gespeichert. Eventuell hast Du aber auch eine globale *.gitattributes*-Datei mit allen Deinen {% data variables.large_files.product_name_short %}-Zuordnungen erstellt. + **Note:** Your *.gitattributes* file is generally saved within your local repository. In some cases, you may have created a global *.gitattributes* file that contains all of your {% data variables.large_files.product_name_short %} associations. {% endnote %} -3. Suche und entferne die zugeordnete {% data variables.large_files.product_name_short %}-Tracking-Regel (Nachverfolgungsregel) in der *.gitattributes*-Datei. -4. Speichere und schließe die *.gitattributes*-Datei. +3. Find and remove the associated {% data variables.large_files.product_name_short %} tracking rule within the *.gitattributes* file. +4. Save and exit the *.gitattributes* file. -### Alle Dateien eines {% data variables.large_files.product_name_short %}-Repositorys entfernen +### Removing all files within a {% data variables.large_files.product_name_short %} repository -1. Entferne die Dateien mit dem Befehl `filter-branch` oder mit BFG Repo-Cleaner aus dem Git-Verlauf des Repositorys. Weitere Informationen zur Verwendung dieser Werkzeuge findest Du unter „[Vertrauliche Daten aus einem Repository entfernen](/articles/removing-sensitive-data-from-a-repository).“ -2. Führe optional folgenden Befehl aus, um {% data variables.large_files.product_name_short %} im Repository zu deinstallieren: +1. Remove the files from the repository's Git history using either the `filter-branch` command or BFG Repo-Cleaner. For detailed information on using these, see "[Removing sensitive data from a repository](/articles/removing-sensitive-data-from-a-repository)." +2. Optionally, to uninstall {% data variables.large_files.product_name_short %} in the repository, run: ```shell $ git lfs uninstall ``` - Führe bei {% data variables.large_files.product_name_short %}-Versionen vor 1.1.0 folgenden Befehl aus: + For {% data variables.large_files.product_name_short %} versions below 1.1.0, run: ```shell $ git lfs uninit ``` -### {% data variables.large_files.product_name_short %}-Objekte in Deinem Repository +### {% data variables.large_files.product_name_short %} objects in your repository -Die {% data variables.large_files.product_name_short %}-Objekte von Dateien, die Du aus {% data variables.large_files.product_name_short %} entfernt hast, sind nach wie vor im Remote-Speicher vorhanden{% if currentVersion == "free-pro-team@latest" %} und werden Deinem {% data variables.large_files.product_name_short %}-Speicher-Kontingent weiterhin angerechnet{% endif %}. +After you remove files from {% data variables.large_files.product_name_short %}, the {% data variables.large_files.product_name_short %} objects still exist on the remote storage{% if currentVersion == "free-pro-team@latest" %} and will continue to count toward your {% data variables.large_files.product_name_short %} storage quota{% endif %}. -Um {% data variables.large_files.product_name_short %}-Objekte aus einem Repository zu entfernen, {% if currentVersion == "free-pro-team@latest" %}lösche und erstelle das Repository erneut. Wenn Du ein Repository löschst, werden alle zugehörigen Issues, Sterne und Forks ebenfalls gelöscht. Weitere Informationen findest Du unter "[Löschen eines Repositories](/github/administering-a-repository/deleting-a-repository)."{% else %}kontaktiere Deinen {% data variables.product.prodname_enterprise %}-Administrator, um die Objekte zu archivieren. Archivierte Objekte werden nach drei Monaten gelöscht.{% endif %} +To remove {% data variables.large_files.product_name_short %} objects from a repository, {% if currentVersion == "free-pro-team@latest" %}delete and recreate the repository. When you delete a repository, any associated issues, stars, and forks are also deleted. For more information, see "[Deleting a repository](/github/administering-a-repository/deleting-a-repository)."{% else %}contact your {% data variables.product.prodname_enterprise %} administrator to archive the objects. Archived objects are purged after three months.{% endif %} {% note %} -**Hinweis:** Wenn Du eine einzelne Datei entfernt hast und andere {% data variables.large_files.product_name_short %}-Objekte hast, die Du in Deinem Repository behalten möchtest, rekonfiguriere Deine {% data variables.large_files.product_name_short %} zugeordneten Dateien,nachdem Du Dein Repository gelöscht und neu erstellt hast. Weitere Informationen findest Du unter "[Entferne eine einzelne Datei](#removing-a-single-file)" und "[Konfiguriere {% data variables.large_files.product_name_long %}](/github/managing-large-files/configuring-git-large-file-storage)." +**Note:** If you removed a single file and have other {% data variables.large_files.product_name_short %} objects that you'd like to keep in your repository, after deleting and recreating your repository, reconfigure your {% data variables.large_files.product_name_short %}-associated files. For more information, see "[Removing a single file](#removing-a-single-file)" and "[Configuring {% data variables.large_files.product_name_long %}](/github/managing-large-files/configuring-git-large-file-storage)." {% endnote %} -### Weiterführende Informationen +### Further reading -- „[Informationen zu {% data variables.large_files.product_name_long %}](/articles/about-git-large-file-storage)“ -- „[Mit {% data variables.large_files.product_name_long %} zusammenarbeiten](/articles/collaboration-with-git-large-file-storage/)“ -- „[{% data variables.large_files.product_name_long %} installieren](/articles/installing-git-large-file-storage)“ +- "[About {% data variables.large_files.product_name_long %}](/articles/about-git-large-file-storage)" +- "[Collaboration with {% data variables.large_files.product_name_long %}](/articles/collaboration-with-git-large-file-storage/)" +- "[Installing {% data variables.large_files.product_name_long %}](/articles/installing-git-large-file-storage)" diff --git a/translations/de-DE/content/github/managing-large-files/resolving-git-large-file-storage-upload-failures.md b/translations/de-DE/content/github/managing-large-files/resolving-git-large-file-storage-upload-failures.md index 4ee9532dd07e..044748464754 100644 --- a/translations/de-DE/content/github/managing-large-files/resolving-git-large-file-storage-upload-failures.md +++ b/translations/de-DE/content/github/managing-large-files/resolving-git-large-file-storage-upload-failures.md @@ -1,6 +1,6 @@ --- title: Fehler beim Hochladen mit Git Large File Storage beheben -intro: 'Wenn Deine {% data variables.large_files.product_name_short %}-Dateien nicht richtig hochgeladen werden, kannst Du den Fehler beim Hochladen in mehreren Schritten beheben.' +intro: 'Wenn Ihre {% data variables.large_files.product_name_short %}-Dateien nicht richtig hochgeladen werden, können Sie den Uploadfehler in mehreren Schritten beheben.' redirect_from: - /articles/resolving-git-large-file-storage-upload-failures versions: diff --git a/translations/de-DE/content/github/managing-large-files/working-with-large-files.md b/translations/de-DE/content/github/managing-large-files/working-with-large-files.md index f735753787da..193cf0489934 100644 --- a/translations/de-DE/content/github/managing-large-files/working-with-large-files.md +++ b/translations/de-DE/content/github/managing-large-files/working-with-large-files.md @@ -1,6 +1,6 @@ --- title: Große Dateien verwenden -intro: Ein Git-Repository enthält jede Version jeder Datei. Für einige Dateitypen ist dies jedoch nicht praktikabel. Durch mehrere Revisionen großer Dateien werden die Klon- und Abrufzeiten für andere Benutzer eines Repositorys erhöht. +intro: 'Ein Git-Repository enthält jede Version jeder Datei. Für einige Dateitypen ist dies jedoch nicht praktikabel. Durch mehrere Revisionen großer Dateien werden die Klon- und Abrufzeiten für andere Benutzer eines Repositorys erhöht.' mapTopic: true redirect_from: - /articles/working-with-large-files diff --git a/translations/de-DE/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md b/translations/de-DE/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md index 73b8dce6840a..0ce617f2fdb2 100644 --- a/translations/de-DE/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md +++ b/translations/de-DE/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md @@ -77,15 +77,15 @@ We send security alerts to people with admin permissions in the affected reposit ### Configuring notifications for {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} {% if currentVersion == "free-pro-team@latest" %} -By default, you will receive {% data variables.product.prodname_dependabot_alerts %} by email, grouped by the specific vulnerability. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-options)." +By default, you will receive {% data variables.product.prodname_dependabot_alerts %} by email, grouped by the specific vulnerability. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-notification-options)." {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %} -By default, if your site administrator has configured email for notifications on your instance, you will receive {% data variables.product.prodname_dependabot_alerts %} by email. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-options)." +By default, if your site administrator has configured email for notifications on your instance, you will receive {% data variables.product.prodname_dependabot_alerts %} by email. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-notification-options)." {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion == "enterprise-server@2.21" %} -By default, if your site administrator has configured email for notifications on your instance, you will receive security alerts by email. You can also choose to receive security alerts in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#security-alert-options)." +By default, if your site administrator has configured email for notifications on your instance, you will receive security alerts by email. You can also choose to receive security alerts in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#security-alert-notification-options)." {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.21" %} diff --git a/translations/de-DE/content/github/managing-security-vulnerabilities/adding-a-collaborator-to-a-security-advisory.md b/translations/de-DE/content/github/managing-security-vulnerabilities/adding-a-collaborator-to-a-security-advisory.md index 77900a9a44ad..ce3384ca1dfa 100644 --- a/translations/de-DE/content/github/managing-security-vulnerabilities/adding-a-collaborator-to-a-security-advisory.md +++ b/translations/de-DE/content/github/managing-security-vulnerabilities/adding-a-collaborator-to-a-security-advisory.md @@ -1,6 +1,6 @@ --- title: Einen Mitarbeiter zu einem Sicherheitshinweis hinzufügen -intro: 'Du kannst andere Benutzer oder Teams hinzufügen, damit sie mit Dir an einem Sicherheitshinweis zusammenarbeiten.' +intro: Du kannst andere Benutzer oder Teams hinzufügen, damit sie mit Dir an einem Sicherheitshinweis zusammenarbeiten. redirect_from: - /articles/adding-a-collaborator-to-a-maintainer-security-advisory - /github/managing-security-vulnerabilities/adding-a-collaborator-to-a-maintainer-security-advisory diff --git a/translations/de-DE/content/github/managing-security-vulnerabilities/adding-a-security-policy-to-your-repository.md b/translations/de-DE/content/github/managing-security-vulnerabilities/adding-a-security-policy-to-your-repository.md index ee70669b18f2..91de531e7b32 100644 --- a/translations/de-DE/content/github/managing-security-vulnerabilities/adding-a-security-policy-to-your-repository.md +++ b/translations/de-DE/content/github/managing-security-vulnerabilities/adding-a-security-policy-to-your-repository.md @@ -1,6 +1,6 @@ --- title: Eine Sicherheitsrichtlinie zum Repository hinzufügen -intro: 'Indem Du eine Sicherheitsrichtlinie zu Deinem Repository hinzufügst, kannst Du festlegen, wie Sicherheitslücken in Deinem Projekt verantwortungsvoll gemeldet werden sollen.' +intro: Indem Du eine Sicherheitsrichtlinie zu Deinem Repository hinzufügst, kannst Du festlegen, wie Sicherheitslücken in Deinem Projekt verantwortungsvoll gemeldet werden sollen. redirect_from: - /articles/adding-a-security-policy-to-your-repository versions: @@ -19,7 +19,7 @@ Du kannst eine Standard-Sicherheitsrichtlinie für Deine Organisation oder Dein {% endtip %} -Nachdem jemand eine Sicherheitslücke in Deinem Projekt gemeldet hat, kannst Du {% data variables.product.prodname_security_advisories %} verwenden, um die Verwundbarkeit offen zu legen, sie zu korrigieren und entsprechende Informationen darüber zu veröffentlichen. Weitere Informationen findest Du unter „[Über {% data variables.product.prodname_security_advisories %}](/github/managing-security-vulnerabilities/about-github-security-advisories)." +Nachdem jemand eine Sicherheitslücke in Deinem Projekt gemeldet hat, kannst Du {% data variables.product.prodname_security_advisories %} verwenden, um die Verwundbarkeit offen zu legen, sie zu korrigieren und entsprechende Informationen darüber zu veröffentlichen. Weitere Informationen findest Du unter „[ Über {% data variables.product.prodname_security_advisories %}](/github/managing-security-vulnerabilities/about-github-security-advisories)." {% data reusables.repositories.github-security-lab %} diff --git a/translations/de-DE/content/github/managing-security-vulnerabilities/collaborating-in-a-temporary-private-fork-to-resolve-a-security-vulnerability.md b/translations/de-DE/content/github/managing-security-vulnerabilities/collaborating-in-a-temporary-private-fork-to-resolve-a-security-vulnerability.md index f8a448d52910..54fcd15dd479 100644 --- a/translations/de-DE/content/github/managing-security-vulnerabilities/collaborating-in-a-temporary-private-fork-to-resolve-a-security-vulnerability.md +++ b/translations/de-DE/content/github/managing-security-vulnerabilities/collaborating-in-a-temporary-private-fork-to-resolve-a-security-vulnerability.md @@ -1,6 +1,6 @@ --- -title: 'In einem temporären privaten Fork zusammenarbeiten, um eine Sicherheitslücke zu beheben' -intro: 'Du kannst einen temporären privaten Fork erstellen, um privat an der Behebung einer Sicherheitslücke in Deinem Repository zusammenzuarbeiten.' +title: In einem temporären privaten Fork zusammenarbeiten, um eine Sicherheitslücke zu beheben +intro: Du kannst einen temporären privaten Fork erstellen, um privat an der Behebung einer Sicherheitslücke in Deinem Repository zusammenzuarbeiten. redirect_from: - /articles/collaborating-in-a-temporary-private-fork-to-resolve-a-security-vulnerability versions: diff --git a/translations/de-DE/content/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates.md b/translations/de-DE/content/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates.md index 6a17ed5c24b1..e264b2838210 100644 --- a/translations/de-DE/content/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates.md +++ b/translations/de-DE/content/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates.md @@ -9,7 +9,7 @@ versions: free-pro-team: '*' --- -### Informationen zu {% data variables.product.prodname_dependabot_security_updates %} +### Informationen zum {% data variables.product.prodname_dependabot_security_updates %} {% data variables.product.prodname_dependabot_short %} monitors security advisories such as the {% data variables.product.prodname_advisory_database %} and [WhiteSource](https://www.whitesourcesoftware.com/GitHubSecurityAlerts) and automatically triggers a pull request when it detects a new vulnerable dependency in the dependency graph of repositories. For more information about the {% data variables.product.prodname_advisory_database %}, see "[About the {% data variables.product.prodname_advisory_database %}](/github/managing-security-vulnerabilities/browsing-security-vulnerabilities-in-the-github-advisory-database#about-the-github-advisory-database)." @@ -23,7 +23,7 @@ When you merge a pull request that contains a security update, the corresponding {% note %} -**Note** +**Hinweis** {% data variables.product.prodname_dependabot_security_updates %} only resolve security vulnerabilities in the dependencies tracked by your dependency graph. Security updates are not created to resolve vulnerabilities in private registries or packages hosted in private repositories. However, indirect or transitive dependencies are included if they are explicitly defined in a lock file, or similar. For more information, see "[About the dependency graph](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)." Additionally, it's important to highlight that {% data variables.product.prodname_dependabot_security_updates %} automatically create pulls requests with proposed fixes to the lock files, for the dependencies detected as vulnerable. {% endnote %} @@ -42,14 +42,14 @@ You can enable {% data variables.product.prodname_dependabot_security_updates %} {% endnote %} -| Automatic enablement prerequisite | Weitere Informationen | -| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Das Repository ist kein Fork | „[Über Forks](/github/collaborating-with-issues-and-pull-requests/about-forks)" | -| Das Repository ist nicht archiviert | „[Repositorys archivieren](/github/creating-cloning-and-archiving-repositories/archiving-repositories)" | +| Automatic enablement prerequisite | Weitere Informationen | +| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Das Repository ist kein Fork | „[Über Forks](/github/collaborating-with-issues-and-pull-requests/about-forks)" | +| Das Repository ist nicht archiviert | „[Repositorys archivieren](/github/creating-cloning-and-archiving-repositories/archiving-repositories)" | | Das Repository ist öffentlich, oder es ist privat und Du hast Nur-Lesen-Analysen durch {% data variables.product.prodname_dotcom %}, Abhängigkeitsdiagramme und Sicherheitswarnungen in den Repository-Einstellungen aktiviert | "[Managing data use settings for your private repository](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository)." | | Das Repository enthält eine Abhängigkeits-Manifestdatei aus einem Paket-Ökosystem, das {% data variables.product.prodname_dotcom %} unterstützt | „[Unterstützte Paket-Ökosysteme](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph#supported-package-ecosystems)" | -| {% data variables.product.prodname_dependabot_security_updates %} are not disabled for the repository | "[Managing {% data variables.product.prodname_dependabot_security_updates %} for your repository](#managing-github-dependabot-security-updates-for-your-repositories)" | -| Das Repository benutzt noch keine Integration für die Abhängigkeits-Verwaltung | „[Informationen zu Integrationen](/github/customizing-your-github-workflow/about-integrations)“ | +| {% data variables.product.prodname_dependabot_security_updates %} are not disabled for the repository | "[Managing {% data variables.product.prodname_dependabot_security_updates %} for your repository](#managing-github-dependabot-security-updates-for-your-repositories)" | +| Das Repository benutzt noch keine Integration für die Abhängigkeits-Verwaltung | „[Informationen zu Integrationen](/github/customizing-your-github-workflow/about-integrations)“ | If security updates are not enabled for your repository and you don't know why, first try enabling them using the instructions given in the procedural sections below. If security updates are still not working, you can [contact support](https://support.github.com/contact). diff --git a/translations/de-DE/content/github/managing-security-vulnerabilities/creating-a-security-advisory.md b/translations/de-DE/content/github/managing-security-vulnerabilities/creating-a-security-advisory.md index 8ca1ae9e632b..3e564df18d7d 100644 --- a/translations/de-DE/content/github/managing-security-vulnerabilities/creating-a-security-advisory.md +++ b/translations/de-DE/content/github/managing-security-vulnerabilities/creating-a-security-advisory.md @@ -1,6 +1,6 @@ --- title: Einen Sicherheitshinweis erstellen -intro: 'Du kannst einen Entwurf eines Sicherheitshinweises erstellen, um privat über die Sicherheitslücke in Deinem Open-Source-Projekt zu diskutieren und sie zu beheben.' +intro: Du kannst einen Entwurf eines Sicherheitshinweises erstellen, um privat über die Sicherheitslücke in Deinem Open-Source-Projekt zu diskutieren und sie zu beheben. redirect_from: - /articles/creating-a-maintainer-security-advisory - /github/managing-security-vulnerabilities/creating-a-maintainer-security-advisory diff --git a/translations/de-DE/content/github/managing-security-vulnerabilities/editing-a-security-advisory.md b/translations/de-DE/content/github/managing-security-vulnerabilities/editing-a-security-advisory.md index 67374d733b19..8b7eeacd99f3 100644 --- a/translations/de-DE/content/github/managing-security-vulnerabilities/editing-a-security-advisory.md +++ b/translations/de-DE/content/github/managing-security-vulnerabilities/editing-a-security-advisory.md @@ -1,6 +1,6 @@ --- title: Einen Sicherheitshinweis bearbeiten -intro: 'Du kannst die Metadaten und die Beschreibung für einen Sicherheitshinweis bearbeiten, wenn Du Details aktualisieren oder Fehler korrigieren musst.' +intro: Du kannst die Metadaten und die Beschreibung für einen Sicherheitshinweis bearbeiten, wenn Du Details aktualisieren oder Fehler korrigieren musst. versions: free-pro-team: '*' --- diff --git a/translations/de-DE/content/github/managing-security-vulnerabilities/managing-vulnerabilities-in-your-projects-dependencies.md b/translations/de-DE/content/github/managing-security-vulnerabilities/managing-vulnerabilities-in-your-projects-dependencies.md index 7b1e1dafba30..a46f90b80705 100644 --- a/translations/de-DE/content/github/managing-security-vulnerabilities/managing-vulnerabilities-in-your-projects-dependencies.md +++ b/translations/de-DE/content/github/managing-security-vulnerabilities/managing-vulnerabilities-in-your-projects-dependencies.md @@ -1,6 +1,6 @@ --- title: Sicherheitslücken in den Abhängigkeiten Deines Projekts verwalten -intro: 'You can track your repository''s dependencies and receive {% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} when {% data variables.product.product_name %} detects vulnerable dependencies.' +intro: 'You can track your repository''s dependencies and receive {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} when {% data variables.product.product_name %} detects vulnerable dependencies.' mapTopic: true redirect_from: - /articles/updating-your-project-s-dependencies/ diff --git a/translations/de-DE/content/github/managing-security-vulnerabilities/permission-levels-for-security-advisories.md b/translations/de-DE/content/github/managing-security-vulnerabilities/permission-levels-for-security-advisories.md index bf2064ad6699..2be955ab0041 100644 --- a/translations/de-DE/content/github/managing-security-vulnerabilities/permission-levels-for-security-advisories.md +++ b/translations/de-DE/content/github/managing-security-vulnerabilities/permission-levels-for-security-advisories.md @@ -1,6 +1,6 @@ --- title: Berechtigungsstufen für Sicherheitshinweise -intro: 'Welche Aktionen Du in einem Sicherheitshinweis durchführen kannst, hängt davon ab, ob Du Administrations- oder Schreibberechtigungen für den Sicherheitshinweis hast.' +intro: Welche Aktionen Du in einem Sicherheitshinweis durchführen kannst, hängt davon ab, ob Du Administrations- oder Schreibberechtigungen für den Sicherheitshinweis hast. redirect_from: - /articles/permission-levels-for-maintainer-security-advisories - /github/managing-security-vulnerabilities/permission-levels-for-maintainer-security-advisories diff --git a/translations/de-DE/content/github/managing-security-vulnerabilities/publishing-a-security-advisory.md b/translations/de-DE/content/github/managing-security-vulnerabilities/publishing-a-security-advisory.md index 4f76944e1591..006093078e66 100644 --- a/translations/de-DE/content/github/managing-security-vulnerabilities/publishing-a-security-advisory.md +++ b/translations/de-DE/content/github/managing-security-vulnerabilities/publishing-a-security-advisory.md @@ -1,6 +1,6 @@ --- title: Einen Sicherheitshinweis veröffentlichen -intro: 'Du kannst einen Sicherheitshinweis veröffentlichen, um Deine Community über eine Sicherheitslücke in Deinem Projekt zu informieren.' +intro: Du kannst einen Sicherheitshinweis veröffentlichen, um Deine Community über eine Sicherheitslücke in Deinem Projekt zu informieren. redirect_from: - /articles/publishing-a-maintainer-security-advisory - /github/managing-security-vulnerabilities/publishing-a-maintainer-security-advisory diff --git a/translations/de-DE/content/github/managing-security-vulnerabilities/withdrawing-a-security-advisory.md b/translations/de-DE/content/github/managing-security-vulnerabilities/withdrawing-a-security-advisory.md index efbf364bb01a..cf76ca5d3f8e 100644 --- a/translations/de-DE/content/github/managing-security-vulnerabilities/withdrawing-a-security-advisory.md +++ b/translations/de-DE/content/github/managing-security-vulnerabilities/withdrawing-a-security-advisory.md @@ -1,6 +1,6 @@ --- title: Einen Sicherheitshinweis zurückziehen -intro: 'Du kannst einen Sicherheitshinweis, den Du veröffentlicht hast, auch wieder zurückziehen.' +intro: Du kannst einen Sicherheitshinweis, den Du veröffentlicht hast, auch wieder zurückziehen. versions: free-pro-team: '*' --- diff --git a/translations/de-DE/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md b/translations/de-DE/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md index c170649a0023..79bc5d3dfe54 100644 --- a/translations/de-DE/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md +++ b/translations/de-DE/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md @@ -53,7 +53,8 @@ Um Deine Abonnements übersichtlich zu halten, überprüfe Deine Abonnements und Um anzupassen, wie Du Aktualisierungen für bestimmte Pull Requests oder Issues erhalten möchtest, kannst Du Deine Einstellungen innerhalb des Issues oder Pull Requests konfigurieren. Weitere Informationen findest Du unter „[Eine einzelne Benachrichtigung selektieren](/github/managing-subscriptions-and-notifications-on-github/triaging-a-single-notification#customizing-when-to-receive-future-updates-for-an-issue-or-pull-request).” {% if currentVersion == "free-pro-team@latest" %} -Du kannst Push-Benachrichtigungen in der {% data variables.product.prodname_mobile %}-App aktivieren. Weitere Informationen findest Du unter „[Benachrichtigungen konfigurieren](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#enabling-push-notifications-with-github-for-mobile)." +You can enable push notifications in the +{% data variables.product.prodname_mobile %} app. Weitere Informationen findest Du unter „[Benachrichtigungen konfigurieren](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#enabling-push-notifications-with-github-for-mobile)." {% endif %} ### Gründe für den Erhalt von Benachrichtigungen diff --git a/translations/de-DE/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md b/translations/de-DE/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md index 35e1284863d2..64c110f04ec6 100644 --- a/translations/de-DE/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md +++ b/translations/de-DE/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md @@ -1,6 +1,6 @@ --- -title: Configuring notifications -intro: 'Choose the type of activity on {% data variables.product.product_name %} that you want to receive notifications for and how you want these updates delivered.' +title: Benachrichtigungen konfigurieren +intro: 'Wähle die Art der Aktivitäten auf {% data variables.product.product_name %} , für die Du Benachrichtigungen erhalten möchtest und wie Du diese Aktualisierungen erhalten möchtest.' redirect_from: - /articles/about-web-notifications - /format-of-notification-emails/ @@ -18,15 +18,15 @@ versions: enterprise-server: '>=2.21' --- -### Notification delivery options +### Zustellungsoptionen für Benachrichtigungen -You have three basic options for notification delivery: +Du hast drei grundlegende Optionen für die Zustellung von Benachrichtigungen: - the notifications inbox on {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} - the notifications inbox on {% data variables.product.prodname_mobile %}, which syncs with the inbox on {% data variables.product.product_name %}{% endif %} - an email client that uses a verified email address, which can also sync with the notifications inbox on {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} and {% data variables.product.prodname_mobile %}{% endif %} {% if currentVersion == "free-pro-team@latest" %} -{% data reusables.notifications-v2.notifications-inbox-required-setting %} For more information, see "[Choosing your notification settings](#choosing-your-notification-settings)." +{% data reusables.notifications-v2.notifications-inbox-required-setting %} Weitere Informationen findest Du auf „[Deine Benachrichtigungseinstellungen wählen](#choosing-your-notification-settings)." {% endif %} {% data reusables.notifications-v2.tip-for-syncing-email-and-your-inbox-on-github %} @@ -34,46 +34,47 @@ You have three basic options for notification delivery: #### Benefits of the notifications inbox The notifications inbox on {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} and {% data variables.product.prodname_mobile %}{% endif %} includes triaging options designed specifically for your {% data variables.product.product_name %} notifications flow, including options to: - - Triage multiple notifications at once. - - Mark completed notifications as **Done** and remove them from your inbox. To view all of your notifications marked as **Done**, use the `is:done` query. - - Save a notification to review later. Saved notifications are flagged in your inbox and kept indefinitely. To view all of your saved notifications, use the `is:saved` query. - - Unsubscribe and remove a notification from your inbox. - - Preview the issue, pull request, or team discussion where the notification originates on {% data variables.product.product_name %} from within the notifications inbox. - - See one of the latest reasons you're receiving a notification from your inbox with a `reasons` label. - - Create custom filters to focus on different notifications when you want. - - Group notifications in your inbox by repository or date to get a quick overview with less context switching + - Selektieren mehrerer Benachrichtigungen auf einmal. + - Erledigte Benachrichtigungen als **Done** (Erledigt) markieren und aus dem Posteingang entfernen. Um alle Deine Benachrichtigungen anzuzeigen, die als **Done** markiert sind, verwende die Abfrage mit `is:done`. + - Sichere eine Benachrichtigung für späteren Review. Gesicherte Benachrichtigungen sind in Deinem Posteingang markiert und werden auf unbestimmte Zeit gehalten. Um alle Deine gesicherten Benachrichtigungen zu sehen, benutze die Abfrage mit `is:saved`. + - Melde eine Benachrichtigung ab und entferne sie aus dem Posteingang. + - Vorschau des Issue, Pull Request oder der Team-Diskussion, aus der die Benachrichtigung auf {% data variables.product.product_name %} erstellt wurde, direkt aus dem Posteingang der Benachrichtigungen. + - Siehe einen der neuesten Gründe, weshalb Du eine Benachrichtigung erhältst, über die Kennzeichnung `reasons` (Grund) in Deinem Posteingang. + - Erstelle benutzerdefinierte Filter, um auf Wunsch auf verschiedene Benachrichtigungen fokussieren zu können. + - Gruppiere Benachrichtigungen in Deinem Posteingang nach Repository oder Datum, um einen schnellen Überblick mit weniger Kontextwechseln zu erhalten {% if currentVersion == "free-pro-team@latest" %} -In addition, the notifications inbox on {% data variables.product.prodname_mobile %} allows you to triage notifications in dark mode and receive push notifications for direct mentions. For more information, see "[Enabling push notifications with GitHub for mobile](#enabling-push-notifications-with-github-for-mobile)" or "[GitHub for mobile](/github/getting-started-with-github/github-for-mobile)." +In addition, the notifications inbox on +{% data variables.product.prodname_mobile %} allows you to triage notifications in dark mode and receive push notifications for direct mentions. Weitere Informationen findest Du auf „[Push-Benachrichtigungen mit GitHub for mobile einrichten](#enabling-push-notifications-with-github-for-mobile)" oder auf „[GitHub for mobile](/github/getting-started-with-github/github-for-mobile)." {% endif %} -#### Benefits of using an email client for notifications +#### Vorteile beim Benutzen eines E-Mail-Client für Benachrichtigungen -One benefit of using an email client is that all of your notifications can be kept indefinitely depending on your email client's storage capacity. Your inbox notifications are only kept for 5 months unless you've marked them as **Saved**. **Saved** notifications are kept indefinitely. For more information about your inbox's retention policy, see "[About notifications](/github/managing-subscriptions-and-notifications-on-github/about-notifications#notification-retention-policy)." +Ein Vorteil der Verwendung eines E-Mail-Clients ist, dass alle Deine Benachrichtigungen unbegrenzt aufbewahrt werden können, abhängig von der Speicherkapazität Deines E-Mail-Clients. In Deinem Posteingang für Benachrichtigungen hingegen werden Benachrichtigungen nur für 5 Monate aufbewahrt, außer wenn du sie mit **Saved** (Gesichert) markiert hast. Mit **Saved** (Gesichert) markierte Benachrichtigungen werden unbegrenzt gespeichert. Weitere Informationen zur Aufbewahrungsrichtlinie Deines Posteingangs findest Du unter „[Über Benachrichtigungen](/github/managing-subscriptions-and-notifications-on-github/about-notifications#notification-retention-policy)." -Sending notifications to your email client also allows you to customize your inbox according to your email client's settings, which can include custom or color-coded labels. +Benachrichtigungen an Deinen E-Mail-Client zu senden erlaubt Dir auch, Deinen Posteingang mit allen Einstellungen deines E-Mail-Clients anzupassen, welche allenfalls benutzerdefinierte oder farbcodierte Kennzeichnungen beinhalten. -Email notifications also allow flexibility with the types of notifications you receive and allow you to choose different email addresses for updates. For example, you can send certain notifications for a repository to a verified personal email address. For more information, about your email customization options, see "[Customizing your email notifications](#customizing-your-email-notifications)." +E-Mail-Benachrichtigungen ermöglichen auch Flexibilität bei der Art von Benachrichtigungen, die Du erhältst und erlauben Dir die Auswahl verschiedener E-Mail-Adressen für Aktualisierungen. Beispielsweise kannst Du bestimmte Benachrichtigungen für ein Repository an die verifizierte persönliche E-Mail-Adresse senden. Weitere Informationen über E-Mail-Anpassungsoptionen findest Du unter „[Deine E-Mail-Benachrichtigungen anpassen](#customizing-your-email-notifications)." -### About participating and watching notifications +### Über die Teilnahme und das Beobachten von Benachrichtigungen -When you watch a repository, you're subscribing to updates for activity in that repository. Similarly, when you watch a specific team's discussions, you're subscribing to all conversation updates on that team's page. To see repositories that you're watching, see [https://github.com/watching](https://github.com/watching). For more information, see "[Managing subscriptions and notifications on GitHub](/github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github)." +Wenn Du ein Repository beobachtest, abonnierst Du Aktualisierungen für Aktivitäten in diesem Repository. Ebenfalls, wenn Du die Diskussionen eines bestimmten Teams verfolgst, abonnierst Du alle Aktualisierungen der Unterhaltung auf der Seite dieses Teams. Um Repositorys zu sehen, die Du beobachtest, siehe [https://github.com/watching](https://github.com/watching). Weitere Informationen findest Du unter „[Abonnements und Benachrichtigungen auf GitHub verwalten](/github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github)." -Anytime you comment in a conversation or when someone @mentions your username, you are _participating_ in a conversation. By default, you are automatically subscribed to a conversation when you participate in it. You can unsubscribe from a conversation you've participated in manually by clicking **Unsubscribe** on the issue or pull request or through the **Unsubscribe** option in the notifications inbox. +Jedes Mal, wenn Du in einer Unterhaltung kommentierst oder wenn jemand Deinen Benutzernamen @erwähnt, bist Du _Teilnehmer_ in einer Unterhaltung. Standardmäßig abonnierst Du automatisch eine Unterhaltung, wenn Du daran teilnimmst. Du kannst Dich manuell von einer Unterhaltung abmelden, an der Du teilgenommen hast, indem Du auf dem Issue oder Pull Request auf **Unsubscribe** (Abmelden) klickst oder durch die Option **Unsubscribe** (Abmelden) im Posteingang für Benachrichtigungen. For conversations you're watching or participating in, you can choose whether you want to receive notifications by email or through the notifications inbox on {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} and {% data variables.product.prodname_mobile %}{% endif %}. -![Participating and watching notifications options](/assets/images/help/notifications-v2/participating-and-watching-options.png) +![Optionen für Teilnahme- und Beobachtungs-Benachrichtigungen](/assets/images/help/notifications-v2/participating-and-watching-options.png) -For example: - - If you don't want notifications to be sent to your email, unselect **email** for participating and watching notifications. - - If you want to receive notifications by email when you've participated in a conversation, then you can select **email** under "Participating". +Ein Beispiel: + - Wenn Du nicht möchtest, dass Benachrichtigungen an Deine E-Mail gesendet werden, deaktiviere **email** (E-Mail) für die Teilnahme und das Beobachten von Benachrichtigungen. + - Wenn Du Benachrichtigungen per E-Mail erhalten möchtest, wenn Du an einer Unterhaltung teilgenommen hast, kannst du **email** (E-Mail) unter „Participating" (Teilnehmen) auswählen. If you do not enable watching or participating notifications for web{% if currentVersion == "free-pro-team@latest" %} and mobile{% endif %}, then your notifications inbox will not have any updates. -### Customizing your email notifications +### E-Mail-Benachrichtigungen anpassen -After enabling email notifications, {% data variables.product.product_name %} will send notifications to you as multipart emails that contain both HTML and plain text copies of the content. Email notification content includes any Markdown, @mentions, emojis, hash-links, and more, that appear in the original content on {% data variables.product.product_name %}. If you only want to see the text in the email, you can configure your email client to display the plain text copy only. +Nach der Aktivierung von E-Mail-Benachrichtigungen sendet Dir {% data variables.product.product_name %} Benachrichtigungen als mehrteilige E-Mails, die sowohl HTML als auch reine Textkopien des Inhalts enthalten. Der Inhalt der E-Mail-Benachrichtigung umfasst alle Markdowns, @Erwähnungen, Emojis, Hash-Links usw., die im ursprünglichen Inhalt auf {% data variables.product.product_name %} erscheinen. Wenn Du nur den Text in der E-Mail sehen möchtest, kannst Du Deinen E-Mail-Client so konfigurieren, dass er nur die reine Textkopie anzeigt. {% data reusables.notifications.outbound_email_tip %} @@ -81,132 +82,135 @@ After enabling email notifications, {% data variables.product.product_name %} wi {% if currentVersion == "free-pro-team@latest" %} -If you're using Gmail, you can click a button beside the notification email to visit the original issue or pull request that generated the notification. +Wenn Sie Gmail verwenden, können Sie auf eine Schaltfläche neben der Benachrichtigungs-E-Mail klicken, um den ursprünglichen Issue bzw. Pull Request anzuzeigen, der die Benachrichtigung generiert hat. -![Buttons in Gmail](/assets/images/help/notifications/gmail-buttons.png) +![Schaltflächen in Gmail](/assets/images/help/notifications/gmail-buttons.png) {% endif %} -Choose a default email address where you want to send updates for conversations you're participating in or watching. You can also specify which activity on {% data variables.product.product_name %} you want to receive updates for using your default email address. For example, choose whether you want updates to your default email from: - - Comments on issues and pull requests. - - Pull request reviews. - - Pull request pushes. - - Your own updates, such as when you open, comment on, or close an issue or pull request. +Wähle eine Standard-E-Mail-Adresse, an die Du Aktualisierungen für Unterhaltungen senden willst, an denen Du teilnimmst oder die Du beobachtest. Du kannst auch definieren, für welche Aktivitäten auf {% data variables.product.product_name %} Du Aktualisierungen über Deine Standard-E-Mail-Adresse erhalten willst. Wähle zum Beispiel aus, ob Du Aktualisierungen an Deine Standard-E-Mail senden möchtest für: + - Kommentare für Issues und Pull Requests. + - Pull-Request-Reviews. + - Pull-Request-Pushes. + - Deine eigenen Aktualisierungen, wie wenn Du beispielsweise einen Issue oder Pull Request öffnest, kommentierst oder schließt. -Depending on the organization that owns the repository, you can also send notifications to different email addresses for specific repositories. For example, you can send notifications for a specific public repository to a verified personal email address. Your organization may require the email address to be verified for a specific domain. For more information, see “[Choosing where your organization’s email notifications are sent](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#choosing-where-your-organizations-email-notifications-are-sent)." +Abhängig von der Organisation, die das Repository besitzt, kannst Du auch Benachrichtigungen für bestimmte Repositories an verschiedene E-Mail-Adressen senden. Beispielsweise kannst Du Benachrichtigungen für ein bestimmtes öffentliches Repository an eine verifizierte persönliche E-Mail-Adresse senden. Deine Organisation verlangt möglicherweise, dass E-Mail-Adressen für bestimmte Domänen verifiziert sein müssen. Weitere Informationen findest Du auf „[Auswählen, wohin die E-Mail-Benachrichtigungen Deiner Organisation gesendet werden](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#choosing-where-your-organizations-email-notifications-are-sent)." {% data reusables.notifications-v2.email-notification-caveats %} -### Filtering email notifications +### E-Mail-Benachrichtigungen filtern -Each email notification that {% data variables.product.product_name %} sends contains header information. The header information in every email is consistent, so you can use it in your email client to filter or forward all {% data variables.product.product_name %} notifications, or certain types of {% data variables.product.product_name %} notifications. +Jede E-Mail-Benachrichtigung, die {% data variables.product.product_name %} sendet, enthält Headerinformationen. Die Header-Informationen in jeder E-Mail sind einheitlich, sodass Du sie in Deinem E-Mail-Client verwenden kannst, um alle {% data variables.product.product_name %}-Benachrichtigungen oder bestimmte Arten von {% data variables.product.product_name %}-Benachrichtigungen zu filtern oder weiterzuleiten. -If you believe you're receiving notifications that don't belong to you, examine the `X-GitHub-Recipient` and `X-GitHub-Recipient-Address` headers. These headers show who the intended recipient is. Depending on your email setup, you may receive notifications intended for another user. +Wenn Du glaubst, dass Du Benachrichtigungen erhältst, die nicht zu Dir gehören, überprüfe die Header für `X-GitHub-Recipient` (Empfänger) und `X-GitHub-Recipient-Address` (Empfänger-Adresse). Diese Header zeigen an, wer der beabsichtigte Empfänger ist. Abhängig von Deiner E-Mail-Einrichtung erhältst Du möglicherweise Benachrichtigungen für einen anderen Benutzer. -Email notifications from {% data variables.product.product_name %} contain the following header information: +E-Mail-Benachrichtigungen von {% data variables.product.product_name %} enthalten die folgenden Headerinformationen: -| Header | Information | -| --- | --- | -| `From` address | This address will always be {% if currentVersion == "free-pro-team@latest" %}'`notifications@github.com`'{% else %}'the no-reply email address configured by your site administrator'{% endif %}. | -| `To` field | This field connects directly to the thread. If you reply to the email, you'll add a new comment to the conversation. | -| `Cc` address | {% data variables.product.product_name %} will `Cc` you if you're subscribed to a conversation. The second `Cc` email address matches the notification reason. The suffix for these notification reasons is {% data variables.notifications.cc_address %}. The possible notification reasons are:
    • `assign`: You were assigned to an issue or pull request.
    • `author`: You created an issue or pull request.
    • `comment`: You commented on an issue or pull request.
    • `manual`: There was an update to an issue or pull request you manually subscribed to.
    • `mention`: You were mentioned on an issue or pull request.
    • `push`: Someone committed to a pull request you're subscribed to.
    • `review_requested`: You or a team you're a member of was requested to review a pull request.
    • `security_alert`: {% data variables.product.prodname_dotcom %} detected a vulnerability in a repository you receive alerts for.
    • `state_change`: An issue or pull request you're subscribed to was either closed or opened.
    • `subscribed`: There was an update in a repository you're watching.
    • `team_mention`: A team you belong to was mentioned on an issue or pull request.
    • `your_activity`: You opened, commented on, or closed an issue or pull request.
    | -| `mailing list` field | This field identifies the name of the repository and its owner. The format of this address is always `..{% data variables.command_line.backticks %}`. |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" % %} -| `X-GitHub-Severity` field | {% data reusables.repositories.security-alerts-x-github-severity %} The possible severity levels are:
    • `low`
    • `moderate`
    • `high`
    • `critical`
    For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." |{% endif %} +| Header | Informationen | +| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `From`-Adresse | This address will always be {% if currentVersion == "free-pro-team@latest" %}'`notifications@github.com`'{% else %}'the no-reply email address configured by your site administrator'{% endif %}. | +| `To`-Feld | Dieses Feld ist direkt mit dem Thread verknüpft. Wenn Du auf die E-Mail antwortest, fügst Du der Unterhaltung einen neuen Kommentar hinzu. | +| `Cc`-Adresse | {% data variables.product.product_name %} fügt Sie zu `Cc` hinzu, wenn Sie eine Unterhaltung abonniert haben. Die zweite E-Mail-Adresse in `Cc` entspricht dem Benachrichtigungsgrund. Das Suffix für diese Benachrichtigungsgründe lautet {% data variables.notifications.cc_address %}. Zu den möglichen Benachrichtigungsgründen gehören folgende:
    • `assign`: Dir wurde ein Issue oder Pull Request zugewiesen.
    • `author`: Du hast einen Issue oder Pull Request erstellt.
    • `comment`: Du hast einen Issue oder Pull Request kommentiert.
    • `manual`: Ein Issue oder Pull Request, den Du manuell abonniert hast, wurde aktualisiert.
    • `mention`: Du wurdest in einem Issue oder Pull Request erwähnt.
    • `push`: Jemand hat einen Commit für einen Pull Request erstellt, den Du abonniert hast.
    • `review_requested`: Du oder ein Team, dem Du angehörst, wurdest/wurde gebeten, einen Review für einen Pull Request durchzuführen.
    • `security_alert`: {% data variables.product.prodname_dotcom %} hat eine Schwachstelle in einem Repository erkannt, für das Du Sicherheitswarnungen erhältst.
    • `state_change`: Ein Issue oder Pull Request, den Du abonniert hast, wurde entweder geschlossen oder geöffnet.
    • `subscribed`: Es gab eine Aktualisierung in einem Repository, das Du beobachtest.
    • `team_mention`: Ein Team, dem Du angehörst, wurde in einem Issue oder Pull Request erwähnt.
    • `your_activity`: Du hast einen Issue oder Pull Request geöffnet, kommentiert oder geschlossen.
    | +| `mailing list`-Feld | In diesem Feld werden der Name des Repositorys und sein Inhaber identifiziert. Das Format dieser Adresse lautet immer `..{% data variables.command_line.backticks %}`. |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" % %} +| `X-GitHub-Severity`-Feld | {% data reusables.repositories.security-alerts-x-github-severity %} Die möglichen Schweregrade sind:
    • `low`
    • `moderate`
    • `high`
    • `critical`
    For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." | |{% endif %} -### Choosing your notification settings +### Wähle Deine Benachrichtigungseinstellungen {% data reusables.notifications.access_notifications %} {% data reusables.notifications-v2.manage-notifications %} -3. On the notifications settings page, choose how you receive notifications when: - - There are updates in repositories or team discussions you're watching or in a conversation you're participating in. For more information, see "[About participating and watching notifications](#about-participating-and-watching-notifications)." - - You gain access to a new repository or you've joined a new team. For more information, see "[Automatic watching](#automatic-watching)."{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} - - There are new {% data variables.product.prodname_dependabot_alerts %} in your repository. For more information, see "[{% data variables.product.prodname_dependabot_alerts %} options](#github-dependabot-alerts-options)." {% endif %}{% if currentVersion == "enterprise-server@2.21" %} - - There are new security alerts in your repository. For more information, see "[Security alert options](#security-alert-options)." {% endif %} {% if currentVersion == "free-pro-team@latest" %} - - There are workflow runs updates on repositories set up with {% data variables.product.prodname_actions %}. For more information, see "[{% data variables.product.prodname_actions %} notification options](#github-actions-notification-options)."{% endif %} +3. Auf der Seite für Benachrichtigungseinstellungen wählst Du, wie Du Benachrichtigungen erhalten willst, wenn: + - Es Aktualisierungen in Repositories oder Teamdiskussionen gibt, die Du beobachtest, oder in einer Unterhaltung, an der Du teilnimmst. Weitere Informationen findest Du unter „[Über die Teilnahme an und das Beobachten von Benachrichtigungen](#about-participating-and-watching-notifications)." + - Du Zugriff erhältst auf ein neues Repository oder wenn Du einem neuen Team beigetreten bist. For more information, see "[Automatic watching](#automatic-watching)."{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} + - There are new {% if page.version == 'dotcom' %} {% data variables.product.prodname_dependabot_alerts %} {% else %} security alerts {% endif %} in your repository. Weitere Informationen findest Du unter „[{% data variables.product.prodname_dependabot_alerts %} Benachrichtigungsoptionen](#github-dependabot-alerts-notification-options)." {% endif %}{% if currentVersion == "enterprise-server@2.21" %} + - Es neue Sicherheitswarnungen in Deinem Repository gibt. For more information, see "[Security alert notification options](#security-alert-notification-options)." {% endif %} {% if currentVersion == "free-pro-team@latest" %} + - Es Aktualisierungen zu Workflow-Ausführungen auf Repositorys gibt, die mit {% data variables.product.prodname_actions %} aufgesetzt wurden. For more information, see "[{% data variables.product.prodname_actions %} notification options](#github-actions-notification-options)."{% endif %} -### Automatic watching +### Automatisches Beobachten -By default, anytime you gain access to a new repository, you will automatically begin watching that repository. Anytime you join a new team, you will automatically be subscribed to updates and receive notifications when that team is @mentioned. If you don't want to automatically be subscribed, you can unselect the automatic watching options. +Standardmäßig wirst Du jedes Mal, wenn Du Zugriff auf ein neues Repository erhältst, automatisch mit der Beobachtung dieses Repository beginnen. Jedes mal, wenn Du einem neuen Team beitrittst, abonnierst Du automatisch Aktualisierungen und erhältst Benachrichtigungen, wenn dieses Team @erwähnt ist. Wenn Du keine automatischen Abonnements möchtest, kannst Du die automatischen Beobachtungsoptionen deaktivieren. - ![Automatic watching options](/assets/images/help/notifications-v2/automatic-watching-options.png) + ![Optionen für automatisches Beobachten](/assets/images/help/notifications-v2/automatic-watching-options.png) -If "Automatically watch repositories" is disabled, then you will not automatically watch your own repositories. You must navigate to your repository page and choose the watch option. +Wenn "Automatisch Repositories beobachten" deaktiviert ist, wirst Du auch nicht automatisch Deine eigenen Repositorys beobachten. Du musst dann zu Deiner Repository-Seite navigieren und die Beobachtungsoption wählen. -### Choosing where your organization’s email notifications are sent +### Wähle, wohin die E-Mail-Benachrichtigungen Deiner Organisation gesendet werden -If you belong to an organization, you can choose the email account you want notifications for organization activity sent to. For example, if you belong to an organization for work, you may want your notifications sent to your work email address, rather than your personal address. +Wenn Sie einer Organisation angehören, können Sie das E-Mail-Konto auswählen, an das die Benachrichtigungen für Aktivitäten in der Organisation gesendet werden sollen. Wenn Sie z. B. einer Organisation für die Arbeit angehören, könnten Sie sich die Benachrichtigungen an Ihre berufliche E-Mail-Adresse senden lassen statt an Ihre private. {% data reusables.notifications-v2.email-notification-caveats %} {% data reusables.notifications.access_notifications %} {% data reusables.notifications-v2.manage-notifications %} -3. Under "Default notification email", select the email address you'd like notifications sent to. -![Default notification email address drop-down](/assets/images/help/notifications/notifications_primary_email_for_orgs.png) -4. Click **Save**. +3. Wählen Sie unter „Default notification email“ (Standardmäßige Benachrichtigungs-E-Mail-Adresse) die E-Mail-Adresse aus, an die Benachrichtigungen gesendet werden sollen. + ![Dropdownmenü mit standardmäßigen Benachrichtigungs-E-Mail-Adressen](/assets/images/help/notifications/notifications_primary_email_for_orgs.png) +4. Klicke auf **Save** (Speichern). -#### Customizing email routes per organization +#### E-Mail-Routen pro Organisation anpassen -If you are a member of more than one organization, you can configure each one to send notifications to any of{% if currentVersion == "free-pro-team@latest" %} your verified email addresses{% else %} the email addressed you've added to your {% data variables.product.product_name %} account{% endif %}. {% if currentVersion == "free-pro-team@latest" %} For more information, see "[Verifying your email address](/articles/verifying-your-email-address)."{% endif %} +If you are a member of more than one organization, you can configure each one to send notifications to any of{% if currentVersion == "free-pro-team@latest" %} your verified email addresses{% else %} the email addressed you've added to your {% data variables.product.product_name %} account{% endif %}. {% if currentVersion == "free-pro-team@latest" %} For more information, see "[Verifying your email address](/articles/verifying-your-email-address)."{% endif %} {% data reusables.notifications.access_notifications %} {% data reusables.notifications-v2.manage-notifications %} -3. Under "Custom routing," find your organization's name in the list. -![List of organizations and email addresses](/assets/images/help/notifications/notifications_org_emails.png) -4. Click **Edit** next to the email address you want to change. -![Editing an organization's email addresses](/assets/images/help/notifications/notifications_edit_org_emails.png) -5. Select one of your verified email addresses, then click **Save**. -![Switching your per-org email address](/assets/images/help/notifications/notifications_switching_org_email.gif) +3. Suchen Sie in der Liste unter „Custom routing“ (Benutzerdefiniertes Routing) den Namen Ihrer Organisation. + ![Liste der Organisationen und E-Mail-Adressen](/assets/images/help/notifications/notifications_org_emails.png) +4. Klicke neben der E-Mail-Adresse, die Du ändern möchtest, auf **Edit** (Bearbeiten). ![E-Mail-Adressen einer Organisation bearbeiten](/assets/images/help/notifications/notifications_edit_org_emails.png) +5. Wähle eine Deiner verifizierten E-Mail-Adressen aus, und klicke dann auf **Save** (Speichern). + ![Eigene E-Mail-Adressen pro Organisation ändern](/assets/images/help/notifications/notifications_switching_org_email.gif) {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -### {% data variables.product.prodname_dependabot_alerts %} options +### {% data variables.product.prodname_dependabot_alerts %} Benachrichtigungsoptionen {% else %} -### Security alert options +### Security alert notification options {% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}Choose how you want to receive {% data variables.product.prodname_dependabot_alerts %} for repositories that you are watching. You can receive {% data variables.product.prodname_dependabot_alerts %} in your inbox, as a banner on {% data variables.product.product_name %}, on the command line, through email, or some combination of these options. +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}Choose how you want to receive {% data variables.product.prodname_dependabot_alerts %} for repositories that you are watching. You can receive {% if page.version == 'dotcom' %} {% data variables.product.prodname_dependabot_alerts %} {% else %} security alerts {% endif %} in your inbox, as a banner on {% data variables.product.product_name %}, on the command line, through email, or some combination of these options. -If you want to receive {% data variables.product.prodname_dependabot_alerts %} by email, choose whether you want a weekly email summary of vulnerabilities for up 10 repositories or a new email each time a vulnerability is detected. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)."{% endif %} +If you want to receive {% data variables.product.prodname_dependabot_alerts %} by email, choose whether you want a weekly email summary of vulnerabilities for up 10 repositories or a new email each time a vulnerability is detected. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." |{% endif %} -{% if currentVersion == "enterprise-server@2.21" %}Choose how you want to receive security alerts for repositories that you are watching. You can receive security alerts in your inbox, as a banner on {% data variables.product.product_name %}, on the command line, through email, or some combination of these options. +{% if currentVersion == "enterprise-server@2.21" %}Choose how you want to receive security alerts for repositories that you are watching. Du kannst Sicherheitswarnungen in Deinem Posteingang erhalten, als Banner auf {% data variables.product.product_name %}, auf der Befehlszeile, per E-Mail oder eine beliebige Kombination dieser Optionen. -If you want to receive security alerts by email, choose whether you want a weekly email summary of vulnerabilities for up 10 repositories or a new email each time a vulnerability is detected. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)."{% endif %} +Wenn Du Sicherheitswarnungen per E-Mail erhalten möchtest, wähle, ob Du eine wöchentliche E-Mail-Zusammenfassung von Verwundbarkeiten für bis zu 10 Repositories erhalten möchtest, oder eine neue E-Mail jedes Mal, wenn eine Verwundbarkeit entdeckt wird. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." |{% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} ![{% data variables.product.prodname_dependabot_short %} alerts options](/assets/images/help/notifications-v2/dependabot-alerts-options.png) {% else %} - ![Security alerts options](/assets/images/help/notifications-v2/security-alerts-options.png) + ![Optionen für Sicherheitswarnungen](/assets/images/help/notifications-v2/security-alerts-options.png) {% endif %} +{% note %} + +**Note:** You can filter your {% data variables.product.company_short %} inbox notifications by {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %} security{% endif %} alerts. Weitere Informationen findest Du unter „[Benachrichtigungen über Deinen Posteingang verwalten](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox#supported-queries-for-custom-filters)." + +{% endnote %} + {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -### {% data variables.product.prodname_actions %} notification options +### {% data variables.product.prodname_actions %} Benachrichtigungsoptionen -Choose how you want to receive workflow run updates for repositories that you are watching that are set up with {% data variables.product.prodname_actions %}. You can also choose to only receive notifications for failed workflow runs. +Wähle, wie Du Aktualisierungen für Workflow-Ausführungen erhalten willst für Repositorys, die Du beobachtest und die mit {% data variables.product.prodname_actions %} aufgesetzt sind. Du kannst auch wählen, nur Benachrichtigungen für fehlgeschlagene Workflow-Ausführungen zu erhalten. - ![Notification options for {% data variables.product.prodname_actions %}](/assets/images/help/notifications-v2/github-actions-notification-options.png) + ![Notification options for GitHub Actions](/assets/images/help/notifications-v2/github-actions-notification-options.png) {% endif %} {% if currentVersion == "free-pro-team@latest" %} -### Enabling push notifications with {% data variables.product.prodname_mobile %} +### Push-Benachrichtigungen mit {% data variables.product.prodname_mobile %} aktivieren -When you install {% data variables.product.prodname_mobile %}, you will automatically be opted into web notifications. You can then enable push notifications for direct mentions within the app. +Wenn Du {% data variables.product.prodname_mobile %} installierst, bist Du automatisch für Web-Benachrichtigungen abonniert. Du kannst dann Push-Benachrichtigungen aktivieren für direkte Erwähnungen innerhalb der App. -You can only receive notifications for pushes to repositories on {% data variables.product.prodname_mobile %} at this time. +Du kannst im Moment nur Benachrichtigungen für Pushes an Repositorys auf {% data variables.product.prodname_mobile %} erhalten. -#### Enabling push notifications with {% data variables.product.prodname_ios %} +#### Push-Benachrichtigungen mit {% data variables.product.prodname_ios %} aktivieren -1. Above "Home", tap your profile photo. -2. To view your settings, tap {% octicon "gear" aria-label="The Gear icon" %}. - ![Settings icon for GitHub for iOS](/assets/images/help/mobile/ios-settings-icon.png) -3. To update your notification settings, tap **Push notifications**. -4. To turn on push notifications for direct mentions, use the **Direct Mentions** toggle. +1. Oberhalb von „Home", tippe auf Dein Profilfoto. +2. Um deine Einstellungen zu sehen, tippe auf {% octicon "gear" aria-label="The Gear icon" %}. ![Einstellungssymbol für GitHub for iOS](/assets/images/help/mobile/ios-settings-icon.png) +3. Um Deine Benachrichtigungseinstellungen anzupassen, tippe auf **Push notifications** (Push-Benachrichtigungen). +4. Um Push-Benachrichtigungen für direkte Erwähnungen einzuschalten, verwende den Schalter **Direct Mentions** (Direkte Erwähnung). -#### Enabling push notifications with {% data variables.product.prodname_android %} +#### Push-Benachrichtigungen mit {% data variables.product.prodname_android %} aktivieren -1. Above "Home", tap your profile photo. -2. To view your settings, tap {% octicon "gear" aria-label="The Gear icon" %}. - ![Settings icon for GitHub for Android](/assets/images/help/mobile/android-settings-icon.png) -3. To turn on push notifications for direct mentions, use the **Direct mentions** toggle. +1. Oberhalb von „Home", tippe auf Dein Profilfoto. +2. Um deine Einstellungen zu sehen, tippe auf {% octicon "gear" aria-label="The Gear icon" %}. ![Einstellungssymbol für GitHub for Android](/assets/images/help/mobile/android-settings-icon.png) +3. Um Push-Benachrichtigungen für direkte Erwähnungen einzuschalten, verwende den Schalter **Direct mentions** (Direkte Erwähnung). {% endif %} diff --git a/translations/de-DE/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md b/translations/de-DE/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md index 4adfa24afb11..80387984b51f 100644 --- a/translations/de-DE/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md +++ b/translations/de-DE/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md @@ -19,7 +19,6 @@ Um auf Deinen Posteingang für Benachrichtigungen zuzugreifen, klicke in der rec ![Benachrichtigung, die auf eine ungelesene Mitteilung hinweist](/assets/images/help/notifications/notifications_general_existence_indicator.png) - Dein Posteingang zeigt alle Benachrichtigungen, die Du nicht abgemeldet oder als **Done** (Erledigt) markiert hast. Du kannst Deinen Posteingang so anpassen, dass er Deinem Workflow am besten entspricht, indem Du Filter verwendest, alle oder nur ungelesene Benachrichtigungen anzeigst und Deine Benachrichtigungen gruppierst, um eine schnelle Übersicht zu erhalten. ![Posteingangsansicht](/assets/images/help/notifications-v2/inbox-view.png) @@ -113,7 +112,7 @@ Um Benachrichtigungen nach dem Grund zu filtern, weshalb Du eine Aktualisierung #### Unterstützte `is:`-Abfragen -Um Benachrichtigungen nach bestimmten Aktivitäten auf {% data variables.product.product_name %} zu filtern, kannst du die Abfrage `is` verwenden. Um beispielsweise nur Aktualisierungen zu Repository-Einladungen zu sehen, benutze die Abfrage `is:repository-invitation`. +Um Benachrichtigungen nach bestimmten Aktivitäten auf {% data variables.product.product_name %} zu filtern, kannst du die Abfrage `is` verwenden. For example, to only see repository invitation updates, use `is:repository-invitation`, and to only see {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %} security{% endif %} alerts, use `is:repository-vulnerability-alert`. - `is:check-suite` - `is:commit` diff --git a/translations/de-DE/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md b/translations/de-DE/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md index 04656c0a9baa..915e8b2a2a85 100644 --- a/translations/de-DE/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md +++ b/translations/de-DE/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md @@ -10,7 +10,7 @@ Um Dir zu helfen, Deine Abonnements zu verstehen und zu entscheiden, ob du Dich {% note %} -**Hinweis:** Anstatt Dich abzumelden, hast Du die Möglichkeit, ein Repository zu ignorieren. Wenn Du ein Repository ignorierst, erhältst du keine Benachrichtigungen. Es wird nicht empfohlen, Repositorys zu ignorieren, da Du in diesem Fall auch keine Benachrichtigung erhältst, wenn Du @erwähnt wirst. {% if currentVersion == "free-pro-team@latest" %}Wenn du Missbrauch feststellst und ein Repository ignorieren willst, [kontaktiere bitte den Support](/contact), damit wir Dir helfen können. {% data reusables.policies.abuse %}{% endif %} +**Hinweis:** Anstatt Dich abzumelden, hast Du die Möglichkeit, ein Repository zu ignorieren. Wenn Du ein Repository ignorierst, erhältst du keine Benachrichtigungen. Es wird nicht empfohlen, Repositorys zu ignorieren, da Du in diesem Fall auch keine Benachrichtigung erhältst, wenn Du @erwähnt wirst. {% if currentVersion == "free-pro-team@latest" %}If you're experiencing abuse and want to ignore a repository, please [contact support](/contact) so we can help. {% data reusables.policies.abuse %}{% endif %} {% endnote %} diff --git a/translations/de-DE/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md b/translations/de-DE/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md index bf7e101f7d5f..7a443968211c 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -Abfrageparameter sind optionale Bestandteile einer URL, die Du anpassen kannst, um eine bestimmte Ansicht einer Webseite freizugeben, beispielsweise Suchfilterergebnisse oder eine Issue-Vorlage auf {% data variables.product.prodname_dotcom %}. Um eigene Abfrageparameter zu erstellen, musst Du Schlüssel- und Wertepaar abgleichen. +Abfrageparameter sind optionale Bestandteile einer URL, die Sie anpassen können, um eine bestimmte Ansicht einer Webseite freizugeben, beispielsweise Suchfilterergebnisse oder eine Issue-Vorlage auf {% data variables.product.prodname_dotcom %}. Um eigene Abfrageparameter zu erstellen, musst Du Schlüssel- und Wertepaar abgleichen. {% tip %} @@ -22,15 +22,15 @@ Wenn Du eine ungültige URL mithilfe von Suchparametern erstellst oder wenn Du n ### Unterstützte Abfrageparameter -| Abfrageparameter | Beispiel | -| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `Text` | `https://github.com/octo-org/octo-repo/compare/master...pull-request-test?quick_pull=1&body=Fixes+the+problem.` erstellt einen Pull Request zum Vergleich der Branches `master` und `pull-request-test` mit dem Kommentar „Fixes the problem“ (Behebt das Problem) im Text des Pull Requests. | -| `title` | `https://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report` erstellt einen Issue mit der Kennzeichnung „bug“ (Fehler) und dem Titel „New bug report“ (Neuer Fehlerbericht). | -| `labels` | `https://github.com/octo-org/octo-repo/compare/master...pull-request-test?quick_pull=1&labels=bug` erstellt einen Pull Request zum Vergleich der Branches `master` und `pull-request-test` mit der Kennzeichnung „bug“ (Fehler). | -| `Vorlage` | `https://github.com/octo-org/octo-repo/issues/new?template=issue_template.md` erstellt einen Issue mit einer Vorlage im Issue-Text. | -| `Meilensteine` | `https://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones` erstellt einen Issue mit dem Meilenstein „testing milestones“ (Meilensteine testen). | -| `assignees` | `https://github.com/octo-org/octo-repo/issues/new?assignees=octocat` erstellt einen Issue und weist ihn @octocat zu. | -| `projects` | `https://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1` erstellt einen Issue mit dem Titel „Bug fix“ (Fehlerbehebung) und fügt ihn dem Projektboard 1 der Organisation hinzu. | +| Abfrageparameter | Beispiel | +| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `Text` | `https://github.com/octo-org/octo-repo/compare/main...pull-request-test?quick_pull=1&body=Fixes+the+problem.` creates a pull request, comparing the branches `main` and `pull-request-test`, with the comment "Fixes the problem" in the pull request body. | +| `title` | `https://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report` erstellt einen Issue mit der Kennzeichnung „bug“ (Fehler) und dem Titel „New bug report“ (Neuer Fehlerbericht). | +| `labels` | `https://github.com/octo-org/octo-repo/compare/main...pull-request-test?quick_pull=1&labels=bug` creates a pull request, comparing the branches `main` and `pull-request-test`, with the label "bug." | +| `Vorlage` | `https://github.com/octo-org/octo-repo/issues/new?template=issue_template.md` erstellt einen Issue mit einer Vorlage im Issue-Text. | +| `Meilensteine` | `https://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones` erstellt einen Issue mit dem Meilenstein „testing milestones“ (Meilensteine testen). | +| `assignees` | `https://github.com/octo-org/octo-repo/issues/new?assignees=octocat` erstellt einen Issue und weist ihn @octocat zu. | +| `projects` | `https://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1` erstellt einen Issue mit dem Titel „Bug fix“ (Fehlerbehebung) und fügt ihn dem Projektboard 1 der Organisation hinzu. | ### Issues und Pull Requests mit benutzerdefinierten Vorlagen ausfüllen diff --git a/translations/de-DE/content/github/managing-your-work-on-github/about-automation-for-project-boards.md b/translations/de-DE/content/github/managing-your-work-on-github/about-automation-for-project-boards.md index 5344b133ffb2..44c2e02b1914 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/about-automation-for-project-boards.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/about-automation-for-project-boards.md @@ -1,6 +1,6 @@ --- title: Informationen zur Automatisierung für Projektboards -intro: 'Du kannst automatische Workflows konfigurieren, um zu gewährleisten, dass der Status der Projektboard-Tickets mit den zugehörigen Issues und Pull Requests synchronisiert wird.' +intro: Du kannst automatische Workflows konfigurieren, um zu gewährleisten, dass der Status der Projektboard-Tickets mit den zugehörigen Issues und Pull Requests synchronisiert wird. redirect_from: - /articles/about-automation-for-project-boards versions: @@ -32,5 +32,5 @@ Durch die Automatisierung von Projektboards können Teams auch ein gemeinsames V Die Automatisierung des Projektboards ermöglicht standardmäßig die Verfolgung des Fortschritts. Tickets in Spalten mit den Voreinstellungen „Zu Bearbeiten“, „In Bearbeitung“ oder „Abgeschlossen“ zählen zum Gesamtprojektfortschritt. {% data reusables.project-management.project-progress-locations %} ### Weiterführende Informationen -- „[Automatisierung für Projektboards konfigurieren](/articles/configuring-automation-for-project-boards)“{% if currentVersion == "free-pro-team@latest" %} +- "[Configuring automation for project boards](/articles/configuring-automation-for-project-boards)"{% if currentVersion == "free-pro-team@latest" %} - „[Ein Projektboard kopieren](/articles/copying-a-project-board)“{% endif %} diff --git a/translations/de-DE/content/github/managing-your-work-on-github/about-duplicate-issues-and-pull-requests.md b/translations/de-DE/content/github/managing-your-work-on-github/about-duplicate-issues-and-pull-requests.md index 77645d869e6c..45dbd2628413 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/about-duplicate-issues-and-pull-requests.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/about-duplicate-issues-and-pull-requests.md @@ -1,6 +1,6 @@ --- title: Informationen zu Duplikaten von Issues und Pull Requests -intro: 'Markiere einen Issue oder Pull Request als Duplikat, um ähnliche Issues oder Pull Requests gleichzeitig zu verfolgen und unnötige Belastungen sowohl für Betreuer als auch für Mitarbeiter zu vermeiden.' +intro: Markiere einen Issue oder Pull Request als Duplikat, um ähnliche Issues oder Pull Requests gleichzeitig zu verfolgen und unnötige Belastungen sowohl für Betreuer als auch für Mitarbeiter zu vermeiden. redirect_from: - /articles/about-duplicate-issues-and-pull-requests versions: diff --git a/translations/de-DE/content/github/managing-your-work-on-github/about-issues.md b/translations/de-DE/content/github/managing-your-work-on-github/about-issues.md index 1cbef93418f8..a4280527f8f8 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/about-issues.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/about-issues.md @@ -1,9 +1,9 @@ --- title: Informationen zu Issues -intro: 'Verwende Issues, um Ideen, Verbesserungen, Aufgaben oder Fehler für die Arbeit auf {% data variables.product.product_name %} zu verfolgen.' +intro: 'Verwenden Sie Issues, um Ideen, Verbesserungen, Aufgaben oder Fehler für die Arbeit auf {% data variables.product.product_name %} zu verfolgen.' redirect_from: - /articles/creating-issues/ - - /articles/about-issues + - /articles/about-issues/ versions: free-pro-team: '*' enterprise-server: '*' @@ -13,7 +13,7 @@ Du kannst Feedback von Benutzern sammeln, Softwarefehler melden und Aufgaben org {% data reusables.pull_requests.close-issues-using-keywords %} -Um über die neuesten Kommentare in einem Issue auf dem Laufenden zu bleiben, kannst Du einen Issue beobachten, um Benachrichtigungen über neue Kommentare zu erhalten. Weitere Informationen findest Du unter {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}„[Über Benachrichtigungen](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}„[Über Benachrichtigungen](/github/receiving-notifications-about-activity-on-github/about-notifications){% endif %}." +Um über die neuesten Kommentare in einem Issue auf dem Laufenden zu bleiben, kannst Du einen Issue beobachten, um Benachrichtigungen über neue Kommentare zu erhalten. 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 %}." Um schnell Links zu kürzlich aktualisierten Issues zu finden, besuche Dein Dashboard. Weitere Informationen findest Du unter „[Informationen zum persönlichen Dashboard](/articles/about-your-personal-dashboard).“ @@ -22,10 +22,10 @@ Um schnell Links zu kürzlich aktualisierten Issues zu finden, besuche Dein Dash Issues ermöglichen Dir Folgendes: - Verfolge und priorisiere Deine Arbeit mithilfe von Projektboards. Weitere Informationen findest Du unter „[Projektboards verwenden](/articles/about-project-boards).“ - Erstelle neue Issues, um Feedback aus einem Kommentar in einem Issue-oder Pull-Request-Review zu verfolgen, das außerhalb des Anwendungsbereichs liegt. Weitere Informationen findest Du unter „[Öffnen eines Issue aus einem Kommentar](/github/managing-your-work-on-github/opening-an-issue-from-a-comment)." -- Erstelle Issue-Vorlagen, um Mitarbeitern zu helfen, aussagekräftige Issues zu erstellen. Weitere Informationen findest Du unter „[Informationen zu Vorlagen für Issues und Pull Requests](/articles/about-issue-and-pull-request-templates)“.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -- Übertrage offene Issues in andere Repositorys. Weitere Informationen findest Du unter „[Issue in ein anderes Repository übertragen](/articles/transferring-an-issue-to-another-repository),“{% endif %} +- Erstelle Issue-Vorlagen, um Mitarbeitern zu helfen, aussagekräftige Issues zu erstellen. Weitere Informationen findest Du unter „[Informationen zu Vorlagen für Issues und Pull Requests](/articles/about-issue-and-pull-request-templates)“ +- Übertrage offene Issues in andere Repositorys. Weitere Informationen finden Sie unter „[Einen Issue in ein anderes Repository übertragen](/articles/transferring-an-issue-to-another-repository)“. - Hefte wichtige Issues an, um sie leichter auffindbar zu machen, doppelte Issues zu vermeiden und Störungen zu unterdrücken. Weitere Informationen findest Du unter „[Einen Issue an Dein Repository anheften](/articles/pinning-an-issue-to-your-repository).“ -- Verfolge doppelte Issues anhand gespeicherter Antworten. Weitere Informationen finden Sie unter „[Informationen zu gespeicherten Antworten](/articles/about-saved-replies)“.{% if currentVersion == "free-pro-team@latest" %} -- Melde Kommentare, die gegen die [Community-Richtlinien](/articles/github-community-guidelines) von {% data variables.product.prodname_dotcom %} verstoßen. Weitere Informationen findest Du unter „[Missbrauch oder Spam melden](/articles/reporting-abuse-or-spam)“.{% endif %} +- Verfolge doppelte Issues anhand gespeicherter Antworten. For more information, see "[About saved replies](/articles/about-saved-replies)."{% if currentVersion == "free-pro-team@latest" %} +- Melden Sie Kommentare, die gegen die [Community-Richtlinien](/articles/github-community-guidelines) von {% data variables.product.prodname_dotcom %} verstoßen. Weitere Informationen findest Du unter „[Missbrauch oder Spam melden](/articles/reporting-abuse-or-spam)“.{% endif %} Issues können außerdem [anderen Benutzern zugewiesen](/articles/assigning-issues-and-pull-requests-to-other-github-users), [mit Kennzeichnungen für eine schnellere Suche versehen](/articles/applying-labels-to-issues-and-pull-requests) und [mit Meilensteinen gruppiert](/articles/creating-and-editing-milestones-for-issues-and-pull-requests) werden. diff --git a/translations/de-DE/content/github/managing-your-work-on-github/about-labels.md b/translations/de-DE/content/github/managing-your-work-on-github/about-labels.md index d10470651c82..ae3e1ea5a3a9 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/about-labels.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/about-labels.md @@ -1,6 +1,6 @@ --- title: Informationen zu Kennzeichnungen -intro: 'Kennzeichnungen auf {% data variables.product.product_name %} helfen Dir, Deine Arbeit zu organisieren und zu priorisieren. Du kannst Kennzeichnungen auf Issues und Pull Requests anwenden, um Priorität, Kategorie oder andere Informationen zu kennzeichnen, die Du für nützlich hältst.' +intro: 'Mit Kennzeichnungen auf {% data variables.product.product_name %} können Sie Ihre Arbeit organisieren und priorisieren. Du kannst Kennzeichnungen auf Issues und Pull Requests anwenden, um Priorität, Kategorie oder andere Informationen zu kennzeichnen, die Du für nützlich hältst.' redirect_from: - /articles/about-labels versions: @@ -16,17 +16,17 @@ Alle Benutzer mit Lesezugriff auf ein Repository können die Kennzeichnungen des {% data variables.product.product_name %} bietet in jedem neuen Repository Standardkennzeichnungen. Mithilfe dieser Standardkennzeichnungen kannst Du einen Standardworkflow in einem Repository erstellen: -| Kennzeichnung | Beschreibung | -| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------ | -| `bug` | Kennzeichnet ein unerwartetes Problem oder unbeabsichtigtes Verhalten{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| `documentation` | Kennzeichnet die Notwendigkeit für Verbesserungen oder Ergänzungen der Dokumentation{% endif %} -| `duplicate` | Kennzeichnet ähnliche Issues oder Pull Requests | -| `enhancement` | Kennzeichnet neue Funktionsanfragen | -| `good first issue` | Kennzeichnet einen geeigneten Issue für erstmalig Mitwirkende | -| `help wanted` | Kennzeichnet, dass ein Betreuer Hilfe bei einem Issue oder Pull Request benötigt | -| `invalid` | Kennzeichnet, dass ein Issue oder Pull Request nicht mehr relevant ist | -| `question` | Kennzeichnet, dass ein Issue oder Pull Request weitere Informationen benötigt | -| `wontfix` | Kennzeichnet, dass die Arbeit an einem Issue oder Pull Request nicht fortgesetzt wird | +| Kennzeichnung | Beschreibung | +| ------------------ | ------------------------------------------------------------------------------------- | +| `bug` | Indicates an unexpected problem or unintended behavior | +| `documentation` | Indicates a need for improvements or additions to documentation | +| `duplicate` | Kennzeichnet ähnliche Issues oder Pull Requests | +| `enhancement` | Kennzeichnet neue Funktionsanfragen | +| `good first issue` | Kennzeichnet einen geeigneten Issue für erstmalig Mitwirkende | +| `help wanted` | Kennzeichnet, dass ein Betreuer Hilfe bei einem Issue oder Pull Request benötigt | +| `invalid` | Kennzeichnet, dass ein Issue oder Pull Request nicht mehr relevant ist | +| `question` | Kennzeichnet, dass ein Issue oder Pull Request weitere Informationen benötigt | +| `wontfix` | Kennzeichnet, dass die Arbeit an einem Issue oder Pull Request nicht fortgesetzt wird | Standardkennzeichnungen sind in jedem neuen Repository beinhaltet, wenn das Repository erstellt wird, aber Du kannst die Kennzeichnungen später bearbeiten oder löschen. Weitere Informationen findest Du unter „[Eine Kennzeichnung löschen](/articles/deleting-a-label/).“ diff --git a/translations/de-DE/content/github/managing-your-work-on-github/about-project-boards.md b/translations/de-DE/content/github/managing-your-work-on-github/about-project-boards.md index edc2dcb7b12b..0a7d774ad627 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/about-project-boards.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/about-project-boards.md @@ -1,6 +1,6 @@ --- title: Informationen zu Projektboards -intro: 'Mit Projektboards auf {% data variables.product.product_name %} kannst Du Deine Arbeit organisieren und priorisieren. Du kannst Projektboards für die Arbeit an bestimmten Funktionen, für umfassende Roadmaps oder sogar für Checklisten für Releases erstellen. Projektboards bieten Dir die Flexibilität, individuelle Workflows nach Deinen Bedürfnissen zu erstellen.' +intro: 'Mit Projektboards auf {% data variables.product.product_name %} können Sie Ihre Arbeit organisieren und priorisieren. Du kannst Projektboards für die Arbeit an bestimmten Funktionen, für umfassende Roadmaps oder sogar für Checklisten für Releases erstellen. Projektboards bieten Dir die Flexibilität, individuelle Workflows nach Deinen Bedürfnissen zu erstellen.' redirect_from: - /articles/about-projects/ - /articles/about-project-boards @@ -13,7 +13,7 @@ Projektboards bestehen aus Issues, Pull Requests und Hinweisen, die als Tickets Projektboard-Tickets enthalten relevante Metadaten für Issues und Pull Requests, wie Kennzeichnungen, Bearbeiter, Status und den öffnenden Benutzer. {% data reusables.project-management.edit-in-project %} -Du kannst außerdem Hinweise innerhalb von Spalten erstellen und als Erinnerungen an Aufgaben oder Verweise auf Issues und Pull Requests aus einem beliebigen Repository auf {% data variables.product.product_name %} verwenden. Über Hinweise kannst Du auch zugehörige Informationen zum Projektboard hinzufügen. Du kannst ein Referenzticket für ein anderes Projektboard erstellen, indem Du eine Verknüpfung zu einem Hinweis hinzufügst. Wenn der Hinweis für Deine Bedürfnisse nicht ausreicht, kannst Du ihn in einen Issue umwandeln. Weitere Informationen zur Konvertierung von Hinweisen im Projektboard in Issues findest Du unter „[Hinweise zu einem Projektboard hinzufügen](/articles/adding-notes-to-a-project-board).“ +Sie können außerdem Hinweise innerhalb von Spalten erstellen und als Erinnerungen an Aufgaben oder Verweise auf Issues und Pull Requests aus einem beliebigen Repository auf {% data variables.product.product_name %} verwenden. Über Hinweise können Sie auch zugehörige Informationen zum Projektboard hinzufügen. Du kannst ein Referenzticket für ein anderes Projektboard erstellen, indem Du eine Verknüpfung zu einem Hinweis hinzufügst. Wenn der Hinweis für Deine Bedürfnisse nicht ausreicht, kannst Du ihn in einen Issue umwandeln. Weitere Informationen zur Konvertierung von Hinweisen im Projektboard in Issues findest Du unter „[Hinweise zu einem Projektboard hinzufügen](/articles/adding-notes-to-a-project-board).“ Arten von Projektboards: @@ -59,7 +59,7 @@ Weitere Informationen zur Automatisierung von Projektboards findest Du unter „ ### Weiterführende Informationen - „[Ein Projektboard erstellen](/articles/creating-a-project-board)“ -- „[Ein Projektboard bearbeiten](/articles/editing-a-project-board)“{% if currentVersion == "free-pro-team@latest" %} +- "[Editing a project board](/articles/editing-a-project-board)"{% if currentVersion == "free-pro-team@latest" %} - „[Ein Projektboard kopieren](/articles/copying-a-project-board)“{% endif %} - „[Issues und Pull Requests zu einem Projektboard hinzufügen](/articles/adding-issues-and-pull-requests-to-a-project-board)“ - „[Projektboardberechtigungen für eine Organisation](/articles/project-board-permissions-for-an-organization)“ diff --git a/translations/de-DE/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md b/translations/de-DE/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md index 3cb36bdd852a..121ced4d22f7 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md @@ -54,15 +54,8 @@ In jeder Projektspalte können maximal 2.500 Tickets enthalten sein. Wenn die H 1. Klicke rechts neben einem Issue oder Pull Request auf **Projects {% octicon "gear" aria-label="The Gear icon" %}** (Projekte). ![Projektboard-Schaltfläche in Seitenleiste](/assets/images/help/projects/sidebar-project.png) 2. Klicke auf die Registerkarte **Recent** (Zuletzt verwendet), **Repository** (Repository),**User** (Benutzer) oder **Organization** (Organisation) für das Projektboard, zu dem Du etwas hinzufügen möchtest. ![Registerkarten „Recent“ (Zuletzt verwendet), „Repository“ (Repository) und „Organization“ (Organisation)](/assets/images/help/projects/sidebar-project-tabs.png) 3. Gib den Namen des Projekts in das Feld **Filter projects** (Projekte filtern) ein. ![Projektboard-Suchfeld](/assets/images/help/projects/sidebar-search-project.png) -4. Wähle mindestens ein Projektboard aus, das Du zum Issue oder Pull Request hinzufügen möchten. ![Ausgewähltes Projektboard](/assets/images/help/projects/sidebar-select-project.png){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -5. Click -{% octicon "triangle-down" aria-label="The down triangle icon" %}, then click the column where you want your issue or pull request. Das Ticket wird unten in der ausgewählten Projektboard-Spalte platziert. - ![Menü „Move card to column“ (Ticket in Spalte verschieben)](/assets/images/help/projects/sidebar-select-project-board-column-menu.png) -{% else %} -5. Klicke rechts neben dem Issue oder Pull Request auf **PROJECT-BOARD-NAME (awaiting triage)** (PROJEKTBOARD-NAME (Einteilung ausstehend)). ![Link zum Projektboard](/assets/images/help/projects/sidebar-project-board-link.png) -6. Klicke im Projektboard auf **{% octicon "plus" aria-label="The Plus icon" %} Add cards (1 new)** (Tickets hinzufügen (1 neu)). ![Schaltfläche „Add cards“ (Tickets hinzufügen)](/assets/images/help/projects/add-cards-pending-button.png) -7. Ziehe das Ticket für den Issue oder Pull Request per Drag-and-Drop aus dem Bereich **Triage** (Einteilung) in die gewünschte Spalte im Projektboard. Alternativ kannst Du die Tickets auch mithilfe von Tastenkürzeln verschieben. {% data reusables.project-management.for-more-info-project-keyboard-shortcuts %} -{% endif %} +4. Select one or more project boards where you want to add the issue or pull request. ![Ausgewähltes Projektboard](/assets/images/help/projects/sidebar-select-project.png) +5. Klicke auf {% octicon "triangle-down" aria-label="The down triangle icon" %} und anschließend auf die Spalte, die den Issue oder Pull Request enthalten soll. Das Ticket wird unten in der ausgewählten Projektboard-Spalte platziert. ![Menü „Move card to column“ (Ticket in Spalte verschieben)](/assets/images/help/projects/sidebar-select-project-board-column-menu.png) ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/managing-your-work-on-github/adding-notes-to-a-project-board.md b/translations/de-DE/content/github/managing-your-work-on-github/adding-notes-to-a-project-board.md index 6552a9ba9861..33f4a7d5081c 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/adding-notes-to-a-project-board.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/adding-notes-to-a-project-board.md @@ -1,6 +1,6 @@ --- title: Hinweise zu einem Projektboard hinzufügen -intro: 'Du kannst Hinweise zu einem Projektboard hinzufügen, um an Aufgaben zu erinnern oder Informationen im Zusammenhang mit dem Projektboard hinzuzufügen.' +intro: Du kannst Hinweise zu einem Projektboard hinzufügen, um an Aufgaben zu erinnern oder Informationen im Zusammenhang mit dem Projektboard hinzuzufügen. redirect_from: - /articles/adding-notes-to-a-project/ - /articles/adding-notes-to-a-project-board diff --git a/translations/de-DE/content/github/managing-your-work-on-github/applying-labels-to-issues-and-pull-requests.md b/translations/de-DE/content/github/managing-your-work-on-github/applying-labels-to-issues-and-pull-requests.md index 42268af8b071..10f27c0ce742 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/applying-labels-to-issues-and-pull-requests.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/applying-labels-to-issues-and-pull-requests.md @@ -11,14 +11,15 @@ versions: {% tip %} -**Tipp:** Du kannst auch innerhalb eines Issues oder Pull Requests eine Kennzeichnung über das Dropdownmenü für Kennzeichnungen anwenden. +**Tip:** You can apply up to a maximum of 100 labels to issues and pull requests. {% endtip %} {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issue-pr %} {% data reusables.repositories.select-items-in-issue-or-pr-list %} -4. Klicke in der oberen rechten Ecke auf **Label** (Kennzeichnung), und gib den Namen einer vorhandenen Kennzeichnung ein. Klicke auf den Namen der Kennzeichnung, um sie mit den ausgewählten Elementen zu verknüpfen. ![Dropdownmenü „Issues Milestone assignment" (Issue-Meilenstein-Zuordnung)](/assets/images/help/issues/issues_applying_labels_dropdown.png) +4. Klicke in der oberen rechten Ecke auf **Label** (Kennzeichnung), und gib den Namen einer vorhandenen Kennzeichnung ein. Klicke auf den Namen der Kennzeichnung, um sie mit den ausgewählten Elementen zu verknüpfen. You can also apply a label in the Labels drop-down menu within an issue or pull request. ![Dropdownmenü „Issues Milestone assignment" (Issue-Meilenstein-Zuordnung)](/assets/images/help/issues/issues_applying_labels_dropdown.png) + ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/managing-your-work-on-github/archiving-cards-on-a-project-board.md b/translations/de-DE/content/github/managing-your-work-on-github/archiving-cards-on-a-project-board.md index 9e24ec8310cb..c3b3e54b3357 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/archiving-cards-on-a-project-board.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/archiving-cards-on-a-project-board.md @@ -1,6 +1,6 @@ --- title: Tickets auf einem Projektboard archivieren -intro: 'Du kannst Projektboard-Tickets archivieren, um Deinen Workflow übersichtlich zu halten, ohne die Verlaufsinformationen eines Projekts zu verlieren.' +intro: Du kannst Projektboard-Tickets archivieren, um Deinen Workflow übersichtlich zu halten, ohne die Verlaufsinformationen eines Projekts zu verlieren. redirect_from: - /articles/archiving-cards-on-a-project-board versions: diff --git a/translations/de-DE/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md b/translations/de-DE/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md index add3d6fcd6c2..9da350342d1a 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md @@ -1,6 +1,6 @@ --- title: Issues und Pull Requests anderen GitHub-Benutzern zuweisen -intro: 'Zugewiesene Bearbeiter stellen klar, wer bestimmte Issues und Pull Requests bearbeitet.' +intro: Zugewiesene Bearbeiter stellen klar, wer bestimmte Issues und Pull Requests bearbeitet. redirect_from: - /articles/assigning-issues-and-pull-requests-to-other-github-users versions: @@ -10,7 +10,7 @@ versions: Jeder, der über Schreibberechtigungen für ein Repository verfügt, kann Issues und Pull Requests zuweisen. -Du kannst jedem Issue oder Pull Request bis zu 10 Personen zuweisen (auch Dich selber),{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} jeden, der den Issue oder Pull Request kommentiert hat,{% endif %} jeden, der Schreibberechtigungen für das Repository hat, sowie Organisationsmitglieder mit Leseberechtigung für das Repository. Weitere Informationen findest Du unter „[Zugriffsberechtigungen auf {% data variables.product.prodname_dotcom %}](/articles/access-permissions-on-github).“ +You can assign up to 10 people to each issue or pull request, including yourself, anyone who has commented on the issue or pull request, anyone with write permissions to the repository, and organization members with read permissions to the repository. Weitere Informationen findest Du unter „[Zugriffsberechtigungen auf {% data variables.product.prodname_dotcom %}](/articles/access-permissions-on-github).“ {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issue-pr %} diff --git a/translations/de-DE/content/github/managing-your-work-on-github/associating-milestones-with-issues-and-pull-requests.md b/translations/de-DE/content/github/managing-your-work-on-github/associating-milestones-with-issues-and-pull-requests.md index 05e8b16d2d7e..73e82ea0a174 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/associating-milestones-with-issues-and-pull-requests.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/associating-milestones-with-issues-and-pull-requests.md @@ -1,6 +1,6 @@ --- title: Meilensteine mit Issues und Pull Requests verknüpfen -intro: 'Du kannst ähnliche Issues und Pull Requests mit einem Meilenstein verknüpfen, um ihre Fortschritte besser nachverfolgen zu können.' +intro: Du kannst ähnliche Issues und Pull Requests mit einem Meilenstein verknüpfen, um ihre Fortschritte besser nachverfolgen zu können. redirect_from: - /articles/associating-milestones-with-issues-and-pull-requests versions: diff --git a/translations/de-DE/content/github/managing-your-work-on-github/changing-project-board-visibility.md b/translations/de-DE/content/github/managing-your-work-on-github/changing-project-board-visibility.md index 9bae51df56b9..fa37a224ae5e 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/changing-project-board-visibility.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/changing-project-board-visibility.md @@ -1,6 +1,6 @@ --- title: Sichtbarkeit des Projektboards ändern -intro: Als Organisationsinhaber oder Projektboard-Administrator kannst Du ein Projektboard als öffentlich oder privat festlegen. +intro: 'Als Organisationsinhaber oder Projektboard-Administrator kannst Du ein Projektboard als öffentlich oder privat festlegen.' redirect_from: - /articles/changing-project-board-visibility versions: diff --git a/translations/de-DE/content/github/managing-your-work-on-github/configuring-automation-for-project-boards.md b/translations/de-DE/content/github/managing-your-work-on-github/configuring-automation-for-project-boards.md index 79ecb76eecc7..9644286c4c82 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/configuring-automation-for-project-boards.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/configuring-automation-for-project-boards.md @@ -1,6 +1,6 @@ --- title: Automatisierung für Projektboards konfigurieren -intro: 'Du kannst automatische Workflows einrichten, die Issues und Pull Requests in eine Projektboard-Spalte verschieben, wenn ein festgelegtes Ereignis auftritt.' +intro: Du kannst automatische Workflows einrichten, die Issues und Pull Requests in eine Projektboard-Spalte verschieben, wenn ein festgelegtes Ereignis auftritt. redirect_from: - /articles/configuring-automation-for-project-boards versions: diff --git a/translations/de-DE/content/github/managing-your-work-on-github/copying-a-project-board.md b/translations/de-DE/content/github/managing-your-work-on-github/copying-a-project-board.md index b79afd1586fd..775ddd114a4f 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/copying-a-project-board.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/copying-a-project-board.md @@ -1,6 +1,6 @@ --- title: Ein Projektboard kopieren -intro: 'Du kannst ein Projektboard kopieren, um schnell ein neues Projekt zu erstellen. Das Kopieren häufig genutzter oder stark angepasster Projektboards unterstützt die Standardisierung von Workflows.' +intro: Du kannst ein Projektboard kopieren, um schnell ein neues Projekt zu erstellen. Das Kopieren häufig genutzter oder stark angepasster Projektboards unterstützt die Standardisierung von Workflows. redirect_from: - /articles/copying-a-project-board versions: diff --git a/translations/de-DE/content/github/managing-your-work-on-github/creating-a-label.md b/translations/de-DE/content/github/managing-your-work-on-github/creating-a-label.md index 5f41fd55c1ce..0d84e2ceb741 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/creating-a-label.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/creating-a-label.md @@ -29,6 +29,6 @@ versions: - „[Informationen zu Kennzeichnungen](/articles/about-labels)“ - „[Kennzeichnungen auf Issues und Pull Requests anwenden](/articles/applying-labels-to-issues-and-pull-requests)“ - „[Eine Kennzeichnung bearbeiten](/articles/editing-a-label)“ -- „[Issues und Pull Requests nach Kennzeichnungen filtern](/articles/filtering-issues-and-pull-requests-by-labels)“{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} +- "[Filtering issues and pull requests by labels](/articles/filtering-issues-and-pull-requests-by-labels)"{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} - „[Standardkennzeichnungen für Repositorys in Deiner Organisation verwalten](/articles/managing-default-labels-for-repositories-in-your-organization)" {% endif %} diff --git a/translations/de-DE/content/github/managing-your-work-on-github/creating-a-project-board.md b/translations/de-DE/content/github/managing-your-work-on-github/creating-a-project-board.md index b6a0ded8773e..57cced1e860a 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/creating-a-project-board.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/creating-a-project-board.md @@ -82,7 +82,7 @@ Du kannst auch Workflows automatisieren, um Dein Projektboard mit dem Status der ### Weiterführende Informationen - „[Informationen zu Projektboards](/articles/about-project-boards)“ -- „[Ein Projektboard bearbeiten](/articles/editing-a-project-board)“{% if currentVersion == "free-pro-team@latest" %} +- "[Editing a project board](/articles/editing-a-project-board)"{% if currentVersion == "free-pro-team@latest" %} - „[Ein Projektboard kopieren](/articles/copying-a-project-board)“{% endif %} - „[Ein Projektboard schließen](/articles/closing-a-project-board)“ - „[Informationen zur Automatisierung für Projektboards](/articles/about-automation-for-project-boards)“ diff --git a/translations/de-DE/content/github/managing-your-work-on-github/creating-and-editing-milestones-for-issues-and-pull-requests.md b/translations/de-DE/content/github/managing-your-work-on-github/creating-and-editing-milestones-for-issues-and-pull-requests.md index 81ba0b818150..f8b6fffa5f72 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/creating-and-editing-milestones-for-issues-and-pull-requests.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/creating-and-editing-milestones-for-issues-and-pull-requests.md @@ -1,6 +1,6 @@ --- title: Meilensteine für Issues und Pull Requests erstellen und bearbeiten -intro: 'Du kannst einen Meilenstein erstellen, um den Fortschritt von Gruppen von Issues oder Pull Requests in einem Repository zu verfolgen.' +intro: Du kannst einen Meilenstein erstellen, um den Fortschritt von Gruppen von Issues oder Pull Requests in einem Repository zu verfolgen. redirect_from: - /articles/creating-milestones-for-issues-and-pull-requests/ - /articles/creating-and-editing-milestones-for-issues-and-pull-requests diff --git a/translations/de-DE/content/github/managing-your-work-on-github/deleting-a-label.md b/translations/de-DE/content/github/managing-your-work-on-github/deleting-a-label.md index 698b6221fbd2..0586a5d0e040 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/deleting-a-label.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/deleting-a-label.md @@ -18,6 +18,6 @@ Durch den Löschvorgang wird die Kennzeichnung von allen Issues und Pull Request ### Weiterführende Informationen - „[Kennzeichnungen auf Issues und Pull Requests anwenden](/articles/applying-labels-to-issues-and-pull-requests)“ -- „[Issues und Pull Requests nach Kennzeichnungen filtern](/articles/filtering-issues-and-pull-requests-by-labels)“{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} +- "[Filtering issues and pull requests by labels](/articles/filtering-issues-and-pull-requests-by-labels)"{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} - „[Standardkennzeichnungen für Repositorys in Deiner Organisation verwalten](/articles/managing-default-labels-for-repositories-in-your-organization)" {% endif %} diff --git a/translations/de-DE/content/github/managing-your-work-on-github/deleting-a-project-board.md b/translations/de-DE/content/github/managing-your-work-on-github/deleting-a-project-board.md index 04511d78f5f9..1c6de9020a1a 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/deleting-a-project-board.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/deleting-a-project-board.md @@ -1,6 +1,6 @@ --- title: Ein Projektboard löschen -intro: 'Du kannst ein vorhandenes Projektboard löschen, wenn Du nicht mehr auf seine Inhalte zugreifen musst.' +intro: Du kannst ein vorhandenes Projektboard löschen, wenn Du nicht mehr auf seine Inhalte zugreifen musst. redirect_from: - /articles/deleting-a-project/ - /articles/deleting-a-project-board diff --git a/translations/de-DE/content/github/managing-your-work-on-github/deleting-an-issue.md b/translations/de-DE/content/github/managing-your-work-on-github/deleting-an-issue.md index ea8985160ff4..c08c566e3da2 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/deleting-an-issue.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/deleting-an-issue.md @@ -1,6 +1,6 @@ --- title: Einen Issue löschen -intro: 'Jeder, der über Administratorberechtigungen für ein Repository verfügt, kann einen Issue dauerhaft aus einem Repository löschen.' +intro: Jeder, der über Administratorberechtigungen für ein Repository verfügt, kann einen Issue dauerhaft aus einem Repository löschen. redirect_from: - /articles/deleting-an-issue versions: diff --git a/translations/de-DE/content/github/managing-your-work-on-github/disabling-issues.md b/translations/de-DE/content/github/managing-your-work-on-github/disabling-issues.md index c0b13ce437e7..d168cf7ca4f4 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/disabling-issues.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/disabling-issues.md @@ -1,6 +1,6 @@ --- title: Issues deaktivieren -intro: 'Du kannst Issues für Dein Repository deaktivieren, wenn Du keine Beiträge oder Fehlerberichte akzeptierst.' +intro: Du kannst Issues für Dein Repository deaktivieren, wenn Du keine Beiträge oder Fehlerberichte akzeptierst. redirect_from: - /articles/disabling-issues versions: @@ -17,8 +17,9 @@ Wenn Du Issues zukünftig erneut aktivieren möchtest, sind alle Issues wieder v {% if currentVersion == "free-pro-team@latest" %} {% tip %} +Please contact -Wende Dich an {% data variables.contact.contact_support %}, wenn Du Issues wegen missbräuchlicher Verwendung durch Fremde deaktivieren möchtest. +{% data variables.contact.contact_support %} if you want to turn off issues because of abuse from strangers. {% data reusables.policies.abuse %} {% endtip %} diff --git a/translations/de-DE/content/github/managing-your-work-on-github/disabling-project-boards-in-a-repository.md b/translations/de-DE/content/github/managing-your-work-on-github/disabling-project-boards-in-a-repository.md index acd2d2f391f9..548fc0cc4ad9 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/disabling-project-boards-in-a-repository.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/disabling-project-boards-in-a-repository.md @@ -1,6 +1,6 @@ --- title: Projektboards in einem Repository deaktivieren -intro: 'Repository-Administratoren können Projektboards für ein Repository deaktivieren, wenn Du oder Dein Team die Arbeit anders verwalten.' +intro: Repository-Administratoren können Projektboards für ein Repository deaktivieren, wenn Du oder Dein Team die Arbeit anders verwalten. redirect_from: - /articles/disabling-project-boards-in-a-repository versions: diff --git a/translations/de-DE/content/github/managing-your-work-on-github/editing-a-label.md b/translations/de-DE/content/github/managing-your-work-on-github/editing-a-label.md index 65b63c9dfb8b..4b54a017f555 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/editing-a-label.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/editing-a-label.md @@ -23,6 +23,6 @@ versions: - „[Eine Kennzeichnung erstellen](/articles/creating-a-label)“ - „[Eine Kennzeichnung löschen](/articles/deleting-a-label)“ - „[Kennzeichnungen auf Issues und Pull Requests anwenden](/articles/applying-labels-to-issues-and-pull-requests)“ -- „[Issues und Pull Requests nach Kennzeichnungen filtern](/articles/filtering-issues-and-pull-requests-by-labels)“{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} +- "[Filtering issues and pull requests by labels](/articles/filtering-issues-and-pull-requests-by-labels)"{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} - „[Standardkennzeichnungen für Repositorys in Deiner Organisation verwalten](/articles/managing-default-labels-for-repositories-in-your-organization)" {% endif %} diff --git a/translations/de-DE/content/github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests.md b/translations/de-DE/content/github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests.md index 5b547bd73083..53a67879b052 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests.md @@ -1,6 +1,6 @@ --- -title: Dateianhänge für Issues und Pull Requests -intro: 'Wenn Du einen Issue öffnest oder einen Pull Request aktualisierst, kannst Du mithilfe von Issue-Anhängen Bilder von vorgeschlagenen Funktionen oder Screenshots von Fehlern hochladen.' +title: File attachments on issues and pull requests +intro: 'When you open issue or update a pull request, you can use issue attachments to upload images of proposed features or screenshots of bugs.' redirect_from: - /articles/issue-attachments/ - /articles/file-attachments-on-issues-and-pull-requests @@ -8,34 +8,33 @@ versions: free-pro-team: '*' enterprise-server: '*' --- - {% warning %} -**Warnung:** Wenn Du ein Bild zu einem Pull-Request- oder Issue-Kommentar hinzufügst, kann jeder die anonymisierte Bild-URL ohne Authentifizierung anzeigen, selbst wenn sich der Pull Request in einem privaten Repository befindet{% if currentVersion != "free-pro-team@latest" %} oder der private Modus aktiviert ist{% endif %}. Um vertraulicher Bilder zu schützen, stelle sie über ein privates Netzwerk oder einen Server bereit, der eine Authentifizierung vorschreibt. {% if currentVersion == "free-pro-team@latest" %}Weitere Informationen zu anonymisierten URLs findest Du unter „[Informationen zu anonymisierten Bild-URLs](/articles/about-anonymized-image-urls)“.{% endif %} +**Warning:** If you add an image to a pull request or issue comment, anyone can view the anonymized image URL without authentication, even if the pull request is in a private repository{% if currentVersion != "free-pro-team@latest" %}, or if private mode is enabled{% endif %}. To keep sensitive images private, serve them from a private network or server that requires authentication. {% if currentVersion == "free-pro-team@latest" %}For more information on anonymized URLs see "[About anonymized image URLs](/articles/about-anonymized-image-urls)".{% endif %} {% endwarning %} -Um eine Datei an eine Issue- oder eine Pull-Request-Unterhaltung anzuhängen, ziehe sie per Drag-and-Drop in das Kommentarfeld. Alternativ kannst Du die Leiste am unteren Rand des Kommentarfeldes anklicken, um eine Datei von Deinem Computer zu suchen, auszuwählen und hinzuzufügen. +To attach a file to an issue or pull request conversation, drag and drop it into the comment box. Alternatively, you can click the bar at the bottom of the comment box to browse, select, and add a file from your computer. -![Anhänge vom Computer auswählen](/assets/images/help/pull_requests/select-bar.png) +![Select attachments from computer](/assets/images/help/pull_requests/select-bar.png) {% tip %} -**Tipp:** Wenn Du Chrome verwendest, kannst Du Bilder auch direkt in das Feld kopieren. +**Tip:** If you're using Chrome, you can also copy-and-paste images directly into the box. {% endtip %} -Die Größe der Anhänge ist bei Dateien auf 25 MB und bei Bildern auf 10 MB beschränkt. +The maximum size for files is 25MB and the maximum size for images is 10MB. -Wir unterstützen die folgenden Dateiformate: +We support these files: * PNG (*.png*) * GIF (*.gif*) * JPEG (*.jpg*) -* Protokolldateien (*.log*) -* Microsoft Word-Dokumente (*.docx*), Powerpoint-Dokumente (*.pptx*) und Excel-Dokumente (*.xlsx*) -* Textdateien (*.txt*) -* PDF-Dateien (*.pdf*) -* ZIP-Dateien (*.zip*, *.gz*) +* Log files (*.log*) +* Microsoft Word (*.docx*), Powerpoint (*.pptx*), and Excel (*.xlsx*) documents +* Text files (*.txt*) +* PDFs (*.pdf*) +* ZIP (*.zip*, *.gz*) -![Animiertes GIF zu Anhängen](/assets/images/help/pull_requests/dragging_images.gif) +![Attachments animated GIF](/assets/images/help/pull_requests/dragging_images.gif) diff --git a/translations/de-DE/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md b/translations/de-DE/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md index 433dddfeb8a7..8f6bd912bde3 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md @@ -1,6 +1,6 @@ --- title: Tickets auf einem Projektboard filtern -intro: 'Du kannst die Tickets auf einem Projektboard filtern, um bestimmte Tickets zu suchen oder eine Teilmenge der Tickets anzuzeigen.' +intro: Du kannst die Tickets auf einem Projektboard filtern, um bestimmte Tickets zu suchen oder eine Teilmenge der Tickets anzuzeigen. redirect_from: - /articles/filtering-cards-on-a-project-board versions: @@ -8,20 +8,20 @@ versions: enterprise-server: '*' --- -Auf einem Ticket kannst Du auf einen Bearbeiter{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}, Meilenstein{% endif %} oder eine Kennzeichnung klicken, um das Projektboard nach diesem Qualifizierern zu filtern. Um den Filter zu löschen, klicke erneut auf denselben Bearbeiter{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}, Meilenstein{% endif %} oder dieselbe Kennzeichnung. +On a card, you can click any assignee, milestone, or label to filter the project board by that qualifier. To clear the search, you can click the same assignee, milestone, or label again. Du kannst Tickets auch über die Suchleiste „Filter cards“ (Tickets filtern) oben auf jedem Projektboard suchen. Um Tickets zu filtern, kannst Du die folgenden Qualifizierer in beliebiger Kombination verwenden oder einfach den Text eingeben, nach dem Du suchst. - Tickets nach Autor filtern – mit `author:USERNAME` - Tickets nach Bearbeiter filtern – mit `assignee:USERNAME` oder `no:assignee` -- Tickets nach Kennzeichnung filtern – mit `label:LABEL`, `label:"MULTI-WORD LABEL NAME"` oder `no:label`{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -- Tickets nach Meilenstein filtern – mit `milestone:MY-MILESTONE`{% endif %} +- Filter cards by label using `label:LABEL`, `label:"MULTI-WORD LABEL NAME"`, or `no:label` +- Tickets nach Meilenstein filtern – mit `milestone:MY-MILESTONE` - Tickets nach Status filtern – mit `state:open`, `state:closed` oder `state:merged` - Tickets nach Review-Status filtern – mit `review:none`, `review:required`, `review:approved` oder `review:changes_requested` - Tickets nach Prüfstatus filtern – mit `status:pending`, `status:success` oder `status:failure` - Tickets nach Typ filtern – mit `type:issue`, `type:pr` oder `type:note` - Tickets nach Status und Typ filtern – mit `is:open`, `is:closed` oder `is:merged` und `is:issue`, `is:pr` oder `is:note` -- Tickets nach Issues filtern, die mit einer abschließenden Referenz zu einem Pull Request verbunden sind – mit `linked:pr`{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +- Filter cards by issues that are linked to a pull request by a closing reference using `linked:pr`{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} - Tickets nach Repository in einem organisationsweiten Projektboard filtern – mit `repo:ORGANIZATION/REPOSITORY`{% endif %} 1. Navigiere zu dem Projektboard, das die Tickets enthält, nach denen Du filtern möchtest. diff --git a/translations/de-DE/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests.md b/translations/de-DE/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests.md index e4716e71d098..88100614948b 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests.md @@ -1,6 +1,6 @@ --- title: Issues und Pull Requests filtern -intro: 'Issues und Pull Requests umfassen standardmäßige Filter, mit denen Du Deine Listen organisieren kannst.' +intro: Issues und Pull Requests umfassen standardmäßige Filter, mit denen Du Deine Listen organisieren kannst. redirect_from: - /articles/filtering-issues-and-pull-requests versions: diff --git a/translations/de-DE/content/github/managing-your-work-on-github/filtering-pull-requests-by-review-status.md b/translations/de-DE/content/github/managing-your-work-on-github/filtering-pull-requests-by-review-status.md index 4b9aaf79d7f6..365b555d4c8d 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/filtering-pull-requests-by-review-status.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/filtering-pull-requests-by-review-status.md @@ -1,6 +1,6 @@ --- title: Pull Requests nach Review-Status filtern -intro: 'Mit Filtern kannst Du Pull Requests nach Review-Status auflisten und Pull Requests suchen, die Du überprüft hast oder um deren Review Du von anderen gebeten wurdest.' +intro: Mit Filtern kannst Du Pull Requests nach Review-Status auflisten und Pull Requests suchen, die Du überprüft hast oder um deren Review Du von anderen gebeten wurdest. redirect_from: - /articles/filtering-pull-requests-by-review-status versions: diff --git a/translations/de-DE/content/github/managing-your-work-on-github/labeling-issues-and-pull-requests.md b/translations/de-DE/content/github/managing-your-work-on-github/labeling-issues-and-pull-requests.md index 2629816a4fbc..30a798b7dfae 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/labeling-issues-and-pull-requests.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/labeling-issues-and-pull-requests.md @@ -1,6 +1,6 @@ --- title: Issues und Pull Requests kennzeichnen -intro: 'Du kannst Deine Arbeit auf {% data variables.product.product_name %} verwalten, indem Du Kennzeichnungen für die Kategorisierung von Issues und Pull Requests erstellst.' +intro: 'Sie können Ihre Arbeit auf {% data variables.product.product_name %} verwalten, indem Sie Kennzeichnungen für die Kategorisierung von Issues und Pull Requests erstellen.' mapTopic: true redirect_from: - /articles/labeling-issues-and-pull-requests diff --git a/translations/de-DE/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md b/translations/de-DE/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md index f1b2e1caf784..89bc152f4565 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md @@ -1,6 +1,6 @@ --- title: Einen Pull Request zu einem Issue verknüpfen -intro: 'Du kannst einen Pull Request mit einem Issue verknüpfen, um{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} zu zeigen, dass eine Korrektur im Gang ist und{% endif %} den Issue automatisch zu schließen, wenn der Pull Request zusammenführt wird.' +intro: 'You can link a pull request to an issue to{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} show that a fix is in progress and to{% endif %} automatically close the issue when the pull request is merged.' redirect_from: - /articles/closing-issues-via-commit-message/ - /articles/closing-issues-via-commit-messages/ @@ -11,15 +11,19 @@ versions: enterprise-server: '*' --- +{% note %} + +**Note:** The special keywords in a pull request description are interpreted when the pull request targets the repository's *default* branch. However, if the PR's base is *any other branch*, then these keywords are ignored, no links are created and merging the PR has no effect on the issues. **If you want to link a pull request to an issue using a keyword, the PR must be on the default branch.** + +{% endnote %} + ### Über verknüpfte Issues und Pull Requests -Du kannst einen Issue mit einem Pull-Request {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}manuell oder {% endif %}mit einem unterstützten Schlüsselwort in der Pull-Request Beschreibung verknüpfen. +You can link an issue to a pull request {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}manually or {% endif %}using a supported keyword in the pull request description. -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -Wenn Du einen Pull Request mit dem Issue verknüpfst, der vom Pull Request adressiert wird, dann können Mitarbeiter sehen, dass jemand am Issue arbeitet. -{% if currentVersion ver_lt "enterprise-server@2.21" %}Wenn der Pull Request und der Issue in unterschiedlichen Repositorys sind, wird {% data variables.product.product_name %} nach dem Zusammenführen des Pull Request den Link anzeigen, wenn die Person, die den Pull Request zusammenführt, auch die Berechtigung zum Schließen des Issue hat.{% endif %}{% endif %} +Wenn Du einen Pull Request mit dem Issue verknüpfst, der vom Pull Request adressiert wird, dann können Mitarbeiter sehen, dass jemand am Issue arbeitet. {% if currentVersion ver_lt "enterprise-server@2.21" %}If the pull request and the issue are in different repositories, {% data variables.product.product_name %} will display the link after the pull request is merged, if the person who merges the pull request also has permission to close the issue.{% endif %} -Wenn Du einen verknüpften Pull Request in den Standard-Branch eines Repository zusammenführst, werden seine verknüpften Issues automatisch geschlossen. Weitere Informationen über den Standard-Branch findest Du auf „[Einstellungen des Standard-Branch](/github/administering-a-repository/setting-the-default-branch)." +Wenn Du einen verknüpften Pull Request in den Standard-Branch eines Repository zusammenführst, werden seine verknüpften Issues automatisch geschlossen. For more information about the default branch, see "[Changing the default branch](/github/administering-a-repository/changing-the-default-branch)." {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} ### Einen Pull Request manuell mit einem Issue verknüpfen @@ -37,7 +41,7 @@ Du kannst bis zu 10 Issues manuell mit jedem Pull Request verknüpfen. Der Issue ### Einen Pull Request über ein Stichwort mit einem Issue verknüpfen -Du kannst einen Pull Request mit einem Issue über unterstützte Schlüsselwörter in der Pull-Request-Beschreibung verknüpfen. +You can link a pull request to an issue by using a supported keyword in the pull request's description or in a commit message (please note that the pull request must be on the default branch). * close (schließen) * closes (wird geschlossen) @@ -57,9 +61,9 @@ Die Syntax für schließende Schlüsselwörter hängt davon ab, ob der Issue im | Issue ist in einem unterschiedlichen Repository | *SCHLÜSSELWORT* *INHABER*/*REPOSITORY*#*ISSUE-NUMMER* | `Fixes octo-org/octo-repo#100` | | Mehrfache Issues | Verwende für jeden Issue die vollständige Syntax | `Resolves #10, resolves #123, resolves octo-org/octo-repo#100` | -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}Nur manuell verknüpfte Pull Requests können manuell getrennt werden. Um die Verknüpfung eines Issues zu lösen, den Du über ein Schlüsselwort verknüpft hast, musst Du die Pull-Request-Beschreibung bearbeiten, um das Schlüsselwort zu entfernen.{% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}Only manually linked pull requests can be manually unlinked. Um die Verknüpfung eines Issues zu lösen, den Du über ein Schlüsselwort verknüpft hast, musst Du die Pull-Request-Beschreibung bearbeiten, um das Schlüsselwort zu entfernen.{% endif %} -Du kannst schließende Schlüsselwörter auch in einer Commit-Mitteilung verwenden. Der Issue wird geschlossen, wenn Du den Commit in den Standard-Branch zusammenführst{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, aber der Pull Request, der den Commit enthält, wird nicht als verknüpfter Pull Request aufgeführt werden{% endif %}. +Du kannst schließende Schlüsselwörter auch in einer Commit-Mitteilung verwenden. The issue will be closed when you merge the commit into the default branch, but the pull request that contains the commit will not be listed as a linked pull request. ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/managing-your-work-on-github/managing-your-work-with-issues.md b/translations/de-DE/content/github/managing-your-work-on-github/managing-your-work-with-issues.md index 07fd88c9f7a0..ebf02dc8ecb3 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/managing-your-work-with-issues.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/managing-your-work-with-issues.md @@ -1,6 +1,6 @@ --- title: Deine Arbeit mit Issues verwalten -intro: 'Du kannst Deine Arbeit auf {% data variables.product.product_name %} verwalten, indem Du Issues zur Nachverfolgung von Ideen, Verbesserungen, Aufgaben oder Fehlern erstellst.' +intro: 'Sie können Ihre Arbeit auf {% data variables.product.product_name %} verwalten, indem Sie Issues zur Nachverfolgung von Ideen, Verbesserungen, Aufgaben oder Bugs erstellen.' mapTopic: true redirect_from: - /articles/managing-your-work-with-issues diff --git a/translations/de-DE/content/github/managing-your-work-on-github/tracking-the-progress-of-your-work-with-milestones.md b/translations/de-DE/content/github/managing-your-work-on-github/tracking-the-progress-of-your-work-with-milestones.md index 5629e3faba65..a1db7fc28e3c 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/tracking-the-progress-of-your-work-with-milestones.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/tracking-the-progress-of-your-work-with-milestones.md @@ -1,6 +1,6 @@ --- title: Fortschritt Deiner Arbeit mit Meilensteinen verfolgen -intro: 'Du kannst den Fortschritt Deiner Arbeit auf {% data variables.product.product_name %} mithilfe von Meilensteinen verfolgen, die Du für Issues und Pull Requests erstellst.' +intro: 'Sie können den Fortschritt Ihrer Arbeit auf {% data variables.product.product_name %} mithilfe von Meilensteinen verfolgen, die Sie für Issues und Pull Requests erstellen.' mapTopic: true redirect_from: - /articles/tracking-the-progress-of-your-work-with-milestones diff --git a/translations/de-DE/content/github/managing-your-work-on-github/tracking-the-progress-of-your-work-with-project-boards.md b/translations/de-DE/content/github/managing-your-work-on-github/tracking-the-progress-of-your-work-with-project-boards.md index 23011a797eb3..e367ce71b946 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/tracking-the-progress-of-your-work-with-project-boards.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/tracking-the-progress-of-your-work-with-project-boards.md @@ -1,6 +1,6 @@ --- title: Fortschritt Deiner Arbeit in Projektboards verfolgen -intro: 'Du kannst den Fortschritt Deiner Arbeit auf {% data variables.product.product_name %} verfolgen und priorisieren, indem Du ein Projektboard mit zugehörigen Issues, Pull Requests und Hinweisen erstellst.' +intro: 'Sie können den Fortschritt Ihrer Arbeit auf {% data variables.product.product_name %} in Projektboards, die Sie für Issues, Pull Requests und Hinweise erstellen, verfolgen und priorisieren.' redirect_from: - /articles/tracking-the-progress-of-your-work-with-projects/ - /articles/tracking-the-progress-of-your-work-with-project-boards diff --git a/translations/de-DE/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md b/translations/de-DE/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md index 07b3069b7fd1..66650f803aa4 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md @@ -5,14 +5,14 @@ redirect_from: - /articles/transferring-an-issue-to-another-repository versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- Für die Übertragung eines offenen Issues in ein anderes Repository benötigst Du Schreibberechtigung sowohl für das Repository, aus dem der Issue stammt, wie auch für das Repository, in das der Issue übertragen wird. Weitere Informationen finden Sie unter„[Berechtigungsebenen für die Repositorys einer Organisation](/articles/repository-permission-levels-for-an-organization)“. Du kannst Issues nur zwischen Repositorys übertragen, die demselben Benutzer- oder Organisationskonto angehören. Du kannst einen Issue nicht aus einem privaten Repository in ein öffentliches Repository übertragen. -Wenn Du einen Issue überträgst, bleiben seine Kommentare und Bearbeiter erhalten. Die Kennzeichnungen des Issues{% if currentVersion ver_lt "enterprise-server@2.19" %}, die Projekte{% endif %} und die Meilensteine bleiben nicht erhalten.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} Der Issue wird auf allen benutzereigenen oder organisationsweiten Projektboards verbleiben und von allen Repository-Projektboards entfernt. Weitere Informationen findest Du unter „[Informationen zu Projektboards](/articles/about-project-boards)“.{% endif %} +Wenn Du einen Issue überträgst, bleiben seine Kommentare und Bearbeiter erhalten. The issue's labels and milestones are not retained. This issue will stay on any user-owned or organization-wide project boards and be removed from any repository project boards. Weitere Informationen findest Du unter „[Informationen zu Projektboards](/articles/about-project-boards).“ Im Issue erwähnte Personen und Teams werden über die Übertragung des Issues in ein neues Repository benachrichtigt. Die ursprüngliche URL wird an die neue URL des Issues weitergeleitet. Personen, die für das neue Repository über keine Leseberechtigung verfügen, wird ein Banner angezeigt, das sie darüber informiert, dass der Issue in ein Repository übertragen wurde, auf das sie keinen Zugriff haben. diff --git a/translations/de-DE/content/github/managing-your-work-on-github/using-search-to-filter-issues-and-pull-requests.md b/translations/de-DE/content/github/managing-your-work-on-github/using-search-to-filter-issues-and-pull-requests.md index b8a7a0bc96b6..b86642af8f00 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/using-search-to-filter-issues-and-pull-requests.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/using-search-to-filter-issues-and-pull-requests.md @@ -39,7 +39,7 @@ Bei Pull Requests kannst Du die Suche auch verwenden, um: - Pull Requests zu filtern, in denen ein Reviewer um Änderungen gebeten hat: `state:open type:pr review:changes_requested` - Pull Requests nach [Reviewer](/articles/about-pull-request-reviews/) zu filtern: `state:open type:pr reviewed-by:octocat` - Pull Requests nach dem bestimmten Benutzer zu filtern, der für den [Review angefordert](/articles/requesting-a-pull-request-review) wurde: `state:open type:pr review-requested:octocat` -- Pull Requests nach einem Team filtern, das für dein Review angefordert wurde: `state:open type:pr team-review-requested:github/atom`{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +- Filter pull requests by the team requested for review: `state:open type:pr team-review-requested:github/atom`{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} - Nach Pull Requests filtern, die zu einem Issue verknüpft sind, die der Pull Request schließen könnte: `linked:issue`{% endif %} ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/managing-your-work-on-github/viewing-all-of-your-issues-and-pull-requests.md b/translations/de-DE/content/github/managing-your-work-on-github/viewing-all-of-your-issues-and-pull-requests.md index bbb98ccc7861..cab33fdbed0c 100644 --- a/translations/de-DE/content/github/managing-your-work-on-github/viewing-all-of-your-issues-and-pull-requests.md +++ b/translations/de-DE/content/github/managing-your-work-on-github/viewing-all-of-your-issues-and-pull-requests.md @@ -15,4 +15,4 @@ Deine Dashboards für Issues und Pull Requests sind im oberen Bereich jeder Seit ### Weiterführende Informationen -- {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}„[Deine Abonnements ansehen](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions#reviewing-repositories-that-youre-watching){% else %}„[Liste der von Dir beobachteten Repositorys](/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching){% endif %}" +- {% 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#reviewing-repositories-that-youre-watching){% else %}”[Listing the repositories you're watching](/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching){% endif %}" diff --git a/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/about-email-notifications.md b/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/about-email-notifications.md index eaad488860f2..0928cb359159 100644 --- a/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/about-email-notifications.md +++ b/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/about-email-notifications.md @@ -15,21 +15,21 @@ Nach der Aktivierung von E-Mail-Benachrichtigungen sendet Dir {% data variables. ### E-Mail-Benachrichtigungen filtern -Jede E-Mail-Benachrichtigung, die {% data variables.product.product_name %} sendet, enthält Headerinformationen. Die Headerinformationen in jeder E-Mail sind einheitlich, sodass Sie sie in Ihrem E-Mail-Client verwenden können, um alle {% data variables.product.product_name %}-Benachrichtigungen oder bestimmte Arten von {% data variables.product.product_name %}-Benachrichtigungen zu filtern oder weiterzuleiten. +Jede E-Mail-Benachrichtigung, die {% data variables.product.product_name %} sendet, enthält Headerinformationen. Die Header-Informationen in jeder E-Mail sind einheitlich, sodass Du sie in Deinem E-Mail-Client verwenden kannst, um alle {% data variables.product.product_name %}-Benachrichtigungen oder bestimmte Arten von {% data variables.product.product_name %}-Benachrichtigungen zu filtern oder weiterzuleiten. E-Mail-Benachrichtigungen von {% data variables.product.product_name %} enthalten die folgenden Headerinformationen: -| Header | Informationen | -| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `From`-Adresse | Diese Adresse wird immer die von Deinem Administrator konfigurierte „No-Reply-E-Mail-Adresse" sein. | -| `To`-Feld | Dieses Feld ist direkt mit dem Thread verknüpft. Wenn Du auf die E-Mail antwortest, fügst Du der Unterhaltung einen neuen Kommentar hinzu. | -| `Cc`-Adresse | {% data variables.product.product_name %} fügt Dich zu `Cc` hinzu, wenn Du eine Unterhaltung abonniert hast. Die zweite E-Mail-Adresse in `Cc` entspricht dem Benachrichtigungsgrund. Das Suffix für diese Benachrichtigungsgründe lautet {% data variables.notifications.cc_address %}. Zu den möglichen Benachrichtigungsgründen gehören folgende:
    • `assign`: Dir wurde ein Issue oder Pull Request zugewiesen.
    • `author`: Du hast einen Issue oder Pull Request erstellt.
    • `comment`: Du hast einen Issue oder Pull Request kommentiert.
    • `manual`: Ein Issue oder Pull Request, den Du manuell abonniert hast, wurde aktualisiert.
    • `mention`: Du wurdest in einem Issue oder Pull Request erwähnt.
    • `push`: Jemand hat einen Commit für einen Pull Request erstellt, den Du abonniert hast.
    • `review_requested`: Du oder ein Team, dem Du angehörst, wurdest/wurde gebeten, einen Review für einen Pull Request durchzuführen.
    • `security_alert`: {% data variables.product.prodname_dotcom %} hat eine Schwachstelle in einem Repository erkannt, für das Du Sicherheitswarnungen erhältst.
    • `state_change`: Ein Issue oder Pull Request, den Du abonniert hast, wurde entweder geschlossen oder geöffnet.
    • `subscribed`: Es gab eine Aktualisierung in einem Repository, das Du beobachtest.
    • `team_mention`: Ein Team, dem Du angehörst, wurde in einem Issue oder Pull Request erwähnt.
    • `your_activity`: Du hast einen Issue oder Pull Request geöffnet, kommentiert oder geschlossen.
    | -| `mailing list`-Feld | In diesem Feld werden der Name des Repositorys und sein Inhaber identifiziert. Das Format dieser Adresse lautet immer `..{% data variables.command_line.backticks %}`. |{% if currentVersion ver_gt "enterprise-server@2.19" % %} -| `X-GitHub-Severity`-Feld | {% data reusables.repositories.security-alerts-x-github-severity %} Die möglichen Schweregrade sind:
    • `low`
    • `moderate`
    • `high`
    • `critical`
    For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." | |{% endif %} +| Header | Informationen | +| --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `From`-Adresse | Diese Adresse wird immer die von Deinem Administrator konfigurierte „No-Reply-E-Mail-Adresse" sein. | +| `To`-Feld | Dieses Feld ist direkt mit dem Thread verknüpft. Wenn Du auf die E-Mail antwortest, fügst Du der Unterhaltung einen neuen Kommentar hinzu. | +| `Cc`-Adresse | {% data variables.product.product_name %} fügt Sie zu `Cc` hinzu, wenn Sie eine Unterhaltung abonniert haben. Die zweite E-Mail-Adresse in `Cc` entspricht dem Benachrichtigungsgrund. Das Suffix für diese Benachrichtigungsgründe lautet {% data variables.notifications.cc_address %}. Zu den möglichen Benachrichtigungsgründen gehören folgende:
    • `assign`: Dir wurde ein Issue oder Pull Request zugewiesen.
    • `author`: Du hast einen Issue oder Pull Request erstellt.
    • `comment`: Du hast einen Issue oder Pull Request kommentiert.
    • `manual`: Ein Issue oder Pull Request, den Du manuell abonniert hast, wurde aktualisiert.
    • `mention`: Du wurdest in einem Issue oder Pull Request erwähnt.
    • `push`: Jemand hat einen Commit für einen Pull Request erstellt, den Du abonniert hast.
    • `review_requested`: Du oder ein Team, dem Du angehörst, wurdest/wurde gebeten, einen Review für einen Pull Request durchzuführen.
    • `security_alert`: {% data variables.product.prodname_dotcom %} hat eine Schwachstelle in einem Repository erkannt, für das Du Sicherheitswarnungen erhältst.
    • `state_change`: Ein Issue oder Pull Request, den Du abonniert hast, wurde entweder geschlossen oder geöffnet.
    • `subscribed`: Es gab eine Aktualisierung in einem Repository, das Du beobachtest.
    • `team_mention`: Ein Team, dem Du angehörst, wurde in einem Issue oder Pull Request erwähnt.
    • `your_activity`: Du hast einen Issue oder Pull Request geöffnet, kommentiert oder geschlossen.
    | +| `mailing list`-Feld | In diesem Feld werden der Name des Repositorys und sein Inhaber identifiziert. Das Format dieser Adresse lautet immer `..{% data variables.command_line.backticks %}`. |{% if currentVersion ver_gt "enterprise-server@2.19" % %} +| `X-GitHub-Severity`-Feld | {% data reusables.repositories.security-alerts-x-github-severity %} Die möglichen Schweregrade sind:
    • `low`
    • `moderate`
    • `high`
    • `critical`
    For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." | |{% endif %} ### Weiterführende Informationen - „[Repositorys auflisten, die Du beobachtest](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching)" - „[Beobachten von Repositorys aktivieren oder deaktivieren](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories)" -- „[Abonnieren und Kündigen von Benachrichtigungen](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)"{% if currentVersion ver_gt "enterprise-server@2.17" %} -- „[Gists erstellen](/articles/creating-gists)“{% endif %} +- „[Abonnieren oder Kündigen von Benachrichtigungen](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)" +- „[Gists erstellen](/articles/creating-gists)“ diff --git a/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/about-notifications.md b/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/about-notifications.md index 3133caa8a418..876a283fc9b7 100644 --- a/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/about-notifications.md +++ b/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/about-notifications.md @@ -1,6 +1,6 @@ --- title: Informationen zu Benachrichtigungen -intro: 'Benachrichtigungen bieten aktuelle Informationen zu den Aktivitäten und Unterhaltungen, an denen Du interessiert bist. Du kannst Benachrichtigungen auf {% data variables.product.product_name %} oder über Deinen E-Mail-Client erhalten.' +intro: 'Benachrichtigungen bieten aktuelle Informationen zu den Aktivitäten und Unterhaltungen, an denen Du interessiert bist. Sie können Benachrichtigungen auf {% data variables.product.product_name %} empfangen oder über Ihren E-Mail-Client.' versions: enterprise-server: <2.21 --- @@ -33,9 +33,8 @@ Die Benachrichtigungen, die Du erhältst, sind entweder *Teilnahmebenachrichtigu #### Beobachtungsbenachrichtigungen -{% data variables.product.product_name %} versendet *Beobachtungsbenachrichtigungen* bei Aktualisierungen in Repositorys oder Teamdiskussionen, die Du gerade beobachtest. {% if currentVersion ver_gt "enterprise-server@2.17" %} {% data reusables.notifications.auto-watch %}Weitere Informationen findest Du auf „[Beobachtung von Repositorys aktivieren oder deaktivieren](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories)." - -{% endif %}In folgenden Fällen erhältst Du eine Benachrichtigung: +{% data variables.product.product_name %} versendet *Beobachtungsbenachrichtigungen* bei Aktualisierungen in Repositorys oder Teamdiskussionen, die Du gerade beobachtest. {% data reusables.notifications.auto-watch %}For more information, see "[Watching and unwatching repositories](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories)." +In folgenden Fällen erhältst Du eine Benachrichtigung: - Ein Issue wird geöffnet. - Ein Kommentar wird einem offenen Issue hinzugefügt. - Ein Pull Request wird geöffnet. @@ -53,4 +52,4 @@ Du kannst außerdem die Aktivitäten von Personen, denen Du folgst, von Reposito - „[Repositorys auflisten, die Du beobachtest](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching)" - „[Beobachten von Repositorys aktivieren oder deaktivieren](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories)" - „[Beobachten von Teamdiskussionen aktivieren oder deaktivieren](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions)" -- „[Abonnieren und Kündigen von Benachrichtigungen](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)" +- „[Abonnieren oder Kündigen von Benachrichtigungen](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)" diff --git a/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/about-web-notifications.md b/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/about-web-notifications.md index d0f2c159b184..32641ef90091 100644 --- a/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/about-web-notifications.md +++ b/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/about-web-notifications.md @@ -1,13 +1,13 @@ --- title: Informationen zu Webbenachrichtigungen -intro: 'Wenn Du Webbenachrichtigungen erhältst, kannst Du Deine Teilnahme- und Beobachtungsbenachrichtigungen auf der Benachrichtigungsseite auf {% data variables.product.product_name %} anzeigen.' +intro: 'Wenn Sie Webbenachrichtigungen erhalten, können Sie Ihre Teilnahme- und Beobachtungsbenachrichtigungen auf der Benachrichtigungsseite auf {% data variables.product.product_name %} anzeigen.' versions: enterprise-server: <2.21 --- Weitere Informationen über die Unterschiede zwischen *Teilnahmebenachrichtigungen* und *Beobachtungsbenachrichtigungen-* findest Du auf [Über Benachrichtigungen](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/about-notifications)." -Wenn Webbenachrichtigungen für Dein Konto aktiviert sind, kannst Du auf ein Element auf Deiner Benachrichtigungsseite klicken, woraufhin Du zu der Unterhaltung weitergeleitet wirst, auf die sich die Benachrichtigung bezieht. Wenn Webbenachrichtigungen für Dein Konto aktiviert sind, kannst Du auf ein Element auf Deiner Benachrichtigungsseite klicken, woraufhin Du zu der Unterhaltung weitergeleitet wirst, auf die sich die Benachrichtigung bezieht. Weitere Informationen zum Aktivieren von Webbenachrichtigungen findest du unter „[Auslieferungsmethode für Deine Benachrichtigungen wählen](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications)." +Wenn Webbenachrichtigungen für Dein Konto aktiviert sind, kannst Du auf ein Element auf Deiner Benachrichtigungsseite klicken, woraufhin Du zu der Unterhaltung weitergeleitet wirst, auf die sich die Benachrichtigung bezieht. For more information on enabling web notifications, see "[Choosing the delivery method for your notifications](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications)." Weitere Informationen zum Aktivieren von Webbenachrichtigungen findest du unter „[Auslieferungsmethode für Deine Benachrichtigungen wählen](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications)." {% data reusables.notifications.shared_state %} @@ -15,10 +15,10 @@ Auf Deiner Benachrichtigungsseite kannst Du Benachrichtigungen auch als gelesen - „[Benachrichtigung als gelesen markieren](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/marking-notifications-as-read)" - „[Benachrichtigung für später sichern](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/saving-notifications-for-later)" -- „[Abonnieren und Kündigen von Benachrichtigungen](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)" +- „[Abonnieren oder Kündigen von Benachrichtigungen](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)" ### Weiterführende Informationen - „[Repositorys auflisten, die Du beobachtest](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching)" - „[Beobachten von Repositorys aktivieren oder deaktivieren](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories)" -- „[Abonnieren und Kündigen von Benachrichtigungen](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)" +- „[Abonnieren oder Kündigen von Benachrichtigungen](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)" diff --git a/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/accessing-your-notifications.md b/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/accessing-your-notifications.md index 97740c086702..3d0c7b73e50a 100644 --- a/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/accessing-your-notifications.md +++ b/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/accessing-your-notifications.md @@ -1,6 +1,6 @@ --- title: Auf Deine Benachrichtigungen zugreifen -intro: 'Je nachdem, wie die Auslieferung Deiner Benachrichtigungen eingerichtet ist, kannst Du auf Deine Benachrichtigungen über {% data variables.product.product_name %} oder über Deinen E-Mail-Client zugreifen.' +intro: 'Je nachdem, wie die Auslieferung Ihrer Benachrichtigungen eingerichtet ist, können Sie auf Ihre Benachrichtigungen über {% data variables.product.product_name %} oder über Ihren E-Mail-Client zugreifen.' versions: enterprise-server: <2.21 --- diff --git a/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications.md b/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications.md index fa5975dfb1d6..8c62863cb665 100644 --- a/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications.md +++ b/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications.md @@ -1,6 +1,6 @@ --- title: Auslieferungsmethode für Deine Benachrichtigungen wählen -intro: 'Du kannst Benachrichtigungen auf {% data variables.product.product_location %} empfangen oder über Deinen E-Mail-Client.' +intro: 'Sie können Benachrichtigungen auf {% data variables.product.product_location %} empfangen oder über Ihren E-Mail-Client.' versions: enterprise-server: <2.21 --- diff --git a/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/getting-started-with-notifications.md b/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/getting-started-with-notifications.md index 10d957115387..6ef756f9b7b7 100644 --- a/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/getting-started-with-notifications.md +++ b/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/getting-started-with-notifications.md @@ -1,6 +1,6 @@ --- title: Erste Schritte mit Benachrichtigungen -intro: 'Mithilfe von Benachrichtigungen kannst Du Unterhaltungen und Aktualisierungen, die Dich interessieren, einfacher verfolgen. Du kannst Benachrichtigungen zu Unterhaltungen, an denen Du beteiligt bist, oder Aktualisierungen, die Du beobachtest, auf {% data variables.product.product_name %} oder über Deinen E-Mail-Client empfangen.' +intro: 'Mithilfe von Benachrichtigungen kannst Du Unterhaltungen und Aktualisierungen, die Dich interessieren, einfacher verfolgen. Sie können Benachrichtigungen zu Unterhaltungen, an denen Sie beteiligt sind, oder Aktualisierungen, die Sie beobachten, auf {% data variables.product.product_name %} oder über Ihren E-Mail-Client empfangen.' mapTopic: true versions: enterprise-server: <2.21 diff --git a/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching.md b/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching.md index 46e10db53a4e..bf1f22da5d92 100644 --- a/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching.md +++ b/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching.md @@ -1,6 +1,6 @@ --- title: Die von Dir beobachteten Repositorys auflisten -intro: 'Du kannst eine Übersicht aller Repositorys anzeigen, die Du beobachtest. So kannst Du leichter Repositorys entfernen, zu denen Du keine Benachrichtigungen mehr erhalten möchtest.' +intro: Du kannst eine Übersicht aller Repositorys anzeigen, die Du beobachtest. So kannst Du leichter Repositorys entfernen, zu denen Du keine Benachrichtigungen mehr erhalten möchtest. versions: enterprise-server: <2.21 --- diff --git a/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications.md b/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications.md index 3b0b1dafca05..213413db8fe3 100644 --- a/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications.md +++ b/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications.md @@ -7,21 +7,12 @@ versions: ### Benachrichtigungseinstellungen für ein Issue oder einen Pull Request verwalten -{% if currentVersion ver_lt "enterprise-server@2.18" %}Wenn Du eine Unterhaltung zu einem Issue oder Pull Request abonnierst, erhältst Du bei jeder Aktualisierung der Unterhaltung eine Benachrichtigung, selbst wenn Du nicht an der Unterhaltung teilnimmst. - -Sobald Du das Abonnement einer Unterhaltung zu einem Issue oder Pull Request kündigst, werden diese Benachrichtigungen eingestellt. Sollten jedoch Du oder ein Team, dessen Mitglied Du bist, in der Unterhaltung @erwähnt werden, erhältst Du diese Benachrichtigungen wieder. Weitere Informationen zu @Erwähnungen findest Du unter „[Grundlegende Schreib- und Formatierungssyntax](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams)“.{% endif %} - {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issue-pr %} -3. Wähle einen Issue oder Pull Request, den Du abonnieren möchtest. -{% if currentVersion ver_gt "enterprise-server@2.17" %} +3. Wählen Sie einen Issue oder Pull Request, den Sie abonnieren möchten. 4. Klicke in der rechten Seitenleiste auf **Subscribe** (Abonnieren) oder **Unsubscribe** (Kündigen). ![Schaltfläche „Conversation Subscribe" (Abonnieren einer Unterhaltung)](/assets/images/help/notifications/subscribe_button_with_gear.png) 5. Klicken Sie zum Anpassen Ihrer Benachrichtigungen auf {% octicon "gear" aria-label="The gear icon" %}. ![Einstellungsschaltfläche neben „Subscribe“ (Abonnieren einer Unterhaltung)](/assets/images/help/notifications/subscribe_button_with_gear_chosen.png) -6. Wähle die Art von Benachrichtigungen aus, die Du zu dieser Unterhaltung erhalten möchtest, und klicke auf **Save** (Speichern). ![Liste der Optionen für das Abonnieren einer Unterhaltung](/assets/images/help/notifications/subscribe_options.png) -{% else %} -4. Klicke zum Abonnieren respektive zum Kündigen einer Unterhaltung in der rechten Seitenleiste auf **Subscribe** (Abonnieren) respektive **Unsubscribe** (Kündigen). ![Schaltfläche „Conversation Subscribe" (Abonnieren einer Unterhaltung)](/assets/images/help/notifications/subscribe_button.png) -{% endif %} -Du kannst eine Liste aller abonnierten Issues und Pull Requests abrufen. Weitere Informationen findest Du unter „[Liste Deiner abonnierten Issues und Pull Requests abrufen](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-issues-and-pull-requests-youre-subscribed-to)." +6. Wähle die Art von Benachrichtigungen aus, die Du zu dieser Unterhaltung erhalten möchtest, und klicke auf **Save** (Speichern). ![Conversation Subscribe options list](/assets/images/help/notifications/subscribe_options.png) You can see a list of all the issues and pull requests you're subscribed to. Weitere Informationen findest Du unter „[Liste Deiner abonnierten Issues und Pull Requests abrufen](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-issues-and-pull-requests-youre-subscribed-to)." ### Teamdiskussionen abonnieren diff --git a/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-releases-for-a-repository.md b/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-releases-for-a-repository.md index c9cb557f125f..db3dd88bf002 100644 --- a/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-releases-for-a-repository.md +++ b/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-releases-for-a-repository.md @@ -1,6 +1,6 @@ --- title: Beobachtung von Releases für ein Repository aktivieren oder deaktivieren -intro: 'Du kannst Releases in einem Repository beobachten, um Benachrichtigungen zu erhalten, wenn ein neuer Release veröffentlicht wird, ohne dass Benachrichtigungen zu anderen Updates am Repository empfangen werden. Darüber hinaus kannst Du die Beobachtung von Releases beenden, wenn Du keine weiteren Benachrichtigungen für neue Releases in einem Repository erhalten möchtest.' +intro: Du kannst Releases in einem Repository beobachten, um Benachrichtigungen zu erhalten, wenn ein neuer Release veröffentlicht wird, ohne dass Benachrichtigungen zu anderen Updates am Repository empfangen werden. Darüber hinaus kannst Du die Beobachtung von Releases beenden, wenn Du keine weiteren Benachrichtigungen für neue Releases in einem Repository erhalten möchtest. versions: enterprise-server: <2.21 --- diff --git a/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories.md b/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories.md index cf7b26b00c6a..b887b58ebb29 100644 --- a/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories.md +++ b/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories.md @@ -1,13 +1,11 @@ --- title: Beobachtungen für Repositorys aktivieren und deaktivieren -intro: 'Du kannst ein Repository beobachten, um Benachrichtigungen für neu erstellte Pull Requests und Issues zu erhalten. Darüber hinaus kannst Du die Beobachtung eines Repositorys beenden, wenn Du keine weiteren Benachrichtigungen für dieses bestimmte Repository erhalten möchtest.' +intro: Du kannst ein Repository beobachten, um Benachrichtigungen für neu erstellte Pull Requests und Issues zu erhalten. Darüber hinaus kannst Du die Beobachtung eines Repositorys beenden, wenn Du keine weiteren Benachrichtigungen für dieses bestimmte Repository erhalten möchtest. versions: enterprise-server: <2.21 --- -{% if currentVersion ver_gt "enterprise-server@2.17" %} {% data reusables.notifications.auto-watch %} Weitere Informationen findest Du unter „[Über Benachrichtigungen](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/about-notifications)." -{% endif %} Zudem kannst Du Releases in einem Repository beobachten und deren Beobachtung beenden. Weitere Informationen findest Du unter „[Beobachtung von Repositorys aktivieren oder deaktivieren](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-releases-for-a-repository)." @@ -35,11 +33,11 @@ Zudem kannst Du Releases in einem Repository beobachten und deren Beobachtung be {% note %} -**Hinweis:**Du kannst auch auswählen, dass ein Repository ignoriert werden soll. Wenn Du ein Repository ignorierst, erhältst du keine Benachrichtigungen. Es wird nicht empfohlen, Repositorys zu ignorieren, da Du in diesem Fall auch keine Benachrichtigung erhältst, wenn Du @erwähnt wirst. {% if currentVersion == "free-pro-team@latest" %}Wenn du Missbrauch feststellst und ein Repository ignorieren willst, [kontaktiere bitte den Support](/contact), damit wir Dir helfen können. {% data reusables.policies.abuse %}{% endif %} +**Hinweis:**Du kannst auch auswählen, dass ein Repository ignoriert werden soll. Wenn Du ein Repository ignorierst, erhältst du keine Benachrichtigungen. Es wird nicht empfohlen, Repositorys zu ignorieren, da Du in diesem Fall auch keine Benachrichtigung erhältst, wenn Du @erwähnt wirst. {% if currentVersion == "free-pro-team@latest" %}If you experiencing abuse and want to ignore a repository, please [contact support](/contact) so we can help. {% data reusables.policies.abuse %}{% endif %} {% endnote %} ### Weiterführende Informationen -- „[Abonnieren und Kündigen von Benachrichtigungen](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)" +- „[Abonnieren oder Kündigen von Benachrichtigungen](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)" - „[Repositorys auflisten, die Du beobachtest](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching)" diff --git a/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md b/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md index 458c3ba602b0..cdf5fbc08bf6 100644 --- a/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md +++ b/translations/de-DE/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md @@ -1,6 +1,6 @@ --- title: Beobachtung von Teamdiskussionen aktivieren und deaktivieren -intro: 'Du kannst ein Team beobachten, um Benachrichtigungen zu Teamdiskussionen zu erhalten. Du kannst die Beobachtung eines Teams beenden, wenn Du keine weiteren Benachrichtigungen zu den Diskussionen dieses Teams erhalten möchtest.' +intro: Du kannst ein Team beobachten, um Benachrichtigungen zu Teamdiskussionen zu erhalten. Du kannst die Beobachtung eines Teams beenden, wenn Du keine weiteren Benachrichtigungen zu den Diskussionen dieses Teams erhalten möchtest. versions: enterprise-server: <2.21 --- @@ -21,33 +21,37 @@ Lege Deine Benachrichtigungseinstellungen für die automatische Beobachtung fest {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.notifications %} -{% data reusables.user_settings.automatic_watching_box %} Aktiviere das Kontrollkästchen **Automatically watch teams** (Teams automatisch beobachten). ![Kontrollkästchen zum automatischen Beobachten von Teams](/assets/images/help/notifications/automatic-team-discussions-watching.png) +{% data reusables.user_settings.automatic_watching_box %} Aktivieren Sie das Kontrollkästchen **Automatically watch teams** (Teams automatisch beobachten). +![Kontrollkästchen zum automatischen Beobachten von Teams](/assets/images/help/notifications/automatic-team-discussions-watching.png) ### Diskussionen eines einzelnen Teams beobachten {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.specific_team %} -{% data reusables.organizations.watch-team-options %} Klicke auf **Watch** (Beobachten), um die Benachrichtigungsoptionen zu öffnen. Klicke dann auf **Watching** (Beobachten). ![Beobachtungsoptionen in einem Dropdownmenü für ein spezifisches Team](/assets/images/help/notifications/specific-team-watch-options.png) +{% data reusables.organizations.watch-team-options %} Öffnen Sie die Benachrichtigungsoptionen mit **Watch** (Beobachten). Klicke dann auf **Watching** (Beobachten). +![Beobachtungsoptionen in einem Dropdownmenü für ein spezifisches Team](/assets/images/help/notifications/specific-team-watch-options.png) ### Beobachtung von Teamdiskussionen für alle neuen Teams beenden, denen Du beitrittst -Wenn Du nicht möchtest, dass Du beim Beitritt zu einem Team automatisch Benachrichtigungen zu Teamdiskussionen erhältst, kannst Du Deine Benachrichtigungseinstellungen so ändern, dass die Beobachtung sämtlicher neuer Teams, denen Du beitrittst, beendet wird. +Wenn Sie nicht möchten, dass Sie beim Beitritt zu einem Team automatisch Benachrichtigungen zu Teamdiskussionen erhalten, können Sie Ihre Benachrichtigungseinstellungen so ändern, dass die Beobachtung sämtlicher neuer Teams, denen Sie beitreten, beendet wird. {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.notifications %} -{% data reusables.user_settings.automatic_watching_box %} Deaktiviere das Kontrollkästchen **Automatically watch teams** (Teams automatisch beobachten). ![Standardmäßig ausgewählte Einstellung zum automatischen Beobachten von Teams](/assets/images/help/notifications/automatic-team-discussions-watching.png) +{% data reusables.user_settings.automatic_watching_box %} Deaktivieren Sie das Kontrollkästchen **Automatically watch teams** (Teams automatisch beobachten). +![Standardmäßig ausgewählte Einstellung zum automatischen Beobachten von Teams](/assets/images/help/notifications/automatic-team-discussions-watching.png) ### Beobachtung der Diskussionen eines einzelnen Teams beenden {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.specific_team %} -{% data reusables.organizations.watch-team-options %} Klicke auf **Unwatch** (Beobachtung beenden), um die Benachrichtigungsoptionen zu öffnen. Klicke anschließend auf **Not watching** (Nicht beobachten). ![Beobachtungsoptionen in einem Dropdownmenü für ein spezifisches Team](/assets/images/help/notifications/specific-team-unwatch.png) +{% data reusables.organizations.watch-team-options %} Öffnen Sie die Benachrichtigungsoptionen mit **Unwatch** (Beobachtung beenden). Klicke anschließend auf **Not watching** (Nicht beobachten). +![Beobachtungsoptionen in einem Dropdownmenü für ein spezifisches Team](/assets/images/help/notifications/specific-team-unwatch.png) {% note %} -**Hinweis:** Du kannst auch auswählen, dass die Benachrichtigungen eines Teams ignoriert werden sollen. Wenn Du ein Team ignorierst, erhältst Du keine Benachrichtigungen. Es wird nicht empfohlen, Teams zu ignorieren, da Du in diesem Fall auch keine Benachrichtigung erhältst, wenn Du @erwähnt wirst. +**Hinweis:** Du kannst auch auswählen, dass die Benachrichtigungen eines Teams ignoriert werden sollen. Wenn Sie ein Team ignorieren, erhalten Sie keine Benachrichtigungen. Es wird nicht empfohlen, Teams zu ignorieren, da Sie in diesem Fall keine Benachrichtigung erhalten, wenn Sie @erwähnt werden. {% endnote %} diff --git a/translations/de-DE/content/github/searching-for-information-on-github/about-searching-on-github.md b/translations/de-DE/content/github/searching-for-information-on-github/about-searching-on-github.md index d9fa5e24c061..d5e85419b55f 100644 --- a/translations/de-DE/content/github/searching-for-information-on-github/about-searching-on-github.md +++ b/translations/de-DE/content/github/searching-for-information-on-github/about-searching-on-github.md @@ -1,6 +1,6 @@ --- title: Informationen zur Suche auf GitHub -intro: 'Nutze unsere leistungsstarken Suchfunktionen, um unter den vielen Repositorys, Benutzern und Codezeilen auf {% data variables.product.product_name %} das zu finden, wonach Du suchst.' +intro: 'Our integrated search covers the many repositories, users, and lines of code on {% data variables.product.product_name %}.' redirect_from: - /articles/using-the-command-bar/ - /articles/github-search-basics/ @@ -24,6 +24,8 @@ Du kannst global über {% data variables.product.product_name %} hinweg suchen o - {% data reusables.search.required_login %} - {% data variables.product.prodname_pages %}-Websites können auf {% data variables.product.product_name %} nicht durchsucht werden. Du kannst aber den Quellinhalt mithilfe der Codesuche durchsuchen, wenn er im Standardbranch eines Repositorys vorhanden ist. Weitere Informationen findest Du unter „[Code durchsuchen](/articles/searching-code)“. Weitere Informationen über {% data variables.product.prodname_pages %} findest Du unter „[Was ist GitHub Pages?](/articles/what-is-github-pages/)“ +- Currently our search doesn't support exact matching. +- Whenever you are searching in code files, only the first two results in each file will be returned. {% endnote %} @@ -40,7 +42,7 @@ Du kannst die folgenden Arten von Informationen in allen öffentlichen {% data v - [Issues und Pull Requests](/articles/searching-issues-and-pull-requests) - [Code](/articles/searching-code) - [Commits](/articles/searching-commits) -- [Benutzer](/articles/searching-users){% if currentVersion == "free-pro-team@latest" %} +- [Users](/articles/searching-users){% if currentVersion == "free-pro-team@latest" %} - [Pakete](/github/searching-for-information-on-github/searching-for-packages){% endif %} - [Wikis](/articles/searching-wikis) diff --git a/translations/de-DE/content/github/searching-for-information-on-github/enabling-githubcom-repository-search-in-github-enterprise-server.md b/translations/de-DE/content/github/searching-for-information-on-github/enabling-githubcom-repository-search-in-github-enterprise-server.md index c74899135b4d..2c30646867a5 100644 --- a/translations/de-DE/content/github/searching-for-information-on-github/enabling-githubcom-repository-search-in-github-enterprise-server.md +++ b/translations/de-DE/content/github/searching-for-information-on-github/enabling-githubcom-repository-search-in-github-enterprise-server.md @@ -1,6 +1,6 @@ --- title: GitHub.com Repository-Suche in GitHub Enterprise Server aktivieren -intro: 'Sie kannst Deine persönlichen Konten für {% data variables.product.prodname_dotcom_the_website %} und {% data variables.product.prodname_ghe_server %} verbinden, um nach Inhalten in bestimmten privaten {% data variables.product.prodname_dotcom_the_website %}-Repositorys auf {% data variables.product.prodname_ghe_server %} zu suchen.' +intro: 'Sie können Ihre persönlichen Konten für {% data variables.product.prodname_dotcom_the_website %} und {% data variables.product.prodname_ghe_server %} verbinden, um nach Inhalten in bestimmten privaten {% data variables.product.prodname_dotcom_the_website %}-Repositorys auf {% data variables.product.prodname_ghe_server %} zu suchen.' redirect_from: - /articles/enabling-private-githubcom-repository-search-in-your-github-enterprise-account/ - /articles/enabling-private-github-com-repository-search-in-your-github-enterprise-server-account/ @@ -11,9 +11,9 @@ versions: enterprise-server: '*' --- -Wenn Du {% data variables.product.prodname_ghe_server %} und {% data variables.product.prodname_dotcom_the_website %} verwendest und Dein {% data variables.product.prodname_ghe_server %}-Websiteadministrator {% data variables.product.prodname_github_connect %} und {% data variables.product.prodname_unified_search %} für private Repositorys aktiviert hat, kannst Du nach bestimmten privaten Repositorys in der verbundenen Organisation suchen. +Wenn Sie {% data variables.product.prodname_ghe_server %} und {% data variables.product.prodname_dotcom_the_website %} verwenden und Ihr {% data variables.product.prodname_ghe_server %}-Websiteadministrator {% data variables.product.prodname_github_connect %} und {% data variables.product.prodname_unified_search %} für private Repositorys aktiviert hat, können Sie nach bestimmten privaten Repositorys in der verbundenen Organisation suchen. -Damit private Repositorys in den Suchergebnissen angezeigt werden, musst Du bereits auf diese Repositorys zugreifen können und Deine {% data variables.product.prodname_ghe_server %}- und {% data variables.product.prodname_dotcom_the_website %}-Konten miteinander verbunden haben. Weitere Informationen zu den Repositorys, die Dir für die Suche zur Verfügung stehen, findest Du unter „[{% data variables.product.prodname_ghe_server %} und {% data variables.product.prodname_dotcom_the_website %} gleichzeitig durchsuchen](/articles/about-searching-on-github/#searching-across-github-enterprise-and-githubcom-simultaneously).“ +Damit private Repositorys in den Suchergebnissen angezeigt werden, musst Du bereits auf diese Repositorys zugreifen können und Deine {% data variables.product.prodname_ghe_server %}- und {% data variables.product.prodname_dotcom_the_website %}-Konten miteinander verbunden haben. Weitere Informationen zu den Repositorys, die Ihnen für die Suche zur Verfügung stehen, finden Sie unter „[{% data variables.product.prodname_ghe_server %} und {% data variables.product.prodname_dotcom_the_website %} gleichzeitig durchsuchen](/articles/about-searching-on-github/#searching-across-github-enterprise-and-githubcom-simultaneously)“. {% data reusables.github-connect.access-dotcom-and-enterprise %} {% data reusables.github-connect.access-profile-settings %} diff --git a/translations/de-DE/content/github/searching-for-information-on-github/searching-code.md b/translations/de-DE/content/github/searching-for-information-on-github/searching-code.md index f875b53c5cad..3eec648e7523 100644 --- a/translations/de-DE/content/github/searching-for-information-on-github/searching-code.md +++ b/translations/de-DE/content/github/searching-for-information-on-github/searching-code.md @@ -1,6 +1,6 @@ --- title: Code durchsuchen -intro: 'Auf {% data variables.product.product_name %} kannst Du Code durchsuchen und die Suchergebnisse mit den folgenden Qualifizierern der Codesuche in beliebiger Kombination eingrenzen.' +intro: 'Auf {% data variables.product.product_name %} können Sie Code durchsuchen und die Suchergebnisse mit den folgenden Kennzeichnern der Codesuche in beliebiger Kombination eingrenzen.' redirect_from: - /articles/searching-code - /github/searching-for-information-on-github/searching-files-in-a-repository-for-exact-matches @@ -10,7 +10,7 @@ versions: enterprise-server: '*' --- -Du kannst Code global auf {% data variables.product.product_name %} oder in bestimmten Repositorys oder Organisationen durchsuchen. Um den Code aller öffentlichen Repositorys zu durchsuchen, musst Du bei einem {% data variables.product.product_name %}-Konto angemeldet sein. Weitere Informationen findest Du unter „[Informationen zur Suche auf GitHub](/articles/about-searching-on-github).“ +Sie können Code global auf {% data variables.product.product_name %} oder in bestimmten Repositorys oder Organisationen durchsuchen. Um den Code aller öffentlichen Repositorys zu durchsuchen, musst Du bei einem {% data variables.product.product_name %}-Konto angemeldet sein. Weitere Informationen findest Du unter „[Informationen zur Suche auf GitHub](/articles/about-searching-on-github).“ Du kannst Code nur mit den diesen Qualifizierern der Codesuche durchsuchen. Spezifische Qualifizierer für Repositorys, Benutzer oder Commits funktionieren bei der Durchsuchung von Code nicht. @@ -101,5 +101,5 @@ Der Kennzeichner `extension` sucht Codedateien mit einer bestimmten Dateierweite ### Weiterführende Informationen - „[Suchergebnisse sortieren](/articles/sorting-search-results/)“ -- „[Durchsuchen von Forks](/articles/searching-in-forks)"{% if currentVersion == "free-pro-team@latest" %} +- "[Searching in forks](/articles/searching-in-forks)"{% if currentVersion == "free-pro-team@latest" %} - „[Navigieren von Code auf {% data variables.product.prodname_dotcom %}](/github/managing-files-in-a-repository/navigating-code-on-github)"{% endif %} diff --git a/translations/de-DE/content/github/searching-for-information-on-github/searching-commits.md b/translations/de-DE/content/github/searching-for-information-on-github/searching-commits.md index b311880efad6..8cca1c541436 100644 --- a/translations/de-DE/content/github/searching-for-information-on-github/searching-commits.md +++ b/translations/de-DE/content/github/searching-for-information-on-github/searching-commits.md @@ -1,6 +1,6 @@ --- title: Commits durchsuchen -intro: 'Auf {% data variables.product.product_name %} kannst Du Commits durchsuchen und die Suchergebnisse mit den folgenden Qualifizierern der Commit-Suche in beliebiger Kombination eingrenzen.' +intro: 'Auf {% data variables.product.product_name %} können Sie Commits durchsuchen und die Suchergebnisse mit den folgenden Kennzeichnern der Commit-Suche in beliebiger Kombination eingrenzen.' redirect_from: - /articles/searching-commits versions: @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -Du kannst Commits global auf {% data variables.product.product_name %} oder in bestimmten Repositorys oder Organisationen durchsuchen. Weitere Informationen findest Du unter „[Informationen zur Suche auf {% data variables.product.company_short %}](/articles/about-searching-on-github).“ +Sie können Commits global auf {% data variables.product.product_name %} oder in bestimmten Repositorys oder Organisationen durchsuchen. Weitere Informationen findest Du unter „[Informationen zur Suche auf {% data variables.product.company_short %}](/articles/about-searching-on-github).“ Bei der Suche nach Commits wird nur der [Standardbranch](/articles/about-branches) eines Repositorys durchsucht. diff --git a/translations/de-DE/content/github/searching-for-information-on-github/searching-for-packages.md b/translations/de-DE/content/github/searching-for-information-on-github/searching-for-packages.md index 26feacf40ea5..e0b586ee30b9 100644 --- a/translations/de-DE/content/github/searching-for-information-on-github/searching-for-packages.md +++ b/translations/de-DE/content/github/searching-for-information-on-github/searching-for-packages.md @@ -2,7 +2,7 @@ title: Suche nach Paketen intro: 'Du kannst auf {% data variables.product.product_name %} nach Paketen suchen und die Suchresultate mit Qualifizierern einschränken.' product: '{% data reusables.gated-features.packages %}' -permissions: 'Jeder kann nach Paketen suchen, auf die er Zugriff hat.' +permissions: Jeder kann nach Paketen suchen, auf die er Zugriff hat. versions: free-pro-team: '*' enterprise-server: '>=2.22' @@ -15,7 +15,8 @@ versions: Du kannst global über das gesamte {% data variables.product.product_name %} nach Paketen suchen, oder nur innerhalb einer bestimmten Organisation. Weitere Informationen findest Du unter „[Informationen zur Suche auf {% data variables.product.prodname_dotcom %}](/articles/about-searching-on-github).“ {% if currentVersion != "free-pro-team@latest" %} -Um Pakete zu finden, die einem bestimmten Benutzer oder einer bestimmten Organisation gehören, benutze die Qualifizierer `user` oder `org`. +You can only search for packages on +{% data variables.product.product_location_enterprise %}, not {% data variables.product.prodname_dotcom_the_website %}, even if {% data variables.product.prodname_github_connect %} is enabled. {% endif %} {% data reusables.search.syntax_tips %} @@ -24,9 +25,9 @@ Um Pakete zu finden, die einem bestimmten Benutzer oder einer bestimmten Organis Um Pakete zu finden, die einem bestimmten Benutzer oder einer bestimmten Organisation gehören, benutze die Qualifizierer `user` oder `org`. -| Qualifizierer | Beispiel | -| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| user:USERNAME | [**user:codertocat**](https://github.com/search?q=user%3Acodertocat&type=RegistryPackages) findet Pakete die @codertocat gehören | +| Qualifizierer | Beispiel | +| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| user:USERNAME | [**user:codertocat**](https://github.com/search?q=user%3Acodertocat&type=RegistryPackages) findet Pakete die @codertocat gehören | | org:ORGNAME | [**org:github**](https://github.com/search?q=org%3Agithub&type=RegistryPackages) findet Pakete, die der {% data variables.product.prodname_dotcom %}-Organisation gehören | ### Pakete nach Sichtbarkeit filtern diff --git a/translations/de-DE/content/github/searching-for-information-on-github/searching-for-repositories.md b/translations/de-DE/content/github/searching-for-information-on-github/searching-for-repositories.md index f13b943fa987..9b7206007006 100644 --- a/translations/de-DE/content/github/searching-for-information-on-github/searching-for-repositories.md +++ b/translations/de-DE/content/github/searching-for-information-on-github/searching-for-repositories.md @@ -1,6 +1,6 @@ --- title: Nach Repositorys suchen -intro: 'Auf {% data variables.product.product_name %} kannst Du nach Repositorys suchen und die Suchergebnisse mit den folgenden Qualifizierern der Repository-Suche in beliebiger Kombination eingrenzen.' +intro: 'Auf {% data variables.product.product_name %} können Sie nach Repositorys suchen und die Suchergebnisse mit den folgenden Kennzeichnern der Repository-Suche in beliebiger Kombination eingrenzen.' redirect_from: - /articles/searching-repositories/ - /articles/searching-for-repositories @@ -9,7 +9,7 @@ versions: enterprise-server: '*' --- -Du kannst Repositorys global auf {% data variables.product.product_name %} oder in einer bestimmten Organisation durchsuchen. Weitere Informationen findest Du unter „[Informationen zur Suche auf {% data variables.product.prodname_dotcom %}](/articles/about-searching-on-github).“ +Sie können Repositorys global auf {% data variables.product.product_name %} oder in einer bestimmten Organisation durchsuchen. Weitere Informationen findest Du unter „[Informationen zur Suche auf {% data variables.product.prodname_dotcom %}](/articles/about-searching-on-github).“ Um Forks in die Suchergebnisse einzuschließen, musst du Deiner Abfrage den Qualifizierer `fork:true` oder `fork:only` hinzufügen. Weitere Informationen finden Sie unter „[Forks durchsuchen](/articles/searching-in-forks)“. @@ -146,7 +146,7 @@ Du kannst Deine Suche danach filtern, ob ein Repository öffentlich oder privat ### Suche auf Basis der Spiegelung eines Repositorys -Du kannst Repositorys danach durchsuchen, ob sie ein Spiegel sind und an anderer Stelle gehostet werden. Weitere Informationen findest Du unter „[Möglichkeiten finden, um Beiträge zu Open-Source auf {% data variables.product.prodname_dotcom %} zu leisten](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github) ." +Du kannst Repositorys danach durchsuchen, ob sie ein Spiegel sind und an anderer Stelle gehostet werden. Weitere Informationen findest du unter „[Möglichkeiten finden, Beiträge an Open-Source auf {% data variables.product.prodname_dotcom %} zu leisten](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)." | Qualifizierer | Beispiel | | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | diff --git a/translations/de-DE/content/github/searching-for-information-on-github/searching-issues-and-pull-requests.md b/translations/de-DE/content/github/searching-for-information-on-github/searching-issues-and-pull-requests.md index 8cd6836986ab..4c609b8154a4 100644 --- a/translations/de-DE/content/github/searching-for-information-on-github/searching-issues-and-pull-requests.md +++ b/translations/de-DE/content/github/searching-for-information-on-github/searching-issues-and-pull-requests.md @@ -1,6 +1,6 @@ --- title: Issues und Pull Requests durchsuchen -intro: 'Auf {% data variables.product.product_name %} kannst Du nach Issues und Pull Requests suchen und die Suchergebnisse mit den folgenden Qualifizierern in beliebiger Kombination eingrenzen.' +intro: 'Auf {% data variables.product.product_name %} können Sie nach Issues und Pull Requests suchen und die Suchergebnisse mit den folgenden Suchkennzeichnern in beliebiger Kombination eingrenzen.' redirect_from: - /articles/searching-issues/ - /articles/searching-issues-and-pull-requests @@ -9,11 +9,11 @@ versions: enterprise-server: '*' --- -Du kannst global auf {% data variables.product.product_name %} oder in einer bestimmten Organisation nach Issues und Pull Requests suchen. Weitere Informationen findest Du unter „[Informationen zur Suche auf {% data variables.product.company_short %}](/articles/about-searching-on-github).“ +Sie können Issues und Pull Requests global auf {% data variables.product.product_name %} oder in einer bestimmten Organisation durchsuchen. Weitere Informationen findest Du unter „[Informationen zur Suche auf {% data variables.product.company_short %}](/articles/about-searching-on-github).“ {% tip %} -**Tipps:**{% if currentVersion != "free-pro-team@latest" %} +**Tips:**{% if currentVersion != "free-pro-team@latest" %} - Dieser Artikel enthält Beispielsuchen für die Website {% data variables.product.prodname_dotcom %}.com. Die gleichen Suchfilter kannst Du jedoch auch auf {% data variables.product.product_location_enterprise %} verwenden.{% endif %} - Eine Liste mit Suchsyntax, die Du jedem Qualifizierer hinzufügen kannst, um Deine Ergebnisse zu verbessern, findest Du unter „[Grundlagen der Suchsyntax](/articles/understanding-the-search-syntax)“. - Schließe Suchbegriffe, die aus mehreren Wörtern bestehen, in Anführungszeichen ein. Möchtest Du beispielsweise nach Issues mit der Kennzeichnung „In progress“ suchen, gib `label:"in progress"` ein. Bei der Suche wird die Groß-/Kleinschreibung ignoriert. @@ -65,7 +65,7 @@ Mit dem Qualifizierer `state` oder `is` kannst Du Issues und Pull Requests danac ### Suche nach öffentlichen oder privaten Repositorys -Wenn Du [{% data variables.product.product_name %} vollständig durchsuchst](https://github.com/search), ist ein Filtern der Ergebnisse nach öffentlichen oder privaten Repositorys oft sehr nützlich. Hierzu verwendest Du die Qualifizierer `is:public` und `is:private`. +Wenn Sie [{% data variables.product.product_name %} vollständig durchsuchen](https://github.com/search), ist eine Filterung der Ergebnisse nach öffentlichen oder privaten Repositorys oft sehr nützlich. Hierzu verwendest Du die Qualifizierer `is:public` und `is:private`. | Qualifizierer | Beispiel | | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -229,7 +229,7 @@ Mit dem Qualifizierer `reactions` kannst Du Issues und Pull Requests nach der An ### Suche nach Pull-Request-Entwürfen Du kannst nach Pull-Request-Entwürfen suchen. Weitere Informationen findest Du unter „[Informationen zu Pull Requests](/articles/about-pull-requests#draft-pull-requests).“ -| Qualifizierer | Beispiel | ------------- | -------------{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} | `draft:true` | [**draft:true**](https://github.com/search?q=draft%3Atrue) findet Pull-Request-Entwürfe. | `draft:false` | [**draft:false**](https://github.com/search?q=draft%3Afalse) findet Pull Requests, die bereit sind für den Review.{% else %} | `is:draft` | [**is:draft**](https://github.com/search?q=is%3Adraft) findet Pull-Request-Entwürfe.{% endif %} +| Qualifier | Example | ------------- | -------------{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} | `draft:true` | [**draft:true**](https://github.com/search?q=draft%3Atrue) matches draft pull requests. | `draft:false` | [**draft:false**](https://github.com/search?q=draft%3Afalse) findet Pull Requests, die bereit sind für den Review.{% else %} | `is:draft` | [**is:draft**](https://github.com/search?q=is%3Adraft) findet Pull-Request-Entwürfe.{% endif %} ### Suche nach Review-Status und Reviewer eines Pull-Requests diff --git a/translations/de-DE/content/github/searching-for-information-on-github/searching-topics.md b/translations/de-DE/content/github/searching-for-information-on-github/searching-topics.md index 14942ebb56da..85f06c2143dd 100644 --- a/translations/de-DE/content/github/searching-for-information-on-github/searching-topics.md +++ b/translations/de-DE/content/github/searching-for-information-on-github/searching-topics.md @@ -1,6 +1,6 @@ --- title: Themen durchsuchen -intro: 'Auf {% data variables.product.product_name %} kannst Du Themen suchen, die Repositorys zugeordnet sind.' +intro: 'Auf {% data variables.product.product_name %} können Sie Themen suchen, die Repositorys zugeordnet sind.' redirect_from: - /articles/searching-topics versions: @@ -10,7 +10,7 @@ versions: ### {% data variables.product.product_name %} nach Themen durchsuchen -Du kannst auf {% data variables.product.product_name %} Themen suchen, zugehörige Themen untersuchen und ermitteln, wie viele Repositorys einem bestimmten Thema zugeordnet sind. +Sie können auf {% data variables.product.product_name %} Themen suchen, zugehörige Themen untersuchen und ermitteln, wie viele Repositorys einem bestimmten Thema zugeordnet sind. 1. Navigiere zu „https://github.com/search“. 2. Gib ein Stichwort zum Thema ein. ![Suchfeld](/assets/images/help/search/search-field.png) @@ -21,9 +21,9 @@ Du kannst auf {% data variables.product.product_name %} Themen suchen, zugehöri ### Suche durch Qualifizierer eingrenzen -Wenn Du in Repositorys bestimmte Themen suchst, um zu Projekten beizutragen, oder in Erfahrung bringen möchtest, welche Themen auf {% data variables.product.product_name %} besonders beliebt sind, kannst Du Themen mit den Qualifizierern `is:featured`, `is:curated`, `repositories:n` und `created:YYYY-MM-DD` durchsuchen. +Wenn Sie in Repositorys bestimmte Themen suchen, um zu Projekten beizutragen, oder in Erfahrung bringen möchten, welche Themen auf {% data variables.product.product_name %} besonders beliebt sind, können Sie Themen mit den Suchkennzeichnern `is:featured`, `is:curated`, `repositories:n` und `created:YYYY-MM-DD` durchsuchen. -Der Qualifizierer `is:featured` grenzt das Suchergebnis auf die Themen mit den meisten Repositorys auf {% data variables.product.product_name %} ein. Diese Themen werden auch auf „https://github.com/topics/“ vorgestellt. +Der Suchkennzeichner `is:featured` grenzt das Suchergebnis auf die Themen mit den meisten Repositorys auf {% data variables.product.product_name %} ein. Diese Themen werden auch auf „https://github.com/topics/“ vorgestellt. Der Qualifizierer `is:curated` grenzt das Suchergebnis auf Themen ein, zu denen Community-Mitglieder zusätzliche Informationen hinzugefügt haben. Weitere Informationen findest Du im Explore-Repository auf „https://github.com/github/explore“. diff --git a/translations/de-DE/content/github/searching-for-information-on-github/searching-users.md b/translations/de-DE/content/github/searching-for-information-on-github/searching-users.md index c0335ecbfd2e..82e772426529 100644 --- a/translations/de-DE/content/github/searching-for-information-on-github/searching-users.md +++ b/translations/de-DE/content/github/searching-for-information-on-github/searching-users.md @@ -1,6 +1,6 @@ --- title: Benutzer durchsuchen -intro: 'Auf {% data variables.product.product_name %} kannst Du Benutzer durchsuchen und die Suchergebnisse mit den nachfolgenden Qualifizierern der Benutzersuche in beliebiger Kombination eingrenzen.' +intro: 'Auf {% data variables.product.product_name %} können Sie Benutzer durchsuchen und die Suchergebnisse mit den folgenden Kennzeichnern der Benutzersuche in beliebiger Kombination eingrenzen.' redirect_from: - /articles/searching-users versions: @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -Du kannst auf {% data variables.product.product_name %} global nach Benutzern suchen. Weitere Informationen findest Du unter „[Informationen zur Suche auf {% data variables.product.company_short %}](/articles/about-searching-on-github).“ +Sie können auf {% data variables.product.product_name %} global nach Benutzern suchen. Weitere Informationen findest Du unter „[Informationen zur Suche auf {% data variables.product.company_short %}](/articles/about-searching-on-github).“ {% data reusables.search.syntax_tips %} diff --git a/translations/de-DE/content/github/searching-for-information-on-github/searching-wikis.md b/translations/de-DE/content/github/searching-for-information-on-github/searching-wikis.md index e6eac51281c9..e0fabbdbf284 100644 --- a/translations/de-DE/content/github/searching-for-information-on-github/searching-wikis.md +++ b/translations/de-DE/content/github/searching-for-information-on-github/searching-wikis.md @@ -1,6 +1,6 @@ --- title: Wikis durchsuchen -intro: 'Auf {% data variables.product.product_name %} kannst Du Wikis durchsuchen und die Suchergebnisse mit den nachfolgenden Qualifizierern der Wiki-Suche in beliebiger Kombination eingrenzen.' +intro: 'Auf {% data variables.product.product_name %} können Sie Wikis durchsuchen und die Suchergebnisse mit den folgenden Kennzeichnern der Wiki-Suche in beliebiger Kombination eingrenzen.' redirect_from: - /articles/searching-wikis versions: @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -Du kannst Wikis global auf {% data variables.product.product_name %} oder in bestimmten Repositorys oder Organisationen durchsuchen. Weitere Informationen findest Du unter „[Informationen zur Suche auf {% data variables.product.company_short %}](/articles/about-searching-on-github).“ +Sie können Wikis global auf {% data variables.product.product_name %} oder in bestimmten Repositorys oder Organisationen durchsuchen. Weitere Informationen findest Du unter „[Informationen zur Suche auf {% data variables.product.company_short %}](/articles/about-searching-on-github).“ {% data reusables.search.syntax_tips %} diff --git a/translations/de-DE/content/github/searching-for-information-on-github/sorting-search-results.md b/translations/de-DE/content/github/searching-for-information-on-github/sorting-search-results.md index 66a1b0d784ba..686ce4527fdc 100644 --- a/translations/de-DE/content/github/searching-for-information-on-github/sorting-search-results.md +++ b/translations/de-DE/content/github/searching-for-information-on-github/sorting-search-results.md @@ -1,6 +1,6 @@ --- title: Suchergebnisse sortieren -intro: 'Du kannst Ergebnisse der [{% data variables.product.product_name %}-Suche](/articles/searching-on-github) mit den Optionen des Menüs „Sortieren“ oder durch einen „sort“-Qualifizierer in der Abfrage sortieren.' +intro: 'Sie können Ergebnisse der [{% data variables.product.product_name %}-Suche](/articles/searching-on-github) mit den Optionen des Menüs „Sortieren“ oder durch einen „sort“-Kennzeichner in der Abfrage sortieren.' redirect_from: - /articles/sorting-search-results versions: @@ -18,8 +18,8 @@ Mit einem `sort`-Qualifizierer in der Abfrage kannst Du die Suchergebnisse nach Der Qualifizierer `sort:interactions` sortiert in absteigender Reihenfolge nach der Gesamtzahl der Reaktionen und Kommentare. -| Qualifizierer | Beispiel | -| ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Qualifizierer | Beispiel | +| ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sort:interactions` oder `sort:interactions-desc` | [**org:github sort:interactions**](https://github.com/search?q=org%3Agithub+sort%3Ainteractions&type=Issues) sucht Issues in {% data variables.product.product_name %}-Repositorys und sortiert sie in absteigender Reihenfolge nach der Gesamtzahl der Reaktionen und Kommentare. | | `sort:interactions-asc` | [**org:github sort:interactions-asc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Ainteractions-asc&type=Issues) sucht Issues in {% data variables.product.product_name %}-Repositorys und sortiert sie in aufsteigender Reihenfolge nach der Gesamtzahl der Reaktionen und Kommentare. | @@ -27,8 +27,8 @@ Der Qualifizierer `sort:interactions` sortiert in absteigender Reihenfolge nach Der Qualifizierer `sort:reactions` sortiert nach der Anzahl oder dem Typ der Reaktionen. -| Qualifizierer | Beispiel | -| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| Qualifizierer | Beispiel | +| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sort:reactions` oder `sort:reactions-desc` | [**org:github sort:reactions**](https://github.com/search?q=org%3Agithub+sort%3Areactions&type=Issues) sucht Issues in {% data variables.product.product_name %}-Repositorys und sortiert sie in absteigender Reihenfolge nach der Anzahl der Reaktionen. | | `sort:reactions-asc` | [**org:github sort:reactions-asc**](https://github.com/search?q=org%3Agithub+sort%3Areactions-asc&type=Issues) sucht Issues in {% data variables.product.product_name %}-Repositorys und sortiert sie in aufsteigender Reihenfolge nach der Anzahl der Reaktionen. | | sort:reactions-reaction | [**org:github sort:reactions-+1**](https://github.com/search?q=org%3Agithub+sort%3Areactions-%2B1&type=Issues) sucht Issues in {% data variables.product.product_name %}-Repositorys und sortiert sie in absteigender Reihenfolge nach der Anzahl der :+1:-Reaktionen (Daumen nach oben). | @@ -41,8 +41,8 @@ Der Qualifizierer `sort:reactions` sortiert nach der Anzahl oder dem Typ der Rea Der Qualifizierer `sort:author-date` sortiert in absteigender oder aufsteigender Reihenfolge nach dem Verfassungsdatum. -| Qualifizierer | Beispiel | -| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| Qualifizierer | Beispiel | +| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sort:author-date` oder `sort:author-date-desc` | [**feature org:github sort:author-date**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Aauthor-date&type=Commits) sucht Commits mit dem Wort „feature“ in {% data variables.product.product_name %}-Repositorys und sortiert sie in absteigender Reihenfolge nach dem Verfassungsdatum. | | `sort:author-date-asc` | [**feature org:github sort:author-date-asc**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Aauthor-date-asc&type=Commits) sucht Commits mit dem Wort „feature“ in {% data variables.product.product_name %}-Repositorys und sortiert sie in aufsteigender Reihenfolge nach dem Verfassungsdatum. | @@ -50,8 +50,8 @@ Der Qualifizierer `sort:author-date` sortiert in absteigender oder aufsteigender Der Qualifizierer `sort:committer-date` sortiert in absteigender oder aufsteigender Reihenfolge nach dem Commit-Datum. -| Qualifizierer | Beispiel | -| ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Qualifizierer | Beispiel | +| ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sort:committer-date` oder `sort:committer-date-desc` | [**feature org:github sort:committer-date**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Acommitter-date&type=Commits) sucht Commits mit dem Wort „feature“ in {% data variables.product.product_name %}-Repositorys und sortiert sie in absteigender Reihenfolge nach dem Commit-Datum. | | `sort:committer-date-asc` | [**feature org:github sort:committer-date-asc**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Acommitter-date-asc&type=Commits) sucht Commits mit dem Wort „feature“ in {% data variables.product.product_name %}-Repositorys und sortiert sie in aufsteigender Reihenfolge nach dem Commit-Datum. | diff --git a/translations/de-DE/content/github/searching-for-information-on-github/troubleshooting-search-queries.md b/translations/de-DE/content/github/searching-for-information-on-github/troubleshooting-search-queries.md index 7c56b9bc3a65..e19e3905c6b5 100644 --- a/translations/de-DE/content/github/searching-for-information-on-github/troubleshooting-search-queries.md +++ b/translations/de-DE/content/github/searching-for-information-on-github/troubleshooting-search-queries.md @@ -1,6 +1,6 @@ --- title: Fehlerbehebung bei Suchabfragen -intro: 'Wenn Deine Suche auf {% data variables.product.product_name %} zu unerwarteten Ergebnissen führt, ziehe zur Behebung dieser Fehler unsere Informationen zu häufigen Problemen und Einschränkungen bei der Suche zu Rate.' +intro: 'Wenn Ihre Suche auf {% data variables.product.product_name %} zu unerwarteten Ergebnissen führt, ziehen Sie zur Behebung dieser Fehler unsere Informationen zu häufigen Problemen und Einschränkungen der Abfragelänge zu Rate.' redirect_from: - /articles/troubleshooting-search-queries versions: diff --git a/translations/de-DE/content/github/searching-for-information-on-github/understanding-the-search-syntax.md b/translations/de-DE/content/github/searching-for-information-on-github/understanding-the-search-syntax.md index 8155822fe6d2..4bb646ffdf0a 100644 --- a/translations/de-DE/content/github/searching-for-information-on-github/understanding-the-search-syntax.md +++ b/translations/de-DE/content/github/searching-for-information-on-github/understanding-the-search-syntax.md @@ -1,6 +1,6 @@ --- title: Grundlagen der Suchsyntax -intro: 'Für Suchen auf {% data variables.product.product_name %} kannst Du Abfragen erstellen, die nach bestimmten alphanumerischen Zeichenfolgen suchen.' +intro: 'Für Suchen auf {% data variables.product.product_name %} können Sie Abfragen erstellen, die nach bestimmten alphanumerischen Zeichenfolgen suchen.' redirect_from: - /articles/search-syntax/ - /articles/understanding-the-search-syntax diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-git-large-file-storage.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-git-large-file-storage.md index 3849dd49e8e1..bb693fe8c93e 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-git-large-file-storage.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-git-large-file-storage.md @@ -1,6 +1,6 @@ --- title: Informationen zur Abrechnung für Git Large File Storage -intro: 'Wenn Du zusätzlichen Speicher und zusätzliche Bandbreite für {% data variables.large_files.product_name_long %} kaufst, gilt für Deinen Kauf das bestehende Abrechnungsdatum, die Zahlungsmethode und die Quittung Deines Kontos.' +intro: 'Wenn Sie zusätzlichen Speicher und zusätzliche Bandbreite für {% data variables.large_files.product_name_long %} kaufen, gilt für Ihren Kauf das bestehende Abrechnungsdatum, die Zahlungsmethode und die Quittung Ihres Kontos.' redirect_from: - /articles/about-billing-for-git-large-file-storage versions: diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-accounts.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-accounts.md index 2dbaa4cd763f..db5373c6b6ec 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-accounts.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-accounts.md @@ -18,7 +18,7 @@ Weitere Informationen zu den für Dein Konto verfügbaren Produkten findest Du u Du kannst zwischen einer monatlichen oder jährlichen Abrechnung wählen und Dein Abonnement jederzeit herauf- oder herabstufen. Weitere Informationen findest Du unter „[Abrechnung für Dein {% data variables.product.prodname_dotcom %}-Konto verwalten](/articles/managing-billing-for-your-github-account).“ -Du kannst andere Funktionen und Produkte mit Deinen vorhandenen {% data variables.product.product_name %}-Zahlungsinformationen erwerben. Weitere Informationen findest Du unter „[Informationen zur Abrechnung auf {% data variables.product.prodname_dotcom %}](/articles/about-billing-on-github).“ +Sie können andere Funktionen und Produkte mit Ihren vorhandenen {% data variables.product.product_name %}-Zahlungsinformationen erwerben. Weitere Informationen findest Du unter „[Informationen zur Abrechnung auf {% data variables.product.prodname_dotcom %}](/articles/about-billing-on-github).“ {% tip %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md index 8a470e901109..a664903e8859 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md @@ -12,8 +12,8 @@ versions: Minuten werden jeden Monat zurückgesetzt, während Speichernutzung dies nicht tut. -| Produkt | Speicher | Minuten (pro Monat) | -| ------------------------------------------------------------------------- | -------- | ------------------- | +| Produkt | Speicher | Minuten (pro Monat) | +| -------------------------------------------------------------------- | -------- | ------------------- | | {% data variables.product.prodname_free_user %} | 500 MB | 2.000 | | {% data variables.product.prodname_pro %} | 1 GB | 3.000 | | {% data variables.product.prodname_free_team %} für Organisationen | 500 MB | 2.000 | @@ -44,7 +44,7 @@ Der Speicher, der von einem Repository verbraucht wird, ist der gesamte Speicher | macOS | 0.08 $ | | Windows | 0.016 $ | -Die Anzahl der Aufträge, die Du gleichzeitig über alle Repositories in Deinem Benutzer- oder Organisationskonto ausführen kannst, hängt von Deinem GitHub-Plan ab. Weitere Informationen findest Du unter „[Über {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/about-github-actions/#usage-limits)." +Die Anzahl der Aufträge, die Du gleichzeitig über alle Repositories in Deinem Benutzer- oder Organisationskonto ausführen kannst, hängt von Deinem GitHub-Plan ab. For more information, see "[Usage limits and billing](/actions/reference/usage-limits-billing-and-administration)" for {% data variables.product.prodname_dotcom %}-hosted runners and "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)" for self-hosted runner usage limits. ### Minuten- und Speicherausgaben berechnen diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-marketplace.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-marketplace.md index 421dae590188..56ce39defc9e 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-marketplace.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-marketplace.md @@ -1,6 +1,6 @@ --- title: Informationen zur Abrechnung für GitHub Marketplace -intro: 'Wenn Du eine kostenpflichtige App in {% data variables.product.prodname_marketplace %} installierst, gilt für Dein Abonnement das bestehende Abrechnungsdatum, die Zahlungsmethode und die Quittung Deines Kontos.' +intro: 'Wenn Sie eine kostenpflichtige App in {% data variables.product.prodname_marketplace %} installieren, gilt für Ihr Abonnement das bestehende Abrechnungsdatum, die Zahlungsmethode und die Quittung Ihres Kontos.' redirect_from: - /articles/about-billing-for-github-marketplace versions: @@ -15,7 +15,7 @@ versions: ### Zahlungsmethoden und Abrechnungszeitraum für {% data variables.product.prodname_marketplace %}-Käufe -Du verwendest die gleiche Zahlungsmethode für alle kostenpflichtigen Pläne und Abonnements über {% data variables.product.prodname_dotcom %} hinweg. +Sie verwenden die gleiche Zahlungsmethode für alle kostenpflichtigen Pläne und Abonnements über {% data variables.product.prodname_dotcom %} hinweg. Wenn für Dein persönliches Konto oder Deine Organisation keine Zahlungsmethode hinterlegt ist und Du einen kostenpflichtigen Plan für eine App auswählst, gilt Folgendes: - Dein Abrechnungsdatum ist heute. @@ -26,13 +26,13 @@ Wenn für Dein persönliches Konto oder Deine Organisation keine Zahlungsmethode Wenn für Dein persönliches Konto oder Deine Organisation eine vorhandene Zahlungsmethode hinterlegt ist und Du einen kostenpflichtigen Plan für eine App auswählst, gilt Folgendes: - Basierend auf der verbleibenden Zeit bis zu Deinem nächsten Abrechnungsdatum wird sofort ein anteiliger Betrag über Deine hinterlegte Zahlungsmethode abgerechnet. - Das monatliche oder jährliche Abrechnungsdatum für Dein App-Abonnement ist das gleiche wie das reguläre Abrechnungsdatum des Kontos oder der Organisation. -- An Deinem nächsten Abrechnungsdatum werden auf Deiner Quittung die Gebühren für Deinen kostenpflichtigen {% data variables.product.prodname_dotcom %}-Plan und Dein App-Abonnement aufgeführt. +- An Ihrem nächsten Abrechnungsdatum werden auf Ihrer Quittung die Gebühren für Ihren kostenpflichtigen {% data variables.product.prodname_dotcom %}-Plan und Ihr App-Abonnement aufgeführt. Wenn Du einen kostenpflichtigen Plan mit einer kostenlosen Testperiode auswählst, gilt Folgendes: - Du musst eine bestehende Zahlungsmethode haben oder eine neue Zahlungsmethode für Dein persönliches Konto oder die Organisation hinzufügen, in dem Du die App installieren möchtest. - Wenn du keine weiteren kostenpflichtigen Pläne oder Abonnements hast, wird Dir am Ende der 14-tägigen kostenlosen Testperiode der volle Betrag Deines Abonnements berechnet. - Wenn Du weitere kostenpflichtige Pläne oder Abonnements hast, wird am Ende der 14-tägigen kostenlosen Testperiode basierend auf der verbleibenden Zeit bis zu Deinem nächsten Abrechnungsdatum sofort ein anteiliger Betrag über Deine hinterlegte Zahlungsmethode abgerechnet. -- Wenn Du weitere kostenpflichtige Pläne oder Abonnements hast, werden an Deinem nächsten Abrechnungsdatum auf Deiner Quittung die Gebühren für Deinen kostenpflichtigen {% data variables.product.prodname_dotcom %}-Plan und Deine App-Abonnements aufgeführt. +- Wenn Sie weitere kostenpflichtige Pläne oder Abonnements haben, werden an Ihrem nächsten Abrechnungsdatum auf Ihrer Quittung die Gebühren für Ihren kostenpflichtigen {% data variables.product.prodname_dotcom %}-Plan und Ihr App-Abonnement aufgeführt. ### Begrenzungen für einheitenbasierte Pläne diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md index ac6ff97bc95a..2e1963a2a67a 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md @@ -14,8 +14,8 @@ versions: Die Datenübertragung wird jeden Monat zurückgesetzt, während Speichernutzung dies nicht tut. -| Produkt | Speicher | Datenübertragung (pro Monat) | -| ------------------------------------------------------------------------- | -------- | ---------------------------- | +| Produkt | Speicher | Datenübertragung (pro Monat) | +| -------------------------------------------------------------------- | -------- | ---------------------------- | | {% data variables.product.prodname_free_user %} | 500 MB | 1 GB | | {% data variables.product.prodname_pro %} | 2 GB | 10 GB | | {% data variables.product.prodname_free_team %} für Organisationen | 500 MB | 1 GB | diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-on-github.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-on-github.md index b19ffe9e8c74..939a7d99b310 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-on-github.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-on-github.md @@ -1,6 +1,6 @@ --- title: Informationen zur Abrechnung auf GitHub -intro: 'Bei allem, was Du auf {% data variables.product.prodname_dotcom %} kaufst, gelten Abrechnungsdatum, Zahlungsmethode und Quittung Deines Kontos.' +intro: 'Bei allem, was Sie auf {% data variables.product.prodname_dotcom %} kaufen, gelten Abrechnungsdatum, Zahlungsmethode und Quittung Ihres Kontos.' redirect_from: - /articles/about-billing-on-github versions: @@ -9,7 +9,7 @@ versions: ### Kostenpflichtige Funktionen und Produkte -Du kannst Dein persönliches Konto oder Deine Organisation jederzeit auf ein kostenpflichtiges Abonnement heraufstufen. Du kannst auch Apps von {% data variables.product.prodname_marketplace %} kaufen oder Speicher und Bandbreite für {% data variables.large_files.product_name_long %} heraufstufen. Weitere Informationen findest Du unter: +Du kannst Dein persönliches Konto oder Deine Organisation jederzeit auf ein kostenpflichtiges Abonnement heraufstufen. Sie können auch Apps von {% data variables.product.prodname_marketplace %} kaufen oder Speicher und Bandbreite für {% data variables.large_files.product_name_long %} upgraden. Weitere Informationen findest Du unter: - „[Informationen zur Abrechnung für {% data variables.product.product_name %}-Konten](/articles/about-billing-for-github-accounts)“ - „[Informationen zur Abrechnung für {% data variables.product.prodname_marketplace %}](/articles/about-billing-for-github-marketplace)“ - „[Informationen zur Abrechnung für {% data variables.large_files.product_name_long %}](/articles/about-billing-for-git-large-file-storage)“ @@ -25,7 +25,7 @@ Weitere Informationen findest Du unter „[Deine {% data variables.product.prodn ### Weiterführende Informationen -- „[Abrechnung für Dein {% data variables.product.prodname_dotcom %}-Konto verwalten](/articles/managing-billing-for-your-github-account)“ +- „[Abrechnung für Ihr {% data variables.product.prodname_dotcom %}-Konto verwalten](/articles/managing-billing-for-your-github-account)“ - „[Abrechnung für Ihre {% data variables.product.prodname_marketplace %}-Apps verwalten](/articles/managing-billing-for-github-marketplace-apps)“ - „[Abrechnung für {% data variables.large_files.product_name_long %} verwalten](/articles/managing-billing-for-git-large-file-storage)“ - „[Abrechnung für {% data variables.product.prodname_sponsors %} verwalten](/articles/managing-billing-for-github-sponsors)“ diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-per-user-pricing.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-per-user-pricing.md index a723f9680aec..ebb188dc63db 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-per-user-pricing.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/about-per-user-pricing.md @@ -9,7 +9,7 @@ versions: Neue Unternehmen können mit {% data variables.product.prodname_free_team %} öffentliche und Open-Source-Projekte erstellen, oder zu einem kostenpflichtigen Produkt mit benutzerabhängiger Preisgestaltung [wechseln]({% data variables.product.pricing_url %}). -Organisationen mit einem kostenpflichtigen Abonnement vor dem 11. Mai 2016 können wählen, ob sie an ihrem bestehenden Abrechnungsplan pro Repository festhalten oder zu einer benutzerabhängigen Preisgestaltung wechseln möchten. Wir informieren Dich zwölf Monate vor jeder obligatorischen Änderung Deines Abonnements. Weitere Informationen zum Wechsel Deines Abonnements findest Du unter „[Dein {% data variables.product.prodname_dotcom %}-Abonnement heraufstufen](/articles/upgrading-your-github-subscription).“ +Organisationen mit einem kostenpflichtigen Abonnement vor dem 11. Mai 2016 können wählen, ob sie an ihrem bestehenden Abrechnungsplan pro Repository festhalten oder zu einer benutzerabhängigen Preisgestaltung wechseln möchten. Wir informieren Dich zwölf Monate vor jeder obligatorischen Änderung Deines Abonnements. Weitere Informationen zum Wechsel Ihres Abonnements finden Sie unter „[Ihr {% data variables.product.prodname_dotcom %}-Abonnement heraufstufen](/articles/upgrading-your-github-subscription)“. Weitere Informationen zu Produkten mit benutzerabhängiger Preisgestaltung findest Du unter „[Produkte von {% data variables.product.prodname_dotcom %}](/articles/githubs-products).“ @@ -23,13 +23,13 @@ Externe Mitarbeiter und Bot-Konten werden gegen die Gesamtzahl der bezahlten Liz Du kannst jederzeit bezahlte Lizenzen zu Deiner Organisation hinzufügen. Wenn Du für mehr Lizenzen bezahlst, als Du benutzt, kannst Du diese auch aus Deiner Organisation entfernen. Weitere Informationen findest Du unter „[Dein {% data variables.product.prodname_dotcom %}-Abonnements heraufstufen ](/articles/upgrading-your-github-subscription)“ und „[Dein {% data variables.product.prodname_dotcom %}-Abonnement herabstufen](/articles/downgrading-your-github-subscription).“ -Bei Fragen zum Abonnement Deiner Organisation wende Dich bitte an den {% data variables.contact.contact_support %}. +Bei Fragen zum Abonnement Ihrer Organisation wenden Sie sich bitte an den {% data variables.contact.contact_support %}. ### Wenn ich für meine Organisation einen Repository-abhängigen Abrechnungsplan habe, kann ich dann zu einem anderen Repository-abhängigen Abrechnungsplan wechseln? In den Abrechnungseinstellungen Deiner Organisation kannst Du zwischen den kostenpflichtigen Plänen wechseln. Wenn Du zu einem Plan mit mehr privaten Repositorys wechselst, übertragen wir Dein Konto sofort auf Deinen neuen Plan und berechnen Dir die Preisdifferenz anteilig für die Anzahl der Tage, die in Deinem Abrechnungszyklus verbleiben. -Wenn Du zu einem kostenpflichtigen Plan mit weniger privaten Repositorys wechselst, tritt Dein neuer Plan zum nächsten Abrechnungsdatum in Kraft. Wenn Du mehr private Repositorys hast, als Dein neuer Plan vorsieht, werden Deine privaten Repositorys gesperrt, sobald Dein neuer Plan in Kraft tritt. Um Deine Anzahl der privaten Repositorys zu reduzieren, kannst Du einige Deiner privaten Repositorys öffentlich machen, oder Du kannst Deine privaten Repositorys lokal klonen und die Kopien auf {% data variables.product.prodname_dotcom %} löschen. +Wenn Du zu einem kostenpflichtigen Plan mit weniger privaten Repositorys wechselst, tritt Dein neuer Plan zum nächsten Abrechnungsdatum in Kraft. Wenn Du mehr private Repositorys hast, als Dein neuer Plan vorsieht, werden Deine privaten Repositorys gesperrt, sobald Dein neuer Plan in Kraft tritt. Um Ihre Anzahl der privaten Repositorys zu reduzieren, können Sie einige Ihrer privaten Repositorys öffentlich machen, oder Sie können Ihre privaten Repositorys lokal klonen und die Kopien auf {% data variables.product.prodname_dotcom %} löschen. ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/adding-information-to-your-receipts.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/adding-information-to-your-receipts.md index 829aaaf61ed4..3649752d2bf3 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/adding-information-to-your-receipts.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/adding-information-to-your-receipts.md @@ -1,6 +1,6 @@ --- title: Informationen zu Quittungen hinzufügen -intro: 'Du kannst zusätzliche Informationen zu Deinen {% data variables.product.product_name %}-Quittungen hinzufügen, beispielsweise Steuer- oder Buchhaltungsinformationen, die in Deinem Unternehmen oder Land vorgeschrieben sind.' +intro: 'Sie können zusätzliche Informationen zu Ihren {% data variables.product.product_name %}-Quittungen hinzufügen, z. B. Steuer- oder Buchhaltungsinformationen, die in Ihrem Unternehmen oder Land vorgeschrieben sind.' redirect_from: - /articles/can-i-add-my-credit-card-number-to-my-receipts/ - /articles/can-i-add-extra-information-to-my-receipts--2/ @@ -15,7 +15,7 @@ versions: free-pro-team: '*' --- -Deine Quittungen enthalten Dein {% data variables.product.prodname_dotcom %}-Abonnement sowie alle Abonnements für [sonstige bezahlte Funktionen und Produkte](/articles/about-billing-on-github). +Ihre Quittungen enthalten Ihr {% data variables.product.prodname_dotcom %}-Abonnement sowie alle Abonnements für [sonstige bezahlte Funktionen und Produkte](/articles/about-billing-on-github). {% warning %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/canceling-a-github-marketplace-app.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/canceling-a-github-marketplace-app.md index 0d8520700422..b5ff6d83ace6 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/canceling-a-github-marketplace-app.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/canceling-a-github-marketplace-app.md @@ -1,6 +1,6 @@ --- title: Eine GitHub Marketplace-App kündigen -intro: 'Du kannst {% data variables.product.prodname_marketplace %}-Apps jederzeit kündigen und aus Deinem Konto entfernen.' +intro: 'Sie können {% data variables.product.prodname_marketplace %}-Apps jederzeit kündigen und aus Ihrem Konto entfernen.' redirect_from: - /articles/canceling-an-app-for-your-personal-account/ - /articles/canceling-an-app-for-your-organization/ diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/changing-the-duration-of-your-billing-cycle.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/changing-the-duration-of-your-billing-cycle.md index dd2eb8d16998..d48e7f18c3e7 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/changing-the-duration-of-your-billing-cycle.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/changing-the-duration-of-your-billing-cycle.md @@ -10,7 +10,7 @@ versions: free-pro-team: '*' --- -Wenn Du die Dauer Deines Abrechnungszeitraums änderst, wird Dein {% data variables.product.prodname_dotcom %}-Abonnement und alle weiteren bezahlten Funktionen und Produkte am nächsten Abrechnungsdatum auf den neuen Abrechnungszeitraum umgestellt. +Wenn Sie die Dauer Ihres Abrechnungszeitraums ändern, werden Ihr {% data variables.product.prodname_dotcom %}-Abonnement und alle weiteren bezahlten Features und Produkte am nächsten Abrechnungsdatum auf den neuen Abrechnungszeitraum umgestellt. ### Die Dauer des Abrechnungszeitraums Deines persönlichen Kontos ändern diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/creating-and-paying-for-an-organization-on-behalf-of-a-client.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/creating-and-paying-for-an-organization-on-behalf-of-a-client.md index c39f3fee0f49..0e400803b6c5 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/creating-and-paying-for-an-organization-on-behalf-of-a-client.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/creating-and-paying-for-an-organization-on-behalf-of-a-client.md @@ -1,6 +1,6 @@ --- title: Eine Organisation im Namen eines Kunden erstellen und bezahlen -intro: 'Du kannst im Namen eines Kunden eine {% data variables.product.prodname_dotcom %}-Organisation erstellen und bezahlen.' +intro: 'Sie können im Namen eines Kunden eine {% data variables.product.prodname_dotcom %}-Organisation erstellen und bezahlen.' redirect_from: - /articles/creating-and-paying-for-an-organization-on-behalf-of-a-client versions: @@ -86,7 +86,7 @@ Wenn Du bereits ein persönliches {% data variables.product.prodname_dotcom %}-B ### Nächste Schritte: 1. Bitte Deinen Kunden darum, Dich [als Abrechnungsmanager zur Organisation hinzuzufügen](/articles/adding-a-billing-manager-to-your-organization). Du musst Abrechnungsmanager für die Organisation sein, um in Zukunft das Abonnement Deines Kunden verlängern oder ändern zu können. -2. Wenn Du die Kreditkarte Deiner Organisation aus der neuen Organisation entfernen möchtest, damit sie nicht mehr belastet wird, wende Dich an {% data variables.contact.contact_support %}. +2. Wenn Sie die Kreditkarte Ihrer Organisation aus der Organisation entfernen möchten, damit sie nicht mehr belastet wird, wenden Sie sich an {% data variables.contact.contact_support %}. 3. Informationen zum Verlängern des bezahlten Abonnements Deines Kunden findest Du unter „[Eine bezahlte Organisation Deines Kunden erneuern](/articles/renewing-your-client-s-paid-organization).“ ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/discounted-subscriptions-for-github-accounts.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/discounted-subscriptions-for-github-accounts.md index 7c191693184e..4e7030def282 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/discounted-subscriptions-for-github-accounts.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/discounted-subscriptions-for-github-accounts.md @@ -22,7 +22,7 @@ Neben den unbegrenzten öffentlichen und privaten Repositorys für Studenten und ### Rabatte für Schulen und Universitäten -Verifizierte akademische Fakultäten können {% data variables.product.prodname_team %} für den Unterricht oder die akademische Forschung beantragen. Verifizierte akademische Fakultäten können {% data variables.product.prodname_team %} für den Unterricht oder die akademische Forschung beantragen. Weitere Informationen findest Du unter „[{% data variables.product.prodname_dotcom %} für Lehre und Forschung nutzen](/articles/using-github-in-your-classroom-and-research)“. Weitere Informationen findest Du unter [{% data variables.product.prodname_education %}](https://education.github.com/). +Verifizierte akademische Fakultäten können {% data variables.product.prodname_team %} für den Unterricht oder die akademische Forschung beantragen. Verifizierte akademische Fakultäten können {% data variables.product.prodname_team %} für den Unterricht oder die akademische Forschung beantragen. Weitere Informationen findest Du unter „[{{ site.data.variables.product.prodname_dotcom }} für Lehre und Forschung nutzen](/articles/using-github-in-your-classroom-and-research)“. Weitere Informationen findest Du unter [{% data variables.product.prodname_education %}](https://education.github.com/). ### Rabatte für gemeinnützige Organisationen und Bibliotheken diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-git-large-file-storage.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-git-large-file-storage.md index e3639c5fa65e..b68efad4bde0 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-git-large-file-storage.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-git-large-file-storage.md @@ -1,6 +1,6 @@ --- title: Git Large File Storage herabstufen -intro: 'Du kannst Speicher und Bandbreite für {% data variables.large_files.product_name_short %} in Stufen von je 50 GB pro Monat herabstufen.' +intro: 'Sie können Speicher und Bandbreite für {% data variables.large_files.product_name_short %} in Stufen von je 50 GB pro Monat herabstufen.' redirect_from: - /articles/downgrading-storage-and-bandwidth-for-a-personal-account/ - /articles/downgrading-storage-and-bandwidth-for-an-organization/ diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-the-billing-plan-for-a-github-marketplace-app.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-the-billing-plan-for-a-github-marketplace-app.md index 0d5c775ffab5..a18f1b62ecd0 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-the-billing-plan-for-a-github-marketplace-app.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-the-billing-plan-for-a-github-marketplace-app.md @@ -1,6 +1,6 @@ --- title: Abrechnungsplan für eine GitHub Marketplace-App herabstufen -intro: 'Wenn Du einen anderen Abrechnungsplan wünschst, kannst Du Deine {% data variables.product.prodname_marketplace %}-App jederzeit herabstufen.' +intro: 'Wenn Sie einen anderen Abrechnungsplan wünschen, können Sie Ihre {% data variables.product.prodname_marketplace %}-App jederzeit herabstufen.' redirect_from: - /articles/downgrading-an-app-for-your-personal-account/ - /articles/downgrading-an-app-for-your-organization/ diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/how-does-upgrading-or-downgrading-affect-the-billing-process.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/how-does-upgrading-or-downgrading-affect-the-billing-process.md index 794f4aa2d21b..1ad251066f53 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/how-does-upgrading-or-downgrading-affect-the-billing-process.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/how-does-upgrading-or-downgrading-affect-the-billing-process.md @@ -29,7 +29,7 @@ Die Organisation von Stefan bezahlt jedes Jahr am 20. Mai für 50 Benutzer. Wenn ### Weiterführende Informationen -- „[Abrechnung für Dein {% data variables.product.prodname_dotcom %}-Konto verwalten](/articles/managing-billing-for-your-github-account)“ +- „[Abrechnung für Ihr {% data variables.product.prodname_dotcom %}-Konto verwalten](/articles/managing-billing-for-your-github-account)“ - „[Abrechnung für Ihre {% data variables.product.prodname_marketplace %}-Apps verwalten](/articles/managing-billing-for-github-marketplace-apps)“ - „[Abrechnung für {% data variables.large_files.product_name_long %} verwalten](/articles/managing-billing-for-git-large-file-storage)“ - „[Informationen zu benutzerbasierten Preisen](/articles/about-per-user-pricing)“ diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-git-large-file-storage.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-git-large-file-storage.md index 2250094f8fb0..96463bad6ba3 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-git-large-file-storage.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-git-large-file-storage.md @@ -1,6 +1,6 @@ --- title: Abrechnung für Git Large File Storage verwalten -intro: 'Du kannst die Nutzung anzeigen und {% data variables.large_files.product_name_long %} herauf- oder herabstufen.' +intro: 'Sie können die Nutzung anzeigen und {% data variables.large_files.product_name_long %} upgraden und herabstufen.' redirect_from: - /articles/managing-large-file-storage-and-bandwidth-for-your-personal-account/ - /articles/managing-large-file-storage-and-bandwidth-for-your-organization/ diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-marketplace-apps.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-marketplace-apps.md index b21e678d5f85..215159d24ad7 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-marketplace-apps.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-marketplace-apps.md @@ -1,6 +1,6 @@ --- title: Abrechnung für Deine GitHub Marketplace-Apps verwalten -intro: 'Du kannst {% data variables.product.prodname_marketplace %}-Apps jederzeit herauf- oder herabstufen oder kündigen.' +intro: 'Sie können {% data variables.product.prodname_marketplace %}-Apps jederzeit upgraden, herabstufen oder kündigen.' redirect_from: - /articles/managing-your-personal-account-s-apps/ - /articles/managing-your-organization-s-apps/ diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md index 9b62c927c290..273c2e989c1d 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md @@ -30,7 +30,7 @@ Jeder kann das Ausgabenlimit für {% data variables.product.prodname_actions %} Organisationsinhaber und Abrechnungsmanager können das Ausgabenlimit von {% data variables.product.prodname_actions %} für eine Organisation verwalten. -Wenn Du Dein Organisationskonto per Rechnung bezahlst, kannst Du das Ausgabenlimit für Dein Enterprise-Konto auf {% data variables.product.product_name %} nicht verwalten. Wenn Du Repositorys im Besitz Deiner Organisation erlauben willst, {% data variables.product.prodname_actions %} über die in ihren Konten enthaltenen Speicher oder Datenübertragungen hinaus zu benutzen, kannst Du für Überschreitungen im Voraus bezahlen. Da Überschreitungen im Voraus bezahlt werden müssen, kannst Du keine unbegrenzten Ausgaben für Konten aktivieren, die per Rechnung bezahlt werden. Dein Ausgabenlimit beträgt 150 % des Betrags, den Du im Voraus bezahlt hast. Wenn Du Fragen hast, [wende Dich an unser Kundendienstteam](https://enterprise.github.com/contact). +Wenn Du Dein Organisationskonto per Rechnung bezahlst, kannst Du das Ausgabenlimit für dieses Konto auf {% data variables.product.product_name %} nicht verwalten. Wenn Du Repositorys im Besitz Deiner Organisation erlauben willst, {% data variables.product.prodname_actions %} über die in ihren Konten enthaltenen Speicher oder Datenübertragungen hinaus zu benutzen, kannst Du für Überschreitungen im Voraus bezahlen. Da Überschreitungen im Voraus bezahlt werden müssen, kannst Du keine unbegrenzten Ausgaben für Konten aktivieren, die per Rechnung bezahlt werden. Dein Ausgabenlimit beträgt 150 % des Betrags, den Du im Voraus bezahlt hast. Wenn Du Fragen hast, [wende Dich an unser Kundendienstteam](https://enterprise.github.com/contact). {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} @@ -49,6 +49,8 @@ Enterprise-Inhaber und Abrechnungsmanager können das Ausgabenlimit von {% data {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %} -1. Unter „Monatliche Nutzung von {% data variables.product.prodname_actions %} und Paketen" klicke auf **Cost management** (Kostenmanagement). ![Registerkarte „Cost Management" (Kostenverwaltung)](/assets/images/help/settings/cost-management-tab-enterprise.png) +1. Under " +{% data variables.product.prodname_actions %} and Packages monthly usage", click **Cost management**. + ![Registerkarte „Cost Management" (Kostenverwaltung)](/assets/images/help/settings/cost-management-tab-enterprise.png) {% data reusables.dotcom_billing.monthly-spending-limit %} {% data reusables.dotcom_billing.update-spending-limit %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md index 30a62147c70e..311573263d67 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md @@ -30,7 +30,7 @@ Jeder kann das Ausgabenlimit für {% data variables.product.prodname_registry %} Organisationsinhaber und Abrechnungsmanager können das Ausgabenlimit von {% data variables.product.prodname_registry %} für eine Organisation verwalten. -Wenn Du Dein Organisationskonto per Rechnung bezahlst, kannst Du das Ausgabenlimit für Dein Enterprise-Konto auf {% data variables.product.product_name %} nicht verwalten. Wenn Du Repositorys im Besitz Deiner Organisation erlauben willst, {% data variables.product.prodname_registry %} über die in ihren Konten enthaltenen Speicher oder Datenübertragungen hinaus zu benutzen, kannst Du für Überschreitungen im Voraus bezahlen. Da Überschreitungen im Voraus bezahlt werden müssen, kannst Du keine unbegrenzten Ausgaben für Konten aktivieren, die per Rechnung bezahlt werden. Dein Ausgabenlimit beträgt 150 % des Betrags, den Du im Voraus bezahlt hast. Wenn Du Fragen hast, [wende Dich an unser Kundendienstteam](https://enterprise.github.com/contact). +Wenn Du Dein Organisationskonto per Rechnung bezahlst, kannst Du das Ausgabenlimit für dieses Konto auf {% data variables.product.product_name %} nicht verwalten. Wenn Du Repositorys im Besitz Deiner Organisation erlauben willst, {% data variables.product.prodname_registry %} über die in ihren Konten enthaltenen Speicher oder Datenübertragungen hinaus zu benutzen, kannst Du für Überschreitungen im Voraus bezahlen. Da Überschreitungen im Voraus bezahlt werden müssen, kannst Du keine unbegrenzten Ausgaben für Konten aktivieren, die per Rechnung bezahlt werden. Dein Ausgabenlimit beträgt 150 % des Betrags, den Du im Voraus bezahlt hast. Wenn Du Fragen hast, [wende Dich an unser Kundendienstteam](https://enterprise.github.com/contact). {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} @@ -49,6 +49,8 @@ Enterprise-Inhaber und Abrechnungsmanager können das Ausgabenlimit von {% data {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %} -1. Unter „Monatliche Nutzung von {% data variables.product.prodname_actions %} und Paketen" klicke auf **Cost management** (Kostenmanagement). ![Registerkarte „Cost Management" (Kostenverwaltung)](/assets/images/help/settings/cost-management-tab-enterprise.png) +1. Under " +{% data variables.product.prodname_actions %} and Packages monthly usage", click **Cost management**. + ![Registerkarte „Cost Management" (Kostenverwaltung)](/assets/images/help/settings/cost-management-tab-enterprise.png) {% data reusables.dotcom_billing.monthly-spending-limit %} {% data reusables.dotcom_billing.update-spending-limit %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/redeeming-a-coupon.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/redeeming-a-coupon.md index 55015a6e9225..c2dcc2776416 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/redeeming-a-coupon.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/redeeming-a-coupon.md @@ -1,6 +1,6 @@ --- title: Gutschein einlösen -intro: 'Falls Du einen Gutschein hast, kannst Du ihn für ein bezahltes {% data variables.product.prodname_dotcom %}-Abonnement einlösen.' +intro: 'Falls Sie einen Gutschein haben, können Sie ihn für ein {% data variables.product.prodname_dotcom %}-Abonnement einlösen.' redirect_from: - /articles/where-do-i-add-a-coupon-code/ - /articles/redeeming-a-coupon-for-your-personal-account/ diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/removing-a-payment-method.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/removing-a-payment-method.md index cd47ec1e4c25..faa9a731cba0 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/removing-a-payment-method.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/removing-a-payment-method.md @@ -1,6 +1,6 @@ --- title: Zahlungsmethode entfernen -intro: 'Wenn Du Deine Zahlungsmethode für kein bezahltes Abonnement auf {% data variables.product.prodname_dotcom %} verwendest, kannst Du diese Zahlungsmethode entfernen. Sie wird dann nicht mehr unter Deinem Konto gespeichert.' +intro: 'Wenn Sie Ihre Zahlungsmethode für kein bezahltes Abonnement auf {% data variables.product.prodname_dotcom %} verwenden, können Sie diese Zahlungsmethode entfernen. Sie wird dann nicht mehr unter Ihrem Konto gespeichert.' redirect_from: - /articles/removing-a-credit-card-associated-with-your-user-account/ - /articles/removing-a-payment-method-associated-with-your-user-account/ @@ -11,7 +11,7 @@ versions: free-pro-team: '*' --- -Wenn Du Dein {% data variables.product.product_name %}-Abonnement mit einem Gutschein bezahlst und Deine Zahlungsmethode für keine [anderen bezahlten Funktionen oder Produkte](/articles/about-billing-on-github) auf {% data variables.product.product_name %} benötigst, kannst Du Deine Kreditkarten- oder PayPal-Daten entfernen. +Wenn Sie Ihr {% data variables.product.product_name %}-Abonnement mit einem Gutschein bezahlen und Ihre Zahlungsmethode für keine [anderen bezahlten Funktionen oder Produkte](/articles/about-billing-on-github) auf {% data variables.product.product_name %} benötigen, können Sie Ihre Kreditkarten- oder PayPal-Daten entfernen. {% tip %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/setting-up-paid-organizations-for-procurement-companies.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/setting-up-paid-organizations-for-procurement-companies.md index 028093ec850e..63395dbfcee6 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/setting-up-paid-organizations-for-procurement-companies.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/setting-up-paid-organizations-for-procurement-companies.md @@ -1,6 +1,6 @@ --- title: Bezahlte Organisationen für Beschaffungsunternehmen einrichten -intro: 'Wenn Du {% data variables.product.product_name %} im Auftrag eines Kunden bezahlst, kannst Du dessen Organisations- und Zahlungseinstellungen konfigurieren, um Komfort und Sicherheit zu erhöhen.' +intro: 'Wenn Sie {% data variables.product.product_name %} im Auftrag eines Kunden bezahlen, können Sie dessen Organisations- und Zahlungseinstellungen einrichten, um Komfort und Sicherheit zu erhöhen.' redirect_from: - /articles/setting-up-and-paying-for-organizations-for-resellers/ - /articles/setting-up-and-paying-for-organizations-for-procurement-companies/ diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/setting-your-billing-email.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/setting-your-billing-email.md index d92b310fb307..73834dc35205 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/setting-your-billing-email.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/setting-your-billing-email.md @@ -1,6 +1,6 @@ --- title: E-Mail-Adresse für die Abrechnung festlegen -intro: 'Die E-Mail-Adresse Deines Kontos für die Abrechnung ist diejenige Adresse, an die {% data variables.product.product_name %} Quittungen und andere Benachrichtigungen zu Deiner Abrechnung sendet.' +intro: 'Die E-Mail-Adresse Ihres Kontos für die Abrechnung ist diejenige Adresse, an die {% data variables.product.product_name %} Quittungen und andere Benachrichtigungen zu Ihrer Abrechnung sendet.' redirect_from: - /articles/setting-your-personal-account-s-billing-email/ - /articles/can-i-change-what-email-address-received-my-github-receipt/ @@ -13,7 +13,7 @@ versions: ### E-Mail-Adresse für die Abrechnung für Dein persönliches Konto festlegen -{% data variables.product.product_name %} sendet Quittungen und andere Benachrichtigungen zu Deiner Abrechnung an die primäre E-Mail-Adresse Deines persönlichen Kontos. +{% data variables.product.product_name %} sendet Quittungen und andere Benachrichtigungen zu Ihrer Abrechnung an die primäre E-Mail-Adresse Ihres persönlichen Kontos. Deine primäre E-Mail-Adresse ist die erste E-Mail-Adresse, die in den E-Mail-Einstellungen Deines Kontos aufgeführt ist. Die primäre E-Mail-Adresse Deines Kontos wird auch als E-Mail-Adresse für die Abrechnung verwendet. @@ -21,7 +21,7 @@ Informationen zur Änderung Deiner E-Mail-Adresse für die Abrechnung findest Du ### E-Mail-Adresse für die Abrechnung für Deiner Organisation festlegen -{% data variables.product.product_name %} sendet Quittungen und andere Benachrichtigungen zu Deiner Abrechnung an die für Deine Organisation festgelegte E-Mail-Adresse für die Abrechnung. +{% data variables.product.product_name %} sendet Quittungen und andere Benachrichtigungen zu Ihrer Abrechnung an die für Ihre Organisation festgelegte E-Mail-Adresse für die Abrechnung. {% data reusables.dotcom_billing.org-billing-perms %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/troubleshooting-a-declined-credit-card-charge.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/troubleshooting-a-declined-credit-card-charge.md index 89f7b49e913d..66c2254efe8f 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/troubleshooting-a-declined-credit-card-charge.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/troubleshooting-a-declined-credit-card-charge.md @@ -1,6 +1,6 @@ --- title: Fehlerbehebung bei einer abgelehnten Kreditkartenbelastung -intro: 'Wenn die Kreditkarte abgelehnt wird, die Du für die Zahlung der Nutzung von {% data variables.product.product_name %} angegeben hast, hast Du verschiedene Möglichkeiten um sicherzustellen, dass die Zahlung erfolgt und Dein Konto nicht gesperrt wird.' +intro: 'Wenn die Kreditkarte, die Sie für die Zahlung der Nutzung von {% data variables.product.product_name %} angegeben haben, abgelehnt wird, haben Sie verschiedene Möglichkeiten, sicherzustellen, dass die Zahlung erfolgt und Ihr Konto nicht gesperrt wird.' redirect_from: - /articles/what-do-i-do-if-my-card-is-declined/ - /articles/troubleshooting-a-declined-credit-card-charge diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/unlocking-a-locked-account.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/unlocking-a-locked-account.md index bbf6ace1f483..fd26485a9cd6 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/unlocking-a-locked-account.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/unlocking-a-locked-account.md @@ -1,6 +1,6 @@ --- title: Gesperrtes Konto entsperren -intro: 'Die kostenpflichtigen Funktionen Deiner Organisation sind gesperrt, wenn Deine Zahlung aufgrund von Zahlungsproblemen verspätet ist.' +intro: Die kostenpflichtigen Funktionen Deiner Organisation sind gesperrt, wenn Deine Zahlung aufgrund von Zahlungsproblemen verspätet ist. redirect_from: - /articles/what-happens-if-my-account-is-locked/ - /articles/if-my-account-is-locked-and-i-upgrade-it-do-i-owe-anything-for-previous-time/ diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-git-large-file-storage.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-git-large-file-storage.md index 70176c1b8802..729b9eb5ae7d 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-git-large-file-storage.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-git-large-file-storage.md @@ -1,6 +1,6 @@ --- title: Git Large File Storage upgraden -intro: 'Du kannst zusätzliche Datenpakete kaufen, um Dein monatliches Bandbreitenkontingent und die Gesamtspeicherkapazität für {% data variables.large_files.product_name_short %} zu erhöhen.' +intro: 'Sie können zusätzliche Datenpakete kaufen, um Ihr monatliches Bandbreitenkontingent und um die Gesamtspeicherkapazität für {% data variables.large_files.product_name_short %} zu erhöhen.' redirect_from: - /articles/purchasing-additional-storage-and-bandwidth-for-a-personal-account/ - /articles/purchasing-additional-storage-and-bandwidth-for-an-organization/ diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-the-billing-plan-for-a-github-marketplace-app.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-the-billing-plan-for-a-github-marketplace-app.md index a1e49fd11b44..2737be7c933a 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-the-billing-plan-for-a-github-marketplace-app.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-the-billing-plan-for-a-github-marketplace-app.md @@ -1,6 +1,6 @@ --- title: Abrechnungsplan für eine GitHub Marketplace-App heraufstufen -intro: 'Du kannst Deine {% data variables.product.prodname_marketplace %}-App jederzeit auf einen anderen Plan heraufstufen.' +intro: 'Sie können Ihre {% data variables.product.prodname_marketplace %}-App jederzeit auf einen anderen Plan heraufstufen.' redirect_from: - /articles/upgrading-an-app-for-your-personal-account/ - /articles/upgrading-an-app-for-your-organization/ diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md index bd15d5aca511..15c53c4a99bd 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md @@ -1,6 +1,6 @@ --- title: Dein GitHub-Abonnement hochstufen -intro: 'Du kannst das Abonnement jederzeit für jeden beliebigen {% data variables.product.product_name %}-Kontotyp heraufstufen.' +intro: 'Sie können das Abonnement jederzeit für jeden beliebigen {% data variables.product.product_name %}-Kontotyp heraufstufen.' redirect_from: - /articles/upgrading-your-personal-account-s-billing-plan/ - /articles/upgrading-your-personal-account/ @@ -28,7 +28,9 @@ Du kannst Dein persönliches Konto von {% data variables.product.prodname_free_u {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.billing %} {% data reusables.user_settings.subscriptions-tab %} -4. Klicke neben „{% data variables.product.prodname_free_user %}" auf **Upgrade** (Heraufstufen). ![Schaltfläche „Upgrade“](/assets/images/help/billing/settings_billing_user_upgrade.png) +4. Next to " +{% data variables.product.prodname_free_user %}", click **Upgrade**. + ![Schaltfläche „Upgrade“](/assets/images/help/billing/settings_billing_user_upgrade.png) {% data reusables.dotcom_billing.choose-monthly-or-yearly-billing %} {% data reusables.dotcom_billing.show-plan-details %} {% data reusables.dotcom_billing.enter-payment-info %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-and-managing-pending-changes-to-your-subscription.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-and-managing-pending-changes-to-your-subscription.md index 2a78eb9a4e2a..fc4b0ed86ca5 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-and-managing-pending-changes-to-your-subscription.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-and-managing-pending-changes-to-your-subscription.md @@ -1,6 +1,6 @@ --- title: Ausstehende Änderungen an Deinem Abonnement anzeigen und verwalten -intro: 'Du kannst ausstehende Änderungen an Deinen Abonnements anzeigen und stornieren, bevor sie an Deinem nächsten Abrechnungsdatum wirksam werden.' +intro: Du kannst ausstehende Änderungen an Deinen Abonnements anzeigen und stornieren, bevor sie an Deinem nächsten Abrechnungsdatum wirksam werden. redirect_from: - /articles/viewing-and-managing-pending-changes-to-your-personal-account-s-billing-plan/ - /articles/viewing-and-managing-pending-changes-to-your-organization-s-billing-plan/ diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-git-large-file-storage-usage.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-git-large-file-storage-usage.md index 7f2d002520e5..a50543771cc2 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-git-large-file-storage-usage.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-git-large-file-storage-usage.md @@ -1,6 +1,6 @@ --- title: Deine Git Large File Storage-Nutzung anzeigen -intro: 'Du kannst das monatliche Bandbreitenkontingent Deines Kontos und den verbleibenden Speicher für {% data variables.large_files.product_name_short %} überwachen.' +intro: 'Sie können das monatliche Bandbreitenkontingent Ihres Kontos und den verbleibenden Speicher für {% data variables.large_files.product_name_short %} überwachen.' redirect_from: - /articles/viewing-storage-and-bandwidth-usage-for-a-personal-account/ - /articles/viewing-storage-and-bandwidth-usage-for-an-organization/ diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md index 74ee68cfab9d..22b04cf3dde5 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md @@ -6,7 +6,7 @@ versions: free-pro-team: '*' --- -Du kannst auch die verrechenbaren Auftrags-Ausführungsminuten für eine einzelne Workflow-Ausführung anzeigen. Weitere Informationen findest Du unter „[Eine Workflow-Ausführung verwalten](/actions/configuring-and-managing-workflows/managing-a-workflow-run#viewing-billable-job-execution-minutes).“ +Du kannst auch die verrechenbaren Auftrags-Ausführungsminuten für eine einzelne Workflow-Ausführung anzeigen. For more information, see "[Viewing job execution time](/actions/managing-workflow-runs/viewing-job-execution-time)." ### {% data variables.product.prodname_actions %}-Nutzung für Dein Benutzerkonto anzeigen @@ -43,6 +43,8 @@ Enterprise-Inhaber und Abrechnungsmanager können die Nutzung von {% data variab {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %} -1. Unter „{% data variables.product.prodname_actions %}" siehst Du die Details der Nutzung der Datenübertragung für jede Organisation in Deinem Enterprise-Konto. ![Details der Nutzung von Minuten](/assets/images/help/billing/actions-minutes-enterprise.png) +1. Under " +{% data variables.product.prodname_actions %}", view details of usage of data transfer by each organization in your enterprise account. + ![Details der Nutzung von Minuten](/assets/images/help/billing/actions-minutes-enterprise.png) {% data reusables.dotcom_billing.actions-packages-storage-enterprise-account %} {% data reusables.enterprise-accounts.actions-packages-report-download-enterprise-accounts %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md index 947851241cc9..20fb03454675 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md +++ b/translations/de-DE/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md @@ -41,6 +41,8 @@ Enterprise-Inhaber und Abrechnungsmanager können die Nutzung von {% data variab {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %} -1. Unter „{% data variables.product.prodname_registry %}" siehst Du die Details der Nutzung der Datenübertragung für jede Organisation in Deinem Enterprise-Konto. ![Details zur Nutzung der Datenübertragung](/assets/images/help/billing/packages-data-enterprise.png) +1. Under " +{% data variables.product.prodname_registry %}", view details of usage of data transfer by each organization in your enterprise account. + ![Details zur Nutzung der Datenübertragung](/assets/images/help/billing/packages-data-enterprise.png) {% data reusables.dotcom_billing.actions-packages-storage-enterprise-account %} {% data reusables.enterprise-accounts.actions-packages-report-download-enterprise-accounts %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-oauth-app-access-restrictions.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-oauth-app-access-restrictions.md index 0b1183790119..515fdc08239a 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-oauth-app-access-restrictions.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-oauth-app-access-restrictions.md @@ -8,7 +8,7 @@ versions: free-pro-team: '*' --- -Wenn {% data variables.product.prodname_oauth_app %}-Zugriffsbeschränkungen aktiviert sind, können Organisationsmitglieder den {% data variables.product.prodname_oauth_app %}-Zugriff auf Organisationsressourcen nicht autorisieren. Organisationsmitglieder können die Genehmigung des Inhabers für {% data variables.product.prodname_oauth_app %}s beantragen, die sie verwenden möchten, und Organisationsinhaber erhalten eine Benachrichtigung über ausstehende Anfragen. +Wenn {% data variables.product.prodname_oauth_app %}-Zugriffseinschränkungen aktiviert sind, können Organisationsmitglieder den {% data variables.product.prodname_oauth_app %}-Zugriff auf Organisationsressourcen nicht autorisieren. Organisationsmitglieder können die Genehmigung des Inhabers für {% data variables.product.prodname_oauth_app %}s beantragen, die sie verwenden möchten, und Organisationsinhaber erhalten eine Benachrichtigung über ausstehende Anfragen. {% data reusables.organizations.oauth_app_restrictions_default %} @@ -18,9 +18,9 @@ Wenn {% data variables.product.prodname_oauth_app %}-Zugriffsbeschränkungen akt {% endtip %} -### {% data variables.product.prodname_oauth_app %}-Zugriffsbeschränkungen einrichten +### {% data variables.product.prodname_oauth_app %}-Zugriffseinschränkungen einrichten -Wenn ein Organisationsinhaber zum ersten Mal {% data variables.product.prodname_oauth_app %}-Zugriffsbeschränkungen einrichtet, trifft Folgendes zu: +Wenn ein Organisationsinhaber zum ersten Mal {% data variables.product.prodname_oauth_app %}-Zugriffseinschränkungen einrichtet, trifft Folgendes zu: - **Anwendungen im Besitz der Organisation** erhalten automatisch Zugriff auf die Ressourcen der Organisation. - **{% data variables.product.prodname_oauth_app %}s** verlieren sofort den Zugriff auf die Ressourcen der Organisation. @@ -37,18 +37,18 @@ Wenn ein vor Februar 2014 erstellter SSH-Schlüssel den Zugriff auf eine Organi ### Webhooks -Wenn einer {% data variables.product.prodname_oauth_app %} der Zugriff auf die Organisation gewährt wird, nachdem die Beschränkungen aktiviert wurden, werden alle bereits vorhandenen Webhooks, die von dieser {% data variables.product.prodname_oauth_app %} erstellt wurden, weiter versendet. +Wenn einer {% data variables.product.prodname_oauth_app %} Zugriff auf die Organisation gewährt wird, nachdem die Einschränkungen aktiviert wurden, werden alle bereits vorhandenen Webhooks, die von dieser {% data variables.product.prodname_oauth_app %} erstellt wurden, weiter versendet. Wenn eine Organisation den Zugriff einer zuvor genehmigten {% data variables.product.prodname_oauth_app %} entfernt, werden alle bereits vorhandenen Webhooks, die von dieser Anwendung erstellt wurden, nicht mehr versendet (diese Hooks werden deaktiviert, aber nicht gelöscht). ### Zugriffsbeschränkungen wieder aktivieren -Wenn eine Organisation {% data variables.product.prodname_oauth_app %}-Zugriffsbeschränkungen deaktiviert und später wieder aktiviert, erhalten zuvor genehmigte {% data variables.product.prodname_oauth_app %}s automatisch Zugriff auf die Ressourcen der Organisation. +Wenn eine Organisation {% data variables.product.prodname_oauth_app %}-Zugriffseinschränkungen deaktiviert und später wieder aktiviert, erhalten zuvor genehmigte {% data variables.product.prodname_oauth_app %}s automatisch Zugriff auf die Ressourcen der Organisation. ### Weiterführende Informationen - „[{% data variables.product.prodname_oauth_app %}-Zugriffsbeschränkungen für Deine Organisation aktivieren](/articles/enabling-oauth-app-access-restrictions-for-your-organization)“ -- „[{% data variables.product.prodname_oauth_app %}s für Deine Organisation genehmigen](/articles/approving-oauth-apps-for-your-organization)“ +- „[{% data variables.product.prodname_oauth_app %}s für Ihre Organisation genehmigen](/articles/approving-oauth-apps-for-your-organization)“ - „[Installierte Integrationen Deiner Organisation überprüfen](/articles/reviewing-your-organization-s-installed-integrations)“ - „[Zugriff einer zuvor genehmigten {% data variables.product.prodname_oauth_app %} für Deine Organisation verweigern](/articles/denying-access-to-a-previously-approved-oauth-app-for-your-organization)“ - „[{% data variables.product.prodname_oauth_app %}-Zugriffsbeschränkungen für Deine Organisation deaktivieren](/articles/disabling-oauth-app-access-restrictions-for-your-organization)“ diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md index 3ebcde3346d6..ffdb680cc17c 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md @@ -1,6 +1,6 @@ --- title: Informationen zu Organisationen -intro: 'Organisationen sind gemeinsame Konten, in denen Unternehmen und Open-Source-Projekte übergreifend über mehrere Projekte gleichzeitig zusammenarbeiten können. Inhaber und Administratoren können den Mitgliederzugriff auf Daten und Projekte der Organisation mit komplexen Sicherheits- und Administrationsfunktionen verwalten.' +intro: Organisationen sind gemeinsame Konten, in denen Unternehmen und Open-Source-Projekte übergreifend über mehrere Projekte gleichzeitig zusammenarbeiten können. Inhaber und Administratoren können den Mitgliederzugriff auf Daten und Projekte der Organisation mit komplexen Sicherheits- und Administrationsfunktionen verwalten. redirect_from: - /articles/about-organizations versions: @@ -25,5 +25,4 @@ Bei Organisationen, die einem Enterprise-Konto angehören, wird die Abrechnung a Eine Entität, beispielsweise ein Unternehmen, eine gemeinnützige Organisation oder eine Gruppe, kann die Standardnutzungsbedingungen oder die Unternehmensnutzungsbedingungen für ihre Organisation akzeptieren. Weitere Informationen findest Du unter „[Auf Unternehmensnutzungsbedingungen umstellen](/articles/upgrading-to-the-corporate-terms-of-service).“ -{% data reusables.organizations.enter-data-protection-agreement %} Weitere Informationen findest Du unter „[Eine Datenschutzvereinbarung mit {% data variables.product.prodname_dotcom %} in Bezug auf die Einhaltung der DSGVO abschließen](/articles/entering-a-data-protection-agreement-with-github-for-gdpr-compliance).“ {% endif %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-scim.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-scim.md index d3ed90667996..b69abe59d16a 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-scim.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-scim.md @@ -8,7 +8,7 @@ versions: free-pro-team: '*' --- -Wenn Du in Deiner Organisation [SAML SSO](/articles/about-identity-and-access-management-with-saml-single-sign-on) verwendest, kannst Du SCIM implementieren, um den Zugriff von Organisationsmitgliedern auf {% data variables.product.product_name %} hinzuzufügen, zu verwalten und zu entfernen. Ein Administrator kann beispielsweise die Bereitstellung des Zugriffs eines Organisationsmitglieds mithilfe von SCIM aufheben und das Mitglied automatisch aus der Organisation entfernen. +Wenn Sie in Ihrer Organisation [SAML SSO](/articles/about-identity-and-access-management-with-saml-single-sign-on) verwenden, können Sie SCIM implementieren, um den Zugriff von Organisationsmitgliedern auf {% data variables.product.product_name %} hinzuzufügen, zu verwalten und zu entfernen. Ein Administrator kann beispielsweise die Bereitstellung des Zugriffs eines Organisationsmitglieds mithilfe von SCIM aufheben und das Mitglied automatisch aus der Organisation entfernen. Wenn Du SAML SSO verwendest, ohne SCIM zu implementieren, ist die Aufhebung der Bereitstellung nicht automatisiert. Wenn die Sitzungen der Organisationsmitglieder ablaufen, nachdem ihr Zugriff vom IdP entfernt wurde, werden sie nicht automatisch aus der Organisation entfernt. Autorisierte Token gewähren auch nach Ablauf ihrer Sitzungen Zugriff auf die Organisation. Um den Zugriff zu entfernen, können Administratoren entweder manuell das autorisierte Token aus der Organisation entfernen oder seine Entfernung mit SCIM automatisieren. diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md index 212ff472b624..2df2ca54c84a 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md @@ -6,16 +6,16 @@ redirect_from: - /articles/about-ssh-certificate-authorities versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- Ein SSH-Zertifikat ist ein Mechanismus, mit dem ein SSH-Schlüssel einen anderen SSH-Schlüssel signieren kann. Wenn Du eine SSH-Zertifizierungsstelle (CA) verwendest, um den Mitgliedern Deiner Organisation signierte SSH-Zertifikate bereitzustellen, kannst Du die Zertifizierungsstelle zu Deinem Enterprise-Konto oder Deiner Organisation hinzufügen, damit die Organisationsmitglieder mit ihren Zertifikaten auf die Ressourcen der Organisation zugreifen können. Weitere Informationen findest Du unter „[SSH-Zertifizierungsstellen Deiner Organisation verwalten](/articles/managing-your-organizations-ssh-certificate-authorities).“ -Wenn Du eine SSH-Zertifizierungsstelle zu Deiner Organisation oder Deinem Enterprise-Konto hinzugefügt hast, kannst Du mit der Zertifizierungsstelle Client-SSH-Zertifikate für Organisationsmitglieder signieren. Organisationsmitglieder können mit den signierten Zertifikaten mit Git auf die Repositorys Deiner Organisation (und nur auf diese) zugreifen. Du kannst vorschreiben, dass die Mitglieder SSH-Zertifikate für den Zugriff auf die Organisationsressourcen verwenden müssen.{% if currentVersion == "free-pro-team@latest" %} Weitere Informationen findest Du unter „[Sicherheitseinstellungen für Organisationen in Deinem Enterprise-Konto erzwingen](/articles/enforcing-security-settings-in-your-enterprise-account#managing-your-enterprise-accounts-ssh-certificate-authorities)“.{% endif %} +Wenn Du eine SSH-Zertifizierungsstelle zu Deiner Organisation oder Deinem Enterprise-Konto hinzugefügt hast, kannst Du mit der Zertifizierungsstelle Client-SSH-Zertifikate für Organisationsmitglieder signieren. Organisationsmitglieder können mit den signierten Zertifikaten mit Git auf die Repositorys Deiner Organisation (und nur auf diese) zugreifen. You can require that members use SSH certificates to access organization resources.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[Enforcing security settings in your enterprise account](/articles/enforcing-security-settings-in-your-enterprise-account#managing-your-enterprise-accounts-ssh-certificate-authorities)."{% endif %} -Du kannst beispielsweise ein internes System einrichten, das jeden Morgen ein neues Zertifikat für Deine Entwickler herausgibt. Die Entwickler können dann mit ihren täglichen Zertifikaten in den Repositorys Deiner Organisation auf {% data variables.product.product_name %} arbeiten. Am Ende des Tages läuft das Zertifikat automatisch ab. So werden Deine Repositorys geschützt, falls das Zertifikat zu einem späteren Zeitpunkt kompromittiert wird. +Du kannst beispielsweise ein internes System einrichten, das jeden Morgen ein neues Zertifikat für Deine Entwickler herausgibt. Die Entwickler können mit ihrem aktuellen Zertifikat in den Repositorys Ihrer Organisation auf {% data variables.product.product_name %} arbeiten. Am Ende des Tages läuft das Zertifikat automatisch ab. So werden Deine Repositorys geschützt, falls das Zertifikat zu einem späteren Zeitpunkt kompromittiert wird. -Beim Herausgeben der einzelnen Zertifikate musst Du eine Erweiterung hinzufügen, die festlegt, für welchen {% data variables.product.product_name %}-Benutzer das Zertifikat gedacht ist. Du kannst beispielsweise den OpenSSH-Befehl `ssh-keygen` verwenden und dabei _KEY-IDENTITY_ durch Deine Schlüssel-Identität und _USERNAME_ durch einen {% data variables.product.product_name %}-Benutzernamen ersetzen: +Beim Herausgeben der einzelnen Zertifikate musst Du eine Erweiterung hinzufügen, die festlegt, für welchen {% data variables.product.product_name %}-Benutzer das Zertifikat gedacht ist. Sie können z. B. den OpenSSH-Befehl `ssh-keygen` verwenden und dabei _KEY-IDENTITY_ durch Ihre Schlüssel-Identität und _USERNAME_ einen {% data variables.product.product_name %}-Benutzernamen ersetzen: ```shell $ ssh-keygen -s ./ca-key -I KEY-IDENTITY -O extension:login@github.com=USERNAME ./user-key.pub diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-teams.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-teams.md index 3bd345b77407..59ae114ead2e 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-teams.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-teams.md @@ -1,6 +1,6 @@ --- title: Informationen zu Teams -intro: 'Teams sind Gruppen von Organisationsmitgliedern, welche die Struktur Deines Unternehmens oder Deiner Gruppe mit kaskadierenden Zugriffsberechtigungen und Erwähnungen widerspiegeln.' +intro: Teams sind Gruppen von Organisationsmitgliedern, welche die Struktur Deines Unternehmens oder Deiner Gruppe mit kaskadierenden Zugriffsberechtigungen und Erwähnungen widerspiegeln. redirect_from: - /articles/about-teams versions: @@ -21,7 +21,7 @@ Weitere Informationen findest Du unter: {% if currentVersion != "free-pro-team@latest" %} -Du kannst außerdem mit LDAP Sync {% data variables.product.product_location_enterprise %}-Teammitglieder und -Teamrollen mit Deinen bestehenden LDAP-Gruppen synchronisieren. Dadurch kannst Du eine rollenbasierte Zugriffskontrolle für Benutzer von Deinem LDAP-Server aus einrichten statt manuell innerhalb von {% data variables.product.product_location_enterprise %}. Weitere Informationen finden Sie unter „[LDAP-Synchronisierung aktivieren](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)“. +Sie können außerdem mit LDAP Sync {% data variables.product.product_location_enterprise %}-Teammitglieder und -Teamrollen mit Ihren bestehenden LDAP-Gruppen synchronisieren. Dadurch können Sie eine rollenbasierte Zugriffskontrolle für Benutzer von Ihrem LDAP-Server aus statt manuell innerhalb von {% data variables.product.product_location_enterprise %} einrichten. Weitere Informationen finden Sie unter „[LDAP-Synchronisierung aktivieren](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)“. {% endif %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-two-factor-authentication-and-saml-single-sign-on.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-two-factor-authentication-and-saml-single-sign-on.md index f1de0857e879..749eb135db3e 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-two-factor-authentication-and-saml-single-sign-on.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-two-factor-authentication-and-saml-single-sign-on.md @@ -1,6 +1,6 @@ --- title: Informationen zur Zwei-Faktor-Authentifizierung und zu SAML Single-Sign-On -intro: 'Administratoren von Organisationen können sowohl SAML Single-Sign-On als auch die Zwei-Faktor-Authentifizierung aktivieren, um zusätzliche Authentifizierungsmaßnahmen für ihre Organisationsmitglieder hinzuzufügen.' +intro: Administratoren von Organisationen können sowohl SAML Single-Sign-On als auch die Zwei-Faktor-Authentifizierung aktivieren, um zusätzliche Authentifizierungsmaßnahmen für ihre Organisationsmitglieder hinzuzufügen. product: '{% data reusables.gated-features.saml-sso %}' redirect_from: - /articles/about-two-factor-authentication-and-saml-single-sign-on diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-your-organization-dashboard.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-your-organization-dashboard.md index a67dc9a3144b..21495154d682 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-your-organization-dashboard.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-your-organization-dashboard.md @@ -28,7 +28,7 @@ Im Abschnitt „Recent activity" (Neueste Aktivitäten) Deines Newsfeed kannst D Im Bereich "Alle Aktivitäten" Deines Newsfeed kannst Du Aktualisierungen von anderen Teams und Repositorys in Deiner Organisation ansehen. -Der Abschnitt "Alle Aktivitäten" zeigt alle aktuellen Aktivitäten in der Organisation, einschließlich Aktivitäten in Repositorys, die Du nicht abonniert hast, und von Personen, denen Du nicht folgst. Weitere Informationen findest Du auf {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}„\[Über Benachrichtigungen\](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}„[Beobachtung von Repositorys aktivieren und deaktivieren](/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories){% endif %}" und „[Personen folgen](/articles/following-people)." +Der Abschnitt "Alle Aktivitäten" zeigt alle aktuellen Aktivitäten in der Organisation, einschließlich Aktivitäten in Repositorys, die Du nicht abonniert hast, und von Personen, denen Du nicht folgst. 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 %}"[Watching and unwatching repositories](/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories){% endif %}" and "[Following people](/articles/following-people)." Beispielsweise werden im Newsfeed der Organisation Aktualisierungen angezeigt, wenn jemand in der Organisation: - einen neuen Branch erstellt, diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-your-organizations-news-feed.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-your-organizations-news-feed.md index 6f2281329fe6..9d872305f454 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-your-organizations-news-feed.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/about-your-organizations-news-feed.md @@ -14,8 +14,8 @@ Im Newsfeed einer Organisation sind die neuesten Aktivitäten in Bezug auf die R ### Auf den Newsfeed Deiner Organisation zugreifen -1. {% data variables.product.signin_link %} bei Deinem {% data variables.product.product_name %}-Konto. -2. Öffne Dein {% data reusables.user_settings.personal_dashboard %}. +1. {% data variables.product.signin_link %} bei Ihrem {% data variables.product.product_name %}-Konto. +2. Öffnen Sie Ihr {% data reusables.user_settings.personal_dashboard %}. 3. Klicke auf den Kontextumschalter des Kontos in der oberen linken Ecke der Seite. ![Kontextumschalter-Schaltfläche in Enterprise](/assets/images/help/organizations/account_context_switcher.png) -4. Wähle eine Organisation aus dem Dropdownmenü aus.{% if currentVersion == "free-pro-team@latest" %} ![Kontextumschalter-Menü in dotcom](/assets/images/help/organizations/account-context-switcher-selected-dotcom.png){% else %} -![Kontextumschalter-Menü in Enterprise](/assets/images/help/organizations/account_context_switcher.png){% endif %} +4. Select an organization from the drop-down menu.{% if currentVersion == "free-pro-team@latest" %} ![Context switcher menu in dotcom](/assets/images/help/organizations/account-context-switcher-selected-dotcom.png){% else %} +![Context switcher menu in Enterprise](/assets/images/help/organizations/account_context_switcher.png){% endif %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md index c02d6eb3ecd6..d197a2b4c97d 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md @@ -1,6 +1,6 @@ --- title: Einen externen Mitarbeiter zu einem Projektboard in Deiner Organisation hinzufügen -intro: Als Organisationsinhaber oder Projektboard-Administrator kannst du einen externen Mitarbeiter zu einem Projektboard hinzufügen und seine Berechtigungen anpassen. +intro: 'Als Organisationsinhaber oder Projektboard-Administrator kannst du einen externen Mitarbeiter zu einem Projektboard hinzufügen und seine Berechtigungen anpassen.' redirect_from: - /articles/adding-an-outside-collaborator-to-a-project-board-in-your-organization versions: @@ -17,6 +17,8 @@ Ein externer Mitarbeiter ist eine Person, die nicht explizit Mitglied Deiner Org {% data reusables.project-management.click-menu %} {% data reusables.project-management.access-collaboration-settings %} {% data reusables.project-management.collaborator-option %} -9. Gib unter „Search by username, full name or email address“ (Nach Benutzername, vollständigem Namen oder E-Mail-Adresse suchen) den Namen, den Benutzernamen oder die {% data variables.product.prodname_dotcom %}-E-Mail-Adresse des externen Mitarbeiters ein. ![Der Bereich „Collaborators“ (Mitarbeiter) mit Octocat-Benutzernamen im Suchfeld](/assets/images/help/projects/org-project-collaborators-find-name.png) +9. Under "Search by username, full name or email address", type the outside collaborator's name, username, or +{% data variables.product.prodname_dotcom %} email. + ![Der Bereich „Collaborators“ (Mitarbeiter) mit Octocat-Benutzernamen im Suchfeld](/assets/images/help/projects/org-project-collaborators-find-name.png) {% data reusables.project-management.add-collaborator %} {% data reusables.project-management.collaborator-permissions %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md index ca8f818657d2..b6190bc2cde4 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md @@ -24,7 +24,9 @@ Weitere Informationen zu den Berechtigungen für {% data variables.product.prodn {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.github-apps-settings-sidebar %} -1. Klicke unter „{% data variables.product.prodname_github_app %}s“ auf den Avatar der App, zu der Du einen {% data variables.product.prodname_github_app %}-Manager hinzufügen möchten. ![{% data variables.product.prodname_github_app %} auswählen](/assets/images/help/organizations/select-github-app.png) +1. Under " +{% data variables.product.prodname_github_app %}s", click on the avatar of the app you'd like to add a {% data variables.product.prodname_github_app %} manager for. +![{% data variables.product.prodname_github_app %} auswählen](/assets/images/help/organizations/select-github-app.png) {% data reusables.organizations.app-managers-settings-sidebar %} 1. Gib unter „App managers“ (App-Manager) den Benutzernamen der Person ein, die Du als GitHub App-Manager für die App festlegen möchtest. Klicke anschließend auf **Grant** (Erteilen). ![Einen {% data variables.product.prodname_github_app %}-Manager für eine bestimmte App hinzufügen](/assets/images/help/organizations/add-github-app-manager-for-app.png) diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/adding-organization-members-to-a-team.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/adding-organization-members-to-a-team.md index 6d1b00727e40..6b112565b6de 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/adding-organization-members-to-a-team.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/adding-organization-members-to-a-team.md @@ -1,6 +1,6 @@ --- -title: Organisationsmitglieder zu einem Team hinzufügen -intro: 'Benutzer mit Inhaber- oder Team-Betreuer-Berechtigungen können Organisationsmitglieder zu Teams hinzufügen. Benutzer mit Inhaberberechtigungen können auch {% if currentVersion == "free-pro-team@latest" %}Nicht-Mitglieder zu einem Team und zur Organisation einladen{% else %}Nicht-Mitglieder zu einem Team und zur Organisation hinzufügen.{% endif %}' +title: Adding organization members to a team +intro: 'People with owner or team maintainer permissions can add organization members to teams. People with owner permissions can also {% if currentVersion == "free-pro-team@latest" %}invite non-members to join{% else %}add non-members to{% endif %} a team and the organization.' redirect_from: - /articles/adding-organization-members-to-a-team-early-access-program/ - /articles/adding-organization-members-to-a-team @@ -15,13 +15,14 @@ versions: {% data reusables.profile.access_org %} {% data reusables.organizations.specific_team %} {% data reusables.organizations.team_members_tab %} -6. Klicke oberhalb der Liste der Teammitglieder auf **Add a member** (Ein Mitglied hinzufügen). ![Schaltfläche „Add member“ (Mitglied hinzufügen)](/assets/images/help/teams/add-member-button.png) +6. Above the list of team members, click **Add a member**. +![Add member button](/assets/images/help/teams/add-member-button.png) {% data reusables.organizations.invite_to_team %} {% data reusables.organizations.review-team-repository-access %} {% if currentVersion == "free-pro-team@latest" %}{% data reusables.organizations.cancel_org_invite %}{% endif %} -### Weiterführende Informationen +### Further reading -- „[Informationen zu Teams](/articles/about-teams)“ -- „[Den Teamzugriff auf ein Repository einer Organisation verwalten](/articles/managing-team-access-to-an-organization-repository)“ +- "[About teams](/articles/about-teams)" +- "[Managing team access to an organization repository](/articles/managing-team-access-to-an-organization-repository)" diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/adding-people-to-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/adding-people-to-your-organization.md index 9846a95d4344..8fbe26245af4 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/adding-people-to-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/adding-people-to-your-organization.md @@ -1,6 +1,6 @@ --- title: Personen zu Deiner Organisation hinzufügen -intro: 'Du kannst jede beliebige Person mithilfe ihres {% data variables.product.product_name %}-Benutzernamens oder ihrer E-Mail-Adresse zu einem Mitglied Deiner Organisation machen.' +intro: 'Sie können jede beliebige Person mithilfe ihres {% data variables.product.product_name %}-Benutzernamens oder ihrer E-Mail-Adresse zu einem Mitglied Ihrer Organisation machen.' redirect_from: - /articles/adding-people-to-your-organization versions: diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/allowing-people-to-delete-issues-in-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/allowing-people-to-delete-issues-in-your-organization.md index d985b22ffcb2..756c8e803dfc 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/allowing-people-to-delete-issues-in-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/allowing-people-to-delete-issues-in-your-organization.md @@ -1,6 +1,6 @@ --- title: Personen das Löschen von Issues in Deiner Organisation erlauben -intro: 'Organisationsinhaber können es bestimmten Personen erlauben, Issues in Repositorys zu löschen, die Deiner Organisation gehören.' +intro: Organisationsinhaber können es bestimmten Personen erlauben, Issues in Repositorys zu löschen, die Deiner Organisation gehören. redirect_from: - /articles/allowing-people-to-delete-issues-in-your-organization versions: diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/approving-oauth-apps-for-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/approving-oauth-apps-for-your-organization.md index 58e7c62f540e..d5ec019b99b3 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/approving-oauth-apps-for-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/approving-oauth-apps-for-your-organization.md @@ -8,7 +8,7 @@ versions: free-pro-team: '*' --- -Wenn Beschränkungen für den {% data variables.product.prodname_oauth_app %}-Zugriff aktiviert sind, müssen Organisationsmitglieder [die Genehmigung von einem Organisationsinhaber anfordern](/articles/requesting-organization-approval-for-oauth-apps), bevor sie eine {% data variables.product.prodname_oauth_app %} autorisieren können, die Zugriff auf die Ressourcen der Organisation hat. +Wenn Einschränkungen für den {% data variables.product.prodname_oauth_app %}-Zugriff aktiviert sind, müssen Organisationsmitglieder [die Genehmigung von einem Organisationsinhaber anfordern](/articles/requesting-organization-approval-for-oauth-apps), bevor sie eine {% data variables.product.prodname_oauth_app %} autorisieren können, die Zugriff auf die Ressourcen der Organisation hat. {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/canceling-an-invitation-to-become-an-outside-collaborator-in-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/canceling-an-invitation-to-become-an-outside-collaborator-in-your-organization.md index 96f8416465b0..b99a151cbfd5 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/canceling-an-invitation-to-become-an-outside-collaborator-in-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/canceling-an-invitation-to-become-an-outside-collaborator-in-your-organization.md @@ -1,7 +1,7 @@ --- -title: 'Eine Einladung zurückziehen, externen Mitarbeiter Deiner Organisation zu werden' -intro: 'Du kannst alle Einladungen für eine Person zurückziehen, externer Mitarbeiter auf Repositorys zu werden, die Deiner Organisation gehören.' -permissions: 'Organisationsinhaber können Einladungen zurückziehen, externer Mitarbeiter in der Organisation zu werden.' +title: Eine Einladung zurückziehen, externen Mitarbeiter Deiner Organisation zu werden +intro: Du kannst alle Einladungen für eine Person zurückziehen, externer Mitarbeiter auf Repositorys zu werden, die Deiner Organisation gehören. +permissions: Organisationsinhaber können Einladungen zurückziehen, externer Mitarbeiter in der Organisation zu werden. versions: free-pro-team: '*' --- diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/canceling-or-editing-an-invitation-to-join-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/canceling-or-editing-an-invitation-to-join-your-organization.md index c6d4e42fcd59..594874b6e080 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/canceling-or-editing-an-invitation-to-join-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/canceling-or-editing-an-invitation-to-join-your-organization.md @@ -1,6 +1,6 @@ --- title: Eine Einladung zum Beitritt zu Deiner Organisation abbrechen oder bearbeiten -intro: 'Organisationsinhaber können eine Einladung zum Beitritt zu Deiner Organisation jederzeit abbrechen oder bearbeiten, solange der Benutzer sie noch nicht angenommen hat.' +intro: Organisationsinhaber können eine Einladung zum Beitritt zu Deiner Organisation jederzeit abbrechen oder bearbeiten, solange der Benutzer sie noch nicht angenommen hat. redirect_from: - /articles/canceling-or-editing-an-invitation-to-join-your-organization versions: diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/changing-team-visibility.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/changing-team-visibility.md index 2beed9672b82..89fce8a723c3 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/changing-team-visibility.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/changing-team-visibility.md @@ -1,6 +1,6 @@ --- title: Sichtbarkeit eines Teams ändern -intro: 'Team-Betreuer und Organisationsinhaber können festlegen, ob ein Team *sichtbar* oder *geheim* ist.' +intro: Team-Betreuer und Organisationsinhaber können festlegen, ob ein Team *sichtbar* oder *geheim* ist. redirect_from: - /articles/changing-team-visibility versions: diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md index f261617415ce..7405c61ba6cf 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md @@ -15,8 +15,8 @@ SAML SSO steuert und sichert den Zugriff auf Organisationsressourcen wie Reposit Nachdem Du SCIM aktiviert hast, stehen Dir folgende Bereitstellungsfunktionen für alle Benutzer zur Verfügung, denen Du Deine {% data variables.product.prodname_ghe_cloud %}-Anwendung in Okta zuweist. -| Funktion | Beschreibung | -| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| Funktion | Beschreibung | +| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Push neuer Benutzer | Wenn Du in Okta einen neuen Benutzer erstellst, wird der Benutzer eine E-Mail-Einladung zu Deiner {% data variables.product.prodname_dotcom %}-Organisation erhalten. | | Push Benutzer-Deaktivierung | Wenn Du einen Benutzer in Okta deaktivierst, wird ihn Okta auch von Deiner {% data variables.product.prodname_dotcom %}-Organisation entfernen. | | Push Profil-Aktualisierungen | Wenn Du ein Benutzerprofil in Okta aktualisierst, wird Okta die Metadaten für die Mitgliedschaft des Benutzers in Deiner {% data variables.product.prodname_dotcom %}-Organisation aktualisieren. | diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md new file mode 100644 index 000000000000..5934c0738154 --- /dev/null +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md @@ -0,0 +1,16 @@ +--- +title: Configuring the retention period for GitHub Actions artifacts and logs in your organization +intro: 'You can configure the retention period for {% data variables.product.prodname_actions %} artifacts and logs in your organization.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.23' +--- + +{% data reusables.actions.about-artifact-log-retention %} + +## Setting the retention period for an organization + +{% data reusables.organizations.navigate-to-org %} +{% data reusables.organizations.org_settings %} +{% data reusables.organizations.settings-sidebar-actions %} +{% data reusables.github-actions.change-retention-period-for-artifacts-logs %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/connecting-your-identity-provider-to-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/connecting-your-identity-provider-to-your-organization.md index c01b43d613e1..84766170391b 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/connecting-your-identity-provider-to-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/connecting-your-identity-provider-to-your-organization.md @@ -8,7 +8,7 @@ versions: free-pro-team: '*' --- -Vor der [Aktivierung von SAML SSO](/articles/enabling-and-testing-saml-single-sign-on-for-your-organization) in Deiner {% data variables.product.product_name %}-Organisation musst Du Deinen Identitätsanbieter (IdP Identity Provider) mit Deiner Organisation verbinden. +Vor der [Aktivierung von SAML SSO](/articles/enabling-and-testing-saml-single-sign-on-for-your-organization) in Ihrer {% data variables.product.product_name %}-Organisation müssen Sie Ihren Identity Provider (IdP) mit Ihrer Organisation verbinden. Die SAML- und SCIM-Implementierungsdetails für Deinen IdP findest Du in der IdP-Dokumentation: - Active Directory Federation Services (AD FS) [SAML](https://docs.microsoft.com/windows-server/identity/active-directory-federation-services) diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-member-to-an-outside-collaborator.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-member-to-an-outside-collaborator.md index 3bec415fbf45..c943dc11f2f4 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-member-to-an-outside-collaborator.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-member-to-an-outside-collaborator.md @@ -23,7 +23,7 @@ Weitere Informationen findest Du unter „[Berechtigungsebenen für eine Organis Wir empfehlen Dir, den Zugriff des Organisationsmitglieds auf Repositorys zu überprüfen, um sicherzustellen, dass dessen Zugriff den Erwartungen entspricht. Weitere Informationen findest Du unter „[Den Zugriff einer Person auf ein Repository einer Organisation verwalten](/articles/managing-an-individual-s-access-to-an-organization-repository)“ -Wenn Du ein Organisationsmitglied in einen externen Mitarbeiter umwandelst, werden seine Berechtigungen als Organisationsmitglied drei Monate lang gespeichert. Dadurch kannst Du seine Mitgliedsberechtigungen wiederherstellen, wenn Du innerhalb dieser Zeit{% if currentVersion == "free-pro-team@latest" %} diesen Mitarbeiter einlädst, der Organisation erneut beizutreten{% else %} diesen Mitarbeiter erneut zu Deiner Organisation hinzufügst{% endif %}. Weitere Informationen findest Du unter „[Ehemaliges Mitglied Deiner Organisation wieder einsetzen](/articles/reinstating-a-former-member-of-your-organization).“ +When you convert an organization member to an outside collaborator, their privileges as organization members are saved for three months so that you can restore their membership privileges if you{% if currentVersion == "free-pro-team@latest" %} invite them to rejoin{% else %} add them back to{% endif %} your organization within that time frame. Weitere Informationen findest Du unter „[Ehemaliges Mitglied Deiner Organisation wieder einsetzen](/articles/reinstating-a-former-member-of-your-organization).“ {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/converting-an-outside-collaborator-to-an-organization-member.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/converting-an-outside-collaborator-to-an-organization-member.md index 469e9d05329f..be985f927923 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/converting-an-outside-collaborator-to-an-organization-member.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/converting-an-outside-collaborator-to-an-organization-member.md @@ -1,6 +1,6 @@ --- -title: Einen externen Mitarbeiter in ein Organisationsmitglied umwandeln -intro: 'Wenn Du einem externen Mitarbeiter der Repositorys Deiner Organisation umfassendere Berechtigungen innerhalb Deiner Organisation gewähren möchtest, kannst Du {% if currentVersion == "free-pro-team@latest" %}ihn dazu einladen, Mitglied Deiner Organisation zu werden{% else %}ihn zu einem Mitglied Deiner Organisation machen{% endif %}.' +title: Converting an outside collaborator to an organization member +intro: 'If you would like to give an outside collaborator on your organization''s repositories broader permissions within your organization, you can {% if currentVersion == "free-pro-team@latest" %}invite them to become a member of{% else %}make them a member of{% endif %} the organization.' redirect_from: - /articles/converting-an-outside-collaborator-to-an-organization-member versions: @@ -11,9 +11,9 @@ versions: {% tip %} **Tips**: -- Nur Organisationsinhaber können {% if currentVersion == "free-pro-team@latest" %}Benutzer zum Beitritt zur Organisation einladen{% else %}Benutzer zur Organisation hinzufügen{% endif %}. Weitere Informationen findest Du unter „[Berechtigungsebenen für eine Organisation](/articles/permission-levels-for-an-organization)“.{% if currentVersion == "free-pro-team@latest" %} -- Wenn Deine Organisation ein benutzerabhängiges Abonnement abgeschlossen hat, muss eine Lizenz verfügbar sein, bevor Du ein neues Mitglied zur Organisation einladen oder ein ehemaliges Organisationsmitglied wieder einsetzen kannst. Weitere Informationen finden Sie unter „[Informationen zur benutzerabhängigen Preisgestaltung](/articles/about-per-user-pricing)“. {% data reusables.organizations.org-invite-expiration %}{% endif %} -- Wenn Deine Organisation [die Zwei-Faktor-Authentifizierung für Mitglieder vorschreibt](/articles/requiring-two-factor-authentication-in-your-organization), müssen die Benutzer{% if currentVersion == "free-pro-team@latest" %}, die Du einlädst, [die Zwei-Faktor-Authentifizierung aktivieren](/articles/securing-your-account-with-two-factor-authentication-2fa), bevor sie die Einladung annehmen können.{% else %}[ die Zwei-Faktor-Authentifizierung aktivieren](/articles/securing-your-account-with-two-factor-authentication-2fa), bevor Du sie zur Organisation hinzufügen kannst.{% endif %} +- Only organization owners can {% if currentVersion == "free-pro-team@latest" %}invite users to join{% else %}add users to{% endif %} an organization. For more information, see "[Permission levels for an organization](/articles/permission-levels-for-an-organization)."{% if currentVersion == "free-pro-team@latest" %} +- If your organization is on a paid per-user subscription, an unused license must be available before you can invite a new member to join the organization or reinstate a former organization member. For more information, see "[About per-user pricing](/articles/about-per-user-pricing)." {% data reusables.organizations.org-invite-expiration %}{% endif %} +- If your organization [requires members to use two-factor authentication](/articles/requiring-two-factor-authentication-in-your-organization), users {% if currentVersion == "free-pro-team@latest" %}you invite must [enable two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa) before they can accept the invitation.{% else %}must [enable two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa) before you can add them to the organization.{% endif %} {% endtip %} @@ -22,10 +22,9 @@ versions: {% data reusables.organizations.people %} {% data reusables.organizations.people_tab_outside_collaborators %} {% if currentVersion == "free-pro-team@latest" %} -5. To the right of the name of the outside collaborator you want to become a member, use the -{% octicon "gear" aria-label="The gear icon" %} drop-down menu and click **Invite to organization**.![Externe Mitarbeiter zur Organisation einladen](/assets/images/help/organizations/invite_outside_collaborator_to_organization.png) +5. To the right of the name of the outside collaborator you want to become a member, use the {% octicon "gear" aria-label="The gear icon" %} drop-down menu and click **Invite to organization**.![Invite outside collaborators to organization](/assets/images/help/organizations/invite_outside_collaborator_to_organization.png) {% else %} -5. Klicke rechts neben dem Namen des externen Mitarbeiters, der Mitglied werden soll, auf **Invite to organization** (Zur Organisation einladen).![Externe Mitarbeiter zur Organisation einladen](/assets/images/enterprise/orgs-and-teams/invite_outside_collabs_to_org.png) +5. To the right of the name of the outside collaborator you want to become a member, click **Invite to organization**.![Invite outside collaborators to organization](/assets/images/enterprise/orgs-and-teams/invite_outside_collabs_to_org.png) {% endif %} {% data reusables.organizations.choose-to-restore-privileges %} {% data reusables.organizations.choose-user-role-send-invitation %} @@ -33,6 +32,6 @@ versions: {% data reusables.organizations.user_must_accept_invite_email %} {% data reusables.organizations.cancel_org_invite %} {% endif %} -### Weiterführende Informationen +### Further reading -- „[Ein Organisationsmitglied in einen externen Mitarbeiter umwandeln](/articles/converting-an-organization-member-to-an-outside-collaborator)“ +- "[Converting an organization member to an outside collaborator](/articles/converting-an-organization-member-to-an-outside-collaborator)" diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch.md index 774367017c35..ccaa85b7c068 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch.md @@ -1,6 +1,6 @@ --- title: Eine Organisation von Grund auf neu erstellen -intro: 'Erstelle eine Organisation, um fein abgestufte Zugriffsberechtigungen für Repositorys anzuwenden.' +intro: Erstelle eine Organisation, um fein abgestufte Zugriffsberechtigungen für Repositorys anzuwenden. redirect_from: - /articles/creating-a-new-organization-from-scratch versions: @@ -13,7 +13,7 @@ Wenn Du eine Organisation von Grund auf neu erstellst, sind mit ihr keine Reposi {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.organizations %} {% data reusables.organizations.new-organization %} -4. Folge den Anweisungen, um Deine Organisation zu erstellen. {% if currentVersion == "free-pro-team@latest" %}Weitere Informationen zu den für Dein Team verfügbaren Plänen findest Du unter „[{% data variables.product.prodname_dotcom %}-Produkte](/articles/githubs-products)“.{% endif %} +4. Folge den Anweisungen, um Deine Organisation zu erstellen. {% if currentVersion == "free-pro-team@latest" %}For more information about the plans available for your team, see "[{% data variables.product.prodname_dotcom %}'s products](/articles/githubs-products)."{% endif %} ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/creating-a-team.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/creating-a-team.md index d8c08717c907..5d4a34990ef7 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/creating-a-team.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/creating-a-team.md @@ -1,6 +1,6 @@ --- title: Ein Team erstellen -intro: 'Du kannst unabhängige oder untergeordnete Teams erstellen, um Repository-Berechtigungen und Erwähnungen für Personengruppen zu verwalten.' +intro: Du kannst unabhängige oder untergeordnete Teams erstellen, um Repository-Berechtigungen und Erwähnungen für Personengruppen zu verwalten. redirect_from: - /articles/creating-a-team-early-access-program/ - /articles/creating-a-team diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/deleting-an-organization-account.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/deleting-an-organization-account.md index 52e764e67dfd..7bc17fd7d85c 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/deleting-an-organization-account.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/deleting-an-organization-account.md @@ -1,6 +1,6 @@ --- title: Organisationskonto löschen -intro: 'Wenn Du eine Organisation löschst, werden alle Repositorys, Forks von privaten Repositorys, Wikis, Issues, Pull Requests und Projekt- respektive Organisationsseiten ebenfalls gelöscht. {% if currentVersion == "free-pro-team@latest" %}Der Name der Organisation steht wieder zur Verwendung für ein neues Benutzer- oder Organisationskonto zur Verfügung, und Deine Abrechnung endet.{% endif %}' +intro: 'Wenn Du eine Organisation löschst, werden alle Repositorys, Forks von privaten Repositorys, Wikis, Issues, Pull Requests und Projekt- respektive Organisationsseiten ebenfalls gelöscht. {% if currentVersion == "free-pro-team@latest" %}The organization name becomes available for use on a new user or organization account, and your billing will end.{% endif %}' redirect_from: - /articles/deleting-an-organization-account versions: diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/disabling-oauth-app-access-restrictions-for-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/disabling-oauth-app-access-restrictions-for-your-organization.md index 20d3f7dc3ff6..34dbb9b4ab9c 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/disabling-oauth-app-access-restrictions-for-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/disabling-oauth-app-access-restrictions-for-your-organization.md @@ -1,6 +1,6 @@ --- title: OAuth-App-Zugriffsbeschränkungen für Deine Organisation deaktivieren -intro: 'Organisationsinhaber können Beschränkungen für {% data variables.product.prodname_oauth_app %}s aufheben, die Zugriff auf die Ressourcen der Organisation haben.' +intro: 'Organisationsinhaber können Einschränkungen für {% data variables.product.prodname_oauth_app %}s aufheben, die Zugriff auf die Ressourcen der Organisation haben.' redirect_from: - /articles/disabling-third-party-application-restrictions-for-your-organization/ - /articles/disabling-oauth-app-access-restrictions-for-your-organization diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md index 681bb1207946..536c0ef6595e 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md @@ -17,6 +17,8 @@ Du kannst {% data variables.product.prodname_actions %} für alle Repositories i Alternativ kannst Du {% data variables.product.prodname_actions %} für alle Repository in Deiner Organisation aktivieren, aber die Aktionen limitieren, die ein Workflow ausführen kann. {% data reusables.github-actions.enabled-local-github-actions %} +{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.23" %} + ### {% data variables.product.prodname_actions %}-Berechtigungen für Deine Organisation verwalten {% data reusables.profile.access_profile %} @@ -26,6 +28,42 @@ Alternativ kannst Du {% data variables.product.prodname_actions %} für alle Rep 1. Under **Local and third-party Actions**, select an option. ![Aktiviere, deaktiviere oder limitiere die Aktionen für diese Organisation](/assets/images/help/repository/enable-org-actions.png) 1. Klicke auf **Save** (Speichern). +{% endif %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} + +### {% data variables.product.prodname_actions %}-Berechtigungen für Deine Organisation verwalten + +You can disable all workflows for an organization or set a policy that configures which actions can be used in an organization. + +{% data reusables.actions.actions-use-policy-settings %} + +{% note %} + +**Note:** You might not be able to manage these settings if your organization is managed by an enterprise that has overriding policy. For more information, {% if currentVersion == "free-pro-team@latest" %}"[Enforcing {% data variables.product.prodname_actions %} policies in your enterprise account](/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account)."{% else %}"[Enforcing {% data variables.product.prodname_actions %} policies for your enterprise](/enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise)."{% endif %} + +{% endnote %} + +{% data reusables.profile.access_profile %} +{% data reusables.profile.access_org %} +{% data reusables.organizations.org_settings %} +{% data reusables.organizations.settings-sidebar-actions %} +1. Under **Policies**, select an option. ![Set actions policy for this organization](/assets/images/help/organizations/actions-policy.png) +1. Klicke auf **Save** (Speichern). + +### Allowing specific actions to run + +{% data reusables.actions.allow-specific-actions-intro %} + +{% data reusables.profile.access_profile %} +{% data reusables.profile.access_org %} +{% data reusables.organizations.org_settings %} +{% data reusables.organizations.settings-sidebar-actions %} +1. Under **Policies**, select **Allow specific actions** and add your required actions to the list. ![Add actions to allow list](/assets/images/help/organizations/actions-policy-allow-list.png) +1. Klicke auf **Save** (Speichern). + +{% endif %} + {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} ### Enabling workflows for private repository forks diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization.md index b13b87f8133a..f3231626ad45 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization.md @@ -12,7 +12,7 @@ versions: You can control whether members of your organization can publish websites from repositories in your organization using {% data variables.product.prodname_pages %}. For more information about {% data variables.product.prodname_pages %}, see "[About {% data variables.product.prodname_pages %}](/github/working-with-github-pages/about-github-pages)." -{% if currentVersion != "free-pro-team@latest" %}If your site administrator has enabled Public Pages, {% endif %}{% data variables.product.prodname_pages %} sites are publicly available on the internet, even if the repository for the site is private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %}. Weitere Informationen findest Du unter{% if currentVersion != "free-pro-team@latest" %} „[Konfigurieren {% data variables.product.prodname_pages %} auf Deiner Appliance](/enterprise/admin/installation/configuring-github-pages-on-your-appliance#making-github-pages-publicly-accessible)" und{% endif %} „[Über die Sichtbarkeit des Repositorys](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)." +{% if currentVersion != "free-pro-team@latest" %}If your site administrator has enabled Public Pages, {% endif %}{% data variables.product.prodname_pages %} sites are publicly available on the internet, even if the repository for the site is private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %}. For more information, see{% if currentVersion != "free-pro-team@latest" %} "[Configuring {% data variables.product.prodname_pages %} on your appliance](/enterprise/admin/installation/configuring-github-pages-on-your-appliance#making-github-pages-publicly-accessible)" and{% endif %} "[About repository visibility](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)." ### Disabling publication of {% data variables.product.prodname_pages %} sites @@ -22,5 +22,7 @@ After you disable publication of {% data variables.product.prodname_pages %} sit {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.member-privileges %} -1. Under "Pages creation", unselect **Allow members to publish sites**. ![Unselected checkbox for "Allow members to publish sites" option](/assets/images/help/organizations/org-settings-pages-disable-publication-checkbox.png) -1. Klicke auf **Save** (Speichern). !["Save" button for "Allow members to publish sites" option](/assets/images/help/organizations/org-settings-pages-disable-publication-save-button.png) +1. Under "Pages creation", unselect **Allow members to publish sites**. + ![Unselected checkbox for "Allow members to publish sites" option](/assets/images/help/organizations/org-settings-pages-disable-publication-checkbox.png) +1. Click **Save**. + !["Save" button for "Allow members to publish sites" option](/assets/images/help/organizations/org-settings-pages-disable-publication-save-button.png) diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/downloading-your-organizations-saml-single-sign-on-recovery-codes.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/downloading-your-organizations-saml-single-sign-on-recovery-codes.md index 189a89c411f1..a3fe31d73a33 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/downloading-your-organizations-saml-single-sign-on-recovery-codes.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/downloading-your-organizations-saml-single-sign-on-recovery-codes.md @@ -24,7 +24,7 @@ Wiederherstellungscode sollten nicht öffentlich gemacht und nicht weitergegeben {% endnote %} -7. Wenn Du einen Wiederherstellungscode genutzt hast, um wieder Zugriff auf {% data variables.product.product_name %} zu erhalten, kannst Du diesen Code nicht mehr verwenden. Der Zugriff auf {% data variables.product.product_name %} ist nur 24 Stunden lang verfügbar, bevor Du dazu aufgefordert wirst, Dich mit Single Sign-On anzumelden. +7. Wenn Sie einen Wiederherstellungscode genutzt haben, um wieder Zugriff auf {% data variables.product.product_name %} zu erhalten, können Sie diesen Code nicht mehr verwenden. Der Zugriff auf {% data variables.product.product_name %} ist nur 24 Stunden lang verfügbar, bevor Sie dazu aufgefordert werden, sich mit Single Sign-On anzumelden. ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/enabling-and-testing-saml-single-sign-on-for-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/enabling-and-testing-saml-single-sign-on-for-your-organization.md index 1f174df5ea19..879bbebbc8a8 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/enabling-and-testing-saml-single-sign-on-for-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/enabling-and-testing-saml-single-sign-on-for-your-organization.md @@ -1,6 +1,6 @@ --- title: SAML Single Sign-On für Deine Organisation aktivieren und testen -intro: 'Inhaber und Administratoren von Organisationen können SAML Single-Sign-On aktivieren, um eine zusätzliche Sicherheitsebene für die Organisation zu schaffen.' +intro: Inhaber und Administratoren von Organisationen können SAML Single-Sign-On aktivieren, um eine zusätzliche Sicherheitsebene für die Organisation zu schaffen. product: '{% data reusables.gated-features.saml-sso %}' redirect_from: - /articles/enabling-and-testing-saml-single-sign-on-for-your-organization diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/enabling-oauth-app-access-restrictions-for-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/enabling-oauth-app-access-restrictions-for-your-organization.md index ca8576f84262..3082e4a6aff9 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/enabling-oauth-app-access-restrictions-for-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/enabling-oauth-app-access-restrictions-for-your-organization.md @@ -14,7 +14,7 @@ versions: **Warnings**: - Durch die Aktivierung der {% data variables.product.prodname_oauth_app %}-Zugriffseinschränkungen wird allen zuvor autorisierten {% data variables.product.prodname_oauth_app %}s und SSH-Schlüsseln der Zugriff auf die Organisation entzogen. Weitere Informationen findest Du unter „[Informationen zu {% data variables.product.prodname_oauth_app %}-Zugriffsbeschränkungen](/articles/about-oauth-app-access-restrictions).“ -- Wenn Du die {% data variables.product.prodname_oauth_app %}-Zugriffsbeschränkungen eingerichtet hast, stelle sicher, dass Du alle {% data variables.product.prodname_oauth_app %}s erneut autorisierst, die regelmäßig Zugriff auf die privaten Daten der Organisation benötigen. Alle Organisationsmitglieder müssen neue SSH-Schlüssel erstellen, und die Organisation muss nach Bedarf neue Deployment-Schlüssel erstellen. +- Wenn Sie die {% data variables.product.prodname_oauth_app %}-Zugriffseinschränkungen eingerichtet haben, stellen Sie sicher, dass Sie alle {% data variables.product.prodname_oauth_app %}s erneut autorisieren, die regelmäßig Zugriff auf die privaten Daten der Organisation benötigen. Alle Organisationsmitglieder müssen neue SSH-Schlüssel erstellen, und die Organisation muss nach Bedarf neue Deployment-Schlüssel erstellen. - Wenn {% data variables.product.prodname_oauth_app %}-Zugriffseinschränkungen aktiviert sind, können Anwendungen mit einem OAuth-Token auf Informationen zu {% data variables.product.prodname_marketplace %}-Transaktionen zugreifen. {% endwarning %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/enforcing-saml-single-sign-on-for-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/enforcing-saml-single-sign-on-for-your-organization.md index c9bd281e6a23..9c57756806b3 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/enforcing-saml-single-sign-on-for-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/enforcing-saml-single-sign-on-for-your-organization.md @@ -1,6 +1,6 @@ --- title: SAML Single Sign-On für Deine Organisation erzwingen -intro: 'Inhaber und Administratoren von Organisationen können SAML SSO erzwingen, sodass sich alle Organisationsmitglieder über einen Identitätsanbieter (IdP) authentifizieren müssen.' +intro: Inhaber und Administratoren von Organisationen können SAML SSO erzwingen, sodass sich alle Organisationsmitglieder über einen Identitätsanbieter (IdP) authentifizieren müssen. product: '{% data reusables.gated-features.saml-sso %}' redirect_from: - /articles/enforcing-saml-single-sign-on-for-your-organization diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/index.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/index.md index 2d4b312eff77..054b97ec77eb 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/index.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/index.md @@ -1,7 +1,7 @@ --- title: Organisationen und Teams einrichten und verwalten shortTitle: Organisationen und Teams -intro: 'Arbeite an zahlreichen Projekten zusammen, verwalte den Zugriff auf Projekte und Daten, und passe die Einstellungen für Deine Organisation an.' +intro: Arbeite an zahlreichen Projekten zusammen, verwalte den Zugriff auf Projekte und Daten, und passe die Einstellungen für Deine Organisation an. redirect_from: - /articles/about-improved-organization-permissions/ - /categories/setting-up-and-managing-organizations-and-teams @@ -100,6 +100,7 @@ versions: {% link_in_list /managing-the-forking-policy-for-your-organization %} {% link_in_list /disabling-or-limiting-github-actions-for-your-organization %} + {% link_in_list /entering-a-data-protection-agreement-with-github-for-gdpr-compliance %} {% link_in_list /setting-permissions-for-adding-outside-collaborators %} @@ -131,7 +132,6 @@ versions: {% link_in_list /upgrading-to-the-corporate-terms-of-service %} - {% link_in_list /entering-a-data-protection-agreement-with-github-for-gdpr-compliance %} {% topic_link_in_list /migrating-to-improved-organization-permissions %} {% link_in_list /converting-an-owners-team-to-improved-organization-permissions %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md index d73a74175bbe..c7dcea4e2766 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md @@ -1,6 +1,7 @@ --- title: Benutzer zum Beitritt zu Deiner Organisation einladen -intro: 'Du kannst jede beliebige Person mithilfe ihres {% data variables.product.product_name %}-Benutzernamens oder ihrer E-Mail-Adresse dazu einladen, Mitglied Deiner Organisation zu werden.' +intro: 'Sie können jede beliebige Person mithilfe ihres {% data variables.product.product_name %}-Benutzernamens oder ihrer E-Mail-Adresse dazu einladen, Mitglied Ihrer Organisation zu werden.' +permissions: Organization owners can invite users to join an organization. redirect_from: - /articles/adding-or-inviting-members-to-a-team-in-an-organization/ - /articles/inviting-users-to-join-your-organization @@ -11,9 +12,8 @@ versions: {% tip %} **Tips**: -- Nur Organisationsinhaber können Benutzer zu einer Organisation einladen. Weitere Informationen finden Sie unter „[Berechtigungsebenen für eine Organisation](/articles/permission-levels-for-an-organization)". - Wenn Deine Organisation ein benutzerabhängiges Abonnement abgeschlossen hat, muss eine Lizenz verfügbar sein, bevor Du ein neues Mitglied zur Organisation einladen oder ein ehemaliges Organisationsmitglied wieder einsetzen kannst. Weitere Informationen finden Sie unter „[Informationen zur benutzerabhängigen Preisgestaltung](/articles/about-per-user-pricing)“. {% data reusables.organizations.org-invite-expiration %} -- Wenn Dein Unternehmen [die Zwei-Faktor-Authentifizierung für Mitglieder vorschreibt](/articles/requiring-two-factor-authentication-in-your-organization), müssen die von Dir eingeladenen Benutzer [die Zwei-Faktor-Authentifizierung aktivieren](/articles/securing-your-account-with-two-factor-authentication-2fa), bevor sie die Einladung annehmen können. +- If your organization requires members to use two-factor authentication, users that you invite must enable two-factor authentication before accepting the invitation. For more information, see "[Requiring two-factor authentication in your organization](/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization)" and "[Securing your account with two-factor authentication (2FA)](/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa)." {% endtip %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/maintaining-ownership-continuity-for-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/maintaining-ownership-continuity-for-your-organization.md index 60db61163326..4d2dc4c6df31 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/maintaining-ownership-continuity-for-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/maintaining-ownership-continuity-for-your-organization.md @@ -1,6 +1,6 @@ --- title: Aufrechterhaltung der Inhaberkontinuität für Deine Organisation -intro: 'Organisationen können mehr als einen Organisationsinhaber haben, um Inhaberlücken zu vermeiden.' +intro: Organisationen können mehr als einen Organisationsinhaber haben, um Inhaberlücken zu vermeiden. redirect_from: - /articles/changing-a-person-s-role-to-owner - /articles/changing-a-persons-role-to-owner diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-a-project-board-for-organization-members.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-a-project-board-for-organization-members.md index be7ab9c370a6..c7b6fb9b3798 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-a-project-board-for-organization-members.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-a-project-board-for-organization-members.md @@ -1,6 +1,6 @@ --- title: Zugriff auf ein Projektboard für Organisationsmitglieder verwalten -intro: Als Organisationsinhaber oder Projektboard-Administrator kannst Du eine standardmäßige Berechtigungsebene für ein Projektboard für alle Organisationsmitglieder festlegen. +intro: 'Als Organisationsinhaber oder Projektboard-Administrator kannst Du eine standardmäßige Berechtigungsebene für ein Projektboard für alle Organisationsmitglieder festlegen.' redirect_from: - /articles/managing-access-to-a-project-board-for-organization-members versions: diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-your-organizations-apps.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-your-organizations-apps.md index 940f9eb56002..be9539bddbca 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-your-organizations-apps.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-your-organizations-apps.md @@ -1,6 +1,6 @@ --- title: Zugriff auf die Apps Deiner Organisation verwalten -intro: 'Als Organisationsinhaber kannst Du es einzelnen Organisationsmitgliedern erlauben, {% data variables.product.prodname_github_app %}s in Deiner Organisation zu verwalten.' +intro: 'Als Organisationsinhaber können Sie es einzelnen Organisationsmitgliedern erlauben, {% data variables.product.prodname_github_app %}s in Ihrer Organisation zu verwalten.' redirect_from: - /articles/managing-access-to-your-organization-s-apps - /articles/managing-access-to-your-organizations-apps diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-allowed-ip-addresses-for-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-allowed-ip-addresses-for-your-organization.md index 51ba569fe23b..0455b1bb2a75 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-allowed-ip-addresses-for-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-allowed-ip-addresses-for-your-organization.md @@ -1,6 +1,6 @@ --- title: Verwaltung erlaubter IP-Adressen für Deine Organisation -intro: 'Du kannst den Zugriff auf die Objekte Deiner Organisation einschränken, indem Du eine Liste von IP-Adressen konfigurierst, die zu einer Verbindung berechtigt sind.' +intro: Du kannst den Zugriff auf die Objekte Deiner Organisation einschränken, indem Du eine Liste von IP-Adressen konfigurierst, die zu einer Verbindung berechtigt sind. product: '{% data reusables.gated-features.allowed-ip-addresses %}' versions: free-pro-team: '*' diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md index bbc2a121357a..fde637b93319 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md @@ -1,6 +1,6 @@ --- title: Zugriff einer Einzelperson auf das Projektboard einer Organisation verwalten -intro: Als Organisationsinhaber oder Projektboard-Administrator kannst Du den Zugriff einzelner Mitglieder auf ein Projektboard Deiner Organisation verwalten. +intro: 'Als Organisationsinhaber oder Projektboard-Administrator kannst Du den Zugriff einzelner Mitglieder auf ein Projektboard Deiner Organisation verwalten.' redirect_from: - /articles/managing-an-individual-s-access-to-an-organization-project-board - /articles/managing-an-individuals-access-to-an-organization-project-board @@ -24,7 +24,9 @@ versions: {% data reusables.project-management.click-menu %} {% data reusables.project-management.access-collaboration-settings %} {% data reusables.project-management.collaborator-option %} -9. Gib unter „Search by username, full name or email address“ (Nach Benutzernamen, vollständigem Namen oder E-Mail-Adresse suchen) den Namen, den Benutzernamen oder die {% data variables.product.prodname_dotcom %}-E-Mail-Adresse des Mitarbeiters ein. ![Der Bereich „Collaborators“ (Mitarbeiter) mit Octocat-Benutzernamen im Suchfeld](/assets/images/help/projects/org-project-collaborators-find-name.png) +9. Under "Search by username, full name or email address", type the collaborator's name, username, or +{% data variables.product.prodname_dotcom %} email. + ![Der Bereich „Collaborators“ (Mitarbeiter) mit Octocat-Benutzernamen im Suchfeld](/assets/images/help/projects/org-project-collaborators-find-name.png) {% data reusables.project-management.add-collaborator %} {% data reusables.project-management.collaborator-permissions %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-repository.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-repository.md index 2fb11db69da0..2090f6a3d1ec 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-repository.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-repository.md @@ -30,5 +30,5 @@ Wenn Du einen Mitarbeiter aus einem Repository Deiner Organisation entfernst, ve ### Weiterführende Informationen -{% if currentVersion == "free-pro-team@latest" %}„[Interaktionen mit Deinem Repository einschränken](/articles/limiting-interactions-with-your-repository)“{% endif %} +{% if currentVersion == "free-pro-team@latest" %}- "[Limiting interactions with your repository](/articles/limiting-interactions-with-your-repository)"{% endif %} - „[Berechtigungsebenen für die Repositorys einer Organisation](/articles/repository-permission-levels-for-an-organization)“ diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-bots-and-service-accounts-with-saml-single-sign-on.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-bots-and-service-accounts-with-saml-single-sign-on.md index 12698283a57e..1cd92899ea55 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-bots-and-service-accounts-with-saml-single-sign-on.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-bots-and-service-accounts-with-saml-single-sign-on.md @@ -1,6 +1,6 @@ --- title: Bots und Dienstkonten mit SAML Single-Sign-On verwalten -intro: 'Organisationen, für die SAML Single-Sign-On aktiviert ist, können den Zugriff von Bots und Dienstkonten beibehalten.' +intro: Organisationen, für die SAML Single-Sign-On aktiviert ist, können den Zugriff von Bots und Dienstkonten beibehalten. product: '{% data reusables.gated-features.saml-sso %}' redirect_from: - /articles/managing-bots-and-service-accounts-with-saml-single-sign-on diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team.md index 9d1bddece8d8..d03868469063 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team.md @@ -1,6 +1,6 @@ --- title: Code-Review-Zuweisung für Dein Team verwalten -intro: 'Die Zuweisung von Code-Reviews zeigt deutlich an, welche Mitglieder eines Teams einen Review für einen Pull Request einreichen sollen.' +intro: Die Zuweisung von Code-Reviews zeigt deutlich an, welche Mitglieder eines Teams einen Review für einen Pull Request einreichen sollen. product: '{% data reusables.gated-features.code-review-assignment %}' versions: free-pro-team: '*' diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-default-labels-for-repositories-in-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-default-labels-for-repositories-in-your-organization.md index 7c6c2172d51a..2956920a31d8 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-default-labels-for-repositories-in-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-default-labels-for-repositories-in-your-organization.md @@ -1,6 +1,6 @@ --- title: Standardkennzeichnungen für Repositorys in Deiner Organisation verwalten -intro: 'Du kannst die Kennzeichnungen anpassen, die in jedem neuen Repository Deiner Organisation enthalten sind.' +intro: Du kannst die Kennzeichnungen anpassen, die in jedem neuen Repository Deiner Organisation enthalten sind. redirect_from: - /articles/managing-default-labels-for-repositories-in-your-organization versions: diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md index 37a83c0716fe..1e7df1015234 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md @@ -1,6 +1,6 @@ --- title: Git-Zugriff auf die Repositorys Deiner Organisation verwalten -intro: 'Du kannst Deiner Organisation eine SSH-Zertifizierungsstelle (CA) hinzufügen und erlauben, dass Mitglieder über Git mit den von der SSH-Zertifizierungsstelle signierten Schlüsseln auf die Repositorys der Organisation zugreifen können.' +intro: Du kannst Deiner Organisation eine SSH-Zertifizierungsstelle (CA) hinzufügen und erlauben, dass Mitglieder über Git mit den von der SSH-Zertifizierungsstelle signierten Schlüsseln auf die Repositorys der Organisation zugreifen können. mapTopic: true product: '{% data reusables.gated-features.ssh-certificate-authorities %}' redirect_from: @@ -8,6 +8,6 @@ redirect_from: - /articles/managing-git-access-to-your-organizations-repositories versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-membership-in-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-membership-in-your-organization.md index 096aec2fc7ba..12d94a8edfce 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-membership-in-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-membership-in-your-organization.md @@ -1,6 +1,6 @@ --- title: Mitgliedschaft in Deiner Organisation verwalten -intro: 'Nachdem Du Deine Organisation erstellt hast, kannst Du {% if currentVersion == "free-pro-team@latest" %}Personen dazu einladen, Mitglieder Deiner Organisation zu werden{% else %}Personen als Mitglieder zur Organisation hinzufügen{% endif %}. Du kannst auch Mitglieder aus der Organisation entfernen und ehemalige Mitglieder wieder einsetzen.' +intro: 'After you create your organization, you can {% if currentVersion == "free-pro-team@latest" %}invite people to become{% else %}add people as{% endif %} members of the organization. Du kannst auch Mitglieder aus der Organisation entfernen und ehemalige Mitglieder wieder einsetzen.' redirect_from: - /articles/removing-a-user-from-your-organization/ - /articles/managing-membership-in-your-organization diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-your-organization.md index 3912e9d85caa..73d6f9985c9f 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-your-organization.md @@ -1,6 +1,6 @@ --- title: Geplante Erinnerungen für Deine Organisation verwalten -intro: 'Du kannst in Slack Erinnerungen für alle Pull Requests erhalten, für die Teams in Deiner Organisation zum Review angefordert wurden.' +intro: Du kannst in Slack Erinnerungen für alle Pull Requests erhalten, für die Teams in Deiner Organisation zum Review angefordert wurden. versions: free-pro-team: '*' --- diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-your-team.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-your-team.md index 2b94913605e5..f0ab1593d581 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-your-team.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-your-team.md @@ -1,6 +1,6 @@ --- title: Geplante Erinnerungen für Dein Team verwalten -intro: 'Du kannst in Slack Erinnerungen erhalten, wenn auf dein Team Pull-Request-Reviews warten.' +intro: Du kannst in Slack Erinnerungen erhalten, wenn auf dein Team Pull-Request-Reviews warten. redirect_from: - /github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests versions: diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-project-board.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-project-board.md index b64515a36f8b..c0022a1111ac 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-project-board.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-project-board.md @@ -1,6 +1,6 @@ --- title: Teamzugriff auf ein Projektboard einer Organisation verwalten -intro: Als Organisationsinhaber oder Projektboard-Administrator kannst Du einem Team Zugriff auf ein Projektboard Deiner Organisation gewähren. +intro: 'Als Organisationsinhaber oder Projektboard-Administrator kannst Du einem Team Zugriff auf ein Projektboard Deiner Organisation gewähren.' redirect_from: - /articles/managing-team-access-to-an-organization-project-board versions: diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md index 98c517ae65c8..11b0f25620a9 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md @@ -1,6 +1,7 @@ --- title: Managing the default branch name for repositories in your organization -intro: You can set the default branch name for repositories that members create in your organization. +intro: 'You can set the default branch name for repositories that members create in your organization.' +permissions: Managing the default branch name for your repositories versions: free-pro-team: '*' enterprise-server: '>=2.23' @@ -8,12 +9,10 @@ versions: ### About the default branch name -When a member of your organization creates a new repository, {% data variables.product.prodname_dotcom %} will create a single branch and set it as the repository's default branch. {% data variables.product.prodname_dotcom %} currently names the default branch `master`, but you can set the default branch to be named anything that makes sense for your development environment. +When a member of your organization creates a new repository, {% data variables.product.prodname_dotcom %} will create a single branch and set it as the repository's default branch. You can change the name that {% data variables.product.product_name %} uses for the default branch in new repositories that members of your organization create. For more information about the default branch, see "[About branches](/github/collaborating-with-issues-and-pull-requests/about-branches#about-the-default-branch)." {% data reusables.branches.set-default-branch %} -{% data reusables.branches.rename-existing-branch %} - ### Setting the default branch name {% data reusables.profile.access_profile %} @@ -31,4 +30,4 @@ When a member of your organization creates a new repository, {% data variables.p ### Weiterführende Informationen -- [Managing the default branch name for your repositories](/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories) +- /github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md index daee2a4f2c59..6fe7feeac7bb 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md @@ -1,12 +1,12 @@ --- title: Anzeige der Mitgliedsnamen in Deiner Organisation verwalten -intro: 'Du kannst festlegen, dass Mitglieder Deiner Organisation den Profilnamen eines Kommentarverfassers in privaten Repositorys in der Organisation anzeigen können.' +intro: Du kannst festlegen, dass Mitglieder Deiner Organisation den Profilnamen eines Kommentarverfassers in privaten Repositorys in der Organisation anzeigen können. product: '{% data reusables.gated-features.display-names %}' redirect_from: - /articles/managing-the-display-of-member-names-in-your-organization versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- Organisationsinhaber können die Anzeige der Mitgliedsnamen in einer Organisation verwalten. diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization.md index c11b799b0fc9..571cb920a4b2 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization.md @@ -1,6 +1,6 @@ --- title: Die Forking-Richtlinie für Deine Organisation verwalten -intro: 'Du kannst das Forken von privaten{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} oder internen{% endif %} Repositorys Deiner Organisation erlauben oder verhindern.' +intro: 'You can can allow or prevent the forking of any private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and internal{% endif %} repositories owned by your organization.' redirect_from: - /articles/allowing-people-to-fork-private-repositories-in-your-organization - /github/setting-up-and-managing-organizations-and-teams/allowing-people-to-fork-private-repositories-in-your-organization @@ -10,9 +10,9 @@ versions: enterprise-server: '*' --- -Standardmäßig sind neue Organisationen so konfiguriert, dass sie das Forken von privaten{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} und internen{% endif %} Repositorys verbieten. +By default, new organizations are configured to disallow the forking of private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and internal{% endif %} repositories. -Wenn Du das Forken von privaten{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} und internen{% endif %} Repositorys auf Organisationsebene zulässt, kannst Du auch die Möglichkeit konfigurieren, ein bestimmtes privates{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} oder internes{% endif %} Repository zu forken. Weitere Informationen findest Du unter „[Die Forking-Richtlinie für Dein Repository verwalten](/github/administering-a-repository/managing-the-forking-policy-for-your-repository)." +If you allow forking of private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and internal{% endif %} repositories at the organization level, you can also configure the ability to fork a specific private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %} repository. Weitere Informationen findest Du unter „[Die Forking-Richtlinie für Dein Repository verwalten](/github/administering-a-repository/managing-the-forking-policy-for-your-repository)." {% data reusables.organizations.internal-repos-enterprise %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md index 27d9e168d530..e76fa837be33 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md @@ -6,7 +6,7 @@ redirect_from: - /articles/managing-your-organizations-ssh-certificate-authorities versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- Organisationsinhaber können die SSH-Zertifizierungsstellen (CA) einer Organisation verwalten. diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/moving-a-team-in-your-organizations-hierarchy.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/moving-a-team-in-your-organizations-hierarchy.md index 45778b7a91e6..87fe7d2bd42b 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/moving-a-team-in-your-organizations-hierarchy.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/moving-a-team-in-your-organizations-hierarchy.md @@ -1,6 +1,6 @@ --- title: Team innerhalb der Hierarchie Deiner Organisation verschieben -intro: Team-Betreuer und Organisationsinhaber können ein Team einem übergeordneten Team unterordnen oder das übergeordnete Team eines untergeordneten Teams ändern oder entfernen. +intro: 'Team-Betreuer und Organisationsinhaber können ein Team einem übergeordneten Team unterordnen oder das übergeordnete Team eines untergeordneten Teams ändern oder entfernen.' redirect_from: - /articles/changing-a-team-s-parent/ - /articles/moving-a-team-in-your-organization-s-hierarchy diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/organizing-members-into-teams.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/organizing-members-into-teams.md index fe9246752ea0..162da0f5c871 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/organizing-members-into-teams.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/organizing-members-into-teams.md @@ -1,6 +1,6 @@ --- title: Mitglieder in Teams organisieren -intro: 'Du kannst Organisationsmitglieder in Teams einteilen, die mit kaskadierenden Zugriffsberechtigungen und Erwähnungen die Struktur Deines Unternehmens oder Deiner Gruppe widerspiegeln.' +intro: Du kannst Organisationsmitglieder in Teams einteilen, die mit kaskadierenden Zugriffsberechtigungen und Erwähnungen die Struktur Deines Unternehmens oder Deiner Gruppe widerspiegeln. redirect_from: - /articles/setting-up-teams-improved-organization-permissions/ - /articles/setting-up-teams-for-accessing-organization-repositories/ diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md index df18fcf8b9f7..e3b6c6b4df8a 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md @@ -11,7 +11,7 @@ versions: ### Berechtigungsebenen für eine Organisation -Organisationsmitglieder können folgende Rollen haben: *Inhaber*{% if currentVersion == "free-pro-team@latest" %}, *Abrechnungsmanager*,{% endif %} oder *Mitglied*: +Organization members can have *owner*{% if currentVersion == "free-pro-team@latest" %}, *billing manager*,{% endif %} or *member* roles: - **Inhaber** haben vollen administrativen Zugriff auf eine Organisation. Diese Rolle sollte in Deiner Organisation beschränkt verfügbar sein, aber für nicht weniger als zwei Personen. Weitere Informationen findest Du unter „[Die Inhaber-Kontinuität für Deine Organisation aufrechterhalten](/github/setting-up-and-managing-organizations-and-teams/maintaining-ownership-continuity-for-your-organization)." {% if currentVersion == "free-pro-team@latest" %} @@ -22,94 +22,95 @@ Organisationsmitglieder können folgende Rollen haben: *Inhaber*{% if currentVer {% if currentVersion == "free-pro-team@latest" %} -| Aktion in der Organisation | Inhaber | Mitglieder | Abrechnungsmanager | -|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-------:|:----------:|:----------------------------------:| -| Repositorys erstellen (siehe „[Repository-Erstellung in Deiner Organisation einschränken](/articles/restricting-repository-creation-in-your-organization)“) | **X** | **X** | | -| Abrechnungsinformationen anzeigen und bearbeiten | **X** | | **X** | -| Personen zum Beitritt zur Organisation einladen | **X** | | | -| Einladungen zum Beitritt zur Organisation bearbeiten und zurückziehen | **X** | | | -| Mitglied aus der Organisation entfernen | **X** | | | -| Ehemaliges Mitglied der Organisation wieder einsetzen | **X** | | | -| Benutzer zu **allen Teams** hinzufügen oder wieder entfernen | **X** | | | -| Organisationsmitglieder zu *Team-Betreuern* ernennen | **X** | | | -| Code-Review-Zuweisungen konfigurieren (Weitere Informationen findest Du unter „[Code Review-Zuweisung für Dein Team verwalten](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)") | **X** | | | -| Geplante Erinnerungen setzen (Weitere Informationen findest Du unter „[Geplante Erinnerungen für Pull-Requests verwalten](/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests)") | **X** | | | -| Mitarbeiter zu **allen Repositorys** hinzufügen | **X** | | | -| Auf das Auditprotokoll der Organisation zugreifen | **X** | | | -| Die Profilseite der Organisation bearbeiten (siehe „[Informationen zum Profil Ihrer Organisation](/articles/about-your-organization-s-profile)“) | **X** | | | -| Die Domänen der Organisation überprüfen (siehe „[Domänen Deiner Organisation überprüfen](/articles/verifying-your-organization-s-domain)“) | **X** | | | -| **Alle Teams** löschen | **X** | | | -| Das Organisationskonto einschließlich aller Repositorys löschen | **X** | | | -| Teams erstellen (siehe „[Berechtigungen für die Teamerstellung in Ihrer Organisation festlegen](/articles/setting-team-creation-permissions-in-your-organization)“) | **X** | **X** | | -| [Teams in der Hierarchie einer Organisation verschieben](/articles/moving-a-team-in-your-organization-s-hierarchy) | **X** | | | -| Projektboards erstellen (siehe „[Projektboardberechtigungen für eine Organisation](/articles/project-board-permissions-for-an-organization)“) | **X** | **X** | | -| Alle Organisationsmitglieder und Teams sehen | **X** | **X** | | -| Ein sichtbares Team @erwähnen | **X** | **X** | | -| Kann *Team-Beteuern* werden | **X** | **X** | | -| Einblicke für die Organisation anzeigen (siehe „[Einblicke für Deine Organisation anzeigen ](/articles/viewing-insights-for-your-organization)“) | **X** | **X** | | -| Öffentliche Teamdiskussionen zu **allen Teams** anzeigen und veröffentlichen (siehe „[Informationen zu Teamdiskussionen](/articles/about-team-discussions)“) | **X** | **X** | | -| Private Teamdiskussionen zu **allen Teams** anzeigen und veröffentlichen (siehe „[Informationen zu Teamdiskussionen](/articles/about-team-discussions)“) | **X** | | | -| Teamdiskussionen in **allen Teams** bearbeiten und löschen (siehe „[Störende Kommentare verwalten](/articles/managing-disruptive-comments)“) | **X** | | | -| Kommentare zu Commits, Pull Requests und Issues ausblenden (siehe „[Störende Kommentare verwalten](/articles/managing-disruptive-comments/#hiding-a-comment)“) | **X** | **X** | | -| Teamdiskussionen für eine Organisation deaktivieren (siehe „[Teamdiskussionen innerhalb Ihrer Organisation deaktivieren](/articles/disabling-team-discussions-for-your-organization)“) | **X** | | |{% if currentVersion == "free-pro-team@latest" %} -| Die Anzeige von Abhängigkeiten-Einblicke einer Organisation verwalten (siehe „[Die Sichtbarkeit der Abhängigkeiten-Einblicke Deiner Organisation ändern](/articles/changing-the-visibility-of-your-organizations-dependency-insights)“) | **X** | | |{% endif %} -| Ein Team-Profilbild in **allen Teams** einrichten (siehe „[Profilbild Deines Teams festlegen](/articles/setting-your-team-s-profile-picture)“) | **X** | | | -| Disable publication of {% data variables.product.prodname_pages %} sites from repositories in the organization (see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)" for details) | **X** | | | -| Manage security and analysis settings (see "[Managing security and analysis settings for your organization](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization)" for details) | **X** | | | -| [SAML Single Sign-On](/articles/about-identity-and-access-management-with-saml-single-sign-on) aktivieren und erzwingen | **X** | | | -| [Den SAML-Zugriff eines Benutzers auf Deine Organisation verwalten](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization) | **X** | | | -| Die SSH-Zertifizierungsstellen einer Organisation verwalten (siehe „[SSH-Zertifizierungsstellen Ihrer Organisation verwalten](/articles/managing-your-organizations-ssh-certificate-authorities)“) | **X** | | | -| Repositorys übertragen | **X** | | | -| {% data variables.product.prodname_marketplace %}-Apps erwerben, installieren, kündigen und ihre Abrechnung verwalten | **X** | | | -| Apps auf {% data variables.product.prodname_marketplace %} aufführen | **X** | | | -| Receive [{% data variables.product.prodname_dependabot_alerts %} about vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) for all of an organization's repositories | **X** | | | -| Manage {% data variables.product.prodname_dependabot_security_updates %} (see "[Configuring {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)") | **X** | | | -| [Die Forking-Richtlinie verwalten](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization) | **X** | | | -| [Aktivitäten in öffentlichen Repositorys in einer Organisation einschränken](/articles/limiting-interactions-in-your-organization) | **X** | | | -| Lesen von (pull), Schreiben zu (push) und Kopieren von (clone) *allen Repositorys* der Organisation | **X** | | | -| Organisationsmitglieder in [externe Mitarbeiter](#outside-collaborators) umwandeln | **X** | | | -| [Personen mit Zugriff auf ein Repository der Organisation anzeigen](/articles/viewing-people-with-access-to-your-repository) | **X** | | | -| [Eine Liste der Personen mit Zugriff auf ein Repository der Organisation anzeigen](/articles/viewing-people-with-access-to-your-repository/#exporting-a-list-of-people-with-access-to-your-repository) | **X** | | | -| Standardkennzeichnungen verwalten (siehe „[Standardkennzeichnungen für Repositorys in Deiner Organisation verwalten](/articles/managing-default-labels-for-repositories-in-your-organization)“) | **X** | | | -| Enable team synchronization (see "[Managing team synchronization for your organization](/github/setting-up-and-managing-organizations-and-teams/managing-team-synchronization-for-your-organization)" for details) | **X** | | | +| Aktion in der Organisation | Inhaber | Mitglieder | Abrechnungsmanager | +|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-------:|:----------:|:--------------------------------------------------:| +| Repositorys erstellen (siehe „[Repository-Erstellung in Deiner Organisation einschränken](/articles/restricting-repository-creation-in-your-organization)“) | **X** | **X** | | +| Abrechnungsinformationen anzeigen und bearbeiten | **X** | | **X** | +| Personen zum Beitritt zur Organisation einladen | **X** | | | +| Einladungen zum Beitritt zur Organisation bearbeiten und zurückziehen | **X** | | | +| Mitglied aus der Organisation entfernen | **X** | | | +| Ehemaliges Mitglied der Organisation wieder einsetzen | **X** | | | +| Benutzer zu **allen Teams** hinzufügen oder wieder entfernen | **X** | | | +| Organisationsmitglieder zu *Team-Betreuern* ernennen | **X** | | | +| Code-Review-Zuweisungen konfigurieren (Weitere Informationen findest Du unter „[Code Review-Zuweisung für Dein Team verwalten](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)") | **X** | | | +| Geplante Erinnerungen setzen (Weitere Informationen findest Du unter „[Geplante Erinnerungen für Pull-Requests verwalten](/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests)") | **X** | | | +| Mitarbeiter zu **allen Repositorys** hinzufügen | **X** | | | +| Auf das Auditprotokoll der Organisation zugreifen | **X** | | | +| Die Profilseite der Organisation bearbeiten (siehe „[Informationen zum Profil Ihrer Organisation](/articles/about-your-organization-s-profile)“) | **X** | | | +| Die Domänen der Organisation überprüfen (siehe „[Domänen Deiner Organisation überprüfen](/articles/verifying-your-organization-s-domain)“) | **X** | | | +| **Alle Teams** löschen | **X** | | | +| Das Organisationskonto einschließlich aller Repositorys löschen | **X** | | | +| Teams erstellen (siehe „[Berechtigungen für die Teamerstellung in Ihrer Organisation festlegen](/articles/setting-team-creation-permissions-in-your-organization)“) | **X** | **X** | | +| [Teams in der Hierarchie einer Organisation verschieben](/articles/moving-a-team-in-your-organization-s-hierarchy) | **X** | | | +| Projektboards erstellen (siehe „[Projektboardberechtigungen für eine Organisation](/articles/project-board-permissions-for-an-organization)“) | **X** | **X** | | +| Alle Organisationsmitglieder und Teams sehen | **X** | **X** | | +| Ein sichtbares Team @erwähnen | **X** | **X** | | +| Kann *Team-Beteuern* werden | **X** | **X** | | +| Einblicke für die Organisation anzeigen (siehe „[Einblicke für Deine Organisation anzeigen ](/articles/viewing-insights-for-your-organization)“) | **X** | **X** | | +| Öffentliche Teamdiskussionen zu **allen Teams** anzeigen und veröffentlichen (siehe „[Informationen zu Teamdiskussionen](/articles/about-team-discussions)“) | **X** | **X** | | +| Private Teamdiskussionen zu **allen Teams** anzeigen und veröffentlichen (siehe „[Informationen zu Teamdiskussionen](/articles/about-team-discussions)“) | **X** | | | +| Teamdiskussionen in **allen Teams** bearbeiten und löschen (siehe „[Störende Kommentare verwalten](/articles/managing-disruptive-comments)“) | **X** | | | +| Kommentare zu Commits, Pull Requests und Issues ausblenden (siehe „[Störende Kommentare verwalten](/articles/managing-disruptive-comments/#hiding-a-comment)“) | **X** | **X** | | +| Teamdiskussionen für eine Organisation deaktivieren (siehe „[Teamdiskussionen innerhalb Ihrer Organisation deaktivieren](/articles/disabling-team-discussions-for-your-organization)“) | **X** | | |{% if currentVersion == "free-pro-team@latest" %} +| Die Anzeige von Abhängigkeiten-Einblicke einer Organisation verwalten (siehe „[Die Sichtbarkeit der Abhängigkeiten-Einblicke Deiner Organisation ändern](/articles/changing-the-visibility-of-your-organizations-dependency-insights)“) | **X** | | |{% endif %} +| Ein Team-Profilbild in **allen Teams** einrichten (siehe „[Profilbild Deines Teams festlegen](/articles/setting-your-team-s-profile-picture)“) | **X** | | | +| Disable publication of {% data variables.product.prodname_pages %} sites from repositories in the organization (see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)" for details) | **X** | | | +| Manage security and analysis settings (see "[Managing security and analysis settings for your organization](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization)" for details) | **X** | | | +| [SAML Single Sign-On](/articles/about-identity-and-access-management-with-saml-single-sign-on) aktivieren und erzwingen | **X** | | | +| [Den SAML-Zugriff eines Benutzers auf Deine Organisation verwalten](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization) | **X** | | | +| Die SSH-Zertifizierungsstellen einer Organisation verwalten (siehe „[SSH-Zertifizierungsstellen Ihrer Organisation verwalten](/articles/managing-your-organizations-ssh-certificate-authorities)“) | **X** | | | +| Repositorys übertragen | **X** | | | +| {% data variables.product.prodname_marketplace %}-Apps erwerben, installieren, kündigen und ihre Abrechnung verwalten | **X** | | | +| Apps auf {% data variables.product.prodname_marketplace %} aufführen | **X** | | | +| Receive [{% data variables.product.prodname_dependabot_alerts %} about vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) for all of an organization's repositories | **X** | | | +| Manage {% data variables.product.prodname_dependabot_security_updates %} (see "[Configuring {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)") | **X** | | | +| [Die Forking-Richtlinie verwalten](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization) | **X** | | | +| [Aktivitäten in öffentlichen Repositorys in einer Organisation einschränken](/articles/limiting-interactions-in-your-organization) | **X** | | | +| Lesen von (pull), Schreiben zu (push) und Kopieren von (clone) *allen Repositorys* der Organisation | **X** | | | +| Organisationsmitglieder in [externe Mitarbeiter](#outside-collaborators) umwandeln | **X** | | | +| [Personen mit Zugriff auf ein Repository der Organisation anzeigen](/articles/viewing-people-with-access-to-your-repository) | **X** | | | +| [Eine Liste der Personen mit Zugriff auf ein Repository der Organisation anzeigen](/articles/viewing-people-with-access-to-your-repository/#exporting-a-list-of-people-with-access-to-your-repository) | **X** | | | +| Standardkennzeichnungen verwalten (siehe „[Standardkennzeichnungen für Repositorys in Deiner Organisation verwalten](/articles/managing-default-labels-for-repositories-in-your-organization)“) | **X** | | | +| Standardkennzeichnungen verwalten (siehe „[Standardkennzeichnungen für Repositorys in Deiner Organisation verwalten](/articles/managing-default-labels-for-repositories-in-your-organization)“) | **X** | | | +| Enable team synchronization (see "[Managing team synchronization for your organization](/github/setting-up-and-managing-organizations-and-teams/managing-team-synchronization-for-your-organization)" for details) | **X** | | | {% else %} -| Aktion in der Organisation | Inhaber | Mitglieder | -|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-------:|:---------------------------------------:| -| Personen zum Beitritt zur Organisation einladen | **X** | | -| Einladungen zum Beitritt zur Organisation bearbeiten und zurückziehen | **X** | | -| Mitglied aus der Organisation entfernen | **X** | | | -| Ehemaliges Mitglied der Organisation wieder einsetzen | **X** | | | -| Benutzer zu **allen Teams** hinzufügen oder wieder entfernen | **X** | | -| Organisationsmitglieder zu *Team-Betreuern* ernennen | **X** | |{% if currentVersion ver_gt "enterprise-server@2.19" %} -| Code-Review-Zuweisungen konfigurieren (Weitere Informationen findest Du unter „[Code Review-Zuweisung für Dein Team verwalten](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)") | **X** | |{% endif %} -| Mitarbeiter zu **allen Repositorys** hinzufügen | **X** | | -| Auf das Auditprotokoll der Organisation zugreifen | **X** | | -| Die Profilseite der Organisation bearbeiten (siehe „[Informationen zum Profil Ihrer Organisation](/articles/about-your-organization-s-profile)“) | **X** | | | -| **Alle Teams** löschen | **X** | | -| Das Organisationskonto einschließlich aller Repositorys löschen | **X** | | -| Teams erstellen (siehe „[Berechtigungen für die Teamerstellung in Ihrer Organisation festlegen](/articles/setting-team-creation-permissions-in-your-organization)“) | **X** | **X** | -| Alle Organisationsmitglieder und Teams sehen | **X** | **X** | -| Ein sichtbares Team @erwähnen | **X** | **X** | -| Kann *Team-Beteuern* werden | **X** | **X** | -| Repositorys übertragen | **X** | |{% if currentVersion ver_gt "enterprise-server@2.18" %} -| Die SSH-Zertifizierungsstellen einer Organisation verwalten (siehe „[SSH-Zertifizierungsstellen Ihrer Organisation verwalten](/articles/managing-your-organizations-ssh-certificate-authorities)“) | **X** | |{% endif %} -| Projektboards erstellen (siehe „[Projektboardberechtigungen für eine Organisation](/articles/project-board-permissions-for-an-organization)“) | **X** | **X** | | -| Öffentliche Teamdiskussionen zu **allen Teams** anzeigen und veröffentlichen (siehe „[Informationen zu Teamdiskussionen](/articles/about-team-discussions)“) | **X** | **X** | | -| Private Teamdiskussionen zu **allen Teams** anzeigen und veröffentlichen (siehe „[Informationen zu Teamdiskussionen](/articles/about-team-discussions)“) | **X** | | | -| Teamdiskussionen in **allen Teams** bearbeiten und löschen (siehe „[Störende Kommentare verwalten](/articles/managing-disruptive-comments)“) | **X** | | | -| Kommentare zu Commits, Pull Requests und Issues ausblenden (siehe „[Störende Kommentare verwalten](/articles/managing-disruptive-comments/#hiding-a-comment)“) | **X** | **X** | **X** | -| Teamdiskussionen für eine Organisation deaktivieren (siehe „[Teamdiskussionen innerhalb Ihrer Organisation deaktivieren](/articles/disabling-team-discussions-for-your-organization)“) | **X** | | | -| Ein Team-Profilbild in **allen Teams** einrichten (siehe „[Profilbild Deines Teams festlegen](/articles/setting-your-team-s-profile-picture)“) | **X** | | |{% if currentVersion ver_gt "enterprise-server@2.22" %} -| Disable publication of {% data variables.product.prodname_pages %} sites from repositories in the organization (see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)" for details) | **X** | | |{% endif %} -| [Teams in der Hierarchie einer Organisation verschieben](/articles/moving-a-team-in-your-organization-s-hierarchy) | **X** | | | -| Lesen von (pull), Schreiben zu (push) und Kopieren von (clone) *allen Repositorys* der Organisation | **X** | | -| Organisationsmitglieder in [externe Mitarbeiter](#outside-collaborators) umwandeln | **X** | | -| [Personen mit Zugriff auf ein Repository der Organisation anzeigen](/articles/viewing-people-with-access-to-your-repository) | **X** | | -| [Eine Liste der Personen mit Zugriff auf ein Repository der Organisation anzeigen](/articles/viewing-people-with-access-to-your-repository/#exporting-a-list-of-people-with-access-to-your-repository) | **X** | |{% if currentVersion ver_gt "enterprise-server@2.19" %} -| Standardkennzeichnungen verwalten (siehe „[Standardkennzeichnungen für Repositorys in Deiner Organisation verwalten](/articles/managing-default-labels-for-repositories-in-your-organization)“) | **X** | |{% endif %} +| Aktion in der Organisation | Inhaber | Mitglieder | +|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-------:|:-----------------------------------------------------------:| +| Personen zum Beitritt zur Organisation einladen | **X** | | +| Einladungen zum Beitritt zur Organisation bearbeiten und zurückziehen | **X** | | +| Mitglied aus der Organisation entfernen | **X** | | | +| Ehemaliges Mitglied der Organisation wieder einsetzen | **X** | | | +| Benutzer zu **allen Teams** hinzufügen oder wieder entfernen | **X** | | +| Organisationsmitglieder zu *Team-Betreuern* ernennen | **X** | |{% if currentVersion ver_gt "enterprise-server@2.19" %} +| Code-Review-Zuweisungen konfigurieren (Weitere Informationen findest Du unter „[Code Review-Zuweisung für Dein Team verwalten](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)") | **X** | |{% endif %} +| Mitarbeiter zu **allen Repositorys** hinzufügen | **X** | | +| Auf das Auditprotokoll der Organisation zugreifen | **X** | | +| Die Profilseite der Organisation bearbeiten (siehe „[Informationen zum Profil Ihrer Organisation](/articles/about-your-organization-s-profile)“) | **X** | | | +| **Alle Teams** löschen | **X** | | +| Das Organisationskonto einschließlich aller Repositorys löschen | **X** | | +| Teams erstellen (siehe „[Berechtigungen für die Teamerstellung in Ihrer Organisation festlegen](/articles/setting-team-creation-permissions-in-your-organization)“) | **X** | **X** | +| Alle Organisationsmitglieder und Teams sehen | **X** | **X** | +| Ein sichtbares Team @erwähnen | **X** | **X** | +| Kann *Team-Beteuern* werden | **X** | **X** | +| Repositorys übertragen | **X** | | +| Die SSH-Zertifizierungsstellen einer Organisation verwalten (siehe „[SSH-Zertifizierungsstellen Ihrer Organisation verwalten](/articles/managing-your-organizations-ssh-certificate-authorities)“) | **X** | | +| Projektboards erstellen (siehe „[Projektboardberechtigungen für eine Organisation](/articles/project-board-permissions-for-an-organization)“) | **X** | **X** | | +| Öffentliche Teamdiskussionen zu **allen Teams** anzeigen und veröffentlichen (siehe „[Informationen zu Teamdiskussionen](/articles/about-team-discussions)“) | **X** | **X** | | +| Private Teamdiskussionen zu **allen Teams** anzeigen und veröffentlichen (siehe „[Informationen zu Teamdiskussionen](/articles/about-team-discussions)“) | **X** | | | +| Teamdiskussionen in **allen Teams** bearbeiten und löschen (siehe „[Störende Kommentare verwalten](/articles/managing-disruptive-comments)“) | **X** | | | +| Kommentare zu Commits, Pull Requests und Issues ausblenden (siehe „[Störende Kommentare verwalten](/articles/managing-disruptive-comments/#hiding-a-comment)“) | **X** | **X** | **X** | +| Teamdiskussionen für eine Organisation deaktivieren (siehe „[Teamdiskussionen innerhalb Ihrer Organisation deaktivieren](/articles/disabling-team-discussions-for-your-organization)“) | **X** | | | +| Ein Team-Profilbild in **allen Teams** einrichten (siehe „[Profilbild Deines Teams festlegen](/articles/setting-your-team-s-profile-picture)“) | **X** | | |{% if currentVersion ver_gt "enterprise-server@2.22" %} +| Disable publication of {% data variables.product.prodname_pages %} sites from repositories in the organization (see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)" for details) | **X** | | |{% endif %} +| [Teams in der Hierarchie einer Organisation verschieben](/articles/moving-a-team-in-your-organization-s-hierarchy) | **X** | | | +| Lesen von (pull), Schreiben zu (push) und Kopieren von (clone) *allen Repositorys* der Organisation | **X** | | +| Organisationsmitglieder in [externe Mitarbeiter](#outside-collaborators) umwandeln | **X** | | +| [Personen mit Zugriff auf ein Repository der Organisation anzeigen](/articles/viewing-people-with-access-to-your-repository) | **X** | | +| [Eine Liste der Personen mit Zugriff auf ein Repository der Organisation anzeigen](/articles/viewing-people-with-access-to-your-repository/#exporting-a-list-of-people-with-access-to-your-repository) | **X** | |{% if currentVersion ver_gt "enterprise-server@2.19" %} +| Standardkennzeichnungen verwalten (siehe „[Standardkennzeichnungen für Repositorys in Deiner Organisation verwalten](/articles/managing-default-labels-for-repositories-in-your-organization)“) | **X** | |{% endif %} {% endif %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-require-two-factor-authentication-in-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-require-two-factor-authentication-in-your-organization.md index 27c4a2db4871..245bbf8c4803 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-require-two-factor-authentication-in-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-require-two-factor-authentication-in-your-organization.md @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -Wir empfehlen Dir, {% if currentVersion == "free-pro-team@latest" %}Organisationsmitglieder, externe Mitarbeiter und Abrechnungsmanager{% else %}Organisationsmitglieder und externe Mitarbeiter{% endif %} mindestens eine Woche vor der Erzwingung von 2FA in Deiner Organisation zu benachrichtigen. +We recommend that you notify {% if currentVersion == "free-pro-team@latest" %}organization members, outside collaborators, and billing managers{% else %}organization members and outside collaborators{% endif %} at least one week before you require 2FA in your organization. Wenn Du für Deine Organisation die Zwei-Faktor-Authentifizierung vorschreibst, werden Mitglieder, externe Mitarbeiter und Abrechnungsmanager (einschließlich Bot-Konten), die keine 2FA verwenden, aus der Organisation entfernt und verlieren den Zugriff auf die Repositorys der Organisation. Gleichzeitig verlieren sie auch den Zugriff auf ihre Forks der privaten Repositorys der Organisation. diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-member-of-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-member-of-your-organization.md index c0c464e37c6e..8e1bea50de9b 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-member-of-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-member-of-your-organization.md @@ -1,6 +1,6 @@ --- title: Ehemaliges Mitglied Deiner Organisation wieder einsetzen -intro: 'Organisationsinhaber können ehemalige Organisationsmitglieder {% if currentVersion == "free-pro-team@latest" %}zum Wiedereintritt in Deine Organisation einladen{% else %}wieder zu Deiner Organisation hinzufügen{% endif%} und auswählen, ob auch die ehemalige Rolle, Zugriffsberechtigungen, Forks und Einstellungen der Person wiederhergestellt werden sollen.' +intro: 'Organization owners can {% if currentVersion == "free-pro-team@latest" %}invite former organization members to rejoin{% else %}add former members to{% endif%} your organization, and choose whether to restore the person''s former role, access permissions, forks, and settings.' redirect_from: - /articles/reinstating-a-former-member-of-your-organization versions: @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -Wenn Du [einen Benutzer aus Deiner Organisation entfernst](/articles/removing-a-member-from-your-organization), [ein Organisationsmitglied in einen externen Mitarbeiter umwandelst](/articles/converting-an-organization-member-to-an-outside-collaborator), oder wenn ein Benutzer aus Deiner Organisation entfernt wird, weil Du [von Mitgliedern und externen Mitarbeitern die Aktivierung der Zwei-Faktor-Authentifizierung (2FA) verlangst](/articles/requiring-two-factor-authentication-in-your-organization), bleiben die Zugriffsberechtigungen und Einstellungen des Benutzers drei Monate lang im System gespeichert. Du kannst die Berechtigungen dieses Benutzers wiederherstellen, wenn Du ihn innerhalb dieses Zeitrahmens wieder zur Organisation {% if currentVersion =="free-pro-team@latest" %}einlädst{% else %}hinzufügst{% endif %}. +Wenn Du [einen Benutzer aus Deiner Organisation entfernst](/articles/removing-a-member-from-your-organization), [ein Organisationsmitglied in einen externen Mitarbeiter umwandelst](/articles/converting-an-organization-member-to-an-outside-collaborator), oder wenn ein Benutzer aus Deiner Organisation entfernt wird, weil Du [von Mitgliedern und externen Mitarbeitern die Aktivierung der Zwei-Faktor-Authentifizierung (2FA) verlangst](/articles/requiring-two-factor-authentication-in-your-organization), bleiben die Zugriffsberechtigungen und Einstellungen des Benutzers drei Monate lang im System gespeichert. You can restore the user's privileges if you {% if currentVersion =="free-pro-team@latest" %}invite{% else %}add{% endif %} them back to the organization within that time frame. {% data reusables.two_fa.send-invite-to-reinstate-user-before-2fa-is-enabled %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-outside-collaborators-access-to-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-outside-collaborators-access-to-your-organization.md index f36f35703f90..90f63f350be0 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-outside-collaborators-access-to-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-outside-collaborators-access-to-your-organization.md @@ -1,6 +1,6 @@ --- -title: Zugriff eines ehemaligen externen Mitarbeiters auf Deine Organisation wieder einsetzen -intro: 'Wenn Du in Deiner Organisation die Zwei-Faktor-Authentifizierung eingeführt hast und ein externer Mitarbeiter aus der Organisation entfernt wurde, weil er die 2FA nicht aktiviert hatte, kannst Du dessen Zugriffsberechtigungen für die Repositorys, Forks und Einstellungen der Organisation wiederherstellen.' +title: Reinstating a former outside collaborator's access to your organization +intro: 'If you required two-factor authentication in your organization and an outside collaborator was removed from the organization for not having 2FA enabled, you can reinstate a former outside collaborator''s access permissions for organization repositories, forks, and settings.' redirect_from: - /articles/reinstating-a-former-outside-collaborator-s-access-to-your-organization - /articles/reinstating-a-former-outside-collaborators-access-to-your-organization @@ -9,25 +9,25 @@ versions: enterprise-server: '*' --- -Wenn der Zugriff eines externen Mitarbeiters auf die privaten Repositorys Deiner Organisation entfernt wurde, weil Du von Deinen [Mitgliedern und externen Mitarbeitern die Aktivierung der Zwei-Faktor-Authentifizierung verlangst](/articles/requiring-two-factor-authentication-in-your-organization), bleiben die Zugriffsberechtigungen und Einstellungen des Benutzers drei Monate lang im System gespeichert. Du kannst die Berechtigungen dieses Benutzers wiederherstellen, wenn Du ihn innerhalb dieses Zeitrahmens wieder zur Organisation {% if currentVersion == "free-pro-team@latest" %}einlädst{% else %}hinzufügst{% endif %}. +If an outside collaborator's access to your organization's private repositories is removed because you've [required members and outside collaborators to enable two-factor authentication](/articles/requiring-two-factor-authentication-in-your-organization), the user's access privileges and settings are saved for three months. You can restore the user's privileges if you {% if currentVersion == "free-pro-team@latest" %}invite{% else %}add{% endif %} them back to the organization within that time frame. {% data reusables.two_fa.send-invite-to-reinstate-user-before-2fa-is-enabled %} -Bei der Wiedereinsetzung eines ehemaligen externen Mitarbeiters kannst Du Folgendes wiederherstellen: - - Die früheren Zugriffsberechtigungen des Benutzers auf die Organisationsrepositorys - - Alle privaten Forks der Repositorys der Organisation - - Die Mitgliedschaft innerhalb der Organisationsteams - - Die früheren Zugriffsrechte und Berechtigungen für die Repositorys der Organisation - - Sterne für die Repositorys der Organisation - - Issue-Zuweisungen innerhalb der Organisation - - Repository-Abonnements (Benachrichtigungseinstellungen für das Beobachten, Nichtbeobachten oder Ignorieren der Repository-Aktivitäten) +When you reinstate a former outside collaborator, you can restore: + - The user's former access to organization repositories + - Any private forks of repositories owned by the organization + - Membership in the organization's teams + - Previous access and permissions for the organization's repositories + - Stars for organization repositories + - Issue assignments in the organization + - Repository subscriptions (notification settings for watching, not watching, or ignoring a repository's activity) {% tip %} **Tips**: - - Nur der Organisationsinhaber kann den Zugriff eines externen Mitarbeiters auf seine Organisation wieder einsetzen. Weitere Informationen finden Sie unter „[Berechtigungsebenen für eine Organisation](/articles/permission-levels-for-an-organization)". - - Auch wenn der Ablauf „Mitglied wieder einsetzen“ unter {% data variables.product.product_location %} für die Beschreibung der Wiedereinsetzung eines externen Mitarbeiters den Begriff „Mitglied“ verwendet, erhält ein ehemaliger externer Mitarbeiter bei der Wiedereinsetzung mit seinen früheren Berechtigungen lediglich seine früheren [Berechtigungen als externer Mitarbeiter](/articles/permission-levels-for-an-organization/#outside-collaborators).{% if currentVersion == "free-pro-team@latest" %} - - Wenn Deine Organisation ein benutzerabhängiges Abonnement abgeschlossen hat, muss eine Lizenz verfügbar sein, bevor Du ein neues Mitglied zur Organisation einladen oder ein ehemaliges Organisationsmitglied wieder einsetzen kannst. Weitere Informationen findest Du unter „[Informationen zu benutzerbasierten Preisen](/articles/about-per-user-pricing)“.{% endif %} + - Only organization owners can reinstate outside collaborators' access to an organization. For more information, see "[Permission levels for an organization](/articles/permission-levels-for-an-organization)." + - The reinstating a member flow on {% data variables.product.product_location %} may use the term "member" to describe reinstating an outside collaborator but if you reinstate this person and keep their previous privileges, they will only have their previous [outside collaborator permissions](/articles/permission-levels-for-an-organization/#outside-collaborators).{% if currentVersion == "free-pro-team@latest" %} + - If your organization has a paid per-user subscription, an unused license must be available before you can invite a new member to join the organization or reinstate a former organization member. For more information, see "[About per-user pricing](/articles/about-per-user-pricing)."{% endif %} {% endtip %} @@ -37,35 +37,37 @@ Bei der Wiedereinsetzung eines ehemaligen externen Mitarbeiters kannst Du Folgen {% data reusables.organizations.invite_member_from_people_tab %} {% data reusables.organizations.reinstate-user-type-username %} {% if currentVersion == "free-pro-team@latest" %} -6. Klicke auf **Invite and reinstate** (Einladen und wieder einsetzen) oder auf **Invite and start fresh** (Einladen und neu beginnen), um festzulegen, ob Du den externen Mitarbeiter mit seinen früheren Zugriffsberechtigungen innerhalb der Organisation wieder einsetzen möchtest oder ob Du die früheren Berechtigungen löschen und neu festlegen möchtest. +6. Choose to restore the outside collaborator's previous privileges in the organization by clicking **Invite and reinstate** or choose to clear their previous privileges and set new access permissions by clicking **Invite and start fresh**. {% warning %} - **Warnung:** Wenn Du einen externen Mitarbeiter in ein Mitglied Deiner Organisation umwandeln möchtest, klicke auf **Invite and start fresh** (Einladen und neu starten), und wähle eine neue Rolle für diese Person aus. Wenn Du jedoch seine Rolle und Berechtigungen neu festlegst, gehen seine privaten Forks der Repositorys der Organisation verloren. Sollen bei der Umwandlung des externen Mitarbeiters zu einem Mitglied Deiner Organisation dessen privaten Forks *erhalten bleiben*, wähle stattdessen **Invite and reinstate** (Einladen und wieder einsetzen) aus. Sobald diese Person die Einladung annimmt, kannst Du sie anschließend durch [Einladung zum Organisationsbeitritt als Mitglied](/articles/converting-an-outside-collaborator-to-an-organization-member) in ein Organisationsmitglied umwandeln. + **Warning:** If you want to upgrade the outside collaborator to a member of your organization, then choose **Invite and start fresh** and choose a new role for this person. Note, however, that this person's private forks of your organization's repositories will be lost if you choose to start fresh. To make the former outside collaborator a member of your organization *and* keep their private forks, choose **Invite and reinstate** instead. Once this person accepts the invitation, you can convert them to an organization member by [inviting them to join the organization as a member](/articles/converting-an-outside-collaborator-to-an-organization-member). {% endwarning %} - ![Auswählen, ob Einstellungen wiederhergestellt werden sollen](/assets/images/help/organizations/choose_whether_to_restore_org_member_info.png) + ![Choose to restore settings or not](/assets/images/help/organizations/choose_whether_to_restore_org_member_info.png) {% else %} -6. Klicke auf **Add and reinstate** (Hinzufügen und wieder einsetzen) oder auf **Add and start fresh** (Hinzufügen und neu beginnen), um festzulegen, ob Du den externen Mitarbeiter mit seinen früheren Zugriffsberechtigungen innerhalb der Organisation wieder einsetzen möchtest oder ob Du die früheren Berechtigungen löschen und neu festlegen möchtest. +6. Choose to restore the outside collaborator's previous privileges in the organization by clicking **Add and reinstate** or choose to clear their previous privileges and set new access permissions by clicking **Add and start fresh**. {% warning %} - **Warnung:** Wenn Du einen externen Mitarbeiter in ein Mitglied Deiner Organisation umwandeln möchtest, klicke auf **Add and start fresh** (Hinzufügen und neu beginnen), und wähle eine neue Rolle für diese Person aus. Wenn Du jedoch seine Rolle und Berechtigungen neu festlegst, gehen seine privaten Forks der Repositorys der Organisation verloren. Sollen bei der Umwandlung des externen Mitarbeiters zu einem Mitglied Deiner Organisation dessen privaten Forks *erhalten bleiben*, wähle stattdessen **Add and reinstate** (Hinzufügen und wieder einsetzen) aus. Danach kannst Du diese Person durch [Hinzufügen zur Organisation als Mitglied](/articles/converting-an-outside-collaborator-to-an-organization-member) in ein Organisationsmitglied umwandeln. + **Warning:** If you want to upgrade the outside collaborator to a member of your organization, then choose **Add and start fresh** and choose a new role for this person. Note, however, that this person's private forks of your organization's repositories will be lost if you choose to start fresh. To make the former outside collaborator a member of your organization *and* keep their private forks, choose **Add and reinstate** instead. Then, you can convert them to an organization member by [adding them to the organization as a member](/articles/converting-an-outside-collaborator-to-an-organization-member). {% endwarning %} - ![Auswählen, ob Einstellungen wiederhergestellt werden sollen](/assets/images/help/organizations/choose_whether_to_restore_org_member_info_ghe.png) + ![Choose to restore settings or not](/assets/images/help/organizations/choose_whether_to_restore_org_member_info_ghe.png) {% endif %} {% if currentVersion == "free-pro-team@latest" %} -7. Wenn Du die früheren Berechtigungen eines ehemaligen externen Mitarbeiters gelöscht hast, wähle eine neue Rolle für den Benutzer aus, und füge ihn optional zu einem oder mehreren Teams hinzu. Klicke dann auf **Send invitation** (Einladung senden). ![Rollen- und Teamoptionen und Schaltfläche „Send invitation“ (Einladung senden)](/assets/images/help/organizations/add-role-send-invitation.png) +7. If you cleared the previous privileges for a former outside collaborator, choose a role for the user and optionally add them to some teams, then click **Send invitation**. + ![Role and team options and send invitation button](/assets/images/help/organizations/add-role-send-invitation.png) {% else %} -7. Wenn Du die früheren Berechtigungen eines ehemaligen externen Mitarbeiters gelöscht hast, wähle eine neue Rolle für den Benutzer aus, und füge ihn optional zu einem oder mehreren Teams hinzu. Klicke dann auf **Add member** (Mitglied hinzufügen). ![Rollen- und Teamoptionen und Schaltfläche „Add member“ (Mitglied hinzufügen)](/assets/images/help/organizations/add-role-add-member.png) +7. If you cleared the previous privileges for a former outside collaborator, choose a role for the user and optionally add them to some teams, then click **Add member**. + ![Role and team options and add member button](/assets/images/help/organizations/add-role-add-member.png) {% endif %} {% if currentVersion == "free-pro-team@latest" %} -8. Die eingeladene Person erhält per E-Mail eine Einladung zur Organisation. Um externer Mitarbeiter der Organisation zu werden, muss die eingeladene Person die Einladung annehmen. {% data reusables.organizations.cancel_org_invite %} +8. The invited person will receive an email inviting them to the organization. They will need to accept the invitation before becoming an outside collaborator in the organization. {% data reusables.organizations.cancel_org_invite %} {% endif %} -### Weiterführende Informationen +### Further Reading -- „[Berechtigungsebenen für die Repositorys einer Organisation](/articles/repository-permission-levels-for-an-organization)“ +- "[Repository permission levels for an organization](/articles/repository-permission-levels-for-an-organization)" diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/removing-an-outside-collaborator-from-an-organization-project-board.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/removing-an-outside-collaborator-from-an-organization-project-board.md index 826d16a65831..0ce56c15de05 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/removing-an-outside-collaborator-from-an-organization-project-board.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/removing-an-outside-collaborator-from-an-organization-project-board.md @@ -1,6 +1,6 @@ --- title: Externen Mitarbeiter von einem Projektboard der Organisation entfernen -intro: Als Organisationsinhaber oder Projektboard-Administrator kannst Du den Zugriff eines externen Mitarbeiters auf ein Projektboard entfernen. +intro: 'Als Organisationsinhaber oder Projektboard-Administrator kannst Du den Zugriff eines externen Mitarbeiters auf ein Projektboard entfernen.' redirect_from: - /articles/removing-an-outside-collaborator-from-an-organization-project-board versions: diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md index ff6efc4c1485..03ad9223e197 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md @@ -24,7 +24,9 @@ Weitere Informationen zu den Berechtigungen für {% data variables.product.prodn {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.github-apps-settings-sidebar %} -1. Klicke unter „{% data variables.product.prodname_github_app %}s“ auf den Avatar der App, für die Du einen {% data variables.product.prodname_github_app %}-Manager entfernen möchtest. ![{% data variables.product.prodname_github_app %} auswählen](/assets/images/help/organizations/select-github-app.png) +1. Under " +{% data variables.product.prodname_github_app %}s", click on the avatar of the app you'd like to remove a {% data variables.product.prodname_github_app %} manager from. +![{% data variables.product.prodname_github_app %} auswählen](/assets/images/help/organizations/select-github-app.png) {% data reusables.organizations.app-managers-settings-sidebar %} 1. Suche unter „App managers“ (App-Manager) den Benutzernamen der Person, deren {% data variables.product.prodname_github_app %}-Managerberechtigungen Du entziehen möchtest, und klicke auf **Revoke** (Entziehen). ![{% data variables.product.prodname_github_app %}-Managerberechtigungen entziehen](/assets/images/help/organizations/github-app-manager-revoke-permissions-individual-app.png) diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/renaming-an-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/renaming-an-organization.md index 21fee85da85b..51387360048e 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/renaming-an-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/renaming-an-organization.md @@ -21,14 +21,14 @@ Nach der Änderung Deines Organisationsnamens wird Dein alter Organisationsname #### Automatische Änderungen -- {% data variables.product.prodname_dotcom %} leitet Referenzen auf Deine Repositorys automatisch weiter. Weblinks auf bestehende **Repositorys** Deiner Organisation funktionieren weiterhin. Allerdings kann diese Anpassung nach der Veranlassung der Änderung einige Minuten dauern. +- {% data variables.product.prodname_dotcom %} leitet Referenzen auf Ihre Repositorys automatisch weiter. Weblinks auf bestehende **Repositorys** Deiner Organisation funktionieren weiterhin. Allerdings kann diese Anpassung nach der Veranlassung der Änderung einige Minuten dauern. - Du kannst Deine lokalen Repositorys weiterhin mittels Push auf die bisherige Remote-Tracking-URL übertragen, ohne diese zu aktualisieren. Jedoch wird nach einer Änderung des Organisationsnamens die Aktualiserung der URLs aller vorhandenen Remote-Repositorys empfohlen. Schließlich kann Dein alter Organisationsname nach dessen Änderung von jemand anderem verwendet werden, und es ist durchaus möglich, dass Repositorys einer neuen Organisation mit gleichem Namen die Weiterleitungseinträge für Deine Repositorys überschreiben. Weitere Informationen findest Du unter „[URL eines Remote-Repositorys ändern](/articles/changing-a-remote-s-url).“ - Bisherige Git-Commits werden den Benutzern Deiner Organisation korrekt zugeordnet. #### Änderungen, die nicht automatisch erfolgen Nach der Änderung Deines Organisationsnamens können folgende Probleme auftreten: -- Links auf die bisherige Profilseite Deiner Organisation, wie `https://{% data variables.command_line.backticks %}/frühererorgname`, geben einen 404-Fehler zurück. Wir empfehlen Dir die Aktualisierung der Links auf Deine Organisation von anderen Websites{% if currentVersion == "free-pro-team@latest" %}, beispielsweise von Deinen LinkedIn- oder Twitter-Profilen{% endif %}. +- Links auf die bisherige Profilseite Ihrer Organisation, wie `https://{% data variables.command_line.backticks %}/previousorgname`, geben einen 404-Fehler zurück. We recommend you update links to your organization from other sites{% if currentVersion == "free-pro-team@latest" %}, such as your LinkedIn or Twitter profiles{% endif %}. - API-Anforderungen mit dem alten Organisationsnamen geben einen 404-Fehler zurück. Wir empfehlen Dir die Aktualisierung Deines alten Organisationsnamens in Deinen API-Anforderungen. - Für Teams, die noch den alten Organisationsnamen verwenden, erfolgen [@erwähnen](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams)-Weiterleitungen nicht automatisch. diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md index 5a09ea5c7bde..9b7176a6803c 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md @@ -16,10 +16,10 @@ Personen mit Administratorberechtigungen können den Zugriff einzelner Benutzer Du kannst Organisationsmitgliedern, externen Mitarbeitern und Teams unterschiedliche Zugriffsberechtigungen auf die Repositorys einer Organisation erteilen. Die einzelnen Berechtigungsebenen gewähren progressiv mehr Zugriffsrechte auf die Inhalte und Einstellungen eines Repositorys. Wähle die Ebene aus, die am besten zur jeweiligen Benutzer- oder Teamrolle innerhalb Deines Projekts passt, und achte darauf, den Benutzern nicht mehr als den notwendigen Zugriff auf ein Projekt zu geben. Vom geringsten zum umfassendsten Zugriff sind die Berechtigungsebenen für die Repositorys einer Organisation wie folgt: -- **Read** (Lesen): Empfohlen für Mitarbeiter, die nicht zum Code beitragen, die aber Dein Projekt anzeigen und mitdiskutieren möchten{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -- **Triage** (Triage): Empfohlen für Mitarbeiter, die Issues und Pull Requests proaktiv verwalten müssen, aber keinen Schreibzugriff benötigen.{% endif %} -- **Write** (Schreiben): Empfohlen für Mitarbeiter, die aktiv zu Deinem Projekt beitragen.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -- **Maintain** (Betreuen): Empfohlen für Projektmanager, die das Repository verwalten, aber keinen Zugriff auf sensible oder irreversible Aktionen benötigen.{% endif %} +- **Lesen**: Empfohlen für Mitarbeiter, die nicht zum Code beitragen, die aber Ihr Projekt anzeigen und mitsprechen möchten. +- **Triage** (Triage): Empfohlen für Mitarbeiter, die Issues und Pull Requests proaktiv verwalten müssen, aber keinen Schreibzugriff benötigen. +- **Schreiben**: Empfohlen für Mitarbeiter, die aktiv zu Ihrem Projekt beitragen. +- **Maintain** (Betreuen): Empfohlen für Projektmanager, die das Repository verwalten, aber keinen Zugriff auf sensible oder irreversible Aktionen benötigen. - **Admin** (Verwalten): Empfohlen für Personen, die vollständigen Zugriff auf das Projekt benötigen und auch sensible oder irreversible Aktionen wie die Verwaltung der Sicherheit oder das Löschen eines Repositorys durchführen müssen {% if currentVersion == "free-pro-team@latest" %} @@ -41,135 +41,75 @@ Neben der Berechtigung zum Verwalten der organisationsweiten Einstellungen haben {% endwarning %} ### Repository-Zugriff der einzelnen Berechtigungsebenen -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -| Repository-Aktion | Read (Gelesen) | bewerten | Schreiben | Betreuen | Verwalten | -|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:--------------:|:--------:|:---------:|:--------:|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------:| -| Pull (Abrufen) aus den zugewiesenen Repositorys der Person oder des Teams | **X** | **X** | **X** | **X** | **X** | -| Erstellen eines Forks des zugewiesenen Repositorys der Person oder des Teams | **X** | **X** | **X** | **X** | **X** | -| Bearbeiten und Löschen eigener Kommentare | **X** | **X** | **X** | **X** | **X** | -| Eröffnen von Issues | **X** | **X** | **X** | **X** | **X** | -| Schließen der selbst eröffneten Issues | **X** | **X** | **X** | **X** | **X** | -| Erneutes Eröffnen von selbst geschlossenen Issues | **X** | **X** | **X** | **X** | **X** | -| Sich-Selbst-Zuweisen von Issues | **X** | **X** | **X** | **X** | **X** | -| Senden von Pull Requests aus Forks der dem Team zugewiesenen Repositorys | **X** | **X** | **X** | **X** | **X** | -| Absenden von Reviews zu Pull Requests | **X** | **X** | **X** | **X** | **X** | -| Anzeigen veröffentlichter Releases | **X** | **X** | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [GitHub Actions-Workflow-Ausführungen](/actions/automating-your-workflow-with-github-actions/managing-a-workflow-run) ansehen | **X** | **X** | **X** | **X** | **X** |{% endif %} -| Bearbeiten von Wikis | **X** | **X** | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [Melden von Missbrauch oder Spam](/articles/reporting-abuse-or-spam) | **X** | **X** | **X** | **X** | **X** |{% endif %} -| Anwenden von Kennzeichnungen | | **X** | **X** | **X** | **X** | -| Schließen, erneutes Eröffnen und Zuweisen aller Issues und Pull Requests | | **X** | **X** | **X** | **X** | -| Anwenden von Meilensteinen | | **X** | **X** | **X** | **X** | -| Markieren von [Issues und Pull Requests als Duplikat](/articles/about-duplicate-issues-and-pull-requests) | | **X** | **X** | **X** | **X** | -| Anfordern von [Pull Request-Reviews](/articles/requesting-a-pull-request-review) | | **X** | **X** | **X** | **X** | -| Push (Schreiben) in die zugewiesenen Repositorys der Person oder des Teams | | | **X** | **X** | **X** | -| Bearbeiten und Löschen der Kommentare beliebiger Benutzer zu Commits, Pull Requests und Issues | | | **X** | **X** | **X** | -| [Ausblenden der Kommentare beliebiger Benutzer](/articles/managing-disruptive-comments) | | | **X** | **X** | **X** | -| [Blockieren von Unterhaltungen](/articles/locking-conversations) | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| Übertragen von Issues (siehe „[Issue auf ein anderes Repository übertragen](/articles/transferring-an-issue-to-another-repository)“) | | | **X** | **X** | **X** |{% endif %} -| [Agieren als designierter Codeinhaber eines Repositorys](/articles/about-code-owners) | | | **X** | **X** | **X** | -| [Markieren eines Pull-Request-Entwurfs als bereit für den Review](/articles/changing-the-stage-of-a-pull-request) | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -| [Einen Pull Request in einen Entwurf umwandeln](/articles/changing-the-stage-of-a-pull-request) | | | **X** | **X** | **X** |{% endif %} -| Absenden von Reviews, die sich auf die Merge-Fähigkeit eines Pull Request auswirken | | | **X** | **X** | **X** | -| [Anwenden vorgeschlagener Änderungen](/articles/incorporating-feedback-in-your-pull-request) auf Pull Requests | | | **X** | **X** | **X** | -| Erstellen von [Statuschecks](/articles/about-status-checks) | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| Erstellen, Bearbeiten, Ausführen, Neuausführen und Abbrechen von [GitHub Actions-Workflows](/actions/automating-your-workflow-with-github-actions/) | | | **X** | **X** | **X** |{% endif %} -| Erstellen und Bearbeiten von Releases | | | **X** | **X** | **X** | -| Anzeigen von Release-Entwürfen | | | **X** | **X** | **X** | -| Bearbeiten von Repository-Beschreibungen | | | | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [Pakete anzeigen und installieren](/packages/publishing-and-managing-packages) | **X** | **X** | **X** | **X** | **X** | -| [Pakete veröffentlichen](/packages/publishing-and-managing-packages/publishing-a-package) | | | **X** | **X** | **X** | -| [Pakete löschen](/packages/publishing-and-managing-packages/deleting-a-package) | | | | | **X** |{% endif %} -| Verwalten von [Themen](/articles/classifying-your-repository-with-topics) | | | | **X** | **X** | -| Aktivieren von Wikis und Einschränken der Wiki-Editoren | | | | **X** | **X** | -| Aktivieren von Projektboards | | | | **X** | **X** | -| Configure [pull request merges](/articles/configuring-pull-request-merges) | | | | **X** | **X** | -| Configure [a publishing source for {% data variables.product.prodname_pages %}](/articles/configuring-a-publishing-source-for-github-pages) | | | | **X** | **X** | -| [An geschützte Branches pushen](/articles/about-protected-branches) | | | | **X** | **X** | -| [Erstellen und Bearbeiten sozialer Tickets für Repositorys](/articles/customizing-your-repositorys-social-media-preview) | | | | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [Interaktionen in einem Repository](/github/building-a-strong-community/limiting-interactions-in-your-repository) limitieren | | | | **X** | **X** |{% endif %} -| Löschen von Issues (siehe „[Issue löschen](/articles/deleting-an-issue)“) | | | | | **X** | -| Mergen von Pull Requests in geschützten Branches auch ohne Genehmigungsreviews | | | | | **X** | -| [Festlegen der Codeinhaber eines Repositorys](/articles/about-code-owners) | | | | | **X** | -| Ein Repository zu einem Team hinzufügen (für Details siehe „[Teamzugriff auf ein Organisations-Repository verwalten](/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository#giving-a-team-access-to-a-repository)") | | | | | **X** | -| [Verwalten des Zugriffs externer Mitarbeiter auf ein Repository](/articles/adding-outside-collaborators-to-repositories-in-your-organization) | | | | | **X** | -| [Ändern der Sichtbarkeit eines Repositorys](/articles/restricting-repository-visibility-changes-in-your-organization) | | | | | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| Erstellen einer Vorlage aus einem Repository (siehe „[Repository-Vorlage erstellen](/articles/creating-a-template-repository)“) | | | | | **X** |{% endif %} -| Ändern der Einstellungen eines Repositorys | | | | | **X** | -| Verwalten des Team- und Mitarbeiterzugriffs auf ein Repository | | | | | **X** | -| Bearbeiten des Standardbranch eines Repositorys | | | | | **X** | -| Manage webhooks and deploy keys | | | | | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [Aktivieren des Abhängigkeitsdiagramms](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) für ein privates Repository | | | | | **X** | -| Receive [{% data variables.product.prodname_dependabot_alerts %} for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in a repository | | | | | **X** | -| [Dismiss {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository) | | | | | **X** | -| [Designate additional people or teams to receive {% data variables.product.prodname_dependabot_alerts %}](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository) for vulnerable dependencies | | | | | **X** | -| [Manage data use settings for your private repository](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository) | | | | | **X** |{% endif %}{% if currentVersion == "free-pro-team@latest" %}| Create [security advisories](/github/managing-security-vulnerabilities/about-github-security-advisories) | | | | | **X** |{% endif %} -| [Verwalten der Forking-Richtlinie für ein Repository](/github/administering-a-repository/managing-the-forking-policy-for-your-repository) | | | | | **X** | -| [Übertragen von Repositorys auf die Organisation](/articles/restricting-repository-creation-in-your-organization) | | | | | **X** | -| [Löschen von Repositorys oder Übertragen von Repositorys aus der Organisation](/articles/setting-permissions-for-deleting-or-transferring-repositories) | | | | | **X** | -| [Archivieren von Repositorys](/articles/about-archiving-repositories) | | | | | **X** |{% if currentVersion == "free-pro-team@latest" %} -| Anzeigen einer Sponsorenschaltfläche (siehe „[Sponsorenschaltfläche in Deinem Repository anzeigen](/articles/displaying-a-sponsor-button-in-your-repository)“) | | | | | **X** |{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -| Create autolink references to external resources, like JIRA or Zendesk (see "[Configuring autolinks to reference external resources](/articles/configuring-autolinks-to-reference-external-resources)") | | | | | **X** |{% endif %} - -{% else %} - -| Repository-Aktion | Lese-berechtigungen | Schreib-berechtigungen | Administratorberechtigungen | -|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-------------------:|:----------------------:|:----------------------------------------------------------------------:| -| Pull (Lesen) aus den zugewiesenen Repositorys der Person oder des Teams | **X** | **X** | **X** | -| Erstellen eines Fork (Kopie) des zugewiesenen Repositorys der Person oder des Teams | **X** | **X** | **X** | -| Bearbeiten und Löschen eigener Kommentare zu Commits, Pull Requests und Issues | **X** | **X** | **X** | -| Eröffnen von Issues | **X** | **X** | **X** | -| Schließen der selbst eröffneten Issues | **X** | **X** | **X** | -| Erneutes Eröffnen von selbst geschlossenen Issues | **X** | **X** | **X** | -| Sich-Selbst-Zuweisen von Issues | **X** | **X** | **X** | -| Senden von Pull Requests aus Forks der dem Team zugewiesenen Repositorys | **X** | **X** | **X** | -| Absenden von Reviews zu Pull Requests | **X** | **X** | **X** | -| Anzeigen veröffentlichter Releases | **X** | **X** | **X** | -| Bearbeiten von Wikis | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [Melden von Missbrauch oder Spam](/articles/reporting-abuse-or-spam) | **X** | **X** | **X** |{% endif %} -| Push (Schreiben) in die zugewiesenen Repositorys der Person oder des Teams | | **X** | **X** | -| Bearbeiten und Löschen der Kommentare beliebiger Benutzer zu Commits, Pull Requests und Issues | | **X** | **X** | -| [Ausblenden der Kommentare beliebiger Benutzer](/articles/managing-disruptive-comments) | | **X** | **X** | -| [Blockieren von Unterhaltungen](/articles/locking-conversations) | | **X** | **X** | -| Anwenden von Kennzeichnungen und Meilensteinen | | **X** | **X** | -| Schließen, erneutes Eröffnen und Zuweisen aller Issues | | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| Markieren von [Issues und Pull Requests als Duplikat](/articles/about-duplicate-issues-and-pull-requests) | | **X** | **X** |{% endif %} -| [Agieren als designierter Codeinhaber eines Repositorys](/articles/about-code-owners) | | **X** | **X** | -| [Markieren eines Pull-Request-Entwurfs als bereit für den Review](/articles/changing-the-stage-of-a-pull-request) | | **X** | **X** | -| Anfordern von [Pull Request-Reviews](/articles/requesting-a-pull-request-review) | | **X** | **X** | -| Absenden von Reviews, die sich auf die Merge-Fähigkeit eines Pull Request auswirken | | **X** | **X** | -| Anwenden vorgeschlagener Änderungen an Pull Requests (siehe „[Feedback in Deinen Pull Request aufnehmen](/articles/incorporating-feedback-in-your-pull-request)“) | | **X** | **X** | -| Erstellen von [Statuschecks](/articles/about-status-checks) | | **X** | **X** | -| Erstellen und Bearbeiten von Releases | | **X** | **X** | -| Anzeigen von Release-Entwürfen | | **X** | **X** | -| Löschen von Issues (siehe „[Issue löschen](/articles/deleting-an-issue)“) | | | **X** | -| Mergen von Pull Requests in geschützten Branches auch ohne Genehmigungsreviews | | | **X** | -| [Festlegen der Codeinhaber eines Repositorys](/articles/about-code-owners) | | | **X** | -| Bearbeiten von Repository-Beschreibungen | | | **X** | -| Verwalten von [Themen](/articles/classifying-your-repository-with-topics) | | | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| Erstellen und Bearbeiten sozialer Tickets für Repositorys (siehe „[Social-Media-Vorschau Deines Repositorys anpassen](/articles/customizing-your-repositorys-social-media-preview)“) | | | **X** |{% endif %} -| Ein Repository zu einem Team hinzufügen (für Details siehe „[Teamzugriff auf ein Organisations-Repository verwalten](/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository#giving-a-team-access-to-a-repository)") | | | **X** | -| Verwalten des Zugriffs externer Mitarbeiter auf ein Repository (siehe „[Externe Mitarbeiter zu Organisationsrepositorys hinzufügen](/articles/adding-outside-collaborators-to-repositories-in-your-organization)“) | | | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [Interaktionen in einem Repository](/github/building-a-strong-community/limiting-interactions-in-your-repository) limitieren | | | **X** |{% endif %} -| Ändern der Sichtbarkeit eines Repositorys (siehe „[Änderungen an der Sichtbarkeit eines Repositorys in Deiner Organisation einschränken](/articles/restricting-repository-visibility-changes-in-your-organization)“) | | | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| Erstellen einer Vorlage aus einem Repository (siehe „[Repository-Vorlage erstellen](/articles/creating-a-template-repository)“) | | | | | **X** |{% endif %} -| Ändern der Einstellungen eines Repositorys | | | **X** | -| Verwalten des Team- und Mitarbeiterzugriffs auf ein Repository | | | **X** | -| Bearbeiten des Standardbranch eines Repositorys | | | **X** | -| Manage webhooks and deploy keys | | | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [Aktivieren des Abhängigkeitsdiagramms](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) für ein privates Repository | | | **X** | -| Receive [{% data variables.product.prodname_dependabot_alerts %} for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in a repository | | | **X** | -| [Dismiss {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository) | | | **X** | -| [Designate additional people or teams to receive {% data variables.product.prodname_dependabot_alerts %}](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-github-dependabot-alerts) for vulnerable dependencies | | | **X** | -| [Manage data use settings for your private repository](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository) | | | **X** |{% endif %}{% if currentVersion == "free-pro-team@latest" %} -| [Sicherheitshinweise](/github/managing-security-vulnerabilities/about-github-security-advisories) erstellen") | | | **X** |{% endif %} -| [Verwalten der Forking-Richtlinie für ein Repository](/github/administering-a-repository/managing-the-forking-policy-for-your-repository) | | | **X** | -| Übertragen von Repositorys auf das Organisationskonto (siehe „[Repository-Erstellung in Deiner Organisation einschränken](/articles/restricting-repository-creation-in-your-organization)“) | | | **X** | -| Löschen oder Übertragen von Repositorys (siehe „[Berechtigungen zum Löschen oder Übertragen von Repositorys in Deiner Organisation einstellen](/articles/setting-permissions-for-deleting-or-transferring-repositories)“) | | | **X** | -| [Archivieren von Repositorys](/articles/about-archiving-repositories) | | | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -| Erstellen von automatisch verknüpften Verweisen zu externen Ressourcen wie JIRA oder Zendesk (siehe „[Automatische Verknüpfung zu Verweisen zu externen Ressourcen](/articles/configuring-autolinks-to-reference-external-resources)“) | | | | | **X** |{% endif %} -{% endif %} +| Repository-Aktion | Read (Gelesen) | bewerten | Schreiben | Betreuen | Verwalten | +|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:--------------:|:--------:|:---------:|:--------:|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:| +| Pull (Abrufen) aus den zugewiesenen Repositorys der Person oder des Teams | **X** | **X** | **X** | **X** | **X** | +| Erstellen eines Forks des zugewiesenen Repositorys der Person oder des Teams | **X** | **X** | **X** | **X** | **X** | +| Bearbeiten und Löschen eigener Kommentare | **X** | **X** | **X** | **X** | **X** | +| Eröffnen von Issues | **X** | **X** | **X** | **X** | **X** | +| Schließen der selbst eröffneten Issues | **X** | **X** | **X** | **X** | **X** | +| Erneutes Eröffnen von selbst geschlossenen Issues | **X** | **X** | **X** | **X** | **X** | +| Sich-Selbst-Zuweisen von Issues | **X** | **X** | **X** | **X** | **X** | +| Senden von Pull Requests aus Forks der dem Team zugewiesenen Repositorys | **X** | **X** | **X** | **X** | **X** | +| Absenden von Reviews zu Pull Requests | **X** | **X** | **X** | **X** | **X** | +| Anzeigen veröffentlichter Releases | **X** | **X** | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} +| [GitHub Actions-Workflow-Ausführungen](/actions/automating-your-workflow-with-github-actions/managing-a-workflow-run) ansehen | **X** | **X** | **X** | **X** | **X** |{% endif %} +| Bearbeiten von Wikis | **X** | **X** | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} +| [Melden von Missbrauch oder Spam](/articles/reporting-abuse-or-spam) | **X** | **X** | **X** | **X** | **X** |{% endif %} +| Anwenden von Kennzeichnungen | | **X** | **X** | **X** | **X** | +| Schließen, erneutes Eröffnen und Zuweisen aller Issues und Pull Requests | | **X** | **X** | **X** | **X** | +| Anwenden von Meilensteinen | | **X** | **X** | **X** | **X** | +| Markieren von [Issues und Pull Requests als Duplikat](/articles/about-duplicate-issues-and-pull-requests) | | **X** | **X** | **X** | **X** | +| Anfordern von [Pull Request-Reviews](/articles/requesting-a-pull-request-review) | | **X** | **X** | **X** | **X** | +| Push (Schreiben) in die zugewiesenen Repositorys der Person oder des Teams | | | **X** | **X** | **X** | +| Bearbeiten und Löschen der Kommentare beliebiger Benutzer zu Commits, Pull Requests und Issues | | | **X** | **X** | **X** | +| [Ausblenden der Kommentare beliebiger Benutzer](/articles/managing-disruptive-comments) | | | **X** | **X** | **X** | +| [Blockieren von Unterhaltungen](/articles/locking-conversations) | | | **X** | **X** | **X** | +| Übertragen von Issues (siehe „[Issue auf ein anderes Repository übertragen](/articles/transferring-an-issue-to-another-repository)“) | | | **X** | **X** | **X** | +| [Agieren als designierter Codeinhaber eines Repositorys](/articles/about-code-owners) | | | **X** | **X** | **X** | +| [Markieren eines Pull-Request-Entwurfs als bereit für den Review](/articles/changing-the-stage-of-a-pull-request) | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +| [Einen Pull Request in einen Entwurf umwandeln](/articles/changing-the-stage-of-a-pull-request) | | | **X** | **X** | **X** |{% endif %} +| Absenden von Reviews, die sich auf die Merge-Fähigkeit eines Pull Request auswirken | | | **X** | **X** | **X** | +| [Anwenden vorgeschlagener Änderungen](/articles/incorporating-feedback-in-your-pull-request) auf Pull Requests | | | **X** | **X** | **X** | +| Erstellen von [Statuschecks](/articles/about-status-checks) | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} +| Erstellen, Bearbeiten, Ausführen, Neuausführen und Abbrechen von [GitHub-Actions-Workflows](/actions/automating-your-workflow-with-github-actions/) | | | **X** | **X** | **X** |{% endif %} +| Erstellen und Bearbeiten von Releases | | | **X** | **X** | **X** | +| Anzeigen von Release-Entwürfen | | | **X** | **X** | **X** | +| Bearbeiten von Repository-Beschreibungen | | | | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} +| [Pakete anzeigen und installieren](/packages/publishing-and-managing-packages) | **X** | **X** | **X** | **X** | **X** | +| [Pakete veröffentlichen](/packages/publishing-and-managing-packages/publishing-a-package) | | | **X** | **X** | **X** | +| [Pakete löschen](/packages/publishing-and-managing-packages/deleting-a-package) | | | | | **X** |{% endif %} +| Verwalten von [Themen](/articles/classifying-your-repository-with-topics) | | | | **X** | **X** | +| Aktivieren von Wikis und Einschränken der Wiki-Editoren | | | | **X** | **X** | +| Aktivieren von Projektboards | | | | **X** | **X** | +| Configure [pull request merges](/articles/configuring-pull-request-merges) | | | | **X** | **X** | +| Configure [a publishing source for {% data variables.product.prodname_pages %}](/articles/configuring-a-publishing-source-for-github-pages) | | | | **X** | **X** | +| [An geschützte Branches pushen](/articles/about-protected-branches) | | | | **X** | **X** | +| [Erstellen und Bearbeiten sozialer Tickets für Repositorys](/articles/customizing-your-repositorys-social-media-preview) | | | | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} +| [Interaktionen in einem Repository](/github/building-a-strong-community/limiting-interactions-in-your-repository) limitieren | | | | **X** | **X** |{% endif %} +| Löschen von Issues (siehe „[Issue löschen](/articles/deleting-an-issue)“) | | | | | **X** | +| Mergen von Pull Requests in geschützten Branches auch ohne Genehmigungsreviews | | | | | **X** | +| [Festlegen der Codeinhaber eines Repositorys](/articles/about-code-owners) | | | | | **X** | +| Ein Repository zu einem Team hinzufügen (siehe „[Teamzugriff auf ein Organisations-Repository verwalten](/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository#giving-a-team-access-to-a-repository)") | | | | | **X** | +| [Verwalten des Zugriffs externer Mitarbeiter auf ein Repository](/articles/adding-outside-collaborators-to-repositories-in-your-organization) | | | | | **X** | +| [Ändern der Sichtbarkeit eines Repositorys](/articles/restricting-repository-visibility-changes-in-your-organization) | | | | | **X** | +| Erstellen einer Vorlage aus einem Repository (siehe „[Repository-Vorlage erstellen](/articles/creating-a-template-repository)“) | | | | | **X** | +| Ändern der Einstellungen eines Repositorys | | | | | **X** | +| Verwalten des Team- und Mitarbeiterzugriffs auf ein Repository | | | | | **X** | +| Bearbeiten des Standardbranch eines Repositorys | | | | | **X** | +| Manage webhooks and deploy keys | | | | | **X** |{% if currentVersion == "free-pro-team@latest" %} +| [Aktivieren des Abhängigkeitsdiagramms](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) für ein privates Repository | | | | | **X** | +| Receive [{% data variables.product.prodname_dependabot_alerts %} for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in a repository | | | | | **X** | +| [Dismiss {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository) | | | | | **X** | +| [Designate additional people or teams to receive {% data variables.product.prodname_dependabot_alerts %}](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository) for vulnerable dependencies | | | | | **X** | +| [Manage data use settings for your private repository](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository) | | | | | **X** |{% endif %}{% if currentVersion == "free-pro-team@latest" %}| Create [security advisories](/github/managing-security-vulnerabilities/about-github-security-advisories) | | | | | **X** |{% endif %} +| [Verwalten der Forking-Richtlinie für ein Repository](/github/administering-a-repository/managing-the-forking-policy-for-your-repository) | | | | | **X** | +| [Übertragen von Repositorys auf die Organisation](/articles/restricting-repository-creation-in-your-organization) | | | | | **X** | +| [Löschen von Repositorys oder Übertragen von Repositorys aus der Organisation](/articles/setting-permissions-for-deleting-or-transferring-repositories) | | | | | **X** | +| [Archivieren von Repositorys](/articles/about-archiving-repositories) | | | | | **X** |{% if currentVersion == "free-pro-team@latest" %} +| Anzeigen einer Sponsorenschaltfläche (siehe „[Sponsorenschaltfläche in Ihrem Repository anzeigen](/articles/displaying-a-sponsor-button-in-your-repository)“) | | | | | **X** |{% endif %} +| Create autolink references to external resources, like JIRA or Zendesk (see "[Configuring autolinks to reference external resources](/articles/configuring-autolinks-to-reference-external-resources)") | | | | | **X** | ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md index d6f8d9152a01..f04190761129 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md @@ -1,6 +1,6 @@ --- title: Zwei-Faktor-Authentifizierung in Deiner Organisation erzwingen -intro: 'Organisationsinhaber können von {% if currentVersion == "free-pro-team@latest" %}Organisationsmitgliedern, externen Mitarbeitern und Abrechnungsmanagern{% else %}Organisationsmitgliedern und externen Mitarbeitern{% endif %} die Aktivierung der Zwei-Faktor-Authentifizierung (2FA) für ihre persönlichen Konten erzwingen, um böswillige Angriffe auf die Repositorys und Einstellungen ihrer Organisation zu erschweren.' +intro: 'Organization owners can require {% if currentVersion == "free-pro-team@latest" %}organization members, outside collaborators, and billing managers{% else %}organization members and outside collaborators{% endif %} to enable two-factor authentication for their personal accounts, making it harder for malicious actors to access an organization''s repositories and settings.' redirect_from: - /articles/requiring-two-factor-authentication-in-your-organization versions: @@ -8,23 +8,35 @@ versions: enterprise-server: '*' --- -{% data reusables.two_fa.auth_methods_2fa %} +### About two-factor authentication for organizations + +{% data reusables.two_fa.about-2fa %} You can require all {% if currentVersion == "free-pro-team@latest" %}members, outside collaborators, and billing managers{% else %}members and outside collaborators{% endif %} in your organization to enable two-factor authentication on {% data variables.product.product_name %}. For more information about two-factor authentication, see "[Securing your account with two-factor authentication (2FA)](/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa)." -### Anforderungen für die Erzwingung der Zwei-Faktor-Authentifizierung +{% if currentVersion == "free-pro-team@latest" %} -Bevor Du von {% if currentVersion == "free-pro-team@latest" %}Organisationsmitgliedern, externen Mitarbeitern und Abrechnungsmanagern{% else %}Organisationsmitgliedern und externen Mitarbeitern{% endif %} die Verwendung der 2FA erzwingst, musst Du selbst die [Zwei-Faktor-Authentifizierung für Dein eigenes persönliches Konto aktivieren](/articles/securing-your-account-with-two-factor-authentication-2fa/). +You can also require two-factor authentication for organizations in an enterprise. Weiter Informationen findest Du unter „[Sicherheitseinstellungen für Dein Enterprise-Konto erzwingen](/github/setting-up-and-managing-your-enterprise-account/enforcing-security-settings-in-your-enterprise-account#requiring-two-factor-authentication-for-organizations-in-your-enterprise-account)." + +{% endif %} {% warning %} **Warnungen:** -- Wenn Du innerhalb Deiner Organisation die Zwei-Faktor-Authentifizierung verlangst, werden {% if currentVersion == "free-pro-team@latest" %}Organisationsmitglieder, externe Mitarbeiter und Abrechnungsmanager{% else %}Organisationsmitglieder und externe Mitarbeiter{% endif %} (einschließlich Bot-Konten), die keine 2FA verwenden, aus der Organisation entfernt und verlieren so den Zugriff auf dessen Repositorys. Gleichzeitig verlieren sie auch den Zugriff auf ihre Forks der privaten Repositorys der Organisation. Du kannst [die Zugriffsberechtigungen und Einstellungen dieser Personen wiederherstellen](/articles/reinstating-a-former-member-of-your-organization), wenn sie die Zwei-Faktor-Authentifizierung für ihre persönlichen Konten innerhalb einer Frist von drei Monaten ab ihrer Entfernung aus der Organisation aktivieren. -- Wenn ein Organisationsinhaber, ein Mitglied{% if currentVersion == "free-pro-team@latest" %}, ein Abrechnungsmanager{% endif %} oder ein externer Mitarbeiter die 2FA für sein persönliches Konto deaktiviert, nachdem Du die Erzwingung der Zwei-Faktor-Authentifizierung aktiviert hast, wird diese Person automatisch aus der Organisation entfernt. +- When you require use of two-factor authentication for your organization, {% if currentVersion == "free-pro-team@latest" %}members, outside collaborators, and billing managers{% else %}members and outside collaborators{% endif %} (including bot accounts) who do not use 2FA will be removed from the organization and lose access to its repositories. Gleichzeitig verlieren sie auch den Zugriff auf ihre Forks der privaten Repositorys der Organisation. Du kannst [die Zugriffsberechtigungen und Einstellungen dieser Personen wiederherstellen](/articles/reinstating-a-former-member-of-your-organization), wenn sie die Zwei-Faktor-Authentifizierung für ihre persönlichen Konten innerhalb einer Frist von drei Monaten ab ihrer Entfernung aus der Organisation aktivieren. +- If an organization owner, member,{% if currentVersion == "free-pro-team@latest" %} billing manager,{% endif %} or outside collaborator disables 2FA for their personal account after you've enabled required two-factor authentication, they will automatically be removed from the organization. - Falls Du der einzige Inhaber einer Organisation bist, bei der die Zwei-Faktor-Authentifizierung verlangt wird, kannst Du die 2FA für Dein persönliches Konto nicht deaktivieren, ohne gleichzeitig die Erzwingung der Zwei-Faktor-Authentifizierung für die Organisation aufzuheben. {% endwarning %} -Vor der Erzwingung der Zwei-Faktor-Authentifizierung empfehlen wir Dir, Deine {% if currentVersion == "free-pro-team@latest" %}Organisationsmitglieder, externen Mitarbeiter und Abrechnungsmanager{% else %}Organisationsmitglieder und externen Mitarbeiter{% endif %} zu benachrichtigen und sie zu bitten, die 2FA für ihre Konten einzurichten. Auf der Personenseite Deiner Organisation kannst Du [überprüfen, ob die Mitglieder und externen Mitarbeiter Deiner Organisation die 2FA bereits verwenden](/articles/viewing-whether-users-in-your-organization-have-2fa-enabled). +{% data reusables.two_fa.auth_methods_2fa %} + +### Vorrausetzungen + +Before you can require {% if currentVersion == "free-pro-team@latest" %}organization members, outside collaborators, and billing managers{% else %}organization members and outside collaborators{% endif %} to use two-factor authentication, you must enable two-factor authentication for your account on {% data variables.product.product_name %}. Weitere Informationen findest Du unter „[Dein Konto durch Zwei-Faktor-Authentifizierung (2FA) schützen](/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa).“ + +Before you require use of two-factor authentication, we recommend notifying {% if currentVersion == "free-pro-team@latest" %}organization members, outside collaborators, and billing managers{% else %}organization members and outside collaborators{% endif %} and asking them to set up 2FA for their accounts. You can see if members and outside collaborators already use 2FA. Weitere Informationen findest Du unter „[Überprüfen, ob die Benutzer Deiner Organisation die 2FA aktiviert haben](/github/setting-up-and-managing-organizations-and-teams/viewing-whether-users-in-your-organization-have-2fa-enabled).“ + +### Zwei-Faktor-Authentifizierung in Deiner Organisation erzwingen {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} @@ -38,7 +50,7 @@ Vor der Erzwingung der Zwei-Faktor-Authentifizierung empfehlen wir Dir, Deine {% ### Aus Deiner Organisation entfernte Personen anzeigen -Wenn Du wissen möchtest, welche Personen automatisch aus Deiner Organisation entfernt wurden, weil sie Deiner Anforderung zur Aktivierung der Zwei-Faktor-Authentifizierung nicht Folge leisteten, kannst Du [das Auditprotokoll Deiner Organisation nach Personen durchsuchen](/articles/reviewing-the-audit-log-for-your-organization/#accessing-the-audit-log), die aus der Organisation entfernt wurden. Die im Auditprotokoll aufgezeichneten Ereignisse geben an, ob eine Person aufgrund der Nichterfüllung der 2FA-Anforderung aus der Organisation entfernt wurde. +Wenn Sie wissen möchten, welche Personen automatisch aus Ihrer Organisation entfernt wurden, weil sie Ihrer Anforderung der Aktivierung der Zwei-Faktor-Authentifizierung nicht Folge leisteten, können Sie [das Auditprotokoll Ihrer Organisation nach Personen durchsuchen](/articles/reviewing-the-audit-log-for-your-organization/#accessing-the-audit-log), die aus der Organisation entfernt wurden. Die im Auditprotokoll aufgezeichneten Ereignisse geben an, ob eine Person aufgrund der Nichterfüllung der 2FA-Anforderung aus der Organisation entfernt wurde. ![Ereignis im Auditprotokoll zur Entfernung eines Benutzers aufgrund der Nichterfüllung der 2FA-Anforderung](/assets/images/help/2fa/2fa_noncompliance_audit_log_search.png) @@ -47,7 +59,7 @@ Wenn Du wissen möchtest, welche Personen automatisch aus Deiner Organisation en {% data reusables.audit_log.audit_log_sidebar_for_org_admins %} 4. Gib Deine Suchabfrage ein. Verwende für Deine Suche die folgenden Abfragen: - für die Suche nach entfernten Organisationsmitgliedern die Suchabfrage `action:org.remove_member` - - für die Suche nach entfernten externen Mitarbeitern die Suchabfrage `action:org.remove_outside_collaborator`{% if currentVersion == "free-pro-team@latest" %} + - Outside collaborators removed, use `action:org.remove_outside_collaborator` in your search query{% if currentVersion == "free-pro-team@latest" %} - für die Suche nach entfernten Abrechnungsmanagern die Suchabfrage `action:org.remove_billing_manager`{% endif %} Die Suche nach Personen, die aus Deiner Organisation entfernt wurden, kannst Du auch durch Angabe eines [Zeitfensters](/articles/reviewing-the-audit-log-for-your-organization/#search-based-on-time-of-action) in der Suchabfrage eingrenzen. diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/restricting-access-to-your-organizations-data.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/restricting-access-to-your-organizations-data.md index 7ce31879095c..cbc18637e259 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/restricting-access-to-your-organizations-data.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/restricting-access-to-your-organizations-data.md @@ -1,6 +1,6 @@ --- title: Zugriff auf die Daten Deiner Organisation einschränken -intro: 'Mit den Zugriffsbeschränkungen von {% data variables.product.prodname_oauth_app %} können Organisationsinhaber den Zugriff nicht vertrauenswürdiger Apps auf die Daten der Organisation einschränken. Die Mitglieder der Organisation können dann {% data variables.product.prodname_oauth_app %}s unter ihren persönlichen Benutzerkonten verwenden, ohne die Organisationsdaten einem Risiko auszusetzen.' +intro: 'Mit den Zugriffseinschränkungen von {% data variables.product.prodname_oauth_app %} können Organisationsinhaber den Zugriff nicht vertrauenswürdiger Apps auf die Daten der Organisation einschränken. Die Mitglieder der Organisation können dann {% data variables.product.prodname_oauth_app %}s unter ihren persönlichen Benutzerkonten verwenden, ohne die Organisationsdaten einem Risiko auszusetzen.' redirect_from: - /articles/restricting-access-to-your-organization-s-data - /articles/restricting-access-to-your-organizations-data diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md index 29054bc09218..88a92e7973d9 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md @@ -1,6 +1,6 @@ --- title: Repository-Erstellung in Deiner Organisation einschränken -intro: Zum Schutz Deiner Organisationsdaten kannst Du die Berechtigungen für die Erstellung von Repositorys innerhalb Deiner Organisation konfigurieren. +intro: 'Zum Schutz Deiner Organisationsdaten kannst Du die Berechtigungen für die Erstellung von Repositorys innerhalb Deiner Organisation konfigurieren.' redirect_from: - /articles/restricting-repository-creation-in-your-organization versions: @@ -8,11 +8,11 @@ versions: enterprise-server: '*' --- -Du kannst wählen, ob Mitglieder in Deiner Organisation Repositorys erstellen können. Wenn Du Mitgliedern erlaubst, Repositories zu erstellen, kannst Du auswählen, welche Arten von Repositories Mitglieder erstellen können.{% if currentVersion == "free-pro-team@latest" %} Damit Mitglieder nur private Repositories erstellen können, muss Deine Organisation {% data variables.product.prodname_ghe_cloud %}verwenden.{% endif %} Weitere Informationen findest Du unter „[Über Repository-Sichtbarkeit](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)." +Du kannst wählen, ob Mitglieder in Deiner Organisation Repositorys erstellen können. If you allow members to create repositories, you can choose which types of repositories members can create.{% if currentVersion == "free-pro-team@latest" %} To allow members to create private repositories only, your organization must use {% data variables.product.prodname_ghe_cloud %}.{% endif %} For more information, see "[About repository visibility](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)." Organisationsinhaber können immer jede Art von Repository erstellen. -{% if currentVersion == "free-pro-team@latest" %}Enterprise-Inhaber{% else %}Website-Administratoren{% endif %} können die Optionen einschränken, die Du für die Richtlinie zur Erstellung von Repositorys in Deiner Organisation zur Verfügung hast. Weitere Informationen findest Du unter {% if currentVersion == "free-pro-team@latest" %}„[Repository-Verwaltungsrichtlinie in Deinem Enterprise-Konto erzwingen](/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account)."{% else %}„[Repository-Erstellung auf Deiner Instanz einschränken](/enterprise/admin/user-management/restricting-repository-creation-in-your-instance)."{% endif %} +{% if currentVersion == "free-pro-team@latest" %}Enterprise owners{% else %}Site administrators{% endif %} can restrict the options you have available for your organization's repository creation policy. For more information, see {% if currentVersion == "free-pro-team@latest" %}"[Enforcing repository management policies in your enterprise account](/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account)."{% else %}"[Restricting repository creation in your instance](/enterprise/admin/user-management/restricting-repository-creation-in-your-instance)."{% endif %} {% warning %} @@ -26,5 +26,5 @@ Organisationsinhaber können immer jede Art von Repository erstellen. {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.member-privileges %} -5. Wähle unter „Repository Creation" (Repository Erstellung) {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}eine oder mehrere Optionen{% else %}eine Einstellung{% endif %} aus. ![Optionen für die Repository-Erstellung](/assets/images/help/organizations/repo-creation-perms-radio-buttons.png) +5. Under "Repository creation", select one or more options. ![Optionen für die Repository-Erstellung](/assets/images/help/organizations/repo-creation-perms-radio-buttons.png) 6. Klicke auf **Save** (Speichern). diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-visibility-changes-in-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-visibility-changes-in-your-organization.md index 72fecfc2a6bb..643ec661930d 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-visibility-changes-in-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-visibility-changes-in-your-organization.md @@ -1,6 +1,6 @@ --- title: Sichtbarkeitsänderungen von Repositorys in Deiner Organisation einschränken -intro: Zum Schutz Deiner Organisationsdaten kannst Du die Berechtigungen für die Änderung der Sichtbarkeit von Repositorys in Deiner Organisation konfigurieren. +intro: 'Zum Schutz Deiner Organisationsdaten kannst Du die Berechtigungen für die Änderung der Sichtbarkeit von Repositorys in Deiner Organisation konfigurieren.' redirect_from: - /articles/restricting-repository-visibility-changes-in-your-organization versions: diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md index f256f2c28fdb..b0029b8eeabf 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md @@ -202,7 +202,8 @@ For more information, see "[Restricting publication of {% data variables.product | `remove_outside_collaborator` | Triggered when an owner removes an outside collaborator from an organization or when [two-factor authentication is required in an organization](/articles/requiring-two-factor-authentication-in-your-organization) and an outside collaborator does not use 2FA or disables 2FA. |{% if currentVersion == "free-pro-team@latest" %} | `revoke_external_identity` | Triggered when an organization owner revokes a member's linked identity. For more information, see "[Viewing and managing a member's SAML access to your organization](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization#viewing-and-revoking-a-linked-identity)." | `revoke_sso_session` | Triggered when an organization owner revokes a member's SAML session. For more information, see "[Viewing and managing a member's SAML access to your organization](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization#viewing-and-revoking-a-linked-identity)." -| `unblock_user` | Triggered when an organization owner [unblocks a user from an organization](/articles/unblocking-a-user-from-your-organization).{% endif %} +| `unblock_user` | Triggered when an organization owner [unblocks a user from an organization](/articles/unblocking-a-user-from-your-organization).{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +| `update_new_repository_default_branch_setting` | Triggered when an owner changes the name of the default branch for new repositories in the organization. For more information, see "[Managing the default branch name for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization)."{% endif %} | `update_default_repository_permission` | Triggered when an owner changes the default repository permission level for organization members. | `update_member` | Triggered when an owner changes a person's role from owner to member or member to owner. | `update_member_repository_creation_permission` | Triggered when an owner changes the create repository permission for organization members.{% if currentVersion == "free-pro-team@latest" %} @@ -400,7 +401,6 @@ Using the qualifier `country`, you can filter actions in the audit log based on {% data reusables.audit_log.exported-log-keys-and-values %} {% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} ### Using the Audit log API {% note %} @@ -418,9 +418,7 @@ To ensure a secure IP and maintain compliance for your organization, you can use The GraphQL response can include data for up to 90 to 120 days. -For example, you can make a GraphQL request to see all the new organization members added to your organization. For more information, see the "[GraphQL API Audit Log](/v4/interface/auditentry/)." - -{% endif %} +For example, you can make a GraphQL request to see all the new organization members added to your organization. For more information, see the "[GraphQL API Audit Log](/graphql/reference/interfaces#auditentry/)." ### Further reading diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/reviewing-your-organizations-installed-integrations.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/reviewing-your-organizations-installed-integrations.md index 515c4749f09a..83bcbe3dd4f6 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/reviewing-your-organizations-installed-integrations.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/reviewing-your-organizations-installed-integrations.md @@ -1,6 +1,6 @@ --- -title: Installierte Integrationen Deiner Organisation überprüfen -intro: Du kannst die Berechtigungsebenen für die installierten Integrationen Deiner Organisation überprüfen und den Zugriff jeder Integration auf die Repositorys Deiner Organisation konfigurieren. +title: Reviewing your organization's installed integrations +intro: You can review the permission levels for your organization's installed integrations and configure each integration's access to organization repositories. redirect_from: - /articles/reviewing-your-organization-s-installed-integrations - /articles/reviewing-your-organizations-installed-integrations @@ -12,9 +12,12 @@ versions: {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} -4. Klicke in der linken Seitenleiste auf **Installed {% data variables.product.prodname_github_app %}s** (Installierte Apps). ![Registerkarte „Installed {% data variables.product.prodname_github_app %}s“ (Installierte Apps) in der Seitenleiste mit den Organisationseinstellungen](/assets/images/help/organizations/org-settings-installed-github-apps.png) -5. Klicke neben der {% data variables.product.prodname_github_app %}, die Du überprüfen möchtest, auf **Configure** (Konfigurieren). ![Schaltfläche „Configure“ (Konfigurieren)](/assets/images/help/organizations/configure-installed-integration-button.png) -6. Überprüfe die Berechtigungen und den Repository-Zugriff der {% data variables.product.prodname_github_app %}s. ![Option zur Festlegung des Zugriffs der {% data variables.product.prodname_github_app %} auf alle oder ausgewählte Repositorys](/assets/images/help/organizations/toggle-integration-repo-access.png) - - Soll die {% data variables.product.prodname_github_app %} Zugriff auf alle Repositorys Deiner Organisation haben, klicke auf **All repositories** (Alle Repositorys). - - Soll die Anwendung nur auf bestimmte Repositorys Zugriff haben, wähle **Only select repositories** (Nur ausgewählte Repositorys) aus, und gib einen Repositorynamen ein. -7. Klicke auf **Save** (Speichern). +4. In the left sidebar, click **Installed {% data variables.product.prodname_github_app %}s**. + ![Installed {% data variables.product.prodname_github_app %}s tab in the organization settings sidebar](/assets/images/help/organizations/org-settings-installed-github-apps.png) +5. Next to the {% data variables.product.prodname_github_app %} you'd like to review, click **Configure**. + ![Configure button](/assets/images/help/organizations/configure-installed-integration-button.png) +6. Review the {% data variables.product.prodname_github_app %}'s permissions and repository access. + ![Option to give the {% data variables.product.prodname_github_app %} access to all repositories or specific repositories](/assets/images/help/organizations/toggle-integration-repo-access.png) + - To give the {% data variables.product.prodname_github_app %} access to all of your organization's repositories, select **All repositories**. + - To choose specific repositories to give the application access to, select **Only select repositories**, then type a repository name. +7. Click **Save**. diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/setting-base-permissions-for-an-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/setting-base-permissions-for-an-organization.md index 56c6fd3fa456..e3c495d5581e 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/setting-base-permissions-for-an-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/setting-base-permissions-for-an-organization.md @@ -1,6 +1,6 @@ --- title: Basisberechtigungen für eine Organisation festlegen -intro: 'Du kannst Basisberechtigungen für die Repositorys festlegen, die einer Organisation gehören.' +intro: Du kannst Basisberechtigungen für die Repositorys festlegen, die einer Organisation gehören. permissions: Organisationsinhaber können Basisberechtigungen für eine Organisation festlegen. versions: free-pro-team: '*' @@ -11,7 +11,7 @@ versions: Du kannst Basisberechtigungen festlegen, die für alle Mitglieder einer Organisation gelten, wenn sie auf eines der Repositorys der Organisation zugreifen. Basisberechtigungen gelten nicht für externen Mitarbeiter. -{% if currentVersion == "free-pro-team@latest" %}Standardmäßig haben Mitglieder einer Organisation **Lese**-Berechtigung für die Repositorys der Organisation.{% endif %} +{% if currentVersion == "free-pro-team@latest" %}By default, members of an organization will have **Read** permissions to the organization's repositories.{% endif %} Wenn jemand mit Administratorberechtigungen auf die Repositorys einer Organisation einem Mitglied eine höhere Berechtigungsstufe für das Repository gewährt, überschreibt die höhere Berechtigungsstufe die Basisberechtigung. diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-adding-outside-collaborators.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-adding-outside-collaborators.md index 56e1de5c7a46..9f038f84ec7b 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-adding-outside-collaborators.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-adding-outside-collaborators.md @@ -1,6 +1,6 @@ --- -title: Berechtigungen für das Hinzufügen von externen Mitarbeitern festlegen -intro: 'Zum Schutz Deiner Organisationsdaten und der Anzahl der bezahlten Lizenzen in Deiner Organisation kannst Du es ausschließlich Inhabern erlauben, externe Mitarbeiter zu Organisations-Repositorys einzuladen.' +title: Setting permissions for adding outside collaborators +intro: 'To protect your organization''s data and the number of paid licenses used in your organization, you can allow only owners to invite outside collaborators to organization repositories.' product: '{% data reusables.gated-features.restict-add-collaborator %}' redirect_from: - /articles/restricting-the-ability-to-add-outside-collaborators-to-organization-repositories/ @@ -10,7 +10,7 @@ versions: enterprise-server: '*' --- -Organisationsinhaber und Mitglieder mit Administratorberechtigungen für ein Repository können externe Mitarbeiter einladen, an dem Repository zu arbeiten. Du kannst das Recht, externe Mitarbeiter einzuladen, auf ausschließlich Organisationsinhaber einschränken. +Organization owners, and members with admin privileges for a repository, can invite outside collaborators to work on the repository. You can also restrict outside collaborator invite permissions to only organization owners. {% data reusables.organizations.outside-collaborators-use-seats %} @@ -18,6 +18,7 @@ Organisationsinhaber und Mitglieder mit Administratorberechtigungen für ein Rep {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.member-privileges %} -5. Under "Repository invitations", select **Allow members to invite outside collaborators to repositories for this organization**.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} ![Checkbox to allow members to invite outside collaborators to organization repositories](/assets/images/help/organizations/repo-invitations-checkbox-updated.png){% else %} -![Checkbox to allow members to invite outside collaborators to organization repositories](/assets/images/help/organizations/repo-invitations-checkbox.png){% endif %} -6. Klicke auf **Save** (Speichern). +5. Under "Repository invitations", select **Allow members to invite outside collaborators to repositories for this organization**.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} + ![Checkbox to allow members to invite outside collaborators to organization repositories](/assets/images/help/organizations/repo-invitations-checkbox-updated.png){% else %} + ![Checkbox to allow members to invite outside collaborators to organization repositories](/assets/images/help/organizations/repo-invitations-checkbox.png){% endif %} +6. Click **Save**. diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-deleting-or-transferring-repositories.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-deleting-or-transferring-repositories.md index e391d50039c5..615f4e343457 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-deleting-or-transferring-repositories.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-deleting-or-transferring-repositories.md @@ -1,6 +1,6 @@ --- title: Berechtigungen zum Löschen oder Übertragen von Repositorys festlegen -intro: Du kannst Organisationsmitgliedern mit Administratorberechtigungen für ein Repository das Löschen oder Übertragen des Repositorys erlauben oder Du kannst diese Berechtigung allein auf Organisationsinhaber beschränken. +intro: 'Du kannst Organisationsmitgliedern mit Administratorberechtigungen für ein Repository das Löschen oder Übertragen des Repositorys erlauben oder Du kannst diese Berechtigung allein auf Organisationsinhaber beschränken.' redirect_from: - /articles/setting-permissions-for-deleting-or-transferring-repositories-in-your-organization/ - /articles/setting-permissions-for-deleting-or-transferring-repositories diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/setting-team-creation-permissions-in-your-organization.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/setting-team-creation-permissions-in-your-organization.md index f7ebc5bd4c06..9fa0b727b3ad 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/setting-team-creation-permissions-in-your-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/setting-team-creation-permissions-in-your-organization.md @@ -1,6 +1,6 @@ --- title: Berechtigungen für die Teamerstellung in Deiner Organisation festlegen -intro: 'Du kannst allen Organisationsmitgliedern erlauben, Teams zu erstellen, oder Du kannst die Möglichkeit der Teamerstellung auf Organisationsinhaber beschränken.' +intro: Du kannst allen Organisationsmitgliedern erlauben, Teams zu erstellen, oder Du kannst die Möglichkeit der Teamerstellung auf Organisationsinhaber beschränken. redirect_from: - /articles/setting-team-creation-permissions-in-your-organization versions: diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/setting-your-teams-profile-picture.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/setting-your-teams-profile-picture.md index 8f77316d5c10..1119226c714b 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/setting-your-teams-profile-picture.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/setting-your-teams-profile-picture.md @@ -1,6 +1,6 @@ --- title: Profilbild Deines Teams festlegen -intro: Team-Betreuer und Organisationsinhaber können für Teams Profilbilder festlegen. Das Profilbild wird auf der Seite des Teams angezeigt. +intro: 'Team-Betreuer und Organisationsinhaber können für Teams Profilbilder festlegen. Das Profilbild wird auf der Seite des Teams angezeigt.' redirect_from: - /articles/setting-your-team-s-profile-picture - /articles/setting-your-teams-profile-picture diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/transferring-organization-ownership.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/transferring-organization-ownership.md index 03c386b4fdfe..456809015626 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/transferring-organization-ownership.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/transferring-organization-ownership.md @@ -3,7 +3,7 @@ title: Inhaberschaft an einer Organisation übertragen redirect_from: - /articles/needs-polish-how-do-i-give-ownership-to-an-organization-to-someone-else/ - /articles/transferring-organization-ownership -intro: 'Wenn Du Deine Inhaberschaft an einem Organisationskonto auf eine andere Person übertragen möchtest, musst Du einen neuen Inhaber hinzufügen{% if currentVersion == "free-pro-team@latest" %}, sicherstellen, dass die Abrechnungsinformationen aktualisiert werden{% endif %}, und Dich dann selbst aus dem Konto entfernen.' +intro: 'To make someone else the owner of an organization account, you must add a new owner{% if currentVersion == "free-pro-team@latest" %}, ensure that the billing information is updated,{% endif %} and then remove yourself from the account.' versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md index 54fe5661897e..4ad96878b65a 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md @@ -7,9 +7,11 @@ versions: free-pro-team: '*' --- -Die Standardnutzungsbedingungen sind eine Vereinbarung zwischen {% data variables.product.prodname_dotcom %} und Dir als Einzelperson. Um im Auftrag einer Entität, beispielsweise eines Unternehmens, einer gemeinnützigen Organisation oder einer Gruppe, eine Vereinbarung mit {% data variables.product.prodname_dotcom %} abzuschließen, können Organisationsinhaber ein Hochstufen auf die Unternehmensnutzungsbedingungen vornehmen. +Die Standardnutzungsbedingungen sind eine Vereinbarung zwischen {% data variables.product.prodname_dotcom %} und Ihnen als Einzelperson. Um im Auftrag einer Entität, beispielsweise eines Unternehmens, einer gemeinnützigen Organisation oder einer Gruppe, eine Vereinbarung mit {% data variables.product.prodname_dotcom %} abzuschließen, können Organisationsinhaber ein Hochstufen auf die Unternehmensnutzungsbedingungen vornehmen. -1. Wende Dich an {% data variables.contact.contact_support %}, um ein Hochstufen auf die Unternehmensnutzungsbedingungen anzufordern. Dadurch wird ein Banner im Dashboard Deiner Organisation aktiviert, woraufhin Du die Unternehmensnutzungsbedingungen akzeptieren kannst. +1. Kontakt + +{% data variables.contact.contact_support %} to request an upgrade to the Corporate Terms of Service. Dadurch wird ein Banner im Dashboard Ihrer Organisation aktiviert, wodurch Sie die Unternehmensnutzungsbedingungen akzeptieren können. {% data reusables.dashboard.access-org-dashboard %} 3. Klicke im oberen Bereich der Seite rechts neben dem Banner „Terms of Service“ (Nutzungsbedingungen) auf **Sign now** (Jetzt unterschreiben). ![Schaltfläche „Sign now“ (Jetzt unterschreiben)](/assets/images/help/organizations/sign-now-button.png) 4. Lies die Informationen zu den Unternehmensnutzungsbedingungen. Wähle anschließend **Yes, I want to sign these terms on behalf of my business** (Ja, ich möchte diese Nutzungsbedingungen im Auftrag meines Unternehmens unterschreiben). ![Kontrollkästchen für die Unterschrift im Auftrag Deines Unternehmens](/assets/images/help/organizations/sign-on-behalf-business.png) diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md index 3704fbfd7415..0e1aaac86781 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md @@ -1,6 +1,6 @@ --- title: Domänen Deiner Organisation überprüfen -intro: 'Du kannst die von Deiner Organisation kontrollierten Domänen verifizieren, um die Identität Deiner Organisation auf {% data variables.product.product_name %} zu bestätigen.' +intro: 'Sie können die von Ihrer Organisation gesteuerten Domains überprüfen, um die Identität Ihrer Organisation auf {% data variables.product.product_name %} zu bestätigen.' redirect_from: - /articles/verifying-your-organization-s-domain - /articles/verifying-your-organizations-domain @@ -10,7 +10,7 @@ versions: Um Domänen auf {% data variables.product.product_name %} zu verifizieren, musst Du in der Organisation über Inhaberberechtigungen verfügen. Weitere Informationen finden Sie unter „[Berechtigungsebenen für eine Organisation](/articles/permission-levels-for-an-organization)". Darüber hinaus benötigst Du Zugriff, um die Domänen-Einträge mit Deinem Domänen-Hosting-Dienst zu ändern. -Nachdem Du die Inhaberschaft der Domains Deiner Organisation verifiziert hast, wird im Profil der Organisation der Badge „Verified“ (Verifiziert) angezeigt. Wenn Deine Organisation in {% data variables.product.prodname_ghe_cloud %} vorhanden ist und den Unternehmensnutzungsbedingungen zugestimmt hat, können Organisationsinhaber die Identität der Organisationsmitglieder verifizieren, indem sie die E-Mail-Adresse der jeweiligen Mitglieder innerhalb der verifizierten Domäne anzeigen. Weitere Informationen findest Du unter „[Informationen zum Profil Deiner Organisation](/articles/about-your-organization-s-profile/)“ und „[Auf Unternehmensnutzungsbedingungen umsteigen](/articles/upgrading-to-the-corporate-terms-of-service).“ +Nachdem Du die Inhaberschaft der Domains Deiner Organisation verifiziert hast, wird im Profil der Organisation der Badge „Verified“ (Verifiziert) angezeigt. Wenn Ihre Organisation in {% data variables.product.prodname_ghe_cloud %} vorhanden ist und den Unternehmensnutzungsbedingungen zugestimmt hat, können Organisationsinhaber die Identität der Organisationsmitglieder verifizieren, indem sie die E-Mail-Adresse der jeweiligen Mitglieder in der verifizierten Domain anzeigen. Weitere Informationen findest Du unter „[Informationen zum Profil Deiner Organisation](/articles/about-your-organization-s-profile/)“ und „[Auf Unternehmensnutzungsbedingungen umsteigen](/articles/upgrading-to-the-corporate-terms-of-service).“ Damit der Badge „Verified“ (Verifiziert) angezeigt wird, müssen die in Deinem Profil angezeigten Website- und E-Mail-Informationen mit denen der verifizierten Domäne oder Domänen übereinstimmen. Wenn die im Profil Deiner Organisation angezeigten Website- und E-Mail-Adressen auf unterschiedlichen Domänen gehostet werden, musst Du alle Domänen verifizieren. @@ -20,7 +20,7 @@ Damit der Badge „Verified“ (Verifiziert) angezeigt wird, müssen die in Dein {% endnote %} -Auf {% data variables.product.prodname_ghe_cloud %} kannst Du nach dem Verifizieren der Inhaberschaft der Domäne Deiner Organisation die E-Mail-Benachrichtigungen für die Organisation auf diese Domäne beschränken. Weitere Informationen findest Du unter „[E-Mail-Benachrichtigungen auf eine genehmigte Domäne beschränken](/articles/restricting-email-notifications-to-an-approved-domain).“ +Auf {% data variables.product.prodname_ghe_cloud %} können Sie nach dem Verifizieren der Inhaberschaft der Domain Ihrer Organisation E-Mail-Benachrichtigungen für die Organisation auf diese Domain beschränken. Weitere Informationen findest Du unter „[E-Mail-Benachrichtigungen auf eine genehmigte Domäne beschränken](/articles/restricting-email-notifications-to-an-approved-domain).“ {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/viewing-whether-users-in-your-organization-have-2fa-enabled.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/viewing-whether-users-in-your-organization-have-2fa-enabled.md index 40619022510b..a3d23db53778 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/viewing-whether-users-in-your-organization-have-2fa-enabled.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/viewing-whether-users-in-your-organization-have-2fa-enabled.md @@ -1,5 +1,5 @@ --- -title: 'Überprüfen, ob die Benutzer Deiner Organisation die 2FA aktiviert haben' +title: Überprüfen, ob die Benutzer Deiner Organisation die 2FA aktiviert haben intro: 'Du kannst anzeigen, welche Organisationsinhaber, Mitglieder und externen Mitarbeiter die Zwei-Faktor-Authentifizierung aktiviert haben.' redirect_from: - /articles/viewing-whether-users-in-your-organization-have-2fa-enabled @@ -10,7 +10,7 @@ versions: {% note %} -**Hinweis:** Du kannst festlegen, dass alle Mitglieder{% if currentVersion == "free-pro-team@latest" %}einschließlich Inhabern, Abrechnungsmanagern und{% else %} und{% endif %} externen Mitarbeiter in Deiner Organisation die Zwei-Faktor-Authentifizierung aktiviert haben müssen. Weitere Informationen finden Sie unter „[Zwei-Faktor-Authentifizierung in Ihrer Organisation erzwingen](/articles/requiring-two-factor-authentication-in-your-organization)“. +**Note:** You can require that all members{% if currentVersion == "free-pro-team@latest" %}, including, owners, billing managers and{% else %} and{% endif %} outside collaborators in your organization have two-factor authentication enabled. Weitere Informationen finden Sie unter „[Zwei-Faktor-Authentifizierung in Ihrer Organisation erzwingen](/articles/requiring-two-factor-authentication-in-your-organization)“. {% endnote %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/about-enterprise-accounts.md b/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/about-enterprise-accounts.md index 43eb587ea2b3..73f649b3d37b 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/about-enterprise-accounts.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/about-enterprise-accounts.md @@ -1,6 +1,6 @@ --- title: Informationen zu „Enterprise“ (Unternehmens)-Konten -intro: 'Mit {% data variables.product.prodname_ghe_cloud %} kannst Du ein Enterprise-Konto erstellen, um die Zusammenarbeit zwischen Deinen Organisationen zu ermöglichen und gleichzeitig den Administratoren einen zentralen Anlaufpunkt für Transparenz und Verwaltung zu bieten.' +intro: 'Mit {% data variables.product.prodname_ghe_cloud %} können Sie ein Enterprise Konto erstellen, um die Zusammenarbeit zwischen Ihren Organisationen zu ermöglichen und gleichzeitig den Administratoren einen zentralen Anlaufpunkt für Transparenz und Verwaltung zu bieten.' product: '{% data reusables.gated-features.enterprise-accounts %}' redirect_from: - /articles/about-github-business-accounts/ @@ -12,12 +12,12 @@ versions: ### Informationen zu „Enterprise“ (Unternehmens)-Konten -Mit einem Unternehmens-Konto kannst Du mehrere {% data variables.product.prodname_dotcom %}-Organisationen und {% data variables.product.prodname_ghe_server %}-Instanzen verwalten. Dein Enterprise-Konto benötigt einen Anker, wie zum Beispiel eine Organisation oder ein persönliches Konto auf {% data variables.product.prodname_dotcom %}. Enterprise-Administratoren können Einstellungen und Voreinstellungen verwalten, darunter folgende: +Mit einem Unternehmens-Konto kannst Du mehrere {% data variables.product.prodname_dotcom %}-Organisationen und {% data variables.product.prodname_ghe_server %}-Instanzen verwalten. Ihr Enterprise-Konto benötigt einen Handle, beispielsweise eine Organisation oder ein persönliches Konto auf {% data variables.product.prodname_dotcom %}. Enterprise-Administratoren können Einstellungen und Voreinstellungen verwalten, darunter folgende: - Mitgliederzugang und -verwaltung (Organisationsmitglieder, externe Mitarbeiter) - Abrechnung und Nutzung ({% data variables.product.prodname_ghe_server %}-Instanzen, Benutzerlizenzen, {% data variables.large_files.product_name_short %}-Pakete) - Sicherheit (Single-Sign-On, Zwei-Faktor-Authentifizierung) -- Anfragen und Support-Paket-Einreichung bei {% data variables.contact.enterprise_support %} +- Anfragen und Unterstützen von Bundle-Sharing mit {% data variables.contact.enterprise_support %} {% data reusables.enterprise-accounts.enterprise-accounts-billing %} @@ -25,17 +25,15 @@ Weitere Informationen über die Unterschiede zwischen {% data variables.product. Weitere Informationen zu Mitgliederzugang und -verwaltung findest Du unter „[Benutzer in Deinem Enterprise-Konto verwalten](/articles/managing-users-in-your-enterprise-account).“ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} For more information about managing enterprise accounts using the GraphQL API, see "[Enterprise accounts](/v4/guides/managing-enterprise-accounts)." -{% endif %} ### Mit Deinem Enterprise-Konto verknüpfte Organisationen verwalten Organisationen sind gemeinsame Konten, in denen Personengruppen projektübergreifend zusammenarbeiten können. Inhaber können den Mitgliederzugang zu den Daten und Projekten der Organisation mit komplexen Sicherheits- und Administrationsfunktionen verwalten. Weitere Informationen finden Sie unter „[Informationen zu Organisationen](/articles/about-organizations)“. -Enterprise-Inhaber können Organisationen erstellen und mit dem Enterprise-Konto verknüpfen. Nachdem Du Organisationen zu Deinem Enterprise-Konto hinzugefügt hast, kannst Du die Richtlinien der Organisationen verwalten und erzwingen. Die spezifischen Optionen für das Erzwingen variieren je nach Einstellung. Im Allgemeinen kannst Du wählen, ob Du eine einzige Richtlinie für alle Organisationen in Deinem Enterprise-Konto erzwingen willst, oder ob Du es den Inhabern ermöglichen möchtest, Richtlinien auf Organisationsebene festzulegen. +Enterprise-Inhaber können Organisationen erstellen und mit dem Enterprise-Konto verknüpfen. Nachdem Du Organisationen zu Deinem Enterprise-Konto hinzugefügt hast, kannst Du die Richtlinien der Organisationen verwalten und erzwingen. Die spezifischen Optionen für das Erzwingen variieren je nach Einstellung. Im Allgemeinen können Sie wählen, ob Sie eine einzige Richtlinie für alle Organisationen in Ihrem Enterprise-Konto erzwingen oder es den Inhabern ermöglichen möchten, Richtlinien auf Organisationsebene festzulegen. -Weitere Informationen findest Du unter „[Organisationen in Deinem Enterprise-Konto verwalten](/articles/managing-organizations-in-your-enterprise-account)“ und „[Richtlinien für Organisationen in Deinem Enterprise-Konto festlegen](/articles/setting-policies-for-organizations-in-your-enterprise-account).“ +Weitere Informationen finden Sie unter „[Organisationen in Ihrem Enterprise-Konto verwalten](/articles/managing-organizations-in-your-enterprise-account)“ und „[Richtlinien für Organisationen in Ihrem Enterprise-Konto festlegen](/articles/setting-policies-for-organizations-in-your-enterprise-account)“. ### {% data variables.product.prodname_ghe_server %}-Lizenzen verwalten, die mit Deinem Unternehmens-Konto verknüpft sind diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/adding-organizations-to-your-enterprise-account.md b/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/adding-organizations-to-your-enterprise-account.md index c5392521d6e8..14e905b62d1a 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/adding-organizations-to-your-enterprise-account.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/adding-organizations-to-your-enterprise-account.md @@ -1,6 +1,6 @@ --- title: Organisationen zu Deinem Enterprise-Konto hinzufügen -intro: 'Du kannst neue Organisationen erstellen, um sie in Deinem Enterprise-Konto zu verwalten.' +intro: Du kannst neue Organisationen erstellen, um sie in Deinem Enterprise-Konto zu verwalten. product: '{% data reusables.gated-features.enterprise-accounts %}' redirect_from: - /articles/adding-organizations-to-your-enterprise-account @@ -14,7 +14,7 @@ Um Deinem Enterprise-Konto eine Organisation hinzuzufügen, musst Du die Organis ### Eine Organisation in Deinem Enterprise-Konto erstellen -Die von Dir in den Einstellungen des Enterprise-Kontos erstellten Organisationen sind im {% data variables.product.prodname_ghe_cloud %}-Abonnement Deines Enterprise-Kontos enthalten. Weitere Informationen zur Zusammenarbeit in Organisationen findest Du unter „[Organisationen und Teams einrichten und verwalten](/categories/setting-up-and-managing-organizations-and-teams).“ +Die von Ihnen in den Einstellungen des Enterprise-Kontos erstellten Organisationen sind im {% data variables.product.prodname_ghe_cloud %}-Abonnement Ihres Enterprise-Kontos enthalten. Weitere Informationen zur Zusammenarbeit in Organisationen findest Du unter „[Organisationen und Teams einrichten und verwalten](/categories/setting-up-and-managing-organizations-and-teams).“ Enterprise-Inhaber, die eine dem Enterprise-Konto gehörende Organisation erstellen, werden automatisch zu Organisationsinhabern. Weitere Informationen zu Organisationsinhabern findest Du unter „[Berechtigungsebenen für eine Organisation](/articles/permission-levels-for-an-organization).“ diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md b/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md new file mode 100644 index 000000000000..7a75d8c7a30d --- /dev/null +++ b/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md @@ -0,0 +1,19 @@ +--- +title: Configuring the retention period for GitHub Actions artifacts and logs in your enterprise account +intro: 'Enterprise owners can configure the retention period for {% data variables.product.prodname_actions %} artifacts and logs in an enterprise account.' +product: '{% data reusables.gated-features.enterprise-accounts %}' +miniTocMaxHeadingLevel: 4 +versions: + free-pro-team: '*' + enterprise-server: '>=2.23' +--- + +{% data reusables.actions.about-artifact-log-retention %} + +## Setting the retention period for an enterprise + +{% data reusables.enterprise_site_admin_settings.access-settings %} +{% data reusables.enterprise_site_admin_settings.business %} +{% data reusables.enterprise-accounts.policies-tab %} +{% data reusables.enterprise-accounts.actions-tab %} +{% data reusables.github-actions.change-retention-period-for-artifacts-logs %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account.md b/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account.md index be3bf6997a4f..f559ff6e7ac1 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account.md @@ -13,13 +13,26 @@ By default, {% data variables.product.prodname_actions %} is enabled in all orga Before you can configure {% data variables.product.prodname_code_scanning %} for a repository, you must enable {% data variables.product.prodname_code_scanning %} by adding a {% data variables.product.prodname_actions %} workflow to the repository. - ### Managing {% data variables.product.prodname_actions %} permissions for your enterprise account +You can disable all workflows for an enterprise or set a policy that configures which actions can be used in an organization. + +{% data reusables.actions.actions-use-policy-settings %} + {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.actions-tab %} {% data reusables.actions.enterprise-actions-permissions %} +1. Klicke auf **Save** (Speichern). + +### Allowing specific actions to run + +{% data reusables.actions.allow-specific-actions-intro %} + +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.policies-tab %} +{% data reusables.enterprise-accounts.actions-tab %} +1. Under **Policies**, select **Allow specific actions** and add your required actions to the list. ![Add actions to allow list](/assets/images/help/organizations/enterprise-actions-policy-allow-list.png) ### Enabling workflows for private repository forks diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/index.md b/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/index.md index 2b9a06476c5b..acc040e33577 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/index.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/index.md @@ -14,6 +14,7 @@ versions: {% topic_link_in_list /managing-your-enterprise-account %} {% link_in_list /about-enterprise-accounts %} {% link_in_list /viewing-the-subscription-and-usage-for-your-enterprise-account %} + {% link_in_list /managing-licenses-for-visual-studio-subscription-with-github-enterprise %} {% topic_link_in_list /managing-users-in-your-enterprise-account %} {% link_in_list /roles-for-an-enterprise-account %} {% link_in_list /inviting-people-to-manage-your-enterprise-account %} @@ -32,3 +33,4 @@ versions: {% link_in_list /configuring-saml-single-sign-on-and-scim-for-your-enterprise-account-using-okta %} {% link_in_list /enforcing-a-policy-on-dependency-insights-in-your-enterprise-account %} {% link_in_list /enforcing-github-actions-policies-in-your-enterprise-account %} + {% link_in_list /configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/inviting-people-to-manage-your-enterprise-account.md b/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/inviting-people-to-manage-your-enterprise-account.md index 6e1f04e5eebc..907cbfa64ee1 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/inviting-people-to-manage-your-enterprise-account.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/inviting-people-to-manage-your-enterprise-account.md @@ -1,6 +1,6 @@ --- title: Personen zur Verwaltung Deines Enterprise-Kontos einladen -intro: 'Du kannst Personen dazu einladen, Enterprise-Inhaber oder Abrechnungsmanager in Deinem Enterprise-Konto zu werden. Du kannst auch Enterprise-Inhaber und Abrechnungsmanager entfernen, die nicht mehr auf Dein Enterprise-Konto zugreifen müssen.' +intro: Du kannst Personen dazu einladen, Enterprise-Inhaber oder Abrechnungsmanager in Deinem Enterprise-Konto zu werden. Du kannst auch Enterprise-Inhaber und Abrechnungsmanager entfernen, die nicht mehr auf Dein Enterprise-Konto zugreifen müssen. product: '{% data reusables.gated-features.enterprise-accounts %}' redirect_from: - /articles/inviting-people-to-collaborate-in-your-business-account/ diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md b/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md new file mode 100644 index 000000000000..55bb271f666f --- /dev/null +++ b/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md @@ -0,0 +1,42 @@ +--- +title: Managing licenses for Visual Studio subscription with GitHub Enterprise +intro: 'You can manage {% data variables.product.prodname_enterprise %} licensing for {% data variables.product.prodname_vss_ghe %}.' +redirect_from: + - /github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-the-github-enterprise-and-visual-studio-bundle + - /github/articles/about-the-github-and-visual-studio-bundle + - /articles/about-the-github-and-visual-studio-bundle +versions: + free-pro-team: '*' +--- + +### Informationen zu {% data variables.product.prodname_vss_ghe %} + +{% data variables.product.prodname_vss_ghe %} is a combined offering from Microsoft that allows a subscriber to use both {% data variables.product.prodname_enterprise %} and {% data variables.product.prodname_vs %}. {% data variables.product.prodname_vss_ghe %} is available from Microsoft under the terms of the Microsoft Enterprise Agreement. For more information, see [{% data variables.product.prodname_vss_ghe %}](https://visualstudio.microsoft.com/subscriptions/visual-studio-github/) on the {% data variables.product.prodname_vs %} website. + +After you assign a license for {% data variables.product.prodname_vss_ghe %} to a subscriber, the subscriber will use the {% data variables.product.prodname_enterprise %} portion of the license by joining an organization in your enterprise account with a user account on {% data variables.product.prodname_dotcom_the_website %}. + +Weitere Informationen zu {% data variables.product.prodname_enterprise %} finden Sie unter „[Produkte von {% data variables.product.company_short %}](/github/getting-started-with-github/githubs-products#github-enterprise)“. For more information about accounts on {% data variables.product.prodname_dotcom_the_website %}, see "[Types of {% data variables.product.prodname_dotcom %} accounts](/github/getting-started-with-github/types-of-github-accounts)." + +### Vorrausetzungen + +1. After you buy {% data variables.product.prodname_vss_ghe %}, contact {% data variables.contact.contact_enterprise_sales %} and mention "{% data variables.product.prodname_vss_ghe %}." You'll work with the Sales team to create an enterprise account on {% data variables.product.prodname_dotcom_the_website %}. If you already have an enterprise account on {% data variables.product.prodname_dotcom_the_website %}, or if you're not sure, please tell our Sales team. + +2. Assign licenses for {% data variables.product.prodname_vss_ghe %} to subscribers in {% data variables.product.prodname_vss_admin_portal_with_url %}. For more information about assigning licenses, see [Manage {% data variables.product.prodname_vs %} subscriptions with {% data variables.product.prodname_enterprise %}](https://docs.microsoft.com/en-us/visualstudio/subscriptions/assign-github) in the Microsoft Docs. + +3. On {% data variables.product.prodname_dotcom_the_website %}, create at least one organization owned by your enterprise account. For more information, see "[Adding organizations to your enterprise account](/github/setting-up-and-managing-your-enterprise-account/adding-organizations-to-your-enterprise-account)." + +4. The subscriber must create a user account on {% data variables.product.prodname_dotcom_the_website %}, and the email address for the account must be the same email address as the email address in the {% data variables.product.prodname_vs %} portal. For more information, see "[Signing up for {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/signing-up-for-github)" and "[Managing email preferences](/github/setting-up-and-managing-your-github-user-account/managing-email-preferences)." + +### Inviting a subscriber to use {% data variables.product.prodname_enterprise %} + +To use the {% data variables.product.prodname_enterprise %} portion of the license, the subscriber must join an organization owned by your enterprise account on {% data variables.product.prodname_dotcom_the_website %}. Organization owners can invite new members to an organization. For more information, see "[Inviting users to join your organization](/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization)." + +### Viewing {% data variables.product.prodname_enterprise %} licensing + +After assigning a license for {% data variables.product.prodname_vss_ghe %} in {% data variables.product.prodname_vss_admin_portal_with_url %}, you can view the number of {% data variables.product.prodname_enterprise %} licenses available to your enterprise account. Weitere Informationen findest Du unter „[Abonnement und Nutzung für Dein Enterprise-Konto anzeigen](/github/setting-up-and-managing-your-enterprise-account/viewing-the-subscription-and-usage-for-your-enterprise-account).“ + +You can also see pending {% data variables.product.prodname_enterprise %} invitations to subscribers in {% data variables.product.prodname_vss_admin_portal_with_url %}. The list of pending invitations includes subscribers who are not yet members of at least one organization in your enterprise account. Weitere Informationen finden Sie unter „[Personen Ihres Enterprise-Kontos anzeigen](/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account#viewing-members-and-outside-collaborators)“. + +### Weiterführende Informationen + +- [Introducing Visual Studio subscriptions with GitHub Enterprise](https://docs.microsoft.com/en-us/visualstudio/subscriptions/access-github) in the Microsoft Docs diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/roles-for-an-enterprise-account.md b/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/roles-for-an-enterprise-account.md index 4b1888ccbe9a..e9694a7418c9 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/roles-for-an-enterprise-account.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/roles-for-an-enterprise-account.md @@ -1,6 +1,6 @@ --- title: Rollen für ein Enterprise-Kontos -intro: Zur Steuerung des Zugriffs auf die Einstellungen und Daten Deines Enterprise-Kontos kannst Du den Benutzern Deines Enterprise-Kontos verschiedene Rollen zuweisen. +intro: 'Zur Steuerung des Zugriffs auf die Einstellungen und Daten Deines Enterprise-Kontos kannst Du den Benutzern Deines Enterprise-Kontos verschiedene Rollen zuweisen.' product: '{% data reusables.gated-features.enterprise-accounts %}' redirect_from: - /articles/permission-levels-for-a-business-account/ diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account.md b/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account.md index 671b72f8d240..c3099ae42b4b 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account.md @@ -16,6 +16,7 @@ Du kannst Enterprise-Inhaber und Abrechnungsmanager anzeigen, wie auch eine List {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.people-tab %} {% data reusables.enterprise-accounts.administrators-tab %} +1. Optionally, to view a list of pending invitations, click **_NUMBER_ pending**. !["NUMBER pending" button to the right of search and filter options](/assets/images/help/enterprises/administrators-pending.png) ### Mitglieder und externe Mitarbeiter anzeigen @@ -25,7 +26,8 @@ Du kannst alle {% data variables.product.prodname_ghe_cloud %}-Organisationen un {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.people-tab %} -3. Wenn Du optional anstelle der Liste der Mitglieder eine Liste der externen Mitarbeiter anzeigen möchtest, klicke auf **Outside collaborators** (Externe Mitarbeiter). ![Registerkarte „Outside collaborators“ (Externe Mitarbeiter) auf der Seite „Organization members“ (Organisationsmitglieder)](/assets/images/help/business-accounts/outside-collaborators-tab.png) +1. Wenn Du optional anstelle der Liste der Mitglieder eine Liste der externen Mitarbeiter anzeigen möchtest, klicke auf **Outside collaborators** (Externe Mitarbeiter). ![Registerkarte „Outside collaborators“ (Externe Mitarbeiter) auf der Seite „Organization members“ (Organisationsmitglieder)](/assets/images/help/business-accounts/outside-collaborators-tab.png) +1. Optionally, to view a list of pending invitations, click **_NUMBER_ pending**. !["NUMBER pending" button to the right of search and filter options](/assets/images/help/enterprises/members-pending.png) ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/viewing-the-audit-logs-for-organizations-in-your-enterprise-account.md b/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/viewing-the-audit-logs-for-organizations-in-your-enterprise-account.md index ca49ac49ad25..a8431c540ab6 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/viewing-the-audit-logs-for-organizations-in-your-enterprise-account.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-enterprise-account/viewing-the-audit-logs-for-organizations-in-your-enterprise-account.md @@ -1,6 +1,6 @@ --- title: Auditprotokolle für Organisationen in Deinem Enterprise-Konto anzeigen -intro: 'Enterprise-Inhaber können im zugehörigen Auditprotokoll aggregierte Aktionen aus allen Organisationen anzeigen, die einem Enterprise-Konto gehören.' +intro: Enterprise-Inhaber können im zugehörigen Auditprotokoll aggregierte Aktionen aus allen Organisationen anzeigen, die einem Enterprise-Konto gehören. product: '{% data reusables.gated-features.enterprise-accounts %}' redirect_from: - /articles/viewing-the-audit-logs-for-organizations-in-your-business-account/ diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/about-your-organizations-profile.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/about-your-organizations-profile.md index f7b972afbdbb..a7c287ab4691 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/about-your-organizations-profile.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/about-your-organizations-profile.md @@ -11,7 +11,7 @@ versions: Du kannst optional eine Beschreibung, einen Standort, eine Website und eine E-Mail-Adresse für Deine Organisation hinzufügen und wichtige Repositorys am Anfang der Seite anheften. -{% if currentVersion == "free-pro-team@latest" %}Um die Identität Deiner Organisation zu bestätigen und einen „Verifiziert“-Badge auf der Profilseite Deiner Organisation anzuzeigen, musst Du die Domänen Deiner Organisation mit {% data variables.product.product_name %} verifizieren. Weitere Informationen findest Du unter „[Domänen Deiner Organisation überprüfen](/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain).“ +{% if currentVersion == "free-pro-team@latest" %}To confirm your organization's identity and display a "Verified" badge on your organization profile page, you must verify your organization's domains with {% data variables.product.product_name %}. Weitere Informationen findest Du unter „[Domänen Deiner Organisation überprüfen](/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain).“ ![Beispiel einer verifizierten Profilseite einer Organisation](/assets/images/help/profile/org_profile_verified.png) {% else %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/customizing-your-profile.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/customizing-your-profile.md index 34ee6bbfda70..8eb53ff28e9e 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/customizing-your-profile.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/customizing-your-profile.md @@ -1,6 +1,6 @@ --- title: Dein Profil anpassen -intro: 'Du kannst Dein Profil anpassen, damit andere Benutzer sich ein besseres Bild von Deiner Person und Deiner Arbeit machen können.' +intro: Du kannst Dein Profil anpassen, damit andere Benutzer sich ein besseres Bild von Deiner Person und Deiner Arbeit machen können. mapTopic: true redirect_from: - /articles/customizing-your-profile diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md index 84a6b1eb2962..edda043a6219 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md @@ -1,6 +1,6 @@ --- title: Dein Profil personalisieren -intro: 'Du kannst Informationen zu Deiner Person für andere {% data variables.product.product_name %}-Benutzer bereitstellen, indem Du ein Profilbild einrichtest und eine Biografie zum Profil hinzufügst.' +intro: 'Sie können Informationen zu Ihrer Person für andere {% data variables.product.product_name %}-Benutzer bereitstellen, indem Sie ein Profilbild einrichten und eine Biografie zum Profil hinzufügen.' redirect_from: - /articles/adding-a-bio-to-your-profile/ - /articles/setting-your-profile-picture/ @@ -15,9 +15,9 @@ versions: ### Dein Profilbild ändern -Mit Deinem Profilbild kannst Du überall auf {% data variables.product.product_name %} in Pull Requests, Kommentaren, Beiträge-Seiten und Diagrammen leichter identifiziert werden. +Mit Ihrem Profilbild können Sie überall auf {% data variables.product.product_name %} in Pull Requests, Kommentaren, Beiträge-Seiten und Diagrammen leichter identifiziert werden. -Wenn Du ein Konto anlegst, stellt {% data variables.product.product_name %} Dir ein zufällig generiertes „Identicon“ bereit. [Dein Identicon](https://github.com/blog/1586-identicons) wird aus einem Hash Deiner Benutzer-ID erzeugt. Seine Farbe und sein Muster lassen sich daher nicht steuern. Du kannst das Identicon durch ein Bild ersetzen, das Dich repräsentiert. +Wenn Sie ein Konto anlegen, stellt {% data variables.product.product_name %} Ihnen ein zufällig generiertes „Identicon“ bereit. [Dein Identicon](https://github.com/blog/1586-identicons) wird aus einem Hash Deiner Benutzer-ID erzeugt. Seine Farbe und sein Muster lassen sich daher nicht steuern. Du kannst das Identicon durch ein Bild ersetzen, das Dich repräsentiert. {% tip %} @@ -40,14 +40,14 @@ Wenn Du ein Konto anlegst, stellt {% data variables.product.product_name %} Dir ### Deinen Profilnamen ändern -Du kannst den Namen, der in Deinem Profil angezeigt wird, ändern. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} Dieser Name kann auch neben Kommentaren angezeigt werden, die Du bei privaten Repositorys einer Organisation hinterlässt. Weitere Informationen findest Du unter „[Anzeige der Mitgliedsnamen in Deiner Organisation verwalten](/articles/managing-the-display-of-member-names-in-your-organization)“.{% endif %} +Du kannst den Namen, der in Deinem Profil angezeigt wird, ändern. This name may also be displayed next to comments you make on private repositories owned by an organization. Weitere Informationen findest Du unter „[Anzeige der Mitgliedsnamen in Deiner Organisation verwalten](/articles/managing-the-display-of-member-names-in-your-organization)“. {% data reusables.user_settings.access_settings %} 2. Gib unter „Name“ den Namen ein, der in Deinem Profil angezeigt werden soll. ![Feld „Name“ (Name) in den Profileinstellungen](/assets/images/help/profile/name-field.png) ### Eine Biografie zu Deinem Profil hinzufügen -Füge eine Biografie zu Deinem Profil hinzu, um anderen {% data variables.product.product_name %}-Benutzern Informationen zu Deiner Person bereitzustellen. Mit [@Erwähnungen](/articles/basic-writing-and-formatting-syntax) und Emojis kannst Du Informationen dazu angeben, wo Du gerade arbeitest oder früher gearbeitet hast, welche Tätigkeit Du ausübst oder welche Kaffeesorte Du trinkst. +Fügen Sie eine Biografie zu Ihrem Profil hinzu, um anderen {% data variables.product.product_name %}-Benutzern Informationen zu Ihrer Person bereitzustellen. Mit [@Erwähnungen](/articles/basic-writing-and-formatting-syntax) und Emojis kannst Du Informationen dazu angeben, wo Du gerade arbeitest oder früher gearbeitet hast, welche Tätigkeit Du ausübst oder welche Kaffeesorte Du trinkst. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} @@ -101,12 +101,12 @@ Wenn Sie die Option „Busy“ (Beschäftigt) auswählen, wird ein entsprechende When you participate in certain programs, {% data variables.product.prodname_dotcom %} automatically displays a badge on your profile. -| Badge | Program | Beschreibung | -| --------------------------------------------------------------- | ------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Badge | Program | Beschreibung | +| --------------------------------------------------------------- | -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | {% octicon "north-star" aria-label="The North Star icon" %} | **{% data variables.product.prodname_arctic_vault %} Contributor** | If you authored any commit(s) on the default branch of a repository that was archived in the 2020 Arctic Vault program, you'll get an {% data variables.product.prodname_arctic_vault %} Contributor badge on your profile. For more information on the program, see [{% data variables.product.prodname_archive %}](https://archiveprogram.github.com). | -| {% octicon "cpu" aria-label="The Developer Program icon" %} | **Developer Program Member** | If you're a registered member of the GitHub Developer Program, building an app with the GitHub API, you'll get a Developer Program Member badge on your profile. For more information on the GitHub Developer Program, see [GitHub Developer](/program/). | -| {% octicon "heart-fill" aria-label="The GitHub Sponsor icon" %} | **GitHub Sponsor** | If you sponsored an open source contributor through {% data variables.product.prodname_sponsors %} you'll get a GitHub Sponsor badge on your profile. For more information, see "[Sponsoring open source contributors](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-open-source-contributors)." | -| {% octicon "star-fill" aria-label="The star icon" %} | **Pro** | If you use {% data variables.product.prodname_pro %} you'll get a PRO badge on your profile. Weitere Informationen zu {% data variables.product.prodname_pro %} finden Sie unter „[Produkte von {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/githubs-products#github-pro)“. | +| {% octicon "cpu" aria-label="The Developer Program icon" %} | **Developer Program Member** | If you're a registered member of the GitHub Developer Program, building an app with the GitHub API, you'll get a Developer Program Member badge on your profile. For more information on the GitHub Developer Program, see [GitHub Developer](/program/). | +| {% octicon "heart-fill" aria-label="The GitHub Sponsor icon" %} | **GitHub Sponsor** | If you sponsored an open source contributor through {% data variables.product.prodname_sponsors %} you'll get a GitHub Sponsor badge on your profile. For more information, see "[Sponsoring open source contributors](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-open-source-contributors)." | +| {% octicon "star-fill" aria-label="The star icon" %} | **Pro** | If you use {% data variables.product.prodname_pro %} you'll get a PRO badge on your profile. Weitere Informationen zu {% data variables.product.prodname_pro %} finden Sie unter „[Produkte von {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/githubs-products#github-pro)“. | ### Disabling badges on your profile diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/pinning-items-to-your-profile.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/pinning-items-to-your-profile.md index 925abb7775f4..68e6ef005963 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/pinning-items-to-your-profile.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/pinning-items-to-your-profile.md @@ -1,6 +1,6 @@ --- title: Elemente an Dein Profil anheften -intro: 'Du kannst {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.16" %}Gists und {% endif %}Repositorys an Dein Profil anheften, damit andere Personen Deine besten Arbeiten schnell sehen können.' +intro: 'You can pin {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.16" %}gists and {% endif %}repositories to your profile so other people can quickly see your best work.' redirect_from: - /articles/pinning-repositories-to-your-profile/ - /articles/pinning-items-to-your-profile diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/publicizing-or-hiding-your-private-contributions-on-your-profile.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/publicizing-or-hiding-your-private-contributions-on-your-profile.md index 0007c14e19db..932fc34511db 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/publicizing-or-hiding-your-private-contributions-on-your-profile.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/publicizing-or-hiding-your-private-contributions-on-your-profile.md @@ -1,6 +1,6 @@ --- title: Private Beiträge in Deinem Profil veröffentlichen oder verbergen -intro: 'Dein {% data variables.product.product_name %}-Profil zeigt ein Diagramm Deiner Repository-Beiträge des letzten Jahres an. Du kannst auswählen, ob neben den Aktivitäten in öffentlichen Repositorys auch anonymisierte Aktivitäten in privaten Repositorys angezeigt werden sollen.' +intro: 'Ihr {% data variables.product.product_name %}-Profil zeigt ein Diagramm Ihrer Repository-Beiträge des letzten Jahres an. Du kannst auswählen, ob neben den Aktivitäten in öffentlichen Repositorys auch anonymisierte Aktivitäten in privaten Repositorys angezeigt werden sollen.' redirect_from: - /articles/publicizing-or-hiding-your-private-contributions-on-your-profile versions: diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/sending-your-github-enterprise-server-contributions-to-your-githubcom-profile.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/sending-your-github-enterprise-server-contributions-to-your-githubcom-profile.md index c152c766ade0..174dba9dbc26 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/sending-your-github-enterprise-server-contributions-to-your-githubcom-profile.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/sending-your-github-enterprise-server-contributions-to-your-githubcom-profile.md @@ -1,6 +1,6 @@ --- title: GitHub Enterprise Server-Beiträge an Dein GitHub.com-Profil senden -intro: 'Du kannst Deine Arbeiten auf {% data variables.product.prodname_ghe_server %} hervorheben, indem Du die Anzahl Deiner Beiträge an Dein {% data variables.product.prodname_dotcom_the_website %}-Profil sendest.' +intro: 'Sie können Ihre Arbeiten auf {% data variables.product.prodname_ghe_server %} hervorheben, indem Sie die Anzahl Ihrer Beiträge an Ihr {% data variables.product.prodname_dotcom_the_website %}-Profil senden.' redirect_from: - /articles/sending-your-github-enterprise-contributions-to-your-github-com-profile/ - /articles/sending-your-github-enterprise-server-contributions-to-your-github-com-profile @@ -15,11 +15,11 @@ versions: **Hinweise:** - Für die Verbindung zwischen Deinen Konten gilt die GitHub-Datenschutzerklärung. Benutzer, die diese Verbindung aktivieren, stimmen den Nutzungsbedingungen von GitHub zu. -- Um Dein {% data variables.product.prodname_ghe_server %}-Profil mit Deinem {% data variables.product.prodname_dotcom_the_website %}-Profil verbinden zu können, muss ein Websiteadministrator {% data variables.product.prodname_github_connect %} und den Beitragsaustausch zwischen den Umgebungen aktivieren. Weitere Informationen erhältst Du von Deinem {% data variables.product.prodname_ghe_server %}-Websiteadministrator. +- Um Ihr {% data variables.product.prodname_ghe_server %}-Profil mit Ihrem {% data variables.product.prodname_dotcom_the_website %}-Profil verbinden zu können, muss ein Websiteadministrator {% data variables.product.prodname_github_connect %} und den Beitragsaustausch zwischen den Umgebungen aktivieren. Weitere Informationen erhältst Du von Deinem {% data variables.product.prodname_ghe_server %}-Websiteadministrator. {% endnote %} -Dein {% data variables.product.prodname_dotcom_the_website %}-Profil zeigt die Anzahl Deiner {% data variables.product.prodname_ghe_server %}-Beiträge der letzten 90 Tage an. Die {% data reusables.github-connect.sync-frequency %}-Anzahl Deiner Beiträge aus {% data variables.product.prodname_ghe_server %} wird unter Deinen privaten Beiträgen erfasst. Die Commit-Details enthalten nur die Beitragszähler und die Information, dass diese Beiträge auf {% data variables.product.prodname_ghe_server %} erfolgt sind. +Ihr {% data variables.product.prodname_dotcom_the_website %}-Profil zeigt die Anzahl Ihrer {% data variables.product.prodname_ghe_server %}-Beiträge der letzten 90 Tage an. Die {% data reusables.github-connect.sync-frequency %}-Anzahl Ihrer Beiträge aus {% data variables.product.prodname_ghe_server %} wird unter Ihren privaten Beiträgen erfasst. Die Commit-Details enthalten nur die Beitragszähler und die Information, dass diese Beiträge auf {% data variables.product.prodname_ghe_server %} erfolgt sind. Endbenutzer von {% data variables.product.prodname_ghe_server %} und {% data variables.product.prodname_dotcom_the_website %} können ihre privaten Beitragszahlen veröffentlichen. Weitere Informationen findest Du unter „[Private Beiträge in Deinem Profil veröffentlichen oder verbergen](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile/).“ @@ -30,4 +30,4 @@ Weitere Informationen zur Berechnung der Beitragszahlen findest Du unter „[Bet {% data reusables.github-connect.github-connect-tab-user-settings %} {% data reusables.github-connect.connect-dotcom-and-enterprise %} {% data reusables.github-connect.authorize-connection %} -6. Aktiviere unter „Contributions“ (Beiträge) das Kontrollkästchen **Send my contribution counts to {% data variables.product.prodname_dotcom_the_website %}** (Anzahl meiner Beiträge an {% data variables.product.prodname_dotcom_the_website %} senden), und klicke auf **Update contributions** (Beiträge aktualisieren). ![Kontrollkästchen „Send my contribution counts...“ (Anzahl meiner Beiträge senden) und Schaltfläche „Update contributions“ (Beiträge aktualisieren)](/assets/images/help/settings/send-and-update-contributions.png) +6. Aktivieren Sie unter „Contributions“ (Beiträge) das Kontrollkästchen **Send my contribution counts to {% data variables.product.prodname_dotcom_the_website %}** (Anzahl meiner Beiträge an {% data variables.product.prodname_dotcom_the_website %} senden), und klicken Sie auf **Update contributions** (Beiträge aktualisieren). ![Kontrollkästchen „Send my contribution counts...“ (Anzahl meiner Beiträge senden) und Schaltfläche „Update contributions“ (Beiträge aktualisieren)](/assets/images/help/settings/send-and-update-contributions.png) diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/showing-an-overview-of-your-activity-on-your-profile.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/showing-an-overview-of-your-activity-on-your-profile.md index 02f7cb108260..72330f8d663a 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/showing-an-overview-of-your-activity-on-your-profile.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/showing-an-overview-of-your-activity-on-your-profile.md @@ -1,6 +1,6 @@ --- title: Übersicht über Deine Aktivitäten in Deinem Profil anzeigen -intro: 'In Deinem Profil kannst Du die Aktivitätsübersicht aktivieren, in der Betrachter eine Übersicht über die Art Deiner Beiträge erhalten.' +intro: In Deinem Profil kannst Du die Aktivitätsübersicht aktivieren, in der Betrachter eine Übersicht über die Art Deiner Beiträge erhalten. redirect_from: - /articles/showing-an-overview-of-your-activity-on-your-profile versions: diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/viewing-contributions-on-your-profile.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/viewing-contributions-on-your-profile.md index 164d6a3dc81f..f5a90ef0d922 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/viewing-contributions-on-your-profile.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/viewing-contributions-on-your-profile.md @@ -1,6 +1,6 @@ --- title: Beiträge auf Deinem Profil anzeigen -intro: 'Dein {% data variables.product.product_name %}-Profil zeigt Deine angehefteten Repositorys und ein Diagramm mit Deinen Repository-Beiträgen des letzten Jahres an.' +intro: 'Ihr {% data variables.product.product_name %}-Profil zeigt Ihre angehefteten Repositorys und ein Diagramm mit Ihren Repository-Beiträgen des letzten Jahres an.' redirect_from: - /articles/viewing-contributions/ - /articles/viewing-contributions-on-your-profile-page/ @@ -25,7 +25,7 @@ Bestimmte Aktionen zählen auf Deiner Profilseite als Beiträge: - Commits zum Standardbranch eines Repositorys oder zum Branch `gh-pages` - das Öffnen eines Issues - das Vorschlagen eines Pull Requests -- das Absenden eines Pull-Request-Reviews{% if currentVersion != "free-pro-team@latest" %} +- Submitting a pull request review{% if currentVersion != "free-pro-team@latest" %} - Commits mit Co-Autor im Standardbranch eines Repositorys oder im Branch `gh-pages`{% endif %} {% data reusables.pull_requests.pull_request_merges_and_contributions %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/why-are-my-contributions-not-showing-up-on-my-profile.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/why-are-my-contributions-not-showing-up-on-my-profile.md index 42744352cac7..e0e75feccc58 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/why-are-my-contributions-not-showing-up-on-my-profile.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-profile/why-are-my-contributions-not-showing-up-on-my-profile.md @@ -1,6 +1,6 @@ --- title: Warum werden meine Beiträge nicht in meinem Profil angezeigt? -intro: 'Beim Beteiligungsdiagramm für Dein Profil handelt es sich um eine Aufzeichnung Deiner Beiträge für {% data variables.product.product_name %}-Repositorys. Beiträge werden nicht entsprechend Deiner lokalen Zeitzone, sondern entsprechend der UTC-Zone (Coordinated Universal Time, koordinierte Weltzeit) mit Zeitstempeln versehen. Beiträge werden nur gezählt, falls sie bestimmte Kriterien erfüllen. In manchen Fällen muss Dein Diagramm allenfalls neu erstellt werden, damit die Beiträge angezeigt werden.' +intro: 'Beim Beteiligungsdiagramm für Ihr Profil handelt es sich um einen Eintrag Ihrer Beiträge für {% data variables.product.product_name %}-Repositorys. Beiträge werden nicht entsprechend Deiner lokalen Zeitzone, sondern entsprechend der UTC-Zone (Coordinated Universal Time, koordinierte Weltzeit) mit Zeitstempeln versehen. Beiträge werden nur gezählt, falls sie bestimmte Kriterien erfüllen. In manchen Fällen muss Dein Diagramm allenfalls neu erstellt werden, damit die Beiträge angezeigt werden.' redirect_from: - /articles/why-are-my-contributions-not-showing-up-on-my-profile versions: @@ -16,7 +16,7 @@ Issues und Pull Requests werden in Deinem Beteiligungsdiagramm angezeigt, falls #### Commits Commits werden in Deinem Beteiligungsdiagramm angezeigt, falls sie **alle** folgenden Bedingungen erfüllen: -- Die für die Commits verwendete E-Mail-Adresse ist mit Deinem {% data variables.product.product_name %}-Konto verknüpft. +- Die für die Commits verwendete E-Mail-Adresse ist mit Ihrem {% data variables.product.product_name %}-Konto verknüpft. - Die Commits wurden in einem eigenständigen Repository vorgenommen und nicht in einem Fork. - Die Commits wurden - In the repository's default branch @@ -67,7 +67,7 @@ Commits are only counted if they are made in the default branch or the `gh-pages Falls sich Deine Commits auf einem Nicht-Standard- oder Nicht-`gh-pages`-Branch befinden und sie auf Deine Beiträge angerechnet werden sollen, musst Du eine der folgenden Aktionen durchführen: - [Öffne einen Pull Request](/articles/creating-a-pull-request), damit Deine Änderungen in den Standardbranch oder in den `gh-pages`-Branch zusammengeführt werden. -- [Ändere den Standardbranch](/articles/setting-the-default-branch) des Repositorys. +- [Ändere den Standardbranch](/github/administering-a-repository/changing-the-default-branch) des Repositorys. {% warning %} @@ -79,7 +79,7 @@ Durch das Ändern des Standardbranch des Repositorys wird er für alle Repositor Die in einem Fork durchgeführten Commits werden nicht auf Deine Beiträge angerechnet. Führe eine der folgenden Aktionen durch, damit sie angerechnet werden: - [Öffne einen Pull Request](/articles/creating-a-pull-request), damit Deine Änderungen in das übergeordnete Repository zusammengeführt werden. -- Wende Dich an {% data variables.contact.contact_support %}, falls Du den Fork trennen und in ein eigenständiges Repository auf {% data variables.product.product_name %} umwandeln möchtest. Wenn der Fork eigene Forks hat, musst Du {% data variables.contact.github_support %} wissen lassen, ob die Forks mit Deinem Repository in ein neues Netzwerk verschoben werden sollen oder im aktuellen Netzwerk verbleiben sollen. Weitere Informationen findest Du unter „[Informationen zu Forks](/articles/about-forks/).“ +- Wenden Sie sich an {% data variables.contact.contact_support %}, falls Sie den Fork trennen und in ein eigenständiges Repository auf {% data variables.product.product_name %} umwandeln möchten. Wenn der Fork eigene Forks hat, musst Du {% data variables.contact.github_support %} wissen lassen, ob die Forks mit Deinem Repository in ein neues Netzwerk verschoben werden sollen oder im aktuellen Netzwerk verbleiben sollen. Weitere Informationen findest Du unter „[Informationen zu Forks](/articles/about-forks/).“ ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/about-organization-membership.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/about-organization-membership.md index 115b870effa6..ac7fadd5611d 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/about-organization-membership.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/about-organization-membership.md @@ -1,6 +1,6 @@ --- title: Informationen zur Organisationsmitgliedschaft -intro: 'Du kannst Mitglied einer Organisation werden, um mit Mitarbeitern oder Open-Source-Mitwirkenden in vielen Repositorys gleichzeitig zusammenzuarbeiten.' +intro: Du kannst Mitglied einer Organisation werden, um mit Mitarbeitern oder Open-Source-Mitwirkenden in vielen Repositorys gleichzeitig zusammenzuarbeiten. redirect_from: - /articles/about-organization-membership versions: diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/about-your-personal-dashboard.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/about-your-personal-dashboard.md index b03829c0f887..eb3c724a1236 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/about-your-personal-dashboard.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/about-your-personal-dashboard.md @@ -12,9 +12,9 @@ versions: ### Auf Dein persönliches Dashboard zugreifen -Dein persönliches Dashboard ist die erste Seite, die Sie Du siehst, wenn Du Dich bei {% data variables.product.product_name %} anmeldest. +Ihr persönliches Dashboard ist die erste Seite, die Sie sehen, wenn Sie sich bei {% data variables.product.product_name %} anmelden. -Um nach der Anmeldung auf Dein persönliches Dashboard zuzugreifen, klicke auf das {% octicon "mark-github" aria-label="The github octocat logo" %} in der oberen linken Ecke einer beliebigen Seite auf {% data variables.product.product_url %}. +Um nach der Anmeldung auf Ihr persönliches Dashboard zuzugreifen, klicken Sie auf das {% octicon "mark-github" aria-label="The github octocat logo" %} in der oberen linken Ecke einer beliebigen Seite auf {% data variables.product.product_url %}. ### Neueste Aktivitäten finden @@ -46,7 +46,7 @@ Weitere Informationen zu Sternen für Repositorys und zum Folgen von Personen fi ### Empfohlene Repositorys erkunden -Im Abschnitt "Explore repositories" (Repositories erkunden) auf der rechten Seite Deines Dashboards kannst Du empfohlene Repositorys in Deinen Communities erkunden. Empfehlungen basieren auf den von Dir markierten oder besuchten Repositorys, auf den Personen, denen Du folgst und auf den Aktivitäten innerhalb der Repositorys, auf die Du Zugriff hast.{% if currentVersion == "free-pro-team@latest" %} Weitere Informationen findest Du unter „[Möglichkeiten zum Beitragen an Open Source auf {% data variables.product.prodname_dotcom %} finden](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)."{% endif %} +Im Abschnitt "Explore repositories" (Repositories erkunden) auf der rechten Seite Deines Dashboards kannst Du empfohlene Repositorys in Deinen Communities erkunden. Recommendations are based on repositories you've starred or visited, the people you follow, and activity within repositories that you have access to.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[Finding ways to contribute to open source on {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)."{% endif %} ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/adding-an-email-address-to-your-github-account.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/adding-an-email-address-to-your-github-account.md index 7fe4d5b8a2ed..2e4940fdf355 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/adding-an-email-address-to-your-github-account.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/adding-an-email-address-to-your-github-account.md @@ -1,6 +1,6 @@ --- title: Eine E-Mail-Adresse zu Deinem GitHub-Konto hinzufügen -intro: 'Bei {% data variables.product.product_name %} kannst Du so viele E-Mail-Adressen zu Deinem Konto hinzufügen, wie Du möchtest. Wenn Du eine E-Mail-Adresse in der lokalen Git-Konfiguration festlegst, musst Du diese Adresse zu Deinen Kontoeinstellungen hinzufügen, um Deine Commits mit Deinem Konto zu verbinden. Weitere Informationen zu E-Mail-Adressen und Commits findest Du unter „[Deine Commit-E-Mail-Adresse festlegen](/articles/setting-your-commit-email-address/).“' +intro: 'Bei {% data variables.product.product_name %} können Sie so viele E-Mail-Adressen zu Ihrem Konto hinzufügen, wie Sie möchten. Wenn Du eine E-Mail-Adresse in der lokalen Git-Konfiguration festlegst, musst Du diese Adresse zu Deinen Kontoeinstellungen hinzufügen, um Deine Commits mit Deinem Konto zu verbinden. Weitere Informationen zu E-Mail-Adressen und Commits findest Du unter „[Deine Commit-E-Mail-Adresse festlegen](/articles/setting-your-commit-email-address/).“' redirect_from: - /articles/adding-an-email-address-to-your-github-account versions: diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/blocking-command-line-pushes-that-expose-your-personal-email-address.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/blocking-command-line-pushes-that-expose-your-personal-email-address.md index d477f4e8fef1..6db318791173 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/blocking-command-line-pushes-that-expose-your-personal-email-address.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/blocking-command-line-pushes-that-expose-your-personal-email-address.md @@ -1,5 +1,5 @@ --- -title: 'Pushes über die Befehlszeile blockieren, die Deine private E-Mail-Adresse offenlegen' +title: Pushes über die Befehlszeile blockieren, die Deine private E-Mail-Adresse offenlegen intro: 'Wenn Du festgelegt hast, dass Deine E-Mail-Adresse beim Durchführen webbasierter Vorgänge nicht offengelegt wird, kannst Du auch Pushes über die Befehlszeile blockieren, die Deine private E-Mail-Adresse offenlegen könnten.' redirect_from: - /articles/blocking-command-line-pushes-that-expose-your-personal-email-address diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/changing-your-github-username.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/changing-your-github-username.md index 543cf6e97dcf..8140f491016e 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/changing-your-github-username.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/changing-your-github-username.md @@ -1,6 +1,6 @@ --- -title: Deinen GitHub-Benutzernamen ändern -intro: 'Du kannst Deinen {% data variables.product.product_name %}-Benutzernamen jederzeit ändern.' +title: Changing your GitHub username +intro: 'You can change your {% data variables.product.product_name %} username at any time.' redirect_from: - /articles/how-to-change-your-username/ - /articles/changing-your-github-user-name/ @@ -12,46 +12,50 @@ versions: enterprise-server: '*' --- -### Informationen zu Änderungen des Benutzernamens +### About username changes -Du kannst Deinen Benutzernamen in einen aktuell nicht verwendeten Benutzernamen ändern.{% if currentVersion == "free-pro-team@latest" %} Falls der gewünschte Benutzername nicht verfügbar ist, wird angezeigt, ob Du verlangen kannst, dass der Benutzername freigegeben wird, wenn Du den gewünschten Benutzernamen eingibst. +You can change your username to another username that is not currently in use.{% if currentVersion == "free-pro-team@latest" %} If the username you want is not available, you'll see information about whether you can request the username to be released when you type in the desired username. -Falls der Benutzername nicht freigegeben werden kann und Du für den Benutzernamen keine Handelsmarke führst, kannst Du einen anderen Benutzernamen auswählen oder Deinen aktuellen Benutzernamen beibehalten. {% data variables.contact.github_support %} kann den für Dich nicht verfügbaren Benutzernamen nicht freigeben. Weitere Informationen findest Du unter „[Benutzernamen ändern](#changing-your-username)“.{% endif %} +If the username is not eligible for release and you don't hold a trademark for the username, you can choose another username or keep your current username. {% data variables.contact.github_support %} cannot release the unavailable username for you. For more information, see "[Changing your username](#changing-your-username)."{% endif %} -Wenn Du Deinen Benutzernamen geändert hast, steht Dein alter Benutzername wieder der Allgemeinheit zur Verfügung. Die meisten Verweise auf Deine Repositorys unter dem alten Benutzernamen werden automatisch in den neuen Benutzernamen geändert. Einige Links auf Dein Profil werden jedoch nicht automatisch weitergeleitet. +After changing your username, your old username becomes available for anyone else to claim. Most references to your repositories under the old username automatically change to the new username. However, some links to your profile won't automatically redirect. -Für Folgendes kann {% data variables.product.product_name %} keine Weiterleitungen einrichten: -- [@Erwähnungen](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams) des alten Benutzernamens -- Links zu [Gists](/articles/creating-gists), die Deinen alten Benutzernamen enthalten +{% data variables.product.product_name %} cannot set up redirects for: +- [@mentions](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams) using your old username +- Links to [gists](/articles/creating-gists) that include your old username -### Repository-Verweise +### Repository references -Wenn Du Deinen Benutzernamen geändert hast, leitet {% data variables.product.product_name %} Verweise auf Deine Repositorys automatisch weiter. -- Weblinks zu Deinen vorhandenen Repositorys funktionieren auch weiterhin. Dieser Vorgang kann einige Minuten dauern, nachdem Du die Änderung vorgenommen hast. -- Befehlszeilen-Pushes von Deinen lokalen Repository-Klonen zu den alten Remote-Tracking-URLs funktionieren auch weiterhin. +After you change your username, {% data variables.product.product_name %} will automatically redirect references to your repositories. +- Web links to your existing repositories will continue to work. This can take a few minutes to complete after you make the change. +- Command line pushes from your local repository clones to the old remote tracking URLs will continue to work. -Wenn der neue Inhaber Deines alten Benutzernamens ein Repository mit demselben Namen wie Dein Repository erstellt, wird der Weiterleitungseintrag überschrieben und Deine Weiterleitung wird nicht mehr funktionieren. Angesichts dieser Möglichkeit empfehlen wir Dir, alle vorhandenen Remote-Repository-URLs nach dem Ändern Deines Benutzernamens zu aktualisieren. Weitere Informationen findest Du unter „[URL eines Remote-Repositorys ändern](/articles/changing-a-remote-s-url).“ +If the new owner of your old username creates a repository with the same name as your repository, that will override the redirect entry and your redirect will stop working. Because of this possibility, we recommend you update all existing remote repository URLs after changing your username. For more information, see "[Changing a remote's URL](/articles/changing-a-remote-s-url)." -### Links zu früheren Profilseiten +### Links to your previous profile page -Nach dem Ändern Deines Benutzernamens lösen Links zu Deinen früheren Profilseiten, z. B. `https://{% data variables.command_line.backticks %}/previoususername`, eine 404-Fehlermeldung aus. Wir empfehlen Dir, alle Links zu Deinem {% data variables.product.product_name %}-Konto an anderen Stellen zu aktualisieren{% if currentVersion == "free-pro-team@latest" %}, z. B. in Deinem LinkedIn- oder Twitter-Profil{% endif %}. +After changing your username, links to your previous profile page, such as `https://{% data variables.command_line.backticks %}/previoususername`, will return a 404 error. We recommend updating any links to your {% data variables.product.product_name %} account from elsewhere{% if currentVersion == "free-pro-team@latest" %}, such as your LinkedIn or Twitter profile{% endif %}. -### Deine Git-Commits +### Your Git commits -{% if currentVersion == "free-pro-team@latest"%}Git-Commits, die mit Deiner von {% data variables.product.product_name %} bereitgestellten `no-reply`-E-Mail-Adresse verknüpft wurden, werden nicht mit Deinem neuen Benutzernamen verknüpft und sind nicht in Deinem neuen Beteiligungsdiagramm enthalten.{% endif %} Wenn Deine Git-Commits mit einer anderen E-Mail-Adresse verknüpft sind, die Du [zu Deinem GitHub-Konto hinzugefügt hast](/articles/adding-an-email-address-to-your-github-account), {% if currentVersion == "free-pro-team@latest"%}einschließlich der ID-basierten, von {% data variables.product.product_name %} bereitgestellten `no-reply`-E-Mail-Adresse, {% endif %}werden sie auch nach dem Ändern Deines Benutzernamens weiterhin mit Dir verknüpft und in Deinem Beteiligungsdiagramm enthalten sein. Weitere Informationen zum Einrichten Deiner E-Mail-Adresse findest Du unter „[Commit-E-Mail-Adresse festlegen](/articles/setting-your-commit-email-address).“ +{% if currentVersion == "free-pro-team@latest"%}Git commits that were associated with your {% data variables.product.product_name %}-provided `noreply` email address won't be attributed to your new username and won't appear in your contributions graph.{% endif %} If your Git commits are associated with another email address you've [added to your GitHub account](/articles/adding-an-email-address-to-your-github-account), {% if currentVersion == "free-pro-team@latest"%}including the ID-based {% data variables.product.product_name %}-provided `noreply` email address, {% endif %}they'll continue to be attributed to you and appear in your contributions graph after you've changed your username. For more information on setting your email address, see "[Setting your commit email address](/articles/setting-your-commit-email-address)." -### Deinen Benutzernamen ändern +### Changing your username {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.account_settings %} -3. Klicke im Abschnitt „Change username“ (Benutzername ändern) auf **Change username** (Benutzername ändern). ![Schaltfläche Ändere Benutzernamen](/assets/images/help/settings/settings-change-username.png){% if currentVersion == "free-pro-team@latest" %} -4. Lies die Warnungen in Bezug auf das Ändern Deines Benutzernamens. Falls Du Deinen Benutzernamen dennoch ändern möchtest, klicke auf **I understand, let's change my username** (Ich habe verstanden, meinen Benutzernamen ändern). ![Schaltfläche mit Warnung zur Änderung des Benutzernamens](/assets/images/help/settings/settings-change-username-warning-button.png) -5. Gib einen neuen Benutzernamen ein. ![Feld für neuen Benutzernamen](/assets/images/help/settings/settings-change-username-enter-new-username.png) -6. Falls der gewünschte Benutzername verfügbar ist, klicke auf **Change my username** (Meinen Benutzernamen ändern). Falls der gewünschte Benutzername nicht verfügbar ist, kannst Du versuchen, einen anderen Benutzernamen oder einen der angezeigten Vorschläge zu verwenden. ![Schaltfläche mit Warnung zur Änderung des Benutzernamens](/assets/images/help/settings/settings-change-my-username-button.png) +3. In the "Change username" section, click **Change username**. + ![Change Username button](/assets/images/help/settings/settings-change-username.png){% if currentVersion == "free-pro-team@latest" %} +4. Read the warnings about changing your username. If you still want to change your username, click **I understand, let's change my username**. + ![Change Username warning button](/assets/images/help/settings/settings-change-username-warning-button.png) +5. Type a new username. + ![New username field](/assets/images/help/settings/settings-change-username-enter-new-username.png) +6. If the username you've chosen is available, click **Change my username**. If the username you've chosen is unavailable, you can try a different username or one of the suggestions you see. + ![Change Username warning button](/assets/images/help/settings/settings-change-my-username-button.png) {% endif %} -### Weiterführende Informationen +### Further reading -- „[URL eines Remote-Repositorys ändern](/articles/changing-a-remote-s-url)“ -- „[Warum sind meine Commits mit dem falschen Benutzer verknüpft?](/articles/why-are-my-commits-linked-to-the-wrong-user)“{% if currentVersion == "free-pro-team@latest" %} -- „[{% data variables.product.prodname_dotcom %}-Richtlinie zu Benutzernamen](/articles/github-username-policy)“{% endif %} +- "[Changing a remote's URL](/articles/changing-a-remote-s-url)" +- "[Why are my commits linked to the wrong user?](/articles/why-are-my-commits-linked-to-the-wrong-user)"{% if currentVersion == "free-pro-team@latest" %} +- "[{% data variables.product.prodname_dotcom %} Username Policy](/articles/github-username-policy)"{% endif %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md index 719bbc8a39fb..0aa5fac301ab 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md @@ -8,6 +8,12 @@ versions: enterprise-server: '*' --- +{% note %} + +**Note:** You cannot change your primary email address to an email that is already set to be your backup email address. + +{% endnote %} + {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.emails %} 3. Wenn Du eine neue E-Mail-Adresse hinzufügen und als primäre E-Mail-Adresse festlegen möchtest, gib unter „Add email address“ (E-Mail-Adresse hinzufügen) eine neue E-Mail-Adresse ein. Klicke dann auf **Add** (Hinzufügen). ![Schaltfläche zum Hinzufügen einer anderen E-Mail-Adresse](/assets/images/help/settings/add_another_email_address.png) @@ -15,7 +21,8 @@ versions: 5. To remove the old email address from your account, next to the old email, click {% octicon "trashcan" aria-label="The trashcan symbol" %}. {% if currentVersion == "free-pro-team@latest" %} -6. Verifiziere Deine neue primäre E-Mail-Adresse. Ohne verifizierte E-Mail-Adresse kannst Du nicht alle Funktionen von {% data variables.product.product_name %} nutzen. Weitere Informationen findest Du unter „[Eigene E-Mail-Adresse verifizieren](/articles/verifying-your-email-address).“ +6. Verifiziere Deine neue primäre E-Mail-Adresse. Without a verified email address, you won't be able to use all of +{% data variables.product.product_name %}'s features. Weitere Informationen findest Du unter „[Eigene E-Mail-Adresse verifizieren](/articles/verifying-your-email-address).“ {% endif %} ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md index 2f659ef8d914..f470a3255de1 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md @@ -4,7 +4,7 @@ redirect_from: - /articles/what-is-the-difference-between-create-new-organization-and-turn-account-into-an-organization/ - /articles/explaining-the-account-transformation-warning/ - /articles/converting-a-user-into-an-organization -intro: 'Du kannst Dein Benutzerkonto in eine Organisation umwandeln. Dadurch sind feiner abgestufte Berechtigungen für Repositorys möglich, die zu der Organisation gehören.' +intro: Du kannst Dein Benutzerkonto in eine Organisation umwandeln. Dadurch sind feiner abgestufte Berechtigungen für Repositorys möglich, die zu der Organisation gehören. versions: free-pro-team: '*' enterprise-server: '*' @@ -17,7 +17,7 @@ versions: - Du kannst Dich **nicht mehr** beim umgewandelten Benutzerkonto anmelden. - Du kannst **keine** Gists mehr erstellen oder ändern, die zum umgewandelten Benutzerkonto gehören. - Eine Organisation **kann nicht** zurück in einen Benutzer umgewandelt werden. - - Die SSH-Schlüssel, OAuth-Token, das Auftragsprofil{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, die Reaktionen{% endif %} und die zugehörigen Benutzerinformationen **werden nicht** an die Organisation übertragen. Dies gilt nur für das Benutzerkonto, das umgewandelt wird, nicht für die Mitarbeiter des Benutzerkontos. + - The SSH keys, OAuth tokens, job profile, reactions, and associated user information, **will not** be transferred to the organization. Dies gilt nur für das Benutzerkonto, das umgewandelt wird, nicht für die Mitarbeiter des Benutzerkontos. - Alle Commits, die mit dem umgewandelten Benutzerkonto vorgenommen wurden, **sind nicht mehr** mit diesem Konto verknüpft. Die Commits selbst **bleiben** intakt. {% endwarning %} @@ -35,7 +35,7 @@ Wenn Du möchtest, dass Deine Organisation denselben Namen aufweist, den Du aktu Du kannst Dein persönliches Benutzerkonto auch direkt in eine Organisation umwandeln. Beim Umwandeln Deines Kontos geschieht Folgendes: - Die Repositorys werden so beibehalten, wie sie sind, ohne dass Du sie manuell an ein anderes Konto übertragen musst - Es werden automatisch Mitarbeiter zu Teams eingeladen, wobei die Berechtigungen den bisherigen Berechtigungen entsprechen. - {% if currentVersion == "free-pro-team@latest" %}– Bei Benutzerkonten auf {% data variables.product.prodname_pro %} wird die Abrechnung automatisch auf [das bezahlte {% data variables.product.prodname_team %}](/articles/about-billing-for-github-accounts) umgestellt, ohne dass Du die Zahlungsinformationen erneut eingeben, Deinen Abrechnungszeitraum anpassen oder doppelt bezahlen musst.{% endif %} + {% if currentVersion == "free-pro-team@latest" %}- For user accounts on {% data variables.product.prodname_pro %}, automatically transitions billing to [the paid {% data variables.product.prodname_team %}](/articles/about-billing-for-github-accounts) without the need to re-enter payment information, adjust your billing cycle, or double pay at any time{% endif %} 1. Erstelle ein neues persönliches Konto, mit dem Du Dich nach der Umwandlung bei GitHub anmelden und auf die Organisation und Deine Repositorys zugreifst. 2. [Verlasse alle Organisationen](/articles/removing-yourself-from-an-organization), denen das Benutzerkonto angehört, das Du gerade umwandelst. @@ -56,5 +56,5 @@ Du kannst Dein persönliches Benutzerkonto auch direkt in eine Organisation umwa ### Weiterführende Informationen - „[Teams einrichten](/articles/setting-up-teams)“ -{% if currentVersion == "free-pro-team@latest" %}- „[Benutzer zum Beitritt zu Deiner Organisation einladen](/articles/inviting-users-to-join-your-organization)“{% endif %} +{% if currentVersion == "free-pro-team@latest" %}- "[Inviting users to join your organization](/articles/inviting-users-to-join-your-organization)"{% endif %} - „[Auf eine Organisation zugreifen](/articles/accessing-an-organization)“ diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/deleting-your-user-account.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/deleting-your-user-account.md index ed396700e0e4..7bfb8fd77c71 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/deleting-your-user-account.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/deleting-your-user-account.md @@ -1,6 +1,6 @@ --- title: Dein Benutzerkonto löschen -intro: 'Du kannst Dein {% data variables.product.product_name %}-Benutzerkonto jederzeit löschen.' +intro: 'Sie können Ihr {% data variables.product.product_name %}-Benutzerkonto jederzeit löschen.' redirect_from: - /articles/deleting-a-user-account/ - /articles/deleting-your-user-account @@ -9,9 +9,9 @@ versions: enterprise-server: '*' --- -Wenn Du Dein Benutzerkonto löschst, werden alle dazugehörigen Repositorys, Forks von privaten Repositorys, Wikis, Issues, Pull Requests und Seiten Deines Kontos ebenfalls gelöscht. {% if currentVersion == "free-pro-team@latest" %} Deine Issues, Pull Requests und Kommentare in Repositorys von anderen Benutzern werden nicht gelöscht, sondern mit unserem [Ghost user](https://github.com/ghost) (Geisterbenutzer) verknüpft.{% else %}Deine Issues, Pull Requests und Kommentare in Repositorys von anderen Benutzern werden nicht gelöscht.{% endif %} +Wenn Du Dein Benutzerkonto löschst, werden alle dazugehörigen Repositorys, Forks von privaten Repositorys, Wikis, Issues, Pull Requests und Seiten Deines Kontos ebenfalls gelöscht. {% if currentVersion == "free-pro-team@latest" %} Issues and pull requests you've created and comments you've made in repositories owned by other users will not be deleted - instead, they'll be associated with our [Ghost user](https://github.com/ghost).{% else %}Issues and pull requests you've created and comments you've made in repositories owned by other users will not be deleted.{% endif %} -{% if currentVersion == "free-pro-team@latest" %} Außerdem steht der Name Deines Kontos wieder für andere Benutzer zur Verfügung, und Deine Abrechnung wird beendet. Die mit dem Konto verknüpfte E-Mail-Adresse wird für die Nutzung mit einem anderen {% data variables.product.product_name %}-Konto frei. {% endif %} +{% if currentVersion == "free-pro-team@latest" %} The account name also becomes available to anyone else to use on a new account, and we stop billing you. Die mit dem Konto verknüpfte E-Mail-Adresse wird für die Nutzung mit einem anderen {% data variables.product.product_name %}-Konto frei. {% endif %} Wenn Du der alleinige Inhaber einer Organisation bist, musst Du die Inhaberschaft auf eine andere Person übertragen oder die Organisation löschen, bevor Du Dein Benutzerkonto löschen kannst. Wenn es noch weitere Inhaber Deiner Organisation gibt, musst Du Dich selbst aus der Organisation löschen, bevor Du Dein Benutzerkonto löschen kannst. @@ -38,7 +38,7 @@ Bevor Du Dein Benutzerkonto löschst, erstelle Kopien aller Repositorys, private - Wenn Du der alleinige Inhaber einer Organisation bist, musst Du die Inhaberschaft auf eine andere Person übertragen oder die Organisation löschen. - Wenn es andere Inhaber der Organisation gibt, musst Du Dich selbst aus der Organisation entfernen. ![Schaltfläche zum Löschen des Kontos](/assets/images/help/settings/settings-account-delete.png) 4. Fülle das Dialogfeld „Are you sure you want to do this?“ (Möchtest Du das wirklich tun?) aus, um zu bestätigen, dass Du die Folgen der Kontolöschung verstanden hast: ![Dialogfeld zum Bestätigen der Kontolöschung](/assets/images/help/settings/settings-account-deleteconfirm.png) - {% if currentVersion == "free-pro-team@latest" %}– Denke daran, dass alle Repositorys, Forks von privaten Repositorys, Wikis, Issues, Pull Requests und Seiten von Deinem Konto ebenfalls gelöscht werden, dass Deine Abrechnung beendet wird und Dein Benutzername wieder für die Verwendung auf {% data variables.product.product_name %} freigegeben wird. + {% if currentVersion == "free-pro-team@latest" %}- Recall that all repositories, forks of private repositories, wikis, issues, pull requests and pages owned by your account will be deleted, your billing will end, and your username will be available to anyone for use on {% data variables.product.product_name %}. {% else %}– Denke daran, dass alle Repositorys, Forks von privaten Repositorys, Wikis, Issues, Pull Requests und Seiten von Deinem Konto ebenfalls gelöscht werden und Dein Benutzername wieder für die Verwendung auf {% data variables.product.product_name %} freigegeben wird. {% endif %}– Gib im ersten Feld Deinen {% data variables.product.product_name %}-Benutzernamen oder Deine E-Mail-Adresse ein. - Gib im zweiten Feld den Text von der Aufforderung ein. diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository.md index 0cd4f33e7f24..22ebcc2eb387 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository.md @@ -1,6 +1,6 @@ --- title: Mitarbeiter zu einem persönlichen Repository einladen -intro: 'Du kannst {% if currentVersion == "free-pro-team@latest" %}Benutzer als Mitarbeiter zu Deinem persönlichen Repository einladen{% else %}Benutzer als Mitarbeiter zu Deinem persönlichen Repository hinzufügen{% endif %}.' +intro: 'You can {% if currentVersion == "free-pro-team@latest" %}invite users to become{% else %}add users as{% endif %} collaborators to your personal repository.' redirect_from: - /articles/how-do-i-add-a-collaborator/ - /articles/adding-collaborators-to-a-personal-repository/ @@ -29,7 +29,7 @@ Repositorys, die einer Organisation gehören, können feiner abgestufte Zugriffs 1. Frage nach dem Benutzernamen der Person, die Du als Mitarbeiter einlädst. -{% if currentVersion == "free-pro-team@latest" %} Wenn die Person noch keinen Benutzernamen besitzt, kann sie sich für {% data variables.product.prodname_dotcom %} anmelden. Weitere Informationen findest Du unter „[Für ein neues {% data variables.product.prodname_dotcom %}-Konto anmelden](/articles/signing-up-for-a-new-github-account)“.{% endif %} +{% if currentVersion == "free-pro-team@latest" %} If they don't have a username yet, they can sign up for {% data variables.product.prodname_dotcom %} For more information, see "[Signing up for a new {% data variables.product.prodname_dotcom %} account](/articles/signing-up-for-a-new-github-account)".{% endif %} {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} {% if currentVersion == "free-pro-team@latest" %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories.md index 2731b03fc674..e04e2a0416c5 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories.md @@ -1,6 +1,6 @@ --- title: Kontinuität der Inhaberschaft der Repositorys Deines Benutzerkontos sicherstellen -intro: 'Du kannst jemanden einladen, Deine eigenen Repositorys zu verwalten, wenn Du nicht dazu in der Lage bist.' +intro: Du kannst jemanden einladen, Deine eigenen Repositorys zu verwalten, wenn Du nicht dazu in der Lage bist. versions: free-pro-team: '*' --- diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md index 523d0d4a02c2..b7bf43c72d93 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md @@ -1,6 +1,6 @@ --- title: Zugriff auf die Projektboards Deines Benutzerkontos verwalten -intro: Als Projektboard-Inhaber kannst Du einen Mitarbeiter hinzufügen oder entfernen und seine Berechtigungen für das Projektboard anpassen. +intro: 'Als Projektboard-Inhaber kannst Du einen Mitarbeiter hinzufügen oder entfernen und seine Berechtigungen für das Projektboard anpassen.' redirect_from: - /articles/managing-project-boards-in-your-repository-or-organization/ - /articles/managing-access-to-your-user-account-s-project-boards @@ -18,7 +18,9 @@ Ein Mitarbeiter ist eine Person, die Berechtigungen für eines Deiner Projektboa {% data reusables.project-management.click-menu %} {% data reusables.project-management.access-collaboration-settings %} {% data reusables.project-management.collaborator-option %} -5. Gib unter „Search by username, full name or email address“ (Nach Benutzernamen, vollständigem Namen oder E-Mail-Adresse suchen) den Namen, den Benutzernamen oder die {% data variables.product.prodname_dotcom %}-E-Mail-Adresse des Mitarbeiters ein. ![Der Bereich „Collaborators“ (Mitarbeiter) mit Octocat-Benutzernamen im Suchfeld](/assets/images/help/projects/org-project-collaborators-find-name.png) +5. Under "Search by username, full name or email address", type the collaborator's name, username, or +{% data variables.product.prodname_dotcom %} email. + ![Der Bereich „Collaborators“ (Mitarbeiter) mit Octocat-Benutzernamen im Suchfeld](/assets/images/help/projects/org-project-collaborators-find-name.png) {% data reusables.project-management.add-collaborator %} 7. Der neue Mitarbeiter besitzt standardmäßig Leseberechtigung. Wähle optional im Dropdownmenü neben dem Namen des neuen Mitarbeiters eine andere Berechtigungsebene aus. ![Der Mitarbeiter-Bereich mit ausgewähltem Berechtigungs-Dropdownmenü](/assets/images/help/projects/user-project-collaborators-edit-permissions.png) diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/managing-email-preferences.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/managing-email-preferences.md index dea1292e3439..eac2056c9ecf 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/managing-email-preferences.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/managing-email-preferences.md @@ -1,6 +1,6 @@ --- title: E-Mail-Voreinstellungen verwalten -intro: 'Du kannst die mit Deinem {% data variables.product.product_name %}-Konto verknüpften E-Mail-Adressen ändern oder E-Mail-Adressen hinzufügen. Du kannst auch E-Mails verwalten, die Du von {% data variables.product.product_name %} erhältst.' +intro: 'Sie können die mit Ihrem {% data variables.product.product_name %}-Konto verknüpften E-Mail-Adressen ändern oder E-Mail-Adressen hinzufügen. Sie können auch E-Mails verwalten, die Sie von {% data variables.product.product_name %} erhalten.' redirect_from: - /categories/managing-email-preferences/ - /articles/managing-email-preferences diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/managing-marketing-emails-from-github.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/managing-marketing-emails-from-github.md index 46e0e0ba1587..ed7a63c83480 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/managing-marketing-emails-from-github.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/managing-marketing-emails-from-github.md @@ -1,6 +1,6 @@ --- title: Marketing-E-Mails von GitHub verwalten -intro: 'Neben Benachrichtigungen und Konto-E-Mails versendet {% data variables.product.prodname_dotcom %} gelegentlich auch Marketing-E-Mails mit Neuigkeiten und Informationen zu unseren Produkten. Wenn Du die Marketing-E-Mails kündigst, bist Du von zukünftigen Kampagnen ausgeschlossen, sofern Du Deine {% data variables.product.prodname_dotcom %}-E-Mail-Einstellungen nicht wieder änderst.' +intro: 'Neben Benachrichtigungen und Konto-E-Mails versendet {% data variables.product.prodname_dotcom %} gelegentlich auch Marketing-E-Mails mit Neuigkeiten und Informationen zu unseren Produkten. Wenn Sie die Marketing-E-Mails kündigen, sind Sie von zukünftigen Kampagnen ausgeschlossen, sofern Sie Ihre {% data variables.product.prodname_dotcom %}-E-Mail-Einstellungen nicht entsprechend ändern.' redirect_from: - /articles/managing-marketing-emails-from-github versions: diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md index 84bba6dbeaea..5f0f396cbcff 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md @@ -1,6 +1,6 @@ --- title: Managing the default branch name for your repositories -intro: You can set a default branch name for all new repositories that you create. +intro: 'You can set the default branch name new repositories that you create on {% data variables.product.product_location %}.' versions: free-pro-team: '*' enterprise-server: '>=2.23' @@ -8,12 +8,10 @@ versions: ### About the default branch name -{% data reusables.branches.new-repo-default-branch %} This branch is currently named `master`, but you can set the default branch name to anything that makes sense for your development environment. +When you create a new repository on {% data variables.product.product_location %}, the repository contains one branch, which is the default branch. You can change the name that {% data variables.product.product_name %} uses for the default branch in new repositories you create. For more information about the default branch, see "[About branches](/github/collaborating-with-issues-and-pull-requests/about-branches#about-the-default-branch)." {% data reusables.branches.set-default-branch %} -{% data reusables.branches.rename-existing-branch %} - ### Setting the default branch name {% data reusables.user_settings.access_settings %} @@ -24,4 +22,4 @@ versions: ### Weiterführende Informationen -- [Managing the default branch name for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization) +- "[Managing the default branch name for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization)" diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations.md index fe3ba74d05d3..8479efa43894 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations.md @@ -1,8 +1,6 @@ --- title: Deine Mitgliedschaft in Organisationen verwalten -intro: |- - Wenn Du Mitglied einer Organisation bist, kannst Du Deine Mitgliedschaft veröffentlichen oder ausblenden, die Rollen anderer Benutzer anzeigen und - Dich selbst aus der Organisation entfernen. +intro: "Wenn Du Mitglied einer Organisation bist, kannst Du Deine Mitgliedschaft veröffentlichen oder ausblenden, die Rollen anderer Benutzer anzeigen und \nDich selbst aus der Organisation entfernen." mapTopic: true redirect_from: - /articles/managing-your-membership-in-organizations diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/managing-your-scheduled-reminders.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/managing-your-scheduled-reminders.md index 00fa50f9abe9..26b42c3d1c55 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/managing-your-scheduled-reminders.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/managing-your-scheduled-reminders.md @@ -1,6 +1,6 @@ --- title: Verwalten Deiner geplanten Erinnerungen -intro: 'Du kannst in Slack Erinnerungen erhalten, wenn für Dich oder Dein Team Pull Requests auf einen Review warten.' +intro: Du kannst in Slack Erinnerungen erhalten, wenn für Dich oder Dein Team Pull Requests auf einen Review warten. versions: free-pro-team: '*' --- diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md index d23faba45031..c6ebc8a604b9 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md @@ -1,6 +1,6 @@ --- -title: Berechtigungsebenen für ein Repository eines Benutzerkontos -intro: 'Ein Repository, das einem Benutzerkonto gehört, hat zwei Berechtigungsebenen: den *Repository-Inhaber* und die *Mitarbeiter*.' +title: Permission levels for a user account repository +intro: 'A repository owned by a user account has two permission levels: the *repository owner* and *collaborators*.' redirect_from: - /articles/permission-levels-for-a-user-account-repository versions: @@ -10,65 +10,64 @@ versions: {% tip %} -**Tipp:** Wenn Du einen feiner abgestuften Lese-/Schreibzugriff auf ein Repository benötigst, das Deinem Benutzerkonto gehört, kannst Du das Repository an eine Organisation übertragen. Weitere Informationen findest Du unter „[Ein Repository übertragen](/articles/transferring-a-repository).“ +**Tip:** If you require more granular read/write access to a repository owned by your user account, consider transferring the repository to an organization. For more information, see "[Transferring a repository](/articles/transferring-a-repository)." {% endtip %} -#### Inhaberzugriff auf ein Repository eines Benutzerkontos +#### Owner access on a repository owned by a user account -Der Repository-Inhaber besitzt die vollständige Kontrolle über das Repository. Neben den Berechtigungen, die auch Repository-Mitarbeitern erteilt werden, stehen dem Repository-Inhaber zusätzlich folgende Möglichkeiten zur Verfügung: +The repository owner has full control of the repository. In addition to all the permissions allowed by repository collaborators, the repository owner can: -- {% if currentVersion == "free-pro-team@latest" %}[Mitarbeiter einladen](/articles/inviting-collaborators-to-a-personal-repository){% else %}[Mitarbeiter hinzufügen](/articles/inviting-collaborators-to-a-personal-repository){% endif %} -- Sichtbarkeit des Repositorys ändern (von [öffentlich in privat](/articles/making-a-public-repository-private) oder von [privat in öffentlich](/articles/making-a-private-repository-public)){% if currentVersion == "free-pro-team@latest" %} -- [Interaktionen mit einem Repository einschränken](/articles/limiting-interactions-with-your-repository){% endif %} -- Einen Pull Request auf einem geschützten Branch zusammenführen, selbst ohne genehmigende Reviews -- [Das Repository löschen](/articles/deleting-a-repository) -- [Themen eines Repositorys verwalten](/articles/classifying-your-repository-with-topics){% if currentVersion == "free-pro-team@latest" %} +- {% if currentVersion == "free-pro-team@latest" %}[Invite collaborators](/articles/inviting-collaborators-to-a-personal-repository){% else %}[Add collaborators](/articles/inviting-collaborators-to-a-personal-repository){% endif %} +- Change the visibility of the repository (from [public to private](/articles/making-a-public-repository-private), or from [private to public](/articles/making-a-private-repository-public)){% if currentVersion == "free-pro-team@latest" %} +- [Limit interactions with a repository](/articles/limiting-interactions-with-your-repository){% endif %} +- Merge a pull request on a protected branch, even if there are no approving reviews +- [Delete the repository](/articles/deleting-a-repository) +- [Manage a repository's topics](/articles/classifying-your-repository-with-topics){% if currentVersion == "free-pro-team@latest" %} - Manage security and analysis settings. For more information, see "[Managing security and analysis settings for your user account](/github/setting-up-and-managing-your-github-user-account/managing-security-and-analysis-settings-for-your-user-account)."{% endif %}{% if currentVersion == "free-pro-team@latest" %} -- [das Abhängigkeitsdiagramm](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) für ein privates Repository aktivieren{% endif %}{% if currentVersion == "free-pro-team@latest" %} -- Pakete löschen. Weitere Informationen findest Du unter „[Ein Paket löschen](/github/managing-packages-with-github-packages/deleting-a-package)."{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -- soziale Tickets für Repositorys erstellen und bearbeiten (siehe „[Social-Media-Vorschau Ihres Repositorys anpassen](/articles/customizing-your-repositorys-social-media-preview)“) -- das Repository in eine Vorlage umwandeln Weitere Informationen findest Du unter „[Eine Repository-Vorlage erstellen](/articles/creating-a-template-repository)."{% endif %} -- Receive [{% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in a repository{% if currentVersion == "free-pro-team@latest" %} -- Dismiss {% data variables.product.prodname_dependabot_alerts %} in your repository. For more information, see "[Viewing and updating vulnerable dependencies in your repository](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)." +- [Enable the dependency graph](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) for a private repository{% endif %}{% if currentVersion == "free-pro-team@latest" %} +- Delete packages. For more information, see "[Deleting a package](/github/managing-packages-with-github-packages/deleting-a-package)."{% endif %} +- Create and edit repository social cards. For more information, see "[Customizing your repository's social media preview](/articles/customizing-your-repositorys-social-media-preview)." +- Make the repository a template. For more information, see "[Creating a template repository](/articles/creating-a-template-repository)." +- Receive [{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in a repository.{% if currentVersion == "free-pro-team@latest" %} +- Dismiss {% data variables.product.prodname_dependabot_alerts %} in your repository. For more information, see "[Viewing and updating vulnerable dependencies in your repository](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)." - [Manage data usage for your private repository](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository){% endif %} -- [Codeinhaber für das Repository definieren](/articles/about-code-owners) -- [Repositorys archivieren](/articles/about-archiving-repositories){% if currentVersion == "free-pro-team@latest" %} -- Sicherheitshinweise erstellen. Weitere Informationen findest Du unter „[Über {% data variables.product.prodname_security_advisories %}](/github/managing-security-vulnerabilities/about-github-security-advisories)." -- eine Sponsorenschaltfläche anzeigen Weitere Informationen findest Du unter „[Sponsorenschaltfläche in Deinem Repository anzeigen](/articles/displaying-a-sponsor-button-in-your-repository)“{% endif %} +- [Define code owners for the repository](/articles/about-code-owners) +- [Archive repositories](/articles/about-archiving-repositories){% if currentVersion == "free-pro-team@latest" %} +- Create security advisories. For more information, see "[About {% data variables.product.prodname_security_advisories %}](/github/managing-security-vulnerabilities/about-github-security-advisories)." +- Display a sponsor button. For more information, see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)."{% endif %} -Bei einem Repository, das einem Benutzerkonto gehört, gibt es nur **einen Inhaber**. Diese Berechtigung kann nicht mit einem anderem Benutzerkonto geteilt werden. Informationen zur Übertragung der Repository-Inhaberschaft auf einen anderen Benutzer findest Du unter „[Ein Repository übertragen](/articles/how-to-transfer-a-repository).“ +There is only **one owner** of a repository owned by a user account; this permission cannot be shared with another user account. To transfer ownership of a repository to another user, see "[How to transfer a repository](/articles/how-to-transfer-a-repository)." -#### Mitarbeiterzugriff auf ein Repository eines Benutzerkontos +#### Collaborator access on a repository owned by a user account {% note %} -**Hinweis:** In einem privaten Repository können Repository-Inhaber Mitarbeitern nur Schreibzugriff gewähren. Mitarbeiter können nicht Nur-Lese-Zugriff auf Repositorys haben, die einem Benutzerkonto gehören. +**Note:** In a private repository, repository owners can only grant write access to collaborators. Collaborators can't have read-only access to repositories owned by a user account. {% endnote %} -Mitarbeiter haben folgende Möglichkeiten in persönlichen Repositorys: +Collaborators on a personal repository can: -- Etwas zum Repository pushen (schreiben), etwas vom Repository abrufen (lesen) und das Repository forken (kopieren) -- Kennzeichnungen und Meilensteine erstellen, anwenden und löschen -- Issues öffnen, schließen, erneut öffnen und zuweisen -- Kommentare zu Commits, Pull Requests und Issues bearbeiten und löschen -- Issues und Pull Requests als Duplikate markieren Weitere Informationen findest Du unter „[Informationen zu Duplikaten von Issues und Pull Requests](/articles/about-duplicate-issues-and-pull-requests)“ -- Pull Requests öffnen, zusammenführen und schließen -- Vorgeschlagene Änderungen auf Pull Requests anwenden. Weitere Informationen findest Du unter „[Feedback in Deinen Pull Request aufnehmen](/articles/incorporating-feedback-in-your-pull-request).“ -- Pull Requests vom Fork des Repositorys senden{% if currentVersion == "free-pro-team@latest" %} -- Pakete veröffentlichen, ansehen und installieren. Weitere Informationen findest Du unter „[Pakete veröffentlichen und verwalten](/github/managing-packages-with-github-packages/publishing-and-managing-packages)."{% endif %} -- Wikis erstellen und bearbeiten -- Erstellen und Bearbeiten von Releases. Weitere Informationen findest Du unter „[Releases in einem Repository verwalten](/github/administering-a-repository/managing-releases-in-a-repository). -- Sich selbst als Mitarbeiter aus dem Repository entfernen -- Einen Review zu einem Pull Request absenden, der seine Merge-Fähigkeit beeinflusst -- Als designierter Codeinhaber des Repositorys agieren. Weitere Informationen findest Du unter „[Informationen zu Codeinhabern](/articles/about-code-owners).“ -- Eine Unterhaltung sperren. Weitere Informationen findest Du unter „[Unterhaltungen sperren](/articles/locking-conversations).“{% if currentVersion == "free-pro-team@latest" %} -- Missbräuchliche Inhalte an den {% data variables.contact.contact_support %} melden. Weitere Informationen findest Du unter „[Missbrauch oder Spam melden](/articles/reporting-abuse-or-spam)“.{% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -- Einen Issue in ein anderes Repository übertragen. Weitere Informationen findest Du unter „[Issue in ein anderes Repository übertragen](/articles/transferring-an-issue-to-another-repository),“{% endif %} +- Push to (write), pull from (read), and fork (copy) the repository +- Create, apply, and delete labels and milestones +- Open, close, re-open, and assign issues +- Edit and delete comments on commits, pull requests, and issues +- Mark an issue or pull request as a duplicate. For more information, see "[About duplicate issues and pull requests](/articles/about-duplicate-issues-and-pull-requests)." +- Open, merge and close pull requests +- Apply suggested changes to pull requests. For more information, see "[Incorporating feedback in your pull request](/articles/incorporating-feedback-in-your-pull-request)." +- Send pull requests from forks of the repository{% if currentVersion == "free-pro-team@latest" %} +- Publish, view, and install packages. For more information, see "[Publishing and managing packages](/github/managing-packages-with-github-packages/publishing-and-managing-packages)."{% endif %} +- Create and edit Wikis +- Create and edit releases. For more information, see "[Managing releases in a repository](/github/administering-a-repository/managing-releases-in-a-repository). +- Remove themselves as collaborators on the repository +- Submit a review on a pull request that will affect its mergeability +- Act as a designated code owner for the repository. For more information, see "[About code owners](/articles/about-code-owners)." +- Lock a conversation. For more information, see "[Locking conversations](/articles/locking-conversations)."{% if currentVersion == "free-pro-team@latest" %} +- Report abusive content to {% data variables.contact.contact_support %}. For more information, see "[Reporting abuse or spam](/articles/reporting-abuse-or-spam)."{% endif %} +- Transfer an issue to a different repository. For more information, see "[Transferring an issue to another repository](/articles/transferring-an-issue-to-another-repository)." -### Weiterführende Informationen +### Further reading -- „[Mitarbeiter in ein persönliches Repository einladen](/articles/inviting-collaborators-to-a-personal-repository)“ -- „[Berechtigungsebenen für die Repositorys einer Organisation](/articles/repository-permission-levels-for-an-organization)“ +- "[Inviting collaborators to a personal repository](/articles/inviting-collaborators-to-a-personal-repository)" +- "[Repository permission levels for an organization](/articles/repository-permission-levels-for-an-organization)" diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/remembering-your-github-username-or-email.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/remembering-your-github-username-or-email.md index 92e5ae231197..d7c7999ad13f 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/remembering-your-github-username-or-email.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/remembering-your-github-username-or-email.md @@ -1,6 +1,6 @@ --- title: Erinnerung für Deinen GitHub-Benutzernamen oder Deine GitHub-E-Mail-Adresse -intro: 'Meldest Du Dich seit langem einmal wieder bei {% data variables.product.product_location %} an? Herzlich willkommen! Wenn Du Dich nicht mehr an den Namen Deines {% data variables.product.product_name %}-Benutzerkontos erinnern kannst, versuche ihn mit den folgenden Methoden zu finden.' +intro: 'Meldest Du Dich seit langem einmal wieder bei {% data variables.product.product_location %} an? Herzlich willkommen! Wenn Sie sich nicht mehr an den Namen Ihres {% data variables.product.product_name %}-Benutzerkontos erinnern können, versuchen Sie ihn mit den folgenden Methoden zu finden.' redirect_from: - /articles/oh-noes-i-ve-forgotten-my-username-email/ - /articles/oh-noes-i-ve-forgotten-my-username-or-email/ @@ -17,7 +17,7 @@ versions: 1. Klicke im **GitHub Desktop**-Menü auf **Preferences** (Einstellungen). 2. Überprüfe im Einstellungsfenster Folgendes: - Klicke auf **Accounts** (Konten), um Deinen {% data variables.product.product_name %}-Benutzernamen anzuzeigen. - - Klicke auf **Git**, um Deine Git-E-Mail-Adresse anzuzeigen. Eventuell ist diese Adresse jedoch nicht Deine [primäre {% data variables.product.product_name %}-E-Mail-Adresse](/articles/changing-your-primary-email-address). + - Klicke auf **Git**, um Deine Git-E-Mail-Adresse anzuzeigen. Eventuell ist diese Adresse jedoch nicht Ihre [primäre {% data variables.product.product_name %}-E-Mail-Adresse](/articles/changing-your-primary-email-address). {% endmac %} @@ -28,7 +28,7 @@ versions: 1. Klicke im Menü **File** (Datei) auf **Options** (Optionen). 2. Überprüfe im Optionsfenster Folgendes: - Klicke auf **Accounts** (Konten), um Deinen {% data variables.product.product_name %}-Benutzernamen anzuzeigen. - - Klicke auf **Git**, um Deine Git-E-Mail-Adresse anzuzeigen. Eventuell ist diese Adresse jedoch nicht Deine [primäre {% data variables.product.product_name %}-E-Mail-Adresse](/articles/changing-your-primary-email-address). + - Klicke auf **Git**, um Deine Git-E-Mail-Adresse anzuzeigen. Eventuell ist diese Adresse jedoch nicht Ihre [primäre {% data variables.product.product_name %}-E-Mail-Adresse](/articles/changing-your-primary-email-address). {% endwindows %} @@ -60,7 +60,7 @@ origin https://{% data variables.command_line.codeblock %}/YOUR_USERNAME    YOUR_USERNAME/YOUR_REPOSITORY.git (push) ``` -Dein Benutzername folgt unmittelbar auf `https://{% data variables.command_line.backticks %}/`. +Ihr Benutzername folgt unmittelbar auf `https://{% data variables.command_line.backticks %}/`. {% if currentVersion == "free-pro-team@latest" %} ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-an-organization.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-an-organization.md index 1dbde6643735..031fea465d1b 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-an-organization.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-an-organization.md @@ -1,6 +1,6 @@ --- title: Dich selbst aus einer Organisation entfernen -intro: Als externer Mitarbeiter oder Mitglied einer Organisation kannst Du die Organisation jederzeit aus eigener Initiative verlassen. +intro: 'Als externer Mitarbeiter oder Mitglied einer Organisation kannst Du die Organisation jederzeit aus eigener Initiative verlassen.' redirect_from: - /articles/how-do-i-remove-myself-from-an-organization/ - /articles/removing-yourself-from-an-organization @@ -13,7 +13,7 @@ versions: {% warning %} -**Warnung:** Wenn Du derzeit innerhalb Deiner Organisation für die Zahlung der Nutzung von {% data variables.product.product_name %} verantwortlich bist, werden die für Deine Organisation hinterlegten Abrechnungsinformationen durch Deinen Austritt aus der Organisation **nicht** automatisch aktualisiert. Wenn Du Zahlungsverantwortlicher bist, **musst Du** den Organisationsinhaber oder einen anderen Abrechnungsmanager der Organisation bitten, die [Zahlungsmethode der Organisation zu aktualisieren](/articles/adding-or-editing-a-payment-method). +**Warnung:** Wenn Sie derzeit innerhalb Ihrer Organisation für die Zahlung der Nutzung von {% data variables.product.product_name %} verantwortlich sind, werden die für Ihre Organisation hinterlegten Abrechnungsinformationen durch Ihr Verlassen der Organisation **nicht** automatisch aktualisiert. Wenn Du Zahlungsverantwortlicher bist, **musst Du** den Organisationsinhaber oder einen anderen Abrechnungsmanager der Organisation bitten, die [Zahlungsmethode der Organisation zu aktualisieren](/articles/adding-or-editing-a-payment-method). Weitere Informationen findest Du unter „[Inhaberschaft an einer Organisation übertragen](/articles/transferring-organization-ownership).“ diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/requesting-organization-approval-for-oauth-apps.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/requesting-organization-approval-for-oauth-apps.md index 2d0b526b6917..321b94379ce1 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/requesting-organization-approval-for-oauth-apps.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/requesting-organization-approval-for-oauth-apps.md @@ -9,7 +9,7 @@ versions: free-pro-team: '*' --- -### Organisations-Genehmigung für eine {% data variables.product.prodname_oauth_app %} anfordern, die Du bereits für Dein persönliches Konto autorisiert hast +### Von einer Organisation die Genehmigung für eine {% data variables.product.prodname_oauth_app %} anfordern, die Sie bereits für Ihr persönliches Konto zugelassen haben {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.access_applications %} diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/setting-a-backup-email-address.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/setting-a-backup-email-address.md index cd8468060de1..e98f09f2a0f2 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/setting-a-backup-email-address.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/setting-a-backup-email-address.md @@ -1,6 +1,6 @@ --- title: Backup-E-Mail-Adresse festlegen -intro: 'Deine Backup-E-Mail-Adresse kannst Du zur sicheren Zurücksetzung Deines Passworts verwenden, wenn auf Deine primäre E-Mail-Adresse kein Zugriff mehr möglich ist.' +intro: Deine Backup-E-Mail-Adresse kannst Du zur sicheren Zurücksetzung Deines Passworts verwenden, wenn auf Deine primäre E-Mail-Adresse kein Zugriff mehr möglich ist. redirect_from: - /articles/setting-a-backup-email-address versions: diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address.md index 291ff5fc36ae..c240687bec26 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address.md @@ -17,11 +17,11 @@ versions: ### Informationen zu E-Mail-Adressen für Commits -{% data variables.product.product_name %} verwendet Deine Commit-E-Mail-Adresse zur Verknüpfung Deiner Commits mit Deinem {% data variables.product.product_name %}-Konto. Du kannst den Commits, die Du über die Befehlszeile überträgst, wie auch Deinen webbasierten Git-Operationen jeweils eine eigene E-Mail-Adresse zuordnen. +{% data variables.product.product_name %} verwendet Ihre E-Mail-Adresse für Commits zur Verknüpfung Ihrer Commits mit Ihrem {% data variables.product.product_name %}-Konto. Du kannst den Commits, die Du über die Befehlszeile überträgst, wie auch Deinen webbasierten Git-Operationen jeweils eine eigene E-Mail-Adresse zuordnen. Für webbasierte Git-Operationen legst Du die E-Mail-Adresse für Commits auf {% data variables.product.product_name %} fest. Für Commits, die Du per Push über die Befehlszeile überträgst, legst Du die E-Mail-Adresse für Commits in Git fest. -{% if currentVersion == "free-pro-team@latest" %}Alle Commits, die Du vor der Änderung Deiner Commit-E-Mail-Adresse durchgeführt hast, bleiben mit Deiner früheren E-Mail-Adresse verbunden.{% else %}Nach der Änderung Deiner Commit-E-Mail-Adresse auf {% data variables.product.product_name %} wird die neue E-Mail-Adresse standardmäßig allen zukünftigen webbasierten Git-Operationen zugeordnet. Alle Commits, die Du vor der Änderung Deiner Commit-E-Mail-Adresse durchgeführt hast, bleiben mit Deiner früheren E-Mail-Adresse verbunden.{% endif %} +{% if currentVersion == "free-pro-team@latest" %}Any commits you made prior to changing your commit email address are still associated with your previous email address.{% else %}After changing your commit email address on {% data variables.product.product_name %}, the new email address will be visible in all of your future web-based Git operations by default. Alle Commits, die Du vor der Änderung Deiner Commit-E-Mail-Adresse durchgeführt hast, bleiben mit Deiner früheren E-Mail-Adresse verbunden.{% endif %} {% if currentVersion == "free-pro-team@latest" %} @@ -33,21 +33,21 @@ Für webbasierte Git-Operationen legst Du die E-Mail-Adresse für Commits auf {% {% endif %} -{% if currentVersion == "free-pro-team@latest" %}Wenn Du Deine persönliche E-Mail-Adresse privat halten möchtest, kannst Du als Deine Commit-E-Mail-Adresse eine von {% data variables.product.product_name %} bereitgestellte `no-reply`-E-Mail-Adresse verwenden. Wenn Du eine `no-reply`-E-Mail-Adresse für Commits verwenden möchtest, die Du über die Befehlszeile überträgst, gib diese E-Mail-Adresse bei der Festlegung Deiner Commit-E-Mail-Adresse in Git an. Wenn Du eine `no-reply`-E-Mail-Adresse für webbasierte Git-Operationen verwenden möchtest, lege Deine Commit-E-Mail-Adresse auf GitHub fest, und wähle dabei **Keep my email address private** (E-Mail-Adresse privat halten) aus. +{% if currentVersion == "free-pro-team@latest" %}If you'd like to keep your personal email address private, you can use a {% data variables.product.product_name %}-provided `no-reply` email address as your commit email address. Wenn Du eine `no-reply`-E-Mail-Adresse für Commits verwenden möchtest, die Du über die Befehlszeile überträgst, gib diese E-Mail-Adresse bei der Festlegung Deiner Commit-E-Mail-Adresse in Git an. Wenn Du eine `no-reply`-E-Mail-Adresse für webbasierte Git-Operationen verwenden möchtest, lege Deine Commit-E-Mail-Adresse auf GitHub fest, und wähle dabei **Keep my email address private** (E-Mail-Adresse privat halten) aus. Du kannst auch festlegen, dass Commits, die Du über die Befehlszeile überträgst, blockiert werden, wenn diese Deine persönliche E-Mail-Adresse offenlegen. Weitere Informationen findest Du unter „[Pushes über die Befehlszeile blockieren, die Deine private E-Mail-Adresse offenlegen](/articles/blocking-command-line-pushes-that-expose-your-personal-email-address)“.{% endif %} -Um sicherzustellen, dass Dir Deine Commits zugeschrieben werden und in Deinem Beteiligungsdiagramm erscheinen, gib als Commit-E-Mail-Adresse eine E-Mail-Adresse an, die Du [Deinem GitHub-Konto hinzugefügt hast](/articles/adding-an-email-address-to-your-github-account/){% if currentVersion == "free-pro-team@latest" %}, oder verwende die von {% data variables.product.product_name %} in Deinen E-Mail-Einstellungen bereitgestellte `no-reply`-E-Mail-Adresse{% endif %}. +To ensure that commits are attributed to you and appear in your contributions graph, use an email address that you've [added to your GitHub account](/articles/adding-an-email-address-to-your-github-account/){% if currentVersion == "free-pro-team@latest" %}, or the {% data variables.product.product_name %}-provided `noreply` email address provided to you in your email settings{% endif %}. {% if currentVersion == "free-pro-team@latest" %} {% note %} -**Hinweis:** Wenn Du Dein {% data variables.product.product_name %}-Konto _nach_ dem 18. Juli 2017 erstellt hast, ist Deine von {% data variables.product.product_name %} bereitgestellte `no-reply`-E-Mail-Adresse eine siebenstellige ID-Nummer und Dein Benutzername hat folgende Form: ID+username@users.noreply.github.com. Wenn Du Dein {% data variables.product.product_name %}-Konto _vor_ dem 18. Juli 2017 erstellt hast, ist Deine von {% data variables.product.product_name %} bereitgestellte `no-reply`-E-Mail-Adresse Dein Benutzername in der Form username@users.noreply.github.com. Eine auf Deiner ID basierende `no-reply`-E-Mail-Adresse wird Dir von {% data variables.product.product_name %} bereitgestellt, wenn Du in den E-Mail-Einstellungen **Keep my email address private** (E-Mail-Adresse privat halten) aktivierst (respektive zunächst deaktivierst und dann erneut aktivierst). +**Hinweis:** Wenn Sie Ihr {% data variables.product.product_name %}-Konto _nach_ dem 18. Juli 2017 erstellt haben, ist Ihre von {% data variables.product.product_name %} bereitgestellte `no-reply`-E-Mail-Adresse eine siebenstellige ID-Nummer und Ihr Benutzername hat folgende Form: ID+username@users.noreply.github.com. Wenn Sie Ihr {% data variables.product.product_name %}-Konto _vor_ dem 18. Juli 2017 erstellt haben, ist Ihre von {% data variables.product.product_name %} bereitgestellte `no-reply`-E-Mail-Adresse Ihr Benutzername in der Form username@users.noreply.github.com. Eine auf Deiner ID basierende `no-reply`-E-Mail-Adresse wird Dir von {% data variables.product.product_name %} bereitgestellt, wenn Du in den E-Mail-Einstellungen **Keep my email address private** (E-Mail-Adresse privat halten) aktivierst (respektive zunächst deaktivierst und dann erneut aktivierst). {% endnote %} -Wenn Du Deine Commits unter der von {% data variables.product.product_name %} bereitgestellten `no-reply`-E-Mail-Adresse durchführst und später [Deinen Benutzernamen änderst](/articles/changing-your-github-username), können diese Commits nicht mehr Deinem {% data variables.product.product_name %}-Konto zugeordnet werden. Dies gilt jedoch nicht, wenn Du die von {% data variables.product.product_name %} bereitgestellte ID-basierte `no-reply`-Adresse verwendest. Weitere Informationen findest Du unter „[{% data variables.product.prodname_dotcom %}-Benutzernamen ändern](/articles/changing-your-github-username)“.{% endif %} +Wenn Sie Ihre Commits unter der von {% data variables.product.product_name %} bereitgestellten `no-reply`-E-Mail-Adresse durchführen und später [Ihren Benutzernamen ändern](/articles/changing-your-github-username), können diese Commits nicht mehr Ihrem {% data variables.product.product_name %}-Konto zugeordnet werden. Dies gilt jedoch nicht, wenn Sie die von {% data variables.product.product_name %} bereitgestellte ID-basierte `no-reply`-Adresse verwenden. Weitere Informationen findest Du unter „[{% data variables.product.prodname_dotcom %}-Benutzernamen ändern](/articles/changing-your-github-username)“.{% endif %} ### Deine Commit-E-Mail-Adresse auf {% data variables.product.prodname_dotcom %} festlegen @@ -61,7 +61,7 @@ Wenn Du Deine Commits unter der von {% data variables.product.product_name %} be ### Deine Commit-E-Mail-Adresse in Git festlegen -Mit dem Befehl `git config` kannst Du die Deinen Git-Commits zugeordnete E-Mail-Adresse ändern. Die neue E-Mail-Adresse wird bei allen zukünftigen Commits angezeigt, die Du über die Befehlszeile per Push an {% data variables.product.product_name %} überträgst. Alle Commits, die Du vor der Änderung Deiner Commit-E-Mail-Adresse durchgeführt hast, bleiben mit Deiner früheren E-Mail-Adresse verbunden. +Mit dem Befehl `git config` können Sie die Ihren Git-Commits zugeordnete E-Mail-Adresse ändern. Die neue E-Mail-Adresse wird bei allen zukünftigen Commits angezeigt, die Sie über die Befehlszeile per Push an {% data variables.product.product_name %} übertragen. Alle Commits, die Sie vor der Änderung Ihrer E-Mail-Adresse für Commits durchgeführt haben, bleiben mit Ihrer früheren E-Mail-Adresse verbunden. #### E-Mail-Adresse für alle Repositorys auf Deinem Computer festlegen @@ -79,9 +79,9 @@ Mit dem Befehl `git config` kannst Du die Deinen Git-Commits zugeordnete E-Mail- #### E-Mail-Adresse für ein einzelnes Repository festlegen -{% data variables.product.product_name %} verwendet die in Deiner lokalen Git-Konfiguration festgelegte E-Mail-Adresse zur Zuordnung von über die Befehlszeile übertragenen Commits zu Deinem {% data variables.product.product_name %}-Konto. +{% data variables.product.product_name %} verwendet die in Ihrer lokalen Git-Konfiguration festgelegte E-Mail-Adresse zur Zuordnung Ihrer über die Befehlszeile übertragenen Commits zu Ihrem {% data variables.product.product_name %}-Konto. -Du kannst die E-Mail-Adresse für Deine Commits in einem bestimmten Repository ändern. Dadurch werden Deine globalen Git-Konfigurationseinstellungen ausschließlich für dieses eine Repository überschrieben, die anderen Repositorys sind von dieser Änderung nicht betroffen. +Sie können die E-Mail-Adresse für Ihre Commits an einem bestimmten Repository ändern. Dadurch werden Ihre globalen Git-Konfigurationseinstellungen ausschließlich für dieses eine Repository überschrieben, d. h., die anderen Repositorys sind von dieser Änderung nicht betroffen. {% data reusables.command_line.open_the_multi_os_terminal %} 2. Ändere das aktuelle Arbeitsverzeichnis in das lokale Repository, für das Du die E-Mail-Adresse für Deine Git-Commits festlegen möchten. diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/types-of-emails-github-sends.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/types-of-emails-github-sends.md index 228da801c800..cdfee960237e 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/types-of-emails-github-sends.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/types-of-emails-github-sends.md @@ -1,6 +1,6 @@ --- title: Arten der von GitHub versendeten E-Mails -intro: 'Du kannst von {% data variables.product.product_name %} verschiedene Arten von E-Mails erhalten, unter anderem Benachrichtigungen, Kontoinformationen und Marketingkommunikation.' +intro: 'Sie können von {% data variables.product.product_name %} verschiedene Arten von E-Mails erhalten, unter anderem Benachrichtigungen, Kontoinformationen und Marketingkommunikation.' redirect_from: - /articles/types-of-emails-github-sends versions: diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/what-does-the-available-for-hire-checkbox-do.md b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/what-does-the-available-for-hire-checkbox-do.md index 8ff9d466db58..daa9ad72ac17 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/what-does-the-available-for-hire-checkbox-do.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-github-user-account/what-does-the-available-for-hire-checkbox-do.md @@ -1,6 +1,6 @@ --- title: Funktionsweise des Kontrollkästchens „Available for hire“ (Zur Anstellung verfügbar) -intro: 'Verwende das Kontrollkästchen **Available for hire** (Zur Anstellung verfügbar), um GitHub Jobs-Beiträge in GitHub anzuzeigen.' +intro: Verwende das Kontrollkästchen **Available for hire** (Zur Anstellung verfügbar), um GitHub Jobs-Beiträge in GitHub anzuzeigen. redirect_from: - /articles/what-does-the-available-for-hire-checkbox-do versions: diff --git a/translations/de-DE/content/github/site-policy/amendment-to-github-terms-of-service-applicable-to-us-federal-government-users.md b/translations/de-DE/content/github/site-policy/amendment-to-github-terms-of-service-applicable-to-us-federal-government-users.md index 14050bbed1e9..4280270fb688 100644 --- a/translations/de-DE/content/github/site-policy/amendment-to-github-terms-of-service-applicable-to-us-federal-government-users.md +++ b/translations/de-DE/content/github/site-policy/amendment-to-github-terms-of-service-applicable-to-us-federal-government-users.md @@ -1,5 +1,5 @@ --- -title: 'Nachtrag zu den GitHub-Nutzungsbedingungen, die für Benutzer der US-Bundesregierung gelten Federal Government Users' +title: Nachtrag zu den GitHub-Nutzungsbedingungen, die für Benutzer der US-Bundesregierung gelten Federal Government Users redirect_from: - /articles/amendment-to-github-terms-of-service-applicable-to-government-users/ - /articles/proposed-amendment-to-github-terms-of-service-applicable-to-u-s-federal-government-users/ diff --git a/translations/de-DE/content/github/site-policy/github-additional-product-terms.md b/translations/de-DE/content/github/site-policy/github-additional-product-terms.md index cab5054ecf65..2291b0e5d914 100644 --- a/translations/de-DE/content/github/site-policy/github-additional-product-terms.md +++ b/translations/de-DE/content/github/site-policy/github-additional-product-terms.md @@ -42,11 +42,11 @@ GitHub Pages unterliegen Bandbreiten- und Nutzungsbeschränkungen und sind für ### 5. Actions und Pakete #### a. Verwendung von Actions -GitHub Actions ermöglicht es Ihnen, benutzerdefinierte Softwareentwicklungs-Lebenszyklus-Workflows direkt in Ihrem GitHub Repository zu erstellen. Jedes Konto umfasst die mitgelieferten Berechnungs- und Speichermengen für die Verwendung mit Actions, je nach Ihrem Kontenplan, entsprechend der [Actions-Dokumentation](/github/automating-your-workflow-with-github-actions/about-github-actions#about-github-actions). Ihre Nutzungsberechnung für Actions wird unter [your Account settings (Ihre Kontoeinstellungen)](https://github.com/settings/billing) angezeigt, und Sie werden per E-Mail benachrichtigt, bevor Sie das Limit Ihrer inbegriffenen Menge erreichen. Wenn Sie Actions über die in Ihrem Paket enthaltenen Datenmengen hinaus verwenden möchten, können Sie [enable overages (Überschreitungen aktivieren)](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions) aktivieren. +GitHub Actions ermöglicht es Ihnen, benutzerdefinierte Softwareentwicklungs-Lebenszyklus-Workflows direkt in Ihrem GitHub Repository zu erstellen. Each Account comes with included compute and storage quantities for use with Actions, depending on your Account plan, which can be found in the [Actions documentation](/actions). Ihre Nutzungsberechnung für Actions wird unter [your Account settings (Ihre Kontoeinstellungen)](https://github.com/settings/billing) angezeigt, und Sie werden per E-Mail benachrichtigt, bevor Sie das Limit Ihrer inbegriffenen Menge erreichen. Wenn Sie Actions über die in Ihrem Paket enthaltenen Datenmengen hinaus verwenden möchten, können Sie [enable overages (Überschreitungen aktivieren)](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions) aktivieren. -Die Nutzungsberechnung für enthaltene und bezahlte Mengen wird in Minuten anhand der Art von Aktionen berechnet, die Sie ausführen (z.B. Linux, Windows, macOS). Die Minuten, die für den Auftrag oder die Aufgabe jeder Aktion verwendet werden, werden auf die nächste Minute aufgerundet. Bei inbegriffenen Mengen und abhängig von der Art der Aktion kann ein Multiplikator auf die Zeit angewandt werden, die für die Ausführung jedes Auftrags oder jeder Aufgabe benötigt wird, bevor auf die nächste Minute aufgerundet wird. Zusätzliche Minuten werden zum [angegebenen Preis pro Minute ](https://github.com/features/actions) basierend auf der Art der von Ihnen ausgeführten Aktionen berechnet. Actions und Packages teilen sich Speicher, und Ihre Speichernutzung wird in Ihren [Kontoeinstellungen](https://github.com/settings/billing) angezeigt. Weitere Informationen zur Nutzungsberechnung der mitgelieferten Speichermengen finden Sie in der [Actions-Dokumentation](/github/automating-your-workflow-with-github-actions/about-github-actions#about-github-actions). +Die Nutzungsberechnung für enthaltene und bezahlte Mengen wird in Minuten anhand der Art von Aktionen berechnet, die Sie ausführen (z.B. Linux, Windows, macOS). Die Minuten, die für den Auftrag oder die Aufgabe jeder Aktion verwendet werden, werden auf die nächste Minute aufgerundet. Bei inbegriffenen Mengen und abhängig von der Art der Aktion kann ein Multiplikator auf die Zeit angewandt werden, die für die Ausführung jedes Auftrags oder jeder Aufgabe benötigt wird, bevor auf die nächste Minute aufgerundet wird. Zusätzliche Minuten werden zum [angegebenen Preis pro Minute ](https://github.com/features/actions) basierend auf der Art der von Ihnen ausgeführten Aktionen berechnet. Actions und Packages teilen sich Speicher, und Ihre Speichernutzung wird in Ihren [Kontoeinstellungen](https://github.com/settings/billing) angezeigt. For additional details about included quantity usage calculations, see the [Actions documentation](/actions). -Actions und jegliche Elemente des Action-Dienstes dürfen nicht unter Missachtung der Vereinbarung, der [Richtlinie für die zulässige Verwendung](/github/site-policy/github-acceptable-use-policies), oder der GitHub-Actions [Diensteinschränkungen](/github/automating-your-workflow-with-github-actions/about-github-actions#usage-limits) verwendet werden. Actions sollte außerdem nicht für Folgendes verwendet werden: +Actions und jegliche Elemente des Action-Dienstes dürfen nicht unter Missachtung der Vereinbarung, der [Richtlinie für die zulässige Verwendung](/github/site-policy/github-acceptable-use-policies), oder der GitHub-Actions [Diensteinschränkungen](/actions/reference/usage-limits-billing-and-administration/#usage-limits) verwendet werden. Actions sollte außerdem nicht für Folgendes verwendet werden: - cryptomining; - die Nutzung unserer Server, um Dienste, Geräte, Daten, Konten oder Netzwerke zu stören oder zu versuchen, diese zu stören, oder um unbefugten Zugang zu erlangen oder dies zu versuchen (es sei denn, dies wurde im Rahmen des [GitHub Bug Bounty-Programms](https://bounty.github.com) genehmigt) - the provision of a stand-alone or integrated application or service offering Actions or any elements of Actions for commercial purposes; diff --git a/translations/de-DE/content/github/site-policy/github-bug-bounty-program-legal-safe-harbor.md b/translations/de-DE/content/github/site-policy/github-bug-bounty-program-legal-safe-harbor.md index 7defaa67151a..a1db9e3f24b3 100644 --- a/translations/de-DE/content/github/site-policy/github-bug-bounty-program-legal-safe-harbor.md +++ b/translations/de-DE/content/github/site-policy/github-bug-bounty-program-legal-safe-harbor.md @@ -1,5 +1,5 @@ --- -title: 'Legales, Safe Harbor-konformes GitHub-Bug-Bonusprogramm' +title: Legales, Safe Harbor-konformes GitHub-Bug-Bonusprogramm redirect_from: - /articles/github-bug-bounty-program-legal-safe-harbor versions: diff --git a/translations/de-DE/content/github/site-policy/github-enterprise-service-level-agreement.md b/translations/de-DE/content/github/site-policy/github-enterprise-service-level-agreement.md index 60ef85da5648..6aa8d2758a85 100644 --- a/translations/de-DE/content/github/site-policy/github-enterprise-service-level-agreement.md +++ b/translations/de-DE/content/github/site-policy/github-enterprise-service-level-agreement.md @@ -8,8 +8,6 @@ versions: free-pro-team: '*' --- -# GitHub Enterprise Service Level Agreement - **Short version:** GitHub guarantees a 99.9% quarterly uptime commitment for the GitHub Enterprise Cloud service (the “**Service Level**” or “**SLA**”). If GitHub does not meet the SLA, then Customer will be entitled to a service credit to Customer’s account (“**Service Credits**”). For definitions of each Service feature (“**Service Feature**”) and to review historical and current Uptime, visit the [GitHub Status Page](https://www.githubstatus.com/). Capitalized terms used but not defined in this SLA have the meaning assigned in Customer’s applicable agreement. diff --git a/translations/de-DE/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md b/translations/de-DE/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md index 763829582224..c079aa0894c1 100644 --- a/translations/de-DE/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md +++ b/translations/de-DE/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md @@ -1,6 +1,6 @@ --- -title: GitHub Insights und Datenschutz für Ihre Organisation -intro: '{% data variables.product.prodname_insights %} analysiert Ihre {% data variables.product.prodname_ghe_server %}-Daten. Diese Daten können personenbezogene Daten von Personen in Ihrer Organisation umfassen, die möglicherweise das Recht haben zu verstehen, wie diese personenbezogenen Daten verwendet werden.' +title: GitHub Insights and data protection for your organization +intro: '{% data variables.product.prodname_insights %} analyzes your {% data variables.product.prodname_ghe_server %} data. This data could include personal data of individuals in your organization who may have the right to understand how such personal data is being used.' product: '{% data reusables.gated-features.github-insights %}' redirect_from: - /github/installing-and-configuring-github-insights/github-insights-and-data-protection-for-your-organization @@ -9,38 +9,38 @@ versions: enterprise-server: '*' --- -Weitere Informationen zu den Bedingungen für {% data variables.product.prodname_insights %} finden Sie in Ihrer {% data variables.product.prodname_ghe_one %} Abonnementvereinbarung. +For more information about the terms that govern {% data variables.product.prodname_insights %}, see your {% data variables.product.prodname_ghe_one %} subscription agreement. -Zur Klarstellung: Keine der vorstehenden Informationen sollte als Rechtsberatung durch {% data variables.product.prodname_dotcom %} angesehen werden. Sie sind für die Sicherstellung Ihrer eigenen rechtlichen Analyse der hier bereitgestellten Informationen sowie für die Einhaltung der Datenschutzgesetze verantwortlich. Es liegt in Ihrem alleinigen Ermessen, ob Sie {% data variables.product.prodname_insights %} zur Verarbeitung der Daten Ihrer Mitarbeiter bzw. Benutzer verwenden, und wenn Sie dies tun, sind Sie allein dafür verantwortlich, diese Verarbeitung in Übereinstimmung mit dem geltenden Recht durchzuführen. +For the avoidance of doubt, none of the foregoing information should be considered legal advice provided by {% data variables.product.prodname_dotcom %}. You are responsible for securing your own legal analysis of the information provided herein and for your compliance with privacy and data protection laws. It is up to you whether to use {% data variables.product.prodname_insights %} to process your employees’ and users’ data, and if you do so, you are solely responsible for conducting such processing in compliance with applicable law. -### Die Rollen und Verantwortlichkeiten der Organisation +### The organization’s roles and responsibilities -Bei der Verwendung {% data variables.product.prodname_insights %} ist Ihre Organisation der Datenverantwortliche, da Ihre Organisation bestimmt, ob, wie und warum {% data variables.product.prodname_insights %} personenbezogene Daten einer Person verarbeitet. Ihre Organisation ist allein dafür verantwortlich, dass Sie alle anwendbaren Gesetze bei der Datenverarbeitung mit {% data variables.product.prodname_insights %} einhalten. +When using {% data variables.product.prodname_insights %}, your organization is the data controller because your organization determines whether, how, and why {% data variables.product.prodname_insights %} will process any individual’s personal data. Your organization is solely responsible for ensuring that you are complying with all applicable laws in processing data with {% data variables.product.prodname_insights %}. -### Datenschutzempfehlungen +### Data privacy recommendations -Sie haben die volle Kontrolle darüber vor Beginn der Verwendung von {% data variables.product.prodname_insights %} zu bestimmen, welche Metriken, Berichte, Repositorys und Mitwirkenden enthalten sein sollen. Die Daten, die Sie mit {% data variables.product.prodname_insights %} verarbeiten, können nur von Ihrer Installation von {% data variables.product.prodname_ghe_server %} abgerufen werden. Berücksichtigen Sie die Ausgewogenheit zwischen den Risiken und den Vorteilen der Analyse personenbezogener Daten. +You have full control over which metrics, reports, repositories, and contributors to include before beginning use of {% data variables.product.prodname_insights %}. The data you process with {% data variables.product.prodname_insights %} can only be pulled from your installation of {% data variables.product.prodname_ghe_server %}. Consider balancing the risks versus the benefits of analyzing personal data. -- **Entwickeln Sie einen klaren Analyseplan**: Sie müssen genau verstehen, was Sie analysieren möchten und warum und überlegen Sie dann, wie {% data variables.product.prodname_insights %} Ihnen helfen kann, diese Antworten zu finden. +- **Develop a clear analysis plan**: You must understand clearly what you want to analyze and why, and then consider how {% data variables.product.prodname_insights %} may help you find those answers. -- **Erwägen Sie eine Folgenabschätzung zum Datenschutz**: Wenn Ihre vorgeschlagene Verwendung von {% data variables.product.prodname_insights %} die Verarbeitung personenbezogener Daten beinhaltet, erwägen Sie, eine Bewertung der Auswirkungen auf den Datenschutz oder eine formelle rechtliche Analyse Ihrer geplanten Nutzung durchzuführen. +- **Consider a data protection impact assessment**: If your proposed use of {% data variables.product.prodname_insights %} involves processing personal data, consider completing a data protection impact assessment or otherwise completing formal legal analysis of your planned use. -### Bestimmen Sie, welche Daten verwendet werden sollen +### Decide what data to use -- **Bestimmen Sie, welche Repositorys enthalten werden sollen**: Bevor Sie mit einer Analyse in {% data variables.product.prodname_insights %} beginnen, überlegen Sie, welche Repositorys enthalten sein sollen. Administratoren können Beim Hinzufügen von Organisationen Repositorys einschließen und Repositorys jederzeit aktivieren und deaktivieren. Weitere Informationen zum Hinzufügen von Organisationen zu {% data variables.product.prodname_insights %} finden Sie unter "[Organisationen verwalten](/insights/installing-and-configuring-github-insights/managing-organizations). Weitere Informationen zum Aktivieren und Deaktivieren von Repositorys finden Sie unter "[Repositorys verwalten](/insights/installing-and-configuring-github-insights/managing-repositories)." +- **Decide which repositories to include**: Before you start an analysis in {% data variables.product.prodname_insights %}, consider which repositories to include. Administrators can include repositories when adding organizations and can enable and disable repositories at any time. For more information on adding organizations to {% data variables.product.prodname_insights %}, see "[Managing organizations](/insights/installing-and-configuring-github-insights/managing-organizations)." For more information on enabling and disabling repositories, see "[Managing repositories](/insights/installing-and-configuring-github-insights/managing-repositories)." -- **Legen Sie fest, welche Metriken und Berichte eingeschlossen werden sollen**: Administratoren können Metriken und Berichte, die für alle Benutzer verfügbar sind, jederzeit aktivieren und deaktivieren. Administratoren bestimmen die {% data variables.product.prodname_insights %}-Daten, auf die Benutzer in Ihrer Installation von {% data variables.product.prodname_ghe_server %} Zugriff haben. Weitere Informationen finden Sie unter „[Verwalten verfügbarer Metriken und Berichte](/insights/installing-and-configuring-github-insights/managing-available-metrics-and-reports)." +- **Decide which metrics and reports to include**: Administrators can enable and disable metrics and reports available for all users at any time. Administrators control the {% data variables.product.prodname_insights %} data that users have access to in your installation of {% data variables.product.prodname_ghe_server %}. For more information, see "[Managing available metrics and reports](/insights/installing-and-configuring-github-insights/managing-available-metrics-and-reports)." -- **Legen Sie fest, welche Mitwirkenden ** aufgenommen werden sollen: Administratoren können die Verarbeitung der Daten eines bestimmten Mitwirkenden in den Metriken und Berichten deaktivieren. Weitere Informationen zur Datenverwaltung von Mitwirkenden finden Sie unter "[Verwalten von Mitwirkenden und Teams](/insights/installing-and-configuring-github-insights/managing-contributors-and-teams)." +- **Decide which contributors to include**: Administrators can disable a specific contributor’s data from being processed in the metrics and reports. For more information on managing contributor data, see "[Managing contributors and teams](/insights/installing-and-configuring-github-insights/managing-contributors-and-teams)." -### Benutzerrechte +### User rights -Nach verschiedenen Datenschutzbestimmungen, wie der Datenschutz-Grundverordnung (DSGVO), haben Benutzer möglicherweise das Recht, den Ausschluss von der Verarbeitung, dem Zugriff und der Berichtigung ihrer personenbezogenen Daten oder deren Löschung zu verlangen. Als Datenverantwortlicher sollte Ihre Organisation bewerten, ob eine bestimmte Benutzeranfrage gerechtfertigt ist, und gegebenenfalls Maßnahmen ergreifen, um die Anfrage zu erfüllen. +Under various data protection regulations, such as the General Data Protection Regulation (GDPR), users may have the right to request exclusion from processing, access, and correction, or to request deletion of their personal data. As the data controller, your organization should evaluate whether a particular user request is valid and, if appropriate, take action to fulfill the request. -- **Ausschluss der Datenverarbeitung**: Benutzer haben möglicherweise das Recht, dass ihre personenbezogenen Daten von der Verarbeitung ausgeschlossen werden. Administratoren haben die Möglichkeit, die Daten eines Mitwirkenden von der Verarbeitung in {% data variables.product.prodname_insights %} zu entfernen, sodass die resultierenden Berichte und Metriken die Daten des Mitwirkenden entsprechend ausschließen. Weitere Informationen finden Sie unter „[Verwalten von Mitwirkenden und Teams](/insights/installing-and-configuring-github-insights/managing-contributors-and-teams)“. +- **Exclusion of processing**: Users may have the right to have their personal data excluded from being processed. Administrators have the ability to remove a contributor’s data from being processed in {% data variables.product.prodname_insights %}, and the resulting reports and metrics will exclude the contributor’s data accordingly. For more information, see "[Managing contributors and teams](/insights/installing-and-configuring-github-insights/managing-contributors-and-teams)." -- **Zugang**: Benutzer haben möglicherweise das Recht, Einsicht in die personenbezogenen Daten zu verlangen, die aktuell verarbeitet werden. Jede Metrik und jeder Bericht enthält eine detaillierte Beschreibung der Verarbeitung personenbezogener Daten. Weitere Informationen finden Sie unter „[Verfügbare Metriken mit {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights)“. Rohdaten sind über das {% data variables.product.prodname_enterprise %} API verfügbar. Ihre Organisation ist für alle Entscheidungen zur Verarbeitung personenbezogener Daten und für die Erfüllung solcher Anfragen verantwortlich. +- **Access**: Users may have the right to demand to see what personal data is being processed. Each metric and report has a detailed description of what personal data is being processed. For more information, see "[Metrics available with {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights)." Raw data is available through the {% data variables.product.prodname_enterprise %} API. Your organization is responsible for any decisions to process personal data and for fulfilling any such requests. -- **Korrektur und Löschung**: Benutzer haben ggf. das Recht, ihre personenbezogenen Daten zu berichtigen oder zu löschen. Die in {% data variables.product.prodname_insights %} verwendeten Daten werden von den vorhandenen Daten abgeleitet, die Sie in Ihrer {% data variables.product.prodname_ghe_server %} Installation hinzufügen oder generieren. Die Korrektur und Löschung sollten dem bestehenden Prozess Ihrer Organisation zum Korrigieren und Löschen von Daten in {% data variables.product.prodname_ghe_server %}. +- **Correction and deletion**: Users may have the right to rectify or delete their personal data. The data used in {% data variables.product.prodname_insights %} is derived from the existing data you add to or generate from your {% data variables.product.prodname_ghe_server %} installation. Correction and deletion should follow your organization's existing process to correct and delete data from {% data variables.product.prodname_ghe_server %}. -- **Transparenz in Bezug auf die Verarbeitung**: Jede Metrik und jeder Bericht enthält eine detaillierte Beschreibung, welche persönlichen Daten verarbeitet werden. Weitere Informationen finden Sie unter „[Verfügbare Metriken mit {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights)“. +- **Transparency regarding processing**: Each metric and report has a detailed description of what personal data is being processed. For more information, see "[Metrics available with {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights)." diff --git a/translations/de-DE/content/github/site-policy/github-privacy-statement.md b/translations/de-DE/content/github/site-policy/github-privacy-statement.md index 795fdae636c3..1cc71f6e1b0b 100644 --- a/translations/de-DE/content/github/site-policy/github-privacy-statement.md +++ b/translations/de-DE/content/github/site-policy/github-privacy-statement.md @@ -227,7 +227,7 @@ Auf unserer Webseite [Cookies und Tracking](/github/site-policy/github-subproces Wir verwenden eine Reihe von externen Analyse- und Dienstanbietern, um uns bei der Bewertung der Verwendung von GitHub durch unsere Benutzer zu unterstützen, statistische Berichte über Aktivitäten zusammenzustellen und unsere Inhalte und die Website-Leistung zu verbessern. Wir verwenden diese externen Analyseanbieter nur in bestimmten Bereichen unserer Website und alle von ihnen haben mit uns Datenschutzvereinbarungen unterzeichnet, die die Art der personenbezogenen Daten, die sie sammeln können, und den Zweck, für den sie die Informationen verarbeiten können, einschränken. Darüber hinaus verwenden wir unsere eigene interne Analysesoftware zur Bereitstellung von Funktionen und zur Verbesserung unserer Inhalte und Leistungen. -Einige Browser verfügen über integrierte "Do Not Track"-Funktionen (DNT), die ein Signal an die von Ihnen besuchten Websites senden können, um zu signalisieren, dass Sie nicht getracked werden möchten. GitHub reagiert auf Browser-DNT-Signale und folgt dem [W3C-Standard für das Reagieren auf DNT-Signale](https://www.w3.org/TR/tracking-dnt/). Wenn Sie DNT auf einem Browser, der DNT unterstützt, nicht aktiviert haben, können Cookies an bestimmten Stellen unserer Website Ihre Online-Surfaktivitäten auf anderen Online-Diensten nachverfolgen, aber wir gestatten es keinen Dritten, außer unseren Analyse- und Dienstanbietern, die Aktivitäten von GitHub-Benutzern auf GitHub zu verfolgen. +Einige Browser verfügen über integrierte "Do Not Track"-Funktionen (DNT), die ein Signal an die von Ihnen besuchten Websites senden können, um zu signalisieren, dass Sie nicht getracked werden möchten. GitHub reagiert auf Browser-DNT-Signale und folgt dem [W3C-Standard für das Reagieren auf DNT-Signale](https://www.w3.org/TR/tracking-dnt/). Wenn Sie DNT auf einem Browser, der DNT unterstützt, nicht aktiviert haben, können Cookies an bestimmten Stellen unserer Website Ihre Online-Surfaktivitäten auf anderen Online-Diensten nachverfolgen, aber wir gestatten es keinen Dritten, außer unseren Analyse- und Dienstanbietern, die Aktivitäten von GitHub-Benutzern auf GitHub zu verfolgen. You can read more about DNT in our [Tracking on GitHub](/github/site-policy/github-subprocessors-and-cookies#tracking-on-github) section of our [GitHub Subprocessors and Cookies](/github/site-policy/github-subprocessors-and-cookies) page. ### Wie GitHub Ihre Daten schützt diff --git a/translations/de-DE/content/github/site-policy/github-subprocessors-and-cookies.md b/translations/de-DE/content/github/site-policy/github-subprocessors-and-cookies.md index 8fea81a47e41..d06bb4878b0e 100644 --- a/translations/de-DE/content/github/site-policy/github-subprocessors-and-cookies.md +++ b/translations/de-DE/content/github/site-policy/github-subprocessors-and-cookies.md @@ -10,7 +10,7 @@ versions: free-pro-team: '*' --- -Datum des Inkrafttretens: **12. August 2020** +Effective date: **October 2, 2020** GitHub bietet viel Transparenz darüber, wie wir Ihre Daten verwenden, wie wir Ihre Daten sammeln und mit wem wir Ihre Daten teilen. Zu diesem Zweck stellen wir Ihnen diese Seite zur Verfügung, mit Details zu [unseren Unterauftragsverarbeitern](#github-subprocessors), darüber, wie wir [Cookies](#cookies-on-github) verwenden, und wo und wie wir auf Git Hub [Tracking](#tracking-on-github) durchführen. @@ -19,7 +19,7 @@ GitHub bietet viel Transparenz darüber, wie wir Ihre Daten verwenden, wie wir I Wenn wir Ihre Daten an Unterauftragsverarbeiter, wie z. B. unsere Anbieter und Dienstleister, weitergeben, bleiben wir für diese verantwortlich. Wir legen großen Wert darauf, Ihr Vertrauen zu erhalten, wenn wir neue Anbieter hinzuziehen, und wir verlangen von allen Anbietern, dass sie mit uns Datenschutzvereinbarungen abschließen, die deren Verarbeitung von personenbezogenen Benutzerdaten (wie in der [Datenschutzerklärung](/articles/github-privacy-statement/) definiert) einschränken. | Name des Unterauftragsverarbeiters | Beschreibung der Verarbeitung | Ort der Verarbeitung | Corporate Location | -| ---------------------------------- | ----------------------------------------------------- | ------------------------------ | ------------------------------ | +|:---------------------------------- |:----------------------------------------------------- |:------------------------------ |:------------------------------ | | Automattic | Hosting-Dienst | Vereinigte Staaten von Amerika | Vereinigte Staaten von Amerika | | AWS Amazon | Daten-Hosting | Vereinigte Staaten von Amerika | Vereinigte Staaten von Amerika | | Braintree (PayPal) | Kreditkarten-Zahlungsabwicklung | Vereinigte Staaten von Amerika | Vereinigte Staaten von Amerika | @@ -28,7 +28,7 @@ Wenn wir Ihre Daten an Unterauftragsverarbeiter, wie z. B. unsere Anbieter und D | DiscoverOrg | Marketing-Datenanreicherungsservice | Vereinigte Staaten von Amerika | Vereinigte Staaten von Amerika | | Eloqua | Automatisierung von Marketingkampagnen | Vereinigte Staaten von Amerika | Vereinigte Staaten von Amerika | | Google Apps | Interne Unternehmensinfrastruktur | Vereinigte Staaten von Amerika | Vereinigte Staaten von Amerika | -| Google Analytics | Website-Analyse und -Performance | Vereinigte Staaten von Amerika | Vereinigte Staaten von Amerika | +| Google Analytics | Analytics and performance | Vereinigte Staaten von Amerika | Vereinigte Staaten von Amerika | | LinkedIn Navigator | Marketing-Datenanreicherungsservice | Vereinigte Staaten von Amerika | Vereinigte Staaten von Amerika | | Magic Robot | Kampagnenberichte (Salesforce Add-on) | Vereinigte Staaten von Amerika | Vereinigte Staaten von Amerika | | MailChimp | Kunden-Ticketing-E-Mail Dienstanbieter | Vereinigte Staaten von Amerika | Vereinigte Staaten von Amerika | @@ -49,63 +49,49 @@ Wenn wir einen neuen Unterauftragsverarbeiter einsetzen, der die personenbezogen ### Cookies auf GitHub -GitHub verwendet Cookies, um die Interaktion mit unserem Dienst einfach und sinnvoll zu machen. Wir verwenden Cookies (und ähnliche Technologien wie HTML5 localStorage), um Sie eingeloggt zu halten, uns Ihre Präferenzen zu merken, Informationen für die zukünftige Entwicklung von GitHub bereitzustellen und um Ihnen die Produkte und Dienste von GitHub auf Websites Dritter vorzustellen. - -Ein Cookie ist ein kleiner Text, der von unseren Webservern auf Ihrem Endgerät gespeichert wird. Er wird beim erneuten Aufruf der Webseite wieder an unsere Server zurückgesendet. Cookies müssen Sie nicht unbedingt auf GitHub identifizieren, da sie eine ID für jeden angemeldeten Benutzer speichern können. Wir verwenden Cookies, um Sie eingeloggt zu halten, Ihre Präferenzen zu speichern und Informationen für die zukünftige Entwicklung von GitHub bereitzustellen. Wir verwenden Cookies aus Sicherheitsgründen, um ein Gerät zu identifizieren. Durch die Nutzung unserer Website erklären Sie sich damit einverstanden, dass wir diese Arten von Cookies auf Ihrem Computer oder Gerät speichern. Wenn Sie die Speicherung von Cookies auf Ihrem Browser oder Gerät deaktivieren, können Sie sich weder anmelden noch die Dienste von GitHub nutzen. In bestimmten Bereichen der Website können wir Cookies auch verwenden, um Sie bzw. Ihr Gerät zu identifizieren, um Ihnen Werbung von GitHub-Produkten und -Diensten auf Websites Dritter anzuzeigen. - -GitHub setzt folgende Cookies für unsere Benutzer, aus folgenden Gründen: - -| Name des Cookies | Grund | -| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `user_session` | Dieses Cookie wird verwendet, um Sie anzumelden. | -| `logged_in` | Dieses Cookie wird verwendet, um uns zu signalisieren, dass der Benutzer bereits angemeldet ist. | -| `dotcom_user` | Dieses Cookie wird verwendet, um uns zu signalisieren, dass der Benutzer bereits angemeldet ist. | -| `_gh_sess` | Dieses Cookie wird für temporäre Anwendungen und Framework-Status zwischen Seiten verwendet, z. B. in welchem Schritt sich der Benutzer in einem mehrstufigen Formular befindet. | -| `tz` | Mit diesem Cookie kann Ihr Browser uns mitteilen, in welcher Zeitzone Sie sich befinden. | -| `gist_user_session` | Dieses Cookie wird von Gist verwendet, wenn es auf einem separaten Host ausgeführt wird. | -| `saml_csrf_token` | Dieses Cookie wird von der SAML auth path-Methode gesetzt, um dem Client ein Token zuzuordnen. | -| `saml_return_to` | Dieses Cookie wird von der SAML auth path-Methode gesetzt, um den Status während der SAML-Authentifizierungsschleife beizubehalten. | -| `gist_oauth_csrf` | Dieses Cookie wird von Gist gesetzt, um sicherzustellen, dass der Benutzer, der den auth-Flow gestartet hat, derselbe Benutzer ist, der ihn abschließt. | -| `__Host-user_session_same_site` | Dieses Cookie wird so gesetzt, dass Browser, die SameSite-Cookies unterstützen, überprüfen können, ob eine Anfrage von GitHub stammt. | -| `__Host-gist_user_session_same_site` | Dieses Cookie wird so gesetzt, dass Browser, die SameSite-Cookies unterstützen, überprüfen können, ob eine Anfrage von GitHub stammt. | -| `_ga` | Dieses Cookie wird von Google Analytics verwendet. | -| `_gat` | Dieses Cookie wird von Google Analytics verwendet. | -| `_gid` | Dieses Cookie wird von Google Analytics verwendet. | -| `_octo` | Dieses Cookie wird von Octolytics, unserem internen Analysedienst, verwendet, um eindeutige Benutzer und Kunden zu unterscheiden. | -| `tracker` | Dieses Cookie verfolgt die Referenzquelle für die Anmeldeanalyse. | - -Bestimmte Seiten auf unserer Website können andere Cookies von Drittanbietern setzen. Beispielsweise können wir Inhalte, z. B. Videos, von einer anderen Website, die ein Cookie setzt, einbetten. Während wir versuchen, diese Cookies von Drittanbietern zu minimieren, können wir nicht immer kontrollieren, welche Cookies diese Inhalte von Drittanbietern setzen. +GitHub uses cookies and similar technologies (collectively, “cookies”) to provide and secure our websites, as well as to analyze the usage of our websites, in order to offer you a great user experience. Please take a look at our [Privacy Statement](/github/site-policy/github-privacy-statement#our-use-of-cookies-and-tracking) if you’d like more information about cookies, and on how and why we use them. + +Since the number and names of cookies may change,the table below may be updated from time to time. + +| Service Provider | Cookie Name | Beschreibung | Expiration* | +|:------------------ |:------------------------------------ |:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:------------------------------------------------------------- | +| GitHub | `app_manifest_token` | This cookie is used during the App Manifest flow to maintain the state of the flow during the redirect to fetch a user session. | five minutes | +| GitHub | `cookie-preferences` | This cookie is used to track user cookie preferences. | one year | +| GitHub | `_device_id` | This cookie is used to track recognized devices. | one year | +| GitHub | `dotcom_user` | Dieses Cookie wird verwendet, um uns zu signalisieren, dass der Benutzer bereits angemeldet ist. | one year | +| GitHub | `_gh_ent` | This cookie is used for temporary application and framework state between pages like what step the customer is on in a multiple step form. | two weeks | +| GitHub | `_gh_sess` | Dieses Cookie wird für temporäre Anwendungen und Framework-Status zwischen Seiten verwendet, z. B. in welchem Schritt sich der Benutzer in einem mehrstufigen Formular befindet. | Session, Sitzung | +| GitHub | `gist_oauth_csrf` | Dieses Cookie wird von Gist gesetzt, um sicherzustellen, dass der Benutzer, der den auth-Flow gestartet hat, derselbe Benutzer ist, der ihn abschließt. | deleted when oauth state is validated | +| GitHub | `gist_user_session` | Dieses Cookie wird von Gist verwendet, wenn es auf einem separaten Host ausgeführt wird. | two weeks | +| GitHub | `has_recent_activity` | This cookie is used to prevent showing the security interstitial to users that have visited the app recently. | one hour | +| GitHub | `__Host-gist_user_session_same_site` | Dieses Cookie wird so gesetzt, dass Browser, die SameSite-Cookies unterstützen, überprüfen können, ob eine Anfrage von GitHub stammt. | two weeks | +| GitHub | `__Host-user_session_same_site` | Dieses Cookie wird so gesetzt, dass Browser, die SameSite-Cookies unterstützen, überprüfen können, ob eine Anfrage von GitHub stammt. | two weeks | +| GitHub | `logged_in` | Dieses Cookie wird verwendet, um uns zu signalisieren, dass der Benutzer bereits angemeldet ist. | one year | +| GitHub | `marketplace_repository_ids` | This cookie is used for the marketplace installation flow. | one hour | +| GitHub | `marketplace_suggested_target_id` | This cookie is used for the marketplace installation flow. | one hour | +| GitHub | `_octo` | This cookie is used by our internal analytics service to distinguish unique users and clients. | one year | +| GitHub | `org_transform_notice` | This cookie is used to provide notice during organization transforms. | one hour | +| GitHub | `private_mode_user_session` | This cookie is used for Enterprise authentication requests. | two weeks | +| GitHub | `saml_csrf_token` | Dieses Cookie wird von der SAML auth path-Methode gesetzt, um dem Client ein Token zuzuordnen. | until user closes browser or completes authentication request | +| GitHub | `saml_csrf_token_legacy` | Dieses Cookie wird von der SAML auth path-Methode gesetzt, um dem Client ein Token zuzuordnen. | until user closes browser or completes authentication request | +| GitHub | `saml_return_to` | Dieses Cookie wird von der SAML auth path-Methode gesetzt, um den Status während der SAML-Authentifizierungsschleife beizubehalten. | until user closes browser or completes authentication request | +| GitHub | `saml_return_to_legacy` | Dieses Cookie wird von der SAML auth path-Methode gesetzt, um den Status während der SAML-Authentifizierungsschleife beizubehalten. | until user closes browser or completes authentication request | +| GitHub | `tz` | Mit diesem Cookie kann Ihr Browser uns mitteilen, in welcher Zeitzone Sie sich befinden. | Session, Sitzung | +| GitHub | `user_session` | Dieses Cookie wird verwendet, um Sie anzumelden. | two weeks | +| Google Analytics** | `_ga` | Dieses Cookie wird von Google Analytics verwendet. | two years | +| Google Analytics** | `_gat` | Dieses Cookie wird von Google Analytics verwendet. | one minute | +| Google Analytics** | `_gid` | Dieses Cookie wird von Google Analytics verwendet. | one day | + +_*_ The **expiration** dates for the cookies listed below generally apply on a rolling basis. + +_**_ We use **Google Analytics** as a third party analytics service to collect information about how our website performs and how our users, in general, navigate through and use GitHub. This helps us evaluate our users' use of GitHub, compile statistical reports on activity, and improve our content and website performance. + +You can control your Google Analytics cookie preferences through our cookie preference link located at the footer of our website. In addition, Google provides further information about its own privacy practices and [offers a browser add-on to opt out of Google Analytics tracking](https://tools.google.com/dlpage/gaoptout). + +(!) Please note certain pages on our website may set other third party cookies. Beispielsweise können wir Inhalte, z. B. Videos, von einer anderen Website, die ein Cookie setzt, einbetten. Während wir versuchen, diese Cookies von Drittanbietern zu minimieren, können wir nicht immer kontrollieren, welche Cookies diese Inhalte von Drittanbietern setzen. ### Tracking on GitHub -„[Do Not Track](https://www.eff.org/issues/do-not-track)“ („Nicht verfolgen“, DNT) ist eine Privatsphäreeinstellung, die Sie in Ihrem Browser festlegen können, wenn Sie nicht möchten, dass Online-Dienste, insbesondere Werbenetzwerke, unterschiedlichste Informationen über Ihre Online-Aktivitäten durch Drittanbieter-Verfolgungsdienste sammeln und teilen. GitHub reagiert auf Browser-DNT-Signale und folgt dem [W3C-Standard für das Reagieren auf DNT-Signale](https://www.w3.org/TR/tracking-dnt/). Wenn Sie diese Einstellung in Ihrem Browser setzen wollen, schauen Sie sich die Dokumentation Ihres Browsers an. Es gibt auch gute Anwendungen, die die Online-Verfolgung verhindern. Ein gutes Beispiel dafür ist [Privacy Badger](https://www.eff.org/privacybadger). - -Wenn Sie DNT auf einem Browser, der DNT unterstützt, nicht aktiviert haben, können Cookies an bestimmten Stellen unserer Website Ihre Online-Surfaktivitäten auf anderen Online-Diensten nachverfolgen, aber wir gestatten es keinen Dritten, außer unseren Analyse- und Dienstanbietern, die Aktivitäten von GitHub-Benutzern auf GitHub zu verfolgen. Wir verwenden diese Cookies, damit wir Ihnen Produkte und Dienstleistungen von GitHub auf Websites und Diensten Dritter anbieten können. Wir haben auch Vereinbarungen mit verschiedenen Anbietern, wie Analyseanbietern, die uns helfen, die Besucherbewegung auf bestimmten Seiten unserer eigenen Webseite zu verfolgen. Nur unsere Anbieter, die in unserem Namen personenbezogene Daten sammeln, dürfen Daten auf unseren Seiten sammeln, und wir haben Datenschutzvereinbarungen mit jedem Anbieter unterzeichnet, der diese Daten in unserem Namen erhebt. Wir verwenden die Daten, die wir von diesen Anbietern erhalten, um die Interessen unserer Besucher besser nachvollziehen zu können, um die Leistung unserer Website zu erfassen und um unsere Inhalte zu verbessern. Jeder Analyseanbieter wird oben in unserer Unterauftragsverarbeiter-Liste aufgeführt, und Sie können eine Liste jeder Seite sehen, auf der wir diese Art von Daten erfassen. - -#### Google Analytics - -Wir verwenden Google Analytics als Drittanbieter-Analysedienst, und um unsere Werbekampagnen auf Websites und Diensten Dritter zu verfolgen. Wir verwenden Google Analytics um Informationen darüber zu sammeln, wie unsere Website funktioniert und wie unsere Benutzer im Allgemeinen durch GitHub navigieren und diese Website nutzen. Dies hilft uns, die Nutzung von GitHub durch unsere Benutzer zu bewerten, statistische Berichte über Aktivitäten zu erstellen und unsere Inhalte sowie die Leistung unserer Website zu verbessern. Google stellt weitere Informationen zu seinen eigenen Datenschutzpraktiken zur Verfügung und [bietet ein Browser-Add-On, mit dem die Verfolgung durch Google Analytics deaktiviert werden kann](https://tools.google.com/dlpage/gaoptout). - -#### Seiten auf GitHub auf denen Analysen aktiviert werden können - -Seiten auf URLs, die eine der folgenden Domains und Pfade (einschließlich Subdomains oder Subpaths) auf unseren Websites enthalten, können analytische oder andere Tracking-Codes aktiviert haben. Wenn Sie verhindern möchten, dass wir Informationen über Ihre Browseraktivitäten auf GitHub sammeln, können Sie einen Tracking-Blocker wie [Privacy Badger](https://www.eff.org/privacybadger) verwenden oder sich von Google Analytics-Tracking abmelden. - -- github.com/home (wenn Sie ausgeloggt sind oder keinen Account haben, wird diese Seite angezeigt, wenn Sie zu github.com gehen) -- github.com/about -- github.blog -- github.com/enterprise -- github.com/collections -- github.com/developer-stories -- github.com/events -- github.com/explore -- github.com/features -- github.com/logos -- github.com/nonprofit -- github.com/open-source -- github.com/personal -- github.com/pricing -- github.com/ten -- github.com/trending -- resources.github.com -- de.github.com -- fr.github.com +"[Do Not Track](https://www.eff.org/issues/do-not-track)" (DNT) is a privacy preference you can set in your browser if you do not want online services to collect and share certain kinds of information about your online activity from third party tracking services. GitHub reagiert auf Browser-DNT-Signale und folgt dem [W3C-Standard für das Reagieren auf DNT-Signale](https://www.w3.org/TR/tracking-dnt/). Wenn Sie diese Einstellung in Ihrem Browser setzen wollen, schauen Sie sich die Dokumentation Ihres Browsers an. Es gibt auch gute Anwendungen, die die Online-Verfolgung verhindern. Ein gutes Beispiel dafür ist [Privacy Badger](https://www.eff.org/privacybadger). + +Wenn Sie DNT auf einem Browser, der DNT unterstützt, nicht aktiviert haben, können Cookies an bestimmten Stellen unserer Website Ihre Online-Surfaktivitäten auf anderen Online-Diensten nachverfolgen, aber wir gestatten es keinen Dritten, außer unseren Analyse- und Dienstanbietern, die Aktivitäten von GitHub-Benutzern auf GitHub zu verfolgen. We have agreements with certain vendors, such as analytics providers, who help us track visitors' movements on certain pages on our website. Nur unsere Anbieter, die in unserem Namen personenbezogene Daten sammeln, dürfen Daten auf unseren Seiten sammeln, und wir haben Datenschutzvereinbarungen mit jedem Anbieter unterzeichnet, der diese Daten in unserem Namen erhebt. Wir verwenden die Daten, die wir von diesen Anbietern erhalten, um die Interessen unserer Besucher besser nachvollziehen zu können, um die Leistung unserer Website zu erfassen und um unsere Inhalte zu verbessern. Any analytics vendor will be listed in our [subprocessor list](#github-subprocessors), and you may see a list of every page where we collect this kind of data below. diff --git a/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors.md b/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors.md index 66b865f06b47..f9226848ae22 100644 --- a/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors.md +++ b/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors.md @@ -9,7 +9,7 @@ versions: ### Informationen zu {% data variables.product.prodname_sponsors %} -{% data reusables.sponsors.sponsorship-details %} {% data reusables.sponsors.no-fees %} Weitere Informationen findest Du auf „[Über die Abrechnung für {% data variables.product.prodname_sponsors %}](/articles/about-billing-for-github-sponsors)." +{% data reusables.sponsors.sponsorship-details %}{% data reusables.sponsors.no-fees %} Weitere Informationen findest Du unter „[ Informationen zur Abrechnung für {% data variables.product.prodname_sponsors %}](/articles/about-billing-for-github-sponsors)." {% data reusables.sponsors.you-can-be-a-sponsored-developer %} Weitere Informationen findest Du unter „[Über {% data variables.product.prodname_sponsors %} für Open-Source-Mitwirkende](/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors-for-open-source-contributors)" und „[{% data variables.product.prodname_sponsors %} für Dein Benutzerkonto einrichten](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)." diff --git a/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/configuring-webhooks-for-events-in-your-sponsored-account.md b/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/configuring-webhooks-for-events-in-your-sponsored-account.md index a715d2753717..a2e73d7a3026 100644 --- a/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/configuring-webhooks-for-events-in-your-sponsored-account.md +++ b/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/configuring-webhooks-for-events-in-your-sponsored-account.md @@ -1,6 +1,6 @@ --- title: Webhooks für Ereignisse in deinem unterstützten Konto konfigurieren -intro: 'Du kannst Webhooks konfigurieren, damit Du benachrichtigt wirst, wenn Du ein neues Sponsoring erhältst, oder wenn bestehende Sponsoren Änderungen an ihren Sponsorings machen.' +intro: Du kannst Webhooks konfigurieren, damit Du benachrichtigt wirst, wenn Du ein neues Sponsoring erhältst, oder wenn bestehende Sponsoren Änderungen an ihren Sponsorings machen. versions: free-pro-team: '*' --- diff --git a/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/contacting-your-sponsors.md b/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/contacting-your-sponsors.md index 43ab2b16f2f7..c166c3c94034 100644 --- a/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/contacting-your-sponsors.md +++ b/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/contacting-your-sponsors.md @@ -1,6 +1,6 @@ --- title: Deine Sponsoren kontaktieren -intro: 'Du kannst eine E-Mail an Deine Sponsoren senden, wenn diese den Erhalt von Aktualisierungen zu Deiner Arbeit abonniert haben.' +intro: Du kannst eine E-Mail an Deine Sponsoren senden, wenn diese den Erhalt von Aktualisierungen zu Deiner Arbeit abonniert haben. redirect_from: - /articles/contacting-your-sponsors versions: diff --git a/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors.md b/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors.md index 86483e529ffb..63a0d3c2a7c9 100644 --- a/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors.md +++ b/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors.md @@ -1,6 +1,6 @@ --- title: Die Details Deines GitHub Sponsors-Profil bearbeiten -intro: 'Du kannst die Informationen aktualisieren, die potenziellen Sponsoren zu Deiner Arbeit angezeigt werden.' +intro: Du kannst die Informationen aktualisieren, die potenziellen Sponsoren zu Deiner Arbeit angezeigt werden. redirect_from: - /articles/editing-your-sponsored-developer-profile - /github/supporting-the-open-source-community-with-github-sponsors/editing-your-sponsored-developer-profile diff --git a/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-payouts-from-github-sponsors.md b/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-payouts-from-github-sponsors.md index 63d219c1b10c..4d4d61c51213 100644 --- a/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-payouts-from-github-sponsors.md +++ b/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-payouts-from-github-sponsors.md @@ -1,6 +1,6 @@ --- title: Deine Auszahlungen von GitHub Sponsors verwalten -intro: 'Du kannst Informationen zu vergangenen und künftigen Auszahlungen von {% data variables.product.prodname_sponsors %} einsehen und Deine Bankdaten bearbeiten.' +intro: 'Sie können Informationen zu vergangenen und künftigen Auszahlungen von {% data variables.product.prodname_sponsors %} einsehen und Ihre Bankdaten bearbeiten.' redirect_from: - /articles/managing-your-payouts-from-github-sponsors versions: diff --git a/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship-goal.md b/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship-goal.md index 0e60788e08a7..f8ce7c02fbf3 100644 --- a/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship-goal.md +++ b/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship-goal.md @@ -1,6 +1,6 @@ --- title: Deine Sponsoring-Ziele verwalten -intro: 'Du kannst Ziele für das Profil als unterstützter Entwickler oder als unterstützte Organisationen setzen, um der Community zu helfen, die Auswirkungen zu verstehen, die das Sponsorings auf Dich hat.' +intro: Du kannst Ziele für das Profil als unterstützter Entwickler oder als unterstützte Organisationen setzen, um der Community zu helfen, die Auswirkungen zu verstehen, die das Sponsorings auf Dich hat. versions: free-pro-team: '*' --- diff --git a/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship.md b/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship.md index eb04f26bbc0b..b3168138d7ae 100644 --- a/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship.md +++ b/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship.md @@ -1,6 +1,6 @@ --- title: Sponsoring verwalten -intro: 'Du kannst verwalten, wer Dein Sponsoring sehen kann, und festlegen, ob Du per E-Mail Aktualisierungen von unterstützten Open-Source-Mitwirkenden erhalten möchtest.' +intro: Du kannst verwalten, wer Dein Sponsoring sehen kann, und festlegen, ob Du per E-Mail Aktualisierungen von unterstützten Open-Source-Mitwirkenden erhalten möchtest. redirect_from: - /articles/managing-your-sponsorship versions: diff --git a/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md b/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md index 706dfe63d676..0bb773fa388b 100644 --- a/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md +++ b/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md @@ -50,7 +50,7 @@ Um {% data variables.product.prodname_sponsors %} als ein einzelner Mitwirkender ### Deine Bankinformationen einreichen -Als unterstützte Organisation musst Du Auszahlungen auf ein dediziertes Bankkonto Deiner Organisation in einer unterstützten Region erhalten. Du kannst ein Unternehmensbankkonto über Dienste wie [Open Collective](https://opencollective.com/) und [Stripe Atlas](https://stripe.com/atlas) erhalten. {% data reusables.sponsors.stripe-supported-regions %} +Als unterstützte Organisation musst Du Auszahlungen auf ein dediziertes Bankkonto Deiner Organisation in einer unterstützten Region erhalten. Du kannst ein Unternehmensbankkonto über Dienste wie [Open Collective](https://opencollective.com/) und [Stripe Atlas](https://stripe.com/atlas) erhalten. The region your organization legally operates in and the region of your bank account must match. The person setting up {% data variables.product.prodname_sponsors %} for the organization must live in the same supported region, too. {% data reusables.sponsors.stripe-supported-regions %} {% data reusables.sponsors.double-check-stripe-info %} diff --git a/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md b/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md index b1ba57dde951..7961659dc26b 100644 --- a/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md +++ b/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md @@ -50,7 +50,7 @@ Nachdem {% data variables.product.prodname_dotcom %} Deine Bewerbung überprüft ### Deine Bankinformationen einreichen -Wenn Du in einer unterstützen Region lebst, kannst Du diesen Anweisungen folgen, um Deine Bankinformationen durch das Erstellen eines Stripe Connect-Kontos einzureichen. {% data reusables.sponsors.stripe-supported-regions %} +Wenn Du in einer unterstützen Region lebst, kannst Du diesen Anweisungen folgen, um Deine Bankinformationen durch das Erstellen eines Stripe Connect-Kontos einzureichen. Your region of residence and the region of your bank account must match. {% data reusables.sponsors.stripe-supported-regions %} {% data reusables.sponsors.double-check-stripe-info %} diff --git a/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor.md b/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor.md index 14778ae8d0dd..430eb59b5fac 100644 --- a/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor.md +++ b/translations/de-DE/content/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor.md @@ -11,7 +11,7 @@ versions: ### Über die Unterstützung von Entwicklern und Organisationen -{% data reusables.sponsors.sponsorship-details %} {% data reusables.sponsors.no-fees %} Weitere Informationen findest Du auf „[Über die Abrechnung für {% data variables.product.prodname_sponsors %}](/articles/about-billing-for-github-sponsors)." +{% data reusables.sponsors.sponsorship-details %}{% data reusables.sponsors.no-fees %} Weitere Informationen findest Du unter „[ Informationen zur Abrechnung für {% data variables.product.prodname_sponsors %}](/articles/about-billing-for-github-sponsors)." Wenn Du einen Open-Source-Mitwirkenden unterstützt, wird diese Änderung sofort wirksam. {% data reusables.sponsors.prorated-sponsorship %} @@ -31,7 +31,7 @@ Wenn der Open-Source-Mitwirkende, den du unterstützen möchtest, kein Profil al Bevor Du einen Entwickler unterstützten kannst, musst Du einen verifizierte E-Mail-Adresse haben. Weitere Informationen findest Du unter „[Eigene E-Mail-Adresse verifizieren](/github/getting-started-with-github/verifying-your-email-address).“ -1. Navigiere auf {% data variables.product.product_name %} zu dem Profil des Entwicklers, den Du unterstützen möchtest. +1. Navigieren Sie auf {% data variables.product.product_name %} zu dem Profil des Entwicklers, den Sie sponsern möchten. 2. Klicke unter dem Namen des Entwicklers auf **Sponsor** (Unterstützen). ![Schaltfläche „Sponsor“ (Sponsern)](/assets/images/help/profile/sponsor-button.png) {% data reusables.sponsors.select-a-tier %} {% data reusables.sponsors.select-sponsorship-billing %} diff --git a/translations/de-DE/content/github/teaching-and-learning-with-github-education/about-campus-advisors.md b/translations/de-DE/content/github/teaching-and-learning-with-github-education/about-campus-advisors.md index 0a670f462325..e3da8c1e9163 100644 --- a/translations/de-DE/content/github/teaching-and-learning-with-github-education/about-campus-advisors.md +++ b/translations/de-DE/content/github/teaching-and-learning-with-github-education/about-campus-advisors.md @@ -1,6 +1,6 @@ --- title: Informationen zu Campus Advisors -intro: 'Lerne mit Campus Advisors-Schulung und -Unterstützung, wie Du als Kursleiter oder Mentor {% data variables.product.prodname_dotcom %} in Deiner Bildungseinrichtung einsetzen kannst.' +intro: 'Lernen Sie als Instrukteur oder Mentor, {% data variables.product.prodname_dotcom %} an Ihrer Einrichtung mit Campus Advisors-Schulungen und -Support zu verwenden.' redirect_from: - /articles/about-campus-advisors versions: diff --git a/translations/de-DE/content/github/teaching-and-learning-with-github-education/about-campus-experts.md b/translations/de-DE/content/github/teaching-and-learning-with-github-education/about-campus-experts.md index 0a66b60cd2b4..3282b4d4d55e 100644 --- a/translations/de-DE/content/github/teaching-and-learning-with-github-education/about-campus-experts.md +++ b/translations/de-DE/content/github/teaching-and-learning-with-github-education/about-campus-experts.md @@ -7,4 +7,4 @@ versions: free-pro-team: '*' --- -Erlerne Fähigkeiten in den Bereichen öffentliches Reden, technisches Schreiben, Community-Leadership und Softwareentwicklung als 'Campus Expert' für {% data variables.product.prodname_dotcom %}. Weitere Informationen findest Du unter „[Campus Experts](https://education.github.com/students/experts).“ +Erlernen von Fähigkeiten in den Bereichen öffentliches Reden, technisches Schreiben, Community Leadership und Softwareentwicklung als Campus Experts für {% data variables.product.prodname_dotcom %}. Weitere Informationen findest Du unter „[Campus Experts](https://education.github.com/students/experts).“ diff --git a/translations/de-DE/content/github/teaching-and-learning-with-github-education/about-github-education-for-students.md b/translations/de-DE/content/github/teaching-and-learning-with-github-education/about-github-education-for-students.md index fb4c6fe88897..79c6cf2df2ac 100644 --- a/translations/de-DE/content/github/teaching-and-learning-with-github-education/about-github-education-for-students.md +++ b/translations/de-DE/content/github/teaching-and-learning-with-github-education/about-github-education-for-students.md @@ -7,13 +7,13 @@ versions: free-pro-team: '*' --- -Die Verwendung von {% data variables.product.prodname_dotcom %} für Deine Projektarbeiten ist ein praktischer Weg, um mit anderen zusammenzuarbeiten und ein Portfolio aufzubauen, das Deine praktischen Erfahrungen zeigt. +Die Verwendung von {% data variables.product.prodname_dotcom %} für Ihre Projektarbeiten ist ein praktischer Weg, um mit anderen zusammenzuarbeiten und ein Portfolio aufzubauen, das Ihre praktische Erfahrung zeigt. {% data reusables.education.about-github-education-link %} -Jeder mit einem {% data variables.product.prodname_dotcom %}-Konto kann unbegrenzt in öffentlichen und privaten Repositorys mit {% data variables.product.prodname_free_user %} zusammenarbeiten. Als Schüler oder Student kannst Du auch das {% data variables.product.prodname_student_pack %} beantragen, das kostenlosen Zugriff auf Werkzeuge und Dienste bietet, die von professionellen Entwicklern verwendet werden. Weitere Informationen findest Du unter „[Ein Studentenentwicklungspaket beantragen](/articles/applying-for-a-student-developer-pack)“ und [{% data variables.product.prodname_education %}](https://education.github.com/pack). +Jeder mit einem {% data variables.product.prodname_dotcom %}-Konto kann unbegrenzt in öffentlichen und privaten Repositorys mit {% data variables.product.prodname_free_user %} zusammenarbeiten. Als Schüler oder Student können Sie auch das {% data variables.product.prodname_student_pack %} beantragen, das kostenlosen Zugriff auf Tools und Dienste bietet, die von professionellen Entwicklern verwendet werden. Weitere Informationen findest Du unter „[Ein Studentenentwicklungspaket beantragen](/articles/applying-for-a-student-developer-pack)“ und [{% data variables.product.prodname_education %}](https://education.github.com/pack). -Wenn Du Mitglied in einem FIRST Robotics Club bist, kann Dein Lehrer einen Rabatt beantragen, damit Dein Team mit {% data variables.product.prodname_team %} zusammenarbeiten kann, wodurch eine unbegrenzte Anzahl von Benutzern und privaten Repositorys kostenlos genutzt werden kann. Weitere Informationen findest Du unter „[Einen Lehrer- oder Forscherrabatt beantragen](/articles/applying-for-an-educator-or-researcher-discount).“ +Wenn Sie Mitglied in einem FIRST Robotics Club sind, kann Ihr Lehrer einen Rabatt beantragen, damit Ihr Team mit {% data variables.product.prodname_team %} zusammenarbeiten kann, wodurch eine unbegrenzte Anzahl von Benutzern und privaten Repositorys kostenlos genutzt werden kann. Weitere Informationen findest Du unter „[Einen Lehrer- oder Forscherrabatt beantragen](/articles/applying-for-an-educator-or-researcher-discount).“ ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/teaching-and-learning-with-github-education/about-github-education.md b/translations/de-DE/content/github/teaching-and-learning-with-github-education/about-github-education.md index c353dd8e1a06..2841ab16d7f8 100644 --- a/translations/de-DE/content/github/teaching-and-learning-with-github-education/about-github-education.md +++ b/translations/de-DE/content/github/teaching-and-learning-with-github-education/about-github-education.md @@ -7,12 +7,12 @@ versions: free-pro-team: '*' --- -Wenn Deine Bildungseinrichtung bestimmte Anforderungen erfüllt, kann Deine weiterführende Schule, Deine Universität oder Dein Schülercamp {% data variables.product.prodname_education %} erhalten und damit das Beste von {% data variables.product.prodname_dotcom %} kostenlos nutzen, einschließlich: +Wenn Ihre Schule bestimmte Anforderungen erfüllt, kann Ihre weiterführende Schule, Ihre Universität oder Ihr Schülercamp {% data variables.product.prodname_education %} und damit das Beste von {% data variables.product.prodname_dotcom %} kostenlos nutzen, einschließlich - {% data variables.product.prodname_ghe_cloud %} und/oder {% data variables.product.prodname_ghe_server %}, - Lehrerschulung zur Beherrschung von Git und {% data variables.product.prodname_dotcom %} mit unserem Campus Advisors-Programm, -- Automatisierter Zugriff auf die Premiumfunktionen von {% data variables.product.prodname_education %}, wie beispielsweise das {% data variables.product.prodname_student_pack %}, +- automatisierter Zugriff auf die Premiumfunktionen von {% data variables.product.prodname_education %}, wie z. B. das {% data variables.product.prodname_student_pack %}, - Schulungen für Schüler und Studenten mit dem Campus Experts-Programm zur Entwicklung von Leadership und technischer Kompetenz. Weitere Informationen findest Du auf der [offiziellen {% data variables.product.prodname_education %}-Seite](https://education.github.com/partners/schools). Weitere Informationen zu Schulungsprogrammen für Schüler, Studenten und Lehrer findest Du unter „[{% data variables.product.prodname_dotcom %} Campus Experts](https://education.github.com/students/experts)“ und „[Campus Advisors](https://education.github.com/teachers/advisors).“ -Wenn Du Schüler, Student oder Lehrkraft bist und Deine Einrichtung nicht mit {% data variables.product.prodname_dotcom %} als {% data variables.product.prodname_education %}-Einrichtung kooperiert, kannst Du trotzdem individuell Rabatte für die Nutzung von {% data variables.product.prodname_dotcom %} beantragen. Weitere Informationen findest Du unter „[{% data variables.product.prodname_dotcom %} für schulische Arbeiten nutzen](/articles/using-github-for-your-schoolwork/)“ oder „[{% data variables.product.prodname_dotcom %} für Lehre und Forschung nutzen](/articles/using-github-in-your-classroom-and-research/).“ +Wenn Sie Schüler, Student oder Lehrkraft sind und Ihre Einrichtung nicht mit {% data variables.product.prodname_dotcom %} als {% data variables.product.prodname_education %}-Einrichtung kooperiert, können Sie trotzdem individuell Rabatte für die Nutzung von {% data variables.product.prodname_dotcom %} beantragen. Weitere Informationen findest Du unter „[{% data variables.product.prodname_dotcom %} für schulische Arbeiten nutzen](/articles/using-github-for-your-schoolwork/)“ oder „[{% data variables.product.prodname_dotcom %} für Lehre und Forschung nutzen](/articles/using-github-in-your-classroom-and-research/).“ diff --git a/translations/de-DE/content/github/teaching-and-learning-with-github-education/applying-for-a-student-developer-pack.md b/translations/de-DE/content/github/teaching-and-learning-with-github-education/applying-for-a-student-developer-pack.md index 17aa1872d27c..718370d1f5b3 100644 --- a/translations/de-DE/content/github/teaching-and-learning-with-github-education/applying-for-a-student-developer-pack.md +++ b/translations/de-DE/content/github/teaching-and-learning-with-github-education/applying-for-a-student-developer-pack.md @@ -27,7 +27,7 @@ Während Deiner Zeit als Student wirst Du möglicherweise dazu aufgefordert, in {% endnote %} -Weitere Informationen zum Verlängerung Deines {% data variables.product.prodname_student_pack %}s findest Du unter „[Ablauf und Verlängerungen](/articles/applying-for-a-student-developer-pack/#expiration-and-renewals).“ +Weitere Informationen zum Verlängerung Ihres {% data variables.product.prodname_student_pack %}s finden Sie unter „[Ablauf und Verlängerungen](/articles/applying-for-a-student-developer-pack/#expiration-and-renewals)“. ### Ein {% data variables.product.prodname_student_pack %} beantragen @@ -41,9 +41,9 @@ Weitere Informationen zum Verlängerung Deines {% data variables.product.prodnam ### Ablauf und Verlängerungen -Wenn Dein Zugriff auf das {% data variables.product.prodname_student_pack %} abgelaufen ist, kannst Du ihn erneut beantragen, sofern Du die Voraussetzungen weiterhin erfüllst. Einige unserer Partnerangebote können jedoch nicht verlängert werden. Die meisten zeitlich begrenzten Angebote unserer Partner beginnen unmittelbar nachdem Du sie eingerichtet hast. Weitere Informationen findest Du auf der [{% data variables.product.prodname_student_pack %}](https://education.github.com/pack)-Seite. +Wenn Ihr Zugriff auf das {% data variables.product.prodname_student_pack %} abgelaufen ist, können Sie ihn erneut beantragen, sofern Sie die Voraussetzungen weiterhin erfüllen. Einige unserer Partnerangebote können jedoch nicht verlängert werden. Die meisten zeitlich begrenzten Angebote unserer Partner beginnen unmittelbar nachdem Du sie eingerichtet hast. Weitere Informationen findest Du auf der [{% data variables.product.prodname_student_pack %}](https://education.github.com/pack)-Seite. -Angaben dazu, wann Dein kostenloser Zugriff auf das {% data variables.product.prodname_student_pack %} abläuft, findest Du in den [Abrechnungseinstellungen](https://github.com/settings/billing) Deines Kontos. +Angaben dazu, wann Ihr kostenloser Zugriff auf das {% data variables.product.prodname_student_pack %} abläuft, finden Sie in den [Abrechnungseinstellungen](https://github.com/settings/billing) Ihres Kontos. ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/teaching-and-learning-with-github-education/applying-for-an-educator-or-researcher-discount.md b/translations/de-DE/content/github/teaching-and-learning-with-github-education/applying-for-an-educator-or-researcher-discount.md index 37dfcf4fc102..65ce82279181 100644 --- a/translations/de-DE/content/github/teaching-and-learning-with-github-education/applying-for-an-educator-or-researcher-discount.md +++ b/translations/de-DE/content/github/teaching-and-learning-with-github-education/applying-for-an-educator-or-researcher-discount.md @@ -1,6 +1,6 @@ --- title: Einen Lehrer- oder Forscherrabatt beantragen -intro: 'Wenn Du ein Lehrer oder Forscher bist, kannst Du beantragen, {% data variables.product.prodname_team %} kostenlos für das Konto Deiner Organisation zu erhalten.' +intro: 'Wenn Sie ein Lehrer oder Forscher sind, können Sie beantragen, {% data variables.product.prodname_team %} kostenlos für das Konto Ihrer Organisation zu erhalten.' redirect_from: - /articles/applying-for-a-classroom-discount/ - /articles/applying-for-a-discount-for-your-school-club/ diff --git a/translations/de-DE/content/github/teaching-and-learning-with-github-education/using-github-at-your-educational-institution.md b/translations/de-DE/content/github/teaching-and-learning-with-github-education/using-github-at-your-educational-institution.md index fb27fa131e51..f4b4e6c9203a 100644 --- a/translations/de-DE/content/github/teaching-and-learning-with-github-education/using-github-at-your-educational-institution.md +++ b/translations/de-DE/content/github/teaching-and-learning-with-github-education/using-github-at-your-educational-institution.md @@ -1,6 +1,6 @@ --- title: GitHub in Deiner Bildungseinrichtung verwenden -intro: 'Maximiere die Vorteile der Nutzung von {% data variables.product.prodname_dotcom %} in Deiner Einrichtung für Deine Studenten, Kursleiter und IT-Mitarbeiter mit {% data variables.product.prodname_education %} und unseren verschiedenen Schulungsprogrammen für Studenten und Kursleiter.' +intro: 'Maximieren Sie die Vorteile der Nutzung von {% data variables.product.prodname_dotcom %} in Ihrer Einrichtung für Ihre Studenten, Instrukteure und IT-Mitarbeiter mit {% data variables.product.prodname_education %} und unseren verschiedenen Schulungsprogrammen für Studenten und Instrukteure.' mapTopic: true redirect_from: - /articles/using-github-at-your-educational-institution diff --git a/translations/de-DE/content/github/teaching-and-learning-with-github-education/why-wasnt-my-application-for-an-educator-or-researcher-discount-approved.md b/translations/de-DE/content/github/teaching-and-learning-with-github-education/why-wasnt-my-application-for-an-educator-or-researcher-discount-approved.md index 447c7858faf5..2dfeb57237e3 100644 --- a/translations/de-DE/content/github/teaching-and-learning-with-github-education/why-wasnt-my-application-for-an-educator-or-researcher-discount-approved.md +++ b/translations/de-DE/content/github/teaching-and-learning-with-github-education/why-wasnt-my-application-for-an-educator-or-researcher-discount-approved.md @@ -1,6 +1,6 @@ --- title: Warum wurde mein Antrag auf einen Lehrer- oder Forscherrabatt nicht genehmigt? -intro: 'Lies die generellen Gründe durch, weshalb Bewerbungen für einen Lehrer- oder Forscherrabatt nicht genehmigt werden, und die Tipps, um die erneute Bewerbung erfolgreich zu gestalten.' +intro: Lies die generellen Gründe durch, weshalb Bewerbungen für einen Lehrer- oder Forscherrabatt nicht genehmigt werden, und die Tipps, um die erneute Bewerbung erfolgreich zu gestalten. redirect_from: - /articles/why-was-my-application-for-an-educator-or-researcher-discount-denied/ - /articles/why-wasn-t-my-application-for-an-educator-or-researcher-discount-approved diff --git a/translations/de-DE/content/github/using-git/about-git-rebase.md b/translations/de-DE/content/github/using-git/about-git-rebase.md index 8276c0a9d48c..569a8b747386 100644 --- a/translations/de-DE/content/github/using-git/about-git-rebase.md +++ b/translations/de-DE/content/github/using-git/about-git-rebase.md @@ -106,4 +106,4 @@ Wenn man diese Informationen von oben nach unten betrachtet, wird Folgendes deut - [Kapitel „Git-Branching“ aus dem _Pro Git_-Buch](https://git-scm.com/book/en/Git-Branching-Rebasing) - [Kapitel „Interaktives Rebasing“ aus dem _Pro Git_-Buch](https://git-scm.com/book/en/Git-Tools-Rewriting-History#_changing_multiple) - „[Squashing von Commits mit Rebase](http://gitready.com/advanced/2009/02/10/squashing-commits-with-rebase.html)“ -- „[Deinen Branch synchronisieren](/desktop/contributing-to-projects/syncing-your-branch)" in der {% data variables.product.prodname_desktop %}-Dokumentation +- „[Ihren Branch synchronisieren](/desktop/contributing-to-projects/syncing-your-branch)" in der {% data variables.product.prodname_desktop %}-Dokumentation diff --git a/translations/de-DE/content/github/using-git/about-git-subtree-merges.md b/translations/de-DE/content/github/using-git/about-git-subtree-merges.md index dd12ecb00b16..515886bbc6cd 100644 --- a/translations/de-DE/content/github/using-git/about-git-subtree-merges.md +++ b/translations/de-DE/content/github/using-git/about-git-subtree-merges.md @@ -37,7 +37,7 @@ Das Zusammenführen von Unterstrukturen lässt sich am besten anhand eines Beisp $ touch .gitignore $ git add .gitignore $ git commit -m "initial commit" - > [master (root-commit) 3146c2a] initial commit + > [main (root-commit) 3146c2a] initial commit > 0 files changed, 0 insertions(+), 0 deletions(-) > create mode 100644 .gitignore ``` @@ -55,29 +55,29 @@ Das Zusammenführen von Unterstrukturen lässt sich am besten anhand eines Beisp > Receiving objects: 100% (1732/1732), 528.19 KiB | 621 KiB/s, done. > Resolving deltas: 100% (1086/1086), done. > From git://github.com/octocat/Spoon-Knife - > * [new branch] master -> Spoon-Knife/master + > * [new branch] main -> Spoon-Knife/main ``` 2. Führe das Projekt `Spoon-Knife` in das lokale Git-Projekt zusammen. Dadurch wird keine Deiner Dateien lokal geändert, aber Git wird auf den nächsten Schritt vorbereitet. Bei Verwendung von Git 2.9 oder höher: ```shell - $ git merge -s ours --no-commit --allow-unrelated-histories spoon-knife/master + $ git merge -s ours --no-commit --allow-unrelated-histories spoon-knife/main > Automatic merge went well; stopped before committing as requested ``` Bei Verwendung von Git 2.8 oder älter: ```shell - $ git merge -s ours --no-commit spoon-knife/master + $ git merge -s ours --no-commit spoon-knife/main > Automatic merge went well; stopped before committing as requested ``` 3. Erstelle ein neues Verzeichnis mit dem Namen **spoon-knife**, und kopiere den Git-Verlauf des Projekts `Spoon-Knife` in dieses Verzeichnis. ```shell - $ git read-tree --prefix=spoon-knife/ -u spoon-knife/master + $ git read-tree --prefix=spoon-knife/ -u spoon-knife/main ``` 4. Erstelle einen Commit der Änderungen, um sie zu sichern. ```shell $ git commit -m "Subtree merged in spoon-knife" - > [master fe0ca25] Subtree merged in spoon-knife + > [main fe0ca25] Subtree merged in spoon-knife ``` Wir haben hier nur ein Subprojekt hinzugefügt. Du kannst jedoch eine beliebige Anzahl an Subprojekten in ein Git-Repository integrieren. @@ -99,7 +99,7 @@ $ git pull -s subtree remotename branchname Im Beispiel oben würde dies so aussehen: ```shell -$ git pull -s subtree spoon-knife master +$ git pull -s subtree spoon-knife main ``` ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/using-git/associating-text-editors-with-git.md b/translations/de-DE/content/github/using-git/associating-text-editors-with-git.md index ee9e2ab7e8cf..20292c10ee6f 100644 --- a/translations/de-DE/content/github/using-git/associating-text-editors-with-git.md +++ b/translations/de-DE/content/github/using-git/associating-text-editors-with-git.md @@ -1,6 +1,6 @@ --- title: Texteditoren mit Git verknüpfen -intro: 'Verwende einen Texteditor, um Dateien mit Git zu öffnen und zu bearbeiten.' +intro: Verwende einen Texteditor, um Dateien mit Git zu öffnen und zu bearbeiten. redirect_from: - /textmate/ - /articles/using-textmate-as-your-default-editor/ diff --git a/translations/de-DE/content/github/using-git/dealing-with-non-fast-forward-errors.md b/translations/de-DE/content/github/using-git/dealing-with-non-fast-forward-errors.md index 5decf35eb1cf..0d0d4f2c3a86 100644 --- a/translations/de-DE/content/github/using-git/dealing-with-non-fast-forward-errors.md +++ b/translations/de-DE/content/github/using-git/dealing-with-non-fast-forward-errors.md @@ -11,9 +11,9 @@ versions: Wenn ein anderer Benutzer einen Push zum selben Branch durchgeführt hat wie Du, kann Git Deine Änderungen nicht überführen: ```shell -$ git push origin master +$ git push origin main > To https://{% data variables.command_line.codeblock %}/USERNAME/REPOSITORY.git -> ! [rejected] master -> master (non-fast-forward) +> ! [rejected] main -> main (non-fast-forward) > error: failed to push some refs to 'https://{% data variables.command_line.codeblock %}/USERNAME/REPOSITORY.git' > To prevent you from losing history, non-fast-forward updates were rejected > Merge the remote changes (e.g. 'git pull') before pushing again. See the diff --git a/translations/de-DE/content/github/using-git/getting-changes-from-a-remote-repository.md b/translations/de-DE/content/github/using-git/getting-changes-from-a-remote-repository.md index 0c859c046c0b..bd84c99fe714 100644 --- a/translations/de-DE/content/github/using-git/getting-changes-from-a-remote-repository.md +++ b/translations/de-DE/content/github/using-git/getting-changes-from-a-remote-repository.md @@ -20,7 +20,7 @@ $ git clone https://{% data variables.command_line.codeblock %}/USERNAMEFOLDER-NAME BRANCH-NAME # Filtere den spezifischen Branch in Deinem Verzeichnis und entferne leere Commits @@ -43,7 +43,7 @@ Wenn Du bei der Erstellung eines Repository-Klons einen Ordner in ein separates Das Repository sollte nun nur die Dateien des zuvor angegebenen Unterordners enthalten. 6. [Erstelle ein neues Repository](/articles/creating-a-new-repository/) auf {% data variables.product.product_name %}. -7. Klicke oben auf der Seite zur Schnelleinrichtung Deines neuen {% data variables.product.product_name %}-Repositorys auf {% octicon "clippy" aria-label="The copy to clipboard icon" %}, um die URL des Remote-Repositorys zu kopieren. ![Feld zum Kopieren der Remote-Repository-URL](/assets/images/help/repository/copy-remote-repository-url-quick-setup.png) +7. Klicken Sie oben auf der Seite zur Schnelleinrichtung Ihres neuen {% data variables.product.product_name %}-Repositorys auf {% octicon "clippy" aria-label="The copy to clipboard icon" %}, um die URL des Remote-Repositorys zu kopieren. ![Feld zum Kopieren der Remote-Repository-URL](/assets/images/help/repository/copy-remote-repository-url-quick-setup.png) {% tip %} diff --git a/translations/de-DE/content/github/using-git/updating-credentials-from-the-macos-keychain.md b/translations/de-DE/content/github/using-git/updating-credentials-from-the-macos-keychain.md index 4a0b13ef1fd5..4ff44be01348 100644 --- a/translations/de-DE/content/github/using-git/updating-credentials-from-the-macos-keychain.md +++ b/translations/de-DE/content/github/using-git/updating-credentials-from-the-macos-keychain.md @@ -31,7 +31,7 @@ protocol=https > [Press Return] ``` -Bei erfolgreicher Ausführung des Befehls erhältst Du keine Rückmeldung. Wenn Du testen möchtest, ob der Befehl funktioniert hat, klone ein Repository aus {% data variables.product.product_location %}. Wenn Du nach einem Passwort gefragt wirst, wurde der Keychain-Eintrag gelöscht. +Bei erfolgreicher Ausführung des Befehls erhältst Du keine Rückmeldung. Wenn Sie testen möchten, ob der Befehl funktioniert hat, klonen Sie ein Repository aus {% data variables.product.product_location %}. Wenn Du nach einem Passwort gefragt wirst, wurde der Keychain-Eintrag gelöscht. ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/using-git/using-git-rebase-on-the-command-line.md b/translations/de-DE/content/github/using-git/using-git-rebase-on-the-command-line.md index 5996f910bd55..8fd1e25570e8 100644 --- a/translations/de-DE/content/github/using-git/using-git-rebase-on-the-command-line.md +++ b/translations/de-DE/content/github/using-git/using-git-rebase-on-the-command-line.md @@ -123,7 +123,7 @@ Git zeigt erneut die zu bearbeitende Commit-Mitteilung an. Du kannst den Text (` Der gewöhnliche Befehl `git push origin` funktioniert **nicht**, da Du den Git-Verlauf geändert hast. Du musst den Befehl ändern, indem Du Deine neuesten Änderungen per erzwungenem Push-Vorgang überträgst: ```shell -$ git push origin master --force +$ git push origin main --force ``` {% warning %} diff --git a/translations/de-DE/content/github/using-git/which-remote-url-should-i-use.md b/translations/de-DE/content/github/using-git/which-remote-url-should-i-use.md index 5439aa9441a4..38365dd46914 100644 --- a/translations/de-DE/content/github/using-git/which-remote-url-should-i-use.md +++ b/translations/de-DE/content/github/using-git/which-remote-url-should-i-use.md @@ -31,7 +31,7 @@ Wenn Du an der Befehlszeile mittels HTTPS-URLs `git clone`-, `git fetch`-, `git {% endtip %} - {% if currentVersion == "free-pro-team@latest" %}Wenn Du lieber SSH verwenden möchtest, aber keine Verbindung über Port 22 herstellen kannst, kannst du SSH allenfalls über den HTTPS-Port verwenden. Weitere Informationen findest Du unter „[SSH über den HTTPS-Port verwenden](/github/authenticating-to-github/using-ssh-over-the-https-port)."{% endif %} + {% if currentVersion == "free-pro-team@latest" %}If you'd rather use SSH but cannot connect over port 22, you might be able to use SSH over the HTTPS port. Weitere Informationen findest Du unter „[SSH über den HTTPS-Port verwenden](/github/authenticating-to-github/using-ssh-over-the-https-port)."{% endif %} ### Mit SSH-URLs klonen @@ -39,7 +39,7 @@ SSH-URLs stellen über das sichere Protokoll SSH den Zugriff auf ein Git-Reposit Wenn Du mittels SSH-URLs `git clone`-, `git fetch`-, `git pull`- oder `git push`-Befehle an ein Remote-Repository sendest, musst Du ein Passwort eingeben und Deine SSH-Schlüssel-Passphrase bereitstellen. Weitere Informationen findest Du unter „[SSH-Schlüssel-Passphrasen verwenden](/github/authenticating-to-github/working-with-ssh-key-passphrases).“ -{% if currentVersion == "free-pro-team@latest" %}Wenn Du auf eine Organisation zugreifst, die SAML Single Sign-On (SSO) einsetzt, musst Du vor dem Authentifizieren Deinen SSH-Schlüssel für den Zugriff auf die Organisation autorisieren. Weitere Informationen findest Du unter[„Authentifizierung mit SAML Single Sign-On](/github/authenticating-to-github/about-authentication-with-saml-single-sign-on)" und[„Autorisieren eines SSH-Schlüssels für die Verwendung mit SAML Single Sign-On](/github/authenticating-to-github/authorizing-an-ssh-key-for-use-with-saml-single-sign-on)."{% endif %} +{% if currentVersion == "free-pro-team@latest" %}If you are accessing an organization that uses SAML single sign-on (SSO), you must authorize your SSH key to access the organization before you authenticate. Weitere Informationen findest Du unter[„Authentifizierung mit SAML Single Sign-On](/github/authenticating-to-github/about-authentication-with-saml-single-sign-on)" und[„Autorisieren eines SSH-Schlüssels für die Verwendung mit SAML Single Sign-On](/github/authenticating-to-github/authorizing-an-ssh-key-for-use-with-saml-single-sign-on)."{% endif %} {% tip %} diff --git a/translations/de-DE/content/github/using-git/why-is-git-always-asking-for-my-password.md b/translations/de-DE/content/github/using-git/why-is-git-always-asking-for-my-password.md index 3f6aca5e8c3c..6a06ed31f3de 100644 --- a/translations/de-DE/content/github/using-git/why-is-git-always-asking-for-my-password.md +++ b/translations/de-DE/content/github/using-git/why-is-git-always-asking-for-my-password.md @@ -1,5 +1,5 @@ --- -title: 'Warum werde ich von Git immer aufgefordert, mein Passwort einzugeben?' +title: Warum werde ich von Git immer aufgefordert, mein Passwort einzugeben? intro: 'Wenn Du durch Git jedes Mal zur Eingabe eines Benutzernamens und Passworts aufgefordert wirst, wenn Du versuchst, mit GitHub zu interagieren, verwendest Du wahrscheinlich die HTTPS-Klon-URL für Dein Repository.' redirect_from: - /articles/why-is-git-always-asking-for-my-password diff --git a/translations/de-DE/content/github/visualizing-repository-data-with-graphs/about-repository-graphs.md b/translations/de-DE/content/github/visualizing-repository-data-with-graphs/about-repository-graphs.md index 00671960a4ea..5ea537463b95 100644 --- a/translations/de-DE/content/github/visualizing-repository-data-with-graphs/about-repository-graphs.md +++ b/translations/de-DE/content/github/visualizing-repository-data-with-graphs/about-repository-graphs.md @@ -9,7 +9,7 @@ versions: enterprise-server: '*' --- -Die Diagramme eines Repositorys geben Dir Informationen über {% if currentVersion == "free-pro-team@latest" %}Traffic, vom Repository abhängige Projekte, {% endif %}Mitarbeiter und Commits des Repositorys sowie die Forks und das Netzwerk eines Repositorys. Wenn Du ein Repository verwaltest, kannst Du diese Daten verwenden, um besser zu verstehen, wer Dein Repository verwendet und warum es verwendet wird. +A repository's graphs give you information on {% if currentVersion == "free-pro-team@latest" %} traffic, projects that depend on the repository,{% endif %} contributors and commits to the repository, and a repository's forks and network. Wenn Du ein Repository verwaltest, kannst Du diese Daten verwenden, um besser zu verstehen, wer Dein Repository verwendet und warum es verwendet wird. {% if currentVersion == "free-pro-team@latest" %} diff --git a/translations/de-DE/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md b/translations/de-DE/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md index 3ebfd0eae0c5..069c3b38eda2 100644 --- a/translations/de-DE/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md +++ b/translations/de-DE/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md @@ -47,7 +47,6 @@ You can use the dependency graph to: {% if currentVersion == "free-pro-team@latest" %}To generate a dependency graph, {% data variables.product.product_name %} needs read-only access to the dependency manifest and lock files for a repository. The dependency graph is automatically generated for all public repositories and you can choose to enable it for private repositories. For information about enabling or disabling it for private repositories, see "[Exploring the dependencies of a repository](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository)."{% endif %} - {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %}If the dependency graph is not available in your system, your site administrator can enable the dependency graph and {% data variables.product.prodname_dependabot_short %} alerts. For more information, see "[Enabling alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server)."{% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %} If the dependency graph is not available in your system, your site administrator can enable the dependency graph and security alerts. For more information, see "[Enabling alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server)." @@ -62,7 +61,7 @@ The recommended formats explicitly define which versions are used for all direct | Package manager | Languages | Recommended formats | All supported formats | | --- | --- | --- | ---| -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}| Composer | PHP | `composer.lock` | `composer.json`, `composer.lock` |{% endif %} +| Composer | PHP | `composer.lock` | `composer.json`, `composer.lock` | | `dotnet` CLI | .NET languages (C#, C++, F#, VB) | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj` | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj`, `packages.config` | | Maven | Java, Scala | `pom.xml` | `pom.xml` | | npm | JavaScript | `package-lock.json` | `package-lock.json`, `package.json`| diff --git a/translations/de-DE/content/github/visualizing-repository-data-with-graphs/accessing-basic-repository-data.md b/translations/de-DE/content/github/visualizing-repository-data-with-graphs/accessing-basic-repository-data.md index 976f066991f4..bd520f3703dc 100644 --- a/translations/de-DE/content/github/visualizing-repository-data-with-graphs/accessing-basic-repository-data.md +++ b/translations/de-DE/content/github/visualizing-repository-data-with-graphs/accessing-basic-repository-data.md @@ -1,6 +1,6 @@ --- title: Auf grundlegende Daten des Repositorys zugreifen -intro: 'Du kannst grundlegende Informationen über ein Repository anzeigen, beispielsweise über die Aktivität{% if currentVersion == "free-pro-team@latest" %}, den Datenverkehr{% endif %} und die Beitragsaktivitäten des Repositorys.' +intro: 'You can view basic information about a repository, such as the repository''s activity{% if currentVersion == "free-pro-team@latest" %}, traffic,{% endif %} and contribution activity.' mapTopic: true redirect_from: - /articles/accessing-basic-repository-data diff --git a/translations/de-DE/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md b/translations/de-DE/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md index 237dff6cd51f..d14239d94ff0 100644 --- a/translations/de-DE/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md +++ b/translations/de-DE/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md @@ -26,7 +26,8 @@ The dependency graph shows the dependencies{% if currentVersion == "free-pro-tea #### Dependencies view {% if currentVersion == "free-pro-team@latest" %} -Dependencies are grouped by ecosystem. You can expand a dependency to view its dependencies. For dependencies on public repositories hosted on {% data variables.product.product_name %}, you can also click a dependency to view the repository. Dependencies on private repositories, private packages, or unrecognized files are shown in plain text. +Dependencies are grouped by ecosystem. You can expand a dependency to view its dependencies. For dependencies on public repositories hosted on +{% data variables.product.product_name %}, you can also click a dependency to view the repository. Dependencies on private repositories, private packages, or unrecognized files are shown in plain text. If vulnerabilities have been detected in the repository, these are shown at the top of the view for users with access to {% data variables.product.prodname_dependabot_alerts %}. @@ -35,7 +36,8 @@ If vulnerabilities have been detected in the repository, these are shown at the {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %} -Any direct and indirect dependencies that are specified in the repository's manifest or lock files are listed, grouped by ecosystem. If vulnerabilities have been detected in the repository, these are shown at the top of the view for users with access to {% data variables.product.prodname_dependabot_short %} alerts. +Any direct and indirect dependencies that are specified in the repository's manifest or lock files are listed, grouped by ecosystem. If vulnerabilities have been detected in the repository, these are shown at the top of the view for users with access to +{% data variables.product.prodname_dependabot_short %} alerts. {% note %} @@ -98,14 +100,15 @@ You can disable the dependency graph at any time by clicking **Disable** next to If your dependency graph is empty, there may be a problem with the file containing your dependencies. Check the file to ensure that it's correctly formatted for the file type. {% if currentVersion == "free-pro-team@latest" %} -If the file is correctly formatted, then check its size. The dependency graph ignores individual manifest and lock files that are over 0.5 Mb, unless you are a {% data variables.product.prodname_enterprise %} user. It processes up to 20 manifest or lock files per repository by default, so you can split dependencies into smaller files in subdirectories of the repository.{% endif %} +If the file is correctly formatted, then check its size. The dependency graph ignores individual manifest and lock files that are over 0.5 Mb, unless you are a +{% data variables.product.prodname_enterprise %} user. It processes up to 20 manifest or lock files per repository by default, so you can split dependencies into smaller files in subdirectories of the repository.{% endif %} If a manifest or lock file is not processed, its dependencies are omitted from the dependency graph and they can't be checked for vulnerable dependencies. ### Weiterführende Informationen - "[About the dependency graph](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)"{% if currentVersion == "free-pro-team@latest" %} -- "[Viewing insights for your organization](/github/setting-up-and-managing-organizations-and-teams/viewing-insights-for-your-organization)" +- „[Einblicke für Ihre Organisation anzeigen ](/github/setting-up-and-managing-organizations-and-teams/viewing-insights-for-your-organization)“ - „[Angreifbare Abhängigkeiten in Ihrem Repository anzeigen und aktualisieren](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)“ - „[Grundlegendes zur Verwendung und zum Schutz Ihrer Daten durch {% data variables.product.product_name %}](/github/understanding-how-github-uses-and-protects-your-data)“ {% endif %} diff --git a/translations/de-DE/content/github/visualizing-repository-data-with-graphs/listing-the-forks-of-a-repository.md b/translations/de-DE/content/github/visualizing-repository-data-with-graphs/listing-the-forks-of-a-repository.md index dce76b4b6c02..31d9ec964eb8 100644 --- a/translations/de-DE/content/github/visualizing-repository-data-with-graphs/listing-the-forks-of-a-repository.md +++ b/translations/de-DE/content/github/visualizing-repository-data-with-graphs/listing-the-forks-of-a-repository.md @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -Die Forks sind alphabetisch nach dem Benutzernamen der Person geordnet, die das Repository geforkt hat. Du kannst auf den Benutzernamen klicken, um zur {% data variables.product.product_name %}-Profilseite des Benutzers weitergeleitet zu werden, oder auf den Fork-Namen, um zum entsprechenden Fork des Repositorys weitergeleitet zu werden. +Die Forks sind alphabetisch nach dem Benutzernamen der Person geordnet, die das Repository geforkt hat. Sie können auf den Benutzernamen klicken, um zur {% data variables.product.product_name %}-Profilseite des Benutzers weitergeleitet zu werden, oder auf den Forknamen, um zum entsprechenden Fork des Repositorys weitergeleitet zu werden. {% if currentVersion == "free-pro-team@latest" %} diff --git a/translations/de-DE/content/github/visualizing-repository-data-with-graphs/understanding-connections-between-repositories.md b/translations/de-DE/content/github/visualizing-repository-data-with-graphs/understanding-connections-between-repositories.md index 50385a49c905..b7ff042dd6a7 100644 --- a/translations/de-DE/content/github/visualizing-repository-data-with-graphs/understanding-connections-between-repositories.md +++ b/translations/de-DE/content/github/visualizing-repository-data-with-graphs/understanding-connections-between-repositories.md @@ -1,6 +1,6 @@ --- title: Verbindungen zwischen Repositorys verstehen -intro: 'Die Verbindungen zwischen Repositorys kannst Du besser verstehen, wenn Du Dir das Netzwerk{% if currentVersion == "free-pro-team@latest" %}, die vom Repository abhängigen Projekte{% endif %} und die Repository-Forks ansiehst.' +intro: 'You can better understand the connections that exist between repositories by viewing a repository''s network{% if currentVersion == "free-pro-team@latest" %}, projects that depend on the repository,{% endif %} and its forks.' mapTopic: true redirect_from: - /articles/understanding-connections-between-repositories diff --git a/translations/de-DE/content/github/visualizing-repository-data-with-graphs/viewing-a-projects-contributors.md b/translations/de-DE/content/github/visualizing-repository-data-with-graphs/viewing-a-projects-contributors.md index 99e6dce9edc7..8a5e0bbb8d9b 100644 --- a/translations/de-DE/content/github/visualizing-repository-data-with-graphs/viewing-a-projects-contributors.md +++ b/translations/de-DE/content/github/visualizing-repository-data-with-graphs/viewing-a-projects-contributors.md @@ -1,6 +1,6 @@ --- title: Mitwirkende eines Projekts anzeigen -intro: 'Du kannst anzeigen, wer Commits zu einem Repository{% if currentVersion == "free-pro-team@latest" %} und seinen Abhängigkeiten{% endif %} beigetragen hat.' +intro: 'You can see who contributed commits to a repository{% if currentVersion == "free-pro-team@latest" %} and its dependencies{% endif %}.' redirect_from: - /articles/i-don-t-see-myself-in-the-contributions-graph/ - /articles/viewing-contribution-activity-in-a-repository/ @@ -13,7 +13,7 @@ versions: ### Informationen zu Mitarbeitern -Im Mitarbeiterdiagramm kannst Du die Top 100 der Mitarbeiter an einem Repository anzeigen{% if currentVersion != "free-pro-team@latest" %}, darunter auch die Commit-Co-Autoren{% endif %}. Merge- und leere Commits werden für dieses Diagramm nicht als Beiträge gezählt. +You can view the top 100 contributors to a repository{% if currentVersion != "free-pro-team@latest" %}, including commit co-authors,{% endif %} in the contributors graph. Merge- und leere Commits werden für dieses Diagramm nicht als Beiträge gezählt. {% if currentVersion == "free-pro-team@latest" %} Darüber hinaus kannst Du eine Liste der Personen anzeigen, die Beiträge zu den Python-Abhängigkeiten des Projekts geliefert haben. Rufe `https://github.com/REPO-OWNER/REPO-NAME/community_contributors` auf, um auf diese Liste der Community-Mitarbeiter zuzugreifen. diff --git a/translations/de-DE/content/github/visualizing-repository-data-with-graphs/viewing-traffic-to-a-repository.md b/translations/de-DE/content/github/visualizing-repository-data-with-graphs/viewing-traffic-to-a-repository.md index 7334f6f92220..5597ba968207 100644 --- a/translations/de-DE/content/github/visualizing-repository-data-with-graphs/viewing-traffic-to-a-repository.md +++ b/translations/de-DE/content/github/visualizing-repository-data-with-graphs/viewing-traffic-to-a-repository.md @@ -1,6 +1,6 @@ --- -title: Traffic zu einem Repository anzeigen -intro: 'Personen mit Push-Zugriff auf ein Repository können den zugehörigen Traffic anzeigen, darunter die vollständigen Klone (keine Abrufe), die Besucher der letzten 14 Tage, die verweisenden Websites und die beliebten Inhalte im Traffic-Diagramm.' +title: Viewing traffic to a repository +intro: 'Anyone with push access to a repository can view its traffic, including full clones (not fetches), visitors from the past 14 days, referring sites, and popular content in the traffic graph.' product: 'This repository insights graph is available in public repositories with {% data variables.product.prodname_free_user %} and {% data variables.product.prodname_free_team %} for organizations, and in public and private repositories with {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, and {% data variables.product.prodname_ghe_cloud %}.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[About repository graphs](/articles/about-repository-graphs)" and "[{% data variables.product.prodname_dotcom %}''s products](/articles/github-s-products)."{% endif %}' redirect_from: - /articles/viewing-traffic-to-a-repository @@ -8,20 +8,21 @@ versions: free-pro-team: '*' --- -Du kannst zu den verweisenden Websites, mit Ausnahme der Suchmaschinen und {% data variables.product.product_name %} selbst, über die Links navigieren, von denen aus auf die spezifischen Pfade verwiesen wurde. Der beliebte Inhalt wird mit dem spezifischen Inhalt verknüpft, der Traffic generiert hat. +You can navigate to referring sites, excluding search engines and {% data variables.product.product_name %} itself, from the links the specific paths were referred from. The popular content links to the specific content that generated traffic. -Verweisende Websites und beliebte Inhalte sind nach Ansichten und eindeutigen Besuchern sortiert. Informationen zu vollständigen Klonen und Besuchern werden stündlich aktualisiert. Demgegenüber werden die Abschnitte zu verweisenden Websites und beliebten Inhalten täglich aktualisiert. Alle Daten im Traffic-Diagramm verwenden unabhängig von Deinem Standort die Zeitzone UTC+0. +Referring sites and popular content are ordered by views and unique visitors. Full clones and visitor information update hourly, while referring sites and popular content sections update daily. All data in the traffic graph uses the UTC+0 timezone, regardless of your location. {% tip %} -**Tipp:** Du kannst den Mauszeiger über einen bestimmten Tag im Traffic-Diagramm bewegen, um die exakten Daten für den jeweiligen Tag anzuzeigen. +**Tip:** You can hover over a specific day in the traffic graph to view the exact data for that day. {% endtip %} -![Repository-Traffic-Diagramm mit QuickInfo](/assets/images/help/graphs/repo_traffic_graphs_tooltip_dotcom.png) +![Repository traffic graphs with tooltip](/assets/images/help/graphs/repo_traffic_graphs_tooltip_dotcom.png) -### Auf das Traffic-Diagramm zugreifen +### Accessing the traffic graph {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.accessing-repository-graphs %} -3. Klicke auf der linken Seitenleiste auf **Traffic**. ![Registerkarte „Traffic“](/assets/images/help/graphs/traffic_tab.png) +3. In the left sidebar, click **Traffic**. +![Traffic tab](/assets/images/help/graphs/traffic_tab.png) diff --git a/translations/de-DE/content/github/visualizing-repository-data-with-graphs/visualizing-commits-in-a-repository.md b/translations/de-DE/content/github/visualizing-repository-data-with-graphs/visualizing-commits-in-a-repository.md index f3163a5e9790..e73e6fd93c36 100644 --- a/translations/de-DE/content/github/visualizing-repository-data-with-graphs/visualizing-commits-in-a-repository.md +++ b/translations/de-DE/content/github/visualizing-repository-data-with-graphs/visualizing-commits-in-a-repository.md @@ -1,6 +1,6 @@ --- title: Commits in einem Repository visualisieren -intro: 'Im Commit-Diagramm kannst Du mit Ausnahme von Merge-Commits alle Commits anzeigen, die im vergangenen Jahr an einem Repository vorgenommen wurden.' +intro: Im Commit-Diagramm kannst Du mit Ausnahme von Merge-Commits alle Commits anzeigen, die im vergangenen Jahr an einem Repository vorgenommen wurden. product: '{% data reusables.gated-features.repository-insights %}' redirect_from: - /articles/visualizing-commits-in-a-repository diff --git a/translations/de-DE/content/github/working-with-github-pages/about-custom-domains-and-github-pages.md b/translations/de-DE/content/github/working-with-github-pages/about-custom-domains-and-github-pages.md index ed58c7985b58..c2519327ff65 100644 --- a/translations/de-DE/content/github/working-with-github-pages/about-custom-domains-and-github-pages.md +++ b/translations/de-DE/content/github/working-with-github-pages/about-custom-domains-and-github-pages.md @@ -51,7 +51,7 @@ Eine Apex-Domäne wird mit einem `A`-, `ALIAS`- oder `ANAME`-Eintrag über Deine ### Benutzerdefinierte Domänen aktualisieren, wenn Deine {% data variables.product.prodname_pages %}-Website deaktiviert ist -Wenn Deine {% data variables.product.prodname_pages %}-Website deaktiviert ist, aber eine benutzerdefinierte Domäne für sie eingerichtet wurde, solltest Du den DNS-Eintrag bei Deinem DNS-Provider umgehend aktualisieren oder entfernen, um eine Domänen-Übernahme zu verhindern. Wenn Du eine benutzerdefinierte Domäne bei Deinem DNS-Provider konfigurierst, während Deine Website deaktiviert ist, könnte ein Dritter eine Website auf einer Deiner Subdomänen hosten. Weitere Informationen findest Du unter „[Eine benutzerdefinierte Domäne für Deine {% data variables.product.prodname_pages %}-Website verwalten](/articles/managing-a-custom-domain-for-your-github-pages-site).“ +Wenn Ihre {% data variables.product.prodname_pages %}-Website deaktiviert ist, aber eine benutzerdefinierte Domain für sie eingerichtet wurde, sollten sie den DNS-Eintrag bei Ihrem DNS-Provider umgehend aktualisieren oder entfernen, um eine Domain-Übernahme zu verhindern. Wenn Du eine benutzerdefinierte Domäne bei Deinem DNS-Provider konfigurierst, während Deine Website deaktiviert ist, könnte ein Dritter eine Website auf einer Deiner Subdomänen hosten. Weitere Informationen findest Du unter „[Eine benutzerdefinierte Domäne für Deine {% data variables.product.prodname_pages %}-Website verwalten](/articles/managing-a-custom-domain-for-your-github-pages-site).“ Es gibt mehrere Gründe, weshalb Deine Website automatisch deaktiviert sein könnte. diff --git a/translations/de-DE/content/github/working-with-github-pages/about-github-pages-and-jekyll.md b/translations/de-DE/content/github/working-with-github-pages/about-github-pages-and-jekyll.md index 064230dd8423..61fecdea9787 100644 --- a/translations/de-DE/content/github/working-with-github-pages/about-github-pages-and-jekyll.md +++ b/translations/de-DE/content/github/working-with-github-pages/about-github-pages-and-jekyll.md @@ -69,15 +69,16 @@ Du kannst `site.github` zu einem Beitrag oder einer Seite hinzufügen, um Reposi {% data reusables.pages.add-jekyll-theme %} Weitere Informationen findest Du unter „[Themes](https://jekyllrb.com/docs/themes/)“ (Designs) in der Jekyll-Dokumentation. {% if currentVersion == "free-pro-team@latest" %} -Du kannst zu Deiner Website auf {% data variables.product.prodname_dotcom %} ein unterstütztes Design hinzufügen. Weitere Informationen findest Du unter „[Unterstützte Designs](https://pages.github.com/themes/)“ auf der {% data variables.product.prodname_pages %}-Website und unter „[Ein Design mit dem Theme-Chooser zur {% data variables.product.prodname_pages %}-Website hinzufügen](/articles/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser).“ +You can add a supported theme to your site on +{% data variables.product.prodname_dotcom %}. Weitere Informationen findest Du unter „[Unterstützte Designs](https://pages.github.com/themes/)“ auf der {% data variables.product.prodname_pages %}-Website und unter „[Ein Design mit dem Theme-Chooser zur {% data variables.product.prodname_pages %}-Website hinzufügen](/articles/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser).“ -Um ein anderes Open-Source-Jekyll-Design zu verwenden, das auf {% data variables.product.prodname_dotcom %} gehostet wird, kannst Du das Design manuell hinzufügen.{% else %} Du kannst eine Design manuell zu Deiner Website hinzufügen.{% endif %} Weitere Informationen findest Du unter{% if currentVersion == "free-pro-team@latest" %} „[Auf {% data variables.product.prodname_dotcom %} gehostete Designs](https://github.com/topics/jekyll-theme)“ und{% else %} „[Unterstützte Designs](https://pages.github.com/themes/)“ auf der {% data variables.product.prodname_pages %}-Website und{% endif %} „[Ein Design zu Deiner {% data variables.product.prodname_pages %}-Website mit Jekyll hinzufügen](/articles/adding-a-theme-to-your-github-pages-site-using-jekyll).“ +To use any other open source Jekyll theme hosted on {% data variables.product.prodname_dotcom %}, you can add the theme manually.{% else %} You can add a theme to your site manually.{% endif %} For more information, see{% if currentVersion == "free-pro-team@latest" %} [themes hosted on {% data variables.product.prodname_dotcom %}](https://github.com/topics/jekyll-theme) and{% else %} "[Supported themes](https://pages.github.com/themes/)" on the {% data variables.product.prodname_pages %} site and{% endif %} "[Adding a theme to your {% data variables.product.prodname_pages %} site using Jekyll](/articles/adding-a-theme-to-your-github-pages-site-using-jekyll)." Du kannst alle Standardeinstellungen Deines Designs überschreiben, indem Du die Dateien des Designs bearbeitest. Weitere Informationen findest Du in der Dokumentation zu Deinem Design und unter „[Overriding your theme's defaults](https://jekyllrb.com/docs/themes/#overriding-theme-defaults)“ (Standardeinstellungen Deines Designs überschreiben) in der Jekyll-Dokumentation. ### Plug-ins -Du kannst Jekyll-Plug-ins herunterladen oder erstellen, um die Funktionalität von Jekyll für Deine Website zu erweitern. Mit dem Plugin [jemoji](https://github.com/jekyll/jemoji) kannst Du beispielsweise {% data variables.product.prodname_dotcom %}-Emojis auf allen Seiten Deiner Website genauso verwenden wie auf {% data variables.product.prodname_dotcom %}. Weitere Informationen findest Du unter „[Plugins](https://jekyllrb.com/docs/plugins/)“ (Plug-ins) in der Jekyll-Dokumentation. +Du kannst Jekyll-Plug-ins herunterladen oder erstellen, um die Funktionalität von Jekyll für Deine Website zu erweitern. Mit dem Plugin [jemoji](https://github.com/jekyll/jemoji) können Sie beispielsweise {% data variables.product.prodname_dotcom %}-Emojis auf allen Seiten Ihrer Website genauso verwenden wie auf {% data variables.product.prodname_dotcom %}. Weitere Informationen findest Du unter „[Plugins](https://jekyllrb.com/docs/plugins/)“ (Plug-ins) in der Jekyll-Dokumentation. {% data variables.product.prodname_pages %} verwendet Plug-ins, die standardmäßig aktiviert sind und nicht deaktiviert werden können: - [`jekyll-coffeescript`](https://github.com/jekyll/jekyll-coffeescript) @@ -96,15 +97,15 @@ Informationen zur Verwendung eines bestimmten Plug-ins findest Du in der dazugeh {% tip %} -**Tipp:** Um sicherzustellen, dass Du die aktuellen Versionen aller Plug-ins verwendest, solltest Du die {% data variables.product.prodname_pages %}-Gem regelmäßig aktualisieren. Weitere Informationen findest Du unter „[GitHub Pages-Website lokal mit Jekyll testen](/articles/testing-your-github-pages-site-locally-with-jekyll#updating-the-github-pages-gem)“ und „[Abhängigkeitsversionen](https://pages.github.com/versions/)“ auf der {% data variables.product.prodname_pages %}-Website. +**Tipp:** Um sicherzustellen, dass Sie die aktuellen Versionen aller Plug-ins verwenden, sollten Sie die {% data variables.product.prodname_pages %}-Gem regelmäßig aktualisieren. Weitere Informationen findest Du unter „[GitHub Pages-Website lokal mit Jekyll testen](/articles/testing-your-github-pages-site-locally-with-jekyll#updating-the-github-pages-gem)“ und „[Abhängigkeitsversionen](https://pages.github.com/versions/)“ auf der {% data variables.product.prodname_pages %}-Website. {% endtip %} -{% data variables.product.prodname_pages %} kann keine Websites mit nicht unterstützten Plug-ins erstellen. Wenn Du nicht unterstützte Plug-ins verwenden möchtest, musst Du Deine Website lokal erstellen und die statischen Dateien der Website anschließend zu {% data variables.product.product_name %} übertragen. +{% data variables.product.prodname_pages %} kann keine Websites mit nicht unterstützten Plug-ins erstellen. Wenn Sie nicht unterstützte Plug-ins verwenden möchten, müssen Sie Ihre Website lokal erstellen und die statischen Dateien der Website anschließend zu {% data variables.product.product_name %} pushen. ### Syntaxmarkierung -Damit Deine Website leichter lesbar ist, werden Code-Ausschnitte auf {% data variables.product.prodname_pages %}-Websites ebenso markiert wie auf {% data variables.product.product_name %}. Weitere Informationen zur Syntaxmarkierung auf {% data variables.product.product_name %} findest Du unter „[Codeblöcke erstellen und markieren](/articles/creating-and-highlighting-code-blocks).“ +Damit Ihre Website leichter lesbar ist, werden Code-Ausschnitte auf {% data variables.product.prodname_pages %}-Websites ebenso markiert wie auf {% data variables.product.product_name %}. Weitere Informationen zur Syntaxmarkierung auf {% data variables.product.product_name %} findest Du unter „[Codeblöcke erstellen und markieren](/articles/creating-and-highlighting-code-blocks).“ Standardmäßig werden Codeblöcke auf Deiner Website von Jekyll markiert. Jekyll verwendet den Markierer [Rouge](https://github.com/jneen/rouge), der mit [Pygments](http://pygments.org/) kompatibel ist. Wenn Du in Deiner *_config.yml*-Datei Pygments spezifizierst, wird stattdessen Rouge verwendet. Jekyll kann keinen anderen Syntaxmarkierer verwenden. Wenn Du einen anderen Syntaxmarkierer in der *_config.yml*-Datei angibst, wird eine Build-Warnung für die Website angezeigt. Weitere Informationen findest Du unter „[Informationen zu Jekyll-Build-Fehler für {% data variables.product.prodname_pages %}-Websites](/articles/about-jekyll-build-errors-for-github-pages-sites).“ @@ -116,7 +117,7 @@ kramdown: disable : true ``` -Wenn Dein Design kein CSS für die Syntaxmarkierung enthält, kannst Du das CSS von {% data variables.product.prodname_dotcom %} zur Syntaxmarkierung erzeugen und zur Datei `style.css` des Projekts hinzufügen. +Wenn Ihr Design kein CSS für die Syntaxmarkierung enthält, können Sie das CSS von {% data variables.product.prodname_dotcom %} zur Syntaxmarkierung erzeugen und zur Datei `style.css` des Projekts hinzufügen. ```shell $ rougify style github > style.css diff --git a/translations/de-DE/content/github/working-with-github-pages/about-github-pages.md b/translations/de-DE/content/github/working-with-github-pages/about-github-pages.md index 5ee0fe99100c..bbd5628279f0 100644 --- a/translations/de-DE/content/github/working-with-github-pages/about-github-pages.md +++ b/translations/de-DE/content/github/working-with-github-pages/about-github-pages.md @@ -1,6 +1,6 @@ --- title: Informationen zu GitHub Pages -intro: 'Mit {% data variables.product.prodname_pages %} kannst Du eine Website zu Deiner Person, Deiner Organisation oder Deinem Projekt direkt aus einem {% data variables.product.product_name %}-Repository hosten.' +intro: 'Mit {% data variables.product.prodname_pages %} können Sie eine Website zu Ihrer Person, Ihrer Organisation oder Ihrem Projekt direkt aus einem {% data variables.product.product_name %}-Repository hosten.' redirect_from: - /articles/what-are-github-pages/ - /articles/what-is-github-pages/ @@ -20,31 +20,34 @@ versions: {% data variables.product.prodname_pages %} ist ein Hosting-Dienst für statische Websites, der HTML-, CSS- und JavaScript-Dateien direkt aus einem Repository auf {% data variables.product.product_name %} bezieht, diese Dateien optional einem Build-Prozess unterzieht und eine Website veröffentlicht. Beispiele für {% data variables.product.prodname_pages %}-Websites findest Du in der [{% data variables.product.prodname_pages %}-Beispielsammlung](https://github.com/collections/github-pages-examples). {% if currentVersion == "free-pro-team@latest" %} -Du kannst Deine Website auf der Domäne `github.io` von {% data variables.product.prodname_dotcom %} oder Deiner eigenen benutzerdefinierten Domäne hosten. Weitere Informationen findest Du unter „[Eine benutzerdefinierte Domäne mit {% data variables.product.prodname_pages %} verwenden](/articles/using-a-custom-domain-with-github-pages).“ +You can host your site on +{% data variables.product.prodname_dotcom %}'s `github.io` domain or your own custom domain. Weitere Informationen finden Sie unter „[Eine benutzerdefinierte Domain mit {% data variables.product.prodname_pages %} verwenden](/articles/using-a-custom-domain-with-github-pages)“. {% endif %} Informationen zu den ersten Schritten findest Du unter „[Eine {% data variables.product.prodname_pages %}-Website erstellen](/articles/creating-a-github-pages-site).“ {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -Organization owners can disable the publication of {% data variables.product.prodname_pages %} sites from the organization's repositories. For more information, see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)." +Organization owners can disable the publication of +{% data variables.product.prodname_pages %} sites from the organization's repositories. For more information, see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)." {% endif %} ### Arten von {% data variables.product.prodname_pages %}-Websites Es gibt drei Arten von {% data variables.product.prodname_pages %}-Websites: Projekt-, Benutzer- und Organisations-Websites. Projekt-Websites sind mit einem bestimmten Projekt verbunden, das auf {% data variables.product.product_name %} gehostet wird, z. B. einer JavaScript-Bibliothek oder einer Rezeptsammlung. Benutzer- und Organisations-Websites sind mit einem bestimmten {% data variables.product.product_name %}-Konto verbunden. -Um eine Benutzerwebsite zu veröffentlichen, musst Du ein Repository erstellen, das Deinem Benutzerkonto gehört und den Namen {% if currentVersion == "free-pro-team@latest" %}`.github.io`{% else %}`.`{% endif %} hat. Um eine Organisations-Website zu veröffentlichen, musst du ein Repository erstellen, das einer Organisation gehört, die {% if currentVersion == "free-pro-team@latest" %}`.github.io`{% else %}`.`{% endif %} heißt. {% if currentVersion == "free-pro-team@latest" %}Wenn Du keine benutzerdefinierte Domäne verwendest, sind Benutzer- und Organisations-Websites unter `http(s)://.github.io` oder `http(s)://.github.io` erreichbar.{% endif %} +To publish a user site, you must create a repository owned by your user account that's named {% if currentVersion == "free-pro-team@latest" %}`.github.io`{% else %}`.`{% endif %}. To publish an organization site, you must create a repository owned by an organization that's named {% if currentVersion == "free-pro-team@latest" %}`.github.io`{% else %}`.`{% endif %}. {% if currentVersion == "free-pro-team@latest" %}Unless you're using a custom domain, user and organization sites are available at `http(s)://.github.io` or `http(s)://.github.io`.{% endif %} -Die Quelldateien für eine Projekt-Website werden im selben Repository gespeichert wie das zugehörige Projekt. {% if currentVersion == "free-pro-team@latest" %}Wenn Du keine benutzerdefinierte Domäne verwendest, sind Projekt-Websites unter `http(s)://.github.io/` oder `http(s)://.github.io/` erreichbar.{% endif %} +Die Quelldateien für eine Projekt-Website werden im selben Repository gespeichert wie das zugehörige Projekt. {% if currentVersion == "free-pro-team@latest" %}Unless you're using a custom domain, project sites are available at `http(s)://.github.io/` or `http(s)://.github.io/`.{% endif %} {% if currentVersion == "free-pro-team@latest" %} -Weitere Informationen dazu, wie sich die URL Deiner Website bei benutzerdefinierten Domänen ändert, findest Du unter „[Informationen zu benutzerdefinierten Domänen und {% data variables.product.prodname_pages %}](/articles/about-custom-domains-and-github-pages).“ +Weitere Informationen dazu, wie sich die URL Ihrer Website bei benutzerdefinierten Domains ändert, finden Sie unter „[Informationen zu benutzerdefinierten Domains und {% data variables.product.prodname_pages %}](/articles/about-custom-domains-and-github-pages)“. {% endif %} -Du kannst für jedes {% data variables.product.product_name %}-Konto nur eine Benutzer- oder Organisations-Website erstellen. Für Projekt-Websites gibt es keine Beschränkung, egal, ob sie einer Organisation oder einem Benutzerkonto gehören. +Sie können für jedes {% data variables.product.product_name %}-Konto nur eine Benutzer- oder Organisations-Website erstellen. Für Projekt-Websites gibt es keine Beschränkung, egal, ob sie einer Organisation oder einem Benutzerkonto gehören. {% if currentVersion != "free-pro-team@latest" %} -Unter welcher URL Deine Website erreichbar ist, hängt davon ab, ob die Subdomänen-Isolation für {% data variables.product.product_location %} aktiviert ist. +The URL where your site is available depends on whether subdomain isolation is enabled for +{% data variables.product.product_location %}. | Art der Website | Subdomänen-Isolation aktiviert | Subdomänen-Isolation deaktiviert | | --------------- | ------------------------------ | -------------------------------- | @@ -86,7 +89,7 @@ Die standardmäßige Veröffentlichungsquelle für Projekt-Websites ist der `gh- Du kannst Projekt-Websites auch vom `master`-Branch oder einem `/docs`-Ordner auf dem `master`-Branch veröffentlichen. Um Deine Website aus einer dieser Quellen zu veröffentlichen, musst Du eine andere Veröffentlichungsquelle konfigurieren. Weitere Informationen findest Du unter „[Eine Veröffentlichungsquelle für Deine {% data variables.product.prodname_pages %}-Website konfigurieren](/articles/configuring-a-publishing-source-for-your-github-pages-site#choosing-a-publishing-source).“ - Wenn Du den `/docs`-Ordner des `master`-Branches als Veröffentlichungsquelle auswählst, liest {% data variables.product.prodname_pages %} alle Informationen, die zum Veröffentlichen Deiner Website erforderlich sind,{% if currentVersion == "free-pro-team@latest" %}, einschließlich der _CNAME_-Datei,{% endif %} aus dem `/docs`-Ordner.{% if currentVersion == "free-pro-team@latest" %} Wenn Du beispielsweise Deine benutzerdefinierte Domäne in den {% data variables.product.prodname_pages %}-Einstellungen bearbeitest, schreibt die benutzerdefinierte Domäne in `/docs/CNAME`. Weitere Informationen zu _CNAME_-Dateien findest Du unter „[Eine benutzerdefinierte Domäne für Deine {% data variables.product.prodname_pages %}-Website verwalten](/articles/managing-a-custom-domain-for-your-github-pages-site)“.{% endif %} + If you choose the `/docs` folder of the `master` branch as your publishing source, {% data variables.product.prodname_pages %} will read everything to publish your site{% if currentVersion == "free-pro-team@latest" %}, including the _CNAME_ file,{% endif %} from the `/docs` folder.{% if currentVersion == "free-pro-team@latest" %} For example, when you edit your custom domain through the {% data variables.product.prodname_pages %} settings, the custom domain will write to `/docs/CNAME`. Weitere Informationen zu _CNAME_-Dateien findest Du unter „[Eine benutzerdefinierte Domäne für Deine {% data variables.product.prodname_pages %}-Website verwalten](/articles/managing-a-custom-domain-for-your-github-pages-site)“.{% endif %} Du kannst Deine Projekt-Website nicht aus einem anderen Branch veröffentlichen, auch wenn der Standard-Branch nicht `Master` oder `gh-pages` ist. @@ -94,7 +97,7 @@ Du kannst Projekt-Websites auch vom `master`-Branch oder einem `/docs`-Ordner au ### Generatoren für statische Websites -{% data variables.product.prodname_pages %} veröffentlicht alle statische Dateien, die Sie zu Ihrem Repository pushen. Sie können eigene statische Dateien erstellen oder einen Generator für statische Websites verwenden, der die Website für Sie erstellt. Darüber hinaus können Sie Ihren eigenen Build-Prozess lokal oder auf einem anderen Server anpassen. Wir empfehlen Jekyll, einen Generator für statische Websites mit integrierter Unterstützung von {% data variables.product.prodname_pages %} und einem vereinfachten Build-Prozess. Weitere Informationen findest Du unter „[Informationen zu {% data variables.product.prodname_pages %} und Jekyll](/articles/about-github-pages-and-jekyll).“ +{% data variables.product.prodname_pages %} veröffentlicht alle statische Dateien, die Sie zu Ihrem Repository pushen. Sie können eigene statische Dateien erstellen oder einen Generator für statische Websites verwenden, der die Website für Sie erstellt. Darüber hinaus können Sie Ihren eigenen Build-Prozess lokal oder auf einem anderen Server anpassen. Wir empfehlen Jekyll, einen Generator für statische Websites mit integrierter Unterstützung von {% data variables.product.prodname_pages %} und einem vereinfachten Build-Prozess. Weitere Informationen finden Sie unter „[Informationen zu {% data variables.product.prodname_pages %} und Jekyll](/articles/about-github-pages-and-jekyll)“. {% data variables.product.prodname_pages %} verwendet standardmäßig Jekyll für die Erstellung Ihrer Website. Wenn Sie einen anderen Generator für statische Websites als Jekyll verwenden möchten, müssen Sie den Jekyll-Build-Prozess deaktivieren. Erstellen Sie dazu im Root Ihrer Veröffentlichungsquelle eine leere Datei mit dem Namen `.nojekyll` und folgen den Anweisungen des gewünschten Generators, um Ihre Website lokal zu erstellen. @@ -105,23 +108,23 @@ Du kannst Projekt-Websites auch vom `master`-Branch oder einem `/docs`-Ordner au {% if currentVersion == "free-pro-team@latest" %} - {% data variables.product.prodname_pages %}-Websites, die nach dem 15. Juni 2016 und mittels `github.io`-Domains erstellt wurden, werden über HTTPS bereitgestellt. Wenn Du Deine Website vor dem 15. Juni 2016 erstellt hast, kannst Du die HTTPS-Unterstützung für den Traffic zu Deiner Website aktivieren. Weitere Informationen findest Du unter „[{% data variables.product.prodname_pages %}-Website mit HTTPS schützen](/articles/securing-your-github-pages-site-with-https).“ - {% data reusables.pages.no_sensitive_data_pages %} -- Deine Nutzung von {% data variables.product.prodname_pages %} unterliegt den [GitHub-Nutzungsbedingungen](/articles/github-terms-of-service/), einschließlich des Weiterverkaufsverbots. +- Ihre Nutzung von {% data variables.product.prodname_pages %} unterliegt den [GitHub-Nutzungsbedingungen](/articles/github-terms-of-service/), einschließlich des Weiterverkaufsverbots. #### Nutzungseinschränkungen {% endif %} {% data variables.product.prodname_pages %} unterliegen den folgenden Nutzungseinschränkungen: - - Für {% data variables.product.prodname_pages %}-Quell-Repositorys gilt eine empfohlene Beschränkung von 1 GB.{% if currentVersion == "free-pro-team@latest" %} Weitere Informationen findest Du unter „[Wie lautet mein Disk-Kontingent?](/articles/what-is-my-disk-quota/#file-and-repository-size-limitations)“{% endif %} + - {% data variables.product.prodname_pages %} source repositories have a recommended limit of 1GB.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[What is my disk quota?"](/articles/what-is-my-disk-quota/#file-and-repository-size-limitations){% endif %} - Veröffentlichte {% data variables.product.prodname_pages %}-Websites dürfen nicht größer als 1 GB sein. {% if currentVersion == "free-pro-team@latest" %} - - {% data variables.product.prodname_pages %}-Websites besitzen eine *weiche* Bandbreitenbegrenzung von 100 GB pro Monat. - - {% data variables.product.prodname_pages %}-Websites besitzen eine *weiche* Begrenzung von 10 Builds pro Stunde. + - {% data variables.product.prodname_pages %} sites have a *soft* bandwidth limit of 100GB per month. + - {% data variables.product.prodname_pages %} sites have a *soft* limit of 10 builds per hour. Wenn Ihre Website diese Nutzungskontingente überschreitet, kann Ihre Website ggf. nicht bedient werden oder Sie erhalten eine höfliche E-Mail von {% data variables.contact.contact_support %}, in der Strategien vorgeschlagen werden, um die Auswirkung Ihrer Website auf unsere Server zu reduzieren. Dazu zählen das Einsetzen eines Drittanbieter-CDNs (Content Distribution Networks) vor Ihrer Website, die Nutzung anderer {% data variables.product.prodname_dotcom %}-Features, beispielsweise Veröffentlichungen, oder der Wechsel zu einem anderen Hosting-Dienst, der ggf. besser zu Ihren Anforderungen passt. #### Verbotene Verwendungen -{% data variables.product.prodname_pages %} soll oder darf nicht als kostenloser Web-Hosting-Dienst zum Betreiben Deiner Online-Geschäfts-, E-Commerce-Website oder jeder anderen Website verwendet werden, die in erster Linie darauf ausgerichtet ist, kommerzielle Transaktionen zu erleichtern oder kommerzielle Software-as-a-Service-Lösungen (SaaS) bereitzustellen. +{% data variables.product.prodname_pages %} soll oder darf nicht als kostenloser Web-Hosting-Dienst zum Betreiben Ihrer Online-Geschäfts-, E-Commerce-Website oder jeder anderen Website verwendet werden, die in erster Linie darauf ausgerichtet ist, kommerzielle Transaktionen zu erleichtern oder kommerzielle Software-as-a-Service-Lösungen (SaaS) bereitzustellen. Zusätzlich darf in {% data variables.product.prodname_pages %}-Websites Folgendes nicht enthalten sein: @@ -132,15 +135,16 @@ Zusätzlich darf in {% data variables.product.prodname_pages %}-Websites Folgend - Schnell-reich-werden-Schemas - Sexuell anstößige Inhalte - Deine Identität oder den Zweck Deiner Website falsch darstellende Inhalte +If you have questions about whether your use or intended use falls into these categories, please contact -Wende Dich an {% data variables.contact.contact_support %}, falls Du Fragen dazu hast, ob Deine Nutzung oder gewünschte Nutzung in eine dieser Kategorien fällt. +{% data variables.contact.contact_support %}. {% endif %} ### MIME-Typen auf {% data variables.product.prodname_pages %} Ein MIME-Typ ist ein Header, den ein Server an einen Browser übermittelt und der Informationen zur Art und zum Format der Dateien enthält, die der Browser angefordert hat. {% data variables.product.prodname_pages %} unterstützt mehr als 750 MIME-Typen bei Tausenden von Dateierweiterungen. Die Liste der unterstützten MIME-Typen wird aus dem [mime-db-Projekt](https://github.com/jshttp/mime-db) erzeugt. -Zwar kannst Du keine benutzerdefinierten MIME-Typen für einzelne Dateien oder Repositorys festlegen, aber Du kannst MIME-Typen für die Verwendung auf {% data variables.product.prodname_pages %} hinzufügen oder ändern. Weitere Informationen findest Du in den [Beitragsrichtlinien für mime-db](https://github.com/jshttp/mime-db#adding-custom-media-types). +Zwar können Sie keine benutzerdefinierten MIME-Typen für einzelne Dateien oder Repositorys festlegen. Sie können jedoch MIME-Typen für die Verwendung auf {% data variables.product.prodname_pages %} hinzufügen oder ändern. Weitere Informationen findest Du in den [Beitragsrichtlinien für mime-db](https://github.com/jshttp/mime-db#adding-custom-media-types). ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md b/translations/de-DE/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md index 428fe68e7238..e87dda546f2c 100644 --- a/translations/de-DE/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md +++ b/translations/de-DE/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md @@ -1,6 +1,6 @@ --- title: Informationen zu Jekyll-Build-Fehler für GitHub Pages-Websites -intro: 'Wenn beim Erstellen Deiner {% data variables.product.prodname_pages %}-Website (lokal oder auf {% data variables.product.product_name %}) mit Jekyll ein Fehler auftritt, erhältst Du eine Fehlermeldung mit weiteren Informationen.' +intro: 'Wenn beim Erstellen Ihrer {% data variables.product.prodname_pages %}-Website (lokal oder auf {% data variables.product.product_name %}) mit Jekyll ein Fehler auftritt, erhalten Sie eine Fehlermeldung mit weiteren Informationen.' redirect_from: - /articles/viewing-jekyll-build-error-messages/ - /articles/generic-jekyll-build-failures/ @@ -13,14 +13,14 @@ versions: ### Informationen zu Jekyll-Build-Fehlern -Manchmal kann es vorkommen, dass {% data variables.product.prodname_pages %} nicht versucht, Deine Website zu erstellen, nachdem Du Änderungen zur Veröffentlichungsquelle Deiner Website übertragen hast.{% if currentVersion == "free-pro-team@latest" %} +Sometimes, {% data variables.product.prodname_pages %} will not attempt to build your site after you push changes to your site's publishing source.{% if currentVersion == "free-pro-team@latest" %} - Der Benutzer, der die Änderungen gepusht hat, hat seine E-Mail-Adresse nicht verifiziert. Weitere Informationen findest Du unter „[Eigene E-Mail-Adresse verifizieren](/articles/verifying-your-email-address)“.{% endif %} - Du führst den Push mit einem Deployment-Schlüssel durch. Wenn Du Übertragungen zum Repository Deiner Website automatisieren möchtest, kannst du stattdessen einen Maschinenbenutzer einrichten. For more information, see "[Managing deploy keys](/v3/guides/managing-deploy-keys/#machine-users)." - Du verwendest einen Dienst für die fortlaufende Integration, der nicht zum Erstellen Deiner Veröffentlichungsquelle konfiguriert ist. Travis CI erstellt beispielsweise nicht den Branch `gh-pages`, es sei denn, Du fügst den Branch zu einer Liste mit sicheren Branches hinzu. Weitere Informationen findest Du unter „[Build anpassen](https://docs.travis-ci.com/user/customizing-the-build/#safelisting-or-blocklisting-branches)“ auf Travis CI oder in der Dokumentation Deines Dienstes für die fortlaufende Integration. {% note %} -**Hinweis:** Es kann bis zu 20 Minuten dauern, bis die Änderungen auf Deiner Website veröffentlicht werden, nachdem Du die Änderungen zu {% data variables.product.product_name %} hinzugefügt hast. +**Hinweis:** Es kann bis zu 20 Minuten dauern, bis die Änderungen auf Ihrer Website veröffentlicht werden, nachdem Sie die Änderungen zu {% data variables.product.product_name %} gepusht haben. {% endnote %} @@ -32,15 +32,13 @@ Weitere Informationen zur Behebung von Build-Fehlern findest Du unter „[Behebu ### Jekyll-Build-Fehlermeldungen anzeigen -Wir empfehlen Dir, Deine Website lokal zu testen. Dadurch siehst Du Build-Fehlermeldungen in der Befehlszeile und kannst Build-Fehler beheben, bevor Du die Änderungen zu {% data variables.product.product_name %} überträgst. Weitere Informationen findest Du unter „[Deine {% data variables.product.prodname_pages %}-Website lokal mit Jekyll testen](/articles/testing-your-github-pages-site-locally-with-jekyll).“ +Wir empfehlen Ihnen, Ihre Website lokal zu testen. Dadurch sehen Sie Build-Fehlermeldungen in der Befehlszeile und können Build-Fehler beheben, bevor Sie die Änderungen zu {% data variables.product.product_name %} pushen. Weitere Informationen findest Du unter „[Deine {% data variables.product.prodname_pages %}-Website lokal mit Jekyll testen](/articles/testing-your-github-pages-site-locally-with-jekyll).“ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -Wenn Du einen Pull Request erstellst, um Deine Veröffentlichungsquelle auf {% data variables.product.product_name %} zu aktualisieren, kannst Du auf der Registerkarte **Checks** (Prüfungen) des Pull Requests die Build-Fehlermeldungen einsehen. Weitere Informationen findest Du unter „[Informationen zu Statuschecks](/articles/about-status-checks).“ -{% endif %} +Wenn Sie einen Pull Request erstellen, um Ihre Veröffentlichungsquelle auf {% data variables.product.product_name %} zu aktualisieren, können Sie auf der Registerkarte **Checks** (Prüfungen) des Pull Requests die Build-Fehlermeldungen einsehen. Weitere Informationen findest Du unter „[Informationen zu Statuschecks](/articles/about-status-checks).“ -Wenn Du Änderungen zu Deiner Veröffentlichungsquelle auf {% data variables.product.product_name %} überträgst, versucht {% data variables.product.prodname_pages %}, Deine Website zu erstellen. Wenn der Build fehlschlägt, wird eine E-Mail an Deine primäre E-Mail-Adresse gesendet. Du erhältst auch bei Build-Warnungen E-Mail-Benachrichtigungen. {% data reusables.pages.build-failure-email-server %} +Wenn Sie Änderungen zu Ihrer Veröffentlichungsquelle auf {% data variables.product.product_name %} pushen, versucht {% data variables.product.prodname_pages %}, Ihre Website zu erstellen. Wenn der Build fehlschlägt, wird eine E-Mail an Deine primäre E-Mail-Adresse gesendet. Du erhältst auch bei Build-Warnungen E-Mail-Benachrichtigungen. {% data reusables.pages.build-failure-email-server %} -Build-Fehler (aber keine Build-Warnungen) für Deine Website kannst Du auf {% data variables.product.product_name %} auf der Registerkarte **Settings** (Einstellungen) des Repositorys Deiner Website sehen. +Build-Fehler (aber keine Build-Warnungen) für Ihre Website können Sie auf {% data variables.product.product_name %} auf der Registerkarte **Settings** (Einstellungen) des Repositorys Ihrer Website sehen. Du kannst einen Drittanbieterdienst, beispielsweise [Travis CI](https://travis-ci.org/), so konfigurieren, dass nach jedem Commit Fehlermeldungen angezeigt werden. diff --git a/translations/de-DE/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md b/translations/de-DE/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md index d17ce241a0a7..5068aefa9438 100644 --- a/translations/de-DE/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md +++ b/translations/de-DE/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md @@ -1,6 +1,6 @@ --- title: Ein Design zur GitHub Pages-Website mit Jekyll hinzufügen -intro: 'Du kannst Deine Jekyll-Website personalisieren, indem Du ein Design hinzufügst und anpasst.' +intro: Du kannst Deine Jekyll-Website personalisieren, indem Du ein Design hinzufügst und anpasst. redirect_from: - /articles/customizing-css-and-html-in-your-jekyll-theme/ - /articles/adding-a-jekyll-theme-to-your-github-pages-site/ @@ -21,9 +21,9 @@ Personen mit Schreibberechtigungen für ein Repository können mit Jekyll ein De {% data reusables.pages.navigate-publishing-source %} 2. Navigiere zur Datei *_config.yml*. {% data reusables.repositories.edit-file %} -4. Füge in der Datei eine neue Zeile mit den Namen des Designs hinzu. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - - Um ein unterstütztes Design zu verwenden, g{% else %}G{% endif %}ib `theme: THEME-NAME` ein und ersetze dabei _THEME-NAME_ durch den Namen des Designs, der in der README-Datei des Repositorys des Designs aufgeführt ist. Eine Liste der unterstützten Designs findest Du unter „[Unterstützte Designs](https://pages.github.com/themes/)“ auf der {% data variables.product.prodname_pages %}-Website. ![Unterstütztes Design in der Konfigurationsdatei](/assets/images/help/pages/add-theme-to-config-file.png){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - - Um ein anderes Jekyll-Design zu verwenden, das auf {% data variables.product.prodname_dotcom %} gehostet wird, gib `remote_theme: THEME-NAME` ein und ersetze dabei „THEME-NAME“ durch den Namen des Designs, der in der README-Datei des Repositorys des Designs aufgeführt ist. ![Nicht unterstütztes Design in der Konfigurationsdatei](/assets/images/help/pages/add-remote-theme-to-config-file.png){% endif %} +4. Füge in der Datei eine neue Zeile mit den Namen des Designs hinzu. + - To use a supported theme, type `theme: THEME-NAME`, replacing _THEME-NAME_ with the name of the theme as shown in the README of the theme's repository. Eine Liste der unterstützten Designs findest Du unter „[Unterstützte Designs](https://pages.github.com/themes/)“ auf der {% data variables.product.prodname_pages %}-Website. ![Supported theme in config file](/assets/images/help/pages/add-theme-to-config-file.png) + - Um ein anderes Jekyll-Design zu verwenden, das auf {% data variables.product.prodname_dotcom %} gehostet wird, gib `remote_theme: THEME-NAME` ein und ersetze dabei „THEME-NAME“ durch den Namen des Designs, der in der README-Datei des Repositorys des Designs aufgeführt ist. ![Unsupported theme in config file](/assets/images/help/pages/add-remote-theme-to-config-file.png) {% data reusables.files.write_commit_message %} {% data reusables.files.choose-commit-email %} {% data reusables.files.choose_commit_branch %} @@ -53,7 +53,7 @@ Personen mit Schreibberechtigungen für ein Repository können mit Jekyll ein De {% data reusables.pages.theme-customization-help %} -1. Navigiere auf {% data variables.product.prodname_dotcom %} zum Quell-Repository Deines Designs. Das Quell-Repository für Minima ist beispielsweise https://github.com/jekyll/minima. +1. Navigieren Sie auf {% data variables.product.prodname_dotcom %} zum Quell-Repository Ihres Designs. Das Quell-Repository für Minima ist beispielsweise https://github.com/jekyll/minima. 2. Navigiere im Ordner *_layouts* (Layouts) zur Datei _default.html_ Deines Designs. 3. Kopiere den Inhalt der Datei. {% data reusables.pages.navigate-site-repo %} diff --git a/translations/de-DE/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser.md b/translations/de-DE/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser.md index 62b32d1d5822..6dbed243c719 100644 --- a/translations/de-DE/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser.md +++ b/translations/de-DE/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser.md @@ -1,6 +1,6 @@ --- title: Ein Design mit dem Theme Chooser zu Deiner GitHub Pages-Website hinzufügen -intro: 'Du kannst zu Deiner {% data variables.product.prodname_pages %}-Website ein Design hinzufügen, um das Aussehen der Website anzupassen.' +intro: 'Sie können zu Ihrer {% data variables.product.prodname_pages %}-Website ein Design hinzufügen, um das Aussehen der Website anzupassen.' redirect_from: - /articles/creating-a-github-pages-site-with-the-jekyll-theme-chooser/ - /articles/adding-a-jekyll-theme-to-your-github-pages-site-with-the-jekyll-theme-chooser/ @@ -21,7 +21,7 @@ Wie der Theme Chooser funktioniert, hängt davon ab, ob Dein Repository öffentl - If your repository is public and {% data variables.product.prodname_pages %} is disabled for your repository, using the theme chooser will enable {% data variables.product.prodname_pages %} and configure the default branch as your publishing source. - Wenn Dein Repository privat und {% data variables.product.prodname_pages %} für Dein Repository deaktiviert ist, musst Du {% data variables.product.prodname_pages %} durch die Konfiguration einer Veröffentlichungsquelle erst aktivieren, bevor Du den Theme Chooser verwenden kannst. -Weitere Informationen zu Veröffentlichungsquellen finden Sie unter „[Informationen zu {% data variables.product.prodname_pages %}](/articles/about-github-pages#publishing-sources-for-github-pages-sites)“. +Weitere Informationen zu Veröffentlichungsquellen findest Du unter „[Informationen zu {% data variables.product.prodname_pages %}](/articles/about-github-pages#publishing-sources-for-github-pages-sites).“ Wenn Du in der Vergangenheit manuell ein Jekyll-Design zu Deinem Repository hinzugefügt hast, werden diese Dateien möglicherweise auch nach der Verwendung des Theme Chooser noch angewendet. Um Konflikte zu vermeiden, solltest Du alle manuell hinzugefügten Design-Ordner und -Dateien entfernen, bevor Du den Theme Chooser verwendest. Weitere Informationen findest Du unter „[Ein Design zur {% data variables.product.prodname_pages %}-Website mit Jekyll hinzufügen](/articles/adding-a-theme-to-your-github-pages-site-using-jekyll).“ diff --git a/translations/de-DE/content/github/working-with-github-pages/adding-content-to-your-github-pages-site-using-jekyll.md b/translations/de-DE/content/github/working-with-github-pages/adding-content-to-your-github-pages-site-using-jekyll.md index d5a52c26d8ea..811f0d0864d6 100644 --- a/translations/de-DE/content/github/working-with-github-pages/adding-content-to-your-github-pages-site-using-jekyll.md +++ b/translations/de-DE/content/github/working-with-github-pages/adding-content-to-your-github-pages-site-using-jekyll.md @@ -1,6 +1,6 @@ --- title: Inhalte zur GitHub Pages-Website mit Jekyll hinzufügen -intro: 'Du kannst Du Deiner Jekyll-Website auf {% data variables.product.prodname_pages %} eine neue Seite oder einen neuen Beitrag hinzufügen.' +intro: 'Sie können zu Ihrer Jekyll-Website auf {% data variables.product.prodname_pages %} eine neue Seite oder einen neuen Beitrag hinzufügen.' product: '{% data reusables.gated-features.pages %}' redirect_from: - /articles/adding-content-to-your-github-pages-site-using-jekyll @@ -13,7 +13,7 @@ Personen mit Schreibberechtigungen für ein Repository können mit Jekyll Inhalt ### Informationen zu Inhalten von Jekyll-Websites -Bevor Du Inhalte zu einer Jekyll-Website auf {% data variables.product.prodname_pages %} hinzufügen kannst, musst Du eine Jekyll-Website erstellen. Weitere Informationen findest Du unter „[Eine {% data variables.product.prodname_pages %}-Website mit Jekyll erstellen](/articles/creating-a-github-pages-site-with-jekyll).“ +Bevor Sie Inhalte zu einer Jekyll-Website auf {% data variables.product.prodname_pages %} hinzufügen können, müssen Sie eine Jekyll-Website erstellen. Weitere Informationen findest Du unter „[Eine {% data variables.product.prodname_pages %}-Website mit Jekyll erstellen](/articles/creating-a-github-pages-site-with-jekyll).“ Die hauptsächlichen Arten von Inhalten für Jekyll-Websites sind Seiten und Beiträge. Eine Seite wird für eigenständige Inhalte genutzt, die nicht mit einem bestimmten Datum verknüpft sind, z. B. eine Seite mit Informationen zu Deiner Person oder Organisation. Die standardmäßige Jekyll-Website enthält eine Datei mit dem Namen `about.md`, die als Seite Deiner Website unter `YOUR-SITE-URL/about` angezeigt wird. Du kannst den Inhalt dieser Datei bearbeiten, um Deine Informationsseite zu personalisieren. Die Informationsseite kannst Du außerdem als Vorlage für neue Seiten verwenden. Weitere Informationen findest Du unter „[Pages](https://jekyllrb.com/docs/pages/)“ (Seiten) in der Jekyll-Dokumentation. diff --git a/translations/de-DE/content/github/working-with-github-pages/configuring-a-custom-domain-for-your-github-pages-site.md b/translations/de-DE/content/github/working-with-github-pages/configuring-a-custom-domain-for-your-github-pages-site.md index 9dc5b25db80f..0eb051af84cc 100644 --- a/translations/de-DE/content/github/working-with-github-pages/configuring-a-custom-domain-for-your-github-pages-site.md +++ b/translations/de-DE/content/github/working-with-github-pages/configuring-a-custom-domain-for-your-github-pages-site.md @@ -1,6 +1,6 @@ --- title: Eine benutzerdefinierte Domäne für Deine GitHub Pages-Website konfigurieren -intro: 'Du kannst den Domänen-Namen Deiner {% data variables.product.prodname_pages %}-Website anpassen.' +intro: 'Sie können den Domain-Namen Ihrer {% data variables.product.prodname_pages %}-Website anpassen.' redirect_from: - /articles/tips-for-configuring-an-a-record-with-your-dns-provider/ - /articles/adding-or-removing-a-custom-domain-for-your-github-pages-site/ diff --git a/translations/de-DE/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md b/translations/de-DE/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md index ed4468dd4d3a..7f8d8871ebd6 100644 --- a/translations/de-DE/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md +++ b/translations/de-DE/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md @@ -1,6 +1,6 @@ --- title: Eine Veröffentlichungsquelle für Deine GitHub Pages-Website konfigurieren -intro: 'Wenn Du die Standard-Veröffentlichungsquelle für Deine {% data variables.product.prodname_pages %}-Website verwendest, wird Deine Website automatisch veröffentlicht. You can also choose to publish your{% if currentVersion ver_lt "enterprise-server@2.22" %} project{% endif %} site from a different branch or folder.' +intro: 'Wenn Sie die Standard-Veröffentlichungsquelle für Ihre {% data variables.product.prodname_pages %}-Website verwenden, wird Ihre Website automatisch veröffentlicht. You can also choose to publish your{% if currentVersion ver_lt "enterprise-server@2.23" %} project{% endif %} site from a different branch or folder.' redirect_from: - /articles/configuring-a-publishing-source-for-github-pages/ - /articles/configuring-a-publishing-source-for-your-github-pages-site @@ -11,11 +11,11 @@ versions: enterprise-server: '*' --- -Weitere Informationen zu Veröffentlichungsquellen finden Sie unter „[Informationen zu {% data variables.product.prodname_pages %}](/articles/about-github-pages#publishing-sources-for-github-pages-sites)“. +Weitere Informationen zu Veröffentlichungsquellen findest Du unter „[Informationen zu {% data variables.product.prodname_pages %}](/articles/about-github-pages#publishing-sources-for-github-pages-sites).“ ### Eine Veröffentlichungsquelle auswählen -Before you configure a publishing source, make sure the branch{% if currentVersion ver_lt "enterprise-server@2.22" %} or folder{% endif %} you want to use as your publishing source already exists in your repository.{% if currentVersion ver_lt "enterprise-server@2.22" %} For example, before you can publish your project site from the `/docs` folder on the `master` branch of your repository, you or a collaborator must create a `/docs` folder on the default `master` branch of your repository.{% endif %} +Before you configure a publishing source, make sure the branch{% if currentVersion ver_lt "enterprise-server@2.23" %} or folder{% endif %} you want to use as your publishing source already exists in your repository.{% if currentVersion ver_lt "enterprise-server@2.23" %} For example, before you can publish your project site from the `/docs` folder on the `master` branch of your repository, you or a collaborator must create a `/docs` folder on the default `master` branch of your repository.{% endif %} {% data reusables.pages.navigate-site-repo %} {% data reusables.repositories.sidebar-settings %} @@ -24,11 +24,13 @@ Before you configure a publishing source, make sure the branch{% if currentVersi 4. Optionally, use the drop-down menu to select a folder for your publishing source. ![Drop-down menu to select a folder for publishing source](/assets/images/help/pages/publishing-source-folder-drop-down.png) 5. Klicke auf **Save** (Speichern). ![Button to save changes to publishing source settings](/assets/images/help/pages/publishing-source-save.png) {% else %} -3. Wähle unter „{% data variables.product.prodname_pages %}“ im Dropdownmenü „**Source**“ (Quelle) eine Veröffentlichungsquelle aus. ![Dropdownmenü zum Auswählen einer Veröffentlichungsquelle](/assets/images/help/pages/publishing-source-drop-down.png) +3. Under " +{% data variables.product.prodname_pages %}", use the **Source** drop-down menu and select a publishing source. + ![Dropdownmenü zum Auswählen einer Veröffentlichungsquelle](/assets/images/help/pages/publishing-source-drop-down.png) {% endif %} ### Fehler bei der Veröffentlichung Deiner {% data variables.product.prodname_pages %}-Website beheben {% data reusables.pages.admin-must-push %} -If you choose the `docs` folder on {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}any{% else %}the `master`{% endif %} branch as your publishing source, then later remove the `/docs` folder from that branch in your repository, your site won't build and you'll get a page build error message for a missing `/docs` folder. Weitere Informationen findest Du unter „[Jekyll-Build-Fehler für {% data variables.product.prodname_pages %}-Websites beheben](/articles/troubleshooting-jekyll-build-errors-for-github-pages-sites#missing-docs-folder).“ +If you choose the `docs` folder on {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}any{% else %}the `master`{% endif %} branch as your publishing source, then later remove the `/docs` folder from that branch in your repository, your site won't build and you'll get a page build error message for a missing `/docs` folder. Weitere Informationen findest Du unter „[Jekyll-Build-Fehler für {% data variables.product.prodname_pages %}-Websites beheben](/articles/troubleshooting-jekyll-build-errors-for-github-pages-sites#missing-docs-folder).“ diff --git a/translations/de-DE/content/github/working-with-github-pages/creating-a-custom-404-page-for-your-github-pages-site.md b/translations/de-DE/content/github/working-with-github-pages/creating-a-custom-404-page-for-your-github-pages-site.md index c5c4faae6df6..55b115b9d8fd 100644 --- a/translations/de-DE/content/github/working-with-github-pages/creating-a-custom-404-page-for-your-github-pages-site.md +++ b/translations/de-DE/content/github/working-with-github-pages/creating-a-custom-404-page-for-your-github-pages-site.md @@ -1,6 +1,6 @@ --- title: Eine benutzerdefinierte 404-Seite für Deine GitHub Pages-Website erstellen -intro: 'Du kannst eine benutzerdefinierte 404-Fehler-Seite anzeigen lassen, wenn Benutzer versuchen, nicht vorhandene Seiten auf Deiner Website aufzurufen.' +intro: Du kannst eine benutzerdefinierte 404-Fehler-Seite anzeigen lassen, wenn Benutzer versuchen, nicht vorhandene Seiten auf Deiner Website aufzurufen. redirect_from: - /articles/custom-404-pages/ - /articles/creating-a-custom-404-page-for-your-github-pages-site diff --git a/translations/de-DE/content/github/working-with-github-pages/creating-a-github-pages-site-with-jekyll.md b/translations/de-DE/content/github/working-with-github-pages/creating-a-github-pages-site-with-jekyll.md index b7b8490f9161..86907ab801db 100644 --- a/translations/de-DE/content/github/working-with-github-pages/creating-a-github-pages-site-with-jekyll.md +++ b/translations/de-DE/content/github/working-with-github-pages/creating-a-github-pages-site-with-jekyll.md @@ -1,24 +1,24 @@ --- -title: GitHub Pages-Website mit Jekyll erstellen -intro: 'Du kannst mit Jekyll eine {% data variables.product.prodname_pages %}-Website in einem neuen oder vorhandenen Repository erstellen.' +title: Creating a GitHub Pages site with Jekyll +intro: 'You can use Jekyll to create a {% data variables.product.prodname_pages %} site in a new or existing repository.' product: '{% data reusables.gated-features.pages %}' redirect_from: - /articles/creating-a-github-pages-site-with-jekyll -permissions: 'Personen mit Administratorberechtigungen für ein Repository können mit Jekyll eine {% data variables.product.prodname_pages %}-Website erstellen.' +permissions: 'People with admin permissions for a repository can create a {% data variables.product.prodname_pages %} site with Jekyll.' versions: free-pro-team: '*' enterprise-server: '*' --- -### Vorrausetzungen +### Prerequisites -Bevor Du mit Jekyll eine {% data variables.product.prodname_pages %}-Website erstellen kannst, musst Du Jekyll und Git installieren. Weitere Informationen finden Sie unter „[Installation](https://jekyllrb.com/docs/installation/)“ in der Jekyll-Dokumentation und unter „[Git einrichten](/articles/set-up-git)“. +Before you can use Jekyll to create a {% data variables.product.prodname_pages %} site, you must install Jekyll and Git. For more information, see [Installation](https://jekyllrb.com/docs/installation/) in the Jekyll documentation and "[Set up Git](/articles/set-up-git)." {% data reusables.pages.recommend-bundler %} {% data reusables.pages.jekyll-install-troubleshooting %} -### Ein Repository für eine Website erstellen +### Creating a repository for your site {% data reusables.pages.new-or-existing-repo %} @@ -29,58 +29,59 @@ Bevor Du mit Jekyll eine {% data variables.product.prodname_pages %}-Website ers {% data reusables.pages.create-repo-name %} {% data reusables.repositories.choose-repo-visibility %} -### Eine Website erstellen +### Creating your site {% data reusables.pages.must-have-repo-first %} {% data reusables.command_line.open_the_multi_os_terminal %} -2. Wenn Du noch keine lokale Kopie Deines Repositorys besitzt, navigiere zu dem Speicherort, an dem Du die Quelldateien Deiner Website speichern möchtest, und ersetze dabei _PARENT-FOLDER_ durch den Ordner, der den Ordner für Dein Repository enthalten soll. +2. If you don't already have a local copy of your repository, navigate to the location where you want to store your site's source files, replacing _PARENT-FOLDER_ with the folder you want to contain the folder for your repository. ```shell $ cd PARENT-FOLDER ``` -3. Wenn Du dies noch nicht getan hast, initialisiere ein lokales Git-Repository, und ersetzen dabei _REPOSITORY-NAME_ durch den Namen Deines Repositorys. +3. If you haven't already, initialize a local Git repository, replacing _REPOSITORY-NAME_ with the name of your repository. ```shell $ git init REPOSITORY-NAME > Initialized empty Git repository in /Users/octocat/my-site/.git/ - # Erstellt einen neuen Ordner auf Deinem Computer, der als Git-Repository initialisiert wird - ``` - 4. Wechsle in das Verzeichnis des Repositorys. + # Creates a new folder on your computer, initialized as a Git repository + ``` + 4. Change directories to the repository. ```shell $ cd REPOSITORY-NAME - # Ändert das Arbeitsverzeichnis + # Changes the working directory ``` {% data reusables.pages.decide-publishing-source %} {% data reusables.pages.navigate-publishing-source %} For example, if you chose to publish your site from the `docs` folder on the default branch, create and change directories to the `docs` folder. ```shell $ mkdir docs - # Erstellt einen neuen Ordner mit dem Namen docs + # Creates a new folder called docs $ cd docs ``` - Wenn Du Deine Website aus dem `gh-pages`-Branch veröffentlichen möchtest, erstelle den `gh-pages`-Branch und checke ihn aus. + If you chose to publish your site from the `gh-pages` branch, create and checkout the `gh-pages` branch. ```shell $ git checkout --orphan gh-pages - # Erstellt einen neuen Branch, ohne Verlauf und Inhalte, mit dem namen gh-pages und wechselt zum gh-pages-Branch + # Creates a new branch, with no history or contents, called gh-pages and switches to the gh-pages branch ``` - 7. Um eine neue Jekyll-Website zu erstellen, führe den Befehl `jekyll new` aus. Ersetze dabei _VERSION_ durch die aktuelle Abhängigkeitsversion für Jekyll. Weitere Informationen finden Sie unter „[Abhängigkeitsversionen](https://pages.github.com/versions/)“ auf der {% data variables.product.prodname_pages %}-Website. - - Wenn Du Bundler installiert hast: + 7. To create a new Jekyll site, use the `jekyll new` command, replacing _VERSION_ with the current dependency version for Jekyll. For more information, see "[Dependency versions](https://pages.github.com/versions/)" on the {% data variables.product.prodname_pages %} site. + - If you installed Bundler: ```shell $ bundle exec jekyll VERSION new . - # Erstellt eine Jekyll-Website im aktuellen Verzeichnis + # Creates a Jekyll site in the current directory ``` - - Wenn Du Bundler nicht installiert hast: + - If you don't have Bundler installed: ```shell $ jekyll VERSION new . - # Erstellt eine Jekyll-Website im aktuellen Verzeichnis + # Creates a Jekyll site in the current directory ``` -8. Öffne das gerade erstellte Gemfile, und befolge die Anweisungen in den Gemfile-Kommentaren, um {% data variables.product.prodname_pages %} zu verwenden. ![Anleitung zum Aktualisieren der Gemfile](/assets/images/help/pages/gemfile-instructions.png) -9. Aktualisiere die Zeile `gem "github-pages"` so, dass sie wie folgt aussieht. Ersetze dabei _VERSION_ durch die aktuelle Abhängigkeitsversion für `github-pages`. Weitere Informationen finden Sie unter „[Abhängigkeitsversionen](https://pages.github.com/versions/)“ auf der {% data variables.product.prodname_pages %}-Website. +8. Open the Gemfile that was created and follow the instructions in the Gemfile's comments to use {% data variables.product.prodname_pages %}. + ![Instructions for updating Gemfile](/assets/images/help/pages/gemfile-instructions.png) +9. Update the `gem "github-pages"` line so that the line looks like this, replacing _VERSION_ with the current dependency version for `github-pages`. For more information, see "[Dependency versions](https://pages.github.com/versions/)" on the {% data variables.product.prodname_pages %} site. ```shell gem "github-pages", "~> VERSION", group: :jekyll_plugins ``` -10. Speichere und schließe das Gemfile. -11. Teste Deine Website optional lokal. Weitere Informationen findest Du unter „[Deine {% data variables.product.prodname_pages %}-Website lokal mit Jekyll testen](/articles/testing-your-github-pages-site-locally-with-jekyll).“ -12. Füge Dein {% data variables.product.product_name %}-Repository als Remote-Repository hinzu. Ersetze dabei {% if currentVersion != "free-pro-team@latest" %}_HOSTNAME_ durch den Hostnamen Deiner Appliance,{% endif %} _USER_ durch das Konto, das das Repository besitzt{% if currentVersion != "free-pro-team@latest" %},{% endif %} und _REPOSITORY_ durch den Namen des Repositorys. +10. Save and close the Gemfile. +11. Optionally, test your site locally. For more information, see "[Testing your {% data variables.product.prodname_pages %} site locally with Jekyll](/articles/testing-your-github-pages-site-locally-with-jekyll)." +12. Add your {% data variables.product.product_name %} repository as a remote, replacing {% if currentVersion != "free-pro-team@latest" %}_HOSTNAME_ with your appliance's hostname,{% endif %} _USER_ with the account that owns the repository{% if currentVersion != "free-pro-team@latest" %},{% endif %} and _REPOSITORY_ with the name of the repository. ```shell {% if currentVersion == "free-pro-team@latest" %} $ git remote add origin https://github.com/USER/REPOSITORY.git @@ -88,7 +89,7 @@ $ git remote add origin https://github.com/USER/REPOSITORY.git $ git remote add origin https://HOSTNAME/USER/REPOSITORY.git {% endif %} ``` -13. Übertrage das Repository zu {% data variables.product.product_name %}, und ersetze dabei _BRANCH_ durch den Namen des Branches, auf dem Du gerade arbeitest. +13. Push the repository to {% data variables.product.product_name %}, replacing _BRANCH_ with the name of the branch you're working on. ```shell $ git push -u origin BRANCH ``` @@ -99,8 +100,8 @@ $ git remote add origin https://HOSTNAME/USER/REPOSITORY.github.io//{% else %}`http(s):///pages///{% endif %}about/contact-us.md` verfügbar. +Du kannst Deiner Website weitere Seiten hinzufügen, indem Du zusätzliche neue Dateien erstellst. Jede Datei wird auf Deiner Website im selben Verzeichnis verfügbar sein wie Deine Veröffentlichungsquelle. For example, if the publishing source for your project site is the `gh-pages` branch, and you create a new file called `/about/contact-us.md` on the `gh-pages` branch, the file will be available at {% if currentVersion == "free-pro-team@latest" %}`https://.github.io//{% else %}`http(s):///pages///{% endif %}about/contact-us.md` verfügbar. -Du kannst auch ein Design hinzufügen, um das Aussehen der Website anzupassen. Weitere Informationen findest Du unter {% if currentVersion == "free-pro-team@latest" %}„[Ein Design mit dem Theme Chooser zu Deiner {% data variables.product.prodname_pages %}-Website hinzufügen](/articles/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser){% else %}„[Ein Design zu Deiner {% data variables.product.prodname_pages %}-Website mit Jekyll hinzufügen](/articles/adding-a-theme-to-your-github-pages-site-using-jekyll){% endif %}.“ +Du kannst auch ein Design hinzufügen, um das Aussehen der Website anzupassen. For more information, see {% if currentVersion == "free-pro-team@latest" %}"[Adding a theme to your {% data variables.product.prodname_pages %} site with the theme chooser](/articles/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser){% else %}"[Adding a theme to your {% data variables.product.prodname_pages %} site using Jekyll](/articles/adding-a-theme-to-your-github-pages-site-using-jekyll){% endif %}." -Um Deine Website noch weiter anzupassen, kannst Du Jekyll verwenden, einen Generator für statische Websites mit integrierter Unterstützung von {% data variables.product.prodname_pages %}. Weitere Informationen findest Du unter „[Informationen zu {% data variables.product.prodname_pages %} und Jekyll](/articles/about-github-pages-and-jekyll).“ +Um Ihre Website noch weiter anzupassen, können Sie Jekyll verwenden, einen Generator für statische Websites mit integrierter Unterstützung von {% data variables.product.prodname_pages %}. Weitere Informationen finden Sie unter „[Informationen zu {% data variables.product.prodname_pages %} und Jekyll](/articles/about-github-pages-and-jekyll)“. ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/working-with-github-pages/getting-started-with-github-pages.md b/translations/de-DE/content/github/working-with-github-pages/getting-started-with-github-pages.md index 49812a1c24d6..f6b94392d847 100644 --- a/translations/de-DE/content/github/working-with-github-pages/getting-started-with-github-pages.md +++ b/translations/de-DE/content/github/working-with-github-pages/getting-started-with-github-pages.md @@ -1,6 +1,6 @@ --- title: Erste Schritte mit GitHub Pages -intro: 'Du kannst eine grundlegende {% data variables.product.prodname_pages %}-Website für Dich selbst, für Deine Organisation oder für Dein Projekt einrichten.' +intro: 'Sie können eine grundlegende {% data variables.product.prodname_pages %}-Website für sich selbst, für Ihre Organisation oder für Ihr Projekt einrichten.' redirect_from: - /categories/github-pages-basics - /articles/additional-customizations-for-github-pages/ diff --git a/translations/de-DE/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md b/translations/de-DE/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md index 97bb35216b8c..e6d4ceb237cd 100644 --- a/translations/de-DE/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md +++ b/translations/de-DE/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md @@ -1,6 +1,6 @@ --- title: Eine benutzerdefinierte Domäne für Deine GitHub Pages-Website verwalten -intro: 'Du kannst bestimmte DNS-Datensätze und die Repository-Einstellungen so einrichten oder aktualisieren, dass die Standard-Domäne für Deine {% data variables.product.prodname_pages %}-Website auf eine benutzerdefinierte Domäne verweist.' +intro: 'Sie können bestimmte DNS-Datensätze und die Repository-Einstellungen so einrichten oder aktualisieren, dass die Standard-Domain für Ihre {% data variables.product.prodname_pages %}-Website auf eine benutzerdefinierte Domain verweist.' redirect_from: - /articles/quick-start-setting-up-a-custom-domain/ - /articles/setting-up-an-apex-domain/ @@ -19,7 +19,7 @@ Personen mit Administratorberechtigungen für ein Repository können eine benutz ### Informationen zur Konfiguration einer benutzerdefinierten Domäne -Nimm die benutzerdefinierte Domäne zunächst in die {% data variables.product.prodname_pages %} Website auf, bevor Du die benutzerdefinierte Domäne bei Deinem DNS-Provider konfigurierst. Wenn Du Deine benutzerdefinierte Domäne bei Deinem DNS-Provider konfigurierst, ohne Deine benutzerdefinierte Domäne vorher zu {% data variables.product.product_name %} hinzuzufügen, könnte ein Dritter eine Website auf einer Deiner Subdomänen hosten. +Nimm die benutzerdefinierte Domäne zunächst in die {% data variables.product.prodname_pages %} Website auf, bevor Du die benutzerdefinierte Domäne bei Deinem DNS-Provider konfigurierst. Wenn Sie Ihre benutzerdefinierte Domain bei Ihrem DNS-Provider konfigurieren, ohne Ihre benutzerdefinierte Domain zu {% data variables.product.product_name %} hinzuzufügen, könnte ein Dritter eine Website auf einer Ihrer Subdomains hosten. {% windows %} @@ -40,7 +40,8 @@ Zum Einrichten einer `www`- oder benutzerdefinierten Subdomäne wie `www.example {% data reusables.pages.navigate-site-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.pages.save-custom-domain %} -5. Navigiere zu Deinem DNS-Provider, und erstelle einen `CNAME` Datensatz, welcher Deine Subdomäne auf die Standarddomäne Deiner Website verweist. Soll beispielsweise die Subdomäne `www.example.com` für Deine Benutzer-Website verwendet werden, erstelle einen `CNAME`-Datensatz, mit dem `www.example.com` auf `.github.io` verweist. If you want to use the subdomain `www.anotherexample.com` for your organization site, create a `CNAME` record that points `www.anotherexample.com` to `.github.io`. The `CNAME` file should always point to `.github.io` or `.github.io`, excluding the repository name. {% data reusables.pages.contact-dns-provider %}{% data reusables.pages.default-domain-information %} +5. Navigiere zu Deinem DNS-Provider, und erstelle einen `CNAME` Datensatz, welcher Deine Subdomäne auf die Standarddomäne Deiner Website verweist. Soll beispielsweise die Subdomäne `www.example.com` für Deine Benutzer-Website verwendet werden, erstelle einen `CNAME`-Datensatz, mit dem `www.example.com` auf `.github.io` verweist. If you want to use the subdomain `www.anotherexample.com` for your organization site, create a `CNAME` record that points `www.anotherexample.com` to `.github.io`. The `CNAME` file should always point to `.github.io` or `.github.io`, excluding the repository name. +{% data reusables.pages.contact-dns-provider %}{% data reusables.pages.default-domain-information %} {% data reusables.command_line.open_the_multi_os_terminal %} 6. Prüfe die korrekte Konfiguration des DNS-Datensatzes mit dem Befehl `dig`, und ersetze _WWW.EXAMPLE.COM_ dabei durch Deine Subdomäne. ```shell @@ -64,7 +65,7 @@ Zum Einrichten einer Apex-Domäne, beispielsweise `example.com`, musst Du eine _ {% data reusables.pages.save-custom-domain %} 5. Navigiere zu Deinem DNS-Provider, und erstelle entweder einen `ALIAS`-, einen `ANAME`- oder einen `A`-Datensatz. {% data reusables.pages.contact-dns-provider %} - Soll ein `ALIAS`- oder `ANAME`-Datensatz erstellt werden, verweise Deine Apex-Domäne auf die Standarddomäne Deiner Website. {% data reusables.pages.default-domain-information %} - - Soll ein `A`-Datensatz erstellt werden, verweise Deine Apex-Domäne auf die IP-Adressen für {% data variables.product.prodname_pages %}. + - Soll ein `A`-Datensatz erstellt werden, verweisen Sie Ihre Apex-Domain auf die IP-Adressen für {% data variables.product.prodname_pages %}. ```shell 185.199.108.153 185.199.109.153 diff --git a/translations/de-DE/content/github/working-with-github-pages/securing-your-github-pages-site-with-https.md b/translations/de-DE/content/github/working-with-github-pages/securing-your-github-pages-site-with-https.md index 658bc234b0ed..c58ed901e56e 100644 --- a/translations/de-DE/content/github/working-with-github-pages/securing-your-github-pages-site-with-https.md +++ b/translations/de-DE/content/github/working-with-github-pages/securing-your-github-pages-site-with-https.md @@ -24,11 +24,11 @@ Die HTTPS-Erzwingung ist für {% data variables.product.prodname_pages %}-Websit {% data reusables.pages.navigate-site-repo %} {% data reusables.repositories.sidebar-settings %} -3. Wähle unter „{% data variables.product.prodname_pages %}“ die Option **Enforce HTTPS** (HTTPS erzwingen). ![Kontrollkästchen „Enforce HTTPS“ (HTTPS erzwingen)](/assets/images/help/pages/enforce-https-checkbox.png) +3. Wählen Sie unter „{% data variables.product.prodname_pages %}“ die Option **Enforce HTTPS** (HTTPS erzwingen). ![Kontrollkästchen „Enforce HTTPS“ (HTTPS erzwingen)](/assets/images/help/pages/enforce-https-checkbox.png) ### Probleme bei gemischten Inhalten beheben -Wenn Du für Deine {% data variables.product.prodname_pages %}-Website HTTPS aktivierst, die HTML Deiner Website aber noch Bilder, CSS oder JavaScript über HTTP referenziert, stellt Deine Website *gemischte Inhalte* bereit. In diesem Fall ist Deine Website möglicherweise weniger sicher und das Laden dieser Objekte bereitet eventuell Probleme. +Wenn Sie für Ihre {% data variables.product.prodname_pages %}-Website HTTPS aktivieren, die HTML Ihrer Website aber noch Bilder, CSS oder JavaScript über HTTP referenziert, stellt Ihre Website *gemischte Inhalte* bereit. In diesem Fall ist Deine Website möglicherweise weniger sicher und das Laden dieser Objekte bereitet eventuell Probleme. Sollen die gemischten Inhalte Deiner Website entfernt werden, stelle zunächst alle Objekte über HTTPS bereit. Ersetze hierzu `http://` in der HTML Deiner Website durch `https://`. @@ -40,7 +40,7 @@ Objekte befinden sich meist in den folgenden Speicherorten: {% tip %} -**Tipp:** Wenn Du die Objekte nicht in den Quelldateien Deiner Website findest, suche mit dem Texteditor oder mit {% data variables.product.product_name %} in den Quelldateien nach `http`. +**Tipp:** Wenn Sie die Assets nicht in den Quelldateien Ihrer Website finden, suchen Sie mit dem Texteditor oder mit {% data variables.product.product_name %} in den Quelldateien nach `http`. {% endtip %} diff --git a/translations/de-DE/content/github/working-with-github-pages/setting-up-a-github-pages-site-with-jekyll.md b/translations/de-DE/content/github/working-with-github-pages/setting-up-a-github-pages-site-with-jekyll.md index 92635ba57440..cf08a1fac022 100644 --- a/translations/de-DE/content/github/working-with-github-pages/setting-up-a-github-pages-site-with-jekyll.md +++ b/translations/de-DE/content/github/working-with-github-pages/setting-up-a-github-pages-site-with-jekyll.md @@ -1,6 +1,6 @@ --- title: GitHub Pages-Website mit Jekyll einrichten -intro: 'Mit Jekyll, dem beliebten Generator für statische Websites, kannst Du Deine {% data variables.product.prodname_pages %}-Website weiter anpassen.' +intro: 'Mit Jekyll, dem beliebten Generator für statische Websites, können Sie Ihre {% data variables.product.prodname_pages %}-Website weiter anpassen.' redirect_from: - /articles/using-jekyll-with-pages/ - /articles/using-jekyll-as-a-static-site-generator-with-github-pages diff --git a/translations/de-DE/content/github/working-with-github-pages/testing-your-github-pages-site-locally-with-jekyll.md b/translations/de-DE/content/github/working-with-github-pages/testing-your-github-pages-site-locally-with-jekyll.md index 1816fd04ecb2..e480003fc5fb 100644 --- a/translations/de-DE/content/github/working-with-github-pages/testing-your-github-pages-site-locally-with-jekyll.md +++ b/translations/de-DE/content/github/working-with-github-pages/testing-your-github-pages-site-locally-with-jekyll.md @@ -1,6 +1,6 @@ --- title: GitHub Pages-Website lokal mit Jekyll testen -intro: 'Du kannst Deine {% data variables.product.prodname_pages %}-Website lokal erstellen, um damit eine Vorschau der Änderungen an Deiner Website zu prüfen und diese Änderungen zu testen.' +intro: 'Sie können Ihre {% data variables.product.prodname_pages %}-Website lokal erstellen und damit eine Vorschau der Änderungen an Ihrer Website zu prüfen und diese Änderungen testen.' redirect_from: - /articles/setting-up-your-pages-site-locally-with-jekyll/ - /articles/setting-up-your-github-pages-site-locally-with-jekyll/ diff --git a/translations/de-DE/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md b/translations/de-DE/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md index 023061c8a6fd..a9156cf1f022 100644 --- a/translations/de-DE/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md +++ b/translations/de-DE/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md @@ -15,7 +15,7 @@ versions: Benutzerdefinierte Domänen werden in einer _CNAME_-Datei im Stammverzeichnis der Veröffentlichungsquelle gespeichert. Du kannst diese Datei wahlweise in den Repository-Einstellungen oder manuell hinzufügen oder aktualisieren. Weitere Informationen findest Du unter „[Eine benutzerdefinierte Domäne für Deine {% data variables.product.prodname_pages %}-Website verwalten](/articles/managing-a-custom-domain-for-your-github-pages-site).“ -Damit Deine Website in der richtigen Domäne gerendert wird, prüfe, ob die _CNAME_-Datei sich noch im Repository befindet. Zahlreiche Generatoren für statische Websites erzwingen beispielsweise einen Push-Vorgang an das Repository, wodurch allenfalls die _CNAME_-Datei überschrieben wird, die Du beim Konfigurieren der benutzerdefinierten Domäne in das Repository eingefügt hast. Wenn Du Deine Website lokal erstellst und generierte Dateien per Push-Vorgang an {% data variables.product.product_name %} überträgst, musst Du in jedem Fall zunächst einen Pull-Vorgang für den Commit vornehmen, mit dem die _CNAME_-Datei in das lokale Repository eingefügt wurde, sodass die Datei in den Build aufgenommen wird. +Damit Deine Website in der richtigen Domäne gerendert wird, prüfe, ob die _CNAME_-Datei sich noch im Repository befindet. Zahlreiche Generatoren für statische Websites erzwingen beispielsweise einen Push-Vorgang an das Repository, wodurch allenfalls die _CNAME_-Datei überschrieben wird, die Du beim Konfigurieren der benutzerdefinierten Domäne in das Repository eingefügt hast. Wenn Sie Ihre Website lokal erstellen und generierte Dateien per Push-Vorgang an {% data variables.product.product_name %} übertragen, müssen Sie in jedem Fall zunächst einen Pull-Vorgang für den Commit vornehmen, mit dem die _CNAME_-Datei in das lokale Repository eingefügt wurde, sodass die Datei in den Build aufgenommen wird. Prüfe anschließend, ob die _CNAME_-Datei ordnungsgemäß formatiert ist. diff --git a/translations/de-DE/content/github/working-with-github-pages/troubleshooting-jekyll-build-errors-for-github-pages-sites.md b/translations/de-DE/content/github/working-with-github-pages/troubleshooting-jekyll-build-errors-for-github-pages-sites.md index 02a9bfe6acb9..1ed03b1e523d 100644 --- a/translations/de-DE/content/github/working-with-github-pages/troubleshooting-jekyll-build-errors-for-github-pages-sites.md +++ b/translations/de-DE/content/github/working-with-github-pages/troubleshooting-jekyll-build-errors-for-github-pages-sites.md @@ -1,6 +1,6 @@ --- -title: Fehlerbehebung bei Jekyll-Build-Fehlern für GitHub Pages-Websites -intro: 'Mithilfe der Jekyll-Build-Fehlermeldungen kannst Du Probleme auf Deiner {% data variables.product.prodname_pages %}-Website beheben.' +title: Troubleshooting Jekyll build errors for GitHub Pages sites +intro: 'You can use Jekyll build error messages to troubleshoot problems with your {% data variables.product.prodname_pages %} site.' redirect_from: - /articles/page-build-failed-missing-docs-folder/ - /articles/page-build-failed-invalid-submodule/ @@ -30,158 +30,158 @@ versions: enterprise-server: '*' --- -### Fehlerbehebung bei Build-Fehlern +### Troubleshooting build errors -Wenn beim Erstellen Deiner {% data variables.product.prodname_pages %}-Website (lokal oder auf {% data variables.product.product_name %}) mit Jekyll ein Fehler auftritt, kannst Du die Fehlerbehebung mithilfe der Fehlermeldungen durchführen. Weitere Informationen zu Fehlermeldungen und zum Abrufen dieser Meldungen findest Du unter „[Behebung von Jekyll-Build-Fehlern bei {% data variables.product.prodname_pages %}-Websites](/articles/about-jekyll-build-errors-for-github-pages-sites).“ +If Jekyll encounters an error building your {% data variables.product.prodname_pages %} site locally or on {% data variables.product.product_name %}, you can use error messages to troubleshoot. For more information about error messages and how to view them, see "[About Jekyll build errors for {% data variables.product.prodname_pages %} sites](/articles/about-jekyll-build-errors-for-github-pages-sites)." -Wenn Du eine generische Fehlermeldung erhalten hast, suche nach häufigen Fehlern. -- Du verwendest nicht unterstützte Plug-Ins. Weitere Informationen findest Du unter „[Informationen zu {% data variables.product.prodname_pages %} und Jekyll](/articles/about-github-pages-and-jekyll#plugins)“.{% if currentVersion == "free-pro-team@latest" %} -- Dein Repository hat die Größenbeschränkung für Repositorys überschritten. Weitere Informationen findest Du unter „[Wie lautet mein Disk-Kontingent?](/articles/what-is-my-disk-quota)“.{% endif %} -- Du hast die `source`-Einstellung in der Datei *_config.yml* geändert. {% data variables.product.prodname_pages %} überschreibt diese Einstellung beim Build-Prozess. -- Ein Dateiname in Deiner Veröffentlichungsquelle enthält einen Doppelpunkt (`:`). Dies wird nicht unterstützt. +If you received a generic error message, check for common issues. +- You're using unsupported plugins. For more information, see "[About {% data variables.product.prodname_pages %} and Jekyll](/articles/about-github-pages-and-jekyll#plugins)."{% if currentVersion == "free-pro-team@latest" %} +- Your repository has exceeded our repository size limits. For more information, see "[What is my disk quota?](/articles/what-is-my-disk-quota)"{% endif %} +- You changed the `source` setting in your *_config.yml* file. {% data variables.product.prodname_pages %} overrides this setting during the build process. +- A filename in your publishing source contains a colon (`:`) which is not supported. -Wenn Du eine spezifische Fehlermeldung erhalten hast, lies die nachfolgenden Informationen zur Fehlerbehebung für die jeweilige Fehlermeldung. +If you received a specific error message, review the troubleshooting information for the error message below. -Wenn Du einen Fehler behoben hast, übertrage die Änderungen mit einem Push an die Veröffentlichungsquelle der Website, sodass ein neuer Build auf {% data variables.product.product_name %} ausgelöst wird. +After you've fixed any errors, push the changes to your site's publishing source to trigger another build on {% data variables.product.product_name %}. -### Fehler bei der Dateikonfiguration +### Config file error -Dieser Fehler bedeutet, dass der Build Deiner Website fehlgeschlagen ist, da die Datei *_config.yml* Syntaxfehler enthält. +This error means that your site failed to build because the *_config.yml* file contains syntax errors. -Zur Fehlerbehebung prüfe, ob die Datei *_config.yml* diesen Regeln entspricht: +To troubleshoot, make sure that your *_config.yml* file follows these rules: {% data reusables.pages.yaml-rules %} {% data reusables.pages.yaml-linter %} -### Datum besitzt ungültiges Datum/Uhrzeit +### Date is not a valid datetime -Dieser Fehler bedeutet, dass eine Seite der Website einen ungültigen Wert für Datum/Uhrzeit enthält. +This error means that one of the pages on your site includes an invalid datetime. -Zur Fehlerbehebung prüfe die in der Fehlermeldung genannte Datei und deren Layouts auf Aufrufe datumsbezogener Liquid-Filter. Prüfe, ob alle Variablen, die an datumsabhängige Liquid-Filter übergeben werden, Werte enthalten und nicht `nil` oder `""` übergeben. Weitere Informationen findest Du unter „[Liquid filters](https://help.shopify.com/en/themes/liquid/filters)“ (Liquid-Filter) in der Liquid-Dokumentation. +To troubleshoot, search the file in the error message and the file's layouts for calls to any date-related Liquid filters. Make sure that any variables passed into date-related Liquid filters have values in all cases and never pass `nil` or `""`. For more information, see "[Liquid filters](https://help.shopify.com/en/themes/liquid/filters)" in the Liquid documentation. -### Datei ist im Verzeichnis „includes“ nicht vorhanden +### File does not exist in includes directory -Dieser Fehler bedeutet, dass Dein Code auf eine Datei verweist, die sich nicht im Verzeichnis *_includes* befindet. +This error means that your code references a file that doesn't exist in your *_includes* directory. -{% data reusables.pages.search-for-includes %} Wenn sich referenzierte Dateien nicht im Verzeichnis *_includes* befinden, kopiere oder verschiebe die betreffenden Dateien in das Verzeichnis *_includes*. +{% data reusables.pages.search-for-includes %} If any of the files you've referenced aren't in the *_includes* directory, copy or move the files into the *_includes* directory. -### Datei ist ein Symlink +### File is a symlink -Dieser Fehler bedeutet, dass der Code auf eine per Symlink verknüpfte Datei verweist, die sich nicht in der Veröffentlichungsquelle für Deine Website befindet. +This error means that your code references a symlinked file that does not exist in the publishing source for your site. -{% data reusables.pages.search-for-includes %} Wenn per Symlink verknüpfte Dateien referenziert werden, kopiere oder verschiebe die betreffenden Dateien in das Verzeichnis *_includes*. +{% data reusables.pages.search-for-includes %} If any of the files you've referenced are symlinked, copy or move the files into the *_includes* directory. -### Datei ist nicht ordnungsgemäß UTF-8-codiert +### File is not properly UTF-8 encoded -Dieser Fehler bedeutet, dass Du nicht lateinische Buchstaben wie `日本語` verwendet hast, ohne dem Computer mitzuteilen, dass er diese Symbole erwarten soll. +This error means that you used non-Latin characters, like `日本語`, without telling the computer to expect these symbols. -Zur Fehlerbehebung erzwinge die UTF-8-Codierung. Trage hierzu die folgende Zeile in die Datei *_config.yml* ein: +To troubleshoot, force UTF-8 encoding by adding the following line to your *_config.yml* file: ``` encoding: UTF-8 ``` -### Textmarkersprache ungültig +### Invalid highlighter language -Dieser Fehler bedeutet, dass Du nicht die Syntaxmarkierer [Rouge](https://github.com/jneen/rouge) oder [Pygments](http://pygments.org/) in der Konfigurationsdatei angegeben hast, sondern einen anderen Markierer. +This error means that you specified any syntax highlighter other than [Rouge](https://github.com/jneen/rouge) or [Pygments](http://pygments.org/) in your configuration file. -Zur Fehlerbehebung aktualisiere die Datei *_config.yml*, und gib [Rouge](https://github.com/jneen/rouge) oder [Pygments](http://pygments.org/) an. Weitere Informationen findest Du unter „[Informationen zu {% data variables.product.product_name %} und Jekyll](/articles/about-github-pages-and-jekyll#syntax-highlighting).“ +To troubleshoot, update your *_config.yml* file to specify [Rouge](https://github.com/jneen/rouge) or [Pygments](http://pygments.org/). For more information, see "[About {% data variables.product.product_name %} and Jekyll](/articles/about-github-pages-and-jekyll#syntax-highlighting)." -### Ungültiges Beitragsdatum +### Invalid post date -Dieser Fehler bedeutet, dass ein Beitrag auf Deiner Website ein ungültiges Datum im Dateinamen oder in der YAML-Frontmatter enthält. +This error means that a post on your site contains an invalid date in the filename or YAML front matter. -Zur Fehlerbehebung formatiere alle Datumsangaben als YYYY-MM-DD HH:MM:SS für UTC, und prüfe, ob gültige Kalenderdaten angegeben sind. Soll eine Zeitzone außerhalb der UTC angegeben werden, verwende das Format YYYY-MM-DD HH:MM:SS +/-TTTT, beispielsweise `2014-04-18 11:30:00 +0800`. +To troubleshoot, make sure all dates are formatted as YYYY-MM-DD HH:MM:SS for UTC and are actual calendar dates. To specify a time zone with an offset from UTC, use the format YYYY-MM-DD HH:MM:SS +/-TTTT, like `2014-04-18 11:30:00 +0800`. -Wenn Du ein Datumsformat in der Datei *_config.yml* festlegst, achte auf das richtige Format. +If you specify a date format in your *_config.yml* file, make sure the format is correct. -### Sass oder SCSS ungültig +### Invalid Sass or SCSS -Dieser Fehler bedeutet, dass Dein Repository eine Sass- oder SCSS-Datei mit ungültigem Inhalt enthält. +This error means your repository contains a Sass or SCSS file with invalid content. -Zur Fehlerbehebung prüfe die in der Fehlermeldung genannte Zeilennummer auf ungültige Sass oder SCSS. Damit solche Fehler in Zukunft vermieden werden, installiere einen Sass- oder SCSS-Linter für Deinen meistgenutzten Texteditor. +To troubleshoot, review the line number included in the error message for invalid Sass or SCSS. To help prevent future errors, install a Sass or SCSS linter for your favorite text editor. -### Ungültiges Submodul +### Invalid submodule -Dieser Fehler bedeutet, dass Dein Repository ein nicht ordnungsgemäß initialisiertes Submodul enthält. +This error means that your repository includes a submodule that hasn't been properly initialized. {% data reusables.pages.remove-submodule %} -Soll das Submodul dennoch verwendet werden, referenziere das Submodul mit `https://` (nicht mit `http://`), und stelle sicher, dass sich das Submodul in einem öffentlichen Repository befindet. +If do you want to use the submodule, make sure you use `https://` when referencing the submodule (not `http://`) and that the submodule is in a public repository. -### Ungültige YAML in der Datendatei +### Invalid YAML in data file -Dieser Fehler bedeutet, dass mindestens eine Datei im Ordner *_data* ungültige YAML enthält. +This error means that one of more files in the *_data* folder contains invalid YAML. -Zur Fehlerbehebung prüfe, ob die YAML-Dateien im Ordner *_data* diesen Regeln entsprechen: +To troubleshoot, make sure the YAML files in your *_data* folder follow these rules: {% data reusables.pages.yaml-rules %} {% data reusables.pages.yaml-linter %} -Weitere Informationen zu Jekyll-Datendateien findest Du unter „[Data Files](https://jekyllrb.com/docs/datafiles/)“ (Datendateien) in der Jekyll-Dokumentation. +For more information about Jekyll data files, see "[Data Files](https://jekyllrb.com/docs/datafiles/)" in the Jekyll documentation. -### Markdown-Fehler +### Markdown errors -Dieser Fehler bedeutet, dass Dein Repository Markdown-Fehler enthält. +This error means that your repository contains Markdown errors. -Zur Fehlerbehebung verwende einen unterstützten Markdown-Prozessor. Weitere Informationen findest Du unter „[Markdown-Prozessor für Deine {% data variables.product.prodname_pages %}-Website mit Jekyll festlegen](/articles/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll).“ +To troubleshoot, make sure you are using a supported Markdown processor. For more information, see "[Setting a Markdown processor for your {% data variables.product.prodname_pages %} site using Jekyll](/articles/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll)." -Prüfe außerdem, ob die in der Fehlermeldung genannte Datei eine gültige Markdown-Syntax umfasst. Weitere Informationen findest Du unter „[Markdown: Syntax](https://daringfireball.net/projects/markdown/syntax)“ bei Daring Fireball. +Then, make sure the file in the error message uses valid Markdown syntax. For more information, see "[Markdown: Syntax](https://daringfireball.net/projects/markdown/syntax)" on Daring Fireball. -### Dokumentordner fehlt +### Missing docs folder This error means that you have chosen the `docs` folder on a branch as your publishing source, but there is no `docs` folder in the root of your repository on that branch. -To troubleshoot, if your `docs` folder was accidentally moved, try moving the `docs` folder back to the root of your repository on the branch you chose for your publishing source. Wenn der Ordner `docs` versehentlich gelöscht wurde, kannst Du wie folgt vorgehen: -- Mache den Löschvorgang mit Git rückgängig. Weitere Informationen findest Du unter „[git-revert](https://git-scm.com/docs/git-revert.html) in der Git-Dokumentation. -- Create a new `docs` folder in the root of your repository on the branch you chose for your publishing source and add your site's source files to the folder. Weitere Informationen finden Sie unter „[Neue Dateien erstellen](/articles/creating-new-files)“. -- Ändere die Veröffentlichungsquelle. Weitere Informationen findest Du unter „[Eine Veröffentlichungsquelle für {% data variables.product.prodname_pages %} konfigurieren](/articles/configuring-a-publishing-source-for-github-pages).“ +To troubleshoot, if your `docs` folder was accidentally moved, try moving the `docs` folder back to the root of your repository on the branch you chose for your publishing source. If the `docs` folder was accidentally deleted, you can either: +- Use Git to revert or undo the deletion. For more information, see "[git-revert](https://git-scm.com/docs/git-revert.html)" in the Git documentation. +- Create a new `docs` folder in the root of your repository on the branch you chose for your publishing source and add your site's source files to the folder. For more information, see "[Creating new files](/articles/creating-new-files)." +- Change your publishing source. For more information, see "[Configuring a publishing source for {% data variables.product.prodname_pages %}](/articles/configuring-a-publishing-source-for-github-pages)." -### Submodul fehlt +### Missing submodule -Dieser Fehler bedeutet, dass Dein Repository ein nicht vorhandenes oder ein nicht ordnungsgemäß initialisiertes Submodul enthält. +This error means that your repository includes a submodule that doesn't exist or hasn't been properly initialized. {% data reusables.pages.remove-submodule %} -Soll ein Submodul verwendet werden, initialisiere das Submodul. Weitere Informationen findest Du unter „[Git-Tools – Submodule](https://git-scm.com/book/en/v2/Git-Tools-Submodules)“ im _Pro Git_-Buch. +If you do want to use a submodule, initialize the submodule. For more information, see "[Git Tools - Submodules](https://git-scm.com/book/en/v2/Git-Tools-Submodules)" in the _Pro Git_ book. -### Relative Permalinks konfiguriert +### Relative permalinks configured -Dieser Fehler bedeutet, dass Du relative Permalinks in der Datei *_config.yml* nutzt, die nicht von {% data variables.product.prodname_pages %} unterstützt werden. +This errors means that you have relative permalinks, which are not supported by {% data variables.product.prodname_pages %}, in your *_config.yml* file. -Permalinks sind permanente URLs, die auf einen bestimmten Beitrag oder eine bestimmte Seite Deiner Website verweisen. Absolute Permalinks beginnen mit dem Root der Website, relative Permalinks dagegen mit dem Ordner, in dem sich die referenzierte Seite befindet. {% data variables.product.prodname_pages %} und Jekyll unterstützen relative Permalinks nicht mehr. Weitere Informationen zu Permalinks findest Du unter „[Permalinks](https://jekyllrb.com/docs/permalinks/)“ in der Jekyll-Dokumentation. +Permalinks are permanent URLs that reference a particular page on your site. Absolute permalinks begin with the root of the site, while relative permalinks begin with the folder containing the referenced page. {% data variables.product.prodname_pages %} and Jekyll no longer support relative permalinks. For more information about permalinks, see "[Permalinks](https://jekyllrb.com/docs/permalinks/)" in the Jekyll documentation. -Zur Fehlerbehebung entferne die Konfigurationsoption `relative_permalinks` aus der Datei *_config.yml* der Website, und ändere alle relativen Permalinks auf der Website in absolute Permalinks. Weitere Informationen findest Du unter „[Dateien in Deinem Repository bearbeiten](/articles/editing-files-in-your-repository).“ +To troubleshoot, remove the `relative_permalinks` line from your *_config.yml* file and reformat any relative permalinks in your site with absolute permalinks. For more information, see "[Editing files in your repository](/articles/editing-files-in-your-repository)." -### Symlink ist im Repository Deiner Website nicht vorhanden +### Symlink does not exist within your site's repository -Dieser Fehler bedeutet, dass die Website einen symbolischen Link (Symlink) enthält, der sich nicht in der Veröffentlichungsquelle für die Website befindet. Weitere Informationen zu Symlinks findest Du unter „[Symbolic Link](https://en.wikipedia.org/wiki/Symbolic_link)“ (Symbolische Verknüpfung) auf Wikipedia. +This error means that your site includes a symbolic link (symlink) that does not exist in the publishing source for your site. For more information about symlinks, see "[Symbolic link](https://en.wikipedia.org/wiki/Symbolic_link)" on Wikipedia. -Zur Fehlerbehebung prüfe, ob die in der Fehlermeldung genannte Datei für den Build der Website erforderlich ist. Falls nicht (oder falls die Datei kein Symlink sein soll), lösche die Datei. Wenn die Datei, auf die der Symlink verweist, für den Build der Website erforderlich ist, stelle sicher, dass die Datei oder das Verzeichnis, auf das der Symlink verweist, in der Veröffentlichungsquelle der Website vorhanden ist. Um externe Objekte einzuschließen, empfiehlt es sich, {% if currentVersion == "free-pro-team@latest" %}ein `git submodule` oder {% endif %}einen Drittanbieter-Paketmanager wie [Bower](http://bower.io/) zu verwenden.{% if currentVersion == "free-pro-team@latest" %} Weitere Informationen findest Du unter „[Submodule mit {% data variables.product.prodname_pages %} verwenden](/articles/using-submodules-with-github-pages)“.{% endif %} +To troubleshoot, determine if the file in the error message is used to build your site. If not, or if you don't want the file to be a symlink, delete the file. If the symlinked file is necessary to build your site, make sure the file or directory the symlink references is in the publishing source for your site. To include external assets, consider using {% if currentVersion == "free-pro-team@latest" %}`git submodule` or {% endif %}a third-party package manager such as [Bower](https://bower.io/).{% if currentVersion == "free-pro-team@latest" %} For more information, see "[Using submodules with {% data variables.product.prodname_pages %}](/articles/using-submodules-with-github-pages)."{% endif %} -### Syntaxfehler in der „for“-Schleife +### Syntax error in 'for' loop -Dieser Fehler bedeutet, dass Dein Code ungültige Syntax in einer Liquid-`for`-Schleifen-Deklaration enthält. +This error means that your code includes invalid syntax in a Liquid `for` loop declaration. -Zur Fehlerbehebung prüfe die Syntax in allen `for`-Schleifen in der Datei, die in der Fehlermeldung genannt ist. Weitere Informationen zur korrekten Syntax für `for`-Schleifen findest Du unter „[Iteration tags](https://help.shopify.com/en/themes/liquid/tags/iteration-tags#for)“ (Iterations-Tags) in der Liquid-Dokumentation. +To troubleshoot, make sure all `for` loops in the file in the error message have proper syntax. For more information about proper syntax for `for` loops, see "[Iteration tags](https://help.shopify.com/en/themes/liquid/tags/iteration-tags#for)" in the Liquid documentation. -### Tag nicht ordnungsgemäß geschlossen +### Tag not properly closed -Diese Fehlermeldung bedeutet, dass Dein Code ein logisches Tag enthält, das nicht korrekt geschlossen ist. {% raw %}`{% capture example_variable %}` muss beispielsweise mit `{% endcapture %}`{% endraw %} geschlossen werden. +This error message means that your code includes a logic tag that is not properly closed. For example, {% raw %}`{% capture example_variable %}` must be closed by `{% endcapture %}`{% endraw %}. -Zur Fehlerbehebung prüfe, ob alle logischen Tags in der Datei, die in der Fehlermeldung genannt ist, ordnungsgemäß geschlossen sind. Weitere Informationen findest Du unter „[Liquid tags](https://help.shopify.com/en/themes/liquid/tags)“ (Liquid-Tags) in der Liquid-Dokumentation. +To troubleshoot, make sure all logic tags in the file in the error message are properly closed. For more information, see "[Liquid tags](https://help.shopify.com/en/themes/liquid/tags)" in the Liquid documentation. -### Tag nicht ordnungsgemäß beendet +### Tag not properly terminated -Diese Fehlermeldung bedeutet, dass Dein Code ein Ausgabe-Tag enthält, das nicht korrekt beendet wurde. Beispiel: {% raw %}`{{ page.title }` statt `{{ page.title }}`{% endraw %}. +This error means that your code includes an output tag that is not properly terminated. For example, {% raw %}`{{ page.title }` instead of `{{ page.title }}`{% endraw %}. -Zur Fehlerbehebung prüfe, ob alle Ausgabe-Tags in der Datei, die in der Fehlermeldung genannt ist, mit `}}` beendet wurden. Weitere Informationen findest Du unter „[Liquid objects](https://help.shopify.com/en/themes/liquid/objects)“ (Liquid-Objekte) in der Liquid-Dokumentation. +To troubleshoot, make sure all output tags in the file in the error message are terminated with `}}`. For more information, see "[Liquid objects](https://help.shopify.com/en/themes/liquid/objects)" in the Liquid documentation. -### Unbekannter Tag-Fehler +### Unknown tag error -Dieser Fehler bedeutet, dass Dein Code ein nicht erkanntes Liquid-Tag enthält. +This error means that your code contains an unrecognized Liquid tag. -Zur Fehlerbehebung prüfe, ob alle Liquid-Tags in der Datei, die in der Fehlermeldung genannt ist, den Jekyll-Standardvariablen entsprechen und ob die Tag-Namen korrekt geschrieben sind. Eine Liste der Standardvariablen findest Du unter „[Variables](https://jekyllrb.com/docs/variables/)“ (Variablen) in der Jekyll-Dokumentation. +To troubleshoot, make sure all Liquid tags in the file in the error message match Jekyll's default variables and there are no typos in the tag names. For a list of default varibles, see "[Variables](https://jekyllrb.com/docs/variables/)" in the Jekyll documentation. -Nicht unterstützte Plug-ins sind häufig die Quelle für unbekannte Tags. Wenn Du ein nicht unterstütztes Plug-in auf der Website verwendest, also die Website lokal erstellst und die statischen Dateien per Push an {% data variables.product.product_name %} überträgst, darf das Plug-in keine Tags umfassen, die nicht in den Jekyll-Standardvariablen aufgeführt sind. Eine Liste der unterstützten Plug-ins findest Du unter „[Informationen zu {% data variables.product.prodname_pages %} und Jekyll](/articles/about-github-pages-and-jekyll#plugins).“ +Unsupported plugins are a common source of unrecognized tags. If you use an unsupported plugin in your site by generating your site locally and pushing your static files to {% data variables.product.product_name %}, make sure the plugin is not introducing tags that are not in Jekyll's default variables. For a list of supported plugins, see "[About {% data variables.product.prodname_pages %} and Jekyll](/articles/about-github-pages-and-jekyll#plugins)." diff --git a/translations/de-DE/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md b/translations/de-DE/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md index 3a867d099494..50c7ef592918 100644 --- a/translations/de-DE/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md +++ b/translations/de-DE/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md @@ -1,6 +1,6 @@ --- title: Veröffentlichung einer GitHub Pages-Website zurückziehen -intro: 'Du kannst die Veröffentlichung Deiner {% data variables.product.prodname_pages %}-Website zurückziehen, sodass die Website nicht mehr für {% if currentVersion == "free-pro-team@latest" %}die Öffentlichkeit{% else %}alle Benutzer mit {% data variables.product.product_location %}{% endif %} zur Verfügung steht.' +intro: 'You can unpublish your {% data variables.product.prodname_pages %} site so that the site is no longer available to {% if currentVersion == "free-pro-team@latest" %}the public{% else %}everyone using {% data variables.product.product_location %}{% endif %}.' redirect_from: - /articles/how-do-i-unpublish-a-project-page/ - /articles/unpublishing-a-project-page/ @@ -19,9 +19,11 @@ versions: {% data reusables.repositories.navigate-to-repo %} 2. Wenn das Repository einen Branch `gh-pages` enthält, lösche den Branch `gh-pages`. Weitere Informationen findest Du unter „[Branches in Deinem Repository erstellen und löschen](/articles/creating-and-deleting-branches-within-your-repository#deleting-a-branch).“ 3. Falls der Branch `gh-pages` als Veröffentlichungsquelle fungierte, -{% if currentVersion == "free-pro-team@latest" %}fahre mit Schritt 6 fort{% else %}ist die Veröffentlichung der Website damit aufgehoben, und Du kannst die restlichen Schritte überspringen{% endif %}. +{% if currentVersion == "free-pro-team@latest" %}skip to step 6{% else %}your site is now unpublished and you can skip the remaining steps{% endif %}. {% data reusables.repositories.sidebar-settings %} -5. Wähle unter „{% data variables.product.prodname_pages %}“ im Dropdownmenü „**Source**“ (Quelle) die Option **None** (Keine) aus. ![Dropdownmenü zum Auswählen einer Veröffentlichungsquelle](/assets/images/help/pages/publishing-source-drop-down.png) +5. Under " +{% data variables.product.prodname_pages %}", use the **Source** drop-down menu and select **None.** + ![Dropdownmenü zum Auswählen einer Veröffentlichungsquelle](/assets/images/help/pages/publishing-source-drop-down.png) {% data reusables.pages.update_your_dns_settings %} ### Veröffentlichung einer Benutzer- oder Organisations-Website zurückziehen diff --git a/translations/de-DE/content/github/working-with-github-pages/using-submodules-with-github-pages.md b/translations/de-DE/content/github/working-with-github-pages/using-submodules-with-github-pages.md index e72116ca6d7b..5a94b9a613a4 100644 --- a/translations/de-DE/content/github/working-with-github-pages/using-submodules-with-github-pages.md +++ b/translations/de-DE/content/github/working-with-github-pages/using-submodules-with-github-pages.md @@ -1,6 +1,6 @@ --- title: Using submodules with GitHub Pages -intro: 'Du kannst Submodule in {% data variables.product.prodname_pages %} nutzen und damit andere Projekte in den Code Deiner Website einbinden.' +intro: 'Sie können Submodule in {% data variables.product.prodname_pages %} nutzen und damit andere Projekte in den Code Ihrer Website einbinden.' redirect_from: - /articles/using-submodules-with-pages/ - /articles/using-submodules-with-github-pages @@ -9,9 +9,9 @@ versions: free-pro-team: '*' --- -Wenn das Repository für Deine {% data variables.product.prodname_pages %}-Website Submodule enthält, wird deren Inhalt automatisch beim Erstellen der Website abgerufen. +Wenn das Repository für Ihre {% data variables.product.prodname_pages %}-Website Submodule enthält, wird deren Inhalt automatisch beim Erstellen der Website abgerufen. -Du kannst nur Submodule verwenden, die auf öffentliche Repositorys verweisen, da der {% data variables.product.prodname_pages %}-Server nicht auf private Repositorys zugreifen kann. +Sie können nur Submodule verwenden, die auf öffentliche Repositorys verweisen, da der {% data variables.product.prodname_pages %}-Server nicht auf private Repositorys zugreifen kann. Verwende die schreibgeschützte `https://`-URL für Submodule, einschließlich verschachtelter Submodule. Du kannst diese Änderung in Deiner _.gitmodules_-Datei vornehmen. diff --git a/translations/de-DE/content/github/working-with-github-support/about-github-premium-support-for-github-enterprise-cloud.md b/translations/de-DE/content/github/working-with-github-support/about-github-premium-support-for-github-enterprise-cloud.md index a3610ff3ad2f..c17951dd2d3c 100644 --- a/translations/de-DE/content/github/working-with-github-support/about-github-premium-support-for-github-enterprise-cloud.md +++ b/translations/de-DE/content/github/working-with-github-support/about-github-premium-support-for-github-enterprise-cloud.md @@ -46,7 +46,7 @@ Der {% data variables.contact.premium_support %} ist rund um die Uhr verfügbar. ### Einem Support-Ticket eine Priorität zuweisen -Wenn Du den {% data variables.contact.premium_support %} kontaktierst, kannst Du eine von vier Prioritäten für das Ticket auswählen: „{% data variables.product.support_ticket_priority_urgent %}“ (dringend), „{% data variables.product.support_ticket_priority_high %}“ (hoch), „{% data variables.product.support_ticket_priority_normal %}“ (normal) oder „{% data variables.product.support_ticket_priority_low %}“ (niedrig). +Wenn Du {% data variables.contact.premium_support %}kontaktierst, kannst Du eine von vier Prioritäten für das Ticket auswählen: {% data variables.product.support_ticket_priority_urgent %}, {% data variables.product.support_ticket_priority_high %}, {% data variables.product.support_ticket_priority_normal %} oder {% data variables.product.support_ticket_priority_low %}. {% data reusables.support.github-can-modify-ticket-priority %} diff --git a/translations/de-DE/content/github/working-with-github-support/about-github-support.md b/translations/de-DE/content/github/working-with-github-support/about-github-support.md index a7dd1bc44540..c66785c11742 100644 --- a/translations/de-DE/content/github/working-with-github-support/about-github-support.md +++ b/translations/de-DE/content/github/working-with-github-support/about-github-support.md @@ -1,6 +1,6 @@ --- title: Informationen zum GitHub Support -intro: 'Der {% data variables.contact.github_support %} kann Dir helfen, Probleme zu beheben, auf die Du bei der Verwendung von {% data variables.product.prodname_dotcom %} stößt.' +intro: 'Der {% data variables.contact.github_support %} kann Ihnen helfen, Probleme zu beheben, auf die Sie bei der Verwendung von {% data variables.product.prodname_dotcom %} stoßen.' redirect_from: - /articles/about-github-support versions: @@ -11,13 +11,13 @@ versions: Die Supportoptionen variieren je nach Deinem {% data variables.product.prodname_dotcom_the_website %}-Produkt. Wenn Du ein bezahltes Produkt hast, kannst Du {% data variables.contact.github_support %} in Englisch kontaktieren. Dein Konto beinhaltet allenfalls auch {% data variables.contact.premium_support %}. -| | {% data variables.product.prodname_gcf %} | Standard-Support | Premium Support | -| ------------------------------------------------------ | ---------------------------------------------- | ---------------- | --------------- | -| {% data variables.product.prodname_free_user %} | X | | | -| {% data variables.product.prodname_pro %} | X | X | | -| {% data variables.product.prodname_team %} | X | X | | -| {% data variables.product.prodname_ghe_cloud %} | X | X | X | -| {% data variables.product.prodname_ghe_server %} | X | X | X | +| | {% data variables.product.prodname_gcf %} | Standard-Support | Premium Support | +| -------------------------------------------------- | ----------------------------------------- | ---------------- | --------------- | +| {% data variables.product.prodname_free_user %} | X | | | +| {% data variables.product.prodname_pro %} | X | X | | +| {% data variables.product.prodname_team %} | X | X | | +| {% data variables.product.prodname_ghe_cloud %} | X | X | X | +| {% data variables.product.prodname_ghe_server %} | X | X | X | Um zu prüfen, ob es derzeit Probleme gibt, die die Dienstleistungen von {% data variables.product.prodname_dotcom %} beeinflussen, oder um Benachrichtigungen über zukünftige Statusaktualisierungen zu abonnieren und zu erhalten, besuche die [Statusseite](https://www.githubstatus.com/) von {% data variables.product.prodname_dotcom %}. diff --git a/translations/de-DE/content/github/working-with-github-support/github-enterprise-cloud-support.md b/translations/de-DE/content/github/working-with-github-support/github-enterprise-cloud-support.md index da9691f89bc7..be18e2920dbe 100644 --- a/translations/de-DE/content/github/working-with-github-support/github-enterprise-cloud-support.md +++ b/translations/de-DE/content/github/working-with-github-support/github-enterprise-cloud-support.md @@ -15,20 +15,20 @@ versions: {% endnote %} -Du kannst Prioritätsanfragen einreichen, wenn Du {% data variables.product.prodname_ghe_cloud %} gekauft hast oder ein Mitglied, externer Mitarbeiter oder Abrechnungsmanager einer {% data variables.product.prodname_dotcom %}-Organisation bist, die aktuell {% data variables.product.prodname_ghe_cloud %} abonniert hat. +Sie können Prioritätsfragen einreichen, wenn Sie {% data variables.product.prodname_ghe_cloud %} gekauft haben oder ein Mitglied, externer Mitarbeiter oder Abrechnungsmanager einer {% data variables.product.prodname_dotcom %}-Organisation sind, die aktuell {% data variables.product.prodname_ghe_cloud %} abonniert hat. Fragen, die für Prioritätsantworten qualifiziert sind: -- Fragen, die sich darauf beziehen, dass Du nicht auf die zentrale Funktion zur Versionskontrolle von {% data variables.product.prodname_dotcom %} zugreifen oder sie nicht nutzen kannst +- Fragen, die sich darauf beziehen, dass Sie nicht auf die zentrale Funktion zur Versionskontrolle von {% data variables.product.prodname_dotcom %} zugreifen oder sie nicht nutzen können - Fragen in Zusammenhang mit der Sicherheit Deines Kontos - Fragen zu peripheren Diensten und Funktionen sind nicht abgedeckt, z. B. Fragen zu Gists, {% data variables.product.prodname_pages %} oder E-Mail-Benachrichtigungen - Fragen ausschließlich zu Organisationen, die aktuell {% data variables.product.prodname_ghe_cloud %} verwenden Damit Du Dich für eine Prioritätsantwort qualifizierst, musst Du folgende Voraussetzungen erfüllen: -- Du reichst Deine Frage an [{% data variables.contact.enterprise_support %}](https://enterprise.githubsupport.com/hc/en-us/requests/new?github_product=cloud) über eine verifizierte E-Mail-Adresse ein, die mit einer Organisation verknüpft ist, die aktuell {% data variables.product.prodname_ghe_cloud %} verwendet +- Sie versenden Ihre Frage an [{% data variables.contact.enterprise_support %}](https://enterprise.githubsupport.com/hc/en-us/requests/new?github_product=cloud) über eine verifizierte E-Mail-Adresse, die mit einer Organisation verknüpft ist, die {% data variables.product.prodname_ghe_cloud %} aktuell verwendet. - Du reichst bei jeder einzelnen Prioritätssituation ein neues Supportticket ein - Du reichst Deine Frage von Montag bis Freitag in Deiner lokalen Zeitzone ein - Du weißt, dass Du die Antwort auf eine Prioritätsanfrage per E-Mail erhältst -- Du arbeitest mit {% data variables.contact.github_support %} zusammen und stellst sämtliche Informationen bereit, um die Dich {% data variables.contact.github_support %} bittet +- Sie arbeiten mit {% data variables.contact.github_support %} zusammen und stellen sämtliche Informationen bereit, um die Sie {% data variables.contact.github_support %} bittet. {% tip %} @@ -37,12 +37,12 @@ Damit Du Dich für eine Prioritätsantwort qualifizierst, musst Du folgende Vora {% endtip %} Für die angestrebte Reaktionszeit von acht Stunden gilt: -- Sie beginnt zu dem Zeitpunkt, zu dem Deine qualifizierte Frage bei {% data variables.contact.github_support %} eingeht +- Sie beginnt zu dem Zeitpunkt, zu dem Ihre qualifizierte Frage bei {% data variables.contact.github_support %} eingeht. - Sie beginnt erst, wenn Du ausreichend Informationen bereitgestellt hast, damit die Frage beantwortet werden kann, es sei denn, Du gibst explizit an, dass Dir nicht genügend Informationen vorliegen - Sie gilt nicht an Wochenenden in Deiner lokalen Zeitzone oder an lokalen Feiertagen in Deiner Region {% note %} -**Hinweis:** {% data variables.contact.github_support %} garantiert keine Lösung für Deine Prioritätsanfrage. {% data variables.contact.github_support %} kann Issues auf einen anderen Prioritätsanfragen-Status hoch- oder herabstufen, basierend auf unserer vernünftigen Bewertung der von Dir bereitgestellten Informationen. +**Hinweis:** {% data variables.contact.github_support %} garantiert keine Lösung für Deine Prioritätsanfrage. {% data variables.contact.github_support %} kann Issues auf einen anderen Prioritätsfragen-Status hoch- oder herabstufen, basierend auf unserer vernünftigen Bewertung der von Ihnen bereitgestellten Informationen. {% endnote %} diff --git a/translations/de-DE/content/github/working-with-github-support/github-marketplace-support.md b/translations/de-DE/content/github/working-with-github-support/github-marketplace-support.md index 7dfc27f8bdd7..4f3f52e65f72 100644 --- a/translations/de-DE/content/github/working-with-github-support/github-marketplace-support.md +++ b/translations/de-DE/content/github/working-with-github-support/github-marketplace-support.md @@ -1,6 +1,6 @@ --- title: GitHub Marketplace-Support -intro: 'Wenn Du Unterstützung beim Kauf oder beim Bezahlen einer App von {% data variables.product.prodname_marketplace %} benötigst, wende Dich an den {% data variables.contact.contact_support %}. Wenn Du Hilfe beim Verwenden einer {% data variables.product.prodname_marketplace %}-App brauchst, wende Dich an den Anbieter der jeweiligen App.' +intro: 'Wenn Sie Unterstützung beim Kauf oder beim Bezahlen einer App von {% data variables.product.prodname_marketplace %} benötigen, wenden Sie sich an den {% data variables.contact.contact_support %}. Wenn Sie Hilfe beim Verwenden einer {% data variables.product.prodname_marketplace %}-App brauchen, wenden Sie sich an den Anbieter der jeweiligen App.' redirect_from: - /articles/github-marketplace-support versions: @@ -10,7 +10,7 @@ versions: ### App-Anbieter um Unterstützung bitten -Jede App von {% data variables.product.prodname_marketplace %} enthält einen Link, über den Du das zugehörige Supportteam erreichen kannst. +Jede App von {% data variables.product.prodname_marketplace %} umfasst einen Link, über den Sie das zugehörige Supportteam erreichen können. {% data reusables.marketplace.visit-marketplace %} 2. Rufe die Seite Deiner App auf. diff --git a/translations/de-DE/content/github/working-with-github-support/submitting-a-ticket.md b/translations/de-DE/content/github/working-with-github-support/submitting-a-ticket.md index 3bc70ea1a143..c1d430e05ca1 100644 --- a/translations/de-DE/content/github/working-with-github-support/submitting-a-ticket.md +++ b/translations/de-DE/content/github/working-with-github-support/submitting-a-ticket.md @@ -1,6 +1,6 @@ --- title: Ein Ticket einreichen -intro: 'Zum Einreichen eines Supporttickets an {% data variables.contact.github_support %} verwende das Supportportal.' +intro: 'Zum Einreichen eines Supporttickets an {% data variables.contact.github_support %} verwenden Sie das Supportportal.' redirect_from: - /articles/submitting-a-ticket versions: @@ -13,7 +13,7 @@ Wenn Du {% data variables.product.prodname_ghe_server %}, {% data variables.prod ### Ticket über das {% data variables.contact.support_portal %} einreichen -1. Navigiere zu {% data variables.contact.contact_support_portal %}. +1. Rufen Sie das {% data variables.contact.contact_support_portal %} auf. 2. Gib unter „Name" Deinen Namen ein. ![Feld „Name“](/assets/images/help/support/name-field.png) 3. Wähle im Dropdownmenü „Email“ (E-Mail) die E-Mail-Adresse aus, unter der Dich {% data variables.contact.github_support %} kontaktieren soll. ![Feld „Email“ (E-Mail)](/assets/images/help/support/email-field.png) 4. Geben Sie unter „Subject“ (Betreff) einen beschreibenden Titel zu Ihrem Issue ein. ![Feld „Subject“ (Betreff)](/assets/images/help/support/subject-field.png) diff --git a/translations/de-DE/content/github/writing-on-github/about-saved-replies.md b/translations/de-DE/content/github/writing-on-github/about-saved-replies.md index fd2a86c74c4d..9cb3bd169465 100644 --- a/translations/de-DE/content/github/writing-on-github/about-saved-replies.md +++ b/translations/de-DE/content/github/writing-on-github/about-saved-replies.md @@ -16,7 +16,7 @@ Sobald Du eine gespeicherte Antwort hinzugefügt hast, kann sie sowohl in Issues Du kannst maximal 100 gespeicherte Antworten erstellen. Wenn Du die Höchstgrenze erreicht hast, kannst Du gespeicherte Antworten, die Du nicht mehr verwendest, löschen oder vorhandene gespeicherte Antworten bearbeiten. -Du kannst auch die von {% data variables.product.product_name %} zur Verfügung gestellte gespeicherte Antwort „Duplicate issue“ (Doppelter Issue) verwenden, um einen Issue als Duplikat zu markieren und ihn mit einem ähnlichen Issue nachzuverfolgen. +Sie können auch die von {% data variables.product.product_name %} zur Verfügung gestellte gespeicherte Antwort „Duplicate issue“ (Doppelter Issue) verwenden, um einen Issue als Duplikat zu markieren und ihn mit einem ähnlichen Issue nachzuverfolgen. ### Weiterführende Informationen diff --git a/translations/de-DE/content/github/writing-on-github/autolinked-references-and-urls.md b/translations/de-DE/content/github/writing-on-github/autolinked-references-and-urls.md index 12bb9872e4a7..b3586a53163b 100644 --- a/translations/de-DE/content/github/writing-on-github/autolinked-references-and-urls.md +++ b/translations/de-DE/content/github/writing-on-github/autolinked-references-and-urls.md @@ -38,22 +38,19 @@ In Unterhaltungen auf {% data variables.product.product_name %} werden Verweise ### Commit-SHAs -Verweise auf den SHA-Hash eines Commits werden automatisch in verkürzte Links zum Commit auf {% data variables.product.product_name %} umgewandelt. +Verweise auf den SHA-Hash eines Commits werden zum Committen auf {% data variables.product.product_name %} automatisch in verkürzte Links umgewandelt. | Verweistyp | Rohverweis | Kurzlink | | --------------------------- | ------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------- | | Commit-URL | https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | | SHA | a5c3785ed8d6a35868bc169f07e40e889087fd2e | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | | Benutzer@SHA | jlord@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -| Benutzername/Repository@SHA | Benutzer/Repository@SHA: jlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord/sheetsee.js@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | +| Benutzername/Repository@SHA | jlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord/sheetsee.js@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} ### Benutzerdefinierte automatische Verknüpfungen von externen Ressourcen {% data reusables.repositories.autolink-references %} -{% endif %} - ### Weiterführende Informationen - „[Grundlegende Schreib- und Formatierungssyntax](/articles/basic-writing-and-formatting-syntax)“ diff --git a/translations/de-DE/content/github/writing-on-github/basic-writing-and-formatting-syntax.md b/translations/de-DE/content/github/writing-on-github/basic-writing-and-formatting-syntax.md index cc1ae262c85c..2d58f88b5070 100644 --- a/translations/de-DE/content/github/writing-on-github/basic-writing-and-formatting-syntax.md +++ b/translations/de-DE/content/github/writing-on-github/basic-writing-and-formatting-syntax.md @@ -170,7 +170,7 @@ Weitere Informationen findest Du unter „[Informationen zu Aufgabenlisten](/art ### Personen und Teams erwähnen -Du kannst auf {% data variables.product.product_name %} eine Person oder ein [Team](/articles/setting-up-teams/) erwähnen, indem Du `@` gefolgt vom Benutzer- respektive Teamnamen eingibst. This will trigger a notification and bring their attention to the conversation. Wenn Du einen Kommentar bearbeitest und dabei den Benutzer- oder Teamnamen erwähnst, wird die Person respektive das Team ebenfalls benachrichtigt. Weitere Informationen zu Benachrichtigungen findest Du unter {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}„[Über Benachrichtigungen](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}„[Über Benachrichtigungen](/github/receiving-notifications-about-activity-on-github/about-notifications){% endif %}." +Du kannst auf {% data variables.product.product_name %} eine Person oder ein [Team](/articles/setting-up-teams/) erwähnen, indem Du `@` gefolgt vom Benutzer- respektive Teamnamen eingibst. This will trigger a notification and bring their attention to the conversation. Wenn Du einen Kommentar bearbeitest und dabei den Benutzer- oder Teamnamen erwähnst, wird die Person respektive das Team ebenfalls benachrichtigt. For more information about notifications, 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 %}." `@github/support Wie findet ihr diese Aktualisierungen?` @@ -188,20 +188,17 @@ Du kannst eine Liste vorgeschlagener Issues und Pull Requests im Repository anze Weitere Informationen findest Du unter „[Automatisch verknüpfte Verweise und URLs](/articles/autolinked-references-and-urls).“ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} ### Auf externe Ressourcen verweisen {% data reusables.repositories.autolink-references %} -{% endif %} - ### Inhaltsanhänge Einige {% data variables.product.prodname_github_app %}s stellen Informationen in {% data variables.product.product_name %} für URLs bereit, die auf die registrierten Domänen verknüpfen. {% data variables.product.product_name %} zeigt die von der App bereitgestellten Informationen unter der URL im Text oder Kommentar eines Issues bzw. Pull Requests an. ![Inhaltsanhang](/assets/images/help/writing/content-attachment.png) -Um Inhaltsanhänge zu sehen, musst Du eine {% data variables.product.prodname_github_app %} besitzen, die das API für Inhaltsanhänge nutzt, welche auf dem Repository installiert ist.{% if currentVersion == "free-pro-team@latest" %} Weitere Informationen findest Du unter „[Eine App in Deinem persönlichen Konto installieren](/articles/installing-an-app-in-your-personal-account)“ und „[Eine App in Deiner Organisation installieren](/articles/installing-an-app-in-your-organization)“.{% endif %} +To see content attachments, you must have a {% data variables.product.prodname_github_app %} that uses the Content Attachments API installed on the repository.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[Installing an app in your personal account](/articles/installing-an-app-in-your-personal-account)" and "[Installing an app in your organization](/articles/installing-an-app-in-your-organization)."{% endif %} Für URLs, die Teil eines Markdown-Links sind, werden keine Inhaltsanhänge angezeigt. @@ -225,7 +222,7 @@ Um einen neuen Absatz zu erstellen, lasse eine Zeile zwischen den Textzeilen lee ### Markdown-Formatierung ignorieren -Du kannst {% data variables.product.product_name %} anweisen, die Markdown-Formatierung zu ignorieren (oder zu verlassen), indem Du das Markdown-Zeichen mit `\` maskierst. +Sie können {% data variables.product.product_name %} anweisen, die Markdown-Formatierung zu ignorieren, indem Sie das Markdown-Zeichen mit `\` maskieren. `Wir benennen \*unser-neues-Projekt\* in \*unser-altes-Projekt\* um.` diff --git a/translations/de-DE/content/github/writing-on-github/creating-and-highlighting-code-blocks.md b/translations/de-DE/content/github/writing-on-github/creating-and-highlighting-code-blocks.md index d1e26c83e2be..bd3980f349ea 100644 --- a/translations/de-DE/content/github/writing-on-github/creating-and-highlighting-code-blocks.md +++ b/translations/de-DE/content/github/writing-on-github/creating-and-highlighting-code-blocks.md @@ -1,6 +1,6 @@ --- title: Codeblöcke erstellen und markieren -intro: 'Gib Codebeispiele mit Fenced-Code-Blöcken frei, und aktiviere die Syntaxmarkierung.' +intro: Gib Codebeispiele mit Fenced-Code-Blöcken frei, und aktiviere die Syntaxmarkierung. redirect_from: - /articles/creating-and-highlighting-code-blocks versions: diff --git a/translations/de-DE/content/github/writing-on-github/creating-gists.md b/translations/de-DE/content/github/writing-on-github/creating-gists.md index 737c54f565a9..31189761acb0 100644 --- a/translations/de-DE/content/github/writing-on-github/creating-gists.md +++ b/translations/de-DE/content/github/writing-on-github/creating-gists.md @@ -13,11 +13,11 @@ versions: ### Informationen zu Gists -Jeder Gist ist ein Git-Repository, d. h., er kann geforkt und geklont werden. Wenn Du bei der Erstellung eines Gists bei {% data variables.product.product_name %} angemeldet bist, wird der Gist mit Deinem Konto verknüpft und in der Liste Deiner Gists angezeigt, wenn Du Deine {% data variables.gists.gist_homepage %} aufrufst. +Jeder Gist ist ein Git-Repository, d. h., er kann geforkt und geklont werden. Wenn Sie bei der Erstellung eines Gists bei {% data variables.product.product_name %} angemeldet sind, wird der Gist mit Ihrem Konto verknüpft und in der Liste Ihrer Gists angezeigt, wenn Sie Ihre {% data variables.gists.gist_homepage %} aufrufen. Gists können öffentlich oder geheim sein. Öffentliche Gists werden in {% data variables.gists.discover_url %} angezeigt, wo Benutzer neue Gists nach der Erstellung durchsuchen können. Gists können auch gesucht werden, Du kannst sie also verwenden, wenn Du möchtest, dass andere Benutzer Deine Arbeit finden und ansehen können. {% data reusables.gist.cannot-convert-public-gists-to-secret %} -Geheime Gists werden nicht in {% data variables.gists.discover_url %} angezeigt{% if currentVersion != "free-pro-team@latest" %}{% endif %} und können nicht gesucht werden. {% data reusables.gist.cannot-convert-public-gists-to-secret %} Geheime Gists sind nicht privat. Wenn Du die URL eines geheimen Gists an einen Freund sendest, kann er den Gist sehen. Wenn jemand, den Du nicht kennst, die URL findet, kann er Deinen Gist ebenfalls sehen. Wenn Du nicht möchtest, dass Dein Code von anderen gesehen werden kann, kannst Du stattdessen [ein privates Repository erstellen](/articles/creating-a-new-repository). +Secret gists don't show up in {% data variables.gists.discover_url %}{% if currentVersion != "free-pro-team@latest" %},{% endif %} and are not searchable. {% data reusables.gist.cannot-convert-public-gists-to-secret %} Geheime Gists sind nicht privat. Wenn Du die URL eines geheimen Gists an einen Freund sendest, kann er den Gist sehen. Wenn jemand, den Du nicht kennst, die URL findet, kann er Deinen Gist ebenfalls sehen. Wenn Du nicht möchtest, dass Dein Code von anderen gesehen werden kann, kannst Du stattdessen [ein privates Repository erstellen](/articles/creating-a-new-repository). {% if currentVersion != "free-pro-team@latest" %} @@ -27,17 +27,14 @@ Wenn Dein Websiteadministrator den privaten Modus deaktiviert hat, kannst Du auc {% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} - In folgenden Fällen erhältst Du eine Benachrichtigung: - Du bist der Autor eines Gists. - Jemand erwähnt Dich in einem Gist. - Du abonnierst einen Gist, indem Du oben im Gist auf **Subscribe** (Abonnieren) klickst. -{% endif %} -Du kannst Gists an Deinem Profil anheften, damit andere Personen sie leichter sehen. Weitere Informationen findest Du unter „[Elemente an Dein Profil anheften](/articles/pinning-items-to-your-profile).“ +Du kannst Gists an Deinem Profil anheften, damit andere Personen sie leichter sehen. Weitere Informationen finden Sie unter „[Elemente an Ihr Profil anheften](/articles/pinning-items-to-your-profile)“. -Um Gists zu entdecken, die von anderen Benutzern erstellt wurden, rufe die {% data variables.gists.gist_homepage %} auf und klicke dort auf **All Gists** (Alle Gists). Daraufhin wird eine Seite mit allen Gists angezeigt, die nach dem Zeitpunkt der Erstellung oder Aktualisierung sortiert sind. Mit der {% data variables.gists.gist_search_url %} kannst Du Gists auch nach Sprache suchen. Die Gist-Suche nutzt dieselbe Suchsyntax wie [die Codesuche](/articles/searching-code). +Um Gists zu entdecken, die von anderen Benutzern erstellt wurden, rufe die {% data variables.gists.gist_homepage %} auf und klicke dort auf **All Gists** (Alle Gists). Daraufhin wird eine Seite mit allen Gists angezeigt, die nach dem Zeitpunkt der Erstellung oder Aktualisierung sortiert sind. Mit der {% data variables.gists.gist_search_url %} können Sie Gists auch nach Sprache suchen. Die Gist-Suche nutzt dieselbe Suchsyntax wie [die Codesuche](/articles/searching-code). Da es sich bei Gists um Git-Repositorys handelt, kannst Du ihren vollständigen Commit-Verlauf anzeigen, einschließlich der Diffs. Du kannst Gists auch forken oder klonen. Weitere Informationen findest Du unter „[Gists forken und klonen](/articles/forking-and-cloning-gists)“. @@ -61,8 +58,8 @@ You can also create a gist using the {% data variables.product.prodname_cli %}. {% endnote %} {% endif %} -1. Melde Dich bei {% data variables.product.product_name %} an. -2. Navigiere zu Deiner {% data variables.gists.gist_homepage %}. +1. Melden Sie sich bei {% data variables.product.product_name %} an. +2. Navigieren Sie zu Ihrer {% data variables.gists.gist_homepage %}. 3. Gib eine optionale Beschreibung und einen Namen für Deinen Gist ein. ![Name und Beschreibung des Gists](/assets/images/help/gist/gist_name_description.png) 4. Gib den Text für den Gist in das Gist-Textfeld ein. ![Gist-Textfeld](/assets/images/help/gist/gist_text_box.png) diff --git a/translations/de-DE/content/graphql/guides/managing-enterprise-accounts.md b/translations/de-DE/content/graphql/guides/managing-enterprise-accounts.md index d7810c93fda6..342dbc87e477 100644 --- a/translations/de-DE/content/graphql/guides/managing-enterprise-accounts.md +++ b/translations/de-DE/content/graphql/guides/managing-enterprise-accounts.md @@ -5,7 +5,7 @@ redirect_from: - /v4/guides/managing-enterprise-accounts versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- ### About managing enterprise accounts with GraphQL diff --git a/translations/de-DE/content/index.md b/translations/de-DE/content/index.md index 2719012e5207..1800e3661d03 100644 --- a/translations/de-DE/content/index.md +++ b/translations/de-DE/content/index.md @@ -11,8 +11,6 @@ popularLinks: - /github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line - /github/using-git/managing-remote-repositories - /github/working-with-github-pages -versions: - free-pro-team: '*' - enterprise-server: '*' +versions: '*' --- diff --git a/translations/de-DE/content/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights.md b/translations/de-DE/content/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights.md index ae8a68971f9d..1d4e6eb41354 100644 --- a/translations/de-DE/content/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights.md +++ b/translations/de-DE/content/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights.md @@ -4,7 +4,7 @@ intro: '' product: '{% data reusables.gated-features.github-insights %}' permissions: 'Anyone with access to {% data variables.product.prodname_insights %} can navigate between {% data variables.product.prodname_enterprise %} and {% data variables.product.prodname_insights %}.' versions: - enterprise-server: '>=2.19' + enterprise-server: '*' --- Before you can navigate between {% data variables.product.prodname_enterprise %} and {% data variables.product.prodname_insights %}, a site administrator must enable a link between {% data variables.product.prodname_insights %} and {% data variables.product.prodname_enterprise %}. For more information, see "[Enabling a link between {% data variables.product.prodname_insights %} and {% data variables.product.prodname_enterprise %}](/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise)." diff --git a/translations/de-DE/content/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise.md b/translations/de-DE/content/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise.md index 188b6b3d2980..b6603567d945 100644 --- a/translations/de-DE/content/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise.md +++ b/translations/de-DE/content/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise.md @@ -7,7 +7,7 @@ redirect_from: - /github/installing-and-configuring-github-insights/navigating-between-github-insights-and-github-enterprise - /github/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise versions: - enterprise-server: '>=2.19' + enterprise-server: '*' --- After you enable the link, each user can navigate directly from {% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_insights %}. For more information, see "[Navigating between {% data variables.product.prodname_enterprise %} and {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights)." @@ -17,7 +17,8 @@ After you enable the link, each user can navigate directly from {% data variable ``` ghe-config 'app.github.insights-available' 'true' && ghe-config-apply ``` -3. Kehren Sie zu {% data variables.product.prodname_ghe_server %} zurück. +3. Return to +{% data variables.product.prodname_ghe_server %}. {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.settings-tab %} diff --git a/translations/de-DE/content/insights/installing-and-configuring-github-insights/installing-github-insights.md b/translations/de-DE/content/insights/installing-and-configuring-github-insights/installing-github-insights.md index f7a704395ad3..0170457eea01 100644 --- a/translations/de-DE/content/insights/installing-and-configuring-github-insights/installing-github-insights.md +++ b/translations/de-DE/content/insights/installing-and-configuring-github-insights/installing-github-insights.md @@ -28,7 +28,8 @@ versions: To connect {% data variables.product.prodname_insights %} to {% data variables.product.prodname_enterprise %}, you must create a {% data variables.product.prodname_github_app %} in an organization on {% data variables.product.prodname_enterprise %}. A slugged version of your app's name will be shown on {% data variables.product.prodname_enterprise %} when your integration takes an action. {% data reusables.enterprise_site_admin_settings.sign-in %} -2. Navigate to the organization you'd like to connect to {% data variables.product.prodname_insights %}. +2. Navigate to the organization you'd like to connect to +{% data variables.product.prodname_insights %}. {% data reusables.organizations.org_settings %} {% data reusables.organizations.github-apps-settings-sidebar %} 5. Click **New {% data variables.product.prodname_github_app %}**. ![New GitHub App button](/assets/images/help/apps/github_apps_new.png) diff --git a/translations/de-DE/content/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images.md b/translations/de-DE/content/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images.md index 8b784ad4c809..05268dd9ac00 100644 --- a/translations/de-DE/content/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images.md +++ b/translations/de-DE/content/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images.md @@ -24,8 +24,8 @@ Weitere Informationen findest Du unter „[Informationen zu {% data variables.pr The domain for the {% data variables.product.prodname_container_registry %} is `ghcr.io`. -| Registry | Example URL | -| ---------------------------------------------------------------------- | --------------------------------------------------- | +| Registry | Example URL | +| ----------------------------------------------------------------- | --------------------------------------------------- | | {% data variables.product.prodname_registry %} Docker registry | `docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME` | | {% data variables.product.prodname_github_container_registry %} | `ghcr.io/OWNER/IMAGE_NAME` | @@ -33,7 +33,9 @@ The domain for the {% data variables.product.prodname_container_registry %} is ` You will need to authenticate to the {% data variables.product.prodname_container_registry %} with the base URL `ghcr.io`. We recommend creating a new access token for using the {% data variables.product.prodname_container_registry %}. -{% data reusables.package_registry.authenticate-to-container-registry %} +{% data reusables.package_registry.authenticate_with_pat_for_container_registry %} + +{% data reusables.package_registry.authenticate-to-container-registry-steps %} ### Migrating a Docker image using the Docker CLI @@ -55,7 +57,9 @@ To move Docker images that you host on {% data variables.product.prodname_regist $ docker tag docker.pkg.github.com/SOURCE_OWNER/SOURCE_REPOSITORY/SOURCE_IMAGE_NAME:VERSION ghcr.io/TARGET_OWNER/TARGET_IMAGE_NAME:VERSION ``` -4. Sign in to the new {% data variables.product.prodname_container_registry %}. We recommend creating a new PAT limited to the `read:packages` and `write:packages` scopes since you no longer need the `repo` scope and your previous PAT may not have the `write:packages` scope. +4. Sign in to the new + +{% data variables.product.prodname_container_registry %}. We recommend creating a new PAT limited to the `read:packages` and `write:packages` scopes since you no longer need the `repo` scope and your previous PAT may not have the `write:packages` scope. {% raw %} ```shell $ echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin diff --git a/translations/de-DE/content/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image.md b/translations/de-DE/content/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image.md index c5d9dea6bdf1..fc46559e32f2 100644 --- a/translations/de-DE/content/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image.md +++ b/translations/de-DE/content/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image.md @@ -62,7 +62,9 @@ https://github.com/monalisa/hello_docker $ docker tag 38f737a91f39 ghcr.io/monalisa/hello_docker:latest ``` -5. If you haven't already, authenticate to {% data variables.product.prodname_github_container_registry %}. For more information, see "[Authenticating to GitHub Container Registry](/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images#authenticating-to-github-container-registry)." +5. If you haven't already, authenticate to + +{% data variables.product.prodname_github_container_registry %}. For more information, see "[Authenticating to GitHub Container Registry](/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images#authenticating-to-github-container-registry)." {% raw %} ```shell $ echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin diff --git a/translations/de-DE/content/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images.md b/translations/de-DE/content/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images.md index 612eef8648c2..278fb66f7e85 100644 --- a/translations/de-DE/content/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images.md +++ b/translations/de-DE/content/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images.md @@ -12,13 +12,15 @@ To push and pull container images owned by an organization, an organization admi ### Bei {% data variables.product.prodname_github_container_registry %} authentifizieren -{% data reusables.package_registry.authenticate-to-container-registry %} +{% data reusables.package_registry.authenticate_with_pat_for_container_registry %} + +{% data reusables.package_registry.authenticate-to-container-registry-steps %} ### Pushing container images This example pushes the latest version of `IMAGE-NAME`. ```shell - $ docker push ghcr.io/OWNER/IMAGE_NAME.latest + $ docker push ghcr.io/OWNER/IMAGE_NAME:latest ``` This example pushes the `2.5` version of the image. diff --git a/translations/de-DE/content/packages/publishing-and-managing-packages/about-github-packages.md b/translations/de-DE/content/packages/publishing-and-managing-packages/about-github-packages.md index aecf4ecfe162..168d2e328289 100644 --- a/translations/de-DE/content/packages/publishing-and-managing-packages/about-github-packages.md +++ b/translations/de-DE/content/packages/publishing-and-managing-packages/about-github-packages.md @@ -34,18 +34,18 @@ You can configure webhooks to subscribe to package-related events, such as when #### About package permissions and visibility {% if currentVersion == "free-pro-team@latest" %} -| | Package registries | {% data variables.product.prodname_github_container_registry %} | +| | Package registries | {% data variables.product.prodname_github_container_registry %} | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Hosting locations | You can host multiple packages in one repository. | You can host multiple container images in one organization or user account. | -| Permissions | {% data reusables.package_registry.public-or-private-packages %} You can use {% data variables.product.prodname_dotcom %} roles and teams to limit who can install or publish each package, as packages inherit the permissions of the repository. Anyone with read permissions for a repository can install a package as a dependency in a project, and anyone with write permissions can publish a new package version. | For each container image, you can choose the access level that others have. The permissions for container image access are separate from your organization and repository permissions. | +| Permissions | {{ site.data.reusables.package_registry.public-or-private-packages }} You can use {{ site.data.variables.product.prodname_dotcom }} roles and teams to limit who can install or publish each package, as packages inherit the permissions of the repository. Anyone with read permissions for a repository can install a package as a dependency in a project, and anyone with write permissions can publish a new package version. | For each container image, you can choose the access level that others have. The permissions for container image access are separate from your organization and repository permissions. | Visibility | {% data reusables.package_registry.public-or-private-packages %} | You can set the visibility of each of your container images. A private container image is only visible to people and teams who are given access within your organization. A public container image is visible to anyone. | Anonymous access | N/A | You can access public container images anonymously. {% else %} | | Package registries | | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Hosting locations | You can host multiple packages in one repository. | -| Permissions | {% data reusables.package_registry.public-or-private-packages %} You can use {% data variables.product.prodname_dotcom %} roles and teams to limit who can install or publish each package, as packages inherit the permissions of the repository. Anyone with read permissions for a repository can install a package as a dependency in a project, and anyone with write permissions can publish a new package version. | -| Visibility | {% data reusables.package_registry.public-or-private-packages %} | +| Permissions | {{ site.data.reusables.package_registry.public-or-private-packages }} You can use {{ site.data.variables.product.prodname_dotcom }} roles and teams to limit who can install or publish each package, as packages inherit the permissions of the repository. Anyone with read permissions for a repository can install a package as a dependency in a project, and anyone with write permissions can publish a new package version. | +| Visibility | {% data reusables.package_registry.public-or-private-packages %} {% endif %} @@ -60,8 +60,7 @@ For more information about permissions and visibility for {% data variables.prod {% data reusables.package_registry.packages-billing %} Weitere Informationen findest Du unter „[Informationen zur Abrechnung für {% data variables.product.prodname_registry %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)“. - -{{ site.data.reusables/package_registry/container-registry-beta-billing-note }} +{% data reusables.package_registry.container-registry-beta-billing-note %} {% endif %} ### Unterstützte Clients und Formate @@ -76,8 +75,9 @@ The {% data variables.product.prodname_github_container_registry %} hosts contai | Paketclient | Sprache | Paketformat | Beschreibung | | ----------- | ------- | ------------ | ----------------------------------- | | docker | N/A | `Dockerfile` | Docker-Containermanagementplattform | +For more information about the container support offered by -For more information about the container support offered by {% data variables.product.prodname_github_container_registry %}, see "[About {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry)." +{% data variables.product.prodname_github_container_registry %}, see "[About {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry)." {% endif %} #### Support for package registries @@ -144,10 +144,10 @@ For more information about configuring your package client for use with {% data {% if currentVersion == "free-pro-team@latest" %} ### About tokens -| Scope | Beschreibung | -| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `read:packages` | Download and install container images from {% data variables.product.prodname_github_container_registry %} | -| `write:packages` | Upload and publish container images to {% data variables.product.prodname_github_container_registry %} | +| Scope | Beschreibung | +| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `read:packages` | Download and install container images from {% data variables.product.prodname_github_container_registry %} +| `write:packages` | Upload and publish container images to {% data variables.product.prodname_github_container_registry %} | `delete:packages` | Delete specified versions of private or public container images from {% data variables.product.prodname_github_container_registry %}. For more information, see "[Deleting a container image](/packages/managing-container-images-with-github-container-registry/deleting-a-container-image)." | To learn about available scopes and permissions for container images, see "[About {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry)" or "[Configuring access control and visibility for container images](/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images)." @@ -166,9 +166,9 @@ Ein Beispiel: | Scope | Beschreibung | Repository permissions | | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- | -| `read:packages` | Download and install packages from {% data variables.product.prodname_registry %} | Lesen | -| `write:packages` | Upload and publish packages to {% data variables.product.prodname_registry %} | schreiben | -| `delete:packages` | Delete specified versions of private packages from {% data variables.product.prodname_registry %} | verwalten | +| `read:packages` | Download and install packages from {% data variables.product.prodname_registry %} | Lesen | +| `write:packages` | Upload and publish packages to {% data variables.product.prodname_registry %} | schreiben | +| `delete:packages` | Delete specified versions of private packages from {% data variables.product.prodname_registry %} | verwalten | | `repo` | Install, upload, and delete certain packages in private repositories (along with `read:packages`, `write:packages`, or `delete:packages`) | read, write, or admin | When you create a {% data variables.product.prodname_actions %} workflow, you can use the `GITHUB_TOKEN` to publish and install packages in {% data variables.product.prodname_registry %} without needing to store and manage a personal access token. @@ -180,14 +180,15 @@ Weitere Informationen findest Du unter: ### Managing packages -You can a delete a version of a private package on {% data variables.product.prodname_dotcom %} or using the GraphQL API. When you use the GraphQL API to query and delete private packages, you must use the same token you use to authenticate to {% data variables.product.prodname_registry %}. For more information, see "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package)" and "[Forming calls with GraphQL](/v4/guides/forming-calls/)." +You can delete a version of a private package on {% data variables.product.product_name %} or using the GraphQL API. When you use the GraphQL API to query and delete private packages, you must use the same token you use to authenticate to {% data variables.product.prodname_registry %}. For more information, see "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package)" and "[Forming calls with GraphQL](/v4/guides/forming-calls/)." You can configure webhooks to subscribe to package-related events, such as when a package is published or updated. For more information, see the "[`package` webhook event](/webhooks/event-payloads/#package)." ### Support kontaktieren {% if currentVersion == "free-pro-team@latest" %} -If you have feedback or feature requests for {% data variables.product.prodname_registry %}, use the [feedback form for {% data variables.product.prodname_registry %}](https://support.github.com/contact/feedback?contact%5Bcategory%5D=github-packages). +If you have feedback or feature requests for +{% data variables.product.prodname_registry %}, use the [feedback form for {% data variables.product.prodname_registry %}](https://support.github.com/contact/feedback?contact%5Bcategory%5D=github-packages). Contact {% data variables.contact.github_support %} about {% data variables.product.prodname_registry %} using [our contact form](https://support.github.com/contact?form%5Bsubject%5D=Re:%20GitHub%20Packages) if: @@ -196,6 +197,7 @@ Contact {% data variables.contact.github_support %} about {% data variables.prod * Your published package contains sensitive data, such as GDPR violations, API Keys, or personally identifying information {% else %} -If you need support for {% data variables.product.prodname_registry %}, please contact your site administrators. +If you need support for +{% data variables.product.prodname_registry %}, please contact your site administrators. {% endif %} diff --git a/translations/de-DE/content/packages/publishing-and-managing-packages/deleting-a-package.md b/translations/de-DE/content/packages/publishing-and-managing-packages/deleting-a-package.md index de68110bf756..876ad8661691 100644 --- a/translations/de-DE/content/packages/publishing-and-managing-packages/deleting-a-package.md +++ b/translations/de-DE/content/packages/publishing-and-managing-packages/deleting-a-package.md @@ -11,7 +11,6 @@ versions: {% data reusables.package_registry.packages-ghes-release-stage %} - {% if currentVersion == "free-pro-team@latest" %} ### About container image deletion diff --git a/translations/de-DE/content/packages/publishing-and-managing-packages/installing-a-package.md b/translations/de-DE/content/packages/publishing-and-managing-packages/installing-a-package.md index d8fb93790bdc..11c109094fc6 100644 --- a/translations/de-DE/content/packages/publishing-and-managing-packages/installing-a-package.md +++ b/translations/de-DE/content/packages/publishing-and-managing-packages/installing-a-package.md @@ -20,7 +20,7 @@ After you find a package, you can read the package's description and installatio ### Ein Paket installieren -You can install a package from {% data variables.product.prodname_registry %} using any supported package client by following the same general guidelines. +You can install a package from {% data variables.product.prodname_registry %} using any {% if currentVersion == "free-pro-team@latest" %}supported package client{% else %}package type enabled for your instance{% endif %} by following the same general guidelines. 1. Authenticate to {% data variables.product.prodname_registry %} using the instructions for your package client. For more information, see "[About tokens](/packages/publishing-and-managing-packages/about-github-packages#about-tokens)." 2. Install the package using the instructions for your package client. diff --git a/translations/de-DE/content/packages/publishing-and-managing-packages/publishing-a-package.md b/translations/de-DE/content/packages/publishing-and-managing-packages/publishing-a-package.md index 38af704d6403..e47374863e38 100644 --- a/translations/de-DE/content/packages/publishing-and-managing-packages/publishing-a-package.md +++ b/translations/de-DE/content/packages/publishing-and-managing-packages/publishing-a-package.md @@ -21,12 +21,13 @@ You can help people understand and use your package by providing a description a {% data reusables.package_registry.package-immutability %} {% if currentVersion == "free-pro-team@latest" %} -If a new version of a package fixes a security vulnerability, you should publish a security advisory in your repository. {% data variables.product.prodname_dotcom %} reviews each published security advisory and may use it to send {% data variables.product.prodname_dependabot_short %} alerts to affected repositories. For more information, see "[About GitHub Security Advisories](/github/managing-security-vulnerabilities/about-github-security-advisories)." +If a new version of a package fixes a security vulnerability, you should publish a security advisory in your repository. +{% data variables.product.prodname_dotcom %} reviews each published security advisory and may use it to send {% data variables.product.prodname_dependabot_short %} alerts to affected repositories. For more information, see "[About GitHub Security Advisories](/github/managing-security-vulnerabilities/about-github-security-advisories)." {% endif %} ### Ein Paket veröffentlichen -You can publish a package to {% data variables.product.prodname_registry %} using any supported package client by following the same general guidelines. +You can publish a package to {% data variables.product.prodname_registry %} using any {% if currentVersion == "free-pro-team@latest" %}supported package client{% else %}package type enabled for your instance{% endif %} by following the same general guidelines. 1. Create or use an existing access token with the appropriate scopes for the task you want to accomplish. Weitere Informationen findest Du unter „[Über {% data variables.product.prodname_registry %}](/packages/publishing-and-managing-packages/about-github-packages#authenticating-to-github-packages)." 2. Authenticate to {% data variables.product.prodname_registry %} using your access token and the instructions for your package client. diff --git a/translations/de-DE/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-apache-maven-for-use-with-github-packages.md b/translations/de-DE/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-apache-maven-for-use-with-github-packages.md index c43c701e8944..13b5a865bcc4 100644 --- a/translations/de-DE/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-apache-maven-for-use-with-github-packages.md +++ b/translations/de-DE/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-apache-maven-for-use-with-github-packages.md @@ -13,9 +13,9 @@ versions: {% data reusables.package_registry.packages-ghes-release-stage %} -**Note:** When installing or publishing a docker image, {% data variables.product.prodname_registry %} does not currently support foreign layers, such as Windows images. +{% data reusables.package_registry.admins-can-configure-package-types %} -### Bei {% data variables.product.prodname_registry %} authentifizieren +### Authenticating to {% data variables.product.prodname_registry %} {% data reusables.package_registry.authenticate-packages %} @@ -27,7 +27,7 @@ You can authenticate to {% data variables.product.prodname_registry %} with Apac In the `servers` tag, add a child `server` tag with an `id`, replacing *USERNAME* with your {% data variables.product.prodname_dotcom %} username, and *TOKEN* with your personal access token. -In the `repositories` tag, configure a repository by mapping the `id` of the repository to the `id` you added in the `server` tag containing your credentials. In the `repositories` tag, configure a repository by mapping the `id` of the repository to the `id` you added in the `server` tag containing your credentials. {% data reusables.package_registry.lowercase-name-field %} +In the `repositories` tag, configure a repository by mapping the `id` of the repository to the `id` you added in the `server` tag containing your credentials. Replace {% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance, {% endif %}*REPOSITORY* with the name of the repository you'd like to publish a package to or install a package from, and *OWNER* with the name of the user or organization account that owns the repository. {% data reusables.package_registry.lowercase-name-field %} If you want to interact with multiple repositories, you can add each repository to separate `repository` children in the `repositories` tag, mapping the `id` of each to the credentials in the `servers` tag. @@ -60,7 +60,7 @@ If your instance has subdomain isolation enabled: github GitHub OWNER Apache Maven Packages - https://maven.pkg.github.com/OWNER/REPOSITORY + https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}maven.HOSTNAME{% endif %}/OWNER/REPOSITORY @@ -119,11 +119,11 @@ If your instance has subdomain isolation disabled: ``` {% endif %} -#### #### Authenticating with the `GITHUB_TOKEN` +#### Authenticating with the `GITHUB_TOKEN` {% data reusables.package_registry.package-registry-with-github-tokens %} -### Ein Paket veröffentlichen +### Publishing a package {% data reusables.package_registry.default-name %} For example, {% data variables.product.prodname_dotcom %} will publish a package named `com.example:test` in a repository called `OWNER/test`. @@ -131,9 +131,7 @@ If you would like to publish multiple packages to the same repository, you can i For more information on creating a package, see the [maven.apache.org documentation](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html). -1. Edit the `distributionManagement` element of the *pom.xml* file located in your package directory, replacing `OWNER` with the name of the user or organization account that owns the repository and `REPOSITORY` with the name of the repository containing your project. - -{% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance, {% endif %}`OWNER` with the name of the user or organization account that owns the repository and `REPOSITORY` with the name of the repository containing your project. +1. Edit the `distributionManagement` element of the *pom.xml* file located in your package directory, replacing {% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance, {% endif %}`OWNER` with the name of the user or organization account that owns the repository and `REPOSITORY` with the name of the repository containing your project. {% if currentVersion != "free-pro-team@latest" %} If your instance has subdomain isolation enabled: {% endif %} @@ -142,7 +140,7 @@ For more information on creating a package, see the [maven.apache.org documentat github GitHub OWNER Apache Maven Packages - https://maven.pkg.github.com/OWNER/REPOSITORY + https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}maven.HOSTNAME{% endif %}/OWNER/REPOSITORY ``` @@ -166,7 +164,7 @@ For more information on creating a package, see the [maven.apache.org documentat {% data reusables.package_registry.viewing-packages %} -### Ein Paket installieren +### Installing a package To install an Apache Maven package from {% data variables.product.prodname_registry %}, edit the *pom.xml* file to include the package as a dependency. If you want to install packages from more than one repository, add a `repository` tag for each. For more information on using a *pom.xml* file in your project, see "[Introduction to the POM](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html)" in the Apache Maven documentation. @@ -182,13 +180,13 @@ To install an Apache Maven package from {% data variables.product.prodname_regis ``` -3. Installieren Sie das Paket. +3. Install the package. ```shell $ mvn install ``` -### Weiterführende Informationen +### Further reading - "[Configuring Gradle for use with {% data variables.product.prodname_registry %}](/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages)" - "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package/)" diff --git a/translations/de-DE/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md b/translations/de-DE/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md index 0b9839b7a075..59c0d2c8b81b 100644 --- a/translations/de-DE/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md +++ b/translations/de-DE/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md @@ -1,6 +1,6 @@ --- title: Configuring Docker for use with GitHub Packages -intro: 'Sie können den Docker-Client für die Nutzung von {% data variables.product.prodname_registry %} zum Veröffentlichen und Abrufen von Docker-Images konfigurieren.' +intro: 'You can configure the Docker client to use {% data variables.product.prodname_registry %} to publish and retrieve docker images.' product: '{% data reusables.gated-features.packages %}' redirect_from: - /articles/configuring-docker-for-use-with-github-package-registry @@ -13,15 +13,11 @@ versions: {% data reusables.package_registry.packages-ghes-release-stage %} -**Note:** When installing or publishing a docker image, {% data variables.product.prodname_registry %} does not currently support foreign layers, such as Windows images. +{% data reusables.package_registry.admins-can-configure-package-types %} -### Bei {% data variables.product.prodname_registry %} authentifizieren +### About Docker and {% data variables.product.prodname_registry %} -{% warning %} - -# Build the image with docker.pkg.github.com/<em>OWNER/REPOSITORY/IMAGE_NAME:VERSION</em> # Assumes Dockerfile resides in the current working directory (.) $ docker build -t docker.pkg.github.com/octocat/octo-app/monalisa:1.0 . # Pusht das Image zu {% data variables.product.prodname_registry %} $ docker push docker.pkg.github.com/octocat/octo-app/monalisa:1.0 - -{% endwarning %} +{% data reusables.package_registry.docker_registry_deprecation_status %} When installing or publishing a docker image, {% data variables.product.prodname_registry %} does not currently support foreign layers, such as Windows images. @@ -31,7 +27,9 @@ Before you can use the Docker registry on {% data variables.product.prodname_reg {% endif %} -### Bei {% data variables.product.prodname_registry %} authentifizieren +### Authenticating to {% data variables.product.prodname_registry %} + +{% data reusables.package_registry.docker_registry_deprecation_status %} {% data reusables.package_registry.authenticate-packages %} @@ -59,17 +57,19 @@ To keep your credentials secure, we recommend you save your personal access toke {% endraw %} {% endif %} -To use this example login command, replace `USERNAME` with your {% data variables.product.prodname_dotcom %} username and `~/TOKEN.txt` with the file path to your personal access token for {% data variables.product.prodname_dotcom %}. +To use this example login command, replace `USERNAME` with your {% data variables.product.product_name %} username{% if currentVersion != "free-pro-team@latest" %}, `HOSTNAME` with the URL for {% data variables.product.product_location_enterprise %},{% endif %} and `~/TOKEN.txt` with the file path to your personal access token for {% data variables.product.product_name %}. For more information, see "[Docker login](https://docs.docker.com/engine/reference/commandline/login/#provide-a-password-using-stdin)." -#### #### Authenticating with the `GITHUB_TOKEN` +#### Authenticating with the `GITHUB_TOKEN` {% data reusables.package_registry.package-registry-with-github-tokens %} -### Ein Paket veröffentlichen +### Publishing a package + +{% data reusables.package_registry.docker_registry_deprecation_status %} -{% data variables.product.prodname_registry %} unterstützt mehrere Top-Level-Docker-Images pro Repository. A repository can have any number of image tags. You may experience degraded service publishing or installing Docker images larger than 10GB, layers are capped at 5GB each. For more information, see "[Docker tag](https://docs.docker.com/engine/reference/commandline/tag/)" in the Docker documentation. +{% data variables.product.prodname_registry %} supports multiple top-level Docker images per repository. A repository can have any number of image tags. You may experience degraded service publishing or installing Docker images larger than 10GB, layers are capped at 5GB each. For more information, see "[Docker tag](https://docs.docker.com/engine/reference/commandline/tag/)" in the Docker documentation. {% data reusables.package_registry.lowercase-name-field %} @@ -82,19 +82,17 @@ For more information, see "[Docker login](https://docs.docker.com/engine/referen > REPOSITORY TAG IMAGE ID CREATED SIZE > IMAGE_NAME VERSION IMAGE_ID 4 weeks ago 1.11MB ``` -2. Using the Docker image ID, tag the docker image, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image, and *VERSION* with package version at build time. -{% if currentVersion != "free-pro-team@latest" %} *HOSTNAME* with the hostname of {% data variables.product.product_location_enterprise %},{% endif %} and *VERSION* with package version at build time. +2. Using the Docker image ID, tag the docker image, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image,{% if currentVersion != "free-pro-team@latest" %} *HOSTNAME* with the hostname of {% data variables.product.product_location_enterprise %},{% endif %} and *VERSION* with package version at build time. {% if currentVersion == "free-pro-team@latest" %} ```shell $ docker tag IMAGE_ID docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME:VERSION ``` {% else %} ```shell - If you haven't already built a docker image for the package, build the image, replacing OWNER with the name of the user or organization account that owns the repository, REPOSITORY with the name of the repository containing your project, IMAGE_NAME with name of the package or image, VERSION with package version at build time, and PATH to the image if it isn't in the current working directory. + $ docker tag IMAGE_ID docker.HOSTNAME/OWNER/REPOSITORY/IMAGE_NAME:VERSION ``` {% endif %} -3. If you haven't already built a docker image for the package, build the image, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image, *VERSION* with package version at build time, -{% if currentVersion != "free-pro-team@latest" %} *HOSTNAME* with the hostname of {% data variables.product.product_location_enterprise %},{% endif %} and *PATH* to the image if it isn't in the current working directory.s +3. If you haven't already built a docker image for the package, build the image, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image, *VERSION* with package version at build time,{% if currentVersion != "free-pro-team@latest" %} *HOSTNAME* with the hostname of {% data variables.product.product_location_enterprise %},{% endif %} and *PATH* to the image if it isn't in the current working directory.s {% if currentVersion == "free-pro-team@latest" %} ```shell $ docker build -t docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME:VERSION PATH @@ -122,6 +120,8 @@ For more information, see "[Docker login](https://docs.docker.com/engine/referen #### Example publishing a Docker image +{% data reusables.package_registry.docker_registry_deprecation_status %} + You can publish version 1.0 of the `monalisa` image to the `octocat/octo-app` repository using an image ID. {% if currentVersion == "free-pro-team@latest" %} @@ -163,7 +163,7 @@ You can publish a new Docker image for the first time and name it `monalisa`. # Assumes Dockerfile resides in the current working directory (.) $ docker build -t docker.pkg.github.com/octocat/octo-app/monalisa:1.0 . -# Pusht das Image zu {% data variables.product.prodname_registry %} +# Push the image to {% data variables.product.prodname_registry %} $ docker push docker.pkg.github.com/octocat/octo-app/monalisa:1.0 ``` @@ -178,10 +178,11 @@ $ docker push docker.HOSTNAME/octocat/octo-app/monalisa:1.0 ``` {% endif %} -### Ein Paket installieren +### Installing a package -You can use the `docker pull` command to install a docker image from {% data variables.product.prodname_registry %}, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image, *TAG_NAME* with tag for the image you want to install. {% data reusables.package_registry.lowercase-name-field %} +{% data reusables.package_registry.docker_registry_deprecation_status %} +You can use the `docker pull` command to install a docker image from {% data variables.product.prodname_registry %}, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image,{% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance, {% endif %} and *TAG_NAME* with tag for the image you want to install. {% data reusables.package_registry.lowercase-name-field %} {% if currentVersion == "free-pro-team@latest" %} ```shell @@ -199,7 +200,6 @@ $ docker pull docker.HOSTNAME/OWNER/REPOSITORY/IMAGE_NAME:TAG_NAME {% endnote %} - -### Weiterführende Informationen +### Further reading - "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package/)" diff --git a/translations/de-DE/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-dotnet-cli-for-use-with-github-packages.md b/translations/de-DE/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-dotnet-cli-for-use-with-github-packages.md index 8589ea0ca0e6..86804a187cf3 100644 --- a/translations/de-DE/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-dotnet-cli-for-use-with-github-packages.md +++ b/translations/de-DE/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-dotnet-cli-for-use-with-github-packages.md @@ -14,9 +14,9 @@ versions: {% data reusables.package_registry.packages-ghes-release-stage %} -{% data reusables.package_registry.admins-can-configure-package-types %} +**Note:** When installing or publishing a docker image, {% data variables.product.prodname_registry %} does not currently support foreign layers, such as Windows images. -### Authenticating to {% data variables.product.prodname_registry %} +### Bei {% data variables.product.prodname_registry %} authentifizieren {% data reusables.package_registry.authenticate-packages %} @@ -55,29 +55,30 @@ If your instance has subdomain isolation enabled: If your instance has subdomain isolation disabled: ```xml - - - - - - - - - - - - - + + + + Exe + netcoreapp3.0 + OctodogApp + 1.0.0 + Octodog + GitHub + This package adds an Octodog! + https://github.com/octo-org/octo-cats-and-dogs + + + ``` {% endif %} -#### Authenticating with the `GITHUB_TOKEN` +#### #### Authenticating with the `GITHUB_TOKEN` {% data reusables.package_registry.package-registry-with-github-tokens %} -### Publishing a package +### Ein Paket veröffentlichen -You can publish a package to {% data variables.product.prodname_registry %} by authenticating with a *nuget.config* file. When publishing, you need to use the same value for `OWNER` in your *csproj* file that you use in your *nuget.config* authentication file. Specify or increment the version number in your *.csproj* file, then use the `dotnet pack` command to create a *.nuspec* file for that version. For more information on creating your package, see "[Create and publish a package](https://docs.microsoft.com/en-us/nuget/quickstart/create-and-publish-a-package-using-the-dotnet-cli)" in the Microsoft documentation. +You can publish a package to {% data variables.product.prodname_registry %} by authenticating with a *nuget.config* file. When publishing, you need to use the same value for `OWNER` in your *csproj* file that you use in your *nuget.config* authentication file. Specify or increment the version number in your *.csproj* file, then use the `dotnet pack` command to create a *.nuspec* file for that version. Weitere Informationen zum Erstellen eines Pakets finden Sie unter „[Ein Paket erstellen und veröffentlichen](https://docs.microsoft.com/en-us/nuget/quickstart/create-and-publish-a-package-using-the-dotnet-cli)“ in der Microsoft-Dokumentation. {% data reusables.package_registry.viewing-packages %} @@ -88,7 +89,7 @@ You can publish a package to {% data variables.product.prodname_registry %} by a ``` 3. Add your project's specific information to your project's file, which ends in *.csproj*. You must replace: - `OWNER` with the name of the user or organization account that owns the repository containing your project. - - `REPOSITORY` with the name of the repository containing the package you want to publish. + - `REPOSITORY` with the name of the repository containing the package you want to publish. - `1.0.0` with the version number of the package.{% if currentVersion != "free-pro-team@latest" %} - `HOSTNAME` with the host name for your {% data variables.product.prodname_ghe_server %} instance.{% endif %} ``` xml @@ -157,8 +158,7 @@ For example, the *OctodogApp* and *OctocatApp* projects will publish to the same ``` - -### Installing a package +### Ein Paket installieren Using packages from {% data variables.product.prodname_dotcom %} in your project is similar to using packages from *nuget.org*. Add your package dependencies to your *.csproj* file, specifying the package name and version. For more information on using a *.csproj* file in your project, see "[Working with NuGet packages](https://docs.microsoft.com/en-us/nuget/consume-packages/overview-and-workflow)" in the Microsoft documentation. @@ -191,6 +191,6 @@ Using packages from {% data variables.product.prodname_dotcom %} in your project dotnet restore ``` -### Further reading +### Weiterführende Informationen - "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package/)" diff --git a/translations/de-DE/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages.md b/translations/de-DE/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages.md index 15989c6ab1fc..3a2e36154882 100644 --- a/translations/de-DE/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages.md +++ b/translations/de-DE/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages.md @@ -26,7 +26,8 @@ versions: You can authenticate to {% data variables.product.prodname_registry %} with Gradle using either Gradle Groovy or Kotlin DSL by editing your *build.gradle* file (Gradle Groovy) or *build.gradle.kts* file (Kotlin DSL) file to include your personal access token. You can also configure Gradle Groovy and Kotlin DSL to recognize a single package or multiple packages in a repository. {% if currentVersion != "free-pro-team@latest" %} -Replace *REGISTRY-URL* with the URL for your instance's Maven registry. If your instance has subdomain isolation enabled, use `maven.HOSTNAME`. If your instance has subdomain isolation disabled, use `HOSTNAME/_registry/maven`. In either case, replace *HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance. +Replace *REGISTRY-URL* with the URL for your instance's Maven registry. If your instance has subdomain isolation enabled, use `maven.HOSTNAME`. If your instance has subdomain isolation disabled, use `HOSTNAME/_registry/maven`. In either case, replace *HOSTNAME* with the host name of your +{% data variables.product.prodname_ghe_server %} instance. {% endif %} Replace *USERNAME* with your {% data variables.product.prodname_dotcom %} username, *TOKEN* with your personal access token, *REPOSITORY* with the name of the repository containing the package you want to publish, and *OWNER* with the name of the user or organization account on {% data variables.product.prodname_dotcom %} that owns the repository. {% data reusables.package_registry.lowercase-name-field %} @@ -48,7 +49,7 @@ publishing { repositories { maven { name = "GitHubPackages" - url = uri("https://maven.pkg.github.com/OWNER/REPOSITORY") + url = uri("https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}REGISTRY-URL{% endif %}/OWNER/REPOSITORY") credentials { username = project.findProperty("gpr.user") ?: System.getenv("USERNAME") password = project.findProperty("gpr.key") ?: System.getenv("TOKEN") @@ -76,7 +77,7 @@ subprojects { repositories { maven { name = "GitHubPackages" - url = uri("https://maven.pkg.github.com/OWNER/REPOSITORY") + url = uri("https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}REGISTRY-URL{% endif %}/OWNER/REPOSITORY") credentials { username = project.findProperty("gpr.user") ?: System.getenv("USERNAME") password = project.findProperty("gpr.key") ?: System.getenv("TOKEN") @@ -103,7 +104,7 @@ publishing { repositories { maven { name = "GitHubPackages" - url = uri("https://maven.pkg.github.com/OWNER/REPOSITORY") + url = uri("https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}REGISTRY-URL{% endif %}/OWNER/REPOSITORY") credentials { username = project.findProperty("gpr.user") as String? ?: System.getenv("USERNAME") password = project.findProperty("gpr.key") as String? ?: System.getenv("TOKEN") @@ -120,8 +121,8 @@ publishing { ##### Example using Kotlin DSL for multiple packages in the same repository - ```shell - plugins { +```shell +plugins { `maven-publish` apply false } @@ -145,7 +146,7 @@ publishing { } } } - ``` +``` #### Authenticating with the `GITHUB_TOKEN` @@ -209,5 +210,5 @@ You can install a package by adding the package as a dependency to your project. ### Weiterführende Informationen -- „[Apache Maven für die Verwendung mit {% data variables.product.prodname_registry %} konfigurieren](/packages/using-github-packages-with-your-projects-ecosystem/configuring-apache-maven-for-use-with-github-packages)“ +- "[Configuring Apache Maven for use with {% data variables.product.prodname_registry %}](/packages/using-github-packages-with-your-projects-ecosystem/configuring-apache-maven-for-use-with-github-packages)" - "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package/)" diff --git a/translations/de-DE/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md b/translations/de-DE/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md index 1e5879de083e..efc0e2d45072 100644 --- a/translations/de-DE/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md +++ b/translations/de-DE/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md @@ -1,6 +1,6 @@ --- title: Configuring npm for use with GitHub Packages -intro: 'Sie können NPM für die Veröffentlichung von Paketen auf {% data variables.product.prodname_registry %} und für die Nutzung von auf {% data variables.product.prodname_registry %} gespeicherten Paketen als Abhängigkeiten in einem NPM-Projekt konfigurieren.' +intro: 'You can configure npm to publish packages to {% data variables.product.prodname_registry %} and to use packages stored on {% data variables.product.prodname_registry %} as dependencies in an npm project.' product: '{% data reusables.gated-features.packages %}' redirect_from: - /articles/configuring-npm-for-use-with-github-package-registry @@ -13,9 +13,9 @@ versions: {% data reusables.package_registry.packages-ghes-release-stage %} -**Note:** When installing or publishing a docker image, {% data variables.product.prodname_registry %} does not currently support foreign layers, such as Windows images. +{% data reusables.package_registry.admins-can-configure-package-types %} -### Bei {% data variables.product.prodname_registry %} authentifizieren +### Authenticating to {% data variables.product.prodname_registry %} {% data reusables.package_registry.authenticate-packages %} @@ -25,24 +25,21 @@ versions: You can authenticate to {% data variables.product.prodname_registry %} with npm by either editing your per-user *~/.npmrc* file to include your personal access token or by logging in to npm on the command line using your username and personal access token. -To authenticate by adding your personal access token to your *~/.npmrc* file, edit the *~/.npmrc* file for your project to include the following line, replacing *TOKEN* with your personal access token. Create a new *~/.npmrc* file if one doesn't exist. +To authenticate by adding your personal access token to your *~/.npmrc* file, edit the *~/.npmrc* file for your project to include the following line, replacing {% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance and {% endif %}*TOKEN* with your personal access token. Create a new *~/.npmrc* file if one doesn't exist. {% if currentVersion != "free-pro-team@latest" %} If your instance has subdomain isolation enabled: {% endif %} ```shell -//npm.pkg.github.com/:_authToken=TOKEN +//{% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %}/:_authToken=TOKEN ``` {% if currentVersion != "free-pro-team@latest" %} If your instance has subdomain isolation disabled: ```shell -$ npm login --registry=https://npm.pkg.github.com -> Username: USERNAME -> Password: TOKEN -> Email: PUBLIC-EMAIL-ADDRESS +//HOSTNAME/_registry/npm/:_authToken=TOKEN ``` {% endif %} @@ -53,34 +50,34 @@ If your instance has subdomain isolation enabled: {% endif %} ```shell -"repository" : { - "type" : "git", - "url": "ssh://git@github.com/OWNER/REPOSITORY.git", - "directory": "packages/name" - }, +$ npm login --registry=https://{% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %} +> Username: USERNAME +> Password: TOKEN +> Email: PUBLIC-EMAIL-ADDRESS ``` {% if currentVersion != "free-pro-team@latest" %} If your instance has subdomain isolation disabled: ```shell -registry=https://npm.pkg.github.com/OWNER -@OWNER:registry=https://npm.pkg.github.com -@OWNER:registry=https://npm.pkg.github.com +$ npm login --registry=https://HOSTNAME/_registry/npm/ +> Username: USERNAME +> Password: TOKEN +> Email: PUBLIC-EMAIL-ADDRESS ``` {% endif %} -#### #### Authenticating with the `GITHUB_TOKEN` +#### Authenticating with the `GITHUB_TOKEN` {% data reusables.package_registry.package-registry-with-github-tokens %} -### Ein Paket veröffentlichen +### Publishing a package -By default, {% data variables.product.prodname_registry %} publishes a package in the {% data variables.product.prodname_dotcom %} repository you specify in the name field of the *package.json* file. Ein Paket namens `@my-org/test` würde beispielsweise im Repository `my-org/test` auf {% data variables.product.prodname_dotcom %} veröffentlicht. You can add a summary for the package listing page by including a *README.md* file in your package directory. For more information, see "[Working with package.json](https://docs.npmjs.com/getting-started/using-a-package.json)" and "[How to create Node.js Modules](https://docs.npmjs.com/getting-started/creating-node-modules)" in the npm documentation. +By default, {% data variables.product.prodname_registry %} publishes a package in the {% data variables.product.prodname_dotcom %} repository you specify in the name field of the *package.json* file. For example, you would publish a package named `@my-org/test` to the `my-org/test` {% data variables.product.prodname_dotcom %} repository. You can add a summary for the package listing page by including a *README.md* file in your package directory. For more information, see "[Working with package.json](https://docs.npmjs.com/getting-started/using-a-package.json)" and "[How to create Node.js Modules](https://docs.npmjs.com/getting-started/creating-node-modules)" in the npm documentation. You can publish multiple packages to the same {% data variables.product.prodname_dotcom %} repository by including a `URL` field in the *package.json* file. For more information, see "[Publishing multiple packages to the same repository](#publishing-multiple-packages-to-the-same-repository)." -Die Scope-Zuordnung für Ihr Projekt können Sie entweder über die lokale *.npmrc*-Datei im Projekt oder die Option `publishConfig` in der Datei *package.json* festlegen. {% data variables.product.prodname_registry %} only supports scoped npm packages. Pakete mit Scopes weisen Namen im Format `@owner/name` auf. Pakete mit Scopes beginnen immer mit dem Symbol `@`. Eventuell müssen Sie den Namen in der Datei *package.json* aktualisieren, um den Namen mit Scope zu verwenden. Beispiel: `"name": "@codertocat/hello-world-npm"`. +You can set up the scope mapping for your project using either a local *.npmrc* file in the project or using the `publishConfig` option in the *package.json*. {% data variables.product.prodname_registry %} only supports scoped npm packages. Scoped packages have names with the format of `@owner/name`. Scoped packages always begin with an `@` symbol. You may need to update the name in your *package.json* to use the scoped name. For example, `"name": "@codertocat/hello-world-npm"`. {% data reusables.package_registry.viewing-packages %} @@ -91,29 +88,29 @@ You can use an *.npmrc* file to configure the scope mapping for your project. In {% data reusables.package_registry.authenticate-step %} {% data reusables.package_registry.create-npmrc-owner-step %} {% data reusables.package_registry.add-npmrc-to-repo-step %} -4. Überprüfen Sie den Namen Ihres Pakets in der Datei *package.json* Ihres Projekts. Das Feld `name` (Name) muss den Scope und den Namen des Pakets enthalten. Wenn z. B. Ihr Paket „test“ heißt und Sie es in der {% data variables.product.prodname_dotcom %}-Organisation „My-org“ veröffentlichen möchten, muss das Feld `name` (Name) in der Datei *package.json* `@my-org/test` enthalten. +4. Verify the name of your package in your project's *package.json*. The `name` field must contain the scope and the name of the package. For example, if your package is called "test", and you are publishing to the "My-org" {% data variables.product.prodname_dotcom %} organization, the `name` field in your *package.json* should be `@my-org/test`. {% data reusables.package_registry.verify_repository_field %} {% data reusables.package_registry.publish_package %} #### Publishing a package using `publishConfig` in the *package.json* file -You can use `publishConfig` element in the *package.json* file to specify the registry where you want the package published. Weitere Informationen finden Sie unter „[publishConfig](https://docs.npmjs.com/files/package.json#publishconfig)“ in der NPM-Dokumentation. +You can use `publishConfig` element in the *package.json* file to specify the registry where you want the package published. For more information, see "[publishConfig](https://docs.npmjs.com/files/package.json#publishconfig)" in the npm documentation. -1. Bearbeiten Sie die Datei *package.json* für Ihr Paket, und fügen Sie den Eintrag `publishConfig` hinzu. +1. Edit the *package.json* file for your package and include a `publishConfig` entry. {% if currentVersion != "free-pro-team@latest" %} If your instance has subdomain isolation enabled: {% endif %} ```shell - "publishConfig": { - "registry":"https://npm.pkg.github.com/" - }, + "publishConfig": { + "registry":"https://{% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %}" + }, ``` {% if currentVersion != "free-pro-team@latest" %} If your instance has subdomain isolation disabled: ```shell - "publishConfig": { - "registry":"https://HOSTNAME/_registry/npm/" - }, + "publishConfig": { + "registry":"https://HOSTNAME/_registry/npm/" + }, ``` {% endif %} {% data reusables.package_registry.verify_repository_field %} @@ -135,13 +132,13 @@ To ensure the repository's URL is correct, replace REPOSITORY with the name of t }, ``` -### Ein Paket installieren +### Installing a package -You can install packages from {% data variables.product.prodname_registry %} by adding the packages as dependencies in the *package.json* file for your project. Weitere Informationen zum Verwenden einer *package.json*-Datei in Ihrem Projekt finden Sie unter „[Mit package.json arbeiten](https://docs.npmjs.com/getting-started/using-a-package.json)“ in der npm-Dokumentation. +You can install packages from {% data variables.product.prodname_registry %} by adding the packages as dependencies in the *package.json* file for your project. For more information on using a *package.json* in your project, see "[Working with package.json](https://docs.npmjs.com/getting-started/using-a-package.json)" in the npm documentation. -By default, you can add packages from one organization. For more information, see [Installing packages from other organizations](#installing-packages-from-other-organizations) +By default, you can add packages from one organization. For more information, see "[Installing packages from other organizations](#installing-packages-from-other-organizations)." -You also need to add the *.npmrc* file to your project so all requests to install packages will go through {% data variables.product.prodname_registry %}. When you route all package requests through {% data variables.product.prodname_registry %}, you can use both scoped and unscoped packages from *npmjs.com*. Weitere Informationen finden Sie unter „[npm-scope](https://docs.npmjs.com/misc/scope) in der npm-Dokumentation. +You also need to add the *.npmrc* file to your project so all requests to install packages will go through {% data variables.product.prodname_registry %}. When you route all package requests through {% data variables.product.prodname_registry %}, you can use both scoped and unscoped packages from *npmjs.com*. For more information, see "[npm-scope](https://docs.npmjs.com/misc/scope)" in the npm documentation. {% data reusables.package_registry.authenticate-step %} {% data reusables.package_registry.create-npmrc-owner-step %} @@ -161,22 +158,22 @@ You also need to add the *.npmrc* file to your project so all requests to instal } } ``` -5. Installieren Sie das Paket. +5. Install the package. ```shell $ npm install ``` -#### Pakete von anderen Organisationen installieren +#### Installing packages from other organizations -Standardmäßig können Sie nur {% data variables.product.prodname_registry %}-Pakete von einer Organisation verwenden. Standardmäßig können Sie nur {% data variables.product.prodname_registry %}-Pakete von einer Organisation verwenden. {% data reusables.package_registry.lowercase-name-field %} +By default, you can only use {% data variables.product.prodname_registry %} packages from one organization. If you'd like to route package requests to multiple organizations and users, you can add additional lines to your *.npmrc* file, replacing {% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance and {% endif %}*OWNER* with the name of the user or organization account that owns the repository containing your project. {% data reusables.package_registry.lowercase-name-field %} {% if currentVersion != "free-pro-team@latest" %} If your instance has subdomain isolation enabled: {% endif %} ```shell -registry=https://{% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %}OWNER +registry=https://{% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME{% endif %}/OWNER @OWNER:registry={% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %} @OWNER:registry={% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %} ``` @@ -191,7 +188,6 @@ registry=https://HOSTNAME/_registry/npm/OWNER ``` {% endif %} - -### Weiterführende Informationen +### Further reading - "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package/)" diff --git a/translations/de-DE/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md b/translations/de-DE/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md index f994a92e0c9f..8875879a16f7 100644 --- a/translations/de-DE/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md +++ b/translations/de-DE/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md @@ -18,11 +18,13 @@ versions: You can extend the CI and CD capabilities of your repository by publishing or installing packages as part of your workflow. {% if currentVersion == "free-pro-team@latest" %} -#### Bei {% data variables.product.prodname_github_container_registry %} authentifizieren +#### Authenticating to {% data variables.product.prodname_github_container_registry %} {% data reusables.package_registry.container-registry-beta %} -Instead of using a personal access token to authenticate to {% data variables.product.prodname_registry %}, use the `GITHUB_TOKEN` that {% data variables.product.prodname_dotcom %} automatically creates for your repository when you enable {% data variables.product.prodname_actions %}. For an authentication example, see "[Authenticating with the {% data variables.product.prodname_container_registry %}](/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images#authenticating-with-the-container-registry)." +{% data reusables.package_registry.authenticate_with_pat_for_container_registry %} + +For an authentication example, see "[Authenticating with the {% data variables.product.prodname_container_registry %}](/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images#authenticating-with-the-container-registry)." {% endif %} @@ -30,7 +32,7 @@ Instead of using a personal access token to authenticate to {% data variables.pr {% if currentVersion == "free-pro-team@latest" %}If you want your workflow to authenticate to {% data variables.product.prodname_registry %} to access a package registry other than the {% data variables.product.prodname_container_registry %} on {% data variables.product.product_name %}, then{% else %}To authenticate to package registries on {% data variables.product.product_name %},{% endif %} we recommend using the `GITHUB_TOKEN` that {% data variables.product.product_name %} automatically creates for your repository when you enable {% data variables.product.prodname_actions %} instead of a personal access token for authentication. The `GITHUB_TOKEN` has `read:packages` and `write:packages` scopes to the current repository. For forks, the token also has the `read:packages` scope for the parent repository. -You can reference the `GITHUB_TOKEN` in your workflow file using the {% raw %}`{{secrets.GITHUB_TOKEN}}`{% endraw %} context. Weitere Informationen findest Du unter „[Authentifizierung mit dem GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)". +You can reference the `GITHUB_TOKEN` in your workflow file using the {% raw %}`{{secrets.GITHUB_TOKEN}}`{% endraw %} context. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)." ### Publishing a package using an action @@ -42,7 +44,7 @@ You can publish packages as part of your continuous integration (CI) flow using You can install packages as part of your CI flow using {% data variables.product.prodname_actions %}. For example, you could configure a workflow so that anytime a developer pushes code to a pull request, the workflow resolves dependencies by downloading and installing packages hosted by {% data variables.product.prodname_registry %}. Then, the workflow can run CI tests that require the dependencies. -Installing packages hosted by {% data variables.product.prodname_registry %} through {% data variables.product.prodname_actions %} requires minimal configuration or additional authentication, by using the `GITHUB_TOKEN`. Data transfer is also free when an action installs a package. Weitere Informationen finden Sie unter „[Informationen zur Abrechnung für {% data variables.product.prodname_registry %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)“. +Installing packages hosted by {% data variables.product.prodname_registry %} through {% data variables.product.prodname_actions %} requires minimal configuration or additional authentication when you use `GITHUB_TOKEN`.{% if currentVersion == "free-pro-team@latest" %} Data transfer is also free when an action installs a package. For more information, see "[About billing for {% data variables.product.prodname_registry %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)."{% endif %} {% if currentVersion == "free-pro-team@latest" %} `GITHUB_TOKEN` cannot install packages from any private repository besides the repository where the action runs. You cannot currently use `GITHUB_TOKEN` to authenticate to {% data variables.product.prodname_github_container_registry %}. diff --git a/translations/de-DE/content/rest/guides/basics-of-authentication.md b/translations/de-DE/content/rest/guides/basics-of-authentication.md index ff31d8a0c765..fad29ce33e13 100644 --- a/translations/de-DE/content/rest/guides/basics-of-authentication.md +++ b/translations/de-DE/content/rest/guides/basics-of-authentication.md @@ -11,7 +11,6 @@ versions: --- - In this section, we're going to focus on the basics of authentication. Specifically, we're going to create a Ruby server (using [Sinatra][Sinatra]) that implements the [web flow][webflow] of an application in several different ways. {% tip %} @@ -48,7 +47,8 @@ end ``` Your client ID and client secret keys come from [your application's configuration page][app settings]. You should **never, _ever_** store these values in -{% data variables.product.product_name %}--or any other public place, for that matter. We recommend storing them as [environment variables][about env vars]--which is exactly what we've done here. +{% data variables.product.product_name %}--or any other public place, for that matter. We recommend storing them as +[environment variables][about env vars]--which is exactly what we've done here. Next, in _views/index.erb_, paste this content: @@ -106,7 +106,7 @@ After a successful app authentication, {% data variables.product.product_name %} #### Checking granted scopes -In the future, users will be able to [edit the scopes you requested][edit scopes post], and your application might be granted less access than you originally asked for. So, before making any requests with the token, you should check the scopes that were granted for the token by the user. +Users can edit the scopes you requested by directly changing the URL. This can grant your application less access than you originally asked for. Before making any requests with the token, check the scopes that were granted for the token by the user. For more information about requested and granted scopes, see "[Scopes for OAuth Apps](/developers/apps/scopes-for-oauth-apps#requested-scopes-and-granted-scopes)." The scopes that were granted are returned as a part of the response from exchanging a token. @@ -173,7 +173,8 @@ We can do whatever we want with our results. In this case, we'll just dump them It'd be a pretty bad model if we required users to log into the app every single time they needed to access the web page. For example, try navigating directly to `http://localhost:4567/basic`. You'll get an error. What if we could circumvent the entire "click here" process, and just _remember_ that, as long as the user's logged into -{% data variables.product.product_name %}, they should be able to access this application? Hold on to your hat, because _that's exactly what we're going to do_. +{% data variables.product.product_name %}, they should be able to access this application? Hold on to your hat, +because _that's exactly what we're going to do_. Our little server above is rather simple. In order to wedge in some intelligent authentication, we're going to switch over to using sessions for storing tokens. This will make authentication transparent to the user. @@ -302,6 +303,5 @@ Also, if we had never authorized this application to access our {% data variable [libraries]: /libraries/ [oauth scopes]: /apps/building-oauth-apps/understanding-scopes-for-oauth-apps/ [oauth scopes]: /apps/building-oauth-apps/understanding-scopes-for-oauth-apps/ -[edit scopes post]: https://developer.github.com/changes/2013-10-04-oauth-changes-coming/ [new oauth app]: https://github.com/settings/applications/new [app settings]: https://github.com/settings/developers diff --git a/translations/de-DE/content/rest/guides/best-practices-for-integrators.md b/translations/de-DE/content/rest/guides/best-practices-for-integrators.md index 23643156fa7d..b99e43b3d9b9 100644 --- a/translations/de-DE/content/rest/guides/best-practices-for-integrators.md +++ b/translations/de-DE/content/rest/guides/best-practices-for-integrators.md @@ -12,7 +12,6 @@ versions: Interested in integrating with the GitHub platform? [You're in good company](https://github.com/integrations). This guide will help you build an app that provides the best experience for your users *and* ensure that it's reliably interacting with the API. - ### Secure payloads delivered from GitHub It's very important that you secure [the payloads sent from GitHub][event-types]. Although no personal information (like passwords) is ever transmitted in a payload, leaking *any* information is not good. Some information that might be sensitive include committer email address or the names of private repositories. diff --git a/translations/de-DE/content/rest/guides/delivering-deployments.md b/translations/de-DE/content/rest/guides/delivering-deployments.md index ccdab99530d7..75f293bdd9c3 100644 --- a/translations/de-DE/content/rest/guides/delivering-deployments.md +++ b/translations/de-DE/content/rest/guides/delivering-deployments.md @@ -12,7 +12,7 @@ versions: -The [Deployments API][deploy API] provides your projects hosted on {% data variables.product.product_name %} with the capability to launch them on a server that you own. Combined with [the Status API][status API], you'll be able to coordinate your deployments the moment your code lands on `master`. +The [Deployments API][deploy API] provides your projects hosted on {% data variables.product.product_name %} with the capability to launch them on a server that you own. Combined with [the Status API][status API], you'll be able to coordinate your deployments the moment your code lands on the default branch. This guide will use that API to demonstrate a setup that you can use. In our scenario, we will: diff --git a/translations/de-DE/content/rest/guides/getting-started-with-the-checks-api.md b/translations/de-DE/content/rest/guides/getting-started-with-the-checks-api.md index 98b744c83703..8479856ced9d 100644 --- a/translations/de-DE/content/rest/guides/getting-started-with-the-checks-api.md +++ b/translations/de-DE/content/rest/guides/getting-started-with-the-checks-api.md @@ -37,8 +37,8 @@ A check run is an individual test that is part of a check suite. Each run includ ![Check runs workflow](/assets/images/check_runs.png) {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -If a check run is in a incomplete state for more than 14 days, then the check run's `conclusion` becomes `stale` and appears on {% data variables.product.prodname_dotcom %} as stale with -{% octicon "issue-reopened" aria-label="The issue-reopened icon" %}. Only {% data variables.product.prodname_dotcom %} can mark check runs as `stale`. For more information about possible conclusions of a check run, see the [`conclusion` parameter](/rest/reference/checks#create-a-check-run--parameters). +If a check run is in a incomplete state for more than 14 days, then the check run's `conclusion` becomes `stale` and appears on +{% data variables.product.prodname_dotcom %} as stale with {% octicon "issue-reopened" aria-label="The issue-reopened icon" %}. Only {% data variables.product.prodname_dotcom %} can mark check runs as `stale`. For more information about possible conclusions of a check run, see the [`conclusion` parameter](/rest/reference/checks#create-a-check-run--parameters). {% endif %} As soon as you receive the [`check_suite`](/webhooks/event-payloads/#check_suite) webhook, you can create the check run, even if the check is not complete. You can update the `status` of the check run as it completes with the values `queued`, `in_progress`, or `completed`, and you can update the `output` as more details become available. A check run can contain timestamps, a link to more details on your external site, detailed annotations for specific lines of code, and information about the analysis performed. diff --git a/translations/de-DE/content/rest/guides/getting-started-with-the-git-database-api.md b/translations/de-DE/content/rest/guides/getting-started-with-the-git-database-api.md index 0cd5ea60f40f..cdef24288f9b 100644 --- a/translations/de-DE/content/rest/guides/getting-started-with-the-git-database-api.md +++ b/translations/de-DE/content/rest/guides/getting-started-with-the-git-database-api.md @@ -32,7 +32,7 @@ It might seem complex, but it's actually pretty simple when you understand the m {% warning %} -**Warning!** Please do not depend on using Git directly or {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}[`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference){% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}[`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference){% endif %} for updates to `merge` Git refs, because this content becomes outdated without warning. +**Warning!** Please do not depend on using Git directly or [`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference) for updates to `merge` Git refs, because this content becomes outdated without warning. {% endwarning %} @@ -42,4 +42,4 @@ If you are currently using polling methods that produce outdated `merge` Git ref 1. Receive the pull request webhook. 2. Call [`GET /repos/{owner}/{repo}/pulls/{pull_number}`](/v3/pulls/#get-a-pull-request) to start a background job for creating the merge commit candidate. -3. Poll your repository using [`GET /repos/{owner}/{repo}/pulls/{pull_number}`](/v3/pulls/#get-a-pull-request) to see if the `mergeable` attribute is `true` or `false`. You can use Git directly or {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}[`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference){% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}[`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference){% endif %} for updates to `merge` Git refs only after performing the previous steps. +3. Poll your repository using [`GET /repos/{owner}/{repo}/pulls/{pull_number}`](/v3/pulls/#get-a-pull-request) to see if the `mergeable` attribute is `true` or `false`. You can use Git directly or [`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference) for updates to `merge` Git refs only after performing the previous steps. diff --git a/translations/de-DE/content/rest/guides/getting-started-with-the-rest-api.md b/translations/de-DE/content/rest/guides/getting-started-with-the-rest-api.md index baace79a79fb..88ed6f31a263 100644 --- a/translations/de-DE/content/rest/guides/getting-started-with-the-rest-api.md +++ b/translations/de-DE/content/rest/guides/getting-started-with-the-rest-api.md @@ -10,7 +10,6 @@ versions: --- - Let's walk through core API concepts as we tackle some everyday use cases. ### Übersicht @@ -55,7 +54,6 @@ $ curl -i {% data variables.product.api_url_pre %}/users/defunkt > Server: GitHub.com > Date: Sun, 11 Nov 2012 18:43:28 GMT > Content-Type: application/json; charset=utf-8 -> Connection: keep-alive > Status: 200 OK > ETag: "bfd85cbf23ac0b0c8a29bee02e7117c6" > X-RateLimit-Limit: 60 @@ -195,7 +193,8 @@ In this example, we grab only those repositories that octocat owns, not the ones #### Ein Repository erstellen Fetching information for existing repositories is a common use case, but the -{% data variables.product.product_name %} API supports creating new repositories as well. To [create a repository][create repo], we need to `POST` some JSON containing the details and configuration options. +{% data variables.product.product_name %} API supports creating new repositories as well. To [create a repository][create repo], +we need to `POST` some JSON containing the details and configuration options. ```shell $ curl -i -H "Authorization: token 5199831f4dd3b79e7c5b7e0ebe75d67aa66e79d4" \ diff --git a/translations/de-DE/content/rest/overview/api-previews.md b/translations/de-DE/content/rest/overview/api-previews.md index 0823d41011b9..26f7fc14f4a9 100644 --- a/translations/de-DE/content/rest/overview/api-previews.md +++ b/translations/de-DE/content/rest/overview/api-previews.md @@ -10,7 +10,6 @@ versions: --- - API previews let you try out new APIs and changes to existing API methods before they become part of the official GitHub API. During the preview period, we may change some features based on developer feedback. If we do make changes, we'll announce them on the [developer blog](https://developer.github.com/changes/) without advance notice. @@ -27,7 +26,7 @@ Allows you to download repositories from your GitHub user or organization accoun ### Enhanced deployments -Exercise greater control over [deployments](/v3/repos/deployments/) with more information and finer granularity. +Exercise greater control over [deployments](/rest/reference/repos#deployments) with more information and finer granularity. **Custom media type:** `ant-man-preview` **Announced:** [2016-04-06](https://developer.github.com/changes/2016-04-06-deployment-and-deployment-status-enhancements/) @@ -43,14 +42,6 @@ Get a [list of events](/v3/issues/timeline/) for an issue or pull request. **Custom media type:** `mockingbird-preview` **Announced:** [2016-05-23](https://developer.github.com/changes/2016-05-23-timeline-preview-api/) -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -### Pages - -Get more information about your [GitHub Pages](/v3/repos/pages/) site. - -**Custom media type:** `mister-fantastic-preview` **Announced:** [2016-07-06](https://developer.github.com/changes/2016-07-06-github-pages-preview-api/) -{% endif %} - {% if currentVersion != "free-pro-team@latest" %} ### Pre-receive environments @@ -120,9 +111,9 @@ Include nested team content in [team](/v3/teams/) payloads. ### Global webhooks -Enables [global webhooks](/v3/enterprise-admin/global_webhooks/) for [organization](/webhooks/event-payloads/#organization) and [user](/webhooks/event-payloads/#user) event types. This API preview is only available for {% data variables.product.prodname_ghe_server %}. +Enables [global webhooks](/rest/reference/enterprise-admin#global-webhooks/) for [organization](/webhooks/event-payloads/#organization) and [user](/webhooks/event-payloads/#user) event types. This API preview is only available for {% data variables.product.prodname_ghe_server %}. -**Custom media type:** `superpro-preview` **Announced:** [2017-12-12](/v3/enterprise-admin/global_webhooks) +**Custom media type:** `superpro-preview` **Announced:** [2017-12-12](/rest/reference/enterprise-admin#global-webhooks) {% endif %} @@ -142,15 +133,6 @@ You can now add a reason when you [lock an issue](/v3/issues/#lock-an-issue). **Custom media type:** `sailor-v-preview` **Announced:** [2018-01-10](https://developer.github.com/changes/2018-01-10-lock-reason-api-preview) {% endif %} -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -### Teamdiskussionen, - -You can now use the API to manage [team discussions](/v3/teams/discussions) and [team discussion comments](/v3/teams/discussion_comments). - -**Custom media type:** `echo-preview` **Announced:** [2018-02-07](https://developer.github.com/changes/2018-02-07-team-discussions-api) - -{% endif %} - ### Require signed commits You can now use the API to manage the setting for [requiring signed commits on protected branches](/v3/repos/branches). @@ -172,11 +154,13 @@ Retrieve information from [someone's hovercard](/v3/users/#get-contextual-inform {% endif %} +{% if currentVersion ver_lt "enterprise-server@2.23" %} ### Check runs and check suites API Allows a GitHub App to run external checks on a repository's code. See the [Check runs](/v3/checks/runs/) and [Check suites](/v3/checks/suites/) APIs for more details. **Custom media type:** `antiope-preview` **Announced:** [2018-05-07](https://developer.github.com/changes/2018-05-07-new-checks-api-public-beta/) +{% endif %} {% if currentVersion != "free-pro-team@latest" %} @@ -206,7 +190,7 @@ GitHub App Manifests allow people to create preconfigured GitHub Apps. See "[Cre ### Deployment statuses -You can now update the `environment` of a [deployment status](/v3/repos/deployments/#create-a-deployment-status) and use the `in_progress` and `queued` states. When you create deployment statuses, you can now use the `auto_inactive` parameter to mark old `production` deployments as `inactive`. +You can now update the `environment` of a [deployment status](/rest/reference/repos#create-a-deployment-status) and use the `in_progress` and `queued` states. When you create deployment statuses, you can now use the `auto_inactive` parameter to mark old `production` deployments as `inactive`. **Custom media type:** `flash-preview` **Announced:** [2018-10-16](https://developer.github.com/changes/2018-10-16-deployments-environments-states-and-auto-inactive-updates/) @@ -243,7 +227,7 @@ You can use the Draft Pull Requests API and its [pull request](/v3/pulls/) endpo ### Enable and disable Pages -You can use the new endpoints in the [Pages API](/v3/repos/pages/) to enable or disable Pages. To learn more about Pages, see "[GitHub Pages Basics](/categories/github-pages-basics)". +You can use the new endpoints in the [Pages API](/rest/reference/repos#pages) to enable or disable Pages. To learn more about Pages, see "[GitHub Pages Basics](/categories/github-pages-basics)". **Custom media types:** `switcheroo-preview` **Announced:** [2019-03-14](https://developer.github.com/changes/2019-03-14-enabling-disabling-pages/) diff --git a/translations/de-DE/content/rest/overview/endpoints-available-for-github-apps.md b/translations/de-DE/content/rest/overview/endpoints-available-for-github-apps.md index 99648a43234a..9ae64ab8c3d2 100644 --- a/translations/de-DE/content/rest/overview/endpoints-available-for-github-apps.md +++ b/translations/de-DE/content/rest/overview/endpoints-available-for-github-apps.md @@ -11,7 +11,7 @@ versions: You must use an installation access token to access endpoints using your {% data variables.product.prodname_github_app %}. For more information, see "[Authenticating with {% data variables.product.prodname_github_apps %}](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)." -{% for thing in rest.operationsEnabledForApps[currentVersion] %} +{% for thing in rest.operationsEnabledForGitHubApps[currentVersion] %} {% assign category = thing[0] %} {% assign operations = thing[1] %} {% if operations.size > 0 %} diff --git a/translations/de-DE/content/rest/overview/other-authentication-methods.md b/translations/de-DE/content/rest/overview/other-authentication-methods.md index 8307284c703e..54d597e4a271 100644 --- a/translations/de-DE/content/rest/overview/other-authentication-methods.md +++ b/translations/de-DE/content/rest/overview/other-authentication-methods.md @@ -9,9 +9,9 @@ versions: --- - While the API provides multiple methods for authentication, we strongly recommend using [OAuth](/apps/building-integrations/setting-up-and-registering-oauth-apps/) for production applications. The other methods provided are intended to be used for scripts or testing (i.e., cases where full OAuth would be overkill). Third party applications that rely on -{% data variables.product.product_name %} for authentication should not ask for or collect {% data variables.product.product_name %} credentials. Instead, they should use the [OAuth web flow](/apps/building-oauth-apps/authorizing-oauth-apps/). +{% data variables.product.product_name %} for authentication should not ask for or collect {% data variables.product.product_name %} credentials. +Instead, they should use the [OAuth web flow](/apps/building-oauth-apps/authorizing-oauth-apps/). ### Basic Authentication diff --git a/translations/de-DE/content/rest/overview/resources-in-the-rest-api.md b/translations/de-DE/content/rest/overview/resources-in-the-rest-api.md index b38e31b6ef27..8aa9e2a0bae1 100644 --- a/translations/de-DE/content/rest/overview/resources-in-the-rest-api.md +++ b/translations/de-DE/content/rest/overview/resources-in-the-rest-api.md @@ -11,7 +11,6 @@ versions: This describes the resources that make up the official {% data variables.product.product_name %} REST API. If you have any problems or requests, please contact {% data variables.contact.contact_support %}. - ### Current version By default, all requests to `{% data variables.product.api_url_code %}` receive the **v3** [version](/v3/versions) of the REST API. We encourage you to [explicitly request this version via the `Accept` header](/v3/media/#request-specific-version). @@ -36,7 +35,6 @@ $ curl -i {% data variables.product.api_url_pre %}/users/octocat/orgs > Server: nginx > Date: Fri, 12 Oct 2012 23:33:14 GMT > Content-Type: application/json; charset=utf-8 -> Connection: keep-alive > Status: 200 OK > ETag: "a00049ba79152d03380c34652f2cb612" > X-GitHub-Media-Type: github.v3 diff --git a/translations/de-DE/content/rest/reference/actions.md b/translations/de-DE/content/rest/reference/actions.md index 16d393257ba6..0a728de92216 100644 --- a/translations/de-DE/content/rest/reference/actions.md +++ b/translations/de-DE/content/rest/reference/actions.md @@ -24,6 +24,16 @@ The Artifacts API allows you to download, delete, and retrieve information about {% if operation.subcategory == 'artifacts' %}{% include rest_operation %}{% endif %} {% endfor %} +## Permissions + +The Permissions API allows you to set permissions for what organizations and repositories are allowed to run {% data variables.product.prodname_actions %}, and what actions are allowed to run. For more information, see "[Usage limits, billing, and administration](/actions/reference/usage-limits-billing-and-administration#disabling-or-limiting-github-actions-for-your-repository-or-organization)." + +You can also set permissions for an enterprise. For more information, see the "[{% data variables.product.prodname_dotcom %} Enterprise administration](/rest/reference/enterprise-admin#github-actions)" REST API. + +{% for operation in currentRestOperations %} + {% if operation.subcategory == 'permissions' %}{% include rest_operation %}{% endif %} +{% endfor %} + ## Secrets The Secrets API lets you create, update, delete, and retrieve information about encrypted secrets. {% data reusables.actions.about-secrets %} For more information, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)." @@ -40,7 +50,7 @@ The Self-hosted Runners API allows you to register, view, and delete self-hosted {% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_app %}s must have the `administration` permission for repositories or the `organization_self_hosted_runners` permission for organizations. Authenticated users must have admin access to the repository or organization to use this API. -You can manage self-hosted runners for an enterprise. For more information, see the "[{% data variables.product.prodname_dotcom %} Enterprise administration](/rest/reference/enterprise-admin#actions)" REST API. +You can manage self-hosted runners for an enterprise. For more information, see the "[{% data variables.product.prodname_dotcom %} Enterprise administration](/rest/reference/enterprise-admin#github-actions)" REST API. {% for operation in currentRestOperations %} {% if operation.subcategory == 'self-hosted-runners' %}{% include rest_operation %}{% endif %} @@ -52,7 +62,7 @@ The Self-hosted Runners Groups API allows you manage groups of self-hosted runne {% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_app %}s must have the `administration` permission for repositories or the `organization_self_hosted_runners` permission for organizations. Authenticated users must have admin access to the repository or organization to use this API. -You can manage self-hosted runner groups for an enterprise. For more information, see the "[{% data variables.product.prodname_dotcom %} Enterprise administration](/rest/reference/enterprise-admin#actions)" REST API. +You can manage self-hosted runner groups for an enterprise. For more information, see the "[{% data variables.product.prodname_dotcom %} Enterprise administration](/rest/reference/enterprise-admin##github-actions)" REST API. {% for operation in currentRestOperations %} {% if operation.subcategory == 'self-hosted-runner-groups' %}{% include rest_operation %}{% endif %} diff --git a/translations/de-DE/content/rest/reference/activity.md b/translations/de-DE/content/rest/reference/activity.md index 0857b72469ea..73c10416fcaa 100644 --- a/translations/de-DE/content/rest/reference/activity.md +++ b/translations/de-DE/content/rest/reference/activity.md @@ -15,7 +15,7 @@ versions: The Events API is a read-only API to the {% data variables.product.prodname_dotcom %} events. These events power the various activity streams on the site. -The Events API can return different types of events triggered by activity on {% data variables.product.product_name %}. The Events API can return different types of events triggered by activity on {% data variables.product.product_name %}. For more information about the specific events that you can receive from the Events API, see "[{% data variables.product.prodname_dotcom %} Event types](/developers/webhooks-and-events/github-event-types)." For more information, see the "[Issue Events API](/rest/reference/issues#events)." +The Events API can return different types of events triggered by activity on {% data variables.product.product_name %}. The Events API can return different types of events triggered by activity on {% data variables.product.product_name %}. For more information about the specific events that you can receive from the Events API, see "[{{ site.data.variables.product.prodname_dotcom }} Event types](/developers/webhooks-and-events/github-event-types)." For more information, see the "[Issue Events API](/rest/reference/issues#events)." Events are optimized for polling with the "ETag" header. If no new events have been triggered, you will see a "304 Not Modified" response, and your current rate limit will be untouched. There is also an "X-Poll-Interval" header that specifies how often (in seconds) you are allowed to poll. In times of high server load, the time may increase. Please obey the header. @@ -138,19 +138,19 @@ When retrieving responses from the Notifications API, each payload has a key tit Here's a list of potential `reason`s for receiving a notification: -| Reason Name | Beschreibung | -| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `assign` | You were assigned to the issue. | -| `Autor` | You created the thread. | -| `kommentieren` | You commented on the thread. | -| `Einladung` | You accepted an invitation to contribute to the repository. | -| `manual` | You subscribed to the thread (via an issue or pull request). | -| `erwähnen` | You were specifically **@mentioned** in the content. | +| Reason Name | Beschreibung | +| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `assign` | You were assigned to the issue. | +| `Autor` | You created the thread. | +| `kommentieren` | You commented on the thread. | +| `Einladung` | You accepted an invitation to contribute to the repository. | +| `manual` | You subscribed to the thread (via an issue or pull request). | +| `erwähnen` | You were specifically **@mentioned** in the content. | | `review_requested` | You, or a team you're a member of, were requested to review a pull request.{% if currentVersion == "free-pro-team@latest" %} | `security_alert` | {% data variables.product.prodname_dotcom %} discovered a [security vulnerability](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in your repository.{% endif %} -| `state_change` | You changed the thread state (for example, closing an issue or merging a pull request). | -| `subscribed` | You're watching the repository. | -| `team_mention` | You were on a team that was mentioned. | +| `state_change` | You changed the thread state (for example, closing an issue or merging a pull request). | +| `subscribed` | You're watching the repository. | +| `team_mention` | You were on a team that was mentioned. | Note that the `reason` is modified on a per-thread basis, and can change, if the `reason` on a later notification is different. diff --git a/translations/de-DE/content/rest/reference/apps.md b/translations/de-DE/content/rest/reference/apps.md index 8bdb0e68e832..191557815b87 100644 --- a/translations/de-DE/content/rest/reference/apps.md +++ b/translations/de-DE/content/rest/reference/apps.md @@ -35,9 +35,7 @@ You can use this API to manage the OAuth tokens an OAuth application uses to acc The Installations API enables you to get information about installations of your GitHub App and perform actions within those installations. An _installation_ refers to any user or organization account that has installed the app. For information on how to authenticate as an installation and limit access to specific repositories, see "[Authenticating as an installation](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)." -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} To list all GitHub App installations for an organization, see "[List app installations for an organization](/v3/orgs/#list-app-installations-for-an-organization)." -{% endif %} {% for operation in currentRestOperations %} {% if operation.subcategory == 'installations' %}{% include rest_operation %}{% endif %} diff --git a/translations/de-DE/content/rest/reference/code-scanning.md b/translations/de-DE/content/rest/reference/code-scanning.md new file mode 100644 index 000000000000..42f1f093fec7 --- /dev/null +++ b/translations/de-DE/content/rest/reference/code-scanning.md @@ -0,0 +1,14 @@ +--- +title: Code scanning +redirect_from: + - /v3/code-scanning +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta %} + +The {% data variables.product.prodname_code_scanning %} API lets you retrieve and update code scanning alerts from a repository. You can use the endpoints to create automated reports for the code scanning alerts in an organization or upload analysis results generated using offline code scanning tools. For more information, see "[Finding security vulnerabilities and errors in your code](/github/finding-security-vulnerabilities-and-errors-in-your-code)." + +{% include rest_operations_at_current_path %} diff --git a/translations/de-DE/content/rest/reference/enterprise-admin.md b/translations/de-DE/content/rest/reference/enterprise-admin.md index a6ce288e818c..6c1045bb89f5 100644 --- a/translations/de-DE/content/rest/reference/enterprise-admin.md +++ b/translations/de-DE/content/rest/reference/enterprise-admin.md @@ -9,7 +9,7 @@ versions: enterprise-server: '*' --- -You can use these {% data variables.product.prodname_ghe_cloud %} endpoints to administer your enterprise account. +You can use these {{ site.data.variables.product.prodname_ghe_cloud }} endpoints to administer your enterprise account. {% if currentVersion == "free-pro-team@latest" %} @@ -124,11 +124,10 @@ GET /scim/v2/enterprises/{enterprise}/Users/{scim_user_id} ### Supported SCIM Group attributes -| Name | Typ | Beschreibung | -| ------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Name | Typ | Beschreibung | +| ------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `displayName` | `string` | The name of the SCIM group, which must exactly match the name of the corresponding {% data variables.product.product_name %} organization. For example, if the URL of the organization is `https://github.com/octo-org`, the group name must be `octo-org`. | -| `members` | `array` | List of SCIM user IDs that are members of the group. | - +| `members` | `array` | List of SCIM user IDs that are members of the group. | {% for operation in currentRestOperations %} {% if operation.subcategory == 'scim' %}{% include rest_operation %}{% endif %} @@ -245,13 +244,13 @@ The Pre-receive Environments API allows you to create, list, update and delete e #### Pre-receive Environment -| Name | Typ | Beschreibung | -| --------------------- | --------- | ---------------------------------------------------------------------------------------------------------------- | -| `name` | `string` | The name of the environment as displayed in the UI. | -| `image_url` | `string` | URL to the tarball that will be downloaded and extracted. | +| Name | Typ | Beschreibung | +| --------------------- | --------- | ----------------------------------------------------------------------------------------------------------- | +| `name` | `string` | The name of the environment as displayed in the UI. | +| `image_url` | `string` | URL to the tarball that will be downloaded and extracted. | | `default_environment` | `boolean` | Whether this is the default environment that ships with {% data variables.product.prodname_ghe_server %}. | -| `download` | `Objekt` | This environment's download status. | -| `hooks_count` | `integer` | The number of pre-receive hooks that use this environment. | +| `download` | `Objekt` | This environment's download status. | +| `hooks_count` | `integer` | The number of pre-receive hooks that use this environment. | #### Pre-receive Environment Download diff --git a/translations/de-DE/content/rest/reference/interactions.md b/translations/de-DE/content/rest/reference/interactions.md index 5521f31d7aa8..9f3d4c2de5d7 100644 --- a/translations/de-DE/content/rest/reference/interactions.md +++ b/translations/de-DE/content/rest/reference/interactions.md @@ -28,9 +28,9 @@ The Organization Interactions API allows organization owners to temporarily rest The Repository Interactions API allows people with owner or admin access to temporarily restrict which users can comment, open issues, or create pull requests in a public repository. {% data reusables.interactions.interactions-detail %} Here's more about the groups of {% data variables.product.product_name %} users: -* {% data reusables.interactions.existing-user-limit-definition %} in the respository. -* {% data reusables.interactions.contributor-user-limit-definition %} in the respository. -* {% data reusables.interactions.collaborator-user-limit-definition %} in the respository. +* {% data reusables.interactions.existing-user-limit-definition %} in the repository. +* {% data reusables.interactions.contributor-user-limit-definition %} in the repository. +* {% data reusables.interactions.collaborator-user-limit-definition %} in the repository. {% for operation in currentRestOperations %} {% if operation.subcategory == 'repos' %}{% include rest_operation %}{% endif %} diff --git a/translations/de-DE/content/rest/reference/licenses.md b/translations/de-DE/content/rest/reference/licenses.md index c76e491fa7df..a8a147bb5c71 100644 --- a/translations/de-DE/content/rest/reference/licenses.md +++ b/translations/de-DE/content/rest/reference/licenses.md @@ -18,8 +18,8 @@ If a license is matched, the license key and name returned conforms to the [SPDX - [Get a repository](/v3/repos/#get-a-repository) - [List repositories for a user](/v3/repos/#list-repositories-for-a-user) - [Repositorys einer Organisation auflisten](/v3/repos/#list-organization-repositories) -- [List forks](/v3/repos/forks/#list-forks) -- [List repositories watched by a user](/v3/activity/watching/#list-repositories-watched-by-a-user) +- [List forks](/rest/reference/repos#list-forks) +- [List repositories watched by a user](/rest/reference/activity#list-repositories-watched-by-a-user) - [List team repositories](/v3/teams/#list-team-repositories) {% warning %} diff --git a/translations/de-DE/content/rest/reference/permissions-required-for-github-apps.md b/translations/de-DE/content/rest/reference/permissions-required-for-github-apps.md index 349b48145528..6533185089ef 100644 --- a/translations/de-DE/content/rest/reference/permissions-required-for-github-apps.md +++ b/translations/de-DE/content/rest/reference/permissions-required-for-github-apps.md @@ -2,7 +2,7 @@ title: Permissions required for GitHub Apps intro: 'You can find the required permissions for each {% data variables.product.prodname_github_app %}-compatible endpoint.' redirect_from: - - /v3/apps/permissions --- + - /v3/apps/permissions versions: free-pro-team: '*' enterprise-server: '*' @@ -18,12 +18,11 @@ GitHub Apps have the `Read-only` metadata permission by default. The metadata pe {% data reusables.apps.metadata-permissions %} - - [`GET /`](/v3/#root-endpoint) - [`GET /codes_of_conduct`](/v3/codes_of_conduct/#get-all-codes-of-conduct) - [`GET /codes_of_conduct/:key`](/v3/codes_of_conduct/#get-a-code-of-conduct) - [`GET /emojis`](/v3/emojis/#emojis) -- [`GET /feeds`](/v3/activity/feeds/#get-feeds) +- [`GET /feeds`](/rest/reference/activity#get-feeds) - [`GET /licenses`](/v3/licenses/#get-all-commonly-used-licenses) - [`GET /licenses/:key`](/v3/licenses/#get-a-license) - [`POST /markdown`](/v3/markdown/#render-a-markdown-document) @@ -39,22 +38,22 @@ GitHub Apps have the `Read-only` metadata permission by default. The metadata pe - [`GET /repos/:owner/:repo/community/profile`](/v3/repos/community/#get-community-profile-metrics) {% endif %} - [`GET /repos/:owner/:repo/contributors`](/v3/repos/#list-repository-contributors) -- [`GET /repos/:owner/:repo/forks`](/v3/repos/forks/#list-forks) +- [`GET /repos/:owner/:repo/forks`](/rest/reference/repos#list-forks) - [`GET /repos/:owner/:repo/languages`](/v3/repos/#list-repository-languages) - [`GET /repos/:owner/:repo/license`](/v3/licenses/#get-the-license-for-a-repository) -- [`GET /repos/:owner/:repo/stargazers`](/v3/activity/starring/#list-stargazers) +- [`GET /repos/:owner/:repo/stargazers`](/rest/reference/activity#list-stargazers) - [`GET /repos/:owner/:repo/stats/code_frequency`](/v3/repos/statistics/#get-the-weekly-commit-activity) - [`GET /repos/:owner/:repo/stats/commit_activity`](/v3/repos/statistics/#get-the-last-year-of-commit-activity) - [`GET /repos/:owner/:repo/stats/contributors`](/v3/repos/statistics/#get-all-contributor-commit-activity) - [`GET /repos/:owner/:repo/stats/participation`](/v3/repos/statistics/#get-the-weekly-commit-count) - [`GET /repos/:owner/:repo/stats/punch_card`](/v3/repos/statistics/#get-the-hourly-commit-count-for-each-day) -- [`GET /repos/:owner/:repo/subscribers`](/v3/activity/watching/#list-watchers) +- [`GET /repos/:owner/:repo/subscribers`](/rest/reference/activity#list-watchers) - [`GET /repos/:owner/:repo/tags`](/v3/repos/#list-repository-tags) - [`GET /repos/:owner/:repo/topics`](/v3/repos#get-all-repository-topics) - [`GET /repositories`](/v3/repos/#list-public-repositories) - [`GET /user/repos`](/v3/repos/#list-repositories-for-the-authenticated-user) -- [`GET /user/starred`](/v3/activity/starring/#list-repositories-starred-by-a-user) -- [`GET /user/subscriptions`](/v3/activity/watching/#list-repositories-watched-by-a-user) +- [`GET /user/starred`](/rest/reference/activity#list-repositories-starred-by-a-user) +- [`GET /user/subscriptions`](/rest/reference/activity#list-repositories-watched-by-a-user) - [`GET /users`](/v3/users/#list-users) - [`GET /users/:username`](/v3/users/#get-a-user) - [`GET /users/:username/followers`](/v3/users/followers/#list-followers-of-a-user) @@ -62,10 +61,10 @@ GitHub Apps have the `Read-only` metadata permission by default. The metadata pe - [`GET /users/:username/following/:target_user`](/v3/users/followers/#check-if-a-user-follows-another-user) - [`GET /users/:username/gpg_keys`](/v3/users/gpg_keys/#list-gpg-keys-for-a-user) - [`GET /users/:username/orgs`](/v3/orgs/#list-organizations-for-a-user) -- [`GET /users/:username/received_events`](/v3/activity/events/#list-events-received-by-the-authenticated-user) -- [`GET /users/:username/received_events/public`](/v3/activity/events/#list-public-events-received-by-a-user) +- [`GET /users/:username/received_events`](/rest/reference/activity#list-events-received-by-the-authenticated-user) +- [`GET /users/:username/received_events/public`](/rest/reference/activity#list-public-events-received-by-a-user) - [`GET /users/:username/repos`](/v3/repos/#list-repositories-for-a-user) -- [`GET /users/:username/subscriptions`](/v3/activity/watching/#list-repositories-watched-by-a-user) +- [`GET /users/:username/subscriptions`](/rest/reference/activity#list-repositories-watched-by-a-user) _Mitarbeiter_ - [`GET /repos/:owner/:repo/collaborators`](/v3/repos/collaborators/#list-repository-collaborators) @@ -78,12 +77,12 @@ _Commit-Kommentare_ - [`GET /repos/:owner/:repo/commits/:sha/comments`](/v3/repos/comments/#list-commit-comments) _Ereignisse_ -- [`GET /events`](/v3/activity/events/#list-public-events) -- [`GET /networks/:owner/:repo/events`](/v3/activity/events/#list-public-events-for-a-network-of-repositories) -- [`GET /orgs/:org/events`](/v3/activity/events/#list-public-organization-events) -- [`GET /repos/:owner/:repo/events`](/v3/activity/events/#list-repository-events) -- [`GET /users/:username/events`](/v3/activity/events/#list-events-for-the-authenticated-user) -- [`GET /users/:username/events/public`](/v3/activity/events/#list-public-events-for-a-user) +- [`GET /events`](/rest/reference/activity#list-public-events) +- [`GET /networks/:owner/:repo/events`](/rest/reference/activity#list-public-events-for-a-network-of-repositories) +- [`GET /orgs/:org/events`](/rest/reference/activity#list-public-organization-events) +- [`GET /repos/:owner/:repo/events`](/rest/reference/activity#list-repository-events) +- [`GET /users/:username/events`](/rest/reference/activity#list-events-for-the-authenticated-user) +- [`GET /users/:username/events/public`](/rest/reference/activity#list-public-events-for-a-user) _Git_ - [`GET /gitignore/templates`](/v3/gitignore/#get-all-gitignore-templates) @@ -169,7 +168,6 @@ _Suche_ {% if currentVersion == "free-pro-team@latest" %} - [`DELETE /repos/:owner/:repo/vulnerability-alerts`](/v3/repos/#disable-vulnerability-alerts) (:write) {% endif %} -- [`POST /user/repos`](/v3/repos/#create-a-repository-for-the-authenticated-user) (:write) - [`PATCH /user/repository_invitations/:invitation_id`](/v3/repos/invitations/#accept-a-repository-invitation) (:write) - [`DELETE /user/repository_invitations/:invitation_id`](/v3/repos/invitations/#decline-a-repository-invitation) (:write) @@ -344,12 +342,10 @@ _Traffic_ _Branches_ - [`GET /repos/:owner/:repo/branches`](/v3/repos/branches/#list-branches) (:read) - [`GET /repos/:owner/:repo/branches/:branch`](/v3/repos/branches/#get-a-branch) (:read) -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - [`GET /repos/:owner/:repo/branches/:branch/protection/restrictions/apps`](/v3/repos/branches/#list-apps-with-access-to-the-protected-branch) (:write) - [`POST /repos/:owner/:repo/branches/:branch/protection/restrictions/apps`](/v3/repos/branches/#add-app-access-restrictions) (:write) - [`PUT /repos/:owner/:repo/branches/:branch/protection/restrictions/apps`](/v3/repos/branches/#set-app-access-restrictions) (:write) - [`DELETE /repos/:owner/:repo/branches/:branch/protection/restrictions/apps`](/v3/repos/branches/#remove-user-access-restrictions) (:write) -{% endif %} _Commit-Kommentare_ - [`PATCH /repos/:owner/:repo/comments/:comment_id`](/v3/repos/comments/#update-a-commit-comment) (:write) @@ -363,13 +359,8 @@ _Git_ - [`POST /repos/:owner/:repo/git/commits`](/v3/git/commits/#create-a-commit) (:write) - [`GET /repos/:owner/:repo/git/commits/:commit_id`](/v3/git/commits/#get-a-commit) (:read) - [`POST /repos/:owner/:repo/git/refs`](/v3/git/refs/#create-a-reference) (:write) -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -- [`GET /repos/:owner/:repo/git/refs/:ref`](/v3/git/refs/#get-a-reference) (:read) -- [`GET /repos/:owner/:repo/git/refs`](/v3/git/refs/#list-references) (:read) -{% else %} - [`GET /repos/:owner/:repo/git/ref/:ref`](/v3/git/refs/#get-a-reference) (:read) - [`GET /repos/:owner/:repo/git/matching-refs/:ref`](/v3/git/refs/#list-matching-references) (:read) -{% endif %} - [`PATCH /repos/:owner/:repo/git/refs/:ref`](/v3/git/refs/#update-a-reference) (:write) - [`DELETE /repos/:owner/:repo/git/refs/:ref`](/v3/git/refs/#delete-a-reference) (:write) - [`POST /repos/:owner/:repo/git/tags`](/v3/git/tags/#create-a-tag-object) (:write) diff --git a/translations/de-DE/content/rest/reference/repos.md b/translations/de-DE/content/rest/reference/repos.md index 5cf8483635c3..6d7ca1e37da4 100644 --- a/translations/de-DE/content/rest/reference/repos.md +++ b/translations/de-DE/content/rest/reference/repos.md @@ -177,7 +177,7 @@ The authenticated user will be the author of any merges done through this endpoi ## Pages -The {% data variables.product.prodname_pages %} API retrieves information about your {% data variables.product.prodname_pages %} configuration, and the statuses of your builds. Information about the site and the builds can only be accessed by authenticated owners, even though the websites are public. For more information, see "[About {% data variables.product.prodname_pages %}](/github/working-with-github-pages/about-github-pages)." +The {% data variables.product.prodname_pages %} API retrieves information about your {% data variables.product.prodname_pages %} configuration, and the statuses of your builds. Information about the site and the builds can only be accessed by authenticated owners, even though the websites are public. Weitere Informationen findest Du unter „[Über {% data variables.product.prodname_pages %}](/github/working-with-github-pages/about-github-pages)." In {% data variables.product.prodname_pages %} API endpoints with a `status` key in their response, the value can be one of: * `null`: The site has yet to be built. @@ -186,10 +186,10 @@ In {% data variables.product.prodname_pages %} API endpoints with a `status` key * `built`: The site has been built. * `errored`: Indicates an error occurred during the build. -In {% data variables.product.prodname_pages %} API endpoints that {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}support the `mister-fantastic-preview` and{% endif %} return GitHub Pages site information, the JSON responses include these fields: +In {% data variables.product.prodname_pages %} API endpoints that return GitHub Pages site information, the JSON responses include these fields: * `html_url`: The absolute URL (including scheme) of the rendered Pages site. For example, `https://username.github.io`. * `source`: An object that contains the source branch and directory for the rendered Pages site. This includes: - - `branch`: The repository branch used to publish your [site's source files](/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site). For example, _master_ or _gh-pages_. + - `branch`: The repository branch used to publish your [site's source files](/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site). For example, _main_ or _gh-pages_. - `path`: The repository directory from which the site publishes. Will be either `/` or `/docs`. {% for operation in currentRestOperations %} @@ -216,7 +216,7 @@ The Repository Statistics API allows you to fetch the data that {% data variable Computing repository statistics is an expensive operation, so we try to return cached data whenever possible. If the data hasn't been cached when you query a repository's statistics, you'll receive a `202` response; a background job is also fired to start compiling these statistics. Give the job a few moments to complete, and then submit the request again. If the job has completed, that request will receive a `200` response with the statistics in the response body. -Repository statistics are cached by the SHA of the repository's default branch, which is usually master; pushing to the default branch resets the statistics cache. +Repository statistics are cached by the SHA of the repository's default branch; pushing to the default branch resets the statistics cache. ### Statistics exclude some types of commits diff --git a/translations/de-DE/data/glossaries/external.yml b/translations/de-DE/data/glossaries/external.yml index 27ceb8057537..5768ddb6adc4 100644 --- a/translations/de-DE/data/glossaries/external.yml +++ b/translations/de-DE/data/glossaries/external.yml @@ -180,7 +180,7 @@ - term: Standardbranch description: >- - Der Basis-Branch in Ihrem Repository, für den alle Pull Requests und Code-Commits automatisch gesendet werden, sofern Sie keinen anderen Branch angeben. Dieser Branch wird in der Regel als „Master“ bezeichnet. + The base branch for new pull requests and code commits in a repository. Each repository has at least one branch, which Git creates when you initialize the repository. The first branch is usually called `main`, and is often the default branch. - term: Abhängigkeitsdiagramm description: >- diff --git a/translations/de-DE/data/glossaries/internal.yml b/translations/de-DE/data/glossaries/internal.yml index ec73067b56eb..e4a0db597fae 100644 --- a/translations/de-DE/data/glossaries/internal.yml +++ b/translations/de-DE/data/glossaries/internal.yml @@ -737,7 +737,7 @@ description: >- Die Struktur der tatsächlich ausgecheckten Dateien. Die Arbeitsstruktur enthält normalerweise die Inhalte der Struktur des HEAD-Commits sowie die von Ihnen vorgenommenen lokalen Änderungen, die noch nicht committed wurden. - - term: WYSIWIG + term: WYSIWYG description: >- What You See Is What You Get (WYSIWYG, Vorschau). Ein Akronym, das bedeutet, dass der Bildschirmtext genauso aussieht, wenn er dargestellt wird. - diff --git a/translations/de-DE/data/graphql/graphql_previews.yml b/translations/de-DE/data/graphql/graphql_previews.yml index 1a353f1c6c4a..a66636c86d8b 100644 --- a/translations/de-DE/data/graphql/graphql_previews.yml +++ b/translations/de-DE/data/graphql/graphql_previews.yml @@ -27,57 +27,6 @@ - CreateDeploymentPayload owning_teams: - '@github/ecosystem-api' -- - title: Prüfungen - description: This preview adds support for reading checks created by GitHub Apps. - toggled_by: ':antiope-preview' - announcement: null - updates: null - toggled_on: - - CheckAnnotationRange - - CheckAnnotationPosition - - CheckAnnotationSpan - - CheckAnnotation - - CheckAnnotationConnection.nodes - - CheckAnnotationData - - CheckAnnotationEdge.node - - CheckAnnotationLevel - - CheckConclusionState - - CheckStatusState - - CheckSuiteAutoTriggerPreference - - CheckRun - - CheckRunConnection.nodes - - CheckRunEdge.node - - CheckRunAction - - CheckRunFilter - - CheckRunOutput - - CheckRunOutputImage - - CheckRunType - - CheckSuite - - CheckSuiteConnection.nodes - - CheckSuiteEdge.node - - CheckSuiteFilter - - CreateCheckRunInput - - CreateCheckRunPayload - - CreateCheckSuiteInput - - CreateCheckSuitePayload - - Commit.checkSuites - - Mutation.createCheckRun - - Mutation.createCheckSuite - - Mutation.rerequestCheckSuite - - Mutation.updateCheckRun - - Mutation.updateCheckSuitePreferences - - Push - - RequestableCheckStatusState - - RerequestCheckSuiteInput - - RerequestCheckSuitePayload - - UpdateCheckRunInput - - UpdateCheckRunPayload - - UpdateCheckSuitePayload.checkSuite - - UpdateCheckSuitePreferencesInput - - UpdateCheckSuitePreferencesPayload - owning_teams: - - '@github/ce-extensibility' - title: >- MergeInfoPreview - More detailed information about a pull request's merge state. diff --git a/translations/de-DE/data/products.yml b/translations/de-DE/data/products.yml index 78527bebbce9..3f033072dc98 100644 --- a/translations/de-DE/data/products.yml +++ b/translations/de-DE/data/products.yml @@ -4,7 +4,7 @@ #note this file should not be translated productsInOrder: - github - - enterpriseServer + - verwalten - actions - Pakete - developers @@ -12,12 +12,3 @@ productsInOrder: - graphql - insights - desktop -#TODO this can be removed when the new versioning handling is in place -hasEnterpriseUserVersions: - - github - - actions - - developers - - rest - - graphql - - insights - - Pakete diff --git a/translations/de-DE/data/reusables/actions/about-artifact-log-retention.md b/translations/de-DE/data/reusables/actions/about-artifact-log-retention.md new file mode 100644 index 000000000000..aa8a5300359d --- /dev/null +++ b/translations/de-DE/data/reusables/actions/about-artifact-log-retention.md @@ -0,0 +1,6 @@ +By default, the artifacts and log files generated by workflows are retained for 90 days before they are automatically deleted. You can adjust the retention period, depending on the type of repository: + +- For public repositories: you can change this retention period to anywhere between 1 day or 90 days. +- For private, internal, and {% data variables.product.prodname_enterprise %} repositories: you can change this retention period to anywhere between 1 day or 400 days. + +When you customize the retention period, it only applies to new artifacts and log files, and does not retroactively apply to existing objects. For managed repositories and organizations, the maximum retention period cannot exceed the limit set by the managing organization or enterprise. diff --git a/translations/de-DE/data/reusables/actions/about-artifacts.md b/translations/de-DE/data/reusables/actions/about-artifacts.md index 99b604753e4b..232a96ad0971 100644 --- a/translations/de-DE/data/reusables/actions/about-artifacts.md +++ b/translations/de-DE/data/reusables/actions/about-artifacts.md @@ -1 +1 @@ -Artifacts enable you to share data between jobs in a workflow and store data once that workflow has completed. \ No newline at end of file +Artifacts enable you to share data between jobs in a workflow and store data once that workflow has completed. diff --git a/translations/de-DE/data/reusables/actions/about-secrets.md b/translations/de-DE/data/reusables/actions/about-secrets.md index 94b36e1c5846..9035067f833a 100644 --- a/translations/de-DE/data/reusables/actions/about-secrets.md +++ b/translations/de-DE/data/reusables/actions/about-secrets.md @@ -1 +1 @@ -Encrypted secrets allow you to store sensitive information, such as access tokens, in your repository or organization. \ No newline at end of file +Encrypted secrets allow you to store sensitive information, such as access tokens, in your repository or organization. diff --git a/translations/de-DE/data/reusables/actions/about-self-hosted-runners.md b/translations/de-DE/data/reusables/actions/about-self-hosted-runners.md index 0e2edd274acf..5ac03cc46b28 100644 --- a/translations/de-DE/data/reusables/actions/about-self-hosted-runners.md +++ b/translations/de-DE/data/reusables/actions/about-self-hosted-runners.md @@ -1 +1 @@ -Self-hosted runners allow you to host your own runners and customize the environment used to run jobs in your {% data variables.product.prodname_actions %} workflows. \ No newline at end of file +Self-hosted runners allow you to host your own runners and customize the environment used to run jobs in your {% data variables.product.prodname_actions %} workflows. diff --git a/translations/de-DE/data/reusables/actions/about-workflow-jobs.md b/translations/de-DE/data/reusables/actions/about-workflow-jobs.md index ba8ef85e4da8..33439420967f 100644 --- a/translations/de-DE/data/reusables/actions/about-workflow-jobs.md +++ b/translations/de-DE/data/reusables/actions/about-workflow-jobs.md @@ -1 +1 @@ -A workflow job is a set of steps that execute on the same runner. \ No newline at end of file +A workflow job is a set of steps that execute on the same runner. diff --git a/translations/de-DE/data/reusables/actions/about-workflow-runs.md b/translations/de-DE/data/reusables/actions/about-workflow-runs.md index fc10b8a30547..103cdc577724 100644 --- a/translations/de-DE/data/reusables/actions/about-workflow-runs.md +++ b/translations/de-DE/data/reusables/actions/about-workflow-runs.md @@ -1 +1 @@ -A workflow run is an instance of your workflow that runs when the pre-configured event occurs. \ No newline at end of file +A workflow run is an instance of your workflow that runs when the pre-configured event occurs. diff --git a/translations/de-DE/data/reusables/actions/about-workflows.md b/translations/de-DE/data/reusables/actions/about-workflows.md index 6ff1dd709ae1..3c044274d0f5 100644 --- a/translations/de-DE/data/reusables/actions/about-workflows.md +++ b/translations/de-DE/data/reusables/actions/about-workflows.md @@ -1 +1 @@ -Workflows automate your software development life cycle with a wide range of tools and services. \ No newline at end of file +Workflows automate your software development life cycle with a wide range of tools and services. diff --git a/translations/de-DE/data/reusables/actions/actions-app-actions-permissions-api.md b/translations/de-DE/data/reusables/actions/actions-app-actions-permissions-api.md index 251474c83b40..90dc3d003980 100644 --- a/translations/de-DE/data/reusables/actions/actions-app-actions-permissions-api.md +++ b/translations/de-DE/data/reusables/actions/actions-app-actions-permissions-api.md @@ -1 +1 @@ -{% data variables.product.prodname_github_app %}s must have the `actions` permission to use this API. \ No newline at end of file +{% data variables.product.prodname_github_app %}s must have the `actions` permission to use this API. diff --git a/translations/de-DE/data/reusables/actions/actions-authentication.md b/translations/de-DE/data/reusables/actions/actions-authentication.md index 266246660c6e..a047e0b5c463 100644 --- a/translations/de-DE/data/reusables/actions/actions-authentication.md +++ b/translations/de-DE/data/reusables/actions/actions-authentication.md @@ -1 +1 @@ -This API is available for authenticated users, {% data variables.product.prodname_oauth_app %}s, and {% data variables.product.prodname_github_app %}s. Access tokens require [`repo` scope](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes) for private repos and [`public_repo` scope](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes) for public repos. \ No newline at end of file +This API is available for authenticated users, {% data variables.product.prodname_oauth_app %}s, and {% data variables.product.prodname_github_app %}s. Access tokens require [`repo` scope](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes) for private repos and [`public_repo` scope](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes) for public repos. diff --git a/translations/de-DE/data/reusables/actions/actions-not-verified.md b/translations/de-DE/data/reusables/actions/actions-not-verified.md index b2a9577daa60..cb26fa9d61f6 100644 --- a/translations/de-DE/data/reusables/actions/actions-not-verified.md +++ b/translations/de-DE/data/reusables/actions/actions-not-verified.md @@ -1 +1 @@ -Anyone can publish an action in {% data variables.product.prodname_marketplace %} as long as they meet the terms of service. Unlike apps, {% data variables.product.prodname_actions %} listed in {% data variables.product.prodname_marketplace %} are not verified by {% data variables.product.prodname_dotcom %}. \ No newline at end of file +Anyone can publish an action in {% data variables.product.prodname_marketplace %} as long as they meet the terms of service. Unlike apps, {% data variables.product.prodname_actions %} listed in {% data variables.product.prodname_marketplace %} are not verified by {% data variables.product.prodname_dotcom %}. diff --git a/translations/de-DE/data/reusables/actions/actions-use-policy-settings.md b/translations/de-DE/data/reusables/actions/actions-use-policy-settings.md new file mode 100644 index 000000000000..b25cd5eb26be --- /dev/null +++ b/translations/de-DE/data/reusables/actions/actions-use-policy-settings.md @@ -0,0 +1,3 @@ +If you choose the option to **Allow specific actions**, there are additional options that you can configure. For more information, see "[Allowing specific actions to run](#allowing-specific-actions-to-run)." + +When you allow local actions only, the policy blocks all access to actions authored by {% data variables.product.prodname_dotcom %}. For example, the [`actions/checkout`](https://github.com/actions/checkout) would not be accessible. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/actions/allow-specific-actions-intro.md b/translations/de-DE/data/reusables/actions/allow-specific-actions-intro.md new file mode 100644 index 000000000000..248668d773ef --- /dev/null +++ b/translations/de-DE/data/reusables/actions/allow-specific-actions-intro.md @@ -0,0 +1,19 @@ +When you select the **Allow select actions**, there are additional options that you need to choose to configure the allowed actions: + +- **Allow actions created by {% data variables.product.prodname_dotcom %}:** You can allow all actions created by {% data variables.product.prodname_dotcom %} to be used by workflows. Actions created by {% data variables.product.prodname_dotcom %} are located in the `actions` and `github` organization. For more information, see the [`actions`](https://github.com/actions) and [`github`](https://github.com/github) organizations. +- **Allow Marketplace actions by verified creators:** You can allow all {% data variables.product.prodname_marketplace %} actions created by verified creators to be used by workflows. When GitHub has verified the creator of the action as a partner organization, the {% octicon "verified" aria-label="The verified badge" %} badge is displayed next to the action in {% data variables.product.prodname_marketplace %}. +- **Allow specified actions:** You can restrict workflows to use actions in specific organizations and repositories. + + To restrict access to specific tags or commit SHAs of an action, use the same `/@` syntax used in the workflow to select the action. For example, `actions/javascript-action@v1.0.1` to select a tag or `actions/javascript-action@172239021f7ba04fe7327647b213799853a9eb89` to select a SHA. For more information, see "[Finding and customizing actions](/actions/learn-github-actions/finding-and-customizing-actions#using-release-management-for-your-custom-actions)." + + You can use the `*` wildcard character to match patterns. For example, to allow all actions in organizations that start with `space-org`, you can specify `space-org*/*`. To add all actions in repositories that start with octocat, you can use `*/octocat*@*`. For more information about using the `*` wildcard, see "[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#filter-pattern-cheat-sheet)." + + {% if currentVersion == "free-pro-team@latest" %} + {% note %} + + **Note:** The **Allow specified actions** option is only available in public repositories with the {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} for organizations, or {% data variables.product.prodname_team %} plan. + + {% endnote %} + {% endif %} + +This procedure demonstrates how to add specific actions to the allow list. diff --git a/translations/de-DE/data/reusables/actions/enterprise-actions-permissions.md b/translations/de-DE/data/reusables/actions/enterprise-actions-permissions.md index fb9bd1119ddf..72c38f66bcae 100644 --- a/translations/de-DE/data/reusables/actions/enterprise-actions-permissions.md +++ b/translations/de-DE/data/reusables/actions/enterprise-actions-permissions.md @@ -1 +1 @@ -1. Under "Policies", select an option. ![Enable, disable, or limits actions for this enterprise account](/assets/images/help/settings/actions-enable-enterprise-account.png) \ No newline at end of file +1. Under "Policies", select an option. ![Enable, disable, or limits actions for this enterprise account](/assets/images/help/organizations/enterprise-actions-policy.png) diff --git a/translations/de-DE/data/reusables/actions/enterprise-beta.md b/translations/de-DE/data/reusables/actions/enterprise-beta.md index 876f328cd5c0..30eac75a9196 100644 --- a/translations/de-DE/data/reusables/actions/enterprise-beta.md +++ b/translations/de-DE/data/reusables/actions/enterprise-beta.md @@ -4,4 +4,4 @@ **Note:** {% data variables.product.prodname_actions %} support on {% data variables.product.prodname_ghe_server %} 2.22 is a limited public beta. To review the external storage requirements and request access to the beta, see "[Enabling {% data variables.product.prodname_actions %} and configuring storage](/enterprise/admin/github-actions/enabling-github-actions-and-configuring-storage)." {% endnote %} -{% endif %} \ No newline at end of file +{% endif %} diff --git a/translations/de-DE/data/reusables/actions/enterprise-github-hosted-runners.md b/translations/de-DE/data/reusables/actions/enterprise-github-hosted-runners.md index 1ef3c4ce19a6..178bf09abe72 100644 --- a/translations/de-DE/data/reusables/actions/enterprise-github-hosted-runners.md +++ b/translations/de-DE/data/reusables/actions/enterprise-github-hosted-runners.md @@ -4,4 +4,4 @@ **Note:** {% data variables.product.prodname_dotcom %}-hosted runners are not currently supported on {% data variables.product.prodname_ghe_server %}. You can see more information about planned future support on the [{% data variables.product.prodname_roadmap %}](https://github.com/github/roadmap/issues/72). {% endnote %} -{% endif %} \ No newline at end of file +{% endif %} diff --git a/translations/de-DE/data/reusables/actions/registry-credentials.md b/translations/de-DE/data/reusables/actions/registry-credentials.md new file mode 100644 index 000000000000..829539de7800 --- /dev/null +++ b/translations/de-DE/data/reusables/actions/registry-credentials.md @@ -0,0 +1 @@ +If the image's container registry requires authentication to pull the image, you can use `credentials` to set a `map` of the `username` and `password`. The credentials are the same values that you would provide to the [`docker login`](https://docs.docker.com/engine/reference/commandline/login/) command. diff --git a/translations/de-DE/data/reusables/actions/scheduled-workflows-disabled.md b/translations/de-DE/data/reusables/actions/scheduled-workflows-disabled.md new file mode 100644 index 000000000000..bdec7e515b23 --- /dev/null +++ b/translations/de-DE/data/reusables/actions/scheduled-workflows-disabled.md @@ -0,0 +1 @@ +To prevent unnecessary workflow runs, scheduled workflows may be disabled automatically. When a public repository is forked, scheduled workflows are disabled by default. In a public repository, scheduled workflows are automatically disabled when no repository activity has occurred in 60 days. diff --git a/translations/de-DE/data/reusables/apps/general-apps-restrictions.md b/translations/de-DE/data/reusables/apps/general-apps-restrictions.md index 20e20ff5ecf4..3d59f0f6edb2 100644 --- a/translations/de-DE/data/reusables/apps/general-apps-restrictions.md +++ b/translations/de-DE/data/reusables/apps/general-apps-restrictions.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}If you are using your app with GitHub Actions and want to modify workflow files, you must authenticate on behalf of the user with an OAuth token that includes the `workflow` scope. The user must have admin or write permission to the repository that contains the workflow file. For more information, see "[Understanding scopes for OAuth apps](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)."{% endif %} \ No newline at end of file +{% if currentVersion == "free-pro-team@latest" %}If you are using your app with GitHub Actions and want to modify workflow files, you must authenticate on behalf of the user with an OAuth token that includes the `workflow` scope. The user must have admin or write permission to the repository that contains the workflow file. For more information, see "[Understanding scopes for OAuth apps](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)."{% endif %} diff --git a/translations/de-DE/data/reusables/apps/maximum-github-apps-allowed.md b/translations/de-DE/data/reusables/apps/maximum-github-apps-allowed.md index 93e063db4cb6..e1b7a44e3c28 100644 --- a/translations/de-DE/data/reusables/apps/maximum-github-apps-allowed.md +++ b/translations/de-DE/data/reusables/apps/maximum-github-apps-allowed.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}A user or organization can own up to 100 GitHub Apps.{% endif %} \ No newline at end of file +{% if currentVersion == "free-pro-team@latest" %}A user or organization can own up to 100 GitHub Apps.{% endif %} diff --git a/translations/de-DE/data/reusables/apps/maximum-oauth-apps-allowed.md b/translations/de-DE/data/reusables/apps/maximum-oauth-apps-allowed.md index b46e9b82c9dc..9e65b80fe2a6 100644 --- a/translations/de-DE/data/reusables/apps/maximum-oauth-apps-allowed.md +++ b/translations/de-DE/data/reusables/apps/maximum-oauth-apps-allowed.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}A user or organization can own up to 100 OAuth apps.{% endif %} \ No newline at end of file +{% if currentVersion == "free-pro-team@latest" %}A user or organization can own up to 100 OAuth apps.{% endif %} diff --git a/translations/de-DE/data/reusables/apps/metadata-permissions.md b/translations/de-DE/data/reusables/apps/metadata-permissions.md index 61bc044a800f..37608ebcb59c 100644 --- a/translations/de-DE/data/reusables/apps/metadata-permissions.md +++ b/translations/de-DE/data/reusables/apps/metadata-permissions.md @@ -1 +1 @@ -If you set the metadata permission to `No access` and select a permission that requires repository access, GitHub will override your selection and set the metadata permission back to `Read-only`. To set the metadata permission to `No access`, you must set all permissions that require repository access to `No access` first. \ No newline at end of file +If you set the metadata permission to `No access` and select a permission that requires repository access, GitHub will override your selection and set the metadata permission back to `Read-only`. To set the metadata permission to `No access`, you must set all permissions that require repository access to `No access` first. diff --git a/translations/de-DE/data/reusables/apps/oauth-apps-restrictions.md b/translations/de-DE/data/reusables/apps/oauth-apps-restrictions.md index 2ae56010bacc..fa81dbf36df1 100644 --- a/translations/de-DE/data/reusables/apps/oauth-apps-restrictions.md +++ b/translations/de-DE/data/reusables/apps/oauth-apps-restrictions.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}If you are using your OAuth App with GitHub Actions and want to modify workflow files, your OAuth token must have the `workflow` scope and the user must have owner or write permission to the repository that contains the workflow file. For more information, see "[Understanding scopes for OAuth apps](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)."{% endif %} \ No newline at end of file +{% if currentVersion == "free-pro-team@latest" %}If you are using your OAuth App with GitHub Actions and want to modify workflow files, your OAuth token must have the `workflow` scope and the user must have owner or write permission to the repository that contains the workflow file. For more information, see "[Understanding scopes for OAuth apps](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)."{% endif %} diff --git a/translations/de-DE/data/reusables/apps/state_description.md b/translations/de-DE/data/reusables/apps/state_description.md index fd754d2939f2..927d8b8a0071 100644 --- a/translations/de-DE/data/reusables/apps/state_description.md +++ b/translations/de-DE/data/reusables/apps/state_description.md @@ -1 +1 @@ -An unguessable random string. It is used to protect against cross-site request forgery attacks. \ No newline at end of file +An unguessable random string. It is used to protect against cross-site request forgery attacks. diff --git a/translations/de-DE/data/reusables/audit_log/audit-log-search.md b/translations/de-DE/data/reusables/audit_log/audit-log-search.md index aee3b05bf893..be4cf2219c2f 100644 --- a/translations/de-DE/data/reusables/audit_log/audit-log-search.md +++ b/translations/de-DE/data/reusables/audit_log/audit-log-search.md @@ -8,7 +8,6 @@ Das Protokoll enthält die folgenden Informationen zu jeder Aktion: Beachte, dass Du nicht mit Text nach Einträgen suchen kannst. Du kannst jedoch Suchabfragen mit den verschiedensten Filtern erstellen. Viele Operatoren, die für die Abfrage des Log verwendet werden - wie z.B. `-`, `>` oder `<` - haben das gleiche Format wie die Suche über {% data variables.product.product_name %}. Weitere Informationen findest Du unter „[Suchen nach {% data variables.product.prodname_dotcom %}](/github/searching-for-information-on-github/about-searching-on-github).“ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} #### Vorgangsbasierte Suche Verwende den Qualifizierer `operation` (Vorgang) um Aktionen für spezifische Typen von Vorgängen zu beschränken. Ein Beispiel: @@ -20,7 +19,6 @@ Verwende den Qualifizierer `operation` (Vorgang) um Aktionen für spezifische Ty * `operation:remove` (Vorgangsentfernung) findet alle Ereignisse, bei denen eine vorhandene Ressource entfernt wurde. * `operation:restore` (Vorgangswiederherstellung) findet alle Ereignisse, bei denen eine vorhandene Ressource wiederhergestellt wurde. * `operation:transfer` (Vorgangsübertragung) findet alle Ereignisse, bei denen eine vorhandene Ressource übertragen wurde. -{% endif %} #### Suche basierend auf Repository @@ -40,4 +38,4 @@ Der Qualifizierer `actor` (Akteur) kann Ereignisse einschränken basierend darau * `actor:octocat actor:hubot` findet alle Ereignisse in Verbindung mit Aktionen, die von `octocat` oder `hubot` ausgeführt wurden. * `-actor:hubot` schließt alle Ereignisse in Verbindung mit Aktionen aus, die von `hubot` ausgeführt wurden. -Beachte, dass Du nur den in {% data variables.product.product_name %} verwendeten Benutzernamen, nicht den wirklichen Namen eines Benutzers, verwenden kannst. +Beachten Sie, dass Sie nur den in {% data variables.product.product_name %} verwendeten Benutzernamen, nicht den wirklichen Namen eines Benutzers, verwenden können. diff --git a/translations/de-DE/data/reusables/branches/change-default-branch.md b/translations/de-DE/data/reusables/branches/change-default-branch.md new file mode 100644 index 000000000000..2a44e1845aa7 --- /dev/null +++ b/translations/de-DE/data/reusables/branches/change-default-branch.md @@ -0,0 +1 @@ +You can change the default branch for an existing repository. For more information, see "[Changing the default branch](/github/administering-a-repository/changing-the-default-branch)." diff --git a/translations/de-DE/data/reusables/branches/default-branch-automatically-base-branch.md b/translations/de-DE/data/reusables/branches/default-branch-automatically-base-branch.md index 9350f601c269..b7e77330c423 100644 --- a/translations/de-DE/data/reusables/branches/default-branch-automatically-base-branch.md +++ b/translations/de-DE/data/reusables/branches/default-branch-automatically-base-branch.md @@ -1 +1,2 @@ -The default branch is the base branch in your repository, against which all pull requests and code commits are automatically made, unless you specify a different branch. \ No newline at end of file +Unless you specify a different branch, the default branch in a repository is the base branch for new pull requests and code commits. + diff --git a/translations/de-DE/data/reusables/branches/new-repo-default-branch.md b/translations/de-DE/data/reusables/branches/new-repo-default-branch.md index 99628077f836..d85e1174ba7f 100644 --- a/translations/de-DE/data/reusables/branches/new-repo-default-branch.md +++ b/translations/de-DE/data/reusables/branches/new-repo-default-branch.md @@ -1 +1,2 @@ -When you create a repository on {% data variables.product.prodname_dotcom %} with content, the repository is initialized with a single branch, called the default branch. \ No newline at end of file +When you create a repository with content on {% data variables.product.product_location %}, {% data variables.product.product_name %} creates the repository with a single branch. This first branch in the repository is the default branch. + diff --git a/translations/de-DE/data/reusables/branches/set-default-branch.md b/translations/de-DE/data/reusables/branches/set-default-branch.md index a36fcc41b762..f5ff905d85ca 100644 --- a/translations/de-DE/data/reusables/branches/set-default-branch.md +++ b/translations/de-DE/data/reusables/branches/set-default-branch.md @@ -1 +1 @@ -If you have admin permissions to a repository, you can change the default branch to another existing branch. For more information, see "[Setting the default branch](/github/administering-a-repository/setting-the-default-branch)." +You can set the name of the default branch for new repositories. For more information, see "[Managing the default branch for your repositories](/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories)," "[Managing the default branch name for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization)," or "[Enforcing a policy on the default branch name](/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account#enforcing-a-policy-on-the-default-branch-name)." diff --git a/translations/de-DE/data/reusables/code-scanning/analyze-go.md b/translations/de-DE/data/reusables/code-scanning/analyze-go.md new file mode 100644 index 000000000000..56f04cb3de4a --- /dev/null +++ b/translations/de-DE/data/reusables/code-scanning/analyze-go.md @@ -0,0 +1 @@ +{% data variables.product.prodname_codeql %} also runs a build for Go projects to set up the project. However, in contrast to the other compiled languages, all Go files in the repository are extracted, not just those that are built. Custom build commands are not supported for Go. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/code-scanning/autobuild-add-build-steps.md b/translations/de-DE/data/reusables/code-scanning/autobuild-add-build-steps.md index 61f06aaba9d0..40b9ba69836b 100644 --- a/translations/de-DE/data/reusables/code-scanning/autobuild-add-build-steps.md +++ b/translations/de-DE/data/reusables/code-scanning/autobuild-add-build-steps.md @@ -1 +1 @@ -If the C/C++, C#, or Java code in your repository has a non-standard build process or if it's written in more than one compiled language, `autobuild` may fail. You will need to remove the `autobuild` step from the workflow, and manually add build steps. +If the C/C++, C#, or Java code in your repository has a non-standard build process, `autobuild` may fail. You will need to remove the `autobuild` step from the workflow, and manually add build steps. diff --git a/translations/de-DE/data/reusables/code-scanning/autobuild-compiled-languages.md b/translations/de-DE/data/reusables/code-scanning/autobuild-compiled-languages.md index aa17161c559a..1e599d813b1b 100644 --- a/translations/de-DE/data/reusables/code-scanning/autobuild-compiled-languages.md +++ b/translations/de-DE/data/reusables/code-scanning/autobuild-compiled-languages.md @@ -1,5 +1 @@ -For compiled languages like C/C++, C#, and Java, the `autobuild` step in the default workflow attempts to build code before the action performs {% data variables.product.prodname_codeql %} analysis. In contrast to the other compiled languages, {% data variables.product.prodname_codeql %} analyzes Go without building the code. - -The `autobuild` process only ever attempts to build _one_ compiled language for a repository. The language automatically selected for analysis is the language with most files. - - +For the supported compiled languages, you can use the `autobuild` action in the {% data variables.product.prodname_codeql_workflow %} to build your code. This avoids you having to specify explicit build commands for C/C++, C#, and Java. diff --git a/translations/de-DE/data/reusables/code-scanning/beta-codeql-runner.md b/translations/de-DE/data/reusables/code-scanning/beta-codeql-runner.md new file mode 100644 index 000000000000..f83682fcfaca --- /dev/null +++ b/translations/de-DE/data/reusables/code-scanning/beta-codeql-runner.md @@ -0,0 +1,9 @@ +{% if currentVersion == "free-pro-team@latest" %} + +{% note %} + +**Note:** The {% data variables.product.prodname_codeql_runner %} is currently in beta and subject to change. + +{% endnote %} + +{% endif %} diff --git a/translations/de-DE/data/reusables/code-scanning/beta.md b/translations/de-DE/data/reusables/code-scanning/beta.md index 7a2fb6418f8b..9f16a9f2e2f5 100644 --- a/translations/de-DE/data/reusables/code-scanning/beta.md +++ b/translations/de-DE/data/reusables/code-scanning/beta.md @@ -1,5 +1,9 @@ +{% if currentVersion == "enterprise-server@2.22" %} + {% note %} -**Hinweis:** {% data variables.product.prodname_code_scanning_capc %} befindet sich derzeit in der Beta-Version und kann sich jederzeit verändern. Um Zugriff auf die Beta-Version zu erhalten, [tritt der Warteliste bei](https://github.com/features/security/advanced-security/signup). +**Hinweis:** {% data variables.product.prodname_code_scanning_capc %} befindet sich derzeit in der Beta-Version und kann sich jederzeit verändern. For more information about taking part in the beta, [sign up here](https://resources.github.com/beta-signup/). {% endnote %} + +{% endif %} diff --git a/translations/de-DE/data/reusables/code-scanning/click-alert-in-list.md b/translations/de-DE/data/reusables/code-scanning/click-alert-in-list.md index 996c3b339e46..347685c60bd7 100644 --- a/translations/de-DE/data/reusables/code-scanning/click-alert-in-list.md +++ b/translations/de-DE/data/reusables/code-scanning/click-alert-in-list.md @@ -1 +1 @@ -1. Unter „Code scanning“ (Code durchsuchen) klicke auf die Warnung, die Du anzeigen möchtest. ![Liste der Warnungen von {% data variables.product.prodname_code_scanning %}](/assets/images/help/repository/code-scanning-click-alert.png) +1. Under "Code scanning," click the alert you'd like to explore. ![Liste der Warnungen von {% data variables.product.prodname_code_scanning %}](/assets/images/help/repository/code-scanning-click-alert.png) diff --git a/translations/de-DE/data/reusables/code-scanning/close-alert-examples.md b/translations/de-DE/data/reusables/code-scanning/close-alert-examples.md new file mode 100644 index 000000000000..394120901f5f --- /dev/null +++ b/translations/de-DE/data/reusables/code-scanning/close-alert-examples.md @@ -0,0 +1 @@ +For example, an error in code that's used only for testing, or when the effort of fixing the error is greater than the potential benefit of improving the code. diff --git a/translations/de-DE/data/reusables/code-scanning/codeql-runner-license.md b/translations/de-DE/data/reusables/code-scanning/codeql-runner-license.md index 17283fb710b2..96d197d8dc19 100644 --- a/translations/de-DE/data/reusables/code-scanning/codeql-runner-license.md +++ b/translations/de-DE/data/reusables/code-scanning/codeql-runner-license.md @@ -1,10 +1,12 @@ {% note %} {% if currentVersion == "free-pro-team@latest" %} -**Note:** The {% data variables.product.prodname_codeql_runner %} uses the {% data variables.product.prodname_codeql %} CLI to analyze code and therefore has the same license conditions. It's free to use on public repositories that are maintained on {% data variables.product.prodname_dotcom_the_website %}, and available to use on private repositories that are owned by customers with an {% data variables.product.prodname_advanced_security %} license. For information, see "[{% data variables.product.product_name %} {% data variables.product.prodname_codeql %} Terms and Conditions](https://securitylab.github.com/tools/codeql/license)" and "[{% data variables.product.prodname_codeql %} CLI](https://help.semmle.com/codeql/codeql-cli.html)." +**Note:** The +{% data variables.product.prodname_codeql_runner %} uses the {% data variables.product.prodname_codeql %} CLI to analyze code and therefore has the same license conditions. It's free to use on public repositories that are maintained on {% data variables.product.prodname_dotcom_the_website %}, and available to use on private repositories that are owned by customers with an {% data variables.product.prodname_advanced_security %} license. For information, see "[{% data variables.product.product_name %} {% data variables.product.prodname_codeql %} Terms and Conditions](https://securitylab.github.com/tools/codeql/license)" and "[{% data variables.product.prodname_codeql %} CLI](https://help.semmle.com/codeql/codeql-cli.html)." {% else %} -**Note:** The {% data variables.product.prodname_codeql_runner %} is available to customers with an {% data variables.product.prodname_advanced_security %} license. +**Note:** The +{% data variables.product.prodname_codeql_runner %} is available to customers with an {% data variables.product.prodname_advanced_security %} license. {% endif %} -{% endnote %} \ No newline at end of file +{% endnote %} diff --git a/translations/de-DE/data/reusables/code-scanning/edit-workflow.md b/translations/de-DE/data/reusables/code-scanning/edit-workflow.md index d5ba1fcae3d2..98bd06f5cb10 100644 --- a/translations/de-DE/data/reusables/code-scanning/edit-workflow.md +++ b/translations/de-DE/data/reusables/code-scanning/edit-workflow.md @@ -1 +1 @@ -Typically, you don't need to edit the default workflow for {% data variables.product.prodname_code_scanning %}. However, if required, you can edit the workflow to customize some of the settings. For example, you can edit {% data variables.product.prodname_dotcom %}'s {% data variables.product.prodname_codeql_workflow %} to specify the frequency of scans, the languages or directories to scan, and what {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} looks for in your code. You might also need to edit the workflow if you use a specific set of commands to compile your code or if there is more than one compiled language in your repository. +Typically, you don't need to edit the default workflow for {% data variables.product.prodname_code_scanning %}. However, if required, you can edit the workflow to customize some of the settings. For example, you can edit {% data variables.product.prodname_dotcom %}'s {% data variables.product.prodname_codeql_workflow %} to specify the frequency of scans, the languages or directories to scan, and what {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} looks for in your code. You might also need to edit the {% data variables.product.prodname_codeql_workflow %} if you use a specific set of commands to compile your code. diff --git a/translations/de-DE/data/reusables/code-scanning/enabling-options.md b/translations/de-DE/data/reusables/code-scanning/enabling-options.md index 6b1c8b1a10b9..3ef6731b266a 100644 --- a/translations/de-DE/data/reusables/code-scanning/enabling-options.md +++ b/translations/de-DE/data/reusables/code-scanning/enabling-options.md @@ -28,4 +28,4 @@ Using {% data variables.product.prodname_actions %} (see "Enabling {% data variables.product.prodname_code_scanning %} using actions") or generated externally and uploaded to {% data variables.product.product_name %} (see "Uploading a SARIF file to {% data variables.product.prodname_dotcom %}"). - \ No newline at end of file + diff --git a/translations/de-DE/data/reusables/code-scanning/false-positive-fix-codeql.md b/translations/de-DE/data/reusables/code-scanning/false-positive-fix-codeql.md new file mode 100644 index 000000000000..db3da9c9d538 --- /dev/null +++ b/translations/de-DE/data/reusables/code-scanning/false-positive-fix-codeql.md @@ -0,0 +1 @@ +If you close a {% data variables.product.prodname_codeql %} alert as a false positive result, for example because the code uses a sanitization library that isn't supported, consider contributing to the {% data variables.product.prodname_codeql %} repository and improving the analysis. For more information about {% data variables.product.prodname_codeql %}, see "[Contributing to {% data variables.product.prodname_codeql %}](https://github.com/github/codeql/blob/main/CONTRIBUTING.md)." diff --git a/translations/de-DE/data/reusables/code-scanning/interoperable-with-tools-that-output-sarif.md b/translations/de-DE/data/reusables/code-scanning/interoperable-with-tools-that-output-sarif.md index 65786b3f732b..17917b756c0f 100644 --- a/translations/de-DE/data/reusables/code-scanning/interoperable-with-tools-that-output-sarif.md +++ b/translations/de-DE/data/reusables/code-scanning/interoperable-with-tools-that-output-sarif.md @@ -1 +1 @@ -{% data variables.product.prodname_code_scanning_capc %} ist mit Code-Scan-Werkzeugen von Drittanbietern interoperabel, welche SARIF-Daten (Static Analysis Results Interchange Format) ausgeben. SARIF ist ein Open-Source-Standard. Weitere Informationen findest Du unter „[SARIF-Ausgabe für {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning)." \ No newline at end of file +{% data variables.product.prodname_code_scanning_capc %} ist mit Code-Scan-Werkzeugen von Drittanbietern interoperabel, welche SARIF-Daten (Static Analysis Results Interchange Format) ausgeben. SARIF ist ein Open-Source-Standard. Weitere Informationen findest Du unter „[SARIF-Ausgabe für {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning)." diff --git a/translations/de-DE/data/reusables/code-scanning/run-additional-queries.md b/translations/de-DE/data/reusables/code-scanning/run-additional-queries.md index d7ba2219c3f9..324371958793 100644 --- a/translations/de-DE/data/reusables/code-scanning/run-additional-queries.md +++ b/translations/de-DE/data/reusables/code-scanning/run-additional-queries.md @@ -1,4 +1,4 @@ -When you use {% data variables.product.prodname_codeql %} to scan code, the {% data variables.product.prodname_codeql %} analysis engine generates a database from the code and runs queries on it. Weitere Informationen findest Du unter „[Über {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning#about-codeql)." +When you use {% data variables.product.prodname_codeql %} to scan code, the {% data variables.product.prodname_codeql %} analysis engine generates a database from the code and runs queries on it. Weitere Informationen findest Du unter „[ Über {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning#about-codeql)." {% data variables.product.prodname_codeql %} analysis uses a default set of queries, but you can specify more queries to run, in addition to the default queries. The queries you want to run must belong to a {% data variables.product.prodname_ql %} pack and can be in your own repository or any public repository. For more information, see "[About {% data variables.product.prodname_ql %} packs](https://help.semmle.com/codeql/codeql-cli/reference/qlpack-overview.html)." diff --git a/translations/de-DE/data/reusables/code-scanning/specify-language-to-analyze.md b/translations/de-DE/data/reusables/code-scanning/specify-language-to-analyze.md index 937acdf0ab1f..00904806ec99 100644 --- a/translations/de-DE/data/reusables/code-scanning/specify-language-to-analyze.md +++ b/translations/de-DE/data/reusables/code-scanning/specify-language-to-analyze.md @@ -1 +1 @@ -If your repository contains code in multiple languages, you can specify the languages you want to analyze. There are several reasons you might want to prevent a language being analyzed. For example, the project might have dependencies in a different language to the main body of your code, and you might prefer not to see alerts for those dependencies. +If your repository contains code in more than one of the supported languages, you can choose which languages you want to analyze. There are several reasons you might want to prevent a language being analyzed. For example, the project might have dependencies in a different language to the main body of your code, and you might prefer not to see alerts for those dependencies. diff --git a/translations/de-DE/data/reusables/codespaces/about-billing-for-codespaces.md b/translations/de-DE/data/reusables/codespaces/about-billing-for-codespaces.md new file mode 100644 index 000000000000..8a1128db5e3c --- /dev/null +++ b/translations/de-DE/data/reusables/codespaces/about-billing-for-codespaces.md @@ -0,0 +1 @@ +{% data variables.product.prodname_codespaces %} is free to use during the beta. When {% data variables.product.prodname_codespaces %} becomes generally available, you will be billed for storage and compute usage. diff --git a/translations/de-DE/data/reusables/codespaces/click-remote-explorer-icon-vscode.md b/translations/de-DE/data/reusables/codespaces/click-remote-explorer-icon-vscode.md index 7f3cc8395291..f56c11656691 100644 --- a/translations/de-DE/data/reusables/codespaces/click-remote-explorer-icon-vscode.md +++ b/translations/de-DE/data/reusables/codespaces/click-remote-explorer-icon-vscode.md @@ -1 +1 @@ -1. Klicke in der linken Seitenleiste von {% data variables.product.prodname_vscode %} auf das „Remote Explorer"-Symbol. ![Das „Remote Explorer"-Symbol in {% data variables.product.prodname_vscode %}](/assets/images/help/codespaces/click-remote-explorer-icon-vscode.png) \ No newline at end of file +1. Klicke in der linken Seitenleiste von {% data variables.product.prodname_vscode %} auf das „Remote Explorer"-Symbol. ![Das „Remote Explorer"-Symbol in {% data variables.product.prodname_vscode %}](/assets/images/help/codespaces/click-remote-explorer-icon-vscode.png) diff --git a/translations/de-DE/data/reusables/codespaces/codespaces-are-per-branch.md b/translations/de-DE/data/reusables/codespaces/codespaces-are-per-branch.md index 114af2378adc..9ba14a8df7bf 100644 --- a/translations/de-DE/data/reusables/codespaces/codespaces-are-per-branch.md +++ b/translations/de-DE/data/reusables/codespaces/codespaces-are-per-branch.md @@ -1 +1 @@ -Jeder Codespace ist mit einem spezifischen Branch eines Repositorys verbunden. \ No newline at end of file +Jeder Codespace ist mit einem spezifischen Branch eines Repositorys verbunden. diff --git a/translations/de-DE/data/reusables/codespaces/codespaces-are-personal.md b/translations/de-DE/data/reusables/codespaces/codespaces-are-personal.md index c62bb9cc1498..a9f41f0c218a 100644 --- a/translations/de-DE/data/reusables/codespaces/codespaces-are-personal.md +++ b/translations/de-DE/data/reusables/codespaces/codespaces-are-personal.md @@ -1 +1 @@ -Jeder von Dir erstellte Codespace steht nur Dir zur Verfügung. Niemand sonst kann in Deinem Codespace arbeiten. \ No newline at end of file +Jeder von Dir erstellte Codespace steht nur Dir zur Verfügung. Niemand sonst kann in Deinem Codespace arbeiten. diff --git a/translations/de-DE/data/reusables/codespaces/connect-to-codespace-from-vscode.md b/translations/de-DE/data/reusables/codespaces/connect-to-codespace-from-vscode.md index 642490e0ad66..f6f389132bf0 100644 --- a/translations/de-DE/data/reusables/codespaces/connect-to-codespace-from-vscode.md +++ b/translations/de-DE/data/reusables/codespaces/connect-to-codespace-from-vscode.md @@ -1 +1 @@ -Du kannst Dich direkt aus {% data variables.product.prodname_vscode %} mit Deinem Codespace verbinden. Weitere Informationen findest Du unter „[Aus {% data variables.product.prodname_vscode %} zu Deinem Codespace verbinden](/github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code)." \ No newline at end of file +Du kannst Dich direkt aus {% data variables.product.prodname_vscode %} mit Deinem Codespace verbinden. For more information, see "[Using Codespaces in {% data variables.product.prodname_vscode %}](/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code)." diff --git a/translations/de-DE/data/reusables/codespaces/devcontainer-location.md b/translations/de-DE/data/reusables/codespaces/devcontainer-location.md new file mode 100644 index 000000000000..196fc006be1a --- /dev/null +++ b/translations/de-DE/data/reusables/codespaces/devcontainer-location.md @@ -0,0 +1 @@ +This file can be located in the root of the repository or in a folder called `.devcontainer`. If the file is located in the root of the repository, the filename must begin with a period: `.devcontainer.json`. diff --git a/translations/de-DE/data/reusables/codespaces/navigate-to-codespaces.md b/translations/de-DE/data/reusables/codespaces/navigate-to-codespaces.md index faa113f6de37..f13ff1cd8c34 100644 --- a/translations/de-DE/data/reusables/codespaces/navigate-to-codespaces.md +++ b/translations/de-DE/data/reusables/codespaces/navigate-to-codespaces.md @@ -1 +1 @@ -1. Klicke zuoberst auf einer beliebigen Seite auf **Codespaces**. ![{% data variables.product.prodname_codespaces %}-Link in der Kopfzeile](/assets/images/help/codespaces/header-link.png) \ No newline at end of file +1. Klicke zuoberst auf einer beliebigen Seite auf **Codespaces**. ![{% data variables.product.prodname_codespaces %}-Link in der Kopfzeile](/assets/images/help/codespaces/header-link.png) diff --git a/translations/de-DE/data/reusables/codespaces/release-stage.md b/translations/de-DE/data/reusables/codespaces/release-stage.md index 1544cd6a233e..9cf4d59d9fbb 100644 --- a/translations/de-DE/data/reusables/codespaces/release-stage.md +++ b/translations/de-DE/data/reusables/codespaces/release-stage.md @@ -2,4 +2,4 @@ **Hinweis:** {% data variables.product.prodname_codespaces %} befindet sich derzeit in der eingeschränkten Beta-Phase und kann sich jederzeit verändern. Während der Beta-Phase gibt {% data variables.product.prodname_dotcom %} keine Garantie für die Verfügbarkeit von {% data variables.product.prodname_codespaces %} ab. Weitere Informationen zum Beitritt zur Beta-Phase findest Du unter „[Über {% data variables.product.prodname_codespaces %}](/github/developing-online-with-codespaces/about-codespaces#joining-the-beta)." -{% endnote %} \ No newline at end of file +{% endnote %} diff --git a/translations/de-DE/data/reusables/codespaces/unsupported-repos.md b/translations/de-DE/data/reusables/codespaces/unsupported-repos.md index 1e495c179e56..ac3f7622a29c 100644 --- a/translations/de-DE/data/reusables/codespaces/unsupported-repos.md +++ b/translations/de-DE/data/reusables/codespaces/unsupported-repos.md @@ -1 +1 @@ -Während der Beta-Phase werden private Repositorys von Organisationen oder Repositorys von Organisation, die SAML Single Sign-On verlangen, nicht unterstützt. \ No newline at end of file +Während der Beta-Phase werden private Repositorys von Organisationen oder Repositorys von Organisation, die SAML Single Sign-On verlangen, nicht unterstützt. diff --git a/translations/de-DE/data/reusables/codespaces/use-visual-studio-features.md b/translations/de-DE/data/reusables/codespaces/use-visual-studio-features.md index 9091a16bea4e..77d8f0ba9ed5 100644 --- a/translations/de-DE/data/reusables/codespaces/use-visual-studio-features.md +++ b/translations/de-DE/data/reusables/codespaces/use-visual-studio-features.md @@ -1 +1 @@ -Nachdem Du einen Codespace eröffnet hast, kannst Du mithilfe von {% data variables.product.prodname_vscode %}-Funktionen wie Textbearbeitung, Fehlersuche und Git-Befehlen weiterentwickeln. Weitere Informationen findest Du in der [{% data variables.product.prodname_vscode %}-Dokumentation](https://code.visualstudio.com/docs). +You can edit code, debug, and use Git commands while developing in a codespace with {% data variables.product.prodname_vscode %}. Weitere Informationen findest Du in der [{% data variables.product.prodname_vscode %}-Dokumentation](https://code.visualstudio.com/docs). diff --git a/translations/de-DE/data/reusables/codespaces/you-can-see-all-your-codespaces.md b/translations/de-DE/data/reusables/codespaces/you-can-see-all-your-codespaces.md index f0a0142413e6..2a19d76e201e 100644 --- a/translations/de-DE/data/reusables/codespaces/you-can-see-all-your-codespaces.md +++ b/translations/de-DE/data/reusables/codespaces/you-can-see-all-your-codespaces.md @@ -1 +1 @@ -Du kannst alle Codespaces Deines Benutzerkontos unter [github.com/codespaces](https://github.com/codespaces) sehen. \ No newline at end of file +Du kannst alle Codespaces Deines Benutzerkontos unter [github.com/codespaces](https://github.com/codespaces) sehen. diff --git a/translations/de-DE/data/reusables/command_line/git-clone-url.md b/translations/de-DE/data/reusables/command_line/git-clone-url.md index e92311e0716d..82a4de7197d2 100644 --- a/translations/de-DE/data/reusables/command_line/git-clone-url.md +++ b/translations/de-DE/data/reusables/command_line/git-clone-url.md @@ -1,4 +1,4 @@ 5. Gib `git clone` ein, und füge dann die zuvor kopierte URL ein. ```shell $ git clone https://{% data variables.command_line.codeblock %}/YOUR-USERNAME/YOUR-REPOSITORY - ``` \ No newline at end of file + ``` diff --git a/translations/de-DE/data/reusables/command_line/manipulating_file_prereqs.md b/translations/de-DE/data/reusables/command_line/manipulating_file_prereqs.md index e88227c0d4a0..b8af6c3500db 100644 --- a/translations/de-DE/data/reusables/command_line/manipulating_file_prereqs.md +++ b/translations/de-DE/data/reusables/command_line/manipulating_file_prereqs.md @@ -1,4 +1,4 @@ Bei dieser Prozedur wird vorausgesetzt, dass Du Folgendes bereits erledigt hast: - - [Du hast ein Repository auf {% data variables.product.product_name %} erstellt](/articles/creating-a-new-repository) oder Du hast ein Repository, das einer anderen Person gehört, zu dem Du beitragen möchtest + - [Sie haben ein Repository auf {% data variables.product.product_name %} erstellt](/articles/creating-a-new-repository) oder Sie haben ein Repository, das einer anderen Person gehört, zu dem Sie beitragen möchten - [Du hast das Repository lokal auf Deinem Computer geklont](/articles/cloning-a-repository) diff --git a/translations/de-DE/data/reusables/command_line/provide-an-access-token.md b/translations/de-DE/data/reusables/command_line/provide-an-access-token.md index 5499389c1a05..8dacf8a92be7 100644 --- a/translations/de-DE/data/reusables/command_line/provide-an-access-token.md +++ b/translations/de-DE/data/reusables/command_line/provide-an-access-token.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}Wenn Du auf eine Organisation zugreifst, die SAML SSO verwendet, musst Du vor Deiner Authentifizierung auch Dein persönliches Zugriffstoken für den Zugriff auf die Organisation autorisieren. Weitere Informationen findest Du unter[„Authentifizierung mit SAML Single Sign-On](/github/authenticating-to-github/about-authentication-with-saml-single-sign-on)" und[„Autorisieren eines persönlichen Zugriffstokens für die Verwendung mit SAML Single Sign-On](/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on)."{% endif %} +{% if currentVersion == "free-pro-team@latest" %}If you are accessing an organization that uses SAML SSO, you must also authorize your personal access token to access the organization before you authenticate. Weitere Informationen findest Du unter[„Authentifizierung mit SAML Single Sign-On](/github/authenticating-to-github/about-authentication-with-saml-single-sign-on)" und[„Autorisieren eines persönlichen Zugriffstokens für die Verwendung mit SAML Single Sign-On](/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on)."{% endif %} diff --git a/translations/de-DE/data/reusables/dashboard/access-org-dashboard.md b/translations/de-DE/data/reusables/dashboard/access-org-dashboard.md index 2c9292dedb34..84873e464c1a 100644 --- a/translations/de-DE/data/reusables/dashboard/access-org-dashboard.md +++ b/translations/de-DE/data/reusables/dashboard/access-org-dashboard.md @@ -1,2 +1,2 @@ -1. Klicke in der oberen linken Ecke einer beliebigen Seite unter {% data variables.product.product_name %} auf {% octicon "mark-github" aria-label="The github octocat logo" %}, um auf die Dashboard-Seite zuzugreifen. +1. Klicken Sie in der oberen linken Ecke einer beliebigen Seite unter {% data variables.product.product_name %} auf {% octicon "mark-github" aria-label="The github octocat logo" %}, um auf die Dashboard-Seite zuzugreifen. 2. Klicke in der oberen linken Ecke der Seite auf Deinen Benutzernamen, und verwende das Dropdownmenü, um auf die gewünschte Organisation zu klicken. ![Dashboard-Kontextumschalter-Dropdownmenü, in dem unterschiedliche Organisationsoptionen gezeigt werden](/assets/images/help/dashboard/dashboard-context-switcher.png) diff --git a/translations/de-DE/data/reusables/dependabot/check-in-dependabot-yml.md b/translations/de-DE/data/reusables/dependabot/check-in-dependabot-yml.md index 2502f32e583b..629a74058605 100644 --- a/translations/de-DE/data/reusables/dependabot/check-in-dependabot-yml.md +++ b/translations/de-DE/data/reusables/dependabot/check-in-dependabot-yml.md @@ -1 +1 @@ -1. Check the *dependabot.yml* configuration file in to the `.github` directory of the repository. \ No newline at end of file +1. Check the *dependabot.yml* configuration file in to the `.github` directory of the repository. diff --git a/translations/de-DE/data/reusables/dependabot/create-dependabot-yml.md b/translations/de-DE/data/reusables/dependabot/create-dependabot-yml.md index 910f3a210739..d8151637a32d 100644 --- a/translations/de-DE/data/reusables/dependabot/create-dependabot-yml.md +++ b/translations/de-DE/data/reusables/dependabot/create-dependabot-yml.md @@ -1 +1 @@ -1. Create a *dependabot.yml* configuration file. \ No newline at end of file +1. Create a *dependabot.yml* configuration file. diff --git a/translations/de-DE/data/reusables/dependabot/default-dependencies-allow-ignore.md b/translations/de-DE/data/reusables/dependabot/default-dependencies-allow-ignore.md index 0a1a6fde04f0..a229a6340d14 100644 --- a/translations/de-DE/data/reusables/dependabot/default-dependencies-allow-ignore.md +++ b/translations/de-DE/data/reusables/dependabot/default-dependencies-allow-ignore.md @@ -1 +1 @@ -By default all dependencies that are explicitly defined in a manifest or lock file are kept up to date. You can use `allow` and `ignore` to customize which dependencies to maintain with version updates. {% data variables.product.prodname_dependabot %} checks for all allowed dependencies and then filters out any ignored dependencies or versions. So a dependency that is matched by both an `allow` and an `ignore` will be ignored. \ No newline at end of file +By default all dependencies that are explicitly defined in a manifest or lock file are kept up to date. You can use `allow` and `ignore` to customize which dependencies to maintain with version updates. {% data variables.product.prodname_dependabot %} checks for all allowed dependencies and then filters out any ignored dependencies or versions. So a dependency that is matched by both an `allow` and an `ignore` will be ignored. diff --git a/translations/de-DE/data/reusables/dependabot/dependabot-tos.md b/translations/de-DE/data/reusables/dependabot/dependabot-tos.md index d52b0b03405b..a72c36c5a119 100644 --- a/translations/de-DE/data/reusables/dependabot/dependabot-tos.md +++ b/translations/de-DE/data/reusables/dependabot/dependabot-tos.md @@ -1 +1 @@ -{% data variables.product.prodname_dependabot %} and all related features are covered by [{% data variables.product.prodname_dotcom %}'s Terms of Service](/github/site-policy/github-terms-of-service). \ No newline at end of file +{% data variables.product.prodname_dependabot %} and all related features are covered by [{% data variables.product.prodname_dotcom %}'s Terms of Service](/github/site-policy/github-terms-of-service). diff --git a/translations/de-DE/data/reusables/dependabot/option-affects-security-updates.md b/translations/de-DE/data/reusables/dependabot/option-affects-security-updates.md index bb25d1b1fc5a..acf2a7655842 100644 --- a/translations/de-DE/data/reusables/dependabot/option-affects-security-updates.md +++ b/translations/de-DE/data/reusables/dependabot/option-affects-security-updates.md @@ -1 +1 @@ -Setting this option will also affect pull requests for security updates to the manifest files of this package manager, unless you use `target-branch` to check for version updates on a non-default branch. \ No newline at end of file +Setting this option will also affect pull requests for security updates to the manifest files of this package manager, unless you use `target-branch` to check for version updates on a non-default branch. diff --git a/translations/de-DE/data/reusables/dependabot/private-dependencies.md b/translations/de-DE/data/reusables/dependabot/private-dependencies.md index 1ba08ff8f048..dfcbae9c7300 100644 --- a/translations/de-DE/data/reusables/dependabot/private-dependencies.md +++ b/translations/de-DE/data/reusables/dependabot/private-dependencies.md @@ -1 +1 @@ -Currently, {% data variables.product.prodname_dependabot_version_updates %} doesn't support manifest or lock files that contain any private git dependencies or private git registries. This is because, when running version updates, {% data variables.product.prodname_dependabot_short %} must be able to resolve all dependencies from their source to verify that version updates have been successful. \ No newline at end of file +Currently, {% data variables.product.prodname_dependabot_version_updates %} doesn't support manifest or lock files that contain any private git dependencies or private git registries. This is because, when running version updates, {% data variables.product.prodname_dependabot_short %} must be able to resolve all dependencies from their source to verify that version updates have been successful. diff --git a/translations/de-DE/data/reusables/dependabot/supported-package-managers.md b/translations/de-DE/data/reusables/dependabot/supported-package-managers.md index f9cb69f91be6..48c5b661f2d2 100644 --- a/translations/de-DE/data/reusables/dependabot/supported-package-managers.md +++ b/translations/de-DE/data/reusables/dependabot/supported-package-managers.md @@ -1,15 +1,29 @@ -- Bundler: `bundler` -- Cargo: `cargo` -- Composer: `composer` -- Docker: `docker` -- Elm: `elm` -- git submodule: `gitsubmodule` -- GitHub Actions: `github-actions` -- Go modules: `gomod` -- Gradle: `gradle` -- Maven: `maven` -- Mix: `mix` -- npm: `npm` -- NuGet: `nuget` -- pip: `pip` -- Terraform: `terraform` +| Paketmanager | Supports vendoring | +| -------------------------------- |:------------------:| +| Bundler: `bundler` | **X** | +| Cargo: `cargo` | | +| Composer: `composer` | | +| Docker: `docker` | | +| Elm: `elm` | | +| git submodule: `gitsubmodule` | | +| GitHub Actions: `github-actions` | | +| Go modules: `gomod` | | +| Gradle: `gradle` | | +| Maven: `maven` | | +| Mix: `mix` | | +| npm: `npm` | | +| NuGet: `nuget` | | +| pip: `pip` | | +| Terraform: `terraform` | | + +{% note %} + +**Note**: {% data variables.product.prodname_dependabot_short %} also supports the following package managers: + +-`yarn` (v1 only) (specify `npm`) + +-`pipenv`, `pip-compile`, and `poetry` (specify `pip`) + +For example, if you use `poetry` to manage your Python dependencies and want {% data variables.product.prodname_dependabot_short %} to monitor your dependency manifest file for new versions, use `package-ecosystem: "pip"` in your *dependabot.yml* file. + +{% endnote %} diff --git a/translations/de-DE/data/reusables/desktop/choose-a-theme.md b/translations/de-DE/data/reusables/desktop/choose-a-theme.md index fcdcc21bcd79..73260972317f 100644 --- a/translations/de-DE/data/reusables/desktop/choose-a-theme.md +++ b/translations/de-DE/data/reusables/desktop/choose-a-theme.md @@ -1,2 +1,2 @@ 3. Klicke auf **Appearance** (Erscheinungsbild). -4. Klicke auf das gewünschte Design. Optional kannst Du **Automatically switch theme to match system** (Automatisch das Design dem System anpassen) wählen, wenn Du möchtest, dass {% data variables.product.prodname_desktop %} immer dem Design auf Deinem Computer entspricht. \ No newline at end of file +4. Klicke auf das gewünschte Design. Optional kannst Du **Automatically switch theme to match system** (Automatisch das Design dem System anpassen) wählen, wenn Du möchtest, dass {% data variables.product.prodname_desktop %} immer dem Design auf Deinem Computer entspricht. diff --git a/translations/de-DE/data/reusables/desktop/confirm-tag.md b/translations/de-DE/data/reusables/desktop/confirm-tag.md index 02ad11bfdfa6..279e2f4ce0f9 100644 --- a/translations/de-DE/data/reusables/desktop/confirm-tag.md +++ b/translations/de-DE/data/reusables/desktop/confirm-tag.md @@ -1 +1 @@ -1. Klicke auf **Create Tag** (Tag erstellen). \ No newline at end of file +1. Klicke auf **Create Tag** (Tag erstellen). diff --git a/translations/de-DE/data/reusables/desktop/create-tag.md b/translations/de-DE/data/reusables/desktop/create-tag.md index 927fb8e1488b..7e1c47db5871 100644 --- a/translations/de-DE/data/reusables/desktop/create-tag.md +++ b/translations/de-DE/data/reusables/desktop/create-tag.md @@ -1 +1 @@ -1. Klicke mit der rechten Maustaste auf den Commit, und klicke dann auf **Create Tag...** (Tag erstellen...). ![Wähle den Menüpunkt „create tag" (Tag erstellen)](/assets/images/help/desktop/select-create-tag.png) \ No newline at end of file +1. Klicke mit der rechten Maustaste auf den Commit, und klicke dann auf **Create Tag...** (Tag erstellen...). ![Wähle den Menüpunkt „create tag" (Tag erstellen)](/assets/images/help/desktop/select-create-tag.png) diff --git a/translations/de-DE/data/reusables/desktop/get-an-account.md b/translations/de-DE/data/reusables/desktop/get-an-account.md index 5705392fc731..f59345437bb2 100644 --- a/translations/de-DE/data/reusables/desktop/get-an-account.md +++ b/translations/de-DE/data/reusables/desktop/get-an-account.md @@ -1,4 +1,4 @@ -Du musst bereits ein {% data variables.product.prodname_dotcom %}- oder {% data variables.product.prodname_enterprise %}-Konto haben. +Sie müssen bereits ein {% data variables.product.prodname_dotcom %}- oder {% data variables.product.prodname_enterprise %}-Konto haben. - Weitere Informationen zum Erstellen eines {% data variables.product.prodname_dotcom %}-Kontos findest Du unter „[Für ein neues {% data variables.product.prodname_dotcom %}-Konto anmelden](/articles/signing-up-for-a-new-github-account/)“. - Für ein {% data variables.product.prodname_enterprise %}-Konto wendest Du Dich bitte an Deinen {% data variables.product.prodname_enterprise %}-Websiteadministrator. diff --git a/translations/de-DE/data/reusables/desktop/paste-email-git-config.md b/translations/de-DE/data/reusables/desktop/paste-email-git-config.md index e52993eca2b7..9445766bb5b9 100644 --- a/translations/de-DE/data/reusables/desktop/paste-email-git-config.md +++ b/translations/de-DE/data/reusables/desktop/paste-email-git-config.md @@ -1 +1 @@ -1. Füge im Feld **Email** (E-Mail) die E-Mail-Adresse ein, die Du aus Deinen {% data variables.product.prodname_dotcom %}- oder {% data variables.product.prodname_enterprise %}-Kontoeinstellungen kopiert hast. +1. Fügen Sie im Feld **Email** (E-Mail) die E-Mail-Adresse ein, die Sie aus Ihren {% data variables.product.prodname_dotcom %}- oder {% data variables.product.prodname_enterprise %}-Kontoeinstellungen kopiert haben. diff --git a/translations/de-DE/data/reusables/desktop/retrieve-2fa.md b/translations/de-DE/data/reusables/desktop/retrieve-2fa.md index 82bff9bc4a0a..9e1cb8a425af 100644 --- a/translations/de-DE/data/reusables/desktop/retrieve-2fa.md +++ b/translations/de-DE/data/reusables/desktop/retrieve-2fa.md @@ -1,4 +1,4 @@ -1. Gehe wie folgt vor, wenn Du die Zwei-Faktor-Authentifizierung für {% data variables.product.prodname_enterprise %} konfiguriert hast: +1. Gehen Sie wie folgt vor, wenn Sie die Zwei-Faktor-Authentifizierung für {% data variables.product.prodname_enterprise %} konfiguriert haben: - Wenn Du die Zwei-Faktor-Authentifizierung per SMS eingerichtet hast, rufst Du Deinen2FA-Code aus einer SMS ab. - Wenn Du die Zwei-Faktor-Authentifizierung mit einer TOTP-Anwendung eingerichtet hast, generierst Du einen 2FA-Code. diff --git a/translations/de-DE/data/reusables/desktop/revert-commit.md b/translations/de-DE/data/reusables/desktop/revert-commit.md index 53e9c1f4097d..43a9141db43b 100644 --- a/translations/de-DE/data/reusables/desktop/revert-commit.md +++ b/translations/de-DE/data/reusables/desktop/revert-commit.md @@ -1 +1 @@ -1. Klicke mit der rechten Maustaste auf den Commit, den Du rückgängig machen willst, und klicke dann **Revert This Commit** (Diesen Commit rückgängig machen). \ No newline at end of file +1. Klicke mit der rechten Maustaste auf den Commit, den Du rückgängig machen willst, und klicke dann **Revert This Commit** (Diesen Commit rückgängig machen). diff --git a/translations/de-DE/data/reusables/desktop/select-base-branch.md b/translations/de-DE/data/reusables/desktop/select-base-branch.md index f6f9f1e7f6ed..de87a5d1d567 100644 --- a/translations/de-DE/data/reusables/desktop/select-base-branch.md +++ b/translations/de-DE/data/reusables/desktop/select-base-branch.md @@ -1 +1 @@ -1. Wähle den aktuellen Branch oder den Standardbranch (in der Regel „Master“) aus, auf dem der neue Branch basieren soll. +1. Use the drop-down to choose a base branch for your new branch. diff --git a/translations/de-DE/data/reusables/desktop/windows_git_bash.md b/translations/de-DE/data/reusables/desktop/windows_git_bash.md index 9a381de67f28..efc7d1712d9a 100644 --- a/translations/de-DE/data/reusables/desktop/windows_git_bash.md +++ b/translations/de-DE/data/reusables/desktop/windows_git_bash.md @@ -1 +1 @@ -Wenn Du [{% data variables.product.prodname_desktop %}](https://desktop.github.com/) installiert hast, kannst Du die Lösung verwenden, um Repositorys zu klonen und um nicht mit SSH-Schlüsseln zu arbeiten. +Wenn Sie [{% data variables.product.prodname_desktop %}](https://desktop.github.com/) installiert haben, können Sie die Lösung verwenden, um Repositorys zu klonen und um nicht mit SSH-Schlüsseln zu arbeiten. diff --git a/translations/de-DE/data/reusables/developer-site/pull_request_forked_repos_link.md b/translations/de-DE/data/reusables/developer-site/pull_request_forked_repos_link.md index af68812b885b..724e3f2c494e 100644 --- a/translations/de-DE/data/reusables/developer-site/pull_request_forked_repos_link.md +++ b/translations/de-DE/data/reusables/developer-site/pull_request_forked_repos_link.md @@ -6,7 +6,7 @@ {% endnote %} -Wenn Du einen Pull Request an das Basis-Repository aus einem geforkten Repository heraus erstellst, sendet {% data variables.product.prodname_dotcom %} das Ereignis `pull_request` an das Basis-Repository, und im geforkten Repository treten keine Pull-Request-Ereignisse ein. +Wenn Sie einen Pull Request an das Basis-Repository aus einem geforkten Repository heraus erstellen, sendet {% data variables.product.prodname_dotcom %} das Ereignis `pull_request` an das Basis-Repository, und im geforkten Repository treten keine Pull-Request-Ereignisse ein. Workflows werden standardmäßig nicht für geforkte Repositorys ausgeführt. Du musst GitHub Actions auf der Registerkarte **Actions** (Aktionen) im geforkten Repository aktivieren. diff --git a/translations/de-DE/data/reusables/dotcom_billing/add-seats.md b/translations/de-DE/data/reusables/dotcom_billing/add-seats.md index 2a7011fdb341..cf16104d91ce 100644 --- a/translations/de-DE/data/reusables/dotcom_billing/add-seats.md +++ b/translations/de-DE/data/reusables/dotcom_billing/add-seats.md @@ -1 +1 @@ -1. Verwende das Dropdownmenü **Edit** (Bearbeiten) und klicke auf **Add seats** (Benutzer hinzufügen). ![Dropdownmenü „Edit" (Bearbeiten)](/assets/images/help/billing/add-seats-dropdown.png) \ No newline at end of file +1. Verwende das Dropdownmenü **Edit** (Bearbeiten) und klicke auf **Add seats** (Benutzer hinzufügen). ![Dropdownmenü „Edit" (Bearbeiten)](/assets/images/help/billing/add-seats-dropdown.png) diff --git a/translations/de-DE/data/reusables/dotcom_billing/confirm-add-seats.md b/translations/de-DE/data/reusables/dotcom_billing/confirm-add-seats.md index b164024f09fa..0e75020ea65b 100644 --- a/translations/de-DE/data/reusables/dotcom_billing/confirm-add-seats.md +++ b/translations/de-DE/data/reusables/dotcom_billing/confirm-add-seats.md @@ -1 +1 @@ -1. Klicke auf **Add seats** (Benutzer hinzufügen). ![Add seats button](/assets/images/help/billing/add-seats-button.png) \ No newline at end of file +1. Klicke auf **Add seats** (Benutzer hinzufügen). ![Add seats button](/assets/images/help/billing/add-seats-button.png) diff --git a/translations/de-DE/data/reusables/dotcom_billing/lfs-add-data.md b/translations/de-DE/data/reusables/dotcom_billing/lfs-add-data.md index 7f59db68c0ae..7b3c015e967e 100644 --- a/translations/de-DE/data/reusables/dotcom_billing/lfs-add-data.md +++ b/translations/de-DE/data/reusables/dotcom_billing/lfs-add-data.md @@ -1 +1 @@ -1. Klicke neben „{% data variables.large_files.product_name_short %} Data“ ({% data variables.large_files.product_name_short %}-Daten) auf **Add more data** (Mehr Daten hinzufügen), oder verwende das Dropdownmenü „Edit“ (Bearbeiten), und klicke auf **Add more data packs** (Mehr Datenpakete hinzufügen). ![Schaltfläche „Add more data" (Hinzufügen weiterer Daten)](/assets/images/help/billing/data-pack-purchase-more.png) +1. Klicken Sie neben „{% data variables.large_files.product_name_short %} Data“ ({% data variables.large_files.product_name_short %}-Daten) auf **Add more data** (Mehr Daten hinzufügen), oder verwenden Sie das Dropdownmenü „Edit“ (Bearbeiten), und klicken Sie auf **Add more data packs** (Mehr Datenpakete hinzufügen). ![Schaltfläche „Add more data" (Hinzufügen weiterer Daten)](/assets/images/help/billing/data-pack-purchase-more.png) diff --git a/translations/de-DE/data/reusables/dotcom_billing/number-of-seats.md b/translations/de-DE/data/reusables/dotcom_billing/number-of-seats.md index d949a46eee5a..8f9f8bb07850 100644 --- a/translations/de-DE/data/reusables/dotcom_billing/number-of-seats.md +++ b/translations/de-DE/data/reusables/dotcom_billing/number-of-seats.md @@ -1 +1 @@ -1. Geben Sie unter „Add seats“ (Benutzer hinzufügen) die Anzahl der gewünschten Benutzer ein, die hinzugefügt werden soll. ![Add seats input](/assets/images/help/billing/add-seats-amount.png) \ No newline at end of file +1. Geben Sie unter „Add seats“ (Benutzer hinzufügen) die Anzahl der gewünschten Benutzer ein, die hinzugefügt werden soll. ![Add seats input](/assets/images/help/billing/add-seats-amount.png) diff --git a/translations/de-DE/data/reusables/dotcom_billing/upgrade_org.md b/translations/de-DE/data/reusables/dotcom_billing/upgrade_org.md index a677b43be756..2050a05ba4e7 100644 --- a/translations/de-DE/data/reusables/dotcom_billing/upgrade_org.md +++ b/translations/de-DE/data/reusables/dotcom_billing/upgrade_org.md @@ -1 +1 @@ -1. Wenn Du ein Upgrade von {% data variables.product.prodname_free_team %} machst, klicke **Upgrade options** (Upgrade Optionen). Wenn Du ein Upgrade von {% data variables.product.prodname_team %} machst, verwende die **Edit** (Bearbeiten) Dropdownmenü und klicke auf **Upgrade** (Aktualisieren). ![Schaltfläche „Upgrade options" (Upgrade-Optionen)](/assets/images/help/billing/choose-monthly-or-yearly-billing.png) \ No newline at end of file +1. Wenn Du ein Upgrade von {% data variables.product.prodname_free_team %} machst, klicke **Upgrade options** (Upgrade Optionen). Wenn Du ein Upgrade von {% data variables.product.prodname_team %} machst, verwende die **Edit** (Bearbeiten) Dropdownmenü und klicke auf **Upgrade** (Aktualisieren). ![Schaltfläche „Upgrade options" (Upgrade-Optionen)](/assets/images/help/billing/choose-monthly-or-yearly-billing.png) diff --git a/translations/de-DE/data/reusables/education/about-github-education-link.md b/translations/de-DE/data/reusables/education/about-github-education-link.md index 818713069ba2..ef5133da411b 100644 --- a/translations/de-DE/data/reusables/education/about-github-education-link.md +++ b/translations/de-DE/data/reusables/education/about-github-education-link.md @@ -1 +1 @@ -Bevor Du einen individuellen Rabatt anwendest, solltest Du überprüfen, ob Deine Lerngemeinschaft bereits mit uns als {% data variables.product.prodname_education %}-Bildungseinrichtung zusammenarbeitet. Weitere Informationen findest Du unter „[Informationen zu {% data variables.product.prodname_education %}](https://education.github.com/partners/schools)“. +Bevor Sie einen individuellen Rabatt anwenden, sollten Sie überprüfen, ob Ihre Lerngemeinschaft bereits mit uns als {% data variables.product.prodname_education %}-Bildungseinrichtung zusammenarbeitet. Weitere Informationen findest Du unter „[Informationen zu {% data variables.product.prodname_education %}](https://education.github.com/partners/schools)“. diff --git a/translations/de-DE/data/reusables/education/apply-for-team.md b/translations/de-DE/data/reusables/education/apply-for-team.md index e8c4c2511a98..d3fecd2cda45 100644 --- a/translations/de-DE/data/reusables/education/apply-for-team.md +++ b/translations/de-DE/data/reusables/education/apply-for-team.md @@ -1 +1 @@ -- Melde Dich für kostenlose [{% data variables.product.prodname_team %}](/articles/github-s-products) an, was unbegrenzte Benutzer- und private Repositorys ermöglicht. Weitere Informationen findest Du unter „[Einen Lehrer- oder Forscherrabatt beantragen](/articles/applying-for-an-educator-or-researcher-discount).“ +- Melden Sie sich kostenlos für[{% data variables.product.prodname_team %}](/articles/github-s-products) an, was unbegrenzte Benutzer- und private Repositorys ermöglicht. Weitere Informationen findest Du unter „[Einen Lehrer- oder Forscherrabatt beantragen](/articles/applying-for-an-educator-or-researcher-discount).“ diff --git a/translations/de-DE/data/reusables/education/benefits-page.md b/translations/de-DE/data/reusables/education/benefits-page.md index 231e91a84be7..6848da21e87a 100644 --- a/translations/de-DE/data/reusables/education/benefits-page.md +++ b/translations/de-DE/data/reusables/education/benefits-page.md @@ -1 +1 @@ -1. Navigiere zu [{% data variables.product.prodname_education %}](https://education.github.com), und klicke oben rechts auf **Get benefits** (Vorteile nutzen). +1. Navigieren Sie zu [{% data variables.product.prodname_education %}](https://education.github.com), und klicken Sie oben rechts auf **Get benefits** (Vorteile nutzen). diff --git a/translations/de-DE/data/reusables/education/plan-to-use-github.md b/translations/de-DE/data/reusables/education/plan-to-use-github.md index 67e5a8128808..c39d5ac705ab 100644 --- a/translations/de-DE/data/reusables/education/plan-to-use-github.md +++ b/translations/de-DE/data/reusables/education/plan-to-use-github.md @@ -1 +1 @@ -1. Beschreibe, wie Du {% data variables.product.prodname_dotcom %} verwenden möchtest. ![Feld „Description“ (Beschreibung) zur Angabe, wie Du {% data variables.product.prodname_dotcom %} verwenden möchtest](/assets/images/help/education/purpose-for-github-education.png) +1. Beschreiben Sie, wie Sie {% data variables.product.prodname_dotcom %} verwenden möchten. ![Feld „Description“ (Beschreibung) zur Angabe, wie Sie {% data variables.product.prodname_dotcom %} verwenden möchten](/assets/images/help/education/purpose-for-github-education.png) diff --git a/translations/de-DE/data/reusables/enterprise-accounts/access-enterprise.md b/translations/de-DE/data/reusables/enterprise-accounts/access-enterprise.md index ef3dedf19fa5..2a7bee222c99 100644 --- a/translations/de-DE/data/reusables/enterprise-accounts/access-enterprise.md +++ b/translations/de-DE/data/reusables/enterprise-accounts/access-enterprise.md @@ -1 +1,3 @@ -1. Navigiere zu Deinem Enterprise-Konto. Besuche dazu `https://github.com/enterprises/UNTERNEHMENSNAME`, und ersetze `UNTERNEHMENSNAME` durch den Namen Deines Enterprise-Kontos. +1. In the top-right corner of {% data variables.product.product_name %}, click your profile photo, then click **Your enterprises**. !["Your enterprises" in drop-down menu for profile photo on GitHub](/assets/images/help/enterprises/your-enterprises.png) + +1. In the list of enterprises, click the enterprise you want to view. ![Name of an enterprise in list of your enterprises](/assets/images/help/enterprises/your-enterprises-list.png) diff --git a/translations/de-DE/data/reusables/enterprise-accounts/github-connect-tab.md b/translations/de-DE/data/reusables/enterprise-accounts/github-connect-tab.md index acbfb95bada7..767b4f024995 100644 --- a/translations/de-DE/data/reusables/enterprise-accounts/github-connect-tab.md +++ b/translations/de-DE/data/reusables/enterprise-accounts/github-connect-tab.md @@ -1 +1 @@ -1. Klicke auf der linken Seitenleiste auf **{% data variables.product.prodname_github_connect %}**. ![Registerkarte „GitHub Connect“ (GitHub-Verbindung) auf der Seitenleiste mit den Einstellungen des Geschäftskontos](/assets/images/enterprise/business-accounts/settings-github-connect-tab.png) +1. Klicken Sie auf der linken Seitenleiste auf **{% data variables.product.prodname_github_connect %}**. ![Registerkarte „GitHub Connect“ (GitHub-Verbindung) auf der Seitenleiste mit den Einstellungen des Geschäftskontos](/assets/images/enterprise/business-accounts/settings-github-connect-tab.png) diff --git a/translations/de-DE/data/reusables/enterprise/rate_limit.md b/translations/de-DE/data/reusables/enterprise/rate_limit.md index dd52413e463c..ddf01e8d889f 100644 --- a/translations/de-DE/data/reusables/enterprise/rate_limit.md +++ b/translations/de-DE/data/reusables/enterprise/rate_limit.md @@ -1,3 +1,4 @@ {% if currentVersion != "free-pro-team@latest" %} -Note that the limits mentioned above are the default rate limits for a {% data variables.product.prodname_ghe_server %} instance. Contact your site administrator to confirm if rate limits are enabled and how they are configured. +Note that the limits mentioned above are the default rate limits for a +{% data variables.product.prodname_ghe_server %} instance. Contact your site administrator to confirm if rate limits are enabled and how they are configured. {% endif %} diff --git a/translations/de-DE/data/reusables/enterprise_clustering/configuration-file-heading.md b/translations/de-DE/data/reusables/enterprise_clustering/configuration-file-heading.md index 06b1491d9115..9617fb94121d 100644 --- a/translations/de-DE/data/reusables/enterprise_clustering/configuration-file-heading.md +++ b/translations/de-DE/data/reusables/enterprise_clustering/configuration-file-heading.md @@ -1 +1 @@ -The cluster configuration file lists each node under a [cluster "HOSTNAME"] heading. \ No newline at end of file +The cluster configuration file lists each node under a [cluster "HOSTNAME"] heading. diff --git a/translations/de-DE/data/reusables/enterprise_clustering/replacing-a-cluster-node-provision.md b/translations/de-DE/data/reusables/enterprise_clustering/replacing-a-cluster-node-provision.md index 648693063aa2..3b58425c59be 100644 --- a/translations/de-DE/data/reusables/enterprise_clustering/replacing-a-cluster-node-provision.md +++ b/translations/de-DE/data/reusables/enterprise_clustering/replacing-a-cluster-node-provision.md @@ -1 +1 @@ -1. [Verteile und installiere {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-github-enterprise-server-instance) mit einem eindeutigen Hostnamen auf dem Ersatzknoten. +1. [Verteilen und installieren Sie {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-github-enterprise-server-instance) mit einem eindeutigen Hostnamen auf dem Ersatzknoten. diff --git a/translations/de-DE/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md b/translations/de-DE/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md index e86282e43be6..906c2b24edfe 100644 --- a/translations/de-DE/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md +++ b/translations/de-DE/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md @@ -1,6 +1,6 @@ -1. Wenn Du den MySQL-Masterknoten oder den Redis-Masterknoten ersetzt, ersetze in der Datei `cluster.conf` den Wert `mysql-master` oder `redis-master` durch den Namen des Ersatzknotens. +1. If you're replacing the primary MySQL or Redis node, in `cluster.conf`, modify the `mysql-master` or `redis-master` value with the replacement node name. - So gibt beispielsweise diese geänderte Datei `cluster.conf` den neu verteilten Clusterknoten `ghe-replacement-data-node-1` als MySQL- und Redis-Masterknoten an: 
    +  For example, this modified `cluster.conf` file specifies a newly provisioned cluster node, `ghe-replacement-data-node-1` as the primary MySQL and Redis node: 
       mysql-master = ghe-replacement-data-node-1
   redis-master = ghe-replacement-data-node-1
   
    
diff --git a/translations/de-DE/data/reusables/enterprise_enterprise_support/installing-releases.md b/translations/de-DE/data/reusables/enterprise_enterprise_support/installing-releases.md
index 136d2d07138b..e5ece3fd5388 100644
--- a/translations/de-DE/data/reusables/enterprise_enterprise_support/installing-releases.md
+++ b/translations/de-DE/data/reusables/enterprise_enterprise_support/installing-releases.md
@@ -1,3 +1,3 @@
 ### {% data variables.product.prodname_ghe_server %}-Releases installieren
 
-Um sicherzustellen, dass {% data variables.product.product_location_enterprise %} stabil ist, musst Du {% data variables.product.prodname_ghe_server %}-Releases installieren und implementieren. Die Installation von {% data variables.product.prodname_ghe_server %}-Releases stellt sicher, dass Du über die neuesten Features, Änderungen und Verbesserungen sowie über alle Updates von Features, Codekorrekturen, Patches oder andere allgemeine Updates und Korrekturen von {% data variables.product.prodname_ghe_server %} verfügst.
+Um sicherzustellen, dass {% data variables.product.product_location_enterprise %} stabil ist, musst Du {% data variables.product.prodname_ghe_server %}-Releases installieren und implementieren. Die Installation von {% data variables.product.prodname_ghe_server %}-Versionen stellt sicher, dass Sie über die neuesten Features, Änderungen und Verbesserungen sowie über alle Updates von Features, Codekorrekturen, Patches oder andere allgemeine Updates und Korrekturen von {% data variables.product.prodname_ghe_server %} verfügen.
diff --git a/translations/de-DE/data/reusables/enterprise_enterprise_support/submit-support-ticket-first-section.md b/translations/de-DE/data/reusables/enterprise_enterprise_support/submit-support-ticket-first-section.md
index f5f1bdae46e6..0c54f101dab9 100644
--- a/translations/de-DE/data/reusables/enterprise_enterprise_support/submit-support-ticket-first-section.md
+++ b/translations/de-DE/data/reusables/enterprise_enterprise_support/submit-support-ticket-first-section.md
@@ -4,13 +4,15 @@
     - Schritte zum Reproduzieren des Issue
     - Besondere Umstände, die zum Zeitpunkt des Problems bzw. dessen Auftreten vorlagen (z. B. das erste Auftreten, Auftreten nach einem bestimmten Ereignis, Häufigkeit des Auftretens, Auswirkung des Problems auf das Geschäft und Dringlichkeit einer Lösung)
     - Der genaue Wortlaut von Fehlermeldungen
-1. Wähle aus dem {% data variables.product.prodname_enterprise %}-Produkte-Dropdownmenü die Option {% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_ghe_cloud %}{% else %}{% data variables.product.prodname_ghe_server %}{% endif %}. ![Dropdownmenü „Priority“ (Priorität)](/assets/images/enterprise/support/support-ticket-ghe-product.png)
-1. Wähle im Dropdownmenü „Priority“ (Priorität) die entsprechende Dringlichkeit aus. Weitere Informationen findest Du unter „[Einem Support-Ticket eine Priorität zuweisen]{% if currentVersion == "free-pro-team@latest" %}(/articles/about-github-premium-support-for-github-enterprise-cloud#assigning-a-priority-to-a-support-ticket){% else %}(/enterprise/admin/guides/enterprise-support/about-github-enterprise-support#assigning-a-priority-to-a-support-ticket){% endif %}." ![Dropdownmenü „Priority“ (Priorität)](/assets/images/enterprise/support/support-ticket-priority.png)
-    - Wähle **{% data variables.product.support_ticket_priority_urgent %}** um {% if currentVersion == "free-pro-team@latest" %}kritische Systemfehler{% else %}schwerwiegende Systemfehler, Ausfälle mit Auswirkungen auf kritische Systemvorgänge, Sicherheitsvorfälle und abgelaufene Lizenzen{% endif %} zu melden.
-    - Wähle **{% data variables.product.support_ticket_priority_high %}** um Probleme zu melden, die sich auf den Geschäftsbetrieb auswirken, einschließlich {% if currentVersion == "free-pro-team@latest" %}entfernen vertraulicher Daten (Commits, Probleme, Pull Requests, hochgeladene Anlagen) aus Deinen eigenen Konten und Organisations-Wiederherstellungen{% else %}Probleme mit der Systemleistung{% endif %}, oder um kritische Fehler zu melden.
-    - Wähle **{% data variables.product.support_ticket_priority_normal %}** um {% if currentVersion == "free-pro-team@latest" %}Kontowiederherstellung oder Spam-Kennzeichnung entfernen anzufordern, Benutzeranmeldungsprobleme zu melden{% else %}technische Anforderungen wie Konfigurationsänderungen und Integration von Drittanbietern zu stellen{% endif %}, und um nicht kritische Fehler zu melden.
-    - Wähle **{% data variables.product.support_ticket_priority_low %}** um allgemeine Fragen zu stellen und um Anfragen für neue Funktionen, Käufe, Ausbildung oder Systemdiagnosen einzureichen.{% if currentVersion != "free-pro-team@latest" %}
-1. Wähle im Dropdownmenü „{% data variables.product.prodname_enterprise %}-Series" die Version des {% data variables.product.prodname_ghe_server %}, die Du benutzt. ![Dropdownmenü „{% data variables.product.prodname_enterprise %} Series“ ({% data variables.product.prodname_enterprise %}-Serie)](/assets/images/enterprise/support/support-ticket-ghes-series.png)
+1. From the {% data variables.product.prodname_enterprise %} Product drop-down menu, select {% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_ghe_cloud %}{% else %}{% data variables.product.prodname_ghe_server %}{% endif %}. ![Dropdownmenü „Priority“ (Priorität)](/assets/images/enterprise/support/support-ticket-ghe-product.png)
+1. Wähle im Dropdownmenü „Priority“ (Priorität) die entsprechende Dringlichkeit aus. For more information, see "[Assigning a priority to a support ticket]{% if currentVersion == "free-pro-team@latest" %}(/articles/about-github-premium-support-for-github-enterprise-cloud#assigning-a-priority-to-a-support-ticket){% else %}(/enterprise/admin/guides/enterprise-support/about-github-enterprise-support#assigning-a-priority-to-a-support-ticket){% endif %}." ![Dropdownmenü „Priority“ (Priorität)](/assets/images/enterprise/support/support-ticket-priority.png)
+    - Choose **{% data variables.product.support_ticket_priority_urgent %}** to report {% if currentVersion == "free-pro-team@latest" %}critical system failure{% else %}fatal system failures, outages impacting critical system operations, security incidents, and expired licenses{% endif %}.
+    - Choose **{% data variables.product.support_ticket_priority_high %}** to report issues impacting business operations, including {% if currentVersion == "free-pro-team@latest" %}removing sensitive data (commits, issues, pull requests, uploaded attachments) from your own accounts and organization restorations{% else %}system performance issues{% endif %}, or to report critical bugs.
+    - Choose **{% data variables.product.support_ticket_priority_normal %}** to {% if currentVersion == "free-pro-team@latest" %}request account recovery or spam unflagging, report user login issues{% else %}make technical requests like configuration changes and third-party integrations{% endif %}, and to report non-critical bugs.
+    - Choose **{% data variables.product.support_ticket_priority_low %}** to ask general questions and submit requests for new features, purchases, training, or health checks.{% if currentVersion != "free-pro-team@latest" %}
+1. From the "
+{% data variables.product.prodname_enterprise %} Series" drop-down menu, select the version of {% data variables.product.prodname_ghe_server %} you're using.
+  ![Dropdownmenü „{% data variables.product.prodname_enterprise %} Series“ ({% data variables.product.prodname_enterprise %}-Serie)](/assets/images/enterprise/support/support-ticket-ghes-series.png)
 {% endif %}
 1. Wähle im Dropdownmenü „Global Region“ (Globale Region) Deine Region aus: APAC (Asien-Pazifik), EMEA (Europa, Naher Osten und Afrika) oder Americas (Nord- und Südamerika). ![Dropdownmenü „Global Region“ (Globale Region)](/assets/images/enterprise/support/support-ticket-global-region.png)
 1. Klicke auf **Add file** (Datei hinzufügen) und füge die heruntergeladene Diagnose-Datei hinzu, um die Diagnoseinformationen Deinem Support-Ticket beizufügen. ![Schaltfläche „Add file“ (Datei hinzufügen)](/assets/images/enterprise/support/support-ticket-add-file.png)
diff --git a/translations/de-DE/data/reusables/enterprise_enterprise_support/submit-support-ticket-second-section.md b/translations/de-DE/data/reusables/enterprise_enterprise_support/submit-support-ticket-second-section.md
index 203b972b9f5b..81f2575d813f 100644
--- a/translations/de-DE/data/reusables/enterprise_enterprise_support/submit-support-ticket-second-section.md
+++ b/translations/de-DE/data/reusables/enterprise_enterprise_support/submit-support-ticket-second-section.md
@@ -1,4 +1,5 @@
 1. Klicke auf **Submit** (Einreichen).
 
 {% if currentVersion != "free-pro-team@latest" %}
-Wenn in Deinem Supportticket keine Diagnosen enthalten sein sollen, kannst Du Deine Diagnoseinformationen nach dem Absenden Deiner Supportanforderung für den {% data variables.product.prodname_enterprise %}-Support freigeben. Weitere Informationen findest Du unter „[Daten für den {% data variables.product.prodname_dotcom %}-Support bereitstellen](/enterprise/admin/guides/enterprise-support/providing-data-to-github-support)“.{% endif %}
+If you chose not to include diagnostics with your support ticket, you can share diagnostic information with
+{% data variables.product.prodname_enterprise %} Support after submitting your support request. Weitere Informationen findest Du unter „[Daten für den {% data variables.product.prodname_dotcom %}-Support bereitstellen](/enterprise/admin/guides/enterprise-support/providing-data-to-github-support)“.{% endif %}
diff --git a/translations/de-DE/data/reusables/enterprise_enterprise_support/use_ghe_cluster_support_bundle.md b/translations/de-DE/data/reusables/enterprise_enterprise_support/use_ghe_cluster_support_bundle.md
index f231f61d950d..7df23b1132f4 100644
--- a/translations/de-DE/data/reusables/enterprise_enterprise_support/use_ghe_cluster_support_bundle.md
+++ b/translations/de-DE/data/reusables/enterprise_enterprise_support/use_ghe_cluster_support_bundle.md
@@ -1,5 +1,5 @@
 {% note %}
 
-**Hinweis:** Wenn Du eine Geo-Replikationskonfiguration oder {% data variables.product.prodname_enterprise %} Clustering verwendest, solltest Du das Support-Bundle mit dem Befehl `ghe-cluster-support-bundle` abrufen. Weitere Informationen findest Du unter „[Befehlszeilendienstprogramme](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#ghe-cluster-support-bundle)“.
+**Hinweis:** Wenn Sie eine Geo-Replikationskonfiguration oder {% data variables.product.prodname_enterprise %} Clustering verwenden, sollten Sie das Support-Bundle mit dem Befehl `ghe-cluster-support-bundle` abrufen. Weitere Informationen findest Du unter „[Befehlszeilendienstprogramme](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#ghe-cluster-support-bundle)“.
 
 {% endnote %}
diff --git a/translations/de-DE/data/reusables/enterprise_installation/aws-supported-instance-types.md b/translations/de-DE/data/reusables/enterprise_installation/aws-supported-instance-types.md
index 32c3043601bf..465a9f2940c4 100644
--- a/translations/de-DE/data/reusables/enterprise_installation/aws-supported-instance-types.md
+++ b/translations/de-DE/data/reusables/enterprise_installation/aws-supported-instance-types.md
@@ -28,10 +28,9 @@
 | ---------------- | -------------------------------------------------------------------- |
 | R4               | r4.large, r4.xlarge, r4.2xlarge, r4.4xlarge, r4.8xlarge, r4.16xlarge |
 
-| EC2-Instance-Typ | Modell                                                                |
-| ---------------- | --------------------------------------------------------------------- |
-| R5               | r5.large, r5.xlarge, r5.2xlarge, r5.4xlarge, r5.12xlarge, r5.24xlarge |
-
+| EC2-Instance-Typ | Modell                                                                                                                                                                                                                                                                                                                                         |
+| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| R5               | r5.large, r5.xlarge, r5.2xlarge, r5.4xlarge, r5.12xlarge, r5.24xlarge{% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.19" %}, r5n.large, r5n.xlarge, r5n.2xlarge, r5n.4xlarge, r5n.12xlarge, r5n.24xlarge, r5a.large, r5a.xlarge, r5a.2xlarge, r5a.4xlarge, r5a.12xlarge, r5a.24xlarge{% endif %}
 
 | EC2-Instance-Typ | Modell                   |
 | ---------------- | ------------------------ |
diff --git a/translations/de-DE/data/reusables/enterprise_installation/download-appliance.md b/translations/de-DE/data/reusables/enterprise_installation/download-appliance.md
index ea5035c21a7e..f8a5f717ee97 100644
--- a/translations/de-DE/data/reusables/enterprise_installation/download-appliance.md
+++ b/translations/de-DE/data/reusables/enterprise_installation/download-appliance.md
@@ -1 +1 @@
-1. Klicke auf **Get the latest release of {% data variables.product.prodname_ghe_server %}** (Neuesten Release abrufen).
+1. Klicken Sie auf **Get the latest release of {% data variables.product.prodname_ghe_server %}** (Neueste Version von {% data variables.product.prodname_ghe_server %} abrufen).
diff --git a/translations/de-DE/data/reusables/enterprise_installation/download-package.md b/translations/de-DE/data/reusables/enterprise_installation/download-package.md
index 48147a0de5f6..0c5e31c5a076 100644
--- a/translations/de-DE/data/reusables/enterprise_installation/download-package.md
+++ b/translations/de-DE/data/reusables/enterprise_installation/download-package.md
@@ -1,4 +1,4 @@
-1. Lade das Upgrade-Paket mit `curl` auf {% data variables.product.product_location_enterprise %} herunter:
+1. Laden Sie das Upgrade-Paket mit `curl` auf {% data variables.product.product_location_enterprise %} herunter:
 ```shell
 admin@HOSTNAME:~$ curl -L -O UPGRADE-PKG-URL
 ```
diff --git a/translations/de-DE/data/reusables/enterprise_installation/enterprise-download-procedural.md b/translations/de-DE/data/reusables/enterprise_installation/enterprise-download-procedural.md
index bc1580885896..14fdfe8db680 100644
--- a/translations/de-DE/data/reusables/enterprise_installation/enterprise-download-procedural.md
+++ b/translations/de-DE/data/reusables/enterprise_installation/enterprise-download-procedural.md
@@ -1 +1 @@
-1. Navigiere zur [{% data variables.product.prodname_ghe_server %}-Downloadseite](https://enterprise.github.com/download).
+1. Navigieren Sie zur [{% data variables.product.prodname_ghe_server %}-Downloadseite](https://enterprise.github.com/download).
diff --git a/translations/de-DE/data/reusables/enterprise_installation/enterprise-download-upgrade-pkg.md b/translations/de-DE/data/reusables/enterprise_installation/enterprise-download-upgrade-pkg.md
index acebb341d703..683153c37fe1 100644
--- a/translations/de-DE/data/reusables/enterprise_installation/enterprise-download-upgrade-pkg.md
+++ b/translations/de-DE/data/reusables/enterprise_installation/enterprise-download-upgrade-pkg.md
@@ -1 +1 @@
-Navigiere zur Seite [{% data variables.product.prodname_ghe_server %}-Releases](https://enterprise.github.com/releases). Klicke neben dem Release, auf den Du ein Upgrade durchführst, auf **Download**, und klicke dann auf die Registerkarte **Upgrading** (Aktualisieren).
+Navigieren Sie zur Seite [{% data variables.product.prodname_ghe_server %}-Veröffentlichungen](https://enterprise.github.com/releases). Klicke neben dem Release, auf den Du ein Upgrade durchführst, auf **Download**, und klicke dann auf die Registerkarte **Upgrading** (Aktualisieren).
diff --git a/translations/de-DE/data/reusables/enterprise_installation/hardware-rec-table.md b/translations/de-DE/data/reusables/enterprise_installation/hardware-rec-table.md
index 50caa47bc4f3..82cc36e9c90c 100644
--- a/translations/de-DE/data/reusables/enterprise_installation/hardware-rec-table.md
+++ b/translations/de-DE/data/reusables/enterprise_installation/hardware-rec-table.md
@@ -1,13 +1,13 @@
 {% if currentVersion == "enterprise-server@2.22" %}
 
 Minimum requirements for an instance with beta features enabled are **bold** in the following table. For more information, see "[Beta features in {% data variables.product.prodname_ghe_server %} 2.22](#beta-features-in-github-enterprise-server-222)." |{% endif %}
-| Benutzerlizenzen                                           |                                                                                                              vCPUs |                                                                                                            Arbeitsspeicher |                                                                                                           Attached-Storage | Root-Storage |
-|:---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------:| --------------------------------------------------------------------------------------------------------------------------:| --------------------------------------------------------------------------------------------------------------------------:| ------------:|
+| Benutzerlizenzen                                           |                                                                                                                                  vCPUs |                                                                                                                                Arbeitsspeicher |                                                                                                                               Attached-Storage | Root-Storage |
+|:---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------:| ------------:|
 | Test, Demo oder 10 Benutzer mit eingeschränkten Funktionen |   2{% if currentVersion == "enterprise-server@2.22" %}
    or [**4**](#beta-features-in-github-enterprise-server-222){% endif %} |   16 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**32 GB**](#beta-features-in-github-enterprise-server-222){% endif %} | 100 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**150 GB**](#beta-features-in-github-enterprise-server-222){% endif %} |       200 GB |
 | 10–3000                                                    |   4{% if currentVersion == "enterprise-server@2.22" %}
    or [**8**](#beta-features-in-github-enterprise-server-222){% endif %} |   32 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**48 GB**](#beta-features-in-github-enterprise-server-222){% endif %} | 250 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**300 GB**](#beta-features-in-github-enterprise-server-222){% endif %} |       200 GB |
-| 3000–5000                                                  |  8{% if currentVersion == "enterprise-server@2.22" %}
    or [**12**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                      64 GB |                                                                                                                     500 GB |       200 GB |
-| 5000–8000                                                  | 12{% if currentVersion == "enterprise-server@2.22" %}
    or [**16**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                      96 GB |                                                                                                                     750 GB |       200 GB |
-| 8000–10000+                                                | 16{% if currentVersion == "enterprise-server@2.22" %}
    or [**20**](#beta-features-in-github-enterprise-server-222){% endif %} | 128 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**160 GB**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                    1000 GB |       200 GB |
+| 3000–5000                                                  |  8{% if currentVersion == "enterprise-server@2.22" %}
    or [**12**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                                          64 GB |                                                                                                                                         500 GB |       200 GB |
+| 5000–8000                                                  | 12{% if currentVersion == "enterprise-server@2.22" %}
    or [**16**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                                          96 GB |                                                                                                                                         750 GB |       200 GB |
+| 8000–10000+                                                | 16{% if currentVersion == "enterprise-server@2.22" %}
    or [**20**](#beta-features-in-github-enterprise-server-222){% endif %} | 128 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**160 GB**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                                        1000 GB |       200 GB |
 
 {% if currentVersion == "enterprise-server@2.22" %}
 
diff --git a/translations/de-DE/data/reusables/enterprise_installation/hotpatching-explanation.md b/translations/de-DE/data/reusables/enterprise_installation/hotpatching-explanation.md
index 5c3282cf95dd..008af77ee2a0 100644
--- a/translations/de-DE/data/reusables/enterprise_installation/hotpatching-explanation.md
+++ b/translations/de-DE/data/reusables/enterprise_installation/hotpatching-explanation.md
@@ -1 +1 @@
-Du kannst ein Upgrade von {% data variables.product.prodname_ghe_server %} auf den neuesten Patch-Release durchführen. verwende dazu einen Hotpatch, für den kein Wartungsfenster und in der Regel kein Neustart erforderlich ist. Mittels Hotpatching kannst Du ein Upgrade auf einen neueren Patch-Release durchführen, jedoch keine Feature-Veröffentlichung. So kannst Du beispielsweise ein Upgrade von `2.10.1` auf `2.10.5` durchführen, da sie sich in derselben Featureserie befinden, jedoch nicht von `2.10.9` auf `2.11.0`, da sie sich in unterschiedlichen Featureserien befinden.
+Sie können ein Upgrade von {% data variables.product.prodname_ghe_server %} auf die neueste Patch-Version durchführen. Verwenden Sie dazu einen Hotpatch, für den kein Wartungsfenster und in der Regel kein Neustart erforderlich ist. Mittels Hotpatching kannst Du ein Upgrade auf einen neueren Patch-Release durchführen, jedoch keine Feature-Veröffentlichung. So kannst Du beispielsweise ein Upgrade von `2.10.1` auf `2.10.5` durchführen, da sie sich in derselben Featureserie befinden, jedoch nicht von `2.10.9` auf `2.11.0`, da sie sich in unterschiedlichen Featureserien befinden.
diff --git a/translations/de-DE/data/reusables/enterprise_installation/monitoring-replicas.md b/translations/de-DE/data/reusables/enterprise_installation/monitoring-replicas.md
index 5dde1d3dfa60..5eefd987bc1e 100644
--- a/translations/de-DE/data/reusables/enterprise_installation/monitoring-replicas.md
+++ b/translations/de-DE/data/reusables/enterprise_installation/monitoring-replicas.md
@@ -1,4 +1,4 @@
-Du kannst die Verfügbarkeit von {% data variables.product.prodname_ghe_server %} überwachen, indem Du den für die URL `https://HOSTNAME/status` zurückgegebenen Statuscode überprüfst. Eine Appliance, die den Benutzer-Traffic verarbeiten kann, gibt den Statuscode `200` (OK) zurück. Es gibt einige Ursachen, weshalb eine Appliance den Statuscode `503` (Service Unavailable (Dienst nicht verfügbar)) zurückgibt:
+Sie können die Verfügbarkeit von {% data variables.product.prodname_ghe_server %} überwachen, indem Sie den für die URL `https://HOSTNAME/status` zurückgegebenen Statuscode überprüfen. Eine Appliance, die den Benutzer-Traffic verarbeiten kann, gibt den Statuscode `200` (OK) zurück. Es gibt einige Ursachen, weshalb eine Appliance den Statuscode `503` (Service Unavailable (Dienst nicht verfügbar)) zurückgibt:
  - Die Appliance ist ein passives Replikat, beispielsweise ein Replikat in einer Hochverfügbarkeitskonfiguration mit zwei Knoten.
  - Die Appliance befindet sich im Wartungsmodus.
  - Die Appliance ist Bestandteil der Geo-Replikationskonfiguration, ist jedoch ein inaktives Replikat.
diff --git a/translations/de-DE/data/reusables/enterprise_installation/necessary_ports.md b/translations/de-DE/data/reusables/enterprise_installation/necessary_ports.md
index ad059c10d246..15c736e27e71 100644
--- a/translations/de-DE/data/reusables/enterprise_installation/necessary_ports.md
+++ b/translations/de-DE/data/reusables/enterprise_installation/necessary_ports.md
@@ -1,12 +1,12 @@
-| Port     | Dienst | Beschreibung                                                                                                                                     |
-| -------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
-| 22       | SSH    | Git über SSH-Zugriff. Unterstützt das Klonen, Abrufen und Übertragen von Vorgängen an öffentliche/private Repositorys.                           |
-| 25       | SMTP   | SMTP mit Verschlüsselung (STARTTLS) wird unterstützt.                                                                                            |
-| 80       | HTTP   | Webanwendungszugriff. *Alle Anforderungen werden an den HTTPS-Port weitergeleitet, wenn SSL aktiviert ist.*                                      |
-| 122      | SSH    | Shellzugriff auf die Instanz. *Der standardmäßige SSH-Port (22) ist für den Git- und SSH-Netzwerk-Traffic der Anwendung vorgesehen.*             |
-| 161/UDP  | SNMP   | Für Netzwerküberwachungs-Protokollvorgänge erforderlich.                                                                                         |
-| 443      | HTTPS  | Webanwendung und Git über HTTPS-Zugriff.                                                                                                         |
-| 1194/UDP | VPN    | Sicherer Replikationsnetzwerktunnel in einer hochverfügbaren Konfiguration.                                                                      |
-| 8080     | HTTP   | Webbasierte {% data variables.enterprise.management_console %} in Nur-Text. *Nur erforderlich, wenn SSL manuell deaktiviert wird.*          |
-| 8443     | HTTPS  | Sichere webbasierte {% data variables.enterprise.management_console %}. *Für die grundlegende Installation und Konfiguration erforderlich.* |
-| 9418     | Git    | Einfacher Git-Protokollport. Nur Klon- und Abrufvorgänge zu öffentlichen Repositorys. *Unverschlüsselte Netzwerkkommunikation.*                  |
+| Port     | Dienst | Beschreibung                                                                                                                                                                                |
+| -------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 22       | SSH    | Git über SSH-Zugriff. Unterstützt das Klonen, Abrufen und Übertragen von Vorgängen an öffentliche/private Repositorys.                                                                      |
+| 25       | SMTP   | SMTP mit Verschlüsselung (STARTTLS) wird unterstützt.                                                                                                                                       |
+| 80       | HTTP   | Webanwendungszugriff. *Alle Anforderungen werden an den HTTPS-Port weitergeleitet, wenn SSL aktiviert ist.*                                                                                 |
+| 122      | SSH    | Shellzugriff auf die Instanz. *Der standardmäßige SSH-Port (22) ist für den Git- und SSH-Netzwerk-Traffic der Anwendung vorgesehen.*                                                        |
+| 161/UDP  | SNMP   | Für Netzwerküberwachungs-Protokollvorgänge erforderlich.                                                                                                                                    |
+| 443      | HTTPS  | Webanwendung und Git über HTTPS-Zugriff.                                                                                                                                                    |
+| 1194/UDP | VPN    | Sicherer Replikationsnetzwerktunnel in einer hochverfügbaren Konfiguration.                                                                                                                 |
+| 8080     | HTTP   | Webbasierte {% data variables.enterprise.management_console %} in Nur-Text. *Nur erforderlich, wenn SSL manuell deaktiviert wird.*                                                          |
+| 8443     | HTTPS  | Sichere webbasierte {% data variables.enterprise.management_console %}. *Für die grundlegende Installation und Konfiguration erforderlich.*                                                 |
+| 9418     | Git    | Einfacher Git-Protokollport. Nur Klon- und Abrufvorgänge zu öffentlichen Repositorys. *Unencrypted network communication.* {% data reusables.enterprise_installation.when-9418-necessary %}
diff --git a/translations/de-DE/data/reusables/enterprise_installation/request-a-trial.md b/translations/de-DE/data/reusables/enterprise_installation/request-a-trial.md
index 779012116d78..6374da9879ea 100644
--- a/translations/de-DE/data/reusables/enterprise_installation/request-a-trial.md
+++ b/translations/de-DE/data/reusables/enterprise_installation/request-a-trial.md
@@ -1 +1 @@
-Du kannst eine Testversion anfordern, um {% data variables.product.prodname_ghe_server %} zu evaluieren. Weitere Informationen findest Du unter „[Eine Testversion von {% data variables.product.prodname_ghe_server %} einrichten](/articles/setting-up-a-trial-of-github-enterprise-server).“
+Sie können eine Testversion anfordern, um {% data variables.product.prodname_ghe_server %} zu evaluieren. Weitere Informationen findest Du unter „[Eine Testversion von {% data variables.product.prodname_ghe_server %} einrichten](/articles/setting-up-a-trial-of-github-enterprise-server).“
diff --git a/translations/de-DE/data/reusables/enterprise_installation/save-settings-in-web-based-mgmt-console.md b/translations/de-DE/data/reusables/enterprise_installation/save-settings-in-web-based-mgmt-console.md
index edfd558733d9..54af78e67023 100644
--- a/translations/de-DE/data/reusables/enterprise_installation/save-settings-in-web-based-mgmt-console.md
+++ b/translations/de-DE/data/reusables/enterprise_installation/save-settings-in-web-based-mgmt-console.md
@@ -1 +1 @@
-3. Konfiguriere in der [{% data variables.enterprise.management_console %}](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-management-console/) Deine gewünschten Einstellungen, und speichere sie.
+3. Konfigurieren Sie in der [{% data variables.enterprise.management_console %}](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-management-console/) Ihre gewünschten Einstellungen, und speichern Sie sie.
diff --git a/translations/de-DE/data/reusables/enterprise_installation/software-license.md b/translations/de-DE/data/reusables/enterprise_installation/software-license.md
index 3465ef0cfcdf..790848ea3673 100644
--- a/translations/de-DE/data/reusables/enterprise_installation/software-license.md
+++ b/translations/de-DE/data/reusables/enterprise_installation/software-license.md
@@ -1 +1 @@
-Du musst über eine {% data variables.product.prodname_enterprise %}-Lizenzdatei verfügen. Besuche [enterprise.github.com](https://enterprise.github.com/download), um eine vorhandene Lizenzdatei herunterzuladen oder eine Testlizenz anzufordern. Weitere Informationen findest Du unter „[Deine {% data variables.product.prodname_enterprise %}-Lizenz verwalten](/enterprise/{{ currentVersion }}/admin/guides/installation/managing-your-github-enterprise-license/)."
+Sie müssen über eine {% data variables.product.prodname_enterprise %}-Lizenzdatei verfügen. Besuche [enterprise.github.com](https://enterprise.github.com/download), um eine vorhandene Lizenzdatei herunterzuladen oder eine Testlizenz anzufordern. Weitere Informationen findest Du unter „[Deine {% data variables.product.prodname_enterprise %}-Lizenz verwalten](/enterprise/{{ currentVersion }}/admin/guides/installation/managing-your-github-enterprise-license/)."
diff --git a/translations/de-DE/data/reusables/enterprise_installation/ssh-into-instance.md b/translations/de-DE/data/reusables/enterprise_installation/ssh-into-instance.md
index c6707fc50392..2882ef9038e5 100644
--- a/translations/de-DE/data/reusables/enterprise_installation/ssh-into-instance.md
+++ b/translations/de-DE/data/reusables/enterprise_installation/ssh-into-instance.md
@@ -1,4 +1,4 @@
-1. Stelle eine SSH-Verbindung zu {% data variables.product.product_location_enterprise %} her.
+1. Stellen Sie eine SSH-Verbindung zu {% data variables.product.product_location_enterprise %} her.
 ```shell
 $ ssh -p 122 admin@HOSTNAME
 ```
diff --git a/translations/de-DE/data/reusables/enterprise_installation/ssh-into-target-instance.md b/translations/de-DE/data/reusables/enterprise_installation/ssh-into-target-instance.md
index 72c0923c2eb7..3263861a9cf1 100644
--- a/translations/de-DE/data/reusables/enterprise_installation/ssh-into-target-instance.md
+++ b/translations/de-DE/data/reusables/enterprise_installation/ssh-into-target-instance.md
@@ -1,4 +1,4 @@
-1. Stelle als ein Websiteadministrator eine [SSH-Verbindung zur {% data variables.product.prodname_ghe_server %}-Instanz her](/enterprise/admin/guides/installation/accessing-the-administrative-shell-ssh/).
+1. Stellen Sie als ein Websiteadministrator eine [SSH-Verbindung zur {% data variables.product.prodname_ghe_server %}-Instanz her](/enterprise/admin/guides/installation/accessing-the-administrative-shell-ssh/).
 ```shell
 $ ssh -p 122 admin@HOSTNAME
 ```
diff --git a/translations/de-DE/data/reusables/enterprise_installation/when-9418-necessary.md b/translations/de-DE/data/reusables/enterprise_installation/when-9418-necessary.md
new file mode 100644
index 000000000000..7eed264bd24e
--- /dev/null
+++ b/translations/de-DE/data/reusables/enterprise_installation/when-9418-necessary.md
@@ -0,0 +1 @@
+If you have enabled private mode on your instance, then opening this port is only required if you also enabled anonymous Git read access. For more information, see "[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#configuring-anonymous-git-read-access)."
\ No newline at end of file
diff --git a/translations/de-DE/data/reusables/enterprise_management_console/advanced-security-tab.md b/translations/de-DE/data/reusables/enterprise_management_console/advanced-security-tab.md
index 2b80636fb415..ffd61c8ac3e2 100644
--- a/translations/de-DE/data/reusables/enterprise_management_console/advanced-security-tab.md
+++ b/translations/de-DE/data/reusables/enterprise_management_console/advanced-security-tab.md
@@ -1 +1 @@
-1. Klicke auf der linken Seitenleiste auf **{% data variables.product.prodname_advanced_security %}**. ![Advanced Security sidebar](/assets/images/enterprise/management-console/sidebar-advanced-security.png)
+1. Klicken Sie auf der linken Seitenleiste auf **{% data variables.product.prodname_advanced_security %}**. ![Advanced Security sidebar](/assets/images/enterprise/management-console/sidebar-advanced-security.png)
diff --git a/translations/de-DE/data/reusables/enterprise_management_console/badge_indicator.md b/translations/de-DE/data/reusables/enterprise_management_console/badge_indicator.md
index 75bd22b5120c..2d99ae3d7598 100644
--- a/translations/de-DE/data/reusables/enterprise_management_console/badge_indicator.md
+++ b/translations/de-DE/data/reusables/enterprise_management_console/badge_indicator.md
@@ -1 +1 @@
-Ein Team, das mit einer [LDAP-Gruppe synchronisiert](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#enabling-ldap-sync) ist, wird durch einen speziellen LDAP-Badge angegeben. Die Mitgliederliste für ein LDAP-synchronisiertes Team kann nur über die LDAP-Gruppe verwaltet werden, der sie zugeordnet ist.
+Ein Team, das mit einer [LDAP-Gruppe synchronisiert](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#enabling-ldap-sync) ist, wird durch einen speziellen LDAP-Badge angegeben. Die Mitgliederliste für ein LDAP-synchronisiertes Team kann nur über die LDAP-Gruppe verwaltet werden, der sie zugeordnet ist.
diff --git a/translations/de-DE/data/reusables/enterprise_management_console/support-link.md b/translations/de-DE/data/reusables/enterprise_management_console/support-link.md
index 755c674ccbe1..3ef1b2594d88 100644
--- a/translations/de-DE/data/reusables/enterprise_management_console/support-link.md
+++ b/translations/de-DE/data/reusables/enterprise_management_console/support-link.md
@@ -1 +1 @@
-4. Klicke im oberen rechten Bereich der {% data variables.enterprise.management_console %} auf **Support**. ![Schaltfläche für den Zugriff auf den Bereich „Support“](/assets/images/enterprise/management-console/support-link.png)
+4. Klicken Sie im oberen rechten Bereich der {% data variables.enterprise.management_console %} auf **Support**. ![Schaltfläche für den Zugriff auf den Bereich „Support“](/assets/images/enterprise/management-console/support-link.png)
diff --git a/translations/de-DE/data/reusables/enterprise_management_console/type-management-console-password.md b/translations/de-DE/data/reusables/enterprise_management_console/type-management-console-password.md
index 7f03e7e0bd8f..8c4987e84853 100644
--- a/translations/de-DE/data/reusables/enterprise_management_console/type-management-console-password.md
+++ b/translations/de-DE/data/reusables/enterprise_management_console/type-management-console-password.md
@@ -1 +1 @@
-1. Wenn Du dazu aufgefordert wirst, gib Dein {% data variables.enterprise.management_console %}-Passwort ein. ![{% data variables.enterprise.management_console %}-Entsperrbildschirm](/assets/images/enterprise/management-console/unlock-password.png)
+1. Wenn Sie dazu aufgefordert werden, geben Sie Ihr {% data variables.enterprise.management_console %}-Passwort ein. ![{% data variables.enterprise.management_console %}-Entsperrbildschirm](/assets/images/enterprise/management-console/unlock-password.png)
diff --git a/translations/de-DE/data/reusables/enterprise_management_console/updates-tab.md b/translations/de-DE/data/reusables/enterprise_management_console/updates-tab.md
index e8346441986f..fd143587385a 100644
--- a/translations/de-DE/data/reusables/enterprise_management_console/updates-tab.md
+++ b/translations/de-DE/data/reusables/enterprise_management_console/updates-tab.md
@@ -1 +1 @@
-1. Klicke im oberen Bereich der {% data variables.enterprise.management_console %} auf **Updates**. ![Menüpunkt „Updates“](/assets/images/enterprise/management-console/updates_tab.png)
+1. Klicken Sie im oberen Bereich der {% data variables.enterprise.management_console %} auf **Updates**. ![Menüpunkt „Updates“](/assets/images/enterprise/management-console/updates_tab.png)
diff --git a/translations/de-DE/data/reusables/enterprise_site_admin_settings/business.md b/translations/de-DE/data/reusables/enterprise_site_admin_settings/business.md
index cbe9833a371b..bcda507fbea0 100644
--- a/translations/de-DE/data/reusables/enterprise_site_admin_settings/business.md
+++ b/translations/de-DE/data/reusables/enterprise_site_admin_settings/business.md
@@ -1 +1 @@
-1. Klicken Sie auf der linken Seitenleiste auf **Enterprise**. ![Registerkarte „Enterprise“ in den Einstellungen des Websiteadministrators](/assets/images/enterprise/site-admin-settings/enterprise-tab.png)
+1. In the left sidebar, click **Enterprise{% if currentVersion ver_gt "enterprise-server@2.21" %} overview{% endif %}**. ![Enterprise{% if currentVersion ver_gt "enterprise-server@2.21" %} overview{% endif %} tab in the Site admin settings](/assets/images/enterprise/site-admin-settings/enterprise-tab.png)
diff --git a/translations/de-DE/data/reusables/enterprise_site_admin_settings/packages-tab.md b/translations/de-DE/data/reusables/enterprise_site_admin_settings/packages-tab.md
index 7552439d3d6c..add144d1e6c8 100644
--- a/translations/de-DE/data/reusables/enterprise_site_admin_settings/packages-tab.md
+++ b/translations/de-DE/data/reusables/enterprise_site_admin_settings/packages-tab.md
@@ -1 +1 @@
-1. In the left sidebar, click **Packages**. ![Packages tab in management console sidebar](/assets/images/enterprise/site-admin-settings/management-console-packages-tab.png)
\ No newline at end of file
+1. In the left sidebar, click **Packages**. ![Packages tab in management console sidebar](/assets/images/enterprise/site-admin-settings/management-console-packages-tab.png)
diff --git a/translations/de-DE/data/reusables/enterprise_user_management/manage-global-webhooks-api.md b/translations/de-DE/data/reusables/enterprise_user_management/manage-global-webhooks-api.md
index 2eb5518a5a23..9cf3f7c3e86d 100644
--- a/translations/de-DE/data/reusables/enterprise_user_management/manage-global-webhooks-api.md
+++ b/translations/de-DE/data/reusables/enterprise_user_management/manage-global-webhooks-api.md
@@ -1 +1 @@
-Du kannst auch {% data variables.product.prodname_enterprise_api %} verwenden, um globale Webhooks zu verwalten. For a complete list of actions, see "[Global webhooks](/v3/enterprise-admin/global_webhooks)."
+Du kannst auch {% data variables.product.prodname_enterprise_api %} verwenden, um globale Webhooks zu verwalten. For a complete list of actions, see "[Global webhooks](/rest/reference/enterprise-admin#global-webhooks)."
diff --git a/translations/de-DE/data/reusables/files/commit-author-email-options.md b/translations/de-DE/data/reusables/files/commit-author-email-options.md
index 3f37917e1cb4..e165f53c555b 100644
--- a/translations/de-DE/data/reusables/files/commit-author-email-options.md
+++ b/translations/de-DE/data/reusables/files/commit-author-email-options.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-Wenn Du den Datenschutz für E-Mail-Adressen nicht aktiviert hast, kannst Du auswählen, welche verifizierte E-Mail-Adresse als Autor erscheint, wenn Du Dateien bearbeitest, löschst oder erstellst oder einen Pull Request auf {% data variables.product.product_name %} zusammenführst. Wenn Du den Datenschutz der E-Mail-Adressen aktiviert hast, kann die E-Mail-Adresse des Commit-Autors nicht geändert werden und ist standardmäßig `@users.noreply.github.com`.
+If you haven't enabled email address privacy, you can choose which verified email address to author changes with when you edit, delete, or create files or merge a pull request on
+{% data variables.product.product_name %}. Wenn Du den Datenschutz der E-Mail-Adressen aktiviert hast, kann die E-Mail-Adresse des Commit-Autors nicht geändert werden und ist standardmäßig `@users.noreply.github.com`.
 {% endif %}
diff --git a/translations/de-DE/data/reusables/gated-features/actions.md b/translations/de-DE/data/reusables/gated-features/actions.md
index 4abab3468016..ed730faaf2ee 100644
--- a/translations/de-DE/data/reusables/gated-features/actions.md
+++ b/translations/de-DE/data/reusables/gated-features/actions.md
@@ -1 +1 @@
-{% data variables.product.prodname_actions %} ist verfügbar mit {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} für Organisationen, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, und {% data variables.product.prodname_ghe_one %}. {% data variables.product.prodname_actions %} is not available for private repositories owned by accounts using legacy per-repository plans. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %}
+{{ site.data.variables.product.prodname_actions }} ist verfügbar mit {{ site.data.variables.product.prodname_free_user }}, {{ site.data.variables.product.prodname_pro }}, {{ site.data.variables.product.prodname_free_team }} für Organisationen, {{ site.data.variables.product.prodname_team }}, {{ site.data.variables.product.prodname_ghe_cloud }}, und {{ site.data.variables.product.prodname_ghe_one }}. {% data variables.product.prodname_actions %} ist nicht verfügbar für private Repositorys, die im Besitz von Konten mit älteren Pro-Repository-Plänen sind. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %}
diff --git a/translations/de-DE/data/reusables/gated-features/branch-restrictions.md b/translations/de-DE/data/reusables/gated-features/branch-restrictions.md
index e642bfc9b248..2b8b2c1e5972 100644
--- a/translations/de-DE/data/reusables/gated-features/branch-restrictions.md
+++ b/translations/de-DE/data/reusables/gated-features/branch-restrictions.md
@@ -1 +1 @@
-Geschützte Brances sind verfügbar in öffentlichen Repositorys mit {% data variables.product.prodname_free_user %} und {% data variables.product.prodname_free_team %} für Organisationen, und in öffentlichen und privaten Repositorys mit {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, und {% data variables.product.prodname_ghe_server %}. Die Fähigkeit, Branches einzuschränken, ist ein Branch-Schutztyp, der für öffentliche und private Repositorys verfügbar ist, die Organisationen in {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %} und {% data variables.product.prodname_ghe_server %} gehören. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %}
+Geschützte Branches sind verfügbar in öffentlichen Repositorys mit {% data variables.product.prodname_free_user %} und {% data variables.product.prodname_free_team %} für Organisationen, und in öffentlichen und privaten Repositorys mit {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, und {% data variables.product.prodname_ghe_server %}. Die Fähigkeit, Branches einzuschränken, ist ein Branch-Schutztyp, der für öffentliche und private Repositorys verfügbar ist, die Organisationen in {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %} und {% data variables.product.prodname_ghe_server %} gehören. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %}
diff --git a/translations/de-DE/data/reusables/gated-features/code-review-assignment.md b/translations/de-DE/data/reusables/gated-features/code-review-assignment.md
index e1bfb36dcf87..0aabf111078b 100644
--- a/translations/de-DE/data/reusables/gated-features/code-review-assignment.md
+++ b/translations/de-DE/data/reusables/gated-features/code-review-assignment.md
@@ -1 +1 @@
-Codereview-Zuweisung ist verfügbar mit {% data variables.product.prodname_team %}{% if currentVersion ver_gt "enterprise-server@2.19" %}, {% data variables.product.prodname_ghe_server %} 2.20+,{% endif %} und {% data variables.product.prodname_ghe_cloud %}. Weiter Informationen findest Du unter „[GitHub Produkte](/articles/githubs-products)."
+Code review assignment is available with {% data variables.product.prodname_team %}{% if currentVersion ver_gt "enterprise-server@2.19" %}, {% data variables.product.prodname_ghe_server %} 2.20+,{% endif %} and {% data variables.product.prodname_ghe_cloud %}. Weiter Informationen findest Du unter „[GitHub Produkte](/articles/githubs-products)."
diff --git a/translations/de-DE/data/reusables/gated-features/code-scanning.md b/translations/de-DE/data/reusables/gated-features/code-scanning.md
new file mode 100644
index 000000000000..a1aca3e675eb
--- /dev/null
+++ b/translations/de-DE/data/reusables/gated-features/code-scanning.md
@@ -0,0 +1 @@
+{% data variables.product.prodname_code_scanning_capc %} is available in public repositories, and in public and private repositories owned by organizations with a license for {% data variables.product.prodname_advanced_security %}. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %}
diff --git a/translations/de-DE/data/reusables/gated-features/enterprise-accounts.md b/translations/de-DE/data/reusables/gated-features/enterprise-accounts.md
index a5ffc5246c69..9812aa0dc9e4 100644
--- a/translations/de-DE/data/reusables/gated-features/enterprise-accounts.md
+++ b/translations/de-DE/data/reusables/gated-features/enterprise-accounts.md
@@ -1 +1 @@
-Enterprise-Konten sind verfügbar mit {% data variables.product.prodname_ghe_cloud %} und {% data variables.product.prodname_ghe_server %}. {% if currentVersion == "free-pro-team@latest" %}Weitere Informationen findest Du unter „[Über Enterprise-Konten](/articles/about-enterprise-accounts)".{% endif %}
+Enterprise-Konten sind verfügbar mit {% data variables.product.prodname_ghe_cloud %} und {% data variables.product.prodname_ghe_server %}. {% if currentVersion == "free-pro-team@latest" %}For more information, see "[About enterprise accounts](/articles/about-enterprise-accounts)."{% endif %}
diff --git a/translations/de-DE/data/reusables/gated-features/github-insights.md b/translations/de-DE/data/reusables/gated-features/github-insights.md
index 02872fa933bc..43548d93206a 100644
--- a/translations/de-DE/data/reusables/gated-features/github-insights.md
+++ b/translations/de-DE/data/reusables/gated-features/github-insights.md
@@ -1 +1 @@
-{% data variables.product.prodname_insights %} ist verfügbar mit {% data variables.product.prodname_ghe_one %}. Weitere Informationen finden Sie unter „[Produkte von {% data variables.product.prodname_dotcom %}](/articles/githubs-products)“.
+{% data variables.product.prodname_insights %} ist verfügbar mit {% data variables.product.prodname_ghe_one %}. Weitere Informationen findest Du unter „[Produkte von {% data variables.product.prodname_dotcom %}](/articles/githubs-products).“
diff --git a/translations/de-DE/data/reusables/gated-features/more-info-org-products.md b/translations/de-DE/data/reusables/gated-features/more-info-org-products.md
index e61b8eefc7cb..323025b41e40 100644
--- a/translations/de-DE/data/reusables/gated-features/more-info-org-products.md
+++ b/translations/de-DE/data/reusables/gated-features/more-info-org-products.md
@@ -1 +1 @@
-{% if currentVersion == "free-pro-team@latest" %}Weitere Informationen findest Du unter „[{% data variables.product.prodname_dotcom %}-Produkte](/articles/github-s-products)".{% endif %}
+{% if currentVersion == "free-pro-team@latest" %}For more information, see "[{% data variables.product.prodname_dotcom %}'s products](/articles/github-s-products)."{% endif %}
diff --git a/translations/de-DE/data/reusables/gated-features/more-info.md b/translations/de-DE/data/reusables/gated-features/more-info.md
index e61b8eefc7cb..323025b41e40 100644
--- a/translations/de-DE/data/reusables/gated-features/more-info.md
+++ b/translations/de-DE/data/reusables/gated-features/more-info.md
@@ -1 +1 @@
-{% if currentVersion == "free-pro-team@latest" %}Weitere Informationen findest Du unter „[{% data variables.product.prodname_dotcom %}-Produkte](/articles/github-s-products)".{% endif %}
+{% if currentVersion == "free-pro-team@latest" %}For more information, see "[{% data variables.product.prodname_dotcom %}'s products](/articles/github-s-products)."{% endif %}
diff --git a/translations/de-DE/data/reusables/gated-features/packages.md b/translations/de-DE/data/reusables/gated-features/packages.md
index 55b65bbc4d45..5da742c32466 100644
--- a/translations/de-DE/data/reusables/gated-features/packages.md
+++ b/translations/de-DE/data/reusables/gated-features/packages.md
@@ -1,4 +1,5 @@
 {% data variables.product.prodname_registry %} is available with {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} for organizations, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, {% data variables.product.prodname_ghe_server %} 2.22, and {% data variables.product.prodname_ghe_one %}.
 {% if currentVersion == "free-pro-team@latest" %}
-
    {% data variables.product.prodname_registry %} ist nicht verfügbar für private Repositorys im Besitz von Konten mit älteren Pro-Repository-Plänen. {% data variables.product.prodname_registry %} ist verfügbar mit {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} für Organisationen, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, und {% data variables.product.prodname_ghe_one %}. {% data reusables.gated-features.more-info %}
+
    
+{% data variables.product.prodname_registry %} ist nicht verfügbar für private Repositorys im Besitz von Konten mit älteren Pro-Repository-Plänen. {% data variables.product.prodname_registry %} ist verfügbar mit {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} für Organisationen, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, und {% data variables.product.prodname_ghe_one %}. {% data reusables.gated-features.more-info %}
 {% endif %}
diff --git a/translations/de-DE/data/reusables/gated-features/protected-branches.md b/translations/de-DE/data/reusables/gated-features/protected-branches.md
index 3a6dce7d1df5..724c36e1a8a8 100644
--- a/translations/de-DE/data/reusables/gated-features/protected-branches.md
+++ b/translations/de-DE/data/reusables/gated-features/protected-branches.md
@@ -1 +1 @@
-Geschützte Brances sind verfügbar in öffentlichen Repositorys mit {% data variables.product.prodname_free_user %} und {% data variables.product.prodname_free_team %} für Organisationen, und in öffentlichen und privaten Repositorys mit {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, und {% data variables.product.prodname_ghe_server %}. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %}
+Geschützte Branches sind verfügbar in öffentlichen Repositorys mit {% data variables.product.prodname_free_user %} und {% data variables.product.prodname_free_team %} für Organisationen, und in öffentlichen und privaten Repositorys mit {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, und {% data variables.product.prodname_ghe_server %}. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %}
diff --git a/translations/de-DE/data/reusables/gated-features/repository-insights.md b/translations/de-DE/data/reusables/gated-features/repository-insights.md
index 67d7e294525e..c400b5bf830d 100644
--- a/translations/de-DE/data/reusables/gated-features/repository-insights.md
+++ b/translations/de-DE/data/reusables/gated-features/repository-insights.md
@@ -1 +1 @@
-Dieses Repository-Insights-Diagramm ist verfügbar in öffentlichen Repositorys mit {% data variables.product.prodname_free_user %} und {% data variables.product.prodname_free_team %} für Organisationen, und in öffentlichen und privaten Repositorys mit {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, und {% data variables.product.prodname_ghe_server %}.{% if currentVersion == "free-pro-team@latest" %} Weitere Informationen findest Du unter „[Über Repository-Diagramme](/articles/about-repository-graphs)" und unter „[{% data variables.product.prodname_dotcom %} Produkte](/articles/github-s-products)."{% endif %}
+This repository insights graph is available in public repositories with {% data variables.product.prodname_free_user %} and {% data variables.product.prodname_free_team %} for organizations, and in public and private repositories with {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, and {% data variables.product.prodname_ghe_server %}.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[About repository graphs](/articles/about-repository-graphs)" and "[{% data variables.product.prodname_dotcom %}'s products](/articles/github-s-products)."{% endif %}
diff --git a/translations/de-DE/data/reusables/git/git-push.md b/translations/de-DE/data/reusables/git/git-push.md
index 759c36bdc576..30a9acd7a63b 100644
--- a/translations/de-DE/data/reusables/git/git-push.md
+++ b/translations/de-DE/data/reusables/git/git-push.md
@@ -1,4 +1,4 @@
-1. [Übergeben Sie die Änderungen](/articles/pushing-commits-to-a-remote-repository/) in Ihrem lokalen Repository per Push an {% data variables.product.product_location %}.
+1. [Übergib die Änderungen](/articles/pushing-commits-to-a-remote-repository/) in Deinem lokalen Repository per Push an {% data variables.product.product_location %}.
   ```shell
   $ git push origin your-branch
   # Uebertraegt die Aenderungen in Deinem lokalen Repository per Push auf das von Dir als Ursprung festgelegte Remote-Repository
diff --git a/translations/de-DE/data/reusables/github-actions/actions-billing.md b/translations/de-DE/data/reusables/github-actions/actions-billing.md
index 865be88f5f42..5e2f301f5159 100644
--- a/translations/de-DE/data/reusables/github-actions/actions-billing.md
+++ b/translations/de-DE/data/reusables/github-actions/actions-billing.md
@@ -1 +1 @@
-{% data variables.product.prodname_actions %} Nutzung ist kostenlos für öffentliche Repositorys. Für private Repositorys erhält jedes {% data variables.product.prodname_dotcom %} Konto eine bestimmte Menge von kostenlosen Minuten und Speicher, abhängig vom Produkt, das mit dem Konto verwendet wird.
+{% data variables.product.prodname_actions %} usage is free for public repositories and self-hosted runners. Für private Repositorys erhält jedes {% data variables.product.prodname_dotcom %} Konto eine bestimmte Menge von kostenlosen Minuten und Speicher, abhängig vom Produkt, das mit dem Konto verwendet wird.
diff --git a/translations/de-DE/data/reusables/github-actions/actions-on-examples.md b/translations/de-DE/data/reusables/github-actions/actions-on-examples.md
index 65d09cd4c67c..9ed6e219978e 100644
--- a/translations/de-DE/data/reusables/github-actions/actions-on-examples.md
+++ b/translations/de-DE/data/reusables/github-actions/actions-on-examples.md
@@ -1,14 +1,14 @@
 ##### **Beispiel mit einem einzelnen Ereignis**
 
 ```yaml
-# Bei Push auslösen
+# Triggered when code is pushed to any branch in a repository
 on: push
 ```
 
 ##### **Beispiel mit einer Ereignisliste**
 
 ```yaml
-# Workflow bei Push oder bei Pull Request auslösen
+# Triggers the workflow on push or pull request events
 on: [push, pull_request]
 ```
 
@@ -18,17 +18,17 @@ Wenn Du Aktivitätstypen oder Konfigurationen für ein Ereignis angeben musst, m
 
 ```yaml
 on:
-  # Workflow bei Push oder Pull Request ausloesen,
-  # aber nur für den Master-Branch
+  # Trigger the workflow on push or pull request,
+  # but only for the main branch
   push:
     branches:
-      - master
+      - main
   pull_request:
     branches:
-      - master
-  # Auch bei page_build ausloesen, wie auch für Release erstellte Ereignisse
+      - main
+  # Also trigger on page_build, as well as release created events
   page_build:
   release:
-    types: # Diese Konfiguration beeinflusst das obige page_build Ereignis nicht
+    types: # This configuration does not affect the page_build event above
       - created
 ```
diff --git a/translations/de-DE/data/reusables/github-actions/actions-unused-labels.md b/translations/de-DE/data/reusables/github-actions/actions-unused-labels.md
index e9b18681f132..6b6d4506506d 100644
--- a/translations/de-DE/data/reusables/github-actions/actions-unused-labels.md
+++ b/translations/de-DE/data/reusables/github-actions/actions-unused-labels.md
@@ -1 +1 @@
- Alle unbenutzten Kennzeichnungen, die keinem Läufer zugewiesen sind, werden innerhalb von 24 Stunden automatisch gelöscht.
\ No newline at end of file
+ Alle unbenutzten Kennzeichnungen, die keinem Läufer zugewiesen sind, werden innerhalb von 24 Stunden automatisch gelöscht.
diff --git a/translations/de-DE/data/reusables/github-actions/artifact-log-retention-statement.md b/translations/de-DE/data/reusables/github-actions/artifact-log-retention-statement.md
new file mode 100644
index 000000000000..1109967df33c
--- /dev/null
+++ b/translations/de-DE/data/reusables/github-actions/artifact-log-retention-statement.md
@@ -0,0 +1,2 @@
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} By default, {% data variables.product.product_name %} stores build logs and artifacts for 90 days, and this retention period can be customized. For more information, see "[Usage limits, billing, and administration](/actions/reference/usage-limits-billing-and-administration#artifact-and-log-retention-policy)".{% endif %}
+{% if currentVersion == "enterprise-server@2.22" %} {% data variables.product.product_name %} stores full build logs and artifacts for 90 days.{% endif %}
diff --git a/translations/de-DE/data/reusables/github-actions/branch-requirement.md b/translations/de-DE/data/reusables/github-actions/branch-requirement.md
index b1e18ddef170..b8be9a7d5365 100644
--- a/translations/de-DE/data/reusables/github-actions/branch-requirement.md
+++ b/translations/de-DE/data/reusables/github-actions/branch-requirement.md
@@ -1,5 +1,5 @@
 {% note %}
 
-**Hinweis:** Dieses Ereignis löst nur dann eine Workflow-Ausführung aus, wenn sich die Workflowdatei auf dem `master` oder Standardbranch befindet.
+**Note:** This event will only trigger a workflow run if the workflow file is on the default branch.
 
 {% endnote %}
diff --git a/translations/de-DE/data/reusables/github-actions/change-retention-period-for-artifacts-logs.md b/translations/de-DE/data/reusables/github-actions/change-retention-period-for-artifacts-logs.md
new file mode 100644
index 000000000000..19398bca6ab8
--- /dev/null
+++ b/translations/de-DE/data/reusables/github-actions/change-retention-period-for-artifacts-logs.md
@@ -0,0 +1,2 @@
+1. Under **Artifact and log retention duration**, enter a new value.
+1. Click **Save** to apply the change.
\ No newline at end of file
diff --git a/translations/de-DE/data/reusables/github-actions/contacting-support.md b/translations/de-DE/data/reusables/github-actions/contacting-support.md
index 4a50d27e1432..249000fe19bc 100644
--- a/translations/de-DE/data/reusables/github-actions/contacting-support.md
+++ b/translations/de-DE/data/reusables/github-actions/contacting-support.md
@@ -1,8 +1,8 @@
 Wenn Du Hilfe für irgendwelche Themen in Bezug auf Workflow-Konfigurationen brauchst, beispielsweise zu Syntax, {% data variables.product.prodname_dotcom %}-gehostete Läufer oder Bauvorgänge, suche nach einen vorhandenen Thema oder starte ein neues im [{% data variables.product.prodname_gcf %}'s {% data variables.product.prodname_actions %} Board](https://github.community/c/github-actions).
 
-Wenn Du Feedback oder Feature-Anfragen zu {% data variables.product.prodname_actions %} abgeben möchtest, teile diese in den {% data variables.contact.contact_feedback_actions %}.
+Wenn Sie Feedback oder Feature-Anfragen zu {% data variables.product.prodname_actions %} abgeben möchten, teilen Sie diese in den {% data variables.contact.contact_feedback_actions %}.
 
-Wende Dich in den folgenden Fällen an den {% data variables.contact.contact_support %}, unabhängig davon, ob Deine Nutzung oder beabsichtigte Nutzung in die Nutzungseinschränkungskategorien fällt:
+Wenden Sie sich in den folgenden Fällen an den {% data variables.contact.contact_support %}, unabhängig davon, ob Ihre Nutzung oder beabsichtigte Nutzung in die Nutzungseinschränkungskategorien fällt:
 
 * Du bist der Meinung, dass Dein Konto ungerechtfertigt eingeschränkt wurde
 * Beim Ausführen einer Aktion tritt ein unerwarteter Fehler auf, z. B. eine eindeutige ID
diff --git a/translations/de-DE/data/reusables/github-actions/disabled-actions-description.md b/translations/de-DE/data/reusables/github-actions/disabled-actions-description.md
index 71c17c1e1ed8..7d0d0e4b60be 100644
--- a/translations/de-DE/data/reusables/github-actions/disabled-actions-description.md
+++ b/translations/de-DE/data/reusables/github-actions/disabled-actions-description.md
@@ -1 +1 @@
-Wenn Du {% data variables.product.prodname_actions %} deaktivierst, werden keine Workflows in Deinem Repository ausgeführt.
\ No newline at end of file
+Wenn Du {% data variables.product.prodname_actions %} deaktivierst, werden keine Workflows in Deinem Repository ausgeführt.
diff --git a/translations/de-DE/data/reusables/github-actions/disabling-github-actions.md b/translations/de-DE/data/reusables/github-actions/disabling-github-actions.md
index e6824e20684d..9344146d57e7 100644
--- a/translations/de-DE/data/reusables/github-actions/disabling-github-actions.md
+++ b/translations/de-DE/data/reusables/github-actions/disabling-github-actions.md
@@ -1 +1 @@
-By default, {% data variables.product.prodname_actions %} is enabled on all repositories and organizations. You can choose to disable {% data variables.product.prodname_actions %} or limit them to private actions only, which means that people can only use actions that exist in your repository.
+By default, {% if currentVersion ver_gt "enterprise-server@2.21" %}after {% data variables.product.prodname_actions %} is enabled on {% data variables.product.product_location %}, it{% else if if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_actions %}{% endif %} is enabled on all repositories and organizations. You can choose to disable {% data variables.product.prodname_actions %} or limit them to private actions only, which means that people can only use actions that exist in your repository.
diff --git a/translations/de-DE/data/reusables/github-actions/docker-container-os-support.md b/translations/de-DE/data/reusables/github-actions/docker-container-os-support.md
index 348ccb22e9f5..38fd56c5aef5 100644
--- a/translations/de-DE/data/reusables/github-actions/docker-container-os-support.md
+++ b/translations/de-DE/data/reusables/github-actions/docker-container-os-support.md
@@ -2,7 +2,7 @@
 
 **Hinweis:** Wenn Deine Workflows Docker-Containeraktionen oder Dienstcontainer verwenden, musst Du einen Linux-Läufer verwenden:
 
-* Wenn Du {% data variables.product.prodname_dotcom %}-gehostete Läufer verwendest, musst Du den `ubuntu-latest` Läufer verwenden.
+* If you are using {% data variables.product.prodname_dotcom %}-hosted runners, you must use an Ubuntu runner.
 * Wenn Du selbst gehostete Läufer verwendest, musst Du einen Linux-Rechner als Deinen Läufer verwenden und Docker muss installiert sein.
 
 {% endnote %}
diff --git a/translations/de-DE/data/reusables/github-actions/dockerfile-guidelines.md b/translations/de-DE/data/reusables/github-actions/dockerfile-guidelines.md
index 44655195c74e..7b17e0720809 100644
--- a/translations/de-DE/data/reusables/github-actions/dockerfile-guidelines.md
+++ b/translations/de-DE/data/reusables/github-actions/dockerfile-guidelines.md
@@ -1,3 +1,3 @@
 1. Dokumentiere die erforderlichen Argumente in der README der Aktion und lasse sie in der `CMD`-Anweisung weg.
 1. Verwenden Sie Standardwerte, die die Verwendung der Aktion ohne Angabe von `args` erlauben.
-1. Wenn die Aktion ein `--help` Flag oder etwas ähnliches verfügbar macht, verwende dieses, um Deine Aktion selbstdokumentierend zu machen.
\ No newline at end of file
+1. Wenn die Aktion ein `--help` Flag oder etwas ähnliches verfügbar macht, verwende dieses, um Deine Aktion selbstdokumentierend zu machen.
diff --git a/translations/de-DE/data/reusables/github-actions/enabled-actions-description.md b/translations/de-DE/data/reusables/github-actions/enabled-actions-description.md
index ee3f8bcd9abf..e6c0191f454d 100644
--- a/translations/de-DE/data/reusables/github-actions/enabled-actions-description.md
+++ b/translations/de-DE/data/reusables/github-actions/enabled-actions-description.md
@@ -1 +1 @@
-Wenn Du {% data variables.product.prodname_actions %} aktivierst, können Workflows Aktionen ausführen, die sich in Deinem Repository und jedem anderen öffentlichen Repository befinden.
\ No newline at end of file
+Wenn Du {% data variables.product.prodname_actions %} aktivierst, können Workflows Aktionen ausführen, die sich in Deinem Repository und jedem anderen öffentlichen Repository befinden.
diff --git a/translations/de-DE/data/reusables/github-actions/enabled-local-github-actions.md b/translations/de-DE/data/reusables/github-actions/enabled-local-github-actions.md
index 1ed8812e398e..f88275e7c204 100644
--- a/translations/de-DE/data/reusables/github-actions/enabled-local-github-actions.md
+++ b/translations/de-DE/data/reusables/github-actions/enabled-local-github-actions.md
@@ -1 +1 @@
-Wenn Du nur lokale Aktionen aktivierst, können Workflows nur Aktionen ausführen, die sich in Deinem Repository oder Deiner Organisation befinden.
\ No newline at end of file
+Wenn Du nur lokale Aktionen aktivierst, können Workflows nur Aktionen ausführen, die sich in Deinem Repository oder Deiner Organisation befinden.
diff --git a/translations/de-DE/data/reusables/github-actions/expression-syntax-if.md b/translations/de-DE/data/reusables/github-actions/expression-syntax-if.md
index e012be75b937..8f6fbdfc26c6 100644
--- a/translations/de-DE/data/reusables/github-actions/expression-syntax-if.md
+++ b/translations/de-DE/data/reusables/github-actions/expression-syntax-if.md
@@ -1 +1 @@
-Wenn Du Ausdrücke in einer `if` Bedingung verwendest, kannst Du die Syntax des Ausdrucks ({% raw %}`${{ }}`{% endraw %}) weglassen, da {% data variables.product.prodname_dotcom %} automatisch die `if` Bedingung als Ausdruck wertet.
\ No newline at end of file
+Wenn Du Ausdrücke in einer `if` Bedingung verwendest, kannst Du die Syntax des Ausdrucks ({% raw %}`${{ }}`{% endraw %}) weglassen, da {% data variables.product.prodname_dotcom %} automatisch die `if` Bedingung als Ausdruck wertet.
diff --git a/translations/de-DE/data/reusables/github-actions/gradle-workflow-steps.md b/translations/de-DE/data/reusables/github-actions/gradle-workflow-steps.md
index 7825f377bc8f..035c8e59cf79 100644
--- a/translations/de-DE/data/reusables/github-actions/gradle-workflow-steps.md
+++ b/translations/de-DE/data/reusables/github-actions/gradle-workflow-steps.md
@@ -1,4 +1,4 @@
 Dieser Workflow führt die folgenden Schritte aus:
 
 1. Checkt eine Kopie des Projekt-Repositorys aus.
-1. Richtet das Java JDK ein.
\ No newline at end of file
+1. Richtet das Java JDK ein.
diff --git a/translations/de-DE/data/reusables/github-actions/permissions-statement-secrets-api.md b/translations/de-DE/data/reusables/github-actions/permissions-statement-secrets-api.md
index 205580788ca2..0e62bb6498c9 100644
--- a/translations/de-DE/data/reusables/github-actions/permissions-statement-secrets-api.md
+++ b/translations/de-DE/data/reusables/github-actions/permissions-statement-secrets-api.md
@@ -1 +1 @@
-Um Geheimnisse mit der REST-API zu erstellen, musst Du Schreibzugriff auf das Repository haben. For more information, see "[{% data variables.product.prodname_actions %} secrets API](/v3/actions/secrets/)."
+To create secrets using the REST API, you must have write access to the repository or admin access to the organization. For more information, see "[{% data variables.product.prodname_actions %} secrets API](/v3/actions/secrets/)."
diff --git a/translations/de-DE/data/reusables/github-actions/permissions-statement-secrets-organization.md b/translations/de-DE/data/reusables/github-actions/permissions-statement-secrets-organization.md
index cce045790d6e..0a490aa57f43 100644
--- a/translations/de-DE/data/reusables/github-actions/permissions-statement-secrets-organization.md
+++ b/translations/de-DE/data/reusables/github-actions/permissions-statement-secrets-organization.md
@@ -1 +1 @@
-Um Geheimnisse auf Organisationsebene zu erstellen, musst Du `admin`-Zugriff haben. 
\ No newline at end of file
+Um Geheimnisse auf Organisationsebene zu erstellen, musst Du `admin`-Zugriff haben. 
diff --git a/translations/de-DE/data/reusables/github-actions/permissions-statement-secrets-repository.md b/translations/de-DE/data/reusables/github-actions/permissions-statement-secrets-repository.md
index dc5195e8b6bf..dae26c9982f0 100644
--- a/translations/de-DE/data/reusables/github-actions/permissions-statement-secrets-repository.md
+++ b/translations/de-DE/data/reusables/github-actions/permissions-statement-secrets-repository.md
@@ -1 +1 @@
-Um Geheimnisse für ein Benutzerkonto-Repository zu erstellen, musst Du der Repository-Inhaber sein. Um Geheimnisse für ein Organisations-Repository zu erstellen, musst Du `admin`-Zugriff haben.
\ No newline at end of file
+Um Geheimnisse für ein Benutzerkonto-Repository zu erstellen, musst Du der Repository-Inhaber sein. Um Geheimnisse für ein Organisations-Repository zu erstellen, musst Du `admin`-Zugriff haben.
diff --git a/translations/de-DE/data/reusables/github-actions/private-repository-forks-overview.md b/translations/de-DE/data/reusables/github-actions/private-repository-forks-overview.md
index 716a64703f20..1664f904ecca 100644
--- a/translations/de-DE/data/reusables/github-actions/private-repository-forks-overview.md
+++ b/translations/de-DE/data/reusables/github-actions/private-repository-forks-overview.md
@@ -2,4 +2,4 @@ If you rely on using forks of your private repositories, you can configure polic
 
 - **Run workflows from fork pull requests** - Allows users to run workflows from fork pull requests, using a `GITHUB_TOKEN` with read-only permission, and with no access to secrets.
 - **Send write tokens to workflows from pull requests** - Allows pull requests from forks to use a `GITHUB_TOKEN` with write permission.
-- **Send secrets to workflows from pull requests** - Makes all secrets available to the pull request.
\ No newline at end of file
+- **Send secrets to workflows from pull requests** - Makes all secrets available to the pull request.
diff --git a/translations/de-DE/data/reusables/github-actions/publish-to-maven-workflow-step.md b/translations/de-DE/data/reusables/github-actions/publish-to-maven-workflow-step.md
index 1a695fd7f547..15b5012f6615 100644
--- a/translations/de-DE/data/reusables/github-actions/publish-to-maven-workflow-step.md
+++ b/translations/de-DE/data/reusables/github-actions/publish-to-maven-workflow-step.md
@@ -1 +1 @@
-Führt den `mvn -B deploy` Befehl aus um das `ossrh` Repository zu veröffentlichen. Die Umgebungsvariable `MAVEN_USERNAME` wird mit dem Inhalt Deines Geheimnisses `OSSRH_USERNAME` gefüllt, und die Umgebungsvariable `MAVEN_PASSWORD` wird mit dem Inhalt Deines Geheimnisses `OSSRH_TOKEN` gefüllt.
\ No newline at end of file
+Führt den `mvn -B deploy` Befehl aus um das `ossrh` Repository zu veröffentlichen. Die Umgebungsvariable `MAVEN_USERNAME` wird mit dem Inhalt Deines Geheimnisses `OSSRH_USERNAME` gefüllt, und die Umgebungsvariable `MAVEN_PASSWORD` wird mit dem Inhalt Deines Geheimnisses `OSSRH_TOKEN` gefüllt.
diff --git a/translations/de-DE/data/reusables/github-actions/publish-to-packages-workflow-step.md b/translations/de-DE/data/reusables/github-actions/publish-to-packages-workflow-step.md
index 9fbab7701c5b..8c832b711a77 100644
--- a/translations/de-DE/data/reusables/github-actions/publish-to-packages-workflow-step.md
+++ b/translations/de-DE/data/reusables/github-actions/publish-to-packages-workflow-step.md
@@ -1 +1 @@
-Führt den Befehl `mvn -B deploy` aus, um nach {% data variables.product.prodname_registry %} zu veröffentlichen. Die `GITHUB_TOKEN`-Umgebungsvariable wird mit dem Inhalt des `GITHUB_TOKEN`-Geheimnisses gesetzt.
\ No newline at end of file
+Führt den Befehl `mvn -B deploy` aus, um nach {% data variables.product.prodname_registry %} zu veröffentlichen. Die `GITHUB_TOKEN`-Umgebungsvariable wird mit dem Inhalt des `GITHUB_TOKEN`-Geheimnisses gesetzt.
diff --git a/translations/de-DE/data/reusables/github-actions/publishing-java-packages-intro.md b/translations/de-DE/data/reusables/github-actions/publishing-java-packages-intro.md
index 1fedff3e3aaa..fdbd511d9b04 100644
--- a/translations/de-DE/data/reusables/github-actions/publishing-java-packages-intro.md
+++ b/translations/de-DE/data/reusables/github-actions/publishing-java-packages-intro.md
@@ -1 +1 @@
-Diese Anleitung zeigt, wie Du einen Workflow erstellst, der Java-Pakete in das {% data variables.product.prodname_registry %} und das Maven Central Repository veröffentlicht. Mit einem einzelnen Workflow kannst Du Pakete in ein einzelnes oder in mehrere Repositorys veröffentlichen.
\ No newline at end of file
+Diese Anleitung zeigt, wie Du einen Workflow erstellst, der Java-Pakete in das {% data variables.product.prodname_registry %} und das Maven Central Repository veröffentlicht. Mit einem einzelnen Workflow kannst Du Pakete in ein einzelnes oder in mehrere Repositorys veröffentlichen.
diff --git a/translations/de-DE/data/reusables/github-actions/run_id_description.md b/translations/de-DE/data/reusables/github-actions/run_id_description.md
index fd5f67f6d682..8b76d9959365 100644
--- a/translations/de-DE/data/reusables/github-actions/run_id_description.md
+++ b/translations/de-DE/data/reusables/github-actions/run_id_description.md
@@ -1 +1 @@
-Eine eindeutige Nummer für jede Ausführung innerhalb eines Repository. Diese Nummer ändert sich nicht, wenn Du den Workflowablauf erneut ausführst.
\ No newline at end of file
+Eine eindeutige Nummer für jede Ausführung innerhalb eines Repository. Diese Nummer ändert sich nicht, wenn Du den Workflowablauf erneut ausführst.
diff --git a/translations/de-DE/data/reusables/github-actions/run_number_description.md b/translations/de-DE/data/reusables/github-actions/run_number_description.md
index 2edd1691ce3f..39c8b844ee8c 100644
--- a/translations/de-DE/data/reusables/github-actions/run_number_description.md
+++ b/translations/de-DE/data/reusables/github-actions/run_number_description.md
@@ -1 +1 @@
-Eine eindeutige Nummer für jede Ausführung eines bestimmten Workflows in einem Repository. Diese Nummer beginnt bei 1 für die erste Ausführung des Workflows und erhöht sich mit jeder neuen Ausführung. Diese Nummer ändert sich nicht, wenn Du den Workflowablauf erneut ausführst.
\ No newline at end of file
+Eine eindeutige Nummer für jede Ausführung eines bestimmten Workflows in einem Repository. Diese Nummer beginnt bei 1 für die erste Ausführung des Workflows und erhöht sich mit jeder neuen Ausführung. Diese Nummer ändert sich nicht, wenn Du den Workflowablauf erneut ausführst.
diff --git a/translations/de-DE/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md b/translations/de-DE/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md
index 538d2771f7e0..97614dd5e5ae 100644
--- a/translations/de-DE/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md
+++ b/translations/de-DE/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md
@@ -1,2 +1,2 @@
 1. In the **Self-hosted runners** section of the settings page, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} next to the runner group you'd like to configure, then click **Edit name and [organization|repository] access**. ![Repository-Berechtigungen verwalten](/assets/images/help/settings/actions-runner-manage-permissions.png)
-1. Select a new policy from the dropdown list, or modify the runner group name.
\ No newline at end of file
+1. Select a new policy from the dropdown list, or modify the runner group name.
diff --git a/translations/de-DE/data/reusables/github-actions/self-hosted-runner-list-group.md b/translations/de-DE/data/reusables/github-actions/self-hosted-runner-list-group.md
index b86a8be047bc..b1512186b608 100644
--- a/translations/de-DE/data/reusables/github-actions/self-hosted-runner-list-group.md
+++ b/translations/de-DE/data/reusables/github-actions/self-hosted-runner-list-group.md
@@ -1 +1 @@
-1. If your runner is in a group, locate the runner group and click {% octicon "chevron-down" aria-label="The downward chevron" %} to view the list of runners. ![List runner group](/assets/images/help/settings/actions-org-enterprise-list-group-runners.png)
\ No newline at end of file
+1. If your runner is in a group, locate the runner group and click {% octicon "chevron-down" aria-label="The downward chevron" %} to view the list of runners. ![List runner group](/assets/images/help/settings/actions-org-enterprise-list-group-runners.png)
diff --git a/translations/de-DE/data/reusables/github-actions/self-hosted-runner-list.md b/translations/de-DE/data/reusables/github-actions/self-hosted-runner-list.md
index 315f976b7614..3e0ee5b85253 100644
--- a/translations/de-DE/data/reusables/github-actions/self-hosted-runner-list.md
+++ b/translations/de-DE/data/reusables/github-actions/self-hosted-runner-list.md
@@ -1 +1 @@
- 1. Locate the list of runners under "Self-hosted runners".
\ No newline at end of file
+ 1. Locate the list of runners under "Self-hosted runners".
diff --git a/translations/de-DE/data/reusables/github-actions/self-hosted-runner-management-permissions-required.md b/translations/de-DE/data/reusables/github-actions/self-hosted-runner-management-permissions-required.md
index 8e56b67d417c..3c69be1b97e4 100644
--- a/translations/de-DE/data/reusables/github-actions/self-hosted-runner-management-permissions-required.md
+++ b/translations/de-DE/data/reusables/github-actions/self-hosted-runner-management-permissions-required.md
@@ -1,4 +1,4 @@
-Ein selbst-gehosteter Läufer kann entweder in Deinen Organisations- oder Repository-Einstellungen auf {% data variables.product.prodname_dotcom %} gefunden werden. Um einen selbst-gehosteten Läufer zu verwalten, musst Du über die folgenden Berechtigungen verfügen, abhängig davon, wo der selbst-gehostete Läufer hinzugefügt wurde:
+A self-hosted runner can be located in either your repository, organization, or {% if currentVersion == "free-pro-team@latest" %}enterprise account settings on {% data variables.product.prodname_dotcom %}{% else if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %} enterprise settings on {% data variables.product.product_location %}{% endif %}. Um einen selbst-gehosteten Läufer zu verwalten, musst Du über die folgenden Berechtigungen verfügen, abhängig davon, wo der selbst-gehostete Läufer hinzugefügt wurde:
 - **User repository**: You must be the repository owner.
 - **Organization**: You must be an organization owner.
 - **Organization repository**: You must be an organization owner, or have admin access to the repository.
diff --git a/translations/de-DE/data/reusables/github-actions/self-hosted-runner-navigate-repo-and-org.md b/translations/de-DE/data/reusables/github-actions/self-hosted-runner-navigate-repo-and-org.md
index 4201e76a784c..93b6da6b96f2 100644
--- a/translations/de-DE/data/reusables/github-actions/self-hosted-runner-navigate-repo-and-org.md
+++ b/translations/de-DE/data/reusables/github-actions/self-hosted-runner-navigate-repo-and-org.md
@@ -1 +1 @@
-1. Navigiere in Deiner Organisation oder Deinem Repository zur Hauptseite, und klicke auf {% octicon "gear" aria-label="The Settings gear" %} **Settings** (Einstellungen).
\ No newline at end of file
+1. Navigiere in Deiner Organisation oder Deinem Repository zur Hauptseite, und klicke auf {% octicon "gear" aria-label="The Settings gear" %} **Settings** (Einstellungen).
diff --git a/translations/de-DE/data/reusables/github-actions/self-hosted-runner-removal-impact.md b/translations/de-DE/data/reusables/github-actions/self-hosted-runner-removal-impact.md
index 581966322d9a..fd467b44be10 100644
--- a/translations/de-DE/data/reusables/github-actions/self-hosted-runner-removal-impact.md
+++ b/translations/de-DE/data/reusables/github-actions/self-hosted-runner-removal-impact.md
@@ -1 +1 @@
-Dieses Verfahren entfernt den selbst-gehosteten Läufer dauerhaft. Wenn Du nur vorübergehend verhindern möchtest, dass einem Läufer Aufträge zugewiesen werden, kannst Du entweder die Maschine herunterfahren oder die `run` Applikation beenden. Der Läufer bleibt im Status "Offline" zugewiesen und wird keine Aufträge ausführen, bis Du den Läufer mit der `run` Anwendung neu startest.
\ No newline at end of file
+Dieses Verfahren entfernt den selbst-gehosteten Läufer dauerhaft. Wenn Du nur vorübergehend verhindern möchtest, dass einem Läufer Aufträge zugewiesen werden, kannst Du entweder die Maschine herunterfahren oder die `run` Applikation beenden. Der Läufer bleibt im Status "Offline" zugewiesen und wird keine Aufträge ausführen, bis Du den Läufer mit der `run` Anwendung neu startest.
diff --git a/translations/de-DE/data/reusables/github-actions/self-hosted-runner-reusing.md b/translations/de-DE/data/reusables/github-actions/self-hosted-runner-reusing.md
index 0435ac7bb9ec..c15c029bdca3 100644
--- a/translations/de-DE/data/reusables/github-actions/self-hosted-runner-reusing.md
+++ b/translations/de-DE/data/reusables/github-actions/self-hosted-runner-reusing.md
@@ -1 +1 @@
-Alternatively, if you don't have access to the repository, organization, or enterprise on {% data variables.product.product_name %} to remove a runner, but you would like to re-use the runner machine, then you can delete the `.runner` file inside the self-hosted runner application directory. This allows the runner to be registered without having to re-download the self-hosted runner application.
\ No newline at end of file
+Alternatively, if you don't have access to the repository, organization, or enterprise on {% data variables.product.product_name %} to remove a runner, but you would like to re-use the runner machine, then you can delete the `.runner` file inside the self-hosted runner application directory. This allows the runner to be registered without having to re-download the self-hosted runner application.
diff --git a/translations/de-DE/data/reusables/github-actions/sidebar-secret.md b/translations/de-DE/data/reusables/github-actions/sidebar-secret.md
index 6970a541ced2..ce81235c73bd 100644
--- a/translations/de-DE/data/reusables/github-actions/sidebar-secret.md
+++ b/translations/de-DE/data/reusables/github-actions/sidebar-secret.md
@@ -1 +1 @@
-1. Klicken Sie auf der linken Seitenleiste auf **Secrets** (Geheimnisse).
\ No newline at end of file
+1. Klicken Sie auf der linken Seitenleiste auf **Secrets** (Geheimnisse).
diff --git a/translations/de-DE/data/reusables/github-actions/spending-limit-enterprise-account.md b/translations/de-DE/data/reusables/github-actions/spending-limit-enterprise-account.md
index 1696b89f3faa..cadc645c0943 100644
--- a/translations/de-DE/data/reusables/github-actions/spending-limit-enterprise-account.md
+++ b/translations/de-DE/data/reusables/github-actions/spending-limit-enterprise-account.md
@@ -1 +1 @@
-Wenn Du Dein Enterprise-Konto per Rechnung bezahlst, kannst Du das Ausgabenlimit für Dein Enterprise-Konto auf {% data variables.product.product_name %} nicht verwalten. Wenn Du Organisationen im Besitz Deines Enterprise-Konto erlauben willst, {% data variables.product.prodname_actions %} über die in ihren Konten enthaltenen Speicher oder Datenübertragungen hinaus zu benutzen, kannst Du für Überschreitungen im Voraus bezahlen. Da Überschreitungen im Voraus bezahlt werden müssen, kannst Du keine unbegrenzten Ausgaben für Konten aktivieren, die per Rechnung bezahlt werden. Dein Ausgabenlimit beträgt 150 % des Betrags, den Du im Voraus bezahlt hast. Wenn Du Fragen hast, [wende Dich an unser Kundendienstteam](https://enterprise.github.com/contact).
+Wenn Du Dein Enterprise-Konto per Rechnung bezahlst, kannst Du das Ausgabenlimit für Dein Enterprise-Konto nicht auf {% data variables.product.product_name %} verwalten. Wenn Du Organisationen im Besitz Deines Enterprise-Konto erlauben willst, {% data variables.product.prodname_actions %} über die in ihren Konten enthaltenen Speicher oder Datenübertragungen hinaus zu benutzen, kannst Du für Überschreitungen im Voraus bezahlen. Da Überschreitungen im Voraus bezahlt werden müssen, kannst Du keine unbegrenzten Ausgaben für Konten aktivieren, die per Rechnung bezahlt werden. Dein Ausgabenlimit beträgt 150 % des Betrags, den Du im Voraus bezahlt hast. Wenn Du Fragen hast, [wende Dich an unser Kundendienstteam](https://enterprise.github.com/contact).
diff --git a/translations/de-DE/data/reusables/github-actions/usage-api-requests.md b/translations/de-DE/data/reusables/github-actions/usage-api-requests.md
new file mode 100644
index 000000000000..dc1859f68b01
--- /dev/null
+++ b/translations/de-DE/data/reusables/github-actions/usage-api-requests.md
@@ -0,0 +1 @@
+- **API requests** (API Anfragen) - Pro Stunde kannst Du bis zu 1000 API-Anfragen über alle Aktionen innerhalb innerhalb eines Repository ausführen. Bei Überschreitung schlagen zusätzliche API-Aufrufe fehl, was dazu führen kann, dass Aufträge fehlschlagen.
diff --git a/translations/de-DE/data/reusables/github-actions/usage-matrix-limits.md b/translations/de-DE/data/reusables/github-actions/usage-matrix-limits.md
new file mode 100644
index 000000000000..73eaef2f9ceb
--- /dev/null
+++ b/translations/de-DE/data/reusables/github-actions/usage-matrix-limits.md
@@ -0,0 +1 @@
+- **Job matrix** - A job matrix can generate a maximum of 256 jobs per workflow run. Dieses Limit gilt auch für selbst-gehostete Läufer.
diff --git a/translations/de-DE/data/reusables/github-actions/usage-workflow-run-time.md b/translations/de-DE/data/reusables/github-actions/usage-workflow-run-time.md
new file mode 100644
index 000000000000..049ca4e5e04e
--- /dev/null
+++ b/translations/de-DE/data/reusables/github-actions/usage-workflow-run-time.md
@@ -0,0 +1 @@
+- **Workflow run time** (Workflow-Laufzeit) - Jede Workflow-Ausführung ist auf 72 Stunden begrenzt. Wenn eine Workflow-Ausführung diesen Grenzwert erreicht, wird die Workflow-Ausführung abgebrochen.
diff --git a/translations/de-DE/data/reusables/github-connect/access-dotcom-and-enterprise.md b/translations/de-DE/data/reusables/github-connect/access-dotcom-and-enterprise.md
index 21e6f6b68e17..2d9a75adb7bd 100644
--- a/translations/de-DE/data/reusables/github-connect/access-dotcom-and-enterprise.md
+++ b/translations/de-DE/data/reusables/github-connect/access-dotcom-and-enterprise.md
@@ -1 +1 @@
-1. Melden Sie sich bei {% data variables.product.product_location_enterprise %} und {% data variables.product.prodname_dotcom_the_website %} an.
+1. Melden Dich bei {% data variables.product.product_location_enterprise %} und {% data variables.product.prodname_dotcom_the_website %} an.
diff --git a/translations/de-DE/data/reusables/github-connect/github-connect-tab-user-settings.md b/translations/de-DE/data/reusables/github-connect/github-connect-tab-user-settings.md
index 35077afce80f..91ee8a486193 100644
--- a/translations/de-DE/data/reusables/github-connect/github-connect-tab-user-settings.md
+++ b/translations/de-DE/data/reusables/github-connect/github-connect-tab-user-settings.md
@@ -1 +1 @@
-1. Klicke auf der linken Seitenleiste auf **{% data variables.product.prodname_github_connect %}**. ![Registerkarte „GitHub Connect" in der Seitenleiste der Benutzereinstellungen](/assets/images/help/settings/github-connect-tab-user-settings.png)
+1. Klicken Sie auf der linken Seitenleiste auf **{% data variables.product.prodname_github_connect %}**. ![Registerkarte „GitHub Connect" in der Seitenleiste der Benutzereinstellungen](/assets/images/help/settings/github-connect-tab-user-settings.png)
diff --git a/translations/de-DE/data/reusables/github-insights/choose-key-metric.md b/translations/de-DE/data/reusables/github-insights/choose-key-metric.md
index b5ebf8863030..1dec2494458d 100644
--- a/translations/de-DE/data/reusables/github-insights/choose-key-metric.md
+++ b/translations/de-DE/data/reusables/github-insights/choose-key-metric.md
@@ -1 +1 @@
-2. Klicke unter **{% octicon "graph" aria-label="The graph icon" %} Key metrics** (Schlüsselmetriken) auf den Namen der Metrik, die Du anzeigen möchtest. ![Liste der Schlüsselmetriken](/assets/images/help/insights/key-metrics-list.png)
\ No newline at end of file
+2. Klicke unter **{% octicon "graph" aria-label="The graph icon" %} Key metrics** (Schlüsselmetriken) auf den Namen der Metrik, die Du anzeigen möchtest. ![Liste der Schlüsselmetriken](/assets/images/help/insights/key-metrics-list.png)
diff --git a/translations/de-DE/data/reusables/github-insights/enterprise-api-url.md b/translations/de-DE/data/reusables/github-insights/enterprise-api-url.md
index 2342d5569c15..3fdaff9e488e 100644
--- a/translations/de-DE/data/reusables/github-insights/enterprise-api-url.md
+++ b/translations/de-DE/data/reusables/github-insights/enterprise-api-url.md
@@ -1 +1 @@
-1. Unter „{% data variables.product.prodname_dotcom %} API URL", tippe {% if currentVersion == "free-pro-team@latest" %}https://api.github.com {% else %}die URL die Du zum Zugriff auf {% data variables.product.prodname_enterprise %} verwendest{% endif %}. ![{% data variables.product.prodname_enterprise %} API URL Feld](/assets/images/help/insights/enterprise-api-url.png)
+1. Under "{% data variables.product.prodname_dotcom %} API URL", type {% if currentVersion == "free-pro-team@latest" %}https://api.github.com {% else %}the URL you use to access {% data variables.product.prodname_enterprise %}{% endif %}. ![{% data variables.product.prodname_enterprise %} API URL Feld](/assets/images/help/insights/enterprise-api-url.png)
diff --git a/translations/de-DE/data/reusables/github-insights/navigate-to-key-metrics.md b/translations/de-DE/data/reusables/github-insights/navigate-to-key-metrics.md
index 1155c7182b22..2364c643e57e 100644
--- a/translations/de-DE/data/reusables/github-insights/navigate-to-key-metrics.md
+++ b/translations/de-DE/data/reusables/github-insights/navigate-to-key-metrics.md
@@ -1 +1 @@
-1. Klicke in {% data variables.product.prodname_insights %} auf **{% octicon "graph" aria-label="The graph icon" %} Key Metrics** (Schlüsselmetriken). ![Registerkarte „Key metrics" (Schlüsselmetriken)](/assets/images/help/insights/key-metrics-tab.png)
\ No newline at end of file
+1. Klicke in {% data variables.product.prodname_insights %} auf **{% octicon "graph" aria-label="The graph icon" %} Key Metrics** (Schlüsselmetriken). ![Registerkarte „Key metrics" (Schlüsselmetriken)](/assets/images/help/insights/key-metrics-tab.png)
diff --git a/translations/de-DE/data/reusables/gpg/private-email.md b/translations/de-DE/data/reusables/gpg/private-email.md
index 0dde058d1eb9..15ea1833856c 100644
--- a/translations/de-DE/data/reusables/gpg/private-email.md
+++ b/translations/de-DE/data/reusables/gpg/private-email.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-Um Deine E-Mail-Adresse privat zu halten, verwende Deine von {% data variables.product.product_name %} bereitgestellte `no-reply` E-Mail-Adresse.
+To keep your email address private, use your
+{% data variables.product.product_name %}-provided `no-reply` email address.
 {% endif %}
diff --git a/translations/de-DE/data/reusables/identity-and-permissions/enable-team-sync-azure.md b/translations/de-DE/data/reusables/identity-and-permissions/enable-team-sync-azure.md
index 26ef946db550..4ce08f9f5098 100644
--- a/translations/de-DE/data/reusables/identity-and-permissions/enable-team-sync-azure.md
+++ b/translations/de-DE/data/reusables/identity-and-permissions/enable-team-sync-azure.md
@@ -1 +1 @@
-1. Klicke unter „Team synchronization“ (Teamsynchronisierung) auf **Enable for Azure AD** (Für Azure AD aktivieren). ![Schaltfläche „Enable team synchronization" (Aktivieren der Teamsynchronisierung) auf der Seite der Sicherheitseinstellungen](/assets/images/help/teams/enable-team-synchronization.png)
\ No newline at end of file
+1. Klicke unter „Team synchronization“ (Teamsynchronisierung) auf **Enable for Azure AD** (Für Azure AD aktivieren). ![Schaltfläche „Enable team synchronization" (Aktivieren der Teamsynchronisierung) auf der Seite der Sicherheitseinstellungen](/assets/images/help/teams/enable-team-synchronization.png)
diff --git a/translations/de-DE/data/reusables/identity-and-permissions/enable-team-sync-okta.md b/translations/de-DE/data/reusables/identity-and-permissions/enable-team-sync-okta.md
index 64da61dc12ad..b23a98e8b100 100644
--- a/translations/de-DE/data/reusables/identity-and-permissions/enable-team-sync-okta.md
+++ b/translations/de-DE/data/reusables/identity-and-permissions/enable-team-sync-okta.md
@@ -1 +1 @@
-1. Klicke unter „Team synchronization“ (Teamsynchronisierung) auf **Enable for Okta** (Für Okta aktivieren). ![Schaltfläche zum Aktivieren der Teamsynchronisierung für Okta auf der Seite der Sicherheitseinstellungen](/assets/images/help/teams/enable-team-synchronization-okta.png)
\ No newline at end of file
+1. Klicke unter „Team synchronization“ (Teamsynchronisierung) auf **Enable for Okta** (Für Okta aktivieren). ![Schaltfläche zum Aktivieren der Teamsynchronisierung für Okta auf der Seite der Sicherheitseinstellungen](/assets/images/help/teams/enable-team-synchronization-okta.png)
diff --git a/translations/de-DE/data/reusables/identity-and-permissions/supported-idps-team-sync.md b/translations/de-DE/data/reusables/identity-and-permissions/supported-idps-team-sync.md
index 308ca8550648..cad7192e782b 100644
--- a/translations/de-DE/data/reusables/identity-and-permissions/supported-idps-team-sync.md
+++ b/translations/de-DE/data/reusables/identity-and-permissions/supported-idps-team-sync.md
@@ -1,3 +1,3 @@
 Du kannst Teamsynchronisierung mit unterstützten IdPs verwenden.
   - Azure AD
-  - Okta
\ No newline at end of file
+  - Okta
diff --git a/translations/de-DE/data/reusables/identity-and-permissions/sync-team-with-idp-group.md b/translations/de-DE/data/reusables/identity-and-permissions/sync-team-with-idp-group.md
index bf46f045c14c..844ef0a42cb9 100644
--- a/translations/de-DE/data/reusables/identity-and-permissions/sync-team-with-idp-group.md
+++ b/translations/de-DE/data/reusables/identity-and-permissions/sync-team-with-idp-group.md
@@ -1 +1 @@
-Nachdem Du die Teamsynchronisierung aktiviert hast, können Team-Betreuer und Organisationsinhaber ein Team auf {% data variables.product.prodname_dotcom %} oder mit dem API zu einer IdP-Gruppe verbinden. For more information, see "[Synchronizing a team with an identity provider group](/github/setting-up-and-managing-organizations-and-teams/synchronizing-a-team-with-an-identity-provider-group)" and "[Team synchronization](/v3/teams/team_sync/)."
\ No newline at end of file
+Nachdem Du die Teamsynchronisierung aktiviert hast, können Team-Betreuer und Organisationsinhaber ein Team auf {% data variables.product.prodname_dotcom %} oder mit dem API zu einer IdP-Gruppe verbinden. For more information, see "[Synchronizing a team with an identity provider group](/github/setting-up-and-managing-organizations-and-teams/synchronizing-a-team-with-an-identity-provider-group)" and "[Team synchronization](/v3/teams/team_sync/)."
diff --git a/translations/de-DE/data/reusables/identity-and-permissions/team-sync-disable.md b/translations/de-DE/data/reusables/identity-and-permissions/team-sync-disable.md
index ec61c9939016..fcb6337a09ad 100644
--- a/translations/de-DE/data/reusables/identity-and-permissions/team-sync-disable.md
+++ b/translations/de-DE/data/reusables/identity-and-permissions/team-sync-disable.md
@@ -2,4 +2,4 @@
 
 **Warnung:** Wenn Du die Teamsynchronisierung deaktivierst, werden alle Teammitglieder, die über eine IdP-Gruppe zu einem {% data variables.product.prodname_dotcom %}-Team hinzugefügt wurden, aus diesem Team entfernt und verlieren allenfalls den Zugriff auf Repositorys.
 
-{% endwarning %}
\ No newline at end of file
+{% endwarning %}
diff --git a/translations/de-DE/data/reusables/identity-and-permissions/team-sync-okta-requirements.md b/translations/de-DE/data/reusables/identity-and-permissions/team-sync-okta-requirements.md
index 83b18c88bffb..8d49b27a6368 100644
--- a/translations/de-DE/data/reusables/identity-and-permissions/team-sync-okta-requirements.md
+++ b/translations/de-DE/data/reusables/identity-and-permissions/team-sync-okta-requirements.md
@@ -2,4 +2,4 @@ Um die Teamsynchronisierung für Okta zu aktivieren, müssen Du oder Dein IdP-Ad
 
 - SAML SSO und SCIM für Deine Organisation mit Okta aktivieren. Weitere Informationen findest Du unter „[SAML Single Sign-On und SCIM mit Okta konfigurieren](/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta)."
 - Die Mandanten-URL für Deine Okta-Instanz angeben.
-- Einen gültigen SSWS-Token generieren, der über schreibgeschützte Administratorberechtigungen für Deine Okta-Installation als ein Dienstbenutzer verfügt. Weitere Informationen findest Du unter [Token erstellen](https://developer.okta.com/docs/guides/create-an-api-token/create-the-token/) und [Dienstbenutzer](https://help.okta.com/en/prod/Content/Topics/Adv_Server_Access/docs/service-users.htm) in der Okta-Dokumentation.
\ No newline at end of file
+- Einen gültigen SSWS-Token generieren, der über schreibgeschützte Administratorberechtigungen für Deine Okta-Installation als ein Dienstbenutzer verfügt. Weitere Informationen findest Du unter [Token erstellen](https://developer.okta.com/docs/guides/create-an-api-token/create-the-token/) und [Dienstbenutzer](https://help.okta.com/en/prod/Content/Topics/Adv_Server_Access/docs/service-users.htm) in der Okta-Dokumentation.
diff --git a/translations/de-DE/data/reusables/interactions/collaborator-user-limit-definition.md b/translations/de-DE/data/reusables/interactions/collaborator-user-limit-definition.md
index 62f4c861d7f2..718a221e6f7c 100644
--- a/translations/de-DE/data/reusables/interactions/collaborator-user-limit-definition.md
+++ b/translations/de-DE/data/reusables/interactions/collaborator-user-limit-definition.md
@@ -1 +1 @@
-**Collaborators only:** When you limit interactions to `collaborators_only`, users who are not collaborators will be temporarily restricted
\ No newline at end of file
+**Collaborators only:** When you limit interactions to `collaborators_only`, users who are not collaborators will be temporarily restricted
diff --git a/translations/de-DE/data/reusables/interactions/contributor-user-limit-definition.md b/translations/de-DE/data/reusables/interactions/contributor-user-limit-definition.md
index 134e152c9ee9..e750eb466295 100644
--- a/translations/de-DE/data/reusables/interactions/contributor-user-limit-definition.md
+++ b/translations/de-DE/data/reusables/interactions/contributor-user-limit-definition.md
@@ -1 +1 @@
-**Contributors only:** When you limit interactions to `contributors_only`,  users who have not previously contributed and are not collaborators will be temporarily restricted
\ No newline at end of file
+**Contributors only:** When you limit interactions to `contributors_only`,  users who have not previously contributed and are not collaborators will be temporarily restricted
diff --git a/translations/de-DE/data/reusables/interactions/existing-user-limit-definition.md b/translations/de-DE/data/reusables/interactions/existing-user-limit-definition.md
index 54c7d8b0b5f6..b921d4455547 100644
--- a/translations/de-DE/data/reusables/interactions/existing-user-limit-definition.md
+++ b/translations/de-DE/data/reusables/interactions/existing-user-limit-definition.md
@@ -1 +1 @@
-**Existing users:** When you limit interactions to `existing_users`, new users with accounts less than 24 hours old who have not previously contributed and are not collaborators will be temporarily restricted
\ No newline at end of file
+**Existing users:** When you limit interactions to `existing_users`, new users with accounts less than 24 hours old who have not previously contributed and are not collaborators will be temporarily restricted
diff --git a/translations/de-DE/data/reusables/interactions/interactions-detail.md b/translations/de-DE/data/reusables/interactions/interactions-detail.md
index 95ef4c017e4f..9193cd04e704 100644
--- a/translations/de-DE/data/reusables/interactions/interactions-detail.md
+++ b/translations/de-DE/data/reusables/interactions/interactions-detail.md
@@ -1 +1 @@
-When restrictions are enabled, only the specified group of {% data variables.product.product_name %} users will be able to participate in interactions. Restrictions expire 24 hours from the time they are set.
\ No newline at end of file
+When restrictions are enabled, only the specified group of {% data variables.product.product_name %} users will be able to participate in interactions. Restrictions expire 24 hours from the time they are set.
diff --git a/translations/de-DE/data/reusables/issue-events/assignee-properties.md b/translations/de-DE/data/reusables/issue-events/assignee-properties.md
index e408d915e266..60f612d89caf 100644
--- a/translations/de-DE/data/reusables/issue-events/assignee-properties.md
+++ b/translations/de-DE/data/reusables/issue-events/assignee-properties.md
@@ -1 +1 @@
-`assignee` | `object` | The person unassigned from this issue. `assigner` | `object` | The person who performed the unassignment for this issue.
\ No newline at end of file
+`assignee` | `object` | The person unassigned from this issue. `assigner` | `object` | The person who performed the unassignment for this issue.
diff --git a/translations/de-DE/data/reusables/issue-events/issue-event-common-properties.md b/translations/de-DE/data/reusables/issue-events/issue-event-common-properties.md
index 57f2e8434435..db148568908e 100644
--- a/translations/de-DE/data/reusables/issue-events/issue-event-common-properties.md
+++ b/translations/de-DE/data/reusables/issue-events/issue-event-common-properties.md
@@ -7,4 +7,4 @@
 | `event`      | `string`  | Identifies the actual type of event that occurred.                   |
 | `commit_id`  | `string`  | The SHA of the commit that referenced this issue.                    |
 | `commit_url` | `string`  | The GitHub REST API link to the commit that referenced this issue.   |
-| `created_at` | `string`  | The timestamp indicating when the event occurred.                    |
\ No newline at end of file
+| `created_at` | `string`  | The timestamp indicating when the event occurred.                    |
diff --git a/translations/de-DE/data/reusables/issue-events/label-properties.md b/translations/de-DE/data/reusables/issue-events/label-properties.md
index 1d616889b1a1..e97ef30a880b 100644
--- a/translations/de-DE/data/reusables/issue-events/label-properties.md
+++ b/translations/de-DE/data/reusables/issue-events/label-properties.md
@@ -1 +1 @@
-`label` | `object` | The label removed from the issue `label[name]` | `string` | The name of the label. `label[color]` | `string` | The hex color code. 
\ No newline at end of file
+`label` | `object` | The label removed from the issue `label[name]` | `string` | The name of the label. `label[color]` | `string` | The hex color code. 
diff --git a/translations/de-DE/data/reusables/issue-events/project-card-properties.md b/translations/de-DE/data/reusables/issue-events/project-card-properties.md
index 646b6a85b558..457adf5eda1c 100644
--- a/translations/de-DE/data/reusables/issue-events/project-card-properties.md
+++ b/translations/de-DE/data/reusables/issue-events/project-card-properties.md
@@ -1 +1 @@
-`project_card` | `object` | The project card object. `project_id` | `integer` | The unique identifier of the project card. `project_url` | `string` | The REST API URL to retrieve the project card. `column_name` | `string` | The name of the column the issue is in.
\ No newline at end of file
+`project_card` | `object` | The project card object. `project_id` | `integer` | The unique identifier of the project card. `project_url` | `string` | The REST API URL to retrieve the project card. `column_name` | `string` | The name of the column the issue is in.
diff --git a/translations/de-DE/data/reusables/issue-events/review-dismissed-properties.md b/translations/de-DE/data/reusables/issue-events/review-dismissed-properties.md
index 9c6f67ec8671..7232cb9ea5d3 100644
--- a/translations/de-DE/data/reusables/issue-events/review-dismissed-properties.md
+++ b/translations/de-DE/data/reusables/issue-events/review-dismissed-properties.md
@@ -1 +1 @@
-`dismissed_review` | `object` | The information for the dismissed review. `dismissed_review[state]` | `string` | The state the pull request was in when it was dismissed. Can be one of: `commented`, `approved`, or `changes_requested`. `dismissed_review[review_id]` | `string` | The unique identifier of the pull request's review. `dismissed_review[dismissal_message]` | `string` | The message the user included when dismissing the review. `dismissed_review[dismissal_commit_id]` | `string` | The unique identifier of the commit that dismissed the review if one exists.
\ No newline at end of file
+`dismissed_review` | `object` | The information for the dismissed review. `dismissed_review[state]` | `string` | The state the pull request was in when it was dismissed. Can be one of: `commented`, `approved`, or `changes_requested`. `dismissed_review[review_id]` | `string` | The unique identifier of the pull request's review. `dismissed_review[dismissal_message]` | `string` | The message the user included when dismissing the review. `dismissed_review[dismissal_commit_id]` | `string` | The unique identifier of the commit that dismissed the review if one exists.
diff --git a/translations/de-DE/data/reusables/issue-events/review-request-properties.md b/translations/de-DE/data/reusables/issue-events/review-request-properties.md
index 350f0d3ff9dd..8821c8b69e8e 100644
--- a/translations/de-DE/data/reusables/issue-events/review-request-properties.md
+++ b/translations/de-DE/data/reusables/issue-events/review-request-properties.md
@@ -1 +1 @@
-`requested_reviewer` | `object` | The person requested to review the pull request. `review_requester` | `object` | The person who requested a review.
\ No newline at end of file
+`requested_reviewer` | `object` | The person requested to review the pull request. `review_requester` | `object` | The person who requested a review.
diff --git a/translations/de-DE/data/reusables/issue-events/timeline_events_object_properties.md b/translations/de-DE/data/reusables/issue-events/timeline_events_object_properties.md
index 43c03587e7df..c7877fcb46cb 100644
--- a/translations/de-DE/data/reusables/issue-events/timeline_events_object_properties.md
+++ b/translations/de-DE/data/reusables/issue-events/timeline_events_object_properties.md
@@ -1 +1 @@
-This events properties do not use the same structure as the [issue event object common properties](#issue-event-object-common-properties). The following properties are returned for this event.
\ No newline at end of file
+This events properties do not use the same structure as the [issue event object common properties](#issue-event-object-common-properties). The following properties are returned for this event.
diff --git a/translations/de-DE/data/reusables/large_files/can-include-lfs-objects-archives.md b/translations/de-DE/data/reusables/large_files/can-include-lfs-objects-archives.md
index f0f75e6ec5de..83a7278c3796 100644
--- a/translations/de-DE/data/reusables/large_files/can-include-lfs-objects-archives.md
+++ b/translations/de-DE/data/reusables/large_files/can-include-lfs-objects-archives.md
@@ -2,4 +2,4 @@
 
 You can choose whether {% data variables.large_files.product_name_long %}({% data variables.large_files.product_name_short %}) objects are included in source code archives, such as ZIP files and tarballs, that {% data variables.product.product_name %} creates for your repository. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)."
 
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/translations/de-DE/data/reusables/marketplace/cancellation-clarification.md b/translations/de-DE/data/reusables/marketplace/cancellation-clarification.md
index f4463ad23d57..80e164b90d61 100644
--- a/translations/de-DE/data/reusables/marketplace/cancellation-clarification.md
+++ b/translations/de-DE/data/reusables/marketplace/cancellation-clarification.md
@@ -1 +1 @@
-When a customer cancels a {% data variables.product.prodname_marketplace %} subscription, GitHub does not automatically uninstall the app, so the customer can expect that free features will continue to function.
\ No newline at end of file
+When a customer cancels a {% data variables.product.prodname_marketplace %} subscription, GitHub does not automatically uninstall the app, so the customer can expect that free features will continue to function.
diff --git a/translations/de-DE/data/reusables/marketplace/downgrade-marketplace-only.md b/translations/de-DE/data/reusables/marketplace/downgrade-marketplace-only.md
index 7578956dd967..62b1f0a98b2c 100644
--- a/translations/de-DE/data/reusables/marketplace/downgrade-marketplace-only.md
+++ b/translations/de-DE/data/reusables/marketplace/downgrade-marketplace-only.md
@@ -1 +1 @@
-Das Kündigen einer App oder das Herunterstufen auf kostenlos wirkt sich nicht auf Deine [anderen bezahlten Abonnements](/articles/about-billing-on-github) auf {% data variables.product.prodname_dotcom %} aus. Wenn Du alle kostenpflichtigen Abonnements auf {% data variables.product.prodname_dotcom %} beenden möchtest, musst Du jedes kostenpflichtige Abonnement separat herabstufen.
+Das Kündigen einer App oder das Herunterstufen auf kostenlos wirkt sich nicht auf Deine [anderen bezahlten Abonnements](/articles/about-billing-on-github) auf {% data variables.product.prodname_dotcom %} aus. Wenn Sie alle kostenpflichtigen Abonnements auf {% data variables.product.prodname_dotcom %} beenden möchten, müssen Sie jedes kostenpflichtige Abonnement separat herabstufen.
diff --git a/translations/de-DE/data/reusables/marketplace/github_apps_preferred.md b/translations/de-DE/data/reusables/marketplace/github_apps_preferred.md
index 04c37a99c9c5..c9ccbece0da2 100644
--- a/translations/de-DE/data/reusables/marketplace/github_apps_preferred.md
+++ b/translations/de-DE/data/reusables/marketplace/github_apps_preferred.md
@@ -1 +1 @@
-GitHub Apps are the officially recommended way to integrate with GitHub because they offer much more granular permissions to access data
\ No newline at end of file
+GitHub Apps are the officially recommended way to integrate with GitHub because they offer much more granular permissions to access data
diff --git a/translations/de-DE/data/reusables/marketplace/launch-with-free.md b/translations/de-DE/data/reusables/marketplace/launch-with-free.md
index b809c37a0e6a..15230e218b5e 100644
--- a/translations/de-DE/data/reusables/marketplace/launch-with-free.md
+++ b/translations/de-DE/data/reusables/marketplace/launch-with-free.md
@@ -1 +1 @@
-You can submit both an unverified and verified app. This will allow you to launch with a free version of your app. Once GitHub verifies your app, your listing will change from unverified to verified in {% data variables.product.prodname_marketplace %} and GitHub will publish your new pricing plans.
\ No newline at end of file
+You can submit both an unverified and verified app. This will allow you to launch with a free version of your app. Once GitHub verifies your app, your listing will change from unverified to verified in {% data variables.product.prodname_marketplace %} and GitHub will publish your new pricing plans.
diff --git a/translations/de-DE/data/reusables/marketplace/unverified-apps.md b/translations/de-DE/data/reusables/marketplace/unverified-apps.md
index d390a5e5eaf0..b7ce68277e1c 100644
--- a/translations/de-DE/data/reusables/marketplace/unverified-apps.md
+++ b/translations/de-DE/data/reusables/marketplace/unverified-apps.md
@@ -1 +1 @@
-Unverified apps are only offered with free plans. To list paid plans, you must submit a verified app.
\ No newline at end of file
+Unverified apps are only offered with free plans. To list paid plans, you must submit a verified app.
diff --git a/translations/de-DE/data/reusables/notifications-v2/email-notification-caveats.md b/translations/de-DE/data/reusables/notifications-v2/email-notification-caveats.md
index 90a4a2644361..6e908f898845 100644
--- a/translations/de-DE/data/reusables/notifications-v2/email-notification-caveats.md
+++ b/translations/de-DE/data/reusables/notifications-v2/email-notification-caveats.md
@@ -2,4 +2,4 @@ Sie erhalten nur Benachrichtigungs-E-Mails, wenn Sie E-Mail-Benachrichtigungen i
 
 {% if currentVersion == "free-pro-team@latest" %}
 {% data reusables.user_settings.verify-org-approved-email-domain %}
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/translations/de-DE/data/reusables/notifications-v2/manage-notifications.md b/translations/de-DE/data/reusables/notifications-v2/manage-notifications.md
index 9f53986d3562..a31eca29cf3d 100644
--- a/translations/de-DE/data/reusables/notifications-v2/manage-notifications.md
+++ b/translations/de-DE/data/reusables/notifications-v2/manage-notifications.md
@@ -1 +1 @@
-1. Verwende in der linken Seitenleiste unter der Liste der Repositories das Dropdownmenü "Manage notifications" (Benachrichtigungen verwalten), um auf **Notification settings** (Benachrichtigungseinstellungen) zu klicken. ![Dropdownmenü-Optionen „Manage Notifications" (Benachrichtigungen verwalten)](/assets/images/help/notifications-v2/manage-notifications-options.png)
\ No newline at end of file
+1. Verwende in der linken Seitenleiste unter der Liste der Repositories das Dropdownmenü "Manage notifications" (Benachrichtigungen verwalten), um auf **Notification settings** (Benachrichtigungseinstellungen) zu klicken. ![Dropdownmenü-Optionen „Manage Notifications" (Benachrichtigungen verwalten)](/assets/images/help/notifications-v2/manage-notifications-options.png)
diff --git a/translations/de-DE/data/reusables/notifications/shared_state.md b/translations/de-DE/data/reusables/notifications/shared_state.md
index 95ff976976a6..479d545eec64 100644
--- a/translations/de-DE/data/reusables/notifications/shared_state.md
+++ b/translations/de-DE/data/reusables/notifications/shared_state.md
@@ -1,5 +1,5 @@
 {% tip %}
 
-**Tipp:** Wenn Du sowohl Web- als auch E-Mail-Benachrichtigungen erhältst, kannst Du den Gelesen- oder Ungelesen-Status der Benachrichtigung automatisch synchronisieren, sodass Webbenachrichtigungen automatisch als gelesen markiert werden, sobald Du die entsprechende E-Mail-Benachrichtigung gelesen hast. Um diese Synchronisierung zu aktivieren, muss Dein E-Mail-Client Bilder von {% if currentVersion == "free-pro-team@latest" %}'`notifications@github.com`'{% else %}"der von Deinem Websiteadministrator konfigurierte No-Reply E-Mail-Adresse{% endif %} anzeigen können.
+**Tipp:** Wenn Du sowohl Web- als auch E-Mail-Benachrichtigungen erhältst, kannst Du den Gelesen- oder Ungelesen-Status der Benachrichtigung automatisch synchronisieren, sodass Webbenachrichtigungen automatisch als gelesen markiert werden, sobald Du die entsprechende E-Mail-Benachrichtigung gelesen hast. To enable this sync, your email client must be able to view images from {% if currentVersion == "free-pro-team@latest" %}'`notifications@github.com`'{% else %}'the no-reply email address configured by your site administrator'{% endif %}.
 
 {% endtip %}
diff --git a/translations/de-DE/data/reusables/organizations/can-require-ssh-cert.md b/translations/de-DE/data/reusables/organizations/can-require-ssh-cert.md
index 287861eea957..6da37763232e 100644
--- a/translations/de-DE/data/reusables/organizations/can-require-ssh-cert.md
+++ b/translations/de-DE/data/reusables/organizations/can-require-ssh-cert.md
@@ -1 +1 @@
-Du kannst festlegen, dass Mitglieder SSH-Zertifikate verwenden müssen, um auf die Organisationsressourcen zuzugreifen{% if currentVersion ver_gt "enterprise-server@2.17" %}, außer wenn SSH in Deinem Repository deaktiviert ist{% endif %}.
+You can require that members use SSH certificates to access organization resources,, unless SSH is disabled in your repository.
diff --git a/translations/de-DE/data/reusables/organizations/oauth_app_restrictions_default.md b/translations/de-DE/data/reusables/organizations/oauth_app_restrictions_default.md
index 34e618fce4eb..27f0cfc332ce 100644
--- a/translations/de-DE/data/reusables/organizations/oauth_app_restrictions_default.md
+++ b/translations/de-DE/data/reusables/organizations/oauth_app_restrictions_default.md
@@ -1 +1 @@
-{% if currentVersion == "free-pro-team@latest" %}Wenn Du eine neue Organisation erstellst, sind {% data variables.product.prodname_oauth_app %} Zugriffsbeschränkungen standardmäßig aktiviert. Organisationsinhaber können jederzeit [{% data variables.product.prodname_oauth_app %} Zugriffsbeschränkungen deaktivieren](/articles/disabling-oauth-app-access-restrictions-for-your-organization).{% endif %}
+{% if currentVersion == "free-pro-team@latest" %}When you create a new organization, {% data variables.product.prodname_oauth_app %} access restrictions are enabled by default. Organisationsinhaber können jederzeit [{% data variables.product.prodname_oauth_app %} Zugriffsbeschränkungen deaktivieren](/articles/disabling-oauth-app-access-restrictions-for-your-organization).{% endif %}
diff --git a/translations/de-DE/data/reusables/organizations/organization-name.md b/translations/de-DE/data/reusables/organizations/organization-name.md
index bde206e3c58f..f857fd77334e 100644
--- a/translations/de-DE/data/reusables/organizations/organization-name.md
+++ b/translations/de-DE/data/reusables/organizations/organization-name.md
@@ -1 +1 @@
-1. Gib unter „Organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} account{% endif %} name" einen Namen für Dein Organisationskonto ein. ![Feld zur Eingabe eines Organisationsnamens](/assets/images/help/organizations/new-org-name.png)
+1. Under "Organization account name", type a name for your organization account. ![Feld zur Eingabe eines Organisationsnamens](/assets/images/help/organizations/new-org-name.png)
diff --git a/translations/de-DE/data/reusables/organizations/organizations_include.md b/translations/de-DE/data/reusables/organizations/organizations_include.md
index 09cbd936cf3b..60384dacd4c4 100644
--- a/translations/de-DE/data/reusables/organizations/organizations_include.md
+++ b/translations/de-DE/data/reusables/organizations/organizations_include.md
@@ -1,5 +1,5 @@
 Organisationen beinhalten:
-{% if currentVersion == "free-pro-team@latest" %}- Eine kostenlose Option {% data variables.product.prodname_free_team %} mit unbegrenzten Mitarbeitern auf unbegrenzten öffentlichen Repositorys mit vollen Funktionen und unbegrenzten privaten Repositorys mit begrenzten Funktionen.
+{% if currentVersion == "free-pro-team@latest" %}- A free option, {% data variables.product.prodname_free_team %}, with unlimited collaborators on unlimited public repositories with full features and unlimited private repositories with limited features.
 - Die Option zum Upgrade auf {% data variables.product.prodname_team %} oder {% data variables.product.prodname_ghe_cloud %} für zusätzliche Funktionen, einschließlich anspruchsvolle Benutzerauthentifizierung und -verwaltung und eskalierte Unterstützungsoptionen. {% data reusables.gated-features.more-info %}{% endif %}
 - Unbegrenzte Mitgliedschaft mit einer Vielzahl von Rollen, die [unterschiedliche Zugriffsebenen auf die Organisation und auf deren Daten](/articles/permission-levels-for-an-organization) gewähren
 - Die Möglichkeit, den Mitgliedern [eine Reihe von Zugriffsberechtigungen auf die Repositorys Ihrer Organisation](/articles/repository-permission-levels-for-an-organization) zu erteilen
diff --git a/translations/de-DE/data/reusables/organizations/outside-collaborators-use-seats.md b/translations/de-DE/data/reusables/organizations/outside-collaborators-use-seats.md
index bdca66168e30..344a47c28777 100644
--- a/translations/de-DE/data/reusables/organizations/outside-collaborators-use-seats.md
+++ b/translations/de-DE/data/reusables/organizations/outside-collaborators-use-seats.md
@@ -1 +1 @@
-{% if currentVersion == "free-pro-team@latest" %}Das Hinzufügen eines externen Mitarbeiters zu einem privaten Repository wird eine der kostenpflichtigen Lizenzen Ihrer Organisation verwenden. Weitere Informationen findest Du unter „[Informationen zur benutzerabhängigen Preisgestaltung](/articles/about-per-user-pricing/)“.{% endif %}
+{% if currentVersion == "free-pro-team@latest" %}Adding an outside collaborator to a private repository will use one of your organization's paid licenses. Weitere Informationen findest Du unter „[Informationen zur benutzerabhängigen Preisgestaltung](/articles/about-per-user-pricing/)“.{% endif %}
diff --git a/translations/de-DE/data/reusables/organizations/repository-labels.md b/translations/de-DE/data/reusables/organizations/repository-labels.md
index c5664dbde429..efdb518cf94a 100644
--- a/translations/de-DE/data/reusables/organizations/repository-labels.md
+++ b/translations/de-DE/data/reusables/organizations/repository-labels.md
@@ -1 +1 @@
-1. In der linken Seitenleisten klicke auf **Repository labels** (Repository Kennzeichnungen). ![Registerkarte „Repository labels" (Repository Kennzeichnungen)](/assets/images/help/organizations/repo-labels-tab.png)
\ No newline at end of file
+1. In der linken Seitenleisten klicke auf **Repository labels** (Repository Kennzeichnungen). ![Registerkarte „Repository labels" (Repository Kennzeichnungen)](/assets/images/help/organizations/repo-labels-tab.png)
diff --git a/translations/de-DE/data/reusables/organizations/send-invitation.md b/translations/de-DE/data/reusables/organizations/send-invitation.md
index 68115b180a2f..f1b7420e05a0 100644
--- a/translations/de-DE/data/reusables/organizations/send-invitation.md
+++ b/translations/de-DE/data/reusables/organizations/send-invitation.md
@@ -1 +1 @@
-1. Klicke {% if currentVersion == "free-pro-team@latest" %}**Send invitation** (Einladung senden){% else %}**Add member** (Mitglied hinzufügen){% endif %}.
+1. Click {% if currentVersion == "free-pro-team@latest" %}**Send invitation**{% else %}**Add member**{% endif %}.
diff --git a/translations/de-DE/data/reusables/organizations/team_maintainers_can.md b/translations/de-DE/data/reusables/organizations/team_maintainers_can.md
index 027f744929d9..536742f4d282 100644
--- a/translations/de-DE/data/reusables/organizations/team_maintainers_can.md
+++ b/translations/de-DE/data/reusables/organizations/team_maintainers_can.md
@@ -10,6 +10,6 @@ Mitglieder mit Team-Betreuer-Berechtigungen können folgende Aktionen durchführ
 - [Dem Team Organisationsmitglieder hinzufügen](/articles/adding-organization-members-to-a-team)
 - [Organisationsmitglieder aus dem Team entfernen](/articles/removing-organization-members-from-a-team)
 - [Ein vorhandenes Teammitglied zum Team-Betreuer hochstufen](/articles/giving-team-maintainer-permissions-to-an-organization-member)
-- Entfernen des Zugriffs eines Teams auf Repositorys{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}
-- [Code-Review-Zuweisung für das Team verwalten](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team){% endif %}{% if currentVersion == "free-pro-team@latest" %}
+- Remove the team's access to repositories{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}
+- [Manage code review assignment for the team](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team){% endif %}{% if currentVersion == "free-pro-team@latest" %}
 - [Geplante Erinnerungen für Pull Requests verwalten](/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests){% endif %}
diff --git a/translations/de-DE/data/reusables/package_registry/admins-can-configure-package-types.md b/translations/de-DE/data/reusables/package_registry/admins-can-configure-package-types.md
index 82369c5e4a37..efe344932d49 100644
--- a/translations/de-DE/data/reusables/package_registry/admins-can-configure-package-types.md
+++ b/translations/de-DE/data/reusables/package_registry/admins-can-configure-package-types.md
@@ -4,4 +4,4 @@
 **Note:** This package type may not be available for your instance, because site administrators can enable or disable each supported package type. For more information, see "[Configuring packages support for your enterprise](/enterprise/admin/packages/configuring-packages-support-for-your-enterprise)."
 
 {% endnote %}
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/translations/de-DE/data/reusables/package_registry/authenticate-packages.md b/translations/de-DE/data/reusables/package_registry/authenticate-packages.md
index 1936b9a650e5..2344fb8cb3dc 100644
--- a/translations/de-DE/data/reusables/package_registry/authenticate-packages.md
+++ b/translations/de-DE/data/reusables/package_registry/authenticate-packages.md
@@ -1,9 +1,11 @@
 You need an access token to publish, install, and delete packages. Du kannst ein persönliches Zugriffstoken verwenden, um Dich mit Deinem Benutzernamen direkt bei {% data variables.product.prodname_registry %} oder beim {% data variables.product.prodname_dotcom %}-API zu authentifizieren. When you create a personal access token, you can assign the token different scopes depending on your needs.
 
 {% if currentVersion == "free-pro-team@latest" %}
-To authenticate using a {% data variables.product.prodname_actions %} workflow:
+To authenticate using a
+{% data variables.product.prodname_actions %}-workflow:
 - For package registries (`PACKAGE-REGISTRY.pkg.github.com/OWNER/REPOSITORY/IMAGE-NAME`), you can use a `GITHUB_TOKEN`.
 - For the container registry (`ghcr.io/OWNER/IMAGE-NAME`), you must use a personal access token.
 {% else %}
-Du kannst ein `GITHUB_TOKEN` verwenden, um Dich mit einem {% data variables.product.prodname_actions %}-Workflow zu authentifizieren.
+To authenticate to
+{% data variables.product.prodname_registry %} using a {% data variables.product.prodname_actions %} workflow, you must use `GITHUB_TOKEN`.
 {% endif %}
diff --git a/translations/de-DE/data/reusables/package_registry/authenticate-to-container-registry-steps.md b/translations/de-DE/data/reusables/package_registry/authenticate-to-container-registry-steps.md
new file mode 100644
index 000000000000..3858e98f3b70
--- /dev/null
+++ b/translations/de-DE/data/reusables/package_registry/authenticate-to-container-registry-steps.md
@@ -0,0 +1,25 @@
+1. Create a new personal access token (PAT) with the appropriate scopes for the tasks you want to accomplish. If your organization requires SSO, you must enable SSO for your new token.
+  {% warning %}
+
+  **Note:** If you select the `write:packages` scope, deselect the `repo` scope when creating the PAT. Adding a PAT with the `repo` scope as a secret in your repository allows the credential to be accessible to all collaborators in the repository. This gives unnecessary additional access when a PAT with the `repo` scope is used within an action. For more information on security best practices for actions, see "[Security hardening for GitHub Actions](/actions/getting-started-with-github-actions/security-hardening-for-github-actions#considering-cross-repository-access)."
+
+  {% endwarning %}
+
+    - Select the `read:packages` scope to download container images and read their metadata.
+    - Select the `write:packages` scope to download and upload container images and read and write their metadata.
+    - Select the `delete:packages` scope to delete container images.
+
+  Weitere Informationen findest Du unter „[Ein persönliches Zugriffstoken für die Befehlszeile erstellen](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line).“
+
+2. Save your PAT. We recommend saving your PAT as an environment variable.
+  ```shell
+  $ export CR_PAT=YOUR_TOKEN
+  ```
+3. Using the CLI for your container type, sign in to the
+{% data variables.product.prodname_github_container_registry %} service at `ghcr.io`.
+  {% raw %}
+  ```shell
+  $ echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin
+  > Login Succeeded
+  ```
+  {% endraw %}
diff --git a/translations/de-DE/data/reusables/package_registry/authenticate_with_pat_for_container_registry.md b/translations/de-DE/data/reusables/package_registry/authenticate_with_pat_for_container_registry.md
new file mode 100644
index 000000000000..7a08298672be
--- /dev/null
+++ b/translations/de-DE/data/reusables/package_registry/authenticate_with_pat_for_container_registry.md
@@ -0,0 +1,9 @@
+{% if currentVersion == "free-pro-team@latest" %}
+If you want to authenticate to
+{% data variables.product.prodname_github_container_registry %} in a {% data variables.product.prodname_actions %} workflow, then you must use a personal access token (PAT). The `GITHUB_TOKEN` does not currently have the required permissions. During the {% data variables.product.prodname_github_container_registry %} beta, the only supported form of authentication is the PAT.
+
+PATs can grant broad access to your account. We recommend selecting only the necessary read, write, or delete `package` scope when creating a PAT to authenticate to the {% data variables.product.prodname_container_registry %}. Avoid including the `repo` scope in a PAT used by a GitHub Actions workflow because it gives unnecessary additional access.
+
+If you'd like to use the {% data variables.product.prodname_container_registry %} in actions during the beta, follow our security best practices for PAT use at "[Security hardening for GitHub Actions](/actions/getting-started-with-github-actions/security-hardening-for-github-actions#considering-cross-repository-access)."
+
+{% endif %}
diff --git a/translations/de-DE/data/reusables/package_registry/docker_registry_deprecation_status.md b/translations/de-DE/data/reusables/package_registry/docker_registry_deprecation_status.md
new file mode 100644
index 000000000000..79e9650f348f
--- /dev/null
+++ b/translations/de-DE/data/reusables/package_registry/docker_registry_deprecation_status.md
@@ -0,0 +1,5 @@
+{% warning %}
+
+**Note:** The {% data variables.product.prodname_registry %} Docker registry will be superseded by {% data variables.product.prodname_github_container_registry %}{% if currentVersion != "free-pro-team@latest" %} in a future {% data variables.product.product_name %} release{% endif %}.{% if currentVersion == "free-pro-team@latest" %} To learn how to migrate your existing Docker images and any workflows using them, see "[Migrating to {% data variables.product.prodname_github_container_registry %} for Docker images](/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images)" and "[Getting started with {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry)."{% endif %}
+
+{% endwarning %}
diff --git a/translations/de-DE/data/reusables/package_registry/package-immutability.md b/translations/de-DE/data/reusables/package_registry/package-immutability.md
index f6b07b3e384f..f64bcf948811 100644
--- a/translations/de-DE/data/reusables/package_registry/package-immutability.md
+++ b/translations/de-DE/data/reusables/package_registry/package-immutability.md
@@ -1,3 +1,5 @@
-Um Verwirrung und Build-Probleme zu vermeiden, reserviert {% data variables.product.prodname_dotcom %} den Namen und die Versionsnummer eines Pakets dauerhaft. Selbst wenn ein ganzes Paket gelöscht wird, kannst Du den gelöschten Paketnamen In keinem anderen Repository wiederverwenden, das dem selben Konto gehört.
+**Public packages:** To prevent confusion and build problems, {% data variables.product.prodname_dotcom %} permanently reserves a package's name and version number. Selbst wenn ein ganzes Paket gelöscht wird, kannst Du den gelöschten Paketnamen In keinem anderen Repository wiederverwenden, das dem selben Konto gehört.
+
+**Private packages:** If all versions of a private package are deleted, you can publish a package with a previously used name and version.
 
 Um eine Paketversion zu überarbeiten oder zu ersetzen, empfehlen wir, dass Du eine neue Version Deines Pakets veröffentlichst.
diff --git a/translations/de-DE/data/reusables/package_registry/public-or-private-packages.md b/translations/de-DE/data/reusables/package_registry/public-or-private-packages.md
index 64bdcc2eba48..96876d84f347 100644
--- a/translations/de-DE/data/reusables/package_registry/public-or-private-packages.md
+++ b/translations/de-DE/data/reusables/package_registry/public-or-private-packages.md
@@ -1 +1 @@
-Du kannst Pakete in einem öffentlichen Repository (öffentliche Pakete) veröffentlichen, um sie mit allen {% data variables.product.prodname_dotcom %} zu teilen , oder in einem privaten Repository (private Pakete), um sie mit Mitarbeitern oder einer Organisation zu teilen.
+You can publish packages in a public repository (public packages) to share with {% if currentVersion == "free-pro-team@latest" %}all of {% data variables.product.prodname_dotcom %}{% else %}everyone on your instance{% endif %}, or in a private repository (private packages) to share with collaborators or an organization.
diff --git a/translations/de-DE/data/reusables/package_registry/spending-limit-enterprise-account.md b/translations/de-DE/data/reusables/package_registry/spending-limit-enterprise-account.md
index fb266d4f42f9..c0153e899cdb 100644
--- a/translations/de-DE/data/reusables/package_registry/spending-limit-enterprise-account.md
+++ b/translations/de-DE/data/reusables/package_registry/spending-limit-enterprise-account.md
@@ -1 +1 @@
-Wenn Du Dein Enterprise-Konto per Rechnung bezahlst, kannst Du das Ausgabenlimit für Dein Enterprise-Konto auf {% data variables.product.product_name %} nicht verwalten. Wenn Du Organisationen im Besitz Deines Enterprise-Konto erlauben willst, {% data variables.product.prodname_registry %} über die in ihren Konten enthaltenen Speicher oder Datenübertragungen hinaus zu benutzen, kannst Du für Überschreitungen im Voraus bezahlen. Da Überschreitungen im Voraus bezahlt werden müssen, kannst Du keine unbegrenzten Ausgaben für Konten aktivieren, die per Rechnung bezahlt werden. Dein Ausgabenlimit beträgt 150 % des Betrags, den Du im Voraus bezahlt hast. Wenn Du Fragen hast, [wende Dich an unser Kundendienstteam](https://enterprise.github.com/contact).
+Wenn Du Dein Enterprise-Konto per Rechnung bezahlst, kannst Du das Ausgabenlimit für Dein Enterprise-Konto nicht auf {% data variables.product.product_name %} verwalten. Wenn Du Organisationen im Besitz Deines Enterprise-Konto erlauben willst, {% data variables.product.prodname_registry %} über die in ihren Konten enthaltenen Speicher oder Datenübertragungen hinaus zu benutzen, kannst Du für Überschreitungen im Voraus bezahlen. Da Überschreitungen im Voraus bezahlt werden müssen, kannst Du keine unbegrenzten Ausgaben für Konten aktivieren, die per Rechnung bezahlt werden. Dein Ausgabenlimit beträgt 150 % des Betrags, den Du im Voraus bezahlt hast. Wenn Du Fragen hast, [wende Dich an unser Kundendienstteam](https://enterprise.github.com/contact).
diff --git a/translations/de-DE/data/reusables/pages/admin-must-push.md b/translations/de-DE/data/reusables/pages/admin-must-push.md
index c5380c73fa61..50633bf3dca8 100644
--- a/translations/de-DE/data/reusables/pages/admin-must-push.md
+++ b/translations/de-DE/data/reusables/pages/admin-must-push.md
@@ -1,5 +1,5 @@
 {% tip %}
 
-**Note**: If your site{% if currentVersion ver_lt "enterprise-server@2.22" %}'s source files are located in the default publishing source—`master` for user and organization sites or `gh-pages` for project sites—but your site{% endif %} has not published automatically, make sure someone with admin permissions and a verified email address has pushed to the publishing source.
+**Note**: If your site{% if currentVersion ver_lt "enterprise-server@2.23" %}'s source files are located in the default publishing source—`master` for user and organization sites or `gh-pages` for project sites—but your site{% endif %} has not published automatically, make sure someone with admin permissions and a verified email address has pushed to the publishing source.
 
 {% endtip %}
diff --git a/translations/de-DE/data/reusables/pages/best-with-supported-themes.md b/translations/de-DE/data/reusables/pages/best-with-supported-themes.md
index acc8fb56ecae..9de885f4e832 100644
--- a/translations/de-DE/data/reusables/pages/best-with-supported-themes.md
+++ b/translations/de-DE/data/reusables/pages/best-with-supported-themes.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-Diese Anweisungen funktionieren am besten mit Designs, die offiziell von {% data variables.product.prodname_pages %} unterstützt werden. Eine vollständige Liste der unterstützten Designs findest Du unter „[Unterstützte Designs](https://pages.github.com/themes/)" auf der Website {% data variables.product.prodname_pages %}.
+These instructions work best with themes that are officially supported by
+{% data variables.product.prodname_pages %}. Eine vollständige Liste der unterstützten Designs findest Du unter „[Unterstützte Designs](https://pages.github.com/themes/)" auf der Website {% data variables.product.prodname_pages %}.
 {% endif %}
diff --git a/translations/de-DE/data/reusables/pages/decide-publishing-source.md b/translations/de-DE/data/reusables/pages/decide-publishing-source.md
index 2736d7e2b48d..8e950fc86be7 100644
--- a/translations/de-DE/data/reusables/pages/decide-publishing-source.md
+++ b/translations/de-DE/data/reusables/pages/decide-publishing-source.md
@@ -1 +1 @@
-1. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}Decide{% else %}If you're creating a project site, decide{% endif %} which publishing source you want to use. {% if currentVersion ver_lt "enterprise-server@2.22" %}If you're creating a user or organization site, you must store your site's source code on the `master` branch.{% endif %} For more information, see "[About {% data variables.product.prodname_pages %}](/articles/about-github-pages#publishing-sources-for-github-pages-sites)."
+1. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}Decide{% else %}If you're creating a project site, decide{% endif %} which publishing source you want to use. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're creating a user or organization site, you must store your site's source code on the `master` branch.{% endif %} For more information, see "[About {% data variables.product.prodname_pages %}](/articles/about-github-pages#publishing-sources-for-github-pages-sites)."
diff --git a/translations/de-DE/data/reusables/pages/navigate-publishing-source.md b/translations/de-DE/data/reusables/pages/navigate-publishing-source.md
index f3b3708262da..135cf33b770e 100644
--- a/translations/de-DE/data/reusables/pages/navigate-publishing-source.md
+++ b/translations/de-DE/data/reusables/pages/navigate-publishing-source.md
@@ -1 +1 @@
-1. Navigiere zur Veröffentlichungsquelle für Deine Website. Weitere Informationen zu Veröffentlichungsquellen finden Sie unter „[Informationen zu {% data variables.product.prodname_pages %}](/articles/about-github-pages#publishing-sources-for-github-pages-sites)“.
+1. Navigiere zur Veröffentlichungsquelle für Deine Website. Weitere Informationen zu Veröffentlichungsquellen findest Du unter „[Informationen zu {% data variables.product.prodname_pages %}](/articles/about-github-pages#publishing-sources-for-github-pages-sites).“
diff --git a/translations/de-DE/data/reusables/pages/new-or-existing-repo.md b/translations/de-DE/data/reusables/pages/new-or-existing-repo.md
index 33de4d5066d6..f52410d1b7f5 100644
--- a/translations/de-DE/data/reusables/pages/new-or-existing-repo.md
+++ b/translations/de-DE/data/reusables/pages/new-or-existing-repo.md
@@ -1,3 +1,3 @@
-Wenn Deine Website ein unabhängiges Projekt ist, kannst Du ein neues Repository erstellen, um den Quellcode Deiner Website zu speichern. Wenn Deine Website ein unabhängiges Projekt ist, kannst Du ein neues Repository erstellen, um den Quellcode Deiner Website zu speichern.
+Wenn Deine Website ein unabhängiges Projekt ist, kannst Du ein neues Repository erstellen, um den Quellcode Deiner Website zu speichern. If your site is associated with an existing project, you can add the source code {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}to that project's repository, in a `/docs` folder on the default branch or on a different branch.{% else %}for your site to a `gh-pages` branch or a `docs` folder on the `master` branch in that project's repository.{% endif %} For example, if you're creating a site to publish documentation for a project that's already on {% data variables.product.product_name %}, you may want to store the source code for the site in the same repository as the project.
 
 Wenn Du eine Website in einem vorhandenen Repository erstellen möchtest, springe zum Abschnitt „[Erstellen Deiner Website](#creating-your-site)".
diff --git a/translations/de-DE/data/reusables/pages/private_pages_are_public_warning.md b/translations/de-DE/data/reusables/pages/private_pages_are_public_warning.md
index dac0868135f7..2579c5d10f51 100644
--- a/translations/de-DE/data/reusables/pages/private_pages_are_public_warning.md
+++ b/translations/de-DE/data/reusables/pages/private_pages_are_public_warning.md
@@ -1,5 +1,5 @@
   {% warning %}
 
-  **Warning**: {% if currentVersion != "free-pro-team@latest" %}If your site administrator has enabled Public Pages, {% endif %}{% data variables.product.prodname_pages %} sites are publicly available on the internet, even if the repository for the site is private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %}. Wenn Du sensitive Daten im Repository Deiner Website hast, solltest Du diese vor der Veröffentlichung entfernen. Weitere Informationen findest Du unter{% if currentVersion != "free-pro-team@latest" %} „[Konfigurieren {% data variables.product.prodname_pages %} auf Deiner Appliance](/enterprise/admin/installation/configuring-github-pages-on-your-appliance#making-github-pages-publicly-accessible)" und{% endif %} „[Über die Sichtbarkeit des Repositorys](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)."
+  **Warning**: {% if currentVersion != "free-pro-team@latest" %}If your site administrator has enabled Public Pages, {% endif %}{% data variables.product.prodname_pages %} sites are publicly available on the internet, even if the repository for the site is private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %}. If you have sensitive data in your site's repository, you may want to remove it before publishing. For more information, see{% if currentVersion != "free-pro-team@latest" %} "[Configuring {% data variables.product.prodname_pages %} on your appliance](/enterprise/admin/installation/configuring-github-pages-on-your-appliance#making-github-pages-publicly-accessible)" and{% endif %} "[About repository visibility](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)."
 
   {% endwarning %}
diff --git a/translations/de-DE/data/reusables/pages/visit-site.md b/translations/de-DE/data/reusables/pages/visit-site.md
index 562ae01c1e25..70a87291a9c1 100644
--- a/translations/de-DE/data/reusables/pages/visit-site.md
+++ b/translations/de-DE/data/reusables/pages/visit-site.md
@@ -2,6 +2,6 @@
 
   {% note %}
 
-  **Hinweis:** Es kann bis zu 20 Minuten dauern, bis die Änderungen auf Deiner Website veröffentlicht werden, nachdem Du die Änderungen zu {% data variables.product.product_name %} hinzugefügt hast. Wenn Deine Änderungen nach einer Stunde in Deinem Browser nicht angezeigt werden, findest Du weitere Informationen unter „[Über Jekyll-Build-Fehler für {% data variables.product.prodname_pages %}-Websites](/articles/about-jekyll-build-errors-for-github-pages-sites)."
+  **Hinweis:** Es kann bis zu 20 Minuten dauern, bis die Änderungen auf Ihrer Website veröffentlicht werden, nachdem Sie die Änderungen zu {% data variables.product.product_name %} gepusht haben. Wenn Deine Änderungen nach einer Stunde in Deinem Browser nicht angezeigt werden, findest Du weitere Informationen unter „[Über Jekyll-Build-Fehler für {% data variables.product.prodname_pages %}-Websites](/articles/about-jekyll-build-errors-for-github-pages-sites)."
 
   {% endnote %}
diff --git a/translations/de-DE/data/reusables/policies/abuse.md b/translations/de-DE/data/reusables/policies/abuse.md
index fd277b08dbd7..78c56e096b05 100644
--- a/translations/de-DE/data/reusables/policies/abuse.md
+++ b/translations/de-DE/data/reusables/policies/abuse.md
@@ -1 +1 @@
-{% data variables.product.prodname_dotcom %} toleriert keinen Missbrauch.{% if currentVersion == "free-pro-team@latest" %} Weitere Informationen zu den Richtlinien von {% data variables.product.prodname_dotcom %} findest Du in unseren [Nutzungsbedingungen](/articles/github-terms-of-service) and [Community-Richtlinien](/articles/github-community-guidelines).{% endif %}
+{% data variables.product.prodname_dotcom %} does not tolerate abuse.{% if currentVersion == "free-pro-team@latest" %} For more information on {% data variables.product.prodname_dotcom %}'s policies, see our [Terms of Service](/articles/github-terms-of-service) and [Community Guidelines](/articles/github-community-guidelines).{% endif %}
diff --git a/translations/de-DE/data/reusables/pre-release-program/machine-man-preview.md b/translations/de-DE/data/reusables/pre-release-program/machine-man-preview.md
index 8fb50254cd1f..bdcee03dec6f 100644
--- a/translations/de-DE/data/reusables/pre-release-program/machine-man-preview.md
+++ b/translations/de-DE/data/reusables/pre-release-program/machine-man-preview.md
@@ -6,4 +6,4 @@
 `application/vnd.github.machine-man-preview+json`
 
 {% endnote %}
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/translations/de-DE/data/reusables/pre-release-program/suspend-installation-beta.md b/translations/de-DE/data/reusables/pre-release-program/suspend-installation-beta.md
index 3d81271d74ca..ae027690926d 100644
--- a/translations/de-DE/data/reusables/pre-release-program/suspend-installation-beta.md
+++ b/translations/de-DE/data/reusables/pre-release-program/suspend-installation-beta.md
@@ -1,4 +1,5 @@
 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}
-Suspending a {% data variables.product.prodname_github_app %} installation is currently in beta and subject to change. Before you can suspend a {% data variables.product.prodname_github_app %}, the app owner must enable suspending installations for the app by opting-in to the beta. To opt-in to the suspending installations beta feature, see "[Activating beta features for apps](/developers/apps/activating-beta-features-for-apps)."
+Suspending a
+{% data variables.product.prodname_github_app %} installation is currently in beta and subject to change. Before you can suspend a {% data variables.product.prodname_github_app %}, the app owner must enable suspending installations for the app by opting-in to the beta. To opt-in to the suspending installations beta feature, see "[Activating beta features for apps](/developers/apps/activating-beta-features-for-apps)."
 
 {% endif %}
diff --git a/translations/de-DE/data/reusables/profile/profile-readme.md b/translations/de-DE/data/reusables/profile/profile-readme.md
index 6c734861db2e..a19a3d4a30d3 100644
--- a/translations/de-DE/data/reusables/profile/profile-readme.md
+++ b/translations/de-DE/data/reusables/profile/profile-readme.md
@@ -1 +1 @@
-If you add a README file to the root of a public repository with the same name as your username, that README will automatically appear on your profile page. You can edit your profile README with GitHub Flavored Markdown to create a personalized section on your profile.
\ No newline at end of file
+If you add a README file to the root of a public repository with the same name as your username, that README will automatically appear on your profile page. You can edit your profile README with GitHub Flavored Markdown to create a personalized section on your profile.
diff --git a/translations/de-DE/data/reusables/project-management/link-repos-to-project-board.md b/translations/de-DE/data/reusables/project-management/link-repos-to-project-board.md
index cbd797c9a4f9..c68621a809ed 100644
--- a/translations/de-DE/data/reusables/project-management/link-repos-to-project-board.md
+++ b/translations/de-DE/data/reusables/project-management/link-repos-to-project-board.md
@@ -1 +1 @@
-Du kannst bis zu 25 Repositorys mit Deinem Organisations- oder benutzereigenen Projektboard verknüpfen. Das Verknüpfen von Repositorys erleichtert das Hinzufügen von Issues und Pull Requests aus diesen Repositorys zu Deinem Projektboard mit Hilfe von **{% octicon "plus" aria-label="The Plus icon" %} Add cards** (Tickets hinzufügen){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} oder aus der Issues- oder Pull-Request-Seitenleiste{% endif %}.
+Du kannst bis zu 25 Repositorys mit Deinem Organisations- oder benutzereigenen Projektboard verknüpfen. Das Verknüpfen von Repositorys erleichtert das Hinzufügen von Issues und Pull Requests aus diesen Repositorys zu Deinem Projektboard mit Hilfe von **{% octicon "plus" aria-label="The Plus icon" %} Add cards** (Tickets hinzufügen) oder aus der Issues- oder Pull-Request-Seitenleiste.
diff --git a/translations/de-DE/data/reusables/project-management/project-board-import-with-api.md b/translations/de-DE/data/reusables/project-management/project-board-import-with-api.md
index 54da09cfacbc..96000e70d7d8 100644
--- a/translations/de-DE/data/reusables/project-management/project-board-import-with-api.md
+++ b/translations/de-DE/data/reusables/project-management/project-board-import-with-api.md
@@ -1 +1 @@
-Du kannst das API von {% data variables.product.prodname_dotcom %} verwenden, um ein Projektboard zu importieren. For more information, see "[importProject](/v4/mutation/importproject/)."
+Du kannst das API von {% data variables.product.prodname_dotcom %} verwenden, um ein Projektboard zu importieren. For more information, see "[importProject](/graphql/reference/mutations#importproject/)."
diff --git a/translations/de-DE/data/reusables/projects/disabled-projects.md b/translations/de-DE/data/reusables/projects/disabled-projects.md
index 2b10747e7e27..9f6e391db7fe 100644
--- a/translations/de-DE/data/reusables/projects/disabled-projects.md
+++ b/translations/de-DE/data/reusables/projects/disabled-projects.md
@@ -1 +1 @@
-You only see this event in responses when project boards have been [enabled](/articles/disabling-project-boards-in-a-repository) in the repository.
\ No newline at end of file
+You only see this event in responses when project boards have been [enabled](/articles/disabling-project-boards-in-a-repository) in the repository.
diff --git a/translations/de-DE/data/reusables/pull_requests/automatically-delete-branches.md b/translations/de-DE/data/reusables/pull_requests/automatically-delete-branches.md
index 7c654c2a8441..5a53e2a3829b 100644
--- a/translations/de-DE/data/reusables/pull_requests/automatically-delete-branches.md
+++ b/translations/de-DE/data/reusables/pull_requests/automatically-delete-branches.md
@@ -1,3 +1 @@
-{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}
 Du kannst festlegen, dass Head-Branches automatisch gelöscht werden, nachdem die Pull Requests in Deinem Repository zusammengeführt sind. Weitere Informationen findest Du unter „[Verwalten des automatischen Löschens von Branches](/articles/managing-the-automatic-deletion-of-branches)."
-{% endif %}
diff --git a/translations/de-DE/data/reusables/pull_requests/close-issues-using-keywords.md b/translations/de-DE/data/reusables/pull_requests/close-issues-using-keywords.md
index 021d1071c57c..858381fb4f45 100644
--- a/translations/de-DE/data/reusables/pull_requests/close-issues-using-keywords.md
+++ b/translations/de-DE/data/reusables/pull_requests/close-issues-using-keywords.md
@@ -1 +1 @@
-Du kannst einen Pull Request mit einem Issue verknüpfen, um{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} zu zeigen, dass eine Korrektur im Gang ist und{% endif %} den Issue automatisch zu schließen, wenn jemand den Pull Request zusammenführt. Weitere Informationen findest Du unter "[Pull Request mit einem Issue verknüpfen](/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue)."
+You can link a pull request to an issue to{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} show that a fix is in progress and to{% endif %} automatically close the issue when someone merges the pull request. Weitere Informationen findest Du unter "[Pull Request mit einem Issue verknüpfen](/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue)."
diff --git a/translations/de-DE/data/reusables/pull_requests/collect-co-author-commit-git-config-info.md b/translations/de-DE/data/reusables/pull_requests/collect-co-author-commit-git-config-info.md
index a2595a7b8871..b832ddb27e54 100644
--- a/translations/de-DE/data/reusables/pull_requests/collect-co-author-commit-git-config-info.md
+++ b/translations/de-DE/data/reusables/pull_requests/collect-co-author-commit-git-config-info.md
@@ -1 +1 @@
-1. Erfasse den Namen und die E-Mail-Adresse jedes Co-Autoren.{% if currentVersion == "free-pro-team@latest" %} Wenn eine Person ihre E-Mail-Adresse privat halten möchte, solltest Du ihre von {% data variables.product.product_name %} zur Verfügung gestellte `no-reply` E-Mail benutzen, um ihre Privatsphäre zu schützen.{% endif %}
+1. Collect the name and email address for each co-author.{% if currentVersion == "free-pro-team@latest" %} If a person chooses to keep their email address private, you should use their {% data variables.product.product_name %}-provided `no-reply` email to protect their privacy.{% endif %}
diff --git a/translations/de-DE/data/reusables/pull_requests/default-commit-message-squash-merge.md b/translations/de-DE/data/reusables/pull_requests/default-commit-message-squash-merge.md
index 4d1056d48adb..a5aa547d0c05 100644
--- a/translations/de-DE/data/reusables/pull_requests/default-commit-message-squash-merge.md
+++ b/translations/de-DE/data/reusables/pull_requests/default-commit-message-squash-merge.md
@@ -1 +1 @@
-For information about the default commit messages for squash merges, see "[About pull request merges](/github/collaborating-with-issues-and-pull-requests/about-pull-request-merges#merge-message-for-a-squash-merge)."
\ No newline at end of file
+For information about the default commit messages for squash merges, see "[About pull request merges](/github/collaborating-with-issues-and-pull-requests/about-pull-request-merges#merge-message-for-a-squash-merge)."
diff --git a/translations/de-DE/data/reusables/pull_requests/mark-ready-review.md b/translations/de-DE/data/reusables/pull_requests/mark-ready-review.md
index 9a8ca869ec3a..a47fc4553977 100644
--- a/translations/de-DE/data/reusables/pull_requests/mark-ready-review.md
+++ b/translations/de-DE/data/reusables/pull_requests/mark-ready-review.md
@@ -1 +1 @@
-Wenn Du bereit bist, Feedback zu Deinem Pull Request zu erhalten, kannst Du Deinen Entwurf des Pull Requests als zur Überprüfung bereit markieren. Wenn Du einen Pull Request als bereit zur Überprüfung markierst, werden Reviews von allen Codeinhabern angefordert.
\ No newline at end of file
+Wenn Du bereit bist, Feedback zu Deinem Pull Request zu erhalten, kannst Du Deinen Entwurf des Pull Requests als zur Überprüfung bereit markieren. Wenn Du einen Pull Request als bereit zur Überprüfung markierst, werden Reviews von allen Codeinhabern angefordert.
diff --git a/translations/de-DE/data/reusables/pull_requests/pull_request_merges_and_contributions.md b/translations/de-DE/data/reusables/pull_requests/pull_request_merges_and_contributions.md
index 7ccaf84fa163..60c2dc8da08f 100644
--- a/translations/de-DE/data/reusables/pull_requests/pull_request_merges_and_contributions.md
+++ b/translations/de-DE/data/reusables/pull_requests/pull_request_merges_and_contributions.md
@@ -1,6 +1,6 @@
 {% note %}
 
-**Hinweise:**{% if currentVersion != "free-pro-team@latest" %}
+**Notes:**{% if currentVersion != "free-pro-team@latest" %}
 - Damit Commits mit Co-Autor auf Profil-Beteiligungsdiagrammen angezeigt werden, müssen sie dieselben Kriterien wie Commits mit einem Autor erfüllen.{% endif %}
 - Beim Rebasing von Commits erhalten die ursprünglichen Autoren des Commits und die Person, welche die Commits rebaset hat, den Beitragscredit, unabhängig davon, ob sie die Commits an der Befehlszeile oder auf {% data variables.product.product_location %} rebaset haben.
 
diff --git a/translations/de-DE/data/reusables/reminders/author-reviews.md b/translations/de-DE/data/reusables/reminders/author-reviews.md
index 10ad2da17a40..0a4fac958da7 100644
--- a/translations/de-DE/data/reusables/reminders/author-reviews.md
+++ b/translations/de-DE/data/reusables/reminders/author-reviews.md
@@ -1 +1 @@
-1. Um optional nach dem Erfüllen der Überprüfungsanforderungen Erinnerungen an die Pull-Request-Autoren zu senden, wähle **Remind authors after reviews** (Erinnere Autoren nach der Überprüfung) und wähle die Anzahl benötigter Überprüfungen vor dem Senden der Erinnerung. ![Kontrollkästchen „Remind authors after reviews" (Autoren nach den Überprüfungen erinnern)](/assets/images/help/settings/scheduled-reminders-remind-authors.png)
\ No newline at end of file
+1. Um optional nach dem Erfüllen der Überprüfungsanforderungen Erinnerungen an die Pull-Request-Autoren zu senden, wähle **Remind authors after reviews** (Erinnere Autoren nach der Überprüfung) und wähle die Anzahl benötigter Überprüfungen vor dem Senden der Erinnerung. ![Kontrollkästchen „Remind authors after reviews" (Autoren nach den Überprüfungen erinnern)](/assets/images/help/settings/scheduled-reminders-remind-authors.png)
diff --git a/translations/de-DE/data/reusables/reminders/ignored-labels.md b/translations/de-DE/data/reusables/reminders/ignored-labels.md
index a06aca5b9efa..fe4eb6c98983 100644
--- a/translations/de-DE/data/reusables/reminders/ignored-labels.md
+++ b/translations/de-DE/data/reusables/reminders/ignored-labels.md
@@ -1 +1 @@
-1. Gib unter "Ignored labels" (Ignorierte Kennzeichnungen) eine Komma-getrennte Liste von Bezeichnungen ein. Geplante Erinnerungen werden keine Pull Requests beinhalten, welche eine oder mehrere dieser Kennzeichnungen haben. ![Feld „Ignored labels" (Ignorierte Kennzeichnungen)](/assets/images/help/settings/scheduled-reminders-ignored-labels-field.png)
\ No newline at end of file
+1. Gib unter "Ignored labels" (Ignorierte Kennzeichnungen) eine Komma-getrennte Liste von Bezeichnungen ein. Geplante Erinnerungen werden keine Pull Requests beinhalten, welche eine oder mehrere dieser Kennzeichnungen haben. ![Feld „Ignored labels" (Ignorierte Kennzeichnungen)](/assets/images/help/settings/scheduled-reminders-ignored-labels-field.png)
diff --git a/translations/de-DE/data/reusables/reminders/ignored-terms.md b/translations/de-DE/data/reusables/reminders/ignored-terms.md
index b4f3e365d6f3..7c742b5f3c15 100644
--- a/translations/de-DE/data/reusables/reminders/ignored-terms.md
+++ b/translations/de-DE/data/reusables/reminders/ignored-terms.md
@@ -1 +1 @@
-1. Gib unter „Ignored Terms" (Ignorierte Begriffe) eine Komma-getrennte Liste von Begriffen ein, die in den Titeln von Pull Requests erscheinen können. Geplante Erinnerungen werden keine Pull Requests einschließen, welche eine oder mehrere dieser Begriffe in ihren Titeln beinhalten. ![Feld „Ignored terms" (Ignorierte Begriffe)](/assets/images/help/settings/scheduled-reminders-ignored-terms-field.png)
\ No newline at end of file
+1. Gib unter „Ignored Terms" (Ignorierte Begriffe) eine Komma-getrennte Liste von Begriffen ein, die in den Titeln von Pull Requests erscheinen können. Geplante Erinnerungen werden keine Pull Requests einschließen, welche eine oder mehrere dieser Begriffe in ihren Titeln beinhalten. ![Feld „Ignored terms" (Ignorierte Begriffe)](/assets/images/help/settings/scheduled-reminders-ignored-terms-field.png)
diff --git a/translations/de-DE/data/reusables/reminders/min-age.md b/translations/de-DE/data/reusables/reminders/min-age.md
index 5cf264044b80..664b670a836e 100644
--- a/translations/de-DE/data/reusables/reminders/min-age.md
+++ b/translations/de-DE/data/reusables/reminders/min-age.md
@@ -1 +1 @@
-1. Unter „Minimum age" (Mindestalter) gib das Alter des Pull Requests in Stunden ein. Geplante Erinnerungen enthalten keine Pull Requests, die neuer sind als diese Altersgrenze. ![Feld „Ignored labels" (Ignorierte Kennzeichnungen)](/assets/images/help/settings/scheduled-reminders-min-age-field.png)
\ No newline at end of file
+1. Unter „Minimum age" (Mindestalter) gib das Alter des Pull Requests in Stunden ein. Geplante Erinnerungen enthalten keine Pull Requests, die neuer sind als diese Altersgrenze. ![Feld „Ignored labels" (Ignorierte Kennzeichnungen)](/assets/images/help/settings/scheduled-reminders-min-age-field.png)
diff --git a/translations/de-DE/data/reusables/reminders/min-staleness.md b/translations/de-DE/data/reusables/reminders/min-staleness.md
index cbe4546c29c8..1bd9e9acd88c 100644
--- a/translations/de-DE/data/reusables/reminders/min-staleness.md
+++ b/translations/de-DE/data/reusables/reminders/min-staleness.md
@@ -1 +1 @@
-1. Unter "Minimum staleness" (minimale Veraltung) gib die Zeit seit der letzten Aktivität auf einem Pull Request in Stunden ein. Geplante Erinnerungen werden keine Pull Requests beinhalten, deren letzte Aktivität aktueller war als dieses Zeitspanne. ![Feld Minimum „staleness" (Minimale Veraltung)](/assets/images/help/settings/scheduled-reminders-min-staleness-field.png)
\ No newline at end of file
+1. Unter "Minimum staleness" (minimale Veraltung) gib die Zeit seit der letzten Aktivität auf einem Pull Request in Stunden ein. Geplante Erinnerungen werden keine Pull Requests beinhalten, deren letzte Aktivität aktueller war als dieses Zeitspanne. ![Feld Minimum „staleness" (Minimale Veraltung)](/assets/images/help/settings/scheduled-reminders-min-staleness-field.png)
diff --git a/translations/de-DE/data/reusables/reminders/real-time-alerts.md b/translations/de-DE/data/reusables/reminders/real-time-alerts.md
index 44cabbedaca5..757073ee6d22 100644
--- a/translations/de-DE/data/reusables/reminders/real-time-alerts.md
+++ b/translations/de-DE/data/reusables/reminders/real-time-alerts.md
@@ -1 +1 @@
-1. Um optional Slack-Nachrichten zu erhalten, sobald ein bestimmtes Ereignis eintritt, wähle **Enable real-time alerts** (Echtzeit-Benachrichtigungen aktivieren) und wähle die Ereignisse, für die Du Echtzeit-Benachrichtigungen erhalten willst.
\ No newline at end of file
+1. Um optional Slack-Nachrichten zu erhalten, sobald ein bestimmtes Ereignis eintritt, wähle **Enable real-time alerts** (Echtzeit-Benachrichtigungen aktivieren) und wähle die Ereignisse, für die Du Echtzeit-Benachrichtigungen erhalten willst.
diff --git a/translations/de-DE/data/reusables/reminders/required-labels.md b/translations/de-DE/data/reusables/reminders/required-labels.md
index ec041202fff9..d316637b0d18 100644
--- a/translations/de-DE/data/reusables/reminders/required-labels.md
+++ b/translations/de-DE/data/reusables/reminders/required-labels.md
@@ -1 +1 @@
-1. Gib unter „Required labels" (Erforderliche Kennzeichnungen) eine Komma-getrennte Liste von Beschriftungen ein. Geplante Erinnerungen werden nur bisher nicht ignorierte Pull Requests beinhalten, wenn sie eine oder mehrere dieser Kennzeichnungen haben. ![Feld „Required labels" (Benötigte Kennzeichnungen)](/assets/images/help/settings/scheduled-reminders-required-labels-field.png)
\ No newline at end of file
+1. Gib unter „Required labels" (Erforderliche Kennzeichnungen) eine Komma-getrennte Liste von Beschriftungen ein. Geplante Erinnerungen werden nur bisher nicht ignorierte Pull Requests beinhalten, wenn sie eine oder mehrere dieser Kennzeichnungen haben. ![Feld „Required labels" (Benötigte Kennzeichnungen)](/assets/images/help/settings/scheduled-reminders-required-labels-field.png)
diff --git a/translations/de-DE/data/reusables/repositories/about-github-archive-program.md b/translations/de-DE/data/reusables/repositories/about-github-archive-program.md
index 0b062170cee2..22966f81ac81 100644
--- a/translations/de-DE/data/reusables/repositories/about-github-archive-program.md
+++ b/translations/de-DE/data/reusables/repositories/about-github-archive-program.md
@@ -1 +1 @@
-Standardmäßig sind alle öffentlichen Repositories in {% data variables.product.prodname_archive %} enthalten, welches eine Partnerschaft zwischen {% data variables.product.prodname_dotcom %} und Organisationen wie der Software Heritage Foundation und 'Internet Archive' ist, um die langfristige Erhaltung der weltweiten Open-Source-Software zu gewährleisten.
\ No newline at end of file
+Standardmäßig sind alle öffentlichen Repositories in {% data variables.product.prodname_archive %} enthalten, welches eine Partnerschaft zwischen {% data variables.product.prodname_dotcom %} und Organisationen wie der Software Heritage Foundation und 'Internet Archive' ist, um die langfristige Erhaltung der weltweiten Open-Source-Software zu gewährleisten.
diff --git a/translations/de-DE/data/reusables/repositories/about-internal-repos.md b/translations/de-DE/data/reusables/repositories/about-internal-repos.md
index c4d353de7343..d921cfd13384 100644
--- a/translations/de-DE/data/reusables/repositories/about-internal-repos.md
+++ b/translations/de-DE/data/reusables/repositories/about-internal-repos.md
@@ -1 +1 @@
-Du kannst interne Repositorys benutzen um „innersource" innerhalb {% if currentVersion == "free-pro-team@latest" %}Deines Enterprise-Kontos{% else %}Deiner Instanz{% endif %} zu üben. Mitglieder {% if currentVersion == "free-pro-team@latest" %}Deines Enterprise-Konto{% else %}irgendeiner Organisation auf Deiner Instanz{% endif %} können mit Hilfe von Open-Source-Methoden zusammenarbeiten, ohne proprietäre Informationen öffentlich zu teilen{% if currentVersion != "free-pro-team@latest" %}, auch bei deaktiviertem Privatmodus{% endif %}.
+You can use internal repositories to practice "innersource" within your {% if currentVersion == "free-pro-team@latest" %}enterprise account{% else %}instance{% endif %}. Members of {% if currentVersion == "free-pro-team@latest" %}your enterprise account{% else %}any organization on your instance{% endif %} can collaborate using open source methodologies without sharing proprietary information publicly{% if currentVersion != "free-pro-team@latest" %}, even with private mode disabled{% endif %}.
diff --git a/translations/de-DE/data/reusables/repositories/actions-workflow-status-badge-into.md b/translations/de-DE/data/reusables/repositories/actions-workflow-status-badge-into.md
index 6b04b2e26e9d..158e60c45d42 100644
--- a/translations/de-DE/data/reusables/repositories/actions-workflow-status-badge-into.md
+++ b/translations/de-DE/data/reusables/repositories/actions-workflow-status-badge-into.md
@@ -1,3 +1,3 @@
-Status-Badges zeigen an, ob ein Workflow derzeit fehlschlägt oder richtig abläuft. Ein häufiger Ort zum Hinzufügen eines Status-Badge ist in der README.md-Datei Deines Repository, aber Du kannst ihn zu jeder beliebigen Webseite hinzufügen. By default, badges display the status of your default branch. Du kannst auch den Status einer Workflow-Ausführung für einen bestimmten Branch oder ein bestimmtes Ereignis anzeigen, indem Du die Abfrageparameter `branch` (Branch) und `event` (Ereignis) in der URL verwendest.
+A status badge shows whether a workflow is currently failing or passing. Ein häufiger Ort zum Hinzufügen eines Status-Badge ist in der README.md-Datei Deines Repository, aber Du kannst ihn zu jeder beliebigen Webseite hinzufügen. By default, badges display the status of your default branch. Du kannst auch den Status einer Workflow-Ausführung für einen bestimmten Branch oder ein bestimmtes Ereignis anzeigen, indem Du die Abfrageparameter `branch` (Branch) und `event` (Ereignis) in der URL verwendest.
 
 ![example status badge](/assets/images/help/repository/actions-workflow-status-badge.png)
diff --git a/translations/de-DE/data/reusables/repositories/blocked-passwords.md b/translations/de-DE/data/reusables/repositories/blocked-passwords.md
index fc0b3515952d..068b957e9fc5 100644
--- a/translations/de-DE/data/reusables/repositories/blocked-passwords.md
+++ b/translations/de-DE/data/reusables/repositories/blocked-passwords.md
@@ -1,5 +1,6 @@
 {% if currentVersion == "free-pro-team@latest" %}
-Wenn Du ein Passwort eingibst um Dich anzumelden, ein Konto zu erstellen oder Dein Passwort zu ändern, wird {% data variables.product.product_name %} prüfen, ob das eingegebene Passwort gemäß Datensätzen wie HaveIBeenPwned als unsicher zu betrachten ist. Das Passwort wird möglicherweise als unsicher erkannt, selbst wenn Du dieses Passwort zuvor noch nie verwendet hast.
+When you type a password to sign in, create an account, or change your password,
+{% data variables.product.product_name %} will check if the password you entered is considered weak according to datasets like HaveIBeenPwned. Das Passwort wird möglicherweise als unsicher erkannt, selbst wenn Sie dieses Passwort zuvor noch nie verwendet haben.
 
-{% data variables.product.product_name %} überprüft das Passwort nur zum Eingabezeitpunkt und wird das eingegebene Passwort nie im Klartext speichern. Weitere Informationen findest Du unter [HaveIBeenPwned](https://haveibeenpwned.com/).
+{% data variables.product.product_name %} überprüft das Passwort nur zum Eingabezeitpunkt und wird das eingegebene Passwort nie im Klartext speichern. Weitere Informationen finden Sie unter [HaveIBeenPwned](https://haveibeenpwned.com/).
 {% endif %}
diff --git a/translations/de-DE/data/reusables/repositories/copy-clone-url.md b/translations/de-DE/data/reusables/repositories/copy-clone-url.md
index 522bedcd61ca..a4d353a81498 100644
--- a/translations/de-DE/data/reusables/repositories/copy-clone-url.md
+++ b/translations/de-DE/data/reusables/repositories/copy-clone-url.md
@@ -2,13 +2,13 @@
 1. Klicke unter dem Repository-Namen auf **Clone or download** (Klonen oder herunterladen). ![Schaltfläche „Clone or download“ (Klonen oder herunterladen)](/assets/images/help/repository/clone-repo-clone-url-button.png)
 2. To clone the repository using HTTPS, under "Clone with HTTPS", click
 {% octicon "clippy" aria-label="The clipboard icon" %}.
-To clone the repository using an SSH key
-{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, including a certificate issued by your organization's SSH certificate authority,{% endif %} click **Use SSH**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.
+To clone the repository using an SSH key, including a certificate issued by your organization's SSH certificate authority, click **Use SSH**, then click
+{% octicon "clippy" aria-label="The clipboard icon" %}.
 ![Schaltfläche „Clone URL" (URL klonen)](/assets/images/help/repository/https-url-clone.png)
 {% else %}
 1. Above the list of files, click {% octicon "download" aria-label="The download icon" %} **Code**. !["Code" button](/assets/images/help/repository/code-button.png)
 1. To clone the repository using HTTPS, under "Clone with HTTPS", click
-{% octicon "clippy" aria-label="The clipboard icon" %}. To clone the repository using an SSH key{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, including a certificate issued by your organization's SSH certificate authority,{% endif %} click **Use SSH**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} To clone a repository using {% data variables.product.prodname_cli %}, click **Use {% data variables.product.prodname_cli %}**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.{% endif %}
+{% octicon "clippy" aria-label="The clipboard icon" %}. To clone the repository using an SSH key, including a certificate issued by your organization's SSH certificate authority, click **Use SSH**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} To clone a repository using {% data variables.product.prodname_cli %}, click **Use {% data variables.product.prodname_cli %}**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.{% endif %}
   ![The clipboard icon for copying the URL to clone a repository](/assets/images/help/repository/https-url-clone.png)
   {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}
   ![The clipboard icon for copying the URL to clone a repository with GitHub CLI](/assets/images/help/repository/https-url-clone-cli.png){% endif %}
diff --git a/translations/de-DE/data/reusables/repositories/default-issue-templates.md b/translations/de-DE/data/reusables/repositories/default-issue-templates.md
index 266d57193743..7816df07878e 100644
--- a/translations/de-DE/data/reusables/repositories/default-issue-templates.md
+++ b/translations/de-DE/data/reusables/repositories/default-issue-templates.md
@@ -1,2 +1,2 @@
-Du kannst Standard-Issuevorlagen {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} und ein Standard-Konfigurationsfile für Issue-Vorlagen{% endif %} für Deine Organisation{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} oder Dein Benutzerkonto{% endif %} erstellen. Weitere Informationen findest Du unter „[Eine Standard Community-Unterstützungsdatei erstellen](/github/building-a-strong-community/creating-a-default-community-health-file)."
+You can create default issue templates{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and a default configuration file for issue templates{% endif %} for your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %}. Weitere Informationen findest Du unter „[Eine Standard Community-Unterstützungsdatei erstellen](/github/building-a-strong-community/creating-a-default-community-health-file)."
 
diff --git a/translations/de-DE/data/reusables/repositories/deleted_forks_from_private_repositories_warning.md b/translations/de-DE/data/reusables/repositories/deleted_forks_from_private_repositories_warning.md
index 5bcaf33f581e..14ae8e36cf0c 100644
--- a/translations/de-DE/data/reusables/repositories/deleted_forks_from_private_repositories_warning.md
+++ b/translations/de-DE/data/reusables/repositories/deleted_forks_from_private_repositories_warning.md
@@ -2,10 +2,10 @@
 
 **Warnung:**
 
-- Wenn Du den Zugriff einer Person auf ein privates Repository entfernst, werden all ihre Forks in diesem privaten Repositorys gelöscht. Lokale Klone des privaten Repositorys werden beibehalten. Wenn der Zugriff eines Teams auf ein privates Repository widerrufen wird oder ein Team mit Zugriff auf ein privates Repository gelöscht wird und die Teammitglieder nicht über ein anderes Team auf das Repository zugreifen können, werden die privaten Forks des Repositorys gelöscht.{% if currentVersion != "free-pro-team@latest" %}
-- Wenn Du [bei aktivierter LDAP-Synchronisation](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap/#enabling-ldap-sync) eine Person aus einem Repository entfernst, verliert diese den Zugriff, aber ihre Forks werden nicht gelöscht. Wenn die Person innerhalb von drei Monaten einem Team mit Zugriff auf das ursprüngliche Organisations-Repository hinzugefügt wird, wird ihr Zugriff auf die Forks bei der nächsten Synchronisierung automatisch wiederhergestellt.{% endif %}
+- Wenn Du den Zugriff einer Person auf ein privates Repository entfernst, werden all ihre Forks in diesem privaten Repositorys gelöscht. Lokale Klone des privaten Repositorys werden beibehalten. If a team's access to a private repository is revoked or a team with access to a private repository is deleted, and team members do not have access to the repository through another team, private forks of the repository will be deleted.{% if currentVersion != "free-pro-team@latest" %}
+- Wenn Du [bei aktivierter LDAP-Synchronisation](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap/#enabling-ldap-sync) eine Person aus einem Repository entfernst, verliert diese den Zugriff, aber ihre Forks werden nicht gelöscht. Wenn die Person innerhalb von drei Monaten einem Team mit Zugriff auf das ursprüngliche Organisations-Repository hinzugefügt wird, wird ihr Zugriff auf die Forks bei der nächsten Synchronisierung automatisch wiederhergestellt.{% endif %}
 - Sie sind dafür verantwortlich, dass die Personen, denen Sie den Zugriff auf ein Repository entziehen, vertrauliche Informationen oder geistiges Eigentum von ihren Systemen löschen.
 
-- Personen mit Administratorberechtigungen für ein privates{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} oder internes{% endif %} Repository können das Forking dieses Repositorys verbieten, und Organisationsinhaber können das Forking jedes privaten{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} oder internen{% endif %} Repository in einer Organisation verbieten. Weitere Informationen findest Du unter „[Verwalten der Forking-Richtlinie für Deine Organisation](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization)" und „[Verwalten der Forking-Richtlinie für Dein Repository".](/github/administering-a-repository/managing-the-forking-policy-for-your-repository)
+- People with admin permissions to a private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %} repository can disallow forking of that repository, and organization owners can disallow forking of any private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %} repository in an organization. Weitere Informationen findest Du unter „[Verwalten der Forking-Richtlinie für Deine Organisation](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization)" und „[Verwalten der Forking-Richtlinie für Dein Repository".](/github/administering-a-repository/managing-the-forking-policy-for-your-repository)
 
 {% endwarning %}
diff --git a/translations/de-DE/data/reusables/repositories/enable-security-alerts.md b/translations/de-DE/data/reusables/repositories/enable-security-alerts.md
index c1a76a37e691..4ab63edcb311 100644
--- a/translations/de-DE/data/reusables/repositories/enable-security-alerts.md
+++ b/translations/de-DE/data/reusables/repositories/enable-security-alerts.md
@@ -1,4 +1,4 @@
 {% if currentVersion != "free-pro-team@latest" %}
 Your site administrator must enable
-Dein Website-Administrator muss Sicherheitsmeldungen für angreifbare Abhängigkeiten für {% data variables.product.product_location_enterprise %} aktivieren, bevor Du diese Funktion nutzen kannst. Weitere Informationen findest Du unter „[Sicherheitsmeldungen für angreifbare Abhängigkeiten auf {% data variables.product.prodname_ghe_server %} aktivieren](/enterprise/{{ currentVersion }}/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server)“.
+{% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies for {% data variables.product.product_location_enterprise %} before you can use this feature. For more information, see "[Enabling alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server)."
 {% endif %}
diff --git a/translations/de-DE/data/reusables/repositories/navigate-to-job-superlinter.md b/translations/de-DE/data/reusables/repositories/navigate-to-job-superlinter.md
new file mode 100644
index 000000000000..17fcbc8ecc42
--- /dev/null
+++ b/translations/de-DE/data/reusables/repositories/navigate-to-job-superlinter.md
@@ -0,0 +1,5 @@
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+1. Klicke in der linken Seitenleiste auf den Auftrag, den Du sehen willst. ![Lint code base job](/assets/images/help/repository/superlinter-lint-code-base-job.png)
+{% else %}
+1. Klicke in der linken Seitenleiste auf den Auftrag, den Du sehen willst. ![Select a workflow job](/assets/images/help/repository/workflow-job.png)
+{% endif %}
\ No newline at end of file
diff --git a/translations/de-DE/data/reusables/repositories/navigate-to-workflow-superlinter.md b/translations/de-DE/data/reusables/repositories/navigate-to-workflow-superlinter.md
new file mode 100644
index 000000000000..68605327dabb
--- /dev/null
+++ b/translations/de-DE/data/reusables/repositories/navigate-to-workflow-superlinter.md
@@ -0,0 +1 @@
+1. Klicke in der linken Seitenleiste auf den Workflow, den Du sehen willst. ![Workflow-Liste in der linken Seitenleiste](/assets/images/help/repository/superlinter-workflow-sidebar.png)
\ No newline at end of file
diff --git a/translations/de-DE/data/reusables/repositories/open-with-github-desktop.md b/translations/de-DE/data/reusables/repositories/open-with-github-desktop.md
index f5557d81d364..fe235be96002 100644
--- a/translations/de-DE/data/reusables/repositories/open-with-github-desktop.md
+++ b/translations/de-DE/data/reusables/repositories/open-with-github-desktop.md
@@ -1,6 +1,8 @@
 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %}
 1. Klicke unter dem Namen Deines Repositorys auf **Clone or download** (Klonen oder herunterladen). ![Schaltfläche „Clone or download“ (Klonen oder herunterladen)](/assets/images/help/repository/clone-repo-clone-url-button.png)
-1. Klicke auf **Open in Desktop** (In Desktop öffnen), um das Repository zu klonen und in {% data variables.product.prodname_desktop %} zu öffnen. ![Schaltfläche „Open in Desktop“ (In Desktop öffnen)](/assets/images/help/desktop/open-in-desktop-button.png)
+1. Click **Open in Desktop** to clone the repository and open it in
+über {% data variables.product.prodname_desktop %}.
+![Schaltfläche „Open in Desktop“ (In Desktop öffnen)](/assets/images/help/desktop/open-in-desktop-button.png)
 {% else %}
 1. Above the list of files, click {% octicon "download" aria-label="The download icon" %} **Code**. !["Code" button](/assets/images/help/repository/code-button.png)
 1. Click
diff --git a/translations/de-DE/data/reusables/repositories/permissions-statement-read.md b/translations/de-DE/data/reusables/repositories/permissions-statement-read.md
index 747eeb5cdacd..241fdd2ba86a 100644
--- a/translations/de-DE/data/reusables/repositories/permissions-statement-read.md
+++ b/translations/de-DE/data/reusables/repositories/permissions-statement-read.md
@@ -1 +1 @@
-Personen mit Lesezugriff auf das Repository können diese Schritte ausführen.
\ No newline at end of file
+Read access to the repository is required to perform these steps.
diff --git a/translations/de-DE/data/reusables/repositories/permissions-statement-write.md b/translations/de-DE/data/reusables/repositories/permissions-statement-write.md
index 6db53800d2fa..457fe0472478 100644
--- a/translations/de-DE/data/reusables/repositories/permissions-statement-write.md
+++ b/translations/de-DE/data/reusables/repositories/permissions-statement-write.md
@@ -1 +1 @@
-Personen mit Schreibzugriff auf das Repository können diese Schritte ausführen.
\ No newline at end of file
+Write access to the repository is required to perform these steps.
diff --git a/translations/de-DE/data/reusables/repositories/relative-links.md b/translations/de-DE/data/reusables/repositories/relative-links.md
index 99f41d07a06a..6930782c3a1e 100644
--- a/translations/de-DE/data/reusables/repositories/relative-links.md
+++ b/translations/de-DE/data/reusables/repositories/relative-links.md
@@ -6,6 +6,6 @@ Ein relativer Link ist ein Verknüpfung, die relativ zur aktuellen Datei ist. We
 [Beitragsrichtlinien für dieses Projekt](docs/CONTRIBUTING.md)
 ```
 
-{% data variables.product.product_name %} wandelt Deinen relativen Link oder den Bildpfad automatisch anhand dem Branch um, auf dem Du Dich gerade befindest, damit der Link oder der Pfad immer funktioniert. Du kannst alle relativen Link-Operanden verwenden, beispielsweise `./` und `../`.
+{% data variables.product.product_name %} wandelt Ihren relativen Link oder den Bildpfad automatisch anhand dessen um, auf welchem Branch Sie sich gerade befinden, damit der Link oder der Pfad immer funktioniert. Du kannst alle relativen Link-Operanden verwenden, beispielsweise `./` und `../`.
 
 Relative Links sind für Benutzer, die Dein Repository klonen, einfacher zu verwenden. Absolute Links funktionieren möglicherweise nicht in Klons Deines Repositorys - wir empfehlen relative Links zu verwenden, um auf andere Dateien in Deinem Repository zu verweisen.
diff --git a/translations/de-DE/data/reusables/repositories/security-alert-delivery-options.md b/translations/de-DE/data/reusables/repositories/security-alert-delivery-options.md
index d5d965ab015d..7d18a4511586 100644
--- a/translations/de-DE/data/reusables/repositories/security-alert-delivery-options.md
+++ b/translations/de-DE/data/reusables/repositories/security-alert-delivery-options.md
@@ -1 +1 @@
-Wenn Dein Repository ein unterstütztes Abhängigkeiten-Manifest hat{% if currentVersion == "free-pro-team@latest" %} (und wenn du das Abhängigkeiten-Diagramm eingerichtet hast, wenn es ein privates Repository ist){% endif %}, erhältst Du eine wöchentliche Digest-E-Mail, sobald {% data variables.product.product_name %} eine angreifbare Abhängigkeit in Deinem Repository entdeckt. Darüber hinaus kannst Du Deine Sicherheitsmeldungen als Webbenachrichtigungen, einzelne E-Mail-Benachrichtigungen, tägliche E-Mail-Digests oder Meldungen auf der {% data variables.product.product_name %}-Oberfläche konfigurieren. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." |
+If your repository has a supported dependency manifest{% if currentVersion == "free-pro-team@latest" %} (and if you've set up the dependency graph if it's a private repository){% endif %}, whenever {% data variables.product.product_name %} detects a vulnerable dependency in your repository, you will receive a weekly digest email. Darüber hinaus können Sie Ihre Sicherheitsmeldungen als Webbenachrichtigungen, einzelne E-Mail-Benachrichtigungen, tägliche E-Mail-Digests oder Meldungen auf der {% data variables.product.product_name %}-Oberfläche konfigurieren. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." |
diff --git a/translations/de-DE/data/reusables/repositories/security-alerts-x-github-severity.md b/translations/de-DE/data/reusables/repositories/security-alerts-x-github-severity.md
index 8b4e13244cb5..7230ee99948a 100644
--- a/translations/de-DE/data/reusables/repositories/security-alerts-x-github-severity.md
+++ b/translations/de-DE/data/reusables/repositories/security-alerts-x-github-severity.md
@@ -1 +1 @@
-Email notifications for {% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} that affect one or more repositories include the `X-GitHub-Severity`  header field. You can use the value of the `X-GitHub-Severity` header field to filter email notifications for {% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %}.
\ No newline at end of file
+Email notifications for {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} that affect one or more repositories include the `X-GitHub-Severity`  header field. You can use the value of the `X-GitHub-Severity` header field to filter email notifications for {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %}.
diff --git a/translations/de-DE/data/reusables/repositories/select-marketplace-apps.md b/translations/de-DE/data/reusables/repositories/select-marketplace-apps.md
index 90e9617fc0a1..7e8e5d375476 100644
--- a/translations/de-DE/data/reusables/repositories/select-marketplace-apps.md
+++ b/translations/de-DE/data/reusables/repositories/select-marketplace-apps.md
@@ -1,3 +1,5 @@
 {% if currentVersion == "free-pro-team@latest" %}
-1. Wenn optional das persönliche Konto oder die Organisation, in der Du erstellst, {% data variables.product.prodname_github_app %}s von {% data variables.product.prodname_marketplace %} verwendet, wähle alle Apps aus, die Du im Repository verwenden möchtest. ![Liste der {% data variables.product.prodname_github_app %}s Deines Kontos von {% data variables.product.prodname_marketplace %} und Option zum Gewähren von Zugriff](/assets/images/help/repository/create-repository-choose-marketplace-apps.png)
+1. Optionally, if the personal account or organization in which you're creating uses any
+{% data variables.product.prodname_github_app %}s from {% data variables.product.prodname_marketplace %}, select any apps you'd like to use in the repository.
+  ![Liste der {% data variables.product.prodname_github_app %}s Ihres Kontos von {% data variables.product.prodname_marketplace %} und Option zum Gewähren von Zugriff](/assets/images/help/repository/create-repository-choose-marketplace-apps.png)
 {% endif %}
diff --git a/translations/de-DE/data/reusables/repositories/sidebar-dependabot-alerts.md b/translations/de-DE/data/reusables/repositories/sidebar-dependabot-alerts.md
index 74585315b209..b7eadd335c26 100644
--- a/translations/de-DE/data/reusables/repositories/sidebar-dependabot-alerts.md
+++ b/translations/de-DE/data/reusables/repositories/sidebar-dependabot-alerts.md
@@ -1 +1 @@
-1. In the security sidebar, click **{% data variables.product.prodname_dependabot_short %} alerts**. ![{% data variables.product.prodname_dependabot_short %} alerts tab](/assets/images/help/repository/dependabot-alerts-tab.png)
\ No newline at end of file
+1. In the security sidebar, click **{% data variables.product.prodname_dependabot_short %} alerts**. ![{% data variables.product.prodname_dependabot_short %} alerts tab](/assets/images/help/repository/dependabot-alerts-tab.png)
diff --git a/translations/de-DE/data/reusables/repositories/squash-and-rebase-linear-commit-hisitory.md b/translations/de-DE/data/reusables/repositories/squash-and-rebase-linear-commit-hisitory.md
index 2e26699b46dc..a091577d6845 100644
--- a/translations/de-DE/data/reusables/repositories/squash-and-rebase-linear-commit-hisitory.md
+++ b/translations/de-DE/data/reusables/repositories/squash-and-rebase-linear-commit-hisitory.md
@@ -1 +1 @@
-{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}Wenn in Deinem Repository eine geschützte Branch-Regel vorhanden ist, die einen linearen Commit-Verlauf erfordert, musst Du das Zusammenführen von Squash oder von Rebase oder beides zulassen. Weitere Informationen findest Du unter „[Einen linearen Commit-Verlauf verlangen](/github/administering-a-repository/requiring-a-linear-commit-history)."{% endif %}
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}If there is a protected branch rule in your repository that requires a linear commit history, you must allow squash merging, rebase merging, or both. Weitere Informationen findest Du unter „[Einen linearen Commit-Verlauf verlangen](/github/administering-a-repository/requiring-a-linear-commit-history)."{% endif %}
diff --git a/translations/de-DE/data/reusables/repositories/start-line-comment.md b/translations/de-DE/data/reusables/repositories/start-line-comment.md
index 29f0cd71a00e..3548a08c4cd4 100644
--- a/translations/de-DE/data/reusables/repositories/start-line-comment.md
+++ b/translations/de-DE/data/reusables/repositories/start-line-comment.md
@@ -1 +1 @@
-1. Führe den Mauszeiger über die Codezeile, wo Du einen Kommentar hinzufügen willst und klicke auf das blaue Kommentarsymbol.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} Um einen Kommentar zu mehreren Zeilen hinzuzufügen, klicke und ziehe den Mauszeiger, um den Zeilenbereich auszuwählen, und klicke dann auf das blaue Kommentarsymbol.{% endif %} ![Blaues Kommentarsymbol](/assets/images/help/commits/hover-comment-icon.gif)
+1. Hover over the line of code where you'd like to add a comment, and click the blue comment icon.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} To add a comment on multiple lines, click and drag to select the range of lines, then click the blue comment icon.{% endif %} ![Blaues Kommentarsymbol](/assets/images/help/commits/hover-comment-icon.gif)
diff --git a/translations/de-DE/data/reusables/repositories/suggest-changes.md b/translations/de-DE/data/reusables/repositories/suggest-changes.md
index 1adb1fc2e1f4..a0dca188f6eb 100644
--- a/translations/de-DE/data/reusables/repositories/suggest-changes.md
+++ b/translations/de-DE/data/reusables/repositories/suggest-changes.md
@@ -1 +1 @@
-1. Um optional eine bestimmte Änderung an der Zeile{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} oder den Zeilen{% endif %} vorzuschlagen, klicke auf {% octicon "diff" aria-label="The diff symbol" %} und bearbeite den Text innerhalb des Vorschlagsblocks. ![Vorschlagsblock](/assets/images/help/pull_requests/suggestion-block.png)
+1. Optionally, to suggest a specific change to the line{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} or lines{% endif %}, click {% octicon "diff" aria-label="The diff symbol" %}, then edit the text within the suggestion block. ![Vorschlagsblock](/assets/images/help/pull_requests/suggestion-block.png)
diff --git a/translations/de-DE/data/reusables/repositories/view-failed-job-results-superlinter.md b/translations/de-DE/data/reusables/repositories/view-failed-job-results-superlinter.md
new file mode 100644
index 000000000000..434994a1691a
--- /dev/null
+++ b/translations/de-DE/data/reusables/repositories/view-failed-job-results-superlinter.md
@@ -0,0 +1,5 @@
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+1. Any failed steps are automatically expanded to display the results. ![Super linter workflow results](/assets/images/help/repository/super-linter-workflow-results-updated.png)
+{% else %}
+1. Expand the **Run Super-Linter** step to view the results. ![Super linter workflow results](/assets/images/help/repository/super-linter-workflow-results.png)
+{% endif %}
\ No newline at end of file
diff --git a/translations/de-DE/data/reusables/repositories/view-run-superlinter.md b/translations/de-DE/data/reusables/repositories/view-run-superlinter.md
new file mode 100644
index 000000000000..418f6d61fb6c
--- /dev/null
+++ b/translations/de-DE/data/reusables/repositories/view-run-superlinter.md
@@ -0,0 +1 @@
+1. From the list of workflow runs, click the name of the run you want to see. ![Name der Workflow-Ausführung](/assets/images/help/repository/superlinter-run-name.png)
\ No newline at end of file
diff --git a/translations/de-DE/data/reusables/repositories/view-run.md b/translations/de-DE/data/reusables/repositories/view-run.md
index 15384d13c9f3..06c190b079c8 100644
--- a/translations/de-DE/data/reusables/repositories/view-run.md
+++ b/translations/de-DE/data/reusables/repositories/view-run.md
@@ -1 +1 @@
-1. Klicke unter „Workflow runs" (Workflow-Ausführungen) auf den Namens des Ausführung, die Du sehen willst. ![Name der Workflow-Ausführung](/assets/images/help/repository/run-name.png)
+1. From the list of workflow runs, click the name of the run you want to see. ![Name der Workflow-Ausführung](/assets/images/help/repository/run-name.png)
diff --git a/translations/de-DE/data/reusables/repositories/view-specific-line-superlinter.md b/translations/de-DE/data/reusables/repositories/view-specific-line-superlinter.md
new file mode 100644
index 000000000000..11a0a73f53b7
--- /dev/null
+++ b/translations/de-DE/data/reusables/repositories/view-specific-line-superlinter.md
@@ -0,0 +1,5 @@
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+1. Klicke bei Bedarf auf die Zeilennummer des Schritts, um einen Link zu einer bestimmten Zeile in den Logs zu erhalten. You can then copy the link from the address bar of your web browser. ![Schaltfläche zum Kopieren des Links](/assets/images/help/repository/copy-link-button-updated.png)
+{% else %}
+1. Klicke bei Bedarf auf die Zeilennummer des Schritts, um einen Link zu einer bestimmten Zeile in den Logs zu erhalten. You can then copy the link from the address bar of your web browser. ![Schaltfläche zum Kopieren des Links](/assets/images/help/repository/copy-link-button.png)
+{% endif %}
\ No newline at end of file
diff --git a/translations/de-DE/data/reusables/repositories/you-can-fork.md b/translations/de-DE/data/reusables/repositories/you-can-fork.md
index 20161c1647fc..2d290ce6cde4 100644
--- a/translations/de-DE/data/reusables/repositories/you-can-fork.md
+++ b/translations/de-DE/data/reusables/repositories/you-can-fork.md
@@ -1,3 +1,3 @@
-Du kannst jedes öffentliche Repository zu Deinem Benutzerkonto oder zu jeder Organisation forken, in der Du die Berechtigung zum Erstellen von Repositorys hast. Weitere Informationen finden Sie unter „[Berechtigungsebenen für eine Organisation](/articles/permission-levels-for-an-organization)".
+You can fork any public repository to your user account or any organization where you have repository creation permissions. For more information, see "[Permission levels for an organization](/articles/permission-levels-for-an-organization)."
 
-Du kannst jedes private Repository, auf das Du Zugriff hast, zu Deinem Benutzerkonto oder zu jeder Organisation auf {% data variables.product.prodname_team %} oder {% data variables.product.prodname_enterprise %} forken, in denen Du die Berechtigung zum Erstellen von Repositorys hast. Du kannst ein privates Repository nicht an eine Organisation forken, die {% data variables.product.prodname_free_team %} verwendet.{% if currentVersion == "free-pro-team@latest" %} Weitere Informationen findest Du unter „[GitHub Produkte](/articles/githubs-products)."{% endif %}
+You can fork any private repository you can access to your user account and any organization on {% data variables.product.prodname_team %} or {% data variables.product.prodname_enterprise %} where you have repository creation permissions. You cannot fork a private repository to an organization using {% data variables.product.prodname_free_team %}.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[GitHub's products](/articles/githubs-products)."{% endif %}
diff --git a/translations/de-DE/data/reusables/saml/add-okta-application.md b/translations/de-DE/data/reusables/saml/add-okta-application.md
index 80e813f82126..79acb396e490 100644
--- a/translations/de-DE/data/reusables/saml/add-okta-application.md
+++ b/translations/de-DE/data/reusables/saml/add-okta-application.md
@@ -1 +1 @@
-2. Klicke auf **Add application** (Anwendung hinzufügen). ![Schaltfläche "Add application" (Anwendung hinzufügen) in der Anwendungs-Registerkarte des Okta Dashboard](/assets/images/help/saml/okta-add-application.png)
\ No newline at end of file
+2. Klicke auf **Add application** (Anwendung hinzufügen). ![Schaltfläche "Add application" (Anwendung hinzufügen) in der Anwendungs-Registerkarte des Okta Dashboard](/assets/images/help/saml/okta-add-application.png)
diff --git a/translations/de-DE/data/reusables/saml/assign-yourself-to-okta.md b/translations/de-DE/data/reusables/saml/assign-yourself-to-okta.md
index 7b2fd7293434..42cb7d475a97 100644
--- a/translations/de-DE/data/reusables/saml/assign-yourself-to-okta.md
+++ b/translations/de-DE/data/reusables/saml/assign-yourself-to-okta.md
@@ -1 +1 @@
-1. Assign the application to your user in Okta. For more information, see [Assign applications to users](https://help.okta.com/en/prod/Content/Topics/users-groups-profiles/usgp-assign-apps.htm) in the Okta documentation.
\ No newline at end of file
+1. Assign the application to your user in Okta. For more information, see [Assign applications to users](https://help.okta.com/en/prod/Content/Topics/users-groups-profiles/usgp-assign-apps.htm) in the Okta documentation.
diff --git a/translations/de-DE/data/reusables/saml/click-enterprise-account-application.md b/translations/de-DE/data/reusables/saml/click-enterprise-account-application.md
index e5d172dcb9e5..3f8b0dcf579a 100644
--- a/translations/de-DE/data/reusables/saml/click-enterprise-account-application.md
+++ b/translations/de-DE/data/reusables/saml/click-enterprise-account-application.md
@@ -1 +1 @@
-1. Click the label for the application you created for your enterprise account.
\ No newline at end of file
+1. Click the label for the application you created for your enterprise account.
diff --git a/translations/de-DE/data/reusables/saml/okta-admin-button.md b/translations/de-DE/data/reusables/saml/okta-admin-button.md
index b1f3d74979cc..ffc7938d2dde 100644
--- a/translations/de-DE/data/reusables/saml/okta-admin-button.md
+++ b/translations/de-DE/data/reusables/saml/okta-admin-button.md
@@ -1 +1 @@
-1. In Okta, in the upper-right corner, click **Admin**. ![Admin button in Okta](/assets/images/help/saml/okta-admin-button.png)
\ No newline at end of file
+1. In Okta, in the upper-right corner, click **Admin**. ![Admin button in Okta](/assets/images/help/saml/okta-admin-button.png)
diff --git a/translations/de-DE/data/reusables/saml/okta-configure-api-integration.md b/translations/de-DE/data/reusables/saml/okta-configure-api-integration.md
index 63038a53e725..e390b3847fea 100644
--- a/translations/de-DE/data/reusables/saml/okta-configure-api-integration.md
+++ b/translations/de-DE/data/reusables/saml/okta-configure-api-integration.md
@@ -1 +1 @@
-1. Klicke auf **Configure API Integration** (API-Integration konfigurieren). ![Schaltfläche "Configure API Integration" (API-Integration konfigurieren) der Okta-Anwendung](/assets/images/help/saml/okta-configure-api-integration.png)
\ No newline at end of file
+1. Klicke auf **Configure API Integration** (API-Integration konfigurieren). ![Schaltfläche "Configure API Integration" (API-Integration konfigurieren) der Okta-Anwendung](/assets/images/help/saml/okta-configure-api-integration.png)
diff --git a/translations/de-DE/data/reusables/saml/okta-edit-provisioning.md b/translations/de-DE/data/reusables/saml/okta-edit-provisioning.md
index 95c0eac00e51..6716a863c75b 100644
--- a/translations/de-DE/data/reusables/saml/okta-edit-provisioning.md
+++ b/translations/de-DE/data/reusables/saml/okta-edit-provisioning.md
@@ -2,4 +2,4 @@
 11. Wähle rechts neben „Create Users" (Benutzer erstellen) die Option **Enable** (Aktivieren). ![Kontrollkästchen "Enable" (Aktivieren) für die Option "Create Users" (Benutzer erstellen) der Okta-Anwendung](/assets/images/help/saml/okta-provisioning-enable-create-users.png)
 12. Wähle rechts neben „Update User Attributes" (Benutzerattribute aktualisieren) die Option **Enable** (Aktivieren). ![Kontrollkästchen "Enable" (Aktivieren) für die Option "Update User Attributes" (Benutzerattribute aktualisieren) der Okta-Anwendung](/assets/images/help/saml/okta-provisioning-enable-update-user-attributes.png)
 13. Wähle rechts neben "Deactivate Users" (Benutzer deaktivieren) die Option **Enable** (Aktivieren). ![Kontrollkästchen "Enable" (Aktivieren) für die Option "Deactivate Users" (Benutzer deaktivieren) der Okta-Anwendung](/assets/images/help/saml/okta-provisioning-enable-deactivate-users.png)
-14. Klicke auf **Save** (Speichern). ![Schaltfläche "Save" (Speichern) für die Bereitstellungs-Konfiguration der Okta-Anwendung](/assets/images/help/saml/okta-provisioning-save.png)
\ No newline at end of file
+14. Klicke auf **Save** (Speichern). ![Schaltfläche "Save" (Speichern) für die Bereitstellungs-Konfiguration der Okta-Anwendung](/assets/images/help/saml/okta-provisioning-save.png)
diff --git a/translations/de-DE/data/reusables/saml/okta-enable-api-integration.md b/translations/de-DE/data/reusables/saml/okta-enable-api-integration.md
index fa5af936304c..ae8892aab445 100644
--- a/translations/de-DE/data/reusables/saml/okta-enable-api-integration.md
+++ b/translations/de-DE/data/reusables/saml/okta-enable-api-integration.md
@@ -1 +1 @@
-1. Wähle **Enable API integration** (API-Integration aktivieren). ![Kontrollkästchen "Enable API integration" (API-Integration aktivieren) der Okta-Anwendung](/assets/images/help/saml/okta-enable-api-integration.png)
\ No newline at end of file
+1. Wähle **Enable API integration** (API-Integration aktivieren). ![Kontrollkästchen "Enable API integration" (API-Integration aktivieren) der Okta-Anwendung](/assets/images/help/saml/okta-enable-api-integration.png)
diff --git a/translations/de-DE/data/reusables/saml/okta-provisioning-tab.md b/translations/de-DE/data/reusables/saml/okta-provisioning-tab.md
index 43913b6f64aa..3ba325e8ea76 100644
--- a/translations/de-DE/data/reusables/saml/okta-provisioning-tab.md
+++ b/translations/de-DE/data/reusables/saml/okta-provisioning-tab.md
@@ -1 +1 @@
-1. Under the name of the application, click **Provisioning**. ![Registerkarte "Provisioning" (Bereitstellung) der Okta-Anwendung](/assets/images/help/saml/okta-provisioning-tab.png)
\ No newline at end of file
+1. Under the name of the application, click **Provisioning**. ![Registerkarte "Provisioning" (Bereitstellung) der Okta-Anwendung](/assets/images/help/saml/okta-provisioning-tab.png)
diff --git a/translations/de-DE/data/reusables/saml/okta-save-provisioning.md b/translations/de-DE/data/reusables/saml/okta-save-provisioning.md
index aeb201f3fb19..53f350b00a33 100644
--- a/translations/de-DE/data/reusables/saml/okta-save-provisioning.md
+++ b/translations/de-DE/data/reusables/saml/okta-save-provisioning.md
@@ -1 +1 @@
-1. Klicke auf **Save** (Speichern). ![Schaltfläche "Save" (Speichern) für die Bereitstellungs-Konfiguration der Okta-Anwendung](/assets/images/help/saml/okta-provisioning-tab-save.png)
\ No newline at end of file
+1. Klicke auf **Save** (Speichern). ![Schaltfläche "Save" (Speichern) für die Bereitstellungs-Konfiguration der Okta-Anwendung](/assets/images/help/saml/okta-provisioning-tab-save.png)
diff --git a/translations/de-DE/data/reusables/saml/okta-sign-on-tab.md b/translations/de-DE/data/reusables/saml/okta-sign-on-tab.md
index 677d09a996d2..1859e879f828 100644
--- a/translations/de-DE/data/reusables/saml/okta-sign-on-tab.md
+++ b/translations/de-DE/data/reusables/saml/okta-sign-on-tab.md
@@ -1 +1 @@
-1. Under the name of the application, click **Sign on**. ![Registerkarte "Sign on" (Anmelden) für die Okta-Anwendung](/assets/images/help/saml/okta-sign-on-tab.png)
\ No newline at end of file
+1. Under the name of the application, click **Sign on**. ![Registerkarte "Sign on" (Anmelden) für die Okta-Anwendung](/assets/images/help/saml/okta-sign-on-tab.png)
diff --git a/translations/de-DE/data/reusables/saml/okta-view-setup-instructions.md b/translations/de-DE/data/reusables/saml/okta-view-setup-instructions.md
index 1412cb0d0f62..bca183d828c9 100644
--- a/translations/de-DE/data/reusables/saml/okta-view-setup-instructions.md
+++ b/translations/de-DE/data/reusables/saml/okta-view-setup-instructions.md
@@ -1 +1 @@
-1. Klicke unter „SIGN ON METHODS" (Anmeldemethoden) auf **View Setup Instructions** (Setup-Anweisungen anzeigen). ![Schaltfläche "View Setup Instructions" (Setup-Anweisungen anzeigen) in der Registerkarte "Sign On" (Anmelden) der Okta-Anwendung](/assets/images/help/saml/okta-view-setup-instructions.png)
\ No newline at end of file
+1. Klicke unter „SIGN ON METHODS" (Anmeldemethoden) auf **View Setup Instructions** (Setup-Anweisungen anzeigen). ![Schaltfläche "View Setup Instructions" (Setup-Anweisungen anzeigen) in der Registerkarte "Sign On" (Anmelden) der Okta-Anwendung](/assets/images/help/saml/okta-view-setup-instructions.png)
diff --git a/translations/de-DE/data/reusables/saml/search-ghec-okta.md b/translations/de-DE/data/reusables/saml/search-ghec-okta.md
index bec120ddcce9..140101c42b80 100644
--- a/translations/de-DE/data/reusables/saml/search-ghec-okta.md
+++ b/translations/de-DE/data/reusables/saml/search-ghec-okta.md
@@ -1 +1 @@
-3. Gib im Suchfeld „GitHub Enterprise Cloud" ein. ![Feld "Search for an application" (eine Anwendung suchen) in Okta](/assets/images/help/saml/okta-search-for-an-application.png)
\ No newline at end of file
+3. Gib im Suchfeld „GitHub Enterprise Cloud" ein. ![Feld "Search for an application" (eine Anwendung suchen) in Okta](/assets/images/help/saml/okta-search-for-an-application.png)
diff --git a/translations/de-DE/data/reusables/saml/use-classic-ui.md b/translations/de-DE/data/reusables/saml/use-classic-ui.md
index f2f85efdcd6a..ed4b561d7206 100644
--- a/translations/de-DE/data/reusables/saml/use-classic-ui.md
+++ b/translations/de-DE/data/reusables/saml/use-classic-ui.md
@@ -1,3 +1,3 @@
 You must use the "Classic UI" in Okta. Weitere Informationen findest Du unter „[Organisierte Navigation](https://developer.okta.com/blog/2017/09/25/all-new-developer-console#new-look--feel) auf dem Okta Blog.
 
-![Wähle "Classic UI" aus der Okta UI Stilauswahl über dem Dashboard](/assets/images/help/saml/okta-classic-ui.png)
\ No newline at end of file
+![Wähle "Classic UI" aus der Okta UI Stilauswahl über dem Dashboard](/assets/images/help/saml/okta-classic-ui.png)
diff --git a/translations/de-DE/data/reusables/scim/enterprise-account-scim.md b/translations/de-DE/data/reusables/scim/enterprise-account-scim.md
index 41d1a43470e4..1797863354c2 100644
--- a/translations/de-DE/data/reusables/scim/enterprise-account-scim.md
+++ b/translations/de-DE/data/reusables/scim/enterprise-account-scim.md
@@ -1 +1 @@
-If you're participating in the private beta for user provisioning for enterprise accounts, when you enable SAML for your enterprise account, SCIM provisioning and deprovisioning is enabled by default in {% data variables.product.product_name %}. You can use provisioning to manage organization membership by configuring SCIM in your IdP.
\ No newline at end of file
+If you're participating in the private beta for user provisioning for enterprise accounts, when you enable SAML for your enterprise account, SCIM provisioning and deprovisioning is enabled by default in {% data variables.product.product_name %}. You can use provisioning to manage organization membership by configuring SCIM in your IdP.
diff --git a/translations/de-DE/data/reusables/search/syntax_tips.md b/translations/de-DE/data/reusables/search/syntax_tips.md
index 3848a0a9183a..83266f1938fa 100644
--- a/translations/de-DE/data/reusables/search/syntax_tips.md
+++ b/translations/de-DE/data/reusables/search/syntax_tips.md
@@ -1,6 +1,6 @@
 {% tip %}
 
-**Tipps:**{% if currentVersion != "free-pro-team@latest" %}
+**Tips:**{% if currentVersion != "free-pro-team@latest" %}
   - Dieser Artikel enthält Beispielsuchen für die Website {% data variables.product.prodname_dotcom %}.com. Die gleichen Suchfilter kannst Du jedoch auch auf {% data variables.product.product_location_enterprise %} verwenden.{% endif %}
   - Eine Liste mit Suchsyntax, die Du jedem Qualifizierer hinzufügen kannst, um Deine Ergebnisse zu verbessern, findest Du unter „[Grundlagen der Suchsyntax](/articles/understanding-the-search-syntax)“.
   - Schließe Suchbegriffe, die aus mehreren Wörtern bestehen, in Anführungszeichen ein. Möchtest Du beispielsweise nach Issues mit der Kennzeichnung „In progress“ suchen, gib `label:"in progress"` ein. Bei der Suche wird die Groß-/Kleinschreibung ignoriert.
diff --git a/translations/de-DE/data/reusables/secret-scanning/beta.md b/translations/de-DE/data/reusables/secret-scanning/beta.md
index 979f182467ee..ac6f249279e1 100644
--- a/translations/de-DE/data/reusables/secret-scanning/beta.md
+++ b/translations/de-DE/data/reusables/secret-scanning/beta.md
@@ -2,4 +2,4 @@
 
 **Hinweis:** {% data variables.product.prodname_secret_scanning_caps %} für private Repositorys befindet sich derzeit in der Beta-Version und kann sich jederzeit verändern. Um Zugriff auf die Beta-Version zu erhalten, [tritt der Warteliste bei](https://github.com/features/security/advanced-security/signup).
 
-{% endnote %}
\ No newline at end of file
+{% endnote %}
diff --git a/translations/de-DE/data/reusables/security/security-and-analysis-features-enable-read-only.md b/translations/de-DE/data/reusables/security/security-and-analysis-features-enable-read-only.md
index 9085cfbda842..56fbe20770c1 100644
--- a/translations/de-DE/data/reusables/security/security-and-analysis-features-enable-read-only.md
+++ b/translations/de-DE/data/reusables/security/security-and-analysis-features-enable-read-only.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-If you enable security and analysis features, {% data variables.product.company_short %} performs read-only analysis on your repository. Weitere Informationen findest Du unter „[Über {% data variables.product.company_short %}'s Verwendung Deiner Daten](/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data)."
-{% endif %}
\ No newline at end of file
+If you enable security and analysis features,
+{% data variables.product.company_short %} performs read-only analysis on your repository. Weitere Informationen findest Du unter „[Über {% data variables.product.company_short %}'s Verwendung Deiner Daten](/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data)."
+{% endif %}
diff --git a/translations/de-DE/data/reusables/shortdesc/iso_8601.md b/translations/de-DE/data/reusables/shortdesc/iso_8601.md
index ff04e176b2e3..6f3fbed64c03 100644
--- a/translations/de-DE/data/reusables/shortdesc/iso_8601.md
+++ b/translations/de-DE/data/reusables/shortdesc/iso_8601.md
@@ -1 +1 @@
-This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`.
\ No newline at end of file
+This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`.
diff --git a/translations/de-DE/data/reusables/sponsors/edit-featured-work.md b/translations/de-DE/data/reusables/sponsors/edit-featured-work.md
index e5441e8ce066..5b699d96feac 100644
--- a/translations/de-DE/data/reusables/sponsors/edit-featured-work.md
+++ b/translations/de-DE/data/reusables/sponsors/edit-featured-work.md
@@ -1,3 +1,3 @@
 1. Wähle optional die Repositorys aus, die auf Deinem {% data variables.product.prodname_sponsors %}-Profil präsentiert werden.
     - Klicke rechts neben „Featured work" (Vorgestellte Arbeit) auf **Edit** (Bearbeiten). ![Schaltfläche „Edit" (Bearbeiten) für vorgestellte Arbeiten](/assets/images/help/sponsors/featured-work-edit-button.png)
-    - Wähle bis zu 6 Repositorys, dann klicke auf **Save** (Speichern). ![Kontrollkästchen um Repositorys auszuwählen](/assets/images/help/sponsors/featured-work-select.png)
\ No newline at end of file
+    - Wähle bis zu 6 Repositorys, dann klicke auf **Save** (Speichern). ![Kontrollkästchen um Repositorys auszuwählen](/assets/images/help/sponsors/featured-work-select.png)
diff --git a/translations/de-DE/data/reusables/sponsors/meet-the-team.md b/translations/de-DE/data/reusables/sponsors/meet-the-team.md
index cbc4fee83f19..6f523e333b7e 100644
--- a/translations/de-DE/data/reusables/sponsors/meet-the-team.md
+++ b/translations/de-DE/data/reusables/sponsors/meet-the-team.md
@@ -2,4 +2,4 @@
     - Klicke rechts neben "Meet the team" (Das Team treffen) auf **Edit** (Bearbeiten).  
       ![Schaltfläche „Edit organization members to profile" (Organisationsmitglieder im Profil bearbeiten)](/assets/images/help/sponsors/edit-org-members-profile-button.png)
     - Wähle bis zu sechs Organisationsmitglieder aus und klicke dann auf **Save** (Speichern). ![Wähle hervorgehobenen Organisationsmitglieder aus](/assets/images/help/sponsors/select-highlighted-org-members.png)
-    - Gib optional unter dem Namen jedes hervorgehobenen Mitglieds eine Beschreibung des Mitglieds ein. ![Beschreibung für hervorgehobene Organisationsmitglieder](/assets/images/help/sponsors/description-highlighted-org-members.png)
\ No newline at end of file
+    - Gib optional unter dem Namen jedes hervorgehobenen Mitglieds eine Beschreibung des Mitglieds ein. ![Beschreibung für hervorgehobene Organisationsmitglieder](/assets/images/help/sponsors/description-highlighted-org-members.png)
diff --git a/translations/de-DE/data/reusables/sponsors/navigate-to-your-goals-tab.md b/translations/de-DE/data/reusables/sponsors/navigate-to-your-goals-tab.md
index f809cb690d5f..4b66ebbb79f8 100644
--- a/translations/de-DE/data/reusables/sponsors/navigate-to-your-goals-tab.md
+++ b/translations/de-DE/data/reusables/sponsors/navigate-to-your-goals-tab.md
@@ -1 +1 @@
-1. Klicke in der linken Seitenleiste auf **Your goals** (Deine Ziele). ![Registerkarte „Your goals" (Deine Ziele)](/assets/images/help/sponsors/your-goals-tab.png)
\ No newline at end of file
+1. Klicke in der linken Seitenleiste auf **Your goals** (Deine Ziele). ![Registerkarte „Your goals" (Deine Ziele)](/assets/images/help/sponsors/your-goals-tab.png)
diff --git a/translations/de-DE/data/reusables/sponsors/opt-in-to-being-featured.md b/translations/de-DE/data/reusables/sponsors/opt-in-to-being-featured.md
index c1efdccc6390..5a275a15c9cd 100644
--- a/translations/de-DE/data/reusables/sponsors/opt-in-to-being-featured.md
+++ b/translations/de-DE/data/reusables/sponsors/opt-in-to-being-featured.md
@@ -1 +1 @@
-1. Wähle optional **Opt-in to potentially being featured on github.com/sponsors** (Anmelden, um möglicherweise auf github.com/sponsors vorgestellt zu werden). ![Kontrollkästchen, um sich für die Vorstellung anzumelden](/assets/images/help/sponsors/opt-in-to-being-featured.png)
\ No newline at end of file
+1. Wähle optional **Opt-in to potentially being featured on github.com/sponsors** (Anmelden, um möglicherweise auf github.com/sponsors vorgestellt zu werden). ![Kontrollkästchen, um sich für die Vorstellung anzumelden](/assets/images/help/sponsors/opt-in-to-being-featured.png)
diff --git a/translations/de-DE/data/reusables/sponsors/publish-goal.md b/translations/de-DE/data/reusables/sponsors/publish-goal.md
index 48394862e90b..e1232f7bec80 100644
--- a/translations/de-DE/data/reusables/sponsors/publish-goal.md
+++ b/translations/de-DE/data/reusables/sponsors/publish-goal.md
@@ -1 +1 @@
-1. Klicke auf **Publish** (Veröffentlichen). ![Schaltfläche zum Veröffentlichen](/assets/images/help/sponsors/publish-goal-button.png)
\ No newline at end of file
+1. Klicke auf **Publish** (Veröffentlichen). ![Schaltfläche zum Veröffentlichen](/assets/images/help/sponsors/publish-goal-button.png)
diff --git a/translations/de-DE/data/reusables/sponsors/retire-goal.md b/translations/de-DE/data/reusables/sponsors/retire-goal.md
index f7ccba57866a..cff1124526d5 100644
--- a/translations/de-DE/data/reusables/sponsors/retire-goal.md
+++ b/translations/de-DE/data/reusables/sponsors/retire-goal.md
@@ -1,2 +1,2 @@
 1. Klicke unten auf der Seite auf **Retire** (Zurückziehen). ![Schaltfläche „Retire" (Zurückziehen)](/assets/images/help/sponsors/retire-goal-button.png)
-2. Lies die Warnung, dann klicke auf **OK**. ![Warnung über das Zurückziehen eines Zieles](/assets/images/help/sponsors/confirm-retire-goal.png)
\ No newline at end of file
+2. Lies die Warnung, dann klicke auf **OK**. ![Warnung über das Zurückziehen eines Zieles](/assets/images/help/sponsors/confirm-retire-goal.png)
diff --git a/translations/de-DE/data/reusables/sponsors/save-profile.md b/translations/de-DE/data/reusables/sponsors/save-profile.md
index 91aa154f0d8e..0e2592ff51cc 100644
--- a/translations/de-DE/data/reusables/sponsors/save-profile.md
+++ b/translations/de-DE/data/reusables/sponsors/save-profile.md
@@ -1 +1 @@
-1. Klicke auf **Update profile** (Profil aktualisieren).
\ No newline at end of file
+1. Klicke auf **Update profile** (Profil aktualisieren).
diff --git a/translations/de-DE/data/reusables/sponsors/set-a-goal.md b/translations/de-DE/data/reusables/sponsors/set-a-goal.md
index dfb8e6bdf780..4b5da02197e8 100644
--- a/translations/de-DE/data/reusables/sponsors/set-a-goal.md
+++ b/translations/de-DE/data/reusables/sponsors/set-a-goal.md
@@ -1 +1 @@
-1. Klicke unter „Your goals" (Deine Ziele) auf **Set a goal** (ein Ziel setzen). ![Schaltfläche „Set a goal" (Ein Ziel setzen) ](/assets/images/help/sponsors/set-a-goal-button.png)
\ No newline at end of file
+1. Klicke unter „Your goals" (Deine Ziele) auf **Set a goal** (ein Ziel setzen). ![Schaltfläche „Set a goal" (Ein Ziel setzen) ](/assets/images/help/sponsors/set-a-goal-button.png)
diff --git a/translations/de-DE/data/reusables/sponsors/short-bio.md b/translations/de-DE/data/reusables/sponsors/short-bio.md
index 4b1fe94f049e..f92d5fe62cfb 100644
--- a/translations/de-DE/data/reusables/sponsors/short-bio.md
+++ b/translations/de-DE/data/reusables/sponsors/short-bio.md
@@ -1 +1 @@
-1. Gib unter „Short bio" (kurzer Lebenslauf) eine kurze Beschreibung von Dir selber und Deiner Arbeit ein. ![Feld „Short bio" (kurzer Lebenslauf)](/assets/images/help/sponsors/short-bio.png)
\ No newline at end of file
+1. Gib unter „Short bio" (kurzer Lebenslauf) eine kurze Beschreibung von Dir selber und Deiner Arbeit ein. ![Feld „Short bio" (kurzer Lebenslauf)](/assets/images/help/sponsors/short-bio.png)
diff --git a/translations/de-DE/data/reusables/sponsors/stripe-supported-regions.md b/translations/de-DE/data/reusables/sponsors/stripe-supported-regions.md
index 1f21b814218f..ba32cb875f26 100644
--- a/translations/de-DE/data/reusables/sponsors/stripe-supported-regions.md
+++ b/translations/de-DE/data/reusables/sponsors/stripe-supported-regions.md
@@ -1 +1 @@
-Für eine Liste der unterstützten Regionen siehe [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors).
+Für eine Liste der unterstützten Regionen siehe [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors#countries).
diff --git a/translations/de-DE/data/reusables/sponsors/you-can-be-a-sponsored-developer.md b/translations/de-DE/data/reusables/sponsors/you-can-be-a-sponsored-developer.md
index 905d92ba6060..53371a58d523 100644
--- a/translations/de-DE/data/reusables/sponsors/you-can-be-a-sponsored-developer.md
+++ b/translations/de-DE/data/reusables/sponsors/you-can-be-a-sponsored-developer.md
@@ -1 +1 @@
-Jeder, der an einem Open-Source-Projekt mitwirkt und ein Bankkonto in einer unterstützten Region hat, kann ein „unterstützter Entwickler" werden. Zu Beiträgen zählen beispielsweise Fehlerberichte, Issue-Triage, Code, Dokumentationen, Leitung, Geschäftsentwicklung, Projektverwaltung, Mentoring und Design. Wenn Du in einer Region lebst, die noch nicht von {% data variables.product.prodname_sponsors %} unterstützt ist, kannst Du Dich in die Warteliste eintragen, um an der Beta-Version von {% data variables.product.prodname_sponsors %} teilzunehmen. Um herauszufinden, ob {% data variables.product.prodname_sponsors %} in Deiner Region verfügbar ist, lies [die Liste der unterstützten Regionen](https://github.com/sponsors#regions).
+Anyone who contributes to an open source project and lives in a supported region is eligible to become a sponsored developer. Zu Beiträgen zählen beispielsweise Fehlerberichte, Issue-Triage, Code, Dokumentationen, Leitung, Geschäftsentwicklung, Projektverwaltung, Mentoring und Design. Wenn Du in einer Region lebst, die noch nicht von {% data variables.product.prodname_sponsors %} unterstützt ist, kannst Du Dich in die Warteliste eintragen, um an der Beta-Version von {% data variables.product.prodname_sponsors %} teilzunehmen.
diff --git a/translations/de-DE/data/reusables/sponsors/you-can-be-a-sponsored-organization.md b/translations/de-DE/data/reusables/sponsors/you-can-be-a-sponsored-organization.md
index df1f90a33d2c..8b1a3ed050da 100644
--- a/translations/de-DE/data/reusables/sponsors/you-can-be-a-sponsored-organization.md
+++ b/translations/de-DE/data/reusables/sponsors/you-can-be-a-sponsored-organization.md
@@ -1 +1 @@
-Jede Organisation, die zu einem Open-Source-Projekt beiträgt und über ein dediziertes Bankkonto in einer unterstützten Region verfügt, kann eine „unterstützte Organisation" werden. Wenn du in einer Region lebst, die nicht bereits von {% data variables.product.prodname_sponsors %} unterstützt wird, tritt der Warteliste unter [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors) bei.
+Any organization that contributes to an open source project and legally operates in a supported region is eligible to become a sponsored organization. If your organization operates in a region that isn't already supported by {% data variables.product.prodname_sponsors %}, join the waitlist at [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors).
diff --git a/translations/de-DE/data/reusables/ssh/dsa-support.md b/translations/de-DE/data/reusables/ssh/dsa-support.md
index 061a28975bcd..6d7877187ee1 100644
--- a/translations/de-DE/data/reusables/ssh/dsa-support.md
+++ b/translations/de-DE/data/reusables/ssh/dsa-support.md
@@ -1,5 +1,5 @@
 {% note %}
 
-**Hinweis:** {% if currentVersion != "free-pro-team@latest" or currentVersion ver_lt "enterprise-server@2.19" %}DSA-Schlüssel wurden in OpenSSH 7.0 als veraltet definiert. Wenn Dein Betriebssystem OpenSSH verwendet, musst Du beim Einrichten von SSH einen alternativen Schlüsseltyp verwenden, wie zum Beispiel einen RSA-Schlüssel. Wenn Dein Betriebssystem zum Beispiel macOS Sierra ist, kannst Du SSH mit einem RSA-Schlüssel einrichten.{% else %}DSA-Schlüssel (SSH-DSS) werden nicht mehr unterstützt. Bestehende Schlüssel werden weiterhin funktionieren, aber du kannst keinen neuen DSA-Schlüssel zu Deinem {% data variables.product.product_name %}-Konto hinzufügen.{% endif %}
+**Note:** DSA keys (SSH-DSS) are no longer supported. Bestehende Schlüssel werden weiterhin funktionieren, aber du kannst keinen neuen DSA-Schlüssel zu Deinem {% data variables.product.product_name %}-Konto hinzufügen.
 
 {% endnote %}
diff --git a/translations/de-DE/data/reusables/support/about-premium-plans.md b/translations/de-DE/data/reusables/support/about-premium-plans.md
index 304ffb0213b8..f42cbc04bef9 100644
--- a/translations/de-DE/data/reusables/support/about-premium-plans.md
+++ b/translations/de-DE/data/reusables/support/about-premium-plans.md
@@ -3,16 +3,16 @@
 
 Es gibt zwei {% data variables.contact.premium_support %}-Pläne: Premium und Premium Plus / {% data variables.product.microsoft_premium_plus_support_plan %}.
 
-|                       | {% data variables.product.premium_support_plan %} | {% data variables.product.premium_plus_support_plan %} |
-| --------------------- | -------------------------------------------------------- | ------------------------------------------------------------- |
-| Geschäftszeiten       | 24 x 7                                                   | 24 x 7                                                        |
-| Erste Reaktionszeit   | 
    • 30 Minuten für {% data variables.product.support_ticket_priority_urgent %}
    • 4 Stunden für {% data variables.product.support_ticket_priority_high %}
                                    | 
    • 30 Minuten für {% data variables.product.support_ticket_priority_urgent %}
    • 4 Stunden für {% data variables.product.support_ticket_priority_high %}
                                         |
-| Supportkanäle         | 
    • Online-Ticket-Übermittlung
    • Telefonischer Support
                                    | 
    • Online-Ticket-Übermittlung
    • Telefonischer Support
    • Bildschirmfreigabe für kritische Probleme
                                         |
-| Schulungen            | Zugriff auf Premium-Inhalte                              | 
    • Zugriff auf Premium-Inhalte
    • 1 virtuelle Schulung pro Jahr
                                         |
-| Autorisierte Kontakte | 10                                                       | 25                                                            |
-| Ressourcen            | Bevorzugte Ticketbearbeitung                             | 
    • Bevorzugte Ticketbearbeitung
    • Namentlich bekannter Technischer Support-Account-Manager
                                         |
-| Geplante Checks       | Halbjährlicher Systemdiagnose und Berichterstellung      | 
    • Vierteljährlicher Systemdiagnose und Berichterstellung
    • Vierteljährliche Konto-Reviews
                                         |
-| Administration        |                                                          | 4 Stunden verwaltete Dienste pro Monat                        |
+|                       | {% data variables.product.premium_support_plan %} | {% data variables.product.premium_plus_support_plan %}
+| --------------------- | --------------------------------------------------- | -------------------------------------------------------- |
+| Geschäftszeiten       | 24 x 7                                              | 24 x 7                                                   |
+| Erste Reaktionszeit   | 
    • 30 Minuten für {% data variables.product.support_ticket_priority_urgent %}
    • 4 Stunden für {% data variables.product.support_ticket_priority_high %}
                               | 
    • 30 Minuten für {% data variables.product.support_ticket_priority_urgent %}
    • 4 Stunden für {% data variables.product.support_ticket_priority_high %}
                                    |
+| Supportkanäle         | 
    • Online-Ticket-Übermittlung
    • Telefonischer Support
                               | 
    • Online-Ticket-Übermittlung
    • Telefonischer Support
    • Bildschirmfreigabe für kritische Probleme
                                    |
+| Schulungen            | Zugriff auf Premium-Inhalte                         | 
    • Zugriff auf Premium-Inhalte
    • 1 virtuelle Schulung pro Jahr
                                    |
+| Autorisierte Kontakte | 10                                                  | 25                                                       |
+| Ressourcen            | Bevorzugte Ticketbearbeitung                        | 
    • Bevorzugte Ticketbearbeitung
    • Namentlich bekannter Technischer Support-Account-Manager
                                    |
+| Geplante Checks       | Halbjährlicher Systemdiagnose und Berichterstellung | 
    • Vierteljährlicher Systemdiagnose und Berichterstellung
    • Vierteljährliche Konto-Reviews
                                    |
+| Administration        |                                                     | 4 Stunden verwaltete Dienste pro Monat                   |
 
   {% note %}
 
diff --git a/translations/de-DE/data/reusables/support/ghec-premium-priorities.md b/translations/de-DE/data/reusables/support/ghec-premium-priorities.md
index 9e3d84be5349..92f09b9c04b9 100644
--- a/translations/de-DE/data/reusables/support/ghec-premium-priorities.md
+++ b/translations/de-DE/data/reusables/support/ghec-premium-priorities.md
@@ -1,6 +1,6 @@
-|                             Priorität                              | Beschreibung                                                                                                                                                                                                                                                                                                                  | Beispiele                 |
-|:------------------------------------------------------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
-| {% data variables.product.support_ticket_priority_urgent %} | Produktions-Workflows für Deine Organisation oder Dein Unternehmen auf {% data variables.product.prodname_ghe_cloud %} schlagen aufgrund kritischer Servicefehler oder -Ausfälle fehl, und der Fehler wirkt sich direkt auf den Betrieb Deines Unternehmens aus.                                                       | 
    • Fehler oder Ausfälle bei {% data variables.product.prodname_dotcom_the_website %}, welche die Kernfunktionen von Git- oder Web-Anwendungen für alle Mitglieder Deiner Organisation oder Deines Unternehmens betreffen
     |
-|  {% data variables.product.support_ticket_priority_high %}  | Konten- oder Sicherheitsprobleme mit Deiner Organisation oder Deinem Unternehmen auf {% data variables.product.prodname_ghe_cloud %} haben nur begrenzte Auswirkungen auf Dein Unternehmen.                                                                                                                            | 
    • Ein Organisations- oder Unternehmensinhaber hat unbeabsichtigt eine Organisation gelöscht
    • Ein Organisations- oder Unternehmensmitglied hat sensitive Daten in einem Commit, einem Issue, einem Pull Request oder einem Issueanhang hochgeladen
     |
+|                           Priorität                           | Beschreibung                                                                                                                                                                                                                                                                                                        | Beispiele                 |
+|:-------------------------------------------------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
+| {% data variables.product.support_ticket_priority_urgent %} | Produktions-Workflows für Deine Organisation oder Dein Unternehmen auf {% data variables.product.prodname_ghe_cloud %} schlagen aufgrund kritischer Servicefehler oder -Ausfälle fehl, und der Fehler wirkt sich direkt auf den Betrieb Deines Unternehmens aus.                                                  | 
    • Fehler oder Ausfälle bei {% data variables.product.prodname_dotcom_the_website %}, welche die Kernfunktionen von Git- oder Web-Anwendungen für alle Mitglieder Deiner Organisation oder Deines Unternehmens betreffen
     |
+|  {% data variables.product.support_ticket_priority_high %}  | Konten- oder Sicherheitsprobleme mit Deiner Organisation oder Deinem Unternehmen auf {% data variables.product.prodname_ghe_cloud %} haben nur begrenzte Auswirkungen auf Dein Unternehmen.                                                                                                                       | 
    • Ein Organisations- oder Unternehmensinhaber hat unbeabsichtigt eine Organisation gelöscht
    • Ein Organisations- oder Unternehmensmitglied hat sensitive Daten in einem Commit, einem Issue, einem Pull Request oder einem Issueanhang hochgeladen
     |
 | {% data variables.product.support_ticket_priority_normal %} | Mitglieder Deiner Organisation oder Deines Unternehmens auf {% data variables.product.prodname_ghe_cloud %} erfahren begrenzte oder moderate Probleme mit {% data variables.product.prodname_dotcom_the_website %}, oder Du hast allgemeine Bedenken oder Fragen über Deine Organisation oder Dein Unternehmen. | 
    • Fragen zur Verwendung von APIs und Features für Deine Organisation oder Dein Unternehmen
    • Issues mit Werkzeugen für die Migration von Organisationsdaten, welche von {% data variables.product.company_short %} zur Verfügung gestellt werden
    • Features im Zusammenhang mit Deiner Organisation oder Deinem Unternehmen funktionieren nicht wir erwartet
    • Allgemeine Sicherheitsfragen zu Deiner Organisation oder Deinem Unternehmen
     |
-|  {% data variables.product.support_ticket_priority_low %}   | Du hast Fragen oder Vorschläge zu Deiner Organisation oder Deinem Unternehmen auf {% data variables.product.prodname_ghe_cloud %}, die weder zeitkritisch sind noch anderweitig die Produktivität Deines Teams blockieren.                                                                                             | 
    • Übermäßige Ressourcennutzung für Deine Organisation oder Dein Unternehmen
    • Anträge auf Systemdiagnosen
    • Hilfe bei der Verwendung von Gists, Benachrichtigungen, Wikis, {% data variables.product.prodname_pages %}, {% data variables.product.prodname_desktop %}, Atom, oder anderen peripheren Diensten oder Features mit Deiner Organisation oder Deinem Unternehmen
    • Feature-Anfragen
    • Produkt Feedback
     |
+|  {% data variables.product.support_ticket_priority_low %}   | Du hast Fragen oder Vorschläge zu Deiner Organisation oder Deinem Unternehmen auf {% data variables.product.prodname_ghe_cloud %}, die weder zeitkritisch sind noch anderweitig die Produktivität Deines Teams blockieren.                                                                                        | 
    • Übermäßige Ressourcennutzung für Deine Organisation oder Dein Unternehmen
    • Anträge auf Systemdiagnosen
    • Hilfe bei der Verwendung von Gists, Benachrichtigungen, Wikis, {% data variables.product.prodname_pages %}, {% data variables.product.prodname_desktop %}, Atom, oder anderen peripheren Diensten oder Features mit Deiner Organisation oder Deinem Unternehmen
    • Feature-Anfragen
    • Produkt Feedback
     |
diff --git a/translations/de-DE/data/reusables/support/ghes-priorities.md b/translations/de-DE/data/reusables/support/ghes-priorities.md
index 443876514361..302bc1161fc2 100644
--- a/translations/de-DE/data/reusables/support/ghes-priorities.md
+++ b/translations/de-DE/data/reusables/support/ghes-priorities.md
@@ -1,6 +1,6 @@
-|                             Priorität                              | Beschreibung                                                                                                                                                                                                                                                               | Beispiele                 |
-|:------------------------------------------------------------------:| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
+|                           Priorität                           | Beschreibung                                                                                                                                                                                                                                                     | Beispiele                 |
+|:-------------------------------------------------------------:| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
 | {% data variables.product.support_ticket_priority_urgent %} | {% data variables.product.prodname_ghe_server %} ist in einer Produktionsumgebung fehlgeschlagen und der Ausfall wirkt sich direkt auf den Betrieb Deines Unternehmens aus.

    _{% data reusables.support.priority-urgent-english-only %}_ | 
    • Fehler oder Ausfälle, die sich auf die Kernfunktionen von Git- oder Web-Anwendungen aller Benutzer auswirken
    • Erhebliche Leistungsverschlechterung für die Mehrheit der Benutzer
    • Voller oder sich schnell füllender Speicher
    • Eine erneuerte Lizenzdatei kann nicht installiert werden
    • Sicherheitsvorfall
    • Verlust des administrativen Zugriffs auf die Instanz ohne bekannte Umgehungslösung
    • Fehler beim Wiederherstellen einer Sicherungsdatei in eine Produktionsumgebung
     |
-|  {% data variables.product.support_ticket_priority_high %}  | {% data variables.product.prodname_ghe_server %} schlägt in einer Produktionsumgebung fehl, aber die Auswirkungen auf den Betrieb Deines Unternehmens sind begrenzt.                                                                                                | 
    • Leistungsverschlechterung, die die Produktivität vieler Benutzer reduziert
    • Reduzierte Redundanz durch den Ausfall von Hochverfügbarkeits- (HA) oder Cluster-Knoten
    • Fehler beim Sichern einer Instanz
    • Fehler bei der Wiederherstellung einer Sicherungsdatei in eine Test- oder Staging-Umgebung, was die erfolgreiche Wiederherstellung einer Produktionsumgebung beeinträchtigen könnte
     |
-| {% data variables.product.support_ticket_priority_normal %} | Du erfährst begrenzte oder moderate Probleme mit {% data variables.product.prodname_ghe_server %}, oder Du hast allgemeine Bedenken oder Fragen zum Betrieb Deiner Instanz.                                                                                         | 
    • Probleme in einer Test- oder Staging-Umgebung
    • Ratschläge zur Verwendung von {% data variables.product.prodname_dotcom %}-APIs und -Features oder Fragen zur Konfiguration von Drittanbieter-Integrationen in Deiner Instanz
    • Issues mit Werkzeugen für die Migration von Benutzerdaten, welche von {% data variables.product.company_short %} zur Verfügung gestellt werden
    • Upgrades
    • Fehlerberichte
    • Features arbeiten nicht wie erwartet
    • Allgemeine Sicherheitsfragen
     |
-|  {% data variables.product.support_ticket_priority_low %}   | Du hast Fragen oder Vorschläge zum {% data variables.product.prodname_ghe_server %}, die weder zeitkritisch sind noch anderweitig die Produktivität Deines Teams blockieren.                                                                                        | 
    • Feature-Anfragen
    • Produkt Feedback
    • Anfragen für Systemdiagnosen (momentan nur verfügbar für Kunden mit einem {% data variables.product.premium_support_plan %})
    • Benachrichtigen von {% data variables.product.company_short %} über geplante Wartungsarbeiten auf Deiner Instanz
     |
+|  {% data variables.product.support_ticket_priority_high %}  | {% data variables.product.prodname_ghe_server %} schlägt in einer Produktionsumgebung fehl, aber die Auswirkungen auf den Betrieb Deines Unternehmens sind begrenzt.                                                                                           | 
    • Leistungsverschlechterung, die die Produktivität vieler Benutzer reduziert
    • Reduzierte Redundanz durch den Ausfall von Hochverfügbarkeits- (HA) oder Cluster-Knoten
    • Fehler beim Sichern einer Instanz
    • Fehler bei der Wiederherstellung einer Sicherungsdatei in eine Test- oder Staging-Umgebung, was die erfolgreiche Wiederherstellung einer Produktionsumgebung beeinträchtigen könnte
     |
+| {% data variables.product.support_ticket_priority_normal %} | Du erfährst begrenzte oder moderate Probleme mit {% data variables.product.prodname_ghe_server %}, oder Du hast allgemeine Bedenken oder Fragen zum Betrieb Deiner Instanz.                                                                                    | 
    • Probleme in einer Test- oder Staging-Umgebung
    • Ratschläge zur Verwendung von {% data variables.product.prodname_dotcom %}-APIs und -Features oder Fragen zur Konfiguration von Drittanbieter-Integrationen in Deiner Instanz
    • Issues mit Werkzeugen für die Migration von Benutzerdaten, welche von {% data variables.product.company_short %} zur Verfügung gestellt werden
    • Upgrades
    • Fehlerberichte
    • Features arbeiten nicht wie erwartet
    • Allgemeine Sicherheitsfragen
     |
+|  {% data variables.product.support_ticket_priority_low %}   | Du hast Fragen oder Vorschläge zum {% data variables.product.prodname_ghe_server %}, die weder zeitkritisch sind noch anderweitig die Produktivität Deines Teams blockieren.                                                                                   | 
    • Feature-Anfragen
    • Produkt Feedback
    • Anfragen für Systemdiagnosen (momentan nur verfügbar für Kunden mit einem {% data variables.product.premium_support_plan %})
    • Benachrichtigen von {% data variables.product.company_short %} über geplante Wartungsarbeiten auf Deiner Instanz
     |
diff --git a/translations/de-DE/data/reusables/support/priority-urgent-english-only.md b/translations/de-DE/data/reusables/support/priority-urgent-english-only.md
index 0027a76ab718..080f9bc36045 100644
--- a/translations/de-DE/data/reusables/support/priority-urgent-english-only.md
+++ b/translations/de-DE/data/reusables/support/priority-urgent-english-only.md
@@ -1 +1 @@
-Unterstützung für Tickets mit {% data variables.product.support_ticket_priority_urgent %}-Priorität ist nur in englischer Sprache verfügbar.
\ No newline at end of file
+Unterstützung für Tickets mit {% data variables.product.support_ticket_priority_urgent %}-Priorität ist nur in englischer Sprache verfügbar.
diff --git a/translations/de-DE/data/reusables/support/receiving-credits.md b/translations/de-DE/data/reusables/support/receiving-credits.md
index 14d46b3c97b3..62872ec34709 100644
--- a/translations/de-DE/data/reusables/support/receiving-credits.md
+++ b/translations/de-DE/data/reusables/support/receiving-credits.md
@@ -1,12 +1,12 @@
 
 ### Erhalten von Gutschriften für verspätete Antworten auf Support-Tickets
 
-Wenn Du basierend auf dem {% data variables.product.company_short %}-Geschäftsjahr für mehr als vier Tickets in einem bestimmten Quartal keine erste Antwort innerhalb der garantierten Reaktionszeit erhältst, bist Du für eine Gutschrift berechtigt. Unter Berücksichtigung des SLA erstattet {% data variables.product.company_short %} 20 % der vierteljährlichen {% data variables.contact.premium_support %}-Gebühr in bar zurück. Für die Rückerstattung musst Du eine Gutschriftsanforderung absenden.
+Wenn Du basierend auf dem {% data variables.product.company_short %}-Geschäftsjahr für mehr als vier Tickets in einem bestimmten Quartal keine erste Antwort innerhalb der garantierten Reaktionszeit erhältst, bist Du für eine Gutschrift berechtigt. Unter Berücksichtigung des SLAs erstattet {% data variables.product.company_short %} 20 % der vierteljährlichen {% data variables.contact.premium_support %}-Gebühr in bar zurück.  Für die Rückerstattung musst Du eine Gutschriftsanforderung absenden.
 
 Die Gutschriftsanforderung muss innerhalb von 30 Tagen nach Ende des Quartals gestellt werden, in dem {% data variables.contact.premium_support %} nicht innerhalb der festgelegten Reaktionszeiten auf Deine Tickets geantwortet hat. Gutschriftsanforderungen werden nach dem Verstreichen der entsprechenden Frist nicht mehr berücksichtigt. Nach dem Verstreichen der entsprechenden Frist hast Du auf die Möglichkeit verzichtet, eine Rückerstattung für die qualifizierte Gutschrift zu beantragen.
 
 Für den Erhalt einer Rückerstattung musst Du eine ausgefüllte Gutschriftsanforderung an  senden. Um berechtigt zu sein, muss die Gutschriftsanforderung:
-- Über eine Deinem {% data variables.product.product_name %}-Konto zugeordnete E-Mail-Adresse gesendet werden
+- über eine Ihrem {% data variables.product.product_name %}-Konto zugeordnete E-Mail-Adresse gesendet werden,
 - Am Ende des 30. Tages nach dem Quartal, in dem die vier qualifizierenden Gutschriften aufgetreten sind, von {% data variables.product.company_short %} empfangen worden sein,
 - „Gutschriftsanforderung" in der Betreffzeile enthalten
 
@@ -14,6 +14,6 @@ Die folgenden Informationen **müssen** in Deiner Gutschriftsanforderung enthalt
 - **Datum** (Das Datum muss innerhalb von 30 Tagen nach dem Quartal liegen, basierend auf dem Geschäftsjahr von {% data variables.product.company_short %}, in dem die Ansprüche auftraten [31. Januar, 30. April, 31. Juli oder 31. Oktober].)
 - **Kundenkontakt** (Du musst einen Namen und eine E-Mail-Adresse angeben.)
 - **Kundenadresse**
-- **Qualifizierende Gutschriften** (Du musst das Datum jeder qualifizierenden Gutschrift und die zugeordnete Ticketnummer angeben.){% if currentVersion == "free-pro-team@latest" %}
+- **Qualifying credits** (You must provide the date of each qualifying credit and the associated ticket number.){% if currentVersion == "free-pro-team@latest" %}
 - **Name der {% data variables.product.prodname_ghe_cloud %}-Organisation**{% endif %}
 - **Ticketnummern**
diff --git a/translations/de-DE/data/reusables/support/scope-of-support.md b/translations/de-DE/data/reusables/support/scope-of-support.md
index 7d09b71095c1..d41b7787983a 100644
--- a/translations/de-DE/data/reusables/support/scope-of-support.md
+++ b/translations/de-DE/data/reusables/support/scope-of-support.md
@@ -1,7 +1,7 @@
 
 ### Supportumfang
 
-Wenn Deine Supportanfrage außerhalb des Bereichs liegt, in dem unser Team Dir helfen kann, können wir weiter Schritte empfehlen, damit Du Deinen Issue außerhalb von {% data variables.contact.github_support %} beheben kannst. Deine Supportanfrage liegt möglicherweise nicht im Bereich von {% data variables.contact.github_support %}, wenn sie sich primär auf Folgendes bezieht:
+Wenn Ihre Supportanfrage außerhalb des Geltungsbereichs liegt, bei dem unser Team Ihnen helfen kann, können wir Ihnen die nächsten Schritte empfehlen, damit Sie Ihren Issue außerhalb von {% data variables.contact.github_support %} beheben können. Ihre Supportanfrage liegt möglicherweise nicht im Umfang von {% data variables.contact.github_support %}, wenn sie sich primär auf Folgendes bezieht:
 - Integration von Drittanbietern
 - Hardware-Einstellungen
 - CI/CD, beispielsweise Jenkins
diff --git a/translations/de-DE/data/reusables/support/service-level-agreement-response-times.md b/translations/de-DE/data/reusables/support/service-level-agreement-response-times.md
index 3403240cfeb1..db4b476e5c65 100644
--- a/translations/de-DE/data/reusables/support/service-level-agreement-response-times.md
+++ b/translations/de-DE/data/reusables/support/service-level-agreement-response-times.md
@@ -2,7 +2,7 @@
 
 Für die von Dir abgesendeten Tickets steht der Support 7 Tage pro Woche und 24 Stunden pro Tag zur Verfügung. Die erste Reaktionszeit, die vom SLA garantiert wird, hängt von der Prioritätsstufe des Tickets ab. Die Reaktionszeit beginnt, wenn {% data variables.contact.premium_support %} die Prioritätsstufe des Tickets festlegt. Eine Antwort bedeutet nicht, dass der Issue behoben wurde.
 
-| Ticket-Prioritätsstufe                                             | Erste Reaktionszeit |
-| ------------------------------------------------------------------ | ------------------- |
+| Ticket-Prioritätsstufe                                        | Erste Reaktionszeit |
+| ------------------------------------------------------------- | ------------------- |
 | {% data variables.product.support_ticket_priority_urgent %} | 30 Minuten          |
 | {% data variables.product.support_ticket_priority_high %}   | 4 Stunden           |
diff --git a/translations/de-DE/data/reusables/two_fa/about-2fa.md b/translations/de-DE/data/reusables/two_fa/about-2fa.md
new file mode 100644
index 000000000000..704cb699cc2e
--- /dev/null
+++ b/translations/de-DE/data/reusables/two_fa/about-2fa.md
@@ -0,0 +1 @@
+Two-factor authentication (2FA) is an extra layer of security used when logging into websites or apps.
diff --git a/translations/de-DE/data/reusables/two_fa/after-2fa-add-security-key.md b/translations/de-DE/data/reusables/two_fa/after-2fa-add-security-key.md
index dc269fb8c548..0e417d28486b 100644
--- a/translations/de-DE/data/reusables/two_fa/after-2fa-add-security-key.md
+++ b/translations/de-DE/data/reusables/two_fa/after-2fa-add-security-key.md
@@ -1 +1 @@
-Nachdem Du 2FA mit einer mobilen App{% if currentVersion == "free-pro-team@latest" %} oder per SMS{% endif %} konfiguriert hast, kannst Du einen Sicherheitsschlüssel hinzufügen, zum Beispiel einen Fingerabdruckleser oder Windows Hello. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}Die Technologie, welche die Authentifizierung mit einem Sicherheitsschlüssel ermöglicht, heißt WebAuthn. WebAuthn ist der Nachfolger von U2F und arbeitet in allen modernen Browsern. Weitere Informationen findest du unter „[WebAuthn](https://webauthn.guide/)" und „[Can I Use](https://caniuse.com/#search=webauthn)" (Kann ich es verwenden).{% else %}FIDO U2F Authentifizierung ist momentan verfügbar für die Browser Chrome, Firefox und Opera.{% endif %}
+After you configure 2FA using a mobile app{% if currentVersion == "free-pro-team@latest" %} or via text message{% endif %}, you can add a security key, like a fingerprint reader or Windows Hello. The technology that enables authentication with a security key is called WebAuthn. WebAuthn ist der Nachfolger von U2F und arbeitet in allen modernen Browsern. For more information, see "[WebAuthn](https://webauthn.guide/)" and "[Can I Use](https://caniuse.com/#search=webauthn)."
diff --git a/translations/de-DE/data/reusables/two_fa/auth_methods_2fa.md b/translations/de-DE/data/reusables/two_fa/auth_methods_2fa.md
index 5c127dec3552..60697f9581be 100644
--- a/translations/de-DE/data/reusables/two_fa/auth_methods_2fa.md
+++ b/translations/de-DE/data/reusables/two_fa/auth_methods_2fa.md
@@ -1,10 +1,10 @@
 {% if currentVersion != "free-pro-team@latest" %}
 ### Authentifizierungsmethoden, die 2FA unterstützen
 
-| Authentifizierungsmethode                                  | Beschreibung                                                                                                                                      | Unterstützung der Zwei-Faktor-Authentifizierung                                                                                                                                                                                                                                             |
-| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Authentifizierungsmethode                                  | Beschreibung                                                                                                                                 | Unterstützung der Zwei-Faktor-Authentifizierung                                                                                                                                                                                                                                                        |
+| ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | Integriert                                                 | Die Authentifizierung erfolgt über Benutzerkonten, die in der {% data variables.product.prodname_ghe_server %}-Appliance gespeichert sind. | Wird in der {% data variables.product.prodname_ghe_server %}-Appliance unterstützt und verwaltet. Organisationsadministratoren können vorschreiben, dass die Zwei-Faktor-Authentifizierung für Mitglieder der Organisation aktiviert werden muss. |{% if currentVersion != "free-pro-team@latest" %}
-| Integrierte Authentifizierung mit einem Identitätsanbieter | Die Authentifizierung erfolgt über Benutzerkonten, die beim Identitätsanbieter gespeichert sind.                                                  | Ist vom Identitätsanbieter abhängig.{% endif %}
-| LDAP                                                       | Erlaubt die Integration in Deinen Unternehmens-Verzeichnisdienst für Authentifizierung.                                                           | Wird in der {% data variables.product.prodname_ghe_server %}-Appliance unterstützt und verwaltet. Organisationsadministratoren können vorschreiben, dass die Zwei-Faktor-Authentifizierung für Mitglieder der Organisation aktiviert werden muss.                                    |
-| SAML                                                       | Die Authentifizierung erfolgt über einen externen Identitätsanbieter.                                                                             | {% data reusables.two_fa.2fa_not_supported_with_saml_and_cas %}                                                                                                                                                                                                                  |
-| CAS                                                        | Der Single Sign-On-Dienst wird von einem externen Server bereitgestellt.                                                                          | {% data reusables.two_fa.2fa_not_supported_with_saml_and_cas %}{% endif %}
+| Integrierte Authentifizierung mit einem Identitätsanbieter | Die Authentifizierung erfolgt über Benutzerkonten, die beim Identitätsanbieter gespeichert sind.                                             | Ist vom Identitätsanbieter abhängig.{% endif %}
+| LDAP                                                       | Erlaubt die Integration in Deinen Unternehmens-Verzeichnisdienst für Authentifizierung.                                                      | Wird in der {% data variables.product.prodname_ghe_server %}-Appliance unterstützt und verwaltet. Organisationsadministratoren können vorschreiben, dass die Zwei-Faktor-Authentifizierung für Mitglieder der Organisation aktiviert werden muss.                                                    |
+| SAML                                                       | Die Authentifizierung erfolgt über einen externen Identitätsanbieter.                                                                        | {% data reusables.two_fa.2fa_not_supported_with_saml_and_cas %}
+| CAS                                                        | Der Single Sign-On-Dienst wird von einem externen Server bereitgestellt.                                                                     | {% data reusables.two_fa.2fa_not_supported_with_saml_and_cas %}{% endif %}
diff --git a/translations/de-DE/data/reusables/user_settings/about-commit-email-addresses.md b/translations/de-DE/data/reusables/user_settings/about-commit-email-addresses.md
index d445e76b8ec4..c1d07e76835b 100644
--- a/translations/de-DE/data/reusables/user_settings/about-commit-email-addresses.md
+++ b/translations/de-DE/data/reusables/user_settings/about-commit-email-addresses.md
@@ -1 +1 @@
-Weitere Informationen zu Commit-E-Mail-Adressen{% if currentVersion == "free-pro-team@latest" %}, einschließlich Deiner von {% data variables.product.product_name %} bereitgestellten `no-reply` E-Mail-Adresse,{% endif %} findest Du unter „[Festlegen Deiner Commit-E-Mail-Adresse](/articles/setting-your-commit-email-address)."
+For more information on commit email addresses,{% if currentVersion == "free-pro-team@latest" %} including your {% data variables.product.product_name %}-provided `noreply` email address,{% endif %} see "[Setting your commit email address](/articles/setting-your-commit-email-address)."
diff --git a/translations/de-DE/data/reusables/user_settings/export-data.md b/translations/de-DE/data/reusables/user_settings/export-data.md
index 4e4ca88c7150..857cba63b9c9 100644
--- a/translations/de-DE/data/reusables/user_settings/export-data.md
+++ b/translations/de-DE/data/reusables/user_settings/export-data.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-Du kannst die Metadaten, die {% data variables.product.product_name %} über Dein persönliches Konto speichert, exportieren und überprüfen.
+You can export and review the metadata that
+{% data variables.product.product_name %} stores about your personal account.
 {% endif %}
diff --git a/translations/de-DE/data/reusables/user_settings/password-authentication-deprecation.md b/translations/de-DE/data/reusables/user_settings/password-authentication-deprecation.md
index 162de178f843..939ac37eda71 100644
--- a/translations/de-DE/data/reusables/user_settings/password-authentication-deprecation.md
+++ b/translations/de-DE/data/reusables/user_settings/password-authentication-deprecation.md
@@ -1 +1 @@
-Password-based authentication for Git is deprecated, and we recommend using a personal access token (PAT) when prompted for a password instead, which is more secure. Treat your token just like a password. Weitere Informationen finden Sie unter "[Erstellen eines persönlichen Zugriffstokens](/github/authenticating-to-github/creating-a-personal-access-token)."
\ No newline at end of file
+Password-based authentication for Git is deprecated, and we recommend using a personal access token (PAT) when prompted for a password instead, which is more secure. Treat your token just like a password. Weitere Informationen finden Sie unter "[Erstellen eines persönlichen Zugriffstokens](/github/authenticating-to-github/creating-a-personal-access-token)."
diff --git a/translations/de-DE/data/reusables/user_settings/personal_dashboard.md b/translations/de-DE/data/reusables/user_settings/personal_dashboard.md
index 962fe3e81659..07083b821d07 100644
--- a/translations/de-DE/data/reusables/user_settings/personal_dashboard.md
+++ b/translations/de-DE/data/reusables/user_settings/personal_dashboard.md
@@ -1 +1 @@
-{% if currentVersion == "free-pro-team@latest" %}[Persönliches Dashboard](https://github.com/dashboard){% else %}Persönliches Dashboard (`https://[hostname]/dashboard`){% endif %}
+{% if currentVersion == "free-pro-team@latest" %}[personal dashboard](https://github.com/dashboard){% else %}personal dashboard (`https://[hostname]/dashboard`){% endif %}
diff --git a/translations/de-DE/data/reusables/user_settings/set_your_email_address_in_git.md b/translations/de-DE/data/reusables/user_settings/set_your_email_address_in_git.md
index 62241446176e..750c779daddb 100644
--- a/translations/de-DE/data/reusables/user_settings/set_your_email_address_in_git.md
+++ b/translations/de-DE/data/reusables/user_settings/set_your_email_address_in_git.md
@@ -1 +1 @@
-Lege in Git eine E-Mail-Adresse fest. Du kannst {% if currentVersion == "free-pro-team@latest"%}Deine von [{% data variables.product.product_name %} zur Verfügung gestellte `no-reply` E-Mail-Adresse](/articles/setting-your-commit-email-address) oder {% endif %}eine beliebige E-Mail-Adresse verwenden.
+Lege in Git eine E-Mail-Adresse fest. You can use {% if currentVersion == "free-pro-team@latest"%}your [{% data variables.product.product_name %}-provided `no-reply` email address](/articles/setting-your-commit-email-address) or {% endif %}any email address.
diff --git a/translations/de-DE/data/reusables/user_settings/sudo-mode-popup.md b/translations/de-DE/data/reusables/user_settings/sudo-mode-popup.md
index 68233a0ee7d5..6e51221b5fec 100644
--- a/translations/de-DE/data/reusables/user_settings/sudo-mode-popup.md
+++ b/translations/de-DE/data/reusables/user_settings/sudo-mode-popup.md
@@ -1 +1 @@
-1. Wenn Du dazu aufgefordert wirst, bestätige Dein {% data variables.product.product_name %}-Passwort. ![Sudo-Modus-Dialog](/assets/images/help/settings/sudo_mode_popup.png)
\ No newline at end of file
+1. Wenn Du dazu aufgefordert wirst, bestätige Dein {% data variables.product.product_name %}-Passwort. ![Sudo-Modus-Dialog](/assets/images/help/settings/sudo_mode_popup.png)
diff --git a/translations/de-DE/data/reusables/webhooks/action_type_desc.md b/translations/de-DE/data/reusables/webhooks/action_type_desc.md
index 3342e6e1c6ec..43e5cb80e4f5 100644
--- a/translations/de-DE/data/reusables/webhooks/action_type_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/action_type_desc.md
@@ -1 +1 @@
-The type of activity is specified in the `action` property of the payload object.
\ No newline at end of file
+The type of activity is specified in the `action` property of the payload object.
diff --git a/translations/de-DE/data/reusables/webhooks/app_desc.md b/translations/de-DE/data/reusables/webhooks/app_desc.md
index 9dbfd79e4d6f..e81bab2cf4dc 100644
--- a/translations/de-DE/data/reusables/webhooks/app_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/app_desc.md
@@ -1 +1 @@
-`installation` | `object` | The {% data variables.product.prodname_github_app %} installation. Webhook payloads contain the `installation` property when the event is configured for and sent to a {% data variables.product.prodname_github_app %}.
\ No newline at end of file
+`installation` | `object` | The {% data variables.product.prodname_github_app %} installation. Webhook payloads contain the `installation` property when the event is configured for and sent to a {% data variables.product.prodname_github_app %}.
diff --git a/translations/de-DE/data/reusables/webhooks/check_run_properties.md b/translations/de-DE/data/reusables/webhooks/check_run_properties.md
index 7fdab6f13553..950c1681546f 100644
--- a/translations/de-DE/data/reusables/webhooks/check_run_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/check_run_properties.md
@@ -1,10 +1,10 @@
-| Schlüssel                      | Typ       | Beschreibung                                                                                                                                                                                                                                                                                                          |
-| ------------------------------ | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `action`                       | `string`  | The action performed. Can be one of: 
    •  `created` - A new check run was created.
    •  `completed` - The `status` of the check run is `completed`.
    •  `rerequested` - Someone requested to re-run your check run from the pull request UI. See "[About status checks](/articles/about-status-checks#checks)" for more details about the GitHub UI. When you receive a `rerequested` action, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run). Only the {% data variables.product.prodname_github_app %} that someone requests to re-run the check will receive the `rerequested` payload.
    •  `requested_action` - Someone requested an action your app provides to be taken. Only the {% data variables.product.prodname_github_app %} someone requests to perform an action will receive the `requested_action` payload. To learn more about check runs and requested actions, see "[Check runs and requested actions](/v3/checks/runs/#check-runs-and-requested-actions)."
                                                                                                                                                                                                                                                             |
-| `check_run`                    | `Objekt`  | The [check_run](/v3/checks/runs/#get-a-check-run).                                                                                                                                                                                                                                                                    |
-| `check_run[status]`            | `string`  | The current status of the check run. Can be `queued`, `in_progress`, or `completed`.                                                                                                                                                                                                                                  |
+| Schlüssel                      | Typ       | Beschreibung                                                                                                                                                                                                                                                                                                                                              |
+| ------------------------------ | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `action`                       | `string`  | The action performed. Can be one of: 
    •  `created` - A new check run was created.
    •  `completed` - The `status` of the check run is `completed`.
    •  `rerequested` - Someone requested to re-run your check run from the pull request UI. See "[About status checks](/articles/about-status-checks#checks)" for more details about the GitHub UI. When you receive a `rerequested` action, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run). Only the {% data variables.product.prodname_github_app %} that someone requests to re-run the check will receive the `rerequested` payload.
    •  `requested_action` - Someone requested an action your app provides to be taken. Only the {% data variables.product.prodname_github_app %} someone requests to perform an action will receive the `requested_action` payload. To learn more about check runs and requested actions, see "[Check runs and requested actions](/v3/checks/runs/#check-runs-and-requested-actions)."
                                                                                                                                                                                                                                                                                                 |
+| `check_run`                    | `Objekt`  | The [check_run](/v3/checks/runs/#get-a-check-run).                                                                                                                                                                                                                                                                                                        |
+| `check_run[status]`            | `string`  | The current status of the check run. Can be `queued`, `in_progress`, or `completed`.                                                                                                                                                                                                                                                                      |
 | `check_run[conclusion]`        | `string`  | The result of the completed check run. Can be one of `success`, `failure`, `neutral`, `cancelled`, `timed_out`,  {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}`action_required` or `stale`{% else %}or `action_required`{% endif %}. This value will be `null` until the check run has `completed`. |
-| `check_run[name]`              | `string`  | The name of the check run.                                                                                                                                                                                                                                                                                            |
-| `check_run[check_suite][id]`   | `integer` | The id of the check suite that this check run is part of.                                                                                                                                                                                                                                                             |
-| `requested_action`             | `Objekt`  | The action requested by the user.                                                                                                                                                                                                                                                                                     |
-| `requested_action[identifier]` | `string`  | The integrator reference of the action requested by the user.                                                                                                                                                                                                                                                         |
\ No newline at end of file
+| `check_run[name]`              | `string`  | The name of the check run.                                                                                                                                                                                                                                                                                                                                |
+| `check_run[check_suite][id]`   | `integer` | The id of the check suite that this check run is part of.                                                                                                                                                                                                                                                                                                 |
+| `requested_action`             | `Objekt`  | The action requested by the user.                                                                                                                                                                                                                                                                                                                         |
+| `requested_action[identifier]` | `string`  | The integrator reference of the action requested by the user.                                                                                                                                                                                                                                                                                             |
diff --git a/translations/de-DE/data/reusables/webhooks/check_run_short_desc.md b/translations/de-DE/data/reusables/webhooks/check_run_short_desc.md
index 305bd1626e33..19fd0846b885 100644
--- a/translations/de-DE/data/reusables/webhooks/check_run_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/check_run_short_desc.md
@@ -1 +1 @@
-Check run activity has occurred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[check runs](/v3/checks/runs/)" REST API.
\ No newline at end of file
+Check run activity has occurred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[check runs](/v3/checks/runs/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/check_suite_properties.md b/translations/de-DE/data/reusables/webhooks/check_suite_properties.md
index e4c9136675b9..75421c7bdf4d 100644
--- a/translations/de-DE/data/reusables/webhooks/check_suite_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/check_suite_properties.md
@@ -1,10 +1,10 @@
-| Schlüssel                    | Typ      | Beschreibung                                                                                                                                                                                                                                                                                                                                               |
-| ---------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `action`                     | `string` | The action performed. Can be:
    • `completed` - All check runs in a check suite have completed.
    • `requested` - Occurs when new code is pushed to the app's repository. When you receive the `requested` action events, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run).
    • `rerequested` - Occurs when someone requests to re-run the entire check suite from the pull request UI. When you receive the `rerequested` action events, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run). See "[About status checks](/articles/about-status-checks#checks)" for more details about the GitHub UI.
                                                                                                                                                                                                                                                                                                         |
-| `check_suite`                | `Objekt` | The [check_suite](/v3/checks/suites/).                                                                                                                                                                                                                                                                                                                     |
-| `check_suite[head_branch]`   | `string` | The head branch name the changes are on.                                                                                                                                                                                                                                                                                                                   |
-| `check_suite[head_sha]`      | `string` | The SHA of the most recent commit for this check suite.                                                                                                                                                                                                                                                                                                    |
-| `check_suite[status]`        | `string` | The summary status for all check runs that are part of the check suite. Can be `requested`, `in_progress`, or `completed`.                                                                                                                                                                                                                                 |
+| Schlüssel                    | Typ      | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                   |
+| ---------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `action`                     | `string` | The action performed. Can be:
    • `completed` - All check runs in a check suite have completed.
    • `requested` - Occurs when new code is pushed to the app's repository. When you receive the `requested` action events, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run).
    • `rerequested` - Occurs when someone requests to re-run the entire check suite from the pull request UI. When you receive the `rerequested` action events, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run). See "[About status checks](/articles/about-status-checks#checks)" for more details about the GitHub UI.
                                                                                                                                                                                                                                                                                                                                             |
+| `check_suite`                | `Objekt` | The [check_suite](/v3/checks/suites/).                                                                                                                                                                                                                                                                                                                                                         |
+| `check_suite[head_branch]`   | `string` | The head branch name the changes are on.                                                                                                                                                                                                                                                                                                                                                       |
+| `check_suite[head_sha]`      | `string` | The SHA of the most recent commit for this check suite.                                                                                                                                                                                                                                                                                                                                        |
+| `check_suite[status]`        | `string` | The summary status for all check runs that are part of the check suite. Can be `requested`, `in_progress`, or `completed`.                                                                                                                                                                                                                                                                     |
 | `check_suite[conclusion]`    | `string` | The summary conclusion for all check runs that are part of the check suite. Can be one of `success`, `failure`, `neutral`, `cancelled`, `timed_out`,  {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}`action_required` or `stale`{% else %}or `action_required`{% endif %}. This value will be `null` until the check run has `completed`. |
-| `check_suite[url]`           | `string` | URL that points to the check suite API resource.                                                                                                                                                                                                                                                                                                           |
-| `check_suite[pull_requests]` | `array`  | An array of pull requests that match this check suite. A pull request matches a check suite if they have the same `head_sha` and `head_branch`. When the check suite's `head_branch` is in a forked repository it will be `null` and the `pull_requests` array will be empty.                                                                              |
\ No newline at end of file
+| `check_suite[url]`           | `string` | URL that points to the check suite API resource.                                                                                                                                                                                                                                                                                                                                               |
+| `check_suite[pull_requests]` | `array`  | An array of pull requests that match this check suite. A pull request matches a check suite if they have the same `head_sha` and `head_branch`. When the check suite's `head_branch` is in a forked repository it will be `null` and the `pull_requests` array will be empty.                                                                                                                  |
diff --git a/translations/de-DE/data/reusables/webhooks/check_suite_short_desc.md b/translations/de-DE/data/reusables/webhooks/check_suite_short_desc.md
index f7197fc59e48..00c4c00937f9 100644
--- a/translations/de-DE/data/reusables/webhooks/check_suite_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/check_suite_short_desc.md
@@ -1 +1 @@
-Check suite activity has occurred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[check suites](/v3/checks/suites/)" REST API.
\ No newline at end of file
+Check suite activity has occurred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[check suites](/v3/checks/suites/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/code_scanning_alert_event_short_desc.md b/translations/de-DE/data/reusables/webhooks/code_scanning_alert_event_short_desc.md
index e246022ed42e..e5163ce2d013 100644
--- a/translations/de-DE/data/reusables/webhooks/code_scanning_alert_event_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/code_scanning_alert_event_short_desc.md
@@ -1 +1 @@
-Activity related to code scanning alerts in a repository. The type of activity is specified in the action property of the payload object. For more information, see “[About code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning).”
\ No newline at end of file
+Activity related to code scanning alerts in a repository. The type of activity is specified in the action property of the payload object. For more information, see “[About code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning).”
diff --git a/translations/de-DE/data/reusables/webhooks/commit_comment_properties.md b/translations/de-DE/data/reusables/webhooks/commit_comment_properties.md
index e58de78c936e..0081aa664544 100644
--- a/translations/de-DE/data/reusables/webhooks/commit_comment_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/commit_comment_properties.md
@@ -1,4 +1,4 @@
 | Schlüssel      | Typ      | Beschreibung                                                             |
 | -------------- | -------- | ------------------------------------------------------------------------ |
 | `action`       | `string` | The action performed. Can be `created`.                                  |
-| `kommentieren` | `Objekt` | The [commit comment](/v3/repos/comments/#get-a-commit-comment) resource. |
\ No newline at end of file
+| `kommentieren` | `Objekt` | The [commit comment](/v3/repos/comments/#get-a-commit-comment) resource. |
diff --git a/translations/de-DE/data/reusables/webhooks/commit_comment_short_desc.md b/translations/de-DE/data/reusables/webhooks/commit_comment_short_desc.md
index 918e0279b925..20e258a1ea1f 100644
--- a/translations/de-DE/data/reusables/webhooks/commit_comment_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/commit_comment_short_desc.md
@@ -1 +1 @@
-A commit comment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[commit comment](/v3/repos/comments/)" REST API.
\ No newline at end of file
+A commit comment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[commit comment](/v3/repos/comments/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/content_reference_short_desc.md b/translations/de-DE/data/reusables/webhooks/content_reference_short_desc.md
index b7880d039d3a..5187dbb40bc8 100644
--- a/translations/de-DE/data/reusables/webhooks/content_reference_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/content_reference_short_desc.md
@@ -1 +1 @@
-A new content reference is `created`. A new content reference is created when the body or comment of an issue or pull request includes a URL that matches a configured content reference domain. For more information, see "[Using content attachments](/apps/using-content-attachments/)" to learn more about content references and attachments.
\ No newline at end of file
+A new content reference is `created`. A new content reference is created when the body or comment of an issue or pull request includes a URL that matches a configured content reference domain. For more information, see "[Using content attachments](/apps/using-content-attachments/)" to learn more about content references and attachments.
diff --git a/translations/de-DE/data/reusables/webhooks/create_properties.md b/translations/de-DE/data/reusables/webhooks/create_properties.md
index dce46627e77f..089d43194435 100644
--- a/translations/de-DE/data/reusables/webhooks/create_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/create_properties.md
@@ -1,6 +1,6 @@
-| Schlüssel       | Typ      | Beschreibung                                                                                                                                                                                         |
-| --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `ref`           | `string` | {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}The [`git ref`](/v3/git/refs/#get-a-reference) resource.{% else %}The [`git ref`](/v3/git/refs/#get-a-reference) resource.{% endif %}
-| `ref_type`      | `string` | The type of Git ref object created in the repository. Can be either `branch` or `tag`.                                                                                                               |
-| `master_branch` | `string` | The name of the repository's default branch (usually `master`).                                                                                                                                      |
-| `Beschreibung`  | `string` | The repository's current description.                                                                                                                                                                |
\ No newline at end of file
+| Schlüssel       | Typ      | Beschreibung                                                                                                                                                                                  |
+| --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `ref`           | `string` | The [`git ref`](/v3/git/refs/#get-a-reference) resource.                                                                                                                                      |
+| `ref_type`      | `string` | The type of Git ref object created in the repository. Can be either `branch` or `tag`.                                                                                                        |
+| `master_branch` | `string` | The name of the repository's default branch (usually {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.23" %}`main`{% else %}`master`{% endif %}). |
+| `Beschreibung`  | `string` | The repository's current description.                                                                                                                                                         |
diff --git a/translations/de-DE/data/reusables/webhooks/create_short_desc.md b/translations/de-DE/data/reusables/webhooks/create_short_desc.md
index 0140bfadf5c2..a43ab3994391 100644
--- a/translations/de-DE/data/reusables/webhooks/create_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/create_short_desc.md
@@ -1 +1 @@
-A Git branch or tag is created. For more information, see the "[Git data](/v3/git/)" REST API.
\ No newline at end of file
+A Git branch or tag is created. For more information, see the "[Git data](/v3/git/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/delete_properties.md b/translations/de-DE/data/reusables/webhooks/delete_properties.md
index 25b4410f6251..6bc323fd1e99 100644
--- a/translations/de-DE/data/reusables/webhooks/delete_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/delete_properties.md
@@ -1,4 +1,4 @@
-| Schlüssel  | Typ      | Beschreibung                                                                                                                                                                                         |
-| ---------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `ref`      | `string` | {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}The [`git ref`](/v3/git/refs/#get-a-reference) resource.{% else %}The [`git ref`](/v3/git/refs/#get-a-reference) resource.{% endif %}
-| `ref_type` | `string` | The type of Git ref oject deleted in the repository. Can be `branch` or `tag`.                                                                                                                       |
\ No newline at end of file
+| Schlüssel  | Typ      | Beschreibung                                                                   |
+| ---------- | -------- | ------------------------------------------------------------------------------ |
+| `ref`      | `string` | The [`git ref`](/v3/git/refs/#get-a-reference) resource.                       |
+| `ref_type` | `string` | The type of Git ref oject deleted in the repository. Can be `branch` or `tag`. |
diff --git a/translations/de-DE/data/reusables/webhooks/delete_short_desc.md b/translations/de-DE/data/reusables/webhooks/delete_short_desc.md
index 60568e8b0958..7557d8e4edb3 100644
--- a/translations/de-DE/data/reusables/webhooks/delete_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/delete_short_desc.md
@@ -1 +1 @@
-A Git branch or tag is deleted. For more information, see the "[Git data](/v3/git/)" REST API.
\ No newline at end of file
+A Git branch or tag is deleted. For more information, see the "[Git data](/v3/git/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/deploy_key_properties.md b/translations/de-DE/data/reusables/webhooks/deploy_key_properties.md
index 16163e2241c4..0fa70fac71e4 100644
--- a/translations/de-DE/data/reusables/webhooks/deploy_key_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/deploy_key_properties.md
@@ -1,4 +1,4 @@
 | Schlüssel   | Typ      | Beschreibung                                                   |
 | ----------- | -------- | -------------------------------------------------------------- |
 | `action`    | `string` | The action performed. Can be either `created` or `deleted`.    |
-| `Schlüssel` | `Objekt` | The [`deploy key`](/v3/repos/keys/#get-a-deploy-key) resource. |
\ No newline at end of file
+| `Schlüssel` | `Objekt` | The [`deploy key`](/v3/repos/keys/#get-a-deploy-key) resource. |
diff --git a/translations/de-DE/data/reusables/webhooks/deploy_key_short_desc.md b/translations/de-DE/data/reusables/webhooks/deploy_key_short_desc.md
index 551eef44c5cc..c83fe68579c6 100644
--- a/translations/de-DE/data/reusables/webhooks/deploy_key_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/deploy_key_short_desc.md
@@ -1 +1 @@
-A deploy key is added or removed from a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[Deploy keys](/v3/repos/keys/)" REST API.
\ No newline at end of file
+A deploy key is added or removed from a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[Deploy keys](/v3/repos/keys/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/deployment_short_desc.md b/translations/de-DE/data/reusables/webhooks/deployment_short_desc.md
index 75683350b9df..249535a29dc8 100644
--- a/translations/de-DE/data/reusables/webhooks/deployment_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/deployment_short_desc.md
@@ -1 +1 @@
-A deployment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[deployment](/v3/repos/deployments/#list-deployments)" REST API.
\ No newline at end of file
+A deployment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[deployment](/rest/reference/repos#list-deployments)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/deployment_status_short_desc.md b/translations/de-DE/data/reusables/webhooks/deployment_status_short_desc.md
index 11953ea072e4..d58bd3e0efed 100644
--- a/translations/de-DE/data/reusables/webhooks/deployment_status_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/deployment_status_short_desc.md
@@ -1 +1 @@
-A deployment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[deployment statuses](/v3/repos/deployments/#list-deployment-statuses)" REST API.
\ No newline at end of file
+A deployment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[deployment statuses](/rest/reference/repos#list-deployment-statuses)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/enterprise_short_desc.md b/translations/de-DE/data/reusables/webhooks/enterprise_short_desc.md
index 999949bcbb50..07659be69c50 100644
--- a/translations/de-DE/data/reusables/webhooks/enterprise_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/enterprise_short_desc.md
@@ -1 +1 @@
-A site or repository administrator enables or disables anonymous Git read access. See "[Allowing admins to enable anonymous Git read access to public repositories](/enterprise/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories)" for more details. This event is not available in the Events API.
\ No newline at end of file
+A site or repository administrator enables or disables anonymous Git read access. See "[Allowing admins to enable anonymous Git read access to public repositories](/enterprise/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories)" for more details. This event is not available in the Events API.
diff --git a/translations/de-DE/data/reusables/webhooks/events_api_payload.md b/translations/de-DE/data/reusables/webhooks/events_api_payload.md
index b40c9904faf8..d63dfb496eb9 100644
--- a/translations/de-DE/data/reusables/webhooks/events_api_payload.md
+++ b/translations/de-DE/data/reusables/webhooks/events_api_payload.md
@@ -1 +1 @@
-The [event object](#event-object-common-properties) includes properties that are common for all events. Each event object includes a `payload` property and the value is unique to each event type. The `payload` object for this event is described below.
\ No newline at end of file
+The [event object](#event-object-common-properties) includes properties that are common for all events. Each event object includes a `payload` property and the value is unique to each event type. The `payload` object for this event is described below.
diff --git a/translations/de-DE/data/reusables/webhooks/fork_properties.md b/translations/de-DE/data/reusables/webhooks/fork_properties.md
index 69d7702fa3c4..2a6514c1aa8d 100644
--- a/translations/de-DE/data/reusables/webhooks/fork_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/fork_properties.md
@@ -1,3 +1,3 @@
 | Schlüssel | Typ      | Beschreibung                                                      |
 | --------- | -------- | ----------------------------------------------------------------- |
-| `forkee`  | `Objekt` | The created [`repository`](/v3/repos/#get-a-repository) resource. |
\ No newline at end of file
+| `forkee`  | `Objekt` | The created [`repository`](/v3/repos/#get-a-repository) resource. |
diff --git a/translations/de-DE/data/reusables/webhooks/fork_short_desc.md b/translations/de-DE/data/reusables/webhooks/fork_short_desc.md
index a294851f9c96..60f88625b01f 100644
--- a/translations/de-DE/data/reusables/webhooks/fork_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/fork_short_desc.md
@@ -1 +1 @@
-A user forks a repository. For more information, see the "[forks](/v3/repos/forks/)" REST API.
\ No newline at end of file
+A user forks a repository. For more information, see the "[forks](/v3/repos/forks/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/gollum_properties.md b/translations/de-DE/data/reusables/webhooks/gollum_properties.md
index 32a0db24bb23..e27c066d36f2 100644
--- a/translations/de-DE/data/reusables/webhooks/gollum_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/gollum_properties.md
@@ -5,4 +5,4 @@
 | `pages[][title]`     | `string` | The current page title.                                                  |
 | `pages[][action]`    | `string` | The action that was performed on the page. Can be `created` or `edited`. |
 | `pages[][sha]`       | `string` | The latest commit SHA of the page.                                       |
-| `pages[][html_url]`  | `string` | Points to the HTML wiki page.                                            |
\ No newline at end of file
+| `pages[][html_url]`  | `string` | Points to the HTML wiki page.                                            |
diff --git a/translations/de-DE/data/reusables/webhooks/gollum_short_desc.md b/translations/de-DE/data/reusables/webhooks/gollum_short_desc.md
index 88d8dacb57e5..03bef9d2699c 100644
--- a/translations/de-DE/data/reusables/webhooks/gollum_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/gollum_short_desc.md
@@ -1 +1 @@
-A wiki page is created or updated. For more information, see the "[About wikis](/github/building-a-strong-community/about-wikis)".
\ No newline at end of file
+A wiki page is created or updated. For more information, see the "[About wikis](/github/building-a-strong-community/about-wikis)".
diff --git a/translations/de-DE/data/reusables/webhooks/installation_properties.md b/translations/de-DE/data/reusables/webhooks/installation_properties.md
index 9aca8e27c614..a651b2c5ebb0 100644
--- a/translations/de-DE/data/reusables/webhooks/installation_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/installation_properties.md
@@ -1,4 +1,4 @@
 | Schlüssel     | Typ      | Beschreibung                                                                |
 | ------------- | -------- | --------------------------------------------------------------------------- |
 | `action`      | `string` | die Aktion, die durchgeführt wurde. Can be one of:
    • `created` - Someone installs a {% data variables.product.prodname_github_app %}.
    • `deleted` - Someone uninstalls a {% data variables.product.prodname_github_app %}
      • {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}
    • `suspend` - Someone suspends a {% data variables.product.prodname_github_app %} installation.
    • `unsuspend` - Someone unsuspends a {% data variables.product.prodname_github_app %} installation.
      • {% endif %}
    • `new_permissions_accepted` - Someone accepts new permissions for a {% data variables.product.prodname_github_app %} installation. When a {% data variables.product.prodname_github_app %} owner requests new permissions, the person who installed the {% data variables.product.prodname_github_app %} must accept the new permissions request. 
     |
-| `repositorys` | `array`  | An array of repository objects that the insatllation can access.            |
\ No newline at end of file
+| `repositorys` | `array`  | An array of repository objects that the insatllation can access.            |
diff --git a/translations/de-DE/data/reusables/webhooks/installation_repositories_properties.md b/translations/de-DE/data/reusables/webhooks/installation_repositories_properties.md
index dda7d036b424..de8011bed8a9 100644
--- a/translations/de-DE/data/reusables/webhooks/installation_repositories_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/installation_repositories_properties.md
@@ -3,4 +3,4 @@
 | `action`               | `string` | die Aktion, die durchgeführt wurde. Can be either `added` or `removed`.               |
 | `repository_selection` | `string` | The choice of repositories the installation is on. Can be either `selected` or `all`. |
 | `repositories_added`   | `array`  | An array of repository objects, which were added to the installation.                 |
-| `repositories_removed` | `array`  | An array of repository objects, which were removed from the installation.             |
\ No newline at end of file
+| `repositories_removed` | `array`  | An array of repository objects, which were removed from the installation.             |
diff --git a/translations/de-DE/data/reusables/webhooks/installation_repositories_short_desc.md b/translations/de-DE/data/reusables/webhooks/installation_repositories_short_desc.md
index b01eeca22efe..63166ba6e220 100644
--- a/translations/de-DE/data/reusables/webhooks/installation_repositories_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/installation_repositories_short_desc.md
@@ -1 +1 @@
-Activity related to repositories being added to a GitHub App installation. {% data reusables.webhooks.action_type_desc %} For more information, see the "[GitHub App installation](/v3/apps/)" REST API.
\ No newline at end of file
+Activity related to repositories being added to a GitHub App installation. {% data reusables.webhooks.action_type_desc %} For more information, see the "[GitHub App installation](/v3/apps/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/installation_short_desc.md b/translations/de-DE/data/reusables/webhooks/installation_short_desc.md
index 0a19aef9b5d0..4abc1de643b4 100644
--- a/translations/de-DE/data/reusables/webhooks/installation_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/installation_short_desc.md
@@ -1 +1 @@
-Activity related to a GitHub App installation. {% data reusables.webhooks.action_type_desc %} For more information, see the "[GitHub App installation](/v3/apps/)" REST API.
\ No newline at end of file
+Activity related to a GitHub App installation. {% data reusables.webhooks.action_type_desc %} For more information, see the "[GitHub App installation](/v3/apps/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/issue_comment_properties.md b/translations/de-DE/data/reusables/webhooks/issue_comment_properties.md
index 1cc3962f11bf..b983deb16f16 100644
--- a/translations/de-DE/data/reusables/webhooks/issue_comment_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/issue_comment_properties.md
@@ -1 +1 @@
-`changes`|`object` | The changes to the comment if the action was `edited`. `changes[body][from]` |`string` | The previous version of the body if the action was `edited`. `issue`|`object` | The [issue](/v3/issues/) the comment belongs to. `comment`|`object` | The [comment](/v3/issues/comments/) itself.
\ No newline at end of file
+`changes`|`object` | The changes to the comment if the action was `edited`. `changes[body][from]` |`string` | The previous version of the body if the action was `edited`. `issue`|`object` | The [issue](/v3/issues/) the comment belongs to. `comment`|`object` | The [comment](/v3/issues/comments/) itself.
diff --git a/translations/de-DE/data/reusables/webhooks/issue_comment_short_desc.md b/translations/de-DE/data/reusables/webhooks/issue_comment_short_desc.md
index 0c12ec707b62..cc07764d1919 100644
--- a/translations/de-DE/data/reusables/webhooks/issue_comment_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/issue_comment_short_desc.md
@@ -1 +1 @@
-Activity related to an issue comment. {% data reusables.webhooks.action_type_desc %} For more information, see the "[issue comments](/v3/issues/comments/)" REST API.
\ No newline at end of file
+Activity related to an issue comment. {% data reusables.webhooks.action_type_desc %} For more information, see the "[issue comments](/v3/issues/comments/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/issue_comment_webhook_properties.md b/translations/de-DE/data/reusables/webhooks/issue_comment_webhook_properties.md
index 46d9ecad58ab..c19a95c4d344 100644
--- a/translations/de-DE/data/reusables/webhooks/issue_comment_webhook_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/issue_comment_webhook_properties.md
@@ -1,3 +1,3 @@
 | Schlüssel | Typ      | Beschreibung                                                                                   |
 | --------- | -------- | ---------------------------------------------------------------------------------------------- |
-| `action`  | `string` | The action that was performed on the comment. Can be one of `created`, `edited`, or `deleted`. |
\ No newline at end of file
+| `action`  | `string` | The action that was performed on the comment. Can be one of `created`, `edited`, or `deleted`. |
diff --git a/translations/de-DE/data/reusables/webhooks/issue_event_api_properties.md b/translations/de-DE/data/reusables/webhooks/issue_event_api_properties.md
index 6e4cdff2a7b6..36ac9bef613b 100644
--- a/translations/de-DE/data/reusables/webhooks/issue_event_api_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/issue_event_api_properties.md
@@ -1,3 +1,3 @@
 | Schlüssel | Typ      | Beschreibung                                                                                                                           |
 | --------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------- |
-| `action`  | `string` | die Aktion, die durchgeführt wurde. Can be one of `opened`, `closed`, `reopened`, `assigned`, `unassigned`, `labeled`, or `unlabeled`. |
\ No newline at end of file
+| `action`  | `string` | die Aktion, die durchgeführt wurde. Can be one of `opened`, `closed`, `reopened`, `assigned`, `unassigned`, `labeled`, or `unlabeled`. |
diff --git a/translations/de-DE/data/reusables/webhooks/issue_properties.md b/translations/de-DE/data/reusables/webhooks/issue_properties.md
index 84db05eb2bfe..c146faa96802 100644
--- a/translations/de-DE/data/reusables/webhooks/issue_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/issue_properties.md
@@ -1 +1 @@
-`issue`|`object` | The [issue](/v3/issues) itself. `changes`|`object`| The changes to the issue if the action was `edited`. `changes[title][from]`|`string` | The previous version of the title if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `assignee`|`object` | The optional user who was assigned or unassigned from the issue. `label`|`object` | The optional label that was added or removed from the issue.
\ No newline at end of file
+`issue`|`object` | The [issue](/v3/issues) itself. `changes`|`object`| The changes to the issue if the action was `edited`. `changes[title][from]`|`string` | The previous version of the title if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `assignee`|`object` | The optional user who was assigned or unassigned from the issue. `label`|`object` | The optional label that was added or removed from the issue.
diff --git a/translations/de-DE/data/reusables/webhooks/issue_webhook_properties.md b/translations/de-DE/data/reusables/webhooks/issue_webhook_properties.md
index 16166a666ab8..1fb8cbb62778 100644
--- a/translations/de-DE/data/reusables/webhooks/issue_webhook_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/issue_webhook_properties.md
@@ -1,3 +1,3 @@
 | Schlüssel | Typ      | Beschreibung                                                                                                                                                                                                                                          |
 | --------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `action`  | `string` | die Aktion, die durchgeführt wurde. Can be one of `opened`, `edited`, `deleted`, `pinned`, `unpinned`, `closed`, `reopened`, `assigned`, `unassigned`, `labeled`, `unlabeled`, `locked`, `unlocked`,  `transferred`, `milestoned`, or `demilestoned`. |
\ No newline at end of file
+| `action`  | `string` | die Aktion, die durchgeführt wurde. Can be one of `opened`, `edited`, `deleted`, `pinned`, `unpinned`, `closed`, `reopened`, `assigned`, `unassigned`, `labeled`, `unlabeled`, `locked`, `unlocked`,  `transferred`, `milestoned`, or `demilestoned`. |
diff --git a/translations/de-DE/data/reusables/webhooks/issues_short_desc.md b/translations/de-DE/data/reusables/webhooks/issues_short_desc.md
index fea9fc0cfcd8..7dadec073bb6 100644
--- a/translations/de-DE/data/reusables/webhooks/issues_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/issues_short_desc.md
@@ -1 +1 @@
-Activity related to an issue. {% data reusables.webhooks.action_type_desc %} For more information, see the "[issues](/v3/issues/comments/)" REST API.
\ No newline at end of file
+Activity related to an issue. {% data reusables.webhooks.action_type_desc %} For more information, see the "[issues](/v3/issues/comments/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/label_short_desc.md b/translations/de-DE/data/reusables/webhooks/label_short_desc.md
index ca095139a6d2..c5f7178d8a4c 100644
--- a/translations/de-DE/data/reusables/webhooks/label_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/label_short_desc.md
@@ -1 +1 @@
-Activity related to an issue. {% data reusables.webhooks.action_type_desc %} For more information, see the "[labels](/v3/issues/labels/)" REST API.
\ No newline at end of file
+Activity related to an issue. {% data reusables.webhooks.action_type_desc %} For more information, see the "[labels](/v3/issues/labels/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/member_event_api_properties.md b/translations/de-DE/data/reusables/webhooks/member_event_api_properties.md
index 61df592af1bf..6ce4447d12ee 100644
--- a/translations/de-DE/data/reusables/webhooks/member_event_api_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/member_event_api_properties.md
@@ -1,3 +1,3 @@
 | Schlüssel | Typ      | Beschreibung                                                                                                  |
 | --------- | -------- | ------------------------------------------------------------------------------------------------------------- |
-| `action`  | `string` | die Aktion, die durchgeführt wurde. Can be `added` to indicate a user accepted an invitation to a repository. |
\ No newline at end of file
+| `action`  | `string` | die Aktion, die durchgeführt wurde. Can be `added` to indicate a user accepted an invitation to a repository. |
diff --git a/translations/de-DE/data/reusables/webhooks/member_properties.md b/translations/de-DE/data/reusables/webhooks/member_properties.md
index 7fde9d65f4b7..d9e1757f404e 100644
--- a/translations/de-DE/data/reusables/webhooks/member_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/member_properties.md
@@ -1 +1 @@
-`member`|`object` | The [user](/v3/users/) that was added. `changes`|`object`| The changes to the collaborator permissions if the action was `edited`. `changes[old_permission][from]`|`string` | The previous permissions of the collaborator if the action was `edited`.
\ No newline at end of file
+`member`|`object` | The [user](/v3/users/) that was added. `changes`|`object`| The changes to the collaborator permissions if the action was `edited`. `changes[old_permission][from]`|`string` | The previous permissions of the collaborator if the action was `edited`.
diff --git a/translations/de-DE/data/reusables/webhooks/member_short_desc.md b/translations/de-DE/data/reusables/webhooks/member_short_desc.md
index 9447f245ed0a..2e8289677381 100644
--- a/translations/de-DE/data/reusables/webhooks/member_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/member_short_desc.md
@@ -1 +1 @@
-Activity related to repository collaborators. {% data reusables.webhooks.action_type_desc %} For more information, see the "[collaborators](/v3/repos/collaborators/)" REST API.
\ No newline at end of file
+Activity related to repository collaborators. {% data reusables.webhooks.action_type_desc %} For more information, see the "[collaborators](/v3/repos/collaborators/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/member_webhook_properties.md b/translations/de-DE/data/reusables/webhooks/member_webhook_properties.md
index 52458ac5f5a5..3fe25daf58ff 100644
--- a/translations/de-DE/data/reusables/webhooks/member_webhook_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/member_webhook_properties.md
@@ -1,3 +1,3 @@
 | Schlüssel | Typ      | Beschreibung                                                                |
 | --------- | -------- | --------------------------------------------------------------------------- |
-| `action`  | `string` | die Aktion, die durchgeführt wurde. Can be one of:
    •  `added` - A user accepts an invitation to a repository.
    • `removed` - A user is removed as a collaborator in a repository.
    • `edited` - A user's collaborator permissios have changed. 
     |
\ No newline at end of file
+| `action`  | `string` | die Aktion, die durchgeführt wurde. Can be one of:
    •  `added` - A user accepts an invitation to a repository.
    • `removed` - A user is removed as a collaborator in a repository.
    • `edited` - A user's collaborator permissios have changed. 
     |
diff --git a/translations/de-DE/data/reusables/webhooks/membership_properties.md b/translations/de-DE/data/reusables/webhooks/membership_properties.md
index 622a52afb634..59c0a79b4ef5 100644
--- a/translations/de-DE/data/reusables/webhooks/membership_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/membership_properties.md
@@ -3,4 +3,4 @@
 | `action`   | `string` | die Aktion, die durchgeführt wurde. Can be `added` or `removed`. |
 | `Umfang`   | `string` | The scope of the membership. Currently, can only be `team`.      |
 | `Mitglied` | `Objekt` | The [user](/v3/users/) that was added or removed.                |
-| `Team`     | `Objekt` | The [team](/v3/teams/) for the membership.                       |
\ No newline at end of file
+| `Team`     | `Objekt` | The [team](/v3/teams/) for the membership.                       |
diff --git a/translations/de-DE/data/reusables/webhooks/membership_short_desc.md b/translations/de-DE/data/reusables/webhooks/membership_short_desc.md
index 4ffa7e0d72c0..e557eea9026a 100644
--- a/translations/de-DE/data/reusables/webhooks/membership_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/membership_short_desc.md
@@ -1 +1 @@
-Activity related to team membership. {% data reusables.webhooks.action_type_desc %} For more information, see the "[team members](/v3/teams/members/)" REST API.
\ No newline at end of file
+Activity related to team membership. {% data reusables.webhooks.action_type_desc %} For more information, see the "[team members](/v3/teams/members/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/milestone_properties.md b/translations/de-DE/data/reusables/webhooks/milestone_properties.md
index 88ada8f51ad5..694bc235df7e 100644
--- a/translations/de-DE/data/reusables/webhooks/milestone_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/milestone_properties.md
@@ -5,4 +5,4 @@
 | `changes`                    | `Objekt` | The changes to the milestone if the action was `edited`.                                                 |
 | `changes[description][from]` | `string` | The previous version of the description if the action was `edited`.                                      |
 | `changes[due_on][from]`      | `string` | The previous version of the due date if the action was `edited`.                                         |
-| `changes[title][from]`       | `string` | The previous version of the title if the action was `edited`.                                            |
\ No newline at end of file
+| `changes[title][from]`       | `string` | The previous version of the title if the action was `edited`.                                            |
diff --git a/translations/de-DE/data/reusables/webhooks/milestone_short_desc.md b/translations/de-DE/data/reusables/webhooks/milestone_short_desc.md
index 0e6f857a512a..6b6bd073ceab 100644
--- a/translations/de-DE/data/reusables/webhooks/milestone_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/milestone_short_desc.md
@@ -1 +1 @@
-Activity related to milestones. {% data reusables.webhooks.action_type_desc %} For more information, see the "[milestones](/v3/issues/milestones/)" REST API.
\ No newline at end of file
+Activity related to milestones. {% data reusables.webhooks.action_type_desc %} For more information, see the "[milestones](/v3/issues/milestones/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/org_block_short_desc.md b/translations/de-DE/data/reusables/webhooks/org_block_short_desc.md
index 379de19da9fc..7c3896f63c8d 100644
--- a/translations/de-DE/data/reusables/webhooks/org_block_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/org_block_short_desc.md
@@ -1 +1 @@
-Activity related to people being blocked in an organization. {% data reusables.webhooks.action_type_desc %} For more information, see the "[blocking organization users](/v3/orgs/blocking/)" REST API.
\ No newline at end of file
+Activity related to people being blocked in an organization. {% data reusables.webhooks.action_type_desc %} For more information, see the "[blocking organization users](/v3/orgs/blocking/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/org_desc.md b/translations/de-DE/data/reusables/webhooks/org_desc.md
index e763e6d6b614..8b344e764cde 100644
--- a/translations/de-DE/data/reusables/webhooks/org_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/org_desc.md
@@ -1 +1 @@
-`organization` | `object` | Webhook payloads contain the [`organization`](/v3/orgs/#get-an-organization) object when the webhook is configured for an organization or the event occurs from activity in a repository owned by an organization.
\ No newline at end of file
+`organization` | `object` | Webhook payloads contain the [`organization`](/v3/orgs/#get-an-organization) object when the webhook is configured for an organization or the event occurs from activity in a repository owned by an organization.
diff --git a/translations/de-DE/data/reusables/webhooks/organization_short_desc.md b/translations/de-DE/data/reusables/webhooks/organization_short_desc.md
index 131d20fc3de8..895b584aaf26 100644
--- a/translations/de-DE/data/reusables/webhooks/organization_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/organization_short_desc.md
@@ -1 +1 @@
-Activity related to an organization and its members. {% data reusables.webhooks.action_type_desc %} For more information, see the "[organizations](/v3/orgs/)" REST API.
\ No newline at end of file
+Activity related to an organization and its members. {% data reusables.webhooks.action_type_desc %} For more information, see the "[organizations](/v3/orgs/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/package_properties.md b/translations/de-DE/data/reusables/webhooks/package_properties.md
index b897ba21b367..6c9667e66daf 100644
--- a/translations/de-DE/data/reusables/webhooks/package_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/package_properties.md
@@ -1,4 +1,4 @@
 | Schlüssel    | Typ      | Beschreibung                                                         |
 | ------------ | -------- | -------------------------------------------------------------------- |
 | `action`     | `string` | die Aktion, die durchgeführt wurde. Can be `published` or `updated`. |
-| `paketieren` | `Objekt` | Information about the package.                                       |
\ No newline at end of file
+| `paketieren` | `Objekt` | Information about the package.                                       |
diff --git a/translations/de-DE/data/reusables/webhooks/page_build_short_desc.md b/translations/de-DE/data/reusables/webhooks/page_build_short_desc.md
index 7c5be712c388..dda5755d8870 100644
--- a/translations/de-DE/data/reusables/webhooks/page_build_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/page_build_short_desc.md
@@ -1 +1 @@
-Represents an attempted build of a GitHub Pages site, whether successful or not. A push to a GitHub Pages enabled branch (`gh-pages` for project pages, `master` for user and organization pages) triggers this event.
\ No newline at end of file
+Represents an attempted build of a {% data variables.product.prodname_pages %} site, whether successful or not. A push to a {% data variables.product.prodname_pages %} enabled branch (`gh-pages` for project pages, the default branch for user and organization pages) triggers this event.
diff --git a/translations/de-DE/data/reusables/webhooks/payload_url.md b/translations/de-DE/data/reusables/webhooks/payload_url.md
index 3a3fde655ce3..f48cdfee0e5c 100644
--- a/translations/de-DE/data/reusables/webhooks/payload_url.md
+++ b/translations/de-DE/data/reusables/webhooks/payload_url.md
@@ -1 +1 @@
-The payload URL is the URL of the server that will receive the webhook `POST` requests.
\ No newline at end of file
+The payload URL is the URL of the server that will receive the webhook `POST` requests.
diff --git a/translations/de-DE/data/reusables/webhooks/ping_short_desc.md b/translations/de-DE/data/reusables/webhooks/ping_short_desc.md
index 8cdd735b78c5..139c6735e2fd 100644
--- a/translations/de-DE/data/reusables/webhooks/ping_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/ping_short_desc.md
@@ -1 +1 @@
-When you create a new webhook, we'll send you a simple `ping` event to let you know you've set up the webhook correctly. This event isnt stored so it isn't retrievable via the [Events API](/v3/activity/events/). You can trigger a `ping` again by calling the [Ping a repository webhook](/v3/repos/hooks/#ping-a-repository-webhook) endpoint.
+When you create a new webhook, we'll send you a simple `ping` event to let you know you've set up the webhook correctly. This event isnt stored so it isn't retrievable via the [Events API](/rest/reference/activity#ping-a-repository-webhook) endpoint.
diff --git a/translations/de-DE/data/reusables/webhooks/project_card_properties.md b/translations/de-DE/data/reusables/webhooks/project_card_properties.md
index 3d15a7caf960..0b2049c391a2 100644
--- a/translations/de-DE/data/reusables/webhooks/project_card_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/project_card_properties.md
@@ -4,4 +4,4 @@
 | `changes`             | `Objekt`  | The changes to the project card if the action was `edited` or `converted`.                                                   |
 | `changes[note][from]` | `string`  | The previous version of the note if the action was `edited` or `converted`.                                                  |
 | `after_id`            | `integer` | The id of the card that this card now follows if the action was "moved". Will be `null` if it is the first card in a column. |
-| `project_card`        | `Objekt`  | The [project card](/v3/projects/cards) itself.                                                                               |
\ No newline at end of file
+| `project_card`        | `Objekt`  | The [project card](/v3/projects/cards) itself.                                                                               |
diff --git a/translations/de-DE/data/reusables/webhooks/project_card_short_desc.md b/translations/de-DE/data/reusables/webhooks/project_card_short_desc.md
index 3a474c89ecee..bbea9ea6c407 100644
--- a/translations/de-DE/data/reusables/webhooks/project_card_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/project_card_short_desc.md
@@ -1 +1 @@
-Activity related to project cards. {% data reusables.webhooks.action_type_desc %} For more information, see the "[project cards](/v3/projects/cards)" REST API.
\ No newline at end of file
+Activity related to project cards. {% data reusables.webhooks.action_type_desc %} For more information, see the "[project cards](/v3/projects/cards)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/project_column_properties.md b/translations/de-DE/data/reusables/webhooks/project_column_properties.md
index 7c72797b75b1..a10af792eb02 100644
--- a/translations/de-DE/data/reusables/webhooks/project_column_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/project_column_properties.md
@@ -4,4 +4,4 @@
 | `changes`             | `Objekt`  | The changes to the project column if the action was `edited`.                                                                       |
 | `changes[name][from]` | `string`  | The previous version of the name if the action was `edited`.                                                                        |
 | `after_id`            | `integer` | The id of the column that this column now follows if the action was "moved". Will be `null` if it is the first column in a project. |
-| `project_column`      | `Objekt`  | The [project column](/v3/projects/columns) itself.                                                                                  |
\ No newline at end of file
+| `project_column`      | `Objekt`  | The [project column](/v3/projects/columns) itself.                                                                                  |
diff --git a/translations/de-DE/data/reusables/webhooks/project_column_short_desc.md b/translations/de-DE/data/reusables/webhooks/project_column_short_desc.md
index 31cc257267b0..19ac3f6412c8 100644
--- a/translations/de-DE/data/reusables/webhooks/project_column_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/project_column_short_desc.md
@@ -1 +1 @@
-Activity related to columns in a project board. {% data reusables.webhooks.action_type_desc %} For more information, see the "[project columns](/v3/projects/columns)" REST API.
\ No newline at end of file
+Activity related to columns in a project board. {% data reusables.webhooks.action_type_desc %} For more information, see the "[project columns](/v3/projects/columns)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/project_properties.md b/translations/de-DE/data/reusables/webhooks/project_properties.md
index 2e2b014490ba..fe1ff8fa6d63 100644
--- a/translations/de-DE/data/reusables/webhooks/project_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/project_properties.md
@@ -4,4 +4,4 @@
 | `changes`             | `Objekt` | The changes to the project if the action was `edited`.                                                               |
 | `changes[name][from]` | `string` | The previous version of the name if the action was `edited`.                                                         |
 | `changes[body][from]` | `string` | The previous version of the body if the action was `edited`.                                                         |
-| `project (Projekt)`   | `Objekt` | The [project](/v3/projects/) itself.                                                                                 |
\ No newline at end of file
+| `project (Projekt)`   | `Objekt` | The [project](/v3/projects/) itself.                                                                                 |
diff --git a/translations/de-DE/data/reusables/webhooks/project_short_desc.md b/translations/de-DE/data/reusables/webhooks/project_short_desc.md
index c5f8a804a47c..6f18da5d6957 100644
--- a/translations/de-DE/data/reusables/webhooks/project_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/project_short_desc.md
@@ -1 +1 @@
-Activity related to project boards. {% data reusables.webhooks.action_type_desc %} For more information, see the "[projects](/v3/projects)" REST API.
\ No newline at end of file
+Activity related to project boards. {% data reusables.webhooks.action_type_desc %} For more information, see the "[projects](/v3/projects)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/public_short_desc.md b/translations/de-DE/data/reusables/webhooks/public_short_desc.md
index 925a4bfeddc5..9333dc3841cc 100644
--- a/translations/de-DE/data/reusables/webhooks/public_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/public_short_desc.md
@@ -1 +1 @@
-When a private repository is made public.  Without a doubt: the best {% data variables.product.product_name %} event. 
\ No newline at end of file
+When a private repository is made public.  Without a doubt: the best {% data variables.product.product_name %} event. 
diff --git a/translations/de-DE/data/reusables/webhooks/pull_request_event_api_properties.md b/translations/de-DE/data/reusables/webhooks/pull_request_event_api_properties.md
index ae5adec14f8d..9069ae4cf75d 100644
--- a/translations/de-DE/data/reusables/webhooks/pull_request_event_api_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/pull_request_event_api_properties.md
@@ -1,3 +1,3 @@
 | Schlüssel | Typ      | Beschreibung                                                                                                                                                                                         |
 | --------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `action`  | `string` | die Aktion, die durchgeführt wurde. Can be one of `opened`, `closed`, `reopened`, `assigned`, `unassigned`, `review_requested`, `review_request_removed`, `labeled`, `unlabeled`, and `synchronize`. |
\ No newline at end of file
+| `action`  | `string` | die Aktion, die durchgeführt wurde. Can be one of `opened`, `closed`, `reopened`, `assigned`, `unassigned`, `review_requested`, `review_request_removed`, `labeled`, `unlabeled`, and `synchronize`. |
diff --git a/translations/de-DE/data/reusables/webhooks/pull_request_properties.md b/translations/de-DE/data/reusables/webhooks/pull_request_properties.md
index b2619258bb68..21544ccd9e8d 100644
--- a/translations/de-DE/data/reusables/webhooks/pull_request_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/pull_request_properties.md
@@ -1 +1 @@
-`number`|`integer` | The pull request number. `changes`|`object`| The changes to the comment if the action was `edited`. `changes[title][from]`|`string` | The previous version of the title if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `pull_request`|`object` | The [pull request](/v3/pulls) itself.
\ No newline at end of file
+`number`|`integer` | The pull request number. `changes`|`object`| The changes to the comment if the action was `edited`. `changes[title][from]`|`string` | The previous version of the title if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `pull_request`|`object` | The [pull request](/v3/pulls) itself.
diff --git a/translations/de-DE/data/reusables/webhooks/pull_request_review_comment_event_api_properties.md b/translations/de-DE/data/reusables/webhooks/pull_request_review_comment_event_api_properties.md
index 8c83cea7274f..72ce5e91d30d 100644
--- a/translations/de-DE/data/reusables/webhooks/pull_request_review_comment_event_api_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/pull_request_review_comment_event_api_properties.md
@@ -1,3 +1,3 @@
 | Schlüssel | Typ      | Beschreibung                                                    |
 | --------- | -------- | --------------------------------------------------------------- |
-| `action`  | `string` | The action that was performed on the comment. Can be `created`. |
\ No newline at end of file
+| `action`  | `string` | The action that was performed on the comment. Can be `created`. |
diff --git a/translations/de-DE/data/reusables/webhooks/pull_request_review_comment_properties.md b/translations/de-DE/data/reusables/webhooks/pull_request_review_comment_properties.md
index 85341dd38525..a38df37d8c7d 100644
--- a/translations/de-DE/data/reusables/webhooks/pull_request_review_comment_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/pull_request_review_comment_properties.md
@@ -1 +1 @@
-`changes`|`object`| The changes to the comment if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `pull_request`|`object` | The [pull request](/v3/pulls/) the comment belongs to. `comment`|`object` | The [comment](/v3/pulls/comments) itself.
\ No newline at end of file
+`changes`|`object`| The changes to the comment if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `pull_request`|`object` | The [pull request](/v3/pulls/) the comment belongs to. `comment`|`object` | The [comment](/v3/pulls/comments) itself.
diff --git a/translations/de-DE/data/reusables/webhooks/pull_request_review_comment_short_desc.md b/translations/de-DE/data/reusables/webhooks/pull_request_review_comment_short_desc.md
index 0dbf1f6974da..7b05ee9a9a19 100644
--- a/translations/de-DE/data/reusables/webhooks/pull_request_review_comment_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/pull_request_review_comment_short_desc.md
@@ -1 +1 @@
-Activity related to pull request review comments in the pull request's unified diff. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull request review comments](/v3/pulls/comments/)" REST API.
\ No newline at end of file
+Activity related to pull request review comments in the pull request's unified diff. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull request review comments](/v3/pulls/comments/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/pull_request_review_comment_webhook_properties.md b/translations/de-DE/data/reusables/webhooks/pull_request_review_comment_webhook_properties.md
index 46d9ecad58ab..c19a95c4d344 100644
--- a/translations/de-DE/data/reusables/webhooks/pull_request_review_comment_webhook_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/pull_request_review_comment_webhook_properties.md
@@ -1,3 +1,3 @@
 | Schlüssel | Typ      | Beschreibung                                                                                   |
 | --------- | -------- | ---------------------------------------------------------------------------------------------- |
-| `action`  | `string` | The action that was performed on the comment. Can be one of `created`, `edited`, or `deleted`. |
\ No newline at end of file
+| `action`  | `string` | The action that was performed on the comment. Can be one of `created`, `edited`, or `deleted`. |
diff --git a/translations/de-DE/data/reusables/webhooks/pull_request_review_properties.md b/translations/de-DE/data/reusables/webhooks/pull_request_review_properties.md
index 7685f0836018..0d570bafdddc 100644
--- a/translations/de-DE/data/reusables/webhooks/pull_request_review_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/pull_request_review_properties.md
@@ -3,4 +3,4 @@
 | `action`              | `string` | die Aktion, die durchgeführt wurde. Can be one of:
    • `submitted` - A pull request review is submitted into a non-pending state.
    • `edited` - The body of a review has been edited.
    • `dismissed` - A review has been dismissed.
     |
 | `pull_request`        | `Objekt` | The [pull request](/v3/pulls/) the review pertains to.                      |
 | `Review`              | `Objekt` | The review that was affected.                                               |
-| `changes[body][from]` | `string` | The previous version of the body if the action was `edited`.                |
\ No newline at end of file
+| `changes[body][from]` | `string` | The previous version of the body if the action was `edited`.                |
diff --git a/translations/de-DE/data/reusables/webhooks/pull_request_review_short_desc.md b/translations/de-DE/data/reusables/webhooks/pull_request_review_short_desc.md
index a92f0dd3bb24..07b263364d7f 100644
--- a/translations/de-DE/data/reusables/webhooks/pull_request_review_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/pull_request_review_short_desc.md
@@ -1 +1 @@
-Activity related to pull request reviews. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull request reviews](/v3/pulls/reviews/)" REST API.
\ No newline at end of file
+Activity related to pull request reviews. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull request reviews](/v3/pulls/reviews/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/pull_request_short_desc.md b/translations/de-DE/data/reusables/webhooks/pull_request_short_desc.md
index c88a5120c8f4..ea9e435d0328 100644
--- a/translations/de-DE/data/reusables/webhooks/pull_request_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/pull_request_short_desc.md
@@ -1 +1 @@
-Activity related to pull requests. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull requests](/v3/pulls/)" REST API.
\ No newline at end of file
+Activity related to pull requests. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull requests](/v3/pulls/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/pull_request_webhook_properties.md b/translations/de-DE/data/reusables/webhooks/pull_request_webhook_properties.md
index f8ccf07d2fda..aa6f41ba8925 100644
--- a/translations/de-DE/data/reusables/webhooks/pull_request_webhook_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/pull_request_webhook_properties.md
@@ -1,3 +1,3 @@
 | Schlüssel | Typ      | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
 | --------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `action`  | `string` | die Aktion, die durchgeführt wurde. Can be one of  `opened`, `edited`, `closed`, `assigned`, `unassigned`, `review_requested`, `review_request_removed`, `ready_for_review`, `labeled`, `unlabeled`, `synchronize`, `locked`, `unlocked`, or `reopened`. If the action is `closed` and the `merged` key is `false`, the pull request was closed with unmerged commits. If the action is `closed` and the `merged` key is `true`, the pull request was merged. |
\ No newline at end of file
+| `action`  | `string` | die Aktion, die durchgeführt wurde. Can be one of  `opened`, `edited`, `closed`, `assigned`, `unassigned`, `review_requested`, `review_request_removed`, `ready_for_review`, `labeled`, `unlabeled`, `synchronize`, `locked`, `unlocked`, or `reopened`. If the action is `closed` and the `merged` key is `false`, the pull request was closed with unmerged commits. If the action is `closed` and the `merged` key is `true`, the pull request was merged. |
diff --git a/translations/de-DE/data/reusables/webhooks/push_short_desc.md b/translations/de-DE/data/reusables/webhooks/push_short_desc.md
index 53583a273873..9d434a42fb49 100644
--- a/translations/de-DE/data/reusables/webhooks/push_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/push_short_desc.md
@@ -1 +1 @@
-One or more commits are pushed to a repository branch or tag.
\ No newline at end of file
+One or more commits are pushed to a repository branch or tag.
diff --git a/translations/de-DE/data/reusables/webhooks/release_event_api_properties.md b/translations/de-DE/data/reusables/webhooks/release_event_api_properties.md
index c9c59435ba06..fb908d21f198 100644
--- a/translations/de-DE/data/reusables/webhooks/release_event_api_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/release_event_api_properties.md
@@ -1,3 +1,3 @@
 | Schlüssel | Typ      | Beschreibung                                            |
 | --------- | -------- | ------------------------------------------------------- |
-| `action`  | `string` | die Aktion, die durchgeführt wurde. Can be `published`. |
\ No newline at end of file
+| `action`  | `string` | die Aktion, die durchgeführt wurde. Can be `published`. |
diff --git a/translations/de-DE/data/reusables/webhooks/release_properties.md b/translations/de-DE/data/reusables/webhooks/release_properties.md
index f9fa6700c8ba..969aefd9d705 100644
--- a/translations/de-DE/data/reusables/webhooks/release_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/release_properties.md
@@ -1 +1 @@
-`changes[body][from]` |`string` | The previous version of the body if the action was `edited`. `changes[name][from]` |`string` | The previous version of the name if the action was `edited`. `release`|`object` | The [release](/v3/repos/releases/#get-a-release) object.
\ No newline at end of file
+`changes[body][from]` |`string` | The previous version of the body if the action was `edited`. `changes[name][from]` |`string` | The previous version of the name if the action was `edited`. `release`|`object` | The [release](/rest/reference/repos/#get-a-release) object.
diff --git a/translations/de-DE/data/reusables/webhooks/release_short_desc.md b/translations/de-DE/data/reusables/webhooks/release_short_desc.md
index b3250fbf11ec..e3a9a3bb3a3c 100644
--- a/translations/de-DE/data/reusables/webhooks/release_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/release_short_desc.md
@@ -1 +1 @@
-Activity related to a release. {% data reusables.webhooks.action_type_desc %} For more information, see the "[releases](/v3/repos/releases/)" REST API.
\ No newline at end of file
+Activity related to a release. {% data reusables.webhooks.action_type_desc %} For more information, see the "[releases](/v3/repos/releases/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/release_webhook_properties.md b/translations/de-DE/data/reusables/webhooks/release_webhook_properties.md
index a6490c813488..869bae8e6e5a 100644
--- a/translations/de-DE/data/reusables/webhooks/release_webhook_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/release_webhook_properties.md
@@ -1,3 +1,3 @@
-| Schlüssel | Typ      | Beschreibung                                                                                                                                                                                                                                                                                                                         |
-| --------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `action`  | `string` | die Aktion, die durchgeführt wurde. Can be one of:
    • `published`: a release, pre-release, or draft of a release is published
      • {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}
    • `unpublished`: a release or pre-release is deleted
    • `created`: a draft is saved, or a release or pre-release is published without previously being saved as a draft
    • `edited`: a release, pre-release, or draft release is edited
    • `deleted`: a release, pre-release, or draft release is deleted
    • `prereleased`: a pre-release is created
    • `released`: a release or draft of a release is published, or a pre-release is changed to a release
      • {% endif %} |
\ No newline at end of file
+| Schlüssel | Typ      | Beschreibung                                                                                                                                                                                                                                               |
+| --------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `action`  | `string` | die Aktion, die durchgeführt wurde. Can be one of:
      • `published`: a release, pre-release, or draft of a release is published
      • `unpublished`: a release or pre-release is deleted
      • `created`: a draft is saved, or a release or pre-release is published without previously being saved as a draft
      • `edited`: a release, pre-release, or draft release is edited
      • `deleted`: a release, pre-release, or draft release is deleted
      • `prereleased`: a pre-release is created
      • `released`: a release or draft of a release is published, or a pre-release is changed to a release
        •  |
diff --git a/translations/de-DE/data/reusables/webhooks/repo_desc.md b/translations/de-DE/data/reusables/webhooks/repo_desc.md
index a61104a4ba83..27cc4f74c02c 100644
--- a/translations/de-DE/data/reusables/webhooks/repo_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/repo_desc.md
@@ -1 +1 @@
-`repository` | `object` | The [`repository`](/v3/repos/#get-a-repository) where the event occured.
\ No newline at end of file
+`repository` | `object` | The [`repository`](/v3/repos/#get-a-repository) where the event occured.
diff --git a/translations/de-DE/data/reusables/webhooks/repository_import_properties.md b/translations/de-DE/data/reusables/webhooks/repository_import_properties.md
index 31d8f099d07b..ad04350f5eb2 100644
--- a/translations/de-DE/data/reusables/webhooks/repository_import_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/repository_import_properties.md
@@ -1,3 +1,3 @@
 | Schlüssel | Typ      | Beschreibung                                                                            |
 | --------- | -------- | --------------------------------------------------------------------------------------- |
-| `Status`  | `string` | The final state of the import. This can be one of `success`, `cancelled`, or `failure`. |
\ No newline at end of file
+| `Status`  | `string` | The final state of the import. This can be one of `success`, `cancelled`, or `failure`. |
diff --git a/translations/de-DE/data/reusables/webhooks/repository_import_short_desc.md b/translations/de-DE/data/reusables/webhooks/repository_import_short_desc.md
index 2d30661c839a..056531b0195c 100644
--- a/translations/de-DE/data/reusables/webhooks/repository_import_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/repository_import_short_desc.md
@@ -1 +1 @@
-Activity related to a repository being imported to GitHub. {% data reusables.webhooks.action_type_desc %} For more information, see the "[source imports](/v3/migrations/source_imports/)" REST API.
\ No newline at end of file
+Activity related to a repository being imported to GitHub. {% data reusables.webhooks.action_type_desc %} For more information, see the "[source imports](/v3/migrations/source_imports/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/repository_short_desc.md b/translations/de-DE/data/reusables/webhooks/repository_short_desc.md
index b7c3f660a8a0..df290ac0ea83 100644
--- a/translations/de-DE/data/reusables/webhooks/repository_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/repository_short_desc.md
@@ -1 +1 @@
-Activity related to a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[repositories](/v3/repos/)" REST API.
\ No newline at end of file
+Activity related to a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[repositories](/v3/repos/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/repository_vulnerability_alert_properties.md b/translations/de-DE/data/reusables/webhooks/repository_vulnerability_alert_properties.md
index 5ab00188d29b..962f45b3288c 100644
--- a/translations/de-DE/data/reusables/webhooks/repository_vulnerability_alert_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/repository_vulnerability_alert_properties.md
@@ -1,4 +1,4 @@
 | Schlüssel | Typ      | Beschreibung                                                                              |
 | --------- | -------- | ----------------------------------------------------------------------------------------- |
 | `action`  | `string` | die Aktion, die durchgeführt wurde. This can be one of `create`, `dismiss`, or `resolve`. |
-| `Warnung` | `Objekt` | The security alert of the vulnerable dependency.                                          |
\ No newline at end of file
+| `Warnung` | `Objekt` | The security alert of the vulnerable dependency.                                          |
diff --git a/translations/de-DE/data/reusables/webhooks/repository_vulnerability_alert_short_desc.md b/translations/de-DE/data/reusables/webhooks/repository_vulnerability_alert_short_desc.md
index 9eab73f38a49..635c979d782d 100644
--- a/translations/de-DE/data/reusables/webhooks/repository_vulnerability_alert_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/repository_vulnerability_alert_short_desc.md
@@ -1 +1 @@
-Activity related to security vulnerability alerts in a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[About security alerts for vulerable dependencies](/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies)".
\ No newline at end of file
+Activity related to security vulnerability alerts in a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[About security alerts for vulerable dependencies](/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies)".
diff --git a/translations/de-DE/data/reusables/webhooks/secret.md b/translations/de-DE/data/reusables/webhooks/secret.md
index 119e13a93770..d4d128984aec 100644
--- a/translations/de-DE/data/reusables/webhooks/secret.md
+++ b/translations/de-DE/data/reusables/webhooks/secret.md
@@ -1 +1 @@
-Setting a webhook secret allows you to ensure that `POST` requests sent to the payload URL are from GitHub. When you set a secret, you'll receive the `X-Hub-Signature` header in the webhook `POST` request. For more details on how to use the secret and the `X-Hub-Signature` header to secure your webhook payloads, see "[Securing your webhooks](/webhooks/securing/)."
\ No newline at end of file
+Setting a webhook secret allows you to ensure that `POST` requests sent to the payload URL are from {% data variables.product.product_name %}. When you set a secret, you'll receive the {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}`X-Hub-Signature` and `X-Hub-Signature-256` headers{% else if currentVersion ver_lt "enterprise-server@2.23" %}`X-Hub-Signature` header{% else if currentVersion == "private-instances@latest" %}`X-Hub-Signature-256` header{% endif %} in the webhook `POST` request. For more information on how to use a secret with a signature header to secure your webhook payloads, see "[Securing your webhooks](/webhooks/securing/)."
diff --git a/translations/de-DE/data/reusables/webhooks/sender_desc.md b/translations/de-DE/data/reusables/webhooks/sender_desc.md
index d3c9f888bc19..218063f9e078 100644
--- a/translations/de-DE/data/reusables/webhooks/sender_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/sender_desc.md
@@ -1 +1 @@
-`sender` | `object` | The user that triggered the event.
\ No newline at end of file
+`sender` | `object` | The user that triggered the event.
diff --git a/translations/de-DE/data/reusables/webhooks/sponsorship_event_api_properties.md b/translations/de-DE/data/reusables/webhooks/sponsorship_event_api_properties.md
index 79451de1fc2e..2dcced46291d 100644
--- a/translations/de-DE/data/reusables/webhooks/sponsorship_event_api_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/sponsorship_event_api_properties.md
@@ -1,3 +1,3 @@
 | Schlüssel | Typ      | Beschreibung                                               |
 | --------- | -------- | ---------------------------------------------------------- |
-| `action`  | `string` | die Aktion, die durchgeführt wurde. This can be `created`. |
\ No newline at end of file
+| `action`  | `string` | die Aktion, die durchgeführt wurde. This can be `created`. |
diff --git a/translations/de-DE/data/reusables/webhooks/sponsorship_properties.md b/translations/de-DE/data/reusables/webhooks/sponsorship_properties.md
index 6506db181710..939d7fd0ea13 100644
--- a/translations/de-DE/data/reusables/webhooks/sponsorship_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/sponsorship_properties.md
@@ -1 +1 @@
-`effective_date` | `string` | The `pending_cancellation` and `pending_tier_change` event types will include the date the cancellation or tier change will take effect. `changes[tier][from]` | `object` | The `tier_changed` and `pending_tier_change` will include the original tier before the change or pending change. For more information, see the [pending tier change payload](/webhooks/event-payloads#webhook-payload-example-when-someone-downgrades-a-sponsorship). `changes[privacy_level][from]` | `string` | The `edited` event types include the details about the change when someone edits a sponsorship to change the privacy.
\ No newline at end of file
+`effective_date` | `string` | The `pending_cancellation` and `pending_tier_change` event types will include the date the cancellation or tier change will take effect. `changes[tier][from]` | `object` | The `tier_changed` and `pending_tier_change` will include the original tier before the change or pending change. For more information, see the [pending tier change payload](/webhooks/event-payloads#webhook-payload-example-when-someone-downgrades-a-sponsorship). `changes[privacy_level][from]` | `string` | The `edited` event types include the details about the change when someone edits a sponsorship to change the privacy.
diff --git a/translations/de-DE/data/reusables/webhooks/sponsorship_short_desc.md b/translations/de-DE/data/reusables/webhooks/sponsorship_short_desc.md
index cb6cdccf21dc..2f62ffe8d86a 100644
--- a/translations/de-DE/data/reusables/webhooks/sponsorship_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/sponsorship_short_desc.md
@@ -1 +1 @@
-Activity related to a sponsorship listing. {% data reusables.webhooks.action_type_desc %} For more information, see "[About GitHub Sponsors](/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors)".
\ No newline at end of file
+Activity related to a sponsorship listing. {% data reusables.webhooks.action_type_desc %} For more information, see "[About GitHub Sponsors](/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors)".
diff --git a/translations/de-DE/data/reusables/webhooks/sponsorship_webhook_properties.md b/translations/de-DE/data/reusables/webhooks/sponsorship_webhook_properties.md
index 85155ad97462..e841926df8b4 100644
--- a/translations/de-DE/data/reusables/webhooks/sponsorship_webhook_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/sponsorship_webhook_properties.md
@@ -1,3 +1,3 @@
 | Schlüssel | Typ      | Beschreibung                                                                                                                                               |
 | --------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `action`  | `string` | die Aktion, die durchgeführt wurde. This can be one of `created`, `cancelled`, `edited`, `tier_changed`, `pending_cancellation`, or `pending_tier_change`. |
\ No newline at end of file
+| `action`  | `string` | die Aktion, die durchgeführt wurde. This can be one of `created`, `cancelled`, `edited`, `tier_changed`, `pending_cancellation`, or `pending_tier_change`. |
diff --git a/translations/de-DE/data/reusables/webhooks/star_properties.md b/translations/de-DE/data/reusables/webhooks/star_properties.md
index c7930c2c15be..7f79e524424a 100644
--- a/translations/de-DE/data/reusables/webhooks/star_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/star_properties.md
@@ -1,4 +1,4 @@
-| Schlüssel    | Typ      | Beschreibung                                                                                                         |
-| ------------ | -------- | -------------------------------------------------------------------------------------------------------------------- |
-| `action`     | `string` | The action performed. Can be `created` or `deleted`.                                                                 |
-| `starred_at` | `string` | The time the star was created. {% data reusables.shortdesc.iso_8601 %} Will be `null` for the `deleted` action. |
\ No newline at end of file
+| Schlüssel    | Typ      | Beschreibung                                                                                                    |
+| ------------ | -------- | --------------------------------------------------------------------------------------------------------------- |
+| `action`     | `string` | The action performed. Can be `created` or `deleted`.                                                            |
+| `starred_at` | `string` | The time the star was created. {% data reusables.shortdesc.iso_8601 %} Will be `null` for the `deleted` action. |
diff --git a/translations/de-DE/data/reusables/webhooks/star_short_desc.md b/translations/de-DE/data/reusables/webhooks/star_short_desc.md
index eac484160fed..f4fb6634197e 100644
--- a/translations/de-DE/data/reusables/webhooks/star_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/star_short_desc.md
@@ -1 +1 @@
-Activity related to a repository being starred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[starring](/v3/activity/starring/)" REST API.
\ No newline at end of file
+Activity related to a repository being starred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[starring](/v3/activity/starring/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/status_short_desc.md b/translations/de-DE/data/reusables/webhooks/status_short_desc.md
index 8d28713099d2..754f871add59 100644
--- a/translations/de-DE/data/reusables/webhooks/status_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/status_short_desc.md
@@ -1 +1 @@
-When the status of a Git commit changes. {% data reusables.webhooks.action_type_desc %} For more information, see the "[statuses](/v3/repos/statuses/)" REST API.
\ No newline at end of file
+When the status of a Git commit changes. {% data reusables.webhooks.action_type_desc %} For more information, see the "[statuses](/v3/repos/statuses/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/team_add_short_desc.md b/translations/de-DE/data/reusables/webhooks/team_add_short_desc.md
index 5ef912458fe4..914535a21208 100644
--- a/translations/de-DE/data/reusables/webhooks/team_add_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/team_add_short_desc.md
@@ -1 +1 @@
-When a [repository is added to a team](/v3/teams/#add-or-update-team-repository-permissions).
\ No newline at end of file
+When a [repository is added to a team](/v3/teams/#add-or-update-team-repository-permissions).
diff --git a/translations/de-DE/data/reusables/webhooks/team_short_desc.md b/translations/de-DE/data/reusables/webhooks/team_short_desc.md
index 8faf762fe915..fdcf742789ee 100644
--- a/translations/de-DE/data/reusables/webhooks/team_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/team_short_desc.md
@@ -1 +1 @@
-Activity related to an organization's team. {% data reusables.webhooks.action_type_desc %} For more information, see the "[teams](/v3/teams/)" REST API.
\ No newline at end of file
+Activity related to an organization's team. {% data reusables.webhooks.action_type_desc %} For more information, see the "[teams](/v3/teams/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/watch_properties.md b/translations/de-DE/data/reusables/webhooks/watch_properties.md
index 39a68c63f437..4f7fe87283f9 100644
--- a/translations/de-DE/data/reusables/webhooks/watch_properties.md
+++ b/translations/de-DE/data/reusables/webhooks/watch_properties.md
@@ -1,3 +1,3 @@
 | Schlüssel | Typ      | Beschreibung                                                          |
 | --------- | -------- | --------------------------------------------------------------------- |
-| `action`  | `string` | die Aktion, die durchgeführt wurde. Currently, can only be `started`. |
\ No newline at end of file
+| `action`  | `string` | die Aktion, die durchgeführt wurde. Currently, can only be `started`. |
diff --git a/translations/de-DE/data/reusables/webhooks/watch_short_desc.md b/translations/de-DE/data/reusables/webhooks/watch_short_desc.md
index a40fc1893db2..a853027b12ef 100644
--- a/translations/de-DE/data/reusables/webhooks/watch_short_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/watch_short_desc.md
@@ -1 +1 @@
-When someone stars a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[starring](/v3/activity/starring/)" REST API.
\ No newline at end of file
+When someone stars a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[starring](/v3/activity/starring/)" REST API.
diff --git a/translations/de-DE/data/reusables/webhooks/webhooks_ssl.md b/translations/de-DE/data/reusables/webhooks/webhooks_ssl.md
index 987a85576227..c0d40e639296 100644
--- a/translations/de-DE/data/reusables/webhooks/webhooks_ssl.md
+++ b/translations/de-DE/data/reusables/webhooks/webhooks_ssl.md
@@ -1 +1 @@
-If your "Payload URL" is a secure site (HTTPS), you will have the option to configure the SSL verification settings. If your "Payload URL" is not secure (HTTP), GitHub will not display this option. By default, GitHub verifies the SSL certificate of your website when delivering webhook payloads. SSL verification helps ensure that hook payloads are delivered to your URL endpoint securely. You have the option to disable SSL, but we recommend keeping **Enable SSL verification** selected.
\ No newline at end of file
+If your "Payload URL" is a secure site (HTTPS), you will have the option to configure the SSL verification settings. If your "Payload URL" is not secure (HTTP), GitHub will not display this option. By default, GitHub verifies the SSL certificate of your website when delivering webhook payloads. SSL verification helps ensure that hook payloads are delivered to your URL endpoint securely. You have the option to disable SSL, but we recommend keeping **Enable SSL verification** selected.
diff --git a/translations/de-DE/data/reusables/webhooks/workflow_run_desc.md b/translations/de-DE/data/reusables/webhooks/workflow_run_desc.md
index 25d67bab0223..8866577116c7 100644
--- a/translations/de-DE/data/reusables/webhooks/workflow_run_desc.md
+++ b/translations/de-DE/data/reusables/webhooks/workflow_run_desc.md
@@ -1,4 +1,4 @@
 
 This event occurs when a workflow run is requested or completed, and allows you to execute a workflow based on the finished result of another workflow. For example, if your `pull_request` workflow generates build artifacts, you can create a new workflow that uses `workflow_run` to analyze the results and add a comment to the original pull request.
 
-The workflow started by the `workflow_run` event is able to access the secrets and write tokens used by the original workflow.
\ No newline at end of file
+The workflow started by the `workflow_run` event is able to access the secrets and write tokens used by the original workflow.
diff --git a/translations/de-DE/data/variables/command_line.yml b/translations/de-DE/data/variables/command_line.yml
index decb9036da37..805c67903e68 100644
--- a/translations/de-DE/data/variables/command_line.yml
+++ b/translations/de-DE/data/variables/command_line.yml
@@ -1,10 +1,10 @@
 ---
-#Use this variable wherever backticks are necessary: http://git.io/AArkqA
+#Use this variable wherever backticks are necessary: https://github.com/github/docs-internal/pull/1176#discussion-diff-19853931
 backticks: >-
   {% if currentVersion == "free-pro-team@latest" %}github.com{% else %}[hostname]{% endif %}
 #Use this variable within codeblocks (because it includes HTML! Which only renders in shell codeblocks!)
 codeblock: >-
-  {% if currentVersion == "free-pro-team@latest" %}github.com{% else %}Hostname{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}github.com{% else %}hostname{% endif %}
 #GitHub URL example
 git_url_example: >-
   https://{% if currentVersion == "free-pro-team@latest" %}github.com{% else %}github.example.com{% endif %}
diff --git a/translations/de-DE/data/variables/contact.yml b/translations/de-DE/data/variables/contact.yml
index 97af18ea46ef..c9a2e60dcbf2 100644
--- a/translations/de-DE/data/variables/contact.yml
+++ b/translations/de-DE/data/variables/contact.yml
@@ -1,18 +1,17 @@
 ---
 contact_ent_support: '[GitHub Enterprise-Support](https://enterprise.githubsupport.com/hc/en-us) oder [GitHub Premium-Support](https://premium.githubsupport.com)'
 contact_support: >-
-  {% if currentVersion == "free-pro-team@latest" %}[GitHub-Support]((https://support.github.com/contact) oder [GitHub Premium-Support](https://premium.githubsupport.com){% else %}Ihr GitHub Enterprise-Websiteadministrator{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[GitHub Support](https://support.github.com/contact) or [GitHub Premium Support](https://premium.githubsupport.com){% else %}your GitHub Enterprise site administrator{% endif %}
 report_abuse: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Missbrauch melden](https://github.com/contact/report-abuse){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Report abuse](https://github.com/contact/report-abuse){% endif %}
 report_content: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Missbrauch melden](https://github.com/contact/report-content){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Report content](https://github.com/contact/report-content){% endif %}
 contact_dmca: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Formular für Urheberrechtsansprüche](https://github.com/contact/dmca){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Copyright claims form](https://github.com/contact/dmca){% endif %}
 contact_privacy: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Datenschutzkontaktformular](https://github.com/contact/privacy){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Privacy contact form](https://github.com/contact/privacy){% endif %}
 contact_enterprise_sales: '[GitHub''s Vertriebsteam](https://enterprise.github.com/contact)'
 contact_feedback_actions: '[Feedback-Formular für GitHub Actions](https://support.github.com/contact/feedback?contact[category]=actions)'
-contact_partner_engineering: '[partnerengineering@github.com](mailto:partnerengineering@github.com)'
 #The team that provides Standard Support
 enterprise_support: 'GitHub Enterprise-Support'
 #The larger team that includes Enterprise Support and Premium Support
diff --git a/translations/de-DE/data/variables/explore.yml b/translations/de-DE/data/variables/explore.yml
index dc889a0c1f9a..e9d43c423085 100644
--- a/translations/de-DE/data/variables/explore.yml
+++ b/translations/de-DE/data/variables/explore.yml
@@ -1,7 +1,7 @@
 ---
 explore_github: >-
-  {% if currentVersion == "free-pro-team@latest" %}[GitHub erkunden](https://github.com/explore){% else %}GitHub erkunden („https://[hostname]/explore“){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Explore GitHub](https://github.com/explore){% else %}Explore GitHub (`https://[hostname]/explore`){% endif %}
 your_stars_page: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Seite mit Sternen](https://github.com/stars){% else %}Seite mit Sternen („https://[hostname]/stars“){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[stars page](https://github.com/stars){% else %}stars page (`https://[hostname]/stars`){% endif %}
 trending_page: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Seite mit Trends](https://github.com/trending){% else %}Seite mit Trends („https://[hostname]/trending“){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Trending page](https://github.com/trending){% else %}Trending page (`https://[hostname]/trending`){% endif %}
diff --git a/translations/de-DE/data/variables/gists.yml b/translations/de-DE/data/variables/gists.yml
index 5e1b5ff0b33a..9d1fea10acf4 100644
--- a/translations/de-DE/data/variables/gists.yml
+++ b/translations/de-DE/data/variables/gists.yml
@@ -1,7 +1,7 @@
 ---
 gist_homepage: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Gist-Startseite](https://gist.github.com/){% else %}Gist-Startseite, „http(s)://[hostname]/gist“ oder „http(s)://gist.[hostname]“ bei aktivierten Subdomains {% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[gist home page](https://gist.github.com/){% else %}gist home page, `http(s)://[hostname]/gist` or `http(s)://gist.[hostname]` if subdomains are enabled {% endif %}
 gist_search_url: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Gist-Suche](https://gist.github.com/search){% else %}Gist-Suche, „http(s)://[hostname]/gist/search“ oder „http(s)://gist.[hostname]/search“ bei aktivierten Subdomains{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Gist Search](https://gist.github.com/search){% else %}Gist Search, `http(s)://[hostname]/gist/search` or `http(s)://gist.[hostname]/search` if subdomains are enabled{% endif %}
 discover_url: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Discover (Erkunden)](https://gist.github.com/discover){% else %}Discover (Erkunden), „http(s)://[hostname]/gist/discover“ oder „http(s)://gist.[hostname]/discover“ bei aktivierten Subdomains{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Discover](https://gist.github.com/discover){% else %}Discover, `http(s)://[hostname]/gist/discover` or `http(s)://gist.[hostname]/discover` if subdomains are enabled{% endif %}
diff --git a/translations/de-DE/data/variables/notifications.yml b/translations/de-DE/data/variables/notifications.yml
index 195b7d2e84ee..441bdba328c2 100644
--- a/translations/de-DE/data/variables/notifications.yml
+++ b/translations/de-DE/data/variables/notifications.yml
@@ -1,5 +1,5 @@
 ---
 no_reply_address: >-
-  {% if currentVersion == "free-pro-team@latest" %}„noreply@github.com“{% else %}die von Ihrem Websiteadministrator konfigurierte no-reply-E-Mail-Adresse{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}`noreply@github.com`{% else %}the no-reply email address configured by your site administrator{% endif %}
 cc_address: >-
-  {% if currentVersion == "free-pro-team@latest" %}„@noreply.github.com“{% else %}basiert auf der von Ihrem Websiteadministrator konfigurierten no-reply-E-Mail-Adresse{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}`@noreply.github.com`{% else %}based on the no-reply email address configured by your site administrator{% endif %}
diff --git a/translations/de-DE/data/variables/product.yml b/translations/de-DE/data/variables/product.yml
index 0c510a980dd8..ff82002c5b71 100644
--- a/translations/de-DE/data/variables/product.yml
+++ b/translations/de-DE/data/variables/product.yml
@@ -19,7 +19,7 @@ prodname_ghe_cloud: 'GitHub Enterprise Cloud'
 prodname_ghe_one: 'GitHub One'
 ## Use these variables when referring specifically to a location within a product
 product_location: >-
-  {% if currentVersion == "free-pro-team@latest" %}GitHub{% else %}Ihre GitHub Enterprise Server-Instanz{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}GitHub{% else %}your GitHub Enterprise Server instance{% endif %}
 product_location_enterprise: 'Ihre GitHub Enterprise Server-Instanz'
 prodname_free_user: 'GitHub Free'
 prodname_pro: 'GitHub Pro'
@@ -56,12 +56,9 @@ prodname_github_app: 'GitHub App'
 prodname_github_apps: 'GitHub Apps'
 prodname_oauth_app: 'OAuth App'
 #API and developer docs
-prodname_dev_docs: 'die GitHub-Entwicklerdokumentation'
 prodname_enterprise_api: 'die GitHub Enterprise Server-API'
-prodname_support_forum: 'GitHub API Entwicklungs- und Support-Forum'
 prodname_support_forum_with_url: '[GitHub API Entwicklungs- und Support-Forum](https://github.community/c/github-api-development-and-support/37)'
 prodname_unfurls: 'Inhaltsanhänge'
-prodname_component_kit: 'GitHub Component Kit'
 #GitHub Actions
 ## Use this variable only when referring to GitHub Actions the product. When referring to the thing that someone creates using the product, call it an action (small a). See the terminology page of the Brand Guide for more.
 prodname_actions: 'GitHub Actions'
@@ -80,9 +77,8 @@ prodname_matching_fund: 'GitHub Sponsors Matching Fund'
 prodname_advanced_security: 'Advanced Security'
 #Codespaces
 prodname_codespaces: 'Codespaces'
-prodname_vscode: 'Visual Studio Code'
 prodname_vs_codespaces: 'Visual Studio Codespaces'
-prodname_vs: 'Visual Studio'
+prodname_github_codespaces: 'GitHub Codespaces'
 #GitHub resources: blog, jobs, Learning Lab
 prodname_gcf: 'GitHub Community Support'
 prodname_blog: 'der GitHub-Blog'
@@ -110,15 +106,18 @@ prodname_code_scanning: 'code scanning'
 prodname_code_scanning_capc: 'Code scanning'
 prodname_codeql_runner: 'CodeQL runner'
 prodname_advisory_database: 'GitHub Advisory Database'
-prodname_codeql_workflow: 'CodeQL Analysis workflow'
+prodname_codeql_workflow: 'CodeQL analysis workflow'
+#Visual Studio
+prodname_vs: 'Visual Studio'
+prodname_vscode: 'Visual Studio Code'
+prodname_vss_ghe: 'Visual Studio subscription with GitHub Enterprise'
+prodname_vss_admin_portal_with_url: 'the [administrator portal for Visual Studio subscriptions](https://visualstudio.microsoft.com/subscriptions-administration/)'
 #GitHub Dependabot
 prodname_dependabot: 'GitHub Dependabot'
 prodname_dependabot_short: 'Dependabot'
 prodname_dependabot_alerts: 'GitHub Dependabot alerts'
 prodname_dependabot_security_updates: 'GitHub Dependabot security updates'
 prodname_dependabot_version_updates: 'GitHub Dependabot version updates'
-#GitHub Policies
-prodname_policies: 'GitHub Policies'
 #GitHub Archive Program
 prodname_archive: 'GitHub Archive-Programm'
 prodname_arctic_vault: 'Arctic Code Vault'
@@ -127,9 +126,9 @@ product_url: >-
   {% if currentVersion == "free-pro-team@latest" %}github.com{% else %}[hostname]{% endif %}
 pricing_url: 'https://github.com/pricing'
 signin_link: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Sign in](https://github.com/login){% else %}Anmelden („https://[hostname]/login“){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Sign in](https://github.com/login){% else %}Sign in (`https://[hostname]/login`){% endif %}
 signout_link: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Sign out](https://github.com/logout){% else %}Abmelden („https://[hostname]/logout“){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Sign out](https://github.com/logout){% else %}Sign out (`https://[hostname]/logout`){% endif %}
 raw_github_com: >-
   {% if currentVersion == "free-pro-team@latest" %}raw.githubusercontent.com{% else %}[hostname]/user/repo/raw{% endif %}
 #GitHub Enterprise Server past versions
diff --git a/translations/de-DE/data/variables/search.yml b/translations/de-DE/data/variables/search.yml
index 238da519a318..f22c85c91625 100644
--- a/translations/de-DE/data/variables/search.yml
+++ b/translations/de-DE/data/variables/search.yml
@@ -1,11 +1,5 @@
 ---
 advanced_url: >-
-  {% if currentVersion == "free-pro-team@latest" %}Seite für [erweiterte Suche](https://github.com/search/advanced){% else %}Seite für erweiterte Suche („https://[Hostname]/search/advanced“){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[advanced search](https://github.com/search/advanced) page{% else %}advanced search page (`https://[hostname]/search/advanced`){% endif %}
 search_page_url: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Suchseite](https://github.com/search){% else %}Suchseite („https://[Hostname]/search“){% endif %}
-search_highlighting_link: >-
-  Für weitere Details, wie man hervorgehobene Suchergebnisse erhält, siehe [Textübereinstimmung mit Metadaten](#text-match-metadata).
-search_query_description: >-
-  Die Suchanfrage enthält ein oder mehrere Suchbegriffe und Qualifizierer. Qualifizierer erlauben Dir, die Suche auf spezifische Bereiche auf GitHub einzuschränken. Das REST-API unterstützt die gleichen Qualifizierer wie GitHub.com. Um mehr über das Format der Abfrage zu erfahren, siehe [Eine Suchanfrage erstellen](#constructing-a-search-query).
-order_description: >-
-  Legt fest, ob das erste zurückgegebene Suchergebnis die höchste Anzahl von Übereinstimmungen (`desc`) (absteigend) oder die niedrigste Anzahl von Übereinstimmungen (`asc`) (aufsteigend) enthält. Dieser Parameter wird ignoriert, es sei denn, Du gibst `sort` mit. Der Standardwert ist `desc` (absteigend)
+  {% if currentVersion == "free-pro-team@latest" %}[search](https://github.com/search) page{% else %}search page (`https://[hostname]/search`){% endif %}
diff --git a/translations/es-XL/content/developers/apps/authorizing-oauth-apps.md b/translations/es-XL/content/developers/apps/authorizing-oauth-apps.md
index 2d59d81e19f6..87f8be697567 100644
--- a/translations/es-XL/content/developers/apps/authorizing-oauth-apps.md
+++ b/translations/es-XL/content/developers/apps/authorizing-oauth-apps.md
@@ -1,5 +1,5 @@
 ---
-title: Autorizar aplicaciones OAuth
+title: Authorizing OAuth Apps
 intro: '{% data reusables.shortdesc.authorizing_oauth_apps %}'
 redirect_from:
   - /apps/building-integrations/setting-up-and-registering-oauth-apps/about-authorization-options-for-oauth-apps/
@@ -13,83 +13,84 @@ versions:
   enterprise-server: '*'
 ---
 
-La implementación de OAuth de {% data variables.product.product_name %} es compatible con el [tipo de auotrización para otorgamiento de código](https://tools.ietf.org/html/rfc6749#section-4.1){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} y con el [Otorgamiento de autorizción para dispositivos](https://tools.ietf.org/html/rfc8628) de OAuth 2.0 para las apps que no tengan acceso a un buscador web{% endif %}.
+{% data variables.product.product_name %}'s OAuth implementation supports the standard [authorization code grant type](https://tools.ietf.org/html/rfc6749#section-4.1){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} and the OAuth 2.0 [Device Authorization Grant](https://tools.ietf.org/html/rfc8628) for apps that don't have access to a web browser{% endif %}.
 
-Si quieres saltar el proceso de autorización de tu app en el modo estándar, tal como sucede cuando la estás probando, puedes utilizar el [flujo no web para aplicaciones](#non-web-application-flow).
+If you want to skip authorizing your app in the standard way, such as when testing your app, you can use the [non-web application flow](#non-web-application-flow).
 
 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}
 
-Para autorizar tu app de OAuth, considera qué flujo de autorizaciones queda mejor con ella.
+To authorize your OAuth app, consider which authorization flow best fits your app.
 
-- [flujo web de aplicaciones](#web-application-flow): Se utiliza para autorizar a los usuarios para las aplicaciones de OAuth que se ejecutan en el buscador. (El [tipo de concesión implícito](https://tools.ietf.org/html/rfc6749#section-4.2) no es compatible)
-- [flujo de dispositivos](#device-flow): Se utiliza para las apps sin encabezado, tales como las herramientas de CLI.
+- [web application flow](#web-application-flow): Used to authorize users for standard OAuth apps that run in the browser. (The [implicit grant type](https://tools.ietf.org/html/rfc6749#section-4.2) is not supported.)
+- [device flow](#device-flow):  Used for headless apps, such as CLI tools.
 
 {% else %}
 
-Para las apps estándar que se ejecutan en el buscador, utiliza el [flujo web de aplicaciones](#web-application-flow) para obtener un código de autorización e intercambiarlo por un token. (El [tipo de concesión implícito](https://tools.ietf.org/html/rfc6749#section-4.2) no es compatible)
+For standard apps that run in the browser, use the [web application flow](#web-application-flow) to obtain an authorization code and exchange it for a token. (The [implicit grant type](https://tools.ietf.org/html/rfc6749#section-4.2) is not supported.)
 
 {% endif %}
 
-### Flujo de aplicaciones Web
+### Web application flow
 
 {% note %}
 
-**Nota:** Si estás creando una GitHub App, aún puedes utilizar el flujo de aplicaciones web de OAuth, pero la configuración tiene diferencias importantes. Consulta la sección "[Identificar y autorizar usuarios para las GitHub Apps](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/)" para obtener más información.
+**Note:** If you are building a GitHub App, you can still use the OAuth web application flow, but the setup has some important differences. See "[Identifying and authorizing users for GitHub Apps](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/)" for more information.
 
 {% endnote %}
 
-El flujo web de aplicaciones para autorizar a los usuarios en tu app es:
+The web application flow to authorize users for your app is:
 
-1. Se redirecciona a los usuarios para solicitar su identidad de GitHub
-2. GitHub redirecciona a los usuarios de vuelta a tu sitio
-3. Tu aplicación accede a la API con el token de acceso del usuario
+1. Users are redirected to request their GitHub identity
+2. Users are redirected back to your site by GitHub
+3. Your app accesses the API with the user's access token
 
-#### 1. Solicita la identidad de un usuario de GitHub
+#### 1. Request a user's GitHub identity
 
     GET {% data variables.product.oauth_host_code %}/login/oauth/authorize
 
-Cuando tu GitHub App especifica un parámetro de `login`, solicita a los usuarios con una cuenta específica que pueden utilizar para registrarse y autorizar tu app.
+When your GitHub App specifies a `login` parameter, it prompts users with a specific account they can use for signing in and authorizing your app.
 
-##### Parámetros
+##### Parameters
 
-| Nombre         | Tipo        | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
-| -------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `client_id`    | `secuencia` | **Requerido**. La ID de cliente que recibiste de GitHub cuando te {% if currentVersion == "free-pro-team@latest" %}[registraste](https://github.com/settings/applications/new){% else %}registraste{% endif %}.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
-| `redirect_uri` | `secuencia` | La URL en tu aplicación a donde se enviará a los usuarios después de la autorización. Consulta los siguientes detalles sobre [urls de redireccionamiento](#redirect-urls).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
-| `login`        | `secuencia` | Sugiere una cuenta específica para utilizar para registrarse y autorizar la app.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| `alcance`      | `secuencia` | Una lista de [alcances](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/) delimitada en espacio. De no proporcionarse, el `scope` será, predeterminadamente, una lista vacía para los usuarios que no han autorizado ningún alcance para la aplicación. Para los usuarios que han autorizado alcances para la aplicación, el usuario no se mostrará en la página de autorización de OAuth con la lista de alcances. En vez de esto, este paso del flujo se completara automáticamente con el conjunto de alcances que el usuario haya autorizado para la aplicación. Por ejemplo, si un usuario ya realizó el flujo web dos veces y autorizó un token con alcance de `user` y otro con alcance de `repo`, un tercer flujo web que no proporcione un `scope` recibirá un token con los alcances `user` y `repo`. |
-| `state`        | `secuencia` | {% data reusables.apps.state_description %}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| `allow_signup` | `secuencia` | Ya sea que se ofrezca o no una opción para registrarse en GitHub a los usuarios sin autenticar durante el flujo de OAuth, la opción predeterminada es `true`. Utiliza `false` cuando una política prohíba los registros.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+Name | Type | Description
+-----|------|--------------
+`client_id`|`string` | **Required**. The client ID you received from GitHub when you {% if currentVersion == "free-pro-team@latest" %}[registered](https://github.com/settings/applications/new){% else %}registered{% endif %}.
+`redirect_uri`|`string` | The URL in your application where users will be sent after authorization. See details below about [redirect urls](#redirect-urls).
+`login` | `string` | Suggests a specific account to use for signing in and authorizing the app.
+`scope`|`string` | A space-delimited list of [scopes](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/). If not provided, `scope` defaults to an empty list for users that have not authorized any scopes for the application. For users who have authorized scopes for the application, the user won't be shown the OAuth authorization page with the list of scopes. Instead, this step of the flow will automatically complete with the set of scopes the user has authorized for the application. For example, if a user has already performed the web flow twice and has authorized one token with `user` scope and another token with `repo` scope, a third web flow that does not provide a `scope` will receive a token with `user` and `repo` scope.
+`state` | `string` | {% data reusables.apps.state_description %}
+`allow_signup`|`string` | Whether or not unauthenticated users will be offered an option to sign up for GitHub during the OAuth flow. The default is `true`. Use `false` when a policy prohibits signups.
 
-#### 2. GitHub redirecciona a los usuarios de vuelta a tu sitio
+#### 2. Users are redirected back to your site by GitHub
 
-Si el usuario acepta tu solicitud, {% data variables.product.product_name %} lo redirecciona a tu sitio con un `code` temporal en un parámetro de código así como el estado que proporcionaste en el paso previo en un parámetro de `state`. El código temporal caducará después de 10 minutos. Si los estados no empatan, entonces un tercero creó la solicitud, y debes abandonar el proceso.
+If the user accepts your request, {% data variables.product.product_name %} redirects back to your site with a temporary `code` in a code parameter as well as the state you provided in the previous step in a `state` parameter. The temporary code will expire after 10 minutes. If the states don't match, then a third party created the request, and you should abort the process.
 
-Intercambia este `code` por un token de acceso:
+Exchange this `code` for an access token:
 
     POST {% data variables.product.oauth_host_code %}/login/oauth/access_token
 
-##### Parámetros
+##### Parameters
 
-| Nombre          | Tipo        | Descripción                                                                                                                                                            |
-| --------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `client_id`     | `secuencia` | **Requerido.** La ID de cliente que recibiste de {% data variables.product.product_name %} para tu {% data variables.product.prodname_github_app %}.       |
-| `client_secret` | `secuencia` | **Requerido.** El secreto del cliente que recibiste de {% data variables.product.product_name %} para tu {% data variables.product.prodname_github_app %}. |
-| `código`        | `secuencia` | **Requerido.** El código que recibiste como respuesta al Paso 1.                                                                                                       |
-| `redirect_uri`  | `secuencia` | La URL en tu aplicación, hacia la cual se envía a los usuarios después de su autorización.                                                                             |
-| `state`         | `secuencia` | La secuencia aleatoria indescifrable que proporcionaste en el Paso 1.                                                                                                  |
+Name | Type | Description
+-----|------|--------------
+`client_id` | `string` | **Required.** The client ID you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_github_app %}.
+`client_secret` | `string` | **Required.** The client secret you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_github_app %}.
+`code` | `string` | **Required.** The code you received as a response to Step 1.
+`redirect_uri` | `string` | The URL in your application where users are sent after authorization.
+`state` | `string` | The unguessable random string you provided in Step 1.
 
-##### Respuesta
+##### Response
 
-Predeterminadamente, la respuesta toma la siguiente forma:
+By default, the response takes the following form:
 
     access_token=e72e16c7e42f292c6912e7710c838347ae178b4a&token_type=bearer
 
-También puedes recibir el contenido en diferentes formatos, dependiendo del encabezado de aceptación:
+You can also receive the content in different formats depending on the Accept
+header:
 
     Accept: application/json
     {"access_token":"e72e16c7e42f292c6912e7710c838347ae178b4a", "scope":"repo,gist", "token_type":"bearer"}
-    
+
     Accept: application/xml
     
       bearer
@@ -97,51 +98,50 @@ También puedes recibir el contenido en diferentes formatos, dependiendo del enc
       e72e16c7e42f292c6912e7710c838347ae178b4a
     
 
-#### 3. Utiliza el token de acceso para acceder a la API
+#### 3. Use the access token to access the API
 
-El token de acceso te permite hacer solicitudes a la API a nombre de un usuario.
+The access token allows you to make requests to the API on a behalf of a user.
 
     Authorization: token OAUTH-TOKEN
     GET {% data variables.product.api_url_code %}/user
 
-Por ejemplo, en curl, puedes configurar el encabezado de autorización de la siguiente manera:
+For example, in curl you can set the Authorization header like this:
 
 ```shell
 curl -H "Authorization: token OAUTH-TOKEN" {% data variables.product.api_url_pre %}/user
 ```
 
 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}
-### Flujo de dispositivos
+### Device flow
 
 {% note %}
 
-**Nota:** El flujo de dispositivos se encuentra en beta público y está sujeto a cambios.{% if currentVersion == "free-pro-team@latest" %} Para habilitar esta característica beta, consulta la sección "[Activar las características beta para las apps](/developers/apps/activating-beta-features-for-apps)".{% endif %}
+**Note:** The device flow is in public beta and subject to change.{% if currentVersion == "free-pro-team@latest" %} To enable this beta feature, see "[Activating beta features for apps](/developers/apps/activating-beta-features-for-apps)."{% endif %}
 
 {% endnote %}
 
-Este flujo de dispositivos te permite autorizar usuarios para una app sin encabezado, tal como una herramienta de CLI o un administrador de credenciales de Git.
+The device flow allows you to authorize users for a headless app, such as a CLI tool or Git credential manager.
 
-#### Resumen del flujo de dispositivos
+#### Overview of the device flow
 
-1. Tu app solicita el dispositivo y los códigos de verificación de usuario y obtiene una URL de autoización en donde el usuario ignresará su código de verificación de usuario.
-2. La app pide al usuario ingresar un código de verificación de usuario en {% data variables.product.device_authorization_url %}.
-3.  La app sondea el estado de autenticación del usuario. Una vez que el usuario haya autorizado el dispositivo, la app podrá hacer llamadas a la API con un token de acceso nuevo.
+1. Your app requests device and user verification codes and gets the authorization URL where the user will enter the user verification code.
+2. The app prompts the user to enter a user verification code at {% data variables.product.device_authorization_url %}.
+3.  The app polls for the user authentication status. Once the user has authorized the device, the app will be able to make API calls with a new access token.
 
-#### Paso 1: La app solicita los códigos de dispositivo y de usuario a GitHub
+#### Step 1: App requests the device and user verification codes from GitHub
 
     POST {% data variables.product.oauth_host_code %}/login/device/code
 
-Tu app debe solicitar un código de verificación de usuario y una URL de verificación que la app utilizará para indicar al usuario que se autentique en el siguiente paso. Esta solicitud también devuelve un código de verificación de dispositivo que debe utilizar la app para recibir un token de acceso y verificar así el estado de la autenticación del usuario.
-
-##### Parámetros de entrada
+Your app must request a user verification code and verification URL that the app will use to prompt the user to authenticate in the next step. This request also returns a device verification code that the app must use to receive an access token and check the status of user authentication.
 
-| Nombre      | Tipo        | Descripción                                                                                                  |
-| ----------- | ----------- | ------------------------------------------------------------------------------------------------------------ |
-| `client_id` | `secuencia` | **Requerido.** La ID de cliente que recibiste de {% data variables.product.product_name %} para tu app. |
-| `alcance`   | `secuencia` | El alcance al cual está solicitando acceso tu app.                                                           |
+##### Input Parameters
 
-##### Respuesta
+Name | Type | Description
+-----|------|--------------
+`client_id` | `string` | **Required.** The client ID you received from {% data variables.product.product_name %} for your app.
+`scope` | `string` | The scope that your app is requesting access to.
 
+##### Response
 
 {% if currentVersion == "free-pro-team@latest" %}
   ```JSON
@@ -165,41 +165,41 @@ Tu app debe solicitar un código de verificación de usuario y una URL de verifi
   ```
 {% endif %}
 
-##### Parámetros de respuesta
+##### Response parameters
 
-| Nombre             | Tipo        | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
-| ------------------ | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `device_code`      | `secuencia` | El código de verificación de dispositivo es de 40 caracteres y se utiliza para verificar dicho dispositivo.                                                                                                                                                                                                                                                                                                                                                                                                  |
-| `user_code`        | `secuencia` | El código de verificación de usuario se muestra en el dispositivo para que el usuario pueda ingresar dicho código en un buscador. El código es de 8 caracteres con un guión medio a la mitad.                                                                                                                                                                                                                                                                                                                |
-| `verification_uri` | `secuencia` | La URL de verificación en donde los usuarios necesitan ingresar el `user_code`: {% data variables.product.device_authorization_url %}.                                                                                                                                                                                                                                                                                                                                                                |
-| `expires_in`       | `número`    | La cantidad de segundos antes de que caduquen tanto el `device_code` como el `user_code`. La cantidad predeterminada es de 900 segundos o 15 minutos.                                                                                                                                                                                                                                                                                                                                                        |
-| `interval`         | `número`    | La cantidad mínima de segundos que deben transcurrir antes de que puedas hacer una soliciud de token de acceso nueva (`POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`) para completar la autorización del dispositivo. Por ejemplo, si el intervalo es 5, entonces no puedes hacer una solicitud nueva hasta que hayan transcurrido 5 segudos. Si haces más de una solicitud en estos 5 segundos, entonces lelgarás al límite de tasa y recibirás un error de `slow_down`. |
+Name | Type | Description
+-----|------|--------------
+`device_code` | `string` | The device verification code is 40 characters and used to verify the device.
+`user_code` | `string` | The user verification code is displayed on the device so the user can enter the code in a browser. This code is 8 characters with a hyphen in the middle.
+`verification_uri` | `string` | The verification URL where users need to enter the `user_code`: {% data variables.product.device_authorization_url %}.
+`expires_in` | `integer`| The number of seconds before the `device_code` and `user_code` expire. The default is 900 seconds or 15 minutes.
+`interval` | `integer` | The minimum number of seconds that must pass before you can make a new access token request (`POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`) to complete the device authorization. For example, if the interval is 5, then you cannot make a new request until 5 seconds pass. If you make more than one request over 5 seconds, then you will hit the rate limit and receive a `slow_down` error.
 
-#### Paso 2: Indicar al usuario ingresar el código de usuario en un buscador
+#### Step 2: Prompt the user to enter the user code in a browser
 
-Tu dispositivo mostrará el código de verificación de usuario y pedirá al usuario ingresar el código en la {% data variables.product.device_authorization_url %}.
+Your device will show the user verification code and prompt the user to enter the code at {% data variables.product.device_authorization_url %}.
 
-  ![Campo para ingresar el código de verificación de usuario nuevo en tu dispositivo](/assets/images/github-apps/device_authorization_page_for_user_code.png)
+  ![Field to enter the user verification code displayed on your device](/assets/images/github-apps/device_authorization_page_for_user_code.png)
 
-#### Paso 3: La app sondea GitHub para verificar si el usuario autorizó el dispositivo
+#### Step 3: App polls GitHub to check if the user authorized the device
 
     POST {% data variables.product.oauth_host_code %}/login/oauth/access_token
 
-Tu app hará solicitudes de autorización de dispositivo que sondean a `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`, hasta que los códigos de dispositivo y de usuario caduquen o hasta que el usuario haya autorizado la app con éxito con un código de usuario válido. La app debe usar el `interval` de sondeo mínimo que se ha recuperado en el paso 1 para evitar los errores de límite de tasa. Para obtener más información, consulta la sección "[Límites de tasa para el flujo del dispositivo](#rate-limits-for-the-device-flow)".
+Your app will make device authorization requests that poll `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`, until the device and user codes expire or the user has successfully authorized the app with a valid user code. The app must use the minimum polling `interval` retrieved in step 1 to avoid rate limit errors. For more information, see "[Rate limits for the device flow](#rate-limits-for-the-device-flow)."
 
-El usuario debe ingresar un código válido dentro de los 15 minutos (o 900 segundos) siguientes. Después de transcurridos estos 15 minutos, necesitarás solicitar un código de autorización de dispositivo nuevo con `POST {% data variables.product.oauth_host_code %}/login/device/code`.
+The user must enter a valid code within 15 minutes (or 900 seconds). After 15 minutes, you will need to request a new device authorization code with `POST {% data variables.product.oauth_host_code %}/login/device/code`.
 
-Ya que el usuario lo haya autorizado, la app recibirá un token de acceso que se puede utilizar para hacer solicitudes a la API en nombre de un usuario.
+Once the user has authorized, the app will receive an access token that can be used to make requests to the API on behalf of a user.
 
-##### Parámetros de entrada
+##### Input parameters
 
-| Nombre        | Tipo        | Descripción                                                                                                                                                           |
-| ------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `client_id`   | `secuencia` | **Requerido.** La ID de cliente que recibiste de {% data variables.product.product_name %} para tu {% data variables.product.prodname_oauth_app %}.       |
-| `device_code` | `secuencia` | **Requerido.** El código de verificación del dispositivo que recibiste de la solicitud de `POST {% data variables.product.oauth_host_code %}/login/device/code`. |
-| `grant_type`  | `secuencia` | **Requerido.** El tipo de otorgamiento debe ser `urn:ietf:params:oauth:grant-type:device_code`.                                                                       |
+Name | Type | Description
+-----|------|--------------
+`client_id` | `string` | **Required.** The client ID you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_oauth_app %}.
+`device_code` | `string` | **Required.** The device verification code you received from the `POST {% data variables.product.oauth_host_code %}/login/device/code` request.
+`grant_type` | `string` | **Required.** The grant type must be `urn:ietf:params:oauth:grant-type:device_code`.
 
-##### Respuesta
+##### Response
 
 ```json
 {
@@ -209,44 +209,50 @@ Ya que el usuario lo haya autorizado, la app recibirá un token de acceso que se
 }
 ```
 
-#### Límites de tasa para el flujo del dispositivo
+#### Rate limits for the device flow
 
-Cuando un usuario emite el código de verificación en el buscador, habrá un límite de tasa de 50 emisiones por hora por aplicación.
+When a user submits the verification code on the browser, there is a there is a rate limit of 50 submissions in an hour per application.
 
-Si realizas más de una solicitud de acceso con token (`POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`) dentro del marco de tiempo mínimo requerido entre solicitudes (o `interval`), alcanzarás el límite de tasa y recibirás una respuesta de error de `slow_down`. La respuesta de error `slow_down` agrega 5 segundos al último `interval`. Para obtener más información, consulta los [Errores para el flujo del dispositivo](#errors-for-the-device-flow).
+If you make more than one access token request (`POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`) within the required minimum timeframe between requests (or `interval`), you'll hit the rate limit and receive a `slow_down` error response. The `slow_down` error response adds 5 seconds to the last `interval`. For more information, see the [Errors for the device flow](#errors-for-the-device-flow).
 
-#### Códigos de error para el flujo del dispositivo
+#### Error codes for the device flow
 
-| Código de error                | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
-| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `authorization_pending`        | Este error ocurre cuando la solicitud de autorización se encuentra pendiente y el usuario no ha ingresado el código de usuario aún. Se espera que la app siga sondeando la solicitud de  `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token` sin exceder el [`interval`](#response-parameters), lo cual requiere una cantidad mínima de segundos entre cada solicitud.                                                                                                                                                                                      |
-| `slow_down`                    | Cuando recibes el error de `slow_down`, se agregan 5 segundos extra al `interval` mínimo o al marco de tiempo requerido entre tus solicitudes utilizando `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`. Por ejemplo, si el intervalo de inicio requirió por lo menos 5 segundos entre solicitudes y obtienes una respuesta de error de `slow_down`, ahora necesitarás esperar por lo menos 10 segundos antes de que hagas una solicitud nueva para un token de acceso de OAuth. La respuesta de error incluye el nuevo `interval` que debes utilizar. |
-| `expired_token`                | Si el código de dispositivo expiró, entonces verás el error `token_expired`. Debes hacer una nueva solicitud para un código de dispositivo.                                                                                                                                                                                                                                                                                                                                                                                                                                               |
-| `unsupported_grant_type`       | El tipo de otorgamiento debe ser `urn:ietf:params:oauth:grant-type:device_code` y se debe incluir como un parámetro de entrada cuando sondeas la solicitud de token de OAuth `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`.                                                                                                                                                                                                                                                                                                                           |
-| `incorrect_client_credentials` | Para el flujo de dispositivos, debes pasar la ID de cliente de tu app, la cual puedes encontrar en la página de configuración de la misma. No se necesita el `client_secret` para el flujo del dispositivo.                                                                                                                                                                                                                                                                                                                                                                               |
-| `incorrect_device_code`        | El device_code que se proporcionó es inválido.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
-| `access_denied`                | Cuando un usuario da clic en cancelar durante el proceso de autorización, recibirás un error de `access_denied` y el usuario no podrá utilizar el código de verificación nuevamente.                                                                                                                                                                                                                                                                                                                                                                                                      |
+| Error code | Description |
+|----|----|
+| `authorization_pending`| This error occurs when the authorization request is pending and the user hasn't entered the user code yet. The app is expected to keep polling the `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token` request without exceeding the [`interval`](#response-parameters), which requires a minimum number of seconds between each request. |
+| `slow_down` | When you receive the `slow_down` error, 5 extra seconds are added to the minimum `interval` or timeframe required between your requests using `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`. For example, if the starting interval required at least 5 seconds between requests and you get a `slow_down` error response, you must now wait a minimum of 10 seconds before making a new request for an OAuth access token. The error response includes the new `interval` that you must use.
+| `expired_token` | If the device code expired, then you will see the `token_expired` error. You must make a new request for a device code.
+| `unsupported_grant_type` | The grant type must be `urn:ietf:params:oauth:grant-type:device_code` and included as an input parameter when you poll the OAuth token request `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`.
+| `incorrect_client_credentials` | For the device flow, you must pass your app's client ID, which you can find on your app settings page. The `client_secret` is not needed for the device flow.
+| `incorrect_device_code` | The device_code provided is not valid.
+| `access_denied` | When a user clicks cancel during the authorization process, you'll receive a `access_denied` error and the user won't be able to use the verification code again.
 
-Para obtener más información, consulta la sección "[Otorgamiento de Autorización de Dispositivo de OAuth 2.0](https://tools.ietf.org/html/rfc8628#section-3.5)".
+For more information, see the "[OAuth 2.0 Device Authorization Grant](https://tools.ietf.org/html/rfc8628#section-3.5)."
 
 {% endif %}
 
-### Flujo de aplicaciónes no web
+### Non-Web application flow
 
-La autenticación no web está disponible para situaciones limitadas, como las pruebas. Si lo necesitas, puedes utilizar la [Autenticación Básica](/v3/auth#basic-authentication) para crear un token de acceso personal utilizando tu [página de configuración de los tokens de acceso personal](/articles/creating-an-access-token-for-command-line-use). Esta técnica le permite al usuario revocar el acceso en cualquier momento.
+Non-web authentication is available for limited situations like testing. If you need to, you can use [Basic Authentication](/v3/auth#basic-authentication) to create a personal access token using your [Personal access tokens settings page](/articles/creating-an-access-token-for-command-line-use). This technique enables the user to revoke access at any time.
 
 {% note %}
 
-**Nota:** CUando utilices el flujo de aplicaciones no web para crear un token OAuth2, asegúrate de entender cómo [trabajar con autenticaciones de dos factores](/v3/auth/#working-with-two-factor-authentication) si tú o tus usuarios han habilitado dicho tipo de autenticación.
+**Note:** When using the non-web application flow to create an OAuth2 token, make sure to understand how to [work with
+two-factor authentication](/v3/auth/#working-with-two-factor-authentication) if
+you or your users have two-factor authentication enabled.
 
 {% endnote %}
 
-### URLs de Redirección
+### Redirect URLs
 
-El parámetro `redirect_uri` es opcional. Si se deja fuera, GitHub redireccionará a los usuarios a la URL de rellamado configurada en la aplicación de OAuth. De proporcionarse, el puerto y host de las URL de rellamado deberán empatar exactamente con la URL de rellamado. La ruta de las URL de redireccionamiento deberán referenciar un subdirectorio de la URL de rellamado.
+The `redirect_uri` parameter is optional. If left out, GitHub will
+redirect users to the callback URL configured in the OAuth Application
+settings. If provided, the redirect URL's host and port must exactly
+match the callback URL. The redirect URL's path must reference a
+subdirectory of the callback URL.
 
     CALLBACK: http://example.com/path
-    
+
     GOOD: http://example.com/path
     GOOD: http://example.com/path/subdir/other
     BAD:  http://example.com/bar
@@ -255,29 +261,29 @@ El parámetro `redirect_uri` es opcional. Si se deja fuera, GitHub redireccionar
     BAD:  http://oauth.example.com:8080/path
     BAD:  http://example.org
 
-#### URLs de redirección de Localhost
+#### Localhost redirect urls
 
-El parámetro opcional `redirect_uri` también puede utilizarse para las URL de localhost. Si la aplicación especifica una URL y puerto de localhost, entonces, después de autorizar la aplicación, los usuarios se redireccionarán al puerto y URL proporcionados. La `redirect_uri` no necesita empatar con el puerto especificado en la url de rellamado para la app.
+The optional `redirect_uri` parameter can also be used for localhost URLs. If the application specifies a localhost URL and a port, then after authorizing the application users will be redirected to the provided URL and port. The `redirect_uri` does not need to match the port specified in the callback url for the app.
 
-Para la URL de rellamado de `http://localhost/path`, puedes utilizar esta `redirect_uri`:
+For the `http://localhost/path` callback URL, you can use this `redirect_uri`:
 
    http://localhost:1234/path
 
-### Crear tokens múltiples para Apps de OAuth
+### Creating multiple tokens for OAuth Apps
 
-Puedes crear tokens múltiples para una combinación de usuario/aplicación/alcance para crear tokens para casos de uso específicos.
+You can create multiple tokens for a user/application/scope combination to create tokens for specific use cases.
 
-Esto es útil si tu Aplicación de OAuth es compatible con un flujo de trabajo que utilice GitHub para registrarse y requiera solo información básica del usuario. Otro flujo de trabajo podría requerir acceso a los repositorios privados del usuario. Al utilizar tokens múltiples, tu App de OAuth podrá llevar a cabo el flujo web para cada caso de uso, solicitando únicamente los alcances que necesite. Si un usuario utiliza tu aplicación únicamente para registrarse, nunca se les solicitará otorgar acceso a tu App de OAuth para sus repositorios privados.
+This is useful if your OAuth App supports one workflow that uses GitHub for sign-in and only requires basic user information. Another workflow may require access to a user's private repositories. Using multiple tokens, your OAuth App can perform the web flow for each use case, requesting only the scopes needed. If a user only uses your application to sign in, they are never required to grant your OAuth App access to their private repositories.
 
-Hay un límite en la cantidad de tokens que se emiten por combinación de usuario/aplicación/alcance. Si tu aplicación solicita suficientes tokens para sobrepasar uno de los límites, los tokens anteriores _con el mismo alcance que se está solicitando_ dejarán de funcionar.
+There is a limit to the number of tokens that are issued per user/application/scope combination. If your application requests enough tokens to go over one of the limits, older tokens _with the same scope being requested_ will stop working.
 
 {% data reusables.apps.deletes_ssh_keys %}
 
-### Dirigir a los usuarios para revisar su acceso
+### Directing users to review their access
 
-Puedes vincular a la información de autorización para una App de OAuth para que los usuarios puedan revisar y revocar sus autorizaciones de la aplicación.
+You can link to authorization information for an OAuth App so that users can review and revoke their application authorizations.
 
-Para crear este vínculo, necesitarás el `client_id` de tus Apps de Oauth, el cual recibiste de GitHub cuando registraste la aplicación.
+To build this link, you'll need your OAuth Apps `client_id` that you received from GitHub when you registered the application.
 
 ```
 {% data variables.product.oauth_host_code %}/settings/connections/applications/:client_id
@@ -285,14 +291,14 @@ Para crear este vínculo, necesitarás el `client_id` de tus Apps de Oauth, el c
 
 {% tip %}
 
-**Tip:** Para aprender más acerca de los recursos a los cuales puede acceder tu App de OAuth para un usuario, consulta la sección "[Descubrir recursos para un usuario](/v3/guides/discovering-resources-for-a-user/)".
+**Tip:** To learn more about the resources that your OAuth App can access for a user, see "[Discovering resources for a user](/v3/guides/discovering-resources-for-a-user/)."
 
 {% endtip %}
 
-### Solución de problemas
+### Troubleshooting
 
-* "[Solución de problemas para errores de solicitud de autorización](/apps/managing-oauth-apps/troubleshooting-authorization-request-errors)"
-* "[Solución de problemas para errores de solicitud de tokens de acceso para Apps de OAuth](/apps/managing-oauth-apps/troubleshooting-oauth-app-access-token-request-errors)"
+* "[Troubleshooting authorization request errors](/apps/managing-oauth-apps/troubleshooting-authorization-request-errors)"
+* "[Troubleshooting OAuth App access token request errors](/apps/managing-oauth-apps/troubleshooting-oauth-app-access-token-request-errors)"
 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}
-* "[Errores de flujo de dispositivo](#errors-for-the-device-flow)"
+* "[Device flow errors](#errors-for-the-device-flow)"
 {% endif %}
diff --git a/translations/es-XL/content/developers/apps/creating-a-github-app-using-url-parameters.md b/translations/es-XL/content/developers/apps/creating-a-github-app-using-url-parameters.md
index 85e04bc2da2e..d718d3f89bdd 100644
--- a/translations/es-XL/content/developers/apps/creating-a-github-app-using-url-parameters.md
+++ b/translations/es-XL/content/developers/apps/creating-a-github-app-using-url-parameters.md
@@ -1,6 +1,6 @@
 ---
-title: Crear una GitHub App utilizando parámetros de URL
-intro: 'Puedes preseleccionar los ajustes de una nueva {% data variables.product.prodname_github_app %} utilizando [parámetros de consulta] de una URL (https://en.wikipedia.org/wiki/Query_string) para configurar rápidamente los nuevos ajustes de la {% data variables.product.prodname_github_app %}.'
+title: Creating a GitHub App using URL parameters
+intro: 'You can preselect the settings of a new {% data variables.product.prodname_github_app %} using URL [query parameters](https://en.wikipedia.org/wiki/Query_string) to quickly set up the new {% data variables.product.prodname_github_app %}''s configuration.'
 redirect_from:
   - /apps/building-github-apps/creating-github-apps-using-url-parameters
 versions:
@@ -9,111 +9,111 @@ versions:
 ---
 
 
-### Acerca de los parámetros de URL de las {% data variables.product.prodname_github_app %}
+### About {% data variables.product.prodname_github_app %} URL parameters
 
-Puedes agregar parámetros de consulta a estas URL para preseleccionar la configuración de una {% data variables.product.prodname_github_app %} en una cuenta organizacional o personal:
-* **Cuenta de usuario:** `https://github.com/settings/apps/new`
-* **Cuenta de organización:** `https://github.com/organizations/:org/settings/apps/new`
+You can add query parameters to these URLs to preselect the configuration of a {% data variables.product.prodname_github_app %} on a personal or organization account:
+* **User account:** `https://github.com/settings/apps/new`
+* **Organization account:** `https://github.com/organizations/:org/settings/apps/new`
 
-El creador de la app puede editar los valores preseleccionados desde la página de registro de la {% data variables.product.prodname_github_app %} antes de emitirla. Si no incluyes los parámetros requeridos en la secuencia de consulta de la URL, como el `name`, el creador de la app necesitará ingresar un valor antes de emitirla.
+The person creating the app can edit the preselected values from the {% data variables.product.prodname_github_app %} registration page, before submitting the app. If you do not include required parameters in the URL query string, like `name`, the person creating the app will need to input a value before submitting the app.
 
-La siguiente URL crea una app pública nueva que se llama `octocat-github-app` con una descripción preconfigurada y una URL de rellamado. Esta URL también selecciona los permisos de lectura y escritura para las `checks`, se suscribe a los eventos de webhook de `check_run` y `check_suite`, y selecciona la opción para solicitar la autorización del usuario (OAuth) durante la instalación:
+The following URL creates a new public app called `octocat-github-app` with a preconfigured description and callback URL. This URL also selects read and write permissions for `checks`, subscribes to the `check_run` and `check_suite` webhook events, and selects the option to request user authorization (OAuth) during installation:
 
   ```
   https://github.com/settings/apps/new?name=octocat-github-app&description=An%20Octocat%20App&callback_url=https://example.com&request_oauth_on_install=true&public=true&checks=write&events[]=check_run&events[]=check_suite
   ```
 
-La lista completa de parámetros de consulta, permisos y eventos disponibles se lista en las secciones siguientes.
+The complete list of available query parameters, permissions, and events is listed in the sections below.
 
-### Parámetros de configuración de una {% data variables.product.prodname_github_app %}
+### {% data variables.product.prodname_github_app %} configuration parameters
 
- | Nombre                     | Tipo                     | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
- | -------------------------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
- | `name (nombre)`            | `secuencia`              | El nombre de la {% data variables.product.prodname_github_app %}. Pónle un nombre claro y breve a tu app. Tu app no puede tener el mismo nombre que un usuario de GitHub, a menos de que sea tu propio nombre de usuario u organización. Una versión simplificada del nombre de tu aplicación se mostrará en la interface de usuario cuando tu integración tome alguna acción.                                                                                                                                                                                     |
- | `descripción`              | `secuencia`              | Una descripción de la {% data variables.product.prodname_github_app %}.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
- | `url`                      | `secuencia`              | La URL complea de la página principal del sitio web de tu {% data variables.product.prodname_github_app %}.                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
- | `callback_url`             | `secuencia`              | La URL completa a la cual se redirigirá después de que alguien autorice la instalación. Esta URL se utiliza si tu app necesita identificar y autorizar las solicitudes de usuario a servidor.                                                                                                                                                                                                                                                                                                                                                                             |
- | `request_oauth_on_install` | `boolean`                | Si tu app autoriza a los usuarios mediante el flujo de OAuth, puedes configurar esta opción como `true` para permitir que las personas autoricen la app cuando la instalen, lo cual te ahorra un paso. Si seleccionas esta opción, la `setup_url` deja de estar disponible y se redirigirá a los usuarios a tu `callback_url` después de que instalen la app.                                                                                                                                                                                                             |
- | `setup_url`                | `secuencia`              | La URL completa a la cual se redirigirá después de que instalen la {% data variables.product.prodname_github_app %} si ésta requiere de alguna configuración adicional después de su instalación.                                                                                                                                                                                                                                                                                                                                                                  |
- | `setup_on_update`          | `boolean`                | Configúralo como `true` para redireccionar a las personas a la URL de ajustes cuando las instalaciones se actualicen, por ejemplo, después de que se agreguen o eliminen repositorios.                                                                                                                                                                                                                                                                                                                                                                                    |
- | `public`                   | `boolean`                | Configúralo como `true` cuando tu {% data variables.product.prodname_github_app %} se encuentre disponible al público, o como `false` cuando solo el propietario de la misma tenga acceso a ella.                                                                                                                                                                                                                                                                                                                                                                  |
- | `webhook_url`              | `secuencia`              | La URL completa a la cual quisieras enviar cargas útiles de eventos de webhook.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
- | `webhook_secret`           | `secuencia`              | Puedes especificar un secreto para asegurar tus webhooks. Consulta la sección "[Asegurar tus webhooks](/webhooks/securing/)" para obtener más detalles.                                                                                                                                                                                                                                                                                                                                                                                                                   |
- | `eventos`                  | `conjunto de secuencias` | Eventos de webhook. Algunos eventos de webhook requieren asignar permisos de `read` o de `write` a un recurso antes de que puedas seleccionar el evento cuando registras una {% data variables.product.prodname_github_app %} nueva. Consulta la sección "[Eventos de webhook de las {% data variables.product.prodname_github_app %}](#github-app-webhook-events)" para encontrar los eventos disponibles y sus permisos requeridos. Puedes seleccionar eventos múltiples en una secuencia de consulta. Por ejemplo, `events[]=public&events[]=label`. |
- | `dominio`                  | `secuencia`              | La URL de una referencia de contenido.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
- | `single_file_name`         | `secuencia`              | Cuando otorgas acceso de `read` o de `write` al permiso de `single_file`, este campo proporciona la ruta al archivo único que administrará tu {% data variables.product.prodname_github_app %}.                                                                                                                                                                                                                                                                                                                                                                    |
+ Name | Type | Description
+-----|------|-------------
+`name` | `string` | The name of the {% data variables.product.prodname_github_app %}. Give your app a clear and succinct name. Your app cannot have the same name as an existing GitHub user, unless it is your own user or organization name. A slugged version of your app's name will be shown in the user interface when your integration takes an action.
+`description` | `string` | A description of the {% data variables.product.prodname_github_app %}.
+`url` | `string` | The full URL of your {% data variables.product.prodname_github_app %}'s website homepage.
+`callback_url` | `string` | The full URL to redirect to after someone authorizes an installation. This URL is used if your app needs to identify and authorize user-to-server requests.
+`request_oauth_on_install` | `boolean` | If your app authorizes users using the OAuth flow, you can set this option to `true` to allow people to authorize the app when they install it, saving a step. If you select this option, the `setup_url` becomes unavailable and users will be redirected to your `callback_url` after installing the app.
+`setup_url` | `string` | The full URL to redirect to after someone installs the {% data variables.product.prodname_github_app %} if the app requires additional setup after installation.
+`setup_on_update` | `boolean` | Set to `true` to redirect people to the setup URL when installations have been updated, for example, after repositories are added or removed.
+`public` | `boolean` | Set to `true` when your {% data variables.product.prodname_github_app %} is available to the public or `false` when it is only accessible to the owner of the app.
+`webhook_url` | `string` | The full URL that you would like to send webhook event payloads to.
+`webhook_secret` | `string` | You can specify a secret to secure your webhooks. See "[Securing your webhooks](/webhooks/securing/)" for more details.
+`events` | `array of strings` | Webhook events. Some webhook events require `read` or `write` permissions for a resource before you can select the event when registering a new {% data variables.product.prodname_github_app %}. See the "[{% data variables.product.prodname_github_app %} webhook events](#github-app-webhook-events)" section for available events and their required permissions. You can select multiple events in a query string. For example, `events[]=public&events[]=label`.
+`domain` | `string` | The URL of a content reference.
+`single_file_name` | `string` | When you grant `read` or `write` access to the `single_file` permission, this field provides the path to the single file your {% data variables.product.prodname_github_app %} will manage.
 
-### Permisos de la {% data variables.product.prodname_github_app %}
+### {% data variables.product.prodname_github_app %} permissions
 
-Puedes seleccionar los permisos en una secuencia de consulta utilizando los nombres de permiso conforme en la siguiente tabla a manera de nombres de parámetro de consulta y usando el tipo de permiso como el valor de la consulta. Por ejemplo, para seleccionar los permisos de `Read & write` en la interface de usuario para `contents`, tu secuencia de consulta incluiría `&contents=write`. Para seleccionar los permisos de `Read-only` en la interface de usuario para `blocking`, tu secuencia de consulta incluiría `&blocking=read`. Para seleccionar `no-access` en la interface de usuario para las `checks`, tu secuencia de consulta no incluiría el permiso `checks`.
+You can select permissions in a query string using the permission name in the following table as the query parameter name and the permission type as the query value. For example, to select `Read & write` permissions in the user interface for `contents`, your query string would include `&contents=write`. To select `Read-only` permissions in the user interface for `blocking`, your query string would include `&blocking=read`. To select `no-access` in the user interface for `checks`, your query string would not include the `checks` permission.
 
-| Permiso                                                                                                                          | Descripción                                                                                                                                                                                                                                                                                                               |
-| -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| [`administración`](/rest/reference/permissions-required-for-github-apps/#permission-on-administration)                           | Otorga acceso a diversas terminales para la administración de organizaciones y repositorios. Puede ser uno de entre: `none`, `read`, o `write`.{% if currentVersion == "free-pro-team@latest" %}
-| [`blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-blocking)                                       | Otorga acceso a la [API de Bloqueo de Usuarios](/v3/users/blocking/). Puede ser uno de entre: `none`, `read`, o `write`.{% endif %}
-| [`verificaciones`](/rest/reference/permissions-required-for-github-apps/#permission-on-checks)                                   | Otorga acceso a la [API de verificaciones](/v3/checks/). Puede ser uno de entre `none`, `read`, o `write`.                                                                                                                                                                                                                |
-| `content_references`                                                                                                             | Otorga acceso a la terminal "[Crear un adjunto de contenido](/v3/apps/installations/#create-a-content-attachment)". Puede ser uno de entre `none`, `read`, o `write`.                                                                                                                                                     |
-| [`contenidos`](/rest/reference/permissions-required-for-github-apps/#permission-on-contents)                                     | Otorga acceso a diversas terminales que te permiten modificar el contenido de los repositorios. Puede ser uno de entre `none`, `read`, o `write`.                                                                                                                                                                         |
-| [`implementaciones`](/rest/reference/permissions-required-for-github-apps/#permission-on-deployments)                            | Otorga acceso a la [API de despliegues](/v3/repos/deployments/). Puede ser uno de entre `none`, `read`, o `write`.                                                                                                                                                                                                        |
-| [`correos electrónicos`](/rest/reference/permissions-required-for-github-apps/#permission-on-emails)                             | Otorga acceso a la [API de Correos electrónicos](/v3/users/emails/). Puede ser uno de entre `none`, `read`, o `write`.                                                                                                                                                                                                    |
-| [`seguidores`](/rest/reference/permissions-required-for-github-apps/#permission-on-followers)                                    | Otorga acceso a la [API de Seguidores](/v3/users/followers/). Puede ser uno de entre `none`, `read`, o `write`.                                                                                                                                                                                                           |
-| [`claves_gpg`](/rest/reference/permissions-required-for-github-apps/#permission-on-gpg-keys)                                     | Otorga acceso a la [API de Llaves GPG](/v3/users/gpg_keys/). Puede ser uno de entre `none`, `read`, o `write`.                                                                                                                                                                                                            |
-| [`propuestas`](/rest/reference/permissions-required-for-github-apps/#permission-on-issues)                                       | Otorga acceso a la [API de Informe de problemas](/v3/issues/). Puede ser uno de entre `none`, `read`, o `write`.                                                                                                                                                                                                          |
-| [`keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-keys)                                               | Otorga acceso a la [API de Llaves Públicas](/v3/users/keys/). Puede ser uno de entre `none`, `read`, o `write`.                                                                                                                                                                                                           |
-| [`members`](/rest/reference/permissions-required-for-github-apps/#permission-on-members)                                         | Otorga acceso para administrar los miembros de una organización. Puede ser uno de entre: `none`, `read`, o `write`.{% if currentVersion == "free-pro-team@latest" %}
-| [`metadatos`](/rest/reference/permissions-required-for-github-apps/#metadata-permissions)                                        | Otorga acceso a las terminales de solo lectura que no filtran datos sensibles. Puede ser `read` o `none`. Su valor predeterminado es `read` cuando configuras cualquier permiso, o bien, `none` cuando no especificas ningún permiso para la {% data variables.product.prodname_github_app %}.                     |
-| [`organization_administration`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-administration) | Otorga acceso a la terminal "[Actualizar una organización](/v3/orgs/#update-an-organization)" y a la [API de Restricciones de Interacción en la Organización](/v3/interactions/orgs/#set-interaction-restrictions-for-an-organization). Puede ser uno de entre: `none`, `read`, o `write`.{% endif %}
-| [`organization_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-hooks)                   | Otorga acceso a la [API de Webhooks de la Organización](/v3/orgs/hooks/). Puede ser uno de entre `none`, `read`, o `write`.                                                                                                                                                                                               |
-| `organization_plan`                                                                                                              | Otorga acceso para obtener información acerca del plan de una organización que utilice la terminal "[Obtener una organización](/v3/orgs/#get-an-organization)". Puede ser uno de entre `none` o `read`.                                                                                                                   |
-| [`organization_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects)             | Otorga acceso a la [API de Proyectos](/v3/projects/). Puede ser uno de entre: `none`, `read`, `write`, o `admin`.{% if currentVersion == "free-pro-team@latest" %}
-| [`organization_user_blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects)        | Otorga acceso a la [API de Bloqueo de Usuarios de la Organización](/v3/orgs/blocking/). Puede ser uno de entre: `none`, `read`, o `write`.{% endif %}
-| [`páginas`](/rest/reference/permissions-required-for-github-apps/#permission-on-pages)                                           | Otorga acceso a la [API de páginas](/v3/repos/pages/). Puede ser uno de entre `none`, `read`, o `write`.                                                                                                                                                                                                                  |
-| `plan`                                                                                                                           | Otorga acceso para obtener información acerca del plan de GitHub de un usuario que utilice la terminal "[Obtener un usuario](/v3/users/#get-a-user)". Puede ser uno de entre `none` o `read`.                                                                                                                             |
-| [`pull_requests`](/rest/reference/permissions-required-for-github-apps/#permission-on-pull-requests)                             | Otorga acceso a varias terminales de solicitud de extracción. Puede ser uno de entre `none`, `read`, o `write`.                                                                                                                                                                                                           |
-| [`repository_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-hooks)                       | Otorga acceso a la [API de Webhooks del Repositorio](/v3/repos/hooks/). Puede ser uno de entre `none`, `read`, o `write`.                                                                                                                                                                                                 |
-| [`repository_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-projects)                 | Otorga acceso a la [API de Proyectos](/v3/projects/). Puede ser uno de entre: `none`, `read`, `write`, o `admin`.                                                                                                                                                                                                         |
-| [`single_file`](/rest/reference/permissions-required-for-github-apps/#permission-on-single-file)                                 | Otorga acceso a la [API de Contenidos](/v3/repos/contents/). Puede ser uno de entre `none`, `read`, o `write`.                                                                                                                                                                                                            |
-| [`starring`](/rest/reference/permissions-required-for-github-apps/#permission-on-starring)                                       | Otorga acceso a la [API de marcar con estrella](/v3/activity/starring/). Puede ser uno de entre `none`, `read`, o `write`.                                                                                                                                                                                                |
-| [`estados`](/rest/reference/permissions-required-for-github-apps/#permission-on-statuses)                                        | Otorga acceso a la [API de Estados](/v3/repos/statuses/). Puede ser uno de entre `none`, `read`, o `write`.                                                                                                                                                                                                               |
-| [`team_discussions`](/rest/reference/permissions-required-for-github-apps/#permission-on-team-discussions)                       | Otorga acceso a la [API de debates de equipo](/v3/teams/discussions/) y a la [API de comentarios en debates de equipo](/v3/teams/discussion_comments/). Puede ser uno de entre `none`, `read`, o `write`.                                                                                                                 |
-| `vulnerability_alerts`                                                                                                           | Otorga acceso para recibir alertas de seguridad para las dependencias vulnerables en un repositorio. Consulta la sección "[Acerca de las alertas de seguridad para las dependencias vulnerables](/articles/about-security-alerts-for-vulnerable-dependencies)" para aprender más. Puede ser uno de entre `none` o `read`. |
-| `observación`                                                                                                                    | Otorga acceso a la lista y cambia los repositorios a los que un usuario está suscrito. Puede ser uno de entre `none`, `read`, o `write`.                                                                                                                                                                                  |
+Permission | Description
+---------- | -----------
+[`administration`](/rest/reference/permissions-required-for-github-apps/#permission-on-administration) | Grants access to various endpoints for organization and repository administration. Can be one of: `none`, `read`, or `write`.{% if currentVersion == "free-pro-team@latest" %}
+[`blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-blocking) | Grants access to the [Blocking Users API](/v3/users/blocking/). Can be one of: `none`, `read`, or `write`.{% endif %}
+[`checks`](/rest/reference/permissions-required-for-github-apps/#permission-on-checks) | Grants access to the [Checks API](/v3/checks/). Can be one of: `none`, `read`, or `write`.
+`content_references` | Grants access to the "[Create a content attachment](/v3/apps/installations/#create-a-content-attachment)" endpoint. Can be one of: `none`, `read`, or `write`.
+[`contents`](/rest/reference/permissions-required-for-github-apps/#permission-on-contents) |  Grants access to various endpoints that allow you to modify repository contents. Can be one of: `none`, `read`, or `write`.
+[`deployments`](/rest/reference/permissions-required-for-github-apps/#permission-on-deployments) | Grants access to the [Deployments API](/rest/reference/repos#deployments). Can be one of: `none`, `read`, or `write`.
+[`emails`](/rest/reference/permissions-required-for-github-apps/#permission-on-emails) | Grants access to the [Emails API](/v3/users/emails/). Can be one of: `none`, `read`, or `write`.
+[`followers`](/rest/reference/permissions-required-for-github-apps/#permission-on-followers) | Grants access to the [Followers API](/v3/users/followers/). Can be one of: `none`, `read`, or `write`.
+[`gpg_keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-gpg-keys) | Grants access to the [GPG Keys API](/v3/users/gpg_keys/). Can be one of: `none`, `read`, or `write`.
+[`issues`](/rest/reference/permissions-required-for-github-apps/#permission-on-issues) | Grants access to the [Issues API](/v3/issues/). Can be one of: `none`, `read`, or `write`.
+[`keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-keys) | Grants access to the [Public Keys API](/v3/users/keys/). Can be one of: `none`, `read`, or `write`.
+[`members`](/rest/reference/permissions-required-for-github-apps/#permission-on-members) |  Grants access to manage an organization's members. Can be one of: `none`, `read`, or `write`.{% if currentVersion == "free-pro-team@latest" %}
+[`metadata`](/rest/reference/permissions-required-for-github-apps/#metadata-permissions) | Grants access to read-only endpoints that do not leak sensitive data. Can be `read` or `none`. Defaults to `read` when you set any permission, or defaults to `none` when you don't specify any permissions for the {% data variables.product.prodname_github_app %}.
+[`organization_administration`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-administration) | Grants access to "[Update an organization](/v3/orgs/#update-an-organization)" endpoint and the [Organization Interaction Restrictions API](/v3/interactions/orgs/#set-interaction-restrictions-for-an-organization). Can be one of: `none`, `read`, or `write`.{% endif %}
+[`organization_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-hooks) | Grants access to the [Organization Webhooks API](/rest/reference/orgs#webhooks/). Can be one of: `none`, `read`, or `write`.
+`organization_plan` | Grants access to get information about an organization's plan using the "[Get an organization](/v3/orgs/#get-an-organization)" endpoint. Can be one of: `none` or `read`.
+[`organization_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects) |  Grants access to the [Projects API](/v3/projects/). Can be one of: `none`, `read`, `write`, or `admin`.{% if currentVersion == "free-pro-team@latest" %}
+[`organization_user_blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects) | Grants access to the [Blocking Organization Users API](/v3/orgs/blocking/). Can be one of: `none`, `read`, or `write`.{% endif %}
+[`pages`](/rest/reference/permissions-required-for-github-apps/#permission-on-pages) | Grants access to the [Pages API](/rest/reference/repos#pages). Can be one of: `none`, `read`, or `write`.
+`plan` | Grants access to get information about a user's GitHub plan using the "[Get a user](/v3/users/#get-a-user)" endpoint. Can be one of: `none` or `read`.
+[`pull_requests`](/rest/reference/permissions-required-for-github-apps/#permission-on-pull-requests) | Grants access to various pull request endpoints. Can be one of: `none`, `read`, or `write`.
+[`repository_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-hooks) | Grants access to the [Repository Webhooks API](/v3/repos/hooks/). Can be one of: `none`, `read`, or `write`.
+[`repository_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-projects) |  Grants access to the [Projects API](/v3/projects/). Can be one of: `none`, `read`, `write`, or `admin`.
+[`single_file`](/rest/reference/permissions-required-for-github-apps/#permission-on-single-file) | Grants access to the [Contents API](/v3/repos/contents/). Can be one of: `none`, `read`, or `write`.
+[`starring`](/rest/reference/permissions-required-for-github-apps/#permission-on-starring) | Grants access to the [Starring API](/v3/activity/starring/). Can be one of: `none`, `read`, or `write`.
+[`statuses`](/rest/reference/permissions-required-for-github-apps/#permission-on-statuses) | Grants access to the [Statuses API](/v3/repos/statuses/). Can be one of: `none`, `read`, or `write`.
+[`team_discussions`](/rest/reference/permissions-required-for-github-apps/#permission-on-team-discussions) | Grants access to the [Team Discussions API](/v3/teams/discussions/) and the [Team Discussion Comments API](/v3/teams/discussion_comments/). Can be one of: `none`, `read`, or `write`.
+`vulnerability_alerts`| Grants access to receive security alerts for vulnerable dependencies in a repository. See "[About security alerts for vulnerable dependencies](/articles/about-security-alerts-for-vulnerable-dependencies)" to learn more. Can be one of: `none` or `read`.
+`watching` | Grants access to list and change repositories a user is subscribed to. Can be one of: `none`, `read`, or `write`.
 
-### Eventos de webhook de {% data variables.product.prodname_github_app %}
+### {% data variables.product.prodname_github_app %} webhook events
 
-| Nombre del evento de webhook                                                                                 | Permiso requerido                               | Descripción                                                                                         |
-| ------------------------------------------------------------------------------------------------------------ | ----------------------------------------------- | --------------------------------------------------------------------------------------------------- |
-| [`check_run`](/webhooks/event-payloads/#check_run)                                                           | `verificaciones`                                | {% data reusables.webhooks.check_run_short_desc %}                                           |
-| [`check_suite`](/webhooks/event-payloads/#check_suite)                                                       | `verificaciones`                                | {% data reusables.webhooks.check_suite_short_desc %}                                          |
-| [`comentario_confirmación de cambios`](/webhooks/event-payloads/#commit_comment)                             | `contenidos`                                    | {% data reusables.webhooks.commit_comment_short_desc %}                                      |
-| [`content_reference`](/webhooks/event-payloads/#content_reference)                                           | `content_references`                            | {% data reusables.webhooks.content_reference_short_desc %}                                   |
-| [`create (crear)`](/webhooks/event-payloads/#create)                                                         | `contenidos`                                    | {% data reusables.webhooks.create_short_desc %}                                              |
-| [`eliminar`](/webhooks/event-payloads/#delete)                                                               | `contenidos`                                    | {% data reusables.webhooks.delete_short_desc %}                                              |
-| [`deployment`](/webhooks/event-payloads/#deployment)                                                         | `implementaciones`                              | {% data reusables.webhooks.deployment_short_desc %}                                          |
-| [`deployment_status`](/webhooks/event-payloads/#deployment_status)                                           | `implementaciones`                              | {% data reusables.webhooks.deployment_status_short_desc %}                                   |
-| [`bifurcación`](/webhooks/event-payloads/#fork)                                                              | `contenidos`                                    | {% data reusables.webhooks.fork_short_desc %}                                                |
-| [`gollum`](/webhooks/event-payloads/#gollum)                                                                 | `contenidos`                                    | {% data reusables.webhooks.gollum_short_desc %}                                              |
-| [`propuestas`](/webhooks/event-payloads/#issues)                                                             | `propuestas`                                    | {% data reusables.webhooks.issues_short_desc %}                                              |
-| [`comentario_propuesta`](/webhooks/event-payloads/#issue_comment)                                            | `propuestas`                                    | {% data reusables.webhooks.issue_comment_short_desc %}                                       |
-| [`etiqueta`](/webhooks/event-payloads/#label)                                                                | `metadatos`                                     | {% data reusables.webhooks.label_short_desc %}                                               |
-| [`member`](/webhooks/event-payloads/#member)                                                                 | `members`                                       | {% data reusables.webhooks.member_short_desc %}                                              |
-| [`membership`](/webhooks/event-payloads/#membership)                                                         | `members`                                       | {% data reusables.webhooks.membership_short_desc %}                                          |
-| [`hito`](/webhooks/event-payloads/#milestone)                                                                | `solicitud_extracción`                          | {% data reusables.webhooks.milestone_short_desc %}{% if currentVersion == "free-pro-team@latest" %}
-| [`org_block`](/webhooks/event-payloads/#org_block)                                                           | `organization_administration`                   | {% data reusables.webhooks.org_block_short_desc %}{% endif %}
-| [`organización`](/webhooks/event-payloads/#organization)                                                     | `members`                                       | {% data reusables.webhooks.organization_short_desc %}                                        |
-| [`page_build`](/webhooks/event-payloads/#page_build)                                                         | `páginas`                                       | {% data reusables.webhooks.page_build_short_desc %}                                          |
-| [`project`](/webhooks/event-payloads/#project)                                                               | `repository_projects` u `organization_projects` | {% data reusables.webhooks.project_short_desc %}                                             |
-| [`project_card`](/webhooks/event-payloads/#project_card)                                                     | `repository_projects` u `organization_projects` | {% data reusables.webhooks.project_card_short_desc %}                                        |
-| [`project_column`](/webhooks/event-payloads/#project_column)                                                 | `repository_projects` u `organization_projects` | {% data reusables.webhooks.project_column_short_desc %}                                      |
-| [`public`](/webhooks/event-payloads/#public)                                                                 | `metadatos`                                     | {% data reusables.webhooks.public_short_desc %}                                              |
-| [`solicitud_extracción`](/webhooks/event-payloads/#pull_request)                                             | `pull_requests`                                 | {% data reusables.webhooks.pull_request_short_desc %}                                        |
-| [`revisión_solicitud de extracción`](/webhooks/event-payloads/#pull_request_review)                          | `solicitud_extracción`                          | {% data reusables.webhooks.pull_request_review_short_desc %}                               |
-| [`comentarios _revisiones_solicitudes de extracción`](/webhooks/event-payloads/#pull_request_review_comment) | `solicitud_extracción`                          | {% data reusables.webhooks.pull_request_review_comment_short_desc %}                       |
-| [`subir`](/webhooks/event-payloads/#push)                                                                    | `contenidos`                                    | {% data reusables.webhooks.push_short_desc %}                                                |
-| [`lanzamiento`](/webhooks/event-payloads/#release)                                                           | `contenidos`                                    | {% data reusables.webhooks.release_short_desc %}                                             |
-| [`repositorio`](/webhooks/event-payloads/#repository)                                                        | `metadatos`                                     | {% data reusables.webhooks.repository_short_desc %}{% if currentVersion == "free-pro-team@latest"%}
-| [`repository_dispatch`](/webhooks/event-payloads/#repository_dispatch)                                       | `contenidos`                                    | Permite que los integradores que utilizan GitHub Actions activen eventos personalizados.{% endif %}
-| [`estado`](/webhooks/event-payloads/#status)                                                                 | `estados`                                       | {% data reusables.webhooks.status_short_desc %}                                              |
-| [`equipo`](/webhooks/event-payloads/#team)                                                                   | `members`                                       | {% data reusables.webhooks.team_short_desc %}                                                |
-| [`team_add`](/webhooks/event-payloads/#team_add)                                                             | `members`                                       | {% data reusables.webhooks.team_add_short_desc %}                                            |
-| [`ver`](/webhooks/event-payloads/#watch)                                                                     | `metadatos`                                     | {% data reusables.webhooks.watch_short_desc %}                                               |
+Webhook event name | Required permission | Description
+------------------ | ------------------- | -----------
+[`check_run`](/webhooks/event-payloads/#check_run) |`checks` | {% data reusables.webhooks.check_run_short_desc %}
+[`check_suite`](/webhooks/event-payloads/#check_suite) |`checks` | {% data reusables.webhooks.check_suite_short_desc %}
+[`commit_comment`](/webhooks/event-payloads/#commit_comment) | `contents` | {% data reusables.webhooks.commit_comment_short_desc %}
+[`content_reference`](/webhooks/event-payloads/#content_reference) |`content_references` | {% data reusables.webhooks.content_reference_short_desc %}
+[`create`](/webhooks/event-payloads/#create) | `contents` | {% data reusables.webhooks.create_short_desc %}
+[`delete`](/webhooks/event-payloads/#delete) | `contents` | {% data reusables.webhooks.delete_short_desc %}
+[`deployment`](/webhooks/event-payloads/#deployment) | `deployments` | {% data reusables.webhooks.deployment_short_desc %}
+[`deployment_status`](/webhooks/event-payloads/#deployment_status) | `deployments` | {% data reusables.webhooks.deployment_status_short_desc %}
+[`fork`](/webhooks/event-payloads/#fork) | `contents` | {% data reusables.webhooks.fork_short_desc %}
+[`gollum`](/webhooks/event-payloads/#gollum) | `contents` | {% data reusables.webhooks.gollum_short_desc %}
+[`issues`](/webhooks/event-payloads/#issues) | `issues` | {% data reusables.webhooks.issues_short_desc %}
+[`issue_comment`](/webhooks/event-payloads/#issue_comment) | `issues` | {% data reusables.webhooks.issue_comment_short_desc %}
+[`label`](/webhooks/event-payloads/#label) | `metadata` | {% data reusables.webhooks.label_short_desc %}
+[`member`](/webhooks/event-payloads/#member) | `members` | {% data reusables.webhooks.member_short_desc %}
+[`membership`](/webhooks/event-payloads/#membership) | `members` | {% data reusables.webhooks.membership_short_desc %}
+[`milestone`](/webhooks/event-payloads/#milestone) | `pull_request` | {% data reusables.webhooks.milestone_short_desc %}{% if currentVersion == "free-pro-team@latest" %}
+[`org_block`](/webhooks/event-payloads/#org_block) | `organization_administration` | {% data reusables.webhooks.org_block_short_desc %}{% endif %}
+[`organization`](/webhooks/event-payloads/#organization) | `members` | {% data reusables.webhooks.organization_short_desc %}
+[`page_build`](/webhooks/event-payloads/#page_build) | `pages` | {% data reusables.webhooks.page_build_short_desc %}
+[`project`](/webhooks/event-payloads/#project) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_short_desc %}
+[`project_card`](/webhooks/event-payloads/#project_card) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_card_short_desc %}
+[`project_column`](/webhooks/event-payloads/#project_column) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_column_short_desc %}
+[`public`](/webhooks/event-payloads/#public) | `metadata` | {% data reusables.webhooks.public_short_desc %}
+[`pull_request`](/webhooks/event-payloads/#pull_request) | `pull_requests` | {% data reusables.webhooks.pull_request_short_desc %}
+[`pull_request_review`](/webhooks/event-payloads/#pull_request_review) | `pull_request` | {% data reusables.webhooks.pull_request_review_short_desc %}
+[`pull_request_review_comment`](/webhooks/event-payloads/#pull_request_review_comment) | `pull_request` | {% data reusables.webhooks.pull_request_review_comment_short_desc %}
+[`push`](/webhooks/event-payloads/#push) | `contents` | {% data reusables.webhooks.push_short_desc %}
+[`release`](/webhooks/event-payloads/#release) | `contents` | {% data reusables.webhooks.release_short_desc %}
+[`repository`](/webhooks/event-payloads/#repository) |`metadata` | {% data reusables.webhooks.repository_short_desc %}{% if currentVersion == "free-pro-team@latest"%}
+[`repository_dispatch`](/webhooks/event-payloads/#repository_dispatch) | `contents` | Allows integrators using GitHub Actions to trigger custom events.{% endif %}
+[`status`](/webhooks/event-payloads/#status) | `statuses` | {% data reusables.webhooks.status_short_desc %}
+[`team`](/webhooks/event-payloads/#team) | `members` | {% data reusables.webhooks.team_short_desc %}
+[`team_add`](/webhooks/event-payloads/#team_add) | `members` | {% data reusables.webhooks.team_add_short_desc %}
+[`watch`](/webhooks/event-payloads/#watch) | `metadata` | {% data reusables.webhooks.watch_short_desc %}
diff --git a/translations/es-XL/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md b/translations/es-XL/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md
index a8838065910e..95d7ec2ffca2 100644
--- a/translations/es-XL/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md
+++ b/translations/es-XL/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md
@@ -1,5 +1,5 @@
 ---
-title: Identificar y autorizar usuarios para las GitHub Apps
+title: Identifying and authorizing users for GitHub Apps
 intro: '{% data reusables.shortdesc.identifying_and_authorizing_github_apps %}'
 redirect_from:
   - /early-access/integrations/user-identification-authorization/
@@ -13,80 +13,80 @@ versions:
 
 {% data reusables.pre-release-program.expiring-user-access-tokens-beta %}
 
-Cuando tu GitHub App actúe en nombre de un usuario, ésta realiza solicitudes de usuario a servidor. Estas solicitudes deben autorizarse con un token de acceso de usuario. Las solicitudes de usuario a servidor incluyen el solicitar datos para un usuario, como el determinar qué repositorios mostrar a un usuario en particular. Estas solicitudes también incluyen las acciones que activa un usuario, como ejecutar una compilación.
+When your GitHub App acts on behalf of a user, it performs user-to-server requests. These requests must be authorized with a user's access token. User-to-server requests include requesting data for a user, like determining which repositories to display to a particular user. These requests also include actions triggered by a user, like running a build.
 
 {% data reusables.apps.expiring_user_authorization_tokens %}
 
-### Identificar usuarios en tu sitio
+### Identifying users on your site
 
-Para autorizar a los usuarios para las apps estándar que se ejecutan en el buscador, utiliza el [flujo de aplicaciones web](#web-application-flow).
+To authorize users for standard apps that run in the browser, use the [web application flow](#web-application-flow).
 
 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}
-Para autorizar a los usuarios para apps sin interfaz gráfica sin acceso directo al buscador, tales como las herramientas de CLI o administradores de credenciales de Git, utiliza el [flujo del dispositivo](#device-flow). El flujo de dispositivos utiliza el [Otorgamiento de Autorizción de Dispositivos](https://tools.ietf.org/html/rfc8628) de OAuth 2.0.
+To authorize users for headless apps without direct access to the browser, such as CLI tools or Git credential managers, use the [device flow](#device-flow). The device flow uses the OAuth 2.0 [Device Authorization Grant](https://tools.ietf.org/html/rfc8628).
 {% endif %}
 
-### Flujo de aplicaciones Web
+### Web application flow
 
-Al utilizar el flujo de aplicaciones web, el proceso para identificar a los usuarios en tu sitio es:
+Using the web application flow, the process to identify users on your site is:
 
-1. Se redirecciona a los usuarios para solicitar su identidad de GitHub
-2. GitHub redirecciona a los usuarios de vuelta a tu sitio
-3. Tu GitHub App accede a la API con el token de acceso del usuario
+1. Users are redirected to request their GitHub identity
+2. Users are redirected back to your site by GitHub
+3. Your GitHub App accesses the API with the user's access token
 
-Si seleccionas **Solicitar la autorización del usuario (OAuth) durante la instalación** cuando crees o modifiques tu app, el paso 1 se completará durante la instalación de la misma. Para obtener más información, consulta la sección "[Autorizar usuarios durante la instalación](/apps/installing-github-apps/#authorizing-users-during-installation)".
+If you select **Request user authorization (OAuth) during installation** when creating or modifying your app, step 1 will be completed during app installation. For more information, see "[Authorizing users during installation](/apps/installing-github-apps/#authorizing-users-during-installation)."
 
-#### 1. Solicita la identidad de un usuario de GitHub
+#### 1. Request a user's GitHub identity
 
     GET {% data variables.product.oauth_host_code %}/login/oauth/authorize
 
-Cuando tu GitHub App especifica un parámetro de `login`, solicita a los usuarios con una cuenta específica que pueden utilizar para registrarse y autorizar tu app.
+When your GitHub App specifies a `login` parameter, it prompts users with a specific account they can use for signing in and authorizing your app.
 
-##### Parámetros
+##### Parameters
 
-| Nombre         | Tipo        | Descripción                                                                                                                                                                                                                                                                                              |
-| -------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `client_id`    | `secuencia` | **Requerido.** La ID de cliente para tu GitHub App. Puedes encontrarla en los [Ajustes de tu GitHub App](https://github.com/settings/apps) cuando selecciones tu app.                                                                                                                                    |
-| `redirect_uri` | `secuencia` | La URL en tu aplicación a donde se enviará a los usuarios después de la autorización.  Esta deberá ser una coincidencia exacta de la URL que proporcionaste en el campo **URL de rellamado para autorización del usuario** cuando configuraste tu GitHub App y no puede contener parámetros adicionales. |
-| `state`        | `secuencia` | Este deberá contener una secuencia aleatoria para dar protección contra los ataques de falsificación y podría contener cualquier otros datos arbitrarios.                                                                                                                                                |
-| `login`        | `secuencia` | Sugiere una cuenta específica para utilizar para registrarse y autorizar la app.                                                                                                                                                                                                                         |
+Name | Type | Description
+-----|------|------------
+`client_id` | `string` | **Required.** The client ID for your GitHub App. You can find this in your [GitHub App settings](https://github.com/settings/apps) when you select your app.
+`redirect_uri` | `string` | The URL in your application where users will be sent after authorization.  This must be an exact match to the URL you provided in the **User authorization callback URL** field when setting up your GitHub App and can't contain any additional parameters.
+`state` | `string` | This should contain a random string to protect against forgery attacks and could contain any other arbitrary data.
+`login` | `string` | Suggests a specific account to use for signing in and authorizing the app.
 
 {% note %}
 
-**Nota:** No necesitas proporcionar alcances en tu solicitud de autorización. A diferencia de la OAuth trandicional, el token de autorizción se limita a los permisos asociados con tu GitHub App y a aquellos del usuario.
+**Note:** You don't need to provide scopes in your authorization request. Unlike traditional OAuth, the authorization token is limited to the permissions associated with your GitHub App and those of the user.
 
 {% endnote %}
 
-#### 2. GitHub redirecciona a los usuarios de vuelta a tu sitio
+#### 2. Users are redirected back to your site by GitHub
 
-Si el usuario acepta tu solicitud, GitHub te redirecciona de regreso a tu sitio con un `code` temporal en un parámetro de código así como con el estado que proporcionaste en el paso anterior en el parámetro `state`. Si los estados no coinciden significa que un tercero creó la solicitud y que se debe anular el proceso.
+If the user accepts your request, GitHub redirects back to your site with a temporary `code` in a code parameter as well as the state you provided in the previous step in a `state` parameter. If the states don't match, the request was created by a third party and the process should be aborted.
 
 {% note %}
 
-**Nota:** Si seleccionas **Solicitar la autorización del usuario (OAuth) durante la instalación ** cuando creas o modificas tu app, GitHub regreará un `code` temporal que necesitarás intercambiar por un token de acceso. El parámetro `state` no se regresa cuando GitHub inicia el flujo de OAuth durante la instalación de la app.
+**Note:** If you select **Request user authorization (OAuth) during installation** when creating or modifying your app, GitHub returns a temporary `code` that you will need to exchange for an access token. The `state` parameter is not returned when GitHub initiates the OAuth flow during app installation.
 
 {% endnote %}
 
-Intercambia este `code` por un token de acceso. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} Cuando se habilita la caducidad de los tokens, el token de acceso caduca en 8 horas y el token de actualización en 6. Cada que actualizas el token, obtienes un nuevo token de actualización. Para obtener más información, consulta la sección "[Actualizar los tokens de acceso de usuario a servidor](/apps/building-github-apps/refreshing-user-to-server-access-tokens/)".
+Exchange this `code` for an access token. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} When expiring tokens are enabled, the access token expires in 8 hours and the refresh token expires in 6 months. Every time you refresh the token, you get a new refresh token. For more information, see "[Refreshing user-to-server access tokens](/apps/building-github-apps/refreshing-user-to-server-access-tokens/)."
 
-Los tokens de usuario con caducidad son parte del beta de caducidad de tokens de usuario a servidor actualmente y están sujetos a cambios. Para participar en la característica beta de tokens de usuario a servidor con caducidad, consulta la sección "[Activar las características beta para las aplicaciones](/developers/apps/activating-beta-features-for-apps)".{% endif %}
+Expiring user tokens are currently part of the user-to-server token expiration beta and subject to change. To opt-in to the user-to-server token expiration beta feature, see "[Activating beta features for apps](/developers/apps/activating-beta-features-for-apps)."{% endif %}
 
     POST {% data variables.product.oauth_host_code %}/login/oauth/access_token
 
-##### Parámetros
+##### Parameters
 
-| Nombre          | Tipo        | Descripción                                                                                |
-| --------------- | ----------- | ------------------------------------------------------------------------------------------ |
-| `client_id`     | `secuencia` | **Requerido.** La ID de cliente para tu GitHub App.                                        |
-| `client_secret` | `secuencia` | **Requerido.** El secreto de cliente para tu GitHub App.                                   |
-| `código`        | `secuencia` | **Requerido.** El código que recibiste como respuesta al Paso 1.                           |
-| `redirect_uri`  | `secuencia` | La URL en tu aplicación, hacia la cual se envía a los usuarios después de su autorización. |
-| `state`         | `secuencia` | La secuencia aleatoria indescifrable que proporcionaste en el Paso 1.                      |
+Name | Type | Description
+-----|------|------------
+`client_id` | `string` | **Required.** The  client ID for your GitHub App.
+`client_secret` | `string`   | **Required.** The  client secret for your GitHub App.
+`code` | `string`   | **Required.** The code you received as a response to Step 1.
+`redirect_uri` | `string` | The URL in your application where users are sent after authorization.
+`state` | `string` | The unguessable random string you provided in Step 1.
 
-##### Respuesta
+##### Response
 
 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}
 
-Predeterminadamente, la respuesta toma la siguiente forma. Los parámetros de respuesta `expires_in`, `refresh_token`,  y `refresh_token_expires_in`  solo se devuelven cuando habilitas el beta para la caducidad de los tokens de acceso de usuario a servidor.
+By default, the response takes the following form. The response parameters `expires_in`, `refresh_token`,  and `refresh_token_expires_in` are only returned when you enable the beta for expiring user-to-server access tokens.
 
 ```
 {
@@ -100,832 +100,829 @@ Predeterminadamente, la respuesta toma la siguiente forma. Los parámetros de re
 ```
 {% else %}
 
-Predeterminadamente, la respuesta toma la siguiente forma:
+By default, the response takes the following form:
 
     access_token=e72e16c7e42f292c6912e7710c838347ae178b4a&token_type=bearer
 
 {% endif %}
 
-#### 3. Tu GitHub App accede a la API con el token de acceso del usuario
+#### 3. Your GitHub App accesses the API with the user's access token
 
-El token de acceso del usuario permite que la GitHub App haga solicitudes a la API a nombre del usuario.
+The user's access token allows the GitHub App to make requests to the API on behalf of a user.
 
     Authorization: token OAUTH-TOKEN
     GET {% data variables.product.api_url_code %}/user
 
-Por ejemplo, en curl, puedes configurar el encabezado de autorización de la siguiente manera:
+For example, in curl you can set the Authorization header like this:
 
 ```shell
 curl -H "Authorization: token OAUTH-TOKEN" {% data variables.product.api_url_pre %}/user
 ```
 
 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}
-### Flujo de dispositivos
+### Device flow
 
 {% note %}
 
-**Nota:** El flujo de dispositivos se encuentra en beta público y está sujeto a cambios.{% if currentVersion == "free-pro-team@latest" %} Para habilitar esta característica beta, consulta la sección "[Activar las características beta para las apps](/developers/apps/activating-beta-features-for-apps)".{% endif %}
+**Note:** The device flow is in public beta and subject to change.{% if currentVersion == "free-pro-team@latest" %} To enable this beta feature, see "[Activating beta features for apps](/developers/apps/activating-beta-features-for-apps)."{% endif %}
 
 {% endnote %}
 
-Este flujo de dispositivos te permite autorizar usuarios para una app sin encabezado, tal como una herramienta de CLI o un administrador de credenciales de Git.
+The device flow allows you to authorize users for a headless app, such as a CLI tool or Git credential manager.
 
-Para obtener más información acerca de autorizar a usuarios utilizando el flujo de dispositivos, consulta la sección "[Autorizar Apps de OAuth](/developers/apps/authorizing-oauth-apps#device-flow)".
+For more information about authorizing users using the device flow, see "[Authorizing OAuth Apps](/developers/apps/authorizing-oauth-apps#device-flow)".
 
 {% endif %}
 
-### Revisar a qué recursos de instalación puede acceder un usuario
+### Check which installation's resources a user can access
 
 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %}
 {% data reusables.pre-release-program.machine-man-preview %}
 {% data reusables.pre-release-program.api-preview-warning %}
 {% endif %}
 
-Ya que tengas un token de OAuth para un usuario, puedes revisar a qué instalaciones puede acceder.
+Once you have an OAuth token for a user, you can check which installations that user can access.
 
     Authorization: token OAUTH-TOKEN
     GET /user/installations
 
-También puedes verificar qué repositorios se encuentran accesibles para un usuario para una instalación.
+You can also check which repositories are accessible to a user for an installation.
 
     Authorization: token OAUTH-TOKEN
     GET /user/installations/:installation_id/repositories
 
-Puedes encontrar más detalles en: [Listar instalaciones de app accesibles para el token de acceso del usuario](/v3/apps/installations/#list-app-installations-accessible-to-the-user-access-token) y [Listar repositorios accesibles para el token de acceso del usuario](/v3/apps/installations/#list-repositories-accessible-to-the-user-access-token).
+More details can be found in: [List app installations accessible to the user access token](/v3/apps/installations/#list-app-installations-accessible-to-the-user-access-token) and [List repositories accessible to the user access token](/v3/apps/installations/#list-repositories-accessible-to-the-user-access-token).
 
-### Gestionar una autorización revocada a una GitHub App
+### Handling a revoked GitHub App authorization
 
-Si un usuario revoca su autorización de una GitHub App, dicha app recibirá el webhook [`github_app_authorization`](/webhooks/event-payloads/#github_app_authorization) predeterminadamente. Las GitHub Apps no pueden desuscribirse de este evento. {% data reusables.webhooks.authorization_event %}
+If a user revokes their authorization of a GitHub App, the app will receive the [`github_app_authorization`](/webhooks/event-payloads/#github_app_authorization) webhook by default. GitHub Apps cannot unsubscribe from this event. {% data reusables.webhooks.authorization_event %}
 
-### Permisos a nivel de usuario
+### User-level permissions
 
-Puedes agregar permisos a nivel de usuario a tu GitHub App para acceder a los recursos del usuario, tales como correos electrónicos del usuario, los cuales otorgan los usuarios independientes como parte del [flujo de autorización del usuario](#identifying-users-on-your-site). Los permisos a nivel de usuario difieren de los [permisos a nivel de organización y de repositorio](/v3/apps/permissions/), los cuales se otorgan en el momento de la instalación en una cuenta de usuario o de organización.
+You can add user-level permissions to your GitHub App to access user resources, such as user emails, that are granted by individual users as part of the [user authorization flow](#identifying-users-on-your-site). User-level permissions differ from [repository and organization-level permissions](/v3/apps/permissions/), which are granted at the time of installation on an organization or user account.
 
-Puedes seleccionar los permisos a nivel de usuario desde dentro de la configuración de tu GitHub App en la sección de **Permisos de usuario** de la página de **Permisos & webhooks**. Para obtener más información sobre seleccionar permisos, consulta la sección [Editar los permisos de una GitHub App](/apps/managing-github-apps/editing-a-github-app-s-permissions/)".
+You can select user-level permissions from within your GitHub App's settings in the **User permissions** section of the **Permissions & webhooks** page. For more information on selecting permissions, see "[Editing a GitHub App's permissions](/apps/managing-github-apps/editing-a-github-app-s-permissions/)."
 
-Cuando un usuario instala tu app en su cuenta, el aviso de instalación listará los permisos a nivel de usuario que tu app está solicitando y explicará que la app puede pedir estos permisos a los usuarios independientes.
+When a user installs your app on their account, the installation prompt will list the user-level permissions your app is requesting and explain that the app can ask individual users for these permissions.
 
-Ya que los permisos a nivel de usuario se otorgan individualmente, puedes agregarlos a tu app existente sin solicitar que los usuarios los mejoren. Sin embargo, necesitarás enviar usuarios existentes a través del flujo de autorización de usuarios para autorizar los permisos nuevos y obtener un token nuevo de usuario a servidor para estas solicitudes.
+Because user-level permissions are granted on an individual user basis, you can add them to your existing app without prompting users to upgrade. You will, however, need to send existing users through the user authorization flow to authorize the new permission and get a new user-to-server token for these requests.
 
-### Solicitudes de usuario a servidor
+### User-to-server requests
 
-Mientras que la mayoría de tu interacción con la API deberá darse utilizando tus tokens de acceso a la instalación de servidor a servidor, ciertas terminales te permiten llevar a cabo acciones a través de la API utilizando un token de acceso. Tu app puede hacer las siguientes solicitudes utilizando las terminales de [GraphQL v4](/v4/) o de [REST v3](/v3/).
+While most of your API interaction should occur using your server-to-server installation access tokens, certain endpoints allow you to perform actions via the API using a user access token. Your app can make the following requests using [GraphQL v4](/v4/) or [REST v3](/v3/) endpoints.
 
-#### Terminales compatibles
+#### Supported endpoints
 
 {% if currentVersion == "free-pro-team@latest" %}
-##### Ejecutores de Acciones
-
-* [Listar aplicaciones de ejecutores para un repositorio](/v3/actions/self-hosted-runners/#list-runner-applications-for-a-repository)
-* [Listar ejecutores auto-hospedados para un repositorio](/v3/actions/self-hosted-runners/#list-self-hosted-runners-for-a-repository)
-* [Obtener un ejecutor auto-hospedado para un repositorio](/v3/actions/self-hosted-runners/#get-a-self-hosted-runner-for-a-repository)
-* [Borrar un ejecutor auto-hospedado de un repositorio](/v3/actions/self-hosted-runners/#delete-a-self-hosted-runner-from-a-repository)
-* [Crear un token de registro para un repositorio](/v3/actions/self-hosted-runners/#create-a-registration-token-for-a-repository)
-* [Crear un token de eliminación para un repositorio](/v3/actions/self-hosted-runners/#create-a-remove-token-for-a-repository)
-* [Listar aplicaciones de ejecutores para una organización](/v3/actions/self-hosted-runners/#list-runner-applications-for-an-organization)
-* [Listar ejecutores auto-hospedados para una organización](/v3/actions/self-hosted-runners/#list-self-hosted-runners-for-an-organization)
-* [Obtener ejecutores auto-hospedados para una organización](/v3/actions/self-hosted-runners/#get-a-self-hosted-runner-for-an-organization)
-* [Borrar un ejecutor auto-hospedado de una organización](/v3/actions/self-hosted-runners/#delete-a-self-hosted-runner-from-an-organization)
-* [Crear un token de registro para una organización](/v3/actions/self-hosted-runners/#create-a-registration-token-for-an-organization)
-* [Crear un token de eliminación para una organización](/v3/actions/self-hosted-runners/#create-a-remove-token-for-an-organization)
-
-##### Secretos de las Acciones
-
-* [Obtener la llave pública de un repositorio](/v3/actions/secrets/#get-a-repository-public-key)
-* [Listar los secretos del repositorio](/v3/actions/secrets/#list-repository-secrets)
-* [Obtener el secreto de un repositorio](/v3/actions/secrets/#get-a-repository-secret)
-* [Crear o actualizar el secreto de un repositorio](/v3/actions/secrets/#create-or-update-a-repository-secret)
-* [Borrar el secreto de un repositorio](/v3/actions/secrets/#delete-a-repository-secret)
-* [Obtener la llave pública de una organización](/v3/actions/secrets/#get-an-organization-public-key)
-* [Listar los secretos de la organización](/v3/actions/secrets/#list-organization-secrets)
-* [Obtener el secreto de una organización](/v3/actions/secrets/#get-an-organization-secret)
-* [Crear o actualizar el secreto de una organización](/v3/actions/secrets/#create-or-update-an-organization-secret)
-* [Listar los repositorios seleccionados para el secreto de una organización](/v3/actions/secrets/#list-selected-repositories-for-an-organization-secret)
-* [Configurar los repositorios seleccionados para el secreto de una organización](/v3/actions/secrets/#set-selected-repositories-for-an-organization-secret)
-* [Agregar el repositorio seleccionado al secreto de una organización](/v3/actions/secrets/#add-selected-repository-to-an-organization-secret)
-* [Eliminar el repositorio seleccionado del secreto de una organización](/v3/actions/secrets/#remove-selected-repository-from-an-organization-secret)
-* [Borrar el secreto de una organización](/v3/actions/secrets/#delete-an-organization-secret)
+##### Actions Runners
+
+* [List runner applications for a repository](/v3/actions/self-hosted-runners/#list-runner-applications-for-a-repository)
+* [List self-hosted runners for a repository](/v3/actions/self-hosted-runners/#list-self-hosted-runners-for-a-repository)
+* [Get a self-hosted runner for a repository](/v3/actions/self-hosted-runners/#get-a-self-hosted-runner-for-a-repository)
+* [Delete a self-hosted runner from a repository](/v3/actions/self-hosted-runners/#delete-a-self-hosted-runner-from-a-repository)
+* [Create a registration token for a repository](/v3/actions/self-hosted-runners/#create-a-registration-token-for-a-repository)
+* [Create a remove token for a repository](/v3/actions/self-hosted-runners/#create-a-remove-token-for-a-repository)
+* [List runner applications for an organization](/v3/actions/self-hosted-runners/#list-runner-applications-for-an-organization)
+* [List self-hosted runners for an organization](/v3/actions/self-hosted-runners/#list-self-hosted-runners-for-an-organization)
+* [Get a self-hosted runner for an organization](/v3/actions/self-hosted-runners/#get-a-self-hosted-runner-for-an-organization)
+* [Delete a self-hosted runner from an organization](/v3/actions/self-hosted-runners/#delete-a-self-hosted-runner-from-an-organization)
+* [Create a registration token for an organization](/v3/actions/self-hosted-runners/#create-a-registration-token-for-an-organization)
+* [Create a remove token for an organization](/v3/actions/self-hosted-runners/#create-a-remove-token-for-an-organization)
+
+##### Actions Secrets
+
+* [Get a repository public key](/v3/actions/secrets/#get-a-repository-public-key)
+* [List repository secrets](/v3/actions/secrets/#list-repository-secrets)
+* [Get a repository secret](/v3/actions/secrets/#get-a-repository-secret)
+* [Create or update a repository secret](/v3/actions/secrets/#create-or-update-a-repository-secret)
+* [Delete a repository secret](/v3/actions/secrets/#delete-a-repository-secret)
+* [Get an organization public key](/v3/actions/secrets/#get-an-organization-public-key)
+* [List organization secrets](/v3/actions/secrets/#list-organization-secrets)
+* [Get an organization secret](/v3/actions/secrets/#get-an-organization-secret)
+* [Create or update an organization secret](/v3/actions/secrets/#create-or-update-an-organization-secret)
+* [List selected repositories for an organization secret](/v3/actions/secrets/#list-selected-repositories-for-an-organization-secret)
+* [Set selected repositories for an organization secret](/v3/actions/secrets/#set-selected-repositories-for-an-organization-secret)
+* [Add selected repository to an organization secret](/v3/actions/secrets/#add-selected-repository-to-an-organization-secret)
+* [Remove selected repository from an organization secret](/v3/actions/secrets/#remove-selected-repository-from-an-organization-secret)
+* [Delete an organization secret](/v3/actions/secrets/#delete-an-organization-secret)
 {% endif %}
 
 {% if currentVersion == "free-pro-team@latest" %}
-##### Artefactos
+##### Artifacts
 
-* [Listar artefactos para un repositorio](/v3/actions/artifacts/#list-artifacts-for-a-repository)
-* [Listar artefactos de ejecución de flujo de trabajo](/v3/actions/artifacts/#list-workflow-run-artifacts)
-* [Obtener un artefacto](/v3/actions/artifacts/#get-an-artifact)
-* [Borrar un artefacto](/v3/actions/artifacts/#delete-an-artifact)
-* [Descargar un artefacto](/v3/actions/artifacts/#download-an-artifact)
+* [List artifacts for a repository](/v3/actions/artifacts/#list-artifacts-for-a-repository)
+* [List workflow run artifacts](/v3/actions/artifacts/#list-workflow-run-artifacts)
+* [Get an artifact](/v3/actions/artifacts/#get-an-artifact)
+* [Delete an artifact](/v3/actions/artifacts/#delete-an-artifact)
+* [Download an artifact](/v3/actions/artifacts/#download-an-artifact)
 {% endif %}
 
-##### Ejecuciones de Verificación
+##### Check Runs
 
-* [Crear una ejecución de verificación](/v3/checks/runs/#create-a-check-run)
-* [Obtener una ejecución de verificación](/v3/checks/runs/#get-a-check-run)
-* [Actualizar una ejecución de verificación](/v3/checks/runs/#update-a-check-run)
-* [Listar las anotaciones de una ejecución de verificación](/v3/checks/runs/#list-check-run-annotations)
-* [Listar las ejecuciones de verificación en un conjunto de verificaciones](/v3/checks/runs/#list-check-runs-in-a-check-suite)
-* [Listar las ejecuciones de verificación para una referencia de Git](/v3/checks/runs/#list-check-runs-for-a-git-reference)
+* [Create a check run](/v3/checks/runs/#create-a-check-run)
+* [Get a check run](/v3/checks/runs/#get-a-check-run)
+* [Update a check run](/v3/checks/runs/#update-a-check-run)
+* [List check run annotations](/v3/checks/runs/#list-check-run-annotations)
+* [List check runs in a check suite](/v3/checks/runs/#list-check-runs-in-a-check-suite)
+* [List check runs for a Git reference](/v3/checks/runs/#list-check-runs-for-a-git-reference)
 
-##### Comprobar Suites
+##### Check Suites
 
-* [Crear un conjunto de verificaciones](/v3/checks/suites/#create-a-check-suite)
-* [Obtener un conjunto de verificaciones](/v3/checks/suites/#get-a-check-suite)
-* [Solicitar un conjunto de verificaciones](/v3/checks/suites/#rerequest-a-check-suite)
-* [Actualizar las preferencias del repositorio para los conjuntos de verificaciones](/v3/checks/suites/#update-repository-preferences-for-check-suites)
-* [Listar conjuntos de verificaciones para una referencia de Git](/v3/checks/suites/#list-check-suites-for-a-git-reference)
+* [Create a check suite](/v3/checks/suites/#create-a-check-suite)
+* [Get a check suite](/v3/checks/suites/#get-a-check-suite)
+* [Rerequest a check suite](/v3/checks/suites/#rerequest-a-check-suite)
+* [Update repository preferences for check suites](/v3/checks/suites/#update-repository-preferences-for-check-suites)
+* [List check suites for a Git reference](/v3/checks/suites/#list-check-suites-for-a-git-reference)
 
-##### Códigos de Conducta
+##### Codes Of Conduct
 
-* [Obtener todos los códigos de conducta](/v3/codes_of_conduct/#get-all-codes-of-conduct)
-* [Obtener un código de conducta específico](/v3/codes_of_conduct/#get-a-code-of-conduct)
+* [Get all codes of conduct](/v3/codes_of_conduct/#get-all-codes-of-conduct)
+* [Get a code of conduct](/v3/codes_of_conduct/#get-a-code-of-conduct)
 
-##### Estados de Despliegue
+##### Deployment Statuses
 
-* [Listar los estados de despliegue](/v3/repos/deployments/#list-deployment-statuses)
-* [Crear los estados de despliegue](/v3/repos/deployments/#create-a-deployment-status)
-* [Obtener un estado de despliegue](/v3/repos/deployments/#get-a-deployment-status)
+* [List deployment statuses](/rest/reference/repos#list-deployment-statuses)
+* [Create a deployment status](/rest/reference/repos#create-a-deployment-status)
+* [Get a deployment status](/rest/reference/repos#get-a-deployment-status)
 
-##### Implementaciones
+##### Deployments
 
-* [Listar los despliegues](/v3/repos/deployments/#list-deployments)
-* [Crear un despliegue](/v3/repos/deployments/#create-a-deployment)
-* [Obtener un despliegue](/v3/repos/deployments/#get-a-deployment){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}
-* [Borrar un despliegue](/v3/repos/deployments/#delete-a-deployment){% endif %}
+* [List deployments](/rest/reference/repos#list-deployments)
+* [Create a deployment](/rest/reference/repos#create-a-deployment)
+* [Get a deployment](/rest/reference/repos#get-a-deployment){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}
+* [Delete a deployment](/rest/reference/repos#delete-a-deployment){% endif %}
 
-##### Eventos
+##### Events
 
-* [Listar eventos públicos para una red de repositorios](/v3/activity/events/#list-public-events-for-a-network-of-repositories)
-* [Listar eventos de organizaciones públicas](/v3/activity/events/#list-public-organization-events)
+* [List public events for a network of repositories](/rest/reference/activity#list-public-events-for-a-network-of-repositories)
+* [List public organization events](/rest/reference/activity#list-public-organization-events)
 
-##### Fuentes
+##### Feeds
 
-* [Obtener fuentes](/v3/activity/feeds/#get-feeds)
+* [Get feeds](/rest/reference/activity#get-feeds)
 
-##### Blobs de Git
+##### Git Blobs
 
-* [Crear un blob](/v3/git/blobs/#create-a-blob)
-* [Obtener un blob](/v3/git/blobs/#get-a-blob)
+* [Create a blob](/v3/git/blobs/#create-a-blob)
+* [Get a blob](/v3/git/blobs/#get-a-blob)
 
-##### Confirmaciones de Git
+##### Git Commits
 
-* [Crear una confirmación](/v3/git/commits/#create-a-commit)
-* [Obtener una confirmación](/v3/git/commits/#get-a-commit)
+* [Create a commit](/v3/git/commits/#create-a-commit)
+* [Get a commit](/v3/git/commits/#get-a-commit)
 
-##### Referencias de Git
+##### Git Refs
 
-* [Crear una referencia](/v3/git/refs/#create-a-reference){% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}
-* [Listar referencias](/v3/git/refs/#list-references)
-* [Obtener una referencia](/v3/git/refs/#get-a-reference){% else %}
-* [Obtener una referencia](/v3/git/refs/#get-a-reference)
-* [Listar referencias coincidentes](/v3/git/refs/#list-matching-references){% endif %}
-* [Actualizar una referencia](/v3/git/refs/#update-a-reference)
-* [Borrar una referencia](/v3/git/refs/#delete-a-reference)
+* [Create a reference](/v3/git/refs/#create-a-reference)* [Get a reference](/v3/git/refs/#get-a-reference)
+* [List matching references](/v3/git/refs/#list-matching-references)
+* [Update a reference](/v3/git/refs/#update-a-reference)
+* [Delete a reference](/v3/git/refs/#delete-a-reference)
 
-##### Matrículas de Git
+##### Git Tags
 
-* [Crear un objeto de matrícula](/v3/git/tags/#create-a-tag-object)
-* [Obtener una matrícula](/v3/git/tags/#get-a-tag)
+* [Create a tag object](/v3/git/tags/#create-a-tag-object)
+* [Get a tag](/v3/git/tags/#get-a-tag)
 
-##### Árboles de Git
+##### Git Trees
 
-* [Crear un árbol](/v3/git/trees/#create-a-tree)
-* [Obtener un árbol](/v3/git/trees/#get-a-tree)
+* [Create a tree](/v3/git/trees/#create-a-tree)
+* [Get a tree](/v3/git/trees/#get-a-tree)
 
-##### Plantillas de Gitignore
+##### Gitignore Templates
 
-* [Obtener todas las plantillas de gitignore](/v3/gitignore/#get-all-gitignore-templates)
-* [Obtener una plantilla específica de gitignore](/v3/gitignore/#get-a-gitignore-template)
+* [Get all gitignore templates](/v3/gitignore/#get-all-gitignore-templates)
+* [Get a gitignore template](/v3/gitignore/#get-a-gitignore-template)
 
-##### Instalaciones
+##### Installations
 
-* [Listar repositorios accesibles para el token de acceso del usuario](/v3/apps/installations/#list-repositories-accessible-to-the-user-access-token)
+* [List repositories accessible to the user access token](/v3/apps/installations/#list-repositories-accessible-to-the-user-access-token)
 
 {% if currentVersion == "free-pro-team@latest" %}
-##### Límites de interacción
-
-* [Obtener restricciones de interacción para una organización](/v3/interactions/orgs/#get-interaction-restrictions-for-an-organization)
-* [Configurar restricciones de interacción para una organización](/v3/interactions/orgs/#set-interaction-restrictions-for-an-organization)
-* [Eliminar restricciones de interacción para una organización](/v3/interactions/orgs/#remove-interaction-restrictions-for-an-organization)
-* [Obtener restricciones de interacción para un repositorio](/v3/interactions/repos/#get-interaction-restrictions-for-a-repository)
-* [Configurar restricciones de interacción para un repositorio](/v3/interactions/repos/#set-interaction-restrictions-for-a-repository)
-* [Eliminar restricciones de interacción para un repositorio](/v3/interactions/repos/#remove-interaction-restrictions-for-a-repository)
+##### Interaction Limits
+
+* [Get interaction restrictions for an organization](/v3/interactions/orgs/#get-interaction-restrictions-for-an-organization)
+* [Set interaction restrictions for an organization](/v3/interactions/orgs/#set-interaction-restrictions-for-an-organization)
+* [Remove interaction restrictions for an organization](/v3/interactions/orgs/#remove-interaction-restrictions-for-an-organization)
+* [Get interaction restrictions for a repository](/v3/interactions/repos/#get-interaction-restrictions-for-a-repository)
+* [Set interaction restrictions for a repository](/v3/interactions/repos/#set-interaction-restrictions-for-a-repository)
+* [Remove interaction restrictions for a repository](/v3/interactions/repos/#remove-interaction-restrictions-for-a-repository)
 {% endif %}
 
-##### Asignados de Informes de Problemas
+##### Issue Assignees
 
-* [Agregar asignados a un informe de problemas](/v3/issues/assignees/#add-assignees-to-an-issue)
-* [Eliminar asignados de un informe de problemas](/v3/issues/assignees/#remove-assignees-from-an-issue)
+* [Add assignees to an issue](/v3/issues/assignees/#add-assignees-to-an-issue)
+* [Remove assignees from an issue](/v3/issues/assignees/#remove-assignees-from-an-issue)
 
-##### Comentarios de Informes de Problemas
+##### Issue Comments
 
-* [Listar comentarios del informe de problemas](/v3/issues/comments/#list-issue-comments)
-* [Crear un comentario del informe de problemas](/v3/issues/comments/#create-an-issue-comment)
-* [Listar cometnarios del informe de problemas para un repositorio](/v3/issues/comments/#list-issue-comments-for-a-repository)
-* [Obtener un comentario de un informe de problemas](/v3/issues/comments/#get-an-issue-comment)
-* [Actualizar un comentario de un informe de problemas](/v3/issues/comments/#update-an-issue-comment)
-* [Borrar un comentario de un informe de problemas](/v3/issues/comments/#delete-an-issue-comment)
+* [List issue comments](/v3/issues/comments/#list-issue-comments)
+* [Create an issue comment](/v3/issues/comments/#create-an-issue-comment)
+* [List issue comments for a repository](/v3/issues/comments/#list-issue-comments-for-a-repository)
+* [Get an issue comment](/v3/issues/comments/#get-an-issue-comment)
+* [Update an issue comment](/v3/issues/comments/#update-an-issue-comment)
+* [Delete an issue comment](/v3/issues/comments/#delete-an-issue-comment)
 
-##### Eventos de Informe de Problemas
+##### Issue Events
 
-* [Listar eventos del informe de problemas](/v3/issues/events/#list-issue-events)
+* [List issue events](/v3/issues/events/#list-issue-events)
 
-##### Línea de tiempo del Informe de Problemas
+##### Issue Timeline
 
-* [Listar eventos de la línea de tiempo para un informe de problemas](/v3/issues/timeline/#list-timeline-events-for-an-issue)
+* [List timeline events for an issue](/v3/issues/timeline/#list-timeline-events-for-an-issue)
 
-##### Problemas
+##### Issues
 
-* [Listar informes de problemas asignados al usuario autenticado](/v3/issues/#list-issues-assigned-to-the-authenticated-user)
-* [Listar asignados](/v3/issues/assignees/#list-assignees)
-* [Revisar si se puede asignar un usuario](/v3/issues/assignees/#check-if-a-user-can-be-assigned)
-* [Listar informes de problemas del repositorio](/v3/issues/#list-repository-issues)
-* [Crear un informe de problemas](/v3/issues/#create-an-issue)
-* [Obtener un informe de problemas](/v3/issues/#get-an-issue)
-* [Actualizar un informe de problemas](/v3/issues/#update-an-issue)
-* [Bloquear un informe de problemas](/v3/issues/#lock-an-issue)
-* [Desbloquear un informe de problemas](/v3/issues/#unlock-an-issue)
+* [List issues assigned to the authenticated user](/v3/issues/#list-issues-assigned-to-the-authenticated-user)
+* [List assignees](/v3/issues/assignees/#list-assignees)
+* [Check if a user can be assigned](/v3/issues/assignees/#check-if-a-user-can-be-assigned)
+* [List repository issues](/v3/issues/#list-repository-issues)
+* [Create an issue](/v3/issues/#create-an-issue)
+* [Get an issue](/v3/issues/#get-an-issue)
+* [Update an issue](/v3/issues/#update-an-issue)
+* [Lock an issue](/v3/issues/#lock-an-issue)
+* [Unlock an issue](/v3/issues/#unlock-an-issue)
 
 {% if currentVersion == "free-pro-team@latest" %}
 ##### Jobs
 
-* [Obener un job para una ejecución de flujo de trabajo](/v3/actions/workflow-jobs/#get-a-job-for-a-workflow-run)
-* [Descargar bitácoras del job para una ejecución de flujode trabajo](/v3/actions/workflow-jobs/#download-job-logs-for-a-workflow-run)
-* [Listar jobs para una ejecución de flujo de trabajo](/v3/actions/workflow-jobs/#list-jobs-for-a-workflow-run)
+* [Get a job for a workflow run](/v3/actions/workflow-jobs/#get-a-job-for-a-workflow-run)
+* [Download job logs for a workflow run](/v3/actions/workflow-jobs/#download-job-logs-for-a-workflow-run)
+* [List jobs for a workflow run](/v3/actions/workflow-jobs/#list-jobs-for-a-workflow-run)
 {% endif %}
 
-##### Etiquetas
+##### Labels
 
-* [Listar las etiquetas para un informe de problemas](/v3/issues/labels/#list-labels-for-an-issue)
-* [Agregar etiquetas a un informe de problemas](/v3/issues/labels/#add-labels-to-an-issue)
-* [Configurar eitquetas para un informe de problemas](/v3/issues/labels/#set-labels-for-an-issue)
-* [Eliminar todas las etiquetas de un informe de problemas](/v3/issues/labels/#remove-all-labels-from-an-issue)
-* [Eliminar una etiqueta de un informe de problemas](/v3/issues/labels/#remove-a-label-from-an-issue)
-* [Listar etiquetas para un repositorio](/v3/issues/labels/#list-labels-for-a-repository)
-* [Crear una etiqueta](/v3/issues/labels/#create-a-label)
-* [Obtener una etiqueta](/v3/issues/labels/#get-a-label)
-* [Actualizar una etiqueta](/v3/issues/labels/#update-a-label)
-* [Borrar una etiqueta](/v3/issues/labels/#delete-a-label)
-* [Obtener etiquetas para cada informe de problemas en un hito](/v3/issues/labels/#list-labels-for-issues-in-a-milestone)
+* [List labels for an issue](/v3/issues/labels/#list-labels-for-an-issue)
+* [Add labels to an issue](/v3/issues/labels/#add-labels-to-an-issue)
+* [Set labels for an issue](/v3/issues/labels/#set-labels-for-an-issue)
+* [Remove all labels from an issue](/v3/issues/labels/#remove-all-labels-from-an-issue)
+* [Remove a label from an issue](/v3/issues/labels/#remove-a-label-from-an-issue)
+* [List labels for a repository](/v3/issues/labels/#list-labels-for-a-repository)
+* [Create a label](/v3/issues/labels/#create-a-label)
+* [Get a label](/v3/issues/labels/#get-a-label)
+* [Update a label](/v3/issues/labels/#update-a-label)
+* [Delete a label](/v3/issues/labels/#delete-a-label)
+* [Get labels for every issue in a milestone](/v3/issues/labels/#list-labels-for-issues-in-a-milestone)
 
-##### Licencias
+##### Licenses
 
-* [Obtener todas las licencias que se utilizan habitualmente](/v3/licenses/#get-all-commonly-used-licenses)
-* [Obtener una licencia](/v3/licenses/#get-a-license)
+* [Get all commonly used licenses](/v3/licenses/#get-all-commonly-used-licenses)
+* [Get a license](/v3/licenses/#get-a-license)
 
 ##### Markdown
 
-* [Generar un documento de Markdown](/v3/markdown/#render-a-markdown-document)
-* [Generar un documento de markdwon en modo raw](/v3/markdown/#render-a-markdown-document-in-raw-mode)
+* [Render a Markdown document](/v3/markdown/#render-a-markdown-document)
+* [Render a markdown document in raw mode](/v3/markdown/#render-a-markdown-document-in-raw-mode)
 
 ##### Meta
 
 * [Meta](/v3/meta/#meta)
 
-##### Hitos
+##### Milestones
 
-* [Listar hitos](/v3/issues/milestones/#list-milestones)
-* [Crear un hito](/v3/issues/milestones/#create-a-milestone)
-* [Obtener un hito](/v3/issues/milestones/#get-a-milestone)
-* [Actualizar un hito](/v3/issues/milestones/#update-a-milestone)
-* [Borrar un hito](/v3/issues/milestones/#delete-a-milestone)
+* [List milestones](/v3/issues/milestones/#list-milestones)
+* [Create a milestone](/v3/issues/milestones/#create-a-milestone)
+* [Get a milestone](/v3/issues/milestones/#get-a-milestone)
+* [Update a milestone](/v3/issues/milestones/#update-a-milestone)
+* [Delete a milestone](/v3/issues/milestones/#delete-a-milestone)
 
-##### Ganchos de organización
+##### Organization Hooks
 
-* [Listar los webhooks de la organización](/v3/orgs/hooks/#list-organization-webhooks)
-* [Crear un webhook para una organización](/v3/orgs/hooks/#create-an-organization-webhook)
-* [Obtener un webhook de una organización](/v3/orgs/hooks/#get-an-organization-webhook)
-* [Actualizar el webhook de una organización](/v3/orgs/hooks/#update-an-organization-webhook)
-* [Borrar el webhook de una organización](/v3/orgs/hooks/#delete-an-organization-webhook)
-* [Hacer ping al webhook de una organización](/v3/orgs/hooks/#ping-an-organization-webhook)
+* [List organization webhooks](/rest/reference/orgs#webhooks/#list-organization-webhooks)
+* [Create an organization webhook](/rest/reference/orgs#webhooks/#create-an-organization-webhook)
+* [Get an organization webhook](/rest/reference/orgs#webhooks/#get-an-organization-webhook)
+* [Update an organization webhook](/rest/reference/orgs#webhooks/#update-an-organization-webhook)
+* [Delete an organization webhook](/rest/reference/orgs#webhooks/#delete-an-organization-webhook)
+* [Ping an organization webhook](/rest/reference/orgs#webhooks/#ping-an-organization-webhook)
 
 {% if currentVersion == "free-pro-team@latest" %}
-##### Invitaciones a las Organizaciones
+##### Organization Invitations
 
-* [Listar las invitaciones pendientes a una organización](/v3/orgs/members/#list-pending-organization-invitations)
-* [Crear una invitación a una organización](/v3/orgs/members/#create-an-organization-invitation)
-* [Listar los equipos de invitación a una organización](/v3/orgs/members/#list-organization-invitation-teams)
+* [List pending organization invitations](/v3/orgs/members/#list-pending-organization-invitations)
+* [Create an organization invitation](/v3/orgs/members/#create-an-organization-invitation)
+* [List organization invitation teams](/v3/orgs/members/#list-organization-invitation-teams)
 {% endif %}
 
-##### Miembros de la Organización
+##### Organization Members
 
-* [Listar a los miembros de la organización](/v3/orgs/members/#list-organization-members)
-* [Verificar la membrecía de organización de un usuario](/v3/orgs/members/#check-organization-membership-for-a-user)
-* [Eliminar a un miembro de una organización](/v3/orgs/members/#remove-an-organization-member)
-* [Obtener la membrecía de organización para un usuario](/v3/orgs/members/#get-organization-membership-for-a-user)
-* [Configurar una mebrecía de organización para un usuario](/v3/orgs/members/#set-organization-membership-for-a-user)
-* [Eliminar la membrecía de organización de un usuario](/v3/orgs/members/#remove-organization-membership-for-a-user)
-* [Listar los miembros de una organización pública](/v3/orgs/members/#list-public-organization-members)
-* [Verificar la membrecía de una organización pública de un usuario](/v3/orgs/members/#check-public-organization-membership-for-a-user)
-* [Configurar la membrecía de una organización pública para el usuario autenticado](/v3/orgs/members/#set-public-organization-membership-for-the-authenticated-user)
-* [Eliminar la membrecía de una organizción pública del usuario autenticado](/v3/orgs/members/#remove-public-organization-membership-for-the-authenticated-user)
+* [List organization members](/v3/orgs/members/#list-organization-members)
+* [Check organization membership for a user](/v3/orgs/members/#check-organization-membership-for-a-user)
+* [Remove an organization member](/v3/orgs/members/#remove-an-organization-member)
+* [Get organization membership for a user](/v3/orgs/members/#get-organization-membership-for-a-user)
+* [Set organization membership for a user](/v3/orgs/members/#set-organization-membership-for-a-user)
+* [Remove organization membership for a user](/v3/orgs/members/#remove-organization-membership-for-a-user)
+* [List public organization members](/v3/orgs/members/#list-public-organization-members)
+* [Check public organization membership for a user](/v3/orgs/members/#check-public-organization-membership-for-a-user)
+* [Set public organization membership for the authenticated user](/v3/orgs/members/#set-public-organization-membership-for-the-authenticated-user)
+* [Remove public organization membership for the authenticated user](/v3/orgs/members/#remove-public-organization-membership-for-the-authenticated-user)
 
-##### Colaboradores Externos de una Organización
+##### Organization Outside Collaborators
 
-* [Listar los colaboradores externos de una organización](/v3/orgs/outside_collaborators/#list-outside-collaborators-for-an-organization)
-* [Convertir a un miembro de la organización en colaborador externo](/v3/orgs/outside_collaborators/#convert-an-organization-member-to-outside-collaborator)
-* [Eliminar a un colaborador externo de la organización](/v3/orgs/outside_collaborators/#remove-outside-collaborator-from-an-organization)
+* [List outside collaborators for an organization](/v3/orgs/outside_collaborators/#list-outside-collaborators-for-an-organization)
+* [Convert an organization member to outside collaborator](/v3/orgs/outside_collaborators/#convert-an-organization-member-to-outside-collaborator)
+* [Remove outside collaborator from an organization](/v3/orgs/outside_collaborators/#remove-outside-collaborator-from-an-organization)
 
 {% if currentVersion != "free-pro-team@latest" %}
-##### Ganchos de Pre-recepción de la Organización
+##### Organization Pre Receive Hooks
 
-* [Listar los ganchos de pre-recepción de una organización](/enterprise/user/rest/reference/enterprise-admin#list-pre-receive-hooks-for-an-organization)
-* [Obtener los ganchos de pre-recepción de una organización](/enterprise/user/rest/reference/enterprise-admin#get-a-pre-receive-hook-for-an-organization)
-* [Actualizar el requerir los ganchos de pre-recepción para una organización](/enterprise/user/rest/reference/enterprise-admin#update-pre-receive-hook-enforcement-for-an-organization)
-* [Eliminar el requerir los ganchos de pre-recepción para una organización](/enterprise/user/rest/reference/enterprise-admin#remove-pre-receive-hook-enforcement-for-an-organization)
+* [List pre-receive hooks for an organization](/enterprise/user/rest/reference/enterprise-admin#list-pre-receive-hooks-for-an-organization)
+* [Get a pre-receive hook for an organization](/enterprise/user/rest/reference/enterprise-admin#get-a-pre-receive-hook-for-an-organization)
+* [Update pre-receive hook enforcement for an organization](/enterprise/user/rest/reference/enterprise-admin#update-pre-receive-hook-enforcement-for-an-organization)
+* [Remove pre-receive hook enforcement for an organization](/enterprise/user/rest/reference/enterprise-admin#remove-pre-receive-hook-enforcement-for-an-organization)
 {% endif %}
 
 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}
-##### Poyectos de Equipo de una Organización
+##### Organization Team Projects
 
-* [Listar los proyectos de equipo](/v3/teams/#list-team-projects)
-* [Verificar los permisos del equipo para un proyecto](/v3/teams/#check-team-permissions-for-a-project)
-* [Agregar o actualizar los permisos de un proyecto de equipo](/v3/teams/#add-or-update-team-project-permissions)
-* [Eliminar a un proyecto de un equipo](/v3/teams/#remove-a-project-from-a-team)
+* [List team projects](/v3/teams/#list-team-projects)
+* [Check team permissions for a project](/v3/teams/#check-team-permissions-for-a-project)
+* [Add or update team project permissions](/v3/teams/#add-or-update-team-project-permissions)
+* [Remove a project from a team](/v3/teams/#remove-a-project-from-a-team)
 {% endif %}
 
-##### Repositorios de Equipo de la Organización
+##### Organization Team Repositories
 
-* [Listar los repositorios de equipo](/v3/teams/#list-team-repositories)
-* [Verificar los permisos de un equipo para un repositorio](/v3/teams/#check-team-permissions-for-a-repository)
-* [Agregar o actualizar los permisos de un repositorio de equipo](/v3/teams/#add-or-update-team-repository-permissions)
-* [Eliminar a un repositorio de un equipo](/v3/teams/#remove-a-repository-from-a-team)
+* [List team repositories](/v3/teams/#list-team-repositories)
+* [Check team permissions for a repository](/v3/teams/#check-team-permissions-for-a-repository)
+* [Add or update team repository permissions](/v3/teams/#add-or-update-team-repository-permissions)
+* [Remove a repository from a team](/v3/teams/#remove-a-repository-from-a-team)
 
 {% if currentVersion == "free-pro-team@latest" %}
-##### Sincronización de Equipos de la Organización
+##### Organization Team Sync
 
-* [Listar los grupos de IdP de un equipo](/v3/teams/team_sync/#list-idp-groups-for-a-team)
-* [Crear o actualizar las conexiones de un grupo de IdP](/v3/teams/team_sync/#create-or-update-idp-group-connections)
-* [Listar grupos de IdP para una organización](/v3/teams/team_sync/#list-idp-groups-for-an-organization)
+* [List idp groups for a team](/v3/teams/team_sync/#list-idp-groups-for-a-team)
+* [Create or update idp group connections](/v3/teams/team_sync/#create-or-update-idp-group-connections)
+* [List IdP groups for an organization](/v3/teams/team_sync/#list-idp-groups-for-an-organization)
 {% endif %}
 
-##### Equipos de la Organización
+##### Organization Teams
 
-* [Listar equipos](/v3/teams/#list-teams)
-* [Crear un equipo](/v3/teams/#create-a-team)
-* [Obtener un equipo por su nombre](/v3/teams/#get-a-team-by-name)
+* [List teams](/v3/teams/#list-teams)
+* [Create a team](/v3/teams/#create-a-team)
+* [Get a team by name](/v3/teams/#get-a-team-by-name)
 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.21" %}
-* [Obtener un equipo](/v3/teams/#get-a-team)
+* [Get a team](/v3/teams/#get-a-team)
 {% endif %}
-* [Actualizar un equipo](/v3/teams/#update-a-team)
-* [Borrar un equipo](/v3/teams/#delete-a-team)
+* [Update a team](/v3/teams/#update-a-team)
+* [Delete a team](/v3/teams/#delete-a-team)
 {% if currentVersion == "free-pro-team@latest" %}
-* [Listar invitaciones pendientes al equipo](/v3/teams/members/#list-pending-team-invitations)
+* [List pending team invitations](/v3/teams/members/#list-pending-team-invitations)
 {% endif %}
-* [Listar miembros del equipo](/v3/teams/members/#list-team-members)
-* [Obtener la membresía de equipo de un usuario](/v3/teams/members/#get-team-membership-for-a-user)
-* [Agregar o actualizar la membrecía de equipo de un usuario](/v3/teams/members/#add-or-update-team-membership-for-a-user)
-* [Eliminar la membrecía de equipo para un usuario](/v3/teams/members/#remove-team-membership-for-a-user)
-* [Listar los equipos hijos](/v3/teams/#list-child-teams)
-* [Listar los equipos para el usuario autenticado](/v3/teams/#list-teams-for-the-authenticated-user)
-
-##### Organizaciones
-
-* [Listar organizaciones](/v3/orgs/#list-organizations)
-* [Obtener una organización](/v3/orgs/#get-an-organization)
-* [Actualizar una organización](/v3/orgs/#update-an-organization)
-* [Listar membrecías de organización para el usuario autenticado](/v3/orgs/members/#list-organization-memberships-for-the-authenticated-user)
-* [Obtener la membrecía de organización para el usuario autenticado](/v3/orgs/members/#get-an-organization-membership-for-the-authenticated-user)
-* [Actualizar la membrecía de una organización para el usuario autenticado](/v3/orgs/members/#update-an-organization-membership-for-the-authenticated-user)
-* [Listar las organizaciones para el usuario autenticado](/v3/orgs/#list-organizations-for-the-authenticated-user)
-* [Listar las organizaciones de un usuario](/v3/orgs/#list-organizations-for-a-user)
+* [List team members](/v3/teams/members/#list-team-members)
+* [Get team membership for a user](/v3/teams/members/#get-team-membership-for-a-user)
+* [Add or update team membership for a user](/v3/teams/members/#add-or-update-team-membership-for-a-user)
+* [Remove team membership for a user](/v3/teams/members/#remove-team-membership-for-a-user)
+* [List child teams](/v3/teams/#list-child-teams)
+* [List teams for the authenticated user](/v3/teams/#list-teams-for-the-authenticated-user)
+
+##### Organizations
+
+* [List organizations](/v3/orgs/#list-organizations)
+* [Get an organization](/v3/orgs/#get-an-organization)
+* [Update an organization](/v3/orgs/#update-an-organization)
+* [List organization memberships for the authenticated user](/v3/orgs/members/#list-organization-memberships-for-the-authenticated-user)
+* [Get an organization membership for the authenticated user](/v3/orgs/members/#get-an-organization-membership-for-the-authenticated-user)
+* [Update an organization membership for the authenticated user](/v3/orgs/members/#update-an-organization-membership-for-the-authenticated-user)
+* [List organizations for the authenticated user](/v3/orgs/#list-organizations-for-the-authenticated-user)
+* [List organizations for a user](/v3/orgs/#list-organizations-for-a-user)
 
 {% if currentVersion == "free-pro-team@latest" %}
-##### Autorizaciones de Credencial para las Organizaciones
+##### Organizations Credential Authorizations
 
-* [Listar las autorizaciones del SSO de SAML para una organización](/v3/orgs/#list-saml-sso-authorizations-for-an-organization)
-* [Eliminar las autorizaciones del SSO de SAML de una organización](/v3/orgs/#remove-a-saml-sso-authorization-for-an-organization)
+* [List SAML SSO authorizations for an organization](/v3/orgs/#list-saml-sso-authorizations-for-an-organization)
+* [Remove a SAML SSO authorization for an organization](/v3/orgs/#remove-a-saml-sso-authorization-for-an-organization)
 {% endif %}
 
 {% if currentVersion == "free-pro-team@latest" %}
-##### Scim de las Organizaciones
-
-* [Listar las identidades aprovisionadas de SCIM](/v3/scim/#list-scim-provisioned-identities)
-* [Aprovisionar e invitar a un usuario de SCIM](/v3/scim/#provision-and-invite-a-scim-user)
-* [Obtener la información de aprovisionamiento de SCIM para un usuario](/v3/scim/#get-scim-provisioning-information-for-a-user)
-* [Configurar la información de SCIM para un usuario aprovisionado](/v3/scim/#set-scim-information-for-a-provisioned-user)
-* [Actualizar un atributo para un usuario de SCIM](/v3/scim/#update-an-attribute-for-a-scim-user)
-* [Borrar a un usuario de SCIM de una organización](/v3/scim/#delete-a-scim-user-from-an-organization)
+##### Organizations Scim
+
+* [List SCIM provisioned identities](/v3/scim/#list-scim-provisioned-identities)
+* [Provision and invite a SCIM user](/v3/scim/#provision-and-invite-a-scim-user)
+* [Get SCIM provisioning information for a user](/v3/scim/#get-scim-provisioning-information-for-a-user)
+* [Set SCIM information for a provisioned user](/v3/scim/#set-scim-information-for-a-provisioned-user)
+* [Update an attribute for a SCIM user](/v3/scim/#update-an-attribute-for-a-scim-user)
+* [Delete a SCIM user from an organization](/v3/scim/#delete-a-scim-user-from-an-organization)
 {% endif %}
 
 {% if currentVersion == "free-pro-team@latest" %}
-##### Importaciones de Código Fuente
-
-* [Obtener el estado de una importación](/v3/migrations/source_imports/#get-an-import-status)
-* [Iniciar una importación](/v3/migrations/source_imports/#start-an-import)
-* [Actualizar una importación](/v3/migrations/source_imports/#update-an-import)
-* [Cancelar una importación](/v3/migrations/source_imports/#cancel-an-import)
-* [Obtener los autores de una confirmación](/v3/migrations/source_imports/#get-commit-authors)
-* [Mapear al autor de una confirmación](/v3/migrations/source_imports/#map-a-commit-author)
-* [Obtener archivos grandes](/v3/migrations/source_imports/#get-large-files)
-* [Actualizar la preferencia de LFS de Git](/v3/migrations/source_imports/#update-git-lfs-preference)
+##### Source Imports
+
+* [Get an import status](/v3/migrations/source_imports/#get-an-import-status)
+* [Start an import](/v3/migrations/source_imports/#start-an-import)
+* [Update an import](/v3/migrations/source_imports/#update-an-import)
+* [Cancel an import](/v3/migrations/source_imports/#cancel-an-import)
+* [Get commit authors](/v3/migrations/source_imports/#get-commit-authors)
+* [Map a commit author](/v3/migrations/source_imports/#map-a-commit-author)
+* [Get large files](/v3/migrations/source_imports/#get-large-files)
+* [Update Git LFS preference](/v3/migrations/source_imports/#update-git-lfs-preference)
 {% endif %}
 
-##### Colaboradores de Proyecto
-
-* [Listar colaboradores del proyecto](/v3/projects/collaborators/#list-project-collaborators)
-* [Agregar a un colaborador del proyecto](/v3/projects/collaborators/#add-project-collaborator)
-* [Eliminar a un colaborador del proyecto](/v3/projects/collaborators/#remove-project-collaborator)
-* [Obtener permisos del proyecto para un usuario](/v3/projects/collaborators/#get-project-permission-for-a-user)
-
-##### Proyectos
-
-* [Listar los proyectos de la organización](/v3/projects/#list-organization-projects)
-* [Crear un proyecto en la organización](/v3/projects/#create-an-organization-project)
-* [Obtener un proyecto](/v3/projects/#get-a-project)
-* [Actualizar un proyecto](/v3/projects/#update-a-project)
-* [Borrar un proyecto](/v3/projects/#delete-a-project)
-* [Listar las columnas del proyecto](/v3/projects/columns/#list-project-columns)
-* [Crear una columna de proyecto](/v3/projects/columns/#create-a-project-column)
-* [Obtener una columna de proyecto](/v3/projects/columns/#get-a-project-column)
-* [Actualizar una column de proyecto](/v3/projects/columns/#update-a-project-column)
-* [Borrar una columna de proyecto](/v3/projects/columns/#delete-a-project-column)
-* [Listar las tarjetas del proyecto](/v3/projects/cards/#list-project-cards)
-* [Crear una tarjeta de proyecto](/v3/projects/cards/#create-a-project-card)
-* [Mover una columna de proyecto](/v3/projects/columns/#move-a-project-column)
-* [Obtener una tarjeta de proyecto](/v3/projects/cards/#get-a-project-card)
-* [Actualizar una tarjeta de proyecto](/v3/projects/cards/#update-a-project-card)
-* [Borrar una tarjeta de proyecto](/v3/projects/cards/#delete-a-project-card)
-* [Mover una tarjeta de proyecto](/v3/projects/cards/#move-a-project-card)
-* [Listar los proyectos de un repositorio](/v3/projects/#list-repository-projects)
-* [Crear un proyecto en un repositorio](/v3/projects/#create-a-repository-project)
-
-##### Comentarios de Extracción
-
-* [Listar comentarios de revisión en una solicitud de extracción](/v3/pulls/comments/#list-review-comments-on-a-pull-request)
-* [Crear un comentario de revisión para una solicitud de extracción](/v3/pulls/comments/#create-a-review-comment-for-a-pull-request)
-* [Listar comentarios de revisión en un repositorio](/v3/pulls/comments/#list-review-comments-in-a-repository)
-* [Obtener un comentario de revisión para una solicitud de extracción](/v3/pulls/comments/#get-a-review-comment-for-a-pull-request)
-* [Actualizar un comentario de revisión para una solicitud de extracción](/v3/pulls/comments/#update-a-review-comment-for-a-pull-request)
-* [Borrar un comentario de revisión para una solicitud de extracción](/v3/pulls/comments/#delete-a-review-comment-for-a-pull-request)
-
-##### Eventos de Revisión en Solciitudes de Extracción
-
-* [Descartar una revisión para una solicitud de extracción](/v3/pulls/reviews/#dismiss-a-review-for-a-pull-request)
-* [Emitir una revisión para una solicitud de extracción](/v3/pulls/reviews/#submit-a-review-for-a-pull-request)
-
-##### Solicitudes de Revisión para Solicitudes de Extracción
-
-* [Listar a los revisores requeridos para una solicitud de extracción](/v3/pulls/review_requests/#list-requested-reviewers-for-a-pull-request)
-* [Solicitar a los revisores para una solicitud de extracción](/v3/pulls/review_requests/#request-reviewers-for-a-pull-request)
-* [Eliminar a los revisores solicitados para una solicitud de extracción](/v3/pulls/review_requests/#remove-requested-reviewers-from-a-pull-request)
-
-##### Revisiones de Solicitudes de Extracción
-
-* [Listar revisores para una solicitud de extracción](/v3/pulls/reviews/#list-reviews-for-a-pull-request)
-* [Crear revisión para una solicitud de extracción](/v3/pulls/reviews/#create-a-review-for-a-pull-request)
-* [Obtener una revisión para una solicitud de extracción](/v3/pulls/reviews/#get-a-review-for-a-pull-request)
-* [Actualizar una revisión para una solicitud de extracción](/v3/pulls/reviews/#update-a-review-for-a-pull-request)
-* [Listar los comentarios para una revisión de una solicitud de extracción](/v3/pulls/reviews/#list-comments-for-a-pull-request-review)
-
-##### Extracciones
-
-* [Listar solicitudes extracción](/v3/pulls/#list-pull-requests)
-* [Crear una solicitud de extracción](/v3/pulls/#create-a-pull-request)
-* [Obtener una solicitud de extracción](/v3/pulls/#get-a-pull-request)
-* [Actualizar una solicitud de extracción](/v3/pulls/#update-a-pull-request)
-* [Listar las confirmaciones en una solicitud de extracción](/v3/pulls/#list-commits-on-a-pull-request)
-* [Listar los archivos en una solicitud de extracción](/v3/pulls/#list-pull-requests-files)
-* [Revisar si se ha fusionado una solicitud de extracción](/v3/pulls/#check-if-a-pull-request-has-been-merged)
-* [Fusionar una solicitud de extracción (Botón de Fusionar)](/v3/pulls/#merge-a-pull-request)
-
-##### Reacciones
-
-{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}*[Borrar una reacción](/v3/reactions/#delete-a-reaction-legacy){% else %}*[Borrar una reacción](/v3/reactions/#delete-a-reaction){% endif %}
-* [Listar las reacciones a un comentario de una confirmación](/v3/reactions/#list-reactions-for-a-commit-comment)
-* [Crear una reacción para el comentario de una confirmación](/v3/reactions/#create-reaction-for-a-commit-comment)
-* [Listar las reacciones de un informe de problemas](/v3/reactions/#list-reactions-for-an-issue)
-* [Crear una reacción para un informe de problemas](/v3/reactions/#create-reaction-for-an-issue)
-* [Listar las reacciones para el comentario de un informe de problemas](/v3/reactions/#list-reactions-for-an-issue-comment)
-* [Crear una reacción para el comentario de informe de problemas](/v3/reactions/#create-reaction-for-an-issue-comment)
-* [Listar las reacciones para el comentario de revisión de una solicitud de extracción](/v3/reactions/#list-reactions-for-a-pull-request-review-comment)
-* [Crear una reacción para un comentario de revisión de una solicitud de extracción](/v3/reactions/#create-reaction-for-a-pull-request-review-comment)
-* [Listar las reacciones para un comentario de debate de equipo](/v3/reactions/#list-reactions-for-a-team-discussion-comment)
-* [Crear una reacción para un comentario de debate de equipo](/v3/reactions/#create-reaction-for-a-team-discussion-comment)
-* [Listar las reaciones a un debate de equipo](/v3/reactions/#list-reactions-for-a-team-discussion)
-* [Crear una reacción para un debate de equipo](/v3/reactions/#create-reaction-for-a-team-discussion){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}
-* [Borrar la reacción a un comentario de una confirmación](/v3/reactions/#delete-a-commit-comment-reaction)
-* [Borrar la reacción a un comentario](/v3/reactions/#delete-an-issue-reaction)
-* [Borrar la reacción a un comentario de una confirmación](/v3/reactions/#delete-an-issue-comment-reaction)
-* [Borrar la reacción a un comentario de una solicitud de extracción](/v3/reactions/#delete-a-pull-request-comment-reaction)
-* [Borrar la reacción a un debate de equipo](/v3/reactions/#delete-team-discussion-reaction)
-* [Borrar la reacción a un comentario de un debate de equipo](/v3/reactions/#delete-team-discussion-comment-reaction){% endif %}
-
-##### Repositorios
-
-* [Listar los repositorios de una organización](/v3/repos/#list-organization-repositories)
-* [Crear un repositorio para el usuario autenticado](/v3/repos/#create-a-repository-for-the-authenticated-user)
-* [Obtener un repositorio](/v3/repos/#get-a-repository)
-* [Actualizar un repositorio](/v3/repos/#update-a-repository)
-* [Borrar un repositorio](/v3/repos/#delete-a-repository)
-* [Comparar dos confirmaciones](/v3/repos/commits/#compare-two-commits)
-* [Listar los colaboradores del repositorio](/v3/repos/#list-repository-contributors)
-* [Listar las bifurcaciones](/v3/repos/forks/#list-forks)
-* [Crear una bifuración](/v3/repos/forks/#create-a-fork)
-* [Listar los lenguajes de un repositorio](/v3/repos/#list-repository-languages)
-* [Listar las matrículas de un repositorio](/v3/repos/#list-repository-tags)
-* [Listar los equipos de un repositorio](/v3/repos/#list-repository-teams)
-* [Transferir un repositorio](/v3/repos/#transfer-a-repository)
-* [Listar los repositorios públicos](/v3/repos/#list-public-repositories)
-* [Listar los repositorios para el usuario autenticado](/v3/repos/#list-repositories-for-the-authenticated-user)
-* [Listar los repositorios para un usuario](/v3/repos/#list-repositories-for-a-user)
-* [Crear un repositorio utilizando una plantilla de repositorio](/v3/repos/#create-repository-using-a-repository-template)
-
-##### Actividad del Repositorio
-
-* [Listar Stargazers](/v3/activity/starring/#list-stargazers)
-* [Listar observadores](/v3/activity/watching/#list-watchers)
-* [Listar los repositorios que el usuario ha marcado con una estrella](/v3/activity/starring/#list-repositories-starred-by-a-user)
-* [Verificar si el usuario autenticado ha marcado al repositorio con una estrella](/v3/activity/starring/#check-if-a-repository-is-starred-by-the-authenticated-user)
-* [Marcar un repositorio con una estrella para el usuario autenticado](/v3/activity/starring/#star-a-repository-for-the-authenticated-user)
-* [Quitar la estrella de un repositorio para el usuario autenticado](/v3/activity/starring/#unstar-a-repository-for-the-authenticated-user)
-* [Listar los repositorios que el usuario está observando](/v3/activity/watching/#list-repositories-watched-by-a-user)
+##### Project Collaborators
+
+* [List project collaborators](/v3/projects/collaborators/#list-project-collaborators)
+* [Add project collaborator](/v3/projects/collaborators/#add-project-collaborator)
+* [Remove project collaborator](/v3/projects/collaborators/#remove-project-collaborator)
+* [Get project permission for a user](/v3/projects/collaborators/#get-project-permission-for-a-user)
+
+##### Projects
+
+* [List organization projects](/v3/projects/#list-organization-projects)
+* [Create an organization project](/v3/projects/#create-an-organization-project)
+* [Get a project](/v3/projects/#get-a-project)
+* [Update a project](/v3/projects/#update-a-project)
+* [Delete a project](/v3/projects/#delete-a-project)
+* [List project columns](/v3/projects/columns/#list-project-columns)
+* [Create a project column](/v3/projects/columns/#create-a-project-column)
+* [Get a project column](/v3/projects/columns/#get-a-project-column)
+* [Update a project column](/v3/projects/columns/#update-a-project-column)
+* [Delete a project column](/v3/projects/columns/#delete-a-project-column)
+* [List project cards](/v3/projects/cards/#list-project-cards)
+* [Create a project card](/v3/projects/cards/#create-a-project-card)
+* [Move a project column](/v3/projects/columns/#move-a-project-column)
+* [Get a project card](/v3/projects/cards/#get-a-project-card)
+* [Update a project card](/v3/projects/cards/#update-a-project-card)
+* [Delete a project card](/v3/projects/cards/#delete-a-project-card)
+* [Move a project card](/v3/projects/cards/#move-a-project-card)
+* [List repository projects](/v3/projects/#list-repository-projects)
+* [Create a repository project](/v3/projects/#create-a-repository-project)
+
+##### Pull Comments
+
+* [List review comments on a pull request](/v3/pulls/comments/#list-review-comments-on-a-pull-request)
+* [Create a review comment for a pull request](/v3/pulls/comments/#create-a-review-comment-for-a-pull-request)
+* [List review comments in a repository](/v3/pulls/comments/#list-review-comments-in-a-repository)
+* [Get a review comment for a pull request](/v3/pulls/comments/#get-a-review-comment-for-a-pull-request)
+* [Update a review comment for a pull request](/v3/pulls/comments/#update-a-review-comment-for-a-pull-request)
+* [Delete a review comment for a pull request](/v3/pulls/comments/#delete-a-review-comment-for-a-pull-request)
+
+##### Pull Request Review Events
+
+* [Dismiss a review for a pull request](/v3/pulls/reviews/#dismiss-a-review-for-a-pull-request)
+* [Submit a review for a pull request](/v3/pulls/reviews/#submit-a-review-for-a-pull-request)
+
+##### Pull Request Review Requests
+
+* [List requested reviewers for a pull request](/v3/pulls/review_requests/#list-requested-reviewers-for-a-pull-request)
+* [Request reviewers for a pull request](/v3/pulls/review_requests/#request-reviewers-for-a-pull-request)
+* [Remove requested reviewers from a pull request](/v3/pulls/review_requests/#remove-requested-reviewers-from-a-pull-request)
+
+##### Pull Request Reviews
+
+* [List reviews for a pull request](/v3/pulls/reviews/#list-reviews-for-a-pull-request)
+* [Create a review for a pull request](/v3/pulls/reviews/#create-a-review-for-a-pull-request)
+* [Get a review for a pull request](/v3/pulls/reviews/#get-a-review-for-a-pull-request)
+* [Update a review for a pull request](/v3/pulls/reviews/#update-a-review-for-a-pull-request)
+* [List comments for a pull request review](/v3/pulls/reviews/#list-comments-for-a-pull-request-review)
+
+##### Pulls
+
+* [List pull requests](/v3/pulls/#list-pull-requests)
+* [Create a pull request](/v3/pulls/#create-a-pull-request)
+* [Get a pull request](/v3/pulls/#get-a-pull-request)
+* [Update a pull request](/v3/pulls/#update-a-pull-request)
+* [List commits on a pull request](/v3/pulls/#list-commits-on-a-pull-request)
+* [List pull requests files](/v3/pulls/#list-pull-requests-files)
+* [Check if a pull request has been merged](/v3/pulls/#check-if-a-pull-request-has-been-merged)
+* [Merge a pull request (Merge Button)](/v3/pulls/#merge-a-pull-request)
+
+##### Reactions
+
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}* [Delete a reaction](/v3/reactions/#delete-a-reaction-legacy){% else %}* [Delete a reaction](/v3/reactions/#delete-a-reaction){% endif %}
+* [List reactions for a commit comment](/v3/reactions/#list-reactions-for-a-commit-comment)
+* [Create reaction for a commit comment](/v3/reactions/#create-reaction-for-a-commit-comment)
+* [List reactions for an issue](/v3/reactions/#list-reactions-for-an-issue)
+* [Create reaction for an issue](/v3/reactions/#create-reaction-for-an-issue)
+* [List reactions for an issue comment](/v3/reactions/#list-reactions-for-an-issue-comment)
+* [Create reaction for an issue comment](/v3/reactions/#create-reaction-for-an-issue-comment)
+* [List reactions for a pull request review comment](/v3/reactions/#list-reactions-for-a-pull-request-review-comment)
+* [Create reaction for a pull request review comment](/v3/reactions/#create-reaction-for-a-pull-request-review-comment)
+* [List reactions for a team discussion comment](/v3/reactions/#list-reactions-for-a-team-discussion-comment)
+* [Create reaction for a team discussion comment](/v3/reactions/#create-reaction-for-a-team-discussion-comment)
+* [List reactions for a team discussion](/v3/reactions/#list-reactions-for-a-team-discussion)
+* [Create reaction for a team discussion](/v3/reactions/#create-reaction-for-a-team-discussion){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}
+* [Delete a commit comment reaction](/v3/reactions/#delete-a-commit-comment-reaction)
+* [Delete an issue reaction](/v3/reactions/#delete-an-issue-reaction)
+* [Delete a reaction to a commit comment](/v3/reactions/#delete-an-issue-comment-reaction)
+* [Delete a pull request comment reaction](/v3/reactions/#delete-a-pull-request-comment-reaction)
+* [Delete team discussion reaction](/v3/reactions/#delete-team-discussion-reaction)
+* [Delete team discussion comment reaction](/v3/reactions/#delete-team-discussion-comment-reaction){% endif %}
+
+##### Repositories
+
+* [List organization repositories](/v3/repos/#list-organization-repositories)
+* [Create a repository for the authenticated user](/v3/repos/#create-a-repository-for-the-authenticated-user)
+* [Get a repository](/v3/repos/#get-a-repository)
+* [Update a repository](/v3/repos/#update-a-repository)
+* [Delete a repository](/v3/repos/#delete-a-repository)
+* [Compare two commits](/v3/repos/commits/#compare-two-commits)
+* [List repository contributors](/v3/repos/#list-repository-contributors)
+* [List forks](/rest/reference/repos#list-forks)
+* [Create a fork](/v3/repos/forks/#create-a-fork)
+* [List repository languages](/v3/repos/#list-repository-languages)
+* [List repository tags](/v3/repos/#list-repository-tags)
+* [List repository teams](/v3/repos/#list-repository-teams)
+* [Transfer a repository](/v3/repos/#transfer-a-repository)
+* [List public repositories](/v3/repos/#list-public-repositories)
+* [List repositories for the authenticated user](/v3/repos/#list-repositories-for-the-authenticated-user)
+* [List repositories for a user](/v3/repos/#list-repositories-for-a-user)
+* [Create repository using a repository template](/v3/repos/#create-repository-using-a-repository-template)
+
+##### Repository Activity
+
+* [List stargazers](/rest/reference/activity#list-stargazers)
+* [List watchers](/rest/reference/activity#list-watchers)
+* [List repositories starred by a user](/rest/reference/activity#list-repositories-starred-by-a-user)
+* [Check if a repository is starred by the authenticated user](/rest/reference/activity#check-if-a-repository-is-starred-by-the-authenticated-user)
+* [Star a repository for the authenticated user](/rest/reference/activity#star-a-repository-for-the-authenticated-user)
+* [Unstar a repository for the authenticated user](/rest/reference/activity#unstar-a-repository-for-the-authenticated-user)
+* [List repositories watched by a user](/rest/reference/activity#list-repositories-watched-by-a-user)
 
 {% if currentVersion == "free-pro-team@latest" %}
-##### Correcciones de Seguridad Automatizadas de un Repositorio
+##### Repository Automated Security Fixes
 
-* [Habilitar las correcciones de seguridad automatizadas](/v3/repos/#enable-automated-security-fixes)
-* [Inhabilitar las correcciones de seguridad automatizadas](/v3/repos/#disable-automated-security-fixes)
+* [Enable automated security fixes](/v3/repos/#enable-automated-security-fixes)
+* [Disable automated security fixes](/v3/repos/#disable-automated-security-fixes)
 {% endif %}
 
-##### Ramas de los Repositorios
-
-* [Listar ramas](/v3/repos/branches/#list-branches)
-* [Obtener una rama](/v3/repos/branches/#get-a-branch)
-* [Obtener la protección de una rama](/v3/repos/branches/#get-branch-protection)
-* [Actualizar la protección de una rama](/v3/repos/branches/#update-branch-protection)
-* [Borrar la protección de una rama](/v3/repos/branches/#delete-branch-protection)
-* [Obtener la protección administrativa de una rama](/v3/repos/branches/#get-admin-branch-protection)
-* [Configurar la protección administrativa de una rama](/v3/repos/branches/#set-admin-branch-protection)
-* [Borrar la protección administrativa de una rama](/v3/repos/branches/#delete-admin-branch-protection)
-* [Obtener la protección de la revisión de una solicitud de extracción](/v3/repos/branches/#get-pull-request-review-protection)
-* [Actualizar la protección de la revisión de una solicitud de extracción](/v3/repos/branches/#update-pull-request-review-protection)
-* [Borrar la protección de la revisión de una solicitud de extracción](/v3/repos/branches/#delete-pull-request-review-protection)
-* [Obtener la protección de firma de una confirmación](/v3/repos/branches/#get-commit-signature-protection)
-* [Crear la protección de firma de una confirmación](/v3/repos/branches/#create-commit-signature-protection)
-* [Borrar la protección de firma de una confirmación](/v3/repos/branches/#delete-commit-signature-protection)
-* [Obtener la protección de las verificaciones de estado](/v3/repos/branches/#get-status-checks-protection)
-* [Actualizar la protección de las verificaciones de estado](/v3/repos/branches/#update-status-check-potection)
-* [Eliminar la protección de las verificaciones de estado](/v3/repos/branches/#remove-status-check-protection)
-* [Obtener todos los contextos de verificaciones de estado](/v3/repos/branches/#get-all-status-check-contexts)
-* [Agregar un contexto de verificación de estado](/v3/repos/branches/#add-status-check-contexts)
-* [Obtener un contexto de verificación de estado](/v3/repos/branches/#set-status-check-contexts)
-* [Eliminar los contextos de verificación de estado](/v3/repos/branches/#remove-status-check-contexts)
-* [Obtener restricciones de acceso](/v3/repos/branches/#get-access-restrictions)
-* [Borrar restricciones de acceso](/v3/repos/branches/#delete-access-restrictions)
-* [Listar a los equipos con acceso a la rama protegida](/v3/repos/branches/#list-teams-with-access-to-the-protected-branch)
-* [Agregar restricciones de acceso a equipos](/v3/repos/branches/#add-team-access-restrictions)
-* [Obtener restricciones de acceso a equipos](/v3/repos/branches/#set-team-access-restrictions)
-* [Eliminar restricciones de acceso a equipos](/v3/repos/branches/#remove-team-access-restrictions)
-* [Listar las restricciones de usuario para la rama protegida](/v3/repos/branches/#list-users-with-access-to-the-protected-branch)
-* [Agregar las restricciones de acceso para los usuarios](/v3/repos/branches/#add-user-access-restrictions)
-* [Configurar las restricciones de acceso para los usuarios](/v3/repos/branches/#set-user-access-restrictions)
-* [Eliminar las restricciones de acceso para los usuarios](/v3/repos/branches/#remove-user-access-restrictions)
-* [Fusionar una rama](/v3/repos/merging/#merge-a-branch)
-
-##### Colaboradores del Repositorio
-
-* [Listar los colaboradores del repositorio](/v3/repos/collaborators/#list-repository-collaborators)
-* [Verificar si un usuario es colaborador de un repositorio](/v3/repos/collaborators/#check-if-a-user-is-a-repository-collaborator)
-* [Agregar un colaborador de repositorio](/v3/repos/collaborators/#add-a-repository-collaborator)
-* [Eliminar a un colaborador del repositorio](/v3/repos/collaborators/#remove-a-repository-collaborator)
-* [Obtener permisos del repositorio para un usuario](/v3/repos/collaborators/#get-repository-permissions-for-a-user)
-
-##### Comentarios de Confirmaciones de un Repositorio
-
-* [Listar los comentarios de confirmaciones en un repositorio](/v3/repos/comments/#list-commit-comments-for-a-repository)
-* [Obtener un comentario de una confirmación](/v3/repos/comments/#get-a-commit-comment)
-* [Actualizar un comentario de una confirmación](/v3/repos/comments/#update-a-commit-comment)
-* [Borrar un comentario de una confirmación](/v3/repos/comments/#delete-a-commit-comment)
-* [Listar los comentarios de una confirmación](/v3/repos/comments/#list-commit-comments)
-* [Crear un comentario de una confirmación](/v3/repos/comments/#create-a-commit-comment)
-
-##### Confirmaciones de Repositorio
-
-* [Listar confirmaciones](/v3/repos/commits/#list-commits)
-* [Obtener una confirmación](/v3/repos/commits/#get-a-commit)
-* [Listar ramas para la confirmación principal](/v3/repos/commits/#list-branches-for-head-commit)
-* [Listar solicitudes de extracción asociadas con una confirmación](/v3/repos/commits/#list-pull-requests-associated-with-commit)
-
-##### Comunidad del Repositorio
-
-* [Obtener el código de conducta de un repositorio](/v3/codes_of_conduct/#get-the-code-of-conduct-for-a-repository)
+##### Repository Branches
+
+* [List branches](/v3/repos/branches/#list-branches)
+* [Get a branch](/v3/repos/branches/#get-a-branch)
+* [Get branch protection](/v3/repos/branches/#get-branch-protection)
+* [Update branch protection](/v3/repos/branches/#update-branch-protection)
+* [Delete branch protection](/v3/repos/branches/#delete-branch-protection)
+* [Get admin branch protection](/v3/repos/branches/#get-admin-branch-protection)
+* [Set admin branch protection](/v3/repos/branches/#set-admin-branch-protection)
+* [Delete admin branch protection](/v3/repos/branches/#delete-admin-branch-protection)
+* [Get pull request review protection](/v3/repos/branches/#get-pull-request-review-protection)
+* [Update pull request review protection](/v3/repos/branches/#update-pull-request-review-protection)
+* [Delete pull request review protection](/v3/repos/branches/#delete-pull-request-review-protection)
+* [Get commit signature protection](/v3/repos/branches/#get-commit-signature-protection)
+* [Create commit signature protection](/v3/repos/branches/#create-commit-signature-protection)
+* [Delete commit signature protection](/v3/repos/branches/#delete-commit-signature-protection)
+* [Get status checks protection](/v3/repos/branches/#get-status-checks-protection)
+* [Update status check potection](/v3/repos/branches/#update-status-check-potection)
+* [Remove status check protection](/v3/repos/branches/#remove-status-check-protection)
+* [Get all status check contexts](/v3/repos/branches/#get-all-status-check-contexts)
+* [Add status check contexts](/v3/repos/branches/#add-status-check-contexts)
+* [Set status check contexts](/v3/repos/branches/#set-status-check-contexts)
+* [Remove status check contexts](/v3/repos/branches/#remove-status-check-contexts)
+* [Get access restrictions](/v3/repos/branches/#get-access-restrictions)
+* [Delete access restrictions](/v3/repos/branches/#delete-access-restrictions)
+* [List teams with access to the protected branch](/v3/repos/branches/#list-teams-with-access-to-the-protected-branch)
+* [Add team access restrictions](/v3/repos/branches/#add-team-access-restrictions)
+* [Set team access restrictions](/v3/repos/branches/#set-team-access-restrictions)
+* [Remove team access restriction](/v3/repos/branches/#remove-team-access-restrictions)
+* [List user restrictions of protected branch](/v3/repos/branches/#list-users-with-access-to-the-protected-branch)
+* [Add user access restrictions](/v3/repos/branches/#add-user-access-restrictions)
+* [Set user access restrictions](/v3/repos/branches/#set-user-access-restrictions)
+* [Remove user access restrictions](/v3/repos/branches/#remove-user-access-restrictions)
+* [Merge a branch](/v3/repos/merging/#merge-a-branch)
+
+##### Repository Collaborators
+
+* [List repository collaborators](/v3/repos/collaborators/#list-repository-collaborators)
+* [Check if a user is a repository collaborator](/v3/repos/collaborators/#check-if-a-user-is-a-repository-collaborator)
+* [Add a repository collaborator](/v3/repos/collaborators/#add-a-repository-collaborator)
+* [Remove a repository collaborator](/v3/repos/collaborators/#remove-a-repository-collaborator)
+* [Get repository permissions for a user](/v3/repos/collaborators/#get-repository-permissions-for-a-user)
+
+##### Repository Commit Comments
+
+* [List commit comments for a repository](/v3/repos/comments/#list-commit-comments-for-a-repository)
+* [Get a commit comment](/v3/repos/comments/#get-a-commit-comment)
+* [Update a commit comment](/v3/repos/comments/#update-a-commit-comment)
+* [Delete a commit comment](/v3/repos/comments/#delete-a-commit-comment)
+* [List commit comments](/v3/repos/comments/#list-commit-comments)
+* [Create a commit comment](/v3/repos/comments/#create-a-commit-comment)
+
+##### Repository Commits
+
+* [List commits](/v3/repos/commits/#list-commits)
+* [Get a commit](/v3/repos/commits/#get-a-commit)
+* [List branches for head commit](/v3/repos/commits/#list-branches-for-head-commit)
+* [List pull requests associated with commit](/v3/repos/commits/#list-pull-requests-associated-with-commit)
+
+##### Repository Community
+
+* [Get the code of conduct for a repository](/v3/codes_of_conduct/#get-the-code-of-conduct-for-a-repository)
 {% if currentVersion == "free-pro-team@latest" %}
-* [Obtener las métricas de perfil de la comunidad](/v3/repos/community/#get-community-profile-metrics)
+* [Get community profile metrics](/v3/repos/community/#get-community-profile-metrics)
 {% endif %}
 
-##### Contenido de los Repositorios
+##### Repository Contents
 
-* [Descargar un archivo de un repositorio](/v3/repos/contents/#download-a-repository-archive)
-* [Obtener el contenido de un repositorio](/v3/repos/contents/#get-repository-content)
-* [Crear o actualizar los contenidos de archivo](/v3/repos/contents/#create-or-update-file-contents)
-* [Borrar un archivo](/v3/repos/contents/#delete-a-file)
-* [Obtener el README de un repositorio](/v3/repos/contents/#get-a-repository-readme)
-* [Obtener la licencia para un repositorio](/v3/licenses/#get-the-license-for-a-repository)
+* [Download a repository archive](/v3/repos/contents/#download-a-repository-archive)
+* [Get repository content](/v3/repos/contents/#get-repository-content)
+* [Create or update file contents](/v3/repos/contents/#create-or-update-file-contents)
+* [Delete a file](/v3/repos/contents/#delete-a-file)
+* [Get a repository README](/v3/repos/contents/#get-a-repository-readme)
+* [Get the license for a repository](/v3/licenses/#get-the-license-for-a-repository)
 
 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}
-##### Envíos de Evento de un Repositorio
+##### Repository Event Dispatches
 
-* [Crear un evento de envío de un repositorio](/v3/repos/#create-a-repository-dispatch-event)
+* [Create a repository dispatch event](/v3/repos/#create-a-repository-dispatch-event)
 {% endif %}
 
-##### Ganchos de Repositorio
+##### Repository Hooks
 
-* [Listar los webhooks de un repositorio](/v3/repos/hooks/#list-repository-webhooks)
-* [Crear un webhook para un repositorio](/v3/repos/hooks/#create-a-repository-webhook)
-* [Obtener un webhook para un repositorio](/v3/repos/hooks/#get-a-repository-webhook)
-* [Actualizar el webhook de un repositorio](/v3/repos/hooks/#update-a-repository-webhook)
-* [Borrar el webhook de un repositorio](/v3/repos/hooks/#delete-a-repository-webhook)
-* [Hacer ping al webhook de un repositorio](/v3/repos/hooks/#ping-a-repository-webhook)
-* [Probar el webhook de carga a un repositorio](/v3/repos/hooks/#test-the-push-repository-webhook)
+* [List repository webhooks](/v3/repos/hooks/#list-repository-webhooks)
+* [Create a repository webhook](/v3/repos/hooks/#create-a-repository-webhook)
+* [Get a repository webhook](/v3/repos/hooks/#get-a-repository-webhook)
+* [Update a repository webhook](/v3/repos/hooks/#update-a-repository-webhook)
+* [Delete a repository webhook](/v3/repos/hooks/#delete-a-repository-webhook)
+* [Ping a repository webhook](/v3/repos/hooks/#ping-a-repository-webhook)
+* [Test the push repository webhook](/v3/repos/hooks/#test-the-push-repository-webhook)
 
-##### Invitaciones a un repositorio
+##### Repository Invitations
 
-* [Listar las invitaciones a un repositorio](/v3/repos/invitations/#list-repository-invitations)
-* [Actualizar la invitación a un repositorio](/v3/repos/invitations/#update-a-repository-invitation)
-* [Borrar la invitación a un repositorio](/v3/repos/invitations/#delete-a-repository-invitation)
-* [Listar las invitaciones a un repositorio para el usuario autenticado](/v3/repos/invitations/#list-repository-invitations-for-the-authenticated-user)
-* [Aceptar la invitación a un repositorio](/v3/repos/invitations/#accept-a-repository-invitation)
-* [Rechazar la invitación a un repositorio](/v3/repos/invitations/#decline-a-repository-invitation)
+* [List repository invitations](/v3/repos/invitations/#list-repository-invitations)
+* [Update a repository invitation](/v3/repos/invitations/#update-a-repository-invitation)
+* [Delete a repository invitation](/v3/repos/invitations/#delete-a-repository-invitation)
+* [List repository invitations for the authenticated user](/v3/repos/invitations/#list-repository-invitations-for-the-authenticated-user)
+* [Accept a repository invitation](/v3/repos/invitations/#accept-a-repository-invitation)
+* [Decline a repository invitation](/v3/repos/invitations/#decline-a-repository-invitation)
 
-##### Claves de Repositorio
+##### Repository Keys
 
-* [Listar claves de despliegue](/v3/repos/keys/#list-deploy-keys)
-* [Crear una clave de despliegue](/v3/repos/keys/#create-a-deploy-key)
-* [Obtener una clave de despliegue](/v3/repos/keys/#get-a-deploy-key)
-* [Borrar una clave de despiegue](/v3/repos/keys/#delete-a-deploy-key)
+* [List deploy keys](/v3/repos/keys/#list-deploy-keys)
+* [Create a deploy key](/v3/repos/keys/#create-a-deploy-key)
+* [Get a deploy key](/v3/repos/keys/#get-a-deploy-key)
+* [Delete a deploy key](/v3/repos/keys/#delete-a-deploy-key)
 
-##### Páginas de Repositorio
+##### Repository Pages
 
-* [Obtener un sitio de GitHub Pages](/v3/repos/pages/#get-a-github-pages-site)
-* [Crear un sitio de GitHub Pages](/v3/repos/pages/#create-a-github-pages-site)
-* [Actualizar la información acerca de un sitio de GitHub Pages](/v3/repos/pages/#update-information-about-a-github-pages-site)
-* [Borrar un sitio de GitHub Pages](/v3/repos/pages/#delete-a-github-pages-site)
-* [Listar las compilaciones de GitHub Pages](/v3/repos/pages/#list-github-pages-builds)
-* [Solicitar una compilación de GitHub Pages](/v3/repos/pages/#request-a-github-pages-build)
-* [Obtener una compilación de GitHub Pages](/v3/repos/pages/#get-github-pages-build)
-* [Obtener la última compilación de pages](/v3/repos/pages/#get-latest-pages-build)
+* [Get a GitHub Pages site](/rest/reference/repos#get-a-github-pages-site)
+* [Create a GitHub Pages site](/rest/reference/repos#create-a-github-pages-site)
+* [Update information about a GitHub Pages site](/rest/reference/repos#update-information-about-a-github-pages-site)
+* [Delete a GitHub Pages site](/rest/reference/repos#delete-a-github-pages-site)
+* [List GitHub Pages builds](/rest/reference/repos#list-github-pages-builds)
+* [Request a GitHub Pages build](/rest/reference/repos#request-a-github-pages-build)
+* [Get GitHub Pages build](/rest/reference/repos#get-github-pages-build)
+* [Get latest pages build](/rest/reference/repos#get-latest-pages-build)
 
 {% if currentVersion != "free-pro-team@latest" %}
-##### Ganchos de Pre-recepción de un Repositorio
+##### Repository Pre Receive Hooks
 
-* [Listar los ganchos de pre-recepción para un repositorio](/enterprise/user/rest/reference/enterprise-admin#list-pre-receive-hooks-for-a-repository)
-* [Obtener un gancho de pre-recepción de un repositorio](/enterprise/user/rest/reference/enterprise-admin#get-a-pre-receive-hook-for-a-repository)
-* [Actualizar el requerir ganchos de pre-recepción en un repositorio](/enterprise/user/rest/reference/enterprise-admin#update-pre-receive-hook-enforcement-for-a-repository)
-* [Eliminar el requerir ganchos de pre-recepción para un repositorio](/enterprise/user/rest/reference/enterprise-admin#remove-pre-receive-hook-enforcement-for-a-repository)
+* [List pre-receive hooks for a repository](/enterprise/user/rest/reference/enterprise-admin#list-pre-receive-hooks-for-a-repository)
+* [Get a pre-receive hook for a repository](/enterprise/user/rest/reference/enterprise-admin#get-a-pre-receive-hook-for-a-repository)
+* [Update pre-receive hook enforcement for a repository](/enterprise/user/rest/reference/enterprise-admin#update-pre-receive-hook-enforcement-for-a-repository)
+* [Remove pre-receive hook enforcement for a repository](/enterprise/user/rest/reference/enterprise-admin#remove-pre-receive-hook-enforcement-for-a-repository)
 {% endif %}
 
-##### Lanzamientos de repositorio
+##### Repository Releases
 
-* [Listar los lanzamientos](/v3/repos/releases/#list-releases)
-* [Crear un lanzamiento](/v3/repos/releases/#create-a-release)
-* [Obtener un lanzamiento](/v3/repos/releases/#get-a-release)
-* [Actualizar un lanzamiento](/v3/repos/releases/#update-a-release)
-* [Borrar un lanzamiento](/v3/repos/releases/#delete-a-release)
-* [Listar activos de lanzamiento](/v3/repos/releases/#list-release-assets)
-* [Obtener un activo de lanzamiento](/v3/repos/releases/#get-a-release-asset)
-* [Actualizar un activo de lanzamiento](/v3/repos/releases/#update-a-release-asset)
-* [Borrar un activo de lanzamiento](/v3/repos/releases/#delete-a-release-asset)
-* [Obtener el lanzamiento más reciente](/v3/repos/releases/#get-the-latest-release)
-* [Obtener un lanzamiento por nombre de matrícula](/v3/repos/releases/#get-a-release-by-tag-name)
+* [List releases](/rest/reference/repos/#list-releases)
+* [Create a release](/rest/reference/repos/#create-a-release)
+* [Get a release](/rest/reference/repos/#get-a-release)
+* [Update a release](/rest/reference/repos/#update-a-release)
+* [Delete a release](/rest/reference/repos/#delete-a-release)
+* [List release assets](/rest/reference/repos/#list-release-assets)
+* [Get a release asset](/rest/reference/repos/#get-a-release-asset)
+* [Update a release asset](/rest/reference/repos/#update-a-release-asset)
+* [Delete a release asset](/rest/reference/repos/#delete-a-release-asset)
+* [Get the latest release](/rest/reference/repos/#get-the-latest-release)
+* [Get a release by tag name](/rest/reference/repos/#get-a-release-by-tag-name)
 
-##### Estadísticas de Repositorio
+##### Repository Stats
 
-* [Obtener la actividad de confirmaciones semanal](/v3/repos/statistics/#get-the-weekly-commit-activity)
-* [Obtener la actividad de confirmaciones del año pasado](/v3/repos/statistics/#get-the-last-year-of-commit-activity)
-* [Obtener la actividad de confirmaciones de todos los colaboradores](/v3/repos/statistics/#get-all-contributor-commit-activity)
-* [Obtener la cuenta semanal de confirmaciones](/v3/repos/statistics/#get-the-weekly-commit-count)
-* [Obtener la cuenta de confirmaciones por hora para cada día](/v3/repos/statistics/#get-the-hourly-commit-count-for-each-day)
+* [Get the weekly commit activity](/v3/repos/statistics/#get-the-weekly-commit-activity)
+* [Get the last year of commit activity](/v3/repos/statistics/#get-the-last-year-of-commit-activity)
+* [Get all contributor commit activity](/v3/repos/statistics/#get-all-contributor-commit-activity)
+* [Get the weekly commit count](/v3/repos/statistics/#get-the-weekly-commit-count)
+* [Get the hourly commit count for each day](/v3/repos/statistics/#get-the-hourly-commit-count-for-each-day)
 
 {% if currentVersion == "free-pro-team@latest" %}
-##### Alertas de Vulnerabilidad en Repositorios
+##### Repository Vulnerability Alerts
 
-* [Habilitar las alertas de vulnerabilidades](/v3/repos/#enable-vulnerability-alerts)
-* [Inhabilitar las alertas de vulnerabilidades](/v3/repos/#disable-vulnerability-alerts)
+* [Enable vulnerability alerts](/v3/repos/#enable-vulnerability-alerts)
+* [Disable vulnerability alerts](/v3/repos/#disable-vulnerability-alerts)
 {% endif %}
 
-##### Raíz
+##### Root
 
-* [Terminal raíz](/v3/#root-endpoint)
+* [Root endpoint](/v3/#root-endpoint)
 * [Emojis](/v3/emojis/#emojis)
-* [Obtener un estado de límite de tasa para el usuario autenticado](/v3/rate_limit/#get-rate-limit-status-for-the-authenticated-user)
+* [Get rate limit status for the authenticated user](/v3/rate_limit/#get-rate-limit-status-for-the-authenticated-user)
 
-##### Buscar
+##### Search
 
-* [Buscar código](/v3/search/#search-code)
-* [Buscar confirmaciones](/v3/search/#search-commits)
-* [Buscar etiquetas](/v3/search/#search-labels)
-* [Buscar repositorios](/v3/search/#search-repositories)
-* [Buscar temas](/v3/search/#search-topics)
-* [Buscar usuarios](/v3/search/#search-users)
+* [Search code](/v3/search/#search-code)
+* [Search commits](/v3/search/#search-commits)
+* [Search labels](/v3/search/#search-labels)
+* [Search repositories](/v3/search/#search-repositories)
+* [Search topics](/v3/search/#search-topics)
+* [Search users](/v3/search/#search-users)
 
-##### Estados
+##### Statuses
 
-* [Obtener el estado combinado para una referencia específica](/v3/repos/statuses/#get-the-combined-status-for-a-specific-reference)
-* [Listar los estados de confirmación para una referencia](/v3/repos/statuses/#list-commit-statuses-for-a-reference)
-* [Crear un estado de confirmación](/v3/repos/statuses/#create-a-commit-status)
+* [Get the combined status for a specific reference](/v3/repos/statuses/#get-the-combined-status-for-a-specific-reference)
+* [List commit statuses for a reference](/v3/repos/statuses/#list-commit-statuses-for-a-reference)
+* [Create a commit status](/v3/repos/statuses/#create-a-commit-status)
 
-##### Debates de Equipo
+##### Team Discussions
 
-* [Listar debates](/v3/teams/discussions/#list-discussions)
-* [Crear un debate](/v3/teams/discussions/#create-a-discussion)
-* [Obtener un debate](/v3/teams/discussions/#get-a-discussion)
-* [Actualizar un debate](/v3/teams/discussions/#update-a-discussion)
-* [Borrar un debate](/v3/teams/discussions/#delete-a-discussion)
-* [Listar los comentarios del debate](/v3/teams/discussion_comments/#list-discussion-comments)
-* [Crear un comentario sobre un debate](/v3/teams/discussion_comments/#create-a-discussion-comment)
-* [Obtener un comentario de un debate](/v3/teams/discussion_comments/#get-a-discussion-comment)
-* [Actualizar un comentario en un debate](/v3/teams/discussion_comments/#update-a-discussion-comment)
-* [Borrar un comentario de un debate](/v3/teams/discussion_comments/#delete-a-discussion-comment)
+* [List discussions](/v3/teams/discussions/#list-discussions)
+* [Create a discussion](/v3/teams/discussions/#create-a-discussion)
+* [Get a discussion](/v3/teams/discussions/#get-a-discussion)
+* [Update a discussion](/v3/teams/discussions/#update-a-discussion)
+* [Delete a discussion](/v3/teams/discussions/#delete-a-discussion)
+* [List discussion comments](/v3/teams/discussion_comments/#list-discussion-comments)
+* [Create a discussion comment](/v3/teams/discussion_comments/#create-a-discussion-comment)
+* [Get a discussion comment](/v3/teams/discussion_comments/#get-a-discussion-comment)
+* [Update a discussion comment](/v3/teams/discussion_comments/#update-a-discussion-comment)
+* [Delete a discussion comment](/v3/teams/discussion_comments/#delete-a-discussion-comment)
 
-##### Temas
+##### Topics
 
-* [Obtener todos los temas de un repositorio](/v3/repos#get-all-repository-topics)
-* [Reemplazar todos los temas de un repositorio](/v3/repos/#replace-all-repository-topics)
+* [Get all repository topics](/v3/repos#get-all-repository-topics)
+* [Replace all repository topics](/v3/repos/#replace-all-repository-topics)
 
 {% if currentVersion == "free-pro-team@latest" %}
-##### Tráfico
+##### Traffic
 
-* [Obtener los clones de un repositorio](/v3/repos/traffic/#get-repository-clones)
-* [Obtener las rutas de referencia superior](/v3/repos/traffic/#get-top-referral-paths)
-* [Obtener las fuentes de referencia superior](/v3/repos/traffic/#get-top-referral-sources)
-* [Obtener las visualizaciones de página](/v3/repos/traffic/#get-page-views)
+* [Get repository clones](/v3/repos/traffic/#get-repository-clones)
+* [Get top referral paths](/v3/repos/traffic/#get-top-referral-paths)
+* [Get top referral sources](/v3/repos/traffic/#get-top-referral-sources)
+* [Get page views](/v3/repos/traffic/#get-page-views)
 {% endif %}
 
 {% if currentVersion == "free-pro-team@latest" %}
-##### Bloquear Usuarios
-
-* [Listar a los usuarios que ha bloqueado el usuario autenticado](/v3/users/blocking/#list-users-blocked-by-the-authenticated-user)
-* [Verificar si el usuario autenticado bloqueó a un usuario](/v3/users/blocking/#check-if-a-user-is-blocked-by-the-authenticated-user)
-* [Listar a los usuarios que habloqueado la organización](/v3/orgs/blocking/#list-users-blocked-by-an-organization)
-* [Verificar si una organización bloqueó a un usuario](/v3/orgs/blocking/#check-if-a-user-is-blocked-by-an-organization)
-* [Bloquear a un usuario de una organización](/v3/orgs/blocking/#block-a-user-from-an-organization)
-* [Desbloquear a un usuario de una organización](/v3/orgs/blocking/#unblock-a-user-from-an-organization)
-* [Bloquear a un usuario](/v3/users/blocking/#block-a-user)
-* [Desbloquear a un usuario](/v3/users/blocking/#unblock-a-user)
+##### User Blocking
+
+* [List users blocked by the authenticated user](/v3/users/blocking/#list-users-blocked-by-the-authenticated-user)
+* [Check if a user is blocked by the authenticated user](/v3/users/blocking/#check-if-a-user-is-blocked-by-the-authenticated-user)
+* [List users blocked by an organization](/v3/orgs/blocking/#list-users-blocked-by-an-organization)
+* [Check if a user is blocked by an organization](/v3/orgs/blocking/#check-if-a-user-is-blocked-by-an-organization)
+* [Block a user from an organization](/v3/orgs/blocking/#block-a-user-from-an-organization)
+* [Unblock a user from an organization](/v3/orgs/blocking/#unblock-a-user-from-an-organization)
+* [Block a user](/v3/users/blocking/#block-a-user)
+* [Unblock a user](/v3/users/blocking/#unblock-a-user)
 {% endif %}
 
-##### Correo Electrónico de Usuario
+##### User Emails
 
 {% if currentVersion == "free-pro-team@latest" %}
-* [Configurar la visibilidad del correo electrónico principal para el usuario autenticado](/v3/users/emails/#set-primary-email-visibility-for-the-authenticated-user)
+* [Set primary email visibility for the authenticated user](/v3/users/emails/#set-primary-email-visibility-for-the-authenticated-user)
 {% endif %}
-* [Listar las direcciones de correo electrónico para el usuario autenticado](/v3/users/emails/#list-email-addresses-for-the-authenticated-user)
-* [Agregar la(s) dirección(es) de correo electrónico](/v3/users/emails/#add-an-email-address-for-the-authenticated-user)
-* [Borrar la(s) direccion(es) de correo electrónico](/v3/users/emails/#delete-an-email-address-for-the-authenticated-user)
-* [Listar las direcciones de correo electrónico del usuario autenticado](/v3/users/emails/#list-public-email-addresses-for-the-authenticated-user)
+* [List email addresses for the authenticated user](/v3/users/emails/#list-email-addresses-for-the-authenticated-user)
+* [Add email address(es)](/v3/users/emails/#add-an-email-address-for-the-authenticated-user)
+* [Delete email address(es)](/v3/users/emails/#delete-an-email-address-for-the-authenticated-user)
+* [List public email addresses for the authenticated user](/v3/users/emails/#list-public-email-addresses-for-the-authenticated-user)
 
-##### Seguidores del Usuario
+##### User Followers
 
-* [Listar los seguidores de un usuario](/v3/users/followers/#list-followers-of-a-user)
-* [Listar a las personas que sigue un usuario](/v3/users/followers/#list-the-people-a-user-follows)
-* [Revisar si el usuario autenticado sigue a una persona](/v3/users/followers/#check-if-a-person-is-followed-by-the-authenticated-user)
-* [Seguir a un usuario](/v3/users/followers/#follow-a-user)
-* [Dejar de seguri a un usuario](/v3/users/followers/#unfollow-a-user)
-* [Verificar si el usuario sigue a otro usuario](/v3/users/followers/#check-if-a-user-follows-another-user)
+* [List followers of a user](/v3/users/followers/#list-followers-of-a-user)
+* [List the people a user follows](/v3/users/followers/#list-the-people-a-user-follows)
+* [Check if a person is followed by the authenticated user](/v3/users/followers/#check-if-a-person-is-followed-by-the-authenticated-user)
+* [Follow a user](/v3/users/followers/#follow-a-user)
+* [Unfollow a user](/v3/users/followers/#unfollow-a-user)
+* [Check if a user follows another user](/v3/users/followers/#check-if-a-user-follows-another-user)
 
-##### Utilizar Llaves Gpg
+##### User Gpg Keys
 
-* [Listar las llaves GPG para el usuario autenticado](/v3/users/gpg_keys/#list-gpg-keys-for-the-authenticated-user)
-* [Crear una llave GPG para el usuario autenticado](/v3/users/gpg_keys/#create-a-gpg-key-for-the-authenticated-user)
-* [Obtener una llave GPG para el usuario autenticado](/v3/users/gpg_keys/#get-a-gpg-key-for-the-authenticated-user)
-* [Borrar una llave GPG para el usuario autenticado](/v3/users/gpg_keys/#delete-a-gpg-key-for-the-authenticated-user)
-* [Listar las llaves GPG de un usuario](/v3/users/gpg_keys/#list-gpg-keys-for-a-user)
+* [List GPG keys for the authenticated user](/v3/users/gpg_keys/#list-gpg-keys-for-the-authenticated-user)
+* [Create a GPG key for the authenticated user](/v3/users/gpg_keys/#create-a-gpg-key-for-the-authenticated-user)
+* [Get a GPG key for the authenticated user](/v3/users/gpg_keys/#get-a-gpg-key-for-the-authenticated-user)
+* [Delete a GPG key for the authenticated user](/v3/users/gpg_keys/#delete-a-gpg-key-for-the-authenticated-user)
+* [List gpg keys for a user](/v3/users/gpg_keys/#list-gpg-keys-for-a-user)
 
-##### Llaves Públicas de Usuario
+##### User Public Keys
 
-* [Listar las llaves SSH para el usuario autenticado](/v3/users/keys/#list-public-ssh-keys-for-the-authenticated-user)
-* [Crear una llave SSH para el usuario autenticado](/v3/users/keys/#create-a-public-ssh-key-for-the-authenticated-user)
-* [Obtener una llave SSH pública para el usuario autenticado](/v3/users/keys/#get-a-public-ssh-key-for-the-authenticated-user)
-* [Borrar una llave pública de SSH para el usuario autenticado](/v3/users/keys/#delete-a-public-ssh-key-for-the-authenticated-user)
-* [Listar las llaves públicas de un usuario](/v3/users/keys/#list-public-keys-for-a-user)
+* [List public SSH keys for the authenticated user](/v3/users/keys/#list-public-ssh-keys-for-the-authenticated-user)
+* [Create a public SSH key for the authenticated user](/v3/users/keys/#create-a-public-ssh-key-for-the-authenticated-user)
+* [Get a public SSH key for the authenticated user](/v3/users/keys/#get-a-public-ssh-key-for-the-authenticated-user)
+* [Delete a public SSH key for the authenticated user](/v3/users/keys/#delete-a-public-ssh-key-for-the-authenticated-user)
+* [List public keys for a user](/v3/users/keys/#list-public-keys-for-a-user)
 
-##### Usuarios
+##### Users
 
-* [Obtener al usuario autenticado](/v3/users/#get-the-authenticated-user)
-* [Listar las instalaciones de apps accesibles para el token de acceso del usuario](/v3/apps/installations/#list-app-installations-accessible-to-the-user-access-token)
+* [Get the authenticated user](/v3/users/#get-the-authenticated-user)
+* [List app installations accessible to the user access token](/v3/apps/installations/#list-app-installations-accessible-to-the-user-access-token)
 {% if currentVersion == "free-pro-team@latest" %}
-* [Listar las suscripciones del usuario autenticado](/v3/apps/marketplace/#list-subscriptions-for-the-authenticated-user)
+* [List subscriptions for the authenticated user](/v3/apps/marketplace/#list-subscriptions-for-the-authenticated-user)
 {% endif %}
-* [Listar usuarios](/v3/users/#list-users)
-* [Obtener un usuario](/v3/users/#get-a-user)
+* [List users](/v3/users/#list-users)
+* [Get a user](/v3/users/#get-a-user)
 
 {% if currentVersion == "free-pro-team@latest" %}
-##### Ejecuciones de Flujo de Trabajo
-
-* [Listar las ejecuciones de flujode trabajo de un repositorio](/v3/actions/workflow-runs/#list-workflow-runs-for-a-repository)
-* [Obtener una ejecución de flujo de trabajo](/v3/actions/workflow-runs/#get-a-workflow-run)
-* [Cancelar una ejecución de flujo de trabajo](/v3/actions/workflow-runs/#cancel-a-workflow-run)
-* [Descargar las bitácoras de ejecución de flujo de trabajo](/v3/actions/workflow-runs/#download-workflow-run-logs)
-* [Borrar las bitácoras de ejecución de flujo de trabajo](/v3/actions/workflow-runs/#delete-workflow-run-logs)
-* [Re-ejecutar un flujo de trabajo](/v3/actions/workflow-runs/#re-run-a-workflow)
-* [Listar las ejecuciones de flujo de trabajo](/v3/actions/workflow-runs/#list-workflow-runs)
-* [Obtener las estadísticas de uso de las ejecuciones de flujo de trabajo](/v3/actions/workflow-runs/#get-workflow-run-usage)
+##### Workflow Runs
+
+* [List workflow runs for a repository](/v3/actions/workflow-runs/#list-workflow-runs-for-a-repository)
+* [Get a workflow run](/v3/actions/workflow-runs/#get-a-workflow-run)
+* [Cancel a workflow run](/v3/actions/workflow-runs/#cancel-a-workflow-run)
+* [Download workflow run logs](/v3/actions/workflow-runs/#download-workflow-run-logs)
+* [Delete workflow run logs](/v3/actions/workflow-runs/#delete-workflow-run-logs)
+* [Re run a workflow](/v3/actions/workflow-runs/#re-run-a-workflow)
+* [List workflow runs](/v3/actions/workflow-runs/#list-workflow-runs)
+* [Get workflow run usage](/v3/actions/workflow-runs/#get-workflow-run-usage)
 {% endif %}
 
 {% if currentVersion == "free-pro-team@latest" %}
-##### Flujos de trabajo
+##### Workflows
 
-* [Listar los flujos de trabajo del repositorio](/v3/actions/workflows/#list-repository-workflows)
-* [Obtener un flujo de trabajo](/v3/actions/workflows/#get-a-workflow)
-* [Obtener el uso de un flujo de trabajo](/v3/actions/workflows/#get-workflow-usage)
+* [List repository workflows](/v3/actions/workflows/#list-repository-workflows)
+* [Get a workflow](/v3/actions/workflows/#get-a-workflow)
+* [Get workflow usage](/v3/actions/workflows/#get-workflow-usage)
 {% endif %}
diff --git a/translations/es-XL/content/developers/apps/scopes-for-oauth-apps.md b/translations/es-XL/content/developers/apps/scopes-for-oauth-apps.md
index 0e60fbdc9a71..ff5b4dc33152 100644
--- a/translations/es-XL/content/developers/apps/scopes-for-oauth-apps.md
+++ b/translations/es-XL/content/developers/apps/scopes-for-oauth-apps.md
@@ -1,5 +1,5 @@
 ---
-title: Alcances para las Apps de OAuth
+title: Scopes for OAuth Apps
 intro: '{% data reusables.shortdesc.understanding_scopes_for_oauth_apps %}'
 redirect_from:
   - /apps/building-integrations/setting-up-and-registering-oauth-apps/about-scopes-for-oauth-apps/
@@ -10,19 +10,19 @@ versions:
   enterprise-server: '*'
 ---
 
-Cuando estás configurando una App de OAuth en GitHub, los alcances solicitados se muestran al usuario en el formato de autorización.
+When setting up an OAuth App on GitHub, requested scopes are displayed to the user on the authorization form.
 
 {% note %}
 
-**Nota:** Si estás creando una GitHub App, no necesitas proporcionar alcances en tu solicitud de autorización. Para obtener más información sobre esto, consulta la sección "[Identificar y autorizar usuarios para las GitHub Apps](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/)".
+**Note:** If you're building a GitHub App, you don’t need to provide scopes in your authorization request. For more on this, see "[Identifying and authorizing users for GitHub Apps](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/)."
 
 {% endnote %}
 
 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}
-Si tu {% data variables.product.prodname_oauth_app %} no tiene acceso a un buscador, tal como una herramienta de CLI, entonces no necesitarás especificar un alcance para que los usuarios se autentiquen dicha app. Para obtener más información, consulta la sección "[Autorizar las Apps de OAuth](/developers/apps/authorizing-oauth-apps#device-flow)".
+If your {% data variables.product.prodname_oauth_app %} doesn't have access to a browser, such as a CLI tool, then you don't need to specify a scope for users to authenticate to your app. For more information, see "[Authorizing OAuth apps](/developers/apps/authorizing-oauth-apps#device-flow)."
 {% endif %}
 
-Verifica los encabezados para ver qué alcances de OAuth tienes, y cuáles acepta la acción de la API:
+Check headers to see what OAuth scopes you have, and what the API action accepts:
 
 ```shell
 $ curl -H "Authorization: token OAUTH-TOKEN" {% data variables.product.api_url_pre %}/users/codertocat -I
@@ -31,51 +31,52 @@ X-OAuth-Scopes: repo, user
 X-Accepted-OAuth-Scopes: user
 ```
 
-* `X-OAuth-Scopes` lista los alcances que tu token tiene autorizados.
-* `X-Accepted-OAuth-Scopes` lista los alcances que revisrá la acción.
-
-### Alcances disponibles
-
-| Nombre                   | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                          |
-| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **`(no scope)`**         | Otorga acceso de solo lectura a la información pública (incluye la información del perfil de usuario público, y los gists){% if currentVersion != "free-pro-team@latest" %}
-| **`site_admin`**         | Otorga a los administradores de sitio acceso a las [Terminales de la API para la Administración de {% data variables.product.prodname_ghe_server %}](/v3/enterprise-admin).{% endif %}
-| **`repo`**               | Otorga acceso completo a los repositorios públicos y privados. Esto incluye acceso de lectura/escritura al código, estados de las confirmaciones, proyectos de repositorio y de organización, invitaciones, colaboradores, agregar membrecías de equipo, estados de despliegue, y webhooks de repositorio para aquellos repositorios privados y públicos y para las organizaciones. También otorga la capacidad de administrar proyectos de usuario. |
-|  `repo:status`      | Otorga acceso de lectura/escritura en los estados de confirmación de los repositorios privados. Este alcance solo se necesita para otorgar a otros usuarios o servicios el acceso a los estados de las confirmaciones en repositorios privados *sin* otorgarles acceso al código.                                                                                                                                                                    |
-|  `repo_deployment`  | Otorga acceso a los [estados de despliegue](/v3/repos/deployments) para los repositorios públicos y privados. Este alcance solo se necesita para otorgar a otros usuarios o servicios el acceso a los estados de despliegue *sin* otorgarles acceso al código.                                                                                                                                                                                       |
-|  `public_repo`      | Limita el acceso a los repositorios públicos. Esto incluye el acceso de lectura/escritura al código, estados de las confirmaciones, proyectos de repositorio, colaboradores y estados de despliegue para los repositorios públicos y para las organizaciones. También se requiere para marcar a los repositorios públicos con una estrella.                                                                                                          |
-|  `repo:invite`      | Otorga capacidades de aceptar/rechazar las invitaciones para colaborar con un repositorio. Este alcance solo es necesario para otorgar a otros usuarios o servicios acceso a las invitaciones *sin* otorgar acceso al código.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21"%}
-|  `security_events`  | Otorga acceso de lectura y escritura a los eventos de seguridad en la [API de {% data variables.product.prodname_code_scanning %}](/v3/code-scanning).{% endif %}
-| **`admin:repo_hook`**    | Otorga acceso de lectura, escritura, ping y borrado a los ganchos de los repositorios privados y públicos. Los alcances `repo` y `public_repo` otorgan acceso completo a los repositorios, incluyendo a los ganchos de éstos. Utiliza el alcance `admin:repo_hook` para limitar el acceso únicamente a los ganchos de los repositorios.                                                                                                              |
-|  `write:repo_hook`  | Otorga acceso de lectura, escritura y ping a los ganchos en los repositorios públicos o privados.                                                                                                                                                                                                                                                                                                                                                    |
-|  `read:repo_hook`   | Otorga acceso de lectura y de ping a los ganchos en los repositorios privados o públicos.                                                                                                                                                                                                                                                                                                                                                            |
-| **`admin:org`**          | Para administrar totalmente la organización y sus equipos, proyectos y membrecías.                                                                                                                                                                                                                                                                                                                                                                   |
-|  `write:org`        | Acceso de lectura y escritura para la membrecía de organización y de los equipos y para los proyectos de la organización.                                                                                                                                                                                                                                                                                                                            |
-|  `read:org`         | Acceso de solo lectura para la membrecía de organización y de los equipos y para los proyectos de la organización.                                                                                                                                                                                                                                                                                                                                   |
-| **`admin:public_key`**   | Administrar totalmente las llaves públicas.                                                                                                                                                                                                                                                                                                                                                                                                          |
-|  `write:public_key` | Crear, listar y ver los detalles de las llaves públicas.                                                                                                                                                                                                                                                                                                                                                                                             |
-|  `read:public_key`  | Listar y ver los detalles para las llaves públicas.                                                                                                                                                                                                                                                                                                                                                                                                  |
-| **`admin:org_hook`**     | Otorga acceso de lectura, escritura, ping y borrado para los ganchos de la organización. **Nota:** Los tokens de OAuth solo podrán realizar estas acciones en los ganchos de la organización los cuales haya creado la App de OAuth. Los tokens de acceso personal solo podrán llevar a cabo estas acciones en los ganchos de la organización que cree un usuario.                                                                                   |
-| **`gist`**               | Otorga acceso de escritura a los gists.                                                                                                                                                                                                                                                                                                                                                                                                              |
-| **`notificaciones`**     | Otorga: 
        * acceso de lectura a las notificaciones de un usuario 
        * acceso de marcar como leído en los hilos 
        * acceso de observar y dejar de observar en un repositorio, y 
        * acceso de lectura, escritura y borrado para las suscripciones a los hilos.                                                                                                                                                     |
-| **`usuario`**            | Otorga acceso de lectura/escritura únicamente para la información de perfil.  Este alcance incluye a `user:email` y `user:follow`.                                                                                                                                                                                                                                                                                                                   |
-|  `read:user`        | Otorga acceso para leer los datos de perfil de un usuario.                                                                                                                                                                                                                                                                                                                                                                                           |
-|  `user:email`       | Otorga acceso de lectura para las direcciones de correo electrónico de un usuario.                                                                                                                                                                                                                                                                                                                                                                   |
-|  `user:follow`      | Otorga acceso para seguir o dejar de seguir a otros usuarios.                                                                                                                                                                                                                                                                                                                                                                                        |
-| **`delete_repo`**        | Otorga acceso para borrar los repositorios administrables.                                                                                                                                                                                                                                                                                                                                                                                           |
-| **`write:discussion`**   | Permite el acceso de lectura y escritura para los debates de equipo.                                                                                                                                                                                                                                                                                                                                                                                 |
-|  `read:discussion`  | Permite los accesos de lectura y escritura para los debates de equipo.{% if currentVersion == "free-pro-team@latest" %}
-| **`write:packages`**     | Otorga acceso para cargar o publicar un paquete en el {% data variables.product.prodname_registry %}. Para obtener más información, consulta la sección "[Publicar un paquete](/github/managing-packages-with-github-packages/publishing-a-package)".                                                                                                                                                                                           |
-| **`read:packages`**      | Otorga acceso para descargar o instalar paquetes desde el {% data variables.product.prodname_registry %}. Para obtener más información, consulta la sección "[Instalar un paquete](/github/managing-packages-with-github-packages/installing-a-package)".                                                                                                                                                                                       |
-| **`delete:packages`**    | Otorga acceso para borrar paquetes del {% data variables.product.prodname_registry %}. Para obtener más información, consulta la sección "[Borrar paquetes](/github/managing-packages-with-github-packages/deleting-a-package)".{% endif %}
-| **`admin:gpg_key`**      | Administra las llaves GPG totalmente.                                                                                                                                                                                                                                                                                                                                                                                                                |
-|  `write:gpg_key`    | Crea, lista, y visualiza los detalles de las llaves GPG.                                                                                                                                                                                                                                                                                                                                                                                             |
-|  `read:gpg_key`     | Lista y visualiza los detalles de las llaves GPG.{% if currentVersion == "free-pro-team@latest" %}
-| **`flujo de trabajo`**   | Otorga la capacidad de agregar y actualizar archivos del flujo de trabajo de las {% data variables.product.prodname_actions %}. Los archivos de flujo de trabajo pueden confirmarse sin este alcance en caso de que el mismo archivo (con la misma ruta y el mismo contenido) exista en otra rama en el mismo repositorio.{% endif %}
+* `X-OAuth-Scopes` lists the scopes your token has authorized.
+* `X-Accepted-OAuth-Scopes` lists the scopes that the action checks for.
+
+### Available scopes
+
+Name | Description
+-----|-----------|
+**`(no scope)`** | Grants read-only access to public information (includes public user profile info, public repository info, and gists){% if currentVersion != "free-pro-team@latest" %}
+**`site_admin`** | Grants site administrators access to [{% data variables.product.prodname_ghe_server %} Administration API endpoints](/v3/enterprise-admin).{% endif %}
+**`repo`** | Grants full access to private and public repositories. That includes read/write access to code, commit statuses, repository and organization projects, invitations, collaborators, adding team memberships, deployment statuses, and repository webhooks for public and private repositories and organizations. Also grants ability to manage user projects.
+ `repo:status`| Grants read/write access to public and private repository commit statuses. This scope is only necessary to grant other users or services access to private repository commit statuses *without* granting access to the code.
+ `repo_deployment`| Grants access to [deployment statuses](/v3/repos/deployments) for public and private repositories. This scope is only necessary to grant other users or services access to deployment statuses, *without* granting access to the code.
+ `public_repo`| Limits access to public repositories. That includes read/write access to code, commit statuses, repository projects, collaborators, and deployment statuses for public repositories and organizations. Also required for starring public repositories.
+ `repo:invite` | Grants accept/decline abilities for invitations to collaborate on a repository. This scope is only necessary to grant other users or services access to invites *without* granting access to the code.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21"%}
+ `security_events` | Grants read and write access to security events in the [{% data variables.product.prodname_code_scanning %} API](/v3/code-scanning).{% endif %}
+**`admin:repo_hook`** | Grants read, write, ping, and delete access to repository hooks in public and private repositories. The `repo` and `public_repo` scopes grants full access to repositories, including repository hooks. Use the `admin:repo_hook` scope to limit access to only repository hooks.
+ `write:repo_hook` | Grants read, write, and ping access to hooks in public or private repositories.
+ `read:repo_hook`| Grants read and ping access to hooks in public or private repositories.
+**`admin:org`** | Fully manage the organization and its teams, projects, and memberships.
+ `write:org`| Read and write access to organization membership, organization projects, and team membership.
+ `read:org`| Read-only access to organization membership, organization projects, and team membership.
+**`admin:public_key`** | Fully manage public keys.
+ `write:public_key`| Create, list, and view details for public keys.
+ `read:public_key`| List and view details for public keys.
+**`admin:org_hook`** | Grants read, write, ping, and delete access to organization hooks. **Note:** OAuth tokens will only be able to perform these actions on organization hooks which were created by the OAuth App. Personal access tokens will only be able to perform these actions on organization hooks created by a user.
+**`gist`** | Grants write access to gists.
+**`notifications`** | Grants: 
        * read access to a user's notifications 
        * mark as read access to threads 
        * watch and unwatch access to a repository, and 
        * read, write, and delete access to thread subscriptions.
+**`user`** | Grants read/write access to profile info only.  Note that this scope includes `user:email` and `user:follow`.
+ `read:user`| Grants access to read a user's profile data.
+ `user:email`| Grants read access to a user's email addresses.
+ `user:follow`| Grants access to follow or unfollow other users.
+**`delete_repo`** | Grants access to delete adminable repositories.
+**`write:discussion`** | Allows read and write access for team discussions.
+ `read:discussion` | Allows read access for team discussions.{% if currentVersion == "free-pro-team@latest" %}
+**`write:packages`** | Grants access to upload or publish a package in {% data variables.product.prodname_registry %}. For more information, see "[Publishing a package](/github/managing-packages-with-github-packages/publishing-a-package)".
+**`read:packages`** | Grants access to download or install packages from {% data variables.product.prodname_registry %}. For more information, see "[Installing a package](/github/managing-packages-with-github-packages/installing-a-package)".
+**`delete:packages`** | Grants access to delete packages from {% data variables.product.prodname_registry %}. For more information, see "[Deleting packages](/github/managing-packages-with-github-packages/deleting-a-package)".{% endif %}
+**`admin:gpg_key`** | Fully manage GPG keys.
+ `write:gpg_key`| Create, list, and view details for GPG keys.
+ `read:gpg_key`| List and view details for GPG keys.{% if currentVersion == "free-pro-team@latest" %}
+**`workflow`** | Grants the ability to add and update {% data variables.product.prodname_actions %} workflow files. Workflow files can be committed without this scope if the same file (with both the same path and contents) exists on another branch in the same repository.{% endif %}
 
 {% note %}
 
-**Nota:** Tu App de OAuth puede solicitar los alcances en la redirección inicial. Puedes especificar varios alcances si los separas con un espacio:
+**Note:** Your OAuth App can request the scopes in the initial redirection. You
+can specify multiple scopes by separating them with a space:
 
     https://github.com/login/oauth/authorize?
       client_id=...&
@@ -83,16 +84,31 @@ X-Accepted-OAuth-Scopes: user
 
 {% endnote %}
 
-### Alcances solicitados y otorgados
+### Requested scopes and granted scopes
 
-El atributo `scope` lista los alcances adjuntos al token que otorgó el usuario. Normalmente, estos alcances serán idénticos a lo que solicitaste. Sin embargo, los usuarios pueden editar sus alcances, lo cual es efectivo para otorgar a tu organización menos accesos de lo que solicitaste originalmente. También, los usuarios puede editar los alcances de los tokens después de completar un flujo de OAuth. Debes estar consciente de esta posibilidad y ajustar el comportamiento de tu aplicación de acuerdo con esto.
+The `scope` attribute lists scopes attached to the token that were granted by
+the user. Normally, these scopes will be identical to what you requested.
+However, users can edit their scopes, effectively
+granting your application less access than you originally requested. Also, users
+can edit token scopes after the OAuth flow is completed.
+You should be aware of this possibility and adjust your application's behavior
+accordingly.
 
-Es importante gestionar los casos de error en donde un usuario elige otorgarte menos acceso de lo que solicitaste originalmente. Por ejemplo, las aplicaciones pueden advertir o comunicar de cualquier otra forma a sus usuarios si experimentarán funcionalidad reducida o si serán incapaces de realizar alguna acción.
+It's important to handle error cases where a user chooses to grant you
+less access than you originally requested. For example, applications can warn
+or otherwise communicate with their users that they will see reduced
+functionality or be unable to perform some actions.
 
-También, las aplicaciones siempre pueden enviar nuevamente de regreso a los usuarios a través del flujo para obtener permisos adicionales, pero no olvides que dichos usuarios siempre pueden rehusarse a hacerlo.
+Also, applications can always send users back through the flow again to get
+additional permission, but don’t forget that users can always say no.
 
-Revisa la sección [Guía de aspectos básicos de la autenticación](/guides/basics-of-authentication/), la cual proporciona consejos sobre la gestión de alcances modificables de los tokens.
+Check out the [Basics of Authentication guide](/guides/basics-of-authentication/), which
+provides tips on handling modifiable token scopes.
 
-### Alcances normalizados
+### Normalized scopes
 
-Cuando solicites alcances múltiples, el token se guarda con una lista de alcances normalizada y descarta aquellos que se otro alcance solicitado incluya implícitamente. Por ejemplo, el solicitar `user,gist,user:email` dará como resultado un token con alcances de `user` y de `gist` únicamente, ya que el acceso que se otorga con el alcance `user:email` se incluye en el alcance `user`.
+When requesting multiple scopes, the token is saved with a normalized list
+of scopes, discarding those that are implicitly included by another requested
+scope. For example, requesting `user,gist,user:email` will result in a
+token with `user` and `gist` scopes only since the access granted with
+`user:email` scope is included in the `user` scope.
diff --git a/translations/es-XL/content/developers/webhooks-and-events/about-webhooks.md b/translations/es-XL/content/developers/webhooks-and-events/about-webhooks.md
index 11928724f1e3..64b973bcf586 100644
--- a/translations/es-XL/content/developers/webhooks-and-events/about-webhooks.md
+++ b/translations/es-XL/content/developers/webhooks-and-events/about-webhooks.md
@@ -1,6 +1,6 @@
 ---
-title: Acerca de webhooks
-intro: Aprende lo básico sobre cómo funcionan los webhooks para ayudarte a ccrear y configurar integraciones.
+title: About webhooks
+intro: Learn the basics of how webhooks work to help you build and set up integrations.
 redirect_from:
   - /webhooks
 versions:
@@ -9,26 +9,25 @@ versions:
 ---
 
 
+Webhooks allow you to build or set up integrations, such as [{% data variables.product.prodname_github_app %}s](/apps/building-github-apps/) or [{% data variables.product.prodname_oauth_app %}s](/apps/building-oauth-apps/), which subscribe to certain events on GitHub.com. When one of those events is triggered, we'll send a HTTP POST payload to the webhook's configured URL. Webhooks can be used to update an external issue tracker, trigger CI builds, update a backup mirror, or even deploy to your production server. You're only limited by your imagination.
 
-Los Webhooks te permiten crear y configurar integraciones, tales como [{% data variables.product.prodname_github_app %}](/apps/building-github-apps/) o [{% data variables.product.prodname_oauth_app %}](/apps/building-oauth-apps/), las cuales se suscriben a ciertos eventos en GitHub.com. Cuando se activa alguno de esos eventos, enviamos una carga útil de POST por HTTP a la URL que el webhook tiene configurada. Los webhooks pueden utilizarse para actualizar un rastreador de problemas externo, activar compilaciones de IC, actualizar un espejo de respaldo, o incluso para desplegar en tu servidor productivo. Solo te limita tu imaginación.
+Webhooks can be installed on{% if currentVersion != "free-pro-team@latest" %} a [{% data variables.product.prodname_ghe_server %} instance](/rest/reference/enterprise-admin#global-webhooks/),{% endif %} an [organization][org-hooks], a specific [repository][repo-hooks], or a {% data variables.product.prodname_github_app %}. Once installed, the webhook will be sent each time one or more subscribed events occurs.
 
-Los webhooks se pueden instalar en {% if currentVersion != "free-pro-team@latest" %} una [instancia de {% data variables.product.prodname_ghe_server %}](/v3/enterprise-admin/global_webhooks/),{% endif %} una[organización][org-hooks], un [repositorio][repo-hooks] específico, o una {% data variables.product.prodname_github_app %}. Una vez que se instalan, el webhook se enviará cada vez que ocurra uno o más eventos suscritos.
+You can create up to {% if currentVersion != "free-pro-team@latest" %}250{% else %}20{% endif %} webhooks for each event on each installation target {% if currentVersion != "free-pro-team@latest" %}({% data variables.product.prodname_ghe_server %} instance, specific organization, or specific repository).{% else %}(specific organization or specific repository).{% endif %}
 
-Puedes crear hasta {% if currentVersion != "free-pro-team@latest" %}250{% else %}20{% endif %} webhooks para cada evento en cada destino de instalación {% if currentVersion != "free-pro-team@latest" %}(instancia de {% data variables.product.prodname_ghe_server %}, organización específica, o repositorio específico).{% else %}(organización específica o repositorio específico).{% endif %}
-
-### Eventos
+### Events
 
 {% data reusables.webhooks.webhooks_intro %}
 
-Cada evento corresponde a conjuntos de acciones específicos que pueden suceder en tu organización y/o repositorio. Por ejemplo, si te suscribes al evento `issues`, recibirás cargas útiles detalladas cada vez que un informe de problemas se abra, cierre, etiquete, etc.
+Each event corresponds to a certain set of actions that can happen to your organization and/or repository. For example, if you subscribe to the `issues` event you'll receive detailed payloads every time an issue is opened, closed, labeled, etc.
 
-Consulta la sección "[Cargas útiles de los eventos de webhook](/webhooks/event-payloads)" para encontrar una lista de los eventos de webhook disponibles y de sus cargas útiles.
+See "[Webhook event payloads](/webhooks/event-payloads)" for the list of available webhook events and their payloads.
 
-### Evento de Ping
+### Ping event
 
 {% data reusables.webhooks.ping_short_desc %}
 
-Para obtener más información acerca de la carga útil del webhook del evento `ping`, consulta el evento [`ping`](/webhooks/event-payloads/#ping).
+For more information about the `ping` event webhook payload, see the [`ping`](/webhooks/event-payloads/#ping) event.
 
-[org-hooks]: /v3/orgs/hooks/
+[org-hooks]: /rest/reference/orgs#webhooks/
 [repo-hooks]: /v3/repos/hooks/
diff --git a/translations/es-XL/content/github/administering-a-repository/classifying-your-repository-with-topics.md b/translations/es-XL/content/github/administering-a-repository/classifying-your-repository-with-topics.md
index 49003bf35c2d..1adf59df661f 100644
--- a/translations/es-XL/content/github/administering-a-repository/classifying-your-repository-with-topics.md
+++ b/translations/es-XL/content/github/administering-a-repository/classifying-your-repository-with-topics.md
@@ -1,6 +1,6 @@
 ---
-title: Clasificar tu repositorio con temas
-intro: 'Para ayudar a otras personas a buscar y contribuir en tu proyecto, puedes agregar temas a tu repositorio relacionados con el fin previsto de tu proyecto, área temática, grupos de afinidad u otras cualidades importantes.'
+title: Classifying your repository with topics
+intro: 'To help other people find and contribute to your project, you can add topics to your repository related to your project''s intended purpose, subject area, affinity groups, or other important qualities.'
 redirect_from:
   - /articles/about-topics/
   - /articles/classifying-your-repository-with-topics
@@ -9,30 +9,36 @@ versions:
   enterprise-server: '*'
 ---
 
-### Acerca de los temas
+### About topics
 
-En el caso de los temas, puedes explorar repositorios en un área temática particular, buscar proyectos a los cuales contribuir y descubrir nuevas soluciones para un problema específico. Los temas aparecen en la página principal de un repositorio. Puedes hacer clic en el nombre de un tema para {% if currentVersion == "free-pro-team@latest" %}ver los temas relacionados y una lista de otros repositorios clasificados con ese tema{% else %}buscar otros repositorios con ese tema{% endif %}.
+With topics, you can explore repositories in a particular subject area, find projects to contribute to, and discover new solutions to a specific problem. Topics appear on the main page of a repository. You can click a topic name to {% if currentVersion == "free-pro-team@latest" %}see related topics and a list of other repositories classified with that topic{% else %}search for other repositories with that topic{% endif %}.
 
-![Página principal del repositorio de prueba que muestra temas](/assets/images/help/repository/os-repo-with-topics.png)
+![Main page of the test repository showing topics](/assets/images/help/repository/os-repo-with-topics.png)
 
-Para explorar los temas más usados, visita https://github.com/topics/.
+To browse the most used topics, go to https://github.com/topics/.
 
-{% if currentVersion == "free-pro-team@latest" %}También puedes contribuir al conjunto de temas presentados de {% data variables.product.product_name %} en el repositorio [github/explore](https://github.com/github/explore). {% endif %}
+{% if currentVersion == "free-pro-team@latest" %}You can contribute to {% data variables.product.product_name %}'s set of featured topics in the [github/explore](https://github.com/github/explore) repository. {% endif %}
 
-Los administradores del repositorio pueden agregar los temas que deseen a un repositorio. Entre los temas útiles para clasificar un repositorio se incluyen fines previstos, áreas temáticas, comunidad o idioma.{% if currentVersion == "free-pro-team@latest" %}Además, {% data variables.product.product_name %} analiza el contenido de repositorios públicos y genera temas sugeridos que los administradores de los repositorios pueden aceptar o rechazar. El contenido del repositorio privado no se analiza y no recibe sugerencias de tema.{% endif %}
+Repository admins can add any topics they'd like to a repository. Helpful topics to classify a repository include the repository's intended purpose, subject area, community, or language.{% if currentVersion == "free-pro-team@latest" %} Additionally, {% data variables.product.product_name %} analyzes public repository content and generates suggested topics that repository admins can accept or reject. Private repository content is not analyzed and does not receive topic suggestions.{% endif %}
 
-Los repositorios públicos y privados pueden tener temas, si bien solo verás los repositorios privados a los que tienes acceso en los resultados de búsqueda de temas.
+Public and private repositories can have topics, although you will only see private repositories that you have access to in topic search results.
 
-Puedes buscar los repositorios que están asociados con un tema en particular. Para obtener más información, consulta "[Buscar repositorios](/articles/searching-for-repositories/#search-by-topic)". También puedes buscar un listado de temas en {% data variables.product.product_name %}. Para obtener más información, consulta "[Buscar temas](/articles/searching-topics)".
+You can search for repositories that are associated with a particular topic. For more information, see "[Searching for repositories](/articles/searching-for-repositories#search-by-topic)." You can also search for a list of topics on {% data variables.product.product_name %}. For more information, see "[Searching topics](/articles/searching-topics)."
 
-### Agregar temas a tu repositorio
+### Adding topics to your repository
 
 {% data reusables.repositories.navigate-to-repo %}{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %}
-2. En la descripción de tu repositorio, haz clic en **Add topics** (Agregar temas). ![Enlace para agregar temas en la página principal de un repositorio](/assets/images/help/repository/add-topics-link.png)
-3. Escribe el tema que deseas agregar a tu repositorio, luego escribe un espacio. ![Formulario para ingresar temas](/assets/images/help/repository/add-topic-form.png)
-4. Cuando hayas finalizado de agregar temas, haz clic en **Done** (Listo). ![Formulario con una lista de temas y botón Done (Listo)](/assets/images/help/repository/add-topics-done-button.png)
+2. Under your repository description, click **Add topics**.
+  ![Add topics link on a repository's main page](/assets/images/help/repository/add-topics-link.png)
+3. Type the topic you want to add to your repository, then type a space.
+  ![Form to enter topics](/assets/images/help/repository/add-topic-form.png)
+4. After you've finished adding topics, click **Done**.
+  ![Form with a list of topics and Done button](/assets/images/help/repository/add-topics-done-button.png)
 {% else %}
-2. A la derecha de "Acerca de", da clic en el {% octicon "gear" aria-label="The Gear icon" %}. ![Icono de engrane en la página principal del repositorio](/assets/images/help/repository/edit-repository-details-gear.png)
-3. Debajo de "Temas", teclea el tema que quieras agregar a tu repositorio y después teclea un espacio. ![Formulario para ingresar temas](/assets/images/help/repository/add-topic-form.png)
-4. Después de que termines de agregar los temas, da clic en **Guardar cambios**. ![Botón de "Guardar cambios" en "Editar los detalles del repositorio"](/assets/images/help/repository/edit-repository-details-save-changes-button.png)
+2. To the right of "About", click {% octicon "gear" aria-label="The Gear icon" %}.
+  ![Gear icon on main page of a repository](/assets/images/help/repository/edit-repository-details-gear.png)
+3. Under "Topics", type the topic you want to add to your repository, then type a space.
+  ![Form to enter topics](/assets/images/help/repository/add-topic-form.png)
+4. After you've finished adding topics, click **Save changes**.
+  !["Save changes" button in "Edit repository details"](/assets/images/help/repository/edit-repository-details-save-changes-button.png)
 {% endif %}
diff --git a/translations/es-XL/content/github/administering-a-repository/enabling-force-pushes-to-a-protected-branch.md b/translations/es-XL/content/github/administering-a-repository/enabling-force-pushes-to-a-protected-branch.md
index eb9ba9e25a44..3cb9b4f7ebf3 100644
--- a/translations/es-XL/content/github/administering-a-repository/enabling-force-pushes-to-a-protected-branch.md
+++ b/translations/es-XL/content/github/administering-a-repository/enabling-force-pushes-to-a-protected-branch.md
@@ -1,31 +1,32 @@
 ---
-title: Habilitar subidas de información forzadas en una rama protegida
-intro: Puedes permitir subidas de información forzadas en una rama protegida.
+title: Enabling force pushes to a protected branch
+intro: You can allow force pushes to a protected branch.
 product: '{% data reusables.gated-features.protected-branches %}'
 versions:
   free-pro-team: '*'
   enterprise-server: '>=2.20'
 ---
 
-Cualquiera con permisos de administrador en un repositorio puede habilitar las subidas de información forzadas.
+Anyone with admin permissions to a repository can enable force pushes.
 
-### Acerca de las subidas de información forzadas en ramas protegidas
+### About force pushes to protected branches
 
-Predeterminadamente, las subidas de información forzadas se encuentran bloqueadas en todas las ramas protegidas. Cuando habilitas estas subidas forzadas en una rama protegida, cualquiera que tenga privilegios por lo menos de escritura en ese repositorio puede forzar la subida de información a la rama, incluyendo aquellos con permisos de administrador.
+By default, force pushes are blocked on all protected branches. When you enable force pushes to a protected branch, anyone with at least write permissions to the repository can force push to the branch, including those with admin permissions.
 
-Habilitar las subidas forzadas no invalidará ninguna otra regla de protección a la rama. Por ejemplo, si una rama requiere un historial de confirmaciones linear, no puedes forzar la subida de fusión de confirmaciones en esa rama.
+Enabling force pushes will not override any other branch protection rules. For example, if a branch requires a linear commit history, you cannot force push merge commits to that branch.
 
-{% if currentVersion != "free-pro-team@latest" %}No puedes habilitar las subidas forzadas en una rama protegida si un administrador de sitio las ha bloqueado en todas las ramas de tu repositorio. Para obtener más información, consulta "[Bloquear las subidas de información forzadas en los repositorios que sean propiedad de una organización o cuenta de usuario](/enterprise/{{ currentVersion }}/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization)."
+{% if currentVersion != "free-pro-team@latest" %}You cannot enable force pushes for a protected branch if a site administrator has blocked force pushes to all branches in your repository. For more information, see "[Blocking force pushes to repositories owned by a user account or organization](/enterprise/{{ currentVersion }}/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization)."
 
-Si un administrador de sitio ha bloqueado las subidas de información forzadas en la rama predeterminada únicamente, entonces aún puedes habilitarlas en cualquier otra rama protegida.{% endif %}
+If a site administrator has blocked force pushes to the default branch only, you can still enable force pushes for any other protected branch.{% endif %}
 
 {% data reusables.repositories.protected-branches-options %}
 
-### Habilitar subidas de información forzadas
+### Enabling force pushes
 
 {% data reusables.repositories.navigate-to-repo %}
 {% data reusables.repositories.sidebar-settings %}
 {% data reusables.repositories.repository-branches %}
 {% data reusables.repositories.add-branch-protection-rules %}
-6. Debajo de "Reglas aplicadas a todos, incluyendo administradores", selecciona **Permitir subidas de información forzadas**. ![Permitir la opción de subida de información forzada](/assets/images/help/repository/allow-force-pushes.png)
-7. Haz clic en **Create** (crear).
+6. Under "Rules applied to everyone including administrators", select **Allow force pushes**.
+![Allow force pushes option](/assets/images/help/repository/allow-force-pushes.png)
+7. Click **Create**.
diff --git a/translations/es-XL/content/github/authenticating-to-github/error-permission-denied-publickey.md b/translations/es-XL/content/github/authenticating-to-github/error-permission-denied-publickey.md
index 8e3ca115b89a..75af14ce4136 100644
--- a/translations/es-XL/content/github/authenticating-to-github/error-permission-denied-publickey.md
+++ b/translations/es-XL/content/github/authenticating-to-github/error-permission-denied-publickey.md
@@ -1,6 +1,6 @@
 ---
-title: 'Error: Permiso denegado (publickey)'
-intro: Un error de "Permiso denegado" significa que el servidor rechazó tu conexión. Esto puede suceder por varias razones. A continuación se explican los ejemplos más comunes.
+title: 'Error: Permission denied (publickey)'
+intro: 'A "Permission denied" error means that the server rejected your connection. There could be several reasons why, and the most common examples are explained below.'
 redirect_from:
   - /articles/error-permission-denied-publickey
 versions:
@@ -8,50 +8,50 @@ versions:
   enterprise-server: '*'
 ---
 
-### ¿El comando `sudo` se debe usar con Git?
+### Should the `sudo` command be used with Git?
 
-No deberías estar usando el comando `sudo` con Git. Si tienes una *muy buena razón* para usar `sudo`, asegúrate de estar usándolo con todos los comandos (probablemente es mejor que uses `su` para obtener un shell como raíz en este punto). Si [generas claves SSH](/articles/generating-an-ssh-key) sin `sudo` y luego intentas usar un comando como `sudo git push`, no estarás usando las mismas claves que generaste.
+You should not be using the `sudo` command with Git. If you have a *very good reason* you must use `sudo`, then ensure you are using it with every command (it's probably just better to use `su` to get a shell as root at that point). If you [generate SSH keys](/articles/generating-an-ssh-key) without `sudo` and then try to use a command like `sudo git push`, you won't be using the same keys that you generated.
 
-### Verifica si estás conectado al servidor correcto
+### Check that you are connecting to the correct server
 
-Escribir no es fácil. Todos los sabemos. Escribe con cuidado; no podrás conectarte con "githib.com" ni a "guthub.com". En algunos casos, una red corporativa puede generar problemas al tratar de resolver también el registro de DNS.
+Typing is hard, we all know it. Pay attention to what you type; you won't be able to connect to "githib.com" or "guthub.com". In some cases, a corporate network may cause issues resolving the DNS record as well.
 
-Para asegurarte de que te estás conectando al dominio correcto, puedes ingresar el siguiente comando:
+To make sure you are connecting to the right domain, you can enter the following command:
 
 ```shell
 $ ssh -vT git@{% data variables.command_line.codeblock %}
-> OpenSSH_5.6p1, OpenSSL 0.9.8r 8 Feb 2011
+> OpenSSH_8.1p1, LibreSSL 2.7.3
 > debug1: Reading configuration data /Users/you/.ssh/config
-> debug1: Reading configuration data /etc/ssh_config
-> debug1: Applying options for *
-> debug1: Connecting to {% data variables.command_line.codeblock %} [IP ADDRESS] port 22.
+> debug1: Reading configuration data /etc/ssh/ssh_config
+> debug1: /etc/ssh/ssh_config line 47: Applying options for *
+> debug1: Connecting to {% data variables.command_line.codeblock %} port 22.
 ```
 
-La conexión debe establecerse en el puerto 22{% if currentVersion == "free-pro-team@latest" %}, a menos que estés anulando parámetros para usar [SSH a través de HTTPS](/articles/using-ssh-over-the-https-port){% endif %}.
+The connection should be made on port 22{% if currentVersion == "free-pro-team@latest" %}, unless you're overriding settings to use [SSH over HTTPS](/articles/using-ssh-over-the-https-port){% endif %}.
 
-### Siempre usa el usuario "git"
+### Always use the "git" user
 
-Todas las conexiones, incluidas las de URL remotas, deben hacerse como el usuario "git". Si intentas conectarte con tu nombre de usuario de {% data variables.product.product_name %}, la conexión fallará:
+All connections, including those for remote URLs, must be made as the "git" user. If you try to connect with your {% data variables.product.product_name %} username, it will fail:
 
 ```shell
 $ ssh -T GITHUB-USERNAME@{% data variables.command_line.codeblock %}
 > Permission denied (publickey).
 ```
-Si tu conexión ha fallado y estás usando una URL remota con tu nombre de usuario de {% data variables.product.product_name %}, puedes [cambiar tu URL remota para usar el usuario "git"](/articles/changing-a-remote-s-url/).
+If your connection failed and you're using a remote URL with your {% data variables.product.product_name %} username, you can [change the remote URL to use the "git" user](/articles/changing-a-remote-s-url/).
 
-Para verificar tu conexión, debes escribir:
+You should verify your connection by typing:
 
 ```shell
 $ ssh -T git@{% data variables.command_line.codeblock %}
 > Hi username! You've successfully authenticated...
 ```
 
-### Asegúrate de tener una clave que esté en uso
+### Make sure you have a key that is being used
 
 {% mac %}
 
 {% data reusables.command_line.open_the_multi_os_terminal %}
-2. Verifica si tienes una llave privada generada y cargada en SSH. Si estás usando OpenSSH 6.7 o una versión anterior:
+2. Verify that you have a private key generated and loaded into SSH. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older:
   ```shell
   # start the ssh-agent in the background
   $ eval "$(ssh-agent -s)"
@@ -60,7 +60,7 @@ $ ssh -T git@{% data variables.command_line.codeblock %}
   > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA)
   ```
 
-  Si estás usando OpenSSH 6.8 o una versión más reciente:
+  If you're using OpenSSH 6.8 or newer:
   ```shell
   # start the ssh-agent in the background
   $ eval "$(ssh-agent -s)"
@@ -68,6 +68,14 @@ $ ssh -T git@{% data variables.command_line.codeblock %}
   $ ssh-add -l -E md5
   > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA)
   ```
+  {% else %}
+  ```shell
+  # start the ssh-agent in the background
+  $ eval "$(ssh-agent -s)"
+  > Agent pid 59566
+  $ ssh-add -l -E sha256
+  > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA)
+  ```{% endif %}
 
 {% endmac %}
 
@@ -78,24 +86,29 @@ $ ssh -T git@{% data variables.command_line.codeblock %}
 1. {% data reusables.desktop.windows_git_bash_turn_on_ssh_agent %}
 
   {% data reusables.desktop.windows_git_for_windows_turn_on_ssh_agent %}
-2. Verifica si tienes una llave privada generada y cargada en SSH. Si estás usando OpenSSH 6.7 o una versión anterior:
+2. Verify that you have a private key generated and loaded into SSH. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older:
   ```shell
   $ ssh-add -l
   > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA)
   ```
 
-  Si estás usando OpenSSH 6.8 o una versión más reciente:
+  If you're using OpenSSH 6.8 or newer:
   ```shell
   $ ssh-add -l -E md5
   > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA)
   ```
+  {% else %}
+  ```shell
+  $ ssh-add -l -E sha256
+  > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA)
+  ```{% endif %}
 
 {% endwindows %}
 
 {% linux %}
 
 {% data reusables.command_line.open_the_multi_os_terminal %}
-2. Verifica si tienes una llave privada generada y cargada en SSH. Si estás usando OpenSSH 6.7 o una versión anterior:
+2. Verify that you have a private key generated and loaded into SSH. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older:
   ```shell
   # start the ssh-agent in the background
   $ eval "$(ssh-agent -s)"
@@ -104,7 +117,7 @@ $ ssh -T git@{% data variables.command_line.codeblock %}
   > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA)
   ```
 
-  Si estás usando OpenSSH 6.8 o una versión más reciente:
+  If you're using OpenSSH 6.8 or newer:
   ```shell
   # start the ssh-agent in the background
   $ eval "$(ssh-agent -s)"
@@ -112,20 +125,26 @@ $ ssh -T git@{% data variables.command_line.codeblock %}
   $ ssh-add -l -E md5
   > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA)
   ```
+  {% else %}
+  ```shell
+  $ ssh-add -l -E sha256
+  > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA)
+  ```{% endif %}
+  
 
 {% endlinux %}
 
-El comando `ssh-add` *debe* imprimir una larga cadena de números y letras. Si no imprime nada, necesitarás [generar una nueva clave SSH](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) y asociarla con {% data variables.product.product_name %}.
+The `ssh-add` command *should* print out a long string of numbers and letters. If it does not print anything, you will need to [generate a new SSH key](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) and associate it with {% data variables.product.product_name %}.
 
 {% tip %}
 
-**Consejo**: En la mayoría de los sistemas las claves privadas predeterminadas (`~/.ssh/id_rsa`{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}, `~/. sh/id_dsa`{% endif %} y `~/.ssh/identity`) se añaden automáticamente al agente de autenticación SSH. No debería ser necesario que ejecutes `ssh-add path/to/key` a menos que anules el nombre del archivo cuando generes una llave.
+**Tip**: On most systems the default private keys (`~/.ssh/id_rsa` and `~/.ssh/identity`) are automatically added to the SSH authentication agent. You shouldn't need to run `ssh-add path/to/key` unless you override the file name when you generate a key.
 
 {% endtip %}
 
-#### Más detalles
+#### Getting more details
 
-Para verificar si esa llave se está usando, también puedes intentar conectarte con `git@{% data variables.command_line.backticks %}`:
+You can also check that the key is being used by trying to connect to `git@{% data variables.command_line.backticks %}`:
 
 ```shell
 $ ssh -vT git@{% data variables.command_line.codeblock %}
@@ -143,7 +162,7 @@ $ ssh -vT git@{% data variables.command_line.codeblock %}
 > Permission denied (publickey).
 ```
 
-En ese ejemplo, no teníamos ninguna llave para que usara SSH. El "-1" al final de las líneas que dicen "identity file" (identidad del archivo) significan que SSH no pudo encontrar un archivo para usar. Luego, en las líneas que indican "Trying private key" (Probando llave privada) también indica que no se encontró ningún archivo. Si existiera un archivo, esas líneas dirían "1" y "Ofreciendo llave privada", respectivamente:
+In that example, we did not have any keys for SSH to use. The "-1" at the end of the "identity file" lines means SSH couldn't find a file to use. Later on, the "Trying private key" lines also indicate that no file was found. If a file existed, those lines would be "1" and "Offering public key", respectively:
 
 ```shell
 $ ssh -vT git@{% data variables.command_line.codeblock %}
@@ -155,77 +174,89 @@ $ ssh -vT git@{% data variables.command_line.codeblock %}
 > debug1: Offering RSA public key: /Users/you/.ssh/id_rsa
 ```
 
-### Verifica si la llave pública está asociada a tu cuenta
+### Verify the public key is attached to your account
 
-Debes indicarle tu llave privada a {% data variables.product.product_name %} para establecer una conexión segura.
+You must provide your public key to {% data variables.product.product_name %} to establish a secure connection.
 
 {% mac %}
 
-1. Abre Terminal.
-2. Inicia el agente SSH en segundo plano.
+1. Open Terminal.
+2. Start SSH agent in the background.
   ```shell
   $ eval "$(ssh-agent -s)"
   > Agent pid 59566
   ```
-3. Busca tu huella digital de llave pública y anótala. Si estás usando OpenSSH 6.7 o una versión anterior:
+3. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older:
   ```shell
   $ ssh-add -l
   > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA)
   ```
 
-  Si estás usando OpenSSH 6.8 o una versión más reciente:
+  If you're using OpenSSH 6.8 or newer:
   ```shell
   $ ssh-add -l -E md5
   > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA)
   ```
+  {% else %}
+  ```shell
+  $ ssh-add -l -E sha256
+  > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA)
+  ```{% endif %}
 
 {% data reusables.user_settings.access_settings %}
 {% data reusables.user_settings.ssh %}
-6. Compara la lista de claves SSH con el resultado que arroja el comando `ssh-add`. ![Lista de claves SSH en {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png)
+6. Compare the list of SSH keys with the output from the `ssh-add` command.
+![SSH key listing in {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png)
 
 {% endmac %}
 
 {% windows %}
 
-1. Abre la línea de comando.
-2. Inicia el agente SSH en segundo plano.
+1. Open the command line.
+2. Start SSH agent in the background.
   ```shell
   $ ssh-agent -s
   > Agent pid 59566
   ```
-3. Busca tu huella digital de llave pública y anótala. Si estás usando OpenSSH 6.7 o una versión anterior:
+3. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older:
   ```shell
   $ ssh-add -l
   > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA)
   ```
 
-  Si estás usando OpenSSH 6.8 o una versión más reciente:
+  If you're using OpenSSH 6.8 or newer:
   ```shell
   $ ssh-add -l -E md5
   > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA)
   ```
+  {% else %}
+  ```shell
+  $ ssh-add -l -E sha256
+  > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA)
+  ```{% endif %}
 
 {% data reusables.user_settings.access_settings %}
 {% data reusables.user_settings.ssh %}
-6. Compara la lista de claves SSH con el resultado que arroja el comando `ssh-add`. ![Lista de claves SSH en {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png)
+6. Compare the list of SSH keys with the output from the `ssh-add` command.
+![SSH key listing in {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png)
 
 {% endwindows %}
 
 {% linux %}
 
-1. Abre Terminal.
-2. Inicia el agente SSH en segundo plano.
+1. Open Terminal.
+2. Start SSH agent in the background.
   ```shell
   $ eval "$(ssh-agent -s)"
   > Agent pid 59566
   ```
-3. Busca tu huella digital de llave pública y anótala. Si estás usando OpenSSH 6.7 o una versión anterior:
+3. Find and take a note of your public key fingerprint. If you're using OpenSSH 6.7 or older:
   ```shell
   $ ssh-add -l
   > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA)
   ```
 
-  Si estás usando OpenSSH 6.8 o una versión más reciente:
+  If you're using OpenSSH 6.8 or newer:
   ```shell
   $ ssh-add -l -E md5
   > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA)
@@ -233,14 +264,15 @@ Debes indicarle tu llave privada a {% data variables.product.product_name %} par
 
 {% data reusables.user_settings.access_settings %}
 {% data reusables.user_settings.ssh %}
-6. Compara la lista de claves SSH con el resultado que arroja el comando `ssh-add`. ![Lista de claves SSH en {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png)
+6. Compare the list of SSH keys with the output from the `ssh-add` command.
+![SSH key listing in {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png)
 
 {% endlinux %}
 
-Si no ves tu llave pública en {% data variables.product.product_name %}, será necesario que [agregues tu clave SSH a {% data variables.product.product_name %}](/articles/adding-a-new-ssh-key-to-your-github-account) para asociarla con tu computadora.
+If you don't see your public key in {% data variables.product.product_name %}, you'll need to [add your SSH key to {% data variables.product.product_name %}](/articles/adding-a-new-ssh-key-to-your-github-account) to associate it with your computer.
 
 {% warning %}
 
-**Advertencia**: Si ves una clave SSH que no te resulta familiar en {% data variables.product.product_name %}, elimínala de inmediato y contáctate con {% data variables.contact.contact_support %} para recibir más ayuda. Una llave pública no identificada puede indicar un posible problema de seguridad. Para obtener más información, consulta "[Revisar tus claves SSH](/articles/reviewing-your-ssh-keys)".
+**Warning**: If you see an SSH key you're not familiar with on {% data variables.product.product_name %}, delete it immediately and contact {% data variables.contact.contact_support %}, for further help. An unidentified public key may indicate a possible security concern. For more information, see "[Reviewing your SSH keys](/articles/reviewing-your-ssh-keys)."
 
 {% endwarning %}
diff --git a/translations/es-XL/content/github/authenticating-to-github/reviewing-your-security-log.md b/translations/es-XL/content/github/authenticating-to-github/reviewing-your-security-log.md
index f2a2abf59624..38e933477191 100644
--- a/translations/es-XL/content/github/authenticating-to-github/reviewing-your-security-log.md
+++ b/translations/es-XL/content/github/authenticating-to-github/reviewing-your-security-log.md
@@ -1,6 +1,6 @@
 ---
-title: Revisar tu registro de seguridad
-intro: 'Puedes revisar el registro de seguridad de tu cuenta de usuario para entender mejor las acciones que has realizado y las que otros han realizado, las cuales te involucran.'
+title: Reviewing your security log
+intro: You can review the security log for your user account to better understand actions you've performed and actions others have performed that involve you.
 redirect_from:
   - /articles/reviewing-your-security-log
 versions:
@@ -8,233 +8,238 @@ versions:
   enterprise-server: '*'
 ---
 
-### Acceder a tu registro de seguridad
+### Accessing your security log
 
-El registro de seguridad lista todas las acciones realizadas en los últimos 90 días{% if currentVersion ver_lt "enterprise-server@2.20" %}, hasta 50{% endif %}.
+The security log lists all actions performed within the last 90 days{% if currentVersion ver_lt "enterprise-server@2.20" %}, up to 50{% endif %}.
 
 {% data reusables.user_settings.access_settings %}
 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}
-2. En la barra lateral de la configuración de usuario, da clic en **Registro de Seguridad**. ![Pestaña de registro de seguridad](/assets/images/help/settings/audit-log-tab.png)
+2. In the user settings sidebar, click **Security log**.
+  ![Security log tab](/assets/images/help/settings/audit-log-tab.png)
 {% else %}
 {% data reusables.user_settings.security %}
-3. En "Security history" (Historial de seguridad) se muestra tu registro. ![Registro de seguridad](/assets/images/help/settings/user_security_log.png)
-4. Haz clic en la entrada para ver más información acerca del evento. ![Registro de seguridad](/assets/images/help/settings/user_security_history_action.png)
+3. Under "Security history," your log is displayed.
+  ![Security log](/assets/images/help/settings/user_security_log.png)
+4. Click on an entry to see more information about the event.
+  ![Security log](/assets/images/help/settings/user_security_history_action.png)
 {% endif %}
 
 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}
-### Buscar tu registro de seguridad
+### Searching your security log
 
 {% data reusables.audit_log.audit-log-search %}
 
-#### Búsqueda basada en la acción realizada
+#### Search based on the action performed
 {% else %}
-### Entender los eventos en tu registro de seguridad
-
-Las acciones listadas en tu registro de seguridad se agrupan dentro de las siguientes categorías |{% endif %}
-| Nombre de la categoría            | Descripción                                                                                                                                                                                                                                                                                                                                                                                                          |
-| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" %}
-| `account_recovery_token`          | Contiene todas las actividades relacionadas con [agregar un token de recuperación](/articles/configuring-two-factor-authentication-recovery-methods).                                                                                                                                                                                                                                                                |
-| `facturación`                     | Contiene todas las actividades relacionadas con tu información de facturación.                                                                                                                                                                                                                                                                                                                                       |
-| `marketplace_agreement_signature` | Contiene todas las actividades relacionadas con la firma del Acuerdo del programador de {% data variables.product.prodname_marketplace %}.                                                                                                                                                                                                                                                                      |
-| `marketplace_listing`             | Contiene todas las actividades relacionadas con el listado de aplicaciones en {% data variables.product.prodname_marketplace %}.{% endif %}
-| `oauth_access`                    | Contiene todas las actividades relacionadas con las [{% data variables.product.prodname_oauth_app %}s](/articles/authorizing-oauth-apps) con las que te hayas conectado.{% if currentVersion == "free-pro-team@latest" %}
-| `payment_method`                  | Contiene todas las actividades relacionadas con el pago de tu suscripción de {% data variables.product.prodname_dotcom %}.{% endif %}
-| `profile_picture`                 | Contiene todas las actividades relacionadas con tu foto de perfil.                                                                                                                                                                                                                                                                                                                                                   |
-| `project`                         | Contiene todas las actividades relacionadas con los tableros de proyecto.                                                                                                                                                                                                                                                                                                                                            |
-| `public_key`                      | Contiene todas las actividades relacionadas con [tus claves SSH públicas](/articles/adding-a-new-ssh-key-to-your-github-account).                                                                                                                                                                                                                                                                                    |
-| `repo`                            | Contiene todas las actividades relacionadas con los repositorios que te pertenecen.{% if currentVersion == "free-pro-team@latest" %}
-| `sponsors`                        | Contiene todos los eventos relacionados con los {% data variables.product.prodname_sponsors %} y los botones de patrocinadores (consulta "[Acerca de los {% data variables.product.prodname_sponsors %}](/articles/about-github-sponsors)" y "[Mostrar un botón de patrocinador en tu repositorio](/articles/displaying-a-sponsor-button-in-your-repository)"){% endif %}{% if currentVersion != "free-pro-team@latest" %}
-| `equipo`                          | Contiene todas las actividades relacionadas con los equipos de los que eres parte.{% endif %}
-| `two_factor_authentication`       | Contiene todas las actividades relacionadas con la [autenticación de dos factores](/articles/securing-your-account-with-two-factor-authentication-2fa).                                                                                                                                                                                                                                                              |
-| `usuario`                         | Contiene todas las actividades relacionadas con tu cuenta.                                                                                                                                                                                                                                                                                                                                                           |
-
-A continuación se detalla una descripción de los eventos dentro de estas categorías.
+### Understanding events in your security log
+
+Actions listed in your security log are grouped within the following categories:
+{% endif %}
+
+| Category Name | Description
+|------------------|-------------------{% if currentVersion == "free-pro-team@latest" %}
+| `account_recovery_token` | Contains all activities related to [adding a recovery token](/articles/configuring-two-factor-authentication-recovery-methods).
+| `billing` | Contains all activities related to your billing information.
+| `marketplace_agreement_signature` | Contains all activities related to signing the {% data variables.product.prodname_marketplace %} Developer Agreement.
+| `marketplace_listing` | Contains all activities related to listing apps in {% data variables.product.prodname_marketplace %}.{% endif %}
+| `oauth_access` | Contains all activities related to [{% data variables.product.prodname_oauth_app %}s](/articles/authorizing-oauth-apps) you've connected with.{% if currentVersion == "free-pro-team@latest" %}
+| `payment_method` | Contains all activities related to paying for your {% data variables.product.prodname_dotcom %} subscription.{% endif %}
+| `profile_picture` | Contains all activities related to your profile picture.
+| `project` | Contains all activities related to project boards.
+| `public_key` | Contains all activities related to [your public SSH keys](/articles/adding-a-new-ssh-key-to-your-github-account).
+| `repo` | Contains all activities related to the repositories you own.{% if currentVersion == "free-pro-team@latest" %}
+| `sponsors` | Contains all events related to {% data variables.product.prodname_sponsors %} and sponsor buttons (see "[About {% data variables.product.prodname_sponsors %}](/articles/about-github-sponsors)" and "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)"){% endif %}{% if currentVersion != "free-pro-team@latest" %}
+| `team` | Contains all activities related to teams you are a part of.{% endif %}
+| `two_factor_authentication` | Contains all activities related to [two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa).
+| `user` | Contains all activities related to your account.
+
+A description of the events within these categories is listed below.
 
 {% if currentVersion == "free-pro-team@latest" %}
 
-#### La categoría de `account_recovery_token` (token de recuperación de cuenta)
+#### The `account_recovery_token` category
 
-| Acción                                | Descripción                                                                                                                                               |
-| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| confirm (confirmar)                   | Se activa cuando almacenas [con éxito un nuevo token con un proveedor de recuperación](/articles/configuring-two-factor-authentication-recovery-methods). |
-| recover (recuperar)                   | Se activa cuando canjeas [con éxito un token de recuperación de cuenta](/articles/recovering-your-account-if-you-lose-your-2fa-credentials).              |
-| recover_error (error de recuperación) | Se activa cuando se utiliza un token, pero {% data variables.product.prodname_dotcom %} no está disponible para validarlo.                           |
+| Action | Description
+|------------------|-------------------
+| confirm | Triggered when you successfully [store a new token with a recovery provider](/articles/configuring-two-factor-authentication-recovery-methods).
+| recover | Triggered when you successfully [redeem an account recovery token](/articles/recovering-your-account-if-you-lose-your-2fa-credentials).
+| recover_error | Triggered when a token is used but {% data variables.product.prodname_dotcom %} is not able to validate it.
 
-#### La categoría de `billing` (facturación)
+#### The `billing` category
 
-| Acción                                              | Descripción                                                                                                                                         |
-| --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
-| change_billing_type (cambiar tipo de facturación) | Se activa cuando [cambias la manera de pagar](/articles/adding-or-editing-a-payment-method) para {% data variables.product.prodname_dotcom %}. |
-| change_email (cambiar correo electrónico)           | Se activa cuando [cambias tu dirección de correo electrónico](/articles/changing-your-primary-email-address).                                       |
+| Action | Description
+|------------------|-------------------
+| change_billing_type | Triggered when you [change how you pay](/articles/adding-or-editing-a-payment-method) for {% data variables.product.prodname_dotcom %}.
+| change_email | Triggered when you [change your email address](/articles/changing-your-primary-email-address).
 
-#### La categoría de `marketplace_agreement_signature` (firma del acuerdo de mercado)
+#### The `marketplace_agreement_signature` category
 
-| Acción         | Descripción                                                                                                |
-| -------------- | ---------------------------------------------------------------------------------------------------------- |
-| create (crear) | Se activa cuando firmas el {% data variables.product.prodname_marketplace %} Acuerdo del programador. |
+| Action | Description
+|------------------|-------------------
+| create | Triggered when you sign the {% data variables.product.prodname_marketplace %} Developer Agreement.
 
-#### La categoría de `marketplace_listing` (lista de mercado)
+#### The `marketplace_listing` category
 
-| Acción                      | Descripción                                                                                                         |
-| --------------------------- | ------------------------------------------------------------------------------------------------------------------- |
-| aprobar                     | Se activa cuando se aprueba tu lista para ser incluida en {% data variables.product.prodname_marketplace %}.   |
-| create (crear)              | Se activa cuando creas una lista para tu app en {% data variables.product.prodname_marketplace %}.             |
-| delist (quitar de la lista) | Se activa cuando se elimina tu lista de {% data variables.product.prodname_marketplace %}.                     |
-| redraft (reformular)        | Se activa cuando tu lista se vuelve a colocar en estado de borrador.                                                |
-| reject (rechazar)           | Se activa cuando no se acepta tu lista para ser incluida en {% data variables.product.prodname_marketplace %}. |
+| Action | Description
+|------------------|-------------------
+| approve | Triggered when your listing is approved for inclusion in {% data variables.product.prodname_marketplace %}.
+| create | Triggered when you create a listing for your app in {% data variables.product.prodname_marketplace %}.
+| delist | Triggered when your listing is removed from {% data variables.product.prodname_marketplace %}.
+| redraft | Triggered when your listing is sent back to draft state.
+| reject | Triggered when your listing is not accepted for inclusion in {% data variables.product.prodname_marketplace %}.
 
 {% endif %}
 
-#### La categoría de `oauth_access` (acceso oauth)
+#### The `oauth_access` category
 
-| Acción             | Descripción                                                                                                                                                       |
-| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| create (crear)     | Se activa cuando [otorgas acceso a una {% data variables.product.prodname_oauth_app %}](/articles/authorizing-oauth-apps).                                 |
-| destroy (destruir) | Se activa cuando [revocas el acceso de una {% data variables.product.prodname_oauth_app %} a tu cuenta](/articles/reviewing-your-authorized-integrations). |
+| Action | Description
+|------------------|-------------------
+| create | Triggered when you [grant access to an {% data variables.product.prodname_oauth_app %}](/articles/authorizing-oauth-apps).
+| destroy | Triggered when you [revoke an {% data variables.product.prodname_oauth_app %}'s access to your account](/articles/reviewing-your-authorized-integrations).
 
 {% if currentVersion == "free-pro-team@latest" %}
 
-#### La categoría de `payment_method` (método de pago)
+#### The `payment_method` category
 
-| Acción           | Descripción                                                                                                   |
-| ---------------- | ------------------------------------------------------------------------------------------------------------- |
-| clear (eliminar) | Se activa cuando se elimina [un método de pago](/articles/removing-a-payment-method) archivado.               |
-| create (crear)   | Se activa cuando se agrega un nuevo método de pago, como una tarjeta de crédito o una cuenta de PayPal nueva. |
-| actualización    | Se activa cuando se actualiza un método de pago existente.                                                    |
+| Action | Description
+|------------------|-------------------
+| clear | Triggered when [a payment method](/articles/removing-a-payment-method) on file is removed.
+| create | Triggered when a new payment method is added, such as a new credit card or PayPal account.
+| update | Triggered when an existing payment method is updated.
 
 {% endif %}
 
-#### La categoría de `profile_picture` (foto de perfil)
-
-| Acción        | Descripción                                                                                            |
-| ------------- | ------------------------------------------------------------------------------------------------------ |
-| actualización | Se activa cuando [estableces o actualizas tu foto de perfil](/articles/setting-your-profile-picture/). |
-
-#### La categoría de `project` (proyecto)
-
-| Acción                                                   | Descripción                                                                                                               |
-| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
-| `create (crear)`                                         | Se activa cuando se crear un tablero de proyecto.                                                                         |
-| `rename (renombrar)`                                     | Se activa cuando se renombra un tablero de proyecto.                                                                      |
-| `actualización`                                          | Se activa cuando se actualiza un tablero de proyecto.                                                                     |
-| `eliminar`                                               | Se activa cuando se elimina un tablero de proyecto.                                                                       |
-| `enlace`                                                 | Se activa cuando un repositorio se vincula a un tablero de proyecto.                                                      |
-| `unlink (desvincular)`                                   | Se activa cuando se anula el enlace a un repositorio desde un tablero de proyecto.                                        |
-| `project.access`                                         | Se activa cuando se modifica la visibilidad de un tablero de proyecto.                                                    |
-| `update_user_permission (actualizar permiso de usuario)` | Triggered when an outside collaborator is added to or removed from a project board or has their permission level changed. |
-
-#### La categoría de `public_key` (clave pública)
-
-| Acción         | Descripción                                                                                                                                                         |
-| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| create (crear) | Se activa cuando [agregas una clave SSH pública a tu {% data variables.product.product_name %} cuenta](/articles/adding-a-new-ssh-key-to-your-github-account). |
-| eliminar       | Se activa cuando [eliminas una clave SSH pública para tu {% data variables.product.product_name %} cuenta](/articles/reviewing-your-ssh-keys).                 |
-
-#### La categoría de `repo`
-
-| Acción                                                                                  | Descripción                                                                                                                                                                                                                                                                                                                                               |
-| --------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| access (acceder)                                                                        | Se activa cuando un repositorio que te pertenece se [cambia de "privado" a "público"](/articles/making-a-private-repository-public) (o viceversa).                                                                                                                                                                                                        |
-| add_member (agregar miembro)                                                            | Se activa cuando se invita a un {% data variables.product.product_name %} usuario {% if currentVersion == "free-pro-team@latest" %}[a tener acceso de colaboración](/articles/inviting-collaborators-to-a-personal-repository){% else %}[otorgado el acceso de colaboración](/articles/inviting-collaborators-to-a-personal-repository){% endif %} a un repositorio. |
-| add_topic (agregar tema)                                                                | Se activa cuando un propietario del repositorio [agrega un tema](/articles/classifying-your-repository-with-topics) a un repositorio.                                                                                                                                                                                                                     |
-| archived (archivado)                                                                    | Se activa cuando un propietario del repositorio [archiva un repositorio](/articles/about-archiving-repositories).{% if currentVersion != "free-pro-team@latest" %}
-| config.disable_anonymous_git_access (configurar inhabilitar el acceso de git anónimo) | Se activa cuando [se inhabilita el acceso de lectura de Git anónimo](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) en un repositorio público.                                                                                                                                                         |
-| config.enable_anonymous_git_access (configurar habilitar acceso de git anónimo)       | Se activa cuando [se habilita el acceso de lectura de Git anónimo](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) en un repositorio público.                                                                                                                                                           |
-| config.lock_anonymous_git_access (configurar bloquear acceso de git anónimo)          | Se activa cuando se bloquea el parámetro de acceso de lectura de Git anónimo [de un repositorio](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access).                                                                                                                                   |
-| config.unlock_anonymous_git_access (configurar desbloquear acceso de git anónimo)     | Se activa cuando se desbloquea el parámetro de acceso de lectura de Git anónimo [de un repositorio](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access).{% endif %}
-| create (crear)                                                                          | Se activa cuando [se crea un repositorio nuevo](/articles/creating-a-new-repository).                                                                                                                                                                                                                                                                     |
-| destroy (destruir)                                                                      | Se activa cuando [se elimina un repositorio](/articles/deleting-a-repository).{% if currentVersion == "free-pro-team@latest" %}
-| inhabilitar                                                                             | Se activa cuando se inhabilita un repositorio (p. ej., por [fondos insuficientes](/articles/unlocking-a-locked-account)).{% endif %}{% if currentVersion == "free-pro-team@latest" %}
-| habilitar                                                                               | Se activa cuando se vuelve a habilitar un repositorio.{% endif %}
-| remove_member (eliminar miembro)                                                        | Se activa cuando se elimina {% data variables.product.product_name %} un usuario [de un repositorio como colaborador](/articles/removing-a-collaborator-from-a-personal-repository).                                                                                                                                                                 |
-| remove_topic (eliminar tema)                                                            | Se activa cuando un propietario del repositorio elimina un tema de un repositorio.                                                                                                                                                                                                                                                                        |
-| rename (renombrar)                                                                      | Se activa cuando [se renombra un repositorio](/articles/renaming-a-repository).                                                                                                                                                                                                                                                                           |
-| transferencia                                                                           | Se activa cuando [se transfiere un repositorio](/articles/how-to-transfer-a-repository).                                                                                                                                                                                                                                                                  |
-| transfer_start (comienzo de transferencia)                                              | Se activa cuando está por ocurrir una transferencia de repositorio.                                                                                                                                                                                                                                                                                       |
-| unarchived (desarchivado)                                                               | Se activa cuando un administrador del repositorio desarchiva un repositorio.                                                                                                                                                                                                                                                                              |
+#### The `profile_picture` category
+
+| Action | Description
+|------------------|-------------------
+| update | Triggered when you [set or update your profile picture](/articles/setting-your-profile-picture/).
+
+#### The `project` category
+
+| Action | Description
+|--------------------|---------------------
+| `create` | Triggered when a project board is created.
+| `rename` | Triggered when a project board is renamed.
+| `update` | Triggered when a project board is updated.
+| `delete` | Triggered when a project board is deleted.
+| `link`   | Triggered when a repository is linked to a project board.
+| `unlink` | Triggered when a repository is unlinked from a project board.
+| `project.access` | Triggered when a project board's visibility is changed.
+| `update_user_permission` | Triggered when an outside collaborator is added to or removed from a project board or has their permission level changed.
+
+#### The `public_key` category
+
+| Action | Description
+|------------------|-------------------
+| create | Triggered when you [add a new public SSH key to your {% data variables.product.product_name %} account](/articles/adding-a-new-ssh-key-to-your-github-account).
+| delete | Triggered when you [remove a public SSH key to your {% data variables.product.product_name %} account](/articles/reviewing-your-ssh-keys).
+
+#### The `repo` category
+
+| Action | Description
+|------------------|-------------------
+| access | Triggered when you a repository you own is [switched from "private" to "public"](/articles/making-a-private-repository-public) (or vice versa).
+| add_member | Triggered when a {% data variables.product.product_name %} user is {% if currentVersion == "free-pro-team@latest" %}[invited to have collaboration access](/articles/inviting-collaborators-to-a-personal-repository){% else %}[given collaboration access](/articles/inviting-collaborators-to-a-personal-repository){% endif %} to a repository.
+| add_topic | Triggered when a repository owner [adds a topic](/articles/classifying-your-repository-with-topics) to a repository.
+| archived | Triggered when a repository owner [archives a repository](/articles/about-archiving-repositories).{% if currentVersion != "free-pro-team@latest" %}
+| config.disable_anonymous_git_access | Triggered when [anonymous Git read access is disabled](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) in a public repository.
+| config.enable_anonymous_git_access | Triggered when [anonymous Git read access is enabled](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) in a public repository.
+| config.lock_anonymous_git_access | Triggered when a repository's [anonymous Git read access setting is locked](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access).
+| config.unlock_anonymous_git_access | Triggered when a repository's [anonymous Git read access setting is unlocked](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access).{% endif %}
+| create | Triggered when [a new repository is created](/articles/creating-a-new-repository).
+| destroy |  Triggered when [a repository is deleted](/articles/deleting-a-repository).{% if currentVersion == "free-pro-team@latest" %}
+| disable | Triggered when a repository is disabled (e.g., for [insufficient funds](/articles/unlocking-a-locked-account)).{% endif %}{% if currentVersion == "free-pro-team@latest" %}
+| enable | Triggered when a repository is re-enabled.{% endif %}
+| remove_member | Triggered when a {% data variables.product.product_name %} user is [removed from a repository as a collaborator](/articles/removing-a-collaborator-from-a-personal-repository).
+| remove_topic | Triggered when a repository owner removes a topic from a repository.
+| rename | Triggered when [a repository is renamed](/articles/renaming-a-repository).
+| transfer | Triggered when [a repository is transferred](/articles/how-to-transfer-a-repository).
+| transfer_start | Triggered when a repository transfer is about to occur.
+| unarchived | Triggered when a repository owner unarchives a repository.
 
 {% if currentVersion == "free-pro-team@latest" %}
-#### La categoría de `sponsors` (patrocinadores)
-
-| Acción                                                                                                              | Descripción                                                                                                                                                                                                                                                                                                                                                 |
-| ------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| repo_funding_link_button_toggle (alternar botón de enlace al financiamiento del repositorio)                    | Se activa cuando habilitas o inhabilitas un botón de patrocinador en tu repositorio (consulta "[Mostrar un botón de patrocinador en tu repositorio](/articles/displaying-a-sponsor-button-in-your-repository)")                                                                                                                                             |
-| repo_funding_links_file_action (acción de archivo de enlaces de financiamiento del repositorio)                 | Se activa cuando cambias el archivo FUNDING de tu repositorio (consulta "[Mostrar un botón de patrocinador en tu repositorio](/articles/displaying-a-sponsor-button-in-your-repository)")                                                                                                                                                                   |
-| sponsor_sponsorship_cancel (cancelación del patrocinio del patrocinador)                                          | Se activa cuando cancelas un patrocinio (consulta "[Bajar de categoría un patrocinio](/articles/downgrading-a-sponsorship)")                                                                                                                                                                                                                                |
-| sponsor_sponsorship_create (creación de un patrocinio de patrocinador)                                            | Desencadenada cuando patrocinas a un desarrollador (consulta "[Patrocinar a un colaborador de código abierto](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor#sponsoring-a-developer)")                                                                                                             |
-| sponsor_sponsorship_preference_change (cambio de preferencia de patrocinio de patrocinador)                       | Se activa cuando cambias si deseas recibir actualizaciones por correo electrónico de un programador patrocinado (consulta "[Administrar tu patrocinio](/articles/managing-your-sponsorship)")                                                                                                                                                               |
-| sponsor_sponsorship_tier_change (cambiar nivel de patrocinio de patrocinador)                                     | Se activa cuando subes o bajas de categoría tu patrocinio (consulta "[Subir de categoría un patrocinio](/articles/upgrading-a-sponsorship)" y "[Bajar de categoría un patrocinio](/articles/downgrading-a-sponsorship)")                                                                                                                                    |
-| sponsored_developer_approve (aprobación de programador patrocinado)                                               | Desencadenado cuando se aprueba tu cuenta de {% data variables.product.prodname_sponsors %} (consulta "[Configuración {% data variables.product.prodname_sponsors %} para tu cuenta de usuario](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)")                             |
-| sponsored_developer_create (creación de programador patrocinado)                                                  | Desencadenado cuando se crea tu cuenta de {% data variables.product.prodname_sponsors %} (consulta "[Configuración de {% data variables.product.prodname_sponsors %} para tu cuenta de usuario](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)")                             |
-| sponsored_developer_profile_update (actualización del perfil de programador patrocinado)                          | Desencadenado cuando editas el perfil de tu desarrollador patrocinado (consulta "[Editar tus detalles de perfil para {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors)")                                                             |
-| sponsored_developer_request_approval (aprobación de solicitud de programador patrocinado)                         | Desencadenado cuando emites tu aplicación para {% data variables.product.prodname_sponsors %} para su aprobación (consulta "[Configuración {% data variables.product.prodname_sponsors %} pára tu cuenta de usuario](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)")        |
-| sponsored_developer_tier_description_update (actualización de descripción del nivel de programador patrocinado) | Se activa cuando cambias la descripción de un nivel de patrocinio (consulta "[Cambiar tus niveles de patrocinio](/articles/changing-your-sponsorship-tiers)")                                                                                                                                                                                               |
-| sponsored_developer_update_newsletter_send (envío de boletín de actualización del programador patrocinado)      | Se activa cuando envías una actualización de correo electrónico a tus patrocinadores (consulta "[Contactar a tus patrocinadores](/articles/contacting-your-sponsors)")                                                                                                                                                                                      |
-| waitlist_invite_sponsored_developer (invitación a la lista de espera de programadores patrocinados)               | Desencadenado cuando se te invita a unirte a {% data variables.product.prodname_sponsors %} desde la lista de espera (consulta "[Configuración de {% data variables.product.prodname_sponsors %} para tu cuenta de usuario](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") |
-| waitlist_join (incorporación a la lista de espera)                                                                  | Desencadenado cuando te unes a la lista de espera para convertirte en un desarrollador patrocinado (consulta "[Configuración de {% data variables.product.prodname_sponsors %} para tu cuenta de usuario](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)")                        |
+#### The `sponsors` category
+
+| Action | Description
+|------------------|-------------------
+| repo_funding_link_button_toggle | Triggered when you enable or disable a sponsor button in your repository (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)")
+| repo_funding_links_file_action | Triggered when you change the FUNDING file in your repository (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)")
+| sponsor_sponsorship_cancel | Triggered when you cancel a sponsorship (see "[Downgrading a sponsorship](/articles/downgrading-a-sponsorship)")
+| sponsor_sponsorship_create | Triggered when you sponsor a developer (see "[Sponsoring an open source contributor](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor#sponsoring-a-developer)")
+| sponsor_sponsorship_preference_change | Triggered when you change whether you receive email updates from a sponsored developer (see "[Managing your sponsorship](/articles/managing-your-sponsorship)")
+| sponsor_sponsorship_tier_change | Triggered when you upgrade or downgrade your sponsorship (see "[Upgrading a sponsorship](/articles/upgrading-a-sponsorship)" and "[Downgrading a sponsorship](/articles/downgrading-a-sponsorship)")
+| sponsored_developer_approve | Triggered when your {% data variables.product.prodname_sponsors %} account is approved (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)")
+| sponsored_developer_create | Triggered when your {% data variables.product.prodname_sponsors %} account is created (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)")
+| sponsored_developer_profile_update | Triggered when you edit your sponsored developer profile (see "[Editing your profile details for {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors)")
+| sponsored_developer_request_approval | Triggered when you submit your application for {% data variables.product.prodname_sponsors %} for approval (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)")
+| sponsored_developer_tier_description_update | Triggered when you change the description for a sponsorship tier (see "[Changing your sponsorship tiers](/articles/changing-your-sponsorship-tiers)")
+| sponsored_developer_update_newsletter_send | Triggered when you send an email update to your sponsors (see "[Contacting your sponsors](/articles/contacting-your-sponsors)")
+| waitlist_invite_sponsored_developer | Triggered when you are invited to join {% data variables.product.prodname_sponsors %} from the waitlist (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)")
+| waitlist_join | Triggered when you join the waitlist to become a sponsored developer (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)")
 {% endif %}
 
 {% if currentVersion == "free-pro-team@latest" %}
-#### La categoría `successor_invitation`
-
-| Acción         | Descripción                                                                                                                                                                                                                                                                                     |
-| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| accept         | Se activa cuando aceptas una invitación de sucesión (consulta la secicón "[Mantener continuidad en la titularidad de los repositorios de tu cuenta de usuario](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)")  |
-| cancel         | Se activa cuando cancelas una invitación de sucesión (consulta la secicón "[Mantener continuidad en la titularidad de los repositorios de tu cuenta de usuario](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") |
-| create (crear) | Se activa cuando creas una invitación de sucesión (consulta la secicón "[Mantener continuidad en la titularidad de los repositorios de tu cuenta de usuario](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)")    |
-| decline        | Se activa cuando rechazas una invitación de sucesión (consulta la secicón "[Mantener continuidad en la titularidad de los repositorios de tu cuenta de usuario](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") |
-| revoke         | Se activa cuando retiras una invitación de sucesión (consulta la secicón "[Mantener continuidad en la titularidad de los repositorios de tu cuenta de usuario](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)")  |
+#### The `successor_invitation` category
+
+| Action | Description
+|------------------|-------------------
+| accept | Triggered when you accept a succession invitation (see "[Maintaining ownership continuity of your user account's repositories](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)")
+| cancel | Triggered when you cancel a succession invitation (see "[Maintaining ownership continuity of your user account's repositories](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)")
+| create | Triggered when you create a succession invitation (see "[Maintaining ownership continuity of your user account's repositories](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)")
+| decline | Triggered when you decline a succession invitation (see "[Maintaining ownership continuity of your user account's repositories](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)")
+| revoke | Triggered when you revoke a succession invitation (see "[Maintaining ownership continuity of your user account's repositories](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)")
 {% endif %}
 
 {% if currentVersion != "free-pro-team@latest" %}
 
-#### La categoría de `team` (equipo)
+#### The `team` category
 
-| Acción                                   | Descripción                                                                                                                                          |
-| ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
-| add_member (agregar miembro)             | Se activa cuando un miembro de una organización a la que perteneces te [agrega a un equipo](/articles/adding-organization-members-to-a-team).        |
-| add_repository (agregar repositorio)     | Se activa cuando se le otorga el control de un repositorio a un equipo del que eres miembro.                                                         |
-| create (crear)                           | Se activa cuando se crea un equipo nuevo en una organización a la que perteneces.                                                                    |
-| destroy (destruir)                       | Se activa cuando un equipo del que eres miembro se elimina de la organización.                                                                       |
-| remove_member (eliminar miembro)         | Se activa cuando un miembro de una organización se [elimina de un equipo](/articles/removing-organization-members-from-a-team) del que eres miembro. |
-| remove_repository (eliminar repositorio) | Se activa cuando un repositorio deja de estar bajo el control de un equipo.                                                                          |
+| Action | Description
+|------------------|-------------------
+| add_member | Triggered when a member of an organization you belong to [adds you to a team](/articles/adding-organization-members-to-a-team).
+| add_repository | Triggered when a team you are a member of is given control of a repository.
+| create | Triggered when a new team in an organization you belong to is created.
+| destroy | Triggered when a team you are a member of is deleted from the organization.
+| remove_member | Triggered when a member of an organization is [removed from a team](/articles/removing-organization-members-from-a-team) you are a member of.
+| remove_repository | Triggered when a repository is no longer under a team's control.
 
 {% endif %}
 
-#### La categoría de `two_factor_authentication` (autenticación de dos factores)
-
-| Acción                  | Descripción                                                                                                                          |
-| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
-| enabled (habilitado)    | Se activa cuando se habilita la [autenticación de dos factores](/articles/securing-your-account-with-two-factor-authentication-2fa). |
-| disabled (inhabilitado) | Se activa cuando se inhabilita la autenticación de dos factores.                                                                     |
-
-#### La categoría de `user` (usuario)
-
-| Acción                                                                         | Descripción                                                                                                                                                                                     |
-| ------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| add_email (agregar correo electrónico)                                         | Se activa cuando [agregas una dirección de correo electrónico nueva](/articles/changing-your-primary-email-address).                                                                            |
-| create (crear)                                                                 | Se activa cuando creas una cuenta de usuario nueva.                                                                                                                                             |
-| remove_email (eliminar correo electrónico)                                     | Se activa cuando eliminas una dirección de correo electrónico.                                                                                                                                  |
-| rename (renombrar)                                                             | Se activa cuando renombras tu cuenta.                                                                                                                                                           |
-| change_password (cambiar contraseña)                                           | Se activa cuando cambias tu contraseña.                                                                                                                                                         |
-| forgot_password (olvidé la contraseña)                                         | Se activa cuando solicitas [un restablecimiento de contraseña](/articles/how-can-i-reset-my-password).                                                                                          |
-| login                                                                          | Se activa cuando inicias sesión en {% data variables.product.product_location %}.                                                                                                          |
-| failed_login (inicio de sesión fallido)                                        | Se activa cuando no puedes iniciar sesión con éxito.                                                                                                                                            |
-| two_factor_requested (dos factores requeridos)                               | Se activa cuando {% data variables.product.product_name %} te solicita [tu código de autenticación de dos factores](/articles/accessing-github-using-two-factor-authentication).           |
-| show_private_contributions_count (mostrar conteo de contribuciones privadas) | Se activa cuando [publicitas contribuciones privadas en tu perfil](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile).                                                 |
-| hide_private_contributions_count (ocultar conteo de contribuciones privadas) | Se activa cuando [ocultas contribuciones privadas en tu perfil](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile).{% if currentVersion == "free-pro-team@latest" %}
-| report_content (informar contenido)                                            | Se activa cuando [informas una propuesta o solicitud de extracción, o un comentario sobre una propuesta, solicitud de extracción o confirmación](/articles/reporting-abuse-or-spam).{% endif %}
-
-#### La categoría de `user_status` (estado de usuario)
-
-| Acción             | Descripción                                                                                                                                                                            |
-| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| actualización      | Se activa cuando estableces o cambias el estado en tu perfil. Para obtener más información, consulta "[Configurar un estado](/articles/personalizing-your-profile/#setting-a-status)". |
-| destroy (destruir) | Se activa cuando eliminas el estado de tu perfil.                                                                                                                                      |
+#### The `two_factor_authentication` category
+
+| Action | Description
+|------------------|-------------------
+| enabled | Triggered when [two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa) is enabled.
+| disabled | Triggered when two-factor authentication is disabled.
+
+#### The `user` category
+
+| Action | Description
+|--------------------|---------------------
+| add_email | Triggered when you [add a new email address](/articles/changing-your-primary-email-address).
+| create | Triggered when you create a new user account.
+| remove_email | Triggered when you remove an email address.
+| rename | Triggered when you rename your account.
+| change_password | Triggered when you change your password.
+| forgot_password | Triggered when you ask for [a password reset](/articles/how-can-i-reset-my-password).
+| login | Triggered when you log in to {% data variables.product.product_location %}.
+| failed_login | Triggered when you failed to log in successfully.
+| two_factor_requested | Triggered when {% data variables.product.product_name %} asks you for [your two-factor authentication code](/articles/accessing-github-using-two-factor-authentication).
+| show_private_contributions_count | Triggered when you [publicize private contributions on your profile](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile).
+| hide_private_contributions_count | Triggered when you [hide private contributions on your profile](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile).{% if currentVersion == "free-pro-team@latest" %}
+| report_content | Triggered when you [report an issue or pull request, or a comment on an issue, pull request, or commit](/articles/reporting-abuse-or-spam).{% endif %}
+
+#### The `user_status` category
+
+| Action | Description
+|--------------------|---------------------
+| update | Triggered when you set or change the status on your profile. For more information, see "[Setting a status](/articles/personalizing-your-profile/#setting-a-status)."
+| destroy | Triggered when you clear the status on your profile.
 
 {% if currentVersion == "free-pro-team@latest" %}
 
-### Exportar tu registro de seguridad
+### Exporting your security log
 
 {% data reusables.audit_log.export-log %}
 {% data reusables.audit_log.exported-log-keys-and-values %}
diff --git a/translations/es-XL/content/github/authenticating-to-github/reviewing-your-ssh-keys.md b/translations/es-XL/content/github/authenticating-to-github/reviewing-your-ssh-keys.md
index 6f1ab852b1fa..71ea5e3d0586 100644
--- a/translations/es-XL/content/github/authenticating-to-github/reviewing-your-ssh-keys.md
+++ b/translations/es-XL/content/github/authenticating-to-github/reviewing-your-ssh-keys.md
@@ -1,6 +1,6 @@
 ---
-title: Revisar tus claves SSH
-intro: 'Para mantener seguras tus credenciales, debes auditar de manera regular tus claves SSH, llaves de implementación y revisar las aplicaciones autorizadas que acceden a tu {% data variables.product.product_name %} cuenta.'
+title: Reviewing your SSH keys
+intro: 'To keep your credentials secure, you should regularly audit your SSH keys, deploy keys, and review authorized applications that access your {% data variables.product.product_name %} account.'
 redirect_from:
   - /articles/keeping-your-application-access-tokens-safe/
   - /articles/keeping-your-ssh-keys-and-application-access-tokens-safe/
@@ -10,37 +10,43 @@ versions:
   enterprise-server: '*'
 ---
 
-Puedes eliminar las claves SSH no autorizadas (o posiblemente comprometidas) para garantizar que un atacante no tenga más acceso a tus repositorios. También puedes aprobar llaves SSH existentes que sean válidas.
+You can delete unauthorized (or possibly compromised) SSH keys to ensure that an attacker no longer has access to your repositories. You can also approve existing SSH keys that are valid.
 
 {% mac %}
 
 {% data reusables.user_settings.access_settings %}
 {% data reusables.user_settings.ssh %}
-3. En la página de Parámetros SSH, anota las claves SSH asociadas a tu cuenta. Para las que no reconozcas o que estén desactualizadas, haz clic en **Delete** (Eliminar). Si hay claves SSH válidas que quieres conservar, haz clic en **Approve** (Aprobar). ![Lista de claves SSH](/assets/images/help/settings/settings-ssh-key-review.png)
+3. On the SSH Settings page, take note of the SSH keys associated with your account. For those that you don't recognize, or that are out-of-date, click **Delete**. If there are valid SSH keys you'd like to keep, click **Approve**.
+	![SSH key list](/assets/images/help/settings/settings-ssh-key-review.png)
 
   {% tip %}
 
-     **Nota:** Si estás auditando tus claves SSH por una operación de Git fallida, la clave no verificada que provocó el [error de auditoría de clave SSH](/articles/error-we-re-doing-an-ssh-key-audit) se resaltará en la lista de claves SSH. ![Claves SSH no verificadas](/assets/images/help/settings/settings-ssh-key-review-highlight.png)
+     **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys.
 
   {% endtip %}
 
-4. Abre Terminal.
+4. Open Terminal.
 
 5. {% data reusables.command_line.start_ssh_agent %}
 
-6. Busca tu huella digital de llave pública y anótala. Si estás usando OpenSSH 6.7 o una versión anterior:
+6. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older:
   ```shell
   $ ssh-add -l
   > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA)
   ```
 
-  Si estás usando OpenSSH 6.8 o una versión más reciente:
+  If you're using OpenSSH 6.8 or newer:
   ```shell
   $ ssh-add -l -E md5
   > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA)
   ```
+  {% else %}
+  ```shell
+  $ ssh-add -l -E sha256
+  > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA)
+  ```{% endif %}
 
-7. Las claves SSH en {% data variables.product.product_name %} *deben* coincidir con las mismas calves en tu computadora.
+7. The SSH keys on {% data variables.product.product_name %} *should* match the same keys on your computer.
 
 {% endmac %}
 
@@ -48,33 +54,39 @@ Puedes eliminar las claves SSH no autorizadas (o posiblemente comprometidas) par
 
 {% data reusables.user_settings.access_settings %}
 {% data reusables.user_settings.ssh %}
-3. En la página de Parámetros SSH, anota las claves SSH asociadas a tu cuenta. Para las que no reconozcas o que estén desactualizadas, haz clic en **Delete** (Eliminar). Si hay claves SSH válidas que quieres conservar, haz clic en **Approve** (Aprobar). ![Lista de claves SSH](/assets/images/help/settings/settings-ssh-key-review.png)
+3. On the SSH Settings page, take note of the SSH keys associated with your account. For those that you don't recognize, or that are out-of-date, click **Delete**. If there are valid SSH keys you'd like to keep, click **Approve**.
+	![SSH key list](/assets/images/help/settings/settings-ssh-key-review.png)
 
   {% tip %}
 
-     **Nota:** Si estás auditando tus claves SSH por una operación de Git fallida, la clave no verificada que provocó el [error de auditoría de clave SSH](/articles/error-we-re-doing-an-ssh-key-audit) se resaltará en la lista de claves SSH.![Claves SSH no verificadas](/assets/images/help/settings/settings-ssh-key-review-highlight.png)
+     **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys.
 
   {% endtip %}
 
-4. Abre Git Bash. Si estás usando Git Shell, que se incluye en {% data variables.product.prodname_desktop %}, abre Git Shell y avanza hasta el paso 6.
+4. Open Git Bash. If you're using Git Shell, which is included in {% data variables.product.prodname_desktop %}, open Git Shell and skip to step 6.
 
 5. {% data reusables.desktop.windows_git_bash_turn_on_ssh_agent %}
 
   {% data reusables.desktop.windows_git_for_windows_turn_on_ssh_agent %}
 
-6. Busca tu huella digital de llave pública y anótala. Si estás usando OpenSSH 6.7 o una versión anterior:
+6. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older:
   ```shell
   $ ssh-add -l
   > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA)
   ```
 
-  Si estás usando OpenSSH 6.8 o una versión más reciente:
+  If you're using OpenSSH 6.8 or newer:
   ```shell
   $ ssh-add -l -E md5
   > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA)
   ```
+  {% else %}
+  ```shell
+  $ ssh-add -l -E sha256
+  > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA)
+  ```{% endif %}
 
-7. Las claves SSH en {% data variables.product.product_name %} *deben* coincidir con las mismas calves en tu computadora.
+7. The SSH keys on {% data variables.product.product_name %} *should* match the same keys on your computer.
 
 {% endwindows %}
 
@@ -82,36 +94,42 @@ Puedes eliminar las claves SSH no autorizadas (o posiblemente comprometidas) par
 
 {% data reusables.user_settings.access_settings %}
 {% data reusables.user_settings.ssh %}
-3. En la página de Parámetros SSH, anota las claves SSH asociadas a tu cuenta. Para las que no reconozcas o que estén desactualizadas, haz clic en **Delete** (Eliminar). Si hay claves SSH válidas que quieres conservar, haz clic en **Approve** (Aprobar). ![Lista de claves SSH](/assets/images/help/settings/settings-ssh-key-review.png)
+3. On the SSH Settings page, take note of the SSH keys associated with your account. For those that you don't recognize, or that are out-of-date, click **Delete**. If there are valid SSH keys you'd like to keep, click **Approve**.
+	![SSH key list](/assets/images/help/settings/settings-ssh-key-review.png)
 
   {% tip %}
 
-     **Nota:** Si estás auditando tus claves SSH por una operación de Git fallida, la clave no verificada que provocó el [error de auditoría de clave SSH](/articles/error-we-re-doing-an-ssh-key-audit) se resaltará en la lista de claves SSH. ![Claves SSH no verificadas](/assets/images/help/settings/settings-ssh-key-review-highlight.png)
+     **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys.
 
   {% endtip %}
 
-4. Abre Terminal.
+4. Open Terminal.
 
 5. {% data reusables.command_line.start_ssh_agent %}
 
-6. Busca tu huella digital de llave pública y anótala. Si estás usando OpenSSH 6.7 o una versión anterior:
+6. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older:
   ```shell
   $ ssh-add -l
   > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA)
   ```
 
-  Si estás usando OpenSSH 6.8 o una versión más reciente:
+  If you're using OpenSSH 6.8 or newer:
   ```shell
   $ ssh-add -l -E md5
   > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA)
   ```
+  {% else %}
+  ```shell
+  $ ssh-add -l -E sha256
+  > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA)
+  ```{% endif %}
 
-7. Las claves SSH en {% data variables.product.product_name %} *deben* coincidir con las mismas calves en tu computadora.
+7. The SSH keys on {% data variables.product.product_name %} *should* match the same keys on your computer.
 
 {% endlinux %}
 
 {% warning %}
 
-**Advertencia**: Si ves una clave SSH que no te resulta familiar en {% data variables.product.product_name %}, elimínala de inmediato y contáctate con {% data variables.contact.contact_support %} para recibir más ayuda. Una llave pública no identificada puede indicar un posible problema de seguridad.
+**Warning**: If you see an SSH key you're not familiar with on {% data variables.product.product_name %}, delete it immediately and contact {% data variables.contact.contact_support %} for further help. An unidentified public key may indicate a possible security concern.
 
 {% endwarning %}
diff --git a/translations/es-XL/content/github/building-a-strong-community/locking-conversations.md b/translations/es-XL/content/github/building-a-strong-community/locking-conversations.md
index 715d99dc3f80..5e86b60383ee 100644
--- a/translations/es-XL/content/github/building-a-strong-community/locking-conversations.md
+++ b/translations/es-XL/content/github/building-a-strong-community/locking-conversations.md
@@ -1,6 +1,6 @@
 ---
-title: Bloquear conversaciones
-intro: 'Los propietarios y colaboradores del repositorio, y las personas con acceso de escritura, pueden bloquear conversaciones sobre propuestas, solicitudes de extracción y confirmaciones de manera permanente o temporal para desactivar una interacción subida de tono.'
+title: Locking conversations
+intro: 'Repository owners and collaborators, and people with write access to a repository, can lock conversations on issues, pull requests, and commits permanently or temporarily to defuse a heated interaction.'
 redirect_from:
   - /articles/locking-conversations
 versions:
@@ -8,28 +8,32 @@ versions:
   enterprise-server: '*'
 ---
 
-Corresponde bloquear una conversación cuando en su conjunto no es constructiva o viola el código de conducta de tu comunidad {% if currentVersion == "free-pro-team@latest" %} o las [Pautas de la comunidad](/articles/github-community-guidelines){% endif %} de GitHub. Cuando bloqueas una conversación, también puedes especificar el motivo, que queda públicamente visible.
+It's appropriate to lock a conversation when the entire conversation is not constructive or violates your community's code of conduct{% if currentVersion == "free-pro-team@latest" %} or GitHub's [Community Guidelines](/articles/github-community-guidelines){% endif %}. When you lock a conversation, you can also specify a reason, which is publicly visible.
 
-Bloquear una conversación genera un evento de cronología que queda visible para cualquiera que tenga acceso de lectura al repositorio. Sin embargo, el nombre de usuario de la persona que bloqueó la conversación solo lo pueden ver las personas con acceso de escritura al repositorio. Para cualquiera que no tenga acceso de escritura, el evento de cronología es anónimo.
+Locking a conversation creates a timeline event that is visible to anyone with read access to the repository. However, the username of the person who locked the conversation is only visible to people with write access to the repository. For anyone without write access, the timeline event is anonymized.
 
-![Evento de cronología anónimo de una conversación bloqueada](/assets/images/help/issues/anonymized-timeline-entry-for-locked-conversation.png)
+![Anonymized timeline event for a locked conversation](/assets/images/help/issues/anonymized-timeline-entry-for-locked-conversation.png)
 
-Mientras una conversación está bloqueada, solo [las personas con acceso de escritura](/articles/repository-permission-levels-for-an-organization/) y [los propietarios y colaboradores del repositorio](/articles/permission-levels-for-a-user-account-repository/#collaborator-access-on-a-repository-owned-by-a-user-account) pueden agregar, ocultar y eliminar comentarios.
+While a conversation is locked, only [people with write access](/articles/repository-permission-levels-for-an-organization/) and [repository owners and collaborators](/articles/permission-levels-for-a-user-account-repository/#collaborator-access-on-a-repository-owned-by-a-user-account) can add, hide, and delete comments.
 
-Para buscar conversaciones bloqueadas en un repositorio que no está archivado, puedes usar los calificadores de búsqueda `is:locked` y `archived:false`. Las conversaciones se bloquean de forma automática en los repositorios archivados. Para obtener más información, consulta "[Buscar propuestas y solicitudes de extracción](/articles/searching-issues-and-pull-requests#search-based-on-whether-a-conversation-is-locked)".
+To search for locked conversations in a repository that is not archived, you can use the search qualifiers `is:locked` and `archived:false`. Conversations are automatically locked in archived repositories. For more information, see "[Searching issues and pull requests](/articles/searching-issues-and-pull-requests#search-based-on-whether-a-conversation-is-locked)."
 
-1. De manera opcional, escribe un comentario que explique el motivo por el cual estás bloqueando la conversación.
-2. En el margen derecho de la propuesta o solicitud de extracción, o por encima del cuadro de comentarios de la página de confirmaciones, haz clic en **Lock conversation** (Bloquear conversación). ![Enlace Lock conversation (Bloquear conversación)](/assets/images/help/repository/lock-conversation.png)
-3. De manera opcional, elige el motivo para bloquear la conversación. ![Menú Reason for locking a conversation (Motivo para bloquear una conversación)](/assets/images/help/repository/locking-conversation-reason-menu.png)
-4. Lee la información acerca de bloquear conversaciones y haz clic en **Lock conversation on this issue** (Bloquear conversación sobre esta propuesta), **Lock conversation on this pull request** (Bloquear conversación sobre esta solicitud de extracción) o **Lock conversation on this commit** (Bloquear conversación sobre esta confirmación). ![Cuadro de diálogo Confirm lock with a reason (Confirmar bloqueo con motivo)](/assets/images/help/repository/lock-conversation-confirm-with-reason.png)
-5. Cuando estés listo para desbloquear la conversación, haz clic en **Unlock conversation** (Desbloquear conversación). ![Enlace Unlock conversation (Anular bloqueo de la conversación)](/assets/images/help/repository/unlock-conversation.png)
+1. Optionally, write a comment explaining why you're locking the conversation.
+2. In the right margin of the issue or pull request, or above the comment box on the commit page, click **Lock conversation**.
+![Lock conversation link](/assets/images/help/repository/lock-conversation.png)
+3. Optionally, choose a reason for locking the conversation.
+![Reason for locking a conversation menu](/assets/images/help/repository/locking-conversation-reason-menu.png)
+4. Read the information about locking conversations and click **Lock conversation on this issue**, **Lock conversation on this pull request**, or **Lock conversation on this commit**.
+![Confirm lock with a reason dialog box](/assets/images/help/repository/lock-conversation-confirm-with-reason.png)
+5. When you're ready to unlock the conversation, click **Unlock conversation**.
+![Unlock conversation link](/assets/images/help/repository/unlock-conversation.png)
 
-### Leer más
+### Further reading
 
-- "[Configurar tu proyecto para contribuciones positivas](/articles/setting-up-your-project-for-healthy-contributions)"
-- "[Utilizar plantillas para fomentar el informe de problemas útil y las solicitudes de extracción](/github/building-a-strong-community/using-templates-to-encourage-useful-issues-and-pull-requests)"
-- [Administrar los comentarios ofensivos](/articles/managing-disruptive-comments)"{% if currentVersion == "free-pro-team@latest" %}
-- "[Mantener tu seguridad en {% data variables.product.prodname_dotcom %}](/github/building-a-strong-community/maintaining-your-safety-on-github)"
-- "[Informar abuso o spam](/articles/reporting-abuse-or-spam)"
-- "[Limitar interacciones en tu repositorio](/github/building-a-strong-community/limiting-interactions-in-your-repository)"
+- "[Setting up your project for healthy contributions](/articles/setting-up-your-project-for-healthy-contributions)"
+- "[Using templates to encourage useful issues and pull requests](/github/building-a-strong-community/using-templates-to-encourage-useful-issues-and-pull-requests)"
+- "[Managing disruptive comments](/articles/managing-disruptive-comments)"{% if currentVersion == "free-pro-team@latest" %}
+- "[Maintaining your safety on {% data variables.product.prodname_dotcom %}](/github/building-a-strong-community/maintaining-your-safety-on-github)"
+- "[Reporting abuse or spam](/articles/reporting-abuse-or-spam)"
+- "[Limiting interactions in your repository](/github/building-a-strong-community/limiting-interactions-in-your-repository)"
 {% endif %}
diff --git a/translations/es-XL/content/github/building-a-strong-community/managing-disruptive-comments.md b/translations/es-XL/content/github/building-a-strong-community/managing-disruptive-comments.md
index ca99ab19c106..809825ccfb66 100644
--- a/translations/es-XL/content/github/building-a-strong-community/managing-disruptive-comments.md
+++ b/translations/es-XL/content/github/building-a-strong-community/managing-disruptive-comments.md
@@ -1,6 +1,6 @@
 ---
-title: Administrar comentarios negativos
-intro: 'Puedes {% if currentVersion == "free-pro-team@latest" %}ocultar, editar,{% else %}editar{% endif %} o eliminar comentarios sobre reportes de problemas, solicitudes de extracción y confirmaciones.'
+title: Managing disruptive comments
+intro: 'You can {% if currentVersion == "free-pro-team@latest" %}hide, edit,{% else %}edit{% endif %} or delete comments on issues, pull requests, and commits.'
 redirect_from:
   - /articles/editing-a-comment/
   - /articles/deleting-a-comment/
@@ -10,69 +10,76 @@ versions:
   enterprise-server: '*'
 ---
 
-### Ocultar un comentario
+### Hiding a comment
 
-Cualquiera con acceso de escritura a un repositorio puede ocultar comentarios en reportes de problemas, solicitudes de extracción y confirmaciones.
+Anyone with write access to a repository can hide comments on issues, pull requests, and commits. 
 
-Si un comentario está fuera de tema, desactualizado o resuelto, es posible que desees ocultar un comentario para mantener la conversación enfocada o hacer que una solicitud de extracción sea más fácil de navegar o revisar. Los comentarios ocultos se minimizan pero las personas con acceso de lectura a un repositorio puede expandirlos.
+If a comment is off-topic, outdated, or resolved, you may want to hide a comment to keep a discussion focused or make a pull request easier to navigate and review. Hidden comments are minimized but people with read access to the repository can expand them.
 
-![Contenido minimizado](/assets/images/help/repository/hidden-comment.png)
+![Minimized comment](/assets/images/help/repository/hidden-comment.png)
 
-1. Navega hasta el comentario que deseas ocultar.
-2. En la esquina superior derecha del comentario, haz clic en {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, después haz clic en **Hide (Ocultar)**. ![El ícono de kebab horizontal y el menú de moderación de comentario que muestra las opciones Editar, Ocultar y Eliminar](/assets/images/help/repository/comment-menu.png)
-3. Utilizando el menú desplegable "Choose a reason" (Elige una razón), haz clic en una razón para ocultar el comentario. Después haz clic en **Hide comment (Ocultar comentario)**.
+1. Navigate to the comment you'd like to hide.
+2. In the upper-right corner of the comment, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Hide**.
+  ![The horizontal kebab icon and comment moderation menu showing the edit, hide, delete options](/assets/images/help/repository/comment-menu.png)
+3. Using the "Choose a reason" drop-down menu, click a reason to hide the comment. Then click, **Hide comment**.
   {% if currentVersion == "free-pro-team@latest" %}
-  ![Elija la razón para ocultar el menú desplegable de comentarios](/assets/images/help/repository/choose-reason-for-hiding-comment.png)
+  ![Choose reason for hiding comment drop-down menu](/assets/images/help/repository/choose-reason-for-hiding-comment.png)
   {% else %}
-  ![Elija la razón para ocultar el menú desplegable de comentarios](/assets/images/help/repository/choose-reason-for-hiding-comment-ghe.png)
+  ![Choose reason for hiding comment drop-down menu](/assets/images/help/repository/choose-reason-for-hiding-comment-ghe.png)
   {% endif %}
 
-### Desocultar un comentario
+### Unhiding a comment
 
-Cualquiera con acceso de escritura a un repositorio puede volver a mostrar comentarios sobre reportes de problemas, solicitudes de extracción y confirmaciones.
+Anyone with write access to a repository can unhide comments on issues, pull requests, and commits.
 
-1. Navega hasta el comentario que deseas desocultar.
-2. En la esquina superior derecha del comentario, haz clic en **{% octicon "fold" aria-label="The fold icon" %} Show comment (Mostrar comentario)**. ![Mostrar el texto del comentario](/assets/images/help/repository/hidden-comment-show.png)
-3. En el lateral derecho del comentario expandido, haz clic en {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} (el ícono de kebab horizontal), después **Unhide (Desocultar)**. ![El ícono de kebab horizontal y el menú de moderación de comentario que muestra las opciones Editar, Desocultar y Eliminar](/assets/images/help/repository/comment-menu-hidden.png)
+1. Navigate to the comment you'd like to unhide.
+2. In the upper-right corner of the comment, click **{% octicon "fold" aria-label="The fold icon" %} Show comment**.
+   ![Show comment text](/assets/images/help/repository/hidden-comment-show.png)
+3. On the right side of the expanded comment, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then **Unhide**.
+   ![The horizontal kebab icon and comment moderation menu showing the edit, unhide, delete options](/assets/images/help/repository/comment-menu-hidden.png)
 
-### Editar un comentario
+### Editing a comment
 
-Cualquiera con acceso de escritura a un repositorio puede editar comentarios sobre reportes de problemas, solicitudes de extracción y confirmaciones.
+Anyone with write access to a repository can edit comments on issues, pull requests, and commits.
 
-Es correcto editar un comentario y eliminar el contenido que no contribuya a la conversación y viole el código de conducta de tu comunidad {% if currentVersion == "free-pro-team@latest" %} o [las pautas de la comunidad de GitHub ](/articles/github-community-guidelines){% endif %}.
+It's appropriate to edit a comment and remove content that doesn't contribute to the conversation and violates your community's code of conduct{% if currentVersion == "free-pro-team@latest" %} or GitHub's [Community Guidelines](/articles/github-community-guidelines){% endif %}.
 
-Cuando editas un comentario, toma nota de la ubicación desde la que se ha eliminado el contenido y, de manera opcional, la razón por la que se lo eliminó.
+When you edit a comment, note the location that the content was removed from and optionally, the reason for removing it.
 
-Cualquier persona con acceso de lectura a un repositorio puede ver el historial de edición del comentario. El menú desplegable **editado** en la parte superior del comentario contiene un historial de las ediciones y muestra el usuario y el registro de horario de cada edición.
+Anyone with read access to a repository can view a comment's edit history. The **edited** dropdown at the top of the comment contains a history of edits showing the user and timestamp for each edit.
 
-![Comentario con nota adicional que el contenido fue redactado](/assets/images/help/repository/content-redacted-comment.png)
+![Comment with added note that content was redacted](/assets/images/help/repository/content-redacted-comment.png)
 
-Los autores de los comentarios y cualquiera con acceso de escritura a un repositorio puede también eliminar información sensible de un historial de edición de los comentarios. Para obtener más información, consulta "[Rastrear los cambios en un comentario](/github/building-a-strong-community/tracking-changes-in-a-comment)".
+Comment authors and anyone with write access to a repository can also delete sensitive information from a comment's edit history. For more information, see "[Tracking changes in a comment](/github/building-a-strong-community/tracking-changes-in-a-comment)."
 
-1. Navega hasta el comentario que deseas editar.
-2. En la esquina superior derecha del comentario, haz clic en {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, después haz clic en **Edit (Editar)**. ![El ícono de kebab horizontal y el menú de moderación de comentario que muestra las opciones Editar, Ocultar, Eliminar e Informar](/assets/images/help/repository/comment-menu.png)
-3. En la ventana de comentario, elimina el contenido que deseas eliminar, después escribe `[REDACTED]` para reemplazarlo. ![Ventana de comentario con contenido redactado](/assets/images/help/issues/redacted-content-comment.png)
-4. En la parte inferior del comentario, escribe una nota que indique que has editado el comentario, y de forma opcional, la razón por la que editaste el comentario. ![Ventana de comentario con nota adicional que indica que el contenido fue redactado](/assets/images/help/issues/note-content-redacted-comment.png)
-5. Haz clic en **Update comment (Actualizar comentario)**.
+1. Navigate to the comment you'd like to edit.
+2. In the upper-right corner of the comment, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Edit**.
+  ![The horizontal kebab icon and comment moderation menu showing the edit, hide, delete, and report options](/assets/images/help/repository/comment-menu.png)
+3. In the comment window, delete the content you'd like to remove, then type `[REDACTED]` to replace it.
+  ![Comment window with redacted content](/assets/images/help/issues/redacted-content-comment.png)
+4. At the bottom of the comment, type a note indicating that you have edited the comment, and optionally, why you edited the comment.
+  ![Comment window with added note that content was redacted](/assets/images/help/issues/note-content-redacted-comment.png)
+5. Click **Update comment**.
 
-### Eliminar un comentario
+### Deleting a comment
 
-Cualquiera con acceso de escritura a un repositorio puede borrar comentarios sobre reportes de problemas, solicitudes de extracción y confirmaciones. Los propietarios de organizaciones, mantenedores de equipos, y el autor del comentario también pueden borrarlo en la página del equipo.
+Anyone with write access to a repository can delete comments on issues, pull requests, and commits. Organization owners, team maintainers, and the comment author can also delete a comment on a team page.
 
-Eliminar un comentario es tu último recurso como moderador. Es correcto eliminar un comentario si el comentario entero no añade un contenido constructivo a una conversación y viola el código de conducta de tu comunidad{% if currentVersion == "free-pro-team@latest" %} o [las pautas de la comunidad de GitHub](/articles/github-community-guidelines){% endif %}.
+Deleting a comment is your last resort as a moderator. It's appropriate to delete a comment if the entire comment adds no constructive content to a conversation and violates your community's code of conduct{% if currentVersion == "free-pro-team@latest" %} or GitHub's [Community Guidelines](/articles/github-community-guidelines){% endif %}.
 
-Eliminar un comentario crea un evento cronológico que es visible para todos aquellos que tienen acceso de lectura al repositorio. Sin embargo, el nombre de usuario de la persona que eliminó el comentario solo es visible para personas con acceso de escritura al repositorio. Para cualquiera que no tenga acceso de escritura, el evento de cronología es anónimo.
+Deleting a comment creates a timeline event that is visible to anyone with read access to the repository. However, the username of the person who deleted the comment is only visible to people with write access to the repository. For anyone without write access, the timeline event is anonymized.
 
-![Evento cronológico anónimo para un comentario eliminado](/assets/images/help/issues/anonymized-timeline-entry-for-deleted-comment.png)
+![Anonymized timeline event for a deleted comment](/assets/images/help/issues/anonymized-timeline-entry-for-deleted-comment.png)
 
-Si un comentario contiene algún contenido constructivo que sume a la conversación en cuanto a la propuesta o a la solicitud de extracción, puedes editar el comentario.
+If a comment contains some constructive content that adds to the conversation in the issue or pull request, you can edit the comment instead.
 
 {% note %}
 
-**Nota:** el comentario inicial (o cuerpo) de una propuesta o solicitud de extracción no puede eliminarse. Por el contrario, pueden editar los cuerpos de la propuesta o de la solicitud de extracción para eliminar el contenido no deseado.
+**Note:** The initial comment (or body) of an issue or pull request can't be deleted. Instead, you can edit issue and pull request bodies to remove unwanted content.
 
 {% endnote %}
 
-1. Navega hasta el comentario que deseas eliminar.
-2. En la esquina superior derecha del comentario, haz clic en {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, después haz clic en **Delete (Eliminar)**. ![El ícono de kebab horizontal y el menú de moderación de comentario que muestra las opciones Editar, Ocultar, Eliminar e Informar](/assets/images/help/repository/comment-menu.png)
-3. De forma opcional, escribe un comentario señalando que eliminaste un comentario y el porqué.
+1. Navigate to the comment you'd like to delete.
+2. In the upper-right corner of the comment, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Delete**.
+  ![The horizontal kebab icon and comment moderation menu showing the edit, hide, delete, and report options](/assets/images/help/repository/comment-menu.png)
+3. Optionally, write a comment noting that you deleted a comment and why.
diff --git a/translations/es-XL/content/github/collaborating-with-issues-and-pull-requests/collaborating-on-repositories-with-code-quality-features.md b/translations/es-XL/content/github/collaborating-with-issues-and-pull-requests/collaborating-on-repositories-with-code-quality-features.md
index 4150145874f5..95ca378e1e12 100644
--- a/translations/es-XL/content/github/collaborating-with-issues-and-pull-requests/collaborating-on-repositories-with-code-quality-features.md
+++ b/translations/es-XL/content/github/collaborating-with-issues-and-pull-requests/collaborating-on-repositories-with-code-quality-features.md
@@ -1,6 +1,6 @@
 ---
-title: Colaborar en repositorios con características de calidad de código
-intro: 'Las características de la calidad del flujo de trabajo como estados, {% if currentVersion != "free-pro-team@latest" %}ganchos de pre-recepción. {% endif %}ramas protegidas y verificación de estado requerida ayudan a los colaboradores a hacer contribuciones que cumplan con las condiciones establecidas por la organización y los administradores del repositorio.'
+title: Collaborating on repositories with code quality features
+intro: 'Workflow quality features like statuses, {% if currentVersion != "free-pro-team@latest" %}pre-receive hooks, {% endif %}protected branches, and required status checks help collaborators make contributions that meet conditions set by organization and repository administrators.'
 mapTopic: true
 redirect_from:
   - /articles/collaborating-on-repositories-with-code-quality-features-enabled/
diff --git a/translations/es-XL/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md b/translations/es-XL/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md
index 66d6ad63620d..1b9ed3f8d809 100644
--- a/translations/es-XL/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md
+++ b/translations/es-XL/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md
@@ -1,6 +1,6 @@
 ---
-title: Resolver un conflicto de fusión en GitHub
-intro: 'Puedes resolver conflictos de fusión simples que impliquen realizar cambios de líneas en GitHub, usando el editor de conflictos.'
+title: Resolving a merge conflict on GitHub
+intro: 'You can resolve simple merge conflicts that involve competing line changes on GitHub, using the conflict editor.'
 redirect_from:
   - /articles/resolving-a-merge-conflict-on-github
 versions:
@@ -8,50 +8,56 @@ versions:
   enterprise-server: '*'
 ---
 
-Solo puedes resolver los conflictos de fusión en {% data variables.product.product_name %} que hayan sido provocados por realizar cambios de líneas, como cuando las personas hacen cambios diferentes en la misma línea del mismo archivo en ramas diferentes de tu repositorio de Git. Para todos los demás tipos de conflictos de fusión, debes resolver el conflicto de manera local desde la línea de comando. Para obtener más información, consulta "[Resolver un conflicto de fusión en la línea de comandos](/articles/resolving-a-merge-conflict-using-the-command-line/)".
+You can only resolve merge conflicts on {% data variables.product.product_name %} that are caused by competing line changes, such as when people make different changes to the same line of the same file on different branches in your Git repository. For all other types of merge conflicts, you must resolve the conflict locally on the command line. For more information, see "[Resolving a merge conflict using the command line](/articles/resolving-a-merge-conflict-using-the-command-line/)."
 
 {% if currentVersion != "free-pro-team@latest" %}
-Si un administrador del sitio inhabilita el editor de conflictos de fusión para las solicitudes de extracción entre repositorios, no podrás utilizar el editor de conflictos en {% data variables.product.product_name %} y deberás resolver los conflictos de fusión desde la línea de comandos. Por ejemplo, si el editor de conflictos de fusión está inhabilitado, no podrás utilizarlo en una solicitud de extracción entre una bifurcación y el repositorio ascendente.
+If a site administrator disables the merge conflict editor for pull requests between repositories, you cannot use the conflict editor on {% data variables.product.product_name %} and must resolve merge conflicts on the command line. For example, if the merge conflict editor is disabled, you cannot use it on a pull request between a fork and upstream repository.
 {% endif %}
 
 {% warning %}
 
 {% if currentVersion ver_lt "enterprise-server@2.22" %}
-**Advertencia:** Cuando resuelvas un conflcto de fusión en {% data variables.product.product_name %}, toda la [rama base](/github/getting-started-with-github/github-glossary#base-branch) de tu solicitud de extracción se fusionará en la [rama de encabezado](/github/getting-started-with-github/github-glossary#head-branch), aún si dicha rama es la rama predeterminada de tu repositorio o está protegida. Asegúrate que realmente quieras hacer una confirmación para esta rama.
+**Warning:** When you resolve a merge conflict on {% data variables.product.product_name %},  the entire [base branch](/github/getting-started-with-github/github-glossary#base-branch) of your pull request is merged into the [head branch](/github/getting-started-with-github/github-glossary#head-branch), even if the head branch is the default branch of your repository or a protected branch. Make sure you really want to commit to this branch.
 {% else %}
-**Advertencia:** Cuando resuelves un conflicto de fusión en {% data variables.product.product_name %}, toda la [rama base](/github/getting-started-with-github/github-glossary#base-branch) de tu solicitud de extracción se fusiona en la [rama principal](/github/getting-started-with-github/github-glossary#head-branch). Asegúrate que realmente quieras hacer una confirmación para esta rama. Si la rama de encabezado es la predeterminada para tu repositorio, se te dará la opción de crear una rama nueva para que funcione como rama de encabezado para tu solicitud de extracción. Si la rama principal está protegida, no podrás fusionar tu resolución de conflictos con ella, así que se te pedirá crear una nueva rama principal. Para obtener más información, consulta"[Acerca de las ramas protegidas](/github/administering-a-repository/about-protected-branches)".
+**Warning:** When you resolve a merge conflict on {% data variables.product.product_name %},  the entire [base branch](/github/getting-started-with-github/github-glossary#base-branch) of your pull request is merged into the [head branch](/github/getting-started-with-github/github-glossary#head-branch). Make sure you really want to commit to this branch. If the head branch is the default branch of your repository, you'll be given the option of creating a new branch to serve as the head branch for your pull request. If the head branch is protected you won't be able to merge your conflict resolution into it, so you'll be prompted to create a new head branch. For more information, see "[About protected branches](/github/administering-a-repository/about-protected-branches)."
 {% endif %}
 
 {% endwarning %}
 
 {% data reusables.repositories.sidebar-pr %}
-1. En la lista de "Pull Requests" (Solicitudes de extracción), haz clic en la solicitud de extracción con un conflicto de fusión que quieres resolver.
-1. Cerca de la parte de abajo de tu solicitud de extracción, haz clic en **Resolve conflicts** (Resolver conflictos). ![Botón para resolver conflictos de fusión](/assets/images/help/pull_requests/resolve-merge-conflicts-button.png)
+1. In the "Pull Requests" list, click the pull request with a merge conflict that you'd like to resolve.
+1. Near the bottom of your pull request, click **Resolve conflicts**.
+![Resolve merge conflicts button](/assets/images/help/pull_requests/resolve-merge-conflicts-button.png)
 
  {% tip %}
 
- **Sugerencias:** Si el botón **Resolve conflicts** (Resolver conflictos) está desactivado, el conflicto de fusión de tu solicitud de extracción es demasiado complejo para resolverlo en {% data variables.product.product_name %}{% if currentVersion != "free-pro-team@latest" %} o el administrador del sitio inhabilitó el editor de conflictos para las solicitudes de extracción entre repositorios{% endif %}. Debes resolver el conflicto de fusión utilizando un cliente de Git alterno, o utilizando Git en la línea de comandos. Para obtener más información, consulta "[Resolver un conflicto de fusión con la línea de comando](/articles/resolving-a-merge-conflict-using-the-command-line)".
+ **Tip:** If the **Resolve conflicts** button is deactivated, your pull request's merge conflict is too complex to resolve on {% data variables.product.product_name %}{% if currentVersion != "free-pro-team@latest" %} or the site administrator has disabled the conflict editor for pull requests between repositories{% endif %}. You must resolve the merge conflict using an alternative Git client, or by using Git on the command line. For more information see "[Resolving a merge conflict using the command line](/articles/resolving-a-merge-conflict-using-the-command-line)."
 
  {% endtip %}
 {% data reusables.pull_requests.decide-how-to-resolve-competing-line-change-merge-conflict %}
- ![Ver el ejemplo de conflicto de fusión con los marcadores de conflicto](/assets/images/help/pull_requests/view-merge-conflict-with-markers.png)
-1. Si tienes más de un conflicto de fusión en tu archivo, desplázate hacia abajo hasta el siguiente conjunto de marcadores de conflicto y repite los pasos cuatro y cinco para resolver el conflicto de fusión.
-1. Una vez que hayas resuelto todos los conflictos en el archivo, haz clic en **Mark as resolved** (Marcar como resuelto). ![Dar clic en el botón de marcar como resuelto](/assets/images/help/pull_requests/mark-as-resolved-button.png)
-1. Si tienes más de un archivo con conflictos, selecciona el siguiente archivo que quieres editar del lado izquierdo de la página en "conflicting files" (archivos conflictivos) y repite los pasos cuatro a siete hasta que hayas resuelto todos los conflictos de fusión de tu solicitud de extracción. ![Seleccionar el siguiente archivo conflictivo, de ser aplicable](/assets/images/help/pull_requests/resolve-merge-conflict-select-conflicting-file.png)
-1. Una vez que hayas resuelto todos tus conflictos de fusión, haz clic en **Commit merge** (Confirmar fusión). Esto fusiona toda la rama de base con tu rama de encabezado. ![Resolve merge conflicts button](/assets/images/help/pull_requests/merge-conflict-commit-changes.png){% if currentVersion ver_lt "enterprise-server@2.22" %}
-1. Si se te solicita, revisa la rama para la que vas a confirmar. Si quieres confirmar para esta rama, haz clic en **I understand, update _BRANCH_** (Comprendo, actualizar RAMA). ![Merge conflict confirmation window](/assets/images/help/pull_requests/merge-conflict-confirmation.png){% else %}
-1. Si se te solicita, revisa la rama para la que vas a confirmar.
-
-   Si la rama principal es la rama predeterminada del repositorio, puedes escoger ya sea actualizar esta rama con los cambios que hiciste para resolver el conflicto, o crear una rama nueva y utilizarla como la rama principal de la solicitud de extracción. ![Mensaje para revisar la rama que se actualizará](/assets/images/help/pull_requests/conflict-resolution-merge-dialog-box.png)
-
-   Si eliges crear una rama nueva, ingresa un nombre para ésta.
-
-   Si la rama principal de tu solicitud de extracción está protegida, debes crear una rama nueva. No tendrás la opción para actualizar la rama protegida.
-
-   Da clic en **Crear rama y actualizar mi solicitud de extracción** o en **Entiendo, continuar actualizando la _RAMA_**. El texto del botón corresponde a la acción que estás realizando.
+ ![View merge conflict example with conflict markers](/assets/images/help/pull_requests/view-merge-conflict-with-markers.png)
+1. If you have more than one merge conflict in your file, scroll down to the next set of conflict markers and repeat steps four and five to resolve your merge conflict.
+1. Once you've resolved all the conflicts in the file, click **Mark as resolved**.
+ ![Click mark as resolved button](/assets/images/help/pull_requests/mark-as-resolved-button.png)
+1. If you have more than one file with a conflict, select the next file you want to edit on the left side of the page under "conflicting files" and repeat steps four through seven until you've resolved all of your pull request's merge conflicts.
+ ![Select next conflicting file if applicable](/assets/images/help/pull_requests/resolve-merge-conflict-select-conflicting-file.png)
+1. Once you've resolved all your merge conflicts, click **Commit merge**. This merges the entire base branch into your head branch.
+ ![Resolve merge conflicts button](/assets/images/help/pull_requests/merge-conflict-commit-changes.png){% if currentVersion ver_lt "enterprise-server@2.22" %}
+1. If prompted, review the branch that you are committing to. If you want to commit to this branch, click **I understand, update _BRANCH_**.
+![Merge conflict confirmation window](/assets/images/help/pull_requests/merge-conflict-confirmation.png){% else %}
+1. If prompted, review the branch that you are committing to. 
+
+   If the head branch is the default branch of the repository, you can choose either to update this branch with the changes you made to resolve the conflict, or to create a new branch and use this as the head branch of the pull request.
+ ![Prompt to review the branch that will be updated](/assets/images/help/pull_requests/conflict-resolution-merge-dialog-box.png)
+   
+   If you choose to create a new branch, enter a name for the branch.
+   
+   If the head branch of your pull request is protected you must create a new branch. You won't get the option to update the protected branch.
+   
+   Click **Create branch and update my pull request** or **I understand, continue updating _BRANCH_**. The button text corresponds to the action you are performing.
 {% endif %}
-1. Para fusionar tu solicitud de extracción, haz clic en **Merge pull request** (Fusionar solicitud de extracción). Para obtener más información acerca de otras opciones de fusión de solicitudes de extracción, consulta "[Fusionar una solicitud de extracción](/articles/merging-a-pull-request/)".
+1. To merge your pull request, click **Merge pull request**. For more information about other pull request merge options, see "[Merging a pull request](/articles/merging-a-pull-request/)."
 
-### Leer más
+### Further reading
 
-- "[Acerca de las fusiones de solicitudes de extracción](/articles/about-pull-request-merges/)"
+- "[About pull request merges](/articles/about-pull-request-merges)"
diff --git a/translations/es-XL/content/github/committing-changes-to-your-project/creating-a-commit-with-multiple-authors.md b/translations/es-XL/content/github/committing-changes-to-your-project/creating-a-commit-with-multiple-authors.md
index af012599fd9c..079e81663f51 100644
--- a/translations/es-XL/content/github/committing-changes-to-your-project/creating-a-commit-with-multiple-authors.md
+++ b/translations/es-XL/content/github/committing-changes-to-your-project/creating-a-commit-with-multiple-authors.md
@@ -1,6 +1,6 @@
 ---
-title: Crear una confirmación con distintos autores
-intro: 'Puedes atribuir una confirmación a más de un autor agregando una o más introducciones `Co-authored-by` al mensaje de la confirmación. Las confirmaciones conjuntas se pueden ver en {% data variables.product.product_name %} y se pueden incluir en el gráfico de contribuciones del perfil y en las estadísticas del repositorio.'
+title: Creating a commit with multiple authors
+intro: 'You can attribute a commit to more than one author by adding one or more `Co-authored-by` trailers to the commit''s message. Co-authored commits are visible on {% data variables.product.product_name %}{% if currentVersion != "free-pro-team@latest" %} and can be included in the profile contributions graph and the repository''s statistics{% endif %}.'
 redirect_from:
   - /articles/creating-a-commit-with-multiple-authors
 versions:
@@ -8,41 +8,41 @@ versions:
   enterprise-server: '*'
 ---
 
-### Información del coautor requerida
+### Required co-author information
 
-Antes de agregar un coautor a una confirmación, debes saber el correo electrónico correcto para usar con cada coautor. Para que la confirmación del coautor se considere como una contribución, debes usar el correo electrónico asociado con su cuenta {% data variables.product.product_name %}.
+Before you can add a co-author to a commit, you must know the appropriate email to use for each co-author. For the co-author's commit to count as a contribution, you must use the email associated with their {% data variables.product.product_name %} account.
 
 {% if currentVersion == "free-pro-team@latest" %}
 
-Si una persona elige mantener la privacidad de su dirección de correo electrónico, debes usar su correo electrónico `no-reply` proporcionado por {% data variables.product.product_name %} para proteger su privacidad. Si no lo haces, el correo electrónico del coautor estará disponible para el público en el mensaje de confirmación. Si deseas mantener la privacidad de tu correo electrónico, puedes optar por usar un correo electrónico `no-reply` proporcionado por {% data variables.product.product_name %} para las operaciones Git y solicitar a los otros coautores que incluyan tu correo electrónico `no-reply` en las introducciones de cada confirmación.
+If a person chooses to keep their email address private, you should use their {% data variables.product.product_name %}-provided `no-reply` email to protect their privacy. Otherwise, the co-author's email will be available to the public in the commit message. If you want to keep your email private, you can choose to use a {% data variables.product.product_name %}-provided `no-reply` email for Git operations and ask other co-authors to list your `no-reply` email in commit trailers.
 
-Para obtener más información, consulta "[Establecer tu dirección de correo electrónico de confirmación](/articles/setting-your-commit-email-address)".
+For more information, see "[Setting your commit email address](/articles/setting-your-commit-email-address)."
 
   {% tip %}
 
-  **Sugerencia:** Puedes ayudar a un coautor a encontrar una dirección de correo electrónico de su preferencia compartiendo esta información:
-  - Para encontrar tu correo electrónico `no-reply` proporcionado por {% data variables.product.product_name %} dirígete a la página de configuración de tu correo electrónico en "Mantener la privacidad de mi dirección de correo electrónico".
-  - Para encontrar el correo electrónico que usaste para configurar Git en tu computadora, ejecuta `git config user.email` en la línea de comando.
+  **Tip:** You can help a co-author find their preferred email address by sharing this information:
+  - To find your {% data variables.product.product_name %}-provided `no-reply` email, navigate to your email settings page under "Keep my email address private."
+  - To find the email you used to configure Git on your computer, run `git config user.email` on the command line.
 
   {% endtip %}
 
 {% endif %}
 
-### Crear confirmaciones conjuntas usando {% data variables.product.prodname_desktop %}
+### Creating co-authored commits using {% data variables.product.prodname_desktop %}
 
-Puedes usar {% data variables.product.prodname_desktop %} para crear una confirmación con un coautor. Para obtener más información, consulta "[Escribe un mensaje de confirmación y sube tus cambios](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project#3-write-a-commit-message-and-push-your-changes)" y [{% data variables.product.prodname_desktop %}](https://desktop.github.com).
+You can use {% data variables.product.prodname_desktop %} to create a commit with a co-author. For more information, see "[Write a commit message and push your changes](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project#3-write-a-commit-message-and-push-your-changes)" and [{% data variables.product.prodname_desktop %}](https://desktop.github.com).
 
-![Agregar un coautor al mensaje de confirmación](/assets/images/help/desktop/co-authors-demo-hq.gif)
+![Add a co-author to the commit message](/assets/images/help/desktop/co-authors-demo-hq.gif)
 
-### Crear confirmaciones conjuntas en la línea de comando
+### Creating co-authored commits on the command line
 
 {% data reusables.pull_requests.collect-co-author-commit-git-config-info %}
 
 {% data reusables.pull_requests.commit-message-with-trailer-beginning %}
 
-3. En la línea siguiente del mensaje de confirmación, escribe `Co-authored-by:name ` con información específica para cada coautor. Luego de la información del coautor, agrega comillas de cierre.
+3. On the next line of the commit message, type `Co-authored-by: name ` with specific information for each co-author. After the co-author information, add a closing quotation mark.
 
-  Si estás agregando distintos coautores, asigna una línea y una introducción de la confirmación `Co-authored-by` a cada coautor.
+  If you're adding multiple co-authors, give each co-author their own line and `Co-authored-by:` commit trailer.
   ```shell
   $ git commit -m "Refactor usability tests.
   >
@@ -51,26 +51,27 @@ Puedes usar {% data variables.product.prodname_desktop %} para crear una confirm
   Co-authored-by: another-name <another-name@example.com>"
   ```
 
-El nuevo mensaje y la confirmación aparecerán en {% data variables.product.product_location %} la próxima vez que subas un cambio. Para obtener más información, consulta "[Subir cambios a un repositorio remoto](/articles/pushing-commits-to-a-remote-repository/)."
+The new commit and message will appear on {% data variables.product.product_location %} the next time you push. For more information, see "[Pushing changes to a remote repository](/articles/pushing-commits-to-a-remote-repository/)."
 
-### Crear confirmaciones conjuntas en {% data variables.product.product_name %}
+### Creating co-authored commits on {% data variables.product.product_name %}
 
-Una vez que hayas realizado los cambios en un archivo usando el editor web en {% data variables.product.product_name %}, puedes crear una confirmación conjunta agregando una introducción `Co-authored-by:` al mensaje de confirmación.
+After you've made changes in a file using the web editor on {% data variables.product.product_name %}, you can create a co-authored commit by adding a `Co-authored-by:` trailer to the commit's message.
 
 {% data reusables.pull_requests.collect-co-author-commit-git-config-info %}
-2. Luego de hacer tus cambios de forma conjunta, en la parte inferior de la página, escribe un mensaje de confirmación breve y significativo que describa los cambios que realizaste. ![Mensaje de confirmación de tu cambio](/assets/images/help/repository/write-commit-message-quick-pull.png)
-3. En el cuadro de texto que aparece debajo de tu mensaje de confirmación, agrega `Co-authored-by:name ` con información específica para cada coautor. Si estás agregando distintos coautores, asigna una línea y una introducción de la confirmación `Co-authored-by` a cada coautor.
+2. After making your changes together, at the bottom of the page, type a short, meaningful commit message that describes the changes you made.
+  ![Commit message for your change](/assets/images/help/repository/write-commit-message-quick-pull.png)
+3. In the text box below your commit message, add `Co-authored-by: name ` with specific information for each co-author. If you're adding multiple co-authors, give each co-author their own line and `Co-authored-by:` commit trailer.
 
-  ![Ejemplo de introducción de coautor del mensaje de confirmación en el cuadro de texto para el mensaje de confirmación](/assets/images/help/repository/write-commit-message-co-author-trailer.png)
-4. Haz clic en **Confirmar cambios** o **Proponer cambios**.
+  ![Commit message co-author trailer example in second commit message text box](/assets/images/help/repository/write-commit-message-co-author-trailer.png)
+4. Click **Commit changes** or **Propose changes**.
 
-La confirmación y el mensaje nuevos aparecerán en {% data variables.product.product_location %}.
+The new commit and message will appear on {% data variables.product.product_location %}.
 
-### Leer más
+### Further reading
 {% if currentVersion != "free-pro-team@latest" %}
-- "[Ver las contribuciones en tu perfil](/articles/viewing-contributions-on-your-profile)"
-- "[¿Por qué mis contribuciones no se ven en mi perfil?](/articles/why-are-my-contributions-not-showing-up-on-my-profile)"{% endif %}
-- "[Ver un resumen de la actividad del repositorio](/articles/viewing-a-summary-of-repository-activity)"
-- "[Ver los colaboradores de un proyecto](/articles/viewing-a-projects-contributors)"
-- "[Cambiar un mensaje de confirmación](/articles/changing-a-commit-message)"
-- "[Confirmar y revisar los cambios en tu proyecto](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project#3-write-a-commit-message-and-push-your-changes)" en la documentación de {% data variables.product.prodname_desktop %}
+- "[Viewing contributions on your profile](/articles/viewing-contributions-on-your-profile)"
+- "[Why are my contributions not showing up on my profile?](/articles/why-are-my-contributions-not-showing-up-on-my-profile)"{% endif %}
+- "[Viewing a summary of repository activity](/articles/viewing-a-summary-of-repository-activity)"
+- "[Viewing a project's contributors](/articles/viewing-a-projects-contributors)"
+- "[Changing a commit message](/articles/changing-a-commit-message)"
+- "[Committing and reviewing changes to your project](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project#3-write-a-commit-message-and-push-your-changes)" in the {% data variables.product.prodname_desktop %} documentation
diff --git a/translations/es-XL/content/github/creating-cloning-and-archiving-repositories/about-repository-visibility.md b/translations/es-XL/content/github/creating-cloning-and-archiving-repositories/about-repository-visibility.md
index 0b689e003f8a..d8c3f2ea37c5 100644
--- a/translations/es-XL/content/github/creating-cloning-and-archiving-repositories/about-repository-visibility.md
+++ b/translations/es-XL/content/github/creating-cloning-and-archiving-repositories/about-repository-visibility.md
@@ -1,23 +1,23 @@
 ---
-title: Acerca de la visibilidad de un repositorio
-intro: 'Puedes restringir quién tiene acceso a un repositorio si eliges su visibilidad: {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}pública, interna, o privada{% else %} pública o privada{% endif %}.'
+title: About repository visibility
+intro: 'You can restrict who has access to a repository by choosing a repository''s visibility: {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}public, internal, or private{% else %} public or private{% endif %}.'
 versions:
   free-pro-team: '*'
   enterprise-server: '*'
 ---
 
-### Acerca de la visibilidad de un repositorio
+### About repository visibility
 
-Cuando creas un repositorio, puedes elegir configurarlo como público o privado. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}Si creas un repositorio en una organización{% if currentVersion == "free-pro-team@latest" %} que sea propiedad de una cuenta empresarial{% endif %}, también puedes configurarlo como interno.{% endif %}
+When you create a repository, you can choose to make the repository public or private. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}If you're creating the repository in an organization{% if currentVersion == "free-pro-team@latest" %} that is owned by an enterprise account{% endif %}, you can also choose to make the repository internal.{% endif %}
 
-{% if currentVersion != "free-pro-team@latest" %}Si {% data variables.product.product_location_enterprise %} no está en modo privado o detrás de un cortafuegos, cualquier persona en la internet podrá acceder a los repositorios p{% else %}P{% endif %}úblicos.{% if currentVersion != "free-pro-team@latest" %}De lo contrario, los repositorios públicos estarán disponibles para cualquiera que utilice {% data variables.product.product_location_enterprise %}, incluyendo a los colaboradores externos.{% endif %} Solo tú y las personas con las que compartas el acceso explícitamente podrán acceder a los repositorios privados y, en caso de los repositorios organizacionales, solo [algunos miembros específicos de la organización](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization). {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}Los {% if currentVersion == "free-pro-team@latest" %}miembros de tu cuenta empresarial y{% else %}los de cualquier organización en tu instancia{% endif %} tienen acceso a los repositorios internos. Para obtener más información, consulta la sección "[Acerca de los repositorios internos](#about-internal-repositories)."{% endif %}
+{% if currentVersion != "free-pro-team@latest" %}If {% data variables.product.product_location_enterprise %} is not in private mode or behind a firewall, p{% else %}P{% endif %}ublic repositories are accessible to everyone on the internet.{% if currentVersion != "free-pro-team@latest" %} Otherwise, public repositories are available to everyone using {% data variables.product.product_location_enterprise %}, including outside collaborators.{% endif %} Private repositories are only accessible to you, people you explicitly share access with, and, for organization repositories, [certain organization members](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization). {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}Internal repositories are accessible to {% if currentVersion == "free-pro-team@latest" %}members of your enterprise account{% else %}members of any organization on your instance{% endif %}. For more information, see "[About internal repositories](#about-internal-repositories)."{% endif %}
 
-Los propietarios de la organización siempre tiene acceso a todos los repositorios creados en la misma. Para obtener más información, consulta la sección "[Niveles de permiso en un repositorio para una organización](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization)".
+Organization owners always have access to every repository created in an organization. For more information, see "[Repository permission levels for an organization](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization)."
 
-Las personas con permisos de administrador para un repositorio pueden cambiar la visibilidad de los repositorios existentes. Para obtener más información, consulta la sección "[Configurar la visibilidad de los repositorios](/github/administering-a-repository/setting-repository-visibility)".
+People with admin permissions for a repository can change an existing repository's visibility. For more information, see "[Setting repository visibility](/github/administering-a-repository/setting-repository-visibility)."
 
 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}
-### Acerca de los repositorios internos
+### About internal repositories
 
 {% note %}
 
@@ -25,12 +25,11 @@ Las personas con permisos de administrador para un repositorio pueden cambiar la
 
 {% endnote %}
 
-{% data reusables.repositories.about-internal-repos %}Para obtener más información sobre innersource, consulta la documentación técnica de {% data variables.product.prodname_dotcom %} "Introducción a innersource".
+{% data reusables.repositories.about-internal-repos %} For more information on innersource, see {% data variables.product.prodname_dotcom %}'s whitepaper "[An introduction to innersource](https://resources.github.com/whitepapers/introduction-to-innersource/)."
 
-Todos los {% if currentVersion == "free-pro-team@latest" %} miembros empresariales{% else %}miembros organizacionales{% endif %}tienen permisos de lectura para los repositorios internos, pero estos no serán visibles para aquellos {% if currentVersion == "free-pro-team@latest" %} externos a la cuenta empresarial{% else %} que no sean miembros de una organización{% endif %}, incluyendo los colaboradores en repositorios organizacionales. Para obtener más información, consulta la sección {% if currentVersion == "free-pro-team@latest" %}"[Roles para una cuenta empresarial](/articles/roles-for-an-enterprise-account#enterprise-members)" y {% endif %}"[Niveles de permiso para una organización en los repositorios](/articles/repository-permission-levels-for-an-organization)".
+All {% if currentVersion == "free-pro-team@latest" %}enterprise members{% else %}organization members{% endif %} have read permissions to the internal repository, but internal repositories are not visible to people {% if currentVersion == "free-pro-team@latest" %}outside of the enterprise account{% else %}who are not members of an organization{% endif %}, including outside collaborators on organization repositories. For more information, see {% if currentVersion == "free-pro-team@latest" %}"[Roles for an enterprise account](/articles/roles-for-an-enterprise-account#enterprise-members)" and {% endif %}"[Repository permission levels for an organization](/articles/repository-permission-levels-for-an-organization)."
 
 {% data reusables.repositories.internal-repo-default %}
-Si se elimina a un usuario de
 
-{% if currentVersion == "free-pro-team@latest" %}una cuenta empresarial{% else %} todas las organizaciones en la instancia{% endif %}, que las bifurcaciones de un usuario en los repositorios internos se eliminan automáticamente.
+If a user is removed from {% if currentVersion == "free-pro-team@latest" %}an enterprise account{% else %}all organizations on the instance{% endif %}, that user's forks of internal repositories are removed automatically.
 {% endif %}
diff --git a/translations/es-XL/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md b/translations/es-XL/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md
index d177f7f5b202..5364873fbeb0 100644
--- a/translations/es-XL/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md
+++ b/translations/es-XL/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md
@@ -1,42 +1,41 @@
 ---
-title: Realizar una copia de seguridad de un repositorio
-intro: 'Puedes usar Git {% if currentVersion != "free-pro-team@latest" %} y {% endif %}la API{% if currentVersion == "free-pro-team@latest" %}o una herramienta de terceros {% endif %}para realizar una copia de seguridad de tu repositorio.'
+title: Backing up a repository
+intro: 'You can use{% if currentVersion != "free-pro-team@latest" %} Git and{% endif %} the API {% if currentVersion == "free-pro-team@latest" %}or a third-party tool {% endif %}to back up your repository.'
 redirect_from:
   - /articles/backing-up-a-repository
 versions:
   free-pro-team: '*'
   enterprise-server: '*'
 ---
-
 {% if currentVersion == "free-pro-team@latest" %}
 
-Para descargar un archivo en tu repositorio, puedes usar la API para migraciones del usuario o la organizacion. Para obtener más información, consulta la sección "[Migraciones](/v3/migrations/)".
+To download an archive of your repository, you can use the API for user or organization migrations. For more information, see "[Migrations](/v3/migrations/)."
 {% else %}
 
-Puedes descargar y realizar una copia de seguridad de tus repositorios manualmente:
+You can download and back up your repositories manually:
 
-- Para descargar los datos Git de un repositorio en tu máquina local, necesitarás clonar el repositorio. Para obtener más información, consulta "[Clonar un repositorio](/articles/cloning-a-repository)".
-- También puedes descargar las wiki de un repositorio. Para obtener más información, consulta "[Agregar o editar páginas wiki](/articles/adding-or-editing-wiki-pages)".
+- To download a repository's Git data to your local machine, you'll need to clone the repository. For more information, see "[Cloning a repository](/articles/cloning-a-repository)."
+- You can also download your repository's wiki. For more information, see "[Adding or editing wiki pages](/articles/adding-or-editing-wiki-pages)."
 
-Cuando clonas un repositorio o wiki, solo se descargan los datos Git, como archivos de proyecto o historial de confirmaciones. Puedes usar nuestra API para exportar otros elementos de tu repositorio {% data variables.product.product_name %} en tu máquina local:
+When you clone a repository or wiki, only Git data, such as project files and commit history, is downloaded. You can use our API to export other elements of your {% data variables.product.product_name %} repository to your local machine:
 
-- [Problemas](/v3/issues/#list-issues-for-a-repository)
-- [Solicitudes de extracción](/v3/pulls/#list-pull-requests)
-- [Bifurcaciones](/v3/repos/forks/#list-forks)
-- [Comentarios](/v3/issues/comments/#list-comments-in-a-repository)
-- [Hitos](/v3/issues/milestones/#list-milestones-for-a-repository)
-- [Etiquetas](/v3/issues/labels/#list-all-labels-for-this-repository)
-- [Observadores](/v3/activity/watching/#list-watchers)
-- [Stargazers](/v3/activity/starring/#list-stargazers)
-- [Proyectos](/v3/projects/#list-repository-projects)
+- [Issues](/v3/issues/#list-issues-for-a-repository)
+- [Pull requests](/v3/pulls/#list-pull-requests)
+- [Forks](/rest/reference/repos#list-forks)
+- [Comments](/rest/reference/issues#list-issue-comments-for-a-repository)
+- [Milestones](/rest/reference/issues#list-milestones)
+- [Labels](/rest/reference/issues#list-labels-for-a-repository)
+- [Watchers](/rest/reference/activity#list-watchers)
+- [Stargazers](/rest/reference/activity#list-stargazers)
+- [Projects](/v3/projects/#list-repository-projects)
 {% endif %}
 
-Una vez que tienes una versión local{% if currentVersion != "free-pro-team@latest" %} de todo el contenido del que deseas realizar una copia de seguridad, puedes crear un archivo zip y {% else %}una vez descargado tu archivo, puedes{% endif %}copiarlo en un disco duro externo o cargarlo en un servicio de copia de seguridad basado en la nube, como [Google Drive](https://www.google.com/drive/) o [Dropbox](https://www.dropbox.com/).
+Once you have {% if currentVersion != "free-pro-team@latest" %}a local version of all the content you want to back up, you can create a zip archive and {% else %}downloaded your archive, you can {% endif %}copy it to an external hard drive and/or upload it to a cloud-based backup service such as [Google Drive](https://www.google.com/drive/) or [Dropbox](https://www.dropbox.com/).
 
 {% if currentVersion == "free-pro-team@latest" %}
-### Herramientas de copias de seguridad de terceros
+### Third-party backup tools
 
-Existe un número de herramientas de autoservicio que automatizan las copias de seguridad de los repositorios. A diferencia de los proyectos de archivo, los cuales archivan _todos_ los repositorios públicos en {% data variables.product.product_name %} que no hayan optado por salir y que ponen todos los datos a disposición de cualquiera, las herramientas de respaldo descargarán los datos de repositorios _específicos_ y los organizarán en una nueva rama o directorio. Para obtener más información acerca de los proyectos de archivo, consulta la sección "[Acerca de archivar contenido y datos en {% data variables.product.prodname_dotcom %}](/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github#about-the-github-archive-program)".
+A number of self-service tools exist that automate backups of repositories. Unlike archival projects, which archive _all_ public repositories on {% data variables.product.product_name %} that have not opted out and make the data accessible to anyone, backup tools will download data from _specific_ repositories and organize it within a new branch or directory. For more information about archival projects, see "[About archiving content and data on {% data variables.product.prodname_dotcom %}](/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github#about-the-github-archive-program)."
 
-Puedes realizar una copia de seguridad de todos los datos Git de un repositorio (como archivos de proyecto e historial de confirmaciones), así como tanta información de {% data variables.product.product_name %} (como propuestas y solicitudes de extracción), con [BackHub](https://github.com/marketplace/backhub), que crea copias de seguridad diarias recurrentes de tus repositorios con instantáneas de hasta 30 días. BckHub está disponible en {% data variables.product.prodname_marketplace %}.
+You can back up all of a repository's Git data (such as project files and commit history), as well as much data from {% data variables.product.product_name %} (such as issues and pull requests), with [BackHub](https://github.com/marketplace/backhub), which creates daily recurring backups of your repositories with snapshots up to 30 days back in time. BackHub is available in {% data variables.product.prodname_marketplace %}.
 {% endif %}
diff --git a/translations/es-XL/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md b/translations/es-XL/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md
index 0d53123e1ba8..985918901d8d 100644
--- a/translations/es-XL/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md
+++ b/translations/es-XL/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md
@@ -1,19 +1,20 @@
 ---
-title: Crear un repositorio desde una plantilla
-intro: 'Puedes crear una plantilla a partir de un repositorio existente para que tanto tú como otras personas puedan generar nuevos repositorios con la misma estructura de {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}ramas y{% endif %}archivos en el directorio.'
+title: Creating a template repository
+intro: 'You can make an existing repository a template, so you and others can generate new repositories with the same directory structure{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}, branches,{% endif %} and files.'
 redirect_from:
   - /articles/creating-a-template-repository
 versions:
   free-pro-team: '*'
-  enterprise-server: '>=2.18'
+  enterprise-server: '*'
 ---
 
-Cualquier usuario con permisos de administrador para un repositorio puede convertir el repositorio en una plantilla.
+Anyone with admin permissions to a repository can make the repository a template.
 
-Para crear un repositorio de plantilla, debes crear un repositorio y luego convertirlo en una plantilla. Para obtener más información sobre la creación de repositorios, consulta "[Crear un repositorio nuevo](/articles/creating-a-new-repository)."
+To create a template repository, you must create a repository, then make the repository a template. For more information about creating a repository, see "[Creating a new repository](/articles/creating-a-new-repository)."
 
-Después de convertir tu repositorio en una plantilla, cualquiera con acceso a él puede generar un nuevo repositorio con la misma estructura de directorio y archivos que tu rama predeterminada. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} También pueden elegir incluir todas las otras ramas de tu repositorio.{% endif %} Para obtener más información, consulta la sección "[Crear un repositorio desde una plantilla](/articles/creating-a-repository-from-a-template)".
+After you make your repository a template, anyone with access to the repository can generate a new repository with the same directory structure and files as your default branch.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} They can also choose to include all the other branches in your repository.{% endif %} For more information, see "[Creating a repository from a template](/articles/creating-a-repository-from-a-template)."
 
 {% data reusables.repositories.navigate-to-repo %}
 {% data reusables.repositories.sidebar-settings %}
-3. Selecciona **Repositorio de plantilla**. ![Casilla de verificación para convertir un repositorio en una plantilla](/assets/images/help/repository/template-repository-checkbox.png)
+3. Select **Template repository**.
+  ![Checkbox to make a repository a template](/assets/images/help/repository/template-repository-checkbox.png)
diff --git a/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md b/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md
index defb7d667560..ff27712b4928 100644
--- a/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md
+++ b/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md
@@ -18,7 +18,7 @@ versions:
 
 You can use {% data variables.product.prodname_code_scanning %} to find, triage, and prioritize fixes for existing problems in your code. {% data variables.product.prodname_code_scanning_capc %} also prevents developers from introducing new problems. You can schedule scans for specific days and times, or trigger scans when a specific event occurs in the repository, such as a push.
 
-If {% data variables.product.prodname_code_scanning %} finds a potential vulnerability or error in your code, {% data variables.product.prodname_dotcom %} displays an alert in the repository. After you fix the code that triggered the alert, {% data variables.product.prodname_dotcom %} closes the alert. For more information, see "[Managing alerts from {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)."
+If {% data variables.product.prodname_code_scanning %} finds a potential vulnerability or error in your code, {% data variables.product.prodname_dotcom %} displays an alert in the repository. After you fix the code that triggered the alert, {% data variables.product.prodname_dotcom %} closes the alert. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)."
 
 To monitor results from {% data variables.product.prodname_code_scanning %} across your repositories or your organization, you can use the {% data variables.product.prodname_code_scanning %} API.
 For more information about API endpoints, see  "[{% data variables.product.prodname_code_scanning_capc %}](/v3/code-scanning)."
diff --git a/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md b/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md
index acdbe03dcc4c..af2300e7a3c5 100644
--- a/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md
+++ b/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md
@@ -1,8 +1,8 @@
 ---
-title: Configurar el escaneo de código
-intro: 'Puedes configurar la forma en que {% data variables.product.prodname_dotcom %} escanea el código en tu proyecto para encontrar vulnerabilidades y errores.'
+title: Configuring code scanning
+intro: 'You can configure how {% data variables.product.prodname_dotcom %} scans the code in your project for vulnerabilities and errors.'
 product: '{% data reusables.gated-features.code-scanning %}'
-permissions: 'Las personas con permisos de escritura en un repositorio pueden configurar {% data variables.product.prodname_code_scanning %} para el mismo.'
+permissions: 'People with write permissions to a repository can configure {% data variables.product.prodname_code_scanning %} for the repository.'
 miniTocMaxHeadingLevel: 4
 versions:
   free-pro-team: '*'
@@ -12,63 +12,66 @@ versions:
 {% data reusables.code-scanning.beta %}
 {% data reusables.code-scanning.enterprise-enable-code-scanning-actions %}
 
+### About {% data variables.product.prodname_code_scanning %} configuration
 
-### Acerca de la configuración de {% data variables.product.prodname_code_scanning %}
+You can run {% data variables.product.prodname_code_scanning %} within {% data variables.product.product_location %}, using {% data variables.product.prodname_actions %}, or from your continuous integration (CI) system, using the {% data variables.product.prodname_codeql_runner %}. For more information about {% data variables.product.prodname_actions %}, see "[About {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)." For more information about the {% data variables.product.prodname_codeql_runner %}, see "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)."
 
-You can run {% data variables.product.prodname_code_scanning %} within {% data variables.product.product_location %}, using {% data variables.product.prodname_actions %}, or from your continuous integration (CI) system, using the {% data variables.product.prodname_codeql_runner %}. Para obtener más información acerca de {% data variables.product.prodname_actions %}, consulta la sección "[Acerca de {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)". For more information about the {% data variables.product.prodname_codeql_runner %}, see "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)."
+This article is about running {% data variables.product.prodname_code_scanning %} within {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_ghe_server %}{% else %}{% data variables.product.prodname_dotcom %}{% endif %}.
 
-{% data variables.product.prodname_code_scanning_capc %} detecta y escanea automáticamente el código que se escribe en los lenguajes compatibles.
-
-Antes de que puedas configurar {% data variables.product.prodname_code_scanning %} para un repositorio, debes habilitar {% data variables.product.prodname_code_scanning %} agregando un flujo de trabajo de {% data variables.product.prodname_actions %} a dicho repositorio. El flujo de trabajo predeterminado de {% data variables.product.prodname_code_scanning %} utiliza el evento `on.push` para activar el escaneo de código cada vez que alguien carga información a cualquier rama que contenga el archivo de flujo de trabajo.
+Before you can configure {% data variables.product.prodname_code_scanning %} for a repository, you must enable {% data variables.product.prodname_code_scanning %} by adding a {% data variables.product.prodname_actions %} workflow to the repository. For more information, see "[Enabling {% data variables.product.prodname_code_scanning %} for a repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository)."
 
 {% data reusables.code-scanning.edit-workflow %}
 
 {% data variables.product.prodname_codeql %} analysis is just one type of {% data variables.product.prodname_code_scanning %} you can do in {% data variables.product.prodname_dotcom %}. {% data variables.product.prodname_marketplace %}{% if currentVersion ver_gt "enterprise-server@2.21" %} on  {% data variables.product.prodname_dotcom_the_website %}{% endif %} contains other {% data variables.product.prodname_code_scanning %} workflows you can use. {% if currentVersion == "free-pro-team@latest" %}You can find a selection of these on the "Get started with {% data variables.product.prodname_code_scanning %}" page, which you can access from the **{% octicon "shield" aria-label="The shield symbol" %} Security** tab.{% endif %} The specific examples given in this article relate to the {% data variables.product.prodname_codeql_workflow %} file.
 
-### Editing a code scanning workflow
+### Editing a {% data variables.product.prodname_code_scanning %} workflow
 
-{% data variables.product.prodname_dotcom %} guarda los archivos de flujo de trabajo en el directorio de _.github/workflows_ de tu repositorio. You can find the workflow by searching for its file name. For example, the default workflow file for CodeQL code scanning is called `codeql-analysis.yml`.
+{% data variables.product.prodname_dotcom %} saves workflow files in the _.github/workflows_ directory of your repository. You can find a workflow you have enabled by searching for its file name. For example, by default, the workflow file for {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} is called _codeql-analysis.yml_.
 
-1. En tu repositorio, navega hasta el archivo de flujo de trabajo que deseas editar.
-1. En el ángulo superior derecho de la vista del archivo, para abrir el editor de flujo de trabajo, haz clic en {% octicon "pencil" aria-label="The edit icon" %}.![Botón para editar un archivo de flujo de trabajo](/assets/images/help/repository/code-scanning-edit-workflow-button.png)
-1. Después de que hayas editado el archivo, da clic en **Iniciar confirmación** y completa el formato de "Cambios de la confirmación". Puedes elegir confirmar directamente en la rama actual, o crear una rama nueva e iniciar una solicitud de extracción. ![Confirmar la actualización del flujo de trabajo de codeql.yml](/assets/images/help/repository/code-scanning-workflow-update.png)
+1. In your repository, browse to the workflow file you want to edit.
+1. In the upper right corner of the file view, to open the workflow editor, click {% octicon "pencil" aria-label="The edit icon" %}.
+![Edit workflow file button](/assets/images/help/repository/code-scanning-edit-workflow-button.png)
+1. After you have edited the file, click **Start commit** and complete the "Commit changes" form. You can choose to commit directly to the current branch, or create a new branch and start a pull request.
+![Commit update to codeql.yml workflow](/assets/images/help/repository/code-scanning-workflow-update.png)
 
-Para obtener más información acerca de la edición de flujos de trabajo, consulta la sección "[Configurar un flujo de trabajo](/actions/configuring-and-managing-workflows/configuring-a-workflow)".
+For more information about editing workflow files, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)."
 
-### Configurar la frecuencia
+### Configuring frequency
 
-Puedes escanear código con cierta programación o cuando ocurren eventos específicos en un repositorio.
+You can configure the {% data variables.product.prodname_codeql_workflow %} to scan code on a schedule or when specific events occur in a repository.
 
-Escanear el código en cada carga al repositorio, y cada vez que se crea una solicitud de extracción, previene que los desarrolladores introduzcan vulnerabilidades y errores nuevos en dicho código. Escanear el código con una programación definida te informará de las últimas vulnerabilidades y errores que {% data variables.product.company_short %}, los investigadores de seguridad, y la comunidad descubren, aún cuando los desarrolladores no estén manteniendo el repositorio activamente.
+Scanning code when someone pushes a change, and whenever a pull request is created, prevents developers from introducing new vulnerabilities and errors into the code. Scanning code on a schedule informs you about the latest vulnerabilities and errors that {% data variables.product.company_short %}, security researchers, and the community discover, even when developers aren't actively maintaining the repository.
 
-#### Escanear cuando se carga información
+#### Scanning on push
 
-Si utilizas el flujo de trabajo predeterminado, el {% data variables.product.prodname_code_scanning %} escaneará el código en tu repositorio una vez por semana, adicionalmente a los escaneos activados por los eventos. Para ajustar este programa, edita el valor `cron` en el flujo de trabajo. Para obtener más información, consulta la sección "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#on)".
+By default, the {% data variables.product.prodname_codeql_workflow %} uses the `on.push` event to trigger a code scan on every push to the default branch of the repository and any protected branches. For {% data variables.product.prodname_code_scanning %} to be triggered on a specified branch, the workflow must exist in that branch. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#on)." 
 
-#### Escanear las solicitudes de extracción
+#### Scanning pull requests
 
-**Nota**: Las palabras clave `paths` y `paths-ignore` que se utilizan en el contexto del archivo de configuración de {% data variables.product.prodname_code_scanning %} no deberán confundirse con las mismas palabras clave cuando se utilicen para `on..paths`. Cuando se tulizan para modificar `on.` en un archivo de flujo de trabajo, éstas determinan si las acciones se ejecutarán cuando alguien modifique el código en los directorios especificados. Para obtener más información, consulta la sección "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)".
+The default {% data variables.product.prodname_codeql_workflow %} uses the `pull_request` event to trigger a code scan on the `HEAD` commit of a pull request against the default branch. {% if currentVersion ver_gt "enterprise-server@2.21" %}The `pull_request` event is not triggered if the pull request was opened from a private fork.{% else %}If a pull request is from a private fork, the `pull_request` event will only be triggered if you've selected the "Run workflows from fork pull requests" option in the repository settings. For more information, see "[Disabling or limiting {% data variables.product.prodname_actions %} for a repository](/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository#enabling-workflows-for-private-repository-forks)."{% endif %} 
 
-Para obtener más información acerca del evento `pull_request`, consulta la sección "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)".
+For more information about the `pull_request` event, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)."
 
-#### Escanear de forma pre-programada
+#### Scanning on a schedule
 
-El flujo de trabajo del {% data variables.product.prodname_code_scanning %} utiliza el evento `pull_request` para activar un escaneo de código en la confirmación `HEAD` de una solicitud de extracción. Para ajustar este programa, edita el valor `cron` en el flujo de trabajo. Para obtener más información, consulta la sección "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onschedule)".
+If you use the default {% data variables.product.prodname_codeql_workflow %}, the workflow will scan the code in your repository once a week, in addition to the scans triggered by events. To adjust this schedule, edit the `cron` value in the workflow. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onschedule)."
 
 {% note %}
 
-**Nota**: {% data variables.product.prodname_dotcom %} solo ejecuta jobs pre-programados que se encuentren en flujos de trabajo de la rama predeterminada. Cambiar la programación en un flujo de trabajo en cualquier otra rama no tendrá efecto hasta que fusiones esta rama con la predeterminada.
+**Note**: {% data variables.product.prodname_dotcom %} only runs scheduled jobs that are in workflows on the default branch. Changing the schedule in a workflow on any other branch has no effect until you merge the branch into the default branch.
 
 {% endnote %}
 
-#### Ejemplo
+#### Example
 
 The following example shows a {% data variables.product.prodname_codeql_workflow %} for a particular repository that has a default branch called `main` and one protected branch called `protected`.
 
 ``` yaml
 on:
   push:
+    branches: [main, protected]
   pull_request:
+    branches: [main]
   schedule:
     - cron: '0 15 * * 0'
 ```
@@ -78,9 +81,11 @@ This workflow scans:
 * Every pull request to the default branch
 * The default branch at 3 P.M. every Sunday
 
-### Especificar un sistema operativo
+### Specifying an operating system
+
+If your code requires a specific operating system to compile, you can configure the operating system in your {% data variables.product.prodname_codeql_workflow %}. Edit the value of `jobs.analyze.runs-on` to specify the operating system for the machine that runs your {% data variables.product.prodname_code_scanning %} actions. {% if currentVersion ver_gt "enterprise-server@2.21" %}You specify the operating system by using an appropriate label as the second element in a two-element array, after `self-hosted`.{% else %}
 
-Si tu código requiere un sistema operativo específico para compilar, puedes configurarlo en tu flujo de trabajo. Edita el valor de `jobs..runs-on` para especificar el sistema operativo para la máquina que ejecuta tus acciones de {% data variables.product.prodname_code_scanning %}. {% if currentVersion ver_gt "enterprise-server@2.21" %}You specify the operating system by using an appropriate label as the second element in a two-element array, after `self-hosted`.
+If you choose to use a self-hosted runner for code scanning, you can specify an operating system by using an appropriate label as the second element in a two-element array, after `self-hosted`.{% endif %}
 
 ``` yaml
 jobs:
@@ -88,60 +93,122 @@ jobs:
     name: Analyze
     runs-on: [self-hosted, ubuntu-latest]
 ```
-{% endif %}
 
-{% data variables.product.prodname_code_scanning_capc %} es compatible con las últimas versiones de macOs, Ubuntu, y Windows. Typical values for this setting are therefore: `ubuntu-latest`, `windows-latest`, and `macos-latest`. For more information, see {% if currentVersion ver_gt "enterprise-server@2.21" %}"[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#self-hosted-runners)" and "[Using labels with self-hosted runners](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners){% else %}"[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on){% endif %}."
+{% if currentVersion == "free-pro-team@latest" %}For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners)" and "[Adding self-hosted runners](/actions/hosting-your-own-runners/adding-self-hosted-runners)."{% endif %}
 
-### Invalidar la detección automática de lenguaje
+{% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} supports the latest versions of Ubuntu, Windows, and macOS. Typical values for this setting are therefore: `ubuntu-latest`, `windows-latest`, and `macos-latest`. For more information, see {% if currentVersion ver_gt "enterprise-server@2.21" %}"[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#self-hosted-runners)" and "[Using labels with self-hosted runners](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners){% else %}"[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on){% endif %}."
 
-{% data reusables.code-scanning.autobuild-add-build-steps %} For more information about how to configure {% data variables.product.prodname_code_scanning %} for compiled languages, see "[Configuring {% data variables.product.prodname_code_scanning %} for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages)."
+{% if currentVersion ver_gt "enterprise-server@2.21" %}You must ensure that Git is in the PATH variable on your self-hosted runners.{% else %}If you use a self-hosted runner, you must ensure that Git is in the PATH variable.{% endif %}
+
+### Changing the languages that are analyzed
+
+{% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} automatically detects code written in the supported languages.
 
 {% data reusables.code-scanning.supported-languages %}
 
+The default {% data variables.product.prodname_codeql_workflow %} file contains a build matrix called `language` which lists the languages in your repository that are analyzed. {% data variables.product.prodname_codeql %} automatically populates this matrix when you add {% data variables.product.prodname_code_scanning %} to a repository. Using the `language` matrix optimizes {% data variables.product.prodname_codeql %} to run each analysis in parallel. We recommend that all workflows adopt this configuration due to the performance benefits of parallelizing builds. For more information about build matrices, see "[Managing complex workflows](/actions/learn-github-actions/managing-complex-workflows#using-a-build-matrix)."
+
 {% data reusables.code-scanning.specify-language-to-analyze %}
 
-Para invalidar la detección automática de lenguajes, agrega `with:languages:` a la acción de `init` en tu flujo de trabajo. Las palabras clave para los lenguajes compatibles son `cpp`, `csharp`, `go`, `java`, `javascript`, y `python`.
+If your workflow uses the `language` matrix then {% data variables.product.prodname_codeql %} is hardcoded to analyze only the languages in the matrix. To change the languages you want to analyze, edit the value of the matrix variable. You can remove a language to prevent it being analyzed or you can add a language that was not present in the repository when {% data variables.product.prodname_code_scanning %} was enabled. For example, if the repository initially only contained JavaScript when {% data variables.product.prodname_code_scanning %} was enabled, and you later added Python code, you will need to add `python` to the matrix.
 
-Por ejemplo, la siguiente configuración limita a {% data variables.product.prodname_code_scanning %} para reconocer C/C++, C#, y Python.
+```yaml
+jobs:
+  analyze:
+    name: Analyze
+    ...
+    strategy:
+      fail-fast: false
+      matrix:
+        language: ['javascript', 'python']
+```
+  
+If your workflow does not contain a matrix called `language`, then {% data variables.product.prodname_codeql %} is configured to run analysis sequentially. If you don't specify languages in the workflow, {% data variables.product.prodname_codeql %} automatically detects, and attempts to analyze, any supported languages in the repository. If you want to choose which languages to analyze, without using a matrix, you can use the `languages` parameter under the `init` action.
 
-``` yaml
+```yaml
 - uses: github/codeql-action/init@v1
   with:
     languages: cpp, csharp, python
-```
+```  
+{% if currentVersion == "free-pro-team@latest" %}
+### Analyzing Python dependencies
+
+For GitHub-hosted runners that use Linux only, the {% data variables.product.prodname_codeql_workflow %} will try to auto-install Python dependencies to give more results for the CodeQL analysis. You can control this behavior by specifying the `setup-python-dependencies` parameter for the action called by the "Initialize CodeQL" step. By default, this parameter is set to `true`:
+
+-  If the repository contains code written in Python, the "Initialize CodeQL" step installs the necessary dependencies on the GitHub-hosted runner. If the auto-install succeeds, the action also sets the environment variable `CODEQL_PYTHON` to the Python executable file that includes the dependencies.
+
+- If the repository doesn't have any Python dependencies, or the dependencies are specified in an unexpected way, you'll get a warning and the action will continue with the remaining jobs. The action can run successfully even when there are problems interpreting dependencies, but the results may be incomplete.
+
+Alternatively, you can install Python dependencies manually on any operating system. You will need to add `setup-python-dependencies` and set it to `false`, as well as set `CODEQL_PYTHON` to the Python executable that includes the dependencies, as shown in this workflow extract:
 
-### Ejecutar consultas adicionales
+```yaml
+jobs:
+  CodeQL-Build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v2
+      with:
+        fetch-depth: 2
+    - name: Set up Python
+      uses: actions/setup-python@v2
+      with:
+        python-version: '3.x'
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        if [ -f requirements.txt ]; 
+        then pip install -r requirements.txt;
+        fi
+        # Set the `CODEQL-PYTHON` environment variable to the Python executable
+        # that includes the dependencies
+        echo "::set-env name=CODEQL_PYTHON::$(which python)"
+    - run: git checkout HEAD^2
+      if: ${{ github.event_name == 'pull_request' }}
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v1
+      with:
+        languages: python
+        # Override the default behavior so that the action doesn't attempt 
+        # to auto-install Python dependencies
+        setup-python-dependencies: false
+```  
+{% endif %}
+
+### Running additional queries
 
 {% data reusables.code-scanning.run-additional-queries %}
 
-Para agregar uno o más conjuntos de consultas, agrega una sección de `queries` a tu archivo de configuración.
+To add one or more queries, add a `with: queries:` entry within the `uses: github/codeql-action/init@v1` section of the workflow.
 
 ``` yaml
 - uses: github/codeql-action/init@v1
   with:
-    - queries: COMMA-SEPARATED LIST OF PATHS
+    queries: COMMA-SEPARATED LIST OF PATHS
 ```
 
-También puedes ejecutar conjuntos de consultas adicionales si los especificas en un archivo de configuración. Los conjuntos de consultas son colecciones de consultas que a menudo se agrupan por propósito o lenguaje.
+You can also specify query suites in the value of `queries`. Query suites are collections of queries, usually grouped by purpose or language.
 
 {% data reusables.code-scanning.codeql-query-suites %}
 
-Puedes ejecutar consultas adicionales si las especificas en un archivo de configuración. If you want to run the combined set of additional queries specified here and in the configuration file, prefix the value of `queries` in the workflow with the `+` symbol. Para encontrar ejemplos de archivos de configuración, consulta la sección "[Ejemplos de archivos de configuración](#example-configuration-files)".
+If you are also using a configuration file for custom settings, any additional queries specified in your workflow are used instead of any specified in the configuration file. If you want to run the combined set of additional queries specified here and in the configuration file, prefix the value of `queries` in the workflow with the `+` symbol. For more information, see "[Using a custom configuration file](#using-a-custom-configuration-file)."
 
 In the following example, the `+` symbol ensures that the specified additional queries are used together with any queries specified in the referenced configuration file.
 
 ``` yaml
 - uses: github/codeql-action/init@v1
   with:
-    - config-file: ./.github/codeql/codeql-config.yml
-    - queries: +security-and-quality,octo-org/python-qlpack/show_ifs.ql@main
+    config-file: ./.github/codeql/codeql-config.yml
+    queries: +security-and-quality,octo-org/python-qlpack/show_ifs.ql@main
 ```
 
-### Utilizar una herramienta de escaneo de código de terceros
+### Using a custom configuration file
 
 As an alternative to specifying which queries to run in the workflow file, you can do this in a separate configuration file. You can also use a configuration file to disable the default queries and to specify which directories to scan during analysis.
 
-In the workflow file, use the `config-file` parameter of the `init` action to specify the path to the configuration file you want to use. Este ejemplo carga el archivo de configuración _./.github/codeql/codeql-config.yml_.
+In the workflow file, use the `config-file` parameter of the `init` action to specify the path to the configuration file you want to use. This example loads the configuration file _./.github/codeql/codeql-config.yml_.
 
 ``` yaml
 - uses: github/codeql-action/init@v1
@@ -150,7 +217,7 @@ In the workflow file, use the `config-file` parameter of the `init` action to sp
 ```
 
 The configuration file can be located within the local repository, or in a public, remote repository. For remote repositories, you can use the _owner/repository/file.yml@branch_ syntax. The settings in the file are written in YAML format.
-
+ 
 #### Specifying additional queries
 
 You specify additional queries in a `queries` array. Each element of the array contains a `uses` parameter with a value that identifies a single query file, a directory containing query files, or a query suite definition file.
@@ -166,11 +233,11 @@ Optionally, you can give each array element a name, as shown in the example conf
 
 For more information about additional queries, see "[Running additional queries](#running-additional-queries)" above.
 
-#### Inhabilitar las consultas predeterminadas
+#### Disabling the default queries
 
-Si solo quieres ejecutar consultas personalizadas, puedes inhabilitar las consultas de seguridad predeterminadas si agregas `disable-default-queries: true` a tu archivo de configuración.
+If you only want to run custom queries, you can disable the default security queries by using `disable-default-queries: true`.
 
-#### Especificar directorios para escanear
+#### Specifying directories to scan
 
 For the interpreted languages that {% data variables.product.prodname_codeql %} supports (Python and JavaScript/TypeScript), you can restrict {% data variables.product.prodname_code_scanning %} to files in specific directories by adding a `paths` array to the configuration file. You can exclude the files in specific directories from scans by adding a `paths-ignore` array.
 
@@ -184,38 +251,39 @@ paths-ignore:
 
 {% note %}
 
-**Note**:
+**Note**: 
 
-* The `paths` and `paths-ignore` keywords, used in the context of the {% data variables.product.prodname_code_scanning %} configuration file, should not be confused with the same keywords when used for `on..paths` in a workflow. When they are used to modify `on.` in a workflow, they determine whether the actions will be run when someone modifies code in the specified directories. Para obtener más información, consulta la sección "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)".
-* `**` **Note**: `**` characters can only be at the start or end of a line, or surrounded by slashes, and you can't mix `**` and other characters. Por ejemplo, `foo/**`, `**/foo`, y `foo/**/bar` son todas sintaxis permitidas, pero `**foo` no lo es. Sin embargo, puedes utilizar asteriscos sencillos con otros caracteres, tal como se muestra en el ejemplo. You'll need to quote anything that contains a `*` character.
+* The `paths` and `paths-ignore` keywords, used in the context of the {% data variables.product.prodname_code_scanning %} configuration file, should not be confused with the same keywords when used for `on..paths` in a workflow. When they are used to modify `on.` in a workflow, they determine whether the actions will be run when someone modifies code in the specified directories. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)."
+* `**` characters can only be at the start or end of a line, or surrounded by slashes, and you can't mix `**` and other characters. For example, `foo/**`, `**/foo`, and `foo/**/bar` are all allowed syntax, but `**foo` isn't. However you can use single stars along with other characters, as shown in the example. You'll need to quote anything that contains a `*` character.
 
 {% endnote %}
 
-Para C/C++, C# y Java, si quieres limitar el {% data variables.product.prodname_code_scanning %} para directorios específicos en tu proyecto, deberás especificar los pasos de compilación adecuados en el flujo de trabajo. Los comandos que necesites utilizar para excluir un directorio de la compilación dependerán en tu sistema de compilación. For more information, see "[Configuring the {% data variables.product.prodname_codeql %} action for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages#adding-build-steps-for-a-compiled-language)."
+For C/C++, C#, and Java, if you want to limit {% data variables.product.prodname_code_scanning %} to specific directories in your project, you must specify appropriate build steps in the workflow. The commands you need to use to exclude a directory from the build will depend on your build system. For more information, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)."
 
-Puedes analizar rápidamente partes pequeñas de un monorepo cuando modificas el código en directorios específicos. Necesitarás tanto excluir los directorios en tus pasos de compilación como utilizar las palabras clave `paths-ignore` y `paths` para [`on.`](https://help.github.com/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths) en tu archivo de flujo de trabajo.
+You can quickly analyze small portions of a monorepo when you modify code in specific directories. You'll need to both exclude directories in your build steps and use the `paths-ignore` and `paths` keywords for [`on.`](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths) in your workflow.
 
-#### Ejemplos de archivos de configuración
+#### Example configuration files
 
 {% data reusables.code-scanning.example-configuration-files %}
 
-### Configurar {% data variables.product.prodname_code_scanning %} para los lenguajes compilados
+### Configuring {% data variables.product.prodname_code_scanning %} for compiled languages
 
-{% data reusables.code-scanning.autobuild-compiled-languages %}
+{% data reusables.code-scanning.autobuild-compiled-languages %} {% data reusables.code-scanning.analyze-go %}
 
-{% data reusables.code-scanning.autobuild-add-build-steps %} For more information about how to configure {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} for compiled languages, see "[Configuring the {% data variables.product.prodname_codeql %} action for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages)."
+{% data reusables.code-scanning.autobuild-add-build-steps %} For more information about how to configure {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} for compiled languages, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages)."
 
-### Acceder a repositorios privados
+### Accessing private repositories
 
-Si tu flujo de trabajo para {% data variables.product.prodname_code_scanning %} accede a repositorios privados en {% data variables.product.prodname_dotcom %}, necesitarás configurar Git para autenticarte con un token de acceso personal. Define el secreto en el ambiente del ejecutor utilizando `jobs..steps.env` en tu flujo de trabajo antes de cualquier acción de {% data variables.product.prodname_codeql %}. Para obtener más información, consulta la sección "[Crear un token de acceso personal para la línea de comandos](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)" y "[Crear y almacenar secretos cifrados](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)".
+If your workflow for {% data variables.product.prodname_code_scanning %} accesses a private repository, other than the repository that contains the workflow, you'll need to configure Git to authenticate with a personal access token. Define the secret in the runner environment by using `jobs..steps.env` in your workflow before any {% data variables.product.prodname_codeql %} actions. For more information, see "[Creating a personal access token for the command line](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)" and "[Creating and storing encrypted secrets](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)."
 
-Por ejemplo, la siguiente configuración hace que Git reemplace las URL completas en los repositorios `github/foo`, `github/bar`, y `github/baz` en {% data variables.product.prodname_dotcom_the_website %} con las URL que incluyen el token de acceso personal que almacenas en la variable de ambiente `ACCESS_TOKEN`.
+For example, the following configuration has Git replace the full URLs to the `github/foo`, `github/bar`, and `github/baz` repositories on {% data variables.product.prodname_dotcom_the_website %} with URLs that include the personal access token that you store in the `ACCESS_TOKEN` environment variable.
 
 {% raw %}
 ```yaml
 steps:
-- name: Configure access to private repository on GitHub.com
-  env: TOKEN: ${{ secrets. ACCESS_TOKEN }}
+- name: Configure access to private repositories
+  env:
+    TOKEN: ${{ secrets.ACCESS_TOKEN }}
   run: |
     git config --global url."https://${TOKEN}@github.com/github/foo".insteadOf "https://github.com/github/foo"
     git config --global url."https://${TOKEN}@github.com/github/bar".insteadOf "https://github.com/github/bar"
@@ -223,6 +291,6 @@ steps:
 ```
 {% endraw %}
 
-### Puedes escribir un archivo de configuración para {% data variables.product.prodname_code_scanning %}.
+### Uploading {% data variables.product.prodname_code_scanning %} data to {% data variables.product.prodname_dotcom %}
 
-{% data variables.product.prodname_dotcom %} can display code analysis data generated externally by a third-party tool. Puedes mostrar el análisis de código de una herramienta de terceros en {% data variables.product.prodname_dotcom %} su agregas la acción `upload-sarif` en tu flujo de trabajo. Para obtener más información, consulta la sección "[Cargar un archivo SARIF a GitHub](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)".
+{% data variables.product.prodname_dotcom %} can display code analysis data generated externally by a third-party tool. You can upload code analysis data with the `upload-sarif` action. For more information, see "[Uploading a SARIF file to GitHub](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)."
diff --git a/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md b/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md
index 14a835f18f1a..f4cabb2462b7 100644
--- a/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md
+++ b/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md
@@ -27,23 +27,91 @@ You decide how you generate {% data variables.product.prodname_code_scanning %}
 
 {% data reusables.repositories.navigate-to-repo %}
 {% data reusables.repositories.sidebar-security %}
-3. To the right of "Code scanning", click **Set up code scanning**.
- !["Set up code scanning" button to the right of "Code scanning" in the Security Overview](/assets/images/help/security/overview-set-up-code-scanning.png)
-4. Under "Get started with code scanning", click **Set up this workflow** on the {% data variables.product.prodname_codeql_workflow %} or on a third-party workflow.
- !["Set up this workflow" button under "Get started with code scanning" heading](/assets/images/help/repository/code-scanning-set-up-this-workflow.png)
-5. Optionally, to customize how {% data variables.product.prodname_code_scanning %} scans your code, edit the workflow. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)."
+3. To the right of "{% data variables.product.prodname_code_scanning_capc %}", click **Set up {% data variables.product.prodname_code_scanning %}**.
+ !["Set up {% data variables.product.prodname_code_scanning %}" button to the right of "{% data variables.product.prodname_code_scanning_capc %}" in the Security Overview](/assets/images/help/security/overview-set-up-code-scanning.png)
+4. Under "Get started with {% data variables.product.prodname_code_scanning %}", click **Set up this workflow** on the {% data variables.product.prodname_codeql_workflow %} or on a third-party workflow.
+ !["Set up this workflow" button under "Get started with {% data variables.product.prodname_code_scanning %}" heading](/assets/images/help/repository/code-scanning-set-up-this-workflow.png)
+5. To customize how {% data variables.product.prodname_code_scanning %} scans your code, edit the workflow.
+
+   Generally you can commit the {% data variables.product.prodname_codeql_workflow %} without making any changes to it. However, many of the third-party workflows require additional configuration, so read the comments in the workflow before committing.
+
+   For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)."
 6. Use the **Start commit** drop-down, and type a commit message.
  ![Start commit](/assets/images/help/repository/start-commit-commit-new-file.png)
 7. Choose whether you'd like to commit directly to the default branch, or create a new branch and start a pull request.
  ![Choose where to commit](/assets/images/help/repository/start-commit-choose-where-to-commit.png)
 8. Click **Commit new file** or **Propose new file**.
 
-After you commit the workflow file or create a pull request, {% data variables.product.prodname_code_scanning %} will analyze your code according to the frequency you specified in your workflow file. If you created a pull request, {% data variables.product.prodname_code_scanning %} will only analyze the code on the pull request's topic branch until you merge the pull request into the default branch of the repository.
+In the default {% data variables.product.prodname_codeql_workflow %}, {% data variables.product.prodname_code_scanning %} is configured to analyze your code each time you either push a change to the default branch or any protected branches, or raise a pull request against the default branch or any protected branches. As a result, {% data variables.product.prodname_code_scanning %} will now commence.
+
+### Viewing the logging output from {% data variables.product.prodname_code_scanning %}
+
+After enabling {% data variables.product.prodname_code_scanning %} for your repository, you can watch the output of the actions as they run.
+
+{% data reusables.repositories.actions-tab %}
+
+  You'll see a list that includes an entry for running the {% data variables.product.prodname_code_scanning %} workflow.
+
+  ![Actions list showing {% data variables.product.prodname_code_scanning %} workflow](/assets/images/help/repository/code-scanning-actions-list.png)
+
+1. Click the entry for the {% data variables.product.prodname_code_scanning %} workflow.
+
+1. Click the job name on the left. For example, **Analyze (LANGUAGE)**.
+
+  ![Log output from the {% data variables.product.prodname_code_scanning %} workflow](/assets/images/help/repository/code-scanning-logging-analyze-action.png)
+
+1. Review the logging output from the actions in this workflow as they run.
+
+1. Once all jobs are complete, you can view the details of any {% data variables.product.prodname_code_scanning %} alerts that were identified. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository#viewing-an-alert)."
+
+{% note %}
+
+**Note:** If you raised a pull request to add the {% data variables.product.prodname_code_scanning %} workflow to the repository, alerts from that pull request aren't displayed directly on the {% data variables.product.prodname_code_scanning_capc %} page until the pull request is merged. If any alerts were found you can view these, before the pull request is merged, by clicking the **_n_ alerts found** link in the banner on the {% data variables.product.prodname_code_scanning_capc %} page.
+
+  ![Click the "n alerts found" link](/assets/images/help/repository/code-scanning-alerts-found-link.png)
+
+{% endnote %}
+
+### Understanding the pull request checks
+
+Each {% data variables.product.prodname_code_scanning %} workflow you enable to run on pull requests always has at least two entries listed in the checks section of a pull request. There is one entry for each of the analysis jobs in the workflow, and a final one for the results of the analysis.
+
+The names of the {% data variables.product.prodname_code_scanning %} analysis checks take the form: "TOOL NAME / JOB NAME (TRIGGER)." For example, for {% data variables.product.prodname_codeql %}, analysis of C++ code has the entry "{% data variables.product.prodname_codeql %} / Analyze (cpp) (pull_request)." You can click **Details** on a {% data variables.product.prodname_code_scanning %} analysis entry to see logging data. This allows you to debug a problem if the analysis job failed. For example, for {% data variables.product.prodname_code_scanning %} analysis of compiled languages, this can happen if the action can't build the code.
+
+  ![{% data variables.product.prodname_code_scanning %} pull request checks](/assets/images/help/repository/code-scanning-pr-checks.png)
+
+When the {% data variables.product.prodname_code_scanning %} jobs complete, {% data variables.product.prodname_dotcom %} works out whether any alerts were added by the pull request and adds the "{% data variables.product.prodname_code_scanning_capc %} results / TOOL NAME" entry to the list of checks. After {% data variables.product.prodname_code_scanning %} has been performed at least once, you can click **Details** to view the results of the analysis. If you used a pull request to add {% data variables.product.prodname_code_scanning %} to the repository, you will initially see a "Missing analysis" message when you click **Details** on the "{% data variables.product.prodname_code_scanning_capc %} results / TOOL NAME" check.
+
+  ![Missing analysis for commit message](/assets/images/help/repository/code-scanning-missing-analysis.png)
+
+#### Reasons for the "missing analysis" message
+
+After {% data variables.product.prodname_code_scanning %} has analyzed the code in a pull request, it needs to compare the analysis of the topic branch (the branch you used to create the pull request) with the analysis of the base branch (the branch into which you want to merge the pull request). This allows {% data variables.product.prodname_code_scanning %} to compute which alerts are newly introduced by the pull request, which alerts were already present in the base branch, and whether any existing alerts are fixed by the changes in the pull request. Initially, if you use a pull request to add {% data variables.product.prodname_code_scanning %} to a repository, the base branch has not yet been analyzed, so it's not possible to compute these details. In this case, when you click through from the results check on the pull request you will see the "Missing analysis for base commit SHA-HASH" message.
+
+There are other situations where there may be no analysis for the latest commit to the base branch for a pull request. These include:
+
+* The pull request has been raised against a branch other than the default branch or a protected branch, and this branch hasn't been analyzed.
+
+  To check whether a branch has been scanned, go to the {% data variables.product.prodname_code_scanning_capc %} page, click the **Branch** drop-down and select the relevant branch.
+
+  ![Choose a branch from the Branch drop-down menu](/assets/images/help/repository/code-scanning-branch-dropdown.png)
+
+  The solution in this situation is to add the name of the base branch to the `on:push` and `on:pull_request` specification in the {% data variables.product.prodname_code_scanning %} workflow on that branch and then make a change that updates the open pull request that you want to scan.
+
+* The latest commit on the base branch for the pull request is currently being analyzed and analysis is not yet available.
+
+  Wait a few minutes and then push a change to the pull request to retrigger {% data variables.product.prodname_code_scanning %}.
+
+* An error occurred while analyzing the latest commit on the base branch and analysis for that commit isn't available.
+
+  Merge a trivial change into the base branch to trigger {% data variables.product.prodname_code_scanning %} on this latest commit, then push a change to the pull request to retrigger {% data variables.product.prodname_code_scanning %}.
 
 ### Next steps
 
-After you enable {% data variables.product.prodname_code_scanning %}, you can monitor analysis, view results, and further customize how you scan your code.
+After enabling {% data variables.product.prodname_code_scanning %}, and allowing its actions to complete, you can:
 
-- You can view the run status of {% data variables.product.prodname_code_scanning %} and get notifications for completed runs. For more information, see "[Managing a workflow run](/actions/configuring-and-managing-workflows/managing-a-workflow-run)" and "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)."
-- After a scan completes, you can view alerts from a completed scan. For more information, see "[Managing alerts from {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)."
-- You can customize how {% data variables.product.prodname_code_scanning %} scans the code in your repository. For more information, see "[Configuring code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)."
+- View all of the {% data variables.product.prodname_code_scanning %} alerts generated for this repository. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)."
+- View any alerts generated for a pull request submitted after you enabled {% data variables.product.prodname_code_scanning %}. For more information, see "[Triaging {% data variables.product.prodname_code_scanning %} alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests)."
+- Set up notifications for completed runs. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)."
+- Investigate any problems that occur with the initial setup of {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %}. For more information, see "[Troubleshooting the {% data variables.product.prodname_codeql %} workflow](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow)."
+- Customize how {% data variables.product.prodname_code_scanning %} scans the code in your repository. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)."
diff --git a/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md b/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md
new file mode 100644
index 000000000000..5b7faf0e62b0
--- /dev/null
+++ b/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md
@@ -0,0 +1,161 @@
+---
+title: Running CodeQL code scanning in your CI system
+shortTitle: Running in your CI
+intro: 'You can use the {% data variables.product.prodname_codeql_runner %} to perform {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in a third-party continuous integration system.'
+product: '{% data reusables.gated-features.code-scanning %}'
+redirect_from:
+  - /github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.code-scanning.beta-codeql-runner %}
+{% data reusables.code-scanning.beta %}
+{% data reusables.code-scanning.enterprise-enable-code-scanning %}
+
+### Using {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} with your existing CI system
+
+If you use a continuous integration or continuous delivery/deployment (CI/CD) system other than {% data variables.product.prodname_actions %}, you can use your existing system to run {% data variables.product.prodname_dotcom %}'s {% data variables.product.prodname_codeql %} analysis and upload the results to {% data variables.product.prodname_dotcom %}. To do this, use the {% data variables.product.prodname_codeql_runner %}.
+
+### About the {% data variables.product.prodname_codeql_runner %}
+
+{% data reusables.code-scanning.about-code-scanning %} For information, see "[About {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)."
+
+You can use the {% data variables.product.prodname_codeql_runner %} to run {% data variables.product.prodname_code_scanning %} on code that you're processing in a third-party continuous integration (CI) system. Alternatively, you can use {% data variables.product.prodname_actions %} to run {% data variables.product.prodname_code_scanning %} on {% data variables.product.product_location %}. For information, see "[Enabling {% data variables.product.prodname_code_scanning %} for a repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository)."
+
+The {% data variables.product.prodname_codeql_runner %} is a command-line tool that runs {% data variables.product.prodname_codeql %} analysis on a checkout of a {% data variables.product.prodname_dotcom %} repository. You add the runner to your third-party system, then call the runner to analyze code and upload the results to {% data variables.product.product_location %}. These results are displayed as {% data variables.product.prodname_code_scanning %} alerts in the repository.
+
+{% data reusables.code-scanning.codeql-runner-license %}
+
+### Downloading the {% data variables.product.prodname_codeql_runner %}
+
+You can download the {% data variables.product.prodname_codeql_runner %} from https://github.com/github/codeql-action/releases. On some operating systems, you may need to change permissions for the downloaded file before you can run it.
+
+On Linux:
+
+```shell
+chmod +x codeql-runner-linux
+```
+
+On MacOS:
+
+```shell
+chmod +x codeql-runner-macos
+sudo xattr -d com.apple.quarantine codeql-runner-macos
+```
+
+On Windows, the `codeql-runner-win.exe` file usually requires no change to permissions.
+
+### Adding the {% data variables.product.prodname_codeql_runner %} to your CI system
+
+Once you have downloaded the {% data variables.product.prodname_codeql_runner %} and verified that it can be executed, you should make the runner available to each CI server that you intend to use for {% data variables.product.prodname_code_scanning %}. It is important to notice that each CI server that you intend to use for {% data variables.product.prodname_code_scanning %} needs to have the {% data variables.product.prodname_codeql_runner %}. You might configure each server to copy the runner from a central, internal location, or you could use the REST API to get the runner direct from GitHub, for example: 
+
+```shell
+wget https://github.com/github/codeql-action/releases/download/codeql-bundle-20200826/codeql-runner-linux 
+chmod +x codeql-runner-linux
+```
+
+In addition to this, each CI server also needs:
+
+- A {% data variables.product.prodname_github_apps %} or personal access token for the {% data variables.product.prodname_codeql_runner %} to use. For private repositories  the token must have the `repo` scope. For public the token needs only the `public_repo` and `repo:security_events` scopes. For information, see "[Building {% data variables.product.prodname_github_apps %}](/developers/apps/building-github-apps)" and "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token)."
+- Access to the {% data variables.product.prodname_codeql %} bundle associated with this release of the {% data variables.product.prodname_codeql_runner %}. This package contains the {% data variables.product.prodname_codeql %} CLI, queries, and libraries needed for {% data variables.product.prodname_codeql %} analysis. For information, see "[{% data variables.product.prodname_codeql %} CLI](https://help.semmle.com/codeql/codeql-cli.html)."
+
+The options for providing access to the {% data variables.product.prodname_codeql %} bundle are:
+
+1. Allow the CI servers access to {% data variables.product.prodname_dotcom_the_website %} so that the {% data variables.product.prodname_codeql_runner %} can download the bundle automatically.
+1. Manually download/extract the bundle, store it with other central resources, and use the `--codeql-path` flag to specify the location of the bundle in calls to initialize the {% data variables.product.prodname_codeql_runner %}.
+{% if currentVersion != "free-pro-team@latest" %}
+1. You can mirror the `github/codeql-action` repository on {% data variables.product.product_location %}. Unless you specify the `--codeql-path` flag, the runner automatically checks for the bundle in this location and on {% data variables.product.prodname_dotcom_the_website %}.{% endif %}
+
+### Calling the {% data variables.product.prodname_codeql_runner %}
+
+You should call the {% data variables.product.prodname_codeql_runner %} from the checkout location of the repository you want to analyze. The two main commands are:
+
+1. `init` required to initialize the runner and create a {% data variables.product.prodname_codeql %} database for each language to be analyzed. These databases are populated and analyzed by subsequent commands.
+1. `analyze` required to populate the {% data variables.product.prodname_codeql %} databases, analyze them, and upload results to {% data variables.product.product_location %}.
+
+For both commands, you must specify the URL of {% data variables.product.product_location %}, the repository *OWNER/NAME*, and the GitHub Apps or personal access token to use for authentication. You also need to specify the location of the CodeQL bundle unless the CI server has access to download it directly from the `github/codeql-action` repository on {% data variables.product.prodname_dotcom_the_website %}{% if currentVersion != "free-pro-team@latest" %} or mirrored on {% data variables.product.product_location %}{% endif %}.
+
+You can configure where the {% data variables.product.prodname_codeql_runner %} stores the CodeQL bundle for future analysis on a server using the `--tools-dir` flag and where it stores temporary files during analysis using `--temp-dir`.
+
+To view the command-line reference for the runner, use the `-h` flag. For example, to list all commands run: `codeql-runner-OS -h`, or to list all the flags available for the `init` command run: `codeql-runner-OS init -h` (where `OS` varies according to the executable that you are using). For more information, see "[Configuring {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system#codeql-runner-command-reference)."
+
+#### Basic example
+
+This example runs {% data variables.product.prodname_codeql %} analysis on a Linux CI server for the `octo-org/example-repo` repository hosted on `{% data variables.command_line.git_url_example %}`. The process is very simple because the repository contains only languages that can be analyzed by {% data variables.product.prodname_codeql %} directly, without being built (that is, Go, JavaScript, Python, and TypeScript).
+
+1. Check out the repository to analyze.
+1. Move into the directory where the repository is checked out.
+1. Initialize the {% data variables.product.prodname_codeql_runner %} and create {% data variables.product.prodname_codeql %} databases for the languages detected.
+
+    ```shell
+    $ /path/to-runner/codeql-runner-linux init --repository octo-org/example-repo
+        --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN
+    > Cleaning temp directory /srv/checkout/example-repo/codeql-runner
+    > ...
+    > Created CodeQL database at /srv/checkout/example-repo/codeql-runner/codeql_databases/javascript.
+    ```
+
+1. Populate the {% data variables.product.prodname_codeql_runner %} databases, analyze them, and upload the results to {% data variables.product.product_name %}.
+
+    ```shell
+    $ /path/to-runner/codeql-runner-linux analyze --repository octo-org/example-repo
+        --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN
+        --commit 5b6a3078b31dc346e5ce7b86837d6abbe7a18bbd --ref refs/heads/main
+    > Finalizing database creation
+    > ...
+    > POST /repos/octo-org/example-repo/code-scanning/sarifs - 202 in 786ms
+    > Successfully uploaded results
+    ```
+
+The server has access to download the {% data variables.product.prodname_codeql %} bundle directly from the `github/codeql-action` repository on {% data variables.product.prodname_dotcom_the_website %}{% if currentVersion != "free-pro-team@latest" %} or mirrored on {% data variables.product.product_location %}{% endif %}, so there is no need to use the `--codeql-path` flag. When the analysis is complete, the {% data variables.product.prodname_codeql_runner %} uploads the results to the {% data variables.product.prodname_code_scanning %} view. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)."
+
+#### Compiled language example
+
+This example is similar to the previous example, however this time the repository has code in C/C++, C#, or Java. To create a {% data variables.product.prodname_codeql %} database for these languages, the CLI needs to monitor the build. At the end of the initialization process, the runner reports the command you need to set up the environment before building the code. You need to run this command, before calling the normal CI build process, and then running the `analyze` command.
+
+1. Check out the repository to analyze.
+1. Move into the directory where the repository is checked out.
+1. Initialize the {% data variables.product.prodname_codeql_runner %} and create {% data variables.product.prodname_codeql %} databases for the languages detected.
+
+    ```shell
+    $ /path/to-runner/codeql-runner-linux init --repository octo-org/example-repo-2
+        --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN
+    > Cleaning temp directory /srv/checkout/example-repo-2/codeql-runner
+    > ...
+    > CodeQL environment output to "/srv/checkout/example-repo-2/codeql-runner/codeql-env.json"
+      and "/srv/checkout/example-repo-2/codeql-runner/codeql-env.sh".
+      Please export these variables to future processes so the build can be traced, for example by running "
+      . /srv/checkout/example-repo-2/codeql-runner/codeql-env.sh".
+      ```
+
+1. Run the script generated by the `init` action to set up the environment to monitor the build.
+
+    ```shell
+    $ . /srv/checkout/example-repo-2/codeql-runner/codeql-env.sh
+    ```
+
+1. Build the code.
+1. Populate the {% data variables.product.prodname_codeql %} databases, analyze them, and upload the results to GitHub.
+
+    ```shell
+    $ /path/to-runner/codeql-runner-linux analyze --repository octo-org/example-repo-2
+        --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN
+        --commit ae7b655ef30b50fb726ae7b3daa79571a39d194d --ref refs/heads/main
+    > Finalizing database creation
+    > ...
+    > POST /repos/octo-org/example-repo-2/code-scanning/sarifs - 202 in 573ms
+    > Successfully uploaded results
+    ```
+
+{% note %}
+
+**Note:** If you use a containerized build, you need to run the {% data variables.product.prodname_codeql_runner %} in the container where your build task takes place.
+
+{% endnote %}
+
+### Further reading
+
+- "[Configuring {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system)"
+- "[Troubleshooting {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system)"
diff --git a/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md b/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md
new file mode 100644
index 000000000000..f42dbb3db617
--- /dev/null
+++ b/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md
@@ -0,0 +1,125 @@
+---
+title: Troubleshooting the CodeQL workflow
+shortTitle: Troubleshooting CodeQL
+intro: 'If you''re having problems with {% data variables.product.prodname_code_scanning %}, you can troubleshoot by using these tips for resolving issues.'
+product: '{% data reusables.gated-features.code-scanning %}'
+redirect_from:
+  - /github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.code-scanning.beta %}
+
+### Automatic build for a compiled language fails
+
+If an automatic build of code for a compiled language within your project fails, try the following troubleshooting steps.
+
+- Remove the `autobuild` step from your {% data variables.product.prodname_code_scanning %} workflow and add specific build steps. For information about editing the workflow, see  "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)." For more information about replacing the `autobuild` step, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)."
+
+- If your workflow doesn't explicitly specify the languages to analyze, {% data variables.product.prodname_codeql %} implicitly detects the supported languages in your code base. In this configuration, out of the compiled languages C/C++, C#, and Java, {% data variables.product.prodname_codeql %} only analyzes the language with the most source files. Edit the workflow and add a build matrix specifying the languages you want to analyze. The default CodeQL analysis workflow uses such a matrix. 
+
+  The following extracts from a workflow show how you can use a matrix within the job strategy to specify languages, and then reference each language within the "Initialize {% data variables.product.prodname_codeql %}" step:
+
+  ```yaml
+  jobs:
+    analyze:
+      ...
+      strategy:
+        fail-fast: false
+        matrix:
+          language: ['csharp', 'cpp', 'javascript']
+
+      ...
+
+      - name: Initialize {% data variables.product.prodname_codeql %}
+        uses: github/codeql-action/init@v1
+        with:
+          languages: {% raw %}${{ matrix.language }}{% endraw %}
+  ```
+   
+  For more information about editing the workflow, see "[Configuring code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)."
+
+### No code found during the build
+
+If your workflow fails with an error `No source code was seen during the build` or `The process '/opt/hostedtoolcache/CodeQL/0.0.0-20200630/x64/codeql/codeql' failed with exit code 32`, this indicates that {% data variables.product.prodname_codeql %} was unable to monitor your code. Several reasons can explain such a failure:
+
+1. Automatic language detection identified a supported language, but there is no analyzable code of that language in the repository. A typical example is when our language detection service finds a file associated with a particular programming language like a `.h`, or `.gyp` file, but no corresponding executable code is present in the repository. To solve the problem, you can manually define the languages you want to analyze by updating the list of languages in the `language` matrix. For example, the following configuration will analyze only Go, and JavaScript.
+
+  ```yaml
+  strategy:
+    fail-fast: false
+    matrix:
+      # Override automatic language detection by changing the list below
+      # Supported options are:
+      # ['csharp', 'cpp', 'go', 'java', 'javascript', 'python']
+      language: ['go', 'javascript']
+  ```
+For more information, see the workflow extract in "[Automatic build for a compiled language fails](#automatic-build-for-a-compiled-language-fails)" above.
+1. Your {% data variables.product.prodname_code_scanning %} workflow is analyzing a compiled language (C, C++, C#, or Java), but the code was not compiled. By default, the {% data variables.product.prodname_codeql %} analysis workflow contains an `autobuild` step, however, this step represents a best effort process, and may not succeed in building your code, depending on your specific build environment. Compilation may also fail if you have removed the `autobuild` step and did not include build steps manually.  For more information about specifying build steps, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)."
+1. Your workflow is analyzing a compiled language (C, C++, C#, or Java), but portions of your build are cached to improve performance (most likely to occur with build systems like Gradle or Bazel). Since {% data variables.product.prodname_codeql %} observes the activity of the compiler to understand the data flows in a repository, {% data variables.product.prodname_codeql %} requires a complete build to take place in order to perform analysis. 
+1. Your workflow is analyzing a compiled language (C, C++, C#, or Java), but compilation does not occur between the `init` and `analyze` steps in the workflow. {% data variables.product.prodname_codeql %} requires that your build happens in between these two steps in order to observe the activity of the compiler and perform analysis. 
+1. Your compiled code (in C, C++, C#, or Java) was compiled successfully, but {% data variables.product.prodname_codeql %} was unable to detect the compiler invocations. The most common causes are certain configuration options like running your build process in a container, if you're building using a distributed build system external to {% data variables.product.prodname_actions %} using a daemon process, or if {% data variables.product.prodname_codeql %} isn't aware of the specific compiler you are using. 
+
+  For C# projects using either `dotnet build` or `msbuild` which target .NET Core 2, you should specify `/p:UseSharedCompilation=false` in your workflow's `run` step, when you build your code. The `UseSharedCompilation` flag isn't necessary for .NET Core 3.0 and later.
+  
+  For example, the following configuration for C# will pass the flag during the first build step.
+
+   ``` yaml
+   - run: |
+       dotnet build /p:UseSharedCompilation=false 
+   ```
+
+  If you encounter another problem with your specific compiler or configuration, contact {% data variables.contact.contact_support %}.
+
+For more information about specifying build steps, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." 
+
+### Portions of my repository were not analyzed using `autobuild`
+
+The {% data variables.product.prodname_codeql %} `autobuild` feature uses heuristics to build the code in a repository, however, sometimes this approach results in incomplete analysis of a repository. For example, when multiple `build.sh` commands exist in a single repository, the analysis may not complete since the `autobuild` step will only execute one of the commands. The solution is to replace the `autobuild` step with build steps which build all of the source code which you wish to analyze. For more information, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)."
+
+### Error: "Server error"
+
+If the run of a workflow for {% data variables.product.prodname_code_scanning %} fails due to a server error, try running the workflow again. If the problem persists, contact {% data variables.contact.contact_support %}.
+
+### Error: "Out of disk" or "Out of memory"
+
+On very large projects, {% data variables.product.prodname_codeql %} may run out of disk or memory on the runner.
+{% if currentVersion == "free-pro-team@latest" %}If you encounter this issue on a hosted {% data variables.product.prodname_actions %} runner, contact {% data variables.contact.contact_support %} so that we can investigate the problem.
+{% else %}If you encounter this issue, try increasing the memory on the runner.{% endif %}
+
+### The build takes too long
+
+If your build with {% data variables.product.prodname_codeql %} analysis takes too long to run, there are several approaches you can try to reduce the build time. 
+
+#### Increase the memory or cores
+
+If you use self-hosted runners to run {% data variables.product.prodname_codeql %} analysis, you can increase the memory or the number of cores on those runners.
+
+#### Use matrix builds to parallelize the analysis
+
+The default {% data variables.product.prodname_codeql_workflow %} uses a build matrix of languages, which causes the analysis of each language to run in parallel. If you have specified the languages you want to analyze directly in the "Initialize CodeQL" step, analysis of each language will happen sequentially. To speed up analysis of multiple languages, modify your workflow to use a matrix. For more information, see the workflow extract in "[Automatic build for a compiled language fails](#automatic-build-for-a-compiled-language-fails)" above.
+
+#### Reduce the amount of code being analyzed in a single workflow
+
+Analysis time is typically proportional to the amount of code being analyzed. You can reduce the analysis time by reducing the amount of code being analyzed at once, for example, by excluding test code, or breaking analysis into multiple workflows that analyze only a subset of your code at a time.
+
+For compiled languages like Java, C, C++, and C#, {% data variables.product.prodname_codeql %} analyzes all of the code which was built during the workflow run. To limit the amount of code being analyzed, build only the code which you wish to analyze by specifying your own build steps in a `run` block. You can combine specifying your own build steps with using the `paths` or `paths-ignore` filters on the `pull_request` and `push` events to ensure that your workflow only runs when specific code is changed. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)."
+
+For interpreted languages like Go, JavaScript, Python, and TypeScript, that {% data variables.product.prodname_codeql %} analyzes without a specific build, you can specify additional configuration options to limit the amount of code to analyze. For more information, see "[Specifying directories to scan](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#specifying-directories-to-scan)."
+
+If you split your analysis into multiple workflows as described above, we still recommend that you have at least one workflow which runs on a `schedule` which analyzes all of the code in your repository. Because {% data variables.product.prodname_codeql %} analyzes data flows between components, some complex security behaviors may only be detected on a complete build. 
+
+#### Run only during a `schedule` event
+
+If your analysis is still too slow to be run during `push` or `pull_request` events, then you may want to only trigger analysis on the `schedule` event. For more information, see "[Events](/actions/learn-github-actions/introduction-to-github-actions#events)."
+
+{% if currentVersion == "free-pro-team@latest" %}
+### Results differ between analysis platforms
+
+If you are analyzing code written in Python, you may see different results depending on whether you run the {% data variables.product.prodname_codeql_workflow %} on Linux, macOS, or Windows.
+
+On GitHub-hosted runners that use Linux, the {% data variables.product.prodname_codeql_workflow %} tries to install and analyze Python dependencies, which could lead to more results. To disable the auto-install, add `setup-python-dependencies: false` to the "Initialize CodeQL" step of the workflow. For more information about configuring the analysis of Python dependencies, see "[Analyzing Python dependencies](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#analyzing-python-dependencies)."
+
+{% endif %}
\ No newline at end of file
diff --git a/translations/es-XL/content/github/managing-large-files/removing-files-from-git-large-file-storage.md b/translations/es-XL/content/github/managing-large-files/removing-files-from-git-large-file-storage.md
index 90b7409ccef4..9290d04394dc 100644
--- a/translations/es-XL/content/github/managing-large-files/removing-files-from-git-large-file-storage.md
+++ b/translations/es-XL/content/github/managing-large-files/removing-files-from-git-large-file-storage.md
@@ -1,6 +1,6 @@
 ---
-title: Eliminar archivos de Git Large File Storage
-intro: 'Si has configurado {% data variables.large_files.product_name_short %} para tu repositorio, puedes eliminar todos los archivos o un subconjunto de archivos desde {% data variables.large_files.product_name_short %}.'
+title: Removing files from Git Large File Storage
+intro: 'If you''ve set up {% data variables.large_files.product_name_short %} for your repository, you can remove all files or a subset of files from {% data variables.large_files.product_name_short %}.'
 redirect_from:
   - /articles/removing-files-from-git-large-file-storage
 versions:
@@ -8,45 +8,45 @@ versions:
   enterprise-server: '*'
 ---
 
-### Eliminar un único archivo
+### Removing a single file
 
-1.  Elimina el archivo del historial del repositorio de Git utilizando el comando `filter-branch` o BFG Repo-Cleaner. Para obtener información detallada sobre sus usos, consulta "[Eliminar datos confidenciales de un repositorio](/articles/removing-sensitive-data-from-a-repository)".
-2. Navega hasta tu archivo *.gitattributes*.
+1.  Remove the file from the repository's Git history using either the `filter-branch` command or BFG Repo-Cleaner. For detailed information on using these, see "[Removing sensitive data from a repository](/articles/removing-sensitive-data-from-a-repository)."
+2. Navigate to your *.gitattributes* file.
 
   {% note %}
 
-  **Nota:** Tu archivo *.gitattributes* generalmente se guarda dentro de tu repositorio local. En algunos casos, puede que hayas creado un archivo *.gitattributes* global que contiene todas tus {% data variables.large_files.product_name_short %} asociaciones.
+  **Note:** Your *.gitattributes* file is generally saved within your local repository. In some cases, you may have created a global *.gitattributes* file that contains all of your {% data variables.large_files.product_name_short %} associations.
 
   {% endnote %}
-3. Encuentra y elimina la regla de seguimiento {% data variables.large_files.product_name_short %} asociada dentro del archivo *.gitattributes*.
-4. Guarda y cierra el archivo *.gitattributes*.
+3. Find and remove the associated {% data variables.large_files.product_name_short %} tracking rule within the *.gitattributes* file.
+4. Save and exit the *.gitattributes* file.
 
-### Eliminar todos los archivos dentro de un repositorio {% data variables.large_files.product_name_short %}
+### Removing all files within a {% data variables.large_files.product_name_short %} repository
 
-1. Eliminar los archivos del historial de Git del repositorio usando el comando `filter-branch` o BFG Repo-Cleaner. Para obtener información detallada sobre sus usos, consulta "[Eliminar datos confidenciales de un repositorio](/articles/removing-sensitive-data-from-a-repository)".
-2. De manera opcional, para desinstalar {% data variables.large_files.product_name_short %} en el repositorio, ejecuta:
+1. Remove the files from the repository's Git history using either the `filter-branch` command or BFG Repo-Cleaner. For detailed information on using these, see "[Removing sensitive data from a repository](/articles/removing-sensitive-data-from-a-repository)."
+2. Optionally, to uninstall {% data variables.large_files.product_name_short %} in the repository, run:
   ```shell
   $ git lfs uninstall
   ```
-  Para las versiones {% data variables.large_files.product_name_short %} más bajas que 1.1.0, ejecuta:
+  For {% data variables.large_files.product_name_short %} versions below 1.1.0, run:
   ```shell
   $ git lfs uninit
   ```
 
-### objetos {% data variables.large_files.product_name_short %} en tu repositorio
+### {% data variables.large_files.product_name_short %} objects in your repository
 
-Después de eliminar archivos de {% data variables.large_files.product_name_short %}, los objetos {% data variables.large_files.product_name_short %} siguen existiendo en el almacenamiento remoto{% if currentVersion == "free-pro-team@latest" %} y seguirán contabilizando en tu {% data variables.large_files.product_name_short %} cuota de almacenamiento{% endif %}.
+After you remove files from {% data variables.large_files.product_name_short %}, the {% data variables.large_files.product_name_short %} objects still exist on the remote storage{% if currentVersion == "free-pro-team@latest" %} and will continue to count toward your {% data variables.large_files.product_name_short %} storage quota{% endif %}.
 
-Para eliminar objetos de {% data variables.large_files.product_name_short %} de un repositorio, {% if currentVersion == "free-pro-team@latest" %}bórralo y vuelve a crearlo. Cuando se borra un repositorio también se borra cualquier informe de problemas, estrellas y bifurcaciones asociados al mismo. Para obtener más información, consulta la sección "[Borrar un repositorio](/github/administering-a-repository/deleting-a-repository)".{% else %}contacta a tu administrador de {% data variables.product.prodname_enterprise %} para archivar los objetos. Los objetos archivados se purgan después de tres meses.{% endif %}
+To remove {% data variables.large_files.product_name_short %} objects from a repository, {% if currentVersion == "free-pro-team@latest" %}delete and recreate the repository. When you delete a repository, any associated issues, stars, and forks are also deleted. For more information, see "[Deleting a repository](/github/administering-a-repository/deleting-a-repository)."{% else %}contact your {% data variables.product.prodname_enterprise %} administrator to archive the objects. Archived objects are purged after three months.{% endif %}
 
 {% note %}
 
-**Nota:** Si eliminaste un solo archivo y tienes otros objetos de {% data variables.large_files.product_name_short %} que quieres mantener en tu repositorio, después de borrar y volver a crear dicho repositorio, reconfigura tus archivos asociados de {% data variables.large_files.product_name_short %}. Para obtener más información, consulta la sección "[Eliminar un solo archivo](#removing-a-single-file)" y "[{% data variables.large_files.product_name_long %}](/github/managing-large-files/configuring-git-large-file-storage)".
+**Note:** If you removed a single file and have other {% data variables.large_files.product_name_short %} objects that you'd like to keep in your repository, after deleting and recreating your repository, reconfigure your {% data variables.large_files.product_name_short %}-associated files. For more information, see "[Removing a single file](#removing-a-single-file)" and "[Configuring {% data variables.large_files.product_name_long %}](/github/managing-large-files/configuring-git-large-file-storage)."
 
 {% endnote %}
 
-### Leer más
+### Further reading
 
-- "[Acerca de {% data variables.large_files.product_name_long %}](/articles/about-git-large-file-storage)"
-- "[Colaborar con {% data variables.large_files.product_name_long %}](/articles/collaboration-with-git-large-file-storage)"
-- "[Instalar {% data variables.large_files.product_name_long %}](/articles/installing-git-large-file-storage)"
+- "[About {% data variables.large_files.product_name_long %}](/articles/about-git-large-file-storage)"
+- "[Collaboration with {% data variables.large_files.product_name_long %}](/articles/collaboration-with-git-large-file-storage/)"
+- "[Installing {% data variables.large_files.product_name_long %}](/articles/installing-git-large-file-storage)"
diff --git a/translations/es-XL/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md b/translations/es-XL/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md
index 73b8dce6840a..0ce617f2fdb2 100644
--- a/translations/es-XL/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md
+++ b/translations/es-XL/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md
@@ -77,15 +77,15 @@ We send security alerts to people with admin permissions in the affected reposit
 ### Configuring notifications for {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %}
 
 {% if currentVersion == "free-pro-team@latest" %}
-By default, you will receive {% data variables.product.prodname_dependabot_alerts %} by email, grouped by the specific vulnerability. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-options)."
+By default, you will receive {% data variables.product.prodname_dependabot_alerts %} by email, grouped by the specific vulnerability. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-notification-options)."
 {% endif %}
 
 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %}
-By default, if your site administrator has configured email for notifications on your instance, you will receive {% data variables.product.prodname_dependabot_alerts %} by email. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-options)."
+By default, if your site administrator has configured email for notifications on your instance, you will receive {% data variables.product.prodname_dependabot_alerts %} by email. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-notification-options)."
 {% endif %}
 
 {% if currentVersion != "free-pro-team@latest" and currentVersion == "enterprise-server@2.21" %}
-By default, if your site administrator has configured email for notifications on your instance, you will receive security alerts by email. You can also choose to receive security alerts in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#security-alert-options)."
+By default, if your site administrator has configured email for notifications on your instance, you will receive security alerts by email. You can also choose to receive security alerts in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#security-alert-notification-options)."
 {% endif %}
 
 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.21" %}
diff --git a/translations/es-XL/content/github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests.md b/translations/es-XL/content/github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests.md
index 6ddc1346b68e..53a67879b052 100644
--- a/translations/es-XL/content/github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests.md
+++ b/translations/es-XL/content/github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests.md
@@ -1,6 +1,6 @@
 ---
-title: Adjuntos de archivos en propuestas y solicitudes de extracción
-intro: 'Cuando abres una propuesta o actualizas una solicitud de extracción, puedes usar los adjuntos de propuestas para cargar imágenes de las características propuestas o capturas de pantalla de errores.'
+title: File attachments on issues and pull requests
+intro: 'When you open issue or update a pull request, you can use issue attachments to upload images of proposed features or screenshots of bugs.'
 redirect_from:
   - /articles/issue-attachments/
   - /articles/file-attachments-on-issues-and-pull-requests
@@ -8,34 +8,33 @@ versions:
   free-pro-team: '*'
   enterprise-server: '*'
 ---
-
 {% warning %}
 
-**Advertencia:** Si agregas una imagen a una solicitud de extracción o un comentario sobre una propuesta, cualquier usuario podrá ver la URL de la imagen anonimizada sin autenticación, aun si la solicitud de extracción se encuentra en un repositorio privado{% if currentVersion != "free-pro-team@latest" %} o si el modo privado se encuentra habilitado{% endif %}. Para mantener las imágenes confidenciales en privado, limítalas a una red privada o a un servidor que requiera de autenticación. {% if currentVersion == "free-pro-team@latest" %}Para obtener más información acerca de las URL anonimizadas, consulta "[Acerca de las URL de imágenes anonimizadas](/articles/about-anonymized-image-urls)".{% endif %}
+**Warning:** If you add an image to a pull request or issue comment, anyone can view the anonymized image URL without authentication, even if the pull request is in a private repository{% if currentVersion != "free-pro-team@latest" %}, or if private mode is enabled{% endif %}. To keep sensitive images private, serve them from a private network or server that requires authentication. {% if currentVersion == "free-pro-team@latest" %}For more information on anonymized URLs see "[About anonymized image URLs](/articles/about-anonymized-image-urls)".{% endif %}
 
 {% endwarning %}
 
-Para adjuntar un archivo a una propuesta o una conversación de una solicitud de extracción, arrástralo y suéltalo en el cuadro de comentarios. Como alternativa, puedes dar clic en la barra al final del recuadro de comentarios para buscar, seleccionar y agregar un archivo desde tu ordenador.
+To attach a file to an issue or pull request conversation, drag and drop it into the comment box. Alternatively, you can click the bar at the bottom of the comment box to browse, select, and add a file from your computer.
 
-![Seleccionar adjuntos desde el ordenador](/assets/images/help/pull_requests/select-bar.png)
+![Select attachments from computer](/assets/images/help/pull_requests/select-bar.png)
 
 {% tip %}
 
-**Sugerencia:** Si estás usando Chrome, también puedes copiar y pegar las imágenes directamente en el cuadro.
+**Tip:** If you're using Chrome, you can also copy-and-paste images directly into the box.
 
 {% endtip %}
 
-El tamaño máximo de los archivos es de 25 MB y el tamaño máximo de las imágenes es de 10 MB.
+The maximum size for files is 25MB and the maximum size for images is 10MB.
 
-Archivos compatibles:
+We support these files:
 
 * PNG (*.png*)
 * GIF (*.gif*)
 * JPEG (*.jpg*)
-* Archivos de registro (*.log*)
-* Documentos de Microsoft Word (*.docx*), Powerpoint (*.pptx*) y Excel (*.xlsx*)
-* Archivos de texto (*.txt*)
-* PDF (*.pdf*)
+* Log files (*.log*)
+* Microsoft Word (*.docx*), Powerpoint (*.pptx*), and Excel (*.xlsx*) documents
+* Text files (*.txt*)
+* PDFs (*.pdf*)
 * ZIP (*.zip*, *.gz*)
 
-![GIF animados adjuntos](/assets/images/help/pull_requests/dragging_images.gif)
+![Attachments animated GIF](/assets/images/help/pull_requests/dragging_images.gif)
diff --git a/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/adding-organization-members-to-a-team.md b/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/adding-organization-members-to-a-team.md
index 3c188473e618..6b112565b6de 100644
--- a/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/adding-organization-members-to-a-team.md
+++ b/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/adding-organization-members-to-a-team.md
@@ -1,6 +1,6 @@
 ---
-title: Agregar miembros de la organización a un equipo
-intro: 'Las personas con permisos de propietario o mantenedor del equipo pueden agregar miembros de la organización a los equipos. Las personas con permisos de propietario también pueden {% if currentVersion == "free-pro-team@latest" %} invitar a personas que no son miembros {% else %}a incorporar a personas que no son miembros a{% endif %} un equipo y la organización.'
+title: Adding organization members to a team
+intro: 'People with owner or team maintainer permissions can add organization members to teams. People with owner permissions can also {% if currentVersion == "free-pro-team@latest" %}invite non-members to join{% else %}add non-members to{% endif %} a team and the organization.'
 redirect_from:
   - /articles/adding-organization-members-to-a-team-early-access-program/
   - /articles/adding-organization-members-to-a-team
@@ -15,13 +15,14 @@ versions:
 {% data reusables.profile.access_org %}
 {% data reusables.organizations.specific_team %}
 {% data reusables.organizations.team_members_tab %}
-6. Encima de la lista de los miembros del equipo, haz clic en **Add a member** (Agregar un miembro). ![Botón Add member (Agregar miembro)](/assets/images/help/teams/add-member-button.png)
+6. Above the list of team members, click **Add a member**.
+![Add member button](/assets/images/help/teams/add-member-button.png)
 {% data reusables.organizations.invite_to_team %}
 {% data reusables.organizations.review-team-repository-access %}
 
 {% if currentVersion == "free-pro-team@latest" %}{% data reusables.organizations.cancel_org_invite %}{% endif %}
 
-### Leer más
+### Further reading
 
-- [Acerca de los equipos](/articles/about-teams)"
-- "[Administrar el acceso del equipo al repositorio de una organización](/articles/managing-team-access-to-an-organization-repository)"
+- "[About teams](/articles/about-teams)"
+- "[Managing team access to an organization repository](/articles/managing-team-access-to-an-organization-repository)"
diff --git a/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/converting-an-outside-collaborator-to-an-organization-member.md b/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/converting-an-outside-collaborator-to-an-organization-member.md
index f2f7c5a0d160..be985f927923 100644
--- a/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/converting-an-outside-collaborator-to-an-organization-member.md
+++ b/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/converting-an-outside-collaborator-to-an-organization-member.md
@@ -1,6 +1,6 @@
 ---
-title: Convertir un colaborador externo en un miembro de la organización
-intro: 'Si deseas que un colaborador externo en los repositorios de la organización tenga más permisos dentro de tu organización, puedes {% if currentVersion == "free-pro-team@latest" %}invitarlo a convertirse en miembro de{% else %}convertirlo en miembro de{% endif %} la organización.'
+title: Converting an outside collaborator to an organization member
+intro: 'If you would like to give an outside collaborator on your organization''s repositories broader permissions within your organization, you can {% if currentVersion == "free-pro-team@latest" %}invite them to become a member of{% else %}make them a member of{% endif %} the organization.'
 redirect_from:
   - /articles/converting-an-outside-collaborator-to-an-organization-member
 versions:
@@ -11,9 +11,9 @@ versions:
 {% tip %}
 
 **Tips**:
-- Solo los propietarios de la organización pueden {% if currentVersion == "free-pro-team@latest" %}invitar a los usuarios a unirse a{% else %}agregar a usuarios a{% endif %} una organización. Para obtener más información, consulta "[Niveles de permiso para una organización](/articles/permission-levels-for-an-organization)".{% if currentVersion == "free-pro-team@latest" %}
-- Si tu organización está en una suscripción de pago por usuario, debes contar con una licencia sin utilizarse antes de que puedas invitar a un nuevo miembro a unirse a tu organización o a reinstalar a un miembro previo de la misma. Para obtener más información, consulta "[About per-user pricing](/articles/about-per-user-pricing)". {% data reusables.organizations.org-invite-expiration %}{% endif %}
-- Si tu organización [requiere que los miembros usen autenticación de dos factores](/articles/requiring-two-factor-authentication-in-your-organization), los usuarios {% if currentVersion == "free-pro-team@latest" %}que invites deben [habilitar la autenticación de dos factores](/articles/securing-your-account-with-two-factor-authentication-2fa) antes de que puedan aceptar la invitación.{% else %}debe [habilitar la autenticación de dos factores](/articles/securing-your-account-with-two-factor-authentication-2fa) antes de que puedas agregarla a la organización.{% endif %}
+- Only organization owners can {% if currentVersion == "free-pro-team@latest" %}invite users to join{% else %}add users to{% endif %} an organization. For more information, see "[Permission levels for an organization](/articles/permission-levels-for-an-organization)."{% if currentVersion == "free-pro-team@latest" %}
+- If your organization is on a paid per-user subscription, an unused license must be available before you can invite a new member to join the organization or reinstate a former organization member. For more information, see "[About per-user pricing](/articles/about-per-user-pricing)." {% data reusables.organizations.org-invite-expiration %}{% endif %}
+- If your organization [requires members to use two-factor authentication](/articles/requiring-two-factor-authentication-in-your-organization), users {% if currentVersion == "free-pro-team@latest" %}you invite must [enable two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa) before they can accept the invitation.{% else %}must [enable two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa) before you can add them to the organization.{% endif %}
 
 {% endtip %}
 
@@ -22,10 +22,9 @@ versions:
 {% data reusables.organizations.people %}
 {% data reusables.organizations.people_tab_outside_collaborators %}
 {% if currentVersion == "free-pro-team@latest" %}
-5. To the right of the name of the outside collaborator you want to become a member, use the
-{% octicon "gear" aria-label="The gear icon" %} drop-down menu and click **Invite to organization**.![Invitar colaboradores externos a la organización](/assets/images/help/organizations/invite_outside_collaborator_to_organization.png)
+5. To the right of the name of the outside collaborator you want to become a member, use the {% octicon "gear" aria-label="The gear icon" %} drop-down menu and click **Invite to organization**.![Invite outside collaborators to organization](/assets/images/help/organizations/invite_outside_collaborator_to_organization.png)
 {% else %}
-5. A la derecha del nombre del colaborador externo que quieres hacer miembro, haz clic en **Invite to organization** (Invitar a la organización).![Invitar colaboradores externos a la organización](/assets/images/enterprise/orgs-and-teams/invite_outside_collabs_to_org.png)
+5. To the right of the name of the outside collaborator you want to become a member, click **Invite to organization**.![Invite outside collaborators to organization](/assets/images/enterprise/orgs-and-teams/invite_outside_collabs_to_org.png)
 {% endif %}
 {% data reusables.organizations.choose-to-restore-privileges %}
 {% data reusables.organizations.choose-user-role-send-invitation %}
@@ -33,6 +32,6 @@ versions:
 {% data reusables.organizations.user_must_accept_invite_email %} {% data reusables.organizations.cancel_org_invite %}
 {% endif %}
 
-### Leer más
+### Further reading
 
-- "[Convertir a un miembro de la organización en colaborador externo](/articles/converting-an-organization-member-to-an-outside-collaborator)"
+- "[Converting an organization member to an outside collaborator](/articles/converting-an-organization-member-to-an-outside-collaborator)"
diff --git a/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization.md b/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization.md
index 5a4e63a1e22d..f3231626ad45 100644
--- a/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization.md
+++ b/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization.md
@@ -10,9 +10,9 @@ versions:
 
 ### About restrictions on publication of {% data variables.product.prodname_pages %} sites
 
-You can control whether members of your organization can publish websites from repositories in your organization using {% data variables.product.prodname_pages %}. Para obtener más información acerca de {% data variables.product.prodname_pages %}, consulta la sección "[Acerca de {% data variables.product.prodname_pages %}](/github/working-with-github-pages/about-github-pages)".
+You can control whether members of your organization can publish websites from repositories in your organization using {% data variables.product.prodname_pages %}. For more information about {% data variables.product.prodname_pages %}, see "[About {% data variables.product.prodname_pages %}](/github/working-with-github-pages/about-github-pages)."
 
-{% if currentVersion != "free-pro-team@latest" %}If your site administrator has enabled Public Pages, {% endif %}{% data variables.product.prodname_pages %} sites are publicly available on the internet, even if the repository for the site is private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %}. Para obtener más información, consulta la sección {% if currentVersion != "free-pro-team@latest" %}"[Configurar {% data variables.product.prodname_pages %} en tu aplicativo](/enterprise/admin/installation/configuring-github-pages-on-your-appliance#making-github-pages-publicly-accessible)" y {% endif %} "[Acerca de la visibilidad de un repositorio](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)".
+{% if currentVersion != "free-pro-team@latest" %}If your site administrator has enabled Public Pages, {% endif %}{% data variables.product.prodname_pages %} sites are publicly available on the internet, even if the repository for the site is private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %}. For more information, see{% if currentVersion != "free-pro-team@latest" %} "[Configuring {% data variables.product.prodname_pages %} on your appliance](/enterprise/admin/installation/configuring-github-pages-on-your-appliance#making-github-pages-publicly-accessible)" and{% endif %} "[About repository visibility](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)."
 
 ### Disabling publication of {% data variables.product.prodname_pages %} sites
 
@@ -22,5 +22,7 @@ After you disable publication of {% data variables.product.prodname_pages %} sit
 {% data reusables.profile.access_org %}
 {% data reusables.organizations.org_settings %}
 {% data reusables.organizations.member-privileges %}
-1. Under "Pages creation", unselect **Allow members to publish sites**. ![Unselected checkbox for "Allow members to publish sites" option](/assets/images/help/organizations/org-settings-pages-disable-publication-checkbox.png)
-1. Haz clic en **Save (Guardar)**. !["Save" button for "Allow members to publish sites" option](/assets/images/help/organizations/org-settings-pages-disable-publication-save-button.png)
+1. Under "Pages creation", unselect **Allow members to publish sites**.
+  ![Unselected checkbox for "Allow members to publish sites" option](/assets/images/help/organizations/org-settings-pages-disable-publication-checkbox.png)
+1. Click **Save**.
+  !["Save" button for "Allow members to publish sites" option](/assets/images/help/organizations/org-settings-pages-disable-publication-save-button.png)
diff --git a/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-outside-collaborators-access-to-your-organization.md b/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-outside-collaborators-access-to-your-organization.md
index 8a163fa235e0..90f63f350be0 100644
--- a/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-outside-collaborators-access-to-your-organization.md
+++ b/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-outside-collaborators-access-to-your-organization.md
@@ -1,6 +1,6 @@
 ---
-title: Reinstalar el acceso de un colaborador externo antiguo a tu organización
-intro: 'Si requeriste la autenticación de dos factores en tu organización, y se eliminó un colaborador externo de la organización por no tener la 2FA habilitada, puedes reinstalar los permisos de acceso de un colaborador externo antiguo para los repositorios, las bifurcaciones y los parámetros de la organización.'
+title: Reinstating a former outside collaborator's access to your organization
+intro: 'If you required two-factor authentication in your organization and an outside collaborator was removed from the organization for not having 2FA enabled, you can reinstate a former outside collaborator''s access permissions for organization repositories, forks, and settings.'
 redirect_from:
   - /articles/reinstating-a-former-outside-collaborator-s-access-to-your-organization
   - /articles/reinstating-a-former-outside-collaborators-access-to-your-organization
@@ -9,25 +9,25 @@ versions:
   enterprise-server: '*'
 ---
 
-Si se eliminó el acceso de un colaborador externo a los repositorios privados de tu organización porque les requeriste a [los miembros y colaboradores externos que habilitaran la autenticación de dos factores](/articles/requiring-two-factor-authentication-in-your-organization), los privilegios y parámetros de acceso del usuario se guardarán durante tres meses. Puedes restaurar los privilegios del usuario si lo vuelves a {% if currentVersion == "free-pro-team@latest" %}invitar{% else %}agregar{% endif %} a la organización en el transcurso de ese tiempo.
+If an outside collaborator's access to your organization's private repositories is removed because you've [required members and outside collaborators to enable two-factor authentication](/articles/requiring-two-factor-authentication-in-your-organization), the user's access privileges and settings are saved for three months. You can restore the user's privileges if you {% if currentVersion == "free-pro-team@latest" %}invite{% else %}add{% endif %} them back to the organization within that time frame.
 
 {% data reusables.two_fa.send-invite-to-reinstate-user-before-2fa-is-enabled %}
 
-Cuando reinstalas un colaborador externo antiguo, puedes restaurar lo siguiente:
- - El acceso antiguo del usuario a los repositorios de la organización
- - Cualquier bifurcación privada de los repositorios que son propiedad de la organización
- - La membresía a los equipos de la organización
- - El acceso y los permisos previos para los repositorios de la organización
- - Las estrellas para los repositorios de la organización
- - Las asignaciones de propuestas en la organización
- - Las suscripciones a repositorios (los parámetros de notificaciones para observar, no observar o ignorar la actividad de un repositorio)
+When you reinstate a former outside collaborator, you can restore:
+ - The user's former access to organization repositories
+ - Any private forks of repositories owned by the organization
+ - Membership in the organization's teams
+ - Previous access and permissions for the organization's repositories
+ - Stars for organization repositories
+ - Issue assignments in the organization
+ - Repository subscriptions (notification settings for watching, not watching, or ignoring a repository's activity)
 
 {% tip %}
 
 **Tips**:
- - Solo los propietarios de la organización pueden reinstalar el acceso de colaboradores externos a una organización. Para obtener más información, consulta "[Niveles de permiso para una organización](/articles/permission-levels-for-an-organization)".
- - Puede que el flujo de reinstalación de un miembro en {% data variables.product.product_location %} utilice el término "miembro" para describir la reinstalación de un colaborador externo, pero si reinstalas a esta persona y mantienes sus privilegios previos, solo tendrá los [permisos de colaborador externo](/articles/permission-levels-for-an-organization/#outside-collaborators) anteriores.{% if currentVersion == "free-pro-team@latest" %}
- - Si tu organización tiene una suscripción de pago por usuario, debe de existir una licencia sin utilizarse antes de que puedas invitar a un nuevo miembro para que se una a la organización o antes de reinstalar a algún mimbro previo de la misma. Para obtener más información, consulta "[Acerca del precio por usuario](/articles/about-per-user-pricing)."{% endif %}
+ - Only organization owners can reinstate outside collaborators' access to an organization. For more information, see "[Permission levels for an organization](/articles/permission-levels-for-an-organization)."
+ - The reinstating a member flow on {% data variables.product.product_location %} may use the term "member" to describe reinstating an outside collaborator but if you reinstate this person and keep their previous privileges, they will only have their previous [outside collaborator permissions](/articles/permission-levels-for-an-organization/#outside-collaborators).{% if currentVersion == "free-pro-team@latest" %}
+ - If your organization has a paid per-user subscription, an unused license must be available before you can invite a new member to join the organization or reinstate a former organization member. For more information, see "[About per-user pricing](/articles/about-per-user-pricing)."{% endif %}
 
 {% endtip %}
 
@@ -37,35 +37,37 @@ Cuando reinstalas un colaborador externo antiguo, puedes restaurar lo siguiente:
 {% data reusables.organizations.invite_member_from_people_tab %}
 {% data reusables.organizations.reinstate-user-type-username %}
 {% if currentVersion == "free-pro-team@latest" %}
-6. Decide si quieres restaurar los privilegios antiguos del colaborador externo en la organización haciendo clic en **Invite and reinstate** (Invitar y reinstalar) o decide eliminar los privilegios antiguos y establecer nuevos permisos de acceso haciendo clic en **Invite and start fresh** (Invitar e iniciar de nuevo).
+6. Choose to restore the outside collaborator's previous privileges in the organization by clicking **Invite and reinstate** or choose to clear their previous privileges and set new access permissions by clicking **Invite and start fresh**.
 
   {% warning %}
 
-  **Advertencia:** Si quieres subir de categoría el colaborador externo a miembro de tu organización, elige **Invite and start fresh** (Invitar e iniciar de nuevo) y elige un rol nuevo para esta persona. Sin embargo, ten en cuenta que las bifurcaciones privadas de los repositorios de tu organización de esa persona se perderán si decides iniciar de nuevo. En cambio, para hacer que el colaborador externo antiguo sea miembro de tu organización *y* conserve sus bifurcaciones privadas, elige **Invite and reinstate** (Invitar y reinstalar). Una vez que esta persona acepte la invitación, puedes convertirla en miembro de la organización [invitándola a que se una a la organización como miembro](/articles/converting-an-outside-collaborator-to-an-organization-member).
+  **Warning:** If you want to upgrade the outside collaborator to a member of your organization, then choose **Invite and start fresh** and choose a new role for this person. Note, however, that this person's private forks of your organization's repositories will be lost if you choose to start fresh. To make the former outside collaborator a member of your organization *and* keep their private forks, choose **Invite and reinstate** instead. Once this person accepts the invitation, you can convert them to an organization member by [inviting them to join the organization as a member](/articles/converting-an-outside-collaborator-to-an-organization-member).
 
   {% endwarning %}
 
-  ![Decide si quieres restaurar los parámetros o no](/assets/images/help/organizations/choose_whether_to_restore_org_member_info.png)
+  ![Choose to restore settings or not](/assets/images/help/organizations/choose_whether_to_restore_org_member_info.png)
 {% else %}
-6. Decide si quieres restaurar los privilegios antiguos del colaborador externo en la organización haciendo clic en **Add and reinstate** (Agregar y reinstalar) o decide eliminar los privilegios antiguos y establecer nuevos permisos de acceso haciendo clic en **Add and start fresh** (Agregar e iniciar de nuevo).
+6. Choose to restore the outside collaborator's previous privileges in the organization by clicking **Add and reinstate** or choose to clear their previous privileges and set new access permissions by clicking **Add and start fresh**.
 
   {% warning %}
 
-  **Advertencia:** Si quieres subir de categoría el colaborador externo a miembro de tu organización, elige **Add and start fresh** (Agregar e iniciar de nuevo) y elige un rol nuevo para esta persona. Sin embargo, ten en cuenta que las bifurcaciones privadas de los repositorios de tu organización de esa persona se perderán si decides iniciar de nuevo. En cambio, para hacer que el colaborador externo antiguo sea miembro de tu organización *y* conserve sus bifurcaciones privadas, elige **Add and reinstate** (Agregar y reinstalar). Luego puedes convertirla en miembro de la organización [agregándola a la organización como miembro](/articles/converting-an-outside-collaborator-to-an-organization-member).
+  **Warning:** If you want to upgrade the outside collaborator to a member of your organization, then choose **Add and start fresh** and choose a new role for this person. Note, however, that this person's private forks of your organization's repositories will be lost if you choose to start fresh. To make the former outside collaborator a member of your organization *and* keep their private forks, choose **Add and reinstate** instead. Then, you can convert them to an organization member by [adding them to the organization as a member](/articles/converting-an-outside-collaborator-to-an-organization-member).
 
   {% endwarning %}
 
-  ![Decide si quieres restaurar los parámetros o no](/assets/images/help/organizations/choose_whether_to_restore_org_member_info_ghe.png)
+  ![Choose to restore settings or not](/assets/images/help/organizations/choose_whether_to_restore_org_member_info_ghe.png)
 {% endif %}
 {% if currentVersion == "free-pro-team@latest" %}
-7. Si eliminaste los privilegios anteriores de un colaborador externo antiguo, elige un rol para el usuario y, de manera opcional, agrégalo a algunos equipos, luego haz clic en **Send invitation** (Enviar invitación). ![Opciones de rol y equipo y botón para enviar invitación](/assets/images/help/organizations/add-role-send-invitation.png)
+7. If you cleared the previous privileges for a former outside collaborator, choose a role for the user and optionally add them to some teams, then click **Send invitation**.
+  ![Role and team options and send invitation button](/assets/images/help/organizations/add-role-send-invitation.png)
 {% else %}
-7. Si eliminaste los privilegios anteriores de un colaborador externo antiguo, elige un rol para el usuario y, de manera opcional, agrégalo a algunos equipos, luego haz clic en **Add member** (Agregar miembro). ![Opciones de rol y equipo y botón para agregar miembros](/assets/images/help/organizations/add-role-add-member.png)
+7. If you cleared the previous privileges for a former outside collaborator, choose a role for the user and optionally add them to some teams, then click **Add member**.
+  ![Role and team options and add member button](/assets/images/help/organizations/add-role-add-member.png)
 {% endif %}
 {% if currentVersion == "free-pro-team@latest" %}
-8. La persona invitada recibirá un correo electrónico invitándola a la organización. Tendrá que aceptar la invitación antes de convertirse en colaborador externo de la organización. {% data reusables.organizations.cancel_org_invite %}
+8. The invited person will receive an email inviting them to the organization. They will need to accept the invitation before becoming an outside collaborator in the organization. {% data reusables.organizations.cancel_org_invite %}
 {% endif %}
 
-### Leer más
+### Further Reading
 
-- "[Niveles de permiso del repositorio para una organización](/articles/repository-permission-levels-for-an-organization)"
+- "[Repository permission levels for an organization](/articles/repository-permission-levels-for-an-organization)"
diff --git a/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md b/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md
index f256f2c28fdb..b0029b8eeabf 100644
--- a/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md
+++ b/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md
@@ -202,7 +202,8 @@ For more information, see "[Restricting publication of {% data variables.product
 | `remove_outside_collaborator` | Triggered when an owner removes an outside collaborator from an organization or when [two-factor authentication is required in an organization](/articles/requiring-two-factor-authentication-in-your-organization) and an outside collaborator does not use 2FA or disables 2FA. |{% if currentVersion == "free-pro-team@latest" %}
 | `revoke_external_identity` | Triggered when an organization owner revokes a member's linked identity. For more information, see "[Viewing and managing a member's SAML access to your organization](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization#viewing-and-revoking-a-linked-identity)."
 | `revoke_sso_session` | Triggered when an organization owner revokes a member's SAML session. For more information, see "[Viewing and managing a member's SAML access to your organization](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization#viewing-and-revoking-a-linked-identity)."
-| `unblock_user` | Triggered when an organization owner [unblocks a user from an organization](/articles/unblocking-a-user-from-your-organization).{% endif %}
+| `unblock_user` | Triggered when an organization owner [unblocks a user from an organization](/articles/unblocking-a-user-from-your-organization).{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+| `update_new_repository_default_branch_setting` | Triggered when an owner changes the name of the default branch for new repositories in the organization. For more information, see "[Managing the default branch name for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization)."{% endif %}
 | `update_default_repository_permission` | Triggered when an owner changes the default repository permission level for organization members.
 | `update_member` | Triggered when an owner changes a person's role from owner to member or member to owner.
 | `update_member_repository_creation_permission` | Triggered when an owner changes the create repository permission for organization members.{% if currentVersion == "free-pro-team@latest" %}
@@ -400,7 +401,6 @@ Using the qualifier `country`, you can filter actions in the audit log based on
 {% data reusables.audit_log.exported-log-keys-and-values %}
 {% endif %}
 
-{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}
 ### Using the Audit log API
 
 {% note %}
@@ -418,9 +418,7 @@ To ensure a secure IP and maintain compliance for your organization, you can use
 
 The GraphQL response can include data for up to 90 to 120 days.
 
-For example, you can make a GraphQL request to see all the new organization members added to your organization. For more information, see the "[GraphQL API Audit Log](/v4/interface/auditentry/)."
-
-{% endif %}
+For example, you can make a GraphQL request to see all the new organization members added to your organization. For more information, see the "[GraphQL API Audit Log](/graphql/reference/interfaces#auditentry/)."
 
 ### Further reading
 
diff --git a/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/reviewing-your-organizations-installed-integrations.md b/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/reviewing-your-organizations-installed-integrations.md
index d6b6669dd299..83bcbe3dd4f6 100644
--- a/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/reviewing-your-organizations-installed-integrations.md
+++ b/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/reviewing-your-organizations-installed-integrations.md
@@ -1,6 +1,6 @@
 ---
-title: Revisar las integraciones instaladas de tu organización
-intro: Puedes revisar los niveles de permiso para las integraciones instaladas de tu organización y configurar cada accedo de integración a los repositorios de la organización.
+title: Reviewing your organization's installed integrations
+intro: You can review the permission levels for your organization's installed integrations and  configure each integration's access to organization repositories.
 redirect_from:
   - /articles/reviewing-your-organization-s-installed-integrations
   - /articles/reviewing-your-organizations-installed-integrations
@@ -12,9 +12,12 @@ versions:
 {% data reusables.profile.access_profile %}
 {% data reusables.profile.access_org %}
 {% data reusables.organizations.org_settings %}
-4. En la barra lateral izquierda, haz clic en **Installed {% data variables.product.prodname_github_app %}s** ({% data variables.product.prodname_github_app %}s instaladas). ![Pestaña de {% data variables.product.prodname_github_app %}s instaladas en la barra lateral de parámetros de la organización](/assets/images/help/organizations/org-settings-installed-github-apps.png)
-5. Al lado de la {% data variables.product.prodname_github_app %} que quieras revisar, haz clic en **Configure** (Configurar). ![Botón Configure (Configurar)](/assets/images/help/organizations/configure-installed-integration-button.png)
-6. Revisa el acceso al repositorio y los permisos de {% data variables.product.prodname_github_app %}. ![Opción para darle acceso a {% data variables.product.prodname_github_app %} a todos los repositorios o a repositorios específicos](/assets/images/help/organizations/toggle-integration-repo-access.png)
-    - Para darle acceso a la {% data variables.product.prodname_github_app %} a todos los repositorios de tu organización, selecciona **All repositories** (Todos los repositorios).
-    - Para elegir repositorios específicos para darle acceso a la aplicación, selecciona **Only select repositories** (Solo repositorios seleccionados), luego escribe el nombre de un repositorio.
-7. Haz clic en **Save (Guardar)**.
+4. In the left sidebar, click **Installed {% data variables.product.prodname_github_app %}s**.
+  ![Installed {% data variables.product.prodname_github_app %}s tab in the organization settings sidebar](/assets/images/help/organizations/org-settings-installed-github-apps.png)
+5. Next to the {% data variables.product.prodname_github_app %} you'd like to review, click **Configure**.
+  ![Configure button](/assets/images/help/organizations/configure-installed-integration-button.png)
+6. Review the {% data variables.product.prodname_github_app %}'s permissions and repository access.
+  ![Option to give the {% data variables.product.prodname_github_app %} access to all repositories or specific repositories](/assets/images/help/organizations/toggle-integration-repo-access.png)
+    - To give the {% data variables.product.prodname_github_app %} access to all of your organization's repositories, select **All repositories**.
+    - To choose specific repositories to give the application access to, select **Only select repositories**, then type a repository name.
+7. Click **Save**.
diff --git a/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-adding-outside-collaborators.md b/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-adding-outside-collaborators.md
index 7a259b4d2084..9f038f84ec7b 100644
--- a/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-adding-outside-collaborators.md
+++ b/translations/es-XL/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-adding-outside-collaborators.md
@@ -1,6 +1,6 @@
 ---
-title: Configurar permisos para agregar colaboradores externos
-intro: 'Para proteger los datos de tu organización y la cantidad de licencias pagadas que se utilizan en ella, puedes permitir que únicamente los propietarios inviten colaboradores externos a los repositorios que le pertenezcan.'
+title: Setting permissions for adding outside collaborators
+intro: 'To protect your organization''s data and the number of paid licenses used in your organization, you can allow only owners to invite outside collaborators to organization repositories.'
 product: '{% data reusables.gated-features.restict-add-collaborator %}'
 redirect_from:
   - /articles/restricting-the-ability-to-add-outside-collaborators-to-organization-repositories/
@@ -10,7 +10,7 @@ versions:
   enterprise-server: '*'
 ---
 
-Los propietarios de la organización y los miembros con privilegios administrativos en los repositorios pueden invitar colaboradores externos para trabajar en ellos. También puedes restringir los permisos de invitación de colaboradores externos para que solo los propietarios de la organización puedan emitirlos.
+Organization owners, and members with admin privileges for a repository, can invite outside collaborators to work on the repository. You can also restrict outside collaborator invite permissions to only organization owners.
 
 {% data reusables.organizations.outside-collaborators-use-seats %}
 
@@ -18,5 +18,7 @@ Los propietarios de la organización y los miembros con privilegios administrati
 {% data reusables.profile.access_org %}
 {% data reusables.organizations.org_settings %}
 {% data reusables.organizations.member-privileges %}
-5. Debajo de "Invitaciones al Repositorio", selecciona **Permitir que los miembros inviten colaboradores externos a los repositorios de esta organización**.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}![Checkbox to allow members to invite outside collaborators to organization repositories](/assets/images/help/organizations/repo-invitations-checkbox-updated.png){% else %}![Checkbox to allow members to invite outside collaborators to organization repositories](/assets/images/help/organizations/repo-invitations-checkbox.png){% endif %}
-6. Haz clic en **Save (Guardar)**.
+5. Under "Repository invitations", select **Allow members to invite outside collaborators to repositories for this organization**.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}
+  ![Checkbox to allow members to invite outside collaborators to organization repositories](/assets/images/help/organizations/repo-invitations-checkbox-updated.png){% else %}
+  ![Checkbox to allow members to invite outside collaborators to organization repositories](/assets/images/help/organizations/repo-invitations-checkbox.png){% endif %}
+6. Click **Save**.
diff --git a/translations/es-XL/content/github/setting-up-and-managing-your-github-user-account/changing-your-github-username.md b/translations/es-XL/content/github/setting-up-and-managing-your-github-user-account/changing-your-github-username.md
index 33f4524ec6b6..8140f491016e 100644
--- a/translations/es-XL/content/github/setting-up-and-managing-your-github-user-account/changing-your-github-username.md
+++ b/translations/es-XL/content/github/setting-up-and-managing-your-github-user-account/changing-your-github-username.md
@@ -1,6 +1,6 @@
 ---
-title: Cambiar tu nombre de usuario de GitHub
-intro: 'Puedes cambiar tu nombre de usuario de {% data variables.product.product_name %} en cualquier momento.'
+title: Changing your GitHub username
+intro: 'You can change your {% data variables.product.product_name %} username at any time.'
 redirect_from:
   - /articles/how-to-change-your-username/
   - /articles/changing-your-github-user-name/
@@ -12,46 +12,50 @@ versions:
   enterprise-server: '*'
 ---
 
-### Acerca de los cambios de nombre de usuario
+### About username changes
 
-Puedes cambiar tu nombre de usuario por otro nombre de usuario que actualmente no esté en uso.{% if currentVersion == "free-pro-team@latest" %} Si el nombre de usuario que quieres no está disponible, verás información acerca de si puedes solicitar el nombre de usuario que aparecerá cuando escribas el nombre de usuario deseado.
+You can change your username to another username that is not currently in use.{% if currentVersion == "free-pro-team@latest" %} If the username you want is not available, you'll see information about whether you can request the username to be released when you type in the desired username.
 
-Si el nombre de usuario no puede usarse y no posees una marca comercial para el nombre de usuario, puedes elegir otro nombre de usuario o conservar tu nombre de usuario actual. {% data variables.contact.github_support %} no puede publicar el nombre de usuario que no está disponible para ti. Para obtener más información, consulta "[Cambiar tu nombre de usuario](#changing-your-username)".{% endif %}
+If the username is not eligible for release and you don't hold a trademark for the username, you can choose another username or keep your current username. {% data variables.contact.github_support %} cannot release the unavailable username for you. For more information, see "[Changing your username](#changing-your-username)."{% endif %}
 
-Una vez que cambies tu nombre de usuario, el nombre de usuario anterior estará disponible para todas las personas que lo reclamen. La mayoría de las referencias a tus repositorios con el nombre de usuario anterior automáticamente cambian al nombre de usuario nuevo. Sin embargo, algunos enlaces a tu perfil no se redirigirán automáticamente.
+After changing your username, your old username becomes available for anyone else to claim. Most references to your repositories under the old username automatically change to the new username. However, some links to your profile won't automatically redirect.
 
-{% data variables.product.product_name %} no puede configurar redirecciones para:
-- [@menciones](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams) con tu nombre de usuario anterior
-- Enlaces a los [gists](/articles/creating-gists) que incluyen tu nombre de usuario anterior
+{% data variables.product.product_name %} cannot set up redirects for:
+- [@mentions](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams) using your old username
+- Links to [gists](/articles/creating-gists) that include your old username
 
-### Referencias del repositorio
+### Repository references
 
-Después de cambiar tu nombre de usuario, {% data variables.product.product_name %} automáticamente redirigirá las referencias a tus repositorios.
-- Los enlaces web a tus repositorios existentes seguirán funcionando. Esto puede tardar algunos minutos en completarse después de realizar el cambio.
-- Las inserciones de la línea de comando desde tus clones de repositorio local hasta las URL del registro remoto anterior seguirán funcionando.
+After you change your username, {% data variables.product.product_name %} will automatically redirect references to your repositories.
+- Web links to your existing repositories will continue to work. This can take a few minutes to complete after you make the change.
+- Command line pushes from your local repository clones to the old remote tracking URLs will continue to work.
 
-Si el nuevo propietario de tu nombre de usuario anterior crea un repositorio con el mismo nombre que tu repositorio, se sobrescribirá el registro de redirección y tu redirección dejará de funcionar. Debido a esta posibilidad, recomendamos que actualices todas las URL de repositorios remotos existentes luego de cambiar tu nombre de usuario. Para obtener más información, consulta "[Cambiar la URL de un remoto](/articles/changing-a-remote-s-url).
+If the new owner of your old username creates a repository with the same name as your repository, that will override the redirect entry and your redirect will stop working. Because of this possibility, we recommend you update all existing remote repository URLs after changing your username. For more information, see "[Changing a remote's URL](/articles/changing-a-remote-s-url)."
 
-### Enlaces a tu página de perfil anterior
+### Links to your previous profile page
 
-Luego de cambiar tu nombre de usuario, los enlaces a tu página de perfil anterior, como `https://{% data variables.command_line.backticks %}/previoususername`, arrojarán un error 404. Recomendamos actualizar todos los enlaces a tu cuenta de {% data variables.product.product_name %} desde cualaquier lugar{% if currentVersion == "free-pro-team@latest" %}, como tu perfil de LinkedIn o Twitter{% endif %}.
+After changing your username, links to your previous profile page, such as `https://{% data variables.command_line.backticks %}/previoususername`, will return a 404 error. We recommend updating any links to your {% data variables.product.product_name %} account from elsewhere{% if currentVersion == "free-pro-team@latest" %}, such as your LinkedIn or Twitter profile{% endif %}.
 
-### Tus confirmaciones Git
+### Your Git commits
 
-{% if currentVersion == "free-pro-team@latest"%}Las confirmaciones de Git que estaban asociadas con tu dirección de correo electrónico de {% data variables.product.product_name %} `sin respuesta` ya no se atribuirán a tu nuevo nombre de usuario y no aparecerán en tu gráfico de contribuciones.{% endif %}Si tus confirmaciones de Git están asociadas con otra dirección de correo electrónico que has[agregado a tu cuenta de GitHub](/articles/adding-an-email-address-to-your-github-account), {% if currentVersion == "free-pro-team@latest"%}incluida la dirección de correo electrónico basada en ID `sin respuesta` proporcionada por {% data variables.product.product_name %}, {% endif %}se te seguirá atribuyendo y aparecerá en tu gráfico de contribuciones después de que hayas cambiado tu nombre de usuario. Para obtener más información sobre cómo establecer tu dirección de correo electrónico, consulta "[Establecer tu dirección de correo electrónico de confirmación](/articles/setting-your-commit-email-address)".
+{% if currentVersion == "free-pro-team@latest"%}Git commits that were associated with your {% data variables.product.product_name %}-provided `noreply` email address won't be attributed to your new username and won't appear in your contributions graph.{% endif %} If your Git commits are associated with another email address you've [added to your GitHub account](/articles/adding-an-email-address-to-your-github-account), {% if currentVersion == "free-pro-team@latest"%}including the ID-based {% data variables.product.product_name %}-provided `noreply` email address, {% endif %}they'll continue to be attributed to you and appear in your contributions graph after you've changed your username. For more information on setting your email address, see "[Setting your commit email address](/articles/setting-your-commit-email-address)."
 
-### Cambiar tu nombre de usuario
+### Changing your username
 
 {% data reusables.user_settings.access_settings %}
 {% data reusables.user_settings.account_settings %}
-3. En la sección "Change username" (Cambiar nombre de usuario), haz clic en **Change username** (Cambiar nombre de usuario). ![Change Username button](/assets/images/help/settings/settings-change-username.png){% if currentVersion == "free-pro-team@latest" %}
-4. Lee las advertencias sobre cómo cambiar tu nombre de usuario. Si aún deseas cambiar tu nombre de usuario, haz clic en **I understand, let's change my username** (Comprendo, cambiaré mi nombre de usuario). ![Cambiar botón Username warning (Advertencia de nombre de usuario)](/assets/images/help/settings/settings-change-username-warning-button.png)
-5. Escribe un nuevo nombre de usuario. ![Campo New username (Nuevo nombre de usuario)](/assets/images/help/settings/settings-change-username-enter-new-username.png)
-6. Si el nombre de usuario que elegiste está disponible, haz clic en **Change my username** (Cambiar mi nombre de usuario). Si el nombre de usuario que elegiste no está disponible, puedes probar un nombre de usuario diferente o una de las sugerencias que ves. ![Cambiar botón Username warning (Advertencia de nombre de usuario)](/assets/images/help/settings/settings-change-my-username-button.png)
+3. In the "Change username" section, click **Change username**.
+   ![Change Username button](/assets/images/help/settings/settings-change-username.png){% if currentVersion == "free-pro-team@latest" %}
+4. Read the warnings about changing your username. If you still want to change your username, click **I understand, let's change my username**.
+   ![Change Username warning button](/assets/images/help/settings/settings-change-username-warning-button.png)
+5. Type a new username.
+   ![New username field](/assets/images/help/settings/settings-change-username-enter-new-username.png)
+6. If the username you've chosen is available, click **Change my username**. If the username you've chosen is unavailable, you can try a different username or one of the suggestions you see.
+   ![Change Username warning button](/assets/images/help/settings/settings-change-my-username-button.png)
 {% endif %}
 
-### Leer más
+### Further reading
 
-- "[Cambiar la URL de un remoto](/articles/changing-a-remote-s-url)"
-- "[¿Por qué mis confirmaciones están vinculadas al usuario incorrecto?](/articles/why-are-my-commits-linked-to-the-wrong-user)"{% if currentVersion == "free-pro-team@latest" %}
-- "[{% data variables.product.prodname_dotcom %} Política de nombre de usuario](/articles/github-username-policy)"{% endif %}
+- "[Changing a remote's URL](/articles/changing-a-remote-s-url)"
+- "[Why are my commits linked to the wrong user?](/articles/why-are-my-commits-linked-to-the-wrong-user)"{% if currentVersion == "free-pro-team@latest" %}
+- "[{% data variables.product.prodname_dotcom %} Username Policy](/articles/github-username-policy)"{% endif %}
diff --git a/translations/es-XL/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md b/translations/es-XL/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md
index 5b57eaa7a731..c6ebc8a604b9 100644
--- a/translations/es-XL/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md
+++ b/translations/es-XL/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md
@@ -1,6 +1,6 @@
 ---
-title: Niveles de permiso para un repositorio de cuenta de usuario
-intro: 'Un repositorio que es propiedad de una cuenta de usuario tiene dos niveles de permiso: el *del propietario del repositorio* y *de los colaboradores*.'
+title: Permission levels for a user account repository
+intro: 'A repository owned by a user account has two permission levels: the *repository owner* and *collaborators*.'
 redirect_from:
   - /articles/permission-levels-for-a-user-account-repository
 versions:
@@ -10,65 +10,64 @@ versions:
 
 {% tip %}
 
-**Sugerencia:** si requieres más acceso pormenorizado de lectura/escritura a un repositorio propiedad de una cuenta de usuario, contempla transferir el repositorio a una organización. Para obtener más información, consulta "[Transferir un repositorio](/articles/transferring-a-repository).
+**Tip:** If you require more granular read/write access to a repository owned by your user account, consider transferring the repository to an organization. For more information, see "[Transferring a repository](/articles/transferring-a-repository)."
 
 {% endtip %}
 
-#### Acceso de propietario sobre un repositorio propiedad de una cuenta de usuario
+#### Owner access on a repository owned by a user account
 
-El propietario del repositorio tiene control completo del repositorio. Además de todos los permisos admitidos por los colaboradores del repositorio, el propietario del repositorio puede:
+The repository owner has full control of the repository. In addition to all the permissions allowed by repository collaborators, the repository owner can:
 
-- {% if currentVersion == "free-pro-team@latest" %}[Invitar colaboradores](/articles/inviting-collaborators-to-a-personal-repository){% else %}[Agregar colaboradores](/articles/inviting-collaborators-to-a-personal-repository){% endif %}
-- Cambiar la visibilidad del repositorio (de [público a privado](/articles/making-a-public-repository-private), o de [privado a público](/articles/making-a-private-repository-public)){% if currentVersion == "free-pro-team@latest" %}
-- [Limitar las interacciones con un repositorio](/articles/limiting-interactions-with-your-repository)"{% endif %}
-- Fusionar una solicitud de extracción sobre una rama protegida, incluso si no hay revisiones de aprobación
-- [Eliminar el repositorio](/articles/deleting-a-repository)
-- [Administrar los temas de un repositorio](/articles/classifying-your-repository-with-topics){% if currentVersion == "free-pro-team@latest" %}
-- Administrar la configuración de seguridad y análisis. Para obtener más información, consulta la sección "[Administrar la configuración de seguridad y análisis para tu cuenta de usuario](/github/setting-up-and-managing-your-github-user-account/managing-security-and-analysis-settings-for-your-user-account)".{% endif %}{% if currentVersion == "free-pro-team@latest" %}
-- [Habilitar el gráfico de dependencia](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) para un repositorio privado{% endif %}{% if currentVersion == "free-pro-team@latest" %}
-- Borrar paquetes. Para obtener más información, consulta la sección "[Eliminar un paquete](/github/managing-packages-with-github-packages/deleting-a-package)".{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}
-- Crear y editar las tarjetas sociales de un repositorio. Para obtener más información, consulta "[Personalizar la vista preliminar de las redes sociales de tu repositorio](/articles/customizing-your-repositorys-social-media-preview)."
-- Convertir al repositorio en una plantilla. Para obtener más información, consulta la sección "[Crear un repositorio plantilla](/articles/creating-a-template-repository)".{% endif %}
-- Recibe las [{% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}alertas de seguridad{% endif %} para las dependencias vulnerables](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) en un repositorio{% if currentVersion == "free-pro-team@latest" %}
-- Ignora las {% data variables.product.prodname_dependabot_alerts %} en tu repositorio. Para obtener más información, consulta la sección "[Visualizar y actualizar las dependencias vulnerables en tu repositiorio](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)".
-- [Administrar el uso de datos para tu repositorio privado](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository){% endif %}
-- [Definir propietarios del código para un repositorio](/articles/about-code-owners)
-- [Archivar repositorios](/articles/about-archiving-repositories){% if currentVersion == "free-pro-team@latest" %}
-- Crear asesorías de seguridad. Para obtener más información, consulta la sección "[Acerca de{% data variables.product.prodname_security_advisories %}](/github/managing-security-vulnerabilities/about-github-security-advisories)".
-- Mostrar el botón del patrocinador. Para obtener más información, consulta "[Mostrar un botón de patrocinador en tu repositorio](/articles/displaying-a-sponsor-button-in-your-repository)".{% endif %}
+- {% if currentVersion == "free-pro-team@latest" %}[Invite collaborators](/articles/inviting-collaborators-to-a-personal-repository){% else %}[Add collaborators](/articles/inviting-collaborators-to-a-personal-repository){% endif %}
+- Change the visibility of the repository (from [public to private](/articles/making-a-public-repository-private), or from [private to public](/articles/making-a-private-repository-public)){% if currentVersion == "free-pro-team@latest" %}
+- [Limit interactions with a repository](/articles/limiting-interactions-with-your-repository){% endif %}
+- Merge a pull request on a protected branch, even if there are no approving reviews
+- [Delete the repository](/articles/deleting-a-repository)
+- [Manage a repository's topics](/articles/classifying-your-repository-with-topics){% if currentVersion == "free-pro-team@latest" %}
+- Manage security and analysis settings. For more information, see "[Managing security and analysis settings for your user account](/github/setting-up-and-managing-your-github-user-account/managing-security-and-analysis-settings-for-your-user-account)."{% endif %}{% if currentVersion == "free-pro-team@latest" %}
+- [Enable the dependency graph](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) for a private repository{% endif %}{% if currentVersion == "free-pro-team@latest" %}
+- Delete packages. For more information, see "[Deleting a package](/github/managing-packages-with-github-packages/deleting-a-package)."{% endif %}
+- Create and edit repository social cards. For more information, see "[Customizing your repository's social media preview](/articles/customizing-your-repositorys-social-media-preview)."
+- Make the repository a template. For more information, see "[Creating a template repository](/articles/creating-a-template-repository)."
+- Receive [{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in a repository.{% if currentVersion == "free-pro-team@latest" %}
+- Dismiss {% data variables.product.prodname_dependabot_alerts %} in your repository. For more information, see "[Viewing and updating vulnerable dependencies in your repository](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)." 
+- [Manage data usage for your private repository](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository){% endif %}
+- [Define code owners for the repository](/articles/about-code-owners)
+- [Archive repositories](/articles/about-archiving-repositories){% if currentVersion == "free-pro-team@latest" %}
+- Create security advisories. For more information, see "[About {% data variables.product.prodname_security_advisories %}](/github/managing-security-vulnerabilities/about-github-security-advisories)."
+- Display a sponsor button. For more information, see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)."{% endif %}
 
-Solamente hay un **único propietario** de un repositorio propiedad de una cuenta de usuario; este permiso no puede compartirse con otra cuenta de usuario. Para transferir la propiedad de un repositorio a otro usuario, consulta "[Cómo transferir un repositorio](/articles/how-to-transfer-a-repository)."
+There is only **one owner** of a repository owned by a user account; this permission cannot be shared with another user account. To transfer ownership of a repository to another user, see "[How to transfer a repository](/articles/how-to-transfer-a-repository)."
 
-#### Acceso de colaborador sobre un repositorio propiedad de una cuenta de usuario
+#### Collaborator access on a repository owned by a user account
 
 {% note %}
 
-**Nota:** en un repositorio privado, los propietarios del repositorio solo pueden otorgar acceso de escritura a los colaboradores. Los colaboradores no pueden tener acceso de solo lectura a los repositorio propiedad de una cuenta de usuario.
+**Note:** In a private repository, repository owners can only grant write access to collaborators. Collaborators can't have read-only access to repositories owned by a user account.
 
 {% endnote %}
 
-Los colaboradores de un repositorio personal pueden:
+Collaborators on a personal repository can:
 
-- Subir (escribir), extraer (lectura) y bifurcar (copiar) el repositorio
-- Crear, aplicar y eliminar etiquetas e hitos
-- Abrir, cerrar, volver a abrir y asignar propuestas
-- Editar y eliminar comentarios en confirmaciones, solicitudes de extracción y propuestas
-- Marcar una propuesta o solicitud de extracción como un duplicado. Para obtener más información, consulta [Acerca de duplicar propuestas y solicitudes de extracción](/articles/about-duplicate-issues-and-pull-requests)."
+- Push to (write), pull from (read), and fork (copy) the repository
+- Create, apply, and delete labels and milestones
+- Open, close, re-open, and assign issues
+- Edit and delete comments on commits, pull requests, and issues
+- Mark an issue or pull request as a duplicate. For more information, see "[About duplicate issues and pull requests](/articles/about-duplicate-issues-and-pull-requests)."
 - Open, merge and close pull requests
-- Aplicar cambios sugeridos a solicitudes de extracción. Para obtener más información, consulta "[Incorporar opiniones en tu solicitud de extracción](/articles/incorporating-feedback-in-your-pull-request)."
-- Enviar solicitudes de extracción desde bifurcaciones del repositorio {% if currentVersion == "free-pro-team@latest" %}
-- Publicar, ver e instalar paquetes. Para obtener más información, consulta la sección "[Publicar y administrar paquetes](/github/managing-packages-with-github-packages/publishing-and-managing-packages)".{% endif %}
-- Crear y editar Wikis
-- Crear y editar lanzamientos. Para obtener más información, consulta "[Gestionar los lanzamientos en un repositorio](/github/administering-a-repository/managing-releases-in-a-repository).
-- Eliminarse como colaboradores del repositorio
-- Enviar una revisión sobre una solicitud de extracción que afectará su capacidad de fusión
-- Actuar como un propietario de código designado para un repositorio. Para obtener más información, consulta "[Acerca de los propietarios del código](/articles/about-code-owners)."
-- Bloquear una conversación. Para obtener más información, consulta "[Bloquear conversaciones](/articles/locking-conversations)."{% if currentVersion == "free-pro-team@latest" %}
-- Informar contenido ofensivo a {% data variables.contact.contact_support %}. Para obtener más información, consulta "[Informar abuso o spam](/articles/reporting-abuse-or-spam)".{% endif %}
-{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}
-- Transferir una propuesta a un repositorio diferente. Para obtener más información, consulta "[Transferir una propuesta a otro repositorio](/articles/transferring-an-issue-to-another-repository)."{% endif %}
+- Apply suggested changes to pull requests. For more information, see "[Incorporating feedback in your pull request](/articles/incorporating-feedback-in-your-pull-request)."
+- Send pull requests from forks of the repository{% if currentVersion == "free-pro-team@latest" %}
+- Publish, view, and install packages. For more information, see "[Publishing and managing packages](/github/managing-packages-with-github-packages/publishing-and-managing-packages)."{% endif %}
+- Create and edit Wikis
+- Create and edit releases. For more information, see "[Managing releases in a repository](/github/administering-a-repository/managing-releases-in-a-repository).
+- Remove themselves as collaborators on the repository
+- Submit a review on a pull request that will affect its mergeability
+- Act as a designated code owner for the repository. For more information, see "[About code owners](/articles/about-code-owners)."
+- Lock a conversation. For more information, see "[Locking conversations](/articles/locking-conversations)."{% if currentVersion == "free-pro-team@latest" %}
+- Report abusive content to {% data variables.contact.contact_support %}. For more information, see "[Reporting abuse or spam](/articles/reporting-abuse-or-spam)."{% endif %}
+- Transfer an issue to a different repository. For more information, see "[Transferring an issue to another repository](/articles/transferring-an-issue-to-another-repository)."
 
-### Leer más
+### Further reading
 
-- "[Invitar colaboradores a un repositorio personal](/articles/inviting-collaborators-to-a-personal-repository)"
-- "[Niveles de permiso del repositorio para una organización](/articles/repository-permission-levels-for-an-organization)"
+- "[Inviting collaborators to a personal repository](/articles/inviting-collaborators-to-a-personal-repository)"
+- "[Repository permission levels for an organization](/articles/repository-permission-levels-for-an-organization)"
diff --git a/translations/es-XL/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md b/translations/es-XL/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md
index d538faf4d3f7..c079aa0894c1 100644
--- a/translations/es-XL/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md
+++ b/translations/es-XL/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md
@@ -1,6 +1,6 @@
 ---
-title: GitHub Insights y la protección de datos para tu organización
-intro: '{% data variables.product.prodname_insights %} analiza tus datos de {% data variables.product.prodname_ghe_server %}. Estos datos podrían incluir datos personales de individuos en tu organización quienes podrían tener derecho a entender cómo se utilizan éstos.'
+title: GitHub Insights and data protection for your organization
+intro: '{% data variables.product.prodname_insights %} analyzes your {% data variables.product.prodname_ghe_server %} data. This data could include personal data of individuals in your organization who may have the right to understand how such personal data is being used.'
 product: '{% data reusables.gated-features.github-insights %}'
 redirect_from:
   - /github/installing-and-configuring-github-insights/github-insights-and-data-protection-for-your-organization
@@ -9,38 +9,38 @@ versions:
   enterprise-server: '*'
 ---
 
-Para obtener más información acerca de las condiciones normativas de {% data variables.product.prodname_insights %}, consulta tu contrato de suscripción de {% data variables.product.prodname_ghe_one %}.
+For more information about the terms that govern {% data variables.product.prodname_insights %}, see your {% data variables.product.prodname_ghe_one %} subscription agreement.
 
-Para evitar las dudas, ninguna información anterior deberá considerarse como asesoría legal proporcionada por {% data variables.product.prodname_dotcom %}. Eres responsable de asegurar tu propio análisis legal de la información aquí proporcionada y de dar cumplimiento a las leyes de protección de privacidad y datos. Dependerá de ti si quieres utilizar {% data variables.product.prodname_insights %} para procesar los datos de tus usuarios y empleados, y si lo haces, serás el único responsable para ejecutar dicho procesamiento en cumplimiento con las leyes aplicables.
+For the avoidance of doubt, none of the foregoing information should be considered legal advice provided by {% data variables.product.prodname_dotcom %}. You are responsible for securing your own legal analysis of the information provided herein and for your compliance with privacy and data protection laws. It is up to you whether to use {% data variables.product.prodname_insights %} to process your employees’ and users’ data, and if you do so, you are solely responsible for conducting such processing in compliance with applicable law.
 
-### Los roles y responsabilidades de la organización
+### The organization’s roles and responsibilities
 
-Cuando utilizas {% data variables.product.prodname_insights %}, tu organización es el controlador de los datos, porque ésta determina cómo, cuándo y si {% data variables.product.prodname_insights %} procesará cualquier tipo de datos personales de los individuos. Tu organización es la única responsable para garantizar que cumples con todas las leyes aplicables sobre el procesamiento de datos con {% data variables.product.prodname_insights %}.
+When using {% data variables.product.prodname_insights %}, your organization is the data controller because your organization determines whether, how, and why {% data variables.product.prodname_insights %} will process any individual’s personal data. Your organization is solely responsible for ensuring that you are complying with all applicable laws in processing data with {% data variables.product.prodname_insights %}.
 
-### Recomendaciones de privacidad de datos
+### Data privacy recommendations
 
-Tienes todo el control sobre las métricas, reportes, repositorios y colaboradores a incluir antes de comenzar a utilizar {% data variables.product.prodname_insights %}. Los datos que proceses con {% data variables.product.prodname_insights %} podrán descargarse únicamente de tu instalación de {% data variables.product.prodname_ghe_server %}. Considera equilibrar los riesgos con los beneficios de analizar datos personales.
+You have full control over which metrics, reports, repositories, and contributors to include before beginning use of {% data variables.product.prodname_insights %}. The data you process with {% data variables.product.prodname_insights %} can only be pulled from your installation of {% data variables.product.prodname_ghe_server %}. Consider balancing the risks versus the benefits of analyzing personal data.
 
-- **Desarrolla un plan claro de análisis de datos**: Debes entender claramente lo que quieres analizar, y por qué, y después considerar como puede ayudarte {% data variables.product.prodname_insights %} a encontrar estas respuestas.
+- **Develop a clear analysis plan**: You must understand clearly what you want to analyze and why, and then consider how {% data variables.product.prodname_insights %} may help you find those answers.
 
-- **Considera una valoración de impacto en la protección de datos**: Si el uso de {% data variables.product.prodname_insights %} que propones involucra el procesamiento de datos personales, considera completar una valoración de impacto en la protección de datos o completar de otra forma un análisis legal del uso que pretendes tener.
+- **Consider a data protection impact assessment**: If your proposed use of {% data variables.product.prodname_insights %} involves processing personal data, consider completing a data protection impact assessment or otherwise completing formal legal analysis of your planned use.
 
-### Decidir qué datos utilizar
+### Decide what data to use
 
-- **Decide qué repositorios incluir**: Antes de comenzar un análisis en {% data variables.product.prodname_insights %}, considera qué repositorios incluirás. Los administradores pueden incluir repositorios cuando agregan organizaciones y pueden habilitar o inhabilitar los repositorios en cualquier momento. Para obtener más información sobre agregar organizaciones a {% data variables.product.prodname_insights %}, consulta la sección "[Administrar organizaciones](/insights/installing-and-configuring-github-insights/managing-organizations)". Para obtener más información sobre habilitar e inhabilitar repositorios, consulta la sección "[Administrar repositorios](/insights/installing-and-configuring-github-insights/managing-repositories)".
+- **Decide which repositories to include**: Before you start an analysis in {% data variables.product.prodname_insights %}, consider which repositories to include. Administrators can include repositories when adding organizations and can enable and disable repositories at any time. For more information on adding organizations to {% data variables.product.prodname_insights %}, see "[Managing organizations](/insights/installing-and-configuring-github-insights/managing-organizations)." For more information on enabling and disabling repositories, see "[Managing repositories](/insights/installing-and-configuring-github-insights/managing-repositories)."
 
-- **Decide las métricas y reportes a incluir**: Los administradores pueden habilitar e inhabilitar las métricas y reportes disponibles para todos los usuarios en cualquier momento. Los administradores controlan los datos de {% data variables.product.prodname_insights %} a los cuales tienen acceso los usuarios en tu instalación de {% data variables.product.prodname_ghe_server %}. Para obtener más información, consulta "[Administrar métricas e informes disponibles](/insights/installing-and-configuring-github-insights/managing-available-metrics-and-reports)".
+- **Decide which metrics and reports to include**: Administrators can enable and disable metrics and reports available for all users at any time. Administrators control the {% data variables.product.prodname_insights %} data that users have access to in your installation of {% data variables.product.prodname_ghe_server %}. For more information, see "[Managing available metrics and reports](/insights/installing-and-configuring-github-insights/managing-available-metrics-and-reports)."
 
-- **Decide qué colaboradores incluir**: Los administradores pueden inhabilitar los datos de un colaborador específico para que no se procesen en las métricas y reportes. Para obtener más información acerca de administrar los datos de un colaborador, consulta la sección "[Administrar colaboradores y equipos](/insights/installing-and-configuring-github-insights/managing-contributors-and-teams)".
+- **Decide which contributors to include**: Administrators can disable a specific contributor’s data from being processed in the metrics and reports. For more information on managing contributor data, see "[Managing contributors and teams](/insights/installing-and-configuring-github-insights/managing-contributors-and-teams)."
 
-### Derechos del usuario
+### User rights
 
-De acuerdo con diversas regulaciones de protección de datos, tales como la Regulación General para la Protección de Datos (GDPR, por sus siglas en inglés), los usuarios podrían tener derecho a solicitar que se les excluya del procesamiento, acceso y corrección, o de solicitar que se borre sus datos personales. Como el controlador de los datos, tu organización deberá evaluar si la solicitud de un usuario en particular es válida, y de ser adecuado, tomar las acciones para completar la solicitud.
+Under various data protection regulations, such as the General Data Protection Regulation (GDPR), users may have the right to request exclusion from processing, access, and correction, or to request deletion of their personal data. As the data controller, your organization should evaluate whether a particular user request is valid and, if appropriate, take action to fulfill the request.
 
-- **Exclusión del procesamiento**: Los usuarios tendrán el derecho de que se excluya su información personal del procesamiento. Los administradores tienen la capacidad de eliminar los datos de los contribuyentes del procesamiento en {% data variables.product.prodname_insights %}, y los reportes y métricas resultantes excluirán los datos del colaborador como consecuencia. Para obtener más información, consulta "[Administrar colaboradores y equipos](/insights/installing-and-configuring-github-insights/managing-contributors-and-teams)".
+- **Exclusion of processing**: Users may have the right to have their personal data excluded from being processed. Administrators have the ability to remove a contributor’s data from being processed in {% data variables.product.prodname_insights %}, and the resulting reports and metrics will exclude the contributor’s data accordingly. For more information, see "[Managing contributors and teams](/insights/installing-and-configuring-github-insights/managing-contributors-and-teams)."
 
-- **Acceso**: Los usuarios podrían tener el derecho de solicitar ver qué datos personales se están procesando. Cada métrica y reporte cuenta con una descripción detallada de qué datos personales se están procesando. Para obtener más información, consulta la sección "[Métricas disponibles con {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights)". Los datos sin procesar están disponibles a través de la API de {% data variables.product.prodname_enterprise %}. Tu organización es responsable por cualquier decisión para procesar datos personales y por llevar a cabo dichas solicitudes.
+- **Access**: Users may have the right to demand to see what personal data is being processed. Each metric and report has a detailed description of what personal data is being processed. For more information, see "[Metrics available with {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights)." Raw data is available through the {% data variables.product.prodname_enterprise %} API. Your organization is responsible for any decisions to process personal data and for fulfilling any such requests.
 
-- **Corrección y borrado**: Los usuarios podrían tener el derecho de rectificar o eliminar sus datos personales. Los datos utilizados en {% data variables.product.prodname_insights %} se derivan de los datos existentes que agregas o generas desde tu instalación de {% data variables.product.prodname_ghe_server %}. La corrección y borrado deberán seguir los procesos existentes de tu organización para corregir y eliminar los datos de {% data variables.product.prodname_ghe_server %}.
+- **Correction and deletion**: Users may have the right to rectify or delete their personal data. The data used in {% data variables.product.prodname_insights %} is derived from the existing data you add to or generate from your {% data variables.product.prodname_ghe_server %} installation. Correction and deletion should follow your organization's existing process to correct and delete data from {% data variables.product.prodname_ghe_server %}.
 
-- **Transparencia con respecto al procesamiento**: Cada métrica y reporte tiene una descripción detallada de los datos personales que se están procesando. Para obtener más información, consulta la sección "[Métricas disponibles con {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights)".
+- **Transparency regarding processing**:  Each metric and report has a detailed description of what personal data is being processed. For more information, see "[Metrics available with {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights)."
diff --git a/translations/es-XL/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md b/translations/es-XL/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md
index 3ebfd0eae0c5..069c3b38eda2 100644
--- a/translations/es-XL/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md
+++ b/translations/es-XL/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md
@@ -47,7 +47,6 @@ You can use the dependency graph to:
 
 {% if currentVersion == "free-pro-team@latest" %}To generate a dependency graph, {% data variables.product.product_name %} needs read-only access to the dependency manifest and lock files for a repository. The dependency graph is automatically generated for all public repositories and you can choose to enable it for private repositories. For information about enabling or disabling it for private repositories, see "[Exploring the dependencies of a repository](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository)."{% endif %}
 
-
 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %}If the dependency graph is not available in your system, your site administrator can enable the dependency graph and {% data variables.product.prodname_dependabot_short %} alerts. For more information, see "[Enabling alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server)."{% endif %}
 
 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %} If the dependency graph is not available in your system, your site administrator can enable the dependency graph and security alerts. For more information, see "[Enabling alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server)."
@@ -62,7 +61,7 @@ The recommended formats explicitly define which versions are used for all direct
 
 | Package manager | Languages | Recommended formats | All supported formats |
 | --- | --- | --- | ---|
-{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}| Composer             | PHP           | `composer.lock` | `composer.json`, `composer.lock` |{% endif %}
+| Composer             | PHP           | `composer.lock` | `composer.json`, `composer.lock` |
 | `dotnet` CLI | .NET languages (C#, C++, F#, VB)  |   `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj` |  `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj`, `packages.config` |
 | Maven | Java, Scala |  `pom.xml`  | `pom.xml`  |
 | npm | JavaScript |            `package-lock.json` | `package-lock.json`, `package.json`|
diff --git a/translations/es-XL/content/github/visualizing-repository-data-with-graphs/viewing-traffic-to-a-repository.md b/translations/es-XL/content/github/visualizing-repository-data-with-graphs/viewing-traffic-to-a-repository.md
index 94285a1f8e9b..5597ba968207 100644
--- a/translations/es-XL/content/github/visualizing-repository-data-with-graphs/viewing-traffic-to-a-repository.md
+++ b/translations/es-XL/content/github/visualizing-repository-data-with-graphs/viewing-traffic-to-a-repository.md
@@ -1,16 +1,16 @@
 ---
-title: Ver el tráfico de un repositorio
-intro: 'Cualquier persona con acceso de escritura a un repositorio puede ver su tráfico, incluidos los clones completos (no recuperaciones), los visitantes de los últimos 14 días, sitios de referencia y contenido popular en el gráfico de tráfico.'
-product: 'Esta gráfica de perspectivas del repositorio se encuentra disponible en los repositorios públicos con {% data variables.product.prodname_free_user %} y {% data variables.product.prodname_free_team %} para organizaciones, y en los repositorios privados y públicos con {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, y {% data variables.product.prodname_ghe_cloud %}.{% if currentVersion == "free-pro-team@latest" %} Para obtener más información, consulta las secciones "[Acerca de las gráficas de los repositorios](/articles/about-repository-graphs)" y "[productos de {% data variables.product.prodname_dotcom %}](/articles/github-s-products)."{% endif %}'
+title: Viewing traffic to a repository
+intro: 'Anyone with push access to a repository can view its traffic, including full clones (not fetches), visitors from the past 14 days, referring sites, and popular content in the traffic graph.'
+product: 'This repository insights graph is available in public repositories with {% data variables.product.prodname_free_user %} and {% data variables.product.prodname_free_team %} for organizations, and in public and private repositories with {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, and {% data variables.product.prodname_ghe_cloud %}.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[About repository graphs](/articles/about-repository-graphs)" and "[{% data variables.product.prodname_dotcom %}''s products](/articles/github-s-products)."{% endif %}'
 redirect_from:
   - /articles/viewing-traffic-to-a-repository
 versions:
   free-pro-team: '*'
 ---
 
-Puedes desplazarte a los sitios de referencia, excluidos los motores de búsqueda y {% data variables.product.product_name %} propiamente dicho, desde los vínculos donde se hizo la referencia a las rutas específicas. El contenido popular vincula al contenido específico que generó tráfico.
+You can navigate to referring sites, excluding search engines and {% data variables.product.product_name %} itself, from the links the specific paths were referred from. The popular content links to the specific content that generated traffic.
 
-Los sitios de referencia y el contenido popular se ordenan por vistas y visitantes únicos. Los clones completos y la información del visitante se actualizan cada hora, mientras que las secciones de los sitios de referencia y del contenido popular se actualizan diariamente. Todos los datos en el gráfico de tráfico utiliza la zona horaria UTC+0, sin importar tu ubicación.
+Referring sites and popular content are ordered by views and unique visitors. Full clones and visitor information update hourly, while referring sites and popular content sections update daily. All data in the traffic graph uses the UTC+0 timezone, regardless of your location.
 
 {% tip %}
 
@@ -18,10 +18,11 @@ Los sitios de referencia y el contenido popular se ordenan por vistas y visitant
 
 {% endtip %}
 
-![Gráficos de tráfico del repositorio con una información de herramienta](/assets/images/help/graphs/repo_traffic_graphs_tooltip_dotcom.png)
+![Repository traffic graphs with tooltip](/assets/images/help/graphs/repo_traffic_graphs_tooltip_dotcom.png)
 
-### Acceder al gráfico de tráfico
+### Accessing the traffic graph
 
 {% data reusables.repositories.navigate-to-repo %}
 {% data reusables.repositories.accessing-repository-graphs %}
-3. In the left sidebar, click **Traffic**. ![Pestaña de tráfico](/assets/images/help/graphs/traffic_tab.png)
+3. In the left sidebar, click **Traffic**.
+![Traffic tab](/assets/images/help/graphs/traffic_tab.png)
diff --git a/translations/es-XL/content/github/working-with-github-pages/creating-a-github-pages-site-with-jekyll.md b/translations/es-XL/content/github/working-with-github-pages/creating-a-github-pages-site-with-jekyll.md
index 1fffe7c2e1cf..86907ab801db 100644
--- a/translations/es-XL/content/github/working-with-github-pages/creating-a-github-pages-site-with-jekyll.md
+++ b/translations/es-XL/content/github/working-with-github-pages/creating-a-github-pages-site-with-jekyll.md
@@ -1,24 +1,24 @@
 ---
-title: Crear un sitio de Páginas de GitHub con Jekyll
-intro: 'Puedes usar Jekyll para crear un sitio de {% data variables.product.prodname_pages %} en un repositorio nuevo o existente.'
+title: Creating a GitHub Pages site with Jekyll
+intro: 'You can use Jekyll to create a {% data variables.product.prodname_pages %} site in a new or existing repository.'
 product: '{% data reusables.gated-features.pages %}'
 redirect_from:
   - /articles/creating-a-github-pages-site-with-jekyll
-permissions: 'Las personas con permisos de administración para un repositorio pueden crear un sitio de {% data variables.product.prodname_pages %} con Jekyll.'
+permissions: 'People with admin permissions for a repository can create a {% data variables.product.prodname_pages %} site with Jekyll.'
 versions:
   free-pro-team: '*'
   enterprise-server: '*'
 ---
 
-### Prerrequisitos
+### Prerequisites
 
-Antes de que puedas usar Jekyll para crear un sitio de {% data variables.product.prodname_pages %}, debes instalar Jekyll y Git. Para obtener más información, consulta [Instalación](https://jekyllrb.com/docs/installation/) en la documentación de Jekyll y "[Configurar Git](/articles/set-up-git)".
+Before you can use Jekyll to create a {% data variables.product.prodname_pages %} site, you must install Jekyll and Git. For more information, see [Installation](https://jekyllrb.com/docs/installation/) in the Jekyll documentation and "[Set up Git](/articles/set-up-git)."
 
 {% data reusables.pages.recommend-bundler %}
 
 {% data reusables.pages.jekyll-install-troubleshooting %}
 
-### Crear un repositorio para tu sitio
+### Creating a repository for your site
 
 {% data reusables.pages.new-or-existing-repo %}
 
@@ -29,58 +29,59 @@ Antes de que puedas usar Jekyll para crear un sitio de {% data variables.product
 {% data reusables.pages.create-repo-name %}
 {% data reusables.repositories.choose-repo-visibility %}
 
-### Crear tu sitio
+### Creating your site
 
 {% data reusables.pages.must-have-repo-first %}
 
 {% data reusables.command_line.open_the_multi_os_terminal %}
-2. Si aún no tienes una copia local de tu repositorio, desplázate hasta la ubicación en la que quieras almacenar los archivos fuente de tu sitio y reemplaza _PARENT-FOLDER_ por la carpeta que quieras que contenga la carpeta para su repositorio.
+2. If you don't already have a local copy of your repository, navigate to the location where you want to store your site's source files, replacing _PARENT-FOLDER_ with the folder you want to contain the folder for your repository.
   ```shell
   $ cd PARENT-FOLDER
   ```
-3. Si aún no lo has hecho, inicia un repositorio de Git local reemplazando _REPOSITORY-NAME_ por el nombre de tu repositorio.
+3. If you haven't already, initialize a local Git repository, replacing _REPOSITORY-NAME_ with the name of your repository.
   ```shell
   $ git init REPOSITORY-NAME
   > Initialized empty Git repository in /Users/octocat/my-site/.git/
   # Creates a new folder on your computer, initialized as a Git repository
-  ```
-  4. Cambio los directorios para el repositorio.
+  ```  
+  4. Change directories to the repository.
   ```shell
   $ cd REPOSITORY-NAME
   # Changes the working directory
   ```
 {% data reusables.pages.decide-publishing-source %}
 {% data reusables.pages.navigate-publishing-source %}
-  Por ejemplo, si decides publicar tu sitio desde la carpeta `docs` de la rama predeterminada, crea y cambia los directorios para la carpeta `docs`.
+  For example, if you chose to publish your site from the `docs` folder on the default branch, create and change directories to the `docs` folder.
  ```shell
  $ mkdir docs
  # Creates a new folder called docs
  $ cd docs
  ```
- Si decides publicar tu sitio desde la rama `gh-pages`, crea y controla la rama `gh-pages`.
+ If you chose to publish your site from the `gh-pages` branch, create and checkout the `gh-pages` branch.
  ```shell
  $ git checkout --orphan gh-pages
  # Creates a new branch, with no history or contents, called gh-pages and switches to the gh-pages branch
  ```
- 7. Para crear un sitio Jekyll nuevo, usa el comando `jekyll new` y reemplaza _VERSION_ por la versión de dependencias actual para Jekyll. Para obtener más información, consulta "[Versiones de dependencias](https://pages.github.com/versions/)" en el sitio de {% data variables.product.prodname_pages %}.
-    - Si instalaste Bundler:
+ 7. To create a new Jekyll site, use the `jekyll new` command, replacing _VERSION_ with the current dependency version for Jekyll. For more information, see "[Dependency versions](https://pages.github.com/versions/)" on the {% data variables.product.prodname_pages %} site.
+    - If you installed Bundler:
       ```shell
       $ bundle exec jekyll VERSION new .
       # Creates a Jekyll site in the current directory
       ```
-    - Si no tienes instalado Bundler:
+    - If you don't have Bundler installed:
      ```shell
      $ jekyll VERSION new .
      # Creates a Jekyll site in the current directory
      ```
-8. Abre el Gemfile que se creó y sigue las instrucciones de los comentarios del Gemfile para usar las {% data variables.product.prodname_pages %}. ![Instrucciones para actualizar Gemfile](/assets/images/help/pages/gemfile-instructions.png)
-9. Actualiza la línea `gem "github-pages"` para que luzca así, reemplazando _VERSION_ por la versión de dependencias actual para `github-pages`. Para obtener más información, consulta "[Versiones de dependencias](https://pages.github.com/versions/)" en el sitio de {% data variables.product.prodname_pages %}.
+8. Open the Gemfile that was created and follow the instructions in the Gemfile's comments to use {% data variables.product.prodname_pages %}.
+  ![Instructions for updating Gemfile](/assets/images/help/pages/gemfile-instructions.png)
+9. Update the `gem "github-pages"` line so that the line looks like this, replacing _VERSION_ with the current dependency version for `github-pages`. For more information, see "[Dependency versions](https://pages.github.com/versions/)" on the {% data variables.product.prodname_pages %} site.
 ```shell
 gem "github-pages", "~> VERSION", group: :jekyll_plugins
 ```
-10. Guarda y cierra el Gemfile.
-11. De forma opcional, prueba tu sitio localmente. Para obtener más información, consulta "[Verificar tu sitio de {% data variables.product.prodname_pages %} localmente con Jekyll](/articles/testing-your-github-pages-site-locally-with-jekyll)".
-12. Agrega tu repositorio {% data variables.product.product_name %} como remoto, reemplazando {% if currentVersion != "free-pro-team@latest" %}_HOSTNAME_ con el nombre del host de tu aparato,{% endif %} _USER_por la cuenta que le pertenece al repositorio{% if currentVersion != "free-pro-team@latest" %},{% endif %} y _REPOSITORY_ por el nombre del repositorio.
+10. Save and close the Gemfile.
+11. Optionally, test your site locally. For more information, see "[Testing your {% data variables.product.prodname_pages %} site locally with Jekyll](/articles/testing-your-github-pages-site-locally-with-jekyll)."
+12. Add your {% data variables.product.product_name %} repository as a remote, replacing {% if currentVersion != "free-pro-team@latest" %}_HOSTNAME_ with your appliance's hostname,{% endif %} _USER_ with the account that owns the repository{% if currentVersion != "free-pro-team@latest" %},{% endif %} and _REPOSITORY_ with the name of the repository.
 ```shell
 {% if currentVersion == "free-pro-team@latest" %}
 $ git remote add origin https://github.com/USER/REPOSITORY.git
@@ -88,7 +89,7 @@ $ git remote add origin https://github.com/USER/REPOSITORY.git
 $ git remote add origin https://HOSTNAME/USER/REPOSITORY.git
 {% endif %}
 ```
-13. Sube el repositorio a {% data variables.product.product_name %}, reemplazando _BRANCH_ por el nombre de la rama en la que estás trabajando.
+13. Push the repository to {% data variables.product.product_name %}, replacing _BRANCH_ with the name of the branch you're working on.
    ```shell
    $ git push -u origin BRANCH
    ```
@@ -99,8 +100,8 @@ $ git remote add origin https://HOSTNAME/USER/REPOSITORY
           github
           GitHub OWNER Apache Maven Packages
-          https://maven.pkg.github.com/OWNER/REPOSITORY
+          https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}maven.HOSTNAME{% endif %}/OWNER/REPOSITORY
         
       
     
@@ -77,7 +77,7 @@ Para obtener más información acerca de cómo crear un paquete, consulta la [do
 ```
 
 {% if currentVersion != "free-pro-team@latest" %}
-Por ejemplo, los proyectos *OctodogApp* y *OctocatApp* publicarán en el mismo repositorio:
+If your instance has subdomain isolation disabled:
 
 ```
 `elemento del archivo *pom.xml*. {% data variables.product.prodname_dotcom %} coincidirá con el repositorio según ese campo. Dado que el nombre del repositorio también es parte del elemento `distributionManagement`, no hay pasos adicionales para publicar múltiples paquetes en el mismo repositorio.
+If you would like to publish multiple packages to the same repository, you can include the URL of the repository in the `` element of the *pom.xml* file. {% data variables.product.prodname_dotcom %} will match the repository based on that field. Since the repository name is also part of the `distributionManagement` element, there are no additional steps to publish multiple packages to the same repository.
 
-Para obtener más información acerca de cómo crear un paquete, consulta la [documentación maven.apache.org](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html).
+For more information on creating a package, see the [maven.apache.org documentation](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html).
 
-1. Edita el elemento `distributionManagement` del archivo *POM.
        
-
-{% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance, {% endif %}`OWNER` with the name of the user or organization account that owns the repository and `REPOSITORY` with the name of the repository containing your project.
+1. Edit the `distributionManagement` element of the *pom.xml* file located in your package directory, replacing {% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance, {% endif %}`OWNER` with the name of the user or organization account that owns the repository and `REPOSITORY` with the name of the repository containing your project.
   {% if currentVersion != "free-pro-team@latest" %}
-  Para obtener más información acerca de cómo crear un paquete, consulta la [documentación maven.apache.org](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html).
+  If your instance has subdomain isolation enabled:
   {% endif %}
   ```
   
      
        github
        GitHub OWNER Apache Maven Packages
-       https://maven.pkg.github.com/OWNER/REPOSITORY
+       https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}maven.HOSTNAME{% endif %}/OWNER/REPOSITORY
      
   
   ```
   {% if currentVersion != "free-pro-team@latest" %}
-  Por ejemplo, los proyectos *OctodogApp* y *OctocatApp* publicarán en el mismo repositorio:
+  If your instance has subdomain isolation disabled:
   ```
   
      
@@ -157,23 +155,21 @@ Para obtener más información acerca de cómo crear un paquete, consulta la [do
      
   
   ```
-  {% endif %}
-2
-Publicar el paquete.
+  {% endif %}
+2. Publish the package.
 
    ```shell
    $ mvn deploy
   ```
-
 
 {% data reusables.package_registry.viewing-packages %}
 
-### Instalar un paquete
+### Installing a package
 
-Para instalar un paquete de Apache Maven desde {% data variables.product.prodname_registry %}, edita el *POM. XML* archivo para incluir el paquete como una dependencia. Si deseas instalar paquetes desde más de un repositorio, agrega una etiqueta `repositorio` para cada uno. Para obtener más información acerca del uso de un archivo *pom.xml* en tu proyecto, consulta "[Introducción al POM](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html)"en la documentación de Apache Maven.
+To install an Apache Maven package from {% data variables.product.prodname_registry %}, edit the *pom.xml* file to include the package as a dependency. If you want to install packages from more than one repository, add a `repository` tag for each. For more information on using a *pom.xml* file in your project, see "[Introduction to the POM](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html)" in the Apache Maven documentation.
 
 {% data reusables.package_registry.authenticate-step %}
-2. Agrega las dependencias del paquete al elemento `dependencias` del archivo *pom.xml* de tu proyecto, reemplazando `com.example:test` con tu paquete.
+2. Add the package dependencies to the `dependencies` element of your project *pom.xml* file, replacing `com.example:test` with your package.
 
   ```
   
@@ -184,13 +180,13 @@ Para instalar un paquete de Apache Maven desde {% data variables.product.prodnam
     
   
   ```
-3. Instala el paquete.
+3. Install the package.
 
   ```shell
   $ mvn install
   ```
 
-### Leer más
+### Further reading
 
-- "[Configurar Gradle para usar con {% data variables.product.prodname_registry %}](/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages)"
-- "[Eliminar un paquete](/packages/publishing-and-managing-packages/deleting-a-package/)"
+- "[Configuring Gradle for use with {% data variables.product.prodname_registry %}](/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages)"
+- "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package/)"
diff --git a/translations/es-XL/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md b/translations/es-XL/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md
index 0bd279a646a9..59c0d2c8b81b 100644
--- a/translations/es-XL/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md
+++ b/translations/es-XL/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md
@@ -1,6 +1,6 @@
 ---
-title: Configurar Docker para usar con paquetes de GitHub
-intro: 'Puedes configurar el cliente Docker para usar {% data variables.product.prodname_registry %} para publicar y recuperar imágenes de docker'
+title: Configuring Docker for use with GitHub Packages
+intro: 'You can configure the Docker client to use {% data variables.product.prodname_registry %} to publish and retrieve docker images.'
 product: '{% data reusables.gated-features.packages %}'
 redirect_from:
   - /articles/configuring-docker-for-use-with-github-package-registry
@@ -13,17 +13,13 @@ versions:
 
 {% data reusables.package_registry.packages-ghes-release-stage %}
 
-**Nota:** Cuando instalas o publicas una imagen de docker, {% data variables.product.prodname_registry %} no es compatible con capas externas, tales como imágenes de Windows.
+{% data reusables.package_registry.admins-can-configure-package-types %}
 
-### Autenticar a {% data variables.product.prodname_registry %}
+### About Docker and {% data variables.product.prodname_registry %}
 
-{% warning %}
+{% data reusables.package_registry.docker_registry_deprecation_status %}
 
-Si todavía no has creado una imagen Docker para el paquete, construye la imagen, reemplazando *OWNER* con el nombre de la cuenta de usuario o de organización a la que pertenece el repositorio, *REPOSITORY* con el nombre del repositorio que contiene tu proyecto, *IMAGE_NAME* con el nombre del paquete o la imagen, *VERSION* con la versión del paquete en tiempo de construcción y *PATH* a la imagen si no está en el directorio de trabajo actual.
-
-{% endwarning %}
-
-Puedes autenticarte en {% data variables.product.prodname_registry %} con Docker utilizando el comando de ingreso `docker`.
+When installing or publishing a docker image, {% data variables.product.prodname_registry %} does not currently support foreign layers, such as Windows images.
 
 {% if currentVersion != "free-pro-team@latest" %}
 
@@ -31,17 +27,19 @@ Before you can use the Docker registry on {% data variables.product.prodname_reg
 
 {% endif %}
 
-### Autenticar a {% data variables.product.prodname_registry %}
+### Authenticating to {% data variables.product.prodname_registry %}
+
+{% data reusables.package_registry.docker_registry_deprecation_status %}
 
 {% data reusables.package_registry.authenticate-packages %}
 
-#### Autenticando con un token de acceso personal
+#### Authenticating with a personal access token
 
 {% data reusables.package_registry.required-scopes %}
 
-Puedes autenticarte en {% data variables.product.prodname_registry %} con Docker utilizando el comando de ingreso `docker`.
+You can authenticate to {% data variables.product.prodname_registry %} with Docker using the `docker` login command.
 
-Para mantener seguras tus credenciales, te recomendamos que guardes tu token de acceso personal en un archivo local en tu computadora y uses el indicador `--password-stdin` de Docker, que lee tu token desde un archivo local.
+To keep your credentials secure, we recommend you save your personal access token in a local file on your computer and use Docker's `--password-stdin` flag, which reads your token from a local file.
 
 {% if currentVersion == "free-pro-team@latest" %}
 {% raw %}
@@ -54,58 +52,47 @@ Para mantener seguras tus credenciales, te recomendamos que guardes tu token de
 {% if currentVersion != "free-pro-team@latest" %}
 {% raw %}
  ```shell
- $ docker images
-
-> REPOSITORY           TAG      IMAGE ID      CREATED      SIZE
-> monalisa             1.0      c75bebcdd211  4 weeks ago  1.11MB
-
-# Etiqueta la imagen con OWNER/REPO/IMAGE_NAME
-$ docker tag c75bebcdd211 docker.pkg.github.com/octocat/octo-app/monalisa:1.0
-
-# Sube la imagen a {% data variables.product.prodname_registry %}
-$ docker push docker.pkg.github.com/octocat/octo-app/monalisa:1.0
+ $ cat ~/TOKEN.txt | docker login docker.HOSTNAME -u USERNAME --password-stdin
 ```
 {% endraw %}
 {% endif %}
 
-Utiliza este ejemplo de comando de ingreso, reemplaza `USERNAME` con tu nombre de usuario de {% data variables.product.prodname_dotcom %} y `~/TOKEN.txt` con la ruta de archivo a tu token de acceso personal para {% data variables.product.prodname_dotcom %}.
+To use this example login command, replace `USERNAME` with your {% data variables.product.product_name %} username{% if currentVersion != "free-pro-team@latest" %}, `HOSTNAME` with the URL for {% data variables.product.product_location_enterprise %},{% endif %} and `~/TOKEN.txt` with the file path to your personal access token for {% data variables.product.product_name %}.
 
-Para obtener más información, consulta "[Inicio de sesión de Docker](https://docs.docker.com/engine/reference/commandline/login/#provide-a-password-using-stdin)."
+For more information, see "[Docker login](https://docs.docker.com/engine/reference/commandline/login/#provide-a-password-using-stdin)."
 
-#### Autenticando con el `GITHUB_TOKEN`
+#### Authenticating with the `GITHUB_TOKEN`
 
 {% data reusables.package_registry.package-registry-with-github-tokens %}
 
-### Publicar un paquete
+### Publishing a package
+
+{% data reusables.package_registry.docker_registry_deprecation_status %}
 
-{% data variables.product.prodname_registry %} admite varias imágenes Docker de primer nivel por repositorio. Un repositorio puede tener cualquier cantidad de etiquetas de imagen. Puedes experimentar un servicio de menor calidad al publicar o instalar imágenes de Docker de más de 10 GB, las capas tienen un límite de 5 GB cada una. Para obtener más información, consulta "[Etiqueta Docker](https://docs.docker.com/engine/reference/commandline/tag/)" en la documentación de Docker.
+{% data variables.product.prodname_registry %} supports multiple top-level Docker images per repository. A repository can have any number of image tags. You may experience degraded service publishing or installing Docker images larger than 10GB, layers are capped at 5GB each. For more information, see "[Docker tag](https://docs.docker.com/engine/reference/commandline/tag/)" in the Docker documentation.
 
 {% data reusables.package_registry.lowercase-name-field %}
 
 {% data reusables.package_registry.viewing-packages %}
 
-1. Determina el nombre y la ID de la imagen Docker utilizando `imágenes docker`.
+1. Determine the image name and ID for your docker image using `docker images`.
   ```shell
   $ docker images
   > < >
   > REPOSITORY        TAG        IMAGE ID       CREATED      SIZE
   > IMAGE_NAME        VERSION    IMAGE_ID       4 weeks ago  1.11MB
   ```
-2. Con la ID de la imagen Docker, etiqueta la imagen Docker, reemplazando *OWNER* con el nombre de la cuenta de usuario o de organización a la que pertenece el repositorio, *REPOSITORY* con el nombre del repositorio que contiene tu proyecto, *IMAGE_NAME* con el nombre del paquete o la imagen y *VERSION* con la versión del paquete en tiempo de construcción.
-{% if currentVersion != "free-pro-team@latest" %} *HOSTNAME* with the hostname of {% data variables.product.product_location_enterprise %},{% endif %} and *VERSION* with package version at build time.
+2. Using the Docker image ID, tag the docker image, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image,{% if currentVersion != "free-pro-team@latest" %} *HOSTNAME* with the hostname of {% data variables.product.product_location_enterprise %},{% endif %} and *VERSION* with package version at build time.
   {% if currentVersion == "free-pro-team@latest" %}
   ```shell
   $ docker tag IMAGE_ID docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME:VERSION
   ```
   {% else %}
   ```shell
-  Puedes publicar una nueva imagen de Docker por primera vez y nombrarla monalisa.
+  $ docker tag IMAGE_ID docker.HOSTNAME/OWNER/REPOSITORY/IMAGE_NAME:VERSION
   ```
-.
-        
   {% endif %}
-3. If you haven't already built a docker image for the package, build the image, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image, *VERSION* with package version at build time,
-{% if currentVersion != "free-pro-team@latest" %} *HOSTNAME* with the hostname of {% data variables.product.product_location_enterprise %},{% endif %} and *PATH* to the image if it isn't in the current working directory.s
+3. If you haven't already built a docker image for the package, build the image, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image, *VERSION* with package version at build time,{% if currentVersion != "free-pro-team@latest" %} *HOSTNAME* with the hostname of {% data variables.product.product_location_enterprise %},{% endif %} and *PATH* to the image if it isn't in the current working directory.s
   {% if currentVersion == "free-pro-team@latest" %}
   ```shell
   $ docker build -t docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME:VERSION PATH
@@ -115,7 +102,7 @@ Para obtener más información, consulta "[Inicio de sesión de Docker](https://
   $ docker build -t docker.HOSTNAME/OWNER/REPOSITORY/IMAGE_NAME:VERSION PATH
   ```
   {% endif %}
-4. Publicar la imagen para {% data variables.product.prodname_registry %}.
+4. Publish the image to {% data variables.product.prodname_registry %}.
   {% if currentVersion == "free-pro-team@latest" %}
   ```shell
   $ docker push docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME:VERSION
@@ -127,13 +114,15 @@ Para obtener más información, consulta "[Inicio de sesión de Docker](https://
   {% endif %}
   {% note %}
 
-  **Nota:** Debes subir tu imagen usando `IMAGE_NAME: VERSION` y no utilizar `IMAGE_NAME: SHA`.
+  **Note:** You must push your image using `IMAGE_NAME:VERSION` and not using `IMAGE_NAME:SHA`.
 
   {% endnote %}
 
-#### Ejemplo de publicación de una imagen Docker
+#### Example publishing a Docker image
+
+{% data reusables.package_registry.docker_registry_deprecation_status %}
 
-Puedes publicar la versión 1.0 de la imagen `monalisa` al repositorio `octocat/octo-app` usando una ID de imagen.
+You can publish version 1.0 of the `monalisa` image to the `octocat/octo-app` repository using an image ID.
 
 {% if currentVersion == "free-pro-team@latest" %}
 ```shell
@@ -142,10 +131,10 @@ $ docker images
 > REPOSITORY           TAG      IMAGE ID      CREATED      SIZE
 > monalisa             1.0      c75bebcdd211  4 weeks ago  1.11MB
 
-# Etiqueta la imagen con OWNER/REPO/IMAGE_NAME
+# Tag the image with OWNER/REPO/IMAGE_NAME
 $ docker tag c75bebcdd211 docker.pkg.github.com/octocat/octo-app/monalisa:1.0
 
-# Sube la imagen a {% data variables.product.prodname_registry %}
+# Push the image to {% data variables.product.prodname_registry %}
 $ docker push docker.pkg.github.com/octocat/octo-app/monalisa:1.0
 ```
 
@@ -166,16 +155,15 @@ $ docker push docker.HOSTNAME/octocat/octo-app/monalisa:1.0
 
 {% endif %}
 
-Puedes publicar una nueva imagen de Docker por primera vez y nombrarla `monalisa`.
+You can publish a new Docker image for the first time and name it `monalisa`.
 
 {% if currentVersion == "free-pro-team@latest" %}
 ```shell
-# Construye la imagen con docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME:VERSION
-# Asume que Dockerfile reside en el directorio de trabajo actual (.)
-$ docker build -t docker.pkg.github.com/octocat/octo-app/monalisa:1.0 .
+# Build the image with docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME:VERSION
+# Assumes Dockerfile resides in the current working directory (.)
 $ docker build -t docker.pkg.github.com/octocat/octo-app/monalisa:1.0 .
 
-# Sube la imagen a {% data variables.product.prodname_registry %}
+# Push the image to {% data variables.product.prodname_registry %}
 $ docker push docker.pkg.github.com/octocat/octo-app/monalisa:1.0
 ```
 
@@ -190,10 +178,11 @@ $ docker push docker.HOSTNAME/octocat/octo-app/monalisa:1.0
 ```
 {% endif %}
 
-### Instalar un paquete
+### Installing a package
 
-Puedes usar el comando `docker pull` para instalar una imagen Docker desde {% data variables.product.prodname_registry %}, reemplazando *OWNER* con el nombre de la cuenta de usuario o de organización a la que pertenece el repositorio *REPOSITORY* con el nombre del repositorio que contiene tu proyecto, *IMAGE_NAME* con el nombre del paquete o la imagen, *TAG_NAME* con la etiqueta para la imagen que deseas instalar. {% data reusables.package_registry.lowercase-name-field %}
+{% data reusables.package_registry.docker_registry_deprecation_status %}
 
+You can use the `docker pull` command to install a docker image from {% data variables.product.prodname_registry %}, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image,{% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance, {% endif %} and *TAG_NAME* with tag for the image you want to install. {% data reusables.package_registry.lowercase-name-field %}
 
 {% if currentVersion == "free-pro-team@latest" %}
 ```shell
@@ -207,11 +196,10 @@ $ docker pull docker.HOSTNAME/OWNER/REPOSITORY/IMAGE_NAME:TAG_NAME
 
 {% note %}
 
-**Nota:** Debes extraer la imagen utilizando `IMAGE_NAME:VERSION` y no así, utilizando `IMAGE_NAME:SHA`.
+**Note:** You must pull the image using `IMAGE_NAME:VERSION` and not using `IMAGE_NAME:SHA`.
 
 {% endnote %}
 
+### Further reading
 
-### Leer más
-
-- "[Eliminar un paquete](/packages/publishing-and-managing-packages/deleting-a-package/)"
+- "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package/)"
diff --git a/translations/es-XL/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md b/translations/es-XL/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md
index 2f18b5393fd6..efc0e2d45072 100644
--- a/translations/es-XL/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md
+++ b/translations/es-XL/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md
@@ -1,6 +1,6 @@
 ---
-title: Configurar npm para usar con Paquetes de GitHub
-intro: 'Puedes configurar npm para publicar paquetes en {% data variables.product.prodname_registry %} y para usar los paquetes almacenados en {% data variables.product.prodname_registry %} como dependencias en un proyecto npm.'
+title: Configuring npm for use with GitHub Packages
+intro: 'You can configure npm to publish packages to {% data variables.product.prodname_registry %} and to use packages stored on {% data variables.product.prodname_registry %} as dependencies in an npm project.'
 product: '{% data reusables.gated-features.packages %}'
 redirect_from:
   - /articles/configuring-npm-for-use-with-github-package-registry
@@ -13,119 +13,116 @@ versions:
 
 {% data reusables.package_registry.packages-ghes-release-stage %}
 
-**Nota:** Cuando instalas o publicas una imagen de docker, {% data variables.product.prodname_registry %} no es compatible con capas externas, tales como imágenes de Windows.
+{% data reusables.package_registry.admins-can-configure-package-types %}
 
-### Autenticar a {% data variables.product.prodname_registry %}
+### Authenticating to {% data variables.product.prodname_registry %}
 
 {% data reusables.package_registry.authenticate-packages %}
 
-#### Autenticando con un token de acceso personal
+#### Authenticating with a personal access token
 
 {% data reusables.package_registry.required-scopes %}
 
-Puedes autenticarte en {% data variables.product.prodname_registry %} con npm al editar tu archivo *~/.npmrc* por usuario para incluir tu token de acceso personal o al iniciar sesión en npm en la línea de comando por medio tu nombre de usuario y token de acceso personal.
+You can authenticate to {% data variables.product.prodname_registry %} with npm by either editing your per-user *~/.npmrc* file to include your personal access token or by logging in to npm on the command line using your username and personal access token.
 
-Para autenticarte al agregar tu token de acceso personal a tu archivo *~/.npmrc*, edita el archivo *~/.npmrc* para que tu proyecto incluya la siguiente línea, al reemplazar *TOKEN* por tu token de acceso personal.  Crea un nuevo archivo *~/.npmrc* si no existe uno.
+To authenticate by adding your personal access token to your *~/.npmrc* file, edit the *~/.npmrc* file for your project to include the following line, replacing {% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance and {% endif %}*TOKEN* with your personal access token.  Create a new *~/.npmrc* file if one doesn't exist.
 
 {% if currentVersion != "free-pro-team@latest" %}
-Para obtener más información acerca de cómo crear un paquete, consulta la [documentación maven.apache.org](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html).
+If your instance has subdomain isolation enabled:
 {% endif %}
 
 ```shell
-//npm.pkg.github.com/:_authToken=TOKEN
+//{% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %}/:_authToken=TOKEN
 ```
 
 {% if currentVersion != "free-pro-team@latest" %}
-Por ejemplo, los proyectos *OctodogApp* y *OctocatApp* publicarán en el mismo repositorio:
+If your instance has subdomain isolation disabled:
 
 ```shell
-$ npm login --registry=https://npm.pkg.github.com
-> Username: USERNAME
-> Password: TOKEN
-> Email: PUBLIC-EMAIL-ADDRESS
+//HOSTNAME/_registry/npm/:_authToken=TOKEN
 ```
 {% endif %}
 
-Para autenticarte al iniciar sesión en npm, usa el comando `npm login`, reemplaza *USERNAME* por tu nombre de usuario de {% data variables.product.prodname_dotcom %}, *TOKEN* por tu token de acceso personal y *PUBLIC-EMAIL-ADDRESS* por tu dirección de correo electrónico.
+To authenticate by logging in to npm, use the `npm login` command, replacing *USERNAME* with your {% data variables.product.prodname_dotcom %} username, *TOKEN* with your personal access token, and *PUBLIC-EMAIL-ADDRESS* with your email address.
 
 {% if currentVersion != "free-pro-team@latest" %}
-Para obtener más información acerca de cómo crear un paquete, consulta la [documentación maven.apache.org](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html).
+If your instance has subdomain isolation enabled:
 {% endif %}
 
 ```shell
-"repository" : {
-    "type" : "git",
-    "url": "ssh://git@github.com/OWNER/REPOSITORY.git",
-    "directory": "packages/name"
-  },
+$ npm login --registry=https://{% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %}
+> Username: USERNAME
+> Password: TOKEN
+> Email: PUBLIC-EMAIL-ADDRESS
 ```
 
 {% if currentVersion != "free-pro-team@latest" %}
-Por ejemplo, los proyectos *OctodogApp* y *OctocatApp* publicarán en el mismo repositorio:
+If your instance has subdomain isolation disabled:
 
 ```shell
-registry=https://npm.pkg.github.com/OWNER
-@OWNER:registry=https://npm.pkg.github.com
-@OWNER:registry=https://npm.pkg.github.com
+$ npm login --registry=https://HOSTNAME/_registry/npm/
+> Username: USERNAME
+> Password: TOKEN
+> Email: PUBLIC-EMAIL-ADDRESS
 ```
 {% endif %}
 
-#### Autenticando con el `GITHUB_TOKEN`
+#### Authenticating with the `GITHUB_TOKEN`
 
 {% data reusables.package_registry.package-registry-with-github-tokens %}
 
-### Publicar un paquete
+### Publishing a package
 
-De forma predeterminada, {% data variables.product.prodname_registry %} publica un paquete en el repositorio de {% data variables.product.prodname_dotcom %} que especifiques en el campo nombre del archivo *package.json*. Por ejemplo, publicarías un paquete denominado `@my-org/test` al repositorio de {% data variables.product.prodname_dotcom %} `My-org/test`. Puedes agregar un resumen para la página de descripción del paquete al incluir un archivo *README.md* en el directorio de tu paquete. Para obtener más información, consulta "[Trabajar con package.json](https://docs.npmjs.com/getting-started/using-a-package.json)" y "[Cómo crear módulos Node.js](https://docs.npmjs.com/getting-started/creating-node-modules)" en la documentación de npm.
+By default, {% data variables.product.prodname_registry %} publishes a package in the {% data variables.product.prodname_dotcom %} repository you specify in the name field of the *package.json* file. For example, you would publish a package named `@my-org/test` to the `my-org/test` {% data variables.product.prodname_dotcom %} repository. You can add a summary for the package listing page by including a *README.md* file in your package directory. For more information, see "[Working with package.json](https://docs.npmjs.com/getting-started/using-a-package.json)" and "[How to create Node.js Modules](https://docs.npmjs.com/getting-started/creating-node-modules)" in the npm documentation.
 
-Puedes publicar varios paquetes en el mismo repositorio de {% data variables.product.prodname_dotcom %} al incluir un campo `URL` en el archivo *package.json*. Para obtener más información, consulta "[Publicar varios paquetes en el mismo repositorio](#publishing-multiple-packages-to-the-same-repository)".
+You can publish multiple packages to the same {% data variables.product.prodname_dotcom %} repository by including a `URL` field in the *package.json* file. For more information, see "[Publishing multiple packages to the same repository](#publishing-multiple-packages-to-the-same-repository)."
 
-Puedes configurar la asignación de alcance de tu proyecto por medio de un archivo *.npmrc* local en el proyecto o mediante la opción `publishConfig` en *package.json*. {% data variables.product.prodname_registry %} solo admite paquetes npm con alcance definido. Los paquetes definidos tienen nombres con el formato de `@owner/name`. Además, siempre comienzan con un símbolo`@`. Es posible que tengas que actualizar el nombre en tu *package.json* para usar el nombre de alcance definido. Por ejemplo, `"name": "@codertocat/hello-world-npm"`.
+You can set up the scope mapping for your project using either a local *.npmrc* file in the project or using the `publishConfig` option in the *package.json*. {% data variables.product.prodname_registry %} only supports scoped npm packages. Scoped packages have names with the format of `@owner/name`. Scoped packages always begin with an `@` symbol. You may need to update the name in your *package.json* to use the scoped name. For example, `"name": "@codertocat/hello-world-npm"`.
 
 {% data reusables.package_registry.viewing-packages %}
 
-#### Publicar un paquete por medio de un archivo *.npmrc* local
+#### Publishing a package using a local *.npmrc* file
 
-Puedes usar un archivo *.npmrc* para configurar la asignación del alcance de tu proyecto. En el archivo *.npmrc*, usa la URL y el propietario de la cuenta de {% data variables.product.prodname_registry %} para que {% data variables.product.prodname_registry %} sepa dónde enrutar las solicitudes del paquete. Usar un archivo *.npmrc* impide que otros programadores publiquen accidentalmente el paquete en npmjs.org en lugar de {% data variables.product.prodname_registry %}. {% data reusables.package_registry.lowercase-name-field %}
+You can use an *.npmrc* file to configure the scope mapping for your project. In the *.npmrc* file, use the {% data variables.product.prodname_registry %} URL and account owner so {% data variables.product.prodname_registry %} knows where to route package requests. Using an *.npmrc* file prevents other developers from accidentally publishing the package to npmjs.org instead of {% data variables.product.prodname_registry %}. {% data reusables.package_registry.lowercase-name-field %}
 
 {% data reusables.package_registry.authenticate-step %}
 {% data reusables.package_registry.create-npmrc-owner-step %}
 {% data reusables.package_registry.add-npmrc-to-repo-step %}
-4. Verifica el nombre de tu paquete en el *package.json* de tu proyecto. El campo `name (nombre)` debe contener el alcance y el nombre del paquete. Por ejemplo, si tu paquete se denomina "test" (prueba) y vas a publicar en la organización "My-org" de {% data variables.product.prodname_dotcom %}, el campo `name (nombre)` de tu *package.json* debería ser `@my-org/test`.
+4. Verify the name of your package in your project's *package.json*. The `name` field must contain the scope and the name of the package. For example, if your package is called "test", and you are publishing to the "My-org" {% data variables.product.prodname_dotcom %} organization, the `name` field in your *package.json* should be `@my-org/test`.
 {% data reusables.package_registry.verify_repository_field %}
 {% data reusables.package_registry.publish_package %}
 
-#### Publicar un paquete por medio de `publishConfig` en el archivo *package.json*
+#### Publishing a package using `publishConfig` in the *package.json* file
 
-Puedes usar el elemento `publishConfig` en el archivo *package.json* para especificar el registro en el que deseas que se publique el paquete. Para obtener más información, consulta "[publishConfig](https://docs.npmjs.com/files/package.json#publishconfig)" en la documentación de npm.
+You can use `publishConfig` element in the *package.json* file to specify the registry where you want the package published. For more information, see "[publishConfig](https://docs.npmjs.com/files/package.json#publishconfig)" in the npm documentation.
 
-1. Edita el archivo *package.json* de tu paquete e incluye una entrada de `publishConfig`.
+1. Edit the *package.json* file for your package and include a `publishConfig` entry.
   {% if currentVersion != "free-pro-team@latest" %}
-  Para obtener más información acerca de cómo crear un paquete, consulta la [documentación maven.apache.org](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html).
+  If your instance has subdomain isolation enabled:
   {% endif %}
   ```shell
-    "publishConfig": {
-      "registry":"https://npm.pkg.github.com/"
-    },
+  "publishConfig": {
+    "registry":"https://{% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %}"
+  },
   ```
   {% if currentVersion != "free-pro-team@latest" %}
-  Por ejemplo, los proyectos *OctodogApp* y *OctocatApp* publicarán en el mismo repositorio:
+  If your instance has subdomain isolation disabled:
    ```shell
-    "publishConfig": {
-      "registry":"https://HOSTNAME/_registry/npm/"
-    },
+   "publishConfig": {
+     "registry":"https://HOSTNAME/_registry/npm/"
+   },
   ```
   {% endif %}
 {% data reusables.package_registry.verify_repository_field %}
 {% data reusables.package_registry.publish_package %}
 
-### Publicar varios paquetes en el mismo repositorio
+### Publishing multiple packages to the same repository
 
-Para publicar varios paquetes en el mismo repositorio, puedes incluir la URL del repositorio de {% data variables.product.prodname_dotcom %} en el campo `repository (repositorio)` del archivo *package.json* para cada paquete.
+To publish multiple packages to the same repository, you can include the URL of the {% data variables.product.prodname_dotcom %} repository in the `repository` field of the *package.json* file for each package.
 
-Para asegurarte de que la URL del repositorio sea correcta, reemplaza REPOSITORY por el nombre del repositorio que contiene el paquete que deseas publicar y OWNER por el nombre de la cuenta de usuario o de organización en {% data variables.product.prodname_dotcom %} que posee el repositorio.
+To ensure the repository's URL is correct, replace REPOSITORY with the name of the repository containing the package you want to publish, and OWNER with the name of the user or organization account on {% data variables.product.prodname_dotcom %} that owns the repository.
 
-{% data variables.product.prodname_registry %} coincidirá con el repositorio en base a la URL, en lugar de basarse en el nombre del paquete. Si almacenas el archivo *package.json* fuera del directorio raíz de tu repositorio, puedes usar el campo `directory (directorio)` para especificar la ubicación donde {% data variables.product.prodname_registry %} puede encontrar los archivos *package.json*.
+{% data variables.product.prodname_registry %} will match the repository based on the URL, instead of based on the package name. If you store the *package.json* file outside the root directory of your repository, you can use the `directory` field to specify the location where {% data variables.product.prodname_registry %} can find the *package.json* files.
 
 ```shell
 "repository" : {
@@ -135,18 +132,18 @@ Para asegurarte de que la URL del repositorio sea correcta, reemplaza REPOSITORY
   },
 ```
 
-### Instalar un paquete
+### Installing a package
 
-Puedes instalar paquetes desde {% data variables.product.prodname_registry %} al agregar los paquetes como dependencias en el archivo *package.json* para tu proyecto. Para obtener más información sobre el uso de un *package.json* en tu proyecto, consulta "[Trabajar con package.json](https://docs.npmjs.com/getting-started/using-a-package.json)" en la documentación de npm.
+You can install packages from {% data variables.product.prodname_registry %} by adding the packages as dependencies in the *package.json* file for your project. For more information on using a *package.json* in your project, see "[Working with package.json](https://docs.npmjs.com/getting-started/using-a-package.json)" in the npm documentation.
 
-Por defecto, puedes agregar paquetes de una organización. Para obtener más información, consulta [Instalar paquetes de otras organizaciones](#installing-packages-from-other-organizations)
+By default, you can add packages from one organization. For more information, see "[Installing packages from other organizations](#installing-packages-from-other-organizations)."
 
-También debes agregar el archivo *.npmrc* a tu proyecto por lo que todas las solicitudes de instalación de paquetes pasarán por {% data variables.product.prodname_registry %}. Cuando enrutas todas las solicitudes de paquete a través de {% data variables.product.prodname_registry %}, puedes usar paquetes con alcance definido y sin alcance definido de *npmjs.com*. Para obtener más información, consulta "[npm-scope](https://docs.npmjs.com/misc/scope)" en la documentación de npm.
+You also need to add the *.npmrc* file to your project so all requests to install packages will go through {% data variables.product.prodname_registry %}. When you route all package requests through {% data variables.product.prodname_registry %}, you can use both scoped and unscoped packages from *npmjs.com*. For more information, see "[npm-scope](https://docs.npmjs.com/misc/scope)" in the npm documentation.
 
 {% data reusables.package_registry.authenticate-step %}
 {% data reusables.package_registry.create-npmrc-owner-step %}
 {% data reusables.package_registry.add-npmrc-to-repo-step %}
-4. Configura *package.json* en tu proyecto para usar el paquete que estás instalando. Para agregar las dependencias de tu paquete al archivo *package.json* para {% data variables.product.prodname_registry %}, especifica el nombre del paquete de alcance completo, como `@my-org/server`. Para paquetes de *npmjs.com*, especifica el nombre completo, como `@babel/core` o `@lodash`. Por ejemplo, el archivo *package.json* a continuación utiliza el paquete `@octo-org/octo-app` como una dependencia.
+4. Configure *package.json* in your project to use the package you are installing. To add your package dependencies to the *package.json* file for {% data variables.product.prodname_registry %}, specify the full-scoped package name, such as `@my-org/server`. For packages from *npmjs.com*, specify the full name, such as `@babel/core` or `@lodash`. For example, this following *package.json* uses the `@octo-org/octo-app` package as a dependency.
 
   ```
   {
@@ -161,28 +158,28 @@ También debes agregar el archivo *.npmrc* a tu proyecto por lo que todas las so
     }
   }
   ```
-5. Instala el paquete.
+5. Install the package.
 
   ```shell
   $ npm install
   ```
 
-#### Instalar paquetes de otras organizaciones
+#### Installing packages from other organizations
 
-Por defecto, solo puedes usar paquetes de {% data variables.product.prodname_registry %} de una organización. Por defecto, solo puedes usar paquetes de {% data variables.product.prodname_registry %} de una organización. {% data reusables.package_registry.lowercase-name-field %}
+By default, you can only use {% data variables.product.prodname_registry %} packages from one organization. If you'd like to route package requests to multiple organizations and users, you can add additional lines to your *.npmrc* file, replacing {% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance and {% endif %}*OWNER* with the name of the user or organization account that owns the repository containing your project. {% data reusables.package_registry.lowercase-name-field %}
 
 {% if currentVersion != "free-pro-team@latest" %}
-Para obtener más información acerca de cómo crear un paquete, consulta la [documentación maven.apache.org](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html).
+If your instance has subdomain isolation enabled:
 {% endif %}
 
 ```shell
-registry=https://{% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %}OWNER
+registry=https://{% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME{% endif %}/OWNER
 @OWNER:registry={% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %}
 @OWNER:registry={% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %}
 ```
 
 {% if currentVersion != "free-pro-team@latest" %}
-Por ejemplo, los proyectos *OctodogApp* y *OctocatApp* publicarán en el mismo repositorio:
+If your instance has subdomain isolation disabled:
 
 ```shell
 registry=https://HOSTNAME/_registry/npm/OWNER
@@ -191,7 +188,6 @@ registry=https://HOSTNAME/_registry/npm/OWNER
 ```
 {% endif %}
 
+### Further reading
 
-### Leer más
-
-- "[Eliminar un paquete](/packages/publishing-and-managing-packages/deleting-a-package/)"
+- "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package/)"
diff --git a/translations/es-XL/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md b/translations/es-XL/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md
index 08ed649b6827..8875879a16f7 100644
--- a/translations/es-XL/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md
+++ b/translations/es-XL/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md
@@ -1,6 +1,6 @@
 ---
-title: Usar GitHub Packages con GitHub Actions
-intro: 'Puedes configurar un flujo de trabajo en {% data variables.product.prodname_actions %} para publicar o instalar automáticamente un paquete desde {% data variables.product.prodname_registry %}.'
+title: Using GitHub Packages with GitHub Actions
+intro: 'You can configure a workflow in {% data variables.product.prodname_actions %} to automatically publish or install a package from {% data variables.product.prodname_registry %}.'
 product: '{% data reusables.gated-features.packages %}'
 redirect_from:
   - /github/managing-packages-with-github-packages/using-github-packages-with-github-actions
@@ -11,41 +11,43 @@ versions:
 
 {% data reusables.package_registry.packages-ghes-release-stage %}
 
-### Acerca de {% data variables.product.prodname_registry %} con {% data variables.product.prodname_actions %}
+### About {% data variables.product.prodname_registry %} with {% data variables.product.prodname_actions %}
 
-{% data reusables.repositories.about-github-actions %} {% data reusables.repositories.actions-ci-cd %} Para obtener más información, consulta "[Acerca de {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/about-github-actions)."
+{% data reusables.repositories.about-github-actions %} {% data reusables.repositories.actions-ci-cd %} For more information, see "[About {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/about-github-actions)."
 
-Puedes ampliar las capacidades de CI y CD de tu repositorio publicando o instalando paquetes como parte de tu flujo de trabajo.
+You can extend the CI and CD capabilities of your repository by publishing or installing packages as part of your workflow.
 
 {% if currentVersion == "free-pro-team@latest" %}
-#### Autenticar a {% data variables.product.prodname_github_container_registry %}
+#### Authenticating to {% data variables.product.prodname_github_container_registry %}
 
 {% data reusables.package_registry.container-registry-beta %}
 
-En lugar de usar un token de acceso personal para autenticarte a {% data variables.product.prodname_registry %}, usa el `GITHUB_TOKEN` que {% data variables.product.prodname_dotcom %} crea automáticamente para tu repositorio cuando habilitas {% data variables.product.prodname_actions %}. For an authentication example, see "[Authenticating with the {% data variables.product.prodname_container_registry %}](/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images#authenticating-with-the-container-registry)."
+{% data reusables.package_registry.authenticate_with_pat_for_container_registry %}
+
+For an authentication example, see "[Authenticating with the {% data variables.product.prodname_container_registry %}](/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images#authenticating-with-the-container-registry)."
 
 {% endif %}
 
 #### Authenticating to package registries on {% data variables.product.prodname_dotcom %}
 
-{% if currentVersion == "free-pro-team@latest" %}If you want your workflow to authenticate to {% data variables.product.prodname_registry %} to access a package registry other than the {% data variables.product.prodname_container_registry %} on {% data variables.product.product_name %}, then{% else %}To authenticate to package registries on {% data variables.product.product_name %},{% endif %} we recommend using the `GITHUB_TOKEN` that {% data variables.product.product_name %} automatically creates for your repository when you enable {% data variables.product.prodname_actions %} instead of a personal access token for authentication. El `GITHUB_TOKEN` tiene ámbitos `read:packages` y `write:packages` en el repositorio actual. Para las bifurcaciones, el token también tiene el ámbito `read:packages` para el repositorio padre.
+{% if currentVersion == "free-pro-team@latest" %}If you want your workflow to authenticate to {% data variables.product.prodname_registry %} to access a package registry other than the {% data variables.product.prodname_container_registry %} on {% data variables.product.product_name %}, then{% else %}To authenticate to package registries on {% data variables.product.product_name %},{% endif %} we recommend using the `GITHUB_TOKEN` that {% data variables.product.product_name %} automatically creates for your repository when you enable {% data variables.product.prodname_actions %} instead of a personal access token for authentication. The `GITHUB_TOKEN` has `read:packages` and `write:packages` scopes to the current repository. For forks, the token also has the `read:packages` scope for the parent repository.
 
-Puedes hacer referencia al `GITHUB_TOKEN` en tu archivo de flujo de trabajo mediante el contexto {% raw %}`{{secrets.GITHUB_TOKEN}}`{% endraw %}. Para más información, consulta "[Autenticando con el GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)."
+You can reference the `GITHUB_TOKEN` in your workflow file using the {% raw %}`{{secrets.GITHUB_TOKEN}}`{% endraw %} context. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)."
 
-### Publicar un paquete mediante una acción
+### Publishing a package using an action
 
-Puedes publicar paquetes como parte de tu flujo de integración continua (CI) mediante {% data variables.product.prodname_actions %}. Por ejemplo, podrías configurar un flujo de trabajo para que cada vez que un desarrollador suba código a la rama predeterminada, el flujo de trabajo ejecute pruebas de IC. Si esas pruebas se superan, el flujo de trabajo publica una nueva versión del paquete en {% data variables.product.prodname_registry %}. Este flujo de trabajo automatiza la creación de nuevas versiones de paquete solo si el código cumple con tus estándares de calidad.
+You can publish packages as part of your continuous integration (CI) flow using {% data variables.product.prodname_actions %}. For example, you could configure a workflow so that anytime a developer pushes code to the default branch, the workflow runs CI tests. If those tests pass, the workflow publishes a new package version to {% data variables.product.prodname_registry %}. This workflow automates the creation of new package versions only if the code meets your quality standards.
 
 {% data reusables.package_registry.actions-configuration %}
 
-### Instalar un paquete mediante una acción
+### Installing a package using an action
 
-Puedes instalar paquetes como parte de tu flujo de CI mediante {% data variables.product.prodname_actions %}. Por ejemplo, podrías configurar un flujo de trabajo para que cada vez que un programador suba código a una solicitud de extracción, el flujo de trabajo resuelva las dependencias al descargar e instalar paquetes alojados por el {% data variables.product.prodname_registry %}. Luego, el flujo de trabajo puede ejecutar pruebas de CI que requieran las dependencias.
+You can install packages as part of your CI flow using {% data variables.product.prodname_actions %}. For example, you could configure a workflow so that anytime a developer pushes code to a pull request, the workflow resolves dependencies by downloading and installing packages hosted by {% data variables.product.prodname_registry %}. Then, the workflow can run CI tests that require the dependencies.
 
-Instalar paquetes alojados por el {% data variables.product.prodname_registry %} a través de las {% data variables.product.prodname_actions %} requiere una configuración mínima o una autenticación adicional, mediante el `GITHUB_TOKEN`. La transferencia de datos también es gratuita cuando una acción instala un paquete. Para obtener más información, consulta "[Acerca de la facturación para {% data variables.product.prodname_registry %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)".
+Installing packages hosted by {% data variables.product.prodname_registry %} through {% data variables.product.prodname_actions %} requires minimal configuration or additional authentication when you use `GITHUB_TOKEN`.{% if currentVersion == "free-pro-team@latest" %} Data transfer is also free when an action installs a package. For more information, see "[About billing for {% data variables.product.prodname_registry %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)."{% endif %}
 
 {% if currentVersion == "free-pro-team@latest" %}
-`GITHUB_TOKEN` no puede instalar paquetes desde ningún repositorio privado además del repositorio donde se ejecuta la acción.  You cannot currently use `GITHUB_TOKEN` to authenticate to {% data variables.product.prodname_github_container_registry %}.
+`GITHUB_TOKEN` cannot install packages from any private repository besides the repository where the action runs.  You cannot currently use `GITHUB_TOKEN` to authenticate to {% data variables.product.prodname_github_container_registry %}.
 {% endif %}
 
 {% data reusables.package_registry.actions-configuration %}
diff --git a/translations/es-XL/data/reusables/gated-features/draft-prs.md b/translations/es-XL/data/reusables/gated-features/draft-prs.md
index 47c1d519833d..0379025602e7 100644
--- a/translations/es-XL/data/reusables/gated-features/draft-prs.md
+++ b/translations/es-XL/data/reusables/gated-features/draft-prs.md
@@ -1 +1 @@
-Los borradores de solicitudes de extracción se encuentran disponibles en los repositorios públicos con {% data variables.product.prodname_free_team %} para organizaciones y en los plnes de facturación por repositorio, y en los repositorios públicos y privados con {% data variables.product.prodname_team %}{% if currentVersion != "free-pro-team@latest" %}, {% data variables.product.prodname_ghe_server %} 2.17+,{% endif %} y {% data variables.product.prodname_ghe_cloud %}. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %}
+Draft pull requests are available in public repositories with {% data variables.product.prodname_free_team %} for organizations and legacy per-repository billing plans, and in public and private repositories with {% data variables.product.prodname_team %}{% if currentVersion != "free-pro-team@latest" %}, {% data variables.product.prodname_ghe_server %} 2.17+,{% endif %} and {% data variables.product.prodname_ghe_cloud %}. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %}
diff --git a/translations/es-XL/data/reusables/package_registry/docker_registry_deprecation_status.md b/translations/es-XL/data/reusables/package_registry/docker_registry_deprecation_status.md
new file mode 100644
index 000000000000..79e9650f348f
--- /dev/null
+++ b/translations/es-XL/data/reusables/package_registry/docker_registry_deprecation_status.md
@@ -0,0 +1,5 @@
+{% warning %}
+
+**Note:** The {% data variables.product.prodname_registry %} Docker registry will be superseded by {% data variables.product.prodname_github_container_registry %}{% if currentVersion != "free-pro-team@latest" %} in a future {% data variables.product.product_name %} release{% endif %}.{% if currentVersion == "free-pro-team@latest" %} To learn how to migrate your existing Docker images and any workflows using them, see "[Migrating to {% data variables.product.prodname_github_container_registry %} for Docker images](/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images)" and "[Getting started with {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry)."{% endif %}
+
+{% endwarning %}
diff --git a/translations/es-XL/data/reusables/pages/private_pages_are_public_warning.md b/translations/es-XL/data/reusables/pages/private_pages_are_public_warning.md
index cf32ec497022..2579c5d10f51 100644
--- a/translations/es-XL/data/reusables/pages/private_pages_are_public_warning.md
+++ b/translations/es-XL/data/reusables/pages/private_pages_are_public_warning.md
@@ -1,5 +1,5 @@
   {% warning %}
 
-  **Warning**: {% if currentVersion != "free-pro-team@latest" %}If your site administrator has enabled Public Pages, {% endif %}{% data variables.product.prodname_pages %} sites are publicly available on the internet, even if the repository for the site is private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %}. Si tienes datos sensibles en el repositorio de tu sitio, tal vez quieras eliminarlos antes de publicarlo. Para obtener más información, consulta la sección {% if currentVersion != "free-pro-team@latest" %}"[Configurar {% data variables.product.prodname_pages %} en tu aplicativo](/enterprise/admin/installation/configuring-github-pages-on-your-appliance#making-github-pages-publicly-accessible)" y {% endif %} "[Acerca de la visibilidad de un repositorio](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)".
+  **Warning**: {% if currentVersion != "free-pro-team@latest" %}If your site administrator has enabled Public Pages, {% endif %}{% data variables.product.prodname_pages %} sites are publicly available on the internet, even if the repository for the site is private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %}. If you have sensitive data in your site's repository, you may want to remove it before publishing. For more information, see{% if currentVersion != "free-pro-team@latest" %} "[Configuring {% data variables.product.prodname_pages %} on your appliance](/enterprise/admin/installation/configuring-github-pages-on-your-appliance#making-github-pages-publicly-accessible)" and{% endif %} "[About repository visibility](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)."
 
   {% endwarning %}
diff --git a/translations/es-XL/data/reusables/repositories/about-internal-repos.md b/translations/es-XL/data/reusables/repositories/about-internal-repos.md
index 86939ca14363..d921cfd13384 100644
--- a/translations/es-XL/data/reusables/repositories/about-internal-repos.md
+++ b/translations/es-XL/data/reusables/repositories/about-internal-repos.md
@@ -1 +1 @@
-Puedes utilizar repositorios internos para practicar el "innersource" dentro de tu {% if currentVersion == "free-pro-team@latest" %}cuenta empresarial{% else %}instancia{% endif %}. Los miembros de {% if currentVersion == "free-pro-team@latest" %}tu cuenta empresarial{% else %}y cualquier organización en tu instancia{% endif %} pueden colaborar utilizando metodologías de código abierto sin compartir información propietaria de forma pública{% if currentVersion != "free-pro-team@latest" %}, aún si habilitan el modo privado{% endif %}.
+You can use internal repositories to practice "innersource" within your {% if currentVersion == "free-pro-team@latest" %}enterprise account{% else %}instance{% endif %}. Members of {% if currentVersion == "free-pro-team@latest" %}your enterprise account{% else %}any organization on your instance{% endif %} can collaborate using open source methodologies without sharing proprietary information publicly{% if currentVersion != "free-pro-team@latest" %}, even with private mode disabled{% endif %}.
diff --git a/translations/es-XL/data/reusables/repositories/you-can-fork.md b/translations/es-XL/data/reusables/repositories/you-can-fork.md
index d6b8b3f6663b..2d290ce6cde4 100644
--- a/translations/es-XL/data/reusables/repositories/you-can-fork.md
+++ b/translations/es-XL/data/reusables/repositories/you-can-fork.md
@@ -1,3 +1,3 @@
-Puedes bifurcar cualquier repositorio público en tu cuenta de usuario o en cualquier organización en donde tengas permiso para crear repositorios. Para obtener más información, consulta "[Niveles de permiso para una organización](/articles/permission-levels-for-an-organization)".
+You can fork any public repository to your user account or any organization where you have repository creation permissions. For more information, see "[Permission levels for an organization](/articles/permission-levels-for-an-organization)."
 
-Para bifurcar cualquier repositorio, puedes acceder a tu cuenta de usuario y a cualquier organización en {% data variables.product.prodname_team %} o {% data variables.product.prodname_enterprise %} donde tengas permisos de creación de repositorios. No puedes bifurcar repositorios privados en una organización utilizando {% data variables.product.prodname_free_team %}. {% if currentVersion == "free-pro-team@latest" %}Para obtener más información, consulta la sección "[Productos de GitHub](/articles/githubs-products)."{% endif %}
+You can fork any private repository you can access to your user account and any organization on {% data variables.product.prodname_team %} or {% data variables.product.prodname_enterprise %} where you have repository creation permissions. You cannot fork a private repository to an organization using {% data variables.product.prodname_free_team %}.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[GitHub's products](/articles/githubs-products)."{% endif %}
diff --git a/translations/es-XL/data/reusables/user_settings/about-commit-email-addresses.md b/translations/es-XL/data/reusables/user_settings/about-commit-email-addresses.md
index b48587de3aaa..c1d07e76835b 100644
--- a/translations/es-XL/data/reusables/user_settings/about-commit-email-addresses.md
+++ b/translations/es-XL/data/reusables/user_settings/about-commit-email-addresses.md
@@ -1 +1 @@
-Para obtener más información sobre las direcciones de correo electrónico para las confirmaciones, {% if currentVersion == "free-pro-team@latest" %} incluyendo tu dirección de `noreply` proporcionada por {% data variables.product.product_name %}, {% endif %} consulta la sección "[Configurar tu dirección de correo electrónico para confirmaciones](/articles/setting-your-commit-email-address)".
+For more information on commit email addresses,{% if currentVersion == "free-pro-team@latest" %} including your {% data variables.product.product_name %}-provided `noreply` email address,{% endif %} see "[Setting your commit email address](/articles/setting-your-commit-email-address)."
diff --git a/translations/ja-JP/content/actions/creating-actions/about-actions.md b/translations/ja-JP/content/actions/creating-actions/about-actions.md
index a5fdd98d205f..788a53ead4ea 100644
--- a/translations/ja-JP/content/actions/creating-actions/about-actions.md
+++ b/translations/ja-JP/content/actions/creating-actions/about-actions.md
@@ -1,6 +1,6 @@
 ---
 title: アクションについて
-intro: 'アクションは個々のタスクで、組み合わせてジョブを作成したりワークフローをカスタマイズしたりできます。 独自のアクションを作成したり、 {% data variables.product.prodname_dotcom %} コミュニティで共有するアクションを使用したりカスタマイズしたりできます。'
+intro: 'アクションは個々のタスクで、組み合わせてジョブを作成したりワークフローをカスタマイズしたりできます。 独自のアクションの作成、または {% data variables.product.prodname_dotcom %} コミュニティによって共有されるアクションの使用やカスタマイズができます。'
 product: '{% data reusables.gated-features.actions %}'
 redirect_from:
   - /articles/about-actions
@@ -12,7 +12,7 @@ versions:
   enterprise-server: '>=2.22'
 ---
 
-{% data reusables.actions.enterprise-beta %}
+{% data variables.product.prodname_actions %} の支払いを管理する
 {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
 
 ### アクションについて
@@ -20,7 +20,8 @@ versions:
 {% data variables.product.prodname_dotcom %}の API やパブリックに利用可能なサードパーティAPIとのインテグレーションなど、好きな方法でリポジトリを操作するカスタムコードを書いて、アクションを作成することができます。 たとえば、アクションでnpmモジュールを公開する、緊急の問題が発生したときにSMSアラートを送信する、本番対応のコードをデプロイすることなどが可能です。
 
 {% if currentVersion == "free-pro-team@latest" %}
-ワークフローで使用する独自のアクションを作成したり、ビルドしたアクションを{% data variables.product.prodname_dotcom %}コミュニティと共有したりできます。 ビルドしたアクションをシェアするには、リポジトリをパブリックにする必要があります。
+独自のアクションの作成、または
+{% data variables.product.prodname_dotcom %} コミュニティによって共有されるアクションの使用やカスタマイズができます。 ビルドしたアクションをシェアするには、リポジトリをパブリックにする必要があります。
 {% endif %}
 
 アクションはマシン上で直接実行することも、Dockerコンテナで実行することもできます。 アクションの入力、出力、環境変数を定義できます。
@@ -53,47 +54,40 @@ Node.jsプロジェクトの開発では、{% data variables.product.prodname_ac
 
 #### 複合実行ステップアクション
 
-_複合実行ステップ_ アクションを使用すると、複数のワークフロー実行ステップを 1 つのアクション内で結合できます。 たとえば、この機能を使用して複数の実行コマンドを 1 つのアクションにバンドルし、そのアクションを使用してバンドルされたコマンドを 1 つのステップで実行するワークフローを作成できます。 例を参照するには、「[複合実行ステップの作成アクション](/actions/creating-actions/creating-a-composite-run-steps-action)」を確認してください。
+_複合実行ステップ_ アクションを使用すると、1 つのアクション内で複数のワークフロー実行ステップを組み合わせることができます。 たとえば、この機能を使用して、複数の実行コマンドを 1 つのアクションにバンドルし、バンドルされたコマンドをそのアクションを使用して 1 つのステップで実行するワークフローを作成できます。 例を確認するには、「[複合実行ステップ アクションを作成する](/actions/creating-actions/creating-a-composite-run-steps-action)」を参照してください。
 
 ### アクションの場所を選択する
 
 他のユーザーが使うアクションを開発する場合には、他のアプリケーションコードにバンドルするのではなく、アクションをそれ自体のリポジトリに保持しておくことをお勧めします。 こうすると、他のソフトウェアと同様にアクションのバージョニング、追跡、リリースが可能になるからです。
 
 {% if currentVersion == "free-pro-team@latest" %}
-アクションをそれ自体のリポジトリに保存すると、{% data variables.product.prodname_dotcom %}コミュニティがアクションを見つけやすくなります。また、開発者がアクションの問題を解決したり機能を拡張したりするとき、コードベースのスコープが限定され、アクションのバージョニングが他のアプリケーションコードのバージョニングから切り離されます。
+アクションをそれ自体のリポジトリに保存すると、
+{% data variables.product.prodname_dotcom %} コミュニティがアクションを見つけやすくなります。また、開発者がアクションの問題を解決したり機能を拡張したりするとき、コードベースのスコープが限定され、アクションのバージョニングが他のアプリケーションコードのバージョニングから切り離されます。
 {% endif %}
 
-ビルドしているアクションをパブリックに公開する予定がない場合、アクションのファイルはリポジトリのどの場所に保存してもかまいません。 アクション、ワークフロー、アプリケーションコードを 1 つのリポジトリで組み合わせる予定の場合、アクションは `.github` ディレクトリに保存することをお勧めします。 たとえば、`.github/actions/action-a`や`.github/actions/action-b`に保存します。
+{% if currentVersion == "free-pro-team@latest" %} ビルドしているアクションをパブリックに公開する予定がない場合、{% else %}{% endif %}アクションのファイルはリポジトリのどの場所に保存してもかまいません。 アクション、ワークフロー、アプリケーションコードを 1 つのリポジトリで組み合わせる予定の場合、アクションは `.github` ディレクトリに保存することをお勧めします。 たとえば、`.github/actions/action-a`や`.github/actions/action-b`に保存します。
 
-### {% data variables.product.prodname_ghe_server %}との互換性
+### {% data variables.product.prodname_ghe_server %} との互換性
 
-アクションが {% data variables.product.prodname_ghe_server %}と互換性があることを確認するには、 {% data variables.product.prodname_dotcom %} API URL へのハードコーディングされた参照を使用しないようにする必要があります。 代わりに、環境変数を使用して {% data variables.product.prodname_dotcom %} API を参照する必要があります。
+アクションが {% data variables.product.prodname_ghe_server %} と互換性があることを確認するには、{% data variables.product.prodname_dotcom %} API URL へのハードコードされた参照を使用しないようにする必要があります。 代わりに、環境変数を使用して {% data variables.product.prodname_dotcom %} APIを参照する必要があります。
 
 - REST API の場合は、 `GITHUB_API_URL` 環境変数を使用します。
 - GraphQL の場合は、 `GITHUB_GRAPHQL_URL` 環境変数を使用します。
 
-詳細については、「既定の環境変数
-
-」を参照してください。
         
-
-
+詳しい情報については、「[デフォルトの環境変数](/actions/configuring-and-managing-workflows/using-environment-variables#default-environment-variables)」を参照してください。
 
 ### アクションにリリース管理を使用する
 
 このセクションでは、リリース管理を使用してアクションへの更新を予測可能な方法で配布する方法について説明します。
 
-
-
 #### リリース管理の良い方法
 
 他のユーザが使用するアクションを開発している場合は、リリース管理を使用して、更新の配布方法を管理することをお勧めします。 既存のワークフローとの互換性を維持しつつ、アクションのメジャーバージョンに必要な重要な修正およびセキュリティパッチも含まれます。 変更が互換性に影響する場合は、新しいメジャーバージョンのリリースを検討する必要があります。
 
-このリリース管理アプローチでは、アクションが最新のコードを含む可能性が高く、結果として不安定になる可能性があるため、ユーザはアクションの `master` ブランチを参照しないでください。 代わりに、ユーザにアクションの使用時にメジャーバージョンを指定するように勧めて、問題が発生した場合にのみ、特定のバージョンを指定するようにすることができます。
+このリリース管理アプローチでは、アクションが最新のコードを含む可能性が高く、結果として不安定になる可能性があるため、ユーザはアクションのデフォルトブランチを参照しないでください。 代わりに、ユーザにアクションの使用時にメジャーバージョンを指定するように勧めて、問題が発生した場合にのみ、特定のバージョンを指定するようにすることができます。
 
 特定のアクションのバージョンを使用するために、ユーザは {% data variables.product.prodname_actions %} ワークフローを設定して、タグ、コミットの SHA、またはリリースの名前が付けられたブランチをターゲットにすることができます。
 
-
-
 #### タグを使用したリリース管理
 
 アクションのリリース管理にはタグを使用することをお勧めします。 この方法を使用すると、ユーザはメジャーバージョンとマイナーバージョンを簡単に区別できます。
@@ -106,55 +100,37 @@ _複合実行ステップ_ アクションを使用すると、複数のワー
 
 次の例は、ユーザがメジャーリリースタグを参照する方法を示しています。
 
-
-
 ```yaml
 steps:
     - uses: actions/javascript-action@v1
 ```
 
-
 次の例は、ユーザが特定のパッチリリースタグを参照する方法を示しています。
 
-
-
 ```yaml
 steps:
     - uses: actions/javascript-action@v1.0.1
 ```
 
-
-
-
 #### ブランチを使用したリリース管理
 
 リリース管理にブランチ名を使用する場合、次の例では名前付きブランチを参照する方法を示しています。
 
-
-
 ```yaml
 steps:
     - uses: actions/javascript-action@v1-beta
 ```
 
-
-
-
 #### コミットの SHA を使用したリリース管理
 
 各 Git コミットは、計算された SHA 値を受け取ります。これは一意で不変のものです。 アクションのユーザは、コミットの SHA 値に依存することを好む場合があります。削除や移動ができるタグを指定するよりこの方法のほうが信頼できるためです。 ただし、これは、ユーザがアクションに対して行われた更新をそれ以上受け取らないことを意味しています。 省略された値の代わりにコミットの完全な SHA 値を使用すると、同じ省略形を使用する悪意のあるコミットの使用を防ぐことができます。
 
-
-
 ```yaml
 steps:
     - uses: actions/javascript-action@172239021f7ba04fe7327647b213799853a9eb89
 ```
 
-
-
-
-### アクションのREADMEファイルを作成する 
+### アクションのREADMEファイルを作成する
 
 アクションをパブリックに共有する予定がある場合には、アクションの使用方法を伝えるため README ファイルを作成することをお勧めします。 `README.md` には、以下の情報を含めることができます:
 
@@ -165,35 +141,27 @@ steps:
 - アクションが使用する環境変数
 - ワークフローにおけるアクションの使用例
 
-
-
 ### {% data variables.product.prodname_github_apps %}に対する{% data variables.product.prodname_actions %}の比較
 
-{% data variables.product.prodname_marketplace %}は、ワークフローを改善するツールを提供します。 それぞれのツールの違いや利点を理解すれば、自分の作業に最も適したツールを選択できるようになります。 アクションとアプリの構築の詳細については、「[の 「アプリの](/actions/getting-started-with-github-actions/about-github-actions)について 」および「アプリについて」を参照してください。
         
-
-
+{% data variables.product.prodname_marketplace %}は、ワークフローを改善するツールを提供します。 それぞれのツールの違いや利点を理解すれば、自分の作業に最も適したツールを選択できるようになります。 アプリケーションのビルドに関する詳しい情報については、「[アプリケーションについて](/apps/about-apps/)」を参照してください。
 
 #### GitHub ActionsとGitHub Appsの強み
 
 {% data variables.product.prodname_actions %}と{% data variables.product.prodname_github_app %}はどちらもビルドの自動化の方法とワークフローツールを提供しますが、これらはそれぞれ異なる強みを持っており、違ったやり方で役立ちます。
 
 {% data variables.product.prodname_github_apps %}は：
-
 * 永続的に動作し、イベントに素早く反応できます。
 * 永続化されたデータが必要な場合にうまく動作します。
 * 時間のかからないAPIリクエストとうまく働きます。
 * ユーザが提供するサーバーあるいはコンピューティングインフラストラクチャ上で動作します。
 
 {% data variables.product.prodname_actions %}は：
-
 * 継続的インテグレーションや継続的デプロイメントを実行する自動化を提供します。
 * ランナーマシン上でもDockerコンテナ内でも直接実行できます。
 * リポジトリのクローンへのアクセスを含めて、コードにアクセスするツール、コードフォーマッタ、コマンドラインツールをデプロイしたり公開したりできます。
 * コードのデプロイやアプリケーションの提供が必要ありません。
 * シークレットの生成と利用のためのシンプルなインターフェースを持っており、アクションを利用する人の認証情報を保存せずにサードパーティのサービスとアクションを連携できます。
 
-
-
 ### 参考リンク
 
 - "[{% data variables.product.prodname_actions %}の開発ツール](/articles/development-tools-for-github-actions)"
diff --git a/translations/ja-JP/content/actions/creating-actions/creating-a-composite-run-steps-action.md b/translations/ja-JP/content/actions/creating-actions/creating-a-composite-run-steps-action.md
index 0498991f2ccc..1db1450e5791 100644
--- a/translations/ja-JP/content/actions/creating-actions/creating-a-composite-run-steps-action.md
+++ b/translations/ja-JP/content/actions/creating-actions/creating-a-composite-run-steps-action.md
@@ -1,13 +1,13 @@
 ---
 title: 複合実行ステップ アクションの作成
-intro: このガイドでは、複合実行ステップ アクションを構築する方法について説明します。
+intro: 'このガイドでは、複合実行ステップ アクションを構築する方法について説明します。'
 product: '{% data reusables.gated-features.actions %}'
 versions:
   free-pro-team: '*'
   enterprise-server: '>=2.22'
 ---
 
-{% data reusables.actions.enterprise-beta %}
+{% data variables.product.prodname_actions %} の支払いを管理する
 {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
 
 ### はじめに
@@ -18,9 +18,9 @@ versions:
 
 ### 必要な環境
 
-開始する前に、 {% data variables.product.product_name %} リポジトリを作成します。
+始める前に、{% data variables.product.product_name %} リポジトリを作成します。
 
-1. {% data variables.product.product_location %}で新しいパブリック リポジトリを作成します。 任意のリポジトリ名を選択するか、hello-world コンポジット実行ステップアクション 例 `次の方法を使用できます。 これらのファイルは、プロジェクトを {% data variables.product.product_name %}にプッシュした後で追加できます。 詳しい情報については、「新しいリポジトリの作成」を参照してください。
        
+1. {% data variables.product.product_location %} に新しいパブリックリポジトリを作成します。 任意のリポジトリ名を選択するか、hello-world コンポジット実行ステップアクション 例 `次の方法を使用できます。 これらのファイルは、プロジェクトを {% data variables.product.product_name %}にプッシュした後で追加できます。 詳しい情報については、「新しいリポジトリの作成」を参照してください。
        
 
      • リポジトリをお手元のコンピューターにクローンします。 詳しい情報についてはリポジトリのクローンを参照してください。
        • 
 
      • ターミナルから、ディレクトリを新しいリポジトリに変更します。
 
          cd ハローワールドコンポジット実行ステップアクション
@@ -32,7 +32,7 @@ versions:
   エコー"さようなら"
   ```
 
-1. ターミナルから実行可能 `goodbye.sh` 作成し、リポジトリにチェックインします。
+3. 端末から、`goodbye.sh` を実行可能にします。
 
   ```shell
   chmod +x goodbye.sh
@@ -79,10 +79,29 @@ versions:
 
   出力の管理の詳細については、「複合実行手順の出力 を[`する」参照してください。 
        
 
-
        github.action_path`の使用方法の詳細については、「github コンテキスト](/actions/creating-actions/metadata-syntax-for-github-actions#outputs-for-composite-run-steps-actions)の[`」を参照してください。
        • 
-
      • 新しいラベルを作成します。 この例では、メインブランチに対 v1` というラベルを使用します。 詳細については、「ラベル ](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)の作成
+
        github.action_path`の使用方法の詳細については、「github コンテキスト](/actions/creating-actions/metadata-syntax-for-github-actions#outputs-for-composite-run-steps-actions)の
 
-」を参照してください。
        •   
+`」を参照してください。
        
+
      • 端末から、action.yml` ファイルを確認します。 
+
+
+
+  ```shell
+  git add action.yml
+  git commit -m "Add action"
+  git push
+  ```
+
        •  
+
+1 端末から、タグを追加します。 この例では、`v1` というタグを使用しています。 詳細については、「[アクションについて](/actions/creating-actions/about-actions#using-release-management-for-actions)」を参照してください。 
+  
+  
+
+  ```shell
+  git tag -a -m "Description of this release" v1
+  git push --follow-tags
+  ```
+ 
 
 
 
@@ -90,7 +109,7 @@ versions:
 
 次のワークフロー コードでは、「アクション メタデータ ファイルの作成」で行った完了した hello world アクション[使用](/actions/creating-actions/creating-a-composite-run-steps-action#creating-an-action-metadata-file)。
 
-ワークフロー コードを別のリポジトリの `.github/workflow/main.yml` ファイルにコピーしますが、 `アクション/hello-world-composite-run-steps-action@v1` を作成したリポジトリとラベルに置き換えます。 `who-to-greet` 入力を自分の名前に置き換えることもできます。
+ワークフローコードを別のリポジトリの `.github/workflows/main.yml` ファイルにコピーしますが、`actions/hello-world-composite-run-steps-action@v1` は作成したリポジトリとタグに置き換えます。 `who-to-greet` 入力を自分の名前に置き換えることもできます。
 
 {% raw %}
 
diff --git a/translations/ja-JP/content/actions/creating-actions/creating-a-docker-container-action.md b/translations/ja-JP/content/actions/creating-actions/creating-a-docker-container-action.md
index 9518946a865c..533872851eba 100644
--- a/translations/ja-JP/content/actions/creating-actions/creating-a-docker-container-action.md
+++ b/translations/ja-JP/content/actions/creating-actions/creating-a-docker-container-action.md
@@ -1,18 +1,18 @@
 ---
 title: Docker コンテナのアクションを作成する
-intro: このガイドでは、Docker コンテナのアクションを作成するために最低限必要なステップを案内します。
+intro: 'このガイドでは、Docker コンテナのアクションを作成するために最低限必要なステップを案内します。'
 product: '{% data reusables.gated-features.actions %}'
 redirect_from:
   - /articles/creating-a-docker-container-action
   - /github/automating-your-workflow-with-github-actions/creating-a-docker-container-action
   - /actions/automating-your-workflow-with-github-actions/creating-a-docker-container-action
-  - /アクション/ビルディングアクション/ドッカーコンテナアクションの作成
+  - /actions/building-actions/creating-a-docker-container-action
 versions:
   free-pro-team: '*'
   enterprise-server: '>=2.22'
 ---
 
-{% data reusables.actions.enterprise-beta %}
+{% data variables.product.prodname_actions %} の支払いを管理する
 {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
 
 ### はじめに
@@ -61,7 +61,7 @@ ENTRYPOINT ["/entrypoint.sh"]
 
 ### アクションのメタデータファイルの作成
 
-新しい `action.yml` ファイルを、上で作成した `hello-world-docker-action` ディレクトリの中に作成します。 詳しい情報については「[{% data variables.product.prodname_actions %}のメタデータ構文](/actions/creating-actions/metadata-syntax-for-github-actions)」を参照してください。
+新しい `action.yml` ファイルを、上で作成した `hello-world-docker-action` ディレクトリの中に作成します。 詳しい情報については、「[{% data variables.product.prodname_actions %} のメタデータ構文](/actions/creating-actions/metadata-syntax-for-github-actions)」を参照してください。
 
 {% raw %}
 **アクション.yml**
diff --git a/translations/ja-JP/content/actions/creating-actions/creating-a-javascript-action.md b/translations/ja-JP/content/actions/creating-actions/creating-a-javascript-action.md
index 9a10508c40aa..6799ccc71321 100644
--- a/translations/ja-JP/content/actions/creating-actions/creating-a-javascript-action.md
+++ b/translations/ja-JP/content/actions/creating-actions/creating-a-javascript-action.md
@@ -1,18 +1,18 @@
 ---
 title: JavaScript アクションを作成する
-intro: このガイドでは、アクションツールキットを使って JavaScript アクションをビルドする方法について学びます。
+intro: 'このガイドでは、アクションツールキットを使って JavaScript アクションをビルドする方法について学びます。'
 product: '{% data reusables.gated-features.actions %}'
 redirect_from:
   - /articles/creating-a-javascript-action
   - /github/automating-your-workflow-with-github-actions/creating-a-javascript-action
   - /actions/automating-your-workflow-with-github-actions/creating-a-javascript-action
-  - /アクション/ビルディングアクション/作成-javaスクリプトアクション
+  - /actions/building-actions/creating-a-javascript-action
 versions:
   free-pro-team: '*'
   enterprise-server: '>=2.22'
 ---
 
-{% data reusables.actions.enterprise-beta %}
+{% data variables.product.prodname_actions %} の支払いを管理する
 {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
 
 ### はじめに
@@ -51,7 +51,7 @@ versions:
 
 ### アクションのメタデータファイルの作成
 
-`hello-world-javascript-action`ディレクトリに、以下のサンプルコードで新しく`action.yml`というファイルを作成してください。 詳しい情報については「[{% data variables.product.prodname_actions %}のメタデータ構文](/actions/creating-actions/metadata-syntax-for-github-actions)」を参照してください。
+`hello-world-javascript-action`ディレクトリに、以下のサンプルコードで新しく`action.yml`というファイルを作成してください。 詳しい情報については、「[{% data variables.product.prodname_actions %} のメタデータ構文](/actions/creating-actions/metadata-syntax-for-github-actions)」を参照してください。
 
 
 **アクション.yml**
@@ -77,9 +77,9 @@ runs:
 
 アクションのツールキットは、Node.js パッケージのコレクションで、より一貫性を保ちつつ、JavaScript を素早く作成するためのものです。
 
-ツールキットの [`@actions/core`](https://github.com/actions/toolkit/tree/master/packages/core)パッケージは、ワークフローのコマンド、入力および出力変数、終了ステータス、ならびにデバッグメッセージに対してインターフェースを提供します。
+ツールキットの [`@actions/core`](https://github.com/actions/toolkit/tree/main/packages/core)パッケージは、ワークフローのコマンド、入力および出力変数、終了ステータス、ならびにデバッグメッセージに対してインターフェースを提供します。
 
-このツールキットはまた、認証を受けたOctokit RESTクライアント及びGitHub Actionsコンテキストへのアクセスを返す[`@actions/github`](https://github.com/actions/toolkit/tree/master/packages/github)パッケージも提供します。
+このツールキットはまた、認証を受けたOctokit RESTクライアント及びGitHub Actionsコンテキストへのアクセスを返す[`@actions/github`](https://github.com/actions/toolkit/tree/main/packages/github)パッケージも提供します。
 
 ツールキットは、`core` や `github` パッケージ以外のものも提供しています。 詳しい情報については、[actions/toolkit](https://github.com/actions/toolkit) リポジトリ以下を参照してください。
 
@@ -119,7 +119,7 @@ try {
 }
 ```
 
-上記のサンプルの`index.js`でエラーが投げられた場合、`core.setFailed(error.message);`はアクションツールキットの[`@actions/core`](https://github.com/actions/toolkit/tree/master/packages/core)パッケージを使ってメッセージをログに記録し、失敗の終了コードを設定します。 詳しい情報については「[アクションの終了コードの設定](/actions/creating-actions/setting-exit-codes-for-actions)」を参照してください。
+上記のサンプルの`index.js`でエラーが投げられた場合、`core.setFailed(error.message);`はアクションツールキットの[`@actions/core`](https://github.com/actions/toolkit/tree/main/packages/core)パッケージを使ってメッセージをログに記録し、失敗の終了コードを設定します。 詳しい情報については「[アクションの終了コードの設定](/actions/creating-actions/setting-exit-codes-for-actions)」を参照してください。
 
 
 ### READMEの作成
@@ -258,4 +258,8 @@ jobs:
 
 リポジトリから [**Actions**] タブをクリックして、最新のワークフロー実行を選択します。 "Hello Mona the Octocat"、または`who-to-greet` 入力に指定した名前とタイムスタンプがログに出力されます。
 
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+![ワークフローでアクションを使用しているスクリーンショット](/assets/images/help/repository/javascript-action-workflow-run-updated.png)
+{% else %}
 ![ワークフローでアクションを使用しているスクリーンショット](/assets/images/help/repository/javascript-action-workflow-run.png)
+{% endif %}
\ No newline at end of file
diff --git a/translations/ja-JP/content/actions/creating-actions/dockerfile-support-for-github-actions.md b/translations/ja-JP/content/actions/creating-actions/dockerfile-support-for-github-actions.md
index ecc85b0f6c2f..4d588ae276fe 100644
--- a/translations/ja-JP/content/actions/creating-actions/dockerfile-support-for-github-actions.md
+++ b/translations/ja-JP/content/actions/creating-actions/dockerfile-support-for-github-actions.md
@@ -1,16 +1,16 @@
 ---
 title: GitHub ActionsのためのDockerfileサポート
 shortTitle: Docker
-intro: Dockerコンテナアクション用の`Dockerfile`を作成する際には、いくつかのDockerの命令がGitHub Actionsやアクションのメタデータファイルとどのように関わるのかを知っておく必要があります。
+intro: 'Dockerコンテナアクション用の`Dockerfile`を作成する際には、いくつかのDockerの命令がGitHub Actionsやアクションのメタデータファイルとどのように関わるのかを知っておく必要があります。'
 product: '{% data reusables.gated-features.actions %}'
 redirect_from:
-  - /アクション/ビルディングアクション/ドッカーファイルサポート-githubアクション
+  - /actions/building-actions/dockerfile-support-for-github-actions
 versions:
   free-pro-team: '*'
   enterprise-server: '>=2.22'
 ---
 
-{% data reusables.actions.enterprise-beta %}
+{% data variables.product.prodname_actions %} の支払いを管理する
 {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
 
 ### Dockerfileの命令について
diff --git a/translations/ja-JP/content/actions/creating-actions/index.md b/translations/ja-JP/content/actions/creating-actions/index.md
index 3f3151cf35bf..29dbbb1ada87 100644
--- a/translations/ja-JP/content/actions/creating-actions/index.md
+++ b/translations/ja-JP/content/actions/creating-actions/index.md
@@ -6,13 +6,14 @@ redirect_from:
   - /github/automating-your-workflow-with-github-actions/building-actions
   - /actions/automating-your-workflow-with-github-actions/building-actions
   - /actions/building-actions
+  - /記事/作成-githubアクション/
 versions:
   free-pro-team: '*'
   enterprise-server: '>=2.22'
 ---
 
-{% data reusables.actions.enterprise-beta %}
-{% data reusables.actions.enterprise-github-hosted-runners %}
+{% data variables.product.prodname_actions %} の支払いを管理する
+{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
 
 {% link_in_list /about-actions %}
 {% link_in_list /creating-a-docker-container-action %}
diff --git a/translations/ja-JP/content/actions/creating-actions/metadata-syntax-for-github-actions.md b/translations/ja-JP/content/actions/creating-actions/metadata-syntax-for-github-actions.md
index 604c1aea53d0..c5e5fceb5890 100644
--- a/translations/ja-JP/content/actions/creating-actions/metadata-syntax-for-github-actions.md
+++ b/translations/ja-JP/content/actions/creating-actions/metadata-syntax-for-github-actions.md
@@ -13,7 +13,7 @@ versions:
   enterprise-server: '>=2.22'
 ---
 
-{% data reusables.actions.enterprise-beta %}
+{% data variables.product.prodname_actions %} の支払いを管理する
 {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
 
 ### {% data variables.product.prodname_actions %}のYAML構文について
@@ -42,7 +42,6 @@ Docker及びJavaScriptアクションにはメタデータファイルが必要
 
 この例では、numOctocatsとoctocatEyeColorという 2つの入力を設定しています。 入力のnumOctocatsは必須ではなく、デフォルトの値は'1'になっています。 入力のoctocatEyeColorは必須であり、デフォルト値を持ちません。 このアクションを使うワークフローのファイルは、`with`キーワードを使ってoctocatEyeColorの入力値を設定しなければなりません。 `with`構文に関する詳しい情報については「[{% data variables.product.prodname_actions %}のためのワークフローの構文](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepswith)」を参照してください。
 
-
 ```yaml
 inputs:
   numOctocats:
@@ -54,7 +53,6 @@ inputs:
     required: true
 ```
 
-
 ワークフローファイル内で、あるいはデフォルトの入力値を使ってアクションに入力を指定すると、{% data variables.product.prodname_dotcom %}はその入力に対応して`INPUT_`という名前の環境変数を生成します。 生成される環境変数では、入力の名前を大文字にして、空白を`_`に変換します。
 
 たとえば、ワークフローがnumOctocats及びoctocatEyeColorという入力を定義すると、アクションのコードはこれらの入力の値を`INPUT_NUMOCTOCATS`及び`INPUT_OCTOCATEYECOLOR`という環境変数で読み取れます。
@@ -243,7 +241,7 @@ runs:
 
 ##### **`runs.steps.env`**
 
-**オプション**  そのステップのみの環境変数の `map` を設定します。 ワークフローに保存されている環境変数を変更する場合は、複合実行ステップで `echo "::set-env name={name}::{value}"` を使用します。
+**オプション**  そのステップのみの環境変数の `map` を設定します。 ワークフローに保存されている環境変数を変更する場合は、複合実行ステップで {% if currentVersion == "free-pro-team@latest" または currentVersion ver_gt "enterprise-server@2.22" %}`echo "{name}={value}" >> $GITHUB_ENV`{% else %}`echo "::set-env name={name}::{value}"`{% endif %} を使用します。
 
 ##### **`runs.steps.working-directory`**
 
@@ -321,7 +319,7 @@ runs:
 
 #### **`runs.args`**
 
-**オプション** Dockerコンテナへの入力を定義する文字列の配列。 入力には、ハードコードされた文字列を含めることができます。 {% data variables.product.prodname_dotcom %}は、コンテナの起動時にコンテナの`ENTRYPOINT`に`args`を渡します。
+**オプション** Dockerコンテナへの入力を定義する文字列の配列。 入力には、ハードコードされた文字列を含めることができます。 {% data variables.product.prodname_dotcom %}は、コンテナの起動時に`args`をコンテナの`ENTRYPOINT`に渡します。
 
 `args`は、`Dockerfile`中の`CMD`命令の場所で使われます。 `Dockerfile`中で`CMD`を使うなら、以下の優先順位順のガイドラインを利用してください。
 
diff --git a/translations/ja-JP/content/actions/creating-actions/setting-exit-codes-for-actions.md b/translations/ja-JP/content/actions/creating-actions/setting-exit-codes-for-actions.md
index de4a28e31f59..7a2819f55fa3 100644
--- a/translations/ja-JP/content/actions/creating-actions/setting-exit-codes-for-actions.md
+++ b/translations/ja-JP/content/actions/creating-actions/setting-exit-codes-for-actions.md
@@ -10,7 +10,7 @@ versions:
   enterprise-server: '>=2.22'
 ---
 
-{% data reusables.actions.enterprise-beta %}
+{% data variables.product.prodname_actions %} の支払いを管理する
 {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
 
 ### 終了コードについて
@@ -24,7 +24,7 @@ versions:
 
 ### JavaScript アクションで失敗終了を設定する
 
-JavaScript アクションを作成している場合、アクションツールキットの [`@actions/core`](https://github.com/actions/toolkit/tree/master/packages/core) パッケージを使用してメッセージをログに記録し、失敗終了コードを設定できます。 例:
+JavaScript アクションを作成している場合、アクションツールキットの [`@actions/core`](https://github.com/actions/toolkit/tree/main/packages/core) パッケージを使用してメッセージをログに記録し、失敗終了コードを設定できます。 例:
 
 ```javascript
 try {
diff --git a/translations/ja-JP/content/actions/guides/about-continuous-integration.md b/translations/ja-JP/content/actions/guides/about-continuous-integration.md
new file mode 100644
index 000000000000..8bcce36adb32
--- /dev/null
+++ b/translations/ja-JP/content/actions/guides/about-continuous-integration.md
@@ -0,0 +1,63 @@
+---
+title: 継続的インテグレーションについて
+intro: '{% data variables.product.prodname_actions %} で {% data variables.product.prodname_dotcom %} リポジトリにカスタム継続的インテグレーション（CI）ワークフローと継続的デプロイメント（CD）ワークフローを直接作成できます。'
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /articles/about-continuous-integration
+  - /github/automating-your-workflow-with-github-actions/about-continuous-integration
+  - /actions/automating-your-workflow-with-github-actions/about-continuous-integration
+  - /actions/building-and-testing-code-with-continuous-integration/about-continuous-integration
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data variables.product.prodname_actions %} の支払いを管理する
+{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
+
+### 継続的インテグレーションについて
+
+継続的インテグレーション (CI) とは、ソフトウェアの開発においてコードを頻繁に共有リポジトリにコミットする手法のことです。 コードをコミットする頻度が高いほどエラーの検出が早くなり、開発者がエラーの原因を見つけようとしてデバッグする必要性も減ります。 コードの更新が頻繁であれば、ソフトウェア開発チームの他のメンバーによる変更をマージするのも、それだけ容易になります。 開発者がコードの記述にばかり時間をとられ、エラーのデバッグやマージコンフリクトの解決にかける時間が少ないときに威力を発揮します。
+
+コードをリポジトリにコミットするとき、コミットによってエラーが発生しないように、コードのビルドとテストを継続的に行うことができます。 テストには、コードの文法チェッカー (スタイルフォーマットをチェックする)、セキュリティチェック、コード網羅率、機能テスト、その他のカスタムチェックを含めることができます。
+
+コードをビルドしてテストするには、サーバーが必要です。 ローカルでアップデートのビルドとテストを行ってからコードをリポジトリにプッシュする方法もありますし、リポジトリ での新しいコードのコミットをチェックするCIサーバーを使用する方法もあります。
+
+### {% data variables.product.prodname_actions %} を使用する継続的インテグレーションについて
+
+{% data variables.product.prodname_actions %} を利用した CI では、リポジトリ内のコードをビルドしてテストを実行できるワークフローが利用できます。 ワークフローは、{% data variables.product.prodname_dotcom %} でホストされている仮想マシン、または自分がホストしているマシンで実行できます。 詳しい情報については、「[{% data variables.product.prodname_dotcom %} ホストランナーの仮想環境](/actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)」および「[セルフホストランナーについて](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)」を参照してください。
+
+CI ワークフローは、{% data variables.product.product_name %} イベントが発生したとき（たとえば、新しいコードがリポジトリにプッシュされたとき）、設定されたスケジュールで、またはリポジトリディスパッチ Webhook を使用して外部イベントが発生したときに実行するように設定できます。
+
+{% data variables.product.product_name %} は CI テストを実行して、プルリクエストで各テストの結果を提供するため、ブランチの変更によってエラーが発生したかどうかを確認できます。 ワークフローのテストがすべて成功すると、プッシュした変更をチームメンバーがレビューできるように、またはマージできるようになります。 テストが失敗した場合は、いずれかの変更がその原因になっている可能性があります。
+
+リポジトリに CI を設定すると、{% data variables.product.product_name %} がリポジトリ内のコードを分析し、リポジトリ内の言語とフレームワークに基づいて CI ワークフローを推奨します。 たとえば、[Node.js](https://nodejs.org/en/) を使用する場合、{% data variables.product.product_name %} は、Node.js パッケージをインストールしてテストを実行するテンプレートファイルを提案します。 {% data variables.product.product_name %} によって提案された CI ワークフローテンプレートを使用しても、提案されたテンプレートをカスタマイズしてもかまいませんし、独自のカスタムワークフローファイルを作成して CI テストを実行することもできます。
+
+![提案された継続的インテグレーションテンプレートのスクリーンショット](/assets/images/help/repository/ci-with-actions-template-picker.png)
+
+プロジェクトの CI ワークフローの設定だけでなく、{% data variables.product.prodname_actions %} を使用してソフトウェア開発のライフサイクル全体でワークフローを作成することもできます。 たとえば、アクションを使用してプロジェクトをデプロイ、パッケージ、またはリリースすることが可能です。 詳しい情報については、「[{% data variables.product.prodname_actions %} について](/articles/about-github-actions)」を参照してください。
+
+一般的な用語の定義については「[{% data variables.product.prodname_actions %} の中核的概念](/github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)」を参照してください。
+
+### サポートされている言語
+
+{% data variables.product.product_name %} では、各種言語およびフレームワークに応じて CI ワークフローテンプレートが提供されます。
+
+{% data variables.product.product_location %} 上の {% if currentVersion == "free-pro-team@latest" %}[actions/starter-workflows](https://github.com/actions/starter-workflows/tree/main/ci) リポジトリ{% else %} `actions/starter-workflows` リポジトリで {% data variables.product.product_name %} が提供する CI ワークフローテンプレートの完全なリストを参照します。{% endif %}
+
+### ワークフロー実行の通知
+
+{% data reusables.repositories.workflow-notifications %}
+
+### ワークフロー実行のためのステータスバッジ
+
+{% data reusables.repositories.actions-workflow-status-badge-into %}
+
+詳細は「[ワークフローの設定](/articles/configuring-a-workflow)」を参照してください。
+
+### 参考リンク
+
+- 「[{% data variables.product.prodname_actions %} を使用して継続的インテグレーションを設定する](/articles/setting-up-continuous-integration-using-github-actions)」
+{% if currentVersion == "free-pro-team@latest" %}
+- 「[{% data variables.product.prodname_actions %} の支払いを管理する](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)」
+{% endif %}
diff --git a/translations/ja-JP/content/actions/guides/about-packaging-with-github-actions.md b/translations/ja-JP/content/actions/guides/about-packaging-with-github-actions.md
new file mode 100644
index 000000000000..5672b2da8969
--- /dev/null
+++ b/translations/ja-JP/content/actions/guides/about-packaging-with-github-actions.md
@@ -0,0 +1,47 @@
+---
+title: GitHub Actionsでのパッケージング
+intro: 'パッケージを生成し、{% data variables.product.prodname_registry %}あるいはその他のパッケージホスティングプロバイダにアップロードするワークフローを{% data variables.product.prodname_actions %}でセットアップできます。'
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/about-packaging-with-github-actions
+  - /actions/publishing-packages-with-github-actions/about-packaging-with-github-actions
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data variables.product.prodname_actions %} の支払いを管理する
+{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
+
+### パッケージングのステップについて
+
+パッケージングのステップは、継続的インテグレーションあるいは継続的デリバリのワークフローの一般的な部分です。 アプリケーションをビルドしてテストした後、実行もしくはデプロイ可能な成果物がパッケージの形で生成されます。 たとえば、Javaのプロジェクトのための継続的インテグレーションのワークフローは、`mvn package`を実行してJARファイルを生成するかもしれません。 あるいは、Node.jsアプリケーションのためのCIワークフローは、Dockerコンテナを作成するかもしれません。
+
+ビルドしているアプリケーションの種類によって、このパッケージは手動でのテストのためにローカルにダウンロードしたり、ユーザーがダウンロードできるようにしたり、ステージングあるいはプロダクションの環境にデプロイしたりできます。
+
+### 継続的インテグレーションワークフロー内でのパッケージング
+
+継続的インテグレーションワークフローの終わりにパッケージを作成すれば、プルリクエストに対するコードレビューの間に役立つことがあります。 コードをビルドしてテストした後、パッケージングのステップで実行可能な、あるいはデプロイ可能な成果物を生成できます。 そしてワークフローはワークフローの一部として、この成果物をアップロードできます。
+
+そうすれば、プルリクエストをレビューする際には、ワークフローの実行を見て生成された成果物をダウンロードできるでしょう。
+
+![成果物のダウンロードのドロップダウンメニュー](/assets/images/help/repository/artifact-drop-down.png)
+
+こうすれば、プルリクエスト中のコードを自分のマシン上で実行できるので、プルリクエストのデバッグやテストに役立ちます。
+
+### パッケージを公開するためのワークフロー
+
+継続的インテグレーションのワークフロー中で、テストのためにパッケージ化された成果物をアップロードすることに加えて、プロジェクトをビルドして、パッケージをパッケージレジストリに公開するワークフローを作成できます。
+
+* **{% data variables.product.prodname_registry %} へのパッケージの公開**
+  {% data variables.product.prodname_registry %} は、多くの種類のパッケージのパッケージホスティングサービスとして機能します。 パッケージを{% data variables.product.prodname_dotcom %}のすべてと共有することも、パッケージをプライベートにしてコラボレータやOrganizationと共有することもできます。 詳しい情報については「[{% data variables.product.prodname_registry %}について](/github/managing-packages-with-github-packages/about-github-packages)」を参照してください。
+
+  デフォルトブランチへのプッシュごとに、パッケージを {% data variables.product.prodname_registry %} に公開することをお勧めします。 そうすれば、プロジェクトの開発者は常にmasterからの最新のビルドを{% data variables.product.prodname_registry %}からインストールして実行及びテストできるようになります。
+
+* **パッケージレジストリへのパッケージの公開** 多くのプロジェクトで、新しいバージョンのプロジェクトがリリースされたときにパッケージレジストリへの公開が行われます。 たとえば、JARファイルを生成するプロジェクトは、新しいリリースをMaven Centralリポジトリにアップロードするかもしれません。 あるいは、.NETのプロジェクトはnugetのパッケージを生成し、NuGet Galleryへアップロードするかもしれません。
+
+  これは、リリースが作成される度にパッケージをパッケージレジストリに公開するワークフローを作成すれば、自動化できます。 詳しい情報については「[リリースの作成](/github/administering-a-repository/creating-releases)」を参照してください。
+
+### 参考リンク
+
+- [Node.jsパッケージの公開](/actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages)
diff --git a/translations/ja-JP/content/actions/guides/about-service-containers.md b/translations/ja-JP/content/actions/guides/about-service-containers.md
new file mode 100644
index 000000000000..0b931f43ee5b
--- /dev/null
+++ b/translations/ja-JP/content/actions/guides/about-service-containers.md
@@ -0,0 +1,117 @@
+---
+title: サービスコンテナについて
+intro: 'サービスコンテナを使って、データベース、Webサービス、メモリキャッシュ、あるいはその他のツールをワークフローに接続できます。'
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/about-service-containers
+  - /actions/configuring-and-managing-workflows/about-service-containers
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data variables.product.prodname_actions %} の支払いを管理する
+{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
+
+### サービスコンテナについて
+
+サービスコンテナは、ワークフロー中でアプリケーションをテストもしくは運用するのに必要になるかもしれないサービスをホストするための、シンプルでポータブルな方法を提供するDockerコンテナです。 たとえば、ワークフローでデータベースやメモリキャッシュへのアクセスを必要とする結合テストを実行する必要があるかもしれません。
+
+サービスコンテナは、ワークフロー中のそれぞれのジョブに対して設定できます。 {% data variables.product.prodname_dotcom %}は新しいDockerコンテナをワークフロー中で設定された各サービスに対して作成し、ジョブが完了したときにそのサービスコンテナを破棄します。 ジョブ中のステップは、同じジョブの一部であるすべてのサービスコンテナと通信できます。
+
+{% data reusables.github-actions.docker-container-os-support %}
+
+### サービスコンテナとの通信
+
+ワークフロー中のジョブは、直接ランナーマシン上で実行するようにも、Dockerコンテナ中で実行するようにも設定できます。 ジョブと、ジョブのサービスコンテナとの通信は、ジョブがランナーマシン上で直接実行されているか、コンテナ内で実行されているかによって異なります。
+
+#### コンテナ内でのジョブの実行
+
+コンテナ内でジョブを実行する場合、{% data variables.product.prodname_dotcom %}はDockerのユーザー定義ブリッジネットワークを使ってサービスコンテナをジョブに接続します。 詳しい情報についてはDockerのドキュメンテーションの「[ブリッジネットワークの利用](https://docs.docker.com/network/bridge/)」を参照してください。
+
+コンテナ内でジョブとサービスを実行すれば、ネットワークアクセスはシンプルになります。 サービスコンテナへは、ワークフロー中で設定したラベルを使ってアクセスできます。 サービスコンテナのホスト名は、自動的にラベル名にマップされます。 たとえば`redis`というラベルでサービスコンテナを作成したなら、そのサービスコンテナのホスト名は`redis`になります。
+
+サービスコンテナでポートを設定する必要はありません。 デフォルトで、すべてのコンテナは同じDockerネットワークの一部となってお互いにすべてのポートを公開し合い、Dockerネットワークの外部へはポートは公開されません。
+
+#### ランナーマシン上でのジョブの実行
+
+ジョブをランナーマシン上で直接実行する場合、サービスコンテナには`localhost:`もしくは`127.0.0.1:`を使ってアクセスできます。 {% data variables.product.prodname_dotcom %}は、サービスコンテナからDockerホストへの通信を可能にするよう、コンテナネットワークを設定します。
+
+ジョブがランナーマシン上で直接実行されている場合、Dockerコンテナ内で実行されているサービスは、ランナー上で実行しているジョブに対してデフォルトではポートを公開しません。 サービスコンテナ上のポートは、Dockerホストに対してマップする必要があります。 詳しい情報については「[Dockerホストとサービスコンテナのポートのマッピング](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)」を参照してください。
+
+### サービスコンテナの作成
+
+`services`キーワードを使って、ワークフロー内のジョブの一部であるサービスコンテナを作成できます。 詳しい情報については[`jobs..services`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idservices)を参照してください。
+
+以下の例は、`container-job`というジョブの中に`redis`というサービスを作成します。 この例でのDockerホストは`node:10.18-jessie`コンテナです。
+
+{% raw %}
+```yaml
+name: Redis container example
+on: push
+
+jobs:
+  # コンテナジョブのラベル
+  container-job:
+    # コンテナはLinuxベースのオペレｰ手イングシステム内で実行する
+    runs-on: ubuntu-latest
+    # `container-job`が実行されるDocker Hubイメージ
+    container: node:10.18-jessie
+
+    # `container-job`と実行されるサービスコンテナ
+    services:
+      # サービスコンテナへのアクセスに使われるラベル
+      redis:
+        # Docker Hubのイメージ
+        image: redis
+```
+{% endraw %}
+
+### Dockerホストとサービスコンテナのポートのマッピング
+
+ジョブがDockerコンテナ内で実行されるなら、ポートをホストあるいはサービスコンテナにマップする必要はありません。 ジョブがランナーマシン上で直接実行されるなら、必要なサービスコンテナのポートはホストランナーマシンのポートにマップしなければなりません。
+
+サービスコンテナのポートは、`ports`キーワードを使ってDockerホストにマップできます。 詳しい情報については[`jobs..services`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idservices)を参照してください。
+
+| `ports`の値     | 説明                                                |
+| ------------- | ------------------------------------------------- |
+| `8080:80`     | コンテナのTCPのポート80をDockerホストのポート8080にマップします。          |
+| `8080:80/udp` | コンテナのUDPポート80をDockerホストのポート8080にマップします。           |
+| `8080/udp`    | コンテナでランダムに選択したUDPポートをDockerホストのUDPポート8080にマップします。 |
+
+`ports`キーワードを使ってポートをマップする場合、{% data variables.product.prodname_dotcom %}は`--publish`コマンドを使ってコンテナのポートをDockerホストに公開します。 詳しい情報についてはDockerのドキュメンテーションの「[Dockerコンテナのネットワーキング](https://docs.docker.com/config/containers/container-networking/)」を参照してください。
+
+Dockerホストのポートを指定して、コンテナのポートを指定しなかった場合、コンテナのポートは空いているポートにランダムに割り当てられます。 {% data variables.product.prodname_dotcom %}は割り当てられたコンテナのポートをサービスコンテナのコンテキストに設定します。 たとえば`redis`サービスコンテナに対し、Dockerホストのポート5432を設定したなら、対応するコンテナのポートには`job.services.redis.ports[5432]`コンテキストを使ってアクセスできます。 詳しい情報については、「[{% data variables.product.prodname_actions %} のコンテキストと式構文](/actions/reference/context-and-expression-syntax-for-github-actions#job-context)」を参照してください。
+
+#### Redisのポートのマッピングの例
+
+以下の例は、サービスコンテナ`redis`のポート6379を、Dockerホストのポート6379にマップします。
+
+{% raw %}
+```yaml
+name: Redis Service Example
+on: push
+
+jobs:
+  # コンテナジョブのラベル
+  runner-job:
+    # サービスコンテナもしくはコンテナジョブの利用の際はLinux環境を使わなければならない
+    runs-on: ubuntu-latest
+
+    # `runner-job`と実行するサービスコンテナ
+    services:
+      # サービスコンテナへのアクセスに使われるラベル
+      redis:
+        # Docker Hubイメージ
+        image: redis
+        #
+        ports:
+          # ホストとサービスコンテナのTCPポート6379をオープンする
+          - 6379:6379
+```
+{% endraw %}
+
+### 参考リンク
+
+- [Redisサービスコンテナの作成](/actions/automating-your-workflow-with-github-actions/creating-redis-service-containers)
+- [PostgreSQLサービスコンテナの作成](/actions/automating-your-workflow-with-github-actions/creating-postgresql-service-containers)
diff --git a/translations/ja-JP/content/actions/guides/building-and-testing-java-with-ant.md b/translations/ja-JP/content/actions/guides/building-and-testing-java-with-ant.md
new file mode 100644
index 000000000000..71b644ec947c
--- /dev/null
+++ b/translations/ja-JP/content/actions/guides/building-and-testing-java-with-ant.md
@@ -0,0 +1,109 @@
+---
+title: AntでのJavaのビルドとテスト
+intro: GitHub Actions中で継続的インテグレーション（CI）ワークフローを作成し、AntでJavaのプロジェクトのビルドとテストを行うことができます。
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/building-and-testing-java-with-ant
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data variables.product.prodname_actions %} の支払いを管理する
+{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
+
+### はじめに
+
+このガイドは、Antビルドシステムを使ってJavaのプロジェクトのための継続的インテグレーション（CI）を実行するワークフローを作成する方法を紹介します。 作成するワークフローによって、プルリクエストに対するコミットがデフォルトブランチに対してビルドあるいはテストの失敗を引き起こしたことを見ることができるようになります。このアプローチは、コードが常に健全であることを保証するための役に立ちます。 CIワークフローを拡張して、ワークフローの実行による成果物をアップロードするようにもできます。
+
+{% data variables.product.prodname_dotcom %}ホストランナーは、Java Development Kits（JDKs）及びAntを含むプリインストールされたソフトウェアを伴うツールキャッシュを持ちます。 JDK および Ant のソフトウェアとプリインストールされたバージョンのリストについては、「[{% data variables.product.prodname_dotcom %} でホストされているランナーの仕様](/actions/reference/specifications-for-github-hosted-runners/#supported-software)」を参照してください。
+
+### 必要な環境
+
+YAMLと{% data variables.product.prodname_actions %}の構文に馴染んでいる必要があります。 詳しい情報については、以下を参照してください。
+- [{% data variables.product.prodname_actions %}のワークフロー構文](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)
+- 「[{% data variables.product.prodname_actions %} を学ぶ](/actions/learn-github-actions)」
+
+Java及びAntフレームワークの基本的な理解をしておくことをおすすめします。 詳しい情報については[Apache Ant Manual](https://ant.apache.org/manual/)を参照してください。
+
+{% data reusables.actions.enterprise-setup-prereq %}
+
+### Antワークフローテンプレートで始める
+
+{% data variables.product.prodname_dotcom %}は、ほとんどのAntベースのJavaプロジェクトで使えるAntワークフローテンプレートを提供しています。 詳しい情報については[Antワークフローテンプレート](https://github.com/actions/starter-workflows/blob/main/ci/ant.yml)を参照してください。
+
+素早く始めるには、新しいワークフローを作成する際に事前設定されたAntテンプレートを選択できます。 詳しい情報については、「[{% data variables.product.prodname_actions %} のクイックスタート](/actions/quickstart)」を参照してください。
+
+リポジトリの`.github/workflows`に新しいファイルを作成して、手作業でこのワークフローを追加することもできます。
+
+{% raw %}
+```yaml
+name: Java CI
+
+on: [push]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up JDK 1.8
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Build with Ant
+        run: ant -noinput -buildfile build.xml
+```
+{% endraw %}
+
+このワークフローは以下のステップを実行します。
+
+1. `checkout`ステップは、ランナーにリポジトリのコピーをダウンロードします。
+2. `setup-java`ステップは、Java 1.8 JDKを設定します。
+3. "Build with Ant"ステップは、`build.xml`中のデフォルトターゲットを非インタラクティブモードで実行します。
+
+デフォルトのワークフローテンプレートは、ビルドとテストのワークフローを構築する際の素晴らしい出発点であり、プロジェクトの要求に合わせてこのテンプレートをカスタマイズできます。
+
+{% data reusables.github-actions.example-github-runner %}
+
+{% data reusables.github-actions.java-jvm-architecture %}
+
+### コードのビルドとテスト
+
+ローカルで使うのと同じコマンドを、コードのビルドとテストに使えます。
+
+このスターターワークフローは、_build.xml_ファイルで指定されたデフォルトのターゲットを実行します。  デフォルトのターゲットは、一般的にクラスをビルドし、テストを実行し、たとえばJARファイルのような配布可能なフォーマットにクラスをパッケージするように設定されるでしょう。
+
+プロジェクトのビルドに異なるコマンドを使ったり、異なるターゲットを実行したいのであれば、それらを指定できます。 たとえば、_build-ci.xml_ファイル中で設定された`jar`ターゲットを実行したいこともあるでしょう。
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+    with:
+      java-version: 1.8
+  - name: Run the Ant jar target
+    run: ant -noinput -buildfile build-ci.xml jar
+```
+{% endraw %}
+
+### 成果物としてのワークフローのデータのパッケージ化
+
+ビルドが成功し、テストがパスした後には、結果のJavaのパッケージをビルドの成果物としてアップロードすることになるかもしれません。 そうすれば、ビルドされたパッケージをワークフローの実行の一部として保存することになり、それらをダウンロードできるようになります。 成果物によって、プルリクエストをマージする前にローカルの環境でテスト及びデバッグしやすくなります。 詳しい情報については「[成果物を利用してワークフローのデータを永続化する](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)」を参照してください。
+
+Antは通常、JAR、EAR、WARのような出力ファイルを`build/jar`ディレクトリに作成します。 このディレクトリの内容は`upload-artifact`アクションを使ってアップロードできます。
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+  - run: ant -noinput -buildfile build.xml
+  - uses: actions/upload-artifact@v2
+    with:
+      name: Package
+      path: build/jar
+```
+{% endraw %}
diff --git a/translations/ja-JP/content/actions/guides/building-and-testing-java-with-gradle.md b/translations/ja-JP/content/actions/guides/building-and-testing-java-with-gradle.md
new file mode 100644
index 000000000000..db14443ac99d
--- /dev/null
+++ b/translations/ja-JP/content/actions/guides/building-and-testing-java-with-gradle.md
@@ -0,0 +1,134 @@
+---
+title: GradleでのJavaのビルドとテスト
+intro: GitHub Actions中で継続的インテグレーション（CI）ワークフローを作成し、GradleでJavaのプロジェクトのビルドとテストを行うことができます。
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/building-and-testing-java-with-gradle
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data variables.product.prodname_actions %} の支払いを管理する
+{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
+
+### はじめに
+
+このガイドは、Gradleビルドシステムを使ってJavaのプロジェクトのための継続的インテグレーション（CI）を実行するワークフローを作成する方法を紹介します。 作成するワークフローによって、プルリクエストに対するコミットがデフォルトブランチに対してビルドあるいはテストの失敗を引き起こしたことを見ることができるようになります。このアプローチは、コードが常に健全であることを保証するための役に立ちます。 CIワークフローを拡張して、ファイルをキャッシュし、ワークフローの実行による成果物をアップロードするようにもできます。
+
+{% data variables.product.prodname_dotcom %}ホストランナーは、Java Development Kits（JDKs）及びGradleを含むプリインストールされたソフトウェアを伴うツールキャッシュを持ちます。 JDK および Gradle のソフトウェアとプリインストールされたバージョンのリストについては、「[{% data variables.product.prodname_dotcom %} でホストされているランナーの仕様](/actions/reference/specifications-for-github-hosted-runners/#supported-software)」を参照してください。
+
+### 必要な環境
+
+YAMLと{% data variables.product.prodname_actions %}の構文に馴染んでいる必要があります。 詳しい情報については、以下を参照してください。
+- [{% data variables.product.prodname_actions %}のワークフロー構文](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)
+- 「[{% data variables.product.prodname_actions %} を学ぶ](/actions/learn-github-actions)」
+
+Java及びGradleフレームワークの基本的な理解をしておくことをおすすめします。 詳しい情報については、Gradleのドキュメンテーションの[Getting Started](https://docs.gradle.org/current/userguide/getting_started.html)を参照してください。
+
+{% data reusables.actions.enterprise-setup-prereq %}
+
+### Gradleワークフローテンプレートで始める
+
+{% data variables.product.prodname_dotcom %}は、ほとんどのGradleベースのJavaプロジェクトで使えるGradleワークフローテンプレートを提供しています。 詳しい情報については[Gradleワークフローテンプレート](https://github.com/actions/starter-workflows/blob/main/ci/gradle.yml)を参照してください。
+
+素早く始めるには、新しいワークフローを作成する際に事前設定されたGradleテンプレートを選択できます。 詳しい情報については、「[{% data variables.product.prodname_actions %} のクイックスタート](/actions/quickstart)」を参照してください。
+
+リポジトリの`.github/workflows`に新しいファイルを作成して、手作業でこのワークフローを追加することもできます。
+
+{% raw %}
+```yaml
+name: Java CI
+
+on: [push]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up JDK 1.8
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Build with Gradle
+        run: ./gradlew build
+```
+{% endraw %}
+
+このワークフローは以下のステップを実行します。
+
+1. `checkout`ステップは、ランナーにリポジトリのコピーをダウンロードします。
+2. `setup-java`ステップは、Java 1.8 JDKを設定します。
+3. "Build with Gradle"ステップは、ラッパースクリプトの`gradlew`を実行し、コードがビルドされ、テストをパスし、パッケージが作成できることを保証します。
+
+デフォルトのワークフローテンプレートは、ビルドとテストのワークフローを構築する際の素晴らしい出発点であり、プロジェクトの要求に合わせてこのテンプレートをカスタマイズできます。
+
+{% data reusables.github-actions.example-github-runner %}
+
+{% data reusables.github-actions.java-jvm-architecture %}
+
+### コードのビルドとテスト
+
+ローカルで使うのと同じコマンドを、コードのビルドとテストに使えます。
+
+スターターワークフローは、デフォルトで`build`タスクを実行します。 デフォルトのGradleの設定では、このコマンドは依存関係をダウンロードし、クラスをビルドし、テストを実行し、たとえばJARファイルのような配布可能なフォーマットにクラスをパッケージします。
+
+プロジェクトのビルドに異なるコマンドを使ったり、異なるタスクを使いたいのであれば、それらを指定できます。 たとえば、_ci.gradle_ファイル中で設定された`package`タスクを実行したいこともあるでしょう。
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+    with:
+      java-version: 1.8
+  - name: Run the Gradle package task
+    run: ./gradlew -b ci.gradle package
+```
+{% endraw %}
+
+### 依存関係のキャッシング
+
+ワークフローの実行速度を上げるために、依存関係をキャッシュすることもできます。 実行に成功した後、ローカルのGradleパッケージキャッシュがGitHub Actionsのインフラストラクチャ上に保存されます。 その後のワークフローの実行では、キャッシュがリストアされ、依存関係をリモートのパッケージリポジトリからダウンロードする必要がなくなります。 詳しい情報については「[ワークフローを高速化するための依存関係のキャッシング](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)」及び[`cache`アクション](https://github.com/marketplace/actions/cache)を参照してください。
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - name: Set up JDK 1.8
+    uses: actions/setup-java@v1
+    with:
+      java-version: 1.8
+  - name: Cache Gradle packages
+    uses: actions/cache@v2
+    with:
+      path: ~/.gradle/caches
+      key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle') }}
+      restore-keys: ${{ runner.os }}-gradle
+  - name: Build with Gradle
+    run: ./gradlew build
+```
+{% endraw %}
+
+このワークフローは、ランナーのホームディレクトリ内の`.gradle/caches`ディレクトリにあるローカルのGradleパッケージキャッシュの内容を保存します。 キャッシュのキーは、Gradleのビルドファイルの内容をハッシュしたものになるので、それらに変更があればキャッシュは無効になります。
+
+### 成果物としてのワークフローのデータのパッケージ化
+
+ビルドが成功し、テストがパスした後には、結果のJavaのパッケージをビルドの成果物としてアップロードすることになるかもしれません。 そうすれば、ビルドされたパッケージをワークフローの実行の一部として保存することになり、それらをダウンロードできるようになります。 成果物によって、プルリクエストをマージする前にローカルの環境でテスト及びデバッグしやすくなります。 詳しい情報については「[成果物を利用してワークフローのデータを永続化する](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)」を参照してください。
+
+Gradleは通常、JAR、EAR、WARのような出力ファイルを`build/libs`ディレクトリに作成します。 このディレクトリの内容は`upload-artifact`アクションを使ってアップロードできます。
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+  - run: ./gradlew build
+  - uses: actions/upload-artifact@v2
+    with:
+      name: Package
+      path: build/libs
+```
+{% endraw %}
diff --git a/translations/ja-JP/content/actions/guides/building-and-testing-java-with-maven.md b/translations/ja-JP/content/actions/guides/building-and-testing-java-with-maven.md
new file mode 100644
index 000000000000..0d8eb6c2eac4
--- /dev/null
+++ b/translations/ja-JP/content/actions/guides/building-and-testing-java-with-maven.md
@@ -0,0 +1,135 @@
+---
+title: MavenでのJavaのビルドとテスト
+intro: GitHub Actions中で継続的インテグレーション（CI）ワークフローを作成し、MavenでJavaのプロジェクトのビルドとテストを行うことができます。
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/building-and-testing-java-with-maven
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data variables.product.prodname_actions %} の支払いを管理する
+{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
+
+### はじめに
+
+このガイドは、ソフトウェアプロジェクト管理ツールのMavenを使ってJavaのプロジェクトのための継続的インテグレーション（CI）を実行するワークフローを作成する方法を紹介します。 作成するワークフローによって、プルリクエストに対するコミットがデフォルトブランチに対してビルドあるいはテストの失敗を引き起こしたことを見ることができるようになります。このアプローチは、コードが常に健全であることを保証するための役に立ちます。 CIワークフローを拡張して、ファイルをキャッシュし、ワークフローの実行による成果物をアップロードするようにもできます。
+
+{% data variables.product.prodname_dotcom %}ホストランナーは、Java Development Kits（JDKs）及びMavenを含むプリインストールされたソフトウェアを伴うツールキャッシュを持ちます。 JDK および Maven のソフトウェアとプリインストールされたバージョンのリストについては、「[{% data variables.product.prodname_dotcom %} でホストされているランナーの仕様](/actions/reference/specifications-for-github-hosted-runners/#supported-software)」を参照してください。
+
+### 必要な環境
+
+YAMLと{% data variables.product.prodname_actions %}の構文に馴染んでいる必要があります。 詳しい情報については、以下を参照してください。
+- [{% data variables.product.prodname_actions %}のワークフロー構文](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)
+- 「[{% data variables.product.prodname_actions %} を学ぶ](/actions/learn-github-actions)」
+
+Java及びMavenフレームワークの基本的な理解をしておくことをおすすめします。 詳しい情報については、Mavenのドキュメンテーションの[Maven Getting Started Guide](http://maven.apache.org/guides/getting-started/index.html)を参照してください。
+
+{% data reusables.actions.enterprise-setup-prereq %}
+
+### Mavenワークフローテンプレートで始める
+
+{% data variables.product.prodname_dotcom %}は、ほとんどのMavenベースのJavaプロジェクトで使えるMavenワークフローテンプレートを提供しています。 詳しい情報については[Mavenワークフローテンプレート](https://github.com/actions/starter-workflows/blob/main/ci/maven.yml)を参照してください。
+
+素早く始めるには、新しいワークフローを作成する際に事前設定されたMavenテンプレートを選択できます。 詳しい情報については、「[{% data variables.product.prodname_actions %} のクイックスタート](/actions/quickstart)」を参照してください。
+
+リポジトリの`.github/workflows`に新しいファイルを作成して、手作業でこのワークフローを追加することもできます。
+
+{% raw %}
+```yaml
+name: Java CI
+
+on: [push]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up JDK 1.8
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Build with Maven
+        run: mvn -B package --file pom.xml
+```
+{% endraw %}
+
+このワークフローは以下のステップを実行します。
+
+1. `checkout`ステップは、ランナーにリポジトリのコピーをダウンロードします。
+2. `setup-java`ステップは、Java 1.8 JDKを設定します。
+3. "Build with Maven"ステップは、Mavenの`package`ターゲットを非インタラクティブモードで実行し、コードがビルドされ、テストをパスし、パッケージが作成できることを保証します。
+
+デフォルトのワークフローテンプレートは、ビルドとテストのワークフローを構築する際の素晴らしい出発点であり、プロジェクトの要求に合わせてこのテンプレートをカスタマイズできます。
+
+{% data reusables.github-actions.example-github-runner %}
+
+{% data reusables.github-actions.java-jvm-architecture %}
+
+### コードのビルドとテスト
+
+ローカルで使うのと同じコマンドを、コードのビルドとテストに使えます。
+
+スターターワークフローは、デフォルトで`package`タスクを実行します。 デフォルトのMavenの設定では、このコマンドは依存関係をダウンロードし、クラスをビルドし、テストを実行し、たとえばJARファイルのような配布可能なフォーマットにクラスをパッケージします。
+
+プロジェクトのビルドに異なるコマンドを使ったり、異なるターゲットを使いたいのであれば、それらを指定できます。 たとえば、_pom-ci.xml_ファイル中で設定された`verify`ターゲットを実行したいこともあるでしょう。
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+    with:
+      java-version: 1.8
+  - name: Run the Maven verify phase
+    run: mvn -B verify --file pom-ci.xml
+```
+{% endraw %}
+
+### 依存関係のキャッシング
+
+ワークフローの実行速度を上げるために、依存関係をキャッシュすることもできます。 実行に成功した後、ローカルのMavenリポジトリがGitHub Actionsのインフラストラクチャ上に保存されます。 その後のワークフローの実行では、キャッシュがリストアされ、依存関係をリモートのMavenリポジトリからダウンロードする必要がなくなります。 詳しい情報については「[ワークフローを高速化するための依存関係のキャッシング](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)」及び[`cache`アクション](https://github.com/marketplace/actions/cache)を参照してください。
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - name: Set up JDK 1.8
+    uses: actions/setup-java@v1
+    with:
+      java-version: 1.8
+  - name: Cache Maven packages
+    uses: actions/cache@v2
+    with:
+      path: ~/.m2
+      key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }}
+      restore-keys: ${{ runner.os }}-m2
+  - name: Build with Maven
+    run: mvn -B package --file pom.xml
+```
+{% endraw %}
+
+このワークフローは、ランナーのホームディレクトリ内の`.m2`ディレクトリにあるローカルのMavenリポジトリの内容を保存します。 キャッシュのキーは_pom.xml_の内容をハッシュしたものになるので、_pom.xml_が変更されればキャッシュは無効になります。
+
+### 成果物としてのワークフローのデータのパッケージ化
+
+ビルドが成功し、テストがパスした後には、結果のJavaのパッケージをビルドの成果物としてアップロードすることになるかもしれません。 そうすれば、ビルドされたパッケージをワークフローの実行の一部として保存することになり、それらをダウンロードできるようになります。 成果物によって、プルリクエストをマージする前にローカルの環境でテスト及びデバッグしやすくなります。 詳しい情報については「[成果物を利用してワークフローのデータを永続化する](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)」を参照してください。
+
+Mavenは通常、JAR、EAR、WARのような出力ファイルを`target`ディレクトリに作成します。 それらを成果物としてアップロードするために、アップロードする成果物を含む新しいディレクトリにそれらをコピーできます。 たとえば、`staging`というディレクトリを作成できます。 として、そのディレクトリの内容を`upload-artifact`アクションを使ってアップロードできます。
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+  - run: mvn -B package --file pom.xml
+  - run: mkdir staging && cp target/*.jar staging
+  - uses: actions/upload-artifact@v2
+    with:
+      name: Package
+      path: staging
+```
+{% endraw %}
diff --git a/translations/ja-JP/content/actions/guides/building-and-testing-nodejs.md b/translations/ja-JP/content/actions/guides/building-and-testing-nodejs.md
new file mode 100644
index 000000000000..d49aba3fa542
--- /dev/null
+++ b/translations/ja-JP/content/actions/guides/building-and-testing-nodejs.md
@@ -0,0 +1,276 @@
+---
+title: Node.js のビルドとテスト
+intro: Node.jsプロジェクトのビルドとテストのための継続的インテグレーション（CI）ワークフローを作成できます。
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions
+  - /actions/language-and-framework-guides/using-nodejs-with-github-actions
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data variables.product.prodname_actions %} の支払いを管理する
+{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
+
+### はじめに
+
+このガイドでは、Node.jsのコードのビルドとテストを行う継続的インテグレーション（CI）ワークフローの作成方法を紹介します。 CIテストにパスしたなら、コードをデプロイしたりパッケージを公開したりすることになるでしょう。
+
+### 必要な環境
+
+Node.js、YAML、ワークフローの設定オプションと、ワークフローファイルの作成方法についての基本的な知識を持っておくことをおすすめします。 詳しい情報については、以下を参照してください。
+
+- 「[{% data variables.product.prodname_actions %} を学ぶ](/actions/learn-github-actions)」
+- 「[Node.js を使ってみる](https://nodejs.org/en/docs/guides/getting-started-guide/)」
+
+{% data reusables.actions.enterprise-setup-prereq %}
+
+### Node.jsワークフローテンプレートでの開始
+
+{% data variables.product.prodname_dotcom %}は、ほとんどのNode.jsプロジェクトで使えるNode.jsのワークフローテンプレートを提供しています。 このガイドには、カスタマイズして利用できるnpm及びYarnの例が含まれます。 詳しい情報については[Node.jsのワークフローテンプレート](https://github.com/actions/starter-workflows/blob/main/ci/node.js.yml)を参照してください。
+
+手早く始めるために、テンプレートをリポジトリの`.github/workflows`ディレクトリに追加してください。
+
+{% raw %}
+```yaml
+name: Node.js CI
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [8.x, 10.x, 12.x]
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v1
+      with:
+        node-version: ${{ matrix.node-version }}
+    - run: npm install
+    - run: npm run build --if-present
+    - run: npm test
+      env:
+        CI: true
+```
+{% endraw %}
+
+{% data reusables.github-actions.example-github-runner %}
+
+### Node.jsのバージョンの指定
+
+最も簡単にNode.jsのバージョンを指定する方法は、{% data variables.product.prodname_dotcom %}が提供する`setup-node`アクションを使うことです。 詳しい情報については[`setup-node`](https://github.com/actions/setup-node/)を参照してください。
+
+`setup-node`アクションはNode.jsのバージョンを入力として取り、ランナー上でそのバージョンを設定します。 `setup-node`は各ランナー上のツールキャッシュから指定されたNode.jsのバージョンを見つけ、必要なバイナリを`PATH`に追加します。設定されたバイナリは、ジョブでそれ以降永続化されます。 `setup-node`アクションの利用は、{% data variables.product.prodname_actions %}でNode.jsを使うための推奨される方法です。これは、そうすることで様々なランナーや様々なバージョンのNode.jsで一貫した振る舞いが保証されるためです。 セルフホストランナーを使っている場合は、Node.jsをインストールして`PATH`に追加しなければなりません。
+
+以下のテンプレートには、Node.jsのバージョン8.x、10.x、12.ｘでコードをビルドしてテストするマトリクス戦略が含まれています。 この'x'はワイルドカードキャラクターで、そのバージョンで利用できる最新のマイナー及びパッチリリースにマッチします。 `node-version`配列で指定されたNode.jsの各バージョンに対して、同じステップを実行するジョブが作成されます。
+
+それぞれのジョブは、配列`node-version` のマトリクスで定義された値に、`matrix`コンテキストを使ってアクセスできます。 `setup-node`アクションは、このコンテキストを`node-version`のインプットとして使います。 `setup-node`アクションは、コードのビルドとテストに先立って、様々なNode.jsのバージョンで各ジョブを設定します。 マトリクス戦略とコンテキストに関する詳しい情報については、「[{% data variables.product.prodname_actions %}のワークフロー構文](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix)」及び「[{% data variables.product.prodname_actions %}のコンテキストと式構文](/actions/reference/context-and-expression-syntax-for-github-actions)」を参照してください。
+
+{% raw %}
+```yaml
+strategy:
+  matrix:
+    node-version: [8.x, 10.x, 12.x]
+
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js ${{ matrix.node-version }}
+  uses: actions/setup-node@v1
+  with:
+    node-version: ${{ matrix.node-version }}
+```
+{% endraw %}
+
+あるいは、厳密にNode.jsバージョンを指定してビルドとテストを行うこともできます。
+
+```yaml
+strategy:
+  matrix:
+    node-version: [8.16.2, 10.17.0]
+```
+
+または、Node.jsの1つのバージョンを使ってビルドとテストを行うこともできます。
+
+{% raw %}
+```yaml
+name: Node.js CI
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Use Node.js
+      uses: actions/setup-node@v1
+      with:
+        node-version: '12.x'
+    - run: npm install
+    - run: npm run build --if-present
+    - run: npm test
+      env:
+        CI: true
+```
+{% endraw %}
+
+Node.jsのバージョンを指定しなかった場合、{% data variables.product.prodname_dotcom %}は環境のデフォルトのNode.jsのバージョンを使います。 詳しい情報については、「[{% data variables.product.prodname_dotcom %} ホストランナーの仕様](/actions/reference/specifications-for-github-hosted-runners/#supported-software)」を参照してください。
+
+### 依存関係のインストール
+
+{% data variables.product.prodname_dotcom %}ホストランナーには、依存関係マネージャーのnpmとYarnがインストールされています。 コードのビルドとテストに先立って、npmやYarnを使ってワークフロー中で依存関係をインストールできます。 Windows及びLinuxの{% data variables.product.prodname_dotcom %}ホストランナーには、Grunt、Gulp、Bowerもインストールされています。
+
+ワークフローの速度を上げるために、依存関係をキャッシュすることもできます。 詳しい情報については「[ワークフローを高速化するための依存関係のキャッシング](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)」を参照してください。
+
+#### npmの利用例
+
+以下の例では、*package.json*ファイルで定義された依存関係がインストールされます。 詳しい情報については[`npm install`](https://docs.npmjs.com/cli/install)を参照してください。
+
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    node-version: '12.x'
+- name: Install dependencies
+  run: npm install
+```
+
+`npm ci`を使うと、 *package-lock.json*あるいは*npm-shrinkwrap.json*ファイル中のバージョンがインストールされ、ロックファイルの更新を回避できます。 概して`npm ci`は、`npm install`を実行するよりも高速です。 詳しい情報については[`npm ci`](https://docs.npmjs.com/cli/ci.html)及び「[Introducing `npm ci` for faster, more reliable builds](https://blog.npmjs.org/post/171556855892/introducing-npm-ci-for-faster-more-reliable)」を参照してください。
+
+{% raw %}
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    node-version: '12.x'
+- name: Install dependencies
+  run: npm ci
+```
+{% endraw %}
+
+#### Yarnの利用例
+
+以下の例では、*package.json*ファイルで定義された依存関係がインストールされます。 詳しい情報については[`yarn install`](https://yarnpkg.com/en/docs/cli/install)を参照してください。
+
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    node-version: '12.x'
+- name: Install dependencies
+  run: yarn
+```
+
+あるいは`--frozen-lockfile`を渡して*yarn.lock*ファイル中のバージョンをインストールし、*yarn.lock*ファイルの更新を回避できます。
+
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    node-version: '12.x'
+- name: Install dependencies
+  run: yarn --frozen-lockfile
+```
+
+#### プライベートレジストリの利用と.npmrcファイルの作成の例
+
+{% data reusables.github-actions.setup-node-intro %}
+
+プライベートリポジトリで認証を受けるには、npm認証トークンをリポジトリ設定中にシークレットとして保存しなければなりません。 たとえば`NPM_TOKEN`というシークレットを生成してください。 詳しい情報については、「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。
+
+以下の例では、`NPM_TOKEN`というシークレットにはnpmの認証トークンが保存されます。 `setup-node`アクションは、環境変数の`NODE_AUTH_TOKEN`からnpmの認証トークンを読み取るよう*.npmrc*ファイルを設定します。 `setup-node`アクションを使って*.npmrc*ファイルを作成する場合、環境変数の`NPM_AUTH_TOKEN`にnpmの認証トークンを含むシークレットを設定しなければなりません。
+
+依存関係をインストールする前に、`setup-node`アクションを使って*.npmrc*ファイルを作成してください。 このアクションには2つの入力パラメーターがあります。 `node-version`パラメーターはNode.jsのバージョンを設定し、`registry-url`パラメーターはデフォルトのレジストリを設定します。 パッケージレジストリがスコープを使うなら、`scope`パラメーターを使わなければなりません。 詳しい情報については[`npm-scope`](https://docs.npmjs.com/misc/scope)を参照してください。
+
+{% raw %}
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    always-auth: true
+    node-version: '12.x'
+    registry-url: https://registry.npmjs.org
+    scope: '@octocat'
+- name: Install dependencies
+  run: npm ci
+  env:
+    NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}}
+```
+{% endraw %}
+
+上の例では、以下の内容で*.npmrc*ファイルを作成しています。
+
+```
+//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN}
+@octocat:registry=https://registry.npmjs.org/
+always-auth=true
+```
+
+#### 依存関係のキャッシングの例
+
+`cache`アクションを使って、ユニークキーを使って依存関係をキャッシュし、将来のワークフローの実行で依存関係をリストアできます。 詳しい情報については「[ワークフローを高速化するための依存関係のキャッシング](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)」及び[`cache`アクション](https://github.com/marketplace/actions/cache)を参照してください。
+
+{% raw %}
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    node-version: '12.x'
+- name: Cache Node.js modules
+  uses: actions/cache@v2
+  with:
+    # npm キャッシュファイルは Linux/macOS の「~/.npm」に保存される
+    path: ~/.npm 
+    key: ${{ runner.OS }}-node-${{ hashFiles('**/package-lock.json') }}
+    restore-keys: |
+      ${{ runner.OS }}-node-
+      ${{ runner.OS }}-
+- name: Install dependencies
+  run: npm ci
+```
+{% endraw %}
+
+### コードのビルドとテスト
+
+ローカルで使うのと同じコマンドを、コードのビルドとテストに使えます。 たとえば*package.json*ファイルで定義されたビルドのステップを実行するのに`npm run build`を実行し、テストスイートを実行するのに`npm test`を実行しているなら、それらのコマンドをワークフローファイルに追加します。
+
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    node-version: '12.x'
+- run: npm install
+- run: npm run build --if-present
+- run: npm test
+```
+
+### 成果物としてのワークフローのデータのパッケージ化
+
+ビルドとテストのステップの成果物を保存し、ジョブの完了後に見ることができます。 たとえば、ログファイル、コアダンプ、テスト結果、スクリーンショットを保存する必要があるかもしれません。 詳しい情報については「[成果物を利用してワークフローのデータを永続化する](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)」を参照してください。
+
+### パッケージレジストリへの公開
+
+CIテストにパスした後、Node.jsパッケージをパッケージレジストリに公開するようにワークフローを設定できます。 npm及び{% data variables.product.prodname_registry %}への公開に関する詳しい情報については「[Node.jsパッケージの公開](/actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages)」を参照してください。
diff --git a/translations/ja-JP/content/actions/guides/building-and-testing-python.md b/translations/ja-JP/content/actions/guides/building-and-testing-python.md
new file mode 100644
index 000000000000..3596418b1828
--- /dev/null
+++ b/translations/ja-JP/content/actions/guides/building-and-testing-python.md
@@ -0,0 +1,463 @@
+---
+title: Python のビルドとテスト
+intro: Pythonプロジェクトのビルドとテストのための継続的インテグレーション（CI）ワークフローを作成できます。
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/using-python-with-github-actions
+  - /actions/language-and-framework-guides/using-python-with-github-actions
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data variables.product.prodname_actions %} の支払いを管理する
+{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
+
+### はじめに
+
+このガイドは、Pythonパッケージのビルド、テスト、公開の方法を紹介します。
+
+{% data variables.product.prodname_dotcom %}ホストランナーは、Python及びPyPyを含むプリインストールされたソフトウェアを伴うツールキャッシュを持ちます。 自分では何もインストールする必要がありません！ 最新のソフトウェアと、Python および PyPy のプリインストールされたバージョンの完全なリストについては、「[{% data variables.product.prodname_dotcom %} ホストランナーの仕様](/actions/reference/specifications-for-github-hosted-runners/#supported-software)」を参照してください。
+
+### 必要な環境
+
+YAMLと{% data variables.product.prodname_actions %}の構文に馴染んでいる必要があります。 詳しい情報については、「[{% data variables.product.prodname_actions %} を学ぶ](/actions/learn-github-actions)」を参照してください。
+
+Python、PyPy、pipの基本的な理解をしておくことをおすすめします。 詳しい情報については、以下を参照してください。
+- [Getting started with Python](https://www.python.org/about/gettingstarted/)
+- [PyPy](https://pypy.org/)
+- [Pip package manager](https://pypi.org/project/pip/)
+
+{% data reusables.actions.enterprise-setup-prereq %}
+
+### Pythonワークフローテンプレートでの開始
+
+{% data variables.product.prodname_dotcom %}は、ほとんどのPythonプロジェクトで使えるPythonのワークフローテンプレートを提供しています。 このガイドには、テンプレートのカスタマイズに利用できる例が含まれます。 詳しい情報については[Pythonのワークフローテンプレート](https://github.com/actions/starter-workflows/blob/main/ci/python-package.yml)を参照してください。
+
+手早く始めるために、テンプレートをリポジトリの`.github/workflows`ディレクトリに追加してください。
+
+{% raw %}
+```yaml
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: [2.7, 3.5, 3.6, 3.7, 3.8]
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v2
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install flake8 pytest
+        if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
+    - name: Lint with flake8
+      run: |
+        # Python 構文エラーまたは未定義の名前がある場合はビルドを停止する
+        flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+        # exit-zeroはすべてのエラーを警告として扱う。 GitHubのエディタの幅は127文字
+        flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+    - name: Test with pytest
+      run: |
+        pytest
+```
+{% endraw %}
+
+### Pythonのバージョンの指定
+
+{% data variables.product.prodname_dotcom %}ホストランナー上でPythonもしくはPyPyのプリインストールされたバージョンを使うには、`setup-python`アクションを使ってください。 このアクションは各ランナーのツールキャッシュから指定されたバージョンのPythonもしくはPyPyを見つけ、必要なバイナリを`PATH`に追加します。設定されたバイナリは、ジョブでそれ以降永続化されます。 特定のバージョンの Python がツールキャッシュにプリインストールされていない場合、`setup-python` アクションは [`python-versions`](https://github.com/actions/python-versions) リポジトリから適切なバージョンをダウンロードして設定します。
+
+`setup-action`の利用は、{% data variables.product.prodname_actions %}でPythonを使うための推奨される方法です。 これは、そうすることで様々なランナーや様々なバージョンのPythonで一貫した振る舞いが保証されるためです。 セルフホストランナーを使っている場合は、Pythonをインストールして`PATH`に追加しなければなりません。 詳しい情報については、[`setup-python`アクション](https://github.com/marketplace/actions/setup-python)を参照してください。
+
+以下の表は、各{% data variables.product.prodname_dotcom %}ホストランナー内でのツールキャッシュの場所です。
+
+|                    | Ubuntu                          | Mac                                      | Windows                                    |
+| ------------------ | ------------------------------- | ---------------------------------------- | ------------------------------------------ |
+| **ツールキャッシュディレクトリ** | `/opt/hostedtoolcache/*`        | `/Users/runner/hostedtoolcache/*`        | `C:\hostedtoolcache\windows\*`         |
+| **Pythonツールキャッシュ** | `/opt/hostedtoolcache/Python/*` | `/Users/runner/hostedtoolcache/Python/*` | `C:\hostedtoolcache\windows\Python\*` |
+| **PyPyツールキャッシュ**   | `/opt/hostedtoolcache/PyPy/*`   | `/Users/runner/hostedtoolcache/PyPy/*`   | `C:\hostedtoolcache\windows\PyPy\*`   |
+
+セルフホストランナーを使用している場合は、`setup-python` アクションを使用して依存関係を管理するようにランナーを設定できます。 詳しい情報については、`setup-python` の README にある「[セルフホストランナーで setup-python を使用する](https://github.com/actions/setup-python#using-setup-python-with-a-self-hosted-runner)」を参照してください。
+
+{% data variables.product.prodname_dotcom %}は、セマンティックバージョン構文をサポートしています。 詳しい情報については「[セマンティックバージョンの利用](https://docs.npmjs.com/about-semantic-versioning#using-semantic-versioning-to-specify-update-types-your-package-can-accept)」及び「[セマンティックバージョンの仕様](https://semver.org/)」を参照してください。
+
+#### Pythonの複数バージョンの利用
+
+{% raw %}
+```yaml
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      # python-version内のPyPyのバージョンが利用できる。
+      # For example, pypy2 and pypy3
+      matrix:
+        python-version: [2.7, 3.5, 3.6, 3.7, 3.8]
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v2
+      with:
+        python-version: ${{ matrix.python-version }}
+    # 現在の Python バージョンを印刷して、マトリックスをテストできます
+    - name: Display Python version
+      run: python -c "import sys; print(sys.version)"
+```
+{% endraw %}
+
+#### 　特定のバージョンのPythonの利用
+
+Pythonの特定バージョンを設定することができます。 たとえば3.8が利用できます。 あるいは、セマンティックバージョン構文を使い、最新のマイナーリリースを使うことができます。 以下の例では、Python 3の最新のマイナーリリースを使います。
+
+{% raw %}
+```yaml
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python 3.x
+      uses: actions/setup-python@v2
+      with:
+        # セマンティックバージョン範囲の構文または Python バージョンの正確なバージョン
+        python-version: '3.x' 
+        # オプション - x64 または x86 アーキテクチャ、デフォルトは x64
+        architecture: 'x64' 
+    # 現在の Python バージョンを印刷して、マトリックスをテストできます
+    - name: Display Python version
+      run: python -c "import sys; print(sys.version)"
+```
+{% endraw %}
+
+#### バージョンの除外
+
+使用できないPythonのバージョンを指定すると、`setup-python`は`##[error]Version 3.4 with arch x64 not found`といったエラーで失敗します。 このエラーメッセージには、利用できるバージョンが含まれます。
+
+実行したくないPythonの環境があるなら、ワークフロー中で`exclude`キーワードを使うこともできます。 詳しい情報については、「[{% data variables.product.prodname_actions %} のワークフロー構文](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategy)」を参照してください。
+
+{% raw %}
+```yaml
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: [2.7, 3.6, 3.7, 3.8, pypy2, pypy3]
+        exclude:
+          - os: macos-latest
+            python-version: 3.6
+          - os: windows-latest
+            python-version: 3.6
+```
+{% endraw %}
+
+#### デフォルトバージョンのPythonの利用
+
+依存関係を明示的にしやすくなるので、ワークフロー中で使うPythonのバージョンの設定には`setup-python`を使うことをおすすめします。 `setup-python`を使わない場合、いずれかのシェルで`python`を呼ぶと`PATH`に設定されたデフォルトバージョンのPythonが使われます。 デフォルトバージョンのPythonは、{% data variables.product.prodname_dotcom %}ホストランナーによって様々なので、予想外の変更が生じたり、期待しているよりも古いバージョンが使われたりするかもしれません。
+
+| {% data variables.product.prodname_dotcom %}ホストランナー | 説明                                                                                                                                                                                                               |
+| --------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Ubuntu                                              | Ubuntuランナーでは`/usr/bin/python`及び`/usr/bin/python3`の下に複数バージョンのシステムPythonがあります。 {% data variables.product.prodname_dotcom %}がツールキャッシュにインストールしエチルバージョンに加えて、UbuntuにパッケージングされているバージョンのPythonがあります。                     |
+| Windows                                             | ツールキャッシュにあるPythonのバージョンを除けば、WindowsにはシステムPythonに相当するバージョンは含まれていません。 他のランナーとの一貫した動作を保ち、`setup-python`アクションなしですぐにPythonが使えるようにするため、{% data variables.product.prodname_dotcom %}はツールキャッシュからいくつかのバージョンを`PATH`に追加します。 |
+| macOS                                               | macOSランナーには、ツールキャッシュ内のバージョンに加えて、複数バージョンのシステムPythonがインストールされています。 システムのPythonバージョンは`/usr/local/Cellar/python/*`mディレクトリにあります。                                                                                      |
+
+### 依存関係のインストール
+
+{% data variables.product.prodname_dotcom %}ホストランナーには、パッケージマネージャーのpipがインストールされています。 コードのビルドとテストに先立って、pipを使ってパッケージレジストリのPyPIから依存関係をインストールできます。 たとえば以下のYAMLは`pip`パッケージインストーラーと`setuptools`及び`wheel`パッケージのインストールやアップグレードを行います。
+
+ワークフローの速度を上げるために、依存関係をキャッシュすることもできます。 詳しい情報については「[ワークフローを高速化するための依存関係のキャッシング](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)」を参照してください。
+
+{% raw %}
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Set up Python
+  uses: actions/setup-python@v2
+  with:
+    python-version: '3.x'
+- name: Install dependencies
+  run: python -m pip install --upgrade pip setuptools wheel
+```
+{% endraw %}
+
+#### Requirementsファイル
+
+`pip`をアップデートした後、次の典型的なステップは*requirements.txt*からの依存関係のインストールです。
+
+{% raw %}
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Set up Python
+  uses: actions/setup-python@v2
+  with:
+    python-version: '3.x'
+- name: Install dependencies
+  run: |
+    python -m pip install --upgrade pip
+    pip install -r requirements.txt
+```
+{% endraw %}
+
+#### 依存関係のキャッシング
+
+`cache`アクションを使って、ユニークキーを使ってpipの依存関係をキャッシュし、将来のワークフローの実行で依存関係をリストアできます。 詳しい情報については「[ワークフローを高速化するための依存関係のキャッシング](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)」を参照してください。
         
+
+ランナーのオペレーティングシステムによって、pipは依存関係を様々な場所にキャッシュします。 キャッシュする必要があるパスは、使用するオペレーティングシステムによって以下のUbuntuの例とは異なるかもしれません。 詳しい情報については[Pythonのキャッシングの例](https://github.com/actions/cache/blob/main/examples.md#python---pip)を参照してください。
+
+{% raw %}
+
+
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Setup Python
+  uses: actions/setup-python@v2
+  with:
+    python-version: '3.x'
+- name: Cache pip
+  uses: actions/cache@v2
+  with:
+    # このパスは Ubuntu に固有です
+    path: ~/.cache/pip
+    # 対応する要件ファイルにキャッシュヒットがあるかどうかを確認する
+    key: ${{ runner.os }}-pip-${{ hashFiles('requirements.txt') }}
+    restore-keys: |
+      ${{ runner.os }}-pip-
+      ${{ runner.os }}-
+- name: Install dependencies
+  run: pip install -r requirements.txt
+```
+
+
+{% endraw %}
+
+{% note %}
+
+**ノート：** 依存関係の数によっては、依存関係キャッシュを使う方が高速になることがあります。 多くの大きな依存関係を持つプロジェクトでは、ダウンロードに必要な時間を節約できるので、パフォーマンスの向上が見られるでしょう。 依存関係が少ないプロジェクトでは、大きなパフォーマンスの向上は見られないかもしれず、pipがキャッシュされた依存関係をインストールする方法のために、パフォーマンスがやや低下さえするかもしれません。 パフォーマンスはプロジェクトによって異なります。
+
+{% endnote %}
+
+
+
+### コードのテスト
+
+ローカルで使うのと同じコマンドを、コードのビルドとテストに使えます。
+
+
+
+#### pytest及びpytest-covでのテスト
+
+以下の例では、`pytest`及び`pytest-cov`をインストールあるいはアップグレードします。 そしてテストが実行され、JUnit形式で出力が行われ、一方でコードカバレッジの結果がCoberturaに出力されます。 詳しい情報については[JUnit](https://junit.org/junit5/)及び[Cobertura](https://cobertura.github.io/cobertura/)を参照してください。
+
+{% raw %}
+
+
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Set up Python
+  uses: actions/setup-python@v2
+  with:
+    python-version: '3.x'
+- name: Install dependencies
+  run: |
+    python -m pip install --upgrade pip
+    pip install -r requirements.txt
+- name: Test with pytest
+  run: |
+    pip install pytest
+    pip install pytest-cov
+    pytest tests.py --doctest-modules --junitxml=junit/test-results.xml --cov=com --cov-report=xml --cov-report=html
+```
+
+
+{% endraw %}
+
+
+
+#### Flake8を使ったコードのlint
+
+以下の例は、`flake8`をインストールもしくはアップグレードし、それを使ってすべてのファイルをlintします。 詳しい情報については[Flake8](http://flake8.pycqa.org/en/latest/)を参照してください。
+
+{% raw %}
+
+
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Set up Python
+  uses: actions/setup-python@v2
+  with:
+    python-version: '3.x'
+- name: Install dependencies
+  run: |
+    python -m pip install --upgrade pip
+    pip install -r requirements.txt
+- name: Lint with flake8
+  run: |
+    pip install flake8
+    flake8 .
+```
+
+
+{% endraw %}
+
+
+
+#### toxでのテストの実行
+
+{% data variables.product.prodname_actions %}では、toxでテストを実行し、その処理を複数のジョブに分散できます。 toxを起動する際には、特定のバージョンを指定するのではなく、`-e py`オプションを使って`PATH`中のPythonのバージョンを選択しなければなりません。 詳しい情報については [tox](https://tox.readthedocs.io/en/latest/)を参照してください。
+
+{% raw %}
+
+
+```yaml
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python: [2.7, 3.7, 3.8]
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Setup Python
+        uses: actions/setup-python@v2
+        with:
+          python-version: ${{ matrix.python }}
+      - name: Install Tox and any other packages
+        run: pip install tox
+      - name: Run Tox
+        # 「PATH」で Python のバージョンを使用して tox を実行する
+        run: tox -e py
+```
+
+
+{% endraw %}
+
+
+
+### 成果物としてのワークフローのデータのパッケージ化
+
+ワークフローの完了後に、成果物をアップロードして見ることができます。 たとえば、ログファイル、コアダンプ、テスト結果、スクリーンショットを保存する必要があるかもしれません。 詳しい情報については「[成果物を利用してワークフローのデータを永続化する](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)」を参照してください。
+
+以下の例は、`upload-artifact`アクションを使って`pytest`の実行によるテスト結果をアーカイブする方法を示しています。 詳しい情報については[`upload-artifact`アクション](https://github.com/actions/upload-artifact)を参照してください。
+
+{% raw %}
+
+
+```yaml
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: [2.7, 3.5, 3.6, 3.7, 3.8]
+
+      steps:
+      - uses: actions/checkout@v2
+      - name: Setup Python # Set Python version
+        uses: actions/setup-python@v2
+        with:
+          python-version: ${{ matrix.python-version }}
+      # pip と pytest をインストールする
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install pytest
+      - name: Test with pytest
+        run: pytest tests.py --doctest-modules --junitxml=junit/test-results-${{ matrix.python-version }}.xml
+      - name: Upload pytest test results
+        uses: actions/upload-artifact@v2
+        with:
+          name: pytest-results-${{ matrix.python-version }}
+          path: junit/test-results-${{ matrix.python-version }}.xml
+        # テスト失敗時にテスト結果を公開するには、always() を使用して常にこのステップを実行する
+        if: ${{ always() }}
+```
+
+
+{% endraw %}
+
+
+
+### パッケージレジストリへの公開
+
+CIテストにパスしたなら、Pythonパッケージを任意のパッケージレジストリに公開するようにワークフローを設定できます。
+
+パッケージを公開するのに必要なアクセストークンやクレデンシャルは、リポジトリシークレットを使って保存できます。 以下の例では、`twine`と`dist`を使ってパッケージを作成してPyPIに公開しています。 詳しい情報については、「[暗号化されたシークレットの作成と利用](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。
+
+{% raw %}
+
+
+```yaml
+name: Upload Python Package
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python
+      uses: actions/setup-python@v2
+      with:
+        python-version: '3.x'
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install setuptools wheel twine
+    - name: Build and publish
+      env:
+        TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }}
+        TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
+      run: |
+        python setup.py sdist bdist_wheel
+        twine upload dist/*
+```
+
+
+{% endraw %}
+
+テンプレートワークフローに関する詳しい情報については[`python-publish`](https://github.com/actions/starter-workflows/blob/main/ci/python-publish.yml)を参照してください。
diff --git a/translations/ja-JP/content/actions/guides/caching-dependencies-to-speed-up-workflows.md b/translations/ja-JP/content/actions/guides/caching-dependencies-to-speed-up-workflows.md
new file mode 100644
index 000000000000..209d641a5c33
--- /dev/null
+++ b/translations/ja-JP/content/actions/guides/caching-dependencies-to-speed-up-workflows.md
@@ -0,0 +1,192 @@
+---
+title: 依存関係をキャッシュしてワークフローのスピードを上げる
+shortTitle: 依存関係のキャッシング
+intro: 'ワークフローを高速化して効率を上げるために、依存関係や広く再利用されるファイルに対するキャッシュを作成して利用できます。'
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /github/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows
+  - /actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows
+  - /actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows
+versions:
+  free-pro-team: '*'
+---
+
+### ワークフローの依存関係のキャッシングについて
+
+ワークフローの実行は、しばしば他の実行と同じ出力あるいはダウンロードされた依存関係を再利用します。 たとえばMaven、Gradle、npm、Yarnといったパッケージ及び依存関係管理ツールは、ダウンロードされた依存関係のローカルキャッシュを保持します。
+
+{% data variables.product.prodname_dotcom %}ホストランナー上のジョブは、クリーンな仮想環境で開始され、依存関係を毎回ダウンロードしなければならず、ネットワークの利用率を増大させ、実行時間が長くなり、コストが高まってしまいます。 これらのファイルの再生成にかかる時間を短縮しやすくするために、{% data variables.product.prodname_dotcom %}はワークフロー内で頻繁に使われる依存関係をキャッシュできます。
+
+ジョブのために依存関係をキャッシュするには、{% data variables.product.prodname_dotcom %}の`cache`アクションを使わなければなりません。 このアクションは、ユニークなキーで指定されるキャッシュを取得します。 詳しい情報については「[`actions/cache`](https://github.com/actions/cache)」を参照してください。
+
+{% warning %}
+
+**警告**: パブリックリポジトリのキャッシュには、センシティブな情報を保存しないことをおすすめします。 たとえばキャッシュパス内のファイルに保存されたアクセストークンあるいはログインクレデンシャルなどがセンシティブな情報です。 また、`docker login`のようなコマンドラインインターフェース（CLI）プログラムは、アクセスクレデンシャルを設定ファイルに保存することがあります。 読み取りアクセスを持つ人は誰でも、リポジトリにプルリクエストを作成し、キャッシュの内容にアクセスできます。 リポジトリのフォークも、ベースブランチ上にプルリクエストを作成し、ベースブランチ上のキャッシュにアクセスできます。
+
+{% endwarning %}
+
+### 成果物の比較と依存関係のキャッシング
+
+成果物とキャッシングは、{% data variables.product.prodname_dotcom %}にファイルを保存できるようにするので似ていますが、それぞれの機能のユースケースは異なっており、入れ替えて使うことはできません。
+
+- キャッシングは、ジョブやワークフローの実行間で頻繁に変化しないファイルを再利用したいときに使ってください。
+- ジョブによって生成されたファイルをワークフローの終了後に見るために保存したい場合に成果物を使ってください。 詳しい情報については「[成果物を利用してワークフローのデータを永続化する](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)」を参照してください。
+
+### キャッシュへのアクセスについての制限
+
+`cache` アクションの `v2` を使用すると、`GITHUB_REF` を含むイベントによってトリガーされるワークフローのキャッシュにアクセスできます。 `cache` アクションの `v1` を使用している場合、`pull_request` の `closed` イベントを除いて、`push` イベントと `pull_request` イベントによってトリガーされるワークフローでのみキャッシュにアクセスできます。 詳しい情報については、「[ワークフローをトリガーするイベント](/actions/reference/events-that-trigger-workflows)」を参照してください。
+
+ワークフローは、現在のブランチ、ベースブランチ（フォークされたリポジトリのベースブランチを含む）、またはデフォルトブランチ（通常は `main`）で作成されたキャッシュにアクセスして復元できます。 たとえば、デフォルトブランチで作成されたキャッシュは、どのプルリクエストからもアクセスできます。 また、`feature-b` ブランチに `feature-a` ベースブランチがある場合、`feature-b` でトリガーされたワークフローは、デフォルトのブランチ（`main`）、`feature-a`、および `feature-b` で作成されたキャッシュにアクセスできます。
+
+アクセス制限は、異なるワークフローとブランチ間の論理的な境界を作成することによって、キャッシュの分離とセキュリティを提供します。 たとえば、`feature-a` ブランチ（ベース `main` を使用）向けに作成されたキャッシュは、`feature-b` ブランチ（ベース `main` を使用）のプルリクエストにアクセスできません。
+
+### `cache`アクションの利用
+
+`cache`アクションは、提供された`key`に基づいてキャッシュをリストアしようとします。 このアクションは、キャッシュを見つけるとそのキャッシュファイルを設定された`path`にリストアします。
+
+正確なマッチがなければ、ジョブが成功したならこのアクションは新しいキャッシュエントリを作成します。 新しいキャッシュは提供された`key`を使い、`path`ディレクトリ内にファイルを保存します。
+
+既存のキャッシュに`key`がマッチしなかった場合に使われる、`restore-keys`のリストを提供することもできます。 `restore-keys`のリストは、 `restore-keys`が部分的にしかキャッシュキーとマッチしないために、他のブランチからのキャッシュをリストアする場合に役立ちます。 `restore-keys`のマッチに関する詳しい情報については「[キャッシュキーのマッチ](#matching-a-cache-key)」を参照してください。
+
+詳しい情報については「[`actions/cache`](https://github.com/actions/cache)」を参照してください。
+
+#### `cache` アクションの入力パラメータ
+
+- `key`: **必須** このキーはキャッシュの保存時に作成され、キャッシュの検索に使われます。 変数、コンテキスト値、静的な文字列、関数の任意の組み合わせが使えます。 キーの長さは最大で512文字であり、キーが最大長よりも長いとアクションは失敗します。
+- `path`: **必須** ランナーがキャッシュあるいはリストアをするファイルパス。 このパスは、絶対パスでも、ワーキングディレクトリからの相対パスでもかまいません。
+  - `cache` アクションの `v2` では、単一のパスまたは複数のパスをリストとして指定できます。 パスはディレクトリまたは単一ファイルのいずれかで、glob パターンがサポートされています。
+  - `cache` アクションの `v1` では、単一のパスのみがサポートされ、かつそれがディレクトリである必要があります。 単一のファイルをキャッシュすることはできません。
+- `restore-keys`: **オプション** `key`に対するキャッシュヒットがなかった場合にキャッシュを見つけるために使われる代理キーの順序付きリスト。
+
+#### `cache`アクションの出力パラメータ
+
+- `cache-hit`: キーの完全一致が見つかったことを示すブール値。
+
+#### `cache` アクションの使用例
+
+以下の例では、`package-lock.json`ファイル内のパッケージが変更された場合、あるいはランナーのオペレーティングシステムが変更された場合に新しいキャッシュが作成されます。 キャッシュキーはコンテキストと式を使い、ランナーのオペレーティングシステムと`package-lock.json`ファイルのSHA-256ハッシュを含むキーを生成します。
+
+{% raw %}
+```yaml
+name: Caching with npm
+
+on: push
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+
+    - name: Cache node modules
+      uses: actions/cache@v2
+      env:
+        cache-name: cache-node-modules
+      with:
+        # npm キャッシュファイルは Linux/macOS の「~/.npm」に保存される
+        path: ~/.npm
+        key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }}
+        restore-keys: |
+          ${{ runner.os }}-build-${{ env.cache-name }}-
+          ${{ runner.os }}-build-
+          ${{ runner.os }}-
+
+    - name: Install Dependencies
+      run: npm install
+
+    - name: Build
+      run: npm build
+
+    - name: Test
+      run: npm test
+
+```
+{% endraw %}
+
+`key`が既存のキャッシュにマッチした場合はキャッシュヒットと呼ばれ、このアクションはキャッシュされたファイルを`path`ディレクトリにリストアします。
+
+`key`が既存のキャッシュにマッチしなかった場合はキャッシュミスと呼ばれ、ジョブが成功して完了したなら新しいキャッシュが作成されます。 キャッシュミスが生じた場合、このアクションは`restore-keys`と呼ばれる代理キーを検索します。
+
+1. `restore-keys`が渡された場合、`cache`アクションは`restore-keys`のリストにマッチするキャッシュを順番に検索します。
+   - 完全なマッチがあった場合、アクションはそのファイルを`path`ディレクトリ中のキャッシュにリストアします。
+   - 完全なマッチがなかった場合、アクションはリストアキーに対する部分一致を検索します。 アクションが部分一致を見つけた場合、最も最近のキャッシュが`path`ディレクトリにリストアされます。
+1. `cache` アクションが完了し、ジョブ内の次のワークフローステップが実行されます。
+1. ジョブが成功して完了したなら、アクションは`path`ディレクトリの内容で新しいキャッシュを作成します。
+
+複数のディレクトリにファイルをキャッシュするには、各ディレクトリごとに[`cache`](https://github.com/actions/cache) アクションを使うステップが必要です。 キャッシュをいったん作成すると、既存のキャッシュの内容を変更することはできませんが、新しいキーで新しいキャッシュを作成することはできます。
+
+#### コンテキストを使ったキャッシュキーの作成
+
+キャッシュキーには、コンテキスト、関数、リテラル、{% data variables.product.prodname_actions %}がサポートする演算子を含めることができます。 詳しい情報については、「[{% data variables.product.prodname_actions %} のコンテキストと式構文](/actions/reference/context-and-expression-syntax-for-github-actions)」を参照してください。
+
+式を使って`key`を作成すれば、依存関係が変化したときに自動的に新しいキャッシュを作成できます。 たとえばnpmの`package-lock.json`ファイルのハッシュを計算する式を使って`key`を作成できます。
+
+{% raw %}
+```
+npm-${{ hashFiles('package-lock.json') }}
+```
+{% endraw %}
+
+{% data variables.product.prodname_dotcom %}は`hash "package-lock.json"`という式を評価して、最終的な`key`を導出します。
+
+```
+npm-d5ea0750
+```
+
+### キャッシュキーのマッチング
+
+`cache` アクションは最初に、ワークフロー実行を含むブランチで `key` および `restore-keys` のキャッシュヒットを検索します。 現在のブランチにヒットがない場合、`cache` アクションは、親ブランチと上流のブランチで `key` および `restore-keys` を検索します。
+
+`key`でキャッシュミスがあった場合に使うリストアキーのリストを提供できます。 特定の度合いが強いものから弱いものへ並べて複数のリストアキーを作成できます。 `cache`アクションは順番に`restore-keys`を検索していきます。 キーが直接マッチしなかった場合、アクションはリストアキーでプレフィックスされたキーを検索します。 リストアキーに対して複数の部分一致があった場合、アクションは最も最近に作成されたキャッシュを返します。
+
+#### 複数のリストアキーの利用例
+
+{% raw %}
+```
+restore-keys: |
+  npm-foobar-${{ hashFiles('package-lock.json') }}
+  npm-foobar-
+  npm-
+```
+{% endraw %}
+
+ランナーは式を評価します。この式は以下のような`restore-keys`になります。
+
+{% raw %}
+```
+restore-keys: |
+  npm-foobar-d5ea0750
+  npm-foobar-
+  npm-
+```
+{% endraw %}
+
+リストアキーの`npm-foobar-`は、`npm-foobar-`という文字列で始まる任意のキーにマッチします。 たとえば`npm-foobar-fd3052de`や`npm-foobar-a9b253ff`というキーはいずれもこのリストアキーにマッチします。 最も最近の期日に作成されたキャッシュが使われます。 この例でのキーは、以下の順序で検索されます。
+
+1. **`npm-foobar-d5ea0750`**は特定のハッシュにマッチします。
+1. **`npm-foobar-`**は`npm-foobar-`をプレフィックスとするキャッシュキーにマッチします。
+1. **`npm-`**は`npm-`をプレフィックスとする任意のキーにマッチします。
+
+##### 検索の優先度の例
+
+```yaml
+key:
+  npm-feature-d5ea0750
+restore-keys: |
+  npm-feature-
+  npm-
+```
+
+たとえば、プルリクエストに `feature` ブランチ（現在のスコープ）が含まれ、デフォルトブランチ（`main`）をターゲットにしている場合、アクションは次の順序で `key` と `restore-keys` を検索します。
+
+1. `feature`ブランチのスコープ内で`npm-feature-d5ea0750`というキー
+1. `feature`ブランチのスコープ内で`npm-feature-`というキー
+2. `feature`ブランチのスコープ内で`npm-`というキー
+1. `main` ブランチのスコープ内で `npm-feature-d5ea0750` というキー
+3. `main` ブランチのスコープ内で `npm-feature-` というキー
+4. `main` ブランチのスコープ内で `npm` というキー
+
+### 利用制限と退去のポリシー
+
+{% data variables.product.prodname_dotcom %}は、7日間以上アクセスされていないキャッシュエントリを削除します。 保存できるキャッシュ数には上限がありませんが、1つのリポジトリ内のすべてのキャッシュの合計サイズは5GBに制限されます。 この制限を超えた場合、{% data variables.product.prodname_dotcom %}はキャッシュを保存しますが、合計サイズが5GB以下になるまでキャッシュを退去させはじめます。
diff --git a/translations/ja-JP/content/actions/guides/creating-postgresql-service-containers.md b/translations/ja-JP/content/actions/guides/creating-postgresql-service-containers.md
new file mode 100644
index 000000000000..252709d5ac77
--- /dev/null
+++ b/translations/ja-JP/content/actions/guides/creating-postgresql-service-containers.md
@@ -0,0 +1,335 @@
+---
+title: PostgreSQLサービスコンテナの作成
+shortTitle: PostgreSQL サービス コンテナ
+intro: ワークフローで利用するPostgreSQLサービスコンテナを作成できます。 このガイドでは、コンテナで実行されるジョブか、ランナーマシン上で直接実行されるジョブのためのPostgreSQLサービスの作成例を紹介します。
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/creating-postgresql-service-containers
+  - /actions/configuring-and-managing-workflows/creating-postgresql-service-containers
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data variables.product.prodname_actions %} の支払いを管理する
+{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
+
+### はじめに
+
+このガイドでは、Docker Hubの`postgres`イメージを使ってサービスコンテナを設定するワークフローの例を紹介します。 このワークフローは、PostgreSQLのクライアントを作成してクライアントにデータを展開するスクリプトを実行します。 PostgreSQLクライアントを作成して展開するワークフローをテストするために、このスクリプトはクライアントのデータをコンソールに出力します。
+
+{% data reusables.github-actions.docker-container-os-support %}
+
+### 必要な環境
+
+{% data reusables.github-actions.service-container-prereqs %}
+
+YAML、{% data variables.product.prodname_actions %}の構文、PosgreSQLの基本な理解があれば役立つかも知れません。 詳しい情報については、以下を参照してください。
+
+- 「[{% data variables.product.prodname_actions %} を学ぶ](/actions/learn-github-actions)」
+- PostgreSQLのドキュメンテーション中の[PostgreSQLチュートリアル](https://www.postgresqltutorial.com/)
+
+### コンテナ内でのジョブの実行
+
+{% data reusables.github-actions.container-jobs-intro %}
+
+{% data reusables.github-actions.copy-workflow-file %}
+
+{% raw %}
+```yaml
+name: PostgreSQL service example
+on: push
+
+jobs:
+  # コンテナジョブのラベル
+  container-job:
+    # コンテナはLinuxベースのオペレーティングシステム内で実行しなければならない
+    runs-on: ubuntu-latest
+    # `container-job`が実行されるDocker Hubのイメージ
+    container: node:10.18-jessie
+
+    # `container-job`と実行されるサービスコンテナ
+    services:
+      # サービスコンテナへのアクセスに使われるラベル
+      postgres:
+        # Docker Hubのイメージ
+        image: postgres
+        # postgresのパスワードを提供
+        env:
+          POSTGRES_PASSWORD: postgres
+        # postgresが起動するまで待つヘルスチェックの設定
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
+    steps:
+      # CIテストの実行前にリポジトリからコードのコピーをダウンロード
+      - name: Check out repository code
+        uses: actions/checkout@v2
+
+      # `package.json`ファイル内のすべての依存関係のクリーンインストールを実行
+      # 詳しい情報についてはhttps://docs.npmjs.com/cli/ci.htmlを参照
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Connect to PostgreSQL
+        # PostgreSQLクライアントを作成し、クライアントにデータを展開し、
+        # データを取り出すスクリプトを実行
+        run: node client.js
+        # `client.js`スクリプトが新しいPostgreSQLクライアントの作成に使う環境変数
+        env:
+          # PostgreSQLサービスコンテナとの通信に使われるホスト名
+          POSTGRES_HOST: postgres
+          # デフォルトのPostgreSQLポート
+          POSTGRES_PORT: 5432
+```
+{% endraw %}
+
+#### ランナージョブの設定
+
+{% data reusables.github-actions.service-container-host %}
+
+{% data reusables.github-actions.postgres-label-description %}
+
+```yaml
+jobs:
+  # コンテナジョブのラベル
+  container-job:
+    # コンテナはLinuxベースのオペレーティングシステム内で実行しなければならない
+    runs-on: ubuntu-latest
+    # `container-job`が実行されるDocker Hubのイメージ
+    container: node:10.18-jessie
+
+    # `container-job`と実行されるサービスコンテナ
+    services:
+      # サービスコンテナへのアクセスに使われるラベル
+      postgres:
+        # Docker Hubのイメージ
+        image: postgres
+        # postgresのパスワードを提供
+        env:
+          POSTGRES_PASSWORD: postgres
+        # postgresが起動するまで待つヘルスチェックの設定
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+```
+
+#### ステップの設定
+
+{% data reusables.github-actions.service-template-steps %}
+
+```yaml
+steps:
+  # CIテストの実行前にリポジトリのコードのコピーをダウンロード
+  - name: Check out repository code
+    uses: actions/checkout@v2
+
+  # `package.json`ファイル中のすべての依存関係のクリーンインストールを実行
+  # 詳しい情報については https://docs.npmjs.com/cli/ci.html を参照
+  - name: Install dependencies
+    run: npm ci
+
+  - name: Connect to PostgreSQL
+    # PostgreSQLクライアントを作成し、クライアントにデータを展開し、
+    # データを取り出すスクリプトを実行
+    run: node client.js
+    # `client.js`スクリプトが新しいPostgreSQLクライアントを作成する際に
+    # 利用する環境変数
+    env:
+      # PostgreSQLサービスコンテナとの通信に使われるホスト名
+      POSTGRES_HOST: postgres
+      # デフォルトのPostgreSQLポート
+      POSTGRES_PORT: 5432
+```
+
+{% data reusables.github-actions.postgres-environment-variables %}
+
+PostgreSQLサービスのホスト名は、ワークフロー中で設定されたラベルで、ここでは`postgres`です。 同じユーザー定義ブリッジネットワーク上のDockerコンテナは、デフォルトですべてのポートをオープンするので、サービスコンテナにはデフォルトのPostgreSQLのポートである5432でアクセスできます。
+
+### ランナーマシン上で直接のジョブの実行
+
+ランナーマシン上で直接ジョブを実行する場合、サービスコンテナ上のポートをDockerホスト上のポートにマップしなければなりません。 Dockerホストからサービスコンテナへは、`localhost`とDockerホストのポート番号を使ってアクセスできます。
+
+{% data reusables.github-actions.copy-workflow-file %}
+
+{% raw %}
+```yaml
+name: PostgreSQL Service Example
+on: push
+
+jobs:
+  # ランナージョブのラベル
+  runner-job:
+    # サービスコンテナもしくはコンテナジョブを使う場合にはLinux環境を使わなければならない
+    runs-on: ubuntu-latest
+
+    # `runner-job`と実行されるサービスコンテナ
+    services:
+      # サービスコンテナへのアクセスに使われるラベル
+      postgres:
+        # Docker Hubのイメージ
+        image: postgres
+        # postgresのパスワードを提供
+        env:
+          POSTGRES_PASSWORD: postgres
+        # posgresが起動するまで待つヘルスチェックの設定
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          # サービスコンテナ上のTCPポート5432をホストにマップ
+          - 5432:5432
+
+    steps:
+      # CIテストの実行前にリポジトリからコードのコピーをダウンロード
+      - name: Check out repository code
+        uses: actions/checkout@v2
+
+      # `package.json`ファイル内のすべての依存関係のクリーンインストールを実行
+      # 詳しい情報についてはhttps://docs.npmjs.com/cli/ci.htmlを参照
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Connect to PostgreSQL
+        # PostgreSQLクライアントを作成し、クライアントにデータを展開し、
+        # データを取り出すスクリプトを実行
+        run: node client.js
+        # `client.js`スクリプトが新しいPostgreSQLクライアントの
+        # 作成に使う環境変数
+        env:
+          # PostgreSQLサービスコンテナとの通信に使われるホスト名
+          POSTGRES_HOST: localhost
+          # デフォルトのPostgreSQLポート
+          POSTGRES_PORT: 5432
+```
+{% endraw %}
+
+#### ランナージョブの設定
+
+{% data reusables.github-actions.service-container-host-runner %}
+
+{% data reusables.github-actions.postgres-label-description %}
+
+このワークフローはPostgreSQLサービスコンテナ上のポート5432をDockerホストにマップします。 `ports`キーワードに関する詳しい情報については「[サービスコンテナについて](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)」を参照してください。
+
+```yaml
+jobs:
+  # ランナージョブのラベル
+  runner-job:
+    # サービスコンテナもしくはコンテナジョブを使う場合にはLinux環境を使わなければならない
+    runs-on: ubuntu-latest
+
+    # `runner-job`と実行されるサービスコンテナ
+    services:
+      # サービスコンテナへのアクセスに使われるラベル
+      postgres:
+        # Docker Hubのイメージ
+        image: postgres
+        # postgresにパスワードを提供
+        env:
+          POSTGRES_PASSWORD: postgres
+        # postgresが起動するまで待つヘルスチェックの設定
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          # サービスコンテナ上のTCPポート5432をホストにマップ
+          - 5432:5432
+```
+
+#### ステップの設定
+
+{% data reusables.github-actions.service-template-steps %}
+
+```yaml
+steps:
+  # CIテストの実行前にリポジトリのコードのコピーをダウンロード
+  - name: Check out repository code
+    uses: actions/checkout@v2
+
+  # `package.json`ファイル中のすべての依存関係のクリーンインストールを実行
+  # 詳しい情報については https://docs.npmjs.com/cli/ci.html を参照
+  - name: Install dependencies
+    run: npm ci
+
+  - name: Connect to PostgreSQL
+    # PostgreSQLクライアントを作成し、クライアントにデータを展開し、
+    # データを取り出すスクリプトを実行
+    run: node client.js
+    # `client.js`スクリプトが新しいPostgreSQLクライアントを作成する際に
+    # 利用する環境変数
+    env:
+      # PostgreSQLサービスコンテナとの通信に使われるホスト名
+      POSTGRES_HOST: localhost
+      # デフォルトのPostgreSQLポート
+      POSTGRES_PORT: 5432
+```
+
+{% data reusables.github-actions.postgres-environment-variables %}
+
+{% data reusables.github-actions.service-container-localhost %}
+
+### PostgreSQLサービスコンテナのテスト
+
+ワークフローを以下のスクリプトでテストできます。このスクリプトはPostgreSQLクライアントを作成し、いくつかのプレースホルダーデータで新しいテーブルを追加します。 そしてこのスクリプトは、PostgreSQLクライアント内に保存された値をターミナルに出力します。 スクリプトには好きな言語を使えますが、この例ではNode.jsとnpmモジュールの`pg`を使っています。 詳しい情報については[npm pgモジュール](https://www.npmjs.com/package/pg)を参照してください。
+
+*client.js*を修正して、ワークフローで必要なPostgreSQLの操作を含めることができます。 この例では、スクリプトはPostgreSQLクライアントのインスタンスを作成し、テーブルを作成し、プレースホルダーデータを追加し、そしてそのデータを取り出します。
+
+{% data reusables.github-actions.service-container-add-script %}
+
+```javascript
+const { Client } = require('pg');
+
+const pgclient = new Client({
+    host: process.env.POSTGRES_HOST,
+    port: process.env.POSTGRES_PORT,
+    user: 'postgres',
+    password: 'postgres',
+    database: 'postgres'
+});
+
+pgclient.connect();
+
+const table = 'CREATE TABLE student(id SERIAL PRIMARY KEY, firstName VARCHAR(40) NOT NULL, lastName VARCHAR(40) NOT NULL, age INT, address VARCHAR(80), email VARCHAR(40))'
+const text = 'INSERT INTO student(firstname, lastname, age, address, email) VALUES($1, $2, $3, $4, $5) RETURNING *'
+const values = ['Mona the', 'Octocat', 9, '88 Colin P Kelly Jr St, San Francisco, CA 94107, United States', 'octocat@github.com']
+
+pgclient.query(table, (err, res) => {
+    if (err) throw err
+});
+
+pgclient.query(text, values, (err, res) => {
+    if (err) throw err
+});
+
+pgclient.query('SELECT * FROM student', (err, res) => {
+    if (err) throw err
+    console.log(err, res.rows) // Print the data in student table
+    pgclient.end()
+});
+```
+
+このスクリプトは新しいPostgreSQLの`Client`を作成します。これは、パラメーターとして`host`と`port`を受け付けます。 スクリプトは環境変数の`POSTGRES_HOST`と`POSTGRES_PORT`を使って、クライアントのIPアドレスとポートを設定します。 `host`と`port`が定義されていない場合、デフォルトのホストは`localhost`で、デフォルトのポートは5432になります。
+
+スクリプトはテーブルを作成し、そのテーブルにプレースホルダーデータを展開します。 PostgreSQLデータベースがデータを含んでいることをテストするために、スクリプトはテーブルの内容をコンソールログに出力します。
+
+このワークフローを実行すると、"Connect to PostgreSQL"ステップで以下のように出力され、PostgreSQLのクライアントが作成され、データが追加されたことが確認できます。
+
+```
+null [ { id: 1,
+    firstname: 'Mona the',
+    lastname: 'Octocat',
+    age: 9,
+    address:
+     '88 Colin P Kelly Jr St, San Francisco, CA 94107, United States',
+    email: 'octocat@github.com' } ]
+```
diff --git a/translations/ja-JP/content/actions/guides/creating-redis-service-containers.md b/translations/ja-JP/content/actions/guides/creating-redis-service-containers.md
new file mode 100644
index 000000000000..7901e089a4fd
--- /dev/null
+++ b/translations/ja-JP/content/actions/guides/creating-redis-service-containers.md
@@ -0,0 +1,325 @@
+---
+title: Redisサービスコンテナの作成
+shortTitle: Redis サービス コンテナ
+intro: サービスコンテナを使って、ワークフロー中でRedisのクライアントを作成できます。 このガイドでは、コンテナで実行されるジョブか、ランナーマシン上で直接実行されるジョブのためのRedisサービスの作成例を紹介します。
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/creating-redis-service-containers
+  - /actions/configuring-and-managing-workflows/creating-redis-service-containers
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data variables.product.prodname_actions %} の支払いを管理する
+{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
+
+### はじめに
+
+このガイドでは、Docker Hubの`redis`イメージを使ってサービスコンテナを設定するワークフローの例を紹介します。 このワークフローは、Redisのクライアントを作成してクライアントにデータを展開するスクリプトを実行します。 Redisクライアントを作成して展開するワークフローをテストするために、このスクリプトはクライアントのデータをコンソールに出力します。
+
+{% data reusables.github-actions.docker-container-os-support %}
+
+### 必要な環境
+
+{% data reusables.github-actions.service-container-prereqs %}
+
+YAML、{% data variables.product.prodname_actions %}の構文、Redisの基本な理解があれば役立つかも知れません。 詳しい情報については、以下を参照してください。
+
+- 「[{% data variables.product.prodname_actions %} を学ぶ](/actions/learn-github-actions)」
+- Redisのドキュメンテーション中の[Getting Started with Redis](https://redislabs.com/get-started-with-redis/)
+
+### コンテナ内でのジョブの実行
+
+{% data reusables.github-actions.container-jobs-intro %}
+
+{% data reusables.github-actions.copy-workflow-file %}
+
+{% raw %}
+```yaml
+name: Redis container example
+on: push
+
+jobs:
+  # コンテナジョブのラベル
+  container-job:
+    # コンテナはLinuxベースのオペレーティングシステム内で実行しなければならない
+    runs-on: ubuntu-latest
+    # `container-job`が実行されるDocker Hubのイメージ
+    container: node:10.18-jessie
+
+    # `container-job`と実行されるサービスコンテナ
+    services:
+      # サービスコンテナへのアクセスに使われるラベル
+      redis:
+        # Docker Hubのイメージ
+        image: redis
+        # redisが起動するまで待つヘルスチェックの設定
+        options: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
+    steps:
+      # CIテストの実行前にリポジトリからコードのコピーをダウンロード
+      - name: Check out repository code
+        uses: actions/checkout@v2
+
+      # `package.json`ファイル内のすべての依存関係のクリーンインストールの実行
+      # 詳しい情報についてはhttps://docs.npmjs.com/cli/ci.htmlを参照
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Connect to Redis
+        # Redisクライアントを作成し、クライアントにデータを展開し、
+        # データを取り出すスクリプトを実行
+        run: node client.js
+        # `client.js`スクリプトが新しいRedisクライアントを作成するのに使う環境変数
+        env:
+          # Redisサービスコンテナとの通信に使われるホスト名
+          REDIS_HOST: redis
+          # デフォルトのRedisポート
+          REDIS_PORT: 6379
+```
+{% endraw %}
+
+#### コンテナジョブの設定
+
+{% data reusables.github-actions.service-container-host %}
+
+{% data reusables.github-actions.redis-label-description %}
+
+```yaml
+jobs:
+  # コンテナジョブのラベル
+  container-job:
+    # コンテナはLinuxベースのオペレーティングシステム内で実行しなければならない
+    runs-on: ubuntu-latest
+    # `container-job`が実行されるDocker Hubのイメージ
+    container: node:10.18-jessie
+
+    # `container-job`と実行されるサービスコンテナ
+    services:
+      # サービスコンテナへのアクセスに使われるラベル
+      redis:
+        # Docker Hubのイメージ
+        image: redis
+        # redisが起動するまで待つヘルスチェックの設定
+        options: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+```
+
+#### ステップの設定
+
+{% data reusables.github-actions.service-template-steps %}
+
+```yaml
+steps:
+  # CIテストの実行前にリポジトリのコードのコピーをダウンロード
+  - name: Check out repository code
+    uses: actions/checkout@v2
+
+  # `package.json`ファイル中のすべての依存関係のクリーンインストールの実行
+  # 詳しい情報については https://docs.npmjs.com/cli/ci.html を参照
+  - name: Install dependencies
+    run: npm ci
+
+  - name: Connect to Redis
+    # Redisクライアントを作成し、クライアントにデータを展開し、
+    # データを取り出すスクリプトを実行
+    run: node client.js
+    # `client.js`スクリプトが新しいRedisクライアントを作成する際に利用する環境変数
+    env:
+          # Redisサービスコンテナとの通信に使われるホスト名
+          REDIS_HOST: redis
+          # デフォルトのRedisポート
+          REDIS_PORT: 6379
+```
+
+{% data reusables.github-actions.redis-environment-variables %}
+
+Redisサービスのホスト名は、ワークフロー中で設定されたラベルで、ここでは`redis`です。 同じユーザー定義ブリッジネットワーク上のDockerコンテナは、デフォルトですべてのポートをオープンするので、サービスコンテナにはデフォルトのRedisのポートである6379でアクセスできます。
+
+### ランナーマシン上で直接のジョブの実行
+
+ランナーマシン上で直接ジョブを実行する場合、サービスコンテナ上のポートをDockerホスト上のポートにマップしなければなりません。 Dockerホストからサービスコンテナへは、`localhost`とDockerホストのポート番号を使ってアクセスできます。
+
+{% data reusables.github-actions.copy-workflow-file %}
+
+{% raw %}
+```yaml
+name: Redis runner example
+on: push
+
+jobs:
+  # ランナージョブのラベル
+  runner-job:
+    # サービスコンテナもしくはコンテナジョブを使う際にはLinux環境を使わなければならない
+    runs-on: ubuntu-latest
+
+    # `runner-job`と実行されるサービスコンテナ
+    services:
+      # サービスコンテナへのアクセスに使われるラベル
+      redis:
+        # Docker Hubのイメージ
+        image: redis
+        # redisが起動するまで待つヘルスチェックの設定
+        options: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          # サービスコンテナのポート6379をホストにマップ
+          - 6379:6379
+
+    steps:
+      # CIテストの実行前にリポジトリのコードのコピーをダウンロード
+      - name: Check out repository code
+        uses: actions/checkout@v2
+
+      # `package.json`ファイル内のすべての依存関係のクリーンインストールの実行
+      # 詳しい情報についてはhttps://docs.npmjs.com/cli/ci.htmlを参照
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Connect to Redis
+        # Redisクライアントを作成し、クライアントにデータを展開し、
+        # データを取り出すスクリプトを実行
+        run: node client.js
+        # `client.js`スクリプトが新しいRedisクライアントを作成するのに
+        # 使う環境変数
+        env:
+          # Redisサービスコンテナとの通信に使われるホスト名
+          REDIS_HOST: localhost
+          # デフォルトのRedisポート
+          REDIS_PORT: 6379
+```
+{% endraw %}
+
+#### ランナージョブの設定
+
+{% data reusables.github-actions.service-container-host-runner %}
+
+{% data reusables.github-actions.redis-label-description %}
+
+このワークフローはRedisサービスコンテナ上のポート6379をDockerホストにマップします。 `ports`キーワードに関する詳しい情報については「[サービスコンテナについて](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)」を参照してください。
+
+```yaml
+jobs:
+  # ランナージョブのラベル
+  runner-job:
+    # サービスコンテナもしくはコンテナジョブを使う際にはLinux環境を使わなければならない
+    runs-on: ubuntu-latest
+
+    # `runner-job`と実行するサービスコンテナ
+    services:
+      # サービスコンテナへのアクセスに使うラベル
+      redis:
+        # Docker Hubのイメージ
+        image: redis
+        # redisが起動するまで待つヘルスチェックの設定
+        options: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          # サービスコンテナ上のポート6379をホストにマップ
+          - 6379:6379
+```
+
+#### ステップの設定
+
+{% data reusables.github-actions.service-template-steps %}
+
+```yaml
+steps:
+  # CIテストの実行前にリポジトリのコードのコピーをダウンロード
+  - name: Check out repository code
+    uses: actions/checkout@v2
+
+  # `package.json`ファイル中のすべての依存関係のクリーンインストールの実行
+  # 詳しい情報については https://docs.npmjs.com/cli/ci.html を参照
+  - name: Install dependencies
+    run: npm ci
+
+  - name: Connect to Redis
+    # Redisクライアントを作成し、クライアントにデータを展開し、
+    # データを取り出すスクリプトを実行
+    run: node client.js
+    # `client.js`スクリプトが新しいRedisクライアントを作成する際に
+    # 利用する環境変数
+    env:
+          # Redisサービスコンテナとの通信に使われるホスト名
+          REDIS_HOST: localhost
+          # デフォルトのRedisポート
+          REDIS_PORT: 6379
+```
+
+{% data reusables.github-actions.redis-environment-variables %}
+
+{% data reusables.github-actions.service-container-localhost %}
+
+### Redisサービスコンテナのテスト
+
+ワークフローを以下のスクリプトでテストできます。このスクリプトはRedisクライアントを作成し、いくつかのプレースホルダーデータをクライアントに展開します。 そしてこのスクリプトは、Redisクライアント内に保存された値をターミナルに出力します。 スクリプトには好きな言語を使えますが、この例ではNode.jsとnpmモジュールの`redis`を使っています。 詳しい情報については[npm redisモジュール](https://www.npmjs.com/package/redis)を参照してください。
+
+*client.js*を修正して、ワークフローで必要なRedisの操作を含めることができます。 この例では、スクリプトはRedisクライアントのインスタンスを作成し、プレースホルダーデータを追加し、そしてそのデータを取り出します。
+
+{% data reusables.github-actions.service-container-add-script %}
+
+```javascript
+const redis = require("redis");
+
+// 新しいRedisクライアントの作成
+// REDIS_HOSTが設定されていなければ、デフォルトのホストはlocalhost
+// REDIS_PORTが設定されていなければ、デフォルトのポートは6379
+const redisClient = redis.createClient({
+  host: process.env.REDIS_HOST,
+  port: process.env.REDIS_PORT  
+});
+
+redisClient.on("error", function(err) {
+    console.log("Error " + err);
+});
+
+// キー"octocat"に"Mona the octocat"という値を設定
+redisClient.set("octocat", "Mona the Octocat", redis.print);
+// キーを"octocat"、フィールドを"species"、"value"を"Cat and Octopus"に設定
+redisClient.hset("species", "octocat", "Cat and Octopus", redis.print);
+// キーを"octocat"、フィールドを"species"、"value"を"Dinosaur and Octopus"に設定
+redisClient.hset("species", "dinotocat", "Dinosaur and Octopus", redis.print);
+// キーを"octocat"、フィールドを"species"、 "value"を"Cat and Robot"に設定
+redisClient.hset(["species", "robotocat", "Cat and Robot"], redis.print);
+// キー"species"のすべてのフィールドを取得
+
+redisClient.hkeys("species", function (err, replies) {
+    console.log(replies.length + " replies:");
+    replies.forEach(function (reply, i) {
+        console.log("    " + i + ": " + reply);
+    });
+    redisClient.quit();
+});
+```
+
+このスクリプトは新しいRedisクライアントを`createClient`メソッドを使って作成します。これは、パラメーターとして`host`と`port`を受け付けます。 スクリプトは環境変数の`REDIS_HOST`と`REDIS_PORT`を使って、クライアントのIPアドレスとポートを設定します。 `host`と`port`が定義されていない場合、デフォルトのホストは`localhost`で、デフォルトのポートは6379になります。
+
+このスクリプトは、`set`及び`hset`メソッドを使ってデータベースにいくつかのキー、フィールド、値を展開します。 Redisデータベースがデータを含んでいることを確認するために、スクリプトはデータベースの内容をコンソールログに出力します。
+
+このワークフローを実行すると、"Connect to Redis"ステップで以下のように出力され、Redisのクライアントが作成され、データが追加されたことが確認できます。
+
+```
+Reply: OK
+Reply: 1
+Reply: 1
+Reply: 1  
+3 replies:
+    0: octocat
+    1: dinotocat
+    2: robotocat
+```
diff --git a/translations/ja-JP/content/actions/guides/index.md b/translations/ja-JP/content/actions/guides/index.md
new file mode 100644
index 000000000000..bc96d737c4ee
--- /dev/null
+++ b/translations/ja-JP/content/actions/guides/index.md
@@ -0,0 +1,60 @@
+---
+title: ガイド
+shortTitle: ガイド
+intro: '{% data variables.product.prodname_actions %} のこれらのガイドには、ワークフローの設定に役立つ特定の使用例とサンプルが含まれています。'
+redirect_from:
+  - /actions/guides/caching-and-storing-workflow-data
+  - /actions/automating-your-workflow-with-github-actions/using-databases-and-services
+  - /actions/configuring-and-managing-workflows/using-databases-and-service-containers
+  - /actions/guides/using-databases-and-service-containers
+  - /actions/language-and-framework-guides
+  - /actions/language-and-framework-guides/github-actions-for-docker
+  - /actions/language-and-framework-guides/github-actions-for-java
+  - /actions/language-and-framework-guides/github-actions-for-javascript-and-typescript
+  - /actions/language-and-framework-guides/github-actions-for-python
+  - /actions/publishing-packages-with-github-actions
+  - /actions/building-and-testing-code-with-continuous-integration
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data variables.product.prodname_actions %} の支払いを管理する
+{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
+
+### カスタム継続的インテグレーションワークフローを作成する
+
+{% data variables.product.prodname_actions %} を使用して、さまざまなプログラミング言語で記述されたプロジェクトを設定およびテストするカスタム継続的インテグレーション (CI) ワークフローを作成できます。
+
+{% link_in_list /about-continuous-integration %}
+{% link_in_list /setting-up-continuous-integration-using-workflow-templates %}
+{% link_in_list /building-and-testing-nodejs %}
+{% link_in_list /building-and-testing-python %}
+{% link_in_list /building-and-testing-java-with-maven %}
+{% link_in_list /building-and-testing-java-with-gradle %}
+{% link_in_list /building-and-testing-java-with-ant %}
+
+### ソフトウェア パッケージを公開する
+
+継続的デリバリ (CD) ワークフローの一部として、ソフトウェア パッケージの公開を自動化できます。 パッケージは、任意のパッケージ ホストおよび {% data reusables.gated-features.packages %} に公開できます。
+
+{% link_in_list /about-packaging-with-github-actions %}
+{% link_in_list /publishing-nodejs-packages %}
+{% link_in_list /publishing-java-packages-with-maven %}
+{% link_in_list /publishing-java-packages-with-gradle %}
+{% link_in_list /publishing-docker-images %}
+
+### ワークフローデータのキャッシングと保存
+
+依存関係をキャッシュし、成果物を保存して、ワークフローの実行を効率化してください。
+
+{% link_in_list /storing-workflow-data-as-artifacts %}
+{% link_in_list /caching-dependencies-to-speed-up-workflows %}
+
+### ワークフローでサービスコンテナを使用する
+
+サービス コンテナを使用して、サービスをワークフローに接続します。
+
+{% link_in_list /about-service-containers %}
+{% link_in_list /creating-redis-service-containers %}
+{% link_in_list /creating-postgresql-service-containers %}
diff --git a/translations/ja-JP/content/actions/guides/publishing-docker-images.md b/translations/ja-JP/content/actions/guides/publishing-docker-images.md
new file mode 100644
index 000000000000..366b0a882379
--- /dev/null
+++ b/translations/ja-JP/content/actions/guides/publishing-docker-images.md
@@ -0,0 +1,158 @@
+---
+title: Dockerイメージの公開
+intro: '継続的インテグレーション（CI）の一部として、Docker Hubや{% data variables.product.prodname_registry %}といったレジストリに対しDockerイメージを公開できます。'
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/publishing-docker-images
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data variables.product.prodname_actions %} の支払いを管理する
+{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
+
+### はじめに
+
+このガイドでは、Dockerのビルドを実行し、DockerのイメージをDocker Hubあるいは{% data variables.product.prodname_registry %}に公開するワークフローの作成方法を紹介します。 1つのワークフローで、1つのレジストリあるいは複数のレジストリにイメージを公開できます。
+
+{% note %}
+
+**ノート:** 他のサードパーティのDockerレジストリにプッシュしたい場合は、「[{% data variables.product.prodname_registry %}へのイメージの公開](#publishing-images-to-github-packages)」セクションにある例がよいテンプレートになるでしょう。
+
+{% endnote %}
+
+### 必要な環境
+
+ワークフローの設定オプションと、ワークフローファイルの作成方法についての基本的な知識を持っておくことをおすすめします。 詳しい情報については、「[{% data variables.product.prodname_actions %} を学ぶ](/actions/learn-github-actions)」を参照してください。
+
+以下についての基本的な理解があると役に立つでしょう。
+
+- 「[暗号化されたシークレット](/actions/reference/encrypted-secrets)」
+- 「[ワークフローでの認証](/actions/reference/authentication-in-a-workflow)」
+- [{% data variables.product.prodname_registry %}で利用するためのDockerの設定](/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)
+
+### イメージの設定について
+
+このガイドは、{% data variables.product.prodname_dotcom %}レジストリ内に保存されたDockerのイメージについての完全な定義を持っていることを前提としています。 たとえば、リポジトリにはイメージを作成するためのDockerビルドを行うのに必要な_Dockerfile_やその他のファイルが含まれていなければなりません。
+
+このガイドではDockerの`build-push-action`アクションを使って、Dockerイメージをビルドし、それを1つ以上のDockerレジストリにプッシュします。 詳しい情報については[`build-push-action`](https://github.com/marketplace/actions/build-and-push-docker-images)を参照してください。
+
+{% data reusables.actions.enterprise-marketplace-actions %}
+
+### Docker Hubへのイメージの公開
+
+{% data reusables.github-actions.release-trigger-workflow %}
+
+以下のワークフローの例では、Dockerの`build-push-action`アクションを使ってDockerイメージをビルドし、ビルドが成功すれば構築されたイメージをDocker Hubにプッシュします。
+
+Docker Hubにプッシュするためには、Docker Hubのアカウントを持っており、Docker Hubのレジストリを作成していなければなりません。 詳しい情報についてはDockerのドキュメンテーション中の「[Share images on Docker Hub](https://docs.docker.com/get-started/part3/)」を参照してください。
+
+Docker Hubに必要な`build-push-action`のオプションは以下のとおりです。
+
+* `username`及び`password`: Docker Hubのユーザ名とパスワードです。 Docker Hubのユーザ名とパスワードは、{% data variables.product.prodname_dotcom %}リポジトリに暗号化されたシークレットとして保存し、ワークフローファイルで公開しないことをおすすめします。 詳しい情報については、「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。
+* `repository`: `DOCKER-HUB-NAMESPACE/DOCKER-HUB-REPOSITORY`フォーマットでのDocker Hubのリポジトリ。
+
+{% raw %}
+```yaml
+name: Publish Docker image
+on:
+  release:
+    types: [published]
+jobs:
+  push_to_registry:
+    name: Push Docker image to Docker Hub
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out the repo
+        uses: actions/checkout@v2
+      - name: Push to Docker Hub
+        uses: docker/build-push-action@v1
+        with:
+          username: ${{ secrets.DOCKER_USERNAME }}
+          password: ${{ secrets.DOCKER_PASSWORD }}
+          repository: my-docker-hub-namespace/my-docker-hub-repository
+          tag_with_ref: true
+```
+{% endraw %}
+
+{% data reusables.github-actions.docker-tag-with-ref %}
+
+### {% data variables.product.prodname_registry %}へのイメージの公開
+
+{% data reusables.github-actions.release-trigger-workflow %}
+
+以下のワークフローの例では、Dockerの`build-push-action`アクションを使ってDockerイメージをビルドし、ビルドが成功すれば構築されたイメージを{% data variables.product.prodname_registry %}にプッシュします。
+
+{% data variables.product.prodname_registry %}に必要な`build-push-action`のオプションは以下のとおりです。
+
+* `username`: {% raw %}`${{ github.actor }}`{% endraw %}コンテキストを使って、ワークフローの実行を始めたユーザのユーザ名を自動的に使うことができます。 詳しい情報については、「[GitHub Actionsのコンテキストと式構文](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)」を参照してください。
+* `password`: パスワードには、自動的に生成された`GITHUB_TOKEN`シークレットを利用できます。 詳しい情報については「[GITHUB_TOKENでの認証](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)」を参照してください。
+* `registry`: `docker.pkg.github.com`に設定しなければなりません。
+* `repository`: `OWNER/REPOSITORY/IMAGE_NAME`というフォーマットで設定しなければなりません。 たとえば、`http://github.com/octo-org/octo-repo`にある{% data variables.product.prodname_dotcom %}上に保存される`octo-image`という名前のイメージでは、`repository`オプションは`octo-org/octo-repo/octo-image`に設定しなければなりません。
+
+{% raw %}
+```yaml
+name: Publish Docker image
+on:
+  release:
+    types: [published]
+jobs:
+  push_to_registry:
+    name: Push Docker image to GitHub Packages
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out the repo
+        uses: actions/checkout@v2
+      - name: Push to GitHub Packages
+        uses: docker/build-push-action@v1
+        with:
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+          registry: docker.pkg.github.com
+          repository: my-org/my-repo/my-image
+          tag_with_ref: true
+
+```
+{% endraw %}
+
+{% data reusables.github-actions.docker-tag-with-ref %}
+
+### Docker Hubと{% data variables.product.prodname_registry %}へのイメージの公開
+
+1つのワークフローで、それぞれのレジストリに対して`build-push-action`アクションを使い、複数のレジストリにDockerイメージを公開できます。
+
+以下のワークフローの例では、以前のセクション（「[Docker Hubへのイメージの公開](#publishing-images-to-docker-hub)」及び「[{% data variables.product.prodname_registry %}へのイメージの公開](#publishing-images-to-github-packages)」）での`build-push-action`ステップを使い、両方のレジストリにプッシュを行う1つのワークフローを作成します。
+
+{% raw %}
+```yaml
+name: Publish Docker image
+on:
+  release:
+    types: [published]
+jobs:
+  push_to_registries:
+    name: Push Docker image to multiple registries
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out the repo
+        uses: actions/checkout@v2
+      - name: Push to Docker Hub
+        uses: docker/build-push-action@v1
+        with:
+          username: ${{ secrets.DOCKER_USERNAME }}
+          password: ${{ secrets.DOCKER_PASSWORD }}
+          repository: my-docker-hub-namespace/my-docker-hub-repository
+          tag_with_ref: true
+      - name: Push to GitHub Packages
+        uses: docker/build-push-action@v1
+        with:
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+          registry: docker.pkg.github.com
+          repository: my-org/my-repo/my-image
+          tag_with_ref: true
+```
+{% endraw %}
+
+上のワークフローの例は、{% data variables.product.prodname_dotcom %}リポジトリをチェックアウトし、`build-push-action`アクションを2回使ってDockerイメージをビルドしてDocker Hubと{% data variables.product.prodname_registry %}にプッシュします。 どちらのステップでも、このワークフローは`build-push-action`のオプションの[`tag_with_ref`](https://github.com/marketplace/actions/build-and-push-docker-images#tag_with_ref)を、構築されたDockerイメージをワークフローイベントのGit参照で自動的にタグ付けするように設定します。 このワークフローは{% data variables.product.prodname_dotcom %}リリースの公開で起動されるので、どちらのレジストリの参照も、そのリリースのGitタグになります。
diff --git a/translations/ja-JP/content/actions/guides/publishing-java-packages-with-gradle.md b/translations/ja-JP/content/actions/guides/publishing-java-packages-with-gradle.md
new file mode 100644
index 000000000000..e8638a6b6313
--- /dev/null
+++ b/translations/ja-JP/content/actions/guides/publishing-java-packages-with-gradle.md
@@ -0,0 +1,219 @@
+---
+title: GradleでのJavaパッケージの公開
+intro: 継続的インテグレーション（CI）ワークフローの一部として、Javaのパッケージをレジストリに公開するためにGradleを利用できます。
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/publishing-java-packages-with-gradle
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data variables.product.prodname_actions %} の支払いを管理する
+{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
+
+### はじめに
+
+{% data reusables.github-actions.publishing-java-packages-intro %}
+
+### 必要な環境
+
+ワークフローファイルと設定オプションに関する基本的な理解をしておくことをおすすめします。 詳しい情報については、「[{% data variables.product.prodname_actions %} を学ぶ](/actions/learn-github-actions)」を参照してください。
+
+GradleでのJavaプロジェクトのためのCIワークフローの作成に関する詳しい情報については「[GradleでのJavaのビルドとテスト](/actions/language-and-framework-guides/building-and-testing-java-with-gradle)」を参照してください。
+
+また、以下の基本的な理解があれば役立ちます。
+
+- [{% data variables.product.prodname_registry %} で利用するために npm を設定する](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)
+- 「[環境変数](/actions/reference/environment-variables)」
+- 「[暗号化されたシークレット](/actions/reference/encrypted-secrets)」
+- 「[ワークフローでの認証](/actions/reference/authentication-in-a-workflow)」
+
+### パッケージの設定について
+
+_build.gradle_ファイルの`MavenPublication`セクションにある`groupId`及び`artifactId`フィールドは、レジストリがパッケージをレジストリにリンクするために使用する、パッケージのためのユニークな識別子を生成します。  これは、Mavenの_pom.xml_ファイルにおける`groupId`と`artifactId`に似ています。  詳しい情報については、Gradleのドキュメンテーションの「[Maven Publish Plugin](https://docs.gradle.org/current/userguide/publishing_maven.html)」を参照してください。
+
+_build.gradle_ファイルには、Gradleがパッケージを公開する配布管理リポジトリの設定も含まれています。 各リポジトリは、名前、デプロイメントのURL、認証のためのクレデンシャルを持っていなければなりません。
+
+### Maven Central Repositoryへのパッケージの公開
+
+新しいリリースを作成するたびに、パッケージを公開するワークフローを起動できます。 以下の例でのワークフローは、`created`という種類で`release`イベントが発生したときに実行されます。 このワークフローは、CIテストをパスすればMaven Central Repositoryにパッケージを公開します。 `release`イベントに関する詳しい情報については「[ワークフローを起動するイベント](/actions/reference/events-that-trigger-workflows#release)」を参照してください。
+
+_build.gradle_ファイルのpublishingブロックには、パッケージリポジトリを指す新しいMavenリポジトリを定義できます。  たとえば、OSSRHホスティングプロジェクトを通じてMaven Central Repositoryにデプロイしていたなら、_build.gradle_ は`”OSSRH"`という名前でリポジトリを指定できます。
+
+{% raw %}
+```groovy
+publishing {
+  ...
+
+  repositories {
+    maven {
+      name = "OSSRH"
+      url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/"
+      credentials {
+        username = System.getenv("MAVEN_USERNAME")
+        password = System.getenv("MAVEN_PASSWORD")
+      }
+    }
+  }
+}
+```
+{% endraw %}
+
+この設定で、`gradle publish`コマンドの実行によってパッケージをMaven Central Repositoryに公開するワークフローを作成できます。 リポジトリの認証のために、ユーザ名とパスワードを含む環境変数を提供する必要もあります。
+
+デプロイのステップでは、ユーザ名とパスワードのための環境変数か、Mavenリポジトリの認証に使うトークンを環境変数に設定する必要があります。 詳しい情報については、「[暗号化されたシークレットの作成と利用](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。
+
+
+{% raw %}
+```yaml
+name: Publish package to the Maven Central Repository
+on:
+  release:
+    types: [created]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Java
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Publish package
+        run: gradle publish
+        env:
+          MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
+          MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}
+```
+{% endraw %}
+
+{% data reusables.github-actions.gradle-workflow-steps %}
+1. `gradle publish`コマンドを実行して、`OSSRH` Mavenリポジトリに公開してください。 環境変数の`MAVEN_USERNAME`は`OSSRH_USERNAME`シークレットの内容で、環境変数の`MAVEN_PASSWORD`は`OSSRH_TOKEN`シークレットの内容で設定されます。
+
+   ワークフロー中でのシークレットの利用に関する詳しい情報については「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。
+
+### {% data variables.product.prodname_registry %}へのパッケージの公開
+
+新しいリリースを作成するたびに、パッケージを公開するワークフローを起動できます。 以下の例でのワークフローは、`created`という種類で`release`イベントが発生したときに実行されます。 このワークフローは、CIテストをパスすれば{% data variables.product.prodname_registry %}にパッケージを公開します。 `release`イベントに関する詳しい情報については「[ワークフローを起動するイベント](/actions/reference/events-that-trigger-workflows#release)」を参照してください。
+
+_build.gradle_のpublishingブロックには、{% data variables.product.prodname_registry %}を指す新しいMavenリポジトリを定義できます。  そのリポジトリの設定では、CIワークフローの実行で設定された環境変数を活用することもできます。  環境変数の`GITHUB_ACTOR`はユーザ名として利用でき、環境変数の`GITHUB_TOKEN`には`GITHUB_TOKEN`シークレットを設定できます。
+
+`GITHUB_TOKEN`は、デフォルトでリポジトリ中に存在し、ワークフローが実行されるリポジトリ中のパッケージには読み書きの権限があります。 詳しい情報については「[GITHUB_TOKENでの認証](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)」を参照してください。
+
+たとえば、Organizationの名前が"octocat"でリポジトリの名前が"hello-world"なら、_build.gradle_中の{% data variables.product.prodname_registry %}の設定は以下の例のようになるでしょう。
+
+{% raw %}
+```groovy
+publishing {
+  ...
+
+  repositories {
+    maven {
+      name = "GitHubPackages"
+      url = "https://maven.pkg.github.com/octocat/hello-world"
+      credentials {
+        username = System.getenv("GITHUB_ACTOR")
+        password = System.getenv("GITHUB_TOKEN")
+      }
+    }
+  }
+}
+```
+{% endraw %}
+
+この設定で、`gradle publish`コマンドの実行によってパッケージをMaven Central Repositoryに公開するワークフローを作成できます。
+
+{% raw %}
+```yaml
+name: Publish package to GitHub Packages
+on:
+  release:
+    types: [created]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Publish package
+        run: gradle publish
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
+
+{% data reusables.github-actions.gradle-workflow-steps %}
+1. {% data variables.product.prodname_registry %}に公開するために` gradle publish `コマンドを実行してください。 環境変数`GITHUB_TOKEN`には、`GITHUB_TOKEN`シークレットの内容が設定されます。
+
+   ワークフロー中でのシークレットの利用に関する詳しい情報については「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。
+
+### Maven Central Repositoryと{% data variables.product.prodname_registry %}へのパッケージの公開
+
+_ build.gradle _ファイルでそれぞれについて設定すれば、Maven Central Repositoryと{% data variables.product.prodname_registry %}の両方にパッケージを公開できます。
+
+_build.gradle_ファイルに、{% data variables.product.prodname_dotcom %}リポジトリとMaven Central Repositoryプロバイダの双方に対するリポジトリを確実に含めてください。
+
+たとえば、OSSRHホスティングプロジェクトを通じてMaven Central Repositoryにデプロイしていたなら、`name`を`OSSRH `に設定して配布管理リポジトリでそのことを指定できます。 {% data variables.product.prodname_registry %}にデプロイするなら、`name`を`GitHubPackages`に設定して配布管理リポジトリでそのことを指定できます。
+
+Organizationの名前が"octocat"でリポジトリの名前が"hello-world"なら、_build.gradle_中の{% data variables.product.prodname_registry %}の設定は以下の例のようになるでしょう。
+
+{% raw %}
+```groovy
+publishing {
+  ...
+
+  repositories {
+    maven {
+      name = "OSSRH"
+      url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/"
+      credentials {
+        username = System.getenv("MAVEN_USERNAME")
+        password = System.getenv("MAVEN_PASSWORD")
+      }
+    }
+    maven {
+      name = "GitHubPackages"
+      url = "https://maven.pkg.github.com/octocat/hello-world"
+      credentials {
+        username = System.getenv("GITHUB_ACTOR")
+        password = System.getenv("GITHUB_TOKEN")
+      }
+    }
+  }
+}
+```
+{% endraw %}
+
+この設定で、`gradle publish`コマンドの実行によってパッケージをMaven Central Repositoryと{% data variables.product.prodname_registry %}の両方に公開するワークフローを作成できます。
+
+{% raw %}
+```yaml
+name: Publish package to the Maven Central Repository and GitHub Packages
+on:
+  release:
+    types: [created]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Java
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Publish to the Maven Central Repository
+        run: gradle publish
+        env:
+          MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
+          MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
+
+{% data reusables.github-actions.gradle-workflow-steps %}
+1. `OSSRH` Mavenリポジトリと{% data variables.product.prodname_registry %}に公開するために` gradle publish`コマンドを実行してください。 環境変数の`MAVEN_USERNAME`は`OSSRH_USERNAME`シークレットの内容で、環境変数の`MAVEN_PASSWORD`は`OSSRH_TOKEN`シークレットの内容で設定されます。 環境変数`GITHUB_TOKEN`には、`GITHUB_TOKEN`シークレットの内容が設定されます。
+
+   ワークフロー中でのシークレットの利用に関する詳しい情報については「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。
diff --git a/translations/ja-JP/content/actions/guides/publishing-java-packages-with-maven.md b/translations/ja-JP/content/actions/guides/publishing-java-packages-with-maven.md
new file mode 100644
index 000000000000..b12bbedcfcbb
--- /dev/null
+++ b/translations/ja-JP/content/actions/guides/publishing-java-packages-with-maven.md
@@ -0,0 +1,210 @@
+---
+title: MavenでのJavaのパッケージの公開
+intro: 継続的インテグレーション（CI）ワークフローの一部として、Javaのパッケージをレジストリに公開するためにMavenを利用できます。
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/publishing-java-packages-with-maven
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data variables.product.prodname_actions %} の支払いを管理する
+{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
+
+### はじめに
+
+{% data reusables.github-actions.publishing-java-packages-intro %}
+
+### 必要な環境
+
+ワークフローファイルと設定オプションに関する基本的な理解をしておくことをおすすめします。 詳しい情報については、「[{% data variables.product.prodname_actions %} を学ぶ](/actions/learn-github-actions)」を参照してください。
+
+MavenでのJavaプロジェクトのためのCIワークフローの作成に関する詳しい情報については「[MavenでのJavaのビルドとテスト](/actions/language-and-framework-guides/building-and-testing-java-with-maven)」を参照してください。
+
+また、以下の基本的な理解があれば役立ちます。
+
+- [{% data variables.product.prodname_registry %} で利用するために npm を設定する](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)
+- 「[環境変数](/actions/reference/environment-variables)」
+- 「[暗号化されたシークレット](/actions/reference/encrypted-secrets)」
+- 「[ワークフローでの認証](/actions/reference/authentication-in-a-workflow)」
+
+### パッケージの設定について
+
+_pom.xml_ファイル中の`groupId`及び`artifactId`フィールドは、レジストリがパッケージをレジストリにリンクするために利用するパッケージのユニークな識別子を作成します。  詳しい情報については、Apache Mavenのドキュメンテーションの[Guide to uploading artifacts to the Central Repository](http://maven.apache.org/repository/guide-central-repository-upload.html)を参照してください。
+
+_pom.xml_ファイルには、Mavenがパッケージをデプロイする配布管理リポジトリの設定も含まれています。 各リポジトリは、名前とデプロイメントURLを持たなければなりません。 これらのリポジトリに対する認証は、Mavenを実行するユーザーのホームディレクトリ内の_.m2/settings.xml_ファイルに設定できます。
+
+`setup-java`アクションを使って、デプロイメントリポジトリを認証と合わせて設定できます。 詳しい情報については[`setup-java`](https://github.com/actions/setup-java)を参照してください。
+
+### Maven Central Repositoryへのパッケージの公開
+
+新しいリリースを作成するたびに、パッケージを公開するワークフローを起動できます。 以下の例でのワークフローは、`created`という種類で`release`イベントが発生したときに実行されます。 このワークフローは、CIテストをパスすればMaven Central Repositoryにパッケージを公開します。 `release`イベントに関する詳しい情報については「[ワークフローを起動するイベント](/actions/reference/events-that-trigger-workflows#release)」を参照してください。
+
+このワークフロー内では、`setup-java`アクションを利用できます。 このアクションは、指定されたバージョンのJDKを`PATH`にインストールしますが、パッケージの公開のためのMavenの_settings.xml_も設定します。 デフォルトでは、設定ファイルは{% data variables.product.prodname_registry %}に対して設定されますが、Maven Central Repositoryなどの他のパッケージレジストリにデプロイするようにも設定できます。 _pom.xml_に設定済みの配布管理リポジトリが酢デイあるなら、`setup-java`アクションの呼び出しの際にその`id`を指定できます。
+
+たとえば、OSSRHホスティングプロジェクトを通じてMaven Central Repositoryにデプロイしていたなら、_pom.xml_ は`ossrh`の`id`で配布管理リポジトリを指定できます。
+
+{% raw %}
+```xml
+
+  ...
+  
+    
+      ossrh
+      Central Repository OSSRH
+      https://oss.sonatype.org/service/local/staging/deploy/maven2/
+    
+  
+
+```
+{% endraw %}
+
+この設定で、リポジトリ管理の`id`を`setup-java`アクションに指定してやることで、パッケージをMaven Central Repositoryに公開するワークフローを作成できます。 リポジトリの認証のために、ユーザ名とパスワードを含む環境変数を提供する必要もあります。
+
+デプロイのステップでは、リポジトリに認証してもらうユーザ名と、認証のためのパスワードあるいはトークンで設定したシークレットを環境変数に設定する必要があります。  詳しい情報については、「[暗号化されたシークレットの作成と利用](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。
+
+
+{% raw %}
+```yaml
+name: Publish package to the Maven Central Repository
+on:
+  release:
+    types: [created]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Maven Central Repository
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+          server-id: ossrh
+          server-username: MAVEN_USERNAME
+          server-password: MAVEN_PASSWORD
+      - name: Publish package
+        run: mvn -B deploy
+        env:
+          MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
+          MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}
+```
+{% endraw %}
+
+このワークフローは以下のステップを実行します。
+
+1. プロジェクトのリポジトリのコピーをチェックアウトします。
+1. Java JDKをセットアップし、環境変数の`MAVEN_USERNAME`と`MAVEN_PASSWORD`を使って`ossrh`リポジトリに対する認証を追加するためにMavenの_settings.xml_ファイルも設定します。
+1. {% data reusables.github-actions.publish-to-maven-workflow-step %}
+
+   ワークフロー中でのシークレットの利用に関する詳しい情報については「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。
+
+### {% data variables.product.prodname_registry %}へのパッケージの公開
+
+新しいリリースを作成するたびに、パッケージを公開するワークフローを起動できます。 以下の例でのワークフローは、`created`という種類で`release`イベントが発生したときに実行されます。 このワークフローは、CIテストをパスすれば{% data variables.product.prodname_registry %}にパッケージを公開します。 `release`イベントに関する詳しい情報については「[ワークフローを起動するイベント](/actions/reference/events-that-trigger-workflows#release)」を参照してください。
+
+このワークフロー内では、`setup-java`アクションを利用できます。 このアクションは、指定されたバージョンのJDKを`PATH`にインストールし、{% data variables.product.prodname_registry %}にパッケージを公開するためにMavenの_settings.xml_もセットアップします。 生成された_settings.xml_は、環境変数の`GITHUB_ACTOR`をユーザ名、`GITHUB_TOKEN`をパスワードとして使い、`github`の`id`でサーバーの認証を定義します。
+
+`GITHUB_TOKEN`は、デフォルトでリポジトリ中に存在し、ワークフローが実行されるリポジトリ中のパッケージには読み書きの権限があります。 詳しい情報については「[GITHUB_TOKENでの認証](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)」を参照してください。
+
+Mavenベースのプロジェクトでは、{% data variables.product.prodname_registry %}のエンドポイントを指す`github`の`id`で_pom.xml_ファイル中に配布リポジトリを作成することによって、これらの設定を利用できます。
+
+たとえば、Organizationの名前が"octocat"でリポジトリの名前が"hello-world"なら、_pom.xml_中の{% data variables.product.prodname_registry %}の設定は以下の例のようになるでしょう。
+
+{% raw %}
+```xml
+
+  ...
+  
+    
+      github
+      GitHub Packages
+      https://maven.pkg.github.com/octocat/hello-world
+    
+  
+
+```
+{% endraw %}
+
+この設定で、自動的に生成された_settings.xml_を利用して{% data variables.product.prodname_registry %}にパッケージを公開するワークフローを作成できます。
+
+{% raw %}
+```yaml
+name: Publish package to GitHub Packages
+on:
+  release:
+    types: [created]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Publish package
+        run: mvn -B deploy
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
+
+このワークフローは以下のステップを実行します。
+
+1. プロジェクトのリポジトリのコピーをチェックアウトします。
+1. Java JDKをセットアップし、自動的にMavenの_settings.xml_ファイルを設定して環境変数の`GITHUB_TOKEN`を使うように`github` Mavenリポジトリの認証を追加します。
+1. {% data reusables.github-actions.publish-to-packages-workflow-step %}
+
+   ワークフロー中でのシークレットの利用に関する詳しい情報については「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。
+
+### Maven Central Repositoryと{% data variables.product.prodname_registry %}へのパッケージの公開
+
+`setup-java`アクションをそれぞれのレジストリに対して利用すれば、Maven Central Repositoryと{% data variables.product.prodname_registry %}の両方にパッケージを公開できます。
+
+_pom.xml_ファイルに、{% data variables.product.prodname_dotcom %}リポジトリとMaven Central Repositoryプロバイダの双方に対する配布管理リポジトリを確実に含めてください。 たとえば、OSSRHホスティングプロジェクトを通じてCentral Repositoryへデプロイするなら、それを`id`を`ossrh`に設定して配布管理リポジトリ内で指定し、`id`を`github`に設定して配布管理リポジトリ内で{% data variables.product.prodname_registry %}を指定することになるかもしれません。
+
+{% raw %}
+```yaml
+name: Publish package to the Maven Central Repository and GitHub Packages
+on:
+  release:
+    types: [created]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Java for publishing to Maven Central Repository
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+          server-id: ossrh
+          server-username: MAVEN_USERNAME
+          server-password: MAVEN_PASSWORD
+      - name: Publish to the Maven Central Repository
+        run: mvn -B deploy
+        env:
+          MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
+          MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}
+      - name: Set up Java for publishing to GitHub Packages
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Publish to GitHub Packages
+        run: mvn -B deploy
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
+
+このワークフローは、`setup-java`アクションを2回呼びます。  実行される度に、`setup-java`アクションはMavenの_settings.xml_をパッケージの公開のために上書きします。  リポジトリの認証については、_settings.xml_ファイルは配布管理リポジトリの`id`、及びユーザ名とパスワードを参照します。
+
+このワークフローは以下のステップを実行します。
+
+1. プロジェクトのリポジトリのコピーをチェックアウトします。
+1. 1回目の`setup-java`の呼び出しを行います。 これはMavenの_settings.xml_ファイルを`ossrh`に対して設定し、認証のオプションを次のステップで定義される環境変数に設定します。
+1. {% data reusables.github-actions.publish-to-maven-workflow-step %}
+1. 2回目の`setup-java`の呼び出しを行います。 Mavenの_settings.xml_ファイルを{% data variables.product.prodname_registry %}に対して自動的に設定します。
+1. {% data reusables.github-actions.publish-to-packages-workflow-step %}
+
+   ワークフロー中でのシークレットの利用に関する詳しい情報については「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。
diff --git a/translations/ja-JP/content/actions/guides/publishing-nodejs-packages.md b/translations/ja-JP/content/actions/guides/publishing-nodejs-packages.md
new file mode 100644
index 000000000000..7bde7bd386e3
--- /dev/null
+++ b/translations/ja-JP/content/actions/guides/publishing-nodejs-packages.md
@@ -0,0 +1,210 @@
+---
+title: Node.jsパッケージの公開
+intro: 継続的インテグレーション（CI）ワークフローの一部として、Node.jsのパッケージをレジストリに公開できます。
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages
+  - /actions/language-and-framework-guides/publishing-nodejs-packages
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data variables.product.prodname_actions %} の支払いを管理する
+{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
+
+### はじめに
+
+本ガイドでは、継続的インテグレーション（CI）テストにパスした後、Node.jsのパッケージを{% data variables.product.prodname_registry %}及びnpmレジストリに公開するワークフローの作成方法を紹介します。 1つのワークフローで、パッケージを1つのレジストリや複数のレジストリに公開できます。
+
+### 必要な環境
+
+ワークフローの設定オプションと、ワークフローファイルの作成方法についての基本的な知識を持っておくことをおすすめします。 詳しい情報については、「[{% data variables.product.prodname_actions %} を学ぶ](/actions/learn-github-actions)」を参照してください。
+
+Node.jsプロジェクトのためのCIワークフローの作成に関する詳しい情報については「[{% data variables.product.prodname_actions %}でのNode.jsの利用](/actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions)」を参照してください。
+
+また、以下の基本的な理解があれば役立ちます。
+
+- [{% data variables.product.prodname_registry %} で利用するために npm を設定する](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)
+- 「[環境変数](/actions/reference/environment-variables)」
+- 「[暗号化されたシークレット](/actions/reference/encrypted-secrets)」
+- 「[ワークフローでの認証](/actions/reference/authentication-in-a-workflow)」
+
+### パッケージの設定について
+
+ *package.json*ファイル中の`name`及び`version`フィールドは、レジストリがパッケージをレジストリにリンクするために利用するユニークな識別子を作成します。 *package.json*ファイル中に`description`を含めることによって、パッケージのリストページのためのまとめを追加できます。 詳しい情報については、npmのドキュメンテーション中の「[package.jsonファイルの作成](https://docs.npmjs.com/creating-a-package-json-file)」及び「[Node.jsモジュールの作成](https://docs.npmjs.com/creating-node-js-modules)」を参照してください。
+
+ローカルの*.npmrc*ファイルがあり、`registry`の値が指定されている場合、`npm publish`コマンドは*.npmrc*ファイルで設定されたレジストリを使います。 {% data reusables.github-actions.setup-node-intro %}
+
+`setup-node`アクションを使えば、ランナーにインストールされたNode.jsのバージョンを指定できます。
+
+*package.json*ファイルに`publishConfig`フィールドを設定するステップをワークフローに追加したなら、`setup-node`アクションを使ってregistry-urlを指定する必要はありませんが、パッケージを公開するレジストリは1つだけに限られます。 詳しい情報についてはnpmドキュメンテーションの「[Configの公開](https://docs.npmjs.com/files/package.json#publishconfig)」を参照してください。
+
+### npmレジストリへのパッケージの公開
+
+新しいリリースを作成するたびに、パッケージを公開するワークフローを起動できます。 以下の例でのワークフローは、`created`という種類で`release`イベントが発生したときに実行されます。 このワークフローは、CIテストをパスすればnpmレジストリにパッケージを公開します。
+
+ワークフロー中でnpmレジストリに対して認証を受けた操作を行うためには、npmの認証トークンをリポジトリの設定中にシークレットとして保存しなければなりません。 たとえば`NPM_TOKEN`というシークレットを生成してください。 詳しい情報については、「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。
+
+デフォルトでは、npmは*package.json*ファイルの`name`フィールドを使ってnpmレジストリを決めます。 グローバルな名前空間に公開する場合は、パッケージ名だけを含める必要があります。 たとえば`https://www.npmjs.com/package/npm-hello-world-test`に`npm-hello-world-test`という名前のパッケージを公開できます。
+
+スコープのプレフィックスを含むパッケージを公開するなら、そのスコープを*package.json*ファイルの名前に含めてください。 たとえばnpmのスコーププレフィックスがoctocatであり、パッケージ名がhello-worldなら、*package.json*ファイル中の`name`は`@octocat/hello-world`とすべきです。 npmパッケージがスコーププレフィックスを使っており、パブリックであるなら、`npm publish --access public`オプションを使う必要があります。 これは、意図せずプライベートパッケージを公開してしまうことを防ぐためにnpmが必要とするオプションです。
+
+以下の例は、`NPM_TOKEN`シークレットを環境変数の`NODE_AUTH_TOKEN`に保存します。 `setup-node`アクションが*.npmrc*ファイルを作成する際には、環境変数の`NODE_AUTH_TOKEN`からトークンを参照します。
+
+{% raw %}
+```yaml
+name: Node.js Package
+on:
+  release:
+    types: [created]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    # npmへの公開のための.npmrcファイルのセットアップ
+    - uses: actions/setup-node@v1
+      with:
+        node-version: '12.x'
+        registry-url: 'https://registry.npmjs.org'
+    - run: npm install
+    - run: npm publish
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+```
+{% endraw %}
+
+上の例では、`setup-node`アクションは以下の内容でランナー上に*.npmrc*ファイルを作成します。
+
+```
+//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN}
+registry=https://registry.npmjs.org/
+always-auth=true
+```
+
+### {% data variables.product.prodname_registry %}へのパッケージの公開
+
+新しいリリースを作成するたびに、パッケージを公開するワークフローを起動できます。 以下の例でのワークフローは、`created`という種類で`release`イベントが発生したときに実行されます。 このワークフローは、CIテストをパスすれば{% data variables.product.prodname_registry %}にパッケージを公開します。
+
+デフォルトでは、{% data variables.product.prodname_registry %}は*package.json*ファイルの`name`フィールドで指定された{% data variables.product.prodname_dotcom %}のリポジトリにパッケージを公開します。 たとえば`@my-org/test`という名前のパッケージを{% data variables.product.prodname_dotcom %}リポジトリの`my-org/test`に公開します。 詳しい情報については、npmドキュメンテーション中の[`npm-scope`](https://docs.npmjs.com/misc/scope)を参照してください。
+
+ワークフロー中で{% data variables.product.prodname_registry %}レジストリに対して認証を受けた操作をするには、`GITHUB_TOKEN`が使えます。 `GITHUB_TOKEN`は、デフォルトでリポジトリ中に存在し、ワークフローが実行されるリポジトリ中のパッケージには読み書きの権限があります。 詳しい情報については、「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。
+
+以下の例は、`GITHUB_TOKEN`シークレットを環境変数の`NODE_AUTH_TOKEN`に保存します。 `setup-node`アクションが*.npmrc*ファイルを作成する際には、環境変数の`NODE_AUTH_TOKEN`からトークンを参照します。
+
+{% raw %}
+```yaml
+name: Node.js Package
+on:
+  release:
+    types: [created]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    # GitHub パッケージに公開する .npmrc ファイルを設定する
+    - uses: actions/setup-node@v1
+      with:
+        node-version: '12.x'
+        registry-url: 'https://npm.pkg.github.com'
+        # デフォルトはワークフローファイルを所有するユーザまたは Organization
+        scope: '@octocat'
+    - run: npm install
+    - run: npm publish
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
+
+`setup-node`アクションは、ランナー上で*.npmrc*ファイルを作成します。 `setup-node`アクションで`scope`インプットを使うと、*.npmrc*ファイルにはスコーププレフィックスが含まれます。 デフォルトでは、`setup-node`アクションは*.npmrc*ファイルのスコープを、ワークフローファイルを含むアカウントに設定します。
+
+```
+//npm.pkg.github.com/:_authToken=${NODE_AUTH_TOKEN}
+@octocat:registry=https://npm.pkg.github.com
+always-auth=true
+```
+
+### yarnを利用したパッケージの公開
+
+パッケージマネージャーのYarnを使う場合、Yarnを使ってパッケージのインストールと公開が行えます。
+
+{% raw %}
+```yaml
+name: Node.js Package
+on:
+  release:
+    types: [created]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    # npm に公開する .npmrc ファイルを設定する
+    - uses: actions/setup-node@v1
+      with:
+        node-version: '12.x'
+        registry-url: 'https://registry.npmjs.org'
+        # デフォルトはワークフローファイルを所有するユーザまたは Organization
+        scope: '@octocat' 
+    - run: yarn
+    - run: yarn publish
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+```
+{% endraw %}
+
+### npmと{% data variables.product.prodname_registry %}へのパッケージの公開
+
+{% note %}
+
+**ノート：** 異なるスコーププレフィックスを持つレジストリへ公開する必要がある倍は、ランナー上の*package.json*ファイルを修正してスコーププレフィックスを変更しなければなりません。 たとえばnpmに対しては`@mona`スコープで、{% data variables.product.prodname_registry %}に対しては`@octocat`スコープでパッケージを公開する場合は、npmへの公開後、{% data variables.product.prodname_registry %}への公開前にランナー上の*package.json*ファイルの`@mona`スコープを`@octocat`で置き換えることができます。
+
+{% endnote %}
+
+`setup-node`アクションをそれぞれのレジストリに対して利用すれば、npmレジストリと{% data variables.product.prodname_registry %}の両方にパッケージを公開できます。
+
+両方のレジストリにパッケージを公開するなら、npm上のスコーププレフィックスが{% data variables.product.prodname_dotcom %}のユーザ名もしくはOrganization名と一致することを確認する必要があります。 パッケージをスコーププレフィックス付きでパブリックなレジストリに公開するには、`npm publish --access public`コマンドが使えます。 詳しい情報については、npmドキュメンテーション中の[`npm-scope`](https://docs.npmjs.com/misc/scope)及び「[スコープ付きのパブリックパッケージの作成と公開](https://docs.npmjs.com/creating-and-publishing-scoped-public-packages)」を参照してください。
+
+*package.json*ファイルに{% data variables.product.prodname_dotcom %}レジストリとnpmレジストリのスコープが含まれていることを確かめてください。 たとえば、`octocat/npm-hello-world-test`リポジトリ内のパッケージを{% data variables.product.prodname_dotcom %}及びhttps://www.npmjs.com/package/@octocat/npm-hello-world-testに公開する計画をしているなら、*package.json*ファイル内の名前は`"name": "@octocat/npm-hello-world-test"`となるでしょう。
+
+ワークフロー中で{% data variables.product.prodname_registry %}レジストリに対して認証を受けた操作をするには、`GITHUB_TOKEN`が使えます。 `GITHUB_TOKEN`は、デフォルトでリポジトリ中に存在し、ワークフローが実行されるリポジトリ中のパッケージには読み書きの権限があります。 詳しい情報については、「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。
+
+`setup-node`アクションで`scope`インプットを使うと、このアクションはスコーププレフィックスを含む*.npmrc*ファイルを作成します。 デフォルトでは、`setup-node`アクションは*.npmrc*ファイル中のスコープを、ワークフローファイルを所有するユーザもしくはOrganizationに設定します。
+
+このワークフローは、`setup-node`アクションを2回呼びます。 `setup-node`アクションは、実行されるたびに*.npmrc*ファイルを上書きします。 *.npmrc*ファイルは、パッケージレジストリに対する認証を受けた操作を行えるようにしてくれるトークンを、環境変数の`NODE_AUTH_TOKEN`から参照します。 このワークフローは、環境変数の`NODE_AUTH_TOKEN`を`npm publish`コマンドが実行されるたびに設定します。初回はnpmへの公開のためのトークン（`NPM_TOKEN`）が、続いて{% data variables.product.prodname_registry %}への公開のためのトークン（`GITHUB_TOKEN`）が使われます。
+
+{% raw %}
+```yaml
+name: Node.js Package
+on:
+  release:
+    types: [created]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    # npmに公開する.npmrcファイルを設定する
+    - uses: actions/setup-node@v1
+      with:
+        node-version: '10.x'
+        registry-url: 'https://registry.npmjs.org'
+    - run: npm install
+    # npmに公開する
+    - run: npm publish --access public
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+    # GitHub パッケージに公開する .npmrc ファイルを設定する
+    - uses: actions/setup-node@v1
+      with:
+        registry-url: 'https://npm.pkg.github.com'
+        # デフォルトはワークフローファイルを所有するユーザまたは Organization
+        scope: '@octocat'
+    # GitHub パッケージに公開する
+    - run: npm publish
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
diff --git a/translations/ja-JP/content/actions/guides/setting-up-continuous-integration-using-workflow-templates.md b/translations/ja-JP/content/actions/guides/setting-up-continuous-integration-using-workflow-templates.md
new file mode 100644
index 000000000000..9bf8f04fcda0
--- /dev/null
+++ b/translations/ja-JP/content/actions/guides/setting-up-continuous-integration-using-workflow-templates.md
@@ -0,0 +1,43 @@
+---
+title: ワークフローテンプレートを使用して継続的インテグレーションを設定する
+shortTitle: テンプレートを使用した CI の設定
+intro: 使用したい言語とツールに一致するワークフローテンプレートを使用して、プロジェクトに継続的インテグレーションを設定することができます。
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /articles/setting-up-continuous-integration-using-github-actions
+  - /github/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions
+  - /actions/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions
+  - /actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data variables.product.prodname_actions %} の支払いを管理する
+{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
+
+リポジトリへの書き込み権限があるユーザなら誰でも {% data variables.product.prodname_actions %} を使用して継続的インテグレーション (CI) を設定することができます。
+
+CIを設定すると、必要に応じてワークフローをカスタマイズすることができます。
+
+{% data reusables.repositories.navigate-to-repo %}
+{% data reusables.repositories.actions-tab %}
+1. 使用したい言語とツールに一致するテンプレートを探し、[**Set up this workflow**] をクリックします。 ![[Setup workflow] ボタン](/assets/images/help/repository/setup-workflow-button.png)
+5. [**Start commit**] をクリックします。 ![[Start commit]ボタン](/assets/images/help/repository/start-commit.png)
+{% data reusables.files.write_commit_message %}
+{% data reusables.files.choose_commit_branch %}
+{% data reusables.files.propose_new_file %}
+
+リポジトリへのプッシュを実行すると、{% data variables.product.prodname_dotcom %}で実行された継続的インテグレーションワークフローのステータスと詳細ログを追跡し、カスタマイズした通知を受け取ることができます。 詳しい情報については、「[通知を設定する](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)」及び「[ワークフローの実行の管理](/articles/managing-a-workflow-run)」を参照してください。
+
+{% data reusables.repositories.actions-workflow-status-badge-into %}
+
+詳しい情報については、「[{% data variables.product.prodname_actions %} を学ぶ](/actions/learn-github-actions)」を参照してください。
+
+### 参考リンク
+
+- [継続的インテグレーションについて](/articles/about-continuous-integration)
+- "[ワークフロー実行の管理](/articles/managing-a-workflow-run)"
+{% if currentVersion == "free-pro-team@latest" %}
+- 「[{% data variables.product.prodname_actions %} の支払いを管理する](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)」
+{% endif %}
diff --git a/translations/ja-JP/content/actions/guides/storing-workflow-data-as-artifacts.md b/translations/ja-JP/content/actions/guides/storing-workflow-data-as-artifacts.md
new file mode 100644
index 000000000000..39a95d745ad8
--- /dev/null
+++ b/translations/ja-JP/content/actions/guides/storing-workflow-data-as-artifacts.md
@@ -0,0 +1,248 @@
+---
+title: ワークフロー データをアーティファクトとして保存する
+shortTitle: ワークフロー アーティファクトを保存する
+intro: アーティファクトを使うと、ワークフローが完了したときに、そのワークフローのジョブとストアデータの間でデータを共有することができます。
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /articles/persisting-workflow-data-using-artifacts
+  - /github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts
+  - /actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts
+  - /actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data variables.product.prodname_actions %} の支払いを管理する
+{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
+
+### ワークフローの成果物について
+
+成果物を使えば、ジョブの完了後にデータを永続化でき、そのデータを同じワークフロー中の他のジョブと共有できます。 アーティファクトとは、ワークフロー実行中に生成されるファイル、またはファイルのコレクションです。 たとえば、成果物を使ってワークフローの実行が終了した後、ビルドとテストの出力を保存しておけます。
+
+{% data reusables.github-actions.artifact-log-retention-statement %} プルリクエストの保持期間は、ユーザが新しいコミットをプルリクエストにプッシュするたびに再開されます。
+
+以下は、アップロードできる一般的な成果物の一部です。
+
+- ログファイルとコアダンプ
+- テスト結果、エラー、スクリーンショット
+- バイナリあるいは圧縮されたファイル
+- ストレステストのパフォーマンス出力およびコード網羅率の結果
+
+{% if currentVersion == "free-pro-team@latest" %}
+
+成果物の保存には、{% data variables.product.product_name %}上のストレージ領域が使われます。 {% data reusables.github-actions.actions-billing %} 詳細は「[{% data variables.product.prodname_actions %} の支払いの管理](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)」を参照してください。
+
+{% else %}
+
+アーティファクトは、{% data variables.product.product_location %} 上の {% data variables.product.prodname_actions %} 向けに設定された外部 blob ストレージ上のストレージスペースを消費します。
+
+{% endif %}
+
+成果物はワークフローの実行中にアップロードされ、成果物の名前とサイズはUIで見ることができます。 {% data variables.product.product_name %}のUIを使って成果物がダウンロードされる場合、成果物の一部として個別にアップロードされたすべてのファイルはzipして1つのファイルにまとめられます。 これはすなわち、支払いはこのzipファイルのサイズではなく、アップロードされた成果物のサイズを元に計算されるということです。
+
+{% data variables.product.product_name %}には、ビルドアーティファクトのアップロードとダウンロードに使用できるアクションが2つあります。 詳しい情報については、 {% data variables.product.product_location %} 上の {% if currentVersion == "free-pro-team@latest" %}[actions/upload-artifact](https://github.com/actions/upload-artifact) および [download-artifact](https://github.com/actions/download-artifact) アクション{% else %} `actions/upload-artifact` および `download-artifact` アクション{% endif %}を参照してください。
+
+ジョブ間でデータを共有するには:
+
+* **ファイルをアップロード**: アップロードされたファイルに名前を付けて、ジョブが終了する前にデータをアップロードしてください。
+* **ファイルをダウンロード**: 成果物は、同じワークフローの実行中にアップロードされたものだけがダウンロードできます。 ファイルをダウンロードする際には、名前で参照できます。
+
+ジョブのステップは、ランナーマシン上で同じ環境を共有しますが、それぞれが個別のプロセス内で実行されます。 ジョブのステップ間のデータを受け渡すには、入力と出力を使用できます。 入力と出力の詳細については、「[{% data variables.product.prodname_actions %}構文のメタデータ](/articles/metadata-syntax-for-github-actions)」を参照してください。
+
+### ビルドおよびテストの成果物をアップロードする
+
+継続的インテグレーション（CI）ワークフローを作成して、コードのビルドやテストを行えます。 {% data variables.product.prodname_actions %} を使用して CI を実行する方法の詳細については、「[継続的インテグレーションについて](/articles/about-continuous-integration)」を参照してください。
+
+コードのビルドおよびテストを出力すると多くの場合、エラーのデバッグに使用できるファイルと、デプロイできる本番コードが生成されます。 リポジトリにプッシュされるコードをビルドしてテストし、成功または失敗のステータスをレポートするワークフローを構成することができます。 デプロイメントに使用するビルドおよびテスト出力をアップロードし、失敗したテストまたはクラッシュをデバッグしてテストスイートの範囲を確認できます。
+
+成果物をアップロードするには、`upload-artifact`アクションが使用できます。 成果物をアップロードする場合は、単一のファイルまたはディレクトリー、または複数のファイルまたはディレクトリーを指定できます。 また、特定のファイルやディレクトリを除外したり、ワイルドカードパターンを使用したりすることもできます。 アーティファクトの名前を指定することをお勧めしますが、名前を指定しない場合は、 `アーティファクト` が既定の名前として使用されます。 構文の詳細については、 {% data variables.product.product_location %} 上の {% if currentVersion == "free-pro-team@latest" %}[actions/upload-artifact](https://github.com/actions/upload-artifact) アクション{% else %} `actions/upload-artifact` アクション{% endif %}を参照してください。
+
+#### サンプル
+
+たとえば、リポジトリあるいはWebアプリケーションにはCSSやJavaScriptに変換しなければならないSASSやTypeScriptが含まれているかもしれません。 ビルド構成が`dist`ディレクトリにコンパイル後のファイルを出力すると仮定すると、テストがすべて正常に完了した場合、`dist`ディレクトリにあるファイルがWebアプリケーションにデプロイされます。
+
+```
+|-- hello-world (repository)
+|   └── dist
+|   └── tests
+|   └── src
+|       └── sass/app.scss
+|       └── app.ts
+|   └── output
+|       └── test
+|   
+```
+
+この例では、`src`ディレクトリにコードを`builds`して、`tests`ディレクトリでテストを実行するNode.jsプロジェクトのワークフローを作成しています。 実行中の`npm test`が、`code-coverage.html`という名前で、`output/test/`ディレクトリに保存されるコード網羅率レポートを生成すると想定できます。
+
+ワークフローは、 `dist` ディレクトリにプロダクション アーティファクトをアップロードしますが、マークダウン ファイルは除きます。 また、 `の code-coverage.html` レポートを別のアーティファクトとしてアップロードします。
+
+```yaml
+名前: ノード CI
+
+: [push]
+
+ジョブ:
+  build_and_test:
+    実行: ubuntu-最新
+    ステップ:
+      - 名前: チェックアウト リポジトリ
+        使用: アクション/checkout@v2
+      - 名前: npm インストール、ビルド、テスト
+        実行: |
+          npm のインストール
+          npm 実行ビルド --if-present
+          npm テスト
+      - 名前: アーカイブ制作アーティファクト
+        使用: アクション/アップロードartifact@v2
+        :
+          名: dist-マークダウンなし
+          パス: |
+            dist
+            !dist/**/*.md
+      - 名前: アーカイブ コード カバレッジ結果
+        使用: アクション/アップロードartifact@v2
+        と共に:
+          名: コード カバレッジ レポート
+          パス: output/test/code-coverage.html
+```
+
+![ワークフローアップロード成果物ワークフロー実行の画像](/assets/images/help/repository/upload-build-test-artifact.png)
+
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+### カスタムアーティファクトの保持期間を設定する
+
+ワークフローによって作成された個々のアーティファクトのカスタム保存期間を定義できます。 ワークフローを使用して新しいアーティファクトを作成する場合、`upload-artifact` アクションで `retention-days` を使用できます。 この例は、`my-artifact` という名前のアーティファクトに 5 日間のカスタム保存期間を設定する方法を示しています。
+
+```
+  - name: 'Upload Artifact'
+    uses: actions/upload-artifact@v2
+    with:
+      name: my-artifact
+      path: my_file.txt
+      retention-days: 5
+```
+
+`retention-days` の値は、リポジトリ、Organization、または Enterprise によって設定された保持制限を超えることはできません。
+{% endif %}
+
+### 成果物のダウンロードあるいは削除
+
+ワークフローの実行中に、[`download-artifactaction`](https://github.com/actions/download-artifact) を使用して、同じワークフローの実行で以前にアップロードされたアーティファクトをダウンロードできます。
+
+ワークフローの実行が完了したら、{% data variables.product.prodname_dotcom %} または REST API を使用してアーティファクトをダウンロードまたは削除できます。 詳しい情報については、「[ワークフローアーティファクトをダウンロードする](/actions/managing-workflow-runs/downloading-workflow-artifacts)」、「[ワークフローアーティファクトを削除する](/actions/managing-workflow-runs/removing-workflow-artifacts)」、および「[アーティファクト REST API](/v3/actions/artifacts/)」を参照してください。
+
+#### ワークフロー実行中の成果物のダウンロード
+
+[`actions/download-artifact`](https://github.com/actions/download-artifact) のダウンロードアクションを使用して、ワークフローの実行中に以前にアップロードされたアーティファクトをダウンロードできます。
+
+{% note %}
+
+**注意:** 同じワークフロー実行中にアップロードされたワークフロー内のアーティファクトのみをダウンロードできます。
+
+{% endnote %}
+
+個々の成果物をダウンロードする成果物の名前を指定します。 名前を指定せずにアーティファクトをアップロードした場合、デフォルト名はアーティファクト        `されます。
        
+
+
        - 名前: 使用
+  単一のアーティファクトをダウンロード: アクション/ダウンロードartifact@v2
+  と共に:
+    名: my-artifact
+`
        
+
+また、名前を指定しないことで、ワークフロー実行のすべての成果物をダウンロードすることもできます。 これは、多数のアーティファクトを扱っている場合に便利です。
+
+```yaml
+- 名前: 使用
+  すべてのワークフロー実行アーティファクトをダウンロード: アクション/ダウンロードartifact@v2
+```
+
+ワークフロー実行のすべての成果物をダウンロードすると、各成果物のディレクトリーがその名前を使用して作成されます。
+
+構文の詳細については、{% data variables.product.product_location %} 上の {% if currentVersion == "free-pro-team@latest" %}[actions/upload-artifact](https://github.com/actions/download-artifact) アクション{% else %} `actions/upload-artifact` アクション{% endif %}を参照してください。
+
+### ワークフローのジョブ間でデータを受け渡す
+
+`upload-artifact`アクションと`download-artifact`アクションを使うと、ワークフローのジョブ間でデータを共有できます。 以下のワークフローの例では、同じワークフローのジョブ間でデータを受け渡す方法を説明しています。 詳しい情報については、 {% data variables.product.product_location %} 上の {% if currentVersion == "free-pro-team@latest" %}[actions/upload-artifact](https://github.com/actions/upload-artifact) および [download-artifact](https://github.com/actions/download-artifact) アクション{% else %} `actions/upload-artifact` および `download-artifact` アクション{% endif %}を参照してください。
+
+前のジョブのアーティファクトに依存するジョブは、前のジョブが正常に完了するまで待つ必要があります。 このワークフローは、`needs`キーワードを使用して`job_1`、`job_2`、`job_3`を順次実行することができます。 たとえば、`job_2`には`needs: job_1`構文を使用する`job_1`が必要です。
+
+ジョブ1は、以下のステップを実行します。
+- 数式の計算を実行し、その結果を`math-homework.txt`というテキストファイルに保存します。
+- `upload-artifact`アクションを使って、`math-homework.txt`ファイルを`homework`という名前でアップロードします。 このアクションで、ファイルが`homework`という名前のディレクトリに配置されます。
+
+ジョブ2は、前のジョブの結果を利用して、次の処理を実行します。
+- 前のジョブでアップロードされた`homework`成果物をダウンロードします。 デフォルトでは、`download-artifact`アクションは、ステップが実行されているワークスペースディレクトリに成果物をダウンロードします。 入力パラメータの`path`を使って、別のダウンロードディレクトリを指定することもできます。
+- `homework/math-homework.txt`ファイル中の値を読み取り、数式の計算を実行し、結果を`math-homework.txt`に保存します。
+- `math-homework.txt`ファイルをアップロードします。 このアップロードは、前のアップロードを上書きします。どちらも同じ名前を使っているからです。
+
+ジョブ3は、前のジョブでアップロードされた結果を表示して、次の処理を実行します。
+- `homework`成果物をダウンロードします。
+- 数式の結果をログに出力します。
+
+このワークフロー例で実行される完全な数式は、`(3 + 7) x 9 = 90`です。
+
+```yaml
+名前:
+
+ジョブ間でデータを共有: [push]
+
+ジョブ:
+  job_1:
+    名: 3 と 7
+    実行を追加: ubuntu 最新
+    ステップ:
+      - シェル: バッシュ
+        実行: |
+          expr 3 + 7 > math-homework.txt
+      - 名前: ジョブ1の数学の結果をアップロード
+        使用: アクション/アップロードartifact@v2
+        使用:
+          名: 宿題
+          パス: math-homework.txt
+
+  job_2:
+    名: job_1
+    の
+    ニーズ: job_1 実行: windows-最新
+    ステップ:
+      - 名前: ジョブ1
+        の数学結果をダウンロード使用: アクション/ダウンロードartifact@v2
+
+        
+      
+          :
+          値='cat math-homework.txt'
+          は、数学-homework.txt
+      $value 9 > - 名前:ジョブ2
+        の数学の結果をアップロード使用:アクション/アップロードartifact@v2
+        :
+          名:宿題
+          パス:数学-宿題.txt
+
+  job_3:
+    名 結果
+    表示:のニーズを表示する:job_2
+    実行:macOS最新
+    ステップ:
+      - 名前:ジョブ2の数学の結果をダウンロード
+        使用:アクション/ダウンロードartifact@v2
+        :
+          名:宿題
+      - 名前:シェル
+        最終結果を印刷する:バッシュ
+        実行: |
+          値='cat数学宿題.txt'
+          エコー 結果は $value
+```
+
+![ジョブ間でデータを受け渡して数学を実行するワークフロー](/assets/images/help/repository/passing-data-between-jobs-in-a-workflow.png)
+
+{% if currentVersion == "free-pro-team@latest" %}
+
+### 参考リンク
+
+- /github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions
+
+{% endif %}
diff --git a/translations/ja-JP/content/actions/hosting-your-own-runners/about-self-hosted-runners.md b/translations/ja-JP/content/actions/hosting-your-own-runners/about-self-hosted-runners.md
index 852a09280bc1..cbae31fa8bb4 100644
--- a/translations/ja-JP/content/actions/hosting-your-own-runners/about-self-hosted-runners.md
+++ b/translations/ja-JP/content/actions/hosting-your-own-runners/about-self-hosted-runners.md
@@ -9,7 +9,7 @@ versions:
   enterprise-server: '>=2.22'
 ---
 
-{% data reusables.actions.enterprise-beta %}
+{% data variables.product.prodname_actions %} の支払いを管理する
 {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
 
 ### 自己ホストランナーについて
@@ -53,6 +53,15 @@ versions:
 * そのマシンが、実行しようとしている種類のワークフローに対して十分なハードウェアリソースを持っていること。 セルフホストランナーアプリケーションそのものは、最小限のリソースしか必要としません。
 * Dockerコンテナアクションあるいはサービスコンテナを使うワークフローを実行したいなら、Linuxのマシンを使い、Dockerがインストールされていなければなりません。
 
+### 使用制限
+
+セルフホストランナーを使用する場合、{% data variables.product.prodname_actions %} の使用にはいくつかの制限があります。 これらの制限は変更されることがあります。
+
+{% data reusables.github-actions.usage-workflow-run-time %}
+- **ジョブキュー時間** - セルフホストランナーの各ジョブは、最大24時間キューイングできます。 この制限内にセルフホストランナーがジョブの実行を開始しなければ、ジョブは終了させられ、完了に失敗します。
+{% data reusables.github-actions.usage-api-requests %}
+- **ジョブマトリックス** - {% data reusables.github-actions.usage-matrix-limits %}
+
 ### セルフホストランナーをサポートするオペレーティングシステム
 
 セルフホストランナーアプリケーション用には、以下のオペレーティングシステムがサポートされています。
diff --git a/translations/ja-JP/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md b/translations/ja-JP/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md
index 72289dcc427c..d5dd92e58036 100644
--- a/translations/ja-JP/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md
+++ b/translations/ja-JP/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md
@@ -1,6 +1,6 @@
 ---
 title: 自己ホストランナーの追加
-intro: '{% data variables.product.prodname_actions %}にセルフホストランナーを追加できます。'
+intro: '{{ site.data.variables.product.prodname_actions }}にセルフホストランナーを追加できます。'
 redirect_from:
   - /github/automating-your-workflow-with-github-actions/adding-self-hosted-runners
   - /actions/automating-your-workflow-with-github-actions/adding-self-hosted-runners
@@ -9,7 +9,7 @@ versions:
   enterprise-server: '>=2.22'
 ---
 
-{% data reusables.actions.enterprise-beta %}
+{% data variables.product.prodname_actions %} の支払いを管理する
 {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
 
 セルフホストランナーでサポートされているオペレーティングシステム、あるいはプロキシサーバーとセルフホストランナーを使う方法に関する情報については、「[セルフホストランナーについて](/github/automating-your-workflow-with-github-actions/about-self-hosted-runners)」を参照してください。
@@ -51,7 +51,8 @@ versions:
 {% if currentVersion == "free-pro-team@latest" %}
 セルフホストランナーを Enterprise アカウントに追加するには、Enterprise のオーナーである必要があります。
 {% else if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21"%}
-Enterprise レベルの {% data variables.product.product_location %} でセルフホストランナーを追加するには、サイト管理者である必要があります。
+セルフホストランナーを
+{% data variables.product.product_location %} の Enterprise レベルでを追加するには、サイト管理者である必要があります。
 {% endif %}
 
 {% if currentVersion == "free-pro-team@latest" %}
diff --git a/translations/ja-JP/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md b/translations/ja-JP/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md
index 9281dabf1d92..b88dc4a3be93 100644
--- a/translations/ja-JP/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md
+++ b/translations/ja-JP/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md
@@ -8,7 +8,7 @@ versions:
   enterprise-server: '>=2.22'
 ---
 
-{% data reusables.actions.enterprise-beta %}
+{% data variables.product.prodname_actions %} の支払いを管理する
 {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
 
 {% capture service_first_step %}1. セルフホストランナー アプリケーションが現在実行中の場合は、そのアプリケーションを停止します。{% endcapture %}
diff --git a/translations/ja-JP/content/actions/hosting-your-own-runners/index.md b/translations/ja-JP/content/actions/hosting-your-own-runners/index.md
index 2b2e4d75f3cc..8bbdc36e457f 100644
--- a/translations/ja-JP/content/actions/hosting-your-own-runners/index.md
+++ b/translations/ja-JP/content/actions/hosting-your-own-runners/index.md
@@ -9,7 +9,7 @@ versions:
   enterprise-server: '>=2.22'
 ---
 
-{% data reusables.actions.enterprise-beta %}
+{% data variables.product.prodname_actions %} の支払いを管理する
 {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
 
 {% link_in_list /about-self-hosted-runners %}
diff --git a/translations/ja-JP/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups.md b/translations/ja-JP/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups.md
index a5cbbb7fec1d..e971f16f2162 100644
--- a/translations/ja-JP/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups.md
+++ b/translations/ja-JP/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups.md
@@ -8,7 +8,7 @@ versions:
   enterprise-server: '>=2.22'
 ---
 
-{% data reusables.actions.enterprise-beta %}
+{% data variables.product.prodname_actions %} の支払いを管理する
 {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
 
 ### セルフホストランナーのグループについて
diff --git a/translations/ja-JP/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md b/translations/ja-JP/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md
index 92728e22a3c7..803035358746 100644
--- a/translations/ja-JP/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md
+++ b/translations/ja-JP/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md
@@ -10,10 +10,10 @@ versions:
   enterprise-server: '>=2.22'
 ---
 
-{% data reusables.actions.enterprise-beta %}
+{% data variables.product.prodname_actions %} の支払いを管理する
 {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
 
-### {% data variables.product.prodname_dotcom %}を使ったセルフホストランナーのステータスのチェック
+### {{ site.data.variables.product.prodname_dotcom }}を使ったセルフホストランナーのステータスのチェック
 
 {% data reusables.github-actions.self-hosted-runner-management-permissions-required %}
 
diff --git a/translations/ja-JP/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md b/translations/ja-JP/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md
index b2330ee975c1..8f1f09c03ec6 100644
--- a/translations/ja-JP/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md
+++ b/translations/ja-JP/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md
@@ -1,6 +1,6 @@
 ---
 title: セルフホストランナーの削除
-intro: 'セルフホストランナーを、{% data variables.product.prodname_actions %}から恒久的に削除できます。'
+intro: 'セルフホストランナーを、{{ site.data.variables.product.prodname_actions }}から恒久的に削除できます。'
 redirect_from:
   - /github/automating-your-workflow-with-github-actions/removing-self-hosted-runners
   - /actions/automating-your-workflow-with-github-actions/removing-self-hosted-runners
@@ -9,7 +9,7 @@ versions:
   enterprise-server: '>=2.22'
 ---
 
-{% data reusables.actions.enterprise-beta %}
+{% data variables.product.prodname_actions %} の支払いを管理する
 {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
 
 ### リポジトリからのランナーの削除
@@ -63,7 +63,8 @@ Organizationからセルフホストランナーを削除するには、Organiza
 {% if currentVersion == "free-pro-team@latest" %}
 セルフホストランナーを Enterprise アカウントから削除するには、Enterprise のオーナーである必要があります。 セルフホストランナーのマシンへもアクセスできるようにしておくことをおすすめします。
 {% else if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21"%}
-Organizationからセルフホストランナーを削除するには、Organizationのオーナーでなければなりません。 セルフホストランナーのマシンへもアクセスできるようにしておくことをおすすめします。
+次の Enterprise レベルでセルフホストランナーを削除するには、
+{% data variables.product.product_location %} の Enterprise レベルでを追加するには、サイト管理者である必要があります。 セルフホストランナーのマシンへもアクセスできるようにしておくことをおすすめします。
 {% endif %}
 
 {% data reusables.github-actions.self-hosted-runner-reusing %}
diff --git a/translations/ja-JP/content/actions/hosting-your-own-runners/using-a-proxy-server-with-self-hosted-runners.md b/translations/ja-JP/content/actions/hosting-your-own-runners/using-a-proxy-server-with-self-hosted-runners.md
index a892ca7f7d8d..64582fcec0c4 100644
--- a/translations/ja-JP/content/actions/hosting-your-own-runners/using-a-proxy-server-with-self-hosted-runners.md
+++ b/translations/ja-JP/content/actions/hosting-your-own-runners/using-a-proxy-server-with-self-hosted-runners.md
@@ -8,7 +8,7 @@ versions:
   enterprise-server: '>=2.22'
 ---
 
-{% data reusables.actions.enterprise-beta %}
+{% data variables.product.prodname_actions %} の支払いを管理する
 {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
 
 ### 環境変数を利用したプロキシサーバーの設定
diff --git a/translations/ja-JP/content/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners.md b/translations/ja-JP/content/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners.md
index f287d78f49e4..32062b7863ac 100644
--- a/translations/ja-JP/content/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners.md
+++ b/translations/ja-JP/content/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners.md
@@ -6,7 +6,7 @@ versions:
   enterprise-server: '>=2.22'
 ---
 
-{% data reusables.actions.enterprise-beta %}
+{% data variables.product.prodname_actions %} の支払いを管理する
 {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
 
 特定の種類のセルフホストランナーにジョブをまわすためのラベルの利用方法に関する情報については、「[ワークフロー内でのセルフホストランナーの利用](/actions/hosting-your-own-runners/using-self-hosted-runners-in-a-workflow)」を参照してください。
diff --git a/translations/ja-JP/content/actions/hosting-your-own-runners/using-self-hosted-runners-in-a-workflow.md b/translations/ja-JP/content/actions/hosting-your-own-runners/using-self-hosted-runners-in-a-workflow.md
index f147ee44dacf..4ddf5ec58ea8 100644
--- a/translations/ja-JP/content/actions/hosting-your-own-runners/using-self-hosted-runners-in-a-workflow.md
+++ b/translations/ja-JP/content/actions/hosting-your-own-runners/using-self-hosted-runners-in-a-workflow.md
@@ -1,6 +1,6 @@
 ---
 title: ワークフローでのセルフホストランナーの利用
-intro: ワークフローでセルフホストランナーを使うには、ラベルを使ってジョブのためのランナーの種類を指定できます。
+intro: 'ワークフローでセルフホストランナーを使うには、ラベルを使ってジョブのためのランナーの種類を指定できます。'
 redirect_from:
   - /github/automating-your-workflow-with-github-actions/using-self-hosted-runners-in-a-workflow
   - /actions/automating-your-workflow-with-github-actions/using-self-hosted-runners-in-a-workflow
@@ -9,7 +9,7 @@ versions:
   enterprise-server: '>=2.22'
 ---
 
-{% data reusables.actions.enterprise-beta %}
+{% data variables.product.prodname_actions %} の支払いを管理する
 {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。
 
 カスタム及びデフォルトラベルの作成に関する情報については「[セルフホストランナーでのラベルの利用](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners)」を参照してください。
diff --git a/translations/ja-JP/content/actions/index.md b/translations/ja-JP/content/actions/index.md
index fca6e46b9931..07577fec2beb 100644
--- a/translations/ja-JP/content/actions/index.md
+++ b/translations/ja-JP/content/actions/index.md
@@ -33,8 +33,8 @@ versions:
 
 
 
-
        
-  
        
+
        
+  
        
     
        
       
        {% data ui.toc.getting_started %}
        
     
        
@@ -45,7 +45,7 @@ versions:
    • -
    +

    {% data ui.toc.popular_articles %}

    @@ -56,7 +56,7 @@ versions:
    -
    +

    Manage workflows

    @@ -68,22 +68,28 @@ versions:
    -
    - -
    {% octicon "bookmark" width="24" %}
    -

    Create actions

    -

    A complete guide to creating and sharing actions with the community.

    -     - -
    {% octicon "rocket" width="24" %}
    -

    Starter workflows

    -

    A collection of workflow files to help you get started with GitHub Actions.

    -     - -
    {% octicon "light-bulb" width="24" %}
    -

    GitHub Actions Marketplace

    -

    Explore community actions and supercharge your workflow.

    -     +
    +
    + +
    {% octicon "bookmark" width="24" %}
    +

    Create actions

    +

    A complete guide to creating and sharing actions with the community.

    +     +
    +
    + +
    {% octicon "rocket" width="24" %}
    +

    Starter workflows

    +

    A collection of workflow files to help you get started with GitHub Actions.

    +     +
    +
    + +
    {% octicon "light-bulb" width="24" %}
    +

    GitHub Actions Marketplace

    +

    Explore community actions and supercharge your workflow.

    +     +
    @@ -91,7 +97,7 @@ versions:

    ガイド

    -
    +

    Building and testing Node.js

    @@ -107,7 +113,7 @@ versions:
    -
    +

    Building and testing Python

    @@ -123,7 +129,7 @@ versions:
    -
    +

    Building and testing Java with Maven

    @@ -139,7 +145,7 @@ versions:
    -
    +

    Building and testing Java with Gradle

    @@ -155,7 +161,7 @@ versions:
    -
    +

    Building and testing Java with Ant

    @@ -171,7 +177,7 @@ versions:
    -
    +

    Publishing Node.js packages

    diff --git a/translations/ja-JP/content/actions/learn-github-actions/essential-features-of-github-actions.md b/translations/ja-JP/content/actions/learn-github-actions/essential-features-of-github-actions.md new file mode 100644 index 000000000000..8c3b1ce73cb6 --- /dev/null +++ b/translations/ja-JP/content/actions/learn-github-actions/essential-features-of-github-actions.md @@ -0,0 +1,95 @@ +--- +title: GitHub Actions の重要な機能 +shortTitle: 重要な機能 +intro: '{% data variables.product.prodname_actions %} は、堅牢で動的な自動化の構築ができるように設計されています。 このガイドでは、環境変数、カスタマイズされたスクリプトなどを含む {% data variables.product.prodname_actions %} ワークフローを作成する方法を説明します。' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +### 概要 + +{% data variables.product.prodname_actions %} を使用すると、アプリケーションと Team の固有のニーズに合わせてワークフローをカスタマイズできます。 このガイドでは、変数の使用、スクリプトの実行、ジョブ間でのデータとアーティファクトの共有など、いくつかの重要なカスタマイズ手法について説明します。 + +### ワークフローで変数を使用する + +{% data variables.product.prodname_actions %} には、ワークフロー実行ごとのデフォルトの環境変数が含まれています。 カスタム環境変数を使用する必要がある場合は、YAML ワークフローファイルでこれらを設定できます。 この例は、`POSTGRES_HOST` および `POSTGRES_PORT` という名前のカスタム変数の作成方法を示しています。 これらの変数は、`node client.js` スクリプトで使用できます。 + +```yaml +jobs: + example-job: + steps: + - name: Connect to PostgreSQL + run: node client.js + env: + POSTGRES_HOST: postgres + POSTGRES_PORT: 5432 +``` + +詳しい情報については、「[環境変数の利用](/actions/configuring-and-managing-workflows/using-environment-variables)」を参照してください。 + +### ワークフローにスクリプトを追加する + +アクションを使用してスクリプトとシェルコマンドを実行し、割り当てられたランナーで実行できます。 この例では、アクションが `run` キーワードを使用して、ランナーで `npm install -g bats` を実行する方法を示しています。 + +```yaml +jobs: + example-job: + steps: + - run: npm install -g bats +``` + +たとえば、スクリプトをアクションとして実行するには、スクリプトをリポジトリに保存し、パスとシェルタイプを指定します。 + +```yaml +jobs: + example-job: + steps: + - name: Run build script + run: ./.github/scripts/build.sh + shell: bash +``` + +詳細については、「[{% data variables.product.prodname_actions %}のワークフロー構文](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)」を参照してください。 + +### ジョブ間でデータを共有する + +ジョブが同じワークフロー内の別のジョブと共有するファイルを生成する場合、または後で参照できるようにファイルを保存する場合は、それらを_アーティファクト_として {% data variables.product.prodname_dotcom %} に保存できます。 アーティファクトとは、コードをビルドしてテストするときに作成されるファイルのことです。 たとえば、アーティファクトには、バイナリまたパッケージファイル、テスト結果、スクリーンショット、ログファイルなどがあります。 アーティファクトは、それが作成されたワークフロー実行に関連付けられており、別のジョブで使用できます。 + +たとえば、ファイルを作成し、それをアーティファクトとしてアップロードできます。 + +```yaml +jobs: + example-job: + name: Save output + steps: + - shell: bash + run: | + expr 1 + 1 > output.log + - name: Upload output file + uses: actions/upload-artifact@v1 + with: + name: output-log-file + path: output.log +``` + +別のワークフロー実行からアーティファクトをダウンロードするには、`actions/download-artifact` アクションを使用できます。 たとえば、`output-log-file` という名前のアーティファクトをダウンロードできます。 + +```yaml +jobs: + example-job: + steps: + - name: Download a single artifact + uses: actions/download-artifact@v2 + with: + name: output-log-file +``` + +アーティファクトに関する詳しい情報については「[アーティファクトを利用してワークフローのデータを永続化する](/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts)」を参照してください。 + +### 次のステップ + +{% data variables.product.prodname_actions %} について詳しくは、「[複雑なワークフローを管理する](/actions/learn-github-actions/managing-complex-workflows)」を参照してください。 diff --git a/translations/ja-JP/content/actions/learn-github-actions/finding-and-customizing-actions.md b/translations/ja-JP/content/actions/learn-github-actions/finding-and-customizing-actions.md new file mode 100644 index 000000000000..4ae6970322d7 --- /dev/null +++ b/translations/ja-JP/content/actions/learn-github-actions/finding-and-customizing-actions.md @@ -0,0 +1,156 @@ +--- +title: アクションの検索とカスタマイズ +shortTitle: アクションの検索とカスタマイズ +intro: 'アクションは、ワークフローを動かす構成要素です。 ワークフローには、コミュニティによって作成されたアクションを含めることも、アプリケーションのリポジトリ内に直接独自のアクションを作成することもできます。 このガイドでは、アクションを検出、使用、およびカスタマイズする方法を説明します。' +redirect_from: + - /actions/automating-your-workflow-with-github-actions/using-github-marketplace-actions + - /actions/automating-your-workflow-with-github-actions/using-actions-from-github-marketplace-in-your-workflow + - /actions/getting-started-with-github-actions/using-actions-from-github-marketplace + - /actions/getting-started-with-github-actions/using-community-workflows-and-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +### 概要 + +ワークフローで使用するアクションは、次のように定義できます。 + +- パブリック リポジトリ +- ワークフローファイルがアクションを参照するのと同じリポジトリ +- Docker ハブで公開された Docker コンテナー イメージ + +{% data variables.product.prodname_marketplace %}は、{% data variables.product.prodname_dotcom %}コミュニティによって構築されたアクションを見つけるための中央となる場所です。 [{% data variables.product.prodname_marketplace %} ページ](https://github.com/marketplace/actions/)では、アクションをカテゴリでフィルタできます。 + +{% data reusables.actions.enterprise-marketplace-actions %} + +### ワークフローエディタで Marketplace アクションを参照する + +リポジトリのワークフローエディタで、直接アクションを検索し、ブラウズできます。 サイドバーから特定のアクションを検索し、注目のアクションを見て、注目のカテゴリをブラウズできます。 また、アクションが{% data variables.product.prodname_dotcom %}コミュニティから受けたStarの数も見ることができます。 + +1. リポジトリで、編集したいワークフローファイルにアクセスします。 +1. ファイルビューの右上隅の {% octicon "pencil" aria-label="The edit icon" %}をクリックしてワークフローエディタを開きます。 ![ワークフローファイルの編集ボタン](/assets/images/help/repository/actions-edit-workflow-file.png) +1. エディタの右側で{% data variables.product.prodname_marketplace %}サイドバーを使ってアクションをブラウズしてください。 {% octicon "verified" aria-label="The verified badge" %} バッジの付いたアクションは、{% data variables.product.prodname_dotcom %} がアクションの作者をパートナー Organization として確認したことを示します。 ![マーケットプレイスのワークフローサイドバー](/assets/images/help/repository/actions-marketplace-sidebar.png) + +### ワークフローにアクションを追加する + +アクションのリストのページには、アクションのバージョンと、そのアクションを利用するために必要なワークフローの構文が含まれています。 アクションが更新された場合でもワークフローを安定させるために、ワークフローファイルで Git または Docker タグ番号を指定することにより、使用するアクションのバージョンを参照できます。 + +1. ワークフローで使いたいアクションにアクセスしてください。 +1. "Installation（インストール）"の下で、{% octicon "clippy" aria-label="The edit icon" %}をクリックしてワークフローの構文をコピーしてください。 ![アクションのリストの表示](/assets/images/help/repository/actions-sidebar-detailed-view.png) +1. この構文をワークフロー中に新しいステップとして貼り付けてください。 詳細については、「[{% data variables.product.prodname_actions %}のワークフロー構文](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idsteps)」を参照してください。 +1. アクションで入力が必要な場合は、ワークフローで設定します。 アクションに必要な入力については、「[アクションで入力と出力を使用する](/actions/learn-github-actions/finding-and-customizing-actions#using-inputs-and-outputs-with-an-action)」を参照してください。 + +{% if currentVersion == "free-pro-team@latest" %} + +{% data reusables.dependabot.version-updates-for-actions %} + +{% endif %} + +### カスタムアクションにリリース管理を使用する + +コミュニティアクションの作者は、タグ、ブランチ、または SHA 値を使用してアクションのリリースを管理するオプションがあります。 他の依存関係と同様に、アクションの更新を自動的に受け入れる際のお好みに応じて、使用するアクションのバージョンを指定する必要があります。 + +ワークフローファイルでアクションのバージョンを指定します。 リリース管理へのアプローチに関する情報、および使用するタグ、ブランチ、または SHA 値を確認するには、アクションのドキュメントを確認してください。 + +#### タグの使用 + +タグは、メジャーバージョンとマイナーバージョンの切り替えタイミングを決定するときに役立ちますが、これらはより一過性のものであり、メンテナから移動または削除される可能性があります。 この例では、`v1.0.1` としてタグ付けされたアクションをターゲットにする方法を示しています。 + +```yaml +steps: + - uses: actions/javascript-action@v1.0.1 +``` + +#### SHA の使用 + +より信頼性の高いバージョン管理が必要な場合は、アクションのバージョンに関連付けられた SHA 値を使用する必要があります。 SHA は不変であるため、タグやブランチよりも信頼性が高くなります。 ただし、このアプローチでは、重要なバグ修正やセキュリティアップデートなど、アクションの更新を自動的に受信しません。 この例では、アクションの SHA を対象としています。 + +```yaml +steps: + - uses: actions/javascript-action@172239021f7ba04fe7327647b213799853a9eb89 +``` + +#### ブランチの使用 + +特定のブランチを参照するということは、アクションが常にターゲットブランチの最新の更新を含み使用することを示しますが、それらの更新に重大な変更が含まれる場合、問題が発生する可能性があります。 この例では、`@main` という名前のブランチを対象としています。 + +```yaml +steps: + - uses: actions/javascript-action@main +``` + +詳しい情報については、「[アクションにリリース管理を使用する](/actions/creating-actions/about-actions#using-release-management-for-actions)」を参照してください。 + +### アクションで入力と出力を使用する + +多くの場合、アクションは入力を受け入れたり要求したりして、使用できる出力を生成します。 たとえば、アクションでは、ファイルへのパス、ラベルの名前、またはアクション処理の一部として使用するその他のデータを指定する必要がある場合があります。 + +アクションの入力と出力を確認するには、リポジトリのルートディレクトリにある `action.yml` または `action.yaml` を確認してください。 + +この例の `action.yml` では、`inputs` キーワードは、`file-path` と呼ばれる必須の入力を定義し、何も指定されていない場合に使用されるデフォルト値を含みます。 `output` キーワードは、結果の場所を示す `results-file` という出力を定義します。 + +```yaml +name: 'Example' +description: 'Receives file and generates output' +inputs: + file-path: # id of input + description: "Path to test script" + required: true + default: 'test-file.js' +outputs: + results-file: # id of output + description: "Path to results file" +``` + +### ワークフロー ファイルでアクションを使用する同じリポジトリ内のアクションの参照 + +ワークフロー ファイルがアクションを使用するのと同じリポジトリでアクションが定義されている場合は、ワークフロー ファイル内の`{owner}/{repo}@{ref}` または `./path/to/dir` 構文を使用してアクションを参照できます。 + +リポジトリ ファイル構造の例: + +``` +|-- ハローワールド (リポジトリ) +| github +| └─ ワークフロー +| └─ 私の最初のワークフロー.yml +| └─ +アクション | |__ ハローワールドアクション +| └── アクション.yml +``` + +ワークフロー ファイルの例: + +```yaml +ジョブ: + ビルド: + 実行: ubuntu 最新 + ステップ: + # このステップは、リポジトリのコピーをチェックアウトします。 + - 用途: アクション/checkout@v2 + # このステップは、アクションを含むディレクトリを参照します。 + - 用途: ./.github/アクション/ハローワールドアクション +``` + +`action.yml` ファイルは、アクションのメタデータを提供するために使用されます。 このファイルの内容については、「[GitHub Actions のメタデータ構文](/actions/creating-actions/metadata-syntax-for-github-actions)」をご覧ください。 + +### Docker ハブでのコンテナーの参照 + +アクションが Docker Hub の公開された Docker コンテナー イメージで定義されている場合は、ワークフロー ファイル内の `docker://{image}:{tag}` 構文を使用してアクションを参照する必要があります。 コードとデータを保護するために、ワークフローで使用する前に Docker Hub から Docker コンテナー イメージの整合性を確認することを強くお勧めします。 + +```yaml +ジョブ: + my_first_job: + ステップ: + - 名前: 使用 + 私の最初のステップ: docker://alpine:3.8 +``` + +Dockerアクションの例については、[Docker-image.ymlのワークフロー](https://github.com/actions/starter-workflows/blob/main/ci/docker-image.yml)及び「[Dockerコンテナのアクションの作成](/articles/creating-a-docker-container-action)」を参照してください。 + +### 次のステップ + +{% data variables.product.prodname_actions %} の詳細については、「[{% data variables.product.prodname_actions %} の重要な機能](/actions/learn-github-actions/essential-features-of-github-actions)」を参照してください。 diff --git a/translations/ja-JP/content/actions/learn-github-actions/index.md b/translations/ja-JP/content/actions/learn-github-actions/index.md new file mode 100644 index 000000000000..66e9fa3c7862 --- /dev/null +++ b/translations/ja-JP/content/actions/learn-github-actions/index.md @@ -0,0 +1,42 @@ +--- +title: GitHub Actions について学ぶ +shortTitle: GitHub Actions について学ぶ +intro: '{% data variables.product.prodname_actions %} を初めて使用する場合も、そこで提供されているすべての項目を学ぶ場合も、このガイドは、{% data variables.product.prodname_actions %} を使用してアプリケーション開発ワークフローを促進する際に役立ちます。' +redirect_from: + - /articles/about-github-actions + - /github/automating-your-workflow-with-github-actions/about-github-actions + - /actions/automating-your-workflow-with-github-actions/about-github-actions + - /actions/getting-started-with-github-actions + - /actions/getting-started-with-github-actions/about-github-actions + - /actions/getting-started-with-github-actions/overview + - /actions/getting-started-with-github-actions/getting-started-with-github-actions + - /articles/migrating-github-actions-from-hcl-syntax-to-yaml-syntax/ + - /actions/configuring-and-managing-workflows/configuring-a-workflow + - /記事/ワークフローを作成する -github アクション/ + - /記事/ワークフローの構成 + - /github/自動化-ワークフローをgithubアクションで/ワークフローを設定する + - /アクション/自動化-ワークフローをgithubアクションで/ワークフローを設定する + - /アクション/作成ワークフロー/ワークフロー構成オプション + - /articles/configuring-workflows + - /github/automating-your-workflow-with-github-actions/configuring-workflows + - /actions/automating-your-workflow-with-github-actions/configuring-workflows + - /github/automating-your-workflow-with-github-actions/getting-started-with-github-actions + - /actions/automating-your-workflow-with-github-actions/getting-started-with-github-actions + - /actions/configuring-and-managing-workflows + - /articles/getting-started-with-github-actions + - /actions/migrating-to-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% link_with_intro /introduction-to-github-actions %} +{% link_with_intro /finding-and-customizing-actions %} +{% link_with_intro /essential-features-of-github-actions %} +{% link_with_intro /managing-complex-workflows %} +{% link_with_intro /sharing-workflows-with-your-organization %} +{% link_with_intro /security-hardening-for-github-actions %} +{% link_with_intro /migrating-from-circleci-to-github-actions %} +{% link_with_intro /migrating-from-gitlab-cicd-to-github-actions %} +{% link_with_intro /migrating-from-azure-pipelines-to-github-actions %} +{% link_with_intro /migrating-from-jenkins-to-github-actions %} diff --git a/translations/ja-JP/content/actions/learn-github-actions/introduction-to-github-actions.md b/translations/ja-JP/content/actions/learn-github-actions/introduction-to-github-actions.md new file mode 100644 index 000000000000..1bac7acb62e0 --- /dev/null +++ b/translations/ja-JP/content/actions/learn-github-actions/introduction-to-github-actions.md @@ -0,0 +1,225 @@ +--- +title: GitHub Actions 入門 +shortTitle: GitHub Actions 入門 +intro: '{% data variables.product.prodname_actions %} の中核的概念とさまざまなコンポーネントについて学び、リポジトリに自動化を追加する方法の例を示します。' +redirect_from: + - /github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions + - /actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions + - /actions/getting-started-with-github-actions/core-concepts-for-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +### 概要 + +{% data variables.product.prodname_actions %} は、ソフトウェア開発ライフサイクル内のタスクを自動化するのに役立ちます。 {% data variables.product.prodname_actions %} はイベント駆動型で、指定されたイベントが発生した後に一連のコマンドを実行できます。 たとえば、誰かがリポジトリのプルリクエストを作成するたびに、ソフトウェアテストスクリプトを実行するコマンドを自動的に実行できます。 + +この図は、{% data variables.product.prodname_actions %} を使用してソフトウェアテストスクリプトを自動的に実行する方法を示しています。 イベントは、_ジョブ_を含む_ワークフロー_を自動的にトリガーします。 次に、ジョブは_ステップ_を使用して、_アクション_が実行される順序を制御します。 これらのアクションは、ソフトウェアテストを自動化するコマンドです。 + +![Workflow overview](/assets/images/help/images/overview-actions-simple.png) + +### {% data variables.product.prodname_actions %} のコンポーネント + +以下は、ジョブを実行するために連動する複数の {% data variables.product.prodname_actions %} コンポーネントのリストです。 これらのコンポーネントがどのように相互作用するかを確認できます。 + +![Component and service overview](/assets/images/help/images/overview-actions-design.png) + +#### ワークフロー + +ワークフローは、リポジトリに追加する自動化された手順です。 ワークフローは 1 つ以上のジョブで構成されており、イベントによってスケジュールまたはトリガーできます。 ワークフローを使用して、{% data variables.product.prodname_dotcom %} でプロジェクトをビルド、テスト、パッケージ、リリース、またはデプロイできます。 + +#### イベント + +イベントは、ワークフローをトリガーする特定のアクティビティです。 たとえば、誰かがコミットをリポジトリにプッシュした場合、あるいはIssueもしくはプルリクエストが作成された場合、{% data variables.product.prodname_dotcom %}からアクティビティを発生させることができます。 リポジトリディスパッチ webhook を使用して、外部イベントが発生したときにワークフローをトリガーすることもできます。 ワークフローのトリガーに使用できるイベントの完全なリストについては、[ワークフローをトリガーするイベント](/actions/reference/events-that-trigger-workflows)を参照してください。 + +#### Jobs + +ジョブは、同じランナーで実行される一連のステップです。 デフォルトでは、複数のジョブを含むワークフローは、それらのジョブを並行して実行します。 ジョブを順番に実行するようにワークフローを設定することもできます。 たとえば、ワークフローにコードのビルドとテストという2つのシーケンシャルなジョブを持たせ、テストジョブをビルドジョブのステータスに依存させることができます。 ビルドジョブが失敗した場合は、テストジョブは実行されません。 + +#### ステップ + +ステップは、コマンド（_アクション_と呼ばれる）を実行できる個々のタスクです。 ジョブの各ステップは同じランナーで実行され、そのジョブのアクションが互いにデータを共有できるようにします。 + +#### アクション + +_アクション_は、_ジョブ_を作成するために_ステップ_に結合されるスタンドアロンコマンドです。 アクションは、ワークフローの最小のポータブルな構成要素です。 独自のアクションを作成することも、{% data variables.product.prodname_dotcom %} コミュニティによって作成されたアクションを使用することもできます。 ワークフローでアクションを使うには、それをステップとして含めなければなりません。 + +#### ランナー + +ランナーは、{% data variables.product.prodname_actions %} ランナーアプリケーションがインストールされているサーバーです。 {% data variables.product.prodname_dotcom %} がホストするランナーを使用することも、自分でランナーをホストすることもできます。 ランナーは、使用可能なジョブをリッスンし、一度に 1 つのジョブを実行し、進行状況、ログ、および結果を {% data variables.product.prodname_dotcom %} に返します。 {% data variables.product.prodname_dotcom %}ホストランナーでは、ワークフロー内の各ジョブは新しい仮想環境で実行されます。 + +{% data variables.product.prodname_dotcom %} ホストランナーは、Ubuntu Linux、Microsoft Windows、および macOS に基づいています。 {% data variables.product.prodname_dotcom %} ホストランナーの詳細については、「[{% data variables.product.prodname_dotcom %} ホストランナーの仮想環境](/actions/reference/virtual-environments-for-github-hosted-runners)」を参照してください。 別のオペレーティングシステムが必要な場合、または特定のハードウェア設定が必要な場合は、自分のランナーをホストできます。 セルフホストランナーの詳細については、「[自分のランナーをホストする](/actions/hosting-your-own-runners)」を参照してください。 + +### サンプルワークフローを作成する + +{% data variables.product.prodname_actions %}は、YAML 構文を使用して、イベント、ジョブ、およびステップを定義します。 これらの YAML ファイルは、コードリポジトリの `.github/workflows` というディレクトリに保存されます。 + +コードがプッシュされるたびに一連のコマンドを自動的にトリガーするサンプルワークフローをリポジトリに作成できます。 このワークフローでは、{% data variables.product.prodname_actions %} がプッシュされたコードをチェックアウトし、ソフトウェアの依存関係をインストールして、`bats-v` を実行します。 + +1. リポジトリに、ワークフローファイルを保存するための `.github/workflows/` ディレクトリを作成します。 +1. `.github/workflows/` ディレクトリに、`learn-github-actions.yml` という名前の新しいファイルを作成し、次のコードを追加します。 + ```yaml + name: learn-github-actions + on: [push] + jobs: + check-bats-version: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - uses: actions/setup-node@v1 + - run: npm install -g bats + - run: bats -v + ``` +1. これらの変更をコミットして、{% data variables.product.prodname_dotcom %} リポジトリにプッシュします。 + +これで、新しい {% data variables.product.prodname_actions %} ワークフローファイルがリポジトリにインストールされ、別のユーザがリポジトリに変更をプッシュするたびに自動的に実行されます。 ジョブの実行履歴の詳細については、「[ワークフローのアクティビティを表示する](/actions/learn-github-actions/introduction-to-github-actions#viewing-the-jobs-activity)」を参照してください。 + +### ワークフローファイルを理解する + +YAML 構文を使用してワークフローファイルを作成する方法を理解しやすくするために、このセクションでは、導入例の各行について説明します。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + + ```yaml + name: learn-github-actions + ``` + + オプション - {% data variables.product.prodname_dotcom %} リポジトリの [Actions] タブに表示されるワークフローの名前。 +
    + + ```yaml + on: [push] + ``` + + ワークフローファイルを自動的にトリガーするイベントを指定します。 この例では push イベントを使用しているため、別のユーザが変更をリポジトリにプッシュするたびにジョブが実行されます。 特定のブランチ、パス、またはタグでのみ実行するようにワークフローを設定できます。 ブランチ、パス、またはタグを含むまたは除外する構文の例については、「{% data variables.product.prodname_actions %} のワークフロー構文」を参照してください。 +
    + + ```yaml + jobs: + ``` + + learn-github-actions ワークフローファイルで実行されるすべてのジョブをグループ化します。 +
    + + ```yaml + check-bats-version: + ``` + + jobs セクション内に保存されている check-bats-version ジョブの名前を定義します。 +
    + + ```yaml + runs-on: ubuntu-latest + ``` + + Ubuntu Linux ランナーで実行するようにジョブを設定します。 これは、ジョブが GitHub によってホストされている新しい仮想マシンで実行されるということです。 他のランナーを使用した構文例については、「{% data variables.product.prodname_actions %} のワークフロー構文」を参照してください。 +
    + + ```yaml + steps: + ``` + + check-bats-version ジョブで実行されるすべてのステップをグループ化します。 このセクションの下にネストされた各行は、個別のアクションです。 +
    + + ```yaml + - uses: actions/checkout@v2 + ``` + + uses キーワードは、actions/checkout@v2 という名前のコミュニティアクションの v2 を取得するようにジョブに指示します。 これは、リポジトリをチェックアウトしてランナーにダウンロードし、コード（テストツールなど）に対してアクションを実行できるようにします。 ワークフローがリポジトリのコードに対して実行されるとき、またはリポジトリで定義されたアクションを使用しているときはいつでも、チェックアウトアクションを使用する必要があります。 +
    + + ```yaml + - uses: actions/setup-node@v1 + ``` + + このアクションにより、node ソフトウェアパッケージがランナーにインストールされ、npm コマンドにアクセスできるようになります。 +
    + + ```yaml + - run: npm install -g bats + ``` + + run キーワードは、ランナーでコマンドを実行するようにジョブに指示します。 この場合、npm を使用して bats ソフトウェアテストパッケージをインストールしています。 +
    + + ```yaml + - run: bats -v + ``` + + 最後に、ソフトウェアバージョンを出力するパラメータを指定して bats コマンドを実行します。 +
    + +#### ワークフローファイルの視覚化 + +In this diagram, you can see the workflow file you just created and how the {% data variables.product.prodname_actions %} components are organized in a hierarchy. Each step executes a single action. Steps 1 and 2 use prebuilt community actions. To find more prebuilt actions for your workflows, see "[Finding and customizing actions](/actions/learn-github-actions/finding-and-customizing-actions)." + +![Workflow overview](/assets/images/help/images/overview-actions-event.png) + + +### Viewing the job's activity + +Once your job has started running, you can view each step's activity on {% data variables.product.prodname_dotcom %}. + +{% data reusables.repositories.navigate-to-repo %} +1. リポジトリ名の下で**Actions（アクション）**をクリックしてください。 ![Navigate to repository](/assets/images/help/images/learn-github-actions-repository.png) +1. In the left sidebar, click the workflow you want to see. ![Screenshot of workflow results](/assets/images/help/images/learn-github-actions-workflow.png) +1. Under "Workflow runs", click the name of the run you want to see. ![Screenshot of workflow runs](/assets/images/help/images/learn-github-actions-run.png) +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +1. Click on the job name to see the results of each step. ![Screenshot of workflow run details](/assets/images/help/images/overview-actions-result-updated.png) +{% else %} +1. Click on the job name to see the results of each step. ![Screenshot of workflow run details](/assets/images/help/images/overview-actions-result.png) +{% endif %} + +### 次のステップ + +To continue learning about {% data variables.product.prodname_actions %}, see "[Finding and customizing actions](/actions/learn-github-actions/finding-and-customizing-actions)." + +### サポートへの連絡 + +{% data reusables.github-actions.contacting-support %} diff --git a/translations/ja-JP/content/actions/learn-github-actions/managing-complex-workflows.md b/translations/ja-JP/content/actions/learn-github-actions/managing-complex-workflows.md new file mode 100644 index 000000000000..7fa1d968a64f --- /dev/null +++ b/translations/ja-JP/content/actions/learn-github-actions/managing-complex-workflows.md @@ -0,0 +1,151 @@ +--- +title: 複雑なワークフローを管理する +shortTitle: 複雑なワークフローを管理する +intro: 'このガイドでは、{% data variables.product.prodname_actions %} の高度な機能を、シークレット管理、依存ジョブ、キャッシング、ビルドマトリックス、ラベルとともに使用する方法を説明します。' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +### 概要 + +この記事では、より複雑なワークフローの作成に役立つ {% data variables.product.prodname_actions %} の高度な機能の一部について説明します。 + +### シークレットを保存する + +ワークフローでパスワードや証明書などの機密データを使用する場合は、これらを {% data variables.product.prodname_dotcom %} に _secrets_ として保存すると、ワークフローで環境変数として使用できます。 これは、YAML ワークフローに直接機密値を埋め込むことなく、ワークフローを作成して共有できることを示しています。 + +この例では、既存のシークレットを環境変数として参照し、それをパラメータとしてサンプルコマンドに送信する方法を示しています。 + +{% raw %} +```yaml +jobs: + example-job: + steps: + - name: Retrieve secret + env: + super_secret: ${{ secrets.SUPERSECRET }} + run: | + example-command "$SUPER_SECRET" +``` +{% endraw %} + +詳しい情報については「[暗号化されたシークレットの作成と保存](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)」を参照してください。 + +### 依存ジョブを作成する + +デフォルトでは、ワークフロー内のジョブはすべて同時並行で実行されます。 したがって、別のジョブが完了した後にのみ実行する必要があるジョブがある場合は、`needs` キーワードを使用してこの依存関係を作成できます。 ジョブのうちの 1 つが失敗すると、依存するすべてのジョブがスキップされます。ただし、ジョブを続行する必要がある場合は、[`if`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idif) 条件ステートメントを使用してこれを定義できます。 + +この例では、`setup`、`build`、および `test` ジョブが連続して実行され、`build` と `test` は、それらに先行するジョブが正常に完了したかどうかに依存します。 + +```yaml +jobs: + setup: + runs-on: ubuntu-latest + steps: + - run: ./setup_server.sh + build: + needs: setup + steps: + - run: ./build_server.sh + test: + needs: build + runs-on: ubuntu-latest + steps: + - run: ./test_server.sh +``` + +詳しい情報については、[`jobs..needs`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds) を参照してください。 + +### ビルドマトリックスを使用する + +ワークフローでオペレーティングシステム、プラットフォーム、および言語の複数の組み合わせにわたってテストを実行する場合は、ビルドマトリックスを使用できます。 ビルドマトリックスは、ビルドオプションを配列として受け取る `strategy` キーワードを使用して作成されます。 たとえば、このビルドマトリックスは、異なるバージョンの Node.js を使用して、ジョブを複数回実行します。 + +{% raw %} +```yaml +jobs: + build: + runs-on: ubuntu-latest + strategy: + matrix: + node: [6, 8, 10] + steps: + - uses: actions/setup-node@v1 + with: + node-version: ${{ matrix.node }} +``` +{% endraw %} + +詳しい情報については、[`jobs..strategy.matrix`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix) を参照してください。 + +### 依存関係のキャッシング + +{% data variables.product.prodname_dotcom %} ホストランナーは各ジョブの新しい環境として開始されるため、ジョブが依存関係を定期的に再利用する場合は、これらのファイルをキャッシュしてパフォーマンスを向上させることを検討できます。 キャッシュが作成されると、同じリポジトリ内のすべてのワークフローで使用できるようになります。 + +この例は、`~/.npm` ディレクトリをキャッシュする方法を示しています。 + +{% raw %} +```yaml +jobs: + example-job: + steps: + - name: Cache node modules + uses: actions/cache@v2 + env: + cache-name: cache-node-modules + with: + path: ~/.npm + key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }} + restore-keys: | + ${{ runner.os }}-build-${{ env.cache-name }}- +``` +{% endraw %} + +詳しい情報については「[ワークフローを高速化するための依存関係のキャッシング](/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows)」を参照してください。 + +### データベースとサービスコンテナの利用 + +ジョブにデータベースまたはキャッシュサービスが必要な場合は、[`services`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idservices) キーワードを使用して、サービスをホストするための一時コンテナを作成できます。 この例は、ジョブが `services` を使用して `postgres` コンテナを作成し、`node` を使用してサービスに接続する方法を示しています。 + +```yaml +jobs: + container-job: + runs-on: ubuntu-latest + container: node:10.18-jessie + services: + postgres: + image: postgres + steps: + - name: Check out repository code + uses: actions/checkout@v2 + - name: Install dependencies + run: npm ci + - name: Connect to PostgreSQL + run: node client.js + env: + POSTGRES_HOST: postgres + POSTGRES_PORT: 5432 +``` + +詳しい情報については、「[データベースおよびサービスコンテナを使用する](/actions/configuring-and-managing-workflows/using-databases-and-service-containers)」を参照してください。 + +### ラベルを使用してワークフローを転送する + +この機能は、特定のセルフホストランナーにジョブを割り当てるのに役立ちます。 特定のタイプのランナーがジョブを処理することを確認したい場合は、ラベルを使用してジョブの実行場所を制御できます。 セルフホストランナーにラベルを割り当ててから、YAML ワークフローでこれらのラベルを参照して、ジョブが予測可能な方法で転送されるようにすることができます。 + +この例は、ワークフローがラベルを使用して必要なランナーを指定する方法を示しています。 + +```yaml +jobs: + example-job: + runs-on: [self-hosted, linux, x64, gpu] +``` + +詳しい情報については、「[セルフホストランナーでのラベルの利用](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners)」を参照してください。 + +### 次のステップ + +{% data variables.product.prodname_actions %} について詳しくは、「[Organization とワークフローを共有する](/actions/learn-github-actions/sharing-workflows-with-your-organization)」を参照してください。 diff --git a/translations/ja-JP/content/actions/learn-github-actions/migrating-from-azure-pipelines-to-github-actions.md b/translations/ja-JP/content/actions/learn-github-actions/migrating-from-azure-pipelines-to-github-actions.md new file mode 100644 index 000000000000..c27988992679 --- /dev/null +++ b/translations/ja-JP/content/actions/learn-github-actions/migrating-from-azure-pipelines-to-github-actions.md @@ -0,0 +1,327 @@ +--- +title: Migrating from Azure Pipelines to GitHub Actions +intro: '{% data variables.product.prodname_actions %} and Azure Pipelines share several configuration similarities, which makes migrating to {% data variables.product.prodname_actions %} relatively straightforward.' +redirect_from: + - /actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Introduction + +Azure Pipelines and {% data variables.product.prodname_actions %} both allow you to create workflows that automatically build, test, publish, release, and deploy code. Azure Pipelines and {% data variables.product.prodname_actions %} share some similarities in workflow configuration: + +- Workflow configuration files are written in YAML and are stored in the code's repository. +- Workflows include one or more jobs. +- Jobs include one or more steps or individual commands. +- Steps or tasks can be reused and shared with the community. + +For more information, see "[Core concepts for {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)." + +### Key differences + +When migrating from Azure Pipelines, consider the following differences: + +- Azure Pipelines supports a legacy _classic editor_, which lets you define your CI configuration in a GUI editor instead of creating the pipeline definition in a YAML file. {% data variables.product.prodname_actions %} uses YAML files to define workflows and does not support a graphical editor. +- Azure Pipelines allows you to omit some structure in job definitions. For example, if you only have a single job, you don't need to define the job and only need to define its steps. {% data variables.product.prodname_actions %} requires explicit configuration, and YAML structure cannot be omitted. +- Azure Pipelines supports _stages_ defined in the YAML file, which can be used to create deployment workflows. {% data variables.product.prodname_actions %} requires you to separate stages into separate YAML workflow files. +- On-premises Azure Pipelines build agents can be selected with capabilities. {% data variables.product.prodname_actions %} self-hosted runners can be selected with labels. + +### Migrating jobs and steps + +Jobs and steps in Azure Pipelines are very similar to jobs and steps in {% data variables.product.prodname_actions %}. In both systems, jobs have the following characteristics: + +* Jobs contain a series of steps that run sequentially. +* Jobs run on separate virtual machines or in separate containers. +* Jobs run in parallel by default, but can be configured to run sequentially. + +### Migrating script steps + +You can run a script or a shell command as a step in a workflow. In Azure Pipelines, script steps can be specified using the `script` key, or with the `bash`, `powershell`, or `pwsh` keys. Scripts can also be specified as an input to the [Bash task](https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/utility/bash?view=azure-devops) or the [PowerShell task](https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/utility/powershell?view=azure-devops). + +In {% data variables.product.prodname_actions %}, all scripts are specified using the `run` key. To select a particular shell, you can specify the `shell` key when providing the script. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)." + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +Azure Pipelines + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +jobs: +- job: scripts + pool: + vmImage: 'windows-latest' + steps: + - script: echo "This step runs in the default shell" + - bash: echo "This step runs in bash" + - pwsh: Write-Host "This step runs in PowerShell Core" + - task: PowerShell@2 + inputs: + script: Write-Host "This step runs in PowerShell" +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + scripts: + runs-on: windows-latest + steps: + - run: echo "This step runs in the default shell" + - run: echo "This step runs in bash" + shell: bash + - run: Write-Host "This step runs in PowerShell Core" + shell: pwsh + - run: Write-Host "This step runs in PowerShell" + shell: powershell +``` +{% endraw %} +
    + +### Differences in script error handling + +In Azure Pipelines, scripts can be configured to error if any output is sent to `stderr`. {% data variables.product.prodname_actions %} does not support this configuration. + +{% data variables.product.prodname_actions %} configures shells to "fail fast" whenever possible, which stops the script immediately if one of the commands in a script exits with an error code. In contrast, Azure Pipelines requires explicit configuration to exit immediately on an error. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#exit-codes-and-error-action-preference)." + +### Differences in the default shell on Windows + +In Azure Pipelines, the default shell for scripts on Windows platforms is the Command shell (_cmd.exe_). In {% data variables.product.prodname_actions %}, the default shell for scripts on Windows platforms is PowerShell. PowerShell has several differences in built-in commands, variable expansion, and flow control. + +If you're running a simple command, you might be able to run a Command shell script in PowerShell without any changes. But in most cases, you will either need to update your script with PowerShell syntax or instruct {% data variables.product.prodname_actions %} to run the script with the Command shell instead of PowerShell. You can do this by specifying `shell` as `cmd`. + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +Azure Pipelines + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +jobs: +- job: run_command + pool: + vmImage: 'windows-latest' + steps: + - script: echo "This step runs in CMD on Windows by default" +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + run_command: + runs-on: windows-latest + steps: + - run: echo "This step runs in PowerShell on Windows by default" + - run: echo "This step runs in CMD on Windows explicitly" + shell: cmd +``` +{% endraw %} +
    + +For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#using-a-specific-shell)." + +### Migrating conditionals and expression syntax + +Azure Pipelines and {% data variables.product.prodname_actions %} can both run steps conditionally. In Azure Pipelines, conditional expressions are specified using the `condition` key. In {% data variables.product.prodname_actions %}, conditional expressions are specified using the `if` key. + +Azure Pipelines uses functions within expressions to execute steps conditionally. In contrast, {% data variables.product.prodname_actions %} uses an infix notation. For example, you must replace the `eq` function in Azure Pipelines with the `==` operator in {% data variables.product.prodname_actions %}. + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +Azure Pipelines + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +jobs: +- job: conditional + pool: + vmImage: 'ubuntu-latest' + steps: + - script: echo "This step runs with str equals 'ABC' and num equals 123" + condition: and(eq(variables.str, 'ABC'), eq(variables.num, 123)) +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + conditional: + runs-on: ubuntu-latest + steps: + - run: echo "This step runs with str equals 'ABC' and num equals 123" + if: ${{ env.str == 'ABC' && env.num == 123 }} +``` +{% endraw %} +
    + +For more information, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)." + +### Dependencies between jobs + +Both Azure Pipelines and {% data variables.product.prodname_actions %} allow you to set dependencies for a job. In both systems, jobs run in parallel by default, but job dependencies can be specified explicitly. In Azure Pipelines, this is done with the `dependsOn` key. In {% data variables.product.prodname_actions %}, this is done with the `needs` key. + +Below is an example of the syntax for each system. The workflows start a first job named `initial`, and when that job completes, two jobs named `fanout1` and `fanout2` will run. Finally, when those jobs complete, the job `fanin` will run. + + + + + + + + + + +
    +Azure Pipelines + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +jobs: +- job: initial + pool: + vmImage: 'ubuntu-latest' + steps: + - script: echo "This job will be run first." +- job: fanout1 + pool: + vmImage: 'ubuntu-latest' + dependsOn: initial + steps: + - script: echo "This job will run after the initial job, in parallel with fanout2." +- job: fanout2 + pool: + vmImage: 'ubuntu-latest' + dependsOn: initial + steps: + - script: echo "This job will run after the initial job, in parallel with fanout1." +- job: fanin: + pool: + vmImage: 'ubuntu-latest' + dependsOn: [fanout1, fanout2] + steps: + - script: echo "This job will run after fanout1 and fanout2 have finished." +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + initial: + runs-on: ubuntu-latest + steps: + - run: echo "This job will be run first." + fanout1: + runs-on: ubuntu-latest + needs: initial + steps: + - run: echo "This job will run after the initial job, in parallel with fanout2." + fanout2: + runs-on: ubuntu-latest + needs: initial + steps: + - run: echo "This job will run after the initial job, in parallel with fanout1." + fanin: + runs-on: ubuntu-latest + needs: [fanout1, fanout2] + steps: + - run: echo "This job will run after fanout1 and fanout2 have finished." +``` +{% endraw %} +
    + +For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)." + +### Migrating tasks to actions + +Azure Pipelines uses _tasks_, which are application components that can be re-used in multiple workflows. {% data variables.product.prodname_actions %} uses _actions_, which can be used to perform tasks and customize your workflow. In both systems, you can specify the name of the task or action to run, along with any required inputs as key/value pairs. + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +Azure Pipelines + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +jobs: +- job: run_python + pool: + vmImage: 'ubuntu-latest' + steps: + - task: UsePythonVersion@0 + inputs: + versionSpec: '3.7' + architecture: 'x64' + - script: python script.py +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + run_python: + runs-on: ubuntu-latest + steps: + - uses: actions/setup-python@v2 + with: + python-version: '3.7' + architecture: 'x64' + - run: python script.py +``` +{% endraw %} +
    + +You can find actions that you can use in your workflow in [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=actions), or you can create your own actions. For more information, see "[Creating actions](/actions/creating-actions)." + diff --git a/translations/ja-JP/content/actions/learn-github-actions/migrating-from-circleci-to-github-actions.md b/translations/ja-JP/content/actions/learn-github-actions/migrating-from-circleci-to-github-actions.md new file mode 100644 index 000000000000..9f409220daf6 --- /dev/null +++ b/translations/ja-JP/content/actions/learn-github-actions/migrating-from-circleci-to-github-actions.md @@ -0,0 +1,447 @@ +--- +title: CircleCIからGitHub Actionsへの移行 +intro: 'GitHub ActionsとCircleCIには設定に相似点があるので、GitHub Actionsへの移行は比較的単純明快です。' +redirect_from: + - /actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +### はじめに + +CircleCIと{% data variables.product.prodname_actions %}は、どちらも自動的にコードのビルド、テスト、公開、リリース、デプロイを行うワークフローを作成できます。 CircleCIと{% data variables.product.prodname_actions %}は、ワークフローの設定において似ているところがあります。 + +- ワークフローの設定ファイルはYAMLで書かれ、リポジトリに保存されます。 +- ワークフローには1つ以上のジョブが含まれます。 +- ジョブには1つ以上のステップもしくは個別のコマンドが含まれます。 +- ステップもしくはタスクは、再利用とコミュニティとの共有が可能です。 + +詳しい情報については、「[{% data variables.product.prodname_actions %}の中核的概念](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)」を参照してください。 + +### 主要な差異 + +CircleCIから移行する際には、以下の差異を考慮してください。 + +- CircleCIの自動テストの並列性は、ユーザが指定したルールもしくは過去のタイミングの情報に基づいて、自動的にテストをグループ化します。 この機能は{% data variables.product.prodname_actions %}には組み込まれていません。 +- コンテナはユーザのマッピングが異なるので、Dockerコンテナ内で実行されるアクションは、権限の問題に敏感です。 これらの問題の多くは、*Dockerfile*中で`USER`命令を使わなければ回避できます。 Dockerのファイルシステムに関する詳しい情報については「[{% data variables.product.product_name %}ホストランナーの仮想環境](/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem)」を参照してください。 + +### ワークフローとジョブの移行 + +CircleCIは*config.yml*ファイル中で`workflows`を定義するので、複数のワークフローを設定できます。 {% data variables.product.product_name %}はワークフローごとに1つのワークフローファイルを必要とするので、結果として`workflows`を宣言する必要がありません。 それぞれのワークフローごとに、*config.yml*で内で設定された新しいワークフローファイルを作成しなければなりません。 + +CircleCIと{% data variables.product.prodname_actions %}は、どちらも似た構文を使って設定ファイル中で`jobs`を設定します。 CircleCIワークフロー中で`requires`を使ってジョブ間の依存関係を設定しているなら、相当する{% data variables.product.prodname_actions %}の`needs`構文を利用できます。 詳細については、「[{% data variables.product.prodname_actions %}のワークフロー構文](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)」を参照してください。 + +### orbsからアクションへの移行 + +CircleCIと{% data variables.product.prodname_actions %}は、どちらもワークフロー中のタスクを再利用し、共有するための仕組みを提供しています。 CircleCIはorbsという概念を利用します。これはYAMLで書かれ、ワークフロー中で再利用できるタスクを提供します。 {% data variables.product.prodname_actions %}はアクションと呼ばれる協力で柔軟な再利用できるコンポーネントを持っており、これはJavaScriptファイルもしくはDockerイメージで構築できます。 {% data variables.product.product_name %}の API やパブリックに利用可能なサードパーティAPIとのインテグレーションなど、好きな方法でリポジトリを操作するカスタムコードを書いて、アクションを作成することができます。 たとえば、アクションでnpmモジュールを公開する、緊急の問題が発生したときにSMSアラートを送信する、本番対応のコードをデプロイすることなどが可能です。 詳細については、「[アクションを作成する](/actions/creating-actions)」を参照してください。 + +CircleCIは、YAMLのアンカーとエイリアスでワークフローの部分を再利用できます。 {% data variables.product.prodname_actions %}はビルドマトリックスを使って、再利用性についての一般的な要求のほとんどをサポートします。 ビルドマトリックスに関する詳細な情報については「[複雑なワークフローを管理する](/actions/learn-github-actions/managing-complex-workflows/#using-a-build-matrix)」を参照してください。 + +### Dockerイメージの利用 + + +CircleCIと{% data variables.product.prodname_actions %}は、どちらもDockerイメージ内でのステップの実行をサポートします。 + +CircleCIは、共通の依存関係を持つ一連のビルド済みのイメージを提供します。 これらのイメージでは`USER`が`circleci`に設定されており、それが{% data variables.product.prodname_actions %}との権限の衝突を引き起こすことになります。 + +{% data variables.product.prodname_actions %}への移行に際しては、CircleCIの構築済みイメージから離脱することをおすすめします。 多くの場合、必要な追加の依存関係のインストールにアクションを使うことができます。 + +Dockerのファイルシステムに関する詳しい情報については「[{% data variables.product.product_name %}ホストランナーの仮想環境](/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem)」を参照してください。 + +{% data variables.product.prodname_dotcom %}ホストの仮想環境で利用できるツールとパッケージに関する詳しい情報については「[{% data variables.product.prodname_dotcom %} ホストランナーにインストールされているソフトウェア](/actions/reference/specifications-for-github-hosted-runners/#supported-software)」を参照してください。 + +### 変数とシークレットの利用 + +CircleCIと{% data variables.product.prodname_actions %}は、設定ファイル内での環境変数の設定と、CircleCIもしくは{% data variables.product.product_name %}のUIを使ったシークレットの作成をサポートしています。 + +詳しい情報については「[環境変数の利用](/actions/configuring-and-managing-workflows/using-environment-variables)」及び「[暗号化されたシークレットの作成と利用](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)」を参照してください。 + +### キャッシング + +CircleCIと{% data variables.product.prodname_actions %}は、設定ファイル中で手動でファイルをキャッシュする方法を提供しています。 + +以下は、それぞれのシステムにおける構文の例です。 + + + + + + + + + + +
    +CircleCI + +GitHub Actions +
    +{% raw %} +```yaml +- restore_cache: + keys: + - v1-npm-deps-{{ checksum "package-lock.json" }} + - v1-npm-deps- +``` +{% endraw %} + +{% raw %} +```yaml +- name: Cache node modules + uses: actions/cache@v2 + with: + path: ~/.npm + key: v1-npm-deps-${{ hashFiles('**/package-lock.json') }} + restore-keys: v1-npm-deps- +``` +{% endraw %} +
    + +詳しい情報については「[ワークフローを高速化するための依存関係のキャッシング](/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows)」を参照してください。 + +{% data variables.product.prodname_actions %}は、CircleCIのDocker Layer Caching（DLC）に相当する機能を持っていません。 + +### ジョブ間でのデータの永続化 + +CircleCIと{% data variables.product.prodname_actions %}は、どちらもジョブ間でデータを永続化するための仕組みを提供しています。 + +以下は、CircleCIと{% data variables.product.prodname_actions %}の設定構文の例です。 + + + + + + + + + + +
    +CircleCI + +GitHub Actions +
    +{% raw %} +```yaml +- persist_to_workspace: + root: workspace + paths: + - math-homework.txt + +... + +- attach_workspace: + at: /tmp/workspace +``` +{% endraw %} + +{% raw %} +```yaml +- name: Upload math result for job 1 + uses: actions/upload-artifact@v2 + with: + name: homework + path: math-homework.txt + +... + +- name: Download math result for job 1 + uses: actions/download-artifact@v2 + with: + name: homework +``` +{% endraw %} +
    + +詳しい情報については「[成果物を利用してワークフローのデータを永続化する](/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts)」を参照してください。 + +### データベースとサービスコンテナの利用 + +どちらのシステムでも、データベース、キャッシング、あるいはその他の依存関係のための追加コンテナを含めることができます。 + +CircleCIでは、*config.yaml*で最初に挙げられているイメージが、コマンドの実行に使われる主要なイメージです。 {% data variables.product.prodname_actions %}は明示的なセクションを使います。主要なコンテナには`container`を使い、追加のコンテナは`services`にリストしてください。 + +以下は、CircleCIと{% data variables.product.prodname_actions %}の設定構文の例です。 + + + + + + + + + + +
    +CircleCI + +GitHub Actions +
    +{% raw %} +```yaml +--- +version: 2.1 + +jobs: + + ruby-26: + docker: + - image: circleci/ruby:2.6.3-node-browsers-legacy + environment: + PGHOST: localhost + PGUSER: administrate + RAILS_ENV: test + - image: postgres:10.1-alpine + environment: + POSTGRES_USER: administrate + POSTGRES_DB: ruby26 + POSTGRES_PASSWORD: "" + + working_directory: ~/administrate + + steps: + - checkout + + # Bundle install dependencies + - run: bundle install --path vendor/bundle + + # Wait for DB + - run: dockerize -wait tcp://localhost:5432 -timeout 1m + + # Setup the environment + - run: cp .sample.env .env + + # Setup the database + - run: bundle exec rake db:setup + + # Run the tests + - run: bundle exec rake + + +workflows: + version: 2 + build: + jobs: + - ruby-26 +... + +- attach_workspace: + at: /tmp/workspace +``` +{% endraw %} + +{% raw %} +```yaml +name: Containers + +on: [push] + +jobs: + build: + + runs-on: ubuntu-latest + container: circleci/ruby:2.6.3-node-browsers-legacy + + env: + PGHOST: postgres + PGUSER: administrate + RAILS_ENV: test + + services: + postgres: + image: postgres:10.1-alpine + env: + POSTGRES_USER: administrate + POSTGRES_DB: ruby25 + POSTGRES_PASSWORD: "" + ports: + - 5432:5432 + # Add a health check + options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5 + + steps: + # This Docker file changes sets USER to circleci instead of using the default user, so we need to update file permissions for this image to work on GH Actions. + # https://docs.github.com/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem 参照 + - name: Setup file system permissions + run: sudo chmod -R 777 $GITHUB_WORKSPACE /github /__w/_temp + - uses: actions/checkout@v2 + - name: Install dependencies + run: bundle install --path vendor/bundle + - name: Setup environment configuration + run: cp .sample.env .env + - name: Setup database + run: bundle exec rake db:setup + - name: Run tests + run: bundle exec rake +``` +{% endraw %} +
    + +詳しい情報については「[サービスコンテナについて](/actions/configuring-and-managing-workflows/about-service-containers)」を参照してください。 + +### 完全な例 + +以下は実際の例です。 左は[ thoughtbot/administrator](https://github.com/thoughtbot/administrate)リポジトリのための実際の*config.yml*を示しています。 右は、同等の{% data variables.product.prodname_actions %}を示しています。 + + + + + + + + + + +
    +CircleCI + +GitHub Actions +
    +{% raw %} +```yaml +--- +version: 2.1 + +commands: + shared_steps: + steps: + - checkout + + # Restore Cached Dependencies + - restore_cache: + name: Restore bundle cache + key: administrate-{{ checksum "Gemfile.lock" }} + + # Bundle install dependencies + - run: bundle install --path vendor/bundle + + # Cache Dependencies + - save_cache: + name: Store bundle cache + key: administrate-{{ checksum "Gemfile.lock" }} + paths: + - vendor/bundle + + # Wait for DB + - run: dockerize -wait tcp://localhost:5432 -timeout 1m + + # Setup the environment + - run: cp .sample.env .env + + # Setup the database + - run: bundle exec rake db:setup + + # Run the tests + - run: bundle exec rake + +default_job: &default_job + working_directory: ~/administrate + steps: + - shared_steps + # Run the tests against multiple versions of Rails + - run: bundle exec appraisal install + - run: bundle exec appraisal rake + +jobs: + ruby-25: + <<: *default_job + docker: + - image: circleci/ruby:2.5.0-node-browsers + environment: + PGHOST: localhost + PGUSER: administrate + RAILS_ENV: test + - image: postgres:10.1-alpine + environment: + POSTGRES_USER: administrate + POSTGRES_DB: ruby25 + POSTGRES_PASSWORD: "" + + ruby-26: + <<: *default_job + docker: + - image: circleci/ruby:2.6.3-node-browsers-legacy + environment: + PGHOST: localhost + PGUSER: administrate + RAILS_ENV: test + - image: postgres:10.1-alpine + environment: + POSTGRES_USER: administrate + POSTGRES_DB: ruby26 + POSTGRES_PASSWORD: "" + + +workflows: + version: 2 + multiple-rubies: + jobs: + - ruby-26 + - ruby-25 +``` +{% endraw %} + +{% raw %} +```yaml +name: Containers + +on: [push] + +jobs: + build: + + strategy: + matrix: + ruby: [2.5, 2.6.3] + + runs-on: ubuntu-latest + + env: + PGHOST: localhost + PGUSER: administrate + RAILS_ENV: test + + services: + postgres: + image: postgres:10.1-alpine + env: + POSTGRES_USER: administrate + POSTGRES_DB: ruby25 + POSTGRES_PASSWORD: "" + ports: + - 5432:5432 + # ヘルスチェックを追加する + options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5 + + steps: + - uses: actions/checkout@v2 + - name: Setup Ruby + uses: eregon/use-ruby-action@master + with: + ruby-version: ${{ matrix.ruby }} + - name: Cache dependencies + uses: actions/cache@v2 + with: + path: vendor/bundle + key: administrate-${{ matrix.image }}-${{ hashFiles('Gemfile.lock') }} + - name: Install postgres headers + run: sudo apt-get install libpq-dev + - name: Install dependencies + run: bundle install --path vendor/bundle + - name: Setup environment configuration + run: cp .sample.env .env + - name: Setup database + run: bundle exec rake db:setup + - name: Run tests + run: bundle exec rake + - name: Install appraisal + run: bundle exec appraisal install + - name: Run appraisal + run: bundle exec appraisal rake +``` +{% endraw %} +
    diff --git a/translations/ja-JP/content/actions/learn-github-actions/migrating-from-gitlab-cicd-to-github-actions.md b/translations/ja-JP/content/actions/learn-github-actions/migrating-from-gitlab-cicd-to-github-actions.md new file mode 100644 index 000000000000..aad477296ab6 --- /dev/null +++ b/translations/ja-JP/content/actions/learn-github-actions/migrating-from-gitlab-cicd-to-github-actions.md @@ -0,0 +1,476 @@ +--- +title: Migrating from GitLab CI/CD to GitHub Actions +intro: '{% data variables.product.prodname_actions %} and GitLab CI/CD share several configuration similarities, which makes migrating to {% data variables.product.prodname_actions %} relatively straightforward.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +### はじめに + +GitLab CI/CD and {% data variables.product.prodname_actions %} both allow you to create workflows that automatically build, test, publish, release, and deploy code. GitLab CI/CD and {% data variables.product.prodname_actions %} share some similarities in workflow configuration: + +- ワークフローの設定ファイルはYAMLで書かれ、コードのリポジトリに保存されます。 +- ワークフローには1つ以上のジョブが含まれます。 +- ジョブには1つ以上のステップもしくは個別のコマンドが含まれます。 +- Jobs can run on either managed or self-hosted machines. + +There are a few differences, and this guide will show you the important differences so that you can migrate your workflow to {% data variables.product.prodname_actions %}. + +### Jobs + +Jobs in GitLab CI/CD are very similar to jobs in {% data variables.product.prodname_actions %}. どちらのシステムでも、ジョブは以下の特徴を持ちます。 + +* Jobs contain a series of steps or scripts that run sequentially. +* Jobs can run on separate machines or in separate containers. +* ジョブは、デフォルトでは並列に実行されますが、順次実行するように設定することもできます。 + +You can run a script or a shell command in a job. In GitLab CI/CD, script steps are specified using the `script` key. {% data variables.product.prodname_actions %}では、すべてのスクリプトは`run`キーを使って指定されます。 + +以下が、それぞれのシステムの構文の例です。 + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +job1: + variables: + GIT_CHECKOUT: "true" + script: + - echo "Run your script here" +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + job1: + steps: + - uses: actions/checkout@v2 + - run: echo "Run your script here" +``` +{% endraw %} +
    + +### ランナー + +Runners are machines on which the jobs run. Both GitLab CI/CD and {% data variables.product.prodname_actions %} offer managed and self-hosted variants of runners. In GitLab CI/CD, `tags` are used to run jobs on different platforms, while in {% data variables.product.prodname_actions %} it is done with the `runs-on` key. + +以下が、それぞれのシステムの構文の例です。 + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +windows_job: + tags: + - windows + script: + - echo Hello, %USERNAME%! + +linux_job: + tags: + - linux + script: + - echo "Hello, $USER!" +``` +{% endraw %} + +{% raw %} +```yaml +windows_job: + runs-on : windows-latest + steps: + - run: echo Hello, %USERNAME%! + +linux_job: + runs-on: ubuntu-latest + steps: + - run: echo "Hello, $USER!" +``` +{% endraw %} +
    + +For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on)." + +### Docker images + +Both GitLab CI/CD and {% data variables.product.prodname_actions %} support running jobs in a Docker image. In GitLab CI/CD, Docker images are defined with a `image` key, while in {% data variables.product.prodname_actions %} it is done with the `container` key. + +以下が、それぞれのシステムの構文の例です。 + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +my_job: + image: node:10.16-jessie +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + my_job: + container: node:10.16-jessie +``` +{% endraw %} +
    + +For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idcontainer)." + +### Condition and expression syntax + +GitLab CI/CD uses `rules` to determine if a job will run for a specific condition. {% data variables.product.prodname_actions %} uses the `if` keyword to prevent a job from running unless a condition is met. + +以下が、それぞれのシステムの構文の例です。 + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +deploy_prod: + stage: deploy + script: + - echo "Deply to production server" + rules: + - if: '$CI_COMMIT_BRANCH == "master"' +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + deploy_prod: + if: contains( github.ref, 'master') + runs-on: ubuntu-latest + steps: + - run: echo "Deply to production server" +``` +{% endraw %} +
    + +詳しい情報については、「[{% data variables.product.prodname_actions %} のコンテキストと式構文](/actions/reference/context-and-expression-syntax-for-github-actions)」を参照してください。 + +### Dependencies between Jobs + +Both GitLab CI/CD and {% data variables.product.prodname_actions %} allow you to set dependencies for a job. In both systems, jobs run in parallel by default, but job dependencies in {% data variables.product.prodname_actions %} can be specified explicitly with the `needs` key. GitLab CI/CD also has a concept of `stages`, where jobs in a stage run concurrently, but the next stage will start when all the jobs in the previous stage have completed. You can recreate this scenario in {% data variables.product.prodname_actions %} with the `needs` key. + +以下は、それぞれのシステムにおける構文の例です。 The workflows start with two jobs named `build_a` and `build_b` running in parallel, and when those jobs complete, another job called `test_ab` will run. Finally, when `test_ab` completes, the `deploy_ab` job will run. + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +stages: + - build + - test + - deploy + +build_a: + stage: build + script: + - echo "This job will run first." + +build_b: + stage: build + script: + - echo "This job will run first, in parallel with build_a." + +test_ab: + stage: test + script: + - echo "This job will run after build_a and build_b have finished." + +deploy_ab: + stage: deploy + script: + - echo "This job will run after test_ab is complete" +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + build_a: + runs-on: ubuntu-latest + steps: + - run: echo "This job will be run first." + + build_b: + runs-on: ubuntu-latest + steps: + - run: echo "This job will be run first, in parallel with build_a" + + test_ab: + runs-on: ubuntu-latest + needs: [build_a,build_b] + steps: + - run: echo "This job will run after build_a and build_b have finished" + + deploy_ab: + runs-on: ubuntu-latest + needs: [test_ab] + steps: + - run: echo "This job will run after test_ab is complete" +``` +{% endraw %} +
    + +詳細については、「[{% data variables.product.prodname_actions %}のワークフロー構文](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)」を参照してください。 + +### Scheduling workflows + +Both GitLab CI/CD and {% data variables.product.prodname_actions %} allow you to run workflows at a specific interval. In GitLab CI/CD, pipeline schedules are configured with the UI, while in {% data variables.product.prodname_actions %} you can trigger a workflow on a scheduled interval with the "on" key. + +For more information, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows#scheduled-events)." + +### Variables and secrets + +GitLab CI/CD and {% data variables.product.prodname_actions %} support setting environment variables in the pipeline or workflow configuration file, and creating secrets using the GitLab or {% data variables.product.product_name %} UI. + +For more information, see "[Environment variables](/actions/reference/environment-variables)" and "[Encrypted secrets](/actions/reference/encrypted-secrets)." + +### キャッシング + +GitLab CI/CD and {% data variables.product.prodname_actions %} provide a method in the configuration file to manually cache workflow files. + +以下が、それぞれのシステムの構文の例です。 + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +image: node:latest + +cache: + key: $CI_COMMIT_REF_SLUG + paths: + - .npm/ + +before_script: + - npm ci --cache .npm --prefer-offline + +test_async: + script: + - node ./specs/start.js ./specs/async.spec.js +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + test_async: + - name: Cache node modules + uses: actions/cache@v2 + with: + path: ~/.npm + key: v1-npm-deps-${{ hashFiles('**/package-lock.json') }} + restore-keys: v1-npm-deps- +``` +{% endraw %} +
    + +For more information, see "[Caching dependencies to speed up workflows](/actions/guides/caching-dependencies-to-speed-up-workflows)." + +### 成果物 + +Both GitLab CI/CD and {% data variables.product.prodname_actions %} can upload files and directories created by a job as artifacts. In {% data variables.product.prodname_actions %}, artifacts can be used to persist data across multiple jobs. + +以下が、それぞれのシステムの構文の例です。 + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +script: +artifacts: + paths: + - math-homework.txt +``` +{% endraw %} + +{% raw %} +```yaml +- name: Upload math result for job 1 + uses: actions/upload-artifact@v2 + with: + name: homework + path: math-homework.txt +``` +{% endraw %} +
    + +For more information, see "[Storing workflow data as artifacts](/actions/guides/storing-workflow-data-as-artifacts)." + +### Databases and service containers + +どちらのシステムでも、データベース、キャッシング、あるいはその他の依存関係のための追加コンテナを含めることができます。 + +In GitLab CI/CD, a container for the job is specified with the `image` key, while {% data variables.product.prodname_actions %} uses the `container` key. In both systems, additional service containers are specified with the `services` key. + +以下が、それぞれのシステムの構文の例です。 + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +container-job: + variables: + POSTGRES_PASSWORD: postgres + # The hostname used to communicate with the + # PostgreSQL service container + POSTGRES_HOST: postgres + # The default PostgreSQL port + POSTGRES_PORT: 5432 + image: node:10.18-jessie + services: + - postgres + script: + # Performs a clean installation of all dependencies + # in the `package.json` file + - npm ci + # Runs a script that creates a PostgreSQL client, + # populates the client with data, and retrieves data + - node client.js + tags: + - docker +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + container-job: + runs-on: ubuntu-latest + container: node:10.18-jessie + + services: + postgres: + image: postgres + env: + POSTGRES_PASSWORD: postgres + + steps: + - name: Check out repository code + uses: actions/checkout@v2 + + # Performs a clean installation of all dependencies + # in the `package.json` file + - name: Install dependencies + run: npm ci + + - name: Connect to PostgreSQL + # Runs a script that creates a PostgreSQL client, + # populates the client with data, and retrieves data + run: node client.js + env: + # The hostname used to communicate with the + # PostgreSQL service container + POSTGRES_HOST: postgres + # The default PostgreSQL port + POSTGRES_PORT: 5432 +``` +{% endraw %} +
    + +For more information, see "[About service containers](/actions/guides/about-service-containers)." diff --git a/translations/ja-JP/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md b/translations/ja-JP/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md new file mode 100644 index 000000000000..0bf50542747e --- /dev/null +++ b/translations/ja-JP/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md @@ -0,0 +1,293 @@ +--- +title: JenkinsからGitHub Actionsへの移行 +intro: '{% data variables.product.prodname_actions %}とJenkinsには複数の相似点があり、そのため{% data variables.product.prodname_actions %}への移行は比較的単純です。' +redirect_from: + - /actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +### はじめに + +Jenkinsと{% data variables.product.prodname_actions %}は、どちらも自動的にコードのビルド、テスト、公開、リリース、デプロイを行うワークフローを作成できます。 Jenkinsと{% data variables.product.prodname_actions %}は、ワークフローの設定において似ているところがあります。 + +- Jenkinsは_宣言的パイプライン_を使ってワークフローを作成します。これは{% data variables.product.prodname_actions %}のワークフローファイルに似ています。 +- Jenkinsは_ステージ_を使ってステップの集合を実行しますが、{% data variables.product.prodname_actions %}は1つ以上のステップもしくは個別のコマンドをグループ化するのにジョブを使います。 +- Jenkinsと{% data variables.product.prodname_actions %}はコンテナベースのビルドをサポートします。 詳しい情報については「[Docker コンテナアクションを作成する](/articles/creating-a-docker-container-action)」を参照してください。 +- ステップもしくはタスクは、再利用とコミュニティとの共有が可能です。 + +詳しい情報については、「[{% data variables.product.prodname_actions %}の中核的概念](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)」を参照してください。 + +### 主要な差異 + +- Jenkinsには、パイプラインの作成用の構文として、宣言的パイプラインとスクリプトパイプラインの2種類があります。 {% data variables.product.prodname_actions %}は、ワークフローと設定ファイルの作成にYAMLを使います。 詳しい情報については、「[GitHub Actionsのワークフロー構文](/actions/reference/workflow-syntax-for-github-actions)」を参照してください。 +- Jenkinsのデプロイメントは通常セルフホストであり、ユーザが自身のデータセンター内のサーバーをメンテナンスします。 {% data variables.product.prodname_actions %}は、ジョブの実行に利用できる独自のランナーをホストするハイブリッドクラウドのアプローチを提供しながら、セルフホストランナーもサポートします。 詳しい情報については「[セルフホストランナーについて](/actions/hosting-your-own-runners/about-self-hosted-runners)」を参照してください。 + +### 機能の比較 + +#### ビルドの分配 + +Jenkinsでは、ビルドを単一のビルドエージェントに送信することも、複数のエージェントに対して分配することもできます。 それらのエージェントを、オペレーティングシステムの種類などの様々な属性に従って分類することもできます。 + +同様に、{% data variables.product.prodname_actions %} はジョブを {% data variables.product.prodname_dotcom %} ホストまたはセルフホストランナーに送信でき、ラベルを使用してさまざまな属性に従ってランナーを分類できます。 以下の表は、分散ビルドの概念がJenkinsと{% data variables.product.prodname_actions %}でどのように実装されているかを比較しています。 + +| Jenkins | {% data variables.product.prodname_actions %} +| ---------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`エージェント`](https://wiki.jenkins.io/display/JENKINS/Distributed+builds) | [`ランナー`](/actions/learn-github-actions/introduction-to-github-actions#runners)
    [`セルフホストランナー`](/actions/hosting-your-own-runners/about-self-hosted-runners) | + +#### セクションを利用したパイプラインの整理 + +Jenkinsは、宣言的パイプラインを複数のセクションに分割します。 同様に、{% data variables.product.prodname_actions %} はワークフローを個別のセクションに編成します。 以下の表は、Jenkinsのセクションを{% data variables.product.prodname_actions %}のワークフローと比較しています。 + +| Jenkinsのディレクティブ | {% data variables.product.prodname_actions %} +| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| [`agent`](https://jenkins.io/doc/book/pipeline/syntax/#agent) | [`jobs..runs-on`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idruns-on)
    [`jobs..container`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idcontainer) | +| [`post`](https://jenkins.io/doc/book/pipeline/syntax/#post) | | +| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#stages) | [`jobs`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobs) | +| [`steps`](https://jenkins.io/doc/book/pipeline/syntax/#steps) | [`jobs..steps`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idsteps) | + + +### ディレクティブの利用 + +Jenkinsは、_宣言的パイプライン_を管理するためにディレクティブを使います。 それらのディレクティブは、ワークフローの特徴と、その実行方法を定義します。 以下の表は、それらのディレクティブが{% data variables.product.prodname_actions %}の概念とどのように対応するかを示しています。 + +| Jenkinsのディレクティブ | {% data variables.product.prodname_actions %} +| ------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`environment`](https://jenkins.io/doc/book/pipeline/syntax/#environment) | [`jobs..env`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env)
    [`jobs..steps.env`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv) | +| [`options`](https://jenkins.io/doc/book/pipeline/syntax/#parameters) | [`jobs..strategy`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategy)
    [`jobs..strategy.fail-fast`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategyfail-fast)
    [`jobs..timeout-minutes`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idtimeout-minutes) | +| [`parameters`](https://jenkins.io/doc/book/pipeline/syntax/#parameters) | [`inputs`](/actions/creating-actions/metadata-syntax-for-github-actions#inputs)
    [`outputs`](/actions/creating-actions/metadata-syntax-for-github-actions#outputs) | +| [`triggers`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`on`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#on)
    [`on..types`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onevent_nametypes)
    [on..](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)
    [on..paths](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpushpull_requestpaths) | +| [`triggers { upstreamprojects() }`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`jobs..needs`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idneeds) | +| [Jenkinsのcron構文](https://jenkins.io/doc/book/pipeline/syntax/#cron-syntax) | [`on.schedule`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onschedule) | +| [`ステージ`](https://jenkins.io/doc/book/pipeline/syntax/#stage) | [`jobs.`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_id)
    [`jobs..name`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idname) | +| [`tools`](https://jenkins.io/doc/book/pipeline/syntax/#tools) | [{% data variables.product.prodname_dotcom %} ホストランナーの仕様](/actions/reference/specifications-for-github-hosted-runners/#supported-software) | +| [`input`](https://jenkins.io/doc/book/pipeline/syntax/#input) | [`inputs`](/actions/automating-your-workflow-with-github-actions/metadata-syntax-for-github-actions#inputs) | +| [`when`](https://jenkins.io/doc/book/pipeline/syntax/#when) | [`jobs..if`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idif) | + + +### シーケンシャルなステージの利用 + +#### 並列なジョブの処理 + +Jenkinsは`ステージ`と`ステップ`を並行して実行できますが、{% data variables.product.prodname_actions %}が並行に処理できるのは現時点ではジョブだけです。 + +| Jenkinsの並列処理 | {% data variables.product.prodname_actions %} +| ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`parallel`](https://jenkins.io/doc/book/pipeline/syntax/#parallel) | [`jobs..strategy.max-parallel`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymax-parallel) | + +#### ビルドマトリックス + +{% data variables.product.prodname_actions %}とJenkinsはどちらも、ビルドマトリックスを使って様々なシステムの組み合わせを定義できます。 + +| Jenkins | {% data variables.product.prodname_actions %} +| ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`axis`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-axes) | [`strategy/matrix`](/actions/learn-github-actions/managing-complex-workflows/#using-a-build-matrix)
    [`context`](/actions/reference/context-and-expression-syntax-for-github-actions) | +| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages) | [`steps-context`](/actions/reference/context-and-expression-syntax-for-github-actions#steps-context) | +| [`excludes`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages) | | + +#### ステップを使ったタスクの実行 + +Jenkinsは`ステップ`をまとめて`ステージ`にグループ化します。 それらの各ステップは、スクリプト、関数、コマンドなどです。 同様に、{% data variables.product.prodname_actions %}は`ジョブ`を使って特定の`ステップ`のグループを実行します。 + +| Jenkinsのステップ | {% data variables.product.prodname_actions %} +| --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | +| [`script`](https://jenkins.io/doc/book/pipeline/syntax/#script) | [`jobs..steps`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idsteps) | + +### 一般的なタスクの例 + +#### `cron`で実行するようパイプラインをスケジュール + + + + + + + + + + +
    +Jenkinsのパイプライン + +{% data variables.product.prodname_actions %}のワークフロー +
    + + ```yaml + pipeline { + agent any + triggers { + cron('H/15 * * * 1-5') + } + } + ``` + + + + ```yaml + on: + schedule: + - cron: '*/15 * * * 1-5' + ``` + +
    + +#### パイプライン中での環境変数の設定 + + + + + + + + + + +
    +Jenkinsのパイプライン + +{% data variables.product.prodname_actions %}のワークフロー +
    + + ```yaml + pipeline { + agent any + environment { + MAVEN_PATH = '/usr/local/maven' + } + } + ``` + + + + ```yaml + jobs: + maven-build: + env: + MAVEN_PATH: '/usr/local/maven' + + ``` + +
    + +#### 上流のプロジェクトからのビルド + + + + + + + + + + +
    +Jenkinsのパイプライン + +{% data variables.product.prodname_actions %}のワークフロー +
    + + ```yaml + pipeline { + triggers { + upstream( + upstreamProjects: 'job1,job2', + threshold: hudson.model.Result.SUCCESS) + } + } + } + + ``` + + + + ```yaml + jobs: + job1: + job2: + needs: job1 + job3: + needs: [job1, job2] + + ``` + +
    + +#### 複数のオペレーティングシステムでのビルド + + + + + + + + + + +
    +Jenkinsのパイプライン + +{% data variables.product.prodname_actions %}のワークフロー +
    + + ```yaml +pipeline { + agent none + stages { + stage('Run Tests') { + parallel { + stage('Test On MacOS') { + agent { label "macos" } + tools { nodejs "node-12" } + steps { + dir("scripts/myapp") { + sh(script: "npm install -g bats") + sh(script: "bats tests") + } + } + } + stage('Test On Linux') { + agent { label "linux" } + tools { nodejs "node-12" } + steps { + dir("script/myapp") { + sh(script: "npm install -g bats") + sh(script: "bats tests") + } + } + } + } + } + } +} + ``` + + + +{% raw %} + ```yaml + name: demo-workflow + on: + push: + jobs: + test: + runs-on: ${{ matrix.os }} + strategy: + fail-fast: false + matrix: + os: [macos-latest, ubuntu-latest] + steps: + - uses: actions/checkout@v1 + - uses: actions/setup-node@v1 + with: + node-version: 12 + - run: npm install -g bats + - run: bats tests + working-directory: scripts/myapp + ``` +{% endraw %} + +
    diff --git a/translations/ja-JP/content/actions/learn-github-actions/security-hardening-for-github-actions.md b/translations/ja-JP/content/actions/learn-github-actions/security-hardening-for-github-actions.md new file mode 100644 index 000000000000..a1291e657466 --- /dev/null +++ b/translations/ja-JP/content/actions/learn-github-actions/security-hardening-for-github-actions.md @@ -0,0 +1,97 @@ +--- +title: GitHub Actions のセキュリティ強化 +shortTitle: セキュリティ強化 +intro: '{% data variables.product.prodname_actions %} 機能を使用するための適切なセキュリティプラクティス。' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /actions/getting-started-with-github-actions/security-hardening-for-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +### 概要 + +このガイドでは、特定の {% data variables.product.prodname_actions %} 機能のセキュリティ強化を設定する方法について説明します。 {% data variables.product.prodname_actions %} の概念について理解を深めるには、「[GitHub Actions の中核的概念](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)」を参照してください。 + +### シークレットを使用する + +機密性の高い値は、平文としてワークフローファイルに保存するのではなく、シークレットとして保存してください。 [シークレット](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)は Organization またはリポジトリレベルで設定でき、機密情報を {% data variables.product.product_name %} に保存できます。 + +シークレットは [Libsodium sealed boxes](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes) を使用するため、{% data variables.product.product_name %} に到達する前に暗号化されます。 これは、[UI を使用](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets#creating-encrypted-secrets-for-a-repository)して、または [REST API](/rest/reference/actions#secrets) を介してシークレットが送信されたときに発生します。 このクライアント側の暗号化により、{% data variables.product.product_name %} のインフラストラクチャ内での偶発的なログ（例外ログやリクエストログなど）に関連するリスクを最小限に抑えることができます。 シークレットがアップロードされると、{% data variables.product.product_name %} はそれを復号化して、ワークフローランタイムに挿入できるようになります。 + +偶発的な開示を防ぐために、{% data variables.product.product_name %} は、実行ログに表示されるシークレットを編集しようとするメカニズムを使用しています。 この編集は、設定されたシークレットの完全一致、および Base64 などの値の一般的なエンコーディングを検索します。 ただし、シークレットの値を変換する方法は複数あるため、この編集は保証されません。 そのため、シークレットを確実に編集し、シークレットに関連する他のリスクを制限するために実行する必要がある、特定の予防的ステップと推奨事項は次のとおりです。 + +- **構造化データをシークレットとして使用しない** + - 非構造化データは、ログ内のシークレットの編集失敗の原因となる可能性があります。これは、編集が特定のシークレット値の完全一致を見つけることに大きく依存しているためです。 たとえば、JSON、XML、または YAML（または同様）の Blob を使用してシークレット値をカプセル化しないでください。シークレットが適切に編集される可能性が大幅に低下するためです。 代わりに、機密値ごとに個別のシークレットを作成します。 +- **ワークフロー内で使用されるすべてのシークレットを登録する** + - シークレットを使用してワークフロー内で別の機密値を生成する場合は、生成された値を正式に[シークレットとして登録](https://github.com/actions/toolkit/tree/main/packages/core#setting-a-secret)して、ログに表示されたときに編集されるようにする必要があります。 たとえば、秘密鍵を使用して署名済み JWT を生成し、Web API にアクセスする場合は、その JWT をシークレットとして登録してください。そうしない場合、ログ出力に入力されても編集されません。 + - シークレットの登録は、あらゆる種類の変換/エンコーディングにも適用されます。 シークレットが何らかの方法で変換された場合（Base64 や URL エンコードなど）、新しい値もシークレットとして登録してください。 +- **シークレットの処理方法を監査する** + - シークレットの使用方法を監査し、シークレットが想定どおりに処理されていることを確認します。 これを行うには、ワークフローを実行しているリポジトリのソースコードを確認し、ワークフローで使用されているアクションを確認します。 たとえば、意図しないホストに送信されていないか、またはログ出力に明示的に出力されていないかを確認します。 + - 有効/無効な入力をテストした後、ワークフローの実行ログを表示し、シークレットが正しく編集されているか、表示されていないかを確認します。 呼び出しているコマンドまたはツールがどのようにしてエラーを `STDOUT` および `STDERR` に送信するかは必ずしも明らかではなく、シークレットはその後エラーログに記録される可能性があります。 そのため、有効な入力と無効な入力をテストした後、ワークフローログを手動で確認することをお勧めします。 +- **スコープが最小限の資格情報を使用する** + - ワークフロー内で使用されている認証情報に必要な最小限の権限があることを確認し、リポジトリへの書き込みアクセスを持つすべてのユーザが、リポジトリで設定されたすべてのシークレットへの読み取りアクセスを持っていることに注意してください。 +- **登録されたシークレットの監査とローテーション** + - 登録されたシークレットを定期的に確認して、現在も必要であることを確認します。 不要になったものは削除してください。 + - シークレットを定期的にローテーションして、不正使用されたシークレットが有効である期間を短縮します。 + +### サードパーティアクションを使用する + +ワークフロー内の個々のジョブは、他のジョブと相互作用（および侵害）する場合があります。 たとえば、後のジョブで使用される環境変数をクエリするジョブ、後のジョブが処理する共有ディレクトリにファイルを書き込むジョブ、または Docker ソケットとやり取りして他の実行中のコンテナを検査してコマンドを実行することにより、さらに多くのディレクトリを作成するジョブなどです。 + +これは、ワークフロー内の 1 つのアクションへの侵害が非常に重要になる可能性があるということです。その侵害されたアクションがリポジトリに設定されたすべてのシークレットにアクセスし、`GITHUB_TOKEN` を使用してリポジトリに書き込むことができるためです。 したがって、{% data variables.product.prodname_dotcom %} のサードパーティリポジトリからアクションを調達することには大きなリスクがあります。 次のような適切な方法に従うことで、このリスクを軽減することができます。 + +* **アクションを完全なコミット SHA にピン止めする** + + 現在、アクションを不変のリリースとして使用する唯一の方法は、アクションを完全なコミット SHA にピン止めすることです。 特定の SHA にピン止めすると、有効な Git オブジェクトペイロードに対して SHA-1 衝突を生成する必要があるため、悪意のある人がアクションのリポジトリにバックドアを追加するリスクを軽減できます。 + + {% warning %} + + **警告:** コミット SHA の短いバージョンは安全ではないため、アクションの Git リファレンスの指定には使用しないでください。 リポジトリネットワークの仕組みにより、どのユーザもリポジトリをフォークし、短い SHA と衝突するよう細工されたコミットをプッシュできます。 これにより、その SHA の後続のクローンがあいまいなコミットになるため失敗します。 その結果、短縮された SHA を使用するワークフローはすぐに失敗します。 + + {% endwarning %} +* **アクションのソースコードを監査する** + + アクションが想定どおりにリポジトリとシークレットのコンテンツを処理していることを確認します。 たとえば、シークレットが意図しないホストに送信されていないか、または誤ってログに記録されていないかを確認します。 + +* **作成者を信頼できる場合に限り、アクションをタグにピン止めする** + + コミット SHA に対するピン止めが最も安全なオプションですが、タグを指定する方が便利で広く使用されています。 タグを指定する場合は、アクションの作成者が信頼できることを確認してください。 {% data variables.product.prodname_marketplace %} の「Verified creator」バッジは便利な判断材料で、 {% data variables.product.prodname_dotcom %} で身元が確認されたチームによって作成されたアクションであることを示しています。 作者が信頼できる場合でも、このアプローチにはリスクがあることに注意してください。悪意のある人がアクションを保存しているリポジトリにアクセスすると、タグが移動または削除される可能性があります。 + +### リポジトリ間のアクセスを検討する + +{% data variables.product.product_name %} は、意図的に一度に単一のリポジトリに対してスコープされます。 ワークフロー環境で使用される `GITHUB_TOKEN` は、書き込みアクセスユーザと同じレベルのアクセスを許可します。書き込みアクセスを持つユーザは、ワークフローファイルを作成または変更することによってこのトークンにアクセスできるためです。 ユーザはリポジトリごとに特定の権限を持っているため、1 つのリポジトリの `GITHUB_TOKEN` に別のリポジトリへのアクセスを許可すると、慎重に実装しない場合 {% data variables.product.prodname_dotcom %} 権限モデルに影響します。 同様に、{% data variables.product.prodname_dotcom %} 認証トークンをワークフロー環境に追加する場合は注意が必要です。これは、コラボレータに誤って広範なアクセスを付与することにより、{% data variables.product.prodname_dotcom %} アクセス許可モデルにも影響を与える可能性があるためです。 + +[{% data variables.product.prodname_dotcom %} ロードマップ](https://github.com/github/roadmap/issues/74)では、{% data variables.product.product_name %} 内のリポジトリ間アクセスを可能にするフローをサポートする計画がありますが、この機能はまだサポートされていません。 現在、権限のあるリポジトリ間のやり取りを実行する唯一の方法は、ワークフロー環境内に {% data variables.product.prodname_dotcom %} 認証トークンまたは SSH キーをシークレットとして配置することです。 多くの認証トークンタイプでは特定のリソースへの詳細なアクセスが許可されていないことから、意図したものよりはるかに広範なアクセスを許可できるため、間違ったトークンタイプを使用すると重大なリスクが生じます。 + +次のリストでは、ワークフロー内のリポジトリデータにアクセスするための推奨アプローチを優先度の高い順に説明しています。 + +1. **ワークフロー環境の `GITHUB_TOKEN`** + - このトークンは、ワークフローを呼び出した単一のリポジトリに意図的にスコープが設定されており、リポジトリの書き込みアクセスユーザと同じレベルのアクセス権を持っています。 トークンは各ジョブが開始する前に作成され、ジョブが終了すると期限切れになります。 詳しい情報については「[GITHUB_TOKENでの認証](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)」を参照してください。 + - 可能な場合は、常に `GITHUB_TOKEN` を使用する必要があります。 +2. **リポジトリのデプロイキー** + - デプロイキーは、単一のリポジトリへの読み取りまたは書き込みアクセスを許可する唯一の認証情報タイプの 1 つであり、ワークフロー内の別のリポジトリとのやり取りに使用できます。 詳しい情報については、「[デプロイキーを管理する](/developers/overview/managing-deploy-keys#deploy-keys)」を参照してください。 + - デプロイキーは Git を使用してリポジトリに複製およびプッシュできるだけであり、REST または GraphQL API とのやり取りには使用できないため、要件に適さない場合があることに注意してください。 +3. **{% data variables.product.prodname_github_app %} トークン** + - {% data variables.product.prodname_github_apps %} は、選択したリポジトリにインストールでき、リポジトリ内のリソースに対する詳細な権限を持つこともできます。 Organization の内部で {% data variables.product.prodname_github_app %} を作成し、ワークフロー内でアクセスする必要があるリポジトリにインストールして、それらのリポジトリにアクセスするためのワークフロー内のインストールとして認証できます。 +4. **個人アクセストークン** + - 自分のアカウントから個人アクセストークンを使用しないでください。 これらのトークンは、アクセスできる Organization 内のすべてのリポジトリ、およびユーザアカウントのすべての個人リポジトリへのアクセスを許可します。 これにより、ワークフローが含まれているリポジトリのすべての書き込みアクセスユーザに間接的に広範なアクセス権が付与されます。 さらに、後で Organization を離れると、このトークンを使用するワークフローはすぐに中断され、この問題のデバッグが困難になる場合があります。 + - 個人アクセストークンを使用する場合は、ワークフローに必要な特定のリポジトリへのアクセスのみが許可される新しいアカウント用に生成されたものを使用してください。 このアプローチはスケーラブルではないため、デプロイキーなどの代替案を優先して避ける必要があります。 +5. **ユーザアカウントの SSH キー** + - ワークフローでは、ユーザアカウントの SSH キーを使用しないでください。 これらは、個人アクセストークンと同様に、すべての個人リポジトリと、Organization のメンバーシップを通じてアクセスできるすべてのリポジトリに読み取り/書き込み権限を付与します。 これにより、ワークフローが含まれているリポジトリのすべての書き込みアクセスユーザに間接的に広範なアクセス権が付与されます。 リポジトリのクローンまたはプッシュのみを実行する必要があり、パブリック API とやり取りする必要がないため、SSH キーを使用する場合は、代わりに個別のデプロイキーを使用する必要があります。 + +### セルフホストランナーを強化する + +**{% data variables.product.prodname_dotcom %} でホストされた**ランナーは、一過性でクリーンな隔離された仮想マシン内でコードを実行します。つまり、この環境を永続的に危険にさらしたり、ブートストラッププロセス中にこの環境に置かれた以上の情報にアクセスしたりする方法はありません。 + +**{% data variables.product.product_name %} のセルフホスト**ランナーは、一過性でクリーンな仮想マシンでの実行に関する保証がなく、ワークフロー内の信頼されていないコードによって永続的に侵害される可能性があります。 + +そのため、[{% data variables.product.product_name %} のパブリックリポジトリにセルフホストランナーを使用することはほとんどありません](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories)。これは、ユーザがリポジトリに対してプルリクエストを開き、環境を危険にさらす可能性があるためです。 同様に、プライベートリポジトリでセルフホストランナーを使用する場合は注意してください。リポジトリをフォークして PR を開くことができるユーザ（一般にリポジトリへの読み取りアクセス権を持つユーザ）は、シークレットへのアクセスと、リポジトリへの書き込みアクセス許可を付与する、より特権的な `GITHUB_TOKEN` を取得して、セルフホストのランナー環境を危険にさらすことができるためです。 + +次のように、セルフホストランナーマシンの環境も考慮する必要があります。 +- セルフホストランナーとして設定されたマシンにはどのような機密情報が存在するか。 たとえば、SSH 秘密鍵、API アクセストークンなどです。 +- マシンが機密性の高いサービスにネットワークアクセス可能か。 たとえば、Azure または AWS メタデータサービスなどです。 この環境での機密情報量は最小限に抑える必要があります。ワークフローを呼び出すことができるすべてのユーザがこの環境にアクセスできることを常に意識しておいてください。 diff --git a/translations/ja-JP/content/actions/learn-github-actions/sharing-workflows-with-your-organization.md b/translations/ja-JP/content/actions/learn-github-actions/sharing-workflows-with-your-organization.md new file mode 100644 index 000000000000..84b72b4d0bab --- /dev/null +++ b/translations/ja-JP/content/actions/learn-github-actions/sharing-workflows-with-your-organization.md @@ -0,0 +1,112 @@ +--- +title: Sharing workflows with your organization +shortTitle: Sharing workflows with your organization +intro: 'Learn how you can use organization features to collaborate with your team, by sharing workflow templates, secrets, and self-hosted runners.' +redirect_from: + - /actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +### 概要 + +If you need to share workflows and other {% data variables.product.prodname_actions %} features with your team, then consider collaborating within a {% data variables.product.prodname_dotcom %} organization. An organization allows you to centrally store and and manage secrets, artifacts, and self-hosted runners. You can also create workflow templates in the `.github` repository and share them with other users in your organization. + +### ワークフロー テンプレートの作成 + +ワークフローテンプレートは、組織の `.github` リポジトリへの書き込みアクセス権を持つユーザーによって作成できます。 その後、ワークフローを作成する権限を持つ組織メンバーがテンプレートを使用できます。 ワークフロー テンプレートを使用すると、組織のパブリック リポジトリに新しいワークフローを作成できます。テンプレートを使用してプライベートリポジトリにワークフローを作成するには、組織がエンタープライズプランまたはGitHub Oneプランの一部である必要があります。 + +この手順では、ワークフロー テンプレートとメタデータ ファイルを作成する方法を示します。 メタデータ ファイルには、ユーザーが新しいワークフローを作成するときにテンプレートがどのように表示されるかについて説明します。 + +1. 存在しない場合は、組織内で .github `という名前の新しいパブリック リポジトリを作成します。 +
  • ワークフロー テンプレートという名前のディレクトリ 作成`。 +1. `ワークフローテンプレート` ディレクトリ内に新しいワークフローファイルを作成します。 + + リポジトリのデフォルトブランチを参照する必要がある場合は、 `$default-branch` プレースホルダを使用できます。 テンプレートを使用してワークフローを作成すると、プレースホルダはリポジトリのデフォルトブランチの名前に自動的に置き換えられます。 + + たとえば、octo-organization-ci.yml `名前のこのファイルは、基本的なワークフローを示しています。 +
       name: Octo Organization CI
+
+   :
+     プッシュ:
+       ブランチ: [ $default-ブランチ ]
+     pull_request:
+       ブランチ: [ $default-ブランチ]
+
+   ジョブ:
+     ビルド:
+       実行: ubuntu-最新
+
+       ステップ:
+       - 使用: アクション/checkout@v2
+
+       - 名前: 1 行スクリプトを実行
+         実行します: Octo Organization から hello をエコーします
+`
    +1. `ワークフローテンプレート` ディレクトリ内にメタデータファイルを作成します。 メタデータ ファイルは、ワークフロー ファイルと同じ名前である必要がありますが、 `.yml` 拡張子の代わりに、 `.properties.json`を付ける必要があります。 たとえば、octo-organization-ci.properties.json `名前のこのファイルには` 、octo-organization-ci.yml`名前のワークフローファイルのメタデータが含まれています。 +
       { "名前"
+       " " " " " " " " " "説明"
+       " "説明" " " "" "アイコン"
+       " "example-icon"
+       "" "  "" "
+       " " [
+           "go"  ]
+       "filePatterns" [
+           "package.json$" 」
+   
+       
+           、
+           "^Dockerfile"
+`
    + * `名` - 必須 **。** ワークフロー テンプレートの名前。 これは、使用可能なテンプレートの一覧に表示されます。 + * `説明` - 必須 **。** ワークフロー テンプレートの説明。 これは、使用可能なテンプレートの一覧に表示されます。 + * `アイコン名前` - 必須 **。** テンプレート リスト内のワークフローのエントリのアイコンを定義します。 `iconName` は、同じ名前の SVG アイコンである必要があり、 `ワークフローテンプレート` ディレクトリに格納する必要があります。 たとえば、example-icon.svg `名前の SVG ファイルは、 例アイコン`として参照されます。 + * `カテゴリ` - オプション **。** ワークフローの言語カテゴリを定義します。 ユーザーが使用可能なテンプレートを表示すると、同じ言語に一致するテンプレートの機能が顕著になります。 使用可能な言語カテゴリについては、「https://github.com/github/linguist/blob/master/lib/linguist/languages.yml」を参照してください。 + * `ファイルパターン` - オプション **。** 定義された正規表現に一致するファイルがユーザーのリポジトリのルート ディレクトリにある場合に、テンプレートを使用できるようにします。 + +別のワークフロー テンプレートを追加するには、同じ `ワークフロー テンプレート` ディレクトリにファイルを追加します。 例: + +![ワークフロー テンプレート ファイル](/assets/images/help/images/workflow-template-files.png) + +### ワークフロー テンプレートの使用 + +この手順では、組織のメンバーがワークフロー テンプレートを検索して使用して新しいワークフローを作成する方法を示します。 組織のワークフロー テンプレートは、組織のメンバーであるすべてのユーザーが使用できます。 + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. リポジトリに既存のワークフローが既に存在する場合: 左上隅にある [新しいワークフロー**] をクリックします。 ![新規ワークフローの選択](/assets/images/help/repository/actions-new-workflow.png)

    • +1 +組織のワークフロー テンプレートは、組織名で作成されたワークフロー"というタイトルの独自 _セクションにあります。 使いたいテンプレート名の下で、**Set up this workflow（このワークフローをセットアップする）**をクリックしてください。 ![このワークフローを設定します](/assets/images/help/settings/actions-create-starter-workflow.png)

    + + +### Sharing secrets within an organization + +You can centrally manage your secrets within an organization, and then make them available to selected repositories. This also means that you can update a secret in one location, and have the change apply to all repository workflows that use the secret. + +組織でシークレットを作成する場合、ポリシーを使用して、そのシークレットにアクセスできるリポジトリを制限できます。 たとえば、すべてのリポジトリにアクセスを許可したり、プライベート リポジトリまたは指定したリポジトリ のリストのみにアクセスを制限したりできます。 + +{% data reusables.github-actions.permissions-statement-secrets-organization %} + +{% data reusables.organizations.navigate-to-org %} +{% data reusables.organizations.org_settings %} +{% data reusables.github-actions.sidebar-secret %} +1. [新しいシークレット ****] をクリックします。 +1. [名前] 入力ボックスにシークレットの名前 **入力します。 +1 シークレットの **値** を入力します。 +1 [ **リポジトリアクセス** ドロップダウン リストから、アクセス ポリシーを選択します。 +1 [**Add secret**] をクリックします。 + +### Share self-hosted runners within an organization + +Organization admins can add their self-hosted runners to groups, and then create policies that control which repositories can access the group. + +詳しい情報については、「[グループを使用したセルフホストランナーへのアクセスを管理する](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups)」を参照してください。 + + +### 次のステップ + +To continue learning about {% data variables.product.prodname_actions %}, see "[Security hardening for {% data variables.product.prodname_actions %}](/actions/learn-github-actions/security-hardening-for-github-actions)." diff --git a/translations/ja-JP/content/actions/managing-workflow-runs/adding-a-workflow-status-badge.md b/translations/ja-JP/content/actions/managing-workflow-runs/adding-a-workflow-status-badge.md new file mode 100644 index 000000000000..9a8473de6693 --- /dev/null +++ b/translations/ja-JP/content/actions/managing-workflow-runs/adding-a-workflow-status-badge.md @@ -0,0 +1,60 @@ +--- +title: ワークフローステータスバッジを追加する +intro: リポジトリにステータスバッジを表示して、ワークフローのステータスを示すことができます。 +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +{% data reusables.repositories.actions-workflow-status-badge-into %} + +ワークフローで `名` キーワードを使用する場合は、ワークフローを名前で参照する必要があります。 ワークフローの名前に空白が含まれている場合は、URL エンコード文字列 `%20`にスペースを置き換える必要があります。 `name` キーワードに関する詳しい情報については、「[{% data variables.product.prodname_actions %}のためのワークフローの構文](/articles/workflow-syntax-for-github-actions#name)」を参照してください。 + +``` +https://github.com///ワークフロー//badge.svg +``` + +または、ワークフローに `名が含まれていない場合`は、リポジトリのルート ディレクトリに対する相対ファイル パスを使用してワークフロー ファイルを参照する必要があります。 + +{% note %} + +**注意:** ワークフローに `名が含まれていない場合、ファイル パスを使用してワークフロー ファイルを参照`機能しません。 + +{% endnote %} + +``` +https://github.com///ワークフロー//badge.svg +``` + +### ワークフロー名を使用する + +この Markdown の例では、"すべてのユーザーを出す" という名前のワークフローのステータス バッジを追加します。 リポジトリの `OWNER` は、組織     `アクションであり、 リポジトリ` 名はハローワールド`。

    + +
    ![ワークフロー名の例](https://github.com/actions/hello-world/workflows/Greet%20E非常に一つ/バッジ.svg)
+`
    + +### ワークフローのファイルパスを使用する + +この Markdown の例では、ファイル パスを持つワークフローのステータス バッジを追加します `.github/workflow/main.yml`。 リポジトリの `OWNER` は、組織 `アクションであり、 リポジトリ` 名はハローワールド`。

    + +
    ![ワークフロー ファイルのパスの例](https://github.com/actions/hello-world/workflows/.github/workflows/main.yml/badge.svg)
+`
    + +### `branch` パラメータを使用する + +この Markdown の例では、機能 1の名前 `分岐のステータス バッジを追加します。

    + +
    ![分岐パラメータの例](https://github.com/actions/hello-world/workflows/Greet%20E非常に一人/バッジ.svg?ブランチ=フィーチャー-1)
+`
    + +### `event` パラメータを使用する + +この Markdown の例では、 `pull_request` イベントによってトリガーされたワークフロー実行の状態を示すバッジを追加します。 + +``` +![イベント パラメーターの例](https://github.com/actions/hello-world/workflows/Greet%20E非常に一人/バッジ.svg?イベント=pull_request) +``` diff --git a/translations/ja-JP/content/actions/managing-workflow-runs/canceling-a-workflow.md b/translations/ja-JP/content/actions/managing-workflow-runs/canceling-a-workflow.md new file mode 100644 index 000000000000..1dd6be4f0795 --- /dev/null +++ b/translations/ja-JP/content/actions/managing-workflow-runs/canceling-a-workflow.md @@ -0,0 +1,31 @@ +--- +title: ワークフローをキャンセルする +intro: '進行中のワークフロー実行をキャンセルできます。 ワークフロー実行をキャンセルすると、{% data variables.product.prodname_dotcom %} はそのワークフローの一部であるすべてのジョブとステップをキャンセルします。' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +{% data reusables.repositories.permissions-statement-write %} + +### ワークフローの実行をキャンセルする + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. ワークフローの右上隅にある [**ワークフローのキャンセル**] をクリックします。 ![[Cancel check suite] ボタン](/assets/images/help/repository/cancel-check-suite.png) + +### ワークフロー実行をキャンセルするために {% data variables.product.prodname_dotcom %} が実行するステップ + +ワークフローの実行をキャンセルする場合、ワークフローの実行に関連するリソースを使用する他のソフトウェアを実行している可能性があります。 ワークフロー実行に関連するリソースを解放するため、{% data variables.product.prodname_dotcom %} がワークフロー実行をキャンセルする際のステップを知っておくと役立つ場合があります。 + +1. ワークフローの実行をキャンセルするには、現在実行中のすべてのジョブに対して条件 `を再評価します。 条件が true`に評価 `場合、ジョブはキャンセルされません。 例えば、条件 : always()` が true と評価され、ジョブの実行が継続されます。 条件がない場合、前のステップが正常に終了した場合にのみ実行される条件 `の条件と同等です`。 +2. キャンセルする必要があるジョブについては、サーバーは、キャンセルする必要があるジョブを持つすべてのランナー マシンにキャンセル メッセージを送信します。 +3. 実行を継続するジョブの場合、サーバーは、未完了のステップの条件 場合、 `を再評価します。 条件が true`に `評価された場合、ステップは引き続き実行されます。 +
  • キャンセルが必要なステップの場合、ランナーマシンは、ステップのエントリープロセスに SIGINT/Ctrl-C` を送信します(javascriptアクションの`ノード` 、コンテナアクションのドッカー を `、ステップで実行` `を使用する場合は のbash/cmd/pwd` を送信します)。 プロセスが 7500 ミリ秒以内に終了しない場合、ランナーは `SIGTERM/Ctrl-Break` をプロセスに送信し、プロセスが終了するまで 2500 ミリ秒待ちます。 プロセスがまだ実行中の場合、ランナーはプロセスツリーを強制終了します。 +5. 5 分間のキャンセル タイムアウト期間が経過すると、サーバーは、実行を完了しないか、キャンセルプロセスを完了できなかったすべてのジョブとステップを強制的に終了します。 diff --git a/translations/ja-JP/content/actions/managing-workflow-runs/deleting-a-workflow-run.md b/translations/ja-JP/content/actions/managing-workflow-runs/deleting-a-workflow-run.md new file mode 100644 index 000000000000..fbddb708feb3 --- /dev/null +++ b/translations/ja-JP/content/actions/managing-workflow-runs/deleting-a-workflow-run.md @@ -0,0 +1,23 @@ +--- +title: ワークフロー実行の削除 +intro: '完了した、または 2 週間以上経過したワークフロー実行を削除できます。' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +{% data reusables.repositories.permissions-statement-write %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +1. ワークフロー実行を削除するには、[ {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} ] ドロップダウン メニューを使用して、[ワークフローの削除 ****を実行する] を選択します。 + + ![ワークフロー実行の削除](/assets/images/help/settings/workflow-delete-run.png) +2. 確認プロンプトを確認し、[はい、このワークフロー実行を完全に削除 **をクリックします。

    + + ![ワークフロー実行確認の削除](/assets/images/help/settings/workflow-delete-run-confirmation.png)
    • diff --git a/translations/ja-JP/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md b/translations/ja-JP/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md new file mode 100644 index 000000000000..afcf83474940 --- /dev/null +++ b/translations/ja-JP/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md @@ -0,0 +1,45 @@ +--- +title: Disabling and enabling a workflow +intro: '{% data variables.product.prodname_dotcom %} または REST API を使用して、ワークフローを無効化したり、再度有効化したりすることができます。' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.23' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +Disabling a workflow allows you to stop a workflow from being triggered without having to delete the file from the repo. You can easily re-enable the workflow again on {% data variables.product.prodname_dotcom %}. REST API を使用して、ワークフローを無効化または有効化することもできます。 詳しい情報については、「[アクション REST API](/rest/reference/actions#workflows)」を参照してください。 + +Temporarily disabling a workflow can be useful in many scenarios. These are a few examples where disabling a workflow might be helpful: + +- A workflow error that produces too many or wrong requests, impacting external services negatively. +- A workflow that is not critical and is consuming too many minutes on your account. +- A workflow that sends requests to a service that is down. +- Workflows on a forked repository that aren't needed (for example, scheduled workflows). + +{% warning %} + +**警告：** {% data reusables.actions.scheduled-workflows-disabled %} + +{% endwarning %} + +### Disabling a workflow + +You can manually disable a workflow so that it won't execute any workflow runs. A disabled workflow is not deleted, and can be re-enabled. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. In the left sidebar, click the workflow you want to disable. ![アクション選択ワークフロー](/assets/images/actions-select-workflow.png) +1. Click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}. ![actions kebab menu](/assets/images/help/repository/actions-workflow-menu-kebab.png) +1. Click **Disable workflow**. ![actions disable workflow](/assets/images/help/repository/actions-disable-workflow.png) The disabled workflow is marked {% octicon "stop" aria-label="The stop icon" %} to indicate its status. ![actions list disabled workflow](/assets/images/help/repository/actions-find-disabled-workflow.png) + +### Enabling a workflow + +You can re-enable a workflow that was previously disabled. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. In the left sidebar, click the workflow you want to enable. ![actions select disabled workflow](/assets/images/help/repository/actions-select-disabled-workflow.png) +1. Click **Enable workflow**. ![actions enable workflow](/assets/images/help/repository/actions-enable-workflow.png) diff --git a/translations/ja-JP/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md b/translations/ja-JP/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md new file mode 100644 index 000000000000..ddfd6150e183 --- /dev/null +++ b/translations/ja-JP/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md @@ -0,0 +1,22 @@ +--- +title: Downloading workflow artifacts +intro: アーカイブされたアーティファクトは、自動的に有効期限切れになる前にダウンロードできます。 +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}デフォルトでは、{% data variables.product.product_name %} はビルドログとアーティファクトを 90 日間保存します。リポジトリのタイプに応じて、この保持期間をカスタマイズできます。 詳しい情報については、「[リポジトリ内の GitHub Actions アーティファクトとログの保持期間を設定する](/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository)」を参照してください。{% endif %} +{% if currentVersion == "enterprise-server@2.22" %} {% data variables.product.product_name %} には、完全なビルドログとアーティファクトが 90 日間保存されます。{% endif %} + +{% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. Under **Artifacts**, click the artifact you want to download. ![成果物のダウンロードのドロップダウンメニュー](/assets/images/help/repository/artifact-drop-down.png) diff --git a/translations/ja-JP/content/actions/managing-workflow-runs/enabling-debug-logging.md b/translations/ja-JP/content/actions/managing-workflow-runs/enabling-debug-logging.md new file mode 100644 index 000000000000..6b1ced34d347 --- /dev/null +++ b/translations/ja-JP/content/actions/managing-workflow-runs/enabling-debug-logging.md @@ -0,0 +1,38 @@ +--- +title: デバッグロギングの有効化 +intro: 'ワークフロージョブあるいはステップが期待どおりに動作しない理由を診断する上で、十分な詳細がワークフローのログになかった場合、追加のデバッグロギングを有効化できます。' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +これらの追加ログは、ワークフローを含むリポジトリにシークレットを設定することで有効になるため、同じ権限要件が適用されます。 + +- {% data reusables.github-actions.permissions-statement-secrets-repository %} +- {% data reusables.github-actions.permissions-statement-secrets-organization %} +- {% data reusables.github-actions.permissions-statement-secrets-api %} + +シークレットの設定に関する詳しい情報については、「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 + +### ランナーの診断ロギングの有効化 + +ランナーの診断ログは、ランナーによるジョブの実行の様子に関する情報を含む追加のログファイルを提供します。 ログアーカイブには、2つのログファイルが追加されます。 + +* ランナープロセスログにはジョブの実行のためのランナーの調整とセットアップに関する情報が含まれます。 +* ワーカープロセスログには、ジョブの実行が記録されます。 + +1. ランナー診断ロギングを有効化するには、ワークフローを含むリポジトリ内で以下のシークレットを設定してください： `ACTIONS_RUNNER_DEBUG`を`true`にしてください。 + +1. ランナーの診断ログをダウンロードするには、ワークフローの実行のログアーカイブをダウンロードしてください。 ランナーの診断ログは`runner-diagnostic-logs`フォルダに含まれています。 ログのダウンロードに関する詳しい情報については「[ログのダウンロード](/actions/managing-workflow-runs/using-workflow-run-logs/#downloading-logs)」を参照してください。 + +### ステップのデバッグロギングの有効化 + +ステップのデバッグロギングは、ジョブの実行の間と実行後のジョブのログの詳細度を高めます。 + +1. ステップのデバッグロギングを有効化するには、ワークフローを含むリポジトリで以下のシークレットを設定しなければなりません： `ACTIONS_STEP_DEBUG`を`true`にしてください。 + +1. このシークレットを設定すると、ステップログにより多くのデバッグイベントが示されるようになります。 詳しい情報については「[障害の診断のためのログの閲覧](/actions/managing-workflow-runs/using-workflow-run-logs/#viewing-logs-to-diagnose-failures)」を参照してください。 diff --git a/translations/ja-JP/content/actions/managing-workflow-runs/index.md b/translations/ja-JP/content/actions/managing-workflow-runs/index.md new file mode 100644 index 000000000000..c7011ffc4ef4 --- /dev/null +++ b/translations/ja-JP/content/actions/managing-workflow-runs/index.md @@ -0,0 +1,32 @@ +--- +title: Managing workflow runs +shortTitle: Managing workflow runs +intro: 'ワークフローの各ステップのステータスと結果の表示、保留中のワークフローのキャンセル、請求可能なジョブ実行時間の表示、失敗したワークフローのデバッグと再実行、ログの検索とダウンロード、アーティファクトのダウンロードを行うことができます。' +redirect_from: + - /actions/configuring-and-managing-workflows/managing-a-workflow-run + - /articles/viewing-your-repository-s-workflows + - /articles/viewing-your-repositorys-workflows + - /articles/managing-a-workflow-run + - /github/automating-your-workflow-with-github-actions/managing-a-workflow-run + - /actions/automating-your-workflow-with-github-actions/managing-a-workflow-run + - /actions/configuring-and-managing-workflows/configuring-and-managing-workflow-files-and-runs +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +{% link_in_list /viewing-workflow-run-history %} +{% link_in_list /using-workflow-run-logs %} +{% link_in_list /manually-running-a-workflow %} +{% link_in_list /re-running-a-workflow %} +{% link_in_list /canceling-a-workflow %} +{% link_in_list /disabling-and-enabling-a-workflow %} +{% link_in_list /deleting-a-workflow-run %} +{% link_in_list /viewing-job-execution-time %} +{% link_in_list /downloading-workflow-artifacts %} +{% link_in_list /removing-workflow-artifacts %} +{% link_in_list /enabling-debug-logging %} +{% link_in_list /adding-a-workflow-status-badge %} diff --git a/translations/ja-JP/content/actions/managing-workflow-runs/manually-running-a-workflow.md b/translations/ja-JP/content/actions/managing-workflow-runs/manually-running-a-workflow.md new file mode 100644 index 000000000000..c5265ebf5383 --- /dev/null +++ b/translations/ja-JP/content/actions/managing-workflow-runs/manually-running-a-workflow.md @@ -0,0 +1,31 @@ +--- +title: ワークフローの手動実行 +intro: 'When a workflow is configured to run on the `workflow_dispatch` event, you can run the workflow using the REST API or from the Actions tab on {% data variables.product.prodname_dotcom %}.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +To run a workflow manually, the workflow must be configured to run on the `workflow_dispatch` event. 詳しい情報については、「[ワークフローをトリガーするイベント](/actions/reference/events-that-trigger-workflows)」を参照してください。 + +### Running a workflow on {% data variables.product.prodname_dotcom %} + +{% data variables.product.prodname_dotcom %} で `workflow_dispatch` イベントをトリガーするには、ワークフローがデフォルトブランチに含まれている必要があります。 ワークフローの実行を手動でトリガーするには、次の手順に従います。 + +{% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. 左側のサイドバーで、実行するワークフローをクリックします。 ![アクション選択ワークフロー](/assets/images/actions-select-workflow.png) +1. ワークフロー実行の一覧の上にある [ワークフローの実行 ****を実行する] を選択します。 ![アクション ワークフローのディスパッチ](/assets/images/actions-workflow-dispatch.png) +1. ワークフローを実行する分岐を選択し、ワークフローで使用される入力パラメータを入力します。 [ ワークフロー**実行 ] をクリックします。 ![アクションはワークフローを手動で実行します](/assets/images/actions-manually-run-workflow.png)

    + +### Running a workflow using the REST API + +REST API を使用する場合は、 `入力` を構成し、要求本文パラメーターとして ref     します。 入力を省略すると、ワークフロー ファイルで定義されている既定値が使用されます。

    + +

    REST API の使用の詳細については、「ワークフローディスパッチ イベントの作成」を参照してください。

    diff --git a/translations/ja-JP/content/actions/managing-workflow-runs/re-running-a-workflow.md b/translations/ja-JP/content/actions/managing-workflow-runs/re-running-a-workflow.md new file mode 100644 index 000000000000..c33fb907291b --- /dev/null +++ b/translations/ja-JP/content/actions/managing-workflow-runs/re-running-a-workflow.md @@ -0,0 +1,19 @@ +--- +title: Re-running a workflow +intro: You can re-run an instance of a workflow. Re-running a workflow uses the same `GITHUB_SHA` (commit SHA) and `GITHUB_REF` (Git ref) of the original event that triggered the workflow run. +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +{% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. In the upper-right corner of the workflow, use the **Re-run jobs** drop-down menu, and select **Re-run all jobs**. ![[Re-run checks] ドロップダウンメニュー](/assets/images/help/repository/rerun-checks-drop-down.png) diff --git a/translations/ja-JP/content/actions/managing-workflow-runs/removing-workflow-artifacts.md b/translations/ja-JP/content/actions/managing-workflow-runs/removing-workflow-artifacts.md new file mode 100644 index 000000000000..fc1449ed6b16 --- /dev/null +++ b/translations/ja-JP/content/actions/managing-workflow-runs/removing-workflow-artifacts.md @@ -0,0 +1,41 @@ +--- +title: Removing workflow artifacts +intro: '{% data variables.product.product_name %} で期限切れになる前にアーティファクトを削除することで、使用済みの {% data variables.product.prodname_actions %} ストレージを再利用できます。' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +### アーティファクトを削除する + +{% warning %} + +**警告:** いったん削除された成果物をリストアすることはできません。 + +{% endwarning %} + +{% data reusables.repositories.permissions-statement-write %} + +{% data reusables.github-actions.artifact-log-retention-statement %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. Under **Artifacts**, click {% octicon "trashcan" aria-label="The trashcan icon" %} next to the artifact you want to remove. ![成果物の削除のドロップダウンメニュー](/assets/images/help/repository/actions-delete-artifact.png) + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +### アーティファクトの保持期間を設定する + +アーティファクトとログの保持期間は、リポジトリ、Organization、および Enterprise レベルで設定できます。 詳しい情報については、「[使用制限、支払い、および管理](/actions/reference/usage-limits-billing-and-administration#artifact-and-log-retention-policy)」を参照してください。 + +ワークフローの `actions/upload-artifact` アクションを使用して、個々のアーティファクトのカスタム保持期間を定義することもできます。 詳しい情報については、「[ワークフローデータをアーティファクトとして保存する](/actions/guides/storing-workflow-data-as-artifacts#configuring-a-custom-artifact-retention-period)」を参照してください。 + +### アーティファクトの有効期限を探す + +API を使用して、アーティファクトの削除がスケジュールされている日付を確認できます。 詳しい情報については、「[リポジトリのアーティファクトの一覧表示](/rest/reference/actions#artifacts)」によって返される `expires_at` 値を参照してください。 +{% endif %} \ No newline at end of file diff --git a/translations/ja-JP/content/actions/managing-workflow-runs/using-workflow-run-logs.md b/translations/ja-JP/content/actions/managing-workflow-runs/using-workflow-run-logs.md new file mode 100644 index 000000000000..15ece802c5a1 --- /dev/null +++ b/translations/ja-JP/content/actions/managing-workflow-runs/using-workflow-run-logs.md @@ -0,0 +1,86 @@ +--- +title: Using workflow run logs +intro: 'You can view, search, and download the logs for each job in a workflow run.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +ワークフローの実行ページから、ワークフローの実行が進行中か完了しているかを確認できます。 パブリックなリポジトリの分も含むワークフローの実行情報を見るには、{% data variables.product.prodname_dotcom %}のアカウントにログインしなければなりません。 詳細は「[GitHub 上のアクセス権限](/articles/access-permissions-on-github)」を参照してください。 + +実行が完了している場合には、結果が成功か失敗か、キャンセルされたか、またはニュートラルかを確認できます。 実行が失敗した場合には、ビルドログを表示して検索し、失敗の原因を診断してワークフローを再実行することもできます。 また、課金対象のジョブ実行時間を表示したり、ログをダウンロードして成果物をビルドすることもできます。 + +{% data variables.product.prodname_actions %}は、Checks APIを使用してワークフローのステータス、結果、ログを出力します。 {% data variables.product.prodname_dotcom %} は、ワークフローの実行に対してそれぞれ新しいチェックスイートを作成します。 チェックスイートには、ワークフロー内の各ジョブに対するチェック実行が含まれ、各ジョブにはステップが含まれています。 {% data variables.product.prodname_actions %}は、ワークフローのステップとして実行されます。 チェック API の詳細については、「[チェック](/v3/checks/)」を参照してください。 + +{% data reusables.github-actions.invalid-workflow-files %} + +### ログを表示してエラーを診断する + +ワークフローの実行を失敗した場合には、どのステップが失敗の原因になったかを確認し、失敗したステップのビルドログを確かめてトラブルシューティングすることができます。 各ステップの実行にかかった時間もわかります。 ログファイルの特定の行のパーマリンクをコピーして、チームで共有することもできます。 {% data reusables.repositories.permissions-statement-read %} + +In addition to the steps configured in the workflow file, {% data variables.product.prodname_dotcom %} adds two additional steps to each job to set up and complete the job's execution. These steps are logged in the workflow run with the names "Set up job" and "Complete job". + +{% data variables.product.prodname_dotcom %}ホストランナー上のジョブの実行では、"Set up job"はランナーの仮想環境の詳細を記録し、ランナーマシン上にあったプリインストールされたツールのリストへのリンクを含みます。 + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +{% data reusables.repositories.navigate-to-job-superlinter %} +{% data reusables.repositories.view-failed-job-results-superlinter %} +{% data reusables.repositories.view-specific-line-superlinter %} + +### ログを検索する + +特定のステップのビルドログを検索できます。 ログを検索する際、展開されているステップのみが結果に含まれます。 {% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +{% data reusables.repositories.navigate-to-job-superlinter %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +1. ログ出力の右上隅にある [**Search logs**] 検索ボックスに、検索語句を入力します。 ![ログを検索するための検索ボックス](/assets/images/help/repository/search-log-box-updated.png) +{% else %} +1. 検索に含めたい各ステップを展開するには、そのステップをクリックします。![ステップの名前](/assets/images/help/repository/failed-check-step.png) +1. ログ出力の右上隅にある [**Search logs**] 検索ボックスに、検索語句を入力します。 ![ログを検索するための検索ボックス](/assets/images/help/repository/search-log-box.png) +{% endif %} + +### ログのダウンロード + +ワークフローの実行からは、ログファイルをダウンロードできます。 また、ワークフローの成果物もダウンロードできます。 詳しい情報については「[成果物を利用してワークフローのデータを永続化する](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)」を参照してください。 {% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +{% data reusables.repositories.navigate-to-job-superlinter %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +1. In the upper right corner, click +{% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} and select **Download log archive**. + ![[Download logs] ドロップダウンメニュー](/assets/images/help/repository/download-logs-drop-down-updated.png) +{% else %} +1. In the upper right corner, click +{% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} and select **Download log archive**. + ![[Download logs] ドロップダウンメニュー](/assets/images/help/repository/download-logs-drop-down.png) +{% endif %} + +### ログの削除 + +ワークフローの実行からログファイルを削除できます。 {% data reusables.repositories.permissions-statement-write %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +1. In the upper right corner, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}. ![Kebab-horizontal icon](/assets/images/help/repository/workflow-run-kebab-horizontal-icon-updated.png) +2. ログファイルを削除するには、**Delete all logs（すべてのログを削除）**ボタンをクリックして、確認の要求を見てください 。 ![Delete all logs](/assets/images/help/repository/delete-all-logs-updated.png) ログを削除すると、**Delete all logs（すべてのログを削除）**ボタンはなくなり、ワークフローの実行中にログファイルが残っていないことを示します。 +{% else %} +1. In the upper right corner, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}. ![Kebab-horizontal icon](/assets/images/help/repository/workflow-run-kebab-horizontal-icon.png) +2. ログファイルを削除するには、**Delete all logs（すべてのログを削除）**ボタンをクリックして、確認の要求を見てください 。 ![Delete all logs](/assets/images/help/repository/delete-all-logs.png) After the logs have been deleted, the **Delete all logs** button is removed to indicate that no log files remain in the workflow run. +{% endif %} diff --git a/translations/ja-JP/content/actions/managing-workflow-runs/viewing-job-execution-time.md b/translations/ja-JP/content/actions/managing-workflow-runs/viewing-job-execution-time.md new file mode 100644 index 000000000000..b17372dc547d --- /dev/null +++ b/translations/ja-JP/content/actions/managing-workflow-runs/viewing-job-execution-time.md @@ -0,0 +1,24 @@ +--- +title: Viewing job execution time +intro: 'ジョブの実行時間 (ジョブの発生した支払対象の分を含む) を表示できます。' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +Billable job execution minutes are only shown for jobs run on private repositories that use {% data variables.product.prodname_dotcom %}-hosted runners. There are no billable minutes when using {% data variables.product.prodname_actions %} in public repositories or for jobs run on self-hosted runners. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. Under the job summary, you can view the job's execution time. To view the billable job execution time, click **Run and billable time details**. ![実行および支払請求可能な時間の詳細リンク](/assets/images/help/repository/view-run-billable-time.png) + + {% note %} + + **注:** 表示される請求可能な時間には、丸めや分数の乗数は含まれません。 To view your total {% data variables.product.prodname_actions %} usage, including rounding and minute multipliers, see "[Viewing your {% data variables.product.prodname_actions %} usage](/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage)." + + {% endnote %} diff --git a/translations/ja-JP/content/actions/managing-workflow-runs/viewing-workflow-run-history.md b/translations/ja-JP/content/actions/managing-workflow-runs/viewing-workflow-run-history.md new file mode 100644 index 000000000000..4d75478ddc2f --- /dev/null +++ b/translations/ja-JP/content/actions/managing-workflow-runs/viewing-workflow-run-history.md @@ -0,0 +1,18 @@ +--- +title: Viewing workflow run history +intro: You can view logs for each run of a workflow. Logs include the status for each job and step in a workflow. +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +{% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} diff --git a/translations/ja-JP/content/actions/quickstart.md b/translations/ja-JP/content/actions/quickstart.md index b224277950ff..f22ebf039150 100644 --- a/translations/ja-JP/content/actions/quickstart.md +++ b/translations/ja-JP/content/actions/quickstart.md @@ -9,7 +9,7 @@ versions: enterprise-server: '>=2.22' --- -{% data reusables.actions.enterprise-beta %} +{% data variables.product.prodname_actions %} の支払いを管理する {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 ### はじめに @@ -55,11 +55,12 @@ Committing the workflow file in your repository triggers the `push` event and ru ### Viewing your workflow results +{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.actions-tab %} -1. 左のサイドバーで、表示させたいワークフローをクリックしてください。 ![左サイドバーのワークフローのリスト](/assets/images/help/repository/superlinter-workflow-sidebar.png) -1. From the list of workflow runs, click the name of the run you want to see. ![ワークフローの実行の名前](/assets/images/help/repository/superlinter-run-name.png) +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} 1. In the left sidebar, click the **Lint code base** job. ![Lint code base job](/assets/images/help/repository/superlinter-lint-code-base-job.png) -2. Expand the **Run Super-Linter** step to view the results. ![Super linter workflow results](/assets/images/help/repository/super-linter-workflow-results.png) +{% data reusables.repositories.view-failed-job-results-superlinter %} ### More starter workflows diff --git a/translations/ja-JP/content/actions/reference/authentication-in-a-workflow.md b/translations/ja-JP/content/actions/reference/authentication-in-a-workflow.md new file mode 100644 index 000000000000..e8cb006fa91b --- /dev/null +++ b/translations/ja-JP/content/actions/reference/authentication-in-a-workflow.md @@ -0,0 +1,100 @@ +--- +title: Authentication in a workflow +intro: '{% data variables.product.prodname_dotcom %}は、{% data variables.product.prodname_actions %}の代理で認証を受けるために利用できるトークンを提供します。' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /github/automating-your-workflow-with-github-actions/authenticating-with-the-github_token + - /actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token + - /actions/configuring-and-managing-workflows/authenticating-with-the-github_token +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +リポジトリに対して`write`アクセスがあるユーザなら、誰でもシークレットの作成、読み取りおよび使用ができます。 + +### `GITHUB_TOKEN`シークレットについて + +{% data variables.product.prodname_dotcom %}は、ワークフローで利用する`GITHUB_TOKEN`シークレットを自動的に生成します。 この`GITHUB_TOKEN`は、ワークフローの実行内での認証に利用できます。 + +{% data variables.product.prodname_actions %}を有効化すると、{% data variables.product.prodname_dotcom %}はリポジトリに{% data variables.product.prodname_github_app %}をインストールします。 `GITHUB_TOKEN`シークレットは、{% data variables.product.prodname_github_app %}インストールアクセストークンです。 このインストールアクセストークンは、リポジトリにインストールされた{% data variables.product.prodname_github_app %}の代わりに認証を受けるために利用できます このトークンの権限は、ワークフローを含むリポジトリに限定されます。 詳しい情報については「[`GITHUB_TOKEN`の権限](#permissions-for-the-github_token)」を参照してください。 + +各ジョブの開始前に、{% data variables.product.prodname_dotcom %} はジョブのインストールアクセストークンをフェッチします。 トークンはジョブが終了すると期限切れになります。 + +このトークンは、`github.token`コンテキストにもあります。 詳しい情報については、「[{% data variables.product.prodname_actions %} のコンテキストと式構文](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)」を参照してください。 + +### ワークフロー内での`GITHUB_TOKEN`の利用 + +`GITHUB_TOKEN`シークレットを利用するためには、ワークフローファイル内で参照しなければなりません。 トークンの利用には、そのトークンを要求するアクションへ入力としてそのトークンを渡すことや、認証を受けた{% data variables.product.prodname_dotcom %} APIコールの発行が含まれます。 + +{% data reusables.github-actions.actions-do-not-trigger-workflows %} + +#### `GITHUB_TOKEN`を入力として渡す例 + +以下のワークフローの例では[labeler action](https://github.com/actions/labeler)を使用しています。これには、`repo-token`入力パラメータの値として`GITHUB_TOKEN`を渡すことが必要です。 + + {% raw %} + ```yaml + name: Pull request labeler + on: + - pull_request + jobs: + triage: + runs-on: ubuntu-latest + steps: + - uses: actions/labeler@v2 + with: + repo-token: ${{ secrets.GITHUB_TOKEN }} + ``` + {% endraw %} + +#### REST APIの呼び出しの例 + +`GITHUB_TOKEN`を使って、認証されたAPIコールを発行できます。 以下のワークフローの例では、{% data variables.product.prodname_dotcom %} REST APIを使ってIssueを作成しています。 + + {% raw %} + ```yaml + name: Create issue on commit + on: + - push + jobs: + create_commit: + runs-on: ubuntu-latest + steps: + - name: Create issue using REST API + run: | + curl --request POST \ + --url https://api.github.com/repos/${{ github.repository }}/issues \ + --header 'authorization: Bearer ${{ secrets.GITHUB_TOKEN }}' \ + --header 'content-type: application/json' \ + --data '{ + "title": "Automated issue for commit: ${{ github.sha }}", + "body": "This issue was automatically created by the GitHub Action workflow **${{ github.workflow }}**. \n\n The commit hash was: _${{ github.sha }}_." + }' + ``` + {% endraw %} + +### `GITHUB_TOKEN`の権限 + +{% data variables.product.prodname_github_apps %} が各権限でアクセできる API エンドポイントについては、「[{% data variables.product.prodname_github_app %} の権限](/v3/apps/permissions/)」を参照してください。 + +| 権限 | アクセスタイプ | フォークしたリポジトリからのアクセス | +| ----------- | --------- | ------------------ | +| actions | 読み取り/書き込み | 読み取り | +| チェック | 読み取り/書き込み | 読み取り | +| コンテンツ | 読み取り/書き込み | 読み取り | +| デプロイメント | 読み取り/書き込み | 読み取り | +| issues | 読み取り/書き込み | 読み取り | +| メタデータ | 読み取り | 読み取り | +| パッケージ | 読み取り/書き込み | 読み取り | +| プルリクエスト | 読み取り/書き込み | 読み取り | +| リポジトリプロジェクト | 読み取り/書き込み | 読み取り | +| ステータス | 読み取り/書き込み | 読み取り | + +`GITHUB_TOKEN`で利用できない権限を要求するトークンが必要な場合は、個人アクセストークンを生成して、それをリポジトリのシークレットに設定できます。 + +1. リポジトリに対して適切な権限を持つトークンを利用もしくは生成してください。 詳しい情報については、「[個人アクセストークンを作成する](/github/authenticating-to-github/creating-a-personal-access-token)」を参照してください。 +1. ワークフローのリポジトリにそのトークンをシークレットとして追加し、 {%raw%}`${{ secrets.SECRET_NAME }}`{% endraw %}構文でそれを参照してください。 詳しい情報については、「[暗号化されたシークレットの作成と利用](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 diff --git a/translations/ja-JP/content/actions/reference/context-and-expression-syntax-for-github-actions.md b/translations/ja-JP/content/actions/reference/context-and-expression-syntax-for-github-actions.md index ce307dd94b9c..74f5ea370c65 100644 --- a/translations/ja-JP/content/actions/reference/context-and-expression-syntax-for-github-actions.md +++ b/translations/ja-JP/content/actions/reference/context-and-expression-syntax-for-github-actions.md @@ -5,7 +5,7 @@ intro: ワークフローおよびアクションにおいて、コンテキス product: '{% data reusables.gated-features.actions %}' redirect_from: - /articles/contexts-and-expression-syntax-for-github-actions - - /github/automating-your-workflow-with-github-actions/contexts-and-expression-syntax-for-github-actions + - /articles/contexts-and-expression-syntax-for-github-actions - /actions/automating-your-workflow-with-github-actions/contexts-and-expression-syntax-for-github-actions - /actions/reference/contexts-and-expression-syntax-for-github-actions versions: @@ -13,7 +13,7 @@ versions: enterprise-server: '>=2.22' --- -{% data reusables.actions.enterprise-beta %} +{% data variables.product.prodname_actions %} の支払いを管理する {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 ### コンテキストと式について @@ -81,27 +81,27 @@ env: {% data reusables.github-actions.github-context-warning %} -| プロパティ名 | 種類 | 説明 | -| ------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `github` | `オブジェクト` | ワークフローのあらゆるジョブやステップにおいて使用できる最上位のコンテキスト。 | -| `github.event` | `オブジェクト` | webhook ペイロードの完全なイベント。 詳しい情報については、「[ワークフローをトリガーするイベント](/articles/events-that-trigger-workflows/)」を参照してください。 このコンテキストを使用して、イベントの個々のプロパティにアクセスできます。 | -| `github.event_path` | `string` | ランナー上の完全なイベントwebhookペイロードへのパス。 | -| `github.workflow` | `string` | ワークフローの名前。 ワークフローファイルで `name` を指定していない場合、このプロパティの値は、リポジトリ内にあるワークフローファイルのフルパスになります。 | -| `github.job` | `string` | 現在のジョブの[`job_id`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_id)。 | -| `github.run_id` | `string` | {% data reusables.github-actions.run_id_description %} | -| `github.run_number` | `string` | {% data reusables.github-actions.run_number_description %} | -| `github.actor` | `string` | ワークフローの実行を開始したユーザのログイン。 | -| `github.repository` | `string` | 所有者およびリポジトリの名前。 `Codertocat/Hello-World`などです。 | -| `github.repository_owner` | `string` | リポジトリのオーナーの名前。 たとえば`Codertocat`。 | -| `github.event_name` | `string` | ワークフローの実行をトリガーしたイベントの名前。 | -| `github.sha` | `string` | ワークフローの実行をトリガーしたコミット SHA。 | -| `github.ref` | `string` | ワークフローの実行をトリガーしたブランチまたはタグ ref。 | -| `github.head_ref` | `string` | ワークフローの実行における `head_ref` またはプルリクエストのソースブランチ。 このプロパティは、ワークフローの実行をトリガーしたイベントが `pull_request` の場合のみ使用できます。 | -| `github.base_ref` | `string` | ワークフローの実行における `base_ref` またはプルリクエストのターゲットブランチ。 このプロパティは、ワークフローの実行をトリガーしたイベントが `pull_request` の場合のみ使用できます。 | -| `github.token` | `string` | リポジトリにインストールされたGitHub Appの代わりに認証するためのトークン。 これは機能的に`GITHUB_TOKEN`シークレットに等価です。 詳しい情報については「[GITHUB_TOKENでの認証](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)」を参照してください。 | -| `github.workspace` | `string` | [`checkout`](https://github.com/actions/checkout)アクションを使う際の、ステップにとってのデフォルトのワーキングディレクトリであり、リポジトリのデフォルトの場所です。 | +| プロパティ名 | 種類 | 説明 | +| ------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `github` | `オブジェクト` | ワークフローのあらゆるジョブやステップにおいて使用できる最上位のコンテキスト。 | | `github.action` | `string` | 現在実行中のアクションの名前。 {% data variables.product.prodname_dotcom %}は、現在のステップがステップを実行する際に、特殊なキャラクターを削除するか、`run`という名前を使います。 同じジョブの中で同じアクションを複数回使う場合、名前には順番に番号が加えられます。 たとえば、実行する最初のスクリプトの名前は`run1`で、2番目のスクリプトの名前は`run2`というようになります。 同様に、`actions/checkout`の2回目の呼び出しは`actionscheckout2`となります。 | -| `github.action_path` | `string` | アクションが置かれているパス。 このパスを使用して、アクションと同じリポジトリにあるファイルに簡単にアクセスできます。 この属性は、複合実行ステップアクションでのみサポートされています。 | +| `github.action_path` | `string` | アクションが置かれているパス。 このパスを使用して、アクションと同じリポジトリにあるファイルに簡単にアクセスできます。 この属性は、複合実行ステップアクションでのみサポートされています。 | +| `github.actor` | `string` | ワークフローの実行を開始したユーザのログイン。 | +| `github.base_ref` | `string` | ワークフローの実行における `base_ref` またはプルリクエストのターゲットブランチ。 このプロパティは、ワークフローの実行をトリガーしたイベントが `pull_request` の場合のみ使用できます。 | +| `github.event` | `オブジェクト` | webhook ペイロードの完全なイベント。 詳しい情報については、「[ワークフローをトリガーするイベント](/articles/events-that-trigger-workflows/)」を参照してください。 このコンテキストを使用して、イベントの個々のプロパティにアクセスできます。 | +| `github.event_name` | `string` | ワークフローの実行をトリガーしたイベントの名前。 | +| `github.event_path` | `string` | ランナー上の完全なイベントwebhookペイロードへのパス。 | +| `github.head_ref` | `string` | ワークフローの実行における `head_ref` またはプルリクエストのソースブランチ。 このプロパティは、ワークフローの実行をトリガーしたイベントが `pull_request` の場合のみ使用できます。 | +| `github.job` | `string` | 現在のジョブの[`job_id`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_id)。 | +| `github.ref` | `string` | ワークフローの実行をトリガーしたブランチまたはタグ ref。 | +| `github.repository` | `string` | 所有者およびリポジトリの名前。 `Codertocat/Hello-World`などです。 | +| `github.repository_owner` | `string` | リポジトリのオーナーの名前。 たとえば`Codertocat`。 | +| `github.run_id` | `string` | {% data reusables.github-actions.run_id_description %} +| `github.run_number` | `string` | {% data reusables.github-actions.run_number_description %} +| `github.sha` | `string` | ワークフローの実行をトリガーしたコミット SHA。 | +| `github.token` | `string` | リポジトリにインストールされたGitHub Appの代わりに認証するためのトークン。 これは機能的に`GITHUB_TOKEN`シークレットに等価です。 詳しい情報については「[GITHUB_TOKENでの認証](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)」を参照してください。 | +| `github.workflow` | `string` | ワークフローの名前。 ワークフローファイルで `name` を指定していない場合、このプロパティの値は、リポジトリ内にあるワークフローファイルのフルパスになります。 | +| `github.workspace` | `string` | [`checkout`](https://github.com/actions/checkout)アクションを使う際の、ステップにとってのデフォルトのワーキングディレクトリであり、リポジトリのデフォルトの場所です。 | #### **`env`コンテキスト** @@ -121,17 +121,17 @@ env: `job` コンテキストは、現在実行中のジョブに関する情報を含みます。 -| プロパティ名 | 種類 | 説明 | -| ----------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `ジョブ` | `オブジェクト` | このコンテキストは、実行しているジョブごとに異なります。 このコンテキストには、ジョブのあらゆるステップからアクセスできます。 | -| `job.status` | `string` | ジョブの現在の状態。 `success`、`failure`、`cancelled` のいずれかの値をとります。 | +| プロパティ名 | 種類 | 説明 | +| ----------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `ジョブ` | `オブジェクト` | このコンテキストは、実行しているジョブごとに異なります。 このコンテキストには、ジョブのあらゆるステップからアクセスできます。 | | `job.container` | `オブジェクト` | ジョブのコンテナに関する情報。 コンテナに関する詳しい情報については、「[{% data variables.product.prodname_actions %} のワークフロー構文](/articles/workflow-syntax-for-github-actions#jobsjob_idcontainer)」を参照してください。 | -| `job.container.network` | `string` | コンテナネットワークの ID。 runner は、コンテナ内のすべてのジョブに使用されるネットワークを作成します。 | -| `job.container.id` | `string` | コンテナの ID。 | +| `job.container.id` | `string` | コンテナの ID。 | +| `job.container.network` | `string` | コンテナネットワークの ID。 runner は、コンテナ内のすべてのジョブに使用されるネットワークを作成します。 | | `job.services` | `オブジェクト` | ジョブのために作成されたサービスコンテナ。 サービスコンテナに関する詳しい情報については、「[{% data variables.product.prodname_actions %} のワークフロー構文](/articles/workflow-syntax-for-github-actions#jobsjob_idservices)」を参照してください。 | -| `job.services..id` | `string` | サービスコンテナの ID。 | -| `job.services..ports` | `オブジェクト` | サービスコンテナの公開ポート。 | -| `job.services..network` | `string` | サービスコンテナネットワークの ID。 runner は、コンテナ内のすべてのジョブに使用されるネットワークを作成します。 | +| `job.services..id` | `string` | サービスコンテナの ID。 | +| `job.services..network` | `string` | サービスコンテナネットワークの ID。 runner は、コンテナ内のすべてのジョブに使用されるネットワークを作成します。 | +| `job.services..ports` | `オブジェクト` | サービスコンテナの公開ポート。 | +| `job.status` | `string` | ジョブの現在の状態。 `success`、`failure`、`cancelled` のいずれかの値をとります。 | #### **`steps` コンテキスト** @@ -140,31 +140,31 @@ env: | プロパティ名 | 種類 | 説明 | | --------------------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `steps` | `オブジェクト` | このコンテキストは、ジョブのステップごとに異なります。 このコンテキストには、ジョブのあらゆるステップからアクセスできます。 | -| `steps..outputs` | `オブジェクト` | ステップに定義された出力のセット。 詳しい情報については、「[{% data variables.product.prodname_actions %} のメタデータ構文](/articles/metadata-syntax-for-github-actions#outputs)」を参照してください。 | -| `steps..outputs.` | `string` | 特定の出力の値。 | -| `steps..outcome` | `string` | [`continue-on-error`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepscontinue-on-error)が適用される前の完了したステップの結果。 `success`、`failure`、`cancelled`、`skipped`のいずれかの値をとります。 `continue-on-error`のステップが失敗すると、`outcome`は`failure`になりますが、最終的な`conclusion`は`success`になります。 | +| `steps..outputs` | `オブジェクト` | ステップに定義された出力のセット。 詳しい情報については、「[{% data variables.product.prodname_actions %} のメタデータ構文](/articles/metadata-syntax-for-github-actions#outputs)」を参照してください。 | | `steps..conclusion` | `string` | [`continue-on-error`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepscontinue-on-error)が適用された後に完了したステップの結果。 `success`、`failure`、`cancelled`、`skipped`のいずれかの値をとります。 `continue-on-error`のステップが失敗すると、`outcome`は`failure`になりますが、最終的な`conclusion`は`success`になります。 | +| `steps..outcome` | `string` | [`continue-on-error`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepscontinue-on-error)が適用される前の完了したステップの結果。 `success`、`failure`、`cancelled`、`skipped`のいずれかの値をとります。 `continue-on-error`のステップが失敗すると、`outcome`は`failure`になりますが、最終的な`conclusion`は`success`になります。 | +| `steps..outputs.` | `string` | 特定の出力の値。 | #### **`runner`コンテキスト** `runner`コンテキストには、現在のジョブを実行しているランナーに関する情報が含まれています。 -| プロパティ名 | 種類 | 説明 | -| ------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `runner.os` | `string` | ジョブを実行しているランナーのオペレーティングシステム。 取り得る値は`Linux`、`Windows`、`macOS`のいずれか。 | -| `runner.temp` | `string` | ランナー用のテンポラリディレクトリのパス。 このディレクトリは、セルフホストランナーの場合であっても、各ジョブの開始時点では空であることが保証されています。 | -| `runner.tool_cache` | `string` | {% data variables.product.prodname_dotcom %}ホストランナーにプレインストールされているいくつかのツールを含むディレクトリのパス。 詳しい情報については「[GitHUbホストランナーにインストールされているソフトウェア](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)」を参照してください。 | +| プロパティ名 | 種類 | 説明 | +| ------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `runner.os` | `string` | ジョブを実行しているランナーのオペレーティングシステム。 取り得る値は`Linux`、`Windows`、`macOS`のいずれか。 | +| `runner.temp` | `string` | ランナー用のテンポラリディレクトリのパス。 このディレクトリは、セルフホストランナーの場合であっても、各ジョブの開始時点では空であることが保証されています。 | +| `runner.tool_cache` | `string` | {% data variables.product.prodname_dotcom %}ホストランナーにプレインストールされているいくつかのツールを含むディレクトリのパス。 詳しい情報については、「[{% data variables.product.prodname_dotcom %} ホストランナーの仕様](/actions/reference/specifications-for-github-hosted-runners/#supported-software)」を参照してください。 | #### **`needs`コンテキスト** `needs`コンテキストは、現在のジョブの依存関係として定義されたすべてのジョブからの出力を含みます。 ジョブの依存関係の定義に関する詳しい情報については「[{% data variables.product.prodname_actions %}のワークフロー構文](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)」を参照してください。 -| プロパティ名 | 種類 | 説明 | -| -------------------------------------------------- | -------- | ------------------------------------------------------------------ | -| `needs.` | `オブジェクト` | 現在のジョブが依存している1つのジョブ。 | -| `needs..result` | `string` | 現在のジョブが依存しているジョブの結果。 `success`、`failure`、`cancelled` のいずれかの値をとります。 | -| `needs..outputs` | `オブジェクト` | 現在のジョブが依存しているジョブの出力の集合。 | -| `needs..outputs.` | `string` | 現在のジョブが依存しているジョブの特定の出力の値。 | +| プロパティ名 | 種類 | 説明 | +| -------------------------------------------------- | -------- | --------------------------------------------------------------------------- | +| `needs.` | `オブジェクト` | 現在のジョブが依存している1つのジョブ。 | +| `needs..outputs` | `オブジェクト` | 現在のジョブが依存しているジョブの出力の集合。 | +| `needs..outputs.` | `string` | 現在のジョブが依存しているジョブの特定の出力の値。 | +| `needs..result` | `string` | 現在のジョブが依存しているジョブの結果。 `success`、`failure`、`cancelled`、`skipped`のいずれかの値をとります。 | #### コンテキスト情報をログに出力するサンプル @@ -179,7 +179,7 @@ on: push jobs: one: - runs-on: ubuntu-16.04 + runs-on: ubuntu-latest steps: - name: Dump GitHub context env: diff --git a/translations/ja-JP/content/actions/reference/encrypted-secrets.md b/translations/ja-JP/content/actions/reference/encrypted-secrets.md new file mode 100644 index 000000000000..6c202cb6f39b --- /dev/null +++ b/translations/ja-JP/content/actions/reference/encrypted-secrets.md @@ -0,0 +1,221 @@ +--- +title: Encrypted secrets +intro: 暗号化されたシークレットを使用すると、機密情報をリポジトリまたは Organization に保存できます。 +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets + - /actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets + - /actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +### 暗号化されたシークレットについて + +シークレットは、リポジトリまたは Organization で作成する暗号化された環境変数です。 作成したシークレットは、{% data variables.product.prodname_actions %} ワークフローで使用できます。 {% data variables.product.prodname_dotcom %}は、[ libsodium sealed box](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes)を使って、シークレットが{% data variables.product.prodname_dotcom %}に到達する前に暗号化され、ワークフローで使われるまで暗号化されたままになっていることを保証する手助けをします。 + +{% data reusables.github-actions.secrets-org-level-overview %} + +#### シークレットに名前を付ける + +シークレットの名前には次のルールが適用されます。 + +* シークレット名には、英数字（`[a-z]`、`[A-Z]`、`[0-9]`）または下線（`_`）のみを含めることができます。 スペースは使用できません。 +* シークレット名の最初を `GITHUB_` プレフィックスにすることはできません。 +* シークレット名の最初を数字にすることはできません。 +* シークレット名は、作成されたレベルで一意である必要があります。 たとえば、Organization レベルで作成されたシークレット名はそのレベルで一意である必要があり、リポジトリレベルで作成されたシークレット名はそのリポジトリ内で一意である必要があります。 Organization レベルのシークレット名がリポジトリレベルのシークレット名と同じ場合、リポジトリレベルのシークレット名が優先されます。 + +{% data variables.product.prodname_dotcom %} がログのシークレットを確実に削除するよう、シークレットの値として構造化データを使用しないでください。 たとえば、JSONやエンコードされたGit blobを含むシークレットは作成しないでください。 + +#### シークレットにアクセスする + +シークレットをアクションが使用できるようにするには、ワークフローファイルでシークレットを入力または環境変数に設定する必要があります。 アクションに必要な入力および環境変数については、アクションのREADMEファイルを確認します。 詳しい情報については、「[{% data variables.product.prodname_actions %}のワークフロー構文](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)」を参照してください。 + +ファイルを編集するアクセス権を持っていれば、ワークフローファイル中の暗号化されたシークレットを使い、読み取ることができます。 詳細は「[{% data variables.product.prodname_dotcom %} 上のアクセス権限](/github/getting-started-with-github/access-permissions-on-github)」を参照してください。 + +{% warning %} + +**警告：** {% data variables.product.prodname_dotcom %}は、ログに出力されたシークレットを自動的に削除しますが、シークレットをログに出力することは意識的に避けなくてはなりません。 + +{% endwarning %} + +REST API を使用してシークレットを管理することもできます。 詳しい情報については、「[シークレット](/v3/actions/secrets/)」を参照してください。 + +#### 認証情報のアクセス許可を制限する + +クレデンシャルを生成する際には、可能な限り最小限の権限だけを許可することをおすすめします。 たとえば、個人のクレデンシャルを使う代わりに、[デプロイキー](/v3/guides/managing-deploy-keys/#deploy-keys)あるいはサービスアカウントを使ってください。 必要なのが読み取りだけであれば、読み取りのみの権限を許可すること、そしてアクセスをできるかぎり限定することを考慮してください。 個人アクセストークン（PAT）を生成する際には、必要最小限のスコープを選択してください。 + +### リポジトリの暗号化されたシークレットの作成 + +{% data reusables.github-actions.permissions-statement-secrets-repository %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.github-actions.sidebar-secret %} +1. [**Add a new secret**] をクリックします。 +1. [名前] 入力ボックスにシークレットの名前 **入力します。 +1 シークレットの値を入力します。 +1 [**Add secret**] をクリックします。 + +リポジトリが親組織のシークレットにアクセスできる場合、そのシークレットもこのページに表示されます。 + +### 組織の暗号化されたシークレットの作成 + +組織でシークレットを作成する場合、ポリシーを使用して、そのシークレットにアクセスできるリポジトリを制限できます。 たとえば、すべてのリポジトリにアクセスを許可したり、プライベート リポジトリまたは指定したリポジトリ のリストのみにアクセスを制限したりできます。 + +{% data reusables.github-actions.permissions-statement-secrets-organization %} + +{% data reusables.organizations.navigate-to-org %} +{% data reusables.organizations.org_settings %} +{% data reusables.github-actions.sidebar-secret %} +1. [新しいシークレット ****] をクリックします。 +1. [名前] 入力ボックスにシークレットの名前 **入力します。 +1 シークレットの **値** を入力します。 +1 [ **リポジトリアクセス** ドロップダウン リストから、アクセス ポリシーを選択します。 +1 [**Add secret**] をクリックします。 + +### 組織レベルのシークレットへのアクセスの確認 + +組織内のシークレットに適用されているアクセス ポリシーを確認できます。 + +{% data reusables.organizations.navigate-to-org %} +{% data reusables.organizations.org_settings %} +{% data reusables.github-actions.sidebar-secret %} +1. シークレットのリストには、構成済みのアクセス許可とポリシーが含まれます。 例: ![シークレットリスト](/assets/images/help/settings/actions-org-secrets-list.png) +1. 各シークレットに構成されているアクセス許可の詳細については、[更新**] をクリックしてください。

    + +### 暗号化されたシークレットのワークフロー内での利用 + +`GITHUB_TOKEN`を除き、フォークしたリポジトリからワークフローがトリガーされた場合、シークレットは runner に渡されません。 + +アクションに入力あるいは環境変数としてシークレットを提供するには、リポジトリ内に作成したシークレットにアクセスする`secrets`コンテキストを使うことができます。 詳しい情報については「[{% data variables.product.prodname_actions %}のコンテキストと式構文](/actions/reference/context-and-expression-syntax-for-github-actions)」及び「[{% data variables.product.prodname_actions %}のワークフロー構文](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)」を参照してください。 + +{% raw %} +```yaml +steps: + - name: Hello world action + with: # Set the secret as an input + super_secret: ${{ secrets.SuperSecret }} + env: # Or as an environment variable + super_secret: ${{ secrets.SuperSecret }} +``` +{% endraw %} + +可能であれば、コマンドラインからプロセス間でシークレットを渡すのは避けてください。 コマンドラインプロセスは他のユーザから見えるかもしれず（`ps`コマンドを使って）、あるいは[セキュリティ監査イベント](https://docs.microsoft.com/en-us/windows-server/identity/ad-ds/manage/component-updates/command-line-process-auditing)でキャプチャされるかもしれません。 シークレットの保護のために、環境変数、`STDIN`、あるいはターゲットのプロセスがサポートしている他の仕組みの利用を考慮してください。 + +コマンドラインからシークレットを渡さなければならない場合は、それらを適切なルールでクオート内に収めてください。 シークレットは、意図せずシェルに影響するかもしれない特殊なキャラクターをしばしば含みます。 それらの特殊なキャラクターをエスケープするには、環境変数をクオートで囲ってください。 例: + +#### Bashの利用例 + +{% raw %} +```yaml +steps: + - shell: bash + env: + SUPER_SECRET: ${{ secrets.SuperSecret }} + run: | + example-command "$SUPER_SECRET" +``` +{% endraw %} + +#### PowerShellの利用例 + +{% raw %} +```yaml +steps: + - shell: pwsh + env: + SUPER_SECRET: ${{ secrets.SuperSecret }} + run: | + example-command "$env:SUPER_SECRET" +``` +{% endraw %} + +#### Cmd.exeの利用例 + +{% raw %} +```yaml +steps: + - shell: cmd + env: + SUPER_SECRET: ${{ secrets.SuperSecret }} + run: | + example-command "%SUPER_SECRET%" +``` +{% endraw %} + +### シークレットの制限 + +ワークフローは、最大で100のシークレットを持てます。 シークレット環境変数の名前は、リポジトリ内でユニークでなければなりません。 + +シークレットの容量は最大64 KBです。 64 KBより大きなシークレットを使うには、暗号化されたシークレットをリポジトリ内に保存して、復号化パスフレーズを{% data variables.product.prodname_dotcom %}に保存します。 たとえば、{% data variables.product.prodname_dotcom %}のリポジトリにファイルをチェックインする前に、`gpg`を使って認証情報をローカルで暗号化します。 詳しい情報については、「[gpg manpage](https://www.gnupg.org/gph/de/manual/r1023.html)」を参照してください。 + +{% warning %} + +**警告**: アクションを実行する際、シークレットは出力されないので注意してください。 この回避策を用いる場合、{% data variables.product.prodname_dotcom %}はログに出力されたシークレットを削除しません。 + +{% endwarning %} + +1. ターミナルから以下のコマンドを実行して、`gpg`およびAES256暗号アルゴリズムを使用して`my_secret.json`ファイルを暗号化します。 + + ``` shell + $ gpg --symmetric --cipher-algo AES256 my_secret.json + ``` + +1. パスフレーズを入力するよう求められます。 このパスフレーズを覚えておいてください。{% data variables.product.prodname_dotcom %}で、このパスフレーズを値として用いる新しいシークレットを作成するために必要になります。 + +1. パスフレーズを含む新しいシークレットを作成します。 たとえば、`LARGE_SECRET_PASSPHRASE`という名前で新しいシークレットを作成し、シークレットの値を上記のステップで選択したパスフレーズに設定します。 + +1. 暗号化したファイルをリポジトリ内にコピーしてコミットします。 この例では、暗号化したファイルは`my_secret.json.gpg`です。 + +1. パスワードを復号化するシェルスクリプトを作成します。 このファイルを`decrypt_secret.sh`として保存します。 + + ``` shell + #!/bin/sh + + # mkdir $HOME/secrets + # --batch + ファイルを復号化して、インタラクティブなコマンド + # --yes を防ぎ、質問に対して "はい" を + -- yes --はい --パスフレーズを解読する ="$LARGE_SECRET_PASSPHRASE" \ + -- $HOME/secrets/my_secret.json my_secret.json.gpg + ``` + +1. リポジトリにチェックインする前に、シェルスクリプトが実行可能であることを確かめてください。 + + ``` shell + $ chmod +x decrypt_secret.sh + $ git add decrypt_secret.sh + $ git commit -m "Add new decryption script" + $ git push + ``` + +1. ワークフローから、`step`を使用してシェルスクリプトを呼び出し、シークレットを復号化します。 ワークフローを実行している環境にリポジトリのコピーを作成するには、[`actions/checkout`](https://github.com/actions/checkout)アクションを使用する必要があります。 リポジトリのルートを基準として、`run`コマンドを使用することで、シェルスクリプトを参照します。 + +{% raw %} + ```yaml + 名前: 大きな + + 秘密を持つワークフロー: プッシュ + + ジョブ + : プッシュジョブ: + 名:のジョブ + 実行: ubuntu 最新 + ステップ: + - 使用: アクション/checkout@v2 + - 名前: 大規模な秘密 + を復号化 + 実行: ./.github/scripts/decrypt_secret.sh env: + LARGE_SECRET_PASSPHRASE: ${{ secrets.LARGE_SECRET_PASSPHRASE }} + # このコマンドは、あなたの秘密が印刷されていることを示す例 + # あなたの印刷シークレットを削除します。 GitHub does + # not hide secrets that use this workaround. + - name: Test printing your secret (Remove this step in production) + run: cat $HOME/secrets/my_secret.json + ``` +{% endraw %} diff --git a/translations/ja-JP/content/actions/reference/environment-variables.md b/translations/ja-JP/content/actions/reference/environment-variables.md new file mode 100644 index 000000000000..db63723a6583 --- /dev/null +++ b/translations/ja-JP/content/actions/reference/environment-variables.md @@ -0,0 +1,69 @@ +--- +title: 環境変数 +intro: '{% data variables.product.prodname_dotcom %}はそれぞれの{% data variables.product.prodname_actions %}ワークフローの実行に対してデフォルトの環境変数を設定します。 ワークフローファイル中でカスタムの環境変数を設定することもできます。' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /github/automating-your-workflow-with-github-actions/using-environment-variables + - /actions/automating-your-workflow-with-github-actions/using-environment-variables + - /actions/configuring-and-managing-workflows/using-environment-variables +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +### 環境変数について + +{% data variables.product.prodname_dotcom %}は、ワークフローの実行におけるどのステップでも使用できる、デフォルトの環境変数を設定します。 環境変数では、大文字小文字は区別されます。 アクションあるいはステップ内のコマンド実行は、環境変数を作成、読み取り、変更することができます。 + +カスタムの環境変数を設定するには、ワークフローファイル中でその変数を指定しなければなりません。 ステップ、ジョブ、あるいはワークフロー全体に対する環境変数は、[`jobs..steps.env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv)、[`jobs..env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idenv)、 [`env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env)というキーワードを使って定義できます。 詳しい情報については、「[{% data variables.product.prodname_dotcom %}のワークフロー構文](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)」を参照してください。 + +```yaml +steps: + - name: Hello world + run: echo Hello world $FIRST_NAME $middle_name $Last_Name! + env: + FIRST_NAME: Mona + middle_name: The + Last_Name: Octocat +``` + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} `GITHUB_ENV` 環境ファイル {% else %} `set-env` ワークフローコマンド {% endif %} を使用して、ワークフローの次の手順で使用できる環境変数を設定することもできます。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} 環境ファイル {% else %} `set-env` コマンド {% endif %} は、アクションによって直接使用することも、`run` キーワードを使用してワークフローファイルのシェルコマンドとして使用することもできます。 詳しい情報については「[{% data variables.product.prodname_actions %}のワークフローコマンド](/actions/reference/workflow-commands-for-github-actions/#setting-an-environment-variable)」を参照してください。 + +### デフォルトの環境変数 + +アクションでは、ファイルシステムにアクセスするとき、ハードコードされたファイルパスを使うのではなく環境変数を使用することを強くお勧めします。 {% data variables.product.prodname_dotcom %}は、すべてのランナー環境でアクションが使用する環境変数を設定します。 + +| 環境変数 | 説明 | +| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `CI` | 常に`true`に設定されます。 | +| `HOME` | ユーザーデータの格納に使用される{% data variables.product.prodname_dotcom %}ホームディレクトリのパス。 たとえば、`/github/home`です。 | +| `GITHUB_WORKFLOW` | ワークフローの名前。 | +| `GITHUB_RUN_ID` | {% data reusables.github-actions.run_id_description %} +| `GITHUB_RUN_NUMBER` | {% data reusables.github-actions.run_number_description %} +| `GITHUB_ACTION` | アクションの一意の識別子 (`id`)。 | +| `GITHUB_ACTIONS` | {% data variables.product.prodname_actions %}がワークフローを実行しているときは常に`true`に設定されます。 この変数は、テストがローカルで実行されているときと、{% data variables.product.prodname_actions %}によって実行されているときを区別するために利用できます。 | +| `GITHUB_ACTOR` | ワークフローを開始するユーザーまたはアプリの名前。 `octocat`などです。 | +| `GITHUB_REPOSITORY` | 所有者およびリポジトリの名前。 `octocat/Hello-World`などです。 | +| `GITHUB_EVENT_NAME` | ワークフローをトリガーしたwebhookイベントの名前。 | +| `GITHUB_EVENT_PATH` | 完了したwebhookイベントペイロードのファイルのパス。 `/github/workflow/event.json`などです。 | +| `GITHUB_WORKSPACE` | {% data variables.product.prodname_dotcom %}ワークスペースディレクトリのパス。 ワークフローで [actions/checkout](https://github.com/actions/checkout) アクションを使用する場合、ワークスペースディレクトリはリポジトリのコピーです。 `actions/checkout`アクションを使用していない場合、ディレクトリは空となります。 たとえば、`/home/runner/work/my-repo-name/my-repo-name`となります。 | +| `GITHUB_SHA` | ワークフローをトリガーしたコミットSHA。 たとえば、`ffac537e6cbbf934b08745a378932722df287a53`です。 | +| `GITHUB_REF` | ワークフローをトリガーしたブランチまたはタグref。 たとえば、`refs/heads/feature-branch-1`です。 イベントタイプのブランチもタグも利用できない場合、変数は存在しません。 | +| `GITHUB_HEAD_REF` | フォークしたリポジトリのみに設定。 headリポジトリのブランチです。 | +| `GITHUB_BASE_REF` | フォークしたリポジトリのみに設定。 ベースリポジトリのブランチです。 | +| `GITHUB_SERVER_URL` | Returns the URL of the {% data variables.product.product_name %} server. For example: `https://github.com`. | +| `GITHUB_API_URL` | API URL を返します。 For example: `https://api.github.com`. | +| `GITHUB_GRAPHQL_URL` | グラフ QL API の URL を返します。 For example: `https://api.github.com/graphql`. | + +### 環境変数の命名規則 + +{% note %} + +**メモ:** {% data variables.product.prodname_dotcom %}では、`GITHUB_`という環境変数接頭辞は、{% data variables.product.prodname_dotcom %}が内部で使用するために予約されています。 `GITHUB_`接頭辞を使用して環境変数またはシークレットを設定すると、エラーになります。 + +{% endnote %} + +ファイルシステム上の場所にそのポイントを設定した新しい環境変数がある場合は、`_PATH`接尾辞を指定する必要があります。 デフォルトの変数`HOME`と`GITHUB_WORKSPACE`は、「home」および「workspace」という言葉で最初から場所がわかっているため、この規則の例外です。 diff --git a/translations/ja-JP/content/actions/reference/events-that-trigger-workflows.md b/translations/ja-JP/content/actions/reference/events-that-trigger-workflows.md index 941d798e8973..247df2c9dbfb 100644 --- a/translations/ja-JP/content/actions/reference/events-that-trigger-workflows.md +++ b/translations/ja-JP/content/actions/reference/events-that-trigger-workflows.md @@ -12,34 +12,156 @@ versions: enterprise-server: '>=2.22' --- -{% data reusables.actions.enterprise-beta %} +{% data variables.product.prodname_actions %} の支払いを管理する {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 -### ワークフローイベントについて +### Configuring workflow events -{% data variables.product.product_name %} 上のアクティビティから webhook イベントが作成された際にワークフローを実行するよう設定できます。 ワークフローは、ワークフローの実行をトリガーするための webhook イベントを複数使用できます。 詳しい情報については、「[webhook](/webhooks)」を参照してください。 `on` 構文の詳細については、「[{% data variables.product.prodname_actions %}のためのワークフローの構文](/articles/workflow-syntax-for-github-actions#on)」を参照してください。 +You can configure workflows to run for one or more events using the `on` workflow syntax. 詳細については、「[{% data variables.product.prodname_actions %}のワークフロー構文](/articles/workflow-syntax-for-github-actions#on)」を参照してください。 + +{% data reusables.github-actions.actions-on-examples %} + +{% note %} + +**ノート:** `GITHUB_TOKEN`を使って新しいワークフローの実行をトリガーすることはできません。 詳しい情報については「[個人アクセストークンを使った新しいワークフローのトリガー](#triggering-new-workflows-using-a-personal-access-token)」を参照してください。 + +{% endnote %} ワークフローの実行がトリガーされるには、以下のステップが生じます。 -1. リポジトリでイベントが生じ、その結果のイベントのwebhookは関連づけられたコミットSHAとGit refを持っている。 -1. リポジトリ内の関連づけられたコミットSHAもしくはGit refにおける `.github/workflows`ディレクトリ内でワークフローファイルが検索される。 ワークフローファイルは、コミットSHAあるいはGit refを考慮した上で存在していなければなりません。 +1. An event occurs on your repository, and the resulting event has an associated commit SHA and Git ref. +2. リポジトリ内の関連づけられたコミットSHAもしくはGit refにおける `.github/workflows`ディレクトリ内でワークフローファイルが検索される。 ワークフローファイルは、コミットSHAあるいはGit refを考慮した上で存在していなければなりません。 たとえば、イベントが特定のリポジトリブランチで発生したなら、ワークフローファイルはそのブランチ上でリポジトリ内に存在しなければなりません。 1. そのコミットSHA及びGit refのワークフローファイルが調べられ、トリガーを起こしたイベントにマッチする`on:`の値を持つワークフローについて新しい実行がトリガーされる。 ワークフローの実行は、イベントをトリガーしたのと同じコミットSHA及びGit refにあるリポジトリのコード上で実行されます。 ワークフローを実行すると、{% data variables.product.product_name %} はランナー環境において `GITHUB_SHA` (コミット SHA) および `GITHUB_REF` (Git ref) 環境変数を設定します。 詳しい情報については、「[環境変数の利用](/actions/automating-your-workflow-with-github-actions/using-environment-variables)」を参照してください。 +### スケジュールしたイベント + +`schedule` イベントを使用すると、スケジュールされた時間にワークフローをトリガーできます。 + +#### `schedule` + +| webhook イベントのペイロード | アクティビティタイプ | `GITHUB_SHA` | `GITHUB_REF` | +| ------------------ | ---------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| n/a | n/a | デフォルトブランチの直近のコミット | デフォルトブランチ | スケジュールしたワークフローを実行するよう設定したとき。 スケジュールしたワークフローは、[POSIX クーロン構文](https://pubs.opengroup.org/onlinepubs/9699919799/utilities/crontab.html#tag_20_25_07)を使用します。 詳しい情報については、「[イベントでワークフローをトリガーする](/articles/configuring-a-workflow/#triggering-a-workflow-with-events)」を参照してください。 | + +{% data reusables.repositories.actions-scheduled-workflow-example %} + +クーロン構文では、スペースで分けられた 5 つのフィールドがあり、各フィールドは時間の単位を表わします。 + +``` +┌───────────── 分 (0 - 59) +│ ┌───────────── 時間 (0 - 23) +│ │ ┌───────────── 日 (1 - 31) +│ │ │ ┌───────────── 月 (1 - 12 または JAN-DEC) +│ │ │ │ ┌───────────── 曜日 (0 - 6 または SUN-SAT) +│ │ │ │ │ +│ │ │ │ │ +│ │ │ │ │ +* * * * * +``` + +5 つのフィールドいずれにおいても、以下の演算子を使用できます: + +| 演算子 | 説明 | サンプル | +| --- | ---------- | --------------------------------------------------------------- | +| * | 任意の値 | `* * * * *` 毎日、毎分実行します。 | +| , | 値リストの区切り文字 | `2,10 4,5 * * *` 毎日、午前 4 時および午前 5 時の、2 分および 10 分に実行します。 | +| - | 値の範囲 | `0 4-6 * * *` 午前 4 時、5 時、および 6 時の、0 分に実行します。 | +| / | ステップ値 | `20/15 * * * *` 20 分から 59 分までの間で、15 分おきに実行します (20 分、35 分、50 分)。 | + {% note %} -**ノート:** `GITHUB_TOKEN`を使って新しいワークフローの実行をトリガーすることはできません。 詳しい情報については「[個人アクセストークンを使った新しいワークフローのトリガー](#triggering-new-workflows-using-a-personal-access-token)」を参照してください。 +**注釈:** {% data variables.product.prodname_actions %} は、非標準的構文　(`@yearly`、`@monthly`、`@weekly`、`@daily`、`@hourly`、`@reboot`) をサポートしていません。 {% endnote %} -{% data reusables.github-actions.actions-on-examples %} +[crontab guru](https://crontab.guru/) を使うと、クーロン構文の生成および実行時間の確認に役立ちます。 また、クーロン構文の生成を支援するため、[crontab guru のサンプル](https://crontab.guru/examples.html)リストもあります。 + +### 手動イベント + +ワークフローの実行を手動でトリガーできます。 リポジトリ内の特定のワークフローをトリガーするには、`workflow_dispatch` イベントを使用します。 リポジトリで複数のワークフローをトリガーし、カスタムイベントとイベントタイプを作成するには、`repository_dispatch` イベントを使用します。 + +#### `workflow_dispatch` + +| webhook イベントのペイロード | アクティビティタイプ | `GITHUB_SHA` | `GITHUB_REF` | +| ---------------------------------------------------------------- | ---------- | -------------------------- | --------------- | +| [workflow_dispatch](/webhooks/event-payloads/#workflow_dispatch) | n/a | `GITHUB_REF` ブランチ上の直近のコミット | ディスパッチを受信したブランチ | + +You can configure custom-defined input properties, default input values, and required inputs for the event directly in your workflow. ワークフローが実行されると、 `github.event.inputs` コンテキスト内の入力値にアクセスできます。 詳しい情報については、「[{% data variables.product.prodname_actions %} のコンテキストと式構文](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)」を参照してください。 + +You can manually trigger a workflow run using the {% data variables.product.prodname_dotcom %} API and from {% data variables.product.prodname_dotcom %}. For more information, see "[Manually running a workflow](/actions/managing-workflow-runs/manually-running-a-workflow)." + + {% data variables.product.prodname_dotcom %} でイベントをトリガーすると、{% data variables.product.prodname_dotcom %} で `ref` と `inputs` を直接入力できます。 For more information, see "[Using inputs and outputs with an action](/actions/learn-github-actions/finding-and-customizing-actions#using-inputs-and-outputs-with-an-action)." + + REST API を使用してカスタム `workflow_dispatch` webhook イベントをトリガーするには、`POST` リクエストを {% data variables.product.prodname_dotcom %} API エンドポイントに送信し、`ref` および必要な `inputs` を入力する必要があります。 詳細については、「[ワークフローディスパッチイベントの作成](/rest/reference/actions/#create-a-workflow-dispatch-event)」REST API エンドポイントを参照してください。 + +##### Example workflow configuration + +この例では、 `名` 定義し、入力 ` github.event.inputs.name` を使用してそれらを出力し、github.event.inputs.home コンテキスト `します。 ` `名が指定されていない場合は、既定値の 「Mona the Octocat」 が表示されます。

    + +

    {% raw %}

    + +
    名前: 手動でトリガーされたワークフロー
+:
+  workflow_dispatch:
+    入力:
+      の説明:
+        
+        説明: 必須: true
+        デフォルト: 'モナ・ザ・オクトキャット' ホーム
+      : 'モナ・ザ・オクトキャット'
+        ホーム: '場所'
+        必要: 偽
+
+ジョブ:
+  say_hello:
+    実行: ubuntu最新
+    ステップ:
+    - 実行 |
+        エコー "こんにちは ${{ github.event.inputs.name }}!
+        エコー "- ${{ github.event.inputs.home }}で!
+`
    +{% endraw %} + +#### `repository_dispatch` + +| webhook イベントのペイロード | アクティビティタイプ | `GITHUB_SHA` | `GITHUB_REF` | +| -------------------------------------------------------------------- | ---------- | -------------------------- | --------------- | +| [repository_dispatch](/webhooks/event-payloads/#repository_dispatch) | n/a | `GITHUB_REF` ブランチ上の直近のコミット | ディスパッチを受信したブランチ | + +{% data reusables.github-actions.branch-requirement %} + +{% data variables.product.product_name %} の外部で生じるアクティビティのためにワークフローをトリガーしたい場合、{% data variables.product.prodname_dotcom %} API を使って、[`repository_dispatch`](/webhooks/event-payloads/#repository_dispatch) と呼ばれる webhook イベントをトリガーできます。 詳細については、「リポジトリディスパッチ イベント    を作成 + +」を参照してください。

    + +カスタム `repository_dispatch` webhook イベントをトリガーするには、{% data variables.product.product_name %} API エンドポイントに `POST` リクエストを送信して、アクティビティのタイプを説明する `event_type` 名を提供する必要があります。 ワークフローの実行をトリガーするには、`repository_dispatch` イベントを使用するようワークフローを設定する必要もあります。 + + + +##### サンプル + +デフォルトでは、すべての`event_types`がワークフローの実行をトリガーします。 特定の`event_type`の値が`repository_dispatch` webhookのペイロード内で送信された時にのみワークフローが実行されるように制限できます。 リポジトリのディスパッチイベントを生成する際に、`repository_dispatch`ペイロード内で送信されるイベントの種類を定義します。 + + + +```yaml +on: + repository_dispatch: + types: [opened, deleted] +``` + + + ### webhook イベント -GitHub で webhook イベントが作成された際にワークフローを実行するよう設定できます。 イベントによっては、そのイベントをトリガーするアクティビティタイプが 複数あります。 イベントをトリガーするアクティビティタイプが複数ある場合は、ワークフローの実行をトリガーするアクティビティタイプを指定できます。 +GitHub で webhook イベントが作成された際にワークフローを実行するよう設定できます。 イベントによっては、そのイベントをトリガーするアクティビティタイプが 複数あります。 イベントをトリガーするアクティビティタイプが複数ある場合は、ワークフローの実行をトリガーするアクティビティタイプを指定できます。 詳しい情報については、「[webhook](/webhooks)」を参照してください。 + + #### `check_run` @@ -51,16 +173,22 @@ GitHub で webhook イベントが作成された際にワークフローを実 | -------------------------------------------------- | -------------------------------------------------------------------------------------------- | ----------------- | ------------ | | [`check_run`](/webhooks/event-payloads/#check_run) | - `created`
    - `rerequested`
    - `completed`
    - `requested_action` | デフォルトブランチの直近のコミット | デフォルトブランチ | + {% data reusables.developer-site.limit_workflow_to_activity_types %} たとえば、チェック実行が `rerequested` または `requested_action` だったときにワークフローを実行する例は、次のとおりです。 + + ```yaml on: check_run: types: [rerequested, requested_action] ``` + + + #### `check_suite` `check_suite` イベントが発生したときにワークフローを実行します。 {% data reusables.developer-site.multiple_activity_types %} REST API の詳細については、「[チェックスイート](/v3/checks/suites/)」を参照してください。 @@ -77,16 +205,22 @@ on: | ------------------------------------------------------ | -------------------------------------------------------------------------- | ----------------- | ------------ | | [`check_suite`](/webhooks/event-payloads/#check_suite) | - `completed`
    - `requested`
    - `rerequested`
    | デフォルトブランチの直近のコミット | デフォルトブランチ | + {% data reusables.developer-site.limit_workflow_to_activity_types %} たとえば、チェック実行が `rerequested` または `completed` だったときにワークフローを実行する例は、次のとおりです。 + + ```yaml on: check_suite: types: [rerequested, completed] ``` + + + #### `create` 誰かがブランチまたはタグを作成し、それによって `create` イベントがトリガーされるときにワークフローを実行します。 REST API の詳細については、「[リファレンスの作成](/v3/git/refs/#create-a-reference)」を参照してください。 @@ -95,13 +229,19 @@ on: | -------------------------------------------- | ---------- | ---------------------- | -------------- | | [`create`](/webhooks/event-payloads/#create) | n/a | 直近でブランチまたはタグが作成されたコミット | 作成されたブランチまたはタグ | + たとえば、`create` イベントが発生したときにワークフローを実行する例は、次のとおりです。 + + ```yaml on: create ``` + + + #### `delete` 誰かがブランチまたはタグを作成し、それによって `create` イベントがトリガーされるときにワークフローを実行します。 REST API の詳細については、「[リファレンスの削除](/v3/git/refs/#delete-a-reference)」を参照してください。 @@ -112,43 +252,61 @@ on: | -------------------------------------------- | ---------- | ----------------- | ------------ | | [`delete`](/webhooks/event-payloads/#delete) | n/a | デフォルトブランチの直近のコミット | デフォルトブランチ | + たとえば、`delete` イベントが発生したときにワークフローを実行する例は、次のとおりです。 + + ```yaml on: delete ``` + + + #### `deployment` -誰かがデプロイメントを作成し、それによって `deploymen` イベントがトリガーされるときにワークフローを実行します。 コミット SHA 付きで作成されたデプロイメントには Git ref がない場合があります。 REST API の詳細については、「[デプロイメント](/v3/repos/deployments/)」を参照してください。 +誰かがデプロイメントを作成し、それによって `deploymen` イベントがトリガーされるときにワークフローを実行します。 コミット SHA 付きで作成されたデプロイメントには Git ref がない場合があります。 REST API の詳細については、「[デプロイメント](/rest/reference/repos#deployments)」を参照してください。 | webhook イベントのペイロード | アクティビティタイプ | `GITHUB_SHA` | `GITHUB_REF` | | ---------------------------------------------------- | ---------- | ------------ | ---------------------------- | | [`deployment`](/webhooks/event-payloads/#deployment) | n/a | デプロイされるコミット | デプロイされるブランチまたはタグ (コミットの場合は空) | + たとえば、`deployment` イベントが発生したときにワークフローを実行する例は、次のとおりです。 + + ```yaml on: deployment ``` + + + #### `deployment_status` -サードパーティプロバイダーがデプロイメントステータスを提供し、それによって `deployment_status` イベントがトリガーされるときにワークフローを実行します。 コミット SHA 付きで作成されたデプロイメントには Git ref がない場合があります。 REST API の詳細については、「[デプロイメントステータスの作成](/v3/repos/deployments/#create-a-deployment-status)」を参照してください。 +サードパーティプロバイダーがデプロイメントステータスを提供し、それによって `deployment_status` イベントがトリガーされるときにワークフローを実行します。 コミット SHA 付きで作成されたデプロイメントには Git ref がない場合があります。 REST API の詳細については、「[デプロイメントステータスの作成](/rest/reference/repos#create-a-deployment-status)」を参照してください。 | webhook イベントのペイロード | アクティビティタイプ | `GITHUB_SHA` | `GITHUB_REF` | | ------------------------------------------------------------------ | ---------- | ------------ | ---------------------------- | | [`deployment_status`](/webhooks/event-payloads/#deployment_status) | n/a | デプロイされるコミット | デプロイされるブランチまたはタグ (コミットの場合は空) | + たとえば、`deployment_status` イベントが発生したときにワークフローを実行する例は、次のとおりです。 + + ```yaml on: deployment_status ``` + + + #### `フォーク` 誰かがリポジトリをフォークし、それによって `deployment_status` イベントがトリガーされるときにワークフローを実行します。 REST API の詳細については、「[フォークの作成](/v3/repos/forks/#create-a-fork)」を参照してください。 @@ -159,13 +317,19 @@ on: | ---------------------------------------- | ---------- | ----------------- | ------------ | | [`フォーク`](/webhooks/event-payloads/#fork) | n/a | デフォルトブランチの直近のコミット | デフォルトブランチ | + たとえば、`fork` イベントが発生したときにワークフローを実行する例は、次のとおりです。 + + ```yaml on: fork ``` + + + #### `gollum` 誰かが Wiki ページを作成または更新し、それによって `gollum` イベントがトリガーされるときにワークフローを実行します。 @@ -176,33 +340,45 @@ on: | -------------------------------------------- | ---------- | ----------------- | ------------ | | [`gollum`](/webhooks/event-payloads/#gollum) | n/a | デフォルトブランチの直近のコミット | デフォルトブランチ | + たとえば、`gollum` イベントが発生したときにワークフローを実行する例は、次のとおりです。 + + ```yaml on: gollum ``` + + + #### `issue_comment` -`issue_comment` イベントが発生したときにワークフローを実行します。 {% data reusables.developer-site.multiple_activity_types %} REST API の詳細については、「[Issue コメント](/v3/issues/comments/)」を参照してください。 +`issue_comment` イベントが発生したときにワークフローを実行します。 {% data reusables.developer-site.multiple_activity_types %} REST API の詳細については、「[Issue コメント](/developers/webhooks-and-events/webhook-events-and-payloads#issue_comment)」を参照してください。 {% data reusables.github-actions.branch-requirement %} -| webhook イベントのペイロード | アクティビティタイプ | `GITHUB_SHA` | `GITHUB_REF` | -| ---------------------------------------------------------- | ----------------------------------------------------------------- | ----------------- | ------------ | -| [`issue_comment`](/v3/activity/event_types/#issue_comment) | - `created`
    - `edited`
    - `deleted`
    | デフォルトブランチの直近のコミット | デフォルトブランチ | +| webhook イベントのペイロード | アクティビティタイプ | `GITHUB_SHA` | `GITHUB_REF` | +| --------------------------------------------------------- | ----------------------------------------------------------------- | ----------------- | ------------ | +| [`issue_comment`](/rest/reference/activity#issue_comment) | - `created`
    - `edited`
    - `deleted`
    | デフォルトブランチの直近のコミット | デフォルトブランチ | + {% data reusables.developer-site.limit_workflow_to_activity_types %} たとえば、Issue コメントが `created` または `deleted` だったときにワークフローを実行する例は、次のとおりです。 + + ```yaml on: issue_comment: types: [created, deleted] ``` + + + #### `issues` `Issue` イベントが発生したときにワークフローを実行します。 {% data reusables.developer-site.multiple_activity_types %} REST API の詳細については、「[Issue](/v3/issues)」を参照してください。 @@ -213,16 +389,22 @@ on: | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ------------ | | [`issues`](/webhooks/event-payloads/#issues) | - `opened`
    - `edited`
    - `deleted`
    - `transferred`
    - `pinned`
    - `unpinned`
    - `closed`
    - `reopened`
    - `assigned`
    - `unassigned`
    - `labeled`
    - `unlabeled`
    - `locked`
    - `unlocked`
    - `milestoned`
    - `demilestoned` | デフォルトブランチの直近のコミット | デフォルトブランチ | + {% data reusables.developer-site.limit_workflow_to_activity_types %} たとえば、Issue が `opened`、`edited`、または `milestoned` だったときにワークフローを実行する例は、次のとおりです。 + + ```yaml on: issues: types: [opened, edited, milestoned] ``` + + + #### `ラベル` `label` イベントが発生したときにワークフローを実行します。 {% data reusables.developer-site.multiple_activity_types %} REST API の詳細については、「[ラベル](/v3/issues/labels/)」を参照してください。 @@ -233,16 +415,22 @@ on: | ---------------------------------------- | ----------------------------------------------------------------- | ----------------- | ------------ | | [`ラベル`](/webhooks/event-payloads/#label) | - `created`
    - `edited`
    - `deleted`
    | デフォルトブランチの直近のコミット | デフォルトブランチ | + {% data reusables.developer-site.limit_workflow_to_activity_types %} たとえば、ラベルが `created` または `deleted` だったときにワークフローを実行する例は、次のとおりです。 + + ```yaml on: label: types: [created, deleted] ``` + + + #### `マイルストーン` `milestone` イベントが発生したときにワークフローを実行します。 {% data reusables.developer-site.multiple_activity_types %} REST API の詳細については、「[マイルストーン](/v3/issues/milestones/)」を参照してください。 @@ -253,19 +441,25 @@ on: | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------- | ----------------- | ------------ | | [`マイルストーン`](/webhooks/event-payloads/#milestone) | - `created`
    - `closed`
    - `opened`
    - `edited`
    - `deleted`
    | デフォルトブランチの直近のコミット | デフォルトブランチ | + {% data reusables.developer-site.limit_workflow_to_activity_types %} たとえばマイルストーンが`opened`あるいは`deleted`になったときにワークフローを実行できます。 + + ```yaml on: milestone: types: [opened, deleted] ``` + + + #### `page_build` -誰かが {% data variables.product.product_name %} ページ対応のブランチを作成し、それによって `page_build` イベントがトリガーされるときにワークフローを実行します。 REST API の詳細については、「[ページ](/v3/repos/pages/)」を参照してください。 +誰かが {% data variables.product.product_name %} ページ対応のブランチを作成し、それによって `page_build` イベントがトリガーされるときにワークフローを実行します。 REST API の詳細については、「[ページ](/rest/reference/repos#pages)」を参照してください。 {% data reusables.github-actions.branch-requirement %} @@ -273,13 +467,19 @@ on: | ---------------------------------------------------- | ---------- | ----------------- | ------------ | | [`page_build`](/webhooks/event-payloads/#page_build) | n/a | デフォルトブランチの直近のコミット | n/a | + たとえば、`page_build` イベントが発生したときにワークフローを実行する例は、次のとおりです。 + + ```yaml on: page_build ``` + + + #### `project` `project` イベントが発生したときにワークフローを実行します。 {% data reusables.developer-site.multiple_activity_types %} REST API の詳細については、「[プロジェクト](/v3/projects/)」を参照してください。 @@ -290,16 +490,22 @@ on: | ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ------------ | | [`project`](/webhooks/event-payloads/#project) | - `created`
    - `updated`
    - `closed`
    - `reopened`
    - `edited`
    - `deleted`
    | デフォルトブランチの直近のコミット | デフォルトブランチ | + {% data reusables.developer-site.limit_workflow_to_activity_types %} たとえば、プロジェクトが `created` または `deleted` だったときにワークフローを実行する例は、次のとおりです。 + + ```yaml on: project: types: [created, deleted] ``` + + + #### `project_card` `project_card` イベントが発生したときにワークフローを実行します。 {% data reusables.developer-site.multiple_activity_types %} REST API の詳細については、「[プロジェクトカード](/v3/projects/cards)」を参照してください。 @@ -310,16 +516,22 @@ on: | -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | ----------------- | ------------ | | [`project_card`](/webhooks/event-payloads/#project_card) | - `created`
    - `moved`
    - `converted` to an issue
    - `edited`
    - `deleted` | デフォルトブランチの直近のコミット | デフォルトブランチ | + {% data reusables.developer-site.limit_workflow_to_activity_types %} たとえば、プロジェクトカードが `opened` または `deleted` だったときにワークフローを実行する例は、次のとおりです。 + + ```yaml on: project_card: types: [opened, deleted] ``` + + + #### `project_column` `project_column` イベントが発生したときにワークフローを実行します。 {% data reusables.developer-site.multiple_activity_types %} REST API の詳細については、「[プロジェクト列](/v3/projects/columns)」を参照してください。 @@ -330,16 +542,22 @@ on: | ------------------------------------------------------------ | --------------------------------------------------------------------------- | ----------------- | ------------ | | [`project_column`](/webhooks/event-payloads/#project_column) | - `created`
    - `updated`
    - `moved`
    - `deleted` | デフォルトブランチの直近のコミット | デフォルトブランチ | + {% data reusables.developer-site.limit_workflow_to_activity_types %} たとえば、プロジェクト列が `created` または `deleted` だったときにワークフローを実行する例は、次のとおりです。 + + ```yaml on: project_column: types: [created, deleted] ``` + + + #### `public` 誰かがプライベートリポジトリをパブリックにし、それによって `public` イベントがトリガーされるときにワークフローを実行します。 REST API の詳細については、「[リポジトリの編集](/v3/repos/#edit)」を参照してください。 @@ -350,13 +568,19 @@ on: | -------------------------------------------- | ---------- | ----------------- | ------------ | | [`public`](/webhooks/event-payloads/#public) | n/a | デフォルトブランチの直近のコミット | デフォルトブランチ | + たとえば、`public` イベントが発生したときにワークフローを実行する例は、次のとおりです。 + + ```yaml on: public ``` + + + #### `pull_request` `pull_request` イベントが発生したときにワークフローを実行します。 {% data reusables.developer-site.multiple_activity_types %} REST API の詳細については、「[プルリクエスト](/v3/pulls)」を参照してください。 @@ -371,18 +595,24 @@ on: | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- | -------------------------------------- | | [`pull_request`](/webhooks/event-payloads/#pull_request) | - `assigned`
    - `unassigned`
    - `labeled`
    - `unlabeled`
    - `opened`
    - `edited`
    - `closed`
    - `reopened`
    - `synchronize`
    - `ready_for_review`
    - `locked`
    - `unlocked`
    - `review_requested`
    - `review_request_removed` | `GITHUB_REF` ブランチ上の直近のマージコミット | PR マージブランチ `refs/pull/:prNumber/merge` | + デフォルトのアクティビティタイプを拡大または制限するには、`types` キーワードを使用します。 詳しい情報については、「[{% data variables.product.prodname_actions %}のワークフロー構文](/articles/workflow-syntax-for-github-actions#onevent_nametypes)」を参照してください。 たとえば、プルリクエストが `assigned`、`opened`、`synchronize`、または `reopened` だったときにワークフローを実行できます。 + + ```yaml on: pull_request: types: [assigned, opened, synchronize, reopened] ``` + {% data reusables.developer-site.pull_request_forked_repos_link %} + + #### `pull_request_review` `pull_request_review` イベントが発生したときにワークフローを実行します。 {% data reusables.developer-site.multiple_activity_types %} REST API の詳細については、「[プルリクエストレビュー](/v3/pulls/reviews)」を参照してください。 @@ -391,18 +621,24 @@ on: | ---------------------------------------------------------------------- | ---------------------------------------------------------- | ----------------------------- | -------------------------------------- | | [`pull_request_review`](/webhooks/event-payloads/#pull_request_review) | - `submitted`
    - `edited`
    - `dismissed` | `GITHUB_REF` ブランチ上の直近のマージコミット | PR マージブランチ `refs/pull/:prNumber/merge` | + {% data reusables.developer-site.limit_workflow_to_activity_types %} たとえば、プルリクエストレビューが `eidted` または `dismissed` だったときにワークフローを実行する例は、次のとおりです。 + + ```yaml on: pull_request_review: types: [edited, dismissed] ``` + {% data reusables.developer-site.pull_request_forked_repos_link %} + + #### `pull_request_review_comment` プルリクエストの統合 diff へのコメントが変更され、それによって `pull_request_review_comment` イベントがトリガーされるときにワークフローを実行します。 {% data reusables.developer-site.multiple_activity_types %} REST API の詳細については、「[レビューコメント](/v3/pulls/comments)」を参照してください。 @@ -411,35 +647,47 @@ on: | -------------------------------------------------------------------------------------- | ------------------------------------------------------ | ----------------------------- | -------------------------------------- | | [`pull_request_review_comment`](/webhooks/event-payloads/#pull_request_review_comment) | - `created`
    - `edited`
    - `deleted` | `GITHUB_REF` ブランチ上の直近のマージコミット | PR マージブランチ `refs/pull/:prNumber/merge` | + {% data reusables.developer-site.limit_workflow_to_activity_types %} たとえば、プルリクエストレビューコメントが `created` または `deleted` だったときにワークフローを実行する例は、次のとおりです。 + + ```yaml on: pull_request_review_comment: types: [created, deleted] ``` + {% data reusables.developer-site.pull_request_forked_repos_link %} + + #### `pull_request_target` -このイベントは `pull_request` に似ていますが、マージコミットではなく、プルリクエストのベースリポジトリのコンテキストで実行される点で異なります。 つまり、ベースリポジトリのコミットで定義されたワークフローのみが実行されるため、プルリクエストによってトリガーされたワークフローでシークレットをより安全に使用できるようになります。 たとえば、このイベントでは、イベントペイロードの内容に基づいて、プルリクエストにラベルを付けてコメントを付けるワークフローを作成できます。 +このイベントは `pull_request` に似ていますが、マージコミットではなく、プルリクエストのベースリポジトリのコンテキストで実行される点で異なります。 つまり、ベースリポジトリのコミットで定義されたワークフローのみが実行されるため、プルリクエストによってトリガーされたワークフローでシークレットをより安全に使用できるようになります。 たとえば、このイベントでは、イベントペイロードの内容に基づいて、プルリクエストにラベルを付けてコメントを付けるワークフローを作成できます。 | webhook イベントのペイロード | アクティビティタイプ | `GITHUB_SHA` | `GITHUB_REF` | | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ------------ | | [`pull_request`](/webhooks/event-payloads/#pull_request) | - `assigned`
    - `unassigned`
    - `labeled`
    - `unlabeled`
    - `opened`
    - `edited`
    - `closed`
    - `reopened`
    - `synchronize`
    - `ready_for_review`
    - `locked`
    - `unlocked`
    - `review_requested`
    - `review_request_removed` | PR ベースブランチの直近のコミット | PR ベースブランチ | + デフォルトでは、ワークフローは、`pull_request_target` のアクティビティタイプが `opened`、`synchronize`、または `reopened` のときにのみ実行されます。 他のアクティビティタイプについてもワークフローをトリガーするには、`types` キーワードを使用してください。 詳しい情報については、「[{% data variables.product.prodname_actions %}のワークフロー構文](/articles/workflow-syntax-for-github-actions#onevent_nametypes)」を参照してください。 たとえば、プルリクエストが `assigned`、`opened`、`synchronize`、または `reopened` だったときにワークフローを実行できます。 + + ```yaml on: pull_request_target types: [assigned, opened, synchronize, reopened] ``` + + + #### `プッシュ` {% note %} @@ -454,13 +702,19 @@ on: pull_request_target | ---------------------------------------- | ---------- | --------------------------------------------- | ------------ | | [`プッシュ`](/webhooks/event-payloads/#push) | n/a | プッシュされたコミット、ただし (デフォルトブランチの際に) ブランチを削除する場合を除く | 更新された ref | + たとえば、`push` イベントが発生したときにワークフローを実行する例は、次のとおりです。 + + ```yaml on: push ``` + + + #### `registry_package` パッケージが`published`もしくは`updated`されるとワークフローを実行します。 詳しい情報については「[{% data variables.product.prodname_registry %}でのパッケージ管理](/github/managing-packages-with-github-packages)」を参照してください。 @@ -469,16 +723,22 @@ on: | ------------------------------------------------------- | ----------------------------------- | --------------- | --------------------- | | [`registry_package`](/webhooks/event-payloads/#package) | - `published`
    - `updated` | 公開されたパッケージのコミット | 公開されたパッケージのブランチもしくはタグ | + {% data reusables.developer-site.limit_workflow_to_activity_types %} たとえば、パッケージが`published`されたときにワークフローを実行できます。 + + ```yaml on: registry_package: types: [published] ``` + + + #### `リリース` {% note %} @@ -489,20 +749,26 @@ on: `release` イベントが発生したときにワークフローを実行します。 {% data reusables.developer-site.multiple_activity_types %} REST API の詳細については、「[リリース](/v3/repos/releases/)」を参照してください。 -| webhook イベントのペイロード | アクティビティタイプ | `GITHUB_SHA` | `GITHUB_REF` | -| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ------------ | -| [`リリース`](/webhooks/event-payloads/#release) | - `published`{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}
    - `unpublished`
    - `created`
    - `edited`
    - `deleted`
    - `prereleased`
    - `released`{% endif %} | リリースのタグが付いた直近のコミット | リリースのタグ | +| webhook イベントのペイロード | アクティビティタイプ | `GITHUB_SHA` | `GITHUB_REF` | +| ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ------------ | +| [`リリース`](/webhooks/event-payloads/#release) | - `published`
    - `unpublished`
    - `created`
    - `edited`
    - `deleted`
    - `prereleased`
    - `released` | リリースのタグが付いた直近のコミット | リリースのタグ | + {% data reusables.developer-site.limit_workflow_to_activity_types %} たとえば、リリースが `published` だったときにワークフローを実行する例は、次のとおりです。 + + ```yaml on: release: types: [published] ``` + + + #### `ステータス` Git コミットのステータスが変更された、それによって `status` イベントがトリガーされるときにワークフローを実行します。 REST API の詳細については、「[ステータス](/v3/repos/statuses/)」を参照してください。 @@ -513,13 +779,19 @@ Git コミットのステータスが変更された、それによって `statu | ------------------------------------------- | ---------- | ----------------- | ------------ | | [`ステータス`](/webhooks/event-payloads/#status) | n/a | デフォルトブランチの直近のコミット | n/a | + たとえば、`status` イベントが発生したときにワークフローを実行する例は、次のとおりです。 + + ```yaml on: status ``` + + + #### `Watch` `watch` イベントが発生したときにワークフローを実行します。 {% data reusables.developer-site.multiple_activity_types %} REST API の詳細については、「[Star を付ける](/v3/activity/starring/)」を参照してください。 @@ -530,16 +802,22 @@ on: | ------------------------------------------ | ----------- | ----------------- | ------------ | | [`Watch`](/webhooks/event-payloads/#watch) | - `started` | デフォルトブランチの直近のコミット | デフォルトブランチ | + {% data reusables.developer-site.limit_workflow_to_activity_types %} たとえば、誰かがリポジトリに Star を付け、それが Watch イベントをトリガーする `started` アクティブタイプである場合にワークフローを実行する例は、次のとおりです。 + + ```yaml on: watch: types: [started] ``` + + + #### `workflow_run` {% data reusables.webhooks.workflow_run_desc %} @@ -548,6 +826,8 @@ on: この例では、ワークフローは別の「Run Tests」ワークフローの完了後に実行されるように設定されています。 + + ```yaml on: workflow_run: @@ -558,91 +838,6 @@ on: - requested ``` -### スケジュールしたイベント - -`schedule` イベントを使用すると、スケジュールされた時間にワークフローをトリガーできます。 - -#### `schedule` - -| webhook イベントのペイロード | アクティビティタイプ | `GITHUB_SHA` | `GITHUB_REF` | -| ------------------ | ---------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| n/a | n/a | デフォルトブランチの直近のコミット | デフォルトブランチ | スケジュールしたワークフローを実行するよう設定したとき。 スケジュールしたワークフローは、[POSIX クーロン構文](https://pubs.opengroup.org/onlinepubs/9699919799/utilities/crontab.html#tag_20_25_07)を使用します。 詳しい情報については、「[イベントでワークフローをトリガーする](/articles/configuring-a-workflow/#triggering-a-workflow-with-events)」を参照してください。 | - -{% data reusables.repositories.actions-scheduled-workflow-example %} - -クーロン構文では、スペースで分けられた 5 つのフィールドがあり、各フィールドは時間の単位を表わします。 - -``` -┌───────────── 分 (0 - 59) -│ ┌───────────── 時間 (0 - 23) -│ │ ┌───────────── 日 (1 - 31) -│ │ │ ┌───────────── 月 (1 - 12 または JAN-DEC) -│ │ │ │ ┌───────────── 曜日 (0 - 6 または SUN-SAT) -│ │ │ │ │ -│ │ │ │ │ -│ │ │ │ │ -* * * * * -``` - -5 つのフィールドいずれにおいても、以下の演算子を使用できます: - -| 演算子 | 説明 | サンプル | -| --- | ---------- | --------------------------------------------------------------- | -| * | 任意の値 | `* * * * *` 毎日、毎分実行します。 | -| , | 値リストの区切り文字 | `2,10 4,5 * * *` 毎日、午前 4 時および午前 5 時の、2 分および 10 分に実行します。 | -| - | 値の範囲 | `0 4-6 * * *` 午前 4 時、5 時、および 6 時の、0 分に実行します。 | -| / | ステップ値 | `20/15 * * * *` 20 分から 59 分までの間で、15 分おきに実行します (20 分、35 分、50 分)。 | - -{% note %} - -**注釈:** {% data variables.product.prodname_actions %} は、非標準的構文　(`@yearly`、`@monthly`、`@weekly`、`@daily`、`@hourly`、`@reboot`) をサポートしていません。 - -{% endnote %} - -[crontab guru](https://crontab.guru/) を使うと、クーロン構文の生成および実行時間の確認に役立ちます。 また、クーロン構文の生成を支援するため、[crontab guru のサンプル](https://crontab.guru/examples.html)リストもあります。 - -### 手動イベント - -ワークフローの実行を手動でトリガーできます。 リポジトリ内の特定のワークフローをトリガーするには、`workflow_dispatch` イベントを使用します。 リポジトリで複数のワークフローをトリガーし、カスタムイベントとイベントタイプを作成するには、`repository_dispatch` イベントを使用します。 - -#### `workflow_dispatch` - -| webhook イベントのペイロード | アクティビティタイプ | `GITHUB_SHA` | `GITHUB_REF` | -| ---------------------------------------------------------------- | ---------- | -------------------------- | --------------- | -| [workflow_dispatch](/webhooks/event-payloads/#workflow_dispatch) | n/a | `GITHUB_REF` ブランチ上の直近のコミット | ディスパッチを受信したブランチ | - -You can manually trigger a workflow run using the {% data variables.product.prodname_dotcom %} API and from {% data variables.product.prodname_dotcom %}. REST API を使用してカスタム `workflow_dispatch` webhook イベントをトリガーするには、`POST` リクエストを {% data variables.product.prodname_dotcom %} API エンドポイントに送信し、`ref` および必要な `inputs` を入力する必要があります。 詳細については、「[ワークフローディスパッチイベントの作成](/rest/reference/actions/#create-a-workflow-dispatch-event)」REST API エンドポイントを参照してください。 - - {% data variables.product.prodname_dotcom %} でイベントをトリガーすると、{% data variables.product.prodname_dotcom %} で `ref` と `inputs` を直接入力できます。 詳細は「[ワークフローの設定](/actions/configuring-and-managing-workflows/configuring-a-workflow#manually-running-a-workflow)」を参照してください。 - -#### `repository_dispatch` - -| webhook イベントのペイロード | アクティビティタイプ | `GITHUB_SHA` | `GITHUB_REF` | -| -------------------------------------------------------------------- | ---------- | -------------------------- | --------------- | -| [repository_dispatch](/webhooks/event-payloads/#repository_dispatch) | n/a | `GITHUB_REF` ブランチ上の直近のコミット | ディスパッチを受信したブランチ | - -{% data reusables.github-actions.branch-requirement %} - -{% data variables.product.product_name %} の外部で生じるアクティビティのためにワークフローをトリガーしたい場合、{% data variables.product.prodname_dotcom %} API を使って、[`repository_dispatch`](/webhooks/event-payloads/#repository_dispatch) と呼ばれる webhook イベントをトリガーできます。 詳細については、「リポジトリディスパッチ イベントを作成 - -」を参照してください。

    - -カスタム `repository_dispatch` webhook イベントをトリガーするには、{% data variables.product.product_name %} API エンドポイントに `POST` リクエストを送信して、アクティビティのタイプを説明する `event_type` 名を提供する必要があります。 ワークフローの実行をトリガーするには、`repository_dispatch` イベントを使用するようワークフローを設定する必要もあります。 - - - -##### サンプル - -デフォルトでは、すべての`event_types`がワークフローの実行をトリガーします。 特定の`event_type`の値が`repository_dispatch` webhookのペイロード内で送信された時にのみワークフローが実行されるように制限できます。 リポジトリのディスパッチイベントを生成する際に、`repository_dispatch`ペイロード内で送信されるイベントの種類を定義します。 - - - -```yaml -on: - repository_dispatch: - types: [opened, deleted] -``` - diff --git a/translations/ja-JP/content/actions/reference/index.md b/translations/ja-JP/content/actions/reference/index.md index 675f1bd4c0db..58c27a44bbc3 100644 --- a/translations/ja-JP/content/actions/reference/index.md +++ b/translations/ja-JP/content/actions/reference/index.md @@ -1,17 +1,49 @@ --- title: リファレンス -intro: 'アクションの構築、ワークフローの作成、および {% data variables.product.prodname_actions %}に関するその他のツールおよび情報に関するリファレンス ドキュメント。' +intro: 'Reference documentation for creating workflows, using GitHub-hosted runners, and authentication.' +redirect_from: + - /actions/configuring-and-managing-workflows/using-variables-and-secrets-in-a-workflow versions: free-pro-team: '*' enterprise-server: '>=2.22' --- -{% data reusables.actions.enterprise-beta %} +{% data variables.product.prodname_actions %} の支払いを管理する {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 +### ワークフロー構文 + +The workflow file is written in YAML. In the YAML workflow file, you can use expression syntax to evaluate contextual information, literals, operators, and functions. Contextual information includes workflow, environment variables, secrets, and the events that triggered the workflow. When you use [`run`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun) in a workflow step to run shell commands, you can use specific workflow command syntax to set environment variables, set output parameters for subsequent steps, and set error or debug messages. + {% link_in_list /workflow-syntax-for-github-actions %} -{% link_in_list /events-that-trigger-workflows %} {% link_in_list /context-and-expression-syntax-for-github-actions %} {% link_in_list /workflow-commands-for-github-actions %} -{% link_in_list /virtual-environments-for-github-hosted-runners %} -{% link_in_list /software-installed-on-github-hosted-runners %} + +### イベント + +You can configure workflows to run when specific GitHub events occur, at a scheduled time, manually, or when events outside of GitHub occur. + +{% link_in_list /events-that-trigger-workflows %} + +### Authentication and secrets + +{% data variables.product.prodname_dotcom %}は、{% data variables.product.prodname_actions %}の代理で認証を受けるために利用できるトークンを提供します。 You can also store sensitive information as a secret in your organization or repository. {% data variables.product.prodname_dotcom %} encrypts all secrets. + +{% link_in_list /authentication-in-a-workflow %} +{% link_in_list /encrypted-secrets %} + +### {% data variables.product.prodname_dotcom %}ホストランナー + +GitHub offers hosted virtual machines to run workflows. The virtual machine contains an environment with tools, packages, and environment variables for GitHub Actions to use. + +{% link_in_list /environment-variables %} +{% link_in_list /specifications-for-github-hosted-runners %} + +{% if currentVersion == "free-pro-team@latest" %} +### 管理 + +When you run workflows on {% data variables.product.prodname_dotcom %}-hosted runners, there are usage limits and potential usage charges. You can also disable or restrict the usage of {% data variables.product.prodname_actions %} in a repository and organization. + +{% link_in_list /usage-limits-billing-and-administration %} + +{% endif %} diff --git a/translations/ja-JP/content/actions/reference/specifications-for-github-hosted-runners.md b/translations/ja-JP/content/actions/reference/specifications-for-github-hosted-runners.md new file mode 100644 index 000000000000..a480f22e01cf --- /dev/null +++ b/translations/ja-JP/content/actions/reference/specifications-for-github-hosted-runners.md @@ -0,0 +1,149 @@ +--- +title: Specifications for GitHub-hosted runners +intro: '{% data variables.product.prodname_dotcom %}は、ワークフローを実行するためのホストされた仮想マシンを提供します。 仮想マシンには、{% data variables.product.prodname_actions %}で使用できるツール、パッケージ、および設定の環境が含まれています。' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /articles/virtual-environments-for-github-actions + - /github/automating-your-workflow-with-github-actions/virtual-environments-for-github-actions + - /github/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners + - /actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners + - /actions/reference/virtual-environments-for-github-hosted-runners + - /actions/reference/software-installed-on-github-hosted-runners +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +### {% data variables.product.prodname_dotcom %}ホストランナーについて + +{% data variables.product.prodname_dotcom %}ホストランナーは{% data variables.product.prodname_actions %}ランナーアプリケーションがインストールされた、{% data variables.product.prodname_dotcom %}がホストする仮想マシンです。 {% data variables.product.prodname_dotcom %}は、Linux、Windows、macOSのランナーを提供します。 + +{% data variables.product.prodname_dotcom %}ホストランナーを使用すると、マシンのメンテナンスとアップグレードが自動的に行われます。 ワークフローは、仮想マシンで直接実行することも、Dockerコンテナで実行することもできます。 + +ワークフローのジョブごとにランナーの種類を指定できます。 ワークフローの各ジョブは、仮想マシンの新しいインスタンスで実行されます。 ジョブ実行のステップはすべて、仮想マシンの同じインスタンスで実行されるため、そのジョブのアクションはファイルシステムを使用して情報を共有できます。 + +{% data reusables.github-actions.runner-app-open-source %} + +#### {% data variables.product.prodname_dotcom %}ホストランナーのクラウドホスト + +{% data variables.product.prodname_dotcom %}は、Microsoft AzureのStandard_DS2_v2仮想マシン上で{% data variables.product.prodname_actions %}ランナーアプリケーションがインストールされたLinux及びWindowsランナーをホストします。 {% data variables.product.prodname_dotcom %}ホストランナーアプリケーションは、Azure Pipelines Agentのフォークです。 インバウンドのICMPパケットはすべてのAzure仮想マシンでブロックされるので、pingやtracerouteコマンドは動作しないでしょう。 Standard_DS2_v2マシンのリソースに関する詳しい情報については、Microsoft Azureドキュメンテーションの「[Dv2 and DSv2シリーズ](https://docs.microsoft.com/ja-jp/azure/virtual-machines/dv2-dsv2-series#dsv2-series)」を参照してください。 + +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +#### {% data variables.product.prodname_dotcom %}ホストランナーの管理権限 + +LinuxおよびmacOSの仮想環境は、パスワード不要の`sudo`により動作します。 現在のユーザが持っているよりも高い権限が求められるコマンドやインストールツールを実行する必要がある場合は、パスワードを入力する必要なく、`sudo`を使うことができます。 詳しい情報については、「[Sudo Manual](https://www.sudo.ws/man/1.8.27/sudo.man.html)」を参照してください。 + +Windowsの仮想マシンは、ユーザアカウント制御（UAC）が無効化されて管理者として動作するように設定されています。 詳しい情報については、Windowsのドキュメンテーションの「[ユーザー アカウント制御のしくみ](https://docs.microsoft.com/en-us/windows/security/identity-protection/user-account-control/how-user-account-control-works)」を参照してください。 + +### サポートされているランナーとハードウェアリソース + +各仮想マシンで、同一のハードウェアリソースを使用できます。 + +- 2コアCPU +- 7 GBのRAMメモリー +- 14 GBのSSDディスク容量 + +{% data reusables.github-actions.supported-github-runners %} + +{% data reusables.github-actions.ubuntu-runner-preview %} + +Workflow logs list the runner used to run a job. For more information, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)." + +### Supported software + +The software tools included in {% data variables.product.prodname_dotcom %}-hosted runners are updated weekly. 各ランナーオペレーティングシステム用に含まれるツールの最新のリストについては、以下のリンクを参照してください。 + +* [Ubuntu 20.04 LTS](https://github.com/actions/virtual-environments/blob/main/images/linux/Ubuntu2004-README.md) +* [Ubuntu 18.04 LTS](https://github.com/actions/virtual-environments/blob/main/images/linux/Ubuntu1804-README.md) +* [Ubuntu 16.04 LTS](https://github.com/actions/virtual-environments/blob/main/images/linux/Ubuntu1604-README.md) +* [Windows Server 2019](https://github.com/actions/virtual-environments/blob/main/images/win/Windows2019-Readme.md) +* [Windows Server 2016](https://github.com/actions/virtual-environments/blob/main/images/win/Windows2016-Readme.md) +* [MacOS 10.15](https://github.com/actions/virtual-environments/blob/main/images/macos/macos-10.15-Readme.md) + +{% data reusables.github-actions.ubuntu-runner-preview %} + +{% data variables.product.prodname_dotcom %}ホストランナーには、オペレーティングシステムのデフォルトの組み込みツールに加え、上のリファレンスのリスト内のパッケージにが含まれています。 たとえば、Ubuntu及びmacOSのランナーには、`grep`、`find`、`which`やその他のデフォルトのツールが含まれています。 + +Workflow logs include a link to the preinstalled tools on the runner. For more information, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)." + +リクエストしたいツールがある場合、[actions/virtual-environments](https://github.com/actions/virtual-environments) で Issue を開いてください。 + +### IP addresses + +{% note %} + +**ノート:** {% data variables.product.prodname_dotcom %}のOrganizationもしくはEnterpriseアカウントでIPアドレスの許可リストを使っているなら、{% data variables.product.prodname_dotcom %}ホストランナーは利用できず、代わりにセルフホストランナーを使わなければなりません。 詳しい情報については「[セルフホストランナーについて](/actions/hosting-your-own-runners/about-self-hosted-runners)」を参照してください。 + +{% endnote %} + +WindowsとUbuntuのランナーはAzureでホストされ、IPアドレスの範囲がAzureデータセンターと同じになります。 現在、すべてのWindows及びUbuntuの{% data variables.product.prodname_dotcom %}ホストランナーは、以下のAzureリージョン内にあります。 + +- 米国東部(`eastus`) +- 米国東部2 (`eastus2`) +- 米国西部2 (`westus2`) +- 米国中部 (`centralus`) +- 米国中南部(`southcentralus`) + +Microsoftは、AzureのIPアドレスの範囲をJSONファイルで毎週更新しています。このファイルは、[Azure IP Ranges and Service Tags - Public Cloud (AzureのIPアドレス範囲とサービスタグ - パブリッククラウド)](https://www.microsoft.com/en-us/download/details.aspx?id=56519)のウェブサイトからダウンロードできます。 内部リソースに対する不正アクセスを防ぐために許可リストが必要な場合には、このIPアドレスの範囲を利用できます。 + +JSONファイルには、`values`という配列があります。 この配列のうち、たとえば`"AzureCloud.eastus2"`というようなAzureのリージョンの`name`と`id`があるオブジェクトで、サポート対象のIPアドレスが見つかります。 + +サポート対象のIPアドレスの範囲は、`"addressPrefixes"`オブジェクトにあります。 次に示すのは、JSONファイルを縮めたサンプルです。 + +```json +{ + "changeNumber": 84, + "cloud": "Public", + "values": [ + { + "name": "AzureCloud.eastus2", + "id": "AzureCloud.eastus2", + "properties": { + "changeNumber": 33, + "region": "eastus2", + "platform": "Azure", + "systemService": "", + "addressPrefixes": [ + "13.68.0.0/17", + "13.77.64.0/18", + "13.104.147.0/25", + ... + ] + } + } + ] +} +``` + +### File systems + +{% data variables.product.prodname_dotcom %}は、仮想マシン上の特定のディレクトリでアクションとシェルコマンドを実行します。 仮想マシン上のファイルパスは静的なものではありません。 `home`、`workspace`、`workflow` ディレクトリのファイルパスを構築するには、{% data variables.product.prodname_dotcom %}が提供している環境変数を使用してください。 + +| ディレクトリ | 環境変数 | 説明 | +| --------------------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------- | +| `home` | `HOME` | ユーザ関連のデータが含まれます。 たとえば、このディレクトリにはログイン試行からの認証情報を含めることができます。 | +| `workspace` | `GITHUB_WORKSPACE` | アクションとシェルコマンドはこのディレクトリで実行されます。 このディレクトリの内容は、アクションによって変更することができ、後続のアクションでアクセスできます。 | +| `workflow/event.json` | `GITHUB_EVENT_PATH` | ワークフローをトリガーしたwebhookイベントの`POST`ペイロード。 {% data variables.product.prodname_dotcom %}は、アクションを実行するたびにアクション間でファイルの内容を隔離するためにこれを書き換えます。 | + +各ワークフローに対して{% data variables.product.prodname_dotcom %}が作成する環境変数のリストについては、「[環境変数の利用](/github/automating-your-workflow-with-github-actions/using-environment-variables)」を参照してください。 + +#### Dockerコンテナのファイルシステム + +Dockerコンテナで実行されるアクションには、 `/github`パスの下に静的なディレクトリがあります。 ただし、Dockerコンテナ内のファイルパスを構築するには、デフォルトの環境変数を使用することを強くお勧めします。 + +{% data variables.product.prodname_dotcom %}は、`/github`パス接頭辞を予約し、アクションのために3つのディレクトリを作成します。 + +- `/github/home` +- `/github/workspace` - {% data reusables.repositories.action-root-user-required %} +- `/github/workflow` + +{% if currentVersion == "free-pro-team@latest" %} + +### 参考リンク +- 「[{% data variables.product.prodname_actions %} の支払いを管理する](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)」 + +{% endif %} diff --git a/translations/ja-JP/content/actions/reference/usage-limits-billing-and-administration.md b/translations/ja-JP/content/actions/reference/usage-limits-billing-and-administration.md new file mode 100644 index 000000000000..a23e696092e7 --- /dev/null +++ b/translations/ja-JP/content/actions/reference/usage-limits-billing-and-administration.md @@ -0,0 +1,88 @@ +--- +title: 'Usage limits, billing, and administration' +intro: 'There are usage limits for {% data variables.product.prodname_actions %} workflows. Usage charges apply to repositories that go beyond the amount of free minutes and storage for a repository.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /actions/getting-started-with-github-actions/usage-and-billing-information-for-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 + +### {% data variables.product.prodname_actions %}の支払いについて + +{% if currentVersion == "free-pro-team@latest" %} +{% data reusables.github-actions.actions-billing %} 詳細は「[{% data variables.product.prodname_actions %} の支払いについて](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions)」を参照してください。 +{% else %} +GitHub Actions usage is free for +{% data variables.product.prodname_ghe_server %} that use self-hosted runners. +{% endif %} + +### 使用制限 + +{% if currentVersion == "free-pro-team@latest" %} +There are some limits on +{% data variables.product.prodname_actions %} usage when using {% data variables.product.prodname_dotcom %}-hosted runners. これらの制限は変更されることがあります。 + +{% note %} + +**Note:** For self-hosted runners, different usage limits apply. 詳しい情報については「[セルフホストランナーについて](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)」を参照してください。 + +{% endnote %} + +- **ジョブの実行時間** - ワークフロー中のそれぞれのジョブは、最大で6時間の間実行できます。 ジョブがこの制限に達すると、ジョブは終了させられ、完了できずに失敗します。 +{% data reusables.github-actions.usage-workflow-run-time %} +{% data reusables.github-actions.usage-api-requests %} +- **並行ジョブ** - アカウント内で実行できる並行ジョブ数は、以下の表に示すとおり、利用しているGitHubのプランによります。 この制限を超えた場合、超過のジョブはキューイングされます。 + + | GitHubプラン | 最大同時ジョブ | 最大同時macOSジョブ | + | ---------- | ------- | ------------ | + | 無料 | 20 | 5 | + | Pro | 40 | 5 | + | Team | 60 | 5 | + | Enterprise | 180 | 50 | +- **ジョブマトリックス** - {% data reusables.github-actions.usage-matrix-limits %} +{% else %} +Usage limits apply to self-hosted runners. 詳しい情報については「[セルフホストランナーについて](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)」を参照してください。 +{% endif %} + +{% if currentVersion == "free-pro-team@latest" %} +### 利用のポリシー +In addition to the usage limits, you must ensure that you use + +{% data variables.product.prodname_actions %} within the [GitHub Terms of Service](/articles/github-terms-of-service/). {% data variables.product.prodname_actions %}の固有の規約に関する詳しい情報については、[GitHubの追加製品規約](/github/site-policy/github-additional-product-terms#a-actions-usage)を参照してください。 +{% endif %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +### アーティファクトとログの保持ポリシー + +リポジトリ、Organization、または Enterprise アカウントのアーティファクトとログの保持期間を構成できます。 + +{% data reusables.actions.about-artifact-log-retention %} + +詳しい情報については、以下を参照してください。 + +- [リポジトリ内のアーティファクトとログの {% data variables.product.prodname_actions %} の保持期間を設定する](/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository) +- [Organization 内のアーティファクトとログの {% data variables.product.prodname_actions %} の保持期間を設定する](/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization) +- [Enterprise 内のアーティファクトとログの {% data variables.product.prodname_actions %} の保持期間を設定する](/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account) +{% endif %} + +### リポジトリあるいはOrganizationでの{% data variables.product.prodname_actions %}の無効化もしくは制限 + +{% data reusables.github-actions.disabling-github-actions %} + +詳しい情報については、以下を参照してください。 +- "[Disabling or limiting {% data variables.product.prodname_actions %} for a repository](/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository)" +- "[Disabling or limiting {% data variables.product.prodname_actions %} for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization)"{% if currentVersion == "free-pro-team@latest" %} +- "[Enforcing {% data variables.product.prodname_actions %} policies in your enterprise account](/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account)" for {% data variables.product.prodname_ghe_cloud %}{% endif %} + +### Disabling and enabling workflows + +You can enable and disable individual workflows in your repository on {% data variables.product.prodname_dotcom %}. + +{% data reusables.actions.scheduled-workflows-disabled %} + +For more information, see "[Disabling and enabling a workflow](/actions/managing-workflow-runs/disabling-and-enabling-a-workflow)." diff --git a/translations/ja-JP/content/actions/reference/workflow-commands-for-github-actions.md b/translations/ja-JP/content/actions/reference/workflow-commands-for-github-actions.md index 97dfd2cb51e2..90dcca04543a 100644 --- a/translations/ja-JP/content/actions/reference/workflow-commands-for-github-actions.md +++ b/translations/ja-JP/content/actions/reference/workflow-commands-for-github-actions.md @@ -14,14 +14,18 @@ versions: enterprise-server: '>=2.22' --- -{% data reusables.actions.enterprise-beta %} +{% data variables.product.prodname_actions %} の支払いを管理する {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 ### ワークフローコマンドについて アクションは、 環境変数を設定する、他のアクションに利用される値を出力する、デバッグメッセージを出力ログに追加するなどのタスクを行うため、ランナーマシンとやりとりできます。 +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +Most workflow commands use the `echo` command in a specific format, while others are invoked by writing to a file. For more information, see ["Environment files".](#environment-files) +{% else %} ワークフローコマンドは、特定のフォーマットで `echo` コマンドを使います。 +{% endif %} ``` bash echo "::workflow-command parameter1={data},parameter2={data}::{command value}" @@ -41,40 +45,46 @@ echo "::workflow-command parameter1={data},parameter2={data}::{command value}" ### ワークフローコマンドを使ったツールキット関数へのアクセス -[actions/toolkit](https://github.com/actions/toolkit)には、ワークフローコマンドとして実行できる多くの関数があります。 `::`構文を使って、YAMLファイル内でワークフローコマンドを実行してください。それらのコマンドは`stdout`を通じてランナーに送信されます。 たとえば、環境変数を設定するのにコードを使う代わりに、以下のようにできます。 +[actions/toolkit](https://github.com/actions/toolkit)には、ワークフローコマンドとして実行できる多くの関数があります。 `::`構文を使って、YAMLファイル内でワークフローコマンドを実行してください。それらのコマンドは`stdout`を通じてランナーに送信されます。 For example, instead of using code to set an output, as below: ```javascript -core.exportVariable('SELECTED_COLOR', 'green'); +core.setOutput('SELECTED_COLOR', 'green'); ``` -同じ値を設定するのに、ワークフロー中で`set-env`コマンドが使えます。 +You can use the `set-output` command in your workflow to set the same value: ``` yaml - name: Set selected color - run: echo '::set-env name=SELECTED_COLOR::green' + run: echo '::set-output name=SELECTED_COLOR::green' + id: random-color-generator - name: Get color - run: echo 'The selected color is' $SELECTED_COLOR + run: echo 'The selected color is' ${steps.random-color-generator.outputs.SELECTED_COLOR} ``` 以下の表は、ワークフロー内で使えるツールキット関数を示しています。 -| ツールキット関数 | 等価なワークフローのコマンド | -| --------------------- | ---------------------------------- | -| `core.addPath` | `add-path` | -| `core.debug` | `debug` | -| `core.error` | `エラー` | -| `core.endGroup` | `endgroup` | -| `core.exportVariable` | `set-env` | -| `core.getInput` | 環境変数の`INPUT_{NAME}`を使ってアクセス可能 | -| `core.getState` | 環境変数の`STATE_{NAME}`を使ってアクセス可能 | -| `core.isDebug` | 環境変数の`RUNNER_DEBUG`を使ってアクセス可能 | -| `core.saveState` | `save-state` | -| `core.setFailed` | `::error`及び`exit 1`のショートカットとして使われる | -| `core.setOutput` | `set-output` | -| `core.setSecret` | `add-mask` | -| `core.startGroup` | `group` | -| `core.warning` | `warning file` | - +| ツールキット関数 | 等価なワークフローのコマンド | +| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- | +| `core.addPath` | | +| {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}Accessible using environment file `GITHUB_PATH`{% else %} `add-path` {% endif %} | | +| | | +| `core.debug` | `debug` | +| `core.error` | `エラー` | +| `core.endGroup` | `endgroup` | +| `core.exportVariable` | | +| {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}Accessible using environment file `GITHUB_ENV`{% else %} `set-env` {% endif %} | | +| | | +| `core.getInput` | 環境変数の`INPUT_{NAME}`を使ってアクセス可能 | +| `core.getState` | 環境変数の`STATE_{NAME}`を使ってアクセス可能 | +| `core.isDebug` | 環境変数の`RUNNER_DEBUG`を使ってアクセス可能 | +| `core.saveState` | `save-state` | +| `core.setFailed` | `::error`及び`exit 1`のショートカットとして使われる | +| `core.setOutput` | `set-output` | +| `core.setSecret` | `add-mask` | +| `core.startGroup` | `group` | +| `core.warning` | `warning file` | + +{% if currentVersion ver_lt "enterprise-server@2.23" %} ### 環境変数の設定 `::set-env name={name}::{value}` @@ -86,6 +96,7 @@ core.exportVariable('SELECTED_COLOR', 'green'); ``` bash echo "::set-env name=action_state::yellow" ``` +{% endif %} ### 出力パラメータの設定 @@ -101,6 +112,7 @@ echo "::set-env name=action_state::yellow" echo "::set-output name=action_fruit::strawberry" ``` +{% if currentVersion ver_lt "enterprise-server@2.23" %} ### システムパスの追加 `::add-path::{path}` @@ -112,12 +124,13 @@ echo "::set-output name=action_fruit::strawberry" ``` bash echo "::add-path::/path/to/dir" ``` +{% endif %} ### デバッグメッセージの設定 `::debug::{message}` -デバッグメッセージをログに出力します。 ログでこのコマンドにより設定されたデバッグメッセージを表示するには、`ACTIONS_STEP_DEBUG` という名前のシークレットを作成し、値を `true` に設定する必要があります。 詳しい情報については「[ワークフロー実行の管理](/actions/configuring-and-managing-workflows/managing-a-workflow-run#enabling-debug-logging)」を参照してください。 +デバッグメッセージをログに出力します。 ログでこのコマンドにより設定されたデバッグメッセージを表示するには、`ACTIONS_STEP_DEBUG` という名前のシークレットを作成し、値を `true` に設定する必要があります。 For more information, see "[Enabling debug logging](/actions/managing-workflow-runs/enabling-debug-logging)." #### サンプル @@ -213,3 +226,67 @@ console.log('::save-state name=processID::12345') ``` javascript console.log("The running PID from the main action is: " + process.env.STATE_processID); ``` + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +## Environment Files + +During the execution of a workflow, the runner generates temporary files that can be used to perform certain actions. The path to these files are exposed via environment variables. You will need to use UTF-8 encoding when writing to these files to ensure proper processing of the commands. Multiple commands can be written to the same file, separated by newlines. + +{% warning %} + +**Warning:** Powershell does not use UTF-8 by default. Make sure you write files using the correct encoding. For example, you need to set UTF-8 encoding when you set the path: + +``` +steps: + - run: echo "mypath" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append +``` + +{% endwarning %} + +### 環境変数の設定 + +`echo "{name}={value}" >> $GITHUB_ENV` + +ジョブの中で次に実行される任意のアクションの環境変数を作成または更新します。 環境変数を作成または更新するアクションは、新しい値にアクセスできませんが、ジョブの中でそれ以降に続くすべてのアクションは、その新しい値にアクセスできます。 環境変数では、大文字と小文字が区別され、句読点を含めることができます。 + +#### サンプル + +```bash +echo "action_state=yellow" >> $GITHUB_ENV +``` + +Running `$action_state` in a future step will now return `yellow` + +#### Multline strings +複数行の文字列の場合、次の構文で区切り文字を使用できます。 + +``` +{name}<<{delimiter} +{value} +{delimiter} +``` + +#### サンプル +In this example, we use `EOF` as a delimiter and set the `JSON_RESPONSE` environment variable to the value of the curl response. +``` +steps: + - name: Set the value + id: step_one + run: | + echo 'JSON_RESPONSE<> $GITHUB_ENV + curl https://httpbin.org/json >> $GITHUB_ENV + echo 'EOF' >> $GITHUB_ENV +``` + +### システムパスの追加 + +`echo "{path}" >> $GITHUB_PATH` + +現在のジョブ内にある、続くすべてのアクションにおいて、システム `PATH` 変数の前に、ディレクトリを付加します。 現在実行中のアクションは、新しいパス変数にアクセスできません。 + +#### サンプル + +``` bash +echo "/path/to/dir" >> $GITHUB_PATH +``` +{% endif %} diff --git a/translations/ja-JP/content/actions/reference/workflow-syntax-for-github-actions.md b/translations/ja-JP/content/actions/reference/workflow-syntax-for-github-actions.md index d388ae0c5738..500c35b3359d 100644 --- a/translations/ja-JP/content/actions/reference/workflow-syntax-for-github-actions.md +++ b/translations/ja-JP/content/actions/reference/workflow-syntax-for-github-actions.md @@ -12,7 +12,7 @@ versions: enterprise-server: '>=2.22' --- -{% data reusables.actions.enterprise-beta %} +{% data variables.product.prodname_actions %} の支払いを管理する {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 ### ワークフロー用のYAML構文について @@ -21,10 +21,6 @@ versions: ワークフローファイルは、リポジトリの`.github/workflows`ディレクトリに保存する必要があります。 -### 使用制限 - -{% data reusables.github-actions.github-actions-usage-limits %} - ### **`name`** ワークフローの名前。 {% data variables.product.prodname_dotcom %}では、リポジトリのアクションページにワークフローの名前が表示されます。 `name`を省略すると、{% data variables.product.prodname_dotcom %}はリポジトリのルートに対するワークフローファイルの相対パスをその値に設定します。 @@ -62,18 +58,18 @@ on: ```yaml on: push: - # refs/heads にマッチするパターンのシーケンス + # refs/heads とマッチするパターンのシークエンス branches: - # マスターブランチでイベントをプッシュする - - master - # refs/heads/mona/octocat にマッチするブランチにイベントをプッシュする + # メインブランチのプッシュイベント + - main + # refs/heads/mona/octocat に一致するブランチにイベントをプッシュする - 'mona/octocat' - # refs/heads/releases/10 にマッチするイベントをブランチにプッシュする + # refs/heads/releases/10 に一致するブランチにイベントをプッシュする - 'releases/**' - # refs/tags と照合されるパターンのシーケンス + # refs/tags とマッチするパターンのシーケンス tags: - v1 # イベントを v1 タグにプッシュする - - v1.* # イベントを v1.0、v1.1、v1.9 タグにプッシュする + - v1.* # イベントを v1.0、v1.1、および v1.9 タグにプッシュする ``` #### ブランチとタグを無視する例 @@ -229,7 +225,7 @@ defaults: それぞれのジョブは、`runs-on`で指定された環境で実行されます。 -ワークフローの利用限度内であれば、実行するジョブ数に限度はありません。 詳細については「[利用限度](#usage-limits)」を参照してください。 +ワークフローの利用限度内であれば、実行するジョブ数に限度はありません。 For more information, see "[Usage limits and billing](/actions/reference/usage-limits-billing-and-administration)" for {% data variables.product.prodname_dotcom %}-hosted runners and "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)" for self-hosted runner usage limits. ワークフローの実行中で動作しているジョブのユニークな識別子が必要な場合は、{% data variables.product.prodname_dotcom %} APIが利用できます。 詳しい情報については、「[ワークフロージョブ](/v3/actions/workflow-jobs)」を参照してください。 @@ -310,7 +306,7 @@ runs-on: [self-hosted, linux] 詳しい情報については「[セルフホストランナーについて](/github/automating-your-workflow-with-github-actions/about-self-hosted-runners)」及び「[ワークフロー内でのセルフホストランナーの利用](/github/automating-your-workflow-with-github-actions/using-self-hosted-runners-in-a-workflow)」を参照してください。 -### **`jobs..outputs`** +### **`jobs..outputs`** ジョブからの出力の`map`です。 ジョブの出力は、そのジョブに依存しているすべての下流のジョブから利用できます。 ジョブの依存関係の定義に関する詳しい情報については[`jobs..needs`](#jobsjob_idneeds)を参照してください。 @@ -393,7 +389,7 @@ jobs: 1つのジョブには、`steps` (ステップ) と呼ばれる一連のタスクがあります。 ステップでは、コマンドを実行する、設定タスクを実行する、あるいはリポジトリやパブリックリポジトリ、Dockerレジストリで公開されたアクションを実行することができます。 すべてのステップでアクションを実行するとは限りませんが、すべてのアクションはステップとして実行されます。 各ステップは、ランナー環境のそれ自体のプロセスで実行され、ワークスペースとファイルシステムにアクセスします。 ステップはそれ自体のプロセスで実行されるため、環境変数を変更しても、ステップ間では反映されません。 {% data variables.product.prodname_dotcom %}には、ジョブを設定して完了するステップが組み込まれています。 -ワークフローの利用限度内であれば、実行するステップ数に限度はありません。 詳細については「[利用限度](#usage-limits)」を参照してください。 +ワークフローの利用限度内であれば、実行するステップ数に限度はありません。 For more information, see "[Usage limits and billing](/actions/reference/usage-limits-billing-and-administration)" for {% data variables.product.prodname_dotcom %}-hosted runners and "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)" for self-hosted runner usage limits. #### サンプル @@ -447,7 +443,7 @@ steps: ```yaml steps: - name: My first step - uses: monacorp/action-name@master + uses: monacorp/action-name@main - name: My backup step if: {% raw %}${{ failure() }}{% endraw %} uses: actions/heroku@master @@ -464,7 +460,7 @@ steps: Git ref、SHA、またはDockerタグ番号を指定して、使用しているアクションのバージョンを含めることを強く推奨します。 バージョンを指定しないと、アクションのオーナーがアップデートを公開したときに、ワークフローが中断したり、予期せぬ動作をしたりすることがあります。 - リリースされたアクションバージョンのコミットSHAを使用するのが、安定性とセキュリティのうえで最も安全です。 - 特定のメジャーアクションバージョンを使用すると、互換性を維持したまま重要な修正とセキュリティパッチを受け取ることができます。 ワークフローがまだ動作していることも確認できます。 -- アクションの`master`ブランチを使用すると便利なこともありますが、別のユーザーが大きな変更のある新しいメジャーバージョンをリリースすると、ワークフローが中断する場合があります。 +- アクションのデフォルトブランチを使用すると便利なこともありますが、別のユーザが大きな変更を加えた新しいメジャーバージョンをリリースすると、ワークフローが中断する場合があります。 入力が必要なアクションもあり、入力を[`with`](#jobsjob_idstepswith)キーワードを使って設定する必要があります。 必要な入力を判断するには、アクションのREADMEファイルをお読みください。 @@ -481,7 +477,7 @@ steps: # リリースのマイナーバージョンを参照する - uses: actions/setup-node@v1.2 # ブランチを参照する - - uses: actions/setup-node@master + - uses: actions/setup-node@main ``` ##### パブリックアクションを使用する例 @@ -495,7 +491,7 @@ jobs: my_first_job: steps: - name: My first step - # 公開リポジトリのマスターブランチを使用する + # 公開リポジトリのデフォルトブランチを使用する uses: actions/heroku@master - name: My second step # パブリックリポジトリの特定のバージョンタグを使用する @@ -513,7 +509,7 @@ jobs: my_first_job: steps: - name: My first step - uses: actions/aws/ec2@master + uses: actions/aws/ec2@main ``` ##### ワークフローと同じリポジトリにあるアクションを使用する例 @@ -596,14 +592,14 @@ jobs: `shell`キーワードを使用して、ランナーのオペレーティングシステムのデフォルトシェルを上書きできます。 組み込みの`shell`キーワードを使用するか、カスタムセットのシェルオプションを定義することができます。 -| サポートされているプラットフォーム | `shell` パラメータ | 説明 | 内部で実行されるコマンド | -| ----------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- | -| すべて | `bash` | 非Windowsプラットフォームのデフォルトシェルで、`sh`へのフォールバックがあります。 Windowsでbashシェルを指定すると、Windows用Gitに含まれるbashシェルが使用されます。 | `bash --noprofile --norc -eo pipefail {0}` | -| すべて | `pwsh` | PowerShell Coreです。 {% data variables.product.prodname_dotcom %}はスクリプト名に拡張子`.ps1`を追加します。 | `pwsh -command "& '{0}'"` | -| すべて | `python` | Pythonのコマンドを実行します。 | `python {0}` | -| Linux / macOS | `sh` | 非Windowsプラットフォームにおいてシェルが提供されておらず、パス上で`bash`が見つからなかった場合のフォールバック動作です。 | `sh -e {0}` | +| サポートされているプラットフォーム | `shell` パラメータ | 説明 | 内部で実行されるコマンド | +| ----------------- | ------------- | -------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- | +| すべて | `bash` | 非Windowsプラットフォームのデフォルトシェルで、`sh`へのフォールバックがあります。 Windowsでbashシェルを指定すると、Windows用Gitに含まれるbashシェルが使用されます。 | `bash --noprofile --norc -eo pipefail {0}` | +| すべて | `pwsh` | PowerShell Coreです。 {% data variables.product.prodname_dotcom %}はスクリプト名に拡張子`.ps1`を追加します。 | `pwsh -command ". '{0}'"` | +| すべて | `python` | Pythonのコマンドを実行します。 | `python {0}` | +| Linux / macOS | `sh` | 非Windowsプラットフォームにおいてシェルが提供されておらず、パス上で`bash`が見つからなかった場合のフォールバック動作です。 | `sh -e {0}` | | Windows | `cmd` | {% data variables.product.prodname_dotcom %}はスクリプト名に拡張子`.cmd`を追加し、`{0}`を置き換えます。 | `%ComSpec% /D /E:ON /V:OFF /S /C "CALL "{0}""`. | -| Windows | `powershell` | これはWindowsで使われるデフォルトのシェルです。 デスクトップPowerShellです。 {% data variables.product.prodname_dotcom %}はスクリプト名に拡張子`.ps1`を追加します。 | `powershell -command "& '{0}'"`. | +| Windows | `powershell` | これはWindowsで使われるデフォルトのシェルです。 デスクトップPowerShellです。 {% data variables.product.prodname_dotcom %}はスクリプト名に拡張子`.ps1`を追加します。 | `powershell -command ". '{0}'"`. | ##### bashを使用してスクリプトを実行する例 @@ -678,7 +674,7 @@ jobs: my_first_job: steps: - name: My first step - uses: actions/hello_world@master + uses: actions/hello_world@main with: first_name: Mona middle_name: The @@ -687,7 +683,7 @@ jobs: #### **`jobs..steps.with.args`** -Dockerコンテナへの入力を定義する`文字列`。 {% data variables.product.prodname_dotcom %}は、コンテナの起動時にコンテナの`ENTRYPOINT`に`args`を渡します。 このパラメータは、`文字列の配列`をサポートしません。 +Dockerコンテナへの入力を定義する`文字列`。 {% data variables.product.prodname_dotcom %}は、コンテナの起動時に`args`をコンテナの`ENTRYPOINT`に渡します。 このパラメータは、`文字列の配列`をサポートしません。 ##### サンプル @@ -695,7 +691,7 @@ Dockerコンテナへの入力を定義する`文字列`。 {% data variables.pr ```yaml steps: - name: Explain why this job ran - uses: monacorp/action-name@master + uses: monacorp/action-name@main with: entrypoint: /bin/echo args: The ${{ github.event_name }} event triggered this step. @@ -708,7 +704,6 @@ steps: 1. `args`を指定せずにアクションを利用できるよう、デフォルトを使ってください。 1. アクションが`--help`フラグやそれに類するものを備えている場合は、アクションを自己ドキュメント化するためのデフォルトとして利用してください。 - #### **`jobs..steps.with.entrypoint`** `Dockerfile`中のDockerの`ENTRYPOINT`をオーバーライドします。あるいは、もしそれが指定されていなかった場合に設定します。 shellやexec形式を持つDockerの`ENTRYPOINT`命令とは異なり、`entrypoint`キーワードは実行する実行可能ファイルを定義する単一の文字列だけを受け付けます。 @@ -718,7 +713,7 @@ steps: ```yaml steps: - name: Run a custom command - uses: monacorp/action-name@master + uses: monacorp/action-name@main with: entrypoint: /a/different/executable ``` @@ -766,7 +761,7 @@ strategy (戦略) によって、ジョブのビルドマトリクスが作成 様々なジョブの設定のマトリックスを定義できます。 マトリックスによって、単一のジョブの定義内の変数の置き換えを行い、複数のジョブを作成できるようになります。 たとえば、マトリックスを使って複数のサポートされているバージョンのプログラミング言語、オペレーティングシステム、ツールに対するジョブを作成できます。 マトリックスは、ジョブの設定を再利用し、設定した各マトリクスに対してジョブを作成します。 -{% data reusables.github-actions.matrix-limits %} +{% data reusables.github-actions.usage-matrix-limits %} `matrix`内で定義した各オプションは、キーと値を持ちます。 定義したキーは`matrix`コンテキスト中のプロパティとなり、ワークフローファイルの他のエリア内のプロパティを参照できます。 たとえば、オペレーティングシステムの配列を含む`os`というキーを定義したなら、`matrix.os`プロパティを`runs-on`キーワードの値として使い、それぞれのオペレーティングシステムに対するジョブを作成できます。 詳しい情報については、「[{% data variables.product.prodname_actions %} のコンテキストと式構文](/actions/reference/context-and-expression-syntax-for-github-actions)」を参照してください。 @@ -843,7 +838,6 @@ strategy: `include`を使って新しいジョブを追加し、マトリックスを構築できます。 マッチしなかったincludeの設定があれば、マトリックスに追加されます。 たとえば、`node`のバージョン12を使って複数のオペレーティングシステム上でビルドを行い、追加で実験的なジョブをUbuntu上でnodeバージョン13で行いたいなら、`include`を使ってこの追加のジョブを指定できます。 - {% raw %} ```yaml runs-on: ${{ matrix.os }} @@ -952,7 +946,25 @@ jobs: #### **`jobs..container.image`** -アクションを実行するコンテナとして使用するDockerイメージ。 値はDocker Hubイメージ名か、パブリックDockerレジストリ名です。 +アクションを実行するコンテナとして使用するDockerイメージ。 The value can be the Docker Hub image name or a {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.23" %}public{% endif %} registry name. + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +#### **`jobs..container.credentials`** + +{% data reusables.actions.registry-credentials %} + +##### サンプル + +{% raw %} +```yaml +container: + image: ghcr.io/owner/image + credentials: + username: ${{ github.actor }} + password: ${{ secrets.ghcr_token }} +``` +{% endraw %} +{% endif %} #### **`jobs..container.env`** @@ -1015,19 +1027,43 @@ services: - 6379/tcp ``` -#### **`jobs..services.image`** +#### **`jobs..services..image`** + +アクションを実行するサービスコンテナとして使用するDockerイメージ。 The value can be the Docker Hub image name or a {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.23" %}public{% endif %} registry name. -アクションを実行するサービスコンテナとして使用するDockerイメージ。 値はDockerベースイメージ名か、パブリックDocker Hubまたはレジストリです。 +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +#### **`jobs..services..credentials`** + +{% data reusables.actions.registry-credentials %} + +##### サンプル + +{% raw %} +```yaml +services: + myservice1: + image: ghcr.io/owner/myservice1 + credentials: + username: ${{ github.actor }} + password: ${{ secrets.ghcr_token }} + myservice2: + image: dockerhub_org/myservice2 + credentials: + username: ${{ secrets.DOCKER_USER }} + password: ${{ secrets.DOCKER_PASSWORD }} +``` +{% endraw %} +{% endif %} -#### **`jobs..services.env`** +#### **`jobs..services..env`** サービスコンテナ中の環境変数の`map`を設定します。 -#### **`jobs..services.ports`** +#### **`jobs..services..ports`** サービスコンテナで公開するポートの`array`を設定します。 -#### **`jobs..services.volumes`** +#### **`jobs..services..volumes`** 使用するサービスコンテナにボリュームの`array`を設定します。 volumes (ボリューム) を使用すると、サービス間で、または1つのジョブのステップ間でデータを共有できます。 指定できるのは、名前付きDockerボリューム、匿名Dockerボリューム、またはホスト上のバインドマウントです。 @@ -1046,7 +1082,7 @@ volumes: - /source/directory:/destination/directory ``` -#### **`jobs..services.options`** +#### **`jobs..services..options`** 追加のDockerコンテナリソースのオプション。 オプションの一覧は、「[`docker create`のオプション](https://docs.docker.com/engine/reference/commandline/create/#options)」を参照してください。 @@ -1076,16 +1112,16 @@ YAMLにおいては、`*`、`[`、`!`は特別なキャラクタです。 パタ #### ブランチやタグにマッチするパターン -| パターン | 説明 | マッチの例 | -| ----------------------------------------------- | ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -| `feature/*` | ワイルドカードの`*`は任意のキャラクタにマッチしますが、スラッシュ（`/`）にはマッチしません。 | -`feature/my-branch`
    -`feature/your-branch` | -| `feature/**` | ワイルドカードの`**`は、ブランチ及びタグ名のスラッシュ（`/`）を含む任意のキャラクタにマッチします。 | -`feature/beta-a/my-branch`
    -`feature/your-branch`
    -`feature/mona/the/octocat` | -| -`master`
    -`releases/mona-the-octcat` | ブランチあるいはタグ名に完全に一致したときにマッチします。 | -`master`
    -`releases/mona-the-octocat` | -| `'*'` | スラッシュ（`/`）を含まないすべてのブランチ及びタグ名にマッチします。 `*`はYAMLにおける特別なキャラクタです。 パターンを`*`で始める場合は、クオートを使わなければなりません。 | -`master`
    -`releases` | -| `'**'` | すべてのブランチ及びタグ名にマッチします。 これは `branches`あるいは`tags`フィルタを使わない場合のデフォルトの動作です。 | -`all/the/branches`
    -`every/tag` | -| `'*feature'` | `*`はYAMLにおける特別なキャラクタです。 パターンを`*`で始める場合は、クオートを使わなければなりません。 | -`mona-feature`
    -`feature`
    -`ver-10-feature` | -| `v2*` | `v2`で始めるブランチ及びタグ名にマッチします。 | -`v2`
    -`v2.0`
    -`v2.9` | -| `v[12].[0-9]+.[0-9]+` | メジャーバージョンが1もしくは2のすべてのセマンティックバージョニングタグにマッチします。 | -`v1.10.1`
    -`v2.0.0` | +| パターン | 説明 | マッチの例 | +| --------------------------------------------- | ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | +| `feature/*` | ワイルドカードの`*`は任意のキャラクタにマッチしますが、スラッシュ（`/`）にはマッチしません。 | -`feature/my-branch`
    -`feature/your-branch` | +| `feature/**` | ワイルドカードの`**`は、ブランチ及びタグ名のスラッシュ（`/`）を含む任意のキャラクタにマッチします。 | -`feature/beta-a/my-branch`
    -`feature/your-branch`
    -`feature/mona/the/octocat` | +| -`main`
    -`releases/mona-the-octcat` | ブランチあるいはタグ名に完全に一致したときにマッチします。 | -`main`
    -`releases/mona-the-octocat` | +| `'*'` | スラッシュ（`/`）を含まないすべてのブランチ及びタグ名にマッチします。 `*`はYAMLにおける特別なキャラクタです。 パターンを`*`で始める場合は、クオートを使わなければなりません。 | -`main`
    -`releases` | +| `'**'` | すべてのブランチ及びタグ名にマッチします。 これは `branches`あるいは`tags`フィルタを使わない場合のデフォルトの動作です。 | -`all/the/branches`
    -`every/tag` | +| `'*feature'` | `*`はYAMLにおける特別なキャラクタです。 パターンを`*`で始める場合は、クオートを使わなければなりません。 | -`mona-feature`
    -`feature`
    -`ver-10-feature` | +| `v2*` | `v2`で始めるブランチ及びタグ名にマッチします。 | -`v2`
    -`v2.0`
    -`v2.9` | +| `v[12].[0-9]+.[0-9]+` | メジャーバージョンが1もしくは2のすべてのセマンティックバージョニングタグにマッチします。 | -`v1.10.1`
    -`v2.0.0` | #### ファイルパスにマッチするパターン diff --git a/translations/ja-JP/content/admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider.md b/translations/ja-JP/content/admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider.md index 52f640135547..aeeaf5f15b2e 100644 --- a/translations/ja-JP/content/admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider.md +++ b/translations/ja-JP/content/admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider.md @@ -1,6 +1,6 @@ --- title: 使用しているアイデンティティプロバイダ外のユーザのためのビルトイン認証の許可 -intro: LDAP、SAML、CASを使うアイデンティティプロバイダへのアクセスを持たないユーザを認証するために、ビルトイン認証を設定できます。 +intro: 'LDAP、SAML、CASを使うアイデンティティプロバイダへのアクセスを持たないユーザを認証するために、ビルトイン認証を設定できます。' redirect_from: - /enterprise/admin/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider - /enterprise/admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider @@ -45,6 +45,6 @@ versions: ### 参考リンク -- /enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap +- /enterprise/{{ page.version }}/admin/guides/user-management/using-ldap - [SAMLの利用](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-saml) - [CASの利用](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-cas) diff --git a/translations/ja-JP/content/admin/authentication/disabling-unauthenticated-sign-ups.md b/translations/ja-JP/content/admin/authentication/disabling-unauthenticated-sign-ups.md index 27a72cb278d5..1a0cc0563990 100644 --- a/translations/ja-JP/content/admin/authentication/disabling-unauthenticated-sign-ups.md +++ b/translations/ja-JP/content/admin/authentication/disabling-unauthenticated-sign-ups.md @@ -4,7 +4,7 @@ redirect_from: - /enterprise/admin/articles/disabling-sign-ups/ - /enterprise/admin/user-management/disabling-unauthenticated-sign-ups - /enterprise/admin/authentication/disabling-unauthenticated-sign-ups -intro: ビルトイン認証を使っている場合、認証されていない人がアカウントを作成するのをブロックできます。 +intro: 'ビルトイン認証を使っている場合、認証されていない人がアカウントを作成するのをブロックできます。' versions: enterprise-server: '*' --- diff --git a/translations/ja-JP/content/admin/authentication/using-cas.md b/translations/ja-JP/content/admin/authentication/using-cas.md index eae1086b87dd..4219a41b8415 100644 --- a/translations/ja-JP/content/admin/authentication/using-cas.md +++ b/translations/ja-JP/content/admin/authentication/using-cas.md @@ -5,7 +5,7 @@ redirect_from: - /enterprise/admin/articles/about-cas-authentication/ - /enterprise/admin/user-management/using-cas - /enterprise/admin/authentication/using-cas -intro: 'CAS は、複数の Web アプリケーションのためのシングルサインオン (SSO) プロトコルです。 CASのユーザアカウントは、ユーザがサインインするまで{% if currentVersion ver_gt "enterprise-server@2.16" %}ユーザライセンス{% else %}シート{% endif %}を消費しません。' +intro: 'CAS は、複数の Web アプリケーションのためのシングルサインオン (SSO) プロトコルです。 A CAS user account does not take up a {% if currentVersion ver_gt "enterprise-server@2.16" %}user license{% else %}seat{% endif %} until the user signs in.' versions: enterprise-server: '*' --- @@ -25,8 +25,8 @@ versions: 以下の属性が利用できます。 -| 属性名 | 種類 | 説明 | -| ------ | -- | ------------------------------------------------------------- | +| 属性名 | 種類 | 説明 | +| ------ | -- | -------------------------------------------------------- | | `ユーザ名` | 必須 | {% data variables.product.prodname_ghe_server %} のユーザ名 | ### CASの設定 diff --git a/translations/ja-JP/content/admin/authentication/using-ldap.md b/translations/ja-JP/content/admin/authentication/using-ldap.md index fb0e18091eeb..ebf827d41fde 100644 --- a/translations/ja-JP/content/admin/authentication/using-ldap.md +++ b/translations/ja-JP/content/admin/authentication/using-ldap.md @@ -59,19 +59,19 @@ LDAPを設定した後、ユーザは自分のLDAPクレデンシャルでイン | 属性名 | 種類 | 説明 | | ------------------------------------------------ | -- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `Host` | 必須 | LDAP のホスト。例: `ldap.example.com` あるいは `10.0.0.30`。 ホスト名が内部ネットワークからしか利用できないなら、まず{% data variables.product.product_location_enterprise %}のDNSを設定してホスト名を内部のネームサーバを使って解決できるようにする必要があるかもしれません。 | +| `Host` | 必須 | LDAP のホスト。例: `ldap.example.com` あるいは `10.0.0.30`。 ホスト名が内部ネットワークからしか利用できないなら、まず{% data variables.product.product_location_enterprise %}のDNSを設定してホスト名を内部のネームサーバを使って解決できるようにする必要があるかもしれません。 | | `ポート` | 必須 | ホストの LDAP サービスが待ち受けるポート。 例：389及び636（LDAPS用）。 | | `Encryption` | 必須 | LDAP サーバーとの通信をセキュアにするために使われる暗号化の方法。 例：plain（暗号化なし）、SSL/LDAPS（最初からの暗号化）、StartTLS（接続後に暗号化通信にアップグレード）。 | | `Domain search user` | 任意 | ユーザのサインインの際に認証のためにユーザのルックアップを行う LDAP ユーザ。 これは通常、サードパーティとのインテグレーションのために特に作成されるサービスアカウントです。 `cn=Administrator,cn=Users,dc=Example,dc=com`のような完全修飾名を使ってください。 Active Directoryでは、ドメイン検索ユーザとして `[DOMAIN]\[USERNAME]`という構文（例：`WINDOWS\Administrator`）を使うこともできます。 | | `Domain search password` | 任意 | ドメイン検索ユーザのためのパスワード。 | | `Administrators group` | 任意 | このグループ内のユーザは、アプライアンスへサインインしたときにサイト管理者に昇格します。 LDAPの管理者グループを設定しなければ、アプライアンスに最初にサインインしたLDAPユーザが自動的にサイト管理者に昇格します。 | | `Domain base` | 必須 | ユーザおよびグループの検索を行う LDAP サブツリーの完全修飾 `Distinguished Name` (DN)。 いくつでも追加できるが、それぞれのグループはユーザが属するのと同じドメインベースで定義されなければなりません。 制限されたユーザグループを指定したなら、それらのグループに属するユーザだけがスコープに入ります。 ドメインベースにはLDAPディレクトリツリーの最上位を指定し、制限されたユーザグループでアクセス制御することをおすすめします。 | -| `Restricted user groups` | 任意 | 指定された場合、このグループ内のユーザだけがログインできます。 指定が必要なのはグループのcommon name（CN）だけで、グループはいくつでも追加できます。 グループが指定されていなければ、指定されたドメインベースのスコープ内の*すべての*ユーザが {% data variables.product.prodname_ghe_server %} インスタンスにサインインできるようになります。 | -| `User ID` | 必須 | 認証を受けようとした LDAP ユーザを特定する LDAP 属性。 マッピングが確立されたら、ユーザは自分の {% data variables.product.prodname_ghe_server %} ユーザ名を変更できます。 このフィールドはほとんどのActive Directoryの環境では`sAMAccountName`にすべきですが、OpenLDAPなどの他のLDAPソリューションでは`uid`になることがあります。 デフォルト値は`uid`です。 | -| `Profile name` | 任意 | ユーザの {% data variables.product.prodname_ghe_server %} プロフィールページに表示される名前。 LDAP Syncが有効化されていなければ、ユーザは自分のプロフィール名を変更できます。 | -| `Emails` | 任意 | ユーザの {% data variables.product.prodname_ghe_server %} アカウントのメールアドレス。 | -| `SSH keys` | 任意 | ユーザの {% data variables.product.prodname_ghe_server %} アカウントにアタッチされた公開 SSH キー。 キーはOpenSSH形式でなければなりません。 | -| `GPG keys` | 任意 | ユーザの {% data variables.product.prodname_ghe_server %} アカウントにアタッチされたGPGキー。 | +| `Restricted user groups` | 任意 | 指定された場合、このグループ内のユーザだけがログインできます。 指定が必要なのはグループのcommon name（CN）だけで、グループはいくつでも追加できます。 グループが指定されていなければ、指定されたドメインベースのスコープ内の*すべての*ユーザが {% data variables.product.prodname_ghe_server %} インスタンスにサインインできるようになります。 | +| `User ID` | 必須 | 認証を受けようとした LDAP ユーザを特定する LDAP 属性。 マッピングが確立されたら、ユーザは自分の {% data variables.product.prodname_ghe_server %} ユーザ名を変更できます。 このフィールドはほとんどのActive Directoryの環境では`sAMAccountName`にすべきですが、OpenLDAPなどの他のLDAPソリューションでは`uid`になることがあります。 デフォルト値は`uid`です。 | +| `Profile name` | 任意 | ユーザの {% data variables.product.prodname_ghe_server %} プロフィールページに表示される名前。 LDAP Syncが有効化されていなければ、ユーザは自分のプロフィール名を変更できます。 | +| `Emails` | 任意 | ユーザの {% data variables.product.prodname_ghe_server %} アカウントのメールアドレス。 | +| `SSH keys` | 任意 | ユーザの {% data variables.product.prodname_ghe_server %} アカウントにアタッチされた公開 SSH キー。 キーはOpenSSH形式でなければなりません。 | +| `GPG keys` | 任意 | ユーザの {% data variables.product.prodname_ghe_server %} アカウントにアタッチされたGPGキー。 | | `Disable LDAP authentication for Git operations` | 任意 | 選択した場合、ユーザが LDAP パスワードで Git の操作の認証を受けるのが[オフ](#disabling-password-authentication-for-git-operations)になります。 | | `Enable LDAP certificate verification` | 任意 | 選択した場合、LDAP 証明書の検証が[オン](#enabling-ldap-certificate-verification)になります。 | | `Synchronization` | 任意 | 選択した場合、LDAP Sync が[オン](#enabling-ldap-sync)になります。 | @@ -97,6 +97,12 @@ TLSと共に使うLDAPサーバの証明書を検証するには、LDAPの設定 #### LDAP Syncの有効化 +{% note %} + +**注釈:** LDAP Sync を使用する Team は、最大 1499 人のメンバーに制限されています。 + +{% endnote %} + LDAP Sync を使うと、{% data variables.product.prodname_ghe_server %} のユーザおよび Team のメンバーシップを、確立された LDAP グループに対して同期できます。 そうすることで、{% data variables.product.prodname_ghe_server %} 内で手作業で行う代わりに、LDAP サーバからユーザのロールベースのアクセス制御を確立できます。 詳細は「[チームを作成する](/enterprise/{{ currentVersion }}/admin/guides/user-management/creating-teams#creating-teams-with-ldap-sync-enabled)」を参照してください。 LDAP Sync を有効化するには、[**Synchronize Emails**]、[**Synchronize SSH Keys**]、または [**Synchronize GPG Keys**] を選択します。 diff --git a/translations/ja-JP/content/admin/authentication/using-saml.md b/translations/ja-JP/content/admin/authentication/using-saml.md index 935cfe5046f9..928555742b23 100644 --- a/translations/ja-JP/content/admin/authentication/using-saml.md +++ b/translations/ja-JP/content/admin/authentication/using-saml.md @@ -33,7 +33,7 @@ versions: {% note %} -**注釈**: ユーザの `NameID` が IdP で変更された場合、ユーザが {% data variables.product.prodname_ghe_server %} インスタンスにサインインしようとすると、エラーメッセージが表示されます。 {% if currentVersion ver_gt "enterprise-server@2.21" %} ユーザのアクセスを復元するには、ユーザアカウントの `NameID` マッピングを更新する必要があります。 詳しい情報については、「[ユーザの SAML `NameID` を更新する](#updating-a-users-saml-nameid)」を参照してください。{% else %} 詳しい情報については、「[エラー: '別のユーザーがすでにアカウントを所有しています'](#error-another-user-already-owns-the-account)」を参照してください。{% endif %} +**注釈**: ユーザの `NameID` が IdP で変更された場合、ユーザが {% data variables.product.prodname_ghe_server %} インスタンスにサインインしようとすると、エラーメッセージが表示されます。 {% if currentVersion ver_gt "enterprise-server@2.21" %}To restore the user's access, you'll need to update the user account's `NameID` mapping. 詳しい情報については、「[ユーザの SAML `NameID` を更新する](#updating-a-users-saml-nameid)」を参照してください。{% else %} 詳しい情報については、「[エラー: '別のユーザーがすでにアカウントを所有しています'](#error-another-user-already-owns-the-account)」を参照してください。{% endif %} {% endnote %} @@ -54,15 +54,15 @@ versions: 以下の属性が利用できます。 `administrator`属性以外の属性の名前は[Management Console](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-management-console/)で変更できます。 -| デフォルトの属性名 | 種類 | 説明 | -| --------------- | -- | -------------------------------------------------------------------------------------------------------------------------------- | +| デフォルトの属性名 | 種類 | 説明 | +| --------------- | -- | --------------------------------------------------------------------------------------------------------------------------- | | `NameID` | 必須 | 永続ユーザ識別子。 任意の名前識別子の形式を使用できます。 どの代替アサーションも指定しない場合、{% data variables.product.prodname_ghe_server %}ユーザ名には`NameID`要素が使用されます。 | -| `administrator` | 任意 | この値が 'true' であれば、ユーザは自動的に管理者に昇格します。 他の値、あるいは値が存在しない場合は、ユーザは通常のユーザアカウントに降格します。 | +| `administrator` | 任意 | この値が 'true' であれば、ユーザは自動的に管理者に昇格します。 他の値、あるいは値が存在しない場合は、ユーザは通常のユーザアカウントに降格します。 | | `ユーザ名` | 任意 | {% data variables.product.prodname_ghe_server %} のユーザ名 | -| `full_name` | 任意 | ユーザのプロフィールページに表示されるユーザ名です。 ユーザはプロビジョニング後に名前を変更できます。 | -| `emails` | 任意 | ユーザのメールアドレス。 複数指定することができます。 | -| `public_keys` | 任意 | ユーザの公開 SSH キー。 複数指定することができます。 | -| `gpg_keys` | 任意 | ユーザの GPG キー。 複数指定することができます。 | +| `full_name` | 任意 | ユーザのプロフィールページに表示されるユーザ名です。 ユーザはプロビジョニング後に名前を変更できます。 | +| `emails` | 任意 | ユーザのメールアドレス。 複数指定することができます。 | +| `public_keys` | 任意 | ユーザの公開 SSH キー。 複数指定することができます。 | +| `gpg_keys` | 任意 | ユーザの GPG キー。 複数指定することができます。 | ### SAMLの設定 @@ -88,7 +88,7 @@ versions: {% if currentVersion ver_gt "enterprise-server@2.21" %} -### {% data variables.product.product_location_enterprise %}へのアクセスの削除 +### {{ site.data.variables.product.product_location_enterprise }}へのアクセスの削除 {% data reusables.enterprise_site_admin_settings.access-settings %} 2. **SAML**を選択してください。 ![サイト管理者設定の "All users" サイドバー項目](/assets/images/enterprise/site-admin-settings/all-users.png) @@ -144,7 +144,7 @@ versions: > 別のユーザが既にアカウントを所有しています。 管理者に認証ログを確認するようご依頼ください。 -このメッセージは通常、その人のユーザ名またはメールアドレスが IdP で変更されたということを示します。 {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_ghe_server %} のユーザアカウントの `NameID` マッピングが IdP のユーザの `NameID` とマッチすることを確認します。 詳しい情報については、「[ユーザの SAML `NameID` の更新](#updating-a-users-saml-nameid)」を参照してください。{% else %} `NameID` マッピングの更新については、{% data variables.contact.contact_ent_support %} にお問い合わせください。{% endif %} +このメッセージは通常、その人のユーザ名またはメールアドレスが IdP で変更されたということを示します。 {% if currentVersion ver_gt "enterprise-server@2.21" %}Ensure that the `NameID` mapping for the user account on {% data variables.product.prodname_ghe_server %} matches the user's `NameID` on your IdP. 詳しい情報については、「[ユーザの SAML `NameID` の更新](#updating-a-users-saml-nameid)」を参照してください。{% else %} `NameID` マッピングの更新については、{% data variables.contact.contact_ent_support %} にお問い合わせください。{% endif %} #### SAMLレスポンスが署名されていなかった場合、あるいは署名が内容とマッチしなかった場合、authログに以下のエラーメッセージが残されます。 diff --git a/translations/ja-JP/content/admin/configuration/command-line-utilities.md b/translations/ja-JP/content/admin/configuration/command-line-utilities.md index f2bc9a3acbec..b8616ed08786 100644 --- a/translations/ja-JP/content/admin/configuration/command-line-utilities.md +++ b/translations/ja-JP/content/admin/configuration/command-line-utilities.md @@ -20,7 +20,8 @@ SSH 管理ユーザとしてサインインした後では、VM 上のどこか このユーティリティは、あらゆる {% data variables.product.prodname_enterprise %} ページの上部にバナーを設定します。 これを使用すればユーザにメッセージを配信することができます。 {% if currentVersion ver_gt "enterprise-server@2.21" %} -{% data variables.product.product_name %} の Enterprise 設定を使用して、お知らせバナーを設定することもできます。 詳しい情報については「[インスタンス上でのユーザメッセージをカスタマイズする](/enterprise/admin/user-management/customizing-user-messages-on-your-instance#creating-a-global-announcement-banner)」を参照してください。 +You can also set an announcement banner using the enterprise settings on +{% data variables.product.product_name %}. 詳しい情報については「[インスタンス上でのユーザメッセージをカスタマイズする](/enterprise/admin/user-management/customizing-user-messages-on-your-instance#creating-a-global-announcement-banner)」を参照してください。 {% endif %} ```shell @@ -181,7 +182,6 @@ ghe-logs-tail ghe-maintenance -h ``` -{% if currentVersion ver_gt "enterprise-server@2.17" %} #### ghe-motd このユーティリティは、管理者が管理シェルを介してインスタンスにアクセスしたときに表示される今日のメッセージ (MOTD) を再表示します。 出力には、インスタンスの状態の概要が含まれます。 @@ -189,7 +189,6 @@ ghe-maintenance -h ```shell ghe-motd ``` -{% endif %} #### ghe-nwo @@ -711,7 +710,7 @@ ghe-support-upload -f path/to/your/file -t ticket-id #### ghe-upgrade -このユーティリティは、アップグレードパッケージをインストール、または確認します。 アップグレードが失敗した場合や中断された場合は、このユーティリティを使用してパッチリリースをロールバックすることもできます。 詳しい情報については、「[{% data variables.product.prodname_ghe_server %} をアップグレードする](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server/)」を参照してください。 +このユーティリティは、アップグレードパッケージをインストール、または確認します。 アップグレードが失敗した場合や中断された場合は、このユーティリティを使用してパッチリリースをロールバックすることもできます。 詳細は「[{% data variables.product.prodname_ghe_server %} をアップグレードする](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server/)」を参照してください。 アップグレードパッケージを確認するには以下のようにします。 ```shell diff --git a/translations/ja-JP/content/admin/configuration/configuring-applications.md b/translations/ja-JP/content/admin/configuration/configuring-applications.md index 7e128f09ea30..eb02f839391c 100644 --- a/translations/ja-JP/content/admin/configuration/configuring-applications.md +++ b/translations/ja-JP/content/admin/configuration/configuring-applications.md @@ -15,5 +15,7 @@ versions: {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} 3. 左のサイドバーで、**Applications（アプリケーション）** をクリックしてください。 ![[Settings] サイドバーでの [Applications] タブ](/assets/images/enterprise/management-console/sidebar-applications.png) -4. [Avatar image cache time (seconds)] で、{% data variables.product.product_location_enterprise %} にアバター画像をキャッシュさせる秒数を入力します。 ![アバター画像キャッシュのフォームフィールド](/assets/images/enterprise/management-console/add-image-caching-value-field.png) +4. Under "Avatar image cache time (seconds)", type the number of seconds that you would like +{% data variables.product.product_location_enterprise %} to cache avatar images. +![アバター画像キャッシュのフォームフィールド](/assets/images/enterprise/management-console/add-image-caching-value-field.png) {% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/ja-JP/content/admin/configuration/configuring-code-scanning-for-your-appliance.md b/translations/ja-JP/content/admin/configuration/configuring-code-scanning-for-your-appliance.md index 8adb29d977be..bd377a043f21 100644 --- a/translations/ja-JP/content/admin/configuration/configuring-code-scanning-for-your-appliance.md +++ b/translations/ja-JP/content/admin/configuration/configuring-code-scanning-for-your-appliance.md @@ -12,7 +12,7 @@ versions: {% data reusables.code-scanning.beta %} -### {% data variables.product.prodname_code_scanning %}について +### {% data variables.product.prodname_code_scanning %} について {% data reusables.code-scanning.about-code-scanning %} @@ -37,7 +37,9 @@ versions: {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_management_console.advanced-security-tab %} -1. [{% data variables.product.prodname_advanced_security %}] で、[**{% data variables.product.prodname_code_scanning_capc %}**] をクリックします。 ![{% data variables.product.prodname_code_scanning %} を有効化または無効化するチェックボックス](/assets/images/enterprise/management-console/enable-code-scanning-checkbox.png) +1. Under " +{% data variables.product.prodname_advanced_security %}," click **{% data variables.product.prodname_code_scanning_capc %}**. +![{% data variables.product.prodname_code_scanning %} を有効化または無効化するチェックボックス](/assets/images/enterprise/management-console/enable-code-scanning-checkbox.png) {% data reusables.enterprise_management_console.save-settings %} @@ -47,6 +49,8 @@ versions: {% data variables.product.prodname_actions %} ベータに登録している場合、{% data variables.product.prodname_ghe_server %} は {% data variables.product.prodname_actions %} ワークフローを使用して {% data variables.product.prodname_code_scanning %} を実行できます。 まず、環境内に 1 つ以上のセルフホスト {% data variables.product.prodname_actions %} ランナーをプロビジョニングする必要があります。 セルフホストランナーは、リポジトリ、Organization、または Enterprise アカウントレベルでプロビジョニングできます。 詳しい情報については、「[セルフホストランナーについて](/actions/hosting-your-own-runners/about-self-hosted-runners)」および「[セルフホストランナーを追加する](/actions/hosting-your-own-runners/adding-self-hosted-runners)」を参照してください。 +You must ensure that Git is in the PATH variable on any self-hosted runners you use to run {% data variables.product.prodname_codeql %} actions. + #### アクションをプロビジョニングする {% data variables.product.prodname_ghe_server %} で {% data variables.product.prodname_actions %} を使用して {% data variables.product.prodname_code_scanning %} を実行するには、適切なアクションがローカルで使用可能である必要があります。 アクションを 3 つの方法で利用可能にすることができます。 @@ -67,7 +71,7 @@ versions: ### {% data variables.product.prodname_codeql_runner %} を使用して {% data variables.product.prodname_code_scanning %} を実行する Organization が {% data variables.product.prodname_actions %} のベータに参加していない場合、または {% data variables.product.prodname_actions %} を使用しない場合は、{% data variables.product.prodname_codeql_runner %} を使用して {% data variables.product.prodname_code_scanning %} を実行できます。 -{% data variables.product.prodname_codeql_runner %} は、サードパーティの CI/CD システムに追加できるコマンドラインツールです。 このツールは、{% data variables.product.prodname_dotcom %} リポジトリのチェックアウトに対して {% data variables.product.prodname_codeql %} 分析を実行します。 詳しい情報については、「[{% data variables.product.prodname_code_scanning %} を CI システムで実行する](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)」を参照してください。 +{% data variables.product.prodname_codeql_runner %} は、サードパーティの CI/CD システムに追加できるコマンドラインツールです。 このツールは、{% data variables.product.prodname_dotcom %} リポジトリのチェックアウトに対して {% data variables.product.prodname_codeql %} 分析を実行します。 詳しい情報については、「[{% data variables.product.prodname_code_scanning %} を CI システムで実行する](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)」を参照してください。 ### {% data variables.product.prodname_code_scanning %} を無効にする @@ -76,5 +80,7 @@ Organization が {% data variables.product.prodname_actions %} のベータに {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_management_console.advanced-security-tab %} -1. [{% data variables.product.prodname_advanced_security %}] で、[**{% data variables.product.prodname_code_scanning_capc %}**] を選択解除します。 ![{% data variables.product.prodname_code_scanning %} を有効化または無効化するチェックボックス](/assets/images/enterprise/management-console/code-scanning-disable.png) +1. Under " +{% data variables.product.prodname_advanced_security %}", unselect **{% data variables.product.prodname_code_scanning_capc %}**. +![{% data variables.product.prodname_code_scanning %} を有効化または無効化するチェックボックス](/assets/images/enterprise/management-console/code-scanning-disable.png) {% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/ja-JP/content/admin/configuration/configuring-rate-limits.md b/translations/ja-JP/content/admin/configuration/configuring-rate-limits.md index 87fcc56b9a61..7cda7be6a344 100644 --- a/translations/ja-JP/content/admin/configuration/configuring-rate-limits.md +++ b/translations/ja-JP/content/admin/configuration/configuring-rate-limits.md @@ -13,7 +13,7 @@ versions: {% data variables.product.prodname_enterprise_api %}のレート制限を有効化すれば、個人あるいは認証されていないユーザによるリソースの過剰な利用を回避できます。 詳しい情報については、「[REST API のリソース](/rest/overview/resources-in-the-rest-api#rate-limiting)」を参照してください。 {% if currentVersion ver_gt "enterprise-server@2.21" %} -{% data variables.product.prodname_enterprise_api %}のレート制限を有効化すれば、個人あるいは認証されていないユーザによるリソースの過剰な利用を回避できます。 For more information, see "[Rate Limiting](/enterprise/{{ currentVersion }}/v3/#rate-limiting)." +{{ site.data.variables.product.prodname_enterprise_api }}のレート制限を有効化すれば、個人あるいは認証されていないユーザによるリソースの過剰な利用を回避できます。 For more information, see "[Rate Limiting](/enterprise/{{ page.version }}/v3/#rate-limiting)." {% endif %} {% note %} diff --git a/translations/ja-JP/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md b/translations/ja-JP/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md index 7366875dfc5a..0336f0d2f51e 100644 --- a/translations/ja-JP/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md +++ b/translations/ja-JP/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md @@ -8,7 +8,15 @@ versions: enterprise-server: '*' --- +{% note %} + +**注釈:** {% data variables.product.prodname_ghe_server %} へのネットワークアダプタの追加はサポートされていません。 + +{% endnote %} + {% data reusables.enterprise_installation.open-vm-console-start %} 3. `IPv4`あるいは`IPv6`プロトコルの設定を選択してください。 ![IPv4 または IPv6 プロトコルを選択するためのオプション](/assets/images/enterprise/network-configuration/IPv4-or-IPv6-protocol.png) 4. 選択したプロトコルのオプションを設定してください。 ![IP プロトコルオプションのメニュー](/assets/images/enterprise/network-configuration/network-settings-selection.png) {% data reusables.enterprise_installation.vm-console-done %} + + diff --git a/translations/ja-JP/content/admin/configuration/configuring-tls.md b/translations/ja-JP/content/admin/configuration/configuring-tls.md index dacde11866a4..b0e4816eeeec 100644 --- a/translations/ja-JP/content/admin/configuration/configuring-tls.md +++ b/translations/ja-JP/content/admin/configuration/configuring-tls.md @@ -26,7 +26,7 @@ SSL が有効な場合、{% data variables.product.prodname_ghe_server %} アプ また、証明書には"[Subdomain Isolationの有効化](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-subdomain-isolation#about-subdomain-isolation)"のリストにあるサブドメインに設定されたSubject Alternative Namesが必要で、中間証明書認証局によって署名されたものであれば、完全な証明書チェーンを含んでいる必要があります。 詳しい情報についてはWikipediaの"[Subject Alternative Name](http://en.wikipedia.org/wiki/SubjectAltName)"を参照してください。 -`ghe-ssl-generate-csr` コマンドを使用すれば、インスタンス用の証明書署名要求 (CSR) を生成できます。 詳しい情報については、「[コマンドラインユーティリティ](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#ghe-ssl-generate-csr)」を参照してください。 +`ghe-ssl-generate-csr` コマンドを使用すれば、インスタンス用の証明書署名要求 (CSR) を生成できます。 詳細は「[コマンドラインユーティリティ](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#ghe-ssl-generate-csr)」を参照してください。 ### カスタムのTLS証明書のアップロード diff --git a/translations/ja-JP/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md b/translations/ja-JP/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md index 7a2b2b4d78ad..d76fe5bd6413 100644 --- a/translations/ja-JP/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md +++ b/translations/ja-JP/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md @@ -37,12 +37,12 @@ versions: {% data variables.product.prodname_github_connect %} を有効化しても、{% data variables.product.prodname_dotcom_the_website %} のユーザは {% data variables.product.prodname_ghe_server %} を変更できるようになりません。 -{% if currentVersion ver_gt "enterprise-server@2.18" %} GraphQL APIを利用したEnterpriseアカウントの管理に関する詳しい情報については、「[Enterprise アカウント](/v4/guides/managing-enterprise-accounts)」を参照してください。 -{% endif %} ### {% data variables.product.prodname_github_connect %} の有効化 -1. {% data variables.product.product_location_enterprise %}と{% data variables.product.prodname_dotcom_the_website %}にサインインしてください。 +1. Sign in to + +{% data variables.product.product_location_enterprise %} and {% data variables.product.prodname_dotcom_the_website %}. {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.settings-tab %} diff --git a/translations/ja-JP/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md b/translations/ja-JP/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md index 62d9a5059798..0685f36002eb 100644 --- a/translations/ja-JP/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md +++ b/translations/ja-JP/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md @@ -1,45 +1,42 @@ --- -title: Enabling alerts for vulnerable dependencies on GitHub Enterprise Server +title: GitHub Enterprise Serverで脆弱性のある依存関係に対するアラートを有効化する intro: 'You can connect {% data variables.product.product_location_enterprise %} to {% data variables.product.prodname_ghe_cloud %} and enable {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies in repositories in your instance.' redirect_from: - /enterprise/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server - /enterprise/admin/configuration/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server - /enterprise/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server - - /enterprise/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server - - /enterprise/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server - - /enterprise/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server permissions: 'Site administrators for {% data variables.product.prodname_ghe_server %} who are also owners of the connected {% data variables.product.prodname_ghe_cloud %} organization or enterprise account can enable {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %}.' versions: enterprise-server: '*' --- -### About alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %} +### {% data variables.product.prodname_ghe_server %} 上の脆弱性のある依存関係に対するアラートについて -{% data reusables.repositories.tracks-vulnerabilities %} For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." +{% data reusables.repositories.tracks-vulnerabilities %} 詳しい情報については、「[脆弱性のある依存関係に対するアラートについて](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)」を参照してください。 You can connect {% data variables.product.product_location_enterprise %} to {% data variables.product.prodname_dotcom_the_website %}, then sync vulnerability data to your instance and generate {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts in repositories with a vulnerable dependency. -After connecting {% data variables.product.product_location_enterprise %} to {% data variables.product.prodname_dotcom_the_website %} and enabling {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies, vulnerability data is synced from {% data variables.product.prodname_dotcom_the_website %} to your instance once every hour. You can also choose to manually sync vulnerability data at any time. No code or information about code from {% data variables.product.product_location_enterprise %} is uploaded to {% data variables.product.prodname_dotcom_the_website %}. +After connecting {% data variables.product.product_location_enterprise %} to {% data variables.product.prodname_dotcom_the_website %} and enabling {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies, vulnerability data is synced from {% data variables.product.prodname_dotcom_the_website %} to your instance once every hour. また、脆弱性データはいつでも手動で同期することができます。 {% data variables.product.product_location_enterprise %} からのコードまたはコードに関する情報は、{% data variables.product.prodname_dotcom_the_website %} にアップロードされません。 -{% if currentVersion ver_gt "enterprise-server@2.21" %}When {% data variables.product.product_location_enterprise %} receives information about a vulnerability, it will identify repositories in your instance that use the affected version of the dependency and send {% data variables.product.prodname_dependabot_short %} alerts to owners and people with admin access in those repositories. They can customize how they receive {% data variables.product.prodname_dependabot_short %} alerts. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/#configuring-notifications-for-github-dependabot-alerts)." +{% if currentVersion ver_gt "enterprise-server@2.21" %}When {% data variables.product.product_location_enterprise %} receives information about a vulnerability, it will identify repositories in your instance that use the affected version of the dependency and send {% data variables.product.prodname_dependabot_short %} alerts to owners and people with admin access in those repositories. {% data variables.product.prodname_dependabot_short %} アラートを受け取る方法をカスタマイズできます。 詳しい情報については、「[脆弱性のある依存関係に対するアラートについて](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/#configuring-notifications-for-github-dependabot-alerts)」を参照してください。 {% endif %} -{% if currentVersion ver_lt "enterprise-server@2.21" or currentVersion == "enterprise-server@2.21" %}When {% data variables.product.product_location_enterprise %} receives information about a vulnerability, it will identify repositories in your instance that use the affected version of the dependency and send security alerts to owners and people with admin access in those repositories. They can customize how they receive security alerts. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/#configuring-notifications-for-security-alerts)." +{% if currentVersion ver_lt "enterprise-server@2.21" or currentVersion == "enterprise-server@2.21" %}When {% data variables.product.product_location_enterprise %} receives information about a vulnerability, it will identify repositories in your instance that use the affected version of the dependency and send security alerts to owners and people with admin access in those repositories. セキュリティアラートの受信方法をカスタマイズすることができます。 詳しい情報については、「[脆弱性のある依存関係に対するアラートについて](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/#configuring-notifications-for-security-alerts)」を参照してください。 {% endif %} {% if currentVersion ver_gt "enterprise-server@2.21" %} -### Enabling {% data variables.product.prodname_dependabot_short %} alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %} +### {% data variables.product.prodname_ghe_server %} 上の脆弱性のある依存関係に対して {% data variables.product.prodname_dependabot_short %} アラートを有効化にする {% else %} -### Enabling security alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %} +### {% data variables.product.prodname_ghe_server %}で脆弱性のある依存関係に対するアラートを有効化する {% endif %} -Before enabling {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies on {% data variables.product.product_location_enterprise %}, you must connect {% data variables.product.product_location_enterprise %} to {% data variables.product.prodname_dotcom_the_website %}. For more information, see "[Connecting {% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_ghe_cloud %}](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)." +Before enabling {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies on {% data variables.product.product_location_enterprise %}, you must connect {% data variables.product.product_location_enterprise %} to {% data variables.product.prodname_dotcom_the_website %}. 詳細は、「[{% data variables.product.prodname_ghe_server %}を{% data variables.product.prodname_ghe_cloud %}に接続する](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)」を参照してください。 -{% if currentVersion ver_gt "enterprise-server@2.20" %} +{% if currentVersion ver_gt "enterprise-server@2.20" %} -{% if currentVersion ver_gt "enterprise-server@2.21" %}We recommend configuring {% data variables.product.prodname_dependabot_short %} alerts without notifications for the first few days to avoid an overload of emails. After a few days, you can enable notifications to receive {% data variables.product.prodname_dependabot_short %} alerts as usual.{% endif %} +{% if currentVersion ver_gt "enterprise-server@2.21" %}We recommend configuring {% data variables.product.prodname_dependabot_short %} alerts without notifications for the first few days to avoid an overload of emails. 数日後、通知を有効化すれば、通常どおり {% data variables.product.prodname_dependabot_short %} アラートを受信できます。{% endif %} -{% if currentVersion == "enterprise-server@2.21" %}We recommend configuring security alerts without notifications for the first few days to avoid an overload of emails. After a few days, you can enable notifications to receive security alerts as usual.{% endif %} +{% if currentVersion == "enterprise-server@2.21" %}We recommend configuring security alerts without notifications for the first few days to avoid an overload of emails. 数日後、通知を有効化すれば、通常どおりセキュリティアラートを受信できます。{% endif %} {% endif %} @@ -48,22 +45,21 @@ Before enabling {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data v ``` shell $ ghe-dep-graph-enable ``` -3. Return to {% data variables.product.prodname_ghe_server %}. +3. Return to +{% data variables.product.prodname_ghe_server %}. {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.github-connect-tab %}{% if currentVersion ver_gt "enterprise-server@2.20" %} -5. Under "Repositories can be scanned for vulnerabilities", use the drop-down menu and select **Enabled without notifications**. Optionally, to enable alerts with notifications, select **Enabled with notifications**.{% else %} -5. Under "Repositories can be scanned for vulnerabilities", use the drop-down menu and select **Enabled**. +5. [Repositories can be scanned for vulnerabilities] で、ドロップダウンメニューを使用して、[**Enabled without notifications**] を選択します。 必要に応じて、通知を含むアラートを有効化にするには、[**Enabled with notifications**] を選択します。{% else %} +5. 「Repositories can be scanned for vulnerabilities」で、ドロップダウンメニューを使用して「**Enabled**」を選択します。 {% endif %} - ![Drop-down menu to enable scanning repositories for vulnerabilities](/assets/images/enterprise/site-admin-settings/enable-vulnerability-scanning-in-repositories.png) + ![脆弱性に対するリポジトリのスキャンを有効化するドロップダウンメニュー](/assets/images/enterprise/site-admin-settings/enable-vulnerability-scanning-in-repositories.png) -### Viewing vulnerable dependencies on {% data variables.product.prodname_ghe_server %} +### {% data variables.product.prodname_ghe_server %}で脆弱性のある依存関係を表示する -You can view all vulnerabilities in {% data variables.product.product_location_enterprise %} and manually sync vulnerability data from {% data variables.product.prodname_dotcom_the_website %} to update the list. +{% data variables.product.product_location_enterprise %}ですべての脆弱性を表示し、{% data variables.product.prodname_dotcom_the_website %}から脆弱性データを手動で同期して、リストを更新することができます。 {% data reusables.enterprise_site_admin_settings.access-settings %} -2. In the left sidebar, click **Vulnerabilities**. - ![Vulnerabilities tab in the site admin sidebar](/assets/images/enterprise/business-accounts/vulnerabilities-tab.png) -3. To sync vulnerability data, click **Sync Vulnerabilities now**. - ![Sync vulnerabilities now button](/assets/images/enterprise/site-admin-settings/sync-vulnerabilities-button.png) +2. 左サイドバーで [**Vulnerabilities**] をクリックします。 ![サイト管理サイドバーの [Vulnerabilities] タブ](/assets/images/enterprise/business-accounts/vulnerabilities-tab.png) +3. 脆弱性データを同期するには、[**Sync Vulnerabilities now**] をクリックします。 ![[Sync vulnerabilities now] ボタン](/assets/images/enterprise/site-admin-settings/sync-vulnerabilities-button.png) diff --git a/translations/ja-JP/content/admin/configuration/enabling-subdomain-isolation.md b/translations/ja-JP/content/admin/configuration/enabling-subdomain-isolation.md index bb1616c0c140..004ec9506800 100644 --- a/translations/ja-JP/content/admin/configuration/enabling-subdomain-isolation.md +++ b/translations/ja-JP/content/admin/configuration/enabling-subdomain-isolation.md @@ -16,28 +16,29 @@ Subdomain Isolationは、クロスサイトスクリプティングや関連す Subdomain Isolation が有効な場合、{% data variables.product.prodname_ghe_server %} はいくつかのパスをサブドメインで置き換えます。 {% if currentVersion ver_gt "enterprise-server@2.21" %} -Docker を {% data variables.product.prodname_registry %} で使用するには、Subdomain Isolation も有効化する必要があります。 詳しい情報については、「[{% data variables.product.prodname_registry %} で使用するために Docker を設定する](/enterprise/{{ currentVersion }}/user/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)」を参照してください。 +To use Docker with +{% data variables.product.prodname_registry %}, you must also enable subdomain isolation. 詳しい情報については、「[{% data variables.product.prodname_registry %} で使用するために Docker を設定する](/enterprise/{{ currentVersion }}/user/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)」を参照してください。 {% data reusables.package_registry.packages-ghes-release-stage %} | {% endif %} -| Subdomain Isolationなしのパス | Subdomain Isolationされたパス | -| --------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- | -| `http(s)://HOSTNAME/assets/` | `http(s)://assets.HOSTNAME/` | -| `http(s)://HOSTNAME/avatars/` | `http(s)://avatars.HOSTNAME/` | -| `http(s)://HOSTNAME/codeload/` | `http(s)://codeload.HOSTNAME/` | -| `http(s)://HOSTNAME/gist/` | `http(s)://gist.HOSTNAME/` | -| `http(s)://HOSTNAME/media/` | `http(s)://media.HOSTNAME/` | -| `http(s)://HOSTNAME/pages/` | `http(s)://pages.HOSTNAME/` | -| `http(s)://HOSTNAME/raw/` | `http(s)://raw.HOSTNAME/` | -| `http(s)://HOSTNAME/render/` | `http(s)://render.HOSTNAME/` | -| `http(s)://HOSTNAME/reply/` | `http(s)://reply.HOSTNAME/` | -| `http(s)://HOSTNAME/uploads/` | `http(s)://uploads.HOSTNAME/` |{% if currentVersion ver_gt "enterprise-server@2.21" %} -| N/A、{% data variables.product.prodname_registry %} を使用した Docker は、Subdomain Isolation を無効化すると機能しません。 | `http(s)://uploads.HOSTNAME/` | -| `https://HOSTNAME/_registry/npm/` | `https://npm.HOSTNAME/` | -| `https://HOSTNAME/_registry/rubygems/` | `https://rubygems.HOSTNAME/` | -| `https://HOSTNAME/_registry/maven/` | `https://maven.HOSTNAME/` | -| `https://HOSTNAME/_registry/nuget/` | `https://nuget.HOSTNAME/`{% endif %} +| Subdomain Isolationなしのパス | Subdomain Isolationされたパス | +| ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | +| `http(s)://HOSTNAME/assets/` | `http(s)://assets.HOSTNAME/` | +| `http(s)://HOSTNAME/avatars/` | `http(s)://avatars.HOSTNAME/` | +| `http(s)://HOSTNAME/codeload/` | `http(s)://codeload.HOSTNAME/` | +| `http(s)://HOSTNAME/gist/` | `http(s)://gist.HOSTNAME/` | +| `http(s)://HOSTNAME/media/` | `http(s)://media.HOSTNAME/` | +| `http(s)://HOSTNAME/pages/` | `http(s)://pages.HOSTNAME/` | +| `http(s)://HOSTNAME/raw/` | `http(s)://raw.HOSTNAME/` | +| `http(s)://HOSTNAME/render/` | `http(s)://render.HOSTNAME/` | +| `http(s)://HOSTNAME/reply/` | `http(s)://reply.HOSTNAME/` | +| `http(s)://HOSTNAME/uploads/` | `http(s)://uploads.HOSTNAME/` |{% if currentVersion ver_gt "enterprise-server@2.21" %} +| N/A、{% data variables.product.prodname_registry %} を使用した Docker は、Subdomain Isolation を無効化すると機能しません。 | `http(s)://uploads.HOSTNAME/` | +| `https://HOSTNAME/_registry/npm/` | `https://npm.HOSTNAME/` | +| `https://HOSTNAME/_registry/rubygems/` | `https://rubygems.HOSTNAME/` | +| `https://HOSTNAME/_registry/maven/` | `https://maven.HOSTNAME/` | +| `https://HOSTNAME/_registry/nuget/` | `https://nuget.HOSTNAME/`{% endif %} ### 必要な環境 diff --git a/translations/ja-JP/content/admin/configuration/index.md b/translations/ja-JP/content/admin/configuration/index.md index 69df91663e03..c179646b07f5 100644 --- a/translations/ja-JP/content/admin/configuration/index.md +++ b/translations/ja-JP/content/admin/configuration/index.md @@ -40,7 +40,7 @@ versions: {% topic_link_in_list /managing-connections-between-github-enterprise-server-and-github-enterprise-cloud %} {% link_in_list /connecting-github-enterprise-server-to-github-enterprise-cloud %} {% link_in_list /enabling-unified-search-between-github-enterprise-server-and-githubcom %} - {% link_in_list /enabling-unified-contributions-between-github-enterprise-server-and-githubcom %} + {% link_in_list /enabling-unified-contributions-between-github-enterprise-server-and-githubcom %} {% link_in_list /enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server %} {% link_in_list /enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud %} @@ -49,3 +49,11 @@ versions: {% topic_link_in_list /configuring-advanced-security-features %} {% link_in_list /configuring-code-scanning-for-your-appliance %} + +{% if currentVersion ver_gt "enterprise-server@2.21" %} +{% note %} + +**Note:** To configure {% data variables.product.prodname_actions %} or {% data variables.product.prodname_registry %} for your enterprise, see "[Managing GitHub Actions for your enterprise](/admin/github-actions)" or "[Managing GitHub Packages for your enterprise](/admin/packages)." + +{% endnote %} +{% endif %} diff --git a/translations/ja-JP/content/admin/configuration/network-ports.md b/translations/ja-JP/content/admin/configuration/network-ports.md index 2b65e1d6754c..3e95063a1831 100644 --- a/translations/ja-JP/content/admin/configuration/network-ports.md +++ b/translations/ja-JP/content/admin/configuration/network-ports.md @@ -7,7 +7,7 @@ redirect_from: - /enterprise/admin/guides/installation/network-ports-to-open/ - /enterprise/admin/installation/network-ports - /enterprise/admin/configuration/network-ports -intro: オープンするネットワークポートは、管理者、エンドユーザ、メールサポートへ公開する必要があるネットワークサービスに応じて選択してください。 +intro: 'オープンするネットワークポートは、管理者、エンドユーザ、メールサポートへ公開する必要があるネットワークサービスに応じて選択してください。' versions: enterprise-server: '*' --- @@ -16,25 +16,25 @@ versions: {% data variables.product.product_location_enterprise %}を設定し、一部の機能を実行するためにはいくつかの管理ポートが必要です。 管理ポートは、エンドユーザが基本的なアプリケーションを利用するためには必要ありません。 -| ポート | サービス | 説明 | -| -------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| ポート | サービス | 説明 | +| -------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 8443 | HTTPS | 安全な Web ベースの {% data variables.enterprise.management_console %}。 基本的なインストールと設定に必要です。 | | 8080 | HTTP | プレーンテキストの Web ベースの {% data variables.enterprise.management_console %}。 SSL を手動で無効にしない限り必要ありません。 | | 122 | SSH | {% data variables.product.product_location_enterprise %} 用のシェルアクセス。 High Availability 設定では他のすべてのノードからの着信接続に対して開かれている必要があります。 デフォルトの SSHポート (22) は Git と SSH のアプリケーションネットワークトラフィック専用です。 | -| 1194/UDP | VPN | High Availability設定でのセキュアなレプリケーションネットワークトンネル。 その設定では他のすべてのノードに対して開かれている必要があります。 | -| 123/UDP | NTP | timeプロトコルの処理に必要。 | -| 161/UDP | SNMP | ネットワークモニタリングプロトコルの処理に必要。 | +| 1194/UDP | VPN | High Availability設定でのセキュアなレプリケーションネットワークトンネル。 その設定では他のすべてのノードに対して開かれている必要があります。 | +| 123/UDP | NTP | timeプロトコルの処理に必要。 | +| 161/UDP | SNMP | ネットワークモニタリングプロトコルの処理に必要。 | ### エンドユーザーのためのアプリケーションポート アプリケーションのポートは、エンドユーザーにWebアプリケーションとGitへのアクセスを提供します。 -| ポート | サービス | 説明 | -| ---- | ----- | --------------------------------------------------------------------- | -| 443 | HTTPS | WebアプリケーションとGit over HTTPSのアクセス。 | -| 80 | HTTP | Web アプリケーションへのアクセス。 SSL が有効な場合にすべての要求は HTTPS ポートにリダイレクトされます。 | -| 22 | SSH | Git over SSH へのアクセス。 パブリックとプライベートリポジトリへの clone、fetch、push 操作をサポートします。 | -| 9418 | Git | Gitプロトコルのポート。暗号化されないネットワーク通信でのパブリックなリポジトリへのclone及びfetch操作をサポートする。 | +| ポート | サービス | 説明 | +| ---- | ----- | ---------------------------------------------------------------------------------------------------------------------------------- | +| 443 | HTTPS | WebアプリケーションとGit over HTTPSのアクセス。 | +| 80 | HTTP | Web アプリケーションへのアクセス。 SSL が有効な場合にすべての要求は HTTPS ポートにリダイレクトされます。 | +| 22 | SSH | Git over SSH へのアクセス。 パブリックとプライベートリポジトリへの clone、fetch、push 操作をサポートします。 | +| 9418 | Git | Gitプロトコルのポート。暗号化されないネットワーク通信でのパブリックなリポジトリへのclone及びfetch操作をサポートする。 {% data reusables.enterprise_installation.when-9418-necessary %} {% data reusables.enterprise_installation.terminating-tls %} diff --git a/translations/ja-JP/content/admin/configuration/site-admin-dashboard.md b/translations/ja-JP/content/admin/configuration/site-admin-dashboard.md index e97aca0e29a7..2d511ea9666d 100644 --- a/translations/ja-JP/content/admin/configuration/site-admin-dashboard.md +++ b/translations/ja-JP/content/admin/configuration/site-admin-dashboard.md @@ -15,7 +15,7 @@ versions: ### 検索 -ここで、ドメインや認証、SSL などの仮想アプライアンスの設定を管理するための {% data variables.enterprise.management_console %}を起動することができます。 +ここで、ドメインや認証、SSL などの仮想アプライアンスの設定を管理するための {{ site.data.variables.enterprise.management_console }}を起動することができます。 {% else %} @@ -162,7 +162,7 @@ GitHub の[コード検索][]フィーチャは、[Elasticsearch][] に駆動さ ### 全ユーザ -ここでは、{% data variables.product.product_location_enterprise %} で一時停止されているすべてのユーザーを確認することができ、そして [SSH キー監査を開始する](/enterprise/{{ currentVersion }}/admin/guides/user-management/auditing-ssh-keys)ことができます。 +ここでは、{{ site.data.variables.product.product_location_enterprise }} で一時停止されているすべてのユーザーを確認することができ、そして [SSH キー監査を開始する](/enterprise/{{ page.version }}/admin/guides/user-management/auditing-ssh-keys)ことができます。 {% endif %} diff --git a/translations/ja-JP/content/admin/configuration/troubleshooting-ssl-errors.md b/translations/ja-JP/content/admin/configuration/troubleshooting-ssl-errors.md index 8fdef5aa060e..3c6f5fb0ab09 100644 --- a/translations/ja-JP/content/admin/configuration/troubleshooting-ssl-errors.md +++ b/translations/ja-JP/content/admin/configuration/troubleshooting-ssl-errors.md @@ -1,6 +1,6 @@ --- title: SSLのエラーのトラブルシューティング -intro: アプライアンスでSSLの問題が生じたなら、解決のためのアクションを取ってください。 +intro: 'アプライアンスでSSLの問題が生じたなら、解決のためのアクションを取ってください。' redirect_from: - /enterprise/admin/articles/troubleshooting-ssl-errors/ - /enterprise/admin/categories/dns-ssl-and-subdomain-configuration/ diff --git a/translations/ja-JP/content/admin/enterprise-management/about-geo-replication.md b/translations/ja-JP/content/admin/enterprise-management/about-geo-replication.md index 50101d33fc90..a8cba2fc7453 100644 --- a/translations/ja-JP/content/admin/enterprise-management/about-geo-replication.md +++ b/translations/ja-JP/content/admin/enterprise-management/about-geo-replication.md @@ -18,7 +18,7 @@ Geo-replicationがスムーズに動作するためには、[Amazon's Route 53 ### 制限事項 -レプリカへの書き込みリクエストには、データをプライマリとすべてのレプリカへ送信することが必要です。 これはすなわち、すべての書き込みのパフォーマンスは最も低速なレプリカによって制約されるということです。{% if currentVersion ver_gt "enterprise-server@2.17" %}ただし、Geoレプリカは、大部分のデータをプライマリからではなく、既存の共在するGeoレプリカからシードできます。{% endif %} Geo-replication は、{% data variables.product.prodname_ghe_server %} インスタンスに容量を追加したり、不十分な CPU やメモリリソースに関連するパフォーマンスの問題を解決したりしません。 プライマリのアプライアンスがオフラインである場合、アクティブなレプリカはいかなる読み込みや書き込みのリクエストも処理できません。 +レプリカへの書き込みリクエストには、データをプライマリとすべてのレプリカへ送信することが必要です。 This means that the performance of all writes are limited by the slowest replica, although new geo-replicas can seed the majority of their data from existing co-located geo-replicas, rather than from the primary. Geo-replication は、{% data variables.product.prodname_ghe_server %} インスタンスに容量を追加したり、不十分な CPU やメモリリソースに関連するパフォーマンスの問題を解決したりしません。 プライマリのアプライアンスがオフラインである場合、アクティブなレプリカはいかなる読み込みや書き込みのリクエストも処理できません。 ### Geo-replication設定のモニタリング diff --git a/translations/ja-JP/content/admin/enterprise-management/about-high-availability-configuration.md b/translations/ja-JP/content/admin/enterprise-management/about-high-availability-configuration.md index db5c6fb5d197..d9c28e97fcab 100644 --- a/translations/ja-JP/content/admin/enterprise-management/about-high-availability-configuration.md +++ b/translations/ja-JP/content/admin/enterprise-management/about-high-availability-configuration.md @@ -52,7 +52,7 @@ Geo-replication を使用している場合は、トラフィックを最も近 `ghe-repl-setup` コマンドは、{% data variables.product.prodname_ghe_server %} アプライアンスをレプリカスタンバイモードにします。 - - 2 つのアプライアンス間の通信のために、暗号化された{% if currentVersion ver_gt "enterprise-server@2.17" %}WireGuard VPN{% else %}OpenVPN{% endif %}トンネルが設定されます。 + - An encrypted WireGuard VPN tunnel is configured for communication between the two appliances. - レプリケーションのためのデータベースサービスが設定され、起動されます。 - アプリケーションサービスは無効化されます。 HTTP、Git、あるいはその他のサポートされているプロトコルでレプリカアプライアンスへアクセスしようとすると、"appliance in replica mode"メンテナンスページあるいはエラーメッセージが返されます。 @@ -71,8 +71,7 @@ To disable replica mode and undo these changes, run `ghe-repl-teardown'. `ghe-repl-start`コマンドは、すべてのデータストアのアクティブなレプリケーションを有効化します。 ```shell -admin@169-254-1-2:~$ ghe-repl-start{% if currentVersion ver_lt "enterprise-server@2.18" %} -Starting OpenVPN tunnel ... {% endif %} +admin@169-254-1-2:~$ ghe-repl-start Starting MySQL replication ... Starting Redis replication ... Starting Elasticsearch replication ... @@ -144,8 +143,7 @@ Stopping Pages replication ... Stopping Git replication ... Stopping MySQL replication ... Stopping Redis replication ... -Stopping Elasticsearch replication ...{% if currentVersion ver_lt "enterprise-server@2.18" %} -Stopping OpenVPN tunnel ...{% endif %} +Stopping Elasticsearch replication ... Success: replication was stopped for all services. ``` @@ -163,8 +161,7 @@ Stopping replication ... | Stopping Git replication ... | Stopping MySQL replication ... | Stopping Redis replication ... - | Stopping Elasticsearch replication ...{% if currentVersion ver_lt "enterprise-server@2.18" %} - | Stopping OpenVPN tunnel ...{% endif %} + | Stopping Elasticsearch replication ... | Success: replication was stopped for all services. Switching out of replica mode ... | Success: Replication configuration has been removed. diff --git a/translations/ja-JP/content/admin/enterprise-management/accessing-the-monitor-dashboard.md b/translations/ja-JP/content/admin/enterprise-management/accessing-the-monitor-dashboard.md index 6ebfaf03d673..50e99267b626 100644 --- a/translations/ja-JP/content/admin/enterprise-management/accessing-the-monitor-dashboard.md +++ b/translations/ja-JP/content/admin/enterprise-management/accessing-the-monitor-dashboard.md @@ -24,10 +24,10 @@ versions: モニターダッシュボードを使ってアプライアンスリソースの健全性を把握し、高利用率の問題の解決方法を判断してください。 -| 問題 | 考えられる原因 | 推奨される対応 | -| --------------- | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| 高いCPU消費 | 同一ホスト上で動作する他のサービスやプログラムとのVM競合 | 可能であれば、CPU消費を下げるように他のサービスやプログラムを再設定する。 VMの総CPUリソースを増加させる方法については"[CPUあるいはメモリリソースの増加](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)"を参照してください。 | -| 高いメモリ消費 | 同一ホスト上で動作する他のサービスやプログラムとのVM競合 | 可能であれば、メモリ消費を下げるように他のサービスやプログラムを再設定する。 VMで利用できるの総メモリ量を増加させる方法については"[CPUあるいはメモリリソースの増加](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)"を参照してください。 | -| ディスクの空き容量の低下 | 大きなバイナリあるいはログファイルによるディスク領域の消費 | 可能であれば大きなバイナリは個別のサーバー上に置き、ログファイルは圧縮もしくはアーカイブする。 必要であれば、使用しているプラットフォームで"[ストレージ容量の増加](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity/)"のステップを踏み、VM上のディスク領域を増やしてください。 | -| 通常よりも長いレスポンスタイム | 多くの場合上記のいずれかの問題によって生ずる | 原因となっている問題を特定して修復してください。 それでもレスポンスタイムが長い場合は、{% data variables.contact.contact_ent_support %} に連絡してください。 | +| 問題 | 考えられる原因 | 推奨される対応 | +| --------------- | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 高いCPU消費 | 同一ホスト上で動作する他のサービスやプログラムとのVM競合 | 可能であれば、CPU消費を下げるように他のサービスやプログラムを再設定する。 VMの総CPUリソースを増加させる方法については"[CPUあるいはメモリリソースの増加](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)"を参照してください。 | +| 高いメモリ消費 | 同一ホスト上で動作する他のサービスやプログラムとのVM競合 | 可能であれば、メモリ消費を下げるように他のサービスやプログラムを再設定する。 VMで利用できるの総メモリ量を増加させる方法については"[CPUあるいはメモリリソースの増加](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)"を参照してください。 | +| ディスクの空き容量の低下 | 大きなバイナリあるいはログファイルによるディスク領域の消費 | 可能であれば大きなバイナリは個別のサーバー上に置き、ログファイルは圧縮もしくはアーカイブする。 必要であれば、使用しているプラットフォームで"[ストレージ容量の増加](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity/)"のステップを踏み、VM上のディスク領域を増やしてください。 | +| 通常よりも長いレスポンスタイム | 多くの場合上記のいずれかの問題によって生ずる | 原因となっている問題を特定して修復してください。 それでもレスポンスタイムが長い場合は、{% data variables.contact.contact_ent_support %} に連絡してください。 | | エラーレートの増大 | ソフトウェアの問題 | {% data variables.contact.contact_ent_support %}に連絡し、Support Bundleを含めてください。 詳細は「[{% data variables.product.prodname_enterprise %} Support にデータを提供する](/enterprise/{{ currentVersion}}/admin/guides/enterprise-support/providing-data-to-github-support#creating-and-sharing-support-bundles)」を参照してください。 | diff --git a/translations/ja-JP/content/admin/enterprise-management/cluster-network-configuration.md b/translations/ja-JP/content/admin/enterprise-management/cluster-network-configuration.md index 9e7f80d0d2c3..bf7c71f90e8a 100644 --- a/translations/ja-JP/content/admin/enterprise-management/cluster-network-configuration.md +++ b/translations/ja-JP/content/admin/enterprise-management/cluster-network-configuration.md @@ -71,7 +71,6 @@ versions: | 8302/UDP | Consul | | 25827/UDP | Collectd | - ### ロードバランサの設定 ノード間のトラフィックの分配には、PROXY プロトコルをサポートする TCP ベースの外部ロードバランサをおすすめします。 以下のロードバランサ設定を検討してください: diff --git a/translations/ja-JP/content/admin/enterprise-management/creating-a-high-availability-replica.md b/translations/ja-JP/content/admin/enterprise-management/creating-a-high-availability-replica.md index 3f9ab38cfe5e..0c50324891fe 100644 --- a/translations/ja-JP/content/admin/enterprise-management/creating-a-high-availability-replica.md +++ b/translations/ja-JP/content/admin/enterprise-management/creating-a-high-availability-replica.md @@ -1,6 +1,6 @@ --- title: High Availabilityレプリカの作成 -intro: アクティブ／パッシブ設定では、レプリカアプライアンスはプライマリアプライアンスの冗長コピーです。 プライマリアプライアンスに障害が起こると、High Availabilityモードではレプリカがプライマリアプライアンスとして動作し、サービスの中断を最小限にできます。 +intro: 'アクティブ／パッシブ設定では、レプリカアプライアンスはプライマリアプライアンスの冗長コピーです。 プライマリアプライアンスに障害が起こると、High Availabilityモードではレプリカがプライマリアプライアンスとして動作し、サービスの中断を最小限にできます。' redirect_from: - /enterprise/admin/installation/creating-a-high-availability-replica - /enterprise/admin/enterprise-management/creating-a-high-availability-replica @@ -49,7 +49,7 @@ versions: (replica2)$ ghe-repl-setup --add PRIMARY IP (replica2)$ ghe-repl-start ``` -3. デフォルトでは、レプリカは同じデータセンターに設定され{% if currentVersion ver_gt "enterprise-server@2.17" %}、同じノードにある既存のノードからシードを試行し{% endif %}ます。 レプリカを別のデータセンターに設定するには、datacenter オプションに異なる値を設定します。 具体的な値は、それらが互いに異なる限り、どのようなものでもかまいません。 各ノードで `ghe-repl-node` コマンドを実行し、データセンターを指定します。 +3. By default, replicas are configured to the same datacenter, and will now attempt to seed from an existing node in the same datacenter. レプリカを別のデータセンターに設定するには、datacenter オプションに異なる値を設定します。 具体的な値は、それらが互いに異なる限り、どのようなものでもかまいません。 各ノードで `ghe-repl-node` コマンドを実行し、データセンターを指定します。 プライマリでは以下のコマンドを実行します。 ```shell diff --git a/translations/ja-JP/content/admin/enterprise-management/increasing-storage-capacity.md b/translations/ja-JP/content/admin/enterprise-management/increasing-storage-capacity.md index c5ede9e58269..8176808d410c 100644 --- a/translations/ja-JP/content/admin/enterprise-management/increasing-storage-capacity.md +++ b/translations/ja-JP/content/admin/enterprise-management/increasing-storage-capacity.md @@ -1,6 +1,6 @@ --- title: ストレージ容量の増加 -intro: Gitリポジトリ、データベース、検索インデックス、その他の恒久的なアプリケーションデータに利用できるストレージの量は、追加あるいは変更できます。 +intro: 'Gitリポジトリ、データベース、検索インデックス、その他の恒久的なアプリケーションデータに利用できるストレージの量は、追加あるいは変更できます。' redirect_from: - /enterprise/admin/installation/increasing-storage-capacity - /enterprise/admin/enterprise-management/increasing-storage-capacity diff --git a/translations/ja-JP/content/admin/enterprise-management/index.md b/translations/ja-JP/content/admin/enterprise-management/index.md index b349ec47c7e2..082bf5c3aa02 100644 --- a/translations/ja-JP/content/admin/enterprise-management/index.md +++ b/translations/ja-JP/content/admin/enterprise-management/index.md @@ -3,14 +3,12 @@ title: 'Monitoring, managing, and updating your enterprise' intro: 'You can monitor your appliance, upgrade to a newer version, and configure clustering or high availability' redirect_from: - /enterprise/admin/enterprise-management - - /enterprise/admin/enterprise-management - - /enterprise/admin/enterprise-management versions: enterprise-server: '*' --- -### Table of Contents +### 目次 {% topic_link_in_list /monitoring-your-appliance %} {% link_in_list /accessing-the-monitor-dashboard %} @@ -18,8 +16,7 @@ versions: {% link_in_list /setting-up-external-monitoring %} {% link_in_list /configuring-collectd %} {% link_in_list /log-forwarding %} - {% link_in_list /monitoring-using-snmp %}{% if currentVersion ver_gt "enterprise-server@2.21" %} - {% link_in_list /monitoring-using-analytics %}{% endif %} + {% link_in_list /monitoring-using-snmp %} {% topic_link_in_list /updating-the-virtual-machine-and-physical-resources %} {% link_in_list /upgrade-requirements %} {% link_in_list /upgrading-github-enterprise-server %} diff --git a/translations/ja-JP/content/admin/enterprise-management/initializing-the-cluster.md b/translations/ja-JP/content/admin/enterprise-management/initializing-the-cluster.md index 222ac5b6f4b6..844558b4ba93 100644 --- a/translations/ja-JP/content/admin/enterprise-management/initializing-the-cluster.md +++ b/translations/ja-JP/content/admin/enterprise-management/initializing-the-cluster.md @@ -17,7 +17,7 @@ versions: ### 最初のノードの設定 -1. `cluster.conf`中で`mysql-master`に指定されるノードに接続してください。 詳しい情報については「[クラスタの設定について](/enterprise/{{ currentVersion }}/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)」を参照してください。 +1. `cluster.conf` で MySQL プライマリとして指定されるノードに接続します。 詳しい情報については、「[クラスタ設定ファイルについて](/enterprise/{{ currentVersion }}/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)」を参照してください。 2. Webブラウザで`https://:8443/setup/`にアクセスしてください。 {% data reusables.enterprise_installation.upload-a-license-file %} {% data reusables.enterprise_installation.save-settings-in-web-based-mgmt-console %} @@ -43,7 +43,7 @@ versions: ノードの名前には、ホスト名として有効な任意の名前を選択できます。 この名前は各ノードのホスト名として設定され、各ノードの`/etc/hosts`に追加され、各ノードがローカルでお互いを解決できるようにします。 -設定した最初のクラスタノードを、`mysql-server`及び`mysql-master`でMySQLのマスターとして指定してください。 +設定した最初のクラスタノードを、`mysql-server` および `mysql-master`で MySQL のプライマリとして指定してください。 ``` [cluster] diff --git a/translations/ja-JP/content/admin/enterprise-management/monitoring-cluster-nodes.md b/translations/ja-JP/content/admin/enterprise-management/monitoring-cluster-nodes.md index 6d6c8ba3409d..c38c9ffa1b17 100644 --- a/translations/ja-JP/content/admin/enterprise-management/monitoring-cluster-nodes.md +++ b/translations/ja-JP/content/admin/enterprise-management/monitoring-cluster-nodes.md @@ -1,15 +1,16 @@ --- -title: Monitoring cluster nodes -intro: 'A {% data variables.product.prodname_ghe_server %} cluster is comprised of redundant services that are distributed across two or more nodes. If an individual service or an entire node were to fail, it should not be immediately apparent to users of the cluster. However since performance and redundancy are affected, it is important to monitor the health of a {% data variables.product.prodname_ghe_server %} cluster.' +title: クラスタノードのモニタリング +intro: '{% data variables.product.prodname_ghe_server %} クラスタは、2 つ以上のノードに分散された冗長サービスで構成されています。 もしも個々のサービスまたは1つのノード全体に障害があっても、それがクラスタのユーザに即座に見えることはありません。 ただし、パフォーマンスと冗長性が影響を受けるため、{% data variables.product.prodname_ghe_server %} クラスタの健全性を監視することが重要です。' redirect_from: - /enterprise/admin/clustering/monitoring-cluster-nodes - /enterprise/admin/enterprise-management/monitoring-cluster-nodes versions: enterprise-server: '*' --- -### Manually checking cluster status -{% data variables.product.prodname_ghe_server %} has a built-in command line utility for monitoring the health of the cluster. From the administrative shell, running the `ghe-cluster-status` command executes a series of health checks on each node including verification of connectivity and service status. The output shows all test results including the text `ok` or `error`. For example, to only display failing tests, run: +### クラスタのステータスの手動でのチェック + +{% data variables.product.prodname_ghe_server %} には、クラスタの健全性をモニタリングするためのコマンドラインユーティリティが組み込まれています。 管理シェルから`ghe-cluster-status`コマンドを実行すると、接続性やサービスステータスの検証を含む一連のヘルスチェックが各ノード上で実行されます。 結果出力には、すべてのテスト結果にtext `ok`もしくは`error`が含まれます。 たとえば失敗したテストだけを表示するには以下のようにしてください。 ```shell admin@ghe-data-node-0:~$ ghe-cluster-status | grep error @@ -18,20 +19,20 @@ admin@ghe-data-node-0:~$ ghe-cluster-status | grep error ``` {% note %} -**Note:** If there are no failing tests, this command produces no output. This indicates the cluster is healthy. +**メモ:** すべてのテストにパスした場合、このコマンドは何も出力しません。 これはクラスタが健全であることを意味します。 {% endnote %} -### Monitoring cluster status with Nagios +### Nagiosでのクラスタステータスのモニタリング -You can configure [Nagios](https://www.nagios.org/) to monitor {% data variables.product.prodname_ghe_server %}. In addition to monitoring basic connectivity to each of the cluster nodes, you can check the cluster status by configuring Nagios to use the `ghe-cluster-status -n` command. This returns output in a format that Nagios understands. +{% data variables.product.prodname_ghe_server %} をモニタリングするよう、[Nagios](https://www.nagios.org/) を設定できます。 各クラスタノードの基本的な接続性のモニタリングに加えて、`ghe-cluster-status -n`コマンドを使うようNagiosを設定してクラスタステータスをチェックできます。 これは、Nagiosが理解できるフォーマットの出力を返します。 -#### Prerequisites -* Linux host running Nagios. -* Network access to the {% data variables.product.prodname_ghe_server %} cluster. +#### 必要な環境 +* Nagiosを動作させるLinuxのホスト。 +* {% data variables.product.prodname_ghe_server %}クラスターへのネットワークアクセス。 -#### Configuring the Nagios host -1. Generate an SSH key with a blank passphrase. Nagios uses this to authenticate to the {% data variables.product.prodname_ghe_server %} cluster. +#### Nagiosホストの設定 +1. 空のパスフレーズで SSH キーを生成してください。 Nagios はこれを使用して {% data variables.product.prodname_ghe_server %} クラスタへの認証を行います。 ```shell nagiosuser@nagios:~$ ssh-keygen -t rsa -b 4096 > Generating public/private rsa key pair. @@ -43,18 +44,19 @@ You can configure [Nagios](https://www.nagios.org/) to monitor {% data variables ``` {% danger %} - **Security Warning:** An SSH key without a passphrase can pose a security risk if authorized for full access to a host. Limit this key's authorization to a single read-only command. + {{#danger}} + **セキュリティの警告:** パスフレーズを持たない SSH キーは、ホストへの完全なアクセスを承認されていた場合、セキュリティリスクになることがあります。 このキーの承認は、単一の読み取りのみのコマンドに限定してください。 {% enddanger %} -2. Copy the private key (`id_rsa`) to the `nagios` home folder and set the appropriate ownership. +2. 秘密鍵 (`id_rsa`) を `nagios` ホームフォルダにコピーし、適切な所有権を設定します。 ```shell nagiosuser@nagios:~$ sudo cp .ssh/id_rsa /var/lib/nagios/.ssh/ nagiosuser@nagios:~$ sudo chown nagios:nagios /var/lib/nagios/.ssh/id_rsa ``` -3. To authorize the public key to run *only* the `ghe-cluster-status -n` command, use a `command=` prefix in the `/data/user/common/authorized_keys` file. From the administrative shell on any node, modify this file to add the public key generated in step 1. For example: `command="/usr/local/bin/ghe-cluster-status -n" ssh-rsa AAAA....` +3. `ghe-cluster-status -n` コマンド*のみ*を実行するために公開鍵を認証するには、`/data/user/common/authorized_keys` ファイル中で `command=` プレフィックスを使ってください。 任意のノードの管理シェルから、このファイルを変更してステップ1で生成した公開鍵を追加してください。 例: `command="/usr/local/bin/ghe-cluster-status -n" ssh-rsa AAAA....` -4. Validate and copy the configuration to each node in the cluster by running `ghe-cluster-config-apply` on the node where you modified the `/data/user/common/authorized_keys` file. +4. `/data/user/common/authorized_keys` ファイルを変更したノード上で `ghe-cluster-config-apply` を実行し、設定を検証してクラスタ内の各ノードにコピーしてください。 ```shell admin@ghe-data-node-0:~$ ghe-cluster-config-apply @@ -63,14 +65,15 @@ You can configure [Nagios](https://www.nagios.org/) to monitor {% data variables > Finished cluster configuration ``` -5. To test that the Nagios plugin can successfully execute the command, run it interactively from Nagios host. +5. Nagios プラグインがこのコマンドの実行をうまく行えることをテストするには、このコマンドを Nagios のホストからインタラクティブに実行してください。 ```shell nagiosuser@nagios:~$ /usr/lib/nagios/plugins/check_by_ssh -l admin -p 122 -H hostname -C "ghe-cluster-status -n" -t 30 > OK - No errors detected ``` -6. Create a command definition in your Nagios configuration. - ###### Example definition +6. Nagios の設定中にコマンド定義を作成してください。 + + ###### 定義の例 ``` define command { @@ -78,9 +81,10 @@ You can configure [Nagios](https://www.nagios.org/) to monitor {% data variables command_line $USER1$/check_by_ssh -H $HOSTADDRESS$ -C "ghe-cluster-status -n" -l admin -p 122 -t 30 } ``` -7. Add this command to a service definition for a node in the {% data variables.product.prodname_ghe_server %} cluster. +7. このコマンドを {% data variables.product.prodname_ghe_server %} クラスタ内のノードのサービス定義に追加します。 + - ###### Example definition + ###### 定義の例 ``` define host{ @@ -98,6 +102,6 @@ You can configure [Nagios](https://www.nagios.org/) to monitor {% data variables } ``` -Once you add the definition to Nagios, the service check executes according to your configuration. You should be able to see the newly configured service in the Nagios web interface. +Nagios に定義を追加すると、設定に従ってサービスチェックが実行されます。 Nagios の Web インターフェースで新しく設定されたサービスを確認することができます。 -![Nagios Example](/assets/images/enterprise/cluster/nagios-example.png) +![Nagios の例](/assets/images/enterprise/cluster/nagios-example.png) diff --git a/translations/ja-JP/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources.md b/translations/ja-JP/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources.md index ef757adcf023..cbbafcb2943e 100644 --- a/translations/ja-JP/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources.md +++ b/translations/ja-JP/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources.md @@ -1,6 +1,6 @@ --- title: 仮想マシンと物理リソースのアップデート -intro: 仮想ソフトウェアと仮想ハードウェアをアップグレードするためには、インスタンスのダウンタイムが必要になるので、事前にアップグレードについて計画をしておいてください。 +intro: '仮想ソフトウェアと仮想ハードウェアをアップグレードするためには、インスタンスのダウンタイムが必要になるので、事前にアップグレードについて計画をしておいてください。' redirect_from: - '/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-the-vm/' - '/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-physical-resources/' diff --git a/translations/ja-JP/content/admin/enterprise-management/upgrade-requirements.md b/translations/ja-JP/content/admin/enterprise-management/upgrade-requirements.md index 5f54d502caac..8ac08214c503 100644 --- a/translations/ja-JP/content/admin/enterprise-management/upgrade-requirements.md +++ b/translations/ja-JP/content/admin/enterprise-management/upgrade-requirements.md @@ -39,4 +39,4 @@ curl -s http://localhost:9201/audit_log/_stats/store | jq ._all.primaries.store. ``` MySQLの監査ログで必要なディスク容量の概算には、この数字を使用します。 スクリプトは、インポートの進行中に空きディスク容量も監視します。 この数字を監視しておくと、空きディスク容量が、移行に必要なディスク容量に近い場合に特に便利です。 -これらの推奨および要求事項をレビューした後で、{% data variables.product.prodname_ghe_server %} をアップグレードできます。 詳しい情報については、「[{% data variables.product.prodname_ghe_server %} をアップグレードする](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server/)」を参照してください。 +これらの推奨および要求事項をレビューした後で、{% data variables.product.prodname_ghe_server %} をアップグレードできます。 詳細は「[{% data variables.product.prodname_ghe_server %} をアップグレードする](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server/)」を参照してください。 diff --git a/translations/ja-JP/content/admin/enterprise-management/upgrading-a-cluster.md b/translations/ja-JP/content/admin/enterprise-management/upgrading-a-cluster.md index e799dc3f660b..a4db61e530d9 100644 --- a/translations/ja-JP/content/admin/enterprise-management/upgrading-a-cluster.md +++ b/translations/ja-JP/content/admin/enterprise-management/upgrading-a-cluster.md @@ -50,7 +50,7 @@ versions: #### クラスタノードのアップグレード 1. 任意のクラスタノードの管理シェルに接続し、`ghe-cluster-maintenance -s` を実行して、スケジュールしたウィンドウに従ってメンテナンスモードを有効にします。 -2. **With the exception of the primary MySQL node**, connect to the administrative shell of each of the {% data variables.product.prodname_ghe_server %} nodes. [アップグレードの準備](#preparing-to-upgrade)のステップ 4 でダウンロードしたパッケージのファイル名を用いて、`ghe-upgrade` コマンドを実行してください。 +2. **プライマリMySQLノードを除き**、{% data variables.product.prodname_ghe_server %}の各ノードの管理シェルに接続します。 [アップグレードの準備](#preparing-to-upgrade)のステップ 4 でダウンロードしたパッケージのファイル名を用いて、`ghe-upgrade` コマンドを実行してください。 ```shell $ ghe-upgrade PACKAGE-FILENAME.pkg > *** verifying upgrade package signature... diff --git a/translations/ja-JP/content/admin/enterprise-management/upgrading-github-enterprise-server.md b/translations/ja-JP/content/admin/enterprise-management/upgrading-github-enterprise-server.md index b14071827695..5269dc0278c1 100644 --- a/translations/ja-JP/content/admin/enterprise-management/upgrading-github-enterprise-server.md +++ b/translations/ja-JP/content/admin/enterprise-management/upgrading-github-enterprise-server.md @@ -19,7 +19,7 @@ versions: ### アップグレードの準備 -1. アップグレードの戦略を決定し、アップグレード先のバージョンを選択してください。 詳しい情報については、「[アップグレードの要求事項](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)」を参照してください。 +1. アップグレードの戦略を決定し、アップグレード先のバージョンを選択してください。 詳細は「[アップグレードの要求事項](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)」を参照してください。 3. {% data variables.product.prodname_enterprise_backup_utilities %} で、プライマリインスタンスの新しいバックアップを作成してください。 詳しい情報については、[{% data variables.product.prodname_enterprise_backup_utilities %}README.md ファイル](https://github.com/github/backup-utils#readme)を参照してください。 4. アップグレードパッケージを使ってアップグレードをする場合は、{% data variables.product.prodname_ghe_server %} のエンドユーザのためにメンテナンス時間枠をスケジューリングしてください。 ホットパッチを利用している場合、メンテナンスモードは必要ありません。 @@ -57,7 +57,7 @@ versions: ### ホットパッチでのアップグレード -{% data reusables.enterprise_installation.hotpatching-explanation %}{% data variables.enterprise.management_console %} を使うと、ホットパッチを即座にインストールすることや、後にインストールするようにスケジュールすることができます。 管理シェルを使って `ghe-upgrade` ユーティリティでホットパッチをインストールすることもできます。 詳しい情報については、「[アップグレードの要求事項](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)」を参照してください。 +{% data reusables.enterprise_installation.hotpatching-explanation %}{% data variables.enterprise.management_console %} を使うと、ホットパッチを即座にインストールすることや、後にインストールするようにスケジュールすることができます。 管理シェルを使って `ghe-upgrade` ユーティリティでホットパッチをインストールすることもできます。 詳細は「[アップグレードの要求事項](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)」を参照してください。 {% note %} @@ -120,7 +120,7 @@ High Availability と Geo-replication が設定されたアプライアンスは ### アップグレードパッケージでのアップグレード -フィーチャシリーズ内の最新のパッチリリースへのアップグレードにはホットパッチが利用できますが、新しいフィーチャリリースへのアップグレードにはアップグレードパッケージを使わなければなりません。 たとえば `2.11.10` から `2.12.4` へのアップグレードの場合、これらは異なるフィーチャシリーズなので、アップグレードパッケージを使わなければなりません。 詳しい情報については、「[アップグレードの要求事項](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)」を参照してください。 +フィーチャシリーズ内の最新のパッチリリースへのアップグレードにはホットパッチが利用できますが、新しいフィーチャリリースへのアップグレードにはアップグレードパッケージを使わなければなりません。 たとえば `2.11.10` から `2.12.4` へのアップグレードの場合、これらは異なるフィーチャシリーズなので、アップグレードパッケージを使わなければなりません。 詳細は「[アップグレードの要求事項](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)」を参照してください。 #### アップグレードパッケージでの単一のアプライアンスのアップグレード diff --git a/translations/ja-JP/content/admin/enterprise-support/about-github-enterprise-support.md b/translations/ja-JP/content/admin/enterprise-support/about-github-enterprise-support.md index 70f1525fc328..7c804a9d7b1b 100644 --- a/translations/ja-JP/content/admin/enterprise-support/about-github-enterprise-support.md +++ b/translations/ja-JP/content/admin/enterprise-support/about-github-enterprise-support.md @@ -59,21 +59,21 @@ versions: {% data variables.contact.enterprise_support %} は、以下の米国の祝日を休日としています。 ただし、緊急サポートチケットにはグローバルサポートチームが対応しています。 -| アメリカ合衆国の祝日 祝日 | Date observed in {{ "now" | date: "%Y" }} | -| --- | --- | -| New Year's Day | January 1 | -| Martin Luther King, Jr. Day | Third Monday in January | -| Presidents' Day | Third Monday in February | -| Memorial Day | Last Monday in May | -| Independence Day | July 4 | -| Labor Day | First Monday in September | -| Veterans Day | November 12 | -| Thanksgiving Day | Fourth Thursday in November | -| Day after Thanksgiving | Fourth Friday in November | -| Christmas Eve | December 24 | -| Christmas Day | December 25 | -| Day after Christmas | December 26 | -| New Year's Eve | December 31 | +| アメリカ合衆国の祝日 祝日 | Date observed in {{ "now" | 日付: "%Y" }} | +| --------------------------- | --------------------------- | ----------- | +| New Year's Day | January 1 | | +| Martin Luther King, Jr. Day | Third Monday in January | | +| Presidents' Day | Third Monday in February | | +| Memorial Day | Last Monday in May | | +| Independence Day | July 4 | | +| Labor Day | First Monday in September | | +| Veterans Day | November 12 | | +| Thanksgiving Day | Fourth Thursday in November | | +| Day after Thanksgiving | Fourth Friday in November | | +| Christmas Eve | December 24 | | +| Christmas Day | December 25 | | +| Day after Christmas | December 26 | | +| New Year's Eve | December 31 | | #### 日本の祝日 diff --git a/translations/ja-JP/content/admin/enterprise-support/about-support-for-advanced-security.md b/translations/ja-JP/content/admin/enterprise-support/about-support-for-advanced-security.md index 92ee125344e5..fa9a6e542423 100644 --- a/translations/ja-JP/content/admin/enterprise-support/about-support-for-advanced-security.md +++ b/translations/ja-JP/content/admin/enterprise-support/about-support-for-advanced-security.md @@ -70,8 +70,8 @@ versions: {% data reusables.support.github-can-modify-ticket-priority %} -| 優先度 | 説明 | -|:------------------------------------------------------------------:| -------------------------------------------------------------------------------------------------------------------------------- | +| 優先度 | 説明 | +|:-------------------------------------------------------------:| --------------------------------------------------------------------------------------------------------------------------- | | {% data variables.product.support_ticket_priority_high %} | {% data variables.product.prodname_advanced_security %} は、機能しない、停止している、またはエンドユーザがソフトウェアの利用を合理的に継続できないほどの影響があり、回避策がないものです。 | | {% data variables.product.support_ticket_priority_normal %} | {% data variables.product.prodname_advanced_security %}の機能が不安定であり、エンドユーザの利用や生産性に支障があります。 | | {% data variables.product.support_ticket_priority_low %} | {% data variables.product.prodname_advanced_security %}は安定して動作していますが、ドキュメントの更新、見かけ上の欠陥、拡張といったソフトウェア上の軽微な変更をエンドユーザが求めています。 | diff --git a/translations/ja-JP/content/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server.md b/translations/ja-JP/content/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server.md index ae6e4a96b559..74f1bdabd5bc 100644 --- a/translations/ja-JP/content/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server.md +++ b/translations/ja-JP/content/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server.md @@ -7,7 +7,7 @@ versions: enterprise-server: '>=2.22' --- -{% data reusables.actions.enterprise-beta %} +{% data variables.product.prodname_actions %} の支払いを管理する {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 {% data reusables.actions.enterprise-no-internet-actions %} diff --git a/translations/ja-JP/content/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect.md b/translations/ja-JP/content/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect.md index fa7119e4403a..df9dd1d405f2 100644 --- a/translations/ja-JP/content/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect.md +++ b/translations/ja-JP/content/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect.md @@ -8,7 +8,7 @@ versions: enterprise-server: '>=2.22' --- -{% data reusables.actions.enterprise-beta %} +{% data variables.product.prodname_actions %} の支払いを管理する {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 By default, {% data variables.product.prodname_actions %} workflows on {% data variables.product.prodname_ghe_server %} cannot use actions directly from {% data variables.product.prodname_dotcom_the_website %} or [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=actions). diff --git a/translations/ja-JP/content/admin/github-actions/enabling-github-actions-and-configuring-storage.md b/translations/ja-JP/content/admin/github-actions/enabling-github-actions-and-configuring-storage.md index 02cebd8a1745..02e76413083b 100644 --- a/translations/ja-JP/content/admin/github-actions/enabling-github-actions-and-configuring-storage.md +++ b/translations/ja-JP/content/admin/github-actions/enabling-github-actions-and-configuring-storage.md @@ -21,7 +21,7 @@ versions: To enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %}, you must have access to external blob storage. -{% data variables.product.prodname_actions %} uses blob storage to store artifacts generated by workflow runs, such as workflow logs and user-uploaded build artifacts. The amount of storage required depends on your usage of {% data variables.product.prodname_actions %}. +{% data variables.product.prodname_actions %} uses blob storage to store artifacts generated by workflow runs, such as workflow logs and user-uploaded build artifacts. 必要なストレージ容量は、{% data variables.product.prodname_actions %} の使用状況によって異なります。 {% data variables.product.prodname_actions %} supports these storage providers: diff --git a/translations/ja-JP/content/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise.md b/translations/ja-JP/content/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise.md index 65c6b4839efe..6668def0a584 100644 --- a/translations/ja-JP/content/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise.md +++ b/translations/ja-JP/content/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise.md @@ -7,7 +7,7 @@ versions: enterprise-server: '>=2.22' --- -{% data reusables.actions.enterprise-beta %} +{% data variables.product.prodname_actions %} の支払いを管理する {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 ### About {% data variables.product.prodname_actions %} permissions for your enterprise diff --git a/translations/ja-JP/content/admin/github-actions/index.md b/translations/ja-JP/content/admin/github-actions/index.md index f91f95afb4f5..254751127a76 100644 --- a/translations/ja-JP/content/admin/github-actions/index.md +++ b/translations/ja-JP/content/admin/github-actions/index.md @@ -7,7 +7,7 @@ versions: enterprise-server: '>=2.22' --- -{% data reusables.actions.enterprise-beta %} +{% data variables.product.prodname_actions %} の支払いを管理する {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 ### 目次 diff --git a/translations/ja-JP/content/admin/github-actions/managing-access-to-actions-from-githubcom.md b/translations/ja-JP/content/admin/github-actions/managing-access-to-actions-from-githubcom.md index 53e468945491..51d601c89f2e 100644 --- a/translations/ja-JP/content/admin/github-actions/managing-access-to-actions-from-githubcom.md +++ b/translations/ja-JP/content/admin/github-actions/managing-access-to-actions-from-githubcom.md @@ -4,8 +4,6 @@ intro: 'Controlling which actions on {% data variables.product.prodname_dotcom_t mapTopic: true redirect_from: - /enterprise/admin/github-actions/managing-access-to-actions-from-githubcom - - /enterprise/admin/github-actions/managing-access-to-actions-from-githubcom - - /enterprise/admin/github-actions/managing-access-to-actions-from-githubcom versions: enterprise-server: '>=2.22' --- diff --git a/translations/ja-JP/content/admin/github-actions/manually-syncing-actions-from-githubcom.md b/translations/ja-JP/content/admin/github-actions/manually-syncing-actions-from-githubcom.md index 8397b929f012..93c2a6b11d96 100644 --- a/translations/ja-JP/content/admin/github-actions/manually-syncing-actions-from-githubcom.md +++ b/translations/ja-JP/content/admin/github-actions/manually-syncing-actions-from-githubcom.md @@ -7,7 +7,7 @@ versions: enterprise-server: '>=2.22' --- -{% data reusables.actions.enterprise-beta %} +{% data variables.product.prodname_actions %} の支払いを管理する {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 {% data reusables.actions.enterprise-no-internet-actions %} diff --git a/translations/ja-JP/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md b/translations/ja-JP/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md index 76ec65678fd3..60e44c854d30 100644 --- a/translations/ja-JP/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md +++ b/translations/ja-JP/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md @@ -7,7 +7,7 @@ versions: enterprise-server: '>=2.22' --- -{% data reusables.actions.enterprise-beta %} +{% data variables.product.prodname_actions %} の支払いを管理する {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 ### About the included setup actions and the runner tool cache @@ -69,7 +69,7 @@ You can populate the runner tool cache by running a {% data variables.product.pr path: ${{runner.tool_cache}}/tool_cache.tar.gz ``` {% endraw %} -1. Download the tool cache artifact from the workflow run. For instructions on downloading artifacts, see "[Persisting workflow data using artifacts](/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts#downloading-and-deleting-artifacts-after-a-workflow-run-is-complete)." +1. Download the tool cache artifact from the workflow run. Download the tool cache artifact from the workflow run. 1. Transfer the tool cache artifact to your self hosted runner and extract it to the local tool cache directory. The default tool cache directory is `RUNNER_DIR/_work/_tool`. If the runner hasn't processed any jobs yet, you might need to create the `_work/_tool` directories. After extracting the tool cache artifact uploaded in the above example, you should have a directory structure on your self-hosted runner that is similar to the following example: diff --git a/translations/ja-JP/content/admin/index.md b/translations/ja-JP/content/admin/index.md index ce91446498f4..f2f44bf2326d 100644 --- a/translations/ja-JP/content/admin/index.md +++ b/translations/ja-JP/content/admin/index.md @@ -3,7 +3,7 @@ title: Enterprise Administrators redirect_from: - /enterprise/admin/hidden/migrating-from-github-fi/ - /enterprise/admin -intro: GitHub Enterprise インスタンスを配備、設定、および管理している組織の管理者、システム管理者、およびセキュリティスペシャリストのためのステップバイステップガイドです。 +intro: 'GitHub Enterprise インスタンスを配備、設定、および管理している組織の管理者、システム管理者、およびセキュリティスペシャリストのためのステップバイステップガイドです。' versions: enterprise-server: '*' --- diff --git a/translations/ja-JP/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md b/translations/ja-JP/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md index cef39f661d00..6a75ab2ba92b 100644 --- a/translations/ja-JP/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md +++ b/translations/ja-JP/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md @@ -24,7 +24,8 @@ Google Cloud Platformde{% data variables.product.product_location_enterprise %} #### サポートされているマシンタイプ -{% data variables.product.prodname_ghe_server %} は、次の Google Compute Engine (GCE) マシンタイプでサポートされています。 詳しい情報については[Google Cloud Platformのマシンタイプの記事](https://cloud.google.com/compute/docs/machine-types)を参照してください。 | +{% data variables.product.prodname_ghe_server %} は、次の Google Compute Engine (GCE) マシンタイプでサポートされています。 詳しい情報については[Google Cloud Platformのマシンタイプの記事](https://cloud.google.com/compute/docs/machine-types)を参照してください。 +| {% if currentVersion != "free-pro-team@latest" %} | | ハイメモリ | | | ------------- | diff --git a/translations/ja-JP/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md b/translations/ja-JP/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md index 99e4895e88c2..c56f1a4ae6de 100644 --- a/translations/ja-JP/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md +++ b/translations/ja-JP/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md @@ -29,7 +29,9 @@ versions: {% data reusables.enterprise_installation.create-ghe-instance %} -1. OpenStack Horizon で、ダウンロードした {% data variables.product.prodname_ghe_server %} のイメージをアップロードします。 手順については、OpenStack ガイドの「[Upload and manage images](https://docs.openstack.org/horizon/latest/user/manage-images.html)」の 「Upload an image」セクションを参照してください。 +1. In OpenStack Horizon, upload the + +{% data variables.product.prodname_ghe_server %} image you downloaded. 手順については、OpenStack ガイドの「[Upload and manage images](https://docs.openstack.org/horizon/latest/user/manage-images.html)」の 「Upload an image」セクションを参照してください。 {% data reusables.enterprise_installation.create-attached-storage-volume %} 手順については、OpenStack ガイドの「[Create and manage volumes](https://docs.openstack.org/horizon/latest/user/manage-volumes.html)」を参照してください。 3. セキュリティグループを作成し、下の表の各ポートについて新しいセキュリティグループルールを追加してください。 その方法についてはOpenStackのガイド"[Configure access and security for instances](https://docs.openstack.org/horizon/latest/user/configure-access-and-security-for-instances.html)"を参照してください。 diff --git a/translations/ja-JP/content/admin/overview/about-the-github-enterprise-server-api.md b/translations/ja-JP/content/admin/overview/about-the-github-enterprise-server-api.md index 5e085bac9fc3..7bdc13818b96 100644 --- a/translations/ja-JP/content/admin/overview/about-the-github-enterprise-server-api.md +++ b/translations/ja-JP/content/admin/overview/about-the-github-enterprise-server-api.md @@ -15,5 +15,5 @@ versions: - {% data variables.enterprise.management_console %} に変更を加える。 詳しい情報については、「[{% data variables.enterprise.management_console %}](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#management-console)」を参照してください。 - 自分のインスタンスに関する統計を収集する。 詳しい情報については、「[管理統計](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#admin-stats)」を参照してください。 -- LDAP 同期を設定する。 詳しい情報については、「[LDAP](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#ldap)」を参照してください。{% if currentVersion ver_gt "enterprise-server@2.18" %} -- Enterpriseアカウントの管理。 詳しい情報については「[Enterprise アカウント](/v4/guides/managing-enterprise-accounts)」を参照してください。{% endif %} +- LDAP 同期を設定する。 詳しい情報については、「[LDAP](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#ldap)」を参照してください。 +- Enterpriseアカウントの管理。 詳しい情報については「[Enterprise アカウント](/v4/guides/managing-enterprise-accounts)」を参照してください。 diff --git a/translations/ja-JP/content/admin/overview/managing-your-github-enterprise-license.md b/translations/ja-JP/content/admin/overview/managing-your-github-enterprise-license.md index 6fbdfc1b6880..e5307b4c6106 100644 --- a/translations/ja-JP/content/admin/overview/managing-your-github-enterprise-license.md +++ b/translations/ja-JP/content/admin/overview/managing-your-github-enterprise-license.md @@ -34,7 +34,8 @@ versions: {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.enterprise-licensing-tab %} 4. [Enterprise Server Instances] で、{% octicon "download" aria-label="The download icon" %} をクリックしてライセンスファイルをダウンロードします。 ![GitHub Enterprise Server ライセンスをダウンロードする](/assets/images/help/business-accounts/download-ghes-license.png) -5. {% data variables.product.prodname_ghe_server %} インスタンスにサイト管理者としてログインします。 +5. Log into your +{% data variables.product.prodname_ghe_server %} instance as a site administrator. {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.settings-tab %} @@ -63,7 +64,8 @@ versions: {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.license-tab %} 5. [Quick links] で、{% data variables.product.prodname_ghe_server %}上の現在のライセンスを含むファイルをダウンロードするには、[**Export license usage**] をクリックします。 ![ライセンス使用状況リンクをエクスポートする](/assets/images/enterprise/business-accounts/export-license-usage-link.png) -6. {% data variables.product.prodname_ghe_cloud %}に移動します。 +6. Navigate to +{% data variables.product.prodname_ghe_cloud %}. {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.enterprise-licensing-tab %} diff --git a/translations/ja-JP/content/admin/packages/enabling-github-packages-for-your-enterprise.md b/translations/ja-JP/content/admin/packages/enabling-github-packages-for-your-enterprise.md index b359d1ad4943..55bc189526f8 100644 --- a/translations/ja-JP/content/admin/packages/enabling-github-packages-for-your-enterprise.md +++ b/translations/ja-JP/content/admin/packages/enabling-github-packages-for-your-enterprise.md @@ -1,20 +1,17 @@ --- -title: Enabling GitHub Packages for your enterprise -intro: 'You can start using {% data variables.product.prodname_registry %} on your instance by enabling the feature, configuring third-party storage, configuring the ecosystems you want to support, and updating your TLS certificate.' +title: Enterprise 向けの GitHub パッケージを有効化する +intro: '機能の有効化、サードパーティストレージの設定、サポートするエコシステムの設定、TLS 証明書の更新を行い、インスタンスで {% data variables.product.prodname_registry %} を使用開始します。' redirect_from: - /enterprise/admin/packages/enabling-github-packages-for-your-enterprise - - /enterprise/admin/packages/enabling-github-packages-for-your-enterprise - - /enterprise/admin/packages/enabling-github-packages-for-your-enterprise - - /enterprise/admin/packages/enabling-github-packages-for-your-enterprise versions: enterprise-server: '>=2.22' --- {% data reusables.package_registry.packages-ghes-release-stage %} -1. After you've been invited to join the beta, to enable {% data variables.product.prodname_registry %} for your instance, follow the instructions from your account representative. -1. Configure third-party storage for your enterprise's packages. For more information, see "[Configuring third-party storage for packages](/enterprise/admin/packages/configuring-third-party-storage-for-packages)." -1. Enable or disable each package ecosystem for your enterprise. For more information, see "[Configuring packages support for your enterprise](/enterprise/admin/packages/configuring-packages-support-for-your-enterprise)." -1. If subdomain isolation is enabled for your instance, which is required to use {% data variables.product.prodname_registry %} with Docker, create and upload a TLS certificate that allows the package host URL for each ecosystem you want to use, such as `npm.HOSTNAME`. Make sure each package host URL includes `https://`. +1. ベータに招待されたら、顧客担当の指示に従ってインスタンスで {% data variables.product.prodname_registry %} を有効化します。 +1. Enterprise のパッケージ向けにサードパーティストレージを設定します。 詳しい情報については、「[パッケージのサードパーティストレージを設定する](/enterprise/admin/packages/configuring-third-party-storage-for-packages)」を参照してください。 +1. Enterprise の各パッケージエコシステムを有効化または無効化します。 詳しい情報については、「[Enterprise 向けのパッケージサポートを設定する](/enterprise/admin/packages/configuring-packages-support-for-your-enterprise)」を参照してください。 +1. Docker で {% data variables.product.prodname_registry %} を使用するために必要なインスタンスで Subdomain Isolation が有効になっている場合は、使用する各エコシステムのパッケージホスト URL（`npm.HOSTNAME` など）を許可する TLS 証明書を作成してアップロードします。 各パッケージのホスト URL に `https://` が含まれていることを確認します。 - You can create the certificate manually or using Let's Encrypt. If you already use Let's Encrypt, you must request a new TLS certificate after enabling {% data variables.product.prodname_registry %}. For more information about package host URLs, see "[Enabling subdomain isolation](/enterprise/admin/configuration/enabling-subdomain-isolation)." For more information about uploading TLS certificates to {% data variables.product.product_name %}, see "[Configuring TLS](/enterprise/admin/configuration/configuring-tls)." + 証明書は手動で作成することも、Let's Encrypt を使用して作成することもできます。 すでに Let's Encrypt を使用している場合は、{% data variables.product.prodname_registry %} を有効にしてから新しい TLS 証明書をリクエストする必要があります。 パッケージホスト URL の詳しい情報については、「[Subdomain Isolation を有効化する](/enterprise/admin/configuration/enabling-subdomain-isolation)」を参照してください。 {% data variables.product.product_name %} への TLS 証明書のアップロード方法について詳しくは、「[TLS を設定する](/enterprise/admin/configuration/configuring-tls)」を参照してください。 diff --git a/translations/ja-JP/content/admin/policies/creating-a-pre-receive-hook-environment.md b/translations/ja-JP/content/admin/policies/creating-a-pre-receive-hook-environment.md index 94757a394848..72875a911c4e 100644 --- a/translations/ja-JP/content/admin/policies/creating-a-pre-receive-hook-environment.md +++ b/translations/ja-JP/content/admin/policies/creating-a-pre-receive-hook-environment.md @@ -1,6 +1,6 @@ --- title: pre-receiveフック環境の作成 -intro: pre-receiveフックを実行するには、デフォルトのpre-receive環境を使うか、カスタムの環境を作成します。 +intro: 'pre-receiveフックを実行するには、デフォルトのpre-receive環境を使うか、カスタムの環境を作成します。' redirect_from: - /enterprise/admin/developer-workflow/creating-a-pre-receive-hook-environment - /enterprise/admin/policies/creating-a-pre-receive-hook-environment diff --git a/translations/ja-JP/content/admin/policies/creating-a-pre-receive-hook-script.md b/translations/ja-JP/content/admin/policies/creating-a-pre-receive-hook-script.md index f3c54ffcaebd..3d3c4f4f8024 100644 --- a/translations/ja-JP/content/admin/policies/creating-a-pre-receive-hook-script.md +++ b/translations/ja-JP/content/admin/policies/creating-a-pre-receive-hook-script.md @@ -54,11 +54,11 @@ pre-receiveスクリプトの`終了ステータス`は、プッシュが受け | $GITHUB_REPO_PUBLIC | 論理値で、`true` ならパブリックリポジトリを、`false` ならプライベートリポジトリを示す。 | | $GITHUB_PUBLIC_KEY_FINGERPRINT | ユーザの公開鍵のフィンガープリント。 | | $GITHUB_PULL_REQUEST_HEAD | PR の HEAD に対する `user:branch` という形式の文字列。
    例: `octocat:fix-bug` | -| $GITHUB_PULL_REQUEST_BASE | A string in the format: `user:branch` for the BASE of the PR.
    Example: `octocat:main` | +| $GITHUB_PULL_REQUEST_BASE | PR の BASE に対する `user:branch` という形式の文字列。
    例: `octocat:main` | | $GITHUB_VIA | ref の作成に使われた方式。
    **取り得る値: **
    - `auto-merge deployment api`
    - `blob edit`
    - `branch merge api`
    - `branches page delete button`
    - `git refs create api`
    - `git refs delete api`
    - `git refs update api`
    - `merge api`
    - `pull request branch delete button`
    - `pull request branch undo button`
    - `pull request merge api`
    - `pull request merge button`
    - `pull request revert button`
    - `releases delete button`
    - `stafftools branch restore`
    - `slumlord (#{sha})` | | $GIT_PUSH_OPTION_COUNT | クライアントによって送信されたプッシュオプション数。 プッシュオプションに関する詳しい情報については、Gitのドキュメンテーションの[git-push](https://git-scm.com/docs/git-push#git-push---push-optionltoptiongt)を参照してください。 | | $GIT_PUSH_OPTION_N | ここで N は 0 から始まる整数で、この変数にはクライアントから送信されたプッシュオプションの文字列が含まれます。 送信された最初のオプションはGIT_PUSH_OPTION_0に保存され、2番目のオプションはGIT_PUSH_OPTION_1に保存され、といったようになります。 プッシュオプションに関する詳しい情報については、Gitのドキュメンテーションの[git-push](https://git-scm.com/docs/git-push#git-push---push-optionltoptiongt)を参照してください。 |{% if currentVersion ver_gt "enterprise-server@2.21" %} -| $GIT_USER_AGENT | The user-agent string sent by the client that pushed the changes. |{% endif %} +| $GIT_USER_AGENT | 変更をプッシュしたクライアントから送信されたユーザエージェント文字列型。 |{% endif %} ### 権限の設定と {% data variables.product.prodname_ghe_server %} への pre-receive フックのプッシュ @@ -182,7 +182,7 @@ pre-receive フックスクリプトは、{% data variables.product.prodname_ghe $ git clone git@github.com:octocat/Hello-World.git $ cd Hello-World $ git remote add test git@127.0.0.1:test.git - $ GIT_SSH_COMMAND="ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no -p 52311 -i ../id_rsa" git push -u test master + $ GIT_SSH_COMMAND="ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no -p 52311 -i ../id_rsa" git push -u test main > Warning: Permanently added '[192.168.99.100]:52311' (ECDSA) to the list of known hosts. > Counting objects: 7, done. > Delta compression using up to 4 threads. @@ -191,7 +191,7 @@ pre-receive フックスクリプトは、{% data variables.product.prodname_ghe > Total 7 (delta 0), reused 7 (delta 0) > remote: error: rejecting all pushes > To git@192.168.99.100:test.git - > ! [remote rejected] master -> master (pre-receive hook declined) + > ! [remote rejected] main -> main (pre-receive hook declined) > error: failed to push some refs to 'git@192.168.99.100:test.git' ``` diff --git a/translations/ja-JP/content/admin/policies/enforcing-policies-for-your-enterprise.md b/translations/ja-JP/content/admin/policies/enforcing-policies-for-your-enterprise.md index 20c2315bcaac..5629ee8710d5 100644 --- a/translations/ja-JP/content/admin/policies/enforcing-policies-for-your-enterprise.md +++ b/translations/ja-JP/content/admin/policies/enforcing-policies-for-your-enterprise.md @@ -1,10 +1,8 @@ --- -title: Enforcing policies for your enterprise +title: Enterprise にポリシーを適用する mapTopic: true redirect_from: - /enterprise/admin/policies/enforcing-policies-for-your-enterprise - - /enterprise/admin/policies/enforcing-policies-for-your-enterprise - - /enterprise/admin/policies/enforcing-policies-for-your-enterprise versions: enterprise-server: '*' --- diff --git a/translations/ja-JP/content/admin/policies/enforcing-policy-with-pre-receive-hooks.md b/translations/ja-JP/content/admin/policies/enforcing-policy-with-pre-receive-hooks.md index 13c44db66e3b..ddb44b6cafa7 100644 --- a/translations/ja-JP/content/admin/policies/enforcing-policy-with-pre-receive-hooks.md +++ b/translations/ja-JP/content/admin/policies/enforcing-policy-with-pre-receive-hooks.md @@ -1,5 +1,5 @@ --- -title: Enforcing policy with pre-receive hooks +title: Pre-receive フックを使ってポリシーを適用する intro: pre-receiveフックを使ってOrganization内のワークフローの標準を強制します。 pre-receiveフックは、プッシュがリポジトリに受け付けられる前に、事前に定義された一連の品質チェックをコードがパスすることを求めます。 mapTopic: true redirect_from: diff --git a/translations/ja-JP/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md b/translations/ja-JP/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md index b4cb64b269f9..86f0af7ef5a2 100644 --- a/translations/ja-JP/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md +++ b/translations/ja-JP/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md @@ -1,6 +1,6 @@ --- -title: Enforcing repository management policies in your enterprise -intro: 'Enterprise owners can enforce certain repository management policies for all organizations owned by an enterprise account, or allow policies to be set in each organization.' +title: Enterprise でリポジトリ管理ポリシーを適用する +intro: 'Enterprise のオーナーは、自分の Enterprise のアカウントが所有するすべての Organization に対して特定のリポジトリの管理ポリシーを強制したり、Organization ごとのポリシーの設定を許可したりすることができます。' redirect_from: - /enterprise/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance - /enterprise/admin/guides/user-management/preventing-users-from-changing-a-repository-s-visibility @@ -29,15 +29,15 @@ versions: enterprise-server: '*' --- -### Configuring the default visibility of new repositories on your appliance +### アプライアンスにおける新しいリポジトリのデフォルトの可視性の設定 -Each time someone creates a new repository on {% data variables.product.product_location_enterprise %}, that person must choose a visibility for the repository. When you configure a default visibility setting for the instance, you choose which visibility is selected by default. For more information on repository visibility, see "[About repository visibility](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)." +{% data variables.product.product_location_enterprise %}上に新しいリポジトリを作るときには、そのリポジトリの可視性を選択しなければなりません。 そのインタンスのデフォルトの可視性の設定をする際には、デフォルトで選択される可視性を選択します。 リポジトリの可視性に関する詳しい情報については、「[リポジトリの可視性について](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)」を参照してください。 -If a site administrator disallows members from creating certain types of repositories, members will not be able to create that type of repository even if the visibility setting defaults to that type. For more information, see "[Restricting repository creation in your instance](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)." +サイト管理者がメンバーに対して特定の種類のリポジトリの作成を禁止している場合、可視性の設定のデフォルトがその種類になっていても、メンバーはその種類のリポジトリを作成できません。 詳細は「[インスタンスでリポジトリ作成を制限する](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)」を参照してください。 {% tip %} -**Tip:** You can restrict the ability to change repository visibility to site administrators only. For more information, see "[Preventing users from changing a repository's visibility](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-a-repository-s-visibility)." +**Tip:** リポジトリの可視性を変更できる能力をサイト管理者のみに制限できます。 詳しい情報については"[ユーザによるリポジトリの可視性の変更の禁止](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-a-repository-s-visibility)."を参照してください。 {% endtip %} @@ -49,26 +49,25 @@ If a site administrator disallows members from creating certain types of reposit {% data reusables.enterprise-accounts.settings-tab %} {% endif %} {% data reusables.enterprise-accounts.options-tab %} -1. Under "Default repository visibility", use the drop-down menu and select a default visibility. - ![Drop-down menu to choose the default repository visibility for your instance](/assets/images/enterprise/site-admin-settings/default-repository-visibility-settings.png) +1. "Default repository visibility（デフォルトのリポジトリの可視性）"の下で、ドロップダウンメニューを使ってデフォルトの可視性を選択してください。![インスタンスにおけるデフォルトのリポジトリの可視化性を選択するためのドロップダウンメニュー](/assets/images/enterprise/site-admin-settings/default-repository-visibility-settings.png) {% data reusables.enterprise_installation.image-urls-viewable-warning %} -### Setting a policy for changing a repository's visibility +### リポジトリの可視性を変更するためのポリシーを設定する -When you prevent members from changing repository visibility, only site administrators have the ability to make public repositories private or make private repositories public. +メンバーがリポジトリの可視性を変更できないようにすると、パブリックなリポジトリをプライベートにしたり、プライベートなリポジトリをパブリックにしたりできるのはサイト管理者だけになります。 -If a site administrator has restricted repository creation to organization owners only, then members will not be able to change repository visibility. If a site administrator has restricted member repository creation to private repositories only, then members will only be able to change repositories from public to private. For more information, see "[Setting a policy for repository creation](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)." +サイト管理者がリポジトリの作成を Organization のオーナーのみに制限している場合、メンバーはリポジトリの可視性を変更できません。 サイト管理者がメンバーのリポジトリ作成をプライベート リポジトリのみに制限している場合、メンバーはリポジトリをパブリックからプライベートに変更すること以外はできません。 詳しい情報については、「[リポジトリ作成のためのポリシーを設定する](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)」を参照してください。 {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.repositories-tab %} -5. Under "Repository visibility change", review the information about changing the setting. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} +5. [Repository visibility change] で、設定変更についての情報を確認します。 {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} {% data reusables.enterprise-accounts.repository-visibility-policy %} -### Setting a policy for repository creation +### リポジトリ作成のためのポリシーを設定する {% data reusables.organizations.repo-creation-constants %} @@ -76,35 +75,34 @@ If a site administrator has restricted repository creation to organization owner {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.repositories-tab %} -5. Under "Repository creation", review the information about changing the setting. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} +5. [Repository creation] で、設定変更に関する情報を読みます。 {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} {% if currentVersion ver_gt "enterprise-server@2.19" %} {% data reusables.enterprise-accounts.repo-creation-policy %} {% data reusables.enterprise-accounts.repo-creation-types %} {% else %} -6. Under "Repository creation", use the drop-down menu and choose a policy. - ![Drop-down menu with repository creation policies](/assets/images/enterprise/site-admin-settings/repository-creation-drop-down.png) +6. [Repository creation（リポジトリの作成）] で、ドロップダウンメニューを使用してポリシーを選択します。 ![リポジトリ作成ポリシーのドロップダウンメニュー](/assets/images/enterprise/site-admin-settings/repository-creation-drop-down.png) {% endif %} -### Setting a policy for repository deletion and transfer +### リポジトリの削除と移譲のためのポリシーを設定する {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.repositories-tab %} -5. Under "Repository deletion and transfer", review the information about changing the setting. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} +5. 「Repository deletion and transfer」で、設定変更に関する情報を確認します。 {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} {% data reusables.enterprise-accounts.repository-deletion-policy %} -### Setting a policy for Git push limits +### Git プッシュ制限のためのポリシーを設定する -To keep your repository size manageable and prevent performance issues, you can configure a file size limit for repositories on your instance. +リポジトリのサイズを管理できるように留め、パフォーマンスの問題を避けるために、インスタンス上のリポジトリのファイルサイズに制限を設定できます。 -By default, when you enforce repository upload limits, people cannot add or update files larger than 100 MB. +デフォルトでは、リポジトリのアップロード制限を適用すると、100MB以上のファイルの追加やアップロードができなくなります。 {% if currentVersion ver_lt "enterprise-server@2.20" %} {% tip %} -**Note:** Only files larger than {% data variables.large_files.warning_size %} will be checked against the Git push limit. If you need to set a lower push limit, contact {% data variables.contact.contact_ent_support %} for assistance. +**注：**{% data variables.large_files.warning_size %}以上のサイズのファイルのみが、Gitプッシュの制限に照らし合わせて確認されます。 プッシュ制限をより小さくする必要がある場合は、{% data variables.contact.contact_ent_support %}までお問い合わせください。 {% endtip %} {% endif %} @@ -117,14 +115,12 @@ By default, when you enforce repository upload limits, people cannot add or upda {% data reusables.enterprise-accounts.settings-tab %} {% endif %} {% data reusables.enterprise-accounts.options-tab %} -4. Under "Repository upload limit", use the drop-down menu and click a maximum object size. -![Drop-down menu with maximum object size options](/assets/images/enterprise/site-admin-settings/repo-upload-limit-dropdown.png) -5. Optionally, to enforce a maximum upload limit for all repositories on {% data variables.product.product_location_enterprise %}, select **Enforce on all repositories** -![Enforce maximum object size on all repositories option](/assets/images/enterprise/site-admin-settings/all-repo-upload-limit-option.png) +4. [Repository upload limit] で、ドロップダウンメニューを使用して最大オブジェクトサイズをクリックします。 ![最大オブジェクトサイズのオプションを備えたドロップダウンメニュー](/assets/images/enterprise/site-admin-settings/repo-upload-limit-dropdown.png) +5. あるいは、{% data variables.product.product_location_enterprise %}上のすべてのリポジトリにアップロードの最大制限を適用するために、**Enforce on all repositories（すべてのリポジトリに適用）**を選択してください。 ![すべてのリポジトリにオブジェクトの最大サイズを適用するオプション](/assets/images/enterprise/site-admin-settings/all-repo-upload-limit-option.png) -### Configuring the merge conflict editor for pull requests between repositories +### リポジトリ間のプルリクエストのためのマージコンフリクトエディタを設定する -Requiring users to resolve merge conflicts locally on their computer can prevent people from inadvertently writing to an upstream repository from a fork. +ユーザが自分のコンピュータ上でローカルにマージコンフリクトを解決するように要求すれば、うっかりフォークから上流のリポジトリに書き込んでしまうことを回避できます。 {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} @@ -134,14 +130,13 @@ Requiring users to resolve merge conflicts locally on their computer can prevent {% data reusables.enterprise-accounts.settings-tab %} {% endif %} {% data reusables.enterprise-accounts.options-tab %} -1. Under "Conflict editor for pull requests between repositories", use the drop-down menu, and click **Disabled**. - ![Drop-down menu with option to disable the merge conflict editor](/assets/images/enterprise/settings/conflict-editor-settings.png) +1. "Conflict editor for pull requests between repositories（リポジトリ間のプルリクエストのコンフリクトエディタ）"の下でドロップダウンメニューを使い、**Disabled（無効化）**を選択してください。 ![マージコンフリクトエディタを無効化するオプションを持つドロップダウンメニュー](/assets/images/enterprise/settings/conflict-editor-settings.png) -### Configuring force pushes +### フォースプッシュを設定する -Each repository inherits a default force push setting from the settings of the user account or organization to which it belongs. Likewise, each organization and user account inherits a default force push setting from the force push setting for the entire appliance. If you change the force push setting for the appliance, it will change for all repositories owned by any user or organization. +それぞれのリポジトリは、所属するユーザアカウントもしくはOraganizationの設定から、デフォルトのフォースプッシュの設定を引き継ぎます。 同様に、それぞれのOrganization及びユーザアカウントは、デフォルトのフォースプッシュの設定をアプライアンス全体のフォースプッシュの設定から引き継ぎます。 アプライアンスのフォースプッシュの設定を変更すれば、すべてのユーザあるいはOrganizationが所有するすべてのリポジトリが変更されます。 -#### Blocking all force pushes on your appliance +#### アプライアンス上でのすべてのフォースプッシュをブロックする {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} @@ -151,11 +146,10 @@ Each repository inherits a default force push setting from the settings of the u {% data reusables.enterprise-accounts.settings-tab %} {% endif %} {% data reusables.enterprise-accounts.options-tab %} -4. Under "Force pushes", use the drop-down menu, and click **Allow**, **Block** or **Block to the default branch**. -![Force pushes dropdown](/assets/images/enterprise/site-admin-settings/force-pushes-dropdown.png) -5. Optionally, select **Enforce on all repositories**, which will override organization and repository level settings for force pushes. +4. [Force pushes] の下のドロップダウンメニューから、[**Allow**]、[**Block**]、[**Block to the default branch**] のいずれかをクリックしてください。 ![フォースプッシュのドロップダウン](/assets/images/enterprise/site-admin-settings/force-pushes-dropdown.png) +5. [**Enforce on all repositories（すべてのリポジトリに強制）**] を選択して、フォースプッシュに関する Organization およびリポジトリレベルの設定をオーバーライドすることもできます。 -#### Blocking force pushes to a specific repository +#### 特定のリポジトリへのフォースプッシュをブロックする {% data reusables.enterprise_site_admin_settings.override-policy %} @@ -165,14 +159,13 @@ Each repository inherits a default force push setting from the settings of the u {% data reusables.enterprise_site_admin_settings.click-repo %} {% data reusables.enterprise_site_admin_settings.admin-top-tab %} {% data reusables.enterprise_site_admin_settings.admin-tab %} -4. Select **Block** or **Block to the default branch** under **Push and Pull**. - ![Block force pushes](/assets/images/enterprise/site-admin-settings/repo/repo-block-force-pushes.png) +4. [**Push and Pull**] の下で [**Block**] または [**Block to the default branch**] を選択してください。 ![フォースプッシュのブロック](/assets/images/enterprise/site-admin-settings/repo/repo-block-force-pushes.png) -#### Blocking force pushes to repositories owned by a user account or organization +#### ユーザアカウントもしくはOrganizationが所有するリポジトリへのフォースプッシュのブロック -Repositories inherit force push settings from the user account or organization to which they belong. User accounts and organizations in turn inherit their force push settings from the force push settings for the entire appliance. +リポジトリは、所属するユーザアカウントもしくはOrganizationからフォースプッシュの設定を引き継ぎます。 そしてそれぞれのOrganization及びユーザアカウントは、フォースプッシュの設定をアプライアンス全体のフォースプッシュの設定から引き継ぎます。 -You can override the default inherited settings by configuring the settings for a user account or organization. +引き継がれたデフォルトの設定は、ユーザアカウントもしくはOrganizationの設定をすることで上書きできます。 {% data reusables.enterprise_site_admin_settings.sign-in %} {% data reusables.enterprise_site_admin_settings.access-settings %} @@ -180,28 +173,26 @@ You can override the default inherited settings by configuring the settings for {% data reusables.enterprise_site_admin_settings.click-user-or-org %} {% data reusables.enterprise_site_admin_settings.admin-top-tab %} {% data reusables.enterprise_site_admin_settings.admin-tab %} -5. Under "Repository default settings" in the "Force pushes" section, select - - **Block** to block force pushes to all branches. - - **Block to the default branch** to only block force pushes to the default branch. - ![Block force pushes](/assets/images/enterprise/site-admin-settings/user/user-block-force-pushes.png) -6. Optionally, select **Enforce on all repositories** to override repository-specific settings. Note that this will **not** override an appliance-wide policy. - ![Block force pushes](/assets/images/enterprise/site-admin-settings/user/user-block-all-force-pushes.png) +5. [Repository default settings（リポジトリのデフォルト設定）] の下の [Force pushes（フォースプッシュ）] セクションで、以下から選択してください。 + - [**Block（ブロック）**] ですべてのブランチへのフォースプッシュがブロックされます。 + - [**Block to the default branch（デフォルトブランチへのブロック）**] でデフォルトブランチへのフォースプッシュのみがブロックされます。 ![フォースプッシュのブロック](/assets/images/enterprise/site-admin-settings/user/user-block-force-pushes.png) +6. **Enforce on all repositories（すべてのリポジトリに対して強制）**を選択して、リポジトリ固有の設定を上書きすることもできます。 こうしてもアプライアンス全体のポリシーは上書き**されない**ことに注意してください。 ![フォースプッシュのブロック](/assets/images/enterprise/site-admin-settings/user/user-block-all-force-pushes.png) -### Configuring anonymous Git read access +### 匿名 Git 読み取りアクセスを設定する {% data reusables.enterprise_user_management.disclaimer-for-git-read-access %} -If you have [enabled private mode](/enterprise/admin/configuration/enabling-private-mode) on your instance, you can allow repository administrators to enable anonymous Git read access to public repositories. +インスタンスで[プライベートモードを有効化](/enterprise/admin/configuration/enabling-private-mode)した場合は、リポジトリ管理者がパブリックリポジトリへの匿名 Git 読み取りアクセスを有効化できるようにすることができます。 -Enabling anonymous Git read access allows users to bypass authentication for custom tools on your instance. When you or a repository administrator enable this access setting for a repository, unauthenticated Git operations (and anyone with network access to {% data variables.product.prodname_ghe_server %}) will have read access to the repository without authentication. +匿名 Git 読み取りアクセスを有効化すると、ユーザはインスタンス上のカスタムツールの認証をバイパスできるようになります。 あなたもしくはリポジトリ管理者がこのアクセス設定をリポジトリで有効化すると、認証を受けていない Git の操作 (そして {% data variables.product.prodname_ghe_server %} へのネットワークアクセスができる人はだれでも) は、認証なしでリポジトリに読み取りアクセスできることになります。 -If necessary, you can prevent repository administrators from changing anonymous Git access settings for repositories on {% data variables.product.product_location_enterprise %} by locking the repository's access settings. After you lock a repository's Git read access setting, only a site administrator can change the setting. +必要に応じて、リポジトリのアクセス設定をロックすることで、リポジトリ管理者が {% data variables.product.product_location_enterprise %} 上のリポジトリの匿名 Git アクセス設定を変更不可にすることができます。 リポジトリのGit読み取りアクセス設定をロックすると、サイト管理者だけがこの設定を変更できるようになります。 {% data reusables.enterprise_site_admin_settings.list-of-repos-with-anonymous-git-read-access-enabled %} {% data reusables.enterprise_user_management.exceptions-for-enabling-anonymous-git-read-access %} -#### Setting anonymous Git read access for all repositories +#### すべてのリポジトリに対する匿名 Git 読み取りアクセスを設定する {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} @@ -211,23 +202,17 @@ If necessary, you can prevent repository administrators from changing anonymous {% data reusables.enterprise-accounts.settings-tab %} {% endif %} {% data reusables.enterprise-accounts.options-tab %} -4. Under "Anonymous Git read access", use the drop-down menu, and click **Enabled**. -![Anonymous Git read access drop-down menu showing menu options "Enabled" and "Disabled"](/assets/images/enterprise/site-admin-settings/enable-anonymous-git-read-access.png) -3. Optionally, to prevent repository admins from changing anonymous Git read access settings in all repositories on your instance, select **Prevent repository admins from changing anonymous Git read access**. -![Select checkbox to prevent repository admins from changing anonymous Git read access settings for all repositories on your instance](/assets/images/enterprise/site-admin-settings/globally-lock-repos-from-changing-anonymous-git-read-access.png) +4. [Anonymous Git read access（匿名 Git 読み取りアクセス）] の下で、ドロップダウンメニューを使って [**Enabled（有効化）**] をクリックしてください。 ![[Enabled] と [Disabled] のメニューオプションが表示されている [Anonymous Git read access] ドロップダウンメニュー](/assets/images/enterprise/site-admin-settings/enable-anonymous-git-read-access.png) +3. インスタンスのすべてのリポジトリでリポジトリ管理者が匿名 Git 読み取りアクセス設定を変更するのを避けるために、[**Prevent repository admins from changing anonymous Git read access（リポジトリ管理者による匿名Git読み取りアクセスの変更の回避）**] を選択することもできます。 ![インスタンス上のすべてのリポジトリへの匿名Git読み取りアクセス設定をリポジトリ管理者が変更するのを避けるための選択チェックボックス](/assets/images/enterprise/site-admin-settings/globally-lock-repos-from-changing-anonymous-git-read-access.png) -#### Setting anonymous Git read access for a specific repository +#### 特定のリポジトリでの匿名 Git 読み取りアクセスを設定する {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.repository-search %} {% data reusables.enterprise_site_admin_settings.click-repo %} {% data reusables.enterprise_site_admin_settings.admin-top-tab %} {% data reusables.enterprise_site_admin_settings.admin-tab %} -6. Under "Danger Zone", next to "Enable Anonymous Git read access", click **Enable**. -!["Enabled" button under "Enable anonymous Git read access" in danger zone of a repository's site admin settings ](/assets/images/enterprise/site-admin-settings/site-admin-enable-anonymous-git-read-access.png) -7. Review the changes. To confirm, click **Yes, enable anonymous Git read access.** -![Confirm anonymous Git read access setting in pop-up window](/assets/images/enterprise/site-admin-settings/confirm-anonymous-git-read-access-for-specific-repo-as-site-admin.png) -8. Optionally, to prevent repository admins from changing this setting for this repository, select **Prevent repository admins from changing anonymous Git read access**. -![Select checkbox to prevent repository admins from changing anonymous Git read access for this repository](/assets/images/enterprise/site-admin-settings/lock_anonymous_git_access_for_specific_repo.png) - +6. "Danger Zone（危険区域）"の下で、"Enable Anonymous Git read access（匿名Git読み取りアクセスの有効化）"の隣の**Enable（有効化）**をクリックしてください。 ![リポジトリのサイト管理設定の危険地域内の "匿名 Git 読み取りアクセスの有効化" の下の "有効化" ボタン ](/assets/images/enterprise/site-admin-settings/site-admin-enable-anonymous-git-read-access.png) +7. 変更を確認します。 確定するには、[**Yes, enable anonymous Git read access**] をクリックします。 ![ポップアップウィンドウの [Confirm anonymous Git read access] 設定](/assets/images/enterprise/site-admin-settings/confirm-anonymous-git-read-access-for-specific-repo-as-site-admin.png) +8. このリポジトリの設定をリポジトリ管理者が変更するのを避けるために、[**Prevent repository admins from changing anonymous Git read access（リポジトリ管理者による匿名Git読み取りアクセスの変更の回避）**] を選択することもできます。 ![このリポジトリへの匿名Git読み取りアクセス設定をリポジトリ管理者が変更するのを避けるための選択チェックボックス](/assets/images/enterprise/site-admin-settings/lock_anonymous_git_access_for_specific_repo.png) diff --git a/translations/ja-JP/content/admin/policies/index.md b/translations/ja-JP/content/admin/policies/index.md index 55b0a5fc2b6d..29f60550696f 100644 --- a/translations/ja-JP/content/admin/policies/index.md +++ b/translations/ja-JP/content/admin/policies/index.md @@ -1,6 +1,6 @@ --- -title: Setting policies for your enterprise -intro: 'You can set policies in {% data variables.product.prodname_enterprise %} to reduce risk and increase quality.' +title: Enterprise のポリシーを設定する +intro: '{% data variables.product.prodname_enterprise %} でポリシーを設定することで、リスクを軽減し、品質を向上させることができます。' redirect_from: - /enterprise/admin/developer-workflow - /enterprise/admin/policies diff --git a/translations/ja-JP/content/admin/user-management/audit-logging.md b/translations/ja-JP/content/admin/user-management/audit-logging.md index d8b437a8bd81..832b84dc5b5f 100644 --- a/translations/ja-JP/content/admin/user-management/audit-logging.md +++ b/translations/ja-JP/content/admin/user-management/audit-logging.md @@ -34,5 +34,5 @@ Oct 26 01:42:08 github-ent github_audit: {:created_at=>1351215728326, :actor_ip= 次の例は、コミットがリポジトリにプッシュされたことを示しています。 ``` -Oct 26 02:19:31 github-ent github_audit: { "pid":22860, "ppid":22859, "program":"receive-pack", "git_dir":"/data/repositories/some-user/some-repository.git", "hostname":"github-ent", "pusher":"some-user", "real_ip":"10.0.0.51", "user_agent":"git/1.7.10.4", "repo_id":1, "repo_name":"some-user/some-repository", "transaction_id":"b031b7dc7043c87323a75f7a92092ef1456e5fbaef995c68", "frontend_ppid":1, "repo_public":true, "user_name":"some-user", "user_login":"some-user", "frontend_pid":18238, "frontend":"github-ent", "user_email":"some-user@github.example.com", "user_id":2, "pgroup":"github-ent_22860", "status":"post_receive_hook", "features":" report-status side-band-64k", "received_objects":3, "receive_pack_size":243, "non_fast_forward":false, "current_ref":"refs/heads/master" } +Oct 26 02:19:31 github-ent github_audit: { "pid":22860, "ppid":22859, "program":"receive-pack", "git_dir":"/data/repositories/some-user/some-repository.git", "hostname":"github-ent", "pusher":"some-user", "real_ip":"10.0.0.51", "user_agent":"git/1.7.10.4", "repo_id":1, "repo_name":"some-user/some-repository", "transaction_id":"b031b7dc7043c87323a75f7a92092ef1456e5fbaef995c68", "frontend_ppid":1, "repo_public":true, "user_name":"some-user", "user_login":"some-user", "frontend_pid":18238, "frontend":"github-ent", "user_email":"some-user@github.example.com", "user_id":2, "pgroup":"github-ent_22860", "status":"post_receive_hook", "features":" report-status side-band-64k", "received_objects":3, "receive_pack_size":243, "non_fast_forward":false, "current_ref":"refs/heads/main" } ``` diff --git a/translations/ja-JP/content/admin/user-management/audited-actions.md b/translations/ja-JP/content/admin/user-management/audited-actions.md index 1d642c09701a..6bf9059c722d 100644 --- a/translations/ja-JP/content/admin/user-management/audited-actions.md +++ b/translations/ja-JP/content/admin/user-management/audited-actions.md @@ -35,28 +35,28 @@ versions: #### インスタンス設定 -| 名前 | 説明 | -| -------------------------------------------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `business.update_member_repository_creation_permission` | サイトアドミンは、インスタンス上の Organization でリポジトリの作成を制限しています。 詳しい情報については、「[インスタンスでリポジトリ作成を制限する](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)」を参照してください。 | -| `business.clear_members_can_create_repos` | サイトアドミンは、インスタンス上の Organization でリポジトリ作成の制限を解除しています。 詳しい情報については、「[インスタンスでリポジトリ作成を制限する](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)」を参照してください。 | +| 名前 | 説明 | +| -------------------------------------------------------:| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `business.update_member_repository_creation_permission` | サイトアドミンは、インスタンス上の Organization でリポジトリの作成を制限しています。 詳細は「[インスタンスでリポジトリ作成を制限する](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)」を参照してください。 | +| `business.clear_members_can_create_repos` | サイトアドミンは、インスタンス上の Organization でリポジトリ作成の制限を解除しています。 詳細は「[インスタンスでリポジトリ作成を制限する](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)」を参照してください。 | | `enterprise.config.lock_anonymous_git_access` | リポジトリ管理者が、インスタンス上のリポジトリに対する既存の匿名 Git 読み取りアクセス設定を変更できないようにするため、サイトアドミンは、匿名 Git 読み取りアクセス設定をロックしています。 詳細は「[ユーザによる匿名 Git 読み取りアクセスの変更を禁止する](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)」を参照してください。 | | `enterprise.config.unlock_anonymous_git_access` | リポジトリ管理者が、インスタンス上のリポジトリに対する既存の匿名 Git 読み取りアクセス設定を変更できるようにするため、サイトアドミンは、匿名 Git 読み取りアクセス設定のロックを解除しています。 詳細は「[ユーザによる匿名 Git 読み取りアクセスの変更を禁止する](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)」を参照してください。 | #### Issue およびプルリクエスト -| 名前 | 説明 | -| ------------------------------------:| ------------------------------------------------------------------------------------------------------------------- | -| `issue.update` | Issue のテキスト本体（最初のコメント）が変更されました。 | -| `issue_comment.update` | Issue （最初以外）のコメントが変更されました。 | -| `pull_request_review_comment.delete` | A comment on a pull request was deleted. | +| 名前 | 説明 | +| ------------------------------------:| --------------------------------------------------------------------------------------------------------------------- | +| `issue.update` | Issue のテキスト本体（最初のコメント）が変更されました。 | +| `issue_comment.update` | Issue （最初以外）のコメントが変更されました。 | +| `pull_request_review_comment.delete` | A comment on a pull request was deleted. | | `issue.destroy` | Issue がリポジトリから削除されました。 詳細は「[Issue を削除する](/enterprise/{{ currentVersion }}/user/articles/deleting-an-issue)」を参照してください。 | #### Organization -| 名前 | 説明 | -| ------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `org.async_delete` | ユーザが Organization を削除するための背景ジョブを開始しました。 | -| `org.delete` | ユーザが行った背景ジョブによって Organization が削除されました。 | +| 名前 | 説明 | +| ------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `org.async_delete` | ユーザが Organization を削除するための背景ジョブを開始しました。 | +| `org.delete` | ユーザが行った背景ジョブによって Organization が削除されました。 | | `org.transform` | ユーザアカウントが Organization へと変換されました。 詳しくは [ユーザをOrganization に変換する方法](/enterprise/{{ currentVersion}}/user/articles/converting-a-user-into-an-organization/) を参照してください。 | #### 保護されたブランチ @@ -76,18 +76,18 @@ versions: #### リポジトリ -| 名前 | 説明 | -| ------------------------------------------:| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `repo.access` | プライベートリポジトリが公開されたか、パブリックリポジトリが非公開にされました。 | +| 名前 | 説明 | +| ------------------------------------------:| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `repo.access` | プライベートリポジトリが公開されたか、パブリックリポジトリが非公開にされました。 | | `repo.archive` | リポジトリがアーカイブされました。 詳細は「[リポジトリのアーカイブとアーカイブ削除](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/)」を参照してください。 | -| `repo.add_member` | リポジトリにコラボレーターが追加されました。 | +| `repo.add_member` | リポジトリにコラボレーターが追加されました。 | | `repo.config` | サイト管理者がフォースプッシュをブロックしました。 詳しくは、 [リポジトリへのフォースプッシュのブロック](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository/)を参照してください。 | -| `repo.create` | リポジトリが作成されました。 | -| `repo.destroy` | リポジトリが削除されました。 | -| `repo.remove_member` | コラボレーターがリポジトリから削除されました。 | -| `repo.rename` | リポジトリの名前が変更されました。 | -| `repo.transfer` | ユーザーが転送されたリポジトリを受け取る要求を受け入れました。 | -| `repo.transfer_start` | ユーザーがリポジトリを別のユーザーまたは Organization に転送する要求を送信しました。 | +| `repo.create` | リポジトリが作成されました。 | +| `repo.destroy` | リポジトリが削除されました。 | +| `repo.remove_member` | コラボレーターがリポジトリから削除されました。 | +| `repo.rename` | リポジトリの名前が変更されました。 | +| `repo.transfer` | ユーザーが転送されたリポジトリを受け取る要求を受け入れました。 | +| `repo.transfer_start` | ユーザーがリポジトリを別のユーザーまたは Organization に転送する要求を送信しました。 | | `repo.unarchive` | リポジトリがアーカイブ解除されました。 詳細は「[リポジトリのアーカイブとアーカイブ削除](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/)」を参照してください。 | | `repo.config.disable_anonymous_git_access` | 匿名 Git 読み取りアクセスがパブリックリポジトリに対して無効になります。 詳細は「[リポジトリに対する匿名 Git 読み取りアクセスを有効化する](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)」を参照してください。 | | `repo.config.enable_anonymous_git_access` | 匿名 Git 読み取りアクセスがパブリックリポジトリに対して有効になっています。 詳細は「[リポジトリに対する匿名 Git 読み取りアクセスを有効化する](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)」を参照してください。 | @@ -96,13 +96,13 @@ versions: #### サイトアドミンのツール -| 名前 | 説明 | -| --------------------:| --------------------------------------------------------------------------------- | -| `staff.disable_repo` | サイトアドミンがリポジトリとその全てのフォークへのアクセスを無効にしました。 | -| `staff.enable_repo` | サイトアドミンがリポジトリとその全てのフォークへのアクセスを再度有効化しました。 | +| 名前 | 説明 | +| --------------------:| ---------------------------------------------------------------------------- | +| `staff.disable_repo` | サイトアドミンがリポジトリとその全てのフォークへのアクセスを無効にしました。 | +| `staff.enable_repo` | サイトアドミンがリポジトリとその全てのフォークへのアクセスを再度有効化しました。 | | `staff.fake_login` | サイトアドミンが {% data variables.product.prodname_enterprise %}に別のユーザとしてサインインしました。 | -| `staff.repo_unlock` | サイトアドミンがユーザのプライベートリポジトリを解除（一時的にフルアクセスが可能）しました。 | -| `staff.unlock` | サイトアドミンがユーザの全てのプライベートリポジトリを解除（一時的にフルアクセスが可能）しました。 | +| `staff.repo_unlock` | サイトアドミンがユーザのプライベートリポジトリを解除（一時的にフルアクセスが可能）しました。 | +| `staff.unlock` | サイトアドミンがユーザの全てのプライベートリポジトリを解除（一時的にフルアクセスが可能）しました。 | #### Team diff --git a/translations/ja-JP/content/admin/user-management/creating-teams.md b/translations/ja-JP/content/admin/user-management/creating-teams.md index f84220fafc2a..dbe2285c3c98 100644 --- a/translations/ja-JP/content/admin/user-management/creating-teams.md +++ b/translations/ja-JP/content/admin/user-management/creating-teams.md @@ -1,6 +1,6 @@ --- title: Teamの作成 -intro: Team は Organization がメンバーのグループを作成し、リポジトリへのアクセスを制御できるようにします。 Team のメンバーには特定のリポジトリの読み取り、書き込み、管理権限を与えることができます。 +intro: 'Team は Organization がメンバーのグループを作成し、リポジトリへのアクセスを制御できるようにします。 Team のメンバーには特定のリポジトリの読み取り、書き込み、管理権限を与えることができます。' redirect_from: - /enterprise/admin/user-management/creating-teams versions: @@ -28,7 +28,7 @@ Teamの良く考えられた組み合わせは、リポジトリへのアクセ ### LDAP Syncを有効化したTeamの作成 -ユーザ認証にLDAPを使っているインスタンスでは、Teamのメンバー管理にLDAP Syncが使えます。 **LDAP group** フィールド内のグループの **Distinguished Name** (DN) を設定すれば、Team を LDAP サーバ上の LDAP グループにマッピングできます。 Teamのメンバー管理にLDAP Syncを使う場合、{% data variables.product.product_location_enterprise %}内でTeamを管理することはできません。 LADP Syncを有効化すると、マッピングされたTeamはそのメンバーをバックグラウンドで定期的に設定された間隔で同期します。 詳しい情報については[LDAP Syncの有効化](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)を参照してください。 +ユーザ認証にLDAPを使っているインスタンスでは、Teamのメンバー管理にLDAP Syncが使えます。 **LDAP group** フィールド内のグループの **Distinguished Name** (DN) を設定すれば、Team を LDAP サーバ上の LDAP グループにマッピングできます。 Teamのメンバー管理にLDAP Syncを使う場合、{% data variables.product.product_location_enterprise %}内でTeamを管理することはできません。 LADP Syncを有効化すると、マッピングされたTeamはそのメンバーをバックグラウンドで定期的に設定された間隔で同期します。 詳しい情報については[LDAP Syncの有効化](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)を参照してください。 {% data reusables.enterprise_user_management.ldap-sync-nested-teams %} @@ -36,17 +36,19 @@ Teamの良く考えられた組み合わせは、リポジトリへのアクセ **ノート:** - LDAP Sync は Team のメンバーリストだけを管理します。 Team のリポジトリと権限は {% data variables.product.prodname_ghe_server %} 内で管理しなければなりません。 -- LDAP グループが削除されるなどして、DN への LDAP グループのマッピングが削除されたなら、すべてのメンバーは同期されている {% data variables.product.prodname_ghe_server %} Team から削除されます。 これを修復するには、Teamを新しいDNにマップし、Teamのメンバーを再度追加し、[手動でマッピングを同期](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap/#manually-syncing-ldap-accounts)してください。 +- LDAP グループが削除されるなどして、DN への LDAP グループのマッピングが削除されたなら、すべてのメンバーは同期されている {% data variables.product.prodname_ghe_server %} Team から削除されます。 これを修復するには、Teamを新しいDNにマップし、Teamのメンバーを再度追加し、[手動でマッピングを同期](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap/#manually-syncing-ldap-accounts)してください。 - LDAP Sync が有効化されていると、ある人がリポジトリから削除された場合、その人はアクセスを失いますが、その人のフォークは削除されません。 元々のOrganizationのリポジトリへのアクセスできるように3ヶ月以内にその人がTeamに追加されたなら、次回の同期の際にフォークへのアクセスは自動的に回復されます。 {% endwarning %} -1. [LDAP Syncが有効化](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)されていることを確認してください。 +1. [LDAP Syncが有効化](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)されていることを確認してください。 {% data reusables.profile.enterprise_access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.new_team %} {% data reusables.organizations.team_name %} -6. TeamをマッピングするLDAPグループのDNを検索してください。 DNが分からないなら、LDAPグループの名前を入力してください。 {% data variables.product.prodname_ghe_server %} は検索を行い、マッチがあればオートコンプリートします。 ![LDAP グループ DN へのマッピング](/assets/images/enterprise/orgs-and-teams/ldap-group-mapping.png) +6. TeamをマッピングするLDAPグループのDNを検索してください。 DNが分からないなら、LDAPグループの名前を入力してください。 +{% data variables.product.prodname_ghe_server %} は検索を行い、マッチがあればオートコンプリートします。 +![LDAP グループ DN へのマッピング](/assets/images/enterprise/orgs-and-teams/ldap-group-mapping.png) {% data reusables.organizations.team_description %} {% data reusables.organizations.team_visibility %} {% data reusables.organizations.create-team-choose-parent %} diff --git a/translations/ja-JP/content/admin/user-management/customizing-user-messages-on-your-instance.md b/translations/ja-JP/content/admin/user-management/customizing-user-messages-on-your-instance.md index efb76bb9d656..ed725857c93c 100644 --- a/translations/ja-JP/content/admin/user-management/customizing-user-messages-on-your-instance.md +++ b/translations/ja-JP/content/admin/user-management/customizing-user-messages-on-your-instance.md @@ -3,7 +3,7 @@ title: インスタンス上でのユーザメッセージをカスタマイズ redirect_from: - /enterprise/admin/user-management/creating-a-custom-sign-in-message/ - /enterprise/admin/user-management/customizing-user-messages-on-your-instance -intro: '{% if currentVersion ver_gt "enterprise-server@2.15" %}サインインページおよびサインアウトページでユーザに見せるカスタムメッセージ{% else %}サインインページでユーザに見せるカスタムメッセージ{% endif %}を作成できます。' +intro: 'You can create custom messages that users will see on the sign in and sign out pages{% if currentVersion ver_gt "enterprise-server@2.21" %} or in an announcement banner at the top of every page{% endif %}.' versions: enterprise-server: '*' --- diff --git a/translations/ja-JP/content/admin/user-management/managing-dormant-users.md b/translations/ja-JP/content/admin/user-management/managing-dormant-users.md index d9a3425eb7f8..aafde4061a82 100644 --- a/translations/ja-JP/content/admin/user-management/managing-dormant-users.md +++ b/translations/ja-JP/content/admin/user-management/managing-dormant-users.md @@ -1,45 +1,38 @@ --- -title: Managing dormant users +title: 休眠ユーザの管理 redirect_from: - /enterprise/admin/articles/dormant-users/ - /enterprise/admin/articles/viewing-dormant-users/ - /enterprise/admin/articles/determining-whether-a-user-account-is-dormant/ - /enterprise/admin/user-management/managing-dormant-users - - /enterprise/admin/user-management/managing-dormant-users - - /enterprise/admin/user-management/managing-dormant-users - - /enterprise/admin/user-management/managing-dormant-users -intro: A user account is considered to be dormant if it has not been active for at least a month. You may choose to suspend dormant users to free up user licenses. +intro: 少なくとも 1 か月の間活動のなかったユーザアカウントは、休眠していると見なされます。 You may choose to suspend dormant users to free up user licenses. versions: enterprise-server: '*' --- -"Activity" includes, but is not limited to: -- Signing in to {% data variables.product.prodname_ghe_server %}. -- Commenting on issues and pull requests. -- Creating, deleting, watching, and starring repositories. +「活動」には以下のことが含まれますが、以下に限定はされません: +- {% data variables.product.prodname_ghe_server %} へのサインイン。 +- Issue やプルリクエストへのコメント。 +- リポジトリの作成、削除、Watch、スター付け。 - Pushing commits.{% if currentVersion ver_gt "enterprise-server@2.21" %} - Accessing resources by using a personal access token or SSH key.{% endif %} -### Viewing dormant users +### 休眠ユーザの表示 -You can view a list of all dormant users who have not been suspended and who are not site administrators. +サスペンドされておらず、サイト管理者でもないすべての休眠ユーザのリストを表示できます。 {% data reusables.enterprise_site_admin_settings.access-settings %} -3. In the left sidebar, click **Dormant users**. -![Dormant users tab](/assets/images/enterprise/site-admin-settings/dormant-users-tab.png) -4. To suspend all the dormant users in this list, at the top of the page, click **Suspend all**. -![Suspend all button](/assets/images/enterprise/site-admin-settings/suspend-all.png) +3. 左のサイドバーで**Dormant users（休眠ユーザ）**をクリックしてください。 ![休眠ユーザタブ](/assets/images/enterprise/site-admin-settings/dormant-users-tab.png) +4. このリスト中のすべての休眠ユーザをサスペンドするには、ページの上部で**Suspend all（全員をサスペンド）**をクリックしてください。 ![全員をサスペンドボタン](/assets/images/enterprise/site-admin-settings/suspend-all.png) -### Determining whether a user account is dormant +### ユーザアカウントが休眠状態かの判断 {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.search-user %} {% data reusables.enterprise_site_admin_settings.click-user %} -5. In the **User info** section, a red dot with the word "Dormant" indicates the user account is dormant, and a green dot with the word "Active" indicates the user account is active. -![Dormant user account](/assets/images/enterprise/stafftools/dormant-user.png) -![Active user account](/assets/images/enterprise/stafftools/active-user.png) +5. **User info（ユーザ情報）**セクションで"Dormant（休眠）"という語の付いた赤い点は、そのユーザアカウントが休眠状態であることを示し、"Active（アクティブ）"という語の付いた緑の点はそのユーザアカウントがアクティブであることを示します。 ![休眠ユーザアカウント](/assets/images/enterprise/stafftools/dormant-user.png) ![アクティブなユーザアカウント](/assets/images/enterprise/stafftools/active-user.png) -### Configuring the dormancy threshold +### 休眠の閾値の設定 {% data reusables.enterprise_site_admin_settings.dormancy-threshold %} @@ -51,5 +44,4 @@ You can view a list of all dormant users who have not been suspended and who are {% data reusables.enterprise-accounts.settings-tab %} {% endif %} {% data reusables.enterprise-accounts.options-tab %} -4. Under "Dormancy threshold", use the drop-down menu, and click the desired dormancy threshold. -![The Dormancy threshold drop-down menu](/assets/images/enterprise/site-admin-settings/dormancy-threshold-menu.png) +4. [Dormancy threshold] の下で、ドロップダウンメニューを使って、希望する休眠閾値をクリックします。 ![休眠の閾値のドロップダウンメニュー](/assets/images/enterprise/site-admin-settings/dormancy-threshold-menu.png) diff --git a/translations/ja-JP/content/admin/user-management/managing-global-webhooks.md b/translations/ja-JP/content/admin/user-management/managing-global-webhooks.md index 39a8380c51b6..58f4d17aed5b 100644 --- a/translations/ja-JP/content/admin/user-management/managing-global-webhooks.md +++ b/translations/ja-JP/content/admin/user-management/managing-global-webhooks.md @@ -1,6 +1,6 @@ --- title: グローバルwebhookの管理 -intro: サイト管理者は、インスタンスレベルのイベントを追跡するためのグローバルwebhookの表示、追加、編集、削除が行えます。 +intro: 'サイト管理者は、インスタンスレベルのイベントを追跡するためのグローバルwebhookの表示、追加、編集、削除が行えます。' redirect_from: - /enterprise/admin/user-management/about-global-webhooks - /enterprise/admin/user-management/managing-global-webhooks diff --git a/translations/ja-JP/content/admin/user-management/managing-organizations-in-your-enterprise.md b/translations/ja-JP/content/admin/user-management/managing-organizations-in-your-enterprise.md index 7a747ad5b357..d336e2b9931f 100644 --- a/translations/ja-JP/content/admin/user-management/managing-organizations-in-your-enterprise.md +++ b/translations/ja-JP/content/admin/user-management/managing-organizations-in-your-enterprise.md @@ -5,7 +5,7 @@ redirect_from: - /enterprise/admin/categories/admin-bootcamp/ - /enterprise/admin/user-management/organizations-and-teams - /enterprise/admin/user-management/managing-organizations-in-your-enterprise -intro: Organizationは企業内で、部署や同様のプロジェクトで作業を行うグループなど、個別のユーザグループを作成する素晴らしい手段です。 Organizationに属するパブリックリポジトリは他のOrganizationのユーザからもアクセスできますが、プライベートリポジトリはOrganizationのメンバーでなければアクセスできません。 +intro: 'Organizationは企業内で、部署や同様のプロジェクトで作業を行うグループなど、個別のユーザグループを作成する素晴らしい手段です。 Organizationに属するパブリックリポジトリは他のOrganizationのユーザからもアクセスできますが、プライベートリポジトリはOrganizationのメンバーでなければアクセスできません。' mapTopic: true versions: enterprise-server: '*' diff --git a/translations/ja-JP/content/admin/user-management/monitoring-activity-in-your-enterprise.md b/translations/ja-JP/content/admin/user-management/monitoring-activity-in-your-enterprise.md index f867608ea0ff..991fef7abca5 100644 --- a/translations/ja-JP/content/admin/user-management/monitoring-activity-in-your-enterprise.md +++ b/translations/ja-JP/content/admin/user-management/monitoring-activity-in-your-enterprise.md @@ -4,8 +4,6 @@ mapTopic: true redirect_from: - /enterprise/admin/installation/monitoring-activity-on-your-github-enterprise-server-instance - /enterprise/admin/user-management/monitoring-activity-in-your-enterprise - - /enterprise/admin/user-management/monitoring-activity-in-your-enterprise - - /enterprise/admin/user-management/monitoring-activity-in-your-enterprise versions: enterprise-server: '*' --- diff --git a/translations/ja-JP/content/admin/user-management/promoting-or-demoting-a-site-administrator.md b/translations/ja-JP/content/admin/user-management/promoting-or-demoting-a-site-administrator.md index dff6f3509b73..3b69402f4fd7 100644 --- a/translations/ja-JP/content/admin/user-management/promoting-or-demoting-a-site-administrator.md +++ b/translations/ja-JP/content/admin/user-management/promoting-or-demoting-a-site-administrator.md @@ -4,14 +4,14 @@ redirect_from: - /enterprise/admin/articles/promoting-a-site-administrator/ - /enterprise/admin/articles/demoting-a-site-administrator/ - /enterprise/admin/user-management/promoting-or-demoting-a-site-administrator -intro: サイト管理者は、任意の通常ユーザアカウントをサイト管理者に昇格させることや、他のサイト管理者を通常のユーザに降格させることができます。 +intro: 'サイト管理者は、任意の通常ユーザアカウントをサイト管理者に昇格させることや、他のサイト管理者を通常のユーザに降格させることができます。' versions: enterprise-server: '*' --- {% tip %} -**メモ:** [ユーザの LDAP アクセスの設定](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#configuring-ldap-with-your-github-enterprise-server-instance)時に [LDAP Sync が有効](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)になっており、`Administrators group` 属性が設定されている場合、それらのユーザは自動的にインスタンスに対するサイト管理者アクセスを持つことになります。 この場合、以下のステップで手動でユーザを昇格させることはできません。ユーザを昇格させるにはLDAPの管理者グループに追加してください。 +**メモ:** [ユーザの LDAP アクセスの設定](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#configuring-ldap-with-your-github-enterprise-server-instance)時に [LDAP Sync が有効](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)になっており、`Administrators group` 属性が設定されている場合、それらのユーザは自動的にインスタンスに対するサイト管理者アクセスを持つことになります。 この場合、以下のステップで手動でユーザを昇格させることはできません。ユーザを昇格させるにはLDAPの管理者グループに追加してください。 {% endtip %} diff --git a/translations/ja-JP/content/admin/user-management/rebuilding-contributions-data.md b/translations/ja-JP/content/admin/user-management/rebuilding-contributions-data.md index 6f2d7375a2d3..74a23fd7b01c 100644 --- a/translations/ja-JP/content/admin/user-management/rebuilding-contributions-data.md +++ b/translations/ja-JP/content/admin/user-management/rebuilding-contributions-data.md @@ -15,4 +15,5 @@ versions: 3. ページ左にある、**Admin** をクリックする。 ![[Admin] タブ](/assets/images/enterprise/site-admin-settings/admin-tab.png) 4. **Contributions data** で、**Rebuild** をクリックする。 ![[Rebuild] ボタン](/assets/images/enterprise/site-admin-settings/rebuild-button.png) -{% data variables.product.prodname_enterprise %} は、コミットをユーザアカウントに再度リンクするためのバックグラウンドジョブを開始します。 ![待ち行列に入っている再構築ジョブ](/assets/images/enterprise/site-admin-settings/rebuild-jobs.png) +{% data variables.product.prodname_enterprise %} will now start background jobs to re-link commits with that user's account. + ![待ち行列に入っている再構築ジョブ](/assets/images/enterprise/site-admin-settings/rebuild-jobs.png) diff --git a/translations/ja-JP/content/admin/user-management/removing-users-from-teams-and-organizations.md b/translations/ja-JP/content/admin/user-management/removing-users-from-teams-and-organizations.md index a51245583ab1..9944d4bbf660 100644 --- a/translations/ja-JP/content/admin/user-management/removing-users-from-teams-and-organizations.md +++ b/translations/ja-JP/content/admin/user-management/removing-users-from-teams-and-organizations.md @@ -1,6 +1,6 @@ --- title: Team及びOrganizationからのユーザの削除 -intro: Organizationのメンバーが特定のリポジトリへのアクセスを必要としなくなったなら、そのメンバーをアクセスを許可しているTeamから削除できます。 OrganizationのメンバーがOrganizationの所有するすべてのリポジトリへのアクセスを必要としなくなったなら、そのメンバーをOrganizationから削除できます。 +intro: 'Organizationのメンバーが特定のリポジトリへのアクセスを必要としなくなったなら、そのメンバーをアクセスを許可しているTeamから削除できます。 OrganizationのメンバーがOrganizationの所有するすべてのリポジトリへのアクセスを必要としなくなったなら、そのメンバーをOrganizationから削除できます。' redirect_from: - /enterprise/admin/user-management/removing-users-from-teams-and-organizations versions: diff --git a/translations/ja-JP/content/admin/user-management/requiring-two-factor-authentication-for-an-organization.md b/translations/ja-JP/content/admin/user-management/requiring-two-factor-authentication-for-an-organization.md index de49ee34e816..b1e190a5a343 100644 --- a/translations/ja-JP/content/admin/user-management/requiring-two-factor-authentication-for-an-organization.md +++ b/translations/ja-JP/content/admin/user-management/requiring-two-factor-authentication-for-an-organization.md @@ -1,6 +1,6 @@ --- title: Organizationに2要素認証を要求する -intro: Organizationのメンバーと外部のコラボレータに対し、Organizatin内の個人アカウントで2要素認証を有効化することを求め、悪意ある者がOrganizationのリポジトリや設定にアクセスするのを困難にできます。 +intro: 'Organizationのメンバーと外部のコラボレータに対し、Organizatin内の個人アカウントで2要素認証を有効化することを求め、悪意ある者がOrganizationのリポジトリや設定にアクセスするのを困難にできます。' redirect_from: - /enterprise/admin/user-management/requiring-two-factor-authentication-for-an-organization versions: diff --git a/translations/ja-JP/content/admin/user-management/searching-the-audit-log.md b/translations/ja-JP/content/admin/user-management/searching-the-audit-log.md index 19c4ed9479f9..1f9b53273c42 100644 --- a/translations/ja-JP/content/admin/user-management/searching-the-audit-log.md +++ b/translations/ja-JP/content/admin/user-management/searching-the-audit-log.md @@ -13,22 +13,22 @@ versions: AND/ORの論理演算子で区切られた値のペア:1つ以上のキーを使って、検索クエリを構成します。 -| キー | 値 | -| --------------:| ----------------------------------------------------------------------------------------- | -| `actor_id` | アクションを開始したユーザアカウントの ID | -| `actor` | アクションを開始したユーザアカウントの名前 | -| `oauth_app_id` | アクションに関連付けられている OAuth アプリケーションの ID | +| キー | 値 | +| --------------:| ------------------------------------------------------------------------------------------- | +| `actor_id` | アクションを開始したユーザアカウントの ID | +| `actor` | アクションを開始したユーザアカウントの名前 | +| `oauth_app_id` | アクションに関連付けられている OAuth アプリケーションの ID | | `action` | [監査されたアクション](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions)の名前 | -| `user_id` | アクションによって影響を受けたユーザの ID | -| `ユーザ` | アクションによって影響を受けたユーザの名前 | -| `repo_id` | アクションによって影響を受けたリポジトリの ID （妥当な場合） | -| `repo` | アクションによって影響を受けたリポジトリの名前 （妥当な場合） | -| `actor_ip` | アクション元の IP アドレス | -| `created_at` | アクションが作成された時間 | -| `from` | アクション元の View | -| `note` | イベント固有の他の情報（プレーンテキストまたは JSON フォーマット） | -| `org` | アクションによって影響を受けたOrganizationの名前（該当する場合） | -| `org_id` | アクションによって影響を受けたOrganizationの ID（該当する場合） | +| `user_id` | アクションによって影響を受けたユーザの ID | +| `ユーザ` | アクションによって影響を受けたユーザの名前 | +| `repo_id` | アクションによって影響を受けたリポジトリの ID （妥当な場合） | +| `repo` | アクションによって影響を受けたリポジトリの名前 （妥当な場合） | +| `actor_ip` | アクション元の IP アドレス | +| `created_at` | アクションが作成された時間 | +| `from` | アクション元の View | +| `note` | イベント固有の他の情報（プレーンテキストまたは JSON フォーマット） | +| `org` | アクションによって影響を受けたOrganizationの名前（該当する場合） | +| `org_id` | アクションによって影響を受けたOrganizationの ID（該当する場合） | たとえば、2017 年の初めからリポジトリ `octocat/Spoon-Knife` に影響を与えたすべてのアクションを確認するには、次のようにします: diff --git a/translations/ja-JP/content/admin/user-management/suspending-and-unsuspending-users.md b/translations/ja-JP/content/admin/user-management/suspending-and-unsuspending-users.md index d152a80bd495..f67a97998afb 100644 --- a/translations/ja-JP/content/admin/user-management/suspending-and-unsuspending-users.md +++ b/translations/ja-JP/content/admin/user-management/suspending-and-unsuspending-users.md @@ -27,7 +27,7 @@ fatal: The remote end hung up unexpectedly {% tip %} -**メモ:** 仮に {% data variables.product.product_location_enterprise %} で [LDAP Sync が有効化されている](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)なら、LDAP ディレクトリサーバから削除されたユーザは自動的にサスペンドされます。 インスタンスで LDAP Sync が有効化されている場合、通常のユーザのサスペンド方法は無効化されています。 +**メモ:** 仮に {% data variables.product.product_location_enterprise %} で [LDAP Sync が有効化されている](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)なら、LDAP ディレクトリサーバから削除されたユーザは自動的にサスペンドされます。 インスタンスで LDAP Sync が有効化されている場合、通常のユーザのサスペンド方法は無効化されています。 {% endtip %} diff --git a/translations/ja-JP/content/admin/user-management/troubleshooting-service-hooks.md b/translations/ja-JP/content/admin/user-management/troubleshooting-service-hooks.md index 3c09611f36be..cde4705c14b8 100644 --- a/translations/ja-JP/content/admin/user-management/troubleshooting-service-hooks.md +++ b/translations/ja-JP/content/admin/user-management/troubleshooting-service-hooks.md @@ -1,6 +1,6 @@ --- title: サービスフックのトラブルシューティング -intro: ペイロードが配信されない場合、以下の一般的な問題をチェックしてください。 +intro: 'ペイロードが配信されない場合、以下の一般的な問題をチェックしてください。' redirect_from: - /enterprise/admin/articles/troubleshooting-service-hooks/ - /enterprise/admin/developer-workflow/troubleshooting-service-hooks diff --git a/translations/ja-JP/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-a-repository-from-github-to-github-desktop.md b/translations/ja-JP/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-a-repository-from-github-to-github-desktop.md index 5346ba7a47b9..f904f7d0b1cb 100644 --- a/translations/ja-JP/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-a-repository-from-github-to-github-desktop.md +++ b/translations/ja-JP/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-a-repository-from-github-to-github-desktop.md @@ -15,7 +15,9 @@ versions: {% mac %} -1. クローンする前に、{% data variables.product.product_location %}と{% data variables.product.prodname_desktop %}にサインインします。 +1. Sign in to + +{% data variables.product.product_location %} and {% data variables.product.prodname_desktop %} before you start to clone. {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.open-with-github-desktop %} 5. [**Choose...**]をクリックし、Finderウインドウを使用してリポジトリをクローンするローカルパスに移動します。 ![URLタブにあるchooseボタン](/assets/images/help/desktop/clone-choose-button-url-mac.png) @@ -32,7 +34,9 @@ versions: {% windows %} -1. クローンする前に、{% data variables.product.product_location %}と{% data variables.product.prodname_desktop %}にサインインします。 +1. Sign in to + +{% data variables.product.product_location %} and {% data variables.product.prodname_desktop %} before you start to clone. {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.open-with-github-desktop %} 5. **Choose...**をクリックし、Windows Explorerを使用してリポジトリをクローンするローカルパスに移動します。 ![Chooseボタン](/assets/images/help/desktop/clone-choose-button-url-win.png) diff --git a/translations/ja-JP/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop.md b/translations/ja-JP/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop.md index 862403bd7fd7..1bc222580e33 100644 --- a/translations/ja-JP/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop.md +++ b/translations/ja-JP/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop.md @@ -19,8 +19,8 @@ versions: ![Mac アプリケーション内の [Clone] メニューオプション](/assets/images/help/desktop/clone-file-menu-mac.png) {% data reusables.desktop.cloning-location-tab %} ![[Clone a repository] メニュー内の [Location] タブ](/assets/images/help/desktop/choose-repository-location-mac.png) -{% data reusables.desktop.cloning-repository-list %} -![リポジトリリストのクローン](/assets/images/help/desktop/clone-a-repository-list-mac.png) +{% data reusables.desktop.cloning-repository-list %} + ![リポジトリリストのクローン](/assets/images/help/desktop/clone-a-repository-list-mac.png) 4. [**Choose...**]をクリックし、Finderウインドウを使用してリポジトリをクローンするローカルパスに移動します。 ![Chooseボタン](/assets/images/help/desktop/clone-choose-button-mac.png) 5. **Clone**をクリックします。 ![Cloneボタン](/assets/images/help/desktop/clone-button-mac.png) @@ -32,8 +32,8 @@ versions: ![Windows アプリケーション内の [Clone] メニューオプション](/assets/images/help/desktop/clone-file-menu-windows.png) {% data reusables.desktop.cloning-location-tab %} ![[Clone a repository] メニュー内の [Location] タブ](/assets/images/help/desktop/choose-repository-location-win.png) -{% data reusables.desktop.cloning-repository-list %} -![リポジトリリストのクローン](/assets/images/help/desktop/clone-a-repository-list-win.png) +{% data reusables.desktop.cloning-repository-list %} + ![リポジトリリストのクローン](/assets/images/help/desktop/clone-a-repository-list-win.png) 4. **Choose...**をクリックし、Windows Explorerを使用してリポジトリをクローンするローカルパスに移動します。 ![Chooseボタン](/assets/images/help/desktop/clone-choose-button-win.png) 5. **Clone**をクリックします。 ![Cloneボタン](/assets/images/help/desktop/clone-button-win.png) diff --git a/translations/ja-JP/content/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request.md b/translations/ja-JP/content/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request.md index 0b5cd0b5ceb5..f5004443ebfb 100644 --- a/translations/ja-JP/content/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request.md +++ b/translations/ja-JP/content/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request.md @@ -1,7 +1,7 @@ --- title: Issueもしくはプルリクエストの作成 intro: リポジトリに対する変更の提案あるいは共同作業のために、Issueあるいはプルリクエストを作成できます。 -permissions: Issue が有効になっているパブリックリポジトリに誰でも Issue を作成できます。 リポジトリに対する読み取り権限があるユーザなら誰でもプルリクエストを作成できますが、ブランチの作成には書き込み権限が必要です。 +permissions: 'Issue が有効になっているパブリックリポジトリに誰でも Issue を作成できます。 リポジトリに対する読み取り権限があるユーザなら誰でもプルリクエストを作成できますが、ブランチの作成には書き込み権限が必要です。' redirect_from: - /desktop/contributing-to-projects/creating-an-issue-or-pull-request - /desktop/contributing-to-projects/creating-a-pull-request @@ -50,7 +50,9 @@ Issue を使用して、プロジェクトにとって重要なアイデア、 1. プルリクエストを作成するブランチに切り替えます。 詳しい情報については、「[ブランチの切り替え](/desktop/contributing-and-collaborating-using-github-desktop/managing-branches#switching-between-branches)」を参照してください。 2. **Create Pull Request**をクリックします {% data variables.product.prodname_desktop %} はデフォルトのブラウザを開いて {% data variables.product.prodname_dotcom %} に移動します。 ![[Create Pull Request] ボタン](/assets/images/help/desktop/mac-create-pull-request.png) -4. {% data variables.product.prodname_dotcom %} で、**base:** ドロップダウンメニューのブランチが変更をマージするブランチであることを確認します。 **compare:** ドロップダウンメニューのブランチが、変更を加えたトピックブランチであることを確認します。 ![ベースを選択し、ブランチを比較するドロップダウンメニュー](/assets/images/help/desktop/base-and-compare-branches.png) +4. On +{% data variables.product.prodname_dotcom %}, confirm that the branch in the **base:** drop-down menu is the branch where you want to merge your changes. **compare:** ドロップダウンメニューのブランチが、変更を加えたトピックブランチであることを確認します。 + ![ベースを選択し、ブランチを比較するドロップダウンメニュー](/assets/images/help/desktop/base-and-compare-branches.png) {% data reusables.repositories.pr-title-description %} {% data reusables.repositories.create-pull-request %} @@ -60,7 +62,9 @@ Issue を使用して、プロジェクトにとって重要なアイデア、 1. プルリクエストを作成するブランチに切り替えます。 詳しい情報については、「[ブランチの切り替え](/desktop/contributing-and-collaborating-using-github-desktop/managing-branches#switching-between-branches)」を参照してください。 2. **Create Pull Request**をクリックします {% data variables.product.prodname_desktop %} はデフォルトのブラウザを開いて {% data variables.product.prodname_dotcom %} に移動します。 ![[Create Pull Request] ボタン](/assets/images/help/desktop/windows-create-pull-request.png) -3. {% data variables.product.prodname_dotcom %} で、**base:** ドロップダウンメニューのブランチが変更をマージするブランチであることを確認します。 **compare:** ドロップダウンメニューのブランチが、変更を加えたトピックブランチであることを確認します。 ![ベースを選択し、ブランチを比較するドロップダウンメニュー](/assets/images/help/desktop/base-and-compare-branches.png) +3. On +{% data variables.product.prodname_dotcom %}, confirm that the branch in the **base:** drop-down menu is the branch where you want to merge your changes. **compare:** ドロップダウンメニューのブランチが、変更を加えたトピックブランチであることを確認します。 + ![ベースを選択し、ブランチを比較するドロップダウンメニュー](/assets/images/help/desktop/base-and-compare-branches.png) {% data reusables.repositories.pr-title-description %} {% data reusables.repositories.create-pull-request %} diff --git a/translations/ja-JP/content/desktop/contributing-and-collaborating-using-github-desktop/index.md b/translations/ja-JP/content/desktop/contributing-and-collaborating-using-github-desktop/index.md index cd23e5c6e8b4..95b930232e5e 100644 --- a/translations/ja-JP/content/desktop/contributing-and-collaborating-using-github-desktop/index.md +++ b/translations/ja-JP/content/desktop/contributing-and-collaborating-using-github-desktop/index.md @@ -1,7 +1,7 @@ --- title: GitHub Desktop を使用したコントリビューションとコラボレーション shortTitle: コントリビューションとコラボレーション -intro: GitHub Desktopを使って、プロジェクトを管理し、有意義なコミットを作成し、プロジェクトの履歴をコマンドラインではなくアプリで追跡しましょう。 +intro: 'GitHub Desktopを使って、プロジェクトを管理し、有意義なコミットを作成し、プロジェクトの履歴をコマンドラインではなくアプリで追跡しましょう。' redirect_from: - /desktop/contributing-to-projects versions: diff --git a/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/about-connections-to-github.md b/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/about-connections-to-github.md index 7a6ac5d2c208..804bae26fb46 100644 --- a/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/about-connections-to-github.md +++ b/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/about-connections-to-github.md @@ -1,17 +1,17 @@ --- -title: About connections to GitHub -intro: '{% data variables.product.prodname_desktop %} uses HTTPS to securely exchange data with {% data variables.product.prodname_dotcom %}.' +title: GitHub への接続について +intro: '{% data variables.product.prodname_desktop %} は、HTTPS を使用して {% data variables.product.prodname_dotcom %} と安全にデータを交換します。' redirect_from: - /desktop/getting-started-with-github-desktop/about-connections-to-github versions: free-pro-team: '*' --- -{% data variables.product.prodname_desktop %} connects to {% data variables.product.prodname_dotcom %} when you pull from, push to, clone, and fork remote repositories. To connect to {% data variables.product.prodname_dotcom %} from {% data variables.product.prodname_desktop %}, you must authenticate your account. 詳しい情報については「[{% data variables.product.prodname_dotcom %}への認証を行う](/desktop/getting-started-with-github-desktop/authenticating-to-github)」を参照してください。 +{% data variables.product.prodname_desktop %} は、リモートリポジトリからプル、プッシュ、クローン、フォークを行うと、{% data variables.product.prodname_dotcom %} に接続します。 {% data variables.product.prodname_desktop %} から {% data variables.product.prodname_dotcom %} に接続するには、アカウントを認証する必要があります。 詳しい情報については「[{% data variables.product.prodname_dotcom %}への認証を行う](/desktop/getting-started-with-github-desktop/authenticating-to-github)」を参照してください。 -After you authenticate to {% data variables.product.prodname_dotcom %}, you can connect to remote repositories with {% data variables.product.prodname_desktop %}. {% data variables.product.prodname_desktop %} caches your credentials (username and password or personal access token) and uses the credentials to authenticate for each connection to the remote repository. +{% data variables.product.prodname_dotcom %} への認証後、{% data variables.product.prodname_desktop %} を使用してリモートリポジトリに接続できます。 {% data variables.product.prodname_desktop %} は、認証情報（ユーザ名とパスワード、または個人アクセストークン）をキャッシュし、その認証情報を使用してリモートリポジトリへの接続ごとに認証します。 -{% data variables.product.prodname_desktop %} connects to {% data variables.product.prodname_dotcom %} using HTTPS. If you use {% data variables.product.prodname_desktop %} to access repositories that were cloned using SSH, you may encounter errors. To connect to a repository that was cloned using SSH, change the remote's URLs. 詳しい情報については、「[リモートの URL を変更する](/github/using-git/changing-a-remotes-url)」を参照してください。 +{% data variables.product.prodname_desktop %} は、HTTPS を使用して {% data variables.product.prodname_dotcom %} に接続します。 SSH を使用してクローンされたリポジトリにアクセスする際に {% data variables.product.prodname_desktop %} を使用すると、エラーが発生する可能性があります。 SSH を使用してクローンされたリポジトリに接続するには、リモートの URL を変更します。 詳しい情報については、「[リモートの URL を変更する](/github/using-git/changing-a-remotes-url)」を参照してください。 ### 参考リンク -- "[Cloning and forking repositories from GitHub Desktop](/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop)" +- 「[GitHub Desktop からのリポジトリのクローンとフォーク](/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop)」 diff --git a/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/authenticating-to-github.md b/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/authenticating-to-github.md index 25decbe83423..1f3077a57ace 100644 --- a/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/authenticating-to-github.md +++ b/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/authenticating-to-github.md @@ -37,7 +37,9 @@ versions: {% data reusables.desktop.mac-select-desktop-menu %} {% data reusables.desktop.mac-select-accounts %} {% data reusables.desktop.choose-product-authenticate %} -4. {% data variables.product.prodname_enterprise %} アカウントを追加するには、[Enterprise server address] に認証情報を入力して [**Continue**] をクリックします。 ![GitHub EnterpriseのSign Inボタン](/assets/images/help/desktop/mac-sign-in-button-enterprise.png) +4. To add a +{% data variables.product.prodname_enterprise %} account, type your credentials under "Enterprise server address," then click **Continue**. + ![GitHub EnterpriseのSign Inボタン](/assets/images/help/desktop/mac-sign-in-button-enterprise.png) {% data reusables.desktop.retrieve-2fa %} {% endmac %} @@ -65,7 +67,9 @@ versions: {% data reusables.desktop.windows-choose-options %} {% data reusables.desktop.windows-select-accounts %} {% data reusables.desktop.choose-product-authenticate %} -4. {% data variables.product.prodname_enterprise %} アカウントを追加するには、[Enterprise server address] に認証情報を入力して [**Continue**] をクリックします。 ![GitHub EnterpriseのSign Inボタン](/assets/images/help/desktop/windows-sign-in-button-enterprise.png) +4. To add a +{% data variables.product.prodname_enterprise %} account, type your credentials under "Enterprise server address," then click **Continue**. + ![GitHub EnterpriseのSign Inボタン](/assets/images/help/desktop/windows-sign-in-button-enterprise.png) {% data reusables.desktop.retrieve-2fa %} {% endwindows %} @@ -80,14 +84,14 @@ versions: {% mac %} -1. [**Help**] ドロップダウンメニューを使用して、[**Show Logs in Finder**] をクリックします。 ![The Show Logs in Finder button](/assets/images/help/desktop/mac-show-logs.png) +1. [**Help**] ドロップダウンメニューを使用して、[**Show Logs in Finder**] をクリックします。 ![[Show Logs in Finder] ボタン](/assets/images/help/desktop/mac-show-logs.png) 2. 認証エラーが発生した日付からログファイルを選択します。 {% endmac %} {% windows %} -1. [**Help**] ドロップダウンメニューを使用して、[**Show Logs in Explorer**] をクリックします。 ![The Show Logs in Explorer button](/assets/images/help/desktop/windows-show-logs.png) +1. [**Help**] ドロップダウンメニューを使用して、[**Show Logs in Explorer**] をクリックします。 ![[Show Logs in Explorer] ボタン](/assets/images/help/desktop/windows-show-logs.png) 2. 認証エラーが発生した日付からログファイルを選択します。 {% endwindows %} @@ -150,30 +154,30 @@ fatal: Could not read from remote repository. 正しいアクセス権があり、リポジトリが存在することを確認してください。 ``` -This error means that either the repository that you are trying to clone has submodules that you do not have access to or you do not have a valid SSH key set up. +このエラーは、クローンを作成しようとしているリポジトリにアクセス権のないサブモジュールがあるか、有効な SSH キーが設定されていないことを示しています。 -If you do not have access to the submodules, troubleshoot by contacting the person who administers permissions for the repository. +サブモジュールにアクセスできない場合は、リポジトリの権限の管理者に連絡してトラブルシューティングを行ってください。 -If you do not have a valid SSH key set up, see "[Generating a new SSH key and adding it to the SSH agent](/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)." +有効な SSH キーが設定されていない場合は、「[新しい SSH キーを生成して SSH エージェントに追加する](/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)」を参照してください。 {% windows %} -#### Unable to read AskPass response +#### AskPass レスポンスが読み取れない ```shell error: unable to read askpass response from '/Users//GitHub Desktop.app/Contents/Resources/app/static/ask-pass-trampoline.sh' fatal: could not read Username for 'https://github.com': terminal prompts disabled ``` -This error can be caused by multiple events. +このエラーは、複数のイベントによって発生する可能性があります。 -If the `Command Processor` registry entries are modified, {% data variables.product.prodname_desktop %} will respond with an `Authentication failed` error. To check if these registry entries have been modified, follow these steps. +`Command Processor` のレジストリエントリが変更されると、{% data variables.product.prodname_desktop %} は、`Authentication failed` で応答します。 これらのレジストリエントリが変更されているかどうかを確認するには、次のステップを実行します。 -1. Open the Registry Editor (`regedit.exe`) and navigate to the following locations. `` HKEY_CURRENT_USER\Software\Microsoft\Command Processor\` ``HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Command Processor\` -2. Check to see if there is an `Autorun` value in either location. -3. If there is an `Autorun` value, delete it. +1. レジストリエディタ（`regedit.exe`）を開き、次の場所に移動します。 `` HKEY_CURRENT_USER\Software\Microsoft\Command Processor\` ``HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Command Processor\` +2. いずれかの場所に `Autorun` 値があるかどうかを確認します。 +3. `Autorun` 値がある場合は、それを削除します。 -If your Windows username has extended Unicode characters, it may cause an AskPass response error. To troubleshoot, create a new Windows user account and migrate your files to that account. For more information, see "[Create a user account in Windows](https://support.microsoft.com/en-us/help/13951/windows-create-user-account)" in the Microsoft documentation. +Windows ユーザ名に拡張 Unicode 文字が含まれている場合、AskPass レスポンスエラーが発生する可能性があります。 トラブルシューティングを行うには、新しい Windows ユーザアカウントを作成し、ファイルをそのアカウントに移行します。 詳しい情報については、Microsoft ドキュメンテーションの「[Windows でユーザアカウントを作成する](https://support.microsoft.com/en-us/help/13951/windows-create-user-account)」を参照してください。 {% endwindows %} diff --git a/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop.md b/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop.md index 70d4f4b072b2..1bc209e50926 100644 --- a/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop.md +++ b/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop.md @@ -1,6 +1,6 @@ --- title: GitHub Desktopの設定とカスタマイズ -intro: Gitをセットアップし、デフォルトのエディタに接続し、GitHub Desktopをワークフローに適合させるために設定をカスタマイズしてください。 +intro: 'Gitをセットアップし、デフォルトのエディタに接続し、GitHub Desktopをワークフローに適合させるために設定をカスタマイズしてください。' mapTopic: true redirect_from: - /desktop/getting-started-with-github-desktop/configuring-and-customizing-github-desktop diff --git a/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/configuring-basic-settings.md b/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/configuring-basic-settings.md index e9741a7c0ef6..026429c2a8cf 100644 --- a/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/configuring-basic-settings.md +++ b/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/configuring-basic-settings.md @@ -1,6 +1,6 @@ --- title: ベーシック設定 -intro: プライバシー保護、アカウントのGitHub Desktopへの関連付け、およびGit構成のための設定にアクセスできます。 +intro: 'プライバシー保護、アカウントのGitHub Desktopへの関連付け、およびGit構成のための設定にアクセスできます。' redirect_from: - /desktop/getting-started-with-github-desktop/configuring-basic-settings versions: diff --git a/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/configuring-git-for-github-desktop.md b/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/configuring-git-for-github-desktop.md index 51300e814562..99537c5b41f6 100644 --- a/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/configuring-git-for-github-desktop.md +++ b/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/configuring-git-for-github-desktop.md @@ -1,14 +1,14 @@ --- title: GitHub Desktop用のGitの設定方法 -shortTitle: Configuring Git -intro: Gitをまだインストールしていない場合、GitHub Desktopを使う前にGitを設定する必要があります。 +shortTitle: Git を設定する +intro: 'Gitをまだインストールしていない場合、GitHub Desktopを使う前にGitを設定する必要があります。' redirect_from: - /desktop/getting-started-with-github-desktop/configuring-git-for-github-desktop versions: free-pro-team: '*' --- -{% data variables.product.prodname_desktop %} uses the email address you set in your local Git configuration to connect commits with your account on {% data variables.product.product_name %}. +{% data variables.product.prodname_desktop %} は、ローカルの Git 設定で設定したメールアドレスを使用して、{% data variables.product.product_name %} のアカウントにコミットを接続します。 {% data reusables.desktop.update-email-address %} @@ -26,13 +26,13 @@ versions: {% data reusables.desktop.copy-email-git-config %} {% data reusables.desktop.return-to-desktop %} {% data reusables.desktop.mac-select-desktop-menu %} -7. In the Preferences window, click **Git**. ![[Preferences] メニュー内の Git ペイン](/assets/images/help/desktop/mac-select-git-pane.png) +7. [Preferences] ウィンドウで [**Git**] を選択します。 ![[Preferences] メニュー内の Git ペイン](/assets/images/help/desktop/mac-select-git-pane.png) {% data reusables.desktop.name-field-git-config %} ![Git コンフィグレーション内の [Name] フィールド](/assets/images/help/desktop/mac-name-git-config.png) {% data reusables.desktop.paste-email-git-config %} ![Gitコンフィグレーションフィールドに貼り付けられたEメールアドレス](/assets/images/help/desktop/mac-email-git-config.png) {% data reusables.desktop.click-save-git-config %} - ![Save button in Git configuration field](/assets/images/help/desktop/mac-save-git-config.png) + ![Git 設定フィールドの [Save] ボタン](/assets/images/help/desktop/mac-save-git-config.png) {% endmac %} @@ -44,13 +44,13 @@ versions: {% data reusables.desktop.copy-email-git-config %} {% data reusables.desktop.return-to-desktop %} {% data reusables.desktop.windows-choose-options %} -8. In the Options window, click **Git**. ![[Options] メニュー内の Git ペイン](/assets/images/help/desktop/windows-select-git-pane.png) +8. [Options] ウィンドウで [**Git**] を選択します。 ![[Options] メニュー内の Git ペイン](/assets/images/help/desktop/windows-select-git-pane.png) {% data reusables.desktop.name-field-git-config %} ![Git コンフィグレーション内の [Name] フィールド](/assets/images/help/desktop/windows-name-git-config.png) {% data reusables.desktop.paste-email-git-config %} ![Gitコンフィグレーションフィールドに貼り付けられたEメールアドレス](/assets/images/help/desktop/windows-email-git-config.png) {% data reusables.desktop.click-save-git-config %} - ![Save button in Git configuration field](/assets/images/help/desktop/windows-save-git-config.png) + ![Git 設定フィールドの [Save] ボタン](/assets/images/help/desktop/windows-save-git-config.png) {% endwindows %} diff --git a/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/getting-started-with-github-desktop.md b/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/getting-started-with-github-desktop.md index 348207f816fd..159e4febbb23 100644 --- a/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/getting-started-with-github-desktop.md +++ b/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/getting-started-with-github-desktop.md @@ -92,7 +92,7 @@ After you make changes to a branch, you can review them in {% data variables.pro ![Viewing and making commits](/assets/images/help/desktop/commit-button.png) -If you want to access your changes remotely or share them with other people, you can push your commits to {% data variables.product.prodname_dotcom %}. For more information, see "[Pushing changes to {% data variables.product.prodname_dotcom %}](/desktop/contributing-and-collaborating-using-github-desktop/pushing-changes-to-github)." +If you want to access your changes remotely or share them with other people, you can push your commits to {% data variables.product.prodname_dotcom %}. 詳しい情報については、「[{% data variables.product.prodname_dotcom %} への変更をプッシュする](/desktop/contributing-and-collaborating-using-github-desktop/pushing-changes-to-github)」を参照してください。 #### Collaborating with {% data variables.product.prodname_desktop %} You can use {% data variables.product.prodname_desktop %} to create issues or pull requests to collaborate on projects with other people. Issues help you keep track of ideas and discuss possible changes to projects. Pull requests let you share your proposed changes with others, receive feedback, and merge changes into a project. For more information, see "[Creating an issue or pull request](/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request)."'' @@ -100,7 +100,7 @@ You can use {% data variables.product.prodname_desktop %} to create issues or pu You can view your own or your collaborator's pull requests in {% data variables.product.prodname_desktop %}. Viewing a pull request in {% data variables.product.prodname_desktop %} lets you see any proposed changes and make additional changes by opening the project's files and repositories in your default text editor. For more information, see "[Viewing a pull request in {% data variables.product.prodname_desktop %}](/desktop/contributing-and-collaborating-using-github-desktop/viewing-a-pull-request-in-github-desktop)." #### Keeping your local repository in sync -When you make changes to your local repositories or when other people make changes to the remote repositories, you will need to sync your local copy of the project with the remote repository. {% data variables.product.prodname_desktop %} can keep your local copy of a project in sync with the remote version by pushing and pulling commits. For more information, see "[Syncing your branch](/desktop/contributing-and-collaborating-using-github-desktop/syncing-your-branch)." +When you make changes to your local repositories or when other people make changes to the remote repositories, you will need to sync your local copy of the project with the remote repository. {% data variables.product.prodname_desktop %} can keep your local copy of a project in sync with the remote version by pushing and pulling commits. 詳しい情報については、「[ブランチを同期する](/desktop/contributing-and-collaborating-using-github-desktop/syncing-your-branch)」を参照してください。 ### 参考リンク - "[Installing and authenticating to {% data variables.product.prodname_desktop %}](/desktop/getting-started-with-github-desktop/installing-and-authenticating-to-github-desktop)" diff --git a/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/index.md b/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/index.md index bae9b9956440..826314067ae6 100644 --- a/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/index.md +++ b/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/index.md @@ -1,7 +1,7 @@ --- -title: Installing and configuring GitHub Desktop +title: GitHub Desktop のインストールと設定 shortTitle: インストールと設定 -intro: 'Get {% data variables.product.prodname_desktop %} set up to manage your project work. Authenticate to {% data variables.product.prodname_dotcom_the_website %} or {% data variables.product.prodname_enterprise %}, keep the app up-to-date, and review your preferred settings.' +intro: '{% data variables.product.prodname_desktop %} を設定して、プロジェクトの作業を管理します。 {% data variables.product.prodname_dotcom_the_website %} または {% data variables.product.prodname_enterprise %} に対して認証を行って、アプリケーションを最新の状態に保ち、お好みの設定を確認します。' redirect_from: - /desktop/getting-started-with-github-desktop versions: diff --git a/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/keyboard-shortcuts.md b/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/keyboard-shortcuts.md index 879eff11428d..7e2b5a300a95 100644 --- a/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/keyboard-shortcuts.md +++ b/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/keyboard-shortcuts.md @@ -14,51 +14,51 @@ macOSでのGitHub Desktopキーボードショートカット ### サイト全体のショートカット -| キーボードショートカット | 説明 | -| ------------------------------------ | --------------------------------------------------------------- | -| ⌘, | 設定に移動 | +| キーボードショートカット | 説明 | +| ------------------------------------ | ---------------------------------------------------------- | +| ⌘, | 設定に移動 | | ⌘H | {% data variables.product.prodname_desktop %}のアプリケーションの非表示 | -| ⌥⌘H | 他の全てのアプリケーションの非表示 | +| ⌥⌘H | 他の全てのアプリケーションの非表示 | | ⌘Q | {% data variables.product.prodname_desktop %}を終了 | -| ⌃⌘F | フルスクリーン表示をオン/オフにする | -| ⌘0 | ズームをデフォルトのテキストサイズにリセット | -| ⌘= | ズームインして、テキストとグラフィックスを大きくする | -| ⌘- | ズームアウトして、テキストとグラフィックスを小さくする | -| ⌥⌘I | デベロッパーツールの表示/非表示 | +| ⌃⌘F | フルスクリーン表示をオン/オフにする | +| ⌘0 | ズームをデフォルトのテキストサイズにリセット | +| ⌘= | ズームインして、テキストとグラフィックスを大きくする | +| ⌘- | ズームアウトして、テキストとグラフィックスを小さくする | +| ⌥⌘I | デベロッパーツールの表示/非表示 | ### リポジトリ -| キーボードショートカット | 説明 | -| ------------------------------------ | --------------------------------------------------------------- | -| ⌘N | 新規リポジトリの追加 | -| ⌘O | ローカルリポジトリの追加 | +| キーボードショートカット | 説明 | +| ------------------------------------ | ---------------------------------------------------------- | +| ⌘N | 新規リポジトリの追加 | +| ⌘O | ローカルリポジトリの追加 | | ⇧⌘O | {% data variables.product.prodname_dotcom %}からリポジトリをクローンする | -| ⌘T | リポジトリリストの表示 | +| ⌘T | リポジトリリストの表示 | | ⌘P | 最新コミットを{% data variables.product.prodname_dotcom %}にプッシュ | | ⇧⌘P | 最新変更を{% data variables.product.prodname_dotcom %}からプルダウン | -| ⌘⌫ | 既存リポジトリの削除 | +| ⌘⌫ | 既存リポジトリの削除 | | ⇧⌘G | {% data variables.product.prodname_dotcom %}にリポジトリを表示 | -| ⌃` | リポジトリをお好みのターミナルツールで開く | -| ⇧⌘F | Finderでリポジトリを表示 | -| ⇧⌘A | リポジトリをお好みのエディタツールで開く | +| ⌃` | リポジトリをお好みのターミナルツールで開く | +| ⇧⌘F | Finderでリポジトリを表示 | +| ⇧⌘A | リポジトリをお好みのエディタツールで開く | | ⌘I | {% data variables.product.prodname_dotcom %}でIssueを作成 | ### ブランチ -| キーボードショートカット | 説明 | -| ------------------------------------ | --------------------------------------------------------------- | -| ⌘1 | コミットする前に全ての変更を表示 | -| ⌘2 | コミット履歴を表示 | -| ⌘B | 全てのブランチを表示 | -| ⌘G | コミット概要のフィールドに移動 | -| space | Select or deselect all highlighted files | -| ⇧⌘N | 新規ブランチの作成 | -| ⇧⌘R | 現在ブランチの名前を変更 | -| ⇧⌘D | 現在ブランチの削除 | -| ⇧⌘U | デフォルトブランチから更新 | -| ⇧⌘B | 既存のブランチと比較 | -| ⇧⌘M | 現在ブランチにマージ | -| ⌃H | stash した変更の表示または非表示 | +| キーボードショートカット | 説明 | +| ------------------------------------ | ---------------------------------------------------------- | +| ⌘1 | コミットする前に全ての変更を表示 | +| ⌘2 | コミット履歴を表示 | +| ⌘B | 全てのブランチを表示 | +| ⌘G | コミット概要のフィールドに移動 | +| space | ハイライトされたすべてのファイルを選択または選択解除 | +| ⇧⌘N | 新規ブランチの作成 | +| ⇧⌘R | 現在ブランチの名前を変更 | +| ⇧⌘D | 現在ブランチの削除 | +| ⇧⌘U | デフォルトブランチから更新 | +| ⇧⌘B | 既存のブランチと比較 | +| ⇧⌘M | 現在ブランチにマージ | +| ⌃H | stash した変更の表示または非表示 | | ⇧⌘C | {% data variables.product.prodname_dotcom %}のブランチを比較 | | ⌘R | 現在のプルリクエストを{% data variables.product.prodname_dotcom %}に表示 | @@ -81,37 +81,37 @@ WindowsでのGitHub Desktopキーボードのショートカット ### リポジトリ -| キーボード ショート カット | 説明 | -| ------------------------------------------- | --------------------------------------------------------------- | -| CtrlN | 新規リポジトリの追加 | -| CtrlO | ローカルリポジトリの追加 | +| キーボード ショート カット | 説明 | +| ------------------------------------------- | ---------------------------------------------------------- | +| CtrlN | 新規リポジトリの追加 | +| CtrlO | ローカルリポジトリの追加 | | CtrlShiftO | {% data variables.product.prodname_dotcom %}からリポジトリをクローンする | -| CtrlT | リポジトリリストの表示 | +| CtrlT | リポジトリリストの表示 | | CtrlP | 最新コミットを{% data variables.product.prodname_dotcom %}にプッシュ | | CtrlShiftP | 最新変更を{% data variables.product.prodname_dotcom %}からプルダウン | -| CtrlDelete | 既存リポジトリの削除 | +| CtrlDelete | 既存リポジトリの削除 | | CtrlShiftG | {% data variables.product.prodname_dotcom %}にリポジトリを表示 | -| Ctrl` | リポジトリをお好みのコマンドラインルツールで開く | -| CtrlShiftF | Explorerでリポジトリを表示 | -| CtrlShiftA | リポジトリをお好みのエディタツールで開く | +| Ctrl` | リポジトリをお好みのコマンドラインルツールで開く | +| CtrlShiftF | Explorerでリポジトリを表示 | +| CtrlShiftA | リポジトリをお好みのエディタツールで開く | | CtrlI | {% data variables.product.prodname_dotcom %}でIssueを作成 | ### ブランチ -| キーボードショートカット | 説明 | -| ------------------------------------------- | --------------------------------------------------------------- | -| Ctrl1 | コミットする前に全ての変更を表示 | -| Ctrl2 | コミット履歴を表示 | -| CtrlB | 全てのブランチを表示 | -| CtrlG | コミット概要のフィールドに移動 | -| space | Select or deselect all highlighted files | -| CtrlShiftN | 新規ブランチの作成 | -| CtrlShiftR | 現在ブランチの名前を変更 | -| CtrlShiftD | 現在ブランチの削除 | -| CtrlShiftU | デフォルトブランチから更新 | -| CtrlShiftB | 既存のブランチと比較 | -| CtrlShiftM | 現在ブランチにマージ | -| CtrlH | stash した変更の表示または非表示 | +| キーボードショートカット | 説明 | +| ------------------------------------------- | ---------------------------------------------------------- | +| Ctrl1 | コミットする前に全ての変更を表示 | +| Ctrl2 | コミット履歴を表示 | +| CtrlB | 全てのブランチを表示 | +| CtrlG | コミット概要のフィールドに移動 | +| space | ハイライトされたすべてのファイルを選択または選択解除 | +| CtrlShiftN | 新規ブランチの作成 | +| CtrlShiftR | 現在ブランチの名前を変更 | +| CtrlShiftD | 現在ブランチの削除 | +| CtrlShiftU | デフォルトブランチから更新 | +| CtrlShiftB | 既存のブランチと比較 | +| CtrlShiftM | 現在ブランチにマージ | +| CtrlH | stash した変更の表示または非表示 | | CtrlShiftC | {% data variables.product.prodname_dotcom %}のブランチを比較 | | CtrlR | 現在のプルリクエストを{% data variables.product.prodname_dotcom %}に表示 | diff --git a/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/launching-github-desktop-from-the-command-line.md b/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/launching-github-desktop-from-the-command-line.md index d25cd2750ca0..7044f171c981 100644 --- a/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/launching-github-desktop-from-the-command-line.md +++ b/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/launching-github-desktop-from-the-command-line.md @@ -1,6 +1,6 @@ --- title: コマンドラインからのGitHub Desktopの起動方法 -shortTitle: Launching from the command line +shortTitle: コマンドラインから起動する intro: GitHub Desktopはコマンドラインで起動できます。 redirect_from: - /desktop/getting-started-with-github-desktop/launching-github-desktop-from-the-command-line @@ -10,7 +10,7 @@ versions: {% mac %} -1. In the menu bar, select the **{% data variables.product.prodname_desktop %}** menu, then click **Install Command Line Tool**. ![Install Command Line Tool option in the {% data variables.product.prodname_desktop %} drop-down menu](/assets/images/help/desktop/mac-install-command-line-tool.png) +1. メニューバーで、[**{% data variables.product.prodname_desktop %}**] メニューを選択し、[**Install Command Line Tool**] をクリックします。 ![[{% data variables.product.prodname_desktop %}]ドロップダウンメニューの [Install Command Line Tool] オプション](/assets/images/help/desktop/mac-install-command-line-tool.png) 2. ターミナルを開きます。 3. {% data reusables.desktop.launch-desktop-from-command-line %} @@ -18,7 +18,7 @@ versions: $ github /path/to/repo ``` - You can also change to your repository path and then type `github .` to open that repository. + リポジトリパスに変更してから、`github .`と入力してそのリポジトリを開くこともできます。 ```shell $ cd /path/to/repo @@ -36,7 +36,7 @@ versions: C:\Users\octocat> github path\to\repo ``` - You can also change to your repository path and then type `github .` to open that repository. + リポジトリパスに変更してから、`github .`と入力してそのリポジトリを開くこともできます。 ```shell C:\Users\octocat> cd repo\myrepo diff --git a/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/supported-operating-systems.md b/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/supported-operating-systems.md index bcc7bc1692c3..3714e5a98c28 100644 --- a/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/supported-operating-systems.md +++ b/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/supported-operating-systems.md @@ -1,6 +1,6 @@ --- -title: Supported operating systems -intro: 'You can use {% data variables.product.prodname_desktop %} on any supported operating system.' +title: サポートされているオペレーティングシステム +intro: 'サポートされているオペレーティングシステムで {% data variables.product.prodname_desktop %} を使用できます。' miniTocMaxHeadingLevel: 4 redirect_from: - /desktop/getting-started-with-github-desktop/supported-operating-systems @@ -8,41 +8,41 @@ versions: free-pro-team: '*' --- -### About supported operating systems +### サポートされているオペレーティングシステムについて -The following operating systems are supported for {% data variables.product.prodname_desktop %}. +{% data variables.product.prodname_desktop %} では、次のオペレーティングシステムがサポートされています。 - {% data variables.desktop.mac-osx-versions %} -- {% data variables.desktop.windows-versions %}. You must have a 64-bit operating system to run {% data variables.product.prodname_desktop %}. +- {% data variables.desktop.windows-versions %}. {% data variables.product.prodname_desktop %} を実行するには、64 ビットのオペレーティングシステムが必要です。 -### Troubleshooting problems on macOS -If you're encountering problems using {% data variables.product.prodname_desktop %} on macOS, here are resolutions to try. For more information, see [`known-issues`](https://github.com/desktop/desktop/blob/development/docs/known-issues.md). +### macOS に関する問題のトラブルシューティング +macOS で {% data variables.product.prodname_desktop %} を使用して問題が発生した場合は、以下の解決策を試してください。 詳しい情報については、[`known-issues`](https://github.com/desktop/desktop/blob/development/docs/known-issues.md) を参照してください。 -#### `The username or passphrase you entered is not correct` error after signing into your account +#### アカウントへのサインイン時のエラー：`The username or passphrase you entered is not correct`（入力したユーザ名またはパスフレーズが正しくありません） -This error can occur when {% data variables.product.prodname_desktop %} can't access your stored credentials on Keychain. +このエラーは、{% data variables.product.prodname_desktop %} がキーチェーンに保存されている認証情報にアクセスできない場合に発生する可能性があります。 -To troubleshoot this error, follow these steps. +このエラーのトラブルシューティングを行うには、次のステップを実行します。 -1. Open the "Keychain Access" app. -2. Right-click on **login** and then click **Lock Keychain "login"**. ![The "Lock Keychain "login" option](/assets/images/help/desktop/mac-lock-keychain.png) -3. Right-click on **login** and then click **Unlock Keychain "login"**. Follow any onscreen prompts to finish unlocking the Keychain "login." ![The "Unlock Keychain "login" option](/assets/images/help/desktop/mac-unlock-keychain.png) -4. Re-authenticate your account on {% data variables.product.prodname_dotcom %} or {% data variables.product.prodname_enterprise %}. +1. 「Keychain Access」アプリケーションを開きます。 +2. [**login**] を右クリックして、[**Lock Keychain "login"**] をクリックします。 ![The "Lock Keychain "login" option](/assets/images/help/desktop/mac-lock-keychain.png) +3. [**login**] を右クリックして、[**Unlock Keychain "login"**] をクリックします。 画面の指示に従って、Keychain "login" のロック解除を完了します。 ![The "Unlock Keychain "login" option](/assets/images/help/desktop/mac-unlock-keychain.png) +4. {% data variables.product.prodname_dotcom %} または {% data variables.product.prodname_enterprise %} でアカウントを再認証します。 -#### `Could not create temporary directory: Permission denied` error after checking for updates +#### アップデート確認時のエラー：`Could not create temporary directory: Permission denied`（一時ディレクトリを作成できませんでした：権限が拒否されました） -This error can be caused by missing permissions for the `~/Library/Caches/com.github.GitHubClient.ShipIt` directory. {% data variables.product.prodname_desktop %} uses this directory to create and unpack temporary files as part of updating the application. +このエラーは、`~/Library/Caches/com.github.GitHubClient.ShipIt` ディレクトリの権限がない場合に発生する可能性があります。 {% data variables.product.prodname_desktop %} はこのディレクトリを使用して、アプリケーションの更新の一部として一時ファイルを作成および解凍します。 -To troubleshoot this error, follow these steps. +このエラーのトラブルシューティングを行うには、次のステップを実行します。 -1. Close {% data variables.product.prodname_desktop %}. -2. Open "Finder" and navigate to `~/Library/Caches/`. -3. Right-click `com.github.GitHubClient.ShipIt` and then click **Get Info**. -4. Click the arrow to the left of "Sharing & Permissions." -5. If the Privilege to the right of your user account does not say "Read & Write," click the text and then click **Read & Write**. ![The "Sharing & Permissions" options](/assets/images/help/desktop/mac-adjust-permissions.png) -6. Open {% data variables.product.prodname_desktop %} and check for updates. +1. {% data variables.product.prodname_desktop %} を閉じます。 +2. 「Finder」を開き、`~/Library/Caches/` に移動します。 +3. `com.github.GitHubClient.ShipIt` を右クリックし、[**Get Info**] をクリックします。 +4. [Sharing & Permissions] の左にある矢印をクリックします。 +5. ユーザアカウントの右にある権限に「Read & Write」と表示されていない場合は、テキストをクリックして、[**Read & Write**] をクリックします。 ![The "Sharing & Permissions" options](/assets/images/help/desktop/mac-adjust-permissions.png) +6. {% data variables.product.prodname_desktop %} を開き、更新を確認します。 -### Troubleshooting problems on Windows -If you're encountering problems using {% data variables.product.prodname_desktop %} on Windows, here are resolutions to try. For more information, see [`known-issues`](https://github.com/desktop/desktop/blob/development/docs/known-issues.md). +### Windows に関する問題のトラブルシューティング +Windows で {% data variables.product.prodname_desktop %} を使用して問題が発生した場合は、以下の解決策を試してください。 詳しい情報については、[`known-issues`](https://github.com/desktop/desktop/blob/development/docs/known-issues.md) を参照してください。 #### `The revocation function was unable to check revocation for the certificate.` error diff --git a/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/uninstalling-github-desktop.md b/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/uninstalling-github-desktop.md index 5d0b8370ca1d..68d47cbd049d 100644 --- a/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/uninstalling-github-desktop.md +++ b/translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/uninstalling-github-desktop.md @@ -1,6 +1,6 @@ --- title: GitHub Desktopのアンインストール方法 -intro: You can uninstall GitHub Desktop from your computer at any time. +intro: GitHub Desktop はいつでもコンピュータからアンインストールできます。 redirect_from: - /desktop/getting-started-with-github-desktop/uninstalling-github-desktop versions: @@ -9,18 +9,18 @@ versions: {% mac %} -1. In a Finder window, navigate to the Applications folder. ![Applications folder in the Finder window](/assets/images/help/desktop/applications-folder.png) -2. While pressing the **Control** button on your keyboard, click **{% data variables.product.prodname_desktop %}**. -3. **Move to Trash**を選択します。 ![The Move to Trash option](/assets/images/help/desktop/mac-move-to-trash.png) -4. In the menu bar, use the **Finder** drop-down menu, then click **Empty Trash**. ![The Empty Trash option in the menu bar](/assets/images/help/desktop/mac-empty-trash-menu.png) -5. ポップアップボックスの警告を読んで、**Empty Trash**をクリックします。 ![The Empty Trash button](/assets/images/help/desktop/mac-empty-trash-button.png) +1. Finder ウィンドウで Applications フォルダに移動します。 ![Finder ウィンドウのアプリケーションフォルダ](/assets/images/help/desktop/applications-folder.png) +2. キーボードの **Control** ボタンを押しながら、[**{% data variables.product.prodname_desktop %}**] をクリックします。 +3. **Move to Trash**を選択します。 ![[Move to Trash] オプション](/assets/images/help/desktop/mac-move-to-trash.png) +4. メニューバーで、[**Finder**] ドロップダウンメニューを使用し、[**Empty Trash**] をクリックします。 ![メニューバーの [Empty Trash] オプション](/assets/images/help/desktop/mac-empty-trash-menu.png) +5. ポップアップボックスの警告を読んで、**Empty Trash**をクリックします。 ![[Empty Trash] ボタン](/assets/images/help/desktop/mac-empty-trash-button.png) {% endmac %} {% windows %} -1. Open Control Panel. For more information, see [Where is Control Panel?](https://support.microsoft.com/en-us/help/13764/windows-where-is-control-panel) in Windows Help. -2. Under "Programs", click **Uninstall a program**. ![The Uninstall a Program option in Control Panel](/assets/images/help/desktop/windows-uninstall-a-program.png) -3. Right-click the entry named **{% data variables.product.prodname_desktop %}**, then click **Uninstall**. ![The Uninstall option](/assets/images/help/desktop/windows-click-uninstall.png) +1. コントロールパネルを開きます。 詳しい情報については、Windows ヘルプにある「[コントロールパネルの場所](https://support.microsoft.com/en-us/help/13764/windows-where-is-control-panel)」を参照してください。 +2. [Programs] で [**Uninstall a program**] をクリックします。 ![コントロールパネルの [Uninstall a Program] オプション](/assets/images/help/desktop/windows-uninstall-a-program.png) +3. [**{% data variables.product.prodname_desktop %}**] という名前の項目を右クリックして、[**Uninstall**] をクリックします。 ![アンインストールオプション](/assets/images/help/desktop/windows-click-uninstall.png) {% endwindows %} diff --git a/translations/ja-JP/content/developers/apps/about-apps.md b/translations/ja-JP/content/developers/apps/about-apps.md index 29638d66f743..8c0d306e7398 100644 --- a/translations/ja-JP/content/developers/apps/about-apps.md +++ b/translations/ja-JP/content/developers/apps/about-apps.md @@ -19,7 +19,7 @@ Apps on {% data variables.product.prodname_dotcom %} allow you to automate and i For a walkthrough of the process of building a {% data variables.product.prodname_github_app %}, see "[Building Your First {% data variables.product.prodname_github_app %}](/apps/building-your-first-github-app)." -### {% data variables.product.prodname_github_apps %}について +### {% data variables.product.prodname_github_apps %} について {% data variables.product.prodname_github_apps %} are first-class actors within GitHub. A {% data variables.product.prodname_github_app %} acts on its own behalf, taking actions via the API directly using its own identity, which means you don't need to maintain a bot or service account as a separate user. diff --git a/translations/ja-JP/content/developers/apps/activating-beta-features-for-apps.md b/translations/ja-JP/content/developers/apps/activating-beta-features-for-apps.md index 389ecf6690b1..f349501d5f0c 100644 --- a/translations/ja-JP/content/developers/apps/activating-beta-features-for-apps.md +++ b/translations/ja-JP/content/developers/apps/activating-beta-features-for-apps.md @@ -15,7 +15,8 @@ versions: {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} -3. Select the {% data variables.product.prodname_github_app %} you want to enable a beta feature for. +3. Select the +{% data variables.product.prodname_github_app %} you want to enable a beta feature for. {% data reusables.apps.beta_feature_activation %} ### Activating beta features for {% data variables.product.prodname_oauth_app %}s diff --git a/translations/ja-JP/content/developers/apps/authorizing-oauth-apps.md b/translations/ja-JP/content/developers/apps/authorizing-oauth-apps.md index 9117ac2ed80a..87f8be697567 100644 --- a/translations/ja-JP/content/developers/apps/authorizing-oauth-apps.md +++ b/translations/ja-JP/content/developers/apps/authorizing-oauth-apps.md @@ -1,5 +1,5 @@ --- -title: OAuth アプリケーションの認可 +title: Authorizing OAuth Apps intro: '{% data reusables.shortdesc.authorizing_oauth_apps %}' redirect_from: - /apps/building-integrations/setting-up-and-registering-oauth-apps/about-authorization-options-for-oauth-apps/ @@ -30,7 +30,7 @@ For standard apps that run in the browser, use the [web application flow](#web-a {% endif %} -### Web アプリケーションフロー +### Web application flow {% note %} @@ -50,16 +50,16 @@ The web application flow to authorize users for your app is: When your GitHub App specifies a `login` parameter, it prompts users with a specific account they can use for signing in and authorizing your app. -##### パラメータ +##### Parameters -| 名前 | 種類 | 説明 | -| -------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `client_id` | `string` | **Required**. The client ID you received from GitHub when you {% if currentVersion == "free-pro-team@latest" %}[registered](https://github.com/settings/applications/new){% else %}registered{% endif %}. | -| `redirect_uri` | `string` | The URL in your application where users will be sent after authorization. See details below about [redirect urls](#redirect-urls). | -| `login` | `string` | Suggests a specific account to use for signing in and authorizing the app. | -| `スコープ` | `string` | A space-delimited list of [scopes](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/). If not provided, `scope` defaults to an empty list for users that have not authorized any scopes for the application. For users who have authorized scopes for the application, the user won't be shown the OAuth authorization page with the list of scopes. Instead, this step of the flow will automatically complete with the set of scopes the user has authorized for the application. For example, if a user has already performed the web flow twice and has authorized one token with `user` scope and another token with `repo` scope, a third web flow that does not provide a `scope` will receive a token with `user` and `repo` scope. | -| `状態` | `string` | {% data reusables.apps.state_description %} | -| `allow_signup` | `string` | Whether or not unauthenticated users will be offered an option to sign up for GitHub during the OAuth flow. 省略値は `true` です。 Use `false` when a policy prohibits signups. | +Name | Type | Description +-----|------|-------------- +`client_id`|`string` | **Required**. The client ID you received from GitHub when you {% if currentVersion == "free-pro-team@latest" %}[registered](https://github.com/settings/applications/new){% else %}registered{% endif %}. +`redirect_uri`|`string` | The URL in your application where users will be sent after authorization. See details below about [redirect urls](#redirect-urls). +`login` | `string` | Suggests a specific account to use for signing in and authorizing the app. +`scope`|`string` | A space-delimited list of [scopes](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/). If not provided, `scope` defaults to an empty list for users that have not authorized any scopes for the application. For users who have authorized scopes for the application, the user won't be shown the OAuth authorization page with the list of scopes. Instead, this step of the flow will automatically complete with the set of scopes the user has authorized for the application. For example, if a user has already performed the web flow twice and has authorized one token with `user` scope and another token with `repo` scope, a third web flow that does not provide a `scope` will receive a token with `user` and `repo` scope. +`state` | `string` | {% data reusables.apps.state_description %} +`allow_signup`|`string` | Whether or not unauthenticated users will be offered an option to sign up for GitHub during the OAuth flow. The default is `true`. Use `false` when a policy prohibits signups. #### 2. Users are redirected back to your site by GitHub @@ -69,27 +69,28 @@ Exchange this `code` for an access token: POST {% data variables.product.oauth_host_code %}/login/oauth/access_token -##### パラメータ +##### Parameters -| 名前 | 種類 | 説明 | -| --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `client_id` | `string` | **Required.** The client ID you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_github_app %}. | -| `client_secret` | `string` | **Required.** The client secret you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_github_app %}. | -| `コード` | `string` | **Required.** The code you received as a response to Step 1. | -| `redirect_uri` | `string` | The URL in your application where users are sent after authorization. | -| `状態` | `string` | The unguessable random string you provided in Step 1. | +Name | Type | Description +-----|------|-------------- +`client_id` | `string` | **Required.** The client ID you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_github_app %}. +`client_secret` | `string` | **Required.** The client secret you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_github_app %}. +`code` | `string` | **Required.** The code you received as a response to Step 1. +`redirect_uri` | `string` | The URL in your application where users are sent after authorization. +`state` | `string` | The unguessable random string you provided in Step 1. -##### レスポンス +##### Response By default, the response takes the following form: access_token=e72e16c7e42f292c6912e7710c838347ae178b4a&token_type=bearer -You can also receive the content in different formats depending on the Accept header: +You can also receive the content in different formats depending on the Accept +header: Accept: application/json {"access_token":"e72e16c7e42f292c6912e7710c838347ae178b4a", "scope":"repo,gist", "token_type":"bearer"} - + Accept: application/xml bearer @@ -135,13 +136,12 @@ Your app must request a user verification code and verification URL that the app ##### Input Parameters -| 名前 | 種類 | 説明 | -| ----------- | -------- | ---------------------------------------------------------------------------------------------------------- | -| `client_id` | `string` | **Required.** The client ID you received from {% data variables.product.product_name %} for your app. | -| `スコープ` | `string` | The scope that your app is requesting access to. | - -##### レスポンス +Name | Type | Description +-----|------|-------------- +`client_id` | `string` | **Required.** The client ID you received from {% data variables.product.product_name %} for your app. +`scope` | `string` | The scope that your app is requesting access to. +##### Response {% if currentVersion == "free-pro-team@latest" %} ```JSON @@ -167,13 +167,13 @@ Your app must request a user verification code and verification URL that the app ##### Response parameters -| 名前 | 種類 | 説明 | -| ------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `device_code` | `string` | The device verification code is 40 characters and used to verify the device. | -| `user_code` | `string` | The user verification code is displayed on the device so the user can enter the code in a browser. This code is 8 characters with a hyphen in the middle. | -| `verification_uri` | `string` | The verification URL where users need to enter the `user_code`: {% data variables.product.device_authorization_url %}. | -| `expires_in` | `整数` | The number of seconds before the `device_code` and `user_code` expire. The default is 900 seconds or 15 minutes. | -| `interval` | `整数` | The minimum number of seconds that must pass before you can make a new access token request (`POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`) to complete the device authorization. For example, if the interval is 5, then you cannot make a new request until 5 seconds pass. If you make more than one request over 5 seconds, then you will hit the rate limit and receive a `slow_down` error. | +Name | Type | Description +-----|------|-------------- +`device_code` | `string` | The device verification code is 40 characters and used to verify the device. +`user_code` | `string` | The user verification code is displayed on the device so the user can enter the code in a browser. This code is 8 characters with a hyphen in the middle. +`verification_uri` | `string` | The verification URL where users need to enter the `user_code`: {% data variables.product.device_authorization_url %}. +`expires_in` | `integer`| The number of seconds before the `device_code` and `user_code` expire. The default is 900 seconds or 15 minutes. +`interval` | `integer` | The minimum number of seconds that must pass before you can make a new access token request (`POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`) to complete the device authorization. For example, if the interval is 5, then you cannot make a new request until 5 seconds pass. If you make more than one request over 5 seconds, then you will hit the rate limit and receive a `slow_down` error. #### Step 2: Prompt the user to enter the user code in a browser @@ -193,13 +193,13 @@ Once the user has authorized, the app will receive an access token that can be u ##### Input parameters -| 名前 | 種類 | 説明 | -| ------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `client_id` | `string` | **Required.** The client ID you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_oauth_app %}. | -| `device_code` | `string` | **Required.** The device verification code you received from the `POST {% data variables.product.oauth_host_code %}/login/device/code` request. | -| `grant_type` | `string` | **Required.** The grant type must be `urn:ietf:params:oauth:grant-type:device_code`. | +Name | Type | Description +-----|------|-------------- +`client_id` | `string` | **Required.** The client ID you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_oauth_app %}. +`device_code` | `string` | **Required.** The device verification code you received from the `POST {% data variables.product.oauth_host_code %}/login/device/code` request. +`grant_type` | `string` | **Required.** The grant type must be `urn:ietf:params:oauth:grant-type:device_code`. -##### レスポンス +##### Response ```json { @@ -217,15 +217,15 @@ If you make more than one access token request (`POST {% data variables.product. #### Error codes for the device flow -| Error code | 説明 | -| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `authorization_pending` | This error occurs when the authorization request is pending and the user hasn't entered the user code yet. The app is expected to keep polling the `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token` request without exceeding the [`interval`](#response-parameters), which requires a minimum number of seconds between each request. | -| `slow_down` | When you receive the `slow_down` error, 5 extra seconds are added to the minimum `interval` or timeframe required between your requests using `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`. For example, if the starting interval required at least 5 seconds between requests and you get a `slow_down` error response, you must now wait a minimum of 10 seconds before making a new request for an OAuth access token. The error response includes the new `interval` that you must use. | -| `expired_token` | If the device code expired, then you will see the `token_expired` error. You must make a new request for a device code. | -| `unsupported_grant_type` | The grant type must be `urn:ietf:params:oauth:grant-type:device_code` and included as an input parameter when you poll the OAuth token request `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`. | -| `incorrect_client_credentials` | For the device flow, you must pass your app's client ID, which you can find on your app settings page. The `client_secret` is not needed for the device flow. | -| `incorrect_device_code` | The device_code provided is not valid. | -| `access_denied` | When a user clicks cancel during the authorization process, you'll receive a `access_denied` error and the user won't be able to use the verification code again. | +| Error code | Description | +|----|----| +| `authorization_pending`| This error occurs when the authorization request is pending and the user hasn't entered the user code yet. The app is expected to keep polling the `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token` request without exceeding the [`interval`](#response-parameters), which requires a minimum number of seconds between each request. | +| `slow_down` | When you receive the `slow_down` error, 5 extra seconds are added to the minimum `interval` or timeframe required between your requests using `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`. For example, if the starting interval required at least 5 seconds between requests and you get a `slow_down` error response, you must now wait a minimum of 10 seconds before making a new request for an OAuth access token. The error response includes the new `interval` that you must use. +| `expired_token` | If the device code expired, then you will see the `token_expired` error. You must make a new request for a device code. +| `unsupported_grant_type` | The grant type must be `urn:ietf:params:oauth:grant-type:device_code` and included as an input parameter when you poll the OAuth token request `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`. +| `incorrect_client_credentials` | For the device flow, you must pass your app's client ID, which you can find on your app settings page. The `client_secret` is not needed for the device flow. +| `incorrect_device_code` | The device_code provided is not valid. +| `access_denied` | When a user clicks cancel during the authorization process, you'll receive a `access_denied` error and the user won't be able to use the verification code again. For more information, see the "[OAuth 2.0 Device Authorization Grant](https://tools.ietf.org/html/rfc8628#section-3.5)." @@ -237,16 +237,22 @@ Non-web authentication is available for limited situations like testing. If you {% note %} -**Note:** When using the non-web application flow to create an OAuth2 token, make sure to understand how to [work with two-factor authentication](/v3/auth/#working-with-two-factor-authentication) if you or your users have two-factor authentication enabled. +**Note:** When using the non-web application flow to create an OAuth2 token, make sure to understand how to [work with +two-factor authentication](/v3/auth/#working-with-two-factor-authentication) if +you or your users have two-factor authentication enabled. {% endnote %} ### Redirect URLs -The `redirect_uri` parameter is optional. If left out, GitHub will redirect users to the callback URL configured in the OAuth Application settings. If provided, the redirect URL's host and port must exactly match the callback URL. The redirect URL's path must reference a subdirectory of the callback URL. +The `redirect_uri` parameter is optional. If left out, GitHub will +redirect users to the callback URL configured in the OAuth Application +settings. If provided, the redirect URL's host and port must exactly +match the callback URL. The redirect URL's path must reference a +subdirectory of the callback URL. CALLBACK: http://example.com/path - + GOOD: http://example.com/path GOOD: http://example.com/path/subdir/other BAD: http://example.com/bar @@ -289,7 +295,7 @@ To build this link, you'll need your OAuth Apps `client_id` that you received fr {% endtip %} -### トラブルシューティング +### Troubleshooting * "[Troubleshooting authorization request errors](/apps/managing-oauth-apps/troubleshooting-authorization-request-errors)" * "[Troubleshooting OAuth App access token request errors](/apps/managing-oauth-apps/troubleshooting-oauth-app-access-token-request-errors)" diff --git a/translations/ja-JP/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md b/translations/ja-JP/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md index 07e98e4b8e93..a917d8ba0b87 100644 --- a/translations/ja-JP/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md +++ b/translations/ja-JP/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md @@ -8,9 +8,6 @@ versions: enterprise-server: '*' --- - - - By default, a new OAuth App will have an automatically generated [identicon](https://github.com/blog/1586-identicons). An identicon badge looks something like this: ![Identicon](/assets/images/identicon.png) @@ -31,7 +28,7 @@ To create a custom badge: {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.oauth_apps %} {% data reusables.user-settings.modify_oauth_app %} -5. In "Application logo", drag-and-drop an image from a local folder or click **Upload new logo** to select an image from your computer. ![Upload a logo](/assets/images/oauth-apps/oauth_apps_upload_logo.png) +1. In "Application logo", drag-and-drop an image from a local folder or click **Upload new logo** to select an image from your computer. ![Upload a logo](/assets/images/oauth-apps/oauth_apps_upload_logo.png) 6. 画像をクロッピングします。 When you're done, click **Set new application logo**. ![Crop and set logo](/assets/images/oauth-apps/oauth_apps_crop_and_set_logo.png) 7. In "Badge background color", type the [hexadecimal color code](http://www.color-hex.com/) of the background color for your badge. {% if currentVersion == "free-pro-team@latest" %}**Note:** The "Badge background color" input field will be visible after an application logo has been uploaded.{% endif %} diff --git a/translations/ja-JP/content/developers/apps/creating-a-github-app-from-a-manifest.md b/translations/ja-JP/content/developers/apps/creating-a-github-app-from-a-manifest.md index 128336a83aee..7bce4a260080 100644 --- a/translations/ja-JP/content/developers/apps/creating-a-github-app-from-a-manifest.md +++ b/translations/ja-JP/content/developers/apps/creating-a-github-app-from-a-manifest.md @@ -71,9 +71,9 @@ The `hook_attributes` object has the following key: ##### パラメータ - | 名前 | 種類 | 説明 | - | ---- | -------- | ------------------------------------------------ | - | `状態` | `string` | {% data reusables.apps.state_description %} | + | 名前 | 種類 | 説明 | + | ---- | -------- | ------------------------------------------- | + | `状態` | `string` | {% data reusables.apps.state_description %} ##### サンプル diff --git a/translations/ja-JP/content/developers/apps/creating-a-github-app-using-url-parameters.md b/translations/ja-JP/content/developers/apps/creating-a-github-app-using-url-parameters.md index 44d7af943987..d718d3f89bdd 100644 --- a/translations/ja-JP/content/developers/apps/creating-a-github-app-using-url-parameters.md +++ b/translations/ja-JP/content/developers/apps/creating-a-github-app-using-url-parameters.md @@ -27,93 +27,93 @@ The complete list of available query parameters, permissions, and events is list ### {% data variables.product.prodname_github_app %} configuration parameters - | 名前 | 種類 | 説明 | - | -------------------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - | `name` | `string` | The name of the {% data variables.product.prodname_github_app %}. Give your app a clear and succinct name. Your app cannot have the same name as an existing GitHub user, unless it is your own user or organization name. A slugged version of your app's name will be shown in the user interface when your integration takes an action. | - | `説明` | `string` | A description of the {% data variables.product.prodname_github_app %}. | - | `url` | `string` | The full URL of your {% data variables.product.prodname_github_app %}'s website homepage. | - | `callback_url` | `string` | The full URL to redirect to after someone authorizes an installation. This URL is used if your app needs to identify and authorize user-to-server requests. | - | `request_oauth_on_install` | `boolean` | If your app authorizes users using the OAuth flow, you can set this option to `true` to allow people to authorize the app when they install it, saving a step. If you select this option, the `setup_url` becomes unavailable and users will be redirected to your `callback_url` after installing the app. | - | `setup_url` | `string` | The full URL to redirect to after someone installs the {% data variables.product.prodname_github_app %} if the app requires additional setup after installation. | - | `setup_on_update` | `boolean` | Set to `true` to redirect people to the setup URL when installations have been updated, for example, after repositories are added or removed. | - | `public` | `boolean` | Set to `true` when your {% data variables.product.prodname_github_app %} is available to the public or `false` when it is only accessible to the owner of the app. | - | `webhook_url` | `string` | The full URL that you would like to send webhook event payloads to. | - | `webhook_secret` | `string` | You can specify a secret to secure your webhooks. See "[Securing your webhooks](/webhooks/securing/)" for more details. | - | `イベント` | `array of strings` | webhook イベント. Some webhook events require `read` or `write` permissions for a resource before you can select the event when registering a new {% data variables.product.prodname_github_app %}. See the "[{% data variables.product.prodname_github_app %} webhook events](#github-app-webhook-events)" section for available events and their required permissions. You can select multiple events in a query string. For example, `events[]=public&events[]=label`. | - | `ドメイン` | `string` | The URL of a content reference. | - | `single_file_name` | `string` | When you grant `read` or `write` access to the `single_file` permission, this field provides the path to the single file your {% data variables.product.prodname_github_app %} will manage. | + Name | Type | Description +-----|------|------------- +`name` | `string` | The name of the {% data variables.product.prodname_github_app %}. Give your app a clear and succinct name. Your app cannot have the same name as an existing GitHub user, unless it is your own user or organization name. A slugged version of your app's name will be shown in the user interface when your integration takes an action. +`description` | `string` | A description of the {% data variables.product.prodname_github_app %}. +`url` | `string` | The full URL of your {% data variables.product.prodname_github_app %}'s website homepage. +`callback_url` | `string` | The full URL to redirect to after someone authorizes an installation. This URL is used if your app needs to identify and authorize user-to-server requests. +`request_oauth_on_install` | `boolean` | If your app authorizes users using the OAuth flow, you can set this option to `true` to allow people to authorize the app when they install it, saving a step. If you select this option, the `setup_url` becomes unavailable and users will be redirected to your `callback_url` after installing the app. +`setup_url` | `string` | The full URL to redirect to after someone installs the {% data variables.product.prodname_github_app %} if the app requires additional setup after installation. +`setup_on_update` | `boolean` | Set to `true` to redirect people to the setup URL when installations have been updated, for example, after repositories are added or removed. +`public` | `boolean` | Set to `true` when your {% data variables.product.prodname_github_app %} is available to the public or `false` when it is only accessible to the owner of the app. +`webhook_url` | `string` | The full URL that you would like to send webhook event payloads to. +`webhook_secret` | `string` | You can specify a secret to secure your webhooks. See "[Securing your webhooks](/webhooks/securing/)" for more details. +`events` | `array of strings` | Webhook events. Some webhook events require `read` or `write` permissions for a resource before you can select the event when registering a new {% data variables.product.prodname_github_app %}. See the "[{% data variables.product.prodname_github_app %} webhook events](#github-app-webhook-events)" section for available events and their required permissions. You can select multiple events in a query string. For example, `events[]=public&events[]=label`. +`domain` | `string` | The URL of a content reference. +`single_file_name` | `string` | When you grant `read` or `write` access to the `single_file` permission, this field provides the path to the single file your {% data variables.product.prodname_github_app %} will manage. ### {% data variables.product.prodname_github_app %} permissions You can select permissions in a query string using the permission name in the following table as the query parameter name and the permission type as the query value. For example, to select `Read & write` permissions in the user interface for `contents`, your query string would include `&contents=write`. To select `Read-only` permissions in the user interface for `blocking`, your query string would include `&blocking=read`. To select `no-access` in the user interface for `checks`, your query string would not include the `checks` permission. -| 権限 | 説明 | -| -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`管理`](/rest/reference/permissions-required-for-github-apps/#permission-on-administration) | Grants access to various endpoints for organization and repository administration. Can be one of: `none`, `read`, or `write`.{% if currentVersion == "free-pro-team@latest" %} -| [`blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-blocking) | Grants access to the [Blocking Users API](/v3/users/blocking/). Can be one of: `none`, `read`, or `write`.{% endif %} -| [`チェック`](/rest/reference/permissions-required-for-github-apps/#permission-on-checks) | Grants access to the [Checks API](/v3/checks/). Can be one of: `none`, `read`, or `write`. | -| `content_references` | Grants access to the "[Create a content attachment](/v3/apps/installations/#create-a-content-attachment)" endpoint. Can be one of: `none`, `read`, or `write`. | -| [`コンテンツ`](/rest/reference/permissions-required-for-github-apps/#permission-on-contents) | Grants access to various endpoints that allow you to modify repository contents. Can be one of: `none`, `read`, or `write`. | -| [`デプロイメント`](/rest/reference/permissions-required-for-github-apps/#permission-on-deployments) | Grants access to the [Deployments API](/v3/repos/deployments/). Can be one of: `none`, `read`, or `write`. | -| [`emails`](/rest/reference/permissions-required-for-github-apps/#permission-on-emails) | Grants access to the [Emails API](/v3/users/emails/). Can be one of: `none`, `read`, or `write`. | -| [`フォロワー`](/rest/reference/permissions-required-for-github-apps/#permission-on-followers) | Grants access to the [Followers API](/v3/users/followers/). Can be one of: `none`, `read`, or `write`. | -| [`gpg_keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-gpg-keys) | Grants access to the [GPG Keys API](/v3/users/gpg_keys/). Can be one of: `none`, `read`, or `write`. | -| [`issues`](/rest/reference/permissions-required-for-github-apps/#permission-on-issues) | Grants access to the [Issues API](/v3/issues/). Can be one of: `none`, `read`, or `write`. | -| [`キー`](/rest/reference/permissions-required-for-github-apps/#permission-on-keys) | Grants access to the [Public Keys API](/v3/users/keys/). Can be one of: `none`, `read`, or `write`. | -| [`members`](/rest/reference/permissions-required-for-github-apps/#permission-on-members) | Grants access to manage an organization's members. Can be one of: `none`, `read`, or `write`.{% if currentVersion == "free-pro-team@latest" %} -| [`メタデータ`](/rest/reference/permissions-required-for-github-apps/#metadata-permissions) | Grants access to read-only endpoints that do not leak sensitive data. Can be `read` or `none`. Defaults to `read` when you set any permission, or defaults to `none` when you don't specify any permissions for the {% data variables.product.prodname_github_app %}. | -| [`organization_administration`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-administration) | Grants access to "[Update an organization](/v3/orgs/#update-an-organization)" endpoint and the [Organization Interaction Restrictions API](/v3/interactions/orgs/#set-interaction-restrictions-for-an-organization). Can be one of: `none`, `read`, or `write`.{% endif %} -| [`organization_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-hooks) | Grants access to the [Organization Webhooks API](/v3/orgs/hooks/). Can be one of: `none`, `read`, or `write`. | -| `organization_plan` | Grants access to get information about an organization's plan using the "[Get an organization](/v3/orgs/#get-an-organization)" endpoint. Can be one of: `none` or `read`. | -| [`organization_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects) | Grants access to the [Projects API](/v3/projects/). Can be one of: `none`, `read`, `write`, or `admin`.{% if currentVersion == "free-pro-team@latest" %} -| [`organization_user_blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects) | Grants access to the [Blocking Organization Users API](/v3/orgs/blocking/). Can be one of: `none`, `read`, or `write`.{% endif %} -| [`ページ`](/rest/reference/permissions-required-for-github-apps/#permission-on-pages) | Grants access to the [Pages API](/v3/repos/pages/). Can be one of: `none`, `read`, or `write`. | -| `plan` | Grants access to get information about a user's GitHub plan using the "[Get a user](/v3/users/#get-a-user)" endpoint. Can be one of: `none` or `read`. | -| [`pull_requests`](/rest/reference/permissions-required-for-github-apps/#permission-on-pull-requests) | Grants access to various pull request endpoints. Can be one of: `none`, `read`, or `write`. | -| [`repository_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-hooks) | Grants access to the [Repository Webhooks API](/v3/repos/hooks/). Can be one of: `none`, `read`, or `write`. | -| [`repository_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-projects) | Grants access to the [Projects API](/v3/projects/). Can be one of: `none`, `read`, `write`, or `admin`. | -| [`single_file`](/rest/reference/permissions-required-for-github-apps/#permission-on-single-file) | Grants access to the [Contents API](/v3/repos/contents/). Can be one of: `none`, `read`, or `write`. | -| [`star`](/rest/reference/permissions-required-for-github-apps/#permission-on-starring) | Grants access to the [Starring API](/v3/activity/starring/). Can be one of: `none`, `read`, or `write`. | -| [`ステータス`](/rest/reference/permissions-required-for-github-apps/#permission-on-statuses) | Grants access to the [Statuses API](/v3/repos/statuses/). Can be one of: `none`, `read`, or `write`. | -| [`team_discussions`](/rest/reference/permissions-required-for-github-apps/#permission-on-team-discussions) | Grants access to the [Team Discussions API](/v3/teams/discussions/) and the [Team Discussion Comments API](/v3/teams/discussion_comments/). Can be one of: `none`, `read`, or `write`. | -| `vulnerability_alerts` | Grants access to receive security alerts for vulnerable dependencies in a repository. See "[About security alerts for vulnerable dependencies](/articles/about-security-alerts-for-vulnerable-dependencies)" to learn more. Can be one of: `none` or `read`. | -| `Watch` | Grants access to list and change repositories a user is subscribed to. Can be one of: `none`, `read`, or `write`. | +Permission | Description +---------- | ----------- +[`administration`](/rest/reference/permissions-required-for-github-apps/#permission-on-administration) | Grants access to various endpoints for organization and repository administration. Can be one of: `none`, `read`, or `write`.{% if currentVersion == "free-pro-team@latest" %} +[`blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-blocking) | Grants access to the [Blocking Users API](/v3/users/blocking/). Can be one of: `none`, `read`, or `write`.{% endif %} +[`checks`](/rest/reference/permissions-required-for-github-apps/#permission-on-checks) | Grants access to the [Checks API](/v3/checks/). Can be one of: `none`, `read`, or `write`. +`content_references` | Grants access to the "[Create a content attachment](/v3/apps/installations/#create-a-content-attachment)" endpoint. Can be one of: `none`, `read`, or `write`. +[`contents`](/rest/reference/permissions-required-for-github-apps/#permission-on-contents) | Grants access to various endpoints that allow you to modify repository contents. Can be one of: `none`, `read`, or `write`. +[`deployments`](/rest/reference/permissions-required-for-github-apps/#permission-on-deployments) | Grants access to the [Deployments API](/rest/reference/repos#deployments). Can be one of: `none`, `read`, or `write`. +[`emails`](/rest/reference/permissions-required-for-github-apps/#permission-on-emails) | Grants access to the [Emails API](/v3/users/emails/). Can be one of: `none`, `read`, or `write`. +[`followers`](/rest/reference/permissions-required-for-github-apps/#permission-on-followers) | Grants access to the [Followers API](/v3/users/followers/). Can be one of: `none`, `read`, or `write`. +[`gpg_keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-gpg-keys) | Grants access to the [GPG Keys API](/v3/users/gpg_keys/). Can be one of: `none`, `read`, or `write`. +[`issues`](/rest/reference/permissions-required-for-github-apps/#permission-on-issues) | Grants access to the [Issues API](/v3/issues/). Can be one of: `none`, `read`, or `write`. +[`keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-keys) | Grants access to the [Public Keys API](/v3/users/keys/). Can be one of: `none`, `read`, or `write`. +[`members`](/rest/reference/permissions-required-for-github-apps/#permission-on-members) | Grants access to manage an organization's members. Can be one of: `none`, `read`, or `write`.{% if currentVersion == "free-pro-team@latest" %} +[`metadata`](/rest/reference/permissions-required-for-github-apps/#metadata-permissions) | Grants access to read-only endpoints that do not leak sensitive data. Can be `read` or `none`. Defaults to `read` when you set any permission, or defaults to `none` when you don't specify any permissions for the {% data variables.product.prodname_github_app %}. +[`organization_administration`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-administration) | Grants access to "[Update an organization](/v3/orgs/#update-an-organization)" endpoint and the [Organization Interaction Restrictions API](/v3/interactions/orgs/#set-interaction-restrictions-for-an-organization). Can be one of: `none`, `read`, or `write`.{% endif %} +[`organization_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-hooks) | Grants access to the [Organization Webhooks API](/rest/reference/orgs#webhooks/). Can be one of: `none`, `read`, or `write`. +`organization_plan` | Grants access to get information about an organization's plan using the "[Get an organization](/v3/orgs/#get-an-organization)" endpoint. Can be one of: `none` or `read`. +[`organization_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects) | Grants access to the [Projects API](/v3/projects/). Can be one of: `none`, `read`, `write`, or `admin`.{% if currentVersion == "free-pro-team@latest" %} +[`organization_user_blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects) | Grants access to the [Blocking Organization Users API](/v3/orgs/blocking/). Can be one of: `none`, `read`, or `write`.{% endif %} +[`pages`](/rest/reference/permissions-required-for-github-apps/#permission-on-pages) | Grants access to the [Pages API](/rest/reference/repos#pages). Can be one of: `none`, `read`, or `write`. +`plan` | Grants access to get information about a user's GitHub plan using the "[Get a user](/v3/users/#get-a-user)" endpoint. Can be one of: `none` or `read`. +[`pull_requests`](/rest/reference/permissions-required-for-github-apps/#permission-on-pull-requests) | Grants access to various pull request endpoints. Can be one of: `none`, `read`, or `write`. +[`repository_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-hooks) | Grants access to the [Repository Webhooks API](/v3/repos/hooks/). Can be one of: `none`, `read`, or `write`. +[`repository_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-projects) | Grants access to the [Projects API](/v3/projects/). Can be one of: `none`, `read`, `write`, or `admin`. +[`single_file`](/rest/reference/permissions-required-for-github-apps/#permission-on-single-file) | Grants access to the [Contents API](/v3/repos/contents/). Can be one of: `none`, `read`, or `write`. +[`starring`](/rest/reference/permissions-required-for-github-apps/#permission-on-starring) | Grants access to the [Starring API](/v3/activity/starring/). Can be one of: `none`, `read`, or `write`. +[`statuses`](/rest/reference/permissions-required-for-github-apps/#permission-on-statuses) | Grants access to the [Statuses API](/v3/repos/statuses/). Can be one of: `none`, `read`, or `write`. +[`team_discussions`](/rest/reference/permissions-required-for-github-apps/#permission-on-team-discussions) | Grants access to the [Team Discussions API](/v3/teams/discussions/) and the [Team Discussion Comments API](/v3/teams/discussion_comments/). Can be one of: `none`, `read`, or `write`. +`vulnerability_alerts`| Grants access to receive security alerts for vulnerable dependencies in a repository. See "[About security alerts for vulnerable dependencies](/articles/about-security-alerts-for-vulnerable-dependencies)" to learn more. Can be one of: `none` or `read`. +`watching` | Grants access to list and change repositories a user is subscribed to. Can be one of: `none`, `read`, or `write`. ### {% data variables.product.prodname_github_app %} webhook events -| Webhook イベント名 | Required permission | 説明 | -| -------------------------------------------------------------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------ | -| [`check_run`](/webhooks/event-payloads/#check_run) | `チェック` | {% data reusables.webhooks.check_run_short_desc %} | -| [`check_suite`](/webhooks/event-payloads/#check_suite) | `チェック` | {% data reusables.webhooks.check_suite_short_desc %} | -| [`commit_comment`](/webhooks/event-payloads/#commit_comment) | `コンテンツ` | {% data reusables.webhooks.commit_comment_short_desc %} | -| [`content_reference`](/webhooks/event-payloads/#content_reference) | `content_references` | {% data reusables.webhooks.content_reference_short_desc %} | -| [`create`](/webhooks/event-payloads/#create) | `コンテンツ` | {% data reusables.webhooks.create_short_desc %} | -| [`delete`](/webhooks/event-payloads/#delete) | `コンテンツ` | {% data reusables.webhooks.delete_short_desc %} | -| [`deployment`](/webhooks/event-payloads/#deployment) | `デプロイメント` | {% data reusables.webhooks.deployment_short_desc %} | -| [`deployment_status`](/webhooks/event-payloads/#deployment_status) | `デプロイメント` | {% data reusables.webhooks.deployment_status_short_desc %} | -| [`フォーク`](/webhooks/event-payloads/#fork) | `コンテンツ` | {% data reusables.webhooks.fork_short_desc %} | -| [`gollum`](/webhooks/event-payloads/#gollum) | `コンテンツ` | {% data reusables.webhooks.gollum_short_desc %} | -| [`issues`](/webhooks/event-payloads/#issues) | `issues` | {% data reusables.webhooks.issues_short_desc %} | -| [`issue_comment`](/webhooks/event-payloads/#issue_comment) | `issues` | {% data reusables.webhooks.issue_comment_short_desc %} | -| [`ラベル`](/webhooks/event-payloads/#label) | `メタデータ` | {% data reusables.webhooks.label_short_desc %} | -| [`member`](/webhooks/event-payloads/#member) | `members` | {% data reusables.webhooks.member_short_desc %} | -| [`membership`](/webhooks/event-payloads/#membership) | `members` | {% data reusables.webhooks.membership_short_desc %} | -| [`マイルストーン`](/webhooks/event-payloads/#milestone) | `pull_request` | {% data reusables.webhooks.milestone_short_desc %}{% if currentVersion == "free-pro-team@latest" %} -| [`org_block`](/webhooks/event-payloads/#org_block) | `organization_administration` | {% data reusables.webhooks.org_block_short_desc %}{% endif %} -| [`Organization`](/webhooks/event-payloads/#organization) | `members` | {% data reusables.webhooks.organization_short_desc %} | -| [`page_build`](/webhooks/event-payloads/#page_build) | `ページ` | {% data reusables.webhooks.page_build_short_desc %} | -| [`project`](/webhooks/event-payloads/#project) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_short_desc %} | -| [`project_card`](/webhooks/event-payloads/#project_card) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_card_short_desc %} | -| [`project_column`](/webhooks/event-payloads/#project_column) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_column_short_desc %} | -| [`public`](/webhooks/event-payloads/#public) | `メタデータ` | {% data reusables.webhooks.public_short_desc %} | -| [`pull_request`](/webhooks/event-payloads/#pull_request) | `pull_requests` | {% data reusables.webhooks.pull_request_short_desc %} | -| [`pull_request_review`](/webhooks/event-payloads/#pull_request_review) | `pull_request` | {% data reusables.webhooks.pull_request_review_short_desc %} | -| [`pull_request_review_comment`](/webhooks/event-payloads/#pull_request_review_comment) | `pull_request` | {% data reusables.webhooks.pull_request_review_comment_short_desc %} | -| [`プッシュ`](/webhooks/event-payloads/#push) | `コンテンツ` | {% data reusables.webhooks.push_short_desc %} | -| [`リリース`](/webhooks/event-payloads/#release) | `コンテンツ` | {% data reusables.webhooks.release_short_desc %} | -| [`リポジトリ`](/webhooks/event-payloads/#repository) | `メタデータ` | {% data reusables.webhooks.repository_short_desc %}{% if currentVersion == "free-pro-team@latest"%} -| [`repository_dispatch`](/webhooks/event-payloads/#repository_dispatch) | `コンテンツ` | Allows integrators using GitHub Actions to trigger custom events.{% endif %} -| [`ステータス`](/webhooks/event-payloads/#status) | `ステータス` | {% data reusables.webhooks.status_short_desc %} | -| [`Team`](/webhooks/event-payloads/#team) | `members` | {% data reusables.webhooks.team_short_desc %} | -| [`team_add`](/webhooks/event-payloads/#team_add) | `members` | {% data reusables.webhooks.team_add_short_desc %} | -| [`Watch`](/webhooks/event-payloads/#watch) | `メタデータ` | {% data reusables.webhooks.watch_short_desc %} | +Webhook event name | Required permission | Description +------------------ | ------------------- | ----------- +[`check_run`](/webhooks/event-payloads/#check_run) |`checks` | {% data reusables.webhooks.check_run_short_desc %} +[`check_suite`](/webhooks/event-payloads/#check_suite) |`checks` | {% data reusables.webhooks.check_suite_short_desc %} +[`commit_comment`](/webhooks/event-payloads/#commit_comment) | `contents` | {% data reusables.webhooks.commit_comment_short_desc %} +[`content_reference`](/webhooks/event-payloads/#content_reference) |`content_references` | {% data reusables.webhooks.content_reference_short_desc %} +[`create`](/webhooks/event-payloads/#create) | `contents` | {% data reusables.webhooks.create_short_desc %} +[`delete`](/webhooks/event-payloads/#delete) | `contents` | {% data reusables.webhooks.delete_short_desc %} +[`deployment`](/webhooks/event-payloads/#deployment) | `deployments` | {% data reusables.webhooks.deployment_short_desc %} +[`deployment_status`](/webhooks/event-payloads/#deployment_status) | `deployments` | {% data reusables.webhooks.deployment_status_short_desc %} +[`fork`](/webhooks/event-payloads/#fork) | `contents` | {% data reusables.webhooks.fork_short_desc %} +[`gollum`](/webhooks/event-payloads/#gollum) | `contents` | {% data reusables.webhooks.gollum_short_desc %} +[`issues`](/webhooks/event-payloads/#issues) | `issues` | {% data reusables.webhooks.issues_short_desc %} +[`issue_comment`](/webhooks/event-payloads/#issue_comment) | `issues` | {% data reusables.webhooks.issue_comment_short_desc %} +[`label`](/webhooks/event-payloads/#label) | `metadata` | {% data reusables.webhooks.label_short_desc %} +[`member`](/webhooks/event-payloads/#member) | `members` | {% data reusables.webhooks.member_short_desc %} +[`membership`](/webhooks/event-payloads/#membership) | `members` | {% data reusables.webhooks.membership_short_desc %} +[`milestone`](/webhooks/event-payloads/#milestone) | `pull_request` | {% data reusables.webhooks.milestone_short_desc %}{% if currentVersion == "free-pro-team@latest" %} +[`org_block`](/webhooks/event-payloads/#org_block) | `organization_administration` | {% data reusables.webhooks.org_block_short_desc %}{% endif %} +[`organization`](/webhooks/event-payloads/#organization) | `members` | {% data reusables.webhooks.organization_short_desc %} +[`page_build`](/webhooks/event-payloads/#page_build) | `pages` | {% data reusables.webhooks.page_build_short_desc %} +[`project`](/webhooks/event-payloads/#project) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_short_desc %} +[`project_card`](/webhooks/event-payloads/#project_card) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_card_short_desc %} +[`project_column`](/webhooks/event-payloads/#project_column) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_column_short_desc %} +[`public`](/webhooks/event-payloads/#public) | `metadata` | {% data reusables.webhooks.public_short_desc %} +[`pull_request`](/webhooks/event-payloads/#pull_request) | `pull_requests` | {% data reusables.webhooks.pull_request_short_desc %} +[`pull_request_review`](/webhooks/event-payloads/#pull_request_review) | `pull_request` | {% data reusables.webhooks.pull_request_review_short_desc %} +[`pull_request_review_comment`](/webhooks/event-payloads/#pull_request_review_comment) | `pull_request` | {% data reusables.webhooks.pull_request_review_comment_short_desc %} +[`push`](/webhooks/event-payloads/#push) | `contents` | {% data reusables.webhooks.push_short_desc %} +[`release`](/webhooks/event-payloads/#release) | `contents` | {% data reusables.webhooks.release_short_desc %} +[`repository`](/webhooks/event-payloads/#repository) |`metadata` | {% data reusables.webhooks.repository_short_desc %}{% if currentVersion == "free-pro-team@latest"%} +[`repository_dispatch`](/webhooks/event-payloads/#repository_dispatch) | `contents` | Allows integrators using GitHub Actions to trigger custom events.{% endif %} +[`status`](/webhooks/event-payloads/#status) | `statuses` | {% data reusables.webhooks.status_short_desc %} +[`team`](/webhooks/event-payloads/#team) | `members` | {% data reusables.webhooks.team_short_desc %} +[`team_add`](/webhooks/event-payloads/#team_add) | `members` | {% data reusables.webhooks.team_add_short_desc %} +[`watch`](/webhooks/event-payloads/#watch) | `metadata` | {% data reusables.webhooks.watch_short_desc %} diff --git a/translations/ja-JP/content/developers/apps/creating-ci-tests-with-the-checks-api.md b/translations/ja-JP/content/developers/apps/creating-ci-tests-with-the-checks-api.md index 70eab465d50c..3e5539132af9 100644 --- a/translations/ja-JP/content/developers/apps/creating-ci-tests-with-the-checks-api.md +++ b/translations/ja-JP/content/developers/apps/creating-ci-tests-with-the-checks-api.md @@ -9,7 +9,6 @@ versions: --- - ### はじめに This guide will introduce you to [Github Apps](/apps/) and the [Checks API](/v3/checks/), which you'll use to build a continuous integration (CI) server that runs tests. @@ -134,6 +133,26 @@ The `requested` action requests a check run each time code is pushed to the repo You'll add this new method as a [Sinatra helper](https://github.com/sinatra/sinatra#helpers) in case you want other routes to use it too. Under `helpers do`, add this `create_check_run` method: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +``` ruby +# Create a new check run with the status queued +def create_check_run + # # At the time of writing, Octokit does not support the Checks API yet, but + # it does provide generic HTTP methods you can use: + # /v3/checks/runs/#create-a-check-run + check_run = @installation_client.post( + "repos/#{@payload['repository']['full_name']}/check-runs", + { + accept: 'application/vnd.github.v3+json', + # The name of your check run. + name: 'Octo RuboCop', + # The payload structure differs depending on whether a check run or a check suite event occurred. + head_sha: @payload['check_run'].nil? ? @payload['check_suite']['head_sha'] : @payload['check_run']['head_sha'] + } + ) +end +``` +{% else %} ``` ruby # Create a new check run with the status queued def create_check_run @@ -153,6 +172,7 @@ def create_check_run ) end ``` +{% endif %} This code calls the "[Create a check run](/v3/checks/runs/#create-a-check-run)" endpoint using the generic [HTTP `POST` method](http://octokit.github.io/octokit.rb/Octokit/Connection.html#post-instance_method). This method takes two parameters: the URL of the endpoint and the input parameters to the method. @@ -180,7 +200,7 @@ If you see other apps in the Checks tab, it means you have other apps installed これでうまくいきました。 You've told GitHub to create a check run. You can see the check run status is set to `queued` next to a yellow icon. Next, you'll want to wait for GitHub to create the check run and update its status. -### Step 1.4. Updating a check run +### ステップ 1.4. Updating a check run When your `create_check_run` method runs, it asks GitHub to create a new check run. When Github finishes creating the check run, you'll receive the `check_run` webhook event with the `created` action. That event is your signal to begin running the check. @@ -209,6 +229,43 @@ In this section, you're not going to kick off the CI test yet, but you'll walk t Let's create the `initiate_check_run` method and update the status of the check run. Add the following code to the helpers section: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +``` ruby +# Start the CI process +def initiate_check_run + # Once the check run is created, you'll update the status of the check run + # to 'in_progress' and run the CI process. When the CI finishes, you'll + # update the check run status to 'completed' and add the CI results. + + # Octokit doesn't yet support the Checks API, but it does provide generic + # HTTP methods you can use: + # /v3/checks/runs/#update-a-check-run + updated_check_run = @installation_client.patch( + "repos/#{@payload['repository']['full_name']}/check-runs/#{@payload['check_run']['id']}", + { + accept: 'application/vnd.github.v3+json', + name: 'Octo RuboCop', + status: 'in_progress', + started_at: Time.now.utc.iso8601 + } + ) + + # ***** RUN A CI TEST ***** + + # Mark the check run as complete! + updated_check_run = @installation_client.patch( + "repos/#{@payload['repository']['full_name']}/check-runs/#{@payload['check_run']['id']}", + { + accept: 'application/vnd.github.v3+json', + name: 'Octo RuboCop', + status: 'completed', + conclusion: 'success', + completed_at: Time.now.utc.iso8601 + } + ) +end +``` +{% else %} ``` ruby # Start the CI process def initiate_check_run @@ -245,6 +302,7 @@ def initiate_check_run ) end ``` +{% endif %} The code above calls the "[Update a check run](/v3/checks/runs/#update-a-check-run)" API endpoint using the generic [`patch` HTTP method](http://octokit.github.io/octokit.rb/Octokit/Connection.html#patch-instance_method) to update the check run that you already created. @@ -549,6 +607,21 @@ text = "Octo RuboCop version: #{@output['metadata']['rubocop_version']}" Now you've got all the information you need to update your check run. In the [first half of this quickstart](#step-14-updating-a-check-run), you added this code to set the status of the check run to `success`: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +``` ruby +# Mark the check run as complete! +updated_check_run = @installation_client.patch( + "repos/#{@payload['repository']['full_name']}/check-runs/#{@payload['check_run']['id']}", + { + accept: 'application/vnd.github.v3+json', + name: 'Octo RuboCop', + status: 'completed', + conclusion: 'success', + completed_at: Time.now.utc.iso8601 + } +) +``` +{% else %} ``` ruby # Mark the check run as complete! updated_check_run = @installation_client.patch( @@ -562,9 +635,36 @@ updated_check_run = @installation_client.patch( } ) ``` +{% endif %} You'll need to update that code to use the `conclusion` variable you set based on the RuboCop results (to `success` or `neutral`). You can update the code with the following: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +``` ruby +# Mark the check run as complete! And if there are warnings, share them. +updated_check_run = @installation_client.patch( + "repos/#{@payload['repository']['full_name']}/check-runs/#{@payload['check_run']['id']}", + { + accept: 'application/vnd.github.v3+json', + name: 'Octo RuboCop', + status: 'completed', + conclusion: conclusion, + completed_at: Time.now.utc.iso8601, + output: { + title: 'Octo RuboCop', + summary: summary, + text: text, + annotations: annotations + }, + actions: [{ + label: 'Fix this', + description: 'Automatically fix all linter notices.', + identifier: 'fix_rubocop_notices' + }] + } +) +``` +{% else %} ``` ruby # Mark the check run as complete! And if there are warnings, share them. updated_check_run = @installation_client.patch( @@ -589,6 +689,7 @@ updated_check_run = @installation_client.patch( } ) ``` +{% endif %} Now that you're setting a conclusion based on the status of the CI test and you've added the output from the RuboCop results, you've created a CI test! Congratulations. 🙌 diff --git a/translations/ja-JP/content/developers/apps/differences-between-github-apps-and-oauth-apps.md b/translations/ja-JP/content/developers/apps/differences-between-github-apps-and-oauth-apps.md index 975bfb6c6051..3c74761c87f5 100644 --- a/translations/ja-JP/content/developers/apps/differences-between-github-apps-and-oauth-apps.md +++ b/translations/ja-JP/content/developers/apps/differences-between-github-apps-and-oauth-apps.md @@ -50,13 +50,13 @@ An _authorized_ OAuth App has access to all of the user's or organization owner' {% endnote %} -| GitHub Apps | OAuth Apps | -| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| A GitHub App can request an installation access token by using a private key with a JSON web token format out-of-band. | An OAuth app can exchange a request token for an access token after a redirect via a web request. | -| An installation token identifies the app as the GitHub Apps bot, such as @jenkins-bot. | An access token identifies the app as the user who granted the token to the app, such as @octocat. | -| Installation tokens expire after a predefined amount of time (currently 1 hour). | OAuth tokens remain active until they're revoked by the customer. | -| {% data reusables.apps.api-rate-limits-non-ghec %}{% if currentVersion == "free-pro-team@latest" %} Higher rate limits apply for {% data variables.product.prodname_ghe_cloud %}. For more information, see "[Rate limits for GitHub Apps](/developers/apps/rate-limits-for-github-apps)."{% endif %} | OAuth tokens use the user's rate limit of 5,000 requests per hour. | -| Rate limit increases can be granted both at the GitHub Apps level (affecting all installations) and at the individual installation level. | Rate limit increases are granted per OAuth App. Every token granted to that OAuth App gets the increased limit. |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} +| GitHub Apps | OAuth Apps | +| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| A GitHub App can request an installation access token by using a private key with a JSON web token format out-of-band. | An OAuth app can exchange a request token for an access token after a redirect via a web request. | +| An installation token identifies the app as the GitHub Apps bot, such as @jenkins-bot. | An access token identifies the app as the user who granted the token to the app, such as @octocat. | +| Installation tokens expire after a predefined amount of time (currently 1 hour). | OAuth tokens remain active until they're revoked by the customer. | +| {% data reusables.apps.api-rate-limits-non-ghec %}{% if currentVersion == "free-pro-team@latest" %} Higher rate limits apply for {% data variables.product.prodname_ghe_cloud %}. For more information, see "[Rate limits for GitHub Apps](/developers/apps/rate-limits-for-github-apps)."{% endif %} | OAuth tokens use the user's rate limit of 5,000 requests per hour. | +| Rate limit increases can be granted both at the GitHub Apps level (affecting all installations) and at the individual installation level. | Rate limit increases are granted per OAuth App. Every token granted to that OAuth App gets the increased limit. |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} | {% data variables.product.prodname_github_app %}s can authenticate on behalf of the user, which is called user-to-server requests. The flow to authorize is the same as the OAuth App authorization flow. User-to-server tokens can expire and be renewed with a refresh token. For more information, see "[Refreshing user-to-server access tokens](/apps/building-github-apps/refreshing-user-to-server-access-tokens/)" and "[Identifying and authorizing users for GitHub Apps](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/)." | The OAuth flow used by {% data variables.product.prodname_oauth_app %}s authorizes an {% data variables.product.prodname_oauth_app %} on behalf of the user. This is the same flow used in {% data variables.product.prodname_github_app %} user-to-server authorization. |{% endif %} ### Requesting permission levels for resources @@ -102,5 +102,5 @@ Bot accounts are specific to GitHub Apps and are built into every GitHub App. | GitHub Apps | OAuth Apps | | --------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | -| GitHub App bots do not consume a {% data variables.product.prodname_enterprise %} seat. | A machine user account consumes a {% data variables.product.prodname_enterprise %} seat. | +| GitHub App bots do not consume a {% data variables.product.prodname_enterprise %} seat. | A machine user account consumes a {% data variables.product.prodname_enterprise %} seat. | | Because a GitHub App bot is never granted a password, a customer can't sign into it directly. | A machine user account is granted a username and password to be managed and secured by the customer. | diff --git a/translations/ja-JP/content/developers/apps/editing-a-github-apps-permissions.md b/translations/ja-JP/content/developers/apps/editing-a-github-apps-permissions.md index 81fff7a88b35..75bc2209dcf5 100644 --- a/translations/ja-JP/content/developers/apps/editing-a-github-apps-permissions.md +++ b/translations/ja-JP/content/developers/apps/editing-a-github-apps-permissions.md @@ -18,15 +18,9 @@ versions: {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.github_apps %} -4. Select the GitHub App whose permissions you want to change. -![App selection](/assets/images/github-apps/github_apps_select-app.png) -5. In the left sidebar, click **Permissions & webhooks**. -![Permissions and webhooks](/assets/images/github-apps/github_apps_permissions_and_webhooks.png) -6. Modify the permissions you'd like to change. For each type of permission, select either "Read-only", "Read & write", or "No access" from the dropdown. -![Permissions selections for your GitHub App](/assets/images/github-apps/github_apps_permissions_post2dot13.png) -7. In "Subscribe to events", select any events to which you'd like to subscribe your app. -![Permissions selections for subscribing your GitHub App to events](/assets/images/github-apps/github_apps_permissions_subscribe_to_events.png) -8. Optionally, in "Add a note to users", add a note telling your users why you are changing the permissions that your GitHub App requests. -![Input box to add a note to users explaining why your GitHub App permissions have changed](/assets/images/github-apps/github_apps_permissions_note_to_users.png) -9. Click **Save changes**. -![Button to save permissions changes](/assets/images/github-apps/github_apps_save_changes.png) +4. Select the GitHub App whose permissions you want to change. ![App selection](/assets/images/github-apps/github_apps_select-app.png) +5. 左サイドバーで、[**Permissions & webhooks**] をクリックします。 ![Permissions and webhooks](/assets/images/github-apps/github_apps_permissions_and_webhooks.png) +6. Modify the permissions you'd like to change. For each type of permission, select either "Read-only", "Read & write", or "No access" from the dropdown. ![Permissions selections for your GitHub App](/assets/images/github-apps/github_apps_permissions_post2dot13.png) +7. In "Subscribe to events", select any events to which you'd like to subscribe your app. ![Permissions selections for subscribing your GitHub App to events](/assets/images/github-apps/github_apps_permissions_subscribe_to_events.png) +8. Optionally, in "Add a note to users", add a note telling your users why you are changing the permissions that your GitHub App requests. ![Input box to add a note to users explaining why your GitHub App permissions have changed](/assets/images/github-apps/github_apps_permissions_note_to_users.png) +9. [**Save changes**] をクリックします。 ![Button to save permissions changes](/assets/images/github-apps/github_apps_save_changes.png) diff --git a/translations/ja-JP/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md b/translations/ja-JP/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md index 1d670d5dda73..95d7ec2ffca2 100644 --- a/translations/ja-JP/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md +++ b/translations/ja-JP/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md @@ -25,7 +25,7 @@ To authorize users for standard apps that run in the browser, use the [web appli To authorize users for headless apps without direct access to the browser, such as CLI tools or Git credential managers, use the [device flow](#device-flow). The device flow uses the OAuth 2.0 [Device Authorization Grant](https://tools.ietf.org/html/rfc8628). {% endif %} -### Web アプリケーションフロー +### Web application flow Using the web application flow, the process to identify users on your site is: @@ -41,14 +41,14 @@ If you select **Request user authorization (OAuth) during installation** when cr When your GitHub App specifies a `login` parameter, it prompts users with a specific account they can use for signing in and authorizing your app. -##### パラメータ +##### Parameters -| 名前 | 種類 | 説明 | -| -------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `client_id` | `string` | **Required.** The client ID for your GitHub App. You can find this in your [GitHub App settings](https://github.com/settings/apps) when you select your app. | -| `redirect_uri` | `string` | The URL in your application where users will be sent after authorization. This must be an exact match to the URL you provided in the **User authorization callback URL** field when setting up your GitHub App and can't contain any additional parameters. | -| `状態` | `string` | This should contain a random string to protect against forgery attacks and could contain any other arbitrary data. | -| `login` | `string` | Suggests a specific account to use for signing in and authorizing the app. | +Name | Type | Description +-----|------|------------ +`client_id` | `string` | **Required.** The client ID for your GitHub App. You can find this in your [GitHub App settings](https://github.com/settings/apps) when you select your app. +`redirect_uri` | `string` | The URL in your application where users will be sent after authorization. This must be an exact match to the URL you provided in the **User authorization callback URL** field when setting up your GitHub App and can't contain any additional parameters. +`state` | `string` | This should contain a random string to protect against forgery attacks and could contain any other arbitrary data. +`login` | `string` | Suggests a specific account to use for signing in and authorizing the app. {% note %} @@ -72,17 +72,17 @@ Expiring user tokens are currently part of the user-to-server token expiration b POST {% data variables.product.oauth_host_code %}/login/oauth/access_token -##### パラメータ +##### Parameters -| 名前 | 種類 | 説明 | -| --------------- | -------- | --------------------------------------------------------------------- | -| `client_id` | `string` | **Required.** The client ID for your GitHub App. | -| `client_secret` | `string` | **Required.** The client secret for your GitHub App. | -| `コード` | `string` | **Required.** The code you received as a response to Step 1. | -| `redirect_uri` | `string` | The URL in your application where users are sent after authorization. | -| `状態` | `string` | The unguessable random string you provided in Step 1. | +Name | Type | Description +-----|------|------------ +`client_id` | `string` | **Required.** The client ID for your GitHub App. +`client_secret` | `string` | **Required.** The client secret for your GitHub App. +`code` | `string` | **Required.** The code you received as a response to Step 1. +`redirect_uri` | `string` | The URL in your application where users are sent after authorization. +`state` | `string` | The unguessable random string you provided in Step 1. -##### レスポンス +##### Response {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} @@ -208,7 +208,7 @@ While most of your API interaction should occur using your server-to-server inst {% endif %} {% if currentVersion == "free-pro-team@latest" %} -##### 成果物 +##### Artifacts * [List artifacts for a repository](/v3/actions/artifacts/#list-artifacts-for-a-repository) * [List workflow run artifacts](/v3/actions/artifacts/#list-workflow-run-artifacts) @@ -217,7 +217,7 @@ While most of your API interaction should occur using your server-to-server inst * [Download an artifact](/v3/actions/artifacts/#download-an-artifact) {% endif %} -##### チェックラン +##### Check Runs * [Create a check run](/v3/checks/runs/#create-a-check-run) * [Get a check run](/v3/checks/runs/#get-a-check-run) @@ -226,7 +226,7 @@ While most of your API interaction should occur using your server-to-server inst * [List check runs in a check suite](/v3/checks/runs/#list-check-runs-in-a-check-suite) * [List check runs for a Git reference](/v3/checks/runs/#list-check-runs-for-a-git-reference) -##### チェックスイート +##### Check Suites * [Create a check suite](/v3/checks/suites/#create-a-check-suite) * [Get a check suite](/v3/checks/suites/#get-a-check-suite) @@ -241,25 +241,25 @@ While most of your API interaction should occur using your server-to-server inst ##### Deployment Statuses -* [List deployment statuses](/v3/repos/deployments/#list-deployment-statuses) -* [Create a deployment status](/v3/repos/deployments/#create-a-deployment-status) -* [Get a deployment status](/v3/repos/deployments/#get-a-deployment-status) +* [List deployment statuses](/rest/reference/repos#list-deployment-statuses) +* [Create a deployment status](/rest/reference/repos#create-a-deployment-status) +* [Get a deployment status](/rest/reference/repos#get-a-deployment-status) -##### デプロイメント +##### Deployments -* [List deployments](/v3/repos/deployments/#list-deployments) -* [Create a deployment](/v3/repos/deployments/#create-a-deployment) -* [Get a deployment](/v3/repos/deployments/#get-a-deployment){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -* [Delete a deployment](/v3/repos/deployments/#delete-a-deployment){% endif %} +* [List deployments](/rest/reference/repos#list-deployments) +* [Create a deployment](/rest/reference/repos#create-a-deployment) +* [Get a deployment](/rest/reference/repos#get-a-deployment){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +* [Delete a deployment](/rest/reference/repos#delete-a-deployment){% endif %} -##### イベント +##### Events -* [List public events for a network of repositories](/v3/activity/events/#list-public-events-for-a-network-of-repositories) -* [List public organization events](/v3/activity/events/#list-public-organization-events) +* [List public events for a network of repositories](/rest/reference/activity#list-public-events-for-a-network-of-repositories) +* [List public organization events](/rest/reference/activity#list-public-organization-events) -##### フィード +##### Feeds -* [Get feeds](/v3/activity/feeds/#get-feeds) +* [Get feeds](/rest/reference/activity#get-feeds) ##### Git Blobs @@ -273,11 +273,8 @@ While most of your API interaction should occur using your server-to-server inst ##### Git Refs -* [Create a reference](/v3/git/refs/#create-a-reference){% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -* [List references](/v3/git/refs/#list-references) -* [Get a reference](/v3/git/refs/#get-a-reference){% else %} -* [Get a reference](/v3/git/refs/#get-a-reference) -* [List matching references](/v3/git/refs/#list-matching-references){% endif %} +* [Create a reference](/v3/git/refs/#create-a-reference)* [Get a reference](/v3/git/refs/#get-a-reference) +* [List matching references](/v3/git/refs/#list-matching-references) * [Update a reference](/v3/git/refs/#update-a-reference) * [Delete a reference](/v3/git/refs/#delete-a-reference) @@ -333,13 +330,13 @@ While most of your API interaction should occur using your server-to-server inst * [List timeline events for an issue](/v3/issues/timeline/#list-timeline-events-for-an-issue) -##### 問題 +##### Issues * [List issues assigned to the authenticated user](/v3/issues/#list-issues-assigned-to-the-authenticated-user) * [List assignees](/v3/issues/assignees/#list-assignees) * [Check if a user can be assigned](/v3/issues/assignees/#check-if-a-user-can-be-assigned) * [List repository issues](/v3/issues/#list-repository-issues) -* [Issue を作成します](/v3/issues/#create-an-issue) +* [Create an issue](/v3/issues/#create-an-issue) * [Get an issue](/v3/issues/#get-an-issue) * [Update an issue](/v3/issues/#update-an-issue) * [Lock an issue](/v3/issues/#lock-an-issue) @@ -353,7 +350,7 @@ While most of your API interaction should occur using your server-to-server inst * [List jobs for a workflow run](/v3/actions/workflow-jobs/#list-jobs-for-a-workflow-run) {% endif %} -##### ラベル +##### Labels * [List labels for an issue](/v3/issues/labels/#list-labels-for-an-issue) * [Add labels to an issue](/v3/issues/labels/#add-labels-to-an-issue) @@ -367,7 +364,7 @@ While most of your API interaction should occur using your server-to-server inst * [Delete a label](/v3/issues/labels/#delete-a-label) * [Get labels for every issue in a milestone](/v3/issues/labels/#list-labels-for-issues-in-a-milestone) -##### ライセンス +##### Licenses * [Get all commonly used licenses](/v3/licenses/#get-all-commonly-used-licenses) * [Get a license](/v3/licenses/#get-a-license) @@ -377,11 +374,11 @@ While most of your API interaction should occur using your server-to-server inst * [Render a Markdown document](/v3/markdown/#render-a-markdown-document) * [Render a markdown document in raw mode](/v3/markdown/#render-a-markdown-document-in-raw-mode) -##### メタ情報 +##### Meta -* [メタ情報](/v3/meta/#meta) +* [Meta](/v3/meta/#meta) -##### マイルストーン +##### Milestones * [List milestones](/v3/issues/milestones/#list-milestones) * [Create a milestone](/v3/issues/milestones/#create-a-milestone) @@ -391,12 +388,12 @@ While most of your API interaction should occur using your server-to-server inst ##### Organization Hooks -* [List organization webhooks](/v3/orgs/hooks/#list-organization-webhooks) -* [Create an organization webhook](/v3/orgs/hooks/#create-an-organization-webhook) -* [Get an organization webhook](/v3/orgs/hooks/#get-an-organization-webhook) -* [Update an organization webhook](/v3/orgs/hooks/#update-an-organization-webhook) -* [Delete an organization webhook](/v3/orgs/hooks/#delete-an-organization-webhook) -* [Ping an organization webhook](/v3/orgs/hooks/#ping-an-organization-webhook) +* [List organization webhooks](/rest/reference/orgs#webhooks/#list-organization-webhooks) +* [Create an organization webhook](/rest/reference/orgs#webhooks/#create-an-organization-webhook) +* [Get an organization webhook](/rest/reference/orgs#webhooks/#get-an-organization-webhook) +* [Update an organization webhook](/rest/reference/orgs#webhooks/#update-an-organization-webhook) +* [Delete an organization webhook](/rest/reference/orgs#webhooks/#delete-an-organization-webhook) +* [Ping an organization webhook](/rest/reference/orgs#webhooks/#ping-an-organization-webhook) {% if currentVersion == "free-pro-team@latest" %} ##### Organization Invitations @@ -445,7 +442,7 @@ While most of your API interaction should occur using your server-to-server inst ##### Organization Team Repositories -* [Team リポジトリの一覧表示](/v3/teams/#list-team-repositories) +* [List team repositories](/v3/teams/#list-team-repositories) * [Check team permissions for a repository](/v3/teams/#check-team-permissions-for-a-repository) * [Add or update team repository permissions](/v3/teams/#add-or-update-team-repository-permissions) * [Remove a repository from a team](/v3/teams/#remove-a-repository-from-a-team) @@ -478,7 +475,7 @@ While most of your API interaction should occur using your server-to-server inst * [List child teams](/v3/teams/#list-child-teams) * [List teams for the authenticated user](/v3/teams/#list-teams-for-the-authenticated-user) -##### Organization +##### Organizations * [List organizations](/v3/orgs/#list-organizations) * [Get an organization](/v3/orgs/#get-an-organization) @@ -527,7 +524,7 @@ While most of your API interaction should occur using your server-to-server inst * [Remove project collaborator](/v3/projects/collaborators/#remove-project-collaborator) * [Get project permission for a user](/v3/projects/collaborators/#get-project-permission-for-a-user) -##### プロジェクト +##### Projects * [List organization projects](/v3/projects/#list-organization-projects) * [Create an organization project](/v3/projects/#create-an-organization-project) @@ -588,7 +585,7 @@ While most of your API interaction should occur using your server-to-server inst * [Check if a pull request has been merged](/v3/pulls/#check-if-a-pull-request-has-been-merged) * [Merge a pull request (Merge Button)](/v3/pulls/#merge-a-pull-request) -##### リアクション +##### Reactions {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}* [Delete a reaction](/v3/reactions/#delete-a-reaction-legacy){% else %}* [Delete a reaction](/v3/reactions/#delete-a-reaction){% endif %} * [List reactions for a commit comment](/v3/reactions/#list-reactions-for-a-commit-comment) @@ -610,16 +607,16 @@ While most of your API interaction should occur using your server-to-server inst * [Delete team discussion reaction](/v3/reactions/#delete-team-discussion-reaction) * [Delete team discussion comment reaction](/v3/reactions/#delete-team-discussion-comment-reaction){% endif %} -##### リポジトリ +##### Repositories -* [Organization リポジトリの一覧表示](/v3/repos/#list-organization-repositories) +* [List organization repositories](/v3/repos/#list-organization-repositories) * [Create a repository for the authenticated user](/v3/repos/#create-a-repository-for-the-authenticated-user) -* [リポジトリの Get](/v3/repos/#get-a-repository) +* [Get a repository](/v3/repos/#get-a-repository) * [Update a repository](/v3/repos/#update-a-repository) * [Delete a repository](/v3/repos/#delete-a-repository) * [Compare two commits](/v3/repos/commits/#compare-two-commits) * [List repository contributors](/v3/repos/#list-repository-contributors) -* [一覧表示のフォーク](/v3/repos/forks/#list-forks) +* [List forks](/rest/reference/repos#list-forks) * [Create a fork](/v3/repos/forks/#create-a-fork) * [List repository languages](/v3/repos/#list-repository-languages) * [List repository tags](/v3/repos/#list-repository-tags) @@ -627,18 +624,18 @@ While most of your API interaction should occur using your server-to-server inst * [Transfer a repository](/v3/repos/#transfer-a-repository) * [List public repositories](/v3/repos/#list-public-repositories) * [List repositories for the authenticated user](/v3/repos/#list-repositories-for-the-authenticated-user) -* [ユーザのリポジトリの一覧表示](/v3/repos/#list-repositories-for-a-user) +* [List repositories for a user](/v3/repos/#list-repositories-for-a-user) * [Create repository using a repository template](/v3/repos/#create-repository-using-a-repository-template) ##### Repository Activity -* [List stargazers](/v3/activity/starring/#list-stargazers) -* [List watchers](/v3/activity/watching/#list-watchers) -* [List repositories starred by a user](/v3/activity/starring/#list-repositories-starred-by-a-user) -* [Check if a repository is starred by the authenticated user](/v3/activity/starring/#check-if-a-repository-is-starred-by-the-authenticated-user) -* [Star a repository for the authenticated user](/v3/activity/starring/#star-a-repository-for-the-authenticated-user) -* [Unstar a repository for the authenticated user](/v3/activity/starring/#unstar-a-repository-for-the-authenticated-user) -* [ユーザが Watch しているリポジトリの一覧表示](/v3/activity/watching/#list-repositories-watched-by-a-user) +* [List stargazers](/rest/reference/activity#list-stargazers) +* [List watchers](/rest/reference/activity#list-watchers) +* [List repositories starred by a user](/rest/reference/activity#list-repositories-starred-by-a-user) +* [Check if a repository is starred by the authenticated user](/rest/reference/activity#check-if-a-repository-is-starred-by-the-authenticated-user) +* [Star a repository for the authenticated user](/rest/reference/activity#star-a-repository-for-the-authenticated-user) +* [Unstar a repository for the authenticated user](/rest/reference/activity#unstar-a-repository-for-the-authenticated-user) +* [List repositories watched by a user](/rest/reference/activity#list-repositories-watched-by-a-user) {% if currentVersion == "free-pro-team@latest" %} ##### Repository Automated Security Fixes @@ -756,14 +753,14 @@ While most of your API interaction should occur using your server-to-server inst ##### Repository Pages -* [Get a GitHub Pages site](/v3/repos/pages/#get-a-github-pages-site) -* [Create a GitHub Pages site](/v3/repos/pages/#create-a-github-pages-site) -* [Update information about a GitHub Pages site](/v3/repos/pages/#update-information-about-a-github-pages-site) -* [Delete a GitHub Pages site](/v3/repos/pages/#delete-a-github-pages-site) -* [List GitHub Pages builds](/v3/repos/pages/#list-github-pages-builds) -* [Request a GitHub Pages build](/v3/repos/pages/#request-a-github-pages-build) -* [Get GitHub Pages build](/v3/repos/pages/#get-github-pages-build) -* [Get latest pages build](/v3/repos/pages/#get-latest-pages-build) +* [Get a GitHub Pages site](/rest/reference/repos#get-a-github-pages-site) +* [Create a GitHub Pages site](/rest/reference/repos#create-a-github-pages-site) +* [Update information about a GitHub Pages site](/rest/reference/repos#update-information-about-a-github-pages-site) +* [Delete a GitHub Pages site](/rest/reference/repos#delete-a-github-pages-site) +* [List GitHub Pages builds](/rest/reference/repos#list-github-pages-builds) +* [Request a GitHub Pages build](/rest/reference/repos#request-a-github-pages-build) +* [Get GitHub Pages build](/rest/reference/repos#get-github-pages-build) +* [Get latest pages build](/rest/reference/repos#get-latest-pages-build) {% if currentVersion != "free-pro-team@latest" %} ##### Repository Pre Receive Hooks @@ -776,17 +773,17 @@ While most of your API interaction should occur using your server-to-server inst ##### Repository Releases -* [リリースの一覧表示](/v3/repos/releases/#list-releases) -* [Create a release](/v3/repos/releases/#create-a-release) -* [Get a release](/v3/repos/releases/#get-a-release) -* [リリースの更新](/v3/repos/releases/#update-a-release) -* [Delete a release](/v3/repos/releases/#delete-a-release) -* [List release assets](/v3/repos/releases/#list-release-assets) -* [Get a release asset](/v3/repos/releases/#get-a-release-asset) -* [Update a release asset](/v3/repos/releases/#update-a-release-asset) -* [Delete a release asset](/v3/repos/releases/#delete-a-release-asset) -* [Get the latest release](/v3/repos/releases/#get-the-latest-release) -* [Get a release by tag name](/v3/repos/releases/#get-a-release-by-tag-name) +* [List releases](/rest/reference/repos/#list-releases) +* [Create a release](/rest/reference/repos/#create-a-release) +* [Get a release](/rest/reference/repos/#get-a-release) +* [Update a release](/rest/reference/repos/#update-a-release) +* [Delete a release](/rest/reference/repos/#delete-a-release) +* [List release assets](/rest/reference/repos/#list-release-assets) +* [Get a release asset](/rest/reference/repos/#get-a-release-asset) +* [Update a release asset](/rest/reference/repos/#update-a-release-asset) +* [Delete a release asset](/rest/reference/repos/#delete-a-release-asset) +* [Get the latest release](/rest/reference/repos/#get-the-latest-release) +* [Get a release by tag name](/rest/reference/repos/#get-a-release-by-tag-name) ##### Repository Stats @@ -797,28 +794,28 @@ While most of your API interaction should occur using your server-to-server inst * [Get the hourly commit count for each day](/v3/repos/statistics/#get-the-hourly-commit-count-for-each-day) {% if currentVersion == "free-pro-team@latest" %} -##### リポジトリ脆弱性アラート +##### Repository Vulnerability Alerts * [Enable vulnerability alerts](/v3/repos/#enable-vulnerability-alerts) * [Disable vulnerability alerts](/v3/repos/#disable-vulnerability-alerts) {% endif %} -##### ルート +##### Root -* [ルートエンドポイント](/v3/#root-endpoint) -* [絵文字](/v3/emojis/#emojis) +* [Root endpoint](/v3/#root-endpoint) +* [Emojis](/v3/emojis/#emojis) * [Get rate limit status for the authenticated user](/v3/rate_limit/#get-rate-limit-status-for-the-authenticated-user) -##### 検索 +##### Search * [Search code](/v3/search/#search-code) * [Search commits](/v3/search/#search-commits) * [Search labels](/v3/search/#search-labels) -* [リポジトリを検索](/v3/search/#search-repositories) +* [Search repositories](/v3/search/#search-repositories) * [Search topics](/v3/search/#search-topics) * [Search users](/v3/search/#search-users) -##### ステータス +##### Statuses * [Get the combined status for a specific reference](/v3/repos/statuses/#get-the-combined-status-for-a-specific-reference) * [List commit statuses for a reference](/v3/repos/statuses/#list-commit-statuses-for-a-reference) @@ -843,7 +840,7 @@ While most of your API interaction should occur using your server-to-server inst * [Replace all repository topics](/v3/repos/#replace-all-repository-topics) {% if currentVersion == "free-pro-team@latest" %} -##### トラフィック +##### Traffic * [Get repository clones](/v3/repos/traffic/#get-repository-clones) * [Get top referral paths](/v3/repos/traffic/#get-top-referral-paths) @@ -899,7 +896,7 @@ While most of your API interaction should occur using your server-to-server inst * [Delete a public SSH key for the authenticated user](/v3/users/keys/#delete-a-public-ssh-key-for-the-authenticated-user) * [List public keys for a user](/v3/users/keys/#list-public-keys-for-a-user) -##### ユーザ +##### Users * [Get the authenticated user](/v3/users/#get-the-authenticated-user) * [List app installations accessible to the user access token](/v3/apps/installations/#list-app-installations-accessible-to-the-user-access-token) @@ -923,7 +920,7 @@ While most of your API interaction should occur using your server-to-server inst {% endif %} {% if currentVersion == "free-pro-team@latest" %} -##### ワークフロー +##### Workflows * [List repository workflows](/v3/actions/workflows/#list-repository-workflows) * [Get a workflow](/v3/actions/workflows/#get-a-workflow) diff --git a/translations/ja-JP/content/developers/apps/migrating-oauth-apps-to-github-apps.md b/translations/ja-JP/content/developers/apps/migrating-oauth-apps-to-github-apps.md index 806bb29a1bfb..9c12b8efdc78 100644 --- a/translations/ja-JP/content/developers/apps/migrating-oauth-apps-to-github-apps.md +++ b/translations/ja-JP/content/developers/apps/migrating-oauth-apps-to-github-apps.md @@ -11,7 +11,6 @@ versions: This article provides guidelines for existing integrators who are considering migrating from an OAuth App to a GitHub App. - ### Reasons for switching to GitHub Apps [GitHub Apps](/apps/) are the officially recommended way to integrate with GitHub because they offer many advantages over a pure OAuth-based integration: diff --git a/translations/ja-JP/content/developers/apps/modifying-an-oauth-app.md b/translations/ja-JP/content/developers/apps/modifying-an-oauth-app.md index 869475ce85bd..3e45db618208 100644 --- a/translations/ja-JP/content/developers/apps/modifying-an-oauth-app.md +++ b/translations/ja-JP/content/developers/apps/modifying-an-oauth-app.md @@ -9,12 +9,10 @@ versions: enterprise-server: '*' --- - - - {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.oauth_apps %} {% data reusables.user-settings.modify_oauth_app %} -5. Modify the {% data variables.product.prodname_oauth_app %} information that you'd like to change. +1. Modify the +{% data variables.product.prodname_oauth_app %} information that you'd like to change. {% data reusables.user-settings.update_oauth_app %} diff --git a/translations/ja-JP/content/developers/apps/refreshing-user-to-server-access-tokens.md b/translations/ja-JP/content/developers/apps/refreshing-user-to-server-access-tokens.md index 51f4160cab6b..f98f8f752373 100644 --- a/translations/ja-JP/content/developers/apps/refreshing-user-to-server-access-tokens.md +++ b/translations/ja-JP/content/developers/apps/refreshing-user-to-server-access-tokens.md @@ -28,10 +28,10 @@ This callback request will send you a new access token and a new refresh token. #### パラメータ -| 名前 | 種類 | 説明 | -| --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 名前 | 種類 | 説明 | +| --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `refresh_token` | `string` | **Required.** The token generated when the {% data variables.product.prodname_github_app %} owner enables expiring tokens and issues a new user access token. | -| `grant_type` | `string` | **Required.** Value must be `refresh_token` (required by the OAuth specification). | +| `grant_type` | `string` | **Required.** Value must be `refresh_token` (required by the OAuth specification). | | `client_id` | `string` | **Required.** The client ID for your {% data variables.product.prodname_github_app %}. | | `client_secret` | `string` | **Required.** The client secret for your {% data variables.product.prodname_github_app %}. | diff --git a/translations/ja-JP/content/developers/apps/scopes-for-oauth-apps.md b/translations/ja-JP/content/developers/apps/scopes-for-oauth-apps.md index 5619dbcf5089..ff5b4dc33152 100644 --- a/translations/ja-JP/content/developers/apps/scopes-for-oauth-apps.md +++ b/translations/ja-JP/content/developers/apps/scopes-for-oauth-apps.md @@ -36,46 +36,47 @@ X-Accepted-OAuth-Scopes: user ### Available scopes -| 名前 | 説明 | -| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| **`(no scope)`** | Grants read-only access to public information (includes public user profile info, public repository info, and gists){% if currentVersion != "free-pro-team@latest" %} -| **`site_admin`** | Grants site administrators access to [{% data variables.product.prodname_ghe_server %} Administration API endpoints](/v3/enterprise-admin).{% endif %} -| **`repo`** | Grants full access to private and public repositories. That includes read/write access to code, commit statuses, repository and organization projects, invitations, collaborators, adding team memberships, deployment statuses, and repository webhooks for public and private repositories and organizations. Also grants ability to manage user projects. | -|  `repo:status` | Grants read/write access to public and private repository commit statuses. This scope is only necessary to grant other users or services access to private repository commit statuses *without* granting access to the code. | -|  `repo_deployment` | Grants access to [deployment statuses](/v3/repos/deployments) for public and private repositories. This scope is only necessary to grant other users or services access to deployment statuses, *without* granting access to the code. | -|  `public_repo` | Limits access to public repositories. That includes read/write access to code, commit statuses, repository projects, collaborators, and deployment statuses for public repositories and organizations. Also required for starring public repositories. | -|  `repo:invite` | Grants accept/decline abilities for invitations to collaborate on a repository. This scope is only necessary to grant other users or services access to invites *without* granting access to the code.{% if currentVersion == "free-pro-team@latest" %} -|  `security_events` | Grants read and write access to security events in the [{% data variables.product.prodname_code_scanning %} API](/v3/code-scanning).{% endif %} -| **`admin:repo_hook`** | Grants read, write, ping, and delete access to repository hooks in public and private repositories. The `repo` and `public_repo` scopes grants full access to repositories, including repository hooks. Use the `admin:repo_hook` scope to limit access to only repository hooks. | -|  `write:repo_hook` | Grants read, write, and ping access to hooks in public or private repositories. | -|  `read:repo_hook` | Grants read and ping access to hooks in public or private repositories. | -| **`admin:org`** | Fully manage the organization and its teams, projects, and memberships. | -|  `write:org` | Read and write access to organization membership, organization projects, and team membership. | -|  `read:org` | Read-only access to organization membership, organization projects, and team membership. | -| **`admin:public_key`** | Fully manage public keys. | -|  `write:public_key` | Create, list, and view details for public keys. | -|  `read:public_key` | List and view details for public keys. | -| **`admin:org_hook`** | Grants read, write, ping, and delete access to organization hooks. **Note:** OAuth tokens will only be able to perform these actions on organization hooks which were created by the OAuth App. Personal access tokens will only be able to perform these actions on organization hooks created by a user. | -| **`gist`** | Grants write access to gists. | -| **`通知`** | Grants:
    * read access to a user's notifications
    * mark as read access to threads
    * watch and unwatch access to a repository, and
    * read, write, and delete access to thread subscriptions. | -| **`ユーザ`** | Grants read/write access to profile info only. Note that this scope includes `user:email` and `user:follow`. | -|  `read:user` | Grants access to read a user's profile data. | -|  `user:email` | Grants read access to a user's email addresses. | -|  `user:follow` | Grants access to follow or unfollow other users. | -| **`delete_repo`** | Grants access to delete adminable repositories. | -| **`write:discussion`** | Allows read and write access for team discussions. | -|  `read:discussion` | Allows read access for team discussions.{% if currentVersion == "free-pro-team@latest" %} -| **`write:packages`** | Grants access to upload or publish a package in {% data variables.product.prodname_registry %}. For more information, see "[Publishing a package](/github/managing-packages-with-github-packages/publishing-a-package)". | -| **`read:packages`** | Grants access to download or install packages from {% data variables.product.prodname_registry %}. For more information, see "[Installing a package](/github/managing-packages-with-github-packages/installing-a-package)". | -| **`delete:packages`** | Grants access to delete packages from {% data variables.product.prodname_registry %}. For more information, see "[Deleting packages](/github/managing-packages-with-github-packages/deleting-a-package)".{% endif %} -| **`admin:gpg_key`** | Fully manage GPG keys. | -|  `write:gpg_key` | Create, list, and view details for GPG keys. | -|  `read:gpg_key` | List and view details for GPG keys.{% if currentVersion == "free-pro-team@latest" %} -| **`ワークフロー`** | Grants the ability to add and update {% data variables.product.prodname_actions %} workflow files. Workflow files can be committed without this scope if the same file (with both the same path and contents) exists on another branch in the same repository.{% endif %} +Name | Description +-----|-----------| +**`(no scope)`** | Grants read-only access to public information (includes public user profile info, public repository info, and gists){% if currentVersion != "free-pro-team@latest" %} +**`site_admin`** | Grants site administrators access to [{% data variables.product.prodname_ghe_server %} Administration API endpoints](/v3/enterprise-admin).{% endif %} +**`repo`** | Grants full access to private and public repositories. That includes read/write access to code, commit statuses, repository and organization projects, invitations, collaborators, adding team memberships, deployment statuses, and repository webhooks for public and private repositories and organizations. Also grants ability to manage user projects. + `repo:status`| Grants read/write access to public and private repository commit statuses. This scope is only necessary to grant other users or services access to private repository commit statuses *without* granting access to the code. + `repo_deployment`| Grants access to [deployment statuses](/v3/repos/deployments) for public and private repositories. This scope is only necessary to grant other users or services access to deployment statuses, *without* granting access to the code. + `public_repo`| Limits access to public repositories. That includes read/write access to code, commit statuses, repository projects, collaborators, and deployment statuses for public repositories and organizations. Also required for starring public repositories. + `repo:invite` | Grants accept/decline abilities for invitations to collaborate on a repository. This scope is only necessary to grant other users or services access to invites *without* granting access to the code.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21"%} + `security_events` | Grants read and write access to security events in the [{% data variables.product.prodname_code_scanning %} API](/v3/code-scanning).{% endif %} +**`admin:repo_hook`** | Grants read, write, ping, and delete access to repository hooks in public and private repositories. The `repo` and `public_repo` scopes grants full access to repositories, including repository hooks. Use the `admin:repo_hook` scope to limit access to only repository hooks. + `write:repo_hook` | Grants read, write, and ping access to hooks in public or private repositories. + `read:repo_hook`| Grants read and ping access to hooks in public or private repositories. +**`admin:org`** | Fully manage the organization and its teams, projects, and memberships. + `write:org`| Read and write access to organization membership, organization projects, and team membership. + `read:org`| Read-only access to organization membership, organization projects, and team membership. +**`admin:public_key`** | Fully manage public keys. + `write:public_key`| Create, list, and view details for public keys. + `read:public_key`| List and view details for public keys. +**`admin:org_hook`** | Grants read, write, ping, and delete access to organization hooks. **Note:** OAuth tokens will only be able to perform these actions on organization hooks which were created by the OAuth App. Personal access tokens will only be able to perform these actions on organization hooks created by a user. +**`gist`** | Grants write access to gists. +**`notifications`** | Grants:
    * read access to a user's notifications
    * mark as read access to threads
    * watch and unwatch access to a repository, and
    * read, write, and delete access to thread subscriptions. +**`user`** | Grants read/write access to profile info only. Note that this scope includes `user:email` and `user:follow`. + `read:user`| Grants access to read a user's profile data. + `user:email`| Grants read access to a user's email addresses. + `user:follow`| Grants access to follow or unfollow other users. +**`delete_repo`** | Grants access to delete adminable repositories. +**`write:discussion`** | Allows read and write access for team discussions. + `read:discussion` | Allows read access for team discussions.{% if currentVersion == "free-pro-team@latest" %} +**`write:packages`** | Grants access to upload or publish a package in {% data variables.product.prodname_registry %}. For more information, see "[Publishing a package](/github/managing-packages-with-github-packages/publishing-a-package)". +**`read:packages`** | Grants access to download or install packages from {% data variables.product.prodname_registry %}. For more information, see "[Installing a package](/github/managing-packages-with-github-packages/installing-a-package)". +**`delete:packages`** | Grants access to delete packages from {% data variables.product.prodname_registry %}. For more information, see "[Deleting packages](/github/managing-packages-with-github-packages/deleting-a-package)".{% endif %} +**`admin:gpg_key`** | Fully manage GPG keys. + `write:gpg_key`| Create, list, and view details for GPG keys. + `read:gpg_key`| List and view details for GPG keys.{% if currentVersion == "free-pro-team@latest" %} +**`workflow`** | Grants the ability to add and update {% data variables.product.prodname_actions %} workflow files. Workflow files can be committed without this scope if the same file (with both the same path and contents) exists on another branch in the same repository.{% endif %} {% note %} -**Note:** Your OAuth App can request the scopes in the initial redirection. You can specify multiple scopes by separating them with a space: +**Note:** Your OAuth App can request the scopes in the initial redirection. You +can specify multiple scopes by separating them with a space: https://github.com/login/oauth/authorize? client_id=...& @@ -85,14 +86,29 @@ X-Accepted-OAuth-Scopes: user ### Requested scopes and granted scopes -The `scope` attribute lists scopes attached to the token that were granted by the user. Normally, these scopes will be identical to what you requested. However, users can edit their scopes, effectively granting your application less access than you originally requested. Also, users can edit token scopes after the OAuth flow is completed. You should be aware of this possibility and adjust your application's behavior accordingly. +The `scope` attribute lists scopes attached to the token that were granted by +the user. Normally, these scopes will be identical to what you requested. +However, users can edit their scopes, effectively +granting your application less access than you originally requested. Also, users +can edit token scopes after the OAuth flow is completed. +You should be aware of this possibility and adjust your application's behavior +accordingly. -It's important to handle error cases where a user chooses to grant you less access than you originally requested. For example, applications can warn or otherwise communicate with their users that they will see reduced functionality or be unable to perform some actions. +It's important to handle error cases where a user chooses to grant you +less access than you originally requested. For example, applications can warn +or otherwise communicate with their users that they will see reduced +functionality or be unable to perform some actions. -Also, applications can always send users back through the flow again to get additional permission, but don’t forget that users can always say no. +Also, applications can always send users back through the flow again to get +additional permission, but don’t forget that users can always say no. -Check out the [Basics of Authentication guide](/guides/basics-of-authentication/), which provides tips on handling modifiable token scopes. +Check out the [Basics of Authentication guide](/guides/basics-of-authentication/), which +provides tips on handling modifiable token scopes. ### Normalized scopes -When requesting multiple scopes, the token is saved with a normalized list of scopes, discarding those that are implicitly included by another requested scope. For example, requesting `user,gist,user:email` will result in a token with `user` and `gist` scopes only since the access granted with `user:email` scope is included in the `user` scope. +When requesting multiple scopes, the token is saved with a normalized list +of scopes, discarding those that are implicitly included by another requested +scope. For example, requesting `user,gist,user:email` will result in a +token with `user` and `gist` scopes only since the access granted with +`user:email` scope is included in the `user` scope. diff --git a/translations/ja-JP/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md b/translations/ja-JP/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md index 6c5978ec5d3f..3bb17e644242 100644 --- a/translations/ja-JP/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md +++ b/translations/ja-JP/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md @@ -9,7 +9,6 @@ versions: --- - ### はじめに This guide will walk through the steps needed to configure a GitHub App and run it on a server. GitHub Apps require some setup steps to manage webhook events and connect the app registration on GitHub to your code. The app in this guide serves as a foundation that you can use to extend and build new GitHub Apps. diff --git a/translations/ja-JP/content/developers/apps/suspending-a-github-app-installation.md b/translations/ja-JP/content/developers/apps/suspending-a-github-app-installation.md index 507e57dc59c6..2a6beab9998d 100644 --- a/translations/ja-JP/content/developers/apps/suspending-a-github-app-installation.md +++ b/translations/ja-JP/content/developers/apps/suspending-a-github-app-installation.md @@ -10,20 +10,22 @@ versions: {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} {% note %} -**ノート：** {% data reusables.pre-release-program.suspend-installation-beta %} +**メモ:** {% data reusables.pre-release-program.suspend-installation-beta %} {% endnote %} {% endif %} ### Suspending a GitHub App -To suspend a {% data variables.product.prodname_github_app %}, you must be an account owner or have admin permissions in the repository or organization where the app you want to suspend is installed. +The integrator who owns and maintains a GitHub app, also called a GitHub App owner, can suspend or unsuspend a GitHub App installation using REST API endpoints with a JWT. For more information, see the [GitHub Apps REST API](/rest/reference/apps). -You can also suspend and unsuspend {% data variables.product.prodname_github_app %} installations using the REST API. For more information, see the [GitHub Apps REST API](/v3/apps/). +People who have installed a GitHub App, also called installation owners, can only suspend or unsuspend a GitHub App through their app's installation settings. Installation owners cannot use the API to suspend or unsuspend their app installation. Before people can suspend a GitHub app installation, the GitHub App owner must opt-in to the beta release. 詳しい情報については「[GitHub Appのインストールのサスペンド](/apps/managing-github-apps/suspending-a-github-app-installation/)」を参照してください。 {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.github_apps %} -4. Select the {% data variables.product.prodname_github_app %} you want to suspend. ![App selection](/assets/images/github-apps/github_apps_select-app.png) +4. Select the +{% data variables.product.prodname_github_app %} you want to suspend. +![App selection](/assets/images/github-apps/github_apps_select-app.png) {% data reusables.user-settings.github_apps_advanced %} 6. Next to the suspension settings for the installation, click **Suspend** or **Unsuspend**. ![Suspend a GitHub App](/assets/images/github-apps/suspend-a-github-app.png) diff --git a/translations/ja-JP/content/developers/apps/using-the-github-api-in-your-app.md b/translations/ja-JP/content/developers/apps/using-the-github-api-in-your-app.md index 9894a60f10e5..3231591ed2b4 100644 --- a/translations/ja-JP/content/developers/apps/using-the-github-api-in-your-app.md +++ b/translations/ja-JP/content/developers/apps/using-the-github-api-in-your-app.md @@ -10,7 +10,6 @@ versions: --- - ### はじめに This guide will help you build a GitHub App and run it on a server. The app you build will add a label to all new issues opened in the repository where the app is installed. diff --git a/translations/ja-JP/content/developers/github-marketplace/drafting-a-listing-for-your-app.md b/translations/ja-JP/content/developers/github-marketplace/drafting-a-listing-for-your-app.md index 0da8b2f8d741..7bc6b6e54221 100644 --- a/translations/ja-JP/content/developers/github-marketplace/drafting-a-listing-for-your-app.md +++ b/translations/ja-JP/content/developers/github-marketplace/drafting-a-listing-for-your-app.md @@ -40,7 +40,10 @@ To create a {% data variables.product.prodname_marketplace %} listing: ![App type selection](/assets/images/settings/apps_choose_app.png) -4. Select the app you'd like to add to {% data variables.product.prodname_marketplace %}. ![App selection for {% data variables.product.prodname_marketplace %} listing](/assets/images/github-apps/github_apps_select-app.png) +4. Select the app you'd like to add to + +{% data variables.product.prodname_marketplace %}. +![App selection for {% data variables.product.prodname_marketplace %} listing](/assets/images/github-apps/github_apps_select-app.png) {% data reusables.user-settings.edit_marketplace_listing %} 5. Once you've created a new draft listing, you'll see an overview of the sections that you'll need to visit before your {% data variables.product.prodname_marketplace %} listing will be complete. ![GitHub Marketplace listing](/assets/images/marketplace/marketplace_listing_overview.png) diff --git a/translations/ja-JP/content/developers/github-marketplace/viewing-metrics-for-your-listing.md b/translations/ja-JP/content/developers/github-marketplace/viewing-metrics-for-your-listing.md index fe55776d9baa..045237bda979 100644 --- a/translations/ja-JP/content/developers/github-marketplace/viewing-metrics-for-your-listing.md +++ b/translations/ja-JP/content/developers/github-marketplace/viewing-metrics-for-your-listing.md @@ -47,7 +47,8 @@ To access {% data variables.product.prodname_marketplace %} Insights: {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.marketplace_apps %} -4. Select the {% data variables.product.prodname_github_app %} that you'd like to view Insights for. +4. Select the +{% data variables.product.prodname_github_app %} that you'd like to view Insights for. {% data reusables.user-settings.edit_marketplace_listing %} 6. Click the **Insights** tab. 7. Optionally, select a different time period by clicking the Period dropdown in the upper-right corner of the Insights page. ![Marketplace time period](/assets/images/marketplace/marketplace_insights_time_period.png) diff --git a/translations/ja-JP/content/developers/github-marketplace/viewing-transactions-for-your-listing.md b/translations/ja-JP/content/developers/github-marketplace/viewing-transactions-for-your-listing.md index 5f87adff43f0..15ede21ee304 100644 --- a/translations/ja-JP/content/developers/github-marketplace/viewing-transactions-for-your-listing.md +++ b/translations/ja-JP/content/developers/github-marketplace/viewing-transactions-for-your-listing.md @@ -39,7 +39,8 @@ To access {% data variables.product.prodname_marketplace %} transactions: {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.marketplace_apps %} -4. Select the {% data variables.product.prodname_github_app %} that you'd like to view transactions for. +4. Select the +{% data variables.product.prodname_github_app %} that you'd like to view transactions for. {% data reusables.user-settings.edit_marketplace_listing %} 6. Click the **Transactions** tab. 7. Optionally, select a different time period by clicking the Period dropdown in the upper-right corner of the Transactions page. ![Marketplace time period](/assets/images/marketplace/marketplace_insights_time_period.png) diff --git a/translations/ja-JP/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md b/translations/ja-JP/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md index 8ce848c65b2c..64c0fd209725 100644 --- a/translations/ja-JP/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md +++ b/translations/ja-JP/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md @@ -27,18 +27,18 @@ Each `marketplace_purchase` webhook payload will have the following information: | `action` | `string` | The action performed to generate the webhook. Can be `purchased`, `cancelled`, `pending_change`, `pending_change_cancelled`, or `changed`. For more information, see the example webhook payloads below. **Note:** The `pending_change` and `pending_change_cancelled` payloads contain the same keys as shown in the [`changed` payload example](#example-webhook-payload-for-a-changed-event). | | `effective_date` | `string` | The date the `action` becomes effective. | | `sender` | `オブジェクト` | The person who took the `action` that triggered the webhook. | -| `marketplace_purchase` | `オブジェクト` | The {% data variables.product.prodname_marketplace %} purchase information. | +| `marketplace_purchase` | `オブジェクト` | The {% data variables.product.prodname_marketplace %} purchase information. | The `marketplace_purchase` object has the following keys: | キー | 種類 | 説明 | | -------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `アカウント` | `オブジェクト` | The `organization` or `user` account associated with the subscription. Organization accounts will include `organization_billing_email`, which is the organization's administrative email address. To find email addresses for personal accounts, you can use the [Get the authenticated user](/v3/users/#get-the-authenticated-user) endpoint. | -| `billing_cycle` | `string` | Can be `yearly` or `monthly`. When the `account` owner has a free GitHub plan and has purchased a free {% data variables.product.prodname_marketplace %} plan, `billing_cycle` will be `nil`. | +| `billing_cycle` | `string` | Can be `yearly` or `monthly`. When the `account` owner has a free GitHub plan and has purchased a free {% data variables.product.prodname_marketplace %} plan, `billing_cycle` will be `nil`. | | `unit_count` | `整数` | Number of units purchased. | | `on_free_trial` | `boolean` | `true` when the `account` is on a free trial. | | `free_trial_ends_on` | `string` | The date the free trial will expire. | -| `next_billing_date` | `string` | The date that the next billing cycle will start. When the `account` owner has a free GitHub.com plan and has purchased a free {% data variables.product.prodname_marketplace %} plan, `next_billing_date` will be `nil`. | +| `next_billing_date` | `string` | The date that the next billing cycle will start. When the `account` owner has a free GitHub.com plan and has purchased a free {% data variables.product.prodname_marketplace %} plan, `next_billing_date` will be `nil`. | | `plan` | `オブジェクト` | The plan purchased by the `user` or `organization`. | The `plan` object has the following keys: diff --git a/translations/ja-JP/content/developers/overview/managing-deploy-keys.md b/translations/ja-JP/content/developers/overview/managing-deploy-keys.md index f72830338c55..cfe952c333e9 100644 --- a/translations/ja-JP/content/developers/overview/managing-deploy-keys.md +++ b/translations/ja-JP/content/developers/overview/managing-deploy-keys.md @@ -10,7 +10,6 @@ versions: --- - You can manage SSH keys on your servers when automating deployment scripts using SSH agent forwarding, HTTPS with OAuth tokens, deploy keys, or machine users. ### SSH agent forwarding diff --git a/translations/ja-JP/content/developers/overview/replacing-github-services.md b/translations/ja-JP/content/developers/overview/replacing-github-services.md index 13ea935a867a..eb1925fc9e60 100644 --- a/translations/ja-JP/content/developers/overview/replacing-github-services.md +++ b/translations/ja-JP/content/developers/overview/replacing-github-services.md @@ -19,7 +19,6 @@ As an alternative to the email service, you can now start using email notificati {% endnote %} - ### Deprecation timeline - **October 1, 2018**: GitHub discontinued allowing users to install services. We removed GitHub Services from the GitHub.com user interface. diff --git a/translations/ja-JP/content/developers/webhooks-and-events/about-webhooks.md b/translations/ja-JP/content/developers/webhooks-and-events/about-webhooks.md index f76bc1a89843..64b973bcf586 100644 --- a/translations/ja-JP/content/developers/webhooks-and-events/about-webhooks.md +++ b/translations/ja-JP/content/developers/webhooks-and-events/about-webhooks.md @@ -1,5 +1,5 @@ --- -title: webhook について +title: About webhooks intro: Learn the basics of how webhooks work to help you build and set up integrations. redirect_from: - /webhooks @@ -9,14 +9,13 @@ versions: --- - Webhooks allow you to build or set up integrations, such as [{% data variables.product.prodname_github_app %}s](/apps/building-github-apps/) or [{% data variables.product.prodname_oauth_app %}s](/apps/building-oauth-apps/), which subscribe to certain events on GitHub.com. When one of those events is triggered, we'll send a HTTP POST payload to the webhook's configured URL. Webhooks can be used to update an external issue tracker, trigger CI builds, update a backup mirror, or even deploy to your production server. You're only limited by your imagination. -Webhooks can be installed on{% if currentVersion != "free-pro-team@latest" %} a [{% data variables.product.prodname_ghe_server %} instance](/v3/enterprise-admin/global_webhooks/),{% endif %} an [organization][org-hooks], a specific [repository][repo-hooks], or a {% data variables.product.prodname_github_app %}. Once installed, the webhook will be sent each time one or more subscribed events occurs. +Webhooks can be installed on{% if currentVersion != "free-pro-team@latest" %} a [{% data variables.product.prodname_ghe_server %} instance](/rest/reference/enterprise-admin#global-webhooks/),{% endif %} an [organization][org-hooks], a specific [repository][repo-hooks], or a {% data variables.product.prodname_github_app %}. Once installed, the webhook will be sent each time one or more subscribed events occurs. You can create up to {% if currentVersion != "free-pro-team@latest" %}250{% else %}20{% endif %} webhooks for each event on each installation target {% if currentVersion != "free-pro-team@latest" %}({% data variables.product.prodname_ghe_server %} instance, specific organization, or specific repository).{% else %}(specific organization or specific repository).{% endif %} -### イベント +### Events {% data reusables.webhooks.webhooks_intro %} @@ -30,5 +29,5 @@ See "[Webhook event payloads](/webhooks/event-payloads)" for the list of availab For more information about the `ping` event webhook payload, see the [`ping`](/webhooks/event-payloads/#ping) event. -[org-hooks]: /v3/orgs/hooks/ +[org-hooks]: /rest/reference/orgs#webhooks/ [repo-hooks]: /v3/repos/hooks/ diff --git a/translations/ja-JP/content/developers/webhooks-and-events/github-event-types.md b/translations/ja-JP/content/developers/webhooks-and-events/github-event-types.md index 34fb0ec2b0f0..d88565f8cf05 100644 --- a/translations/ja-JP/content/developers/webhooks-and-events/github-event-types.md +++ b/translations/ja-JP/content/developers/webhooks-and-events/github-event-types.md @@ -16,7 +16,6 @@ The Events API can return different types of events triggered by activity on Git {% endif %} - ### Event object common properties The event objects returned from the Events API endpoints have the same structure. @@ -203,7 +202,7 @@ This event returns an empty `payload` object. | `push_id` | `整数` | Unique identifier for the push. | | `size` | `整数` | The number of commits in the push. | | `distinct_size` | `整数` | The number of distinct commits in the push. | -| `ref` | `string` | The full [`git ref`](/v3/git/refs/) that was pushed. Example: `refs/heads/master`. | +| `ref` | `string` | The full [`git ref`](/v3/git/refs/) that was pushed. Example: `refs/heads/main`. | | `head` | `string` | The SHA of the most recent commit on `ref` after the push. | | `before` | `string` | The SHA of the most recent commit on `ref` before the push. | | `commits` | `array` | An array of commit objects describing the pushed commits. (The array includes a maximum of 20 commits. If necessary, you can use the [Commits API](/v3/repos/commits/) to fetch additional commits. This limit is applied to timeline events only and isn't applied to webhook deliveries.) | diff --git a/translations/ja-JP/content/developers/webhooks-and-events/issue-event-types.md b/translations/ja-JP/content/developers/webhooks-and-events/issue-event-types.md index 5fbbbd13e8cf..1c6ac7c3b2ab 100644 --- a/translations/ja-JP/content/developers/webhooks-and-events/issue-event-types.md +++ b/translations/ja-JP/content/developers/webhooks-and-events/issue-event-types.md @@ -11,7 +11,6 @@ versions: Issue events are triggered by activity in issues and pull requests and are available in the [Issue Events API](/v3/issues/events) and the [Timeline Events API](/v3/issues/timeline). Each event type specifies whether the event is available in the Issue Events or Timeline Events APIs. - GitHub's REST API considers every pull request to be an issue, but not every issue is a pull request. For this reason, the Issue Events and Timeline Events endpoints may return both issues and pull requests in the response. Pull requests have a `pull_request` property in the `issue` object. Because pull requests are issues, issue and pull request numbers do not overlap in a repository. For example, if you open your first issue in a repository, the number will be 1. If you then open a pull request, the number will be 2. Each event type specifies if the event occurs in pull request, issues, or both. ### Issue event object common properties diff --git a/translations/ja-JP/content/developers/webhooks-and-events/securing-your-webhooks.md b/translations/ja-JP/content/developers/webhooks-and-events/securing-your-webhooks.md index 7f135f37bdae..0a5ed843591b 100644 --- a/translations/ja-JP/content/developers/webhooks-and-events/securing-your-webhooks.md +++ b/translations/ja-JP/content/developers/webhooks-and-events/securing-your-webhooks.md @@ -33,9 +33,17 @@ $ export SECRET_TOKEN=your_token ### Validating payloads from GitHub -When your secret token is set, GitHub uses it to create a hash signature with each payload. +When your secret token is set, {% data variables.product.product_name %} uses it to create a hash signature with each payload. This hash signature is included with the headers of each request as {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %}`X-Hub-Signature-256`{% else if currentVersion ver_lt "enterprise-server@2.23" %}`X-Hub-Signature`{% endif %}. -This hash signature is passed along with each request in the headers as `X-Hub-Signature`. Suppose you have a basic server listening to webhooks that looks like this: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %} +{% note %} + +**Note:** For backward-compatibility, we also include the `X-Hub-Signature` header that is generated using the SHA-1 hash function. If possible, we recommend that you use the `X-Hub-Signature-256` header for improved security. The example below demonstrate using the `X-Hub-Signature-256` header. + +{% endnote %} +{% endif %} + +For example, if you have a basic server that listens for webhooks, it might be configured similar to this: ``` ruby require 'sinatra' @@ -47,7 +55,7 @@ post '/payload' do end ``` -The goal is to compute a hash using your `SECRET_TOKEN`, and ensure that the hash from GitHub matches. GitHub uses an HMAC hexdigest to compute the hash, so you could change your server to look a little like this: +The intention is to calculate a hash using your `SECRET_TOKEN`, and ensure that the result matches the hash from {% data variables.product.product_name %}. {% data variables.product.product_name %} uses an HMAC hex digest to compute the hash, so you could reconfigure your server to look a little like this: ``` ruby post '/payload' do @@ -58,16 +66,21 @@ post '/payload' do "I got some JSON: #{push.inspect}" end +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %} +def verify_signature(payload_body) + signature = 'sha256=' + OpenSSL::HMAC.hexdigest(OpenSSL::Digest.new('sha256'), ENV['SECRET_TOKEN'], payload_body) + return halt 500, "Signatures didn't match!" unless Rack::Utils.secure_compare(signature, request.env['HTTP_X_HUB_SIGNATURE_2']) +end{% else if currentVersion ver_lt "enterprise-server@2.23" %} def verify_signature(payload_body) signature = 'sha1=' + OpenSSL::HMAC.hexdigest(OpenSSL::Digest.new('sha1'), ENV['SECRET_TOKEN'], payload_body) return halt 500, "Signatures didn't match!" unless Rack::Utils.secure_compare(signature, request.env['HTTP_X_HUB_SIGNATURE']) -end +end{% endif %} ``` -Obviously, your language and server implementations may differ than this code. There are a couple of very important things to point out, however: +Your language and server implementations may differ from this example code. However, there are a number of very important things to point out: -* No matter which implementation you use, the hash signature starts with `sha1=`, using the key of your secret token and your payload body. +* No matter which implementation you use, the hash signature starts with {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or "private-instances@latest" %}`sha256=`{% else if currentVersion ver_lt "enterprise-server@2.23" %}`sha1=`{% endif %}, using the key of your secret token and your payload body. -* Using a plain `==` operator is **not advised**. A method like [`secure_compare`][secure_compare] performs a "constant time" string comparison, which renders it safe from certain timing attacks against regular equality operators. +* Using a plain `==` operator is **not advised**. A method like [`secure_compare`][secure_compare] performs a "constant time" string comparison, which helps mitigate certain timing attacks against regular equality operators. [secure_compare]: http://rubydoc.info/github/rack/rack/master/Rack/Utils.secure_compare diff --git a/translations/ja-JP/content/developers/webhooks-and-events/testing-webhooks.md b/translations/ja-JP/content/developers/webhooks-and-events/testing-webhooks.md index 7879be6fcb25..1d4d43045cba 100644 --- a/translations/ja-JP/content/developers/webhooks-and-events/testing-webhooks.md +++ b/translations/ja-JP/content/developers/webhooks-and-events/testing-webhooks.md @@ -9,7 +9,6 @@ versions: --- - Now that you've [configured your local server](/webhooks/configuring/), you might be interested in pushing your code to the limits. To that end, GitHub's webhooks view provides some tooling for testing your deployed payloads. ### Listing recent deliveries diff --git a/translations/ja-JP/content/developers/webhooks-and-events/webhook-events-and-payloads.md b/translations/ja-JP/content/developers/webhooks-and-events/webhook-events-and-payloads.md index 97b79fa3d4d8..79eede76ea96 100644 --- a/translations/ja-JP/content/developers/webhooks-and-events/webhook-events-and-payloads.md +++ b/translations/ja-JP/content/developers/webhooks-and-events/webhook-events-and-payloads.md @@ -20,7 +20,6 @@ versions: You can create webhooks that subscribe to the events listed on this page. Each webhook event includes a description of the webhook properties and an example payload. 詳しい情報については「[webhook を作成する](/webhooks/creating/)」を参照してください。 - ### Webhook payload object common properties Each webhook event payload also contains properties unique to the event. You can find the unique properties in the individual event type sections. @@ -28,11 +27,8 @@ Each webhook event payload also contains properties unique to the event. You can | キー | 種類 | 説明 | | -------- | -------- | ---------------------------------------------------------------------------------------------------------------- | | `action` | `string` | Most webhook payloads contain an `action` property that contains the specific activity that triggered the event. | - {% data reusables.webhooks.sender_desc %} This property is included in every webhook payload. -{% data reusables.webhooks.repo_desc %} Webhook payloads contain the - -`repository` property when the event occurs from activity in a repository. +{% data reusables.webhooks.repo_desc %} Webhook payloads contain the `repository` property when the event occurs from activity in a repository. {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} For more information, see "[Building {% data variables.product.prodname_github_app %}](/apps/building-github-apps/)." @@ -48,13 +44,14 @@ The unique properties for a webhook event are the same properties you'll find in HTTP POST payloads that are delivered to your webhook's configured URL endpoint will contain several special headers: -| ヘッダ | 説明 | -| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `X-GitHub-Event` | Name of the event that triggered the delivery. | +| ヘッダ | 説明 | +| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `X-GitHub-Event` | Name of the event that triggered the delivery. | | `X-GitHub-Delivery` | A [GUID](http://en.wikipedia.org/wiki/Globally_unique_identifier) to identify the delivery.{% if currentVersion != "free-pro-team@latest" %} -| `X-GitHub-Enterprise-Version` | The version of the {% data variables.product.prodname_ghe_server %} instance that sent the HTTP POST payload. | -| `X-GitHub-Enterprise-Host` | The hostname of the {% data variables.product.prodname_ghe_server %} instance that sent the HTTP POST payload.{% endif %} -| `X-Hub-Signature` | The HMAC hex digest of the response body. This header will be sent if the webhook is configured with a [`secret`](/v3/repos/hooks/#create-hook-config-params). The HMAC hex digest is generated using the `sha1` hash function and the `secret` as the HMAC `key`. | +| `X-GitHub-Enterprise-Version` | The version of the {% data variables.product.prodname_ghe_server %} instance that sent the HTTP POST payload. | +| `X-GitHub-Enterprise-Host` | The hostname of the {% data variables.product.prodname_ghe_server %} instance that sent the HTTP POST payload.{% endif %}{% if currentVersion != "private-instances@latest" %} +| `X-Hub-Signature` | This header is sent if the webhook is configured with a [`secret`](/v3/repos/hooks/#create-hook-config-params). This is the HMAC hex digest of the request body, and is generated using the SHA-1 hash function and the `secret` as the HMAC `key`.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} `X-Hub-Signature` is provided for compatibility with existing integrations, and we recommend that you use the more secure `X-Hub-Signature-256` instead.{% endif %}{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %} +| `X-Hub-Signature-256` | This header is sent if the webhook is configured with a [`secret`](/v3/repos/hooks/#create-hook-config-params). This is the HMAC hex digest of the request body, and is generated using the SHA-256 hash function and the `secret` as the HMAC `key`.{% endif %} Also, the `User-Agent` for the requests will have the prefix `GitHub-Hookshot/`. @@ -66,8 +63,9 @@ Also, the `User-Agent` for the requests will have the prefix `GitHub-Hookshot/`. > Host: localhost:4567 > X-GitHub-Delivery: 72d3162e-cc78-11e3-81ab-4c9367dc0958{% if currentVersion != "free-pro-team@latest" %} > X-GitHub-Enterprise-Version: 2.15.0 -> X-GitHub-Enterprise-Host: example.com{% endif %} -> X-Hub-Signature: sha1=7d38cdd689735b008b3c702edd92eea23791c5f6 +> X-GitHub-Enterprise-Host: example.com{% endif %}{% if currentVersion != "private-instances@latest" %} +> X-Hub-Signature: sha1=7d38cdd689735b008b3c702edd92eea23791c5f6{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %} +> X-Hub-Signature-256: sha256=d57c68ca6f92289e6987922ff26938930f6e66a2d161ef06abdf1859230aa23c{% endif %} > User-Agent: GitHub-Hookshot/044aadd > Content-Type: application/json > Content-Length: 6615 @@ -292,10 +290,10 @@ Only {% data variables.product.prodname_github_app %}s can receive this event. { #### Webhook payload object -| キー | 種類 | 説明 | -| ------------ | --------------------------------------------------------------- | ---------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -| `action` | `string` | 実行されたアクション。 Can be `created`.{% endif %} -| `deployment` | `オブジェクト` | The [deployment](/v3/repos/deployments/#list-deployments). | +| キー | 種類 | 説明 | +| ------------ | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +| `action` | `string` | 実行されたアクション。 Can be `created`.{% endif %} +| `deployment` | `オブジェクト` | The [deployment](/rest/reference/repos#list-deployments). | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} @@ -317,14 +315,14 @@ Only {% data variables.product.prodname_github_app %}s can receive this event. { #### Webhook payload object -| キー | 種類 | 説明 | -| ---------------------------------- | --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -| `action` | `string` | 実行されたアクション。 Can be `created`.{% endif %} -| `deployment_status` | `オブジェクト` | The [deployment status](/v3/repos/deployments/#list-deployment-statuses). | -| `deployment_status["state"]` | `string` | The new state. Can be `pending`, `success`, `failure`, or `error`. | -| `deployment_status["target_url"]` | `string` | The optional link added to the status. | -| `deployment_status["description"]` | `string` | The optional human-readable description added to the status. | -| `deployment` | `オブジェクト` | The [deployment](/v3/repos/deployments/#list-deployments) that this status is associated with. | +| キー | 種類 | 説明 | +| ---------------------------------- | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +| `action` | `string` | 実行されたアクション。 Can be `created`.{% endif %} +| `deployment_status` | `オブジェクト` | The [deployment status](/rest/reference/repos#list-deployment-statuses). | +| `deployment_status["state"]` | `string` | The new state. Can be `pending`, `success`, `failure`, or `error`. | +| `deployment_status["target_url"]` | `string` | The optional link added to the status. | +| `deployment_status["description"]` | `string` | The optional human-readable description added to the status. | +| `deployment` | `オブジェクト` | The [deployment](/rest/reference/repos#list-deployments) that this status is associated with. | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} @@ -342,7 +340,7 @@ Only {% data variables.product.prodname_github_app %}s can receive this event. { #### Availability -- GitHub Enterprise webhooks. For more information, "[Global webhooks](/v3/enterprise-admin/global_webhooks/)." +- GitHub Enterprise webhooks. For more information, "[Global webhooks](/rest/reference/enterprise-admin#global-webhooks/)." #### Webhook payload object @@ -670,17 +668,17 @@ The webhook this event is configured on was deleted. This event will only listen #### Availability {% if currentVersion != "free-pro-team@latest" %} -- GitHub Enterprise webhooks only receive `created` and `deleted` events. For more information, "[Global webhooks](/v3/enterprise-admin/global_webhooks/).{% endif %} +- GitHub Enterprise webhooks only receive `created` and `deleted` events. For more information, "[Global webhooks](/rest/reference/enterprise-admin#global-webhooks/).{% endif %} - Organization webhooks only receive the `deleted`, `added`, `removed`, `renamed`, and `invited` events - {% data variables.product.prodname_github_app %}s with the `members` permission #### Webhook payload object -| キー | 種類 | 説明 | -| ------------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| キー | 種類 | 説明 | +| ------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `action` | `string` | 実行されたアクション. Can be one of:{% if currentVersion != "free-pro-team@latest" %} `created`,{% endif %} `deleted`, `renamed`, `member_added`, `member_removed`, or `member_invited`. | -| `招待` | `オブジェクト` | The invitation for the user or email if the action is `member_invited`. | -| `membership` | `オブジェクト` | The membership between the user and the organization. Not present when the action is `member_invited`. | +| `招待` | `オブジェクト` | The invitation for the user or email if the action is `member_invited`. | +| `membership` | `オブジェクト` | The membership between the user and the organization. Not present when the action is `member_invited`. | {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} @@ -747,10 +745,10 @@ Activity related to {% data variables.product.prodname_registry %}. {% data reus #### Webhook payload object -| キー | 種類 | 説明 | -| ----- | -------- | --------------------------------------------------------------------------------- | -| `id` | `整数` | The unique identifier of the page build. | -| `ビルド` | `オブジェクト` | The [List GitHub Pages builds](/v3/repos/pages/#list-github-pages-builds) itself. | +| キー | 種類 | 説明 | +| ----- | -------- | -------------------------------------------------------------------------------------- | +| `id` | `整数` | The unique identifier of the page build. | +| `ビルド` | `オブジェクト` | The [List GitHub Pages builds](/rest/reference/repos#list-github-pages-builds) itself. | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} @@ -772,11 +770,11 @@ Activity related to {% data variables.product.prodname_registry %}. {% data reus #### Webhook payload object -| キー | 種類 | 説明 | -| -------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `zen` | `string` | Random string of GitHub zen. | -| `hook_id` | `整数` | The ID of the webhook that triggered the ping. | -| `フック` | `オブジェクト` | The [webhook configuration](/v3/repos/hooks/#get-a-repository-webhook). | +| キー | 種類 | 説明 | +| -------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `zen` | `string` | Random string of GitHub zen. | +| `hook_id` | `整数` | The ID of the webhook that triggered the ping. | +| `フック` | `オブジェクト` | The [webhook configuration](/v3/repos/hooks/#get-a-repository-webhook). | | `hook[app_id]` | `整数` | When you register a new {% data variables.product.prodname_github_app %}, {% data variables.product.product_name %} sends a ping event to the **webhook URL** you specified during registration. The event contains the `app_id`, which is required for [authenticating](/apps/building-integrations/setting-up-and-registering-github-apps/about-authentication-options-for-github-apps/) an app. | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} @@ -972,7 +970,7 @@ Deliveries for `review_requested` and `review_request_removed` events will have | キー | 種類 | 説明 | | -------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `ref` | `string` | The full [`git ref`](/v3/git/refs/) that was pushed. Example: `refs/heads/master`. | +| `ref` | `string` | The full [`git ref`](/v3/git/refs/) that was pushed. Example: `refs/heads/main`. | | `before` | `string` | The SHA of the most recent commit on `ref` before the push. | | `after` | `string` | The SHA of the most recent commit on `ref` after the push. | | `commits` | `array` | An array of commit objects describing the pushed commits. (The array includes a maximum of 20 commits. If necessary, you can use the [Commits API](/v3/repos/commits/) to fetch additional commits. This limit is applied to timeline events only and isn't applied to webhook deliveries.) | @@ -1044,7 +1042,7 @@ This event occurs when a {% data variables.product.prodname_github_app %} sends | キー | 種類 | 説明 | | -------- | -------- | -------------------------------------------------------- | -| `action` | `string` | 実行されたアクション. This can be one of:
    • `created` - A repository is created.
    • `deleted` - A repository is deleted. This event type is only available to [organization hooks](/v3/orgs/hooks/)
    • `archived` - A repository is archived.
    • `unarchived` - A repository is unarchived.
      • {% if currentVersion != "free-pro-team@latest" %}
    • `anonymous_access_enabled` - A repository is [enabled for anonymous Git access](/v3/previews/#anonymous-git-access-to-repositories), `anonymous_access_disabled` - A repository is [disabled for anonymous Git access](/v3/previews/#anonymous-git-access-to-repositories)
      • {% endif %}
    • `edited` - A repository's information is edited.
    • `renamed` - A repository is renamed.
    • `transferred` - A repository is transferred.
    • `publicized` - A repository is made public.
    • `privatized` - A repository is made private.
    | +| `action` | `string` | 実行されたアクション. This can be one of:
    • `created` - A repository is created.
    • `deleted` - A repository is deleted. This event type is only available to [organization hooks](/rest/reference/orgs#webhooks/)
    • `archived` - A repository is archived.
    • `unarchived` - A repository is unarchived.
      • {% if currentVersion != "free-pro-team@latest" %}
    • `anonymous_access_enabled` - A repository is [enabled for anonymous Git access](/v3/previews/#anonymous-git-access-to-repositories), `anonymous_access_disabled` - A repository is [disabled for anonymous Git access](/v3/previews/#anonymous-git-access-to-repositories)
      • {% endif %}
    • `edited` - A repository's information is edited.
    • `renamed` - A repository is renamed.
    • `transferred` - A repository is transferred.
    • `publicized` - A repository is made public.
    • `privatized` - A repository is made private.
    | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} @@ -1253,7 +1251,7 @@ You can only create a sponsorship webhook on {% data variables.product.prodname_ When a user is `created` or `deleted`. #### Availability -- GitHub Enterprise webhooks. For more information, "[Global webhooks](/v3/enterprise-admin/global_webhooks/)." +- GitHub Enterprise webhooks. For more information, "[Global webhooks](/rest/reference/enterprise-admin#global-webhooks/)." #### Webhook payload example @@ -1299,7 +1297,6 @@ This event occurs when someone triggers a workflow run on GitHub or sends a `POS {{ webhookPayloadsForCurrentVersion.workflow_dispatch }} {% endif %} - ### workflow_run When a {% data variables.product.prodname_actions %} workflow run is requested or completed. 詳しい情報については、「[ワークフローをトリガーするイベント](/actions/reference/events-that-trigger-workflows#workflow_run)」を参照してください。 diff --git a/translations/ja-JP/content/github/administering-a-repository/about-branch-restrictions.md b/translations/ja-JP/content/github/administering-a-repository/about-branch-restrictions.md index 63cbf505bfa3..3939542fd463 100644 --- a/translations/ja-JP/content/github/administering-a-repository/about-branch-restrictions.md +++ b/translations/ja-JP/content/github/administering-a-repository/about-branch-restrictions.md @@ -1,6 +1,6 @@ --- title: ブランチ制限について -intro: 'Organization に属するリポジトリ内のブランチは、特定のユーザ{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}、{% else %} または{% endif %}チーム{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}、またはアプリ{% endif %}のみがブランチにプッシュできるように設定できます。' +intro: 'Branches within repositories that belong to organizations can be configured so that only certain users{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %} or{% endif %} teams{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, or apps{% endif %} can push to the branch.' product: '{% data reusables.gated-features.branch-restrictions %}' redirect_from: - /articles/about-branch-restrictions @@ -9,15 +9,15 @@ versions: enterprise-server: '*' --- -ブランチ制限を有効化している場合、権限を与えられたユーザ{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}、{% else %}または{% endif %}チーム{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}、またはアプリ{% endif %}のみが、保護されたブランチにプッシュできます。 詳細については、「[ブランチ制限の有効化](/articles/enabling-branch-restrictions)」と「[保護されたブランチについて](/articles/about-protected-branches) 」を参照してください。 保護されたブランチの設定では、保護されたブランチへのプッシュアクセスを持つユーザ{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}、{% else %}または{% endif %}チーム{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}、またはアプリ{% endif %}を表示および編集できます。 +When you enable branch restrictions, only users, teams, or apps that have been given permission can push to the protected branch. 詳細については、「[ブランチ制限の有効化](/articles/enabling-branch-restrictions)」と「[保護されたブランチについて](/articles/about-protected-branches) 」を参照してください。 You can view and edit the users, teams, or apps with push access to a protected branch in the protected branch's settings. -保護されたブランチをへのプッシュアクセスを与えられる対象は、リポジトリへの`書き込み`アクセスを持つユーザ{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}、{% else %}または{% endif %}チーム{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}、またはインストールされたアプリ{% data variables.product.prodname_github_apps %}{% endif %}のみです。 +You can only give push access to a protected branch to users, teams, or installed {% data variables.product.prodname_github_apps %} with `write` access to a repository. -リポジトリに対する管理者権限を持つ人{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}とアプリ{% endif %}は、保護されたブランチに常にプッシュできます。 +People and apps with admin permissions to a repository are always able to push to a protected branch. {% tip %} -**注釈:** [Include administrators] が選択されていて、ブランチでステータスチェック必須にしており、かつステータスチェックが失敗した場合は、管理者権限を持つ人{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}やアプリ{% endif %}であっても、保護されたブランチに変更をプッシュしようとすれば失敗することになります。 詳しい情報については、「[ステータスチェック必須の有効化](/articles/enabling-required-status-checks)」を参照してください。 +**Note:** If "Include administrators" is selected, you've enabled required status checks on the branch, and if any status checks fail, any attempt to push changes to the protected branch will also fail, even for people and apps with admin permissions. 詳しい情報については、「[ステータスチェック必須の有効化](/articles/enabling-required-status-checks)」を参照してください。 {% endtip %} diff --git a/translations/ja-JP/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md b/translations/ja-JP/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md index 29bb25a7b448..42a0a4f73a67 100644 --- a/translations/ja-JP/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md +++ b/translations/ja-JP/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md @@ -24,7 +24,7 @@ versions: - コミットの一部として変更されたファイル群 - コミットメッセージ -リポジトリへのプッシュに対して受け取るメール通知はフィルタリングできます。 詳細は、{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}「[通知を設定する](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#filtering-email-notifications){% else %}「[メール通知について](/github/receiving-notifications-about-activity-on-github/about-email-notifications)」を参照してください。 プッシュのメール通知を無効にすることもできます。 詳しい情報については、「[通知の配信方法を選択する](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications){% endif %}」を参照してください。 +リポジトリへのプッシュに対して受け取るメール通知はフィルタリングできます。 For more information, see {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#filtering-email-notifications){% else %}"[About notification emails](/github/receiving-notifications-about-activity-on-github/about-email-notifications)." プッシュのメール通知を無効にすることもできます。 詳しい情報については、「[通知の配信方法を選択する](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications){% endif %}」を参照してください。 ### リポジトリへのプッシュに対するメール通知の有効化 @@ -33,14 +33,13 @@ versions: {% data reusables.repositories.sidebar-notifications %} 5. 最大で 2 個まで、通知の送信先にしたいメールアドレスを空白で区切って入力します。 2 つを超える数のアカウントにメールを送信させたい場合は、メールアドレスの 1 つをグループメールアドレスにしてください。 ![メールアドレスのテキストボックス](/assets/images/help/settings/email_services_addresses.png) 6. 自分のサーバーを運用している場合は、**Secret** トークンでメールの整合性を検証できます。 このトークンは `Approved` ヘッダとしてメールとともに送信されます。 `Approved`ヘッダが、あなたが送信したトークンにマッチすれば、そのメールが {% data variables.product.product_name %} からのものであると信頼できます。 ![メールのシークレットテキストボックス](/assets/images/help/settings/email_services_token.png) -7. [**Send from author**] (作者から送信) を選択して、コミッターのメールアドレスを使ってメールを配信することもできます。 そうしない場合、メールの送信元は {% data variables.notifications.no_reply_address %}となります。 ![メール作成者のチェックボックス](/assets/images/help/settings/email_services_author.png) -8. **Save settings（設定の保存）**をクリックしてください。 ![設定保存のボタン](/assets/images/help/settings/save_notification_settings.png) +7. **Save settings（設定の保存）**をクリックしてください。 ![設定保存のボタン](/assets/images/help/settings/save_notification_settings.png) ### 参考リンク {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} - 「[通知について](/github/managing-subscriptions-and-notifications-on-github/about-notifications)」 {% else %} - 「[通知について](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/about-notifications)」 -- 「[通知の配信方法を選択する](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications)」 +- [通知の配信方法を選択する](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications) - 「[メール通知について](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/about-email-notifications)」 - 「[Web 通知について](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/about-web-notifications)」{% endif %} diff --git a/translations/ja-JP/content/github/administering-a-repository/about-github-dependabot-version-updates.md b/translations/ja-JP/content/github/administering-a-repository/about-github-dependabot-version-updates.md index 1289d815b7ff..0aff48b5e138 100644 --- a/translations/ja-JP/content/github/administering-a-repository/about-github-dependabot-version-updates.md +++ b/translations/ja-JP/content/github/administering-a-repository/about-github-dependabot-version-updates.md @@ -9,11 +9,13 @@ versions: {% data reusables.dependabot.beta-note %} -### {% data variables.product.prodname_dependabot_version_updates %}について +### {% data variables.product.prodname_dependabot_version_updates %} について {% data variables.product.prodname_dependabot %} は、依存関係を維持する手間を省きます。 これを使用して、リポジトリが依存するパッケージおよびアプリケーションの最新リリースに自動的に対応できるようにすることができます。 -{% data variables.product.prodname_dependabot_version_updates %} を有効にするには、リポジトリに設定ファイルをチェックインします。 設定ファイルでは、リポジトリに保存されているマニフェストまたは他のパッケージ定義ファイルの場所を指定します。 {% data variables.product.prodname_dependabot_short %} はこの情報を使用して、古いパッケージとアプリケーションをチェックします。 {% data variables.product.prodname_dependabot_short %} は、依存関係のセマンティックバージョニング（[semver](https://semver.org/)）を調べて、そのバージョンへの更新の必要性を判断することにより、依存関係の新しいバージョンの有無を決定します。 {% data variables.product.prodname_dependabot_short %} が古い依存関係を特定すると、プルリクエストを発行して、マニフェストを依存関係の最新バージョンに更新します。 テストに合格したことを確認し、プルリクエストの概要に含まれている変更履歴とリリースノートを確認して、マージします。 詳しい情報については、「[バージョン更新の有効化と無効化](/github/administering-a-repository/enabling-and-disabling-version-updates)」を参照してください。 +{% data variables.product.prodname_dependabot_version_updates %} を有効にするには、リポジトリに設定ファイルをチェックインします。 設定ファイルでは、リポジトリに保存されているマニフェストまたは他のパッケージ定義ファイルの場所を指定します。 {% data variables.product.prodname_dependabot_short %} はこの情報を使用して、古いパッケージとアプリケーションをチェックします。 {% data variables.product.prodname_dependabot_short %} は、依存関係のセマンティックバージョニング（[semver](https://semver.org/)）を調べて、そのバージョンへの更新の必要性を判断することにより、依存関係の新しいバージョンの有無を決定します。 For certain package managers, {% data variables.product.prodname_dependabot_version_updates %} also supports vendoring. Vendored (or cached) dependencies are dependencies that are checked in to a specific directory in a repository, rather than referenced in a manifest. Vendored dependencies are available at build time even if package servers are unavailable. {% data variables.product.prodname_dependabot_version_updates %} can be configured to check vendored dependencies for new versions and update them if necessary. + +{% data variables.product.prodname_dependabot_short %} が古い依存関係を特定すると、プルリクエストを発行して、マニフェストを依存関係の最新バージョンに更新します。 For vendored dependencies, {% data variables.product.prodname_dependabot_short %} raises a pull request to directly replace the outdated dependency with the new version. テストに合格したことを確認し、プルリクエストの概要に含まれている変更履歴とリリースノートを確認して、マージします。 詳しい情報については、「[バージョン更新の有効化と無効化](/github/administering-a-repository/enabling-and-disabling-version-updates)」を参照してください。 セキュリティアップデートを有効にすると、{% data variables.product.prodname_dependabot %} はプルリクエストを発行し、脆弱性のある依存関係を更新します。 詳しい情報については、「[{% data variables.product.prodname_dependabot_security_updates %} を設定する](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)」を参照してください。 @@ -35,7 +37,7 @@ versions: {% endnote %} -サポートされているパッケージマネージャーのいずれかの依存関係マニフェストまたはロックファイルを含むリポジトリのバージョン更新を設定できます。 +サポートされているパッケージマネージャーのいずれかの依存関係マニフェストまたはロックファイルを含むリポジトリのバージョン更新を設定できます。 For some package managers, you can also configure vendoring for dependencies. 詳しい情報については、「[依存関係の更新の設定オプション](/github/administering-a-repository/configuration-options-for-dependency-updates#vendor) 」を参照してください。 {% data reusables.dependabot.supported-package-managers %} diff --git a/translations/ja-JP/content/github/administering-a-repository/about-protected-branches.md b/translations/ja-JP/content/github/administering-a-repository/about-protected-branches.md index bfc34c229895..6541e0995f8a 100644 --- a/translations/ja-JP/content/github/administering-a-repository/about-protected-branches.md +++ b/translations/ja-JP/content/github/administering-a-repository/about-protected-branches.md @@ -1,6 +1,6 @@ --- title: 保護されたブランチについて -intro: 保護されたブランチは、リポジトリのコラボレーターが回復不能な変更をブランチに行えないようにしてくれます。 保護されたブランチを有効にすると、ステータスチェック必須やレビュー必須といった他のオプションのチェックや必須事項を有効にすることもできるようになります。 +intro: '保護されたブランチは、リポジトリのコラボレーターが回復不能な変更をブランチに行えないようにしてくれます。 保護されたブランチを有効にすると、ステータスチェック必須やレビュー必須といった他のオプションのチェックや必須事項を有効にすることもできるようになります。' product: '{% data reusables.gated-features.protected-branches %}' redirect_from: - /articles/about-protected-branches @@ -24,7 +24,7 @@ versions: ### ブランチの保護の設定 -リポジトリでブランチ保護ルールを作成する場合、コラボレータは{% if currentVersion == "free-pro-team@latest" %}デフォルトで{% endif %}保護されたブランチへフォースプッシュしたり、ブランチを削除したりすることはできません。 他のブランチ保護設定を有効にすることができます。 詳細については、「[プルリクエストのマージ可能性を定義](/github/administering-a-repository/defining-the-mergeability-of-pull-requests)」を参照してください。 +When you create a branch protection rule in a repository, collaborators cannot force push to the protected branch or delete the branch{% if currentVersion == "free-pro-team@latest" %} by default{% endif %}. 他のブランチ保護設定を有効にすることができます。 詳細については、「[プルリクエストのマージ可能性を定義](/github/administering-a-repository/defining-the-mergeability-of-pull-requests)」を参照してください。 ### 参考リンク diff --git a/translations/ja-JP/content/github/administering-a-repository/about-releases.md b/translations/ja-JP/content/github/administering-a-repository/about-releases.md index fc6903c1bcc7..330cd29c5049 100644 --- a/translations/ja-JP/content/github/administering-a-repository/about-releases.md +++ b/translations/ja-JP/content/github/administering-a-repository/about-releases.md @@ -1,6 +1,6 @@ --- title: リリースについて -intro: 他の人が使用できるようにソフトウェア、リリースノート、バイナリファイルへのリンクをパッケージしたリリースを作成できます。 +intro: '他の人が使用できるようにソフトウェア、リリースノート、バイナリファイルへのリンクをパッケージしたリリースを作成できます。' redirect_from: - /articles/downloading-files-from-the-command-line/ - /articles/downloading-files-with-curl/ @@ -20,16 +20,18 @@ versions: リリースは [Git タグ](https://git-scm.com/book/en/Git-Basics-Tagging)に基づきます。タグは、リポジトリの履歴の特定の地点をマークするものです。 タグの日付は異なる時点で作成できるため、リリースの日付とは異なる場合があります。 既存のタグの表示に関する詳細は「[リポジトリのリリースとタグを表示する](/github/administering-a-repository/viewing-your-repositorys-releases-and-tags)」を参照してください。 -リポジトリで新しいリリースが公開されたときに通知を受け取り、リポジトリで他の更新があったときには通知を受け取らないでいることができます。 詳しい情報については、{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}「[サブスクリプションを表示する](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions){% else %}「[リポジトリのリリースを Watch および Watch 解除する](/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-releases-for-a-repository){% endif %}」を参照してください。 +リポジトリで新しいリリースが公開されたときに通知を受け取り、リポジトリで他の更新があったときには通知を受け取らないでいることができます。 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 releases for a repository](/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-releases-for-a-repository){% endif %}." リポジトリへの読み取りアクセス権を持つ人はリリースを表示および比較できますが、リリースの管理はリポジトリへの書き込み権限を持つ人のみができます。 詳細は「[リポジトリのリリースを管理する](/github/administering-a-repository/managing-releases-in-a-repository)」を参照してください。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -リポジトリへの管理者権限を持つユーザは、{% data variables.large_files.product_name_long %}（{% data variables.large_files.product_name_short %}）オブジェクトを、{% data variables.product.product_name %} がリリースごとに作成する ZIP ファイルと tarball に含めるかどうかを選択できます。 詳しい情報については、「[リポジトリのアーカイブ内の {% data variables.large_files.product_name_short %} オブジェクトを管理する](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)」を参照してください。 +People with admin permissions to a repository can choose whether +{% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in the ZIP files and tarballs that {% data variables.product.product_name %} creates for each release. 詳しい情報については、「[リポジトリのアーカイブ内の {% data variables.large_files.product_name_short %} オブジェクトを管理する](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)」を参照してください。 {% endif %} {% if currentVersion == "free-pro-team@latest" %} -リリースでセキュリティの脆弱性が修正された場合は、リポジトリにセキュリティアドバイザリを公開する必要があります。 {% data variables.product.prodname_dotcom %} は公開された各セキュリティアドバイザリを確認し、それを使用して、影響を受けるリポジトリに {% data variables.product.prodname_dependabot_short %} アラートを送信できます。 詳しい情報については、「[GitHub セキュリティアドバイザリについて](/github/managing-security-vulnerabilities/about-github-security-advisories)」 を参照してください。 +リリースでセキュリティの脆弱性が修正された場合は、リポジトリにセキュリティアドバイザリを公開する必要があります。 +{% data variables.product.prodname_dotcom %} は公開された各セキュリティアドバイザリを確認し、それを使用して、影響を受けるリポジトリに {% data variables.product.prodname_dependabot_short %} アラートを送信できます。 詳しい情報については、「[GitHub セキュリティアドバイザリについて](/github/managing-security-vulnerabilities/about-github-security-advisories)」 を参照してください。 リポジトリ内のコードに依存しているリポジトリとパッケージを確認するために、依存関係グラフの [**依存関係**] タブを表示することができますが、それによって、新しいリリースの影響を受ける可能性があります。 詳しい情報については、「[依存関係グラフについて](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)」を参照してください。 {% endif %} diff --git a/translations/ja-JP/content/github/administering-a-repository/about-required-commit-signing.md b/translations/ja-JP/content/github/administering-a-repository/about-required-commit-signing.md index 21ba3b2e0223..97b5afd5b15c 100644 --- a/translations/ja-JP/content/github/administering-a-repository/about-required-commit-signing.md +++ b/translations/ja-JP/content/github/administering-a-repository/about-required-commit-signing.md @@ -11,9 +11,9 @@ versions: リポジトリでブランチ保護を強制している場合、必須コミット署名をセットアップできます。 詳しい情報については[保護されたブランチの設定](/articles/configuring-protected-branches/)を参照してください。 -ブランチで必須のコミット署名を有効にすると、コントリビュータ{% if currentVersion == "free-pro-team@latest" %}とボット{% endif %}はブランチに署名および検証されたコミットのみをプッシュできます。 詳細については、「[コミット署名の検証について](/articles/about-commit-signature-verification)」を参照してください。 +When you enable required commit signing on a branch, contibutors {% if currentVersion == "free-pro-team@latest" %}and bots{% endif %} can only push commits that have been signed and verified to the branch. 詳細については、「[コミット署名の検証について](/articles/about-commit-signature-verification)」を参照してください。 -コミットが署名および検証されている場合は、いつでもローカルコミットをブランチにプッシュできます。 {% if currentVersion == "free-pro-team@latest" %}{% data variables.product.product_name %}のプルリクエストを使用して、署名および検証されているコミットをブランチにマージすることもできます。 ただし、プルリクエストの作者でない限り、プルリクエストを squash して{% data variables.product.product_name %}のブランチにマージすることはできません。{% else %}ただし、プルリクエストを{% data variables.product.product_name %}のブランチにマージすることはできません。{% endif %}プルリクエストをローカルで{% if currentVersion == "free-pro-team@latest" %} squash および{% endif %}マージできます。 詳細については、「[プルリクエストをローカルでチェックアウトする](/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally)」を参照してください。{% if currentVersion == "free-pro-team@latest" %}マージ方法の詳細については、「[{% data variables.product.prodname_dotcom %}のマージ方法について](/github/administering-a-repository/about-merge-methods-on-github)」を参照してください。{% endif %} +コミットが署名および検証されている場合は、いつでもローカルコミットをブランチにプッシュできます。 {% if currentVersion == "free-pro-team@latest" %}You can also merge signed and verified commits into the branch using a pull request on {% data variables.product.product_name %}. However, you cannot squash and merge a pull request into the branch on {% data variables.product.product_name %} unless you are the author of the pull request.{% else %} However, you cannot merge pull requests into the branch on {% data variables.product.product_name %}.{% endif %} You can {% if currentVersion == "free-pro-team@latest" %}squash and {% endif %}merge pull requests locally. For more information, see "[Checking out pull requests locally](/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally)."{% if currentVersion == "free-pro-team@latest" %} For more information about merge methods, see "[About merge methods on {% data variables.product.prodname_dotcom %}](/github/administering-a-repository/about-merge-methods-on-github)."{% endif %} {% note %} diff --git a/translations/ja-JP/content/github/administering-a-repository/automation-for-release-forms-with-query-parameters.md b/translations/ja-JP/content/github/administering-a-repository/automation-for-release-forms-with-query-parameters.md index b5d6aea615cc..89c988b86b9f 100644 --- a/translations/ja-JP/content/github/administering-a-repository/automation-for-release-forms-with-query-parameters.md +++ b/translations/ja-JP/content/github/administering-a-repository/automation-for-release-forms-with-query-parameters.md @@ -1,6 +1,6 @@ --- title: クエリパラメータ付きのリリースフォームのための自動化 -intro: カスタマイズされた情報で新しいリリースフォームを自動的に展開することによってリリースを素早く作成するには、リリースフォームページの URL にクエリパラメータを追加できます。 +intro: 'カスタマイズされた情報で新しいリリースフォームを自動的に展開することによってリリースを素早く作成するには、リリースフォームページの URL にクエリパラメータを追加できます。' redirect_from: - /articles/automation-for-release-forms-with-query-parameters versions: diff --git a/translations/ja-JP/content/github/administering-a-repository/changing-the-default-branch.md b/translations/ja-JP/content/github/administering-a-repository/changing-the-default-branch.md new file mode 100644 index 000000000000..cae6ce3ea83d --- /dev/null +++ b/translations/ja-JP/content/github/administering-a-repository/changing-the-default-branch.md @@ -0,0 +1,53 @@ +--- +title: Changing the default branch +intro: 'If you have more than one branch in your repository, you can configure any branch as the default branch.' +permissions: People with admin permissions to a repository can change the default branch for the repository. +versions: + free-pro-team: '*' + enterprise-server: '*' +redirect_from: + - /github/administering-a-repository/setting-the-default-branch + - /articles/setting-the-default-branch +--- + +### About changing the default branch + +You can choose the default branch for a repository. The default branch is the base branch for pull requests and code commits. For more information about the default branch, see "[About branches](/github/collaborating-with-issues-and-pull-requests/about-branches#about-the-default-branch)." + +{% note %} + +**Note**: If you use the Git-Subversion bridge, changing the default branch will affect your `trunk` branch contents and the `HEAD` you see when you list references for the remote repository. For more information, see "[Support for Subversion clients](/github/importing-your-projects-to-github/support-for-subversion-clients)" and [git-ls-remote](https://git-scm.com/docs/git-ls-remote.html) in the Git documentation. + +{% endnote %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} + +{% data reusables.branches.set-default-branch %} + +{% endif %} + +### 必要な環境 + +To change the default branch, your repository must have more than one branch. 詳しい情報については[リポジトリ内でのブランチの作成と削除](/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository#creating-a-branch)を参照してください。 + +### Changing the default branch + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.repository-branches %} +1. Under "Default branch", to the right of the default branch name, click {% octicon "arrow-switch" aria-label="The switch icon with two arrows" %}. ![Switch icon with two arrows to the right of current default branch name](/assets/images/help/repository/repository-options-defaultbranch-change.png) +1. Use the drop-down, then click a branch name. ![Drop-down to choose new default branch](/assets/images/help/repository/repository-options-defaultbranch-drop-down.png) +1. [**Update**] をクリックします。 !["Update" button after choosing a new default branch](/assets/images/help/repository/repository-options-defaultbranch-update.png) +1. Read the warning, then click **I understand, update the default branch.** !["Update" button after choosing a new default branch](/assets/images/help/repository/repository-options-defaultbranch-i-understand.png) + +{% else %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.repository-branches %} +1. In the default branch drop-down, choose the new default branch. ![デフォルトブランチ ドロップダウン セレクター](/assets/images/help/repository/repository-options-defaultbranch.png) +1. [**Update**] をクリックします。 + +{% endif %} diff --git a/translations/ja-JP/content/github/administering-a-repository/classifying-your-repository-with-topics.md b/translations/ja-JP/content/github/administering-a-repository/classifying-your-repository-with-topics.md index 658986a78a06..1adf59df661f 100644 --- a/translations/ja-JP/content/github/administering-a-repository/classifying-your-repository-with-topics.md +++ b/translations/ja-JP/content/github/administering-a-repository/classifying-your-repository-with-topics.md @@ -1,6 +1,6 @@ --- -title: トピックでリポジトリを分類する -intro: あなたのプロジェクトを他の人が見つけて貢献しやすくするために、プロジェクトの目的、分野、主催グループなどの、リポジトリに関するトピックを追加できます。 +title: Classifying your repository with topics +intro: 'To help other people find and contribute to your project, you can add topics to your repository related to your project''s intended purpose, subject area, affinity groups, or other important qualities.' redirect_from: - /articles/about-topics/ - /articles/classifying-your-repository-with-topics @@ -9,30 +9,36 @@ versions: enterprise-server: '*' --- -### Topics について +### About topics -Topics を利用すれば、特定の領域に関するリポジトリを調べたり、コントリビュートするプロジェクトを見つけたり、特定の問題に対する新たなソリューションを見つけ出すことができます。 Topics は、リポジトリのメインページに表示されます。 Topics 名をクリックして、{% if currentVersion == "free-pro-team@latest" %}関連する Topics や、その Topics に分類される他のリポジトリのリストを見たりすることができます。{% else %}そのトピックの他のリポジトリを検索することができます。{% endif %} +With topics, you can explore repositories in a particular subject area, find projects to contribute to, and discover new solutions to a specific problem. Topics appear on the main page of a repository. You can click a topic name to {% if currentVersion == "free-pro-team@latest" %}see related topics and a list of other repositories classified with that topic{% else %}search for other repositories with that topic{% endif %}. -![Topics を表示しているテストリポジトリのメインページ](/assets/images/help/repository/os-repo-with-topics.png) +![Main page of the test repository showing topics](/assets/images/help/repository/os-repo-with-topics.png) -最も利用されているトピックをブラウズするには https://github.com/topics/ にアクセスしてください。 +To browse the most used topics, go to https://github.com/topics/. -{% if currentVersion == "free-pro-team@latest" %}[github/explore](https://github.com/github/explore) リポジトリにある {% data variables.product.product_name %}の注目の Topics 集にコントリビュートできます。 {% endif %} +{% if currentVersion == "free-pro-team@latest" %}You can contribute to {% data variables.product.product_name %}'s set of featured topics in the [github/explore](https://github.com/github/explore) repository. {% endif %} -リポジトリの管理者は、リポジトリに好きなトピックを追加できます。 リポジトリを分類するのに役立つトピックには、そのリポジトリの意図する目的、主題の領域、コミュニティ、言語などがあります。{% if currentVersion == "free-pro-team@latest" %}加えて、{% data variables.product.product_name %}はパブリックなリポジトリの内容を分析し、推奨されるトピックを生成します。リポジトリの管理者は、これを受諾することも拒否することもできます。 プライベートリポジトリの内容は分析されず、Topics が推奨されることはありません。{% endif %} +Repository admins can add any topics they'd like to a repository. Helpful topics to classify a repository include the repository's intended purpose, subject area, community, or language.{% if currentVersion == "free-pro-team@latest" %} Additionally, {% data variables.product.product_name %} analyzes public repository content and generates suggested topics that repository admins can accept or reject. Private repository content is not analyzed and does not receive topic suggestions.{% endif %} -パブリックリポジトリもプライベートリポジトリも Topics を持つことができますが、Topics の検索結果で見えるプライベートリポジトリはアクセス権を持っているものだけです。 +Public and private repositories can have topics, although you will only see private repositories that you have access to in topic search results. -特定のトピックに関連付けられているリポジトリを検索できます。 詳しい情報については[リポジトリの検索](/articles/searching-for-repositories#search-by-topic)を参照してください。 また、{% data variables.product.product_name %} 上でトピックのリストを検索することもできます。 詳細は「[トピックを検索する](/articles/searching-topics)」を参照してください。 +You can search for repositories that are associated with a particular topic. For more information, see "[Searching for repositories](/articles/searching-for-repositories#search-by-topic)." You can also search for a list of topics on {% data variables.product.product_name %}. For more information, see "[Searching topics](/articles/searching-topics)." -### Topics をリポジトリに追加する +### Adding topics to your repository {% data reusables.repositories.navigate-to-repo %}{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %} -2. リポジトリの説明の下にある [**Add topics**] をクリックします。 ![リポジトリのメインページにトピックリンクを追加](/assets/images/help/repository/add-topics-link.png) -3. リポジトリに追加したいトピックを入力してから、スペースを入力します。 ![トピックの入力フォーム](/assets/images/help/repository/add-topic-form.png) -4. トピックの追加が終わり次第、[**Done**] をクリックします。 ![トピックのリストと [Done] ボタンが表示されているフォーム](/assets/images/help/repository/add-topics-done-button.png) +2. Under your repository description, click **Add topics**. + ![Add topics link on a repository's main page](/assets/images/help/repository/add-topics-link.png) +3. Type the topic you want to add to your repository, then type a space. + ![Form to enter topics](/assets/images/help/repository/add-topic-form.png) +4. After you've finished adding topics, click **Done**. + ![Form with a list of topics and Done button](/assets/images/help/repository/add-topics-done-button.png) {% else %} -2. [About] の右にある {% octicon "gear" aria-label="The Gear icon" %} をクリックします。 ![リポジトリのメイン ページにある歯車アイコン](/assets/images/help/repository/edit-repository-details-gear.png) -3. [Topics] で、リポジトリに追加するトピックを入力してから、スペースを入力します。 ![トピックの入力フォーム](/assets/images/help/repository/add-topic-form.png) -4. トピックの追加が完了したら、[**Save changes**] をクリックします。 ![[Save changes] の [Edit repository details] ボタン](/assets/images/help/repository/edit-repository-details-save-changes-button.png) +2. To the right of "About", click {% octicon "gear" aria-label="The Gear icon" %}. + ![Gear icon on main page of a repository](/assets/images/help/repository/edit-repository-details-gear.png) +3. Under "Topics", type the topic you want to add to your repository, then type a space. + ![Form to enter topics](/assets/images/help/repository/add-topic-form.png) +4. After you've finished adding topics, click **Save changes**. + !["Save changes" button in "Edit repository details"](/assets/images/help/repository/edit-repository-details-save-changes-button.png) {% endif %} diff --git a/translations/ja-JP/content/github/administering-a-repository/configuration-options-for-dependency-updates.md b/translations/ja-JP/content/github/administering-a-repository/configuration-options-for-dependency-updates.md index 64c800b6b281..457904d90df9 100644 --- a/translations/ja-JP/content/github/administering-a-repository/configuration-options-for-dependency-updates.md +++ b/translations/ja-JP/content/github/administering-a-repository/configuration-options-for-dependency-updates.md @@ -18,32 +18,33 @@ versions: *dependabot.yml* ファイルは、`version: 2` で始まり、その後に `updates` の配列が続く形である必要があります。 -| Option | 必須 | 説明 | -|:-------------------------------------------------------------------------- |:-----:|:--------------------------- | -| [`package-ecosystem`](#package-ecosystem) | **X** | 使用するパッケージマネージャー | -| [`directory`](#directory) | **X** | パッケージマニフェストの場所 | -| [`schedule.interval`](#scheduleinterval) | **X** | 更新を確認する頻度 | -| [`allow`](#allow) | | 許可する更新をカスタマイズする | -| [`assignees`](#assignees) | | プルリクエストのアサイン担当者 | -| [`commit-message`](#commit-message) | | コミットメッセージの環境設定 | -| [`ignore`](#ignore) | | 特定の依存関係またはバージョンを無視する | -| [`labels`](#labels) | | プルリクエストに設定するラベル | -| [`マイルストーン`](#milestone) | | プルリクエストに設定するマイルストーン | -| [`open-pull-requests-limit`](#open-pull-requests-limit) | | バージョン更新時のオープンなプルリクエスト数を制限する | -| [`pull-request-branch-name.separator`](#pull-request-branch-nameseparator) | | プルリクエストブランチ名の区切り文字を変更する | -| [`rebase-strategy`](#rebase-strategy) | | 自動リベースを無効にする | -| [`reviewers`](#reviewers) | | プルリクエストのレビュー担当者 | -| [`schedule.day`](#scheduleday) | | 更新を確認する曜日 | -| [`schedule.time`](#scheduletime) | | 更新を確認する時刻 (hh:mm) | -| [`schedule.timezone`](#scheduletimezone) | | 時刻のタイムゾーン（ゾーン識別子） | -| [`target-branch`](#target-branch) | | プルリクエストを作成するブランチ | -| [`versioning-strategy`](#versioning-strategy) | | マニフェストのバージョン要件の更新方法 | +| Option | 必須 | 説明 | +|:-------------------------------------------------------------------------- |:-----:|:-------------------------------------- | +| [`package-ecosystem`](#package-ecosystem) | **X** | 使用するパッケージマネージャー | +| [`directory`](#directory) | **X** | パッケージマニフェストの場所 | +| [`schedule.interval`](#scheduleinterval) | **X** | 更新を確認する頻度 | +| [`allow`](#allow) | | 許可する更新をカスタマイズする | +| [`assignees`](#assignees) | | プルリクエストのアサイン担当者 | +| [`commit-message`](#commit-message) | | コミットメッセージの環境設定 | +| [`ignore`](#ignore) | | 特定の依存関係またはバージョンを無視する | +| [`labels`](#labels) | | プルリクエストに設定するラベル | +| [`マイルストーン`](#milestone) | | プルリクエストに設定するマイルストーン | +| [`open-pull-requests-limit`](#open-pull-requests-limit) | | バージョン更新時のオープンなプルリクエスト数を制限する | +| [`pull-request-branch-name.separator`](#pull-request-branch-nameseparator) | | プルリクエストブランチ名の区切り文字を変更する | +| [`rebase-strategy`](#rebase-strategy) | | 自動リベースを無効にする | +| [`reviewers`](#reviewers) | | プルリクエストのレビュー担当者 | +| [`schedule.day`](#scheduleday) | | 更新を確認する曜日 | +| [`schedule.time`](#scheduletime) | | 更新を確認する時刻 (hh:mm) | +| [`schedule.timezone`](#scheduletimezone) | | 時刻のタイムゾーン（ゾーン識別子） | +| [`target-branch`](#target-branch) | | プルリクエストを作成するブランチ | +| [`vendor`](#vendor) | | Update vendored or cached dependencies | +| [`versioning-strategy`](#versioning-strategy) | | マニフェストのバージョン要件の更新方法 | これらのオプションは、次のようなカテゴリに幅広く適合しています。 - すべての設定に含める必要がある必須のセットアップオプション: [`package-ecosystem`](#package-ecosystem)、 [`directory`](#directory)、[`schedule.interval`](#scheduleinterval) - 更新スケジュールをカスタマイズするためのオプション: [`schedule.time`](#scheduletime)、[`schedule.timezone`](#scheduletimezone)、 [`schedule.day`](#scheduleday) -- 更新する依存関係を制御するオプション: [`allow`](#allow)、[`ignore`](#ignore) +- Options to control which dependencies are updated: [`allow`](#allow), [`ignore`](#ignore), [`vendor`](#vendor). - プルリクエストにメタデータを追加するオプション: [`reviewers`](#reviewers)、[`assignees`](#assignees)、[`labels`](#labels)、 [`milestone`](#milestone) - プルリクエストの動作を変更するオプション: [`target-branch`](#target-branch)、[`versioning-strategy`](#versioning-strategy)、[`commit-message`](#commit-message)、[`rebase-strategy`](#rebase-strategy)、[`pull-request-branch-name.separator`](#pull-request-branch-nameseparator) @@ -61,7 +62,7 @@ versions: ### `package-ecosystem` -**必須** {% data variables.product.prodname_dependabot %} で新しいバージョンを監視するパッケージマネージャーごとに、`package-ecosystem` 要素を1つ追加してください。 リポジトリには、これらの各パッケージマネージャーの依存関係マニフェストまたはロックファイルも含まれている必要があります。 +**必須** {% data variables.product.prodname_dependabot %} で新しいバージョンを監視するパッケージマネージャーごとに、`package-ecosystem` 要素を1つ追加してください。 リポジトリには、これらの各パッケージマネージャーの依存関係マニフェストまたはロックファイルも含まれている必要があります。 If you want to enable vendoring for a package manager that supports it, the vendored dependencies must be located in the required directory. For more information, see [`vendor`](#vendor) below. {% data reusables.dependabot.supported-package-managers %} @@ -539,6 +540,31 @@ updates: - "npm dependencies" ``` +### `vendor` + +Use the `vendor` option to tell {% data variables.product.prodname_dependabot_short %} to vendor dependencies when updating them. + +{% note %} + +Currently, {% data variables.product.prodname_dependabot_short %} only supports vendoring dependencies for Bundler. + +{% endnote %} + +```yaml +# Configure version updates for both dependencies defined in manifests and vendored dependencies + +version: 2 +updates: + - package-ecosystem: "bundler" + # Raise pull requests to update vendored dependencies that are checked in to the repository + vendor: true + directory: "/" + schedule: + interval: "weekly" +``` + +{% data variables.product.prodname_dependabot_short %} only updates the vendored dependencies located in specific directories in a repository. For Bundler, the dependencies must be in the _vendor/cache_ directory. Other file paths are not supported. For more information, see the [`bundle cache` documentation](https://bundler.io/man/bundle-cache.1.html). + ### `versioning-strategy` {% data variables.product.prodname_dependabot %} がマニフェストファイルを編集してバージョンを更新する場合、次の全体的な戦略を使用します。 diff --git a/translations/ja-JP/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md b/translations/ja-JP/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md index 5112171236a4..27a572a51499 100644 --- a/translations/ja-JP/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md +++ b/translations/ja-JP/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md @@ -6,7 +6,7 @@ redirect_from: - /articles/configuring-autolinks-to-reference-external-resources versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- Anyone with admin permissions to a repository can configure autolink references to link issues, pull requests,{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} commit messages, and release descriptions{% else %} and commit messages{% endif %} to external third-party services. diff --git a/translations/ja-JP/content/github/administering-a-repository/configuring-protected-branches.md b/translations/ja-JP/content/github/administering-a-repository/configuring-protected-branches.md index fa67c353e9f8..a373fc1ffe6a 100644 --- a/translations/ja-JP/content/github/administering-a-repository/configuring-protected-branches.md +++ b/translations/ja-JP/content/github/administering-a-repository/configuring-protected-branches.md @@ -1,6 +1,6 @@ --- title: 保護されたブランチを設定する -intro: リポジトリのオーナーか、リポジトリの管理者権限がある場合、リポジトリのブランチ保護をカスタマイズし、2 つ以上のプルリクエストレビューを要求したり、プルリクエストのマージを許可する前に特定のステータスチェックを必須としたりするなど、特定のワークフローを強制できます。 +intro: 'リポジトリのオーナーか、リポジトリの管理者権限がある場合、リポジトリのブランチ保護をカスタマイズし、2 つ以上のプルリクエストレビューを要求したり、プルリクエストのマージを許可する前に特定のステータスチェックを必須としたりするなど、特定のワークフローを強制できます。' product: '{% data reusables.gated-features.protected-branches %}' redirect_from: - /articles/configuring-protected-branches diff --git a/translations/ja-JP/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md b/translations/ja-JP/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md new file mode 100644 index 000000000000..c759845dad4e --- /dev/null +++ b/translations/ja-JP/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md @@ -0,0 +1,18 @@ +--- +title: Configuring the retention period for GitHub Actions artifacts and logs in your repository +intro: 'You can configure the retention period for {% data variables.product.prodname_actions %} artifacts and logs in your repository.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.23' +--- + +{% data reusables.actions.about-artifact-log-retention %} + +You can also define a custom retention period for a specific artifact created by a workflow. For more information, see "[Setting the retention period for an artifact](/actions/managing-workflow-runs/removing-workflow-artifacts#setting-the-retention-period-for-an-artifact)." + +## Setting the retention period for a repository + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.settings-sidebar-actions %} +{% data reusables.github-actions.change-retention-period-for-artifacts-logs %} diff --git a/translations/ja-JP/content/github/administering-a-repository/customizing-how-changed-files-appear-on-github.md b/translations/ja-JP/content/github/administering-a-repository/customizing-how-changed-files-appear-on-github.md index 906bbbe60a70..adee079b0f0f 100644 --- a/translations/ja-JP/content/github/administering-a-repository/customizing-how-changed-files-appear-on-github.md +++ b/translations/ja-JP/content/github/administering-a-repository/customizing-how-changed-files-appear-on-github.md @@ -1,6 +1,6 @@ --- title: 変更したファイルの GitHub での表示方法をカスタマイズする -intro: 特定のファイルをデフォルトで diff に表示しない、またはリポジトリの言語として考えないようにするために、 *.gitattributes* ファイルで `linguist-generated` 属性を使ってマークできます。 +intro: '特定のファイルをデフォルトで diff に表示しない、またはリポジトリの言語として考えないようにするために、 *.gitattributes* ファイルで `linguist-generated` 属性を使ってマークできます。' redirect_from: - /articles/customizing-how-changed-files-appear-on-github versions: diff --git a/translations/ja-JP/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md b/translations/ja-JP/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md index bd9308f33dd5..8e557081edb4 100644 --- a/translations/ja-JP/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md +++ b/translations/ja-JP/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md @@ -5,7 +5,7 @@ redirect_from: - /articles/customizing-your-repositorys-social-media-preview versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- 画像を追加するまでは、リポジトリへのリンクは、リポジトリの基本的な情報とオーナーのアバターを表示します。 リポジトリに画像を追加すると、さまざまなソーシャルプラットフォーム上で、あなたのプロジェクトが見つかりやすくなります。 diff --git a/translations/ja-JP/content/github/administering-a-repository/defining-the-mergeability-of-pull-requests.md b/translations/ja-JP/content/github/administering-a-repository/defining-the-mergeability-of-pull-requests.md index f9485e5aff97..ba7d34a00936 100644 --- a/translations/ja-JP/content/github/administering-a-repository/defining-the-mergeability-of-pull-requests.md +++ b/translations/ja-JP/content/github/administering-a-repository/defining-the-mergeability-of-pull-requests.md @@ -1,6 +1,6 @@ --- title: プルリクエストのマージ可能性を定義 -intro: プルリクエストをマージ可能にするための条件として、一連のチェックに合格することを必須とすることができます。 たとえば、ステータスチェックに合格しないプルリクエストをブロックすることができます。あるいは、プルリクエストを承認するレビューが一定数に達していなければマージできないようにすることができます。 +intro: 'プルリクエストをマージ可能にするための条件として、一連のチェックに合格することを必須とすることができます。 たとえば、ステータスチェックに合格しないプルリクエストをブロックすることができます。あるいは、プルリクエストを承認するレビューが一定数に達していなければマージできないようにすることができます。' redirect_from: - /articles/defining-the-mergeability-of-a-pull-request/ - /articles/defining-the-mergeability-of-pull-requests diff --git a/translations/ja-JP/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md b/translations/ja-JP/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md index 6aca47b97e1d..cdbf1c784d2a 100644 --- a/translations/ja-JP/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md +++ b/translations/ja-JP/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md @@ -1,6 +1,6 @@ --- title: プルリクエスト中のブランチの削除と復元 -intro: リポジトリでの書き込みアクセスがある場合、クローズまたはマージされたプルリクエストに関連付けられているブランチを削除できます。 オープンなプルリクエストに関連付けられているブランチは削除できません。 +intro: 'リポジトリでの書き込みアクセスがある場合、クローズまたはマージされたプルリクエストに関連付けられているブランチを削除できます。 オープンなプルリクエストに関連付けられているブランチは削除できません。' redirect_from: - /articles/tidying-up-pull-requests/ - /articles/restoring-branches-in-a-pull-request/ @@ -35,6 +35,5 @@ versions: ### 参考リンク -- 「[リポジトリ内でのブランチの作成と削除](/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository)」{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} +- 「[リポジトリ内でのブランチの作成と削除](/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository)」 - 「[ブランチの自動削除の管理](/github/administering-a-repository/managing-the-automatic-deletion-of-branches)」 -{% endif %} diff --git a/translations/ja-JP/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md b/translations/ja-JP/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md index 79f5a427bbee..386a75c9e0a5 100644 --- a/translations/ja-JP/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md +++ b/translations/ja-JP/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md @@ -6,22 +6,24 @@ versions: enterprise-server: '>=2.22' --- -{% data reusables.actions.enterprise-beta %} +{% data variables.product.prodname_actions %} の支払いを管理する {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 ### リポジトリの {% data variables.product.prodname_actions %} 権限について -{% data reusables.github-actions.disabling-github-actions %} {% data variables.product.prodname_actions %} について詳しくは、「[{% data variables.product.prodname_actions %} について](/actions/getting-started-with-github-actions/about-github-actions)」を参照してください。 +{% data reusables.github-actions.disabling-github-actions %} {% data variables.product.prodname_actions %} の詳細は、「[{% data variables.product.prodname_actions %}について](/actions/getting-started-with-github-actions/about-github-actions)」を参照してください。 リポジトリで {% data variables.product.prodname_actions %} を有効化できます。 {% data reusables.github-actions.enabled-actions-description %} リポジトリの {% data variables.product.prodname_actions %} を完全に無効化することができます。 {% data reusables.github-actions.disabled-actions-description %} または、リポジトリで {% data variables.product.prodname_actions %} を有効化して、ワークフローで実行できるアクションを制限することもできます。 {% data reusables.github-actions.enabled-local-github-actions %} +{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.23" %} + ### リポジトリの {% data variables.product.prodname_actions %} 権限を管理する {% note %} -**注釈:** Organization に優先ポリシーがあるか、優先ポリシーのある Enterprise アカウントによって管理されている場合、これらの設定を管理できない場合があります。 詳しい情報については、「[Organization での {% data variables.product.prodname_actions %} の無効化もしくは制限](/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization)」または「[Enterprise アカウントで {% data variables.product.prodname_actions %} のポリシーを施行する](/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account)」を参照してください。 +**注釈:** Organization に優先ポリシーがあるか、優先ポリシーのある Enterprise アカウントによって管理されている場合、これらの設定を管理できない場合があります。 For more information, see "[Disabling or limiting {% data variables.product.prodname_actions %} for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization)" or {% if currentVersion == "free-pro-team@latest" %}"[Enforcing {% data variables.product.prodname_actions %} policies in your enterprise account](/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account)."{% else if currentVersion ver_gt "enterprise-server@2.21"%}"[Enforcing {% data variables.product.prodname_actions %} policies for your enterprise](/enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise)."{% endif %} {% endnote %} @@ -30,6 +32,41 @@ versions: {% data reusables.repositories.settings-sidebar-actions %} 4. [Actions permissions] で、オプションを選択します。 ![このリポジトリのアクションを有効化、無効化、または制限する](/assets/images/help/repository/enable-repo-actions.png) +{% endif %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} + +### リポジトリの {% data variables.product.prodname_actions %} 権限を管理する + +You can disable all workflows for a repository or set a policy that configures which actions can be used in a repository. + +{% data reusables.actions.actions-use-policy-settings %} + +{% note %} + +**注釈:** Organization に優先ポリシーがあるか、優先ポリシーのある Enterprise アカウントによって管理されている場合、これらの設定を管理できない場合があります。 For more information, see "[Disabling or limiting {% data variables.product.prodname_actions %} for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization)" or {% if currentVersion == "free-pro-team@latest" %}"[Enforcing {% data variables.product.prodname_actions %} policies in your enterprise account](/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account)."{% else if currentVersion ver_gt "enterprise-server@2.21" %}"[Enforcing {% data variables.product.prodname_actions %} policies for your enterprise](/enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise)." + +{% endif %} + +{% endnote %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.settings-sidebar-actions %} +1. Under **Actions permissions**, select an option. ![Set actions policy for this organization](/assets/images/help/repository/actions-policy.png) +1. [**Save**] をクリックします。 + +### Allowing specific actions to run + +{% data reusables.actions.allow-specific-actions-intro %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.settings-sidebar-actions %} +1. Under **Actions permissions**, select **Allow specific actions** and add your required actions to the list. ![Add actions to allow list](/assets/images/help/repository/actions-policy-allow-list.png) +2. [**Save**] をクリックします。 +{% endif %} + {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} ### プライベートリポジトリのフォークのワークフローを有効にする diff --git a/translations/ja-JP/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md b/translations/ja-JP/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md index 21f00070d151..d14568790bb9 100644 --- a/translations/ja-JP/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md +++ b/translations/ja-JP/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md @@ -14,18 +14,18 @@ versions: 外部の資金獲得プラットフォームごとに 1 つのユーザ名、パッケージ名、またはプロジェクト名と、最大 4 つのカスタム URL を追加できます。 {% data variables.product.prodname_sponsors %} には、スポンサード開発者または Organization を最大 4 人追加できます。 追加する場合は、プラットフォームごとに改行し、以下の構文に従ってください: -| プラットフォーム | 構文 | -| ---------------------------------------------------------------------------------- | ---------------------------------------------------------- | -| [CommunityBridge](https://communitybridge.org) | `community_bridge: プロジェクト名` | +| プラットフォーム | 構文 | +| ----------------------------------------------------------------------------- | ---------------------------------------------------------- | +| [CommunityBridge](https://communitybridge.org) | `community_bridge: プロジェクト名` | | [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors) | `github: ユーザ名` または `github: [ユーザ名, ユーザ名, ユーザ名, ユーザ名]` | -| [IssueHunt](https://issuehunt.io/) | `issuehunt: ユーザ名` | -| [Ko-fi](https://ko-fi.com/) | `ko_fi: ユーザ名` | -| [Liberapay](https://en.liberapay.com/) | `liberapay: ユーザ名` | -| [Open Collective](https://opencollective.com/) | `open_collective: ユーザ名` | -| [Otechie](https://otechie.com/) | `otechie: ユーザ名` | -| [Patreon](https://www.patreon.com/) | `patreon: ユーザ名` | -| [Tidelift](https://tidelift.com/) | `tidelift: プラットフォーム名/パッケージ名` | -| カスタム URL | `custom: リンク 1` または `custom: [リンク 1, リンク 2, リンク 3, リンク 4]` | +| [IssueHunt](https://issuehunt.io/) | `issuehunt: ユーザ名` | +| [Ko-fi](https://ko-fi.com/) | `ko_fi: ユーザ名` | +| [Liberapay](https://en.liberapay.com/) | `liberapay: ユーザ名` | +| [Open Collective](https://opencollective.com/) | `open_collective: ユーザ名` | +| [Otechie](https://otechie.com/) | `otechie: ユーザ名` | +| [Patreon](https://www.patreon.com/) | `patreon: ユーザ名` | +| [Tidelift](https://tidelift.com/) | `tidelift: プラットフォーム名/パッケージ名` | +| カスタム URL | `custom: リンク 1` または `custom: [リンク 1, リンク 2, リンク 3, リンク 4]` | Tidelift では、`platform-name/package-name` の構文で、以下のプラットフォーム名を用います: diff --git a/translations/ja-JP/content/github/administering-a-repository/enabling-and-disabling-version-updates.md b/translations/ja-JP/content/github/administering-a-repository/enabling-and-disabling-version-updates.md index d0e53d4c8bc1..154a99bab990 100644 --- a/translations/ja-JP/content/github/administering-a-repository/enabling-and-disabling-version-updates.md +++ b/translations/ja-JP/content/github/administering-a-repository/enabling-and-disabling-version-updates.md @@ -14,7 +14,7 @@ versions: {% data reusables.dependabot.initial-updates %} 詳しい情報については、「[依存関係の更新をカスタマイズする](/github/administering-a-repository/customizing-dependency-updates)」をご覧ください。 -### {% data variables.product.prodname_dependabot_version_updates %} の有効化 +### Enabling {% data variables.product.prodname_dependabot_version_updates %} {% note %} diff --git a/translations/ja-JP/content/github/administering-a-repository/enabling-anonymous-git-read-access-for-a-repository.md b/translations/ja-JP/content/github/administering-a-repository/enabling-anonymous-git-read-access-for-a-repository.md index 5b67381b2afd..f54b8182c6c2 100644 --- a/translations/ja-JP/content/github/administering-a-repository/enabling-anonymous-git-read-access-for-a-repository.md +++ b/translations/ja-JP/content/github/administering-a-repository/enabling-anonymous-git-read-access-for-a-repository.md @@ -1,6 +1,6 @@ --- title: リポジトリに対する匿名 Git 読み取りアクセスを有効化する -intro: リポジトリの管理者として、特定の要件を満たす公開リポジトリの匿名 Git 読み取りアクセスを有効または無効にできます。 +intro: 'リポジトリの管理者として、特定の要件を満たす公開リポジトリの匿名 Git 読み取りアクセスを有効または無効にできます。' redirect_from: - /articles/enabling-anonymous-git-read-access-for-a-repository versions: diff --git a/translations/ja-JP/content/github/administering-a-repository/enabling-branch-restrictions.md b/translations/ja-JP/content/github/administering-a-repository/enabling-branch-restrictions.md index 9f86904ffbb6..f4f51c8aeece 100644 --- a/translations/ja-JP/content/github/administering-a-repository/enabling-branch-restrictions.md +++ b/translations/ja-JP/content/github/administering-a-repository/enabling-branch-restrictions.md @@ -1,6 +1,6 @@ --- title: ブランチ制限の有効化 -intro: 'ブランチ制限を有効化している場合、特定のユーザ{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}、{% else %}または{% endif %}チーム{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}、またはアプリ{% endif %}のみが、Organization が所有するリポジトリの保護されたブランチにプッシュできます。' +intro: 'You can enforce branch restrictions so that only certain users{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %} or{% endif %} teams{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, or apps{% endif %} can push to a protected branch in repositories owned by your organization.' product: '{% data reusables.gated-features.branch-restrictions %}' redirect_from: - /articles/enabling-branch-restrictions @@ -19,7 +19,7 @@ Organization 所有のリポジトリに対する管理者権限があるユー {% data reusables.repositories.add-branch-protection-rules %} {% data reusables.repositories.include-administrators %} 6. [Protect matching branches] で、[**Restrict who can push to matching branches**] を選択します。 ![ブランチ制限のチェックボックス](/assets/images/help/repository/restrict-branch.png) -8. 保護されたブランチにプッシュできる権限を持つ人{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}、{% else %}または{% endif %}チーム{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}、またはアプリ{% endif %}を検索し、選択します。 ![ブランチ制限の検索](/assets/images/help/repository/restrict-branch-search.png) +8. Search for and select the people, teams, or apps who will have permission to push to the protected branch. ![ブランチ制限の検索](/assets/images/help/repository/restrict-branch-search.png) 9. ** Create（作成）**をクリックしてください。 ### 参考リンク diff --git a/translations/ja-JP/content/github/administering-a-repository/enabling-force-pushes-to-a-protected-branch.md b/translations/ja-JP/content/github/administering-a-repository/enabling-force-pushes-to-a-protected-branch.md index da9e1ec6c69b..3cb9b4f7ebf3 100644 --- a/translations/ja-JP/content/github/administering-a-repository/enabling-force-pushes-to-a-protected-branch.md +++ b/translations/ja-JP/content/github/administering-a-repository/enabling-force-pushes-to-a-protected-branch.md @@ -1,31 +1,32 @@ --- -title: 保護されたブランチへのフォースプッシュを有効化する -intro: 保護されたブランチへのフォースプッシュを有効化することができます。 +title: Enabling force pushes to a protected branch +intro: You can allow force pushes to a protected branch. product: '{% data reusables.gated-features.protected-branches %}' versions: free-pro-team: '*' enterprise-server: '>=2.20' --- -リポジトリに対する管理者権限があるユーザは、フォースプッシュを有効化できます。 +Anyone with admin permissions to a repository can enable force pushes. -### 保護されたブランチへのフォースプッシュについて +### About force pushes to protected branches -デフォルトでは、フォースプッシュはすべての保護されたブランチでブロックされます。 保護されたブランチのフォースプッシュを有効にすると、少なくともリポジトリへの書き込み権限を持つユーザは、管理者権限を持つブランチを含め、ブランチをフォースプッシュできます。 +By default, force pushes are blocked on all protected branches. When you enable force pushes to a protected branch, anyone with at least write permissions to the repository can force push to the branch, including those with admin permissions. -フォースプッシュを有効化しても、他のブランチ保護ルールは上書きされません。 たとえば、ブランチに直線状のコミット履歴が必要な場合、そのブランチにマージコミットをフォースプッシュすることはできません。 +Enabling force pushes will not override any other branch protection rules. For example, if a branch requires a linear commit history, you cannot force push merge commits to that branch. -{% if currentVersion != "free-pro-team@latest" %}サイト管理者がリポジトリ内のすべてのブランチへのフォースプッシュをブロックしている場合、保護されたブランチのフォースプッシュを有効にすることはできません。 詳しい情報については、「[ユーザアカウントもしくはOrganizationが所有するリポジトリへのフォースプッシュのブロック](/enterprise/{{ currentVersion }}/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization)」を参照してください。 +{% if currentVersion != "free-pro-team@latest" %}You cannot enable force pushes for a protected branch if a site administrator has blocked force pushes to all branches in your repository. For more information, see "[Blocking force pushes to repositories owned by a user account or organization](/enterprise/{{ currentVersion }}/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization)." -サイト管理者がデフォルトブランチへのフォースプッシュのみをブロックしている場合、他の保護されたブランチに対してフォースプッシュを有効にできます。{% endif %} +If a site administrator has blocked force pushes to the default branch only, you can still enable force pushes for any other protected branch.{% endif %} {% data reusables.repositories.protected-branches-options %} -### フォースプッシュの有効化 +### Enabling force pushes {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.repositories.repository-branches %} {% data reusables.repositories.add-branch-protection-rules %} -6. [Rules applied to everyone including administrators] で、 [**Allow force pushes**] を選択します。 ![フォースプッシュオプションを許可する](/assets/images/help/repository/allow-force-pushes.png) -7. ** Create（作成）**をクリックしてください。 +6. Under "Rules applied to everyone including administrators", select **Allow force pushes**. +![Allow force pushes option](/assets/images/help/repository/allow-force-pushes.png) +7. Click **Create**. diff --git a/translations/ja-JP/content/github/administering-a-repository/index.md b/translations/ja-JP/content/github/administering-a-repository/index.md index 9290418e4ff9..a918fbf189ce 100644 --- a/translations/ja-JP/content/github/administering-a-repository/index.md +++ b/translations/ja-JP/content/github/administering-a-repository/index.md @@ -27,6 +27,7 @@ versions: {% link_in_list /managing-the-forking-policy-for-your-repository %} + {% link_in_list /setting-the-default-branch %} {% link_in_list /disabling-or-limiting-github-actions-for-a-repository %} {% link_in_list /managing-git-lfs-objects-in-archives-of-your-repository %} {% link_in_list /enabling-anonymous-git-read-access-for-a-repository %} @@ -41,8 +42,8 @@ versions: {% link_in_list /restoring-a-deleted-repository %} {% topic_link_in_list /managing-branches-in-your-repository %} - {% link_in_list /setting-the-default-branch %} {% link_in_list /viewing-branches-in-your-repository %} + {% link_in_list /changing-the-default-branch %} {% link_in_list /deleting-and-restoring-branches-in-a-pull-request %} {% topic_link_in_list /configuring-pull-request-merges %} {% link_in_list /about-merge-methods-on-github %} diff --git a/translations/ja-JP/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot.md b/translations/ja-JP/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot.md index 359f87ce322c..133389b8a287 100644 --- a/translations/ja-JP/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot.md +++ b/translations/ja-JP/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot.md @@ -9,7 +9,7 @@ versions: ### {% data variables.product.prodname_dependabot_version_updates %} のアクションについて -多くの場合、アクションはバグ修正と新機能で更新され、自動プロセスの信頼性、速度、安全性が向上しています。 {% data variables.product.prodname_actions %} に対して {% data variables.product.prodname_dependabot_version_updates %} を有効にすると、{% data variables.product.prodname_dependabot %} は、リポジトリの *workflow.yml* ファイル内のアクションへのリファレンスが最新の状態に保たれるようにします。 {% data variables.product.prodname_dependabot_short %} は、ファイル内のアクションごとに、アクションのリファレンス（通常、アクションに関連付けられているバージョン番号またはコミット ID）を最新バージョンと照合します。 より新しいバージョンのアクションが使用可能な場合、{% data variables.product.prodname_dependabot_short %} は、ワークフローファイル内のリファレンスを最新バージョンに更新するプルリクエストを送信します。 {% data variables.product.prodname_dependabot_version_updates %} の詳細については、「[{% data variables.product.prodname_dependabot_version_updates %} について](/github/administering-a-repository/about-github-dependabot-version-updates)」を参照してください。 {% data variables.product.prodname_actions %} のワークフローの設定について詳しくは、「[ワークフローを設定する](/actions/configuring-and-managing-workflows/configuring-a-workflow)」を参照してください。 +多くの場合、アクションはバグ修正と新機能で更新され、自動プロセスの信頼性、速度、安全性が向上しています。 {% data variables.product.prodname_actions %} に対して {% data variables.product.prodname_dependabot_version_updates %} を有効にすると、{% data variables.product.prodname_dependabot %} は、リポジトリの *workflow.yml* ファイル内のアクションへのリファレンスが最新の状態に保たれるようにします。 {% data variables.product.prodname_dependabot_short %} は、ファイル内のアクションごとに、アクションのリファレンス（通常、アクションに関連付けられているバージョン番号またはコミット ID）を最新バージョンと照合します。 より新しいバージョンのアクションが使用可能な場合、{% data variables.product.prodname_dependabot_short %} は、ワークフローファイル内のリファレンスを最新バージョンに更新するプルリクエストを送信します。 {% data variables.product.prodname_dependabot_version_updates %} の詳細については、「[{% data variables.product.prodname_dependabot_version_updates %} について](/github/administering-a-repository/about-github-dependabot-version-updates)」を参照してください。 For more information about configuring workflows for {% data variables.product.prodname_actions %}, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." ### {% data variables.product.prodname_dependabot_version_updates %} のアクションを有効化する diff --git a/translations/ja-JP/content/github/administering-a-repository/managing-releases-in-a-repository.md b/translations/ja-JP/content/github/administering-a-repository/managing-releases-in-a-repository.md index 562e54742b5f..0282b6f68f1c 100644 --- a/translations/ja-JP/content/github/administering-a-repository/managing-releases-in-a-repository.md +++ b/translations/ja-JP/content/github/administering-a-repository/managing-releases-in-a-repository.md @@ -8,7 +8,7 @@ redirect_from: - /articles/managing-releases-in-a-repository - /github/administering-a-repository/creating-releases - /github/administering-a-repository/editing-and-deleting-releases -permissions: リポジトリのコラボレータと、リポジトリへの書き込みアクセスを持つ人は、リリースを作成、編集、削除できます。 +permissions: 'リポジトリのコラボレータと、リポジトリへの書き込みアクセスを持つ人は、リリースを作成、編集、削除できます。' versions: free-pro-team: '*' enterprise-server: '*' @@ -16,10 +16,11 @@ versions: ### リリース管理について -特定のリリースのアクションを {% data variables.product.prodname_marketplace %} で公開することもできます。 詳しい情報については、「[アクションを {% data variables.product.prodname_marketplace %} で公開する](/actions/creating-actions/publishing-actions-in-github-marketplace)」を参照してください。 +特定のリリースのアクションを {% data variables.product.prodname_marketplace %} で公開することもできます。 詳しい情報については、「アクションを {% data variables.product.prodname_marketplace %} で公開する」を参照してください。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -{% data variables.large_files.product_name_long %}（{% data variables.large_files.product_name_short %}）オブジェクトを、{% data variables.product.product_name %} がリリースごとに作成する ZIP ファイルと tarball に含めるかどうかを選択できます。 詳しい情報については、「[リポジトリのアーカイブ内の {% data variables.large_files.product_name_short %} オブジェクトを管理する](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)」を参照してください。 +You can choose whether +{% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in the ZIP files and tarballs that {% data variables.product.product_name %} creates for each release. 詳しい情報については、「[リポジトリのアーカイブ内の {% data variables.large_files.product_name_short %} オブジェクトを管理する](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)」を参照してください。 {% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} @@ -42,7 +43,7 @@ versions: 8. リリースが不安定であり、運用準備ができていないことをユーザに通知するには、[**This is a pre-release**] を選択します。 ![リリースをプレリリースとしてマークするチェックボックス](/assets/images/help/releases/prerelease_checkbox.png) 9. リリースを公開する準備ができている場合は、[**Publish release**] をクリックします。 リリースの作業を後でする場合は、[**Save draft**] をクリックします。 ![[Publish release] と [Save draft] ボタン](/assets/images/help/releases/release_buttons.png) -コマンドラインから、またはスクリプトでリリースを自動的に作成することもできます。 詳しい情報については、「[リリース](/v3/repos/releases/#create-a-release)」を参照してください。 +コマンドラインから、またはスクリプトでリリースを自動的に作成することもできます。 詳しい情報については、「[リリース](/rest/reference/repos/#create-a-release)」を参照してください。 ### リリースの編集 diff --git a/translations/ja-JP/content/github/administering-a-repository/managing-repository-settings.md b/translations/ja-JP/content/github/administering-a-repository/managing-repository-settings.md index 63dfe751aa3a..682877906b68 100644 --- a/translations/ja-JP/content/github/administering-a-repository/managing-repository-settings.md +++ b/translations/ja-JP/content/github/administering-a-repository/managing-repository-settings.md @@ -1,6 +1,6 @@ --- title: リポジトリ設定を管理する -intro: リポジトリの管理者と Organization のオーナーは、リポジトリの名前や所有権、リポジトリの可視性がパブリックかプライベートかなど、いくつかの設定を変更できます。 リポジトリを削除することもできます。 +intro: 'リポジトリの管理者と Organization のオーナーは、リポジトリの名前や所有権、リポジトリの可視性がパブリックかプライベートかなど、いくつかの設定を変更できます。 リポジトリを削除することもできます。' mapTopic: true redirect_from: - /articles/managing-repository-settings diff --git a/translations/ja-JP/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md b/translations/ja-JP/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md index da5085c837e9..92573cc8b4f2 100644 --- a/translations/ja-JP/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md +++ b/translations/ja-JP/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md @@ -5,7 +5,7 @@ redirect_from: - /articles/managing-the-automatic-deletion-of-branches versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- リポジトリに対する管理者権限があるユーザなら誰でも、ブランチの自動的削除を有効化または無効化できます。 diff --git a/translations/ja-JP/content/github/administering-a-repository/managing-the-forking-policy-for-your-repository.md b/translations/ja-JP/content/github/administering-a-repository/managing-the-forking-policy-for-your-repository.md index f9362fcb4024..ac2e8b207ca9 100644 --- a/translations/ja-JP/content/github/administering-a-repository/managing-the-forking-policy-for-your-repository.md +++ b/translations/ja-JP/content/github/administering-a-repository/managing-the-forking-policy-for-your-repository.md @@ -1,6 +1,6 @@ --- title: リポジトリのフォークポリシーを管理する -intro: 'Organization が所有する特定のプライベート{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}または内部{% endif %}リポジトリのフォークを許可または禁止できます。' +intro: 'You can allow or prevent the forking of a specific private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %} repository owned by an organization.' redirect_from: - /articles/allowing-people-to-fork-a-private-repository-owned-by-your-organization - /github/administering-a-repository/allowing-people-to-fork-a-private-repository-owned-by-your-organization @@ -10,7 +10,7 @@ versions: enterprise-server: '*' --- -Organization のオーナーは、特定のリポジトリのフォークを許可または禁止する前に、Organization レベルでプライベート{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}および内部{% endif %}リポジトリのフォークを許可する必要があります。 詳細は「[Organization のフォークポリシーを管理する](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization)」を参照してください。 +An organization owner must allow forks of private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and internal{% endif %} repositories on the organization level before you can allow or disallow forks for a specific repository. 詳細は「[Organization のフォークポリシーを管理する](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization)」を参照してください。 {% data reusables.organizations.internal-repos-enterprise %} diff --git a/translations/ja-JP/content/github/administering-a-repository/releasing-projects-on-github.md b/translations/ja-JP/content/github/administering-a-repository/releasing-projects-on-github.md index b0d20d549c36..051662a7a038 100644 --- a/translations/ja-JP/content/github/administering-a-repository/releasing-projects-on-github.md +++ b/translations/ja-JP/content/github/administering-a-repository/releasing-projects-on-github.md @@ -1,6 +1,6 @@ --- title: GitHub でプロジェクトをリリースする -intro: ほかの人がダウンロードできるように、ソフトウェア、リリースノート、およびバイナリファイルをパッケージ化したリリースを作成できます。 +intro: 'ほかの人がダウンロードできるように、ソフトウェア、リリースノート、およびバイナリファイルをパッケージ化したリリースを作成できます。' mapTopic: true redirect_from: - /categories/85/articles/ diff --git a/translations/ja-JP/content/github/administering-a-repository/setting-repository-visibility.md b/translations/ja-JP/content/github/administering-a-repository/setting-repository-visibility.md index f06ff898ee0f..f3c4f2d6c6b8 100644 --- a/translations/ja-JP/content/github/administering-a-repository/setting-repository-visibility.md +++ b/translations/ja-JP/content/github/administering-a-repository/setting-repository-visibility.md @@ -19,16 +19,16 @@ Organization のオーナーは、リポジトリの可視性を変更する機 #### リポジトリをプライベートにする - * {% data variables.product.prodname_dotcom %} はパブリックリポジトリのパブリックフォークを切り離し、新しいネットワークに追加します。 パブリックフォークはプライベートにはなりません。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}リポジトリの可視性を内部からプライベートに変更すると、{% data variables.product.prodname_dotcom %} は新たなプライベートリポジトリへのアクセスを持たないユーザに属するフォークを削除します。{% endif %}詳しい情報については、「[リポジトリが削除されたり可視性が変更されたりするとフォークはどうなりますか？](/articles/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility#changing-a-public-repository-to-a-private-repository)」を参照してください。 - {% if currentVersion == "free-pro-team@latest" %}* ユーザアカウントまたは Organization に {% data variables.product.prodname_free_user %} を使用している場合、可視性をプライベートに変更すると、リポジトリで一部の機能が使用できなくなります。 {% data reusables.gated-features.more-info %} + * {% data variables.product.prodname_dotcom %} はパブリックリポジトリのパブリックフォークを切り離し、新しいネットワークに追加します。 パブリックフォークはプライベートにはなりません。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}If you change a repository's visibility from internal to private, {% data variables.product.prodname_dotcom %} will remove forks that belong to any user without access to the newly private repository.{% endif %} For more information, see "[What happens to forks when a repository is deleted or changes visibility?](/articles/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility#changing-a-public-repository-to-a-private-repository)" + {% if currentVersion == "free-pro-team@latest" %}* If you're using {% data variables.product.prodname_free_user %} for user accounts or organizations, some features won't be available in the repository after you change the visibility to private. {% data reusables.gated-features.more-info %} * すべての公開済みの {% data variables.product.prodname_pages %} サイトは自動的に取り下げられます。 {% data variables.product.prodname_pages %} サイトにカスタムドメインを追加した場合、ドメインの乗っ取りリスクを回避するために、リポジトリをプライベートに設定する前に DNS レコードを削除または更新してください。 詳しい情報については、「[{% data variables.product.prodname_pages %} サイト用のカスタムドメインを管理する](/articles/managing-a-custom-domain-for-your-github-pages-site)」を参照してください。 * 今後、{% data variables.product.prodname_dotcom %} は {% data variables.product.prodname_archive %} にリポジトリを含まなくなります。 詳しい情報については、「[{% data variables.product.prodname_dotcom %} のコンテンツとデータのアーカイブについて](/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github#about-the-github-archive-program)」を参照してください。{% endif %} - {% if currentVersion != "free-pro-team@latest" %}* 匿名の Git 読み取りアクセスは利用できなくなりました。 詳しい情報については、「[リポジトリで匿名 Git 読み取りアクセスを有効化する](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)」を参照してください。{% endif %} + {% if currentVersion != "free-pro-team@latest" %}* Anonymous Git read access is no longer available. For more information, see "[Enabling anonymous Git read access for a repository](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)."{% endif %} #### リポジトリをパブリックにする * {% data variables.product.prodname_dotcom %} はプライベートフォークを切り離し、スタンドアロンのプライベートリポジトリに変換します。 詳細は「[リポジトリが削除されたり可視性が変更されたりするとフォークはどうなりますか？](/articles/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility#changing-a-private-repository-to-a-public-repository)」を参照してください。 - * オープンソースプロジェクトの作成の一環として、プライベートリポジトリをパブリックリポジトリに変換する場合は、[オープンソースガイド](http://opensource.guide)を参照して役立つヒントやガイドラインを確認してください。{% if currentVersion == "free-pro-team@latest" %} [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}) でオープンソースプロジェクトの管理方法についての無料コースを受けることもできます。 リポジトリがパブリックになったら、コントリビューターをサポートするための最適な手法にプロジェクトが合致しているかどうかを確認するため、リポジトリのコミュニティプロフィールを表示できます。 詳細は「[コミュニティプロフィールを見る](/articles/viewing-your-community-profile)」を参照してください。{% endif %} + * If you're converting your private repository to a public repository as part of a move toward creating an open source project, see the [Open Source Guides](http://opensource.guide) for helpful tips and guidelines.{% if currentVersion == "free-pro-team@latest" %} You can also take a free course on managing an open source project with [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}). リポジトリがパブリックになったら、コントリビューターをサポートするための最適な手法にプロジェクトが合致しているかどうかを確認するため、リポジトリのコミュニティプロフィールを表示できます。 詳細は「[コミュニティプロフィールを見る](/articles/viewing-your-community-profile)」を参照してください。{% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} @@ -49,19 +49,19 @@ Organization のオーナーは、リポジトリの可視性を変更する機 {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} -3. Under "Danger Zone", next to "Make this repository private", click **Make private**. ![プライベートにするボタン](/assets/images/help/repository/repo-makeprivate.png) +3. [Danger Zone] の下、[Make this repository private] の隣で、[**Make private**] をクリックします。 ![プライベートにするボタン](/assets/images/help/repository/repo-makeprivate.png) 4. リポジトリをプライベートにすることに関する警告を読みます。 ![警告ポップアップ](/assets/images/help/repository/repo-privateconfirm.png) 5. プライベートにしたいリポジトリの名前を入力します。たとえば、`accountname/reponame` と入力します。 -6. Click **I understand, make this repository private**. +6. [**I understand, make this repository private**] をクリックします。 ### リポジトリをパブリックにする {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} -3. Under "Danger Zone", next to "Make this repository public", click **Make public**. ![パブリックにするボタン](/assets/images/help/repository/repo-makepublic.png) +3. [Danger Zone] の下、[Make this repository public] の隣で、[**Make public**] をクリックします。 ![パブリックにするボタン](/assets/images/help/repository/repo-makepublic.png) 4. リポジトリをパブリックにすることに関する警告を読みます。 ![プライベートリポジトリをパブリックにすることに関する情報のポップアップ](/assets/images/help/repository/repo-publicconfirm.png) 5. パブリックにしたいリポジトリの名前を入力します。たとえば、`accountname/reponame` と入力します。 -6. Click **I understand, make this repository public**. +6. [**I understand, make this repository public**] をクリックします。 {% if currentVersion ver_gt "enterprise-server@2.19" %} ### リポジトリをインターナルにする @@ -70,10 +70,10 @@ Organization のオーナーは、リポジトリの可視性を変更する機 {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} -3. Under "Danger Zone", next to "Make this repository internal", click **Make internal**. ![[Make internal] ボタン](/assets/images/help/repository/repo-makeinternal.png) +3. [Danger Zone] の下、[Make this repository internal] の隣で、[**Make internal**] をクリックします。 ![[Make internal] ボタン](/assets/images/help/repository/repo-makeinternal.png) 4. リポジトリをインターナルにすることに関する警告を読みます。 ![警告ポップアップ](/assets/images/help/repository/repo-internalconfirm.png) 5. インターナルにしたいリポジトリの名前を入力します。たとえば、`accountname/reponame` と入力します。 -6. Click **I understand, make this repository internal**. +6. [**I understand, make this repository internal**] をクリックします。 {% endif %} {% endif %} diff --git a/translations/ja-JP/content/github/administering-a-repository/transferring-a-repository.md b/translations/ja-JP/content/github/administering-a-repository/transferring-a-repository.md index ea4856b27bc2..2f8d9eeaf968 100644 --- a/translations/ja-JP/content/github/administering-a-repository/transferring-a-repository.md +++ b/translations/ja-JP/content/github/administering-a-repository/transferring-a-repository.md @@ -21,14 +21,14 @@ versions: リポジトリを新たなオーナーに移譲すると、そのオーナーはすぐにリポジトリの内容、Issue、プルリクエスト、リリース、プロジェクトボード、そして設定を管理できるようになります。 -リポジトリ移譲の前提条件{% if currentVersion == "free-pro-team@latest" %} +Prerequisites for repository transfers: {% if currentVersion == "free-pro-team@latest" %} - 自分が所有しているリポジトリを他のユーザアカウントに移譲すると、新しい所有者に確認メールが届きます。 確認メールには、移譲を受け入れるための指示が書かれています。 新しいオーナーが移譲を 1 日以内に受け入れなければ、招待は期限切れになります。{% endif %} - 自分が所有しているリポジトリを Organization に移譲するには、対象 Organization のリポジトリを作成する権限が必要です。 - ターゲットのアカウントは、同じ名前のリポジトリを持っていたり、同じネットワーク内にフォークを持っていたりしてはなりません。 - リポジトリのオリジナルのオーナーは、移譲されたリポジトリにコラボレーターとして追加されます。 他のコラボレーターは、移譲されたリポジトリにそのまま残されます。 - プライベートフォークは移譲できません。 -{% if currentVersion == "free-pro-team@latest" %}プライベートリポジトリを {% data variables.product.prodname_free_user %} ユーザまたは Organization アカウントに移譲すると、リポジトリは保護されたブランチや {% data variables.product.prodname_pages %} などの機能にアクセスできなくなります。 {% data reusables.gated-features.more-info %}{% endif %} +{% if currentVersion == "free-pro-team@latest" %}If you transfer a private repository to a {% data variables.product.prodname_free_user %} user or organization account, the repository will lose access to features like protected branches and {% data variables.product.prodname_pages %}. {% data reusables.gated-features.more-info %}{% endif %} #### リポジトリと共に移譲されるものは？ @@ -36,7 +36,7 @@ versions: - 移譲されたリポジトリがフォークである場合、それは上流のリポジトリに関連付けられたままになります。 - 移譲されたリポジトリにフォークがある場合、それらのフォークは移譲が完了した後リポジトリに関連付けられたままになります。 -- 移譲されたリポジトリが {% data variables.large_files.product_name_long %} を使う場合、すべての {% data variables.large_files.product_name_short %} オブジェクトは自動的に移動します。 この移譲はバックグラウンドで行われます。このため、多数の {% data variables.large_files.product_name_short %} オブジェクトがあるか、{% data variables.large_files.product_name_short %} オブジェクト自体が大容量である場合、移譲には時間がかかることがあります。{% if currentVersion == "free-pro-team@latest" %} {% data variables.large_files.product_name_short %} を利用するリポジトリを移譲する前に、受信側のアカウントが、移動する {% data variables.large_files.product_name_short %} オブジェクトを保存するために十分なデータパックを所有していることを確認してください。 ユーザアカウントにストレージを追加する方法の詳細については、「[{% data variables.large_files.product_name_long %} をアップグレードする](/articles/upgrading-git-large-file-storage)」を参照してください。{% endif %} +- 移譲されたリポジトリが {% data variables.large_files.product_name_long %} を使う場合、すべての {% data variables.large_files.product_name_short %} オブジェクトは自動的に移動します。 This transfer occurs in the background, so if you have a large number of {% data variables.large_files.product_name_short %} objects or if the {% data variables.large_files.product_name_short %} objects themselves are large, it may take some time for the transfer to occur.{% if currentVersion == "free-pro-team@latest" %} Before you transfer a repository that uses {% data variables.large_files.product_name_short %}, make sure the receiving account has enough data packs to store the {% data variables.large_files.product_name_short %} objects you'll be moving over. ユーザアカウントにストレージを追加する方法の詳細については、「[{% data variables.large_files.product_name_long %} をアップグレードする](/articles/upgrading-git-large-file-storage)」を参照してください。{% endif %} - リポジトリを 2 つのユーザアカウント間で移譲する場合、Issue の割り当てはそのまま残ります。 ユーザアカウントから Organization にリポジトリを移譲する場合、Organization のメンバーにアサインされた Issue はそのまま残ります。そして、すべての他の Issue のアサイニーは消えます。 Organization の中のオーナーだけが、新しい Issue のアサインを作成できます。 Organization からユーザアカウントにリポジトリを移譲する場合、リポジトリのオーナーにアサインされた Issue だけが保管され、すべての他のアサイニーは削除されます。 - 移譲されたリポジトリが {% data variables.product.prodname_pages %} サイトを含む場合、Web 上の Git リポジトリへのリンクや Git のアクティビティを通じたリンクはリダイレクトされます。 しかし、リポジトリに関連付けられている {% data variables.product.prodname_pages %} はリダイレクトされません。 - 以前のリポジトリの場所へのすべてのリンクは、新しい場所へ自動的にリダイレクトされます。 移譲されたリポジトリ上で `git clone`、`git fetch`、または `git push` を使う場合には、これらのコマンドは新しいリポジトリの場所あるいは URL にリダイレクトされます。 しかし、混乱を避けるため、既存のローカルクローンは新しいリポジトリの URL を指すよう更新することを強くおすすめします。 それは `git remote` をコマンドライン上で使って行えます。 @@ -57,7 +57,7 @@ Organization にリポジトリが移譲されたら、Organization のデフォ リポジトリの移譲を受け入れるどのユーザアカウントにも、リポジトリを移譲できます。 ２つのユーザアカウントの間でリポジトリを移譲した場合、当初のリポジトリコードオーナーとコラボレーターは、新しいリポジトリにコラボレーターとして自動的に追加されます。 -{% if currentVersion == "free-pro-team@latest" %}プライベートリポジトリに {% data variables.product.prodname_pages %} サイトを公開し、カスタムドメインを追加した場合、ドメイン乗っ取りのリスクを回避するため、DNS レコードを削除するか更新することをおすすめします。 詳しい情報については、「[{% data variables.product.prodname_pages %} サイト用のカスタムドメインを管理する](/articles/managing-a-custom-domain-for-your-github-pages-site)」を参照してください。{% endif %} +{% if currentVersion == "free-pro-team@latest" %}If you published a {% data variables.product.prodname_pages %} site in a private repository and added a custom domain, before transferring the repository, you may want to remove or update your DNS records to avoid the risk of a domain takeover. 詳しい情報については、「[{% data variables.product.prodname_pages %} サイト用のカスタムドメインを管理する](/articles/managing-a-custom-domain-for-your-github-pages-site)」を参照してください。{% endif %} {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} diff --git a/translations/ja-JP/content/github/administering-a-repository/types-of-required-status-checks.md b/translations/ja-JP/content/github/administering-a-repository/types-of-required-status-checks.md index d1bbeb32015b..f7a19c661320 100644 --- a/translations/ja-JP/content/github/administering-a-repository/types-of-required-status-checks.md +++ b/translations/ja-JP/content/github/administering-a-repository/types-of-required-status-checks.md @@ -1,6 +1,6 @@ --- title: 必須ステータスチェックのタイプ -intro: '必須ステータスチェックのタイプは、[loose] (寛容)、[strict] (厳格) のいずれかに設定できます。 選択した必須ステータスチェックのタイプにより、マージする前にブランチをベースブランチとともに最新にする必要があるかどうかが決まります。' +intro: 必須ステータスチェックのタイプは、[loose] (寛容)、[strict] (厳格) のいずれかに設定できます。 選択した必須ステータスチェックのタイプにより、マージする前にブランチをベースブランチとともに最新にする必要があるかどうかが決まります。 product: '{% data reusables.gated-features.protected-branches %}' redirect_from: - /articles/types-of-required-status-checks diff --git a/translations/ja-JP/content/github/administering-a-repository/viewing-deployment-activity-for-your-repository.md b/translations/ja-JP/content/github/administering-a-repository/viewing-deployment-activity-for-your-repository.md index 810e78e19da2..6defaae2a28f 100644 --- a/translations/ja-JP/content/github/administering-a-repository/viewing-deployment-activity-for-your-repository.md +++ b/translations/ja-JP/content/github/administering-a-repository/viewing-deployment-activity-for-your-repository.md @@ -14,7 +14,7 @@ versions: {% endnote %} -リポジトリへの読み取りアクセス権を持つ人は、リポジトリのデプロイメントワークフローが、Deployments API または[{% data variables.product.prodname_marketplace %}](https://github.com/marketplace/category/deployment) のアプリケーションを通して、{% data variables.product.product_name %} に統合されている場合、現在のすべてのデプロイメントの概要と過去のデプロイメントアクティビティのログを見ることができます。 詳しい情報については、「[デプロイメント](/v3/repos/deployments/)」を参照してください。 +リポジトリへの読み取りアクセス権を持つ人は、リポジトリのデプロイメントワークフローが、Deployments API または[{% data variables.product.prodname_marketplace %}](https://github.com/marketplace/category/deployment) のアプリケーションを通して、{% data variables.product.product_name %} に統合されている場合、現在のすべてのデプロイメントの概要と過去のデプロイメントアクティビティのログを見ることができます。 詳しい情報については、「[デプロイメント](/rest/reference/repos#deployments)」を参照してください。 プルリクエストの [Conversation] タブにもデプロイメント情報が表示されます。 diff --git a/translations/ja-JP/content/github/authenticating-to-github/about-authentication-to-github.md b/translations/ja-JP/content/github/authenticating-to-github/about-authentication-to-github.md index 8f6ca3831242..7d64f4e5a502 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/about-authentication-to-github.md +++ b/translations/ja-JP/content/github/authenticating-to-github/about-authentication-to-github.md @@ -16,7 +16,6 @@ versions: - 個人アクセストークン - SSH キー - ### ブラウザで認証する {% data variables.product.product_name %} への認証は、ブラウザ内でさまざまな方法を使用して行うことができます。 @@ -50,4 +49,4 @@ versions: * SSH 接続はファイアウォールとプロキシから許可されない場合がありますが、SSH 経由で {% data variables.product.product_name %} 上のすべてのリポジトリを操作できます。 SSH を使用するには、ローカルマシンで SSH 公開鍵/秘密鍵ペアを生成し、公開鍵を {% data variables.product.product_name %} アカウントに追加する必要があります。 Git を使用して {% data variables.product.product_name %} で認証するたびに、[キーを保存](/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent#adding-your-ssh-key-to-the-ssh-agent)していない限り、SSH キーのパスフレーズの入力を求められます。 詳しい情報については、「[新しい SSH キーを生成して ssh-agent に追加する](/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)」を参照してください。 -{% if currentVersion == "free-pro-team@latest" %}個人アクセストークンまたは SSH キーを使用して、SAML シングルサインオンを使用する Organization が所有するリソースにアクセスするには、個人トークンまたは SSH キーも認証する必要があります。 詳しい情報については、[SAML シングルサインオンで利用するために個人アクセストークンを認証する](/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on)」または「[SAML シングルサインオンで使用するために SSH キーを認証する](/github/authenticating-to-github/authorizing-an-ssh-key-for-use-with-saml-single-sign-on)」を参照してください。{% endif %} +{% if currentVersion == "free-pro-team@latest" %}To use a personal access token or SSH key to access resources owned by an organization that uses SAML single sign-on, you must also authorize the personal token or SSH key. 詳しい情報については、[SAML シングルサインオンで利用するために個人アクセストークンを認証する](/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on)」または「[SAML シングルサインオンで使用するために SSH キーを認証する](/github/authenticating-to-github/authorizing-an-ssh-key-for-use-with-saml-single-sign-on)」を参照してください。{% endif %} diff --git a/translations/ja-JP/content/github/authenticating-to-github/about-authentication-with-saml-single-sign-on.md b/translations/ja-JP/content/github/authenticating-to-github/about-authentication-with-saml-single-sign-on.md index 3089830e2a08..37eefc745c78 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/about-authentication-with-saml-single-sign-on.md +++ b/translations/ja-JP/content/github/authenticating-to-github/about-authentication-with-saml-single-sign-on.md @@ -1,6 +1,6 @@ --- title: SAMLのシングルサインオンでの認証について -intro: SAMLシングルサインオン（SSO）を使うOrganizationには、アイデンティティプロバイダ（IdP）を通じての認証を受けてアクセスできます。 Organization が SAML SSO を実施するときにコマンドラインで API または Git で認証するには、個人アクセストークンまたは SSH キーを承認する必要があります。 +intro: 'SAMLシングルサインオン（SSO）を使うOrganizationには、アイデンティティプロバイダ（IdP）を通じての認証を受けてアクセスできます。 Organization が SAML SSO を実施するときにコマンドラインで API または Git で認証するには、個人アクセストークンまたは SSH キーを承認する必要があります。' product: '{% data reusables.gated-features.saml-sso %}' redirect_from: - /articles/about-authentication-with-saml-single-sign-on diff --git a/translations/ja-JP/content/github/authenticating-to-github/about-commit-signature-verification.md b/translations/ja-JP/content/github/authenticating-to-github/about-commit-signature-verification.md index e4e2d22034c7..3e8f522a7920 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/about-commit-signature-verification.md +++ b/translations/ja-JP/content/github/authenticating-to-github/about-commit-signature-verification.md @@ -1,6 +1,6 @@ --- title: コミット署名の検証について -intro: 'GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} あるいは S/MIME{% endif %} を使って、タグやコミットにローカルで署名できます。 それらのタグやコミットは検証済みとして {% data variables.product.product_name %}上でマークされ、他の人々がその変更が信頼できるソースから来たものと信頼できるようになります。' +intro: 'Using GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} or S/MIME{% endif %}, you can sign tags and commits locally. それらのタグやコミットは検証済みとして {% data variables.product.product_name %}上でマークされ、他の人々がその変更が信頼できるソースから来たものと信頼できるようになります。' redirect_from: - /articles/about-gpg-commit-and-tag-signatures/ - /articles/about-gpg/ @@ -22,7 +22,7 @@ versions: {% data variables.product.product_name %}上の署名されたコミットあるいはタグの検証ステータスをチェックして、コミットの署名が検証されない理由を見ることができます。 詳細は「[コミットおよびタグの署名の検証のステータスをチェックする](/articles/checking-your-commit-and-tag-signature-verification-status)」を参照してください。 -{% if currentVersion == "free-pro-team@latest" %} {% data variables.product.product_name %}は GPG を自動的に使用して、{% data variables.product.product_name %} Web インターフェースを使用して行ったコミットに署名します。ただし、作者ではないプルリクエストを squash してマージする場合は除きます。 {% data variables.product.product_name %}によって署名されたコミットは、{% data variables.product.product_name %}で認証済みのステータスになります。 署名は、https://github.com/web-flow.gpgから利用できる公開鍵を使ってローカルに検証できます。{% endif %} +{% if currentVersion == "free-pro-team@latest" %} {% data variables.product.product_name %} will automatically use GPG to sign commits you make using the {% data variables.product.product_name %} web interface, except for when you squash and merge a pull request that you are not the author of. {% data variables.product.product_name %}によって署名されたコミットは、{% data variables.product.product_name %}で認証済みのステータスになります。 署名は、https://github.com/web-flow.gpgから利用できる公開鍵を使ってローカルに検証できます。{% endif %} ### GPG コミット署名の検証 @@ -59,8 +59,9 @@ S/MIME を使ってコミットに署名し、それらのコミットを {% dat ### ボットの署名検証 コミットの署名が必要な Organization および {% data variables.product.prodname_github_app %} は、コミットの署名にボットを利用できます。 コミットまたはタグが暗号的に検証可能なボット署名を持っている場合、{% data variables.product.product_name %} はそのコミットまたはタグを検証済みとしてマークします。 +Signature verification for bots will only work if the request is verified and authenticated as the -ボットの署名検証は、要求が検証され {% data variables.product.prodname_github_app %} またはボットとして認証されており、カスタム作者情報、カスタムコミッター情報、およびコミットAPI などのカスタム署名情報が含まれていない場合にのみ機能します。 +{% data variables.product.prodname_github_app %} or bot and contains no custom author information, custom committer information, and no custom signature information, such as Commits API. {% endif %} ### 参考リンク diff --git a/translations/ja-JP/content/github/authenticating-to-github/about-ssh.md b/translations/ja-JP/content/github/authenticating-to-github/about-ssh.md index 107da7168968..5fc9c73734a7 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/about-ssh.md +++ b/translations/ja-JP/content/github/authenticating-to-github/about-ssh.md @@ -10,17 +10,16 @@ versions: SSH をセットアップする際には、[SSH キーを生成し、ssh-agent に追加](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)し、それから [ キーを自分の {% data variables.product.product_name %}アカウントに追加](/articles/adding-a-new-ssh-key-to-your-github-account)します。 SSH キーを ssh-agent に追加することで、パスフレーズの利用を通じて SSH キーに追加のセキュリティのレイヤーを持たせることができます。 詳しい情報については[SSH キーのパスフレーズを使う](/articles/working-with-ssh-key-passphrases)を参照してください。 -{% if currentVersion == "free-pro-team@latest" %}SSH キーを SAML シングルサインオンを使う Organization が所有するリポジトリで使うには、まずそのキーを認可しなければなりません。 詳しい情報については、「[SAML シングルサインオンで使うために SSH キーを認可する](/articles/authorizing-an-ssh-key-for-use-with-saml-single-sign-on)」を参照してください。{% endif %} +{% if currentVersion == "free-pro-team@latest" %}To use your SSH key with a repository owned by an organization that uses SAML single sign-on, you'll need to authorize it first. 詳しい情報については、「[SAML シングルサインオンで使うために SSH キーを認可する](/articles/authorizing-an-ssh-key-for-use-with-saml-single-sign-on)」を参照してください。{% endif %} 定期的に [SSH キーのリストをレビュー](/articles/reviewing-your-ssh-keys)し、不正になったものや悪用されたものを取り除くことをおすすめします。 {% if currentVersion == "free-pro-team@latest" %} -SSH キーを 1 年間使っていない場合、セキュリティ上の理由により {% data variables.product.prodname_dotcom %} は使われていない SSH キーを自動的に削除します。 詳細は「[削除されたか存在しない SSH キー](/articles/deleted-or-missing-ssh-keys)」を参照してください。 +If you haven't used your SSH key for a year, then +{% data variables.product.prodname_dotcom %} will automatically delete your inactive SSH key as a security precaution. 詳細は「[削除されたか存在しない SSH キー](/articles/deleted-or-missing-ssh-keys)」を参照してください。 {% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} SSH 証明書を提供する Organization のメンバーである場合、{% data variables.product.product_name %} アカウントにあなたの証明書を追加することなく、その証明書で Organization のリポジトリにアクセスできます。 詳しい情報については、「[SSH 認証局について](/articles/about-ssh-certificate-authorities)」を参照してください。 -{% endif %} ### 参考リンク diff --git a/translations/ja-JP/content/github/authenticating-to-github/about-two-factor-authentication.md b/translations/ja-JP/content/github/authenticating-to-github/about-two-factor-authentication.md index 0337ab94c12d..2331a1071e69 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/about-two-factor-authentication.md +++ b/translations/ja-JP/content/github/authenticating-to-github/about-two-factor-authentication.md @@ -1,6 +1,6 @@ --- title: 2 要素認証について -intro: 2 要素認証、あるいは 2FA は、Web サイトあるいはアプリケーションにログインする際に使われる追加のセキュリティレイヤーです。 2FA を使うと、ユーザ名とパスワードを用い、さらにあなただけが知っている、もしくは利用できる他の形態の認証を利用してログインしなければならなくなります。 +intro: '{% data reusables.two_fa.about-2fa %} With 2FA, you have to log in with your username and password and provide another form of authentication that only you know or have access to.' redirect_from: - /articles/about-two-factor-authentication versions: @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -{% data variables.product.product_name %}では、2 番目の形態の認証は、モバイルデバイス上のアプリケーションで生成された{% if currentVersion == "free-pro-team@latest" %}、もしくはテキストメッセージ (SMS) で送信された{% endif %}コードです。 2FA を有効化すると、{% data variables.product.product_name %}は誰かが {% data variables.product.product_name %}アカウントにサインインしようとすると認証コードを生成します。 誰かがアカウントサインインできるのは、パスワードを知っており、電話上の認証コードも利用できる場合のみです。 +For {% data variables.product.product_name %}, the second form of authentication is a code that's generated by an application on your mobile device{% if currentVersion == "free-pro-team@latest" %} or sent as a text message (SMS){% endif %}. 2FA を有効化すると、{% data variables.product.product_name %}は誰かが {% data variables.product.product_name %}アカウントにサインインしようとすると認証コードを生成します。 誰かがアカウントサインインできるのは、パスワードを知っており、電話上の認証コードも利用できる場合のみです。 {% data reusables.two_fa.after-2fa-add-security-key %} @@ -34,6 +34,6 @@ versions: ### Organization で 2 要素認証を要求する -Organization のオーナーは、Organization のメンバー{% if currentVersion == "free-pro-team@latest" %}、支払いマネージャー{% endif %}および外部のコラボレータが個人アカウントをセキュアに保つために 2 要素認証を使うことを要求できます。 詳しい情報については [Organization で 2 要素認証を要求する](/articles/requiring-two-factor-authentication-in-your-organization)を参照してください。 +Organization owners can require that organization members{% if currentVersion == "free-pro-team@latest" %}, billing managers,{% endif %} and outside collaborators use two-factor authentication to secure their personal accounts. 詳しい情報については [Organization で 2 要素認証を要求する](/articles/requiring-two-factor-authentication-in-your-organization)を参照してください。 {% data reusables.two_fa.auth_methods_2fa %} diff --git a/translations/ja-JP/content/github/authenticating-to-github/accessing-github-using-two-factor-authentication.md b/translations/ja-JP/content/github/authenticating-to-github/accessing-github-using-two-factor-authentication.md index 9aa0cdd798d9..f395c21ae4ee 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/accessing-github-using-two-factor-authentication.md +++ b/translations/ja-JP/content/github/authenticating-to-github/accessing-github-using-two-factor-authentication.md @@ -15,7 +15,7 @@ versions: ### Web サイトへのサインインの際に 2FA コードを提供 -パスワードを使用して {% data variables.product.product_name %}にサインインした後、{% if currentVersion == "free-pro-team@latest" %}テキストメッセージまたは {% endif %}TOTP アプリケーションから、認証コードを入力するよう求められます。 +After you sign in to {% data variables.product.product_name %} using your password, you'll be prompted to provide an authentication code from {% if currentVersion == "free-pro-team@latest" %}a text message or{% endif %} your TOTP app. {% data variables.product.product_name %}が 2FA 認証コードを再度求めるのは、ログアウトした場合、新しいデバイスを使う場合、またはセッションが期限切れになった場合のみです。 diff --git a/translations/ja-JP/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md b/translations/ja-JP/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md index e348b1a2bc1a..516b7f2f2325 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md +++ b/translations/ja-JP/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md @@ -78,10 +78,10 @@ versions: ```shell $ sudo apt-get install xclip - # xclip をダウンロードしてインストールします。 `apt-get`がなければ、それ以外のインストーラ（`yum`など）を使う必要があるかもしれません。 + # xclip をダウンロードしてインストールします。 If you don't have `apt-get`, you might need to use another installer (like `yum`) - $ xclip -sel clip < ~/.ssh/id_rsa.pub - # id_rsa.pubファイルの内容をクリップボードにコピーする + $ xclip -selection clipboard < ~/.ssh/id_rsa.pub + # Copies the contents of the id_rsa.pub file to your clipboard ``` {% tip %} diff --git a/translations/ja-JP/content/github/authenticating-to-github/associating-an-email-with-your-gpg-key.md b/translations/ja-JP/content/github/authenticating-to-github/associating-an-email-with-your-gpg-key.md index 8ed4cff697c6..8d5d5cd3cf99 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/associating-an-email-with-your-gpg-key.md +++ b/translations/ja-JP/content/github/authenticating-to-github/associating-an-email-with-your-gpg-key.md @@ -25,7 +25,7 @@ versions: ```shell $ gpg> adduid ``` -6. プロンプトに従って、本名、メールアドレス、あればコメントを入力してください。 エントリーは、`N`、`C`、`E` を選択して変更できます。 {% data reusables.gpg.private-email %} {% if currentVersion == "free-pro-team@latest" %}詳細は「[コミットメールアドレスを設定する](/articles/setting-your-commit-email-address)」を参照してください。{% endif %} +6. プロンプトに従って、本名、メールアドレス、あればコメントを入力してください。 エントリーは、`N`、`C`、`E` を選択して変更できます。 {% data reusables.gpg.private-email %} {% if currentVersion == "free-pro-team@latest" %} For more information, see "[Setting your commit email address](/articles/setting-your-commit-email-address)."{% endif %} ```shell Real Name: Octocat Email address: octocat@github.com diff --git a/translations/ja-JP/content/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on.md b/translations/ja-JP/content/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on.md index 6f6d8d6c5b2d..6b3d217d5ecf 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on.md +++ b/translations/ja-JP/content/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on.md @@ -1,6 +1,6 @@ --- title: SAMLシングルサインオンで利用するために個人アクセストークンを認可する -intro: SAMLシングルサインオン (SSO) を使う Organization で個人アクセストークンを使うためには、まずそのキーを認可しなければなりません。 +intro: 'SAMLシングルサインオン (SSO) を使う Organization で個人アクセストークンを使うためには、まずそのキーを認可しなければなりません。' redirect_from: - /articles/authorizing-a-personal-access-token-for-use-with-a-saml-single-sign-on-organization/ - /articles/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on diff --git a/translations/ja-JP/content/github/authenticating-to-github/authorizing-an-ssh-key-for-use-with-saml-single-sign-on.md b/translations/ja-JP/content/github/authenticating-to-github/authorizing-an-ssh-key-for-use-with-saml-single-sign-on.md index 8f30e8b2784e..d5477cac31d6 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/authorizing-an-ssh-key-for-use-with-saml-single-sign-on.md +++ b/translations/ja-JP/content/github/authenticating-to-github/authorizing-an-ssh-key-for-use-with-saml-single-sign-on.md @@ -1,6 +1,6 @@ --- title: SAMシングルサインオンで利用するためにSSHキーを認可する -intro: SAML シングルサインオン (SSO) を使う Organization で SSH キーを使うためには、まずそのキーを認可しなければなりません。 +intro: 'SAML シングルサインオン (SSO) を使う Organization で SSH キーを使うためには、まずそのキーを認可しなければなりません。' redirect_from: - /articles/authorizing-an-ssh-key-for-use-with-a-saml-single-sign-on-organization/ - /articles/authorizing-an-ssh-key-for-use-with-saml-single-sign-on diff --git a/translations/ja-JP/content/github/authenticating-to-github/authorizing-oauth-apps.md b/translations/ja-JP/content/github/authenticating-to-github/authorizing-oauth-apps.md index 2c4f90ccfa54..056fc7401c33 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/authorizing-oauth-apps.md +++ b/translations/ja-JP/content/github/authenticating-to-github/authorizing-oauth-apps.md @@ -55,7 +55,7 @@ versions: | デプロイメント | デプロイメントのステータスへアクセスできれば、アプリケーションはパブリック及びプライベートのリポジトリの特定のコミットに対してデプロイメントが成功したかを判断できます。 アプリケーションはコードにはアクセスできません。 | | Gist | [Gist](https://gist.github.com) アクセスがあれば、アプリケーションはあなたのパブリックおよびシークレット Gist の双方を読み書きできます。 | | フック | [webhook](/webhooks) アクセスがあれば、アプリケーションはあなたが管理するリポジトリ上のフックの設定を読み書きできます。 | -| 通知 | 通知アクセスがあれば、アプリケーションは Issue やプルリクエストへのコメントなど、あなたの {% data variables.product.product_name %}通知を読むことができます。 しかし、アプリケーションはリポジトリ内へはアクセスできないままです。 | +| 通知 | 通知アクセスがあれば、アプリケーションは Issue やプルリクエストへのコメントなど、あなたの {% data variables.product.product_name %}通知を読むことができます。 しかし、アプリケーションはリポジトリ内へはアクセスできないままです。 | | Organization および Team | Organization および Team のアクセスがあれば、アプリケーションは Organization および Team のメンバー構成へのアクセスと管理ができます。 | | 個人ユーザデータ | ユーザデータには、名前、メールアドレス、所在地など、ユーザプロファイル内の情報が含まれます。 | | リポジトリ | リポジトリ情報には、コントリビュータの名前、あなたが作成したブランチ、リポジトリ内の実際のファイルなどが含まれます。 アプリケーションはユーザ単位のレベルでパブリックあるいはプライベートリポジトリへのアクセスをリクエストできます。 | diff --git a/translations/ja-JP/content/github/authenticating-to-github/checking-for-existing-gpg-keys.md b/translations/ja-JP/content/github/authenticating-to-github/checking-for-existing-gpg-keys.md index 47590d4500a0..fe1d98581afe 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/checking-for-existing-gpg-keys.md +++ b/translations/ja-JP/content/github/authenticating-to-github/checking-for-existing-gpg-keys.md @@ -1,6 +1,6 @@ --- title: 既存の GPG キーの確認 -intro: GPG キーを生成する前に、GPG キーがすでに存在するかどうかを確認できます。 +intro: 'GPG キーを生成する前に、GPG キーがすでに存在するかどうかを確認できます。' redirect_from: - /articles/checking-for-existing-gpg-keys versions: diff --git a/translations/ja-JP/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md b/translations/ja-JP/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md index 342ce254ae85..33ee58aaea6b 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md +++ b/translations/ja-JP/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md @@ -1,6 +1,6 @@ --- title: 既存の SSH キーの確認 -intro: SSH キーを生成する前に、SSH キーがすでに存在するかどうかを確認できます。 +intro: 'SSH キーを生成する前に、SSH キーがすでに存在するかどうかを確認できます。' redirect_from: - /articles/checking-for-existing-ssh-keys versions: @@ -20,8 +20,7 @@ versions: 3. ディレクトリの一覧から、公開 SSH キーをすでに持っているか確認します。 デフォルトでは、公開鍵のファイル名は以下のいずれかです: - *id_rsa.pub* - *id_ecdsa.pub* - - *id_ed25519.pub*{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} - - *id_dsa.pub*{% endif %} + - *id_ed25519.pub* 公開鍵と秘密鍵のペアが存在しないか、既存の鍵を {% data variables.product.product_name %}への接続に利用したくない場合、[新しい SSH キーを作成](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)します。 diff --git a/translations/ja-JP/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md b/translations/ja-JP/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md index beae59c31e68..3e1ef9663d62 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md +++ b/translations/ja-JP/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md @@ -11,7 +11,9 @@ versions: ### コミットの署名検証のステータスの確認 -1. {% data variables.product.product_name %}上で、プルリクエストに移動します。 +1. On + +{% data variables.product.product_name %}, navigate to your pull request. {% data reusables.repositories.review-pr-commits %} 3. コミットの短縮版コミットハッシュの隣に、コミットの署名が検証されているかどうかを示すボックスがあります。 ![署名されたコミット](/assets/images/help/commits/gpg-signed-commit-verified-without-details.png) 4. コミットの署名について詳しい情報を表示するには、[**Verified**] または [**Unverified**] をクリックします。 ![検証された署名済みコミット](/assets/images/help/commits/gpg-signed-commit_verified_details.png) diff --git a/translations/ja-JP/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md b/translations/ja-JP/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md index 3971e4b13d00..0c2c85baea3e 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md +++ b/translations/ja-JP/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md @@ -91,7 +91,9 @@ Recovery Accounts Elsewhere を使用して、あなたの {% data variables.pro アカウントリカバリトークンを生成し、パートナーリカバリプロバイダを利用して保存できます。 -1. あなたの Facebook アカウントにサインインしてから、{% data variables.product.product_name %} に戻ります。 +1. Sign in to your Facebook account, then return to + +{% data variables.product.product_name %}. {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.security %} 4. 新しいトークンを生成するため、[Recovery tokens] の下にある [**Store new token**] をクリックします。 ![新しいリカバリトークンを保存するボタン](/assets/images/help/settings/store-new-recovery-token.png) diff --git a/translations/ja-JP/content/github/authenticating-to-github/configuring-two-factor-authentication.md b/translations/ja-JP/content/github/authenticating-to-github/configuring-two-factor-authentication.md index f1a3e4c4d0ee..97427254a7c2 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/configuring-two-factor-authentication.md +++ b/translations/ja-JP/content/github/authenticating-to-github/configuring-two-factor-authentication.md @@ -11,14 +11,14 @@ versions: enterprise-server: '*' --- -モバイルアプリまたは{% if currentVersion == "free-pro-team@latest" %}テキストメッセージ{% endif %}を使って、2 要素認証を設定できます。 また、セキュリティキーを追加することも可能です。 +You can configure two-factor authentication using a mobile app{% if currentVersion == "free-pro-team@latest" %} or via text message{% endif %}. また、セキュリティキーを追加することも可能です。 -2 要素認証の設定には、時間ベースのワンタイムパスワード (TOTP) アプリケーションを使うことを強くおすすめします。{% if currentVersion == "free-pro-team@latest" %}TOTP アプリケーションは、特に米国外において、SMS より信頼性があります。{% endif %}TOTP アプリは、クラウド内にある認証コードのセキュアなバックアップをサポートしており、デバイスにアクセスできなくなった場合に回復できます。 +We strongly recommend using a time-based one-time password (TOTP) application to configure 2FA.{% if currentVersion == "free-pro-team@latest" %} TOTP applications are more reliable than SMS, especially for locations outside the United States.{% endif %} TOTP apps support the secure backup of your authentication codes in the cloud and can be restored if you lose access to your device. {% warning %} **警告:** -- 2 要素認証が必要なメンバー{% if currentVersion == "free-pro-team@latest" %}、支払いマネージャー、{% endif %}または Organization のプライベートリポジトリへの外部コラボレーターは、2 要素認証を無効化する前に {% data variables.product.product_location %} で Organization から離脱する必要があります。 +- If you're a member{% if currentVersion == "free-pro-team@latest" %}, billing manager,{% endif %} or outside collaborator to a private repository of an organization that requires two-factor authentication, you must leave the organization before you can disable 2FA on {% data variables.product.product_location %}. - 2 要素認証を無効化すると、Organization や Organization のプライベートリポジトリのフォークへのアクセスも失います。 Organization およびフォークへのアクセスを再取得するには、2 要素認証を再有効化し、Organization オーナーに連絡します。 {% endwarning %} @@ -45,7 +45,9 @@ versions: 8. [Two-factor authentication] ページで、次のいずれかを実行します: - QR コードを、モバイルデバイスのアプリでスキャンする。 スキャン後、アプリは {% data variables.product.product_name %} で入力する 6 桁の数字を表示します。 - QR コードをスキャンできない場合は、[**enter this text code**] をクリックしてコードを表示し、それをコピーして {% data variables.product.product_name %} に手入力してください。 ![[enter this code] をクリック](/assets/images/help/2fa/totp-click-enter-code.png) -9. TOTP モバイルアプリは、あなたの {% data variables.product.product_name %} アカウントを保存し、数秒ごとに認証コードを新しく生成します。 {% data variables.product.product_name %} の 2 要素認証ページでコードを入力し、[**Enable**] をクリックします。 ![[TOTP Enable] フィールド](/assets/images/help/2fa/totp-enter-code.png) +9. The TOTP mobile application saves your +{% data variables.product.product_name %} account and generates a new authentication code every few seconds. {% data variables.product.product_name %} の 2 要素認証ページでコードを入力し、[**Enable**] をクリックします。 + ![[TOTP Enable] フィールド](/assets/images/help/2fa/totp-enter-code.png) {% data reusables.two_fa.test_2fa_immediately %} {% if currentVersion == "free-pro-team@latest" %} @@ -79,32 +81,16 @@ TOTP モバイルアプリを使って認証できない場合は、SMS メッ ほとんどのデバイスとブラウザでは、USB または NFC を介して物理セキュリティキーを使用できます。 一部のブラウザでは、デバイス上の指紋リーダー、顔認識、またはパスワード/ PIN をセキュリティキーとして使用できます。 -セキュリティキーによる認証は、TOTP アプリケーション{% if currentVersion == "free-pro-team@latest" %}またはテキストメッセージ{% endif %}による認証の*二次的な*方法です。 セキュリティキーをなくした場合でも、モバイルデバイスのコードを使ってサインインできます。 +Authentication with a security key is *secondary* to authentication with a TOTP application{% if currentVersion == "free-pro-team@latest" %} or a text message{% endif %}. セキュリティキーをなくした場合でも、モバイルデバイスのコードを使ってサインインできます。 -1. TOTP モバイルアプリ{% if currentVersion == "free-pro-team@latest" %}または SMS{% endif %} 経由で、あらかじめ 2 要素認証を設定しておく必要があります。 -2. お手元のコンピュータに -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}WebAuthn{% else %}FIDO U2F{% endif %} に対応したセキュリティキーが挿入されていることを確認してください。 +1. You must have already configured 2FA via a TOTP mobile app{% if currentVersion == "free-pro-team@latest" %} or via SMS{% endif %}. +2. Ensure that you have a WebAuthn compatible security key inserted into your computer. {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.security %} 5. [Security keys] の隣にある [**Add**] をクリックします。 ![セキュリティキーの追加オプション](/assets/images/help/2fa/add-security-keys-option.png) -6. [Security keys] で、[**Register new security key**] をクリックします。 - {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - ![新しいセキュリティキーを登録する](/assets/images/help/2fa/security-key-register.png) - {% else %} - ![新しい FIDO U2F デバイスを登録する](/assets/images/help/2fa/register_new_fido_u2f_device.png) - {% endif %} -7. セキュリティキーのニックネームを入力して、[**Add**] をクリックします。 - {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - ![セキュリティキーにニックネームを付ける](/assets/images/help/2fa/security-key-nickname.png) - {% else %} - ![FIDO U2F デバイスにニックネームを付ける](/assets/images/help/2fa/fido_u2f_nickname.png) - {% endif %} -8. お手持ちのセキュリティキーのドキュメンテーションに従い、セキュリティキーをアクティベートします。 - {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - ![セキュリティキーのプロンプト](/assets/images/help/2fa/security-key-prompt.png) - {% else %} - ![FIDO U2F デバイスのプロンプト](/assets/images/help/2fa/fido_u2f_prompt_key.png) - {% endif %} +6. [Security keys] で、[**Register new security key**] をクリックします。 ![新しいセキュリティキーを登録する](/assets/images/help/2fa/security-key-register.png) +7. セキュリティキーのニックネームを入力して、[**Add**] をクリックします。 ![セキュリティキーにニックネームを付ける](/assets/images/help/2fa/security-key-nickname.png) +8. お手持ちのセキュリティキーのドキュメンテーションに従い、セキュリティキーをアクティベートします。 ![セキュリティキーのプロンプト](/assets/images/help/2fa/security-key-prompt.png) 9. リカバリコードをダウンロードしていて、アクセスできることを確認してください。 まだコードをダウンロードしていないか、コードのセットをもう 1 つ生成したい場合は、コードをダウンロードして、安全な場所に保存します。 アカウントにアクセスできなくなった場合、リカバリコードを使ってアカウントへのアクセスを回復できます。 詳しい情報については[2FA クレデンシャルをなくした際のアカウントの回復](/articles/recovering-your-account-if-you-lose-your-2fa-credentials)を参照してください。 ![[Download recovery codes] ボタン](/assets/images/help/2fa/2fa-recover-during-setup.png) {% data reusables.two_fa.test_2fa_immediately %} diff --git a/translations/ja-JP/content/github/authenticating-to-github/connecting-with-third-party-applications.md b/translations/ja-JP/content/github/authenticating-to-github/connecting-with-third-party-applications.md index e9d3ca4e9248..9f204d396843 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/connecting-with-third-party-applications.md +++ b/translations/ja-JP/content/github/authenticating-to-github/connecting-with-third-party-applications.md @@ -57,7 +57,7 @@ versions: | デプロイメント | デプロイメントのステータスへアクセスできれば、アプリケーションはパブリックおよびプライベートのリポジトリの特定のコミットに対してデプロイメントが成功したかどうかを判定できます。 アプリケーションは、コードにはアクセスできません。 | | Gist | [Gist](https://gist.github.com) アクセスがあれば、アプリケーションはあなたのパブリックおよびシークレット Gist の両方を読み書きできます。 | | フック | [webhook](/webhooks) アクセスがあれば、アプリケーションはあなたが管理するリポジトリ上のフックの設定を読み書きできます。 | -| 通知 | 通知アクセスがあれば、アプリケーションは Issue やプルリクエストへのコメントなど、あなたの {% data variables.product.product_name %}通知を読むことができます。 ただし、アプリケーションはリポジトリ内へはアクセスできません。 | +| 通知 | 通知アクセスがあれば、アプリケーションは Issue やプルリクエストへのコメントなど、あなたの {% data variables.product.product_name %}通知を読むことができます。 ただし、アプリケーションはリポジトリ内へはアクセスできません。 | | Organization および Team | Organization および Team のアクセスがあれば、アプリケーションは Organization および Team のメンバー構成へのアクセスと管理ができます。 | | 個人ユーザデータ | ユーザデータには、名前、メールアドレス、所在地など、ユーザプロファイル内の情報が含まれます。 | | リポジトリ | リポジトリ情報には、コントリビュータの名前、あなたが作成したブランチ、リポジトリ内の実際のファイルなどが含まれます。 アプリケーションは、ユーザ単位でパブリックまたはプライベートリポジトリへのアクセスをリクエストできます。 | diff --git a/translations/ja-JP/content/github/authenticating-to-github/creating-a-personal-access-token.md b/translations/ja-JP/content/github/authenticating-to-github/creating-a-personal-access-token.md index 45ef1e5b8bf9..b94b1d1a5906 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/creating-a-personal-access-token.md +++ b/translations/ja-JP/content/github/authenticating-to-github/creating-a-personal-access-token.md @@ -13,7 +13,7 @@ versions: 個人アクセストークン（PAT）は、[GitHub API](/v3/auth/#via-oauth-and-personal-access-tokens) または[コマンドライン](#using-a-token-on-the-command-line)を使用するときに {% data variables.product.product_name %} への認証でパスワードの代わりに使用できます。 -{% if currentVersion == "free-pro-team@latest" %}PAT を使用して、SAML SSO を使用する Organization が所有するリソースにアクセスする場合は、PAT を認証する必要があります。 詳しい情報については「[SAMLシングルサインオンでの認証について](/articles/about-authentication-with-saml-single-sign-on)」及び「[SAMLシングルサインオンで利用する個人アクセストークンの認可](/articles/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on)」を参照してください。{% endif %} +{% if currentVersion == "free-pro-team@latest" %}If you want to use a PAT to access resources owned by an organization that uses SAML SSO, you must authorize the PAT. 詳しい情報については「[SAMLシングルサインオンでの認証について](/articles/about-authentication-with-saml-single-sign-on)」及び「[SAMLシングルサインオンで利用する個人アクセストークンの認可](/articles/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on)」を参照してください。{% endif %} {% if currentVersion == "free-pro-team@latest" %}{% data reusables.user_settings.removes-personal-access-tokens %}{% endif %} @@ -27,8 +27,8 @@ versions: 5. トークンにわかりやすい名前を付けます。 ![トークンの説明フィールド](/assets/images/help/settings/token_description.png) 6. このトークンに付与するスコープ、すなわち権限を選択します。 トークンを使用してコマンドラインからリポジトリにアクセスするには、[**repo**] を選択します。 ![トークンスコープの選択](/assets/images/help/settings/token_scopes.gif) 7. [**Generate token**] をクリックします。 ![[Generate token] ボタン](/assets/images/help/settings/generate_token.png) -8. {% octicon "clippy" aria-label="The copy to clipboard icon" %}をクリックしてトークンをクリップボードにコピーします。 セキュリティ上の理由により、ページの外に移動すると、再びこのトークンを見ることはできません。{% if currentVersion == "free-pro-team@latest" %} ![新しく作成されたトークン](/assets/images/help/settings/personal_access_tokens.png){% else %} -![新しく作成されたトークン](/assets/images/help/settings/personal_access_tokens_ghe.png){% endif %} +8. {% octicon "clippy" aria-label="The copy to clipboard icon" %}をクリックしてトークンをクリップボードにコピーします。 For security reasons, after you navigate off the page, you will not be able to see the token again.{% if currentVersion == "free-pro-team@latest" %} ![Newly created token](/assets/images/help/settings/personal_access_tokens.png){% else %} +![Newly created token](/assets/images/help/settings/personal_access_tokens_ghe.png){% endif %} {% warning %} diff --git a/translations/ja-JP/content/github/authenticating-to-github/disabling-two-factor-authentication-for-your-personal-account.md b/translations/ja-JP/content/github/authenticating-to-github/disabling-two-factor-authentication-for-your-personal-account.md index f10b7046bfd4..68d5508725f7 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/disabling-two-factor-authentication-for-your-personal-account.md +++ b/translations/ja-JP/content/github/authenticating-to-github/disabling-two-factor-authentication-for-your-personal-account.md @@ -1,6 +1,6 @@ --- title: 個人アカウントの 2 要素認証を無効化する -intro: 自分の個人アカウントの 2 要素認証を無効化すると、所属する Organization へのアクセスも失う可能性があります。 +intro: '自分の個人アカウントの 2 要素認証を無効化すると、所属する Organization へのアクセスも失う可能性があります。' redirect_from: - /articles/disabling-two-factor-authentication-for-your-personal-account versions: @@ -12,7 +12,7 @@ versions: {% warning %} -**警告:** 2 要素認証を必要とする Organization のメンバー{% if currentVersion == "free-pro-team@latest" %}、支払いマネージャー{% endif %}、または Organization のパブリックリポジトリへの外部コラボレーターが 2 要素認証を無効化すると、Organization から自動的に削除され、リポジトリへのアクセスを失います。 Organization へのアクセスを再取得するには、2 要素認証を再有効化し、Organization オーナーに連絡します。 +**Warning:** If you're a member{% if currentVersion == "free-pro-team@latest" %}, billing manager,{% endif %} or outside collaborator to a public repository of an organization that requires two-factor authentication and you disable 2FA, you'll be automatically removed from the organization, and you'll lose your access to their repositories. Organization へのアクセスを再取得するには、2 要素認証を再有効化し、Organization オーナーに連絡します。 {% endwarning %} diff --git a/translations/ja-JP/content/github/authenticating-to-github/error-key-already-in-use.md b/translations/ja-JP/content/github/authenticating-to-github/error-key-already-in-use.md index aec1c6188754..9bbab737a89e 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/error-key-already-in-use.md +++ b/translations/ja-JP/content/github/authenticating-to-github/error-key-already-in-use.md @@ -1,6 +1,6 @@ --- title: 'Error: Key already in use' -intro: このエラーは、他のアカウントやリポジトリにすでに追加されているキーを追加 (/articles/adding-a-new-ssh-key-to-your-github-account) しようとする場合に発生します。 +intro: 'このエラーは、他のアカウントやリポジトリにすでに追加されているキーを追加 (/articles/adding-a-new-ssh-key-to-your-github-account) しようとする場合に発生します。' redirect_from: - /articles/error-key-already-in-use versions: diff --git a/translations/ja-JP/content/github/authenticating-to-github/error-permission-denied-publickey.md b/translations/ja-JP/content/github/authenticating-to-github/error-permission-denied-publickey.md index 7967a9335441..75af14ce4136 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/error-permission-denied-publickey.md +++ b/translations/ja-JP/content/github/authenticating-to-github/error-permission-denied-publickey.md @@ -1,6 +1,6 @@ --- title: 'Error: Permission denied (publickey)' -intro: 「Permission denied」エラーは、サーバーが接続を却下したことを示します。 原因はいくつか考えられますが、最も一般的な例を説明します。 +intro: 'A "Permission denied" error means that the server rejected your connection. There could be several reasons why, and the most common examples are explained below.' redirect_from: - /articles/error-permission-denied-publickey versions: @@ -8,66 +8,74 @@ versions: enterprise-server: '*' --- -### `sudo` コマンドを Git で使用すべきか +### Should the `sudo` command be used with Git? -`sudo` コマンドは Git で使用するべきではありません。 `sudo` を使用しなければならない*特別な理由*がある場合は、各コマンドで使用するようにしてください (その時点で、シェルを root として取得するために `su` を使用するほうがおそらくベターです)。 `sudo` なしで [SSH キー](/articles/generating-an-ssh-key)を使用し、`sudo git push` などのコマンドの使用を試す場合は、生成したのと同じキーを使用しないでしょう。 +You should not be using the `sudo` command with Git. If you have a *very good reason* you must use `sudo`, then ensure you are using it with every command (it's probably just better to use `su` to get a shell as root at that point). If you [generate SSH keys](/articles/generating-an-ssh-key) without `sudo` and then try to use a command like `sudo git push`, you won't be using the same keys that you generated. -### 正しいサーバーに接続していることを確認する +### Check that you are connecting to the correct server -キーボードで入力するというのは骨の折れる作業です。 入力内容に注意を払ってください。「githib.com」や「guthub.com」に接続することはできません。 一部の場合、企業ネットワークによって DNS レコードの解決の問題も発生します。 +Typing is hard, we all know it. Pay attention to what you type; you won't be able to connect to "githib.com" or "guthub.com". In some cases, a corporate network may cause issues resolving the DNS record as well. -正しいドメインに接続していることを確かめるには、以下のコマンドを入力します: +To make sure you are connecting to the right domain, you can enter the following command: ```shell $ ssh -vT git@{% data variables.command_line.codeblock %} -> OpenSSH_5.6p1, OpenSSL 0.9.8r 8 Feb 2011 +> OpenSSH_8.1p1, LibreSSL 2.7.3 > debug1: Reading configuration data /Users/you/.ssh/config -> debug1: Reading configuration data /etc/ssh_config -> debug1: Applying options for * -> debug1: Connecting to {% data variables.command_line.codeblock %} [IP ADDRESS] port 22. +> debug1: Reading configuration data /etc/ssh/ssh_config +> debug1: /etc/ssh/ssh_config line 47: Applying options for * +> debug1: Connecting to {% data variables.command_line.codeblock %} port 22. ``` -{% if currentVersion == "free-pro-team@latest" %}設定を[HTTPS を介した SSH](/articles/using-ssh-over-the-https-port)を使用するようオーバーライドしていない限り、{% endif %}接続はポート 22で行われるはずです。 +The connection should be made on port 22{% if currentVersion == "free-pro-team@latest" %}, unless you're overriding settings to use [SSH over HTTPS](/articles/using-ssh-over-the-https-port){% endif %}. -### 常に「git」ユーザを使用する +### Always use the "git" user -リモート URL 向けを含むすべての接続は、「git」ユーザとして行われる必要があります。 {% data variables.product.product_name %} のユーザ名で接続しようとすると、失敗します: +All connections, including those for remote URLs, must be made as the "git" user. If you try to connect with your {% data variables.product.product_name %} username, it will fail: ```shell $ ssh -T GITHUB-USERNAME@{% data variables.command_line.codeblock %} > Permission denied (publickey). ``` -接続が失敗し、{% data variables.product.product_name %}のユーザ名でリモート URL を使用している場合は、[「git」ユーザを使用するようリモート URL を変更](/articles/changing-a-remote-s-url/)できます。 +If your connection failed and you're using a remote URL with your {% data variables.product.product_name %} username, you can [change the remote URL to use the "git" user](/articles/changing-a-remote-s-url/). -以下を入力して接続を確認します: +You should verify your connection by typing: ```shell $ ssh -T git@{% data variables.command_line.codeblock %} > Hi username! You've successfully authenticated... ``` -### 使用中のキーを持っていることを確認する +### Make sure you have a key that is being used {% mac %} {% data reusables.command_line.open_the_multi_os_terminal %} -2. プライベートキーを生成し SSH に読み込ませていることを確認します。 OpenSSH 6.7 より前のバージョンを使用している場合: +2. Verify that you have a private key generated and loaded into SSH. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell - # バックグラウンドで ssh-agent を起動する + # start the ssh-agent in the background $ eval "$(ssh-agent -s)" > Agent pid 59566 $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` - OpenSSH 6.8 以降を使用している場合: + If you're using OpenSSH 6.8 or newer: ```shell - # バックグラウンドでssh-agentを起動する + # start the ssh-agent in the background $ eval "$(ssh-agent -s)" > Agent pid 59566 $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + # start the ssh-agent in the background + $ eval "$(ssh-agent -s)" + > Agent pid 59566 + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} {% endmac %} @@ -78,54 +86,65 @@ $ ssh -T git@{% data variables.command_line.codeblock %} 1. {% data reusables.desktop.windows_git_bash_turn_on_ssh_agent %} {% data reusables.desktop.windows_git_for_windows_turn_on_ssh_agent %} -2. プライベートキーを生成し SSH に読み込ませていることを確認します。 OpenSSH 6.7 より前のバージョンを使用している場合: +2. Verify that you have a private key generated and loaded into SSH. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` - OpenSSH 6.8 以降を使用している場合: + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} {% endwindows %} {% linux %} {% data reusables.command_line.open_the_multi_os_terminal %} -2. プライベートキーを生成し SSH に読み込ませていることを確認します。 OpenSSH 6.7 より前のバージョンを使用している場合: +2. Verify that you have a private key generated and loaded into SSH. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell - # バックグラウンドで ssh-agent を起動する + # start the ssh-agent in the background $ eval "$(ssh-agent -s)" > Agent pid 59566 $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` - OpenSSH 6.8 以降を使用している場合: + If you're using OpenSSH 6.8 or newer: ```shell - # バックグラウンドでssh-agentを起動する + # start the ssh-agent in the background $ eval "$(ssh-agent -s)" > Agent pid 59566 $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} + {% endlinux %} -`ssh-add` コマンドによって、英数字の長い文字列がプリントアウトされる*はずです*。 何もプリントされない場合は、[新しい SSH キーを生成](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)して {% data variables.product.product_name %}と関連付ける必要があります。 +The `ssh-add` command *should* print out a long string of numbers and letters. If it does not print anything, you will need to [generate a new SSH key](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) and associate it with {% data variables.product.product_name %}. {% tip %} -**ヒント**: 多くのシステムでは、デフォルトの秘密鍵 (`~/.ssh/id_rsa`{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}、`~/.ssh/id_dsa`、{% endif %}および`~/.ssh/identity`) は、SSH 認証エージェントに自動追加されます。 キーの生成時にファイル名を上書きしていない限り、`ssh-add path/to/key` を実行する必要はありません。 +**Tip**: On most systems the default private keys (`~/.ssh/id_rsa` and `~/.ssh/identity`) are automatically added to the SSH authentication agent. You shouldn't need to run `ssh-add path/to/key` unless you override the file name when you generate a key. {% endtip %} -#### 詳細を確認する +#### Getting more details -`git@{% data variables.command_line.backticks %}` への接続を試して、キーが使用されていることを確認することもできます。 +You can also check that the key is being used by trying to connect to `git@{% data variables.command_line.backticks %}`: ```shell $ ssh -vT git@{% data variables.command_line.codeblock %} @@ -143,7 +162,7 @@ $ ssh -vT git@{% data variables.command_line.codeblock %} > Permission denied (publickey). ``` -この例では、SSH が使用するキーはありませんでした。 「identity file」行の最後の「-1」は、SSH が使用するファイルを見つけることができなかったことを示します。 その後、「Trying private key」の行でもファイルが見つからなかったことが示されています。 ファイルが存在する場合は、これらの行はそれぞれ「1」と「Offering public key」になります。 +In that example, we did not have any keys for SSH to use. The "-1" at the end of the "identity file" lines means SSH couldn't find a file to use. Later on, the "Trying private key" lines also indicate that no file was found. If a file existed, those lines would be "1" and "Offering public key", respectively: ```shell $ ssh -vT git@{% data variables.command_line.codeblock %} @@ -155,77 +174,89 @@ $ ssh -vT git@{% data variables.command_line.codeblock %} > debug1: Offering RSA public key: /Users/you/.ssh/id_rsa ``` -### 公開鍵がアカウントに添付されていることを確認する +### Verify the public key is attached to your account -公開鍵を {% data variables.product.product_name %} に提供して、安全な接続を確立する必要があります。 +You must provide your public key to {% data variables.product.product_name %} to establish a secure connection. {% mac %} -1. ターミナルを開きます。 -2. バックグラウンドで SSH エージェントを開始します。 +1. Open Terminal. +2. Start SSH agent in the background. ```shell $ eval "$(ssh-agent -s)" > Agent pid 59566 ``` -3. 自分の公開鍵のフィンガープリントを見つけてメモします。 OpenSSH 6.7 より前のバージョンを使用している場合: +3. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` - OpenSSH 6.8 以降を使用している場合: + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -6. SSH キーのリストを、`ssh-add` コマンドの出力と比較します。 ![{% data variables.product.product_name %} の SSH キーのリスト](/assets/images/help/settings/ssh_key_listing.png) +6. Compare the list of SSH keys with the output from the `ssh-add` command. +![SSH key listing in {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png) {% endmac %} {% windows %} -1. コマンドラインを開きます。 -2. バックグラウンドで SSH エージェントを開始します。 +1. Open the command line. +2. Start SSH agent in the background. ```shell $ ssh-agent -s > Agent pid 59566 ``` -3. 自分の公開鍵のフィンガープリントを見つけてメモします。 OpenSSH 6.7 より前のバージョンを使用している場合: +3. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` - OpenSSH 6.8 以降を使用している場合: + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -6. SSH キーのリストを、`ssh-add` コマンドの出力と比較します。 ![{% data variables.product.product_name %} の SSH キーのリスト](/assets/images/help/settings/ssh_key_listing.png) +6. Compare the list of SSH keys with the output from the `ssh-add` command. +![SSH key listing in {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png) {% endwindows %} {% linux %} -1. ターミナルを開きます。 -2. バックグラウンドで SSH エージェントを開始します。 +1. Open Terminal. +2. Start SSH agent in the background. ```shell $ eval "$(ssh-agent -s)" > Agent pid 59566 ``` -3. 自分の公開鍵のフィンガープリントを見つけてメモします。 OpenSSH 6.7 より前のバージョンを使用している場合: +3. Find and take a note of your public key fingerprint. If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` - OpenSSH 6.8 以降を使用している場合: + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) @@ -233,14 +264,15 @@ $ ssh -vT git@{% data variables.command_line.codeblock %} {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -6. SSH キーのリストを、`ssh-add` コマンドの出力と比較します。 ![{% data variables.product.product_name %} の SSH キーのリスト](/assets/images/help/settings/ssh_key_listing.png) +6. Compare the list of SSH keys with the output from the `ssh-add` command. +![SSH key listing in {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png) {% endlinux %} -{% data variables.product.product_name %} で公開鍵が見つからない場合は、[{% data variables.product.product_name %} に SSH キーを追加](/articles/adding-a-new-ssh-key-to-your-github-account)してコンピュータと関連付ける必要があります。 +If you don't see your public key in {% data variables.product.product_name %}, you'll need to [add your SSH key to {% data variables.product.product_name %}](/articles/adding-a-new-ssh-key-to-your-github-account) to associate it with your computer. {% warning %} -**警告**: 見慣れない SSH キーが {% data variables.product.product_name %} で見つかった場合は、すぐにそれを削除し、さらに支援が必要な場合は {% data variables.contact.contact_support %} に問い合わせてください。 確認できない公開鍵は、潜在的なセキュリティ上の問題を示している可能性があります。 詳細は「[SSH キーをレビューする](/articles/reviewing-your-ssh-keys)」を参照してください。 +**Warning**: If you see an SSH key you're not familiar with on {% data variables.product.product_name %}, delete it immediately and contact {% data variables.contact.contact_support %}, for further help. An unidentified public key may indicate a possible security concern. For more information, see "[Reviewing your SSH keys](/articles/reviewing-your-ssh-keys)." {% endwarning %} diff --git a/translations/ja-JP/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-userother-repo.md b/translations/ja-JP/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-userother-repo.md index a11215957ba0..a09293d977e8 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-userother-repo.md +++ b/translations/ja-JP/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-userother-repo.md @@ -1,6 +1,6 @@ --- title: 'Error: Permission to user/repo denied to user/other-repo' -intro: このエラーは、プッシュに使用しているキーが、他のリポジトリにデプロイキーとして添付されており、プッシュ先のリポジトリへのアクセス権がないことを示しています。 +intro: 'このエラーは、プッシュに使用しているキーが、他のリポジトリにデプロイキーとして添付されており、プッシュ先のリポジトリへのアクセス権がないことを示しています。' redirect_from: - /articles/error-permission-to-user-repo-denied-to-user-other-repo - /articles/error-permission-to-userrepo-denied-to-userother-repo diff --git a/translations/ja-JP/content/github/authenticating-to-github/error-ssh-add-illegal-option----k.md b/translations/ja-JP/content/github/authenticating-to-github/error-ssh-add-illegal-option----k.md index 744ed39bd683..8ec5f48838e8 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/error-ssh-add-illegal-option----k.md +++ b/translations/ja-JP/content/github/authenticating-to-github/error-ssh-add-illegal-option----k.md @@ -1,6 +1,6 @@ --- title: 'Error: ssh-add: illegal option -- K' -intro: このエラーは、「ssh-add」のバージョンが、パスフレーズをキーチェーンに保管できる機能である、macOS のキーチェーンインテグレーションをサポートしていないことを意味しています。 +intro: 'このエラーは、「ssh-add」のバージョンが、パスフレーズをキーチェーンに保管できる機能である、macOS のキーチェーンインテグレーションをサポートしていないことを意味しています。' redirect_from: - /articles/error-ssh-add-illegal-option-k - /articles/error-ssh-add-illegal-option----k diff --git a/translations/ja-JP/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md b/translations/ja-JP/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md index ccd590c2bf9d..4dff090b337c 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md +++ b/translations/ja-JP/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md @@ -10,8 +10,8 @@ versions: 以下のようなエラーが表示されます: ```shell -$ git push -u github.master -> fatal: 'github.master' does not appear to be a git repository +$ git push -u github.main +> fatal: 'github.main' does not appear to be a git repository > fatal: The remote end hung up unexpectedly $ git pull -u github diff --git a/translations/ja-JP/content/github/authenticating-to-github/generating-a-new-gpg-key.md b/translations/ja-JP/content/github/authenticating-to-github/generating-a-new-gpg-key.md index 7eacb68e6c28..17f663baa655 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/generating-a-new-gpg-key.md +++ b/translations/ja-JP/content/github/authenticating-to-github/generating-a-new-gpg-key.md @@ -1,6 +1,6 @@ --- title: 新しい GPG キーを生成する -intro: 既存の GPG キーがない場合は、新しい GPG キーを生成してコミットおよびタグの署名に使用できます。 +intro: '既存の GPG キーがない場合は、新しい GPG キーを生成してコミットおよびタグの署名に使用できます。' redirect_from: - /articles/generating-a-new-gpg-key versions: @@ -14,7 +14,7 @@ versions: {% note %} -**メモ:** 新しい GPG キーを生成する前にメールアドレスを検証しておいてください。 メールアドレスを検証していないと、GPG を使用してコミットやタグに署名できません。{% if currentVersion == "free-pro-team@latest" %}詳細は「[メールアドレスを検証する](/articles/verifying-your-email-address)」を参照してください。{% endif %} +**メモ:** 新しい GPG キーを生成する前にメールアドレスを検証しておいてください。 If you haven't verified your email address, you won't be able to sign commits and tags with GPG.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[Verifying your email address](/articles/verifying-your-email-address)."{% endif %} {% endnote %} @@ -37,7 +37,7 @@ versions: {% note %} - **メモ:** メールアドレスの入力を求められた場合は、GitHub アカウント用の検証済みメールアドレスを入力してください。 {% data reusables.gpg.private-email %} {% if currentVersion == "free-pro-team@latest" %}詳細は「[メールアドレスを検証する](/articles/verifying-your-email-address)」および「[コミットメールアドレスを設定する](/articles/setting-your-commit-email-address)」を参照してください。{% endif %} + **メモ:** メールアドレスの入力を求められた場合は、GitHub アカウント用の検証済みメールアドレスを入力してください。 {% data reusables.gpg.private-email %} {% if currentVersion == "free-pro-team@latest" %} For more information, see "[Verifying your email address](/articles/verifying-your-email-address)" and "[Setting your commit email address](/articles/setting-your-commit-email-address)."{% endif %} {% endnote %} diff --git a/translations/ja-JP/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md b/translations/ja-JP/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md index 6502fb183747..3778d44dcdbc 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md +++ b/translations/ja-JP/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md @@ -1,6 +1,6 @@ --- title: 新しい SSH キーを生成して ssh-agent に追加する -intro: 既存の SSH キーをチェックした後、新しい SSH キーを生成して認証に使用し、ssh-agent に追加できます。 +intro: '既存の SSH キーをチェックした後、新しい SSH キーを生成して認証に使用し、ssh-agent に追加できます。' redirect_from: - /articles/adding-a-new-ssh-key-to-the-ssh-agent/ - /articles/generating-a-new-ssh-key/ diff --git a/translations/ja-JP/content/github/authenticating-to-github/index.md b/translations/ja-JP/content/github/authenticating-to-github/index.md index 79a2d9f8f3da..934de1a230db 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/index.md +++ b/translations/ja-JP/content/github/authenticating-to-github/index.md @@ -1,7 +1,7 @@ --- title: GitHubへの認証方法 shortTitle: 認証 -intro: 2要素認証、SSH、コミット署名の検証などの機能を使用して、アカウントとデータを保護します。 +intro: '2要素認証、SSH、コミット署名の検証などの機能を使用して、アカウントとデータを保護します。' redirect_from: - /categories/56/articles/ - /categories/ssh/ diff --git a/translations/ja-JP/content/github/authenticating-to-github/managing-commit-signature-verification.md b/translations/ja-JP/content/github/authenticating-to-github/managing-commit-signature-verification.md index aad5bcfa57cd..87fb38d2f128 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/managing-commit-signature-verification.md +++ b/translations/ja-JP/content/github/authenticating-to-github/managing-commit-signature-verification.md @@ -1,6 +1,6 @@ --- title: コミット署名の検証を管理する -intro: 'GPG {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %}または S/MIME {% endif %}を使用して、作業にローカルで署名できます。 信頼できるソースによるコミットであることを他のユーザに知らせるために、{% data variables.product.product_name %} はこの署名を検証します。{% if currentVersion == "free-pro-team@latest" %} {% data variables.product.product_name %} は、{% data variables.product.product_name %} Web インターフェイスを使用して自動的にコミットに署名します。{% endif %}' +intro: 'You can sign your work locally using GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} or S/MIME{% endif %}. {% data variables.product.product_name %} will verify these signatures so other people will know that your commits come from a trusted source.{% if currentVersion == "free-pro-team@latest" %} {% data variables.product.product_name %} will automatically sign commits you make using the {% data variables.product.product_name %} web interface.{% endif %}' redirect_from: - /articles/generating-a-gpg-key/ - /articles/signing-commits-with-gpg/ diff --git a/translations/ja-JP/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md b/translations/ja-JP/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md index b392a9228c60..ba4bc5ac7ba2 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md +++ b/translations/ja-JP/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md @@ -1,6 +1,6 @@ --- title: 2 要素認証クレデンシャルをなくした際のアカウントの回復 -intro: 2 要素認証の認証情報にアクセスできなくなった場合、リカバリコードまたはその他のリカバリ方法を使用して、アカウントへのアクセスを回復できます。 +intro: '2 要素認証の認証情報にアクセスできなくなった場合、リカバリコードまたはその他のリカバリ方法を使用して、アカウントへのアクセスを回復できます。' redirect_from: - /articles/recovering-your-account-if-you-lost-your-2fa-credentials/ - /articles/authenticating-with-an-account-recovery-token/ @@ -81,7 +81,8 @@ versions: 1. Facebook で、[セキュリティ設定](https://www.facebook.com/settings?tab=security)に移動し、[**Recovery Accounts Elsewhere**] をクリックします。 ![Facebook のセキュリティ設定ページと Recovery Accounts Elsewhere リンク](/assets/images/help/settings/security-facebook-security-settings-page.png) 2. {% data variables.product.product_name %}アカウントに関連付けられているリカバリトークンをクリックします。 ![Facebook に格納されているリカバリトークンのリスト](/assets/images/help/settings/security-github-rae-token-on-facebook.png) 3. アカウントリカバリトークンを引き換えるため、[**Recover This Account**] をクリックします。 新しいウィンドウが開き、{% data variables.product.product_name %}に戻ります。 ![リカバリトークンについての情報を表示するモーダルボックスおよび [Recover This Account] ボタン](/assets/images/help/settings/security-recover-account-facebook.png) -4. {% data variables.contact.contact_support %} に連絡して、アカウントリカバリトークンはレビューの準備ができていることを知らせます。 +4. お問い合わせ +{% data variables.contact.contact_support %} to let them know that your account recovery token is ready for review. {% endif %} ### 参考リンク diff --git a/translations/ja-JP/content/github/authenticating-to-github/recovering-your-ssh-key-passphrase.md b/translations/ja-JP/content/github/authenticating-to-github/recovering-your-ssh-key-passphrase.md index eb8c7d48e1bd..7219fc53c409 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/recovering-your-ssh-key-passphrase.md +++ b/translations/ja-JP/content/github/authenticating-to-github/recovering-your-ssh-key-passphrase.md @@ -1,6 +1,6 @@ --- title: SSH キーのパスフレーズのリカバリ -intro: SSH キーのパスフレーズをなくした場合、ご使用のオペレーティングシステムによって、リカバリができることもあれば、SSH キーのパスフレーズを新たに生成することが必要なこともあります。 +intro: 'SSH キーのパスフレーズをなくした場合、ご使用のオペレーティングシステムによって、リカバリができることもあれば、SSH キーのパスフレーズを新たに生成することが必要なこともあります。' redirect_from: - /articles/how-do-i-recover-my-passphrase/ - /articles/how-do-i-recover-my-ssh-key-passphrase/ diff --git a/translations/ja-JP/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md b/translations/ja-JP/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md index a4146901702a..367f41378f7a 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md +++ b/translations/ja-JP/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md @@ -1,6 +1,6 @@ --- title: 機密データをリポジトリから削除する -intro: Git リポジトリへのパスワードや SSH キーといった機密データをコミットする場合、そのデータを履歴から削除することができます。 不要なファイルをリポジトリの履歴から完全に削除するには、「git filter-branch」コマンドか BFG Repo-Cleaner オープンソースツールのいずれかを使用します。 +intro: 'Git リポジトリへのパスワードや SSH キーといった機密データをコミットする場合、そのデータを履歴から削除することができます。 不要なファイルをリポジトリの履歴から完全に削除するには、「git filter-branch」コマンドか BFG Repo-Cleaner オープンソースツールのいずれかを使用します。' redirect_from: - /remove-sensitive-data/ - /removing-sensitive-data/ @@ -71,10 +71,10 @@ $ bfg --replace-text passwords.txt - **既存のタグを上書きする** ```shell $ git filter-branch --force --index-filter \ - "git rm --cached --ignore-unmatch 機密データを含むファイルへのパス" \ + "git rm --cached --ignore-unmatch PATH-TO-YOUR-FILE-WITH-SENSITIVE-DATA" \ --prune-empty --tag-name-filter cat -- --all > Rewrite 48dc599c80e20527ed902928085e7861e6b3cbe6 (266/266) - > Ref 'refs/heads/master' was rewritten + > Ref 'refs/heads/main' was rewritten ``` {% note %} @@ -86,10 +86,10 @@ $ bfg --replace-text passwords.txt 4. 機密データを含むファイルを、誤って再度コミットしないようにするため、`.gitignore` に追加します。 ```shell - $ echo "機密データを含むファイル" >> .gitignore + $ echo "YOUR-FILE-WITH-SENSITIVE-DATA" >> .gitignore $ git add .gitignore - $ git commit -m "Add 機密データを含むファイル to .gitignore" - > [master 051452f] Add 機密データを含むファイル to .gitignore + $ git commit -m "Add YOUR-FILE-WITH-SENSITIVE-DATA to .gitignore" + > [main 051452f] Add YOUR-FILE-WITH-SENSITIVE-DATA to .gitignore > 1 files changed, 1 insertions(+), 0 deletions(-) ``` 5. リポジトリの履歴から削除対象をすべて削除したこと、すべてのブランチがチェックアウトされたことをダブルチェックします。 @@ -101,8 +101,8 @@ $ bfg --replace-text passwords.txt > Compressing objects: 100% (677/677), done. > Writing objects: 100% (1058/1058), 148.85 KiB, done. > Total 1058 (delta 590), reused 602 (delta 378) - > To https://{% data variables.command_line.codeblock %}/ユーザ名/リポジトリ.git - > + 48dc599...051452f master -> master (forced update) + > To https://{% data variables.command_line.codeblock %}/YOUR-USERNAME/YOUR-REPOSITORY.git + > + 48dc599...051452f main -> main (forced update) ``` 7. 機密データを[タグ付きリリース](/articles/about-releases)から削除するため、Git タグに対しても次のようにフォースプッシュする必要があります。 ```shell @@ -112,8 +112,8 @@ $ bfg --replace-text passwords.txt > Compressing objects: 100% (166/166), done. > Writing objects: 100% (321/321), 331.74 KiB | 0 bytes/s, done. > Total 321 (delta 124), reused 269 (delta 108) - > To https://{% data variables.command_line.codeblock %}/ユーザ名/リポジトリ.git - > + 48dc599...051452f master -> master (forced update) + > To https://{% data variables.command_line.codeblock %}/YOUR-USERNAME/YOUR-REPOSITORY.git + > + 48dc599...051452f main -> main (forced update) ``` 8. {% data variables.contact.contact_support %} に連絡し、{% data variables.product.product_name %} 上で、キャッシュされているビューと、プルリクエストでの機密データへの参照を削除するよう依頼します。 9. コラボレータには、 作成したブランチを古い (汚染された) リポジトリ履歴から[リベース](https://git-scm.com/book/en/Git-Branching-Rebasing)する (マージ*しない*) よう伝えます。 マージコミットを 1 回でも行うと、パージで問題が発生したばかりの汚染された履歴の一部または全部が再導入されてしまいます。 diff --git a/translations/ja-JP/content/github/authenticating-to-github/reviewing-your-authorized-applications-oauth.md b/translations/ja-JP/content/github/authenticating-to-github/reviewing-your-authorized-applications-oauth.md index 99d6aac7d722..921d306498e0 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/reviewing-your-authorized-applications-oauth.md +++ b/translations/ja-JP/content/github/authenticating-to-github/reviewing-your-authorized-applications-oauth.md @@ -1,6 +1,6 @@ --- title: 許可されたアプリケーション (OAuth) をレビューする -intro: プライベート リポジトリにアクセス権があるような、広範囲な権限がある新しいアプリケーションが許可されていないことを検証するために、許可されたお使いのアプリケーションをレビューしてください。 +intro: 'プライベート リポジトリにアクセス権があるような、広範囲な権限がある新しいアプリケーションが許可されていないことを検証するために、許可されたお使いのアプリケーションをレビューしてください。' redirect_from: - /articles/reviewing-your-authorized-applications-oauth versions: diff --git a/translations/ja-JP/content/github/authenticating-to-github/reviewing-your-security-log.md b/translations/ja-JP/content/github/authenticating-to-github/reviewing-your-security-log.md index 71174366f7ad..38e933477191 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/reviewing-your-security-log.md +++ b/translations/ja-JP/content/github/authenticating-to-github/reviewing-your-security-log.md @@ -1,6 +1,6 @@ --- -title: セキュリティログをレビューする -intro: ユーザアカウントのセキュリティログをレビューして、自分が実行したアクションと、他のユーザが実行したアクションについて詳しく知ることができます。 +title: Reviewing your security log +intro: You can review the security log for your user account to better understand actions you've performed and actions others have performed that involve you. redirect_from: - /articles/reviewing-your-security-log versions: @@ -8,233 +8,238 @@ versions: enterprise-server: '*' --- -### セキュリティログにアクセスする +### Accessing your security log -セキュリティログには、過去 90 日間に実行されたすべてのアクションが{% if currentVersion ver_lt "enterprise-server@2.20" %}最大 50 件まで{% endif %}リストされます。 +The security log lists all actions performed within the last 90 days{% if currentVersion ver_lt "enterprise-server@2.20" %}, up to 50{% endif %}. {% data reusables.user_settings.access_settings %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -2. ユーザ設定サイドバーで [**Security log**] をクリックします。 ![セキュリティログのタブ](/assets/images/help/settings/audit-log-tab.png) +2. In the user settings sidebar, click **Security log**. + ![Security log tab](/assets/images/help/settings/audit-log-tab.png) {% else %} {% data reusables.user_settings.security %} -3. [Security history] の下に、自分のログが表示されます。 ![セキュリティ ログ](/assets/images/help/settings/user_security_log.png) -4. エントリをクリックして、イベントに関する詳細情報を表示します。 ![セキュリティ ログ](/assets/images/help/settings/user_security_history_action.png) +3. Under "Security history," your log is displayed. + ![Security log](/assets/images/help/settings/user_security_log.png) +4. Click on an entry to see more information about the event. + ![Security log](/assets/images/help/settings/user_security_history_action.png) {% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -### セキュリティログを検索する +### Searching your security log {% data reusables.audit_log.audit-log-search %} -#### 実行されたアクションに基づく検索 +#### Search based on the action performed {% else %} -### セキュリティログでのイベントを理解する - -セキュリティログに一覧表示されるアクションは以下のカテゴリに分類されます。 |{% endif %} -| カテゴリー名 | 説明 | -| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" %} -| `account_recovery_token` | [リカバリトークンの追加](/articles/configuring-two-factor-authentication-recovery-methods)に関連するすべての活動が対象です。 | -| `支払い` | 自分の支払い情報に関連するすべての活動が対象です。 | -| `marketplace_agreement_signature` | {% data variables.product.prodname_marketplace %} Developer Agreement の署名に関連するすべての活動が対象です。 | -| `marketplace_listing` | {% data variables.product.prodname_marketplace %} に一覧表示しているアプリに関連するすべての活動が対象です。{% endif %} -| `oauth_access` | 接続している [{% data variables.product.prodname_oauth_app %}](/articles/authorizing-oauth-apps) に関連するすべての活動が対象です。{% if currentVersion == "free-pro-team@latest" %} -| `payment_method` | {% data variables.product.prodname_dotcom %} プランに対する支払いに関連するすべての活動が対象です。{% endif %} -| `profile_picture` | 自分のプロファイル写真に関連するすべての活動が対象です。 | -| `project` | プロジェクト ボードに関連するすべての活動が対象です。 | -| `public_key` | [公開 SSH キー](/articles/adding-a-new-ssh-key-to-your-github-account)に関連するすべての活動が対象です。 | -| `repo` | 自分が所有するリポジトリに関連するすべての活動が対象です。{% if currentVersion == "free-pro-team@latest" %} -| `sponsors` | {% data variables.product.prodname_sponsors %}およびスポンサーボタンに関連するすべての活動が対象です (「[{% data variables.product.prodname_sponsors %}について](/articles/about-github-sponsors)」と「[リポジトリにスポンサーボタンを表示する](/articles/displaying-a-sponsor-button-in-your-repository)」を参照){% endif %}{% if currentVersion != "free-pro-team@latest" %} -| `Team` | 自分が所属する Team に関連するすべての活動が対象です。{% endif %} -| `two_factor_authentication` | [2 要素認証](/articles/securing-your-account-with-two-factor-authentication-2fa)に関連するすべての活動が対象です。 | -| `ユーザ` | アカウントに関連するすべての活動が対象です。 | - -これらのカテゴリ内のイベントの説明は以下のとおりです。 +### Understanding events in your security log + +Actions listed in your security log are grouped within the following categories: +{% endif %} + +| Category Name | Description +|------------------|-------------------{% if currentVersion == "free-pro-team@latest" %} +| `account_recovery_token` | Contains all activities related to [adding a recovery token](/articles/configuring-two-factor-authentication-recovery-methods). +| `billing` | Contains all activities related to your billing information. +| `marketplace_agreement_signature` | Contains all activities related to signing the {% data variables.product.prodname_marketplace %} Developer Agreement. +| `marketplace_listing` | Contains all activities related to listing apps in {% data variables.product.prodname_marketplace %}.{% endif %} +| `oauth_access` | Contains all activities related to [{% data variables.product.prodname_oauth_app %}s](/articles/authorizing-oauth-apps) you've connected with.{% if currentVersion == "free-pro-team@latest" %} +| `payment_method` | Contains all activities related to paying for your {% data variables.product.prodname_dotcom %} subscription.{% endif %} +| `profile_picture` | Contains all activities related to your profile picture. +| `project` | Contains all activities related to project boards. +| `public_key` | Contains all activities related to [your public SSH keys](/articles/adding-a-new-ssh-key-to-your-github-account). +| `repo` | Contains all activities related to the repositories you own.{% if currentVersion == "free-pro-team@latest" %} +| `sponsors` | Contains all events related to {% data variables.product.prodname_sponsors %} and sponsor buttons (see "[About {% data variables.product.prodname_sponsors %}](/articles/about-github-sponsors)" and "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)"){% endif %}{% if currentVersion != "free-pro-team@latest" %} +| `team` | Contains all activities related to teams you are a part of.{% endif %} +| `two_factor_authentication` | Contains all activities related to [two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa). +| `user` | Contains all activities related to your account. + +A description of the events within these categories is listed below. {% if currentVersion == "free-pro-team@latest" %} -#### `account_recovery_token` カテゴリ +#### The `account_recovery_token` category -| アクション | 説明 | -| ------------- | ----------------------------------------------------------------------------------------------------------- | -| confirm | 正常に[リカバリプロバイダ付きの新たなトークンを保存する](/articles/configuring-two-factor-authentication-recovery-methods)ときにトリガーされます。 | -| recover | 正常に[アカウント リカバリ トークンを引き換える](/articles/recovering-your-account-if-you-lose-your-2fa-credentials)ときにトリガーされます。 | -| recover_error | トークンが使用されているにもかかわらず {% data variables.product.prodname_dotcom %} がそれを有効にできないときにトリガーされます。 | +| Action | Description +|------------------|------------------- +| confirm | Triggered when you successfully [store a new token with a recovery provider](/articles/configuring-two-factor-authentication-recovery-methods). +| recover | Triggered when you successfully [redeem an account recovery token](/articles/recovering-your-account-if-you-lose-your-2fa-credentials). +| recover_error | Triggered when a token is used but {% data variables.product.prodname_dotcom %} is not able to validate it. -#### `billing` カテゴリ +#### The `billing` category -| アクション | 説明 | -| --------------------- | ------------------------------------------------------------------------------------------------------------------------- | -| change_billing_type | {% data variables.product.prodname_dotcom %} の[支払い方法を変更する](/articles/adding-or-editing-a-payment-method)ときにトリガーされます。 | -| change_email | [自分のメール アドレスを変更する](/articles/changing-your-primary-email-address)ときにトリガーされます。 | +| Action | Description +|------------------|------------------- +| change_billing_type | Triggered when you [change how you pay](/articles/adding-or-editing-a-payment-method) for {% data variables.product.prodname_dotcom %}. +| change_email | Triggered when you [change your email address](/articles/changing-your-primary-email-address). -#### `marketplace_agreement_signature` カテゴリ +#### The `marketplace_agreement_signature` category -| アクション | 説明 | -| ------ | -------------------------------------------------------------------------------------------- | -| create | {% data variables.product.prodname_marketplace %} Developer Agreement に署名するときにトリガーされます。 | +| Action | Description +|------------------|------------------- +| create | Triggered when you sign the {% data variables.product.prodname_marketplace %} Developer Agreement. -#### `marketplace_listing` カテゴリ +#### The `marketplace_listing` category -| アクション | 説明 | -| ------- | ---------------------------------------------------------------------------------------- | -| 承認 | 一覧表を {% data variables.product.prodname_marketplace %}に掲載することが承認されるときにトリガーされます。 | -| create | {% data variables.product.prodname_marketplace %} で自分のアプリケーションの一覧表を作成するときにトリガーされます。 | -| delist | 一覧表が {% data variables.product.prodname_marketplace %} から削除されるときにトリガーされます。 | -| redraft | 一覧表がドラフト状態に戻されるときにトリガーされます。 | -| reject | 一覧表が {% data variables.product.prodname_marketplace %} に掲載することを認められないときにトリガーされます。 | +| Action | Description +|------------------|------------------- +| approve | Triggered when your listing is approved for inclusion in {% data variables.product.prodname_marketplace %}. +| create | Triggered when you create a listing for your app in {% data variables.product.prodname_marketplace %}. +| delist | Triggered when your listing is removed from {% data variables.product.prodname_marketplace %}. +| redraft | Triggered when your listing is sent back to draft state. +| reject | Triggered when your listing is not accepted for inclusion in {% data variables.product.prodname_marketplace %}. {% endif %} -#### `oauth_access` カテゴリ +#### The `oauth_access` category -| アクション | 説明 | -| ------- | --------------------------------------------------------------------------------------------------------------------------------------------- | -| create | [{% data variables.product.prodname_oauth_app %} へのアクセスを許可する](/articles/authorizing-oauth-apps)ときにトリガーされます。 | -| destroy | [自分のアカウントへの {% data variables.product.prodname_oauth_app %} のアクセス権を取り消す](/articles/reviewing-your-authorized-integrations)ときにトリガーされます。 | +| Action | Description +|------------------|------------------- +| create | Triggered when you [grant access to an {% data variables.product.prodname_oauth_app %}](/articles/authorizing-oauth-apps). +| destroy | Triggered when you [revoke an {% data variables.product.prodname_oauth_app %}'s access to your account](/articles/reviewing-your-authorized-integrations). {% if currentVersion == "free-pro-team@latest" %} -#### `payment_method` カテゴリ +#### The `payment_method` category -| アクション | 説明 | -| ------ | -------------------------------------------------------------------- | -| clear | ファイルでの[支払い方法](/articles/removing-a-payment-method)が削除されるときにトリガーされます。 | -| create | 新しいクレジット カードや PayPal アカウントなど、新たな支払い方法が追加されるときにトリガーされます。 | -| update | 既存の支払い方法が更新されるときにトリガーされます。 | +| Action | Description +|------------------|------------------- +| clear | Triggered when [a payment method](/articles/removing-a-payment-method) on file is removed. +| create | Triggered when a new payment method is added, such as a new credit card or PayPal account. +| update | Triggered when an existing payment method is updated. {% endif %} -#### `profile_picture` カテゴリ - -| アクション | 説明 | -| ------ | ---------------------------------------------------------------------------- | -| update | [自分のプロフィール写真を設定または更新する](/articles/setting-your-profile-picture/)ときにトリガーされます。 | - -#### `project` カテゴリ - -| アクション | 説明 | -| ------------------------ | ------------------------------------------------------------------------------------------------------------------------- | -| `create` | プロジェクト ボードが作成されるときにトリガーされます。 | -| `rename` | プロジェクトボードの名前が変更されるときにトリガーされます。 | -| `update` | プロジェクト ボードが更新されるときにトリガーされます。 | -| `delete` | プロジェクトボードが削除されるときにトリガーされます。 | -| `link` | リポジトリがプロジェクト ボードにリンクされるときにトリガーされます。 | -| `unlink` | リポジトリがプロジェクトボードからリンク解除されるときにトリガーされます。 | -| `project.access` | プロジェクト ボードの可視性が変更されるときにトリガーされます。 | -| `update_user_permission` | Triggered when an outside collaborator is added to or removed from a project board or has their permission level changed. | - -#### `public_key` カテゴリ - -| アクション | 説明 | -| ------ | ----------------------------------------------------------------------------------------------------------------------------------------------- | -| create | [新たな公開 SSH キーを自分の {% data variables.product.product_name %} アカウントに追加する](/articles/adding-a-new-ssh-key-to-your-github-account)ときにトリガーされます。 | -| delete | [公開 SSH キーを自分の {% data variables.product.product_name %} アカウントから削除する](/articles/reviewing-your-ssh-keys)ときにトリガーされます。 | - -#### `repo` カテゴリ - -| アクション | 説明 | -| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| access | 自分が所有するリポジトリが["プライベート" から "パブリック" に切り替えられる](/articles/making-a-private-repository-public) (またはその逆) ときにトリガーされます。 | -| add_member | {% data variables.product.product_name %} ユーザがリポジトリへの {% if currentVersion == "free-pro-team@latest" %}[共同アクセス権を保有するように招待される](/articles/inviting-collaborators-to-a-personal-repository){% else %}[共同アクセス権を付与される](/articles/inviting-collaborators-to-a-personal-repository){% endif %}ときにトリガーされます。 | -| add_topic | リポジトリのオーナーがリポジトリに[トピックを追加する](/articles/classifying-your-repository-with-topics)ときにトリガーされます。 | -| archived | リポジトリのオーナーが[リポジトリをアーカイブする](/articles/about-archiving-repositories)ときにトリガーされます。{% if currentVersion != "free-pro-team@latest" %} -| config.disable_anonymous_git_access | 公開リポジトリで[匿名の Git 読み取りアクセスが無効になる](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)ときにトリガーされます。 | -| config.enable_anonymous_git_access | 公開リポジトリで[匿名の Git 読み取りアクセスが有効になる](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)ときにトリガーされます。 | -| config.lock_anonymous_git_access | リポジトリの[匿名の Git 読み取りアクセス設定がロックされる](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)ときにトリガーされます。 | -| config.unlock_anonymous_git_access | リポジトリの[匿名の Git 読み取りアクセス設定がロック解除される](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)ときにトリガーされます。{% endif %} -| create | [新たなリポジトリが作成される](/articles/creating-a-new-repository)ときにトリガーされます。 | -| destroy | [リポジトリが削除される](/articles/deleting-a-repository)ときにトリガーされます。{% if currentVersion == "free-pro-team@latest" %} -| disable | リポジトリが無効になるときにトリガーされます ([残高不足](/articles/unlocking-a-locked-account)などの場合)。{% endif %}{% if currentVersion == "free-pro-team@latest" %} -| enable | リポジトリが再び有効になるときにトリガーされます。{% endif %} -| remove_member | {% data variables.product.product_name %}ユーザが[リポジトリのコラボレーターではなくなる](/articles/removing-a-collaborator-from-a-personal-repository)ときにトリガーされます。 | -| remove_topic | リポジトリのオーナーがリポジトリからトピックを削除するときにトリガーされます。 | -| rename | [リポジトリの名前が変更される](/articles/renaming-a-repository)ときにトリガーされます。 | -| 移譲 | [リポジトリが移譲される](/articles/how-to-transfer-a-repository)ときにトリガーされます。 | -| transfer_start | リポジトリの移譲が行われようとしているときにトリガーされます。 | -| unarchived | リポジトリのオーナーがリポジトリをアーカイブ解除するときにトリガーされます。 | +#### The `profile_picture` category + +| Action | Description +|------------------|------------------- +| update | Triggered when you [set or update your profile picture](/articles/setting-your-profile-picture/). + +#### The `project` category + +| Action | Description +|--------------------|--------------------- +| `create` | Triggered when a project board is created. +| `rename` | Triggered when a project board is renamed. +| `update` | Triggered when a project board is updated. +| `delete` | Triggered when a project board is deleted. +| `link` | Triggered when a repository is linked to a project board. +| `unlink` | Triggered when a repository is unlinked from a project board. +| `project.access` | Triggered when a project board's visibility is changed. +| `update_user_permission` | Triggered when an outside collaborator is added to or removed from a project board or has their permission level changed. + +#### The `public_key` category + +| Action | Description +|------------------|------------------- +| create | Triggered when you [add a new public SSH key to your {% data variables.product.product_name %} account](/articles/adding-a-new-ssh-key-to-your-github-account). +| delete | Triggered when you [remove a public SSH key to your {% data variables.product.product_name %} account](/articles/reviewing-your-ssh-keys). + +#### The `repo` category + +| Action | Description +|------------------|------------------- +| access | Triggered when you a repository you own is [switched from "private" to "public"](/articles/making-a-private-repository-public) (or vice versa). +| add_member | Triggered when a {% data variables.product.product_name %} user is {% if currentVersion == "free-pro-team@latest" %}[invited to have collaboration access](/articles/inviting-collaborators-to-a-personal-repository){% else %}[given collaboration access](/articles/inviting-collaborators-to-a-personal-repository){% endif %} to a repository. +| add_topic | Triggered when a repository owner [adds a topic](/articles/classifying-your-repository-with-topics) to a repository. +| archived | Triggered when a repository owner [archives a repository](/articles/about-archiving-repositories).{% if currentVersion != "free-pro-team@latest" %} +| config.disable_anonymous_git_access | Triggered when [anonymous Git read access is disabled](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) in a public repository. +| config.enable_anonymous_git_access | Triggered when [anonymous Git read access is enabled](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) in a public repository. +| config.lock_anonymous_git_access | Triggered when a repository's [anonymous Git read access setting is locked](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access). +| config.unlock_anonymous_git_access | Triggered when a repository's [anonymous Git read access setting is unlocked](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access).{% endif %} +| create | Triggered when [a new repository is created](/articles/creating-a-new-repository). +| destroy | Triggered when [a repository is deleted](/articles/deleting-a-repository).{% if currentVersion == "free-pro-team@latest" %} +| disable | Triggered when a repository is disabled (e.g., for [insufficient funds](/articles/unlocking-a-locked-account)).{% endif %}{% if currentVersion == "free-pro-team@latest" %} +| enable | Triggered when a repository is re-enabled.{% endif %} +| remove_member | Triggered when a {% data variables.product.product_name %} user is [removed from a repository as a collaborator](/articles/removing-a-collaborator-from-a-personal-repository). +| remove_topic | Triggered when a repository owner removes a topic from a repository. +| rename | Triggered when [a repository is renamed](/articles/renaming-a-repository). +| transfer | Triggered when [a repository is transferred](/articles/how-to-transfer-a-repository). +| transfer_start | Triggered when a repository transfer is about to occur. +| unarchived | Triggered when a repository owner unarchives a repository. {% if currentVersion == "free-pro-team@latest" %} -#### `sponsors` カテゴリ - -| アクション | 説明 | -| ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| repo_funding_link_button_toggle | リポジトリでスポンサーボタンの表示を有効化または無効化したときにトリガーされます (「[リポジトリにスポンサーボタンを表示する](/articles/displaying-a-sponsor-button-in-your-repository)」を参照) | -| repo_funding_links_file_action | リポジトリで FUNDING ファイルを変更したときにトリガーされます (「[リポジトリにスポンサーボタンを表示する](/articles/displaying-a-sponsor-button-in-your-repository)」を参照) | -| sponsor_sponsorship_cancel | スポンサーシップをキャンセルしたときにトリガーされます (「[スポンサーシップをダウングレードする](/articles/downgrading-a-sponsorship)」を参照) | -| sponsor_sponsorship_create | 開発者をスポンサーするとトリガーされます (「[オープンソースコントリビューターに対するスポンサー](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor#sponsoring-a-developer)」を参照) | -| sponsor_sponsorship_preference_change | スポンサード開発者からメールで最新情報を受け取るかどうかを変更したときにトリガーされます (「[スポンサーシップを管理する](/articles/managing-your-sponsorship)」を参照) | -| sponsor_sponsorship_tier_change | スポンサーシップをアップグレードまたはダウングレードしたときにトリガーされます (「[スポンサーシップをアップグレードする](/articles/upgrading-a-sponsorship)」および「[スポンサーシップをダウングレードする](/articles/downgrading-a-sponsorship)」を参照) | -| sponsored_developer_approve | {% data variables.product.prodname_sponsors %}アカウントが承認されるとトリガーされます（「[ユーザアカウントに{% data variables.product.prodname_sponsors %}を設定する](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)」を参照） | -| sponsored_developer_create | {% data variables.product.prodname_sponsors %}アカウントが作成されるとトリガーされます（「[ユーザアカウントに{% data variables.product.prodname_sponsors %}を設定する](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)」を参照） | -| sponsored_developer_profile_update | スポンサード開発者のプロフィールを編集するとトリガーされます（「[{% data variables.product.prodname_sponsors %}のプロフィール詳細を編集する](/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors)」を参照） | -| sponsored_developer_request_approval | 承認のために{% data variables.product.prodname_sponsors %}のアプリケーションをサブミットするとトリガーされます（「[ユーザアカウントに{% data variables.product.prodname_sponsors %}を設定する](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)」を参照） | -| sponsored_developer_tier_description_update | スポンサーシップ層の説明を変更したときにトリガーされます (「[スポンサーシップ層を変更する](/articles/changing-your-sponsorship-tiers)」を参照) | -| sponsored_developer_update_newsletter_send | スポンサーにメールで最新情報を送信したときにトリガーされます (「[スポンサーに連絡する](/articles/contacting-your-sponsors)」を参照) | -| waitlist_invite_sponsored_developer | 待ちリストから{% data variables.product.prodname_sponsors %}に参加するよう招待されたときにトリガーされます（「[ユーザアカウントに{% data variables.product.prodname_sponsors %}を設定する](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)」を参照） | -| waitlist_join | スポンサード開発者になるために待ちリストに参加するとトリガーされます（「[ユーザアカウントに{% data variables.product.prodname_sponsors %}を設定する](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)」を参照） | +#### The `sponsors` category + +| Action | Description +|------------------|------------------- +| repo_funding_link_button_toggle | Triggered when you enable or disable a sponsor button in your repository (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)") +| repo_funding_links_file_action | Triggered when you change the FUNDING file in your repository (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)") +| sponsor_sponsorship_cancel | Triggered when you cancel a sponsorship (see "[Downgrading a sponsorship](/articles/downgrading-a-sponsorship)") +| sponsor_sponsorship_create | Triggered when you sponsor a developer (see "[Sponsoring an open source contributor](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor#sponsoring-a-developer)") +| sponsor_sponsorship_preference_change | Triggered when you change whether you receive email updates from a sponsored developer (see "[Managing your sponsorship](/articles/managing-your-sponsorship)") +| sponsor_sponsorship_tier_change | Triggered when you upgrade or downgrade your sponsorship (see "[Upgrading a sponsorship](/articles/upgrading-a-sponsorship)" and "[Downgrading a sponsorship](/articles/downgrading-a-sponsorship)") +| sponsored_developer_approve | Triggered when your {% data variables.product.prodname_sponsors %} account is approved (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") +| sponsored_developer_create | Triggered when your {% data variables.product.prodname_sponsors %} account is created (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") +| sponsored_developer_profile_update | Triggered when you edit your sponsored developer profile (see "[Editing your profile details for {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors)") +| sponsored_developer_request_approval | Triggered when you submit your application for {% data variables.product.prodname_sponsors %} for approval (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") +| sponsored_developer_tier_description_update | Triggered when you change the description for a sponsorship tier (see "[Changing your sponsorship tiers](/articles/changing-your-sponsorship-tiers)") +| sponsored_developer_update_newsletter_send | Triggered when you send an email update to your sponsors (see "[Contacting your sponsors](/articles/contacting-your-sponsors)") +| waitlist_invite_sponsored_developer | Triggered when you are invited to join {% data variables.product.prodname_sponsors %} from the waitlist (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") +| waitlist_join | Triggered when you join the waitlist to become a sponsored developer (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") {% endif %} {% if currentVersion == "free-pro-team@latest" %} -#### `successor_invitation` カテゴリ - -| アクション | 説明 | -| ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| accept | 継承の招待を承諾するとトリガーされます（「[ユーザアカウントのリポジトリの所有権の継続性を管理する](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)」を参照） | -| cancel | 継承の招待をキャンセルするとトリガーされます（「[ユーザアカウントのリポジトリの所有権の継続性を管理する](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)」を参照） | -| create | 継承の招待を作成するとトリガーされます（「[ユーザアカウントのリポジトリの所有権の継続性を管理する](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)」を参照） | -| decline | 継承の招待を拒否するとトリガーされます（「[ユーザアカウントのリポジトリの所有権の継続性を管理する](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)」を参照） | -| revoke | 継承の招待を取り消すとトリガーされます（「[ユーザアカウントのリポジトリの所有権の継続性を管理する](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)」を参照） | +#### The `successor_invitation` category + +| Action | Description +|------------------|------------------- +| accept | Triggered when you accept a succession invitation (see "[Maintaining ownership continuity of your user account's repositories](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") +| cancel | Triggered when you cancel a succession invitation (see "[Maintaining ownership continuity of your user account's repositories](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") +| create | Triggered when you create a succession invitation (see "[Maintaining ownership continuity of your user account's repositories](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") +| decline | Triggered when you decline a succession invitation (see "[Maintaining ownership continuity of your user account's repositories](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") +| revoke | Triggered when you revoke a succession invitation (see "[Maintaining ownership continuity of your user account's repositories](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") {% endif %} {% if currentVersion != "free-pro-team@latest" %} -#### `team` カテゴリ +#### The `team` category -| アクション | 説明 | -| ----------------- | ------------------------------------------------------------------------------------------------------------- | -| add_member | 自分が所属している Organization のメンバーが[自分を Team に追加する](/articles/adding-organization-members-to-a-team)ときにトリガーされます。 | -| add_repository | 自分がメンバーである Team にリポジトリの管理が任せられるときにトリガーされます。 | -| create | 自分が所属している Organization で新たな Team が作成されるときにトリガーされます。 | -| destroy | 自分がメンバーである Team が Organization から削除されるときにトリガーされます。 | -| remove_member | Organization のメンバーが自分がメンバーである [Team から削除される](/articles/removing-organization-members-from-a-team)ときにトリガーされます。 | -| remove_repository | リポジトリが Team の管理下でなくなるときにトリガーされます。 | +| Action | Description +|------------------|------------------- +| add_member | Triggered when a member of an organization you belong to [adds you to a team](/articles/adding-organization-members-to-a-team). +| add_repository | Triggered when a team you are a member of is given control of a repository. +| create | Triggered when a new team in an organization you belong to is created. +| destroy | Triggered when a team you are a member of is deleted from the organization. +| remove_member | Triggered when a member of an organization is [removed from a team](/articles/removing-organization-members-from-a-team) you are a member of. +| remove_repository | Triggered when a repository is no longer under a team's control. {% endif %} -#### `two_factor_authentication` カテゴリ - -| アクション | 説明 | -| -------- | ---------------------------------------------------------------------------------------------- | -| enabled | [2 要素認証](/articles/securing-your-account-with-two-factor-authentication-2fa)が有効になるときにトリガーされます。 | -| disabled | 2 要素認証が無効になるときにトリガーされます。 | - -#### `user` カテゴリ - -| アクション | 説明 | -| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| add_email | [新たなメール アドレスを追加する](/articles/changing-your-primary-email-address)ときにトリガーされます。 | -| create | 新たなユーザ アカウントを作成するときにトリガーされます。 | -| remove_email | メール アドレスを削除するときにトリガーされます。 | -| rename | 自分のアカウント名を変更するときにトリガーされます。 | -| change_password | 自分のパスワードを変更するときにトリガーされます。 | -| forgot_password | [パスワード のリセット](/articles/how-can-i-reset-my-password)を依頼するときにトリガーされます。 | -| login | {% data variables.product.product_location %} にログインするときにトリガーされます | -| failed_login | 正常にログインできなかったときにトリガーされます | -| two_factor_requested | {% data variables.product.product_name %} が[自分の 2 要素認証コード](/articles/accessing-github-using-two-factor-authentication)を要求するときにトリガーされます。 | -| show_private_contributions_count | [自分のプロフィールでプライベート コントリビューションを公開する](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile)ときにトリガーされます。 | -| hide_private_contributions_count | [自分のプロファイルでプライベート コントリビューションを非表示にする](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile)ときにトリガーされます。{% if currentVersion == "free-pro-team@latest" %} -| report_content | [Issue または Pull Request、あるいは Issue、Pull Request、または Commit でのコメントを報告する](/articles/reporting-abuse-or-spam)ときにトリガーされます。{% endif %} - -#### `user_status` カテゴリ - -| アクション | 説明 | -| ------- | ------------------------------------------------------------------------------------------------------------------------- | -| update | 自分のプロファイルでステータスを設定または変更するときにトリガーされます。 詳細は「[ステータスを設定する](/articles/personalizing-your-profile/#setting-a-status)」を参照してください。 | -| destroy | 自分のプロファイルでステータスを消去するときにトリガーされます。 | +#### The `two_factor_authentication` category + +| Action | Description +|------------------|------------------- +| enabled | Triggered when [two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa) is enabled. +| disabled | Triggered when two-factor authentication is disabled. + +#### The `user` category + +| Action | Description +|--------------------|--------------------- +| add_email | Triggered when you [add a new email address](/articles/changing-your-primary-email-address). +| create | Triggered when you create a new user account. +| remove_email | Triggered when you remove an email address. +| rename | Triggered when you rename your account. +| change_password | Triggered when you change your password. +| forgot_password | Triggered when you ask for [a password reset](/articles/how-can-i-reset-my-password). +| login | Triggered when you log in to {% data variables.product.product_location %}. +| failed_login | Triggered when you failed to log in successfully. +| two_factor_requested | Triggered when {% data variables.product.product_name %} asks you for [your two-factor authentication code](/articles/accessing-github-using-two-factor-authentication). +| show_private_contributions_count | Triggered when you [publicize private contributions on your profile](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile). +| hide_private_contributions_count | Triggered when you [hide private contributions on your profile](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile).{% if currentVersion == "free-pro-team@latest" %} +| report_content | Triggered when you [report an issue or pull request, or a comment on an issue, pull request, or commit](/articles/reporting-abuse-or-spam).{% endif %} + +#### The `user_status` category + +| Action | Description +|--------------------|--------------------- +| update | Triggered when you set or change the status on your profile. For more information, see "[Setting a status](/articles/personalizing-your-profile/#setting-a-status)." +| destroy | Triggered when you clear the status on your profile. {% if currentVersion == "free-pro-team@latest" %} -### セキュリティログをエクスポートする +### Exporting your security log {% data reusables.audit_log.export-log %} {% data reusables.audit_log.exported-log-keys-and-values %} diff --git a/translations/ja-JP/content/github/authenticating-to-github/reviewing-your-ssh-keys.md b/translations/ja-JP/content/github/authenticating-to-github/reviewing-your-ssh-keys.md index 32e682aec7fe..71ea5e3d0586 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/reviewing-your-ssh-keys.md +++ b/translations/ja-JP/content/github/authenticating-to-github/reviewing-your-ssh-keys.md @@ -1,6 +1,6 @@ --- -title: SSH キーをレビューする -intro: '認証情報を安全に保つには、SSH キーを定期的に監査し、キーをデプロイし、自分の {% data variables.product.product_name %} アカウントにアクセスする許可されたアプリケーションをレビューしてください。' +title: Reviewing your SSH keys +intro: 'To keep your credentials secure, you should regularly audit your SSH keys, deploy keys, and review authorized applications that access your {% data variables.product.product_name %} account.' redirect_from: - /articles/keeping-your-application-access-tokens-safe/ - /articles/keeping-your-ssh-keys-and-application-access-tokens-safe/ @@ -10,37 +10,43 @@ versions: enterprise-server: '*' --- -許可されていない (あるいは侵害された可能性のある) SSH キーを削除することで、攻撃者が以後自分のリポジトリにアクセスすることを防止できます。 有効な既存の SSH キーを承認することもできます。 +You can delete unauthorized (or possibly compromised) SSH keys to ensure that an attacker no longer has access to your repositories. You can also approve existing SSH keys that are valid. {% mac %} {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -3. [SSH Settings] ページで、自分のアカウントに関連付けられている SSH キーを書き留めます。 覚えていないか古くなっている場合は、[**Delete**] をクリックします。 残しておきたい有効な SSH キーがある場合は、[**Approve**] をクリックします。 ![SSH キーのリスト](/assets/images/help/settings/settings-ssh-key-review.png) +3. On the SSH Settings page, take note of the SSH keys associated with your account. For those that you don't recognize, or that are out-of-date, click **Delete**. If there are valid SSH keys you'd like to keep, click **Approve**. + ![SSH key list](/assets/images/help/settings/settings-ssh-key-review.png) {% tip %} - **メモ:** Git 操作が失敗したために SSH キーを監査している場合は、 [SSH キー監査エラー](/articles/error-we-re-doing-an-ssh-key-audit)の原因となった未検証のキーが SSH キーのリストで強調表示されます。 ![未検証の SSH キー](/assets/images/help/settings/settings-ssh-key-review-highlight.png) + **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys. {% endtip %} -4. ターミナルを開きます。 +4. Open Terminal. 5. {% data reusables.command_line.start_ssh_agent %} -6. 自分の公開鍵のフィンガープリントを見つけてメモします。 OpenSSH 6.7 より前のバージョンを使用している場合: +6. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` - OpenSSH 6.8 以降を使用している場合: + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} -7. {% data variables.product.product_name %} での SSH キーは、お使いのコンピュータでの同じキーと一致して*いなければなりません* 。 +7. The SSH keys on {% data variables.product.product_name %} *should* match the same keys on your computer. {% endmac %} @@ -48,33 +54,39 @@ versions: {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -3. [SSH Settings] ページで、自分のアカウントに関連付けられている SSH キーを書き留めます。 覚えていないか古くなっている場合は、[**Delete**] をクリックします。 残しておきたい有効な SSH キーがある場合は、[**Approve**] をクリックします。 ![SSH キーのリスト](/assets/images/help/settings/settings-ssh-key-review.png) +3. On the SSH Settings page, take note of the SSH keys associated with your account. For those that you don't recognize, or that are out-of-date, click **Delete**. If there are valid SSH keys you'd like to keep, click **Approve**. + ![SSH key list](/assets/images/help/settings/settings-ssh-key-review.png) {% tip %} - **メモ:** Git 操作が失敗したために SSH キーを監査している場合は、 [SSH キー監査エラー](/articles/error-we-re-doing-an-ssh-key-audit)の原因となった未検証のキーが SSH キーのリストで強調表示されます。![未検証の SSH キー](/assets/images/help/settings/settings-ssh-key-review-highlight.png) + **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys. {% endtip %} -4. Git Bash を開きます。 {% data variables.product.prodname_desktop %} に収納されている Git Shell を使用している場合は、Git Shell を開き、ステップ 6 に進みます。 +4. Open Git Bash. If you're using Git Shell, which is included in {% data variables.product.prodname_desktop %}, open Git Shell and skip to step 6. 5. {% data reusables.desktop.windows_git_bash_turn_on_ssh_agent %} {% data reusables.desktop.windows_git_for_windows_turn_on_ssh_agent %} -6. 自分の公開鍵のフィンガープリントを見つけてメモします。 OpenSSH 6.7 より前のバージョンを使用している場合: +6. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` - OpenSSH 6.8 以降を使用している場合: + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} -7. {% data variables.product.product_name %} での SSH キーは、お使いのコンピュータでの同じキーと一致して*いなければなりません* 。 +7. The SSH keys on {% data variables.product.product_name %} *should* match the same keys on your computer. {% endwindows %} @@ -82,36 +94,42 @@ versions: {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -3. [SSH Settings] ページで、自分のアカウントに関連付けられている SSH キーを書き留めます。 覚えていないか古くなっている場合は、[**Delete**] をクリックします。 残しておきたい有効な SSH キーがある場合は、[**Approve**] をクリックします。 ![SSH キーのリスト](/assets/images/help/settings/settings-ssh-key-review.png) +3. On the SSH Settings page, take note of the SSH keys associated with your account. For those that you don't recognize, or that are out-of-date, click **Delete**. If there are valid SSH keys you'd like to keep, click **Approve**. + ![SSH key list](/assets/images/help/settings/settings-ssh-key-review.png) {% tip %} - **メモ:** Git 操作が失敗したために SSH キーを監査している場合は、 [SSH キー監査エラー](/articles/error-we-re-doing-an-ssh-key-audit)の原因となった未検証のキーが SSH キーのリストで強調表示されます。 ![未検証の SSH キー](/assets/images/help/settings/settings-ssh-key-review-highlight.png) + **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys. {% endtip %} -4. ターミナルを開きます。 +4. Open Terminal. 5. {% data reusables.command_line.start_ssh_agent %} -6. 自分の公開鍵のフィンガープリントを見つけてメモします。 OpenSSH 6.7 より前のバージョンを使用している場合: +6. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` - OpenSSH 6.8 以降を使用している場合: + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} -7. {% data variables.product.product_name %} での SSH キーは、お使いのコンピュータでの同じキーと一致して*いなければなりません* 。 +7. The SSH keys on {% data variables.product.product_name %} *should* match the same keys on your computer. {% endlinux %} {% warning %} -**警告**: 見慣れない SSH キーが {% data variables.product.product_name %} で見つかった場合は、すぐにそれを削除し、さらに支援が必要な場合は {% data variables.contact.contact_support %} に問い合わせてください。 確認できない公開鍵は、潜在的なセキュリティ上の問題を示している可能性があります。 +**Warning**: If you see an SSH key you're not familiar with on {% data variables.product.product_name %}, delete it immediately and contact {% data variables.contact.contact_support %} for further help. An unidentified public key may indicate a possible security concern. {% endwarning %} diff --git a/translations/ja-JP/content/github/authenticating-to-github/signing-commits.md b/translations/ja-JP/content/github/authenticating-to-github/signing-commits.md index eb114c672821..948bcc7ec726 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/signing-commits.md +++ b/translations/ja-JP/content/github/authenticating-to-github/signing-commits.md @@ -1,6 +1,6 @@ --- title: コミットに署名する -intro: 'GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} や S/MIME{% endif %} を使って、ローカルでコミットに署名できます。' +intro: 'You can sign commits locally using GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} or S/MIME{% endif %}.' redirect_from: - /articles/signing-commits-and-tags-using-gpg/ - /articles/signing-commits-using-gpg/ @@ -39,7 +39,8 @@ Git バージョン 2.0.0 以降で、ローカルリポジトリでデフォル $ git push # ローカルコミットをリモートリポジトリにプッシュする ``` -4. {% data variables.product.product_name %}上で、プルリクエストに移動します。 +4. On +{% data variables.product.product_name %}, navigate to your pull request. {% data reusables.repositories.review-pr-commits %} 5. ベリファイされた署名の詳しい情報を見るには、Verifiedをクリックします。 ![署名されたコミット](/assets/images/help/commits/gpg-signed-commit-verified-without-details.png) diff --git a/translations/ja-JP/content/github/authenticating-to-github/telling-git-about-your-signing-key.md b/translations/ja-JP/content/github/authenticating-to-github/telling-git-about-your-signing-key.md index ab73d9463b98..9947bcc89bd6 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/telling-git-about-your-signing-key.md +++ b/translations/ja-JP/content/github/authenticating-to-github/telling-git-about-your-signing-key.md @@ -1,6 +1,6 @@ --- title: Git へ署名キーを伝える -intro: 'ローカルでコミットに署名するには、使いたい GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} または X.509{% endif %} キーがあることを Git に通知する必要があります。' +intro: 'To sign commits locally, you need to inform Git that there''s a GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} or X.509{% endif %} key you''d like to use.' redirect_from: - /articles/telling-git-about-your-gpg-key/ - /articles/telling-git-about-your-signing-key diff --git a/translations/ja-JP/content/github/authenticating-to-github/updating-your-github-access-credentials.md b/translations/ja-JP/content/github/authenticating-to-github/updating-your-github-access-credentials.md index 30cb136301ce..900b48d79fdd 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/updating-your-github-access-credentials.md +++ b/translations/ja-JP/content/github/authenticating-to-github/updating-your-github-access-credentials.md @@ -12,7 +12,7 @@ versions: ### 新しいパスワードをリクエストする -1. 新しいパスワードをリクエストするには、{% if currentVersion == "free-pro-team@latest" %}https://{% data variables.product.product_url %}/password_reset{% else %}`https://{% data variables.product.product_url %}/password_reset`{% endif %} にアクセスしてください。 +1. To request a new password, visit {% if currentVersion == "free-pro-team@latest" %}https://{% data variables.product.product_url %}/password_reset{% else %}`https://{% data variables.product.product_url %}/password_reset`{% endif %}. 2. 個人 {% data variables.product.product_name %} アカウントに関連するメールアドレスを入力し、次に [**Send password reset email**] をクリックします。バックアップメールアドレスが設定されている場合、そのアドレスにメールが送られます。 ![パスワードリセットのメールリクエストダイアログ](/assets/images/help/settings/password-recovery-email-request.png) 3. パスワードをリセットするためのリンクがメールで届きます。 メールを受信してから 3 時間以内に、このリンクをクリックする必要があります。 弊社からメールが届かない場合、スパムフォルダを確認してください。 4. メールのリンクをクリックすると、新しいパスワードを入力するように求められます。 ![パスワードリカバリボックス](/assets/images/help/settings/password_recovery_page.png) @@ -29,11 +29,7 @@ versions: 1. {% data variables.product.product_name %} への {% data variables.product.signin_link %} {% data reusables.user_settings.access_settings %} -{%- if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} {% data reusables.user_settings.security %} -{%- else %} -{% data reusables.user_settings.account_settings %} -{%- endif %} 4. [Change password] の下で、古いパスワード、新しい強靭なパスワードを入力し、新しいパスワードを確認します。 強靭なパスワードを作成するための参考として、「[強靭なパスワードを作成する](/articles/creating-a-strong-password)」を参照してください。 5. [**Update password**] をクリックします。 diff --git a/translations/ja-JP/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md b/translations/ja-JP/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md index a21c708d0ead..b71ad36cfbda 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md +++ b/translations/ja-JP/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md @@ -57,7 +57,7 @@ elif [ "$SSH_AUTH_SOCK" ] && [ $agent_run_state = 1 ]; then fi ``` -秘密鍵がデフォルトの場所 (`~/.ssh/id_rsa`{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}または`~/.ssh/id_dsa`{% endif %}) に保存されていない場合は、SSH 認証エージェントにそれがどこにあるかを指定する必要があります。 キーを ssh-agent に追加するには、`ssh-add ~/path/to/my_key` と入力します。 詳細は「[新しい SSH キーを生成して ssh-agent に追加する](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/)」を参照してください。 +If your private key is not stored in one of the default locations (like `~/.ssh/id_rsa`), you'll need to tell your SSH authentication agent where to find it. キーを ssh-agent に追加するには、`ssh-add ~/path/to/my_key` と入力します。 詳細は「[新しい SSH キーを生成して ssh-agent に追加する](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/)」を参照してください。 {% tip %} @@ -88,8 +88,7 @@ fi OS X El Capitan を介する OS X Leopard では、これらのデフォルトの秘密鍵ファイルは自動的に処理されます: -- *.ssh/id_rsa*{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -- *.ssh/id_dsa*{% endif %} +- *.ssh/id_rsa* - *.ssh/identity* 初めてキーを使用するときは、パスフレーズを入力するよう求められます。 キーチェーンと一緒にパスフレーズを保存することを選択した場合は、もう一度入力する必要はありません。 diff --git a/translations/ja-JP/content/github/building-a-strong-community/about-issue-and-pull-request-templates.md b/translations/ja-JP/content/github/building-a-strong-community/about-issue-and-pull-request-templates.md index d138cff1e7bc..80d0b7f604f4 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/about-issue-and-pull-request-templates.md +++ b/translations/ja-JP/content/github/building-a-strong-community/about-issue-and-pull-request-templates.md @@ -1,6 +1,6 @@ --- title: Issueとプルリクエストのテンプレートについて -intro: Issue及びプルリクエストのテンプレートを使えば、コントリビューターがリポジトリでIssuleやプルリクエストをオープンする際に含めてほしい情報をカスタマイズし、標準化できます。 +intro: 'Issue及びプルリクエストのテンプレートを使えば、コントリビューターがリポジトリでIssuleやプルリクエストをオープンする際に含めてほしい情報をカスタマイズし、標準化できます。' redirect_from: - /articles/about-issue-and-pull-request-templates versions: @@ -10,7 +10,7 @@ versions: リポジトリでIssueやプルリクエストのテンプレートを作成すると、コントリビューターはそのテンプレートを使い、リポジトリのコントリビューションのガイドラインに沿ってIssuelをオープンしたり、プルリクエスト中の変更を提案したりできるようになります。 リポジトリへのコントリビューションのガイドラインの追加に関する詳しい情報については[リポジトリコントリビューターのためのガイドラインを定める](/articles/setting-guidelines-for-repository-contributors)を参照してください。 -Organization {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}またはユーザアカウント{% endif %}のデフォルトの Issue とプルリクエストテンプレートを作成できます。 詳しい情報については「[デフォルトのコミュニティ健全性ファイルを作成する](/github/building-a-strong-community/creating-a-default-community-health-file)」を参照してください。 +You can create default issue and pull request templates for your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %}. 詳しい情報については「[デフォルトのコミュニティ健全性ファイルを作成する](/github/building-a-strong-community/creating-a-default-community-health-file)」を参照してください。 ### Issueのテンプレート diff --git a/translations/ja-JP/content/github/building-a-strong-community/about-team-discussions.md b/translations/ja-JP/content/github/building-a-strong-community/about-team-discussions.md index ae8641684604..57565d1c461b 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/about-team-discussions.md +++ b/translations/ja-JP/content/github/building-a-strong-community/about-team-discussions.md @@ -1,6 +1,6 @@ --- title: Team ディスカッションについて -intro: Team は、Organization 内の Team のページ内のディスカッションポストにおける好きな話題について、計画をしたり、更新をしたり、議論をしたりできます。 +intro: 'Team は、Organization 内の Team のページ内のディスカッションポストにおける好きな話題について、計画をしたり、更新をしたり、議論をしたりできます。' redirect_from: - /articles/about-team-discussions versions: @@ -26,7 +26,7 @@ Team のページのパブリックなディスカッションに誰かがポス {% tip %} -**ヒント:** 通知の設定によって、更新はメール、{% data variables.product.product_name %}上の Web 通知、あるいはその両方で受け取ることになります。 詳しい情報については、{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}「[通知を設定する](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications){% else %}「[メール通知について](/github/receiving-notifications-about-activity-on-github/about-email-notifications)」および「[Web 通知について](/github/receiving-notifications-about-activity-on-github/about-web-notifications){% endif %}」を参照してください。 +**ヒント:** 通知の設定によって、更新はメール、{% data variables.product.product_name %}上の Web 通知、あるいはその両方で受け取ることになります。 For more information, see {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications){% else %}"[About email notifications](/github/receiving-notifications-about-activity-on-github/about-email-notifications)" and "[About web notifications](/github/receiving-notifications-about-activity-on-github/about-web-notifications){% endif %}." {% endtip %} @@ -34,7 +34,7 @@ Team のページのパブリックなディスカッションに誰かがポス Team のディスカッションに対する通知をオフにするには、特定のディスカッションのポストのサブスクライブを解除するか、Watch の解除あるいは特定の Team のディスカッションを完全に無視するよう通知設定を変更できます。 Team のディスカッションの Watch を解除している場合でも、特定のディスカッションのポストについての通知をサブスクライブすることはできます。 -詳しい情報については、{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}「[サブスクリプションを表示する](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions){% else %}「[通知のサブスクライブとサブスクライブ解除](/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications){% endif %}」および「[入れ子チーム](/articles/about-teams/#nested-teams)」を参照してください。 +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 %}"[Subscribing to and unsubscribing from notifications](/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications){% endif %}" and "[Nested teams](/articles/about-teams/#nested-teams)." ### 参考リンク diff --git a/translations/ja-JP/content/github/building-a-strong-community/about-wikis.md b/translations/ja-JP/content/github/building-a-strong-community/about-wikis.md index fbbdfd526132..5c7c1a77f663 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/about-wikis.md +++ b/translations/ja-JP/content/github/building-a-strong-community/about-wikis.md @@ -1,6 +1,6 @@ --- title: ウィキについて -intro: リポジトリのドキュメンテーションをウィキでホストして、他者が利用してプロジェクトにコントリビュートすることを可能にできます。 +intro: 'リポジトリのドキュメンテーションをウィキでホストして、他者が利用してプロジェクトにコントリビュートすることを可能にできます。' redirect_from: - /articles/about-github-wikis/ - /articles/about-wikis diff --git a/translations/ja-JP/content/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project.md b/translations/ja-JP/content/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project.md index 13e4ec918256..cef143c7f768 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project.md +++ b/translations/ja-JP/content/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project.md @@ -1,6 +1,6 @@ --- title: プロジェクトへの行動規範の追加 -intro: コミュニティの標準を定義し、参加を歓迎する開放的なプロジェクトであることを発信し、侵害への対処手順の概要を示すために、行動規範を採用してください。 +intro: 'コミュニティの標準を定義し、参加を歓迎する開放的なプロジェクトであることを発信し、侵害への対処手順の概要を示すために、行動規範を採用してください。' redirect_from: - /articles/adding-a-code-of-conduct-to-your-project versions: diff --git a/translations/ja-JP/content/github/building-a-strong-community/adding-support-resources-to-your-project.md b/translations/ja-JP/content/github/building-a-strong-community/adding-support-resources-to-your-project.md index 030eec14bbfd..a812d4a55b98 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/adding-support-resources-to-your-project.md +++ b/translations/ja-JP/content/github/building-a-strong-community/adding-support-resources-to-your-project.md @@ -12,7 +12,7 @@ versions: ![サポートガイドライン](/assets/images/help/issues/support_guidelines_in_issue.png) -Organization {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}またはユーザアカウント{% endif %}のデフォルトのサポートリソースを作成できます。 詳しい情報については「[デフォルトのコミュニティ健全性ファイルを作成する](/github/building-a-strong-community/creating-a-default-community-health-file)」を参照してください。 +You can create default support resources for your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %}. 詳しい情報については「[デフォルトのコミュニティ健全性ファイルを作成する](/github/building-a-strong-community/creating-a-default-community-health-file)」を参照してください。 {% tip %} diff --git a/translations/ja-JP/content/github/building-a-strong-community/blocking-a-user-from-your-personal-account.md b/translations/ja-JP/content/github/building-a-strong-community/blocking-a-user-from-your-personal-account.md index 5539b9ce9acc..0992bcaf14f0 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/blocking-a-user-from-your-personal-account.md +++ b/translations/ja-JP/content/github/building-a-strong-community/blocking-a-user-from-your-personal-account.md @@ -1,6 +1,6 @@ --- title: 個人アカウントからのユーザのブロック -intro: ユーザをブロックして、あなたのアクティビリティやリポジトリへのアクセスを拒否し、あなたに通知を送れないようにすることができます。 +intro: 'ユーザをブロックして、あなたのアクティビリティやリポジトリへのアクセスを拒否し、あなたに通知を送れないようにすることができます。' redirect_from: - /articles/blocking-a-user-from-your-personal-account versions: diff --git a/translations/ja-JP/content/github/building-a-strong-community/collaborating-with-your-team.md b/translations/ja-JP/content/github/building-a-strong-community/collaborating-with-your-team.md index b48a6dba4d8d..1870cf268380 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/collaborating-with-your-team.md +++ b/translations/ja-JP/content/github/building-a-strong-community/collaborating-with-your-team.md @@ -1,6 +1,6 @@ --- title: Team とコラボレーションする -intro: Organization 内で、Team は Team ディスカッションを使い、プロジェクトをまたいで協力して作業できます。 +intro: 'Organization 内で、Team は Team ディスカッションを使い、プロジェクトをまたいで協力して作業できます。' mapTopic: true redirect_from: - /articles/collaborating-with-your-team diff --git a/translations/ja-JP/content/github/building-a-strong-community/configuring-issue-templates-for-your-repository.md b/translations/ja-JP/content/github/building-a-strong-community/configuring-issue-templates-for-your-repository.md index 6c6b0687493f..2450605f5e0a 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/configuring-issue-templates-for-your-repository.md +++ b/translations/ja-JP/content/github/building-a-strong-community/configuring-issue-templates-for-your-repository.md @@ -24,7 +24,7 @@ versions: 7. デフォルトの Issue タイトルを自動的に設定するには、リポジトリへの読み取りアクセスを持つ人に Issue を割り当てるか、ラベルを Issue テンプレートに適用し、こうした詳細な情報を [Optional additional information] の下に入力します。 このような詳細情報を Issue テンプレートに、`title`、`labels`、または `assignees` を YAML frontmatter フォーマットで使用して、追加することもできます。 ![Issue テンプレートの追加情報](/assets/images/help/repository/additional-issue-template-info.png) 8. テンプレートの編集とプレビューが終了したら、ページ右上隅にある [**Propose changes**] をクリックします。 ![[Propose changes] ボタン](/assets/images/help/repository/propose-changes-button.png) 9. 変更内容を説明するコミットメッセージを入力します。 ![Issue テンプレートコミットメッセージフィールド](/assets/images/help/repository/issue-template-commit-message-field.png) -10. コミットメッセージフィールドの下で、テンプレートを直接デフォルトブランチにコミットするか、新しいブランチを作成してプルリクエストを開くか判断します。 プルリクエストに関する詳しい情報については「[プルリクエストについて](/articles/about-pull-requests)」を参照してください。 ![Issue テンプレートの master へのコミットかプルリクエストを開くかの選択](/assets/images/help/repository/issue-template-commit-to-master-or-open-pull-request.png) +10. コミットメッセージフィールドの下で、テンプレートを直接デフォルトブランチにコミットするか、新しいブランチを作成してプルリクエストを開くか判断します。 プルリクエストに関する詳しい情報については「[プルリクエストについて](/articles/about-pull-requests)」を参照してください。 ![Issue template commit to main or open pull request choice](/assets/images/help/repository/issue-template-commit-to-master-or-open-pull-request.png) 11. **[Commit changes]** をクリックしてください。 変更がデフォルトブランチにマージされると、コントリビューターがリポジトリで新しい Issue を開くときにテンプレートを使用できるようになります。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} diff --git a/translations/ja-JP/content/github/building-a-strong-community/creating-a-default-community-health-file.md b/translations/ja-JP/content/github/building-a-strong-community/creating-a-default-community-health-file.md index 0fa126191f5f..fe57de2af14c 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/creating-a-default-community-health-file.md +++ b/translations/ja-JP/content/github/building-a-strong-community/creating-a-default-community-health-file.md @@ -1,6 +1,6 @@ --- title: デフォルトのコミュニティ健全性ファイルを作成する -intro: CONTRIBUTING や CODE_OF_CONDUCT など、デフォルトのコミュニティ健全性ファイルを作成できます。 デフォルトのファイルは、そのような独自ファイルを持たないあらゆるパブリックリポジトリに使用されます。 +intro: 'CONTRIBUTING や CODE_OF_CONDUCT など、デフォルトのコミュニティ健全性ファイルを作成できます。 デフォルトのファイルは、そのような独自ファイルを持たないあらゆるパブリックリポジトリに使用されます。' redirect_from: - /articles/creating-a-default-community-health-file-for-your-organization - /github/building-a-strong-community/creating-a-default-community-health-file-for-your-organization @@ -11,39 +11,38 @@ versions: ### デフォルトのコミュニティ健全性ファイルについて -Organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} またはユーザアカウント{% endif %}が所有する `.github` というパブリックリポジトリのルートにデフォルトのコミュニティ健全性ファイルを追加できます。 +You can add default community health files to the root of a public repository called `.github` that is owned by an organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %}. {% data variables.product.product_name %}は、次のいずれかの場所にそのタイプの独自のファイルがないアカウントのパブリックリポジトリについては、デフォルトファイルを使用および表示します。 - リポジトリのルート - `.github` フォルダ - `docs` フォルダ -たとえば、独自の CONTRIBUTING ファイルを持たないパブリックリポジトリに Issue やプルリクエストを作成する人は誰でも、デフォルトの CONTRIBUTING ファイルへのリンクが見られます。 リポジトリの独自の `.github/ISSUE_TEMPLATE` フォルダ内に -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}、Issue テンプレートや *config.yml* ファイルなどの{% endif %}ファイルがある場合、デフォルトの`.github/ISSUE_TEMPLATE`フォルダにあるコンテンツは使用されません。 +たとえば、独自の CONTRIBUTING ファイルを持たないパブリックリポジトリに Issue やプルリクエストを作成する人は誰でも、デフォルトの CONTRIBUTING ファイルへのリンクが見られます。 If a repository has any files in its own `.github/ISSUE_TEMPLATE` folder{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}, including issue templates or a *config.yml* file,{% endif %} none of the contents of the default `.github/ISSUE_TEMPLATE` folder will be used. デフォルトのファイルは `.github` リポジトリにのみ格納されるものであって、クローン、パッケージ、リポジトリ個別のダウンロードには含まれません。 ### サポートされているファイルの種類 -Organization {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}またはユーザアカウント{% endif %}に対して、次のコミュニティ健全性ファイルにデフォルトを作成できます。 +You can create defaults in your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %} for the following community health files: -| コミュニティ健全性ファイル | 説明 | -| --------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" %} -| *CODE_OF_CONDUCT.md* | CODE_OF_CONDUCT ファイルは、コミュニティへの関わり方についての基準を定義します。 詳しい情報については、「[プロジェクトへの行動規範の追加](/articles/adding-a-code-of-conduct-to-your-project/)」を参照してください。{% endif %} -| *CONTRIBUTING.md* | CONTRIBUTING ファイルは、人々がプロジェクトにどのように貢献すべきかを伝えます。 詳しい情報については、「[リポジトリコントリビューターのためのガイドラインを定める](/articles/setting-guidelines-for-repository-contributors/)」を参照してください。{% if currentVersion == "free-pro-team@latest" %} -| *FUNDING.yml* | FUNDING ファイルは、あなたのオープンソースプロジェクトに対する資金提供のオプションについての認知度を高める目的で、リポジトリにスポンサーボタンを表示するためのものです。 詳細は「[リポジトリにスポンサーボタンを表示する](/articles/displaying-a-sponsor-button-in-your-repository)」を参照してください。{% endif %} -| Issue およびプルリクエストテンプレート{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}および*config.yml*{% endif %} | Issue およびプルリクエストのテンプレートは、リポジトリで Issue およびプルリクエストを開くときに含める情報をカスタマイズして標準化します。 詳しい情報については、「[Issue およびプルリクエストのテンプレートについて](/articles/about-issue-and-pull-request-templates/)」を参照してください。{% if currentVersion == "free-pro-team@latest" %} -| *SECURITY.md* | SECURITY ファイルには、プロジェクトのセキュリティ脆弱性について責任を持って報告する方法が記載されています。 詳しい情報については「[リポジトリにセキュリティポリシーを追加する](/articles/adding-a-security-policy-to-your-repository)」を参照してください。{% endif %} -| *SUPPORT.md* | SUPPORT ファイルは、プロジェクトについて支援を受ける方法を伝えるためのものです。 詳しい情報については"[プロジェクトへのサポートリソースの追加](/articles/adding-support-resources-to-your-project/)"を参照してください。 | +| コミュニティ健全性ファイル | 説明 | +| --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" %} +| *CODE_OF_CONDUCT.md* | CODE_OF_CONDUCT ファイルは、コミュニティへの関わり方についての基準を定義します。 詳しい情報については、「[プロジェクトへの行動規範の追加](/articles/adding-a-code-of-conduct-to-your-project/)」を参照してください。{% endif %} +| *CONTRIBUTING.md* | CONTRIBUTING ファイルは、人々がプロジェクトにどのように貢献すべきかを伝えます。 For more information, see "[Setting guidelines for repository contributors](/articles/setting-guidelines-for-repository-contributors/)."{% if currentVersion == "free-pro-team@latest" %} +| *FUNDING.yml* | FUNDING ファイルは、あなたのオープンソースプロジェクトに対する資金提供のオプションについての認知度を高める目的で、リポジトリにスポンサーボタンを表示するためのものです。 詳細は「[リポジトリにスポンサーボタンを表示する](/articles/displaying-a-sponsor-button-in-your-repository)」を参照してください。{% endif %} +| Issue and pull request templates{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and *config.yml*{% endif %} | Issue およびプルリクエストのテンプレートは、リポジトリで Issue およびプルリクエストを開くときに含める情報をカスタマイズして標準化します。 For more information, see "[About issue and pull request templates](/articles/about-issue-and-pull-request-templates/)."{% if currentVersion == "free-pro-team@latest" %} +| *SECURITY.md* | SECURITY ファイルには、プロジェクトのセキュリティ脆弱性について責任を持って報告する方法が記載されています。 詳しい情報については「[リポジトリにセキュリティポリシーを追加する](/articles/adding-a-security-policy-to-your-repository)」を参照してください。{% endif %} +| *SUPPORT.md* | SUPPORT ファイルは、プロジェクトについて支援を受ける方法を伝えるためのものです。 詳しい情報については"[プロジェクトへのサポートリソースの追加](/articles/adding-support-resources-to-your-project/)"を参照してください。 | デフォルトのライセンスファイルを作成することはできません。 ライセンスファイルは、プロジェクトのクローン時、パッケージ時、またはダウンロード時に含められるよう、個々のリポジトリに追加する必要があります。 ### デフォルトのファイル用にリポジトリを作成 {% data reusables.repositories.create_new %} -2. [**Owner**] ドロップダウンメニューを使用して、デフォルトファイルを作成する Organization {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}またはユーザアカウント{% endif %}を選択します。 ![[Owner] ドロップダウンメニュー](/assets/images/help/repository/create-repository-owner.png) +2. Use the **Owner** drop-down menu, and select the organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %} you want to create default files for. ![[Owner] ドロップダウンメニュー](/assets/images/help/repository/create-repository-owner.png) 3. リポジトリの名前として **.github** と入力し、任意で説明を入力します。 ![リポジトリ作成フィールド](/assets/images/help/repository/default-file-repository-name.png) -4. リポジトリをパブリックにします。 ![プライベートまたはパブリックのステータスを選択するラジオボタン](/assets/images/help/repository/create-repository-public-private.png) +4. Make sure the repository status is set to **Public** (a repository for default files cannot be private). ![プライベートまたはパブリックのステータスを選択するラジオボタン](/assets/images/help/repository/create-repository-public-private.png) {% data reusables.repositories.initialize-with-readme %} {% data reusables.repositories.create-repo %} -7. リポジトリの中に、サポートされているコミュニティ健全性ファイルの 1 つを作成します。 Issue テンプレート{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}とその設定ファイル{% endif %}は、`.github/ISSUE_TEMPLATE` というフォルダ内になければなりません。 その他のサポートされているファイルは、リポジトリのルートにある必要があります。 詳細は「[新しいファイルを作成する](/articles/creating-new-files/)」を参照してください。 +7. リポジトリの中に、サポートされているコミュニティ健全性ファイルの 1 つを作成します。 Issue templates{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and their configuration file{% endif %} must be in a folder called `.github/ISSUE_TEMPLATE`. その他のサポートされているファイルは、リポジトリのルートにある必要があります。 詳細は「[新しいファイルを作成する](/articles/creating-new-files/)」を参照してください。 diff --git a/translations/ja-JP/content/github/building-a-strong-community/creating-a-pull-request-template-for-your-repository.md b/translations/ja-JP/content/github/building-a-strong-community/creating-a-pull-request-template-for-your-repository.md index 58ce968d323e..71030632b788 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/creating-a-pull-request-template-for-your-repository.md +++ b/translations/ja-JP/content/github/building-a-strong-community/creating-a-pull-request-template-for-your-repository.md @@ -1,6 +1,6 @@ --- title: リポジトリ用のプルリクエストテンプレートの作成 -intro: リポジトリにプルリクエストのテンプレートを追加すると、プロジェクトのコントリビューターはプルリクエストの本体にテンプレートの内容を自動的に見ることになります。 +intro: 'リポジトリにプルリクエストのテンプレートを追加すると、プロジェクトのコントリビューターはプルリクエストの本体にテンプレートの内容を自動的に見ることになります。' redirect_from: - /articles/creating-a-pull-request-template-for-your-repository versions: @@ -12,7 +12,7 @@ versions: サポートしているどのフォルダにでも *PULL_REQUEST_TEMPLATE/* サブディレクトリを作成し、プルリクエストテンプレートを複数含めることができます。また、`template` クエリパラメータでプルリクエストの本文に使用するテンプレートを指定できます。 詳細は「[クエリパラメータによる Issue およびプルリクエストの自動化について](/articles/about-automation-for-issues-and-pull-requests-with-query-parameters)」を参照してください。 -Organization {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}またはユーザアカウント{% endif %}のデフォルトのプルリクエストテンプレートを作成できます。 詳しい情報については「[デフォルトのコミュニティ健全性ファイルを作成する](/github/building-a-strong-community/creating-a-default-community-health-file)」を参照してください。 +You can create default pull request templates for your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %}. 詳しい情報については「[デフォルトのコミュニティ健全性ファイルを作成する](/github/building-a-strong-community/creating-a-default-community-health-file)」を参照してください。 ### プルリクエストテンプレートの追加 diff --git a/translations/ja-JP/content/github/building-a-strong-community/creating-a-team-discussion.md b/translations/ja-JP/content/github/building-a-strong-community/creating-a-team-discussion.md index 773db84e0f84..f0a8bc8d5dc2 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/creating-a-team-discussion.md +++ b/translations/ja-JP/content/github/building-a-strong-community/creating-a-team-discussion.md @@ -1,6 +1,6 @@ --- title: Team ディスカッションの作成 -intro: Organization のメンバーであれば誰でも _public_ Team ディスカッションのポストを作成できます。 _private_ Team ディスカッションのポストを作成するには、Team のメンバーか Organization のオーナーでなければなりません。 +intro: 'Organization のメンバーであれば誰でも _public_ Team ディスカッションのポストを作成できます。 _private_ Team ディスカッションのポストを作成するには、Team のメンバーか Organization のオーナーでなければなりません。' redirect_from: - /articles/creating-a-team-discussion versions: diff --git a/translations/ja-JP/content/github/building-a-strong-community/documenting-your-project-with-wikis.md b/translations/ja-JP/content/github/building-a-strong-community/documenting-your-project-with-wikis.md index 6fec02d6c76e..08a4a093ac59 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/documenting-your-project-with-wikis.md +++ b/translations/ja-JP/content/github/building-a-strong-community/documenting-your-project-with-wikis.md @@ -1,6 +1,6 @@ --- title: ウィキでプロジェクトを文書化する -intro: ウィキを使用してプロジェクトに関する具体的な長文形式の情報を共有できます。 +intro: 'ウィキを使用してプロジェクトに関する具体的な長文形式の情報を共有できます。' redirect_from: - /categories/49/articles/ - /categories/wiki/ diff --git a/translations/ja-JP/content/github/building-a-strong-community/editing-or-deleting-a-team-discussion.md b/translations/ja-JP/content/github/building-a-strong-community/editing-or-deleting-a-team-discussion.md index c49c916dc2c5..782334e69a8c 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/editing-or-deleting-a-team-discussion.md +++ b/translations/ja-JP/content/github/building-a-strong-community/editing-or-deleting-a-team-discussion.md @@ -1,6 +1,6 @@ --- title: Team ディスカッションの編集または削除 -intro: Organization のメンバーは、Team のページでディスカッションを編集または削除できます。 Organization のメンバーであれば、ディスカッションを編集または削除できます。 +intro: 'Organization のメンバーは、Team のページでディスカッションを編集または削除できます。 Organization のメンバーであれば、ディスカッションを編集または削除できます。' redirect_from: - /articles/editing-or-deleting-a-team-discussion versions: diff --git a/translations/ja-JP/content/github/building-a-strong-community/editing-wiki-content.md b/translations/ja-JP/content/github/building-a-strong-community/editing-wiki-content.md index 99a1dd234f16..8997ea4cf336 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/editing-wiki-content.md +++ b/translations/ja-JP/content/github/building-a-strong-community/editing-wiki-content.md @@ -1,6 +1,6 @@ --- title: ウィキのコンテンツを編集する -intro: ウィキ内のコンテンツに画像やリンクを追加したり、一部のサポートされている MediaWiki 形式を使用したりできます。 +intro: 'ウィキ内のコンテンツに画像やリンクを追加したり、一部のサポートされている MediaWiki 形式を使用したりできます。' redirect_from: - /articles/adding-links-to-wikis/ - /articles/how-do-i-add-links-to-my-wiki/ diff --git a/translations/ja-JP/content/github/building-a-strong-community/index.md b/translations/ja-JP/content/github/building-a-strong-community/index.md index 396650d2e284..7f0a984c4fa0 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/index.md +++ b/translations/ja-JP/content/github/building-a-strong-community/index.md @@ -1,6 +1,6 @@ --- title: 強いコミュニティを作る -intro: オープンソースのプロジェクトでもプライベートなプロジェクトでも、コラボレーションのための健全で効果的な環境を構築できます。 +intro: 'オープンソースのプロジェクトでもプライベートなプロジェクトでも、コラボレーションのための健全で効果的な環境を構築できます。' redirect_from: - /categories/building-a-strong-community versions: diff --git a/translations/ja-JP/content/github/building-a-strong-community/limiting-interactions-in-your-organization.md b/translations/ja-JP/content/github/building-a-strong-community/limiting-interactions-in-your-organization.md index 0a5b3a7ee53c..b93a7020799d 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/limiting-interactions-in-your-organization.md +++ b/translations/ja-JP/content/github/building-a-strong-community/limiting-interactions-in-your-organization.md @@ -1,6 +1,6 @@ --- title: Organization での操作を制限する -intro: Organization オーナーは、パブリックリポジトリで特定のユーザがコメントする、Issue をオープンする、あるいはプルリクエストを作成するのを一時的に制限することができます。 +intro: 'Organization オーナーは、パブリックリポジトリで特定のユーザがコメントする、Issue をオープンする、あるいはプルリクエストを作成するのを一時的に制限することができます。' redirect_from: - /github/setting-up-and-managing-organizations-and-teams/limiting-interactions-in-your-organization - /articles/limiting-interactions-in-your-organization diff --git a/translations/ja-JP/content/github/building-a-strong-community/limiting-interactions-in-your-repository.md b/translations/ja-JP/content/github/building-a-strong-community/limiting-interactions-in-your-repository.md index 6ef9ea2ff60b..db4545927e2d 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/limiting-interactions-in-your-repository.md +++ b/translations/ja-JP/content/github/building-a-strong-community/limiting-interactions-in-your-repository.md @@ -1,6 +1,6 @@ --- title: リポジトリでのインタラクションを制限する -intro: オーナーまたは管理者のアクセス権を持つユーザは、あなたのパブリックリポジトリで特定のユーザがコメントする、Issue をオープンする、あるいはプルリクエストを作成するのを一時的に制限し、一定の期間、アクティビティ制限を適用することができます。 +intro: 'オーナーまたは管理者のアクセス権を持つユーザは、あなたのパブリックリポジトリで特定のユーザがコメントする、Issue をオープンする、あるいはプルリクエストを作成するのを一時的に制限し、一定の期間、アクティビティ制限を適用することができます。' redirect_from: - /articles/limiting-interactions-with-your-repository/ - /articles/limiting-interactions-in-your-repository diff --git a/translations/ja-JP/content/github/building-a-strong-community/locking-conversations.md b/translations/ja-JP/content/github/building-a-strong-community/locking-conversations.md index d6ceaa2d8dce..5e86b60383ee 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/locking-conversations.md +++ b/translations/ja-JP/content/github/building-a-strong-community/locking-conversations.md @@ -1,6 +1,6 @@ --- -title: 会話をロックする -intro: リポジトリのオーナーおよびコラボレーター、そしてリポジトリへの書き込みアクセスを持つユーザは、過熱した議論を和らげるために、Issue、プルリクエスト、およびコミットに関する会話を、恒久的または一時的にロックすることができます。 +title: Locking conversations +intro: 'Repository owners and collaborators, and people with write access to a repository, can lock conversations on issues, pull requests, and commits permanently or temporarily to defuse a heated interaction.' redirect_from: - /articles/locking-conversations versions: @@ -8,28 +8,32 @@ versions: enterprise-server: '*' --- -会話が全体的に非建設的になったときや、コミュニティの行動規範{% if currentVersion == "free-pro-team@latest" %}または GitHub の [コミュニティ ガイドライン](/articles/github-community-guidelines){% endif %}に違反しているときは、会話をロックすることが妥当です。 会話をロックするとき、理由を指定することもできます。これは誰にでも見ることができます。 +It's appropriate to lock a conversation when the entire conversation is not constructive or violates your community's code of conduct{% if currentVersion == "free-pro-team@latest" %} or GitHub's [Community Guidelines](/articles/github-community-guidelines){% endif %}. When you lock a conversation, you can also specify a reason, which is publicly visible. -会話をロックすると、リポジトリに対する読み取りアクセスを持つユーザなら誰でも見ることのできるタイムラインイベントが作成されます。 ただし、会話をロックしたユーザの名前は、リポジトリへの書き込みアクセスを持つユーザにしか見えません。 書き込みアクセスを持たないユーザから見ると、タイムラインイベントは匿名化されています。 +Locking a conversation creates a timeline event that is visible to anyone with read access to the repository. However, the username of the person who locked the conversation is only visible to people with write access to the repository. For anyone without write access, the timeline event is anonymized. -![ロックした会話について匿名化されたタイムラインイベント](/assets/images/help/issues/anonymized-timeline-entry-for-locked-conversation.png) +![Anonymized timeline event for a locked conversation](/assets/images/help/issues/anonymized-timeline-entry-for-locked-conversation.png) -会話がロックされている間も、[書き込みアクセスを持つユーザ](/articles/repository-permission-levels-for-an-organization/)と[リポジトリのオーナーおよびコラボレーター](/articles/permission-levels-for-a-user-account-repository/#collaborator-access-on-a-repository-owned-by-a-user-account)はコメントを追加または削除したり、非表示にしたりできます。 +While a conversation is locked, only [people with write access](/articles/repository-permission-levels-for-an-organization/) and [repository owners and collaborators](/articles/permission-levels-for-a-user-account-repository/#collaborator-access-on-a-repository-owned-by-a-user-account) can add, hide, and delete comments. -アーカイブされていないリポジトリでロックされた会話を検索するには、検索修飾子 `is:locked` および `archived:false` を使用できます。 会話はアーカイブされたリポジトリで自動的にロックされます。 詳細は「[Issue およびプルリクエストを検索する](/articles/searching-issues-and-pull-requests#search-based-on-whether-a-conversation-is-locked)」を参照してください。 +To search for locked conversations in a repository that is not archived, you can use the search qualifiers `is:locked` and `archived:false`. Conversations are automatically locked in archived repositories. For more information, see "[Searching issues and pull requests](/articles/searching-issues-and-pull-requests#search-based-on-whether-a-conversation-is-locked)." -1. オプションで、会話をロックする理由を説明するコメントを書いてください。 -2. Issue またはプルリクエストの右マージン、またはコメント ページのコメント ボックスの上で、[**Lock conversation**] をクリックします。 ![[Lock conversation] リンク](/assets/images/help/repository/lock-conversation.png) -3. オプションで、会話をロックする理由を選択します。 ![会話をロックする理由のメニュー](/assets/images/help/repository/locking-conversation-reason-menu.png) -4. 会話のロックに関する情報を読み、[**Lock conversation on this issue**]、[**Lock conversation on this pull request**]、または [ **Lock conversation on this commit**] をクリックします。 ![ロックを確定するダイアログ ボックス](/assets/images/help/repository/lock-conversation-confirm-with-reason.png) -5. 会話のロックを解除できるようになったら、[**Unlock conversation**] をクリックします。 ![[Unlock conversation] リンク](/assets/images/help/repository/unlock-conversation.png) +1. Optionally, write a comment explaining why you're locking the conversation. +2. In the right margin of the issue or pull request, or above the comment box on the commit page, click **Lock conversation**. +![Lock conversation link](/assets/images/help/repository/lock-conversation.png) +3. Optionally, choose a reason for locking the conversation. +![Reason for locking a conversation menu](/assets/images/help/repository/locking-conversation-reason-menu.png) +4. Read the information about locking conversations and click **Lock conversation on this issue**, **Lock conversation on this pull request**, or **Lock conversation on this commit**. +![Confirm lock with a reason dialog box](/assets/images/help/repository/lock-conversation-confirm-with-reason.png) +5. When you're ready to unlock the conversation, click **Unlock conversation**. +![Unlock conversation link](/assets/images/help/repository/unlock-conversation.png) -### 参考リンク +### Further reading -- [健全なコントリビューションを促すプロジェクトをセットアップする](/articles/setting-up-your-project-for-healthy-contributions) -- 「[テンプレートを使用して便利な Issue およびプルリクエストを推進する](/github/building-a-strong-community/using-templates-to-encourage-useful-issues-and-pull-requests)」 -- 「[混乱を生むコメントを管理する](/articles/managing-disruptive-comments)」{% if currentVersion == "free-pro-team@latest" %} -- 「[{% data variables.product.prodname_dotcom %} での安全性を維持する](/github/building-a-strong-community/maintaining-your-safety-on-github)」 -- [悪用あるいはスパムのレポート](/articles/reporting-abuse-or-spam) -- 「[リポジトリでのインタラクションを制限する](/github/building-a-strong-community/limiting-interactions-in-your-repository)」 +- "[Setting up your project for healthy contributions](/articles/setting-up-your-project-for-healthy-contributions)" +- "[Using templates to encourage useful issues and pull requests](/github/building-a-strong-community/using-templates-to-encourage-useful-issues-and-pull-requests)" +- "[Managing disruptive comments](/articles/managing-disruptive-comments)"{% if currentVersion == "free-pro-team@latest" %} +- "[Maintaining your safety on {% data variables.product.prodname_dotcom %}](/github/building-a-strong-community/maintaining-your-safety-on-github)" +- "[Reporting abuse or spam](/articles/reporting-abuse-or-spam)" +- "[Limiting interactions in your repository](/github/building-a-strong-community/limiting-interactions-in-your-repository)" {% endif %} diff --git a/translations/ja-JP/content/github/building-a-strong-community/managing-disruptive-comments.md b/translations/ja-JP/content/github/building-a-strong-community/managing-disruptive-comments.md index b259ef2dcdbe..809825ccfb66 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/managing-disruptive-comments.md +++ b/translations/ja-JP/content/github/building-a-strong-community/managing-disruptive-comments.md @@ -1,6 +1,6 @@ --- -title: 混乱を生むコメントを管理する -intro: 'Issue、プルリクエスト、 およびコミットに対するコメントを{% if currentVersion == "free-pro-team@latest" %}非表示、編集{% else %}編集{% endif %}、削除できます。' +title: Managing disruptive comments +intro: 'You can {% if currentVersion == "free-pro-team@latest" %}hide, edit,{% else %}edit{% endif %} or delete comments on issues, pull requests, and commits.' redirect_from: - /articles/editing-a-comment/ - /articles/deleting-a-comment/ @@ -10,69 +10,76 @@ versions: enterprise-server: '*' --- -### コメントを非表示にする +### Hiding a comment -リポジトリに対する書き込み権限があるユーザは、Issue、プルリクエスト、 およびコミットに対するコメントを非表示にすることができます。 +Anyone with write access to a repository can hide comments on issues, pull requests, and commits. -1 つのディスカッションに集中し、プルリクエストのナビゲーションとレビューがしやすいように、トピックから外れている、古い、または解決済みのコメントは非表示にすることができます。 非表示のコメントは最小化されますが、リポジトリに対する読み取りアクセスがあるユーザは展開することができます。 +If a comment is off-topic, outdated, or resolved, you may want to hide a comment to keep a discussion focused or make a pull request easier to navigate and review. Hidden comments are minimized but people with read access to the repository can expand them. -![最小化されたコメント](/assets/images/help/repository/hidden-comment.png) +![Minimized comment](/assets/images/help/repository/hidden-comment.png) -1. 非表示にするコメントに移動します。 -2. コメントの右上隅にある {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} をクリックしてから、[**Hide**] をクリックします。 ![編集、非表示、削除のオプションが表示されている水平の kebab アイコンとコメント モデレーション メニュー](/assets/images/help/repository/comment-menu.png) -3. [Choose a reason] ドロップダウン メニューで、コメントを非表示にする理由をクリックします。 次に、[**Hide comment**] をクリックします。 +1. Navigate to the comment you'd like to hide. +2. In the upper-right corner of the comment, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Hide**. + ![The horizontal kebab icon and comment moderation menu showing the edit, hide, delete options](/assets/images/help/repository/comment-menu.png) +3. Using the "Choose a reason" drop-down menu, click a reason to hide the comment. Then click, **Hide comment**. {% if currentVersion == "free-pro-team@latest" %} - ![[Choose reason for hiding comment] ドロップダウンメニュー](/assets/images/help/repository/choose-reason-for-hiding-comment.png) + ![Choose reason for hiding comment drop-down menu](/assets/images/help/repository/choose-reason-for-hiding-comment.png) {% else %} - ![[Choose reason for hiding comment] ドロップダウンメニュー](/assets/images/help/repository/choose-reason-for-hiding-comment-ghe.png) + ![Choose reason for hiding comment drop-down menu](/assets/images/help/repository/choose-reason-for-hiding-comment-ghe.png) {% endif %} -### コメントを再表示する +### Unhiding a comment -リポジトリに対する書き込み権限があるユーザは、Issue、プルリクエスト、 およびコミットに対するコメントを再表示することができます。 +Anyone with write access to a repository can unhide comments on issues, pull requests, and commits. -1. 再表示するコメントに移動します。 -2. コメントの右上隅にある [**{% octicon "fold" aria-label="The fold icon" %}Show comment**] をクリックします。 ![コメント テキストの表示](/assets/images/help/repository/hidden-comment-show.png) -3. 展開したコメントの右側にある {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}をクリックしてから、[**Unhide**] をクリックします。 ![編集、再表示、削除のオプションが表示されている水平の kebab アイコンとコメント モデレーションメニュー](/assets/images/help/repository/comment-menu-hidden.png) +1. Navigate to the comment you'd like to unhide. +2. In the upper-right corner of the comment, click **{% octicon "fold" aria-label="The fold icon" %} Show comment**. + ![Show comment text](/assets/images/help/repository/hidden-comment-show.png) +3. On the right side of the expanded comment, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then **Unhide**. + ![The horizontal kebab icon and comment moderation menu showing the edit, unhide, delete options](/assets/images/help/repository/comment-menu-hidden.png) -### コメントを編集する +### Editing a comment -リポジトリに対する書き込み権限があるユーザは、Issue、プルリクエスト、およびコミットに対するコメントを編集することができます。 +Anyone with write access to a repository can edit comments on issues, pull requests, and commits. -会話に関係がない、コミュニティの行動規範{% if currentVersion == "free-pro-team@latest" %}または GitHub の[コミュニティ ガイドライン](/articles/github-community-guidelines){% endif %}に違反している場合は、コメントを編集して内容を削除するのが妥当です。 +It's appropriate to edit a comment and remove content that doesn't contribute to the conversation and violates your community's code of conduct{% if currentVersion == "free-pro-team@latest" %} or GitHub's [Community Guidelines](/articles/github-community-guidelines){% endif %}. -コメントを編集する際には、削除した内容があった元の場所がわかるように記録し、オプションで削除の理由を示します。 +When you edit a comment, note the location that the content was removed from and optionally, the reason for removing it. -リポジトリの読み取りアクセスがあれば、誰でもコミットの編集履歴を見ることができます。 コメントの上部にある [**edited**] ドロップダウンには編集履歴があり、編集したユーザとタイムスタンプが表示されます。 +Anyone with read access to a repository can view a comment's edit history. The **edited** dropdown at the top of the comment contains a history of edits showing the user and timestamp for each edit. -![内容を削除編集したというメモを追加したコメント](/assets/images/help/repository/content-redacted-comment.png) +![Comment with added note that content was redacted](/assets/images/help/repository/content-redacted-comment.png) -コメントの作者とリポジトリの書き込みアクセスがあるユーザは、コメントの編集履歴から機密情報を削除できます。 詳しい情報については、「[コメントの変更を追跡する](/github/building-a-strong-community/tracking-changes-in-a-comment)」を参照してください。 +Comment authors and anyone with write access to a repository can also delete sensitive information from a comment's edit history. For more information, see "[Tracking changes in a comment](/github/building-a-strong-community/tracking-changes-in-a-comment)." -1. 編集したいコメントに移動します。 -2. コメントの右上隅にある {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} をクリックし、次に [**Edit**] をクリックします。 ![編集、非表示、削除、レポートのオプションが表示されている水平の kebab アイコンとコメント モデレーション メニュー](/assets/images/help/repository/comment-menu.png) -3. コメント ウィンドウで、問題のある部分を削除し、その場所に `[REDACTED]` と入力します。 ![内容を削除したコメント ウィンドウ](/assets/images/help/issues/redacted-content-comment.png) -4. コメントの下部に、コメントを編集したことを示すメモを入力し、オプションで編集した理由も入力します。 ![内容を削除したというメモを追加したコメント ウィンドウ](/assets/images/help/issues/note-content-redacted-comment.png) -5. [**Update comment**] をクリックします。 +1. Navigate to the comment you'd like to edit. +2. In the upper-right corner of the comment, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Edit**. + ![The horizontal kebab icon and comment moderation menu showing the edit, hide, delete, and report options](/assets/images/help/repository/comment-menu.png) +3. In the comment window, delete the content you'd like to remove, then type `[REDACTED]` to replace it. + ![Comment window with redacted content](/assets/images/help/issues/redacted-content-comment.png) +4. At the bottom of the comment, type a note indicating that you have edited the comment, and optionally, why you edited the comment. + ![Comment window with added note that content was redacted](/assets/images/help/issues/note-content-redacted-comment.png) +5. Click **Update comment**. -### コメントを削除する +### Deleting a comment -リポジトリに対する書き込み権限があるユーザは、Issue、プルリクエスト、 およびコミットに対するコメントを削除することができます。 Organization オーナー、チームメンテナ、コメント作成者は、チームのページのコメントを削除することもできます。 +Anyone with write access to a repository can delete comments on issues, pull requests, and commits. Organization owners, team maintainers, and the comment author can also delete a comment on a team page. -コメントの削除は、モデレーターとしての最終手段です。 コメント全体が会話にとって建設的な内容ではない場合や、コミュニティの行動規範{% if currentVersion == "free-pro-team@latest" %}または GitHub の[コミュニティ ガイドライン](/articles/github-community-guidelines){% endif %}に違反している場合は、コメントを削除するのが妥当です。 +Deleting a comment is your last resort as a moderator. It's appropriate to delete a comment if the entire comment adds no constructive content to a conversation and violates your community's code of conduct{% if currentVersion == "free-pro-team@latest" %} or GitHub's [Community Guidelines](/articles/github-community-guidelines){% endif %}. -コメントを削除すると、リポジトリに対する読み取りアクセスを持つユーザなら誰でも見ることのできるタイムラインイベントが作成されます。 ただし、コメントを削除したユーザの名前は、リポジトリへの書き込みアクセスを持つユーザにしか見えません。 書き込みアクセスを持たないユーザから見ると、タイムラインイベントは匿名化されています。 +Deleting a comment creates a timeline event that is visible to anyone with read access to the repository. However, the username of the person who deleted the comment is only visible to people with write access to the repository. For anyone without write access, the timeline event is anonymized. -![削除したコメントについて匿名化されたタイムラインイベント](/assets/images/help/issues/anonymized-timeline-entry-for-deleted-comment.png) +![Anonymized timeline event for a deleted comment](/assets/images/help/issues/anonymized-timeline-entry-for-deleted-comment.png) -Issue やプルリクエストで、会話に役立つ建設的な内容が部分的に含まれているコメントは、削除せず編集してください。 +If a comment contains some constructive content that adds to the conversation in the issue or pull request, you can edit the comment instead. {% note %} -**メモ:** Issue またはプルリクエストの最初のコメント (本文) は削除できません。 かわりに、Issue やプルリクエストの本文を編集して、不要な内容を削除してください。 +**Note:** The initial comment (or body) of an issue or pull request can't be deleted. Instead, you can edit issue and pull request bodies to remove unwanted content. {% endnote %} -1. 削除したいコメントに移動します。 -2. コメントの右上隅にある {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} をクリックしてから、[**Delete**] をクリックします。 ![編集、非表示、削除、レポートのオプションが表示されている水平の kebab アイコンとコメント モデレーション メニュー](/assets/images/help/repository/comment-menu.png) -3. オプションで、コメントを削除したことを示すコメントとその理由を入力します。 +1. Navigate to the comment you'd like to delete. +2. In the upper-right corner of the comment, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Delete**. + ![The horizontal kebab icon and comment moderation menu showing the edit, hide, delete, and report options](/assets/images/help/repository/comment-menu.png) +3. Optionally, write a comment noting that you deleted a comment and why. diff --git a/translations/ja-JP/content/github/building-a-strong-community/managing-reported-content-in-your-organizations-repository.md b/translations/ja-JP/content/github/building-a-strong-community/managing-reported-content-in-your-organizations-repository.md index faf69507dde0..a4a3202f55bc 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/managing-reported-content-in-your-organizations-repository.md +++ b/translations/ja-JP/content/github/building-a-strong-community/managing-reported-content-in-your-organizations-repository.md @@ -1,6 +1,6 @@ --- title: Organization のリポジトリ内でレポートされたコンテンツを管理する -intro: コントリビューターがリポジトリ内の混乱をもらたすコンテンツをレポートすると、リポジトリメンテナはレポートを表示および管理できます。 +intro: 'コントリビューターがリポジトリ内の混乱をもらたすコンテンツをレポートすると、リポジトリメンテナはレポートを表示および管理できます。' versions: free-pro-team: '*' --- diff --git a/translations/ja-JP/content/github/building-a-strong-community/manually-creating-a-single-issue-template-for-your-repository.md b/translations/ja-JP/content/github/building-a-strong-community/manually-creating-a-single-issue-template-for-your-repository.md index 855ff3e56451..0293158786ec 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/manually-creating-a-single-issue-template-for-your-repository.md +++ b/translations/ja-JP/content/github/building-a-strong-community/manually-creating-a-single-issue-template-for-your-repository.md @@ -1,6 +1,6 @@ --- title: リポジトリ用の単一 Issue テンプレートを手動で作成する -intro: 手動で作成した Issue テンプレートをリポジトリに追加すると、プロジェクトのコントリビューターは自動的に Issue の本体でテンプレートの内容が見えるようになります。 +intro: '手動で作成した Issue テンプレートをリポジトリに追加すると、プロジェクトのコントリビューターは自動的に Issue の本体でテンプレートの内容が見えるようになります。' redirect_from: - /articles/creating-an-issue-template-for-your-repository/ - /articles/manually-creating-a-single-issue-template-for-your-repository diff --git a/translations/ja-JP/content/github/building-a-strong-community/moderating-comments-and-conversations.md b/translations/ja-JP/content/github/building-a-strong-community/moderating-comments-and-conversations.md index e01f4b0aad4b..c7f568521316 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/moderating-comments-and-conversations.md +++ b/translations/ja-JP/content/github/building-a-strong-community/moderating-comments-and-conversations.md @@ -1,6 +1,6 @@ --- title: コメントおよび会話をモデレートする -intro: 会話を管理すると、健全なコラボレーションを進めつつ対立を緩和できるので、プロジェクトのコントリビューター全員にとって友好的なコミュニティが成立します。 レポートされたコンテンツの表示、コメントの編集および削除や会話のロックによって、ディスカッションにコミュニティの行動規範を適用することができます。 +intro: '会話を管理すると、健全なコラボレーションを進めつつ対立を緩和できるので、プロジェクトのコントリビューター全員にとって友好的なコミュニティが成立します。 レポートされたコンテンツの表示、コメントの編集および削除や会話のロックによって、ディスカッションにコミュニティの行動規範を適用することができます。' mapTopic: true redirect_from: - /articles/moderating-comments-and-conversations diff --git a/translations/ja-JP/content/github/building-a-strong-community/pinning-a-team-discussion.md b/translations/ja-JP/content/github/building-a-strong-community/pinning-a-team-discussion.md index 03686e4b4ef6..0f9d808d0f9a 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/pinning-a-team-discussion.md +++ b/translations/ja-JP/content/github/building-a-strong-community/pinning-a-team-discussion.md @@ -1,6 +1,6 @@ --- title: Team ディスカッションをピン止めする -intro: 重要なディスカッションは、参照しやすいように Organization の Team ページにピン止めすることができ、必要がなくなったらピン止めを解除できます。 +intro: '重要なディスカッションは、参照しやすいように Organization の Team ページにピン止めすることができ、必要がなくなったらピン止めを解除できます。' redirect_from: - /articles/pinning-a-team-discussion versions: diff --git a/translations/ja-JP/content/github/building-a-strong-community/reporting-abuse-or-spam.md b/translations/ja-JP/content/github/building-a-strong-community/reporting-abuse-or-spam.md index b19c777396e2..3e6d7000c66f 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/reporting-abuse-or-spam.md +++ b/translations/ja-JP/content/github/building-a-strong-community/reporting-abuse-or-spam.md @@ -58,7 +58,7 @@ versions: - [健全なコントリビューションを促すプロジェクトをセットアップする](/articles/setting-up-your-project-for-healthy-contributions) - 「[テンプレートを使用して便利な Issue およびプルリクエストを推進する](/github/building-a-strong-community/using-templates-to-encourage-useful-issues-and-pull-requests)」 -- 「[混乱を生むコメントを管理する](/articles/managing-disruptive-comments)」{% if currentVersion == "free-pro-team@latest" %} +- "[Managing disruptive comments](/articles/managing-disruptive-comments)"{% if currentVersion == "free-pro-team@latest" %} - 「[ {% data variables.product.prodname_dotcom %} での安全性を維持する](/github/building-a-strong-community/maintaining-your-safety-on-github)」 - 「[リポジトリでのインタラクションを制限する](/github/building-a-strong-community/limiting-interactions-in-your-repository)」{% endif %} - 「[コメントの変更を追跡する](/articles/tracking-changes-in-a-comment)」 diff --git a/translations/ja-JP/content/github/building-a-strong-community/setting-guidelines-for-repository-contributors.md b/translations/ja-JP/content/github/building-a-strong-community/setting-guidelines-for-repository-contributors.md index 69b132185793..11cb737db78e 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/setting-guidelines-for-repository-contributors.md +++ b/translations/ja-JP/content/github/building-a-strong-community/setting-guidelines-for-repository-contributors.md @@ -19,7 +19,7 @@ versions: オーナーおよびコントリビューターの双方にとって、コントリビューションガイドラインは、プルリクエストや Issue のリジェクトや再提出の手間を未然に軽減するための有効な手段です。 -Organization {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}またはユーザアカウント{% endif %}用のデフォルトのコントリビューションガイドラインを作成できます。 詳しい情報については「[デフォルトのコミュニティ健全性ファイルを作成する](/github/building-a-strong-community/creating-a-default-community-health-file)」を参照してください。 +You can create default contribution guidelines for your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %}. 詳しい情報については「[デフォルトのコミュニティ健全性ファイルを作成する](/github/building-a-strong-community/creating-a-default-community-health-file)」を参照してください。 {% tip %} @@ -51,6 +51,6 @@ Organization {% if currentVersion == "free-pro-team@latest" or currentVersion ve - オープンガバメント [コントリビューションガイドライン](https://github.com/opengovernment/opengovernment/blob/master/CONTRIBUTING.md). ### 参考リンク -- オープンソースガイドのセクション「[オープンソースプロジェクトを始める](https://opensource.guide/starting-a-project/)」{% if currentVersion == "free-pro-team@latest" %} +- The Open Source Guides' section "[Starting an Open Source Project](https://opensource.guide/starting-a-project/)"{% if currentVersion == "free-pro-team@latest" %} - [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}){% endif %} - [リポジトリへのライセンスの追加](/articles/adding-a-license-to-a-repository) diff --git a/translations/ja-JP/content/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions.md b/translations/ja-JP/content/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions.md index d6b54c4a8d85..0f14a1a244ed 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions.md +++ b/translations/ja-JP/content/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions.md @@ -1,6 +1,6 @@ --- title: 健全なコントリビューションを促すプロジェクトをセットアップする -intro: リポジトリメンテナは、コントリビューションガイドラインを設定することで、コントリビュータがプロジェクトに対して意味のある有益なコントリビューションを行うことに役立ちます。 +intro: 'リポジトリメンテナは、コントリビューションガイドラインを設定することで、コントリビュータがプロジェクトに対して意味のある有益なコントリビューションを行うことに役立ちます。' redirect_from: - /articles/helping-people-contribute-to-your-project/ - /articles/setting-up-your-project-for-healthy-contributions diff --git a/translations/ja-JP/content/github/building-a-strong-community/tracking-changes-in-a-comment.md b/translations/ja-JP/content/github/building-a-strong-community/tracking-changes-in-a-comment.md index 80499e2591ac..3a523f274705 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/tracking-changes-in-a-comment.md +++ b/translations/ja-JP/content/github/building-a-strong-community/tracking-changes-in-a-comment.md @@ -28,5 +28,5 @@ versions: ### 参考リンク -{% if currentVersion == "free-pro-team@latest" %}- 「[乱用やスパムをレポートする](/articles/reporting-abuse-or-spam)」{% endif %} +{% if currentVersion == "free-pro-team@latest" %}- "[Reporting abuse or spam](/articles/reporting-abuse-or-spam)"{% endif %} - 「[コメントを編集する](/articles/editing-a-comment)」 diff --git a/translations/ja-JP/content/github/building-a-strong-community/unblocking-a-user-from-your-organization.md b/translations/ja-JP/content/github/building-a-strong-community/unblocking-a-user-from-your-organization.md index b9ea85d43cde..58e2faa583ab 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/unblocking-a-user-from-your-organization.md +++ b/translations/ja-JP/content/github/building-a-strong-community/unblocking-a-user-from-your-organization.md @@ -1,6 +1,6 @@ --- title: Organization からユーザのブロックを解除する -intro: Organization のオーナーは、過去にブロックしたユーザのブロックを解除し、Organization のリポジトリへのアクセスを回復できます。 +intro: 'Organization のオーナーは、過去にブロックしたユーザのブロックを解除し、Organization のリポジトリへのアクセスを回復できます。' redirect_from: - /articles/unblocking-a-user-from-your-organization versions: diff --git a/translations/ja-JP/content/github/building-a-strong-community/viewing-a-wikis-history-of-changes.md b/translations/ja-JP/content/github/building-a-strong-community/viewing-a-wikis-history-of-changes.md index b25cd0ce2a21..1e9f8f3a931b 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/viewing-a-wikis-history-of-changes.md +++ b/translations/ja-JP/content/github/building-a-strong-community/viewing-a-wikis-history-of-changes.md @@ -1,6 +1,6 @@ --- title: ウィキの変更履歴を表示する -intro: ウィキは Git リポジトリであるため、行うすべての変更は、表示できるコミットです。 +intro: 'ウィキは Git リポジトリであるため、行うすべての変更は、表示できるコミットです。' product: '{% data reusables.gated-features.wikis %}' redirect_from: - /articles/viewing-a-wiki-s-history-of-changes diff --git a/translations/ja-JP/content/github/building-a-strong-community/viewing-users-who-are-blocked-from-your-organization.md b/translations/ja-JP/content/github/building-a-strong-community/viewing-users-who-are-blocked-from-your-organization.md index 16710457cfe1..e1b50d043c11 100644 --- a/translations/ja-JP/content/github/building-a-strong-community/viewing-users-who-are-blocked-from-your-organization.md +++ b/translations/ja-JP/content/github/building-a-strong-community/viewing-users-who-are-blocked-from-your-organization.md @@ -1,6 +1,6 @@ --- title: Organization からブロックされているユーザの表示 -intro: あなたまたは他のコードオーナーがあなたの Organization からブロックしているすべてのユーザの一覧を表示することができます。 ユーザが一定期間ブロックされた場合は、ユーザがブロックされた時間を確認できます。 +intro: 'あなたまたは他のコードオーナーがあなたの Organization からブロックしているすべてのユーザの一覧を表示することができます。 ユーザが一定期間ブロックされた場合は、ユーザがブロックされた時間を確認できます。' redirect_from: - /articles/viewing-users-who-are-blocked-from-your-organization versions: diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-branches.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-branches.md index 32a2d447e2f8..42da8e58f43a 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-branches.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-branches.md @@ -1,6 +1,6 @@ --- title: ブランチについて -intro: 開発作業をリポジトリ内の他のブランチに影響することなく分離するために、ブランチを使ってください。 各リポジトリには1つのデフォルトブランチがあり、複数の他のブランチを持つことができます。 プルリクエストを使えば、ブランチを他のブランチにマージできます。 +intro: '開発作業をリポジトリ内の他のブランチに影響することなく分離するために、ブランチを使ってください。 各リポジトリには1つのデフォルトブランチがあり、複数の他のブランチを持つことができます。 プルリクエストを使えば、ブランチを他のブランチにマージできます。' redirect_from: - /articles/working-with-protected-branches/ - /articles/about-branches @@ -10,28 +10,30 @@ versions: --- -### ブランチの概要 +### ブランチについて Branches allow you to develop features, fix bugs, or safely experiment with new ideas in a contained area of your repository. ブランチは常に既存のものから作成します。 Typically, you might create a new branch from the default branch of your repository. その後、他の人がリポジトリに加えた変更とは別に、新しいブランチで作業できます。 機能を構築するために作成するブランチは、通常、フィーチャブランチまたはトピックブランチと呼ばれます。 詳しい情報については[リポジトリ内でのブランチの作成と削除](/articles/creating-and-deleting-branches-within-your-repository/)を参照してください。 -また、{% data variables.product.prodname_pages %}サイトを公開するためにブランチを使うこともできます。 詳しい情報については[{% data variables.product.prodname_dotcom %}Pagesと何か？](/articles/what-is-github-pages)を参照してください。 +また、{% data variables.product.prodname_pages %}サイトを公開するためにブランチを使うこともできます。 詳しい情報については「[{% data variables.product.prodname_pages %}について](/articles/what-is-github-pages)」を参照してください。 -ブランチの作成、プルリクエストのオープン、プルリクエスト中でのブランチの削除とリストアを行うためには、リポジトリへの書き込みアクセスを持っていなければなりません。 詳しい情報については、「[{% data variables.product.product_name %}上のアクセス権限](/articles/access-permissions-on-github)」を参照してください。 +ブランチの作成、プルリクエストのオープン、プルリクエスト中でのブランチの削除とリストアを行うためには、リポジトリへの書き込みアクセスを持っていなければなりません。 詳細は「[{% data variables.product.prodname_dotcom %} 上のアクセス権限](/github/getting-started-with-github/access-permissions-on-github)」を参照してください。 ### About the default branch {% data reusables.branches.new-repo-default-branch %} The default branch is the branch that {% data variables.product.prodname_dotcom %} displays when anyone visits your repository. The default branch is also the initial branch that Git checks out locally out when someone clones the repository. {% data reusables.branches.default-branch-automatically-base-branch %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +By default, {% data variables.product.product_name %} names the default branch {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.23" %}`main`{% else %}`master`{% endif %} in any new repository. -By default, the default branch name is `master`, but you can set the name to anything that makes sense for your workflow. For more information on the default branch name, see "[Managing the default branch name for your repositories](/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories)." +{% data reusables.branches.set-default-branch %} -{% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} {% data reusables.branches.set-default-branch %} +{% endif %} + ### ブランチを使用する 満足の行くところまで作業したら、プルリクエストをオープンして、現在のブランチ（*head* ブランチ）の変更を別のブランチ（*base* ブランチ）にマージできます。 詳しい情報については[プルリクエストについて](/articles/about-pull-requests)を参照してください。 @@ -71,7 +73,7 @@ By default, the default branch name is `master`, but you can set the name to any - ブランチでステータスチェック必須が有効化されていると、必要なCIテストがすべてパスするまで、変更をブランチにマージできません。 詳しい情報については[ステータスチェックについて](/articles/about-status-checks)を参照してください。 - ブランチでプルリクエストレビュー必須が有効化されている場合、プルリクエストレビューポリシー中のすべての要求が満たされるまでは、ブランチに変更をマージできません。 詳しい情報については[プルリクエストのマージ](/articles/merging-a-pull-request)を参照してください。 - ブランチでコードオーナーからの必須レビューが有効化されており、プルリクエストがオーナーを持つコードを変更している場合、コードオーナーがプルリクエストを承認しなければ、そのプルリクエストはマージできません。 詳細は「[コードオーナーについて](/articles/about-code-owners)」を参照してください。 -- ブランチでコミット署名必須が有効化されている場合、署名および検証されていないコミットはブランチにプッシュできません。 詳しい情報については、「[コミット署名の検証について](/articles/about-commit-signature-verification)」および「[必須のコミット署名について](/articles/about-required-commit-signing)」を参照してください。{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} +- ブランチでコミット署名必須が有効化されている場合、署名および検証されていないコミットはブランチにプッシュできません。 For more information, see "[About commit signature verification](/articles/about-commit-signature-verification)" and "[About required commit signing](/articles/about-required-commit-signing)."{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} - {% data variables.product.prodname_dotcom %} のコンフリクトエディターを使用して、保護されたブランチから作成したプルリクエストのコンフリクトを修正する場合、{% data variables.product.prodname_dotcom %} はプルリクエストの代替ブランチを作成して、コンフリクトの解決をマージできるようにします。 詳しい情報については、「[{% data variables.product.prodname_dotcom %} でマージコンフリクトを解決する](/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github)」を参照してください。{% endif %} ### 参考リンク diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md index 6f39cc32eea7..6c66c01187af 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md @@ -38,7 +38,7 @@ diff の見方には複数の選択肢があります。 ![Diff の表示のオプションメニュー](/assets/images/help/pull_requests/diff-settings-menu.png) -大きなプルリクエスト中の変更のレビューをシンプルにするために、選択されたファイルタイプだけを表示、{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}コードオーナーであるファイルを表示、表示したことのあるファイルを非表示、{% endif %}または削除されたファイルを非表示にするように diff をフィルタリングできます。 詳しい情報については、「[プルリクエスト内のファイルをファイルタイプでフィルタリングする](/articles/filtering-files-in-a-pull-request)」を参照してください。 +To simplify reviewing changes in a large pull request, you can filter the diff to only show selected file types, show files you are a CODEOWNER of, hide files you have already viewed, or hide deleted files. 詳しい情報については、「[プルリクエスト内のファイルをファイルタイプでフィルタリングする](/articles/filtering-files-in-a-pull-request)」を参照してください。 ![ファイルフィルタのドロップダウンメニュー](/assets/images/help/pull_requests/file-filter-menu.png) @@ -54,7 +54,7 @@ diff の見方には複数の選択肢があります。 プルリクエスト中でツードット diff をシミュレートし、各ブランチの最新バージョン同士の比較を見たい場合には、ベースブランチをトピックブランチにマージできます。そうすれば、ブランチ間の最後の共通の祖先が更新されます。 -変更を比較するための Git コマンドに関する詳しい情報については、_Pro Git_ ブックサイトの「[Git diff のオプション](https://git-scm.com/docs/git-diff#git-diff-emgitdiffemltoptionsgtltcommitgtltcommitgt--ltpathgt82308203)」を参照してください。 +For more information about Git commands to compare changes, see "[Git diff options](https://git-scm.com/docs/git-diff#git-diff-emgitdiffemltoptionsgtltcommitgtltcommitgt--ltpathgt82308203)" from the _Pro Git_ book site. ### diffが表示されない理由 - ファイルあるいは特定のファイルタイプの合計での制限を超えた。 詳しい情報については[リポジトリ中のコンテンツとdiffの表示の制限](/articles/limits-for-viewing-content-and-diffs-in-a-repository/#diff-limits)を参照してください。 diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github.md index 565b3a5c4e82..80205d028814 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github.md @@ -19,7 +19,7 @@ Issueは、バグレポートや計画された改善など、プロジェクト ### コメント中のアイデアへの反応 -議論の中のアイデアに対する賛意や異議を示すことができます。 Team ディスカッション、Issue、プルリクエストのコメントや本体に反応を加えても、その会話をサブスクライブしている人には通知が送信されません。 サブスクリプションの詳細については、 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}「[通知について](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}「[通知のサブスクライブとサブスクライブ解除 ](/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications){% endif %}」を参照してください。 +議論の中のアイデアに対する賛意や異議を示すことができます。 Team ディスカッション、Issue、プルリクエストのコメントや本体に反応を加えても、その会話をサブスクライブしている人には通知が送信されません。 For more information about subscriptions, 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 %}"[Subscribing to and unsubscribing from notifications](/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications){% endif %}." ![反応を含むIssueの例](/assets/images/help/repository/issue-reactions.png) diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-forks.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-forks.md index 60657b18d9b9..34ec9dc74c13 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-forks.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-forks.md @@ -17,17 +17,17 @@ versions: {% data reusables.repositories.desktop-fork %} -フォークを削除しても、オリジナルの上流のリポジトリは削除されません。 オリジナルに影響を与えることなく、コラボレータの追加、ファイル名の変更、{% data variables.product.prodname_pages %} の生成など、自分のフォークに必要な変更を加えることができます。{% if currentVersion == "free-pro-team@latest" %}削除されたフォークリポジトリを復元することはできません。 詳しい情報については、「[削除されたリポジトリを復元する](/articles/restoring-a-deleted-repository)」を参照してください。{% endif %} +フォークを削除しても、オリジナルの上流のリポジトリは削除されません。 You can make any changes you want to your fork—add collaborators, rename files, generate {% data variables.product.prodname_pages %}—with no effect on the original.{% if currentVersion == "free-pro-team@latest" %} You cannot restore a deleted forked repository. 詳しい情報については、「[削除されたリポジトリを復元する](/articles/restoring-a-deleted-repository)」を参照してください。{% endif %} オープンソースプロジェクトでは、フォークを使用して、上流のリポジトリに提供される前にアイデアや変更をイテレーションすることがよくあります。 ユーザ所有のフォークに変更を加え、作業を上流リポジトリと比較するプルリクエストをオープンすると、上流リポジトリへのプッシュアクセスできる人に対して、変更をプルリクエストブランチにプッシュする権限を付与することができます。 これにより、リポジトリメンテナがマージする前に、ユーザが所有するフォークからプルリクエストブランチに対してローカルでコミットを実行したり、テストを実行したりすることができるようになり、コラボレーションがスピードアップします。 Organization が所有するフォークにプッシュ権限を与えることはできません。 {% data reusables.repositories.private_forks_inherit_permissions %} -既存のリポジトリのコンテンツから新しいリポジトリを作成したいけれども、将来にわたって変更を上流にマージしたくない場合、リポジトリを複製する{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}か、リポジトリがテンプレートである場合は、リポジトリをテンプレートとして使う{% endif %}ことができます。 詳細は「[リポジトリを複製する](/articles/duplicating-a-repository)」{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}および「[テンプレートからリポジトリを作成する](/articles/creating-a-repository-from-a-template)」{% endif %}を参照してください。 +If you want to create a new repository from the contents of an existing repository but don't want to merge your changes upstream in the future, you can duplicate the repository or, if the repository is a template, use the repository as a template. 詳細は「[リポジトリを複製する](/articles/duplicating-a-repository)」および「[テンプレートからリポジトリを作成する](/articles/creating-a-repository-from-a-template)」を参照してください。 ### 参考リンク - [コラボレーティブ開発モデルについて](/articles/about-collaborative-development-models) - [フォークからプルリクエストを作成する](/articles/creating-a-pull-request-from-a-fork) -- [オープンソースガイド](https://opensource.guide/){% if currentVersion == "free-pro-team@latest" %} +- [Open Source Guides](https://opensource.guide/){% if currentVersion == "free-pro-team@latest" %} - [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}){% endif %} diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-merge-conflicts.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-merge-conflicts.md index 160c48bc5bf9..9acf0f859912 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-merge-conflicts.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-merge-conflicts.md @@ -1,6 +1,6 @@ --- title: マージコンフリクトについて -intro: マージコンフリクトは、競合するコミットを持つブランチをマージしようとしたときに生じるもので、最終のマージにどちらの変更を取り入れるかを Git が判断するのに手助けが必要になります。 +intro: 'マージコンフリクトは、競合するコミットを持つブランチをマージしようとしたときに生じるもので、最終のマージにどちらの変更を取り入れるかを Git が判断するのに手助けが必要になります。' redirect_from: - /articles/about-merge-conflicts versions: diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-reviews.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-reviews.md index 24caae8a868b..ca2743ce6c70 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-reviews.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-reviews.md @@ -1,6 +1,6 @@ --- title: プルリクエストのレビューについて -intro: レビューを使うと、コラボレーターはプルリクエスト中で提案された変更に対してコメントしたり、変更を承認したり、プルリクエストがマージされる前にさらなる変更をリクエストしたりできます。 リポジトリ管理者は、すべてのプルリクエストをマージ前に承認することを必須にできます。 +intro: 'レビューを使うと、コラボレーターはプルリクエスト中で提案された変更に対してコメントしたり、変更を承認したり、プルリクエストがマージされる前にさらなる変更をリクエストしたりできます。 リポジトリ管理者は、すべてのプルリクエストをマージ前に承認することを必須にできます。' redirect_from: - /articles/about-pull-request-reviews versions: @@ -12,11 +12,11 @@ versions: プルリクエストがオープンになった後、*読み取り*アクセスを持つすべてのユーザは、提案された変更をレビューしてコメントできます。 また、作者がプルリクエストから直接適用できるコード行への特定の変更を提案することもできます。 詳細は「[プルリクエストで提案された変更をレビューする](/articles/reviewing-proposed-changes-in-a-pull-request)」を参照してください。 -リポジトリオーナーとコラボレーターは、特定の人物にプルリクエストのレビューをリクエストできます。 また、Organization メンバーは、リポジトリの読み取りアクセス権を持つ Team にプルリクエストのレビューをリクエストできます。 詳細は「[プルリクエストのレビューをリクエストする](/articles/requesting-a-pull-request-review/)」を参照してください。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}Teamメンバーのサブセットを指定して、Team 全体に代わって自動で割り当てることができます。 詳しい情報については、「[Team のコードレビューの割り当てを管理する](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)」を参照してください。{% endif %} +リポジトリオーナーとコラボレーターは、特定の人物にプルリクエストのレビューをリクエストできます。 また、Organization メンバーは、リポジトリの読み取りアクセス権を持つ Team にプルリクエストのレビューをリクエストできます。 詳細は「[プルリクエストのレビューをリクエストする](/articles/requesting-a-pull-request-review/)」を参照してください。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}You can specify a subset of team members to be automatically assigned in the place of the whole team. 詳しい情報については、「[Team のコードレビューの割り当てを管理する](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)」を参照してください。{% endif %} レビューにより、提案された変更についての議論がなされ、その変更がリポジトリのコントリビューションのガイドラインやその他の品質標準を満たすことを保証しやすくなります。 コードの特定の種類や領域に対して、どの個人や Team をオーナーとするかを、CODEOWNERS ファイルで定義できます。 プルリクエストが、定義されたオーナーを持っているコードを変更するものである場合、オーナーである個人あるいはTeam がレビューを担当するよう、自動的にリクエストされます。 詳細は「[コードオーナーについて](/articles/about-code-owners/)」を参照してください。 -{% if currentVersion == "free-pro-team@latest" %}レビューが必要なプルリクエストのリマインダーをスケジュールできます。 詳しい情報については、「[プルリクエストのスケジュールされたリマインダーを管理する](/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests)」を参照してください。{% endif %} +{% if currentVersion == "free-pro-team@latest" %}You can schedule reminders for pull requests that need to be reviewed. 詳しい情報については、「[プルリクエストのスケジュールされたリマインダーを管理する](/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests)」を参照してください。{% endif %} ![凝固メント付きの変更をリクエストするレビューのヘッダ](/assets/images/help/pull_requests/review-header-with-line-comment.png) diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md index b91f374f6e70..1f234bccaa5b 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md @@ -46,7 +46,7 @@ Organization オーナー、およびリポジトリにプッシュアクセス #### 個々のコミットに関するチェックのスキップとリクエスト -リポジトリがプッシュに対して自動的にチェックをリクエストするように設定されている場合、プッシュする個々のコミットについてチェックをスキップできます。 リポジトリがプッシュに対して自動的にチェックをリクエストするよう設定されて_いない_場合、プッシュする個々のコミットについてチェックをリクエストできます。 これらの設定についての詳しい情報は、「[チェックスイート](/v3/checks/suites/#set-preferences-for-check-suites-on-a-repository)」を参照してください。 +リポジトリがプッシュに対して自動的にチェックをリクエストするように設定されている場合、プッシュする個々のコミットについてチェックをスキップできます。 リポジトリがプッシュに対して自動的にチェックをリクエストするよう設定されて_いない_場合、プッシュする個々のコミットについてチェックをリクエストできます。 これらの設定についての詳しい情報は、「[チェックスイート](/rest/reference/checks#update-repository-preferences-for-check-suites)」を参照してください。 コミットに対するチェックをスキップもしくはリクエストするには、以下の追加行のいずれかをコミットメッセージの末尾に追加します: diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/addressing-merge-conflicts.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/addressing-merge-conflicts.md index f70ddb01d3e3..a4d29154639b 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/addressing-merge-conflicts.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/addressing-merge-conflicts.md @@ -1,6 +1,6 @@ --- title: マージコンフリクトへの対処 -intro: あなたの変更とベースブランチとの間にマージコンフリクトが発生している場合、プルリクエストの変更をマージする前にマージコンフリクトに対処しなければなりません。 +intro: 'あなたの変更とベースブランチとの間にマージコンフリクトが発生している場合、プルリクエストの変更をマージする前にマージコンフリクトに対処しなければなりません。' mapTopic: true redirect_from: - /articles/addressing-merge-conflicts diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/allowing-changes-to-a-pull-request-branch-created-from-a-fork.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/allowing-changes-to-a-pull-request-branch-created-from-a-fork.md index 1f376bd82d11..43fc3f5fad20 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/allowing-changes-to-a-pull-request-branch-created-from-a-fork.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/allowing-changes-to-a-pull-request-branch-created-from-a-fork.md @@ -1,6 +1,6 @@ --- title: フォークから作成されたプルリクエストブランチへの変更を許可する -intro: コラボレーションを強化するために、ユーザアカウントが所有するフォークから作成したブランチでのコミットを許可します。 +intro: 'コラボレーションを強化するために、ユーザアカウントが所有するフォークから作成したブランチでのコミットを許可します。' redirect_from: - /articles/allowing-changes-to-a-pull-request-branch-created-from-a-fork permissions: ユーザアカウントが所有するフォークの上流リポジトリへのプッシュアクセスを持つ人は、フォークされたブランチにコミットできます。 diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/approving-a-pull-request-with-required-reviews.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/approving-a-pull-request-with-required-reviews.md index 0271ba074dd0..6b99850fb5cf 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/approving-a-pull-request-with-required-reviews.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/approving-a-pull-request-with-required-reviews.md @@ -1,6 +1,6 @@ --- title: 必須レビューでのプルリクエストの承認 -intro: リポジトリでレビューが必須になっているなら、プルリクエストがマージできるようになるためには、リポジトリに _書き込み_ あるいは _管理_ 権限を持つ人からの承認レビューが指定された数だけ必要です。 +intro: 'リポジトリでレビューが必須になっているなら、プルリクエストがマージできるようになるためには、リポジトリに _書き込み_ あるいは _管理_ 権限を持つ人からの承認レビューが指定された数だけ必要です。' redirect_from: - /articles/approving-a-pull-request-with-required-reviews versions: diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/changing-the-base-branch-of-a-pull-request.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/changing-the-base-branch-of-a-pull-request.md index a921c3d9641a..14a7f4cb9db8 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/changing-the-base-branch-of-a-pull-request.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/changing-the-base-branch-of-a-pull-request.md @@ -1,6 +1,6 @@ --- title: プルリクエストのベースブランチを変更する -intro: プルリクエストがオープンされた後は、ベースブランチを変更し、プルリクエストの変更を他のブランチと比較できます。 +intro: 'プルリクエストがオープンされた後は、ベースブランチを変更し、プルリクエストの変更を他のブランチと比較できます。' redirect_from: - /articles/changing-the-base-branch-of-a-pull-request versions: diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/changing-the-stage-of-a-pull-request.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/changing-the-stage-of-a-pull-request.md index cb932c689312..7516bdd48b42 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/changing-the-stage-of-a-pull-request.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/changing-the-stage-of-a-pull-request.md @@ -1,6 +1,6 @@ --- title: プルリクエストのステージの変更 -intro: 'プルリクエストのドラフトをレビュー準備完了としてマークしたり{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}、プルリクエストをドラフトに変換したりすることができます{% endif %}。' +intro: 'You can mark a draft pull request as ready for review{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} or convert a pull request to a draft{% endif %}.' permissions: リポジトリへの書き込み権限を持つユーザとプルリクエストの作者は、プルリクエストのステージを変更できます。 product: '{% data reusables.gated-features.draft-prs %}' redirect_from: diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally.md index 58d362d21979..638a7a3ccb53 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally.md @@ -18,7 +18,7 @@ versions: ### アクティブなプルリクエストをローカルで修正する {% data reusables.repositories.sidebar-pr %} -2. プルリクエストのリストで、変更するプルリクエストをクリックします。{% if currentVersion == "free-pro-team@latest" %} +2. In the list of pull requests, click the pull request you'd like to modify.{% if currentVersion == "free-pro-team@latest" %} 3. プルリクエストをオープンする場所を選択するには、[**Open with {% octicon "triangle-down" aria-label="The down triangle icon" %}**] ドロップダウンを選択して、いずれかのタブをクリックします。 ![Link to access command line pull request instructions](/assets/images/help/pull_requests/open-with-button.png){% else %} 3. マージボックスで、[**command line instructions**] をクリックします。 手順に従い、提案されたプルリクエストをローカルにダウンロードしてください。 ![コマンドラインのプルリクエスト手順へのリンク](/assets/images/help/pull_requests/pull_request_show_command_line_merge.png) 4. オプションで、提案された変更を {% data variables.product.prodname_desktop %} で表示するには、[**open this in {% data variables.product.prodname_desktop %}**] をクリックします。 ![Link to open a pull request locally in Desktop](/assets/images/help/desktop/open-pr-in-desktop.png){% endif %} diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/collaborating-on-repositories-with-code-quality-features.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/collaborating-on-repositories-with-code-quality-features.md index e849bd74d449..95ca378e1e12 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/collaborating-on-repositories-with-code-quality-features.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/collaborating-on-repositories-with-code-quality-features.md @@ -1,6 +1,6 @@ --- -title: コード品質保証機能を使ってリポジトリでコラボレーションする -intro: 'ステータス、{% if currentVersion != "free-pro-team@latest" %}pre-receive フック、{% endif %}保護されたブランチ、必須ステータスチェックなどの、ワークフローの品質保証機能は、コラボレーターが Organization やリポジトリの管理者が設定した条件に合うようにコントリビューションを行うために役立ちます。' +title: Collaborating on repositories with code quality features +intro: 'Workflow quality features like statuses, {% if currentVersion != "free-pro-team@latest" %}pre-receive hooks, {% endif %}protected branches, and required status checks help collaborators make contributions that meet conditions set by organization and repository administrators.' mapTopic: true redirect_from: - /articles/collaborating-on-repositories-with-code-quality-features-enabled/ diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request.md index 9cc336a78eb9..2350ab6611ca 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request.md @@ -5,7 +5,7 @@ redirect_from: - /articles/commenting-on-the-diff-of-a-pull-request/ - /articles/commenting-on-differences-between-files/ - /articles/commenting-on-a-pull-request -intro: リポジトリのプルリクエストのオープン後、コラボレーターや Team メンバーは、特定の 2 つのブランチ間におけるファイルの比較について、またプロジェクト全体についてコメントできます。 +intro: 'リポジトリのプルリクエストのオープン後、コラボレーターや Team メンバーは、特定の 2 つのブランチ間におけるファイルの比較について、またプロジェクト全体についてコメントできます。' versions: free-pro-team: '*' enterprise-server: '*' @@ -54,5 +54,5 @@ Pull Request レビューへの行コメント追加に関する 詳しい情報 ### 参考リンク - 「[コードスニペットへのパーマリンクを作成する](/articles/creating-a-permanent-link-to-a-code-snippet/)」 -{% if currentVersion == "free-pro-team@latest" %}- 「[乱用やスパムをレポートする](/articles/reporting-abuse-or-spam)」 +{% if currentVersion == "free-pro-team@latest" %}- "[Reporting abuse or spam](/articles/reporting-abuse-or-spam)" {% endif %} diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md index 2a8bcfd837c5..f2f1428088e5 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md @@ -22,7 +22,9 @@ versions: {% endnote %} -1. {% data variables.product.product_name %}で、プルリクエストのブランチを作成したフォーク (またはリポジトリのコピー) のメインページに移動します。 +1. On + +{% data variables.product.product_name %}, navigate to the main page of the fork (or copy of your repository) where the pull request branch was created. {% data reusables.repositories.copy-clone-url %} {% data reusables.command_line.open_the_multi_os_terminal %} {% tip %} diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md index d12c4242d2df..fa9ae7ce165e 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md @@ -18,7 +18,7 @@ versions: ### ブランチの範囲と宛先リポジトリの変更 -デフォルトでは、プルリクエストは親リポジトリの[デフォルトブランチ](/articles/setting-the-default-branch)に基づいています。 +デフォルトでは、プルリクエストは親リポジトリの[デフォルトブランチ](/articles/setting-the-default-branch)に基づいています。 詳細は「[ブランチについて](/github/collaborating-with-issues-and-pull-requests/about-branches#about-the-default-branch)」を参照してください。 デフォルトの親リポジトリが正しくない場合、親リポジトリとブランチをどちらもドロップダウンリストで変更できます。 また、基準点間の差分を確認するために、ドロップダウンリストで head ブランチと base ブランチを入れ替えることもできます。 ここで言う基準は GitHub リポジトリにあるブランチ名でなければなりません。 diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md index d51cc8f25f4c..206fcc46632e 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md @@ -21,7 +21,7 @@ versions: {% data reusables.pull_requests.automatically-delete-branches %} -If the branch you want to delete is the repository's default branch, you must choose a new default branch before deleting the branch. For more information, see "[Setting the default branch](/github/administering-a-repository/setting-the-default-branch)." +If the branch you want to delete is the repository's default branch, you must choose a new default branch before deleting the branch. For more information, see "[Changing the default branch](/github/administering-a-repository/changing-the-default-branch)." If the branch you want to delete is associated with an open pull request, you must merge or close the pull request before deleting the branch. For more information, see "[Merging a pull request](/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request)" or "[Closing a pull request](/github/collaborating-with-issues-and-pull-requests/closing-a-pull-request)." diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md index a07dd548b19e..2684180a4a9f 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md @@ -14,14 +14,10 @@ versions: {% data reusables.search.requested_reviews_search %} {% data reusables.repositories.sidebar-pr %} -{% data reusables.repositories.choose-pr-review %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} +{% data reusables.repositories.choose-pr-review %} 3. [Conversation] タブで却下したいレビューまでスクロールして、[{% octicon "chevron-down" aria-label="The down button" %}] をクリックします。 ![マージボックス中の V 字型アイコン](/assets/images/help/pull_requests/merge_box/pull-request-open-menu.png) 4. {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} をクリックし、続いて [**Dismiss review**] をクリックします。 ![マージボックス中のケバブアイコン](/assets/images/help/pull_requests/merge_box/pull-request-dismiss-review.png) 5. レビューの却下理由を入力して、[**Dismiss review**] をクリックします。 ![[Dismiss review] ボタン](/assets/images/help/pull_requests/merge_box/pull-request-dismiss-review-button.png) -{% else %} -3. [Conversation] タブで任意のレビューまでスクロールして、[**Dismiss review**] をクリックします。 ![レビューを却下するオプション](/assets/images/help/pull_requests/merge_box/pull-request-dismiss-review.png) -4. レビューの却下理由を入力して、[**Dismiss review**] をクリックします。 ![[Dismiss review] ボタン](/assets/images/help/pull_requests/merge_box/pull-request-dismiss-review-button.png) -{% endif %} ### 参考リンク diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md index 331ebd715aaf..78abd96f1215 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md @@ -1,6 +1,6 @@ --- title: プルリクエスト内のファイルをフィルタリングする -intro: 巨大なプルリクエスト内の変更を素早く確認できるように、変更されたファイルをフィルタリングできます。 +intro: '巨大なプルリクエスト内の変更を素早く確認できるように、変更されたファイルをフィルタリングできます。' redirect_from: - /articles/filtering-files-in-a-pull-request-by-file-type/ - /articles/filtering-files-in-a-pull-request @@ -9,11 +9,11 @@ versions: enterprise-server: '*' --- -プルリクエスト内のファイルは、`.html` や `.js` などの拡張子、拡張子なし、{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}コード所有権、{% endif %}またはドットファイルかどうかなどでフィルタリングできます。 +You can filter files in a pull request by file extension type, such as `.html` or `.js`, lack of an extension, code ownership, or dotfiles. {% tip %} -**ヒント:** ファイルのフィルタドロップダウンメニューから、プルリクエストの diff 内の削除されたファイル{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}か、既に表示したファイル{% endif %}を一時的に非表示にして、プルリクエストの diff 表示を簡素化できます。 +**Tip:** To simplify your pull request diff view, you can also temporarily hide deleted files or files you have already viewed in the pull request diff from the file filter drop-down menu. {% endtip %} diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/github-flow.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/github-flow.md index ac2b344d7554..342e809b3153 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/github-flow.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/github-flow.md @@ -1,6 +1,6 @@ --- title: GitHub のフロー -intro: GitHub では、私たちの製品を毎日使っており、プロジェクトでコラボレーションするためのワークフローを開発しています。 Team の規模や技術的な専門知識の深さにかかわらず使えるように、弊社はワークフローの各手順が Web ベースのインターフェイスで完結できるようにしました。 +intro: 'GitHub では、私たちの製品を毎日使っており、プロジェクトでコラボレーションするためのワークフローを開発しています。 Team の規模や技術的な専門知識の深さにかかわらず使えるように、弊社はワークフローの各手順が Web ベースのインターフェイスで完結できるようにしました。' redirect_from: - /articles/creating-and-editing-files-in-your-repository/ - /articles/github-flow-in-the-browser/ diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request.md index 2f56e02a84ca..b56507420b70 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request.md @@ -1,6 +1,6 @@ --- title: プルリクエストでのフィードバックを取り込む -intro: レビュー担当者がプルリクエストの変更を提案する場合、変更をプルリクエストに自動的に組み込むか、Issue をオープンしてスコープ外の提案を追跡できます。 +intro: 'レビュー担当者がプルリクエストの変更を提案する場合、変更をプルリクエストに自動的に組み込むか、Issue をオープンしてスコープ外の提案を追跡できます。' redirect_from: - /articles/incorporating-feedback-in-your-pull-request versions: diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md index e76223927961..b37ca64e22f1 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md @@ -45,13 +45,13 @@ You can't merge a draft pull request. ドラフトのプルリクエストに関 6. [**Confirm merge**]、[**Confirm squash and merge**] をクリックするか、[**Confirm rebase and merge**] をクリックします。 6. また、代わりに[ブランチを削除](/articles/deleting-unused-branches)することもできます。 こうすることで、リポジトリにあるブランチのリストが整理された状態を保てます。 - {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}リポジトリは、プルリクエストをマージするとプルリクエストの head ブランチが自動的に削除されるように設定できます。 詳しい情報については「[ブランチの自動削除の管理](/github/administering-a-repository/managing-the-automatic-deletion-of-branches)」を参照してください。{% endif %} +The repository may be configured so that the head branch for a pull request is automatically deleted when you merge a pull request. 詳しい情報については「[ブランチの自動削除の管理](/github/administering-a-repository/managing-the-automatic-deletion-of-branches)」を参照してください。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} {% note %} - **注釈:** {% data reusables.pull_requests.retargeted-on-branch-deletion %} -詳しい情報については、「[ブランチについて](/github/collaborating-with-issues-and-pull-requests/about-branches#working-with-branches)」を参照してください。 + **Note:** {% data reusables.pull_requests.retargeted-on-branch-deletion %} + For more information, see "[About branches](/github/collaborating-with-issues-and-pull-requests/about-branches#working-with-branches)." {% endnote %} {% endif %} diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md index 523538997aa3..d6139c89fd0f 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md @@ -1,6 +1,6 @@ --- title: 上流リポジトリをフォークにマージする -intro: 上流リポジトリに対するプッシュ (書き込み) アクセスがない場合でも、そのリポジトリから自分のフォークにコミットをプルできます。 +intro: '上流リポジトリに対するプッシュ (書き込み) アクセスがない場合でも、そのリポジトリから自分のフォークにコミットをプルできます。' redirect_from: - /articles/merging-an-upstream-repository-into-your-fork versions: diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/proposing-changes-to-your-work-with-pull-requests.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/proposing-changes-to-your-work-with-pull-requests.md index 2e1b8254c0b7..3cdf1adf8c7d 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/proposing-changes-to-your-work-with-pull-requests.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/proposing-changes-to-your-work-with-pull-requests.md @@ -1,6 +1,6 @@ --- title: プルリクエストで、作業に対する変更を提案する -intro: トピックブランチまたはフォークに変更を加えた後で、それらをプロジェクトにマージする前に、プルリクエストをオープンしてコラボレーターまたはリポジトリ管理者に変更のレビューを依頼することができます。 +intro: 'トピックブランチまたはフォークに変更を加えた後で、それらをプロジェクトにマージする前に、プルリクエストをオープンしてコラボレーターまたはリポジトリ管理者に変更のレビューを依頼することができます。' mapTopic: true redirect_from: - /articles/proposing-changes-to-your-work-with-pull-requests diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/requesting-a-pull-request-review.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/requesting-a-pull-request-review.md index 9e9b99ef8c33..c5208339e544 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/requesting-a-pull-request-review.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/requesting-a-pull-request-review.md @@ -1,6 +1,6 @@ --- title: Pull Request レビューをリクエストする -intro: Pull Request を作成したら、提案した変更を特定の人にレビューするように依頼できます。 あなたが Organization のメンバーである場合、特定の Team に変更をレビューするようリクエストすることもできます。 +intro: 'Pull Request を作成したら、提案した変更を特定の人にレビューするように依頼できます。 あなたが Organization のメンバーである場合、特定の Team に変更をレビューするようリクエストすることもできます。' redirect_from: - /articles/requesting-a-pull-request-review versions: @@ -10,7 +10,7 @@ versions: ユーザアカウントが所有しているリポジトリのオーナーとコラボレータは、プルリクエストのレビューを割り当てることができます。 リポジトリに対するトリアージ権限を持つ Organization メンバーは、プルリクエストのレビューを割り当てることができます。 -オーナーまたはコラボレータは、ユーザ所有のリポジトリに明示的に[読み取りアクセス](/articles/access-permissions-on-github)を付与された人にプルリクエストのレビューを割り当てることができます。 Organization メンバーは、リポジトリの読み取りアクセス権を持つ人や Team にプルリクエストのレビューを割り当てることができます。 リクエストされたレビュー担当者または Team は、Pull Request レビューをするようあなたが依頼したという通知を受け取ります。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}Team にレビューをリクエストし、コードレビューの割り当てが有効になっている場合、特定のメンバーがリクエストされ、Team はレビュー担当者として削除されます。 詳しい情報については、「[Team のコードレビューの割り当てを管理する](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)」を参照してください。{% endif %} +オーナーまたはコラボレータは、ユーザ所有のリポジトリに明示的に[読み取りアクセス](/articles/access-permissions-on-github)を付与された人にプルリクエストのレビューを割り当てることができます。 Organization メンバーは、リポジトリの読み取りアクセス権を持つ人や Team にプルリクエストのレビューを割り当てることができます。 リクエストされたレビュー担当者または Team は、Pull Request レビューをするようあなたが依頼したという通知を受け取ります。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}If you request a review from a team and code review assignment is enabled, specific members will be requested and the team will be removed as a reviewer. 詳しい情報については、「[Team のコードレビューの割り当てを管理する](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)」を参照してください。{% endif %} {% note %} diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md index 6d3f2dad1daa..1b9ed3f8d809 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md @@ -1,6 +1,6 @@ --- -title: GitHub でのマージ コンフリクトを解決する -intro: コンフリクト エディターを使用すれば、GitHub で行の変更が競合している単純なマージ コンフリクトを解決できます。 +title: Resolving a merge conflict on GitHub +intro: 'You can resolve simple merge conflicts that involve competing line changes on GitHub, using the conflict editor.' redirect_from: - /articles/resolving-a-merge-conflict-on-github versions: @@ -8,50 +8,56 @@ versions: enterprise-server: '*' --- -{% data variables.product.product_name %}で解決できるマージコンフリクトは、Git リポジトリの別々のブランチで、同じファイルの同じ行に異なる変更がなされた場合など、互いに矛盾する行変更を原因とするもののみです。 その他すべての種類のマージ コンフリクトについては、コマンド ラインでコンフリクトをローカルに解決する必要があります。 詳細は「[コマンド ラインを使用してマージコンフリクトを解決する](/articles/resolving-a-merge-conflict-using-the-command-line)」を参照してください。 +You can only resolve merge conflicts on {% data variables.product.product_name %} that are caused by competing line changes, such as when people make different changes to the same line of the same file on different branches in your Git repository. For all other types of merge conflicts, you must resolve the conflict locally on the command line. For more information, see "[Resolving a merge conflict using the command line](/articles/resolving-a-merge-conflict-using-the-command-line/)." {% if currentVersion != "free-pro-team@latest" %} -サイトの管理者がリポジトリ間の Pull Request に対してマージ コンフリクト エディターを無効にしている場合、{% data variables.product.product_name %} ではコンフリクト エディターを使用できず、コマンドラインでマージ コンフリクトを解決する必要があります。 たとえば、マージ コンフリクト エディターが無効な場合、フォークと上流リポジトリの間の Pull Request ではそれを使用できません。 +If a site administrator disables the merge conflict editor for pull requests between repositories, you cannot use the conflict editor on {% data variables.product.product_name %} and must resolve merge conflicts on the command line. For example, if the merge conflict editor is disabled, you cannot use it on a pull request between a fork and upstream repository. {% endif %} {% warning %} {% if currentVersion ver_lt "enterprise-server@2.22" %} -**Warning:** When you resolve a merge conflict on {% data variables.product.product_name %}, the entire [base branch](/github/getting-started-with-github/github-glossary#base-branch) of your pull request is merged into the [head branch](/github/getting-started-with-github/github-glossary#head-branch), even if the head branch is the default branch of your repository or a protected branch. このブランチにコミットすることが間違いでないことを確認してください。 +**Warning:** When you resolve a merge conflict on {% data variables.product.product_name %}, the entire [base branch](/github/getting-started-with-github/github-glossary#base-branch) of your pull request is merged into the [head branch](/github/getting-started-with-github/github-glossary#head-branch), even if the head branch is the default branch of your repository or a protected branch. Make sure you really want to commit to this branch. {% else %} -**警告:** {% data variables.product.product_name %} でマージコンフリクトを解決すると、プルリクエストの[ベースブランチ](/github/getting-started-with-github/github-glossary#base-branch)全体が [head ブランチ](/github/getting-started-with-github/github-glossary#head-branch)にマージされます このブランチにコミットすることが間違いでないことを確認してください。 If the head branch is the default branch of your repository, you'll be given the option of creating a new branch to serve as the head branch for your pull request. head ブランチが保護されている場合、コンフリクトの解決をマージすることができないため、新しい head ブランチを作成するように求められます。 詳しい情報については[保護されたブランチについて](/github/administering-a-repository/about-protected-branches)を参照してください。 +**Warning:** When you resolve a merge conflict on {% data variables.product.product_name %}, the entire [base branch](/github/getting-started-with-github/github-glossary#base-branch) of your pull request is merged into the [head branch](/github/getting-started-with-github/github-glossary#head-branch). Make sure you really want to commit to this branch. If the head branch is the default branch of your repository, you'll be given the option of creating a new branch to serve as the head branch for your pull request. If the head branch is protected you won't be able to merge your conflict resolution into it, so you'll be prompted to create a new head branch. For more information, see "[About protected branches](/github/administering-a-repository/about-protected-branches)." {% endif %} {% endwarning %} {% data reusables.repositories.sidebar-pr %} -1. [Pull Requests] リストで、解決するマージ コンフリクトを起こしている Pull Request をクリックします。 -1. 指定した Pull Request の下部周辺で、[**Resolve conflicts**] をクリックします。 ![[Resolve merge conflicts] ボタン](/assets/images/help/pull_requests/resolve-merge-conflicts-button.png) +1. In the "Pull Requests" list, click the pull request with a merge conflict that you'd like to resolve. +1. Near the bottom of your pull request, click **Resolve conflicts**. +![Resolve merge conflicts button](/assets/images/help/pull_requests/resolve-merge-conflicts-button.png) {% tip %} - **ヒント:** [**Resolve conflicts**] ボタンが作動しない場合、指定した Pull Request のマージ コンフリクトは {% data variables.product.product_name %} で解決するには複雑すぎ{% if currentVersion != "free-pro-team@latest" %} るか、サイトの管理者がリポジトリ間の Pull Request に対してコンフリクト エディターを無効にしてい{% endif %}ます。 別の Git クライアントを使用するか、コマンドラインで Git を使用して、マージのコンフリクトを解決する必要があります。 詳細は「[コマンド ラインを使用してマージコンフリクトを解決する](/articles/resolving-a-merge-conflict-using-the-command-line)」を参照してください。 + **Tip:** If the **Resolve conflicts** button is deactivated, your pull request's merge conflict is too complex to resolve on {% data variables.product.product_name %}{% if currentVersion != "free-pro-team@latest" %} or the site administrator has disabled the conflict editor for pull requests between repositories{% endif %}. You must resolve the merge conflict using an alternative Git client, or by using Git on the command line. For more information see "[Resolving a merge conflict using the command line](/articles/resolving-a-merge-conflict-using-the-command-line)." {% endtip %} {% data reusables.pull_requests.decide-how-to-resolve-competing-line-change-merge-conflict %} - ![コンフリクトマーカー付きのマージコンフリクトの例を表示する](/assets/images/help/pull_requests/view-merge-conflict-with-markers.png) -1. ファイルに複数のマージ コンフリクトがある場合は、次の一連のコンフリクト マーカーまで下にスクロールし、ステップ 4 と 5 を繰り返してマージ コンフリクトを解決します。 -1. ファイル内のコンフリクトをすべて解決したら、[**Mark as resolved**] をクリックします。 ![[Mark as resolved] ボタンをクリックする](/assets/images/help/pull_requests/mark-as-resolved-button.png) -1. コンフリクトしているファイルが複数ある場合は、[conflicting files] の下のページの左側で編集する次のファイルを選択し、Pull Request のマージ コンフリクトをすべて解決するまでステップ 4 から 7 を繰り返します。 ![コンフリクトしている次のファイルを選択する（該当する場合）](/assets/images/help/pull_requests/resolve-merge-conflict-select-conflicting-file.png) -1. マージ コンフリクトをすべて解決したら、[**Commit merge**] をクリックします。 これにより、Base ブランチ全体が Head ブランチにマージされます。 ![Resolve merge conflicts button](/assets/images/help/pull_requests/merge-conflict-commit-changes.png){% if currentVersion ver_lt "enterprise-server@2.22" %} -1. プロンプトに従い、コミット先のブランチをレビューします。 このブランチにコミットする場合は [**I understand, update _BRANCH_**] をクリックします。 ![マージコンフリクト確認ウィンドウ](/assets/images/help/pull_requests/merge-conflict-confirmation.png){% else %} -1. プロンプトに従い、コミット先のブランチをレビューします。 - - head ブランチがリポジトリのデフォルトブランチである場合、コンフリクトを解決するために加えた変更でこのブランチを更新するか、新しいブランチを作成してこれをプルリクエストのヘッドブランチとして使用するかを選択できます。 ![更新するブランチの確認を求める](/assets/images/help/pull_requests/conflict-resolution-merge-dialog-box.png) - - 新しいブランチを作成する場合は、ブランチの名前を入力します。 - - プルリクエストの head ブランチが保護されている場合は、新しいブランチを作成する必要があります。 保護されたブランチを更新するオプションはありません。 - - [**Create branch and update my pull request**] または [**I understand, continue updating _BRANCH_**] をクリックします。 ボタンテキストは、実行中のアクションに対応しています。 + ![View merge conflict example with conflict markers](/assets/images/help/pull_requests/view-merge-conflict-with-markers.png) +1. If you have more than one merge conflict in your file, scroll down to the next set of conflict markers and repeat steps four and five to resolve your merge conflict. +1. Once you've resolved all the conflicts in the file, click **Mark as resolved**. + ![Click mark as resolved button](/assets/images/help/pull_requests/mark-as-resolved-button.png) +1. If you have more than one file with a conflict, select the next file you want to edit on the left side of the page under "conflicting files" and repeat steps four through seven until you've resolved all of your pull request's merge conflicts. + ![Select next conflicting file if applicable](/assets/images/help/pull_requests/resolve-merge-conflict-select-conflicting-file.png) +1. Once you've resolved all your merge conflicts, click **Commit merge**. This merges the entire base branch into your head branch. + ![Resolve merge conflicts button](/assets/images/help/pull_requests/merge-conflict-commit-changes.png){% if currentVersion ver_lt "enterprise-server@2.22" %} +1. If prompted, review the branch that you are committing to. If you want to commit to this branch, click **I understand, update _BRANCH_**. +![Merge conflict confirmation window](/assets/images/help/pull_requests/merge-conflict-confirmation.png){% else %} +1. If prompted, review the branch that you are committing to. + + If the head branch is the default branch of the repository, you can choose either to update this branch with the changes you made to resolve the conflict, or to create a new branch and use this as the head branch of the pull request. + ![Prompt to review the branch that will be updated](/assets/images/help/pull_requests/conflict-resolution-merge-dialog-box.png) + + If you choose to create a new branch, enter a name for the branch. + + If the head branch of your pull request is protected you must create a new branch. You won't get the option to update the protected branch. + + Click **Create branch and update my pull request** or **I understand, continue updating _BRANCH_**. The button text corresponds to the action you are performing. {% endif %} -1. Pull Request をマージするには、[**Merge pull request**] をクリックします。 Pull Request のマージ オプションの詳細については、「 [Pull Request をマージする](/articles/merging-a-pull-request/)」を参照してください。 +1. To merge your pull request, click **Merge pull request**. For more information about other pull request merge options, see "[Merging a pull request](/articles/merging-a-pull-request/)." -### 参考リンク +### Further reading -- [プルリクエストのマージについて](/articles/about-pull-request-merges) +- "[About pull request merges](/articles/about-pull-request-merges)" diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-using-the-command-line.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-using-the-command-line.md index 19c325d8520d..c002202eaa36 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-using-the-command-line.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-using-the-command-line.md @@ -83,8 +83,8 @@ ask your question in IRC. 2. マージ コンフリクトの影響を受けるファイルのリストを生成します。 この例では、ファイル *README.md* にマージコンフリクトが発生しています。 ```shell $ git status - > # On branch master - > # Your branch and 'origin/master' have diverged, + > # On branch main + > # Your branch and 'origin/main' have diverged, > # and have 1 and 2 different commits each, respectively. > # (use "git pull" to merge the remote branch into yours) > # You have unmerged paths. diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/reviewing-changes-in-pull-requests.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/reviewing-changes-in-pull-requests.md index aae72d834d84..e01cb6329c23 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/reviewing-changes-in-pull-requests.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/reviewing-changes-in-pull-requests.md @@ -3,7 +3,7 @@ title: Pull Request での変更をレビューする redirect_from: - /articles/reviewing-and-discussing-changes-in-pull-requests/ - /articles/reviewing-changes-in-pull-requests -intro: Pull Request が公開された後に、提案された一連の変更をレビューしたり議論したりできます。 +intro: 'Pull Request が公開された後に、提案された一連の変更をレビューしたり議論したりできます。' mapTopic: true versions: free-pro-team: '*' diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md index a36cbb2fa54c..d5a652c62956 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md @@ -1,6 +1,6 @@ --- title: プルリクエストで提案された変更をレビューする -intro: Pull Request では、コミット、変更されたファイル、ベース ブランチと比較ブランチでのファイル間の違い (つまり "diff") をレビューしたり議論したりできます。 +intro: 'Pull Request では、コミット、変更されたファイル、ベース ブランチと比較ブランチでのファイル間の違い (つまり "diff") をレビューしたり議論したりできます。' redirect_from: - /articles/reviewing-proposed-changes-in-a-pull-request versions: @@ -10,7 +10,7 @@ versions: ### プルリクエストのレビューについて -プルリクエストの変更は、1 ファイルごとにレビューできます。 プルリクエストのファイルをレビューしている際に、特定の変更についてコメントを残すことができます。{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}各ファイルのレビューを完了後、ファイルをレビュー済みとしてマーク付けできます。 これによりファイルが折りたたまれるので、まだレビューを必要とするファイルを特定するのに役立ちます。 プルリクエストのヘッダにあるプログレスバーは、レビュー済みファイルの数を示します。{% endif %}任意の数のファイルをレビュー後、プルリクエストを承認するか、レビューに要約コメントを付けてサブミットし、さらなる変更をリクエストできます。 +プルリクエストの変更は、1 ファイルごとにレビューできます。 While reviewing the files in a pull request, you can leave individual comments on specific changes. After you finish reviewing each file, you can mark the file as viewed. これによりファイルが折りたたまれるので、まだレビューを必要とするファイルを特定するのに役立ちます。 A progress bar in the pull request header shows the number of files you've viewed. After reviewing as many files as you want, you can approve the pull request or request additional changes by submitting your review with a summary comment. {% data reusables.search.requested_reviews_search_tip %} @@ -28,14 +28,12 @@ versions: ![[Cancel review] ボタン](/assets/images/help/pull_requests/cancel-review-button.png) -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} ### ファイルをレビュー済みとしてマークする ファイルのレビュー後は、そのファイルをレビュー済みとしてマークできます。マークしたファイルは折りたたまれます。 ファイルを表示後に変更すると、レビュー済みマークが解除されます。 {% data reusables.repositories.changed-files %} 2. レビューを完了したファイルの、ヘッダの右側にある [**Viewed**] を選択します。 ![[Viewed] チェックボックス](/assets/images/help/pull_requests/viewed-checkbox.png) -{% endif %} ### レビューを提出する diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/working-with-pre-receive-hooks.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/working-with-pre-receive-hooks.md index 24ece42cb2cc..469a8e403894 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/working-with-pre-receive-hooks.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/working-with-pre-receive-hooks.md @@ -21,7 +21,7 @@ Total 3 (delta 0), reused 0 (delta 0) remote: always_reject.sh: failed with exit status 1 remote: error: rejecting all pushes To https://54.204.174.51/hodor/nope.git -! [remote rejected] master -> master (pre-receive hook declined) +! [remote rejected] main -> main (pre-receive hook declined) error: failed to push some refs to 'https://54.204.174.51/hodor/nope.git' ``` diff --git a/translations/ja-JP/content/github/committing-changes-to-your-project/changing-a-commit-message.md b/translations/ja-JP/content/github/committing-changes-to-your-project/changing-a-commit-message.md index a269de05b9ad..a0e31b2609df 100644 --- a/translations/ja-JP/content/github/committing-changes-to-your-project/changing-a-commit-message.md +++ b/translations/ja-JP/content/github/committing-changes-to-your-project/changing-a-commit-message.md @@ -13,13 +13,9 @@ versions: `git commit --amend` コマンドで、直近のコミットメッセージを変更できます。 -{% warning %} - Git では、コミットメッセージのテキストはコミットの一部として扱われます。 コミットメッセージを変更すると、コミット ID (コミットの SHA1 チェックサム) も変更されます。 実質的には、古いコミットに代わる新しいコミットを作成することになります。 -{% endwarning %} - -#### オンラインにプッシュされていないコミット +### オンラインにプッシュされていないコミット コミットがローカルリポジトリにのみ存在し、{% data variables.product.product_location %}にプッシュされていない場合、`git commit --amend` コマンドでコミットメッセージを修正できます。 @@ -39,7 +35,7 @@ Git で使うデフォルトのテキストエディタは、`core.editor` の {% endtip %} -#### 古いまたは複数のコミットメッセージの修正 +### 古いまたは複数のコミットメッセージの修正 すでにコミットを {% data variables.product.product_location %}にプッシュしている場合、修正済みのメッセージでコミットをフォースプッシュする必要があります。 @@ -49,7 +45,7 @@ Git で使うデフォルトのテキストエディタは、`core.editor` の {% endwarning %} -**直近にプッシュしたコミットのメッセージ修正** +**Changing the message of the most recently pushed commit** 1. [上記の手順](/articles/changing-a-commit-message#commit-has-not-been-pushed-online)に従って、コミットメッセージを修正します。 2. `push --force` コマンドにより、古いコミットをフォースプッシュで上書きします。 @@ -57,7 +53,7 @@ Git で使うデフォルトのテキストエディタは、`core.editor` の $ git push --force example-branch ``` -**古いまたは複数のコミットメッセージの修正** +**Changing the message of older or multiple commit messages** 複数のコミットまたは古いコミットの、メッセージを修正する必要がある場合は、インタラクティブなリベースを利用した後にフォースプッシュして、コミットの履歴を変更できます。 @@ -93,7 +89,6 @@ Git で使うデフォルトのテキストエディタは、`core.editor` の # # Note that empty commits are commented out ``` - 3. 変更する各コミットメッセージの前の `pick` を `reword` に置き換えます。 ```shell pick e499d89 Delete CNAME @@ -102,10 +97,10 @@ Git で使うデフォルトのテキストエディタは、`core.editor` の ``` 4. コミット一覧のファイルを保存して閉じます。 5. 生成された各コミットコミットファイルに、新しいコミットメッセージを入力し、ファイルを保存して閉じます。 -6. 修正したコミットをフォースプッシュします。 - ```shell - $ git push --force - ``` +6. When you're ready to push your changes to GitHub, use the push --force command to force push over the old commit. +```shell +$ git push --force example-branch +``` インタラクティブリベースに関する詳しい情報については、Git のマニュアルにある「[インタラクティブモード](https://git-scm.com/docs/git-rebase#_interactive_mode)」を参照してください。 diff --git a/translations/ja-JP/content/github/committing-changes-to-your-project/commit-branch-and-tag-labels.md b/translations/ja-JP/content/github/committing-changes-to-your-project/commit-branch-and-tag-labels.md index 595fc8d1bb71..9cd46f1ede1b 100644 --- a/translations/ja-JP/content/github/committing-changes-to-your-project/commit-branch-and-tag-labels.md +++ b/translations/ja-JP/content/github/committing-changes-to-your-project/commit-branch-and-tag-labels.md @@ -14,7 +14,7 @@ versions: コミットがデフォルトブランチにある場合は、そのコミットを含むタグがすべて表示され、ブランチのリストにはデフォルトブランチのみが表示されます。 -![Commit-master-label](/assets/images/help/commits/Commit-master-label.png) +![Commit-main-label](/assets/images/help/commits/Commit-master-label.png) ### 参考リンク diff --git a/translations/ja-JP/content/github/committing-changes-to-your-project/comparing-commits.md b/translations/ja-JP/content/github/committing-changes-to-your-project/comparing-commits.md index 6244f39fc32e..8d91219cd593 100644 --- a/translations/ja-JP/content/github/committing-changes-to-your-project/comparing-commits.md +++ b/translations/ja-JP/content/github/committing-changes-to-your-project/comparing-commits.md @@ -26,9 +26,9 @@ compare の最も一般的な使い方は、新しいプルリクエストを開 ### タグを比較する -リリースタグを比較すると、前回のリリース以降のリポジトリへの変更が表示されます。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} 詳しい情報については、「[リリースを比較する](/github/administering-a-repository/comparing-releases)」を参照してください。{% endif %} +リリースタグを比較すると、前回のリリース以降のリポジトリへの変更が表示されます。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} For more information, see "[Comparing releases](/github/administering-a-repository/comparing-releases)."{% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}タグを比較するには、ページ上部の `compare` ドロップダウンメニューからタグ名を選択できます。{% else %}ブランチ名を入力する代わりに、`compare` ドロップダウンメニューにタグの名前を入力します。{% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}To compare tags, you can select a tag name from the `compare` drop-down menu at the top of the page.{% else %} Instead of typing a branch name, type the name of your tag in the `compare` drop down menu.{% endif %} 2 つのタグ間を比較する例については、[こちらをクリック](https://github.com/octocat/linguist/compare/v2.2.0...octocat:v2.3.3)してください。 @@ -46,7 +46,7 @@ compare の最も一般的な使い方は、新しいプルリクエストを開 ベースリポジトリと、フォークした任意のリポジトリを比較できます。 これは、ユーザがプロジェクトにプルリクエストを実行したときに表示されるビューです。 -別のリポジトリにあるブランチを比較するには、ブランチの名前の前にユーザ名を付けてください。 たとえば、`base` に `octocat:master` を、`compare` に `octo-org:master` を指定することで、`octocat` と `octo-org` のそれぞれが所有するリポジトリの `master` ブランチを比較できます。 +別のリポジトリにあるブランチを比較するには、ブランチの名前の前にユーザ名を付けてください。 For example, by specifying `octocat:main` for `base` and `octo-org:main` for `compare`, you can compare the `main` branch of the repositories respectively owned by `octocat` and `octo-org`. 2 つのリポジトリ間を比較した例については、[こちらをクリック](https://github.com/octocat/linguist/compare/master...octo-org:master)してください。 diff --git a/translations/ja-JP/content/github/committing-changes-to-your-project/creating-a-commit-with-multiple-authors.md b/translations/ja-JP/content/github/committing-changes-to-your-project/creating-a-commit-with-multiple-authors.md index 24062e8c68c4..079e81663f51 100644 --- a/translations/ja-JP/content/github/committing-changes-to-your-project/creating-a-commit-with-multiple-authors.md +++ b/translations/ja-JP/content/github/committing-changes-to-your-project/creating-a-commit-with-multiple-authors.md @@ -1,6 +1,6 @@ --- -title: 複数の作者を持つコミットを作成する -intro: 'コミットのメッセージに、1 つ以上の "Co-authored-by" トレーラーを追加することで、1 つのコミットに複数の作者を追加できます。 共作されたコミットは {% data variables.product.product_name %}{% if currentVersion != "free-pro-team@latest" %} で表示され、プロフィールコントリビューショングラフとリポジトリの統計に含めることができます。{% endif %}' +title: Creating a commit with multiple authors +intro: 'You can attribute a commit to more than one author by adding one or more `Co-authored-by` trailers to the commit''s message. Co-authored commits are visible on {% data variables.product.product_name %}{% if currentVersion != "free-pro-team@latest" %} and can be included in the profile contributions graph and the repository''s statistics{% endif %}.' redirect_from: - /articles/creating-a-commit-with-multiple-authors versions: @@ -8,41 +8,41 @@ versions: enterprise-server: '*' --- -### 必要な共作者情報 +### Required co-author information -コミットに共作者を追加する前に、各共作者に使う適切なメールアドレスを知っておく必要があります。 共作者のコミットがコントリビューションとしてカウントされるためには、{% data variables.product.product_name %} アカウントに関連付けられているメールアドレスを使う必要があります。 +Before you can add a co-author to a commit, you must know the appropriate email to use for each co-author. For the co-author's commit to count as a contribution, you must use the email associated with their {% data variables.product.product_name %} account. {% if currentVersion == "free-pro-team@latest" %} -メールアドレスをプライベートにしておきたい人がいる場合、その人のプライバシーを保護するために、{% data variables.product.product_name %} が提供する `no-reply` メールを使わなければなりません。 そうしない場合、コミットメッセージで共作者のメールアドレスが公開されます。 自分のメールアドレスをプライベートにしておきたい場合、Git の操作のために {% data variables.product.product_name %} が提供する `no-reply` メールアドレスを使い、他の共作者に、`no-reply` メールアドレスをコミットのトレーラーに載せるよう依頼できます。 +If a person chooses to keep their email address private, you should use their {% data variables.product.product_name %}-provided `no-reply` email to protect their privacy. Otherwise, the co-author's email will be available to the public in the commit message. If you want to keep your email private, you can choose to use a {% data variables.product.product_name %}-provided `no-reply` email for Git operations and ask other co-authors to list your `no-reply` email in commit trailers. -詳細は「[コミットメールアドレスを設定する](/articles/setting-your-commit-email-address)」を参照してください。 +For more information, see "[Setting your commit email address](/articles/setting-your-commit-email-address)." {% tip %} - **ヒント:** 以下の情報を伝えることで、共作者が好みのメールアドレスを見つける手助けができます: - - {% data variables.product.product_name %} が提供する `no-reply` メールアドレスを表示するには、[Keep my email address private] のメールアドレス設定に移動します。 - - Git を設定するためのメールアドレスを手元のコンピュータで表示するには、コマンドラインで `git config user.email` を実行します。 + **Tip:** You can help a co-author find their preferred email address by sharing this information: + - To find your {% data variables.product.product_name %}-provided `no-reply` email, navigate to your email settings page under "Keep my email address private." + - To find the email you used to configure Git on your computer, run `git config user.email` on the command line. {% endtip %} {% endif %} -### {% data variables.product.prodname_desktop %} で co-authored コミットを作成する +### Creating co-authored commits using {% data variables.product.prodname_desktop %} -{% data variables.product.prodname_desktop %} で、共作者を持つコミットを作成できます。 詳細は「[コミットメッセージの入力と変更のプッシュ](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project#3-write-a-commit-message-and-push-your-changes)」および [{% data variables.product.prodname_desktop %}](https://desktop.github.com) を参照してください。 +You can use {% data variables.product.prodname_desktop %} to create a commit with a co-author. For more information, see "[Write a commit message and push your changes](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project#3-write-a-commit-message-and-push-your-changes)" and [{% data variables.product.prodname_desktop %}](https://desktop.github.com). -![コミットメッセージに共作者を追加](/assets/images/help/desktop/co-authors-demo-hq.gif) +![Add a co-author to the commit message](/assets/images/help/desktop/co-authors-demo-hq.gif) -### コマンドライン上で co-authored コミットを作成する +### Creating co-authored commits on the command line {% data reusables.pull_requests.collect-co-author-commit-git-config-info %} {% data reusables.pull_requests.commit-message-with-trailer-beginning %} -3. コミットメッセージの次の行に、各共作者の情報を `Co-authored-by: name ` という形式で入力します。 共同作者の情報の後に、閉じる引用符を追加します。 +3. On the next line of the commit message, type `Co-authored-by: name ` with specific information for each co-author. After the co-author information, add a closing quotation mark. - 複数の共作者を追加する場合は、共作者それぞれに 1 行をとり、`Co-authored-by:` コミットトレーラーを付けてください。 + If you're adding multiple co-authors, give each co-author their own line and `Co-authored-by:` commit trailer. ```shell $ git commit -m "Refactor usability tests. > @@ -51,26 +51,27 @@ versions: Co-authored-by: another-name <another-name@example.com>" ``` -次回のプッシュ時に、{% data variables.product.product_location %}に新たなコミットとメッセージが表示されます。 詳細は「[リモートリポジトリに変更をプッシュする](/articles/pushing-commits-to-a-remote-repository/)」を参照してください。 +The new commit and message will appear on {% data variables.product.product_location %} the next time you push. For more information, see "[Pushing changes to a remote repository](/articles/pushing-commits-to-a-remote-repository/)." -### {% data variables.product.product_name %} で co-authored コミットを作成する +### Creating co-authored commits on {% data variables.product.product_name %} -{% data variables.product.product_name %} のウェブエディタでファイルを変更してから、コミットのメッセージに `Co-authored-by:` トレーラーを追加することで、co-authored コミットを作成できます。 +After you've made changes in a file using the web editor on {% data variables.product.product_name %}, you can create a co-authored commit by adding a `Co-authored-by:` trailer to the commit's message. {% data reusables.pull_requests.collect-co-author-commit-git-config-info %} -2. 共同で変更を行った後は、ページの下部に、変更について説明する、短くて意味のあるコミットメッセージを入力します。 ![変更のコミットメッセージ](/assets/images/help/repository/write-commit-message-quick-pull.png) -3. コミットメッセージの下にあるテキストボックスに、各共同作者の情報を `Co-authored-by: name ` という形式で入力します。 複数の共作者を追加する場合は、共作者それぞれに 1 行をとり、`Co-authored-by:` コミットトレーラーを付けてください。 +2. After making your changes together, at the bottom of the page, type a short, meaningful commit message that describes the changes you made. + ![Commit message for your change](/assets/images/help/repository/write-commit-message-quick-pull.png) +3. In the text box below your commit message, add `Co-authored-by: name ` with specific information for each co-author. If you're adding multiple co-authors, give each co-author their own line and `Co-authored-by:` commit trailer. - ![2 つ目のコミットメッセージテキストボックスにある、コミットメッセージの共同作者トレーラー例](/assets/images/help/repository/write-commit-message-co-author-trailer.png) -4. [**Commit changes**] または [**Propose changes**] をクリックします。 + ![Commit message co-author trailer example in second commit message text box](/assets/images/help/repository/write-commit-message-co-author-trailer.png) +4. Click **Commit changes** or **Propose changes**. -{% data variables.product.product_location %} に新たなコミットとメッセージが表示されます。 +The new commit and message will appear on {% data variables.product.product_location %}. -### 参考リンク +### Further reading {% if currentVersion != "free-pro-team@latest" %} -- [プロフィール上でのコントリビューションの表示](/articles/viewing-contributions-on-your-profile) -- [プロフィール上でコントリビューションが表示されない理由](/articles/why-are-my-contributions-not-showing-up-on-my-profile){% endif %} -- [リポジトリアクティビティの概要を表示する](/articles/viewing-a-summary-of-repository-activity) -- [プロジェクトのコントリビューターを表示する](/articles/viewing-a-projects-contributors) -- [コミットメッセージの変更](/articles/changing-a-commit-message) -- {% data variables.product.prodname_desktop %} ドキュメンテーションの「[プロジェクトへの変更をコミットまたはレビューする](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project#3-write-a-commit-message-and-push-your-changes)」 +- "[Viewing contributions on your profile](/articles/viewing-contributions-on-your-profile)" +- "[Why are my contributions not showing up on my profile?](/articles/why-are-my-contributions-not-showing-up-on-my-profile)"{% endif %} +- "[Viewing a summary of repository activity](/articles/viewing-a-summary-of-repository-activity)" +- "[Viewing a project's contributors](/articles/viewing-a-projects-contributors)" +- "[Changing a commit message](/articles/changing-a-commit-message)" +- "[Committing and reviewing changes to your project](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project#3-write-a-commit-message-and-push-your-changes)" in the {% data variables.product.prodname_desktop %} documentation diff --git a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/about-archiving-repositories.md b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/about-archiving-repositories.md index e079f79bfa21..439b0c9019c4 100644 --- a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/about-archiving-repositories.md +++ b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/about-archiving-repositories.md @@ -1,6 +1,6 @@ --- title: リポジトリのアーカイブ処理について -intro: リポジトリをアーカイブするということは、そのプロジェクトがアクティブにメンテナンスされなくなるということを人々に伝えることになります。 +intro: 'リポジトリをアーカイブするということは、そのプロジェクトがアクティブにメンテナンスされなくなるということを人々に伝えることになります。' redirect_from: - /articles/about-archiving-repositories versions: @@ -20,7 +20,7 @@ versions: リポジトリがアーカイブされると、コラボレータや Team の追加や削除ができなくなります。 リポジトリへのアクセス権を持つコントリビューターは、プロジェクトをフォークするか Star を付けることだけができます。 -リポジトリがアーカイブされると、そのIssue、プルリクエスト、コード、ラベル、マイルストーン、プロジェクト、Wiki、リリース、コミット、タグ、ブランチ、リアクション、コメントはリードオンリーになります。 アーカイブされたリポジトリに変更を加えるには、まずそのリポジトリのアーカイブ解除をしなければなりません。 +When a repository is archived, its issues, pull requests, code, labels, milestones, projects, wiki, releases, commits, tags, branches, reactions, code scanning alerts, and comments become read-only. アーカイブされたリポジトリに変更を加えるには、まずそのリポジトリのアーカイブ解除をしなければなりません。 アーカイブされたリポジトリに対して検索ができます。 詳しい情報については[リポジトリの検索](/articles/searching-for-repositories/#search-based-on-whether-a-repository-is-archived)を参照してください。 詳しい情報については[リポジトリの検索](/articles/searching-for-repositories/#search-based-on-whether-a-repository-is-archived)を参照してください。 詳しい情報については[Issueやプルリクエストの検索](/articles/searching-issues-and-pull-requests/#search-based-on-whether-a-repository-is-archived)を参照してください。 diff --git a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md index 40feeaff9d26..608eefea9be1 100644 --- a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md +++ b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md @@ -20,7 +20,7 @@ versions: 管理者あるいはオーナー権限を持つ誰かがレビュー必須を有効化した場合、作者がリポジトリ中でプルリクエストをマージできるための条件としてコードオーナーからの承認を必須とすることもできます。 詳しい情報については、「[プルリクエストの必須レビューを有効にする](/github/administering-a-repository/enabling-required-reviews-for-pull-requests)」を参照してください。 -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}Team がコードレビューの割り当てを有効にしている場合、個々の承認は、保護されたブランチでのコードオーナーの承認要件を満たしません。 詳しい情報については、「[Team のコードレビューの割り当てを管理する](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)」を参照してください。{% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}If a team has enabled code review assignments, the individual approvals won't satisfy the requirement for code owner approval in a protected branch. 詳しい情報については、「[Team のコードレビューの割り当てを管理する](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)」を参照してください。{% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} ファイルにコードオーナーがいる場合、プルリクエストをオープンする前にコードオーナーを確認できます。 In the repository, you can browse to the file and hover over @@ -78,8 +78,9 @@ docs/* docs@example.com # appsディレクトリ内のすべてのファイルのオーナーになります。 apps/ @octocat -# この例では、@doctocatはリポジトリのルートにある`/docs` -# ディレクトリ中のすべてのファイルのオーナーになります。 +# In this example, @doctocat owns any file in the `/docs` +# directory in the root of your repository and any of its +# subdirectories. /docs/ @doctocat ``` diff --git a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/about-readmes.md b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/about-readmes.md index 71cc4d0407b3..40228e7abf37 100644 --- a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/about-readmes.md +++ b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/about-readmes.md @@ -1,6 +1,6 @@ --- title: READMEについて -intro: リポジトリにREADMEファイルを追加して、そのプロジェクトがなぜ有益なのか、そのプロジェクトで何ができるか、そのプロジェクトをどのように使えるかを他者に伝えることができます。 +intro: 'リポジトリにREADMEファイルを追加して、そのプロジェクトがなぜ有益なのか、そのプロジェクトで何ができるか、そのプロジェクトをどのように使えるかを他者に伝えることができます。' redirect_from: - /articles/section-links-on-readmes-and-blob-pages/ - /articles/relative-links-in-readmes/ @@ -10,7 +10,7 @@ versions: enterprise-server: '*' --- -README ファイルは、{% if currentVersion == "free-pro-team@latest" %}[リポジトリのライセンス](/articles/licensing-a-repository)、[コントリビューションガイドライン](/articles/setting-guidelines-for-repository-contributors)、[行動規範](/articles/adding-a-code-of-conduct-to-your-project){% else %}[リポジトリのライセンス](/articles/licensing-a-repository)および[コントリビューションガイドライン](/articles/setting-guidelines-for-repository-contributors){% endif %}と合わせて、プロジェクトへのコントリビューションに対する期待を示し、管理するのに役立ちます。 +A README file, along with {% if currentVersion == "free-pro-team@latest" %}a [repository license](/articles/licensing-a-repository), [contribution guidelines](/articles/setting-guidelines-for-repository-contributors), and a [code of conduct](/articles/adding-a-code-of-conduct-to-your-project){% else %}a [repository license](/articles/licensing-a-repository) and [contribution guidelines](/articles/setting-guidelines-for-repository-contributors){% endif %}, helps you communicate expectations for and manage contributions to your project. 多くの場合、READMEはリポジトリへの訪問者が最初に目にするアイテムです。 通常、README ファイルには以下の情報が含まれています: - このプロジェクトが行うこと diff --git a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/about-repositories.md b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/about-repositories.md index a2f8b4563a72..48629ec987c5 100644 --- a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/about-repositories.md +++ b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/about-repositories.md @@ -15,7 +15,8 @@ versions: ユーザが所有するリポジトリでは、他の人々にコラボレーターアクセスを与えて、プロジェクトでコラボレーションするようにできます。 リポジトリが Organization によって所有されている場合は、Organization のメンバーにアクセス権限を与え、リポジトリ上でコラボレーションするようにできます。 詳細は「[ユーザアカウントのリポジトリ権限レベル](/articles/permission-levels-for-a-user-account-repository/)」および「[Organization のリポジトリ権限レベル](/articles/repository-permission-levels-for-an-organization/)」を参照してください。 {% if currentVersion == "free-pro-team@latest" %} -ユーザアカウントと Organization の {% data variables.product.prodname_free_team %} を使用すると、完全な機能セットを備えた無制限のパブリックリポジトリ、または機能セットを制限した無制限のプライベートリポジトリで無制限のコラボレータと連携できます。 プライベートリポジトリの高度なツールを入手するには、 {% data variables.product.prodname_pro %}、{% data variables.product.prodname_team %}、または {% data variables.product.prodname_ghe_cloud %} にアップグレードします。 {% data reusables.gated-features.more-info %} +With +{% data variables.product.prodname_free_team %} for user accounts and 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. プライベートリポジトリの高度なツールを入手するには、 {% data variables.product.prodname_pro %}、{% data variables.product.prodname_team %}、または {% data variables.product.prodname_ghe_cloud %} にアップグレードします。 {% data reusables.gated-features.more-info %} {% else %} 各個人および Organization は、無制限のリポジトリを所有でき、すべてのリポジトリにコラボレータを何人でも招待できます。 {% endif %} diff --git a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md index f7c3d6861d0f..aafacddf5ff3 100644 --- a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md +++ b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md @@ -13,7 +13,8 @@ versions: enterprise-server: '*' --- -構文強調やリポジトリ統計のためには言語を特定する必要があります。{% data variables.product.product_name %}ではオープンソースの [Linguist ライブラリ](https://github.com/github/linguist)を使用して言語を特定します。 Language statistics will update after you push changes to your default branch. +{% data variables.product.product_name %} uses the open source [Linguist library](https://github.com/github/linguist) to +determine file languages for syntax highlighting and repository statistics. Language statistics will update after you push changes to your default branch. ファイルによっては特定しにくいものもあります。また、プロジェクトによっては、主たるコード以外のライブラリやベンダーファイルが含まれていることもあります。 誤った結果が返される場合は、Linguist の [トラブルシューティングガイド](https://github.com/github/linguist#troubleshooting)を調べてみてください。 diff --git a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/about-repository-visibility.md b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/about-repository-visibility.md index 921989b744e3..d8c3f2ea37c5 100644 --- a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/about-repository-visibility.md +++ b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/about-repository-visibility.md @@ -1,23 +1,23 @@ --- -title: リポジトリの可視性について -intro: 'リポジトリの可視性を選択することで、リポジトリにアクセスできるユーザを制限できます{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}（パブリック、内部、プライベート{% else %}パブリックまたはプライベートなど）{% endif %}。' +title: About repository visibility +intro: 'You can restrict who has access to a repository by choosing a repository''s visibility: {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}public, internal, or private{% else %} public or private{% endif %}.' versions: free-pro-team: '*' enterprise-server: '*' --- -### リポジトリの可視性について +### About repository visibility -リポジトリを作成するときに、リポジトリをパブリックにするかプライベートにするかを選択できます。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}Enterprise アカウントが所有する Organization {% if currentVersion == "free-pro-team@latest" %}にリポジトリを作成する場合は{% endif %}、リポジトリを内部にすることもできます。{% endif %} +When you create a repository, you can choose to make the repository public or private. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}If you're creating the repository in an organization{% if currentVersion == "free-pro-team@latest" %} that is owned by an enterprise account{% endif %}, you can also choose to make the repository internal.{% endif %} -{% if currentVersion != "free-pro-team@latest" %}{% data variables.product.product_location_enterprise %} がプライベートモードでない場合、またはファイアウォールの内側にある場合、インターネット上のすべてのユーザがパブリック{% else %}{% endif %}リポジトリにアクセスできます。{% if currentVersion != "free-pro-team@latest" %}それ以外の場合、パブリックリポジトリは、外部のコラボレータを含め、{% data variables.product.product_location_enterprise %} を使用するすべてのユーザが利用できます。{% endif %}プライベートリポジトリには、自分、自分が明示的にアクセスを共有している人、そして Organization リポジトリの場合、[特定の Organization メンバー](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization)のみがアクセスできます。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} 内部リポジトリは、Enterprise アカウントの {% if currentVersion == "free-pro-team@latest" %}メンバー、インスタンスの任意の Organization の{% else %}メンバーにアクセスできます{% endif %}。 詳しい情報については、「[内部リポジトリについて](#about-internal-repositories)」を参照してください。{% endif %} +{% if currentVersion != "free-pro-team@latest" %}If {% data variables.product.product_location_enterprise %} is not in private mode or behind a firewall, p{% else %}P{% endif %}ublic repositories are accessible to everyone on the internet.{% if currentVersion != "free-pro-team@latest" %} Otherwise, public repositories are available to everyone using {% data variables.product.product_location_enterprise %}, including outside collaborators.{% endif %} Private repositories are only accessible to you, people you explicitly share access with, and, for organization repositories, [certain organization members](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization). {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}Internal repositories are accessible to {% if currentVersion == "free-pro-team@latest" %}members of your enterprise account{% else %}members of any organization on your instance{% endif %}. For more information, see "[About internal repositories](#about-internal-repositories)."{% endif %} -Organization のオーナーは、Organization 内で作成されたすべてのリポジトリにいつでもアクセスできます。 詳細は「[Organization のリポジトリ権限レベル](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization)」を参照してください。 +Organization owners always have access to every repository created in an organization. For more information, see "[Repository permission levels for an organization](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization)." -リポジトリの管理者権限を持つユーザは、既存のリポジトリの可視性を変更できます。 詳細は「[リポジトリの可視性を設定する](/github/administering-a-repository/setting-repository-visibility)」を参照してください。 +People with admin permissions for a repository can change an existing repository's visibility. For more information, see "[Setting repository visibility](/github/administering-a-repository/setting-repository-visibility)." {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -### インターナルリポジトリについて +### About internal repositories {% note %} @@ -25,12 +25,11 @@ Organization のオーナーは、Organization 内で作成されたすべての {% endnote %} -{% data reusables.repositories.about-internal-repos %}インナーソースに関する詳しい情報については、{% data variables.product.prodname_dotcom %}のホワイトペーパー「[インナーソース入門](https://resources.github.com/whitepapers/introduction-to-innersource/)」を参照してください。 +{% data reusables.repositories.about-internal-repos %} For more information on innersource, see {% data variables.product.prodname_dotcom %}'s whitepaper "[An introduction to innersource](https://resources.github.com/whitepapers/introduction-to-innersource/)." -すべての{% if currentVersion == "free-pro-team@latest" %}Enterpriseのメンバー{% else %}Organizationのメンバー{% endif %}は、内部リポジトリの読み取り権限を持ちますが、内部リポジトリはOrganizationのリポジトリ上の外部のコラボレータを含め{% if currentVersion == "free-pro-team@latest" %}Enterpriseアカウント外の{% else %}Organizationのメンバーではない{% endif %}人々には見えません。 詳しい情報については、「{% if currentVersion == "free-pro-team@latest" %}[Enterprise アカウントのロール](/articles/roles-for-an-enterprise-account#enterprise-members)」および{% endif %}「[Organization のリポジトリ権限レベル](/articles/repository-permission-levels-for-an-organization)」を参照してください。 +All {% if currentVersion == "free-pro-team@latest" %}enterprise members{% else %}organization members{% endif %} have read permissions to the internal repository, but internal repositories are not visible to people {% if currentVersion == "free-pro-team@latest" %}outside of the enterprise account{% else %}who are not members of an organization{% endif %}, including outside collaborators on organization repositories. For more information, see {% if currentVersion == "free-pro-team@latest" %}"[Roles for an enterprise account](/articles/roles-for-an-enterprise-account#enterprise-members)" and {% endif %}"[Repository permission levels for an organization](/articles/repository-permission-levels-for-an-organization)." {% data reusables.repositories.internal-repo-default %} -ユーザが -{% if currentVersion == "free-pro-team@latest" %}Enterprise アカウント{% else %}インスタンスのすべての Organization {% endif %}から削除されると、そのユーザの内部リポジトリのフォークは自動的に削除されます。 +If a user is removed from {% if currentVersion == "free-pro-team@latest" %}an enterprise account{% else %}all organizations on the instance{% endif %}, that user's forks of internal repositories are removed automatically. {% endif %} diff --git a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md index 81a0a422ca33..5364873fbeb0 100644 --- a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md +++ b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md @@ -1,42 +1,41 @@ --- -title: リポジトリのバックアップ -intro: '{% if currentVersion != "free-pro-team@latest" %}Git および {% endif %}API{% if currentVersion == "free-pro-team@latest" %}またはサードパーティのツール{% endif %}を使用して、リポジトリをバックアップできます。' +title: Backing up a repository +intro: 'You can use{% if currentVersion != "free-pro-team@latest" %} Git and{% endif %} the API {% if currentVersion == "free-pro-team@latest" %}or a third-party tool {% endif %}to back up your repository.' redirect_from: - /articles/backing-up-a-repository versions: free-pro-team: '*' enterprise-server: '*' --- - {% if currentVersion == "free-pro-team@latest" %} -リポジトリのアーカイブをダウンロードするには、ユーザあるいは Organization のマイグレーション用の API が利用できます。 詳しい情報については、「[移行](/v3/migrations/)」を参照してください。 +To download an archive of your repository, you can use the API for user or organization migrations. For more information, see "[Migrations](/v3/migrations/)." {% else %} -リポジトリのダウンロードおよびバックアップを手動で実行できます。 +You can download and back up your repositories manually: -- リポジトリの Git データをローカルマシンにダウンロードするには、リポジトリをクローンする必要があります。 詳しい情報については[リポジトリのクローン](/articles/cloning-a-repository)を参照してください。 -- また、リポジトリの wiki をダウンロードすることもできます。 詳細は「[ウィキページを追加または編集する](/articles/adding-or-editing-wiki-pages)」を参照してください。 +- To download a repository's Git data to your local machine, you'll need to clone the repository. For more information, see "[Cloning a repository](/articles/cloning-a-repository)." +- You can also download your repository's wiki. For more information, see "[Adding or editing wiki pages](/articles/adding-or-editing-wiki-pages)." -リポジトリもしくは wiki をクローンすると、プロジェクトのファイルやコミット履歴などの Git のデータだけがダウンロードされます。 {% data variables.product.product_name %}リポジトリの他の要素をローカルマシンにエクスポートするには、弊社の API が利用できます。 +When you clone a repository or wiki, only Git data, such as project files and commit history, is downloaded. You can use our API to export other elements of your {% data variables.product.product_name %} repository to your local machine: -- [問題](/v3/issues/#list-issues-for-a-repository) -- [プルリクエスト](/v3/pulls/#list-pull-requests) -- [フォーク](/v3/repos/forks/#list-forks) -- [コメント](/v3/issues/comments/#list-comments-in-a-repository) -- [マイルストーン](/v3/issues/milestones/#list-milestones-for-a-repository) -- [ラベル](/v3/issues/labels/#list-all-labels-for-this-repository) -- [Watcher](/v3/activity/watching/#list-watchers) -- [Starを付けたユーザ](/v3/activity/starring/#list-stargazers) -- [プロジェクト](/v3/projects/#list-repository-projects) +- [Issues](/v3/issues/#list-issues-for-a-repository) +- [Pull requests](/v3/pulls/#list-pull-requests) +- [Forks](/rest/reference/repos#list-forks) +- [Comments](/rest/reference/issues#list-issue-comments-for-a-repository) +- [Milestones](/rest/reference/issues#list-milestones) +- [Labels](/rest/reference/issues#list-labels-for-a-repository) +- [Watchers](/rest/reference/activity#list-watchers) +- [Stargazers](/rest/reference/activity#list-stargazers) +- [Projects](/v3/projects/#list-repository-projects) {% endif %} -{% if currentVersion != "free-pro-team@latest" %}バックアップしたいすべての内容のローカルバージョンができたなら、zipアーカイブを作成して{% else %}アーカイブがダウンロードできたなら{% endif %}外部ハードディスクにコピーするか、[Google Drive](https://www.google.com/drive/)あるいは[ Dropbox](https://www.dropbox.com/)などのクラウドベースのバックアップサービスにアップロードしてください。 +Once you have {% if currentVersion != "free-pro-team@latest" %}a local version of all the content you want to back up, you can create a zip archive and {% else %}downloaded your archive, you can {% endif %}copy it to an external hard drive and/or upload it to a cloud-based backup service such as [Google Drive](https://www.google.com/drive/) or [Dropbox](https://www.dropbox.com/). {% if currentVersion == "free-pro-team@latest" %} -### サードパーティのバックアップツール +### Third-party backup tools -リポジトリのバックアップを自動化するセルフサービスのツールはたくさんあります。 オプトアウトしておらず、誰でもデータにアクセスできるようにする {% data variables.product.product_name %} 上の_すべての_パブリックリポジトリをアーカイブするアーカイブプロジェクトとは異なり、バックアップツールは_特定の_リポジトリからデータをダウンロードし、新しいブランチまたはディレクトリ内に整理します。 アーカイブプロジェクトの詳細については、「[{% data variables.product.prodname_dotcom %} のコンテンツとデータのアーカイブについて](/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github#about-the-github-archive-program)」を参照してください。 +A number of self-service tools exist that automate backups of repositories. Unlike archival projects, which archive _all_ public repositories on {% data variables.product.product_name %} that have not opted out and make the data accessible to anyone, backup tools will download data from _specific_ repositories and organize it within a new branch or directory. For more information about archival projects, see "[About archiving content and data on {% data variables.product.prodname_dotcom %}](/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github#about-the-github-archive-program)." -リポジトリのすべての Git データ (プロジェクトファイルやコミット履歴) は、{% data variables.product.product_name %}からのデータの大部分 (Issue やプルリクエストなど) と共に[ BackHub](https://github.com/marketplace/backhub)でバックアップできます。BackHub は、リポジトリの日次の循環バックアップを、最大で 30 日までさかのぼったスナップショットと共に作成します。 BackHub は {% data variables.product.prodname_marketplace %}から利用できます。 +You can back up all of a repository's Git data (such as project files and commit history), as well as much data from {% data variables.product.product_name %} (such as issues and pull requests), with [BackHub](https://github.com/marketplace/backhub), which creates daily recurring backups of your repositories with snapshots up to 30 days back in time. BackHub is available in {% data variables.product.prodname_marketplace %}. {% endif %} diff --git a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository-from-github.md b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository-from-github.md index aec5c12ad6b4..11bd1ab80abc 100644 --- a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository-from-github.md +++ b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository-from-github.md @@ -1,6 +1,6 @@ --- title: GitHub からリポジトリをクローンする -intro: リモートリポジトリは、ローカルマシンにクローンできます。 エラーが発生した場合、いくつかの典型的な解決方法があります。 +intro: 'リモートリポジトリは、ローカルマシンにクローンできます。 エラーが発生した場合、いくつかの典型的な解決方法があります。' mapTopic: true redirect_from: - /articles/cloning-a-repository-from-github diff --git a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md index 1f07085e82e4..8256743b9dff 100644 --- a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md +++ b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md @@ -46,7 +46,7 @@ You can clone your existing repository or clone another person's existing reposi 空のリポジトリにはファイルが含まれていません。 リポジトリを作成するときに README でリポジトリを初期化しない場合に多くあります。 {% data reusables.repositories.navigate-to-repo %} -2. HTTPS でコマンドラインを使用してリポジトリをクローンするには、[Quick setup] で {% octicon "clippy" aria-label="The clipboard icon" %} をクリックします。 Organization の SSH 認証局から発行された証明書を含む SSH キーを使用して{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}リポジトリのクローンを作成するには{% endif %}、[**SSH**] をクリックしてから、{% octicon "clippy" aria-label="The clipboard icon" %} をクリックします。 ![[Empty repository clone URL] ボタン](/assets/images/help/repository/empty-https-url-clone-button.png) +2. HTTPS でコマンドラインを使用してリポジトリをクローンするには、[Quick setup] で {% octicon "clippy" aria-label="The clipboard icon" %} をクリックします。 To clone the repository using an SSH key, including a certificate issued by your organization's SSH certificate authority, click **SSH**, then click {% octicon "clippy" aria-label="The clipboard icon" %}. ![[Empty repository clone URL] ボタン](/assets/images/help/repository/empty-https-url-clone-button.png) または、リポジトリをデスクトップにクローンするには、{% octicon "desktop-download" aria-label="The desktop download button" %} [**Set up in Desktop**] をクリックし、プロンプトに従ってクローンを完了します。 ![[Empty repository clone desktop] ボタン](/assets/images/help/repository/empty-desktop-clone-button.png) @@ -55,7 +55,6 @@ You can clone your existing repository or clone another person's existing reposi {% data reusables.command_line.git-clone-url %} {% data reusables.command_line.local-clone-created %} - ### クローンエラーのトラブルシューティング リポジトリのクローンを作成するときに、エラーが発生する可能性があります。 @@ -66,7 +65,6 @@ You can clone your existing repository or clone another person's existing reposi - クローンするリポジトリへのアクセス権を持っている。 詳しい情報については、「[Error: Repository not found](/github/creating-cloning-and-archiving-repositories/error-repository-not-found)」を参照してください。 - クローンするデフォルトブランチが存在する。 詳しい情報については、「クローンするリポジトリへのアクセス権を持っている」を参照してください。 詳細については、「[Error: Remote HEAD refers to nonexistent ref, unable to checkout](/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout) 」を参照してください。 - {% if currentVersion == "free-pro-team@latest" %} ### 参考リンク diff --git a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md index 58a53cfd65f0..817cb142a756 100644 --- a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md +++ b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md @@ -28,15 +28,15 @@ versions: {% endtip %} {% endif %} -{% data reusables.repositories.create_new %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} +{% data reusables.repositories.create_new %} 2. また、既存のリポジトリのディレクトリ構造とファイルを持つリポジトリを作成するには、[**Choose a template**] ドロップダウンでテンプレートリポジトリを選択します。 あなたが所有するテンプレートリポジトリ、あなたがメンバーとして属する Organization が所有するテンプレートリポジトリ、使ったことがあるテンプレートリポジトリが表示されます。 詳細は「[テンプレートからリポジトリを作成する](/articles/creating-a-repository-from-a-template)」を参照してください。 ![Template drop-down menu](/assets/images/help/repository/template-drop-down.png){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -3. 必要に応じて、テンプレートを使用する場合、デフォルトのブランチだけでなく、テンプレートのすべてのブランチからのディレクトリ構造とファイルを含めるには、[**Include all branches**] を選択します。 ![Include all branches checkbox](/assets/images/help/repository/include-all-branches.png){% endif %}{% endif %} +3. 必要に応じて、テンプレートを使用する場合、デフォルトのブランチだけでなく、テンプレートのすべてのブランチからのディレクトリ構造とファイルを含めるには、[**Include all branches**] を選択します。 ![Include all branches checkbox](/assets/images/help/repository/include-all-branches.png){% endif %} 3. [Owner] ドロップダウンで、リポジトリを作成するアカウントを選択します。 ![[Owner] ドロップダウンメニュー](/assets/images/help/repository/create-repository-owner.png) {% data reusables.repositories.repo-name %} {% data reusables.repositories.choose-repo-visibility %} -6. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}テンプレートを使っていない場合、{% else %}{% endif %}リポジトリに自動入力できる数多くのオプションアイテムがあります。 既存のリポジトリを {% data variables.product.product_name %}にインポートする場合は、このようなオプションはどれも選択しないでください。マージコンフリクトが起きる可能性があります。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.15" %}ユーザインターフェースを使用して新しいファイルを追加または作成する、または{% endif %}コマンドラインを使用して後で新しいファイルを追加することができます。 詳細は「[コマンドラインを使って Git リポジトリをインポートする](/articles/importing-a-git-repository-using-the-command-line/)」、「[コマンドラインを使ってリポジトリにファイルを追加する](/articles/adding-a-file-to-a-repository-using-the-command-line)」、「[マージコンフリクトに対処する](/articles/addressing-merge-conflicts/)」を参照してください。 +6. If you're not using a template, there are a number of optional items you can pre-populate your repository with. 既存のリポジトリを {% data variables.product.product_name %}にインポートする場合は、このようなオプションはどれも選択しないでください。マージコンフリクトが起きる可能性があります。 ユーザインターフェースを使用して新しいファイルを追加または作成する、またはコマンドラインを使用して後で新しいファイルを追加することができます。 詳細は「[コマンドラインを使って Git リポジトリをインポートする](/articles/importing-a-git-repository-using-the-command-line/)」、「[コマンドラインを使ってリポジトリにファイルを追加する](/articles/adding-a-file-to-a-repository-using-the-command-line)」、「[マージコンフリクトに対処する](/articles/addressing-merge-conflicts/)」を参照してください。 - 自分のプロジェクトについて説明するドキュメントである README を作成できます。 詳しい情報については「[README について](/articles/about-readmes/)」を参照してください。 - - 無視するルールを記載した *.gitignore* ファイルを作成できます。 詳細は「[ファイルを無視する](/articles/ignoring-files)」を参照してください。{% if currentVersion == "free-pro-team@latest" %} + - 無視するルールを記載した *.gitignore* ファイルを作成できます。 For more information, see "[Ignoring files](/articles/ignoring-files)."{% if currentVersion == "free-pro-team@latest" %} - 自分のプロジェクトにソフトウェアライセンスを追加することができます。 詳細は「[リポジトリのライセンス](/articles/licensing-a-repository)」を参照してください。{% endif %} {% data reusables.repositories.select-marketplace-apps %} {% data reusables.repositories.create-repo %} @@ -47,6 +47,5 @@ versions: ### 参考リンク - "[Organization のリポジトリへのアクセスを管理する](/articles/managing-access-to-your-organization-s-repositories)" -- [オープンソースガイド](https://opensource.guide/){% if currentVersion == "free-pro-team@latest" %} -- [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}){% endif %}{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.16" %} -- "[README で空のリポジトリを初期化する](/articles/initializing-an-empty-repository-with-a-readme)"{% endif %} +- [Open Source Guides](https://opensource.guide/){% if currentVersion == "free-pro-team@latest" %} +- [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}){% endif %} diff --git a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md index 53a12ac76e0d..394d36261530 100644 --- a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md +++ b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md @@ -5,7 +5,7 @@ redirect_from: - /articles/creating-a-repository-from-a-template versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- ### About repository templates diff --git a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md index 4ffa923092fa..985918901d8d 100644 --- a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md +++ b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md @@ -1,19 +1,20 @@ --- -title: テンプレートリポジトリを作成する -intro: '既存のリポジトリをテンプレートにして、自分や他の人が同じディレクトリ構造{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}、ブランチ、{% endif %}およびファイルで新しいリポジトリを生成できるようにすることができます。' +title: Creating a template repository +intro: 'You can make an existing repository a template, so you and others can generate new repositories with the same directory structure{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}, branches,{% endif %} and files.' redirect_from: - /articles/creating-a-template-repository versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- -リポジトリに対する管理者権限があるユーザなら誰でも、リポジトリをテンプレート化できます。 +Anyone with admin permissions to a repository can make the repository a template. -テンプレートリポジトリを作成するには、リポジトリを作成して、そのリポジトリをテンプレート化する必要があります。 リポジトリの作成に関する詳細は「[新しいリポジトリの作成](/articles/creating-a-new-repository)」を参照してください。 +To create a template repository, you must create a repository, then make the repository a template. For more information about creating a repository, see "[Creating a new repository](/articles/creating-a-new-repository)." -リポジトリをテンプレートにすると、そのリポジトリにアクセスできるすべてのユーザが、デフォルトのブランチと同じディレクトリ構造とファイルで新しいリポジトリを生成できます。{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}また、他のすべてのブランチをリポジトリに含めることもできます。{% endif %}詳しい情報については、「[テンプレートからリポジトリを作成する](/articles/creating-a-repository-from-a-template)」を参照してください。 +After you make your repository a template, anyone with access to the repository can generate a new repository with the same directory structure and files as your default branch.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} They can also choose to include all the other branches in your repository.{% endif %} For more information, see "[Creating a repository from a template](/articles/creating-a-repository-from-a-template)." {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} -3. [**Template repository**] を選択します。 ![リポジトリをテンプレート化するチェックボックス](/assets/images/help/repository/template-repository-checkbox.png) +3. Select **Template repository**. + ![Checkbox to make a repository a template](/assets/images/help/repository/template-repository-checkbox.png) diff --git a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/duplicating-a-repository.md b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/duplicating-a-repository.md index d842c8816899..c829e0e52005 100644 --- a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/duplicating-a-repository.md +++ b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/duplicating-a-repository.md @@ -1,6 +1,6 @@ --- title: リポジトリを複製する -intro: フォークせずにリポジトリを複製するため、特別なクローンコマンドを実行して、新しいリポジトリにミラープッシュすることができます。 +intro: 'フォークせずにリポジトリを複製するため、特別なクローンコマンドを実行して、新しいリポジトリにミラープッシュすることができます。' redirect_from: - /articles/duplicating-a-repo/ - /articles/duplicating-a-repository diff --git a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md index b4ad9decaccd..2ee370aee363 100644 --- a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md +++ b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md @@ -22,23 +22,23 @@ $ git clone https://{% data variables.command_line.codeblock %}/user/ warning: remote HEAD refers to nonexistent ref, unable to checkout. ``` -このエラーを解決するには、{% data variables.product.product_location %} リポジトリの管理者になる必要があります。 リポジトリの[デフォルトブランチの変更](/articles/setting-the-default-branch)が必要となります。 +このエラーを解決するには、{% data variables.product.product_location %} リポジトリの管理者になる必要があります。 リポジトリの[デフォルトブランチの変更](/github/administering-a-repository/changing-the-default-branch)が必要となります。 その後、コマンドラインで使用可能なブランチすべてのリストを取得できます: ```shell $ git branch -a -# すべてのブランチをリスト +# Lists ALL the branches > remotes/origin/awesome > remotes/origin/more-work -> remotes/origin/new-master +> remotes/origin/new-main ``` その後、新しいブランチにスイッチするだけです: ```shell -$ git checkout new-master +$ git checkout new-main # Create and checkout a tracking branch -> Branch new-master set up to track remote branch new-master from origin. -> Switched to a new branch 'new-master' +> Branch new-main set up to track remote branch new-main from origin. +> Switched to a new branch 'new-main' ``` diff --git a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/error-repository-not-found.md b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/error-repository-not-found.md index d95966b9f3cb..6456ff9d8656 100644 --- a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/error-repository-not-found.md +++ b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/error-repository-not-found.md @@ -1,6 +1,6 @@ --- title: 'Error: Repository not found' -intro: '{% if currentVersion == "free-pro-team@latest" %}リポジトリのクローン時にこのエラーが表示された場合は、リポジトリが存在しないかリポジトリへのアクセス権がないことを意味します。 このエラーの解決策は、原因によっていくつかあります。{% else %}リポジトリのクローン時にこのエラーが表示された場合は、リポジトリが存在しないか、リポジトリへのアクセス権がないか、 GitHub Enterprise のインスタンスがプライベートモードであることを意味します。 このエラーには、原因別にいくつかの解決策があります。{% endif %}' +intro: '{% if currentVersion == "free-pro-team@latest" %}If you see this error when cloning a repository, it means that the repository does not exist or you do not have permission to access it. このエラーの解決策は、原因によっていくつかあります。{% else %}リポジトリのクローン時にこのエラーが表示された場合は、リポジトリが存在しないか、リポジトリへのアクセス権がないか、 GitHub Enterprise のインスタンスがプライベートモードであることを意味します。 このエラーには、原因別にいくつかの解決策があります。{% endif %}' redirect_from: - /articles/error-repository-not-found versions: diff --git a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/https-cloning-errors.md b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/https-cloning-errors.md index 5e529a1b6841..17e6fd50bd5a 100644 --- a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/https-cloning-errors.md +++ b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/https-cloning-errors.md @@ -1,6 +1,6 @@ --- title: HTTPS クローニングエラー -intro: Git で HTTPS を使用する際によく生じるエラーがいくつかあります。 これらのエラーは通常、古いバージョンの Git を使用しているか、もしくはリポジトリへのアクセス権を持っていないことが原因です。 +intro: 'Git で HTTPS を使用する際によく生じるエラーがいくつかあります。 これらのエラーは通常、古いバージョンの Git を使用しているか、もしくはリポジトリへのアクセス権を持っていないことが原因です。' redirect_from: - /articles/error-the-requested-url-returned-error-403/ - /articles/error-the-requested-url-returned-error-401/ diff --git a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/index.md b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/index.md index 51f38bad302a..823dfc1fac77 100644 --- a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/index.md +++ b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/index.md @@ -1,5 +1,5 @@ --- -title: リポジトリの作成、クローン、アーカイブ +title: 'リポジトリの作成、クローン、アーカイブ' intro: 'リポジトリを作成またはクローンする際に、さまざまな構成オプションから選択できます。 リポジトリを使用して、{% data variables.product.prodname_dotcom %} のコンテンツとデータをアーカイブすることもできます。' redirect_from: - /categories/repositories/ diff --git a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md index 9a5e919b46bc..c3ae8ae2b2ea 100644 --- a/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md +++ b/translations/ja-JP/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md @@ -1,6 +1,6 @@ --- title: リポジトリのライセンス -intro: GitHub のパブリックリポジトリは、オープンソース ソフトウェアの共有にも頻繁に利用されています。 リポジトリを真にオープンソースにしたければ、他のユーザが自由にそのソフトウェアを使用でき、変更や配布もできるように、ライセンスを付与する必要があります。 +intro: 'GitHub のパブリックリポジトリは、オープンソース ソフトウェアの共有にも頻繁に利用されています。 リポジトリを真にオープンソースにしたければ、他のユーザが自由にそのソフトウェアを使用でき、変更や配布もできるように、ライセンスを付与する必要があります。' redirect_from: - /articles/open-source-licensing/ - /articles/licensing-a-repository @@ -17,7 +17,7 @@ versions: {% note %} -**メモ:** ソースコードを GitHub のパブリックリポジトリで公開する場合、{% if currentVersion == "free-pro-team@latest" %}[利用規約に従って、](/articles/github-terms-of-service){% endif %}他の GitHub ユーザは GitHub サイト内でリポジトリを閲覧し、フォークする権利を有します。 すでにパブリックリポジトリを作成しており、ユーザによるアクセスを禁止したい場合には、リポジトリをプライベートにすることができます。 パブリックリポジトリをプライベートリポジトリに変換しても、他のユーザが作成した既存のフォークやローカル コピーは存続します。 詳細は「[パブリックリポジトリをプライベートにする](/articles/making-a-public-repository-private)」を参照してください。 +**Note:** If you publish your source code in a public repository on GitHub, {% if currentVersion == "free-pro-team@latest" %}according to the [Terms of Service](/articles/github-terms-of-service), {% endif %}other GitHub users have the right to view and fork your repository within the GitHub site. すでにパブリックリポジトリを作成しており、ユーザによるアクセスを禁止したい場合には、リポジトリをプライベートにすることができます。 パブリックリポジトリをプライベートリポジトリに変換しても、他のユーザが作成した既存のフォークやローカル コピーは存続します。 詳細は「[パブリックリポジトリをプライベートにする](/articles/making-a-public-repository-private)」を参照してください。 {% endnote %} @@ -49,6 +49,7 @@ versions: | | Do What The F*ck You Want To Public License | `wtfpl` | | | Educational Community License v2.0 | `ecl-2.0` | | | Eclipse Public License 1.0 | `epl-1.0` | +| | Eclipse Public License 2.0 | `epl-2.0` | | | European Union Public License 1.1 | `eupl-1.1` | | | GNU Affero General Public License v3.0 | `agpl-3.0` | | | GNU General Public License ファミリー | `gpl` | @@ -89,5 +90,5 @@ GitHub がオープンソース ライセンスへの取り組みで目指して ### 参考リンク -- オープンソース ガイドの「[オープンソースの法的な側面](https://opensource.guide/legal/)」セクションをお読みください。{% if currentVersion == "free-pro-team@latest" %} +- The Open Source Guides' section "[The Legal Side of Open Source](https://opensource.guide/legal/)"{% if currentVersion == "free-pro-team@latest" %} - [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}){% endif %} diff --git a/translations/ja-JP/content/github/customizing-your-github-workflow/about-github-marketplace.md b/translations/ja-JP/content/github/customizing-your-github-workflow/about-github-marketplace.md index 28d918725ce2..bd5d083e5000 100644 --- a/translations/ja-JP/content/github/customizing-your-github-workflow/about-github-marketplace.md +++ b/translations/ja-JP/content/github/customizing-your-github-workflow/about-github-marketplace.md @@ -28,5 +28,5 @@ versions: ### 参考リンク - [{% data variables.product.prodname_marketplace %}でのアプリケーションの購入とインストール](/articles/purchasing-and-installing-apps-in-github-marketplace) -- 「[{% data variables.product.prodname_marketplace %} アプリケーションの支払いを管理する](/articles/managing-billing-for-github-marketplace-apps)」 +- [{% data variables.product.prodname_marketplace %} アプリの支払いを管理する](/articles/managing-billing-for-github-marketplace-apps) - [{% data variables.product.prodname_marketplace %}のサポート](/articles/github-marketplace-support) diff --git a/translations/ja-JP/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md b/translations/ja-JP/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md new file mode 100644 index 000000000000..0871503bf376 --- /dev/null +++ b/translations/ja-JP/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md @@ -0,0 +1,27 @@ +--- +title: About billing for Codespaces +intro: 'When {% data variables.product.prodname_codespaces %} becomes generally available, you will be billed for storage and compute usage.' +product: '{% data reusables.gated-features.codespaces %}' +versions: + free-pro-team: '*' +--- + +{% data reusables.codespaces.release-stage %} + +{% data reusables.codespaces.about-billing-for-codespaces %} + +Compute costs are incurred only when a codespace is active. When you're using a codespace, the codespace is active. After 30 minutes of inactivity, a codespace becomes suspended automatically. + +Compute usage is billed per hour, at a rate that depends on your codespace's instance type. During the beta, {% data variables.product.prodname_codespaces %} offers a single, Linux instance type. At general availability, we'll support three Linux instance types. + +| Instance Type (Linux) | Per-hour rate | +| --------------------------------------- | ------------- | +| Basic (2 cores, 4GB RAM, 32 GB SSD) | $0.085 | +| Standard (4 cores, 8 GB RAM, 32 GB SSD) | $0.169 | +| Premium (8 cores, 16 GB RAM, 32 GB SSD) | $0.339 | + +Compute pricing may vary for additional instance types and operating systems supported in the future. + +Each codespace also incurs monthly storage costs until you delete the codespace. Storage costs for all instance types are $0.10/GB-month. + +We'll share more information about any compute and storage usage included in each plan at general availability. diff --git a/translations/ja-JP/content/github/developing-online-with-codespaces/about-codespaces.md b/translations/ja-JP/content/github/developing-online-with-codespaces/about-codespaces.md index bbd407702f6e..88ceb1b48b43 100644 --- a/translations/ja-JP/content/github/developing-online-with-codespaces/about-codespaces.md +++ b/translations/ja-JP/content/github/developing-online-with-codespaces/about-codespaces.md @@ -10,11 +10,11 @@ versions: {% note %} -**注釈:** {% data variables.product.prodname_codespaces %} は現在限定パブリックベータであり、変更されることがあります。 ベータ期間中、 {% data variables.product.prodname_dotcom %} は {% data variables.product.prodname_codespaces %} の可用性について一切の保証を行いません。 ベータへの参加についての詳細は、「[ベータへの参加](/github/developing-online-with-codespaces/about-codespaces#joining-the-beta)」を参照してください。 +**注釈:** {% data variables.product.prodname_codespaces %} は現在限定パブリックベータであり、変更されることがあります。 ベータ期間中、{% data variables.product.prodname_dotcom %}は{% data variables.product.prodname_codespaces %}の可用性について保証しません。 ベータへの参加についての詳細は、「[ベータへの参加](/github/developing-online-with-codespaces/about-codespaces#joining-the-beta)」を参照してください。 {% endnote %} -### {% data variables.product.prodname_codespaces %}について +### {% data variables.product.prodname_codespaces %} について {% data variables.product.prodname_codespaces %} is a cloud development environment available in your browser. codespace には、構文の強調表示とオートコンプリートを備えたテキストエディタ、ターミナル、デバッグツール、Git コマンドなど、特定のリポジトリ向けに開発する必要があるすべてのものが {% data variables.product.prodname_dotcom %} 内に含まれています。 codespace に {% data variables.product.prodname_vscode %} 拡張機能をインストールして、機能を追加することもできます。 @@ -44,7 +44,7 @@ versions: ### {% data variables.product.prodname_codespaces %}の支払いについて -During the limited public beta, {% data variables.product.prodname_codespaces %} is free to use and users are limited to 2 codespaces. プランと価格は、一般提供の前に発表されます。 +{% data reusables.codespaces.about-billing-for-codespaces %} 詳細は「[{% data variables.product.prodname_codespaces %} の支払いについて](/github/developing-online-with-codespaces/about-billing-for-codespaces)」を参照してください。 ### ベータに参加する diff --git a/translations/ja-JP/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md b/translations/ja-JP/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md index 5e28380a5404..2294327fb55b 100644 --- a/translations/ja-JP/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md +++ b/translations/ja-JP/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md @@ -21,7 +21,9 @@ If you don't define a configuration in your repository, {% data variables.produc プロジェクトタイプ用にビルド済みコンテナ設定を使用してデフォルトの codespace 設定を作成するか、プロジェクトのニーズに固有のカスタム設定を作成できます。 -{% data variables.product.prodname_codespaces %} は、リポジトリのルートまたは `.devcontainer` フォルダの `devcontainer.json` という名前のファイルに含まれる設定を使用します。 `devcontainer.json` を使用して、{% data variables.product.prodname_vscode %} エディタを含む codespace 環境全体のデフォルト設定をすることができますが、`.vscode/settings.json` という名前のファイルでエディタ固有の設定をすることもできます。 +{% data variables.product.prodname_codespaces %} uses settings contained in a configuration file named `devcontainer.json`. {% data reusables.codespaces.devcontainer-location %} + +You can use your `devcontainer.json` to set default settings for the entire codespace environment, including the {% data variables.product.prodname_vscode %} editor, but you can also set editor-specific settings in a file named `.vscode/settings.json`. リポジトリの codespace 設定への変更は、すべての新しい codespace にのみ適用され、既存の codespace には影響しません。 @@ -38,7 +40,9 @@ If you don't define a configuration in your repository, {% data variables.produc ### カスタム codespace 設定を作成する -ビルド済みの設定がニーズを満たしていない場合は、`devcontainer.json` ファイルをリポジトリのルートまたは `.devcontainer` フォルダに追加して、カスタム設定を作成できます。 このファイルでは、サポートされている設定キーを使用して、codespace の環境の要素を指定できます。たとえば、{% data variables.product.prodname_vscode %} 拡張機能がインストールできます。 +If none of the pre-built configurations meet your needs, you can create a custom configuration by adding a `devcontainer.json` file. {% data reusables.codespaces.devcontainer-location %} + +このファイルでは、サポートされている設定キーを使用して、codespace の環境の要素を指定できます。たとえば、{% data variables.product.prodname_vscode %} 拡張機能がインストールできます。 {% data reusables.codespaces.vscode-settings-order %} diff --git a/translations/ja-JP/content/github/developing-online-with-codespaces/creating-a-codespace.md b/translations/ja-JP/content/github/developing-online-with-codespaces/creating-a-codespace.md index 6fc75f73d9e5..818cc9a591bb 100644 --- a/translations/ja-JP/content/github/developing-online-with-codespaces/creating-a-codespace.md +++ b/translations/ja-JP/content/github/developing-online-with-codespaces/creating-a-codespace.md @@ -2,7 +2,7 @@ title: codespace を作成する intro: リポジトリのブランチの codespace を作成して、オンラインで開発できます。 product: '{% data reusables.gated-features.codespaces %}' -permissions: すべてのユーザは、任意のパブリックリポジトリ、またはユーザアカウントが所有する任意のリポジトリの codespace を作成できます。 +permissions: 'すべてのユーザは、任意のパブリックリポジトリ、またはユーザアカウントが所有する任意のリポジトリの codespace を作成できます。' redirect_from: - /github/developing-online-with-github-codespaces/creating-a-codespace versions: diff --git a/translations/ja-JP/content/github/developing-online-with-codespaces/index.md b/translations/ja-JP/content/github/developing-online-with-codespaces/index.md index 5ab48aed953d..ac321be2e33a 100644 --- a/translations/ja-JP/content/github/developing-online-with-codespaces/index.md +++ b/translations/ja-JP/content/github/developing-online-with-codespaces/index.md @@ -14,10 +14,12 @@ versions: ### 目次 {% link_in_list /about-codespaces %} +{% link_in_list /about-billing-for-codespaces %} {% link_in_list /configuring-codespaces-for-your-project %} {% link_in_list /creating-a-codespace %} {% link_in_list /developing-in-a-codespace %} {% link_in_list /personalizing-codespaces-for-your-account %} {% link_in_list /deleting-a-codespace %} {% link_in_list /troubleshooting-your-codespace %} -{% link_in_list /connecting-to-your-codespace-from-visual-studio-code %} +{% link_in_list /using-codespaces-in-visual-studio-code %} +{% link_in_list /using-codespaces-in-visual-studio %} diff --git a/translations/ja-JP/content/github/developing-online-with-codespaces/troubleshooting-your-codespace.md b/translations/ja-JP/content/github/developing-online-with-codespaces/troubleshooting-your-codespace.md index 59887cb861e8..2d73d61d9b6e 100644 --- a/translations/ja-JP/content/github/developing-online-with-codespaces/troubleshooting-your-codespace.md +++ b/translations/ja-JP/content/github/developing-online-with-codespaces/troubleshooting-your-codespace.md @@ -1,6 +1,6 @@ --- title: codespace のトラブルシューティング -intro: 「microsoft/vscode」リポジトリで既知の問題を確認することで、codespace の問題をトラブルシューティングできます。 +intro: '「microsoft/vscode」リポジトリで既知の問題を確認することで、codespace の問題をトラブルシューティングできます。' product: '{% data reusables.gated-features.codespaces %}' redirect_from: - /github/developing-online-with-github-codespaces/troubleshooting-your-codespace diff --git a/translations/ja-JP/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md b/translations/ja-JP/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md new file mode 100644 index 000000000000..871388bfb37a --- /dev/null +++ b/translations/ja-JP/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md @@ -0,0 +1,45 @@ +--- +title: Using Codespaces in Visual Studio Code +intro: '{% data variables.product.product_name %} のアカウントに {% data variables.product.prodname_vs_codespaces %} 機能拡張を接続することにより、{% data variables.product.prodname_vscode %} で codespace を直接開発できます。' +product: '{% data reusables.gated-features.codespaces %}' +redirect_from: + - /github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code +versions: + free-pro-team: '*' +--- + +{% data reusables.codespaces.release-stage %} + +### 必要な環境 + +{% data variables.product.prodname_vscode %} の codespace で直接開発する前に、{% data variables.product.product_name %} アカウントに接続するように {% data variables.product.prodname_vs_codespaces %} の機能拡張を設定する必要があります。 + +1. {% data variables.product.prodname_vs %} Marketplace を使用して、[{% data variables.product.prodname_vs_codespaces %}](https://marketplace.visualstudio.com/items?itemName=ms-vsonline.vsonline) 機能拡張をインストールします。 詳しい情報については、{% data variables.product.prodname_vscode %} ドキュメントの「[Extension Marketplace](https://code.visualstudio.com/docs/editor/extension-gallery)」を参照してください。 +2. {% data variables.product.prodname_vscode %} の左サイドバーで、[Extensions] アイコンをクリックします。 ![{% data variables.product.prodname_vscode %} の [Extensions] アイコン](/assets/images/help/codespaces/click-extensions-icon-vscode.png) +3. {% data variables.product.prodname_vs_codespaces %} の下で、[Manage] アイコンをクリックしてから、[**Extension Settings**] をクリックします。 ![[Extension Settings] オプション](/assets/images/help/codespaces/select-extension-settings.png) +4. [Vsonline: Account Provider] ドロップダウンメニューを使用して、{% data variables.product.prodname_dotcom %} を選択します。 ![アカウントプロバイダを {% data variables.product.prodname_dotcom %} に設定する](/assets/images/help/codespaces/select-account-provider-vscode.png) +{% data reusables.codespaces.click-remote-explorer-icon-vscode %} +6. ヘッダで {% data variables.product.prodname_codespaces %} がまだ選択されていない場合は、[**{% data variables.product.prodname_codespaces %}**] をクリックします。 ![{% data variables.product.prodname_codespaces %} ヘッダ](/assets/images/help/codespaces/codespaces-header-vscode.png) +7. [**Sign in to view {% data variables.product.prodname_codespaces %}...**] をクリックします。 ![[Signing in to view {% data variables.product.prodname_codespaces %}]](/assets/images/help/codespaces/sign-in-to-view-codespaces-vscode.png) +8. {% data variables.product.prodname_vscode %} からの {% data variables.product.product_name %} のアカウントへのアクセスを承認するには、[**Allow**] をクリックします。 +9. 機能拡張を承認するには、{% data variables.product.product_name %} にサインインします。 + +### Creating a codespace in {% data variables.product.prodname_vscode %} + +After you connect your {% data variables.product.product_name %} account to the {% data variables.product.prodname_vs_codespaces %} extension, you can develop in a codespace that you created on {% data variables.product.product_name %} or in {% data variables.product.prodname_vscode %}. + +{% data reusables.codespaces.click-remote-explorer-icon-vscode %} +2. Click the Add icon, then click **Create New Codespace**. ![The Create new Codespace option in {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/create-codespace-vscode.png) +3. Type, then click the repository's name you want to develop in. ![Searching for repository to create a new {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/choose-repository-vscode.png) +4. Click the branch you want to develop in. ![Searching for a branch to create a new {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/choose-branch-vscode.png) + +### {% data variables.product.prodname_vscode %} で codespace を開く + +{% data reusables.codespaces.click-remote-explorer-icon-vscode %} +2. [Codespaces] で、開発する codespace をクリックします。 +3. [Connect to Codespace] アイコンをクリックします。 ![{% data variables.product.prodname_vscode %} の [Connect to Codespace] アイコン](/assets/images/help/codespaces/click-connect-to-codespace-icon-vscode.png) + +### Deleting a codespace in {% data variables.product.prodname_vscode %} + +1. Under Codespaces, right-click the codespace you want to delete. +2. In the drop-down menu, click **Delete Codespace**. ![Deleting a codespace in {% data variables.product.prodname_dotcom %}](/assets/images/help/codespaces/delete-codespace-vscode.png) diff --git a/translations/ja-JP/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md b/translations/ja-JP/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md new file mode 100644 index 000000000000..8115b7d41243 --- /dev/null +++ b/translations/ja-JP/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md @@ -0,0 +1,53 @@ +--- +title: Using Codespaces in Visual Studio +intro: 'You can develop in your codespace directly in {% data variables.product.prodname_vs %} by connecting with your account on {% data variables.product.product_name %}.' +product: '{% data reusables.gated-features.codespaces %}' +versions: + free-pro-team: '*' +--- + +{% note %} + +**注釈:** {% data variables.product.prodname_codespaces %} は現在限定パブリックベータであり、変更されることがあります。 ベータ期間中、{% data variables.product.prodname_dotcom %}は{% data variables.product.prodname_codespaces %}の可用性について保証しません。 [Sign up for the limited public beta](https://github.com/features/codespaces/signup-vs). ベータへの参加に関する詳しい情報については「[{% data variables.product.prodname_codespaces %}について](/github/developing-online-with-codespaces/about-codespaces#joining-the-beta)」を参照してください。 + +{% endnote %} + +### About Codespaces in {% data variables.product.prodname_vs %} + +You can create a codespace in {% data variables.product.prodname_vs %} to develop applications in a Windows environment. When you use a codespace in {% data variables.product.prodname_vs %}, you can browse source code, build solutions, and commit changes to your repository. + +You must create a codespace in {% data variables.product.prodname_vs %} to use it with the application. Codespaces created outside of {% data variables.product.prodname_vs %} can not currently be used with {% data variables.product.prodname_vs %}. + +### 必要な環境 + +Before you configure a codespace in {% data variables.product.prodname_vs %}, you must download the latest version of [{% data variables.product.prodname_vs %} Preview](https://aka.ms/vspreview). + +#### Enabling the connection between {% data variables.product.prodname_vs %} and {% data variables.product.prodname_github_codespaces %} + +Connecting to {% data variables.product.prodname_github_codespaces %} with the {% data variables.product.prodname_vs %} Preview is not enabled by default, so you will first need to enable the Preview Features option. + +1. In {% data variables.product.prodname_vs %} Preview, use the Tools drop-down menu, then click **Options**. +2. Under **Environment**, select **Preview Features** and check the **Connect to {% data variables.product.prodname_github_codespaces %}** preview feature. ![Check the Connect to {% data variables.product.prodname_github_codespaces %} preview feature](/assets/images/help/codespaces/connect-to-github-codespaces-preview-feature.png) +3. You will need to restart {% data variables.product.prodname_vs %} for the feature to be available. + +### Creating a codespace in {% data variables.product.prodname_vs %} + +1. When you launch {% data variables.product.prodname_vs %}, the Start Window will show a **Connect to a codespace** button under "Get started". ![Visual Studio Start window with Connect to a codespace](/assets/images/help/codespaces/visual-studio-start-window.png) +2. Click **Connect to a codespace**. +3. Click **Sign in to {% data variables.product.prodname_dotcom %}** and follow the prompts, or click **Create one!** to create a new {% data variables.product.prodname_dotcom %} account and sign into the account. ![Visual Studio sign in to {% data variables.product.prodname_dotcom %}](/assets/images/help/codespaces/visual-studio-sign-in-to-github.png) +4. Under "Codespace details", type the repository's URL you want {% data variables.product.prodname_github_codespaces %} to clone into your codespace. +5. Optionally, use the Instance type and Suspend after drop-down menus to configure more codespace details. ![Visual Studio codespace details](/assets/images/help/codespaces/visual-studio-codespace-details.png) +6. Click **Create and Connect**. {% data variables.product.prodname_github_codespaces %} will begin preparing the codespace and open {% data variables.product.prodname_vs %} after the codespace is ready. The codespace name will appear in the remote indicator in the menu. ![Visual Studio connected to eShopOnWeb repository codespace](/assets/images/help/codespaces/visual-studio-eshoponweb-codespace.png) + +### {% data variables.product.prodname_vs %} で codespace を開く + +1. Use the File drop-down menu, and click **Connect to a Codespace**. ![Visual Studio File Connect to a codespace menu item](/assets/images/help/codespaces/visual-studio-file-connect-to-codespace.png) +2. Under "{% data variables.product.prodname_github_codespaces %}", click the codespace you want to connect to, then click **Connect**. ![Visual Studio displaying available codespaces and details](/assets/images/help/codespaces/visual-studio-connect-codespace.png) + +### Configuring a codespace for {% data variables.product.prodname_vs %} + +The default codespace environment created by {% data variables.product.prodname_vs %} includes popular frameworks and tools such as .NET Core, Microsoft SQL Server, Python, and the Windows SDK. {% data variables.product.prodname_github_codespaces %} created with {% data variables.product.prodname_vs %} can be customized through a subset of `devcontainers.json` properties and a new tool called devinit, included with {% data variables.product.prodname_vs %}. + +#### devinit + +The [devinit](https://docs.microsoft.com/visualstudio/devinit/getting-started-with-devinit) command-line tool lets you install additional frameworks and tools into your Windows development codespaces, as well as run PowerShell scripts or modify environment variables. devinit supports a configuration file called [devinit.json](https://docs.microsoft.com/visualstudio/devinit/devinit-json), which can be added to your project for creating customized and repeatable development environments. For more information about Windows codespace configuration and devinit, see [Customize a codespace](https://docs.microsoft.com/visualstudio/ide/codespaces/customize-codespaces) in the {% data variables.product.prodname_vs %} documentation. diff --git a/translations/ja-JP/content/github/extending-github/getting-started-with-the-api.md b/translations/ja-JP/content/github/extending-github/getting-started-with-the-api.md index ad50389641c6..eee6394c4018 100644 --- a/translations/ja-JP/content/github/extending-github/getting-started-with-the-api.md +++ b/translations/ja-JP/content/github/extending-github/getting-started-with-the-api.md @@ -13,5 +13,5 @@ API の詳細については、[GitHub REST API](/rest) および [GitHub GraphQ ### 参考リンク -- [リポジトリのバックアップ](/articles/backing-up-a-repository){% if currentVersion == "free-pro-team@latest" %} +- "[Backing up a repository](/articles/backing-up-a-repository)"{% if currentVersion == "free-pro-team@latest" %} - "[インテグレーションについて](/articles/about-integrations)"{% endif %} diff --git a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md index defb7d667560..ff27712b4928 100644 --- a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md +++ b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md @@ -18,7 +18,7 @@ versions: You can use {% data variables.product.prodname_code_scanning %} to find, triage, and prioritize fixes for existing problems in your code. {% data variables.product.prodname_code_scanning_capc %} also prevents developers from introducing new problems. You can schedule scans for specific days and times, or trigger scans when a specific event occurs in the repository, such as a push. -If {% data variables.product.prodname_code_scanning %} finds a potential vulnerability or error in your code, {% data variables.product.prodname_dotcom %} displays an alert in the repository. After you fix the code that triggered the alert, {% data variables.product.prodname_dotcom %} closes the alert. For more information, see "[Managing alerts from {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." +If {% data variables.product.prodname_code_scanning %} finds a potential vulnerability or error in your code, {% data variables.product.prodname_dotcom %} displays an alert in the repository. After you fix the code that triggered the alert, {% data variables.product.prodname_dotcom %} closes the alert. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." To monitor results from {% data variables.product.prodname_code_scanning %} across your repositories or your organization, you can use the {% data variables.product.prodname_code_scanning %} API. For more information about API endpoints, see "[{% data variables.product.prodname_code_scanning_capc %}](/v3/code-scanning)." diff --git a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md index 26a08d8d18c9..df5c583f1bc5 100644 --- a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md +++ b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md @@ -1,7 +1,7 @@ --- title: About integration with code scanning shortTitle: About integration -intro: 'You can perform {% data variables.product.prodname_code_scanning %} externally and then display the results in {% data variables.product.prodname_dotcom %}.' +intro: 'You can perform {% data variables.product.prodname_code_scanning %} externally and then display the results in {% data variables.product.prodname_dotcom %}, or set up webhooks that listen to {% data variables.product.prodname_code_scanning %} activity in your repository.' product: '{% data reusables.gated-features.code-scanning %}' versions: free-pro-team: '*' @@ -11,12 +11,14 @@ versions: {% data reusables.code-scanning.beta %} {% data reusables.code-scanning.enterprise-enable-code-scanning %} -As an alternative to running {% data variables.product.prodname_code_scanning %} within {% data variables.product.prodname_dotcom %}, you can perform analysis elsewhere and then upload the results. Alerts for {% data variables.product.prodname_code_scanning %} that you run externally are displayed in the same way as those for {% data variables.product.prodname_code_scanning %} that you run within {% data variables.product.prodname_dotcom %}. For more information, see "[Managing alerts from code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." - -You can use your continuous integration or continuous delivery/deployment (CI/CD) system to run {% data variables.product.prodname_dotcom %}'s {% data variables.product.prodname_codeql %} analysis and upload the results to {% data variables.product.prodname_dotcom %}. This is an alternative to using {% data variables.product.prodname_actions %} to run {% data variables.product.prodname_codeql %} analysis. For more information, see "[Running code scanning in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)." +As an alternative to running {% data variables.product.prodname_code_scanning %} within {% data variables.product.prodname_dotcom %}, you can perform analysis elsewhere and then upload the results. Alerts for {% data variables.product.prodname_code_scanning %} that you run externally are displayed in the same way as those for {% data variables.product.prodname_code_scanning %} that you run within {% data variables.product.prodname_dotcom %}. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." If you use a third-party static analysis tool that can produce results as Static Analysis Results Interchange Format (SARIF) 2.1.0 data, you can upload this to {% data variables.product.prodname_dotcom %}. 詳しい情報については、「[SARIF ファイルを GitHub にアップロードする](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)」を参照してください。 +### Integrations with webhooks + +You can use {% data variables.product.prodname_code_scanning %} webhooks to build or set up integrations, such as [{% data variables.product.prodname_github_app %}s](/apps/building-github-apps/) or [{% data variables.product.prodname_oauth_app %}s](/apps/building-oauth-apps/), that subscribe to {% data variables.product.prodname_code_scanning %} events in your repository. For example, you could build an integration that creates an issue on {% data variables.product.product_location %} or sends you a Slack notification when a new {% data variables.product.prodname_code_scanning %} alert is added in your repository. For more information, see "[Creating webhooks](/developers/webhooks-and-events/creating-webhooks)" and "[Webhook events and payloads](/developers/webhooks-and-events/webhook-events-and-payloads#code_scanning_alert)." + ### 参考リンク * "[About code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)" diff --git a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md index 48af4642925c..16121a50dc8d 100644 --- a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md +++ b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md @@ -3,6 +3,7 @@ title: コードの脆弱性とエラーを自動的にスキャンする shortTitle: 自動的にスキャンする intro: 'プロジェクトのコードの脆弱性とエラーは、{% data variables.product.prodname_dotcom %} で確認できます。' mapTopic: true +product: '{% data reusables.gated-features.code-scanning %}' versions: free-pro-team: '*' enterprise-server: '>=2.22' diff --git a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md index 334e13ba4db4..af2300e7a3c5 100644 --- a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md +++ b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md @@ -1,8 +1,8 @@ --- -title: コードスキャンを設定する -intro: '{% data variables.product.prodname_dotcom %} がプロジェクトのコードをスキャンして脆弱性やエラーを検出する方法を設定できます。' +title: Configuring code scanning +intro: 'You can configure how {% data variables.product.prodname_dotcom %} scans the code in your project for vulnerabilities and errors.' product: '{% data reusables.gated-features.code-scanning %}' -permissions: 'リポジトリへの書き込み権限を持つユーザは、リポジトリの {% data variables.product.prodname_code_scanning %} を設定できます。' +permissions: 'People with write permissions to a repository can configure {% data variables.product.prodname_code_scanning %} for the repository.' miniTocMaxHeadingLevel: 4 versions: free-pro-team: '*' @@ -12,63 +12,66 @@ versions: {% data reusables.code-scanning.beta %} {% data reusables.code-scanning.enterprise-enable-code-scanning-actions %} +### About {% data variables.product.prodname_code_scanning %} configuration -### {% data variables.product.prodname_code_scanning %} の設定について +You can run {% data variables.product.prodname_code_scanning %} within {% data variables.product.product_location %}, using {% data variables.product.prodname_actions %}, or from your continuous integration (CI) system, using the {% data variables.product.prodname_codeql_runner %}. For more information about {% data variables.product.prodname_actions %}, see "[About {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)." For more information about the {% data variables.product.prodname_codeql_runner %}, see "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)." -You can run {% data variables.product.prodname_code_scanning %} within {% data variables.product.product_location %}, using {% data variables.product.prodname_actions %}, or from your continuous integration (CI) system, using the {% data variables.product.prodname_codeql_runner %}. {% data variables.product.prodname_actions %} に関する詳しい情報については、「[{% data variables.product.prodname_actions %} について](/actions/getting-started-with-github-actions/about-github-actions)」を参照してください。 For more information about the {% data variables.product.prodname_codeql_runner %}, see "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)." +This article is about running {% data variables.product.prodname_code_scanning %} within {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_ghe_server %}{% else %}{% data variables.product.prodname_dotcom %}{% endif %}. -次のクエリスイートは {% data variables.product.prodname_code_scanning %} に組み込まれており、設定ファイルで使用できます。 - -リポジトリに {% data variables.product.prodname_code_scanning %} を設定する前に、リポジトリに {% data variables.product.prodname_actions %} ワークフローを追加して {% data variables.product.prodname_code_scanning %} を有効にする必要があります。 デフォルトの {% data variables.product.prodname_code_scanning %} ワークフローは、`on.push` イベントを使用して、ワークフローファイルを含むブランチへのプッシュごとにコードスキャンをトリガーします。 +Before you can configure {% data variables.product.prodname_code_scanning %} for a repository, you must enable {% data variables.product.prodname_code_scanning %} by adding a {% data variables.product.prodname_actions %} workflow to the repository. For more information, see "[Enabling {% data variables.product.prodname_code_scanning %} for a repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository)." {% data reusables.code-scanning.edit-workflow %} {% data variables.product.prodname_codeql %} analysis is just one type of {% data variables.product.prodname_code_scanning %} you can do in {% data variables.product.prodname_dotcom %}. {% data variables.product.prodname_marketplace %}{% if currentVersion ver_gt "enterprise-server@2.21" %} on {% data variables.product.prodname_dotcom_the_website %}{% endif %} contains other {% data variables.product.prodname_code_scanning %} workflows you can use. {% if currentVersion == "free-pro-team@latest" %}You can find a selection of these on the "Get started with {% data variables.product.prodname_code_scanning %}" page, which you can access from the **{% octicon "shield" aria-label="The shield symbol" %} Security** tab.{% endif %} The specific examples given in this article relate to the {% data variables.product.prodname_codeql_workflow %} file. -### Editing a code scanning workflow +### Editing a {% data variables.product.prodname_code_scanning %} workflow -{% data variables.product.prodname_dotcom %} は、リポジトリの _.github/workflows_ ディレクトリにワークフローファイルを保存します。 You can find the workflow by searching for its file name. For example, the default workflow file for CodeQL code scanning is called `codeql-analysis.yml`. +{% data variables.product.prodname_dotcom %} saves workflow files in the _.github/workflows_ directory of your repository. You can find a workflow you have enabled by searching for its file name. For example, by default, the workflow file for {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} is called _codeql-analysis.yml_. -1. リポジトリで、編集したいワークフローファイルにアクセスします。 -1. ファイルビューの右上隅の {% octicon "pencil" aria-label="The edit icon" %}をクリックしてワークフローエディタを開きます。 ![ワークフローファイルの編集ボタン](/assets/images/help/repository/code-scanning-edit-workflow-button.png) -1. ファイルを編集したら、[**Start commit**] をクリックして、[Commit changes] フォームに入力します。 現在のブランチに直接コミットするか、新しいブランチを作成してプルリクエストを開始するかを選択できます。 ![codeql.yml ワークフローの更新をコミットする](/assets/images/help/repository/code-scanning-workflow-update.png) +1. In your repository, browse to the workflow file you want to edit. +1. In the upper right corner of the file view, to open the workflow editor, click {% octicon "pencil" aria-label="The edit icon" %}. +![Edit workflow file button](/assets/images/help/repository/code-scanning-edit-workflow-button.png) +1. After you have edited the file, click **Start commit** and complete the "Commit changes" form. You can choose to commit directly to the current branch, or create a new branch and start a pull request. +![Commit update to codeql.yml workflow](/assets/images/help/repository/code-scanning-workflow-update.png) -ワークフローファイルの編集に関する詳細な情報については「[ワークフローの設定](/actions/configuring-and-managing-workflows/configuring-a-workflow)」を参照してください。 +For more information about editing workflow files, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." -### 頻度を設定する +### Configuring frequency -スケジュール設定されているときや、リポジトリで特定のイベントが発生したときに、コードをスキャンできます。 +You can configure the {% data variables.product.prodname_codeql_workflow %} to scan code on a schedule or when specific events occur in a repository. -リポジトリへのプッシュごと、およびプルリクエストが作成されるたびにコードをスキャンすることで、開発者がコードに新しい脆弱性やエラーをもたらすことを防ぎます。 スケジュールに従ってコードをスキャンすると、開発者がリポジトリを積極的に維持していない場合でも、{% data variables.product.company_short %}、セキュリティ研究者、コミュニティが発見した最新の脆弱性とエラーが通知されます。 +Scanning code when someone pushes a change, and whenever a pull request is created, prevents developers from introducing new vulnerabilities and errors into the code. Scanning code on a schedule informs you about the latest vulnerabilities and errors that {% data variables.product.company_short %}, security researchers, and the community discover, even when developers aren't actively maintaining the repository. -#### プッシュ時にスキャンする +#### Scanning on push -デフォルトのワークフローを使用する場合、{% data variables.product.prodname_code_scanning %} は、イベントによってトリガーされるスキャンに加えて、リポジトリ内のコードを週に1回スキャンします。 このスケジュールを調整するには、ワークフローで `cron` 値を編集します。 詳細については、「[{% data variables.product.prodname_actions %}のワークフロー構文](/actions/reference/workflow-syntax-for-github-actions#on)」を参照してください。 +By default, the {% data variables.product.prodname_codeql_workflow %} uses the `on.push` event to trigger a code scan on every push to the default branch of the repository and any protected branches. For {% data variables.product.prodname_code_scanning %} to be triggered on a specified branch, the workflow must exist in that branch. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#on)." -#### プルリクエストをスキャンする +#### Scanning pull requests -**注釈**: {% data variables.product.prodname_code_scanning %} 設定ファイルのコンテキストで使用される `paths` および `paths-ignore` キーワードを `on..paths` で使用する場合、同じキーワードと混同しないでください。 ワークフローファイルの `on.` を変更するときに使用する場合、指定されたディレクトリのコードの変更時にアクションが実行されるかどうかを決定します。 詳細については、「[{% data variables.product.prodname_actions %}のワークフロー構文](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)」を参照してください。 +The default {% data variables.product.prodname_codeql_workflow %} uses the `pull_request` event to trigger a code scan on the `HEAD` commit of a pull request against the default branch. {% if currentVersion ver_gt "enterprise-server@2.21" %}The `pull_request` event is not triggered if the pull request was opened from a private fork.{% else %}If a pull request is from a private fork, the `pull_request` event will only be triggered if you've selected the "Run workflows from fork pull requests" option in the repository settings. For more information, see "[Disabling or limiting {% data variables.product.prodname_actions %} for a repository](/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository#enabling-workflows-for-private-repository-forks)."{% endif %} -`pull_request` イベントに関する詳しい情報については、「"[{% data variables.product.prodname_actions %}のためのワークフローの構文](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)」を参照してください。 +For more information about the `pull_request` event, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)." -#### スケジュールに従ってスキャンする +#### Scanning on a schedule -デフォルトの {% data variables.product.prodname_code_scanning %} ワークフローは、`pull_request` イベントを使用して、プルリクエストの `HEAD` コミットでコードスキャンをトリガーします。 このスケジュールを調整するには、ワークフローで `cron` 値を編集します。 詳細については、「[{% data variables.product.prodname_actions %}のワークフロー構文](/actions/reference/workflow-syntax-for-github-actions#onschedule)」を参照してください。 +If you use the default {% data variables.product.prodname_codeql_workflow %}, the workflow will scan the code in your repository once a week, in addition to the scans triggered by events. To adjust this schedule, edit the `cron` value in the workflow. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onschedule)." {% note %} -**注釈**: {% data variables.product.prodname_dotcom %} は、デフォルトのブランチのワークフローにあるスケジュール設定されたジョブのみを実行します。 他のブランチのワークフローでスケジュールを変更しても、ブランチをデフォルトブランチにマージするまで影響はありません。 +**Note**: {% data variables.product.prodname_dotcom %} only runs scheduled jobs that are in workflows on the default branch. Changing the schedule in a workflow on any other branch has no effect until you merge the branch into the default branch. {% endnote %} -#### サンプル +#### Example The following example shows a {% data variables.product.prodname_codeql_workflow %} for a particular repository that has a default branch called `main` and one protected branch called `protected`. ``` yaml on: push: + branches: [main, protected] pull_request: + branches: [main] schedule: - cron: '0 15 * * 0' ``` @@ -78,9 +81,11 @@ This workflow scans: * Every pull request to the default branch * The default branch at 3 P.M. every Sunday -### オペレーティングシステムを指定する +### Specifying an operating system + +If your code requires a specific operating system to compile, you can configure the operating system in your {% data variables.product.prodname_codeql_workflow %}. Edit the value of `jobs.analyze.runs-on` to specify the operating system for the machine that runs your {% data variables.product.prodname_code_scanning %} actions. {% if currentVersion ver_gt "enterprise-server@2.21" %}You specify the operating system by using an appropriate label as the second element in a two-element array, after `self-hosted`.{% else %} -If your code requires a specific operating system to compile, you can configure the operating system in your {% data variables.product.prodname_codeql_workflow %}. `jobs..runs-on` の値を編集して、{% data variables.product.prodname_code_scanning %} のアクションを実行するマシンのオペレーティングシステムを指定します。 {% if currentVersion ver_gt "enterprise-server@2.21" %}You specify the operating system by using an appropriate label as the second element in a two-element array, after `self-hosted`. +If you choose to use a self-hosted runner for code scanning, you can specify an operating system by using an appropriate label as the second element in a two-element array, after `self-hosted`.{% endif %} ``` yaml jobs: @@ -88,59 +93,122 @@ jobs: name: Analyze runs-on: [self-hosted, ubuntu-latest] ``` -{% endif %} -{% data variables.product.prodname_code_scanning_capc %} は、macOS、Ubuntu、Windows の最新バージョンをサポートしています。 Typical values for this setting are therefore: `ubuntu-latest`, `windows-latest`, and `macos-latest`. For more information, see {% if currentVersion ver_gt "enterprise-server@2.21" %}"[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#self-hosted-runners)" and "[Using labels with self-hosted runners](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners){% else %}"[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on){% endif %}." +{% if currentVersion == "free-pro-team@latest" %}For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners)" and "[Adding self-hosted runners](/actions/hosting-your-own-runners/adding-self-hosted-runners)."{% endif %} + +{% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} supports the latest versions of Ubuntu, Windows, and macOS. Typical values for this setting are therefore: `ubuntu-latest`, `windows-latest`, and `macos-latest`. For more information, see {% if currentVersion ver_gt "enterprise-server@2.21" %}"[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#self-hosted-runners)" and "[Using labels with self-hosted runners](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners){% else %}"[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on){% endif %}." -### 自動言語検出をオーバーライドする +{% if currentVersion ver_gt "enterprise-server@2.21" %}You must ensure that Git is in the PATH variable on your self-hosted runners.{% else %}If you use a self-hosted runner, you must ensure that Git is in the PATH variable.{% endif %} -{% data reusables.code-scanning.autobuild-add-build-steps %} For more information about how to configure {% data variables.product.prodname_code_scanning %} for compiled languages, see "[Configuring {% data variables.product.prodname_code_scanning %} for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages)." +### Changing the languages that are analyzed + +{% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} automatically detects code written in the supported languages. {% data reusables.code-scanning.supported-languages %} +The default {% data variables.product.prodname_codeql_workflow %} file contains a build matrix called `language` which lists the languages in your repository that are analyzed. {% data variables.product.prodname_codeql %} automatically populates this matrix when you add {% data variables.product.prodname_code_scanning %} to a repository. Using the `language` matrix optimizes {% data variables.product.prodname_codeql %} to run each analysis in parallel. We recommend that all workflows adopt this configuration due to the performance benefits of parallelizing builds. For more information about build matrices, see "[Managing complex workflows](/actions/learn-github-actions/managing-complex-workflows#using-a-build-matrix)." + {% data reusables.code-scanning.specify-language-to-analyze %} -自動言語検出をオーバーライドするには、ワークフローの `init` アクションに `with:languages:` を追加します。 サポートされている言語のキーワードは、`cpp`、`csharp`、`go`、`java`、`JavaScript`、および `python` です。 +If your workflow uses the `language` matrix then {% data variables.product.prodname_codeql %} is hardcoded to analyze only the languages in the matrix. To change the languages you want to analyze, edit the value of the matrix variable. You can remove a language to prevent it being analyzed or you can add a language that was not present in the repository when {% data variables.product.prodname_code_scanning %} was enabled. For example, if the repository initially only contained JavaScript when {% data variables.product.prodname_code_scanning %} was enabled, and you later added Python code, you will need to add `python` to the matrix. -たとえば、次の設定では、{% data variables.product.prodname_code_scanning %} をC/C++、C#、および Python に制限しています。 +```yaml +jobs: + analyze: + name: Analyze + ... + strategy: + fail-fast: false + matrix: + language: ['javascript', 'python'] +``` + +If your workflow does not contain a matrix called `language`, then {% data variables.product.prodname_codeql %} is configured to run analysis sequentially. If you don't specify languages in the workflow, {% data variables.product.prodname_codeql %} automatically detects, and attempts to analyze, any supported languages in the repository. If you want to choose which languages to analyze, without using a matrix, you can use the `languages` parameter under the `init` action. -``` yaml +```yaml - uses: github/codeql-action/init@v1 with: languages: cpp, csharp, python -``` +``` +{% if currentVersion == "free-pro-team@latest" %} +### Analyzing Python dependencies -### 追加のクエリを実行する +For GitHub-hosted runners that use Linux only, the {% data variables.product.prodname_codeql_workflow %} will try to auto-install Python dependencies to give more results for the CodeQL analysis. You can control this behavior by specifying the `setup-python-dependencies` parameter for the action called by the "Initialize CodeQL" step. By default, this parameter is set to `true`: + +- If the repository contains code written in Python, the "Initialize CodeQL" step installs the necessary dependencies on the GitHub-hosted runner. If the auto-install succeeds, the action also sets the environment variable `CODEQL_PYTHON` to the Python executable file that includes the dependencies. + +- If the repository doesn't have any Python dependencies, or the dependencies are specified in an unexpected way, you'll get a warning and the action will continue with the remaining jobs. The action can run successfully even when there are problems interpreting dependencies, but the results may be incomplete. + +Alternatively, you can install Python dependencies manually on any operating system. You will need to add `setup-python-dependencies` and set it to `false`, as well as set `CODEQL_PYTHON` to the Python executable that includes the dependencies, as shown in this workflow extract: + +```yaml +jobs: + CodeQL-Build: + + runs-on: ubuntu-latest + + steps: + - name: Checkout repository + uses: actions/checkout@v2 + with: + fetch-depth: 2 + - name: Set up Python + uses: actions/setup-python@v2 + with: + python-version: '3.x' + - name: Install dependencies + run: | + python -m pip install --upgrade pip + if [ -f requirements.txt ]; + then pip install -r requirements.txt; + fi + # Set the `CODEQL-PYTHON` environment variable to the Python executable + # that includes the dependencies + echo "::set-env name=CODEQL_PYTHON::$(which python)" + - run: git checkout HEAD^2 + if: ${{ github.event_name == 'pull_request' }} + - name: Initialize CodeQL + uses: github/codeql-action/init@v1 + with: + languages: python + # Override the default behavior so that the action doesn't attempt + # to auto-install Python dependencies + setup-python-dependencies: false +``` +{% endif %} + +### Running additional queries {% data reusables.code-scanning.run-additional-queries %} -1つ以上のクエリスイートを追加するには、設定ファイルに `queries` セクションを追加します。 +To add one or more queries, add a `with: queries:` entry within the `uses: github/codeql-action/init@v1` section of the workflow. ``` yaml - uses: github/codeql-action/init@v1 with: - - queries: COMMA-SEPARATED LIST OF PATHS + queries: COMMA-SEPARATED LIST OF PATHS ``` -設定ファイルでこれらを指定して、追加のクエリスイートを実行することもできます。 クエリスイートはクエリのコレクションであり、通常は目的または言語ごとにグループ化されています。 +You can also specify query suites in the value of `queries`. Query suites are collections of queries, usually grouped by purpose or language. {% data reusables.code-scanning.codeql-query-suites %} -If you are also using a configuration file for custom settings, any additional queries specified in your workflow are used instead of any specified in the configuration file. If you want to run the combined set of additional queries specified here and in the configuration file, prefix the value of `queries` in the workflow with the `+` symbol. 設定ファイルの例については、「[Example configuration files](#example-configuration-files)」を参照してください。 +If you are also using a configuration file for custom settings, any additional queries specified in your workflow are used instead of any specified in the configuration file. If you want to run the combined set of additional queries specified here and in the configuration file, prefix the value of `queries` in the workflow with the `+` symbol. For more information, see "[Using a custom configuration file](#using-a-custom-configuration-file)." In the following example, the `+` symbol ensures that the specified additional queries are used together with any queries specified in the referenced configuration file. ``` yaml -queries: - - name: DESCRIPTION OF YOUR CHOICE - uses: PATH +- uses: github/codeql-action/init@v1 + with: + config-file: ./.github/codeql/codeql-config.yml + queries: +security-and-quality,octo-org/python-qlpack/show_ifs.ql@main ``` -### サードパーティのコードスキャンツールを使用する +### Using a custom configuration file As an alternative to specifying which queries to run in the workflow file, you can do this in a separate configuration file. You can also use a configuration file to disable the default queries and to specify which directories to scan during analysis. -In the workflow file, use the `config-file` parameter of the `init` action to specify the path to the configuration file you want to use. この例では、設定ファイル _./.github/codeql/codeql-config.yml_ を読み込みます。 +In the workflow file, use the `config-file` parameter of the `init` action to specify the path to the configuration file you want to use. This example loads the configuration file _./.github/codeql/codeql-config.yml_. ``` yaml - uses: github/codeql-action/init@v1 @@ -148,8 +216,8 @@ In the workflow file, use the `config-file` parameter of the `init` action to sp config-file: ./.github/codeql/codeql-config.yml ``` -The configuration file can be located within the local repository, or in a public, remote repository. リモートリポジトリの場合は、_owner/repository/file.yml@branch_ 構文を使用できます。 The settings in the file are written in YAML format. - +The configuration file can be located within the local repository, or in a public, remote repository. For remote repositories, you can use the _owner/repository/file.yml@branch_ syntax. The settings in the file are written in YAML format. + #### Specifying additional queries You specify additional queries in a `queries` array. Each element of the array contains a `uses` parameter with a value that identifies a single query file, a directory containing query files, or a query suite definition file. @@ -165,11 +233,11 @@ Optionally, you can give each array element a name, as shown in the example conf For more information about additional queries, see "[Running additional queries](#running-additional-queries)" above. -#### デフォルトのクエリを無効にする +#### Disabling the default queries -カスタムクエリのみを実行する場合は、構成ファイルに `disable-default-queries: true` を追加して、デフォルトのセキュリティクエリを無効にすることができます。 +If you only want to run custom queries, you can disable the default security queries by using `disable-default-queries: true`. -#### スキャンするディレクトリを指定する +#### Specifying directories to scan For the interpreted languages that {% data variables.product.prodname_codeql %} supports (Python and JavaScript/TypeScript), you can restrict {% data variables.product.prodname_code_scanning %} to files in specific directories by adding a `paths` array to the configuration file. You can exclude the files in specific directories from scans by adding a `paths-ignore` array. @@ -183,37 +251,37 @@ paths-ignore: {% note %} -**ノート**: +**Note**: -* The `paths` and `paths-ignore` keywords, used in the context of the {% data variables.product.prodname_code_scanning %} configuration file, should not be confused with the same keywords when used for `on..paths` in a workflow. When they are used to modify `on.` in a workflow, they determine whether the actions will be run when someone modifies code in the specified directories. 詳細については、「[{% data variables.product.prodname_actions %}のワークフロー構文](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)」を参照してください。 -* `**` **Note**: `**` characters can only be at the start or end of a line, or surrounded by slashes, and you can't mix `**` and other characters. たとえば、`foo/**`、`**/foo`、および `foo/**/bar` はすべて使用できる構文ですが、`**foo` は使用できません。 ただし、例に示すように、単一の * を他の文字と一緒に使用できます。 You'll need to quote anything that contains a `*` character. +* The `paths` and `paths-ignore` keywords, used in the context of the {% data variables.product.prodname_code_scanning %} configuration file, should not be confused with the same keywords when used for `on..paths` in a workflow. When they are used to modify `on.` in a workflow, they determine whether the actions will be run when someone modifies code in the specified directories. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)." +* `**` characters can only be at the start or end of a line, or surrounded by slashes, and you can't mix `**` and other characters. For example, `foo/**`, `**/foo`, and `foo/**/bar` are all allowed syntax, but `**foo` isn't. However you can use single stars along with other characters, as shown in the example. You'll need to quote anything that contains a `*` character. {% endnote %} -C/C++、C#、および Java の場合、{% data variables.product.prodname_code_scanning %} をプロジェクトの特定のディレクトリに制限するには、ワークフローで適切なビルドステップを指定する必要があります。 ビルドからディレクトリを除外するために使用するコマンドは、ビルドシステムによって異なります。 For more information, see "[Configuring the {% data variables.product.prodname_codeql %} action for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages#adding-build-steps-for-a-compiled-language)." +For C/C++, C#, and Java, if you want to limit {% data variables.product.prodname_code_scanning %} to specific directories in your project, you must specify appropriate build steps in the workflow. The commands you need to use to exclude a directory from the build will depend on your build system. For more information, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." -特定のディレクトリのコードを変更すると、monorepo の一部をすばやく分析できます。 ビルドステップでディレクトリを除外し、ワークフローファイルで [`on.`](https://help.github.com/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths) の`paths-ignore` および `paths` キーワードを使用する必要があります。 +You can quickly analyze small portions of a monorepo when you modify code in specific directories. You'll need to both exclude directories in your build steps and use the `paths-ignore` and `paths` keywords for [`on.`](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths) in your workflow. -#### 設定ファイルの例 +#### Example configuration files {% data reusables.code-scanning.example-configuration-files %} -### コンパイルされた言語の {% data variables.product.prodname_code_scanning %} を設定する +### Configuring {% data variables.product.prodname_code_scanning %} for compiled languages -{% data reusables.code-scanning.autobuild-compiled-languages %} +{% data reusables.code-scanning.autobuild-compiled-languages %} {% data reusables.code-scanning.analyze-go %} -{% data reusables.code-scanning.autobuild-add-build-steps %} For more information about how to configure {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} for compiled languages, see "[Configuring the {% data variables.product.prodname_codeql %} action for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages)." +{% data reusables.code-scanning.autobuild-add-build-steps %} For more information about how to configure {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} for compiled languages, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages)." -### プライベートリポジトリにアクセスする +### Accessing private repositories -{% data variables.product.prodname_code_scanning %} のワークフローが {% data variables.product.prodname_dotcom %} のプライベートリポジトリにアクセスする場合は、個人アクセストークンを使用して認証するように Git を設定する必要があります。 {% data variables.product.prodname_codeql %} アクションの前にワークフローで `jobs..steps.env` を使用して、ランナー環境でシークレットを定義します。 詳しい情報については、「[コマンドライン用の個人アクセストークンを作成する](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)」および「[暗号化されたシークレットの作成と保存](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)」を参照してください。 +If your workflow for {% data variables.product.prodname_code_scanning %} accesses a private repository, other than the repository that contains the workflow, you'll need to configure Git to authenticate with a personal access token. Define the secret in the runner environment by using `jobs..steps.env` in your workflow before any {% data variables.product.prodname_codeql %} actions. For more information, see "[Creating a personal access token for the command line](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)" and "[Creating and storing encrypted secrets](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)." -たとえば、次の設定では、Git が {% data variables.product.prodname_dotcom_the_website %} の `github/foo`、`github/bar`、`github/baz` リポジトリへの完全な URL を、`ACCESS_TOKEN` 環境変数に保存した個人アクセストークンを含む URL に置き換えます。 +For example, the following configuration has Git replace the full URLs to the `github/foo`, `github/bar`, and `github/baz` repositories on {% data variables.product.prodname_dotcom_the_website %} with URLs that include the personal access token that you store in the `ACCESS_TOKEN` environment variable. {% raw %} ```yaml steps: -- name: Configure access to private repository on GitHub.com +- name: Configure access to private repositories env: TOKEN: ${{ secrets.ACCESS_TOKEN }} run: | @@ -223,6 +291,6 @@ steps: ``` {% endraw %} -### {% data variables.product.prodname_code_scanning %} 用の設定ファイルを作成できます。 +### Uploading {% data variables.product.prodname_code_scanning %} data to {% data variables.product.prodname_dotcom %} -{% data variables.product.prodname_dotcom %} can display code analysis data generated externally by a third-party tool. ワークフローに `upload-sarif` アクションを追加することで、{% data variables.product.prodname_dotcom %} のサードパーティツールからのコード分析を表示できます。 詳しい情報については、「[SARIF ファイルを GitHub にアップロードする](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)」を参照してください。 +{% data variables.product.prodname_dotcom %} can display code analysis data generated externally by a third-party tool. You can upload code analysis data with the `upload-sarif` action. For more information, see "[Uploading a SARIF file to GitHub](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)." diff --git a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md new file mode 100644 index 000000000000..68d69e005ae7 --- /dev/null +++ b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md @@ -0,0 +1,165 @@ +--- +title: Configuring CodeQL code scanning in your CI system +shortTitle: Configuring in your CI +intro: 'You can configure how the {% data variables.product.prodname_codeql_runner %} scans the code in your project and uploads the results to {% data variables.product.prodname_dotcom %}.' +product: '{% data reusables.gated-features.code-scanning %}' +miniTocMaxHeadingLevel: 4 +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-in-your-ci-system +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta-codeql-runner %} +{% data reusables.code-scanning.beta %} +{% data reusables.code-scanning.enterprise-enable-code-scanning %} + +### About configuring {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in your CI system + +To integrate {% data variables.product.prodname_code_scanning %} into your CI system, you can use the {% data variables.product.prodname_codeql_runner %}. For more information, see "[Running {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)." + +In general, you invoke the {% data variables.product.prodname_codeql_runner %} as follows. + +``` +$ /path/to-runner/codeql-runner-OS +``` + +`/path/to-runner/` depends on where you've downloaded the {% data variables.product.prodname_codeql_runner %} on your CI system. `codeql-runner-OS` depends on the operating system you use. There are three versions of the {% data variables.product.prodname_codeql_runner %}, `codeql-runner-linux`, `codeql-runner-macos`, and `codeql-runner-win`, for Linux, macOS, and Windows systems respectively. + +To customize the way the {% data variables.product.prodname_codeql_runner %} scans your code, you can use flags, such as `--languages` and `--queries`, or you can specify custom settings in a separate configuration file. + +### 自動言語検出をオーバーライドする + +The {% data variables.product.prodname_codeql_runner %} automatically detects and scans code written in the supported languages. + +{% data reusables.code-scanning.supported-languages %} + +{% data reusables.code-scanning.specify-language-to-analyze %} + +To override automatic language detection, run the `init` command with the `--languages` flag, followed by a comma-separated list of language keywords. サポートされている言語のキーワードは、`cpp`、`csharp`、`go`、`java`、`JavaScript`、および `python` です。 + +``` +$ /path/to-runner/codeql-runner-linux init --languages cpp,java +``` + +### 追加のクエリを実行する + +{% data reusables.code-scanning.run-additional-queries %} + +{% data reusables.code-scanning.codeql-query-suites %} + +To add one or more queries, pass a comma-separated list of paths to the `--queries` flag of the `init` command. You can also specify additional queries in a configuration file. + +If you also are using a configuration file for custom settings, and you are also specifying additional queries with the `--queries` flag, the {% data variables.product.prodname_codeql_runner %} uses the additional queries specified with the `--queries` flag instead of any in the configuration file. If you want to run the combined set of additional queries specified with the flag and in the configuration file, prefix the value passed to `--queries` with the `+` symbol. 設定ファイルの例については、「[Example configuration files](#example-configuration-files)」を参照してください。 + +In the following example, the `+` symbol ensures that the {% data variables.product.prodname_codeql_runner %} uses the additional queries together with any queries specified in the referenced configuration file. + +``` +$ /path/to-runner/codeql-runner-linux init --config-file .github/codeql/codeql-config.yml + --queries +security-and-quality,octo-org/python-qlpack/show_ifs.ql@main +``` + +### サードパーティのコードスキャンツールを使用する + +Instead of passing additional information to the {% data variables.product.prodname_codeql_runner %} commands, you can specify custom settings in a separate configuration file. + +The configuration file is a YAML file. It uses syntax similar to the workflow syntax for {% data variables.product.prodname_actions %}, as illustrated in the examples below. 詳細については、「[{% data variables.product.prodname_actions %}のワークフロー構文](/actions/reference/workflow-syntax-for-github-actions)」を参照してください。 + +Use the `--config-file` flag of the `init` command to specify the configuration file. The value of `--config-file` is the path to the configuration file that you want to use. This example loads the configuration file _.github/codeql/codeql-config.yml_. + +``` +$ /path/to-runner/codeql-runner-linux init --config-file .github/codeql/codeql-config.yml +``` + +#### 設定ファイルの例 + +{% data reusables.code-scanning.example-configuration-files %} + +### コンパイルされた言語の {% data variables.product.prodname_code_scanning %} を設定する + +For the compiled languages C/C++, C#, and Java, {% data variables.product.prodname_codeql %} builds the code before analyzing it. {% data reusables.code-scanning.analyze-go %} + +For many common build systems, the {% data variables.product.prodname_codeql_runner %} can build the code automatically. To attempt to build the code automatically, run `autobuild` between the `init` and `analyze` steps. Note that if your repository requires a specific version of a build tool, you may need to install the build tool manually first. + +The `autobuild` process only ever attempts to build _one_ compiled language for a repository. The language automatically selected for analysis is the language with the most files. If you want to choose a language explicitly, use the `--language` flag of the `autobuild` command. + +``` +$ /path/to-runner/codeql-runner-linux autobuild --language csharp +``` + +If the `autobuild` command can't build your code, you can run the build steps yourself, between the `init` and `analyze` steps. For more information, see "[Running {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system#compiled-language-example)." + +### {% data variables.product.prodname_code_scanning %} 用の設定ファイルを作成できます。 + +By default, the {% data variables.product.prodname_codeql_runner %} uploads results from {% data variables.product.prodname_code_scanning %} when you run the `analyze` command. You can also upload SARIF files separately, by using the `upload` command. + +Once you've uploaded the data, {% data variables.product.prodname_dotcom %} displays the alerts in your repository. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository#viewing-an-alert)." + +### {% data variables.product.prodname_codeql_runner %} command reference + +The {% data variables.product.prodname_codeql_runner %} supports the following commands and flags. + +#### `init` + +Initializes the {% data variables.product.prodname_codeql_runner %} and creates a {% data variables.product.prodname_codeql %} database for each language to be analyzed. + +| Flag | 必須 | Input value | +| -------------------------------- |:--:| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `--repository` | ✓ | Name of the repository to initialize. | +| `--github-url` | ✓ | URL of the {% data variables.product.prodname_dotcom %} instance where your repository is hosted. | +| `--github-auth` | ✓ | A {% data variables.product.prodname_github_apps %} token or personal access token. | +| `--languages` | | Comma-separated list of languages to analyze. By default, the {% data variables.product.prodname_codeql_runner %} detects and analyzes all supported languages in the repository. | +| `--queries` | | Comma-separated list of additional queries to run, in addition to the default suite of security queries. | +| `--config-file` | | Path to custom configuration file. | +| `--codeql-path` | | Path to a copy of the {% data variables.product.prodname_codeql %} CLI executable to use. By default, the {% data variables.product.prodname_codeql_runner %} downloads a copy. | +| `--temp-dir` | | Directory where temporary files are stored. The default is _./codeql-runner_. | +| `--tools-dir` | | Directory where {% data variables.product.prodname_codeql %} tools and other files are stored between runs. The default is a subdirectory of the home directory. | +| `--checkout-path` | | The path to the checkout of your repository. The default is the current working directory. | +| `--debug` | | なし. Prints more verbose output. | +| `-h`, `--help` | | なし. Displays help for the command. | + +#### `autobuild` + +Attempts to build the code for the compiled languages C/C++, C#, and Java. For those languages, {% data variables.product.prodname_codeql %} builds the code before analyzing it. Run `autobuild` between the `init` and `analyze` steps. + +| Flag | 必須 | Input value | +| --------------------------- |:--:| ---------------------------------------------------------------------------------------------------------------------------------------------- | +| `--language` | | The language to build. By default, the {% data variables.product.prodname_codeql_runner %} builds the compiled language with the most files. | +| `--temp-dir` | | Directory where temporary files are stored. The default is _./codeql-runner_. | +| `--debug` | | なし. Prints more verbose output. | +| `-h`, `--help` | | なし. Displays help for the command. | + +#### `analyze` + +Analyzes the code in the {% data variables.product.prodname_codeql %} databases and uploads results to {% data variables.product.product_location %}. + +| Flag | 必須 | Input value | +| -------------------------------- |:--:| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `--repository` | ✓ | Name of the repository to analyze. | +| `--commit` | ✓ | SHA of the commit to analyze. In Git and in Azure DevOps, this corresponds to the value of `git rev-parse HEAD`. In Jenkins, this corresponds to `$GIT_COMMIT`. | +| `--ref` | ✓ | Name of the reference to analyze, for example `refs/heads/main`. In Git and in Jenkins, this corresponds to the value of `git symbolic-ref HEAD`. In Azure DevOps, this corresponds to `$(Build.SourceBranch)`. | +| `--github-url` | ✓ | URL of the {% data variables.product.prodname_dotcom %} instance where your repository is hosted. | +| `--github-auth` | ✓ | A {% data variables.product.prodname_github_apps %} token or personal access token. | +| `--checkout-path` | | The path to the checkout of your repository. The default is the current working directory. | +| `--no-upload` | | なし. Stops the {% data variables.product.prodname_codeql_runner %} from uploading the results to {% data variables.product.product_location %}. | +| `--output-dir` | | Directory where the output SARIF files are stored. The default is in the directory of temporary files. | +| `--temp-dir` | | Directory where temporary files are stored. The default is _./codeql-runner_. | +| `--debug` | | なし. Prints more verbose output. | +| `-h`, `--help` | | なし. Displays help for the command. | + +#### `アップロード` + +Uploads SARIF files to {% data variables.product.product_location %}. + +| Flag | 必須 | Input value | +| -------------------------------- |:--:| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `--sarif-file` | ✓ | SARIF file to upload, or a directory containing multiple SARIF files. | +| `--repository` | ✓ | Name of the repository that was analyzed. | +| `--commit` | ✓ | SHA of the commit that was analyzed. In Git and in Azure DevOps, this corresponds to the value of `git rev-parse HEAD`. In Jenkins, this corresponds to `$GIT_COMMIT`. | +| `--ref` | ✓ | Name of the reference that was analyzed, for example `refs/heads/main`. In Git and in Jenkins, this corresponds to the value of `git symbolic-ref HEAD`. In Azure DevOps, this corresponds to `$(Build.SourceBranch)`. | +| `--github-url` | ✓ | URL of the {% data variables.product.prodname_dotcom %} instance where your repository is hosted. | +| `--github-auth` | ✓ | A {% data variables.product.prodname_github_apps %} token or personal access token. | +| `--checkout-path` | | The path to the checkout of your repository. The default is the current working directory. | +| `--debug` | | なし. Prints more verbose output. | +| `-h`, `--help` | | なし. Displays help for the command. | diff --git a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md new file mode 100644 index 000000000000..7cf614a756b0 --- /dev/null +++ b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md @@ -0,0 +1,116 @@ +--- +title: Configuring the CodeQL workflow for compiled languages +shortTitle: コンパイルされた言語を設定する +intro: 'You can configure how {% data variables.product.prodname_dotcom %} uses the {% data variables.product.prodname_codeql_workflow %} to scan code written in compiled languages for vulnerabilities and errors.' +product: '{% data reusables.gated-features.code-scanning %}' +permissions: 'リポジトリへの書き込み権限を持つユーザは、リポジトリの {% data variables.product.prodname_code_scanning %} を設定できます。' +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages + - /github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta %} +{% data reusables.code-scanning.enterprise-enable-code-scanning-actions %} + +### About the {% data variables.product.prodname_codeql_workflow %} and compiled languages + +You enable {% data variables.product.prodname_dotcom %} to run {% data variables.product.prodname_code_scanning %} for your repository by adding a {% data variables.product.prodname_actions %} workflow to the repository. **Note**: This article refers to {% data variables.product.prodname_code_scanning %} powered by {% data variables.product.prodname_codeql %}, not to {% data variables.product.prodname_code_scanning %} resulting from the upload of third-party static analysis tools. デフォルトの {% data variables.product.prodname_code_scanning %} ワークフローは、`on.push` イベントを使用して、ワークフローファイルを含むブランチへのプッシュごとにコードスキャンをトリガーします。 + +{% data reusables.code-scanning.edit-workflow %} +For general information about configuring +{% data variables.product.prodname_code_scanning %} and editing workflow files, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" and "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." + +### {% data variables.product.prodname_codeql %} の autobuild について + +Code scanning works by running queries against one or more databases. Each database contains a representation of all of the code in a single language in your repository. For the compiled languages C/C++, C#, and Java, the process of populating this database involves building the code and extracting data. {% data reusables.code-scanning.analyze-go %} + +{% data reusables.code-scanning.autobuild-compiled-languages %} + +If your workflow uses a `language` matrix, `autobuild` attempts to build each of the compiled languages listed in the matrix. Without a matrix `autobuild` attempts to build the supported compiled language that has the most source files in the repository. With the exception of Go, analysis of other compiled languages in your repository will fail unless you supply explicit build commands. + +{% note %} + +**注釈**: {% data variables.product.prodname_actions %} にセルフホストランナーを使用する場合、`autobuild` プロセスを使用するために追加のソフトウェアをインストールする必要がある場合があります。 さらに、リポジトリに特定のバージョンのビルドツールが必要な場合は、手動でインストールする必要があります。 詳しい情報については、「[{% data variables.product.prodname_dotcom %} ホストランナーの仕様](/actions/reference/specifications-for-github-hosted-runners/#supported-software)」を参照してください。 + +{% endnote %} + +#### C/C++ + +| サポートされているシステムの種類 | システム名 | +| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | +| オペレーティングシステム | Windows, macOS, and Linux | +| ビルドシステム | Windows: MSbuild and build scripts
    Linux and macOS: Autoconf, Make, CMake, qmake, Meson, Waf, SCons, Linux Kbuild, and build scripts | + +`autobuild` ステップの動作は、抽出を実行するオペレーティングシステムによって異なります。 On Windows, the `autobuild` step attempts to autodetect a suitable build method for C/C++ using the following approach: + +1. Invoke `MSBuild.exe` on the solution (`.sln`) or project (`.vcxproj`) file closest to the root. `autobuild` が最上位ディレクトリから同じ（最短）深度で複数のソリューションまたはプロジェクトファイルを検出した場合、それらすべてをビルドしようとします。 +2. Invoke a script that looks like a build script—_build.bat_, _build.cmd_, _and build.exe_ (in that order). + +On Linux and macOS, the `autobuild` step reviews the files present in the repository to determine the build system used: + +1. ルートディレクトリでビルドシステムを探します。 +2. 何も見つからない場合は、C/C++ のビルドシステムで一意のディレクトリをサブディレクトリで検索します。 +3. 適切なコマンドを実行してシステムを設定します。 + +#### C + +| サポートされているシステムの種類 | システム名 | +| ---------------- | -------------------------- | +| オペレーティングシステム | Windows、Linux | +| ビルドシステム | .NET と MSbuild、およびビルドスクリプト | + +`autobuild` プロセスは、次のアプローチを使用して C# に適したビルドメソッドを自動検出しようとします。 + +1. ルートに最も近いソリューション（`.sln`）またはプロジェクト（`.csproj`）ファイルで `dotnet build` を呼び出します。 +2. ルートに最も近いソリューションまたはプロジェクトファイルで `MSbuild`（Linux）または `MSBuild.exe`（Windows）を呼び出します。 `autobuild` が最上位ディレクトリから同じ（最短）深度で複数のソリューションまたはプロジェクトファイルを検出した場合、それらすべてをビルドしようとします。 +3. ビルドスクリプトのように見えるスクリプト、つまり _build_ と _build.sh_（Linux の場合、この順序で）または _build.bat_、_build.cmd_、および _build.exe_（Windows の場合、この順序で）を呼び出します。 + +#### Java + +| サポートされているシステムの種類 | システム名 | +| ---------------- | ------------------------------------------ | +| オペレーティングシステム | Windows, macOS, and Linux (no restriction) | +| ビルドシステム | Gradle、Maven、Ant | + +`autobuild` プロセスは、この戦略を適用して Java コードベースのビルドシステムを決定しようとします。 + +1. ルートディレクトリでビルドファイルを検索します。 Gradle、Maven、Ant の各ビルドファイルを確認します。 +2. 最初に見つかったビルドファイルを実行します。 Gradle ファイルと Maven ファイルの両方が存在する場合は、Gradle ファイルが使用されます。 +3. それ以外の場合は、ルートディレクトリの直接サブディレクトリ内でビルドファイルを検索します。 1 つのサブディレクトリにのみビルドファイルが含まれている場合は、そのサブディレクトリで識別された最初のファイルを実行します（1 と同じ環境設定を使用）。 複数のサブディレクトリにビルドファイルが含まれている場合は、エラーを報告します。 + +### コンパイル言語のビルドステップを追加する + +{% data reusables.code-scanning.autobuild-add-build-steps %} For information on how to edit the workflow file, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)." + +`autobuild` ステップを削除した後、`run` ステップのコメントを外して、リポジトリに適したビルドコマンドを追加します。 ワークフロー `run` ステップは、オペレーティングシステムのシェルを使用してコマンドラインプログラムを実行します。 これらのコマンドを変更し、さらにコマンドを追加して、ビルドプロセスをカスタマイズできます。 + +``` yaml +- run: | + make bootstrap + make release +``` + +`run` キーワードに関する詳しい情報については、「"[{% data variables.product.prodname_actions %}のためのワークフローの構文](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)」を参照してください。 + +If your repository contains multiple compiled languages, you can specify language-specific build commands. For example, if your repository contains C/C++, C# and Java, and `autobuild` correctly builds C/C++ and C# but fails to build Java, you could use the following configuration in your workflow, after the `init` step. This specifies build steps for Java while still using `autobuild` for C/C++ and C#: + +```yaml +- if: matrix.language == 'cpp' || matrix.language == 'csharp' + name: Autobuild + uses: github/codeql-action/autobuild@v1 + +- if: matrix.language == 'java' + name: Build Java + run: | + make bootstrap + make release +``` + +For more information about the `if` conditional, see "[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsif)." + +For more tips and tricks about why `autobuild` won't build your code, see "[Troubleshooting the {% data variables.product.prodname_codeql %} workflow](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow)." + +If you added manual build steps for compiled languages and {% data variables.product.prodname_code_scanning %} is still not working on your repository, contact {% data variables.contact.contact_support %}. diff --git a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md index 14a835f18f1a..f4cabb2462b7 100644 --- a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md +++ b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md @@ -27,23 +27,91 @@ You decide how you generate {% data variables.product.prodname_code_scanning %} {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-security %} -3. To the right of "Code scanning", click **Set up code scanning**. - !["Set up code scanning" button to the right of "Code scanning" in the Security Overview](/assets/images/help/security/overview-set-up-code-scanning.png) -4. Under "Get started with code scanning", click **Set up this workflow** on the {% data variables.product.prodname_codeql_workflow %} or on a third-party workflow. - !["Set up this workflow" button under "Get started with code scanning" heading](/assets/images/help/repository/code-scanning-set-up-this-workflow.png) -5. Optionally, to customize how {% data variables.product.prodname_code_scanning %} scans your code, edit the workflow. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." +3. To the right of "{% data variables.product.prodname_code_scanning_capc %}", click **Set up {% data variables.product.prodname_code_scanning %}**. + !["Set up {% data variables.product.prodname_code_scanning %}" button to the right of "{% data variables.product.prodname_code_scanning_capc %}" in the Security Overview](/assets/images/help/security/overview-set-up-code-scanning.png) +4. Under "Get started with {% data variables.product.prodname_code_scanning %}", click **Set up this workflow** on the {% data variables.product.prodname_codeql_workflow %} or on a third-party workflow. + !["Set up this workflow" button under "Get started with {% data variables.product.prodname_code_scanning %}" heading](/assets/images/help/repository/code-scanning-set-up-this-workflow.png) +5. To customize how {% data variables.product.prodname_code_scanning %} scans your code, edit the workflow. + + Generally you can commit the {% data variables.product.prodname_codeql_workflow %} without making any changes to it. However, many of the third-party workflows require additional configuration, so read the comments in the workflow before committing. + + For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." 6. Use the **Start commit** drop-down, and type a commit message. ![Start commit](/assets/images/help/repository/start-commit-commit-new-file.png) 7. Choose whether you'd like to commit directly to the default branch, or create a new branch and start a pull request. ![Choose where to commit](/assets/images/help/repository/start-commit-choose-where-to-commit.png) 8. Click **Commit new file** or **Propose new file**. -After you commit the workflow file or create a pull request, {% data variables.product.prodname_code_scanning %} will analyze your code according to the frequency you specified in your workflow file. If you created a pull request, {% data variables.product.prodname_code_scanning %} will only analyze the code on the pull request's topic branch until you merge the pull request into the default branch of the repository. +In the default {% data variables.product.prodname_codeql_workflow %}, {% data variables.product.prodname_code_scanning %} is configured to analyze your code each time you either push a change to the default branch or any protected branches, or raise a pull request against the default branch or any protected branches. As a result, {% data variables.product.prodname_code_scanning %} will now commence. + +### Viewing the logging output from {% data variables.product.prodname_code_scanning %} + +After enabling {% data variables.product.prodname_code_scanning %} for your repository, you can watch the output of the actions as they run. + +{% data reusables.repositories.actions-tab %} + + You'll see a list that includes an entry for running the {% data variables.product.prodname_code_scanning %} workflow. + + ![Actions list showing {% data variables.product.prodname_code_scanning %} workflow](/assets/images/help/repository/code-scanning-actions-list.png) + +1. Click the entry for the {% data variables.product.prodname_code_scanning %} workflow. + +1. Click the job name on the left. For example, **Analyze (LANGUAGE)**. + + ![Log output from the {% data variables.product.prodname_code_scanning %} workflow](/assets/images/help/repository/code-scanning-logging-analyze-action.png) + +1. Review the logging output from the actions in this workflow as they run. + +1. Once all jobs are complete, you can view the details of any {% data variables.product.prodname_code_scanning %} alerts that were identified. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository#viewing-an-alert)." + +{% note %} + +**Note:** If you raised a pull request to add the {% data variables.product.prodname_code_scanning %} workflow to the repository, alerts from that pull request aren't displayed directly on the {% data variables.product.prodname_code_scanning_capc %} page until the pull request is merged. If any alerts were found you can view these, before the pull request is merged, by clicking the **_n_ alerts found** link in the banner on the {% data variables.product.prodname_code_scanning_capc %} page. + + ![Click the "n alerts found" link](/assets/images/help/repository/code-scanning-alerts-found-link.png) + +{% endnote %} + +### Understanding the pull request checks + +Each {% data variables.product.prodname_code_scanning %} workflow you enable to run on pull requests always has at least two entries listed in the checks section of a pull request. There is one entry for each of the analysis jobs in the workflow, and a final one for the results of the analysis. + +The names of the {% data variables.product.prodname_code_scanning %} analysis checks take the form: "TOOL NAME / JOB NAME (TRIGGER)." For example, for {% data variables.product.prodname_codeql %}, analysis of C++ code has the entry "{% data variables.product.prodname_codeql %} / Analyze (cpp) (pull_request)." You can click **Details** on a {% data variables.product.prodname_code_scanning %} analysis entry to see logging data. This allows you to debug a problem if the analysis job failed. For example, for {% data variables.product.prodname_code_scanning %} analysis of compiled languages, this can happen if the action can't build the code. + + ![{% data variables.product.prodname_code_scanning %} pull request checks](/assets/images/help/repository/code-scanning-pr-checks.png) + +When the {% data variables.product.prodname_code_scanning %} jobs complete, {% data variables.product.prodname_dotcom %} works out whether any alerts were added by the pull request and adds the "{% data variables.product.prodname_code_scanning_capc %} results / TOOL NAME" entry to the list of checks. After {% data variables.product.prodname_code_scanning %} has been performed at least once, you can click **Details** to view the results of the analysis. If you used a pull request to add {% data variables.product.prodname_code_scanning %} to the repository, you will initially see a "Missing analysis" message when you click **Details** on the "{% data variables.product.prodname_code_scanning_capc %} results / TOOL NAME" check. + + ![Missing analysis for commit message](/assets/images/help/repository/code-scanning-missing-analysis.png) + +#### Reasons for the "missing analysis" message + +After {% data variables.product.prodname_code_scanning %} has analyzed the code in a pull request, it needs to compare the analysis of the topic branch (the branch you used to create the pull request) with the analysis of the base branch (the branch into which you want to merge the pull request). This allows {% data variables.product.prodname_code_scanning %} to compute which alerts are newly introduced by the pull request, which alerts were already present in the base branch, and whether any existing alerts are fixed by the changes in the pull request. Initially, if you use a pull request to add {% data variables.product.prodname_code_scanning %} to a repository, the base branch has not yet been analyzed, so it's not possible to compute these details. In this case, when you click through from the results check on the pull request you will see the "Missing analysis for base commit SHA-HASH" message. + +There are other situations where there may be no analysis for the latest commit to the base branch for a pull request. These include: + +* The pull request has been raised against a branch other than the default branch or a protected branch, and this branch hasn't been analyzed. + + To check whether a branch has been scanned, go to the {% data variables.product.prodname_code_scanning_capc %} page, click the **Branch** drop-down and select the relevant branch. + + ![Choose a branch from the Branch drop-down menu](/assets/images/help/repository/code-scanning-branch-dropdown.png) + + The solution in this situation is to add the name of the base branch to the `on:push` and `on:pull_request` specification in the {% data variables.product.prodname_code_scanning %} workflow on that branch and then make a change that updates the open pull request that you want to scan. + +* The latest commit on the base branch for the pull request is currently being analyzed and analysis is not yet available. + + Wait a few minutes and then push a change to the pull request to retrigger {% data variables.product.prodname_code_scanning %}. + +* An error occurred while analyzing the latest commit on the base branch and analysis for that commit isn't available. + + Merge a trivial change into the base branch to trigger {% data variables.product.prodname_code_scanning %} on this latest commit, then push a change to the pull request to retrigger {% data variables.product.prodname_code_scanning %}. ### Next steps -After you enable {% data variables.product.prodname_code_scanning %}, you can monitor analysis, view results, and further customize how you scan your code. +After enabling {% data variables.product.prodname_code_scanning %}, and allowing its actions to complete, you can: -- You can view the run status of {% data variables.product.prodname_code_scanning %} and get notifications for completed runs. For more information, see "[Managing a workflow run](/actions/configuring-and-managing-workflows/managing-a-workflow-run)" and "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)." -- After a scan completes, you can view alerts from a completed scan. For more information, see "[Managing alerts from {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." -- You can customize how {% data variables.product.prodname_code_scanning %} scans the code in your repository. For more information, see "[Configuring code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." +- View all of the {% data variables.product.prodname_code_scanning %} alerts generated for this repository. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." +- View any alerts generated for a pull request submitted after you enabled {% data variables.product.prodname_code_scanning %}. For more information, see "[Triaging {% data variables.product.prodname_code_scanning %} alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests)." +- Set up notifications for completed runs. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)." +- Investigate any problems that occur with the initial setup of {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %}. For more information, see "[Troubleshooting the {% data variables.product.prodname_codeql %} workflow](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow)." +- Customize how {% data variables.product.prodname_code_scanning %} scans the code in your repository. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." diff --git a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md index 181e1b857a7d..fba325cc271f 100644 --- a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md +++ b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md @@ -1,5 +1,6 @@ --- title: コード内のセキュリティの脆弱性とエラーを検出する +product: '{% data reusables.gated-features.code-scanning %}' redirect_from: - /github/managing-security-vulnerabilities/finding-security-vulnerabilities-in-your-projects-code versions: @@ -11,14 +12,17 @@ versions: {% topic_link_in_list /automatically-scanning-your-code-for-vulnerabilities-and-errors %} {% link_in_list /about-code-scanning %} + {% link_in_list /triaging-code-scanning-alerts-in-pull-requests %} {% link_in_list /enabling-code-scanning %} - {% link_in_list /managing-alerts-from-code-scanning %} + {% link_in_list /managing-code-scanning-alerts-for-your-repository %} {% link_in_list /configuring-code-scanning %} - {% link_in_list /configuring-the-codeql-action-for-compiled-languages %} - {% link_in_list /troubleshooting-code-scanning %} + {% link_in_list /configuring-the-codeql-workflow-for-compiled-languages %} + {% link_in_list /troubleshooting-the-codeql-workflow %} {% topic_link_in_list /managing-results-from-code-scanning %} {% link_in_list /about-integration-with-code-scanning %} - {% link_in_list /running-code-scanning-in-your-ci-system %} - {% link_in_list /configuring-code-scanning-in-your-ci-system %} {% link_in_list /uploading-a-sarif-file-to-github %} {% link_in_list /sarif-support-for-code-scanning %} +{% link_in_list /running-code-scanning-in-your-ci-system %} + {% link_in_list /configuring-code-scanning-in-your-ci-system %} + {% link_in_list /configuring-the-codeql-action-for-compiled-languages %} + {% link_in_list /troubleshooting-codeql-code-scanning-in-your-ci-system %} diff --git a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md index 9caa80f45c73..01a082e5015f 100644 --- a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md +++ b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md @@ -1,8 +1,9 @@ --- title: Integrating with code scanning shortTitle: Integration -intro: 'You can integrate {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} with your existing CI systems or upload results from other tools.' +intro: 'You can integrate third-party code analysis tools with {% data variables.product.prodname_dotcom %} {% data variables.product.prodname_code_scanning %} by uploading data as SARIF files.' mapTopic: true +product: '{% data reusables.gated-features.code-scanning %}' redirect_from: - /github/finding-security-vulnerabilities-and-errors-in-your-code/managing-results-from-code-scanning versions: diff --git a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository.md b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository.md new file mode 100644 index 000000000000..258dcff05d19 --- /dev/null +++ b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository.md @@ -0,0 +1,63 @@ +--- +title: Managing code scanning alerts for your repository +shortTitle: アラートを管理する +intro: 'プロジェクトのコードの潜在的な脆弱性またはエラーのアラートを表示、修正、およびクローズすることができます。' +product: '{% data reusables.gated-features.code-scanning %}' +permissions: 'People with write permission to a repository can manage {% data variables.product.prodname_code_scanning %} alerts for the repository.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +redirect_from: + - /github/managing-security-vulnerabilities/managing-alerts-from-automated-code-scanning + - /github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning +--- + +{% data reusables.code-scanning.beta %} + +### {% data variables.product.prodname_code_scanning %} からのアラートについて + +You can set up {% data variables.product.prodname_code_scanning %} to check the code in a repository using the default {% data variables.product.prodname_codeql %} analysis, a third-party analysis, or multiple types of analysis. When the analysis is complete, the resulting alerts are displayed alongside each other in the security view of the repository. Results from third-party tools or from custom queries may not include all of the properties that you see for alerts detected by {% data variables.product.company_short %}'s default {% data variables.product.prodname_codeql %} analysis. デフォルトの {% data variables.product.prodname_code_scanning %} ワークフローは、`on.push` イベントを使用して、ワークフローファイルを含むブランチへのプッシュごとにコードスキャンをトリガーします。 + +By default, {% data variables.product.prodname_code_scanning %} analyzes your code periodically on the default branch and during pull requests. For information about managing alerts on a pull request, see "[Triaging {% data variables.product.prodname_code_scanning %} alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests)." + +### About alerts details + +Each alert highlights a problem with the code and the name of the tool that identified it. アラートをトリガーしたコード行と、アラートのプロパティ（問題の重要度や性質など）を確認できます。 アラートは、問題が最初に発生したときにも通知します。 For alerts identified by {% data variables.product.prodname_codeql %} analysis, you will also see information on how to fix the problem. + +![{% data variables.product.prodname_code_scanning %} からのアラートの例](/assets/images/help/repository/code-scanning-alert.png) + +If you enable {% data variables.product.prodname_code_scanning %} using {% data variables.product.prodname_codeql %}, this can also detect data-flow problems in your code. Data-flow analysis finds potential security issues in code, such as: using data insecurely, passing dangerous arguments to functions, and leaking sensitive information. + +{% data variables.product.prodname_code_scanning %} がデータフローアラートを報告すると、{% data variables.product.prodname_dotcom %} はデータがコードを通してどのように移動するかを示します。 {% data variables.product.prodname_code_scanning_capc %} allows you to identify the areas of your code that leak sensitive information, and that could be the entry point for attacks by malicious users. + +### アラートを表示する + +Anyone with read permission for a repository can see {% data variables.product.prodname_code_scanning %} alerts on pull requests. However, you need write permission to view a summary of alerts for repository on the **Security** tab. By default, alerts are shown for the default branch. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-security %} +{% data reusables.repositories.sidebar-code-scanning-alerts %} +{% data reusables.code-scanning.click-alert-in-list %} +5. Optionally, if the alert highlights a problem with data flow, click **Show paths** to display the path from the data source to the sink where it's used. ![データフローアラートの例](/assets/images/help/repository/code-scanning-show-paths.png) + +### Fixing an alert + +Anyone with write permission for a repository can fix an alert by committing a correction to the code. If the repository has {% data variables.product.prodname_code_scanning %} scheduled to run on pull requests, it's best to raise a pull request with your correction. This will trigger {% data variables.product.prodname_code_scanning %} analysis of the changes and test that your fix doesn't introduce any new problems. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" and "[Triaging {% data variables.product.prodname_code_scanning %} alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests)." + +### アラートを閉じる + +Closing an alert is a way to resolve an alert that you don't think needs to be fixed. {% data reusables.code-scanning.close-alert-examples %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-security %} +{% data reusables.repositories.sidebar-code-scanning-alerts %} +{% data reusables.code-scanning.click-alert-in-list %} +5. Select the Close drop-down menu and click a reason for closing the alert. ![Choosing reason for closing the alert via the Close drop-down](/assets/images/help/repository/code-scanning-alert-close-drop-down.png) + +{% data reusables.code-scanning.false-positive-fix-codeql %} + +### 参考リンク + +- "[Triaging {% data variables.product.prodname_code_scanning %} alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests)" +- "[Enabling {% data variables.product.prodname_code_scanning %} for a repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository)" +- "[About integration with {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning)" diff --git a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md new file mode 100644 index 000000000000..5b7faf0e62b0 --- /dev/null +++ b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md @@ -0,0 +1,161 @@ +--- +title: Running CodeQL code scanning in your CI system +shortTitle: Running in your CI +intro: 'You can use the {% data variables.product.prodname_codeql_runner %} to perform {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in a third-party continuous integration system.' +product: '{% data reusables.gated-features.code-scanning %}' +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta-codeql-runner %} +{% data reusables.code-scanning.beta %} +{% data reusables.code-scanning.enterprise-enable-code-scanning %} + +### Using {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} with your existing CI system + +If you use a continuous integration or continuous delivery/deployment (CI/CD) system other than {% data variables.product.prodname_actions %}, you can use your existing system to run {% data variables.product.prodname_dotcom %}'s {% data variables.product.prodname_codeql %} analysis and upload the results to {% data variables.product.prodname_dotcom %}. To do this, use the {% data variables.product.prodname_codeql_runner %}. + +### About the {% data variables.product.prodname_codeql_runner %} + +{% data reusables.code-scanning.about-code-scanning %} For information, see "[About {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)." + +You can use the {% data variables.product.prodname_codeql_runner %} to run {% data variables.product.prodname_code_scanning %} on code that you're processing in a third-party continuous integration (CI) system. Alternatively, you can use {% data variables.product.prodname_actions %} to run {% data variables.product.prodname_code_scanning %} on {% data variables.product.product_location %}. For information, see "[Enabling {% data variables.product.prodname_code_scanning %} for a repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository)." + +The {% data variables.product.prodname_codeql_runner %} is a command-line tool that runs {% data variables.product.prodname_codeql %} analysis on a checkout of a {% data variables.product.prodname_dotcom %} repository. You add the runner to your third-party system, then call the runner to analyze code and upload the results to {% data variables.product.product_location %}. These results are displayed as {% data variables.product.prodname_code_scanning %} alerts in the repository. + +{% data reusables.code-scanning.codeql-runner-license %} + +### Downloading the {% data variables.product.prodname_codeql_runner %} + +You can download the {% data variables.product.prodname_codeql_runner %} from https://github.com/github/codeql-action/releases. On some operating systems, you may need to change permissions for the downloaded file before you can run it. + +On Linux: + +```shell +chmod +x codeql-runner-linux +``` + +On MacOS: + +```shell +chmod +x codeql-runner-macos +sudo xattr -d com.apple.quarantine codeql-runner-macos +``` + +On Windows, the `codeql-runner-win.exe` file usually requires no change to permissions. + +### Adding the {% data variables.product.prodname_codeql_runner %} to your CI system + +Once you have downloaded the {% data variables.product.prodname_codeql_runner %} and verified that it can be executed, you should make the runner available to each CI server that you intend to use for {% data variables.product.prodname_code_scanning %}. It is important to notice that each CI server that you intend to use for {% data variables.product.prodname_code_scanning %} needs to have the {% data variables.product.prodname_codeql_runner %}. You might configure each server to copy the runner from a central, internal location, or you could use the REST API to get the runner direct from GitHub, for example: + +```shell +wget https://github.com/github/codeql-action/releases/download/codeql-bundle-20200826/codeql-runner-linux +chmod +x codeql-runner-linux +``` + +In addition to this, each CI server also needs: + +- A {% data variables.product.prodname_github_apps %} or personal access token for the {% data variables.product.prodname_codeql_runner %} to use. For private repositories the token must have the `repo` scope. For public the token needs only the `public_repo` and `repo:security_events` scopes. For information, see "[Building {% data variables.product.prodname_github_apps %}](/developers/apps/building-github-apps)" and "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token)." +- Access to the {% data variables.product.prodname_codeql %} bundle associated with this release of the {% data variables.product.prodname_codeql_runner %}. This package contains the {% data variables.product.prodname_codeql %} CLI, queries, and libraries needed for {% data variables.product.prodname_codeql %} analysis. For information, see "[{% data variables.product.prodname_codeql %} CLI](https://help.semmle.com/codeql/codeql-cli.html)." + +The options for providing access to the {% data variables.product.prodname_codeql %} bundle are: + +1. Allow the CI servers access to {% data variables.product.prodname_dotcom_the_website %} so that the {% data variables.product.prodname_codeql_runner %} can download the bundle automatically. +1. Manually download/extract the bundle, store it with other central resources, and use the `--codeql-path` flag to specify the location of the bundle in calls to initialize the {% data variables.product.prodname_codeql_runner %}. +{% if currentVersion != "free-pro-team@latest" %} +1. You can mirror the `github/codeql-action` repository on {% data variables.product.product_location %}. Unless you specify the `--codeql-path` flag, the runner automatically checks for the bundle in this location and on {% data variables.product.prodname_dotcom_the_website %}.{% endif %} + +### Calling the {% data variables.product.prodname_codeql_runner %} + +You should call the {% data variables.product.prodname_codeql_runner %} from the checkout location of the repository you want to analyze. The two main commands are: + +1. `init` required to initialize the runner and create a {% data variables.product.prodname_codeql %} database for each language to be analyzed. These databases are populated and analyzed by subsequent commands. +1. `analyze` required to populate the {% data variables.product.prodname_codeql %} databases, analyze them, and upload results to {% data variables.product.product_location %}. + +For both commands, you must specify the URL of {% data variables.product.product_location %}, the repository *OWNER/NAME*, and the GitHub Apps or personal access token to use for authentication. You also need to specify the location of the CodeQL bundle unless the CI server has access to download it directly from the `github/codeql-action` repository on {% data variables.product.prodname_dotcom_the_website %}{% if currentVersion != "free-pro-team@latest" %} or mirrored on {% data variables.product.product_location %}{% endif %}. + +You can configure where the {% data variables.product.prodname_codeql_runner %} stores the CodeQL bundle for future analysis on a server using the `--tools-dir` flag and where it stores temporary files during analysis using `--temp-dir`. + +To view the command-line reference for the runner, use the `-h` flag. For example, to list all commands run: `codeql-runner-OS -h`, or to list all the flags available for the `init` command run: `codeql-runner-OS init -h` (where `OS` varies according to the executable that you are using). For more information, see "[Configuring {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system#codeql-runner-command-reference)." + +#### Basic example + +This example runs {% data variables.product.prodname_codeql %} analysis on a Linux CI server for the `octo-org/example-repo` repository hosted on `{% data variables.command_line.git_url_example %}`. The process is very simple because the repository contains only languages that can be analyzed by {% data variables.product.prodname_codeql %} directly, without being built (that is, Go, JavaScript, Python, and TypeScript). + +1. Check out the repository to analyze. +1. Move into the directory where the repository is checked out. +1. Initialize the {% data variables.product.prodname_codeql_runner %} and create {% data variables.product.prodname_codeql %} databases for the languages detected. + + ```shell + $ /path/to-runner/codeql-runner-linux init --repository octo-org/example-repo + --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN + > Cleaning temp directory /srv/checkout/example-repo/codeql-runner + > ... + > Created CodeQL database at /srv/checkout/example-repo/codeql-runner/codeql_databases/javascript. + ``` + +1. Populate the {% data variables.product.prodname_codeql_runner %} databases, analyze them, and upload the results to {% data variables.product.product_name %}. + + ```shell + $ /path/to-runner/codeql-runner-linux analyze --repository octo-org/example-repo + --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN + --commit 5b6a3078b31dc346e5ce7b86837d6abbe7a18bbd --ref refs/heads/main + > Finalizing database creation + > ... + > POST /repos/octo-org/example-repo/code-scanning/sarifs - 202 in 786ms + > Successfully uploaded results + ``` + +The server has access to download the {% data variables.product.prodname_codeql %} bundle directly from the `github/codeql-action` repository on {% data variables.product.prodname_dotcom_the_website %}{% if currentVersion != "free-pro-team@latest" %} or mirrored on {% data variables.product.product_location %}{% endif %}, so there is no need to use the `--codeql-path` flag. When the analysis is complete, the {% data variables.product.prodname_codeql_runner %} uploads the results to the {% data variables.product.prodname_code_scanning %} view. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." + +#### Compiled language example + +This example is similar to the previous example, however this time the repository has code in C/C++, C#, or Java. To create a {% data variables.product.prodname_codeql %} database for these languages, the CLI needs to monitor the build. At the end of the initialization process, the runner reports the command you need to set up the environment before building the code. You need to run this command, before calling the normal CI build process, and then running the `analyze` command. + +1. Check out the repository to analyze. +1. Move into the directory where the repository is checked out. +1. Initialize the {% data variables.product.prodname_codeql_runner %} and create {% data variables.product.prodname_codeql %} databases for the languages detected. + + ```shell + $ /path/to-runner/codeql-runner-linux init --repository octo-org/example-repo-2 + --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN + > Cleaning temp directory /srv/checkout/example-repo-2/codeql-runner + > ... + > CodeQL environment output to "/srv/checkout/example-repo-2/codeql-runner/codeql-env.json" + and "/srv/checkout/example-repo-2/codeql-runner/codeql-env.sh". + Please export these variables to future processes so the build can be traced, for example by running " + . /srv/checkout/example-repo-2/codeql-runner/codeql-env.sh". + ``` + +1. Run the script generated by the `init` action to set up the environment to monitor the build. + + ```shell + $ . /srv/checkout/example-repo-2/codeql-runner/codeql-env.sh + ``` + +1. Build the code. +1. Populate the {% data variables.product.prodname_codeql %} databases, analyze them, and upload the results to GitHub. + + ```shell + $ /path/to-runner/codeql-runner-linux analyze --repository octo-org/example-repo-2 + --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN + --commit ae7b655ef30b50fb726ae7b3daa79571a39d194d --ref refs/heads/main + > Finalizing database creation + > ... + > POST /repos/octo-org/example-repo-2/code-scanning/sarifs - 202 in 573ms + > Successfully uploaded results + ``` + +{% note %} + +**Note:** If you use a containerized build, you need to run the {% data variables.product.prodname_codeql_runner %} in the container where your build task takes place. + +{% endnote %} + +### Further reading + +- "[Configuring {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system)" +- "[Troubleshooting {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system)" diff --git a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md index a2e1a666dd6b..270e23be650a 100644 --- a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md +++ b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md @@ -1,7 +1,7 @@ --- title: コードスキャンの SARIF サポート shortTitle: SARIF サポート -intro: '{% data variables.product.prodname_dotcom %} のリポジトリにあるサードパーティの静的分析ツールからの結果を表示するには、コードスキャン用に SARIF 2.1.0 JSON スキーマの特定のサブセットをサポートする SARIF ファイルに結果を保存する必要があります。 デフォルトの {% data variables.product.prodname_codeql %} 静的分析エンジンを使用すると、結果は {% data variables.product.prodname_dotcom %} のリポジトリに自動的に表示されます。' +intro: 'To display results from a third-party static analysis tool in your repository on {% data variables.product.prodname_dotcom %}, you''ll need your results stored in a SARIF file that supports a specific subset of the SARIF 2.1.0 JSON schema for {% data variables.product.prodname_code_scanning %}. デフォルトの {% data variables.product.prodname_codeql %} 静的分析エンジンを使用すると、結果は {% data variables.product.prodname_dotcom %} のリポジトリに自動的に表示されます。' product: '{% data reusables.gated-features.code-scanning %}' redirect_from: - /github/finding-security-vulnerabilities-and-errors-in-your-code/about-sarif-support-for-code-scanning @@ -11,27 +11,32 @@ versions: --- {% data reusables.code-scanning.beta %} -{% data reusables.code-scanning.enterprise-enable-code-scanning %} ### SARIF サポートについて SARIF（Static Analysis Results Interchange Format）は、出力ファイル形式を定義する [OASIS 標準](https://docs.oasis-open.org/sarif/sarif/v2.1.0/sarif-v2.1.0.html)です。 SARIF 標準は、静的分析ツールが結果を共有する方法を合理化するために使用されます。 {% data variables.product.prodname_code_scanning_capc %} は、SARIF 2.1.0 JSON スキーマのサブセットをサポートしています。 -サードパーティの静的コード分析エンジンから SARIF ファイルをアップロードするには、アップロードされたファイルが SARIF 2.1.0 バージョンを使用していることを確認する必要があります。 {% data variables.product.prodname_dotcom %} は SARIF ファイルを解析し、コードスキャンエクスペリエンスの一部としてリポジトリの結果を使用してアラートを表示します。 詳しい情報については、「[SARIF ファイルを {% data variables.product.prodname_dotcom %} にアップロードする](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)」を参照してください。 SARIF 2.1.0 JSON スキーマの詳細については、「[`sarif-schema-2.1.0.json`](https://github.com/oasis-tcs/sarif-spec/blob/master/Schemata/sarif-schema-2.1.0.json)」を参照してください。 +サードパーティの静的コード分析エンジンから SARIF ファイルをアップロードするには、アップロードされたファイルが SARIF 2.1.0 バージョンを使用していることを確認する必要があります。 {% data variables.product.prodname_dotcom %} will parse the SARIF file and show alerts using the results in your repository as a part of the {% data variables.product.prodname_code_scanning %} experience. 詳しい情報については、「[SARIF ファイルを {% data variables.product.prodname_dotcom %} にアップロードする](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)」を参照してください。 SARIF 2.1.0 JSON スキーマの詳細については、「[`sarif-schema-2.1.0.json`](https://github.com/oasis-tcs/sarif-spec/blob/master/Schemata/sarif-schema-2.1.0.json)」を参照してください。 -SARIF ファイルに `partialFingerprints` が含まれていない場合、{% data variables.product.prodname_actions %} を使用して SARIF ファイルをアップロードすると、`partialFingerprints` フィールドが計算されます。 詳しい情報については、「[SARIF ファイルを {% data variables.product.prodname_dotcom %} にアップロードする](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github#uploading-a-code-scanning-analysis-with-github-actions)」を参照してください。 +SARIF ファイルに `partialFingerprints` が含まれていない場合、{% data variables.product.prodname_actions %} を使用して SARIF ファイルをアップロードすると、`partialFingerprints` フィールドが計算されます。 For more information, see "[Enabling {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning)" or "[Running {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)." -{% data variables.product.prodname_dotcom %} は、SARIF ファイルのプロパティを使用してアラートを表示します。 たとえば、`shortDescription` と `fullDescription` は、{% data variables.product.prodname_code_scanning %} アラートの上部に表示されます。 `location` により、{% data variables.product.prodname_dotcom %} がコードファイルに注釈を表示できるようになります。 詳しい情報については、「[{% data variables.product.prodname_code_scanning %} からのアラートを管理する](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)」を参照してください。 +{% data variables.product.prodname_dotcom %} は、SARIF ファイルのプロパティを使用してアラートを表示します。 たとえば、`shortDescription` と `fullDescription` は、{% data variables.product.prodname_code_scanning %} アラートの上部に表示されます。 `location` により、{% data variables.product.prodname_dotcom %} がコードファイルに注釈を表示できるようになります。 For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." SARIF の使用が初めてで、詳細を確認する必要がある場合は、Microsoft の [`SARIF tutorials`](https://github.com/microsoft/sarif-tutorials) リポジトリを参照してください。 ### フィンガープリントを使用してアラートの重複を防止する -{% data variables.product.prodname_actions %} ワークフローが新しいコードスキャンを実行するたびに、それぞれの実行結果が処理され、アラートがリポジトリに追加されます。 同じ問題に対するアラートの重複を防ぐために、{% data variables.product.prodname_code_scanning %} はフィンガープリントを使用してさまざまな実行結果を照合し、選択したブランチの最新の実行で 1 回だけ表示されるようにします。 +{% data variables.product.prodname_actions %} ワークフローが新しいコードスキャンを実行するたびに、それぞれの実行結果が処理され、アラートがリポジトリに追加されます。 同じ問題に対するアラートの重複を防ぐために、{% data variables.product.prodname_code_scanning %} はフィンガープリントを使用してさまざまな実行結果を照合し、選択したブランチの最新の実行で 1 回だけ表示されるようにします。 This makes it possible to match alerts to the right line of code when files are edited. {% data variables.product.prodname_dotcom %} は、OASIS 標準の `partialFingerprints` プロパティを使用して、2 つの結果が論理的に同一の場合に検出します。 詳しい情報については、OASIS ドキュメントの「"[partialFingerprints プロパティ](https://docs.oasis-open.org/sarif/sarif/v2.1.0/cs01/sarif-v2.1.0-cs01.html#_Toc16012611)」エントリを参照してください。 -`id` は SARIF ファイルの他の部分から参照され、{% data variables.product.prodname_code_scanning %} が {% data variables.product.prodname_dotcom %} に URL を表示するために使用できます。 If your SARIF file doesn't include `partialFingerprints`, the `partialFingerprints` field will be calculated if you upload the SARIF file using {% data variables.product.prodname_actions %}. 詳しい情報については、「[SARIF ファイルを {% data variables.product.prodname_dotcom %} にアップロードする](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github#uploading-a-code-scanning-analysis-with-github-actions)」を参照してください。 +`id` は SARIF ファイルの他の部分から参照され、{% data variables.product.prodname_code_scanning %} が {% data variables.product.prodname_dotcom %} に URL を表示するために使用できます。 If you upload a SARIF file using the `upload-sarif` action and this data is missing, {% data variables.product.prodname_dotcom %} attempts to populate the `partialFingerprints` field from the source files. For more information about uploading results, see "[Uploading a SARIF file to {% data variables.product.prodname_dotcom %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github#uploading-a-code-scanning-analysis-with-github-actions)." + +If you upload a SARIF file without fingerprint data using the `/code-scanning/sarifs` API endpoint, the {% data variables.product.prodname_code_scanning %} alerts will be processed and displayed, but users may see duplicate alerts. To avoid seeing duplicate alerts, you should calculate fingerprint data and populate the `partialFingerprints` property before you upload the SARIF file. You may find the script that the `upload-sarif` action uses a helpful starting point: https://github.com/github/codeql-action/blob/main/src/fingerprints.ts. For more information about the API, see "[Upload a SARIF file](/rest/reference/code-scanning#upload-a-sarif-file)." + +### Validating your SARIF file + +You can check a SARIF file is compatible with {% data variables.product.prodname_code_scanning %} by testing it against the {% data variables.product.prodname_dotcom %} ingestion rules. For more information, visit the [Microsoft SARIF validator](https://sarifweb.azurewebsites.net/). ### サポートされている SARIF 出力ファイルのプロパティ @@ -44,49 +49,49 @@ SARIF の使用が初めてで、詳細を確認する必要がある場合は | 名前 | 説明 | | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | `$schema` | **必須。**バージョン 2.1.0 の SARIF JSON スキーマの URI。 例: `https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json` | -| `version` | **必須。**{% data variables.product.prodname_code_scanning_capc %} は、SARIF バージョン `2.1.0` のみをサポートしています。 | +| `version` | **必須。**{% data variables.product.prodname_code_scanning_capc %} は、SARIF バージョン `2.1.0` のみをサポートしています。 | | `runs[]` | **必須。**SARIF ファイルには、1 つ以上の実行の配列が含まれています。 各実行は、分析ツールの 1 回の実行を表します。 `run` の詳細については、「[`run` オブジェクト](#run-object)」を参照してください。 | #### `run` オブジェクト {% data variables.product.prodname_code_scanning_capc %} は `run` オブジェクトを使用して、ツールで結果をフィルタし、結果のソースに関する情報を提供します。 `run` オブジェクトには、結果を生成したツールに関する情報を含む `tool.driver` ツールコンポーネントオブジェクトが含まれます。 `run` ごとに、1 つの分析ツールの結果のみを取得できます。 -| 名前 | 説明 | -| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 名前 | 説明 | +| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `tool.driver.name` | **必須。**分析ツールの名前。 {% data variables.product.prodname_code_scanning_capc %} は、{% data variables.product.prodname_dotcom %} に名前を表示して、ツールで結果をフィルタできるようにします。 | | `tool.driver.version` | **任意。**分析ツールのバージョン。 {% data variables.product.prodname_code_scanning_capc %} は、バージョン番号を使用して、分析されているコードでの変更ではなく、ツールのバージョン変更により結果が変更された可能性がある場合に追跡します。 SARIF ファイルに `semanticVersion` フィールドが含まれている場合、`version` は {% data variables.product.prodname_code_scanning %} で使用されません。 | | `tool.driver.semanticVersion` | **任意。**セマンティックバージョニング 2.0 形式で指定された分析ツールのバージョン。 {% data variables.product.prodname_code_scanning_capc %} は、バージョン番号を使用して、分析されているコードでの変更ではなく、ツールのバージョン変更により結果が変更された可能性がある場合に追跡します。 SARIF ファイルに `semanticVersion` フィールドが含まれている場合、`version` は {% data variables.product.prodname_code_scanning %} で使用されません。 詳しい情報については、セマンティックバージョニングのドキュメントの「[セマンティックバージョニング 2.0.0](https://semver.org/)」を参照してください。 | -| `tool.driver.rules[]` | **必須。**ルールを表す `reportingDescriptor` オブジェクトの配列。 分析ツールはルールを使用して、分析対象のコードの問題を見つけます。 詳しい情報については、「[`reportingDescriptor` オブジェクト](#reportingdescriptor-object)」を参照してください。 | +| `tool.driver.rules[]` | **必須。**ルールを表す `reportingDescriptor` オブジェクトの配列。 分析ツールはルールを使用して、分析対象のコードの問題を見つけます。 詳しい情報については、「[`reportingDescriptor` オブジェクト](#reportingdescriptor-object)」を参照してください。 | | `results[]` | **必須。**分析ツールの結果。 {% data variables.product.prodname_code_scanning_capc %} は {% data variables.product.prodname_dotcom %} に結果を表示します。 詳しい情報については、「[`result` オブジェクト](#result-object)」を参照してください。 | #### `reportingDescriptor` オブジェクト -| 名前 | 説明 | -| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 名前 | 説明 | +| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | **必須。**ルールの一意の識別子。 `id` は SARIF ファイルの他の部分から参照され、{% data variables.product.prodname_code_scanning %} が {% data variables.product.prodname_dotcom %} に URL を表示するために使用できます。 | | `name` | **任意。**ルールの名前。 {% data variables.product.prodname_code_scanning_capc %} は、{% data variables.product.prodname_dotcom %} のルールで結果をフィルタできるように名前を表示します。 | | `shortDescription.text` | **必須。**ルールの簡単な説明。 {% data variables.product.prodname_code_scanning_capc %} は、関連する結果の横にある {% data variables.product.prodname_dotcom %} の簡単な説明を表示します。 | | `fullDescription.text` | **必須。**ルールの説明。 {% data variables.product.prodname_code_scanning_capc %} は、関連する結果の横にある {% data variables.product.prodname_dotcom %} の説明全体を表示します。 文字数は最大 1000 文字に制限されています。 | -| `defaultConfiguration.level` | **任意。**ルールのデフォルトの重要度レベル。 {% data variables.product.prodname_code_scanning_capc %} は、特定のルールの結果がどの程度重要であるかを理解するために、重要度レベルを使用します。 この値は、`result` オブジェクトの `level` 属性でオーバーライドできます。 詳しい情報については、「[`result` オブジェクト](#result-object)」を参照してください。 デフォルト: `Warning` | -| `help.text` | **必須。**テキスト形式を使用したルールのドキュメント。 {% data variables.product.prodname_code_scanning_capc %} は、関連する結果の横にこのヘルプドキュメントを表示します。 | -| `help.markdown` | **推奨。**Markdown 形式を使用したルールのドキュメント。 {% data variables.product.prodname_code_scanning_capc %} は、関連する結果の横にこのヘルプドキュメントを表示します。 When `help.markdown` is available, it is displayed instead of `help.text`. | +| `defaultConfiguration.level` | **任意。**ルールのデフォルトの重要度レベル。 {% data variables.product.prodname_code_scanning_capc %} は、特定のルールの結果がどの程度重要であるかを理解するために、重要度レベルを使用します。 この値は、`result` オブジェクトの `level` 属性でオーバーライドできます。 詳しい情報については、「[`result` オブジェクト](#result-object)」を参照してください。 デフォルト: `Warning` | +| `help.text` | **必須。**テキスト形式を使用したルールのドキュメント。 {% data variables.product.prodname_code_scanning_capc %} は、関連する結果の横にこのヘルプドキュメントを表示します。 | +| `help.markdown` | **推奨。**Markdown 形式を使用したルールのドキュメント。 {% data variables.product.prodname_code_scanning_capc %} は、関連する結果の横にこのヘルプドキュメントを表示します。 When `help.markdown` is available, it is displayed instead of `help.text`. | | `properties.tags[]` | **任意。**文字列の配列。 {% data variables.product.prodname_code_scanning_capc %} は、`tags` を使用して、{% data variables.product.prodname_dotcom %} の結果をフィルタできます。 たとえば、`security` タグを含むすべての結果をフィルタすることができます。 | | `properties.precision` | **推奨。**このルールで示される結果が true である頻度を示す文字列。 たとえば、ルールに既知の高誤検知率がある場合、精度は `low` である必要があります。 {% data variables.product.prodname_code_scanning_capc %} は、{% data variables.product.prodname_dotcom %} の精度で結果を並べ替えるため、最高 `level` の精度と最高 `precision` の結果が最初に表示されます。 Can be one of: `very-high`, `high`, `medium`, or `low`. | #### `result` オブジェクト -| 名前 | 説明 | -| --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `ruleId` | **任意。**ルールの一意の識別子（`reportingDescriptor.id`）。 詳しい情報については、「[`reportingDescriptor` オブジェクト](#reportingdescriptor-object)」を参照してください。 {% data variables.product.prodname_code_scanning_capc %} は、ルール識別子を使用して、{% data variables.product.prodname_dotcom %} のルールで結果をフィルタします。 | -| `ruleIndex` | **任意。**ツールコンポーネントの `rules` 配列内の関連するルール（`reportingDescriptor` オブジェクト）のインデックス。 詳しい情報については、「[`run` オブジェクト](#run-object)」を参照してください。 | -| `rule` | **任意。**この結果のルール（レポート記述子）を見つけるために使用される参照。 詳しい情報については、「[`reportingDescriptor` オブジェクト](#reportingdescriptor-object)」を参照してください。 | -| `level` | **任意。**結果の重要度。 このレベルは、ルールで定義されているデフォルトの重要度をオーバーライドします。 {% data variables.product.prodname_code_scanning_capc %} は、レベルを使用して、{% data variables.product.prodname_dotcom %} の重要度で結果をフィルタします。 | -| `message.text` | **必須。**結果を説明するメッセージ。 {% data variables.product.prodname_code_scanning_capc %} は、結果のタイトルとしてメッセージテキストを表示します。 表示スペースが限られている場合、メッセージの最初の文のみが表示されます。 | -| `locations[]` | **必須。**結果が検出された場所。 指定された場所ごとに変更を加えることでのみ問題を修正できる場合を除き、1 つの場所のみを含める必要があります。 **注釈:** {% data variables.product.prodname_code_scanning %} が結果を表示するには、少なくとも 1 つの場所が必要です。 {% data variables.product.prodname_code_scanning_capc %} は、このプロパティを使用して、結果を注釈するファイルを決定します。 この配列の最初の値のみが使用されます。 他のすべての値は無視されます。 | +| 名前 | 説明 | +| --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `ruleId` | **任意。**ルールの一意の識別子（`reportingDescriptor.id`）。 詳しい情報については、「[`reportingDescriptor` オブジェクト](#reportingdescriptor-object)」を参照してください。 {% data variables.product.prodname_code_scanning_capc %} は、ルール識別子を使用して、{% data variables.product.prodname_dotcom %} のルールで結果をフィルタします。 | +| `ruleIndex` | **任意。**ツールコンポーネントの `rules` 配列内の関連するルール（`reportingDescriptor` オブジェクト）のインデックス。 詳しい情報については、「[`run` オブジェクト](#run-object)」を参照してください。 | +| `rule` | **任意。**この結果のルール（レポート記述子）を見つけるために使用される参照。 詳しい情報については、「[`reportingDescriptor` オブジェクト](#reportingdescriptor-object)」を参照してください。 | +| `level` | **任意。**結果の重要度。 このレベルは、ルールで定義されているデフォルトの重要度をオーバーライドします。 {% data variables.product.prodname_code_scanning_capc %} は、レベルを使用して、{% data variables.product.prodname_dotcom %} の重要度で結果をフィルタします。 | +| `message.text` | **必須。**結果を説明するメッセージ。 {% data variables.product.prodname_code_scanning_capc %} は、結果のタイトルとしてメッセージテキストを表示します。 表示スペースが限られている場合、メッセージの最初の文のみが表示されます。 | +| `locations[]` | **必須。**結果が検出された場所。 指定された場所ごとに変更を加えることでのみ問題を修正できる場合を除き、1 つの場所のみを含める必要があります。 **注釈:** {% data variables.product.prodname_code_scanning %} が結果を表示するには、少なくとも 1 つの場所が必要です。 {% data variables.product.prodname_code_scanning_capc %} は、このプロパティを使用して、結果を注釈するファイルを決定します。 この配列の最初の値のみが使用されます。 他のすべての値は無視されます。 | | `partialFingerprints` | **必須。**結果の一意の ID を追跡するために使用される文字列。 {% data variables.product.prodname_code_scanning_capc %} は、`partialFingerprints` を使用して、コミットとブランチで同じ結果であるものを正確に識別します。 {% data variables.product.prodname_code_scanning_capc %} は、`partialFingerprints` がある場合、それを使用しようとします。 `upload-action` を使用してサードパーティの SARIF ファイルをアップロードする場合、SARIF ファイルに含まれていないときに、アクションによって `partialFingerprints` が作成されます。 詳しい情報については、「[フィンガープリントを使用してアラートの重複を防止する](#preventing-duplicate-alerts-using-fingerprints)」を参照してください。 **注釈:** {% data variables.product.prodname_code_scanning_capc %} は、`primaryLocationLineHash` のみを使用します。 | -| `codeFlows[].threadFlows[].locations[]` | **任意。**`threadFlow` オブジェクトに対する `location` オブジェクトの配列。実行スレッドを通してプログラムの進行状況を記述します。 `codeFlow` オブジェクトは、結果の検出に使用されるコード実行パターンを記述します。 コードフローが入力されている場合、{% data variables.product.prodname_code_scanning %} は、関連する結果の {% data variables.product.prodname_dotcom %} のコードフローを拡張します。 詳しい情報については、「[`location` オブジェクト](#location-object)」を参照してください。 | -| `relatedLocations[]` | この結果に関連する場所。 結果メッセージに埋め込まれている場合、{% data variables.product.prodname_code_scanning_capc %} は、関連する場所にリンクします。 詳しい情報については、「[`location` オブジェクト](#location-object)」を参照してください。 | -| `suppressions[].state` | **任意。**`state` が `accepted` に設定されている場合、{% data variables.product.prodname_code_scanning %} は {% data variables.product.prodname_dotcom %} の状態を `Closed` に更新します。 | +| `codeFlows[].threadFlows[].locations[]` | **任意。**`threadFlow` オブジェクトに対する `location` オブジェクトの配列。実行スレッドを通してプログラムの進行状況を記述します。 `codeFlow` オブジェクトは、結果の検出に使用されるコード実行パターンを記述します。 コードフローが入力されている場合、{% data variables.product.prodname_code_scanning %} は、関連する結果の {% data variables.product.prodname_dotcom %} のコードフローを拡張します。 詳しい情報については、「[`location` オブジェクト](#location-object)」を参照してください。 | +| `relatedLocations[]` | この結果に関連する場所。 結果メッセージに埋め込まれている場合、{% data variables.product.prodname_code_scanning_capc %} は、関連する場所にリンクします。 詳しい情報については、「[`location` オブジェクト](#location-object)」を参照してください。 | +| `suppressions[].state` | **任意。**`state` が `accepted` に設定されている場合、{% data variables.product.prodname_code_scanning %} は {% data variables.product.prodname_dotcom %} の状態を `Closed` に更新します。 | #### `location` オブジェクト @@ -100,13 +105,13 @@ SARIF の使用が初めてで、詳細を確認する必要がある場合は #### `physicalLocation` オブジェクト -| 名前 | 説明 | -| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 名前 | 説明 | +| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `artifactLocation.uri` | **必須。**アーティファクトの場所を示す URI（通常はリポジトリ内のファイル、またはビルド中に生成されたファイル）。 URI が相対の場合、分析されている {% data variables.product.prodname_dotcom %} リポジトリのルートに相対である必要があります。 たとえば、main.js または src/script.js は、リポジトリのルートを基準にしています。 URI が絶対の場合、{% data variables.product.prodname_code_scanning %} は URI を使用してアーティファクトをチェックアウトし、リポジトリ内のファイルを照合できます。 例: `https://github.com/github/example/blob/00/src/promiseUtils.js` | -| `region.startLine` | **必須。**リージョンの最初の文字の行番号。 | -| `region.startColumn` | **必須。**リージョンの最初の文字の列番号。 | -| `region.endLine` | **必須。**リージョンの最後の文字の行番号。 | -| `region.endColumn` | **必須。**リージョンの末尾に続く文字の列番号。 | +| `region.startLine` | **必須。**リージョンの最初の文字の行番号。 | +| `region.startColumn` | **必須。**リージョンの最初の文字の列番号。 | +| `region.endLine` | **必須。**リージョンの最後の文字の行番号。 | +| `region.endColumn` | **必須。**リージョンの末尾に続く文字の列番号。 | ### SARIF 出力ファイルの例 @@ -119,38 +124,47 @@ SARIF の使用が初めてで、詳細を確認する必要がある場合は ```json { - "$schema" : "https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json", - "version" : "2.1.0", - "runs" : - [ + "$schema": "https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json", + "version": "2.1.0", + "runs": [ { - "tool" : { - "driver" : { - "name" : "Tool Name" - } - }, - "results" : [ { - "message" : { - "text" : "Result text. This result does not have a rule associated." - }, - "locations" : [ { - "physicalLocation" : { - "artifactLocation" : { - "uri" : "src/build.cmd" - }, - "region" : { - "startLine" : 2, - "startColumn" : 7, - "endColumn" : 10 + "tool": { + "driver": { + "name": "Tool Name", + "rules": [ + { + "id": "R01" } + ] + } + }, + "results": [ + { + "ruleId": "R01", + "message": { + "text": "Result text. This result does not have a rule associated." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "fileURI" + }, + "region": { + "startLine": 2, + "startColumn": 7, + "endColumn": 10 + } + } } - } ], - "partialFingerprints" : { - "primaryLocationLineHash" : "39fa2ee980eb94b0:1" + ], + "partialFingerprints": { + "primaryLocationLineHash": "39fa2ee980eb94b0:1" + } } - }] - } - ] + ] + } + ] } ``` @@ -170,7 +184,7 @@ SARIF の使用が初めてで、詳細を確認する必要がある場合は "semanticVersion": "2.0.0", "rules": [ { - "id": "js/unused-local-variable", + "id": "3f292041e51d22005ce48f39df3585d44ce1b0ad", "name": "js/unused-local-variable", "shortDescription": { "text": "Unused variable, import, function or class" @@ -189,7 +203,7 @@ SARIF の使用が初めてで、詳細を確認する必要がある場合は } }, { - "id": "js/inconsistent-use-of-new", + "id": "d5b664aefd5ca4b21b52fdc1d744d7d6ab6886d0", "name": "js/inconsistent-use-of-new", "shortDescription": { "text": "Inconsistent use of 'new'" @@ -197,7 +211,6 @@ SARIF の使用が初めてで、詳細を確認する必要がある場合は "fullDescription": { "text": "If a function is intended to be a constructor, it should always be invoked with 'new'. Otherwise, it should always be invoked as a normal function, that is, without 'new'." }, - "defaultConfiguration": null, "properties": { "tags": [ "reliability", @@ -206,13 +219,16 @@ SARIF の使用が初めてで、詳細を確認する必要がある場合は ], "precision": "very-high" } + }, + { + "id": "R01" } ] } }, "results": [ { - "ruleId": "js/unused-local-variable", + "ruleId": "3f292041e51d22005ce48f39df3585d44ce1b0ad", "ruleIndex": 0, "message": { "text": "Unused variable foo." @@ -222,8 +238,7 @@ SARIF の使用が初めてで、詳細を確認する必要がある場合は "physicalLocation": { "artifactLocation": { "uri": "main.js", - "uriBaseId": "%SRCROOT%", - "index": 0 + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 2, @@ -239,7 +254,7 @@ SARIF の使用が初めてで、詳細を確認する必要がある場合は } }, { - "ruleId": "js/inconsistent-use-of-new", + "ruleId": "d5b664aefd5ca4b21b52fdc1d744d7d6ab6886d0", "ruleIndex": 1, "message": { "text": "Function resolvingPromise is sometimes invoked as a constructor (for example [here](1)), and sometimes as a normal function (for example [here](2))." @@ -248,8 +263,8 @@ SARIF の使用が初めてで、詳細を確認する必要がある場合は { "physicalLocation": { "artifactLocation": { - "uri": "https://github.com/github/example/blob/0000000000000000000000000000000000000000/src/promiseUtils.js", - "index": 1 + "uri": "src/promises.js", + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 2 @@ -267,8 +282,7 @@ SARIF の使用が初めてで、詳細を確認する必要がある場合は "physicalLocation": { "artifactLocation": { "uri": "src/ParseObject.js", - "uriBaseId": "%SRCROOT%", - "index": 3 + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 2281, @@ -285,8 +299,7 @@ SARIF の使用が初めてで、詳細を確認する必要がある場合は "physicalLocation": { "artifactLocation": { "uri": "src/LiveQueryClient.js", - "uriBaseId": "%SRCROOT%", - "index": 2 + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 166 @@ -299,6 +312,7 @@ SARIF の使用が初めてで、詳細を確認する必要がある場合は ] }, { + "ruleId": "R01", "message": { "text": "Specifying both [ruleIndex](1) and [ruleID](2) might lead to inconsistencies." }, @@ -308,8 +322,7 @@ SARIF の使用が初めてで、詳細を確認する必要がある場合は "physicalLocation": { "artifactLocation": { "uri": "full.sarif", - "uriBaseId": "%SRCROOT%", - "index": 0 + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 54, @@ -403,12 +416,6 @@ SARIF の使用が初めてで、詳細を確認する必要がある場合は } } ], - "newlineSequences": [ - "\r\n", - "\n", - "", - "
 " - ], "columnKind": "utf16CodeUnits" } ] diff --git a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md new file mode 100644 index 000000000000..931419d50117 --- /dev/null +++ b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md @@ -0,0 +1,48 @@ +--- +title: Triaging code scanning alerts in pull requests +shortTitle: Triaging alerts in pull requests +intro: 'When {% data variables.product.prodname_code_scanning %} identifies a problem in a pull request, you can review the highlighted code and resolve the alert.' +product: '{% data reusables.gated-features.code-scanning %}' +permissions: 'People with write permission to a repository can resolve {% data variables.product.prodname_code_scanning %} alerts.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta %} + +### About {% data variables.product.prodname_code_scanning %} results on pull requests + +In repositories where {% data variables.product.prodname_code_scanning %} is configured as a pull request check, {% data variables.product.prodname_code_scanning %} checks the code in the pull request. By default, this is limited to pull requests that target the default branch or protected branches, but you can change this configuration within {% data variables.product.prodname_actions %} or in a third-party CI/CD system. If merging the changes would introduce new {% data variables.product.prodname_code_scanning %} alerts to the target branch, these are reported as check results in the pull request. The alerts are also shown as annotations in the **Files changed** tab of the pull request. If you have write permission for the repository, you can see any existing {% data variables.product.prodname_code_scanning %} alerts on the **Security** tab. For information about repository alerts, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." + +If {% data variables.product.prodname_code_scanning %} has any results with a severity of `error`, the check fails and the error is reported in the check results. If all the results found by {% data variables.product.prodname_code_scanning %} have lower severities, the alerts are treated as warnings or notices and the check succeeds. If your pull request targets a protected branch, and the repository owner has configured required status checks, then you must either fix or close any error alerts before the pull request can be merged. For more information, see "[About required status checks](/github/administering-a-repository/about-required-status-checks)." + +![Example pull request check status with {% data variables.product.prodname_code_scanning %} alert](/assets/images/help/repository/code-scanning-check-failure.png) + +### About {% data variables.product.prodname_code_scanning %} as a pull request check + +There are many options for configuring {% data variables.product.prodname_code_scanning %} as a pull request check, so the exact setup of each repository will vary and some will have more than one check. The check that contains the results of {% data variables.product.prodname_code_scanning %} is: **Code scanning results**. + +If the repository uses the {% data variables.product.prodname_codeql_workflow %} a **{% data variables.product.prodname_codeql %} / Analyze (LANGUAGE)** check is run for each language before the results check runs. The analysis check may fail if there are configuration problems, or if the pull request breaks the build for a language that the analysis needs to compile (for example, C/C++, C#, or Java). As with other pull request checks, you can see full details of the check failure on the **Checks** tab. For more information about configuring and troubleshooting, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" or "[Troubleshooting {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning)." + +### Triaging an alert on your pull request + +When you look at the **Files changed** tab for a pull request, you see annotations for any lines of code that triggered the alert. + +![Example {% data variables.product.prodname_code_scanning %} alert shown as an annotation in the "Files changed" view of a pull request](/assets/images/help/repository/code-scanning-pr-annotation.png) + +Some annotations contain links with extra context for the alert. In the example above, from {% data variables.product.prodname_codeql %} analysis, you can click **user-provided value** to see where the untrusted data enters the data flow (this is referred to as the source). In this case you can view the full path from the source to the code that uses the data (the sink) by clicking **Show paths**. This makes it easy to check whether the data is untrusted or if the analysis failed to recognize a data sanitization step between the source and the sink. For information about analyzing data flow using {% data variables.product.prodname_codeql %}, see "[About data flow analysis](https://help.semmle.com/QL/learn-ql/intro-to-data-flow.html)." + +For more information about an alert, click **Show more details** on the annotation. This allows you to see all of the context and metadata provided by the tool in an alert view. In the example below, you can see tags showing the severity, type, and relevant common weakness enumerations (CWEs) for the problem. The view also shows which commit introduced the problem. + +Alerts from some tools, like {% data variables.product.prodname_codeql %}, also include a description and a **Show more** link for guidance on how to fix the problem in the code. + +![Example of "Show more details" for a {% data variables.product.prodname_code_scanning %} alert in a pull request](/assets/images/help/repository/code-scanning-pr-alert.png) + +### Resolving an alert on your pull request + +Anyone with write permission for a repository can resolve alerts on a pull request. If you commit changes to the pull request this triggers a new run of the pull request checks. If your changes fix the problem, the alert is resolved and the annotation removed. + +If you don't think that an alert needs to be fixed, you can close the alert manually. {% data reusables.code-scanning.close-alert-examples %} The **Close** button is available in annotations and in the alerts view if you have write permission for the repository. + +{% data reusables.code-scanning.false-positive-fix-codeql %} diff --git a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md new file mode 100644 index 000000000000..de07f8176806 --- /dev/null +++ b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md @@ -0,0 +1,52 @@ +--- +title: Troubleshooting CodeQL code scanning in your CI system +shortTitle: Troubleshooting in your CI +intro: 'If you''re having problems with the {% data variables.product.prodname_codeql_runner %}, you can troubleshoot by using these tips.' +product: '{% data reusables.gated-features.code-scanning %}' +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning-in-your-ci-system +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta-codeql-runner %} +{% data reusables.code-scanning.beta %} + +### The `init` command takes too long + +Before the {% data variables.product.prodname_codeql_runner %} can build and analyze code, it needs access to the {% data variables.product.prodname_codeql %} bundle, which contains the {% data variables.product.prodname_codeql %} CLI and the {% data variables.product.prodname_codeql %} libraries. + +When you use the {% data variables.product.prodname_codeql_runner %} for the first time on your machine, the `init` command downloads the {% data variables.product.prodname_codeql %} bundle to your machine. This download can take a few minutes. The {% data variables.product.prodname_codeql %} bundle is cached between runs, so if you use the {% data variables.product.prodname_codeql_runner %} again on the same machine, it won't download the {% data variables.product.prodname_codeql %} bundle again. + +To avoid this automatic download, you can manually download the {% data variables.product.prodname_codeql %} bundle to your machine and specify the path using the `--codeql-path` flag of the `init` command. + +### ビルド中にコードが見つからない + +If the `analyze` command for the {% data variables.product.prodname_codeql_runner %} fails with an error `No source code was seen during the build`, this indicates that {% data variables.product.prodname_codeql %} was unable to monitor your code. Several reasons can explain such a failure. + +1. 自動言語検出により、サポートされている言語が特定されたが、リポジトリにその言語の分析可能なコードがない。 一般的な例としては、言語検出サービスが `.h` や `.gyp` ファイルなどの特定のプログラミング言語に関連付けられたファイルを見つけたが、対応する実行可能コードがリポジトリに存在しない場合です。 To solve the problem, you can manually define the languages you want to analyze by using the `--languages` flag of the `init` command. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system)." + +1. You're analyzing a compiled language without using the `autobuild` command and you run the build steps yourself after the `init` step. For the build to work, you must set up the environment such that the {% data variables.product.prodname_codeql_runner %} can monitor the code. The `init` command generates instructions for how to export the required environment variables, so you can copy and run the script after you've run the `init` command. + - On macOS and Linux: + ```shell + $ . codeql-runner/codeql-env.sh + ``` + - On Windows, using the Command shell (`cmd`) or a batch file (`.bat`): + ```shell + > call codeql-runner\codeql-env.bat + ``` + - On Windows, using PowerShell: + ```shell + > cat codeql-runner\codeql-env.sh | Invoke-Expression + ``` + + The environment variables are also stored in the file `codeql-runner/codeql-env.json`. This file contains a single JSON object which maps environment variable keys to values. If you can't run the script generated by the `init` command, then you can use the data in JSON format instead. + + {% note %} + + **Note:** If you used the `--temp-dir` flag of the `init` command to specify a custom directory for temporary files, the path to the `codeql-env` files might be different. + + {% endnote %} + +1. The code is built in a container or on a separate machine. If you use a containerized build or if you outsource the build to another machine, make sure to run the {% data variables.product.prodname_codeql_runner %} in the container or on the machine where your build task takes place. diff --git a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md new file mode 100644 index 000000000000..f42dbb3db617 --- /dev/null +++ b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md @@ -0,0 +1,125 @@ +--- +title: Troubleshooting the CodeQL workflow +shortTitle: Troubleshooting CodeQL +intro: 'If you''re having problems with {% data variables.product.prodname_code_scanning %}, you can troubleshoot by using these tips for resolving issues.' +product: '{% data reusables.gated-features.code-scanning %}' +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta %} + +### Automatic build for a compiled language fails + +If an automatic build of code for a compiled language within your project fails, try the following troubleshooting steps. + +- Remove the `autobuild` step from your {% data variables.product.prodname_code_scanning %} workflow and add specific build steps. For information about editing the workflow, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)." For more information about replacing the `autobuild` step, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." + +- If your workflow doesn't explicitly specify the languages to analyze, {% data variables.product.prodname_codeql %} implicitly detects the supported languages in your code base. In this configuration, out of the compiled languages C/C++, C#, and Java, {% data variables.product.prodname_codeql %} only analyzes the language with the most source files. Edit the workflow and add a build matrix specifying the languages you want to analyze. The default CodeQL analysis workflow uses such a matrix. + + The following extracts from a workflow show how you can use a matrix within the job strategy to specify languages, and then reference each language within the "Initialize {% data variables.product.prodname_codeql %}" step: + + ```yaml + jobs: + analyze: + ... + strategy: + fail-fast: false + matrix: + language: ['csharp', 'cpp', 'javascript'] + + ... + + - name: Initialize {% data variables.product.prodname_codeql %} + uses: github/codeql-action/init@v1 + with: + languages: {% raw %}${{ matrix.language }}{% endraw %} + ``` + + For more information about editing the workflow, see "[Configuring code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." + +### No code found during the build + +If your workflow fails with an error `No source code was seen during the build` or `The process '/opt/hostedtoolcache/CodeQL/0.0.0-20200630/x64/codeql/codeql' failed with exit code 32`, this indicates that {% data variables.product.prodname_codeql %} was unable to monitor your code. Several reasons can explain such a failure: + +1. Automatic language detection identified a supported language, but there is no analyzable code of that language in the repository. A typical example is when our language detection service finds a file associated with a particular programming language like a `.h`, or `.gyp` file, but no corresponding executable code is present in the repository. To solve the problem, you can manually define the languages you want to analyze by updating the list of languages in the `language` matrix. For example, the following configuration will analyze only Go, and JavaScript. + + ```yaml + strategy: + fail-fast: false + matrix: + # Override automatic language detection by changing the list below + # Supported options are: + # ['csharp', 'cpp', 'go', 'java', 'javascript', 'python'] + language: ['go', 'javascript'] + ``` +For more information, see the workflow extract in "[Automatic build for a compiled language fails](#automatic-build-for-a-compiled-language-fails)" above. +1. Your {% data variables.product.prodname_code_scanning %} workflow is analyzing a compiled language (C, C++, C#, or Java), but the code was not compiled. By default, the {% data variables.product.prodname_codeql %} analysis workflow contains an `autobuild` step, however, this step represents a best effort process, and may not succeed in building your code, depending on your specific build environment. Compilation may also fail if you have removed the `autobuild` step and did not include build steps manually. For more information about specifying build steps, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." +1. Your workflow is analyzing a compiled language (C, C++, C#, or Java), but portions of your build are cached to improve performance (most likely to occur with build systems like Gradle or Bazel). Since {% data variables.product.prodname_codeql %} observes the activity of the compiler to understand the data flows in a repository, {% data variables.product.prodname_codeql %} requires a complete build to take place in order to perform analysis. +1. Your workflow is analyzing a compiled language (C, C++, C#, or Java), but compilation does not occur between the `init` and `analyze` steps in the workflow. {% data variables.product.prodname_codeql %} requires that your build happens in between these two steps in order to observe the activity of the compiler and perform analysis. +1. Your compiled code (in C, C++, C#, or Java) was compiled successfully, but {% data variables.product.prodname_codeql %} was unable to detect the compiler invocations. The most common causes are certain configuration options like running your build process in a container, if you're building using a distributed build system external to {% data variables.product.prodname_actions %} using a daemon process, or if {% data variables.product.prodname_codeql %} isn't aware of the specific compiler you are using. + + For C# projects using either `dotnet build` or `msbuild` which target .NET Core 2, you should specify `/p:UseSharedCompilation=false` in your workflow's `run` step, when you build your code. The `UseSharedCompilation` flag isn't necessary for .NET Core 3.0 and later. + + For example, the following configuration for C# will pass the flag during the first build step. + + ``` yaml + - run: | + dotnet build /p:UseSharedCompilation=false + ``` + + If you encounter another problem with your specific compiler or configuration, contact {% data variables.contact.contact_support %}. + +For more information about specifying build steps, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." + +### Portions of my repository were not analyzed using `autobuild` + +The {% data variables.product.prodname_codeql %} `autobuild` feature uses heuristics to build the code in a repository, however, sometimes this approach results in incomplete analysis of a repository. For example, when multiple `build.sh` commands exist in a single repository, the analysis may not complete since the `autobuild` step will only execute one of the commands. The solution is to replace the `autobuild` step with build steps which build all of the source code which you wish to analyze. For more information, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." + +### Error: "Server error" + +If the run of a workflow for {% data variables.product.prodname_code_scanning %} fails due to a server error, try running the workflow again. If the problem persists, contact {% data variables.contact.contact_support %}. + +### Error: "Out of disk" or "Out of memory" + +On very large projects, {% data variables.product.prodname_codeql %} may run out of disk or memory on the runner. +{% if currentVersion == "free-pro-team@latest" %}If you encounter this issue on a hosted {% data variables.product.prodname_actions %} runner, contact {% data variables.contact.contact_support %} so that we can investigate the problem. +{% else %}If you encounter this issue, try increasing the memory on the runner.{% endif %} + +### The build takes too long + +If your build with {% data variables.product.prodname_codeql %} analysis takes too long to run, there are several approaches you can try to reduce the build time. + +#### Increase the memory or cores + +If you use self-hosted runners to run {% data variables.product.prodname_codeql %} analysis, you can increase the memory or the number of cores on those runners. + +#### Use matrix builds to parallelize the analysis + +The default {% data variables.product.prodname_codeql_workflow %} uses a build matrix of languages, which causes the analysis of each language to run in parallel. If you have specified the languages you want to analyze directly in the "Initialize CodeQL" step, analysis of each language will happen sequentially. To speed up analysis of multiple languages, modify your workflow to use a matrix. For more information, see the workflow extract in "[Automatic build for a compiled language fails](#automatic-build-for-a-compiled-language-fails)" above. + +#### Reduce the amount of code being analyzed in a single workflow + +Analysis time is typically proportional to the amount of code being analyzed. You can reduce the analysis time by reducing the amount of code being analyzed at once, for example, by excluding test code, or breaking analysis into multiple workflows that analyze only a subset of your code at a time. + +For compiled languages like Java, C, C++, and C#, {% data variables.product.prodname_codeql %} analyzes all of the code which was built during the workflow run. To limit the amount of code being analyzed, build only the code which you wish to analyze by specifying your own build steps in a `run` block. You can combine specifying your own build steps with using the `paths` or `paths-ignore` filters on the `pull_request` and `push` events to ensure that your workflow only runs when specific code is changed. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)." + +For interpreted languages like Go, JavaScript, Python, and TypeScript, that {% data variables.product.prodname_codeql %} analyzes without a specific build, you can specify additional configuration options to limit the amount of code to analyze. For more information, see "[Specifying directories to scan](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#specifying-directories-to-scan)." + +If you split your analysis into multiple workflows as described above, we still recommend that you have at least one workflow which runs on a `schedule` which analyzes all of the code in your repository. Because {% data variables.product.prodname_codeql %} analyzes data flows between components, some complex security behaviors may only be detected on a complete build. + +#### Run only during a `schedule` event + +If your analysis is still too slow to be run during `push` or `pull_request` events, then you may want to only trigger analysis on the `schedule` event. For more information, see "[Events](/actions/learn-github-actions/introduction-to-github-actions#events)." + +{% if currentVersion == "free-pro-team@latest" %} +### Results differ between analysis platforms + +If you are analyzing code written in Python, you may see different results depending on whether you run the {% data variables.product.prodname_codeql_workflow %} on Linux, macOS, or Windows. + +On GitHub-hosted runners that use Linux, the {% data variables.product.prodname_codeql_workflow %} tries to install and analyze Python dependencies, which could lead to more results. To disable the auto-install, add `setup-python-dependencies: false` to the "Initialize CodeQL" step of the workflow. For more information about configuring the analysis of Python dependencies, see "[Analyzing Python dependencies](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#analyzing-python-dependencies)." + +{% endif %} \ No newline at end of file diff --git a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md index 6c8edc4ea005..fcc913201416 100644 --- a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md +++ b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md @@ -16,7 +16,7 @@ versions: ### {% data variables.product.prodname_code_scanning %} に対する SARIF ファイルのアップロードについて -SARIF ファイルに `partialFingerprints` が含まれていない場合、`upload-sarif` アクションは、`partialFingerprints` フィールドを計算し、アラートの重複を防止しようと試みます。 {% data variables.product.prodname_dotcom %} は、リポジトリに SARIF ファイルと静的分析で使用されるソースコードの両方が含まれている場合にのみ、`partialFingerprints` を作成できます。 詳しい情報については、「[{% data variables.product.prodname_code_scanning %} からのアラートを管理する](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)」を参照してください。 +SARIF ファイルに `partialFingerprints` が含まれていない場合、`upload-sarif` アクションは、`partialFingerprints` フィールドを計算し、アラートの重複を防止しようと試みます。 {% data variables.product.prodname_dotcom %} は、リポジトリに SARIF ファイルと静的分析で使用されるソースコードの両方が含まれている場合にのみ、`partialFingerprints` を作成できます。 For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." You can generate SARIF files using many static analysis security testing tools, including {% data variables.product.prodname_codeql %}. The results must use SARIF version 2.1.0. 詳しい情報については、「[コードスキャンに対する SARIF サポートについて](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-sarif-support-for-code-scanning)」を参照してください。 @@ -24,12 +24,12 @@ You can upload the results using {% data variables.product.prodname_actions %}{% - {% data variables.product.prodname_actions %} to run the {% data variables.product.prodname_codeql %} action, there is no further action required. SARIF ファイルは、ファイルのアップロードに使用したものと同じ {% data variables.product.prodname_actions %} ワークフローで実行する SARIF 互換の分析ツールから生成できます。 - "[ワークフロー実行の管理](/actions/configuring-and-managing-workflows/managing-a-workflow-run#viewing-your-workflow-history)" -- {% data variables.product.prodname_dotcom %} は、リポジトリにアップロードされた SARIF ファイルからの {% data variables.product.prodname_code_scanning %} アラートを表示します。 詳しい情報については、「[{% data variables.product.prodname_code_scanning %} からのアラートを管理する](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)」を参照してください。 +- {% data variables.product.prodname_dotcom %} は、リポジトリにアップロードされた SARIF ファイルからの {% data variables.product.prodname_code_scanning %} アラートを表示します。 If you block the automatic upload, when you are ready to upload results you can use the `upload` command (for more information, see "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)"). - A tool that generates results as an artifact outside of your repository, you can use the {% data variables.product.prodname_code_scanning %} API to upload the file (for more information, see "[Upload a SARIF file](/rest/reference/code-scanning#upload-a-sarif-file)"). ### {% data variables.product.prodname_actions %} での {% data variables.product.prodname_code_scanning %} 分析をアップロードする -サードパーティの SARIF ファイルを {% data variables.product.prodname_dotcom %} にアップロードするには、{% data variables.product.prodname_actions %} ワークフローが必要です。 詳しい情報については、「[{% data variables.product.prodname_actions %} について](/actions/getting-started-with-github-actions/about-github-actions)」および「[ワークフローを設定する](/actions/configuring-and-managing-workflows/configuring-a-workflow)」を参照してください。 +サードパーティの SARIF ファイルを {% data variables.product.prodname_dotcom %} にアップロードするには、{% data variables.product.prodname_actions %} ワークフローが必要です。 For more information, see "[Learn {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)" and "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." ワークフローは、`upload-sarif` アクションを使用する必要があります。 これには、アップロードの設定に使用できる入力パラメータがあります。 使用する主な入力パラメータは、アップロードする SARIF ファイルのファイルまたはディレクトリを設定する `sarif-file` です。 ディレクトリまたはファイルのパスは、リポジトリのルートからの相対パスです。 詳しい情報については、「[`upload-sarif` アクション](https://github.com/github/codeql-action/tree/HEAD/upload-sarif)」を参照してください。 @@ -43,7 +43,7 @@ SARIF ファイルをリポジトリにコミットした後でアップロー この例のワークフローは、コミットがリポジトリにプッシュされるたびに実行されます。 アクションは `partialFingerprints` プロパティを使用して、変更が発生したかどうかを判断します。 コミットがプッシュされたときに実行されるだけでなく、ワークフローは週に 1 回実行されるようにスケジュールされます。 詳しい情報については、「[ワークフローをトリガーするイベント](/actions/reference/events-that-trigger-workflows)」を参照してください。 -このワークフローは、リポジトリのルートにある `results.sarif` ファイルをアップロードします。 ワークフローファイルの作成に関する詳細な情報については「[ワークフローを設定する](/actions/configuring-and-managing-workflows/configuring-a-workflow)」を参照してください。 +このワークフローは、リポジトリのルートにある `results.sarif` ファイルをアップロードします。 For more information about creating a workflow file, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." または、このワークフローを変更して、SARIF ファイルのディレクトリをアップロードすることもできます。 たとえば、すべての SARIF ファイルをリポジトリのルートにある `sarif-output` というディレクトリに配置し、アクションの入力パラメータ `sarif_file` を `sarif-output` に設定できます。 @@ -73,11 +73,11 @@ jobs: #### ESLint 分析ツールを実行するワークフローの例 -継続的インテグレーション（CI）ワークフローの一部としてサードパーティの SARIF ファイルを生成する場合は、CI テストの実行後のステップとして、`upload-sarif` アクションを追加できます。 CI ワークフローがない場合は、{% data variables.product.prodname_actions %} テンプレートを使用して作成できます。 詳しい情報については「[事前設定されたワークフローテンプレートで始める](/actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates)」を参照してください。 +継続的インテグレーション（CI）ワークフローの一部としてサードパーティの SARIF ファイルを生成する場合は、CI テストの実行後のステップとして、`upload-sarif` アクションを追加できます。 CI ワークフローがない場合は、{% data variables.product.prodname_actions %} テンプレートを使用して作成できます。 詳しい情報については、「[{% data variables.product.prodname_actions %} のクイックスタート](/actions/quickstart)」を参照してください。 この例のワークフローは、コミットがリポジトリにプッシュされるたびに実行されます。 アクションは `partialFingerprints` プロパティを使用して、変更が発生したかどうかを判断します。 コミットがプッシュされたときに実行されるだけでなく、ワークフローは週に 1 回実行されるようにスケジュールされます。 詳しい情報については、「[ワークフローをトリガーするイベント](/actions/reference/events-that-trigger-workflows)」を参照してください。 -ワークフローでは、ESLint 静的分析ツールをワークフローのステップとして実行する例を示しています。 `Run ESLint` ステップは ESLint ツールを実行して、`results.sarif` ファイルを出力します。 次に、ワークフローは `upload-sarif` アクションを使用して、`results.sarif` ファイルを {% data variables.product.prodname_dotcom %} にアップロードします。 ワークフローファイルの作成に関する詳細な情報については「[ワークフローを設定する](/actions/configuring-and-managing-workflows/configuring-a-workflow)」を参照してください。 +ワークフローでは、ESLint 静的分析ツールをワークフローのステップとして実行する例を示しています。 `Run ESLint` ステップは ESLint ツールを実行して、`results.sarif` ファイルを出力します。 次に、ワークフローは `upload-sarif` アクションを使用して、`results.sarif` ファイルを {% data variables.product.prodname_dotcom %} にアップロードします。 For more information about creating a workflow file, see "[Introduction to GitHub Actions](/actions/learn-github-actions/introduction-to-github-actions)." ```yml name: "ESLint analysis" @@ -109,6 +109,6 @@ jobs: ### 参考リンク - "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions)" -- "[Managing a workflow run](/actions/configuring-and-managing-workflows/managing-a-workflow-run#viewing-your-workflow-history)" -- "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)" +- "[Viewing your workflow history](/actions/managing-workflow-runs/viewing-workflow-run-history)" +- "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)" - "[Upload a SARIF file](/rest/reference/code-scanning#upload-a-sarif-file)" diff --git a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md new file mode 100644 index 000000000000..af71f4047d5b --- /dev/null +++ b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md @@ -0,0 +1,11 @@ +--- +title: Using CodeQL code scanning with your existing CI system +shortTitle: CodeQL CI system support +intro: 'The {% data variables.product.prodname_codeql_runner %} allows you to use your existing CI system to run {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %}.' +mapTopic: true +product: '{% data reusables.gated-features.code-scanning %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + diff --git a/translations/ja-JP/content/github/getting-started-with-github/access-permissions-on-github.md b/translations/ja-JP/content/github/getting-started-with-github/access-permissions-on-github.md index d26e6a496578..dad6f22c1d78 100644 --- a/translations/ja-JP/content/github/getting-started-with-github/access-permissions-on-github.md +++ b/translations/ja-JP/content/github/getting-started-with-github/access-permissions-on-github.md @@ -5,7 +5,7 @@ redirect_from: - /articles/what-are-the-different-types-of-team-permissions/ - /articles/what-are-the-different-access-permissions/ - /articles/access-permissions-on-github -intro: 個人のリポジトリにはコラボレータに読み取り/書き込みアクセスを許可できる一方、Organization のメンバーは、Organization のリポジトリに対してより精細なアクセス権限を持つことができます。 +intro: '個人のリポジトリにはコラボレータに読み取り/書き込みアクセスを許可できる一方、Organization のメンバーは、Organization のリポジトリに対してより精細なアクセス権限を持つことができます。' versions: free-pro-team: '*' enterprise-server: '*' @@ -17,7 +17,7 @@ versions: ### Organization アカウント -Organization のメンバーは、*owner (オーナー)*{% if currentVersion == "free-pro-team@latest" %}、*billing manager (支払いマネージャー)*、{% endif %}あるいは*member (メンバー)* ロールを持つことができます。 オーナーは、Organization に対する完全な管理者アクセスを持ち{% if currentVersion == "free-pro-team@latest" %}、支払いマネージャーは支払いの設定を管理でき{% endif %}ます。 メンバーは、その他の人のデフォルトのロールです。 Team を使って、複数のメンバーのアクセス権限を一度に管理できます。 詳しい情報については、以下を参照してください。 +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 %}. メンバーは、その他の人のデフォルトのロールです。 Team を使って、複数のメンバーのアクセス権限を一度に管理できます。 詳しい情報については、以下を参照してください。 - 「[Organization の権限レベル](/articles/permission-levels-for-an-organization)」 - [Organization のプロジェクトボード権限](/articles/project-board-permissions-for-an-organization) - [Organization のリポジトリ権限レベル](/articles/repository-permission-levels-for-an-organization) diff --git a/translations/ja-JP/content/github/getting-started-with-github/be-social.md b/translations/ja-JP/content/github/getting-started-with-github/be-social.md index 91f06ac5b069..ba9efe6e72d9 100644 --- a/translations/ja-JP/content/github/getting-started-with-github/be-social.md +++ b/translations/ja-JP/content/github/getting-started-with-github/be-social.md @@ -21,7 +21,7 @@ versions: ### リポジトリを Watch する -リポジトリを Watch して、新しいプルリクエストと Issue に関する通知を受け取ることができます。 オーナーがリポジトリを更新すると、個人ダッシュボード上で変更を見ることができます。 詳しい情報については、{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}「[サブスクリプションを表示する](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions){% else %}「[リポジトリを Watch および Watch 解除する](/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories){% endif %}」を参照してください。 +リポジトリを Watch して、新しいプルリクエストと Issue に関する通知を受け取ることができます。 オーナーがリポジトリを更新すると、個人ダッシュボード上で変更を見ることができます。 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 %}." リポジトリを Watch するには、リポジトリの上部で [**Watch**] をクリックします。 diff --git a/translations/ja-JP/content/github/getting-started-with-github/create-a-repo.md b/translations/ja-JP/content/github/getting-started-with-github/create-a-repo.md index af2377bc32f8..57fd014ad308 100644 --- a/translations/ja-JP/content/github/getting-started-with-github/create-a-repo.md +++ b/translations/ja-JP/content/github/getting-started-with-github/create-a-repo.md @@ -19,7 +19,9 @@ versions: {% data reusables.repositories.create_new %} 2. リポジトリに、短くて覚えやすい名前を入力します。 たとえば、"hello-world" といった名前です。 ![リポジトリ名を入力するフィールド](/assets/images/help/repository/create-repository-name.png) -3. 必要な場合、リポジトリの説明を追加します。 たとえば、「{% data variables.product.product_name %} の最初のリポジトリ」などです。 ![リポジトリの説明を入力するフィールド](/assets/images/help/repository/create-repository-desc.png) +3. 必要な場合、リポジトリの説明を追加します。 For example, "My first repository on +{% data variables.product.product_name %}." + ![リポジトリの説明を入力するフィールド](/assets/images/help/repository/create-repository-desc.png) {% data reusables.repositories.choose-repo-visibility %} {% data reusables.repositories.initialize-with-readme %} {% data reusables.repositories.create-repo %} diff --git a/translations/ja-JP/content/github/getting-started-with-github/faq-about-changes-to-githubs-plans.md b/translations/ja-JP/content/github/getting-started-with-github/faq-about-changes-to-githubs-plans.md index 98999c6df3e1..3d79395b9af3 100644 --- a/translations/ja-JP/content/github/getting-started-with-github/faq-about-changes-to-githubs-plans.md +++ b/translations/ja-JP/content/github/getting-started-with-github/faq-about-changes-to-githubs-plans.md @@ -1,6 +1,6 @@ --- title: GitHub のプランの変更に関する FAQ -intro: 2020 年 4 月 14 日時点で、GitHub は GitHub の主要機能がすべて無料で利用可能になったことを発表しました。 +intro: '2020 年 4 月 14 日時点で、GitHub は GitHub の主要機能がすべて無料で利用可能になったことを発表しました。' versions: free-pro-team: '*' --- @@ -57,7 +57,7 @@ GitHub アカウントをお持ちの場合は、[Team プランページ](https ### 個人の開発者向けの GitHub Free と Organization 向けの GitHub Free の違い -GitHub Free の各製品の違いに関する詳細は、「[{% data variables.product.prodname_dotcom %} の製品](/articles/github-s-products)」を参照してください。 +GitHub Freeの各製品の差異の詳細については、「[{% data variables.product.prodname_dotcom %}の製品](/articles/github-s-products)」を参照してください。 ### GitHub Team プランで割り当てられた以上の分数が必要な場合、どうすればアクションの分数を増やすことができますか？ diff --git a/translations/ja-JP/content/github/getting-started-with-github/following-people.md b/translations/ja-JP/content/github/getting-started-with-github/following-people.md index 660a4b31702a..85e6886e526a 100644 --- a/translations/ja-JP/content/github/getting-started-with-github/following-people.md +++ b/translations/ja-JP/content/github/getting-started-with-github/following-people.md @@ -1,6 +1,6 @@ --- title: 人をフォローする -intro: '{% data variables.product.product_name %} のユーザをフォローして、アクティビティに関する通知を受け取ることができます。{% if currentVersion == "free-pro-team@latest" %}また、それらのユーザのコミュニティ内でプロジェクトを見つけることもできます。{% endif %}' +intro: 'You can follow people on {% 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: @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -ユーザをフォローすると、ニュースフィードのアクティビティビューに、公開されたアクティビティが表示されます。{% if currentVersion == "free-pro-team@latest" %}フォローしているユーザがパブリックリポジトリに Star を付けると、ニュースフィードのディスカバリービューで {% data variables.product.product_name %} によっておすすめのリポジトリが紹介されます。{% endif %}ユーザをフォローするには、ユーザのプロフィールページにアクセスし、プロフィール画像の下にある [**Follow**] をクリックします。 +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, {% 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. ![ユーザのフォローボタン](/assets/images/help/profile/follow-user-button.png) diff --git a/translations/ja-JP/content/github/getting-started-with-github/fork-a-repo.md b/translations/ja-JP/content/github/getting-started-with-github/fork-a-repo.md index 526ebc862823..91d33bf15643 100644 --- a/translations/ja-JP/content/github/getting-started-with-github/fork-a-repo.md +++ b/translations/ja-JP/content/github/getting-started-with-github/fork-a-repo.md @@ -61,7 +61,9 @@ versions: 今、Spoon-Knife リポジトリのフォークがありますが、お使いのコンピュータにはそのリポジトリ内のファイルはありません。 Let's create a clone of your fork locally on your computer. -1. {% data variables.product.product_name %} で、Spoon-Knife リポジトリの**自分のフォーク**に移動します。 +1. On + +{% data variables.product.product_name %}, navigate to **your fork** of the Spoon-Knife repository. {% data reusables.repositories.copy-clone-url %} {% data reusables.command_line.open_the_multi_os_terminal %} {% data reusables.command_line.change-current-directory-clone %} @@ -86,7 +88,9 @@ Spoon-Knife リポジトリのフォークのローカルのコピーができ オリジナルのリポジトリへの変更を提案するためにプロジェクトをフォークする場合は、オリジナルまたは上流のリポジトリから、フォークのローカルのクローンへと、変更をプルするように Git を構成できます。 -1. {% data variables.product.product_name %} で、[octocat/Spoon-Knife](https://github.com/octocat/Spoon-Knife) リポジトリに移動します。 +1. On + +{% data variables.product.product_name %}, navigate to the [octocat/Spoon-Knife](https://github.com/octocat/Spoon-Knife) repository. {% data reusables.repositories.copy-clone-url %} {% data reusables.command_line.open_the_multi_os_terminal %} 4. ディレクトリを、「[ステップ 2: フォークのローカルクローンを作成する](#step-2-create-a-local-clone-of-your-fork)」でクローンしたフォークの場所に変更します。 @@ -128,7 +132,7 @@ Spoon-Knife リポジトリのフォークのローカルのコピーができ リポジトリをフォークしてプロジェクトへのコントリビューションを開始しましょう。 {% data reusables.repositories.you-can-fork %} -{% if currentVersion == "free-pro-team@latest" %}[Explore](https://github.com/explore) を閲覧して、プロジェクトを探してオープンソースのリポジトリへのコントリビューションを開始できます。 詳しい情報については、「[{% data variables.product.prodname_dotcom %} でオープンソースにコントリビュートする方法を見つける](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)」を参照してください。 +{% if currentVersion == "free-pro-team@latest" %}You can browse [Explore](https://github.com/explore) to find projects and start contributing to open source repositories. 詳しい情報については、「[{% data variables.product.prodname_dotcom %} でオープンソースにコントリビュートする方法を見つける](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)」を参照してください。 {% endif %} diff --git a/translations/ja-JP/content/github/getting-started-with-github/git-and-github-learning-resources.md b/translations/ja-JP/content/github/getting-started-with-github/git-and-github-learning-resources.md index a207b363449b..5f3015044f52 100644 --- a/translations/ja-JP/content/github/getting-started-with-github/git-and-github-learning-resources.md +++ b/translations/ja-JP/content/github/getting-started-with-github/git-and-github-learning-resources.md @@ -54,6 +54,6 @@ versions: [Code School](http://codeschool.com) によるインタラクティブな[オンラインの Git コース](http://www.codeschool.com/courses/git-real)では、数十の楽しいゲーム形式のエクササイズを含む 7 段階のサービスを提供しています。 [.gitignore テンプレート](https://github.com/github/gitignore)では、お客様のニーズに合わせることができます。 -{% data variables.product.prodname_dotcom %} のリーチを、{% if currentVersion == "free-pro-team@latest" %}[インテグレーション](/articles/about-integrations){% else %}インテグレーション{% endif %}、または[{% data variables.product.prodname_desktop %}](https://desktop.github.com) と堅牢な [Atom](https://atom.io) テキストエディタで拡張しましょう。 +Extend your {% data variables.product.prodname_dotcom %} reach through {% if currentVersion == "free-pro-team@latest" %}[integrations](/articles/about-integrations){% else %}integrations{% endif %}, or by installing [{% data variables.product.prodname_desktop %}](https://desktop.github.com) and the robust [Atom](https://atom.io) text editor. [オープンソースのガイド](https://opensource.guide/)で、オープンソースのプロジェクトを立ち上げ成長させる方法をご確認ください。 diff --git a/translations/ja-JP/content/github/getting-started-with-github/github-cli.md b/translations/ja-JP/content/github/getting-started-with-github/github-cli.md index 34f568fdc604..eaac41089f3e 100644 --- a/translations/ja-JP/content/github/getting-started-with-github/github-cli.md +++ b/translations/ja-JP/content/github/getting-started-with-github/github-cli.md @@ -6,7 +6,7 @@ versions: enterprise-server: '>2.19' --- -### {% data variables.product.prodname_cli %}について +### {% data variables.product.prodname_cli %} について {% data variables.product.prodname_cli %} is an open source tool for using {% data variables.product.product_name %} from your computer's command line. When you're working from the command line, you can use the {% data variables.product.prodname_cli %} to save time and avoid switching context. diff --git a/translations/ja-JP/content/github/getting-started-with-github/github-desktop.md b/translations/ja-JP/content/github/getting-started-with-github/github-desktop.md index ecb2b4d43ae0..286b3ebb012e 100644 --- a/translations/ja-JP/content/github/getting-started-with-github/github-desktop.md +++ b/translations/ja-JP/content/github/getting-started-with-github/github-desktop.md @@ -6,7 +6,7 @@ versions: enterprise-server: '*' --- -### {% data variables.product.prodname_desktop %}について +### {% data variables.product.prodname_desktop %} について {% data reusables.desktop.about-github-desktop %} diff --git a/translations/ja-JP/content/github/getting-started-with-github/github-for-mobile.md b/translations/ja-JP/content/github/getting-started-with-github/github-for-mobile.md index f1b87beab258..7830c46f5234 100644 --- a/translations/ja-JP/content/github/getting-started-with-github/github-for-mobile.md +++ b/translations/ja-JP/content/github/getting-started-with-github/github-for-mobile.md @@ -5,7 +5,7 @@ versions: free-pro-team: '*' --- -### {% data variables.product.prodname_mobile %}について +### {% data variables.product.prodname_mobile %} について 現在、{% data variables.product.prodname_mobile %} は {% data variables.product.prodname_dotcom_the_website %} ユーザが Android および iOS アプリとして利用できます。 @@ -23,6 +23,16 @@ versions: Android または iOS に {% data variables.product.prodname_mobile %} をインストールするには、「[{% data variables.product.prodname_mobile %}](https://github.com/mobile)」を参照してください。 +### Supported languages for {% data variables.product.prodname_mobile %} + +{% data variables.product.prodname_mobile %} is available in the following languages. + +- 日本語 +- Brazilian Portuguese +- スペイン語 + +If you configure the language on your device to a supported language, {% data variables.product.prodname_mobile %} will default to the language. You can change the language for {% data variables.product.prodname_mobile %} in {% data variables.product.prodname_mobile %}'s **Settings** menu. + ### iOS で {% data variables.product.prodname_mobile %} のユニバーサルリンクを管理する {% data variables.product.prodname_mobile %} は、iOS のユニバーサルリンクを自動的に有効にします。 {% data variables.product.product_name %} リンクをタップすると、リンク先 URL が Safari ではなく {% data variables.product.prodname_mobile %} で開きます。 詳しい情報については、Apple Developer サイトの「[Universal Links](https://developer.apple.com/ios/universal-links/)」を参照してください。 diff --git a/translations/ja-JP/content/github/getting-started-with-github/githubs-products.md b/translations/ja-JP/content/github/getting-started-with-github/githubs-products.md index 8039c3e4f9fe..da82abc93320 100644 --- a/translations/ja-JP/content/github/getting-started-with-github/githubs-products.md +++ b/translations/ja-JP/content/github/getting-started-with-github/githubs-products.md @@ -96,7 +96,7 @@ Organizationの{% data variables.product.prodname_free_team %}で利用できる - {% data variables.contact.github_support %} {% data variables.product.premium_plus_support_plan %} - {% data variables.product.prodname_insights %} -- {% data variables.product.prodname_advanced_security %} +- {% data variables.product.prodname_advanced_security %}{% if currentVersion == "free-pro-team@latest" %}. For more information, see "[About {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)" and "[About {% data variables.product.prodname_secret_scanning %}](/github/administering-a-repository/about-secret-scanning) (beta)."{% endif %}{% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %}. For more information, see "[About {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning) (beta)."{% endif %} - [Organization の {% data variables.product.prodname_learning %}](https://lab.github.com/organizations) {% data variables.product.prodname_ghe_one %} へのサインアップの詳細については、[{% data variables.product.product_name %} の販売チーム](https://enterprise.github.com/contact)にお問い合わせください。 diff --git a/translations/ja-JP/content/github/getting-started-with-github/keyboard-shortcuts.md b/translations/ja-JP/content/github/getting-started-with-github/keyboard-shortcuts.md index 5b9895c1a79d..b62eceff619c 100644 --- a/translations/ja-JP/content/github/getting-started-with-github/keyboard-shortcuts.md +++ b/translations/ja-JP/content/github/getting-started-with-github/keyboard-shortcuts.md @@ -20,22 +20,22 @@ versions: ### サイト全体のショートカット -| キーボードショートカット | 説明 | -| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| s または / | 検索バーにフォーカスします。 詳細は「[{% data variables.product.company_short %} での検索について](/articles/about-searching-on-github)」を参照してください。 | -| g n | 通知に移動します。 詳しい情報については、{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}「[通知について](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}「[通知について](/github/receiving-notifications-about-activity-on-github/about-notifications){% endif %}」を参照してください。 | -| esc | ユーザ、Issue、またはプルリクエストのホバーカードにフォーカスすると、ホバーカードが閉じ、ホバーカードが含まれている要素に再フォーカスします | +| キーボードショートカット | 説明 | +| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| s または / | 検索バーにフォーカスします。 詳細は「[{% data variables.product.company_short %} での検索について](/articles/about-searching-on-github)」を参照してください。 | +| g n | 通知に移動します。 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 %}." | +| esc | ユーザ、Issue、またはプルリクエストのホバーカードにフォーカスすると、ホバーカードが閉じ、ホバーカードが含まれている要素に再フォーカスします | ### リポジトリ -| キーボードショートカット | 説明 | -| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | -| g c | [**Code**] タブに移動します | -| g i | [**Issues**] タブに移動します。 詳細は「[Issue について](/articles/about-issues)」を参照してください。 | -| g p | [**Pull requests**] タブに移動します。 詳しい情報については[プルリクエストについて](/articles/about-pull-requests)を参照してください。 | -| g a | Go to the **Actions** tab. For more information, see "[About Actions](/actions/getting-started-with-github-actions/about-github-actions)." | -| g b | [**Projects**] タブに移動します。 詳細は「[プロジェクトボードについて](/articles/about-project-boards)」を参照してください。 | -| g w | [**Wiki**] タブに移動します。 詳細は「[ウィキについて](/articles/about-wikis)」を参照してください。 | +| キーボードショートカット | 説明 | +| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| g c | [**Code**] タブに移動します | +| g i | [**Issues**] タブに移動します。 詳細は「[Issue について](/articles/about-issues)」を参照してください。 | +| g p | [**Pull requests**] タブに移動します。 For more information, see "[About pull requests](/articles/about-pull-requests)."{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} +| g a | Go to the **Actions** tab. For more information, see "[About Actions](/actions/getting-started-with-github-actions/about-github-actions)."{% endif %} +| g b | [**Projects**] タブに移動します。 詳細は「[プロジェクトボードについて](/articles/about-project-boards)」を参照してください。 | +| g w | [**Wiki**] タブに移動します。 詳細は「[ウィキについて](/articles/about-wikis)」を参照してください。 | ### ソースコード編集 @@ -67,16 +67,16 @@ versions: ### コメント -| キーボードショートカット | 説明 | -| --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | -| control b または command b | 太字テキストの Markdown 書式を挿入します | -| control i または command i | イタリック体のテキストの Markdown 書式を挿入します | -| control k または command k | リンクを作成するための Markdown 書式を挿入します | -| control shift p または command shift p | **Write** と **Preview** のコメントタブを切り替えます。 | -| control enter | コメントをサブミットします | -| control .、次に control [返信テンプレート番号] | 返信テンプレートメニューを開き、コメントフィールドに返信テンプレートを自動入力します。 詳細は「[返信テンプレートについて](/articles/about-saved-replies)」を参照してください。{% if currentVersion == "free-pro-team@latest" %} +| キーボードショートカット | 説明 | +| --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| control b または command b | 太字テキストの Markdown 書式を挿入します | +| control i または command i | イタリック体のテキストの Markdown 書式を挿入します | +| control k または command k | リンクを作成するための Markdown 書式を挿入します | +| control shift p または command shift p | **Write** と **Preview** のコメントタブを切り替えます。 | +| control enter | コメントをサブミットします | +| control .、次に control [返信テンプレート番号] | 返信テンプレートメニューを開き、コメントフィールドに返信テンプレートを自動入力します。 For more information, see "[About saved replies](/articles/about-saved-replies)."{% if currentVersion == "free-pro-team@latest" %} | control g または command g | 提案を挿入します。 詳細は「[プルリクエストで提案された変更をレビューする](/articles/reviewing-proposed-changes-in-a-pull-request)」を参照してください。 |{% endif %} -| r | 返信で選択したテキストを引用します。 詳細は「[基本的な書き方とフォーマットの構文](/articles/basic-writing-and-formatting-syntax)」を参照してください。 | +| r | 返信で選択したテキストを引用します。 詳細は「[基本的な書き方とフォーマットの構文](/articles/basic-writing-and-formatting-syntax)」を参照してください。 | ### Issue およびプルリクエストのリスト @@ -92,24 +92,24 @@ versions: | o または enter | Issue を開きます | ### Issue およびプルリクエスト -| キーボードショートカット | 説明 | -| ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| q | レビュー担当者にリクエストします。 詳細は「[Pull Request レビューをリクエストする](/articles/requesting-a-pull-request-review/)」を参照してください。 | -| m | マイルストーンを設定します。 詳細は「[Issue およびプルリクエストにマイルストーンを関連付ける](/articles/associating-milestones-with-issues-and-pull-requests)」を参照してください。 | -| l | ラベルを適用します。 詳細は「[Issue およびプルリクエストにラベルを適用する](/articles/applying-labels-to-issues-and-pull-requests)」を参照してください。 | +| キーボードショートカット | 説明 | +| ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| q | レビュー担当者にリクエストします。 詳細は「[Pull Request レビューをリクエストする](/articles/requesting-a-pull-request-review/)」を参照してください。 | +| m | マイルストーンを設定します。 詳細は「[Issue およびプルリクエストにマイルストーンを関連付ける](/articles/associating-milestones-with-issues-and-pull-requests)」を参照してください。 | +| l | ラベルを適用します。 詳細は「[Issue およびプルリクエストにラベルを適用する](/articles/applying-labels-to-issues-and-pull-requests)」を参照してください。 | | a | アサインされた人を設定します。 詳細は「[{% data variables.product.company_short %} の他のユーザに Issue およびプルリクエストをアサインする](/articles/assigning-issues-and-pull-requests-to-other-github-users/)」を参照してください。 | -| cmd + shift + p または control + shift + p | [**Write**] タブと [**Preview**] タブを切り替えます。 | +| cmd + shift + p または control + shift + p | [**Write**] タブと [**Preview**] タブを切り替えます。 | ### プルリクエストの変更 -| キーボードショートカット | 説明 | -| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| c | プルリクエスト内のコミットのリストを開きます | -| t | プルリクエストで変更されたファイルのリストを開きます | -| j | リストで選択を下に移動します | -| k | リストで選択を上に移動します | -| cmd + shift + enter | プルリクエストの差分にコメントを 1 つ追加します | -| alt およびクリック | `alt` を押しながら、[**Show outdated**] または [**Hide outdated**] をクリックして、期限切れのレビューコメントをすべて折りたたむか展開するかを切り替えます。|{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +| キーボードショートカット | 説明 | +| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| c | プルリクエスト内のコミットのリストを開きます | +| t | プルリクエストで変更されたファイルのリストを開きます | +| j | リストで選択を下に移動します | +| k | リストで選択を上に移動します | +| cmd + shift + enter | プルリクエストの差分にコメントを 1 つ追加します | +| alt およびクリック | 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" %} | クリック後、shift およびクリック | プルリクエストの複数行にコメントするには、行番号をクリックし、shift を押したまま、別の行番号をクリックします。 詳しい情報については、「[プルリクエストへコメントする](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request#adding-line-comments-to-a-pull-request)」を参照してください。|{% endif %} ### プロジェクトボード diff --git a/translations/ja-JP/content/github/getting-started-with-github/saving-repositories-with-stars.md b/translations/ja-JP/content/github/getting-started-with-github/saving-repositories-with-stars.md index 66fd1d799cf5..55186f77b4ff 100644 --- a/translations/ja-JP/content/github/getting-started-with-github/saving-repositories-with-stars.md +++ b/translations/ja-JP/content/github/getting-started-with-github/saving-repositories-with-stars.md @@ -1,6 +1,6 @@ --- title: Star を付けてリポジトリを保存する -intro: 'リポジトリ{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.16" %}や Topics {% endif %}に Star を付けて、興味を持ったプロジェクトを追跡{% if currentVersion == "free-pro-team@latest" %}し、ニュースフィードで関連コンテンツを見つけることが{% endif %}できます。' +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/ @@ -19,7 +19,8 @@ versions: Star を付けることで、リポジトリやトピックが後で見つけやすくなります。 {% data variables.explore.your_stars_page %} にアクセスすると、Star 付きのリポジトリとトピックを確認することができます。 {% if currentVersion == "free-pro-team@latest" %} -リポジトリとトピックに Star を付けることで、{% data variables.product.product_name %} 上で類似のプロジェクトを見つけることができます。 リポジトリあるいはトピックに Star を付けると、{% data variables.product.product_name %} はニュースフィードの discovery ビューで関連するコンテンツを推薦することがあります。 詳しい情報については、「[{% data variables.product.prodname_dotcom %} でオープンソースにコントリビュートする方法を見つける](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)」を参照してください。 +You can star repositories and topics to discover similar projects on +{% data variables.product.product_name %}. リポジトリあるいはトピックに Star を付けると、{% data variables.product.product_name %} はニュースフィードの discovery ビューで関連するコンテンツを推薦することがあります。 詳しい情報については、「[{% data variables.product.prodname_dotcom %} でオープンソースにコントリビュートする方法を見つける](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)」を参照してください。 {% endif %} リポジトリに Star を付けるということは、リポジトリメンテナに対してその作業についての感謝を示すことでもあります。 {% data variables.product.prodname_dotcom %} のリポジトリランキングの多くは、リポジトリに付けられた Star の数を考慮しています。 また、[Explore](https://github.com/explore) は、リポジトリに付けられた Star の数に基づいて、人気のあるリポジトリを表示しています。 diff --git a/translations/ja-JP/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-server.md b/translations/ja-JP/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-server.md index f22330b72c89..c098700f6dd2 100644 --- a/translations/ja-JP/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-server.md +++ b/translations/ja-JP/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-server.md @@ -13,7 +13,7 @@ versions: {% data variables.product.prodname_ghe_server %} を評価するための 45 日間トライアルをリクエストできます。 トライアルは仮想アプライアンスとしてインストールされ、オンプレミスまたはクラウドでのデプロイメントのオプションがあります。 サポートされている仮想化プラットフォームの一覧については「[GitHub Enterprise Server インスタンスをセットアップする](/enterprise/admin/installation/setting-up-a-github-enterprise-server-instance)」を参照してください。 -セキュリティアラートと {% data variables.product.prodname_github_connect %} は、{% data variables.product.prodname_ghe_server %} のトライアルでは現在利用できません。 これらの機能のデモについては、{% data variables.contact.contact_enterprise_sales %} にお問い合わせください。 これらの機能の詳しい情報については、「[脆弱性のある依存関係に対するアラートについて](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)」 および「[{% data variables.product.prodname_ghe_server %} を {% data variables.product.prodname_dotcom_the_website %} に接続する](/enterprise/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)」を参照してください。 +{% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}Security{% endif %} alerts and {% data variables.product.prodname_github_connect %} are not currently available in trials of {% data variables.product.prodname_ghe_server %}. これらの機能のデモについては、{% data variables.contact.contact_enterprise_sales %} にお問い合わせください。 これらの機能の詳しい情報については、「[脆弱性のある依存関係に対するアラートについて](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)」 および「[{% data variables.product.prodname_ghe_server %} を {% data variables.product.prodname_dotcom_the_website %} に接続する](/enterprise/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)」を参照してください。 {% data variables.product.prodname_ghe_cloud %} のトライアルも利用できます。 詳しい情報については、「[{% data variables.product.prodname_ghe_cloud %} のトライアルを設定する](/articles/setting-up-a-trial-of-github-enterprise-cloud)」を参照してください。 diff --git a/translations/ja-JP/content/github/getting-started-with-github/supported-browsers.md b/translations/ja-JP/content/github/getting-started-with-github/supported-browsers.md index 8390e912a54f..396e8ab441c2 100644 --- a/translations/ja-JP/content/github/getting-started-with-github/supported-browsers.md +++ b/translations/ja-JP/content/github/getting-started-with-github/supported-browsers.md @@ -4,7 +4,7 @@ redirect_from: - /articles/why-doesn-t-graphs-work-with-ie-8/ - /articles/why-don-t-graphs-work-with-ie8/ - /articles/supported-browsers -intro: '{% data variables.product.product_name %} は、最新の Web ブラウザをサポートするよう設計されています。 [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 %}および [Microsoft Edge](https://www.microsoft.com/en-us/windows/microsoft-edge)の現在のバージョンをサポートしています。' +intro: '{% data variables.product.product_name %} は、最新の Web ブラウザをサポートするよう設計されています。 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: '*' diff --git a/translations/ja-JP/content/github/getting-started-with-github/types-of-github-accounts.md b/translations/ja-JP/content/github/getting-started-with-github/types-of-github-accounts.md index 7b7e4fb0f88d..cc8f23b01c69 100644 --- a/translations/ja-JP/content/github/getting-started-with-github/types-of-github-accounts.md +++ b/translations/ja-JP/content/github/getting-started-with-github/types-of-github-accounts.md @@ -1,6 +1,6 @@ --- title: GitHub アカウントの種類 -intro: 'ユーザアカウントは {% data variables.product.product_location %} 上での身分証明となります。 ユーザアカウントはいくつでも Organization のメンバーになれます。{% if currentVersion == "free-pro-team@latest" %} Organization は Enterprise アカウントに所属できます。{% endif %}' +intro: 'ユーザアカウントは {% 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/ @@ -13,7 +13,8 @@ versions: --- {% if currentVersion == "free-pro-team@latest" %} -各 {% data variables.product.product_name %} 製品の機能の完全なリストについては、「[{% data variables.product.prodname_dotcom %} の製品](/github/getting-started-with-github/githubs-products)」を参照してください。 +For a full list of features for each +{% data variables.product.product_name %} product, see "[{% data variables.product.prodname_dotcom %}'s products](/github/getting-started-with-github/githubs-products)." {% endif %} ### 個人ユーザアカウント @@ -71,6 +72,6 @@ Enterprise アカウントを使用すると、複数の {% data variables.produ ### 参考リンク -{% if currentVersion == "free-pro-team@latest" %}- "[新しい {% data variables.product.prodname_dotcom %} アカウントへのサインアップ](/articles/signing-up-for-a-new-github-account)" +{% if currentVersion == "free-pro-team@latest" %}- "[Signing up for a new {% data variables.product.prodname_dotcom %} account](/articles/signing-up-for-a-new-github-account)" - 「[{% data variables.product.prodname_dotcom %} の製品](/articles/githubs-products)」{% endif %} - 「[新しい Organization アカウントを作成する](/articles/creating-a-new-organization-account)」 diff --git a/translations/ja-JP/content/github/importing-your-projects-to-github/about-github-importer.md b/translations/ja-JP/content/github/importing-your-projects-to-github/about-github-importer.md index 07c68ba496c3..24a6f6e9838c 100644 --- a/translations/ja-JP/content/github/importing-your-projects-to-github/about-github-importer.md +++ b/translations/ja-JP/content/github/importing-your-projects-to-github/about-github-importer.md @@ -1,6 +1,6 @@ --- title: GitHub Importerについて -intro: ソースコードがSubversion、Mercurial、Team Foundation Server、あるいは他のGitリポジトリにあるなら、GitHub Importerを使ってそれをGitHubに移せます。 +intro: 'ソースコードがSubversion、Mercurial、Team Foundation Server、あるいは他のGitリポジトリにあるなら、GitHub Importerを使ってそれをGitHubに移せます。' redirect_from: - /articles/about-github-importer versions: diff --git a/translations/ja-JP/content/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line.md b/translations/ja-JP/content/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line.md index 4b1d8f88e3bf..d06ec5e27991 100644 --- a/translations/ja-JP/content/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line.md +++ b/translations/ja-JP/content/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line.md @@ -21,7 +21,10 @@ versions: {% mac %} -1. {% data variables.product.product_location %}上で[新しいリポジトリを作成](/articles/creating-a-new-repository)します。 エラーを避けるため、新しいリポジトリは*README*、ライセンス、あるいは `gitignore` で初期化しないでください。 これらのファイルは、プロジェクトを {% data variables.product.product_name %}にプッシュした後で追加できます。 ![[Create New Repository] ドロップダウン](/assets/images/help/repository/repo-create.png) +1. [Create a new repository](/articles/creating-a-new-repository) on + +{% data variables.product.product_location %}. エラーを避けるため、新しいリポジトリは*README*、ライセンス、あるいは `gitignore` で初期化しないでください。 これらのファイルは、プロジェクトを {% data variables.product.product_name %}にプッシュした後で追加できます。 + ![[Create New Repository] ドロップダウン](/assets/images/help/repository/repo-create.png) {% data reusables.command_line.open_the_multi_os_terminal %} 3. ワーキングディレクトリをローカルプロジェクトに変更します。 4. ローカルディレクトリを Git リポジトリとして初期化します。 @@ -48,15 +51,18 @@ versions: ``` 9. {% data variables.product.product_location %} へ、ローカルリポジトリの[変更をプッシュ](/articles/pushing-commits-to-a-remote-repository/)します。 ```shell - $ git push -u origin master - # origin として指定したリモートリポジトリにローカルリポジトリの変更をプッシュ + $ git push -u origin main + # Pushes the changes in your local repository up to the remote repository you specified as the origin ``` {% endmac %} {% windows %} -1. {% data variables.product.product_location %}上で[新しいリポジトリを作成](/articles/creating-a-new-repository)します。 エラーを避けるため、新しいリポジトリは*README*、ライセンス、あるいは `gitignore` で初期化しないでください。 これらのファイルは、プロジェクトを {% data variables.product.product_name %}にプッシュした後で追加できます。 ![[Create New Repository] ドロップダウン](/assets/images/help/repository/repo-create.png) +1. [Create a new repository](/articles/creating-a-new-repository) on + +{% data variables.product.product_location %}. エラーを避けるため、新しいリポジトリは*README*、ライセンス、あるいは `gitignore` で初期化しないでください。 これらのファイルは、プロジェクトを {% data variables.product.product_name %}にプッシュした後で追加できます。 + ![[Create New Repository] ドロップダウン](/assets/images/help/repository/repo-create.png) {% data reusables.command_line.open_the_multi_os_terminal %} 3. ワーキングディレクトリをローカルプロジェクトに変更します。 4. ローカルディレクトリを Git リポジトリとして初期化します。 @@ -83,15 +89,18 @@ versions: ``` 9. {% data variables.product.product_location %} へ、ローカルリポジトリの[変更をプッシュ](/articles/pushing-commits-to-a-remote-repository/)します。 ```shell - $ git push origin master - # origin として指定したリモートリポジトリにローカルリポジトリの変更をプッシュ + $ git push origin main + # Pushes the changes in your local repository up to the remote repository you specified as the origin ``` {% endwindows %} {% linux %} -1. {% data variables.product.product_location %}上で[新しいリポジトリを作成](/articles/creating-a-new-repository)します。 エラーを避けるため、新しいリポジトリは*README*、ライセンス、あるいは `gitignore` で初期化しないでください。 これらのファイルは、プロジェクトを {% data variables.product.product_name %}にプッシュした後で追加できます。 ![[Create New Repository] ドロップダウン](/assets/images/help/repository/repo-create.png) +1. [Create a new repository](/articles/creating-a-new-repository) on + +{% data variables.product.product_location %}. エラーを避けるため、新しいリポジトリは*README*、ライセンス、あるいは `gitignore` で初期化しないでください。 これらのファイルは、プロジェクトを {% data variables.product.product_name %}にプッシュした後で追加できます。 + ![[Create New Repository] ドロップダウン](/assets/images/help/repository/repo-create.png) {% data reusables.command_line.open_the_multi_os_terminal %} 3. ワーキングディレクトリをローカルプロジェクトに変更します。 4. ローカルディレクトリを Git リポジトリとして初期化します。 @@ -118,8 +127,8 @@ versions: ``` 9. {% data variables.product.product_location %} へ、ローカルリポジトリの[変更をプッシュ](/articles/pushing-commits-to-a-remote-repository/)します。 ```shell - $ git push origin master - # origin として指定したリモートリポジトリにローカルリポジトリの変更をプッシュ + $ git push origin main + # Pushes the changes in your local repository up to the remote repository you specified as the origin ``` {% endlinux %} diff --git a/translations/ja-JP/content/github/importing-your-projects-to-github/importing-a-git-repository-using-the-command-line.md b/translations/ja-JP/content/github/importing-your-projects-to-github/importing-a-git-repository-using-the-command-line.md index 51d730608832..7ac93993deb3 100644 --- a/translations/ja-JP/content/github/importing-your-projects-to-github/importing-a-git-repository-using-the-command-line.md +++ b/translations/ja-JP/content/github/importing-your-projects-to-github/importing-a-git-repository-using-the-command-line.md @@ -1,6 +1,6 @@ --- title: コマンドラインを使った Git リポジトリのインポート -intro: '{% if currentVersion == "free-pro-team@latest" %}[GitHub Importer](/articles/importing-a-repository-with-github-importer) が目的に適さない、たとえば既存のコードがプライベート ネットワークにホストされているなどの場合には、コマンドライン ラインをお使いください。{% else %}既存のコードがプライベート ネットワークにホストされている場合には、コマンド ラインを使った Git プロジェクトのインポートが適しています。{% endif %}' +intro: '{% if currentVersion == "free-pro-team@latest" %}If [GitHub Importer](/articles/importing-a-repository-with-github-importer) is not suitable for your purposes, such as if your existing code is hosted on a private network, then we recommend importing using the command line.{% else %}Importing Git projects using the command line is suitable when your existing code is hosted on a private network.{% endif %}' redirect_from: - /articles/importing-a-git-repository-using-the-command-line versions: diff --git a/translations/ja-JP/content/github/importing-your-projects-to-github/importing-a-repository-with-github-importer.md b/translations/ja-JP/content/github/importing-your-projects-to-github/importing-a-repository-with-github-importer.md index bd25470ecbcd..fe9e79297e02 100644 --- a/translations/ja-JP/content/github/importing-your-projects-to-github/importing-a-repository-with-github-importer.md +++ b/translations/ja-JP/content/github/importing-your-projects-to-github/importing-a-repository-with-github-importer.md @@ -1,6 +1,6 @@ --- title: GitHub Importer でリポジトリをインポートする -intro: 他のバージョン管理システムにホストされているプロジェクトがある場合は、GitHub Importer ツールを使って自動的に GitHub にインポートすることができます。 +intro: '他のバージョン管理システムにホストされているプロジェクトがある場合は、GitHub Importer ツールを使って自動的に GitHub にインポートすることができます。' redirect_from: - /articles/importing-from-other-version-control-systems-to-github/ - /articles/importing-a-repository-with-github-importer diff --git a/translations/ja-JP/content/github/importing-your-projects-to-github/importing-source-code-to-github.md b/translations/ja-JP/content/github/importing-your-projects-to-github/importing-source-code-to-github.md index 26fb0c3e164f..999530f5176e 100644 --- a/translations/ja-JP/content/github/importing-your-projects-to-github/importing-source-code-to-github.md +++ b/translations/ja-JP/content/github/importing-your-projects-to-github/importing-source-code-to-github.md @@ -1,6 +1,6 @@ --- title: GitHub にソースコードをインポートする -intro: 'リポジトリは、{% if currentVersion == "free-pro-team@latest" %}GitHub Importer、コマンドライン、{% else %}コマンドライン{% endif %}、または外部移行ツールを使用して GitHub にインポートできます。' +intro: 'You can import repositories to GitHub using {% if currentVersion == "free-pro-team@latest" %}GitHub Importer, the command line,{% else %}the command line{% endif %} or external migration tools.' redirect_from: - /articles/importing-an-external-git-repository/ - /articles/importing-from-bitbucket/ diff --git a/translations/ja-JP/content/github/importing-your-projects-to-github/support-for-subversion-clients.md b/translations/ja-JP/content/github/importing-your-projects-to-github/support-for-subversion-clients.md index 44d797de37f9..21dc477a91df 100644 --- a/translations/ja-JP/content/github/importing-your-projects-to-github/support-for-subversion-clients.md +++ b/translations/ja-JP/content/github/importing-your-projects-to-github/support-for-subversion-clients.md @@ -47,7 +47,7 @@ Subversion チェックアウトは違います。ワーキングディレクト Subversion ブリッジを使って GitHub にブランチを作成することもできます。 -svn クライアントから、`trunk` を更新して「master」が最新であることを確認します。 +From your svn client, make sure the default branch is current by updating `trunk`: ```shell $ svn up trunk > At revision 1. diff --git a/translations/ja-JP/content/github/importing-your-projects-to-github/updating-commit-author-attribution-with-github-importer.md b/translations/ja-JP/content/github/importing-your-projects-to-github/updating-commit-author-attribution-with-github-importer.md index 5fe521a204c4..8c50bc33b21a 100644 --- a/translations/ja-JP/content/github/importing-your-projects-to-github/updating-commit-author-attribution-with-github-importer.md +++ b/translations/ja-JP/content/github/importing-your-projects-to-github/updating-commit-author-attribution-with-github-importer.md @@ -1,6 +1,6 @@ --- title: GitHub Importer でコミット作者属性を更新する -intro: インポートの間、コミット作者の GitHub アカウントのリポジトリのコミットにマッチングできます。 +intro: 'インポートの間、コミット作者の GitHub アカウントのリポジトリのコミットにマッチングできます。' redirect_from: - /articles/updating-commit-author-attribution-with-github-importer versions: diff --git a/translations/ja-JP/content/github/importing-your-projects-to-github/what-are-the-differences-between-subversion-and-git.md b/translations/ja-JP/content/github/importing-your-projects-to-github/what-are-the-differences-between-subversion-and-git.md index 1a608193c36e..e9bb672fcba6 100644 --- a/translations/ja-JP/content/github/importing-your-projects-to-github/what-are-the-differences-between-subversion-and-git.md +++ b/translations/ja-JP/content/github/importing-your-projects-to-github/what-are-the-differences-between-subversion-and-git.md @@ -1,6 +1,6 @@ --- title: Subversion と Git の違い -intro: Subversion (SVN) リポジトリは、Git リポジトリに似ています。ですが、プロジェクトのアーキテクチャの点からいくつかの違いがあります。 +intro: 'Subversion (SVN) リポジトリは、Git リポジトリに似ています。ですが、プロジェクトのアーキテクチャの点からいくつかの違いがあります。' redirect_from: - /articles/what-are-the-differences-between-svn-and-git/ - /articles/what-are-the-differences-between-subversion-and-git diff --git a/translations/ja-JP/content/github/index.md b/translations/ja-JP/content/github/index.md index a9f6e0b4e0d7..668a65c003b7 100644 --- a/translations/ja-JP/content/github/index.md +++ b/translations/ja-JP/content/github/index.md @@ -4,7 +4,7 @@ redirect_from: - /articles/ - /common-issues-and-questions/ - /troubleshooting-common-issues/ -intro: ソフトウェア開発者、設計者、およびプロジェクトマネージャーのためのドキュメント、ガイド、およびヘルプトピックです。 Git、プルリクエスト、Issues、Wiki、Gist の使用方法、および開発のために GitHub を最大限活用するために必要な全てのポイントをカバーしています。 +intro: 'ソフトウェア開発者、設計者、およびプロジェクトマネージャーのためのドキュメント、ガイド、およびヘルプトピックです。 Git、プルリクエスト、Issues、Wiki、Gist の使用方法、および開発のために GitHub を最大限活用するために必要な全てのポイントをカバーしています。' versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ja-JP/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md b/translations/ja-JP/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md index edff66d8fa54..489331d0f839 100644 --- a/translations/ja-JP/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md +++ b/translations/ja-JP/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md @@ -19,7 +19,9 @@ versions: {% data reusables.repositories.sensitive-info-warning %} -1. 自分のコンピュータ上で、{% data variables.product.product_name %}にアップロードしたいファイルを、リポジトリをクローンした際に作成したローカルディレクトリに移動します。 +1. On your computer, move the file you'd like to upload to + +{% data variables.product.product_name %} into the local directory that was created when you cloned the repository. {% data reusables.command_line.open_the_multi_os_terminal %} {% data reusables.command_line.switching_directories_procedural %} {% data reusables.git.stage_for_commit %} diff --git a/translations/ja-JP/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md b/translations/ja-JP/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md index 9ef479cffc94..e30e23cd4cc3 100644 --- a/translations/ja-JP/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md +++ b/translations/ja-JP/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md @@ -20,19 +20,19 @@ versions: {% data variables.product.product_location %} でファイルを表示する際、通常はブランチの現在の head でのバージョンが表示されます。 例: -* [https://github.com/github/hubot/blob/**master**/README.md](https://github.com/github/hubot/blob/master/README.md) +* [https://github.com/github/codeql/blob/**main**/README.md](https://github.com/github/codeql/blob/main/README.md) -GitHub の `hubot` リポジトリを参照し、`master` ブランチの `README.md` ファイルの最新バージョンが表示されます。 +refers to GitHub's `codeql` repository, and shows the `main` branch's current version of the `README.md` file. ブランチのヘッドにあるファイルのバージョンは、新たなコミットが行われるたびに変更される場合があるため、通常の URL をコピーすると、後で他のユーザが見るときはファイルのコンテンツが同一ではない場合があります。 ### y を押して特定のコミット内のファイルへのパーマリンクを取得 -表示しているファイルの特定のバージョンへのパーマリンクについては、URL 内のブランチ名 (前述の例の `master` 部など) を使用する代わりに、コミット ID を配置します。 これにより、そのコミットの完全に同じバージョンに永続的にリンクされます。 例: +For a permanent link to the specific version of a file that you see, instead of using a branch name in the URL (i.e. the `main` part in the example above), put a commit id. これにより、そのコミットの完全に同じバージョンに永続的にリンクされます。 例: -* [https://github.com/github/hubot/blob/**ed25584f5ac2520a6c28547ffd0961c7abd7ea49**/README.md](https://github.com/github/hubot/blob/ed25584f5ac2520a6c28547ffd0961c7abd7ea49/README.md) +* [https://github.com/github/codeql/blob/**b212af08a6cffbb434f3c8a2795a579e092792fd**/README.md](https://github.com/github/codeql/blob/b212af08a6cffbb434f3c8a2795a579e092792fd/README.md) -`master` を特定のコミット ID で置き換えると、ファイルのコンテンツは変更されません。 +replaces `main` with a specific commit id and the file content will not change. コミット SHA を手作業で探すのは不便ですが、ショートカットとして y を押すと、URL がパーマリンクのバージョンに自動で更新されます。 その後、URL をコピーし、共有すると、自分が表示したのとまったく同じものが表示されます。 diff --git a/translations/ja-JP/content/github/managing-files-in-a-repository/managing-files-using-the-command-line.md b/translations/ja-JP/content/github/managing-files-in-a-repository/managing-files-using-the-command-line.md index d8b378ff3fea..3b0b484f6758 100644 --- a/translations/ja-JP/content/github/managing-files-in-a-repository/managing-files-using-the-command-line.md +++ b/translations/ja-JP/content/github/managing-files-in-a-repository/managing-files-using-the-command-line.md @@ -1,6 +1,6 @@ --- title: コマンドラインを使用してファイルを管理する -intro: コマンドラインを使用して、リポジトリでファイルの追加、名前変更、移動を行うことができます。 +intro: 'コマンドラインを使用して、リポジトリでファイルの追加、名前変更、移動を行うことができます。' mapTopic: true redirect_from: - /articles/managing-files-using-the-command-line diff --git a/translations/ja-JP/content/github/managing-files-in-a-repository/moving-a-file-to-a-new-location.md b/translations/ja-JP/content/github/managing-files-in-a-repository/moving-a-file-to-a-new-location.md index 9718dd098c0d..7a9f2f75d1fa 100644 --- a/translations/ja-JP/content/github/managing-files-in-a-repository/moving-a-file-to-a-new-location.md +++ b/translations/ja-JP/content/github/managing-files-in-a-repository/moving-a-file-to-a-new-location.md @@ -1,6 +1,6 @@ --- title: ファイルを新しい場所に移動する -intro: 編集中のファイルは、たとえディレクトリが存在していない場合でも、リポジトリ内のどこにでも移動することができます。 +intro: '編集中のファイルは、たとえディレクトリが存在していない場合でも、リポジトリ内のどこにでも移動することができます。' redirect_from: - /articles/moving-a-file-to-a-new-location versions: diff --git a/translations/ja-JP/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md b/translations/ja-JP/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md index 729b09b615e6..9538a574e16c 100644 --- a/translations/ja-JP/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md +++ b/translations/ja-JP/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md @@ -9,9 +9,9 @@ versions: --- -カスタム JavaScript プロットなど、Notebook のインタラクティブ機能は、{% data variables.product.product_location %} のリポジトリでは機能しません。 例については、[*リンキングおよび Interactions.ipynb*](https://github.com/bokeh/bokeh-notebooks/blob/master/tutorial/06%20-%20Linking%20and%20Interactions.ipynb) を参照してください。 +カスタム JavaScript プロットなど、Notebook のインタラクティブ機能は、{% data variables.product.product_location %} のリポジトリでは機能しません。 例については、[*リンキングおよび Interactions.ipynb*](https://github.com/bokeh/bokeh-notebooks/blob/main/tutorial/06%20-%20Linking%20and%20Interactions.ipynb) を参照してください。 -レンダリングした JavaScript コンテンツで Jupyter notebook を表示する、または、notebook ファイルを他のユーザーと共有する場合、[nbviewer](https://nbviewer.jupyter.org/) を使用できます。 例については、[*nbviewerでレンダリングされたリンキングおよびInteractions.ipynb*](https://nbviewer.jupyter.org/github/bokeh/bokeh-notebooks/blob/master/tutorial/06%20-%20Linking%20and%20Interactions.ipynb) を参照してください。 +レンダリングした JavaScript コンテンツで Jupyter notebook を表示する、または、notebook ファイルを他のユーザーと共有する場合、[nbviewer](https://nbviewer.jupyter.org/) を使用できます。 例については、[*nbviewerでレンダリングされたリンキングおよびInteractions.ipynb*](https://nbviewer.jupyter.org/github/bokeh/bokeh-notebooks/blob/main/tutorial/06%20-%20Linking%20and%20Interactions.ipynb) を参照してください。 Jupyter notebook の完全にインタラクティブなバージョンを表示するには、notebook サーバーをローカルに設定します。 詳細は [Jupyter の公式ドキュメント](http://jupyter.readthedocs.io/en/latest/index.html)を参照してください。 diff --git a/translations/ja-JP/content/github/managing-large-files/about-git-large-file-storage.md b/translations/ja-JP/content/github/managing-large-files/about-git-large-file-storage.md index ca5db1a486d9..7b335afec6fa 100644 --- a/translations/ja-JP/content/github/managing-large-files/about-git-large-file-storage.md +++ b/translations/ja-JP/content/github/managing-large-files/about-git-large-file-storage.md @@ -12,17 +12,17 @@ versions: {% data variables.large_files.product_name_short %}は、リポジトリに実際のファイルではなく、ファイルへの参照を保存することで大きなファイルを扱います。 Gitのアーキテクチャを回避するために、{% data variables.large_files.product_name_short %}は実際のファイル（これはどこか別の場所に保存されます）への参照として働くポインタファイルを作成します。 {% data variables.product.product_name %}はこのポインタファイルをリポジトリ中で管理します。 リポジトリをクローンすると、{% data variables.product.product_name %}はこのポインタファイルを大きなファイルを見つけるための地図として使います。 {% if currentVersion == "free-pro-team@latest" %} -{% data variables.large_files.product_name_short %}を使用すると、最大で次のファイルサイズまで保存できます。 +Using +{% data variables.large_files.product_name_short %}, you can store files up to: -| 製品 | 最大ファイルサイズ | -| ------------------------------------------------------ | ---------------- | +| 製品 | 最大ファイルサイズ | +| ------------------------------------------------- | ---------------- | | {% data variables.product.prodname_free_user %} | 2 GB | | {% data variables.product.prodname_pro %} | 2 GB | | {% data variables.product.prodname_team %} | 4 GB | | {% data variables.product.prodname_ghe_cloud %} | 5 GB |{% else %} - -{% data variables.large_files.product_name_short %}を使用すると、最大で次のファイルサイズまで保存できます。 -{% if currentVersion ver_lt "enterprise-server@2.21" %}{% data variables.large_files.max_lfs_size %}{% else %}5 GB{% endif %}（リポジトリ内） + Using +{% data variables.large_files.product_name_short %}, you can store files up to {% if currentVersion ver_lt "enterprise-server@2.21" %}{% data variables.large_files.max_lfs_size %}{% else %}5 GB{% endif %} in your repository. {% endif %} {% data variables.large_files.product_name_short %}を{% data variables.product.prodname_desktop %}と共に使うこともできます。 {% data variables.product.prodname_desktop %}でのGit FLSリポジトリのクローンに関する詳しい情報については、[GitHubからGitHub Desktopへのリポジトリのクローン](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop)を参照してください。 diff --git a/translations/ja-JP/content/github/managing-large-files/about-storage-and-bandwidth-usage.md b/translations/ja-JP/content/github/managing-large-files/about-storage-and-bandwidth-usage.md index 382d0da513d5..eb69478b15c9 100644 --- a/translations/ja-JP/content/github/managing-large-files/about-storage-and-bandwidth-usage.md +++ b/translations/ja-JP/content/github/managing-large-files/about-storage-and-bandwidth-usage.md @@ -20,7 +20,8 @@ versions: - LFS で追跡されている 500 MB のファイルをダウンロードした場合、リポジトリのオーナーに割り当てられている帯域を 500 MB 消費します。 コラボレータがそのファイルに変更をプッシュし、あなたが新しいバージョンをローカルのリポジトリにプルしたなら、あなたは 500 MB の帯域を新たに消費するため、この 2 つのダウンロードでの合計の使用帯域は 1 GB になります。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -{% data variables.large_files.product_name_long %}（{% data variables.large_files.product_name_short %}）オブジェクトがリポジトリのソースコードアーカイブに含まれている場合、それらのアーカイブをダウンロードすると、リポジトリの帯域幅の使用量にカウントされます。 詳しい情報については、「[リポジトリのアーカイブ内の {% data variables.large_files.product_name_short %} オブジェクトを管理する](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)」を参照してください。 +If +{% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in source code archives for your repository, downloads of those archives will count towards bandwidth usage for the repository. 詳しい情報については、「[リポジトリのアーカイブ内の {% data variables.large_files.product_name_short %} オブジェクトを管理する](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)」を参照してください。 {% endif %} {% tip %} diff --git a/translations/ja-JP/content/github/managing-large-files/conditions-for-large-files.md b/translations/ja-JP/content/github/managing-large-files/conditions-for-large-files.md index 97ffded0b45f..69dffb106f0e 100644 --- a/translations/ja-JP/content/github/managing-large-files/conditions-for-large-files.md +++ b/translations/ja-JP/content/github/managing-large-files/conditions-for-large-files.md @@ -16,4 +16,4 @@ versions: ### 大きなファイルのブロックされたプッシュ -{% if currentVersion != "free-pro-team@latest" %}デフォルトでは、{% endif %}{% data variables.product.product_name %}は{% data variables.large_files.max_github_size %}以上のプッシュをブロックします。 {% if currentVersion != "free-pro-team@latest" %}ただし、サイト管理者は、{% data variables.product.prodname_ghe_server %}インスタンスに別の制限を構成できます。 詳しい情報については 、「[Git のプッシュ制限を設定する](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-git-push-limits)」を参照してください。{% endif %} +{% if currentVersion != "free-pro-team@latest" %}By default, {% endif %}{% data variables.product.product_name %} blocks pushes that exceed {% data variables.large_files.max_github_size %}. {% if currentVersion != "free-pro-team@latest" %}However, a site administrator can configure a different limit for your {% data variables.product.prodname_ghe_server %} instance. 詳しい情報については 、「[Git のプッシュ制限を設定する](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-git-push-limits)」を参照してください。{% endif %} diff --git a/translations/ja-JP/content/github/managing-large-files/configuring-git-large-file-storage.md b/translations/ja-JP/content/github/managing-large-files/configuring-git-large-file-storage.md index 92dd0f9608a1..75c91d5c1a42 100644 --- a/translations/ja-JP/content/github/managing-large-files/configuring-git-large-file-storage.md +++ b/translations/ja-JP/content/github/managing-large-files/configuring-git-large-file-storage.md @@ -47,7 +47,7 @@ versions: 5. 以下のように、ファイルをコミットし、{% data variables.product.product_name %} にプッシュします: ```shell $ git commit -m "add file.psd" - $ git push origin master + $ git push ``` アップロードしたファイルの Diagnostics 情報が、以下のように表示されるはずです: ```shell @@ -58,5 +58,5 @@ versions: ### 参考リンク -- 「[{% data variables.large_files.product_name_long %} とのコラボレーション](/articles/collaboration-with-git-large-file-storage/)」{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +- "[Collaboration with {% data variables.large_files.product_name_long %}](/articles/collaboration-with-git-large-file-storage/)"{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} - 「[リポジトリのアーカイブ内の {% data variables.large_files.product_name_short %} オブジェクトを管理する](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)」{% endif %} diff --git a/translations/ja-JP/content/github/managing-large-files/distributing-large-binaries.md b/translations/ja-JP/content/github/managing-large-files/distributing-large-binaries.md index 26f1f30f3333..4990d8b6b593 100644 --- a/translations/ja-JP/content/github/managing-large-files/distributing-large-binaries.md +++ b/translations/ja-JP/content/github/managing-large-files/distributing-large-binaries.md @@ -1,6 +1,6 @@ --- title: 大きなバイナリを配布する -intro: プロジェクトによっては、ソースコードの配布に加えて、バイナリやインストーラーなどの大きなファイルの配布が必要となるものがあります。 +intro: 'プロジェクトによっては、ソースコードの配布に加えて、バイナリやインストーラーなどの大きなファイルの配布が必要となるものがあります。' redirect_from: - /articles/distributing-large-binaries versions: diff --git a/translations/ja-JP/content/github/managing-large-files/installing-git-large-file-storage.md b/translations/ja-JP/content/github/managing-large-files/installing-git-large-file-storage.md index 63e38cfa1ba3..91b395639bc4 100644 --- a/translations/ja-JP/content/github/managing-large-files/installing-git-large-file-storage.md +++ b/translations/ja-JP/content/github/managing-large-files/installing-git-large-file-storage.md @@ -57,7 +57,8 @@ versions: {% endtip %} 2. コンピュータで、ダウンロードしたファイルを見つけます。 -3. *git-lfs-windows-1.X.X.exe* というファイルをダブルクリックします。1.X.X は、ダウンロードした Git LFS のバージョンに置き換えてください。 このファイルを開くと、Windows は {% data variables.large_files.product_name_short %} をインストールするセットアップ ウィザードを実行します。 +3. *git-lfs-windows-1.X.X.exe* というファイルをダブルクリックします。1.X.X は、ダウンロードした Git LFS のバージョンに置き換えてください。 When you open this file Windows will run a setup wizard to install +{% data variables.large_files.product_name_short %}. {% data reusables.command_line.open_the_multi_os_terminal %} 5. インストールが成功したか検証します。 ```shell diff --git a/translations/ja-JP/content/github/managing-large-files/removing-files-from-git-large-file-storage.md b/translations/ja-JP/content/github/managing-large-files/removing-files-from-git-large-file-storage.md index a1b141375a12..9290d04394dc 100644 --- a/translations/ja-JP/content/github/managing-large-files/removing-files-from-git-large-file-storage.md +++ b/translations/ja-JP/content/github/managing-large-files/removing-files-from-git-large-file-storage.md @@ -1,6 +1,6 @@ --- -title: ファイルを Git Large File Storage から削除する -intro: 'リポジトリに {% data variables.large_files.product_name_short %} をセットアップしてあれば、{% data variables.large_files.product_name_short %} からは、すべてのファイルを削除することも、ファイルのサブセットを削除することもできます。' +title: Removing files from Git Large File Storage +intro: 'If you''ve set up {% data variables.large_files.product_name_short %} for your repository, you can remove all files or a subset of files from {% data variables.large_files.product_name_short %}.' redirect_from: - /articles/removing-files-from-git-large-file-storage versions: @@ -8,45 +8,45 @@ versions: enterprise-server: '*' --- -### 1 つのファイルを削除する +### Removing a single file -1. `filter-branch` コマンドか BFG Repo-Cleaner を使用して、リポジトリの Git 履歴からファイルを削除します。 これらを使用する詳しい情報については、「[機密データをリポジトリから削除する](/articles/removing-sensitive-data-from-a-repository)」を参照してください。 -2. *.gitattributes* ファイルに移動します。 +1. Remove the file from the repository's Git history using either the `filter-branch` command or BFG Repo-Cleaner. For detailed information on using these, see "[Removing sensitive data from a repository](/articles/removing-sensitive-data-from-a-repository)." +2. Navigate to your *.gitattributes* file. {% note %} - **メモ:** *.gitattributes* ファイルは通常、ローカルリポジトリ内に保存されます。 場合によっては、{% data variables.large_files.product_name_short %} 関連をすべて含むグローバル *.gitattributes* ファイルが作成されている可能性があります。 + **Note:** Your *.gitattributes* file is generally saved within your local repository. In some cases, you may have created a global *.gitattributes* file that contains all of your {% data variables.large_files.product_name_short %} associations. {% endnote %} -3. *.gitattributes* ファイル内で、関連付けられている {% data variables.large_files.product_name_short %} 追跡ルールを検索して削除します。 -4. *.gitattributes* ファイルを保存して終了します。 +3. Find and remove the associated {% data variables.large_files.product_name_short %} tracking rule within the *.gitattributes* file. +4. Save and exit the *.gitattributes* file. -### {% data variables.large_files.product_name_short %} リポジトリ内にあるすべてのファイルを削除する +### Removing all files within a {% data variables.large_files.product_name_short %} repository -1. `filter-branch` コマンドか BFG Repo-Cleaner のいずれかを使用して、リポジトリの Git 履歴から ファイルを削除します。 これらを使用する詳しい情報については、「[機密データをリポジトリから削除する](/articles/removing-sensitive-data-from-a-repository)」を参照してください。 -2. オプションで、リポジトリにある {% data variables.large_files.product_name_short %} をアンインストールするには、次を実行します: +1. Remove the files from the repository's Git history using either the `filter-branch` command or BFG Repo-Cleaner. For detailed information on using these, see "[Removing sensitive data from a repository](/articles/removing-sensitive-data-from-a-repository)." +2. Optionally, to uninstall {% data variables.large_files.product_name_short %} in the repository, run: ```shell $ git lfs uninstall ``` - バージョンが 1.1.0 より前の {% data variables.large_files.product_name_short %} については、次を実行します: + For {% data variables.large_files.product_name_short %} versions below 1.1.0, run: ```shell $ git lfs uninit ``` -### リポジトリにある {% data variables.large_files.product_name_short %}オブジェクト +### {% data variables.large_files.product_name_short %} objects in your repository -{% data variables.large_files.product_name_short %} からファイルを削除した後でも、{% data variables.large_files.product_name_short %} オブジェクトはそのままリモートストレージに存在し{% if currentVersion == "free-pro-team@latest" %}、{% data variables.large_files.product_name_short %} ストレージ容量に対するカウントも継続し{% endif %}ます。 +After you remove files from {% data variables.large_files.product_name_short %}, the {% data variables.large_files.product_name_short %} objects still exist on the remote storage{% if currentVersion == "free-pro-team@latest" %} and will continue to count toward your {% data variables.large_files.product_name_short %} storage quota{% endif %}. -{% data variables.large_files.product_name_short %} オブジェクトをリポジトリから削除するには、{% if currentVersion == "free-pro-team@latest" %}リポジトリを削除して再作成します。 リポジトリを削除すると、関連する Issue、Star、フォークもすべて削除されます。 詳しい情報については、「[リポジトリを削除する](/github/administering-a-repository/deleting-a-repository)」を参照するか、{% else %}{% data variables.product.prodname_enterprise %} 管理者に連絡してオブジェクトをアーカイブします。 アーカイブ化されたオブジェクトは、3 か月後にパージされます。{% endif %} +To remove {% data variables.large_files.product_name_short %} objects from a repository, {% if currentVersion == "free-pro-team@latest" %}delete and recreate the repository. When you delete a repository, any associated issues, stars, and forks are also deleted. For more information, see "[Deleting a repository](/github/administering-a-repository/deleting-a-repository)."{% else %}contact your {% data variables.product.prodname_enterprise %} administrator to archive the objects. Archived objects are purged after three months.{% endif %} {% note %} -**注釈:** ファイルを 1 つ削除しても、それ以外の {% data variables.large_files.product_name_short %} オブジェクトはリポジトリに保持する場合は、リポジトリを削除して再作成してから、{% data variables.large_files.product_name_short %} に関連付けられたファイルを再設定してください。 詳しい情報については、「[1 つのファイルを削除する](#removing-a-single-file)」および「[{% data variables.large_files.product_name_long %}を設定する](/github/managing-large-files/configuring-git-large-file-storage)」を参照してください。 +**Note:** If you removed a single file and have other {% data variables.large_files.product_name_short %} objects that you'd like to keep in your repository, after deleting and recreating your repository, reconfigure your {% data variables.large_files.product_name_short %}-associated files. For more information, see "[Removing a single file](#removing-a-single-file)" and "[Configuring {% data variables.large_files.product_name_long %}](/github/managing-large-files/configuring-git-large-file-storage)." {% endnote %} -### 参考リンク +### Further reading -- [{% data variables.large_files.product_name_long %}について](/articles/about-git-large-file-storage) -- [{% data variables.large_files.product_name_long %} でのコラボレーション](/articles/collaboration-with-git-large-file-storage/) -- 「[{% data variables.large_files.product_name_long %}をインストールする](/articles/installing-git-large-file-storage)」 +- "[About {% data variables.large_files.product_name_long %}](/articles/about-git-large-file-storage)" +- "[Collaboration with {% data variables.large_files.product_name_long %}](/articles/collaboration-with-git-large-file-storage/)" +- "[Installing {% data variables.large_files.product_name_long %}](/articles/installing-git-large-file-storage)" diff --git a/translations/ja-JP/content/github/managing-large-files/working-with-large-files.md b/translations/ja-JP/content/github/managing-large-files/working-with-large-files.md index 0b468415778c..07dcae004332 100644 --- a/translations/ja-JP/content/github/managing-large-files/working-with-large-files.md +++ b/translations/ja-JP/content/github/managing-large-files/working-with-large-files.md @@ -1,6 +1,6 @@ --- title: 大きなファイルを使って作業する -intro: Git リポジトリは、すべてのファイルのすべてのバージョンを含みます。 しかし、ファイルの種類によっては、これは実用的ではありません。 大きなファイルを複数回修正すると、リポジトリの他のユーザのクローンおよびフェッチにかかる時間が長くなります。 +intro: 'Git リポジトリは、すべてのファイルのすべてのバージョンを含みます。 しかし、ファイルの種類によっては、これは実用的ではありません。 大きなファイルを複数回修正すると、リポジトリの他のユーザのクローンおよびフェッチにかかる時間が長くなります。' mapTopic: true redirect_from: - /articles/working-with-large-files diff --git a/translations/ja-JP/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md b/translations/ja-JP/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md index 73b8dce6840a..0ce617f2fdb2 100644 --- a/translations/ja-JP/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md +++ b/translations/ja-JP/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md @@ -77,15 +77,15 @@ We send security alerts to people with admin permissions in the affected reposit ### Configuring notifications for {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} {% if currentVersion == "free-pro-team@latest" %} -By default, you will receive {% data variables.product.prodname_dependabot_alerts %} by email, grouped by the specific vulnerability. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-options)." +By default, you will receive {% data variables.product.prodname_dependabot_alerts %} by email, grouped by the specific vulnerability. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-notification-options)." {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %} -By default, if your site administrator has configured email for notifications on your instance, you will receive {% data variables.product.prodname_dependabot_alerts %} by email. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-options)." +By default, if your site administrator has configured email for notifications on your instance, you will receive {% data variables.product.prodname_dependabot_alerts %} by email. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-notification-options)." {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion == "enterprise-server@2.21" %} -By default, if your site administrator has configured email for notifications on your instance, you will receive security alerts by email. You can also choose to receive security alerts in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#security-alert-options)." +By default, if your site administrator has configured email for notifications on your instance, you will receive security alerts by email. You can also choose to receive security alerts in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#security-alert-notification-options)." {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.21" %} diff --git a/translations/ja-JP/content/github/managing-security-vulnerabilities/about-github-security-advisories.md b/translations/ja-JP/content/github/managing-security-vulnerabilities/about-github-security-advisories.md index 2021a70cb10b..a6bf5378dd62 100644 --- a/translations/ja-JP/content/github/managing-security-vulnerabilities/about-github-security-advisories.md +++ b/translations/ja-JP/content/github/managing-security-vulnerabilities/about-github-security-advisories.md @@ -12,7 +12,7 @@ versions: {% data reusables.security-advisory.security-researcher-cannot-create-advisory %} -### {% data variables.product.prodname_security_advisories %}について +### {% data variables.product.prodname_security_advisories %} について {% data variables.product.prodname_security_advisories %} を使用すると、リポジトリメンテナがプロジェクトのセキュリティの脆弱性について非公開で議論し、修正できます。 リポジトリメンテナは、修正に協力した後、セキュリティアドバイザリを公開して、プロジェクトのコミュニティにセキュリティの脆弱性を公開します。 リポジトリメンテナは、セキュリティアドバイザリを公開することで、コミュニティがパッケージの依存関係を更新し、セキュリティの脆弱性の影響を調査しやすくなります。 diff --git a/translations/ja-JP/content/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates.md b/translations/ja-JP/content/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates.md index 3dbe52034ab0..dc1d9f3c0c95 100644 --- a/translations/ja-JP/content/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates.md +++ b/translations/ja-JP/content/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates.md @@ -9,7 +9,7 @@ versions: free-pro-team: '*' --- -### {% data variables.product.prodname_dependabot_security_updates %}について +### {% data variables.product.prodname_dependabot_security_updates %} について {% data variables.product.prodname_dependabot_short %} は {% data variables.product.prodname_advisory_database %} や [WhiteSource](https://www.whitesourcesoftware.com/vulnerability-database) などのセキュリティアドバイザリを監視し、リポジトリの依存関係グラフで新たに脆弱性のある依存関係を検出すると、プルリクエストを自動的にトリガーします。 {% data variables.product.prodname_advisory_database %} の詳細については、「[{% data variables.product.prodname_advisory_database %} について](/github/managing-security-vulnerabilities/browsing-security-vulnerabilities-in-the-github-advisory-database#about-the-github-advisory-database)」を参照してください。 @@ -23,7 +23,8 @@ versions: {% note %} -**注釈:** {% data variables.product.prodname_dependabot_security_updates %} は、依存関係グラフによって追跡される依存関係のセキュリティの脆弱性のみを解決します。 セキュリティアップデートは、プライベートリポジトリでホストされているプライベートレジストリまたはパッケージの脆弱性を解決するために作成されていません。 ただし、間接的または推移的な依存関係は、ロックファイルなどで明示的に定義されている場合に含まれます。 詳しい情報については、「[依存関係グラフについて](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)」を参照してください。 さらに、依存関係が脆弱であると検出された場合、{% data variables.product.prodname_dependabot_security_updates %} がロックファイルへの修正案を含むプルリクエストを自動的に作成することを強調することが重要です。 +**注釈** +{% data variables.product.prodname_dependabot_security_updates %} only resolve security vulnerabilities in the dependencies tracked by your dependency graph. セキュリティアップデートは、プライベートリポジトリでホストされているプライベートレジストリまたはパッケージの脆弱性を解決するために作成されていません。 ただし、間接的または推移的な依存関係は、ロックファイルなどで明示的に定義されている場合に含まれます。 詳しい情報については、「[依存関係グラフについて](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)」を参照してください。 さらに、依存関係が脆弱であると検出された場合、{% data variables.product.prodname_dependabot_security_updates %} がロックファイルへの修正案を含むプルリクエストを自動的に作成することを強調することが重要です。 {% endnote %} @@ -41,14 +42,14 @@ versions: {% endnote %} -| 自動有効化の前提条件 | 詳細情報 | -| ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| リポジトリがフォークではない | 「[フォークについて](/github/collaborating-with-issues-and-pull-requests/about-forks)」 | -| リポジトリがアーカイブされていない | 「[リポジトリをアーカイブする](/github/creating-cloning-and-archiving-repositories/archiving-repositories)」 | -| リポジトリがパブリックである、またはリポジトリがプライベートであり、リポジトリの設定で {% data variables.product.prodname_dotcom %}、依存関係グラフ、および脆弱性アラートによる読み取り専用分析が有効化されている | 「[プライベートリポジトリのデータ使用設定を管理する](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository)」 | -| リポジトリに {% data variables.product.prodname_dotcom %} がサポートするパッケージエコシステムの依存関係マニフェストファイルが含まれている | 「[サポートされているパッケージエコシステム](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph#supported-package-ecosystems)」 | +| 自動有効化の前提条件 | 詳細情報 | +| ------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | +| リポジトリがフォークではない | 「[フォークについて](/github/collaborating-with-issues-and-pull-requests/about-forks)」 | +| リポジトリがアーカイブされていない | 「[リポジトリをアーカイブする](/github/creating-cloning-and-archiving-repositories/archiving-repositories)」 | +| リポジトリがパブリックである、またはリポジトリがプライベートであり、リポジトリの設定で {% data variables.product.prodname_dotcom %}、依存関係グラフ、および脆弱性アラートによる読み取り専用分析が有効化されている | 「[プライベートリポジトリのデータ使用設定を管理する](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository)」 | +| リポジトリに {% data variables.product.prodname_dotcom %} がサポートするパッケージエコシステムの依存関係マニフェストファイルが含まれている | 「[サポートされているパッケージエコシステム](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph#supported-package-ecosystems)」 | | {% data variables.product.prodname_dependabot_security_updates %} がリポジトリに対して無効になっていない | 「[リポジトリの {% data variables.product.prodname_dependabot_security_updates %} を管理する](#managing-github-dependabot-security-updates-for-your-repositories)」 | -| リポジトリが依存関係管理の統合をまだ使用していない | "[インテグレーションについて](/github/customizing-your-github-workflow/about-integrations)" | +| リポジトリが依存関係管理の統合をまだ使用していない | "[インテグレーションについて](/github/customizing-your-github-workflow/about-integrations)" | リポジトリでセキュリティアップデートが有効になっておらず、理由が不明の場合は、まず以下の手順のセクションに記載されている指示に従って有効にしてみてください。 それでもセキュリティアップデートが機能しない場合は、[サポートにお問い合わせください](https://support.github.com/contact)。 diff --git a/translations/ja-JP/content/github/managing-security-vulnerabilities/managing-security-vulnerabilities-in-your-project.md b/translations/ja-JP/content/github/managing-security-vulnerabilities/managing-security-vulnerabilities-in-your-project.md index 8f8569abf26c..776ed954ad3d 100644 --- a/translations/ja-JP/content/github/managing-security-vulnerabilities/managing-security-vulnerabilities-in-your-project.md +++ b/translations/ja-JP/content/github/managing-security-vulnerabilities/managing-security-vulnerabilities-in-your-project.md @@ -1,6 +1,6 @@ --- title: プロジェクトのセキュリティ脆弱性を管理する -intro: リポジトリ内のセキュリティ脆弱性を発見、議論、および公開できます。 +intro: 'リポジトリ内のセキュリティ脆弱性を発見、議論、および公開できます。' mapTopic: true redirect_from: - /articles/managing-security-vulnerabilities-in-your-project diff --git a/translations/ja-JP/content/github/managing-security-vulnerabilities/managing-vulnerabilities-in-your-projects-dependencies.md b/translations/ja-JP/content/github/managing-security-vulnerabilities/managing-vulnerabilities-in-your-projects-dependencies.md index a0c45a125265..1d491f97f89e 100644 --- a/translations/ja-JP/content/github/managing-security-vulnerabilities/managing-vulnerabilities-in-your-projects-dependencies.md +++ b/translations/ja-JP/content/github/managing-security-vulnerabilities/managing-vulnerabilities-in-your-projects-dependencies.md @@ -1,6 +1,6 @@ --- title: プロジェクトの依存関係にある脆弱性を管理する -intro: 'リポジトリの依存関係を追跡し、{% data variables.product.product_name %} が脆弱性のある依存関係を検出したときに{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}セキュリティアラート{% endif %}を受け取ることができます。' +intro: 'You can track your repository''s dependencies and receive {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} when {% data variables.product.product_name %} detects vulnerable dependencies.' mapTopic: true redirect_from: - /articles/updating-your-project-s-dependencies/ diff --git a/translations/ja-JP/content/github/managing-security-vulnerabilities/removing-a-collaborator-from-a-security-advisory.md b/translations/ja-JP/content/github/managing-security-vulnerabilities/removing-a-collaborator-from-a-security-advisory.md index 1ecfb08b95a0..9d463bb4550c 100644 --- a/translations/ja-JP/content/github/managing-security-vulnerabilities/removing-a-collaborator-from-a-security-advisory.md +++ b/translations/ja-JP/content/github/managing-security-vulnerabilities/removing-a-collaborator-from-a-security-advisory.md @@ -1,6 +1,6 @@ --- title: セキュリティアドバイザリからコラボレータを削除する -intro: セキュリティアドバイザリからコラボレータを削除すると、そのコラボレータはセキュリティアドバイザリのディスカッションとメタデータへの読み取りおよび書き込みアクセス権を失います。 +intro: 'セキュリティアドバイザリからコラボレータを削除すると、そのコラボレータはセキュリティアドバイザリのディスカッションとメタデータへの読み取りおよび書き込みアクセス権を失います。' versions: free-pro-team: '*' --- diff --git a/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md b/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md index d80d11dbc48c..67ecdfaa5225 100644 --- a/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md +++ b/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md @@ -44,7 +44,7 @@ versions: ### 通知とサブスクリプションをカスタマイズする -[https://github.com/notifications](https://github.com/notifications){% if currentVersion == "free-pro-team@latest" %} と {% data variables.product.prodname_mobile %} アプリ{% endif %}にある通知インボックス、メール、またはこれらのオプションの組み合わせから通知を表示できます。 +You can choose to view your notifications through the notifications inbox at [https://github.com/notifications](https://github.com/notifications){% if currentVersion == "free-pro-team@latest" %} and in the {% data variables.product.prodname_mobile %} app{% endif %}, through your email, or some combination of these options. 通知設定で、受信する更新の種類と更新の送信先をカスタマイズできます。 詳しい情報については「[通知を設定する](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications)」を参照してください。 @@ -53,7 +53,8 @@ versions: 特定のプルリクエストやプルリクエストの更新の受信方法をカスタマイズするには、Issue またはプルリクエスト内で設定できます。 詳しい情報については、「[単一の通知をトリアージする](/github/managing-subscriptions-and-notifications-on-github/triaging-a-single-notification#customizing-when-to-receive-future-updates-for-an-issue-or-pull-request)」を参照してください。 {% if currentVersion == "free-pro-team@latest" %} -{% data variables.product.prodname_mobile %} アプリでプッシュ通知を有効化できます。 詳しい情報については、「[通知を設定する](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#enabling-push-notifications-with-github-for-mobile)」を参照してください。 +You can enable push notifications in the +{% data variables.product.prodname_mobile %} app. 詳しい情報については、「[通知を設定する](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#enabling-push-notifications-with-github-for-mobile)」を参照してください。 {% endif %} ### 通知の受信理由 @@ -82,7 +83,7 @@ versions: ### 通知のインボックスをカスタマイズする -{% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} または {% data variables.product.prodname_mobile %}{% endif %} のインボックスの通知のグループにフォーカスするために、カスタムフィルタを作成できます。 たとえば、自分がコントリビュートしているオープンソースプロジェクトのカスタムフィルタを作成し、自分がメンションされているリポジトリの通知のみを表示することができます。 詳しい情報については「[インボックスからの通知の管理](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox)」を参照してください。 トリアージしているワークフローをカスタマイズする方法のその他の例については、「[通知をトリアージするためのワークフローをカスタマイズする](/github/managing-subscriptions-and-notifications-on-github/customizing-a-workflow-for-triaging-your-notifications)」を参照してください。 +To focus on a group of notifications in your inbox on {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} or {% data variables.product.prodname_mobile %}{% endif %}, you can create custom filters. たとえば、自分がコントリビュートしているオープンソースプロジェクトのカスタムフィルタを作成し、自分がメンションされているリポジトリの通知のみを表示することができます。 詳しい情報については「[インボックスからの通知の管理](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox)」を参照してください。 トリアージしているワークフローをカスタマイズする方法のその他の例については、「[通知をトリアージするためのワークフローをカスタマイズする](/github/managing-subscriptions-and-notifications-on-github/customizing-a-workflow-for-triaging-your-notifications)」を参照してください。 ### 通知の保持ポリシー diff --git a/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md b/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md index 35e1284863d2..67b15b0e07de 100644 --- a/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md +++ b/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md @@ -1,6 +1,6 @@ --- -title: Configuring notifications -intro: 'Choose the type of activity on {% data variables.product.product_name %} that you want to receive notifications for and how you want these updates delivered.' +title: 通知を設定する +intro: '通知を受信する {% data variables.product.product_name %} のアクティビティのタイプと、これらの更新の配信方法を選択します。' redirect_from: - /articles/about-web-notifications - /format-of-notification-emails/ @@ -18,11 +18,11 @@ versions: enterprise-server: '>=2.21' --- -### Notification delivery options +### 通知配信オプション You have three basic options for notification delivery: - the notifications inbox on {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} - - the notifications inbox on {% data variables.product.prodname_mobile %}, which syncs with the inbox on {% data variables.product.product_name %}{% endif %} + - {% data variables.product.product_name %}{% endif %} のインボックスと同期する {% data variables.product.prodname_mobile %} の通知インボックス - an email client that uses a verified email address, which can also sync with the notifications inbox on {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} and {% data variables.product.prodname_mobile %}{% endif %} {% if currentVersion == "free-pro-team@latest" %} @@ -31,33 +31,34 @@ You have three basic options for notification delivery: {% data reusables.notifications-v2.tip-for-syncing-email-and-your-inbox-on-github %} -#### Benefits of the notifications inbox +#### 通知インボックスの利点 The notifications inbox on {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} and {% data variables.product.prodname_mobile %}{% endif %} includes triaging options designed specifically for your {% data variables.product.product_name %} notifications flow, including options to: - - Triage multiple notifications at once. - - Mark completed notifications as **Done** and remove them from your inbox. To view all of your notifications marked as **Done**, use the `is:done` query. - - Save a notification to review later. Saved notifications are flagged in your inbox and kept indefinitely. To view all of your saved notifications, use the `is:saved` query. - - Unsubscribe and remove a notification from your inbox. - - Preview the issue, pull request, or team discussion where the notification originates on {% data variables.product.product_name %} from within the notifications inbox. - - See one of the latest reasons you're receiving a notification from your inbox with a `reasons` label. - - Create custom filters to focus on different notifications when you want. - - Group notifications in your inbox by repository or date to get a quick overview with less context switching + - 複数の通知を一括でトリアージする。 + - 完了した通知を**完了**としてマークし、インボックスから削除する。 **完了**としてマークされたすべての通知を表示するには、`is:done` クエリを使用します。 + - 後で確認するために通知を保存する。 保存した通知にはインボックスでフラグが付けられ、無期限に保持されます。 保存した通知をすべて表示するには、`is:saved` クエリを使用します。 + - サブスクライブ解除して、インボックスから通知を削除する。 + - 通知が、通知インボックスから {% data variables.product.product_name %} で発生する Issue、プルリクエスト、または Team ディスカッションをプレビューする。 + - インボックスから `reasons` ラベルが付いた通知を受信する最新の理由の1つを確認する。 + - カスタムフィルタを作成して、必要なときにさまざまな通知にフォーカスする。 + - インボックスの通知をリポジトリまたは日付別にグループ化して、コンテキストの切り替えを減らし、概要をすばやく確認する。 {% if currentVersion == "free-pro-team@latest" %} -In addition, the notifications inbox on {% data variables.product.prodname_mobile %} allows you to triage notifications in dark mode and receive push notifications for direct mentions. For more information, see "[Enabling push notifications with GitHub for mobile](#enabling-push-notifications-with-github-for-mobile)" or "[GitHub for mobile](/github/getting-started-with-github/github-for-mobile)." +In addition, the notifications inbox on +{% data variables.product.prodname_mobile %} allows you to triage notifications in dark mode and receive push notifications for direct mentions. For more information, see "[Enabling push notifications with GitHub for mobile](#enabling-push-notifications-with-github-for-mobile)" or "[GitHub for mobile](/github/getting-started-with-github/github-for-mobile)." {% endif %} -#### Benefits of using an email client for notifications +#### 通知にメールクライアントを使用する利点 -One benefit of using an email client is that all of your notifications can be kept indefinitely depending on your email client's storage capacity. Your inbox notifications are only kept for 5 months unless you've marked them as **Saved**. **Saved** notifications are kept indefinitely. For more information about your inbox's retention policy, see "[About notifications](/github/managing-subscriptions-and-notifications-on-github/about-notifications#notification-retention-policy)." +One benefit of using an email client is that all of your notifications can be kept indefinitely depending on your email client's storage capacity. Your inbox notifications are only kept for 5 months unless you've marked them as **Saved**. **Saved** notifications are kept indefinitely. インボックスの保持ポリシーの詳細については、「[通知について](/github/managing-subscriptions-and-notifications-on-github/about-notifications#notification-retention-policy)」を参照してください。 Sending notifications to your email client also allows you to customize your inbox according to your email client's settings, which can include custom or color-coded labels. Email notifications also allow flexibility with the types of notifications you receive and allow you to choose different email addresses for updates. For example, you can send certain notifications for a repository to a verified personal email address. For more information, about your email customization options, see "[Customizing your email notifications](#customizing-your-email-notifications)." -### About participating and watching notifications +### 参加と Watch 対象の通知について -When you watch a repository, you're subscribing to updates for activity in that repository. Similarly, when you watch a specific team's discussions, you're subscribing to all conversation updates on that team's page. To see repositories that you're watching, see [https://github.com/watching](https://github.com/watching). For more information, see "[Managing subscriptions and notifications on GitHub](/github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github)." +When you watch a repository, you're subscribing to updates for activity in that repository. Similarly, when you watch a specific team's discussions, you're subscribing to all conversation updates on that team's page. To see repositories that you're watching, see [https://github.com/watching](https://github.com/watching). 詳しい情報については「[GitHub上でのサブスクリプションと通知の管理](/github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github)」を参照してください。 Anytime you comment in a conversation or when someone @mentions your username, you are _participating_ in a conversation. By default, you are automatically subscribed to a conversation when you participate in it. You can unsubscribe from a conversation you've participated in manually by clicking **Unsubscribe** on the issue or pull request or through the **Unsubscribe** option in the notifications inbox. @@ -65,15 +66,15 @@ For conversations you're watching or participating in, you can choose whether yo ![Participating and watching notifications options](/assets/images/help/notifications-v2/participating-and-watching-options.png) -For example: - - If you don't want notifications to be sent to your email, unselect **email** for participating and watching notifications. - - If you want to receive notifications by email when you've participated in a conversation, then you can select **email** under "Participating". +例: + - 通知をメールに送信しない場合は、[**Email**] をオフにして、参加と Watch 対象の通知を行います。 + - 会話に参加したときにメールで通知を受信する場合は、[Participating] の下の [**Email**] を選択します。 If you do not enable watching or participating notifications for web{% if currentVersion == "free-pro-team@latest" %} and mobile{% endif %}, then your notifications inbox will not have any updates. -### Customizing your email notifications +### メール通知をカスタマイズする -After enabling email notifications, {% data variables.product.product_name %} will send notifications to you as multipart emails that contain both HTML and plain text copies of the content. Email notification content includes any Markdown, @mentions, emojis, hash-links, and more, that appear in the original content on {% data variables.product.product_name %}. If you only want to see the text in the email, you can configure your email client to display the plain text copy only. +メール通知を有効化すると、{% data variables.product.product_name %} はコンテンツを HTML とプレーンテキストの両方で含むマルチパートのメールとして通知を送信します。 メール通知のコンテンツには、{% data variables.product.product_name %} のオリジナルのコンテンツに含まれる Markdown、@メンション、絵文字、ハッシュリンクなどがすべて含まれます。 メールでテキストだけを見たいなら、プレーンテキストのコピーだけを表示するようにメールクライアントを設定できます。 {% data reusables.notifications.outbound_email_tip %} @@ -81,50 +82,50 @@ After enabling email notifications, {% data variables.product.product_name %} wi {% if currentVersion == "free-pro-team@latest" %} -If you're using Gmail, you can click a button beside the notification email to visit the original issue or pull request that generated the notification. +Gmailを使っているなら、通知メールの横にあるボタンをクリックして、通知を生成したオリジナルのIssueあるいはプルリクエストにアクセスできます。 -![Buttons in Gmail](/assets/images/help/notifications/gmail-buttons.png) +![Gmailのボタン](/assets/images/help/notifications/gmail-buttons.png) {% endif %} Choose a default email address where you want to send updates for conversations you're participating in or watching. You can also specify which activity on {% data variables.product.product_name %} you want to receive updates for using your default email address. For example, choose whether you want updates to your default email from: - - Comments on issues and pull requests. - - Pull request reviews. - - Pull request pushes. - - Your own updates, such as when you open, comment on, or close an issue or pull request. + - Issue やプルリクエストへのコメント。 + - プルリクエストのレビュー. + - プルリクエストのプッシュ。 + - Issue やプルリクエストのオープン、コメント、クローズなどの、自分自身の操作による更新。 -Depending on the organization that owns the repository, you can also send notifications to different email addresses for specific repositories. For example, you can send notifications for a specific public repository to a verified personal email address. Your organization may require the email address to be verified for a specific domain. For more information, see “[Choosing where your organization’s email notifications are sent](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#choosing-where-your-organizations-email-notifications-are-sent)." +Depending on the organization that owns the repository, you can also send notifications to different email addresses for specific repositories. For example, you can send notifications for a specific public repository to a verified personal email address. Your organization may require the email address to be verified for a specific domain. 詳しい情報については、「[Organization のメール通知の送信先を選択する](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#choosing-where-your-organizations-email-notifications-are-sent)」を参照してください。 {% data reusables.notifications-v2.email-notification-caveats %} -### Filtering email notifications +### メール通知のフィルタリング -Each email notification that {% data variables.product.product_name %} sends contains header information. The header information in every email is consistent, so you can use it in your email client to filter or forward all {% data variables.product.product_name %} notifications, or certain types of {% data variables.product.product_name %} notifications. +{% data variables.product.product_name %} が送信する各メール通知には、ヘッダ情報が含まれています。 各メールのヘッダ情報には一貫性があるので、それを使ってメールクライアントですべての {% data variables.product.product_name %} 通知あるいは特定の種類の {% data variables.product.product_name %} 通知をフィルタリングしたりフォワードしたりできます。 If you believe you're receiving notifications that don't belong to you, examine the `X-GitHub-Recipient` and `X-GitHub-Recipient-Address` headers. These headers show who the intended recipient is. Depending on your email setup, you may receive notifications intended for another user. -Email notifications from {% data variables.product.product_name %} contain the following header information: +{% data variables.product.product_name %} からのメール通知には、以下のヘッダ情報が含まれています: -| Header | Information | -| --- | --- | -| `From` address | This address will always be {% if currentVersion == "free-pro-team@latest" %}'`notifications@github.com`'{% else %}'the no-reply email address configured by your site administrator'{% endif %}. | -| `To` field | This field connects directly to the thread. If you reply to the email, you'll add a new comment to the conversation. | -| `Cc` address | {% data variables.product.product_name %} will `Cc` you if you're subscribed to a conversation. The second `Cc` email address matches the notification reason. The suffix for these notification reasons is {% data variables.notifications.cc_address %}. The possible notification reasons are:
    • `assign`: You were assigned to an issue or pull request.
    • `author`: You created an issue or pull request.
    • `comment`: You commented on an issue or pull request.
    • `manual`: There was an update to an issue or pull request you manually subscribed to.
    • `mention`: You were mentioned on an issue or pull request.
    • `push`: Someone committed to a pull request you're subscribed to.
    • `review_requested`: You or a team you're a member of was requested to review a pull request.
    • `security_alert`: {% data variables.product.prodname_dotcom %} detected a vulnerability in a repository you receive alerts for.
    • `state_change`: An issue or pull request you're subscribed to was either closed or opened.
    • `subscribed`: There was an update in a repository you're watching.
    • `team_mention`: A team you belong to was mentioned on an issue or pull request.
    • `your_activity`: You opened, commented on, or closed an issue or pull request.
    | -| `mailing list` field | This field identifies the name of the repository and its owner. The format of this address is always `..{% data variables.command_line.backticks %}`. |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" % %} -| `X-GitHub-Severity` field | {% data reusables.repositories.security-alerts-x-github-severity %} The possible severity levels are:
    • `low`
    • `moderate`
    • `high`
    • `critical`
    For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." |{% endif %} +| ヘッダ | 情報 | +| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `From` アドレス | This address will always be {% if currentVersion == "free-pro-team@latest" %}'`notifications@github.com`'{% else %}'the no-reply email address configured by your site administrator'{% endif %}. | +| `To` フィールド | このフィールドは、直接スレッドに接続します。 メールに返信すると、会話に新しいコメントを追加することになります。 | +| `Cc` アドレス | あなたが会話をサブスクライブしていれば、{% data variables.product.product_name %}はあなたに `Cc` します。 2番目の`Cc`メールアドレスは、通知の理由にマッチします。 これらの通知理由に対するサフィックスは{% data variables.notifications.cc_address %}です。 通知の理由には以下のようなものがあります。
    • `assign`: 受信者はIssueあるいはプルリクエストに割り当てられました。
    • `author`: 受信者はIssueあるいはプルリクエストの作者です。
    • `comment`: 受信者はIssueあるいはプルリクエストにコメントしました。
    • `manual`: 手作業でサブスクライブした Issue あるいはプルリクエストが更新されました。
    • `mention`: 受信者は Issue あるいはプルリクエストにメンションされました。
    • `push`: 受信者がサブスクライブしているプルリクエストに誰かがコミットしました。
    • `review_requested`: 受信者あるいは受信者がメンバーになっている Team にプルリクエストのレビューがリクエストされました。
    • `security_alert`: {% data variables.product.prodname_dotcom %} は、受信者がセキュリティのアラートを受け取るリポジトリに脆弱性を検出しました。
    • `state_change`: 受信者がサブスクライブしている Issue あるいはプルリクエストがクローズもしくはオープンされました。
    • `subscribed`: 受信者が Watch しているリポジトリに更新がありました。
    • `team_mention`: 受信者が属している Team が Issue あるいはプルリクエストでメンションされました。
    • `your_activity`: 受信者が Issue あるいはプルリクエストをオープン、コメントあるいはクローズしました。
    | +| `mailing list` フィールド | このフィールドはリポジトリの名前とそのオーナーを特定します。 このアドレスのフォーマットは常に`..{% data variables.command_line.backticks %}`となります。 |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" % %} +| `X-GitHub-Severity`フィールド | {% data reusables.repositories.security-alerts-x-github-severity %} 考えられる重大度レベルは次のとおりです。
    • `low`
    • `moderate`
    • `high`
    • `critical`
    詳しい情報については、「[脆弱性のある依存関係に対するアラートについて](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)」を参照してください。 |{% endif %} -### Choosing your notification settings +### 通知設定を選択する {% data reusables.notifications.access_notifications %} {% data reusables.notifications-v2.manage-notifications %} -3. On the notifications settings page, choose how you receive notifications when: - - There are updates in repositories or team discussions you're watching or in a conversation you're participating in. For more information, see "[About participating and watching notifications](#about-participating-and-watching-notifications)." - - You gain access to a new repository or you've joined a new team. For more information, see "[Automatic watching](#automatic-watching)."{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} - - There are new {% data variables.product.prodname_dependabot_alerts %} in your repository. For more information, see "[{% data variables.product.prodname_dependabot_alerts %} options](#github-dependabot-alerts-options)." {% endif %}{% if currentVersion == "enterprise-server@2.21" %} - - There are new security alerts in your repository. For more information, see "[Security alert options](#security-alert-options)." {% endif %} {% if currentVersion == "free-pro-team@latest" %} - - There are workflow runs updates on repositories set up with {% data variables.product.prodname_actions %}. For more information, see "[{% data variables.product.prodname_actions %} notification options](#github-actions-notification-options)."{% endif %} +3. 通知設定ページで、次の場合の通知の受信方法を選択します。 + - Watch しているリポジトリや Team ディスカッション、または参加している会話に更新がある場合。 詳しい情報については、「[参加と Watch 対象の通知について](#about-participating-and-watching-notifications)」を参照してください。 + - 新しいリポジトリにアクセスするか、新しい Team に参加した場合。 For more information, see "[Automatic watching](#automatic-watching)."{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} + - リポジトリに新しい{% if page.version == 'dotcom' %} {% data variables.product.prodname_dependabot_alerts %} {% else %}セキュリティアラート{% endif %}があります。 詳しい情報については、「[{% data variables.product.prodname_dependabot_alerts %} 通知オプション](#github-dependabot-alerts-notification-options)」を参照してください。 {% endif %}{% if currentVersion == "enterprise-server@2.21" %} + - リポジトリに新しいセキュリティアラートがある場合。 There are new security alerts in your repository. {% endif %} {% if currentVersion == "free-pro-team@latest" %} + - {% data variables.product.prodname_actions %} で設定されたリポジトリにワークフロー実行の更新がある場合。 詳しい情報については、「[{% data variables.product.prodname_actions %} 通知オプション](#github-actions-notification-options)」を参照してください。{% endif %} -### Automatic watching +### 自動 Watch By default, anytime you gain access to a new repository, you will automatically begin watching that repository. Anytime you join a new team, you will automatically be subscribed to updates and receive notifications when that team is @mentioned. If you don't want to automatically be subscribed, you can unselect the automatic watching options. @@ -132,81 +133,84 @@ By default, anytime you gain access to a new repository, you will automatically If "Automatically watch repositories" is disabled, then you will not automatically watch your own repositories. You must navigate to your repository page and choose the watch option. -### Choosing where your organization’s email notifications are sent +### Organization のメール通知の送信先を選択する -If you belong to an organization, you can choose the email account you want notifications for organization activity sent to. For example, if you belong to an organization for work, you may want your notifications sent to your work email address, rather than your personal address. +Organization に所属している場合、Organization のアクティビティに関する通知の送信先にするメールアカウントを指定できます。 たとえば、職場の Organization に所属している場合、通知を個人のアドレスではなく、職場のアドレスに送信する方が良いでしょう。 {% data reusables.notifications-v2.email-notification-caveats %} {% data reusables.notifications.access_notifications %} {% data reusables.notifications-v2.manage-notifications %} -3. Under "Default notification email", select the email address you'd like notifications sent to. -![Default notification email address drop-down](/assets/images/help/notifications/notifications_primary_email_for_orgs.png) -4. Click **Save**. +3. [Default notification email] で、通知の送信先にするメールアドレスを選択します。 + ![デフォルトの通知メールアドレスのドロップダウン](/assets/images/help/notifications/notifications_primary_email_for_orgs.png) +4. [**Save**] をクリックします。 -#### Customizing email routes per organization +#### Organization ごとにメールの送信先を設定する -If you are a member of more than one organization, you can configure each one to send notifications to any of{% if currentVersion == "free-pro-team@latest" %} your verified email addresses{% else %} the email addressed you've added to your {% data variables.product.product_name %} account{% endif %}. {% if currentVersion == "free-pro-team@latest" %} For more information, see "[Verifying your email address](/articles/verifying-your-email-address)."{% endif %} +If you are a member of more than one organization, you can configure each one to send notifications to any of{% if currentVersion == "free-pro-team@latest" %} your verified email addresses{% else %} the email addressed you've added to your {% data variables.product.product_name %} account{% endif %}. {% if currentVersion == "free-pro-team@latest" %} For more information, see "[Verifying your email address](/articles/verifying-your-email-address)."{% endif %} {% data reusables.notifications.access_notifications %} {% data reusables.notifications-v2.manage-notifications %} -3. Under "Custom routing," find your organization's name in the list. -![List of organizations and email addresses](/assets/images/help/notifications/notifications_org_emails.png) -4. Click **Edit** next to the email address you want to change. -![Editing an organization's email addresses](/assets/images/help/notifications/notifications_edit_org_emails.png) -5. Select one of your verified email addresses, then click **Save**. -![Switching your per-org email address](/assets/images/help/notifications/notifications_switching_org_email.gif) +3. [Custom routing] で、一覧から Organization の名前を見つけます。 + ![Organization とメールアドレスの一覧](/assets/images/help/notifications/notifications_org_emails.png) +4. 変更したいアドレスの隣にある [**Edit**] をクリックします。 ![Organization のメールアドレスの編集](/assets/images/help/notifications/notifications_edit_org_emails.png) +5. 検証済みメールアドレスのうち 1 つを選択し、[**Save**] をクリックします。 + ![Organization ごとのメールアドレス切り替え](/assets/images/help/notifications/notifications_switching_org_email.gif) {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -### {% data variables.product.prodname_dependabot_alerts %} options +### {% data variables.product.prodname_dependabot_alerts %} の通知オプション {% else %} -### Security alert options +### Security alert options {% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}Choose how you want to receive {% data variables.product.prodname_dependabot_alerts %} for repositories that you are watching. You can receive {% data variables.product.prodname_dependabot_alerts %} in your inbox, as a banner on {% data variables.product.product_name %}, on the command line, through email, or some combination of these options. +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}Choose how you want to receive {% data variables.product.prodname_dependabot_alerts %} for repositories that you are watching. {% if page.version == 'dotcom' %}{% data variables.product.prodname_dependabot_alerts %}{% else %}セキュリティアラート{% endif %}は、インボックス、{% data variables.product.product_name %} のバナー、コマンドライン、メール、またはこれらのオプションの組み合わせで受信できます。 -If you want to receive {% data variables.product.prodname_dependabot_alerts %} by email, choose whether you want a weekly email summary of vulnerabilities for up 10 repositories or a new email each time a vulnerability is detected. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)."{% endif %} +If you want to receive {% data variables.product.prodname_dependabot_alerts %} by email, choose whether you want a weekly email summary of vulnerabilities for up 10 repositories or a new email each time a vulnerability is detected. 詳しい情報については、「[脆弱性のある依存関係に対するアラートについて](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)」を参照してください。 {% endif %} {% if currentVersion == "enterprise-server@2.21" %}Choose how you want to receive security alerts for repositories that you are watching. You can receive security alerts in your inbox, as a banner on {% data variables.product.product_name %}, on the command line, through email, or some combination of these options. -If you want to receive security alerts by email, choose whether you want a weekly email summary of vulnerabilities for up 10 repositories or a new email each time a vulnerability is detected. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)."{% endif %} +If you want to receive security alerts by email, choose whether you want a weekly email summary of vulnerabilities for up 10 repositories or a new email each time a vulnerability is detected. 詳しい情報については、「[脆弱性のある依存関係に対するアラートについて](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)」を参照してください。 {% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} - ![{% data variables.product.prodname_dependabot_short %} alerts options](/assets/images/help/notifications-v2/dependabot-alerts-options.png) + ![{% data variables.product.prodname_dependabot_short %} アラートオプション](/assets/images/help/notifications-v2/dependabot-alerts-options.png) {% else %} ![Security alerts options](/assets/images/help/notifications-v2/security-alerts-options.png) {% endif %} +{% note %} + +If you are a member of more than one organization, you can configure each one to send notifications to any of{% if currentVersion == "free-pro-team@latest" %} your verified email addresses{% else %} the email addressed you've added to your {% data variables.product.product_name %} account{% endif %}. 詳しい情報については「[インボックスからの通知の管理](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox#supported-queries-for-custom-filters)」を参照してください。 + +{% endnote %} + {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -### {% data variables.product.prodname_actions %} notification options +### {% data variables.product.prodname_actions %} の通知オプション Choose how you want to receive workflow run updates for repositories that you are watching that are set up with {% data variables.product.prodname_actions %}. You can also choose to only receive notifications for failed workflow runs. - ![Notification options for {% data variables.product.prodname_actions %}](/assets/images/help/notifications-v2/github-actions-notification-options.png) + ![{% data variables.product.prodname_dependabot_short %} アラートオプション](/assets/images/help/notifications-v2/github-actions-notification-options.png) {% endif %} {% if currentVersion == "free-pro-team@latest" %} -### Enabling push notifications with {% data variables.product.prodname_mobile %} +### {% data variables.product.prodname_mobile %} でプッシュ通知を有効にする -When you install {% data variables.product.prodname_mobile %}, you will automatically be opted into web notifications. You can then enable push notifications for direct mentions within the app. +{% data variables.product.prodname_mobile %} をインストールすると、自動的に Web 通知が有効になります。 You can then enable push notifications for direct mentions within the app. You can only receive notifications for pushes to repositories on {% data variables.product.prodname_mobile %} at this time. -#### Enabling push notifications with {% data variables.product.prodname_ios %} +#### {% data variables.product.prodname_ios %} でプッシュ通知を有効にする -1. Above "Home", tap your profile photo. -2. To view your settings, tap {% octicon "gear" aria-label="The Gear icon" %}. - ![Settings icon for GitHub for iOS](/assets/images/help/mobile/ios-settings-icon.png) -3. To update your notification settings, tap **Push notifications**. -4. To turn on push notifications for direct mentions, use the **Direct Mentions** toggle. +1. [Home] の上にあるプロフィール画像をタップします。 +2. 設定を表示するには、{% octicon "gear" aria-label="The Gear icon" %} をタップします。 ![GitHub iOS 版の設定アイコン](/assets/images/help/mobile/ios-settings-icon.png) +3. 通知設定を更新するには、[**Push notifications**] をタップします。 +4. 直接メンションのプッシュ通知をオンにするには、[**Direct Mentions**] の切り替えを使用します。 -#### Enabling push notifications with {% data variables.product.prodname_android %} +#### {% data variables.product.prodname_android %} でプッシュ通知を有効にする -1. Above "Home", tap your profile photo. -2. To view your settings, tap {% octicon "gear" aria-label="The Gear icon" %}. - ![Settings icon for GitHub for Android](/assets/images/help/mobile/android-settings-icon.png) -3. To turn on push notifications for direct mentions, use the **Direct mentions** toggle. +1. [Home] の上にあるプロフィール画像をタップします。 +2. 設定を表示するには、{% octicon "gear" aria-label="The Gear icon" %} をタップします。 ![GitHub Android 版の設定アイコン](/assets/images/help/mobile/android-settings-icon.png) +3. 直接メンションのプッシュ通知をオンにするには、[**Direct mentions**] の切り替えを使用します。 {% endif %} diff --git a/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/customizing-a-workflow-for-triaging-your-notifications.md b/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/customizing-a-workflow-for-triaging-your-notifications.md index e0173b52c524..e425ef4e8cc9 100644 --- a/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/customizing-a-workflow-for-triaging-your-notifications.md +++ b/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/customizing-a-workflow-for-triaging-your-notifications.md @@ -1,6 +1,6 @@ --- title: 通知をトリアージするためのワークフローをカスタマイズする -intro: これらのワークフロー例を調整してカスタマイズし、通知をトリアージするための理想的なワークフローを作成することができます。 +intro: 'これらのワークフロー例を調整してカスタマイズし、通知をトリアージするための理想的なワークフローを作成することができます。' versions: free-pro-team: '*' enterprise-server: '>=2.21' diff --git a/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md b/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md index 2a3dca19cac6..4a2aeb95a67c 100644 --- a/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md +++ b/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md @@ -1,6 +1,6 @@ --- title: インボックスからの通知を管理する -intro: 'インボックスを使用して、メール{% if currentVersion == "free-pro-team@latest" %}とモバイル{% endif %}間で通知をすばやくトリアージして同期します。' +intro: 'Use your inbox to quickly triage and sync your notifications across email{% if currentVersion == "free-pro-team@latest" %} and mobile{% endif %}.' redirect_from: - /articles/marking-notifications-as-read - /articles/saving-notifications-for-later @@ -19,7 +19,6 @@ To access your notifications inbox, in the upper-right corner of any page, click ![未読メッセージを示す通知](/assets/images/help/notifications/notifications_general_existence_indicator.png) - インボックスには、登録を解除していないか、**Done** とマークされていないすべての通知が表示されます。ワークフローに対して最適な形になるよう、フィルタを使用してインボックスをカスタマイズし、すべてまたは未読の通知を表示して、通知をグループ化することで概要をすばやく確認できます。 ![inbox view](/assets/images/help/notifications-v2/inbox-view.png) @@ -113,7 +112,7 @@ To filter notifications by why you've received an update, you can use the `reaso #### サポートされている `is:` クエリ -{% data variables.product.product_name %} での特定のアクティビティの通知をフィルタするには、`is` クエリを使用できます。 For example, to only see repository invitation updates, use `is:repository-invitation`. +{% data variables.product.product_name %} での特定のアクティビティの通知をフィルタするには、`is` クエリを使用できます。 For example, to only see repository invitation updates, use `is:repository-invitation`, and to only see {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %} security{% endif %} alerts, use `is:repository-vulnerability-alert`. - `is:check-suite` - `is:commit` diff --git a/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github.md b/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github.md index 3df1461f83e5..ab4817ace832 100644 --- a/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github.md +++ b/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github.md @@ -1,6 +1,6 @@ --- title: GitHub におけるアクティビティのサブスクリプションを管理する -intro: 持続可能な通知ワークフローを維持するには、サブスクリプションを理解し、定期的に確認します。 +intro: '持続可能な通知ワークフローを維持するには、サブスクリプションを理解し、定期的に確認します。' mapTopic: true versions: free-pro-team: '*' diff --git a/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md b/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md index ee8b3ac1359d..dfad6716fd30 100644 --- a/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md +++ b/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md @@ -1,6 +1,6 @@ --- title: サブスクリプションを管理する -intro: 通知を効率的に管理するにあたって、サブスクライブ解除するにはいくつかの方法があります。 +intro: '通知を効率的に管理するにあたって、サブスクライブ解除するにはいくつかの方法があります。' versions: free-pro-team: '*' enterprise-server: '>=2.21' diff --git a/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/setting-up-notifications.md b/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/setting-up-notifications.md index 6016ff5c514a..4ce1c6733431 100644 --- a/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/setting-up-notifications.md +++ b/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/setting-up-notifications.md @@ -1,6 +1,6 @@ --- title: 通知を設定する -intro: 通知の関連性を高め、トリアージワークフローを簡素化するには、優先度に合わせて通知を設定します。 +intro: '通知の関連性を高め、トリアージワークフローを簡素化するには、優先度に合わせて通知を設定します。' mapTopic: true redirect_from: - /articles/getting-started-with-notifications diff --git a/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/triaging-a-single-notification.md b/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/triaging-a-single-notification.md index 1b25c78a6123..cfe69dddf0ab 100644 --- a/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/triaging-a-single-notification.md +++ b/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/triaging-a-single-notification.md @@ -1,6 +1,6 @@ --- title: 単一の通知をトリアージする -intro: 単一の通知を確認して調査する場合、詳細な通知ビュー用に最適化されたいくつかのトリアージオプションがあります。 +intro: '単一の通知を確認して調査する場合、詳細な通知ビュー用に最適化されたいくつかのトリアージオプションがあります。' versions: free-pro-team: '*' enterprise-server: '>=2.21' diff --git a/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications.md b/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications.md index 8c640a5fe3aa..b1e0b05551f1 100644 --- a/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications.md +++ b/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications.md @@ -1,6 +1,6 @@ --- title: 通知の表示とトリアージ -intro: 通知ワークフローを最適化するために、通知の表示方法とトリアージ方法をカスタマイズできます。 +intro: '通知ワークフローを最適化するために、通知の表示方法とトリアージ方法をカスタマイズできます。' mapTopic: true redirect_from: - /articles/managing-notifications/ diff --git a/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions.md b/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions.md index 50f35055f403..f018e19a6014 100644 --- a/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions.md +++ b/translations/ja-JP/content/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions.md @@ -1,6 +1,6 @@ --- title: サブスクリプションを表示する -intro: 通知の送信元と通知のボリュームを把握するため、定期的にサブスクリプションを確認し、リポジトリを Watch することをお勧めします。 +intro: '通知の送信元と通知のボリュームを把握するため、定期的にサブスクリプションを確認し、リポジトリを Watch することをお勧めします。' redirect_from: - /articles/subscribing-to-conversations/ - /articles/unsubscribing-from-conversations/ diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md b/translations/ja-JP/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md index b5abea0c0a64..01c24fac4af6 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md @@ -22,15 +22,15 @@ versions: ### サポートされているクエリパラメータ -| クエリパラメータ | サンプル | -| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `body` | `https://github.com/octo-org/octo-repo/compare/master...pull-request-test?quick_pull=1&body=Fixes+the+problem.` は、`master` と `pull-request-test` のブランチを比較して、ボディに "Fixes the problem" というコメントを付けてプルリクエストを作成します。 | -| `title` | `https://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report` は、"bug" というラベルと "New bug report" というタイトルを付けて Issue を作成します。 | -| `labels` | `https://github.com/octo-org/octo-repo/compare/master...pull-request-test?quick_pull=1&labels=bug` は、`master` ブランチと `pull-request-test` ブランチを比較して、"bug" というラベルを付けてプルリクエストを作成します。 | -| `template` | `https://github.com/octo-org/octo-repo/issues/new?template=issue_template.md` は、ボディにテンプレートを付けて Issue を作成します。 | -| `milestone` | `https://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones` は、"testing milestones" というマイルストーンを持たせて Issue を作成します。 | -| `assignees` | `https://github.com/octo-org/octo-repo/issues/new?assignees=octocat` は、Issue を作成して @octocat に割り当てます。 | -| `projects` | `https://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1` は、"Bug fix" というタイトルを付けて Issue を作成し、それを Organization のプロジェクトボード 1 に追加します。 | +| クエリパラメータ | サンプル | +| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `body` | `https://github.com/octo-org/octo-repo/compare/main...pull-request-test?quick_pull=1&body=Fixes+the+problem.` creates a pull request, comparing the branches `main` and `pull-request-test`, with the comment "Fixes the problem" in the pull request body. | +| `title` | `https://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report` は、"bug" というラベルと "New bug report" というタイトルを付けて Issue を作成します。 | +| `labels` | `https://github.com/octo-org/octo-repo/compare/main...pull-request-test?quick_pull=1&labels=bug` creates a pull request, comparing the branches `main` and `pull-request-test`, with the label "bug." | +| `template` | `https://github.com/octo-org/octo-repo/issues/new?template=issue_template.md` は、ボディにテンプレートを付けて Issue を作成します。 | +| `マイルストーン` | `https://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones` は、"testing milestones" というマイルストーンを持たせて Issue を作成します。 | +| `assignees` | `https://github.com/octo-org/octo-repo/issues/new?assignees=octocat` は、Issue を作成して @octocat に割り当てます。 | +| `projects` | `https://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1` は、"Bug fix" というタイトルを付けて Issue を作成し、それを Organization のプロジェクトボード 1 に追加します。 | ### カスタムテンプレートでIssueやプルリクエストを記入する diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/about-automation-for-project-boards.md b/translations/ja-JP/content/github/managing-your-work-on-github/about-automation-for-project-boards.md index 25236dc8d58d..e340630a4f54 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/about-automation-for-project-boards.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/about-automation-for-project-boards.md @@ -32,6 +32,6 @@ versions: プロジェクトボードの自動化によって、デフォルトで進捗を追跡できるようになります。 "To do"、"In progress"、"Done" がプリセットされた列内のカードは、プロジェクト全体の進捗に対してカウントされます。 {% data reusables.project-management.project-progress-locations %} ### 参考リンク -- 「[プロジェクトボードの自動化を設定する](/articles/configuring-automation-for-project-boards)」{% if currentVersion == "free-pro-team@latest" %} +- "[Configuring automation for project boards](/articles/configuring-automation-for-project-boards)"{% if currentVersion == "free-pro-team@latest" %} - [プロジェクトボードのコピー](/articles/copying-a-project-board) {% endif %} diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/about-issues.md b/translations/ja-JP/content/github/managing-your-work-on-github/about-issues.md index 90f7ec1510d4..1876009a0d4f 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/about-issues.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/about-issues.md @@ -3,7 +3,7 @@ title: Issueについて intro: '{% data variables.product.product_name %}での作業についてのアイデア、拡張、タスク、バグの追跡にIssueを使ってください。' redirect_from: - /articles/creating-issues/ - - /articles/about-issues + - /articles/about-issues/ versions: free-pro-team: '*' enterprise-server: '*' @@ -13,7 +13,7 @@ versions: {% data reusables.pull_requests.close-issues-using-keywords %} -Issue 内の最も最新のコメントの情報を得ておきたい場合には、Issue を Watch して最新のコメントについての通知を受けることができます。 詳しい情報については、{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}「[通知について](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}「[通知について](/github/receiving-notifications-about-activity-on-github/about-notifications){% endif %}」を参照してください。 +Issue 内の最も最新のコメントの情報を得ておきたい場合には、Issue を Watch して最新のコメントについての通知を受けることができます。 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 %}." サブスクライブした Issue の最新の更新へのリンクを素早く見つけるには、ダッシュボードにアクセスしてください。 詳しい情報については[パーソナルダッシュボードについて](/articles/about-your-personal-dashboard)を参照してください。 @@ -22,10 +22,10 @@ Issue 内の最も最新のコメントの情報を得ておきたい場合に Issue を使うと、以下のことができます: - プロジェクトボードを使用して作業を追跡し、優先順位を付ける。 詳細は「[プロジェクトボードを使用する](/articles/about-project-boards)」を参照してください。 - 新しい Issue を作成して、Issue または Pull Request レビューのコメントから、スコープ外のフィードバックを追跡する。 詳しい情報については「[コメントからIssueを開く](/github/managing-your-work-on-github/opening-an-issue-from-a-comment)」を参照してください。 -- Issue テンプレートを作成して、コントリビューターが有意義な Issue をオープンしやすくする。 詳細は「[Issue およびプルリクエストのテンプレートについて](/articles/about-issue-and-pull-request-templates)」を参照してください。{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -- オープン Issue を別のリポジトリへ移譲する。 詳細は「[他のリポジトリへ Issue を移譲する](/articles/transferring-an-issue-to-another-repository)」を参照してください。{% endif %} +- Issue テンプレートを作成して、コントリビューターが有意義な Issue をオープンしやすくする。 詳しい情報については[Issue およびプルリクエストのテンプレートについて](/articles/about-issue-and-pull-request-templates)を参照してください。 +- オープン Issue を別のリポジトリへ移譲する。 詳細は「[他のリポジトリへ Issue を移譲する](/articles/transferring-an-issue-to-another-repository)」を参照してください。 - 重要な Issue をピン止めして見つけやすくし、Issue の重複を避けてノイズを減らす。 詳細は「[Issue をリポジトリにピン止めする](/articles/pinning-an-issue-to-your-repository)」を参照してください。 -- 返信テンプレートを使って重複 Issue を追跡する。 詳細は「[返信テンプレートについて](/articles/about-saved-replies)」を参照してください。{% if currentVersion == "free-pro-team@latest" %} +- 返信テンプレートを使って重複 Issue を追跡する。 For more information, see "[About saved replies](/articles/about-saved-replies)."{% if currentVersion == "free-pro-team@latest" %} - {% data variables.product.prodname_dotcom %}の[コミュニティガイドライン](/articles/github-community-guidelines)に違反するコメントをレポートする。 詳細は「[乱用やスパムをレポートする](/articles/reporting-abuse-or-spam)」を参照してください。{% endif %} Issue は[他のユーザに割り当て](/articles/assigning-issues-and-pull-requests-to-other-github-users)たり、素早く検索できるように[ラベルでタグ付け](/articles/applying-labels-to-issues-and-pull-requests)したり、[マイルストーンでグループ化](/articles/creating-and-editing-milestones-for-issues-and-pull-requests)したりすることもできます。 diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/about-labels.md b/translations/ja-JP/content/github/managing-your-work-on-github/about-labels.md index 21a315332455..402bddaa1164 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/about-labels.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/about-labels.md @@ -16,17 +16,17 @@ versions: {% data variables.product.product_name %} は、すべての新しいリポジトリにデフォルトのラベルを提供します。 これらのデフォルトのラベルを使って、リポジトリの標準的なワークフローを作成しやすくできます。 -| ラベル | 説明 | -| ------------------ | --------------------------------------------------------------------------------------- | -| `bug` | 予想外の問題あるいは意図しない振る舞いを示します{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| `documentation` | ドキュメンテーションに改善や追加が必要であることを示します{% endif %} -| `duplicate` | 同様の Issue あるいはプルリクエストを示します | -| `enhancement` | 新しい機能のリクエストを示します | -| `good first issue` | 初回のコントリビューターに適した Issue を示します | -| `help wanted` | メンテナーが Issue もしくはプルリクエストに助けを求めていることを示します | -| `invalid` | Issue あるいはプルリクエストに関連性がなくなったことを示します | -| `question` | Issue あるいはプルリクエストにさらなる情報が必要なことを示します | -| `wontfix` | Issue あるいはプルリクエストの作業が継続されないことを示します | +| ラベル | 説明 | +| ------------------ | --------------------------------------------------------------- | +| `bug` | Indicates an unexpected problem or unintended behavior | +| `documentation` | Indicates a need for improvements or additions to documentation | +| `duplicate` | 同様の Issue あるいはプルリクエストを示します | +| `enhancement` | 新しい機能のリクエストを示します | +| `good first issue` | 初回のコントリビューターに適した Issue を示します | +| `help wanted` | メンテナーが Issue もしくはプルリクエストに助けを求めていることを示します | +| `invalid` | Issue あるいはプルリクエストに関連性がなくなったことを示します | +| `question` | Issue あるいはプルリクエストにさらなる情報が必要なことを示します | +| `wontfix` | Issue あるいはプルリクエストの作業が継続されないことを示します | リポジトリの作成時に、すべての新しいリポジトリにデフォルトのラベルが含められますが、後でそのラベルを編集または削除できます。 詳細は「[ラベルの削除](/articles/deleting-a-label/)」を参照してください。 diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/about-project-boards.md b/translations/ja-JP/content/github/managing-your-work-on-github/about-project-boards.md index 78e06446c5c4..8f48e0f0cebe 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/about-project-boards.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/about-project-boards.md @@ -59,7 +59,7 @@ Organization が所有するプロジェクトボードに、あなたが表示 ### 参考リンク - [プロジェクトボードの作成](/articles/creating-a-project-board) -- [プロジェクトボードの編集](/articles/editing-a-project-board){% if currentVersion == "free-pro-team@latest" %} +- "[Editing a project board](/articles/editing-a-project-board)"{% if currentVersion == "free-pro-team@latest" %} - [プロジェクトボードのコピー](/articles/copying-a-project-board) {% endif %} - [プロジェクトボードへの Issue およびプルリクエストの追加](/articles/adding-issues-and-pull-requests-to-a-project-board) diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md b/translations/ja-JP/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md index d631d1501db8..87b433edf9b3 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md @@ -54,15 +54,8 @@ versions: 1. Issue あるいはプルリクエストの右側で、[**Projects {% octicon "gear" aria-label="The Gear icon" %}**] をクリックします。 ![サイドバーのプロジェクトボードボタン](/assets/images/help/projects/sidebar-project.png) 2. 追加したいプロジェクトボードの [**Recent**]、[**Repository**]、[**User**]、[**Organization**] タブをクリックします。 ![Recent、Repository、Organization タブ](/assets/images/help/projects/sidebar-project-tabs.png) 3. [**Filter projects**] フィールドにプロジェクト名を入力します。 ![プロジェクトボードの検索ボックス](/assets/images/help/projects/sidebar-search-project.png) -4. Issueまたはプルリクエストを追加する1つ以上のプロジェクトボードを選択します。 ![Selected project board](/assets/images/help/projects/sidebar-select-project.png){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -5. Click -{% octicon "triangle-down" aria-label="The down triangle icon" %}, then click the column where you want your issue or pull request. カードが、選択したプロジェクトボードの列の下部に移動します。 - ![[Move card to column] メニュー](/assets/images/help/projects/sidebar-select-project-board-column-menu.png) -{% else %} -5. Issue あるいはプルリクエストの右側で、[**PROJECT-BOARD-NAME (awaiting triage)**] (プロジェクトボード名、トリアージ待ち) をクリックします。 ![プロジェクトボードへのリンク](/assets/images/help/projects/sidebar-project-board-link.png) -6. プロジェクトボードで [**{% octicon "plus" aria-label="The Plus icon" %} Add cards (1 new)**] をクリックします。 ![カードの追加ボタン](/assets/images/help/projects/add-cards-pending-button.png) -7. [**Triage**] セクションから Issue あるいはプルリクエストのカードを、プロジェクトボードの希望する列へドラッグします。 あるいは、キーボードショートカットを使ってカードを移動させることもできます。 {% data reusables.project-management.for-more-info-project-keyboard-shortcuts %} -{% endif %} +4. Select one or more project boards where you want to add the issue or pull request. ![選択されたプロジェクトボード](/assets/images/help/projects/sidebar-select-project.png) +5. {% octicon "triangle-down" aria-label="The down triangle icon" %} をクリックし、Issueまたはプルリクエストが必要な列をクリックします。 カードが、選択したプロジェクトボードの列の下部に移動します。 ![[Move card to column] メニュー](/assets/images/help/projects/sidebar-select-project-board-column-menu.png) ### 参考リンク diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/applying-labels-to-issues-and-pull-requests.md b/translations/ja-JP/content/github/managing-your-work-on-github/applying-labels-to-issues-and-pull-requests.md index da38f0d9a1c3..4e2610a43638 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/applying-labels-to-issues-and-pull-requests.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/applying-labels-to-issues-and-pull-requests.md @@ -1,6 +1,6 @@ --- title: Issue およびプルリクエストへのラベルの適用 -intro: 書き込みアクセスを持っているリポジトリでは、Issue やリポジトリにラベルを割り当て、プロジェクトを整理しやすくできます。 +intro: '書き込みアクセスを持っているリポジトリでは、Issue やリポジトリにラベルを割り当て、プロジェクトを整理しやすくできます。' redirect_from: - /articles/customizing-issue-labels/ - /articles/applying-labels-to-issues-and-pull-requests @@ -18,7 +18,8 @@ versions: {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issue-pr %} {% data reusables.repositories.select-items-in-issue-or-pr-list %} -4. 右上で [**Label**] をクリックし、続けて既存のラベル名を入力してください。 ラベルの名前をクリックして、選択されたアイテムに関連付けてください。 ![Issue のマイルストーン割り当てドロップダウンメニュー](/assets/images/help/issues/issues_applying_labels_dropdown.png) +4. 右上で [**Label**] をクリックし、続けて既存のラベル名を入力してください。 ラベルの名前をクリックして、選択されたアイテムに関連付けてください。 You can also apply a label in the Labels drop-down menu within an issue or pull request. ![Issue のマイルストーン割り当てドロップダウンメニュー](/assets/images/help/issues/issues_applying_labels_dropdown.png) + ### 参考リンク diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/archiving-cards-on-a-project-board.md b/translations/ja-JP/content/github/managing-your-work-on-github/archiving-cards-on-a-project-board.md index 1e0f5eb9b9ae..dff88ecbd22b 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/archiving-cards-on-a-project-board.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/archiving-cards-on-a-project-board.md @@ -13,7 +13,7 @@ versions: ### プロジェクトボード上のカードのアーカイブ 1. プロジェクトボードで、アーカイブしたいカードを見つけて {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} をクリックします。 ![プロジェクトボードカードの編集オプションのリスト](/assets/images/help/projects/select-archiving-options-project-board-card.png) -2. Click **Archive**. ![メニューからのアーカイブオプションの選択](/assets/images/help/projects/archive-project-board-card.png) +2. [**Archive**] をクリックします。 ![メニューからのアーカイブオプションの選択](/assets/images/help/projects/archive-project-board-card.png) ### サイドバーからのプロジェクトボード上のカードのリストア diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md b/translations/ja-JP/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md index 1841cec7c7bd..d783f1cf165f 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md @@ -10,7 +10,7 @@ versions: リポジトリへの書き込み権限があるユーザなら誰でもIssue およびプルリクエストをアサインできます。 -自身、{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}該当する Issue またはプルリクエストにコメントした任意の人、{% endif %}リポジトリへの書き込み権限がある任意の人、およびリポジトリの読み取り権限がある Organization メンバーを含めて、最大 10 人まで各 Issue またはプルリクエストにアサインできます。 詳細は「[{% data variables.product.prodname_dotcom %} 上のアクセス権限](/articles/access-permissions-on-github)」を参照してください。 +You can assign up to 10 people to each issue or pull request, including yourself, anyone who has commented on the issue or pull request, anyone with write permissions to the repository, and organization members with read permissions to the repository. 詳細は「[{% data variables.product.prodname_dotcom %} 上のアクセス権限](/articles/access-permissions-on-github)」を参照してください。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issue-pr %} diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/changing-project-board-visibility.md b/translations/ja-JP/content/github/managing-your-work-on-github/changing-project-board-visibility.md index 07b2fae5074d..e71e116b2e8b 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/changing-project-board-visibility.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/changing-project-board-visibility.md @@ -1,6 +1,6 @@ --- title: プロジェクトボードの表示設定の変更 -intro: Organization のオーナーあるいはプロジェクトボードの管理者は、プロジェクトボードをパブリックまたはプライベートに設定できます。 +intro: 'Organization のオーナーあるいはプロジェクトボードの管理者は、プロジェクトボードをパブリックまたはプライベートに設定できます。' redirect_from: - /articles/changing-project-board-visibility versions: diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/closing-a-project-board.md b/translations/ja-JP/content/github/managing-your-work-on-github/closing-a-project-board.md index 9e05ddec88a2..86fb6e13d50a 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/closing-a-project-board.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/closing-a-project-board.md @@ -1,6 +1,6 @@ --- title: プロジェクトボードをクローズする -intro: プロジェクトボードのタスクをすべて完了したか、プロジェクトボードを使う必要がなくなった場合、そのプロジェクトボードをクローズできます。 +intro: 'プロジェクトボードのタスクをすべて完了したか、プロジェクトボードを使う必要がなくなった場合、そのプロジェクトボードをクローズできます。' redirect_from: - /articles/closing-a-project/ - /articles/closing-a-project-board @@ -15,7 +15,7 @@ versions: 1. リポジトリまたは Organization の、またはあなたのユーザアカウントが所有する、プロジェクトボードの一覧に移動します。 2. プロジェクトリストで、クローズしたいプロジェクトボードの隣にある {% octicon "chevron-down" aria-label="The chevron icon" %}をクリックします。 ![プロジェクトボードの名前の右にある、V 字型のアイコン](/assets/images/help/projects/project-list-action-chevron.png) -3. Click **Close**. ![プロジェクトボードのドロップダウンメニューにある [Close] アイテム](/assets/images/help/projects/close-project.png) +3. [**Close**] をクリックします。 ![プロジェクトボードのドロップダウンメニューにある [Close] アイテム](/assets/images/help/projects/close-project.png) ### 参考リンク diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/creating-a-label.md b/translations/ja-JP/content/github/managing-your-work-on-github/creating-a-label.md index c0f50dfa6fa2..98a5fb69b5a6 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/creating-a-label.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/creating-a-label.md @@ -1,6 +1,6 @@ --- title: ラベルの作成 -intro: 書き込みアクセスを持つリポジトリでは、Issue とプルリクエストを整理するためのラベルを作成できます。 +intro: '書き込みアクセスを持つリポジトリでは、Issue とプルリクエストを整理するためのラベルを作成できます。' redirect_from: - /articles/creating-and-editing-labels-for-issues-and-pull-requests/ - /articles/creating-a-label @@ -29,6 +29,6 @@ versions: - [ラベルについて](/articles/about-labels) - "[Issue およびプルリクエストにラベルを適用する](/articles/applying-labels-to-issues-and-pull-requests)" - "[ラベルの編集](/articles/editing-a-label)" -- [Issue およびプルリクエストをラベルでフィルタリングする](/articles/filtering-issues-and-pull-requests-by-labels){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} +- "[Filtering issues and pull requests by labels](/articles/filtering-issues-and-pull-requests-by-labels)"{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} - [Organization 内のリポジトリのためのデフォルトラベルを管理する](/articles/managing-default-labels-for-repositories-in-your-organization) {% endif %} diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/creating-a-project-board.md b/translations/ja-JP/content/github/managing-your-work-on-github/creating-a-project-board.md index dbad222408c0..893ce7abcbc3 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/creating-a-project-board.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/creating-a-project-board.md @@ -1,6 +1,6 @@ --- title: プロジェクトボードの作成 -intro: プロジェクトボードは、特定機能の働きの追跡と優先度付け、総合的なロードマップ、さらにはリリースチェックリストなど、ニーズを満たすカスタマイズワークフローを作成するために使用できます。 +intro: 'プロジェクトボードは、特定機能の働きの追跡と優先度付け、総合的なロードマップ、さらにはリリースチェックリストなど、ニーズを満たすカスタマイズワークフローを作成するために使用できます。' redirect_from: - /articles/creating-a-project/ - /articles/creating-a-project-board @@ -24,8 +24,8 @@ versions: ### ユーザが所有するプロジェクトボードの作成 {% data reusables.profile.access_profile %} -2. On the top of your profile page, in the main navigation, click -{% octicon "project" aria-label="The project board icon" %} **Projects**. +2. プロフィールページの一番上のメインナビゲーションにある +{% octicon "project" aria-label="The project board icon" %} [**Projects**] をクリックします。 ![プロジェクトタブ](/assets/images/help/projects/user-projects-tab.png) {% data reusables.project-management.click-new-project %} {% data reusables.project-management.create-project-name-description %} @@ -64,7 +64,7 @@ versions: {% data reusables.repositories.navigate-to-repo %} 2. リポジトリ名の下で、クリックします -{% octicon "project" aria-label="The project board icon" %} **Projects**. +{% octicon "project" aria-label="The project board icon" %} [**Projects**] をクリックします。 ![プロジェクトタブ](/assets/images/help/projects/repo-tabs-projects.png) {% data reusables.project-management.click-new-project %} {% data reusables.project-management.create-project-name-description %} @@ -82,7 +82,7 @@ versions: ### 参考リンク - "[プロジェクトボードについて](/articles/about-project-boards)" -- [プロジェクトボードの編集](/articles/editing-a-project-board){% if currentVersion == "free-pro-team@latest" %} +- "[Editing a project board](/articles/editing-a-project-board)"{% if currentVersion == "free-pro-team@latest" %} - [プロジェクトボードのコピー](/articles/copying-a-project-board) {% endif %} - "[プロジェクトボードをクローズする](/articles/closing-a-project-board)" diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/creating-an-issue.md b/translations/ja-JP/content/github/managing-your-work-on-github/creating-an-issue.md index ed3e9b650fe9..ac0d1ca8a3c5 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/creating-an-issue.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/creating-an-issue.md @@ -1,6 +1,6 @@ --- title: Issue の作成 -intro: Issue は、バグ、拡張、その他リクエストの追跡に使用できます。 +intro: 'Issue は、バグ、拡張、その他リクエストの追跡に使用できます。' redirect_from: - /articles/creating-an-issue versions: @@ -17,7 +17,7 @@ Issue または Pull Requestレビューのコメントから新しい Issue を {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} {% tip %} -**Tip**: You can also create an issue using the {% data variables.product.prodname_cli %}. For more information, see "[`gh issue create`](https://cli.github.com/manual/gh_issue_create)" in the {% data variables.product.prodname_cli %} documentation. +**ヒント**: {% data variables.product.prodname_cli %} を使用して Issue を作成することもできます。 詳しい情報については、ドキュメントの「[`gh issue create`](https://cli.github.com/manual/gh_issue_create)」{% data variables.product.prodname_cli %} を参照してください。 {% endtip %} {% endif %} diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/deleting-a-label.md b/translations/ja-JP/content/github/managing-your-work-on-github/deleting-a-label.md index 7583f82b60e5..6d29eaa2cdf8 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/deleting-a-label.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/deleting-a-label.md @@ -1,6 +1,6 @@ --- title: ラベルの削除 -intro: 書き込みアクセスのあるリポジトリでは、Issue やプルリクエストを分類するために必要のないラベルを削除できます。 +intro: '書き込みアクセスのあるリポジトリでは、Issue やプルリクエストを分類するために必要のないラベルを削除できます。' redirect_from: - /articles/deleting-a-label versions: @@ -18,6 +18,6 @@ versions: ### 参考リンク - "[Issue およびプルリクエストにラベルを適用する](/articles/applying-labels-to-issues-and-pull-requests)" -- [Issue およびプルリクエストをラベルでフィルタリングする](/articles/filtering-issues-and-pull-requests-by-labels){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} +- "[Filtering issues and pull requests by labels](/articles/filtering-issues-and-pull-requests-by-labels)"{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} - [Organization 内のリポジトリのためのデフォルトラベルを管理する](/articles/managing-default-labels-for-repositories-in-your-organization) {% endif %} diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/disabling-issues.md b/translations/ja-JP/content/github/managing-your-work-on-github/disabling-issues.md index 39f613bbea30..a29fb29f5ced 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/disabling-issues.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/disabling-issues.md @@ -17,8 +17,9 @@ versions: {% if currentVersion == "free-pro-team@latest" %} {% tip %} +Please contact -他者による悪用を防ぐため Issues をオフにしたいということであれば、{% data variables.contact.contact_support %} までご連絡ください。 +{% data variables.contact.contact_support %} if you want to turn off issues because of abuse from strangers. {% data reusables.policies.abuse %} {% endtip %} diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/editing-a-label.md b/translations/ja-JP/content/github/managing-your-work-on-github/editing-a-label.md index 6db92ae21eba..ea61011ad5de 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/editing-a-label.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/editing-a-label.md @@ -1,6 +1,6 @@ --- title: ラベルの編集 -intro: 書き込みアクセスがあるリポジトリでは、既存のラベルの名前、色、および説明を編集できます。 +intro: '書き込みアクセスがあるリポジトリでは、既存のラベルの名前、色、および説明を編集できます。' redirect_from: - /articles/editing-a-label versions: @@ -23,6 +23,6 @@ versions: - "[ラベルの作成](/articles/creating-a-label)" - "[ラベルの削除](/articles/deleting-a-label)" - "[Issue およびプルリクエストにラベルを適用する](/articles/applying-labels-to-issues-and-pull-requests)" -- [Issue およびプルリクエストをラベルでフィルタリングする](/articles/filtering-issues-and-pull-requests-by-labels){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} +- "[Filtering issues and pull requests by labels](/articles/filtering-issues-and-pull-requests-by-labels)"{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} - [Organization 内のリポジトリのためのデフォルトラベルを管理する](/articles/managing-default-labels-for-repositories-in-your-organization) {% endif %} diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests.md b/translations/ja-JP/content/github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests.md index 95493377046a..53a67879b052 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests.md @@ -1,6 +1,6 @@ --- -title: Issue およびプルリクエストのファイル添付 -intro: Issue を開いたりプルリクエストを更新したりする際に、Issue の添付を使用して機能の提案やバグのスクリーンショットの画像をアップロードできます。 +title: File attachments on issues and pull requests +intro: 'When you open issue or update a pull request, you can use issue attachments to upload images of proposed features or screenshots of bugs.' redirect_from: - /articles/issue-attachments/ - /articles/file-attachments-on-issues-and-pull-requests @@ -8,34 +8,33 @@ versions: free-pro-team: '*' enterprise-server: '*' --- - {% warning %} -**警告:**Pull Request や Issue へのコメントに画像添付を追加した場合、その Pull Request がプライベートリポジトリのものである場合、{% if currentVersion != "free-pro-team@latest" %}またはプライベートモードが有効化されている場合も、{% endif %}匿名化した画像 URL は認証なしに誰もが見ることができます。 機密の画像をプライベートにしておきたい場合は、それらを認証が必要なプライベートなネットワークあるいはサーバーから提供するようにしてください。 {% if currentVersion == "free-pro-team@latest" %}匿名化した URL の詳細については、「[匿名化された画像 URL について](/articles/about-anonymized-image-urls)」を参照してください。{% endif %} +**Warning:** If you add an image to a pull request or issue comment, anyone can view the anonymized image URL without authentication, even if the pull request is in a private repository{% if currentVersion != "free-pro-team@latest" %}, or if private mode is enabled{% endif %}. To keep sensitive images private, serve them from a private network or server that requires authentication. {% if currentVersion == "free-pro-team@latest" %}For more information on anonymized URLs see "[About anonymized image URLs](/articles/about-anonymized-image-urls)".{% endif %} {% endwarning %} -Issue やプルリクエストの会話にファイルを添付するには、コメントボックスにファイルをドラッグアンドドロップします。 または、コメントボックスの下部にあるバーをクリックしてコンピュータからファイルを参照、選択、追加することもできます。 +To attach a file to an issue or pull request conversation, drag and drop it into the comment box. Alternatively, you can click the bar at the bottom of the comment box to browse, select, and add a file from your computer. -![コンピュータから添付ファイルを選択する](/assets/images/help/pull_requests/select-bar.png) +![Select attachments from computer](/assets/images/help/pull_requests/select-bar.png) {% tip %} -**ヒント:** Chrome をお使いの場合は、ボックスに画像を直接コピーして貼り付けることもできます。 +**Tip:** If you're using Chrome, you can also copy-and-paste images directly into the box. {% endtip %} -ファイルの最大サイズは 25MB で、画像の最大サイズは 10MB です。 +The maximum size for files is 25MB and the maximum size for images is 10MB. -以下のファイルがサポートされています: +We support these files: * PNG (*.png*) * GIF (*.gif*) * JPEG (*.jpg*) -* ログファイル (*.log*) -* Microsoft Word (*.docx*)、Powerpoint (*.pptx*)、および Excel (*.xlsx*) 文書 -* テキストファイル (*.txt*) -* PDF (*.pdf*) +* Log files (*.log*) +* Microsoft Word (*.docx*), Powerpoint (*.pptx*), and Excel (*.xlsx*) documents +* Text files (*.txt*) +* PDFs (*.pdf*) * ZIP (*.zip*, *.gz*) -![添付アニメーション GIF](/assets/images/help/pull_requests/dragging_images.gif) +![Attachments animated GIF](/assets/images/help/pull_requests/dragging_images.gif) diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md b/translations/ja-JP/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md index 2f83ee3192f7..ab7b8f17e359 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md @@ -8,20 +8,20 @@ versions: enterprise-server: '*' --- -カードでは、任意のアサインされた人{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}、マイルストーン、{% endif %}、またはラベルをクリックして、その修飾子でプロジェクトをフィルタリングできます。 検索をクリアするには、同じアサインされた人{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}、マイルストーン、{% endif %}またはラベルを再度クリックします。 +On a card, you can click any assignee, milestone, or label to filter the project board by that qualifier. To clear the search, you can click the same assignee, milestone, or label again. また、各プロジェクトボードの上部にある [Filter cards] 検索バーを使用して、カードを検索することも可能です。 以下の検索修飾子をさまざまに組み合わせて使用したり、検索したいテキストを入力したりすることで、カードをフィルタリングできます。 - `author:USERNAME` を使用してカードを作者でフィルタする - `assignee:USERNAME` または `no:assignee` を使用して、カードをアサインされた人でフィルタリングする -- `label:LABEL`、`label:"MULTI-WORD LABEL NAME"`、または `no:label` を使用して、カードをラベルでフィルタリングする{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -- `milestone:MY-MILESTONE` を使用して、カードをマイルストーンでフィルタリングする{% endif %} +- Filter cards by label using `label:LABEL`, `label:"MULTI-WORD LABEL NAME"`, or `no:label` +- `milestone:MY-MILESTONE` を使用して、カードをマイルストーンでフィルタリングする - `state:open`、`state:closed`、または `state:merged` を使用して、カードを状態でフィルタリングする - `review:none`、`review:required`、`review:approved`、または `review:changes_requested` を使用して、カードをレビューステータスでフィルタリングする - `status:pending`、`status:success`、または `status:failure` を使用して、カードをチェックステータスでフィルタリングする - `type:issue`、`type:pr`、または `type:note` を使用して、カードをタイプでフィルタリングする - `is:open`、`is:closed`、または `is:merged`と、`is:issue`、`is:pr`、または `is:note` とを使用して、カードをステータスとタイプでフィルタリングする -- `linked:pr`を使用してクローズしているリファレンスによってプルリクエストにリンクされている Issue でカードをフィルタリングする{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +- Filter cards by issues that are linked to a pull request by a closing reference using `linked:pr`{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} - `repo:ORGANIZATION/REPOSITORY` を使用して、Organization 全体のプロジェクトボード内のリポジトリでカードをフィルタリングする{% endif %} 1. フィルタリングしたいカードが含まれるプロジェクトボードに移動します。 diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests-by-milestone.md b/translations/ja-JP/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests-by-milestone.md index 8ed29b78fbb2..c599e789adcd 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests-by-milestone.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests-by-milestone.md @@ -14,7 +14,7 @@ versions: - 検索バーを使用して Issue とプルリクエストをフィルタリングしたい場合は、マイルストーンの検索構文を使用できます。 My Milestone という名前のマイルストーンであれば、検索構文は `milestone:"My Milestone"` となります。 - フィルタの選択をクリアするには、[**Clear current search query, filters, and sorts**] をクリックします。 -- You can also filter issues or pull requests using the {% data variables.product.prodname_cli %}. For more information, see "[`gh issue list`](https://cli.github.com/manual/gh_issue_list)" or "[`gh pr list`](https://cli.github.com/manual/gh_pr_list)" in the {% data variables.product.prodname_cli %} documentation. +- {% data variables.product.prodname_cli %} を使用して Issue またはプルリクエストをフィルタすることもできます。 For more information, see "[`gh issue list`](https://cli.github.com/manual/gh_issue_list)" or "[`gh pr list`](https://cli.github.com/manual/gh_pr_list)" in the {% data variables.product.prodname_cli %} documentation. {% endtip %} diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/finding-information-in-a-repository.md b/translations/ja-JP/content/github/managing-your-work-on-github/finding-information-in-a-repository.md index 7403ba532b10..77cd3148c23e 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/finding-information-in-a-repository.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/finding-information-in-a-repository.md @@ -1,6 +1,6 @@ --- title: リポジトリ内の情報を検索する -intro: GitHub のリポジトリについての詳細な情報を検索するために、リポジトリに関連する Issue とプルリクエストをフィルタリング、ソート、および検索できます。 +intro: 'GitHub のリポジトリについての詳細な情報を検索するために、リポジトリに関連する Issue とプルリクエストをフィルタリング、ソート、および検索できます。' mapTopic: true redirect_from: - /articles/finding-information-in-a-repository diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md b/translations/ja-JP/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md index b41728b0301c..532599ac64f4 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md @@ -1,6 +1,6 @@ --- title: プルリクエストをIssueにリンクする -intro: 'プルリクエストをIssueにリンクして、{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}修正が進行中であることを示し、{% endif %}プルリクエストがマージされるときIssueを自動的にクローズすることができます。' +intro: 'You can link a pull request to an issue to{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} show that a fix is in progress and to{% endif %} automatically close the issue when the pull request is merged.' redirect_from: - /articles/closing-issues-via-commit-message/ - /articles/closing-issues-via-commit-messages/ @@ -11,15 +11,19 @@ versions: enterprise-server: '*' --- +{% note %} + +**Note:** The special keywords in a pull request description are interpreted when the pull request targets the repository's *default* branch. However, if the PR's base is *any other branch*, then these keywords are ignored, no links are created and merging the PR has no effect on the issues. **If you want to link a pull request to an issue using a keyword, the PR must be on the default branch.** + +{% endnote %} + ### リンクされたIssueとプルリクエストについて -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}手動で、または{% endif %}プルリクエストの説明でサポートされているキーワードを使用して、Issueをプルリクエストにリンクすることができます。 +You can link an issue to a pull request {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}manually or {% endif %}using a supported keyword in the pull request description. -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -プルリクエストが対処するIssueにそのプルリクエストにリンクすると、コラボレータは、誰かがそのIssueに取り組んでいることを確認できます。 -{% if currentVersion ver_lt "enterprise-server@2.21" %}プルリクエストとIssueが別のリポジトリにある場合は、プルリクエストをマージするユーザーにIssueをクローズする権限もあれば、そのマージが実行された後で{% data variables.product.product_name %}にリンクが表示されます。{% endif %}{% endif %} +プルリクエストが対処するIssueにそのプルリクエストにリンクすると、コラボレータは、誰かがそのIssueに取り組んでいることを確認できます。 {% if currentVersion ver_lt "enterprise-server@2.21" %}If the pull request and the issue are in different repositories, {% data variables.product.product_name %} will display the link after the pull request is merged, if the person who merges the pull request also has permission to close the issue.{% endif %} -リンクされたプルリクエストをリポジトリのデフォルトブランチにマージすると、それにリンクされているIssueは自動的にクローズされます。 デフォルトブランチの詳細については、「[デフォルトブランチを設定する](/github/administering-a-repository/setting-the-default-branch)」を参照してください。 +リンクされたプルリクエストをリポジトリのデフォルトブランチにマージすると、それにリンクされているIssueは自動的にクローズされます。 For more information about the default branch, see "[Changing the default branch](/github/administering-a-repository/changing-the-default-branch)." {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} ### 手動でプルリクエストをIssueにリンクする @@ -37,7 +41,7 @@ versions: ### キーワードを使用してプルリクエストをIssueにリンクする -プルリクエストの説明でサポートされているキーワードを使用して、プルリクエストにIssueにリンクすることができます。 +You can link a pull request to an issue by using a supported keyword in the pull request's description or in a commit message (please note that the pull request must be on the default branch). * close * closes @@ -57,9 +61,9 @@ versions: | Issueが別のリポジトリにある | *KEYWORD* *OWNER*/*REPOSITORY*#*ISSUE-NUMBER* | `Fixes octo-org/octo-repo#100` | | 複数の Issue | Issueごとに完全な構文を使用 | `Resolves #10, resolves #123, resolves octo-org/octo-repo#100` | -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}手動でリンクを解除できるのは、手動でリンクされたプルリクエストだけです。 キーワードを使用してリンクしたIssueのリンクを解除するには、プルリクエストの説明を編集してそのキーワードを削除する必要があります。{% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}Only manually linked pull requests can be manually unlinked. キーワードを使用してリンクしたIssueのリンクを解除するには、プルリクエストの説明を編集してそのキーワードを削除する必要があります。{% endif %} -クローズするキーワードは、コミットメッセージでも使用できます。 デフォルトブランチにコミットをマージするとIssueはクローズされます{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}が、そのコミットを含むプルリクエストは、リンクされたプルリクエストとしてリストされません{% endif %}。 +クローズするキーワードは、コミットメッセージでも使用できます。 The issue will be closed when you merge the commit into the default branch, but the pull request that contains the commit will not be listed as a linked pull request. ### 参考リンク diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/linking-a-repository-to-a-project-board.md b/translations/ja-JP/content/github/managing-your-work-on-github/linking-a-repository-to-a-project-board.md index ab8849aee535..b1c9945efbd2 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/linking-a-repository-to-a-project-board.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/linking-a-repository-to-a-project-board.md @@ -18,7 +18,7 @@ versions: 4. 左サイドバーで [**Linked repositories**] をクリックします。 ![左サイドバーの [Linked repositories] メニュー オプション](/assets/images/help/projects/project-board-linked-repositories-setting.png) 5. [**Link a repository**] をクリックします。 ![[Linked repositories] タブにある [Link a repository] ボタン](/assets/images/help/projects/link-repository-button.png) 6. リンクしたいリポジトリを検索します。 ![[Link a repository] ウィンドウの [Search] フィールド](/assets/images/help/projects/search-to-link-repository.png) -7. Click **Link**. リンクを解除するには、[**Unlink**] をクリックします。 ![[Link] ボタン](/assets/images/help/projects/link-button.png) +7. [**Link**] をクリックします。 リンクを解除するには、[**Unlink**] をクリックします。 ![[Link] ボタン](/assets/images/help/projects/link-button.png) ### 参考リンク diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/opening-an-issue-from-code.md b/translations/ja-JP/content/github/managing-your-work-on-github/opening-an-issue-from-code.md index 5de57d6751d4..4a4867f85433 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/opening-an-issue-from-code.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/opening-an-issue-from-code.md @@ -19,7 +19,7 @@ versions: - ファイルのコードに関する Issue を開くには、そのファイルに移動します。 - プルリクエストのコードに関する Issue を開くには、そのプルリクエストに移動し、{% octicon "diff" aria-label="The file diff icon" %}[**Files changed**] をクリックします。 次に、コメントに含めたいコードを持っているファイルを探し、[**View**] をクリックします。 {% data reusables.repositories.choose-line-or-range %} -4. To the left of the code range, click +4. コード範囲の左で、 {% octicon "kebab-horizontal" aria-label="The horizontal kebab octicon" %}. ドロップダウンメニューで、[**Reference in new issue**] をクリックします。 ![選択した行から新しいIssueを開くオプションのある三点メニュー](/assets/images/help/repository/open-new-issue-specific-line.png) {% data reusables.repositories.type-issue-title-and-description %} diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/sharing-filters.md b/translations/ja-JP/content/github/managing-your-work-on-github/sharing-filters.md index 971651c99d2d..67b5e159799b 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/sharing-filters.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/sharing-filters.md @@ -1,6 +1,6 @@ --- title: フィルターを共有する -intro: 一定の Issue およびプルリクエストをフィルタリングする場合、ブラウザの URL は、次の表示にマッチするように自動的に更新されます。 +intro: '一定の Issue およびプルリクエストをフィルタリングする場合、ブラウザの URL は、次の表示にマッチするように自動的に更新されます。' redirect_from: - /articles/sharing-filters versions: diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/tracking-progress-on-your-project-board.md b/translations/ja-JP/content/github/managing-your-work-on-github/tracking-progress-on-your-project-board.md index 1e18e6c3a575..f79ccb901d1c 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/tracking-progress-on-your-project-board.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/tracking-progress-on-your-project-board.md @@ -1,6 +1,6 @@ --- title: プロジェクトボードで進捗を追跡する -intro: デフォルトでは、プロジェクトボードの自動化を有効化すると、プロジェクト全体の進捗がプログレスバーで追跡されます。 +intro: 'デフォルトでは、プロジェクトボードの自動化を有効化すると、プロジェクト全体の進捗がプログレスバーで追跡されます。' redirect_from: - /articles/tracking-progress-on-your-project-board versions: diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md b/translations/ja-JP/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md index dea883da7e23..53b08d733ad5 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md @@ -1,18 +1,18 @@ --- title: 他のリポジトリへ Issue を移譲する -intro: より適しているリポジトリに Issue を移動するため、オープン Issue を他のリポジトリに移譲できます。 +intro: 'より適しているリポジトリに Issue を移動するため、オープン Issue を他のリポジトリに移譲できます。' redirect_from: - /articles/transferring-an-issue-to-another-repository versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- 他のリポジトリにオープン Issue を移譲するには、Issue のあるリポジトリおよびその Issue の移譲先のリポジトリの書き込み権限が必要です。 詳細は「[Organization のためのリポジトリの権限レベル](/articles/repository-permission-levels-for-an-organization)」を参照してください。 同じユーザまたは Organization アカウントが所有するリポジトリ間においてのみ、Issue を移譲できます。 プライベートリポジトリからパブリックリポジトリへは、Issue を移譲できません。 -Issueを委譲する場合、コメントとアサインされた人は保持されます。 Issueのラベル{% if currentVersion ver_lt "enterprise-server@2.19" %}、プロジェクト、{% endif %}マイルストーンは保持されません。{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}このIssueは、ユーザー所有または組織全体のプロジェクトボードにとどまり、リポジトリのプロジェクトボードから削除されます。 詳細は「[プロジェクトボードについて](/articles/about-project-boards)」を参照してください。{% endif %} +Issueを委譲する場合、コメントとアサインされた人は保持されます。 The issue's labels and milestones are not retained. This issue will stay on any user-owned or organization-wide project boards and be removed from any repository project boards. 詳細は「[プロジェクトボードについて](/articles/about-project-boards)」を参照してください。 Issue でメンションされた人や Team は、Issue が新しいリポジトリに移譲されたことを知らせる通知を受け取ります。 当初の URL は、新しい Issue の URL にリダイレクトします。 新しいリポジトリの読み取り権限がない人には、アクセスできない新しいリポジトリに Issue が移譲されたことを知らせるバナーが表示されます。 diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/using-search-to-filter-issues-and-pull-requests.md b/translations/ja-JP/content/github/managing-your-work-on-github/using-search-to-filter-issues-and-pull-requests.md index 6b9367c8484d..02a03e315e44 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/using-search-to-filter-issues-and-pull-requests.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/using-search-to-filter-issues-and-pull-requests.md @@ -31,7 +31,7 @@ Issueについては、以下も検索に利用できます。 - クローズしているリファレンス`linked:pr`によってプルリクエストにリンクされているIssueのフィルタリング {% endif %} -For pull requests, you can also use search to: +プルリクエストについては、検索を利用して以下の操作もできます。 - [ドラフト](/articles/about-pull-requests#draft-pull-requests)プルリクエストのフィルタリング: `is:draft` - まだ[レビュー](/articles/about-pull-request-reviews)されていないプルリクエストのフィルタリング: `state:open type:pr review:none` - マージされる前に[レビューを必要とする](/articles/about-required-reviews-for-pull-requests)プルリクエストのフィルタリング: `state:open type:pr review:required` @@ -39,7 +39,7 @@ For pull requests, you can also use search to: - レビュー担当者が変更を要求したプルリクエストのフィルタリング: `state:open type:pr review:changes_requested` - [レビュー担当者](/articles/about-pull-request-reviews/)によるプルリクエストのフィルタリング: `state:open type:pr reviewed-by:octocat` - [レビューを要求された](/articles/requesting-a-pull-request-review)特定のユーザーによるプルリクエストのフィルタリング: `state:open type:pr review-requested:octocat` -- レビューを要求されたチームによるプルリクエストのフィルタリング: `state:open type:pr team-review-requested:github/atom`{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +- Filter pull requests by the team requested for review: `state:open type:pr team-review-requested:github/atom`{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} - プルリクエストでクローズできるIssueにリンクされているプルリクエストのフィルタリング: `linked:issue`{% endif %} ### 参考リンク diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/viewing-all-of-your-issues-and-pull-requests.md b/translations/ja-JP/content/github/managing-your-work-on-github/viewing-all-of-your-issues-and-pull-requests.md index 8aa7e1bd8d9e..a3d049371094 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/viewing-all-of-your-issues-and-pull-requests.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/viewing-all-of-your-issues-and-pull-requests.md @@ -1,6 +1,6 @@ --- title: すべての Issue およびプルリクエストを見る -intro: Issue およびプルリクエストのダッシュボードには、未解決の Issue と作成したプルリクエストが一覧表示されます。 これらを使用して、古くなったアイテムを更新したり、閉じたり、サブスクライブしていないものも含め、すべてのリポジトリでメンションした場所を追跡したりできます。 +intro: 'Issue およびプルリクエストのダッシュボードには、未解決の Issue と作成したプルリクエストが一覧表示されます。 これらを使用して、古くなったアイテムを更新したり、閉じたり、サブスクライブしていないものも含め、すべてのリポジトリでメンションした場所を追跡したりできます。' redirect_from: - /articles/viewing-all-of-your-issues-and-pull-requests versions: @@ -15,4 +15,4 @@ Issue およびプルリクエストダッシュボードは、すべてのペ ### 参考リンク -- {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}”[サブスクリプションを表示する](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions#reviewing-repositories-that-youre-watching){% else %}”[Watch しているリポジトリのリスト](/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching){% endif %}" +- {% 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#reviewing-repositories-that-youre-watching){% else %}”[Listing the repositories you're watching](/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching){% endif %}" diff --git a/translations/ja-JP/content/github/managing-your-work-on-github/viewing-your-milestones-progress.md b/translations/ja-JP/content/github/managing-your-work-on-github/viewing-your-milestones-progress.md index 90d4e5333068..74f6ba63e6c2 100644 --- a/translations/ja-JP/content/github/managing-your-work-on-github/viewing-your-milestones-progress.md +++ b/translations/ja-JP/content/github/managing-your-work-on-github/viewing-your-milestones-progress.md @@ -1,6 +1,6 @@ --- title: マイルストーンの進捗状況を表示する -intro: マイルストーンを追跡するためには、未解決の Issue とプルリクエストがいくつ残っているかをよく理解しておく必要があります。 +intro: 'マイルストーンを追跡するためには、未解決の Issue とプルリクエストがいくつ残っているかをよく理解しておく必要があります。' redirect_from: - /articles/viewing-your-milestone-s-progress - /articles/viewing-your-milestones-progress diff --git a/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/about-email-notifications.md b/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/about-email-notifications.md index 70ef02202fae..e1807f3214d9 100644 --- a/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/about-email-notifications.md +++ b/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/about-email-notifications.md @@ -1,6 +1,6 @@ --- title: メール通知について -intro: メール通知を有効化すると、参加および Watch 対象の通知をメールクライアントで受け取るようになり、メールヘッダ情報でそれらをフィルタリングできます。 +intro: 'メール通知を有効化すると、参加および Watch 対象の通知をメールクライアントで受け取るようになり、メールヘッダ情報でそれらをフィルタリングできます。' versions: enterprise-server: <2.21 --- @@ -19,17 +19,17 @@ versions: {% data variables.product.product_name %} からのメール通知には、以下のヘッダ情報が含まれています: -| ヘッダ | 情報 | -| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `From` アドレス | このアドレスは常に、サイト管理者が設定した no-reply メールアドレスになります。 | -| `To` フィールド | このフィールドは、直接スレッドに接続します。 メールに返信すると、会話に新しいコメントを追加することになります。 | -| `Cc` アドレス | あなたが会話をサブスクライブしていれば、{% data variables.product.product_name %}はあなたに `Cc` します。 2番目の`Cc`メールアドレスは、通知の理由にマッチします。 これらの通知理由に対するサフィックスは{% data variables.notifications.cc_address %}です。 通知の理由には以下のようなものがあります。
    • `assign`: 受信者はIssueあるいはプルリクエストに割り当てられました。
    • `author`: 受信者はIssueあるいはプルリクエストの作者です。
    • `comment`: 受信者はIssueあるいはプルリクエストにコメントしました。
    • `manual`: 手作業でサブスクライブした Issue あるいはプルリクエストが更新されました。
    • `mention`: 受信者は Issue あるいはプルリクエストにメンションされました。
    • `push`: 受信者がサブスクライブしているプルリクエストに誰かがコミットしました。
    • `review_requested`: 受信者あるいは受信者がメンバーになっている Team にプルリクエストのレビューがリクエストされました。
    • `security_alert`: {% data variables.product.prodname_dotcom %} は、受信者がセキュリティのアラートを受け取るリポジトリに脆弱性を検出しました。
    • `state_change`: 受信者がサブスクライブしている Issue あるいはプルリクエストがクローズもしくはオープンされました。
    • `subscribed`: 受信者が Watch しているリポジトリに更新がありました。
    • `team_mention`: 受信者が属している Team が Issue あるいはプルリクエストでメンションされました。
    • `your_activity`: 受信者が Issue あるいはプルリクエストをオープン、コメントあるいはクローズしました。
    | -| `mailing list` フィールド | このフィールドはリポジトリの名前とそのオーナーを特定します。 このアドレスのフォーマットは常に`..{% data variables.command_line.backticks %}`となります。 |{% if currentVersion ver_gt "enterprise-server@2.19" % %} -| `X-GitHub-Severity`フィールド | {% data reusables.repositories.security-alerts-x-github-severity %} 考えられる重大度レベルは次のとおりです。
    • `low`
    • `moderate`
    • `high`
    • `critical`
    詳しい情報については、「[脆弱性のある依存関係に対するアラートについて](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)」を参照してください。 |{% endif %} +| ヘッダ | 情報 | +| --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `From` アドレス | このアドレスは常に、サイト管理者が設定した no-reply メールアドレスになります。 | +| `To` フィールド | このフィールドは、直接スレッドに接続します。 メールに返信すると、会話に新しいコメントを追加することになります。 | +| `Cc` アドレス | あなたが会話をサブスクライブしていれば、{% data variables.product.product_name %}はあなたに `Cc` します。 2番目の`Cc`メールアドレスは、通知の理由にマッチします。 これらの通知理由に対するサフィックスは{% data variables.notifications.cc_address %}です。 通知の理由には以下のようなものがあります。
    • `assign`: 受信者はIssueあるいはプルリクエストに割り当てられました。
    • `author`: 受信者はIssueあるいはプルリクエストの作者です。
    • `comment`: 受信者はIssueあるいはプルリクエストにコメントしました。
    • `manual`: 手作業でサブスクライブした Issue あるいはプルリクエストが更新されました。
    • `mention`: 受信者は Issue あるいはプルリクエストにメンションされました。
    • `push`: 受信者がサブスクライブしているプルリクエストに誰かがコミットしました。
    • `review_requested`: 受信者あるいは受信者がメンバーになっている Team にプルリクエストのレビューがリクエストされました。
    • `security_alert`: {% data variables.product.prodname_dotcom %} は、受信者がセキュリティのアラートを受け取るリポジトリに脆弱性を検出しました。
    • `state_change`: 受信者がサブスクライブしている Issue あるいはプルリクエストがクローズもしくはオープンされました。
    • `subscribed`: 受信者が Watch しているリポジトリに更新がありました。
    • `team_mention`: 受信者が属している Team が Issue あるいはプルリクエストでメンションされました。
    • `your_activity`: 受信者が Issue あるいはプルリクエストをオープン、コメントあるいはクローズしました。
    | +| `mailing list` フィールド | このフィールドはリポジトリの名前とそのオーナーを特定します。 このアドレスのフォーマットは常に`..{% data variables.command_line.backticks %}`となります。 |{% if currentVersion ver_gt "enterprise-server@2.19" % %} +| `X-GitHub-Severity`フィールド | {% data reusables.repositories.security-alerts-x-github-severity %} 考えられる重大度レベルは次のとおりです。
    • `low`
    • `moderate`
    • `high`
    • `critical`
    詳しい情報については、「[脆弱性のある依存関係に対するアラートについて](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)」を参照してください。 |{% endif %} ### 参考リンク -- [Watch しているリポジトリのリスト](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching) +- 「[Watch しているリポジトリのリスト](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching)」 - [リポジトリの Watch と Watch 解除](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories) -- [通知のサブスクライブとサブスクライブ解除](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications){% if currentVersion ver_gt "enterprise-server@2.17" %} -- [Gistの作成](/articles/creating-gists){% endif %} +- 「[通知のサブスクライブとサブスクライブ解除](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)」 +- [Gistの作成](/articles/creating-gists) diff --git a/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/about-notifications.md b/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/about-notifications.md index f2a5f72cb56e..abff2b0dd0f2 100644 --- a/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/about-notifications.md +++ b/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/about-notifications.md @@ -9,9 +9,9 @@ versions: 受信する通知は、*参加*通知か*Watch対象の*通知です。 どちらの種類の通知も、Webの通知あるいはメール通知として受信できます。 詳しい情報については、以下を参照してください。 -- [Web 通知について](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/about-web-notifications) +- 「[Web 通知について](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/about-web-notifications)」 - 「[メール通知について](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/about-email-notifications)」 -- 「[通知の配信方法を選択する](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications)」 +- [通知の配信方法を選択する](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications) {% data reusables.notifications.outbound_email_tip %} @@ -33,9 +33,8 @@ versions: #### Watch 対象の通知 -{% data variables.product.product_name %} は、あなたが Watch しているリポジトリあるいは Team のディスカッションに更新があった場合、*Watch* 通知を送信します。 {% if currentVersion ver_gt "enterprise-server@2.17" %} {% data reusables.notifications.auto-watch %}詳細は、「[リポジトリの Watch と Watch 解除](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories)」を参照してください。 - -{% endif %}通知は以下の場合に送られます: +{% data variables.product.product_name %} は、あなたが Watch しているリポジトリあるいは Team のディスカッションに更新があった場合、*Watch* 通知を送信します。 {% data reusables.notifications.auto-watch %}For more information, see "[Watching and unwatching repositories](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories)." +通知は以下の場合に送られます: - Issue がオープンされた場合。 - コミットがオープンな Issue に追加された場合。 - プルリクエストがオープンされた場合。 @@ -50,7 +49,7 @@ versions: ### 参考リンク -- [Watch しているリポジトリのリスト](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching) +- 「[Watch しているリポジトリのリスト](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching)」 - [リポジトリの Watch と Watch 解除](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories) - 「[Team ディスカッションの Watch と Watch 解除](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions)」 - 「[通知のサブスクライブとサブスクライブ解除](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)」 diff --git a/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/about-web-notifications.md b/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/about-web-notifications.md index fd1b39223bea..667e7a35be91 100644 --- a/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/about-web-notifications.md +++ b/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/about-web-notifications.md @@ -7,7 +7,7 @@ versions: *参加*と *Watch* 対象との通知の違いについては、「[通知について](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/about-notifications)」を参照してください。 -アカウントで Web 通知が有効化したなら、通知ページ上のアイテムをクリックすると通知が参照している会話へリダイレクトされます。 アカウントで Web 通知が有効化したなら、通知ページ上のアイテムをクリックすると通知が参照している会話へリダイレクトされます。 Web 通知の有効化に関する詳しい情報については「[通知の配信方法を選択する](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications)」を参照してください。 +アカウントで Web 通知が有効化したなら、通知ページ上のアイテムをクリックすると通知が参照している会話へリダイレクトされます。 For more information on enabling web notifications, see "[Choosing the delivery method for your notifications](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications)." Web 通知の有効化に関する詳しい情報については「[通知の配信方法を選択する](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications)」を参照してください。 {% data reusables.notifications.shared_state %} @@ -19,6 +19,6 @@ versions: ### 参考リンク -- [Watch しているリポジトリのリスト](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching) +- 「[Watch しているリポジトリのリスト](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching)」 - [リポジトリの Watch と Watch 解除](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories) - 「[通知のサブスクライブとサブスクライブ解除](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)」 diff --git a/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/accessing-your-notifications.md b/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/accessing-your-notifications.md index 9b2b15e116ed..c18b4473a9f0 100644 --- a/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/accessing-your-notifications.md +++ b/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/accessing-your-notifications.md @@ -20,4 +20,4 @@ versions: ### 参考リンク - 「[通知について](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/about-notifications)」 -- [Watch しているリポジトリのリスト](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching) +- 「[Watch しているリポジトリのリスト](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching)」 diff --git a/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications.md b/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications.md index 54ebc04ee13a..9918f03817b4 100644 --- a/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications.md +++ b/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications.md @@ -41,6 +41,6 @@ versions: - 「[通知について](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/about-notifications)」 - 「[メール通知について](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/about-email-notifications)」 -- [Web 通知について](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/about-web-notifications) +- 「[Web 通知について](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/about-web-notifications)」 - [リポジトリの Watch と Watch 解除](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories) - [メールプリファレンスを管理する](/articles/managing-email-preferences) diff --git a/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/listing-the-issues-and-pull-requests-youre-subscribed-to.md b/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/listing-the-issues-and-pull-requests-youre-subscribed-to.md index 0cd34ca79e9a..72e3169af14b 100644 --- a/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/listing-the-issues-and-pull-requests-youre-subscribed-to.md +++ b/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/listing-the-issues-and-pull-requests-youre-subscribed-to.md @@ -1,6 +1,6 @@ --- title: サブスクライブしている Issue とプルリクエストをリストする -intro: サブスクライブしている Issue とプルリクエストをすべてリストすると、関心があって最近通知を受け取っていなかった会話への移動が簡単になります。 +intro: 'サブスクライブしている Issue とプルリクエストをすべてリストすると、関心があって最近通知を受け取っていなかった会話への移動が簡単になります。' versions: enterprise-server: <2.21 --- @@ -9,8 +9,8 @@ versions: ### プランのリストを表示する -1. 任意のページの右上で {% octicon "bell" aria-label="The notifications bell" %} をクリックします。 Web 通知を無効にしており、ベルのアイコンが表示されていない場合、 にアクセスできます。 詳細は「[通知の配信方法を選択する](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications)」を参照してください。 ![未読メッセージを示す通知](/assets/images/help/notifications/notifications_general_existence_indicator.png) -2. Click **Subscriptions** ![[Subscriptions] タブ](/assets/images/help/notifications/subscriptions-tab.png) +1. 任意のページの右上で {% octicon "bell" aria-label="The notifications bell" %} をクリックします。 Web 通知を無効にしており、ベルのアイコンが表示されていない場合、 にアクセスできます。 詳しい情報については、「[通知の配信方法を選択する](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications)」を参照してください。 ![未読メッセージを示す通知](/assets/images/help/notifications/notifications_general_existence_indicator.png) +2. [**Subscriptions**] をクリックします。 ![[Subscriptions] タブ](/assets/images/help/notifications/subscriptions-tab.png) ### Issue およびプルリクエストのサブスクライブ解除 diff --git a/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/managing-your-notifications.md b/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/managing-your-notifications.md index 6bb9066150f6..059675334908 100644 --- a/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/managing-your-notifications.md +++ b/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/managing-your-notifications.md @@ -1,6 +1,6 @@ --- title: 通知を管理する -intro: 関心のある通知を受け取りやすくするために、通知を既読としてマークできるほか、サブスクライブする、サブスクライブの通知を解除する、そしてリポジトリを Watch および Watch 解除することができます。 +intro: '関心のある通知を受け取りやすくするために、通知を既読としてマークできるほか、サブスクライブする、サブスクライブの通知を解除する、そしてリポジトリを Watch および Watch 解除することができます。' mapTopic: true versions: enterprise-server: <2.21 diff --git a/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/marking-notifications-as-read.md b/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/marking-notifications-as-read.md index 11020786a558..61da0e698f69 100644 --- a/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/marking-notifications-as-read.md +++ b/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/marking-notifications-as-read.md @@ -1,6 +1,6 @@ --- title: 通知を既読としてマークする -intro: Web 通知は、レビューせずに既読としてマークすることができます。 会話を更新すると、新しい通知が届きます。 既読の会話を未読とマークすることもできるので、後からでも簡単に見つけることができます。 +intro: 'Web 通知は、レビューせずに既読としてマークすることができます。 会話を更新すると、新しい通知が届きます。 既読の会話を未読とマークすることもできるので、後からでも簡単に見つけることができます。' versions: enterprise-server: <2.21 --- @@ -34,4 +34,4 @@ Web 通知へのアクセスについては、「[通知にアクセスする](/ ### 参考リンク - 「[通知について](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/about-notifications)」 -- [Web 通知について](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/about-web-notifications) +- 「[Web 通知について](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/about-web-notifications)」 diff --git a/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/saving-notifications-for-later.md b/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/saving-notifications-for-later.md index c67b91ed17d4..a25180a80f5c 100644 --- a/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/saving-notifications-for-later.md +++ b/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/saving-notifications-for-later.md @@ -11,7 +11,7 @@ versions: {% data reusables.notifications.access_notifications %} 1. 通知のリストで、保存したい通知を見つけます。 -1. On the right side of the notification, click +1. 通知の右側で、をクリックします。 {% octicon "bookmark" aria-label="The bookmark button" %}. ![通知を保存するボタン](/assets/images/help/notifications/save_notification.png) {% data reusables.notifications.saved_for_late_sidebar %} diff --git a/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications.md b/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications.md index 459c486f9a0b..679cbf4bd0a6 100644 --- a/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications.md +++ b/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications.md @@ -1,27 +1,18 @@ --- title: 通知のサブスクライブとサブスクライブ解除 -intro: リポジトリを Watch していない場合や、Conversation が行われている Team のメンバーでない場合でも、Issue やプルリクエスト、Team ディスカッションの個別の Conversation にサブスクライブできます。 Conversation に関心がなくなった場合は、サブスクライブ解除や受信する通知のカスタマイズができます。 +intro: 'リポジトリを Watch していない場合や、Conversation が行われている Team のメンバーでない場合でも、Issue やプルリクエスト、Team ディスカッションの個別の Conversation にサブスクライブできます。 Conversation に関心がなくなった場合は、サブスクライブ解除や受信する通知のカスタマイズができます。' versions: enterprise-server: <2.21 --- ### Issue またはプルリクエストの通知設定を管理する -{% if currentVersion ver_lt "enterprise-server@2.18" %}Issue またはプルリクエストの Conversation にサブスクライブしている場合、Conversation に参加していなくても、Conversation が更新されるたびに通知を受信します。 - -Issue またはプルリクエストの Conversation をサブスクライブ解除した場合、その Conversation についての通知を受けることはなくなります。 あなたやメンバーになっている Team が、Conversation で @メンションされた場合は、通知の受信が再開されます。 @メンションの詳しい情報については、「[基本的な書き方とフォーマットの構文](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams)」を参照してください。{% endif %} - {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issue-pr %} 3. サブスクライブの設定を行う Issue またはプルリクエストを選択します。 -{% if currentVersion ver_gt "enterprise-server@2.17" %} 4. 右サイドバーで [**Subscribe**] または [**Unsubscribe**] をクリックします。 ![Conversation サブスクライブボタン](/assets/images/help/notifications/subscribe_button_with_gear.png) 5. 通知をカスタマイズするには {% octicon "gear" aria-label="The gear icon" %} をクリックします。 ![Conversation サブスクライブの隣にある歯車ボタン](/assets/images/help/notifications/subscribe_button_with_gear_chosen.png) -6. この Conversation で受信したいタイプの通知を選択して、[**Save**] をクリックします。 ![Conversationサブスクライブのオプションリスト](/assets/images/help/notifications/subscribe_options.png) -{% else %} -4. Conversation のサブスクライブまたはサブスクライブ解除を行うには、右サイドバーで [**Subscribe**] または [**Unsubscribe**] をクリックします。 ![Conversation サブスクライブボタン](/assets/images/help/notifications/subscribe_button.png) -{% endif %} -You can see a list of all the issues and pull requests you're subscribed to. 詳細は「[サブスクライブしている Issue とプルリクエストをリストする](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-issues-and-pull-requests-youre-subscribed-to)」を参照してください。 +6. この Conversation で受信したいタイプの通知を選択して、[**Save**] をクリックします。 ![Conversation Subscribe options list](/assets/images/help/notifications/subscribe_options.png) You can see a list of all the issues and pull requests you're subscribed to. 詳細は「[サブスクライブしている Issue とプルリクエストをリストする](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-issues-and-pull-requests-youre-subscribed-to)」を参照してください。 ### Team ディスカッションをサブスクライブする @@ -49,4 +40,4 @@ You can see a list of all the issues and pull requests you're subscribed to. 詳 - 「[{% data variables.product.product_name %} での会話について](/articles/about-conversations-on-github)」 - [リポジトリの Watch と Watch 解除](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories) -- [Watch しているリポジトリのリスト](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching) +- 「[Watch しているリポジトリのリスト](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching)」 diff --git a/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories.md b/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories.md index ef27dedb6781..738aef725cde 100644 --- a/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories.md +++ b/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories.md @@ -5,16 +5,14 @@ versions: enterprise-server: <2.21 --- -{% if currentVersion ver_gt "enterprise-server@2.17" %} {% data reusables.notifications.auto-watch %}詳細は「[通知について](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/about-notifications)」を参照してください。 -{% endif %} リポジトリ内のリリースを Watch および Watch 解除することもできます。 詳細は「[リポジトリのリリースの Watch と Watch 解除](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-releases-for-a-repository)」を参照してください。 ### プッシュアクセス権を持っているすべてのリポジトリを Watch する {% data reusables.notifications.access_watching %} -2. Click **Watching**. ![Watch しているリポジトリのリスト](/assets/images/help/notifications/notifications-watching-tab.png) +2. [**Watching**] をクリックします。 ![Watch しているリポジトリのリスト](/assets/images/help/notifications/notifications-watching-tab.png) 3. ページの右側にある [**Automatically watch**] を選択します。 ![Watch するリポジトリを自動的に設定するためのチェックボックス](/assets/images/help/notifications/ent-automatically-watch-repos.png) ### 単一リポジトリを Watch する @@ -25,7 +23,7 @@ versions: ### プッシュアクセス権を持っているすべてのリポジトリを Watch 解除する {% data reusables.notifications.access_watching %} -2. Click **Watching**. ![Watch しているリポジトリのリスト](/assets/images/help/notifications/notifications-watching-tab.png) +2. [**Watching**] をクリックします。 ![Watch しているリポジトリのリスト](/assets/images/help/notifications/notifications-watching-tab.png) 3. ページの右側にある [**Automatically watch**] の選択を解除します。 ![Watch するリポジトリを自動的に設定するためのチェックボックス](/assets/images/help/notifications/ent-automatically-watch-repos.png) ### 単一リポジトリの Watch を解除する @@ -35,11 +33,11 @@ versions: {% note %} -**メモ:** リポジトリを無視することもできます。 リポジトリを無視した場合、通知は届きません。 あなたが @メンションされても通知されなくなるため、リポジトリを無視することはおすすめしません。 {% if currentVersion == "free-pro-team@latest" %}あなたが嫌がらせにあっていて、リポジトリを無視したい場合は、私たちがサポートしますので、[サポートに連絡してください](/contact)。 {% data reusables.policies.abuse %}{% endif %} +**メモ:** リポジトリを無視することもできます。 リポジトリを無視した場合、通知は届きません。 あなたが @メンションされても通知されなくなるため、リポジトリを無視することはおすすめしません。 {% if currentVersion == "free-pro-team@latest" %}If you experiencing abuse and want to ignore a repository, please [contact support](/contact) so we can help. {% data reusables.policies.abuse %}{% endif %} {% endnote %} ### 参考リンク - 「[通知のサブスクライブとサブスクライブ解除](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)」 -- [Watch しているリポジトリのリスト](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching) +- 「[Watch しているリポジトリのリスト](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching)」 diff --git a/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md b/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md index 86760851887a..f4887f1170ca 100644 --- a/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md +++ b/translations/ja-JP/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md @@ -21,14 +21,16 @@ versions: {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.notifications %} -{% data reusables.user_settings.automatic_watching_box %}[**Automatically watch teams**] を選択します。 ![Team を自動的に Watch するためのチェックボックス](/assets/images/help/notifications/automatic-team-discussions-watching.png) +{% data reusables.user_settings.automatic_watching_box %}[**Automatically watch teams**] を選択します。 +![Team を自動的に Watch するためのチェックボックス](/assets/images/help/notifications/automatic-team-discussions-watching.png) ### 単一Team ディスカッションを Watch する {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.specific_team %} -{% data reusables.organizations.watch-team-options %}[**Watch**] をクリックして、通知オプションを開きます。 次に、[**Watching**] をクリックします。 ![特定の Team のドロップダウンメニューの Watch オプション](/assets/images/help/notifications/specific-team-watch-options.png) +{% data reusables.organizations.watch-team-options %}[**Watch**] をクリックして、通知オプションを開きます。 次に、[**Watching**] をクリックします。 +![特定の Team のドロップダウンメニューの Watch オプション](/assets/images/help/notifications/specific-team-watch-options.png) ### 参加するすべての新しい Team の Team ディスカッションを Watch 解除する @@ -36,14 +38,16 @@ Team に参加するときに Team ディスカッション通知を自動的に {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.notifications %} -{% data reusables.user_settings.automatic_watching_box %}[**Automatically watch teams**] を選択解除します。 ![デフォルトで選択されているチームの自動 Watch 設定](/assets/images/help/notifications/automatic-team-discussions-watching.png) +{% data reusables.user_settings.automatic_watching_box %}[**Automatically watch teams**] を選択解除します。 +![デフォルトで選択されているチームの自動 Watch 設定](/assets/images/help/notifications/automatic-team-discussions-watching.png) ### 単一 Team ディスカッションを Watch 解除する {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.specific_team %} -{% data reusables.organizations.watch-team-options %}[**Unwatch**] をクリックして、通知オプションを開きます。 次に、[**Not watching**] をクリックします。 ![特定の Team のドロップダウンメニューの Watch オプション](/assets/images/help/notifications/specific-team-unwatch.png) +{% data reusables.organizations.watch-team-options %}[**Unwatch**] をクリックして、通知オプションを開きます。 次に、[**Not watching**] をクリックします。 +![特定の Team のドロップダウンメニューの Watch オプション](/assets/images/help/notifications/specific-team-unwatch.png) {% note %} diff --git a/translations/ja-JP/content/github/searching-for-information-on-github/about-searching-on-github.md b/translations/ja-JP/content/github/searching-for-information-on-github/about-searching-on-github.md index ae7358ad2907..6ed39dcf9ad7 100644 --- a/translations/ja-JP/content/github/searching-for-information-on-github/about-searching-on-github.md +++ b/translations/ja-JP/content/github/searching-for-information-on-github/about-searching-on-github.md @@ -1,6 +1,6 @@ --- title: GitHub での検索について -intro: 'GitHub の強力な検索ツールを使って、{% data variables.product.product_name %}上の多くのリポジトリ、ユーザ、コードの行から探しているものを見つけてください。' +intro: 'Our integrated search covers the many repositories, users, and lines of code on {% data variables.product.product_name %}.' redirect_from: - /articles/using-the-command-bar/ - /articles/github-search-basics/ @@ -24,6 +24,8 @@ versions: - {% data reusables.search.required_login %} - {% data variables.product.prodname_pages %}サイトは、{% data variables.product.product_name %}上では検索できません。 ただし、コンテンツのソースがリポジトリのデフォルトブランチにある場合は、コード検索を使って検索できます。 詳しい情報については[コードの検索](/articles/searching-code)を参照してください。 {% data variables.product.prodname_pages %}に関する詳しい情報については、[GitHub Pages とは何ですか？ ](/articles/what-is-github-pages/)を参照してください。 +- Currently our search doesn't support exact matching. +- Whenever you are searching in code files, only the first two results in each file will be returned. {% endnote %} @@ -40,7 +42,7 @@ versions: - [Issue およびプルリクエスト](/articles/searching-issues-and-pull-requests) - [コード](/articles/searching-code) - [コミット](/articles/searching-commits) -- [ユーザ](/articles/searching-users){% if currentVersion == "free-pro-team@latest" %} +- [Users](/articles/searching-users){% if currentVersion == "free-pro-team@latest" %} - [パッケージ](/github/searching-for-information-on-github/searching-for-packages){% endif %} - [Wiki](/articles/searching-wikis) diff --git a/translations/ja-JP/content/github/searching-for-information-on-github/searching-code.md b/translations/ja-JP/content/github/searching-for-information-on-github/searching-code.md index a64a1e0cedf0..8607346483b2 100644 --- a/translations/ja-JP/content/github/searching-for-information-on-github/searching-code.md +++ b/translations/ja-JP/content/github/searching-for-information-on-github/searching-code.md @@ -22,7 +22,7 @@ versions: - {% data reusables.search.required_login %} - [フォーク](/articles/about-forks)のコードは、親リポジトリより Star が多い場合に限って検索可能です。 親リポジトリより Star が少ないフォークは、コード検索ではインデックス**されません。** 親リポジトリより Star が多いフォークを検索結果に含めるためには、クエリに `fork:true` または `fork:only` を追加する必要があります。 詳細は「[フォーク内で検索する](/articles/searching-in-forks)」を参照してください。 -- コード検索では、_デフォルトブランチ_のみインデックスされます。{% if currentVersion == "free-pro-team@latest" %} +- Only the _default branch_ is indexed for code search.{% if currentVersion == "free-pro-team@latest" %} - 384 KB より小さいファイルのみ検索可能です。{% else %}* 5 MB より小さいファイルのみ検索可能です。 - 各ファイルの最初の 500 KB のみ検索可能です。{% endif %} - 500,000 より少ないファイル数のリポジトリのみ検索可能です。 @@ -101,5 +101,5 @@ versions: ### 参考リンク - 「[検索結果をソートする](/articles/sorting-search-results/)」 -- "[フォーク内を検索する](/articles/searching-in-forks)"{% if currentVersion == "free-pro-team@latest" %} +- "[Searching in forks](/articles/searching-in-forks)"{% if currentVersion == "free-pro-team@latest" %} - "[ {% data variables.product.prodname_dotcom %} 上のコード間を移動する](/github/managing-files-in-a-repository/navigating-code-on-github)"{% endif %} diff --git a/translations/ja-JP/content/github/searching-for-information-on-github/searching-for-packages.md b/translations/ja-JP/content/github/searching-for-information-on-github/searching-for-packages.md index 183b6ca71396..39167bd6fc00 100644 --- a/translations/ja-JP/content/github/searching-for-information-on-github/searching-for-packages.md +++ b/translations/ja-JP/content/github/searching-for-information-on-github/searching-for-packages.md @@ -15,7 +15,8 @@ versions: {% data variables.product.product_name %} 全体にわたってグローバルにパッケージを検索できます。あるいは、特定の Organization のみのパッケージの検索もできます。 詳細は「[{% data variables.product.prodname_dotcom %} での検索について](/articles/about-searching-on-github)」を参照してください。 {% if currentVersion != "free-pro-team@latest" %} -特定のユーザまたは Organization が所有するパッケージを検索するには、`user` 修飾子または `org` 修飾子を使います。 +You can only search for packages on +{% data variables.product.product_location_enterprise %}, not {% data variables.product.prodname_dotcom_the_website %}, even if {% data variables.product.prodname_github_connect %} is enabled. {% endif %} {% data reusables.search.syntax_tips %} @@ -24,9 +25,9 @@ versions: 特定のユーザまたは Organization が所有するパッケージを検索するには、`user` 修飾子または `org` 修飾子を使います。 -| 修飾子 | サンプル | -| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| user:USERNAME | [**user:codertocat**](https://github.com/search?q=user%3Acodertocat&type=RegistryPackages) は、@codertocat が所有するパッケージにマッチします。 | +| 修飾子 | サンプル | +| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| user:USERNAME | [**user:codertocat**](https://github.com/search?q=user%3Acodertocat&type=RegistryPackages) は、@codertocat が所有するパッケージにマッチします。 | | org:ORGNAME | [**org:github**](https://github.com/search?q=org%3Agithub&type=RegistryPackages) は、{% data variables.product.prodname_dotcom %} Organization が所有するパッケージにマッチします。 | ### パッケージの可視性によるフィルタリング diff --git a/translations/ja-JP/content/github/searching-for-information-on-github/searching-issues-and-pull-requests.md b/translations/ja-JP/content/github/searching-for-information-on-github/searching-issues-and-pull-requests.md index 2f4c86dd0d30..255293e25d06 100644 --- a/translations/ja-JP/content/github/searching-for-information-on-github/searching-issues-and-pull-requests.md +++ b/translations/ja-JP/content/github/searching-for-information-on-github/searching-issues-and-pull-requests.md @@ -13,7 +13,7 @@ versions: {% tip %} -**参考:**{% if currentVersion != "free-pro-team@latest" %} +**Tips:**{% if currentVersion != "free-pro-team@latest" %} - この記事には、{% data variables.product.prodname_dotcom %}.com のウェブサイトでの検索例が含まれています。ですが、同じ検索フィルターを {% data variables.product.product_location_enterprise %} で使えます。{% endif %} - 検索結果を改良する検索修飾子を追加できる検索構文のリストについては、「[検索構文を理解する](/articles/understanding-the-search-syntax)」を参照してください。 - 複数単語の検索用語は引用符で囲みます。 たとえば "In progress" というラベルを持つ Issue を検索したい場合は、`label:"in progress"` とします。 検索では、大文字と小文字は区別されません。 @@ -229,7 +229,7 @@ versions: ### ドラフトプルリクエストを検索 ドラフトプルリクエストをフィルタリングすることができます。 詳しい情報については[プルリクエストについて](/articles/about-pull-requests#draft-pull-requests)を参照してください。 -| Qualifier | Example | ------------- | -------------{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} | `draft:true` | [**draft:true**](https://github.com/search?q=draft%3Atrue) はドラフトプルリクエストに一致します。 | `draft:false` | [**draft:false**](https://github.com/search?q=draft%3Afalse) は、レビューの準備ができたプルリクエストに一致します。{% else %} | `is:draft` | [**is:draft**](https://github.com/search?q=is%3Adraft) はドラフトプルリクエストに一致します。{% endif %} +| Qualifier | Example | ------------- | -------------{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} | `draft:true` | [**draft:true**](https://github.com/search?q=draft%3Atrue) matches draft pull requests. | `draft:false` | [**draft:false**](https://github.com/search?q=draft%3Afalse) は、レビューの準備ができたプルリクエストに一致します。{% else %} | `is:draft` | [**is:draft**](https://github.com/search?q=is%3Adraft) はドラフトプルリクエストに一致します。{% endif %} ### プルリクエストレビューのステータスおよびレビュー担当者で検索 diff --git a/translations/ja-JP/content/github/searching-for-information-on-github/sorting-search-results.md b/translations/ja-JP/content/github/searching-for-information-on-github/sorting-search-results.md index 5d0b7db29295..2fc5c49261a0 100644 --- a/translations/ja-JP/content/github/searching-for-information-on-github/sorting-search-results.md +++ b/translations/ja-JP/content/github/searching-for-information-on-github/sorting-search-results.md @@ -18,8 +18,8 @@ versions: `sort:interactions` 修飾子は、インタラクションおよびコメントの合計数の多い順にソートします。 -| 修飾子 | サンプル | -| ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 修飾子 | サンプル | +| ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sort:interactions` または `sort:interactions-desc` | [**org:github sort:interactions**](https://github.com/search?q=org%3Agithub+sort%3Ainteractions&type=Issues) は、{% data variables.product.product_name %} が所有するリポジトリの Issue にマッチし、インタラクションおよびコメントの合計数の多い順にソートされます。 | | `sort:interactions-asc` | [**org:github sort:interactions-asc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Ainteractions-asc&type=Issues) は、{% data variables.product.product_name %} が所有するリポジトリの Issue にマッチし、インタラクションおよびコメントの合計数の少ない順にソートされます。 | @@ -27,8 +27,8 @@ versions: `sort:reactions` 修飾子は、リアクションおよびコメントの合計数の多い順にソートします。 -| 修飾子 | サンプル | -| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 修飾子 | サンプル | +| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sort:reactions` または `sort:reactions-desc` | [**org:github sort:reactions**](https://github.com/search?q=org%3Agithub+sort%3Areactions&type=Issues) は、{% data variables.product.product_name %} が所有するリポジトリの Issue にマッチし、リアクションの数の多い順にソートされます。 | | `sort:reactions-asc` | [**org:github sort:reactions-asc**](https://github.com/search?q=org%3Agithub+sort%3Areactions-asc&type=Issues) は、{% data variables.product.product_name %} が所有するリポジトリの Issue にマッチし、リアクションの数の少ない順にソートされます。 | | sort:reactions-reaction | [**org:github sort:reactions-+1**](https://github.com/search?q=org%3Agithub+sort%3Areactions-%2B1&type=Issues) は、{% data variables.product.product_name %} が所有するリポジトリの Issue にマッチし、サムズアップ (:+1:) のリアクションが多い順にソートされます。 | @@ -41,8 +41,8 @@ versions: `sort:author-date` 修飾子は、オーサー日付を降順または昇順でソートします。 -| 修飾子 | サンプル | -| ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 修飾子 | サンプル | +| ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sort:author-date` または `sort:author-date-desc` | [**feature org:github sort:author-date**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Aauthor-date&type=Commits) は、オーサー日付で降順にソートされた、{% data variables.product.product_name %} が所有するリポジトリの「feature」という単語を含むコミットにマッチします。 | | `sort:author-date-asc` | [**feature org:github sort:author-date-asc**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Aauthor-date-asc&type=Commits) は、{% data variables.product.product_name %} が所有するリポジトリの「feature」という単語を含むコミットにマッチし、作者日付の昇順でソートされます。 | @@ -50,8 +50,8 @@ versions: `sort:committer-date` 修飾子は、コミッター日付を降順または昇順でソートします。 -| 修飾子 | サンプル | -| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 修飾子 | サンプル | +| ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sort:committer-date` または `sort:committer-date-desc` | [**feature org:github sort:committer-date**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Acommitter-date&type=Commits) は、{% data variables.product.product_name %} が所有するリポジトリの「feature」という単語を含むコミットにマッチし、コミッター日付の降順にソートされます。 | | `sort:committer-date-asc` | [**feature org:github sort:committer-date-asc**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Acommitter-date-asc&type=Commits) は、{% data variables.product.product_name %} が所有するリポジトリの「feature」という単語を含むコミットにマッチし、コミッター日付の昇順でソートされます。 | diff --git a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md index 4845d37d4abd..0162793b2329 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md @@ -12,8 +12,8 @@ versions: 利用時間 (分) は毎月リセットされますが、ストレージはリセットされません。 -| 製品 | ストレージ | 分 (月あたり) | -| --------------------------------------------------------------------- | ------ | -------- | +| 製品 | ストレージ | 分 (月あたり) | +| ---------------------------------------------------------------- | ------ | -------- | | {% data variables.product.prodname_free_user %} | 500 MB | 2,000 | | {% data variables.product.prodname_pro %} | 1 GB | 3,000 | | Organization の {% data variables.product.prodname_free_team %} | 500 MB | 2,000 | @@ -44,7 +44,7 @@ versions: | macOS | $0.08 | | Windows | $0.016 | -アカウントもしくはOrganization内のすべてのリポジトリにわたって同時に実行できるジョブ数は、あなたのGitHubのプランによります。 詳細については、「[{% data variables.product.prodname_actions %}について](/actions/automating-your-workflow-with-github-actions/about-github-actions/#usage-limits)」を参照してください。 +アカウントもしくはOrganization内のすべてのリポジトリにわたって同時に実行できるジョブ数は、あなたのGitHubのプランによります。 For more information, see "[Usage limits and billing](/actions/reference/usage-limits-billing-and-administration)" for {% data variables.product.prodname_dotcom %}-hosted runners and "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)" for self-hosted runner usage limits. ### 利用時間 (分) とストレージ消費量の計算 diff --git a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md index 04088159a3a9..0b8643ec05b2 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md @@ -14,8 +14,8 @@ versions: データ転送は毎月リセットされますが、ストレージはリセットされません。 -| 製品 | ストレージ | データ転送 (月あたり) | -| --------------------------------------------------------------------- | ----- | ------------ | +| 製品 | ストレージ | データ転送 (月あたり) | +| ---------------------------------------------------------------- | ----- | ------------ | | {% data variables.product.prodname_free_user %} | 500MB | 1GB | | {% data variables.product.prodname_pro %} | 2GB | 10GB | | Organization の {% data variables.product.prodname_free_team %} | 500MB | 1GB | diff --git a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-on-github.md b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-on-github.md index 52d82ddd3b40..09db88b35818 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-on-github.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-on-github.md @@ -26,6 +26,6 @@ versions: ### 参考リンク - 「[{% data variables.product.prodname_dotcom %} アカウントの支払いを管理する](/articles/managing-billing-for-your-github-account)」 -- 「[{% data variables.product.prodname_marketplace %} アプリケーションの支払いを管理する](/articles/managing-billing-for-github-marketplace-apps)」 +- [{% data variables.product.prodname_marketplace %} アプリの支払いを管理する](/articles/managing-billing-for-github-marketplace-apps) - 「[{% data variables.large_files.product_name_long %} の支払いを管理する](/articles/managing-billing-for-git-large-file-storage)」 - [{% data variables.product.prodname_sponsors %} の支払いを管理する](/articles/managing-billing-for-github-sponsors) diff --git a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/about-organizations-for-procurement-companies.md b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/about-organizations-for-procurement-companies.md index 9b8d3c4f8408..a5803c97a3c0 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/about-organizations-for-procurement-companies.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/about-organizations-for-procurement-companies.md @@ -1,6 +1,6 @@ --- title: 購入代行業者のためのOrganizationについて -intro: 企業は、Organizationを使って複数のオーナーと管理者を持つ共有プロジェクト上でコラボレートします。 クライアントのためにOrganizationを作成し、クライアントの代理で支払いを行い、そしてOrganizationの所有権をクライアントに渡すことができます。 +intro: '企業は、Organizationを使って複数のオーナーと管理者を持つ共有プロジェクト上でコラボレートします。 クライアントのためにOrganizationを作成し、クライアントの代理で支払いを行い、そしてOrganizationの所有権をクライアントに渡すことができます。' redirect_from: - /articles/about-organizations-for-resellers/ - /articles/about-organizations-for-procurement-companies diff --git a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/about-per-user-pricing.md b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/about-per-user-pricing.md index 78239eb6f29a..b90ab4bd956a 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/about-per-user-pricing.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/about-per-user-pricing.md @@ -1,6 +1,6 @@ --- title: ユーザごとの価格付けについて -intro: ユーザごとの価格付けでは、Organization は Team のための高度なコラボレーションと管理のツールへのアクセス、そして場合によってはセキュリティ、コンプライアンス、デプロイメントの制御のために、Team のサイズに基づいて支払いを行います。 +intro: 'ユーザごとの価格付けでは、Organization は Team のための高度なコラボレーションと管理のツールへのアクセス、そして場合によってはセキュリティ、コンプライアンス、デプロイメントの制御のために、Team のサイズに基づいて支払いを行います。' redirect_from: - /articles/about-per-user-pricing versions: diff --git a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/how-does-upgrading-or-downgrading-affect-the-billing-process.md b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/how-does-upgrading-or-downgrading-affect-the-billing-process.md index c9024e033aa2..c0e8ddde5b75 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/how-does-upgrading-or-downgrading-affect-the-billing-process.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/how-does-upgrading-or-downgrading-affect-the-billing-process.md @@ -1,6 +1,6 @@ --- title: アップグレードやダウングレードは支払い処理にどのように影響しますか? -intro: 個人アカウントまたは Organization のプランをアップグレードした場合、すぐに変更が適用されます。 プランをダウングレードした場合、現在の支払いサイクルの終了時に変更が適用されます。 +intro: '個人アカウントまたは Organization のプランをアップグレードした場合、すぐに変更が適用されます。 プランをダウングレードした場合、現在の支払いサイクルの終了時に変更が適用されます。' redirect_from: - /articles/how-does-upgrading-or-downgrading-affect-the-billing-process versions: @@ -30,6 +30,6 @@ versions: ### 参考リンク - 「[{% data variables.product.prodname_dotcom %} アカウントの支払いを管理する](/articles/managing-billing-for-your-github-account)」 -- 「[{% data variables.product.prodname_marketplace %} アプリケーションの支払いを管理する](/articles/managing-billing-for-github-marketplace-apps)」 +- [{% data variables.product.prodname_marketplace %} アプリの支払いを管理する](/articles/managing-billing-for-github-marketplace-apps) - 「[{% data variables.large_files.product_name_long %} の支払いを管理する](/articles/managing-billing-for-git-large-file-storage)」 - [ユーザごとの価格付けについて](/articles/about-per-user-pricing) diff --git a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-github-billing-settings.md b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-github-billing-settings.md index ed3814e09c29..498e6e5a6d42 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-github-billing-settings.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-github-billing-settings.md @@ -1,6 +1,6 @@ --- title: GitHub の支払い設定を管理する -intro: お使いのアカウントの支払い設定は、アカウントに追加する各有料機能または製品に適用されます。 支払い方法、支払いサイクル、支払い請求先メールアドレスなどの設定を管理できます。 また、ご利用のプラン、請求日、支払い履歴、過去の領収証などの支払い情報を表示することもできます。 +intro: 'お使いのアカウントの支払い設定は、アカウントに追加する各有料機能または製品に適用されます。 支払い方法、支払いサイクル、支払い請求先メールアドレスなどの設定を管理できます。 また、ご利用のプラン、請求日、支払い履歴、過去の領収証などの支払い情報を表示することもできます。' redirect_from: - /articles/viewing-and-managing-your-personal-account-s-billing-information/ - /articles/paying-for-user-accounts/ diff --git a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md index 763fad56e21b..3626bda64a84 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md @@ -49,6 +49,8 @@ Enterprise owners and billing managers can manage the spending limit for {% data {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %} -1. [{% data variables.product.prodname_actions %} and Packages monthly usage] で、[**Cost management**] をクリックします。 ![コスト管理タブ](/assets/images/help/settings/cost-management-tab-enterprise.png) +1. Under " +{% data variables.product.prodname_actions %} and Packages monthly usage", click **Cost management**. + ![コスト管理タブ](/assets/images/help/settings/cost-management-tab-enterprise.png) {% data reusables.dotcom_billing.monthly-spending-limit %} {% data reusables.dotcom_billing.update-spending-limit %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md index b4d53cfa7f89..ff0952c0c48a 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md @@ -49,6 +49,8 @@ Enterprise owners and billing managers can manage the spending limit for {% data {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %} -1. [{% data variables.product.prodname_actions %} and Packages monthly usage] で、[**Cost management**] をクリックします。 ![コスト管理タブ](/assets/images/help/settings/cost-management-tab-enterprise.png) +1. Under " +{% data variables.product.prodname_actions %} and Packages monthly usage", click **Cost management**. + ![コスト管理タブ](/assets/images/help/settings/cost-management-tab-enterprise.png) {% data reusables.dotcom_billing.monthly-spending-limit %} {% data reusables.dotcom_billing.update-spending-limit %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/renewing-your-clients-paid-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/renewing-your-clients-paid-organization.md index 0ba295797cb1..db71dc71ed69 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/renewing-your-clients-paid-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/renewing-your-clients-paid-organization.md @@ -1,6 +1,6 @@ --- title: クライアントの有料 Organization を更新する -intro: クライアントの Organization でファイルに対する支払い方法が有効である場合、その年間プランは自動更新されます。 支払いマネージャーは Organization の支払い方法とプランを表示して更新することができます。 +intro: 'クライアントの Organization でファイルに対する支払い方法が有効である場合、その年間プランは自動更新されます。 支払いマネージャーは Organization の支払い方法とプランを表示して更新することができます。' redirect_from: - /articles/renewing-your-client-s-paid-organization - /articles/renewing-your-clients-paid-organization diff --git a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md index 14858efb8ead..dbf0e6a31676 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md @@ -28,7 +28,9 @@ versions: {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.billing %} {% data reusables.user_settings.subscriptions-tab %} -4. [{% data variables.product.prodname_free_user %}] の隣で、[**Upgrade**] をクリックします。 ![アップグレードボタン](/assets/images/help/billing/settings_billing_user_upgrade.png) +4. Next to " +{% data variables.product.prodname_free_user %}", click **Upgrade**. + ![アップグレードボタン](/assets/images/help/billing/settings_billing_user_upgrade.png) {% data reusables.dotcom_billing.choose-monthly-or-yearly-billing %} {% data reusables.dotcom_billing.show-plan-details %} {% data reusables.dotcom_billing.enter-payment-info %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md index 257ed81df33a..b0a10f689c9b 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md @@ -6,7 +6,7 @@ versions: free-pro-team: '*' --- -個々のワークフロー実行について、請求可能なジョブ実行の時間（分）を確認することもできます。 詳しい情報については「[ワークフロー実行の管理](/actions/configuring-and-managing-workflows/managing-a-workflow-run#viewing-billable-job-execution-minutes)」を参照してください。 +個々のワークフロー実行について、請求可能なジョブ実行の時間（分）を確認することもできます。 For more information, see "[Viewing job execution time](/actions/managing-workflow-runs/viewing-job-execution-time)." ### ユーザアカウントの {% data variables.product.prodname_actions %} の使用状況を表示する @@ -43,6 +43,8 @@ Enterprise owners and billing managers can view {% data variables.product.prodna {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %} -1. [{% data variables.product.prodname_actions %}] で、Enterprise アカウントの Organization ごとにデータ転送の使用状況の詳細を表示します。 ![利用時間 (分) の詳細](/assets/images/help/billing/actions-minutes-enterprise.png) +1. Under " +{% data variables.product.prodname_actions %}", view details of usage of data transfer by each organization in your enterprise account. + ![利用時間 (分) の詳細](/assets/images/help/billing/actions-minutes-enterprise.png) {% data reusables.dotcom_billing.actions-packages-storage-enterprise-account %} {% data reusables.enterprise-accounts.actions-packages-report-download-enterprise-accounts %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md index 95f074468c32..3b5e067c2699 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md @@ -41,6 +41,8 @@ Enterprise owners and billing managers can view {% data variables.product.prodna {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %} -1. [{% data variables.product.prodname_registry %}] で、Enterprise アカウントの Organization ごとにデータ転送の使用状況の詳細を表示します。 ![データ転送の利用状況の詳細](/assets/images/help/billing/packages-data-enterprise.png) +1. Under " +{% data variables.product.prodname_registry %}", view details of usage of data transfer by each organization in your enterprise account. + ![データ転送の利用状況の詳細](/assets/images/help/billing/packages-data-enterprise.png) {% data reusables.dotcom_billing.actions-packages-storage-enterprise-account %} {% data reusables.enterprise-accounts.actions-packages-report-download-enterprise-accounts %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-subscriptions-and-billing-date.md b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-subscriptions-and-billing-date.md index ef0188969065..0490a3e93065 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-subscriptions-and-billing-date.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-subscriptions-and-billing-date.md @@ -1,6 +1,6 @@ --- title: プランと請求日を表示する -intro: アカウントのプラン、有料機能と製品、および次の請求日は、アカウントの支払い設定で確認できます。 +intro: 'アカウントのプラン、有料機能と製品、および次の請求日は、アカウントの支払い設定で確認できます。' redirect_from: - /articles/finding-your-next-billing-date/ - /articles/finding-your-personal-account-s-next-billing-date/ diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md index a99b8faf30cd..b979956613ae 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md @@ -25,5 +25,4 @@ enterprise アカウントに属する Organization では、支払いは enterp 会社、非営利団体、グループなどは、Organization として標準の利用規約あるいは企業向け利用規約に合意できます。 詳細は「[企業向け利用規約にアップグレードする](/articles/upgrading-to-the-corporate-terms-of-service)」を参照してください。 -{% data reusables.organizations.enter-data-protection-agreement %} 詳細は「[GDPR 準拠のために {% data variables.product.prodname_dotcom %} とデータ保護契約を締結する](/articles/entering-a-data-protection-agreement-with-github-for-gdpr-compliance)」を参照してください。 {% endif %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/about-scim.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/about-scim.md index 4b66a38b5ca8..6168a6493216 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/about-scim.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/about-scim.md @@ -1,6 +1,6 @@ --- title: SCIM について -intro: System for Cross-domain Identity Management (SCIM) を使うと、管理者はユーザの識別情報のシステム間での交換を自動化できます。 +intro: 'System for Cross-domain Identity Management (SCIM) を使うと、管理者はユーザの識別情報のシステム間での交換を自動化できます。' product: '{% data reusables.gated-features.saml-sso %}' redirect_from: - /articles/about-scim diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md index 514993097dde..c205dc90e803 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md @@ -1,17 +1,17 @@ --- title: SSH 認証局について -intro: SSH認証局を利用すると、メンバーがGitでリソースにアクセスするときに使用するSSH証明書を、OrganizationまたはEnterpriseアカウントが発行できます。 +intro: 'SSH認証局を利用すると、メンバーがGitでリソースにアクセスするときに使用するSSH証明書を、OrganizationまたはEnterpriseアカウントが発行できます。' product: '{% data reusables.gated-features.ssh-certificate-authorities %}' redirect_from: - /articles/about-ssh-certificate-authorities versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- SSH証明書とは、1つのSSHキーでもうひとつのSSHキーに署名する仕組みです。 SSH認証局 (CA) を利用して、Organizationのメンバーに署名済みのSSH証明書を提供すると、EnterpriseアカウントまたはOrganizationにCAを追加できるため、Organizationのメンバーはそれぞれの証明書を使用してOrganizationのリソースにアクセスできるようになります。 詳細については、「[OrganizationのSSH認証局を管理する](/articles/managing-your-organizations-ssh-certificate-authorities)」を参照してください。 -SSH CAをOrganizationまたはEnterpriseアカウントに追加すると、そのCAを利用して、OrganizationメンバーのクライアントSSH証明書に署名できるようになります。 Organizationのメンバーは、署名済みの証明書を使用して、GitでOrganizationのリポジトリにアクセスできます (ただし、自分のOrganizationのリポジトリに限る)。 メンバーがOrganizationのリソースにアクセスするときに、SSH証明書の使用を必須にすることができます。{% if currentVersion == "free-pro-team@latest" %}詳細については、「[Enterprise アカウントでセキュリティ設定を強制する](/articles/enforcing-security-settings-in-your-enterprise-account#managing-your-enterprise-accounts-ssh-certificate-authorities)」を参照してください。{% endif %} +SSH CAをOrganizationまたはEnterpriseアカウントに追加すると、そのCAを利用して、OrganizationメンバーのクライアントSSH証明書に署名できるようになります。 Organizationのメンバーは、署名済みの証明書を使用して、GitでOrganizationのリポジトリにアクセスできます (ただし、自分のOrganizationのリポジトリに限る)。 You can require that members use SSH certificates to access organization resources.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[Enforcing security settings in your enterprise account](/articles/enforcing-security-settings-in-your-enterprise-account#managing-your-enterprise-accounts-ssh-certificate-authorities)."{% endif %} たとえば、毎朝新しい証明書を開発者に発行する内部システムなども構築できます。 各開発者は、その日の証明書を使用して、{% data variables.product.product_name %}でOrganizationのリポジトリを扱うことができます。 1日の最後になると証明書は自動的に失効するので、証明書が侵害されることがあっても、リポジトリは保護されます。 diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/about-teams.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/about-teams.md index f850b1f0775b..981908df46cb 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/about-teams.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/about-teams.md @@ -21,7 +21,7 @@ Organization のオーナーとチームメンテナは、Team に対して、Or {% if currentVersion != "free-pro-team@latest" %} -また、LDAP Sync を使って {% data variables.product.product_location_enterprise %}の Team メンバーと Team ロールを、既成の LDAP グループと同期させることができます。 そうすることで、{% data variables.product.product_location_enterprise %}内で手動で行う代わりに、LDAP サーバーのユーザのロールベースアクセス制御を確立できます。 詳しい情報については[LDAP Syncの有効化](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)を参照してください。 +また、LDAP Sync を使って {% data variables.product.product_location_enterprise %}の Team メンバーと Team ロールを、既成の LDAP グループと同期させることができます。 そうすることで、{% data variables.product.product_location_enterprise %}内で手動で行う代わりに、LDAP サーバーのユーザのロールベースアクセス制御を確立できます。 詳しい情報については[LDAP Syncの有効化](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)を参照してください。 {% endif %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/about-your-organization-dashboard.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/about-your-organization-dashboard.md index ffe91765c192..d4ea442dfd44 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/about-your-organization-dashboard.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/about-your-organization-dashboard.md @@ -1,6 +1,6 @@ --- title: Organization ダッシュボードについて -intro: Organization のメンバーは、直近のアクティビティの更新情報を常時受け取り、作業中の Issue やプルリクエストを追跡したり、Organization をフォローしたりするために、Organization のダッシュボードにアクセスできます。 +intro: 'Organization のメンバーは、直近のアクティビティの更新情報を常時受け取り、作業中の Issue やプルリクエストを追跡したり、Organization をフォローしたりするために、Organization のダッシュボードにアクセスできます。' redirect_from: - /articles/about-your-organization-dashboard versions: @@ -28,7 +28,7 @@ versions: ニュースフィードの [All activity] セクションでは、Organization 内の他の Team やリポジトリからの更新情報を見ることができます。 -[All activity] セクションは、Organization 内のすべての最近のアクティビティを表示します。これにはあなたがサブスクライブしていないリポジトリでのアクティビティや、フォローしていない人々のアクティビティも含まれます。 詳細は、{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}「通知について」(/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}「[リポジトリの Watch と Watch 解除](/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories){% endif %}」および「[人をフォローする](/articles/following-people)」を参照してください。 +\[All activity] セクションは、Organization 内のすべての最近のアクティビティを表示します。これにはあなたがサブスクライブしていないリポジトリでのアクティビティや、フォローしていない人々のアクティビティも含まれます。 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 %}"[Watching and unwatching repositories](/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories){% endif %}" and "[Following people](/articles/following-people)." たとえば Organization のニュースフィードは Organization 内の誰かが以下のようなことをしたときに 更新情報を知らせます: - 新しいブランチを作成する diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/about-your-organizations-news-feed.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/about-your-organizations-news-feed.md index d70ba0dde7f7..d87c2f2bc215 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/about-your-organizations-news-feed.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/about-your-organizations-news-feed.md @@ -17,5 +17,5 @@ Organization のニュースフィードは、その Organization が所有し 1. 自分の {% data variables.product.product_name %}アカウントに {% data variables.product.signin_link %}します。 2. 自分の {% data reusables.user_settings.personal_dashboard %}を開きます。 3. ページの左上隅にあるアカウントコンテキストスイッチャーをクリックします。 ![Enterprise のコンテキストスイッチャーボタン](/assets/images/help/organizations/account_context_switcher.png) -4. ドロップダウンメニューから Organization を選択します。{% if currentVersion == "free-pro-team@latest" %} ![Context switcher menu in dotcom](/assets/images/help/organizations/account-context-switcher-selected-dotcom.png){% else %} +4. Select an organization from the drop-down menu.{% if currentVersion == "free-pro-team@latest" %} ![Context switcher menu in dotcom](/assets/images/help/organizations/account-context-switcher-selected-dotcom.png){% else %} ![Context switcher menu in Enterprise](/assets/images/help/organizations/account_context_switcher.png){% endif %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/accessing-your-organizations-settings.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/accessing-your-organizations-settings.md index c88e63450477..1318b9af7ee6 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/accessing-your-organizations-settings.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/accessing-your-organizations-settings.md @@ -8,7 +8,7 @@ redirect_from: - /articles/managing-an-organization-s-settings/ - /articles/accessing-your-organization-s-settings - /articles/accessing-your-organizations-settings -intro: Organization アカウントの設定ページには、支払い、Team のメンバーシップ、リポジトリ設定など、アカウントを管理するいくつかの方法があります。 +intro: 'Organization アカウントの設定ページには、支払い、Team のメンバーシップ、リポジトリ設定など、アカウントを管理するいくつかの方法があります。' versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md index 29c14776a419..eadb3343dcc8 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md @@ -1,6 +1,6 @@ --- title: Organization のプロジェクトボードに外部のコラボレータを追加する -intro: Organization のオーナーあるいはプロジェクトボードの管理者は、外部のコラボレータを追加し、追加したコラボレータのプロジェクトボードへの権限をカスタマイズできます。 +intro: 'Organization のオーナーあるいはプロジェクトボードの管理者は、外部のコラボレータを追加し、追加したコラボレータのプロジェクトボードへの権限をカスタマイズできます。' redirect_from: - /articles/adding-an-outside-collaborator-to-a-project-board-in-your-organization versions: @@ -17,6 +17,8 @@ versions: {% data reusables.project-management.click-menu %} {% data reusables.project-management.access-collaboration-settings %} {% data reusables.project-management.collaborator-option %} -9. \[Search by username, full name or email address\] (ユーザ名、フルネーム、メールアドレスでの検索) の下で、外部のコラボレータの名前、ユーザ名、{% data variables.product.prodname_dotcom %}メールを入力してください。 ![Octocat のユーザ名が検索フィールドに入力されているコラボレーターセクション](/assets/images/help/projects/org-project-collaborators-find-name.png) +9. Under "Search by username, full name or email address", type the outside collaborator's name, username, or +{% data variables.product.prodname_dotcom %} email. + ![Octocat のユーザ名が検索フィールドに入力されているコラボレーターセクション](/assets/images/help/projects/org-project-collaborators-find-name.png) {% data reusables.project-management.add-collaborator %} {% data reusables.project-management.collaborator-permissions %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md index 4baaddbbf169..b8c14ae6447a 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md @@ -24,7 +24,9 @@ versions: {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.github-apps-settings-sidebar %} -1. [{% data variables.product.prodname_github_app %}s] の下で、{% data variables.product.prodname_github_app %} マネージャーを追加したいアプリケーションのアバターをクリックします。 ![{% data variables.product.prodname_github_app %} を選択](/assets/images/help/organizations/select-github-app.png) +1. Under " +{% data variables.product.prodname_github_app %}s", click on the avatar of the app you'd like to add a {% data variables.product.prodname_github_app %} manager for. +![{% data variables.product.prodname_github_app %} を選択](/assets/images/help/organizations/select-github-app.png) {% data reusables.organizations.app-managers-settings-sidebar %} 1. [App managers] の下で、そのアプリケーションの GitHub App マネージャーとして指名したい人物のユーザ名を入力し、[**Grant**] をクリックしてください。 ![特定のアプリケーションに {% data variables.product.prodname_github_app %} マネージャーを追加](/assets/images/help/organizations/add-github-app-manager-for-app.png) diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/adding-organization-members-to-a-team.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/adding-organization-members-to-a-team.md index b013aa32d6ca..6b112565b6de 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/adding-organization-members-to-a-team.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/adding-organization-members-to-a-team.md @@ -1,6 +1,6 @@ --- -title: Team への Organization メンバーの追加 -intro: 'オーナーあるいはチームメンテナ権限を持っている人は、Organization のメンバーを Team に加えることができます。 オーナー権限を持っている人は、{% if currentVersion == "free-pro-team@latest" %}メンバーではない人を Team および Organization に参加するよう招待{% else %}メンバーではない人を Team および Organization に追加{% endif %}することもできます。' +title: Adding organization members to a team +intro: 'People with owner or team maintainer permissions can add organization members to teams. People with owner permissions can also {% if currentVersion == "free-pro-team@latest" %}invite non-members to join{% else %}add non-members to{% endif %} a team and the organization.' redirect_from: - /articles/adding-organization-members-to-a-team-early-access-program/ - /articles/adding-organization-members-to-a-team @@ -15,13 +15,14 @@ versions: {% data reusables.profile.access_org %} {% data reusables.organizations.specific_team %} {% data reusables.organizations.team_members_tab %} -6. Team メンバーのリストの上部で、[**Add a member**] をクリックします。 ![[Add member] ボタン](/assets/images/help/teams/add-member-button.png) +6. Above the list of team members, click **Add a member**. +![Add member button](/assets/images/help/teams/add-member-button.png) {% data reusables.organizations.invite_to_team %} {% data reusables.organizations.review-team-repository-access %} {% if currentVersion == "free-pro-team@latest" %}{% data reusables.organizations.cancel_org_invite %}{% endif %} -### 参考リンク +### Further reading -- [Team について](/articles/about-teams) -- [OrganizationのリポジトリへのTeamのアクセスの管理](/articles/managing-team-access-to-an-organization-repository) +- "[About teams](/articles/about-teams)" +- "[Managing team access to an organization repository](/articles/managing-team-access-to-an-organization-repository)" diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/can-i-create-accounts-for-people-in-my-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/can-i-create-accounts-for-people-in-my-organization.md index 1aae439be255..d373c232d235 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/can-i-create-accounts-for-people-in-my-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/can-i-create-accounts-for-people-in-my-organization.md @@ -3,7 +3,7 @@ title: 私の Organization に所属する人のためにアカウントを作 redirect_from: - /articles/can-i-create-accounts-for-those-in-my-organization/ - /articles/can-i-create-accounts-for-people-in-my-organization -intro: 作成した Organization にユーザを追加することはできますが、個人のアカウントを代理で作成することはできません。 +intro: '作成した Organization にユーザを追加することはできますが、個人のアカウントを代理で作成することはできません。' versions: free-pro-team: '*' --- diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md index 32d83cd6e9b6..e434a56d804f 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md @@ -15,8 +15,8 @@ SAML SSO は、リポジトリや Issue、プルリクエストといった Orga SCIM を有効にすると、Okta で {% data variables.product.prodname_ghe_cloud %} アプリケーションを割り当てる任意のユーザが次のプロビジョニング機能を使えるようになります。 -| 機能 | 説明 | -| ------------- | ------------------------------------------------------------------------------------------------------------------------- | +| 機能 | 説明 | +| ------------- | -------------------------------------------------------------------------------------------------------------------- | | 新しいユーザのプッシュ | Okta でユーザを作成すると、{% data variables.product.prodname_dotcom %} Organization に参加するためのメールがユーザに届きます。 | | ユーザ無効化のプッシュ | Okta でユーザを無効化すると、そのユーザは {% data variables.product.prodname_dotcom %} Organization から削除されます。 | | プロフィール更新のプッシュ | Okta でユーザのプロフィールを更新すると、そのユーザの {% data variables.product.prodname_dotcom %} の Organization でのメンバーシップに関するメタデータが更新されます。 | diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md new file mode 100644 index 000000000000..5934c0738154 --- /dev/null +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md @@ -0,0 +1,16 @@ +--- +title: Configuring the retention period for GitHub Actions artifacts and logs in your organization +intro: 'You can configure the retention period for {% data variables.product.prodname_actions %} artifacts and logs in your organization.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.23' +--- + +{% data reusables.actions.about-artifact-log-retention %} + +## Setting the retention period for an organization + +{% data reusables.organizations.navigate-to-org %} +{% data reusables.organizations.org_settings %} +{% data reusables.organizations.settings-sidebar-actions %} +{% data reusables.github-actions.change-retention-period-for-artifacts-logs %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/converting-an-admin-team-to-improved-organization-permissions.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/converting-an-admin-team-to-improved-organization-permissions.md index 30cad8ea9fbc..1be8cdddfe2e 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/converting-an-admin-team-to-improved-organization-permissions.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/converting-an-admin-team-to-improved-organization-permissions.md @@ -1,6 +1,6 @@ --- title: 管理者 Team を改善された Organization の権限に移行する -intro: 2015 年 9 月以降に作成された Organization の場合、Organization の権限モデルはデフォルトで改善されています。 2015 年 9 月より前に作成された Organization は、古いオーナーおよび管理者 Team から、改善された権限モデルに移行する必要があるかもしれません。 レガシーの管理者 Team は、改善された Organization 権限モデルに移行するまで、リポジトリの作成資格を自動的に維持します。 +intro: '2015 年 9 月以降に作成された Organization の場合、Organization の権限モデルはデフォルトで改善されています。 2015 年 9 月より前に作成された Organization は、古いオーナーおよび管理者 Team から、改善された権限モデルに移行する必要があるかもしれません。 レガシーの管理者 Team は、改善された Organization 権限モデルに移行するまで、リポジトリの作成資格を自動的に維持します。' redirect_from: - /articles/converting-your-previous-admin-team-to-the-improved-organization-permissions/ - /articles/converting-an-admin-team-to-improved-organization-permissions diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-into-a-user.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-into-a-user.md index dde484fbd645..bd0cba5ca20b 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-into-a-user.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-into-a-user.md @@ -1,6 +1,6 @@ --- title: Organization をユーザに変換する -intro: Organization は個人ユーザアカウントに変換できませんが、新しいユーザアカウントを作成して、そこへ Organization のリポジトリを移譲することは可能です。 +intro: 'Organization は個人ユーザアカウントに変換できませんが、新しいユーザアカウントを作成して、そこへ Organization のリポジトリを移譲することは可能です。' redirect_from: - /articles/converting-an-organization-into-a-user versions: diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-member-to-an-outside-collaborator.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-member-to-an-outside-collaborator.md index 256ef23ad398..fc35b7d82944 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-member-to-an-outside-collaborator.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-member-to-an-outside-collaborator.md @@ -1,6 +1,6 @@ --- title: Organization メンバーを外部コラボレーターに変換する -intro: Organization の現在のメンバーが、コンサルタントや一時的な雇用者などで、特定のリポジトリへのアクセスのみが必要な場合は、そのメンバーを「外部コラボレーター」に変換できます。 +intro: 'Organization の現在のメンバーが、コンサルタントや一時的な雇用者などで、特定のリポジトリへのアクセスのみが必要な場合は、そのメンバーを「外部コラボレーター」に変換できます。' redirect_from: - /articles/converting-an-organization-member-to-an-outside-collaborator versions: @@ -23,7 +23,7 @@ Organization のメンバーが外部コラボレーターに変換された後 アクセスが期待通りであることを確実にするために、Organization メンバーの、リポジトリへのアクセスを確認することをおすすめします。 詳細は、「[Organization のリポジトリへの個人のアクセスを管理する](/articles/managing-an-individual-s-access-to-an-organization-repository)」を参照してください。 -Organization のメンバーを外部コラボレーターに変換する際、Organization メンバーとしての権限は 3 か月保存されるので、この期間内に、そのユーザを Organization に{% if currentVersion == "free-pro-team@latest" %}再参加するよう招待{% else %}再追加{% endif %}すれば、メンバーとしての権限を回復できます。 詳しい情報については、「[Organization の以前のメンバーを回復する](/articles/reinstating-a-former-member-of-your-organization)」を参照してください。 +When you convert an organization member to an outside collaborator, their privileges as organization members are saved for three months so that you can restore their membership privileges if you{% if currentVersion == "free-pro-team@latest" %} invite them to rejoin{% else %} add them back to{% endif %} your organization within that time frame. 詳しい情報については、「[Organization の以前のメンバーを回復する](/articles/reinstating-a-former-member-of-your-organization)」を参照してください。 {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/converting-an-outside-collaborator-to-an-organization-member.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/converting-an-outside-collaborator-to-an-organization-member.md index fb1cea1d03a0..be985f927923 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/converting-an-outside-collaborator-to-an-organization-member.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/converting-an-outside-collaborator-to-an-organization-member.md @@ -1,6 +1,6 @@ --- -title: 外部コラボレーターを Organization メンバーに変換する -intro: 'Organization のリポジトリ上の外部コラボレーターに、Organization 内において、より幅広い権限を与えたい場合、Organization のメンバーとして{% if currentVersion == "free-pro-team@latest" %}ユーザーを招待{% else %}ユーザーを追加{% endif %}することができます。' +title: Converting an outside collaborator to an organization member +intro: 'If you would like to give an outside collaborator on your organization''s repositories broader permissions within your organization, you can {% if currentVersion == "free-pro-team@latest" %}invite them to become a member of{% else %}make them a member of{% endif %} the organization.' redirect_from: - /articles/converting-an-outside-collaborator-to-an-organization-member versions: @@ -11,9 +11,9 @@ versions: {% tip %} **Tips**: -- Organization オーナーのみが、Organization に{% if currentVersion == "free-pro-team@latest" %}ユーザーを招待{% else %}ユーザーを追加{% endif %}できます。 詳しい情報については「[Organization の権限レベル](/articles/permission-levels-for-an-organization)」を参照してください。{% if currentVersion == "free-pro-team@latest" %} -- Organization がユーザ単位の有料プランである場合、新しいメンバーを招待して参加させる、または Organization の以前のメンバーを復帰させる前に、そのためのライセンスが用意されている必要があります。 詳細は「[ユーザごとの価格付けについて](/articles/about-per-user-pricing)」を参照してください。 {% data reusables.organizations.org-invite-expiration %}{% endif %} -- Organization が[メンバーに 2 要素認証を使うことを要求](/articles/requiring-two-factor-authentication-in-your-organization)している場合、{% if currentVersion == "free-pro-team@latest" %}招待されるユーザは招待を受諾する前に手元で [2 要素認証を有効化](/articles/securing-your-account-with-two-factor-authentication-2fa)しておく必要があります。{% else %}ユーザを Organization に追加する前にそのユーザは手元で [2 要素認証を有効化](/articles/securing-your-account-with-two-factor-authentication-2fa)しておく必要があります。{% endif %} +- Only organization owners can {% if currentVersion == "free-pro-team@latest" %}invite users to join{% else %}add users to{% endif %} an organization. For more information, see "[Permission levels for an organization](/articles/permission-levels-for-an-organization)."{% if currentVersion == "free-pro-team@latest" %} +- If your organization is on a paid per-user subscription, an unused license must be available before you can invite a new member to join the organization or reinstate a former organization member. For more information, see "[About per-user pricing](/articles/about-per-user-pricing)." {% data reusables.organizations.org-invite-expiration %}{% endif %} +- If your organization [requires members to use two-factor authentication](/articles/requiring-two-factor-authentication-in-your-organization), users {% if currentVersion == "free-pro-team@latest" %}you invite must [enable two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa) before they can accept the invitation.{% else %}must [enable two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa) before you can add them to the organization.{% endif %} {% endtip %} @@ -22,10 +22,9 @@ versions: {% data reusables.organizations.people %} {% data reusables.organizations.people_tab_outside_collaborators %} {% if currentVersion == "free-pro-team@latest" %} -5. To the right of the name of the outside collaborator you want to become a member, use the -{% octicon "gear" aria-label="The gear icon" %} drop-down menu and click **Invite to organization**.![外部のコラボレーターを Organization に招待](/assets/images/help/organizations/invite_outside_collaborator_to_organization.png) +5. To the right of the name of the outside collaborator you want to become a member, use the {% octicon "gear" aria-label="The gear icon" %} drop-down menu and click **Invite to organization**.![Invite outside collaborators to organization](/assets/images/help/organizations/invite_outside_collaborator_to_organization.png) {% else %} -5. メンバーにしたい外部のコラボレーターの名前の右側で、[**Invite to organization**] をクリックします。![外部のコラボレーターを Organization に招待](/assets/images/enterprise/orgs-and-teams/invite_outside_collabs_to_org.png) +5. To the right of the name of the outside collaborator you want to become a member, click **Invite to organization**.![Invite outside collaborators to organization](/assets/images/enterprise/orgs-and-teams/invite_outside_collabs_to_org.png) {% endif %} {% data reusables.organizations.choose-to-restore-privileges %} {% data reusables.organizations.choose-user-role-send-invitation %} @@ -33,6 +32,6 @@ versions: {% data reusables.organizations.user_must_accept_invite_email %} {% data reusables.organizations.cancel_org_invite %} {% endif %} -### 参考リンク +### Further reading -- [Organizatin のメンバーを外部のコラボレータに変換する](/articles/converting-an-organization-member-to-an-outside-collaborator) +- "[Converting an organization member to an outside collaborator](/articles/converting-an-organization-member-to-an-outside-collaborator)" diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/converting-an-owners-team-to-improved-organization-permissions.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/converting-an-owners-team-to-improved-organization-permissions.md index 2487920cac92..fb05902d10f8 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/converting-an-owners-team-to-improved-organization-permissions.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/converting-an-owners-team-to-improved-organization-permissions.md @@ -1,6 +1,6 @@ --- title: オーナー Team を改善された Organization の権限に移行する -intro: 2015 年 9 月以降に作成された Organization の場合、Organization の権限モデルはデフォルトで改善されています。 2015 年 9 月より前に作成された Organization は、古いオーナーおよび管理者 Team から、改善された権限モデルに移行する必要があるかもしれません。 「オーナー」は、Organization の各メンバーに与えられる管理者ロールとなりました。 レガシーのオーナー Team のメンバーには、オーナー権限が自動的に与えられます。 +intro: '2015 年 9 月以降に作成された Organization の場合、Organization の権限モデルはデフォルトで改善されています。 2015 年 9 月より前に作成された Organization は、古いオーナーおよび管理者 Team から、改善された権限モデルに移行する必要があるかもしれません。 「オーナー」は、Organization の各メンバーに与えられる管理者ロールとなりました。 レガシーのオーナー Team のメンバーには、オーナー権限が自動的に与えられます。' redirect_from: - /articles/converting-your-previous-owners-team-to-the-improved-organization-permissions-early-access-program/ - /articles/converting-your-previous-owners-team-to-the-improved-organization-permissions/ diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch.md index dd656a9a171e..61f81d562e87 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch.md @@ -13,7 +13,7 @@ versions: {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.organizations %} {% data reusables.organizations.new-organization %} -4. プロンプトに従って Organization を作成します。 {% if currentVersion == "free-pro-team@latest" %}Team で利用できるプランに関する詳しい情報については、「[{% data variables.product.prodname_dotcom %} の製品](/articles/githubs-products)」を参照してください。{% endif %} +4. プロンプトに従って Organization を作成します。 {% if currentVersion == "free-pro-team@latest" %}For more information about the plans available for your team, see "[{% data variables.product.prodname_dotcom %}'s products](/articles/githubs-products)."{% endif %} ### 参考リンク diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/deleting-an-organization-account.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/deleting-an-organization-account.md index 7de6c89b6d95..5ca02df73594 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/deleting-an-organization-account.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/deleting-an-organization-account.md @@ -1,6 +1,6 @@ --- title: Organization アカウントの削除 -intro: 'Organization を削除すると、リポジトリ、プライベートリポジトリのフォーク、ウィキ、Issue、プルリクエスト、プロジェクトページや Organization ページもすべて削除されます。 {% if currentVersion == "free-pro-team@latest" %}Organization 名は新しいユーザや Organization のアカウントで使用できるようになり、支払いは終了します。{% endif %}' +intro: 'Organization を削除すると、リポジトリ、プライベートリポジトリのフォーク、ウィキ、Issue、プルリクエスト、プロジェクトページや Organization ページもすべて削除されます。 {% if currentVersion == "free-pro-team@latest" %}The organization name becomes available for use on a new user or organization account, and your billing will end.{% endif %}' redirect_from: - /articles/deleting-an-organization-account versions: diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md index f4823f826a43..a978773450e5 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md @@ -1,22 +1,24 @@ --- title: Organization について GitHub Actions を無効化または制限する -intro: Organization のオーナーは Organization の GitHub Actions を無効化、有効化、制限することができます。 +intro: 'Organization のオーナーは Organization の GitHub Actions を無効化、有効化、制限することができます。' versions: free-pro-team: '*' enterprise-server: '>=2.22' --- -{% data reusables.actions.enterprise-beta %} +{% data variables.product.prodname_actions %} の支払いを管理する {% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 ### Organization の {% data variables.product.prodname_actions %} 権限について -{% data reusables.github-actions.disabling-github-actions %} {% data variables.product.prodname_actions %} について詳しくは、「[{% data variables.product.prodname_actions %} について](/actions/getting-started-with-github-actions/about-github-actions)」を参照してください。 +{% data reusables.github-actions.disabling-github-actions %} {% data variables.product.prodname_actions %} の詳細は、「[{% data variables.product.prodname_actions %}について](/actions/getting-started-with-github-actions/about-github-actions)」を参照してください。 Organization のすべてのリポジトリについて {% data variables.product.prodname_actions %} を有効化することができます。 {% data reusables.github-actions.enabled-actions-description %} Organization のすべてのリポジトリについて 、{% data variables.product.prodname_actions %} を無効化できます。 {% data reusables.github-actions.disabled-actions-description %} あるいは、Organization のすべてのリポジトリについて {% data variables.product.prodname_actions %} を有効化したうえで、ワークフローで実行できるアクションを制限することができます。 {% data reusables.github-actions.enabled-local-github-actions %} +{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.23" %} + ### Organization の {% data variables.product.prodname_actions %} 権限の管理 {% data reusables.profile.access_profile %} @@ -26,6 +28,42 @@ Organization のすべてのリポジトリについて {% data variables.produc 1. [**Local and third-party Actions**] で、オプションを選択します。 ![この Organization でアクションを有効化、無効化、制限](/assets/images/help/repository/enable-org-actions.png) 1. [**Save**] をクリックします。 +{% endif %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} + +### Organization の {% data variables.product.prodname_actions %} 権限の管理 + +You can disable all workflows for an organization or set a policy that configures which actions can be used in an organization. + +{% data reusables.actions.actions-use-policy-settings %} + +{% note %} + +**Note:** You might not be able to manage these settings if your organization is managed by an enterprise that has overriding policy. For more information, {% if currentVersion == "free-pro-team@latest" %}"[Enforcing {% data variables.product.prodname_actions %} policies in your enterprise account](/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account)."{% else %}"[Enforcing {% data variables.product.prodname_actions %} policies for your enterprise](/enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise)."{% endif %} + +{% endnote %} + +{% data reusables.profile.access_profile %} +{% data reusables.profile.access_org %} +{% data reusables.organizations.org_settings %} +{% data reusables.organizations.settings-sidebar-actions %} +1. Under **Policies**, select an option. ![Set actions policy for this organization](/assets/images/help/organizations/actions-policy.png) +1. [**Save**] をクリックします。 + +### Allowing specific actions to run + +{% data reusables.actions.allow-specific-actions-intro %} + +{% data reusables.profile.access_profile %} +{% data reusables.profile.access_org %} +{% data reusables.organizations.org_settings %} +{% data reusables.organizations.settings-sidebar-actions %} +1. Under **Policies**, select **Allow specific actions** and add your required actions to the list. ![Add actions to allow list](/assets/images/help/organizations/actions-policy-allow-list.png) +1. [**Save**] をクリックします。 + +{% endif %} + {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} ### プライベートリポジトリのフォークのワークフローを有効にする diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization.md index ab591c2f2cfd..f3231626ad45 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization.md @@ -10,9 +10,9 @@ versions: ### About restrictions on publication of {% data variables.product.prodname_pages %} sites -You can control whether members of your organization can publish websites from repositories in your organization using {% data variables.product.prodname_pages %}. {% data variables.product.prodname_pages %} に関する詳しい情報については、「[{% data variables.product.prodname_pages %} について](/github/working-with-github-pages/about-github-pages)」を参照してください。 +You can control whether members of your organization can publish websites from repositories in your organization using {% data variables.product.prodname_pages %}. For more information about {% data variables.product.prodname_pages %}, see "[About {% data variables.product.prodname_pages %}](/github/working-with-github-pages/about-github-pages)." -{% if currentVersion != "free-pro-team@latest" %}If your site administrator has enabled Public Pages, {% endif %}{% data variables.product.prodname_pages %} sites are publicly available on the internet, even if the repository for the site is private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %}. 詳しい情報については{% if currentVersion != "free-pro-team@latest" %}「[アプライアンス上での{% data variables.product.prodname_pages %}の設定](/enterprise/admin/installation/configuring-github-pages-on-your-appliance#making-github-pages-publicly-accessible)」及び{% endif %}「[リポジトリの可視性について](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)」を参照してください。 +{% if currentVersion != "free-pro-team@latest" %}If your site administrator has enabled Public Pages, {% endif %}{% data variables.product.prodname_pages %} sites are publicly available on the internet, even if the repository for the site is private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %}. For more information, see{% if currentVersion != "free-pro-team@latest" %} "[Configuring {% data variables.product.prodname_pages %} on your appliance](/enterprise/admin/installation/configuring-github-pages-on-your-appliance#making-github-pages-publicly-accessible)" and{% endif %} "[About repository visibility](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)." ### Disabling publication of {% data variables.product.prodname_pages %} sites @@ -22,5 +22,7 @@ After you disable publication of {% data variables.product.prodname_pages %} sit {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.member-privileges %} -1. Under "Pages creation", unselect **Allow members to publish sites**. ![Unselected checkbox for "Allow members to publish sites" option](/assets/images/help/organizations/org-settings-pages-disable-publication-checkbox.png) -1. [**Save**] をクリックします。 !["Save" button for "Allow members to publish sites" option](/assets/images/help/organizations/org-settings-pages-disable-publication-save-button.png) +1. Under "Pages creation", unselect **Allow members to publish sites**. + ![Unselected checkbox for "Allow members to publish sites" option](/assets/images/help/organizations/org-settings-pages-disable-publication-checkbox.png) +1. Click **Save**. + !["Save" button for "Allow members to publish sites" option](/assets/images/help/organizations/org-settings-pages-disable-publication-save-button.png) diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/giving-team-maintainer-permissions-to-an-organization-member.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/giving-team-maintainer-permissions-to-an-organization-member.md index 6e4af21a78b6..c00998896e64 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/giving-team-maintainer-permissions-to-an-organization-member.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/giving-team-maintainer-permissions-to-an-organization-member.md @@ -1,6 +1,6 @@ --- title: Organization メンバーに「チームメンテナー」権限を付与する -intro: Organization のオーナーは、Organization の任意のメンバーを Team の *チームメンテナー* に昇格させて、Organization のオーナーが持ついくつかの権限を付与することができます。 +intro: 'Organization のオーナーは、Organization の任意のメンバーを Team の *チームメンテナー* に昇格させて、Organization のオーナーが持ついくつかの権限を付与することができます。' redirect_from: - /articles/giving-team-maintainer-permissions-to-an-organization-member-early-access-program/ - /articles/giving-team-maintainer-permissions-to-an-organization-member diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/granting-access-to-your-organization-with-saml-single-sign-on.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/granting-access-to-your-organization-with-saml-single-sign-on.md index 00163d25d7c1..e75dc4b1daad 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/granting-access-to-your-organization-with-saml-single-sign-on.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/granting-access-to-your-organization-with-saml-single-sign-on.md @@ -1,6 +1,6 @@ --- title: SAML シングルサインオンでの Organization へのアクセスを許可する -intro: Organization の管理者は、SAML シングルサインオンでの Organization へのアクセスを許可できます。 このアクセス権は、Organization メンバー、ボット、およびサービスアカウントに付与することができます。 +intro: 'Organization の管理者は、SAML シングルサインオンでの Organization へのアクセスを許可できます。 このアクセス権は、Organization メンバー、ボット、およびサービスアカウントに付与することができます。' mapTopic: true redirect_from: - /articles/granting-access-to-your-organization-with-saml-single-sign-on diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/index.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/index.md index 43cff9cf3292..a703af9e27c0 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/index.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/index.md @@ -100,6 +100,7 @@ versions: {% link_in_list /managing-the-forking-policy-for-your-organization %} {% link_in_list /disabling-or-limiting-github-actions-for-your-organization %} + {% link_in_list /configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization %} {% link_in_list /setting-permissions-for-adding-outside-collaborators %} @@ -131,7 +132,6 @@ versions: {% link_in_list /upgrading-to-the-corporate-terms-of-service %} - {% link_in_list /entering-a-data-protection-agreement-with-github-for-gdpr-compliance %} {% topic_link_in_list /migrating-to-improved-organization-permissions %} {% link_in_list /converting-an-owners-team-to-improved-organization-permissions %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/integrating-jira-with-your-organization-project-board.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/integrating-jira-with-your-organization-project-board.md index b51e7395b45d..bae65eca6a06 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/integrating-jira-with-your-organization-project-board.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/integrating-jira-with-your-organization-project-board.md @@ -1,6 +1,6 @@ --- title: Organization のプロジェクトボードに JIRA を統合する -intro: Jira Cloud を Organization のアカウントに統合すると、コミットとプルリクエストをスキャンし、メンションされている JIRA の Issue で、関連するメタデータとハイパーリンクを作成できます。 +intro: 'Jira Cloud を Organization のアカウントに統合すると、コミットとプルリクエストをスキャンし、メンションされている JIRA の Issue で、関連するメタデータとハイパーリンクを作成できます。' redirect_from: - /articles/integrating-jira-with-your-organization-project-board versions: diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md index ac76e523c2e5..4e9cde7e40b4 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md @@ -1,6 +1,7 @@ --- title: Organization に参加するようユーザを招待する intro: 'Organization のメンバーとして追加したい人がいれば、その人の {% data variables.product.product_name %} ユーザ名またはメール アドレスを使用して招待することができます。' +permissions: Organization owners can invite users to join an organization. redirect_from: - /articles/adding-or-inviting-members-to-a-team-in-an-organization/ - /articles/inviting-users-to-join-your-organization @@ -11,9 +12,8 @@ versions: {% tip %} **Tips**: -- Organization に参加するようユーザを招待できるのは、Organization オーナーだけです。 詳細は「[Organization の権限レベル](/articles/permission-levels-for-an-organization)」を参照してください。 - Organization がユーザ単位の有料プランである場合、新しいメンバーを招待して参加させる、または Organization の以前のメンバーを復帰させる前に、そのためのライセンスが用意されている必要があります。 詳細は「[ユーザごとの価格付けについて](/articles/about-per-user-pricing)」を参照してください。 {% data reusables.organizations.org-invite-expiration %} -- Organization が[メンバーに 2 要素認証を使うことを要求](/articles/requiring-two-factor-authentication-in-your-organization)している場合、招待するユーザは招待を受ける前に[ 2 要素認証を有効化](/articles/securing-your-account-with-two-factor-authentication-2fa)する必要があります。 +- If your organization requires members to use two-factor authentication, users that you invite must enable two-factor authentication before accepting the invitation. For more information, see "[Requiring two-factor authentication in your organization](/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization)" and "[Securing your account with two-factor authentication (2FA)](/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa)." {% endtip %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/keeping-your-organization-secure.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/keeping-your-organization-secure.md index 8f14fce2a937..3bf9fb67919b 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/keeping-your-organization-secure.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/keeping-your-organization-secure.md @@ -3,7 +3,7 @@ title: Organization を安全に保つ redirect_from: - /articles/preventing-unauthorized-access-to-organization-information/ - /articles/keeping-your-organization-secure -intro: Organization のオーナーがプロジェクトとデータを安全に保つ方法はいくつかあります。 Organization のオーナーは、不正な、または悪意のあるアクティビティが発生していないことを確認するために、Organization の監査ログ、メンバーの 2 要素認証ステータス、そしてアプリケーション設定を定期的にレビューする必要があります。 +intro: 'Organization のオーナーがプロジェクトとデータを安全に保つ方法はいくつかあります。 Organization のオーナーは、不正な、または悪意のあるアクティビティが発生していないことを確認するために、Organization の監査ログ、メンバーの 2 要素認証ステータス、そしてアプリケーション設定を定期的にレビューする必要があります。' mapTopic: true versions: free-pro-team: '*' diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-a-project-board-for-organization-members.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-a-project-board-for-organization-members.md index 30cd252cc16b..ceb7d1605258 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-a-project-board-for-organization-members.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-a-project-board-for-organization-members.md @@ -1,6 +1,6 @@ --- title: Organization メンバーのプロジェクトボードへのアクセスを管理する -intro: Organization のオーナーまたはプロジェクトボード管理者は、Organization のすべてのメンバーについて、プロジェクトボードのデフォルトの権限レベルを設定できます。 +intro: 'Organization のオーナーまたはプロジェクトボード管理者は、Organization のすべてのメンバーについて、プロジェクトボードのデフォルトの権限レベルを設定できます。' redirect_from: - /articles/managing-access-to-a-project-board-for-organization-members versions: diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-your-organizations-project-boards.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-your-organizations-project-boards.md index 88f60ce46fa9..fc44528ff112 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-your-organizations-project-boards.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-your-organizations-project-boards.md @@ -1,6 +1,6 @@ --- title: Organization のプロジェクトボードへのアクセスを管理する -intro: Organization のオーナーまたはプロジェクトボードの管理者は、Organization が所有するプロジェクトボードについて、Organization のメンバー、チーム、外部のコラボレーターごとに異なるレベルのアクセス権を付与できます。 +intro: 'Organization のオーナーまたはプロジェクトボードの管理者は、Organization が所有するプロジェクトボードについて、Organization のメンバー、チーム、外部のコラボレーターごとに異なるレベルのアクセス権を付与できます。' redirect_from: - /articles/managing-access-to-your-organization-s-project-boards - /articles/managing-access-to-your-organizations-project-boards diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md index 15f90072b5c1..e0a85b5c2d17 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md @@ -1,6 +1,6 @@ --- title: Organization のプロジェクトボードに対する個々のアクセスを管理する -intro: Organization のオーナーまたはプロジェクトボードの管理者は、Organization で所有しているプロジェクトボードに対する個々のメンバーのアクセスを管理できます。 +intro: 'Organization のオーナーまたはプロジェクトボードの管理者は、Organization で所有しているプロジェクトボードに対する個々のメンバーのアクセスを管理できます。' redirect_from: - /articles/managing-an-individual-s-access-to-an-organization-project-board - /articles/managing-an-individuals-access-to-an-organization-project-board @@ -24,7 +24,9 @@ versions: {% data reusables.project-management.click-menu %} {% data reusables.project-management.access-collaboration-settings %} {% data reusables.project-management.collaborator-option %} -9. [Search by username, full name or email address] で、コラボレーターの名前、ユーザ名、または {% data variables.product.prodname_dotcom %} メールを入力します。 ![Octocat のユーザ名が検索フィールドに入力されているコラボレーターセクション](/assets/images/help/projects/org-project-collaborators-find-name.png) +9. Under "Search by username, full name or email address", type the collaborator's name, username, or +{% data variables.product.prodname_dotcom %} email. + ![Octocat のユーザ名が検索フィールドに入力されているコラボレーターセクション](/assets/images/help/projects/org-project-collaborators-find-name.png) {% data reusables.project-management.add-collaborator %} {% data reusables.project-management.collaborator-permissions %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-repository.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-repository.md index 458a60e27d39..3dac4e999368 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-repository.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-repository.md @@ -30,5 +30,5 @@ Organization のリポジトリからコラボレーターを削除すると、 ### 参考リンク -{% if currentVersion == "free-pro-team@latest" %}- [リポジトリでのインタラクションを制限する](/articles/limiting-interactions-with-your-repository){% endif %} +{% if currentVersion == "free-pro-team@latest" %}- "[Limiting interactions with your repository](/articles/limiting-interactions-with-your-repository)"{% endif %} - [Organization のリポジトリ権限レベル](/articles/repository-permission-levels-for-an-organization) diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md index cae1d6be474b..8720e78d4264 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md @@ -8,6 +8,6 @@ redirect_from: - /articles/managing-git-access-to-your-organizations-repositories versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-membership-in-your-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-membership-in-your-organization.md index 7aef968e640b..ba0d4a656c14 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-membership-in-your-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-membership-in-your-organization.md @@ -1,6 +1,6 @@ --- title: Organization でメンバーシップを管理する -intro: 'Organization を作成すると、Organization のメンバーとして{% if currentVersion == "free-pro-team@latest" %}ユーザを招待{% else %}ユーザを追加{% endif %}することができます。 メンバーの削除や、元のメンバーの復帰も可能です。' +intro: 'After you create your organization, you can {% if currentVersion == "free-pro-team@latest" %}invite people to become{% else %}add people as{% endif %} members of the organization. メンバーの削除や、元のメンバーの復帰も可能です。' redirect_from: - /articles/removing-a-user-from-your-organization/ - /articles/managing-membership-in-your-organization diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-organization-settings.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-organization-settings.md index 7c4fcb8a24b8..af7d90a97614 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-organization-settings.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-organization-settings.md @@ -1,6 +1,6 @@ --- title: Organization の設定を管理する -intro: Organization の管理者は、Organization に属するリポジトリの名前や、オーナー チームのメンバーシップなど、いつくかの設定を変更できます。 また、Organization とそのリポジトリすべてを削除することもできます。 +intro: 'Organization の管理者は、Organization に属するリポジトリの名前や、オーナー チームのメンバーシップなど、いつくかの設定を変更できます。 また、Organization とそのリポジトリすべてを削除することもできます。' mapTopic: true redirect_from: - /articles/managing-organization-settings diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-peoples-access-to-your-organization-with-roles.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-peoples-access-to-your-organization-with-roles.md index 70db6a255f3b..aa9603115e97 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-peoples-access-to-your-organization-with-roles.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-peoples-access-to-your-organization-with-roles.md @@ -1,6 +1,6 @@ --- title: Organization へのアクセスをロールで管理する -intro: Organization における個人のロールは、Organization、その設定、およびデータにアクセスできるレベルを決めるものです。 個人を Organization のオーナー、メンバー、支払いマネージャーに指定したり、チームメンテナの権限を付与したりできます。 +intro: 'Organization における個人のロールは、Organization、その設定、およびデータにアクセスできるレベルを決めるものです。 個人を Organization のオーナー、メンバー、支払いマネージャーに指定したり、チームメンテナの権限を付与したりできます。' redirect_from: - /articles/managing-people-s-access-to-your-organization-with-roles - /articles/managing-peoples-access-to-your-organization-with-roles diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization.md index ce254beaa823..f67398764541 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization.md @@ -35,7 +35,7 @@ versions: ### 参考リンク -{% if currentVersion == "free-pro-team@latest" %}- [リポジトリのセキュリティ保護について](/github/administering-a-repository/about-securing-your-repository) +{% if currentVersion == "free-pro-team@latest" %}- "[About securing your repository](/github/administering-a-repository/about-securing-your-repository)" - [シークレットスキャンニングについて](/github/administering-a-repository/about-secret-scanning) - [依存関係を自動的に更新する](/github/administering-a-repository/keeping-your-dependencies-updated-automatically) {% endif %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-project-board.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-project-board.md index 8cdee7461a3c..7be00f42fc1a 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-project-board.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-project-board.md @@ -1,6 +1,6 @@ --- title: Organization のプロジェクトボードに対するチームのアクセスを管理する -intro: Organization のオーナーまたはプロジェクトボードの管理者は、Organization が所有しているプロジェクトボードへのアクセスをチームに付与できます。 +intro: 'Organization のオーナーまたはプロジェクトボードの管理者は、Organization が所有しているプロジェクトボードへのアクセスをチームに付与できます。' redirect_from: - /articles/managing-team-access-to-an-organization-project-board versions: diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository.md index 339e991a4357..4697d8a566b9 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository.md @@ -1,6 +1,6 @@ --- title: Organization リポジトリへの Team のアクセスを管理する -intro: リポジトリへのチームアクセスを付与、リポジトリへのチームアクセスを削除、またはリポジトリへのチームの権限レベルを変更することができます。 +intro: 'リポジトリへのチームアクセスを付与、リポジトリへのチームアクセスを削除、またはリポジトリへのチームの権限レベルを変更することができます。' redirect_from: - /articles/managing-team-access-to-an-organization-repository-early-access-program/ - /articles/managing-team-access-to-an-organization-repository diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md index b786bc266bda..ed5818f342e4 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md @@ -1,6 +1,7 @@ --- title: Organization のリポジトリのデフォルブランチ名を管理する -intro: Organization でメンバーが作成するリポジトリについて、デフォルトブランチ名を設定できます。 +intro: 'Organization でメンバーが作成するリポジトリについて、デフォルトブランチ名を設定できます。' +permissions: リポジトリのデフォルトブランチ名を管理する versions: free-pro-team: '*' enterprise-server: '>=2.23' @@ -8,12 +9,10 @@ versions: ### デフォルトブランチ名について -Organization のメンバーが新しいリポジトリを作成するとき、{% data variables.product.prodname_dotcom %} はブランチを 1 つ作成し、それをリポジトリのデフォルトブランチに設定します。 {% data variables.product.prodname_dotcom %} は現在、デフォルトブランチに `master` という名前を付けまが、開発環境でわかりやすいようにデフォルトブランチには任意の名前を設定することができます。 +When a member of your organization creates a new repository in your organization, the repository contains one branch, which is the default branch. Organization のメンバーが新しいリポジトリを作成するとき、{% data variables.product.prodname_dotcom %} はブランチを 1 つ作成し、それをリポジトリのデフォルトブランチに設定します。 For more information about the default branch, see "[About branches](/github/collaborating-with-issues-and-pull-requests/about-branches#about-the-default-branch)." {% data reusables.branches.set-default-branch %} -{% data reusables.branches.rename-existing-branch %} - ### デフォルトブランチ 名を設定する {% data reusables.profile.access_profile %} @@ -31,4 +30,4 @@ Organization のメンバーが新しいリポジトリを作成するとき、{ ### 参考リンク -- [リポジトリのデフォルトブランチ名を管理する](/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories) +- /github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md index 3e2bd0ef95db..5a636869c9c8 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md @@ -6,7 +6,7 @@ redirect_from: - /articles/managing-the-display-of-member-names-in-your-organization versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- Organization のオーナーは、Organization 内のメンバー名表示を管理できます。 diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization.md index e4458cc511f5..915986401c88 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization.md @@ -1,6 +1,6 @@ --- title: Organization のフォークポリシーを管理する -intro: 'Organization が所有するプライベート{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}および内部{% endif %}リポジトリのフォークを許可または禁止できます。' +intro: 'You can can allow or prevent the forking of any private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and internal{% endif %} repositories owned by your organization.' redirect_from: - /articles/allowing-people-to-fork-private-repositories-in-your-organization - /github/setting-up-and-managing-organizations-and-teams/allowing-people-to-fork-private-repositories-in-your-organization @@ -10,9 +10,9 @@ versions: enterprise-server: '*' --- -デフォルトでは、新しい Organization はプライベート{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}および内部{% endif %}リポジトリのフォークを禁止するように設定されます。 +By default, new organizations are configured to disallow the forking of private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and internal{% endif %} repositories. -Organization レベルでプライベート{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} および内部{% endif %}リポジトリのフォークを許可する場合は、特定のプライベート{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}または内部{% endif %}リポジトリをフォークする機能も設定することができます。 詳細は「[リポジトリのフォークポリシーを管理する](/github/administering-a-repository/managing-the-forking-policy-for-your-repository)」を参照してください。 +If you allow forking of private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and internal{% endif %} repositories at the organization level, you can also configure the ability to fork a specific private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %} repository. 詳細は「[リポジトリのフォークポリシーを管理する](/github/administering-a-repository/managing-the-forking-policy-for-your-repository)」を参照してください。 {% data reusables.organizations.internal-repos-enterprise %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md index e7fa04038802..3c53fae9b500 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md @@ -6,12 +6,12 @@ redirect_from: - /articles/managing-your-organizations-ssh-certificate-authorities versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- Organizationのオーナーは、OrganizationのSSH認証局 (CAN) を管理できます。 -SSH CAをOrganizationに追加すると、メンバーはあなたが提供したSSH証明書を使用してOrganizationにアクセスできるようになります。 {% data reusables.organizations.can-require-ssh-cert %}詳細については、「[SSL認証局について](/articles/about-ssh-certificate-authorities)」を参照してください。 +SSH CAをOrganizationに追加すると、メンバーはあなたが提供したSSH証明書を使用してOrganizationにアクセスできるようになります。 {% data reusables.organizations.can-require-ssh-cert %}詳細については、「[SSS認証局について](/articles/about-ssh-certificate-authorities)」を参照してください。 ### SSH 認証局を追加する diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/migrating-admin-teams-to-improved-organization-permissions.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/migrating-admin-teams-to-improved-organization-permissions.md index 470ed98b6c8f..bb180c4fdb28 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/migrating-admin-teams-to-improved-organization-permissions.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/migrating-admin-teams-to-improved-organization-permissions.md @@ -1,6 +1,6 @@ --- title: 管理者 Team を改善された Organization の権限に移行する -intro: 2015 年 9 月以降に作成された Organization の場合、Organization の権限モデルはデフォルトで改善されています。 2015 年 9 月より前に作成された Organization は、古いオーナーおよび管理者 Team から、改善された権限モデルに移行する必要があるかもしれません。 レガシーの管理者 Team は、改善された Organization 権限モデルに移行するまで、リポジトリの作成資格を自動的に維持します。 +intro: '2015 年 9 月以降に作成された Organization の場合、Organization の権限モデルはデフォルトで改善されています。 2015 年 9 月より前に作成された Organization は、古いオーナーおよび管理者 Team から、改善された権限モデルに移行する必要があるかもしれません。 レガシーの管理者 Team は、改善された Organization 権限モデルに移行するまで、リポジトリの作成資格を自動的に維持します。' redirect_from: - /articles/migrating-your-previous-admin-teams-to-the-improved-organization-permissions/ - /articles/migrating-admin-teams-to-improved-organization-permissions diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/migrating-to-improved-organization-permissions.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/migrating-to-improved-organization-permissions.md index cca1a880f4ea..7d5d29fc9d35 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/migrating-to-improved-organization-permissions.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/migrating-to-improved-organization-permissions.md @@ -1,6 +1,6 @@ --- title: 改善された Organization の権限に移行する -intro: 2015 年 9 月以降に作成された Organization の場合、Organization の権限モデルはデフォルトで改善されています。 2015 年 9 月より前に作成された Organization は、古いオーナーおよび管理者 Team から、改善された Organization の権限モデルに移行する必要があるかもしれません。 +intro: '2015 年 9 月以降に作成された Organization の場合、Organization の権限モデルはデフォルトで改善されています。 2015 年 9 月より前に作成された Organization は、古いオーナーおよび管理者 Team から、改善された Organization の権限モデルに移行する必要があるかもしれません。' mapTopic: true redirect_from: - /articles/improved-organization-permissions/ diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/moving-a-team-in-your-organizations-hierarchy.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/moving-a-team-in-your-organizations-hierarchy.md index 75adaf50e49c..803708e2badb 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/moving-a-team-in-your-organizations-hierarchy.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/moving-a-team-in-your-organizations-hierarchy.md @@ -1,6 +1,6 @@ --- title: Organization 階層内で Team を移動する -intro: チームメンテナと Organization のオーナーは、親チームの下に Team を入れ子にしたり、ネストした入れ子チームの親を変更または削除したりすることができます。 +intro: 'チームメンテナと Organization のオーナーは、親チームの下に Team を入れ子にしたり、ネストした入れ子チームの親を変更または削除したりすることができます。' redirect_from: - /articles/changing-a-team-s-parent/ - /articles/moving-a-team-in-your-organization-s-hierarchy diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md index d321c4d4cad5..fd8450304d50 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md @@ -11,7 +11,7 @@ versions: ### Organization の権限レベル -Organization のメンバーは、*owner (オーナー)*{% if currentVersion == "free-pro-team@latest" %}、*billing manager (支払いマネージャー)*、{% endif %}あるいは *member (メンバー)* ロールを持つことができます。 +Organization members can have *owner*{% if currentVersion == "free-pro-team@latest" %}, *billing manager*,{% endif %} or *member* roles: - **オーナー**は、Organization について完全な管理アクセスを持ちます。 このロールは制限する必要がありますが、Organization で少なくとも 2 人は指定する必要があります。 詳細は、「[Organization の所有権の継続性を管理する](/github/setting-up-and-managing-organizations-and-teams/maintaining-ownership-continuity-for-your-organization)」を参照してください。 {% if currentVersion == "free-pro-team@latest" %} @@ -22,94 +22,95 @@ Organization のメンバーは、*owner (オーナー)*{% if currentVersion == {% if currentVersion == "free-pro-team@latest" %} -| Organization のアクション | オーナー | メンバー | 支払いマネージャー | -|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-----:|:-----:|:----------------------------------:| -| リポジトリの作成 (詳細については「[Organization 内でリポジトリの作成を制限する](/articles/restricting-repository-creation-in-your-organization)」を参照) | **X** | **X** | | -| 支払い情報を表示および編集する | **X** | | **X** | -| Organization に参加するようユーザを招待する | **X** | | | -| Organization に参加する招待を編集およびキャンセルする | **X** | | | -| Organization からメンバーを削除する | **X** | | | -| 以前のメンバーを Oraganization に復帰させる | **X** | | | -| **すべての Team** に対してユーザーを追加および削除する | **X** | | | -| Organization メンバーを*チームメンテナ*に昇格させる | **X** | | | -| コードレビューの割り当てを設定する ([「Team のコードレビューの割り当てを管理する」](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)を参照) | **X** | | | -| スケジュールされたリマインダーを設定する (「[プルリクエストのスケジュールされたリマインダーを管理する](/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests)」を参照) | **X** | | | -| **すべてのリポジトリに**コラボレーターを追加する | **X** | | | -| Organization 参加ログにアクセスする | **X** | | | -| Organization のプロフィールページを変更する (詳細は「[Organization のプロフィールについて](/articles/about-your-organization-s-profile)」を参照) | **X** | | | -| Organization のドメインを検証する (詳細は「[Organization のドメインを検証する](/articles/verifying-your-organization-s-domain)」を参照) | **X** | | | -| **すべての Team** を削除する | **X** | | | -| すべてのリポジトリを含めて Organization のアカウントを削除する | **X** | | | -| Team を作成する (詳細は「[Organization のチーム作成権限を設定する](/articles/setting-team-creation-permissions-in-your-organization)」を参照) | **X** | **X** | | -| [Organization の階層で Team を移動する](/articles/moving-a-team-in-your-organization-s-hierarchy) | **X** | | | -| プロジェクトボードを作成する (詳細は「[Organization のプロジェクトボード権限](/articles/project-board-permissions-for-an-oganization)」を参照) | **X** | **X** | | -| Organization の全メンバーおよび Team の表示 | **X** | **X** | | -| 参照可能なチームへの @メンション | **X** | **X** | | -| *チームメンテナ*に指定できる | **X** | **X** | | -| Organization のインサイトを表示する (詳細は「[Organization のインサイトを表示する](/articles/viewing-insights-for-your-organization)」を参照) | **X** | **X** | | -| パブリック Team のディスカッションを表示し、**すべての Team** に投稿する (詳細は「[Team ディスカッションについて](/articles/about-team-discussions)」を参照) | **X** | **X** | | -| プライベート Team のディスカッションを表示し、**すべての Team** に投稿する (詳細は「[Team ディスカッションについて](/articles/about-team-discussions)」を参照) | **X** | | | -| **すべての Team** で Team ディスカッションを編集および削除する (詳細は「[混乱を生むコメントを管理する](/articles/managing-disruptive-comments)」を参照) | **X** | | | -| コミット、プルリクエスト、Issue についてコメントを非表示にする (詳細は「[混乱を生むコメントを管理する](/articles/managing-disruptive-comments)」を参照) | **X** | **X** | | -| Organization の Team ディスカッションを無効にする (詳細は「[Organization の Team ディスカッションを無効化する](/articles/disabling-team-discussions-for-your-organization)」を参照) | **X** | | |{% if currentVersion == "free-pro-team@latest" %} -| Organization dependency insights の可視性を管理する (詳細は「[Organization dependency insights の可視性を変更する](/articles/changing-the-visibility-of-your-organizations-dependency-insights)」を参照) | **X** | | |{% endif %} -| **すべての Team** で Team プロフィール画像を設定する (詳細は「[Team のプロフィール画像を設定する](/articles/setting-your-team-s-profile-picture)」を参照) | **X** | | | -| Disable publication of {% data variables.product.prodname_pages %} sites from repositories in the organization (see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)" for details) | **X** | | | -| Organization のセキュリティおよび分析設定を管理する (詳細は「[Organization のセキュリティおよび分析設定を管理する](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization)」を参照) | **X** | | | -| [SAML シングルサインオン](/articles/about-identity-and-access-management-with-saml-single-sign-on)を有効にして強制する | **X** | | | -| [組織へのユーザーの SAML アクセスを管理する](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization) | **X** | | | -| Organization の SSH 認証局を管理する (詳細は「[Organization の SSH 認証局を管理する](/articles/managing-your-organizations-ssh-certificate-authorities)」を参照) | **X** | | | -| リポジトリを移譲する | **X** | | | -| {% data variables.product.prodname_marketplace %} アプリケーションを購入、インストール、支払い管理、キャンセルする | **X** | | | -| {% data variables.product.prodname_marketplace %} のアプリケーションをリストする | **X** | | | -| Organization のリポジトリすべてについて、脆弱な依存関係についての [{% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) アラートを受け取る | **X** | | | -| {% data variables.product.prodname_dependabot_security_updates %} の管理 (「[{% data variables.product.prodname_dependabot_security_updates %} の設定](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)」を参照) | **X** | | | -| [フォークポリシーの管理](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization) | **X** | | | -| [Organization のパブリックリポジトリでのアクティビティを制限する](/articles/limiting-interactions-in-your-organization) | **X** | | | -| Organization にある*すべてのリポジトリ*のプル (読み取り)、プッシュ (書き込み)、クローン作成 (コピー) | **X** | | | -| Organization メンバーの[外部コラボレーター](#outside-collaborators)への変換 | **X** | | | -| [Organization リポジトリへのアクセス権がある人を表示する](/articles/viewing-people-with-access-to-your-repository) | **X** | | | -| [Organization リポジトリへのアクセス権がある人のリストをエクスポートする](/articles/viewing-people-with-access-to-your-repository/#exporting-a-list-of-people-with-access-to-your-repository) | **X** | | | -| デフォルトラベルの管理 (「[Organization 内のリポジトリのためのデフォルトラベルを管理する](/articles/managing-default-labels-for-repositories-in-your-organization)」を参照) | **X** | | | -| Team の同期を有効化する (「[Organization の Team 同期を管理する](/github/setting-up-and-managing-organizations-and-teams/managing-team-synchronization-for-your-organization)」を参照) | **X** | | | +| Organization のアクション | オーナー | メンバー | 支払いマネージャー | +|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-----:|:-----:|:--------------------------------------------------:| +| リポジトリの作成 (詳細については「[Organization 内でリポジトリの作成を制限する](/articles/restricting-repository-creation-in-your-organization)」を参照) | **X** | **X** | | +| 支払い情報を表示および編集する | **X** | | **X** | +| Organization に参加するようユーザを招待する | **X** | | | +| Organization に参加する招待を編集およびキャンセルする | **X** | | | +| Organization からメンバーを削除する | **X** | | | +| 以前のメンバーを Oraganization に復帰させる | **X** | | | +| **すべての Team** に対してユーザーを追加および削除する | **X** | | | +| Organization メンバーを*チームメンテナ*に昇格させる | **X** | | | +| コードレビューの割り当てを設定する ([「Team のコードレビューの割り当てを管理する」](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)を参照) | **X** | | | +| スケジュールされたリマインダーを設定する (「[プルリクエストのスケジュールされたリマインダーを管理する](/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests)」を参照) | **X** | | | +| **すべてのリポジトリに**コラボレーターを追加する | **X** | | | +| Organization 参加ログにアクセスする | **X** | | | +| Organization のプロフィールページを変更する (詳細は「[Organization のプロフィールについて](/articles/about-your-organization-s-profile)」を参照) | **X** | | | +| Organization のドメインを検証する (詳細は「[Organization のドメインを検証する](/articles/verifying-your-organization-s-domain)」を参照) | **X** | | | +| **すべての Team** を削除する | **X** | | | +| すべてのリポジトリを含めて Organization のアカウントを削除する | **X** | | | +| Team を作成する (詳細は「[Organization のチーム作成権限を設定する](/articles/setting-team-creation-permissions-in-your-organization)」を参照) | **X** | **X** | | +| [Organization の階層で Team を移動する](/articles/moving-a-team-in-your-organization-s-hierarchy) | **X** | | | +| プロジェクトボードを作成する (詳細は「[Organization のプロジェクトボード権限](/articles/project-board-permissions-for-an-oganization)」を参照) | **X** | **X** | | +| Organization の全メンバーおよび Team の表示 | **X** | **X** | | +| 参照可能なチームへの @メンション | **X** | **X** | | +| *チームメンテナ*に指定できる | **X** | **X** | | +| Organization のインサイトを表示する (詳細は「[Organization のインサイトを表示する](/articles/viewing-insights-for-your-organization)」を参照) | **X** | **X** | | +| パブリック Team のディスカッションを表示し、**すべての Team** に投稿する (詳細は「[Team ディスカッションについて](/articles/about-team-discussions)」を参照) | **X** | **X** | | +| プライベート Team のディスカッションを表示し、**すべての Team** に投稿する (詳細は「[Team ディスカッションについて](/articles/about-team-discussions)」を参照) | **X** | | | +| **すべての Team** で Team ディスカッションを編集および削除する (詳細は「[混乱を生むコメントを管理する](/articles/managing-disruptive-comments)」を参照) | **X** | | | +| コミット、プルリクエスト、Issue についてコメントを非表示にする (詳細は「[混乱を生むコメントを管理する](/articles/managing-disruptive-comments)」を参照) | **X** | **X** | | +| Organization の Team ディスカッションを無効にする (詳細は「[Organization の Team ディスカッションを無効化する](/articles/disabling-team-discussions-for-your-organization)」を参照) | **X** | | |{% if currentVersion == "free-pro-team@latest" %} +| Organization dependency insights の可視性を管理する (詳細は「[Organization dependency insights の可視性を変更する](/articles/changing-the-visibility-of-your-organizations-dependency-insights)」を参照) | **X** | | |{% endif %} +| **すべての Team** で Team プロフィール画像を設定する (詳細は「[Team のプロフィール画像を設定する](/articles/setting-your-team-s-profile-picture)」を参照) | **X** | | | +| Disable publication of {% data variables.product.prodname_pages %} sites from repositories in the organization (see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)" for details) | **X** | | | +| Organization のセキュリティおよび分析設定を管理する (詳細は「[Organization のセキュリティおよび分析設定を管理する](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization)」を参照) | **X** | | | +| [SAML シングルサインオン](/articles/about-identity-and-access-management-with-saml-single-sign-on)を有効にして強制する | **X** | | | +| [組織へのユーザーの SAML アクセスを管理する](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization) | **X** | | | +| Organization の SSH 認証局を管理する (詳細は「[Organization の SSH 認証局を管理する](/articles/managing-your-organizations-ssh-certificate-authorities)」を参照) | **X** | | | +| リポジトリを移譲する | **X** | | | +| {% data variables.product.prodname_marketplace %} アプリケーションを購入、インストール、支払い管理、キャンセルする | **X** | | | +| {% data variables.product.prodname_marketplace %} のアプリケーションをリストする | **X** | | | +| Organization のリポジトリすべてについて、脆弱な依存関係についての [{% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) アラートを受け取る | **X** | | | +| {% data variables.product.prodname_dependabot_security_updates %} の管理 (「[{% data variables.product.prodname_dependabot_security_updates %} の設定](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)」を参照) | **X** | | | +| [フォークポリシーの管理](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization) | **X** | | | +| [Organization のパブリックリポジトリでのアクティビティを制限する](/articles/limiting-interactions-in-your-organization) | **X** | | | +| Organization にある*すべてのリポジトリ*のプル (読み取り)、プッシュ (書き込み)、クローン作成 (コピー) | **X** | | | +| Organization メンバーの[外部コラボレーター](#outside-collaborators)への変換 | **X** | | | +| [Organization リポジトリへのアクセス権がある人を表示する](/articles/viewing-people-with-access-to-your-repository) | **X** | | | +| [Organization リポジトリへのアクセス権がある人のリストをエクスポートする](/articles/viewing-people-with-access-to-your-repository/#exporting-a-list-of-people-with-access-to-your-repository) | **X** | | | +| Manage the default branch name (see "[Managing the default branch name for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization)") | **X** | | | +| デフォルトラベルの管理 (「[Organization 内のリポジトリのためのデフォルトラベルを管理する](/articles/managing-default-labels-for-repositories-in-your-organization)」を参照) | **X** | | | +| Team の同期を有効化する (「[Organization の Team 同期を管理する](/github/setting-up-and-managing-organizations-and-teams/managing-team-synchronization-for-your-organization)」を参照) | **X** | | | {% else %} -| Organization のアクション | オーナー | メンバー | -|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-----:|:---------------------------------------:| -| Organization に参加するようユーザを招待する | **X** | | -| Organization に参加する招待を編集およびキャンセルする | **X** | | -| Organization からメンバーを削除する | **X** | | | -| 以前のメンバーを Oraganization に復帰させる | **X** | | | -| **すべての Team** に対してユーザーを追加および削除する | **X** | | -| Organization メンバーを*チームメンテナ*に昇格させる | **X** | |{% if currentVersion ver_gt "enterprise-server@2.19" %} -| コードレビューの割り当てを設定する ([「Team のコードレビューの割り当てを管理する」](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)を参照) | **X** | |{% endif %} -| **すべてのリポジトリに**コラボレーターを追加する | **X** | | -| Organization 参加ログにアクセスする | **X** | | -| Organization のプロフィールページを変更する (詳細は「[Organization のプロフィールについて](/articles/about-your-organization-s-profile)」を参照) | **X** | | | -| **すべての Team** を削除する | **X** | | -| すべてのリポジトリを含めて Organization のアカウントを削除する | **X** | | -| Team を作成する (詳細は「[Organization のチーム作成権限を設定する](/articles/setting-team-creation-permissions-in-your-organization)」を参照) | **X** | **X** | -| Organization の全メンバーおよび Team の表示 | **X** | **X** | -| 参照可能なチームへの @メンション | **X** | **X** | -| *チームメンテナ*に指定できる | **X** | **X** | -| リポジトリを移譲する | **X** | |{% if currentVersion ver_gt "enterprise-server@2.18" %} -| Organization の SSH 認証局を管理する (詳細は「[Organization の SSH 認証局を管理する](/articles/managing-your-organizations-ssh-certificate-authorities)」を参照) | **X** | |{% endif %} -| プロジェクトボードを作成する (詳細は「[Organization のプロジェクトボード権限](/articles/project-board-permissions-for-an-oganization)」を参照) | **X** | **X** | | -| パブリック Team のディスカッションを表示し、**すべての Team** に投稿する (詳細は「[Team ディスカッションについて](/articles/about-team-discussions)」を参照) | **X** | **X** | | -| プライベート Team のディスカッションを表示し、**すべての Team** に投稿する (詳細は「[Team ディスカッションについて](/articles/about-team-discussions)」を参照) | **X** | | | -| **すべての Team** で Team ディスカッションを編集および削除する (「[混乱を生むコメントを管理する](/articles/managing-disruptive-comments)」を参照) | **X** | | | -| コミット、プルリクエスト、Issue についてコメントを非表示にする (詳細は「[混乱を生むコメントを管理する](/articles/managing-disruptive-comments)」を参照) | **X** | **X** | **X** | -| Organization の Team ディスカッションを無効にする (詳細は「[Organization の Team ディスカッションを無効化する](/articles/disabling-team-discussions-for-your-organization)」を参照) | **X** | | | -| **すべての Team** で Team プロフィール画像を設定する (詳細は「[Team のプロフィール画像を設定する](/articles/setting-your-team-s-profile-picture)」を参照) | **X** | | |{% if currentVersion ver_gt "enterprise-server@2.22" %} -| Disable publication of {% data variables.product.prodname_pages %} sites from repositories in the organization (see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)" for details) | **X** | | |{% endif %} -| [Organization の階層で Team を移動する](/articles/moving-a-team-in-your-organization-s-hierarchy) | **X** | | | -| Organization にある*すべてのリポジトリ*のプル (読み取り)、プッシュ (書き込み)、クローン作成 (コピー) | **X** | | -| Organization メンバーの[外部コラボレーター](#outside-collaborators)への変換 | **X** | | -| [Organization リポジトリへのアクセス権がある人を表示する](/articles/viewing-people-with-access-to-your-repository) | **X** | | -| [Organization リポジトリへのアクセス権がある人のリストをエクスポートする](/articles/viewing-people-with-access-to-your-repository/#exporting-a-list-of-people-with-access-to-your-repository) | **X** | |{% if currentVersion ver_gt "enterprise-server@2.19" %} -| デフォルトラベルの管理 (「[Organization 内のリポジトリのためのデフォルトラベルを管理する](/articles/managing-default-labels-for-repositories-in-your-organization)」を参照) | **X** | |{% endif %} +| Organization のアクション | オーナー | メンバー | +|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-----:|:-----------------------------------------------------------:| +| Organization に参加するようユーザを招待する | **X** | | +| Organization に参加する招待を編集およびキャンセルする | **X** | | +| Organization からメンバーを削除する | **X** | | | +| 以前のメンバーを Oraganization に復帰させる | **X** | | | +| **すべての Team** に対してユーザーを追加および削除する | **X** | | +| Organization メンバーを*チームメンテナ*に昇格させる | **X** | |{% if currentVersion ver_gt "enterprise-server@2.19" %} +| コードレビューの割り当てを設定する ([「Team のコードレビューの割り当てを管理する」](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)を参照) | **X** | |{% endif %} +| **すべてのリポジトリに**コラボレーターを追加する | **X** | | +| Organization 参加ログにアクセスする | **X** | | +| Organization のプロフィールページを変更する (詳細は「[Organization のプロフィールについて](/articles/about-your-organization-s-profile)」を参照) | **X** | | | +| **すべての Team** を削除する | **X** | | +| すべてのリポジトリを含めて Organization のアカウントを削除する | **X** | | +| Team を作成する (詳細は「[Organization のチーム作成権限を設定する](/articles/setting-team-creation-permissions-in-your-organization)」を参照) | **X** | **X** | +| Organization の全メンバーおよび Team の表示 | **X** | **X** | +| 参照可能なチームへの @メンション | **X** | **X** | +| *チームメンテナ*に指定できる | **X** | **X** | +| リポジトリを移譲する | **X** | | +| Organization の SSH 認証局を管理する (詳細は「[Organization の SSH 認証局を管理する](/articles/managing-your-organizations-ssh-certificate-authorities)」を参照) | **X** | | +| プロジェクトボードを作成する (詳細は「[Organization のプロジェクトボード権限](/articles/project-board-permissions-for-an-oganization)」を参照) | **X** | **X** | | +| パブリック Team のディスカッションを表示し、**すべての Team** に投稿する (詳細は「[Team ディスカッションについて](/articles/about-team-discussions)」を参照) | **X** | **X** | | +| プライベート Team のディスカッションを表示し、**すべての Team** に投稿する (詳細は「[Team ディスカッションについて](/articles/about-team-discussions)」を参照) | **X** | | | +| **すべての Team** で Team ディスカッションを編集および削除する (「[混乱を生むコメントを管理する](/articles/managing-disruptive-comments)」を参照) | **X** | | | +| コミット、プルリクエスト、Issue についてコメントを非表示にする (詳細は「[混乱を生むコメントを管理する](/articles/managing-disruptive-comments)」を参照) | **X** | **X** | **X** | +| Organization の Team ディスカッションを無効にする (詳細は「[Organization の Team ディスカッションを無効化する](/articles/disabling-team-discussions-for-your-organization)」を参照) | **X** | | | +| **すべての Team** で Team プロフィール画像を設定する (詳細は「[Team のプロフィール画像を設定する](/articles/setting-your-team-s-profile-picture)」を参照) | **X** | | |{% if currentVersion ver_gt "enterprise-server@2.22" %} +| Disable publication of {% data variables.product.prodname_pages %} sites from repositories in the organization (see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)" for details) | **X** | | |{% endif %} +| [Organization の階層で Team を移動する](/articles/moving-a-team-in-your-organization-s-hierarchy) | **X** | | | +| Organization にある*すべてのリポジトリ*のプル (読み取り)、プッシュ (書き込み)、クローン作成 (コピー) | **X** | | +| Organization メンバーの[外部コラボレーター](#outside-collaborators)への変換 | **X** | | +| [Organization リポジトリへのアクセス権がある人を表示する](/articles/viewing-people-with-access-to-your-repository) | **X** | | +| [Organization リポジトリへのアクセス権がある人のリストをエクスポートする](/articles/viewing-people-with-access-to-your-repository/#exporting-a-list-of-people-with-access-to-your-repository) | **X** | |{% if currentVersion ver_gt "enterprise-server@2.19" %} +| デフォルトラベルの管理 (「[Organization 内のリポジトリのためのデフォルトラベルを管理する](/articles/managing-default-labels-for-repositories-in-your-organization)」を参照) | **X** | |{% endif %} {% endif %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-enforce-saml-single-sign-on-in-your-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-enforce-saml-single-sign-on-in-your-organization.md index 773771c0d45a..98a0e41af923 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-enforce-saml-single-sign-on-in-your-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-enforce-saml-single-sign-on-in-your-organization.md @@ -1,6 +1,6 @@ --- title: Organization での SAML シングルサインオンの強制を準備する -intro: Organization で SAML シングルサインオンを強制する前に、Organization のメンバーシップを検証し、アイデンティティプロバイダへの接続文字列を設定する必要があります。 +intro: 'Organization で SAML シングルサインオンを強制する前に、Organization のメンバーシップを検証し、アイデンティティプロバイダへの接続文字列を設定する必要があります。' product: '{% data reusables.gated-features.saml-sso %}' redirect_from: - /articles/preparing-to-enforce-saml-single-sign-on-in-your-organization diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-require-two-factor-authentication-in-your-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-require-two-factor-authentication-in-your-organization.md index af55b80801b3..170da0c08dbb 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-require-two-factor-authentication-in-your-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-require-two-factor-authentication-in-your-organization.md @@ -1,6 +1,6 @@ --- title: Organization で 2 要素認証の義務化を準備する -intro: 2 要素認証を義務化する前に、予定されている変更についてユーザに通知し、どのユーザーが 2 要素認証をすでに使用しているかを確認することができます。 +intro: '2 要素認証を義務化する前に、予定されている変更についてユーザに通知し、どのユーザーが 2 要素認証をすでに使用しているかを確認することができます。' redirect_from: - /articles/preparing-to-require-two-factor-authentication-in-your-organization versions: @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -Organization で 2 要素認証を義務付ける 1 週間以上前に、{% if currentVersion == "free-pro-team@latest" %}Organization のメンバー、外部コラボレーター、支払いマネージャー {% else %}Organization のメンバーと外部コラボレーター{% endif %}に通知することをおすすめします。 +We recommend that you notify {% if currentVersion == "free-pro-team@latest" %}organization members, outside collaborators, and billing managers{% else %}organization members and outside collaborators{% endif %} at least one week before you require 2FA in your organization. Organization で 2 要素認証を必須にすると、2 要素認証を使わないメンバー、外部コラボレーター、および支払いマネージャー (ボットアカウントを含む) は Organization から削除され、そのリポジトリにアクセスできなくなります。 Organization のプライベートリポジトリのフォークへのアクセスも失います。 diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/project-board-permissions-for-an-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/project-board-permissions-for-an-organization.md index 492eb7389504..0fc6520ea346 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/project-board-permissions-for-an-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/project-board-permissions-for-an-organization.md @@ -1,6 +1,6 @@ --- title: Organization のプロジェクトボード権限 -intro: Organization のオーナーと、プロジェクトボード管理者権限を持つユーザーは、Organization のプロジェクトボードに対する読み取り、書き込み、管理の各権限を誰が持つかをカスタマイズすることができます。 +intro: 'Organization のオーナーと、プロジェクトボード管理者権限を持つユーザーは、Organization のプロジェクトボードに対する読み取り、書き込み、管理の各権限を誰が持つかをカスタマイズすることができます。' redirect_from: - /articles/project-board-permissions-for-an-organization versions: diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-member-of-your-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-member-of-your-organization.md index 87076c498a7d..09502c756cbc 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-member-of-your-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-member-of-your-organization.md @@ -1,6 +1,6 @@ --- title: Oraganization の以前のメンバーを復帰させる -intro: 'Organizationのオーナーは{% if currentVersion == "free-pro-team@latest" %}Oraganization の以前のメンバーを招待して Oraganization に復帰させて{% else %}以前のメンバーを Oraganization に追加して{% endif%}、その個人の以前のロール、アクセス権、フォーク、設定をリストアするかどうかを選択することができます。' +intro: 'Organization owners can {% if currentVersion == "free-pro-team@latest" %}invite former organization members to rejoin{% else %}add former members to{% endif%} your organization, and choose whether to restore the person''s former role, access permissions, forks, and settings.' redirect_from: - /articles/reinstating-a-former-member-of-your-organization versions: @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -[ユーザを Organization から削除する](/articles/removing-a-member-from-your-organization)場合、[Organization のメンバーを外部のコラボレータに変換する](/articles/converting-an-organization-member-to-an-outside-collaborator)場合、または[メンバーと外部のコラボレータに 2要素認証（2FA）を有効化するよう要求](/articles/requiring-two-factor-authentication-in-your-organization)したためにユーザが Organization から削除される場合、そのユーザのアクセス権限と設定は 3 か月間保存されます。 そのタイムフレーム内にユーザを Organization へ再度{% if currentVersion =="free-pro-team@latest" %}招待{% else %}追加{% endif %}した場合、そのユーザの権限をリストアできます。 +[ユーザを Organization から削除する](/articles/removing-a-member-from-your-organization)場合、[Organization のメンバーを外部のコラボレータに変換する](/articles/converting-an-organization-member-to-an-outside-collaborator)場合、または[メンバーと外部のコラボレータに 2要素認証（2FA）を有効化するよう要求](/articles/requiring-two-factor-authentication-in-your-organization)したためにユーザが Organization から削除される場合、そのユーザのアクセス権限と設定は 3 か月間保存されます。 You can restore the user's privileges if you {% if currentVersion =="free-pro-team@latest" %}invite{% else %}add{% endif %} them back to the organization within that time frame. {% data reusables.two_fa.send-invite-to-reinstate-user-before-2fa-is-enabled %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-outside-collaborators-access-to-your-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-outside-collaborators-access-to-your-organization.md index 7837356af0f1..90f63f350be0 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-outside-collaborators-access-to-your-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-outside-collaborators-access-to-your-organization.md @@ -1,6 +1,6 @@ --- -title: 以前の外部のコラボレータの Organization へのアクセスを復帰させる -intro: Organization で 2 要素認証を要求しており、外部コラボレーターが 2 要素認証を有効化していないために Organization から削除された場合、以前の外部コラボレーターの Organization リポジトリへのアクセス権、フォーク、設定を復帰させることができます。 +title: Reinstating a former outside collaborator's access to your organization +intro: 'If you required two-factor authentication in your organization and an outside collaborator was removed from the organization for not having 2FA enabled, you can reinstate a former outside collaborator''s access permissions for organization repositories, forks, and settings.' redirect_from: - /articles/reinstating-a-former-outside-collaborator-s-access-to-your-organization - /articles/reinstating-a-former-outside-collaborators-access-to-your-organization @@ -9,25 +9,25 @@ versions: enterprise-server: '*' --- -[メンバーと外部コラボレーターに 2 要素認証を有効化するよう要求](/articles/requiring-two-factor-authentication-in-your-organization)したために Organization のプライベートリポジトリへの 外部コラボレーターのアクセスが削除される場合、そのユーザのアクセス権限と設定は 3 か月間保存されます。 そのタイムフレーム内にユーザを Organization へ再度{% if currentVersion == "free-pro-team@latest" %}招待{% else %}追加{% endif %}した場合、そのユーザの権限をリストアできます。 +If an outside collaborator's access to your organization's private repositories is removed because you've [required members and outside collaborators to enable two-factor authentication](/articles/requiring-two-factor-authentication-in-your-organization), the user's access privileges and settings are saved for three months. You can restore the user's privileges if you {% if currentVersion == "free-pro-team@latest" %}invite{% else %}add{% endif %} them back to the organization within that time frame. {% data reusables.two_fa.send-invite-to-reinstate-user-before-2fa-is-enabled %} -以前の外部コラボレーターを復帰させると、次のことがリストアできます: - - ユーザの Organization リポジトリへの以前のアクセス - - Organization が所有しているリポジトリのあらゆるプライベートフォーク - - Organization のチームでのメンバーシップ - - Organization のリポジトリへの以前のアクセスと権限 - - Organization リポジトリでの Star - - Organization での Issue 割り当て - - リポジトリプラン (リポジトリのアクティビティを Watch するか Watch しないか無視するかについての通知設定) +When you reinstate a former outside collaborator, you can restore: + - The user's former access to organization repositories + - Any private forks of repositories owned by the organization + - Membership in the organization's teams + - Previous access and permissions for the organization's repositories + - Stars for organization repositories + - Issue assignments in the organization + - Repository subscriptions (notification settings for watching, not watching, or ignoring a repository's activity) {% tip %} **Tips**: - - 外部コラボレーターの Organization へのアクセスを復帰させることができるのは、Organization のオーナーだけです。 詳細は「[Organization の権限レベル](/articles/permission-levels-for-an-organization)」を参照してください。 - - {% data variables.product.product_location %} のメンバー復帰フローでは、外部コラボレーターの復帰を説明するために「メンバー」という用語を使用することがありますが、この個人を復帰させて以前の権限を保持しても、付与されるのはその[外部コラボレーターの以前の権限](/articles/permission-levels-for-an-organization/#outside-collaborators)のみです。{% if currentVersion == "free-pro-team@latest" %} - - Organization がユーザ単位の有料プランである場合、新しいメンバーを招待して参加させる、または Organization の以前のメンバーを復帰させる前に、そのためのライセンスが用意されている必要があります。 詳しい情報については、「[ユーザごとの価格付けについて](/articles/about-per-user-pricing)」を参照してください。{% endif %} + - Only organization owners can reinstate outside collaborators' access to an organization. For more information, see "[Permission levels for an organization](/articles/permission-levels-for-an-organization)." + - The reinstating a member flow on {% data variables.product.product_location %} may use the term "member" to describe reinstating an outside collaborator but if you reinstate this person and keep their previous privileges, they will only have their previous [outside collaborator permissions](/articles/permission-levels-for-an-organization/#outside-collaborators).{% if currentVersion == "free-pro-team@latest" %} + - If your organization has a paid per-user subscription, an unused license must be available before you can invite a new member to join the organization or reinstate a former organization member. For more information, see "[About per-user pricing](/articles/about-per-user-pricing)."{% endif %} {% endtip %} @@ -37,35 +37,37 @@ versions: {% data reusables.organizations.invite_member_from_people_tab %} {% data reusables.organizations.reinstate-user-type-username %} {% if currentVersion == "free-pro-team@latest" %} -6. [**Invite and reinstate**] をクリックして外部コラボレーターの Organization での以前の権限をリストアすることを選択するか、[**Invite and start fresh**] をクリックして以前の権限をクリアして新たにアクセス権を設定することを選択します。 +6. Choose to restore the outside collaborator's previous privileges in the organization by clicking **Invite and reinstate** or choose to clear their previous privileges and set new access permissions by clicking **Invite and start fresh**. {% warning %} - **警告:** 外部コラボレーターを Organization のメンバーにアップグレードする場合は、[**Invite and start fresh**] を選択して、その個人の新しいロールを選択します。 ただし、[start fresh] を選択する場合、その個人のプライベートフォークは Organization のリポジトリから失われますので、注意が必要です。 以前の外部コラボレーターを Organization のメンバーにし、*かつ*そのコラボレーターのプライベートフォークを保持するには、代わりに [**Invite and reinstate**] を選択します。 その個人が招待を承認したら、[Organization にメンバーとして参加するよう招待する](/articles/converting-an-outside-collaborator-to-an-organization-member)ことにより、その個人を Organization メンバーに変換できます。 + **Warning:** If you want to upgrade the outside collaborator to a member of your organization, then choose **Invite and start fresh** and choose a new role for this person. Note, however, that this person's private forks of your organization's repositories will be lost if you choose to start fresh. To make the former outside collaborator a member of your organization *and* keep their private forks, choose **Invite and reinstate** instead. Once this person accepts the invitation, you can convert them to an organization member by [inviting them to join the organization as a member](/articles/converting-an-outside-collaborator-to-an-organization-member). {% endwarning %} - ![設定をリストアするか否かの選択](/assets/images/help/organizations/choose_whether_to_restore_org_member_info.png) + ![Choose to restore settings or not](/assets/images/help/organizations/choose_whether_to_restore_org_member_info.png) {% else %} -6. [**Add and reinstate**] をクリックして外部のコラボレータの Organization での以前の権限をリストアすることを選択するか、[**Add and start fresh**] をクリックして以前の権限をクリアして新たにアクセス権を設定することを選択します。 +6. Choose to restore the outside collaborator's previous privileges in the organization by clicking **Add and reinstate** or choose to clear their previous privileges and set new access permissions by clicking **Add and start fresh**. {% warning %} - **警告:** 外部コラボレーターを Organization メンバーにアップグレードする場合は、[**Add and start fresh**] を選択して、その個人に新しいロールを選択してください。 ただし、[start fresh] を選択する場合、その個人のプライベートフォークは Organization のリポジトリから失われますので、注意が必要です。 以前の外部コラボレーターを Organization のメンバーにして、*かつ*そのプライベートフォークを保持するには、代わりに [**Add and reinstate**] を選択します。 それから、[Organization にメンバーとして追加する](/articles/converting-an-outside-collaborator-to-an-organization-member)ことにより、その個人を Organization メンバーに変換できます。 + **Warning:** If you want to upgrade the outside collaborator to a member of your organization, then choose **Add and start fresh** and choose a new role for this person. Note, however, that this person's private forks of your organization's repositories will be lost if you choose to start fresh. To make the former outside collaborator a member of your organization *and* keep their private forks, choose **Add and reinstate** instead. Then, you can convert them to an organization member by [adding them to the organization as a member](/articles/converting-an-outside-collaborator-to-an-organization-member). {% endwarning %} - ![設定をリストアするか否かの選択](/assets/images/help/organizations/choose_whether_to_restore_org_member_info_ghe.png) + ![Choose to restore settings or not](/assets/images/help/organizations/choose_whether_to_restore_org_member_info_ghe.png) {% endif %} {% if currentVersion == "free-pro-team@latest" %} -7. 以前の外部コラボレーターの以前の権限をクリアした場合は、そのユーザのロールを選択し、オプションでいくつかのチームに追加してから、[**Send invitation**] をクリックします。 ![ロールとTeamオプションと招待の送信ボタン](/assets/images/help/organizations/add-role-send-invitation.png) +7. If you cleared the previous privileges for a former outside collaborator, choose a role for the user and optionally add them to some teams, then click **Send invitation**. + ![Role and team options and send invitation button](/assets/images/help/organizations/add-role-send-invitation.png) {% else %} -7. 以前の外部コラボレーターの以前の権限をクリアした場合は、そのユーザのロールを選択し、オプションでいくつかのチームに追加してから、[**Add member**] をクリックします。 ![ロールと Team のオプションと [add member] ボタン](/assets/images/help/organizations/add-role-add-member.png) +7. If you cleared the previous privileges for a former outside collaborator, choose a role for the user and optionally add them to some teams, then click **Add member**. + ![Role and team options and add member button](/assets/images/help/organizations/add-role-add-member.png) {% endif %} {% if currentVersion == "free-pro-team@latest" %} -8. 招待された人物は、Organizationへの招待メールを受け取ります。 Organization で 外部コラボレーターになるには、招待を受諾する必要があります。 {% data reusables.organizations.cancel_org_invite %} +8. The invited person will receive an email inviting them to the organization. They will need to accept the invitation before becoming an outside collaborator in the organization. {% data reusables.organizations.cancel_org_invite %} {% endif %} -### 参考リンク +### Further Reading -- [Organization のリポジトリ権限レベル](/articles/repository-permission-levels-for-an-organization) +- "[Repository permission levels for an organization](/articles/repository-permission-levels-for-an-organization)" diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/removing-a-member-from-your-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/removing-a-member-from-your-organization.md index 19159ee724de..57db6c823ed3 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/removing-a-member-from-your-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/removing-a-member-from-your-organization.md @@ -1,6 +1,6 @@ --- title: Organization からメンバーを削除する -intro: Organization のメンバーが、Organization が所有するリポジトリへのアクセスを必要としなくなった場合、そのメンバーを Organization から削除することができます。 +intro: 'Organization のメンバーが、Organization が所有するリポジトリへのアクセスを必要としなくなった場合、そのメンバーを Organization から削除することができます。' redirect_from: - /articles/removing-a-member-from-your-organization versions: diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/removing-an-outside-collaborator-from-an-organization-project-board.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/removing-an-outside-collaborator-from-an-organization-project-board.md index 5d5fa4650454..824d90ae9047 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/removing-an-outside-collaborator-from-an-organization-project-board.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/removing-an-outside-collaborator-from-an-organization-project-board.md @@ -1,6 +1,6 @@ --- title: 外部コラボレーターを Organization プロジェクトボードから削除する -intro: Organization のオーナーあるいはプロジェクトボードの管理者は、外部コラボレーターのプロジェクトボードへのアクセスを削除できます。 +intro: 'Organization のオーナーあるいはプロジェクトボードの管理者は、外部コラボレーターのプロジェクトボードへのアクセスを削除できます。' redirect_from: - /articles/removing-an-outside-collaborator-from-an-organization-project-board versions: diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md index 8bdc90b10c1f..9da956c1aa82 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md @@ -24,7 +24,9 @@ versions: {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.github-apps-settings-sidebar %} -1. [{% data variables.product.prodname_github_app %}] の下で、{% data variables.product.prodname_github_app %} マネージャーを削除するアプリケーションのアバターをクリックします。 ![{% data variables.product.prodname_github_app %} を選択](/assets/images/help/organizations/select-github-app.png) +1. Under " +{% data variables.product.prodname_github_app %}s", click on the avatar of the app you'd like to remove a {% data variables.product.prodname_github_app %} manager from. +![{% data variables.product.prodname_github_app %} を選択](/assets/images/help/organizations/select-github-app.png) {% data reusables.organizations.app-managers-settings-sidebar %} 1. [App managers] の下で、{% data variables.product.prodname_github_app %} マネージャー権限を削除する個人のユーザ名を探し、 [**Revoke**] をクリックします。 ![{% data variables.product.prodname_github_app %} マネージャー権限の削除](/assets/images/help/organizations/github-app-manager-revoke-permissions-individual-app.png) diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/renaming-an-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/renaming-an-organization.md index 35e5fdc2e273..7b136409d40a 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/renaming-an-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/renaming-an-organization.md @@ -1,6 +1,6 @@ --- title: Organization の名前を変更する -intro: プロジェクトや企業の名前が変更になった場合、Organization の名前を更新して一致させることができます。 +intro: 'プロジェクトや企業の名前が変更になった場合、Organization の名前を更新して一致させることができます。' redirect_from: - /articles/what-happens-when-i-change-my-organization-s-name/ - /articles/renaming-an-organization @@ -28,7 +28,7 @@ Organization の名前を変更したら、古い Organization 名は他の個 #### 自動ではない変更 Organization の名前を変更したら、次のようになります: -- 以前の Organization プロフィールページ (`https://{% data variables.command_line.backticks %}/previousorgname` など) にリンクすると、404 エラーが返されます。 他のサイト{% if currentVersion == "free-pro-team@latest" %} (LinkedIn や Twitter のプロフィールなど) {% endif %}からの Organization へのリンクを更新するよう推奨します。 +- 以前の Organization プロフィールページ (`https://{% data variables.command_line.backticks %}/previousorgname` など) にリンクすると、404 エラーが返されます。 We recommend you update links to your organization from other sites{% if currentVersion == "free-pro-team@latest" %}, such as your LinkedIn or Twitter profiles{% endif %}. - 古い Organization 名を使用する API リクエストでは、404 エラーが返されます。 API リクエストにある古い Organization 名を更新するようおすすめします。 - 古い Organization 名を使用する Team へは、自動での [@mention](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams) リダイレクトはありません。 diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md index 4378befd9191..b6a7b126d903 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md @@ -1,6 +1,6 @@ --- title: Organization のリポジトリ権限レベル -intro: Organization の各リポジトリに対するアクセスを、権限レベルを細かく設定することによりカスタマイズできます。これにより、ユーザが必要な機能やタスクにアクセスできるようになります。 +intro: 'Organization の各リポジトリに対するアクセスを、権限レベルを細かく設定することによりカスタマイズできます。これにより、ユーザが必要な機能やタスクにアクセスできるようになります。' redirect_from: - /articles/repository-permission-levels-for-an-organization-early-access-program/ - /articles/repository-permission-levels-for-an-organization @@ -16,10 +16,10 @@ versions: Organization のメンバー、外部のコラボレータ、および Team に対して、Organization が所有するリポジトリに異なるレベルのアクセスを付与できます。 権限レベルごとに、リポジトリのコンテンツと設定へのアクセスが段階的に増加します。 プロジェクトにおける各人または各 Team のロールに相応しいレベルを選択し、プロジェクトに対して必要以上のアクセスを与えないようにしましょう。 以下のリストでは、Organization のリポジトリに対する権限レベルを、低いものから高いものに並べています: -- **Read**: プロジェクトを表示またはプロジェクトについてディスカッションしたい、コードを書かないコントリビューターにおすすめします{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -- **Triage**: 書き込みアクセスなしに、Issue やプルリクエストを積極的に 管理したいコントリビューターにおすすめします{% endif %} -- **Write**: プロジェクトに積極的にプッシュしたいコントリビューターにおすすめします{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -- **Maintain**: センシティブ、または破壊的なアクションにアクセスせずにリポジトリを管理する必要がある、プロジェクト管理者におすすめします{% endif %} +- **Read**: プロジェクトを表示またはプロジェクトについてディスカッションしたい、コードを書かないコントリビューターにおすすめします +- **Triage**: 書き込みアクセスなしに、Issue やプルリクエストを積極的に 管理したいコントリビューターにおすすめします +- **Write**: プロジェクトに積極的にプッシュしたいコントリビューターにおすすめします +- **Maintain**: センシティブ、または破壊的なアクションにアクセスせずにリポジトリを管理する必要がある、プロジェクト管理者におすすめします - **Admin**: セキュリティの管理やリポジトリの削除など、センシティブおよび破壊的なアクションを含めて、プロジェクトへの完全なアクセスが必要な人におすすめします {% if currentVersion == "free-pro-team@latest" %} @@ -41,135 +41,75 @@ Organization レベルの設定を管理することに加え、Organization の {% endwarning %} ### 各権限レベルが可能なリポジトリへのアクセス -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -| リポジトリアクション | Read | Triage | Write | Maintain | Admin | -|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-----:|:------:|:-----:|:--------:|:------------------------------------------------------------------------------------------------------------------------------------------------------------------:| -| 個人または Team の割り当てリポジトリからのプル | **X** | **X** | **X** | **X** | **X** | -| 個人または Team の割り当てリポジトリのフォーク | **X** | **X** | **X** | **X** | **X** | -| 自分のコメントの編集および削除 | **X** | **X** | **X** | **X** | **X** | -| Issue のオープン | **X** | **X** | **X** | **X** | **X** | -| 自分でオープンした Issue のクローズ | **X** | **X** | **X** | **X** | **X** | -| 自分でクローズした Issue を再オープン | **X** | **X** | **X** | **X** | **X** | -| 自分に割り当てられた Issue の取得 | **X** | **X** | **X** | **X** | **X** | -| Team の割り当てリポジトリのフォークからのプルリクエストの送信 | **X** | **X** | **X** | **X** | **X** | -| プルリクエストについてのレビューのサブミット | **X** | **X** | **X** | **X** | **X** | -| 公開済みリリースの表示 | **X** | **X** | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [[GitHub Actions workflow runs](/actions/automating-your-workflow-with-github-actions/managing-a-workflow-run)] の表示 | **X** | **X** | **X** | **X** | **X** |{% endif %} -| wiki の編集 | **X** | **X** | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [悪用あるいはスパムの可能性があるコンテンツのレポート](/articles/reporting-abuse-or-spam) | **X** | **X** | **X** | **X** | **X** |{% endif %} -| ラベルの適用 | | **X** | **X** | **X** | **X** | -| すべての Issue およびプルリクエストのクローズ、再オープン、割り当て | | **X** | **X** | **X** | **X** | -| マイルストーンの適用 | | **X** | **X** | **X** | **X** | -| [重複した Issue とプルリクエスト](/articles/about-duplicate-issues-and-pull-requests)のマーク付け | | **X** | **X** | **X** | **X** | -| [プルリクエストのレビュー](/articles/requesting-a-pull-request-review)の要求 | | **X** | **X** | **X** | **X** | -| 個人または Team の割り当てリポジトリへのプッシュ (書き込み) | | | **X** | **X** | **X** | -| コミット、プルリクエスト、Issue についての他者によるコメントの編集と削除 | | | **X** | **X** | **X** | -| [他者によるコメントの非表示](/articles/managing-disruptive-comments) | | | **X** | **X** | **X** | -| [会話のロック](/articles/locking-conversations) | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| Issue の移譲 (詳細は「[他のリポジトリへ Issue を移譲する](/articles/transferring-an-issue-to-another-repository)」を参照) | | | **X** | **X** | **X** |{% endif %} -| [リポジトリに指定されたコードオーナーとしてのアクション](/articles/about-code-owners) | | | **X** | **X** | **X** | -| [プルリクエストのドラフトに、レビューの準備ができたことを示すマークを付ける](/articles/changing-the-stage-of-a-pull-request) | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -| [プルリクエストをドラフトに変換する](/articles/changing-the-stage-of-a-pull-request) | | | **X** | **X** | **X** |{% endif %} -| プルリクエストのマージ可能性に影響するレビューのサブミット | | | **X** | **X** | **X** | -| プルリクエストに[提案された変更を適用する](/articles/incorporating-feedback-in-your-pull-request) | | | **X** | **X** | **X** | -| [ステータスチェック](/articles/about-status-checks)の作成 | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| Create, edit, run, re-run, and cancel [GitHub Actions workflows](/actions/automating-your-workflow-with-github-actions/) | | | **X** | **X** | **X** |{% endif %} -| リリースの作成と編集 | | | **X** | **X** | **X** | -| ドラフトリリースの表示 | | | **X** | **X** | **X** | -| リポジトリの説明の編集 | | | | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [View and install packages](/packages/publishing-and-managing-packages) | **X** | **X** | **X** | **X** | **X** | -| [Publish packages](/packages/publishing-and-managing-packages/publishing-a-package) | | | **X** | **X** | **X** | -| [Delete packages](/packages/publishing-and-managing-packages/deleting-a-package) | | | | | **X** |{% endif %} -| [Topics](/articles/classifying-your-repository-with-topics) の管理 | | | | **X** | **X** | -| Wiki の有効化および Wiki 編集者の制限 | | | | **X** | **X** | -| プロジェクトボードの有効化 | | | | **X** | **X** | -| [プルリクエストのマージ](/articles/configuring-pull-request-merges)の設定 | | | | **X** | **X** | -| [{% data variables.product.prodname_pages %} の公開ソース](/articles/configuring-a-publishing-source-for-github-pages)の設定 | | | | **X** | **X** | -| [保護されたブランチへのプッシュ](/articles/about-protected-branches) | | | | **X** | **X** | -| [リポジトリソーシャルカードの作成と編集](/articles/customizing-your-repositorys-social-media-preview) | | | | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [リポジトリでのインタラクション](/github/building-a-strong-community/limiting-interactions-in-your-repository)を制限する | | | | **X** | **X** |{% endif %} -| Issue の削除 (「[Issue を削除する](/articles/deleting-an-issue)」を参照) | | | | | **X** | -| 保護されたブランチでのプルリクエストのマージ（レビューの承認がなくても） | | | | | **X** | -| [リポジトリのコードオーナーの定義](/articles/about-code-owners) | | | | | **X** | -| リポジトリを Team に追加する (詳細は「[Organization リポジトリへの Team のアクセスを管理する](/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository#giving-a-team-access-to-a-repository)」を参照) | | | | | **X** | -| [外部のコラボレータのリポジトリへのアクセスの管理](/articles/adding-outside-collaborators-to-repositories-in-your-organization) | | | | | **X** | -| [リポジトリの可視性の変更](/articles/restricting-repository-visibility-changes-in-your-organization) | | | | | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| リポジトリのテンプレート化 (「[テンプレートリポジトリを作成する](/articles/creating-a-template-repository)」を参照) | | | | | **X** |{% endif %} -| リポジトリ設定の変更 | | | | | **X** | -| Team およびコラボレータのリポジトリへのアクセス管理 | | | | | **X** | -| リポジトリのデフォルトブランチ編集 | | | | | **X** | -| Webhookおよびデプロイキーの管理 | | | | | **X** |{% if currentVersion == "free-pro-team@latest" %} -| プライベートリポジトリの[依存関係グラフの有効化](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) | | | | | **X** | -| リポジトリでの[脆弱性のある依存関係に対する{% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)を受信 | | | | | **X** | -| [{% data variables.product.prodname_dependabot_alerts %} を閉じる](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository) | | | | | **X** | -| 脆弱な依存関係についての[{% data variables.product.prodname_dependabot_alerts %}を受信する個人または Team の追加指定](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository) | | | | | **X** | -| [プライベートリポジトリ用のデータ利用設定を管理する](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository) | | | | | **X** |{% endif %}{% if currentVersion == "free-pro-team@latest" %}| [セキュリティアドバイザリ](/github/managing-security-vulnerabilities/about-github-security-advisories)の作成 | | | | | **X** |{% endif %} -| [リポジトリのフォークポリシーを管理する](/github/administering-a-repository/managing-the-forking-policy-for-your-repository) | | | | | **X** | -| [リポジトリの Organization への移譲](/articles/restricting-repository-creation-in-your-organization) | | | | | **X** | -| [リポジトリの削除または Organization 外への移譲](/articles/setting-permissions-for-deleting-or-transferring-repositories) | | | | | **X** | -| [リポジトリのアーカイブ](/articles/about-archiving-repositories) | | | | | **X** |{% if currentVersion == "free-pro-team@latest" %} -| スポンサーボタンの表示 (「[リポジトリにスポンサーボタンを表示する](/articles/displaying-a-sponsor-button-in-your-repository)」を参照) | | | | | **X** |{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -| JIRA や Zendesk などの外部リソースに対する自動リンク参照を作成します (「[外部リソースを参照する自動リンクの設定](/articles/configuring-autolinks-to-reference-external-resources)」を参照)。 | | | | | **X** |{% endif %} - -{% else %} - -| リポジトリアクション | Read 権限 | Write 権限 | Admin 権限 | -|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-------:|:--------:|:----------------------------------------------------------------------:| -| 個人または Team の割り当てリポジトリからのプル (読み取り) | **X** | **X** | **X** | -| 個人または Team の割り当てリポジトリのフォーク (コピー) | **X** | **X** | **X** | -| コミット、プルリクエスト、Issue についての自分によるコメントの編集と削除 | **X** | **X** | **X** | -| Issue のオープン | **X** | **X** | **X** | -| 自分でオープンした Issue のクローズ | **X** | **X** | **X** | -| 自分でクローズした Issue を再オープン | **X** | **X** | **X** | -| 自分に割り当てられた Issue の取得 | **X** | **X** | **X** | -| Team の割り当てリポジトリのフォークからのプルリクエストの送信 | **X** | **X** | **X** | -| プルリクエストについてのレビューのサブミット | **X** | **X** | **X** | -| 公開済みリリースの表示 | **X** | **X** | **X** | -| wiki の編集 | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [悪用あるいはスパムの可能性があるコンテンツのレポート](/articles/reporting-abuse-or-spam) | **X** | **X** | **X** |{% endif %} -| 個人または Team の割り当てリポジトリへのプッシュ (書き込み) | | **X** | **X** | -| コミット、プルリクエスト、Issue についての他者によるコメントの編集と削除 | | **X** | **X** | -| [他者によるコメントの非表示](/articles/managing-disruptive-comments) | | **X** | **X** | -| [会話のロック](/articles/locking-conversations) | | **X** | **X** | -| ラベルとマイルストーンの適用 | | **X** | **X** | -| すべての Issue のクローズ、再オープン、割り当て | | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [重複した Issue とプルリクエスト](/articles/about-duplicate-issues-and-pull-requests)のマーク付け | | **X** | **X** |{% endif %} -| [リポジトリに指定されたコードオーナーとしてのアクション](/articles/about-code-owners) | | **X** | **X** | -| [プルリクエストのドラフトに、レビューの準備ができたことを示すマークを付ける](/articles/changing-the-stage-of-a-pull-request) | | **X** | **X** | -| [プルリクエストのレビュー](/articles/requesting-a-pull-request-review)の要求 | | **X** | **X** | -| プルリクエストのマージ可能性に影響するレビューのサブミット | | **X** | **X** | -| プルリクエストに対して提案された変更の適用（詳細については「[プルリクエストでのフィードバックを取り込む](/articles/incorporating-feedback-in-your-pull-request)」を参照） | | **X** | **X** | -| [ステータスチェック](/articles/about-status-checks)の作成 | | **X** | **X** | -| リリースの作成と編集 | | **X** | **X** | -| ドラフトリリースの表示 | | **X** | **X** | -| Issue の削除 (「[Issue を削除する](/articles/deleting-an-issue)」を参照) | | | **X** | -| 保護されたブランチでのプルリクエストのマージ（レビューの承認がなくても） | | | **X** | -| [リポジトリのコードオーナーの定義](/articles/about-code-owners) | | | **X** | -| リポジトリの説明の編集 | | | **X** | -| [Topics](/articles/classifying-your-repository-with-topics) の管理 | | | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| リポジトリソーシャルカードの作成および編集 (詳細については「[リポジトリのソーシャルメディア向けプレビューをカスタマイズする](/articles/customizing-your-repositorys-social-media-preview)」を参照) | | | **X** |{% endif %} -| リポジトリを Team に追加する (詳細は「[Organization リポジトリへの Team のアクセスを管理する](/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository#giving-a-team-access-to-a-repository)」を参照) | | | **X** | -| 外部のコラボレータのリポジトリへのアクセスの管理 (詳細については「[外部のコラボレータを Organization のリポジトリに追加する](/articles/adding-outside-collaborators-to-repositories-in-your-organization)」を参照) | | | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [リポジトリでのインタラクション](/github/building-a-strong-community/limiting-interactions-in-your-repository)を制限する | | | **X** |{% endif %} -| リポジトリの可視性の変更（詳細については「[Organization 内でリポジトリの可視性の変更を制限する](/articles/restricting-repository-visibility-changes-in-your-organization)」を参照） | | | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| リポジトリのテンプレート化 (「[テンプレートリポジトリを作成する](/articles/creating-a-template-repository)」を参照) | | | | | **X** |{% endif %} -| リポジトリ設定の変更 | | | **X** | -| Team およびコラボレータのリポジトリへのアクセス管理 | | | **X** | -| リポジトリのデフォルトブランチ編集 | | | **X** | -| Webhookおよびデプロイキーの管理 | | | **X** |{% if currentVersion == "free-pro-team@latest" %} -| プライベートリポジトリの[依存関係グラフの有効化](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) | | | **X** | -| リポジトリでの[脆弱性のある依存関係に対する{% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)を受信 | | | **X** | -| [{% data variables.product.prodname_dependabot_alerts %} を閉じる](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository) | | | **X** | -| 脆弱な依存関係についての[{% data variables.product.prodname_dependabot_alerts %}を受信する個人または Team の追加指定](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-github-dependabot-alerts) | | | **X** | -| [プライベートリポジトリ用のデータ利用設定を管理する](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository) | | | **X** |{% endif %}{% if currentVersion == "free-pro-team@latest" %} -| [セキュリティアドバイザリ](/github/managing-security-vulnerabilities/about-github-security-advisories)の作成") | | | **X** |{% endif %} -| [リポジトリのフォークポリシーを管理する](/github/administering-a-repository/managing-the-forking-policy-for-your-repository) | | | **X** | -| リポジトリの Organization アカウントへの移譲（詳細については［[Organization 内でリポジトリの作成を制限する](/articles/restricting-repository-creation-in-your-organization)」を参照） | | | **X** | -| リポジトリの削除や移譲 (詳細については「[Organization のリポジトリを削除や移譲する権限を設定する](/articles/setting-permissions-for-deleting-or-transferring-repositories)」を参照) | | | **X** | -| [リポジトリのアーカイブ](/articles/about-archiving-repositories) | | | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -| JIRA または Zendesk など外部リソースへの自動リンク参照を作成する (「[外部リソースを参照する自動リンクの設定](/articles/configuring-autolinks-to-reference-external-resources)」を参照) | | | | | **X** |{% endif %} -{% endif %} +| リポジトリアクション | Read | Triage | Write | Maintain | Admin | +|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-----:|:------:|:-----:|:--------:|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:| +| 個人または Team の割り当てリポジトリからのプル | **X** | **X** | **X** | **X** | **X** | +| 個人または Team の割り当てリポジトリのフォーク | **X** | **X** | **X** | **X** | **X** | +| 自分のコメントの編集および削除 | **X** | **X** | **X** | **X** | **X** | +| Issue のオープン | **X** | **X** | **X** | **X** | **X** | +| 自分でオープンした Issue のクローズ | **X** | **X** | **X** | **X** | **X** | +| 自分でクローズした Issue を再オープン | **X** | **X** | **X** | **X** | **X** | +| 自分に割り当てられた Issue の取得 | **X** | **X** | **X** | **X** | **X** | +| Team の割り当てリポジトリのフォークからのプルリクエストの送信 | **X** | **X** | **X** | **X** | **X** | +| プルリクエストについてのレビューのサブミット | **X** | **X** | **X** | **X** | **X** | +| 公開済みリリースの表示 | **X** | **X** | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} +| [[GitHub Actions workflow runs](/actions/automating-your-workflow-with-github-actions/managing-a-workflow-run)] の表示 | **X** | **X** | **X** | **X** | **X** |{% endif %} +| wiki の編集 | **X** | **X** | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} +| [悪用あるいはスパムの可能性があるコンテンツのレポート](/articles/reporting-abuse-or-spam) | **X** | **X** | **X** | **X** | **X** |{% endif %} +| ラベルの適用 | | **X** | **X** | **X** | **X** | +| すべての Issue およびプルリクエストのクローズ、再オープン、割り当て | | **X** | **X** | **X** | **X** | +| マイルストーンの適用 | | **X** | **X** | **X** | **X** | +| [重複した Issue とプルリクエスト](/articles/about-duplicate-issues-and-pull-requests)のマーク付け | | **X** | **X** | **X** | **X** | +| [プルリクエストのレビュー](/articles/requesting-a-pull-request-review)の要求 | | **X** | **X** | **X** | **X** | +| 個人または Team の割り当てリポジトリへのプッシュ (書き込み) | | | **X** | **X** | **X** | +| コミット、プルリクエスト、Issue についての他者によるコメントの編集と削除 | | | **X** | **X** | **X** | +| [他者によるコメントの非表示](/articles/managing-disruptive-comments) | | | **X** | **X** | **X** | +| [会話のロック](/articles/locking-conversations) | | | **X** | **X** | **X** | +| Issue の移譲 (詳細は「[他のリポジトリへ Issue を移譲する](/articles/transferring-an-issue-to-another-repository)」を参照) | | | **X** | **X** | **X** | +| [リポジトリに指定されたコードオーナーとしてのアクション](/articles/about-code-owners) | | | **X** | **X** | **X** | +| [プルリクエストのドラフトに、レビューの準備ができたことを示すマークを付ける](/articles/changing-the-stage-of-a-pull-request) | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +| [プルリクエストをドラフトに変換する](/articles/changing-the-stage-of-a-pull-request) | | | **X** | **X** | **X** |{% endif %} +| プルリクエストのマージ可能性に影響するレビューのサブミット | | | **X** | **X** | **X** | +| プルリクエストに[提案された変更を適用する](/articles/incorporating-feedback-in-your-pull-request) | | | **X** | **X** | **X** | +| [ステータスチェック](/articles/about-status-checks)の作成 | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} +| Create, edit, run, re-run, and cancel [GitHub Actions workflows](/actions/automating-your-workflow-with-github-actions/) | | | **X** | **X** | **X** |{% endif %} +| リリースの作成と編集 | | | **X** | **X** | **X** | +| ドラフトリリースの表示 | | | **X** | **X** | **X** | +| リポジトリの説明の編集 | | | | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} +| [View and install packages](/packages/publishing-and-managing-packages) | **X** | **X** | **X** | **X** | **X** | +| [Publish packages](/packages/publishing-and-managing-packages/publishing-a-package) | | | **X** | **X** | **X** | +| [Delete packages](/packages/publishing-and-managing-packages/deleting-a-package) | | | | | **X** |{% endif %} +| [Topics](/articles/classifying-your-repository-with-topics) の管理 | | | | **X** | **X** | +| Wiki の有効化および Wiki 編集者の制限 | | | | **X** | **X** | +| プロジェクトボードの有効化 | | | | **X** | **X** | +| [プルリクエストのマージ](/articles/configuring-pull-request-merges)の設定 | | | | **X** | **X** | +| [{% data variables.product.prodname_pages %} の公開ソース](/articles/configuring-a-publishing-source-for-github-pages)の設定 | | | | **X** | **X** | +| [保護されたブランチへのプッシュ](/articles/about-protected-branches) | | | | **X** | **X** | +| [リポジトリソーシャルカードの作成と編集](/articles/customizing-your-repositorys-social-media-preview) | | | | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} +| [リポジトリでのインタラクション](/github/building-a-strong-community/limiting-interactions-in-your-repository)を制限する | | | | **X** | **X** |{% endif %} +| Issue の削除 (「[Issue を削除する](/articles/deleting-an-issue)」を参照) | | | | | **X** | +| 保護されたブランチでのプルリクエストのマージ（レビューの承認がなくても） | | | | | **X** | +| [リポジトリのコードオーナーの定義](/articles/about-code-owners) | | | | | **X** | +| リポジトリを Team に追加する (詳細は「[Organization リポジトリへの Team のアクセスを管理する](/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository#giving-a-team-access-to-a-repository)」を参照) | | | | | **X** | +| [外部のコラボレータのリポジトリへのアクセスの管理](/articles/adding-outside-collaborators-to-repositories-in-your-organization) | | | | | **X** | +| [リポジトリの可視性の変更](/articles/restricting-repository-visibility-changes-in-your-organization) | | | | | **X** | +| リポジトリのテンプレート化 (「[テンプレートリポジトリを作成する](/articles/creating-a-template-repository)」を参照) | | | | | **X** | +| リポジトリ設定の変更 | | | | | **X** | +| Team およびコラボレータのリポジトリへのアクセス管理 | | | | | **X** | +| リポジトリのデフォルトブランチ編集 | | | | | **X** | +| Webhookおよびデプロイキーの管理 | | | | | **X** |{% if currentVersion == "free-pro-team@latest" %} +| プライベートリポジトリの[依存関係グラフの有効化](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) | | | | | **X** | +| リポジトリでの[脆弱性のある依存関係に対する{% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)を受信 | | | | | **X** | +| [{% data variables.product.prodname_dependabot_alerts %} を閉じる](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository) | | | | | **X** | +| 脆弱な依存関係についての[{% data variables.product.prodname_dependabot_alerts %}を受信する個人または Team の追加指定](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository) | | | | | **X** | +| [プライベートリポジトリ用のデータ利用設定を管理する](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository) | | | | | **X** |{% endif %}{% if currentVersion == "free-pro-team@latest" %}| Create [security advisories](/github/managing-security-vulnerabilities/about-github-security-advisories) | | | | | **X** |{% endif %} +| [リポジトリのフォークポリシーを管理する](/github/administering-a-repository/managing-the-forking-policy-for-your-repository) | | | | | **X** | +| [リポジトリの Organization への移譲](/articles/restricting-repository-creation-in-your-organization) | | | | | **X** | +| [リポジトリの削除または Organization 外への移譲](/articles/setting-permissions-for-deleting-or-transferring-repositories) | | | | | **X** | +| [リポジトリのアーカイブ](/articles/about-archiving-repositories) | | | | | **X** |{% if currentVersion == "free-pro-team@latest" %} +| スポンサーボタンの表示 (「[リポジトリにスポンサーボタンを表示する](/articles/displaying-a-sponsor-button-in-your-repository)」を参照) | | | | | **X** |{% endif %} +| JIRA や Zendesk などの外部リソースに対する自動リンク参照を作成します (「[外部リソースを参照する自動リンクの設定](/articles/configuring-autolinks-to-reference-external-resources)」を参照)。 | | | | | **X** | ### 参考リンク diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/requesting-to-add-a-child-team.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/requesting-to-add-a-child-team.md index fb5453236135..5aa07e574efb 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/requesting-to-add-a-child-team.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/requesting-to-add-a-child-team.md @@ -1,6 +1,6 @@ --- title: 子チームの追加をリクエストする -intro: あなたがある Team でメンテナーの権限を有している場合は、Organization の階層内で既存の Team を自分の Team の下にネストするようリクエストできます。 +intro: 'あなたがある Team でメンテナーの権限を有している場合は、Organization の階層内で既存の Team を自分の Team の下にネストするようリクエストできます。' redirect_from: - /articles/requesting-to-add-a-child-team versions: diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/requesting-to-add-or-change-a-parent-team.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/requesting-to-add-or-change-a-parent-team.md index 612b2dd97f68..cc4468620cd2 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/requesting-to-add-or-change-a-parent-team.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/requesting-to-add-or-change-a-parent-team.md @@ -1,6 +1,6 @@ --- title: 親チームの追加または変更をリクエストする -intro: ある Team でメンテナーの権限を所有している場合は、Organization の階層内で自分の Team を親チームの下にネストするようにリクエストできます。 +intro: 'ある Team でメンテナーの権限を所有している場合は、Organization の階層内で自分の Team を親チームの下にネストするようにリクエストできます。' redirect_from: - /articles/requesting-to-add-or-change-a-parent-team versions: diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md index 0fc7fc373cfe..5474ce5cbb10 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md @@ -1,6 +1,6 @@ --- title: Organization で 2 要素認証を要求する -intro: 'Organization のオーナーは、 {% if currentVersion == "free-pro-team@latest" %}Organization のメンバー、外部コラボレーター、支払いマネージャー {% else %}Organization のメンバー、外部のコラボレーター{% endif %}に、それぞれの個人アカウントに対する 2 要素認証を有効にするように義務付けることで、悪意のある行為者が Organization のリポジトリや設定にアクセスしにくくすることができます。' +intro: 'Organization owners can require {% if currentVersion == "free-pro-team@latest" %}organization members, outside collaborators, and billing managers{% else %}organization members and outside collaborators{% endif %} to enable two-factor authentication for their personal accounts, making it harder for malicious actors to access an organization''s repositories and settings.' redirect_from: - /articles/requiring-two-factor-authentication-in-your-organization versions: @@ -8,23 +8,35 @@ versions: enterprise-server: '*' --- -{% data reusables.two_fa.auth_methods_2fa %} +### About two-factor authentication for organizations + +{% data reusables.two_fa.about-2fa %} You can require all {% if currentVersion == "free-pro-team@latest" %}members, outside collaborators, and billing managers{% else %}members and outside collaborators{% endif %} in your organization to enable two-factor authentication on {% data variables.product.product_name %}. For more information about two-factor authentication, see "[Securing your account with two-factor authentication (2FA)](/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa)." -### 2 要素認証実施にあたっての要件 +{% if currentVersion == "free-pro-team@latest" %} -{% if currentVersion == "free-pro-team@latest" %}Organization のメンバー、外部コラボレーター、支払いマネージャー {% else %}Organization のメンバー、外部コラボレーター{% endif %}に、 2 要素認証を使用することを義務付けるには、まず自分自身の個人アカウントで [2 要素認証を有効にする](/articles/securing-your-account-with-two-factor-authentication-2fa/)必要があります。 +You can also require two-factor authentication for organizations in an enterprise. 詳細は、「[Enterprise アカウントでセキュリティ設定を強制する](/github/setting-up-and-managing-your-enterprise-account/enforcing-security-settings-in-your-enterprise-account#requiring-two-factor-authentication-for-organizations-in-your-enterprise-account)」を参照してください。 + +{% endif %} {% warning %} **警告:** -- Organization に対して 2 要素認証の使用を義務付ける場合、2FA を使用しない{% if currentVersion == "free-pro-team@latest" %}メンバー、外部コラボレーター、支払いマネージャー {% else %}メンバー、外部コラボレーター{% endif %} (ボット アカウントを含む) は Organization から削除され、そのリポジトリへのアクセス権が失われます。 Organization のプライベートリポジトリのフォークへのアクセスも失います。 Organization から削除されてから 3 か月以内に、個人アカウントに対して 2 要素認証を有効にすれば、[それらのアカウントが持っていたアクセス特権と設定を復元](/articles/reinstating-a-former-member-of-your-organization)できます。 -- 義務付けられた 2 要素認証を有効にした後に、Organization のオーナー、メンバー、{% if currentVersion == "free-pro-team@latest" %}支払いマネージャー、{% endif %} または外部コラボレーターがそれぞれの個人アカウントで 2 要素認証を無効にすると、それらは Organization から自動的に削除されます。 +- When you require use of two-factor authentication for your organization, {% if currentVersion == "free-pro-team@latest" %}members, outside collaborators, and billing managers{% else %}members and outside collaborators{% endif %} (including bot accounts) who do not use 2FA will be removed from the organization and lose access to its repositories. Organization のプライベートリポジトリのフォークへのアクセスも失います。 Organization から削除されてから 3 か月以内に、個人アカウントに対して 2 要素認証を有効にすれば、[それらのアカウントが持っていたアクセス特権と設定を復元](/articles/reinstating-a-former-member-of-your-organization)できます。 +- If an organization owner, member,{% if currentVersion == "free-pro-team@latest" %} billing manager,{% endif %} or outside collaborator disables 2FA for their personal account after you've enabled required two-factor authentication, they will automatically be removed from the organization. - あなたが、2 要素認証を義務付けている Organization の唯一のオーナーである場合、その Organization での 2 要素認証義務を無効にしなければ、あなたの個人アカウントの 2 要素認証を無効にすることはできません。 {% endwarning %} -2 要素認証の使用を義務付ける前に、{% if currentVersion == "free-pro-team@latest" %}Organization のメンバー、外部コラボレーター、支払いマネージャー {% else %}Organization のメンバー、外部コラボレーター{% endif %}に通知して、それぞれのアカウントで 2 要素認証をセットアップするように依頼することをおすすめします。 Organization の [People] ページで、[メンバーと外部コラボレーターがすでに 2 要素認証を使用しているかどうかを確認する](/articles/viewing-whether-users-in-your-organization-have-2fa-enabled)ことができます。 +{% data reusables.two_fa.auth_methods_2fa %} + +### 必要な環境 + +Before you can require {% if currentVersion == "free-pro-team@latest" %}organization members, outside collaborators, and billing managers{% else %}organization members and outside collaborators{% endif %} to use two-factor authentication, you must enable two-factor authentication for your account on {% data variables.product.product_name %}. 詳細は「[2 要素認証 (2FA) でアカウントを保護する](/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa)」を参照してください。 + +Before you require use of two-factor authentication, we recommend notifying {% if currentVersion == "free-pro-team@latest" %}organization members, outside collaborators, and billing managers{% else %}organization members and outside collaborators{% endif %} and asking them to set up 2FA for their accounts. You can see if members and outside collaborators already use 2FA. 詳細は「[Organization 内のユーザが 2 要素認証を有効にしているか確認する](/github/setting-up-and-managing-organizations-and-teams/viewing-whether-users-in-your-organization-have-2fa-enabled)」を参照してください。 + +### Organization で 2 要素認証を要求する {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} @@ -47,7 +59,7 @@ versions: {% data reusables.audit_log.audit_log_sidebar_for_org_admins %} 4. 検索クエリを入力します。 以下のように検索します: - 削除された Organization のメンバーを検索するには、検索クエリで `action:org.remove_member` を使用します - - 削除された外部コラボレーターを検索するには、検索クエリで `action:org.remove_outside_collaborator` を使用します{% if currentVersion == "free-pro-team@latest" %} + - Outside collaborators removed, use `action:org.remove_outside_collaborator` in your search query{% if currentVersion == "free-pro-team@latest" %} - 削除された支払いマネージャーを検索するには、検索クエリで `action:org.remove_billing_manager` を使用します{% endif %} また、検索で[時間枠](/articles/reviewing-the-audit-log-for-your-organization/#search-based-on-time-of-action)を使用すれば、Organization から削除された人々を表示できます。 diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md index a52bf2055ee1..7d59733fe821 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md @@ -1,6 +1,6 @@ --- title: メール通知を承認済みドメインに制限する -intro: Organization の情報が個人アカウントに漏れるのを防ぐために、Organization のオーナーは Organization アクティビティに関するメール通知を検証済みドメインに制限できます。 +intro: 'Organization の情報が個人アカウントに漏れるのを防ぐために、Organization のオーナーは Organization アクティビティに関するメール通知を検証済みドメインに制限できます。' product: '{% data reusables.gated-features.restrict-email-domain %}' redirect_from: - /articles/restricting-email-notifications-about-organization-activity-to-an-approved-email-domain/ diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md index a472c4c8153a..4b5f4b8b5fb6 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md @@ -1,6 +1,6 @@ --- title: Organization 内でリポジトリの作成を制限する -intro: Organization のデータを保護するために、Organization 内でリポジトリを作成するための権限を設定できます。 +intro: 'Organization のデータを保護するために、Organization 内でリポジトリを作成するための権限を設定できます。' redirect_from: - /articles/restricting-repository-creation-in-your-organization versions: @@ -8,11 +8,11 @@ versions: enterprise-server: '*' --- -メンバーが Organization でリポジトリを作成できるかどうかを選択できます。 メンバーにリポジトリの作成を許可する場合、メンバーが作成できるリポジトリの種類を選択できます。{% if currentVersion == "free-pro-team@latest" %}メンバーがプライベートリポジトリのみを作成することを許可する場合、Organization は {% data variables.product.prodname_ghe_cloud %} を使用する必要があります。{% endif %} 詳細は「[リポジトリの可視性について](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)」を参照してください。 +メンバーが Organization でリポジトリを作成できるかどうかを選択できます。 If you allow members to create repositories, you can choose which types of repositories members can create.{% if currentVersion == "free-pro-team@latest" %} To allow members to create private repositories only, your organization must use {% data variables.product.prodname_ghe_cloud %}.{% endif %} For more information, see "[About repository visibility](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)." Organization のオーナーは、いつでもどんなタイプの Team でも作成できます。 -{% if currentVersion == "free-pro-team@latest" %}Enterprise オーナー{% else %}サイト管理者{% endif %}は、Organization のリポジトリ作成ポリシーで使用できるオプションを制限できます。 詳細は、{% if currentVersion == "free-pro-team@latest" %}"「[Enterprise アカウントでリポジトリ管理ポリシーを施行する](/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account)」{% else %}"[インスタンス内でのリポジトリの作成を制限する](/enterprise/admin/user-management/restricting-repository-creation-in-your-instance)」{% endif %}を参照してください。 +{% if currentVersion == "free-pro-team@latest" %}Enterprise owners{% else %}Site administrators{% endif %} can restrict the options you have available for your organization's repository creation policy. For more information, see {% if currentVersion == "free-pro-team@latest" %}"[Enforcing repository management policies in your enterprise account](/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account)."{% else %}"[Restricting repository creation in your instance](/enterprise/admin/user-management/restricting-repository-creation-in-your-instance)."{% endif %} {% warning %} @@ -26,5 +26,5 @@ Organization のオーナーは、いつでもどんなタイプの Team でも {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.member-privileges %} -5. [Repository creation] で、{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}1 つ以上のオプション{% else %}設定{% endif %}を選択します。 ![リポジトリ作成のオプション](/assets/images/help/organizations/repo-creation-perms-radio-buttons.png) +5. Under "Repository creation", select one or more options. ![リポジトリ作成のオプション](/assets/images/help/organizations/repo-creation-perms-radio-buttons.png) 6. [**Save**] をクリックします。 diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-visibility-changes-in-your-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-visibility-changes-in-your-organization.md index 08c14717ab9d..8c0365db18f4 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-visibility-changes-in-your-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-visibility-changes-in-your-organization.md @@ -1,6 +1,6 @@ --- title: Organization 内でリポジトリの可視性の変更を制限する -intro: Organization のデータを保護するために、Organization 内でリポジトリの可視性を変更するための権限を設定できます。 +intro: 'Organization のデータを保護するために、Organization 内でリポジトリの可視性を変更するための権限を設定できます。' redirect_from: - /articles/restricting-repository-visibility-changes-in-your-organization versions: diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md index f256f2c28fdb..b0029b8eeabf 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md @@ -202,7 +202,8 @@ For more information, see "[Restricting publication of {% data variables.product | `remove_outside_collaborator` | Triggered when an owner removes an outside collaborator from an organization or when [two-factor authentication is required in an organization](/articles/requiring-two-factor-authentication-in-your-organization) and an outside collaborator does not use 2FA or disables 2FA. |{% if currentVersion == "free-pro-team@latest" %} | `revoke_external_identity` | Triggered when an organization owner revokes a member's linked identity. For more information, see "[Viewing and managing a member's SAML access to your organization](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization#viewing-and-revoking-a-linked-identity)." | `revoke_sso_session` | Triggered when an organization owner revokes a member's SAML session. For more information, see "[Viewing and managing a member's SAML access to your organization](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization#viewing-and-revoking-a-linked-identity)." -| `unblock_user` | Triggered when an organization owner [unblocks a user from an organization](/articles/unblocking-a-user-from-your-organization).{% endif %} +| `unblock_user` | Triggered when an organization owner [unblocks a user from an organization](/articles/unblocking-a-user-from-your-organization).{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +| `update_new_repository_default_branch_setting` | Triggered when an owner changes the name of the default branch for new repositories in the organization. For more information, see "[Managing the default branch name for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization)."{% endif %} | `update_default_repository_permission` | Triggered when an owner changes the default repository permission level for organization members. | `update_member` | Triggered when an owner changes a person's role from owner to member or member to owner. | `update_member_repository_creation_permission` | Triggered when an owner changes the create repository permission for organization members.{% if currentVersion == "free-pro-team@latest" %} @@ -400,7 +401,6 @@ Using the qualifier `country`, you can filter actions in the audit log based on {% data reusables.audit_log.exported-log-keys-and-values %} {% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} ### Using the Audit log API {% note %} @@ -418,9 +418,7 @@ To ensure a secure IP and maintain compliance for your organization, you can use The GraphQL response can include data for up to 90 to 120 days. -For example, you can make a GraphQL request to see all the new organization members added to your organization. For more information, see the "[GraphQL API Audit Log](/v4/interface/auditentry/)." - -{% endif %} +For example, you can make a GraphQL request to see all the new organization members added to your organization. For more information, see the "[GraphQL API Audit Log](/graphql/reference/interfaces#auditentry/)." ### Further reading diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/reviewing-your-organizations-installed-integrations.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/reviewing-your-organizations-installed-integrations.md index d4d14b9212eb..83bcbe3dd4f6 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/reviewing-your-organizations-installed-integrations.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/reviewing-your-organizations-installed-integrations.md @@ -1,6 +1,6 @@ --- -title: Organization のインストール済みインテグレーションをレビューする -intro: Organization のインストール済みインテグレーションの権限レベルをレビューして、各インテグレーションの Organization リポジトリへのアクセス権を設定できます。 +title: Reviewing your organization's installed integrations +intro: You can review the permission levels for your organization's installed integrations and configure each integration's access to organization repositories. redirect_from: - /articles/reviewing-your-organization-s-installed-integrations - /articles/reviewing-your-organizations-installed-integrations @@ -12,9 +12,12 @@ versions: {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} -4. 左サイドバーで [**Installed {% data variables.product.prodname_github_app %}s**] をクリックします。 ![Organization の Settings サイドバーでの [Installed {% data variables.product.prodname_github_app %}s] タブ](/assets/images/help/organizations/org-settings-installed-github-apps.png) -5. レビューする {% data variables.product.prodname_github_app %}の横にある [**Configure**] をクリックします。 ![[Configure] ボタン](/assets/images/help/organizations/configure-installed-integration-button.png) -6. {% data variables.product.prodname_github_app %} の権限とリポジトリのアクセス権をレビューします。 ![{% data variables.product.prodname_github_app %} にすべてのリポジトリまたは特定のリポジトリへのアクセス権を付与するためのオプション](/assets/images/help/organizations/toggle-integration-repo-access.png) - - {% data variables.product.prodname_github_app %} に Organization のすべてのリポジトリへのアクセス権を付与するには、[**All repositories**] をクリックします。 - - アプリケーションにアクセス権を付与する特定のリポジトリを選択するには、[**Only select repositories**] を選択し、続いてリポジトリ名を入力します。 -7. [**Save**] をクリックします。 +4. In the left sidebar, click **Installed {% data variables.product.prodname_github_app %}s**. + ![Installed {% data variables.product.prodname_github_app %}s tab in the organization settings sidebar](/assets/images/help/organizations/org-settings-installed-github-apps.png) +5. Next to the {% data variables.product.prodname_github_app %} you'd like to review, click **Configure**. + ![Configure button](/assets/images/help/organizations/configure-installed-integration-button.png) +6. Review the {% data variables.product.prodname_github_app %}'s permissions and repository access. + ![Option to give the {% data variables.product.prodname_github_app %} access to all repositories or specific repositories](/assets/images/help/organizations/toggle-integration-repo-access.png) + - To give the {% data variables.product.prodname_github_app %} access to all of your organization's repositories, select **All repositories**. + - To choose specific repositories to give the application access to, select **Only select repositories**, then type a repository name. +7. Click **Save**. diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/setting-base-permissions-for-an-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/setting-base-permissions-for-an-organization.md index eb43c57b20b5..0a344b6edf36 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/setting-base-permissions-for-an-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/setting-base-permissions-for-an-organization.md @@ -11,7 +11,7 @@ versions: Organization のリポジトリにアクセスするとき Organization の全メンバーに適用される基本レベルの権限を設定できます。 基本レベルの権限は、外部のコラボレーターには適用されません。 -{% if currentVersion == "free-pro-team@latest" %}デフォルトでは、Organization のメンバーは Organization のリポジトリに対する**読み取り**権限を付与されます。{% endif %} +{% if currentVersion == "free-pro-team@latest" %}By default, members of an organization will have **Read** permissions to the organization's repositories.{% endif %} Organization のリポジトリに対する管理者権限があるユーザが、リポジトリに対してそれより高いレベルの権限を付与すると、基本レベルの権限は、付与された高い権限によってオーバーライドされます。 diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-adding-outside-collaborators.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-adding-outside-collaborators.md index 6e1c2aeb207b..9f038f84ec7b 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-adding-outside-collaborators.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-adding-outside-collaborators.md @@ -1,6 +1,6 @@ --- -title: 外部のコラボレーターを追加するための権限を設定する -intro: Organization のデータを保護し、Organization 内で使用されている有料ライセンスの数が無駄遣いされないようにするために、外部コラボレーターを Organization のリポジトリに招待することをオーナーのみに許可できます。 +title: Setting permissions for adding outside collaborators +intro: 'To protect your organization''s data and the number of paid licenses used in your organization, you can allow only owners to invite outside collaborators to organization repositories.' product: '{% data reusables.gated-features.restict-add-collaborator %}' redirect_from: - /articles/restricting-the-ability-to-add-outside-collaborators-to-organization-repositories/ @@ -10,7 +10,7 @@ versions: enterprise-server: '*' --- -リポジトリに対する管理者権限を持つ Organization のオーナーとメンバーは、リポジトリで作業するように外部のコラボレーターを招待できます。 外部のコラボレーターの招待権限を、Organization のオーナーに制限することもできます。 +Organization owners, and members with admin privileges for a repository, can invite outside collaborators to work on the repository. You can also restrict outside collaborator invite permissions to only organization owners. {% data reusables.organizations.outside-collaborators-use-seats %} @@ -18,6 +18,7 @@ versions: {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.member-privileges %} -5. [Repository invitations] で、[**Allow members to invite outside collaborators to repositories for this organization**] を選択します。{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} ![Checkbox to allow members to invite outside collaborators to organization repositories](/assets/images/help/organizations/repo-invitations-checkbox-updated.png){% else %} -![Checkbox to allow members to invite outside collaborators to organization repositories](/assets/images/help/organizations/repo-invitations-checkbox.png){% endif %} -6. [**Save**] をクリックします。 +5. Under "Repository invitations", select **Allow members to invite outside collaborators to repositories for this organization**.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} + ![Checkbox to allow members to invite outside collaborators to organization repositories](/assets/images/help/organizations/repo-invitations-checkbox-updated.png){% else %} + ![Checkbox to allow members to invite outside collaborators to organization repositories](/assets/images/help/organizations/repo-invitations-checkbox.png){% endif %} +6. Click **Save**. diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-deleting-or-transferring-repositories.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-deleting-or-transferring-repositories.md index 54feb90d4301..1926a44f68eb 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-deleting-or-transferring-repositories.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-deleting-or-transferring-repositories.md @@ -1,6 +1,6 @@ --- title: リポジトリを削除または移譲する権限を設定する -intro: リポジトリの削除や移譲を、リポジトリの管理者権限を持つ Organization メンバーに許可したり、Organization のオーナーのみがリポジトリを削除や移譲できるよう制限したりできます。 +intro: 'リポジトリの削除や移譲を、リポジトリの管理者権限を持つ Organization メンバーに許可したり、Organization のオーナーのみがリポジトリを削除や移譲できるよう制限したりできます。' redirect_from: - /articles/setting-permissions-for-deleting-or-transferring-repositories-in-your-organization/ - /articles/setting-permissions-for-deleting-or-transferring-repositories diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/setting-your-teams-profile-picture.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/setting-your-teams-profile-picture.md index 22e15cab640e..f8e9cc2893e1 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/setting-your-teams-profile-picture.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/setting-your-teams-profile-picture.md @@ -1,6 +1,6 @@ --- title: Team のプロフィール画像を設定する -intro: チームメンテナおよび Organization のオーナーは、Team で表示される Team のプロフィール画像を設定できます。 +intro: 'チームメンテナおよび Organization のオーナーは、Team で表示される Team のプロフィール画像を設定できます。' redirect_from: - /articles/setting-your-team-s-profile-picture - /articles/setting-your-teams-profile-picture diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/transferring-organization-ownership.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/transferring-organization-ownership.md index 76b86e8f5491..975bf1e762ce 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/transferring-organization-ownership.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/transferring-organization-ownership.md @@ -3,7 +3,7 @@ title: Organization の所有権を移譲する redirect_from: - /articles/needs-polish-how-do-i-give-ownership-to-an-organization-to-someone-else/ - /articles/transferring-organization-ownership -intro: '他の誰かを Organization アカウントのオーナーにするには、新しいオーナーを追加し、{% if currentVersion == "free-pro-team@latest" %}請求情報が更新されることを確認し、{% endif %}アカウントから自分を削除します。' +intro: 'To make someone else the owner of an organization account, you must add a new owner{% if currentVersion == "free-pro-team@latest" %}, ensure that the billing information is updated,{% endif %} and then remove yourself from the account.' versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md index 2ef839f5b6b3..9d7455778020 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md @@ -9,7 +9,9 @@ versions: 標準の利用規約は、{% data variables.product.prodname_dotcom %} と個人としてのあなたとの間の合意です。 会社、非営利団体、グループなどのエンティティに代わって {% data variables.product.prodname_dotcom %} との契約を締結するには、Organization のオーナーが企業利用規約にアップグレードします。 -1. 企業利用規約へのアップグレードをリクエストするには、{% data variables.contact.contact_support %} にお問い合わせください。 彼らは、Organization のダッシュボード上のバナーを有効にします。それにより、企業利用規約を受け入れることができます。 +1. お問い合わせ + +{% data variables.contact.contact_support %} to request an upgrade to the Corporate Terms of Service. 彼らは、Organization のダッシュボード上のバナーを有効にします。それにより、企業利用規約を受け入れることができます。 {% data reusables.dashboard.access-org-dashboard %} 3. ページ上部の利用規約バナーの右側にある [**Sign now**] をクリックします。 ![[Sign now] ボタン](/assets/images/help/organizations/sign-now-button.png) 4. 企業利用規約に関する情報を読み、[**Yes, I want to sign these terms on behalf of my business.**] を選択します。 ![会社を代表して署名するためのチェックボックス](/assets/images/help/organizations/sign-on-behalf-business.png) diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization.md index a97fbff2f51b..a3206a3f3f8d 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization.md @@ -1,6 +1,6 @@ --- title: 組織へのメンバーの SAML アクセスの表示と管理 -intro: Organization のメンバーのリンクされたアイデンティティ、アクティブなセッション、認可されたクレデンシャルの表示と取り消しが可能です。 +intro: 'Organization のメンバーのリンクされたアイデンティティ、アクティブなセッション、認可されたクレデンシャルの表示と取り消しが可能です。' permissions: Organization のオーナーは、組織へのメンバーの SAML アクセスを表示したり管理したりすることもできます。 product: '{% data reusables.gated-features.saml-sso %}' redirect_from: diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/viewing-insights-for-your-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/viewing-insights-for-your-organization.md index 25484272b0aa..92143a7ee4a1 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/viewing-insights-for-your-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/viewing-insights-for-your-organization.md @@ -1,6 +1,6 @@ --- title: Organization のインサイトを表示する -intro: Organization のインサイトは、Organization のアクティビティ、コントリビューション、および依存関係についてのデータを提供します。 +intro: 'Organization のインサイトは、Organization のアクティビティ、コントリビューション、および依存関係についてのデータを提供します。' product: '{% data reusables.gated-features.org-insights %}' redirect_from: - /articles/viewing-insights-for-your-organization diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/viewing-whether-users-in-your-organization-have-2fa-enabled.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/viewing-whether-users-in-your-organization-have-2fa-enabled.md index b7bc0f0a27ea..66b0ed9db454 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/viewing-whether-users-in-your-organization-have-2fa-enabled.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/viewing-whether-users-in-your-organization-have-2fa-enabled.md @@ -1,6 +1,6 @@ --- title: Organization 内のユーザが 2 要素認証を有効にしているかどうかを表示する -intro: どの Organization のオーナー、メンバー、および 外部コラボレーターが 2 要素認証を有効にしているかを確認できます。 +intro: 'どの Organization のオーナー、メンバー、および 外部コラボレーターが 2 要素認証を有効にしているかを確認できます。' redirect_from: - /articles/viewing-whether-users-in-your-organization-have-2fa-enabled versions: @@ -10,7 +10,7 @@ versions: {% note %} -**メモ:** {% if currentVersion == "free-pro-team@latest" %}オーナー、支払いマネージャーおよび{% else %}{% endif %}外部コラボレーターを含むすべてのメンバーに、2 要素認証を有効にするよう要求できます。 詳しい情報については [Organization で 2 要素認証を要求する](/articles/requiring-two-factor-authentication-in-your-organization)を参照してください。 +**Note:** You can require that all members{% if currentVersion == "free-pro-team@latest" %}, including, owners, billing managers and{% else %} and{% endif %} outside collaborators in your organization have two-factor authentication enabled. 詳しい情報については [Organization で 2 要素認証を要求する](/articles/requiring-two-factor-authentication-in-your-organization)を参照してください。 {% endnote %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/about-enterprise-accounts.md b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/about-enterprise-accounts.md index 63c26f23d6d4..feb229a23869 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/about-enterprise-accounts.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/about-enterprise-accounts.md @@ -25,9 +25,7 @@ Enterprise アカウントでは、複数の {% data variables.product.prodname_ メンバーアクセスと管理に関する詳細は「[Enterprise アカウントでユーザを管理する](/articles/managing-users-in-your-enterprise-account)」 を参照してください。 -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} GraphQL APIを利用したEnterpriseアカウントの管理に関する詳しい情報については、「[Enterprise アカウント](/v4/guides/managing-enterprise-accounts)」を参照してください。 -{% endif %} ### Enterprise アカウントにリンクされた Organization を管理する diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md new file mode 100644 index 000000000000..7a75d8c7a30d --- /dev/null +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md @@ -0,0 +1,19 @@ +--- +title: Configuring the retention period for GitHub Actions artifacts and logs in your enterprise account +intro: 'Enterprise owners can configure the retention period for {% data variables.product.prodname_actions %} artifacts and logs in an enterprise account.' +product: '{% data reusables.gated-features.enterprise-accounts %}' +miniTocMaxHeadingLevel: 4 +versions: + free-pro-team: '*' + enterprise-server: '>=2.23' +--- + +{% data reusables.actions.about-artifact-log-retention %} + +## Setting the retention period for an enterprise + +{% data reusables.enterprise_site_admin_settings.access-settings %} +{% data reusables.enterprise_site_admin_settings.business %} +{% data reusables.enterprise-accounts.policies-tab %} +{% data reusables.enterprise-accounts.actions-tab %} +{% data reusables.github-actions.change-retention-period-for-artifacts-logs %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/enforcing-a-policy-on-dependency-insights-in-your-enterprise-account.md b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/enforcing-a-policy-on-dependency-insights-in-your-enterprise-account.md index 1cfc6d6830b3..a51cc3543280 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/enforcing-a-policy-on-dependency-insights-in-your-enterprise-account.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/enforcing-a-policy-on-dependency-insights-in-your-enterprise-account.md @@ -1,6 +1,6 @@ --- title: dependency insightsに関するポリシーを施行する -intro: あなたの Enterprise アカウントが所有しているすべての Organization にわたって、メンバーに dependency insights の表示を許可または不許可に設定できます。また、コードオーナーが Organization レベルで設定を管理できるよう許可できます。 +intro: 'あなたの Enterprise アカウントが所有しているすべての Organization にわたって、メンバーに dependency insights の表示を許可または不許可に設定できます。また、コードオーナーが Organization レベルで設定を管理できるよう許可できます。' product: '{% data reusables.gated-features.enterprise-accounts %}' redirect_from: - /articles/enforcing-a-policy-on-dependency-insights/ diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account.md b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account.md index 8f65ca587032..83c4d8d65053 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account.md @@ -13,13 +13,26 @@ versions: {% data variables.product.prodname_actions %} に関する詳しい情報については、「[{% data variables.product.prodname_actions %} について](/actions/getting-started-with-github-actions/about-github-actions)」を参照してください。 - ### Enterprise アカウント の {% data variables.product.prodname_actions %} 権限の管理 +You can disable all workflows for an enterprise or set a policy that configures which actions can be used in an organization. + +{% data reusables.actions.actions-use-policy-settings %} + {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.actions-tab %} {% data reusables.actions.enterprise-actions-permissions %} +1. [**Save**] をクリックします。 + +### Allowing specific actions to run + +{% data reusables.actions.allow-specific-actions-intro %} + +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.policies-tab %} +{% data reusables.enterprise-accounts.actions-tab %} +1. Under **Policies**, select **Allow specific actions** and add your required actions to the list. ![Add actions to allow list](/assets/images/help/organizations/enterprise-actions-policy-allow-list.png) ### プライベートリポジトリのフォークのワークフローを有効にする diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/enforcing-project-board-policies-in-your-enterprise-account.md b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/enforcing-project-board-policies-in-your-enterprise-account.md index ac115b417108..3ba2a5c91b50 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/enforcing-project-board-policies-in-your-enterprise-account.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/enforcing-project-board-policies-in-your-enterprise-account.md @@ -1,6 +1,6 @@ --- title: Enterprise アカウントでプロジェクトボードでのポリシーを施行する -intro: Enterprise のオーナーは、自分の Enterprise のアカウントが所有するすべての Organization に対して特定のプロジェクトボードのポリシーを強制したり、Organization ごとのポリシーの設定を許可したりすることができます。 +intro: 'Enterprise のオーナーは、自分の Enterprise のアカウントが所有するすべての Organization に対して特定のプロジェクトボードのポリシーを強制したり、Organization ごとのポリシーの設定を許可したりすることができます。' product: '{% data reusables.gated-features.enterprise-accounts %}' redirect_from: - /articles/enforcing-project-board-settings-for-organizations-in-your-business-account/ diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account.md b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account.md index 1b48c96f50fe..baee7146f8b8 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account.md @@ -1,6 +1,6 @@ --- title: Enterprise アカウントでリポジトリ管理ポリシーを施行する -intro: Enterprise のオーナーは、自分の Enterprise のアカウントが所有するすべての Organization に対して特定のリポジトリの管理ポリシーを強制したり、Organization ごとのポリシーの設定を許可したりすることができます。 +intro: 'Enterprise のオーナーは、自分の Enterprise のアカウントが所有するすべての Organization に対して特定のリポジトリの管理ポリシーを強制したり、Organization ごとのポリシーの設定を許可したりすることができます。' product: '{% data reusables.gated-features.enterprise-accounts %}' redirect_from: - /articles/enforcing-repository-management-settings-for-organizations-in-your-business-account/ diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/enforcing-security-settings-in-your-enterprise-account.md b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/enforcing-security-settings-in-your-enterprise-account.md index 91f941152e75..4f0648f37fee 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/enforcing-security-settings-in-your-enterprise-account.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/enforcing-security-settings-in-your-enterprise-account.md @@ -182,7 +182,7 @@ Enterprise アカウントに対して Team の同期を有効化する前提条 Enterprise オーナーは、Enterprise アカウントの SSH 認証局 (CA) を追加および削除できます。 -Enterprise アカウントに SSH CA を追加することにより、その Enterprise アカウントが所有する Organization のメンバー誰でも、その Enterprise アカウントが提供する SSH 認証を使用して Organization のリポジトリにアクセスできるようになります。 {% data reusables.organizations.can-require-ssh-cert %}詳細については、「[SSL認証局について](/articles/about-ssh-certificate-authorities)」を参照してください。 +Enterprise アカウントに SSH CA を追加することにより、その Enterprise アカウントが所有する Organization のメンバー誰でも、その Enterprise アカウントが提供する SSH 認証を使用して Organization のリポジトリにアクセスできるようになります。 {% data reusables.organizations.can-require-ssh-cert %}詳細については、「[SSS認証局について](/articles/about-ssh-certificate-authorities)」を参照してください。 #### SSH 認証局を追加する diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/enforcing-team-policies-in-your-enterprise-account.md b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/enforcing-team-policies-in-your-enterprise-account.md index 98a38e4d586f..a5ef387c6d87 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/enforcing-team-policies-in-your-enterprise-account.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/enforcing-team-policies-in-your-enterprise-account.md @@ -1,6 +1,6 @@ --- title: Enterprise アカウントで Team のポリシーを施行する -intro: Enterprise のオーナーは、自分の Enterprise のアカウントが所有するすべての Organization に対して特定のチームポリシーを強制したり、各 Organization ごとのポリシーの設定を許可したりすることができます。 +intro: 'Enterprise のオーナーは、自分の Enterprise のアカウントが所有するすべての Organization に対して特定のチームポリシーを強制したり、各 Organization ごとのポリシーの設定を許可したりすることができます。' product: '{% data reusables.gated-features.enterprise-accounts %}' redirect_from: - /articles/enforcing-team-settings-for-organizations-in-your-business-account/ diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/index.md b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/index.md index 076995d27fbd..edcdfe6119da 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/index.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/index.md @@ -14,6 +14,7 @@ versions: {% topic_link_in_list /managing-your-enterprise-account %} {% link_in_list /about-enterprise-accounts %} {% link_in_list /viewing-the-subscription-and-usage-for-your-enterprise-account %} + {% link_in_list /managing-licenses-for-visual-studio-subscription-with-github-enterprise %} {% topic_link_in_list /managing-users-in-your-enterprise-account %} {% link_in_list /roles-for-an-enterprise-account %} {% link_in_list /inviting-people-to-manage-your-enterprise-account %} @@ -32,3 +33,4 @@ versions: {% link_in_list /configuring-saml-single-sign-on-and-scim-for-your-enterprise-account-using-okta %} {% link_in_list /enforcing-a-policy-on-dependency-insights-in-your-enterprise-account %} {% link_in_list /enforcing-github-actions-policies-in-your-enterprise-account %} + {% link_in_list /configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md new file mode 100644 index 000000000000..62f0d9453bd4 --- /dev/null +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md @@ -0,0 +1,42 @@ +--- +title: Managing licenses for Visual Studio subscription with GitHub Enterprise +intro: 'You can manage {% data variables.product.prodname_enterprise %} licensing for {% data variables.product.prodname_vss_ghe %}.' +redirect_from: + - /github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-the-github-enterprise-and-visual-studio-bundle + - /github/articles/about-the-github-and-visual-studio-bundle + - /articles/about-the-github-and-visual-studio-bundle +versions: + free-pro-team: '*' +--- + +### {% data variables.product.prodname_vss_ghe %} について + +{% data variables.product.prodname_vss_ghe %} is a combined offering from Microsoft that allows a subscriber to use both {% data variables.product.prodname_enterprise %} and {% data variables.product.prodname_vs %}. {% data variables.product.prodname_vss_ghe %} is available from Microsoft under the terms of the Microsoft Enterprise Agreement. For more information, see [{% data variables.product.prodname_vss_ghe %}](https://visualstudio.microsoft.com/subscriptions/visual-studio-github/) on the {% data variables.product.prodname_vs %} website. + +After you assign a license for {% data variables.product.prodname_vss_ghe %} to a subscriber, the subscriber will use the {% data variables.product.prodname_enterprise %} portion of the license by joining an organization in your enterprise account with a user account on {% data variables.product.prodname_dotcom_the_website %}. + +{% data variables.product.prodname_enterprise %} の詳細は、「[{% data variables.product.company_short %} の製品](/github/getting-started-with-github/githubs-products#github-enterprise)」を参照してください。 For more information about accounts on {% data variables.product.prodname_dotcom_the_website %}, see "[Types of {% data variables.product.prodname_dotcom %} accounts](/github/getting-started-with-github/types-of-github-accounts)." + +### 必要な環境 + +1. After you buy {% data variables.product.prodname_vss_ghe %}, contact {% data variables.contact.contact_enterprise_sales %} and mention "{% data variables.product.prodname_vss_ghe %}." You'll work with the Sales team to create an enterprise account on {% data variables.product.prodname_dotcom_the_website %}. If you already have an enterprise account on {% data variables.product.prodname_dotcom_the_website %}, or if you're not sure, please tell our Sales team. + +2. Assign licenses for {% data variables.product.prodname_vss_ghe %} to subscribers in {% data variables.product.prodname_vss_admin_portal_with_url %}. For more information about assigning licenses, see [Manage {% data variables.product.prodname_vs %} subscriptions with {% data variables.product.prodname_enterprise %}](https://docs.microsoft.com/en-us/visualstudio/subscriptions/assign-github) in the Microsoft Docs. + +3. On {% data variables.product.prodname_dotcom_the_website %}, create at least one organization owned by your enterprise account. For more information, see "[Adding organizations to your enterprise account](/github/setting-up-and-managing-your-enterprise-account/adding-organizations-to-your-enterprise-account)." + +4. The subscriber must create a user account on {% data variables.product.prodname_dotcom_the_website %}, and the email address for the account must be the same email address as the email address in the {% data variables.product.prodname_vs %} portal. For more information, see "[Signing up for {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/signing-up-for-github)" and "[Managing email preferences](/github/setting-up-and-managing-your-github-user-account/managing-email-preferences)." + +### Inviting a subscriber to use {% data variables.product.prodname_enterprise %} + +To use the {% data variables.product.prodname_enterprise %} portion of the license, the subscriber must join an organization owned by your enterprise account on {% data variables.product.prodname_dotcom_the_website %}. Organization owners can invite new members to an organization. For more information, see "[Inviting users to join your organization](/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization)." + +### Viewing {% data variables.product.prodname_enterprise %} licensing + +After assigning a license for {% data variables.product.prodname_vss_ghe %} in {% data variables.product.prodname_vss_admin_portal_with_url %}, you can view the number of {% data variables.product.prodname_enterprise %} licenses available to your enterprise account. 詳細は「[Enterprise アカウントのプランおよび利用状況を見る示](/github/setting-up-and-managing-your-enterprise-account/viewing-the-subscription-and-usage-for-your-enterprise-account)」を参照してください。 + +You can also see pending {% data variables.product.prodname_enterprise %} invitations to subscribers in {% data variables.product.prodname_vss_admin_portal_with_url %}. The list of pending invitations includes subscribers who are not yet members of at least one organization in your enterprise account. 詳細は「[Enterprise アカウントの人を表示する](/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account#viewing-members-and-outside-collaborators)」を参照してください。 + +### 参考リンク + +- [Introducing Visual Studio subscriptions with GitHub Enterprise](https://docs.microsoft.com/en-us/visualstudio/subscriptions/access-github) in the Microsoft Docs diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/roles-for-an-enterprise-account.md b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/roles-for-an-enterprise-account.md index 0bdf4156f3e4..ee5d64edb54b 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/roles-for-an-enterprise-account.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/roles-for-an-enterprise-account.md @@ -1,6 +1,6 @@ --- title: Enterprise アカウントのロール -intro: Enterprise アカウントの設定およびデータへのアクセスを管理するために、Enterprise アカウントの人に異なるロールを割り当てることができます。 +intro: 'Enterprise アカウントの設定およびデータへのアクセスを管理するために、Enterprise アカウントの人に異なるロールを割り当てることができます。' product: '{% data reusables.gated-features.enterprise-accounts %}' redirect_from: - /articles/permission-levels-for-a-business-account/ diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/viewing-and-managing-a-users-saml-access-to-your-enterprise-account.md b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/viewing-and-managing-a-users-saml-access-to-your-enterprise-account.md index 343b0046ca19..2572ecc945eb 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/viewing-and-managing-a-users-saml-access-to-your-enterprise-account.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/viewing-and-managing-a-users-saml-access-to-your-enterprise-account.md @@ -1,6 +1,6 @@ --- title: Enterprise アカウントへのユーザの SAML アクセスの表示および管理 -intro: Enterprise メンバーのリンクされたアイデンティティ、アクティブなセッション、認可されたクレデンシャルの表示と取り消しが可能です。 +intro: 'Enterprise メンバーのリンクされたアイデンティティ、アクティブなセッション、認可されたクレデンシャルの表示と取り消しが可能です。' permissions: Enterprise オーナーは、組織へのメンバーの SAML アクセスを表示したり管理したりすることもできます。 product: '{% data reusables.gated-features.enterprise-accounts %}' versions: diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account.md b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account.md index 29c1d733f94e..7974006d168c 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account.md @@ -1,6 +1,6 @@ --- title: Enterprise アカウントの人を表示する -intro: Enterprise が所有するリソースやユーザライセンスの利用を監査するため、Enterprise のオーナーは、Enterprise アカウントの管理者およびメンバーすべてを表示できます。 +intro: 'Enterprise が所有するリソースやユーザライセンスの利用を監査するため、Enterprise のオーナーは、Enterprise アカウントの管理者およびメンバーすべてを表示できます。' product: '{% data reusables.gated-features.enterprise-accounts %}' redirect_from: - /articles/viewing-people-in-your-enterprise-account @@ -16,6 +16,7 @@ Enterprise のコードオーナー、支払いマネージャー、さらにオ {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.people-tab %} {% data reusables.enterprise-accounts.administrators-tab %} +1. Optionally, to view a list of pending invitations, click **_NUMBER_ pending**. !["NUMBER pending" button to the right of search and filter options](/assets/images/help/enterprises/administrators-pending.png) ### メンバーと外部コラボレーターを表示する @@ -25,7 +26,8 @@ Enterprise のコードオーナー、支払いマネージャー、さらにオ {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.people-tab %} -3. メンバーのリストではなく、外部コラボレーターのリストを表示したい場合は、[**Outside collaborators**] をクリックします。 ![Organization メンバーのページにある、[Outside collaborators] タブ](/assets/images/help/business-accounts/outside-collaborators-tab.png) +1. メンバーのリストではなく、外部コラボレーターのリストを表示したい場合は、[**Outside collaborators**] をクリックします。 ![Organization メンバーのページにある、[Outside collaborators] タブ](/assets/images/help/business-accounts/outside-collaborators-tab.png) +1. Optionally, to view a list of pending invitations, click **_NUMBER_ pending**. !["NUMBER pending" button to the right of search and filter options](/assets/images/help/enterprises/members-pending.png) ### 参考リンク diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/viewing-the-subscription-and-usage-for-your-enterprise-account.md b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/viewing-the-subscription-and-usage-for-your-enterprise-account.md index bb0dd9330928..0ff8b6cff990 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/viewing-the-subscription-and-usage-for-your-enterprise-account.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise-account/viewing-the-subscription-and-usage-for-your-enterprise-account.md @@ -1,8 +1,8 @@ --- title: Enterprise アカウントのプランおよび利用状況を表示する -intro: Enterprise アカウントの、現在のプラン、ライセンスの利用、請求書、支払い履歴、その他支払い情報を表示できます。 +intro: 'Enterprise アカウントの、現在のプラン、ライセンスの利用、請求書、支払い履歴、その他支払い情報を表示できます。' product: '{% data reusables.gated-features.enterprise-accounts %}' -permissions: Enterprise オーナーと支払いマネージャーは、Enterprise アカウントの支払い設定すべてに対するアクセスおよび管理が可能です。 支払いマネージャーの管理に関する詳細は、「Enterprise アカウントを管理するようユーザを招待する (/articles/inviting-people-to-manage-your-enterprise-account)」を参照してください。 +permissions: 'Enterprise オーナーと支払いマネージャーは、Enterprise アカウントの支払い設定すべてに対するアクセスおよび管理が可能です。 支払いマネージャーの管理に関する詳細は、「Enterprise アカウントを管理するようユーザを招待する (/articles/inviting-people-to-manage-your-enterprise-account)」を参照してください。' redirect_from: - /articles/viewing-the-subscription-and-usage-for-your-enterprise-account versions: diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/about-your-organizations-profile.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/about-your-organizations-profile.md index 5bab35508b58..dd349711c246 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/about-your-organizations-profile.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/about-your-organizations-profile.md @@ -11,7 +11,7 @@ versions: Organization の説明、場所、Web サイト、メールアドレスをオプションで追加することや、重要なリポジトリをページの上部にピン止めすることもできます。 -{% if currentVersion == "free-pro-team@latest" %}自分の Organization の素性を確認し、Organization のプロフィールページに "Verified (検証済み)" バッジを表示するには、Organization のドメインを {% data variables.product.product_name %}で検証しなければなりません。 詳しい情報については [Organization のドメインの検証](/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain)を参照してください。 +{% if currentVersion == "free-pro-team@latest" %}To confirm your organization's identity and display a "Verified" badge on your organization profile page, you must verify your organization's domains with {% data variables.product.product_name %}. 詳しい情報については [Organization のドメインの検証](/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain)を参照してください。 ![検証済み Organization プロフィールページのサンプル](/assets/images/help/profile/org_profile_verified.png) {% else %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/about-your-profile.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/about-your-profile.md index 4e1749028104..e764c48028d1 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/about-your-profile.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/about-your-profile.md @@ -1,6 +1,6 @@ --- title: プロフィールについて -intro: プロフィールページは、関心のあるリポジトリ、行ったコントリビューション、会話を通じて、あなたの作業の様子を他者に伝えます。 +intro: 'プロフィールページは、関心のあるリポジトリ、行ったコントリビューション、会話を通じて、あなたの作業の様子を他者に伝えます。' redirect_from: - /articles/viewing-your-feeds/ - /articles/profile-pages/ @@ -26,7 +26,7 @@ versions: - あなたが所有している、もしくはコントリビューションしたリポジトリと Gist。 リポジトリおよび Gist をプロフィールにピン止めすることで、あなたの最も優れた作業を提示することができます。 詳細は「[プロフィールにアイテムをピン止めする](/github/setting-up-and-managing-your-github-profile/pinning-items-to-your-profile)」を参照してください。 - Star を付けたリポジトリ。 詳しい情報については、「[Star を付けてリポジトリを保存する](/articles/saving-repositories-with-stars/)」を参照してください。 -- あなたが最もアクティブな Organization、リポジトリ、Team でのあなたのアクティビティの概要。 詳しい情報については、「[プロフィール上にアクティビティの概要を表示する](/articles/showing-an-overview-of-your-activity-on-your-profile)」を参照してください。{% if currentVersion == "free-pro-team@latest" %} +- あなたが最もアクティブな Organization、リポジトリ、Team でのあなたのアクティビティの概要。 For more information, see "[Showing an overview of your activity on your profile](/articles/showing-an-overview-of-your-activity-on-your-profile).{% if currentVersion == "free-pro-team@latest" %} - {% data variables.product.prodname_arctic_vault %}、{% data variables.product.prodname_sponsors %}、または {% data variables.product.company_short %} 開発者プログラムなどのプログラムに参加したことを示すバッジ。 - {% data variables.product.prodname_pro %} を使っているか。 詳細は「[プロフィールをパーソナライズする](/articles/personalizing-your-profile)」を参照してください。{% endif %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile.md index 6f7ff4d34ef0..eeeeaaf7e622 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile.md @@ -1,6 +1,6 @@ --- title: プロフィールでコントリビューショングラフを管理する -intro: コミット、プルリクエストの提案、Issue のオープンなどのコントリビューションはあなたのプロフィールに表示されるので、あなたが行った作業をユーザは簡単に確認できます。 +intro: 'コミット、プルリクエストの提案、Issue のオープンなどのコントリビューションはあなたのプロフィールに表示されるので、あなたが行った作業をユーザは簡単に確認できます。' mapTopic: true redirect_from: - /articles/managing-contribution-graphs-on-your-profile diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md index 61b6d346241e..92a86cbfe3f6 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md @@ -40,7 +40,7 @@ versions: ### プロフィール名を変更する -プロフィールに表示される名前は変更可能です。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}また、この名前は Organization が所有するプライベートリポジトリで付けたコメントの隣に表示される場合もあります。 詳細は「[Organization のメンバー名表示を管理する](/articles/managing-the-display-of-member-names-in-your-organization)」を参照してください。{% endif %} +プロフィールに表示される名前は変更可能です。 This name may also be displayed next to comments you make on private repositories owned by an organization. 詳細は「[Organization のメンバー名表示を管理する](/articles/managing-the-display-of-member-names-in-your-organization)」を参照してください。 {% data reusables.user_settings.access_settings %} 2. [Name] の下に、プロフィールに表示する名前を入力します。 ![プロフィール設定の [Name] フィールド](/assets/images/help/profile/name-field.png) @@ -101,12 +101,12 @@ versions: 特定のプログラムに参加すると、{% data variables.product.prodname_dotcom %} でプロフィールに自動的にバッジが表示されます。 -| バッジ | プログラム | 説明 | -| --------------------------------------------------------------- | ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| {% octicon "north-star" aria-label="The North Star icon" %} | **{% data variables.product.prodname_arctic_vault %} Contributor** | 2020 Arctic Vault プログラムでアーカイブされたリポジトリのデフォルトブランチでコミットを作成すると、プロフィールで {% data variables.product.prodname_arctic_vault %} コントリビューターバッジを取得できます。 詳しい情報については、[{% data variables.product.prodname_archive %}](https://archiveprogram.github.com) を参照してください。 | -| {% octicon "cpu" aria-label="The Developer Program icon" %} | **開発者プログラムメンバー** | GitHub 開発者プログラムの登録メンバーの場合は、GitHub API でアプリを開発すると、プロフィールで開発者プログラムメンバーのバッジを取得します。 GitHub 開発者の詳しい情報については、「[GitHub 開発者](/program/)」を参照してください。 | -| {% octicon "heart-fill" aria-label="The GitHub Sponsor icon" %} | **GitHub スポンサー** | {% data variables.product.prodname_sponsors %} を通じてオープンソースコントリビューターをスポンサーした場合、プロフィールで GitHub スポンサーのバッジを取得します。 詳細は、「[オープンソースコントリビューターに対するスポンサー](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-open-source-contributors)」を参照してください。 | -| {% octicon "star-fill" aria-label="The star icon" %} | **Pro** | {% data variables.product.prodname_pro %} を使用すると、プロフィールで PRO バッジを取得します。 {% data variables.product.prodname_pro %} の詳細は、「[{% data variables.product.prodname_dotcom %} の製品](/github/getting-started-with-github/githubs-products#github-pro)」を参照してください。 | +| バッジ | プログラム | 説明 | +| --------------------------------------------------------------- | -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| {% octicon "north-star" aria-label="The North Star icon" %} | **{% data variables.product.prodname_arctic_vault %} Contributor** | 2020 Arctic Vault プログラムでアーカイブされたリポジトリのデフォルトブランチでコミットを作成すると、プロフィールで {% data variables.product.prodname_arctic_vault %} コントリビューターバッジを取得できます。 詳しい情報については、[{% data variables.product.prodname_archive %}](https://archiveprogram.github.com) を参照してください。 | +| {% octicon "cpu" aria-label="The Developer Program icon" %} | **開発者プログラムメンバー** | GitHub 開発者プログラムの登録メンバーの場合は、GitHub API でアプリを開発すると、プロフィールで開発者プログラムメンバーのバッジを取得します。 GitHub 開発者の詳しい情報については、「[GitHub 開発者](/program/)」を参照してください。 | +| {% octicon "heart-fill" aria-label="The GitHub Sponsor icon" %} | **GitHub スポンサー** | {% data variables.product.prodname_sponsors %} を通じてオープンソースコントリビューターをスポンサーした場合、プロフィールで GitHub スポンサーのバッジを取得します。 詳細は、「[オープンソースコントリビューターに対するスポンサー](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-open-source-contributors)」を参照してください。 | +| {% octicon "star-fill" aria-label="The star icon" %} | **Pro** | {% data variables.product.prodname_pro %} を使用すると、プロフィールで PRO バッジを取得します。 {% data variables.product.prodname_pro %} の詳細は、「[{% data variables.product.prodname_dotcom %} の製品](/github/getting-started-with-github/githubs-products#github-pro)」を参照してください。 | ### プロフィールでバッジを無効にする diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/pinning-items-to-your-profile.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/pinning-items-to-your-profile.md index 0d9faff4ea5b..a1e566f1e67e 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/pinning-items-to-your-profile.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/pinning-items-to-your-profile.md @@ -1,6 +1,6 @@ --- title: プロフィールにアイテムをピン止めする -intro: '{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.16" %}Gist および{% endif %}リポジトリを自分のプロフィールにピン止めして、他の人があなたの最も優れた作業を素早く見つけられるようにできます。' +intro: 'You can pin {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.16" %}gists and {% endif %}repositories to your profile so other people can quickly see your best work.' redirect_from: - /articles/pinning-repositories-to-your-profile/ - /articles/pinning-items-to-your-profile diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/troubleshooting-commits-on-your-timeline.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/troubleshooting-commits-on-your-timeline.md index 53d3e624045e..43a2130df12b 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/troubleshooting-commits-on-your-timeline.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/troubleshooting-commits-on-your-timeline.md @@ -1,6 +1,6 @@ --- title: タイムライン上のコミットのトラブルシューティング -intro: プロフィールのタイムラインからのコミットの詳細を表示できます。 プロフィールにあるはずのコミットが表示されていない場合やプロフィールページからコミットの詳細を見つけられない場合、コミットの日付とコミット作者が異なる可能性があります。 +intro: 'プロフィールのタイムラインからのコミットの詳細を表示できます。 プロフィールにあるはずのコミットが表示されていない場合やプロフィールページからコミットの詳細を見つけられない場合、コミットの日付とコミット作者が異なる可能性があります。' redirect_from: - /articles/troubleshooting-commits-on-your-timeline versions: diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/viewing-contributions-on-your-profile.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/viewing-contributions-on-your-profile.md index f8a3f9bb3854..1f84ad87d4ba 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/viewing-contributions-on-your-profile.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/viewing-contributions-on-your-profile.md @@ -25,7 +25,7 @@ versions: - リポジトリのデフォルトブランチまたは `gh-pages` ブランチにコミットすること - Issue を開くこと - プルリクエストを提案すること -- プルリクエストレビューのサブミット{% if currentVersion != "free-pro-team@latest" %} +- Submitting a pull request review{% if currentVersion != "free-pro-team@latest" %} - リポジトリのデフォルトのブランチまたは `gh-pages` ブランチでコミットを共作{% endif %} {% data reusables.pull_requests.pull_request_merges_and_contributions %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/why-are-my-contributions-not-showing-up-on-my-profile.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/why-are-my-contributions-not-showing-up-on-my-profile.md index bf929064c2fe..d7410997184d 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/why-are-my-contributions-not-showing-up-on-my-profile.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-profile/why-are-my-contributions-not-showing-up-on-my-profile.md @@ -42,7 +42,7 @@ Issue とプルリクエストは、フォークではなく、スタンドア Commits must be made with an email address that has been added to your {% data variables.product.product_name %} account{% if currentVersion == "free-pro-team@latest" %}, or the {% data variables.product.product_name %}-provided `noreply` email address provided to you in your email settings,{% endif %} in order to appear on your contributions graph.{% if currentVersion == "free-pro-team@latest" %} For more information about `noreply` email addresses, see "[Setting your commit email address](/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address#about-commit-email-addresses)."{% endif %} -You can check the email address used for a commit by adding `.patch` to the end of a commit URL, e.g. https://github.com/octocat/octocat.github.io/commit/67c0afc1da354d8571f51b6f0af8f2794117fd10.patch: +コミット URL の最後に `.patch` を追加すると、コミットに使用されたメールアドレスを確認できます。例: https://github.com/octocat/octocat.github.io/commit/67c0afc1da354d8571f51b6f0af8f2794117fd10.patch: ``` From 67c0afc1da354d8571f51b6f0af8f2794117fd10 Mon Sep 17 00:00:00 2001 @@ -67,7 +67,7 @@ Subject: [PATCH] より良いウェルカムメッセージのためのインデ コミットがデフォルト以外または `gh-pages` 以外のブランチにあり、コントリビューションにカウントする場合は、以下のうち 1 つを行う必要があります: - 変更をデフォルトのブランチまたは `gh-pages` ブランチにマージするには、[プルリクエストを開きます](/articles/creating-a-pull-request)。 -- リポジトリの[デフォルトブランチを変更します](/articles/setting-the-default-branch)。 +- リポジトリの[デフォルトブランチを変更します](/github/administering-a-repository/changing-the-default-branch)。 {% warning %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/about-your-personal-dashboard.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/about-your-personal-dashboard.md index a95abb43cfc4..da70222a551e 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/about-your-personal-dashboard.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/about-your-personal-dashboard.md @@ -4,7 +4,7 @@ redirect_from: - /hidden/about-improved-navigation-to-commonly-accessed-pages-on-github/ - /articles/opting-into-the-public-beta-for-a-new-dashboard/ - /articles/about-your-personal-dashboard -intro: パーソナルダッシュボードにアクセスして、作業したりフォローしたりしている Issue やプルリクエストを追跡したり、トップリポジトリや Team のページにアクセスしたり、Organization やサブスクライブしているリポジトリの最近のアクティビティを知ったり、推奨されたリポジトリを調べたりできます。 +intro: 'パーソナルダッシュボードにアクセスして、作業したりフォローしたりしている Issue やプルリクエストを追跡したり、トップリポジトリや Team のページにアクセスしたり、Organization やサブスクライブしているリポジトリの最近のアクティビティを知ったり、推奨されたリポジトリを調べたりできます。' versions: free-pro-team: '*' enterprise-server: '*' @@ -46,7 +46,7 @@ versions: ### 推奨されているリポジトリを調べる -ダッシュボードの右側にある [Explore repositories] セクションでは、コミュニティで推奨されているリポジトリを調べることができます。 推奨は、Star を付けたりアクセスしたりしたリポジトリ、フォローしているユーザ、アクセスしたリポジトリ内のアクティビティに基づいています。{% if currentVersion == "free-pro-team@latest" %}詳細は、「[{% data variables.product.prodname_dotcom %} でオープンソースにコントリビュートする方法を見つける](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)」を参照してください。{% endif %} +ダッシュボードの右側にある [Explore repositories] セクションでは、コミュニティで推奨されているリポジトリを調べることができます。 Recommendations are based on repositories you've starred or visited, the people you follow, and activity within repositories that you have access to.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[Finding ways to contribute to open source on {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)."{% endif %} ### 参考リンク diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/accessing-an-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/accessing-an-organization.md index 0fce14632de4..4767003c2420 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/accessing-an-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/accessing-an-organization.md @@ -1,6 +1,6 @@ --- title: Organization へのアクセス -intro: 自分がメンバーになっている Organization にアクセスするには、個人ユーザアカウントにサインインしなければなりません。 +intro: '自分がメンバーになっている Organization にアクセスするには、個人ユーザアカウントにサインインしなければなりません。' redirect_from: - /articles/error-cannot-log-in-that-account-is-an-organization/ - /articles/cannot-log-in-that-account-is-an-organization/ diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/best-practices-for-leaving-your-company.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/best-practices-for-leaving-your-company.md index df1170b8c91b..3c49071ad505 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/best-practices-for-leaving-your-company.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/best-practices-for-leaving-your-company.md @@ -1,6 +1,6 @@ --- title: 退職のためのベストプラクティス -intro: 転職は人生の現実です。 GitHub のアカウントを個人と仕事の*両方で*使っているなら、会社や組織を辞める際に念頭に置いておくべきことがあります。 +intro: '転職は人生の現実です。 GitHub のアカウントを個人と仕事の*両方で*使っているなら、会社や組織を辞める際に念頭に置いておくべきことがあります。' redirect_from: - /articles/best-practices-for-leaving-your-company versions: diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/blocking-command-line-pushes-that-expose-your-personal-email-address.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/blocking-command-line-pushes-that-expose-your-personal-email-address.md index 68329d4d13d8..1f50c8f35497 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/blocking-command-line-pushes-that-expose-your-personal-email-address.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/blocking-command-line-pushes-that-expose-your-personal-email-address.md @@ -1,6 +1,6 @@ --- title: 個人のメールアドレスを公開するコマンドラインのプッシュのブロック -intro: Web ベースの操作をする際にメールアドレスをプライベートに保つよう選択したなら、個人のメールアドレスを公開してしまうかもしれないコマンドラインのプッシュをブロックするように選択することもできます。 +intro: 'Web ベースの操作をする際にメールアドレスをプライベートに保つよう選択したなら、個人のメールアドレスを公開してしまうかもしれないコマンドラインのプッシュをブロックするように選択することもできます。' redirect_from: - /articles/blocking-command-line-pushes-that-expose-your-personal-email-address versions: diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/changing-your-github-username.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/changing-your-github-username.md index 319ca5bc3e4d..8140f491016e 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/changing-your-github-username.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/changing-your-github-username.md @@ -1,6 +1,6 @@ --- -title: GitHub ユーザ名の変更 -intro: '{% data variables.product.product_name %}ユーザ名はいつでも変更できます。' +title: Changing your GitHub username +intro: 'You can change your {% data variables.product.product_name %} username at any time.' redirect_from: - /articles/how-to-change-your-username/ - /articles/changing-your-github-user-name/ @@ -12,46 +12,50 @@ versions: enterprise-server: '*' --- -### ユーザ名の変更について +### About username changes -ユーザ名は、現在使われていない別のユーザ名に変更できます。{% if currentVersion == "free-pro-team@latest" %}希望するユーザ名が使えない場合、そのユーザ名を入力したときに、ユーザ名のリリースをリクエストできるかについての情報が表示されます。 +You can change your username to another username that is not currently in use.{% if currentVersion == "free-pro-team@latest" %} If the username you want is not available, you'll see information about whether you can request the username to be released when you type in the desired username. -ユーザ名がリリースできず、かつそのユーザ名の商標を持っていない場合、別のユーザ名を選択するか、現在のユーザ名をそのまま使うことができます。 {% data variables.contact.github_support %} では、利用できないユーザ名をリリースできません。 詳細は「[ユーザ名を変更する](#changing-your-username)」を参照してください。{% endif %} +If the username is not eligible for release and you don't hold a trademark for the username, you can choose another username or keep your current username. {% data variables.contact.github_support %} cannot release the unavailable username for you. For more information, see "[Changing your username](#changing-your-username)."{% endif %} -ユーザ名を変更すると、変更前のユーザ名は誰でも取得できるようになります。 古いユーザ名の下にあるリポジトリへの参照のほとんどが、自動で新しいユーザ名に変わります。 ただし、プロフィールへのリンクによっては、自動的にリダイレクトされません。 +After changing your username, your old username becomes available for anyone else to claim. Most references to your repositories under the old username automatically change to the new username. However, some links to your profile won't automatically redirect. -{% data variables.product.product_name %} は、次のリダイレクトを設定できません: -- 古いユーザ名を使用する [@メンション](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams) -- 古いユーザ名を含む [Gist](/articles/creating-gists) にリンクする +{% data variables.product.product_name %} cannot set up redirects for: +- [@mentions](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams) using your old username +- Links to [gists](/articles/creating-gists) that include your old username -### リポジトリ参照 +### Repository references -ユーザ名を変更した後、{% data variables.product.product_name %} は自動的にあなたのリポジトリへの参照をリダイレクトします。 -- 既存のリポジトリへの Web リンクは引き続き機能します。 変更を加えてから完了するまでに数分かかることがあります。 -- ローカルリポジトリのクローンから古いリモートトラッキング URL へのコマンドラインプッシュは引き続き機能します。 +After you change your username, {% data variables.product.product_name %} will automatically redirect references to your repositories. +- Web links to your existing repositories will continue to work. This can take a few minutes to complete after you make the change. +- Command line pushes from your local repository clones to the old remote tracking URLs will continue to work. -古いユーザ名の新しい所有者が、あなたのリポジトリと同じ名前のリポジトリを作成すると、リダイレクトエントリが上書きされ、リダイレクトは機能しなくなります。 こうしたことが起こることを防ぐため、ユーザ名を変更したら、既存のすべてのリモートリポジトリ URL を更新することをお勧めします。 詳しい情報については、「[リモートの URL を変更する](/articles/changing-a-remote-s-url)」を参照してください。 +If the new owner of your old username creates a repository with the same name as your repository, that will override the redirect entry and your redirect will stop working. Because of this possibility, we recommend you update all existing remote repository URLs after changing your username. For more information, see "[Changing a remote's URL](/articles/changing-a-remote-s-url)." -### 前のプロフィールページにリンクする +### Links to your previous profile page -ユーザ名を変更した後、`https://{% data variables.command_line.backticks %}/previoususername` のように前のプロフィールページにリンクすると 404 エラーが返されます。 {% data variables.product.product_name %} アカウントへのリンクを別の場所{% if currentVersion == "free-pro-team@latest" %} (LinkedIn や Twitter のプロフィールなど) {% endif %}から更新することをお勧めします。 +After changing your username, links to your previous profile page, such as `https://{% data variables.command_line.backticks %}/previoususername`, will return a 404 error. We recommend updating any links to your {% data variables.product.product_name %} account from elsewhere{% if currentVersion == "free-pro-team@latest" %}, such as your LinkedIn or Twitter profile{% endif %}. -### Git コミット +### Your Git commits -{% if currentVersion == "free-pro-team@latest"%}`noreply` メールアドレスが提供され、あなたの {% data variables.product.product_name %} に関連付けられた Git コミットは、あなたの新しいユーザ名に起因するものではなく、あなたのコントリビューショングラフには表示されません 。{% endif %}Git コミットが、{% if currentVersion == "free-pro-team@latest"%}ID ベースの {% data variables.product.product_name %} の提供された `noreply` メールアドレスを含む{% endif %} [GitHub アカウントに追加された](/articles/adding-an-email-address-to-your-github-account)別のメールアドレスに関連付けられている場合、ユーザ名を変更した後も、それらは引き続きあなたに帰属し、あなたのコントリビューショングラフに表示されます。 メールアドレスの設定に関する詳細は「[コミットメールアドレスを設定する](/articles/setting-your-commit-email-address)」を参照してください。 +{% if currentVersion == "free-pro-team@latest"%}Git commits that were associated with your {% data variables.product.product_name %}-provided `noreply` email address won't be attributed to your new username and won't appear in your contributions graph.{% endif %} If your Git commits are associated with another email address you've [added to your GitHub account](/articles/adding-an-email-address-to-your-github-account), {% if currentVersion == "free-pro-team@latest"%}including the ID-based {% data variables.product.product_name %}-provided `noreply` email address, {% endif %}they'll continue to be attributed to you and appear in your contributions graph after you've changed your username. For more information on setting your email address, see "[Setting your commit email address](/articles/setting-your-commit-email-address)." -### ユーザ名を変更する +### Changing your username {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.account_settings %} -3. [Change username] セクションで [**Change username**] をクリックします。 ![Change Username button](/assets/images/help/settings/settings-change-username.png){% if currentVersion == "free-pro-team@latest" %} -4. ユーザ名を変更することに関する警告を読みます。 ユーザ名を変更したい場合は、[**I understand, let's change my username**] をクリックします。 ![[Change Username] 警告ボタン](/assets/images/help/settings/settings-change-username-warning-button.png) -5. 新しいユーザ名を入力します。 ![新しいユーザ名のフィールド](/assets/images/help/settings/settings-change-username-enter-new-username.png) -6. 選択したユーザ名が利用できる場合、[**Change my username**] をクリックします。 選択したユーザ名が利用できない場合、別のユーザ名を入力するか、提案されたユーザ名を利用できます。 ![[Change Username] 警告ボタン](/assets/images/help/settings/settings-change-my-username-button.png) +3. In the "Change username" section, click **Change username**. + ![Change Username button](/assets/images/help/settings/settings-change-username.png){% if currentVersion == "free-pro-team@latest" %} +4. Read the warnings about changing your username. If you still want to change your username, click **I understand, let's change my username**. + ![Change Username warning button](/assets/images/help/settings/settings-change-username-warning-button.png) +5. Type a new username. + ![New username field](/assets/images/help/settings/settings-change-username-enter-new-username.png) +6. If the username you've chosen is available, click **Change my username**. If the username you've chosen is unavailable, you can try a different username or one of the suggestions you see. + ![Change Username warning button](/assets/images/help/settings/settings-change-my-username-button.png) {% endif %} -### 参考リンク +### Further reading -- 「[リモートの URL を変更する](/articles/changing-a-remote-s-url)」 -- 「[コミットが間違ったユーザにリンクされているのはなぜですか？](/articles/why-are-my-commits-linked-to-the-wrong-user)」{% if currentVersion == "free-pro-team@latest" %} -- 「[{% data variables.product.prodname_dotcom %} ユーザ名に関するポリシー](/articles/github-username-policy)"{% endif %} +- "[Changing a remote's URL](/articles/changing-a-remote-s-url)" +- "[Why are my commits linked to the wrong user?](/articles/why-are-my-commits-linked-to-the-wrong-user)"{% if currentVersion == "free-pro-team@latest" %} +- "[{% data variables.product.prodname_dotcom %} Username Policy](/articles/github-username-policy)"{% endif %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md index ae0cb36d5d73..1904033fee8f 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md @@ -8,6 +8,12 @@ versions: enterprise-server: '*' --- +{% note %} + +**Note:** You cannot change your primary email address to an email that is already set to be your backup email address. + +{% endnote %} + {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.emails %} 3. プライマリメールアドレスとして新しいメールアドレスを追加したい場合、[Add email address] の下で新しいメールアドレスを入力し、[**Add**] をクリックします。 ![別のメールアドレスを追加するボタン](/assets/images/help/settings/add_another_email_address.png) @@ -15,7 +21,8 @@ versions: 5. To remove the old email address from your account, next to the old email, click {% octicon "trashcan" aria-label="The trashcan symbol" %}. {% if currentVersion == "free-pro-team@latest" %} -6. 新しいプライマリメールアドレスを検証してください。 検証済みメールアドレスがないと、{% data variables.product.product_name %}の一部の機能を利用できません。 詳細は「[メールアドレスを検証する](/articles/verifying-your-email-address)」を参照してください。 +6. 新しいプライマリメールアドレスを検証してください。 Without a verified email address, you won't be able to use all of +{% data variables.product.product_name %}'s features. 詳細は「[メールアドレスを検証する](/articles/verifying-your-email-address)」を参照してください。 {% endif %} ### 参考リンク diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md index 451045db59be..8426f4fdf93c 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md @@ -17,7 +17,7 @@ versions: - 変換したユーザアカウントには、サインイン**できなくなります**。 - 変換したユーザアカウントが所有していた Gist を作成や変更することは**できなくなります**。 - Organization をユーザに変換して元に戻すことは**できません**。 - - SSH キー、OAuth トークン、ジョブプロフィール、{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}リアクション、{% endif %}および関連するユーザ情報は、Organization に移譲**されません**。 これは、変換されたユーザアカウントのみに該当し、ユーザアカウントのコラボレーターには該当しません。 + - The SSH keys, OAuth tokens, job profile, reactions, and associated user information, **will not** be transferred to the organization. これは、変換されたユーザアカウントのみに該当し、ユーザアカウントのコラボレーターには該当しません。 - 変換したユーザアカウントによるコミットは、アカウントに**リンクされなくなります**。 コミットそのものは、**そのまま残ります**。 {% endwarning %} @@ -35,7 +35,7 @@ Organization の名前を、あなたの個人アカウントが使用してい あなたの個人ユーザアカウントを Organization に直接変換することも可能です。 アカウントを変換すると、以下のことが起こります: - リポジトリはそのまま保持されます。他のアカウントに手動で移譲する必要はありません。 - コラボレーターを、Team に自動的に招待します。コラボレーターの権限は、以前のものがそのまま引き継がれます。 - {% if currentVersion == "free-pro-team@latest" %}- {% data variables.product.prodname_pro %} のユーザアカウントでは、支払い情報の入力や支払いサイクルの調整も必要なく、また二重の支払いもすることなく、自動的に[有料 {% data variables.product.prodname_team %}](/articles/about-billing-for-github-accounts) に移行できます。{% endif %} + {% if currentVersion == "free-pro-team@latest" %}- For user accounts on {% data variables.product.prodname_pro %}, automatically transitions billing to [the paid {% data variables.product.prodname_team %}](/articles/about-billing-for-github-accounts) without the need to re-enter payment information, adjust your billing cycle, or double pay at any time{% endif %} 1. GitHub にサインインし、変換後に Organization やリポジトリにアクセスするために使う、新しい個人アカウントを作成します。 2. 変換するアカウントで参加している、[すべての Organization から自分を削除](/articles/removing-yourself-from-an-organization)してください。 @@ -56,5 +56,5 @@ Organization の名前を、あなたの個人アカウントが使用してい ### 参考リンク - [Team の設定](/articles/setting-up-teams) -{% if currentVersion == "free-pro-team@latest" %}-"[Organization に参加するようユーザを招待する](/articles/inviting-users-to-join-your-organization){% endif %} +{% if currentVersion == "free-pro-team@latest" %}- "[Inviting users to join your organization](/articles/inviting-users-to-join-your-organization)"{% endif %} - [Organization にアクセスする](/articles/accessing-an-organization) diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/deleting-your-user-account.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/deleting-your-user-account.md index aaf1d5eca3c7..6f58ce69c455 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/deleting-your-user-account.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/deleting-your-user-account.md @@ -9,9 +9,9 @@ versions: enterprise-server: '*' --- -自分のユーザアカウントを削除すると、リポジトリ、プライベートリポジトリのフォーク、ウィキ、Issue、プルリクエスト、また自分のアカウントが所有しているページもすべて削除されます。 {% if currentVersion == "free-pro-team@latest" %} 他のユーザが所有するリポジトリでこれまで作成した Issue とプルリクエスト、また行ったコメントが削除されることはなく、代わりに [ゴーストユーザ](https://github.com/ghost)に関連付けられます。{% else %}他のユーザが所有するリポジトリでこれまで作成した Issue とプルリクエスト、また行ったコメントが削除されることはありません。{% endif %} +自分のユーザアカウントを削除すると、リポジトリ、プライベートリポジトリのフォーク、ウィキ、Issue、プルリクエスト、また自分のアカウントが所有しているページもすべて削除されます。 {% if currentVersion == "free-pro-team@latest" %} Issues and pull requests you've created and comments you've made in repositories owned by other users will not be deleted - instead, they'll be associated with our [Ghost user](https://github.com/ghost).{% else %}Issues and pull requests you've created and comments you've made in repositories owned by other users will not be deleted.{% endif %} -{% if currentVersion == "free-pro-team@latest" %} アカウント名も新しいアカウントで誰でも使用できるようになり、請求も停止します。 アカウントに関連付けられていたメールアドレスは別の {% data variables.product.product_name %} アカウントで使用できるようになります。 {% endif %} +{% if currentVersion == "free-pro-team@latest" %} The account name also becomes available to anyone else to use on a new account, and we stop billing you. アカウントに関連付けられていたメールアドレスは別の {% data variables.product.product_name %} アカウントで使用できるようになります。 {% endif %} あなたが Organization のただ一人のオーナーの場合は、ユーザアカウントを削除する前に、所有権を他の人に移譲するか、Organization を削除する必要があります。 Organization に別のオーナーがいる場合は、自分のユーザアカウントを削除する前に、Organization から自分を削除する必要があります。 @@ -38,7 +38,7 @@ versions: - 自分が Organization で唯一のオーナーの場合、Organization を削除する前に所有権を別の人に移譲する必要があります。 - Organization に別のオーナーがいる場合は、自分自身を Organization から削除する必要があります。 ![アカウント削除ボタン](/assets/images/help/settings/settings-account-delete.png) 4. [Make sure you want to do this] ダイアログボックスで、アカウントを削除すると何が起こるか理解したことを確認する手順を完了させます: ![アカウント削除の確認ダイアログ](/assets/images/help/settings/settings-account-deleteconfirm.png) - {% if currentVersion == "free-pro-team@latest" %}- リポジトリ、プライベートリポジトリのフォーク、wiki、Issue、プルリクエスト、自分のアカウントが所有しているページがすべて削除されること、支払いが終了すること、ユーザ名が {% data variables.product.product_name %} 上で誰でも使用できるようになることを再確認します。 + {% if currentVersion == "free-pro-team@latest" %}- Recall that all repositories, forks of private repositories, wikis, issues, pull requests and pages owned by your account will be deleted, your billing will end, and your username will be available to anyone for use on {% data variables.product.product_name %}. {% else %}- リポジトリ、プライベートリポジトリのフォーク、ウィキ、Issue、プルリクエスト、そして自分のアカウントが所有しているページが、すべて削除されること、ユーザ名が {% data variables.product.product_name %} 上で誰でも使用できるようになることを再確認します。 {% endif %}- 最初のフィールドに、自分の {% data variables.product.product_name %}ユーザ名またはメールアドレスを入力してください。 - 2 番目のフィールドに、指示されたとおりのフレーズを入力してください。 diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/integrating-jira-with-your-personal-projects.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/integrating-jira-with-your-personal-projects.md index 10a13c943bb0..ac3d952b950f 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/integrating-jira-with-your-personal-projects.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/integrating-jira-with-your-personal-projects.md @@ -1,6 +1,6 @@ --- title: JIRA を個人プロジェクトに統合する -intro: Jira Cloud をユーザ アカウントに統合すると、コミットとプルリクエストをスキャンし、メンションされている JIRA の Issue で、関連するメタデータとハイパーリンクを作成できます。 +intro: 'Jira Cloud をユーザ アカウントに統合すると、コミットとプルリクエストをスキャンし、メンションされている JIRA の Issue で、関連するメタデータとハイパーリンクを作成できます。' redirect_from: - /articles/integrating-jira-with-your-personal-projects versions: diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository.md index c46d2bb8e71c..55fc75c8beea 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository.md @@ -1,6 +1,6 @@ --- title: コラボレーターを個人リポジトリに招待する -intro: '個人リポジトリにコラボレーターとして{% if currentVersion == "free-pro-team@latest" %}ユーザを招待{% else %}ユーザを追加{% endif %}することができます。' +intro: 'You can {% if currentVersion == "free-pro-team@latest" %}invite users to become{% else %}add users as{% endif %} collaborators to your personal repository.' redirect_from: - /articles/how-do-i-add-a-collaborator/ - /articles/adding-collaborators-to-a-personal-repository/ @@ -29,7 +29,7 @@ Organization が所有するリポジトリは、細やかなアクセスを許 1. コラボレーターとして招待する人のユーザ名を確認してください。 -{% if currentVersion == "free-pro-team@latest" %}まだユーザ名がない場合は、{% data variables.product.prodname_dotcom %}にサインアップできます。詳細は「[新しい {% data variables.product.prodname_dotcom %}アカウントへのサインアップ](/articles/signing-up-for-a-new-github-account)」を参照してください。{% endif %} +{% if currentVersion == "free-pro-team@latest" %} If they don't have a username yet, they can sign up for {% data variables.product.prodname_dotcom %} For more information, see "[Signing up for a new {% data variables.product.prodname_dotcom %} account](/articles/signing-up-for-a-new-github-account)".{% endif %} {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} {% if currentVersion == "free-pro-team@latest" %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md index 38a5c42ebc64..09d15752361b 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md @@ -1,6 +1,6 @@ --- title: ユーザ アカウントのプロジェクトボードに対するアクセスを管理する -intro: プロジェクトボードのオーナーは、コラボレーターを追加または削除して、そのプロジェクトボードに対する権限をカスタマイズすることができます。 +intro: 'プロジェクトボードのオーナーは、コラボレーターを追加または削除して、そのプロジェクトボードに対する権限をカスタマイズすることができます。' redirect_from: - /articles/managing-project-boards-in-your-repository-or-organization/ - /articles/managing-access-to-your-user-account-s-project-boards @@ -18,7 +18,9 @@ versions: {% data reusables.project-management.click-menu %} {% data reusables.project-management.access-collaboration-settings %} {% data reusables.project-management.collaborator-option %} -5. [Search by username, full name or email address] で、コラボレーターの名前、ユーザ名、または {% data variables.product.prodname_dotcom %} メールを入力します。 ![Octocat のユーザ名が検索フィールドに入力されているコラボレーターセクション](/assets/images/help/projects/org-project-collaborators-find-name.png) +5. Under "Search by username, full name or email address", type the collaborator's name, username, or +{% data variables.product.prodname_dotcom %} email. + ![Octocat のユーザ名が検索フィールドに入力されているコラボレーターセクション](/assets/images/help/projects/org-project-collaborators-find-name.png) {% data reusables.project-management.add-collaborator %} 7. 新しいコラボレーターは、デフォルトで読み取り権限を持ちます。 オプションで、新しいコラボレータの名前の隣にあるドロップダウン メニューを使って、権限レベルを変更することもできます。 ![[Collaborators] セクションで [Permissions] ドロップダウン メニューを選択](/assets/images/help/projects/user-project-collaborators-edit-permissions.png) diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md index f8527e7cc182..2ed2c8fcacd4 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md @@ -1,6 +1,6 @@ --- title: リポジトリのデフォルトブランチ名を管理する -intro: You can set a default branch name for all new repositories that you create. +intro: 'You can set the default branch name new repositories that you create on {% data variables.product.product_location %}.' versions: free-pro-team: '*' enterprise-server: '>=2.23' @@ -8,12 +8,10 @@ versions: ### デフォルトブランチ名について -{% data reusables.branches.new-repo-default-branch %} This branch is currently named `master`, but you can set the default branch name to anything that makes sense for your development environment. +When you create a new repository on {% data variables.product.product_location %}, the repository contains one branch, which is the default branch. You can change the name that {% data variables.product.product_name %} uses for the default branch in new repositories you create. For more information about the default branch, see "[About branches](/github/collaborating-with-issues-and-pull-requests/about-branches#about-the-default-branch)." {% data reusables.branches.set-default-branch %} -{% data reusables.branches.rename-existing-branch %} - ### デフォルトブランチ 名を設定する {% data reusables.user_settings.access_settings %} @@ -24,4 +22,4 @@ versions: ### 参考リンク -- [Organization のリポジトリのデフォルブランチ名を管理する](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization) +- "[Managing the default branch name for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization)" diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/managing-user-account-settings.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/managing-user-account-settings.md index 93ee47856285..9a641706d787 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/managing-user-account-settings.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/managing-user-account-settings.md @@ -1,6 +1,6 @@ --- title: ユーザ アカウント設定の管理 -intro: ユーザ名を変更する、アカウントを削除するなど、個人アカウントの設定を変更できます。 +intro: 'ユーザ名を変更する、アカウントを削除するなど、個人アカウントの設定を変更できます。' redirect_from: - /categories/29/articles/ - /categories/user-accounts/ diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations.md index 6b172ac27c7d..1700210f851b 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations.md @@ -1,6 +1,6 @@ --- title: Organization でメンバーシップを管理する -intro: Organization のメンバーは、メンバーシップの公開/非公開の切り替え、他のユーザのロールの閲覧、Organization からの自身の削除を行うことができます。 +intro: 'Organization のメンバーは、メンバーシップの公開/非公開の切り替え、他のユーザのロールの閲覧、Organization からの自身の削除を行うことができます。' mapTopic: true redirect_from: - /articles/managing-your-membership-in-organizations diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/merging-multiple-user-accounts.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/merging-multiple-user-accounts.md index 5b2d2a22bd6f..d6845a77ca29 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/merging-multiple-user-accounts.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/merging-multiple-user-accounts.md @@ -1,6 +1,6 @@ --- title: 複数のユーザアカウントをマージする -intro: 業務用と個人用に別々のアカウントを持っている場合は、アカウントをマージできます。 +intro: '業務用と個人用に別々のアカウントを持っている場合は、アカウントをマージできます。' redirect_from: - /articles/can-i-merge-two-accounts/ - /articles/keeping-work-and-personal-repositories-separate/ diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md index 5ec982ccad7c..c6ebc8a604b9 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md @@ -1,6 +1,6 @@ --- -title: ユーザーアカウントのリポジトリ権限レベル -intro: ユーザーアカウントが所有するリポジトリは、*リポジトリオーナー*と*コラボレーター*という 2 つの権限レベルを持ちます。 +title: Permission levels for a user account repository +intro: 'A repository owned by a user account has two permission levels: the *repository owner* and *collaborators*.' redirect_from: - /articles/permission-levels-for-a-user-account-repository versions: @@ -10,65 +10,64 @@ versions: {% tip %} -**ヒント:** ユーザーアカウントが所有しているリポジトリに対して、より精細な読み取り/書き込みアクセス権が必要な場合には、リポジトリを Organization に移譲することを検討してください。 詳細は「[リポジトリを移譲する](/articles/transferring-a-repository)」を参照してください。 +**Tip:** If you require more granular read/write access to a repository owned by your user account, consider transferring the repository to an organization. For more information, see "[Transferring a repository](/articles/transferring-a-repository)." {% endtip %} -#### ユーザーアカウントが所有しているリポジトリに対するオーナーアクセス権 +#### Owner access on a repository owned by a user account -リポジトリオーナーは、リポジトリを完全に制御することができます。 リポジトリコラボレータによって許可されるすべての権限に加えて、リポジトリオーナーは次の操作が可能です: +The repository owner has full control of the repository. In addition to all the permissions allowed by repository collaborators, the repository owner can: -- {% if currentVersion == "free-pro-team@latest" %}[コラボレーターを招待する](/articles/inviting-collaborators-to-a-personal-repository){% else %}[コラボレーターを追加する](/articles/inviting-collaborators-to-a-personal-repository){% endif %} -- リポジトリの可視性を変更する ([public から private へ](/articles/making-a-public-repository-private)、または [private から public](/articles/making-a-private-repository-public) へ) {% if currentVersion == "free-pro-team@latest" %} -- [リポジトリでのインタラクションを制限する](/articles/limiting-interactions-with-your-repository){% endif %} -- 保護されたブランチで、レビューの承認がなくてもプルリクエストをマージする -- [リポジトリを削除する](/articles/deleting-a-repository) -- [リポジトリのトピックを管理する](/articles/classifying-your-repository-with-topics){% if currentVersion == "free-pro-team@latest" %} +- {% if currentVersion == "free-pro-team@latest" %}[Invite collaborators](/articles/inviting-collaborators-to-a-personal-repository){% else %}[Add collaborators](/articles/inviting-collaborators-to-a-personal-repository){% endif %} +- Change the visibility of the repository (from [public to private](/articles/making-a-public-repository-private), or from [private to public](/articles/making-a-private-repository-public)){% if currentVersion == "free-pro-team@latest" %} +- [Limit interactions with a repository](/articles/limiting-interactions-with-your-repository){% endif %} +- Merge a pull request on a protected branch, even if there are no approving reviews +- [Delete the repository](/articles/deleting-a-repository) +- [Manage a repository's topics](/articles/classifying-your-repository-with-topics){% if currentVersion == "free-pro-team@latest" %} - Manage security and analysis settings. For more information, see "[Managing security and analysis settings for your user account](/github/setting-up-and-managing-your-github-user-account/managing-security-and-analysis-settings-for-your-user-account)."{% endif %}{% if currentVersion == "free-pro-team@latest" %} -- プライベートリポジトリに対して[依存グラフを有効にする](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository){% endif %}{% if currentVersion == "free-pro-team@latest" %} -- パッケージを削除する。 詳細は「[>パッケージを削除する](/github/managing-packages-with-github-packages/deleting-a-package)」を参照してください。{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -- リポジトリソーシャルカードを作成および編集する。 詳細は「[リポジトリのソーシャルメディア向けプレビューをカスタマイズする](/articles/customizing-your-repositorys-social-media-preview)」を参照してください。 -- リポジトリをテンプレートにする。 詳細は「[テンプレートリポジトリを作成する](/articles/creating-a-template-repository)を参照してください。{% endif %} -- 脆弱な依存関係についての[{% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}セキュリティ{% endif %}アラートを受け取ります](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)。 {% if currentVersion == "free-pro-team@latest" %} -- リポジトリで {% data variables.product.prodname_dependabot_alerts %} を閉じます。 詳細については、「[リポジトリ内の脆弱な依存関係を表示・更新する](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)」を参照してください。 -- [プライベートリポジトリのデータ使用を管理する](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository){% endif %} -- [リポジトリのコードオーナーを定義する](/articles/about-code-owners) -- [リポジトリをアーカイブする](/articles/about-archiving-repositories){% if currentVersion == "free-pro-team@latest" %} -- セキュリティアドバイザリを作成する。 詳しい情報については「[{% data variables.product.prodname_security_advisories %}について](/github/managing-security-vulnerabilities/about-github-security-advisories)」を参照してください。 -- スポンサーボタンを表示する。 詳細は「[リポジトリにスポンサーボタンを表示する](/articles/displaying-a-sponsor-button-in-your-repository)」を参照してください。{% endif %} +- [Enable the dependency graph](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) for a private repository{% endif %}{% if currentVersion == "free-pro-team@latest" %} +- Delete packages. For more information, see "[Deleting a package](/github/managing-packages-with-github-packages/deleting-a-package)."{% endif %} +- Create and edit repository social cards. For more information, see "[Customizing your repository's social media preview](/articles/customizing-your-repositorys-social-media-preview)." +- Make the repository a template. For more information, see "[Creating a template repository](/articles/creating-a-template-repository)." +- Receive [{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in a repository.{% if currentVersion == "free-pro-team@latest" %} +- Dismiss {% data variables.product.prodname_dependabot_alerts %} in your repository. For more information, see "[Viewing and updating vulnerable dependencies in your repository](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)." +- [Manage data usage for your private repository](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository){% endif %} +- [Define code owners for the repository](/articles/about-code-owners) +- [Archive repositories](/articles/about-archiving-repositories){% if currentVersion == "free-pro-team@latest" %} +- Create security advisories. For more information, see "[About {% data variables.product.prodname_security_advisories %}](/github/managing-security-vulnerabilities/about-github-security-advisories)." +- Display a sponsor button. For more information, see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)."{% endif %} -ユーザアカウントが所有するリポジトリの**オーナーは 1 人**だけです。この権限を他のユーザアカウントと共有することはできません。 リポジトリの所有権を他のユーザに委譲するには、「[リポジトリを委譲する方法](/articles/how-to-transfer-a-repository)」を参照してください。 +There is only **one owner** of a repository owned by a user account; this permission cannot be shared with another user account. To transfer ownership of a repository to another user, see "[How to transfer a repository](/articles/how-to-transfer-a-repository)." -#### ユーザーアカウントが所有しているリポジトリに対するコラボレーターアクセス権 +#### Collaborator access on a repository owned by a user account {% note %} -**メモ:** プライベートリポジトリでは、リポジトリオーナーはコラボレーターに書き込みアクセスしか付与できません。 コラボレーターが、ユーザアカウントによって所有されているリポジトリに対して「読み取りのみ」アクセス権を持つことはできません。 +**Note:** In a private repository, repository owners can only grant write access to collaborators. Collaborators can't have read-only access to repositories owned by a user account. {% endnote %} -個人リポジトリでのコラボレーターは、次の操作が可能です: +Collaborators on a personal repository can: -- リポジトリに対してプッシュする (書き込む)、プル (読み取る)、フォーク (コピーする) -- ラベルとマイルストーンを作成、適用、削除する -- Issue をオープン、再オープン、割り当てする -- コミット、プルリクエスト、Issue に対するコメントを編集および削除する -- Issue またはプルリクエストを重複としてマークする。 詳細は「[重複した Issue やプルリクエストについて](/articles/about-duplicate-issues-and-pull-requests)」を参照してください。 +- Push to (write), pull from (read), and fork (copy) the repository +- Create, apply, and delete labels and milestones +- Open, close, re-open, and assign issues +- Edit and delete comments on commits, pull requests, and issues +- Mark an issue or pull request as a duplicate. For more information, see "[About duplicate issues and pull requests](/articles/about-duplicate-issues-and-pull-requests)." - Open, merge and close pull requests -- 提案された変更をプルリクエストに適用する。 詳細は「[プルリクエストでのフィードバックを取り込む](/articles/incorporating-feedback-in-your-pull-request)」を参照してください。 -- リポジトリのフォークからプルリクエストを送信する{% if currentVersion == "free-pro-team@latest" %} -- パッケージを公開、表示、インストールする。 詳細は、「[パッケージの公開と管理](/github/managing-packages-with-github-packages/publishing-and-managing-packages)」を参照してください。{% endif %} -- ウィキを作成および編集する -- リリースの作成と編集。 詳細は「[リポジトリのリリースを管理する](/github/administering-a-repository/managing-releases-in-a-repository)」を参照してください。 -- リポジトリでコラボレーターである自身を削除する -- マージ可能性に影響するプルリクエストレビューをサブミットする -- リポジトリに指定されたコードオーナーとして行動する。 詳細は「[コードオーナーについて](/articles/about-code-owners)」を参照してください。 -- 会話をロックする。 詳細は「[会話をロックする](/articles/locking-conversations)」を参照してください。{% if currentVersion == "free-pro-team@latest" %} -- 乱用コンテンツを {% data variables.contact.contact_support %} にレポートする 詳細は「[乱用やスパムをレポートする](/articles/reporting-abuse-or-spam)」を参照してください。{% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -- 他のリポジトリへ Issue を移譲する。 詳細は「[他のリポジトリへ Issue を移譲する](/articles/transferring-an-issue-to-another-repository)」を参照してください。{% endif %} +- Apply suggested changes to pull requests. For more information, see "[Incorporating feedback in your pull request](/articles/incorporating-feedback-in-your-pull-request)." +- Send pull requests from forks of the repository{% if currentVersion == "free-pro-team@latest" %} +- Publish, view, and install packages. For more information, see "[Publishing and managing packages](/github/managing-packages-with-github-packages/publishing-and-managing-packages)."{% endif %} +- Create and edit Wikis +- Create and edit releases. For more information, see "[Managing releases in a repository](/github/administering-a-repository/managing-releases-in-a-repository). +- Remove themselves as collaborators on the repository +- Submit a review on a pull request that will affect its mergeability +- Act as a designated code owner for the repository. For more information, see "[About code owners](/articles/about-code-owners)." +- Lock a conversation. For more information, see "[Locking conversations](/articles/locking-conversations)."{% if currentVersion == "free-pro-team@latest" %} +- Report abusive content to {% data variables.contact.contact_support %}. For more information, see "[Reporting abuse or spam](/articles/reporting-abuse-or-spam)."{% endif %} +- Transfer an issue to a different repository. For more information, see "[Transferring an issue to another repository](/articles/transferring-an-issue-to-another-repository)." -### 参考リンク +### Further reading -- [個人リポジトリへのコラボレータの招待](/articles/inviting-collaborators-to-a-personal-repository) -- [Organization のリポジトリ権限レベル](/articles/repository-permission-levels-for-an-organization) +- "[Inviting collaborators to a personal repository](/articles/inviting-collaborators-to-a-personal-repository)" +- "[Repository permission levels for an organization](/articles/repository-permission-levels-for-an-organization)" diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-user-owned-project-boards.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-user-owned-project-boards.md index 4c9936baaccf..e27c3a3a837c 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-user-owned-project-boards.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-user-owned-project-boards.md @@ -1,6 +1,6 @@ --- title: ユーザー所有のプロジェクトボードの権限レベル -intro: ユーザーアカウントが所有するプロジェクトボードには、プロジェクトボードオーナーとコラボレーターの 2 つの権限レベルがあります。 +intro: 'ユーザーアカウントが所有するプロジェクトボードには、プロジェクトボードオーナーとコラボレーターの 2 つの権限レベルがあります。' redirect_from: - /articles/permission-levels-for-user-owned-project-boards versions: diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/publicizing-or-hiding-organization-membership.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/publicizing-or-hiding-organization-membership.md index bec18c950f43..dfa596ae1cb0 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/publicizing-or-hiding-organization-membership.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/publicizing-or-hiding-organization-membership.md @@ -1,6 +1,6 @@ --- title: Organization のメンバーシップを公開または非公開にする -intro: 自分がどの Organization に属しているかを知らせたい場合は、Organization のアバターをプロフィールに表示することができます。 +intro: '自分がどの Organization に属しているかを知らせたい場合は、Organization のアバターをプロフィールに表示することができます。' redirect_from: - /articles/publicizing-or-concealing-organization-membership/ - /articles/publicizing-or-hiding-organization-membership diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/removing-a-collaborator-from-a-personal-repository.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/removing-a-collaborator-from-a-personal-repository.md index c9f553f3df95..ac46ecbff8ac 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/removing-a-collaborator-from-a-personal-repository.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/removing-a-collaborator-from-a-personal-repository.md @@ -1,6 +1,6 @@ --- title: 個人リポジトリからコラボレーターを削除する -intro: コラボレータをプロジェクトから削除すると、そのコラボレータはリポジトリに対する読み取り/書き込みアクセスを失います。 リポジトリがプライベートであり、その個人がフォークを作成している場合、そのフォークも削除されます。 +intro: 'コラボレータをプロジェクトから削除すると、そのコラボレータはリポジトリに対する読み取り/書き込みアクセスを失います。 リポジトリがプライベートであり、その個人がフォークを作成している場合、そのフォークも削除されます。' redirect_from: - /articles/how-do-i-remove-a-collaborator/ - /articles/what-happens-when-i-remove-a-collaborator-from-my-private-repository/ diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-a-collaborators-repository.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-a-collaborators-repository.md index 23be56789c09..4e82c2c395fe 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-a-collaborators-repository.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-a-collaborators-repository.md @@ -1,6 +1,6 @@ --- title: コラボレーターのリポジトリから自分を削除する -intro: 他の人の個人リポジトリのコラボレーターを続けたくなくなった場合は、自分を削除できます。 +intro: '他の人の個人リポジトリのコラボレーターを続けたくなくなった場合は、自分を削除できます。' redirect_from: - /leave-a-collaborative-repo/ - /leave-a-repo/ diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-an-organization.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-an-organization.md index f0d54213b510..a854a799de0f 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-an-organization.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-an-organization.md @@ -1,6 +1,6 @@ --- title: Organization から自分を削除する -intro: あなたは、ある Organization の外部コラボレーターまたはメンバーになっている場合、その Organization からいつでも離脱できます。 +intro: 'あなたは、ある Organization の外部コラボレーターまたはメンバーになっている場合、その Organization からいつでも離脱できます。' redirect_from: - /articles/how-do-i-remove-myself-from-an-organization/ - /articles/removing-yourself-from-an-organization diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address.md index 52754bcabb58..f4481318bfa3 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address.md @@ -21,7 +21,7 @@ versions: Web ベースの Git 操作については、{% data variables.product.product_name %} でのコミットメールアドレスを設定できます。 コマンドラインからプッシュするコミットについては、Git のコミットメールアドレスを設定できます。 -{% if currentVersion == "free-pro-team@latest" %}コミットメールアドレスの変更前に行ったコミットは、変更前のメールアドレスに関連づけられたままとなります。{% else %}{% data variables.product.product_name %} 上のコミットメールアドレスを変更した後、新規メールアドレスは、今後のウェブベースの Git オペレーションのすべてで表示されます。 コミットメールアドレスを変更する前のコミットは、変更前のメールアドレスに関連付けられたままとなります。{% endif %} +{% if currentVersion == "free-pro-team@latest" %}Any commits you made prior to changing your commit email address are still associated with your previous email address.{% else %}After changing your commit email address on {% data variables.product.product_name %}, the new email address will be visible in all of your future web-based Git operations by default. コミットメールアドレスを変更する前のコミットは、変更前のメールアドレスに関連付けられたままとなります。{% endif %} {% if currentVersion == "free-pro-team@latest" %} @@ -33,11 +33,11 @@ Web ベースの Git 操作については、{% data variables.product.product_n {% endif %} -{% if currentVersion == "free-pro-team@latest" %} メールアドレスをプライベートにしておきたいなら、{% data variables.product.product_name %}が提供する `no-reply` メールアドレスをコミットメールアドレスとして使うことができます。 コマンドラインからプッシュするコミットに対して`noreply`メールアドレスを使いたい場合には、そのメールアドレスを Git のコミットメールアドレスの設定で使用してください。 Web ベースの Git 操作に `noreply` アドレスを使いたい場合には、GitHub でコミットメールアドレスの設定を行い、[**Keep my email address private**] を選択してください。 +{% if currentVersion == "free-pro-team@latest" %}If you'd like to keep your personal email address private, you can use a {% data variables.product.product_name %}-provided `no-reply` email address as your commit email address. コマンドラインからプッシュするコミットに対して`noreply`メールアドレスを使いたい場合には、そのメールアドレスを Git のコミットメールアドレスの設定で使用してください。 Web ベースの Git 操作に `noreply` アドレスを使いたい場合には、GitHub でコミットメールアドレスの設定を行い、[**Keep my email address private**] を選択してください。 また、個人のメールアドレスを公開するコマンドラインからプッシュされたコミットをブロックするよう選択することもできます。 詳細は「[個人のメールを公開するコマンドラインプッシュのブロック](/articles/blocking-command-line-pushes-that-expose-your-personal-email-address)」を参照してください。{% endif %} -コミットが自分に関連付けられ、コントリビューショングラフに表示されるようにするには、[自分の GitHub アカウントに追加した](/articles/adding-an-email-address-to-your-github-account/)メールアドレス{% if currentVersion == "free-pro-team@latest" %}か、メール設定で {% data variables.product.product_name %}から提供された `noreply` メールアドレス{% endif %}を使ってください。 +To ensure that commits are attributed to you and appear in your contributions graph, use an email address that you've [added to your GitHub account](/articles/adding-an-email-address-to-your-github-account/){% if currentVersion == "free-pro-team@latest" %}, or the {% data variables.product.product_name %}-provided `noreply` email address provided to you in your email settings{% endif %}. {% if currentVersion == "free-pro-team@latest" %} diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/what-does-the-available-for-hire-checkbox-do.md b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/what-does-the-available-for-hire-checkbox-do.md index b9e47ad88efa..b18d302e3c3f 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/what-does-the-available-for-hire-checkbox-do.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-github-user-account/what-does-the-available-for-hire-checkbox-do.md @@ -1,5 +1,5 @@ --- -title: 「Available for hire」チェックボックスは何をするのか？ +title: '「Available for hire」チェックボックスは何をするのか？' intro: '[**Available for hire**] を使って、GitHub の GitHub Jobs ポストを表示します。' redirect_from: - /articles/what-does-the-available-for-hire-checkbox-do diff --git a/translations/ja-JP/content/github/site-policy/github-additional-product-terms.md b/translations/ja-JP/content/github/site-policy/github-additional-product-terms.md index 772b76a427fc..e11be3d7377f 100644 --- a/translations/ja-JP/content/github/site-policy/github-additional-product-terms.md +++ b/translations/ja-JP/content/github/site-policy/github-additional-product-terms.md @@ -42,11 +42,11 @@ GitHub Pagesは、特定の帯域幅および使用法の制限を受けるた ### 5. アクションとパッケージ #### a. アクションの使用量 -GitHubアクションでは、カスタムソフトウェア開発のライフサイクルにわたるワークフローをGitHubリポジトリに直接作成することができます。 各アカウントには、アクションで使用できる付属の計算処理およびストレージ容量が、アカウントプランに応じて付属しています。これについては、[Gアクションのドキュメント](/github/automating-your-workflow-with-github-actions/about-github-actions#about-github-actions)を参照してください。 アクションの計算使用量は[アカウント設定](https://github.com/settings/billing)に表示され、付属の量の制限に達すると前ってメールで通知されます。 付属の量を超えてアクションを使用したい場合は、[超過使用を有効にする](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions)こともできます。 +GitHubアクションでは、カスタムソフトウェア開発のライフサイクルにわたるワークフローをGitHubリポジトリに直接作成することができます。 Each Account comes with included compute and storage quantities for use with Actions, depending on your Account plan, which can be found in the [Actions documentation](/actions). アクションの計算使用量は[アカウント設定](https://github.com/settings/billing)に表示され、付属の量の制限に達すると前ってメールで通知されます。 付属の量を超えてアクションを使用したい場合は、[超過使用を有効にする](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions)こともできます。 -付属の量と有料の量の計算使用量は、実行するアクションの種類 (Linux、Windows、macOSなど)に基づいて分単位で計算されます。 各アクションのジョブまたはタスクに使用された時間を、分単位で切り上げます。 付属の量の場合は、アクションの種類に応じ、各ジョブまたはタスクの実行に使われた時間に倍数をかけてから、最も近い分単位に切り上げます。 超過使用時間は、実行するアクションの種類に基づいて[申告された分単位の価格](https://github.com/features/actions)で請求されます。 アクションとパッケージはストレージを共有し、ストレージの使用量は、[アカウント設定](https://github.com/settings/billing)に表示されます。 付属の量の使用量計算に関する詳細は、[アクションのドキュメント](/github/automating-your-workflow-with-github-actions/about-github-actions#about-github-actions)を参照してください。 +付属の量と有料の量の計算使用量は、実行するアクションの種類 (Linux、Windows、macOSなど)に基づいて分単位で計算されます。 各アクションのジョブまたはタスクに使用された時間を、分単位で切り上げます。 付属の量の場合は、アクションの種類に応じ、各ジョブまたはタスクの実行に使われた時間に倍数をかけてから、最も近い分単位に切り上げます。 超過使用時間は、実行するアクションの種類に基づいて[申告された分単位の価格](https://github.com/features/actions)で請求されます。 アクションとパッケージはストレージを共有し、ストレージの使用量は、[アカウント設定](https://github.com/settings/billing)に表示されます。 For additional details about included quantity usage calculations, see the [Actions documentation](/actions). -アクションとアクションサービスの要素は、本契約、[利用規定](/github/site-policy/github-acceptable-use-policies)、またはGitHubアクション[サービス制限](/github/automating-your-workflow-with-github-actions/about-github-actions#usage-limits)に違反して使用される場合があります。 また、アクションは次の用途には使用しないでください。 +アクションとアクションサービスの要素は、本契約、[利用規定](/github/site-policy/github-acceptable-use-policies)、またはGitHubアクション[サービス制限](/actions/reference/usage-limits-billing-and-administration/#usage-limits)に違反して使用される場合があります。 また、アクションは次の用途には使用しないでください。 - クリプトマイニング; - 当社サーバーを使用して、何らかのサービス、デバイス、データ、アカウントまたはネットワークを妨害すること、またはこれらに不正アクセスするかあるいはこれを試みること ([GitHub Bug Bounty program](https://bounty.github.com) により許可されている場合を除く)、 - the provision of a stand-alone or integrated application or service offering Actions or any elements of Actions for commercial purposes; diff --git a/translations/ja-JP/content/github/site-policy/github-enterprise-service-level-agreement.md b/translations/ja-JP/content/github/site-policy/github-enterprise-service-level-agreement.md index b7ca2eb285dd..c44a2d65179f 100644 --- a/translations/ja-JP/content/github/site-policy/github-enterprise-service-level-agreement.md +++ b/translations/ja-JP/content/github/site-policy/github-enterprise-service-level-agreement.md @@ -8,8 +8,6 @@ versions: free-pro-team: '*' --- -# GitHub Enterprise Service Level Agreement - **Short version:** GitHub guarantees a 99.9% quarterly uptime commitment for the GitHub Enterprise Cloud service (the “**Service Level**” or “**SLA**”). If GitHub does not meet the SLA, then Customer will be entitled to a service credit to Customer’s account (“**Service Credits**”). For definitions of each Service feature (“**Service Feature**”) and to review historical and current Uptime, visit the [GitHub Status Page](https://www.githubstatus.com/). Capitalized terms used but not defined in this SLA have the meaning assigned in Customer’s applicable agreement. @@ -20,7 +18,7 @@ For definitions of each Service feature (“**Service Feature**”) and to revi | **Service Feature** | **Uptime Calculation** | **定義** | **Service Credits Calculation** | | --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | -| The **Service** includes the following Service Features:
    • 問題
    • プルリクエスト
    • Git Operations
    • API Requests
    • webhook
    • ページ
    • アクション
    • Packages
    | (total minutes in a calendar quarter - Downtime) / total minutes in a calendar quarter | “**Downtime**” is a period of time where either (a) the error rate exceeds five percent (5%) in a given minute for any Service Feature or (b) the Service was unavailable as determined by a combination of GitHub's internal and external monitoring systems. | A Service Credits claim may be based on either (not both) of the following calculations:
    • 10% of the amount Customer paid for a Service Feature in a calendar quarter where the Uptime for that Service Feature was less than 99.9%, but greater than 99.0%.

      OR

    • 25% of the amount Customer paid for a Service Feature in a calendar quarter where the Uptime of that Service Feature was less than 99.0%.
    | | +| The **Service** includes the following Service Features:
    • 問題
    • プルリクエスト
    • Git Operations
    • API Requests
    • webhook
    • ページ
    • アクション
    • Packages
    | (total minutes in a calendar quarter - Downtime) / total minutes in a calendar quarter | “**Downtime**” is a period of time where either (a) the error rate exceeds five percent (5%) in a given minute for any Service Feature or (b) the Service was unavailable as determined by a combination of GitHub's internal and external monitoring systems. | A Service Credits claim may be based on either (not both) of the following calculations:
    • 10% of the amount Customer paid for a Service Feature in a calendar quarter where the Uptime for that Service Feature was less than or equal to 99.9%, but greater than 99.0%.

      OR

    • 25% of the amount Customer paid for a Service Feature in a calendar quarter where the Uptime of that Service Feature was less than 99.0%.
    | | | **アクション** | (Total Triggered Executions – Unavailable Executions) / (Total Triggered Executions) x 100 | “**Total Triggered Executions**” is the total number of all Actions executions triggered by Customer in a calendar quarter.

    “**Unavailable Executions**” is the total number of executions within Total Triggered Executions which failed to run in a calendar quarter. An execution failed to run when the Actions history log did not capture any output five (5) minutes after the trigger was successfully fired. | Same as above | | **Packages** | Transfers Uptime = same as Actions

    Storage Uptime = 100% - Average Error Rate*

    *The Uptime Calculation excludes public usage and storage transactions that do not count toward either Total Storage Transactions or Failed Storage Transactions (including pre-authentication failures; authentication failures; attempted transactions for storage accounts over their prescribed quotas). | “**Error Rate**” is the total number of Failed Storage Transactions divided by the Total Storage Transactions during a set time interval (currently set at one hour). If the Total Storage Transactions in a given one-hour interval is zero, the error rate for that interval is 0%.

    “**Average Error Rate**” is the sum of Error Rates for each hour in a calendar quarter divided by the total number of hours in a calendar quarter. | Same as above | diff --git a/translations/ja-JP/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md b/translations/ja-JP/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md index 451558b5524d..c079aa0894c1 100644 --- a/translations/ja-JP/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md +++ b/translations/ja-JP/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md @@ -29,7 +29,7 @@ You have full control over which metrics, reports, repositories, and contributor - **Decide which repositories to include**: Before you start an analysis in {% data variables.product.prodname_insights %}, consider which repositories to include. Administrators can include repositories when adding organizations and can enable and disable repositories at any time. For more information on adding organizations to {% data variables.product.prodname_insights %}, see "[Managing organizations](/insights/installing-and-configuring-github-insights/managing-organizations)." For more information on enabling and disabling repositories, see "[Managing repositories](/insights/installing-and-configuring-github-insights/managing-repositories)." -- **Decide which metrics and reports to include**: Administrators can enable and disable metrics and reports available for all users at any time. Administrators control the {% data variables.product.prodname_insights %} data that users have access to in your installation of {% data variables.product.prodname_ghe_server %}. 詳しい情報については「[利用できるメトリクスとレポートの管理](/insights/installing-and-configuring-github-insights/managing-available-metrics-and-reports)」を参照してください。 +- **Decide which metrics and reports to include**: Administrators can enable and disable metrics and reports available for all users at any time. Administrators control the {% data variables.product.prodname_insights %} data that users have access to in your installation of {% data variables.product.prodname_ghe_server %}. For more information, see "[Managing available metrics and reports](/insights/installing-and-configuring-github-insights/managing-available-metrics-and-reports)." - **Decide which contributors to include**: Administrators can disable a specific contributor’s data from being processed in the metrics and reports. For more information on managing contributor data, see "[Managing contributors and teams](/insights/installing-and-configuring-github-insights/managing-contributors-and-teams)." @@ -37,7 +37,7 @@ You have full control over which metrics, reports, repositories, and contributor Under various data protection regulations, such as the General Data Protection Regulation (GDPR), users may have the right to request exclusion from processing, access, and correction, or to request deletion of their personal data. As the data controller, your organization should evaluate whether a particular user request is valid and, if appropriate, take action to fulfill the request. -- **Exclusion of processing**: Users may have the right to have their personal data excluded from being processed. Administrators have the ability to remove a contributor’s data from being processed in {% data variables.product.prodname_insights %}, and the resulting reports and metrics will exclude the contributor’s data accordingly. 詳しい情報については「[コントリビューターとTeamの管理](/insights/installing-and-configuring-github-insights/managing-contributors-and-teams)」を参照してください。 +- **Exclusion of processing**: Users may have the right to have their personal data excluded from being processed. Administrators have the ability to remove a contributor’s data from being processed in {% data variables.product.prodname_insights %}, and the resulting reports and metrics will exclude the contributor’s data accordingly. For more information, see "[Managing contributors and teams](/insights/installing-and-configuring-github-insights/managing-contributors-and-teams)." - **Access**: Users may have the right to demand to see what personal data is being processed. Each metric and report has a detailed description of what personal data is being processed. For more information, see "[Metrics available with {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights)." Raw data is available through the {% data variables.product.prodname_enterprise %} API. Your organization is responsible for any decisions to process personal data and for fulfilling any such requests. diff --git a/translations/ja-JP/content/github/site-policy/github-privacy-statement.md b/translations/ja-JP/content/github/site-policy/github-privacy-statement.md index 2ff6ed896c20..59944beae281 100644 --- a/translations/ja-JP/content/github/site-policy/github-privacy-statement.md +++ b/translations/ja-JP/content/github/site-policy/github-privacy-statement.md @@ -11,7 +11,7 @@ versions: free-pro-team: '*' --- -Effective date: July 22, 2020 +Effective date: October 2, 2020 お客様のソースコードやプロジェクト、個人情報について、GitHub Inc （以下、「GitHub」「当社」と称します）をご信頼いただき、ありがとうございます。 お客様の個人情報を保持することは重大な責務であり、当社がどのように取り扱っているのかを知っていただければと思います。 @@ -219,15 +219,15 @@ GitHubは、一般的に、ユーザ個人情報をアカウントがアクテ #### クッキー -GitHubは、当社のサービスとのインターアクションを容易かつ有意義なものとするためにクッキーを利用します。 Cookie は、ウェブサイトが訪問者のコンピュータまたはモバイルデバイスに度々格納する小さなテキストファイルです。 当社は、お客様のログインの保持、お客様の設定の記憶およびGitHubの今後の開発のための情報提供を目的として、クッキー（およびHTML5 localStorageのような類似技術）を利用します。 セキュリティ目的のため、当社では、デバイスを識別するためにクッキーを利用しています。 当社のウェブサイトを利用することで、お客様は、お客様のコンピュータまたはデバイスにこれらの種類のクッキーを当社が保管することに同意したものとされます。 お客様がこれらのクッキーを許可するブラウザまたはデバイスの能力を無効にした場合、GitHubのサービスにログインまたは利用することはできなくなります。 +GitHub uses cookies and similar technologies (collectively, “cookies”) to make interactions with our service easy and meaningful. Cookie は、ウェブサイトが訪問者のコンピュータまたはモバイルデバイスに度々格納する小さなテキストファイルです。 We use cookies to provide you our services, for example, to keep you logged in, remember your preferences, identify your device for security purposes, and provide information for future development of GitHub. 当社のウェブサイトを利用することで、お客様は、お客様のコンピュータまたはデバイスにこれらの種類のクッキーを当社が保管することに同意したものとされます。 お客様がこれらのクッキーを許可するブラウザまたはデバイスの能力を無効にした場合、GitHubのサービスにログインまたは利用することはできなくなります。 -当社は、当社が設定するクッキー、これらのクッキーの必要性およびそれらのクッキーの種類（テンポラリーもしくはパーマネント）について記載した、[クッキーおよびトラッキング](/github/site-policy/github-subprocessors-and-cookies)についてのウェブページを提供します。 当社はサードパーティアナリティクスプロバイダおよびその他のサービスプロバイダの一覧を掲載し、かつ、当社のウェブサイトのどの部分についてトラッキングを許可しているのか詳細を掲載します。 +We provide more information about [cookies on GitHub](/github/site-policy/github-subprocessors-and-cookies#cookies-on-github) on our [GitHub Subprocessors and Cookies](/github/site-policy/github-subprocessors-and-cookies) page that describes the cookies we set, the needs we have for those cookies, and the expiration of such cookies. It also lists our third-party analytics providers and how you can control your cookie preference settings for such cookies. #### トラッキングおよびアナリティクス 当社は、当社のユーザによるGitHubの利用の評価、アクティビティの統計レポートのコンパイルならびに当社のコンテンツおよびウェブサイトのパフォーマンスの向上に役立つ、一定数のサードパーティアナリティクスおよびサービスプロバイダを利用しています。 当社は、当社のウェブサイトの一定のエリアでのみこれらのサードパーティアナリティクスプロバイダを利用します。これらのプロバイダはすべて、収集できるユーザ個人情報の種類および情報を処理する目的を制限するデータ保護規約を当社と締結しています。 さらに、当社は、機能を提供ならびにコンテンツおよびパフォーマンスを向上するために内部でアナリティクスソフトウェアを利用します。 -一定のブラウザは、「追跡拒否（DNT)」機能が組み込まれており、訪問するウェブサイトに対してトラッキングを望まないシグナルを発信できます。 GitHubは、ブラウザのDNTシグナルに応答し、[DNTシグナルへの応答についてのW3C基準](https://www.w3.org/TR/tracking-dnt/)に従います。 DNTをサポートするブラウザでDNTを有効にしていない場合、当社のウェブサイトの一定箇所は、お客様の他のサービスにおけるオンラインブラウジングアクティビティを繰り返しトラッキングします。ただし、当社は、当社のアナリティクスおよびサービスプロバイダ以外の第三者に対して、GitHub上のユーザのアクティビティを繰り返しトラッキングすることを許可しません。 +一定のブラウザは、「追跡拒否（DNT)」機能が組み込まれており、訪問するウェブサイトに対してトラッキングを望まないシグナルを発信できます。 GitHubは、ブラウザのDNTシグナルに応答し、[DNTシグナルへの応答についてのW3C基準](https://www.w3.org/TR/tracking-dnt/)に従います。 DNTをサポートするブラウザでDNTを有効にしていない場合、当社のウェブサイトの一定箇所は、お客様の他のサービスにおけるオンラインブラウジングアクティビティを繰り返しトラッキングします。ただし、当社は、当社のアナリティクスおよびサービスプロバイダ以外の第三者に対して、GitHub上のユーザのアクティビティを繰り返しトラッキングすることを許可しません。 You can read more about DNT in our [Tracking on GitHub](/github/site-policy/github-subprocessors-and-cookies#tracking-on-github) section of our [GitHub Subprocessors and Cookies](/github/site-policy/github-subprocessors-and-cookies) page. ### お客様情報についての当社の保護方法 diff --git a/translations/ja-JP/content/github/site-policy/github-subprocessors-and-cookies.md b/translations/ja-JP/content/github/site-policy/github-subprocessors-and-cookies.md index 70b8da8fb51b..0f3f6c0d4882 100644 --- a/translations/ja-JP/content/github/site-policy/github-subprocessors-and-cookies.md +++ b/translations/ja-JP/content/github/site-policy/github-subprocessors-and-cookies.md @@ -10,7 +10,7 @@ versions: free-pro-team: '*' --- -発効日：**2020年12月8日** +Effective date: **October 2, 2020** GitHubは、お客様のデータを当社が利用する方法、お客様のデータを当社が収集する方法、およびお客様のデータを共有する対象について、高い透明性を提供します。 この目的のため、当社は[当社のサブプロセッサ](#github-subprocessors)、[クッキー](#cookies-on-github)の使用方法、および[GitHubにおけるトラッキング](#tracking-on-github)を実施する場所とその方法について説明するページをご用意しました。 @@ -19,7 +19,7 @@ GitHubは、お客様のデータを当社が利用する方法、お客様の 当社がお客様の情報を、ベンダーやサービスプロバイダなどのサードパーティーのサブプロセッサと共有する場合、それについては当社が責任を負います。 新たなベンダーとのやり取りを行う際に、当社はお客様の信頼を維持するため努力し、全てのベンダーに対して、 ユーザの個人情報 ([プライバシーについての声明](/articles/github-privacy-statement/)の定義による) に関する取り扱いを制限する、データ保護契約を締結するよう要求しています。 | サブプロセッサ名 | 処理の内容 | 処理の場所 | Corporate Location | -| ------------------ | ------------------------------- | ----- | ------------------ | +|:------------------ |:------------------------------- |:----- |:------------------ | | Automattic | ブログサービス | 米国 | 米国 | | AWS Amazon | データのホスティング | 米国 | 米国 | | Braintree (PayPal) | プランのクレジットカード決済処理業者 | 米国 | 米国 | @@ -28,7 +28,7 @@ GitHubは、お客様のデータを当社が利用する方法、お客様の | DiscoverOrg | マーケティングデータのエンリッチメントサービス | 米国 | 米国 | | Eloqua | マーケティングキャンペーンの自動化 | 米国 | 米国 | | Google Apps | 社内インフラストラクチャ | 米国 | 米国 | -| Google Analytics | ウェブサイトの分析およびパフォーマンス | 米国 | 米国 | +| Google Analytics | Analytics and performance | 米国 | 米国 | | LinkedIn Navigator | マーケティングデータのエンリッチメントサービス | 米国 | 米国 | | Magic Robot | キャンペーンレポート (Salesforceのアドオン) | 米国 | 米国 | | MailChimp | 顧客チケットメールサービスプロバイダ | 米国 | 米国 | @@ -49,63 +49,49 @@ GitHubは、お客様のデータを当社が利用する方法、お客様の ### GitHub上のクッキー -GitHubは、当社のサービスとのインターアクションを容易かつ有意義なものとするためにクッキーを利用します。 当社は、お客様のログインの保持、お客様の設定の記憶、GitHubの今後の開発のための情報提供、ならびにGitHubの製品およびサービスをサードパーティー上のサイトでお客様に宣伝することを目的として、クッキー (およびHTML5 localStorageのような類似技術) を利用します。 - -クッキーとは、当社のウェブサーバーがお客様のコンピュータまたはモバイルデバイスに保存する小さなテキストで、お客様が当社のサイトに再訪したときにブラウザから送信されます。 単にGitHubにアクセスしただけで、クッキーがお客様を特定できるとは限りません。ただしクッキーは、ログインしている各ユーザーに対して一意の識別子を保存する場合があります。 当社は、お客様のログインの保持、お客様の設定の記憶およびGitHubの今後の開発のための情報提供を目的として、クッキーを使用します。 セキュリティ上の理由から、当社では、デバイスを識別するためにクッキーを利用しています。 当社のウェブサイトを利用することで、お客様は、お客様のコンピュータまたはデバイスにこれらの種類のクッキーを当社が保管することに同意したものとされます。 お客様がこれらのクッキーを許可するブラウザまたはデバイスの能力を無効にした場合、GitHubのサービスにログインまたは利用することはできなくなります。 当社ウェブサイトの一部の領域においては、お客様やお客様のデバイスを特定し、第三者のサイトでGitHubの製品およびサービスを宣伝するためクッキーを使用することがあります。 - -GitHubは、以下の理由により、以下のクッキーを当社のユーザーに設定します。 - -| クッキーの名前 | 理由 | -| ------------------------------------ | ----------------------------------------------------------------------------------- | -| `user_session` | このクッキーはログインに使用されます。 | -| `logged_in` | このクッキーは、ユーザがすでにログインしていることを当社に通知するために使用されます。 | -| `dotcom_user` | このクッキーは、ユーザがすでにログインしていることを当社に通知するために使用されます。 | -| `_gh_sess` | このクッキーは、ユーザが複数のステップのうちどのステップにあるのかなど、一時アプリケーションおよびフレームワークにおけるページ間での状態を記録するために使用されます。 | -| `tz` | このクッキーにより、ブラウザがどのお客様がどのタイムゾーンにいるか、ブラウザから当社に通知されます。 | -| `gist_user_session` | このクッキーは、別のホストで実行されている場合にGistによって使用されます。 | -| `saml_csrf_token` | このクッキーは、トークンをクライアントに関連付けるために、SAML認証パスメソッドによって設定されます。 | -| `saml_return_to` | このクッキーは、SAML認証ループ時に、状態を維持するためSAML認証パスメソッドによって設定されます。 | -| `gist_oauth_csrf` | このクッキーは、OAuthフローを開始したユーザが、それを完了したユーザと同一であることを保証するために、Gistによって設定されます。 | -| `__Host-user_session_same_site` | このクッキーは、SameSiteクッキーをサポートするブラウザが、リクエストがGitHubから発信されているかどうかを確認できるように設定されます。 | -| `__Host-gist_user_session_same_site` | このクッキーは、SameSiteクッキーをサポートするブラウザが、リクエストがGitHubから発信されているかどうかを確認できるように設定されます。 | -| `_ga` | このクッキーは、Googleアナリティクスにより使用されます。 | -| `_gat` | このクッキーは、Googleアナリティクスにより使用されます。 | -| `_gid` | このクッキーは、Googleアナリティクスにより使用されます。 | -| `_octo` | このクッキーは、当社の内部分析サービスであるOctolyticsが、一意のユーザーとクライアントを区別するために使用されます。 | -| `tracker` | このクッキーは、サインアップ分析の参照元を追跡します。 | - -当社サイトの一部のページでは、第三者のクッキーを設定する場合があります。 たとえば、クッキーを設定するサイトから、動画などのコンテンツを埋め込むことがあります。 第三者のクッキーは最小限に保つよう努めていますが、当社は第三者のコンテンツが設定するクッキーを常に管理できるわけではありません。 +GitHub uses cookies and similar technologies (collectively, “cookies”) to provide and secure our websites, as well as to analyze the usage of our websites, in order to offer you a great user experience. Please take a look at our [Privacy Statement](/github/site-policy/github-privacy-statement#our-use-of-cookies-and-tracking) if you’d like more information about cookies, and on how and why we use them. + +Since the number and names of cookies may change,the table below may be updated from time to time. + +| Service Provider | Cookie Name | 説明 | Expiration* | +|:------------------ |:------------------------------------ |:------------------------------------------------------------------------------------------------------------------------------------------ |:------------------------------------------------------------- | +| GitHub | `app_manifest_token` | This cookie is used during the App Manifest flow to maintain the state of the flow during the redirect to fetch a user session. | five minutes | +| GitHub | `cookie-preferences` | This cookie is used to track user cookie preferences. | one year | +| GitHub | `_device_id` | This cookie is used to track recognized devices. | one year | +| GitHub | `dotcom_user` | このクッキーは、ユーザがすでにログインしていることを当社に通知するために使用されます。 | one year | +| GitHub | `_gh_ent` | This cookie is used for temporary application and framework state between pages like what step the customer is on in a multiple step form. | two weeks | +| GitHub | `_gh_sess` | このクッキーは、ユーザが複数のステップのうちどのステップにあるのかなど、一時アプリケーションおよびフレームワークにおけるページ間での状態を記録するために使用されます。 | セッション | +| GitHub | `gist_oauth_csrf` | このクッキーは、OAuthフローを開始したユーザが、それを完了したユーザと同一であることを保証するために、Gistによって設定されます。 | deleted when oauth state is validated | +| GitHub | `gist_user_session` | このクッキーは、別のホストで実行されている場合にGistによって使用されます。 | two weeks | +| GitHub | `has_recent_activity` | This cookie is used to prevent showing the security interstitial to users that have visited the app recently. | one hour | +| GitHub | `__Host-gist_user_session_same_site` | このクッキーは、SameSiteクッキーをサポートするブラウザが、リクエストがGitHubから発信されているかどうかを確認できるように設定されます。 | two weeks | +| GitHub | `__Host-user_session_same_site` | このクッキーは、SameSiteクッキーをサポートするブラウザが、リクエストがGitHubから発信されているかどうかを確認できるように設定されます。 | two weeks | +| GitHub | `logged_in` | このクッキーは、ユーザがすでにログインしていることを当社に通知するために使用されます。 | one year | +| GitHub | `marketplace_repository_ids` | This cookie is used for the marketplace installation flow. | one hour | +| GitHub | `marketplace_suggested_target_id` | This cookie is used for the marketplace installation flow. | one hour | +| GitHub | `_octo` | This cookie is used by our internal analytics service to distinguish unique users and clients. | one year | +| GitHub | `org_transform_notice` | This cookie is used to provide notice during organization transforms. | one hour | +| GitHub | `private_mode_user_session` | This cookie is used for Enterprise authentication requests. | two weeks | +| GitHub | `saml_csrf_token` | このクッキーは、トークンをクライアントに関連付けるために、SAML認証パスメソッドによって設定されます。 | until user closes browser or completes authentication request | +| GitHub | `saml_csrf_token_legacy` | このクッキーは、トークンをクライアントに関連付けるために、SAML認証パスメソッドによって設定されます。 | until user closes browser or completes authentication request | +| GitHub | `saml_return_to` | このクッキーは、SAML認証ループ時に、状態を維持するためSAML認証パスメソッドによって設定されます。 | until user closes browser or completes authentication request | +| GitHub | `saml_return_to_legacy` | このクッキーは、SAML認証ループ時に、状態を維持するためSAML認証パスメソッドによって設定されます。 | until user closes browser or completes authentication request | +| GitHub | `tz` | このクッキーにより、ブラウザがどのお客様がどのタイムゾーンにいるか、ブラウザから当社に通知されます。 | セッション | +| GitHub | `user_session` | このクッキーはログインに使用されます。 | two weeks | +| Google Analytics** | `_ga` | このクッキーは、Googleアナリティクスにより使用されます。 | two years | +| Google Analytics** | `_gat` | このクッキーは、Googleアナリティクスにより使用されます。 | one minute | +| Google Analytics** | `_gid` | このクッキーは、Googleアナリティクスにより使用されます。 | one day | + +_*_ The **expiration** dates for the cookies listed below generally apply on a rolling basis. + +_**_ We use **Google Analytics** as a third party analytics service to collect information about how our website performs and how our users, in general, navigate through and use GitHub. This helps us evaluate our users' use of GitHub, compile statistical reports on activity, and improve our content and website performance. + +You can control your Google Analytics cookie preferences through our cookie preference link located at the footer of our website. In addition, Google provides further information about its own privacy practices and [offers a browser add-on to opt out of Google Analytics tracking](https://tools.google.com/dlpage/gaoptout). + +(!) Please note certain pages on our website may set other third party cookies. たとえば、クッキーを設定するサイトから、動画などのコンテンツを埋め込むことがあります。 第三者のクッキーは最小限に保つよう努めていますが、当社は第三者のコンテンツが設定するクッキーを常に管理できるわけではありません。 ### GitHub上のトラッキング -「[Do Not Track](https://www.eff.org/issues/do-not-track)」(DNT) とは、オンラインサービス (特に広告ネットワーク) に対して、第三者のトラッキングサービスからお客様のオンライン活動にする特定の種類の情報を収集して共有することを望まない場合に、ブラウザで設定できるプライバシー設定です。 GitHubは、ブラウザのDNTシグナルに応答し、[DNTシグナルへの応答についてのW3C基準](https://www.w3.org/TR/tracking-dnt/)に従います。 トラッキングを望まないことを通知するようブラウザに対して設定したい場合、この通知を有効化する方法について、ブラウザのドキュメントをご確認ください。 [Privacy Badger](https://www.eff.org/privacybadger)など、トラッキングをブロックする良いアプリケーションもあります。 - -DNTをサポートするブラウザでDNTを有効にしていない場合、当社のウェブサイ」のうち一部は、お客様の他のサービスにおけるオンラインブラウジングアクティビティを繰り返しトラッキングします。ただし、当社は、当社のアナリティクスおよびサービスプロバイダ以外の第三者に対して、GitHub上のユーザのアクティビティを繰り返しトラッキングすることを許可しません。 当社は、GitHubの製品やサービスを第三者のウェブサイトやサービス上でお客様に宣伝するために、これらのクッキーを使用します。 また当社は、当社の特定のページにおける、訪問者の動きを追跡するために用いている分析プロバイダーなどの特定のベンダーと契約を締結しています。 当社を代行して個人情報を収集しているベンダーのみが、当社のページ上のデータを収集することができます。当社は、当社を代行してこのデータを収集する各ベンダーとデータ保護契約を締結しています。 当社は、これらのベンダーから受け取ったデータを使用して、訪問者の関心をより深く理解し、当社のウェブサイトのパフォーマンスを把握し、コンテンツを改善します。 分析ベンダーは全て、上記サブプロセッサのリストに掲載されます。また、この種のデータを収集する全ページを以下に掲載しています。 - -#### Google Analytics - -当社は、第三者の分析サービスとしてGoogleアナリティクスを用いて、第三者のウェブサイト上やサービス上の当社による広告キャンペーンを追跡しています。 当社がGoogleアナリティクスを使用するのは、当社ウェブサイトのパフォーマンスや、一般的にユーザがGitHubを移動し使用する方法についての情報を収集するためです。 これは、当社のユーザによるGitHubの使用について評価し、アクティビティの統計的なレポートをまとめ、当社コンテンツおよびウェブサイトのパフォーマンスを改善するために役立ちます。 Googleは自らのプライバシープラクティスについて詳細に説明し、[Googleアナリティクスのトラッキングをオプトアウトするためのブラウザアドオンを提供しています](https://tools.google.com/dlpage/gaoptout)。 - -#### 分析が有効になっている場合があるGitHub上のページ - -当社サイトで、URLに以下のドメインおよびパス (サブドメインおよびサブパス) のいずれかを含むページでは、分析やその他のトラッキングコードが有効になっている場合があります。 GitHub上で当社がお客様の閲覧行動についての情報を収集させたくない場合は、[Privacy Badger](https://www.eff.org/privacybadger)などのトラッキングブロッカーを使用するか、Googleアナリティクスのトラッキングをオプトアウトします。 - -- github.com/home (ログアウトしている場合、またはアカウントを持っていない場合は、github.comに移動したときに表示されるページです) -- github.com/about -- github.blog -- github.com/enterprise -- github.com/collections -- github.com/developer-stories -- github.com/events -- github.com/explore -- github.com/features -- github.com/logos -- github.com/nonprofit -- github.com/open-source -- github.com/personal -- github.com/pricing -- github.com/ten -- github.com/trending -- resources.github.com -- de.github.com -- fr.github.com +"[Do Not Track](https://www.eff.org/issues/do-not-track)" (DNT) is a privacy preference you can set in your browser if you do not want online services to collect and share certain kinds of information about your online activity from third party tracking services. GitHubは、ブラウザのDNTシグナルに応答し、[DNTシグナルへの応答についてのW3C基準](https://www.w3.org/TR/tracking-dnt/)に従います。 トラッキングを望まないことを通知するようブラウザに対して設定したい場合、この通知を有効化する方法について、ブラウザのドキュメントをご確認ください。 [Privacy Badger](https://www.eff.org/privacybadger)など、トラッキングをブロックする良いアプリケーションもあります。 + +DNTをサポートするブラウザでDNTを有効にしていない場合、当社のウェブサイ」のうち一部は、お客様の他のサービスにおけるオンラインブラウジングアクティビティを繰り返しトラッキングします。ただし、当社は、当社のアナリティクスおよびサービスプロバイダ以外の第三者に対して、GitHub上のユーザのアクティビティを繰り返しトラッキングすることを許可しません。 We have agreements with certain vendors, such as analytics providers, who help us track visitors' movements on certain pages on our website. 当社を代行して個人情報を収集しているベンダーのみが、当社のページ上のデータを収集することができます。当社は、当社を代行してこのデータを収集する各ベンダーとデータ保護契約を締結しています。 当社は、これらのベンダーから受け取ったデータを使用して、訪問者の関心をより深く理解し、当社のウェブサイトのパフォーマンスを把握し、コンテンツを改善します。 Any analytics vendor will be listed in our [subprocessor list](#github-subprocessors), and you may see a list of every page where we collect this kind of data below. diff --git a/translations/ja-JP/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors-for-open-source-contributors.md b/translations/ja-JP/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors-for-open-source-contributors.md index f982bee7a527..da7358ccbcf9 100644 --- a/translations/ja-JP/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors-for-open-source-contributors.md +++ b/translations/ja-JP/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors-for-open-source-contributors.md @@ -1,6 +1,6 @@ --- title: オープンソースコントリビューターに対する GitHub スポンサーについて -intro: オープンソースプロジェクトに貢献すれば、スポンサードコントリビューターとなって、作業に対する報酬を得られます。 +intro: 'オープンソースプロジェクトに貢献すれば、スポンサードコントリビューターとなって、作業に対する報酬を得られます。' redirect_from: - /articles/about-github-sponsors-for-sponsored-developers - /github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors-for-sponsored-developers diff --git a/translations/ja-JP/content/github/supporting-the-open-source-community-with-github-sponsors/changing-your-sponsorship-tiers.md b/translations/ja-JP/content/github/supporting-the-open-source-community-with-github-sponsors/changing-your-sponsorship-tiers.md index 260fe861d64f..1aafab938770 100644 --- a/translations/ja-JP/content/github/supporting-the-open-source-community-with-github-sponsors/changing-your-sponsorship-tiers.md +++ b/translations/ja-JP/content/github/supporting-the-open-source-community-with-github-sponsors/changing-your-sponsorship-tiers.md @@ -1,6 +1,6 @@ --- title: スポンサーシップ層を変更する -intro: 新しいスポンサーシップ層の追加や、既存スポンサーシップ層の編集、破棄が可能です。 +intro: '新しいスポンサーシップ層の追加や、既存スポンサーシップ層の編集、破棄が可能です。' redirect_from: - /articles/changing-your-sponsorship-tiers versions: diff --git a/translations/ja-JP/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md b/translations/ja-JP/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md index ba294b3a9ad0..a1be975ee743 100644 --- a/translations/ja-JP/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md +++ b/translations/ja-JP/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md @@ -50,7 +50,7 @@ To join {% data variables.product.prodname_sponsors %} as an individual contribu ### 銀行口座情報をサブミットする -スポンサードOrganizationは、組織の専用銀行口座への支払いを、サポートされている地域で受け取る必要があります。 業務用の銀行口座は、[Open Collective](https://opencollective.com/)や[Stripe Atlas](https://stripe.com/atlas)といったサービスで設置できます。 {% data reusables.sponsors.stripe-supported-regions %} +スポンサードOrganizationは、組織の専用銀行口座への支払いを、サポートされている地域で受け取る必要があります。 業務用の銀行口座は、[Open Collective](https://opencollective.com/)や[Stripe Atlas](https://stripe.com/atlas)といったサービスで設置できます。 The region your organization legally operates in and the region of your bank account must match. The person setting up {% data variables.product.prodname_sponsors %} for the organization must live in the same supported region, too. {% data reusables.sponsors.stripe-supported-regions %} {% data reusables.sponsors.double-check-stripe-info %} diff --git a/translations/ja-JP/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md b/translations/ja-JP/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md index c767723a9be2..a0188d881435 100644 --- a/translations/ja-JP/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md +++ b/translations/ja-JP/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md @@ -50,7 +50,7 @@ To join {% data variables.product.prodname_sponsors %} as an organization, see " ### 銀行口座情報をサブミットする -サポートされている地域にお住まいの場合は、次の手順に従って Stripe Connect アカウントを作成し、銀行口座情報をサブミットできます。 {% data reusables.sponsors.stripe-supported-regions %} +サポートされている地域にお住まいの場合は、次の手順に従って Stripe Connect アカウントを作成し、銀行口座情報をサブミットできます。 Your region of residence and the region of your bank account must match. {% data reusables.sponsors.stripe-supported-regions %} {% data reusables.sponsors.double-check-stripe-info %} diff --git a/translations/ja-JP/content/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor.md b/translations/ja-JP/content/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor.md index 3439c73d06e3..fe176cf7c529 100644 --- a/translations/ja-JP/content/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor.md +++ b/translations/ja-JP/content/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor.md @@ -1,6 +1,6 @@ --- title: オープンソースコントリビューターに対するスポンサー -intro: あなたが頼りにしているオープンソースプロジェクトを設計、作成、維持する開発者または Organization に対して、毎月定期的に支払いをすることができます。 +intro: 'あなたが頼りにしているオープンソースプロジェクトを設計、作成、維持する開発者または Organization に対して、毎月定期的に支払いをすることができます。' redirect_from: - /articles/sponsoring-a-developer - /articles/sponsoring-an-open-source-contributor diff --git a/translations/ja-JP/content/github/supporting-the-open-source-community-with-github-sponsors/viewing-your-sponsors-and-sponsorships.md b/translations/ja-JP/content/github/supporting-the-open-source-community-with-github-sponsors/viewing-your-sponsors-and-sponsorships.md index 702884a7385f..23a4908009eb 100644 --- a/translations/ja-JP/content/github/supporting-the-open-source-community-with-github-sponsors/viewing-your-sponsors-and-sponsorships.md +++ b/translations/ja-JP/content/github/supporting-the-open-source-community-with-github-sponsors/viewing-your-sponsors-and-sponsorships.md @@ -13,7 +13,7 @@ versions: ### スポンサーダッシュボードを表示する -1. 任意のページの右上隅で、プロフィール画像をクリックし、続いて [**{% data variables.product.prodname_sponsors %}**] をクリックしてください。 ![{% data variables.product.prodname_sponsors %}ボタン](/assets/images/help/sponsors/access-github-sponsors-dashboard.png) +1. 任意のページの右上隅で、プロフィール画像をクリックし、続いて [**{% data variables.product.prodname_sponsors %}**] をクリックします。 ![{% data variables.product.prodname_sponsors %}ボタン](/assets/images/help/sponsors/access-github-sponsors-dashboard.png) 2. 表示されたリストで、スポンサーダッシュボードを表示したいアカウントまたは Organization の右にある [**Dashboard**] をクリックします。 ![開発者スポンサーダッシュボードボタン](/assets/images/help/sponsors/dev-sponsors-dashboard-button.png) ### スポンサーとスポンサーシップを表示する diff --git a/translations/ja-JP/content/github/using-git/about-git-subtree-merges.md b/translations/ja-JP/content/github/using-git/about-git-subtree-merges.md index 30b46fe6c7e4..af5da997a69c 100644 --- a/translations/ja-JP/content/github/using-git/about-git-subtree-merges.md +++ b/translations/ja-JP/content/github/using-git/about-git-subtree-merges.md @@ -4,7 +4,7 @@ redirect_from: - /articles/working-with-subtree-merge/ - /subtree-merge/ - /articles/about-git-subtree-merges -intro: 複数のプロジェクトを単一のリポジトリで管理する必要がある場合、*サブツリーマージ*を使ってすべての参照を扱うことができます。 +intro: '複数のプロジェクトを単一のリポジトリで管理する必要がある場合、*サブツリーマージ*を使ってすべての参照を扱うことができます。' versions: free-pro-team: '*' enterprise-server: '*' @@ -37,7 +37,7 @@ versions: $ touch .gitignore $ git add .gitignore $ git commit -m "initial commit" - > [master (root-commit) 3146c2a] initial commit + > [main (root-commit) 3146c2a] initial commit > 0 files changed, 0 insertions(+), 0 deletions(-) > create mode 100644 .gitignore ``` @@ -55,29 +55,29 @@ versions: > Receiving objects: 100% (1732/1732), 528.19 KiB | 621 KiB/s, done. > Resolving deltas: 100% (1086/1086), done. > From git://github.com/octocat/Spoon-Knife - > * [new branch] master -> Spoon-Knife/master + > * [new branch] main -> Spoon-Knife/main ``` 2. `Spoon-Knife` プロジェクトをローカルの Git プロジェクトにマージします。 こうしてもローカルではファイルはまったく変更されませんが、Git は次のステップに備えることになります。 Git 2.9 以降を使用している場合: ```shell - $ git merge -s ours --no-commit --allow-unrelated-histories spoon-knife/master + $ git merge -s ours --no-commit --allow-unrelated-histories spoon-knife/main > Automatic merge went well; stopped before committing as requested ``` Git 2.8 以前を使用している場合: ```shell - $ git merge -s ours --no-commit spoon-knife/master + $ git merge -s ours --no-commit spoon-knife/main > Automatic merge went well; stopped before committing as requested ``` 3. **spoon-knife** というディレクトリを新たに作成し、`Spoon-Knife` プロジェクトの Git の履歴をそこへコピーします。 ```shell - $ git read-tree --prefix=spoon-knife/ -u spoon-knife/master + $ git read-tree --prefix=spoon-knife/ -u spoon-knife/main ``` 4. 変更をコミットして安全にします。 ```shell $ git commit -m "Subtree merged in spoon-knife" - > [master fe0ca25] Subtree merged in spoon-knife + > [main fe0ca25] Subtree merged in spoon-knife ``` ここでは 1 つのサブプロジェクトを追加しただけですが、Git リポジトリには任意の数のサブプロジェクトを取り込むことができます。 @@ -99,7 +99,7 @@ $ git pull -s subtree remotename branchname 上の例では、以下のようになるでしょう: ```shell -$ git pull -s subtree spoon-knife master +$ git pull -s subtree spoon-knife main ``` ### 参考リンク diff --git a/translations/ja-JP/content/github/using-git/about-remote-repositories.md b/translations/ja-JP/content/github/using-git/about-remote-repositories.md index a0de26d2a5de..8980f9b9509e 100644 --- a/translations/ja-JP/content/github/using-git/about-remote-repositories.md +++ b/translations/ja-JP/content/github/using-git/about-remote-repositories.md @@ -4,7 +4,7 @@ redirect_from: - /articles/working-when-github-goes-down/ - /articles/sharing-repositories-without-github/ - /articles/about-remote-repositories -intro: GitHub のコラボレーティブな開発へのアプローチは、ローカルリポジトリからコミットを公開して、他者が見たり、フェッチしたり、更新したりできるようにすることに依存しています。 +intro: 'GitHub のコラボレーティブな開発へのアプローチは、ローカルリポジトリからコミットを公開して、他者が見たり、フェッチしたり、更新したりできるようにすることに依存しています。' versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ja-JP/content/github/using-git/adding-a-remote.md b/translations/ja-JP/content/github/using-git/adding-a-remote.md index 2c6f14367734..2a974fbdd61b 100644 --- a/translations/ja-JP/content/github/using-git/adding-a-remote.md +++ b/translations/ja-JP/content/github/using-git/adding-a-remote.md @@ -1,6 +1,6 @@ --- title: リモートの追加 -intro: 新しいリモートを追加するには、リポジトリが保存されているディレクトリでターミナルから `git remote add` コマンドを使ってください。 +intro: '新しいリモートを追加するには、リポジトリが保存されているディレクトリでターミナルから `git remote add` コマンドを使ってください。' redirect_from: - /articles/adding-a-remote versions: diff --git a/translations/ja-JP/content/github/using-git/changing-a-remotes-url.md b/translations/ja-JP/content/github/using-git/changing-a-remotes-url.md index 4b5c686398b2..3298fef9ec04 100644 --- a/translations/ja-JP/content/github/using-git/changing-a-remotes-url.md +++ b/translations/ja-JP/content/github/using-git/changing-a-remotes-url.md @@ -3,7 +3,7 @@ title: リモートの URL の変更 redirect_from: - /articles/changing-a-remote-s-url - /articles/changing-a-remotes-url -intro: 「git remote set-url」コマンドにより、既存のリモートリポジトリ URL を変更できます。 +intro: '「git remote set-url」コマンドにより、既存のリモートリポジトリ URL を変更できます。' versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ja-JP/content/github/using-git/configuring-git-to-handle-line-endings.md b/translations/ja-JP/content/github/using-git/configuring-git-to-handle-line-endings.md index 581010743a53..dc4a3d961ab3 100644 --- a/translations/ja-JP/content/github/using-git/configuring-git-to-handle-line-endings.md +++ b/translations/ja-JP/content/github/using-git/configuring-git-to-handle-line-endings.md @@ -1,6 +1,6 @@ --- title: 行終端を処理するようGitを設定する -intro: diff における問題を回避するため、行終端を正しく処理できるよう Git を設定できます。 +intro: 'diff における問題を回避するため、行終端を正しく処理できるよう Git を設定できます。' redirect_from: - /dealing-with-lineendings/ - /line-endings/ diff --git a/translations/ja-JP/content/github/using-git/dealing-with-non-fast-forward-errors.md b/translations/ja-JP/content/github/using-git/dealing-with-non-fast-forward-errors.md index dce36c348ea7..dec0d55ee207 100644 --- a/translations/ja-JP/content/github/using-git/dealing-with-non-fast-forward-errors.md +++ b/translations/ja-JP/content/github/using-git/dealing-with-non-fast-forward-errors.md @@ -1,6 +1,6 @@ --- title: non-fast-forward エラーの扱い -intro: 時として、Git はリモートリポジトリへの変更の際、コミットに失敗することがあります。 その場合、プッシュが拒否されます。 +intro: '時として、Git はリモートリポジトリへの変更の際、コミットに失敗することがあります。 その場合、プッシュが拒否されます。' redirect_from: - /articles/dealing-with-non-fast-forward-errors versions: @@ -11,9 +11,9 @@ versions: 別の人が同じブランチにすでにプッシュしてしまった場合、Git はあなたの変更をプッシュできません: ```shell -$ git push origin master +$ git push origin main > To https://{% data variables.command_line.codeblock %}/USERNAME/REPOSITORY.git -> ! [rejected] master -> master (non-fast-forward) +> ! [rejected] main -> main (non-fast-forward) > error: failed to push some refs to 'https://{% data variables.command_line.codeblock %}/USERNAME/REPOSITORY.git' > To prevent you from losing history, non-fast-forward updates were rejected > Merge the remote changes (e.g. 'git pull') before pushing again. See the diff --git a/translations/ja-JP/content/github/using-git/getting-changes-from-a-remote-repository.md b/translations/ja-JP/content/github/using-git/getting-changes-from-a-remote-repository.md index ffb250b78d70..5868fb42867f 100644 --- a/translations/ja-JP/content/github/using-git/getting-changes-from-a-remote-repository.md +++ b/translations/ja-JP/content/github/using-git/getting-changes-from-a-remote-repository.md @@ -70,5 +70,5 @@ $ git pull remotename branchname ### 参考リンク -- [書籍 _Pro Git_ のリモートでの作業](https://git-scm.com/book/ja/v2/Git-の基本-リモートでの作業){% if currentVersion == "free-pro-team@latest" %} +- ["Working with Remotes" from the _Pro Git_ book](https://git-scm.com/book/en/Git-Basics-Working-with-Remotes)"{% if currentVersion == "free-pro-team@latest" %} - 「[接続の問題のトラブルシューティング](/articles/troubleshooting-connectivity-problems)」{% endif %} diff --git a/translations/ja-JP/content/github/using-git/pushing-commits-to-a-remote-repository.md b/translations/ja-JP/content/github/using-git/pushing-commits-to-a-remote-repository.md index eeeec5e04d3d..c90441571b69 100644 --- a/translations/ja-JP/content/github/using-git/pushing-commits-to-a-remote-repository.md +++ b/translations/ja-JP/content/github/using-git/pushing-commits-to-a-remote-repository.md @@ -12,7 +12,7 @@ versions: `git push` コマンドは、2 つの引数を取ります: * リモート名。たとえば `origin` -* ブランチ名。たとえば `master` +* ブランチ名。 たとえば `master` 例: diff --git a/translations/ja-JP/content/github/using-git/removing-a-remote.md b/translations/ja-JP/content/github/using-git/removing-a-remote.md index 8f3ae1b7a920..c9d1a87e51ac 100644 --- a/translations/ja-JP/content/github/using-git/removing-a-remote.md +++ b/translations/ja-JP/content/github/using-git/removing-a-remote.md @@ -14,7 +14,7 @@ versions: ### サンプル -These examples assume you're [cloning using HTTPS](/articles/which-remote-url-should-i-use/#cloning-with-https-urls), which is recommended. +次の例は (推奨されるとおり) [HTTPS を使用してクローンを作成](/articles/which-remote-url-should-i-use/#cloning-with-https-urls)したと想定しています。 ```shell $ git remote -v diff --git a/translations/ja-JP/content/github/using-git/renaming-a-remote.md b/translations/ja-JP/content/github/using-git/renaming-a-remote.md index 077948639355..c097b089e002 100644 --- a/translations/ja-JP/content/github/using-git/renaming-a-remote.md +++ b/translations/ja-JP/content/github/using-git/renaming-a-remote.md @@ -1,6 +1,6 @@ --- title: リモートの名前を変更する -intro: 「git remote rename」コマンドを使用して、既存のリモートの名前を変更します。 +intro: '「git remote rename」コマンドを使用して、既存のリモートの名前を変更します。' redirect_from: - /articles/renaming-a-remote versions: @@ -15,7 +15,7 @@ versions: ### サンプル -These examples assume you're [cloning using HTTPS](/articles/which-remote-url-should-i-use/#cloning-with-https-urls), which is recommended. +次の例は (推奨されるとおり) [HTTPS を使用してクローンを作成](/articles/which-remote-url-should-i-use/#cloning-with-https-urls)したと想定しています。 ```shell $ git remote -v diff --git a/translations/ja-JP/content/github/using-git/using-git-rebase-on-the-command-line.md b/translations/ja-JP/content/github/using-git/using-git-rebase-on-the-command-line.md index b7e6f085374c..078119ef51a1 100644 --- a/translations/ja-JP/content/github/using-git/using-git-rebase-on-the-command-line.md +++ b/translations/ja-JP/content/github/using-git/using-git-rebase-on-the-command-line.md @@ -123,7 +123,7 @@ i cant' typ goods Git の履歴を変更したので、通常の `git push origin` **は動作しません**。 最新の変更を「強制プッシュ」して、コマンドを変更する必要があります: ```shell -$ git push origin master --force +$ git push origin main --force ``` {% warning %} diff --git a/translations/ja-JP/content/github/using-git/which-remote-url-should-i-use.md b/translations/ja-JP/content/github/using-git/which-remote-url-should-i-use.md index b3d21df8b635..c5b1f00a475f 100644 --- a/translations/ja-JP/content/github/using-git/which-remote-url-should-i-use.md +++ b/translations/ja-JP/content/github/using-git/which-remote-url-should-i-use.md @@ -31,7 +31,7 @@ versions: {% endtip %} - {% if currentVersion == "free-pro-team@latest" %}SSH を使用したくてもポート 22 で接続できない場合は、HTTPS ポートを介する SSH を使用できる場合があります。 詳細は、「[HTTPS ポートを介して SSH を使用する](/github/authenticating-to-github/using-ssh-over-the-https-port)」を参照してください。{% endif %} + {% if currentVersion == "free-pro-team@latest" %}If you'd rather use SSH but cannot connect over port 22, you might be able to use SSH over the HTTPS port. 詳細は、「[HTTPS ポートを介して SSH を使用する](/github/authenticating-to-github/using-ssh-over-the-https-port)」を参照してください。{% endif %} ### SSH URL を使ってクローンする @@ -39,7 +39,7 @@ SSH URL は、SSH (安全なプロトコル) を介した Git リポジトリへ SSH URL を使用して、`git clone`、`git fetch`、`git pull` または `git push` をリモートリポジトリに実行すると、パスワードの入力を求められ、SSH キーパスフレーズを入力する必要があります。 詳しい情報については[SSH キーのパスフレーズを使う](/github/authenticating-to-github/working-with-ssh-key-passphrases)を参照してください。 -{% if currentVersion == "free-pro-team@latest" %}SAML シングルサインオン (SSO) を使っている Organization にアクセスしている場合は、認証を受ける前に、Organization にアクセスする SSHキーを認可する必要があります。 詳しい情報については「[SAMLシングルサインオンでの認証について](/github/authenticating-to-github/about-authentication-with-saml-single-sign-on)」および「[SAML シングルサインオンで使うためにSSHキーを認可する](/github/authenticating-to-github/authorizing-an-ssh-key-for-use-with-saml-single-sign-on)」を参照してください。{% endif %} +{% if currentVersion == "free-pro-team@latest" %}If you are accessing an organization that uses SAML single sign-on (SSO), you must authorize your SSH key to access the organization before you authenticate. 詳しい情報については「[SAMLシングルサインオンでの認証について](/github/authenticating-to-github/about-authentication-with-saml-single-sign-on)」および「[SAML シングルサインオンで使うためにSSHキーを認可する](/github/authenticating-to-github/authorizing-an-ssh-key-for-use-with-saml-single-sign-on)」を参照してください。{% endif %} {% tip %} diff --git a/translations/ja-JP/content/github/using-git/why-is-git-always-asking-for-my-password.md b/translations/ja-JP/content/github/using-git/why-is-git-always-asking-for-my-password.md index aa01fff3e64f..bdb0e35b2007 100644 --- a/translations/ja-JP/content/github/using-git/why-is-git-always-asking-for-my-password.md +++ b/translations/ja-JP/content/github/using-git/why-is-git-always-asking-for-my-password.md @@ -1,6 +1,6 @@ --- title: Git が常にパスワードを要求するのはなぜですか？ -intro: GitHub とやり取りしようとするたびに Git がユーザ名とパスワードの入力を求めてくる場合は、おそらくリポジトリに HTTPS クローン URL を使用しています。 +intro: 'GitHub とやり取りしようとするたびに Git がユーザ名とパスワードの入力を求めてくる場合は、おそらくリポジトリに HTTPS クローン URL を使用しています。' redirect_from: - /articles/why-is-git-always-asking-for-my-password versions: diff --git a/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/about-repository-graphs.md b/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/about-repository-graphs.md index 8d66b8da74be..94cd6cd82c19 100644 --- a/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/about-repository-graphs.md +++ b/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/about-repository-graphs.md @@ -9,7 +9,7 @@ versions: enterprise-server: '*' --- -リポジトリグラフは、{% if currentVersion == "free-pro-team@latest" %}トラフィック、リポジトリに依存するプロジェクト、{% endif %}リポジトリのコントリビューターとコミット、そしてリポジトリのフォークやネットワークに関する情報を提供します。 自分が管理しているリポジトリがある場合、このデータを使用すれば、リポジトリを誰が使っているのか、なぜ使っているのかをよりよく知ることができます。 +A repository's graphs give you information on {% if currentVersion == "free-pro-team@latest" %} traffic, projects that depend on the repository,{% endif %} contributors and commits to the repository, and a repository's forks and network. 自分が管理しているリポジトリがある場合、このデータを使用すれば、リポジトリを誰が使っているのか、なぜ使っているのかをよりよく知ることができます。 {% if currentVersion == "free-pro-team@latest" %} diff --git a/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md b/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md index 3ebfd0eae0c5..069c3b38eda2 100644 --- a/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md +++ b/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md @@ -47,7 +47,6 @@ You can use the dependency graph to: {% if currentVersion == "free-pro-team@latest" %}To generate a dependency graph, {% data variables.product.product_name %} needs read-only access to the dependency manifest and lock files for a repository. The dependency graph is automatically generated for all public repositories and you can choose to enable it for private repositories. For information about enabling or disabling it for private repositories, see "[Exploring the dependencies of a repository](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository)."{% endif %} - {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %}If the dependency graph is not available in your system, your site administrator can enable the dependency graph and {% data variables.product.prodname_dependabot_short %} alerts. For more information, see "[Enabling alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server)."{% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %} If the dependency graph is not available in your system, your site administrator can enable the dependency graph and security alerts. For more information, see "[Enabling alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server)." @@ -62,7 +61,7 @@ The recommended formats explicitly define which versions are used for all direct | Package manager | Languages | Recommended formats | All supported formats | | --- | --- | --- | ---| -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}| Composer | PHP | `composer.lock` | `composer.json`, `composer.lock` |{% endif %} +| Composer | PHP | `composer.lock` | `composer.json`, `composer.lock` | | `dotnet` CLI | .NET languages (C#, C++, F#, VB) | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj` | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj`, `packages.config` | | Maven | Java, Scala | `pom.xml` | `pom.xml` | | npm | JavaScript | `package-lock.json` | `package-lock.json`, `package.json`| diff --git a/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/accessing-basic-repository-data.md b/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/accessing-basic-repository-data.md index a5feeb205d1b..8ab24abffa58 100644 --- a/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/accessing-basic-repository-data.md +++ b/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/accessing-basic-repository-data.md @@ -1,6 +1,6 @@ --- title: 基本的なリポジトリデータへのアクセス -intro: 'リポジトリのアクティビティ{% if currentVersion == "free-pro-team@latest" %}、トラフィック{% endif %}、コントリビューションのアクティビティなど、リポジトリについての基本情報を見ることができます。' +intro: 'You can view basic information about a repository, such as the repository''s activity{% if currentVersion == "free-pro-team@latest" %}, traffic,{% endif %} and contribution activity.' mapTopic: true redirect_from: - /articles/accessing-basic-repository-data diff --git a/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/analyzing-changes-to-a-repositorys-content.md b/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/analyzing-changes-to-a-repositorys-content.md index bed499dba7fc..391afc9ec6de 100644 --- a/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/analyzing-changes-to-a-repositorys-content.md +++ b/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/analyzing-changes-to-a-repositorys-content.md @@ -1,6 +1,6 @@ --- title: リポジトリの内容への変更の分析 -intro: リポジトリのコミット、コミット頻度、内容の追加や削除を分析することで、リポジトリの内容の変更を見ることができます。 +intro: 'リポジトリのコミット、コミット頻度、内容の追加や削除を分析することで、リポジトリの内容の変更を見ることができます。' redirect_from: - /articles/viewing-commit-frequency-in-a-repository/ - /articles/analyzing-changes-to-a-repository-s-content diff --git a/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md b/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md index 7bb60473b9c2..f646fc20e1c6 100644 --- a/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md +++ b/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md @@ -26,7 +26,8 @@ The dependency graph shows the dependencies{% if currentVersion == "free-pro-tea #### 依存関係ビュー {% if currentVersion == "free-pro-team@latest" %} -依存関係はエコシステム別にグループ化されます。 依存関係を拡張すると、その依存関係を表示できます。 For dependencies on public repositories hosted on {% data variables.product.product_name %}, you can also click a dependency to view the repository. Dependencies on private repositories, private packages, or unrecognized files are shown in plain text. +依存関係はエコシステム別にグループ化されます。 依存関係を拡張すると、その依存関係を表示できます。 For dependencies on public repositories hosted on +{% data variables.product.product_name %}, you can also click a dependency to view the repository. Dependencies on private repositories, private packages, or unrecognized files are shown in plain text. If vulnerabilities have been detected in the repository, these are shown at the top of the view for users with access to {% data variables.product.prodname_dependabot_alerts %}. @@ -35,7 +36,8 @@ If vulnerabilities have been detected in the repository, these are shown at the {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %} -Any direct and indirect dependencies that are specified in the repository's manifest or lock files are listed, grouped by ecosystem. If vulnerabilities have been detected in the repository, these are shown at the top of the view for users with access to {% data variables.product.prodname_dependabot_short %} alerts. +Any direct and indirect dependencies that are specified in the repository's manifest or lock files are listed, grouped by ecosystem. If vulnerabilities have been detected in the repository, these are shown at the top of the view for users with access to +{% data variables.product.prodname_dependabot_short %} アラート. {% note %} @@ -98,14 +100,15 @@ You can also enable or disable the dependency graph for all repositories owned b 依存関係グラフが空の場合は、依存関係を含むファイルに問題があるかもしれません。 ファイルがファイルタイプに合わせて適切にフォーマットされているかをチェックしてください。 {% if currentVersion == "free-pro-team@latest" %} -ファイルのフォーマットが正しい場合は、大きさをチェックします。 あなたが {% data variables.product.prodname_enterprise %} ユーザでない限り、依存関係グラフは 0.5 MB を超える個々のマニフェストおよびロックファイルを無視します。 デフォルトでは、最大 20 個のマニフェストまたはロックファイルが処理されるので、リポジトリのサブディレクトリで依存関係を小さいファイルに分割することができます。{% endif %} +ファイルのフォーマットが正しい場合は、大きさをチェックします。 The dependency graph ignores individual manifest and lock files that are over 0.5 Mb, unless you are a +{% data variables.product.prodname_enterprise %} user. デフォルトでは、最大 20 個のマニフェストまたはロックファイルが処理されるので、リポジトリのサブディレクトリで依存関係を小さいファイルに分割することができます。{% endif %} マニフェストまたはロックファイルが処理されない場合、その依存関係は依存関係グラフから省略され、脆弱な依存関係はチェックされなくなります。 ### 参考リンク -- [依存関係グラフについて](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph){% if currentVersion == "free-pro-team@latest" %} -- "[Viewing insights for your organization](/github/setting-up-and-managing-organizations-and-teams/viewing-insights-for-your-organization)" +- "[About the dependency graph](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)"{% if currentVersion == "free-pro-team@latest" %} +- [Organization のインサイトを表示する](/github/setting-up-and-managing-organizations-and-teams/viewing-insights-for-your-organization) - [リポジトリ内の脆弱な依存関係を表示・更新する](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository) -- [{% data variables.product.product_name %}によるデータの利用と保護の方法の理解](/github/understanding-how-github-uses-and-protects-your-data) +- [{% data variables.product.product_name %} によるデータの利用方法と保護方法を理解する](/github/understanding-how-github-uses-and-protects-your-data) {% endif %} diff --git a/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/understanding-connections-between-repositories.md b/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/understanding-connections-between-repositories.md index a72651fc3271..b9dd8a9d6ad5 100644 --- a/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/understanding-connections-between-repositories.md +++ b/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/understanding-connections-between-repositories.md @@ -1,6 +1,6 @@ --- title: リポジトリ間の接続を理解する -intro: 'リポジトリのネットワーク{% if currentVersion == "free-pro-team@latest" %}、リポジトリに依存するプロジェクト{% endif %}やそのフォークを確認することで、リポジトリ間のつながりをより深く理解できます。' +intro: 'You can better understand the connections that exist between repositories by viewing a repository''s network{% if currentVersion == "free-pro-team@latest" %}, projects that depend on the repository,{% endif %} and its forks.' mapTopic: true redirect_from: - /articles/understanding-connections-between-repositories diff --git a/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/viewing-a-projects-contributors.md b/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/viewing-a-projects-contributors.md index eb206ad3aa59..52b844cabb53 100644 --- a/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/viewing-a-projects-contributors.md +++ b/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/viewing-a-projects-contributors.md @@ -1,6 +1,6 @@ --- title: プロジェクトのコントリビューターを表示する -intro: 'リポジトリへのコミットにコントリビュートした人{% if currentVersion == "free-pro-team@latest" %}とその依存関係{% endif %}を表示できます。' +intro: 'You can see who contributed commits to a repository{% if currentVersion == "free-pro-team@latest" %} and its dependencies{% endif %}.' redirect_from: - /articles/i-don-t-see-myself-in-the-contributions-graph/ - /articles/viewing-contribution-activity-in-a-repository/ @@ -13,7 +13,7 @@ versions: ### コントリビューターについて -コントリビューターグラフで{% if currentVersion != "free-pro-team@latest" %}、コミットの共作者を含めて{% endif %}、リポジトリに貢献した上位 100 人のコントリビューターを表示できます。 マージコミットと空のコミットは、このグラフでコントリビューションとして数えられません。 +You can view the top 100 contributors to a repository{% if currentVersion != "free-pro-team@latest" %}, including commit co-authors,{% endif %} in the contributors graph. マージコミットと空のコミットは、このグラフでコントリビューションとして数えられません。 {% if currentVersion == "free-pro-team@latest" %} You can also see a list of people who have contributed to the project's Python dependencies. この、コミュニティコントリビューターのリストを表示するには、`https://github.com/REPO-OWNER/REPO-NAME/community_contributors` にアクセスしてください。 diff --git a/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/viewing-a-repositorys-network.md b/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/viewing-a-repositorys-network.md index 2436cff62847..c758cdba523f 100644 --- a/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/viewing-a-repositorys-network.md +++ b/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/viewing-a-repositorys-network.md @@ -1,6 +1,6 @@ --- title: リポジトリのネットワークを表示する -intro: ネットワークグラフには、ルートリポジトリのブランチとネットワークに固有のコミットを含むフォークのブランチを含む、リポジトリネットワーク全体のブランチ履歴が表示されます。 +intro: 'ネットワークグラフには、ルートリポジトリのブランチとネットワークに固有のコミットを含むフォークのブランチを含む、リポジトリネットワーク全体のブランチ履歴が表示されます。' product: '{% data reusables.gated-features.repository-insights %}' redirect_from: - /articles/viewing-a-repository-s-network diff --git a/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/viewing-traffic-to-a-repository.md b/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/viewing-traffic-to-a-repository.md index 3812947c8910..5597ba968207 100644 --- a/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/viewing-traffic-to-a-repository.md +++ b/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/viewing-traffic-to-a-repository.md @@ -1,6 +1,6 @@ --- -title: リポジトリへのトラフィックを表示する -intro: フルクローン (フェッチではない)、過去 14 日間の訪問者、参照サイト、トラフィックグラフの人気コンテンツなど、リポジトリへのプッシュアクセスを持つユーザは誰でもそのトラフィックを表示できます。 +title: Viewing traffic to a repository +intro: 'Anyone with push access to a repository can view its traffic, including full clones (not fetches), visitors from the past 14 days, referring sites, and popular content in the traffic graph.' product: 'This repository insights graph is available in public repositories with {% data variables.product.prodname_free_user %} and {% data variables.product.prodname_free_team %} for organizations, and in public and private repositories with {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, and {% data variables.product.prodname_ghe_cloud %}.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[About repository graphs](/articles/about-repository-graphs)" and "[{% data variables.product.prodname_dotcom %}''s products](/articles/github-s-products)."{% endif %}' redirect_from: - /articles/viewing-traffic-to-a-repository @@ -8,20 +8,21 @@ versions: free-pro-team: '*' --- -特定のパスが参照されていたリンクから、検索エンジンと {% data variables.product.product_name %} 自体を除く、参照元サイトに移動できます。 人気のあるコンテンツは、トラフィックを発生させた特定のコンテンツにリンクしています。 +You can navigate to referring sites, excluding search engines and {% data variables.product.product_name %} itself, from the links the specific paths were referred from. The popular content links to the specific content that generated traffic. -参照サイトと人気のあるコンテンツは、ビューと一意の訪問者によって並べ替えられます。 フルクローンと訪問者情報は 1 時間ごとに更新され、参照サイトと人気のあるコンテンツセクションは毎日更新されます。 現在地に関係なく、トラフィックグラフのすべてのデータは、UTC+0 タイムゾーンを使用します。 +Referring sites and popular content are ordered by views and unique visitors. Full clones and visitor information update hourly, while referring sites and popular content sections update daily. All data in the traffic graph uses the UTC+0 timezone, regardless of your location. {% tip %} -**ヒント:** トラフィックグラフで特定の日にカーソルを合わせると、その日の正確なデータを表示できます。 +**Tip:** You can hover over a specific day in the traffic graph to view the exact data for that day. {% endtip %} -![ツールチップを使用したリポジトリトラフィックグラフ](/assets/images/help/graphs/repo_traffic_graphs_tooltip_dotcom.png) +![Repository traffic graphs with tooltip](/assets/images/help/graphs/repo_traffic_graphs_tooltip_dotcom.png) -### トラフィックグラフにアクセスする +### Accessing the traffic graph {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.accessing-repository-graphs %} -3. In the left sidebar, click **Traffic**. ![[Traffic] タブ](/assets/images/help/graphs/traffic_tab.png) +3. In the left sidebar, click **Traffic**. +![Traffic tab](/assets/images/help/graphs/traffic_tab.png) diff --git a/translations/ja-JP/content/github/working-with-github-pages/about-github-pages-and-jekyll.md b/translations/ja-JP/content/github/working-with-github-pages/about-github-pages-and-jekyll.md index 4f2a8a56f90b..be0ce8dbb76c 100644 --- a/translations/ja-JP/content/github/working-with-github-pages/about-github-pages-and-jekyll.md +++ b/translations/ja-JP/content/github/working-with-github-pages/about-github-pages-and-jekyll.md @@ -69,9 +69,10 @@ kramdown: {% data reusables.pages.add-jekyll-theme %}詳しい情報については、Jekyllドキュメンテーションの「[Themes](https://jekyllrb.com/docs/themes/)」を参照してください。 {% if currentVersion == "free-pro-team@latest" %} -{% data variables.product.prodname_dotcom %} のサイトに、サポートされているテーマを追加できます。 詳しい情報については、{% data variables.product.prodname_pages %} サイトの「[サポートされているテーマ](https://pages.github.com/themes/)」および「[テーマ選択画面を使用して{% data variables.product.prodname_pages %}サイトにテーマを追加する](/articles/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser)」を参照してください。 +You can add a supported theme to your site on +{% data variables.product.prodname_dotcom %}. 詳しい情報については、{% data variables.product.prodname_pages %} サイトの「[サポートされているテーマ](https://pages.github.com/themes/)」および「[テーマ選択画面を使用して{% data variables.product.prodname_pages %}サイトにテーマを追加する](/articles/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser)」を参照してください。 -{% data variables.product.prodname_dotcom %}にホストされている他のオープンソースJekyllテーマを使用する場合は、テーマを手動で追加できます。{% else %}テーマを手動でサイトに追加できます。{% endif %}詳細については、{% if currentVersion == "free-pro-team@latest" %} [ {% data variables.product.prodname_dotcom %}にホストされているテーマ](https://github.com/topics/jekyll-theme)と、{% else %}{% data variables.product.prodname_pages %}サイトの「[サポートされているテーマ](https://pages.github.com/themes/)」、および{% endif %}「[Jekyllを使用して{% data variables.product.prodname_pages %}サイトにテーマを追加する](/articles/adding-a-theme-to-your-github-pages-site-using-jekyll)」を参照してください。 +To use any other open source Jekyll theme hosted on {% data variables.product.prodname_dotcom %}, you can add the theme manually.{% else %} You can add a theme to your site manually.{% endif %} For more information, see{% if currentVersion == "free-pro-team@latest" %} [themes hosted on {% data variables.product.prodname_dotcom %}](https://github.com/topics/jekyll-theme) and{% else %} "[Supported themes](https://pages.github.com/themes/)" on the {% data variables.product.prodname_pages %} site and{% endif %} "[Adding a theme to your {% data variables.product.prodname_pages %} site using Jekyll](/articles/adding-a-theme-to-your-github-pages-site-using-jekyll)." テーマのファイルを編集することで、テーマのデフォルトを上書きできます。 詳しい情報については、テーマのドキュメンテーションおよびJekyllドキュメンテーションの「[Overriding your theme's defaults](https://jekyllrb.com/docs/themes/#overriding-theme-defaults)」を参照してください。 diff --git a/translations/ja-JP/content/github/working-with-github-pages/about-github-pages.md b/translations/ja-JP/content/github/working-with-github-pages/about-github-pages.md index bcda5214ef8c..890d04243be5 100644 --- a/translations/ja-JP/content/github/working-with-github-pages/about-github-pages.md +++ b/translations/ja-JP/content/github/working-with-github-pages/about-github-pages.md @@ -15,27 +15,29 @@ versions: enterprise-server: '*' --- -### {% data variables.product.prodname_pages %}について +### {% data variables.product.prodname_pages %} について {% data variables.product.prodname_pages %} は、{% data variables.product.product_name %} のリポジトリから HTML、CSS、および JavaScript ファイル を直接取得し、任意でビルドプロセスを通じてファイルを実行し、ウェブサイトを公開できる静的なサイトホスティングサービスです。 {% data variables.product.prodname_pages %} サイトの例については、[{% data variables.product.prodname_pages %} サンプル集](https://github.com/collections/github-pages-examples)で見ることができます。 {% if currentVersion == "free-pro-team@latest" %} -{% data variables.product.prodname_dotcom %} の`github.io` ドメインまたはご自身のカスタムドメインで、サイトをホストできます。 詳細は「[{% data variables.product.prodname_pages %} でカスタムドメインを使用する](/articles/using-a-custom-domain-with-github-pages)」を参照してください。 +You can host your site on +{% data variables.product.prodname_dotcom %}'s `github.io` domain or your own custom domain. 詳細は「[{% data variables.product.prodname_pages %} でカスタムドメインを使用する](/articles/using-a-custom-domain-with-github-pages)」を参照してください。 {% endif %} 作成方法については、「[{% data variables.product.prodname_pages %} サイトを作成する](/articles/creating-a-github-pages-site)」を参照してください。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -Organization owners can disable the publication of {% data variables.product.prodname_pages %} sites from the organization's repositories. For more information, see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)." +Organization owners can disable the publication of +{% data variables.product.prodname_pages %} sites from the organization's repositories. For more information, see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)." {% endif %} ### {% data variables.product.prodname_pages %} サイトの種類 {% data variables.product.prodname_pages %} サイトには、3 つの種類があります。プロジェクト、ユーザ、そして Organization です。 プロジェクトサイトは、JavaScript ライブラリやレシピ集など、{% data variables.product.product_name %} の特定のプロジェクトに関するものです。 ユーザおよび Organization サイトは、特定の {% data variables.product.product_name %} に関するものです。 -ユーザサイトを公開するには、{% if currentVersion == "free-pro-team@latest" %}`.github.io`{% else %}`.`{% endif %} という名前のユーザアカウントが所有するリポジトリを作成する必要があります。 Organization サイトを公開するには、 {% if currentVersion == "free-pro-team@latest" %}`.github.io`{% else %}`.`{% endif %}という名前のOrganizationが所有するリポジトリを作成する必要があります。 {% if currentVersion == "free-pro-team@latest" %}カスタムドメインを設定していない場合、ユーザおよび Organization サイトは `http(s)://.github.io` または `http(s)://.github.io` から利用できます。{% endif %} +To publish a user site, you must create a repository owned by your user account that's named {% if currentVersion == "free-pro-team@latest" %}`.github.io`{% else %}`.`{% endif %}. To publish an organization site, you must create a repository owned by an organization that's named {% if currentVersion == "free-pro-team@latest" %}`.github.io`{% else %}`.`{% endif %}. {% if currentVersion == "free-pro-team@latest" %}Unless you're using a custom domain, user and organization sites are available at `http(s)://.github.io` or `http(s)://.github.io`.{% endif %} -プロジェクトサイトのソースファイルは、プロジェクトと同じリポジトリに保存されます。 {% if currentVersion == "free-pro-team@latest" %}カスタムドメインを設定していない場合、プロジェクトサイトは `http(s)://.github.io/` または `http(s)://.github.io/` から利用できます。{% endif %} +プロジェクトサイトのソースファイルは、プロジェクトと同じリポジトリに保存されます。 {% if currentVersion == "free-pro-team@latest" %}Unless you're using a custom domain, project sites are available at `http(s)://.github.io/` or `http(s)://.github.io/`.{% endif %} {% if currentVersion == "free-pro-team@latest" %} カスタムドメインがサイトの URL に与える影響に関する詳しい情報については、「[カスタムドメインと {% data variables.product.prodname_pages %} について](/articles/about-custom-domains-and-github-pages)」を参照してください。 @@ -44,7 +46,8 @@ Organization owners can disable the publication of {% data variables.product.pro {% data variables.product.product_name %} アカウントごとに、ユーザまたは Organization サイトを 1 つだけ作成できます。 プロジェクトサイトの数については、Organization アカウントでもユーザアカウントでも、無制限です。 {% if currentVersion != "free-pro-team@latest" %} -サイトが利用できる URL については、{% data variables.product.product_location %} で Subdomain Isolation を有効にしているかどうかで異なります。 +The URL where your site is available depends on whether subdomain isolation is enabled for +{% data variables.product.product_location %}. | サイトの種類 | Subdomain Isolation が有効 | Subdomain isolation が無効 | | ------ | ----------------------- | ----------------------- | @@ -86,7 +89,7 @@ If you choose the `/docs` folder of any branch as your publishing source, {% dat プロジェクトサイトは、`master` ブランチまたは `master` ブランチ場の `/docs` フォルダから公開することもできます。 これらの公開元からサイトを公開するには、別の公開元を設定する必要があります。 詳しい情報については「[{% data variables.product.prodname_pages %} サイトの公開元を設定する](/articles/configuring-a-publishing-source-for-your-github-pages-site#choosing-a-publishing-source)」を参照してください。 - `master` ブランチ上の `/docs` フォルダを公開元として選択する場合、サイトを公開するため、{% data variables.product.prodname_pages %} は{% if currentVersion == "free-pro-team@latest" %}、_CNAME_ ファイルも含めた{% endif %}全てのファイルを `/docs` フォルダから読み取ります。{% if currentVersion == "free-pro-team@latest" %}たとえば、{% data variables.product.prodname_pages %} 設定からカスタムドメインを編集すると、そのカスタムドメインは `/docs/CNAME` に書き込みます。 _CNAME_ ファイルに関する詳しい情報については、「[{% data variables.product.prodname_pages %} サイト用のカスタムドメインを管理する](/articles/managing-a-custom-domain-for-your-github-pages-site)」を参照してください。{% endif %} + If you choose the `/docs` folder of the `master` branch as your publishing source, {% data variables.product.prodname_pages %} will read everything to publish your site{% if currentVersion == "free-pro-team@latest" %}, including the _CNAME_ file,{% endif %} from the `/docs` folder.{% if currentVersion == "free-pro-team@latest" %} For example, when you edit your custom domain through the {% data variables.product.prodname_pages %} settings, the custom domain will write to `/docs/CNAME`. _CNAME_ ファイルに関する詳しい情報については、「[{% data variables.product.prodname_pages %} サイト用のカスタムドメインを管理する](/articles/managing-a-custom-domain-for-your-github-pages-site)」を参照してください。{% endif %} デフォルトブランチが`master`または`gh-pages`ではない場合でも、他のブランチからはプロジェクトサイトを公開することはできません。 @@ -111,11 +114,11 @@ If you choose the `/docs` folder of any branch as your publishing source, {% dat {% endif %} {% data variables.product.prodname_pages %} サイトには、次の使用制限があります: - - {% data variables.product.prodname_pages %} ソースリポジトリには、1GB の推奨上限があります。{% if currentVersion == "free-pro-team@latest" %}詳しい情報については、「[私のディスク容量はいくつですか？](/articles/what-is-my-disk-quota/#file-and-repository-size-limitations)」を参照してください。{% endif %} + - {% data variables.product.prodname_pages %} source repositories have a recommended limit of 1GB.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[What is my disk quota?"](/articles/what-is-my-disk-quota/#file-and-repository-size-limitations){% endif %} - 公開された{% data variables.product.prodname_pages %}のサイトは1GB以上であってはなりません。 {% if currentVersion == "free-pro-team@latest" %} - - {% data variables.product.prodname_pages %} サイトには、月当たり 100GB の*ソフトな*帯域幅制限があります。 - - {% data variables.product.prodname_pages %} サイトには、時間当たり 10 ビルドの*ソフトな*制限があります。 + - {% data variables.product.prodname_pages %} sites have a *soft* bandwidth limit of 100GB per month. + - {% data variables.product.prodname_pages %} sites have a *soft* limit of 10 builds per hour. あなたのサイトがこれらの使用割当量を超えている場合、あなたのサイトにサービスを提供できないか、{% data variables.contact.contact_support %} から、あなたのサイトが当社のサーバーに与える影響を減らす方法を示唆するメールが届くことがあります。そうした方法の例としては、サードパーティのコンテンツ配信ネットワーク (CDN) をサイトの前に配置したり、リリースなどの他の {% data variables.product.prodname_dotcom %} 機能を利用したり、ニーズに合った別のホスティングサービスに移行したりすることなどが挙げられます。 @@ -132,8 +135,9 @@ If you choose the `/docs` folder of any branch as your publishing source, {% dat - 攻略法詐欺 - 性的・わいせつなコンテンツ - 自分の素性またはサイトの目的を誤って表現しているコンテンツ +If you have questions about whether your use or intended use falls into these categories, please contact -あなたの用途または意図された用途がこれらのカテゴリに該当するかどうかについて質問がある場合は、{% data variables.contact.contact_support %} にお問い合わせください。 +{% data variables.contact.contact_support %}. {% endif %} ### {% data variables.product.prodname_pages %} での MIME タイプ diff --git a/translations/ja-JP/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md b/translations/ja-JP/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md index 481c38bfc385..0dc362a6d40b 100644 --- a/translations/ja-JP/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md +++ b/translations/ja-JP/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md @@ -13,7 +13,7 @@ versions: ### Jekyllのビルドエラーについて -サイトの公開元に変更をプッシュした後で、{% data variables.product.prodname_pages %}がサイトのビルドを試行しない場合があります。{% if currentVersion == "free-pro-team@latest" %} +Sometimes, {% data variables.product.prodname_pages %} will not attempt to build your site after you push changes to your site's publishing source.{% if currentVersion == "free-pro-team@latest" %} - 変更をプッシュしたユーザーがメールアドレスを検証していない。 詳しい情報については、「[メールアドレスの検証](/articles/verifying-your-email-address)」を参照してください。{% endif %} - デプロイキーでプッシュしている。 サイトのリポジトリへのプッシュを自動化する場合は、かわりにマシンユーザーを設定できます。 詳しい情報については、「[デプロイキーを管理する](/v3/guides/managing-deploy-keys/#machine-users)」を参照してください。 - 公開元をビルドするようにCIサービスを設定していない。 たとえば、Travis CIは`gh-pages`ブランチを、セーフリストに追加しない限りビルドしません。 詳細は、Travis CIまたはCIサービスのドキュメンテーションで、「[ビルドのカスタマイズ](https://docs.travis-ci.com/user/customizing-the-build/#safelisting-or-blocklisting-branches)」を参照してください。 @@ -34,9 +34,7 @@ Jekyllがサイトのビルドを試行せず、エラーが発生した場合 サイトのテストをローカルで行なうことをお勧めします。それにより、ビルドエラーメッセージをコマンドラインで表示でき、変更を {% data variables.product.product_name %} にプッシュする前に、あらゆるビルドエラーに対処できます。 詳しい情報については、「[Jekyll を使用して {% data variables.product.prodname_pages %} サイトをローカルでテストする](/articles/testing-your-github-pages-site-locally-with-jekyll)」を参照してください。 -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} {% data variables.product.product_name %} サイトの公開元を更新するためプルリクエストを作成すると、そのプルリクエストの [**Checks**] タブでビルドエラーメッセージが表示されます。 詳しい情報については[ステータスチェックについて](/articles/about-status-checks)を参照してください。 -{% endif %} {% data variables.product.product_name %} の公開元に変更をプッシュする際、{% data variables.product.prodname_pages %} はサイトのビルドを試みます。 ビルドが失敗すると、プライマリメールアドレスにメールが送信されます。 また、ビルドの警告についてのメールも送信されます。 {% data reusables.pages.build-failure-email-server %} diff --git a/translations/ja-JP/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md b/translations/ja-JP/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md index 261009acbe08..df95d0777569 100644 --- a/translations/ja-JP/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md +++ b/translations/ja-JP/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md @@ -21,9 +21,9 @@ versions: {% data reusables.pages.navigate-publishing-source %} 2. *_config.yml* に移動します。 {% data reusables.repositories.edit-file %} -4. テーマ名のために、ファイルに新しい行を追加します。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - - サポートされている名前を使うには、{% else %}{% endif %}`theme: THEME-NAME` と入力します。_THEME-NAME_ の部分は、テーマのリポジトリの README に表示されている名前に置き換えます。 サポートされているテーマのリストについては、{% data variables.product.prodname_pages %} サイトで「[サポートされているテーマ](https://pages.github.com/themes/)」を参照してください。 ![Supported theme in config file](/assets/images/help/pages/add-theme-to-config-file.png){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - - {% data variables.product.prodname_dotcom %} にホストされているその他の任意の Jekyll テーマを使うには、`remote_theme: THEME-NAME` と入力します。THEME-NAME の部分は、テーマのリポジトリの README に表示されている名前に置き換えます。 ![Unsupported theme in config file](/assets/images/help/pages/add-remote-theme-to-config-file.png){% endif %} +4. テーマ名のために、ファイルに新しい行を追加します。 + - To use a supported theme, type `theme: THEME-NAME`, replacing _THEME-NAME_ with the name of the theme as shown in the README of the theme's repository. サポートされているテーマのリストについては、{% data variables.product.prodname_pages %} サイトで「[サポートされているテーマ](https://pages.github.com/themes/)」を参照してください。 ![Supported theme in config file](/assets/images/help/pages/add-theme-to-config-file.png) + - {% data variables.product.prodname_dotcom %} にホストされているその他の任意の Jekyll テーマを使うには、`remote_theme: THEME-NAME` と入力します。THEME-NAME の部分は、テーマのリポジトリの README に表示されている名前に置き換えます。 ![Unsupported theme in config file](/assets/images/help/pages/add-remote-theme-to-config-file.png) {% data reusables.files.write_commit_message %} {% data reusables.files.choose-commit-email %} {% data reusables.files.choose_commit_branch %} diff --git a/translations/ja-JP/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md b/translations/ja-JP/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md index 8733db801b04..7a450cc84d5b 100644 --- a/translations/ja-JP/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md +++ b/translations/ja-JP/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md @@ -1,6 +1,6 @@ --- title: GitHub Pages サイトの公開元を設定する -intro: '{% data variables.product.prodname_pages %} サイトでデフォルトの公開元を使用している場合、サイトは自動的に公開されます。 You can also choose to publish your{% if currentVersion ver_lt "enterprise-server@2.22" %} project{% endif %} site from a different branch or folder.' +intro: '{% data variables.product.prodname_pages %} サイトでデフォルトの公開元を使用している場合、サイトは自動的に公開されます。 You can also choose to publish your{% if currentVersion ver_lt "enterprise-server@2.23" %} project{% endif %} site from a different branch or folder.' redirect_from: - /articles/configuring-a-publishing-source-for-github-pages/ - /articles/configuring-a-publishing-source-for-your-github-pages-site @@ -15,7 +15,7 @@ versions: ### 公開元を選択する -Before you configure a publishing source, make sure the branch{% if currentVersion ver_lt "enterprise-server@2.22" %} or folder{% endif %} you want to use as your publishing source already exists in your repository.{% if currentVersion ver_lt "enterprise-server@2.22" %} For example, before you can publish your project site from the `/docs` folder on the `master` branch of your repository, you or a collaborator must create a `/docs` folder on the default `master` branch of your repository.{% endif %} +Before you configure a publishing source, make sure the branch{% if currentVersion ver_lt "enterprise-server@2.23" %} or folder{% endif %} you want to use as your publishing source already exists in your repository.{% if currentVersion ver_lt "enterprise-server@2.23" %} For example, before you can publish your project site from the `/docs` folder on the `master` branch of your repository, you or a collaborator must create a `/docs` folder on the default `master` branch of your repository.{% endif %} {% data reusables.pages.navigate-site-repo %} {% data reusables.repositories.sidebar-settings %} @@ -24,11 +24,13 @@ Before you configure a publishing source, make sure the branch{% if currentVersi 4. Optionally, use the drop-down menu to select a folder for your publishing source. ![Drop-down menu to select a folder for publishing source](/assets/images/help/pages/publishing-source-folder-drop-down.png) 5. [**Save**] をクリックします。 ![Button to save changes to publishing source settings](/assets/images/help/pages/publishing-source-save.png) {% else %} -3. [{% data variables.product.prodname_pages %}] で、[**Source**] ドロップダウンメニューから公開元を選択します。 ![公開元を選択するドロップダウンメニュー](/assets/images/help/pages/publishing-source-drop-down.png) +3. Under " +{% data variables.product.prodname_pages %}", use the **Source** drop-down menu and select a publishing source. + ![公開元を選択するドロップダウンメニュー](/assets/images/help/pages/publishing-source-drop-down.png) {% endif %} ### {% data variables.product.prodname_pages %} サイトの公開に関するトラブルシューティング {% data reusables.pages.admin-must-push %} -If you choose the `docs` folder on {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}any{% else %}the `master`{% endif %} branch as your publishing source, then later remove the `/docs` folder from that branch in your repository, your site won't build and you'll get a page build error message for a missing `/docs` folder. 詳細については、「[{% data variables.product.prodname_pages %} サイトの Jekyll ビルドエラーに関するトラブルシューティング](/articles/troubleshooting-jekyll-build-errors-for-github-pages-sites#missing-docs-folder)」を参照してください。 +If you choose the `docs` folder on {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}any{% else %}the `master`{% endif %} branch as your publishing source, then later remove the `/docs` folder from that branch in your repository, your site won't build and you'll get a page build error message for a missing `/docs` folder. 詳細については、「[{% data variables.product.prodname_pages %} サイトの Jekyll ビルドエラーに関するトラブルシューティング](/articles/troubleshooting-jekyll-build-errors-for-github-pages-sites#missing-docs-folder)」を参照してください。 diff --git a/translations/ja-JP/content/github/working-with-github-pages/creating-a-github-pages-site-with-jekyll.md b/translations/ja-JP/content/github/working-with-github-pages/creating-a-github-pages-site-with-jekyll.md index 2de7cb8d3a77..86907ab801db 100644 --- a/translations/ja-JP/content/github/working-with-github-pages/creating-a-github-pages-site-with-jekyll.md +++ b/translations/ja-JP/content/github/working-with-github-pages/creating-a-github-pages-site-with-jekyll.md @@ -1,24 +1,24 @@ --- -title: Jekyll を使用して GitHub Pages サイトを作成する -intro: '新規または既存のリポジトリ内に、{% data variables.product.prodname_pages %} Jekyll を使用してサイトを作成できます。' +title: Creating a GitHub Pages site with Jekyll +intro: 'You can use Jekyll to create a {% data variables.product.prodname_pages %} site in a new or existing repository.' product: '{% data reusables.gated-features.pages %}' redirect_from: - /articles/creating-a-github-pages-site-with-jekyll -permissions: 'リポジトリの管理者権限があるユーザは、Jekyll を使用して {% data variables.product.prodname_pages %} サイトにコンテンツを作成できます。' +permissions: 'People with admin permissions for a repository can create a {% data variables.product.prodname_pages %} site with Jekyll.' versions: free-pro-team: '*' enterprise-server: '*' --- -### 必要な環境 +### Prerequisites -Jekyll を使用して {% data variables.product.prodname_pages %} サイトを作成する前に、Jekyll と Git をインストールする必要があります。 詳しい情報については、Jekyll ドキュメンテーションの [Installation](https://jekyllrb.com/docs/installation/) および「[Git のセットアップ](/articles/set-up-git)」を参照してください。 +Before you can use Jekyll to create a {% data variables.product.prodname_pages %} site, you must install Jekyll and Git. For more information, see [Installation](https://jekyllrb.com/docs/installation/) in the Jekyll documentation and "[Set up Git](/articles/set-up-git)." {% data reusables.pages.recommend-bundler %} {% data reusables.pages.jekyll-install-troubleshooting %} -### サイト用にリポジトリを作成する +### Creating a repository for your site {% data reusables.pages.new-or-existing-repo %} @@ -29,22 +29,22 @@ Jekyll を使用して {% data variables.product.prodname_pages %} サイトを {% data reusables.pages.create-repo-name %} {% data reusables.repositories.choose-repo-visibility %} -### サイトを作成する +### Creating your site {% data reusables.pages.must-have-repo-first %} {% data reusables.command_line.open_the_multi_os_terminal %} -2. リポジトリのローカルコピーがまだない場合、サイトのソースファイルを保存したい場所に移動します。_PARENT-FOLDER_ は、リポジトリを保存したいフォルダの名前に置き換えてください。 +2. If you don't already have a local copy of your repository, navigate to the location where you want to store your site's source files, replacing _PARENT-FOLDER_ with the folder you want to contain the folder for your repository. ```shell $ cd PARENT-FOLDER ``` -3. ローカルの Git リポジトリをまだ初期化していない場合は、初期化します。 _REPOSITORY-NAME_ は、リポジトリの名前に置き換えてください。 +3. If you haven't already, initialize a local Git repository, replacing _REPOSITORY-NAME_ with the name of your repository. ```shell $ git init REPOSITORY-NAME > Initialized empty Git repository in /Users/octocat/my-site/.git/ # Creates a new folder on your computer, initialized as a Git repository - ``` - 4. ディレクトリをリポジトリに変更します。 + ``` + 4. Change directories to the repository. ```shell $ cd REPOSITORY-NAME # Changes the working directory @@ -57,30 +57,31 @@ Jekyll を使用して {% data variables.product.prodname_pages %} サイトを # Creates a new folder called docs $ cd docs ``` - サイトを `gh-pages` ブランチから公開する場合には、`gh-pages` ブランチを作成してチェックアウトします。 + If you chose to publish your site from the `gh-pages` branch, create and checkout the `gh-pages` branch. ```shell $ git checkout --orphan gh-pages # Creates a new branch, with no history or contents, called gh-pages and switches to the gh-pages branch ``` - 7. 新しい Jekyll サイトを作成するには、`jekyll new` コマンドを使用します。_VERSION_ は、Jekyll の現在の依存関係バージョンに置き換えてください。 詳しい情報については、{% data variables.product.prodname_pages %} サイトで「[依存関係のバージョン](https://pages.github.com/versions/)」を参照してください。 - - Bundler をインストールしている場合、以下のコマンドを入力します。 + 7. To create a new Jekyll site, use the `jekyll new` command, replacing _VERSION_ with the current dependency version for Jekyll. For more information, see "[Dependency versions](https://pages.github.com/versions/)" on the {% data variables.product.prodname_pages %} site. + - If you installed Bundler: ```shell $ bundle exec jekyll VERSION new . # Creates a Jekyll site in the current directory ``` - - Bundler をインストールしていない場合、以下のコマンドを入力します。 + - If you don't have Bundler installed: ```shell $ jekyll VERSION new . # Creates a Jekyll site in the current directory ``` -8. 作成された Gemfile を開き、Gemfile のコメントに従って {% data variables.product.prodname_pages %} を使用します。 ![Gemfile の更新手順](/assets/images/help/pages/gemfile-instructions.png) -9. `gem "github-pages"` の行を以下のように更新します。_VERSION_ は、`github-pages` の現在の依存関係バージョンに置き換えてください。 詳しい情報については、{% data variables.product.prodname_pages %} サイトで「[依存関係のバージョン](https://pages.github.com/versions/)」を参照してください。 +8. Open the Gemfile that was created and follow the instructions in the Gemfile's comments to use {% data variables.product.prodname_pages %}. + ![Instructions for updating Gemfile](/assets/images/help/pages/gemfile-instructions.png) +9. Update the `gem "github-pages"` line so that the line looks like this, replacing _VERSION_ with the current dependency version for `github-pages`. For more information, see "[Dependency versions](https://pages.github.com/versions/)" on the {% data variables.product.prodname_pages %} site. ```shell gem "github-pages", "~> VERSION", group: :jekyll_plugins ``` -10. Gemfile を保存して閉じます。 -11. 必要に応じて、サイトをローカルでテストします。 詳しい情報については、「[Jekyll を使用して {% data variables.product.prodname_pages %} サイトをローカルでテストする](/articles/testing-your-github-pages-site-locally-with-jekyll)」を参照してください。 -12. {% data variables.product.product_name %} リポジトリをリモートとして追加します。{% if currentVersion != "free-pro-team@latest" %}_HOSTNAME_ はアプライアンスのホスト名に、{% endif %}_USER_ はリポジトリ所有者のアカウントに{% if currentVersion != "free-pro-team@latest" %}、{% endif %}そして _REPOSITORY_ はリポジトリの名前に置き換えてください。 +10. Save and close the Gemfile. +11. Optionally, test your site locally. For more information, see "[Testing your {% data variables.product.prodname_pages %} site locally with Jekyll](/articles/testing-your-github-pages-site-locally-with-jekyll)." +12. Add your {% data variables.product.product_name %} repository as a remote, replacing {% if currentVersion != "free-pro-team@latest" %}_HOSTNAME_ with your appliance's hostname,{% endif %} _USER_ with the account that owns the repository{% if currentVersion != "free-pro-team@latest" %},{% endif %} and _REPOSITORY_ with the name of the repository. ```shell {% if currentVersion == "free-pro-team@latest" %} $ git remote add origin https://github.com/USER/REPOSITORY.git @@ -88,7 +89,7 @@ $ git remote add origin https://github.com/USER/REPOSITORY.git $ git remote add origin https://HOSTNAME/USER/REPOSITORY.git {% endif %} ``` -13. リポジトリを {% data variables.product.product_name %} にプッシュします。 _BRANCH_ は、作業を行なっているブランチの名前に置き換えてください。 +13. Push the repository to {% data variables.product.product_name %}, replacing _BRANCH_ with the name of the branch you're working on. ```shell $ git push -u origin BRANCH ``` @@ -99,8 +100,8 @@ $ git remote add origin https://HOSTNAME/USER/REPOSITORY.github.io//{% else %}`http(s):///pages///{% endif %}about/contact-us.md` で表示されます。 +新しいファイルを追加で作成することにより、ページを追加できます。 各ファイルは、公開元と同じディレクトリ構造で、サイト上に表示されます。 For example, if the publishing source for your project site is the `gh-pages` branch, and you create a new file called `/about/contact-us.md` on the `gh-pages` branch, the file will be available at {% if currentVersion == "free-pro-team@latest" %}`https://.github.io//{% else %}`http(s):///pages///{% endif %}about/contact-us.md` で表示されます。 -また、サイトの見た目をカスタマイズするため、テーマを追加できます。 詳しい情報については、{% if currentVersion == "free-pro-team@latest" %}「[テーマ選択画面で {% data variables.product.prodname_pages %} サイトにテーマを追加する](/articles/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser){% else %}「[Jekyll テーマ選択画面で {% data variables.product.prodname_pages %} サイトにテーマを追加する](/articles/adding-a-theme-to-your-github-pages-site-using-jekyll){% endif %}」を参照してください。 +また、サイトの見た目をカスタマイズするため、テーマを追加できます。 For more information, see {% if currentVersion == "free-pro-team@latest" %}"[Adding a theme to your {% data variables.product.prodname_pages %} site with the theme chooser](/articles/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser){% else %}"[Adding a theme to your {% data variables.product.prodname_pages %} site using Jekyll](/articles/adding-a-theme-to-your-github-pages-site-using-jekyll){% endif %}." サイトを更にカスタマイズするには、Jekyll を使用できます。Jekyll は、{% data variables.product.prodname_pages %} に組み込まれている静的サイトジェネレータです。 詳しい情報については、「[{% data variables.product.prodname_pages %} と Jekyll](/articles/about-github-pages-and-jekyll)」を参照してください。 diff --git a/translations/ja-JP/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md b/translations/ja-JP/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md index 0c9a0ce11fed..444a340c9ed3 100644 --- a/translations/ja-JP/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md +++ b/translations/ja-JP/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md @@ -40,7 +40,8 @@ DNS レコードの設定が正しいかどうかを検証するために利用 {% data reusables.pages.navigate-site-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.pages.save-custom-domain %} -5. お使いの DNS プロバイダにアクセスし、サブドメインがサイトのデフォルトドメインを指す `CNAME` レコードを作成します。 たとえば、サイトで `www.example.com` というサブドメインを使いたい場合、`www.example.com` が `.github.io` を指す`CNAME` レコードを作成します。 If you want to use the subdomain `www.anotherexample.com` for your organization site, create a `CNAME` record that points `www.anotherexample.com` to `.github.io`. The `CNAME` file should always point to `.github.io` or `.github.io`, excluding the repository name. {% data reusables.pages.contact-dns-provider %}{% data reusables.pages.default-domain-information %} +5. お使いの DNS プロバイダにアクセスし、サブドメインがサイトのデフォルトドメインを指す `CNAME` レコードを作成します。 たとえば、サイトで `www.example.com` というサブドメインを使いたい場合、`www.example.com` が `.github.io` を指す`CNAME` レコードを作成します。 If you want to use the subdomain `www.anotherexample.com` for your organization site, create a `CNAME` record that points `www.anotherexample.com` to `.github.io`. The `CNAME` file should always point to `.github.io` or `.github.io`, excluding the repository name. +{% data reusables.pages.contact-dns-provider %}{% data reusables.pages.default-domain-information %} {% data reusables.command_line.open_the_multi_os_terminal %} 6. DNS レコードが正しくセットアップされたことを確認するには、 `dig` コマンドを使います。_WWW.EXAMPLE.COM_ は、お使いのサブドメインに置き換えてください。 ```shell diff --git a/translations/ja-JP/content/github/working-with-github-pages/troubleshooting-jekyll-build-errors-for-github-pages-sites.md b/translations/ja-JP/content/github/working-with-github-pages/troubleshooting-jekyll-build-errors-for-github-pages-sites.md index f35bd504d5ce..1ed03b1e523d 100644 --- a/translations/ja-JP/content/github/working-with-github-pages/troubleshooting-jekyll-build-errors-for-github-pages-sites.md +++ b/translations/ja-JP/content/github/working-with-github-pages/troubleshooting-jekyll-build-errors-for-github-pages-sites.md @@ -1,6 +1,6 @@ --- -title: GitHub Pages サイトの Jekyll ビルドエラーに関するトラブルシューティング -intro: 'Jekyll ビルドエラーのメッセージを利用して、{% data variables.product.prodname_pages %} サイトの問題をトラブルシューティングすることができます。' +title: Troubleshooting Jekyll build errors for GitHub Pages sites +intro: 'You can use Jekyll build error messages to troubleshoot problems with your {% data variables.product.prodname_pages %} site.' redirect_from: - /articles/page-build-failed-missing-docs-folder/ - /articles/page-build-failed-invalid-submodule/ @@ -30,25 +30,25 @@ versions: enterprise-server: '*' --- -### ビルドエラーのトラブルシューティング +### Troubleshooting build errors -{% data variables.product.prodname_pages %} サイトをローカルで、または {% data variables.product.product_name %} 上でビルドしているときに Jekyll でエラーが発生した場合、そのエラーメッセージをトラブルシューティングに利用できます。 エラーメッセージとその見方に関する詳しい情報は、「[{% data variables.product.prodname_pages %} サイトのJekyllビルドエラーについて](/articles/about-jekyll-build-errors-for-github-pages-sites)」を参照してください。 +If Jekyll encounters an error building your {% data variables.product.prodname_pages %} site locally or on {% data variables.product.product_name %}, you can use error messages to troubleshoot. For more information about error messages and how to view them, see "[About Jekyll build errors for {% data variables.product.prodname_pages %} sites](/articles/about-jekyll-build-errors-for-github-pages-sites)." -一般的なエラーメッセージが表示された場合は、よくある問題をチェックします。 -- サポートされていないプラグインを使用している。 詳しい情報については、「[{% data variables.product.prodname_pages %} と Jekyll について](/articles/about-github-pages-and-jekyll#plugins)」を参照してください。{% if currentVersion == "free-pro-team@latest" %} -- リポジトリがリポジトリサイズの制限を超えている。 詳しい情報については「[私のディスク容量はいくつですか？](/articles/what-is-my-disk-quota)」を参照してください。{% endif %} -- *_config.yml* ファイルで `source` の設定を変更した。 ビルドプロセス中に、この設定は {% data variables.product.prodname_pages %} によってオーバーライドされます。 -- 公開ソースにあるファイル名にコロン (`:`) が含まれている。コロンは使用できません。 +If you received a generic error message, check for common issues. +- You're using unsupported plugins. For more information, see "[About {% data variables.product.prodname_pages %} and Jekyll](/articles/about-github-pages-and-jekyll#plugins)."{% if currentVersion == "free-pro-team@latest" %} +- Your repository has exceeded our repository size limits. For more information, see "[What is my disk quota?](/articles/what-is-my-disk-quota)"{% endif %} +- You changed the `source` setting in your *_config.yml* file. {% data variables.product.prodname_pages %} overrides this setting during the build process. +- A filename in your publishing source contains a colon (`:`) which is not supported. -具体的なエラーメッセージが表示された場合は、エラーメッセージに関する以下のトラブルシューティング情報を確認してください。 +If you received a specific error message, review the troubleshooting information for the error message below. -エラーを修正したら、ソースを公開しているサイトにその変更をプッシュし、{% data variables.product.product_name %} でもう一度ビルドを実行します。 +After you've fixed any errors, push the changes to your site's publishing source to trigger another build on {% data variables.product.product_name %}. ### Config file error -このエラーメッセージは、*_config.yml* ファイルに構文エラーがあるためにサイトのビルドに失敗したことを意味します。 +This error means that your site failed to build because the *_config.yml* file contains syntax errors. -トラブルシューティングの際は、*_config.yml* ファイルが次のルールに従っていることを確認してください。 +To troubleshoot, make sure that your *_config.yml* file follows these rules: {% data reusables.pages.yaml-rules %} @@ -56,132 +56,132 @@ versions: ### Date is not a valid datetime -このエラーは、サイトのいずれかのページに無効な日付データが含まれていることを意味します。 +This error means that one of the pages on your site includes an invalid datetime. -トラブルシューティングするには、エラーメッセージで示されたファイルおよびファイルのレイアウトで、日付関連の Liquid フィルタをコールしている箇所を探します。 日付関連の Liquid フィルタに渡される変数に、すべてのケースで値があることと、`nil`または `""` を渡していないことを確認します。 詳細は、Liquid のドキュメンテーションで「[Liquid フィルタ](https://help.shopify.com/en/themes/liquid/filters)」を参照してください。 +To troubleshoot, search the file in the error message and the file's layouts for calls to any date-related Liquid filters. Make sure that any variables passed into date-related Liquid filters have values in all cases and never pass `nil` or `""`. For more information, see "[Liquid filters](https://help.shopify.com/en/themes/liquid/filters)" in the Liquid documentation. ### File does not exist in includes directory -このエラーは、*_includes* ディレクトリに存在していないファイルをコードで参照していることを意味します。 +This error means that your code references a file that doesn't exist in your *_includes* directory. -{% data reusables.pages.search-for-includes %} 参照していたファイルのいずれかが *_includes* ディレクトリに存在しない場合は、そのファイルを *_includes* ディレクトリにコピーまたは移動してください。 +{% data reusables.pages.search-for-includes %} If any of the files you've referenced aren't in the *_includes* directory, copy or move the files into the *_includes* directory. ### File is a symlink -このエラーは、サイトの公開ソースに存在しないシンボリックリンクされたファイルをコードで参照していることを意味します。 +This error means that your code references a symlinked file that does not exist in the publishing source for your site. -{% data reusables.pages.search-for-includes %} 参照していたファイルのいずれかがシンボリックリンクされている場合は、そのファイルを *_includes* ディレクトリにコピーまたは移動してください。 +{% data reusables.pages.search-for-includes %} If any of the files you've referenced are symlinked, copy or move the files into the *_includes* directory. ### File is not properly UTF-8 encoded -このエラーは、`日本語`などアルファベット以外の文字を使用したことを意味します。 +This error means that you used non-Latin characters, like `日本語`, without telling the computer to expect these symbols. -トラブルシューティングするには、*_config.yml* ファイルに次の行を追加して UTF-8 エンコーディングを指定します。 +To troubleshoot, force UTF-8 encoding by adding the following line to your *_config.yml* file: ``` encoding: UTF-8 ``` ### Invalid highlighter language -このエラーは、設定ファイルで [Rouge](https://github.com/jneen/rouge) または [Pygments](http://pygments.org/) 以外の構文ハイライターを指定したことを意味します。 +This error means that you specified any syntax highlighter other than [Rouge](https://github.com/jneen/rouge) or [Pygments](http://pygments.org/) in your configuration file. -トラブルシューティングするには、*_config.yml* ファイルを更新して [Rouge](https://github.com/jneen/rouge) または [Pygments](http://pygments.org/) を指定します。 詳しい情報については、「[{% data variables.product.product_name %} と Jekyll について](/articles/about-github-pages-and-jekyll#syntax-highlighting)」を参照してください。 +To troubleshoot, update your *_config.yml* file to specify [Rouge](https://github.com/jneen/rouge) or [Pygments](http://pygments.org/). For more information, see "[About {% data variables.product.product_name %} and Jekyll](/articles/about-github-pages-and-jekyll#syntax-highlighting)." ### Invalid post date -このエラーメッセージは、サイトでの投稿で、ファイル名または YAML フロントマターに無効な日付が含まれていることを意味します。 +This error means that a post on your site contains an invalid date in the filename or YAML front matter. -トラブルシューティングするには、日付がすべて YYYY-MM-DD HH:MM:SS 形式の UTC 時間で、実際のカレンダー日付であることを確認します。 UTC との時差があるタイムゾーンを指定する場合は、YYYY-MM-DD HH:MM:SS +/-TTTT 形式を使用し、たとえば `2014-04-18 11:30:00 +0800` のように指定します。 +To troubleshoot, make sure all dates are formatted as YYYY-MM-DD HH:MM:SS for UTC and are actual calendar dates. To specify a time zone with an offset from UTC, use the format YYYY-MM-DD HH:MM:SS +/-TTTT, like `2014-04-18 11:30:00 +0800`. -*_config.yml* ファイルで日付形式を指定している場合は、その形式が正しいことを確認してください。 +If you specify a date format in your *_config.yml* file, make sure the format is correct. ### Invalid Sass or SCSS -このエラーは、リポジトリに無効な内容の Sass または SCSS ファイルが含まれていることを意味します。 +This error means your repository contains a Sass or SCSS file with invalid content. -トラブルシューティングするには、エラーメッセージに含まれている行番号を確認して、無効な Sass または SCSS を探します。 今後のエラーを防ぐために、お好みのテキストエディター用の Sass または SCSS 文法チェッカーをインストールします。 +To troubleshoot, review the line number included in the error message for invalid Sass or SCSS. To help prevent future errors, install a Sass or SCSS linter for your favorite text editor. ### Invalid submodule -このエラーは、適切に初期化されていないサブモジュールがリポジトリに含まれていることを意味します。 +This error means that your repository includes a submodule that hasn't been properly initialized. {% data reusables.pages.remove-submodule %} -そのサブモジュールを使用する必要がある場合は、サブモジュールを参照するとき、必ず `https://` (`http://` ではなく) を使用し、そのサブモジュールをパブリックリポジトリに配置してください。 +If do you want to use the submodule, make sure you use `https://` when referencing the submodule (not `http://`) and that the submodule is in a public repository. ### Invalid YAML in data file -このエラーは、*_data* フォルダの 1 つ以上のファイルに無効な YAML が含まれていることを意味します。 +This error means that one of more files in the *_data* folder contains invalid YAML. -トラブルシューティングするには、*_data* フォルダの YAML ファイルが次のルールに従っていることを確認します。 +To troubleshoot, make sure the YAML files in your *_data* folder follow these rules: {% data reusables.pages.yaml-rules %} {% data reusables.pages.yaml-linter %} -Jekyll データファイルの詳細は、Jekyll のドキュメンテーションで「[データファイル](https://jekyllrb.com/docs/datafiles/)」を参照してください。 +For more information about Jekyll data files, see "[Data Files](https://jekyllrb.com/docs/datafiles/)" in the Jekyll documentation. ### Markdown errors -このエラーは、リポジトリ Markdown エラーがあることを意味します。 +This error means that your repository contains Markdown errors. -トラブルシューティングするには、必ずサポートされている Markdown プロセッサを使用するようにします。 詳細は、「[Jekyll を使用して、{% data variables.product.prodname_pages %} サイトの Markdown プロセッサを設定する](/articles/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll)」を参照してください。 +To troubleshoot, make sure you are using a supported Markdown processor. For more information, see "[Setting a Markdown processor for your {% data variables.product.prodname_pages %} site using Jekyll](/articles/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll)." -次に、エラーメッセージで示されているファイルが有効な Markdown 構文を使っていることを確認します。 詳細は、Daring Fireball の「[Markdown: 構文](https://daringfireball.net/projects/markdown/syntax)」を参照してください。 +Then, make sure the file in the error message uses valid Markdown syntax. For more information, see "[Markdown: Syntax](https://daringfireball.net/projects/markdown/syntax)" on Daring Fireball. ### Missing docs folder This error means that you have chosen the `docs` folder on a branch as your publishing source, but there is no `docs` folder in the root of your repository on that branch. -To troubleshoot, if your `docs` folder was accidentally moved, try moving the `docs` folder back to the root of your repository on the branch you chose for your publishing source. `docs` フォルダを誤って削除した場合は、次のいずれかの方法が可能です。 -- Git を使用して削除を revert する、つまり取り消す。 詳細は、Git のドキュメンテーションで「[git-revert](https://git-scm.com/docs/git-revert.html)」を参照してください。 -- Create a new `docs` folder in the root of your repository on the branch you chose for your publishing source and add your site's source files to the folder. 詳細は「[新しいファイルを作成する](/articles/creating-new-files)」を参照してください。 -- 公開ソースを変更する。 詳細は「[{% data variables.product.prodname_pages %} の公開ソースを設定する](/articles/configuring-a-publishing-source-for-github-pages)」を参照してください。 +To troubleshoot, if your `docs` folder was accidentally moved, try moving the `docs` folder back to the root of your repository on the branch you chose for your publishing source. If the `docs` folder was accidentally deleted, you can either: +- Use Git to revert or undo the deletion. For more information, see "[git-revert](https://git-scm.com/docs/git-revert.html)" in the Git documentation. +- Create a new `docs` folder in the root of your repository on the branch you chose for your publishing source and add your site's source files to the folder. For more information, see "[Creating new files](/articles/creating-new-files)." +- Change your publishing source. For more information, see "[Configuring a publishing source for {% data variables.product.prodname_pages %}](/articles/configuring-a-publishing-source-for-github-pages)." ### Missing submodule -このエラーは、存在しない、または適切に初期化されていないサブモジュールがリポジトリに含まれていることを意味します。 +This error means that your repository includes a submodule that doesn't exist or hasn't been properly initialized. {% data reusables.pages.remove-submodule %} -サブモジュールを使用する必要がある場合は、そのサブモジュールを初期化します。 詳細は、_Pro Git_ ブックで「[Git Tools - Submodules](https://git-scm.com/book/en/v2/Git-Tools-Submodules)」を参照してください。 +If you do want to use a submodule, initialize the submodule. For more information, see "[Git Tools - Submodules](https://git-scm.com/book/en/v2/Git-Tools-Submodules)" in the _Pro Git_ book. ### Relative permalinks configured -このエラーは、*_config.yml* ファイルで相対パーマリンクを使用していることを意味します。相対パーマリンクは {% data variables.product.prodname_pages %} でサポートされていません。 +This errors means that you have relative permalinks, which are not supported by {% data variables.product.prodname_pages %}, in your *_config.yml* file. -パーマリンクとは、サイトの特定ページを参照している恒久的な URL です。 絶対パーマリンクはサイトのルートから始まり、相対パーマリンクは参照先ページを含むフォルダで始まります。 {% data variables.product.prodname_pages %} と Jekyll では、相対パーマリンクがサポートされなくなっています。 詳細は、Jekyll のドキュメンテーションで「[パーマリンク](https://jekyllrb.com/docs/permalinks/)」を参照してください。 +Permalinks are permanent URLs that reference a particular page on your site. Absolute permalinks begin with the root of the site, while relative permalinks begin with the folder containing the referenced page. {% data variables.product.prodname_pages %} and Jekyll no longer support relative permalinks. For more information about permalinks, see "[Permalinks](https://jekyllrb.com/docs/permalinks/)" in the Jekyll documentation. -トラブルシューティングするには、*_config.yml* ファイルから `relative_permalinks` の行を削除し、サイトに相対パーマリンクがある場合は絶対パーマリンクに直します。 詳細は「[リポジトリのファイルを編集する](/articles/editing-files-in-your-repository)」を参照してください。 +To troubleshoot, remove the `relative_permalinks` line from your *_config.yml* file and reformat any relative permalinks in your site with absolute permalinks. For more information, see "[Editing files in your repository](/articles/editing-files-in-your-repository)." ### Symlink does not exist within your site's repository -このエラーは、サイトの公開ソースに存在しないシンボリックリンク (symlink) がサイトに含まれていることを意味します。 シンボリックリンクの詳細は、Wikipedia で「[Symbolic link](https://en.wikipedia.org/wiki/Symbolic_link)」を参照してください。 +This error means that your site includes a symbolic link (symlink) that does not exist in the publishing source for your site. For more information about symlinks, see "[Symbolic link](https://en.wikipedia.org/wiki/Symbolic_link)" on Wikipedia. -トラブルシューティングするには、エラーメッセージで示されているファイルがサイトのビルドに使われているかどうかを確認します。 使われていない場合、またはファイルをシンボリックリンクにしたくない場合は、ファイルを削除します。 サイトのビルドにシンボリックファイルが必要な場合は、そのシンボリックリンクで参照されているファイルまたはディレクトリが、サイトの公開ソースにあることを確認してください。 外部アセットを除外するには、{% if currentVersion == "free-pro-team@latest" %}`git submodule` または{% endif %}サードパーティのパッケージマネージャー、たとえば [Bower](https://bower.io/) などの使用を検討します。{% if currentVersion == "free-pro-team@latest" %}詳細は「[{% data variables.product.prodname_pages %} でサブモジュールを使う ](/articles/using-submodules-with-github-pages)」を参照してください。{% endif %} +To troubleshoot, determine if the file in the error message is used to build your site. If not, or if you don't want the file to be a symlink, delete the file. If the symlinked file is necessary to build your site, make sure the file or directory the symlink references is in the publishing source for your site. To include external assets, consider using {% if currentVersion == "free-pro-team@latest" %}`git submodule` or {% endif %}a third-party package manager such as [Bower](https://bower.io/).{% if currentVersion == "free-pro-team@latest" %} For more information, see "[Using submodules with {% data variables.product.prodname_pages %}](/articles/using-submodules-with-github-pages)."{% endif %} ### Syntax error in 'for' loop -このエラーは、 Liquid の `for` ループ宣言で無効な構文が含まれていることを意味します。 +This error means that your code includes invalid syntax in a Liquid `for` loop declaration. -トラブルシューティングするには、エラーメッセージで示されているファイルですべての `for` ループの構文が正しいことを確認します。 `for` ループの正しい構文についての詳しい情報は、Liquid のドキュメンテーションで「[反復タグ](https://help.shopify.com/en/themes/liquid/tags/iteration-tags#for)」を参照してください。 +To troubleshoot, make sure all `for` loops in the file in the error message have proper syntax. For more information about proper syntax for `for` loops, see "[Iteration tags](https://help.shopify.com/en/themes/liquid/tags/iteration-tags#for)" in the Liquid documentation. ### Tag not properly closed -このエラーメッセージは、コードに含まれる論理タグが正しく閉じていないことを意味します。 たとえば、{% raw %}`{% capture example_variable %}` は `{% endcapture %}`{% endraw %} で閉じる必要があります。 +This error message means that your code includes a logic tag that is not properly closed. For example, {% raw %}`{% capture example_variable %}` must be closed by `{% endcapture %}`{% endraw %}. -トラブルシューティングするには、エラーメッセージで示されているファイルの論理タグがすべて適切に閉じられていることを確認します。 詳細は、Liquid のドキュメンテーションで「[Liquid タグ](https://help.shopify.com/en/themes/liquid/tags)」を参照してください。 +To troubleshoot, make sure all logic tags in the file in the error message are properly closed. For more information, see "[Liquid tags](https://help.shopify.com/en/themes/liquid/tags)" in the Liquid documentation. ### Tag not properly terminated -このエラーは、正しく閉じられていない出力タグがコードに含まれていることを意味します。 たとえば、{% raw %}`{{ page.title }}`{% endraw %} となるはずが {% raw %}`{{ page.title }`{% endraw %} となっているような場合です。 +This error means that your code includes an output tag that is not properly terminated. For example, {% raw %}`{{ page.title }` instead of `{{ page.title }}`{% endraw %}. -トラブルシューティングするには、エラーメッセージで示されているファイルの出力タグがすべて `}}` で適切に閉じられていることを確認します。 詳細は、Liquid のドキュメンテーションで「[Liquid オブジェクト](https://help.shopify.com/en/themes/liquid/objects)」を参照してください。 +To troubleshoot, make sure all output tags in the file in the error message are terminated with `}}`. For more information, see "[Liquid objects](https://help.shopify.com/en/themes/liquid/objects)" in the Liquid documentation. ### Unknown tag error -このエラーは、コードに認識されない Liquid タグが含まれていることを意味します。 +This error means that your code contains an unrecognized Liquid tag. -トラブルシューティングするには、エラーメッセージで示されているファイルの Liquid タグがすべて Jekyll のデフォルトの変数に一致し、タグ名に誤入力がないことを確認します。 デフォルトの変数のリストは、Jekyll のドキュメンテーションで「[変数](https://jekyllrb.com/docs/variables/)」を参照してください。 +To troubleshoot, make sure all Liquid tags in the file in the error message match Jekyll's default variables and there are no typos in the tag names. For a list of default varibles, see "[Variables](https://jekyllrb.com/docs/variables/)" in the Jekyll documentation. -認識されないタグの主な原因は、サポート対象外のプラグインです。 サイトをローカルで生成し、静的なファイルを {% data variables.product.product_name %} にプッシュすることで、サポート対象外のプラグインを使用している場合は、そのプラグインで Jekyll のデフォルトの変数と異なるタグが使われていないかどうか確認してください。 サポート対象のプラグインについては、「[{% data variables.product.prodname_pages %} と Jekyll について](/articles/about-github-pages-and-jekyll#plugins)」を参照してください。 +Unsupported plugins are a common source of unrecognized tags. If you use an unsupported plugin in your site by generating your site locally and pushing your static files to {% data variables.product.product_name %}, make sure the plugin is not introducing tags that are not in Jekyll's default variables. For a list of supported plugins, see "[About {% data variables.product.prodname_pages %} and Jekyll](/articles/about-github-pages-and-jekyll#plugins)." diff --git a/translations/ja-JP/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md b/translations/ja-JP/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md index f912601707e8..5f4a113a2ec4 100644 --- a/translations/ja-JP/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md +++ b/translations/ja-JP/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md @@ -1,6 +1,6 @@ --- title: GitHub Pages サイトを取り下げる -intro: 'サイトを{% if currentVersion == "free-pro-team@latest" %}パブリックに{% else %}{% data variables.product.product_location %} を使用する誰にも{% endif %} 使用できないように、{% data variables.product.prodname_pages %} サイトを取り下げることができます。' +intro: 'You can unpublish your {% data variables.product.prodname_pages %} site so that the site is no longer available to {% if currentVersion == "free-pro-team@latest" %}the public{% else %}everyone using {% data variables.product.product_location %}{% endif %}.' redirect_from: - /articles/how-do-i-unpublish-a-project-page/ - /articles/unpublishing-a-project-page/ @@ -19,9 +19,11 @@ versions: {% data reusables.repositories.navigate-to-repo %} 2. リポジトリに `gh-pages` ブランチが存在する場合は、`gh-pages` ブランチを削除します。 詳しい情報については[リポジトリ内でのブランチの作成と削除](/articles/creating-and-deleting-branches-within-your-repository#deleting-a-branch)を参照してください。 3. `gh-pages` ブランチが公開ソースだった場合、 -{% if currentVersion == "free-pro-team@latest" %}ステップ 6 までスキップしてください{% else %}サイトが取り下げられ、残りのステップはスキップできます{% endif %}。 +{% if currentVersion == "free-pro-team@latest" %}skip to step 6{% else %}your site is now unpublished and you can skip the remaining steps{% endif %}. {% data reusables.repositories.sidebar-settings %} -5. {% data variables.product.prodname_pages %} で、[**Source**] ドロップダウンメニューを使用して [**None**] を選択します。 ![公開元を選択するドロップダウンメニュー](/assets/images/help/pages/publishing-source-drop-down.png) +5. Under " +{% data variables.product.prodname_pages %}", use the **Source** drop-down menu and select **None.** + ![公開元を選択するドロップダウンメニュー](/assets/images/help/pages/publishing-source-drop-down.png) {% data reusables.pages.update_your_dns_settings %} ### ユーザまたは Organization サイトを取り下げる diff --git a/translations/ja-JP/content/github/working-with-github-support/about-github-support.md b/translations/ja-JP/content/github/working-with-github-support/about-github-support.md index 978319a27644..1e403fae9a02 100644 --- a/translations/ja-JP/content/github/working-with-github-support/about-github-support.md +++ b/translations/ja-JP/content/github/working-with-github-support/about-github-support.md @@ -11,13 +11,13 @@ versions: サポートのオプションは、お使いの{% data variables.product.prodname_dotcom_the_website %}の製品によって異なります。 有料の製品を使っている場合は、英語で{% data variables.contact.github_support %}に連絡できます。 アカウントには{% data variables.contact.premium_support %}が含まれていることもあります。 -| | {% data variables.product.prodname_gcf %} | Standard Support | Premium Support | -| ------------------------------------------------------ | ---------------------------------------------- | ---------------- | --------------- | -| {% data variables.product.prodname_free_user %} | X | | | -| {% data variables.product.prodname_pro %} | X | X | | -| {% data variables.product.prodname_team %} | X | X | | -| {% data variables.product.prodname_ghe_cloud %} | X | X | X | -| {% data variables.product.prodname_ghe_server %} | X | X | X | +| | {% data variables.product.prodname_gcf %} | Standard Support | Premium Support | +| -------------------------------------------------- | ----------------------------------------- | ---------------- | --------------- | +| {% data variables.product.prodname_free_user %} | X | | | +| {% data variables.product.prodname_pro %} | X | X | | +| {% data variables.product.prodname_team %} | X | X | | +| {% data variables.product.prodname_ghe_cloud %} | X | X | X | +| {% data variables.product.prodname_ghe_server %} | X | X | X | {% data variables.product.prodname_dotcom %}上のサービスに影響するインシデントが発生しているかの確認、あるいは将来のステータスの更新の通知をサブスクライブして受信するためには、{% data variables.product.prodname_dotcom %}の[ステータスページ](https://www.githubstatus.com/)にアクセスしてください。 diff --git a/translations/ja-JP/content/github/working-with-github-support/github-marketplace-support.md b/translations/ja-JP/content/github/working-with-github-support/github-marketplace-support.md index 7fa6e6d0c7d3..06b5ab3ef628 100644 --- a/translations/ja-JP/content/github/working-with-github-support/github-marketplace-support.md +++ b/translations/ja-JP/content/github/working-with-github-support/github-marketplace-support.md @@ -21,4 +21,4 @@ versions: - [{% data variables.product.prodname_marketplace %}について](/articles/about-github-marketplace) - [{% data variables.product.prodname_marketplace %}でのアプリケーションの購入とインストール](/articles/purchasing-and-installing-apps-in-github-marketplace) -- 「[{% data variables.product.prodname_marketplace %} アプリケーションの支払いを管理する](/articles/managing-billing-for-github-marketplace-apps)」 +- [{% data variables.product.prodname_marketplace %} アプリの支払いを管理する](/articles/managing-billing-for-github-marketplace-apps) diff --git a/translations/ja-JP/content/github/writing-on-github/autolinked-references-and-urls.md b/translations/ja-JP/content/github/writing-on-github/autolinked-references-and-urls.md index a4ef7d9070f4..70f53ec10a92 100644 --- a/translations/ja-JP/content/github/writing-on-github/autolinked-references-and-urls.md +++ b/translations/ja-JP/content/github/writing-on-github/autolinked-references-and-urls.md @@ -1,6 +1,6 @@ --- title: 自動リンクされた参照と URL -intro: URL、Issue、プルリクエスト、コミットへの参照は、自動的に短縮されてリンクに変換されます。 +intro: 'URL、Issue、プルリクエスト、コミットへの参照は、自動的に短縮されてリンクに変換されます。' redirect_from: - /articles/autolinked-references-and-urls versions: @@ -45,15 +45,12 @@ versions: | コミット URL | https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | | SHA | a5c3785ed8d6a35868bc169f07e40e889087fd2e | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | | ユーザ@SHA | jlord@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -| ユーザ名/リポジトリ@SHA | User/Repository@SHA: jlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord/sheetsee.js@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | +| ユーザ名/リポジトリ@SHA | jlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord/sheetsee.js@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} ### 外部リソースへのカスタム自動リンク {% data reusables.repositories.autolink-references %} -{% endif %} - ### 参考リンク - [基本的な書き方とフォーマットの構文](/articles/basic-writing-and-formatting-syntax) diff --git a/translations/ja-JP/content/github/writing-on-github/basic-writing-and-formatting-syntax.md b/translations/ja-JP/content/github/writing-on-github/basic-writing-and-formatting-syntax.md index e4432bccbd78..3a319249fc09 100644 --- a/translations/ja-JP/content/github/writing-on-github/basic-writing-and-formatting-syntax.md +++ b/translations/ja-JP/content/github/writing-on-github/basic-writing-and-formatting-syntax.md @@ -170,7 +170,7 @@ git commit ### 人や Team のメンション -{% data variables.product.product_name %}上の人あるいは [Team](/articles/setting-up-teams/) は、`@` に加えてユーザ名もしくは Team 名を入力することでメンションできます。 This will trigger a notification and bring their attention to the conversation. コメントを編集してユーザ名や Team 名をメンションすれば、人々に通知を受信してもらえます。 通知の詳細は、{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}「[通知について](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}「[通知について](/github/receiving-notifications-about-activity-on-github/about-notifications){% endif %}」を参照してください。 +{% data variables.product.product_name %}上の人あるいは [Team](/articles/setting-up-teams/) は、`@` に加えてユーザ名もしくは Team 名を入力することでメンションできます。 This will trigger a notification and bring their attention to the conversation. コメントを編集してユーザ名や Team 名をメンションすれば、人々に通知を受信してもらえます。 For more information about notifications, 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 %}." `@github/support これらのアップデートについてどう思いますか？` @@ -188,20 +188,17 @@ git commit 詳しい情報については[自動リンクされた参照と URL](/articles/autolinked-references-and-urls) を参照してください。 -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} ### 外部リソースの参照 {% data reusables.repositories.autolink-references %} -{% endif %} - ### コンテンツの添付 {% data variables.product.prodname_github_app %} には、登録されたドメインにリンクする URL に対する情報を {% data variables.product.product_name %} 内で提供するものがあります。 {% data variables.product.product_name %} は、アプリケーションが提供した情報を Issue あるいはプルリクエストのボディもしくはコメント中の URL の下に表示します。 ![コンテンツの添付](/assets/images/help/writing/content-attachment.png) -コンテンツの添付を見るには、リポジトリにインストールされた Content Attachments API を使う {% data variables.product.prodname_github_app %} が必要です。{% if currentVersion == "free-pro-team@latest" %}詳細は「[個人アカウントでアプリケーションをインストールする](/articles/installing-an-app-in-your-personal-account)」および「[Organization でアプリケーションをインストールする](/articles/installing-an-app-in-your-organization)」を参照してください。{% endif %} +To see content attachments, you must have a {% data variables.product.prodname_github_app %} that uses the Content Attachments API installed on the repository.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[Installing an app in your personal account](/articles/installing-an-app-in-your-personal-account)" and "[Installing an app in your organization](/articles/installing-an-app-in-your-organization)."{% endif %} コンテンツの添付は、Markdown のリンクの一部になっている URL には表示されません。 diff --git a/translations/ja-JP/content/github/writing-on-github/creating-a-saved-reply.md b/translations/ja-JP/content/github/writing-on-github/creating-a-saved-reply.md index 6c6db4f96662..169d0db5c68c 100644 --- a/translations/ja-JP/content/github/writing-on-github/creating-a-saved-reply.md +++ b/translations/ja-JP/content/github/writing-on-github/creating-a-saved-reply.md @@ -1,6 +1,6 @@ --- title: 返信テンプレートの作成 -intro: 同じコメントを何度も頻繁に追加する場合は、返信テンプレートを作成しておくと便利です。 +intro: '同じコメントを何度も頻繁に追加する場合は、返信テンプレートを作成しておくと便利です。' redirect_from: - /articles/creating-a-saved-reply versions: diff --git a/translations/ja-JP/content/github/writing-on-github/creating-gists.md b/translations/ja-JP/content/github/writing-on-github/creating-gists.md index 9726c534f553..5e8f74f737b6 100644 --- a/translations/ja-JP/content/github/writing-on-github/creating-gists.md +++ b/translations/ja-JP/content/github/writing-on-github/creating-gists.md @@ -1,6 +1,6 @@ --- title: Gist の作成 -intro: 2 種類の Gist、つまりパブリックとシークレットを作成できます。 自分のアイデアを共有する準備ができていればパブリック Gist を、まだの場合はシークレット Gist を作成します。 +intro: '2 種類の Gist、つまりパブリックとシークレットを作成できます。 自分のアイデアを共有する準備ができていればパブリック Gist を、まだの場合はシークレット Gist を作成します。' redirect_from: - /articles/about-gists/ - /articles/cannot-delete-an-anonymous-gist/ @@ -17,7 +17,7 @@ versions: Gist はパブリックまたはプライベートにできます。 パブリックGistは{% data variables.gists.discover_url %}に表示されます。ここでは作成されたばかりの新しいGistをブラウズできます。 それらのGistは検索もできるので、他の人々に自分の作業を探して見てもらうために使うこともできます。 {% data reusables.gist.cannot-convert-public-gists-to-secret %} -シークレット Gist は {% data variables.gists.discover_url %} では表示されず{% if currentVersion != "free-pro-team@latest" %}、{% endif %}検索もできません。 {% data reusables.gist.cannot-convert-public-gists-to-secret %}シークレット Gist は、プライベートではありません。 シークレット Gist の URL を友人に送信すれば、見てもらえるようになります。 ただし、知人ではない誰かがその URL を見つけたなら、その人もその Gist を見ることができます。 好奇心の強い眼から自分のコードを守っておきたいなら、[プライベートリポジトリを作成](/articles/creating-a-new-repository)するとよいでしょう。 +Secret gists don't show up in {% data variables.gists.discover_url %}{% if currentVersion != "free-pro-team@latest" %},{% endif %} and are not searchable. {% data reusables.gist.cannot-convert-public-gists-to-secret %}シークレット Gist は、プライベートではありません。 シークレット Gist の URL を友人に送信すれば、見てもらえるようになります。 ただし、知人ではない誰かがその URL を見つけたなら、その人もその Gist を見ることができます。 好奇心の強い眼から自分のコードを守っておきたいなら、[プライベートリポジトリを作成](/articles/creating-a-new-repository)するとよいでしょう。 {% if currentVersion != "free-pro-team@latest" %} @@ -27,13 +27,10 @@ Gist はパブリックまたはプライベートにできます。 パブリ {% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} - 通知は以下の場合に送られます: - あなたが Gist の作者である場合。 - 誰かがあなたを Gist 中でメンションした場合。 - いずれかの Gist の上部で [** Subscribe**] をクリックして、Gist をサブスクライブした場合。 -{% endif %} You can pin gists to your profile so other people can see them easily. 詳しい情報については、「[プロフィールにアイテムをピン止めする](/articles/pinning-items-to-your-profile)」を参照してください。 diff --git a/translations/ja-JP/content/github/writing-on-github/deleting-a-saved-reply.md b/translations/ja-JP/content/github/writing-on-github/deleting-a-saved-reply.md index 1a0463732e62..bb92e905fdef 100644 --- a/translations/ja-JP/content/github/writing-on-github/deleting-a-saved-reply.md +++ b/translations/ja-JP/content/github/writing-on-github/deleting-a-saved-reply.md @@ -1,6 +1,6 @@ --- title: 返信テンプレートの削除 -intro: 使用しなくなった返信テンプレートは削除できます。 +intro: '使用しなくなった返信テンプレートは削除できます。' redirect_from: - /articles/deleting-a-saved-reply versions: diff --git a/translations/ja-JP/content/github/writing-on-github/forking-and-cloning-gists.md b/translations/ja-JP/content/github/writing-on-github/forking-and-cloning-gists.md index ad421173bfbe..6a49433bc6bf 100644 --- a/translations/ja-JP/content/github/writing-on-github/forking-and-cloning-gists.md +++ b/translations/ja-JP/content/github/writing-on-github/forking-and-cloning-gists.md @@ -1,6 +1,6 @@ --- title: Gistのフォークとクローン -intro: Gists は Git リポジトリです。つまり、オリジナルの作者でなくても Gist をフォークしたりクローンしたりできます。 diff など、Gist の完全なコミット履歴を見ることもできます。 +intro: 'Gists は Git リポジトリです。つまり、オリジナルの作者でなくても Gist をフォークしたりクローンしたりできます。 diff など、Gist の完全なコミット履歴を見ることもできます。' redirect_from: - /articles/forking-and-cloning-gists versions: diff --git a/translations/ja-JP/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github.md b/translations/ja-JP/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github.md index 1f903f637621..6e451662ac87 100644 --- a/translations/ja-JP/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github.md +++ b/translations/ja-JP/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github.md @@ -4,7 +4,7 @@ redirect_from: - /articles/markdown-basics/ - /articles/things-you-can-do-in-a-text-area-on-github/ - /articles/getting-started-with-writing-and-formatting-on-github -intro: GitHub の Issue、プルリクエスト、およびウィキでは、シンプルな機能を使用してコメントをフォーマットしたり他のユーザとやりとりしたりできます。 +intro: 'GitHub の Issue、プルリクエスト、およびウィキでは、シンプルな機能を使用してコメントをフォーマットしたり他のユーザとやりとりしたりできます。' mapTopic: true versions: free-pro-team: '*' diff --git a/translations/ja-JP/content/github/writing-on-github/organizing-information-with-tables.md b/translations/ja-JP/content/github/writing-on-github/organizing-information-with-tables.md index 37c2061bfd63..2897e6eaf098 100644 --- a/translations/ja-JP/content/github/writing-on-github/organizing-information-with-tables.md +++ b/translations/ja-JP/content/github/writing-on-github/organizing-information-with-tables.md @@ -1,6 +1,6 @@ --- title: 情報を表に編成する -intro: 表を作成して、コメント、Issue、プルリクエスト、ウィキの情報を編成できます。 +intro: '表を作成して、コメント、Issue、プルリクエスト、ウィキの情報を編成できます。' redirect_from: - /articles/organizing-information-with-tables versions: diff --git a/translations/ja-JP/content/github/writing-on-github/using-saved-replies.md b/translations/ja-JP/content/github/writing-on-github/using-saved-replies.md index ed5a964a55f5..7cd25c2e69f2 100644 --- a/translations/ja-JP/content/github/writing-on-github/using-saved-replies.md +++ b/translations/ja-JP/content/github/writing-on-github/using-saved-replies.md @@ -1,6 +1,6 @@ --- title: 返信テンプレートを使う -intro: Issue またはプルリクエストにコメントするときは、すでに設定した 返信テンプレートを追加できます。 返信テンプレートをコメント全体にすることも、カスタマイズしたい場合はコンテンツを追加または削除することもできます。 +intro: 'Issue またはプルリクエストにコメントするときは、すでに設定した 返信テンプレートを追加できます。 返信テンプレートをコメント全体にすることも、カスタマイズしたい場合はコンテンツを追加または削除することもできます。' redirect_from: - /articles/using-saved-replies versions: diff --git a/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting.md b/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting.md index 1b46455d932d..0d242316fc5b 100644 --- a/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting.md +++ b/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting.md @@ -1,6 +1,6 @@ --- title: 高度なフォーマットを使用して作業する -intro: テーブルのようなフォーマット、構文の強調表示、および自動リンキングを使用すると、プルリクエスト、Issue、およびコメントに複雑な情報を明確に配置できます。 +intro: 'テーブルのようなフォーマット、構文の強調表示、および自動リンキングを使用すると、プルリクエスト、Issue、およびコメントに複雑な情報を明確に配置できます。' mapTopic: true redirect_from: - /articles/working-with-advanced-formatting diff --git a/translations/ja-JP/content/github/writing-on-github/working-with-saved-replies.md b/translations/ja-JP/content/github/writing-on-github/working-with-saved-replies.md index cf12fa78f904..f6555e2dafed 100644 --- a/translations/ja-JP/content/github/writing-on-github/working-with-saved-replies.md +++ b/translations/ja-JP/content/github/writing-on-github/working-with-saved-replies.md @@ -1,6 +1,6 @@ --- title: 返信テンプレートを使って作業する -intro: 時間を節約し、一貫したメッセージを配信していることを確認するために、返信テンプレートを Issue およびプルリクエストのコメントに追加できます。 +intro: '時間を節約し、一貫したメッセージを配信していることを確認するために、返信テンプレートを Issue およびプルリクエストのコメントに追加できます。' mapTopic: true redirect_from: - /articles/working-with-saved-replies diff --git a/translations/ja-JP/content/graphql/guides/forming-calls-with-graphql.md b/translations/ja-JP/content/graphql/guides/forming-calls-with-graphql.md index fe8d231efbd9..209d8340662b 100644 --- a/translations/ja-JP/content/graphql/guides/forming-calls-with-graphql.md +++ b/translations/ja-JP/content/graphql/guides/forming-calls-with-graphql.md @@ -1,6 +1,6 @@ --- title: GraphQLでの呼び出しの作成 -intro: GraphQL APIの認証方法を学び、クエリとミューテーションの作成と実行方法を学んでください。 +intro: 'GraphQL APIの認証方法を学び、クエリとミューテーションの作成と実行方法を学んでください。' redirect_from: - /v4/guides/forming-calls - /graphql/guides/forming-calls diff --git a/translations/ja-JP/content/graphql/guides/index.md b/translations/ja-JP/content/graphql/guides/index.md index bb3db09582e6..e1926329b92e 100644 --- a/translations/ja-JP/content/graphql/guides/index.md +++ b/translations/ja-JP/content/graphql/guides/index.md @@ -1,6 +1,6 @@ --- title: ガイド -intro: GraphQLの始め方、RESTからGraphQLへの移行、様々なタスクでのGitHub GraphQL APIの利用方法について学んでください。 +intro: 'GraphQLの始め方、RESTからGraphQLへの移行、様々なタスクでのGitHub GraphQL APIの利用方法について学んでください。' redirect_from: - /v4/guides versions: diff --git a/translations/ja-JP/content/graphql/guides/managing-enterprise-accounts.md b/translations/ja-JP/content/graphql/guides/managing-enterprise-accounts.md index d13ed16fcadc..6664a9983922 100644 --- a/translations/ja-JP/content/graphql/guides/managing-enterprise-accounts.md +++ b/translations/ja-JP/content/graphql/guides/managing-enterprise-accounts.md @@ -5,7 +5,7 @@ redirect_from: - /v4/guides/managing-enterprise-accounts versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- ### GraphQLでのEnterpriseアカウントの管理について @@ -23,7 +23,7 @@ Audit Log APIでは、誰かが以下のようなことをするのをモニタ - ユーザを管理者に昇格。 - GitHub Appの権限の変更。 -Audit Log APIを使えば、Audit logのデータのコピーを保持できます。 Audit Log APIで発行するクエリについては、GraphQLのレスポンスには最大で90から120日分のデータが含まれることがあります。 Audit Log APIで利用できるフィールドのリストについては、「[ AuditEntryインターフェース](/v4/interface/auditentry/)」を参照してください。 +Audit Log APIを使えば、Audit logのデータのコピーを保持できます。 Audit Log APIで発行するクエリについては、GraphQLのレスポンスには最大で90から120日分のデータが含まれることがあります。 Audit Log APIで利用できるフィールドのリストについては、「[ AuditEntryインターフェース](/graphql/reference/interfaces#auditentry/)」を参照してください。 Enterprise APIを利用すると、以下のことができます。 - Enterpriseアカウントに属するすべてのOrganizationとリポジトリの取得と確認。 diff --git a/translations/ja-JP/content/graphql/overview/changelog.md b/translations/ja-JP/content/graphql/overview/changelog.md index 9e98538a4dbc..35fae2cd6f81 100644 --- a/translations/ja-JP/content/graphql/overview/changelog.md +++ b/translations/ja-JP/content/graphql/overview/changelog.md @@ -1,6 +1,6 @@ --- title: 変更履歴 -intro: GraphQLスキーマの変更履歴は、GraphQL APIスキーマに対する最近及び今後の変更のリストです。 これは後方互換性のある変更、スキーマプレビュー、今後の破壊的変更が含まれます。 +intro: 'GraphQLスキーマの変更履歴は、GraphQL APIスキーマに対する最近及び今後の変更のリストです。 これは後方互換性のある変更、スキーマプレビュー、今後の破壊的変更が含まれます。' redirect_from: - /v4/changelog versions: diff --git a/translations/ja-JP/content/index.md b/translations/ja-JP/content/index.md index ba08555d75a9..1800e3661d03 100644 --- a/translations/ja-JP/content/index.md +++ b/translations/ja-JP/content/index.md @@ -1,5 +1,5 @@ --- -title: '{% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %}.com{% endif %} ヘルプドキュメント' +title: '{% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %}.com{% endif %} Help Documentation' gettingStartedLinks: - /github/getting-started-with-github/set-up-git - /github/authenticating-to-github/connecting-to-github-with-ssh @@ -11,8 +11,6 @@ popularLinks: - /github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line - /github/using-git/managing-remote-repositories - /github/working-with-github-pages -versions: - free-pro-team: '*' - enterprise-server: '*' +versions: '*' --- diff --git a/translations/ja-JP/content/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights.md b/translations/ja-JP/content/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights.md index 6f3a015d01b2..c8e5b7f5c154 100644 --- a/translations/ja-JP/content/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights.md +++ b/translations/ja-JP/content/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights.md @@ -4,7 +4,7 @@ intro: '' product: '{% data reusables.gated-features.github-insights %}' permissions: '{% data variables.product.prodname_insights %}にアクセスできる人は、{% data variables.product.prodname_enterprise %}と{% data variables.product.prodname_insights %}の間を行き来できます。' versions: - enterprise-server: '>=2.19' + enterprise-server: '*' --- {% data variables.product.prodname_enterprise %}と{% data variables.product.prodname_insights %}間を行き来できるようになる前に、サイト管理者は{% data variables.product.prodname_insights %}と{% data variables.product.prodname_enterprise %}の間のリンクを有効化しなければなりません。 詳しい情報については「[{% data variables.product.prodname_insights %}と{% data variables.product.prodname_enterprise %}間のリンクの有効化](/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise)」を参照してください。 diff --git a/translations/ja-JP/content/insights/installing-and-configuring-github-insights/about-github-insights.md b/translations/ja-JP/content/insights/installing-and-configuring-github-insights/about-github-insights.md index d215d339856e..bf6396056101 100644 --- a/translations/ja-JP/content/insights/installing-and-configuring-github-insights/about-github-insights.md +++ b/translations/ja-JP/content/insights/installing-and-configuring-github-insights/about-github-insights.md @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -### {% data variables.product.prodname_insights %}について +### {% data variables.product.prodname_insights %} について {% data variables.product.prodname_insights %}は、{% data variables.product.product_location %}からのデータに基づく分析レポートを提供するスタンドアローンアプリケーションで、ソフトウェアデリバリのプロセスを理解し、改善する手助けをします。 これらのメトリクスは、プロセス中のボトルネックの除去、コラボレーションの改善、プロジェクトのデリバリを高品質で高速に行うために利用できます。 @@ -20,7 +20,7 @@ versions: ### サポートへの連絡 -{% data variables.contact.github_support %}から{% data variables.product.prodname_insights %}に関するサポートを受けることができます。 詳しい情報については{% if currentVersion == "free-pro-team@latest" %}「[チケットのサブミット](/github/working-with-github-support/submitting-a-ticket)」{% else %}「[{% data variables.contact.github_support %}への連絡](/enterprise/{{ currentVersion }}/admin/enterprise-support/reaching-github-support)」{% endif %}を参照してください。 +{% data variables.contact.github_support %}から{% data variables.product.prodname_insights %}に関するサポートを受けることができます。 For more information, see {% if currentVersion == "free-pro-team@latest" %}"[Submitting a ticket](/github/working-with-github-support/submitting-a-ticket)."{% else %}"[Reaching {% data variables.contact.github_support %}](/enterprise/{{ currentVersion }}/admin/enterprise-support/reaching-github-support)."{% endif %} ### 参考リンク diff --git a/translations/ja-JP/content/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise.md b/translations/ja-JP/content/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise.md index bcf648d5e2e2..095181bb5a45 100644 --- a/translations/ja-JP/content/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise.md +++ b/translations/ja-JP/content/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise.md @@ -7,7 +7,7 @@ redirect_from: - /github/installing-and-configuring-github-insights/navigating-between-github-insights-and-github-enterprise - /github/installing-and-configuring-github-insights/navigating-between-github-insights-and-github-enterprise versions: - enterprise-server: '>=2.19' + enterprise-server: '*' --- リンクを有効化した後、それぞれのユーザは{% data variables.product.prodname_ghe_server %}から{% data variables.product.prodname_insights %}へ直接アクセスできます。 詳しい情報については「[{% data variables.product.prodname_enterprise %}と{% data variables.product.prodname_insights %}間のアクセス](/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights)」を参照してください。 @@ -17,7 +17,8 @@ versions: ``` ghe-config 'app.github.insights-available' 'true' && ghe-config-apply ``` -3. {% data variables.product.prodname_ghe_server %}に戻ります。 +3. Return to +{% data variables.product.prodname_ghe_server %}. {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.settings-tab %} diff --git a/translations/ja-JP/content/insights/installing-and-configuring-github-insights/installing-github-insights.md b/translations/ja-JP/content/insights/installing-and-configuring-github-insights/installing-github-insights.md index 1fe5dac8dbde..b5479f507b89 100644 --- a/translations/ja-JP/content/insights/installing-and-configuring-github-insights/installing-github-insights.md +++ b/translations/ja-JP/content/insights/installing-and-configuring-github-insights/installing-github-insights.md @@ -28,7 +28,8 @@ versions: {% data variables.product.prodname_insights %}を{% data variables.product.prodname_enterprise %}に接続するには、{% data variables.product.prodname_enterprise %}上のOrganization内に{% data variables.product.prodname_github_app %}を作成しなければなりません。 インテグレーションが動作すると、{% data variables.product.prodname_enterprise %}上にアプリケーションのスラッグバージョンの名前が表示されます。 {% data reusables.enterprise_site_admin_settings.sign-in %} -2. {% data variables.product.prodname_insights %}に接続したいOrganizationにアクセスしてください。 +2. Navigate to the organization you'd like to connect to +{% data variables.product.prodname_insights %}. {% data reusables.organizations.org_settings %} {% data reusables.organizations.github-apps-settings-sidebar %} 5. **New {% data variables.product.prodname_github_app %}（新規{% data variables.product.prodname_github_app %}）**をクリックしてください。 ![新規GitHub Appボタン](/assets/images/help/apps/github_apps_new.png) diff --git a/translations/ja-JP/content/insights/installing-and-configuring-github-insights/managing-permissions-in-github-insights.md b/translations/ja-JP/content/insights/installing-and-configuring-github-insights/managing-permissions-in-github-insights.md index 66c31e20edf2..d0842dc39bcc 100644 --- a/translations/ja-JP/content/insights/installing-and-configuring-github-insights/managing-permissions-in-github-insights.md +++ b/translations/ja-JP/content/insights/installing-and-configuring-github-insights/managing-permissions-in-github-insights.md @@ -9,6 +9,6 @@ versions: {% data reusables.github-insights.permissions-levels %} -{% data variables.product.prodname_enterprise %}のサイト管理者ではない人に管理権限を与えたい場合は、{% data variables.contact.github_support %}に連絡してください。 詳しい情報については{% if currentVersion == "free-pro-team@latest" %}「[チケットのサブミット](/github/working-with-github-support/submitting-a-ticket)」{% else %}「[{% data variables.contact.github_support %}への連絡](/enterprise/{{ currentVersion }}/admin/enterprise-support/reaching-github-support)」{% endif %}を参照してください。 +{% data variables.product.prodname_enterprise %}のサイト管理者ではない人に管理権限を与えたい場合は、{% data variables.contact.github_support %}に連絡してください。 For more information, see {% if currentVersion == "free-pro-team@latest" %}"[Submitting a ticket](/github/working-with-github-support/submitting-a-ticket)."{% else %}"[Reaching {% data variables.contact.github_support %}](/enterprise/{{ currentVersion }}/admin/enterprise-support/reaching-github-support)."{% endif %} {% data variables.product.prodname_insights %}からユーザのアクセス権を削除したい場合は、そのユーザを{% data variables.product.prodname_enterprise %}から削除しなければなりません。 diff --git a/translations/ja-JP/content/packages/getting-started-with-github-container-registry/about-github-container-registry.md b/translations/ja-JP/content/packages/getting-started-with-github-container-registry/about-github-container-registry.md index d22a24720150..82b237ff476d 100644 --- a/translations/ja-JP/content/packages/getting-started-with-github-container-registry/about-github-container-registry.md +++ b/translations/ja-JP/content/packages/getting-started-with-github-container-registry/about-github-container-registry.md @@ -1,6 +1,6 @@ --- -title: About GitHub Container Registry -intro: 'The {% data variables.product.prodname_github_container_registry %} allows you to seamlessly host and manage Docker container images in your organization or personal user account on {% data variables.product.prodname_dotcom %}. {% data variables.product.prodname_github_container_registry %} allows you to configure who can manage and access packages using fine-grained permissions.' +title: GitHub Container Registry について +intro: '{% data variables.product.prodname_github_container_registry %} を利用すると、{% data variables.product.prodname_dotcom %} の Organization または個人ユーザアカウントにシームレスに Docker コンテナイメージをホストして管理できるようになります。 {% data variables.product.prodname_github_container_registry %} を利用すれば、パッケージを管理できるユーザやパッケージにアクセスできるユーザを、きめ細かく設定できます。' product: '{% data reusables.gated-features.packages %}' versions: free-pro-team: '*' @@ -8,35 +8,35 @@ versions: {% note %} -**Note:** {% data variables.product.prodname_github_container_registry %} is currently in public beta and subject to change. Currently, {% data variables.product.prodname_github_container_registry %} only supports Docker image formats. During the beta, storage and bandwidth is free. +**注釈:** {% data variables.product.prodname_github_container_registry %} は現在パブリックベータであり、変更されることがあります。 現在のところ、{% data variables.product.prodname_github_container_registry %} がサポートしているのは Docker イメージフォーマットのみです。 ベータ期間中は、ストレージおよび帯域幅の制限はありません。 {% endnote %} {% data reusables.package_registry.container-registry-feature-highlights %} -To share context about your package's use, you can link a repository to your container image on {% data variables.product.prodname_dotcom %}. For more information, see "[Connecting a repository to a container image](/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image)." +パッケージの使用についてのコンテキストを共有するには、{% data variables.product.prodname_dotcom %} でコンテナイメージをリポジトリにリンクできます。 詳しい情報については、「[リポジトリをコンテナイメージに接続する](/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image)」を参照してください。 ### サポートされているフォーマット -The {% data variables.product.prodname_container_registry %} currently only supports Docker images. +{% data variables.product.prodname_container_registry %} は、現在のところ Docker イメージのみをサポートしています。 -### Visibility and access permissions for container images +### コンテナイメージの可視性とアクセス権限 -If you have admin permissions to a container image, you can set the container image to private or public. Public images allow anonymous access and can be pulled without authentication or signing in via the CLI. +コンテナイメージへのアクセス権限がある場合、コンテナイメージをプライべートまたはパブリックに設定できます。 パブリックイメージは匿名でアクセスでき、認証や CLI 経由でサインインすることなくプルできます。 -As an admin, you can also grant access permissions for a container image that are separate from the permissions you've set at the organization and repository levels. +あなたが管理者であれば、Organization レベルおよびリポジトリレベルに設定した権限とは別に、コンテナイメージに対してアクセス権限を付与することもできます。 -For container images published and owned by a user account, you can give any person an access role. For container images published and owned by an organization, you can give any person or team in the organization an access role. +ユーザアカウントが所有し公開しているコンテナイメージには、任意のユーザにアクセスロールを付与できます。 Organization が所有し公開しているコンテナイメージには、Organization 内の任意の Team にアクセスロールを付与できます。 -| Permission role | Access description | -| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | -| Read | Can download package.
    Can read package metadata. | -| Write | Can upload and download this package.
    Can read and write package metadata. | -| Admin | Can upload, download, delete, and manage this package.
    Can read and write package metadata.
    Can grant package permissions. | +| 権限ロール | アクセス権の内容 | +| ----- | ---------------------------------------------------------------------------------------------------- | +| Read | パッケージをダウンロードできます。
    メタデータの読み取りができます。 | +| Write | このパッケージをアップロードおよびダウンロードできます。
    パッケージのメタデータの読み取りおよび書き込みができます。 | +| Admin | このパッケージのアップロード、ダウンロード、削除、管理ができます。
    パッケージのメタデータの読み取りおよび書き込みができます。
    パッケージに権限を付与できます。 | -For more information, see "[Configuring access control and visibility for container images](/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images)." +詳しい情報については、「[コンテナイメージにアクセス制御と可視性を設定する](/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images)」を参照してください。 ### {% data variables.product.prodname_github_container_registry %}の支払いについて @@ -44,10 +44,10 @@ For more information, see "[Configuring access control and visibility for contai ### サポートへの連絡 -If you have feedback or feature requests for {% data variables.product.prodname_github_container_registry %}, use the [feedback form](https://support.github.com/contact/feedback?contact%5Bcategory%5D=packages). +{% data variables.product.prodname_github_container_registry %} に関するフィードバックや機能のリクエストがある場合は、[フィードバックフォーム](https://support.github.com/contact/feedback?contact%5Bcategory%5D=packages)でご連絡ください。 [連絡フォーム](https://support.github.com/contact?form%5Bsubject%5D=Re:%20GitHub%20Packages)を使い、{% data variables.product.prodname_github_container_registry %}について{% data variables.contact.github_support %}に連絡してください。 * ドキュメンテーションに反する何らかの体験をした時. * 漠然とした、あるいは不明確なエラーを体験した時. -* Your published package contains sensitive data, such as GDPR violations, API Keys, or personally-identifying information. +* GDPR 違反、API キー、個人を識別できる情報といったセンシティブなデータを含むパッケージを公開した時。 diff --git a/translations/ja-JP/content/packages/getting-started-with-github-container-registry/core-concepts-for-github-container-registry.md b/translations/ja-JP/content/packages/getting-started-with-github-container-registry/core-concepts-for-github-container-registry.md index 195e76ed3f2c..5552955262a7 100644 --- a/translations/ja-JP/content/packages/getting-started-with-github-container-registry/core-concepts-for-github-container-registry.md +++ b/translations/ja-JP/content/packages/getting-started-with-github-container-registry/core-concepts-for-github-container-registry.md @@ -1,6 +1,6 @@ --- -title: Core concepts for GitHub Container Registry -intro: 'Below is a list of common {% data variables.product.prodname_github_container_registry %} terms we use across our sites and documentation.' +title: GitHub Container Registry の中核的概念 +intro: '弊社のサイトおよびドキュメンテーションで使用する、一般的な {% data variables.product.prodname_github_container_registry %} 用語を以下に挙げます。' product: '{% data reusables.gated-features.packages %}' versions: free-pro-team: '*' @@ -10,20 +10,20 @@ versions: ### {% data variables.product.prodname_github_container_registry %} -The {% data variables.product.prodname_github_container_registry %} is a registry for containers with support for Docker images. 詳しい情報については「[{% data variables.product.prodname_github_container_registry %}について](/packages/getting-started-with-github-container-registry/about-github-container-registry)」を参照してください。 +{% data variables.product.prodname_github_container_registry %} とは、Docker イメージをサポートする、コンテナのレジストリです。 詳しい情報については「[{% data variables.product.prodname_github_container_registry %}について](/packages/getting-started-with-github-container-registry/about-github-container-registry)」を参照してください。 ### Package -A package is a self-contained and reusable piece of software that includes code and metadata that a developer bundles together in a common place for others to use. A package's metadata may include the version number, name, and the code's dependencies. Packages simplify using and distributing solutions to common problems such as needing frameworks for developing or testing a project, linters to improve code quality, or industry-standard machine learning tools to power your application. Packages exist in many ecosystems. For example, you can package Node.js and Java code or container images. +パッケージは自己完結している再利用可能なソフトウェアで、開発者がコードやメタデータといったものを共通の場所にまとめて、他の人が利用できるようにしたものです。 パッケージのメタデータには、バージョン番号、名前、コードの依存関係を含めることができます。 パッケージは、プロジェクトの開発やテストに必要なフレームワーク、コードの品質を高めるための文法チェッカー、アプリケーションを強化するための業界標準の機械学習ツールといった、一般的な問題に対するソリューションの利用および配布を容易にします。 パッケージは多くのエコシステムで存在します。 たとえば、Node.js と Java のコードやコンテナイメージをパッケージ化できます。 -### Container +### コンテナ -A container is a unit of software designed to reliably deploy software in a standardized way on any platform. A container operates as an isolated virtual environment or instance that can run various software packages and components on the same host kernel as your operating system. Containers use fewer resources than virtual machines because they don't need to include their own virtual hardware to run. Containers are created using a container image file, such as a Dockerfile, and a container client or runtime program. +コンテナとは、あらゆるプラットフォームに標準化された方法でソフトウェアを確実にデプロイするために設計されたソフトウェアのユニットです。 コンテナは、お使いのオペレーティングシステムで、同じホストカーネル上のさまざまなソフトウェアパッケージとコンポーネントを実行できる独立した仮想環境またはインスタンスとして動作します。 コンテナは、実行するために独自の仮想ハードウェアを含める必要がないため、仮想マシンよりも使用するリソースか少なくなります。 コンテナは、Dockerfile などのコンテナイメージと、コンテナクライアントまたはランタイムプログラムを使用して作成されます。 -### Container image +### コンテナイメージ -A container image is a type of package archive that specifies the software requirements to run an app from a container. A container image typically includes the app's code, libraries, and runtime instructions. To ensure that the same image details are used wherever an image is deployed and run, a container image is automatically versioned and cannot be changed once a container image is built in a container. +コンテナイメージとは、コンテナからアプリケーションを実行するためのソフトウェア要件を指定するパッケージアーカイブの一種です。 コンテナイメージには通常、アプリケーションのコード、ライブラリ、およびランタイム命令が含まれます。 どこでイメージがデプロイ、実行されても詳細にわたるまで確実に同じイメージが使用されるようにするため、コンテナイメージは自動的にバージョン管理され、コンテナ内にいったんコンテナイメージが構築されると変更できません。 ### Dockerコンテナ -A Docker container is a type of open source container built on the Docker platform. Docker's original image format has become the OCI (Open Container Initiative) Image Specification. For more information, see the "[Docker documentation](https://docs.docker.com/get-started/overview/)." +Docker コンテナは、Docker プラットフォーム上に構築されたオープンソースコンテナの一種です。 Docker のオリジナルイメージフォーマットは OCI (Open Container Initiative) イメージ仕様となっています。 詳しい情報については、「[Docker のドキュメンテーション](https://docs.docker.com/get-started/overview/)」を参照してください。 diff --git a/translations/ja-JP/content/packages/getting-started-with-github-container-registry/enabling-github-container-registry-for-your-organization.md b/translations/ja-JP/content/packages/getting-started-with-github-container-registry/enabling-github-container-registry-for-your-organization.md index 7a3471c31b9f..a78a29550303 100644 --- a/translations/ja-JP/content/packages/getting-started-with-github-container-registry/enabling-github-container-registry-for-your-organization.md +++ b/translations/ja-JP/content/packages/getting-started-with-github-container-registry/enabling-github-container-registry-for-your-organization.md @@ -1,6 +1,6 @@ --- -title: Enabling GitHub Container Registry for your organization -intro: 'In an organization, organization admins can allow organization members to publish public or private container images to {% data variables.product.prodname_github_container_registry %}.' +title: Organization で GitHub Container Registry を有効化する +intro: 'Organization では、Organization 管理者が Organization メンバーに対して、{% data variables.product.prodname_github_container_registry %} にパブリックまたはプライベートでコンテナイメージを公開することを許可できます。' product: '{% data reusables.gated-features.packages %}' versions: free-pro-team: '*' @@ -8,14 +8,14 @@ versions: {% data reusables.package_registry.container-registry-beta %} -Before organization members can publish container images to {% data variables.product.prodname_github_container_registry %}, an organization admin must enable package creation. +Organization のメンバーがコンテナイメージを {% data variables.product.prodname_github_container_registry %} に公開するには、Organization の管理者がパッケージの作成を有効にする必要があります。 {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.member-privileges %} -5. Under "Package creation", choose whether you want to enable the creation of public or private container images. - - To enable organization members to create a public container image, click **Public**. - - To enable organization members to create a private container image that is only visible to other organization members, click **Private**. You can further customize the visibility of a private container image. For more information, see "[Configuring access control and visibility for container images](/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images)." +5. [Package creation] で、コンテナイメージ作成をパブリックで有効にするか、それともプライベートで有効にするか選択します。 + - Organization のメンバーがパブリックのコンテナイメージを作成できるようにするには、[**Public**] をクリックします。 + - Organization のメンバーに、Organization のメンバーのみが表示できるプライベートコンテナイメージの作成をできるようにするには、[**Private**] をクリックします。 プライベートコンテナイメージの可視性については、さらに細かくカスタマイズできます。 詳しい情報については、「[コンテナイメージにアクセス制御と可視性を設定する](/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images)」を参照してください。 - ![Options to enable public or private packages ](/assets/images/help/package-registry/package-creation-org-settings.png) + ![パブリックまたはプライベートパッケージを有効にするオプション ](/assets/images/help/package-registry/package-creation-org-settings.png) diff --git a/translations/ja-JP/content/packages/getting-started-with-github-container-registry/index.md b/translations/ja-JP/content/packages/getting-started-with-github-container-registry/index.md index 46849f39a609..6ba81af8fed6 100644 --- a/translations/ja-JP/content/packages/getting-started-with-github-container-registry/index.md +++ b/translations/ja-JP/content/packages/getting-started-with-github-container-registry/index.md @@ -1,6 +1,6 @@ --- -title: Getting started with GitHub Container Registry -intro: 'Learn about {% data variables.product.prodname_container_registry %} concepts and how to migrate your Docker images from {% data variables.product.prodname_registry %}.' +title: GitHub Container Registry を使ってみる +intro: '{% data variables.product.prodname_container_registry %} の概念、および Docker イメージを {% data variables.product.prodname_registry %} から移行する方法について学びましょう。' versions: free-pro-team: '*' --- @@ -12,4 +12,4 @@ versions: {% link_in_list /migrating-to-github-container-registry-for-docker-images %} {% link_in_list /enabling-github-container-registry-for-your-organization %} -For more information about configuring, deleting, pushing, or pulling container images, see "[Managing container images with {% data variables.product.prodname_github_container_registry %}](/packages/managing-container-images-with-github-container-registry)." +コンテナイメージの設定、削除、プッシュ、プルに関する詳しい情報については、「[{% data variables.product.prodname_github_container_registry %} でのコンテナイメージ管理](/packages/managing-container-images-with-github-container-registry)」を参照してください。 diff --git a/translations/ja-JP/content/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images.md b/translations/ja-JP/content/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images.md index e2c23bf8ccd7..a7f6c7cb93a3 100644 --- a/translations/ja-JP/content/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images.md +++ b/translations/ja-JP/content/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images.md @@ -1,86 +1,90 @@ --- -title: Migrating to GitHub Container Registry for Docker images -intro: 'If you''ve used the GitHub Packages Docker registry to store Docker images, you can migrate to the new {% data variables.product.prodname_container_registry %}.' +title: Docker イメージを GitHub Container Registry に移行する +intro: 'Docker イメージを保存するため GitHub パッケージ Docker レジストリを使っている場合には、新しい {% data variables.product.prodname_container_registry %} に移行できます。' product: '{% data reusables.gated-features.packages %}' versions: free-pro-team: '*' --- -### Key differences between {% data variables.product.prodname_github_container_registry %} and the Docker package registry +### {% data variables.product.prodname_github_container_registry %} と Docker パッケージレジストリとの主な違い {% data reusables.package_registry.container-registry-beta %} -The {% data variables.product.prodname_github_container_registry %} supersedes the existing Packages Docker registry and is optimized to support some of the unique needs of containers. +{% data variables.product.prodname_github_container_registry %} は既存の Packages Docker レジストリに取って代わるもので、コンテナ固有のニーズのいくつかをサポートできるよう最適化されています。 {% data reusables.package_registry.container-registry-feature-highlights %} 詳しい情報については「[{% data variables.product.prodname_github_container_registry %}について](/packages/getting-started-with-github-container-registry/about-github-container-registry)」を参照してください。 -### Billing changes +### 支払いの変更 {% data reusables.package_registry.billing-for-container-registry %} -### Domain changes +### ドメインの変更 -The domain for the {% data variables.product.prodname_container_registry %} is `ghcr.io`. +{% data variables.product.prodname_container_registry %} のドメインは `ghcr.io` です。 -| Registry | Example URL | -| ---------------------------------------------------------------------- | --------------------------------------------------- | -| {% data variables.product.prodname_registry %} Docker registry | `docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME` | +| レジストリ | Example URL | +| ----------------------------------------------------------------- | --------------------------------------------------- | +| {% data variables.product.prodname_registry %} Docker レジストリ | `docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME` | | {% data variables.product.prodname_github_container_registry %} | `ghcr.io/OWNER/IMAGE_NAME` | -### Authenticating with the container registry +### コンテナレジストリで認証する -You will need to authenticate to the {% data variables.product.prodname_container_registry %} with the base URL `ghcr.io`. We recommend creating a new access token for using the {% data variables.product.prodname_container_registry %}. +{% data variables.product.prodname_container_registry %} は、 ベース URL `ghcr.io` で認証する必要があります。 {% data variables.product.prodname_container_registry %} を使用するために、新しいアクセストークンの作成をお勧めします。 -{% data reusables.package_registry.authenticate-to-container-registry %} +{% data reusables.package_registry.authenticate_with_pat_for_container_registry %} -### Migrating a Docker image using the Docker CLI +{% data reusables.package_registry.authenticate-to-container-registry-steps %} -To move Docker images that you host on {% data variables.product.prodname_registry %} Docker registry, you must republish the images to {% data variables.product.prodname_container_registry %}. We recommend republishing your existing Docker images using the command line on your local machine. +### Docker CLI を使用して Docker イメージを移行する -1. Sign in to the Docker registry using a temporary PAT with at least the `read:packages` scope. This PAT will only be used to sign in to the Docker registry to pull down images and can be deleted afterward. +{% data variables.product.prodname_registry %} Docker レジストリでホストしている Docker イメージを移動するには、イメージを {% data variables.product.prodname_container_registry %} に再公開する必要があります。 既存の Docker イメージを再公開するには、ローカルマシンでコマンドラインを使うことをお勧めします。 + +1. 少なくとも `read:packages` スコープのある一時的な PAT (個人アクセストークン) を使用して、Docker レジストリにサインインします。 この PAT は、Docker レジストリにサインインしてイメージをプルダウンするためにのみ使用され、その後は削除して構いません。 {% raw %} ```shell $ echo $READ_PACKAGES_TOKEN | docker login docker.pkg.github.com -u USERNAME --password-stdin ``` {% endraw %} -2. Pull down the image you'd like to migrate, replacing OWNER with the name of the user or organization account that owns the repository, REPOSITORY with the name of the repository containing your project, IMAGE_NAME with name of the package or image, VERSION with tag for the image you want to install. For example, `docker pull docker.pkg.github.com/octo-org/octoshift/octoshift:latest` pulls the latest tag of the `octoshift/octoshift` image in the octo-org organization. +2. 移行したいイメージをプルダウンします。OWNER はリポジトリを所有しているユーザまたは Organization アカウントの名前に、REPOSITORY はプロジェクトを含むリポジトリの名前に、IMAGE_NAME はパッケージまたはイメージの名前に、VERSION はインストールするイメージのタグにそれぞれ置き換えてください。 たとえば、`docker pull docker.pkg.github.com/octo-org/octoshift/octoshift:latest` は octo-org という Organization の `octoshift/octoshift` イメージの、最新のタグをプルします。 ```shell $ docker pull docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME:VERSION ``` -3. Re-tag the image with the new domain and a new image name. 詳しい情報については、Dockerのドキュメンテーションの「[Docker tag](https://docs.docker.com/engine/reference/commandline/tag/)」を参照してください。 Use the same URL that you used in the previous step for the SOURCE URL. Replace the TARGET_OWNER with the user or organization that you are migrating the container image to and replace the TARGET_IMAGE_NAME with the new {% data variables.product.prodname_container_registry %} image name. +3. 新しいドメインと新しいイメージ名でイメージにタグ付けし直します。 詳しい情報については、Dockerのドキュメンテーションの「[Docker tag](https://docs.docker.com/engine/reference/commandline/tag/)」を参照してください。 先ほどのステップで用いた URL と同じものを SOURCE URL とします。 TARGET_OWNER はコンテナイメージをの移行先であるユーザまたは Organization に、TARGET_IMAGE_NAME は新しい {% data variables.product.prodname_container_registry %} イメージ名に置き換えます。 ```shell $ docker tag docker.pkg.github.com/SOURCE_OWNER/SOURCE_REPOSITORY/SOURCE_IMAGE_NAME:VERSION ghcr.io/TARGET_OWNER/TARGET_IMAGE_NAME:VERSION ``` -4. Sign in to the new {% data variables.product.prodname_container_registry %}. We recommend creating a new PAT limited to the `read:packages` and `write:packages` scopes since you no longer need the `repo` scope and your previous PAT may not have the `write:packages` scope. +4. 新しい + +{% data variables.product.prodname_container_registry %}. `read:packages` スコープと `write:packages` スコープに限定した新しい PAT の作成をお勧めします。`repo` スコープはもはや不要であり、以前の PAT は `write:packages` スコープを持っていない場合があるからです。 {% raw %} ```shell $ echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin ``` {% endraw %} -5. Push your re-tagged image to the {% data variables.product.prodname_container_registry %}. +5. タグ付けし直したイメージを {% data variables.product.prodname_container_registry %} にプッシュします。 ```shell $ docker push ghcr.io/OWNER/IMAGE_NAME:VERSION ``` -### Updating your {% data variables.product.prodname_actions %} workflow +### {% data variables.product.prodname_actions %} ワークフローを更新する -If you have a {% data variables.product.prodname_actions %} workflow that uses a Docker image from the {% data variables.product.prodname_registry %} Docker registry, you may want to update your workflow to the {% data variables.product.prodname_container_registry %} to allow for anonymous access for public container images, finer-grain access permissions, and better storage and bandwidth compatibility for containers. +{% data variables.product.prodname_registry %} Docker レジストリから Docker イメージを使用する {% data variables.product.prodname_actions %} ワークフローがある場合、ワークフローを {% data variables.product.prodname_container_registry %} に更新するといいでしょう。そうすればパブリックコンテナのイメージへの匿名アクセスが可能になり、きめ細かいアクセス権限を設定でき、コンテナに対するストレージと帯域幅が向上します。 -1. Migrate your Docker images to the new {% data variables.product.prodname_container_registry %} at `ghcr.io`. For an example, see "[Migrating a Docker image using the Docker CLI](#migrating-a-docker-image-using-the-docker-cli)." +1. `ghcr.io` にある新しい {% data variables.product.prodname_container_registry %} に Docker イメージを移行します。 例については、「[Docker CLI を使用して Docker イメージを移行する](#migrating-a-docker-image-using-the-docker-cli)」を参照してください。 -2. In your {% data variables.product.prodname_actions %} workflow file, update the package url from `https://docker.pkg.github.com` to `ghcr.io`. +2. {% data variables.product.prodname_actions %} ワークフローファイルで、パッケージ URL を `https://docker.pkg.github.com` から `ghcr.io` に更新します。 -3. Add your new {% data variables.product.prodname_container_registry %} authentication personal access token (PAT) as a GitHub ACtions secret. {% data variables.product.prodname_github_container_registry %} does not support using `GITHUB_TOKEN` for your PAT so you must use a different custom variable, such as `CR_PAT`. 詳しい情報については「[暗号化されたシークレットの作成と保存](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)」を参照してください。 +3. 新しい {% data variables.product.prodname_container_registry %} 認証個人アクセストークン (PAT) を GitHub Actions シークレットとして追加します。 {% data variables.product.prodname_github_container_registry %} は PAT において `GITHUB_TOKEN` の使用をサポートしていないので、`CR_PAT` などの別のカスタム変数を使用する必要があります。 詳しい情報については「[暗号化されたシークレットの作成と保存](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)」を参照してください。 -4. In your {% data variables.product.prodname_actions %} workflow file, update the authentication PAT by replacing your Docker registry PAT ({% raw %}`${{ secrets.GITHUB_TOKEN }}`{% endraw %}) with a new variable for your {% data variables.product.prodname_container_registry %} PAT, such as {% raw %}`${{ secrets.CR_PAT }}`{% endraw %}. +4. {% data variables.product.prodname_actions %} ワークフローファイルにおいて、Docker レジストリ PAT ({% raw %}`${{ secrets.GITHUB_TOKEN }}`{% endraw %} をコンテナレジストリ {% data variables.product.prodname_container_registry %} PAT の新しい変数 (たとえば {% raw %}`${{ secrets.CR_PAT }}`{% endraw %}) に置き換えて、認証 PAT を更新します。 -#### Example of updated workflow +#### 更新したワークフローの例 -If part of your workflow accessed a Docker image hosted by the Docker registry like this: +ワークフローの一部が Docker レジストリにホストされた Docker イメージにアクセスした場合は、次のようになります。 {% raw %} ```yaml @@ -91,7 +95,7 @@ docker push docker.pkg.github.com/github/octoshift/octoshift:$GITHUB_SHA ``` {% endraw %} -Then you'll need to update your workflow with the new {% data variables.product.prodname_container_registry %} URL and PAT like this: +そして、ワークフローを新しい {% data variables.product.prodname_container_registry %} URL と PAT で次のように更新する必要があります。 {% raw %} ```yaml diff --git a/translations/ja-JP/content/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images.md b/translations/ja-JP/content/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images.md index 05fc53b92d0a..914fcf10de60 100644 --- a/translations/ja-JP/content/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images.md +++ b/translations/ja-JP/content/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images.md @@ -1,6 +1,6 @@ --- -title: Configuring access control and visibility for container images -intro: 'Choose who has read, write, or admin access to your container image and the visibility of your container images on {% data variables.product.prodname_dotcom %}.' +title: コンテナイメージのアクセス制御と可視性を設定する +intro: 'コンテナイメージに読み取り、書き込み、管理アクセス権限があるユーザと、{% data variables.product.prodname_dotcom %} 上のコンテナイメージの可視性を選択します。' product: '{% data reusables.gated-features.packages %}' versions: free-pro-team: '*' @@ -8,60 +8,60 @@ versions: {% data reusables.package_registry.container-registry-beta %} -### Configuring access to container images for your personal account +### 個人アカウントにコンテナイメージへのアクセス権限を設定する -If you have admin permissions to a user-account owned container image, you can assign read, write, or admin roles to other users. For more information about these permission roles, see "[Visibility and access permissions for container images](/packages/getting-started-with-github-container-registry/about-github-container-registry#visibility-and-access-permissions-for-container-images)." +ユーザアカウントが所有するコンテナイメージに対する管理者権限がある場合には、他のユーザに読み取り、書き込み、管理者ロールを割り当てることができます。 これらの権限ロールに関する詳しい情報については、[コンテナイメージの可視性とアクセス権限](/packages/getting-started-with-github-container-registry/about-github-container-registry#visibility-and-access-permissions-for-container-images)」を参照してください。 {% data reusables.package_registry.package-settings-from-user-level %} -1. On the package settings page, click **Invite teams or people** and enter the name, username, or email of the person you want to give access. Teams cannot be given access to a container image owned by a user account. ![Container access invite button](/assets/images/help/package-registry/container-access-invite.png) -1. Next to the username or team name, use the "Role" drop-down menu to select a desired permission level. ![Container access options](/assets/images/help/package-registry/container-access-control-options.png) +1. パッケージ設定ページで [**Invite teams or people**] をクリックして、アクセス権を付与するユーザの名前、ユーザ名、またはメールアドレスを入力します。 Team には、ユーザアカウントが所持するコンテナイメージのアクセス権限を与えることができません。 ![コンテナアクセス権の招待ボタン](/assets/images/help/package-registry/container-access-invite.png) +1. ユーザ名または Team 名の隣にある [Role] のドロップダウンメニューで、付与する権限レベルを選択します。 ![コンテナアクセス権のオプション](/assets/images/help/package-registry/container-access-control-options.png) -The selected users will automatically be given access and don't need to accept an invitation first. +選択したユーザには自動的にアクセス権限が与えられ、招待を承諾する必要はありません。 -### Configuring access to container images for an organization +### Organization にコンテナイメージへのアクセス権限を設定する -If you have admin permissions to an organization-owned container image, you can assign read, write, or admin roles to other users and teams. For more information about these permission roles, see "[Visibility and access permissions for container images](/packages/getting-started-with-github-container-registry/about-github-container-registry#visibility-and-access-permissions-for-container-images)." +Organization が所有するコンテナイメージに対する管理者権限がある場合には、他のユーザや Team に読み取り、書き込み、管理者ロールを割り当てることができます。 これらの権限ロールに関する詳しい情報については、[コンテナイメージの可視性とアクセス権限](/packages/getting-started-with-github-container-registry/about-github-container-registry#visibility-and-access-permissions-for-container-images)」を参照してください。 -If your package is owned by an organization and private, then you can only give access to other organization members or teams. +パッケージが Organization の所有でかつプライベートである場合、他の Organization のメンバーまたは Team にのみアクセス権を付与できます。 -For organization image containers, organizations admins must enable packages before you can set the visibility to public. For more information, see "[Enabling GitHub Container Registry for your organization](/packages/getting-started-with-github-container-registry/enabling-github-container-registry-for-your-organization)." +Organization イメージコンテナに対しては、Organization の管理者がパッケージを有効にしないと、可視性をパブリックに設定できません。 詳しい情報については、「[GitHub Container Registry を Organization に対して有効化する](/packages/getting-started-with-github-container-registry/enabling-github-container-registry-for-your-organization)」を参照してください。 {% data reusables.package_registry.package-settings-from-org-level %} -1. On the package settings page, click **Invite teams or people** and enter the name, username, or email of the person you want to give access. You can also enter a team name from the organization to give all team members access. ![Container access invite button](/assets/images/help/package-registry/container-access-invite.png) -1. Next to the username or team name, use the "Role" drop-down menu to select a desired permission level. ![Container access options](/assets/images/help/package-registry/container-access-control-options.png) +1. パッケージ設定ページで [**Invite teams or people**] をクリックして、アクセス権を付与するユーザの名前、ユーザ名、またはメールアドレスを入力します。 また、Organization から Team 名を入力して、全 Team メンバーにアクセスを付与することもできます。 ![コンテナアクセス権の招待ボタン](/assets/images/help/package-registry/container-access-invite.png) +1. ユーザ名または Team 名の隣にある [Role] のドロップダウンメニューで、付与する権限レベルを選択します。 ![コンテナアクセス権のオプション](/assets/images/help/package-registry/container-access-control-options.png) -The selected users or teams will automatically be given access and don't need to accept an invitation first. +選択したユーザや Team には自動的にアクセス権限が与えられ、招待を承諾する必要はありません。 -### Configuring visibility of container images for your personal account +### 個人アカウントにコンテナイメージの可視性を設定する -When you first publish a package, the default visibility is private and only you can see the package. You can modify a private or public container image's access by changing the access settings. +パッケージを最初に公開する際のデフォルトの可視性はプライベートで、パッケージを表示できるのは公開したユーザだけです。 アクセス設定を変更することで、プライベートやパブリックなコンテナイメージのアクセス権限を変更できます。 -A public package can be accessed anonymously without authentication. Once you make your package public, you cannot make your package private again. +パブリックパッケージは認証なしに匿名でアクセスできます。 いったんパッケージをパブリックに設定すると、そのパッケージをプライベートに戻すことはできません。 {% data reusables.package_registry.package-settings-from-user-level %} -5. Under "Danger Zone", choose a visibility setting: - - To make the container image visible to anyone, click **Make public**. +5. [Danger Zone] の下で、可視性の設定を選択します。 + - あらゆる人がコンテナイメージを表示できるようにするには、[**Make public**] をクリックします。 {% warning %} - **Warning:** Once you make a package public, you cannot make it private again. + **警告:** いったんパッケージをパブリックにすると、プライベートに戻すことはできません。 {% endwarning %} - - To make the container image visible to a custom selection of people, click **Make private**. ![Container visibility options](/assets/images/help/package-registry/container-visibility-option.png) + - 指定したユーザだけがコンテナイメージを表示できるようにするには、[**Make private**] をクリックします。 ![コンテナ可視性のオプション](/assets/images/help/package-registry/container-visibility-option.png) -### Configuring visibility of container images for an organization +### Organization にコンテナイメージの可視性を設定する -When you first publish a package, the default visibility is private and only you can see the package. You can grant users or teams different access roles for your container image through the access settings. +パッケージを最初に公開する際のデフォルトの可視性はプライベートで、パッケージを表示できるのは公開したユーザだけです。 アクセス設定を使用して、コンテナイメージに対するさまざまなアクセスロールをユーザや Team に付与できます。 -A public package can be accessed anonymously without authentication. Once you make your package public, you cannot make your package private again. +パブリックパッケージは認証なしに匿名でアクセスできます。 いったんパッケージをパブリックに設定すると、そのパッケージをプライベートに戻すことはできません。 -For organization image containers, organizations admins must enable public packages before you can set the visibility to public. For more information, see "[Enabling GitHub Container Registry for your organization](/packages/getting-started-with-github-container-registry/enabling-github-container-registry-for-your-organization)." +Organization イメージコンテナに対しては、Organization の管理者がパブリックパッケージを有効にしないと、可視性をパブリックに設定できません。 詳しい情報については、「[GitHub Container Registry を Organization に対して有効化する](/packages/getting-started-with-github-container-registry/enabling-github-container-registry-for-your-organization)」を参照してください。 {% data reusables.package_registry.package-settings-from-org-level %} -5. Under "Danger Zone", choose a visibility setting: - - To make the container image visible to anyone, click **Make public**. +5. [Danger Zone] の下で、可視性の設定を選択します。 + - あらゆる人がコンテナイメージを表示できるようにするには、[**Make public**] をクリックします。 {% warning %} - **Warning:** Once you make a package public, you cannot make it private again. + **警告:** いったんパッケージをパブリックにすると、プライベートに戻すことはできません。 {% endwarning %} - - To make the container image visible to a custom selection of people, click **Make private**. ![Container visibility options](/assets/images/help/package-registry/container-visibility-option.png) + - 指定したユーザだけがコンテナイメージを表示できるようにするには、[**Make private**] をクリックします。 ![コンテナ可視性のオプション](/assets/images/help/package-registry/container-visibility-option.png) diff --git a/translations/ja-JP/content/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image.md b/translations/ja-JP/content/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image.md index ba61dad73124..d9160607e2cd 100644 --- a/translations/ja-JP/content/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image.md +++ b/translations/ja-JP/content/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image.md @@ -1,50 +1,50 @@ --- -title: Connecting a repository to a container image -intro: 'You can link a repository with a container image locally and on {% data variables.product.prodname_dotcom %}.' +title: リポジトリをコンテナイメージに接続する +intro: 'ローカルおよび {% data variables.product.prodname_dotcom %} において、リポジトリをコンテナイメージにリンクできます。' product: '{% data reusables.gated-features.packages %}' versions: free-pro-team: '*' --- -When you link a container image with a repository, the package landing page will show information and links from the repository, such as the README. +コンテナイメージをリポジトリに接続すると、パッケージのランディングページには、README などリポジトリからの情報やリンクが表示されます。 -To connect a repository and a container image on {% data variables.product.prodname_dotcom %}, they must share the same owner on {% data variables.product.prodname_dotcom %}. For example, both `my_repo` and `hello_docker` are owned by the user `monalisa`: +リポジトリとコンテナイメージを {% data variables.product.prodname_dotcom %} 上で接続するには、それらが {% data variables.product.prodname_dotcom %} 上で同じオーナーを共有している必要があります。 たとえば、以下の例では `my_repo` と `hello_docker` が、同じ `monalisa` というユーザに所有されています。 ```shell https://github.com/monalisa/my_repo https://github.com/monalisa/hello_docker ``` -### Connecting a repository to a user-owned container image on {% data variables.product.prodname_dotcom %} +### リポジトリをユーザが所有するコンテナに {% data variables.product.prodname_dotcom %} で接続する {% data reusables.package_registry.package-settings-from-user-level %} {% data reusables.package_registry.repository_connection_steps %} -### Connecting a repository to an organization-owned container image on {% data variables.product.prodname_dotcom %} +### リポジトリを Organization が所有するコンテナと {% data variables.product.prodname_dotcom %} で接続する {% data reusables.package_registry.package-settings-from-org-level %} {% data reusables.package_registry.repository_connection_steps %} -### Connecting a repository to a container image on the command line +### リポジトリをコンテナイメージにコマンドラインで接続する -1. In your Dockerfile, add this line, replacing `OWNER` and `REPO` with your details: +1. Dockerfile に以下の行を追加します。`OWNER` と `REPO` は、あなたの情報に置き換えてください。 ```shell LABEL org.opencontainers.image.source https://github.com/OWNER/REPO ``` - For example, if you're the user `monalisa` and own `my-repo`, you would add this line to your Dockerfile: + たとえば、あなたのユーザ名が `monalisa` で、`my-repo` を所有している場合は、以下の行を Dockerfile に追加します。 ```shell LABEL org.opencontainers.image.source https://github.com/monalisa/my-repo ``` - For more information, see "[LABEL](https://docs.docker.com/engine/reference/builder/#label)" in the official Docker documentation and "[Pre-defined Annotation Keys](https://github.com/opencontainers/image-spec/blob/master/annotations.md#pre-defined-annotation-keys)" in the `opencontainers/image-spec` repository. + 詳しい情報については、公式の Docker ドキュメンテーションの「[LABEL](https://docs.docker.com/engine/reference/builder/#label)」、および `opencontainers/image-spec` リポジトリの「[事前定義されたアノテーションキー](https://github.com/opencontainers/image-spec/blob/master/annotations.md#pre-defined-annotation-keys)」を参照してください。 -2. Build your container image. This example builds an image from the Dockerfile in the current directory and assigns the image name `hello_docker`. +2. あなたのコンテナイメージを構築します。 この連では、カレントディレクトリ内の Dockerfile からイメージを構築し、イメージ名を `hello_docker` とします。 ```shell $ docker build -t hello_docker . ``` -3. Optionally, review details for the Docker image you want to tag. +3. 必要に応じて、タグ付けする Docker イメージの情報を確認します。 ```shell $ docker images > REPOSITORY TAG IMAGE ID CREATED SIZE @@ -53,7 +53,7 @@ https://github.com/monalisa/hello_docker > hello-world latest fce289e99eb9 16 months ago 1.84kB ``` -4. Tag your Docker image with your desired image name and hosting destination. +4. Docker イメージを任意のイメージ名とホスティング先でタグ付けします。 ```shell $ docker tag IMAGE_NAME ghcr.io/OWNER/NEW_IMAGE_NAME:TAG ``` @@ -62,14 +62,16 @@ https://github.com/monalisa/hello_docker $ docker tag 38f737a91f39 ghcr.io/monalisa/hello_docker:latest ``` -5. If you haven't already, authenticate to {% data variables.product.prodname_github_container_registry %}. For more information, see "[Authenticating to GitHub Container Registry](/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images#authenticating-to-github-container-registry)." +5. まだ {% data variables.product.prodname_github_container_registry %} への認証を行っていない場合には、 + +{% data variables.product.prodname_github_container_registry %}. 詳しい情報については 「[GitHub Container Registry への認証を行う](/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images#authenticating-to-github-container-registry)」を参照してください。 {% raw %} ```shell $ echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin > Login Succeeded ``` {% endraw %} -6. Push your container image to {% data variables.product.prodname_github_container_registry %}. +6. コンテナイメージを {% data variables.product.prodname_github_container_registry %} にプッシュします。 ```shell $ docker push ghcr.io/OWNER/IMAGE-NAME:TAG ``` diff --git a/translations/ja-JP/content/packages/managing-container-images-with-github-container-registry/deleting-a-container-image.md b/translations/ja-JP/content/packages/managing-container-images-with-github-container-registry/deleting-a-container-image.md index ed2d12614ff6..5e9526ee59a4 100644 --- a/translations/ja-JP/content/packages/managing-container-images-with-github-container-registry/deleting-a-container-image.md +++ b/translations/ja-JP/content/packages/managing-container-images-with-github-container-registry/deleting-a-container-image.md @@ -1,6 +1,6 @@ --- -title: Deleting a container image -intro: 'You can delete a version of a private container image using GraphQL or on {% data variables.product.prodname_dotcom %}.' +title: コンテナイメージを削除する +intro: 'GraphQL を使って、あるいは {% data variables.product.prodname_dotcom %} 上でプライベートパッケージのバージョンを削除できます。' product: '{% data reusables.gated-features.packages %}' versions: free-pro-team: '*' @@ -8,13 +8,13 @@ versions: {% data reusables.package_registry.container-registry-beta %} -### About package deletion +### パッケージの削除について -You can remove an entire container image or a specific version on {% data variables.product.prodname_dotcom %}. To delete a container image, you must use the UI. Using GraphQL to delete a container image is not supported at this time. +{% data variables.product.prodname_dotcom %} 上のコンテナイメージ全体または特定のバージョンを削除できます。 コンテナイメージを削除するには、UI を使用する必要があります。 GraphQL を使用したコンテナイメージの削除は、現時点ではサポートされていません。 -To delete a container image, you must have admin permissions to the container image. +コンテナイメージを削除するには、そのコンテナイメージの管理権限が必要です。 -When deleting public packages, be aware that you may break projects that depend on your package. +パブリックパッケージを削除する場合、そのパッケージに依存するプロジェクトを破壊する可能性があることに注意してください。 @@ -22,16 +22,16 @@ When deleting public packages, be aware that you may break projects that depend {% data reusables.package_registry.package-immutability %} -### Deleting a version of a user-owned container image on {% data variables.product.prodname_dotcom %} +### {% data variables.product.prodname_dotcom %} 上でユーザが所持するコンテナイメージのバージョンを削除する {% data reusables.package_registry.package-settings-from-user-level %} -5. On the left, click **Manage versions**. +5. 左にある [**Manage versions**] をクリックします。 5. 削除したいバージョンの右で**Delete（削除）**をクリックしてください。 ![パッケージの削除ボタン](/assets/images/help/package-registry/delete-package-button.png) 6. 削除を確認するために、パッケージ名を入力して**I understand the consequences, delete this version（生じることを理解したので、このバージョンを削除してください）**をクリックしてください。 ![パッケージの削除の確認ボタン](/assets/images/help/package-registry/confirm-package-deletion.png) -### Deleting a version of an organization-owned container image on {% data variables.product.prodname_dotcom %} +### {% data variables.product.prodname_dotcom %} 上で Organization が所持するコンテナイメージのバージョンを削除する {% data reusables.package_registry.package-settings-from-org-level %} -5. On the left, click **Manage versions**. +5. 左にある [**Manage versions**] をクリックします。 5. 削除したいバージョンの右で**Delete（削除）**をクリックしてください。 ![パッケージの削除ボタン](/assets/images/help/package-registry/delete-package-button.png) 6. 削除を確認するために、パッケージ名を入力して**I understand the consequences, delete this version（生じることを理解したので、このバージョンを削除してください）**をクリックしてください。 ![パッケージの削除の確認ボタン](/assets/images/help/package-registry/confirm-package-deletion.png) diff --git a/translations/ja-JP/content/packages/managing-container-images-with-github-container-registry/index.md b/translations/ja-JP/content/packages/managing-container-images-with-github-container-registry/index.md index c556ba7b516c..d7cb893a0bce 100644 --- a/translations/ja-JP/content/packages/managing-container-images-with-github-container-registry/index.md +++ b/translations/ja-JP/content/packages/managing-container-images-with-github-container-registry/index.md @@ -1,6 +1,6 @@ --- -title: Managing container images with GitHub Container Registry -intro: 'Learn how to manage container images using a supported CLI or on {% data variables.product.prodname_dotcom %}.' +title: GitHub Container Registry でコンテナイメージを管理する +intro: 'サポートされている CLI または {% data variables.product.prodname_dotcom %} を使用してコンテナイメージを管理する方法を学びます。' versions: free-pro-team: '*' --- diff --git a/translations/ja-JP/content/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images.md b/translations/ja-JP/content/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images.md index 7c99258ff0e0..53e30f040795 100644 --- a/translations/ja-JP/content/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images.md +++ b/translations/ja-JP/content/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images.md @@ -1,6 +1,6 @@ --- -title: Pushing and pulling Docker images -intro: 'You can store and manage Docker images in {% data variables.product.prodname_github_container_registry %}.' +title: Docker イメージをプッシュ、プルする +intro: 'Docker イメージは {% data variables.product.prodname_github_container_registry %} で保存して管理できます。' product: '{% data reusables.gated-features.packages %}' versions: free-pro-team: '*' @@ -8,55 +8,57 @@ versions: {% data reusables.package_registry.container-registry-beta %} -To push and pull container images owned by an organization, an organization admin must enable {% data variables.product.prodname_github_container_registry %} for the organization. For more information, see "[Enabling GitHub Container Registry for your organization](/packages/getting-started-with-github-container-registry/enabling-github-container-registry-for-your-organization)." +Organization が所有するコンテナイメージをプッシュまたはプルするには、{% data variables.product.prodname_github_container_registry %} を Organization に対して有効化する必要があります。 詳しい情報については、「[GitHub Container Registry を Organization に対して有効化する](/packages/getting-started-with-github-container-registry/enabling-github-container-registry-for-your-organization)」を参照してください。 ### {% data variables.product.prodname_github_container_registry %} への認証を行う -{% data reusables.package_registry.authenticate-to-container-registry %} +{% data reusables.package_registry.authenticate_with_pat_for_container_registry %} -### Pushing container images +{% data reusables.package_registry.authenticate-to-container-registry-steps %} -This example pushes the latest version of `IMAGE-NAME`. +### コンテナイメージをプッシュする + +以下の例では、`IMAGE-NAME` の最新バージョンをプッシュします。 ```shell - $ docker push ghcr.io/OWNER/IMAGE_NAME.latest + $ docker push ghcr.io/OWNER/IMAGE_NAME:latest ``` -This example pushes the `2.5` version of the image. +以下の例では、イメージのバージョン `2.5` をプッシュします。 ```shell $ docker push ghcr.io/OWNER/IMAGE-NAME:2.5 ``` -When you first publish a package, the default visibility is private. To change the visibility or set access permissions, see "[Configuring access control and visibility for container images](/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images)." +パッケージを最初に公開する際のデフォルトの可視性はプライベートです。 可視性の変更やアクセス権限の設定については、「[コンテナイメージにアクセス制御と可視性を設定する](/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images)」を参照してください。 -### Pulling container images +### コンテナイメージをプルする -#### Pull by digest +#### ダイジェストによるプル -To ensure you're always using the same image, you can specify the exact container image version you want to pull by the `digest` SHA value. +常に同一のイメージを使用するため、`digest` SHA 値でプルするコンテナイメージのバージョンを指定できます。 -1. To find the digest SHA value, use `docker inspect` or `docker pull` and copy the SHA value after `Digest:` +1. `docker inspect` または `docker pull` を使用してダイジェスト SHA 値を調べ、その SHA 値を `Digest:` の後にコピーします。 ```shell $ docker inspect ghcr.io/OWNER/IMAGE_NAME ``` -2. Remove image locally as needed. +2. 必要に応じてローカルでイメージを削除します。 ```shell - $ docker rmi ghcr.io/OWNER/IMAGE_NAME.latest + $ docker rmi ghcr.io/OWNER/IMAGE_NAME:latest ``` -3. Pull the container image with `@YOUR_SHA_VALUE` after the image name. +3. イメージ名の後に `@YOUR_SHA_VALUE` を付けてコンテナイメージをプルします。 ```shell $ docker pull ghcr.io/OWNER/IMAGE_NAME@sha256:82jf9a84u29hiasldj289498uhois8498hjs29hkuhs ``` -#### Pull by name +#### 名前によるプル ```shell $ docker pull ghcr.io/OWNER/IMAGE_NAME ``` -#### Pull by name and version +#### 名前とバージョンによるプル -Docker CLI example showing an image pulled by its name and the `1.14.1` version tag: +名前と `1.14.1` バージョンタグにより Docker CLI でイメージをプルする例を以下に示します。 ```shell $ docker pull ghcr.io/OWNER/IMAGE_NAME:1.14.1 > 5e35bd43cf78: Pull complete @@ -68,7 +70,7 @@ Docker CLI example showing an image pulled by its name and the `1.14.1` version > ghcr.io/orgname/image-name/release:1.14.1 ``` -#### Pull by name and latest version +#### 名前と最新バージョンによるプル ```shell $ docker pull ghcr.io/OWNER/IMAGE_NAME:latest @@ -78,16 +80,16 @@ Docker CLI example showing an image pulled by its name and the `1.14.1` version > ghcr.io/user/image-name:latest ``` -### Building container images +### コンテナイメージを構築する -This example builds the `hello_docker` image: +以下の例では `hello_docker` イメージを構築します。 ```shell $ docker build -t hello_docker . ``` -### Tagging container images +### コンテナイメージにタグ付けする -1. Find the ID for the Docker image you want to tag. +1. タグ付けする Docker イメージの ID を調べます。 ```shell $ docker images > REPOSITORY TAG IMAGE ID CREATED SIZE @@ -96,7 +98,7 @@ This example builds the `hello_docker` image: > hello-world latest fce289e99eb9 16 months ago 1.84kB ``` -2. Tag your Docker image using the image ID and your desired image name and hosting destination. +2. イメージ ID を使用して、Docker イメージを任意のイメージ名とホスティング先でタグ付けします。 ```shell $ docker tag 38f737a91f39 ghcr.io/OWNER/NEW_IMAGE_NAME:latest ``` diff --git a/translations/ja-JP/content/packages/publishing-and-managing-packages/about-github-packages.md b/translations/ja-JP/content/packages/publishing-and-managing-packages/about-github-packages.md index 8f8e0b157b03..f5adf6427544 100644 --- a/translations/ja-JP/content/packages/publishing-and-managing-packages/about-github-packages.md +++ b/translations/ja-JP/content/packages/publishing-and-managing-packages/about-github-packages.md @@ -30,28 +30,28 @@ versions: #### パッケージの表示 -You can review the package's README, some metadata like licensing, download statistics, version history, and more on {% data variables.product.product_name %}. 詳しい情報については「[パッケージの表示](/packages/publishing-and-managing-packages/viewing-packages)」を参照してください。 +パッケージの README や、ライセンス、ダウンロード統計、バージョン履歴などのメタデータを {% data variables.product.product_name %} 上で確認できます。 詳しい情報については「[パッケージの表示](/packages/publishing-and-managing-packages/viewing-packages)」を参照してください。 -#### About package permissions and visibility +#### パッケージの権限と可視性について {% if currentVersion == "free-pro-team@latest" %} -| | Package registries | {% data variables.product.prodname_github_container_registry %} | -| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Hosting locations | You can host multiple packages in one repository. | You can host multiple container images in one organization or user account. | -| Permissions | {% data reusables.package_registry.public-or-private-packages %} パッケージはリポジトリの権限を継承するので、{% data variables.product.prodname_dotcom %}のロールとTeamを使い、各パッケージをインストールしたり公開したりできる人を制限できます。 リポジトリの読み取り権限を持っている人は、パッケージを依存関係としてプロジェクトにインストールでき、書き込み権限を持っている人は新しいパッケージのバージョンを公開できます。 | For each container image, you can choose the access level that others have. The permissions for container image access are separate from your organization and repository permissions. | - Visibility | {% data reusables.package_registry.public-or-private-packages %} | You can set the visibility of each of your container images. A private container image is only visible to people and teams who are given access within your organization. A public container image is visible to anyone. | Anonymous access | N/A | You can access public container images anonymously. +| | パッケージレジストリ | {% data variables.product.prodname_github_container_registry %} +| ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------- | +| ホスト場所 | 1 つのリポジトリに複数のパッケージをホストできます。 | 1 つの Organization またはユーザアカウントに複数のコンテナをホストできます。 | +| 権限 | {{ site.data.reusables.package_registry.public-or-private-packages }} パッケージはリポジトリの権限を継承するので、{{ site.data.variables.product.prodname_dotcom }}のロールとTeamを使い、各パッケージをインストールしたり公開したりできる人を制限できます。 リポジトリの読み取り権限を持っている人は、パッケージを依存関係としてプロジェクトにインストールでき、書き込み権限を持っている人は新しいパッケージのバージョンを公開できます。 | コンテナイメージごとに、他のユーザが持つアクセスレベルを選択できます。 コンテナイメージへのアクセス権限は、Organization およびリポジトリの権限とは別になります。 | + 可視性 | {% data reusables.package_registry.public-or-private-packages %} | それぞれのコンテナイメージに可視性を設定できます。 プライベートコンテナイメージは、Organization 内でアクセス権を付与されたユーザおよび Team のみに表示されます。 パブリックコンテナは誰でも表示できます。 | 匿名アクセス | 該当なし | パブリックコンテナイメージには匿名でアクセスできます。 {% else %} -| | Package registries | -| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| Hosting locations | You can host multiple packages in one repository. | -| Permissions | {% data reusables.package_registry.public-or-private-packages %} パッケージはリポジトリの権限を継承するので、{% data variables.product.prodname_dotcom %}のロールとTeamを使い、各パッケージをインストールしたり公開したりできる人を制限できます。 リポジトリの読み取り権限を持っている人は、パッケージを依存関係としてプロジェクトにインストールでき、書き込み権限を持っている人は新しいパッケージのバージョンを公開できます。 | -| Visibility | {% data reusables.package_registry.public-or-private-packages %} | +| | パッケージレジストリ | +| ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| ホスト場所 | 1 つのリポジトリに複数のパッケージをホストできます。 | +| 権限 | {{ site.data.reusables.package_registry.public-or-private-packages }} パッケージはリポジトリの権限を継承するので、{{ site.data.variables.product.prodname_dotcom }}のロールとTeamを使い、各パッケージをインストールしたり公開したりできる人を制限できます。 リポジトリの読み取り権限を持っている人は、パッケージを依存関係としてプロジェクトにインストールでき、書き込み権限を持っている人は新しいパッケージのバージョンを公開できます。 | +| 可視性 | {% data reusables.package_registry.public-or-private-packages %} {% endif %} {% if currentVersion == "free-pro-team@latest" %} -For more information about permissions and visibility for {% data variables.product.prodname_github_container_registry %}, see "[Configuring access control and visibility for containers](/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images)." +{% data variables.product.prodname_github_container_registry %} のアクセス権限や可視性に関する詳しい情報については、「[コンテナイメージにアクセス制御と可視性を設定する](/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images)」を参照してください。 {% endif %} @@ -60,8 +60,7 @@ For more information about permissions and visibility for {% data variables.prod {% data reusables.package_registry.packages-billing %} 詳細は「[{% data variables.product.prodname_registry %} の支払いについて](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)」を参照してください。 - -{{ site.data.reusables/package_registry/container-registry-beta-billing-note }} +{% data reusables.package_registry.container-registry-beta-billing-note %} {% endif %} ### サポートされているクライアントとフォーマット @@ -69,32 +68,33 @@ For more information about permissions and visibility for {% data variables.prod {% data variables.product.prodname_registry %}は、パッケージのバージョンの公開とインストールに、すでにおなじみのネイティブのパッケージツールコマンドを使います。 {% if currentVersion == "free-pro-team@latest" %} -#### Support for {% data variables.product.prodname_github_container_registry %} +#### {% data variables.product.prodname_github_container_registry %} のサポート -The {% data variables.product.prodname_github_container_registry %} hosts containers at `ghcr.io/OWNER/IMAGE-NAME`. +{% data variables.product.prodname_github_container_registry %} は、コンテナを `ghcr.io/OWNER/IMAGE-NAME` にホストします。 | パッケージクライアント | 言語 | パッケージフォーマット | 説明 | | ----------- | -- | ------------ | ---------------- | | docker | なし | `Dockerfile` | Nodeのパッケージマネージャー | +{% data variables.product.prodname_github_container_registry %} が提供するコンテナのサポートに関する詳しい情報については、 -For more information about the container support offered by {% data variables.product.prodname_github_container_registry %}, see "[About {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry)." +「[About {% data variables.product.prodname_github_container_registry %} について](/packages/getting-started-with-github-container-registry/about-github-container-registry)」を参照してください。 {% endif %} -#### Support for package registries +#### パッケージレジストリのサポート {% if currentVersion == "free-pro-team@latest" %} -Package registries use `PACKAGE-TYPE.pkg.github.com/OWNER/REPOSITORY/IMAGE-NAME` as the package host URL, replacing `PACKAGE-TYPE` with the Package namespace. For example, your Gemfile will be hosted at `rubygem.pkg.github.com/OWNER/REPOSITORY/IMAGE-NAME`. +パッケージレジストリは、`PACKAGE-TYPE.pkg.github.com/OWNER/REPOSITORY/IMAGE-NAME` をパッケージのホスト URL として使用します。`PACKAGE-TYPE` は、パッケージの名前空間に置き換えます。 たとえば、Gemfile は `rubygem.pkg.github.com/OWNER/REPOSITORY/IMAGE-NAME` にホストされます。 {% else %} -The package types supported on {% data variables.product.product_location_enterprise %} may vary since your site administrator can enable or disable support for different package types. For more information, see "[Managing GitHub Packages for your enterprise](/enterprise/admin/packages)." +サイト管理者がさまざまなパッケージのタイプを有効化、無効化できるため、{% data variables.product.product_location_enterprise %} でサポートされているパッケージのタイプはさまざまです。 詳しい情報については、「[Enterprise 向けの GitHub Packages を管理する](/enterprise/admin/packages)」を参照してください。 -If {% data variables.product.product_location_enterprise %} has subdomain isolation enabled, then package registries will use `PACKAGE-TYPE.HOSTNAME/OWNER/REPOSITORY/IMAGE-NAME` as the package host URL, replacing `PACKAGE-TYPE` with the Package namespace. For example, your Dockerfile will be hosted at `docker.HOSTNAME/OWNER/REPOSITORY/IMAGE-NAME`. +{% data variables.product.product_location_enterprise %} が Subdomain Isolation を有効化している場合、パッケージレジストリは `PACKAGE-TYPE.HOSTNAME/OWNER/REPOSITORY/IMAGE-NAME` をパッケージのホスト URL として使用します。`PACKAGE-TYPE` は、パッケージの名前空間に置き換えます。 たとえば、Dockerfile は `docker.HOSTNAME/OWNER/REPOSITORY/IMAGE-NAME` にホストされます。 -If {% data variables.product.product_location_enterprise %} has subdomain isolation disabled, then package registries will use `HOSTNAME/_registry/PACKAGE-TYPE/OWNER/REPOSITORY/IMAGE-NAME` as the package host URL. For example, your Gemfile will be hosted at `HOSTNAME/_registry/rubygems/OWNER/REPOSITORY/IMAGE-NAME`, replacing *HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance. |{% endif %} +{% data variables.product.product_location_enterprise %} が Subdomain Isolation を無効化している場合、パッケージレジストリは `HOSTNAME/_registry/PACKAGE-TYPE/OWNER/REPOSITORY/IMAGE-NAME` をパッケージのホスト URL として使用します。 たとえば、Gemfile は `HOSTNAME/_registry/rubygems/OWNER/REPOSITORY/IMAGE-NAME` にホストされます。*HOSTNAME* は、{% data variables.product.prodname_ghe_server %} インスタンスのホスト名に置き換えます。 |{% endif %} {% if currentVersion == "free-pro-team@latest" %} -| 言語 | 説明 | パッケージフォーマット | パッケージクライアント | Package namespace | +| 言語 | 説明 | パッケージフォーマット | パッケージクライアント | パッケージ名前空間 | | ---------- | ----------------------------- | ------------------------------------- | ------------ | ----------------------------------------------------- | | JavaScript | Nodeのパッケージマネージャー | `package.json` | `npm` | `npm.pkg.github.com/OWNER/REPOSITORY/IMAGE-NAME` | | Ruby | RubyGemsパッケージマネージャー | `Gemfile` | `gem` | `rubygems.pkg.github.com/OWNER/REPOSITORY/IMAGE-NAME` | @@ -104,9 +104,9 @@ If {% data variables.product.product_location_enterprise %} has subdomain isolat {% else %} -With subdomain isolation enabled on {% data variables.product.product_location_enterprise %}: +{% data variables.product.product_location_enterprise %} で Subdomain Isolation を有効化している場合 -| 言語 | 説明 | パッケージフォーマット | パッケージクライアント | Package namespace | +| 言語 | 説明 | パッケージフォーマット | パッケージクライアント | パッケージ名前空間 | | ---------- | ----------------------------- | ------------------------------------- | ------------ | ----------------------------------------------- | | JavaScript | Nodeのパッケージマネージャー | `package.json` | `npm` | `npm.HOSTNAME/OWNER/REPOSITORY/IMAGE-NAME` | | Ruby | RubyGemsパッケージマネージャー | `Gemfile` | `gem` | `rubygems.HOSTNAME/OWNER/REPOSITORY/IMAGE-NAME` | @@ -115,9 +115,9 @@ With subdomain isolation enabled on {% data variables.product.product_location_e | .NET | .NET用のNuGetパッケージ管理 | `nupkg` | `dotnet` CLI | `nuget.HOSTNAME/OWNER/REPOSITORY/IMAGE-NAME` | | なし | Dockerコンテナ管理プラットフォーム | `Dockerfile` | `Docker` | `docker.HOSTNAME/OWNER/REPOSITORY/IMAGE-NAME` | -With subdomain isolation disabled on {% data variables.product.product_location_enterprise %}: +{% data variables.product.product_location_enterprise %} で Subdomain Isolation を無効化している場合 -| 言語 | 説明 | パッケージフォーマット | パッケージクライアント | Package namespace | +| 言語 | 説明 | パッケージフォーマット | パッケージクライアント | パッケージ名前空間 | | ---------- | ----------------------------- | ------------------------------------- | ------------ | --------------------------------------------------------- | | JavaScript | Nodeのパッケージマネージャー | `package.json` | `npm` | `HOSTNAME/_registry/npm/OWNER/REPOSITORY/IMAGE-NAME` | | Ruby | RubyGemsパッケージマネージャー | `Gemfile` | `gem` | `HOSTNAME/_registry/rubygems/OWNER/REPOSITORY/IMAGE-NAME` | @@ -127,11 +127,11 @@ With subdomain isolation disabled on {% data variables.product.product_location_ {% note %} -**Note:** Docker is not supported when subdomain isolation is disabled. +**注釈:** Subdomain Isolation が無効化されている場合、Docker はサポートされません。 {% endnote %} -For more information about subdomain isolation, see "[Enabling subdomain isolation](/enterprise/admin/configuration/enabling-subdomain-isolation)." +Subdomain Isolation の詳しい情報については、「[Subdomain Isolation を有効化する](/enterprise/admin/configuration/enabling-subdomain-isolation)」を参照してください。 {% endif %} @@ -144,13 +144,13 @@ For more information about subdomain isolation, see "[Enabling subdomain isolati {% if currentVersion == "free-pro-team@latest" %} ### トークンについて -| スコープ | 説明 | -| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `read:packages` | Download and install container images from {% data variables.product.prodname_github_container_registry %} | -| `write:packages` | Upload and publish container images to {% data variables.product.prodname_github_container_registry %} | -| `delete:packages` | Delete specified versions of private or public container images from {% data variables.product.prodname_github_container_registry %}. For more information, see "[Deleting a container image](/packages/managing-container-images-with-github-container-registry/deleting-a-container-image)." | +| スコープ | 説明 | +| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `read:packages` | {% data variables.product.prodname_github_container_registry %}からのコンテナイメージのダウンロードとインストール | +| `write:packages` | {% data variables.product.prodname_github_container_registry %}へのコンテナイメージのアップロードと公開 | +| `delete:packages` | {% data variables.product.prodname_github_container_registry %}からの特定バージョンのプライベートまたはパブリックコンテナイメージの削除。 詳細は「[コンテナイメージを削除する](/packages/managing-container-images-with-github-container-registry/deleting-a-container-image)」を参照してください。 | -To learn about available scopes and permissions for container images, see "[About {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry)" or "[Configuring access control and visibility for container images](/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images)." +コンテナイメージで利用できるスコープおよび権限については、「[{% data variables.product.prodname_github_container_registry %} について](/packages/getting-started-with-github-container-registry/about-github-container-registry)」または「[コンテナイメージにアクセス制御と可視性を設定する](/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images)」を参照してください。 詳しい情報については、「[個人アクセストークンを作成する](/github/authenticating-to-github/creating-a-personal-access-token/)」と「[利用可能なスコープ](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)」を参照してください。 @@ -166,9 +166,9 @@ To learn about available scopes and permissions for container images, see "[Abou | スコープ | 説明 | リポジトリの権限 | | ----------------- | ------------------------------------------------------------------------------------------------ | ---------------- | -| `read:packages` | {% data variables.product.prodname_registry %}からのパッケージのダウンロードとインストール | 読み取り | -| `write:packages` | {% data variables.product.prodname_registry %}へのパッケージのアップロードと公開 | 書き込み | -| `delete:packages` | {% data variables.product.prodname_registry %}からの特定バージョンのプライベートパッケージの削除 | 管理 | +| `read:packages` | {% data variables.product.prodname_registry %}からのパッケージのダウンロードとインストール | 読み取り | +| `write:packages` | {% data variables.product.prodname_registry %}へのパッケージのアップロードと公開 | 書き込み | +| `delete:packages` | {% data variables.product.prodname_registry %}からの特定バージョンのプライベートパッケージの削除 | 管理 | | `repo` | プライベートリポジトリ内の特定パッケージのインストール、アップロード、削除（`read:packages`、`write:packages`あるいは`delete:packages`と併せて） | 読み取り、書き込み、あるいは管理 | {% data variables.product.prodname_actions %}ワークフローを作成する際には、`GITHUB_TOKEN`を使って{% data variables.product.prodname_registry %}にパッケージを公開してインストールでき、個人アクセストークンを保存して管理する必要はありません。 @@ -180,14 +180,15 @@ To learn about available scopes and permissions for container images, see "[Abou ### パッケージの管理 -{% data variables.product.product_name %}上で、あるいはGraphQL APIを使ってプライベートパッケージのバージョンを削除できます。 GraphQL APIを使ってプライベートパッケージに対するクエリや削除を行う場合、{% data variables.product.prodname_registry %}の認証に使うのと同じトークンを使わなければなりません。 詳しい情報については、「[パッケージの削除](/packages/publishing-and-managing-packages/deleting-a-package)」と「[GraphQLでの呼び出しの作成](/v4/guides/forming-calls/)」を参照してください。 +You can delete a version of a private package on {% data variables.product.product_name %} or using the GraphQL API. GraphQL APIを使ってプライベートパッケージに対するクエリや削除を行う場合、{% data variables.product.prodname_registry %}の認証に使うのと同じトークンを使わなければなりません。 詳しい情報については、「[パッケージの削除](/packages/publishing-and-managing-packages/deleting-a-package)」と「[GraphQLでの呼び出しの作成](/v4/guides/forming-calls/)」を参照してください。 webhookを設定して、パッケージの公開や更新といったパッケージ関連のイベントにサブスクライブできます。 詳しい情報については、「[`package` webhookイベント](/webhooks/event-payloads/#package)」を参照してください。 ### サポートへの連絡 {% if currentVersion == "free-pro-team@latest" %} -{% data variables.product.prodname_registry %}についてのフィードバックあるいは機能リクエストがある場合は、[{% data variables.product.prodname_registry %}のフィードバックフォーム](https://support.github.com/contact/feedback?contact%5Bcategory%5D=github-packages)を利用してください。 +{% data variables.product.prodname_registry %} についてのフィードバックあるいは機能リクエストがある場合は、 +[{% data variables.product.prodname_registry %} のフィードバックフォーム](https://support.github.com/contact/feedback?contact%5Bcategory%5D=github-packages)を利用してください。 [連絡フォーム](https://support.github.com/contact?form%5Bsubject%5D=Re:%20GitHub%20Packages)を使い、{% data variables.product.prodname_registry %}について{% data variables.contact.github_support %}に連絡してください。 @@ -196,6 +197,7 @@ webhookを設定して、パッケージの公開や更新といったパッケ * GDPR違反、APIキー、個人を識別する情報といったセンシティブなデータを含むパッケージを公開した時 {% else %} -If you need support for {% data variables.product.prodname_registry %}, please contact your site administrators. +{% data variables.product.prodname_registry %} についてサポートが必要な場合は、 +サイト管理者に連絡してください。 {% endif %} diff --git a/translations/ja-JP/content/packages/publishing-and-managing-packages/deleting-a-package.md b/translations/ja-JP/content/packages/publishing-and-managing-packages/deleting-a-package.md index bed5968142e1..e3788abc8f92 100644 --- a/translations/ja-JP/content/packages/publishing-and-managing-packages/deleting-a-package.md +++ b/translations/ja-JP/content/packages/publishing-and-managing-packages/deleting-a-package.md @@ -11,7 +11,6 @@ versions: {% data reusables.package_registry.packages-ghes-release-stage %} - {% if currentVersion == "free-pro-team@latest" %} ### プライベートパッケージの削除について diff --git a/translations/ja-JP/content/packages/publishing-and-managing-packages/installing-a-package.md b/translations/ja-JP/content/packages/publishing-and-managing-packages/installing-a-package.md index 40e0fa069a22..1797336b5ac2 100644 --- a/translations/ja-JP/content/packages/publishing-and-managing-packages/installing-a-package.md +++ b/translations/ja-JP/content/packages/publishing-and-managing-packages/installing-a-package.md @@ -20,7 +20,7 @@ versions: ### パッケージをインストールする -以下の同じ一般的なガイドラインに従って、サポートされているいずれかのパッケージのクライアントを使い、{% data variables.product.prodname_registry %}からパッケージをインストールできます。 +以下の同じ一般的なガイドラインに従って、{% if currentVersion == "free-pro-team@latest" %}サポートされているいずれかのパッケージのクライアント{% else %}インスタンスで有効化しているパッケージのタイプ{% endif %}を使い、{% data variables.product.prodname_registry %} からパッケージをインストールできます。 1. 使用するパッケージクライアントについての指示に従って、{% data variables.product.prodname_registry %}の認証をしてください。 詳しい情報については「[トークンについて](/packages/publishing-and-managing-packages/about-github-packages#authenticating-to-github-packages)」を参照してください。 2. 使用するパッケージクライアントに関する指示に従って、パッケージをインストールしてください。 diff --git a/translations/ja-JP/content/packages/publishing-and-managing-packages/publishing-a-package.md b/translations/ja-JP/content/packages/publishing-and-managing-packages/publishing-a-package.md index 58ecd02c6263..341cceaf2d03 100644 --- a/translations/ja-JP/content/packages/publishing-and-managing-packages/publishing-a-package.md +++ b/translations/ja-JP/content/packages/publishing-and-managing-packages/publishing-a-package.md @@ -14,19 +14,20 @@ versions: ### 公開されたパッケージについて -パッケージページ上のインストール及び利用方法の説明といった、説明やその他の詳細を提供することによって、パッケージを理解して利用しやすくできます。 {% data variables.product.product_name %} provides metadata for each version, such as the publication date, download activity, and recent versions. パッケージページの例としては、[@Codertocat/hello-world-npm](https://github.com/Codertocat/hello-world-npm/packages/10696?version=1.0.1)を参照してください。 +パッケージページ上のインストール及び利用方法の説明といった、説明やその他の詳細を提供することによって、パッケージを理解して利用しやすくできます。 {% data variables.product.product_name %} は各バージョンについて、公開日、ダウンロードのアクティビティ、最近のバージョンなどのメタデータを提供します。 パッケージページの例としては、[@Codertocat/hello-world-npm](https://github.com/Codertocat/hello-world-npm/packages/10696?version=1.0.1)を参照してください。 {% data reusables.package_registry.public-or-private-packages %} リポジトリには複数のパッケージを含めることができます。 混乱を避けるため、READMEと説明で各パッケージに関する情報を明確に提供してください。 {% data reusables.package_registry.package-immutability %} {% if currentVersion == "free-pro-team@latest" %} -新しいバージョンのパッケージでセキュリティの脆弱性が解決される場合は、リポジトリでセキュリティアドバイザリを公開する必要があります。 {% data variables.product.prodname_dotcom %} は公開された各セキュリティアドバイザリを確認し、それを使用して、影響を受けるリポジトリに {% data variables.product.prodname_dependabot_short %} アラートを送信できます。 詳しい情報については、「[GitHub セキュリティアドバイザリについて](/github/managing-security-vulnerabilities/about-github-security-advisories)」 を参照してください。 +新しいバージョンのパッケージでセキュリティの脆弱性が解決される場合は、リポジトリでセキュリティアドバイザリを公開する必要があります。 +{% data variables.product.prodname_dotcom %} は公開された各セキュリティアドバイザリを確認し、それを使用して、影響を受けるリポジトリに {% data variables.product.prodname_dependabot_short %} アラートを送信できます。 詳しい情報については、「[GitHub セキュリティアドバイザリについて](/github/managing-security-vulnerabilities/about-github-security-advisories)」 を参照してください。 {% endif %} ### パッケージを公開する -以下の同じ一般的ガイドラインに従うことで、サポートされているパッケージクライアントを使って{% data variables.product.prodname_registry %}にパッケージを公開できます。 +以下の同じ一般的なガイドラインに従って、{% if currentVersion == "free-pro-team@latest" %}サポートされているいずれかのパッケージのクライアント{% else %}インスタンスで有効化しているパッケージのタイプ{% endif %}を使い、{% data variables.product.prodname_registry %} にパッケージを公開できます。 1. 実行したいタスクに対して適切なスコープを持つ既存のアクセストークンを作成もしくは利用してください。 詳しい情報については「[{% data variables.product.prodname_registry %}について](/packages/publishing-and-managing-packages/about-github-packages#authenticating-to-github-packages)」を参照してください。 2. 使用するパッケージクライアントについての指示に従って、アクセストークンを使って{% data variables.product.prodname_registry %}の認証をしてください。 diff --git a/translations/ja-JP/content/packages/publishing-and-managing-packages/viewing-packages.md b/translations/ja-JP/content/packages/publishing-and-managing-packages/viewing-packages.md index 4c0e60ee2774..6c34def1bef1 100644 --- a/translations/ja-JP/content/packages/publishing-and-managing-packages/viewing-packages.md +++ b/translations/ja-JP/content/packages/publishing-and-managing-packages/viewing-packages.md @@ -1,6 +1,6 @@ --- title: パッケージの表示 -intro: リポジトリに公開されたパッケージの詳細を表示し、Organization またはユーザごとに結果を絞り込むことができます。 +intro: 'リポジトリに公開されたパッケージの詳細を表示し、Organization またはユーザごとに結果を絞り込むことができます。' product: '{% data reusables.gated-features.packages %}' redirect_from: - /articles/viewing-a-repositorys-packages @@ -33,7 +33,7 @@ Organization にインストールされているすべてのパッケージを {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} 3. Organization 名の下で、クリックします -{% octicon "package" aria-label="The package icon" %} **Packages**. +Organization 名の下で、{% octicon "package" aria-label="The package icon" %} [**Packages**] をクリックします。 {% data reusables.package_registry.navigate-to-packages %} ### パッケージを表示する diff --git a/translations/ja-JP/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-apache-maven-for-use-with-github-packages.md b/translations/ja-JP/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-apache-maven-for-use-with-github-packages.md index a24b9bc9478d..13b5a865bcc4 100644 --- a/translations/ja-JP/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-apache-maven-for-use-with-github-packages.md +++ b/translations/ja-JP/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-apache-maven-for-use-with-github-packages.md @@ -1,6 +1,6 @@ --- -title: GitHub Packagesで利用するために Apache Maven を設定する -intro: '{% data variables.product.prodname_registry %} にパッケージを公開するよう Apache Mavenを設定し、{% data variables.product.prodname_registry %} に保存されたパッケージを依存関係としてJavaプロジェクトで利用できます。' +title: Configuring Apache Maven for use with GitHub Packages +intro: 'You can configure Apache Maven to publish packages to {% data variables.product.prodname_registry %} and to use packages stored on {% data variables.product.prodname_registry %} as dependencies in a Java project.' product: '{% data reusables.gated-features.packages %}' redirect_from: - /articles/configuring-apache-maven-for-use-with-github-package-registry @@ -13,28 +13,28 @@ versions: {% data reusables.package_registry.packages-ghes-release-stage %} -**ノート:** dockerイメージをインストールしたり公開したりする際に、現時点で{% data variables.product.prodname_registry %}はWindowsイメージのような外部レイヤーはサポートしていません。 +{% data reusables.package_registry.admins-can-configure-package-types %} -### {% data variables.product.prodname_registry %} への認証を行う +### Authenticating to {% data variables.product.prodname_registry %} {% data reusables.package_registry.authenticate-packages %} -#### 個人アクセストークンでの認証 +#### Authenticating with a personal access token {% data reusables.package_registry.required-scopes %} -*~/.m2/settings.xml*ファイルを編集して個人アクセストークンを含めることで、Apache Mavenで{% data variables.product.prodname_registry %}の認証を受けられます。 *~/.m2/settings.xml*ファイルがないなら新しく作成してください。 +You can authenticate to {% data variables.product.prodname_registry %} with Apache Maven by editing your *~/.m2/settings.xml* file to include your personal access token. Create a new *~/.m2/settings.xml* file if one doesn't exist. -`servers`タグの中に、子として`server`タグを`id`付きで追加し、*USERNAME*を{% data variables.product.prodname_dotcom %}のユーザ名で、*TOKEN*を個人アクセストークンで置き換えてください。 +In the `servers` tag, add a child `server` tag with an `id`, replacing *USERNAME* with your {% data variables.product.prodname_dotcom %} username, and *TOKEN* with your personal access token. -`repositories`の中で、リポジトリの`id`をクレデンシャルを含む`server`タグに追加した`id`にマッピングして、リポジトリを設定してください。 `repositories`の中で、リポジトリの`id`をクレデンシャルを含む`server`タグに追加した`id`にマッピングして、リポジトリを設定してください。 {% data reusables.package_registry.lowercase-name-field %} +In the `repositories` tag, configure a repository by mapping the `id` of the repository to the `id` you added in the `server` tag containing your credentials. Replace {% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance, {% endif %}*REPOSITORY* with the name of the repository you'd like to publish a package to or install a package from, and *OWNER* with the name of the user or organization account that owns the repository. {% data reusables.package_registry.lowercase-name-field %} -複数のリポジトリとやりとりをしたい場合には、それぞれのリポジトリを`repositories`タグの子の個別の`repository`に追加し、それぞれの`id`を`servers` タグのクレデンシャルにマッピングできます。 +If you want to interact with multiple repositories, you can add each repository to separate `repository` children in the `repositories` tag, mapping the `id` of each to the credentials in the `servers` tag. {% data reusables.package_registry.apache-maven-snapshot-versions-supported %} {% if currentVersion != "free-pro-team@latest" %} -パッケージの作成に関する詳しい情報については[maven.apache.orgのドキュメンテーション](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html)を参照してください。 +If your instance has subdomain isolation enabled: {% endif %} ``` @@ -60,7 +60,7 @@ versions: github GitHub OWNER Apache Maven Packages - https://maven.pkg.github.com/OWNER/REPOSITORY + https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}maven.HOSTNAME{% endif %}/OWNER/REPOSITORY @@ -77,7 +77,7 @@ versions: ``` {% if currentVersion != "free-pro-team@latest" %} -たとえば、以下の*OctodogApp*と*OctocatApp*は同じリポジトリに公開されます。 +If your instance has subdomain isolation disabled: ``` `要素に含めてください。 {% data variables.product.prodname_dotcom %} will match the repository based on that field. リポジトリ名も`distributionManagement`要素の一部なので、複数のパッケージを同じリポジトリに公開するための追加手順はありません。 +If you would like to publish multiple packages to the same repository, you can include the URL of the repository in the `` element of the *pom.xml* file. {% data variables.product.prodname_dotcom %} will match the repository based on that field. Since the repository name is also part of the `distributionManagement` element, there are no additional steps to publish multiple packages to the same repository. -パッケージの作成に関する詳しい情報については[maven.apache.orgのドキュメンテーション](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html)を参照してください。 +For more information on creating a package, see the [maven.apache.org documentation](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html). -1. パッケージディレクトリ内にある*pom.xml*ファイルの`distributionManagement`要素を編集し、`OWNER`をリポジトリを所有しているユーザもしくはOrganizationアカウントの名前で、`REPOSITORY`をプロジェクトを含むリポジトリの名前で置き換えてください。 - -`servers`タグの中に、子として`server`タグを`id`付きで追加し、*USERNAME*を{% data variables.product.prodname_dotcom %}のユーザ名で、*TOKEN*を個人アクセストークンで置き換えてください。 +1. Edit the `distributionManagement` element of the *pom.xml* file located in your package directory, replacing {% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance, {% endif %}`OWNER` with the name of the user or organization account that owns the repository and `REPOSITORY` with the name of the repository containing your project. {% if currentVersion != "free-pro-team@latest" %} - パッケージの作成に関する詳しい情報については[maven.apache.orgのドキュメンテーション](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html)を参照してください。 + If your instance has subdomain isolation enabled: {% endif %} ``` github GitHub OWNER Apache Maven Packages - https://maven.pkg.github.com/OWNER/REPOSITORY + https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}maven.HOSTNAME{% endif %}/OWNER/REPOSITORY ``` {% if currentVersion != "free-pro-team@latest" %} - たとえば、以下の*OctodogApp*と*OctocatApp*は同じリポジトリに公開されます。 + If your instance has subdomain isolation disabled: ``` @@ -158,7 +156,7 @@ versions: ``` {% endif %} -2. パッケージを公開します。 +2. Publish the package. ```shell $ mvn deploy @@ -166,12 +164,12 @@ versions: {% data reusables.package_registry.viewing-packages %} -### パッケージをインストールする +### Installing a package -{% data variables.product.prodname_registry %}からApache Mavenパッケージをインストールするには、*pom.xml*ファイルを編集してパッケージを依存関係として含めてください。 複数のリポジトリからパッケージをインストールしたい場合は、それぞれについて`repository`タグを追加してください。 プロジェクト内での*pom.xml*ファイルの利用に関する詳しい情報については、Apache Mavenドキュメンテーション中の「[ Introduction to the POM](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html)」を参照してください。 +To install an Apache Maven package from {% data variables.product.prodname_registry %}, edit the *pom.xml* file to include the package as a dependency. If you want to install packages from more than one repository, add a `repository` tag for each. For more information on using a *pom.xml* file in your project, see "[Introduction to the POM](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html)" in the Apache Maven documentation. {% data reusables.package_registry.authenticate-step %} -2. パッケージの依存関係をプロジェクトの*pom.xml*ファルの`dependencies`要素に追加し、`com.example:test`をパッケージで置き換えてください。 +2. Add the package dependencies to the `dependencies` element of your project *pom.xml* file, replacing `com.example:test` with your package. ``` @@ -182,13 +180,13 @@ versions: ``` -3. パッケージをインストールします。 +3. Install the package. ```shell $ mvn install ``` -### 参考リンク +### Further reading -- [{% data variables.product.prodname_registry %}で利用するためのGradleの設定](/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages) -- [パッケージの削除](/packages/publishing-and-managing-packages/deleting-a-package/) +- "[Configuring Gradle for use with {% data variables.product.prodname_registry %}](/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages)" +- "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package/)" diff --git a/translations/ja-JP/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md b/translations/ja-JP/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md index 3ce223d5104f..59c0d2c8b81b 100644 --- a/translations/ja-JP/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md +++ b/translations/ja-JP/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md @@ -1,6 +1,6 @@ --- -title: GitHub Packagesで利用するために Docker を設定する -intro: 'Docker クライアントが、{% data variables.product.prodname_registry %} を利用して Docker イメージを公開および取得できるよう設定できます。' +title: Configuring Docker for use with GitHub Packages +intro: 'You can configure the Docker client to use {% data variables.product.prodname_registry %} to publish and retrieve docker images.' product: '{% data reusables.gated-features.packages %}' redirect_from: - /articles/configuring-docker-for-use-with-github-package-registry @@ -13,17 +13,13 @@ versions: {% data reusables.package_registry.packages-ghes-release-stage %} -**ノート:** dockerイメージをインストールしたり公開したりする際に、現時点で{% data variables.product.prodname_registry %}はWindowsイメージのような外部レイヤーはサポートしていません。 +{% data reusables.package_registry.admins-can-configure-package-types %} -### {% data variables.product.prodname_registry %} への認証を行う +### About Docker and {% data variables.product.prodname_registry %} -{% warning %} +{% data reusables.package_registry.docker_registry_deprecation_status %} -**Note:** The {% data variables.product.prodname_registry %} Docker registry will be superseded by {% data variables.product.prodname_github_container_registry %}{% if currentVersion != "free-pro-team@latest" %} in a future {% data variables.product.product_name %} release{% endif %}.{% if currentVersion == "free-pro-team@latest" %} To learn how to migrate your existing Docker images and any workflows using them, see "[Migrating to {% data variables.product.prodname_github_container_registry %} for Docker images](/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images)" and "[Getting started with {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry)."{% endif %} - -{% endwarning %} - -`docker` loginコマンドを使い、Dockerで{% data variables.product.prodname_registry %}の認証を受けることができます。 +When installing or publishing a docker image, {% data variables.product.prodname_registry %} does not currently support foreign layers, such as Windows images. {% if currentVersion != "free-pro-team@latest" %} @@ -31,17 +27,19 @@ Before you can use the Docker registry on {% data variables.product.prodname_reg {% endif %} -### {% data variables.product.prodname_registry %} への認証を行う +### Authenticating to {% data variables.product.prodname_registry %} + +{% data reusables.package_registry.docker_registry_deprecation_status %} {% data reusables.package_registry.authenticate-packages %} -#### 個人アクセストークンでの認証 +#### Authenticating with a personal access token {% data reusables.package_registry.required-scopes %} -`docker` loginコマンドを使い、Dockerで{% data variables.product.prodname_registry %}の認証を受けることができます。 +You can authenticate to {% data variables.product.prodname_registry %} with Docker using the `docker` login command. -クレデンシャルをセキュアに保つ貯めに、個人アクセストークンは自分のコンピュータのローカルファイルに保存し、ローカルファイルからトークンを読み取るDockerの`--password-stdin`フラグを使うことをおすすめします。 +To keep your credentials secure, we recommend you save your personal access token in a local file on your computer and use Docker's `--password-stdin` flag, which reads your token from a local file. {% if currentVersion == "free-pro-team@latest" %} {% raw %} @@ -54,45 +52,37 @@ Before you can use the Docker registry on {% data variables.product.prodname_reg {% if currentVersion != "free-pro-team@latest" %} {% raw %} ```shell - $ docker images - -> REPOSITORY TAG IMAGE ID CREATED SIZE -> monalisa 1.0 c75bebcdd211 4 weeks ago 1.11MB - -# OWNER/REPO/IMAGE_NAMEでイメージにタグ付けする -$ docker tag c75bebcdd211 docker.pkg.github.com/octocat/octo-app/monalisa:1.0 - -# {% data variables.product.prodname_registry %}にイメージをプッシュ -$ docker push docker.pkg.github.com/octocat/octo-app/monalisa:1.0 + $ cat ~/TOKEN.txt | docker login docker.HOSTNAME -u USERNAME --password-stdin ``` {% endraw %} {% endif %} -この例のloginコマンドを使うには、`USERNAME` を{% data variables.product.prodname_dotcom %}のユーザ名で、`~/TOKEN.txt`を{% data variables.product.prodname_dotcom %}の個人アクセストークンへのファイルパスで置き換えてください。 +To use this example login command, replace `USERNAME` with your {% data variables.product.product_name %} username{% if currentVersion != "free-pro-team@latest" %}, `HOSTNAME` with the URL for {% data variables.product.product_location_enterprise %},{% endif %} and `~/TOKEN.txt` with the file path to your personal access token for {% data variables.product.product_name %}. -詳しい情報については「[Docker login](https://docs.docker.com/engine/reference/commandline/login/#provide-a-password-using-stdin)」を参照してください。 +For more information, see "[Docker login](https://docs.docker.com/engine/reference/commandline/login/#provide-a-password-using-stdin)." -#### `GITHUB_TOKEN`での認証 +#### Authenticating with the `GITHUB_TOKEN` {% data reusables.package_registry.package-registry-with-github-tokens %} -### パッケージを公開する +### Publishing a package -{% data variables.product.prodname_registry %} は、リポジトリごとに複数の最上位 Docker イメージをサポートしています。 リポジトリは任意の数のイメージタグを持つことができます。 10GB以上のDockerイメージの公開やインストールの際には、サービスのパフォーマンスが低下するかもしれず、各レイヤーは5GBが上限です。 詳しい情報については、Dockerのドキュメンテーションの「[Docker tag](https://docs.docker.com/engine/reference/commandline/tag/)」を参照してください。 +{% data reusables.package_registry.docker_registry_deprecation_status %} + +{% data variables.product.prodname_registry %} supports multiple top-level Docker images per repository. A repository can have any number of image tags. You may experience degraded service publishing or installing Docker images larger than 10GB, layers are capped at 5GB each. For more information, see "[Docker tag](https://docs.docker.com/engine/reference/commandline/tag/)" in the Docker documentation. {% data reusables.package_registry.lowercase-name-field %} {% data reusables.package_registry.viewing-packages %} -1. `docker images`を使って、Dockerイメージのイメージ名とIDを確認してください。 +1. Determine the image name and ID for your docker image using `docker images`. ```shell $ docker images > < > > REPOSITORY TAG IMAGE ID CREATED SIZE > IMAGE_NAME VERSION IMAGE_ID 4 weeks ago 1.11MB ``` -2. 新しいDockerイメージを初めて公開し、`monalisa`という名前にできます。 -{% if currentVersion != "free-pro-team@latest" %} *HOSTNAME* with the hostname of {% data variables.product.product_location_enterprise %},{% endif %} and *VERSION* with package version at build time. +2. Using the Docker image ID, tag the docker image, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image,{% if currentVersion != "free-pro-team@latest" %} *HOSTNAME* with the hostname of {% data variables.product.product_location_enterprise %},{% endif %} and *VERSION* with package version at build time. {% if currentVersion == "free-pro-team@latest" %} ```shell $ docker tag IMAGE_ID docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME:VERSION @@ -102,8 +92,7 @@ $ docker push docker.pkg.github.com/octocat/octo-app/monalisa:1.0 $ docker tag IMAGE_ID docker.HOSTNAME/OWNER/REPOSITORY/IMAGE_NAME:VERSION ``` {% endif %} -3. パッケージ用のDockerイメージをまだ構築していないなら、イメージを構築してください。 *OWNER*をリポジトリを所有しているユーザあるいはOrganizationのアカウント名で、*REPOSITORY*をプロジェクトを含むリポジトリ名で、*IMAGE_NAME*をパッケージもしくはイメージの名前で、*VERSION*をビルド時点のパッケージバージョンで置き換え、イメージが現在のワーキングディレクトリにないなら*PATH*をイメージへのパスで置き換えてください。 -{% if currentVersion != "free-pro-team@latest" %} *HOSTNAME* with the hostname of {% data variables.product.product_location_enterprise %},{% endif %} and *PATH* to the image if it isn't in the current working directory.s +3. If you haven't already built a docker image for the package, build the image, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image, *VERSION* with package version at build time,{% if currentVersion != "free-pro-team@latest" %} *HOSTNAME* with the hostname of {% data variables.product.product_location_enterprise %},{% endif %} and *PATH* to the image if it isn't in the current working directory.s {% if currentVersion == "free-pro-team@latest" %} ```shell $ docker build -t docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME:VERSION PATH @@ -113,7 +102,7 @@ $ docker push docker.pkg.github.com/octocat/octo-app/monalisa:1.0 $ docker build -t docker.HOSTNAME/OWNER/REPOSITORY/IMAGE_NAME:VERSION PATH ``` {% endif %} -4. {% data variables.product.prodname_registry %}にイメージを公開してください。 +4. Publish the image to {% data variables.product.prodname_registry %}. {% if currentVersion == "free-pro-team@latest" %} ```shell $ docker push docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME:VERSION @@ -125,13 +114,15 @@ $ docker push docker.pkg.github.com/octocat/octo-app/monalisa:1.0 {% endif %} {% note %} - **ノート:** イメージのプッシュは`IMAGE_NAME:SHA`を使うのではなく、`IMAGE_NAME:VERSION`を使って行ってください。 + **Note:** You must push your image using `IMAGE_NAME:VERSION` and not using `IMAGE_NAME:SHA`. {% endnote %} -#### Dockerイメージのプッシュの例 +#### Example publishing a Docker image + +{% data reusables.package_registry.docker_registry_deprecation_status %} -`monalisa`イメージのバージョン1.0を、イメージIDを使って`octocat/octo-app`に公開できます。 +You can publish version 1.0 of the `monalisa` image to the `octocat/octo-app` repository using an image ID. {% if currentVersion == "free-pro-team@latest" %} ```shell @@ -140,10 +131,10 @@ $ docker images > REPOSITORY TAG IMAGE ID CREATED SIZE > monalisa 1.0 c75bebcdd211 4 weeks ago 1.11MB -# OWNER/REPO/IMAGE_NAMEでイメージにタグ付けする +# Tag the image with OWNER/REPO/IMAGE_NAME $ docker tag c75bebcdd211 docker.pkg.github.com/octocat/octo-app/monalisa:1.0 -# {% data variables.product.prodname_registry %}にイメージをプッシュ +# Push the image to {% data variables.product.prodname_registry %} $ docker push docker.pkg.github.com/octocat/octo-app/monalisa:1.0 ``` @@ -164,13 +155,12 @@ $ docker push docker.HOSTNAME/octocat/octo-app/monalisa:1.0 {% endif %} -新しいDockerイメージを初めて公開し、`monalisa`という名前にできます。 +You can publish a new Docker image for the first time and name it `monalisa`. {% if currentVersion == "free-pro-team@latest" %} ```shell -# docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME:VERSION でイメージを構築 -# Dockerfileはカレントワーキングディレクトリ (.)にあるものとする -$ docker build -t docker.pkg.github.com/octocat/octo-app/monalisa:1.0 . +# Build the image with docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME:VERSION +# Assumes Dockerfile resides in the current working directory (.) $ docker build -t docker.pkg.github.com/octocat/octo-app/monalisa:1.0 . # Push the image to {% data variables.product.prodname_registry %} @@ -188,10 +178,11 @@ $ docker push docker.HOSTNAME/octocat/octo-app/monalisa:1.0 ``` {% endif %} -### パッケージをインストールする +### Installing a package -You can use the `docker pull` command to install a docker image from {% data variables.product.prodname_registry %}, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image,{% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance, {% endif %} and *TAG_NAME* with tag for the image you want to install. {% data reusables.package_registry.lowercase-name-field %} +{% data reusables.package_registry.docker_registry_deprecation_status %} +You can use the `docker pull` command to install a docker image from {% data variables.product.prodname_registry %}, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image,{% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance, {% endif %} and *TAG_NAME* with tag for the image you want to install. {% data reusables.package_registry.lowercase-name-field %} {% if currentVersion == "free-pro-team@latest" %} ```shell @@ -205,11 +196,10 @@ $ docker pull docker.HOSTNAME/OWNER/REPOSITORY/IMAGE_NAME:TAG_NAME {% note %} -**ノート:** イメージのプルは`IMAGE_NAME:SHA`を使うのではなく、`IMAGE_NAME:VERSION`を使って行ってください。 +**Note:** You must pull the image using `IMAGE_NAME:VERSION` and not using `IMAGE_NAME:SHA`. {% endnote %} +### Further reading -### 参考リンク - -- [パッケージの削除](/packages/publishing-and-managing-packages/deleting-a-package/) +- "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package/)" diff --git a/translations/ja-JP/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-dotnet-cli-for-use-with-github-packages.md b/translations/ja-JP/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-dotnet-cli-for-use-with-github-packages.md index 8589ea0ca0e6..ac368d8beef3 100644 --- a/translations/ja-JP/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-dotnet-cli-for-use-with-github-packages.md +++ b/translations/ja-JP/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-dotnet-cli-for-use-with-github-packages.md @@ -1,6 +1,6 @@ --- -title: Configuring `dotnet` CLI for use with GitHub Packages -intro: 'You can configure the `dotnet` command-line interface (CLI) to publish NuGet packages to {% data variables.product.prodname_registry %} and to use packages stored on {% data variables.product.prodname_registry %} as dependencies in a .NET project.' +title: GitHub Packagesで利用するために`dotnet` CLIを設定する +intro: '{% data variables.product.prodname_registry %} にNuGetパッケージを公開し、{% data variables.product.prodname_registry %} に保存されたパッケージを依存関係として .Net プロジェクトで利用するよう`dotnet`コマンドラインインターフェース（CLI）を設定できます。' product: '{% data reusables.gated-features.packages %}' redirect_from: - /articles/configuring-nuget-for-use-with-github-package-registry @@ -14,25 +14,25 @@ versions: {% data reusables.package_registry.packages-ghes-release-stage %} -{% data reusables.package_registry.admins-can-configure-package-types %} +{% data reusables.package_registry.default-name %} たとえば、{% data variables.product.prodname_dotcom %}は`OWNER/test`というリポジトリ内の`com.example:test`という名前のパッケージを公開します。 -### Authenticating to {% data variables.product.prodname_registry %} +### {% data variables.product.prodname_registry %} への認証を行う {% data reusables.package_registry.authenticate-packages %} -#### Authenticating with a personal access token +#### 個人アクセストークンでの認証 {% data reusables.package_registry.required-scopes %} -To authenticate to {% data variables.product.prodname_registry %} with the `dotnet` command-line interface (CLI), create a *nuget.config* file in your project directory specifying {% data variables.product.prodname_registry %} as a source under `packageSources` for the `dotnet` CLI client. +`dotnet`コマンドラインインターフェース（CLI）で{% data variables.product.prodname_registry %}に認証を受けるには、プロジェクトディレクトリに*nuget.config*ファイルを作成し、{% data variables.product.prodname_registry %}をソースとして`dotnet` CLIクライアントの`packageSources`の下に指定してください。 -You must replace: -- `USERNAME` with the name of your user account on {% data variables.product.prodname_dotcom %}. -- `TOKEN` with your personal access token. -- `OWNER` with the name of the user or organization account that owns the repository containing your project.{% if currentVersion != "free-pro-team@latest" %} -- `HOSTNAME` with the host name for your {% data variables.product.prodname_ghe_server %} instance. +以下のように置き換えてください。 +- `USERNAME`を{% data variables.product.prodname_dotcom %}上のユーザアカウント名で。 +- `TOKEN`を個人アクセストークンで。 +- `OWNER`を、プロジェクトを含むリポジトリを所有しているユーザもしくはOrganizationアカウント名で。{% if currentVersion != "free-pro-team@latest" %} +- `HOSTNAME`を、{% data variables.product.prodname_ghe_server %}インスタンスのホスト名で。 -If your instance has subdomain isolation enabled: +パッケージの作成に関する詳しい情報については[maven.apache.orgのドキュメンテーション](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html)を参照してください。 {% endif %} ```xml @@ -52,45 +52,47 @@ If your instance has subdomain isolation enabled: ``` {% if currentVersion != "free-pro-team@latest" %} -If your instance has subdomain isolation disabled: +たとえば、以下の*OctodogApp*と*OctocatApp*は同じリポジトリに公開されます。 ```xml - - - - - - - - - - - - - + + + + Exe + netcoreapp3.0 + OctodogApp + 1.0.0 + Octodog + GitHub + This package adds an Octodog! + https://github.com/octo-org/octo-cats-and-dogs + + + ``` {% endif %} -#### Authenticating with the `GITHUB_TOKEN` +#### `GITHUB_TOKEN`での認証 {% data reusables.package_registry.package-registry-with-github-tokens %} -### Publishing a package +### パッケージを公開する -You can publish a package to {% data variables.product.prodname_registry %} by authenticating with a *nuget.config* file. When publishing, you need to use the same value for `OWNER` in your *csproj* file that you use in your *nuget.config* authentication file. Specify or increment the version number in your *.csproj* file, then use the `dotnet pack` command to create a *.nuspec* file for that version. For more information on creating your package, see "[Create and publish a package](https://docs.microsoft.com/en-us/nuget/quickstart/create-and-publish-a-package-using-the-dotnet-cli)" in the Microsoft documentation. +*nuget.config*で認証を受けることによって、パッケージを{% data variables.product.prodname_registry %}に公開できます。 公開の際には、*nuget.config*認証ファイルで使用する*csproj*ファイル中で、`OWNER`に同じ値を使わなければなりません。 *.csproj*ファイル中でバージョン番号を指定もしくはインクリメントし、`dotnet pack`コマンドを使ってそのバージョンのための*.nuspec*ファイルを作成してください。 パッケージの作成に関する詳しい情報については、Microsoftのドキュメンテーション中の「[クイック スタート: パッケージの作成と公開 (dotnet CLI)](https://docs.microsoft.com/ja-jp/nuget/quickstart/create-and-publish-a-package-using-the-dotnet-cli)」を参照してください。 {% data reusables.package_registry.viewing-packages %} {% data reusables.package_registry.authenticate-step %} -2. Create a new project. +2. 新しいプロジェクトを作成してください。 ```shell dotnet new console --name OctocatApp ``` -3. Add your project's specific information to your project's file, which ends in *.csproj*. You must replace: - - `OWNER` with the name of the user or organization account that owns the repository containing your project. - - `REPOSITORY` with the name of the repository containing the package you want to publish. - - `1.0.0` with the version number of the package.{% if currentVersion != "free-pro-team@latest" %} - - `HOSTNAME` with the host name for your {% data variables.product.prodname_ghe_server %} instance.{% endif %} +3. プロジェクト固有の情報をプロジェクトファイルに追加してください。プロジェクトファイルは*.csproj*で終わります。 以下のように置き換えてください。 + - `OWNER`を、プロジェクトを含むリポジトリを所有しているユーザもしくはOrganizationアカウント名で。 + - `REPOSITORY`を、公開したいパッケージを含むリポジトリの名前で。 + - `1.0.0`を、パッケージのバージョン番号で。 +{% if currentVersion != "free-pro-team@latest" %} + - `HOSTNAME`を、{% data variables.product.prodname_ghe_server %}インスタンスのホスト名で。{% endif %} ``` xml @@ -107,21 +109,21 @@ You can publish a package to {% data variables.product.prodname_registry %} by a ``` -4. Package the project. +4. プロジェクトをパッケージ化してください。 ```shell dotnet pack --configuration Release ``` -5. Publish the package using the `key` you specified in the *nuget.config* file. +5. *nuget.config*ファイル中で指定した`key`を使ってパッケージを公開してください。 ```shell dotnet nuget push "bin/Release/OctocatApp.1.0.0.nupkg" --source "github" ``` -### Publishing multiple packages to the same repository +### 同じリポジトリへの複数パッケージの公開 -To publish multiple packages to the same repository, you can include the same {% data variables.product.prodname_dotcom %} repository URL in the `RepositoryURL` fields in all *.csproj* project files. {% data variables.product.prodname_dotcom %} matches the repository based on that field. +複数のパッケージを同じリポジトリに公開するには、同じ{% data variables.product.prodname_dotcom %}リポジトリURLをすべての*.csproj*プロジェクトファイル中の`RepositoryURL`フィールドに含めることができます。 {% data variables.product.prodname_dotcom %}は、そのフィールドに基づいてリポジトリをマッチします。 -For example, the *OctodogApp* and *OctocatApp* projects will publish to the same repository: +たとえば、以下の*OctodogApp*と*OctocatApp*は同じリポジトリに公開されます。 ``` xml @@ -157,14 +159,13 @@ For example, the *OctodogApp* and *OctocatApp* projects will publish to the same ``` +### パッケージをインストールする -### Installing a package - -Using packages from {% data variables.product.prodname_dotcom %} in your project is similar to using packages from *nuget.org*. Add your package dependencies to your *.csproj* file, specifying the package name and version. For more information on using a *.csproj* file in your project, see "[Working with NuGet packages](https://docs.microsoft.com/en-us/nuget/consume-packages/overview-and-workflow)" in the Microsoft documentation. +プロジェクトで{% data variables.product.prodname_dotcom %}からパッケージを利用するのは、*nuget.org*からパッケージを使用するのに似ています。 パッケージの依存関係を*.csproj*ファイルに追加し、パッケージ名とバージョンを指定してください。 プロジェクトでの*.csproj*ファイルの利用に関する詳しい情報については、Microsoftのドキュメンテーションの「[パッケージ利用のワークフロー](https://docs.microsoft.com/ja-jp/nuget/consume-packages/overview-and-workflow)」を参照してください。 {% data reusables.package_registry.authenticate-step %} -2. To use a package, add `ItemGroup` and configure the `PackageReference` field in the *.csproj* project file, replacing the `OctokittenApp` package with your package dependency and `1.0.0` with the version you want to use: +2. パッケージを利用するには、*.csproj*プロジェクトファイルに`ItemGroup`を追加し、`PackageReference`フィールドを設定してください。`OctokittenApp`パッケージをパッケージの依存関係で、`1.0.0`を使いたいバージョンで置き換えてください。 ``` xml @@ -186,11 +187,11 @@ Using packages from {% data variables.product.prodname_dotcom %} in your project ``` -3. Install the packages with the `restore` command. +3. `restore`コマンドでパッケージをインストールしてください。 ```shell dotnet restore ``` -### Further reading +### 参考リンク -- "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package/)" +- [パッケージの削除](/packages/publishing-and-managing-packages/deleting-a-package/) diff --git a/translations/ja-JP/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages.md b/translations/ja-JP/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages.md index 2da901de0030..1e3edaaa61d7 100644 --- a/translations/ja-JP/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages.md +++ b/translations/ja-JP/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages.md @@ -13,7 +13,7 @@ versions: {% data reusables.package_registry.packages-ghes-release-stage %} -**ノート:** dockerイメージをインストールしたり公開したりする際に、現時点で{% data variables.product.prodname_registry %}はWindowsイメージのような外部レイヤーはサポートしていません。 +{% data reusables.package_registry.default-name %} たとえば、{% data variables.product.prodname_dotcom %}は`OWNER/test`というリポジトリ内の`com.example:test`という名前のパッケージを公開します。 ### {% data variables.product.prodname_registry %} への認証を行う @@ -26,7 +26,8 @@ versions: Gradle GroovyもしくはKotlin DSLを使って、Gradleで{% data variables.product.prodname_registry %}に認証を受けることができます。それには、*build.gradle*ファイル（Gradle Groovy）もしくは*build.gradle.kts*ファイル（Kotlin DSL）ファイルを編集して、個人アクセストークンを含めます。 リポジトリ中の単一のパッケージもしくは複数パッケージを認識するようにGradle Groovy及びKotlin DSLを設定することもできます。 {% if currentVersion != "free-pro-team@latest" %} -Replace *REGISTRY-URL* with the URL for your instance's Maven registry. If your instance has subdomain isolation enabled, use `maven.HOSTNAME`. If your instance has subdomain isolation disabled, use `HOSTNAME/_registry/maven`. In either case, replace *HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance. +*REGISTRY-URL* をインスタンスの Maven レジストリの URL に置き換えます。 インスタンスで Subdomain Isolation が有効になっている場合は、`maven.HOSTNAME` を使用します。 インスタンスで Subdomain Isolation が無効になっている場合は、`HOSTNAME/_registry/maven` を使用します。 いずれの場合でも、*HOSTNAME* を +{% data variables.product.prodname_ghe_server %} インスタンスのホスト名に置き換えてください。 {% endif %} *USERNAME*を{% data variables.product.prodname_dotcom %}のユーザ名で、*TOKEN*を個人アクセストークンで、*REPOSITORY*を公開したいパッケージを含むリポジトリの名前で、*OWNER*をリポジトリを所有する{% data variables.product.prodname_dotcom %}のユーザもしくはOrganizationアカウント名で置き換えてください。 {% data reusables.package_registry.lowercase-name-field %} @@ -48,7 +49,7 @@ publishing { repositories { maven { name = "GitHubPackages" - url = uri("https://maven.pkg.github.com/OWNER/REPOSITORY") + url = uri("https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}REGISTRY-URL{% endif %}/OWNER/REPOSITORY") credentials { username = project.findProperty("gpr.user") ?: System.getenv("USERNAME") password = project.findProperty("gpr.key") ?: System.getenv("TOKEN") @@ -76,7 +77,7 @@ subprojects { repositories { maven { name = "GitHubPackages" - url = uri("https://maven.pkg.github.com/OWNER/REPOSITORY") + url = uri("https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}REGISTRY-URL{% endif %}/OWNER/REPOSITORY") credentials { username = project.findProperty("gpr.user") ?: System.getenv("USERNAME") password = project.findProperty("gpr.key") ?: System.getenv("TOKEN") @@ -103,7 +104,7 @@ publishing { repositories { maven { name = "GitHubPackages" - url = uri("https://maven.pkg.github.com/OWNER/REPOSITORY") + url = uri("https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}REGISTRY-URL{% endif %}/OWNER/REPOSITORY") credentials { username = project.findProperty("gpr.user") as String? ?: System.getenv("USERNAME") password = project.findProperty("gpr.key") as String? ?: System.getenv("TOKEN") @@ -120,32 +121,32 @@ publishing { ##### 同じリポジトリ中の複数パッケージのためにKotlin DSLを使う例 - ```shell - plugins { - `maven-publish` apply false - } +```shell +plugins { + `maven-publish` apply false +} - subprojects { - apply(plugin = "maven-publish") - configure { - repositories { - maven { - name = "GitHubPackages" - url = uri("https://maven.pkg.github.com/OWNER/REPOSITORY") - credentials { - username = project.findProperty("gpr.user") as String? ?: System.getenv("USERNAME") - password = project.findProperty("gpr.key") as String? ?: System.getenv("TOKEN") - } - } - } - publications { - register("gpr") { - from(components["java"]) - } - } - } - } - ``` +subprojects { + apply(plugin = "maven-publish") + configure { + repositories { + maven { + name = "GitHubPackages" + url = uri("https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}REGISTRY-URL{% endif %}/OWNER/REPOSITORY") + credentials { + username = project.findProperty("gpr.user") as String? ?: System.getenv("USERNAME") + password = project.findProperty("gpr.key") as String? ?: System.getenv("TOKEN") + } + } + } + publications { + register("gpr") { + from(components["java"]) + } + } + } +} +``` #### `GITHUB_TOKEN`での認証 @@ -173,31 +174,31 @@ publishing { {% data reusables.package_registry.authenticate-step %} 2. *build.gradle*ファイル（Gradle Groovy）もしくは*build.gradle.kts*ファイル（Kotlin DSL）にパッケージの依存関係を追加してください。 - Gradle Groovyの例： + Example using Gradle Groovy: ```shell dependencies { - implementation 'com.example:package' + implementation 'com.example:package' } ``` Kotlin DSLの例： ```shell dependencies { - implementation("com.example:package") + implementation("com.example:package") } ``` 3. *build.gradle*ファイル（Gradle Groovy）もしくは*build.gradle.kts*ファイル（Kotlin DSL）にmavenプラグインを追加してください。 - Gradle Groovyの例： + Example using Gradle Groovy: ```shell plugins { - id 'maven' + id 'maven' } ``` Kotlin DSLの例： ```shell plugins { - `maven` + `maven` } ``` diff --git a/translations/ja-JP/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md b/translations/ja-JP/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md index 72821b9dee25..efc0e2d45072 100644 --- a/translations/ja-JP/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md +++ b/translations/ja-JP/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md @@ -1,6 +1,6 @@ --- -title: GitHub Packagesで利用するためにnpmを設定する -intro: '{% data variables.product.prodname_registry %} にパッケージを公開するよう npm を設定し、{% data variables.product.prodname_registry %} に保存されたパッケージを依存関係として npm プロジェクトで利用できます。' +title: Configuring npm for use with GitHub Packages +intro: 'You can configure npm to publish packages to {% data variables.product.prodname_registry %} and to use packages stored on {% data variables.product.prodname_registry %} as dependencies in an npm project.' product: '{% data reusables.gated-features.packages %}' redirect_from: - /articles/configuring-npm-for-use-with-github-package-registry @@ -13,119 +13,116 @@ versions: {% data reusables.package_registry.packages-ghes-release-stage %} -**ノート:** dockerイメージをインストールしたり公開したりする際に、現時点で{% data variables.product.prodname_registry %}はWindowsイメージのような外部レイヤーはサポートしていません。 +{% data reusables.package_registry.admins-can-configure-package-types %} -### {% data variables.product.prodname_registry %} への認証を行う +### Authenticating to {% data variables.product.prodname_registry %} {% data reusables.package_registry.authenticate-packages %} -#### 個人アクセストークンでの認証 +#### Authenticating with a personal access token {% data reusables.package_registry.required-scopes %} -ユーザごとの*~/.npmrc*ファイルを編集して個人アクセストークンを含めるか、コマンドラインからユーザ名と個人アクセストークンを使ってnpmにログインすることによって、npmで{% data variables.product.prodname_registry %}の認証を受けられます。 +You can authenticate to {% data variables.product.prodname_registry %} with npm by either editing your per-user *~/.npmrc* file to include your personal access token or by logging in to npm on the command line using your username and personal access token. -To authenticate by adding your personal access token to your *~/.npmrc* file, edit the *~/.npmrc* file for your project to include the following line, replacing {% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance and {% endif %}*TOKEN* with your personal access token. *~/.npmrc*ファイルが存在しない場合は、新しく作成してください。 +To authenticate by adding your personal access token to your *~/.npmrc* file, edit the *~/.npmrc* file for your project to include the following line, replacing {% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance and {% endif %}*TOKEN* with your personal access token. Create a new *~/.npmrc* file if one doesn't exist. {% if currentVersion != "free-pro-team@latest" %} -パッケージの作成に関する詳しい情報については[maven.apache.orgのドキュメンテーション](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html)を参照してください。 +If your instance has subdomain isolation enabled: {% endif %} ```shell -//npm.pkg.github.com/:_authToken=TOKEN +//{% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %}/:_authToken=TOKEN ``` {% if currentVersion != "free-pro-team@latest" %} -たとえば、以下の*OctodogApp*と*OctocatApp*は同じリポジトリに公開されます。 +If your instance has subdomain isolation disabled: ```shell -$ npm login --registry=https://npm.pkg.github.com -> Username: USERNAME -> Password: TOKEN -> Email: PUBLIC-EMAIL-ADDRESS +//HOSTNAME/_registry/npm/:_authToken=TOKEN ``` {% endif %} -npmにログインすることで認証を受けるには、`npm login`コマンドを使ってください。*USERNAME*は{% data variables.product.prodname_dotcom %}のユーザ名で、*TOKEN*は個人アクセストークンで、*PUBLIC-EMAIL-ADDRESS*はメールアドレスで置き換えてください。 +To authenticate by logging in to npm, use the `npm login` command, replacing *USERNAME* with your {% data variables.product.prodname_dotcom %} username, *TOKEN* with your personal access token, and *PUBLIC-EMAIL-ADDRESS* with your email address. {% if currentVersion != "free-pro-team@latest" %} -パッケージの作成に関する詳しい情報については[maven.apache.orgのドキュメンテーション](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html)を参照してください。 +If your instance has subdomain isolation enabled: {% endif %} ```shell -"repository" : { - "type" : "git", - "url": "ssh://git@github.com/OWNER/REPOSITORY.git", - "directory": "packages/name" - }, +$ npm login --registry=https://{% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %} +> Username: USERNAME +> Password: TOKEN +> Email: PUBLIC-EMAIL-ADDRESS ``` {% if currentVersion != "free-pro-team@latest" %} -たとえば、以下の*OctodogApp*と*OctocatApp*は同じリポジトリに公開されます。 +If your instance has subdomain isolation disabled: ```shell -registry=https://npm.pkg.github.com/OWNER -@OWNER:registry=https://npm.pkg.github.com -@OWNER:registry=https://npm.pkg.github.com +$ npm login --registry=https://HOSTNAME/_registry/npm/ +> Username: USERNAME +> Password: TOKEN +> Email: PUBLIC-EMAIL-ADDRESS ``` {% endif %} -#### `GITHUB_TOKEN`での認証 +#### Authenticating with the `GITHUB_TOKEN` {% data reusables.package_registry.package-registry-with-github-tokens %} -### パッケージを公開する +### Publishing a package -デフォルトでは、{% data variables.product.prodname_registry %}は*package.json*ファイルのnameフィールドで指定された{% data variables.product.prodname_dotcom %}のリポジトリにパッケージを公開します。 たとえば`@my-org/test`という名前のパッケージを{% data variables.product.prodname_dotcom %}リポジトリの`my-org/test`に公開します。 パッケージディレクトリに*README.md*ファイルを置くことで、パッケージリスティングページのためのまとめを追加できます。 詳しい情報については、npmのドキュメンテーション中の「[Working with package.json](https://docs.npmjs.com/getting-started/using-a-package.json)」及び「[How to create Node.js Modules](https://docs.npmjs.com/getting-started/creating-node-modules)」を参照してください。 +By default, {% data variables.product.prodname_registry %} publishes a package in the {% data variables.product.prodname_dotcom %} repository you specify in the name field of the *package.json* file. For example, you would publish a package named `@my-org/test` to the `my-org/test` {% data variables.product.prodname_dotcom %} repository. You can add a summary for the package listing page by including a *README.md* file in your package directory. For more information, see "[Working with package.json](https://docs.npmjs.com/getting-started/using-a-package.json)" and "[How to create Node.js Modules](https://docs.npmjs.com/getting-started/creating-node-modules)" in the npm documentation. -`URL`フィールドを*package.json*ファイルに含めることで、同じ{% data variables.product.prodname_dotcom %}のリポジトリに複数のパッケージを公開できます。 詳しい情報については「[同じリポジトリへの複数パッケージの公開](#publishing-multiple-packages-to-the-same-repository)」を参照してください。 +You can publish multiple packages to the same {% data variables.product.prodname_dotcom %} repository by including a `URL` field in the *package.json* file. For more information, see "[Publishing multiple packages to the same repository](#publishing-multiple-packages-to-the-same-repository)." -プロジェクト内にあるローカルの *.npmrc* ファイルか、*package.json* の `publishConfig` オプションを使って、スコープのマッピングを設定できます。 {% data variables.product.prodname_registry %}はスコープ付きのnpmパッケージのみをサポートしています。 スコープ付きパッケージには、`@owner/name` というフォーマットの名前が付いています。 スコープ付きパッケージの先頭には常に `@` 記号が付いています。 スコープ付きの名前を使うには、*package.json* の名前を更新する必要がある場合があります。 たとえば、`"name": "@codertocat/hello-world-npm"` のようになります。 +You can set up the scope mapping for your project using either a local *.npmrc* file in the project or using the `publishConfig` option in the *package.json*. {% data variables.product.prodname_registry %} only supports scoped npm packages. Scoped packages have names with the format of `@owner/name`. Scoped packages always begin with an `@` symbol. You may need to update the name in your *package.json* to use the scoped name. For example, `"name": "@codertocat/hello-world-npm"`. {% data reusables.package_registry.viewing-packages %} -#### ローカルの*.npmrc*ファイルを使ったパッケージの公開 +#### Publishing a package using a local *.npmrc* file -*.npmrc*ファイルを使って、プロジェクトのスコープのマッピングを設定できます。 *.npmrc*ファイル中で{% data variables.product.prodname_registry %} URLとアカウントオーナーを使い、{% data variables.product.prodname_registry %}がどこへパッケージリクエストをまわせばいいか把握できるようにしてください。 *.npmrc*を使う事で、他の開発者が{% data variables.product.prodname_registry %}の代わりにうっかりパッケージをnpmjs.orgに公開してしまうのを避けることができます。 {% data reusables.package_registry.lowercase-name-field %} +You can use an *.npmrc* file to configure the scope mapping for your project. In the *.npmrc* file, use the {% data variables.product.prodname_registry %} URL and account owner so {% data variables.product.prodname_registry %} knows where to route package requests. Using an *.npmrc* file prevents other developers from accidentally publishing the package to npmjs.org instead of {% data variables.product.prodname_registry %}. {% data reusables.package_registry.lowercase-name-field %} {% data reusables.package_registry.authenticate-step %} {% data reusables.package_registry.create-npmrc-owner-step %} {% data reusables.package_registry.add-npmrc-to-repo-step %} -4. プロジェクトの*package.json*中のパッケージ名を確認してください。 `name`フィールドは、スコープとパッケージの名前を含まなければなりません。 たとえば、パッケージの名前が "test" で、"My-org" {% data variables.product.prodname_dotcom %} Organizationに公開する場合、*package.json*の`name`フィールドは `@my-org/test`とする必要があります。 +4. Verify the name of your package in your project's *package.json*. The `name` field must contain the scope and the name of the package. For example, if your package is called "test", and you are publishing to the "My-org" {% data variables.product.prodname_dotcom %} organization, the `name` field in your *package.json* should be `@my-org/test`. {% data reusables.package_registry.verify_repository_field %} {% data reusables.package_registry.publish_package %} -#### *package.json*ファイル中の`publishConfig`を利用したパッケージの公開 +#### Publishing a package using `publishConfig` in the *package.json* file -*package.json*ファイル中の`publishConfig`要素を使い、パッケージを公開したいレジストリを指定できます。 詳しい情報についてはnpmドキュメンテーションの「[Configの公開](https://docs.npmjs.com/files/package.json#publishconfig)」を参照してください。 +You can use `publishConfig` element in the *package.json* file to specify the registry where you want the package published. For more information, see "[publishConfig](https://docs.npmjs.com/files/package.json#publishconfig)" in the npm documentation. -1. パッケージの*package.json*ファイルを編集して、`publishConfig`エントリを含めてください。 +1. Edit the *package.json* file for your package and include a `publishConfig` entry. {% if currentVersion != "free-pro-team@latest" %} - パッケージの作成に関する詳しい情報については[maven.apache.orgのドキュメンテーション](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html)を参照してください。 + If your instance has subdomain isolation enabled: {% endif %} ```shell - "publishConfig": { - "registry":"https://npm.pkg.github.com/" - }, + "publishConfig": { + "registry":"https://{% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %}" + }, ``` {% if currentVersion != "free-pro-team@latest" %} - たとえば、以下の*OctodogApp*と*OctocatApp*は同じリポジトリに公開されます。 + If your instance has subdomain isolation disabled: ```shell - "publishConfig": { - "registry":"https://HOSTNAME/_registry/npm/" - }, + "publishConfig": { + "registry":"https://HOSTNAME/_registry/npm/" + }, ``` {% endif %} {% data reusables.package_registry.verify_repository_field %} {% data reusables.package_registry.publish_package %} -### 同じリポジトリへの複数パッケージの公開 +### Publishing multiple packages to the same repository -複数のパッケージを同じリポジトリに公開するには、{% data variables.product.prodname_dotcom %}リポジトリのURLを各パッケージの*package.json*ファイル中の`repository`フィールドに含めることができます。 +To publish multiple packages to the same repository, you can include the URL of the {% data variables.product.prodname_dotcom %} repository in the `repository` field of the *package.json* file for each package. -リポジトリのURLが正しいことを確認するには、REPOSITORYを公開したいパッケージを含むリポジトリ名で、OWNERをリポジトリを所有している{% data variables.product.prodname_dotcom %}のユーザもしくはOrganizationアカウント名で置き換えてください。 +To ensure the repository's URL is correct, replace REPOSITORY with the name of the repository containing the package you want to publish, and OWNER with the name of the user or organization account on {% data variables.product.prodname_dotcom %} that owns the repository. -{% data variables.product.prodname_registry %} は、パッケージ名の代わりに、このURLを元にしてリポジトリを照合します。 *package.json*ファイルをリポジトリのルートディレクトリ外に保存しているなら、`directory`フィールドを使って{% data variables.product.prodname_registry %}が*package.json*ファイルを見つけられる場所を指定できます。 +{% data variables.product.prodname_registry %} will match the repository based on the URL, instead of based on the package name. If you store the *package.json* file outside the root directory of your repository, you can use the `directory` field to specify the location where {% data variables.product.prodname_registry %} can find the *package.json* files. ```shell "repository" : { @@ -135,18 +132,18 @@ registry=https://npm.pkg.github.com/OWNER }, ``` -### パッケージをインストールする +### Installing a package -プロジェクトの*package.json*ファイルに依存関係としてパッケージを追加することで、{% data variables.product.prodname_registry %}からパッケージをインストールできます。 プロジェクトにおける *package.json* の利用に関する詳しい情報については、npm ドキュメンテーションの「[package.json を使って作業する](https://docs.npmjs.com/getting-started/using-a-package.json)」を参照してください。 +You can install packages from {% data variables.product.prodname_registry %} by adding the packages as dependencies in the *package.json* file for your project. For more information on using a *package.json* in your project, see "[Working with package.json](https://docs.npmjs.com/getting-started/using-a-package.json)" in the npm documentation. -デフォルトでは、パッケージは1つのOrganizationから追加できます。 詳しい情報については[他のOrganizationからのパッケージのインストール](#installing-packages-from-other-organizations)を参照してください。 +By default, you can add packages from one organization. For more information, see "[Installing packages from other organizations](#installing-packages-from-other-organizations)." -また、*.npmrc*ファイルをプロジェクトに追加して、パッケージのインストールのすべてのリクエストが{% data variables.product.prodname_registry %}を経由するようにしなければなりません。 すべてのパッケージリクエストを{% data variables.product.prodname_registry %}を経由させると、*npmjs.com*からスコープ付き及びスコープ付きではないパッケージの両方を利用できます。 詳しい情報については npm ドキュメンテーションの「[npm-scope](https://docs.npmjs.com/misc/scope)」を参照してください。 +You also need to add the *.npmrc* file to your project so all requests to install packages will go through {% data variables.product.prodname_registry %}. When you route all package requests through {% data variables.product.prodname_registry %}, you can use both scoped and unscoped packages from *npmjs.com*. For more information, see "[npm-scope](https://docs.npmjs.com/misc/scope)" in the npm documentation. {% data reusables.package_registry.authenticate-step %} {% data reusables.package_registry.create-npmrc-owner-step %} {% data reusables.package_registry.add-npmrc-to-repo-step %} -4. インストールしているパッケージを使うには、プロジェクトの*package.json*を設定してください。 {% data variables.product.prodname_registry %}のためにパッケージの依存関係を*package.json*ファイルに追加するには、`@my-org/server`というように完全なスコープ付きのパッケージ名を指定してください。 *npmjs.com*からのパッケージについては、`@babel/core`あるいは`@lodash`というような完全な名前を指定してください。 たとえば、以下の*package.json*は`@octo-org/octo-app`パッケージを依存関係として使っています。 +4. Configure *package.json* in your project to use the package you are installing. To add your package dependencies to the *package.json* file for {% data variables.product.prodname_registry %}, specify the full-scoped package name, such as `@my-org/server`. For packages from *npmjs.com*, specify the full name, such as `@babel/core` or `@lodash`. For example, this following *package.json* uses the `@octo-org/octo-app` package as a dependency. ``` { @@ -161,28 +158,28 @@ registry=https://npm.pkg.github.com/OWNER } } ``` -5. パッケージをインストールします。 +5. Install the package. ```shell $ npm install ``` -#### 他のOrganizationからのパッケージのインストール +#### Installing packages from other organizations -デフォルトでは、1つのOrganizationからのみ{% data variables.product.prodname_registry %}パッケージを利用できます。 If you'd like to route package requests to multiple organizations and users, you can add additional lines to your *.npmrc* file, replacing {% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance and {% endif %}*OWNER* with the name of the user or organization account that owns the repository containing your project. {% data reusables.package_registry.lowercase-name-field %} +By default, you can only use {% data variables.product.prodname_registry %} packages from one organization. If you'd like to route package requests to multiple organizations and users, you can add additional lines to your *.npmrc* file, replacing {% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance and {% endif %}*OWNER* with the name of the user or organization account that owns the repository containing your project. {% data reusables.package_registry.lowercase-name-field %} {% if currentVersion != "free-pro-team@latest" %} -パッケージの作成に関する詳しい情報については[maven.apache.orgのドキュメンテーション](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html)を参照してください。 +If your instance has subdomain isolation enabled: {% endif %} ```shell -registry=https://{% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %}OWNER +registry=https://{% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME{% endif %}/OWNER @OWNER:registry={% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %} @OWNER:registry={% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %} ``` {% if currentVersion != "free-pro-team@latest" %} -たとえば、以下の*OctodogApp*と*OctocatApp*は同じリポジトリに公開されます。 +If your instance has subdomain isolation disabled: ```shell registry=https://HOSTNAME/_registry/npm/OWNER @@ -191,7 +188,6 @@ registry=https://HOSTNAME/_registry/npm/OWNER ``` {% endif %} +### Further reading -### 参考リンク - -- [パッケージの削除](/packages/publishing-and-managing-packages/deleting-a-package/) +- "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package/)" diff --git a/translations/ja-JP/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md b/translations/ja-JP/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md index e0ea0430f3d2..8875879a16f7 100644 --- a/translations/ja-JP/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md +++ b/translations/ja-JP/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md @@ -1,6 +1,6 @@ --- -title: GitHub ActionsでのGitHub Packagesの利用 -intro: '{% data variables.product.prodname_actions %}でのワークフローを、自動的にパッケージを{% data variables.product.prodname_registry %}に公開もしくは{% data variables.product.prodname_registry %}からインストールするように設定できます。' +title: Using GitHub Packages with GitHub Actions +intro: 'You can configure a workflow in {% data variables.product.prodname_actions %} to automatically publish or install a package from {% data variables.product.prodname_registry %}.' product: '{% data reusables.gated-features.packages %}' redirect_from: - /github/managing-packages-with-github-packages/using-github-packages-with-github-actions @@ -11,41 +11,43 @@ versions: {% data reusables.package_registry.packages-ghes-release-stage %} -### {% data variables.product.prodname_actions %}との{% data variables.product.prodname_registry %}について +### About {% data variables.product.prodname_registry %} with {% data variables.product.prodname_actions %} -{% data reusables.repositories.about-github-actions %} {% data reusables.repositories.actions-ci-cd %} 詳しい情報については「[{% data variables.product.prodname_actions %}について](/github/automating-your-workflow-with-github-actions/about-github-actions)」を参照してください。 +{% data reusables.repositories.about-github-actions %} {% data reusables.repositories.actions-ci-cd %} For more information, see "[About {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/about-github-actions)." -ワークフローの一部としてパッケージの公開やインストールを行うことで、リポジトリのCI及びCDの機能を拡張できます。 +You can extend the CI and CD capabilities of your repository by publishing or installing packages as part of your workflow. {% if currentVersion == "free-pro-team@latest" %} -#### {% data variables.product.prodname_github_container_registry %} への認証を行う +#### Authenticating to {% data variables.product.prodname_github_container_registry %} {% data reusables.package_registry.container-registry-beta %} -{% data variables.product.prodname_registry %}の認証をうけるのに個人アクセストークンを使う代わりに、{% data variables.product.prodname_actions %}を有効化した際にリポジトリ用に自動的に{% data variables.product.prodname_dotcom %}が作成する`GITHUB_TOKEN`を使ってください。 For an authentication example, see "[Authenticating with the {% data variables.product.prodname_container_registry %}](/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images#authenticating-with-the-container-registry)." +{% data reusables.package_registry.authenticate_with_pat_for_container_registry %} + +For an authentication example, see "[Authenticating with the {% data variables.product.prodname_container_registry %}](/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images#authenticating-with-the-container-registry)." {% endif %} #### Authenticating to package registries on {% data variables.product.prodname_dotcom %} -{% if currentVersion == "free-pro-team@latest" %}If you want your workflow to authenticate to {% data variables.product.prodname_registry %} to access a package registry other than the {% data variables.product.prodname_container_registry %} on {% data variables.product.product_name %}, then{% else %}To authenticate to package registries on {% data variables.product.product_name %},{% endif %} we recommend using the `GITHUB_TOKEN` that {% data variables.product.product_name %} automatically creates for your repository when you enable {% data variables.product.prodname_actions %} instead of a personal access token for authentication. この`GITHUB_TOKEN`は、現在のリポジトリに対する`read:packages`及び`write:packages`スコープを持ちます。 フォークの場合、このトークンは親のリポジトリへの`read:packages`スコープも持ちます。 +{% if currentVersion == "free-pro-team@latest" %}If you want your workflow to authenticate to {% data variables.product.prodname_registry %} to access a package registry other than the {% data variables.product.prodname_container_registry %} on {% data variables.product.product_name %}, then{% else %}To authenticate to package registries on {% data variables.product.product_name %},{% endif %} we recommend using the `GITHUB_TOKEN` that {% data variables.product.product_name %} automatically creates for your repository when you enable {% data variables.product.prodname_actions %} instead of a personal access token for authentication. The `GITHUB_TOKEN` has `read:packages` and `write:packages` scopes to the current repository. For forks, the token also has the `read:packages` scope for the parent repository. -{% raw %}`{{secrets.GITHUB_TOKEN}}`{% endraw %}コンテキストを使って、ワークフロー中でこの`GITHUB_TOKEN`を参照できます。 詳しい情報については「[GITHUB_TOKENでの認証](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)」を参照してください。 +You can reference the `GITHUB_TOKEN` in your workflow file using the {% raw %}`{{secrets.GITHUB_TOKEN}}`{% endraw %} context. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)." -### アクションを使ったパッケージの公開 +### Publishing a package using an action -{% data variables.product.prodname_actions %}を使い、継続的インテグレーション（CI）ワークフローの一部としてパッケージを公開できます。 たとえば、開発者がデフォルトブランチにコードを公開するたびにワークフローでCIテストが実行されるようにワークフローを構成することができます。 それらのテストをパスすれば、ワークフローは新しいパッケージバージョンを{% data variables.product.prodname_registry %}に公開します。 このワークフローは、コードが品質基準を満たしている場合にのみ新しいパッケージバージョンの作成を自動化します、 +You can publish packages as part of your continuous integration (CI) flow using {% data variables.product.prodname_actions %}. For example, you could configure a workflow so that anytime a developer pushes code to the default branch, the workflow runs CI tests. If those tests pass, the workflow publishes a new package version to {% data variables.product.prodname_registry %}. This workflow automates the creation of new package versions only if the code meets your quality standards. {% data reusables.package_registry.actions-configuration %} -### アクションを使ったパッケージのインストール +### Installing a package using an action -{% data variables.product.prodname_actions %}を使い、CIフローの一部としてパッケージをインストールできます。 たとえば、開発者がコードをプルリクエストにプッシュすると、いつでもワークフローが{% data variables.product.prodname_registry %}によってホストされているパッケージをダウンロードしてインストールすることで、依存関係を解決するようにワークフローを設定できます。 そして、ワークフローはその依存関係を必要とするCIテストを実行できます。 +You can install packages as part of your CI flow using {% data variables.product.prodname_actions %}. For example, you could configure a workflow so that anytime a developer pushes code to a pull request, the workflow resolves dependencies by downloading and installing packages hosted by {% data variables.product.prodname_registry %}. Then, the workflow can run CI tests that require the dependencies. -{% data variables.product.prodname_actions %}を通じて{% data variables.product.prodname_registry %}がホストしているパッケージをインストールするには、`GITHUB_TOKEN`を使う事によって最小限の設定もしくは追加の認証が必要です。 アクションがパッケージをインストールする場合、データ転送も無料です。 詳しい情報については、「[{% data variables.product.prodname_registry %}の支払いについて](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)」を参照してください。 +Installing packages hosted by {% data variables.product.prodname_registry %} through {% data variables.product.prodname_actions %} requires minimal configuration or additional authentication when you use `GITHUB_TOKEN`.{% if currentVersion == "free-pro-team@latest" %} Data transfer is also free when an action installs a package. For more information, see "[About billing for {% data variables.product.prodname_registry %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)."{% endif %} {% if currentVersion == "free-pro-team@latest" %} -`GITHUB_TOKEN`は、アクションが実行されるリポジトリ以外のプライベートリポジトリからパッケージをインストールすることはできません。 You cannot currently use `GITHUB_TOKEN` to authenticate to {% data variables.product.prodname_github_container_registry %}. +`GITHUB_TOKEN` cannot install packages from any private repository besides the repository where the action runs. You cannot currently use `GITHUB_TOKEN` to authenticate to {% data variables.product.prodname_github_container_registry %}. {% endif %} {% data reusables.package_registry.actions-configuration %} diff --git a/translations/ja-JP/content/rest/guides/basics-of-authentication.md b/translations/ja-JP/content/rest/guides/basics-of-authentication.md index 511afaf50e1f..a8c9bb881347 100644 --- a/translations/ja-JP/content/rest/guides/basics-of-authentication.md +++ b/translations/ja-JP/content/rest/guides/basics-of-authentication.md @@ -11,7 +11,6 @@ versions: --- - このセクションでは、認証の基本に焦点を当てます。 具体的には、アプリケーションの[ウェブフロー][webflow]を実装した、([Sinatra][Sinatra] を使う) Rubyサーバーを、いくつかの方法で作成します。 {% tip %} @@ -24,7 +23,7 @@ versions: まず、[アプリケーションの登録][new oauth app]が必要です。 登録された各 OAuth アプリケーションには、一意のクライアント ID とクライアントシークレットが割り当てられます。 クライアントシークレットは共有しないでください。 共有には、文字列をリポジトリにチェックインすることも含まれます。 -どのような情報を入力しても構いませんが、**認証コールバック URL** は例外です。 これが、アプリケーションの設定にあたってもっとも重要な情報と言えるでしょう。 認証の成功後に {% data variables.product.product_name %} がユーザに返すのは、コールバック URL なのです。 +どのような情報を入力しても構いませんが、**認証コールバック URL** は例外です。 これが、アプリケーションの設定にあたってもっとも重要な情報と言えるでしょう。 認証の成功後に {% data variables.product.product_name %} がユーザに返すのは、コールバックURLなのです。 通常の Sinatra サーバーを実行しているので、ローカルインスタンスの場所は `http://localhost:4567` に設定されています。 コールバック URL を `http://localhost:4567/callback` と入力しましょう。 @@ -47,7 +46,9 @@ get '/' do end ``` -クライアント ID とクライアントシークレットは、[アプリケーションの設定ページ][app settings]から取得されます。 これらの値は、{% data variables.product.product_name %} やその他あらゆる公開の場には、**決して_保存しないでください_**。 これらの値は、[環境変数][about env vars]として保存することをお勧めします。この例でも、そのようにしています。 +クライアント ID とクライアントシークレットは、[アプリケーションの設定ページ][app settings]から取得されます。 You should **never, _ever_** store these values in +{% data variables.product.product_name %}--or any other public place, for that matter. We recommend storing them as +[environment variables][about env vars]--which is exactly what we've done here. 次に、_views/index.erb_に以下の内容を貼り付けてください。 @@ -105,7 +106,7 @@ end #### 付与されたスコープの確認 -将来的に、ユーザは[あなたがリクエストしたスコープを編集][edit scopes post]できるようになり、アプリケーションのアクセス権は、最初に要求したものより少なくなるかもしれません。 ですから、このトークンでリクエストを行う前に、ユーザからトークンに付与されたスコープを確認すべきです。 +Users can edit the scopes you requested by directly changing the URL. This can grant your application less access than you originally asked for. Before making any requests with the token, check the scopes that were granted for the token by the user. For more information about requested and granted scopes, see "[Scopes for OAuth Apps](/developers/apps/scopes-for-oauth-apps#requested-scopes-and-granted-scopes)." 付与されたスコープは、トークンの交換によるレスポンスの一部として返されます。 @@ -127,7 +128,7 @@ end リクエストを行う前にのみスコープを確認するだけでは不十分です。確認時と実際のリクエスト時の間に、ユーザがスコープを変更する可能性があります。 このような場合には、成功すると思っていたAPIの呼び出しが`404`または`401`ステータスになって失敗したり、情報の別のサブセットを返したりします。 -この状況にうまく対応できるように、有効なトークンによるリクエストに対するすべてのAPIレスポンスには、[`X-OAuth-Scopes`ヘッダ][oauth scopes]も含まれています。 このヘッダには、リクエストを行うために使用されたトークンのスコープのリストが含まれています。 それに加えて、OAuthアプリケーションAPIは、{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}\[check a token for validity\]\[/v3/apps/oauth_applications/#check-a-token\]{% else %}\[check a token for validity\]\[/v3/apps/oauth_applications/#check-an-authorization\]{% endif %}にエンドポイントを提供します。 この情報を使用してトークンのスコープにおける変更を検出し、利用可能なアプリケーション機能の変更をユーザに通知します。 +この状況にうまく対応できるように、有効なトークンによるリクエストに対するすべてのAPIレスポンスには、[`X-OAuth-Scopes`ヘッダ][oauth scopes]も含まれています。 このヘッダには、リクエストを行うために使用されたトークンのスコープのリストが含まれています。 In addition to that, the OAuth Applications API provides an endpoint to {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} \[check a token for validity\]\[/v3/apps/oauth_applications/#check-a-token\]{% else %}\[check a token for validity\]\[/v3/apps/oauth_applications/#check-an-authorization\]{% endif %}. この情報を使用してトークンのスコープにおける変更を検出し、利用可能なアプリケーション機能の変更をユーザに通知します。 #### 認証リクエストの実施 @@ -171,7 +172,9 @@ erb :basic, :locals => auth_result ウェブページにアクセスするたびに、ユーザにアプリケーションへのログインを求めるというのは非常に悪いモデルです。 たとえば、`http://localhost:4567/basic`に直接移動してみてください。 エラーになるでしょう。 -「ここをクリック」というプロセスをすべてなくし、ユーザが{% data variables.product.product_name %}にログインしている限りそれを_記憶_して、このアプリケーションにアクセスできるとしたらどうでしょうか。 実のところ、_これからやろうとしていること_はまさにそういうことなのです。 +What if we could circumvent the entire "click here" process, and just _remember_ that, as long as the user's logged into +{% data variables.product.product_name %}, they should be able to access this application? Hold on to your hat, +because _that's exactly what we're going to do_. 上記に上げたサーバはかなり単純なものです。 インテリジェントな認証を入れるために、トークンを保存するためセッションを使用するよう切り替えます。 これにより、認証はユーザーに意識されないものになります。 @@ -300,6 +303,5 @@ end [libraries]: /libraries/ [oauth scopes]: /apps/building-oauth-apps/understanding-scopes-for-oauth-apps/ [oauth scopes]: /apps/building-oauth-apps/understanding-scopes-for-oauth-apps/ -[edit scopes post]: https://developer.github.com/changes/2013-10-04-oauth-changes-coming/ [new oauth app]: https://github.com/settings/applications/new [app settings]: https://github.com/settings/developers diff --git a/translations/ja-JP/content/rest/guides/best-practices-for-integrators.md b/translations/ja-JP/content/rest/guides/best-practices-for-integrators.md index f62c9be3ed2c..8b677c3e4b86 100644 --- a/translations/ja-JP/content/rest/guides/best-practices-for-integrators.md +++ b/translations/ja-JP/content/rest/guides/best-practices-for-integrators.md @@ -12,24 +12,23 @@ versions: GitHubプラットフォームとの統合に興味はありますか。 [同じことを思っている仲間がいますよ](https://github.com/integrations)。 このガイドは、ユーザに最高のエクスペリエンスを提供し、かつAPIと確実にやり取りするアプリを構築するために役立ちます。 - ### GitHubから配信されるペイロードの機密を確保する [GitHubから送信されたペイロード][event-types]の機密を確保することは非常に重要です。 ペイロードでパスワードなどの個人情報が送信されることはないものの、いかなる情報であれ漏洩することは好ましくありません。 コミッターのメールアドレスやプライベートリポジトリの名前などは、機密性が求められる場合があります。 いくつかのステップを踏むことで、GitHubから配信されるペイロードを安全に受信できます。 -1. 受信サーバーは必ずHTTPS接続にしてください。 デフォルトでは、GitHubはペイロードを配信する際にSSL証明書を検証します。{% if currentVersion == "free-pro-team@latest" %} +1. 受信サーバーは必ずHTTPS接続にしてください。 By default, GitHub will verify SSL certificates when delivering payloads.{% if currentVersion == "free-pro-team@latest" %} 1. [フック配信時に使用するIPアドレス](/github/authenticating-to-github/about-githubs-ip-addresses)をサーバーの許可リストに追加できます。 正しいIPアドレスを常に確認していることを確かめるため、[`/meta`エンドポイントを使用して](/v3/meta/#meta)GitHubが使用するアドレスを見つけることができます。{% endif %} 1. ペイロードがGitHubから配信されていることを確実に保証するため、[シークレットトークン](/webhooks/securing/)を提供します。 シークレットトークンを強制することにより、サーバーが受信するあらゆるデータが確実にGitHubから来ていることを保証できます。 サービスの*ユーザごと*に異なるシークレットトークンを提供するのが理想的です。 そうすれば、1つのトークンが侵害されても、他のユーザは影響を受けません。 ### 同期作業より非同期作業を優先する -GitHubは、webhookペイロードを受信後{% if currentVersion == "free-pro-team@latest" %}10{% else %}30{% endif %}秒以内にインテグレーションが応答することを求めています。 サービスの応答時間がそれ以上になると、GitHubは接続を中止し、ペイロードは失われます。 +GitHub expects that integrations respond within {% if currentVersion == "free-pro-team@latest" %}10{% else %}30{% endif %} seconds of receiving the webhook payload. サービスの応答時間がそれ以上になると、GitHubは接続を中止し、ペイロードは失われます。 サービスの完了時間を予測することは不可能なので、「実際の作業」のすべてはバックグラウンドジョブで実行すべきです。 バックグラウンドジョブのキューや処理を扱えるライブラリには、[Resque](https://github.com/resque/resque/) (Ruby用)、[RQ](http://python-rq.org/) (Python用)、[RabbitMQ](http://www.rabbitmq.com/)などがあります。 -バックグラウンドジョブが実行中でも、GitHubはサーバが{% if currentVersion == "free-pro-team@latest" %}10{% else %}30{% endif %}秒以内で応答することを求めていることに注意してください。 サーバは何らかの応答を送信することにより、ペイロードの受信を確認する必要があります。 サービスがペイロードについての確認を可能な限り速やかに行うことは非常に重要です。そうすることにより、サーバがリクエストを継続するかどうか正確に報告できます。 +Note that even with a background job running, GitHub still expects your server to respond within {% if currentVersion == "free-pro-team@latest" %}ten{% else %}thirty{% endif %} seconds. サーバは何らかの応答を送信することにより、ペイロードの受信を確認する必要があります。 サービスがペイロードについての確認を可能な限り速やかに行うことは非常に重要です。そうすることにより、サーバがリクエストを継続するかどうか正確に報告できます。 ### GitHubへの応答時に適切なHTTPステータスコードを使用する diff --git a/translations/ja-JP/content/rest/guides/delivering-deployments.md b/translations/ja-JP/content/rest/guides/delivering-deployments.md index a0ba166179d4..838f40068cae 100644 --- a/translations/ja-JP/content/rest/guides/delivering-deployments.md +++ b/translations/ja-JP/content/rest/guides/delivering-deployments.md @@ -1,6 +1,6 @@ --- title: デプロイメントを配信する -intro: Deployment REST APIを使用すると、サーバーおよびサードパーティアプリケーションとやり取りするカスタムツールを構築できます。 +intro: 'Deployment REST APIを使用すると、サーバーおよびサードパーティアプリケーションとやり取りするカスタムツールを構築できます。' redirect_from: - /guides/delivering-deployments/ - /guides/automating-deployments-to-integrators/ @@ -12,7 +12,7 @@ versions: -[Deployment API][deploy API]は、{% data variables.product.product_name %}にホストされたプロジェクトが、あなたのサーバーで起動できるようにします。 [Status API][status API]と組み合わせれば、コードが`master`に到着してからすぐにデプロイメントを調整できるようになります。 +[Deployment API][deploy API]は、{% data variables.product.product_name %}にホストされたプロジェクトが、あなたのサーバーで起動できるようにします。 Combined with [the Status API][status API], you'll be able to coordinate your deployments the moment your code lands on the default branch. このAPIでは、ステータスAPIを使って、利用できる設定を示します。 このシナリオでは、以下を行います。 diff --git a/translations/ja-JP/content/rest/guides/getting-started-with-the-checks-api.md b/translations/ja-JP/content/rest/guides/getting-started-with-the-checks-api.md index 6ad95f25c637..6917f062a928 100644 --- a/translations/ja-JP/content/rest/guides/getting-started-with-the-checks-api.md +++ b/translations/ja-JP/content/rest/guides/getting-started-with-the-checks-api.md @@ -1,6 +1,6 @@ --- title: Checks APIを使ってみる -intro: Check Runs APIを使うと、リポジトリのコード変更に対して強力なチェックを実行するGitHub Appを構築できます。 継続的インテグレーション、コードの構文チェック、コードのスキャンサービスを実行し、コミットについて詳細なフィードバックを行うアプリを作成できます。 +intro: 'Check Runs APIを使うと、リポジトリのコード変更に対して強力なチェックを実行するGitHub Appを構築できます。 継続的インテグレーション、コードの構文チェック、コードのスキャンサービスを実行し、コミットについて詳細なフィードバックを行うアプリを作成できます。' versions: free-pro-team: '*' enterprise-server: '*' @@ -37,8 +37,8 @@ GitHub Appは、単に合格/不合格の二択ではない、情報量の多い ![チェック実行のワークフロー](/assets/images/check_runs.png) {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -チェック実行が15日以上にわたり不完全な状態である場合は、チェック実行の`conclusion`が`stale`になり、{% data variables.product.prodname_dotcom %}に状態が -{% octicon "issue-reopened" aria-label="The issue-reopened icon" %}. {% data variables.product.prodname_dotcom %}のみが、チェック実行を`stale`としてマークできます。 チェック実行で出る可能性がある結果についての詳細は、 [`conclusion`パラメータ](/rest/reference/checks#create-a-check-run--parameters)を参照してください。 +If a check run is in a incomplete state for more than 14 days, then the check run's `conclusion` becomes `stale` and appears on +{% data variables.product.prodname_dotcom %} as stale with {% octicon "issue-reopened" aria-label="The issue-reopened icon" %}. {% data variables.product.prodname_dotcom %}のみが、チェック実行を`stale`としてマークできます。 チェック実行で出る可能性がある結果についての詳細は、 [`conclusion`パラメータ](/rest/reference/checks#create-a-check-run--parameters)を参照してください。 {% endif %} [`check_suite`](/webhooks/event-payloads/#check_suite) webhookを受け取ったら、チェックが完了していなくてもすぐにチェック実行を作成できます。 チェック実行の`status`は、`queued`、`in_progress`、または`completed`の値で更新でき、より詳細を明らかにして`output`を更新できます。 チェック実行にはタイムスタンプ、詳細情報が記載された外部サイトへのリンク、コードの特定の行に対するアノテーション、および実行した分析についての情報を含めることができます。 diff --git a/translations/ja-JP/content/rest/guides/getting-started-with-the-git-database-api.md b/translations/ja-JP/content/rest/guides/getting-started-with-the-git-database-api.md index 34b88f3b4597..fe40427ba790 100644 --- a/translations/ja-JP/content/rest/guides/getting-started-with-the-git-database-api.md +++ b/translations/ja-JP/content/rest/guides/getting-started-with-the-git-database-api.md @@ -32,14 +32,14 @@ Gitオブジェクトデータベースについての詳細は、Pro Gitブッ {% warning %} -**警告:** Git refを`merge`するためにGitディレクトリや{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}[`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference){% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}[`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference){% endif %}に依存しないでください。こうしたコンテンツが古くて使えなくなっても警告されません。 +**Warning!** Please do not depend on using Git directly or [`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference) for updates to `merge` Git refs, because this content becomes outdated without warning. {% endwarning %} _test_マージコミットを作成するには、使用するAPIは、明示的にプルリクエストを要求する必要があります。 _test_マージコミットは、UIでプルリクエストを表示して [Merge] ボタンが表示されるか、REST APIを使ってプルリクエストを[取得](/v3/pulls/#get-a-pull-request)、[作成](/v3/pulls/#create-a-pull-request)、または[編集](/v3/pulls/#update-a-pull-request)した際に作成されます。 このリクエストがなければ、`merge` Git refは次に誰かがプルリクエストを表示するまで期限切れになります。 -期限切れの`merge` Git refを生成するポーリングメソッドを現在使用している場合、GitHubでは以下のステップに従い、ベースブランチ (通常は`master`) から最新の変更を取得することをお勧めします。 +If you are currently using polling methods that produce outdated `merge` Git refs, then GitHub recommends using the following steps to get the latest changes from the default branch: 1. プルリクエストwebhookを受け取ります。 2. [`GET /repos/{owner}/{repo}/pulls/{pull_number}`](/v3/pulls/#get-a-pull-request)を呼び出し、マージコミット候補を作成するためのバックグラウンドジョブを開始します。 -3. `mergeable`属性が`true`か`false`かを判断するため、[`GET /repos/{owner}/{repo}/pulls/{pull_number}`](/v3/pulls/#get-a-pull-request)を使用してリポジトリをポーリングします。 上記のステップを実行後にのみ、Git refsを更新して`merge`するため、Gitディレクトリや{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}[`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference){% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}[`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference){% endif %}を使用することができます。 +3. `mergeable`属性が`true`か`false`かを判断するため、[`GET /repos/{owner}/{repo}/pulls/{pull_number}`](/v3/pulls/#get-a-pull-request)を使用してリポジトリをポーリングします。 You can use Git directly or [`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference) for updates to `merge` Git refs only after performing the previous steps. diff --git a/translations/ja-JP/content/rest/guides/getting-started-with-the-rest-api.md b/translations/ja-JP/content/rest/guides/getting-started-with-the-rest-api.md index f43c24f74546..91e2d1fe6e29 100644 --- a/translations/ja-JP/content/rest/guides/getting-started-with-the-rest-api.md +++ b/translations/ja-JP/content/rest/guides/getting-started-with-the-rest-api.md @@ -1,6 +1,6 @@ --- title: REST APIを使ってみる -intro: 認証とエンドポイントの例から始めて、REST APIを使用するための基礎を学びます。 +intro: '認証とエンドポイントの例から始めて、REST APIを使用するための基礎を学びます。' redirect_from: - /guides/getting-started/ - /v3/guides/getting-started @@ -10,14 +10,13 @@ versions: --- - 日常的なユースケースに取り組みながら、APIの中心的な概念を見ていきましょう。 ### 概要 ほとんどのアプリケーションは、任意の言語において既存の[ラッパーライブラリ][wrappers]を使用しています。ただ、まずは基底となっているAPI HTTPメソッドについて知ることが大切です。 -ちょっと試しにやってみるだけなら、[cURL][curl]を使うのが一番簡単です。{% if currentVersion == "free-pro-team@latest" %}別のクライアントを使用している場合、リクエストで有効な [ユーザエージェントのヘッダ](/rest/overview/resources-in-the-rest-api#user-agent-required)を送信する必要があることに注意してください。{% endif %} +There's no easier way to kick the tires than through [cURL][curl].{% if currentVersion == "free-pro-team@latest" %} If you are using an alternative client, note that you are required to send a valid [User Agent header](/rest/overview/resources-in-the-rest-api#user-agent-required) in your request.{% endif %} #### Hello World @@ -194,7 +193,9 @@ $ curl -i "{% data variables.product.api_url_pre %}/users/octocat/repos?type=own #### リポジトリの作成 -既存のリポジトリ情報をフェッチすることは一般的なユースケースですが、{% data variables.product.product_name %} APIは新規リポジトリの作成もサポートしています。 [リポジトリを作成する][create repo]には、詳細情報や設定オプションを含んだいくつかのJSONを`POST`する必要があります。 +Fetching information for existing repositories is a common use case, but the +{% data variables.product.product_name %} API supports creating new repositories as well. To [create a repository][create repo], +we need to `POST` some JSON containing the details and configuration options. ```shell $ curl -i -H "Authorization: token 5199831f4dd3b79e7c5b7e0ebe75d67aa66e79d4" \ diff --git a/translations/ja-JP/content/rest/guides/index.md b/translations/ja-JP/content/rest/guides/index.md index a02b656431d6..6d2388802b42 100644 --- a/translations/ja-JP/content/rest/guides/index.md +++ b/translations/ja-JP/content/rest/guides/index.md @@ -1,6 +1,6 @@ --- title: ガイド -intro: REST APIおよび認証の初歩や、さまざまなタスクでREST APIを使用する方法について学びましょう。 +intro: 'REST APIおよび認証の初歩や、さまざまなタスクでREST APIを使用する方法について学びましょう。' redirect_from: - /guides/ - /v3/guides diff --git a/translations/ja-JP/content/rest/guides/rendering-data-as-graphs.md b/translations/ja-JP/content/rest/guides/rendering-data-as-graphs.md index 06cf567d27c0..484726333d17 100644 --- a/translations/ja-JP/content/rest/guides/rendering-data-as-graphs.md +++ b/translations/ja-JP/content/rest/guides/rendering-data-as-graphs.md @@ -240,7 +240,7 @@ repos.each do |repo| end ``` -そこから、見つかった各言語を"master list"に次々に追加していきます。 +From there, we'll cumulatively add each language found to a list of languages: ``` ruby repo_langs.each do |lang, count| diff --git a/translations/ja-JP/content/rest/guides/traversing-with-pagination.md b/translations/ja-JP/content/rest/guides/traversing-with-pagination.md index 67784641106b..864aa77edce3 100644 --- a/translations/ja-JP/content/rest/guides/traversing-with-pagination.md +++ b/translations/ja-JP/content/rest/guides/traversing-with-pagination.md @@ -11,9 +11,9 @@ versions: -{% data variables.product.product_name %} API は、開発者が利用できる膨大な量の情報を提供します。 ほとんどの場合は、要求している情報が_多すぎる_ということに気付くかもしれません。サーバーに負担をかけすぎないため、API は自動的に[リクエストされたアイテムをページネーション][pagination]します。 +{% data variables.product.product_name %} APIは、開発者が消費するための膨大な情報を提供します。 ほとんどの場合は、要求している情報が_多すぎる_ということに気付くかもしれません。サーバーに負担をかけすぎないため、API は自動的に[リクエストされたアイテムをページネーション][pagination]します。 -このガイドでは、{% data variables.product.product_name %} Search API を呼び出し、ページネーションを使って結果を反復処理します。 このプロジェクトの完全なソースコードは、[platform-samples][platform samples]リポジトリにあります。 +このガイドでは、{% data variables.product.product_name %} Search APIを呼び出し、ページネーションを使って結果を反復処理します。 このプロジェクトの完全なソースコードは、[platform-samples][platform samples]リポジトリにあります。 ### ページネーションの基本 diff --git a/translations/ja-JP/content/rest/guides/working-with-comments.md b/translations/ja-JP/content/rest/guides/working-with-comments.md index 4b6aefbb9ef7..dc120a7c4bbc 100644 --- a/translations/ja-JP/content/rest/guides/working-with-comments.md +++ b/translations/ja-JP/content/rest/guides/working-with-comments.md @@ -1,6 +1,6 @@ --- title: コメントを扱う -intro: REST API を使用すると、プルリクエスト、Issue、およびコミットにある、コメントにアクセスして管理できます。 +intro: 'REST API を使用すると、プルリクエスト、Issue、およびコミットにある、コメントにアクセスして管理できます。' redirect_from: - /guides/working-with-comments/ - /v3/guides/working-with-comments diff --git a/translations/ja-JP/content/rest/overview/api-previews.md b/translations/ja-JP/content/rest/overview/api-previews.md index b05441f40c96..84c2ef0ac5bc 100644 --- a/translations/ja-JP/content/rest/overview/api-previews.md +++ b/translations/ja-JP/content/rest/overview/api-previews.md @@ -10,7 +10,6 @@ versions: --- - API プレビューを使用すると、正式に GitHub API の一部になる前に、新しい API や既存の API メソッドへの変更を試すことができます。 プレビュー期間中は、開発者からのフィードバックに基づいて機能を変更することがあります。 変更をする際には、事前の通知なく[開発者blog](https://developer.github.com/changes/)でアナウンスします。 @@ -27,7 +26,7 @@ GitHub ユーザまたは Organization アカウントからリポジトリを ### 強化されたデプロイメント -より多くの情報と細かい粒度で、[デプロイメント](/v3/repos/deployments/)をより詳細に制御します。 +より多くの情報と細かい粒度で、[デプロイメント](/rest/reference/repos#deployments)をより詳細に制御します。 **カスタムメディアタイプ:** `ant-man-preview` **発表日:** [2016-04-06](https://developer.github.com/changes/2016-04-06-deployment-and-deployment-status-enhancements/) @@ -43,14 +42,6 @@ Issue またはプルリクエストの[イベントのリスト](/v3/issues/tim **カスタムメディアタイプ:** `mockingbird-preview` **発表日:** [2016-05-23](https://developer.github.com/changes/2016-05-23-timeline-preview-api/) -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -### ページ - -[GitHub Pages](/v3/repos/pages/) サイトの詳細情報を取得します。 - -**カスタムメディアタイプ:** `mister-fantastic-preview` **発表日:** [2016-07-06](https://developer.github.com/changes/2016-07-06-github-pages-preview-api/) -{% endif %} - {% if currentVersion != "free-pro-team@latest" %} ### pre-receive 環境 @@ -120,9 +111,9 @@ API を介して[インテグレーション](/early-access/integrations/)を管 ### グローバル webhook -[Organization](/webhooks/event-payloads/#organization) および[ユーザ](/webhooks/event-payloads/#user)イベントタイプの[グローバル webhook](/v3/enterprise-admin/global_webhooks/) を有効にします。 この API プレビューは {% data variables.product.prodname_ghe_server %} でのみ使用できます。 +[Organization](/webhooks/event-payloads/#organization) および[ユーザ](/webhooks/event-payloads/#user)イベントタイプの[グローバル webhook](/rest/reference/enterprise-admin#global-webhooks/) を有効にします。 この API プレビューは {% data variables.product.prodname_ghe_server %} でのみ使用できます。 -**カスタムメディアタイプ:** `superpro-preview` **発表日:** [2017-12-12](/v3/enterprise-admin/global_webhooks) +**カスタムメディアタイプ:** `superpro-preview` **発表日:** [2017-12-12](/rest/reference/enterprise-admin#global-webhooks) {% endif %} @@ -142,15 +133,6 @@ API を介して[インテグレーション](/early-access/integrations/)を管 **カスタムメディアタイプ:** `sailor-v-preview` **発表日:** [2018-01-10](https://developer.github.com/changes/2018-01-10-lock-reason-api-preview) {% endif %} -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -### Team ディスカッション - -API を使用して、[Team ディスカッション](/v3/teams/discussions)と [Team ディスカッションコメント](/v3/teams/discussion_comments)を管理できるようになりました。 - -**カスタムメディアタイプ:** `echo-preview` **発表日:** [2018-02-07](https://developer.github.com/changes/2018-02-07-team-discussions-api) - -{% endif %} - ### 署名済みコミットの必須化 これで、API を使用して、[保護されたブランチで署名済みコミットを必須にする](/v3/repos/branches)ための設定を管理できます。 @@ -172,11 +154,13 @@ API を使用して、プルリクエストに対して[複数の承認レビュ {% endif %} +{% if currentVersion ver_lt "enterprise-server@2.23" %} ### チェック実行とチェックスイート API GitHub App がリポジトリのコードに対して外部チェックを実行できるようにします。 詳細については、[チェック実行](/v3/checks/runs/)と[チェックスイート](/v3/checks/suites/) API をご覧ください。 **カスタムメディアタイプ:** `antiope-preview` **発表日:** [2018-05-07](https://developer.github.com/changes/2018-05-07-new-checks-api-public-beta/) +{% endif %} {% if currentVersion != "free-pro-team@latest" %} @@ -206,7 +190,7 @@ GitHub App マニフェストを使用すると、事前設された GitHub App ### デプロイメントステータス -[デプロイメントステータス](/v3/repos/deployments/#create-a-deployment-status)の`環境`を更新し、`in_progress` および `queued` ステータスを使用できるようになりました。 デプロイメントステータスを作成するときに、`auto_inactive` パラメータを使用して、古い`本番`デプロイメントを `inactive` としてマークできるようになりました。 +[デプロイメントステータス](/rest/reference/repos#create-a-deployment-status)の`環境`を更新し、`in_progress` および `queued` ステータスを使用できるようになりました。 デプロイメントステータスを作成するときに、`auto_inactive` パラメータを使用して、古い`本番`デプロイメントを `inactive` としてマークできるようになりました。 **カスタムメディアタイプ:** `flash-preview` **発表日:** [2018-10-16](https://developer.github.com/changes/2018-10-16-deployments-environments-states-and-auto-inactive-updates/) @@ -243,7 +227,7 @@ Organization メンバーによるリポジトリの作成可否、および作 ### Pages の有効化と無効化 -[Pages API](/v3/repos/pages/) の新しいエンドポイントを使用して、Pages を有効または無効にできます。 Pages の詳細については、「[GitHub Pages の基本](/categories/github-pages-basics) 」を参照してください。 +[Pages API](/rest/reference/repos#pages) の新しいエンドポイントを使用して、Pages を有効または無効にできます。 Pages の詳細については、「[GitHub Pages の基本](/categories/github-pages-basics) 」を参照してください。 **カスタムメディアタイプ:** `switcheroo-preview` **発表日:** [2019-03-14](https://developer.github.com/changes/2019-03-14-enabling-disabling-pages/) diff --git a/translations/ja-JP/content/rest/overview/endpoints-available-for-github-apps.md b/translations/ja-JP/content/rest/overview/endpoints-available-for-github-apps.md index 68d57322a609..8c53afbf9b17 100644 --- a/translations/ja-JP/content/rest/overview/endpoints-available-for-github-apps.md +++ b/translations/ja-JP/content/rest/overview/endpoints-available-for-github-apps.md @@ -11,7 +11,7 @@ versions: {% data variables.product.prodname_github_app %} を使用してエンドポイントにアクセスするには、インストールアクセストークンを使用する必要があります。 詳しい情報については、「[{% data variables.product.prodname_github_apps %} で認証する](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)」を参照してください。 -{% for thing in rest.operationsEnabledForApps[currentVersion] %} +{% for thing in rest.operationsEnabledForGitHubApps[currentVersion] %} {% assign category = thing[0] %} {% assign operations = thing[1] %} {% if operations.size > 0 %} diff --git a/translations/ja-JP/content/rest/overview/other-authentication-methods.md b/translations/ja-JP/content/rest/overview/other-authentication-methods.md index 52611e556827..e0bc13b3f0c9 100644 --- a/translations/ja-JP/content/rest/overview/other-authentication-methods.md +++ b/translations/ja-JP/content/rest/overview/other-authentication-methods.md @@ -9,8 +9,9 @@ versions: --- - -API は複数の認証方式を提供していますが、本番アプリケーションには [OAuth](/apps/building-integrations/setting-up-and-registering-oauth-apps/) を使用することを強くお勧めします。 他の方式は、スクリプトまたはテスト（完全な OAuth では過剰になる場合）に使用するために提供されています。 認証に {% data variables.product.product_name %} を使用するサードパーティのアプリケーションは、{% data variables.product.product_name %} の認証情報を要求または収集してはなりません。 代わりに、[OAuth web フロー](/apps/building-oauth-apps/authorizing-oauth-apps/)を使用してください。 +API は複数の認証方式を提供していますが、本番アプリケーションには [OAuth](/apps/building-integrations/setting-up-and-registering-oauth-apps/) を使用することを強くお勧めします。 他の方式は、スクリプトまたはテスト（完全な OAuth では過剰になる場合）に使用するために提供されています。 Third party applications that rely on +{% data variables.product.product_name %} for authentication should not ask for or collect {% data variables.product.product_name %} credentials. +代わりに、[OAuth web フロー](/apps/building-oauth-apps/authorizing-oauth-apps/)を使用してください。 ### Basic 認証 @@ -77,7 +78,7 @@ $ curl -v -H "Authorization: token TOKEN" {% data variables.product.api 2 要素認証を有効にしている場合、REST API の_ほとんど_のエンドポイントの [Basic 認証](#basic-authentication)では、ユーザ名とパスワードの代わりに個人アクセストークンまたは OAuth トークンを使用する必要があります。 -{% if currentVersion == "free-pro-team@latest" %}[{% data variables.product.product_name %}開発者設定](https://github.com/settings/tokens/new)で{% endif %}新しい個人用アクセストークンを生成するか、OAuth Authorizations APIのエンドポイントで「[新しい認可を生成][create-access]」して新しいOAuthトークンを作成することができます。 詳しい情報については、「[コマンドラインの個人アクセストークンを作成する](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)」を参照してください。 次に、これらのトークンを使って、GitHub API で [OAuth トークンを使用して認証][oauth-auth]します。 ユーザ名とパスワードで認証する必要があるのは、OAuth トークンを作成するとき、または OAuth Authorizations API を使用するときだけです。 +You can generate a new personal access token {% if currentVersion == "free-pro-team@latest" %}with [{% data variables.product.product_name %} developer settings](https://github.com/settings/tokens/new){% endif %} or use the "[Create a new authorization][create-access]" endpoint in the OAuth Authorizations API to generate a new OAuth token. 詳しい情報については、「[コマンドラインの個人アクセストークンを作成する](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)」を参照してください。 次に、これらのトークンを使って、GitHub API で [OAuth トークンを使用して認証][oauth-auth]します。 ユーザ名とパスワードで認証する必要があるのは、OAuth トークンを作成するとき、または OAuth Authorizations API を使用するときだけです。 #### 2 要素認証で OAuth Authorizations API を使用する diff --git a/translations/ja-JP/content/rest/overview/resources-in-the-rest-api.md b/translations/ja-JP/content/rest/overview/resources-in-the-rest-api.md index 121dec991bb2..29d9b4b891db 100644 --- a/translations/ja-JP/content/rest/overview/resources-in-the-rest-api.md +++ b/translations/ja-JP/content/rest/overview/resources-in-the-rest-api.md @@ -11,7 +11,6 @@ versions: 公式の {% data variables.product.product_name %} REST API を構成するリソースについて説明しています。 ご不明な点やご要望がございましたら、{% data variables.contact.contact_support %} までご連絡ください。 - ### 最新バージョン デフォルトでは、`{% data variables.product.api_url_code %}` へのすべてのリクエストが REST API の **v3** [バージョン](/v3/versions)を受け取ります。 [`Accept` ヘッダを介してこのバージョンを明示的にリクエストする](/v3/media/#request-specific-version)ことをお勧めします。 @@ -26,7 +25,7 @@ GitHub の GraphQL API についての情報は、[v4 ドキュメント](/v4) ### スキーマ -{% if currentVersion == "free-pro-team@latest" %}すべての API アクセスは HTTPS 経由で行われ、{% else %}API は{% endif %} `{% data variables.product.api_url_code %}` からアクセスされます。 すべてのデータは +{% if currentVersion == "free-pro-team@latest" %}All API access is over HTTPS, and{% else %}The API is{% endif %} accessed from `{% data variables.product.api_url_code %}`. すべてのデータは JSON として送受信されます。 ```shell @@ -36,7 +35,6 @@ $ curl -i {% data variables.product.api_url_pre %}/users/octocat/orgs > Server: nginx > Date: Fri, 12 Oct 2012 23:33:14 GMT > Content-Type: application/json; charset=utf-8 -> Connection: keep-alive > Status: 200 OK > ETag: "a00049ba79152d03380c34652f2cb612" > X-GitHub-Media-Type: github.v3 diff --git a/translations/ja-JP/content/rest/reference/actions.md b/translations/ja-JP/content/rest/reference/actions.md index 141067e62102..ace06f21332d 100644 --- a/translations/ja-JP/content/rest/reference/actions.md +++ b/translations/ja-JP/content/rest/reference/actions.md @@ -24,6 +24,16 @@ versions: {% if operation.subcategory == 'artifacts' %}{% include rest_operation %}{% endif %} {% endfor %} +## 権限 + +The Permissions API allows you to set permissions for what organizations and repositories are allowed to run {% data variables.product.prodname_actions %}, and what actions are allowed to run. For more information, see "[Usage limits, billing, and administration](/actions/reference/usage-limits-billing-and-administration#disabling-or-limiting-github-actions-for-your-repository-or-organization)." + +You can also set permissions for an enterprise. 詳しい情報については、「[{% data variables.product.prodname_dotcom %} Enterprise 管理](/rest/reference/enterprise-admin#github-actions)」REST API を参照してください。 + +{% for operation in currentRestOperations %} + {% if operation.subcategory == 'permissions' %}{% include rest_operation %}{% endif %} +{% endfor %} + ## シークレット シークレット API では、暗号化されたシークレットに関する情報を作成、更新、削除、および取得できます。 {% data reusables.actions.about-secrets %} 詳しい情報については、「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 @@ -40,7 +50,7 @@ versions: {% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_app %} には、リポジトリの `administration` 権限または Organization の `organization_self_hosted_runners` 権限が必要です。 認証されたユーザがこの API を使用するには、リポジトリまたは Organization への管理者アクセス権が必要です。 -Enterprise のセルフホストランナーを管理できます。 詳しい情報については、「[{% data variables.product.prodname_dotcom %} Enterprise 管理](/rest/reference/enterprise-admin#actions)」REST API を参照してください。 +Enterprise のセルフホストランナーを管理できます。 詳しい情報については、「[{% data variables.product.prodname_dotcom %} Enterprise 管理](/rest/reference/enterprise-admin#github-actions)」REST API を参照してください。 {% for operation in currentRestOperations %} {% if operation.subcategory == 'self-hosted-runners' %}{% include rest_operation %}{% endif %} @@ -52,7 +62,7 @@ Enterprise のセルフホストランナーを管理できます。 詳しい {% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_app %} には、リポジトリの `administration` 権限または Organization の `organization_self_hosted_runners` 権限が必要です。 認証されたユーザがこの API を使用するには、リポジトリまたは Organization への管理者アクセス権が必要です。 -Enterprise のセルフホストランナーグループを管理できます。 詳しい情報については、「[{% data variables.product.prodname_dotcom %} Enterprise 管理](/rest/reference/enterprise-admin#actions)」REST API を参照してください。 +Enterprise のセルフホストランナーグループを管理できます。 詳しい情報については、「[{% data variables.product.prodname_dotcom %} Enterprise 管理](/rest/reference/enterprise-admin##github-actions)」REST API を参照してください。 {% for operation in currentRestOperations %} {% if operation.subcategory == 'self-hosted-runner-groups' %}{% include rest_operation %}{% endif %} diff --git a/translations/ja-JP/content/rest/reference/activity.md b/translations/ja-JP/content/rest/reference/activity.md index 281a648b4fb0..77b4beb38f7f 100644 --- a/translations/ja-JP/content/rest/reference/activity.md +++ b/translations/ja-JP/content/rest/reference/activity.md @@ -15,7 +15,7 @@ versions: イベント API は、{% data variables.product.prodname_dotcom %} イベントへの読み取り専用 API です。 これらのイベントは、サイト上のさまざまなアクティビティストリームを強化します。 -イベント API は、{% data variables.product.product_name %} でのアクティビティによってトリガーされるさまざまなタイプのイベントを返すことができます。 The Events API can return different types of events triggered by activity on {% data variables.product.product_name %}. For more information about the specific events that you can receive from the Events API, see "[{% data variables.product.prodname_dotcom %} Event types](/developers/webhooks-and-events/github-event-types)." 詳しい情報については、「[Issue イベント API](/rest/reference/issues#events)」を参照してください。 +イベント API は、{% data variables.product.product_name %} でのアクティビティによってトリガーされるさまざまなタイプのイベントを返すことができます。 The Events API can return different types of events triggered by activity on {% data variables.product.product_name %}. For more information about the specific events that you can receive from the Events API, see "[{{ site.data.variables.product.prodname_dotcom }} Event types](/developers/webhooks-and-events/github-event-types)." 詳しい情報については、「[Issue イベント API](/rest/reference/issues#events)」を参照してください。 イベントは「ETag」ヘッダでポーリングするために最適化されています。 新しいイベントがトリガーされていない場合は、「304 Not Modified」というレスポンスが表示され、現在のレート制限は変更されません。 また、ポーリングを許可する頻度（秒単位）を指定する「X-Poll-Interval」ヘッダもあります。 サーバー負荷が高い場合、長時間かかることがあります。 ヘッダに従ってください。 @@ -138,19 +138,19 @@ $ -H "If-Modified-Since: Thu, 25 Oct 2012 15:16:27 GMT" 通知を受け取る `reason`（理由）には、次のようなものがあります。 -| 理由名 | 説明 | -| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `assign` | Issue に割り当てられた。 | -| `作者` | スレッドを作成した。 | -| `コメント` | スレッドにコメントした。 | -| `招待` | リポジトリへのコントリビューションへの招待を承諾した。 | -| `manual` | スレッドをサブスクライブした（Issue またはプルリクエストを介して）。 | -| `メンション` | コンテンツで具体的に**@メンション**された。 | -| `review_requested` | 自分、または自分が所属している Team が、プルリクエストのレビューを求められた。{% if currentVersion == "free-pro-team@latest" %} +| 理由名 | 説明 | +| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `assign` | Issue に割り当てられた。 | +| `作者` | スレッドを作成した。 | +| `コメント` | スレッドにコメントした。 | +| `招待` | リポジトリへのコントリビューションへの招待を承諾した。 | +| `manual` | スレッドをサブスクライブした（Issue またはプルリクエストを介して）。 | +| `メンション` | コンテンツで具体的に**@メンション**された。 | +| `review_requested` | You, or a team you're a member of, were requested to review a pull request.{% if currentVersion == "free-pro-team@latest" %} | `security_alert` | {% data variables.product.prodname_dotcom %} が、リポジトリに[セキュリティの脆弱性](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)を発見した。{% endif %} -| `state_change` | スレッドの状態を変更した（たとえば、Issue をクローズしたり、プルリクエストをマージしたりした）。 | -| `subscribed` | リポジトリを Watch している。 | -| `team_mention` | メンションされた Team に所属していた。 | +| `state_change` | スレッドの状態を変更した（たとえば、Issue をクローズしたり、プルリクエストをマージしたりした）。 | +| `subscribed` | リポジトリを Watch している。 | +| `team_mention` | メンションされた Team に所属していた。 | `reason` はスレッドごとに変更され、後の通知の `reason` が異なる場合は変更される可能性があることに注意してください。 diff --git a/translations/ja-JP/content/rest/reference/apps.md b/translations/ja-JP/content/rest/reference/apps.md index 39fd2678dfec..996fefb712ff 100644 --- a/translations/ja-JP/content/rest/reference/apps.md +++ b/translations/ja-JP/content/rest/reference/apps.md @@ -35,9 +35,7 @@ REST API v3 エンドポイントのサブセットでは、GitHub App のイン Installations API を使用すると、GitHub App のインストールに関する情報を取得して、それらのインストール内でアクションを実行できます。 _インストレーション_とは、アプリケーションをインストールしたユーザまたは Organization のアカウントを指します。 インストレーションとして認証し、特定のリポジトリへのアクセスを制限する方法については、「[インストレーションとして認証する](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)」を参照してください。 -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} Organization のすべての GitHub App インストレーションを一覧表示するには、「[Organization のアプリケーションインストールの一覧表示](/v3/orgs/#list-app-installations-for-an-organization)」を参照してください。 -{% endif %} {% for operation in currentRestOperations %} {% if operation.subcategory == 'installations' %}{% include rest_operation %}{% endif %} diff --git a/translations/ja-JP/content/rest/reference/code-scanning.md b/translations/ja-JP/content/rest/reference/code-scanning.md new file mode 100644 index 000000000000..42f1f093fec7 --- /dev/null +++ b/translations/ja-JP/content/rest/reference/code-scanning.md @@ -0,0 +1,14 @@ +--- +title: Code scanning +redirect_from: + - /v3/code-scanning +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta %} + +The {% data variables.product.prodname_code_scanning %} API lets you retrieve and update code scanning alerts from a repository. You can use the endpoints to create automated reports for the code scanning alerts in an organization or upload analysis results generated using offline code scanning tools. For more information, see "[Finding security vulnerabilities and errors in your code](/github/finding-security-vulnerabilities-and-errors-in-your-code)." + +{% include rest_operations_at_current_path %} diff --git a/translations/ja-JP/content/rest/reference/enterprise-admin.md b/translations/ja-JP/content/rest/reference/enterprise-admin.md index ee76f003ce83..41ed2381ac2e 100644 --- a/translations/ja-JP/content/rest/reference/enterprise-admin.md +++ b/translations/ja-JP/content/rest/reference/enterprise-admin.md @@ -9,7 +9,7 @@ versions: enterprise-server: '*' --- -You can use these {% data variables.product.prodname_ghe_cloud %} endpoints to administer your enterprise account. +You can use these {{ site.data.variables.product.prodname_ghe_cloud }} endpoints to administer your enterprise account. {% if currentVersion == "free-pro-team@latest" %} @@ -39,7 +39,7 @@ http(s)://hostname/ ### 認証 -{% data variables.product.product_name %} のインストールの API エンドポイントは、GitHub.com APIと[同じ認証方法](/rest/overview/resources-in-the-rest-api#authentication)を受け入れます。 **[OAuth トークン](/apps/building-integrations/setting-up-and-registering-oauth-apps/)**（[認証 API](/rest/reference/oauth-authorizations#create-a-new-authorization) を使用して作成可能）または **[Basic 認証](/rest/overview/resources-in-the-rest-api#basic-authentication)**で自分自身を認証できます。 {% if currentVersion != "free-pro-team@latest" %}Enterprise 固有のエンドポイントで使用する場合、OAuthトークンには `site_admin` [OAuth スコープ](/developers/apps/scopes-for-oauth-apps#available-scopes)が必要です。{% endif %} +{% data variables.product.product_name %} のインストールの API エンドポイントは、GitHub.com APIと[同じ認証方法](/rest/overview/resources-in-the-rest-api#authentication)を受け入れます。 **[OAuth トークン](/apps/building-integrations/setting-up-and-registering-oauth-apps/)**（[認証 API](/rest/reference/oauth-authorizations#create-a-new-authorization) を使用して作成可能）または **[Basic 認証](/rest/overview/resources-in-the-rest-api#basic-authentication)**で自分自身を認証できます。 {% if currentVersion != "free-pro-team@latest" %} OAuth tokens must have the `site_admin` [OAuth scope](/developers/apps/scopes-for-oauth-apps#available-scopes) when used with Enterprise-specific endpoints.{% endif %} Enterprise 管理 API エンドポイントには、認証された {% data variables.product.product_name %} サイト管理者のみがアクセスできます。ただし、[Management Console のパスワード](/enterprise/admin/articles/accessing-the-management-console/)が必要な [Management Console](#management-console) API は除きます。 @@ -124,11 +124,10 @@ GET /scim/v2/enterprises/{enterprise}/Users/{scim_user_id} ### サポートされている SCIM グループ属性 -| 名前 | 種類 | 説明 | -| ------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 名前 | 種類 | 説明 | +| ------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `displayName` | `string` | SCIM グループの名前。対応する {% data variables.product.product_name %} Organization の名前と完全に一致する必要があります。 たとえば、Organization の URL が `https://github.com/octo-org` の場合、グループ名は `octo-org` である必要があります。 | -| `members` | `array` | グループのメンバーである SCIM ユーザ ID の一覧。 | - +| `members` | `array` | グループのメンバーである SCIM ユーザ ID の一覧。 | {% for operation in currentRestOperations %} {% if operation.subcategory == 'scim' %}{% include rest_operation %}{% endif %} @@ -245,13 +244,13 @@ pre-receive 環境 API を使用すると、pre-receive フックの環境を作 #### pre-receive 環境 -| 名前 | 種類 | 説明 | -| --------------------- | --------- | ------------------------------------------------------------------------------ | -| `name` | `string` | UI に表示される環境の名前。 | -| `image_url` | `string` | ダウンロードおよび抽出される tarball への URL。 | +| 名前 | 種類 | 説明 | +| --------------------- | --------- | ------------------------------------------------------------------------- | +| `name` | `string` | UI に表示される環境の名前。 | +| `image_url` | `string` | ダウンロードおよび抽出される tarball への URL。 | | `default_environment` | `boolean` | これが {% data variables.product.prodname_ghe_server %} に同梱されるデフォルト環境かどうか。 | -| `download` | `オブジェクト` | この環境のダウンロードステータス。 | -| `hooks_count` | `整数` | この環境を使用する pre-receive フックの数。 | +| `download` | `オブジェクト` | この環境のダウンロードステータス。 | +| `hooks_count` | `整数` | この環境を使用する pre-receive フックの数。 | #### pre-receive 環境のダウンロード diff --git a/translations/ja-JP/content/rest/reference/gists.md b/translations/ja-JP/content/rest/reference/gists.md index 50a59efa7b42..e93581b893ae 100644 --- a/translations/ja-JP/content/rest/reference/gists.md +++ b/translations/ja-JP/content/rest/reference/gists.md @@ -9,7 +9,7 @@ versions: ### 認証 -パブリック Gist {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "2.9" %} を読んで、トークンなしで匿名ユーザ向けに作成できます。{% else %} 匿名でも、Gist を作成するには GitHub にサインインする必要があります。{% endif %}ユーザに代わって Gist を読み書きするには、Gist OAuth スコープとトークンが必要です。 詳しい情報については、「[OAuth App のスコープ](/developers/apps/scopes-for-oauth-apps)」を参照してください。 +You can read public gists {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "2.9" %}and create them for anonymous users without a token.{% else %} anonymously, but you must be signed into GitHub to create gists.{% endif %} To read or write gists on a user's behalf, you need the gist OAuth scope and a token. 詳しい情報については、「[OAuth App のスコープ](/developers/apps/scopes-for-oauth-apps)」を参照してください。 diff --git a/translations/ja-JP/content/rest/reference/interactions.md b/translations/ja-JP/content/rest/reference/interactions.md index 9f36db9fcd79..f99aceb5e783 100644 --- a/translations/ja-JP/content/rest/reference/interactions.md +++ b/translations/ja-JP/content/rest/reference/interactions.md @@ -28,9 +28,9 @@ OrganizationのインタラクションAPIを使用すると、Organizationの リポジトリのインタラクションAPIを使用すると、オーナーまたは管理者アクセス権のあるユーザはパブリックリポジトリでコメント、Issueのオープン、プルリクエストの作成ができるユーザを一時的に制限することができます。 {% data reusables.interactions.interactions-detail %} {% data variables.product.product_name %} ユーザのグループについては以下を参照してください。 -* リポジトリの{% data reusables.interactions.existing-user-limit-definition %} -* リポジトリの{% data reusables.interactions.contributor-user-limit-definition %} -* リポジトリの{% data reusables.interactions.collaborator-user-limit-definition %} +* {% data reusables.interactions.existing-user-limit-definition %} in the repository. +* {% data reusables.interactions.contributor-user-limit-definition %} in the repository. +* {% data reusables.interactions.collaborator-user-limit-definition %} in the repository. {% for operation in currentRestOperations %} {% if operation.subcategory == 'repos' %}{% include rest_operation %}{% endif %} diff --git a/translations/ja-JP/content/rest/reference/licenses.md b/translations/ja-JP/content/rest/reference/licenses.md index e06955114d71..b1d1587184ce 100644 --- a/translations/ja-JP/content/rest/reference/licenses.md +++ b/translations/ja-JP/content/rest/reference/licenses.md @@ -18,8 +18,8 @@ versions: - [リポジトリの Get](/v3/repos/#get-a-repository) - [ユーザのリポジトリの一覧表示](/v3/repos/#list-repositories-for-a-user) - [Organization リポジトリの一覧表示](/v3/repos/#list-organization-repositories) -- [一覧表示のフォーク](/v3/repos/forks/#list-forks) -- [ユーザが Watch しているリポジトリの一覧表示](/v3/activity/watching/#list-repositories-watched-by-a-user) +- [一覧表示のフォーク](/rest/reference/repos#list-forks) +- [ユーザが Watch しているリポジトリの一覧表示](/rest/reference/activity#list-repositories-watched-by-a-user) - [Team リポジトリの一覧表示](/v3/teams/#list-team-repositories) {% warning %} diff --git a/translations/ja-JP/content/rest/reference/permissions-required-for-github-apps.md b/translations/ja-JP/content/rest/reference/permissions-required-for-github-apps.md index c3549568ae5a..7dbe0e191c58 100644 --- a/translations/ja-JP/content/rest/reference/permissions-required-for-github-apps.md +++ b/translations/ja-JP/content/rest/reference/permissions-required-for-github-apps.md @@ -2,7 +2,7 @@ title: GitHub Appに必要な権限 intro: '{% data variables.product.prodname_github_app %}互換の各エンドポイントについて、必要な権限を確認できます。' redirect_from: - - /v3/apps/permissions --- + - /v3/apps/permissions versions: free-pro-team: '*' enterprise-server: '*' @@ -18,12 +18,11 @@ GitHub Appは、デフォルトで`Read-only`メタデータ権限を持ちま {% data reusables.apps.metadata-permissions %} - - [`GET /`](/v3/#root-endpoint) - [`GET /codes_of_conduct`](/v3/codes_of_conduct/#get-all-codes-of-conduct) - [`GET /codes_of_conduct/:key`](/v3/codes_of_conduct/#get-a-code-of-conduct) - [`GET /emojis`](/v3/emojis/#emojis) -- [`GET /feeds`](/v3/activity/feeds/#get-feeds) +- [`GET /feeds`](/rest/reference/activity#get-feeds) - [`GET /licenses`](/v3/licenses/#get-all-commonly-used-licenses) - [`GET /licenses/:key`](/v3/licenses/#get-a-license) - [`POST /markdown`](/v3/markdown/#render-a-markdown-document) @@ -39,22 +38,22 @@ GitHub Appは、デフォルトで`Read-only`メタデータ権限を持ちま - [`GET /repos/:owner/:repo/community/profile`](/v3/repos/community/#get-community-profile-metrics) {% endif %} - [`GET /repos/:owner/:repo/contributors`](/v3/repos/#list-repository-contributors) -- [`GET /repos/:owner/:repo/forks`](/v3/repos/forks/#list-forks) +- [`GET /repos/:owner/:repo/forks`](/rest/reference/repos#list-forks) - [`GET /repos/:owner/:repo/languages`](/v3/repos/#list-repository-languages) - [`GET /repos/:owner/:repo/license`](/v3/licenses/#get-the-license-for-a-repository) -- [`GET /repos/:owner/:repo/stargazers`](/v3/activity/starring/#list-stargazers) +- [`GET /repos/:owner/:repo/stargazers`](/rest/reference/activity#list-stargazers) - [`GET /repos/:owner/:repo/stats/code_frequency`](/v3/repos/statistics/#get-the-weekly-commit-activity) - [`GET /repos/:owner/:repo/stats/commit_activity`](/v3/repos/statistics/#get-the-last-year-of-commit-activity) - [`GET /repos/:owner/:repo/stats/contributors`](/v3/repos/statistics/#get-all-contributor-commit-activity) - [`GET /repos/:owner/:repo/stats/participation`](/v3/repos/statistics/#get-the-weekly-commit-count) - [`GET /repos/:owner/:repo/stats/punch_card`](/v3/repos/statistics/#get-the-hourly-commit-count-for-each-day) -- [`GET /repos/:owner/:repo/subscribers`](/v3/activity/watching/#list-watchers) +- [`GET /repos/:owner/:repo/subscribers`](/rest/reference/activity#list-watchers) - [`GET /repos/:owner/:repo/tags`](/v3/repos/#list-repository-tags) - [`GET /repos/:owner/:repo/topics`](/v3/repos#get-all-repository-topics) - [`GET /repositories`](/v3/repos/#list-public-repositories) - [`GET /user/repos`](/v3/repos/#list-repositories-for-the-authenticated-user) -- [`GET /user/starred`](/v3/activity/starring/#list-repositories-starred-by-a-user) -- [`GET /user/subscriptions`](/v3/activity/watching/#list-repositories-watched-by-a-user) +- [`GET /user/starred`](/rest/reference/activity#list-repositories-starred-by-a-user) +- [`GET /user/subscriptions`](/rest/reference/activity#list-repositories-watched-by-a-user) - [`GET /users`](/v3/users/#list-users) - [`GET /users/:username`](/v3/users/#get-a-user) - [`GET /users/:username/followers`](/v3/users/followers/#list-followers-of-a-user) @@ -62,10 +61,10 @@ GitHub Appは、デフォルトで`Read-only`メタデータ権限を持ちま - [`GET /users/:username/following/:target_user`](/v3/users/followers/#check-if-a-user-follows-another-user) - [`GET /users/:username/gpg_keys`](/v3/users/gpg_keys/#list-gpg-keys-for-a-user) - [`GET /users/:username/orgs`](/v3/orgs/#list-organizations-for-a-user) -- [`GET /users/:username/received_events`](/v3/activity/events/#list-events-received-by-the-authenticated-user) -- [`GET /users/:username/received_events/public`](/v3/activity/events/#list-public-events-received-by-a-user) +- [`GET /users/:username/received_events`](/rest/reference/activity#list-events-received-by-the-authenticated-user) +- [`GET /users/:username/received_events/public`](/rest/reference/activity#list-public-events-received-by-a-user) - [`GET /users/:username/repos`](/v3/repos/#list-repositories-for-a-user) -- [`GET /users/:username/subscriptions`](/v3/activity/watching/#list-repositories-watched-by-a-user) +- [`GET /users/:username/subscriptions`](/rest/reference/activity#list-repositories-watched-by-a-user) _コラボレータ_ - [`GET /repos/:owner/:repo/collaborators`](/v3/repos/collaborators/#list-repository-collaborators) @@ -78,12 +77,12 @@ _コミットのコメント_ - [`GET /repos/:owner/:repo/commits/:sha/comments`](/v3/repos/comments/#list-commit-comments) _イベント_ -- [`GET /events`](/v3/activity/events/#list-public-events) -- [`GET /networks/:owner/:repo/events`](/v3/activity/events/#list-public-events-for-a-network-of-repositories) -- [`GET /orgs/:org/events`](/v3/activity/events/#list-public-organization-events) -- [`GET /repos/:owner/:repo/events`](/v3/activity/events/#list-repository-events) -- [`GET /users/:username/events`](/v3/activity/events/#list-events-for-the-authenticated-user) -- [`GET /users/:username/events/public`](/v3/activity/events/#list-public-events-for-a-user) +- [`GET /events`](/rest/reference/activity#list-public-events) +- [`GET /networks/:owner/:repo/events`](/rest/reference/activity#list-public-events-for-a-network-of-repositories) +- [`GET /orgs/:org/events`](/rest/reference/activity#list-public-organization-events) +- [`GET /repos/:owner/:repo/events`](/rest/reference/activity#list-repository-events) +- [`GET /users/:username/events`](/rest/reference/activity#list-events-for-the-authenticated-user) +- [`GET /users/:username/events/public`](/rest/reference/activity#list-public-events-for-a-user) _Git_ - [`GET /gitignore/templates`](/v3/gitignore/#get-all-gitignore-templates) @@ -169,7 +168,6 @@ _検索_ {% if currentVersion == "free-pro-team@latest" %} - [`DELETE /repos/:owner/:repo/vulnerability-alerts`](/v3/repos/#disable-vulnerability-alerts) (:write) {% endif %} -- [`POST /user/repos`](/v3/repos/#create-a-repository-for-the-authenticated-user) (:write) - [`PATCH /user/repository_invitations/:invitation_id`](/v3/repos/invitations/#accept-a-repository-invitation) (:write) - [`DELETE /user/repository_invitations/:invitation_id`](/v3/repos/invitations/#decline-a-repository-invitation) (:write) @@ -344,12 +342,10 @@ _トラフィック_ _ブランチ_ - [`GET /repos/:owner/:repo/branches`](/v3/repos/branches/#list-branches) (:read) - [`GET /repos/:owner/:repo/branches/:branch`](/v3/repos/branches/#get-a-branch) (:read) -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - [`GET /repos/:owner/:repo/branches/:branch/protection/restrictions/apps`](/v3/repos/branches/#list-apps-with-access-to-the-protected-branch) (:write) - [`POST /repos/:owner/:repo/branches/:branch/protection/restrictions/apps`](/v3/repos/branches/#add-app-access-restrictions) (:write) - [`PUT /repos/:owner/:repo/branches/:branch/protection/restrictions/apps`](/v3/repos/branches/#set-app-access-restrictions) (:write) - [`DELETE /repos/:owner/:repo/branches/:branch/protection/restrictions/apps`](/v3/repos/branches/#remove-user-access-restrictions) (:write) -{% endif %} _コミットのコメント_ - [`PATCH /repos/:owner/:repo/comments/:comment_id`](/v3/repos/comments/#update-a-commit-comment) (:write) @@ -363,13 +359,8 @@ _Git_ - [`POST /repos/:owner/:repo/git/commits`](/v3/git/commits/#create-a-commit) (:write) - [`GET /repos/:owner/:repo/git/commits/:commit_id`](/v3/git/commits/#get-a-commit) (:read) - [`POST /repos/:owner/:repo/git/refs`](/v3/git/refs/#create-a-reference) (:write) -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -- [`GET /repos/:owner/:repo/git/refs/:ref`](/v3/git/refs/#get-a-reference) (:read) -- [`GET /repos/:owner/:repo/git/refs`](/v3/git/refs/#list-references) (:read) -{% else %} - [`GET /repos/:owner/:repo/git/ref/:ref`](/v3/git/refs/#get-a-reference) (:read) - [`GET /repos/:owner/:repo/git/matching-refs/:ref`](/v3/git/refs/#list-matching-references) (:read) -{% endif %} - [`PATCH /repos/:owner/:repo/git/refs/:ref`](/v3/git/refs/#update-a-reference) (:write) - [`DELETE /repos/:owner/:repo/git/refs/:ref`](/v3/git/refs/#delete-a-reference) (:write) - [`POST /repos/:owner/:repo/git/tags`](/v3/git/tags/#create-a-tag-object) (:write) @@ -401,27 +392,27 @@ _リアクション_ - [`DELETE /orgs/:org/teams/:team_slug/discussions/:discussion_number/comments/:comment_number/reactions/:reaction_id`](/v3/reactions/#delete-team-discussion-comment-reaction) (:write){% endif %} _リリース_ -- [`GET /repos/:owner/:repo/releases`](/v3/repos/releases/#list-releases) (:read) -- [`POST /repos/:owner/:repo/releases`](/v3/repos/releases/#create-a-release) (:write) -- [`GET /repos/:owner/:repo/releases/:release_id`](/v3/repos/releases/#get-a-release) (:read) -- [`PATCH /repos/:owner/:repo/releases/:release_id`](/v3/repos/releases/#update-a-release) (:write) -- [`DELETE /repos/:owner/:repo/releases/:release_id`](/v3/repos/releases/#delete-a-release) (:write) -- [`GET /repos/:owner/:repo/releases/:release_id/assets`](/v3/repos/releases/#list-release-assets) (:read) -- [`GET /repos/:owner/:repo/releases/assets/:asset_id`](/v3/repos/releases/#get-a-release-asset) (:read) -- [`PATCH /repos/:owner/:repo/releases/assets/:asset_id`](/v3/repos/releases/#update-a-release-asset) (:write) -- [`DELETE /repos/:owner/:repo/releases/assets/:asset_id`](/v3/repos/releases/#delete-a-release-asset) (:write) -- [`GET /repos/:owner/:repo/releases/latest`](/v3/repos/releases/#get-the-latest-release) (:read) -- [`GET /repos/:owner/:repo/releases/tags/:tag`](/v3/repos/releases/#get-a-release-by-tag-name) (:read) +- [`GET /repos/:owner/:repo/releases`](/rest/reference/repos/#list-releases) (:read) +- [`POST /repos/:owner/:repo/releases`](/rest/reference/repos/#create-a-release) (:write) +- [`GET /repos/:owner/:repo/releases/:release_id`](/rest/reference/repos/#get-a-release) (:read) +- [`PATCH /repos/:owner/:repo/releases/:release_id`](/rest/reference/repos/#update-a-release) (:write) +- [`DELETE /repos/:owner/:repo/releases/:release_id`](/rest/reference/repos/#delete-a-release) (:write) +- [`GET /repos/:owner/:repo/releases/:release_id/assets`](/rest/reference/repos/#list-release-assets) (:read) +- [`GET /repos/:owner/:repo/releases/assets/:asset_id`](/rest/reference/repos/#get-a-release-asset) (:read) +- [`PATCH /repos/:owner/:repo/releases/assets/:asset_id`](/rest/reference/repos/#update-a-release-asset) (:write) +- [`DELETE /repos/:owner/:repo/releases/assets/:asset_id`](/rest/reference/repos/#delete-a-release-asset) (:write) +- [`GET /repos/:owner/:repo/releases/latest`](/rest/reference/repos/#get-the-latest-release) (:read) +- [`GET /repos/:owner/:repo/releases/tags/:tag`](/rest/reference/repos/#get-a-release-by-tag-name) (:read) ### "deployments"に対する権限 -- [`GET /repos/:owner/:repo/deployments`](/v3/repos/deployments/#list-deployments) (:read) -- [`POST /repos/:owner/:repo/deployments`](/v3/repos/deployments/#create-a-deployment) (:write) +- [`GET /repos/:owner/:repo/deployments`](/rest/reference/repos#list-deployments) (:read) +- [`POST /repos/:owner/:repo/deployments`](/rest/reference/repos#create-a-deployment) (:write) - [`GET /repos/:owner/:repo/deployments/:deployment_id`](/v3/repos/deployments/#get-a-deployment) (:read){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -- [`DELETE /repos/:owner/:repo/deployments/:deployment_id`](/v3/repos/deployments/#delete-a-deployment) (:write){% endif %} -- [`GET /repos/:owner/:repo/deployments/:deployment_id/statuses`](/v3/repos/deployments/#list-deployment-statuses) (:read) -- [`POST /repos/:owner/:repo/deployments/:deployment_id/statuses`](/v3/repos/deployments/#create-a-deployment-status) (:write) -- [`GET /repos/:owner/:repo/deployments/:deployment_id/statuses/:status_id`](/v3/repos/deployments/#get-a-deployment-status) (:read) +- [`DELETE /repos/:owner/:repo/deployments/:deployment_id`](/rest/reference/repos#delete-a-deployment) (:write){% endif %} +- [`GET /repos/:owner/:repo/deployments/:deployment_id/statuses`](/rest/reference/repos#list-deployment-statuses) (:read) +- [`POST /repos/:owner/:repo/deployments/:deployment_id/statuses`](/rest/reference/repos#create-a-deployment-status) (:write) +- [`GET /repos/:owner/:repo/deployments/:deployment_id/statuses/:status_id`](/rest/reference/repos#get-a-deployment-status) (:read) ### "emails"に対する権限 @@ -618,12 +609,12 @@ _Team_ ### "organization hooks"に対する権限 -- [`GET /orgs/:org/hooks`](/v3/orgs/hooks/#list-organization-webhooks) (:read) -- [`POST /orgs/:org/hooks`](/v3/orgs/hooks/#create-an-organization-webhook) (:write) -- [`GET /orgs/:org/hooks/:hook_id`](/v3/orgs/hooks/#get-an-organization-webhook) (:read) -- [`PATCH /orgs/:org/hooks/:hook_id`](/v3/orgs/hooks/#update-an-organization-webhook) (:write) -- [`DELETE /orgs/:org/hooks/:hook_id`](/v3/orgs/hooks/#delete-an-organization-webhook) (:write) -- [`POST /orgs/:org/hooks/:hook_id/pings`](/v3/orgs/hooks/#ping-an-organization-webhook) (:write) +- [`GET /orgs/:org/hooks`](/rest/reference/orgs#webhooks/#list-organization-webhooks) (:read) +- [`POST /orgs/:org/hooks`](/rest/reference/orgs#webhooks/#create-an-organization-webhook) (:write) +- [`GET /orgs/:org/hooks/:hook_id`](/rest/reference/orgs#webhooks/#get-an-organization-webhook) (:read) +- [`PATCH /orgs/:org/hooks/:hook_id`](/rest/reference/orgs#webhooks/#update-an-organization-webhook) (:write) +- [`DELETE /orgs/:org/hooks/:hook_id`](/rest/reference/orgs#webhooks/#delete-an-organization-webhook) (:write) +- [`POST /orgs/:org/hooks/:hook_id/pings`](/rest/reference/orgs#webhooks/#ping-an-organization-webhook) (:write) _Team_ - [`DELETE /teams/:team_id/projects/:project_id`](/v3/teams/#remove-a-project-from-a-team) (:read) @@ -668,14 +659,14 @@ _Team_ ### "pages"に対する権限 -- [`GET /repos/:owner/:repo/pages`](/v3/repos/pages/#get-a-github-pages-site) (:read) -- [`POST /repos/:owner/:repo/pages`](/v3/repos/pages/#create-a-github-pages-site) (:write) -- [`PUT /repos/:owner/:repo/pages`](/v3/repos/pages/#update-information-about-a-github-pages-site) (:write) -- [`DELETE /repos/:owner/:repo/pages`](/v3/repos/pages/#delete-a-github-pages-site) (:write) -- [`GET /repos/:owner/:repo/pages/builds`](/v3/repos/pages/#list-github-pages-builds) (:read) -- [`POST /repos/:owner/:repo/pages/builds`](/v3/repos/pages/#request-a-github-pages-build) (:write) -- [`GET /repos/:owner/:repo/pages/builds/:build_id`](/v3/repos/pages/#get-github-pages-build) (:read) -- [`GET /repos/:owner/:repo/pages/builds/latest`](/v3/repos/pages/#get-latest-pages-build) (:read) +- [`GET /repos/:owner/:repo/pages`](/rest/reference/repos#get-a-github-pages-site) (:read) +- [`POST /repos/:owner/:repo/pages`](/rest/reference/repos#create-a-github-pages-site) (:write) +- [`PUT /repos/:owner/:repo/pages`](/rest/reference/repos#update-information-about-a-github-pages-site) (:write) +- [`DELETE /repos/:owner/:repo/pages`](/rest/reference/repos#delete-a-github-pages-site) (:write) +- [`GET /repos/:owner/:repo/pages/builds`](/rest/reference/repos#list-github-pages-builds) (:read) +- [`POST /repos/:owner/:repo/pages/builds`](/rest/reference/repos#request-a-github-pages-build) (:write) +- [`GET /repos/:owner/:repo/pages/builds/:build_id`](/rest/reference/repos#get-github-pages-build) (:read) +- [`GET /repos/:owner/:repo/pages/builds/latest`](/rest/reference/repos#get-latest-pages-build) (:read) ### "pull requests"に対する権限 @@ -853,9 +844,9 @@ _Team_ ### "starring"に対する権限 -- [`GET /user/starred/:owner/:repo`](/v3/activity/starring/#check-if-a-repository-is-starred-by-the-authenticated-user) (:read) -- [`PUT /user/starred/:owner/:repo`](/v3/activity/starring/#star-a-repository-for-the-authenticated-user) (:write) -- [`DELETE /user/starred/:owner/:repo`](/v3/activity/starring/#unstar-a-repository-for-the-authenticated-user) (:write) +- [`GET /user/starred/:owner/:repo`](/rest/reference/activity#check-if-a-repository-is-starred-by-the-authenticated-user) (:read) +- [`PUT /user/starred/:owner/:repo`](/rest/reference/activity#star-a-repository-for-the-authenticated-user) (:write) +- [`DELETE /user/starred/:owner/:repo`](/rest/reference/activity#unstar-a-repository-for-the-authenticated-user) (:write) ### "statuses"に対する権限 diff --git a/translations/ja-JP/content/rest/reference/repos.md b/translations/ja-JP/content/rest/reference/repos.md index f86f0f6c2a1f..dead667bd2e2 100644 --- a/translations/ja-JP/content/rest/reference/repos.md +++ b/translations/ja-JP/content/rest/reference/repos.md @@ -61,20 +61,20 @@ Repo Commits API は、リポジトリ内の子コミットのリスティング ### リポジトリコンテンツのカスタムメディアタイプ -[READMEs](/v3/repos/contents/#get-a-repository-readme), [files](/v3/repos/contents/#get-repository-content), and [symlinks](/v3/repos/contents/#get-repository-content) support the following custom media types: +[README](/v3/repos/contents/#get-a-repository-readme)、[ファイル](/v3/repos/contents/#get-repository-content)、[シンボリックリンク](/v3/repos/contents/#get-repository-content)は以下のカスタムメディアタイプをサポートしています。 application/vnd.github.VERSION.raw application/vnd.github.VERSION.html -Use the `.raw` media type to retrieve the contents of the file. +ファイルのコンテンツを取得するには、`.raw` メディアタイプを使ってください。 Markdown や AsciiDoc などのマークアップファイルでは、`.html` メディアタイプを使用して、レンダリングされた HTML を取得できます。 マークアップ言語は、オープンソースの[マークアップライブラリ](https://github.com/github/markup)を使用して HTML にレンダリングされます。 -[All objects](/v3/repos/contents/#get-repository-content) support the following custom media type: +[すべてのオブジェクト](/v3/repos/contents/#get-repository-content)は、以下のカスタムメディアタイプをサポートしています。 application/vnd.github.VERSION.object -Use the `object` media type parameter to retrieve the contents in a consistent object format regardless of the content type. For example, instead of an array of objects for a directory, the response will be an object with an `entries` attribute containing the array of objects. +コンテンツのタイプに関係なく、一貫したオブジェクトフォーマットを取得するには、`object` メディアタイプパラメータを使用します。 たとえば、レスポンスはディレクトリに対するオブジェクトの配列ではなく、オブジェクトの配列を含む `entries` 属性のオブジェクトになります。 API でのメディアタイプの使用について詳しくは、[こちら](/v3/media/)をご覧ください。 @@ -86,7 +86,7 @@ API でのメディアタイプの使用について詳しくは、[こちら](/ {% data reusables.repositories.deploy-keys %} -Deploy keys can either be setup using the following API endpoints, or by using GitHub. To learn how to set deploy keys up in GitHub, see "[Managing deploy keys](/developers/overview/managing-deploy-keys)." +デプロイキーは、以下の API エンドポイントを使用するか、GitHub を使用することでセットアップできます。 GitHub でデプロイキーを設定する方法については、「[デプロイキーを管理する](/developers/overview/managing-deploy-keys)」を参照してください。 {% for operation in currentRestOperations %} {% if operation.subcategory == 'keys' %}{% include rest_operation %}{% endif %} @@ -94,15 +94,15 @@ Deploy keys can either be setup using the following API endpoints, or by using G ## デプロイメント -Deployments are requests to deploy a specific ref (branch, SHA, tag). GitHub dispatches a [`deployment` event](/developers/webhooks-and-events/webhook-events-and-payloads#deployment) that external services can listen for and act on when new deployments are created. Deployments enable developers and organizations to build loosely coupled tooling around deployments, without having to worry about the implementation details of delivering different types of applications (e.g., web, native). +デプロイメントとは、特定の ref (ブランチ、SHA、タグ) を配備するためるリクエストです。 GitHub は、 外部サーバーがリッスンでき、新しいデプロイメントが作成されたときに実行される [`deployment` イベント](/developers/webhooks-and-events/webhook-events-and-payloads#deployment)をディスバッチします。 デプロイメントにより、開発者や Organization はデプロイメントを中心として、さまざまな種類のアプリケーション (ウェブ、ネイティブなど) を提供するための実装に関する詳細を気にすることなく、疎結合ツールを構築できます。 -Deployment statuses allow external services to mark deployments with an `error`, `failure`, `pending`, `in_progress`, `queued`, or `success` state that systems listening to [`deployment_status` events](/developers/webhooks-and-events/webhook-events-and-payloads#deployment_status) can consume. +デプロイメントのステータスを使用すると、外部サービスがデプロイメントに `error`、`failure`、`pending`、`in_progress`、`queued`、`success` ステータスを付けることができ、[`deployment_status` イベント](/developers/webhooks-and-events/webhook-events-and-payloads#deployment_status)をリッスンするシステムがその情報を使用できます。 -Deployment statuses can also include an optional `description` and `log_url`, which are highly recommended because they make deployment statuses more useful. The `log_url` is the full URL to the deployment output, and the `description` is a high-level summary of what happened with the deployment. +デプロイメントのステータスには、オプションとして `description` と `log_url` を含めることもできます。これによりデプロイメントのステータスがより有用なものになるので、非常におすすめです。 `log_url` はデプロイメントの出力の完全な URL で、`description` はデプロイメントで発生したことの概要を示すものです。 -GitHub dispatches `deployment` and `deployment_status` events when new deployments and deployment statuses are created. These events allows third-party integrations to receive respond to deployment requests and update the status of a deployment as progress is made. +GitHub は、新しいデプロイメント、デプロイメントのステータスが作成されたときに、`deployment` イベント、`deployment_status` イベントをディスパッチします。 これらのイベントにより、サードパーティのインテグレーションがデプロイメントのリクエストに対する応答を受けとり、進展があるたびにステータスを更新できます。 -Below is a simple sequence diagram for how these interactions would work. +以下は、これらの相互作用がどのように機能するかを示す簡単なシーケンス図です。 ``` +---------+ +--------+ +-----------+ +-------------+ @@ -131,15 +131,15 @@ Below is a simple sequence diagram for how these interactions would work. | | | | ``` -Keep in mind that GitHub is never actually accessing your servers. It's up to your third-party integration to interact with deployment events. Multiple systems can listen for deployment events, and it's up to each of those systems to decide whether they're responsible for pushing the code out to your servers, building native code, etc. +GitHub は、あなたのサーバーに実際にアクセスすることはないということは覚えておきましょう。 デプロイメントイベントとやり取りするかどうかは、サードパーティインテグレーション次第です。 複数のシステムがデプロイメントイベントをリッスンできます。コードをサーバーにプッシュする、ネイティブコードを構築するなどを行うかどうかは、それぞれのシステムが決めることができます。 -Note that the `repo_deployment` [OAuth scope](/developers/apps/scopes-for-oauth-apps) grants targeted access to deployments and deployment statuses **without** granting access to repository code, while the `public_repo` and `repo` scopes grant permission to code as well. +`public_repo` スコープおよび `repo` スコープはコードにもアクセス権を付与するのに対し、`repo_deployment` [OAuth scope](/developers/apps/scopes-for-oauth-apps) は、リポジトリのコードにアクセス権を付与**せず**、デプロイメントおよびデプロイメントに絞ってアクセス権を付与することに注意してください。 -### Inactive deployments +### 非アクティブのデプロイメント -When you set the state of a deployment to `success`, then all prior non-transient, non-production environment deployments in the same repository will become `inactive`. To avoid this, you can set `auto_inactive` to `false` when creating the deployment status. +デプロイメントのステータスを `success` に設定すると、同じリポジトリ内の一時的でない、非本番環境のデプロイメントはすべて `inactive` になります。 これを回避するには、デプロイメントのステータスを作成する前に、`auto_inactive` を `false` に設定します。 -You can communicate that a transient environment no longer exists by setting its `state` to `inactive`. Setting the `state` to `inactive` shows the deployment as `destroyed` in {% data variables.product.prodname_dotcom %} and removes access to it. +`state` を `inactive` に設定することで、一時的な環境が存在しなくなったことを伝えることができます。 `state` を `inactive` に設定すると、{% data variables.product.prodname_dotcom %} でデプロイメントが `destroyed` と表示され、アクセス権が削除されます。 {% for operation in currentRestOperations %} {% if operation.subcategory == 'deployments' %}{% include rest_operation %}{% endif %} @@ -153,23 +153,23 @@ You can communicate that a transient environment no longer exists by setting its ## 招待 -The Repository Invitations API allows users or external services to invite other users to collaborate on a repo. The invited users (or external services on behalf of invited users) can choose to accept or decline the invitations. +Repository Invitations API を使用すると、他のユーザにリポジトリでコラボレーションするようユーザや外部サービスを招待できます。 招待されたユーザ (または招待されたユーザを代行する外部サービス) は、招待を受諾または拒否できます。 -Note that the `repo:invite` [OAuth scope](/developers/apps/scopes-for-oauth-apps) grants targeted access to invitations **without** also granting access to repository code, while the `repo` scope grants permission to code as well as invitations. +`repo` スコープはコードにも招待にもアクセス権を付与するのに対し、`repo:invite` [OAuth scope](/developers/apps/scopes-for-oauth-apps) は招待のみに絞ってアクセス権を付与し、リポジトリのコードにはアクセス権を付与**しない**ことに注意してください。 -### Invite a user to a repository +### ユーザをリポジトリに招待する -Use the API endpoint for adding a collaborator. For more information, see "[Add a repository collaborator](/rest/reference/repos#add-a-repository-collaborator)." +コラボレータを追加するには、API エンドポイントを使用します。 詳しい情報については「[リポジトリコラボレータを追加する](/rest/reference/repos#add-a-repository-collaborator)」を参照してください。 {% for operation in currentRestOperations %} {% if operation.subcategory == 'invitations' %}{% include rest_operation %}{% endif %} {% endfor %} -## Merging +## マージ -The Repo Merging API supports merging branches in a repository. This accomplishes essentially the same thing as merging one branch into another in a local repository and then pushing to {% data variables.product.product_name %}. The benefit is that the merge is done on the server side and a local repository is not needed. This makes it more appropriate for automation and other tools where maintaining local repositories would be cumbersome and inefficient. +Repo Merging API は、リポジトリ内にあるブランチのマージをサポートしています。 これは、ローカルリポジトリにおいて 1 つのブランチを別のブランチにマージし、それを {% data variables.product.product_name %} にプッシュするのと本質的には同じことです。 この利点は、マージがサーバー側で行われ、ローカルリポジトリが必要ないことです。 これは自動化や、ローカルリポジトリの保守が煩雑で非効率的なツールに適しています。 -The authenticated user will be the author of any merges done through this endpoint. +認証されたユーザは、このエンドポイントを通じて実行されたあらゆるマージの作者になります。 {% for operation in currentRestOperations %} {% if operation.subcategory == 'merging' %}{% include rest_operation %}{% endif %} @@ -177,20 +177,20 @@ The authenticated user will be the author of any merges done through this endpoi ## ページ -The {% data variables.product.prodname_pages %} API retrieves information about your {% data variables.product.prodname_pages %} configuration, and the statuses of your builds. Information about the site and the builds can only be accessed by authenticated owners, even though the websites are public. For more information, see "[About {% data variables.product.prodname_pages %}](/github/working-with-github-pages/about-github-pages)." +{% data variables.product.prodname_pages %} API は、{% data variables.product.prodname_pages %} の設定や、ビルドのステータスについての情報を取得します。 サイトとビルドについての情報は、ウェブサイトがパブリックである場合でも、認証されたオーナーのみがアクセスできます。 詳しい情報については、「[{% data variables.product.prodname_pages %} について](/github/working-with-github-pages/about-github-pages)」を参照してください。 -In {% data variables.product.prodname_pages %} API endpoints with a `status` key in their response, the value can be one of: -* `null`: The site has yet to be built. -* `queued`: The build has been requested but not yet begun. -* `building`:The build is in progress. -* `built`: The site has been built. -* `errored`: Indicates an error occurred during the build. +レスポンスに `status` キーを持つ {% data variables.product.prodname_pages %} API エンドポイントにおいては、値は以下のいずれかになります。 +* `null`: サイトはまだビルドされていません。 +* `queued`: ビルドがリクエストされたが、まだ開始していません。 +* `building`: ビルドが進行中です。 +* `built`: サイトがビルドされています。 +* `errored`: ビルド中にエラーが発生したことを示します。 -In {% data variables.product.prodname_pages %} API endpoints that {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}support the `mister-fantastic-preview` and{% endif %} return GitHub Pages site information, the JSON responses include these fields: -* `html_url`: The absolute URL (including scheme) of the rendered Pages site. For example, `https://username.github.io`. -* `source`: An object that contains the source branch and directory for the rendered Pages site. これは以下のものが含まれます。 - - `branch`: The repository branch used to publish your [site's source files](/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site). For example, _master_ or _gh-pages_. - - `path`: The repository directory from which the site publishes. Will be either `/` or `/docs`. +In {% data variables.product.prodname_pages %} API endpoints that return GitHub Pages site information, the JSON responses include these fields: +* `html_url`: レンダリングされた Pages サイトの絶対 URL (スキームを含む) 。 たとえば、`https://username.github.io` などです。 +* `source`: レンダリングされた Pages サイトのソースブランチおよびディレクトリを含むオブジェクト。 これは以下のものが含まれます。 + - `branch`: [サイトのソースファイル](/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)を公開するために使用するリポジトリのブランチ。 For example, _main_ or _gh-pages_. + - `path`: サイトの公開元のリポジトリディレクトリ。 `/` または `/docs` のどちらかとなります。 {% for operation in currentRestOperations %} {% if operation.subcategory == 'pages' %}{% include rest_operation %}{% endif %} @@ -200,7 +200,7 @@ In {% data variables.product.prodname_pages %} API endpoints that {% if currentV {% note %} -**Note:** The Releases API replaces the Downloads API. You can retrieve the download count and browser download URL from the endpoints in this API that return releases and release assets. +**注釈:** Releases API は Downloads API を置き換えるものです。 リリースを返し、アセットをリリースする、この API のエンドポイントからダウンロード数と ブラウザのダウンロード URL を取得できます。 {% endnote %} @@ -208,23 +208,23 @@ In {% data variables.product.prodname_pages %} API endpoints that {% if currentV {% if operation.subcategory == 'releases' %}{% include rest_operation %}{% endif %} {% endfor %} -## Statistics +## 統計 -The Repository Statistics API allows you to fetch the data that {% data variables.product.product_name %} uses for visualizing different types of repository activity. +Repository Statistics API を使用すると、{% data variables.product.product_name %} がさまざまなタイプのリポジトリのアクティビティを視覚化するために用いるデータをフェッチできます。 -### A word about caching +### キャッシングについて -Computing repository statistics is an expensive operation, so we try to return cached data whenever possible. If the data hasn't been cached when you query a repository's statistics, you'll receive a `202` response; a background job is also fired to start compiling these statistics. Give the job a few moments to complete, and then submit the request again. If the job has completed, that request will receive a `200` response with the statistics in the response body. +リポジトリの統計情報を計算するのは負荷が高い操作なので、可能な限りキャッシュされたデータを返すようにしています。 リポジトリの統計をクエリした際にデータがキャッシュされていなかった場合は、`202` レスポンスを受け取ります。また、この統計をまとめるため、バックグラウンドでジョブが開始します。 このジョブが完了するまで少し待ってから、リクエストを再度サブミットしてください。 ジョブが完了していた場合、リクエストは `200` レスポンスを受けとり、レスポンスの本文には統計情報が含まれています。 -Repository statistics are cached by the SHA of the repository's default branch, which is usually master; pushing to the default branch resets the statistics cache. +Repository statistics are cached by the SHA of the repository's default branch; pushing to the default branch resets the statistics cache. -### Statistics exclude some types of commits +### 統計で除外されるコミットのタイプ -The statistics exposed by the API match the statistics shown by [different repository graphs](/github/visualizing-repository-data-with-graphs/about-repository-graphs). +API によって公開される統計は、[別のリポジトリグラフ](/github/visualizing-repository-data-with-graphs/about-repository-graphs)で表示される統計と同じものです。 -To summarize: -- All statistics exclude merge commits. -- Contributor statistics also exclude empty commits. +要約すると、 +- すべての統計は、マージコミットが除外されます。 +- コントリビューター統計では、空のコミットも除外されます。 {% for operation in currentRestOperations %} {% if operation.subcategory == 'statistics' %}{% include rest_operation %}{% endif %} @@ -232,17 +232,17 @@ To summarize: ## ステータス -The status API allows external services to mark commits with an `error`, `failure`, `pending`, or `success` state, which is then reflected in pull requests involving those commits. +ステータス API を使用すると、外部サービスがコミットに `error`、 `failure`、`pending`、`success` ステータスを付けることができ、このステータスはコミットが含まれるプルリクエストに反映されます。 -Statuses can also include an optional `description` and `target_url`, and we highly recommend providing them as they make statuses much more useful in the GitHub UI. +ステータスには、オプションとして `description` と `target_url` を含めることもできます。これにより GitHub UI でステータスをより有用なものにできるので、非常におすすめです。 -As an example, one common use is for continuous integration services to mark commits as passing or failing builds using status. The `target_url` would be the full URL to the build output, and the `description` would be the high level summary of what happened with the build. +たとえば、継続的インテグレーションサービスの典型的な使用方法の一つが、ステータスを使用してコミットに合格と不合格の印を付けることです。 `target_url` でビルドの出力先の完全な URL、`description` でビルドで発生したことの概要を示すといったようにします。 -Statuses can include a `context` to indicate what service is providing that status. For example, you may have your continuous integration service push statuses with a context of `ci`, and a security audit tool push statuses with a context of `security`. You can then use the [Get the combined status for a specific reference](/rest/reference/repos#get-the-combined-status-for-a-specific-reference) to retrieve the whole status for a commit. +ステータスには、どのサービスがそのステータスを提供しているかを示す `context` を含めることができます。 たとえば、継続的インテグレーションサービスのプッシュステータスに `ci` のコンテキストを、セキュリティ監査ツールのプッシュステータスに `security` のコンテキストを含めることができます。 その後、[特定のリファレンス複合的なステータス](/rest/reference/repos#get-the-combined-status-for-a-specific-reference)を使用して、コミットの全体のステータスを取得できます。 -Note that the `repo:status` [OAuth scope](/developers/apps/scopes-for-oauth-apps) grants targeted access to statuses **without** also granting access to repository code, while the `repo` scope grants permission to code as well as statuses. +`repo` スコープはコードにもステータスにもアクセス権を付与するのに対し、`repo:status` [OAuth scope](/developers/apps/scopes-for-oauth-apps) はステータスのみに絞ってアクセス権を付与し、リポジトリのコードにはアクセス権を付与**しない**ことに注意してください。 -If you are developing a GitHub App and want to provide more detailed information about an external service, you may want to use the [Checks API](/rest/reference/checks). +GitHub App を開発していて、外部サービスについて詳細な情報を提供したい場合は、[Checks API](/rest/reference/checks) を使用できます。 {% for operation in currentRestOperations %} {% if operation.subcategory == 'statuses' %}{% include rest_operation %}{% endif %} @@ -250,7 +250,7 @@ If you are developing a GitHub App and want to provide more detailed information ## トラフィック -For repositories that you have push access to, the traffic API provides access to the information provided in your repository graph. For more information, see "Viewing traffic to a repository." +プッシュアクセスを持つリポジトリに対し、トラフィック API はリポジトリグラフが提供する情報へのアクセスを提供します。 詳細は「リポジトリへのトラフィックを表示する」を参照してください。 {% for operation in currentRestOperations %} {% if operation.subcategory == 'traffic' %}{% include rest_operation %}{% endif %} @@ -258,9 +258,9 @@ For repositories that you have push access to, the traffic API provides access t ## webhook -The Repository Webhooks API allows repository admins to manage the post-receive hooks for a repository. Webhooks can be managed using the JSON HTTP API, or the [PubSubHubbub](#PubSubHubbub) API. +Repository Webhooks API を使用すると、リポジトリ管理者がリポジトリの post-receive フックを管理できます。 Webhook は、JSON HTTP API または [PubSubHubbub](#PubSubHubbub) API を使用して管理できます。 -If you would like to set up a single webhook to receive events from all of your organization's repositories, see our API documentation for [Organization Webhooks](/rest/reference/orgs#webhooks). +Organization のすべてのリポジトリからイベントを受信するため単一の webhook を設定する場合は、[Organization Webhooks](/rest/reference/orgs#webhooks) の API ドキュメントを参照してください。 {% for operation in currentRestOperations %} {% if operation.subcategory == 'hooks' %}{% include rest_operation %}{% endif %} @@ -276,21 +276,21 @@ If you would like to set up a single webhook to receive events from all of your ### PubSubHubbub -GitHub can also serve as a [PubSubHubbub](https://github.com/pubsubhubbub/PubSubHubbub) hub for all repositories. PSHB is a simple publish/subscribe protocol that lets servers register to receive updates when a topic is updated. The updates are sent with an HTTP POST request to a callback URL. Topic URLs for a GitHub repository's pushes are in this format: +GitHub は、すべてのリポジトリに対する [PubSubHubbub](https://github.com/pubsubhubbub/PubSubHubbub) のハブとして機能することもできます。 PSHB はシンプルな公開/サブスクライブプロトコルで、トピックが更新されたときにサーバーが更新を受信できるよう登録できます。 更新は HTTP POST リクエストでコールバック URL に送信されます。 GitHub リポジトリのプッシュに対するトピック URL のフォーマットは以下の通りです。 `https://github.com/{owner}/{repo}/events/{event}` -The event can be any available webhook event. For more information, see "[Webhook events and payloads](/developers/webhooks-and-events/webhook-events-and-payloads)." +イベントには、任意の使用可能な webhook イベントを指定します。 詳しい情報については、「[webhook イベントとペイロード](/developers/webhooks-and-events/webhook-events-and-payloads)」を参照してください。 -#### Response format +#### レスポンスのフォーマット -The default format is what [existing post-receive hooks should expect](/post-receive-hooks/): A JSON body sent as the `payload` parameter in a POST. You can also specify to receive the raw JSON body with either an `Accept` header, or a `.json` extension. +デフォルトのフォーマットは、[既存の post-receive フックから予想できます](/post-receive-hooks/)。すなわち、POST で `payload` パラメータとして送信される JSON の本文です。 また、`Accept` ヘッダまたは `.json` 拡張子で、Raw 形式の JSON 本文を受信するよう指定できます。 Accept: application/json https://github.com/{owner}/{repo}/events/push.json -#### Callback URLs -Callback URLs can use the `http://` protocol. +#### コールバック URL +コールバック URL は `http://` プロトコルを使用できます。 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.20" %}You can also `github://` callbacks to specify a GitHub service. {% data reusables.apps.deprecating_github_services_ghe %} @@ -303,9 +303,9 @@ Callback URLs can use the `http://` protocol. # Send updates to Campfire github://campfire?subdomain=github&room=Commits&token=abc123 {% endif %} -#### Subscribing +#### サブスクライブ -The GitHub PubSubHubbub endpoint is: `{% data variables.product.api_url_code %}/hub`. A successful request with curl looks like: +GitHub PubSubHubbub のエンドポイントは `{% data variables.product.api_url_code %}/hub` です。 curl でリクエストに成功すると、以下のように表示されます。 ``` shell curl -u "user" -i \ @@ -315,13 +315,13 @@ curl -u "user" -i \ -F "hub.callback=http://postbin.org/123" ``` -PubSubHubbub requests can be sent multiple times. If the hook already exists, it will be modified according to the request. +PubSubHubbub リクエストは複数回送信できます。 フックがすでに存在する場合は、リクエストに従って変更されます。 ##### パラメータ -| 名前 | 種類 | 説明 | -| -------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `hub.mode` | `string` | **Required**. Either `subscribe` or `unsubscribe`. | -| `hub.topic` | `string` | **Required**. The URI of the GitHub repository to subscribe to. The path must be in the format of `/{owner}/{repo}/events/{event}`. | -| `hub.callback` | `string` | The URI to receive the updates to the topic. | -| `hub.secret` | `string` | A shared secret key that generates a SHA1 HMAC of the outgoing body content. You can verify a push came from GitHub by comparing the raw request body with the contents of the `X-Hub-Signature` header. You can see [the PubSubHubbub documentation](https://pubsubhubbub.github.io/PubSubHubbub/pubsubhubbub-core-0.4.html#authednotify) for more details. | +| 名前 | 種類 | 説明 | +| -------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `hub.mode` | `string` | **Required**. `subscribe` または `unsubscribe`。 | +| `hub.topic` | `string` | **Required**. GitHub リポジトリがサブスクライブする URI。 パスのフォーマットは `/{owner}/{repo}/events/{event}` としてください。 | +| `hub.callback` | `string` | トピックの更新を受信する URI。 | +| `hub.secret` | `string` | 送信する本文コンテンツの SHA1 HMAC を生成する共有秘密鍵。 Raw 形式のリクエスト本文と、`X-Hub-Signature` ヘッダのコンテンツを比較することで、 GitHub からのプッシュを検証できます。 詳細は、 [PubSubHubbub のドキュメント](https://pubsubhubbub.github.io/PubSubHubbub/pubsubhubbub-core-0.4.html#authednotify)を参照してください。 | diff --git a/translations/ja-JP/data/glossaries/external.yml b/translations/ja-JP/data/glossaries/external.yml index 5c80ea1c5b10..5714ff03ffc7 100644 --- a/translations/ja-JP/data/glossaries/external.yml +++ b/translations/ja-JP/data/glossaries/external.yml @@ -180,7 +180,7 @@ - term: デフォルトブランチ description: >- - リポジトリの base ブランチ。別途ブランチを指定しない限り、すべてのプルリクエストとコードコミットが自動的に作成されます。 このブランチは通常「master」といいます。 + The base branch for new pull requests and code commits in a repository. Each repository has at least one branch, which Git creates when you initialize the repository. The first branch is usually called `main`, and is often the default branch. - term: 依存グラフ description: >- diff --git a/translations/ja-JP/data/glossaries/internal.yml b/translations/ja-JP/data/glossaries/internal.yml index a3cd8a764add..9f5d0a9fa814 100644 --- a/translations/ja-JP/data/glossaries/internal.yml +++ b/translations/ja-JP/data/glossaries/internal.yml @@ -737,7 +737,7 @@ description: >- 実際にチェックアウトしたファイルのツリー。ワーキングツリーには通常、HEAD コミットのツリーのコンテンツに加え、ローカルで変更を加えたがまだコミットしていない分が含まれています。 - - term: WYSIWIG + term: WYSIWYG description: >- What You See Is What You Get。画面上のテキストは、レンダリングされた際に全く同様に表示される、という意味の頭字語。 - diff --git a/translations/ja-JP/data/graphql/graphql_previews.yml b/translations/ja-JP/data/graphql/graphql_previews.yml index ae4129a86fcf..9c3a89d2eab1 100644 --- a/translations/ja-JP/data/graphql/graphql_previews.yml +++ b/translations/ja-JP/data/graphql/graphql_previews.yml @@ -27,57 +27,6 @@ - CreateDeploymentPayload owning_teams: - '@github/ecosystem-api' -- - title: チェック - description: このプレビューは、GitHub Appsによって作成された読み取りチェックのサポートを追加します。 - toggled_by: ':antiope-preview' - announcement: null - updates: null - toggled_on: - - CheckAnnotationRange - - CheckAnnotationPosition - - CheckAnnotationSpan - - CheckAnnotation - - CheckAnnotationConnection.nodes - - CheckAnnotationData - - CheckAnnotationEdge.node - - CheckAnnotationLevel - - CheckConclusionState - - CheckStatusState - - CheckSuiteAutoTriggerPreference - - CheckRun - - CheckRunConnection.nodes - - CheckRunEdge.node - - CheckRunAction - - CheckRunFilter - - CheckRunOutput - - CheckRunOutputImage - - CheckRunType - - CheckSuite - - CheckSuiteConnection.nodes - - CheckSuiteEdge.node - - CheckSuiteFilter - - CreateCheckRunInput - - CreateCheckRunPayload - - CreateCheckSuiteInput - - CreateCheckSuitePayload - - Commit.checkSuites - - Mutation.createCheckRun - - Mutation.createCheckSuite - - Mutation.rerequestCheckSuite - - Mutation.updateCheckRun - - Mutation.updateCheckSuitePreferences - - Push - - RequestableCheckStatusState - - RerequestCheckSuiteInput - - RerequestCheckSuitePayload - - UpdateCheckRunInput - - UpdateCheckRunPayload - - UpdateCheckSuitePayload.checkSuite - - UpdateCheckSuitePreferencesInput - - UpdateCheckSuitePreferencesPayload - owning_teams: - - '@github/ce-extensibility' - title: >- MergeInfoPreview - プルリクエストのマージ状態に関する詳細な情報。 diff --git a/translations/ja-JP/data/products.yml b/translations/ja-JP/data/products.yml index 8f32a8160524..9068fbfa8242 100644 --- a/translations/ja-JP/data/products.yml +++ b/translations/ja-JP/data/products.yml @@ -4,7 +4,7 @@ #note this file should not be translated productsInOrder: - github - - enterpriseServer + - 管理 - actions - パッケージ - developers @@ -12,12 +12,3 @@ productsInOrder: - graphql - insights - desktop、 -#TODO this can be removed when the new versioning handling is in place -hasEnterpriseUserVersions: - - github - - actions - - developers - - rest - - graphql - - insights - - パッケージ diff --git a/translations/ja-JP/data/reusables/actions/about-artifact-log-retention.md b/translations/ja-JP/data/reusables/actions/about-artifact-log-retention.md new file mode 100644 index 000000000000..aa8a5300359d --- /dev/null +++ b/translations/ja-JP/data/reusables/actions/about-artifact-log-retention.md @@ -0,0 +1,6 @@ +By default, the artifacts and log files generated by workflows are retained for 90 days before they are automatically deleted. You can adjust the retention period, depending on the type of repository: + +- For public repositories: you can change this retention period to anywhere between 1 day or 90 days. +- For private, internal, and {% data variables.product.prodname_enterprise %} repositories: you can change this retention period to anywhere between 1 day or 400 days. + +When you customize the retention period, it only applies to new artifacts and log files, and does not retroactively apply to existing objects. For managed repositories and organizations, the maximum retention period cannot exceed the limit set by the managing organization or enterprise. diff --git a/translations/ja-JP/data/reusables/actions/about-artifacts.md b/translations/ja-JP/data/reusables/actions/about-artifacts.md index 99b604753e4b..232a96ad0971 100644 --- a/translations/ja-JP/data/reusables/actions/about-artifacts.md +++ b/translations/ja-JP/data/reusables/actions/about-artifacts.md @@ -1 +1 @@ -Artifacts enable you to share data between jobs in a workflow and store data once that workflow has completed. \ No newline at end of file +Artifacts enable you to share data between jobs in a workflow and store data once that workflow has completed. diff --git a/translations/ja-JP/data/reusables/actions/about-secrets.md b/translations/ja-JP/data/reusables/actions/about-secrets.md index 94b36e1c5846..9035067f833a 100644 --- a/translations/ja-JP/data/reusables/actions/about-secrets.md +++ b/translations/ja-JP/data/reusables/actions/about-secrets.md @@ -1 +1 @@ -Encrypted secrets allow you to store sensitive information, such as access tokens, in your repository or organization. \ No newline at end of file +Encrypted secrets allow you to store sensitive information, such as access tokens, in your repository or organization. diff --git a/translations/ja-JP/data/reusables/actions/about-self-hosted-runners.md b/translations/ja-JP/data/reusables/actions/about-self-hosted-runners.md index 0e2edd274acf..5ac03cc46b28 100644 --- a/translations/ja-JP/data/reusables/actions/about-self-hosted-runners.md +++ b/translations/ja-JP/data/reusables/actions/about-self-hosted-runners.md @@ -1 +1 @@ -Self-hosted runners allow you to host your own runners and customize the environment used to run jobs in your {% data variables.product.prodname_actions %} workflows. \ No newline at end of file +Self-hosted runners allow you to host your own runners and customize the environment used to run jobs in your {% data variables.product.prodname_actions %} workflows. diff --git a/translations/ja-JP/data/reusables/actions/about-workflow-jobs.md b/translations/ja-JP/data/reusables/actions/about-workflow-jobs.md index ba8ef85e4da8..33439420967f 100644 --- a/translations/ja-JP/data/reusables/actions/about-workflow-jobs.md +++ b/translations/ja-JP/data/reusables/actions/about-workflow-jobs.md @@ -1 +1 @@ -A workflow job is a set of steps that execute on the same runner. \ No newline at end of file +A workflow job is a set of steps that execute on the same runner. diff --git a/translations/ja-JP/data/reusables/actions/about-workflow-runs.md b/translations/ja-JP/data/reusables/actions/about-workflow-runs.md index fc10b8a30547..103cdc577724 100644 --- a/translations/ja-JP/data/reusables/actions/about-workflow-runs.md +++ b/translations/ja-JP/data/reusables/actions/about-workflow-runs.md @@ -1 +1 @@ -A workflow run is an instance of your workflow that runs when the pre-configured event occurs. \ No newline at end of file +A workflow run is an instance of your workflow that runs when the pre-configured event occurs. diff --git a/translations/ja-JP/data/reusables/actions/about-workflows.md b/translations/ja-JP/data/reusables/actions/about-workflows.md index 6ff1dd709ae1..3c044274d0f5 100644 --- a/translations/ja-JP/data/reusables/actions/about-workflows.md +++ b/translations/ja-JP/data/reusables/actions/about-workflows.md @@ -1 +1 @@ -Workflows automate your software development life cycle with a wide range of tools and services. \ No newline at end of file +Workflows automate your software development life cycle with a wide range of tools and services. diff --git a/translations/ja-JP/data/reusables/actions/actions-app-actions-permissions-api.md b/translations/ja-JP/data/reusables/actions/actions-app-actions-permissions-api.md index 251474c83b40..90dc3d003980 100644 --- a/translations/ja-JP/data/reusables/actions/actions-app-actions-permissions-api.md +++ b/translations/ja-JP/data/reusables/actions/actions-app-actions-permissions-api.md @@ -1 +1 @@ -{% data variables.product.prodname_github_app %}s must have the `actions` permission to use this API. \ No newline at end of file +{% data variables.product.prodname_github_app %}s must have the `actions` permission to use this API. diff --git a/translations/ja-JP/data/reusables/actions/actions-authentication.md b/translations/ja-JP/data/reusables/actions/actions-authentication.md index 266246660c6e..a047e0b5c463 100644 --- a/translations/ja-JP/data/reusables/actions/actions-authentication.md +++ b/translations/ja-JP/data/reusables/actions/actions-authentication.md @@ -1 +1 @@ -This API is available for authenticated users, {% data variables.product.prodname_oauth_app %}s, and {% data variables.product.prodname_github_app %}s. Access tokens require [`repo` scope](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes) for private repos and [`public_repo` scope](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes) for public repos. \ No newline at end of file +This API is available for authenticated users, {% data variables.product.prodname_oauth_app %}s, and {% data variables.product.prodname_github_app %}s. Access tokens require [`repo` scope](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes) for private repos and [`public_repo` scope](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes) for public repos. diff --git a/translations/ja-JP/data/reusables/actions/actions-not-verified.md b/translations/ja-JP/data/reusables/actions/actions-not-verified.md index b2a9577daa60..cb26fa9d61f6 100644 --- a/translations/ja-JP/data/reusables/actions/actions-not-verified.md +++ b/translations/ja-JP/data/reusables/actions/actions-not-verified.md @@ -1 +1 @@ -Anyone can publish an action in {% data variables.product.prodname_marketplace %} as long as they meet the terms of service. Unlike apps, {% data variables.product.prodname_actions %} listed in {% data variables.product.prodname_marketplace %} are not verified by {% data variables.product.prodname_dotcom %}. \ No newline at end of file +Anyone can publish an action in {% data variables.product.prodname_marketplace %} as long as they meet the terms of service. Unlike apps, {% data variables.product.prodname_actions %} listed in {% data variables.product.prodname_marketplace %} are not verified by {% data variables.product.prodname_dotcom %}. diff --git a/translations/ja-JP/data/reusables/actions/actions-use-policy-settings.md b/translations/ja-JP/data/reusables/actions/actions-use-policy-settings.md new file mode 100644 index 000000000000..b25cd5eb26be --- /dev/null +++ b/translations/ja-JP/data/reusables/actions/actions-use-policy-settings.md @@ -0,0 +1,3 @@ +If you choose the option to **Allow specific actions**, there are additional options that you can configure. For more information, see "[Allowing specific actions to run](#allowing-specific-actions-to-run)." + +When you allow local actions only, the policy blocks all access to actions authored by {% data variables.product.prodname_dotcom %}. For example, the [`actions/checkout`](https://github.com/actions/checkout) would not be accessible. \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/actions/allow-specific-actions-intro.md b/translations/ja-JP/data/reusables/actions/allow-specific-actions-intro.md new file mode 100644 index 000000000000..248668d773ef --- /dev/null +++ b/translations/ja-JP/data/reusables/actions/allow-specific-actions-intro.md @@ -0,0 +1,19 @@ +When you select the **Allow select actions**, there are additional options that you need to choose to configure the allowed actions: + +- **Allow actions created by {% data variables.product.prodname_dotcom %}:** You can allow all actions created by {% data variables.product.prodname_dotcom %} to be used by workflows. Actions created by {% data variables.product.prodname_dotcom %} are located in the `actions` and `github` organization. For more information, see the [`actions`](https://github.com/actions) and [`github`](https://github.com/github) organizations. +- **Allow Marketplace actions by verified creators:** You can allow all {% data variables.product.prodname_marketplace %} actions created by verified creators to be used by workflows. When GitHub has verified the creator of the action as a partner organization, the {% octicon "verified" aria-label="The verified badge" %} badge is displayed next to the action in {% data variables.product.prodname_marketplace %}. +- **Allow specified actions:** You can restrict workflows to use actions in specific organizations and repositories. + + To restrict access to specific tags or commit SHAs of an action, use the same `/@` syntax used in the workflow to select the action. For example, `actions/javascript-action@v1.0.1` to select a tag or `actions/javascript-action@172239021f7ba04fe7327647b213799853a9eb89` to select a SHA. For more information, see "[Finding and customizing actions](/actions/learn-github-actions/finding-and-customizing-actions#using-release-management-for-your-custom-actions)." + + You can use the `*` wildcard character to match patterns. For example, to allow all actions in organizations that start with `space-org`, you can specify `space-org*/*`. To add all actions in repositories that start with octocat, you can use `*/octocat*@*`. For more information about using the `*` wildcard, see "[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#filter-pattern-cheat-sheet)." + + {% if currentVersion == "free-pro-team@latest" %} + {% note %} + + **Note:** The **Allow specified actions** option is only available in public repositories with the {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} for organizations, or {% data variables.product.prodname_team %} plan. + + {% endnote %} + {% endif %} + +This procedure demonstrates how to add specific actions to the allow list. diff --git a/translations/ja-JP/data/reusables/actions/enterprise-actions-permissions.md b/translations/ja-JP/data/reusables/actions/enterprise-actions-permissions.md index b9abd7aecf3a..5262dd004303 100644 --- a/translations/ja-JP/data/reusables/actions/enterprise-actions-permissions.md +++ b/translations/ja-JP/data/reusables/actions/enterprise-actions-permissions.md @@ -1 +1 @@ -1. [Policies] で、オプションを選択します。 ![この Enterprise アカウントについてアクションを無効化、無効化、または制限](/assets/images/help/settings/actions-enable-enterprise-account.png) \ No newline at end of file +1. [Policies] で、オプションを選択します。 ![この Enterprise アカウントについてアクションを無効化、無効化、または制限](/assets/images/help/organizations/enterprise-actions-policy.png) diff --git a/translations/ja-JP/data/reusables/actions/enterprise-beta.md b/translations/ja-JP/data/reusables/actions/enterprise-beta.md index 876f328cd5c0..30eac75a9196 100644 --- a/translations/ja-JP/data/reusables/actions/enterprise-beta.md +++ b/translations/ja-JP/data/reusables/actions/enterprise-beta.md @@ -4,4 +4,4 @@ **Note:** {% data variables.product.prodname_actions %} support on {% data variables.product.prodname_ghe_server %} 2.22 is a limited public beta. To review the external storage requirements and request access to the beta, see "[Enabling {% data variables.product.prodname_actions %} and configuring storage](/enterprise/admin/github-actions/enabling-github-actions-and-configuring-storage)." {% endnote %} -{% endif %} \ No newline at end of file +{% endif %} diff --git a/translations/ja-JP/data/reusables/actions/enterprise-github-hosted-runners.md b/translations/ja-JP/data/reusables/actions/enterprise-github-hosted-runners.md index 1ef3c4ce19a6..178bf09abe72 100644 --- a/translations/ja-JP/data/reusables/actions/enterprise-github-hosted-runners.md +++ b/translations/ja-JP/data/reusables/actions/enterprise-github-hosted-runners.md @@ -4,4 +4,4 @@ **Note:** {% data variables.product.prodname_dotcom %}-hosted runners are not currently supported on {% data variables.product.prodname_ghe_server %}. You can see more information about planned future support on the [{% data variables.product.prodname_roadmap %}](https://github.com/github/roadmap/issues/72). {% endnote %} -{% endif %} \ No newline at end of file +{% endif %} diff --git a/translations/ja-JP/data/reusables/actions/registry-credentials.md b/translations/ja-JP/data/reusables/actions/registry-credentials.md new file mode 100644 index 000000000000..829539de7800 --- /dev/null +++ b/translations/ja-JP/data/reusables/actions/registry-credentials.md @@ -0,0 +1 @@ +If the image's container registry requires authentication to pull the image, you can use `credentials` to set a `map` of the `username` and `password`. The credentials are the same values that you would provide to the [`docker login`](https://docs.docker.com/engine/reference/commandline/login/) command. diff --git a/translations/ja-JP/data/reusables/actions/scheduled-workflows-disabled.md b/translations/ja-JP/data/reusables/actions/scheduled-workflows-disabled.md new file mode 100644 index 000000000000..bdec7e515b23 --- /dev/null +++ b/translations/ja-JP/data/reusables/actions/scheduled-workflows-disabled.md @@ -0,0 +1 @@ +To prevent unnecessary workflow runs, scheduled workflows may be disabled automatically. When a public repository is forked, scheduled workflows are disabled by default. In a public repository, scheduled workflows are automatically disabled when no repository activity has occurred in 60 days. diff --git a/translations/ja-JP/data/reusables/apps/deprecating_auth_with_query_parameters.md b/translations/ja-JP/data/reusables/apps/deprecating_auth_with_query_parameters.md index 724fa0616f73..0754e55f81e4 100644 --- a/translations/ja-JP/data/reusables/apps/deprecating_auth_with_query_parameters.md +++ b/translations/ja-JP/data/reusables/apps/deprecating_auth_with_query_parameters.md @@ -1,9 +1,9 @@ {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} {% warning %} -**非推奨の注意:** {% data variables.product.prodname_dotcom %}は、クエリパラメータを使ったAPIの認証を廃止します。 APIの認証は、[HTTPの基本認証](/v3/auth/#via-oauth-and-personal-access-tokens)で行うべきです。{% if currentVersion == "free-pro-team@latest" %}APIの認証をクエリパラメータで行うことは、2021年5月5日以降できなくなります。 {% endif %}予定された一時停止を含む詳しい情報については[ブログポスト](https://developer.github.com/changes/2020-02-10-deprecating-auth-through-query-param/)を参照してください。 +**非推奨の注意:** {% data variables.product.prodname_dotcom %}は、クエリパラメータを使ったAPIの認証を廃止します。 Authenticating to the API should be done with [HTTP basic authentication](/v3/auth/#via-oauth-and-personal-access-tokens).{% if currentVersion == "free-pro-team@latest" %} Using query parameters to authenticate to the API will no longer work on May 5, 2021. {% endif %}予定された一時停止を含む詳しい情報については[ブログポスト](https://developer.github.com/changes/2020-02-10-deprecating-auth-through-query-param/)を参照してください。 -{% if currentVersion != "free-pro-team@latest" %}クエリパラメータを使ったAPIの認証は、利用はできるものの、セキュリティ上の懸念からサポートされなくなりました。 その代わりに、インテグレータはアクセストークン、`client_id`もしくは`client_secret`をヘッダに移すことをおすすめします。 {% data variables.product.prodname_dotcom %}は、クエリパラメータによる認証の削除を、事前に通知します。 {% endif %} +{% if currentVersion != "free-pro-team@latest" %} Authentication to the API using query parameters while available is no longer supported due to security concerns. その代わりに、インテグレータはアクセストークン、`client_id`もしくは`client_secret`をヘッダに移すことをおすすめします。 {% data variables.product.prodname_dotcom %}は、クエリパラメータによる認証の削除を、事前に通知します。 {% endif %} {% endwarning %} {% endif %} diff --git a/translations/ja-JP/data/reusables/apps/deprecating_github_services_ghe.md b/translations/ja-JP/data/reusables/apps/deprecating_github_services_ghe.md index ebdcd4af063d..0690e7c2269f 100644 --- a/translations/ja-JP/data/reusables/apps/deprecating_github_services_ghe.md +++ b/translations/ja-JP/data/reusables/apps/deprecating_github_services_ghe.md @@ -1,7 +1,7 @@ {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.20" %} {% note %} -**Note:** GitHub Enterprise release 2.17 and higher no longer allows admins to install new GitHub Services, and existing services will stop working in GitHub Enterprise release 2.20 and higher. You can use the [Replacing GitHub Services guide](/v3/guides/replacing-github-services) to help you update your services to webhooks. +**ノート:** GitHub Enterprise リリース2.17以降では、管理者が新しいGitHub Servicesをインストールすることはできなくなっており、既存のサービスはGitHub Enterprise 2.20以降で動作しなくなります。 サービスをwebhookに更新するためには、[GitHub Servicesの置き換えガイド](/v3/guides/replacing-github-services)が利用できます。 {% endnote %} {% endif %} diff --git a/translations/ja-JP/data/reusables/apps/deprecating_password_auth.md b/translations/ja-JP/data/reusables/apps/deprecating_password_auth.md index 523e5dfb0cd4..db78ef5d5171 100644 --- a/translations/ja-JP/data/reusables/apps/deprecating_password_auth.md +++ b/translations/ja-JP/data/reusables/apps/deprecating_password_auth.md @@ -3,7 +3,7 @@ **非推奨の注意:** {% data variables.product.prodname_dotcom %}は、APIのパスワード認証を廃止します。 You must now authenticate to the {% data variables.product.prodname_dotcom %} API with an API token, such as an OAuth access token, GitHub App installation access token, or personal access token, depending on what you need to do with the token.{% if currentVersion == "free-pro-team@latest" %} Password authentication to the API will be removed on November 13, 2020.{% endif %} For more information,{% if currentVersion == "free-pro-team@latest" %} including scheduled brownouts,{% endif %} see the [blog post](https://developer.github.com/changes/2020-02-14-deprecating-password-auth/). -{% if currentVersion != "free-pro-team@latest" %}パスワードを使ったAPIの認証は現在利用可能で、{% data variables.product.prodname_ghe_server %}では非推奨になっていません。 {% data variables.product.prodname_dotcom %}は、この機能のサポートの削除に先立って、非推奨化を告知し、通知を行います。{% endif %} +{% if currentVersion != "free-pro-team@latest" %} Authenticating to the API using a password is currently available and not yet deprecated in {% data variables.product.prodname_ghe_server %}. {% data variables.product.prodname_dotcom %}は、この機能のサポートの削除に先立って、非推奨化を告知し、通知を行います。{% endif %} {% endwarning %} {% endif %} diff --git a/translations/ja-JP/data/reusables/apps/general-apps-restrictions.md b/translations/ja-JP/data/reusables/apps/general-apps-restrictions.md index 20e20ff5ecf4..3d59f0f6edb2 100644 --- a/translations/ja-JP/data/reusables/apps/general-apps-restrictions.md +++ b/translations/ja-JP/data/reusables/apps/general-apps-restrictions.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}If you are using your app with GitHub Actions and want to modify workflow files, you must authenticate on behalf of the user with an OAuth token that includes the `workflow` scope. The user must have admin or write permission to the repository that contains the workflow file. For more information, see "[Understanding scopes for OAuth apps](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)."{% endif %} \ No newline at end of file +{% if currentVersion == "free-pro-team@latest" %}If you are using your app with GitHub Actions and want to modify workflow files, you must authenticate on behalf of the user with an OAuth token that includes the `workflow` scope. The user must have admin or write permission to the repository that contains the workflow file. For more information, see "[Understanding scopes for OAuth apps](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)."{% endif %} diff --git a/translations/ja-JP/data/reusables/apps/maximum-github-apps-allowed.md b/translations/ja-JP/data/reusables/apps/maximum-github-apps-allowed.md index 93e063db4cb6..e1b7a44e3c28 100644 --- a/translations/ja-JP/data/reusables/apps/maximum-github-apps-allowed.md +++ b/translations/ja-JP/data/reusables/apps/maximum-github-apps-allowed.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}A user or organization can own up to 100 GitHub Apps.{% endif %} \ No newline at end of file +{% if currentVersion == "free-pro-team@latest" %}A user or organization can own up to 100 GitHub Apps.{% endif %} diff --git a/translations/ja-JP/data/reusables/apps/maximum-oauth-apps-allowed.md b/translations/ja-JP/data/reusables/apps/maximum-oauth-apps-allowed.md index b46e9b82c9dc..9e65b80fe2a6 100644 --- a/translations/ja-JP/data/reusables/apps/maximum-oauth-apps-allowed.md +++ b/translations/ja-JP/data/reusables/apps/maximum-oauth-apps-allowed.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}A user or organization can own up to 100 OAuth apps.{% endif %} \ No newline at end of file +{% if currentVersion == "free-pro-team@latest" %}A user or organization can own up to 100 OAuth apps.{% endif %} diff --git a/translations/ja-JP/data/reusables/apps/metadata-permissions.md b/translations/ja-JP/data/reusables/apps/metadata-permissions.md index 61bc044a800f..37608ebcb59c 100644 --- a/translations/ja-JP/data/reusables/apps/metadata-permissions.md +++ b/translations/ja-JP/data/reusables/apps/metadata-permissions.md @@ -1 +1 @@ -If you set the metadata permission to `No access` and select a permission that requires repository access, GitHub will override your selection and set the metadata permission back to `Read-only`. To set the metadata permission to `No access`, you must set all permissions that require repository access to `No access` first. \ No newline at end of file +If you set the metadata permission to `No access` and select a permission that requires repository access, GitHub will override your selection and set the metadata permission back to `Read-only`. To set the metadata permission to `No access`, you must set all permissions that require repository access to `No access` first. diff --git a/translations/ja-JP/data/reusables/apps/oauth-apps-restrictions.md b/translations/ja-JP/data/reusables/apps/oauth-apps-restrictions.md index 2ae56010bacc..fa81dbf36df1 100644 --- a/translations/ja-JP/data/reusables/apps/oauth-apps-restrictions.md +++ b/translations/ja-JP/data/reusables/apps/oauth-apps-restrictions.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}If you are using your OAuth App with GitHub Actions and want to modify workflow files, your OAuth token must have the `workflow` scope and the user must have owner or write permission to the repository that contains the workflow file. For more information, see "[Understanding scopes for OAuth apps](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)."{% endif %} \ No newline at end of file +{% if currentVersion == "free-pro-team@latest" %}If you are using your OAuth App with GitHub Actions and want to modify workflow files, your OAuth token must have the `workflow` scope and the user must have owner or write permission to the repository that contains the workflow file. For more information, see "[Understanding scopes for OAuth apps](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)."{% endif %} diff --git a/translations/ja-JP/data/reusables/apps/state_description.md b/translations/ja-JP/data/reusables/apps/state_description.md index fd754d2939f2..927d8b8a0071 100644 --- a/translations/ja-JP/data/reusables/apps/state_description.md +++ b/translations/ja-JP/data/reusables/apps/state_description.md @@ -1 +1 @@ -An unguessable random string. It is used to protect against cross-site request forgery attacks. \ No newline at end of file +An unguessable random string. It is used to protect against cross-site request forgery attacks. diff --git a/translations/ja-JP/data/reusables/audit_log/audit-log-search.md b/translations/ja-JP/data/reusables/audit_log/audit-log-search.md index 7620bbc14c7a..556cdab18cb2 100644 --- a/translations/ja-JP/data/reusables/audit_log/audit-log-search.md +++ b/translations/ja-JP/data/reusables/audit_log/audit-log-search.md @@ -8,7 +8,6 @@ テキストを使用してエントリを検索することはできません。 ただし、さまざまなフィルターを使用すれば検索クエリを作成できます。 ログを検索するときに使用される多くの演算子 (`-`、`>`、`<` など) は、{% data variables.product.product_name %} 全体で検索するものと同じ形式です。 詳細は「[{% data variables.product.prodname_dotcom %} での検索](/github/searching-for-information-on-github/about-searching-on-github)」を参照してください。 -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} #### 操作に基づく検索 `operation`修飾子は、アクションを特定の操作の種類に限定するときに使ってください。 例: @@ -20,7 +19,6 @@ * `operation:remove`は、既存のリソースが削除されたすべてのイベントを見つけます。 * `operation:restore`は、既存のリソースがリストアされたすべてのイベントを見つけます。 * `operation:transfer`は既存のリソースが移譲されたすべてのイベントを見つけます。 -{% endif %} #### リポジトリに基づく検索 diff --git a/translations/ja-JP/data/reusables/branches/change-default-branch.md b/translations/ja-JP/data/reusables/branches/change-default-branch.md new file mode 100644 index 000000000000..2a44e1845aa7 --- /dev/null +++ b/translations/ja-JP/data/reusables/branches/change-default-branch.md @@ -0,0 +1 @@ +You can change the default branch for an existing repository. For more information, see "[Changing the default branch](/github/administering-a-repository/changing-the-default-branch)." diff --git a/translations/ja-JP/data/reusables/branches/default-branch-automatically-base-branch.md b/translations/ja-JP/data/reusables/branches/default-branch-automatically-base-branch.md index 9350f601c269..b7e77330c423 100644 --- a/translations/ja-JP/data/reusables/branches/default-branch-automatically-base-branch.md +++ b/translations/ja-JP/data/reusables/branches/default-branch-automatically-base-branch.md @@ -1 +1,2 @@ -The default branch is the base branch in your repository, against which all pull requests and code commits are automatically made, unless you specify a different branch. \ No newline at end of file +Unless you specify a different branch, the default branch in a repository is the base branch for new pull requests and code commits. + diff --git a/translations/ja-JP/data/reusables/branches/new-repo-default-branch.md b/translations/ja-JP/data/reusables/branches/new-repo-default-branch.md index 99628077f836..d85e1174ba7f 100644 --- a/translations/ja-JP/data/reusables/branches/new-repo-default-branch.md +++ b/translations/ja-JP/data/reusables/branches/new-repo-default-branch.md @@ -1 +1,2 @@ -When you create a repository on {% data variables.product.prodname_dotcom %} with content, the repository is initialized with a single branch, called the default branch. \ No newline at end of file +When you create a repository with content on {% data variables.product.product_location %}, {% data variables.product.product_name %} creates the repository with a single branch. This first branch in the repository is the default branch. + diff --git a/translations/ja-JP/data/reusables/branches/set-default-branch.md b/translations/ja-JP/data/reusables/branches/set-default-branch.md index a36fcc41b762..f5ff905d85ca 100644 --- a/translations/ja-JP/data/reusables/branches/set-default-branch.md +++ b/translations/ja-JP/data/reusables/branches/set-default-branch.md @@ -1 +1 @@ -If you have admin permissions to a repository, you can change the default branch to another existing branch. For more information, see "[Setting the default branch](/github/administering-a-repository/setting-the-default-branch)." +You can set the name of the default branch for new repositories. For more information, see "[Managing the default branch for your repositories](/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories)," "[Managing the default branch name for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization)," or "[Enforcing a policy on the default branch name](/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account#enforcing-a-policy-on-the-default-branch-name)." diff --git a/translations/ja-JP/data/reusables/code-scanning/analyze-go.md b/translations/ja-JP/data/reusables/code-scanning/analyze-go.md new file mode 100644 index 000000000000..56f04cb3de4a --- /dev/null +++ b/translations/ja-JP/data/reusables/code-scanning/analyze-go.md @@ -0,0 +1 @@ +{% data variables.product.prodname_codeql %} also runs a build for Go projects to set up the project. However, in contrast to the other compiled languages, all Go files in the repository are extracted, not just those that are built. Custom build commands are not supported for Go. \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/code-scanning/autobuild-add-build-steps.md b/translations/ja-JP/data/reusables/code-scanning/autobuild-add-build-steps.md index 61f06aaba9d0..40b9ba69836b 100644 --- a/translations/ja-JP/data/reusables/code-scanning/autobuild-add-build-steps.md +++ b/translations/ja-JP/data/reusables/code-scanning/autobuild-add-build-steps.md @@ -1 +1 @@ -If the C/C++, C#, or Java code in your repository has a non-standard build process or if it's written in more than one compiled language, `autobuild` may fail. You will need to remove the `autobuild` step from the workflow, and manually add build steps. +If the C/C++, C#, or Java code in your repository has a non-standard build process, `autobuild` may fail. You will need to remove the `autobuild` step from the workflow, and manually add build steps. diff --git a/translations/ja-JP/data/reusables/code-scanning/autobuild-compiled-languages.md b/translations/ja-JP/data/reusables/code-scanning/autobuild-compiled-languages.md index d1b2bb062604..1e599d813b1b 100644 --- a/translations/ja-JP/data/reusables/code-scanning/autobuild-compiled-languages.md +++ b/translations/ja-JP/data/reusables/code-scanning/autobuild-compiled-languages.md @@ -1,5 +1 @@ -For compiled languages like C/C++, C#, and Java, the `autobuild` step in the default workflow attempts to build code before the action performs {% data variables.product.prodname_codeql %} analysis. 他のコンパイル言語とは対照的に、{% data variables.product.prodname_codeql %} はコードをビルドせずに Go を分析します。 - -The `autobuild` process only ever attempts to build _one_ compiled language for a repository. The language automatically selected for analysis is the language with most files. - - +For the supported compiled languages, you can use the `autobuild` action in the {% data variables.product.prodname_codeql_workflow %} to build your code. This avoids you having to specify explicit build commands for C/C++, C#, and Java. diff --git a/translations/ja-JP/data/reusables/code-scanning/beta-codeql-runner.md b/translations/ja-JP/data/reusables/code-scanning/beta-codeql-runner.md new file mode 100644 index 000000000000..f83682fcfaca --- /dev/null +++ b/translations/ja-JP/data/reusables/code-scanning/beta-codeql-runner.md @@ -0,0 +1,9 @@ +{% if currentVersion == "free-pro-team@latest" %} + +{% note %} + +**Note:** The {% data variables.product.prodname_codeql_runner %} is currently in beta and subject to change. + +{% endnote %} + +{% endif %} diff --git a/translations/ja-JP/data/reusables/code-scanning/beta.md b/translations/ja-JP/data/reusables/code-scanning/beta.md index 6876f6da4600..bb88f0dba41b 100644 --- a/translations/ja-JP/data/reusables/code-scanning/beta.md +++ b/translations/ja-JP/data/reusables/code-scanning/beta.md @@ -1,5 +1,9 @@ +{% if currentVersion == "enterprise-server@2.22" %} + {% note %} -**ノート:** {% data variables.product.prodname_code_scanning_capc %}は現在ベータで、変更されることがあります。 {% if currentVersion == "free-pro-team@latest" %}To request access to the beta, [join the waitlist](https://github.com/features/security/advanced-security/signup).{% else %}If your organization has an {% data variables.product.prodname_advanced_security %} license, you can [join the beta program](https://resources.github.com/beta-signup/).{% endif %} +**ノート:** {% data variables.product.prodname_code_scanning_capc %}は現在ベータで、変更されることがあります。 For more information about taking part in the beta, [sign up here](https://resources.github.com/beta-signup/). {% endnote %} + +{% endif %} diff --git a/translations/ja-JP/data/reusables/code-scanning/click-alert-in-list.md b/translations/ja-JP/data/reusables/code-scanning/click-alert-in-list.md index cad26341921c..fe596fbae259 100644 --- a/translations/ja-JP/data/reusables/code-scanning/click-alert-in-list.md +++ b/translations/ja-JP/data/reusables/code-scanning/click-alert-in-list.md @@ -1 +1 @@ -1. "Code scanning（コードスキャンニング）"の下で、表示させたいアラートをクリックしてください。 ![{% data variables.product.prodname_code_scanning %}からのアラートのリスト](/assets/images/help/repository/code-scanning-click-alert.png) +1. Under "Code scanning," click the alert you'd like to explore. ![{% data variables.product.prodname_code_scanning %}からのアラートのリスト](/assets/images/help/repository/code-scanning-click-alert.png) diff --git a/translations/ja-JP/data/reusables/code-scanning/close-alert-examples.md b/translations/ja-JP/data/reusables/code-scanning/close-alert-examples.md new file mode 100644 index 000000000000..394120901f5f --- /dev/null +++ b/translations/ja-JP/data/reusables/code-scanning/close-alert-examples.md @@ -0,0 +1 @@ +For example, an error in code that's used only for testing, or when the effort of fixing the error is greater than the potential benefit of improving the code. diff --git a/translations/ja-JP/data/reusables/code-scanning/codeql-runner-license.md b/translations/ja-JP/data/reusables/code-scanning/codeql-runner-license.md index 17283fb710b2..96d197d8dc19 100644 --- a/translations/ja-JP/data/reusables/code-scanning/codeql-runner-license.md +++ b/translations/ja-JP/data/reusables/code-scanning/codeql-runner-license.md @@ -1,10 +1,12 @@ {% note %} {% if currentVersion == "free-pro-team@latest" %} -**Note:** The {% data variables.product.prodname_codeql_runner %} uses the {% data variables.product.prodname_codeql %} CLI to analyze code and therefore has the same license conditions. It's free to use on public repositories that are maintained on {% data variables.product.prodname_dotcom_the_website %}, and available to use on private repositories that are owned by customers with an {% data variables.product.prodname_advanced_security %} license. For information, see "[{% data variables.product.product_name %} {% data variables.product.prodname_codeql %} Terms and Conditions](https://securitylab.github.com/tools/codeql/license)" and "[{% data variables.product.prodname_codeql %} CLI](https://help.semmle.com/codeql/codeql-cli.html)." +**Note:** The +{% data variables.product.prodname_codeql_runner %} uses the {% data variables.product.prodname_codeql %} CLI to analyze code and therefore has the same license conditions. It's free to use on public repositories that are maintained on {% data variables.product.prodname_dotcom_the_website %}, and available to use on private repositories that are owned by customers with an {% data variables.product.prodname_advanced_security %} license. For information, see "[{% data variables.product.product_name %} {% data variables.product.prodname_codeql %} Terms and Conditions](https://securitylab.github.com/tools/codeql/license)" and "[{% data variables.product.prodname_codeql %} CLI](https://help.semmle.com/codeql/codeql-cli.html)." {% else %} -**Note:** The {% data variables.product.prodname_codeql_runner %} is available to customers with an {% data variables.product.prodname_advanced_security %} license. +**Note:** The +{% data variables.product.prodname_codeql_runner %} is available to customers with an {% data variables.product.prodname_advanced_security %} license. {% endif %} -{% endnote %} \ No newline at end of file +{% endnote %} diff --git a/translations/ja-JP/data/reusables/code-scanning/edit-workflow.md b/translations/ja-JP/data/reusables/code-scanning/edit-workflow.md index 1e5f1900e925..c1fa2165e3fa 100644 --- a/translations/ja-JP/data/reusables/code-scanning/edit-workflow.md +++ b/translations/ja-JP/data/reusables/code-scanning/edit-workflow.md @@ -1 +1 @@ -通常、{% data variables.product.prodname_code_scanning %} のデフォルトのワークフローを編集する必要はありません。 However, if required, you can edit the workflow to customize some of the settings. For example, you can edit {% data variables.product.prodname_dotcom %}'s {% data variables.product.prodname_codeql_workflow %} to specify the frequency of scans, the languages or directories to scan, and what {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} looks for in your code. You might also need to edit the workflow if you use a specific set of commands to compile your code or if there is more than one compiled language in your repository. +通常、{% data variables.product.prodname_code_scanning %} のデフォルトのワークフローを編集する必要はありません。 However, if required, you can edit the workflow to customize some of the settings. For example, you can edit {% data variables.product.prodname_dotcom %}'s {% data variables.product.prodname_codeql_workflow %} to specify the frequency of scans, the languages or directories to scan, and what {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} looks for in your code. You might also need to edit the {% data variables.product.prodname_codeql_workflow %} if you use a specific set of commands to compile your code. diff --git a/translations/ja-JP/data/reusables/code-scanning/enabling-options.md b/translations/ja-JP/data/reusables/code-scanning/enabling-options.md index 6b1c8b1a10b9..3ef6731b266a 100644 --- a/translations/ja-JP/data/reusables/code-scanning/enabling-options.md +++ b/translations/ja-JP/data/reusables/code-scanning/enabling-options.md @@ -28,4 +28,4 @@ Using {% data variables.product.prodname_actions %} (see "Enabling {% data variables.product.prodname_code_scanning %} using actions") or generated externally and uploaded to {% data variables.product.product_name %} (see "Uploading a SARIF file to {% data variables.product.prodname_dotcom %}"). - \ No newline at end of file + diff --git a/translations/ja-JP/data/reusables/code-scanning/false-positive-fix-codeql.md b/translations/ja-JP/data/reusables/code-scanning/false-positive-fix-codeql.md new file mode 100644 index 000000000000..db3da9c9d538 --- /dev/null +++ b/translations/ja-JP/data/reusables/code-scanning/false-positive-fix-codeql.md @@ -0,0 +1 @@ +If you close a {% data variables.product.prodname_codeql %} alert as a false positive result, for example because the code uses a sanitization library that isn't supported, consider contributing to the {% data variables.product.prodname_codeql %} repository and improving the analysis. For more information about {% data variables.product.prodname_codeql %}, see "[Contributing to {% data variables.product.prodname_codeql %}](https://github.com/github/codeql/blob/main/CONTRIBUTING.md)." diff --git a/translations/ja-JP/data/reusables/code-scanning/interoperable-with-tools-that-output-sarif.md b/translations/ja-JP/data/reusables/code-scanning/interoperable-with-tools-that-output-sarif.md index 78856afff03e..5073e93cb865 100644 --- a/translations/ja-JP/data/reusables/code-scanning/interoperable-with-tools-that-output-sarif.md +++ b/translations/ja-JP/data/reusables/code-scanning/interoperable-with-tools-that-output-sarif.md @@ -1 +1 @@ -{% data variables.product.prodname_code_scanning_capc %}は、Static Analysis Results Interchange Format (SARIF) データを出力するサードパーティのコードスキャンニングツールと相互運用できます。 SARIFはオープン標準です。 詳しい情報については「[{% data variables.product.prodname_code_scanning %}のためのSARIF出力](/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning)」を参照してください。 \ No newline at end of file +{% data variables.product.prodname_code_scanning_capc %}は、Static Analysis Results Interchange Format (SARIF) データを出力するサードパーティのコードスキャンニングツールと相互運用できます。 SARIFはオープン標準です。 詳しい情報については「[{% data variables.product.prodname_code_scanning %}のためのSARIF出力](/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning)」を参照してください。 diff --git a/translations/ja-JP/data/reusables/code-scanning/run-additional-queries.md b/translations/ja-JP/data/reusables/code-scanning/run-additional-queries.md index 360fb140e091..42d1070adea9 100644 --- a/translations/ja-JP/data/reusables/code-scanning/run-additional-queries.md +++ b/translations/ja-JP/data/reusables/code-scanning/run-additional-queries.md @@ -1,4 +1,4 @@ -When you use {% data variables.product.prodname_codeql %} to scan code, the {% data variables.product.prodname_codeql %} analysis engine generates a database from the code and runs queries on it. 詳しい情報については、「[{% data variables.product.prodname_code_scanning %} について](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning#about-codeql)」を参照してください。 +When you use {% data variables.product.prodname_codeql %} to scan code, the {% data variables.product.prodname_codeql %} analysis engine generates a database from the code and runs queries on it. For more information, see "[About {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning#about-codeql)." {% data variables.product.prodname_codeql %} analysis uses a default set of queries, but you can specify more queries to run, in addition to the default queries. 実行するクエリは、{% data variables.product.prodname_ql %} パックに属している必要があり、独自のリポジトリまたは任意のパブリックリポジトリに格納することができます。 詳しい情報については、「[{% data variables.product.prodname_ql %} パックについて](https://help.semmle.com/codeql/codeql-cli/reference/qlpack-overview.html)」を参照してください。 diff --git a/translations/ja-JP/data/reusables/code-scanning/specify-language-to-analyze.md b/translations/ja-JP/data/reusables/code-scanning/specify-language-to-analyze.md index 16233580cd1d..301d4bd8b36f 100644 --- a/translations/ja-JP/data/reusables/code-scanning/specify-language-to-analyze.md +++ b/translations/ja-JP/data/reusables/code-scanning/specify-language-to-analyze.md @@ -1 +1 @@ -リポジトリに複数の言語のコードが含まれている場合は、分析する言語を指定できます。 言語が分析されないようにする理由はいくつかあります。 たとえば、プロジェクトには、コードの本文とは異なる言語の依存関係があり、それらの依存関係のアラートを表示する必要がない場合があります。 +If your repository contains code in more than one of the supported languages, you can choose which languages you want to analyze. 言語が分析されないようにする理由はいくつかあります。 たとえば、プロジェクトには、コードの本文とは異なる言語の依存関係があり、それらの依存関係のアラートを表示する必要がない場合があります。 diff --git a/translations/ja-JP/data/reusables/codespaces/about-billing-for-codespaces.md b/translations/ja-JP/data/reusables/codespaces/about-billing-for-codespaces.md new file mode 100644 index 000000000000..8a1128db5e3c --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/about-billing-for-codespaces.md @@ -0,0 +1 @@ +{% data variables.product.prodname_codespaces %} is free to use during the beta. When {% data variables.product.prodname_codespaces %} becomes generally available, you will be billed for storage and compute usage. diff --git a/translations/ja-JP/data/reusables/codespaces/click-remote-explorer-icon-vscode.md b/translations/ja-JP/data/reusables/codespaces/click-remote-explorer-icon-vscode.md index 4400acc1c9a7..af85b5328743 100644 --- a/translations/ja-JP/data/reusables/codespaces/click-remote-explorer-icon-vscode.md +++ b/translations/ja-JP/data/reusables/codespaces/click-remote-explorer-icon-vscode.md @@ -1 +1 @@ -1. {% data variables.product.prodname_vscode %}の左サイドバーで、 Remote Explorerのアイコンをクリックしてください。 ![{% data variables.product.prodname_vscode %}のRemote Explorerアイコン](/assets/images/help/codespaces/click-remote-explorer-icon-vscode.png) \ No newline at end of file +1. {% data variables.product.prodname_vscode %}の左サイドバーで、 Remote Explorerのアイコンをクリックしてください。 ![{% data variables.product.prodname_vscode %}のRemote Explorerアイコン](/assets/images/help/codespaces/click-remote-explorer-icon-vscode.png) diff --git a/translations/ja-JP/data/reusables/codespaces/codespaces-are-per-branch.md b/translations/ja-JP/data/reusables/codespaces/codespaces-are-per-branch.md index 43eb255a00d5..06d2a0b13ed6 100644 --- a/translations/ja-JP/data/reusables/codespaces/codespaces-are-per-branch.md +++ b/translations/ja-JP/data/reusables/codespaces/codespaces-are-per-branch.md @@ -1 +1 @@ -各codespaceはリポジトリの特定ブランチと関連づけられます。 \ No newline at end of file +各codespaceはリポジトリの特定ブランチと関連づけられます。 diff --git a/translations/ja-JP/data/reusables/codespaces/codespaces-are-personal.md b/translations/ja-JP/data/reusables/codespaces/codespaces-are-personal.md index 69310cdca6fc..3b8cd5ea2617 100644 --- a/translations/ja-JP/data/reusables/codespaces/codespaces-are-personal.md +++ b/translations/ja-JP/data/reusables/codespaces/codespaces-are-personal.md @@ -1 +1 @@ -各コードスペースは、作成者だけが利用できます。 他者のcodespaceで作業することはできません。 \ No newline at end of file +各コードスペースは、作成者だけが利用できます。 他者のcodespaceで作業することはできません。 diff --git a/translations/ja-JP/data/reusables/codespaces/connect-to-codespace-from-vscode.md b/translations/ja-JP/data/reusables/codespaces/connect-to-codespace-from-vscode.md index 3eef57f10055..15e5e94621b4 100644 --- a/translations/ja-JP/data/reusables/codespaces/connect-to-codespace-from-vscode.md +++ b/translations/ja-JP/data/reusables/codespaces/connect-to-codespace-from-vscode.md @@ -1 +1 @@ -{% data variables.product.prodname_vscode %}から直接codespaceに接続できます。 詳しい情報については「[{% data variables.product.prodname_vscode %}からのcodespaceへの接続](/github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code)」を参照してください。 \ No newline at end of file +{% data variables.product.prodname_vscode %}から直接codespaceに接続できます。 For more information, see "[Using Codespaces in {% data variables.product.prodname_vscode %}](/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code)." diff --git a/translations/ja-JP/data/reusables/codespaces/devcontainer-location.md b/translations/ja-JP/data/reusables/codespaces/devcontainer-location.md new file mode 100644 index 000000000000..196fc006be1a --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/devcontainer-location.md @@ -0,0 +1 @@ +This file can be located in the root of the repository or in a folder called `.devcontainer`. If the file is located in the root of the repository, the filename must begin with a period: `.devcontainer.json`. diff --git a/translations/ja-JP/data/reusables/codespaces/navigate-to-codespaces.md b/translations/ja-JP/data/reusables/codespaces/navigate-to-codespaces.md index 8127eabc10d3..46fba2d2917f 100644 --- a/translations/ja-JP/data/reusables/codespaces/navigate-to-codespaces.md +++ b/translations/ja-JP/data/reusables/codespaces/navigate-to-codespaces.md @@ -1 +1 @@ -1. 任意のページの上部で**Codespaces**をクリックしてください。 ![ヘッダの{% data variables.product.prodname_codespaces %}リンク](/assets/images/help/codespaces/header-link.png) \ No newline at end of file +1. 任意のページの上部で**Codespaces**をクリックしてください。 ![ヘッダの{% data variables.product.prodname_codespaces %}リンク](/assets/images/help/codespaces/header-link.png) diff --git a/translations/ja-JP/data/reusables/codespaces/release-stage.md b/translations/ja-JP/data/reusables/codespaces/release-stage.md index 1ac3f8c85960..e190ef47ab00 100644 --- a/translations/ja-JP/data/reusables/codespaces/release-stage.md +++ b/translations/ja-JP/data/reusables/codespaces/release-stage.md @@ -1,5 +1,5 @@ {% note %} -**注釈:** {% data variables.product.prodname_codespaces %} は現在限定パブリックベータであり、変更されることがあります。 ベータ期間中、 {% data variables.product.prodname_dotcom %} は {% data variables.product.prodname_codespaces %} の可用性について一切の保証を行いません。 ベータへの参加に関する詳しい情報については「[{% data variables.product.prodname_codespaces %}について](/github/developing-online-with-codespaces/about-codespaces#joining-the-beta)」を参照してください。 +**注釈:** {% data variables.product.prodname_codespaces %} は現在限定パブリックベータであり、変更されることがあります。 ベータ期間中、{% data variables.product.prodname_dotcom %}は{% data variables.product.prodname_codespaces %}の可用性について保証しません。 ベータへの参加に関する詳しい情報については「[{% data variables.product.prodname_codespaces %}について](/github/developing-online-with-codespaces/about-codespaces#joining-the-beta)」を参照してください。 -{% endnote %} \ No newline at end of file +{% endnote %} diff --git a/translations/ja-JP/data/reusables/codespaces/unsupported-repos.md b/translations/ja-JP/data/reusables/codespaces/unsupported-repos.md index 73ba11f77bbb..a7046ae35a12 100644 --- a/translations/ja-JP/data/reusables/codespaces/unsupported-repos.md +++ b/translations/ja-JP/data/reusables/codespaces/unsupported-repos.md @@ -1 +1 @@ -ベータの期間、Organizationが所有するプライベートリポジトリ、あるいはSAMLシングルサインオンを必要とするOrganizationが所有するリポジトリはサポートされません。 \ No newline at end of file +ベータの期間、Organizationが所有するプライベートリポジトリ、あるいはSAMLシングルサインオンを必要とするOrganizationが所有するリポジトリはサポートされません。 diff --git a/translations/ja-JP/data/reusables/codespaces/use-visual-studio-features.md b/translations/ja-JP/data/reusables/codespaces/use-visual-studio-features.md index e4ae89fff474..a470336f13f6 100644 --- a/translations/ja-JP/data/reusables/codespaces/use-visual-studio-features.md +++ b/translations/ja-JP/data/reusables/codespaces/use-visual-studio-features.md @@ -1 +1 @@ -codespaceをオープンした後は、テキスト編集、デバッギング、Gitコマンドといった{% data variables.product.prodname_vscode %}の機能を使って開発を行えます。 詳しい情報については[{% data variables.product.prodname_vscode %}のドキュメンテーション](https://code.visualstudio.com/docs)を参照してください。 +You can edit code, debug, and use Git commands while developing in a codespace with {% data variables.product.prodname_vscode %}. 詳しい情報については[{% data variables.product.prodname_vscode %}のドキュメンテーション](https://code.visualstudio.com/docs)を参照してください。 diff --git a/translations/ja-JP/data/reusables/codespaces/you-can-see-all-your-codespaces.md b/translations/ja-JP/data/reusables/codespaces/you-can-see-all-your-codespaces.md index 488588f16c5b..cfb19b873183 100644 --- a/translations/ja-JP/data/reusables/codespaces/you-can-see-all-your-codespaces.md +++ b/translations/ja-JP/data/reusables/codespaces/you-can-see-all-your-codespaces.md @@ -1 +1 @@ -[github.com/codespaces](https://github.com/codespaces)で、自分のユーザアカウントが所有しているすべてのcodespaceを見ることができます。 \ No newline at end of file +[github.com/codespaces](https://github.com/codespaces)で、自分のユーザアカウントが所有しているすべてのcodespaceを見ることができます。 diff --git a/translations/ja-JP/data/reusables/command_line/git-clone-url.md b/translations/ja-JP/data/reusables/command_line/git-clone-url.md index 3e26cad68086..64067cf8bca2 100644 --- a/translations/ja-JP/data/reusables/command_line/git-clone-url.md +++ b/translations/ja-JP/data/reusables/command_line/git-clone-url.md @@ -1,4 +1,4 @@ 5. `git clone` と入力し、前の手順でコピーした URL を貼り付けます。 ```shell $ git clone https://{% data variables.command_line.codeblock %}/YOUR-USERNAME/YOUR-REPOSITORY - ``` \ No newline at end of file + ``` diff --git a/translations/ja-JP/data/reusables/command_line/provide-an-access-token.md b/translations/ja-JP/data/reusables/command_line/provide-an-access-token.md index e0290df9ed7f..f727d81df515 100644 --- a/translations/ja-JP/data/reusables/command_line/provide-an-access-token.md +++ b/translations/ja-JP/data/reusables/command_line/provide-an-access-token.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}SAML SSOを使っているOrganizationにアクセスしているなら、認証を受ける前にOrganizationにアクセスするための個人アクセストークンの認可もしなければなりません。 詳しい情報については「[SAMLシングルサインオンでの認証について](/github/authenticating-to-github/about-authentication-with-saml-single-sign-on)」及び「[SAMLシングルサインオンで利用する個人アクセストークンの認可](/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on)」を参照してください。{% endif %} +{% if currentVersion == "free-pro-team@latest" %}If you are accessing an organization that uses SAML SSO, you must also authorize your personal access token to access the organization before you authenticate. 詳しい情報については「[SAMLシングルサインオンでの認証について](/github/authenticating-to-github/about-authentication-with-saml-single-sign-on)」及び「[SAMLシングルサインオンで利用する個人アクセストークンの認可](/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on)」を参照してください。{% endif %} diff --git a/translations/ja-JP/data/reusables/dependabot/check-in-dependabot-yml.md b/translations/ja-JP/data/reusables/dependabot/check-in-dependabot-yml.md index adf165bce2b5..3480e9ddb107 100644 --- a/translations/ja-JP/data/reusables/dependabot/check-in-dependabot-yml.md +++ b/translations/ja-JP/data/reusables/dependabot/check-in-dependabot-yml.md @@ -1 +1 @@ -1. リポジトリ内の *.github* ディレクトリにある `dependabot.yml` 設定ファイルを確認します。 \ No newline at end of file +1. リポジトリ内の *.github* ディレクトリにある `dependabot.yml` 設定ファイルを確認します。 diff --git a/translations/ja-JP/data/reusables/dependabot/create-dependabot-yml.md b/translations/ja-JP/data/reusables/dependabot/create-dependabot-yml.md index 59ebfe8f7bfa..338034f23301 100644 --- a/translations/ja-JP/data/reusables/dependabot/create-dependabot-yml.md +++ b/translations/ja-JP/data/reusables/dependabot/create-dependabot-yml.md @@ -1 +1 @@ -1. *dependabot.yml* 設定ファイルを作成します。 \ No newline at end of file +1. *dependabot.yml* 設定ファイルを作成します。 diff --git a/translations/ja-JP/data/reusables/dependabot/default-dependencies-allow-ignore.md b/translations/ja-JP/data/reusables/dependabot/default-dependencies-allow-ignore.md index 63520f358ae0..a0727896ab1c 100644 --- a/translations/ja-JP/data/reusables/dependabot/default-dependencies-allow-ignore.md +++ b/translations/ja-JP/data/reusables/dependabot/default-dependencies-allow-ignore.md @@ -1 +1 @@ -デフォルトでは、マニフェストあるいはロックファイルで明示的に定義されたすべての依存関係は、最新の状態に保たれます。 バージョンアップデートでどの依存関係を管理するかは、`allow`と`ignore`を使ってカスタマイズできます。 {% data variables.product.prodname_dependabot %}は許可されたすべての依存関係をチェックし、それから蒸しされた依存関係やバージョンをフィルタリングします。 そのため、`allow`と`ignore`の両方にマッチした依存関係は無視されます。 \ No newline at end of file +デフォルトでは、マニフェストあるいはロックファイルで明示的に定義されたすべての依存関係は、最新の状態に保たれます。 バージョンアップデートでどの依存関係を管理するかは、`allow`と`ignore`を使ってカスタマイズできます。 {% data variables.product.prodname_dependabot %}は許可されたすべての依存関係をチェックし、それから蒸しされた依存関係やバージョンをフィルタリングします。 そのため、`allow`と`ignore`の両方にマッチした依存関係は無視されます。 diff --git a/translations/ja-JP/data/reusables/dependabot/dependabot-tos.md b/translations/ja-JP/data/reusables/dependabot/dependabot-tos.md index d52b0b03405b..a72c36c5a119 100644 --- a/translations/ja-JP/data/reusables/dependabot/dependabot-tos.md +++ b/translations/ja-JP/data/reusables/dependabot/dependabot-tos.md @@ -1 +1 @@ -{% data variables.product.prodname_dependabot %} and all related features are covered by [{% data variables.product.prodname_dotcom %}'s Terms of Service](/github/site-policy/github-terms-of-service). \ No newline at end of file +{% data variables.product.prodname_dependabot %} and all related features are covered by [{% data variables.product.prodname_dotcom %}'s Terms of Service](/github/site-policy/github-terms-of-service). diff --git a/translations/ja-JP/data/reusables/dependabot/option-affects-security-updates.md b/translations/ja-JP/data/reusables/dependabot/option-affects-security-updates.md index d9744f0d011e..55fd74c7c8dd 100644 --- a/translations/ja-JP/data/reusables/dependabot/option-affects-security-updates.md +++ b/translations/ja-JP/data/reusables/dependabot/option-affects-security-updates.md @@ -1 +1 @@ -このオプションの設定も、`target-branch`を使って非デフォルトブランチのバージョンアップデートをチェックしないかぎり、このパッケージマネージャのマニフェストファイルに対するセキュリティアップデートのプルリクエストに影響します。 \ No newline at end of file +このオプションの設定も、`target-branch`を使って非デフォルトブランチのバージョンアップデートをチェックしないかぎり、このパッケージマネージャのマニフェストファイルに対するセキュリティアップデートのプルリクエストに影響します。 diff --git a/translations/ja-JP/data/reusables/dependabot/private-dependencies.md b/translations/ja-JP/data/reusables/dependabot/private-dependencies.md index 1ba08ff8f048..dfcbae9c7300 100644 --- a/translations/ja-JP/data/reusables/dependabot/private-dependencies.md +++ b/translations/ja-JP/data/reusables/dependabot/private-dependencies.md @@ -1 +1 @@ -Currently, {% data variables.product.prodname_dependabot_version_updates %} doesn't support manifest or lock files that contain any private git dependencies or private git registries. This is because, when running version updates, {% data variables.product.prodname_dependabot_short %} must be able to resolve all dependencies from their source to verify that version updates have been successful. \ No newline at end of file +Currently, {% data variables.product.prodname_dependabot_version_updates %} doesn't support manifest or lock files that contain any private git dependencies or private git registries. This is because, when running version updates, {% data variables.product.prodname_dependabot_short %} must be able to resolve all dependencies from their source to verify that version updates have been successful. diff --git a/translations/ja-JP/data/reusables/dependabot/supported-package-managers.md b/translations/ja-JP/data/reusables/dependabot/supported-package-managers.md index 3443dac951b7..0dd99cb10417 100644 --- a/translations/ja-JP/data/reusables/dependabot/supported-package-managers.md +++ b/translations/ja-JP/data/reusables/dependabot/supported-package-managers.md @@ -1,15 +1,29 @@ -- Bundler: `bundler` -- Cargo: `cargo` -- Composer: `composer` -- Docker: `docker` -- Elm: `elm` -- gitサブモジュール:`gitsubmodule` -- GitHub Actions: `github-actions` -- Goモジュール:`gomod` -- Gradle: `gradle` -- Maven: `maven` -- Mix: `mix` -- npm: `npm` -- NuGet: `nuget` -- pip: `pip` -- Terraform: `terraform` +| パッケージマネージャー | Supports vendoring | +| -------------------------------- |:------------------:| +| Bundler: `bundler` | **X** | +| Cargo: `cargo` | | +| Composer: `composer` | | +| Docker: `docker` | | +| Elm: `elm` | | +| gitサブモジュール:`gitsubmodule` | | +| GitHub Actions: `github-actions` | | +| Goモジュール:`gomod` | | +| Gradle: `gradle` | | +| Maven: `maven` | | +| Mix: `mix` | | +| npm: `npm` | | +| NuGet: `nuget` | | +| pip: `pip` | | +| Terraform: `terraform` | | + +{% note %} + +**Note**: {% data variables.product.prodname_dependabot_short %} also supports the following package managers: + +-`yarn` (v1 only) (specify `npm`) + +-`pipenv`, `pip-compile`, and `poetry` (specify `pip`) + +For example, if you use `poetry` to manage your Python dependencies and want {% data variables.product.prodname_dependabot_short %} to monitor your dependency manifest file for new versions, use `package-ecosystem: "pip"` in your *dependabot.yml* file. + +{% endnote %} diff --git a/translations/ja-JP/data/reusables/desktop/choose-a-theme.md b/translations/ja-JP/data/reusables/desktop/choose-a-theme.md index a40eda3961f7..a939199e1ba2 100644 --- a/translations/ja-JP/data/reusables/desktop/choose-a-theme.md +++ b/translations/ja-JP/data/reusables/desktop/choose-a-theme.md @@ -1,2 +1,2 @@ 3. ** Appearance（外観）**をクリックしてください。 -4. 使いたいテーマをクリックしてください。 あるいは、{% data variables.product.prodname_desktop %}が自分のコンピュータのテーマと常にマッチするようにしたいのであれば、**Automatically switch theme to match system（システムにマッチするように自動的にテーマを切り替え）**を選択することもできます。 \ No newline at end of file +4. 使いたいテーマをクリックしてください。 あるいは、{% data variables.product.prodname_desktop %}が自分のコンピュータのテーマと常にマッチするようにしたいのであれば、**Automatically switch theme to match system（システムにマッチするように自動的にテーマを切り替え）**を選択することもできます。 diff --git a/translations/ja-JP/data/reusables/desktop/confirm-tag.md b/translations/ja-JP/data/reusables/desktop/confirm-tag.md index 3b37dd47f603..e32c640c9e03 100644 --- a/translations/ja-JP/data/reusables/desktop/confirm-tag.md +++ b/translations/ja-JP/data/reusables/desktop/confirm-tag.md @@ -1 +1 @@ -1. **Create Tag（タグの作成）**をクリックしてください。 \ No newline at end of file +1. **Create Tag（タグの作成）**をクリックしてください。 diff --git a/translations/ja-JP/data/reusables/desktop/create-tag.md b/translations/ja-JP/data/reusables/desktop/create-tag.md index 20e03909127f..6e5d52cf42b8 100644 --- a/translations/ja-JP/data/reusables/desktop/create-tag.md +++ b/translations/ja-JP/data/reusables/desktop/create-tag.md @@ -1 +1 @@ -1. コミットを右クリックして、**Create Tag...（タグを作成...）**をクリックしてください。 ![タグの作成メニューアイテムの選択](/assets/images/help/desktop/select-create-tag.png) \ No newline at end of file +1. コミットを右クリックして、**Create Tag...（タグを作成...）**をクリックしてください。 ![タグの作成メニューアイテムの選択](/assets/images/help/desktop/select-create-tag.png) diff --git a/translations/ja-JP/data/reusables/desktop/revert-commit.md b/translations/ja-JP/data/reusables/desktop/revert-commit.md index 2fe98c4f7b59..4ebb8d610012 100644 --- a/translations/ja-JP/data/reusables/desktop/revert-commit.md +++ b/translations/ja-JP/data/reusables/desktop/revert-commit.md @@ -1 +1 @@ -1. 打ち消したいコミットを右クリックして、**Revert This Commit（このコミットを打ち消し）**をクリックしてください。 \ No newline at end of file +1. 打ち消したいコミットを右クリックして、**Revert This Commit（このコミットを打ち消し）**をクリックしてください。 diff --git a/translations/ja-JP/data/reusables/desktop/select-base-branch.md b/translations/ja-JP/data/reusables/desktop/select-base-branch.md index 2c48dd6bcdfa..de87a5d1d567 100644 --- a/translations/ja-JP/data/reusables/desktop/select-base-branch.md +++ b/translations/ja-JP/data/reusables/desktop/select-base-branch.md @@ -1 +1 @@ -1. 新しいブランチのベースとして、カレントブランチもしくはデフォルトブランチ (通常は master) を選択してください。 +1. Use the drop-down to choose a base branch for your new branch. diff --git a/translations/ja-JP/data/reusables/dotcom_billing/add-seats.md b/translations/ja-JP/data/reusables/dotcom_billing/add-seats.md index 4acbd98737a5..649e2f25b942 100644 --- a/translations/ja-JP/data/reusables/dotcom_billing/add-seats.md +++ b/translations/ja-JP/data/reusables/dotcom_billing/add-seats.md @@ -1 +1 @@ -1. ** Edit（編集）**ドロップダウンを使い、**Add seats（シートの追加）**をクリックしてください。 ![[Edit] ドロップダウンメニュー](/assets/images/help/billing/add-seats-dropdown.png) \ No newline at end of file +1. ** Edit（編集）**ドロップダウンを使い、**Add seats（シートの追加）**をクリックしてください。 ![[Edit] ドロップダウンメニュー](/assets/images/help/billing/add-seats-dropdown.png) diff --git a/translations/ja-JP/data/reusables/dotcom_billing/confirm-add-seats.md b/translations/ja-JP/data/reusables/dotcom_billing/confirm-add-seats.md index 07aef0e59195..17d4053a0ddb 100644 --- a/translations/ja-JP/data/reusables/dotcom_billing/confirm-add-seats.md +++ b/translations/ja-JP/data/reusables/dotcom_billing/confirm-add-seats.md @@ -1 +1 @@ -1. ** Add seats（シートの追加）**をクリックしてください。 ![Add seats button](/assets/images/help/billing/add-seats-button.png) \ No newline at end of file +1. ** Add seats（シートの追加）**をクリックしてください。 ![Add seats button](/assets/images/help/billing/add-seats-button.png) diff --git a/translations/ja-JP/data/reusables/dotcom_billing/number-of-seats.md b/translations/ja-JP/data/reusables/dotcom_billing/number-of-seats.md index 8537d9f07295..0c3005085f71 100644 --- a/translations/ja-JP/data/reusables/dotcom_billing/number-of-seats.md +++ b/translations/ja-JP/data/reusables/dotcom_billing/number-of-seats.md @@ -1 +1 @@ -1. "Add seats（シートの追加）"の下で、追加したいシート数を入力してください。 ![Add seats input](/assets/images/help/billing/add-seats-amount.png) \ No newline at end of file +1. "Add seats（シートの追加）"の下で、追加したいシート数を入力してください。 ![Add seats input](/assets/images/help/billing/add-seats-amount.png) diff --git a/translations/ja-JP/data/reusables/dotcom_billing/upgrade_org.md b/translations/ja-JP/data/reusables/dotcom_billing/upgrade_org.md index 362f23b918c6..3e9df5d2e216 100644 --- a/translations/ja-JP/data/reusables/dotcom_billing/upgrade_org.md +++ b/translations/ja-JP/data/reusables/dotcom_billing/upgrade_org.md @@ -1 +1 @@ -1. {% data variables.product.prodname_free_team %}からアップグレードしているなら、**Upgrade options（アップグレードオプション）**をクリックしてください。 {% data variables.product.prodname_team %}からアップグレードしているなら、**Edit（編集）**ドロップダウンを使い、**Upgrade（アップグレード）**をクリックしてください。 ![アップグレードオプションボタン](/assets/images/help/billing/choose-monthly-or-yearly-billing.png) \ No newline at end of file +1. {% data variables.product.prodname_free_team %}からアップグレードしているなら、**Upgrade options（アップグレードオプション）**をクリックしてください。 {% data variables.product.prodname_team %}からアップグレードしているなら、**Edit（編集）**ドロップダウンを使い、**Upgrade（アップグレード）**をクリックしてください。 ![アップグレードオプションボタン](/assets/images/help/billing/choose-monthly-or-yearly-billing.png) diff --git a/translations/ja-JP/data/reusables/education/about-github-education-link.md b/translations/ja-JP/data/reusables/education/about-github-education-link.md index 11bc442db206..7d3008b84c6e 100644 --- a/translations/ja-JP/data/reusables/education/about-github-education-link.md +++ b/translations/ja-JP/data/reusables/education/about-github-education-link.md @@ -1 +1 @@ -個人の割引を適用する前に、あなたの学習コミュニティがすでに弊社と{% data variables.product.prodname_education %}学校としてパートナーになっているかを確認してください。 詳細については、「[{% data variables.product.prodname_education %}について](https://education.github.com/partners/schools)」を参照してください。 +個人の割引を適用する前に、あなたの学習コミュニティがすでに弊社と{% data variables.product.prodname_education %}学校としてパートナーになっているかを確認してください。 詳しい情報については、「[{% data variables.product.prodname_education %} について](https://education.github.com/partners/schools)」を参照してください。 diff --git a/translations/ja-JP/data/reusables/enterprise-accounts/access-enterprise.md b/translations/ja-JP/data/reusables/enterprise-accounts/access-enterprise.md index effe1fcc15cf..2a7bee222c99 100644 --- a/translations/ja-JP/data/reusables/enterprise-accounts/access-enterprise.md +++ b/translations/ja-JP/data/reusables/enterprise-accounts/access-enterprise.md @@ -1 +1,3 @@ -1. `https://github.com/enterprises/ENTERPRISE-NAME`にアクセスして、Enterprise アカウントに移動します。`ENTERPRISE-NAME`はあなたの Enterprise アカウント名に置き換えてください。 +1. In the top-right corner of {% data variables.product.product_name %}, click your profile photo, then click **Your enterprises**. !["Your enterprises" in drop-down menu for profile photo on GitHub](/assets/images/help/enterprises/your-enterprises.png) + +1. In the list of enterprises, click the enterprise you want to view. ![Name of an enterprise in list of your enterprises](/assets/images/help/enterprises/your-enterprises-list.png) diff --git a/translations/ja-JP/data/reusables/enterprise/rate_limit.md b/translations/ja-JP/data/reusables/enterprise/rate_limit.md index dd52413e463c..29a4b2e9a9fd 100644 --- a/translations/ja-JP/data/reusables/enterprise/rate_limit.md +++ b/translations/ja-JP/data/reusables/enterprise/rate_limit.md @@ -1,3 +1,4 @@ {% if currentVersion != "free-pro-team@latest" %} -Note that the limits mentioned above are the default rate limits for a {% data variables.product.prodname_ghe_server %} instance. Contact your site administrator to confirm if rate limits are enabled and how they are configured. +Note that the limits mentioned above are the default rate limits for a +{% data variables.product.prodname_ghe_server %} インスタンスのホスト名に置き換えてください。 Contact your site administrator to confirm if rate limits are enabled and how they are configured. {% endif %} diff --git a/translations/ja-JP/data/reusables/enterprise_clustering/configuration-file-heading.md b/translations/ja-JP/data/reusables/enterprise_clustering/configuration-file-heading.md index 06b1491d9115..9617fb94121d 100644 --- a/translations/ja-JP/data/reusables/enterprise_clustering/configuration-file-heading.md +++ b/translations/ja-JP/data/reusables/enterprise_clustering/configuration-file-heading.md @@ -1 +1 @@ -The cluster configuration file lists each node under a [cluster "HOSTNAME"] heading. \ No newline at end of file +The cluster configuration file lists each node under a [cluster "HOSTNAME"] heading. diff --git a/translations/ja-JP/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md b/translations/ja-JP/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md index 93ee2c087ec5..906c2b24edfe 100644 --- a/translations/ja-JP/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md +++ b/translations/ja-JP/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md @@ -1,6 +1,6 @@ -1. MySQLのマスターノードもしくはRedisのマスターノードを入れ替えているなら、`cluster.conf`で`mysql-master`もしくは`redis-master`の値を入れ替えるノード名に修正してください。 +1. If you're replacing the primary MySQL or Redis node, in `cluster.conf`, modify the `mysql-master` or `redis-master` value with the replacement node name. - たとえば以下の修正された`cluster.conf`ファイルでは、新しくプロビジョニングされたクラスタノードの`ghe-replacement-data-node-1`をMySQL及びRedisのマスターノードとして指定しています。 
    +  For example, this modified `cluster.conf` file specifies a newly provisioned cluster node, `ghe-replacement-data-node-1` as the primary MySQL and Redis node: 
       mysql-master = ghe-replacement-data-node-1
   redis-master = ghe-replacement-data-node-1
   
    
diff --git a/translations/ja-JP/data/reusables/enterprise_enterprise_support/submit-support-ticket-first-section.md b/translations/ja-JP/data/reusables/enterprise_enterprise_support/submit-support-ticket-first-section.md
index feb8179d1261..387360d2141d 100644
--- a/translations/ja-JP/data/reusables/enterprise_enterprise_support/submit-support-ticket-first-section.md
+++ b/translations/ja-JP/data/reusables/enterprise_enterprise_support/submit-support-ticket-first-section.md
@@ -4,13 +4,15 @@
     - 問題を再現する手順
     - 問題が発見された状況に特徴的なこと (たとえば初回の発生、あるいは特定の事象の後の発生、発生頻度、問題のビジネス上の影響、想定される緊急度)
     - 正確なエラーメッセージ
-1. {% data variables.product.prodname_enterprise %} Product（{% data variables.product.prodname_enterprise %}製品）ドロップダウンメニューから、{% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_ghe_cloud %}{% else %}{% data variables.product.prodname_ghe_server %}{% endif %}を選択してください。 ![Priority (優先度) のドロップダウンメニュー](/assets/images/enterprise/support/support-ticket-ghe-product.png)
-1. "Priority（緊急度）"ドロップダウンメニューから、適切な緊急度を選択してください。 詳しい情報については「[サポートチケットへの優先度の割り当て]{% if currentVersion == "free-pro-team@latest" %}(/articles/about-github-premium-support-for-github-enterprise-cloud#assigning-a-priority-to-a-support-ticket){% else %}(/enterprise/admin/guides/enterprise-support/about-github-enterprise-support#assigning-a-priority-to-a-support-ticket){% endif %}」を参照してください。 ![Priority (優先度) のドロップダウンメニュー](/assets/images/enterprise/support/support-ticket-priority.png)
-    - {% if currentVersion == "free-pro-team@latest" %}重大なシステムの障害{% else %}重大なシステム障害、重要なシステムの運用に影響するサービス中断、セキュリティインシデント、ライセンスの期限切れ{% endif %}を報告するには、 **{% data variables.product.support_ticket_priority_urgent %}**を選択してください。
-    - {% if currentVersion == "free-pro-team@latest" %}センシティブなデータ（コミット、Issue、プルリクエスト、アップロードされた添付ファイル）の自分のアカウントとOrganizationのリストアからの削除{% else %}システムパフォーマンスの問題{% endif %}を含むビジネスにインパクトのある問題をレポートしたり、重大なバグのレポートをしたりするには**{% data variables.product.support_ticket_priority_high %}**を選択してください。
-    - {% if currentVersion == "free-pro-team@latest" %}アカウントの回復やスパム認定の取り消しのリクエスト、ユーザーログインの問題のレポート{% else %}設定変更やサードパーティとのインテグレーションのような技術的なリクエスト{% endif %}や、重大ではないバグのレポートには、**{% data variables.product.support_ticket_priority_normal %}**を選択してください。
-    - 一般的な質問や、新機能のリクエストのサブミット、購入、トレーニング、ヘルスチェックについては**{% data variables.product.support_ticket_priority_low %}**を選択してください。{% if currentVersion != "free-pro-team@latest" %}
-1. "{% data variables.product.prodname_enterprise %} Series（{% data variables.product.prodname_enterprise %}シリーズ）"ドロップダウンメニューから、使用している{% data variables.product.prodname_ghe_server %}のバージョンを選択してください。 ![{% data variables.product.prodname_enterprise %} シリーズ ドロップダウンメニュー](/assets/images/enterprise/support/support-ticket-ghes-series.png)
+1. From the {% data variables.product.prodname_enterprise %} Product drop-down menu, select {% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_ghe_cloud %}{% else %}{% data variables.product.prodname_ghe_server %}{% endif %}. ![Priority (優先度) のドロップダウンメニュー](/assets/images/enterprise/support/support-ticket-ghe-product.png)
+1. "Priority（緊急度）"ドロップダウンメニューから、適切な緊急度を選択してください。 For more information, see "[Assigning a priority to a support ticket]{% if currentVersion == "free-pro-team@latest" %}(/articles/about-github-premium-support-for-github-enterprise-cloud#assigning-a-priority-to-a-support-ticket){% else %}(/enterprise/admin/guides/enterprise-support/about-github-enterprise-support#assigning-a-priority-to-a-support-ticket){% endif %}." ![Priority (優先度) のドロップダウンメニュー](/assets/images/enterprise/support/support-ticket-priority.png)
+    - Choose **{% data variables.product.support_ticket_priority_urgent %}** to report {% if currentVersion == "free-pro-team@latest" %}critical system failure{% else %}fatal system failures, outages impacting critical system operations, security incidents, and expired licenses{% endif %}.
+    - Choose **{% data variables.product.support_ticket_priority_high %}** to report issues impacting business operations, including {% if currentVersion == "free-pro-team@latest" %}removing sensitive data (commits, issues, pull requests, uploaded attachments) from your own accounts and organization restorations{% else %}system performance issues{% endif %}, or to report critical bugs.
+    - Choose **{% data variables.product.support_ticket_priority_normal %}** to {% if currentVersion == "free-pro-team@latest" %}request account recovery or spam unflagging, report user login issues{% else %}make technical requests like configuration changes and third-party integrations{% endif %}, and to report non-critical bugs.
+    - Choose **{% data variables.product.support_ticket_priority_low %}** to ask general questions and submit requests for new features, purchases, training, or health checks.{% if currentVersion != "free-pro-team@latest" %}
+1. From the "
+{% data variables.product.prodname_enterprise %} Series" drop-down menu, select the version of {% data variables.product.prodname_ghe_server %} you're using.
+  ![{% data variables.product.prodname_enterprise %} シリーズ ドロップダウンメニュー](/assets/images/enterprise/support/support-ticket-ghes-series.png)
 {% endif %}
 1. "Global Region（グローバルリージョン）"ドロップダウンメニューから、APAC (アジアパシフィック)、EMEA (ヨーロッパ、中東、アフリカ)、Americaのいずれかを自分の地域として選択してください。 ![[Global Region] ドロップダウンメニュー](/assets/images/enterprise/support/support-ticket-global-region.png)
 1. **Add file（ファイルの追加）**をクリックし、ダウンロードしたDiagnosticsファイルを添付して、Diagnosticsをサポートチケットに含めてください。 ![[Add file] ボタン](/assets/images/enterprise/support/support-ticket-add-file.png)
diff --git a/translations/ja-JP/data/reusables/enterprise_enterprise_support/submit-support-ticket-second-section.md b/translations/ja-JP/data/reusables/enterprise_enterprise_support/submit-support-ticket-second-section.md
index c0c2ea00cae7..c93bc74a4ceb 100644
--- a/translations/ja-JP/data/reusables/enterprise_enterprise_support/submit-support-ticket-second-section.md
+++ b/translations/ja-JP/data/reusables/enterprise_enterprise_support/submit-support-ticket-second-section.md
@@ -1,4 +1,5 @@
 1. **Submit（サブミット）**をクリックしてください。
 
 {% if currentVersion != "free-pro-team@latest" %}
-Diagnosticsをサポートチケットに含めることにしたなら、サポートリクエストのサブミット後にDiagnostics情報を{% data variables.product.prodname_enterprise %} Supportと共有できます。 詳細は「[{% data variables.product.prodname_dotcom %} Support にデータを提供する](/enterprise/admin/guides/enterprise-support/providing-data-to-github-support)」を参照してください。{% endif %}
+If you chose not to include diagnostics with your support ticket, you can share diagnostic information with
+{% data variables.product.prodname_enterprise %} Support after submitting your support request. 詳細は「[{% data variables.product.prodname_dotcom %} Support にデータを提供する](/enterprise/admin/guides/enterprise-support/providing-data-to-github-support)」を参照してください。{% endif %}
diff --git a/translations/ja-JP/data/reusables/enterprise_installation/aws-supported-instance-types.md b/translations/ja-JP/data/reusables/enterprise_installation/aws-supported-instance-types.md
index f7915e56325f..7251adf59c0e 100644
--- a/translations/ja-JP/data/reusables/enterprise_installation/aws-supported-instance-types.md
+++ b/translations/ja-JP/data/reusables/enterprise_installation/aws-supported-instance-types.md
@@ -28,10 +28,9 @@
 | ------------ | -------------------------------------------------------------------- |
 | R4           | r4.large, r4.xlarge, r4.2xlarge, r4.4xlarge, r4.8xlarge, r4.16xlarge |
 
-| EC2インスタンスタイプ | モデル                                                                   |
-| ------------ | --------------------------------------------------------------------- |
-| R5           | r5.large, r5.xlarge, r5.2xlarge, r5.4xlarge, r5.12xlarge, r5.24xlarge |
-
+| EC2インスタンスタイプ | モデル                                                                                                                                                                                                                                                                                                                                            |
+| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| R5           | r5.large, r5.xlarge, r5.2xlarge, r5.4xlarge, r5.12xlarge, r5.24xlarge{% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.19" %}, r5n.large, r5n.xlarge, r5n.2xlarge, r5n.4xlarge, r5n.12xlarge, r5n.24xlarge, r5a.large, r5a.xlarge, r5a.2xlarge, r5a.4xlarge, r5a.12xlarge, r5a.24xlarge{% endif %}
 
 | EC2インスタンスタイプ | モデル                      |
 | ------------ | ------------------------ |
diff --git a/translations/ja-JP/data/reusables/enterprise_installation/hardware-rec-table.md b/translations/ja-JP/data/reusables/enterprise_installation/hardware-rec-table.md
index 341c480af612..5b2ea6abde6e 100644
--- a/translations/ja-JP/data/reusables/enterprise_installation/hardware-rec-table.md
+++ b/translations/ja-JP/data/reusables/enterprise_installation/hardware-rec-table.md
@@ -1,13 +1,13 @@
 {% if currentVersion == "enterprise-server@2.22" %}
 
 Minimum requirements for an instance with beta features enabled are **bold** in the following table. For more information, see "[Beta features in {% data variables.product.prodname_ghe_server %} 2.22](#beta-features-in-github-enterprise-server-222)." |{% endif %}
-| ユーザライセンス               |                                                                                                              vCPUs |                                                                                                                        メモリ |                                                                                                               アタッチされたストレージ | ルートストレージ |
-|:---------------------- | ------------------------------------------------------------------------------------------------------------------:| --------------------------------------------------------------------------------------------------------------------------:| --------------------------------------------------------------------------------------------------------------------------:| --------:|
+| ユーザライセンス               |                                                                                                                                  vCPUs |                                                                                                                                            メモリ |                                                                                                                                   アタッチされたストレージ | ルートストレージ |
+|:---------------------- | --------------------------------------------------------------------------------------------------------------------------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------:| --------:|
 | トライアル、デモ、あるいは10人の軽量ユーザ |   2{% if currentVersion == "enterprise-server@2.22" %}
    or [**4**](#beta-features-in-github-enterprise-server-222){% endif %} |   16 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**32 GB**](#beta-features-in-github-enterprise-server-222){% endif %} | 100 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**150 GB**](#beta-features-in-github-enterprise-server-222){% endif %} |   200 GB |
 | 10-3000                |   4{% if currentVersion == "enterprise-server@2.22" %}
    or [**8**](#beta-features-in-github-enterprise-server-222){% endif %} |   32 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**48 GB**](#beta-features-in-github-enterprise-server-222){% endif %} | 250 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**300 GB**](#beta-features-in-github-enterprise-server-222){% endif %} |   200 GB |
-| 3000-5000              |  8{% if currentVersion == "enterprise-server@2.22" %}
    or [**12**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                      64 GB |                                                                                                                     500 GB |   200 GB |
-| 5000-8000              | 12{% if currentVersion == "enterprise-server@2.22" %}
    or [**16**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                      96 GB |                                                                                                                     750 GB |   200 GB |
-| 8000-10000+            | 16{% if currentVersion == "enterprise-server@2.22" %}
    or [**20**](#beta-features-in-github-enterprise-server-222){% endif %} | 128 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**160 GB**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                    1000 GB |   200 GB |
+| 3000-5000              |  8{% if currentVersion == "enterprise-server@2.22" %}
    or [**12**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                                          64 GB |                                                                                                                                         500 GB |   200 GB |
+| 5000-8000              | 12{% if currentVersion == "enterprise-server@2.22" %}
    or [**16**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                                          96 GB |                                                                                                                                         750 GB |   200 GB |
+| 8000-10000+            | 16{% if currentVersion == "enterprise-server@2.22" %}
    or [**20**](#beta-features-in-github-enterprise-server-222){% endif %} | 128 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**160 GB**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                                        1000 GB |   200 GB |
 
 {% if currentVersion == "enterprise-server@2.22" %}
 
diff --git a/translations/ja-JP/data/reusables/enterprise_installation/necessary_ports.md b/translations/ja-JP/data/reusables/enterprise_installation/necessary_ports.md
index cc493bdffe4a..7e9aee5e598c 100644
--- a/translations/ja-JP/data/reusables/enterprise_installation/necessary_ports.md
+++ b/translations/ja-JP/data/reusables/enterprise_installation/necessary_ports.md
@@ -1,12 +1,12 @@
-| ポート      | サービス  | 説明                                                                                                    |
-| -------- | ----- | ----------------------------------------------------------------------------------------------------- |
-| 22       | SSH   | Git over SSHのアクセス。 パブリック／プライベートリポジトリのクローン、フェッチ、プッシュ操作がサポートされています。                                     |
-| 25       | SMTP  | 暗号化（STARTTLS）付きのSMTPサポート。                                                                             |
-| 80       | HTTP  | Webアプリケーションへのアクセス。 *SSL が有効な場合、すべての要求は HTTPS ポートにリダイレクトされます。*                                         |
-| 122      | SSH   | インスタンスのシェルへのアクセス。 *デフォルトのSSHポート（22）は、アプリケーションのgit+sshネットワークトラフィック専用です。*                               |
-| 161/UDP  | SNMP  | ネットワークモニタリングプロトコルの処理に必要。                                                                              |
-| 443      | HTTPS | Webアプリケーション及びGit over HTTPSのアクセス。                                                                     |
-| 1194/UDP | VPN   | High Availability設定でのセキュアなレプリケーションネットワークトンネル。                                                         |
-| 8080     | HTTP  | プレーンテキストの Webベースの {% data variables.enterprise.management_console %}。 *SSL を手動で無効にしない限り必要ありません。* |
-| 8443     | HTTPS | セキュアな Webベースの {% data variables.enterprise.management_console %}。 *基本的なインストールと設定に必要です。*          |
-| 9418     | Git   | シンプルなGitプロトコルのポートです。 パブリックリポジトリのクローンとフェッチのみができます。 *暗号化されていないネットワーク通信です。*                              |
+| ポート      | サービス  | 説明                                                                                                                                                      |
+| -------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 22       | SSH   | Git over SSHのアクセス。 パブリック／プライベートリポジトリのクローン、フェッチ、プッシュ操作がサポートされています。                                                                                       |
+| 25       | SMTP  | 暗号化（STARTTLS）付きのSMTPサポート。                                                                                                                               |
+| 80       | HTTP  | Webアプリケーションへのアクセス。 *SSL が有効な場合、すべての要求は HTTPS ポートにリダイレクトされます。*                                                                                           |
+| 122      | SSH   | インスタンスのシェルへのアクセス。 *デフォルトのSSHポート（22）は、アプリケーションのgit+sshネットワークトラフィック専用です。*                                                                                 |
+| 161/UDP  | SNMP  | ネットワークモニタリングプロトコルの処理に必要。                                                                                                                                |
+| 443      | HTTPS | Webアプリケーション及びGit over HTTPSのアクセス。                                                                                                                       |
+| 1194/UDP | VPN   | High Availability設定でのセキュアなレプリケーションネットワークトンネル。                                                                                                           |
+| 8080     | HTTP  | プレーンテキストの Webベースの {% data variables.enterprise.management_console %}。 *SSL を手動で無効にしない限り必要ありません。*                                                        |
+| 8443     | HTTPS | セキュアな Webベースの {% data variables.enterprise.management_console %}。 *基本的なインストールと設定に必要です。*                                                                 |
+| 9418     | Git   | シンプルなGitプロトコルのポートです。 パブリックリポジトリのクローンとフェッチのみができます。 *Unencrypted network communication.* {% data reusables.enterprise_installation.when-9418-necessary %}
diff --git a/translations/ja-JP/data/reusables/enterprise_installation/when-9418-necessary.md b/translations/ja-JP/data/reusables/enterprise_installation/when-9418-necessary.md
new file mode 100644
index 000000000000..7eed264bd24e
--- /dev/null
+++ b/translations/ja-JP/data/reusables/enterprise_installation/when-9418-necessary.md
@@ -0,0 +1 @@
+If you have enabled private mode on your instance, then opening this port is only required if you also enabled anonymous Git read access. For more information, see "[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#configuring-anonymous-git-read-access)."
\ No newline at end of file
diff --git a/translations/ja-JP/data/reusables/enterprise_management_console/badge_indicator.md b/translations/ja-JP/data/reusables/enterprise_management_console/badge_indicator.md
index 3417294f78f9..9997db8a52a6 100644
--- a/translations/ja-JP/data/reusables/enterprise_management_console/badge_indicator.md
+++ b/translations/ja-JP/data/reusables/enterprise_management_console/badge_indicator.md
@@ -1 +1 @@
-[LDAPグループに同期している](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)Teamには、特別なLDAPバッジが示されます。 LDAPに同期しているTeamのメンバーリストは、マップされているLDAPグループからのみ管理できます。
+[LDAPグループに同期している](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)Teamには、特別なLDAPバッジが示されます。 LDAPに同期しているTeamのメンバーリストは、マップされているLDAPグループからのみ管理できます。
diff --git a/translations/ja-JP/data/reusables/enterprise_site_admin_settings/business.md b/translations/ja-JP/data/reusables/enterprise_site_admin_settings/business.md
index d853bee6dd36..bcda507fbea0 100644
--- a/translations/ja-JP/data/reusables/enterprise_site_admin_settings/business.md
+++ b/translations/ja-JP/data/reusables/enterprise_site_admin_settings/business.md
@@ -1 +1 @@
-1. 左のサイドバーで**Enterprise**をクリックしてください。 ![サイトアドミン設定のEnterpriseタブ](/assets/images/enterprise/site-admin-settings/enterprise-tab.png)
+1. In the left sidebar, click **Enterprise{% if currentVersion ver_gt "enterprise-server@2.21" %} overview{% endif %}**. ![Enterprise{% if currentVersion ver_gt "enterprise-server@2.21" %} overview{% endif %} tab in the Site admin settings](/assets/images/enterprise/site-admin-settings/enterprise-tab.png)
diff --git a/translations/ja-JP/data/reusables/enterprise_site_admin_settings/packages-tab.md b/translations/ja-JP/data/reusables/enterprise_site_admin_settings/packages-tab.md
index 7552439d3d6c..add144d1e6c8 100644
--- a/translations/ja-JP/data/reusables/enterprise_site_admin_settings/packages-tab.md
+++ b/translations/ja-JP/data/reusables/enterprise_site_admin_settings/packages-tab.md
@@ -1 +1 @@
-1. In the left sidebar, click **Packages**. ![Packages tab in management console sidebar](/assets/images/enterprise/site-admin-settings/management-console-packages-tab.png)
\ No newline at end of file
+1. In the left sidebar, click **Packages**. ![Packages tab in management console sidebar](/assets/images/enterprise/site-admin-settings/management-console-packages-tab.png)
diff --git a/translations/ja-JP/data/reusables/enterprise_user_management/manage-global-webhooks-api.md b/translations/ja-JP/data/reusables/enterprise_user_management/manage-global-webhooks-api.md
index f4cb5071c035..9b6ca34c3035 100644
--- a/translations/ja-JP/data/reusables/enterprise_user_management/manage-global-webhooks-api.md
+++ b/translations/ja-JP/data/reusables/enterprise_user_management/manage-global-webhooks-api.md
@@ -1 +1 @@
-{% data variables.product.prodname_enterprise_api %}を使ってグローバルなwebhookを管理することもできます。 For a complete list of actions, see "[Global webhooks](/v3/enterprise-admin/global_webhooks)."
+{% data variables.product.prodname_enterprise_api %}を使ってグローバルなwebhookを管理することもできます。 For a complete list of actions, see "[Global webhooks](/rest/reference/enterprise-admin#global-webhooks)."
diff --git a/translations/ja-JP/data/reusables/files/commit-author-email-options.md b/translations/ja-JP/data/reusables/files/commit-author-email-options.md
index 4ffde213005c..d715584694fa 100644
--- a/translations/ja-JP/data/reusables/files/commit-author-email-options.md
+++ b/translations/ja-JP/data/reusables/files/commit-author-email-options.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-メールアドレスのプライバシーを有効化していないなら、{% data variables.product.product_name %}のプルリクエストの編集、削除、ファイルの作成、マージの際に変更の作者となる検証済みのメールアドレスを選択できます。 メールアドレスのプライバシーを有効化しているなら、コミット作者のメールアドレスは変更できず、デフォルトで`@users.noreply.github.com`になります。
+If you haven't enabled email address privacy, you can choose which verified email address to author changes with when you edit, delete, or create files or merge a pull request on
+{% data variables.product.product_name %}. メールアドレスのプライバシーを有効化しているなら、コミット作者のメールアドレスは変更できず、デフォルトで`@users.noreply.github.com`になります。
 {% endif %}
diff --git a/translations/ja-JP/data/reusables/gated-features/actions.md b/translations/ja-JP/data/reusables/gated-features/actions.md
index adc6bb589950..da659c796c40 100644
--- a/translations/ja-JP/data/reusables/gated-features/actions.md
+++ b/translations/ja-JP/data/reusables/gated-features/actions.md
@@ -1 +1 @@
-{% data variables.product.prodname_actions %}は{% data variables.product.prodname_free_user %}、{% data variables.product.prodname_pro %}、{% data variables.product.prodname_free_team %}のOrganization、{% data variables.product.prodname_team %}、{% data variables.product.prodname_ghe_cloud %}、{% data variables.product.prodname_ghe_one %}で利用できます。 {% data variables.product.prodname_actions %} is not available for private repositories owned by accounts using legacy per-repository plans. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %}
+{{ site.data.variables.product.prodname_actions }}は{{ site.data.variables.product.prodname_free_user }}、{{ site.data.variables.product.prodname_pro }}、{{ site.data.variables.product.prodname_free_team }}のOrganization、{{ site.data.variables.product.prodname_team }}、{{ site.data.variables.product.prodname_ghe_cloud }}、{{ site.data.variables.product.prodname_ghe_one }}で利用できます。 {% data variables.product.prodname_actions %}は、レガシーのリポジトリごとのプランを使っているアカウントが所有しているプライベートリポジトリでは利用できません。 {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %}
diff --git a/translations/ja-JP/data/reusables/gated-features/code-review-assignment.md b/translations/ja-JP/data/reusables/gated-features/code-review-assignment.md
index fe448059bcdc..885a6cc8f1ad 100644
--- a/translations/ja-JP/data/reusables/gated-features/code-review-assignment.md
+++ b/translations/ja-JP/data/reusables/gated-features/code-review-assignment.md
@@ -1 +1 @@
-コードレビューの割り当ては、{% data variables.product.prodname_team %}{% if currentVersion ver_gt "enterprise-server@2.19" %}、{% data variables.product.prodname_ghe_server %} 2.20+{% endif %}、{% data variables.product.prodname_ghe_cloud %}で利用できます。 詳しい情報については「[GitHubの製品](/articles/githubs-products)」を参照してください。
+Code review assignment is available with {% data variables.product.prodname_team %}{% if currentVersion ver_gt "enterprise-server@2.19" %}, {% data variables.product.prodname_ghe_server %} 2.20+,{% endif %} and {% data variables.product.prodname_ghe_cloud %}. 詳しい情報については「[GitHubの製品](/articles/githubs-products)」を参照してください。
diff --git a/translations/ja-JP/data/reusables/gated-features/code-scanning.md b/translations/ja-JP/data/reusables/gated-features/code-scanning.md
new file mode 100644
index 000000000000..a1aca3e675eb
--- /dev/null
+++ b/translations/ja-JP/data/reusables/gated-features/code-scanning.md
@@ -0,0 +1 @@
+{% data variables.product.prodname_code_scanning_capc %} is available in public repositories, and in public and private repositories owned by organizations with a license for {% data variables.product.prodname_advanced_security %}. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %}
diff --git a/translations/ja-JP/data/reusables/gated-features/enterprise-accounts.md b/translations/ja-JP/data/reusables/gated-features/enterprise-accounts.md
index 789fed203faf..bdc16b8561f1 100644
--- a/translations/ja-JP/data/reusables/gated-features/enterprise-accounts.md
+++ b/translations/ja-JP/data/reusables/gated-features/enterprise-accounts.md
@@ -1 +1 @@
-Enterpriseアカウントは、{% data variables.product.prodname_ghe_cloud %}及び{% data variables.product.prodname_ghe_server %}で利用できます。 {% if currentVersion == "free-pro-team@latest" %}詳しい情報については「[Enterpriseアカウントについて](/articles/about-enterprise-accounts)」を参照してください。{% endif %}
+Enterpriseアカウントは、{% data variables.product.prodname_ghe_cloud %}及び{% data variables.product.prodname_ghe_server %}で利用できます。 {% if currentVersion == "free-pro-team@latest" %}For more information, see "[About enterprise accounts](/articles/about-enterprise-accounts)."{% endif %}
diff --git a/translations/ja-JP/data/reusables/gated-features/more-info-org-products.md b/translations/ja-JP/data/reusables/gated-features/more-info-org-products.md
index 15fce54a705a..323025b41e40 100644
--- a/translations/ja-JP/data/reusables/gated-features/more-info-org-products.md
+++ b/translations/ja-JP/data/reusables/gated-features/more-info-org-products.md
@@ -1 +1 @@
-{% if currentVersion == "free-pro-team@latest" %}詳しい情報については「[{% data variables.product.prodname_dotcom %}の製品](/articles/github-s-products)」を参照してください。{% endif %}
+{% if currentVersion == "free-pro-team@latest" %}For more information, see "[{% data variables.product.prodname_dotcom %}'s products](/articles/github-s-products)."{% endif %}
diff --git a/translations/ja-JP/data/reusables/gated-features/more-info.md b/translations/ja-JP/data/reusables/gated-features/more-info.md
index 15fce54a705a..323025b41e40 100644
--- a/translations/ja-JP/data/reusables/gated-features/more-info.md
+++ b/translations/ja-JP/data/reusables/gated-features/more-info.md
@@ -1 +1 @@
-{% if currentVersion == "free-pro-team@latest" %}詳しい情報については「[{% data variables.product.prodname_dotcom %}の製品](/articles/github-s-products)」を参照してください。{% endif %}
+{% if currentVersion == "free-pro-team@latest" %}For more information, see "[{% data variables.product.prodname_dotcom %}'s products](/articles/github-s-products)."{% endif %}
diff --git a/translations/ja-JP/data/reusables/gated-features/packages.md b/translations/ja-JP/data/reusables/gated-features/packages.md
index d6f92017d690..66ff3022d4e9 100644
--- a/translations/ja-JP/data/reusables/gated-features/packages.md
+++ b/translations/ja-JP/data/reusables/gated-features/packages.md
@@ -1,4 +1,5 @@
 {% data variables.product.prodname_registry %} is available with {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} for organizations, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, {% data variables.product.prodname_ghe_server %} 2.22, and {% data variables.product.prodname_ghe_one %}.
 {% if currentVersion == "free-pro-team@latest" %}
-
    {% data variables.product.prodname_registry %}は、レガシーのリポジトリごとのプランを使っているアカウントが所有しているプライベートリポジトリでは利用できません。 {% data variables.product.prodname_registry %}は{% data variables.product.prodname_free_user %}、{% data variables.product.prodname_pro %}、{% data variables.product.prodname_free_team %}のOrganization、{% data variables.product.prodname_team %}、{% data variables.product.prodname_ghe_cloud %}、{% data variables.product.prodname_ghe_one %}で利用できます。 {% data reusables.gated-features.more-info %}
+
    
+{% data variables.product.prodname_registry %}は、レガシーのリポジトリごとのプランを使っているアカウントが所有しているプライベートリポジトリでは利用できません。 {% data variables.product.prodname_registry %}は{% data variables.product.prodname_free_user %}、{% data variables.product.prodname_pro %}、{% data variables.product.prodname_free_team %}のOrganization、{% data variables.product.prodname_team %}、{% data variables.product.prodname_ghe_cloud %}、{% data variables.product.prodname_ghe_one %}で利用できます。 {% data reusables.gated-features.more-info %}
 {% endif %}
diff --git a/translations/ja-JP/data/reusables/gated-features/repository-insights.md b/translations/ja-JP/data/reusables/gated-features/repository-insights.md
index e2f4e0e8f88f..c400b5bf830d 100644
--- a/translations/ja-JP/data/reusables/gated-features/repository-insights.md
+++ b/translations/ja-JP/data/reusables/gated-features/repository-insights.md
@@ -1 +1 @@
-このリポジトリインサイトグラフは、{% data variables.product.prodname_free_user %}及び{% data variables.product.prodname_free_team %}のOrganizationのパブリックリポジトリ、{% data variables.product.prodname_pro %} 、{% data variables.product.prodname_team %}、{% data variables.product.prodname_ghe_cloud %}、{% data variables.product.prodname_ghe_server %}のパブリックおよびプライベートリポジトリで利用できます。{% if currentVersion == "free-pro-team@latest" %}詳細は「[リポジトリグラフについて](/articles/about-repository-graphs)」および「[{% data variables.product.prodname_dotcom %} の製品](/articles/github-s-products)」を参照してください。{% endif %}
+This repository insights graph is available in public repositories with {% data variables.product.prodname_free_user %} and {% data variables.product.prodname_free_team %} for organizations, and in public and private repositories with {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, and {% data variables.product.prodname_ghe_server %}.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[About repository graphs](/articles/about-repository-graphs)" and "[{% data variables.product.prodname_dotcom %}'s products](/articles/github-s-products)."{% endif %}
diff --git a/translations/ja-JP/data/reusables/github-actions/actions-billing.md b/translations/ja-JP/data/reusables/github-actions/actions-billing.md
index 53711f939d2f..4fe173f90975 100644
--- a/translations/ja-JP/data/reusables/github-actions/actions-billing.md
+++ b/translations/ja-JP/data/reusables/github-actions/actions-billing.md
@@ -1 +1 @@
-パブリックリポジトリでは、{% data variables.product.prodname_actions %}の利用は無料です。 プライベートリポジトリでは、それぞれの{% data variables.product.prodname_dotcom %}アカウントは使用している製品に応じて一定量の無料の分とストレージを受け取ります。
+{% data variables.product.prodname_actions %} usage is free for public repositories and self-hosted runners. プライベートリポジトリでは、それぞれの{% data variables.product.prodname_dotcom %}アカウントは使用している製品に応じて一定量の無料の分とストレージを受け取ります。
diff --git a/translations/ja-JP/data/reusables/github-actions/actions-on-examples.md b/translations/ja-JP/data/reusables/github-actions/actions-on-examples.md
index e20f16879a71..81c2310549d8 100644
--- a/translations/ja-JP/data/reusables/github-actions/actions-on-examples.md
+++ b/translations/ja-JP/data/reusables/github-actions/actions-on-examples.md
@@ -1,14 +1,14 @@
 ##### **1つのイベントを使用する例**
 
 ```yaml
-# プッシュでトリガー
+# Triggered when code is pushed to any branch in a repository
 on: push
 ```
 
 ##### **イベントのリストを使用する例**
 
 ```yaml
-# プッシュあるいはプルリクエストでワークフローをトリガー
+# Triggers the workflow on push or pull request events
 on: [push, pull_request]
 ```
 
@@ -18,17 +18,17 @@ on: [push, pull_request]
 
 ```yaml
 on:
-  # プッシュもしくはプルリクエストでワークフローを起動する
-  # ただしmasterブランチに対してのみ
+  # Trigger the workflow on push or pull request,
+  # but only for the main branch
   push:
     branches:
-      - master
+      - main
   pull_request:
     branches:
-      - master
-  # page_buildとリリース作成イベントでも起動
+      - main
+  # Also trigger on page_build, as well as release created events
   page_build:
   release:
-    types: # この設定は上のpage_buildイベントには影響しない
+    types: # This configuration does not affect the page_build event above
       - created
 ```
diff --git a/translations/ja-JP/data/reusables/github-actions/actions-unused-labels.md b/translations/ja-JP/data/reusables/github-actions/actions-unused-labels.md
index 3ca2e3377010..55509c4d1746 100644
--- a/translations/ja-JP/data/reusables/github-actions/actions-unused-labels.md
+++ b/translations/ja-JP/data/reusables/github-actions/actions-unused-labels.md
@@ -1 +1 @@
- ランナーに割り当てられていない、未使用のラベルは、24時間以内に自動的に削除されます。
\ No newline at end of file
+ ランナーに割り当てられていない、未使用のラベルは、24時間以内に自動的に削除されます。
diff --git a/translations/ja-JP/data/reusables/github-actions/artifact-log-retention-statement.md b/translations/ja-JP/data/reusables/github-actions/artifact-log-retention-statement.md
new file mode 100644
index 000000000000..b45a4b1e2625
--- /dev/null
+++ b/translations/ja-JP/data/reusables/github-actions/artifact-log-retention-statement.md
@@ -0,0 +1,2 @@
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} By default, {% data variables.product.product_name %} stores build logs and artifacts for 90 days, and this retention period can be customized. For more information, see "[Usage limits, billing, and administration](/actions/reference/usage-limits-billing-and-administration#artifact-and-log-retention-policy)".{% endif %}
+{% if currentVersion == "enterprise-server@2.22" %} {% data variables.product.product_name %} には、完全なビルドログとアーティファクトが 90 日間保存されます。{% endif %}
diff --git a/translations/ja-JP/data/reusables/github-actions/branch-requirement.md b/translations/ja-JP/data/reusables/github-actions/branch-requirement.md
index dbefca36b448..b8be9a7d5365 100644
--- a/translations/ja-JP/data/reusables/github-actions/branch-requirement.md
+++ b/translations/ja-JP/data/reusables/github-actions/branch-requirement.md
@@ -1,5 +1,5 @@
 {% note %}
 
-**ノート:** このイベントがワークフローの実行を引き起こすのは、そのワークフローのファイルが`master`もしくはデフォルトブランチにある場合のみです。
+**Note:** This event will only trigger a workflow run if the workflow file is on the default branch.
 
 {% endnote %}
diff --git a/translations/ja-JP/data/reusables/github-actions/change-retention-period-for-artifacts-logs.md b/translations/ja-JP/data/reusables/github-actions/change-retention-period-for-artifacts-logs.md
new file mode 100644
index 000000000000..19398bca6ab8
--- /dev/null
+++ b/translations/ja-JP/data/reusables/github-actions/change-retention-period-for-artifacts-logs.md
@@ -0,0 +1,2 @@
+1. Under **Artifact and log retention duration**, enter a new value.
+1. Click **Save** to apply the change.
\ No newline at end of file
diff --git a/translations/ja-JP/data/reusables/github-actions/disabled-actions-description.md b/translations/ja-JP/data/reusables/github-actions/disabled-actions-description.md
index 0ce734496436..4ca8e65bc9c3 100644
--- a/translations/ja-JP/data/reusables/github-actions/disabled-actions-description.md
+++ b/translations/ja-JP/data/reusables/github-actions/disabled-actions-description.md
@@ -1 +1 @@
-{% data variables.product.prodname_actions %}を無効化すると、リポジトリでワークフローが実行されなくなります。
\ No newline at end of file
+{% data variables.product.prodname_actions %}を無効化すると、リポジトリでワークフローが実行されなくなります。
diff --git a/translations/ja-JP/data/reusables/github-actions/disabling-github-actions.md b/translations/ja-JP/data/reusables/github-actions/disabling-github-actions.md
index e6824e20684d..9344146d57e7 100644
--- a/translations/ja-JP/data/reusables/github-actions/disabling-github-actions.md
+++ b/translations/ja-JP/data/reusables/github-actions/disabling-github-actions.md
@@ -1 +1 @@
-By default, {% data variables.product.prodname_actions %} is enabled on all repositories and organizations. You can choose to disable {% data variables.product.prodname_actions %} or limit them to private actions only, which means that people can only use actions that exist in your repository.
+By default, {% if currentVersion ver_gt "enterprise-server@2.21" %}after {% data variables.product.prodname_actions %} is enabled on {% data variables.product.product_location %}, it{% else if if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_actions %}{% endif %} is enabled on all repositories and organizations. You can choose to disable {% data variables.product.prodname_actions %} or limit them to private actions only, which means that people can only use actions that exist in your repository.
diff --git a/translations/ja-JP/data/reusables/github-actions/docker-container-os-support.md b/translations/ja-JP/data/reusables/github-actions/docker-container-os-support.md
index 82bd4daa746f..42784c01fa55 100644
--- a/translations/ja-JP/data/reusables/github-actions/docker-container-os-support.md
+++ b/translations/ja-JP/data/reusables/github-actions/docker-container-os-support.md
@@ -2,7 +2,7 @@
 
 **ノート:** ワークフローがDockerコンテナアクションあるいはサービスコンテナを使うなら、Linuxのランナーを利用しなければなりません。
 
-* {% data variables.product.prodname_dotcom %}-ホストランナーを使っているなら、`ubuntu-latest`ランナーを使わなければなりません。
+* If you are using {% data variables.product.prodname_dotcom %}-hosted runners, you must use an Ubuntu runner.
 * セルフホストランナーを使っているなら、ランナーとしてLinuxマシンを使い、Dockerをインストールしておかなければなりません。
 
 {% endnote %}
diff --git a/translations/ja-JP/data/reusables/github-actions/dockerfile-guidelines.md b/translations/ja-JP/data/reusables/github-actions/dockerfile-guidelines.md
index b91c4920c37f..300b27529ada 100644
--- a/translations/ja-JP/data/reusables/github-actions/dockerfile-guidelines.md
+++ b/translations/ja-JP/data/reusables/github-actions/dockerfile-guidelines.md
@@ -1,3 +1,3 @@
 1. 必須の引数をアクションのREADME中でドキュメント化し、`CMD`命令から除外してください。
 1. `args`を指定せずにアクションを利用できるよう、デフォルトを使ってください。
-1. アクションが`--help`フラグやそれに類するものを備えているなら、アクションを自己ドキュメント化するために利用してください。
\ No newline at end of file
+1. アクションが`--help`フラグやそれに類するものを備えているなら、アクションを自己ドキュメント化するために利用してください。
diff --git a/translations/ja-JP/data/reusables/github-actions/enabled-actions-description.md b/translations/ja-JP/data/reusables/github-actions/enabled-actions-description.md
index 682ed7974e52..96fa295b91b6 100644
--- a/translations/ja-JP/data/reusables/github-actions/enabled-actions-description.md
+++ b/translations/ja-JP/data/reusables/github-actions/enabled-actions-description.md
@@ -1 +1 @@
-{% data variables.product.prodname_actions %}を有効化すると、ワークフローはリポジトリ内と、その他の任意のパブリックリポジトリ内のアクションを実行できるようになります。
\ No newline at end of file
+{% data variables.product.prodname_actions %}を有効化すると、ワークフローはリポジトリ内と、その他の任意のパブリックリポジトリ内のアクションを実行できるようになります。
diff --git a/translations/ja-JP/data/reusables/github-actions/enabled-local-github-actions.md b/translations/ja-JP/data/reusables/github-actions/enabled-local-github-actions.md
index 3d84186c25ac..c86966ea5885 100644
--- a/translations/ja-JP/data/reusables/github-actions/enabled-local-github-actions.md
+++ b/translations/ja-JP/data/reusables/github-actions/enabled-local-github-actions.md
@@ -1 +1 @@
-ローカルアクションのみを有効化した場合、ワークフローはリポジトリあるいはOrganization内のアクションだけを実行できるようになります。
\ No newline at end of file
+ローカルアクションのみを有効化した場合、ワークフローはリポジトリあるいはOrganization内のアクションだけを実行できるようになります。
diff --git a/translations/ja-JP/data/reusables/github-actions/expression-syntax-if.md b/translations/ja-JP/data/reusables/github-actions/expression-syntax-if.md
index 35a062e094dc..0d2a2659e98b 100644
--- a/translations/ja-JP/data/reusables/github-actions/expression-syntax-if.md
+++ b/translations/ja-JP/data/reusables/github-actions/expression-syntax-if.md
@@ -1 +1 @@
-`if` 条件の中で式を使用する際には、式構文 ({% raw %}`${{ }}`{% endraw %})を省略できます。これは、{% data variables.product.prodname_dotcom %} が `if` 条件を式として自動的に評価するためです。
\ No newline at end of file
+`if` 条件の中で式を使用する際には、式構文 ({% raw %}`${{ }}`{% endraw %})を省略できます。これは、{% data variables.product.prodname_dotcom %} が `if` 条件を式として自動的に評価するためです。
diff --git a/translations/ja-JP/data/reusables/github-actions/gradle-workflow-steps.md b/translations/ja-JP/data/reusables/github-actions/gradle-workflow-steps.md
index 681e55830270..3314d3fd6e40 100644
--- a/translations/ja-JP/data/reusables/github-actions/gradle-workflow-steps.md
+++ b/translations/ja-JP/data/reusables/github-actions/gradle-workflow-steps.md
@@ -1,4 +1,4 @@
 このワークフローは以下のステップを実行します。
 
 1. プロジェクトのリポジトリのコピーをチェックアウトします。
-1. Java JDKをセットアップします。
\ No newline at end of file
+1. Java JDKをセットアップします。
diff --git a/translations/ja-JP/data/reusables/github-actions/permissions-statement-secrets-api.md b/translations/ja-JP/data/reusables/github-actions/permissions-statement-secrets-api.md
index 5be4fa493fc6..0e62bb6498c9 100644
--- a/translations/ja-JP/data/reusables/github-actions/permissions-statement-secrets-api.md
+++ b/translations/ja-JP/data/reusables/github-actions/permissions-statement-secrets-api.md
@@ -1 +1 @@
-REST APIを使ってシークレットを作成するには、リポジトリに対する書き込みアクセス権を持っていなければなりません。 For more information, see "[{% data variables.product.prodname_actions %} secrets API](/v3/actions/secrets/)."
+To create secrets using the REST API, you must have write access to the repository or admin access to the organization. For more information, see "[{% data variables.product.prodname_actions %} secrets API](/v3/actions/secrets/)."
diff --git a/translations/ja-JP/data/reusables/github-actions/permissions-statement-secrets-organization.md b/translations/ja-JP/data/reusables/github-actions/permissions-statement-secrets-organization.md
index cf386153426f..79ab7ba35585 100644
--- a/translations/ja-JP/data/reusables/github-actions/permissions-statement-secrets-organization.md
+++ b/translations/ja-JP/data/reusables/github-actions/permissions-statement-secrets-organization.md
@@ -1 +1 @@
-Organizationのレベルでシークレットを作成するには、`管理`アクセス権を持っていなければなりません。 
\ No newline at end of file
+Organizationのレベルでシークレットを作成するには、`管理`アクセス権を持っていなければなりません。 
diff --git a/translations/ja-JP/data/reusables/github-actions/permissions-statement-secrets-repository.md b/translations/ja-JP/data/reusables/github-actions/permissions-statement-secrets-repository.md
index 68cbc1508f65..3255e067e68a 100644
--- a/translations/ja-JP/data/reusables/github-actions/permissions-statement-secrets-repository.md
+++ b/translations/ja-JP/data/reusables/github-actions/permissions-statement-secrets-repository.md
@@ -1 +1 @@
-ユーザアカウントのリポジトリにシークレットを作成するには、そのリポジトリのオーナーでなければなりません。 Organizationのリポジトリにシークレットを作成するには、`管理`アクセス権を持っていなければなりません。
\ No newline at end of file
+ユーザアカウントのリポジトリにシークレットを作成するには、そのリポジトリのオーナーでなければなりません。 Organizationのリポジトリにシークレットを作成するには、`管理`アクセス権を持っていなければなりません。
diff --git a/translations/ja-JP/data/reusables/github-actions/private-repository-forks-overview.md b/translations/ja-JP/data/reusables/github-actions/private-repository-forks-overview.md
index 716a64703f20..1664f904ecca 100644
--- a/translations/ja-JP/data/reusables/github-actions/private-repository-forks-overview.md
+++ b/translations/ja-JP/data/reusables/github-actions/private-repository-forks-overview.md
@@ -2,4 +2,4 @@ If you rely on using forks of your private repositories, you can configure polic
 
 - **Run workflows from fork pull requests** - Allows users to run workflows from fork pull requests, using a `GITHUB_TOKEN` with read-only permission, and with no access to secrets.
 - **Send write tokens to workflows from pull requests** - Allows pull requests from forks to use a `GITHUB_TOKEN` with write permission.
-- **Send secrets to workflows from pull requests** - Makes all secrets available to the pull request.
\ No newline at end of file
+- **Send secrets to workflows from pull requests** - Makes all secrets available to the pull request.
diff --git a/translations/ja-JP/data/reusables/github-actions/publish-to-maven-workflow-step.md b/translations/ja-JP/data/reusables/github-actions/publish-to-maven-workflow-step.md
index 4babd4077b48..c2d86e88ed0c 100644
--- a/translations/ja-JP/data/reusables/github-actions/publish-to-maven-workflow-step.md
+++ b/translations/ja-JP/data/reusables/github-actions/publish-to-maven-workflow-step.md
@@ -1 +1 @@
-`ossrh`リポジトリへ公開するために`mvn -B deploy`コマンドを実行してください。 環境変数の`MAVEN_USERNAME`は`OSSRH_USERNAME`シークレットの内容で、環境変数の`MAVEN_PASSWORD`は`OSSRH_TOKEN`シークレットの内容で設定されます。
\ No newline at end of file
+`ossrh`リポジトリへ公開するために`mvn -B deploy`コマンドを実行してください。 環境変数の`MAVEN_USERNAME`は`OSSRH_USERNAME`シークレットの内容で、環境変数の`MAVEN_PASSWORD`は`OSSRH_TOKEN`シークレットの内容で設定されます。
diff --git a/translations/ja-JP/data/reusables/github-actions/publish-to-packages-workflow-step.md b/translations/ja-JP/data/reusables/github-actions/publish-to-packages-workflow-step.md
index 89f3ac117dec..5a3db3270a2f 100644
--- a/translations/ja-JP/data/reusables/github-actions/publish-to-packages-workflow-step.md
+++ b/translations/ja-JP/data/reusables/github-actions/publish-to-packages-workflow-step.md
@@ -1 +1 @@
-{% data variables.product.prodname_registry %}に公開するために`mvn -B deploy`コマンドを実行してください。 環境変数`GITHUB_TOKEN`には、`GITHUB_TOKEN`シークレットの内容が設定されます。
\ No newline at end of file
+{% data variables.product.prodname_registry %}に公開するために`mvn -B deploy`コマンドを実行してください。 環境変数`GITHUB_TOKEN`には、`GITHUB_TOKEN`シークレットの内容が設定されます。
diff --git a/translations/ja-JP/data/reusables/github-actions/publishing-java-packages-intro.md b/translations/ja-JP/data/reusables/github-actions/publishing-java-packages-intro.md
index 8b5d6519dde3..6563254dd85a 100644
--- a/translations/ja-JP/data/reusables/github-actions/publishing-java-packages-intro.md
+++ b/translations/ja-JP/data/reusables/github-actions/publishing-java-packages-intro.md
@@ -1 +1 @@
-このガイドは、Javaのパッケージを{% data variables.product.prodname_registry %}やMaven Central Repositoryに公開するワークフローの作成方法を紹介します。 1つのワークフローで、パッケージを1つのリポジトリあるいは複数のリポジトリに公開できます。
\ No newline at end of file
+このガイドは、Javaのパッケージを{% data variables.product.prodname_registry %}やMaven Central Repositoryに公開するワークフローの作成方法を紹介します。 1つのワークフローで、パッケージを1つのリポジトリあるいは複数のリポジトリに公開できます。
diff --git a/translations/ja-JP/data/reusables/github-actions/run_id_description.md b/translations/ja-JP/data/reusables/github-actions/run_id_description.md
index 61fd1f9c4f27..5fd24ceabd77 100644
--- a/translations/ja-JP/data/reusables/github-actions/run_id_description.md
+++ b/translations/ja-JP/data/reusables/github-actions/run_id_description.md
@@ -1 +1 @@
-リポジトリ内でユニークな各実行に対する番号。 この番号は、ワークフローの実行をやり直しても変化しません、
\ No newline at end of file
+リポジトリ内でユニークな各実行に対する番号。 この番号は、ワークフローの実行をやり直しても変化しません、
diff --git a/translations/ja-JP/data/reusables/github-actions/run_number_description.md b/translations/ja-JP/data/reusables/github-actions/run_number_description.md
index d532957d4608..f67e4812a7a8 100644
--- a/translations/ja-JP/data/reusables/github-actions/run_number_description.md
+++ b/translations/ja-JP/data/reusables/github-actions/run_number_description.md
@@ -1 +1 @@
-リポジトリ内の特定のワークフローの各実行に対するユニークな番号。 この番号は、ワークフローの最初の実行時に1で始まり、新たな実行ごとにインクリメントされます。 この番号は、ワークフローの実行をやり直しても変化しません、
\ No newline at end of file
+リポジトリ内の特定のワークフローの各実行に対するユニークな番号。 この番号は、ワークフローの最初の実行時に1で始まり、新たな実行ごとにインクリメントされます。 この番号は、ワークフローの実行をやり直しても変化しません、
diff --git a/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md b/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md
index 71c1c0853b9a..0cd319c4ae2c 100644
--- a/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md
+++ b/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md
@@ -1,2 +1,2 @@
 1. In the **Self-hosted runners** section of the settings page, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} next to the runner group you'd like to configure, then click **Edit name and [organization|repository] access**. ![リポジトリの権限の管理](/assets/images/help/settings/actions-runner-manage-permissions.png)
-1. Select a new policy from the dropdown list, or modify the runner group name.
\ No newline at end of file
+1. Select a new policy from the dropdown list, or modify the runner group name.
diff --git a/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-list-group.md b/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-list-group.md
index b86a8be047bc..b1512186b608 100644
--- a/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-list-group.md
+++ b/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-list-group.md
@@ -1 +1 @@
-1. If your runner is in a group, locate the runner group and click {% octicon "chevron-down" aria-label="The downward chevron" %} to view the list of runners. ![List runner group](/assets/images/help/settings/actions-org-enterprise-list-group-runners.png)
\ No newline at end of file
+1. If your runner is in a group, locate the runner group and click {% octicon "chevron-down" aria-label="The downward chevron" %} to view the list of runners. ![List runner group](/assets/images/help/settings/actions-org-enterprise-list-group-runners.png)
diff --git a/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-list.md b/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-list.md
index 315f976b7614..3e0ee5b85253 100644
--- a/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-list.md
+++ b/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-list.md
@@ -1 +1 @@
- 1. Locate the list of runners under "Self-hosted runners".
\ No newline at end of file
+ 1. Locate the list of runners under "Self-hosted runners".
diff --git a/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-management-permissions-required.md b/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-management-permissions-required.md
index 2576c7b820d4..0313546827fa 100644
--- a/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-management-permissions-required.md
+++ b/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-management-permissions-required.md
@@ -1,4 +1,4 @@
-セルフホストランナーは、{% data variables.product.prodname_dotcom %}上のOrganizationもしくはリポジトリ設定にあります。 セルフホストランナーを管理するには、セルフホストランナーが追加された場所に応じて以下の権限が必要になります。
+A self-hosted runner can be located in either your repository, organization, or {% if currentVersion == "free-pro-team@latest" %}enterprise account settings on {% data variables.product.prodname_dotcom %}{% else if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %} enterprise settings on {% data variables.product.product_location %}{% endif %}. セルフホストランナーを管理するには、セルフホストランナーが追加された場所に応じて以下の権限が必要になります。
 - **User repository**: You must be the repository owner.
 - **Organization**: You must be an organization owner.
 - **Organization repository**: You must be an organization owner, or have admin access to the repository.
diff --git a/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-navigate-repo-and-org.md b/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-navigate-repo-and-org.md
index 714f416df0f5..9910dbacec9e 100644
--- a/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-navigate-repo-and-org.md
+++ b/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-navigate-repo-and-org.md
@@ -1 +1 @@
-1. Organizationもしくはリポジトリ内で、メインページにアクセスして{% octicon "gear" aria-label="The Settings gear" %} **Settings（設定）**をクリックしてください。
\ No newline at end of file
+1. Organizationもしくはリポジトリ内で、メインページにアクセスして{% octicon "gear" aria-label="The Settings gear" %} **Settings（設定）**をクリックしてください。
diff --git a/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-removal-impact.md b/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-removal-impact.md
index ac1e1faf1e72..e3b902931c8c 100644
--- a/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-removal-impact.md
+++ b/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-removal-impact.md
@@ -1 +1 @@
-この手順は、セルフホストランナーを恒久的に削除します。 一時的にランナーへのジョブの割り当てを停止したいだけなら、そのマシンをシャットダウンするか、`run`アプリケーションを停止させることができます。 ランナーは"Offline（オフライン）"状態で割り当てされたままになり、`run`アプリケーションを使ってランナーを再起動するまでは、ジョブを実行しません。
\ No newline at end of file
+この手順は、セルフホストランナーを恒久的に削除します。 一時的にランナーへのジョブの割り当てを停止したいだけなら、そのマシンをシャットダウンするか、`run`アプリケーションを停止させることができます。 ランナーは"Offline（オフライン）"状態で割り当てされたままになり、`run`アプリケーションを使ってランナーを再起動するまでは、ジョブを実行しません。
diff --git a/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-reusing.md b/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-reusing.md
index 0435ac7bb9ec..c15c029bdca3 100644
--- a/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-reusing.md
+++ b/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-reusing.md
@@ -1 +1 @@
-Alternatively, if you don't have access to the repository, organization, or enterprise on {% data variables.product.product_name %} to remove a runner, but you would like to re-use the runner machine, then you can delete the `.runner` file inside the self-hosted runner application directory. This allows the runner to be registered without having to re-download the self-hosted runner application.
\ No newline at end of file
+Alternatively, if you don't have access to the repository, organization, or enterprise on {% data variables.product.product_name %} to remove a runner, but you would like to re-use the runner machine, then you can delete the `.runner` file inside the self-hosted runner application directory. This allows the runner to be registered without having to re-download the self-hosted runner application.
diff --git a/translations/ja-JP/data/reusables/github-actions/sidebar-secret.md b/translations/ja-JP/data/reusables/github-actions/sidebar-secret.md
index 68a8cc3f9914..889315a30488 100644
--- a/translations/ja-JP/data/reusables/github-actions/sidebar-secret.md
+++ b/translations/ja-JP/data/reusables/github-actions/sidebar-secret.md
@@ -1 +1 @@
-1. 左サイドバーで [**Secrets**] をクリックします。
\ No newline at end of file
+1. 左サイドバーで [**Secrets**] をクリックします。
diff --git a/translations/ja-JP/data/reusables/github-actions/usage-api-requests.md b/translations/ja-JP/data/reusables/github-actions/usage-api-requests.md
new file mode 100644
index 000000000000..4527134d9576
--- /dev/null
+++ b/translations/ja-JP/data/reusables/github-actions/usage-api-requests.md
@@ -0,0 +1 @@
+- **APIリクエスト** - リポジトリ内のすべてのアクションにわたって、1時間のうちに最大1000回のAPIリクエストを実行できます。 この制限を超えた場合、超過のAPIコールは失敗し、それによってジョブも失敗するかもしれません。
diff --git a/translations/ja-JP/data/reusables/github-actions/usage-matrix-limits.md b/translations/ja-JP/data/reusables/github-actions/usage-matrix-limits.md
new file mode 100644
index 000000000000..203db11d3001
--- /dev/null
+++ b/translations/ja-JP/data/reusables/github-actions/usage-matrix-limits.md
@@ -0,0 +1 @@
+- **Job matrix** - A job matrix can generate a maximum of 256 jobs per workflow run. この制限は、セルフホストランナーにも適用されます。
diff --git a/translations/ja-JP/data/reusables/github-actions/usage-workflow-run-time.md b/translations/ja-JP/data/reusables/github-actions/usage-workflow-run-time.md
new file mode 100644
index 000000000000..0a25c5f61b11
--- /dev/null
+++ b/translations/ja-JP/data/reusables/github-actions/usage-workflow-run-time.md
@@ -0,0 +1 @@
+- **ワークフローの実行時間** - 各ワークフローの実行は72時間までに制限されます。 ワークフローの実行がこの制限に達すると、そのワークフローの実行はキャンセルされます。
diff --git a/translations/ja-JP/data/reusables/github-insights/choose-key-metric.md b/translations/ja-JP/data/reusables/github-insights/choose-key-metric.md
index 61a70156fc9d..ddd0ed3ede47 100644
--- a/translations/ja-JP/data/reusables/github-insights/choose-key-metric.md
+++ b/translations/ja-JP/data/reusables/github-insights/choose-key-metric.md
@@ -1 +1 @@
-2. **{% octicon "graph" aria-label="The graph icon" %} Key metrics（主要なメトリクス）**の下で、表示させたいメトリクスの名前をクリックしてください。 ![主要なメトリクスのリスト](/assets/images/help/insights/key-metrics-list.png)
\ No newline at end of file
+2. **{% octicon "graph" aria-label="The graph icon" %} Key metrics（主要なメトリクス）**の下で、表示させたいメトリクスの名前をクリックしてください。 ![主要なメトリクスのリスト](/assets/images/help/insights/key-metrics-list.png)
diff --git a/translations/ja-JP/data/reusables/github-insights/enterprise-api-url.md b/translations/ja-JP/data/reusables/github-insights/enterprise-api-url.md
index 1b6cea8a6ff9..2657d47f82da 100644
--- a/translations/ja-JP/data/reusables/github-insights/enterprise-api-url.md
+++ b/translations/ja-JP/data/reusables/github-insights/enterprise-api-url.md
@@ -1 +1 @@
-1. "{% data variables.product.prodname_dotcom %} API URL"の下で、{% if currentVersion == "free-pro-team@latest" %}https://api.github.com{% else %}{% data variables.product.prodname_enterprise %}にアクセスするのに使うURL{% endif %}を入力してください。 ![{% data variables.product.prodname_enterprise %} API URLフィールド](/assets/images/help/insights/enterprise-api-url.png)
+1. Under "{% data variables.product.prodname_dotcom %} API URL", type {% if currentVersion == "free-pro-team@latest" %}https://api.github.com {% else %}the URL you use to access {% data variables.product.prodname_enterprise %}{% endif %}. ![{% data variables.product.prodname_enterprise %} API URLフィールド](/assets/images/help/insights/enterprise-api-url.png)
diff --git a/translations/ja-JP/data/reusables/github-insights/navigate-to-key-metrics.md b/translations/ja-JP/data/reusables/github-insights/navigate-to-key-metrics.md
index 4e29b8be8c60..a8d08d320d80 100644
--- a/translations/ja-JP/data/reusables/github-insights/navigate-to-key-metrics.md
+++ b/translations/ja-JP/data/reusables/github-insights/navigate-to-key-metrics.md
@@ -1 +1 @@
-1. {% data variables.product.prodname_insights %}で**{% octicon "graph" aria-label="The graph icon" %} Key metrics（主要なメトリクス）**をクリックしてください。 ![主要なメトリクスタブ](/assets/images/help/insights/key-metrics-tab.png)
\ No newline at end of file
+1. {% data variables.product.prodname_insights %}で**{% octicon "graph" aria-label="The graph icon" %} Key metrics（主要なメトリクス）**をクリックしてください。 ![主要なメトリクスタブ](/assets/images/help/insights/key-metrics-tab.png)
diff --git a/translations/ja-JP/data/reusables/gpg/private-email.md b/translations/ja-JP/data/reusables/gpg/private-email.md
index 84cef3b2b388..15ea1833856c 100644
--- a/translations/ja-JP/data/reusables/gpg/private-email.md
+++ b/translations/ja-JP/data/reusables/gpg/private-email.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-メールアドレスをプライベートにしておくには、{% data variables.product.product_name %} が提供する`no-reply`メールアドレスを使ってください。
+To keep your email address private, use your
+{% data variables.product.product_name %}-provided `no-reply` email address.
 {% endif %}
diff --git a/translations/ja-JP/data/reusables/identity-and-permissions/enable-team-sync-azure.md b/translations/ja-JP/data/reusables/identity-and-permissions/enable-team-sync-azure.md
index 113f672cfb65..243d6d76df80 100644
--- a/translations/ja-JP/data/reusables/identity-and-permissions/enable-team-sync-azure.md
+++ b/translations/ja-JP/data/reusables/identity-and-permissions/enable-team-sync-azure.md
@@ -1 +1 @@
-1. "Team synchronization（Teamの同期）"の下で、**Enable for Azure AD（Azure ADでの有効化）**をクリックしてください。 ![セキュリティ設定ページの [Enable team synchronization] ボタン](/assets/images/help/teams/enable-team-synchronization.png)
\ No newline at end of file
+1. "Team synchronization（Teamの同期）"の下で、**Enable for Azure AD（Azure ADでの有効化）**をクリックしてください。 ![セキュリティ設定ページの [Enable team synchronization] ボタン](/assets/images/help/teams/enable-team-synchronization.png)
diff --git a/translations/ja-JP/data/reusables/identity-and-permissions/enable-team-sync-okta.md b/translations/ja-JP/data/reusables/identity-and-permissions/enable-team-sync-okta.md
index 442455060d78..8d5a4c101721 100644
--- a/translations/ja-JP/data/reusables/identity-and-permissions/enable-team-sync-okta.md
+++ b/translations/ja-JP/data/reusables/identity-and-permissions/enable-team-sync-okta.md
@@ -1 +1 @@
-1. "Team synchronization（Teamの同期）"の下で、**Enable for Okta（Oktaでの有効化）**をクリックしてください。 ![セキュリティ設定ページのOktaのためのTeam同期の有効化ボタン](/assets/images/help/teams/enable-team-synchronization-okta.png)
\ No newline at end of file
+1. "Team synchronization（Teamの同期）"の下で、**Enable for Okta（Oktaでの有効化）**をクリックしてください。 ![セキュリティ設定ページのOktaのためのTeam同期の有効化ボタン](/assets/images/help/teams/enable-team-synchronization-okta.png)
diff --git a/translations/ja-JP/data/reusables/identity-and-permissions/supported-idps-team-sync.md b/translations/ja-JP/data/reusables/identity-and-permissions/supported-idps-team-sync.md
index a3645d230c95..0dda52c218fc 100644
--- a/translations/ja-JP/data/reusables/identity-and-permissions/supported-idps-team-sync.md
+++ b/translations/ja-JP/data/reusables/identity-and-permissions/supported-idps-team-sync.md
@@ -1,3 +1,3 @@
 Team同期は、サポートされているIdPで使えます。
   - Azure AD
-  - Okta
\ No newline at end of file
+  - Okta
diff --git a/translations/ja-JP/data/reusables/identity-and-permissions/sync-team-with-idp-group.md b/translations/ja-JP/data/reusables/identity-and-permissions/sync-team-with-idp-group.md
index 7e45215b79a9..e73619ec067b 100644
--- a/translations/ja-JP/data/reusables/identity-and-permissions/sync-team-with-idp-group.md
+++ b/translations/ja-JP/data/reusables/identity-and-permissions/sync-team-with-idp-group.md
@@ -1 +1 @@
-Team同期を有効化すると、チームメンテナとOrganizationのオーナーは、{% data variables.product.prodname_dotcom %}上で、あるいはAPIを通じてTeamをIdPグループに接続できます。 For more information, see "[Synchronizing a team with an identity provider group](/github/setting-up-and-managing-organizations-and-teams/synchronizing-a-team-with-an-identity-provider-group)" and "[Team synchronization](/v3/teams/team_sync/)."
\ No newline at end of file
+Team同期を有効化すると、チームメンテナとOrganizationのオーナーは、{% data variables.product.prodname_dotcom %}上で、あるいはAPIを通じてTeamをIdPグループに接続できます。 For more information, see "[Synchronizing a team with an identity provider group](/github/setting-up-and-managing-organizations-and-teams/synchronizing-a-team-with-an-identity-provider-group)" and "[Team synchronization](/v3/teams/team_sync/)."
diff --git a/translations/ja-JP/data/reusables/identity-and-permissions/team-sync-disable.md b/translations/ja-JP/data/reusables/identity-and-permissions/team-sync-disable.md
index 32af7fa6347f..2d27c51bdceb 100644
--- a/translations/ja-JP/data/reusables/identity-and-permissions/team-sync-disable.md
+++ b/translations/ja-JP/data/reusables/identity-and-permissions/team-sync-disable.md
@@ -2,4 +2,4 @@
 
 **警告:** Team同期を無効化すると、IdPグループを通じて{% data variables.product.prodname_dotcom %}のTeamに割り当てられたメンバーはTeamから削除され、リポジトリへのアクセスを失うことがあります。
 
-{% endwarning %}
\ No newline at end of file
+{% endwarning %}
diff --git a/translations/ja-JP/data/reusables/identity-and-permissions/team-sync-okta-requirements.md b/translations/ja-JP/data/reusables/identity-and-permissions/team-sync-okta-requirements.md
index 23786342dae3..2a2f1fb88ce6 100644
--- a/translations/ja-JP/data/reusables/identity-and-permissions/team-sync-okta-requirements.md
+++ b/translations/ja-JP/data/reusables/identity-and-permissions/team-sync-okta-requirements.md
@@ -2,4 +2,4 @@ OktaのTeam同期を有効化するには、あなたもしくはIdPの管理者
 
 - Oktaを利用するOrganizationでSAML SSOとSCIMを有効化する。 詳しい情報については「[Oktaを使用したSAMLシングルサインオンとSCIMの設定](/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta)」を参照してください。
 - OktaインスタンスのテナントURLを提供してください。
-- Okta環境にサービスユーザとして読み取りのみの管理権限を持つ、有効なSSWSトークンを生成してください。 詳しい情報についてはOktaのドキュメンテーションの[トークンの生成](https://developer.okta.com/docs/guides/create-an-api-token/create-the-token/)及び[サービスユーザ](https://help.okta.com/en/prod/Content/Topics/Adv_Server_Access/docs/service-users.htm)を参照してください。
\ No newline at end of file
+- Okta環境にサービスユーザとして読み取りのみの管理権限を持つ、有効なSSWSトークンを生成してください。 詳しい情報についてはOktaのドキュメンテーションの[トークンの生成](https://developer.okta.com/docs/guides/create-an-api-token/create-the-token/)及び[サービスユーザ](https://help.okta.com/en/prod/Content/Topics/Adv_Server_Access/docs/service-users.htm)を参照してください。
diff --git a/translations/ja-JP/data/reusables/interactions/collaborator-user-limit-definition.md b/translations/ja-JP/data/reusables/interactions/collaborator-user-limit-definition.md
index 62f4c861d7f2..718a221e6f7c 100644
--- a/translations/ja-JP/data/reusables/interactions/collaborator-user-limit-definition.md
+++ b/translations/ja-JP/data/reusables/interactions/collaborator-user-limit-definition.md
@@ -1 +1 @@
-**Collaborators only:** When you limit interactions to `collaborators_only`, users who are not collaborators will be temporarily restricted
\ No newline at end of file
+**Collaborators only:** When you limit interactions to `collaborators_only`, users who are not collaborators will be temporarily restricted
diff --git a/translations/ja-JP/data/reusables/interactions/contributor-user-limit-definition.md b/translations/ja-JP/data/reusables/interactions/contributor-user-limit-definition.md
index 134e152c9ee9..e750eb466295 100644
--- a/translations/ja-JP/data/reusables/interactions/contributor-user-limit-definition.md
+++ b/translations/ja-JP/data/reusables/interactions/contributor-user-limit-definition.md
@@ -1 +1 @@
-**Contributors only:** When you limit interactions to `contributors_only`,  users who have not previously contributed and are not collaborators will be temporarily restricted
\ No newline at end of file
+**Contributors only:** When you limit interactions to `contributors_only`,  users who have not previously contributed and are not collaborators will be temporarily restricted
diff --git a/translations/ja-JP/data/reusables/interactions/existing-user-limit-definition.md b/translations/ja-JP/data/reusables/interactions/existing-user-limit-definition.md
index 54c7d8b0b5f6..b921d4455547 100644
--- a/translations/ja-JP/data/reusables/interactions/existing-user-limit-definition.md
+++ b/translations/ja-JP/data/reusables/interactions/existing-user-limit-definition.md
@@ -1 +1 @@
-**Existing users:** When you limit interactions to `existing_users`, new users with accounts less than 24 hours old who have not previously contributed and are not collaborators will be temporarily restricted
\ No newline at end of file
+**Existing users:** When you limit interactions to `existing_users`, new users with accounts less than 24 hours old who have not previously contributed and are not collaborators will be temporarily restricted
diff --git a/translations/ja-JP/data/reusables/interactions/interactions-detail.md b/translations/ja-JP/data/reusables/interactions/interactions-detail.md
index 95ef4c017e4f..9193cd04e704 100644
--- a/translations/ja-JP/data/reusables/interactions/interactions-detail.md
+++ b/translations/ja-JP/data/reusables/interactions/interactions-detail.md
@@ -1 +1 @@
-When restrictions are enabled, only the specified group of {% data variables.product.product_name %} users will be able to participate in interactions. Restrictions expire 24 hours from the time they are set.
\ No newline at end of file
+When restrictions are enabled, only the specified group of {% data variables.product.product_name %} users will be able to participate in interactions. Restrictions expire 24 hours from the time they are set.
diff --git a/translations/ja-JP/data/reusables/issue-events/assignee-properties.md b/translations/ja-JP/data/reusables/issue-events/assignee-properties.md
index e408d915e266..60f612d89caf 100644
--- a/translations/ja-JP/data/reusables/issue-events/assignee-properties.md
+++ b/translations/ja-JP/data/reusables/issue-events/assignee-properties.md
@@ -1 +1 @@
-`assignee` | `object` | The person unassigned from this issue. `assigner` | `object` | The person who performed the unassignment for this issue.
\ No newline at end of file
+`assignee` | `object` | The person unassigned from this issue. `assigner` | `object` | The person who performed the unassignment for this issue.
diff --git a/translations/ja-JP/data/reusables/issue-events/issue-event-common-properties.md b/translations/ja-JP/data/reusables/issue-events/issue-event-common-properties.md
index c3596b2d4e76..2d756da5f02f 100644
--- a/translations/ja-JP/data/reusables/issue-events/issue-event-common-properties.md
+++ b/translations/ja-JP/data/reusables/issue-events/issue-event-common-properties.md
@@ -7,4 +7,4 @@
 | `event`      | `string` | Identifies the actual type of event that occurred.                   |
 | `commit_id`  | `string` | The SHA of the commit that referenced this issue.                    |
 | `commit_url` | `string` | The GitHub REST API link to the commit that referenced this issue.   |
-| `created_at` | `string` | The timestamp indicating when the event occurred.                    |
\ No newline at end of file
+| `created_at` | `string` | The timestamp indicating when the event occurred.                    |
diff --git a/translations/ja-JP/data/reusables/issue-events/label-properties.md b/translations/ja-JP/data/reusables/issue-events/label-properties.md
index 1d616889b1a1..e97ef30a880b 100644
--- a/translations/ja-JP/data/reusables/issue-events/label-properties.md
+++ b/translations/ja-JP/data/reusables/issue-events/label-properties.md
@@ -1 +1 @@
-`label` | `object` | The label removed from the issue `label[name]` | `string` | The name of the label. `label[color]` | `string` | The hex color code. 
\ No newline at end of file
+`label` | `object` | The label removed from the issue `label[name]` | `string` | The name of the label. `label[color]` | `string` | The hex color code. 
diff --git a/translations/ja-JP/data/reusables/issue-events/project-card-properties.md b/translations/ja-JP/data/reusables/issue-events/project-card-properties.md
index 646b6a85b558..457adf5eda1c 100644
--- a/translations/ja-JP/data/reusables/issue-events/project-card-properties.md
+++ b/translations/ja-JP/data/reusables/issue-events/project-card-properties.md
@@ -1 +1 @@
-`project_card` | `object` | The project card object. `project_id` | `integer` | The unique identifier of the project card. `project_url` | `string` | The REST API URL to retrieve the project card. `column_name` | `string` | The name of the column the issue is in.
\ No newline at end of file
+`project_card` | `object` | The project card object. `project_id` | `integer` | The unique identifier of the project card. `project_url` | `string` | The REST API URL to retrieve the project card. `column_name` | `string` | The name of the column the issue is in.
diff --git a/translations/ja-JP/data/reusables/issue-events/review-dismissed-properties.md b/translations/ja-JP/data/reusables/issue-events/review-dismissed-properties.md
index 9c6f67ec8671..7232cb9ea5d3 100644
--- a/translations/ja-JP/data/reusables/issue-events/review-dismissed-properties.md
+++ b/translations/ja-JP/data/reusables/issue-events/review-dismissed-properties.md
@@ -1 +1 @@
-`dismissed_review` | `object` | The information for the dismissed review. `dismissed_review[state]` | `string` | The state the pull request was in when it was dismissed. Can be one of: `commented`, `approved`, or `changes_requested`. `dismissed_review[review_id]` | `string` | The unique identifier of the pull request's review. `dismissed_review[dismissal_message]` | `string` | The message the user included when dismissing the review. `dismissed_review[dismissal_commit_id]` | `string` | The unique identifier of the commit that dismissed the review if one exists.
\ No newline at end of file
+`dismissed_review` | `object` | The information for the dismissed review. `dismissed_review[state]` | `string` | The state the pull request was in when it was dismissed. Can be one of: `commented`, `approved`, or `changes_requested`. `dismissed_review[review_id]` | `string` | The unique identifier of the pull request's review. `dismissed_review[dismissal_message]` | `string` | The message the user included when dismissing the review. `dismissed_review[dismissal_commit_id]` | `string` | The unique identifier of the commit that dismissed the review if one exists.
diff --git a/translations/ja-JP/data/reusables/issue-events/review-request-properties.md b/translations/ja-JP/data/reusables/issue-events/review-request-properties.md
index 350f0d3ff9dd..8821c8b69e8e 100644
--- a/translations/ja-JP/data/reusables/issue-events/review-request-properties.md
+++ b/translations/ja-JP/data/reusables/issue-events/review-request-properties.md
@@ -1 +1 @@
-`requested_reviewer` | `object` | The person requested to review the pull request. `review_requester` | `object` | The person who requested a review.
\ No newline at end of file
+`requested_reviewer` | `object` | The person requested to review the pull request. `review_requester` | `object` | The person who requested a review.
diff --git a/translations/ja-JP/data/reusables/issue-events/timeline_events_object_properties.md b/translations/ja-JP/data/reusables/issue-events/timeline_events_object_properties.md
index 43c03587e7df..c7877fcb46cb 100644
--- a/translations/ja-JP/data/reusables/issue-events/timeline_events_object_properties.md
+++ b/translations/ja-JP/data/reusables/issue-events/timeline_events_object_properties.md
@@ -1 +1 @@
-This events properties do not use the same structure as the [issue event object common properties](#issue-event-object-common-properties). The following properties are returned for this event.
\ No newline at end of file
+This events properties do not use the same structure as the [issue event object common properties](#issue-event-object-common-properties). The following properties are returned for this event.
diff --git a/translations/ja-JP/data/reusables/large_files/can-include-lfs-objects-archives.md b/translations/ja-JP/data/reusables/large_files/can-include-lfs-objects-archives.md
index e1cf5061386d..e7fe1359926c 100644
--- a/translations/ja-JP/data/reusables/large_files/can-include-lfs-objects-archives.md
+++ b/translations/ja-JP/data/reusables/large_files/can-include-lfs-objects-archives.md
@@ -2,4 +2,4 @@
 
 You can choose whether {% data variables.large_files.product_name_long %}({% data variables.large_files.product_name_short %}) objects are included in source code archives, such as ZIP files and tarballs, that {% data variables.product.product_name %} creates for your repository. 詳しい情報については、「[リポジトリのアーカイブ内の {% data variables.large_files.product_name_short %} オブジェクトを管理する](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)」を参照してください。
 
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/translations/ja-JP/data/reusables/marketplace/cancellation-clarification.md b/translations/ja-JP/data/reusables/marketplace/cancellation-clarification.md
index f4463ad23d57..80e164b90d61 100644
--- a/translations/ja-JP/data/reusables/marketplace/cancellation-clarification.md
+++ b/translations/ja-JP/data/reusables/marketplace/cancellation-clarification.md
@@ -1 +1 @@
-When a customer cancels a {% data variables.product.prodname_marketplace %} subscription, GitHub does not automatically uninstall the app, so the customer can expect that free features will continue to function.
\ No newline at end of file
+When a customer cancels a {% data variables.product.prodname_marketplace %} subscription, GitHub does not automatically uninstall the app, so the customer can expect that free features will continue to function.
diff --git a/translations/ja-JP/data/reusables/marketplace/github_apps_preferred.md b/translations/ja-JP/data/reusables/marketplace/github_apps_preferred.md
index 04c37a99c9c5..c9ccbece0da2 100644
--- a/translations/ja-JP/data/reusables/marketplace/github_apps_preferred.md
+++ b/translations/ja-JP/data/reusables/marketplace/github_apps_preferred.md
@@ -1 +1 @@
-GitHub Apps are the officially recommended way to integrate with GitHub because they offer much more granular permissions to access data
\ No newline at end of file
+GitHub Apps are the officially recommended way to integrate with GitHub because they offer much more granular permissions to access data
diff --git a/translations/ja-JP/data/reusables/marketplace/launch-with-free.md b/translations/ja-JP/data/reusables/marketplace/launch-with-free.md
index b809c37a0e6a..15230e218b5e 100644
--- a/translations/ja-JP/data/reusables/marketplace/launch-with-free.md
+++ b/translations/ja-JP/data/reusables/marketplace/launch-with-free.md
@@ -1 +1 @@
-You can submit both an unverified and verified app. This will allow you to launch with a free version of your app. Once GitHub verifies your app, your listing will change from unverified to verified in {% data variables.product.prodname_marketplace %} and GitHub will publish your new pricing plans.
\ No newline at end of file
+You can submit both an unverified and verified app. This will allow you to launch with a free version of your app. Once GitHub verifies your app, your listing will change from unverified to verified in {% data variables.product.prodname_marketplace %} and GitHub will publish your new pricing plans.
diff --git a/translations/ja-JP/data/reusables/marketplace/unverified-apps.md b/translations/ja-JP/data/reusables/marketplace/unverified-apps.md
index d390a5e5eaf0..b7ce68277e1c 100644
--- a/translations/ja-JP/data/reusables/marketplace/unverified-apps.md
+++ b/translations/ja-JP/data/reusables/marketplace/unverified-apps.md
@@ -1 +1 @@
-Unverified apps are only offered with free plans. To list paid plans, you must submit a verified app.
\ No newline at end of file
+Unverified apps are only offered with free plans. To list paid plans, you must submit a verified app.
diff --git a/translations/ja-JP/data/reusables/notifications-v2/email-notification-caveats.md b/translations/ja-JP/data/reusables/notifications-v2/email-notification-caveats.md
index 8f0122d5de6a..1abcfb440475 100644
--- a/translations/ja-JP/data/reusables/notifications-v2/email-notification-caveats.md
+++ b/translations/ja-JP/data/reusables/notifications-v2/email-notification-caveats.md
@@ -2,4 +2,4 @@
 
 {% if currentVersion == "free-pro-team@latest" %}
 {% data reusables.user_settings.verify-org-approved-email-domain %}
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/translations/ja-JP/data/reusables/notifications-v2/manage-notifications.md b/translations/ja-JP/data/reusables/notifications-v2/manage-notifications.md
index 3f8cefdd8c79..367f56f450a9 100644
--- a/translations/ja-JP/data/reusables/notifications-v2/manage-notifications.md
+++ b/translations/ja-JP/data/reusables/notifications-v2/manage-notifications.md
@@ -1 +1 @@
-1. 左側のサイドバーの、リポジトリリストの下にある [Manage notifications] ドロップダウンを使用して、[**Notification settings**] をクリックします。 ![[Manage notifications] ドロップダウンメニューオプション](/assets/images/help/notifications-v2/manage-notifications-options.png)
\ No newline at end of file
+1. 左側のサイドバーの、リポジトリリストの下にある [Manage notifications] ドロップダウンを使用して、[**Notification settings**] をクリックします。 ![[Manage notifications] ドロップダウンメニューオプション](/assets/images/help/notifications-v2/manage-notifications-options.png)
diff --git a/translations/ja-JP/data/reusables/notifications/shared_state.md b/translations/ja-JP/data/reusables/notifications/shared_state.md
index bc5ee888c22f..b85150b448d3 100644
--- a/translations/ja-JP/data/reusables/notifications/shared_state.md
+++ b/translations/ja-JP/data/reusables/notifications/shared_state.md
@@ -1,5 +1,5 @@
 {% tip %}
 
-**Tip:** Web通知とメール通知の両方を受信する場合、通知の既読あるいは未読状態を自動的に同期して、対応するメール通知を読んだら自動的にWeb通知が既読としてマークされるようにできます。 この同期を有効化するには、メールクライアントが{% if currentVersion == "free-pro-team@latest" %}`notifications@github.com`'{% else %}サイト管理者が設定したno-replyメールアドレス{% endif %}からの画像を表示できなければなりません。
+**Tip:** Web通知とメール通知の両方を受信する場合、通知の既読あるいは未読状態を自動的に同期して、対応するメール通知を読んだら自動的にWeb通知が既読としてマークされるようにできます。 To enable this sync, your email client must be able to view images from {% if currentVersion == "free-pro-team@latest" %}'`notifications@github.com`'{% else %}'the no-reply email address configured by your site administrator'{% endif %}.
 
 {% endtip %}
diff --git a/translations/ja-JP/data/reusables/organizations/can-require-ssh-cert.md b/translations/ja-JP/data/reusables/organizations/can-require-ssh-cert.md
index 7f5ab2b397f3..6da37763232e 100644
--- a/translations/ja-JP/data/reusables/organizations/can-require-ssh-cert.md
+++ b/translations/ja-JP/data/reusables/organizations/can-require-ssh-cert.md
@@ -1 +1 @@
-{% if currentVersion ver_gt "enterprise-server@2.17" %}SSHがリポジトリで無効になっていなければ、{% endif %}Organizationのリソースにメンバーがアクセスする際に、SSH証明書を使わなければならないようにすることができます。
+You can require that members use SSH certificates to access organization resources,, unless SSH is disabled in your repository.
diff --git a/translations/ja-JP/data/reusables/organizations/oauth_app_restrictions_default.md b/translations/ja-JP/data/reusables/organizations/oauth_app_restrictions_default.md
index 1a370f2e769f..e2006b29703f 100644
--- a/translations/ja-JP/data/reusables/organizations/oauth_app_restrictions_default.md
+++ b/translations/ja-JP/data/reusables/organizations/oauth_app_restrictions_default.md
@@ -1 +1 @@
-{% if currentVersion == "free-pro-team@latest" %}新しいOrganizationを作成する際には、{% data variables.product.prodname_oauth_app %}アクセス制限がデフォルトで有効です。 Organizationのオーナーは、いつでも[{% data variables.product.prodname_oauth_app %}アクセス制限を無効化](/articles/disabling-oauth-app-access-restrictions-for-your-organization)できます。{% endif %}
+{% if currentVersion == "free-pro-team@latest" %}When you create a new organization, {% data variables.product.prodname_oauth_app %} access restrictions are enabled by default. Organizationのオーナーは、いつでも[{% data variables.product.prodname_oauth_app %}アクセス制限を無効化](/articles/disabling-oauth-app-access-restrictions-for-your-organization)できます。{% endif %}
diff --git a/translations/ja-JP/data/reusables/organizations/organization-name.md b/translations/ja-JP/data/reusables/organizations/organization-name.md
index 3d8a6b8bece3..56dac82891cd 100644
--- a/translations/ja-JP/data/reusables/organizations/organization-name.md
+++ b/translations/ja-JP/data/reusables/organizations/organization-name.md
@@ -1 +1 @@
-1. "Organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}account{% endif %} name（Organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}アカウント{% endif %}名）"の下で、Organizationアカウントの名前を入力してください。 ![Organization名の入力フィールド](/assets/images/help/organizations/new-org-name.png)
+1. Under "Organization account name", type a name for your organization account. ![Organization名の入力フィールド](/assets/images/help/organizations/new-org-name.png)
diff --git a/translations/ja-JP/data/reusables/organizations/organizations_include.md b/translations/ja-JP/data/reusables/organizations/organizations_include.md
index 59ce99597653..0a12ae8577d8 100644
--- a/translations/ja-JP/data/reusables/organizations/organizations_include.md
+++ b/translations/ja-JP/data/reusables/organizations/organizations_include.md
@@ -1,5 +1,5 @@
 Organizationには以下が含まれます。
-{% if currentVersion == "free-pro-team@latest" %} - フル機能を持つ無制限のパブリックリポジトリ上の無制限のコラボレータと、機能限定された無制限のプライベートリポジトリを持つ無料オプション、{% data variables.product.prodname_free_team %}。
+{% if currentVersion == "free-pro-team@latest" %}- A free option, {% data variables.product.prodname_free_team %}, with unlimited collaborators on unlimited public repositories with full features and unlimited private repositories with limited features.
 - 洗練されたユーザ認証と管理、拡張されたサポートオプションを含む{% data variables.product.prodname_team %}もしくは{% data variables.product.prodname_ghe_cloud %}へのアップグレードオプション。 {% data reusables.gated-features.more-info %}{% endif %}
 - [Organizationとそのデータへの様々なレベルでのアクセス](/articles/permission-levels-for-an-organization)を許可する様々なロールを持つ無制限のメンバーシップ。
 - [Organizationのリポジトリに対する様々なアクセス権限](/articles/repository-permission-levels-for-an-organization)をユーザに与える機能。
diff --git a/translations/ja-JP/data/reusables/organizations/outside-collaborators-use-seats.md b/translations/ja-JP/data/reusables/organizations/outside-collaborators-use-seats.md
index afb727a40b97..52fd222d9245 100644
--- a/translations/ja-JP/data/reusables/organizations/outside-collaborators-use-seats.md
+++ b/translations/ja-JP/data/reusables/organizations/outside-collaborators-use-seats.md
@@ -1 +1 @@
-{% if currentVersion == "free-pro-team@latest" %}外部コラボレータをプライベートリポジトリに追加すると、Organizationの有料ライセンスが使われます。 詳しい情報については、「[ユーザごとの価格付けについて](/articles/about-per-user-pricing/)」を参照してください。{% endif %}
+{% if currentVersion == "free-pro-team@latest" %}Adding an outside collaborator to a private repository will use one of your organization's paid licenses. 詳しい情報については、「[ユーザごとの価格付けについて](/articles/about-per-user-pricing/)」を参照してください。{% endif %}
diff --git a/translations/ja-JP/data/reusables/organizations/repository-labels.md b/translations/ja-JP/data/reusables/organizations/repository-labels.md
index cc1e8b68c972..1909ac824b00 100644
--- a/translations/ja-JP/data/reusables/organizations/repository-labels.md
+++ b/translations/ja-JP/data/reusables/organizations/repository-labels.md
@@ -1 +1 @@
-1. 左のサイドバーで、**Repository labels（リポジトリのラベル）**をクリックしてください。 ![リポジトリのラベルタブ](/assets/images/help/organizations/repo-labels-tab.png)
\ No newline at end of file
+1. 左のサイドバーで、**Repository labels（リポジトリのラベル）**をクリックしてください。 ![リポジトリのラベルタブ](/assets/images/help/organizations/repo-labels-tab.png)
diff --git a/translations/ja-JP/data/reusables/organizations/send-invitation.md b/translations/ja-JP/data/reusables/organizations/send-invitation.md
index 0aea8eb08111..f1b7420e05a0 100644
--- a/translations/ja-JP/data/reusables/organizations/send-invitation.md
+++ b/translations/ja-JP/data/reusables/organizations/send-invitation.md
@@ -1 +1 @@
-1. {% if currentVersion == "free-pro-team@latest" %}**Send invitation（招待の送信）**{% else %}**Add member（メンバーの追加）**{% endif %}をクリックしてください。
+1. Click {% if currentVersion == "free-pro-team@latest" %}**Send invitation**{% else %}**Add member**{% endif %}.
diff --git a/translations/ja-JP/data/reusables/organizations/team_maintainers_can.md b/translations/ja-JP/data/reusables/organizations/team_maintainers_can.md
index 8a35bcbb9f7b..4b66b96ceccb 100644
--- a/translations/ja-JP/data/reusables/organizations/team_maintainers_can.md
+++ b/translations/ja-JP/data/reusables/organizations/team_maintainers_can.md
@@ -10,6 +10,6 @@
 - [OrganizationのメンバーのTeamへの追加](/articles/adding-organization-members-to-a-team)
 - [OrganizationメンバーのTeamからの削除](/articles/removing-organization-members-from-a-team)
 - [既存のTeamメンバーのチームメンテナへの昇格](/articles/giving-team-maintainer-permissions-to-an-organization-member)
-- リポジトリへのTeamのアクセスの削除{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}
-- [Teamのためのコードレビューの割り当て管理](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team){% endif %}{% if currentVersion == "free-pro-team@latest" %}
+- Remove the team's access to repositories{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}
+- [Manage code review assignment for the team](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team){% endif %}{% if currentVersion == "free-pro-team@latest" %}
 - [プルリクエストのスケジュールされたリマインダーの管理](/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests){% endif %}
diff --git a/translations/ja-JP/data/reusables/package_registry/admins-can-configure-package-types.md b/translations/ja-JP/data/reusables/package_registry/admins-can-configure-package-types.md
index 82369c5e4a37..029a2131212e 100644
--- a/translations/ja-JP/data/reusables/package_registry/admins-can-configure-package-types.md
+++ b/translations/ja-JP/data/reusables/package_registry/admins-can-configure-package-types.md
@@ -1,7 +1,7 @@
 {% if currentVersion != "free-pro-team@latest" %}
 {% note %}
 
-**Note:** This package type may not be available for your instance, because site administrators can enable or disable each supported package type. For more information, see "[Configuring packages support for your enterprise](/enterprise/admin/packages/configuring-packages-support-for-your-enterprise)."
+**Note:** This package type may not be available for your instance, because site administrators can enable or disable each supported package type. 詳しい情報については、「[Enterprise 向けのパッケージサポートを設定する](/enterprise/admin/packages/configuring-packages-support-for-your-enterprise)」を参照してください。
 
 {% endnote %}
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/translations/ja-JP/data/reusables/package_registry/authenticate-packages.md b/translations/ja-JP/data/reusables/package_registry/authenticate-packages.md
index af2d83728e83..4c2a168f0218 100644
--- a/translations/ja-JP/data/reusables/package_registry/authenticate-packages.md
+++ b/translations/ja-JP/data/reusables/package_registry/authenticate-packages.md
@@ -1,9 +1,11 @@
-{% data variables.product.prodname_registry %}でパッケージを公開、インストール、削除するにはアクセストークンが必要です。 {% data variables.product.prodname_registry %}に直接、あるいは{% data variables.product.prodname_dotcom %} APIでユーザ名で認証を受けるのに、個人のアクセストークンが利用できます。 個人トークンを作成する際には、必要に応じて様々なスコープをトークンに割り当てできます。
+{{ site.data.variables.product.prodname_registry }}でパッケージを公開、インストール、削除するにはアクセストークンが必要です。 {% data variables.product.prodname_registry %}に直接、あるいは{% data variables.product.prodname_dotcom %} APIでユーザ名で認証を受けるのに、個人のアクセストークンが利用できます。 個人トークンを作成する際には、必要に応じて様々なスコープをトークンに割り当てできます。
 
 {% if currentVersion == "free-pro-team@latest" %}
-To authenticate using a {% data variables.product.prodname_actions %} workflow:
+To authenticate using a
+{% data variables.product.prodname_actions %}のワークフロー:
 - For package registries (`PACKAGE-REGISTRY.pkg.github.com/OWNER/REPOSITORY/IMAGE-NAME`), you can use a `GITHUB_TOKEN`.
 - For the container registry (`ghcr.io/OWNER/IMAGE-NAME`), you must use a personal access token.
 {% else %}
-To authenticate to {% data variables.product.prodname_registry %} using a {% data variables.product.prodname_actions %} workflow, you must use `GITHUB_TOKEN`.
+To authenticate to
+{% data variables.product.prodname_registry %} using a {% data variables.product.prodname_actions %} workflow, you must use `GITHUB_TOKEN`.
 {% endif %}
diff --git a/translations/ja-JP/data/reusables/package_registry/authenticate-to-container-registry-steps.md b/translations/ja-JP/data/reusables/package_registry/authenticate-to-container-registry-steps.md
new file mode 100644
index 000000000000..0862005cda21
--- /dev/null
+++ b/translations/ja-JP/data/reusables/package_registry/authenticate-to-container-registry-steps.md
@@ -0,0 +1,25 @@
+1. Create a new personal access token (PAT) with the appropriate scopes for the tasks you want to accomplish. If your organization requires SSO, you must enable SSO for your new token.
+  {% warning %}
+
+  **Note:** If you select the `write:packages` scope, deselect the `repo` scope when creating the PAT. Adding a PAT with the `repo` scope as a secret in your repository allows the credential to be accessible to all collaborators in the repository. This gives unnecessary additional access when a PAT with the `repo` scope is used within an action. For more information on security best practices for actions, see "[Security hardening for GitHub Actions](/actions/getting-started-with-github-actions/security-hardening-for-github-actions#considering-cross-repository-access)."
+
+  {% endwarning %}
+
+    - Select the `read:packages` scope to download container images and read their metadata.
+    - Select the `write:packages` scope to download and upload container images and read and write their metadata.
+    - Select the `delete:packages` scope to delete container images.
+
+  詳しい情報については[コマンドラインのための個人のアクセストークンの作成](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)を参照してください。
+
+2. Save your PAT. We recommend saving your PAT as an environment variable.
+  ```shell
+  $ export CR_PAT=YOUR_TOKEN
+  ```
+3. Using the CLI for your container type, sign in to the
+{% data variables.product.prodname_github_container_registry %} service at `ghcr.io`.
+  {% raw %}
+  ```shell
+  $ echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin
+  > Login Succeeded
+  ```
+  {% endraw %}
diff --git a/translations/ja-JP/data/reusables/package_registry/authenticate_with_pat_for_container_registry.md b/translations/ja-JP/data/reusables/package_registry/authenticate_with_pat_for_container_registry.md
new file mode 100644
index 000000000000..7a08298672be
--- /dev/null
+++ b/translations/ja-JP/data/reusables/package_registry/authenticate_with_pat_for_container_registry.md
@@ -0,0 +1,9 @@
+{% if currentVersion == "free-pro-team@latest" %}
+If you want to authenticate to
+{% data variables.product.prodname_github_container_registry %} in a {% data variables.product.prodname_actions %} workflow, then you must use a personal access token (PAT). The `GITHUB_TOKEN` does not currently have the required permissions. During the {% data variables.product.prodname_github_container_registry %} beta, the only supported form of authentication is the PAT.
+
+PATs can grant broad access to your account. We recommend selecting only the necessary read, write, or delete `package` scope when creating a PAT to authenticate to the {% data variables.product.prodname_container_registry %}. Avoid including the `repo` scope in a PAT used by a GitHub Actions workflow because it gives unnecessary additional access.
+
+If you'd like to use the {% data variables.product.prodname_container_registry %} in actions during the beta, follow our security best practices for PAT use at "[Security hardening for GitHub Actions](/actions/getting-started-with-github-actions/security-hardening-for-github-actions#considering-cross-repository-access)."
+
+{% endif %}
diff --git a/translations/ja-JP/data/reusables/package_registry/container-registry-beta.md b/translations/ja-JP/data/reusables/package_registry/container-registry-beta.md
index b1b8e612b0c1..03ca5504b82f 100644
--- a/translations/ja-JP/data/reusables/package_registry/container-registry-beta.md
+++ b/translations/ja-JP/data/reusables/package_registry/container-registry-beta.md
@@ -1,5 +1,5 @@
 {% note %}
 
-**Note:** {% data variables.product.prodname_github_container_registry %} is currently in public beta and subject to change. Currently, {% data variables.product.prodname_github_container_registry %} only supports Docker image formats. During the beta, storage and bandwidth is free. 詳しい情報については「[{% data variables.product.prodname_github_container_registry %}について](/packages/getting-started-with-github-container-registry/about-github-container-registry)」を参照してください。
+**注釈:** {% data variables.product.prodname_github_container_registry %} は現在パブリックベータであり、変更されることがあります。 現在のところ、{% data variables.product.prodname_github_container_registry %} がサポートしているのは Docker イメージフォーマットのみです。 ベータ期間中は、ストレージおよび帯域幅の制限はありません。 詳しい情報については「[{% data variables.product.prodname_github_container_registry %}について](/packages/getting-started-with-github-container-registry/about-github-container-registry)」を参照してください。
 
 {% endnote %}
diff --git a/translations/ja-JP/data/reusables/package_registry/docker_registry_deprecation_status.md b/translations/ja-JP/data/reusables/package_registry/docker_registry_deprecation_status.md
new file mode 100644
index 000000000000..79e9650f348f
--- /dev/null
+++ b/translations/ja-JP/data/reusables/package_registry/docker_registry_deprecation_status.md
@@ -0,0 +1,5 @@
+{% warning %}
+
+**Note:** The {% data variables.product.prodname_registry %} Docker registry will be superseded by {% data variables.product.prodname_github_container_registry %}{% if currentVersion != "free-pro-team@latest" %} in a future {% data variables.product.product_name %} release{% endif %}.{% if currentVersion == "free-pro-team@latest" %} To learn how to migrate your existing Docker images and any workflows using them, see "[Migrating to {% data variables.product.prodname_github_container_registry %} for Docker images](/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images)" and "[Getting started with {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry)."{% endif %}
+
+{% endwarning %}
diff --git a/translations/ja-JP/data/reusables/package_registry/package-immutability.md b/translations/ja-JP/data/reusables/package_registry/package-immutability.md
index 092a1cbe978c..2c3b1d595dcf 100644
--- a/translations/ja-JP/data/reusables/package_registry/package-immutability.md
+++ b/translations/ja-JP/data/reusables/package_registry/package-immutability.md
@@ -1,3 +1,5 @@
-混乱とビルドの問題を回避するために、{% data variables.product.prodname_dotcom %}は恒久的にパッケージ名とバージョン番号を予約します。 パッケージ全体が削除された場合でも、削除されたパッケージの名前は、同じアカウントが所有するいかなるリポジトリ内でも再利用できません。
+**Public packages:** To prevent confusion and build problems, {% data variables.product.prodname_dotcom %} permanently reserves a package's name and version number. パッケージ全体が削除された場合でも、削除されたパッケージの名前は、同じアカウントが所有するいかなるリポジトリ内でも再利用できません。
+
+**Private packages:** If all versions of a private package are deleted, you can publish a package with a previously used name and version.
 
 パッケージのバージョンを改訂もしくは置き換えるには、パッケージの新バージョンを公開することをおすすめします。
diff --git a/translations/ja-JP/data/reusables/package_registry/package-settings-from-org-level.md b/translations/ja-JP/data/reusables/package_registry/package-settings-from-org-level.md
index 9507393f82bb..39927432f6e3 100644
--- a/translations/ja-JP/data/reusables/package_registry/package-settings-from-org-level.md
+++ b/translations/ja-JP/data/reusables/package_registry/package-settings-from-org-level.md
@@ -1,4 +1,4 @@
 1. On {% data variables.product.prodname_dotcom %}, navigate to the main page of your organization.
-2. Under your organization name, click **Packages**. ![Container access invite button](/assets/images/help/package-registry/org-tab-for-packages.png)
+2. Under your organization name, click **Packages**. ![コンテナアクセス権の招待ボタン](/assets/images/help/package-registry/org-tab-for-packages.png)
 3. Search for and select your package.
 4. In the top right of your container image's landing page, click **Package settings**. ![Package settings button](/assets/images/help/package-registry/packages-settings-from-package-landing-page.png)
diff --git a/translations/ja-JP/data/reusables/package_registry/public-or-private-packages.md b/translations/ja-JP/data/reusables/package_registry/public-or-private-packages.md
index 81556ada2f03..96876d84f347 100644
--- a/translations/ja-JP/data/reusables/package_registry/public-or-private-packages.md
+++ b/translations/ja-JP/data/reusables/package_registry/public-or-private-packages.md
@@ -1 +1 @@
-パッケージをパブリックリポジトリに公開（パブリックパッケージ）して、{% data variables.product.prodname_dotcom %}の全員と共有したり、プライベートリポジトリに公開（プライベートパッケージ）してコラボレータやOrganizationと共有したりできます。
+You can publish packages in a public repository (public packages) to share with {% if currentVersion == "free-pro-team@latest" %}all of {% data variables.product.prodname_dotcom %}{% else %}everyone on your instance{% endif %}, or in a private repository (private packages) to share with collaborators or an organization.
diff --git a/translations/ja-JP/data/reusables/pages/admin-must-push.md b/translations/ja-JP/data/reusables/pages/admin-must-push.md
index c5380c73fa61..50633bf3dca8 100644
--- a/translations/ja-JP/data/reusables/pages/admin-must-push.md
+++ b/translations/ja-JP/data/reusables/pages/admin-must-push.md
@@ -1,5 +1,5 @@
 {% tip %}
 
-**Note**: If your site{% if currentVersion ver_lt "enterprise-server@2.22" %}'s source files are located in the default publishing source—`master` for user and organization sites or `gh-pages` for project sites—but your site{% endif %} has not published automatically, make sure someone with admin permissions and a verified email address has pushed to the publishing source.
+**Note**: If your site{% if currentVersion ver_lt "enterprise-server@2.23" %}'s source files are located in the default publishing source—`master` for user and organization sites or `gh-pages` for project sites—but your site{% endif %} has not published automatically, make sure someone with admin permissions and a verified email address has pushed to the publishing source.
 
 {% endtip %}
diff --git a/translations/ja-JP/data/reusables/pages/best-with-supported-themes.md b/translations/ja-JP/data/reusables/pages/best-with-supported-themes.md
index a8e7dcf47c85..87c030121ae9 100644
--- a/translations/ja-JP/data/reusables/pages/best-with-supported-themes.md
+++ b/translations/ja-JP/data/reusables/pages/best-with-supported-themes.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-こうした手順は、{% data variables.product.prodname_pages %} により公式にサポートされているテーマで最もうまくいきます。 サポートされているテーマの完全なリストについては、{% data variables.product.prodname_pages %} サイトで「[サポートされているテーマ](https://pages.github.com/themes/)」を参照してください。
+These instructions work best with themes that are officially supported by
+{% data variables.product.prodname_pages %}. サポートされているテーマの完全なリストについては、{% data variables.product.prodname_pages %} サイトで「[サポートされているテーマ](https://pages.github.com/themes/)」を参照してください。
 {% endif %}
diff --git a/translations/ja-JP/data/reusables/pages/build-locally-download-cname.md b/translations/ja-JP/data/reusables/pages/build-locally-download-cname.md
index 5d47eaad1462..e552ba15b3f0 100644
--- a/translations/ja-JP/data/reusables/pages/build-locally-download-cname.md
+++ b/translations/ja-JP/data/reusables/pages/build-locally-download-cname.md
@@ -1 +1 @@
-1. 静的サイトジェネレータを使ってローカルでサイトを構築し、生成されたファイルを{% data variables.product.product_name %}にプッシュしているなら、ローカルのリポジトリに_CNAME_ファイルを追加したコミットをプルしてください。 詳しい情報については「[カスタムドメインと{% data variables.product.prodname_pages %}のトラブルシューティング](/articles/troubleshooting-custom-domains-and-github-pages#cname-errors)」を参照してください。
+1. 静的サイトジェネレータを使ってローカルでサイトを構築し、生成されたファイルを{% data variables.product.product_name %}にプッシュしてイルなら、ローカルのリポジトリに_CNAME_ファイルを追加したコミットをプルしてください。 詳しい情報については「[カスタムドメインと{% data variables.product.prodname_pages %}のトラブルシューティング](/articles/troubleshooting-custom-domains-and-github-pages#cname-errors)」を参照してください。
diff --git a/translations/ja-JP/data/reusables/pages/decide-publishing-source.md b/translations/ja-JP/data/reusables/pages/decide-publishing-source.md
index 2736d7e2b48d..8e950fc86be7 100644
--- a/translations/ja-JP/data/reusables/pages/decide-publishing-source.md
+++ b/translations/ja-JP/data/reusables/pages/decide-publishing-source.md
@@ -1 +1 @@
-1. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}Decide{% else %}If you're creating a project site, decide{% endif %} which publishing source you want to use. {% if currentVersion ver_lt "enterprise-server@2.22" %}If you're creating a user or organization site, you must store your site's source code on the `master` branch.{% endif %} For more information, see "[About {% data variables.product.prodname_pages %}](/articles/about-github-pages#publishing-sources-for-github-pages-sites)."
+1. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}Decide{% else %}If you're creating a project site, decide{% endif %} which publishing source you want to use. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're creating a user or organization site, you must store your site's source code on the `master` branch.{% endif %} For more information, see "[About {% data variables.product.prodname_pages %}](/articles/about-github-pages#publishing-sources-for-github-pages-sites)."
diff --git a/translations/ja-JP/data/reusables/pages/new-or-existing-repo.md b/translations/ja-JP/data/reusables/pages/new-or-existing-repo.md
index d6eefcb8200e..d5ceb529c3d6 100644
--- a/translations/ja-JP/data/reusables/pages/new-or-existing-repo.md
+++ b/translations/ja-JP/data/reusables/pages/new-or-existing-repo.md
@@ -1,3 +1,3 @@
-サイトが独立プロジェクトなら、サイトのソースコードを保存するために新しいリポジトリを作成できます。 サイトが独立プロジェクトなら、サイトのソースコードを保存するために新しいリポジトリを作成できます。
+サイトが独立プロジェクトなら、サイトのソースコードを保存するために新しいリポジトリを作成できます。 If your site is associated with an existing project, you can add the source code {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}to that project's repository, in a `/docs` folder on the default branch or on a different branch.{% else %}for your site to a `gh-pages` branch or a `docs` folder on the `master` branch in that project's repository.{% endif %} For example, if you're creating a site to publish documentation for a project that's already on {% data variables.product.product_name %}, you may want to store the source code for the site in the same repository as the project.
 
 既存のリポジトリにサイトを作成したいのなら、[サイトの作成](#creating-your-site)セクションまでスキップしてください。
diff --git a/translations/ja-JP/data/reusables/pages/private_pages_are_public_warning.md b/translations/ja-JP/data/reusables/pages/private_pages_are_public_warning.md
index 6a2b52d7d286..2579c5d10f51 100644
--- a/translations/ja-JP/data/reusables/pages/private_pages_are_public_warning.md
+++ b/translations/ja-JP/data/reusables/pages/private_pages_are_public_warning.md
@@ -1,5 +1,5 @@
   {% warning %}
 
-  **Warning**: {% if currentVersion != "free-pro-team@latest" %}If your site administrator has enabled Public Pages, {% endif %}{% data variables.product.prodname_pages %} sites are publicly available on the internet, even if the repository for the site is private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %}. サイトのリポジトリにセンシティブなデータがあるなら、公開前にそれを取り除くのが良いでしょう。 詳しい情報については{% if currentVersion != "free-pro-team@latest" %}「[アプライアンス上での{% data variables.product.prodname_pages %}の設定](/enterprise/admin/installation/configuring-github-pages-on-your-appliance#making-github-pages-publicly-accessible)」及び{% endif %}「[リポジトリの可視性について](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)」を参照してください。
+  **Warning**: {% if currentVersion != "free-pro-team@latest" %}If your site administrator has enabled Public Pages, {% endif %}{% data variables.product.prodname_pages %} sites are publicly available on the internet, even if the repository for the site is private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %}. If you have sensitive data in your site's repository, you may want to remove it before publishing. For more information, see{% if currentVersion != "free-pro-team@latest" %} "[Configuring {% data variables.product.prodname_pages %} on your appliance](/enterprise/admin/installation/configuring-github-pages-on-your-appliance#making-github-pages-publicly-accessible)" and{% endif %} "[About repository visibility](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)."
 
   {% endwarning %}
diff --git a/translations/ja-JP/data/reusables/policies/abuse.md b/translations/ja-JP/data/reusables/policies/abuse.md
index 062aae73a0f2..78c56e096b05 100644
--- a/translations/ja-JP/data/reusables/policies/abuse.md
+++ b/translations/ja-JP/data/reusables/policies/abuse.md
@@ -1 +1 @@
-{% data variables.product.prodname_dotcom %} は不正な使用を一切認めていません。{% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_dotcom %} のポリシーに関する詳しい情報については、GitHub の[利用規約](/articles/github-terms-of-service)および[コミュニティガイドライン](/articles/github-community-guidelines)を参照してください。{% endif %}
+{% data variables.product.prodname_dotcom %} does not tolerate abuse.{% if currentVersion == "free-pro-team@latest" %} For more information on {% data variables.product.prodname_dotcom %}'s policies, see our [Terms of Service](/articles/github-terms-of-service) and [Community Guidelines](/articles/github-community-guidelines).{% endif %}
diff --git a/translations/ja-JP/data/reusables/pre-release-program/machine-man-preview.md b/translations/ja-JP/data/reusables/pre-release-program/machine-man-preview.md
index 8fb50254cd1f..bdcee03dec6f 100644
--- a/translations/ja-JP/data/reusables/pre-release-program/machine-man-preview.md
+++ b/translations/ja-JP/data/reusables/pre-release-program/machine-man-preview.md
@@ -6,4 +6,4 @@
 `application/vnd.github.machine-man-preview+json`
 
 {% endnote %}
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/translations/ja-JP/data/reusables/pre-release-program/suspend-installation-beta.md b/translations/ja-JP/data/reusables/pre-release-program/suspend-installation-beta.md
index 3d81271d74ca..ae027690926d 100644
--- a/translations/ja-JP/data/reusables/pre-release-program/suspend-installation-beta.md
+++ b/translations/ja-JP/data/reusables/pre-release-program/suspend-installation-beta.md
@@ -1,4 +1,5 @@
 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}
-Suspending a {% data variables.product.prodname_github_app %} installation is currently in beta and subject to change. Before you can suspend a {% data variables.product.prodname_github_app %}, the app owner must enable suspending installations for the app by opting-in to the beta. To opt-in to the suspending installations beta feature, see "[Activating beta features for apps](/developers/apps/activating-beta-features-for-apps)."
+Suspending a
+{% data variables.product.prodname_github_app %} installation is currently in beta and subject to change. Before you can suspend a {% data variables.product.prodname_github_app %}, the app owner must enable suspending installations for the app by opting-in to the beta. To opt-in to the suspending installations beta feature, see "[Activating beta features for apps](/developers/apps/activating-beta-features-for-apps)."
 
 {% endif %}
diff --git a/translations/ja-JP/data/reusables/profile/profile-readme.md b/translations/ja-JP/data/reusables/profile/profile-readme.md
index 6c734861db2e..a19a3d4a30d3 100644
--- a/translations/ja-JP/data/reusables/profile/profile-readme.md
+++ b/translations/ja-JP/data/reusables/profile/profile-readme.md
@@ -1 +1 @@
-If you add a README file to the root of a public repository with the same name as your username, that README will automatically appear on your profile page. You can edit your profile README with GitHub Flavored Markdown to create a personalized section on your profile.
\ No newline at end of file
+If you add a README file to the root of a public repository with the same name as your username, that README will automatically appear on your profile page. You can edit your profile README with GitHub Flavored Markdown to create a personalized section on your profile.
diff --git a/translations/ja-JP/data/reusables/project-management/link-repos-to-project-board.md b/translations/ja-JP/data/reusables/project-management/link-repos-to-project-board.md
index e1b1d6b5334f..2519bbfef5c2 100644
--- a/translations/ja-JP/data/reusables/project-management/link-repos-to-project-board.md
+++ b/translations/ja-JP/data/reusables/project-management/link-repos-to-project-board.md
@@ -1 +1 @@
-最大で25のリポジトリをOrganizationもしくはユーザが所有するプロジェクトボードにリンクできます。 リポジトリをリンクすると、**{% octicon "plus" aria-label="The Plus icon" %} Add cards（カードの追加）**を利用して{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}、あるいはIssueもしくはプルリクエストのサイドバーから{% endif %}、それらのリポジトリからプロジェクトボードにIssueやプルリクエストを追加しやすくなります。
+最大で25のリポジトリをOrganizationもしくはユーザが所有するプロジェクトボードにリンクできます。 リポジトリをリンクすると、**{% octicon "plus" aria-label="The Plus icon" %} Add cards（カードの追加）**を利用して、あるいはIssueもしくはプルリクエストのサイドバーから、それらのリポジトリからプロジェクトボードにIssueやプルリクエストを追加しやすくなります。
diff --git a/translations/ja-JP/data/reusables/project-management/project-board-import-with-api.md b/translations/ja-JP/data/reusables/project-management/project-board-import-with-api.md
index 799df8a4d973..8844e0f08a92 100644
--- a/translations/ja-JP/data/reusables/project-management/project-board-import-with-api.md
+++ b/translations/ja-JP/data/reusables/project-management/project-board-import-with-api.md
@@ -1 +1 @@
-{% data variables.product.prodname_dotcom %}のAPIを使って、プロジェクトボードをインポートできます。 For more information, see "[importProject](/v4/mutation/importproject/)."
+{% data variables.product.prodname_dotcom %}のAPIを使って、プロジェクトボードをインポートできます。 For more information, see "[importProject](/graphql/reference/mutations#importproject/)."
diff --git a/translations/ja-JP/data/reusables/projects/disabled-projects.md b/translations/ja-JP/data/reusables/projects/disabled-projects.md
index 2b10747e7e27..9f6e391db7fe 100644
--- a/translations/ja-JP/data/reusables/projects/disabled-projects.md
+++ b/translations/ja-JP/data/reusables/projects/disabled-projects.md
@@ -1 +1 @@
-You only see this event in responses when project boards have been [enabled](/articles/disabling-project-boards-in-a-repository) in the repository.
\ No newline at end of file
+You only see this event in responses when project boards have been [enabled](/articles/disabling-project-boards-in-a-repository) in the repository.
diff --git a/translations/ja-JP/data/reusables/pull_requests/automatically-delete-branches.md b/translations/ja-JP/data/reusables/pull_requests/automatically-delete-branches.md
index 6db053f79cfe..22ea68c8c89f 100644
--- a/translations/ja-JP/data/reusables/pull_requests/automatically-delete-branches.md
+++ b/translations/ja-JP/data/reusables/pull_requests/automatically-delete-branches.md
@@ -1,3 +1 @@
-{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}
 プルリクエストがリポジトリにマージされた後、head ブランチを自動的に削除することができます。 詳しい情報については「[ブランチの自動削除の管理](/articles/managing-the-automatic-deletion-of-branches)」を参照してください。
-{% endif %}
diff --git a/translations/ja-JP/data/reusables/pull_requests/close-issues-using-keywords.md b/translations/ja-JP/data/reusables/pull_requests/close-issues-using-keywords.md
index a4de3067b556..bfabb3648058 100644
--- a/translations/ja-JP/data/reusables/pull_requests/close-issues-using-keywords.md
+++ b/translations/ja-JP/data/reusables/pull_requests/close-issues-using-keywords.md
@@ -1 +1 @@
-プルリクエストをIssueにリンクして、{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}修復が進んでいることを示すことや、{% endif %}誰かがプルリクエストをマージしたときにIssueを自動的にクローズすることができます。 詳しい情報については「[プルリクエストのIssueへのリンク](/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue)」を参照してください。
+You can link a pull request to an issue to{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} show that a fix is in progress and to{% endif %} automatically close the issue when someone merges the pull request. 詳しい情報については「[プルリクエストのIssueへのリンク](/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue)」を参照してください。
diff --git a/translations/ja-JP/data/reusables/pull_requests/collect-co-author-commit-git-config-info.md b/translations/ja-JP/data/reusables/pull_requests/collect-co-author-commit-git-config-info.md
index 82b38fc920d8..b832ddb27e54 100644
--- a/translations/ja-JP/data/reusables/pull_requests/collect-co-author-commit-git-config-info.md
+++ b/translations/ja-JP/data/reusables/pull_requests/collect-co-author-commit-git-config-info.md
@@ -1 +1 @@
-1. 各 co-author (共同作者) の名前とメールアドレスを収集してください。{% if currentVersion == "free-pro-team@latest" %}メールアドレスをプライベートにしておきたい人がいる場合、そのプライバシーを保護するためにその人には {% data variables.product.product_name %} が提供する`no-reply`メールを使わなければなりません。{% endif %}
+1. Collect the name and email address for each co-author.{% if currentVersion == "free-pro-team@latest" %} If a person chooses to keep their email address private, you should use their {% data variables.product.product_name %}-provided `no-reply` email to protect their privacy.{% endif %}
diff --git a/translations/ja-JP/data/reusables/pull_requests/default-commit-message-squash-merge.md b/translations/ja-JP/data/reusables/pull_requests/default-commit-message-squash-merge.md
index b3078501ba08..9c64294aff7f 100644
--- a/translations/ja-JP/data/reusables/pull_requests/default-commit-message-squash-merge.md
+++ b/translations/ja-JP/data/reusables/pull_requests/default-commit-message-squash-merge.md
@@ -1 +1 @@
-squashマージのデフォルトのコミットメッセージに関する情報については「[プルリクエストのマージについて](/github/collaborating-with-issues-and-pull-requests/about-pull-request-merges#merge-message-for-a-squash-merge)」を参照してください。
\ No newline at end of file
+squashマージのデフォルトのコミットメッセージに関する情報については「[プルリクエストのマージについて](/github/collaborating-with-issues-and-pull-requests/about-pull-request-merges#merge-message-for-a-squash-merge)」を参照してください。
diff --git a/translations/ja-JP/data/reusables/pull_requests/mark-ready-review.md b/translations/ja-JP/data/reusables/pull_requests/mark-ready-review.md
index e80138b80f9a..27d6e6668ac1 100644
--- a/translations/ja-JP/data/reusables/pull_requests/mark-ready-review.md
+++ b/translations/ja-JP/data/reusables/pull_requests/mark-ready-review.md
@@ -1 +1 @@
-プルリクエストに対するフィードバックをもらう準備ができているなら、ドラフトのプルリクエストにレビューの準備ができているとマークできます。 プルリクエストにレビューの準備ができているとマークすると、コードオーナーたちからのレビューをリクエストすることになります。
\ No newline at end of file
+プルリクエストに対するフィードバックをもらう準備ができているなら、ドラフトのプルリクエストにレビューの準備ができているとマークできます。 プルリクエストにレビューの準備ができているとマークすると、コードオーナーたちからのレビューをリクエストすることになります。
diff --git a/translations/ja-JP/data/reusables/pull_requests/pull_request_merges_and_contributions.md b/translations/ja-JP/data/reusables/pull_requests/pull_request_merges_and_contributions.md
index 867f93efbc3e..a6ba58a5a6e5 100644
--- a/translations/ja-JP/data/reusables/pull_requests/pull_request_merges_and_contributions.md
+++ b/translations/ja-JP/data/reusables/pull_requests/pull_request_merges_and_contributions.md
@@ -1,6 +1,6 @@
 {% note %}
 
-**ノート:**{% if currentVersion != "free-pro-team@latest" %}
+**Notes:**{% if currentVersion != "free-pro-team@latest" %}
 - プロフィールのコントリビューショングラフに表示されるためには、co-authoredコミットは一人の作者によるコミットと同じ条件を満たさなければなりません。{% endif %}
 - コミットをリベースする際には、コミットのオリジナルの作者と、コマンドラインか{% data variables.product.product_location %}かによらずコミットをリベースした人が、コントリビューションクレジットを受け取ります。
 
diff --git a/translations/ja-JP/data/reusables/reminders/author-reviews.md b/translations/ja-JP/data/reusables/reminders/author-reviews.md
index f45eed85c00e..c51b09c8aeae 100644
--- a/translations/ja-JP/data/reusables/reminders/author-reviews.md
+++ b/translations/ja-JP/data/reusables/reminders/author-reviews.md
@@ -1 +1 @@
-1. あるいは、レビューのリクエストが満たされた後にプルリクエストの作者にリマインダーを送信するには、**Remind authors after reviews（レビュー後に作者にリマインド）**を選択して、リマインダーを送信するまでに必要なレビューの数を選択してください。 ![レビュー後の作者へのリマインドのチェックボックス](/assets/images/help/settings/scheduled-reminders-remind-authors.png)
\ No newline at end of file
+1. あるいは、レビューのリクエストが満たされた後にプルリクエストの作者にリマインダーを送信するには、**Remind authors after reviews（レビュー後に作者にリマインド）**を選択して、リマインダーを送信するまでに必要なレビューの数を選択してください。 ![レビュー後の作者へのリマインドのチェックボックス](/assets/images/help/settings/scheduled-reminders-remind-authors.png)
diff --git a/translations/ja-JP/data/reusables/reminders/ignored-labels.md b/translations/ja-JP/data/reusables/reminders/ignored-labels.md
index 0c24b9c7a6c7..0f3e94ca469a 100644
--- a/translations/ja-JP/data/reusables/reminders/ignored-labels.md
+++ b/translations/ja-JP/data/reusables/reminders/ignored-labels.md
@@ -1 +1 @@
-1. "Ignored labels（無視されたラベル）"の下に、カンマ区切りでラベルのリストを入力してください。 スケジュールされたリマインダーは、それらのラベルを1つ以上持っているプルリクエストを含めなくなります。 ![無視されるラベルフィールド](/assets/images/help/settings/scheduled-reminders-ignored-labels-field.png)
\ No newline at end of file
+1. "Ignored labels（無視されたラベル）"の下に、カンマ区切りでラベルのリストを入力してください。 スケジュールされたリマインダーは、それらのラベルを1つ以上持っているプルリクエストを含めなくなります。 ![無視されるラベルフィールド](/assets/images/help/settings/scheduled-reminders-ignored-labels-field.png)
diff --git a/translations/ja-JP/data/reusables/reminders/ignored-terms.md b/translations/ja-JP/data/reusables/reminders/ignored-terms.md
index 8654b7673a36..99b82342bca1 100644
--- a/translations/ja-JP/data/reusables/reminders/ignored-terms.md
+++ b/translations/ja-JP/data/reusables/reminders/ignored-terms.md
@@ -1 +1 @@
-1. "Ignored terms（無視される語）"の下に、プルリクエストのタイトルに現れるかもしれない語のカンマ区切りのリストを入力してください。 スケジュールされたリマインダーは、それらの語をタイトルに1つ以上含むプルリクエストを含めなくなります。 ![無視される語のフィールド](/assets/images/help/settings/scheduled-reminders-ignored-terms-field.png)
\ No newline at end of file
+1. "Ignored terms（無視される語）"の下に、プルリクエストのタイトルに現れるかもしれない語のカンマ区切りのリストを入力してください。 スケジュールされたリマインダーは、それらの語をタイトルに1つ以上含むプルリクエストを含めなくなります。 ![無視される語のフィールド](/assets/images/help/settings/scheduled-reminders-ignored-terms-field.png)
diff --git a/translations/ja-JP/data/reusables/reminders/min-age.md b/translations/ja-JP/data/reusables/reminders/min-age.md
index 308553af54e3..4fe28aa8c131 100644
--- a/translations/ja-JP/data/reusables/reminders/min-age.md
+++ b/translations/ja-JP/data/reusables/reminders/min-age.md
@@ -1 +1 @@
-1. "Minimum age（最小の経過時間）"の下で、時間単位でプルリクエストの経過時間を入力してください。 スケジュールされたリマインダーは、この経過時間よりも新しいプルリクエストを含めなくなります。 ![無視されるラベルフィールド](/assets/images/help/settings/scheduled-reminders-min-age-field.png)
\ No newline at end of file
+1. "Minimum age（最小の経過時間）"の下で、時間単位でプルリクエストの経過時間を入力してください。 スケジュールされたリマインダーは、この経過時間よりも新しいプルリクエストを含めなくなります。 ![無視されるラベルフィールド](/assets/images/help/settings/scheduled-reminders-min-age-field.png)
diff --git a/translations/ja-JP/data/reusables/reminders/min-staleness.md b/translations/ja-JP/data/reusables/reminders/min-staleness.md
index 5590b8b83745..d2dfa8495df2 100644
--- a/translations/ja-JP/data/reusables/reminders/min-staleness.md
+++ b/translations/ja-JP/data/reusables/reminders/min-staleness.md
@@ -1 +1 @@
-1. "Minimum staleness（最小の停滞期間）"の下で、時間を単位としてプルリクエストに対する最後のアクティビティからの経過時間を入力してください。 スケジュールされたリマインダーは、最後のアクティビティがこの時間よりも新しいプルリクエストを含めません。 ![最小の停滞期間フィールド](/assets/images/help/settings/scheduled-reminders-min-staleness-field.png)
\ No newline at end of file
+1. "Minimum staleness（最小の停滞期間）"の下で、時間を単位としてプルリクエストに対する最後のアクティビティからの経過時間を入力してください。 スケジュールされたリマインダーは、最後のアクティビティがこの時間よりも新しいプルリクエストを含めません。 ![最小の停滞期間フィールド](/assets/images/help/settings/scheduled-reminders-min-staleness-field.png)
diff --git a/translations/ja-JP/data/reusables/reminders/real-time-alerts.md b/translations/ja-JP/data/reusables/reminders/real-time-alerts.md
index 0261430b55aa..710c52298a28 100644
--- a/translations/ja-JP/data/reusables/reminders/real-time-alerts.md
+++ b/translations/ja-JP/data/reusables/reminders/real-time-alerts.md
@@ -1 +1 @@
-1. あるいは、特定のイベントが生じたらすぐにSlackのメッセージを受けられるようにするには、**Enable real-time alerts（リアルタイムアラートの有効化）**を選択し、リアルタイムアラートを受信したいイベントを選択してください。
\ No newline at end of file
+1. あるいは、特定のイベントが生じたらすぐにSlackのメッセージを受けられるようにするには、**Enable real-time alerts（リアルタイムアラートの有効化）**を選択し、リアルタイムアラートを受信したいイベントを選択してください。
diff --git a/translations/ja-JP/data/reusables/reminders/required-labels.md b/translations/ja-JP/data/reusables/reminders/required-labels.md
index 9f5770c8c450..951c841b41f8 100644
--- a/translations/ja-JP/data/reusables/reminders/required-labels.md
+++ b/translations/ja-JP/data/reusables/reminders/required-labels.md
@@ -1 +1 @@
-1. "Required labels（必須のラベル）"の下で、カンマ区切りのラベルのリストを入力してください。 スケジュールされたリマインダーは、これらのラベルを1つ以上上含むプルリクエストで、すでに無視されてはいないものだけを含みます。 ![必須ラベルのフィールド](/assets/images/help/settings/scheduled-reminders-required-labels-field.png)
\ No newline at end of file
+1. "Required labels（必須のラベル）"の下で、カンマ区切りのラベルのリストを入力してください。 スケジュールされたリマインダーは、これらのラベルを1つ以上上含むプルリクエストで、すでに無視されてはいないものだけを含みます。 ![必須ラベルのフィールド](/assets/images/help/settings/scheduled-reminders-required-labels-field.png)
diff --git a/translations/ja-JP/data/reusables/repositories/about-github-archive-program.md b/translations/ja-JP/data/reusables/repositories/about-github-archive-program.md
index 1c80e08c35a2..435078c13ee3 100644
--- a/translations/ja-JP/data/reusables/repositories/about-github-archive-program.md
+++ b/translations/ja-JP/data/reusables/repositories/about-github-archive-program.md
@@ -1 +1 @@
-デフォルトでは、すべてのパブリックリポジトリは{% data variables.product.prodname_dotcom %}とSoftware Heritage FoundationやInternet Archiveといった組織との間の、世界中のオープンソースソフトウェアの長期的な保管を行うためのパートナーシップである{% data variables.product.prodname_archive %}に含まれます。
\ No newline at end of file
+デフォルトでは、すべてのパブリックリポジトリは{% data variables.product.prodname_dotcom %}とSoftware Heritage FoundationやInternet Archiveといった組織との間の、世界中のオープンソースソフトウェアの長期的な保管を行うためのパートナーシップである{% data variables.product.prodname_archive %}に含まれます。
diff --git a/translations/ja-JP/data/reusables/repositories/about-internal-repos.md b/translations/ja-JP/data/reusables/repositories/about-internal-repos.md
index 802988f18ab0..d921cfd13384 100644
--- a/translations/ja-JP/data/reusables/repositories/about-internal-repos.md
+++ b/translations/ja-JP/data/reusables/repositories/about-internal-repos.md
@@ -1 +1 @@
-インターナルリポジトリを使って、{% if currentVersion == "free-pro-team@latest" %}Enterpriseアカウント{% else %}インスタンス{% endif %}内での「インナーソース」を実践できます。 {% if currentVersion == "free-pro-team@latest" %}Enterpriseアカウント{% else %}インスタンス内の任意のOrganization{% endif %}のメンバーは、{% if currentVersion != "free-pro-team@latest" %}プライベートモードを無効化することもせず、{% endif %}プロプライエタリな情報をパブリックに共有することなく、オープンソースの方法論を用いてコラボレートできます。
+You can use internal repositories to practice "innersource" within your {% if currentVersion == "free-pro-team@latest" %}enterprise account{% else %}instance{% endif %}. Members of {% if currentVersion == "free-pro-team@latest" %}your enterprise account{% else %}any organization on your instance{% endif %} can collaborate using open source methodologies without sharing proprietary information publicly{% if currentVersion != "free-pro-team@latest" %}, even with private mode disabled{% endif %}.
diff --git a/translations/ja-JP/data/reusables/repositories/actions-workflow-status-badge-into.md b/translations/ja-JP/data/reusables/repositories/actions-workflow-status-badge-into.md
index 7ff3e53b97c5..c114fe9a367b 100644
--- a/translations/ja-JP/data/reusables/repositories/actions-workflow-status-badge-into.md
+++ b/translations/ja-JP/data/reusables/repositories/actions-workflow-status-badge-into.md
@@ -1,3 +1,3 @@
-ステータスバッジは、ワークフローが現在失敗しているかパスしているかを示します。 ステータスバッジを追加する一般的な場所は、リポジトリのREADME.mdファイル中ですが、任意の好きなWebページに追加できます。 By default, badges display the status of your default branch. 特定のブランチやイベントに対するワークフローの実行のステータスを、URL中の`branch`及び`event`クエリパラメータを使って表示することもできます。
+A status badge shows whether a workflow is currently failing or passing. ステータスバッジを追加する一般的な場所は、リポジトリのREADME.mdファイル中ですが、任意の好きなWebページに追加できます。 By default, badges display the status of your default branch. 特定のブランチやイベントに対するワークフローの実行のステータスを、URL中の`branch`及び`event`クエリパラメータを使って表示することもできます。
 
 ![example status badge](/assets/images/help/repository/actions-workflow-status-badge.png)
diff --git a/translations/ja-JP/data/reusables/repositories/blocked-passwords.md b/translations/ja-JP/data/reusables/repositories/blocked-passwords.md
index aeca0b625b0f..a4b1206ee7f2 100644
--- a/translations/ja-JP/data/reusables/repositories/blocked-passwords.md
+++ b/translations/ja-JP/data/reusables/repositories/blocked-passwords.md
@@ -1,5 +1,6 @@
 {% if currentVersion == "free-pro-team@latest" %}
-サインイン、アカウントの作成、パスワードの変更の際にパスワードを入力すると、{% data variables.product.product_name %}は入力されたパスワードがHaveIBeenPwnedのようなデータセットに照らして弱いと考えられるかをチェックします。 以前にまったく使ったことがないパスワードでも、弱いと判定されることがあります。
+When you type a password to sign in, create an account, or change your password,
+{% data variables.product.product_name %} will check if the password you entered is considered weak according to datasets like HaveIBeenPwned. 以前にまったく使ったことがないパスワードでも、弱いと判定されることがあります。
 
 {% data variables.product.product_name %}がパスワードを検査するのは入力の際だけであり、入力されたパスワードが平文で保存されることはありません。 詳しい情報については[ HaveIBeenPwned](https://haveibeenpwned.com/)を参照してください。
 {% endif %}
diff --git a/translations/ja-JP/data/reusables/repositories/copy-clone-url.md b/translations/ja-JP/data/reusables/repositories/copy-clone-url.md
index 29919cef060d..f397023830c2 100644
--- a/translations/ja-JP/data/reusables/repositories/copy-clone-url.md
+++ b/translations/ja-JP/data/reusables/repositories/copy-clone-url.md
@@ -2,13 +2,13 @@
 1. リポジトリ名の下で**Clone or download（クローンもしくはダウンロード）**をクリックしてください。 ![Clone or downloadボタン](/assets/images/help/repository/clone-repo-clone-url-button.png)
 2. To clone the repository using HTTPS, under "Clone with HTTPS", click
 {% octicon "clippy" aria-label="The clipboard icon" %}.
-To clone the repository using an SSH key
-{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, including a certificate issued by your organization's SSH certificate authority,{% endif %} click **Use SSH**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.
+To clone the repository using an SSH key, including a certificate issued by your organization's SSH certificate authority, click **Use SSH**, then click
+{% octicon "clippy" aria-label="The clipboard icon" %}.
 ![クローンURLボタン](/assets/images/help/repository/https-url-clone.png)
 {% else %}
 1. Above the list of files, click {% octicon "download" aria-label="The download icon" %} **Code**. !["Code" button](/assets/images/help/repository/code-button.png)
 1. To clone the repository using HTTPS, under "Clone with HTTPS", click
-{% octicon "clippy" aria-label="The clipboard icon" %}. To clone the repository using an SSH key{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, including a certificate issued by your organization's SSH certificate authority,{% endif %} click **Use SSH**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} To clone a repository using {% data variables.product.prodname_cli %}, click **Use {% data variables.product.prodname_cli %}**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.{% endif %}
+{% octicon "clippy" aria-label="The clipboard icon" %}. To clone the repository using an SSH key, including a certificate issued by your organization's SSH certificate authority, click **Use SSH**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} To clone a repository using {% data variables.product.prodname_cli %}, click **Use {% data variables.product.prodname_cli %}**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.{% endif %}
   ![The clipboard icon for copying the URL to clone a repository](/assets/images/help/repository/https-url-clone.png)
   {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}
   ![The clipboard icon for copying the URL to clone a repository with GitHub CLI](/assets/images/help/repository/https-url-clone-cli.png){% endif %}
diff --git a/translations/ja-JP/data/reusables/repositories/default-issue-templates.md b/translations/ja-JP/data/reusables/repositories/default-issue-templates.md
index 7856df127a86..72eb6b51d400 100644
--- a/translations/ja-JP/data/reusables/repositories/default-issue-templates.md
+++ b/translations/ja-JP/data/reusables/repositories/default-issue-templates.md
@@ -1,2 +1,2 @@
-デフォルトのIssueテンプレート{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}とIssueテンプレートのためのデフォルトの設定ファイル{% endif %}を、Organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}もしくはユーザアカウント{% endif %}用に作成できます。 詳しい情報については「[デフォルトのコミュニティ健全性ファイルを作成する](/github/building-a-strong-community/creating-a-default-community-health-file)」を参照してください。
+You can create default issue templates{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and a default configuration file for issue templates{% endif %} for your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %}. 詳しい情報については「[デフォルトのコミュニティ健全性ファイルを作成する](/github/building-a-strong-community/creating-a-default-community-health-file)」を参照してください。
 
diff --git a/translations/ja-JP/data/reusables/repositories/deleted_forks_from_private_repositories_warning.md b/translations/ja-JP/data/reusables/repositories/deleted_forks_from_private_repositories_warning.md
index afb2f89162f4..84f425d31969 100644
--- a/translations/ja-JP/data/reusables/repositories/deleted_forks_from_private_repositories_warning.md
+++ b/translations/ja-JP/data/reusables/repositories/deleted_forks_from_private_repositories_warning.md
@@ -2,10 +2,10 @@
 
 **警告:**
 
-- プライベートリポジトリへの個人のアクセス権を削除すると、そのプライベートリポジトリからその人が作成したフォークはすべて削除されます。 プライベートリポジトリのローカルクローンは残ります。 プライベートリポジトリへのTeamのアクセス権が削除されたり、プライベートリポジトリへのアクセス権を持つTeamが削除された場合、Teamのメンバーが他のTeamを通じてそのリポジトリへのアクセス権を持っていなければ、そのリポジトリのプライベートフォークは削除されます。{% if currentVersion != "free-pro-team@latest" %}
-- [LDAP Syncが有効化されている](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap/#enabling-ldap-sync)場合、リポジトリから個人を削除すると、その人はアクセス権を失いますが、その人のフォークは削除されません。 元々のOrganizationのリポジトリへのアクセスできるように3ヶ月以内にその人がTeamに追加されたなら、次回の同期の際にフォークへのアクセスは自動的に回復されます。{% endif %}
+- プライベートリポジトリへの個人のアクセス権を削除すると、そのプライベートリポジトリからその人が作成したフォークはすべて削除されます。 プライベートリポジトリのローカルクローンは残ります。 If a team's access to a private repository is revoked or a team with access to a private repository is deleted, and team members do not have access to the repository through another team, private forks of the repository will be deleted.{% if currentVersion != "free-pro-team@latest" %}
+- [LDAP Syncが有効化されている](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap/#enabling-ldap-sync)場合、リポジトリから個人を削除すると、その人はアクセス権を失いますが、その人のフォークは削除されません。 元々のOrganizationのリポジトリへのアクセスできるように3ヶ月以内にその人がTeamに追加されたなら、次回の同期の際にフォークへのアクセスは自動的に回復されます。{% endif %}
 - リポジトリへのアクセスを失った個人に、機密情報や知的財産を確実に削除してもらうのは、あなたの責任です。
 
-- プライベート{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}あるいはインターナル{% endif %}リポジトリに対する管理権限を持つ人は、そのリポジトリのフォークを禁止でき、OrganizationのオーナーはOrganization内のプライベート{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}あるいはインターナル{% endif %}リポジトリのフォークを禁止できます。 詳しい情報については「[Organizationのためのフォークのポリシーの管理](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization)」及び「[リポジトリのフォークのポリシーの管理](/github/administering-a-repository/managing-the-forking-policy-for-your-repository)」を参照してください。
+- People with admin permissions to a private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %} repository can disallow forking of that repository, and organization owners can disallow forking of any private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %} repository in an organization. 詳しい情報については「[Organizationのためのフォークのポリシーの管理](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization)」及び「[リポジトリのフォークのポリシーの管理](/github/administering-a-repository/managing-the-forking-policy-for-your-repository)」を参照してください。
 
 {% endwarning %}
diff --git a/translations/ja-JP/data/reusables/repositories/enable-security-alerts.md b/translations/ja-JP/data/reusables/repositories/enable-security-alerts.md
index 09a47180e14b..4ab63edcb311 100644
--- a/translations/ja-JP/data/reusables/repositories/enable-security-alerts.md
+++ b/translations/ja-JP/data/reusables/repositories/enable-security-alerts.md
@@ -1,4 +1,4 @@
 {% if currentVersion != "free-pro-team@latest" %}
 Your site administrator must enable
-この機能を使えるようにするには、サイト管理者は{% data variables.product.product_location_enterprise %}の脆弱性のある依存関係に対するセキュリティアラートを有効化しなければなりません。 詳しい情報については「[{% data variables.product.prodname_ghe_server %}の脆弱性のある依存関係に関するセキュリティアラートの有効化](/enterprise/{{ currentVersion }}/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server)」を参照してください。
+{% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies for {% data variables.product.product_location_enterprise %} before you can use this feature. For more information, see "[Enabling alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server)."
 {% endif %}
diff --git a/translations/ja-JP/data/reusables/repositories/navigate-to-job-superlinter.md b/translations/ja-JP/data/reusables/repositories/navigate-to-job-superlinter.md
new file mode 100644
index 000000000000..ff66205b87cb
--- /dev/null
+++ b/translations/ja-JP/data/reusables/repositories/navigate-to-job-superlinter.md
@@ -0,0 +1,5 @@
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+1. 左のサイドバーで、表示させたいジョブをクリックしてください。 ![Lint code base job](/assets/images/help/repository/superlinter-lint-code-base-job.png)
+{% else %}
+1. 左のサイドバーで、表示させたいジョブをクリックしてください。 ![Select a workflow job](/assets/images/help/repository/workflow-job.png)
+{% endif %}
\ No newline at end of file
diff --git a/translations/ja-JP/data/reusables/repositories/navigate-to-workflow-superlinter.md b/translations/ja-JP/data/reusables/repositories/navigate-to-workflow-superlinter.md
new file mode 100644
index 000000000000..a9009b07b969
--- /dev/null
+++ b/translations/ja-JP/data/reusables/repositories/navigate-to-workflow-superlinter.md
@@ -0,0 +1 @@
+1. 左のサイドバーで、表示させたいワークフローをクリックしてください。 ![左サイドバーのワークフローのリスト](/assets/images/help/repository/superlinter-workflow-sidebar.png)
\ No newline at end of file
diff --git a/translations/ja-JP/data/reusables/repositories/open-with-github-desktop.md b/translations/ja-JP/data/reusables/repositories/open-with-github-desktop.md
index 308dd2c554f5..7f9439758280 100644
--- a/translations/ja-JP/data/reusables/repositories/open-with-github-desktop.md
+++ b/translations/ja-JP/data/reusables/repositories/open-with-github-desktop.md
@@ -1,9 +1,11 @@
 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %}
 1. リポジトリ名の下にある**Clone or download**をクリックします。 ![Clone or downloadボタン](/assets/images/help/repository/clone-repo-clone-url-button.png)
-1. リポジトリをクローンして、{% data variables.product.prodname_desktop %}で開くには、**Open in Desktop**をクリックします。 ![Open in Desktopボタン](/assets/images/help/desktop/open-in-desktop-button.png)
+1. Click **Open in Desktop** to clone the repository and open it in
+{% data variables.product.prodname_desktop %}.
+![Open in Desktopボタン](/assets/images/help/desktop/open-in-desktop-button.png)
 {% else %}
 1. Above the list of files, click {% octicon "download" aria-label="The download icon" %} **Code**. !["Code" button](/assets/images/help/repository/code-button.png)
-1. Click
+1. 下向きの三角形アイコン
 {% octicon "desktop-download" aria-label="The GitHub Desktop download icon" %} **Open with {% data variables.product.prodname_desktop %}** to clone and open the repository with {% data variables.product.prodname_desktop %}.
   !["Open with {% data variables.product.prodname_desktop %}" button](/assets/images/help/repository/open-with-desktop.png)
 {% endif %}
diff --git a/translations/ja-JP/data/reusables/repositories/permissions-statement-read.md b/translations/ja-JP/data/reusables/repositories/permissions-statement-read.md
index 4321513e3471..241fdd2ba86a 100644
--- a/translations/ja-JP/data/reusables/repositories/permissions-statement-read.md
+++ b/translations/ja-JP/data/reusables/repositories/permissions-statement-read.md
@@ -1 +1 @@
-リポジトリの読み取りアクセス権を持つ人は、以下のステップを実行できます。
\ No newline at end of file
+Read access to the repository is required to perform these steps.
diff --git a/translations/ja-JP/data/reusables/repositories/permissions-statement-write.md b/translations/ja-JP/data/reusables/repositories/permissions-statement-write.md
index ef33fc4c5935..457fe0472478 100644
--- a/translations/ja-JP/data/reusables/repositories/permissions-statement-write.md
+++ b/translations/ja-JP/data/reusables/repositories/permissions-statement-write.md
@@ -1 +1 @@
-リポジトリへの書き込みレベルのアクセス権を持つ人は、以下のステップを実行できます。
\ No newline at end of file
+Write access to the repository is required to perform these steps.
diff --git a/translations/ja-JP/data/reusables/repositories/security-alert-delivery-options.md b/translations/ja-JP/data/reusables/repositories/security-alert-delivery-options.md
index aba39f1ad008..c6b1684bda44 100644
--- a/translations/ja-JP/data/reusables/repositories/security-alert-delivery-options.md
+++ b/translations/ja-JP/data/reusables/repositories/security-alert-delivery-options.md
@@ -1 +1 @@
-リポジトリにサポートされている依存関係のマニフェストがあるなら{% if currentVersion == "free-pro-team@latest" %}（そしてプライベートリポジトリの場合は依存関係のグラフをセットアップしてあるなら）{% endif %}、{% data variables.product.product_name %}がリポジトリ中に脆弱性のある依存関係を検出すると、週次のダイジェストメールを受け取ることになります。 セキュリティアラートは、Web通知、個別のメール通知、日次のメールダイジェスト、{% data variables.product.product_name %}インターフェース上のアラートとして設定することもできます。 詳しい情報については、「[脆弱性のある依存関係に対するアラートについて](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)」を参照してください。
+If your repository has a supported dependency manifest{% if currentVersion == "free-pro-team@latest" %} (and if you've set up the dependency graph if it's a private repository){% endif %}, whenever {% data variables.product.product_name %} detects a vulnerable dependency in your repository, you will receive a weekly digest email. セキュリティアラートは、Web通知、個別のメール通知、日次のメールダイジェスト、{% data variables.product.product_name %}インターフェース上のアラートとして設定することもできます。 詳しい情報については、「[脆弱性のある依存関係に対するアラートについて](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)」を参照してください。
diff --git a/translations/ja-JP/data/reusables/repositories/security-alerts-x-github-severity.md b/translations/ja-JP/data/reusables/repositories/security-alerts-x-github-severity.md
index 8b4e13244cb5..7230ee99948a 100644
--- a/translations/ja-JP/data/reusables/repositories/security-alerts-x-github-severity.md
+++ b/translations/ja-JP/data/reusables/repositories/security-alerts-x-github-severity.md
@@ -1 +1 @@
-Email notifications for {% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} that affect one or more repositories include the `X-GitHub-Severity`  header field. You can use the value of the `X-GitHub-Severity` header field to filter email notifications for {% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %}.
\ No newline at end of file
+Email notifications for {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} that affect one or more repositories include the `X-GitHub-Severity`  header field. You can use the value of the `X-GitHub-Severity` header field to filter email notifications for {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %}.
diff --git a/translations/ja-JP/data/reusables/repositories/select-marketplace-apps.md b/translations/ja-JP/data/reusables/repositories/select-marketplace-apps.md
index 06d9740c6513..2a403e814c4f 100644
--- a/translations/ja-JP/data/reusables/repositories/select-marketplace-apps.md
+++ b/translations/ja-JP/data/reusables/repositories/select-marketplace-apps.md
@@ -1,3 +1,5 @@
 {% if currentVersion == "free-pro-team@latest" %}
-1. 作成をしている個人アカウントもしくはOrganizationが{% data variables.product.prodname_marketplace %}の{% data variables.product.prodname_github_app %}を使っているなら、リポジトリ中で使いたいアプリケーションを選択することもできます。 ![{% data variables.product.prodname_marketplace %} から取得したアカウントの {% data variables.product.prodname_github_app %} のリストと、アクセスを許可するオプション](/assets/images/help/repository/create-repository-choose-marketplace-apps.png)
+1. Optionally, if the personal account or organization in which you're creating uses any
+{% data variables.product.prodname_github_app %}s from {% data variables.product.prodname_marketplace %}, select any apps you'd like to use in the repository.
+  ![{% data variables.product.prodname_marketplace %} から取得したアカウントの {% data variables.product.prodname_github_app %} のリストと、アクセスを許可するオプション](/assets/images/help/repository/create-repository-choose-marketplace-apps.png)
 {% endif %}
diff --git a/translations/ja-JP/data/reusables/repositories/sidebar-dependabot-alerts.md b/translations/ja-JP/data/reusables/repositories/sidebar-dependabot-alerts.md
index 74585315b209..b7eadd335c26 100644
--- a/translations/ja-JP/data/reusables/repositories/sidebar-dependabot-alerts.md
+++ b/translations/ja-JP/data/reusables/repositories/sidebar-dependabot-alerts.md
@@ -1 +1 @@
-1. In the security sidebar, click **{% data variables.product.prodname_dependabot_short %} alerts**. ![{% data variables.product.prodname_dependabot_short %} alerts tab](/assets/images/help/repository/dependabot-alerts-tab.png)
\ No newline at end of file
+1. In the security sidebar, click **{% data variables.product.prodname_dependabot_short %} alerts**. ![{% data variables.product.prodname_dependabot_short %} alerts tab](/assets/images/help/repository/dependabot-alerts-tab.png)
diff --git a/translations/ja-JP/data/reusables/repositories/squash-and-rebase-linear-commit-hisitory.md b/translations/ja-JP/data/reusables/repositories/squash-and-rebase-linear-commit-hisitory.md
index 2c7b231e6dc8..927bd5a7fb6b 100644
--- a/translations/ja-JP/data/reusables/repositories/squash-and-rebase-linear-commit-hisitory.md
+++ b/translations/ja-JP/data/reusables/repositories/squash-and-rebase-linear-commit-hisitory.md
@@ -1 +1 @@
-{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}直線状のコミット履歴を必要とする保護されたブランチのルールがリポジトリ中にあるなら、squashマージ、リベースマージ、あるいはその両方を許可しなければなりません。 詳しい情報については「[直線状のコミット履歴を必須とする](/github/administering-a-repository/requiring-a-linear-commit-history)」を参照してください。{% endif %}
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}If there is a protected branch rule in your repository that requires a linear commit history, you must allow squash merging, rebase merging, or both. 詳しい情報については「[直線状のコミット履歴を必須とする](/github/administering-a-repository/requiring-a-linear-commit-history)」を参照してください。{% endif %}
diff --git a/translations/ja-JP/data/reusables/repositories/start-line-comment.md b/translations/ja-JP/data/reusables/repositories/start-line-comment.md
index 2742048b4d13..d0dfa4717b36 100644
--- a/translations/ja-JP/data/reusables/repositories/start-line-comment.md
+++ b/translations/ja-JP/data/reusables/repositories/start-line-comment.md
@@ -1 +1 @@
-1. コメントを追加したいコードの行の上にカーソルを移動し、青いコメントアイコンをクリックしてください。{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}複数行にコメントを追加するには、クリックしてからドラッグで行の範囲を選択し、続いて青いコメントアイコンをクリックしてください。{% endif %} ![青いコメントアイコン](/assets/images/help/commits/hover-comment-icon.gif)
+1. Hover over the line of code where you'd like to add a comment, and click the blue comment icon.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} To add a comment on multiple lines, click and drag to select the range of lines, then click the blue comment icon.{% endif %} ![青いコメントアイコン](/assets/images/help/commits/hover-comment-icon.gif)
diff --git a/translations/ja-JP/data/reusables/repositories/suggest-changes.md b/translations/ja-JP/data/reusables/repositories/suggest-changes.md
index 8346b7deae3e..4e6511c193b3 100644
--- a/translations/ja-JP/data/reusables/repositories/suggest-changes.md
+++ b/translations/ja-JP/data/reusables/repositories/suggest-changes.md
@@ -1 +1 @@
-1. あるいは、特定の変更を行{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}あるいは複数行{% endif %}に対して示唆するには、{% octicon "diff" aria-label="The diff symbol" %}をクリックし、示唆するブロック内のテキストを編集してください。 ![サジェッションブロック](/assets/images/help/pull_requests/suggestion-block.png)
+1. Optionally, to suggest a specific change to the line{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} or lines{% endif %}, click {% octicon "diff" aria-label="The diff symbol" %}, then edit the text within the suggestion block. ![サジェッションブロック](/assets/images/help/pull_requests/suggestion-block.png)
diff --git a/translations/ja-JP/data/reusables/repositories/view-failed-job-results-superlinter.md b/translations/ja-JP/data/reusables/repositories/view-failed-job-results-superlinter.md
new file mode 100644
index 000000000000..434994a1691a
--- /dev/null
+++ b/translations/ja-JP/data/reusables/repositories/view-failed-job-results-superlinter.md
@@ -0,0 +1,5 @@
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+1. Any failed steps are automatically expanded to display the results. ![Super linter workflow results](/assets/images/help/repository/super-linter-workflow-results-updated.png)
+{% else %}
+1. Expand the **Run Super-Linter** step to view the results. ![Super linter workflow results](/assets/images/help/repository/super-linter-workflow-results.png)
+{% endif %}
\ No newline at end of file
diff --git a/translations/ja-JP/data/reusables/repositories/view-run-superlinter.md b/translations/ja-JP/data/reusables/repositories/view-run-superlinter.md
new file mode 100644
index 000000000000..8725b33e6cc0
--- /dev/null
+++ b/translations/ja-JP/data/reusables/repositories/view-run-superlinter.md
@@ -0,0 +1 @@
+1. From the list of workflow runs, click the name of the run you want to see. ![ワークフローの実行の名前](/assets/images/help/repository/superlinter-run-name.png)
\ No newline at end of file
diff --git a/translations/ja-JP/data/reusables/repositories/view-run.md b/translations/ja-JP/data/reusables/repositories/view-run.md
index ac0e55b4464a..a508293d6109 100644
--- a/translations/ja-JP/data/reusables/repositories/view-run.md
+++ b/translations/ja-JP/data/reusables/repositories/view-run.md
@@ -1 +1 @@
-1. "Workflow runs（ワークフローの実行）"の下で、表示させたい実行の名前をクリックしてください。 ![ワークフローの実行の名前](/assets/images/help/repository/run-name.png)
+1. From the list of workflow runs, click the name of the run you want to see. ![ワークフローの実行の名前](/assets/images/help/repository/run-name.png)
diff --git a/translations/ja-JP/data/reusables/repositories/view-specific-line-superlinter.md b/translations/ja-JP/data/reusables/repositories/view-specific-line-superlinter.md
new file mode 100644
index 000000000000..88413fba194b
--- /dev/null
+++ b/translations/ja-JP/data/reusables/repositories/view-specific-line-superlinter.md
@@ -0,0 +1,5 @@
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+1. あるいはログの中の特定の行へのリンクを取得するには、そのステップの行番号をクリックします。 You can then copy the link from the address bar of your web browser. ![リンクをコピーするボタン](/assets/images/help/repository/copy-link-button-updated.png)
+{% else %}
+1. あるいはログの中の特定の行へのリンクを取得するには、そのステップの行番号をクリックします。 You can then copy the link from the address bar of your web browser. ![リンクをコピーするボタン](/assets/images/help/repository/copy-link-button.png)
+{% endif %}
\ No newline at end of file
diff --git a/translations/ja-JP/data/reusables/repositories/you-can-fork.md b/translations/ja-JP/data/reusables/repositories/you-can-fork.md
index e030e01062b7..2d290ce6cde4 100644
--- a/translations/ja-JP/data/reusables/repositories/you-can-fork.md
+++ b/translations/ja-JP/data/reusables/repositories/you-can-fork.md
@@ -1,3 +1,3 @@
-任意のパブリックなリポジトリを、自分のユーザアカウントあるいはリポジトリの作成権限を持っている任意のOrganization にフォークできます。 詳細は「[Organization の権限レベル](/articles/permission-levels-for-an-organization)」を参照してください。
+You can fork any public repository to your user account or any organization where you have repository creation permissions. For more information, see "[Permission levels for an organization](/articles/permission-levels-for-an-organization)."
 
-アクセス権を持っている任意のプライベートリポジトリを、自分のユーザアカウント及びリポジトリの作成権限を持っている{% data variables.product.prodname_team %}もしくは{% data variables.product.prodname_enterprise %}上の任意のOrganizationにフォークできます。 {% data variables.product.prodname_free_team %}を使っているOrganizationには、プライベートリポジトリをフォークすることはできません。{% if currentVersion == "free-pro-team@latest" %}詳しい情報については「[GitHubの製品](/articles/githubs-products)」を参照してください。{% endif %}
+You can fork any private repository you can access to your user account and any organization on {% data variables.product.prodname_team %} or {% data variables.product.prodname_enterprise %} where you have repository creation permissions. You cannot fork a private repository to an organization using {% data variables.product.prodname_free_team %}.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[GitHub's products](/articles/githubs-products)."{% endif %}
diff --git a/translations/ja-JP/data/reusables/saml/add-okta-application.md b/translations/ja-JP/data/reusables/saml/add-okta-application.md
index 0d5f02007f95..68716ef7d031 100644
--- a/translations/ja-JP/data/reusables/saml/add-okta-application.md
+++ b/translations/ja-JP/data/reusables/saml/add-okta-application.md
@@ -1 +1 @@
-2. [**Add application**] をクリックします。 ![Okta ダッシュボードの [Applications] タブにある [Add application] ボタン](/assets/images/help/saml/okta-add-application.png)
\ No newline at end of file
+2. [**Add application**] をクリックします。 ![Okta ダッシュボードの [Applications] タブにある [Add application] ボタン](/assets/images/help/saml/okta-add-application.png)
diff --git a/translations/ja-JP/data/reusables/saml/assign-yourself-to-okta.md b/translations/ja-JP/data/reusables/saml/assign-yourself-to-okta.md
index 7b2fd7293434..42cb7d475a97 100644
--- a/translations/ja-JP/data/reusables/saml/assign-yourself-to-okta.md
+++ b/translations/ja-JP/data/reusables/saml/assign-yourself-to-okta.md
@@ -1 +1 @@
-1. Assign the application to your user in Okta. For more information, see [Assign applications to users](https://help.okta.com/en/prod/Content/Topics/users-groups-profiles/usgp-assign-apps.htm) in the Okta documentation.
\ No newline at end of file
+1. Assign the application to your user in Okta. For more information, see [Assign applications to users](https://help.okta.com/en/prod/Content/Topics/users-groups-profiles/usgp-assign-apps.htm) in the Okta documentation.
diff --git a/translations/ja-JP/data/reusables/saml/click-enterprise-account-application.md b/translations/ja-JP/data/reusables/saml/click-enterprise-account-application.md
index e5d172dcb9e5..3f8b0dcf579a 100644
--- a/translations/ja-JP/data/reusables/saml/click-enterprise-account-application.md
+++ b/translations/ja-JP/data/reusables/saml/click-enterprise-account-application.md
@@ -1 +1 @@
-1. Click the label for the application you created for your enterprise account.
\ No newline at end of file
+1. Click the label for the application you created for your enterprise account.
diff --git a/translations/ja-JP/data/reusables/saml/okta-admin-button.md b/translations/ja-JP/data/reusables/saml/okta-admin-button.md
index b1f3d74979cc..ffc7938d2dde 100644
--- a/translations/ja-JP/data/reusables/saml/okta-admin-button.md
+++ b/translations/ja-JP/data/reusables/saml/okta-admin-button.md
@@ -1 +1 @@
-1. In Okta, in the upper-right corner, click **Admin**. ![Admin button in Okta](/assets/images/help/saml/okta-admin-button.png)
\ No newline at end of file
+1. In Okta, in the upper-right corner, click **Admin**. ![Admin button in Okta](/assets/images/help/saml/okta-admin-button.png)
diff --git a/translations/ja-JP/data/reusables/saml/okta-configure-api-integration.md b/translations/ja-JP/data/reusables/saml/okta-configure-api-integration.md
index 3ca16b2eb8a5..6d9ac3bbd325 100644
--- a/translations/ja-JP/data/reusables/saml/okta-configure-api-integration.md
+++ b/translations/ja-JP/data/reusables/saml/okta-configure-api-integration.md
@@ -1 +1 @@
-1. [**Configure API Integration**] をクリックします。 ![Okta アプリケーションの [Configure API Integration] ボタン](/assets/images/help/saml/okta-configure-api-integration.png)
\ No newline at end of file
+1. [**Configure API Integration**] をクリックします。 ![Okta アプリケーションの [Configure API Integration] ボタン](/assets/images/help/saml/okta-configure-api-integration.png)
diff --git a/translations/ja-JP/data/reusables/saml/okta-edit-provisioning.md b/translations/ja-JP/data/reusables/saml/okta-edit-provisioning.md
index 83631fe8f27a..22742720b910 100644
--- a/translations/ja-JP/data/reusables/saml/okta-edit-provisioning.md
+++ b/translations/ja-JP/data/reusables/saml/okta-edit-provisioning.md
@@ -2,4 +2,4 @@
 11. [Create Users] の右にある [**Enable**] を選択します。 ![Okta アプリケーションの [Create Users] オプションの [Enable] チェックボックス](/assets/images/help/saml/okta-provisioning-enable-create-users.png)
 12. [Update User Attributes] の右にある [**Enable**] を選択します。 ![Okta アプリケーションの [Update User Attributes] オプションの [Enable] チェックボックス](/assets/images/help/saml/okta-provisioning-enable-update-user-attributes.png)
 13. [Deactivate Users] の右にある [**Enable**] を選択します。 ![Okta アプリケーションの [Deactivate Users] オプションの [Enable] チェックボックス](/assets/images/help/saml/okta-provisioning-enable-deactivate-users.png)
-14. [**Save**] をクリックします。 ![Okta アプリケーションのプロビジョニング設定に使用する [Save] ボタン](/assets/images/help/saml/okta-provisioning-save.png)
\ No newline at end of file
+14. [**Save**] をクリックします。 ![Okta アプリケーションのプロビジョニング設定に使用する [Save] ボタン](/assets/images/help/saml/okta-provisioning-save.png)
diff --git a/translations/ja-JP/data/reusables/saml/okta-enable-api-integration.md b/translations/ja-JP/data/reusables/saml/okta-enable-api-integration.md
index 5792618e08d6..3ab280ac66b8 100644
--- a/translations/ja-JP/data/reusables/saml/okta-enable-api-integration.md
+++ b/translations/ja-JP/data/reusables/saml/okta-enable-api-integration.md
@@ -1 +1 @@
-1. [**Enable API integration**] を選択します。 ![Okta アプリケーションの [Enable API integration] チェックボックス](/assets/images/help/saml/okta-enable-api-integration.png)
\ No newline at end of file
+1. [**Enable API integration**] を選択します。 ![Okta アプリケーションの [Enable API integration] チェックボックス](/assets/images/help/saml/okta-enable-api-integration.png)
diff --git a/translations/ja-JP/data/reusables/saml/okta-provisioning-tab.md b/translations/ja-JP/data/reusables/saml/okta-provisioning-tab.md
index 5d9de5ff47a2..3b44550fd459 100644
--- a/translations/ja-JP/data/reusables/saml/okta-provisioning-tab.md
+++ b/translations/ja-JP/data/reusables/saml/okta-provisioning-tab.md
@@ -1 +1 @@
-1. Under the name of the application, click **Provisioning**. ![Okta アプリケーションの [Provisioning] タブ](/assets/images/help/saml/okta-provisioning-tab.png)
\ No newline at end of file
+1. Under the name of the application, click **Provisioning**. ![Okta アプリケーションの [Provisioning] タブ](/assets/images/help/saml/okta-provisioning-tab.png)
diff --git a/translations/ja-JP/data/reusables/saml/okta-save-provisioning.md b/translations/ja-JP/data/reusables/saml/okta-save-provisioning.md
index 563c6c9da0cf..a8dda7d712e2 100644
--- a/translations/ja-JP/data/reusables/saml/okta-save-provisioning.md
+++ b/translations/ja-JP/data/reusables/saml/okta-save-provisioning.md
@@ -1 +1 @@
-1. [**Save**] をクリックします。 ![Okta アプリケーションのプロビジョニング設定に使用する [Save] ボタン](/assets/images/help/saml/okta-provisioning-tab-save.png)
\ No newline at end of file
+1. [**Save**] をクリックします。 ![Okta アプリケーションのプロビジョニング設定に使用する [Save] ボタン](/assets/images/help/saml/okta-provisioning-tab-save.png)
diff --git a/translations/ja-JP/data/reusables/saml/okta-sign-on-tab.md b/translations/ja-JP/data/reusables/saml/okta-sign-on-tab.md
index 5b37159afb8b..535bceec2f38 100644
--- a/translations/ja-JP/data/reusables/saml/okta-sign-on-tab.md
+++ b/translations/ja-JP/data/reusables/saml/okta-sign-on-tab.md
@@ -1 +1 @@
-1. Under the name of the application, click **Sign on**. ![Okta アプリケーションの [Sign on] タブ](/assets/images/help/saml/okta-sign-on-tab.png)
\ No newline at end of file
+1. Under the name of the application, click **Sign on**. ![Okta アプリケーションの [Sign on] タブ](/assets/images/help/saml/okta-sign-on-tab.png)
diff --git a/translations/ja-JP/data/reusables/saml/okta-view-setup-instructions.md b/translations/ja-JP/data/reusables/saml/okta-view-setup-instructions.md
index 2912ac45a9fe..41caa8618f21 100644
--- a/translations/ja-JP/data/reusables/saml/okta-view-setup-instructions.md
+++ b/translations/ja-JP/data/reusables/saml/okta-view-setup-instructions.md
@@ -1 +1 @@
-1. [SIGN ON METHODS] で、[**View Setup Instructions**] をクリックします。 ![Okta アプリケーションの [Sign On] タブにある [View Setup Instructions] ボタン](/assets/images/help/saml/okta-view-setup-instructions.png)
\ No newline at end of file
+1. [SIGN ON METHODS] で、[**View Setup Instructions**] をクリックします。 ![Okta アプリケーションの [Sign On] タブにある [View Setup Instructions] ボタン](/assets/images/help/saml/okta-view-setup-instructions.png)
diff --git a/translations/ja-JP/data/reusables/saml/search-ghec-okta.md b/translations/ja-JP/data/reusables/saml/search-ghec-okta.md
index e85342e57674..e5a921dee1c7 100644
--- a/translations/ja-JP/data/reusables/saml/search-ghec-okta.md
+++ b/translations/ja-JP/data/reusables/saml/search-ghec-okta.md
@@ -1 +1 @@
-3. 検索フィールドに "GitHub Enterprise Cloud" と入力します。 ![Okta の [Search for an application] フィールド](/assets/images/help/saml/okta-search-for-an-application.png)
\ No newline at end of file
+3. 検索フィールドに "GitHub Enterprise Cloud" と入力します。 ![Okta の [Search for an application] フィールド](/assets/images/help/saml/okta-search-for-an-application.png)
diff --git a/translations/ja-JP/data/reusables/saml/use-classic-ui.md b/translations/ja-JP/data/reusables/saml/use-classic-ui.md
index 216ada38086b..f424386af0ce 100644
--- a/translations/ja-JP/data/reusables/saml/use-classic-ui.md
+++ b/translations/ja-JP/data/reusables/saml/use-classic-ui.md
@@ -1,3 +1,3 @@
 You must use the "Classic UI" in Okta. 詳しい情報については、Okta のブログで「[Organized Navigation](https://developer.okta.com/blog/2017/09/25/all-new-developer-console#new-look--feel)」を参照してください。
 
-![ダッシュボードの上にある Okta の UI 選択機能で [Classic UI] を選択](/assets/images/help/saml/okta-classic-ui.png)
\ No newline at end of file
+![ダッシュボードの上にある Okta の UI 選択機能で [Classic UI] を選択](/assets/images/help/saml/okta-classic-ui.png)
diff --git a/translations/ja-JP/data/reusables/scim/enterprise-account-scim.md b/translations/ja-JP/data/reusables/scim/enterprise-account-scim.md
index 41d1a43470e4..1797863354c2 100644
--- a/translations/ja-JP/data/reusables/scim/enterprise-account-scim.md
+++ b/translations/ja-JP/data/reusables/scim/enterprise-account-scim.md
@@ -1 +1 @@
-If you're participating in the private beta for user provisioning for enterprise accounts, when you enable SAML for your enterprise account, SCIM provisioning and deprovisioning is enabled by default in {% data variables.product.product_name %}. You can use provisioning to manage organization membership by configuring SCIM in your IdP.
\ No newline at end of file
+If you're participating in the private beta for user provisioning for enterprise accounts, when you enable SAML for your enterprise account, SCIM provisioning and deprovisioning is enabled by default in {% data variables.product.product_name %}. You can use provisioning to manage organization membership by configuring SCIM in your IdP.
diff --git a/translations/ja-JP/data/reusables/search/syntax_tips.md b/translations/ja-JP/data/reusables/search/syntax_tips.md
index 9da0b487b2de..7526b8dc6904 100644
--- a/translations/ja-JP/data/reusables/search/syntax_tips.md
+++ b/translations/ja-JP/data/reusables/search/syntax_tips.md
@@ -1,6 +1,6 @@
 {% tip %}
 
-**参考:**{% if currentVersion != "free-pro-team@latest" %}
+**Tips:**{% if currentVersion != "free-pro-team@latest" %}
   - この記事には、{% data variables.product.prodname_dotcom %}.com のウェブサイトでの検索例が含まれています。ですが、同じ検索フィルターを {% data variables.product.product_location_enterprise %} で使えます。{% endif %}
   - 検索結果を改良する検索修飾子を追加できる検索構文のリストについては、「[検索構文を理解する](/articles/understanding-the-search-syntax)」を参照してください。
   - 複数単語の検索用語は引用符で囲みます。 たとえば "In progress" というラベルを持つ Issue を検索したい場合は、`label:"in progress"` とします。 検索では、大文字と小文字は区別されません。
diff --git a/translations/ja-JP/data/reusables/secret-scanning/beta.md b/translations/ja-JP/data/reusables/secret-scanning/beta.md
index 024693ceb22d..37ef8d5b7f2f 100644
--- a/translations/ja-JP/data/reusables/secret-scanning/beta.md
+++ b/translations/ja-JP/data/reusables/secret-scanning/beta.md
@@ -2,4 +2,4 @@
 
 **ノート:** プライベートリポジトリのための{% data variables.product.prodname_secret_scanning_caps %}は現在ベータで、変更されることがあります。 ベータへのアクセスをリクエストするには、[待ちリストに参加](https://github.com/features/security/advanced-security/signup)してください。
 
-{% endnote %}
\ No newline at end of file
+{% endnote %}
diff --git a/translations/ja-JP/data/reusables/security/security-and-analysis-features-enable-read-only.md b/translations/ja-JP/data/reusables/security/security-and-analysis-features-enable-read-only.md
index 942933fd9274..ff3b3d736001 100644
--- a/translations/ja-JP/data/reusables/security/security-and-analysis-features-enable-read-only.md
+++ b/translations/ja-JP/data/reusables/security/security-and-analysis-features-enable-read-only.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-If you enable security and analysis features, {% data variables.product.company_short %} performs read-only analysis on your repository. 詳しい情報については、「[{% data variables.product.company_short %} によるデータ使用について](/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data)」を参照してください。
-{% endif %}
\ No newline at end of file
+If you enable security and analysis features,
+{% data variables.product.company_short %} performs read-only analysis on your repository. 詳しい情報については、「[{% data variables.product.company_short %} によるデータ使用について](/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data)」を参照してください。
+{% endif %}
diff --git a/translations/ja-JP/data/reusables/shortdesc/iso_8601.md b/translations/ja-JP/data/reusables/shortdesc/iso_8601.md
index 10d5d4f84526..f050d9c4df8f 100644
--- a/translations/ja-JP/data/reusables/shortdesc/iso_8601.md
+++ b/translations/ja-JP/data/reusables/shortdesc/iso_8601.md
@@ -1 +1 @@
-これは[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)フォーマットの`YYYY-MM-DDTHH:MM:SSZ`でのタイムスタンプです。
\ No newline at end of file
+これは[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)フォーマットの`YYYY-MM-DDTHH:MM:SSZ`でのタイムスタンプです。
diff --git a/translations/ja-JP/data/reusables/sponsors/edit-featured-work.md b/translations/ja-JP/data/reusables/sponsors/edit-featured-work.md
index 70fa9937c456..1d8215b5e02d 100644
--- a/translations/ja-JP/data/reusables/sponsors/edit-featured-work.md
+++ b/translations/ja-JP/data/reusables/sponsors/edit-featured-work.md
@@ -1,3 +1,3 @@
 1. あるいは、{% data variables.product.prodname_sponsors %}プロファイルで提示されているリポジトリを選択することもできます。
     - "Featured work（重要な作業）"の右で、**Edit（編集）**をクリックしてください。 ![重要な作業の編集ボタン](/assets/images/help/sponsors/featured-work-edit-button.png)
-    - 最大で6つまでのリポジトリを選択し、**Save（保存）**をクリックしてください。 ![リポジトリの選択チェックボックス](/assets/images/help/sponsors/featured-work-select.png)
\ No newline at end of file
+    - 最大で6つまでのリポジトリを選択し、**Save（保存）**をクリックしてください。 ![リポジトリの選択チェックボックス](/assets/images/help/sponsors/featured-work-select.png)
diff --git a/translations/ja-JP/data/reusables/sponsors/meet-the-team.md b/translations/ja-JP/data/reusables/sponsors/meet-the-team.md
index dfa68ec9b68c..0c79aecc9394 100644
--- a/translations/ja-JP/data/reusables/sponsors/meet-the-team.md
+++ b/translations/ja-JP/data/reusables/sponsors/meet-the-team.md
@@ -2,4 +2,4 @@
     - "Meet the team（チームに会う）"の右で、**Edit（編集）**をクリックしてください。  
       ![プロフィールにOrganizationのメンバーを編集ボタン](/assets/images/help/sponsors/edit-org-members-profile-button.png)
     - 最大で6人のOrganizationのメンバーを選択し、**Save（保存）**をクリックしてください。 ![ハイライトされたOrganizationメンバーを選択](/assets/images/help/sponsors/select-highlighted-org-members.png)
-    - あるいは、それぞれのハイライトされたメンバーの名前の下に、そのメンバーの説明を入力してください。  ![ハイライトされたOrganizationメンバーの説明](/assets/images/help/sponsors/description-highlighted-org-members.png)
\ No newline at end of file
+    - あるいは、それぞれのハイライトされたメンバーの名前の下に、そのメンバーの説明を入力してください。  ![ハイライトされたOrganizationメンバーの説明](/assets/images/help/sponsors/description-highlighted-org-members.png)
diff --git a/translations/ja-JP/data/reusables/sponsors/navigate-to-dev-sponsors-dashboard.md b/translations/ja-JP/data/reusables/sponsors/navigate-to-dev-sponsors-dashboard.md
index fe01ef6451e9..3fe3b3e780b3 100644
--- a/translations/ja-JP/data/reusables/sponsors/navigate-to-dev-sponsors-dashboard.md
+++ b/translations/ja-JP/data/reusables/sponsors/navigate-to-dev-sponsors-dashboard.md
@@ -1,2 +1,2 @@
-1. 任意のページの右上隅で、プロフィール画像をクリックし、続いて [**{% data variables.product.prodname_sponsors %}**] をクリックしてください。 ![{% data variables.product.prodname_sponsors %}ボタン](/assets/images/help/sponsors/access-github-sponsors-dashboard.png)
+1. 任意のページの右上隅で、プロフィール画像をクリックし、続いて [**{% data variables.product.prodname_sponsors %}**] をクリックします。 ![{% data variables.product.prodname_sponsors %}ボタン](/assets/images/help/sponsors/access-github-sponsors-dashboard.png)
 2. スポンサー付きの適格なアカウントのリストが表示されているなら、自分のアカウント名の右で**Dashboard（ダッシュボード）**をクリックしてください。 ![開発者スポンサーダッシュボードボタン](/assets/images/help/sponsors/dev-sponsors-dashboard-button.png)
diff --git a/translations/ja-JP/data/reusables/sponsors/navigate-to-org-sponsors-dashboard.md b/translations/ja-JP/data/reusables/sponsors/navigate-to-org-sponsors-dashboard.md
index fdabec5d9794..9e65ac73f214 100644
--- a/translations/ja-JP/data/reusables/sponsors/navigate-to-org-sponsors-dashboard.md
+++ b/translations/ja-JP/data/reusables/sponsors/navigate-to-org-sponsors-dashboard.md
@@ -1,2 +1,2 @@
-1. 任意のページの右上隅で、プロフィール画像をクリックし、続いて [**{% data variables.product.prodname_sponsors %}**] をクリックしてください。 ![{% data variables.product.prodname_sponsors %}ボタン](/assets/images/help/sponsors/access-github-sponsors-dashboard.png)
+1. 任意のページの右上隅で、プロフィール画像をクリックし、続いて [**{% data variables.product.prodname_sponsors %}**] をクリックします。 ![{% data variables.product.prodname_sponsors %}ボタン](/assets/images/help/sponsors/access-github-sponsors-dashboard.png)
 2. スポンサー付きの適格なアカウントのリスト中で、Organizationの右の**Dashboard（ダッシュボード）**をクリックしてください。 ![Organizationのスポンサーダッシュボードボタン](/assets/images/help/sponsors/org-sponsors-dashboard-button.png)
diff --git a/translations/ja-JP/data/reusables/sponsors/navigate-to-your-goals-tab.md b/translations/ja-JP/data/reusables/sponsors/navigate-to-your-goals-tab.md
index 7827f160d869..3a6b5c051126 100644
--- a/translations/ja-JP/data/reusables/sponsors/navigate-to-your-goals-tab.md
+++ b/translations/ja-JP/data/reusables/sponsors/navigate-to-your-goals-tab.md
@@ -1 +1 @@
-1. 左のサイドバーで**Your goals（あなたの目標）**をクリックしてください。 ![あなたの目標タブ](/assets/images/help/sponsors/your-goals-tab.png)
\ No newline at end of file
+1. 左のサイドバーで**Your goals（あなたの目標）**をクリックしてください。 ![あなたの目標タブ](/assets/images/help/sponsors/your-goals-tab.png)
diff --git a/translations/ja-JP/data/reusables/sponsors/opt-in-to-being-featured.md b/translations/ja-JP/data/reusables/sponsors/opt-in-to-being-featured.md
index aadde67a5a17..002240ad12d4 100644
--- a/translations/ja-JP/data/reusables/sponsors/opt-in-to-being-featured.md
+++ b/translations/ja-JP/data/reusables/sponsors/opt-in-to-being-featured.md
@@ -1 +1 @@
-1. あるいは、**Opt-in to potentially being featured on github.com/sponsors（github.com/sponsorsに取り上げられるかもしれないことにオプトイン）**を選択してください。 ![取り上げられることへのオプトインのチェックボックス](/assets/images/help/sponsors/opt-in-to-being-featured.png)
\ No newline at end of file
+1. あるいは、**Opt-in to potentially being featured on github.com/sponsors（github.com/sponsorsに取り上げられるかもしれないことにオプトイン）**を選択してください。 ![取り上げられることへのオプトインのチェックボックス](/assets/images/help/sponsors/opt-in-to-being-featured.png)
diff --git a/translations/ja-JP/data/reusables/sponsors/publish-goal.md b/translations/ja-JP/data/reusables/sponsors/publish-goal.md
index 0a249e498d36..c093277e4d99 100644
--- a/translations/ja-JP/data/reusables/sponsors/publish-goal.md
+++ b/translations/ja-JP/data/reusables/sponsors/publish-goal.md
@@ -1 +1 @@
-1. **Publish（公開）**をクリックしてください。 ![公開ボタン](/assets/images/help/sponsors/publish-goal-button.png)
\ No newline at end of file
+1. **Publish（公開）**をクリックしてください。 ![公開ボタン](/assets/images/help/sponsors/publish-goal-button.png)
diff --git a/translations/ja-JP/data/reusables/sponsors/retire-goal.md b/translations/ja-JP/data/reusables/sponsors/retire-goal.md
index e565d8862694..39aba54c9d86 100644
--- a/translations/ja-JP/data/reusables/sponsors/retire-goal.md
+++ b/translations/ja-JP/data/reusables/sponsors/retire-goal.md
@@ -1,2 +1,2 @@
 1. ページの下部で、**Retire（終了）**をクリックしてください。 ![終了ボタン](/assets/images/help/sponsors/retire-goal-button.png)
-2. 警告を読んで、**OK**をクリックしてください。 ![目標の終了に関する警告](/assets/images/help/sponsors/confirm-retire-goal.png)
\ No newline at end of file
+2. 警告を読んで、**OK**をクリックしてください。 ![目標の終了に関する警告](/assets/images/help/sponsors/confirm-retire-goal.png)
diff --git a/translations/ja-JP/data/reusables/sponsors/save-profile.md b/translations/ja-JP/data/reusables/sponsors/save-profile.md
index 17fb1a6cb7ca..985cbffb05d8 100644
--- a/translations/ja-JP/data/reusables/sponsors/save-profile.md
+++ b/translations/ja-JP/data/reusables/sponsors/save-profile.md
@@ -1 +1 @@
-1. [**Update profile**] をクリックします。
\ No newline at end of file
+1. [**Update profile**] をクリックします。
diff --git a/translations/ja-JP/data/reusables/sponsors/set-a-goal.md b/translations/ja-JP/data/reusables/sponsors/set-a-goal.md
index 6c86cda9b475..5853e63f38bb 100644
--- a/translations/ja-JP/data/reusables/sponsors/set-a-goal.md
+++ b/translations/ja-JP/data/reusables/sponsors/set-a-goal.md
@@ -1 +1 @@
-1. "Your goals（目標）"の下で、**Set a goal（目標の設定）**をクリックしてください。 ![目標の設定ボタン ](/assets/images/help/sponsors/set-a-goal-button.png)
\ No newline at end of file
+1. "Your goals（目標）"の下で、**Set a goal（目標の設定）**をクリックしてください。 ![目標の設定ボタン ](/assets/images/help/sponsors/set-a-goal-button.png)
diff --git a/translations/ja-JP/data/reusables/sponsors/short-bio.md b/translations/ja-JP/data/reusables/sponsors/short-bio.md
index 1e1904c568fe..428aa9f3fdbe 100644
--- a/translations/ja-JP/data/reusables/sponsors/short-bio.md
+++ b/translations/ja-JP/data/reusables/sponsors/short-bio.md
@@ -1 +1 @@
-1. "Short bio（短い略歴）"の下で、あなた自身とあなたの仕事の簡単な説明を入力してください。 ![短い略歴フィールド](/assets/images/help/sponsors/short-bio.png)
\ No newline at end of file
+1. "Short bio（短い略歴）"の下で、あなた自身とあなたの仕事の簡単な説明を入力してください。 ![短い略歴フィールド](/assets/images/help/sponsors/short-bio.png)
diff --git a/translations/ja-JP/data/reusables/sponsors/stripe-supported-regions.md b/translations/ja-JP/data/reusables/sponsors/stripe-supported-regions.md
index 42b7f9b272df..ccb8072d2465 100644
--- a/translations/ja-JP/data/reusables/sponsors/stripe-supported-regions.md
+++ b/translations/ja-JP/data/reusables/sponsors/stripe-supported-regions.md
@@ -1 +1 @@
-サポートされている地域のリストについては[{% data variables.product.prodname_sponsors %}](https://github.com/sponsors)を参照してください。
+サポートされている地域のリストについては[{% data variables.product.prodname_sponsors %}](https://github.com/sponsors#countries)を参照してください。
diff --git a/translations/ja-JP/data/reusables/sponsors/you-can-be-a-sponsored-developer.md b/translations/ja-JP/data/reusables/sponsors/you-can-be-a-sponsored-developer.md
index cfe15be10d98..1503c52567c0 100644
--- a/translations/ja-JP/data/reusables/sponsors/you-can-be-a-sponsored-developer.md
+++ b/translations/ja-JP/data/reusables/sponsors/you-can-be-a-sponsored-developer.md
@@ -1 +1 @@
-オープンソースプロジェクトにコントリビュートし、サポートされている地域に銀行口座を持っている人は、スポンサード開発者になることができます。 コントリビューションにはバグレポート、Issueのトリアージ、コード、ドキュメンテーション、リーダーシップ、ビジネス開発、プロジェクト管理、メンターシップ、設計などがありますが、これだけに限定されません。 {% data variables.product.prodname_sponsors %}にまだサポートされていない地域に住んでいる場合、{% data variables.product.prodname_sponsors %}のベータへの参加の待ちリストにサインアップできます。 あなたの地域で{% data variables.product.prodname_sponsors %}が利用できるかを見るには、[サポートされている地域のリスト](https://github.com/sponsors#regions)を参照してください。
+Anyone who contributes to an open source project and lives in a supported region is eligible to become a sponsored developer. コントリビューションにはバグレポート、Issueのトリアージ、コード、ドキュメンテーション、リーダーシップ、ビジネス開発、プロジェクト管理、メンターシップ、設計などがありますが、これだけに限定されません。 {% data variables.product.prodname_sponsors %}にまだサポートされていない地域に住んでいる場合、{% data variables.product.prodname_sponsors %}のベータへの参加の待ちリストにサインアップできます。
diff --git a/translations/ja-JP/data/reusables/sponsors/you-can-be-a-sponsored-organization.md b/translations/ja-JP/data/reusables/sponsors/you-can-be-a-sponsored-organization.md
index 38a6ad958786..8b1a3ed050da 100644
--- a/translations/ja-JP/data/reusables/sponsors/you-can-be-a-sponsored-organization.md
+++ b/translations/ja-JP/data/reusables/sponsors/you-can-be-a-sponsored-organization.md
@@ -1 +1 @@
-オープンソースプロジェクトにコントリビュートし、サポートされている地域に専用の銀行口座を持っているOrganizationは、スポンサードOrganizationになることができます。 {% data variables.product.prodname_sponsors %}にまだサポートされていない地域に住んでいる場合は、[{% data variables.product.prodname_sponsors %}](https://github.com/sponsors)の待ちリストに加わってください。
+Any organization that contributes to an open source project and legally operates in a supported region is eligible to become a sponsored organization. If your organization operates in a region that isn't already supported by {% data variables.product.prodname_sponsors %}, join the waitlist at [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors).
diff --git a/translations/ja-JP/data/reusables/ssh/dsa-support.md b/translations/ja-JP/data/reusables/ssh/dsa-support.md
index 6f9b001f63da..e75e3cecd2ce 100644
--- a/translations/ja-JP/data/reusables/ssh/dsa-support.md
+++ b/translations/ja-JP/data/reusables/ssh/dsa-support.md
@@ -1,5 +1,5 @@
 {% note %}
 
-**ノート：** {% if currentVersion != "free-pro-team@latest" or currentVersion ver_lt "enterprise-server@2.19" %}DSAキーはOpenSSH 7.0で非推奨となりました。 使用しているオペレーティングシステムがOpenSSHを使っているなら、SSHをセットアップする際にRSAキーなどの別の種類のキーを使う必要があります。 たとえば、使用しているオペレーティングシステムがmacOS Sierraであるなら、RSAキーを使ってSSHをセットアップできます。{% else %}DSAキー（SSH-DSS）はもうサポートされていません。 既存のキーは引き続き動作しますが、{% data variables.product.product_name %}アカウントに新しいDSAキーを追加することはできません。{% endif %}
+**Note:** DSA keys (SSH-DSS) are no longer supported. 既存のキーは引き続き動作しますが、{% data variables.product.product_name %}アカウントに新しいDSAキーを追加することはできません。
 
 {% endnote %}
diff --git a/translations/ja-JP/data/reusables/support/about-premium-plans.md b/translations/ja-JP/data/reusables/support/about-premium-plans.md
index b62c4eaf0c46..93fa07d1eaad 100644
--- a/translations/ja-JP/data/reusables/support/about-premium-plans.md
+++ b/translations/ja-JP/data/reusables/support/about-premium-plans.md
@@ -3,16 +3,16 @@
 
 {% data variables.contact.premium_support %}プランには、PremiumとPremium Plus / {% data variables.product.microsoft_premium_plus_support_plan %}の2つがあります 。
 
-|               | {% data variables.product.premium_support_plan %} | {% data variables.product.premium_plus_support_plan %} |
-| ------------- | -------------------------------------------------------- | ------------------------------------------------------------- |
-| 営業時間          | 24 x 7                                                   | 24 x 7                                                        |
-| 初期返答時間        | 
    • {% data variables.product.support_ticket_priority_urgent %}については30分
    • {% data variables.product.support_ticket_priority_high %}については4時間
                                    | 
    • {% data variables.product.support_ticket_priority_urgent %}については30分
    • {% data variables.product.support_ticket_priority_high %}については4時間
                                         |
-| サポートチャネル      | 
    • オンラインチケットの提出
    • 電話サポート
                                    | 
    • オンラインチケットの提出
    • 電話サポート
    • 重大な問題についての画面共有
                                         |
-| トレーニング        | プレミアムコンテンツへのアクセス                                         | 
    • プレミアムコンテンツへのアクセス
    • 1年ごとに1つの仮想トレーニングクラス
                                         |
-| 承認された連絡先      | 10                                                       | 25                                                            |
-| リソース          | 優先的なチケットの処理                                              | 
    • 優先的なチケットの処理
    • 指名されたテクニカルサポートアカウントマネージャ
                                         |
-| スケジュールされたチェック | 年2回のヘルスチェックとレポート                                         | 
    • 四半期ごとのヘルスチェックとレポート
    • 四半期ごとのアカウントレビュー
                                         |
-| 管理            |                                                          | 月ごと4時間のマネージドサービス                                              |
+|               | {% data variables.product.premium_support_plan %} | {% data variables.product.premium_plus_support_plan %}
+| ------------- | --------------------------------------------------- | -------------------------------------------------------- |
+| 営業時間          | 24 x 7                                              | 24 x 7                                                   |
+| 初期返答時間        | 
    • {% data variables.product.support_ticket_priority_urgent %}については30分
    • {% data variables.product.support_ticket_priority_high %}については4時間
                               | 
    • {% data variables.product.support_ticket_priority_urgent %}については30分
    • {% data variables.product.support_ticket_priority_high %}については4時間
                                    |
+| サポートチャネル      | 
    • オンラインチケットの提出
    • 電話サポート
                               | 
    • オンラインチケットの提出
    • 電話サポート
    • 重大な問題についての画面共有
                                    |
+| トレーニング        | プレミアムコンテンツへのアクセス                                    | 
    • プレミアムコンテンツへのアクセス
    • 1年ごとに1つの仮想トレーニングクラス
                                    |
+| 承認された連絡先      | 10                                                  | 25                                                       |
+| リソース          | 優先的なチケットの処理                                         | 
    • 優先的なチケットの処理
    • 指名されたテクニカルサポートアカウントマネージャ
                                    |
+| スケジュールされたチェック | 年2回のヘルスチェックとレポート                                    | 
    • 四半期ごとのヘルスチェックとレポート
    • 四半期ごとのアカウントレビュー
                                    |
+| 管理            |                                                     | 月ごと4時間のマネージドサービス                                         |
 
   {% note %}
 
diff --git a/translations/ja-JP/data/reusables/support/ghec-premium-priorities.md b/translations/ja-JP/data/reusables/support/ghec-premium-priorities.md
index 98d67716b084..a9761137ff02 100644
--- a/translations/ja-JP/data/reusables/support/ghec-premium-priorities.md
+++ b/translations/ja-JP/data/reusables/support/ghec-premium-priorities.md
@@ -1,6 +1,6 @@
-|                                優先度                                 | 説明                                                                                                                                                                                                                              | サンプル                      |
-|:------------------------------------------------------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
-| {% data variables.product.support_ticket_priority_urgent %} | {% data variables.product.prodname_ghe_cloud %}上のOrganizationあるいはEnterpriseのプロダクションワークフローが、重大なサービスのエラーもしくは中断のために失敗しており、その失敗が直接的にビジネスの運用に影響している。                                                                          | 
    • {% data variables.product.prodname_dotcom_the_website %}のエラーもしくは中断が、OrganizationもしくはEnterpriseのすべてのメンバーに対し、中核的なGitもしくはWebアプリケーションの機能に影響している。
     |
-|  {% data variables.product.support_ticket_priority_high %}  | {% data variables.product.prodname_ghe_cloud %}上のOrganizationもしくはEnterpriseにおけるアカウントもしくはセキュリティの問題が、ビジネスに限定的な影響を及ぼしている。                                                                                                   | 
    • OrganizationあるいはEnterpriseのオーナーが、意図せずOrganizationを削除した。
    • OrganizationあるいはEnterpriseのメンバーが、コミット、Issue、プルリクエスト、Issueへの添付ファイル内でセンシティブなデータをアップロードした。
     |
+|                              優先度                              | 説明                                                                                                                                                                                                                    | サンプル                      |
+|:-------------------------------------------------------------:| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
+| {% data variables.product.support_ticket_priority_urgent %} | {% data variables.product.prodname_ghe_cloud %}上のOrganizationあるいはEnterpriseのプロダクションワークフローが、重大なサービスのエラーもしくは中断のために失敗しており、その失敗が直接的にビジネスの運用に影響している。                                                                     | 
    • {% data variables.product.prodname_dotcom_the_website %}のエラーもしくは中断が、OrganizationもしくはEnterpriseのすべてのメンバーに対し、中核的なGitもしくはWebアプリケーションの機能に影響している。
     |
+|  {% data variables.product.support_ticket_priority_high %}  | {% data variables.product.prodname_ghe_cloud %}上のOrganizationもしくはEnterpriseにおけるアカウントもしくはセキュリティの問題が、ビジネスに限定的な影響を及ぼしている。                                                                                              | 
    • OrganizationあるいはEnterpriseのオーナーが、意図せずOrganizationを削除した。
    • OrganizationあるいはEnterpriseのメンバーが、コミット、Issue、プルリクエスト、Issueへの添付ファイル内でセンシティブなデータをアップロードした。
     |
 | {% data variables.product.support_ticket_priority_normal %} | {% data variables.product.prodname_ghe_cloud %}上のOrganizationあるいはEnterpriseのメンバーが、{% data variables.product.prodname_dotcom_the_website %}において限定的あるいは中程度の問題を体験している、もしくはOrganizatonもしくはEnterpriseに関する一般的な懸念や疑問がある。 | 
    • OrganizationもしくはEnterpriseのためのAPIや機能の利用についての疑問
    • {% data variables.product.company_short %}が提供しているOrganizationのデータ移行のためのツールについての問題
    • OrganizationあるいはEnterpriseに関係する機能が、期待どおりに動作していない
    • OrganizationあるいはEnterpriseに関する一般的なセキュリティの疑問
     |
-|  {% data variables.product.support_ticket_priority_low %}   | {% data variables.product.prodname_ghe_cloud %}上のOrganizationあるいはEnterpriseに関して、時間の問題がない、あるいはチームの生産性を阻害していない疑問や提案がある。                                                                                                    | 
    • OrganizationあるいはEnterpriseによる過剰なリソースの利用
    • ヘルスチェックのリクエスト
    • Gists、通知、ウィキ、{% data variables.product.prodname_pages %}、{% data variables.product.prodname_desktop %}、Atom、あるいはその他のOrganizationあるいはEnterpriseについての周辺サービスや機能の利用に関する支援
    • 機能リクエスト
    • 製品のフィードバック
     |
+|  {% data variables.product.support_ticket_priority_low %}   | {% data variables.product.prodname_ghe_cloud %}上のOrganizationあるいはEnterpriseに関して、時間の問題がない、あるいはチームの生産性を阻害していない疑問や提案がある。                                                                                               | 
    • OrganizationあるいはEnterpriseによる過剰なリソースの利用
    • ヘルスチェックのリクエスト
    • Gists、通知、ウィキ、{% data variables.product.prodname_pages %}、{% data variables.product.prodname_desktop %}、Atom、あるいはその他のOrganizationあるいはEnterpriseについての周辺サービスや機能の利用に関する支援
    • 機能リクエスト
    • 製品のフィードバック
     |
diff --git a/translations/ja-JP/data/reusables/support/ghes-priorities.md b/translations/ja-JP/data/reusables/support/ghes-priorities.md
index ebda97b80052..db9a22ff5a2d 100644
--- a/translations/ja-JP/data/reusables/support/ghes-priorities.md
+++ b/translations/ja-JP/data/reusables/support/ghes-priorities.md
@@ -1,6 +1,6 @@
-|                                優先度                                 | 説明                                                                                                                                                                                           | サンプル                      |
-|:------------------------------------------------------------------:| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
+|                              優先度                              | 説明                                                                                                                                                                                 | サンプル                      |
+|:-------------------------------------------------------------:| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
 | {% data variables.product.support_ticket_priority_urgent %} | {% data variables.product.prodname_ghe_server %}がプロダクション環境で障害を起こしており、その障害が直接的にビジネスの運用に影響している。

    _{% data reusables.support.priority-urgent-english-only %}_ | 
    • すべてのユーザーについて、中核的なGitあるいはWebアプリケーションの機能に影響するエラーもしくは中断
    • ユーザーの大多数についての重大なパフォーマンスの低下
    • ストレージがフル、もしくは急速に埋まりつつある
    • 更新されたライセンスファイルをインストールできない
    • セキュリティインシデント
    • 既知の回避策がない、インスタンスへの管理アクセスの喪失
    • プロダクション環境へのバックアップのリストアの失敗
     |
-|  {% data variables.product.support_ticket_priority_high %}  | {% data variables.product.prodname_ghe_server %}がプロダクション環境で障害を起こしているが、ビジネスへの影響は限定的                                                                                                    | 
    • 多くのユーザの生産性を引き下げるパフォーマンスの低下
    • High Availability (HA)もしくはクラスタノードの障害による冗長性の低下
    • インスタンスのバックアップの失敗
    • プロダクション環境へのリストアが成功しないかもしれないテストあるいはステージング環境へのリストアの失敗
     |
-| {% data variables.product.support_ticket_priority_normal %} | {% data variables.product.prodname_ghe_server %}において限定的あるいは中程度の問題が生じているか、インスタンスの運用に関する一般的な懸念もしくは疑問がある。                                                                                | 
    • テストあるいはステージング環境での問題
    • {% data variables.product.prodname_dotcom %}のAPI及び機能の利用方法についてのアドバイス、あるいはインスタンスでのサードパーティとのインテグレーションの設定に関する疑問
    • {% data variables.product.company_short %}が提供しているユーザデータ移行のためのツールについての問題
    • アップグレード
    • バグのレポート
    • 期待どおりに動作していない機能
    • 一般的なセキュリティに関する疑問
     |
-|  {% data variables.product.support_ticket_priority_low %}   | {% data variables.product.prodname_ghe_server %}に関して、時間の問題がない、あるいはチームの生産性を阻害していない疑問や提案がある。                                                                                            | 
    • 機能リクエスト
    • 製品のフィードバック
    • ヘルスチェックのリクエスト（現時点では{% data variables.product.premium_support_plan %}の顧客のみ利用可能）
    • インスタンス上の計画されたメンテナンスの{% data variables.product.company_short %}への通知
     |
+|  {% data variables.product.support_ticket_priority_high %}  | {% data variables.product.prodname_ghe_server %}がプロダクション環境で障害を起こしているが、ビジネスへの影響は限定的                                                                                               | 
    • 多くのユーザの生産性を引き下げるパフォーマンスの低下
    • High Availability (HA)もしくはクラスタノードの障害による冗長性の低下
    • インスタンスのバックアップの失敗
    • プロダクション環境へのリストアが成功しないかもしれないテストあるいはステージング環境へのリストアの失敗
     |
+| {% data variables.product.support_ticket_priority_normal %} | {% data variables.product.prodname_ghe_server %}において限定的あるいは中程度の問題が生じているか、インスタンスの運用に関する一般的な懸念もしくは疑問がある。                                                                           | 
    • テストあるいはステージング環境での問題
    • {% data variables.product.prodname_dotcom %}のAPI及び機能の利用方法についてのアドバイス、あるいはインスタンスでのサードパーティとのインテグレーションの設定に関する疑問
    • {% data variables.product.company_short %}が提供しているユーザデータ移行のためのツールについての問題
    • アップグレード
    • バグのレポート
    • 期待どおりに動作していない機能
    • 一般的なセキュリティに関する疑問
     |
+|  {% data variables.product.support_ticket_priority_low %}   | {% data variables.product.prodname_ghe_server %}に関して、時間の問題がない、あるいはチームの生産性を阻害していない疑問や提案がある。                                                                                       | 
    • 機能リクエスト
    • 製品のフィードバック
    • ヘルスチェックのリクエスト（現時点では{% data variables.product.premium_support_plan %}の顧客のみ利用可能）
    • インスタンス上の計画されたメンテナンスの{% data variables.product.company_short %}への通知
     |
diff --git a/translations/ja-JP/data/reusables/support/priority-urgent-english-only.md b/translations/ja-JP/data/reusables/support/priority-urgent-english-only.md
index f1ab1ee6d0d3..1a6e420d2fb3 100644
--- a/translations/ja-JP/data/reusables/support/priority-urgent-english-only.md
+++ b/translations/ja-JP/data/reusables/support/priority-urgent-english-only.md
@@ -1 +1 @@
-優先度が{% data variables.product.support_ticket_priority_urgent %}のチケットに対するサポートは、英語でのみ利用できます。
\ No newline at end of file
+優先度が{% data variables.product.support_ticket_priority_urgent %}のチケットに対するサポートは、英語でのみ利用できます。
diff --git a/translations/ja-JP/data/reusables/support/receiving-credits.md b/translations/ja-JP/data/reusables/support/receiving-credits.md
index 7d5a6603fd54..87d94e3db987 100644
--- a/translations/ja-JP/data/reusables/support/receiving-credits.md
+++ b/translations/ja-JP/data/reusables/support/receiving-credits.md
@@ -14,6 +14,6 @@
 - **日付** （日付は、遅延が生じた{% data variables.product.company_short %}の会計年度の四半期から30日以内でなければなりません[1月31日、4月30日、7月31日、10月31日]）
 - **顧客の連絡先** （名前とメールアドレスをどちらも指定しなければなりません）
 - **顧客の住所**
-- **有効なクレジット** （それぞれの有効なクレジットの日付と関連するチケット番号が必要です）{% if currentVersion == "free-pro-team@latest" %}
+- **Qualifying credits** (You must provide the date of each qualifying credit and the associated ticket number.){% if currentVersion == "free-pro-team@latest" %}
 - **{% data variables.product.prodname_ghe_cloud %}のOrganization名**{% endif %}
 - **チケット番号**
diff --git a/translations/ja-JP/data/reusables/support/service-level-agreement-response-times.md b/translations/ja-JP/data/reusables/support/service-level-agreement-response-times.md
index 382eff8aa062..5d4cbf991348 100644
--- a/translations/ja-JP/data/reusables/support/service-level-agreement-response-times.md
+++ b/translations/ja-JP/data/reusables/support/service-level-agreement-response-times.md
@@ -2,7 +2,7 @@
 
 サブミットされたチケットに対しては、サポートは24時間・週7日対応します。 SLAが保証する初期の返信までの時間は、チケットの優先度によります。 返信までの時間は、{% data variables.contact.premium_support %}がチケットの優先度を設定したときから始まります。 返信は、問題が解決されたことを意味しません。
 
-| チケットの優先レベル                                                         | 初期返答時間 |
-| ------------------------------------------------------------------ | ------ |
+| チケットの優先レベル                                                    | 初期返答時間 |
+| ------------------------------------------------------------- | ------ |
 | {% data variables.product.support_ticket_priority_urgent %} | 30分    |
 | {% data variables.product.support_ticket_priority_high %}   | 4時間    |
diff --git a/translations/ja-JP/data/reusables/two_fa/about-2fa.md b/translations/ja-JP/data/reusables/two_fa/about-2fa.md
new file mode 100644
index 000000000000..704cb699cc2e
--- /dev/null
+++ b/translations/ja-JP/data/reusables/two_fa/about-2fa.md
@@ -0,0 +1 @@
+Two-factor authentication (2FA) is an extra layer of security used when logging into websites or apps.
diff --git a/translations/ja-JP/data/reusables/two_fa/after-2fa-add-security-key.md b/translations/ja-JP/data/reusables/two_fa/after-2fa-add-security-key.md
index 7d7be402d190..46decf91ec8a 100644
--- a/translations/ja-JP/data/reusables/two_fa/after-2fa-add-security-key.md
+++ b/translations/ja-JP/data/reusables/two_fa/after-2fa-add-security-key.md
@@ -1 +1 @@
-モバイルアプリケーション{% if currentVersion == "free-pro-team@latest" %}あるいはテキストメッセージ{% endif %}を使って2FAを設定した後、指紋リーダーやWindows Helloのようなセキュリティキーを追加できます。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}セキュリティキーで認証を有効化する技術は、WebAuthnと呼ばれます。 WebAuthnはU2Fの後継であり、現代的なすべてのブラウザーで動作します。 詳しい情報については「[WebAuthn](https://webauthn.guide/)」及び「[利用できますか](https://caniuse.com/#search=webauthn)」を参照してください。{% else %}FIDO U2F認証は、現在Chrome、Firefox、Operaブラウザで利用できます。{% endif %}
+After you configure 2FA using a mobile app{% if currentVersion == "free-pro-team@latest" %} or via text message{% endif %}, you can add a security key, like a fingerprint reader or Windows Hello. The technology that enables authentication with a security key is called WebAuthn. WebAuthnはU2Fの後継であり、現代的なすべてのブラウザーで動作します。 For more information, see "[WebAuthn](https://webauthn.guide/)" and "[Can I Use](https://caniuse.com/#search=webauthn)."
diff --git a/translations/ja-JP/data/reusables/two_fa/auth_methods_2fa.md b/translations/ja-JP/data/reusables/two_fa/auth_methods_2fa.md
index a050f01fe298..92b6fc1662f2 100644
--- a/translations/ja-JP/data/reusables/two_fa/auth_methods_2fa.md
+++ b/translations/ja-JP/data/reusables/two_fa/auth_methods_2fa.md
@@ -1,10 +1,10 @@
 {% if currentVersion != "free-pro-team@latest" %}
 ### 2FAをサポートする認証方式
 
-| 認証方式                    | 説明                                                                                          | 2要素認証のサポート                                                                                                                                                             |
-| ----------------------- | ------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| ビルトイン                   | 認証は{% data variables.product.prodname_ghe_server %}アプライアンスに保存されているユーザアカウントに対して行われます。 | {% data variables.product.prodname_ghe_server %}アプライアンスでサポートされ、管理されます。 Organizationの管理者は、Organizationのメンバーに対して2FAの有効化を要求できます。 {% if currentVersion != "free-pro-team@latest" %}
-| アイデンティティプロバイダ付きのビルトイン認証 | 認証は、アイデンティティプロバイダに保存されたユーザアカウントに対して行われます。                                                   | アイデンティティプロバイダに依存します。{% endif %}
-| LDAP                    | 会社のディレクトリサービスとの認証のインテグレーションができます。                                                           | {% data variables.product.prodname_ghe_server %}アプライアンスでサポートされ、管理されます。 Organizationの管理者は、Organizationのメンバーに対して2FAの有効化を要求できます。                                   |
-| SAML                    | 認証は外部のアイデンティティプロバイダに対して行われます。                                                               | {% data reusables.two_fa.2fa_not_supported_with_saml_and_cas %}                                                                                             |
-| CAS                     | 外部のサーバーによってシングルサインオンサービスが提供されます。                                                            | {% data reusables.two_fa.2fa_not_supported_with_saml_and_cas %}{% endif %}
+| 認証方式                    | 説明                                                                                     | 2要素認証のサポート                                                                                                                                                                         |
+| ----------------------- | -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| ビルトイン                   | 認証は{% data variables.product.prodname_ghe_server %}アプライアンスに保存されているユーザアカウントに対して行われます。 | {% data variables.product.prodname_ghe_server %}アプライアンスでサポートされ、管理されます。 Organizationの管理者は、Organizationのメンバーに対して2FAの有効化を要求できます。 |{% if currentVersion != "free-pro-team@latest" %}
+| アイデンティティプロバイダ付きのビルトイン認証 | 認証は、アイデンティティプロバイダに保存されたユーザアカウントに対して行われます。                                              | アイデンティティプロバイダに依存します。{% endif %}
+| LDAP                    | 会社のディレクトリサービスとの認証のインテグレーションができます。                                                      | {% data variables.product.prodname_ghe_server %}アプライアンスでサポートされ、管理されます。 Organizationの管理者は、Organizationのメンバーに対して2FAの有効化を要求できます。                                                    |
+| SAML                    | 認証は外部のアイデンティティプロバイダに対して行われます。                                                          | {% data reusables.two_fa.2fa_not_supported_with_saml_and_cas %}
+| CAS                     | 外部のサーバーによってシングルサインオンサービスが提供されます。                                                       | {% data reusables.two_fa.2fa_not_supported_with_saml_and_cas %}{% endif %}
diff --git a/translations/ja-JP/data/reusables/user_settings/about-commit-email-addresses.md b/translations/ja-JP/data/reusables/user_settings/about-commit-email-addresses.md
index 25b4ec2cb9e2..c1d07e76835b 100644
--- a/translations/ja-JP/data/reusables/user_settings/about-commit-email-addresses.md
+++ b/translations/ja-JP/data/reusables/user_settings/about-commit-email-addresses.md
@@ -1 +1 @@
-{% if currentVersion == "free-pro-team@latest" %}{% data variables.product.product_name %} が提供する`noreply`メールアドレスを含む{% endif %}コミットメールアドレスに関する詳しい情報については「[コミットメールアドレスの設定](/articles/setting-your-commit-email-address)」を参照してください。
+For more information on commit email addresses,{% if currentVersion == "free-pro-team@latest" %} including your {% data variables.product.product_name %}-provided `noreply` email address,{% endif %} see "[Setting your commit email address](/articles/setting-your-commit-email-address)."
diff --git a/translations/ja-JP/data/reusables/user_settings/export-data.md b/translations/ja-JP/data/reusables/user_settings/export-data.md
index e345cde1138e..857cba63b9c9 100644
--- a/translations/ja-JP/data/reusables/user_settings/export-data.md
+++ b/translations/ja-JP/data/reusables/user_settings/export-data.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-{% data variables.product.product_name %} が個人アカウントに関して保存するメタデータをエクスポートしてレビューできます。
+You can export and review the metadata that
+{% data variables.product.product_name %} stores about your personal account.
 {% endif %}
diff --git a/translations/ja-JP/data/reusables/user_settings/password-authentication-deprecation.md b/translations/ja-JP/data/reusables/user_settings/password-authentication-deprecation.md
index 3437d3825887..d64f46e5a86c 100644
--- a/translations/ja-JP/data/reusables/user_settings/password-authentication-deprecation.md
+++ b/translations/ja-JP/data/reusables/user_settings/password-authentication-deprecation.md
@@ -1 +1 @@
-Password-based authentication for Git is deprecated, and we recommend using a personal access token (PAT) when prompted for a password instead, which is more secure. Treat your token just like a password. 詳しい情報については、「[個人アクセストークンを作成する](/github/authenticating-to-github/creating-a-personal-access-token)」を参照してください。
\ No newline at end of file
+Password-based authentication for Git is deprecated, and we recommend using a personal access token (PAT) when prompted for a password instead, which is more secure. Treat your token just like a password. 詳しい情報については、「[個人アクセストークンを作成する](/github/authenticating-to-github/creating-a-personal-access-token)」を参照してください。
diff --git a/translations/ja-JP/data/reusables/user_settings/personal_dashboard.md b/translations/ja-JP/data/reusables/user_settings/personal_dashboard.md
index 5b52cf377c41..07083b821d07 100644
--- a/translations/ja-JP/data/reusables/user_settings/personal_dashboard.md
+++ b/translations/ja-JP/data/reusables/user_settings/personal_dashboard.md
@@ -1 +1 @@
-{% if currentVersion == "free-pro-team@latest" %}[personal dashboard（個人ダッシュボード）](https://github.com/dashboard){% else %}personal dashboard （個人ダッシュボード）(`https://[hostname]/dashboard`){% endif %}
+{% if currentVersion == "free-pro-team@latest" %}[personal dashboard](https://github.com/dashboard){% else %}personal dashboard (`https://[hostname]/dashboard`){% endif %}
diff --git a/translations/ja-JP/data/reusables/user_settings/set_your_email_address_in_git.md b/translations/ja-JP/data/reusables/user_settings/set_your_email_address_in_git.md
index 4da93da58430..5a5e1701cfef 100644
--- a/translations/ja-JP/data/reusables/user_settings/set_your_email_address_in_git.md
+++ b/translations/ja-JP/data/reusables/user_settings/set_your_email_address_in_git.md
@@ -1 +1 @@
-Gitでメールアドレスを設定してください。 {% if currentVersion == "free-pro-team@latest"%}[{% data variables.product.product_name %}が提供する`no-reply`メールアドレス](/articles/setting-your-commit-email-address)もしくは{% endif %}任意のメールアドレスが利用できます。
+Gitでメールアドレスを設定してください。 You can use {% if currentVersion == "free-pro-team@latest"%}your [{% data variables.product.product_name %}-provided `no-reply` email address](/articles/setting-your-commit-email-address) or {% endif %}any email address.
diff --git a/translations/ja-JP/data/reusables/user_settings/sudo-mode-popup.md b/translations/ja-JP/data/reusables/user_settings/sudo-mode-popup.md
index 193c8ede35f8..f76378972aa4 100644
--- a/translations/ja-JP/data/reusables/user_settings/sudo-mode-popup.md
+++ b/translations/ja-JP/data/reusables/user_settings/sudo-mode-popup.md
@@ -1 +1 @@
-1. {% data variables.product.product_name %} パスワードの確認を促された場合は、確認します。 ![sudo モードダイアログ](/assets/images/help/settings/sudo_mode_popup.png)
\ No newline at end of file
+1. {% data variables.product.product_name %} パスワードの確認を促された場合は、確認します。 ![sudo モードダイアログ](/assets/images/help/settings/sudo_mode_popup.png)
diff --git a/translations/ja-JP/data/reusables/webhooks/action_type_desc.md b/translations/ja-JP/data/reusables/webhooks/action_type_desc.md
index 3342e6e1c6ec..43e5cb80e4f5 100644
--- a/translations/ja-JP/data/reusables/webhooks/action_type_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/action_type_desc.md
@@ -1 +1 @@
-The type of activity is specified in the `action` property of the payload object.
\ No newline at end of file
+The type of activity is specified in the `action` property of the payload object.
diff --git a/translations/ja-JP/data/reusables/webhooks/app_desc.md b/translations/ja-JP/data/reusables/webhooks/app_desc.md
index 9dbfd79e4d6f..e81bab2cf4dc 100644
--- a/translations/ja-JP/data/reusables/webhooks/app_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/app_desc.md
@@ -1 +1 @@
-`installation` | `object` | The {% data variables.product.prodname_github_app %} installation. Webhook payloads contain the `installation` property when the event is configured for and sent to a {% data variables.product.prodname_github_app %}.
\ No newline at end of file
+`installation` | `object` | The {% data variables.product.prodname_github_app %} installation. Webhook payloads contain the `installation` property when the event is configured for and sent to a {% data variables.product.prodname_github_app %}.
diff --git a/translations/ja-JP/data/reusables/webhooks/check_run_properties.md b/translations/ja-JP/data/reusables/webhooks/check_run_properties.md
index d39ec4e3e8f9..f5a304e4dcb9 100644
--- a/translations/ja-JP/data/reusables/webhooks/check_run_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/check_run_properties.md
@@ -1,10 +1,10 @@
-| キー                             | 種類       | 説明                                                                                                                                                                                                                                                                                                                    |
-| ------------------------------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `action`                       | `string` | 実行されたアクション。 Can be one of: 
    •  `created` - A new check run was created.
    •  `completed` - The `status` of the check run is `completed`.
    •  `rerequested` - Someone requested to re-run your check run from the pull request UI. See "[About status checks](/articles/about-status-checks#checks)" for more details about the GitHub UI. When you receive a `rerequested` action, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run). Only the {% data variables.product.prodname_github_app %} that someone requests to re-run the check will receive the `rerequested` payload.
    •  `requested_action` - Someone requested an action your app provides to be taken. Only the {% data variables.product.prodname_github_app %} someone requests to perform an action will receive the `requested_action` payload. To learn more about check runs and requested actions, see "[Check runs and requested actions](/v3/checks/runs/#check-runs-and-requested-actions)."
                                                                                                                                                                                                                                                                       |
-| `check_run`                    | `オブジェクト` | The [check_run](/v3/checks/runs/#get-a-check-run).                                                                                                                                                                                                                                                                    |
-| `check_run[status]`            | `string` | The current status of the check run. Can be `queued`, `in_progress`, or `completed`.                                                                                                                                                                                                                                  |
+| キー                             | 種類       | 説明                                                                                                                                                                                                                                                                                                                                                        |
+| ------------------------------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `action`                       | `string` | 実行されたアクション。 Can be one of: 
    •  `created` - A new check run was created.
    •  `completed` - The `status` of the check run is `completed`.
    •  `rerequested` - Someone requested to re-run your check run from the pull request UI. See "[About status checks](/articles/about-status-checks#checks)" for more details about the GitHub UI. When you receive a `rerequested` action, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run). Only the {% data variables.product.prodname_github_app %} that someone requests to re-run the check will receive the `rerequested` payload.
    •  `requested_action` - Someone requested an action your app provides to be taken. Only the {% data variables.product.prodname_github_app %} someone requests to perform an action will receive the `requested_action` payload. To learn more about check runs and requested actions, see "[Check runs and requested actions](/v3/checks/runs/#check-runs-and-requested-actions)."
                                                                                                                                                                                                                                                                                                           |
+| `check_run`                    | `オブジェクト` | The [check_run](/v3/checks/runs/#get-a-check-run).                                                                                                                                                                                                                                                                                                        |
+| `check_run[status]`            | `string` | The current status of the check run. Can be `queued`, `in_progress`, or `completed`.                                                                                                                                                                                                                                                                      |
 | `check_run[conclusion]`        | `string` | The result of the completed check run. Can be one of `success`, `failure`, `neutral`, `cancelled`, `timed_out`,  {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}`action_required` or `stale`{% else %}or `action_required`{% endif %}. This value will be `null` until the check run has `completed`. |
-| `check_run[name]`              | `string` | The name of the check run.                                                                                                                                                                                                                                                                                            |
-| `check_run[check_suite][id]`   | `整数`     | The id of the check suite that this check run is part of.                                                                                                                                                                                                                                                             |
-| `requested_action`             | `オブジェクト` | The action requested by the user.                                                                                                                                                                                                                                                                                     |
-| `requested_action[identifier]` | `string` | The integrator reference of the action requested by the user.                                                                                                                                                                                                                                                         |
\ No newline at end of file
+| `check_run[name]`              | `string` | The name of the check run.                                                                                                                                                                                                                                                                                                                                |
+| `check_run[check_suite][id]`   | `整数`     | The id of the check suite that this check run is part of.                                                                                                                                                                                                                                                                                                 |
+| `requested_action`             | `オブジェクト` | The action requested by the user.                                                                                                                                                                                                                                                                                                                         |
+| `requested_action[identifier]` | `string` | The integrator reference of the action requested by the user.                                                                                                                                                                                                                                                                                             |
diff --git a/translations/ja-JP/data/reusables/webhooks/check_run_short_desc.md b/translations/ja-JP/data/reusables/webhooks/check_run_short_desc.md
index 305bd1626e33..19fd0846b885 100644
--- a/translations/ja-JP/data/reusables/webhooks/check_run_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/check_run_short_desc.md
@@ -1 +1 @@
-Check run activity has occurred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[check runs](/v3/checks/runs/)" REST API.
\ No newline at end of file
+Check run activity has occurred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[check runs](/v3/checks/runs/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/check_suite_properties.md b/translations/ja-JP/data/reusables/webhooks/check_suite_properties.md
index f09871e5a201..75de745ecb1e 100644
--- a/translations/ja-JP/data/reusables/webhooks/check_suite_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/check_suite_properties.md
@@ -1,10 +1,10 @@
-| キー                           | 種類       | 説明                                                                                                                                                                                                                                                                                                                                                         |
-| ---------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `action`                     | `string` | 実行されたアクション。 Can be:
    • `completed` - All check runs in a check suite have completed.
    • `requested` - Occurs when new code is pushed to the app's repository. When you receive the `requested` action events, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run).
    • `rerequested` - Occurs when someone requests to re-run the entire check suite from the pull request UI. When you receive the `rerequested` action events, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run). See "[About status checks](/articles/about-status-checks#checks)" for more details about the GitHub UI.
                                                                                                                                                                                                                                                                                                                   |
-| `check_suite`                | `オブジェクト` | The [check_suite](/v3/checks/suites/).                                                                                                                                                                                                                                                                                                                     |
-| `check_suite[head_branch]`   | `string` | The head branch name the changes are on.                                                                                                                                                                                                                                                                                                                   |
-| `check_suite[head_sha]`      | `string` | The SHA of the most recent commit for this check suite.                                                                                                                                                                                                                                                                                                    |
-| `check_suite[status]`        | `string` | The summary status for all check runs that are part of the check suite. Can be `requested`, `in_progress`, or `completed`.                                                                                                                                                                                                                                 |
+| キー                           | 種類       | 説明                                                                                                                                                                                                                                                                                                                                                                                             |
+| ---------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `action`                     | `string` | 実行されたアクション。 Can be:
    • `completed` - All check runs in a check suite have completed.
    • `requested` - Occurs when new code is pushed to the app's repository. When you receive the `requested` action events, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run).
    • `rerequested` - Occurs when someone requests to re-run the entire check suite from the pull request UI. When you receive the `rerequested` action events, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run). See "[About status checks](/articles/about-status-checks#checks)" for more details about the GitHub UI.
                                                                                                                                                                                                                                                                                                                                                       |
+| `check_suite`                | `オブジェクト` | The [check_suite](/v3/checks/suites/).                                                                                                                                                                                                                                                                                                                                                         |
+| `check_suite[head_branch]`   | `string` | The head branch name the changes are on.                                                                                                                                                                                                                                                                                                                                                       |
+| `check_suite[head_sha]`      | `string` | The SHA of the most recent commit for this check suite.                                                                                                                                                                                                                                                                                                                                        |
+| `check_suite[status]`        | `string` | The summary status for all check runs that are part of the check suite. Can be `requested`, `in_progress`, or `completed`.                                                                                                                                                                                                                                                                     |
 | `check_suite[conclusion]`    | `string` | The summary conclusion for all check runs that are part of the check suite. Can be one of `success`, `failure`, `neutral`, `cancelled`, `timed_out`,  {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}`action_required` or `stale`{% else %}or `action_required`{% endif %}. This value will be `null` until the check run has `completed`. |
-| `check_suite[url]`           | `string` | URL that points to the check suite API resource.                                                                                                                                                                                                                                                                                                           |
-| `check_suite[pull_requests]` | `array`  | An array of pull requests that match this check suite. A pull request matches a check suite if they have the same `head_sha` and `head_branch`. When the check suite's `head_branch` is in a forked repository it will be `null` and the `pull_requests` array will be empty.                                                                              |
\ No newline at end of file
+| `check_suite[url]`           | `string` | URL that points to the check suite API resource.                                                                                                                                                                                                                                                                                                                                               |
+| `check_suite[pull_requests]` | `array`  | An array of pull requests that match this check suite. A pull request matches a check suite if they have the same `head_sha` and `head_branch`. When the check suite's `head_branch` is in a forked repository it will be `null` and the `pull_requests` array will be empty.                                                                                                                  |
diff --git a/translations/ja-JP/data/reusables/webhooks/check_suite_short_desc.md b/translations/ja-JP/data/reusables/webhooks/check_suite_short_desc.md
index f7197fc59e48..00c4c00937f9 100644
--- a/translations/ja-JP/data/reusables/webhooks/check_suite_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/check_suite_short_desc.md
@@ -1 +1 @@
-Check suite activity has occurred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[check suites](/v3/checks/suites/)" REST API.
\ No newline at end of file
+Check suite activity has occurred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[check suites](/v3/checks/suites/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/code_scanning_alert_event_short_desc.md b/translations/ja-JP/data/reusables/webhooks/code_scanning_alert_event_short_desc.md
index e246022ed42e..e5163ce2d013 100644
--- a/translations/ja-JP/data/reusables/webhooks/code_scanning_alert_event_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/code_scanning_alert_event_short_desc.md
@@ -1 +1 @@
-Activity related to code scanning alerts in a repository. The type of activity is specified in the action property of the payload object. For more information, see “[About code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning).”
\ No newline at end of file
+Activity related to code scanning alerts in a repository. The type of activity is specified in the action property of the payload object. For more information, see “[About code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning).”
diff --git a/translations/ja-JP/data/reusables/webhooks/commit_comment_properties.md b/translations/ja-JP/data/reusables/webhooks/commit_comment_properties.md
index 4cc1cc367f83..e1e1ba4bc19f 100644
--- a/translations/ja-JP/data/reusables/webhooks/commit_comment_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/commit_comment_properties.md
@@ -1,4 +1,4 @@
 | キー       | 種類       | 説明                                                              |
 | -------- | -------- | --------------------------------------------------------------- |
 | `action` | `string` | 実行されたアクション。 `created `になりうる。                                    |
-| `コメント`   | `オブジェクト` | [commit comment](/v3/repos/comments/#get-a-commit-comment)リソース。 |
\ No newline at end of file
+| `コメント`   | `オブジェクト` | [commit comment](/v3/repos/comments/#get-a-commit-comment)リソース。 |
diff --git a/translations/ja-JP/data/reusables/webhooks/commit_comment_short_desc.md b/translations/ja-JP/data/reusables/webhooks/commit_comment_short_desc.md
index 918e0279b925..20e258a1ea1f 100644
--- a/translations/ja-JP/data/reusables/webhooks/commit_comment_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/commit_comment_short_desc.md
@@ -1 +1 @@
-A commit comment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[commit comment](/v3/repos/comments/)" REST API.
\ No newline at end of file
+A commit comment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[commit comment](/v3/repos/comments/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/content_reference_short_desc.md b/translations/ja-JP/data/reusables/webhooks/content_reference_short_desc.md
index b7880d039d3a..5187dbb40bc8 100644
--- a/translations/ja-JP/data/reusables/webhooks/content_reference_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/content_reference_short_desc.md
@@ -1 +1 @@
-A new content reference is `created`. A new content reference is created when the body or comment of an issue or pull request includes a URL that matches a configured content reference domain. For more information, see "[Using content attachments](/apps/using-content-attachments/)" to learn more about content references and attachments.
\ No newline at end of file
+A new content reference is `created`. A new content reference is created when the body or comment of an issue or pull request includes a URL that matches a configured content reference domain. For more information, see "[Using content attachments](/apps/using-content-attachments/)" to learn more about content references and attachments.
diff --git a/translations/ja-JP/data/reusables/webhooks/create_properties.md b/translations/ja-JP/data/reusables/webhooks/create_properties.md
index 8c2cf915fa84..b64d4fb3eff1 100644
--- a/translations/ja-JP/data/reusables/webhooks/create_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/create_properties.md
@@ -1,6 +1,6 @@
-| キー              | 種類       | 説明                                                                                                                                                                                 |
-| --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `ref`           | `string` | {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}[`git ref`](/v3/git/refs/#get-a-reference)リソース。{% else %}[`git ref`](/v3/git/refs/#get-a-reference)リソース。{% endif %}
-| `ref_type`      | `string` | リポジトリで作成されたGit refオブジェクトの種類。 `branch`もしくは`tag`になる。                                                                                                                                 |
-| `master_branch` | `string` | リポジトリのデフォルトブランチの名前（通常は`master`）。                                                                                                                                                   |
-| `説明`            | `string` | リポジトリの現在の説明。                                                                                                                                                                       |
\ No newline at end of file
+| キー              | 種類       | 説明                                                                                                                                                                                            |
+| --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `ref`           | `string` | The [`git ref`](/v3/git/refs/#get-a-reference) resource.                                                                                                                                      |
+| `ref_type`      | `string` | リポジトリで作成されたGit refオブジェクトの種類。 `branch`もしくは`tag`になる。                                                                                                                                            |
+| `master_branch` | `string` | The name of the repository's default branch (usually {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.23" %}`main`{% else %}`master`{% endif %}). |
+| `説明`            | `string` | リポジトリの現在の説明。                                                                                                                                                                                  |
diff --git a/translations/ja-JP/data/reusables/webhooks/create_short_desc.md b/translations/ja-JP/data/reusables/webhooks/create_short_desc.md
index 0140bfadf5c2..a43ab3994391 100644
--- a/translations/ja-JP/data/reusables/webhooks/create_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/create_short_desc.md
@@ -1 +1 @@
-A Git branch or tag is created. For more information, see the "[Git data](/v3/git/)" REST API.
\ No newline at end of file
+A Git branch or tag is created. For more information, see the "[Git data](/v3/git/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/delete_properties.md b/translations/ja-JP/data/reusables/webhooks/delete_properties.md
index 95c38329ad56..5febfb46d602 100644
--- a/translations/ja-JP/data/reusables/webhooks/delete_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/delete_properties.md
@@ -1,4 +1,4 @@
-| キー         | 種類       | 説明                                                                                                                                                                                 |
-| ---------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `ref`      | `string` | {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}[`git ref`](/v3/git/refs/#get-a-reference)リソース。{% else %}[`git ref`](/v3/git/refs/#get-a-reference)リソース。{% endif %}
-| `ref_type` | `string` | リポジトリで削除されたGit refオブジェクトの種類。 `branch`もしくは`tag`になる。                                                                                                                                 |
\ No newline at end of file
+| キー         | 種類       | 説明                                                       |
+| ---------- | -------- | -------------------------------------------------------- |
+| `ref`      | `string` | The [`git ref`](/v3/git/refs/#get-a-reference) resource. |
+| `ref_type` | `string` | リポジトリで削除されたGit refオブジェクトの種類。 `branch`もしくは`tag`になる。       |
diff --git a/translations/ja-JP/data/reusables/webhooks/delete_short_desc.md b/translations/ja-JP/data/reusables/webhooks/delete_short_desc.md
index 60568e8b0958..7557d8e4edb3 100644
--- a/translations/ja-JP/data/reusables/webhooks/delete_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/delete_short_desc.md
@@ -1 +1 @@
-A Git branch or tag is deleted. For more information, see the "[Git data](/v3/git/)" REST API.
\ No newline at end of file
+A Git branch or tag is deleted. For more information, see the "[Git data](/v3/git/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/deploy_key_properties.md b/translations/ja-JP/data/reusables/webhooks/deploy_key_properties.md
index 515e818b7321..75981d42a1ca 100644
--- a/translations/ja-JP/data/reusables/webhooks/deploy_key_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/deploy_key_properties.md
@@ -1,4 +1,4 @@
 | キー       | 種類       | 説明                                                             |
 | -------- | -------- | -------------------------------------------------------------- |
 | `action` | `string` | 実行されたアクション。 Can be either `created` or `deleted`.              |
-| `キー`     | `オブジェクト` | The [`deploy key`](/v3/repos/keys/#get-a-deploy-key) resource. |
\ No newline at end of file
+| `キー`     | `オブジェクト` | The [`deploy key`](/v3/repos/keys/#get-a-deploy-key) resource. |
diff --git a/translations/ja-JP/data/reusables/webhooks/deploy_key_short_desc.md b/translations/ja-JP/data/reusables/webhooks/deploy_key_short_desc.md
index 551eef44c5cc..c83fe68579c6 100644
--- a/translations/ja-JP/data/reusables/webhooks/deploy_key_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/deploy_key_short_desc.md
@@ -1 +1 @@
-A deploy key is added or removed from a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[Deploy keys](/v3/repos/keys/)" REST API.
\ No newline at end of file
+A deploy key is added or removed from a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[Deploy keys](/v3/repos/keys/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/deployment_short_desc.md b/translations/ja-JP/data/reusables/webhooks/deployment_short_desc.md
index 75683350b9df..249535a29dc8 100644
--- a/translations/ja-JP/data/reusables/webhooks/deployment_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/deployment_short_desc.md
@@ -1 +1 @@
-A deployment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[deployment](/v3/repos/deployments/#list-deployments)" REST API.
\ No newline at end of file
+A deployment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[deployment](/rest/reference/repos#list-deployments)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/deployment_status_short_desc.md b/translations/ja-JP/data/reusables/webhooks/deployment_status_short_desc.md
index 11953ea072e4..d58bd3e0efed 100644
--- a/translations/ja-JP/data/reusables/webhooks/deployment_status_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/deployment_status_short_desc.md
@@ -1 +1 @@
-A deployment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[deployment statuses](/v3/repos/deployments/#list-deployment-statuses)" REST API.
\ No newline at end of file
+A deployment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[deployment statuses](/rest/reference/repos#list-deployment-statuses)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/enterprise_short_desc.md b/translations/ja-JP/data/reusables/webhooks/enterprise_short_desc.md
index 999949bcbb50..07659be69c50 100644
--- a/translations/ja-JP/data/reusables/webhooks/enterprise_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/enterprise_short_desc.md
@@ -1 +1 @@
-A site or repository administrator enables or disables anonymous Git read access. See "[Allowing admins to enable anonymous Git read access to public repositories](/enterprise/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories)" for more details. This event is not available in the Events API.
\ No newline at end of file
+A site or repository administrator enables or disables anonymous Git read access. See "[Allowing admins to enable anonymous Git read access to public repositories](/enterprise/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories)" for more details. This event is not available in the Events API.
diff --git a/translations/ja-JP/data/reusables/webhooks/events_api_payload.md b/translations/ja-JP/data/reusables/webhooks/events_api_payload.md
index b40c9904faf8..d63dfb496eb9 100644
--- a/translations/ja-JP/data/reusables/webhooks/events_api_payload.md
+++ b/translations/ja-JP/data/reusables/webhooks/events_api_payload.md
@@ -1 +1 @@
-The [event object](#event-object-common-properties) includes properties that are common for all events. Each event object includes a `payload` property and the value is unique to each event type. The `payload` object for this event is described below.
\ No newline at end of file
+The [event object](#event-object-common-properties) includes properties that are common for all events. Each event object includes a `payload` property and the value is unique to each event type. The `payload` object for this event is described below.
diff --git a/translations/ja-JP/data/reusables/webhooks/fork_properties.md b/translations/ja-JP/data/reusables/webhooks/fork_properties.md
index 5714dfe8cb3c..840d5ff8c52c 100644
--- a/translations/ja-JP/data/reusables/webhooks/fork_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/fork_properties.md
@@ -1,3 +1,3 @@
 | キー       | 種類       | 説明                                                                |
 | -------- | -------- | ----------------------------------------------------------------- |
-| `forkee` | `オブジェクト` | The created [`repository`](/v3/repos/#get-a-repository) resource. |
\ No newline at end of file
+| `forkee` | `オブジェクト` | The created [`repository`](/v3/repos/#get-a-repository) resource. |
diff --git a/translations/ja-JP/data/reusables/webhooks/fork_short_desc.md b/translations/ja-JP/data/reusables/webhooks/fork_short_desc.md
index a294851f9c96..60f88625b01f 100644
--- a/translations/ja-JP/data/reusables/webhooks/fork_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/fork_short_desc.md
@@ -1 +1 @@
-A user forks a repository. For more information, see the "[forks](/v3/repos/forks/)" REST API.
\ No newline at end of file
+A user forks a repository. For more information, see the "[forks](/v3/repos/forks/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/gollum_properties.md b/translations/ja-JP/data/reusables/webhooks/gollum_properties.md
index 3ee8935b3d3d..50a88ec7ea9f 100644
--- a/translations/ja-JP/data/reusables/webhooks/gollum_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/gollum_properties.md
@@ -5,4 +5,4 @@
 | `pages[][title]`     | `string` | The current page title.                                                  |
 | `pages[][action]`    | `string` | The action that was performed on the page. Can be `created` or `edited`. |
 | `pages[][sha]`       | `string` | The latest commit SHA of the page.                                       |
-| `pages[][html_url]`  | `string` | Points to the HTML wiki page.                                            |
\ No newline at end of file
+| `pages[][html_url]`  | `string` | Points to the HTML wiki page.                                            |
diff --git a/translations/ja-JP/data/reusables/webhooks/gollum_short_desc.md b/translations/ja-JP/data/reusables/webhooks/gollum_short_desc.md
index 88d8dacb57e5..03bef9d2699c 100644
--- a/translations/ja-JP/data/reusables/webhooks/gollum_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/gollum_short_desc.md
@@ -1 +1 @@
-A wiki page is created or updated. For more information, see the "[About wikis](/github/building-a-strong-community/about-wikis)".
\ No newline at end of file
+A wiki page is created or updated. For more information, see the "[About wikis](/github/building-a-strong-community/about-wikis)".
diff --git a/translations/ja-JP/data/reusables/webhooks/installation_properties.md b/translations/ja-JP/data/reusables/webhooks/installation_properties.md
index 9caeb7f3c81a..e0a62845543c 100644
--- a/translations/ja-JP/data/reusables/webhooks/installation_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/installation_properties.md
@@ -1,4 +1,4 @@
 | キー             | 種類       | 説明                                                               |
 | -------------- | -------- | ---------------------------------------------------------------- |
 | `action`       | `string` | 実行されたアクション. Can be one of:
    • `created` - Someone installs a {% data variables.product.prodname_github_app %}.
    • `deleted` - Someone uninstalls a {% data variables.product.prodname_github_app %}
      • {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}
    • `suspend` - Someone suspends a {% data variables.product.prodname_github_app %} installation.
    • `unsuspend` - Someone unsuspends a {% data variables.product.prodname_github_app %} installation.
      • {% endif %}
    • `new_permissions_accepted` - Someone accepts new permissions for a {% data variables.product.prodname_github_app %} installation. When a {% data variables.product.prodname_github_app %} owner requests new permissions, the person who installed the {% data variables.product.prodname_github_app %} must accept the new permissions request. 
                  |
-| `repositories` | `array`  | An array of repository objects that the insatllation can access. |
\ No newline at end of file
+| `repositories` | `array`  | An array of repository objects that the insatllation can access. |
diff --git a/translations/ja-JP/data/reusables/webhooks/installation_repositories_properties.md b/translations/ja-JP/data/reusables/webhooks/installation_repositories_properties.md
index b676cf860ec4..e0ab22a8479c 100644
--- a/translations/ja-JP/data/reusables/webhooks/installation_repositories_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/installation_repositories_properties.md
@@ -3,4 +3,4 @@
 | `action`               | `string` | 実行されたアクション. Can be either `added` or `removed`.                                       |
 | `repository_selection` | `string` | The choice of repositories the installation is on. Can be either `selected` or `all`. |
 | `repositories_added`   | `array`  | An array of repository objects, which were added to the installation.                 |
-| `repositories_removed` | `array`  | An array of repository objects, which were removed from the installation.             |
\ No newline at end of file
+| `repositories_removed` | `array`  | An array of repository objects, which were removed from the installation.             |
diff --git a/translations/ja-JP/data/reusables/webhooks/installation_repositories_short_desc.md b/translations/ja-JP/data/reusables/webhooks/installation_repositories_short_desc.md
index b01eeca22efe..63166ba6e220 100644
--- a/translations/ja-JP/data/reusables/webhooks/installation_repositories_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/installation_repositories_short_desc.md
@@ -1 +1 @@
-Activity related to repositories being added to a GitHub App installation. {% data reusables.webhooks.action_type_desc %} For more information, see the "[GitHub App installation](/v3/apps/)" REST API.
\ No newline at end of file
+Activity related to repositories being added to a GitHub App installation. {% data reusables.webhooks.action_type_desc %} For more information, see the "[GitHub App installation](/v3/apps/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/installation_short_desc.md b/translations/ja-JP/data/reusables/webhooks/installation_short_desc.md
index 0a19aef9b5d0..4abc1de643b4 100644
--- a/translations/ja-JP/data/reusables/webhooks/installation_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/installation_short_desc.md
@@ -1 +1 @@
-Activity related to a GitHub App installation. {% data reusables.webhooks.action_type_desc %} For more information, see the "[GitHub App installation](/v3/apps/)" REST API.
\ No newline at end of file
+Activity related to a GitHub App installation. {% data reusables.webhooks.action_type_desc %} For more information, see the "[GitHub App installation](/v3/apps/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/issue_comment_properties.md b/translations/ja-JP/data/reusables/webhooks/issue_comment_properties.md
index 63587d4c1426..a1ae73ab6272 100644
--- a/translations/ja-JP/data/reusables/webhooks/issue_comment_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/issue_comment_properties.md
@@ -1 +1 @@
-`changes`|`object` | The changes to the comment if the action was `edited`. `changes[body][from]` |`string` | アクションが`edited`だった場合の、以前のバージョンのbody。 `issue`|`object` | The [issue](/v3/issues/) the comment belongs to. `comment`|`object` | The [comment](/v3/issues/comments/) itself.
\ No newline at end of file
+`changes`|`object` | The changes to the comment if the action was `edited`. `changes[body][from]` |`string` | アクションが`edited`だった場合の、以前のバージョンのbody。 `issue`|`object` | The [issue](/v3/issues/) the comment belongs to. `comment`|`object` | The [comment](/v3/issues/comments/) itself.
diff --git a/translations/ja-JP/data/reusables/webhooks/issue_comment_short_desc.md b/translations/ja-JP/data/reusables/webhooks/issue_comment_short_desc.md
index 0c12ec707b62..cc07764d1919 100644
--- a/translations/ja-JP/data/reusables/webhooks/issue_comment_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/issue_comment_short_desc.md
@@ -1 +1 @@
-Activity related to an issue comment. {% data reusables.webhooks.action_type_desc %} For more information, see the "[issue comments](/v3/issues/comments/)" REST API.
\ No newline at end of file
+Activity related to an issue comment. {% data reusables.webhooks.action_type_desc %} For more information, see the "[issue comments](/v3/issues/comments/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/issue_comment_webhook_properties.md b/translations/ja-JP/data/reusables/webhooks/issue_comment_webhook_properties.md
index 0034c0c87746..58ed157537b1 100644
--- a/translations/ja-JP/data/reusables/webhooks/issue_comment_webhook_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/issue_comment_webhook_properties.md
@@ -1,3 +1,3 @@
 | キー       | 種類       | 説明                                                                                             |
 | -------- | -------- | ---------------------------------------------------------------------------------------------- |
-| `action` | `string` | The action that was performed on the comment. Can be one of `created`, `edited`, or `deleted`. |
\ No newline at end of file
+| `action` | `string` | The action that was performed on the comment. Can be one of `created`, `edited`, or `deleted`. |
diff --git a/translations/ja-JP/data/reusables/webhooks/issue_event_api_properties.md b/translations/ja-JP/data/reusables/webhooks/issue_event_api_properties.md
index ed39947d794e..7388a8400916 100644
--- a/translations/ja-JP/data/reusables/webhooks/issue_event_api_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/issue_event_api_properties.md
@@ -1,3 +1,3 @@
 | キー       | 種類       | 説明                                                                                                             |
 | -------- | -------- | -------------------------------------------------------------------------------------------------------------- |
-| `action` | `string` | 実行されたアクション. Can be one of `opened`, `closed`, `reopened`, `assigned`, `unassigned`, `labeled`, or `unlabeled`. |
\ No newline at end of file
+| `action` | `string` | 実行されたアクション. Can be one of `opened`, `closed`, `reopened`, `assigned`, `unassigned`, `labeled`, or `unlabeled`. |
diff --git a/translations/ja-JP/data/reusables/webhooks/issue_properties.md b/translations/ja-JP/data/reusables/webhooks/issue_properties.md
index 84db05eb2bfe..c146faa96802 100644
--- a/translations/ja-JP/data/reusables/webhooks/issue_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/issue_properties.md
@@ -1 +1 @@
-`issue`|`object` | The [issue](/v3/issues) itself. `changes`|`object`| The changes to the issue if the action was `edited`. `changes[title][from]`|`string` | The previous version of the title if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `assignee`|`object` | The optional user who was assigned or unassigned from the issue. `label`|`object` | The optional label that was added or removed from the issue.
\ No newline at end of file
+`issue`|`object` | The [issue](/v3/issues) itself. `changes`|`object`| The changes to the issue if the action was `edited`. `changes[title][from]`|`string` | The previous version of the title if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `assignee`|`object` | The optional user who was assigned or unassigned from the issue. `label`|`object` | The optional label that was added or removed from the issue.
diff --git a/translations/ja-JP/data/reusables/webhooks/issue_webhook_properties.md b/translations/ja-JP/data/reusables/webhooks/issue_webhook_properties.md
index fb8c25115bb0..010aef01e37f 100644
--- a/translations/ja-JP/data/reusables/webhooks/issue_webhook_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/issue_webhook_properties.md
@@ -1,3 +1,3 @@
 | キー       | 種類       | 説明                                                                                                                                                                                                                            |
 | -------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `action` | `string` | 実行されたアクション. Can be one of `opened`, `edited`, `deleted`, `pinned`, `unpinned`, `closed`, `reopened`, `assigned`, `unassigned`, `labeled`, `unlabeled`, `locked`, `unlocked`,  `transferred`, `milestoned`, or `demilestoned`. |
\ No newline at end of file
+| `action` | `string` | 実行されたアクション. Can be one of `opened`, `edited`, `deleted`, `pinned`, `unpinned`, `closed`, `reopened`, `assigned`, `unassigned`, `labeled`, `unlabeled`, `locked`, `unlocked`,  `transferred`, `milestoned`, or `demilestoned`. |
diff --git a/translations/ja-JP/data/reusables/webhooks/issues_short_desc.md b/translations/ja-JP/data/reusables/webhooks/issues_short_desc.md
index fea9fc0cfcd8..7dadec073bb6 100644
--- a/translations/ja-JP/data/reusables/webhooks/issues_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/issues_short_desc.md
@@ -1 +1 @@
-Activity related to an issue. {% data reusables.webhooks.action_type_desc %} For more information, see the "[issues](/v3/issues/comments/)" REST API.
\ No newline at end of file
+Activity related to an issue. {% data reusables.webhooks.action_type_desc %} For more information, see the "[issues](/v3/issues/comments/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/label_short_desc.md b/translations/ja-JP/data/reusables/webhooks/label_short_desc.md
index ca095139a6d2..c5f7178d8a4c 100644
--- a/translations/ja-JP/data/reusables/webhooks/label_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/label_short_desc.md
@@ -1 +1 @@
-Activity related to an issue. {% data reusables.webhooks.action_type_desc %} For more information, see the "[labels](/v3/issues/labels/)" REST API.
\ No newline at end of file
+Activity related to an issue. {% data reusables.webhooks.action_type_desc %} For more information, see the "[labels](/v3/issues/labels/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/member_event_api_properties.md b/translations/ja-JP/data/reusables/webhooks/member_event_api_properties.md
index 04ce9f12f5a9..0cb5875d9d53 100644
--- a/translations/ja-JP/data/reusables/webhooks/member_event_api_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/member_event_api_properties.md
@@ -1,3 +1,3 @@
 | キー       | 種類       | 説明                                                                                    |
 | -------- | -------- | ------------------------------------------------------------------------------------- |
-| `action` | `string` | 実行されたアクション. Can be `added` to indicate a user accepted an invitation to a repository. |
\ No newline at end of file
+| `action` | `string` | 実行されたアクション. Can be `added` to indicate a user accepted an invitation to a repository. |
diff --git a/translations/ja-JP/data/reusables/webhooks/member_properties.md b/translations/ja-JP/data/reusables/webhooks/member_properties.md
index 7fde9d65f4b7..d9e1757f404e 100644
--- a/translations/ja-JP/data/reusables/webhooks/member_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/member_properties.md
@@ -1 +1 @@
-`member`|`object` | The [user](/v3/users/) that was added. `changes`|`object`| The changes to the collaborator permissions if the action was `edited`. `changes[old_permission][from]`|`string` | The previous permissions of the collaborator if the action was `edited`.
\ No newline at end of file
+`member`|`object` | The [user](/v3/users/) that was added. `changes`|`object`| The changes to the collaborator permissions if the action was `edited`. `changes[old_permission][from]`|`string` | The previous permissions of the collaborator if the action was `edited`.
diff --git a/translations/ja-JP/data/reusables/webhooks/member_short_desc.md b/translations/ja-JP/data/reusables/webhooks/member_short_desc.md
index 9447f245ed0a..2e8289677381 100644
--- a/translations/ja-JP/data/reusables/webhooks/member_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/member_short_desc.md
@@ -1 +1 @@
-Activity related to repository collaborators. {% data reusables.webhooks.action_type_desc %} For more information, see the "[collaborators](/v3/repos/collaborators/)" REST API.
\ No newline at end of file
+Activity related to repository collaborators. {% data reusables.webhooks.action_type_desc %} For more information, see the "[collaborators](/v3/repos/collaborators/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/member_webhook_properties.md b/translations/ja-JP/data/reusables/webhooks/member_webhook_properties.md
index 6aadcc788312..6e75ac2794e1 100644
--- a/translations/ja-JP/data/reusables/webhooks/member_webhook_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/member_webhook_properties.md
@@ -1,3 +1,3 @@
 | キー       | 種類       | 説明                                                  |
 | -------- | -------- | --------------------------------------------------- |
-| `action` | `string` | 実行されたアクション. Can be one of:
    •  `added` - A user accepts an invitation to a repository.
    • `removed` - A user is removed as a collaborator in a repository.
    • `edited` - A user's collaborator permissios have changed. 
     |
\ No newline at end of file
+| `action` | `string` | 実行されたアクション. Can be one of:
    •  `added` - A user accepts an invitation to a repository.
    • `removed` - A user is removed as a collaborator in a repository.
    • `edited` - A user's collaborator permissios have changed. 
     |
diff --git a/translations/ja-JP/data/reusables/webhooks/membership_properties.md b/translations/ja-JP/data/reusables/webhooks/membership_properties.md
index aade023862fe..770442be84d9 100644
--- a/translations/ja-JP/data/reusables/webhooks/membership_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/membership_properties.md
@@ -3,4 +3,4 @@
 | `action` | `string` | 実行されたアクション. Can be `added` or `removed`.                    |
 | `スコープ`   | `string` | The scope of the membership. Currently, can only be `team`. |
 | `member` | `オブジェクト` | The [user](/v3/users/) that was added or removed.           |
-| `Team`   | `オブジェクト` | The [team](/v3/teams/) for the membership.                  |
\ No newline at end of file
+| `Team`   | `オブジェクト` | The [team](/v3/teams/) for the membership.                  |
diff --git a/translations/ja-JP/data/reusables/webhooks/membership_short_desc.md b/translations/ja-JP/data/reusables/webhooks/membership_short_desc.md
index 4ffa7e0d72c0..e557eea9026a 100644
--- a/translations/ja-JP/data/reusables/webhooks/membership_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/membership_short_desc.md
@@ -1 +1 @@
-Activity related to team membership. {% data reusables.webhooks.action_type_desc %} For more information, see the "[team members](/v3/teams/members/)" REST API.
\ No newline at end of file
+Activity related to team membership. {% data reusables.webhooks.action_type_desc %} For more information, see the "[team members](/v3/teams/members/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/milestone_properties.md b/translations/ja-JP/data/reusables/webhooks/milestone_properties.md
index 533f87d05753..7bfcb866158d 100644
--- a/translations/ja-JP/data/reusables/webhooks/milestone_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/milestone_properties.md
@@ -5,4 +5,4 @@
 | `変更`                         | `オブジェクト` | The changes to the milestone if the action was `edited`.                         |
 | `changes[description][from]` | `string` | The previous version of the description if the action was `edited`.              |
 | `changes[due_on][from]`      | `string` | The previous version of the due date if the action was `edited`.                 |
-| `changes[title][from]`       | `string` | The previous version of the title if the action was `edited`.                    |
\ No newline at end of file
+| `changes[title][from]`       | `string` | The previous version of the title if the action was `edited`.                    |
diff --git a/translations/ja-JP/data/reusables/webhooks/milestone_short_desc.md b/translations/ja-JP/data/reusables/webhooks/milestone_short_desc.md
index 0e6f857a512a..6b6bd073ceab 100644
--- a/translations/ja-JP/data/reusables/webhooks/milestone_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/milestone_short_desc.md
@@ -1 +1 @@
-Activity related to milestones. {% data reusables.webhooks.action_type_desc %} For more information, see the "[milestones](/v3/issues/milestones/)" REST API.
\ No newline at end of file
+Activity related to milestones. {% data reusables.webhooks.action_type_desc %} For more information, see the "[milestones](/v3/issues/milestones/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/org_block_short_desc.md b/translations/ja-JP/data/reusables/webhooks/org_block_short_desc.md
index 379de19da9fc..7c3896f63c8d 100644
--- a/translations/ja-JP/data/reusables/webhooks/org_block_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/org_block_short_desc.md
@@ -1 +1 @@
-Activity related to people being blocked in an organization. {% data reusables.webhooks.action_type_desc %} For more information, see the "[blocking organization users](/v3/orgs/blocking/)" REST API.
\ No newline at end of file
+Activity related to people being blocked in an organization. {% data reusables.webhooks.action_type_desc %} For more information, see the "[blocking organization users](/v3/orgs/blocking/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/org_desc.md b/translations/ja-JP/data/reusables/webhooks/org_desc.md
index e763e6d6b614..8b344e764cde 100644
--- a/translations/ja-JP/data/reusables/webhooks/org_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/org_desc.md
@@ -1 +1 @@
-`organization` | `object` | Webhook payloads contain the [`organization`](/v3/orgs/#get-an-organization) object when the webhook is configured for an organization or the event occurs from activity in a repository owned by an organization.
\ No newline at end of file
+`organization` | `object` | Webhook payloads contain the [`organization`](/v3/orgs/#get-an-organization) object when the webhook is configured for an organization or the event occurs from activity in a repository owned by an organization.
diff --git a/translations/ja-JP/data/reusables/webhooks/organization_short_desc.md b/translations/ja-JP/data/reusables/webhooks/organization_short_desc.md
index 131d20fc3de8..895b584aaf26 100644
--- a/translations/ja-JP/data/reusables/webhooks/organization_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/organization_short_desc.md
@@ -1 +1 @@
-Activity related to an organization and its members. {% data reusables.webhooks.action_type_desc %} For more information, see the "[organizations](/v3/orgs/)" REST API.
\ No newline at end of file
+Activity related to an organization and its members. {% data reusables.webhooks.action_type_desc %} For more information, see the "[organizations](/v3/orgs/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/package_properties.md b/translations/ja-JP/data/reusables/webhooks/package_properties.md
index ed5df342a068..231b9e34aead 100644
--- a/translations/ja-JP/data/reusables/webhooks/package_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/package_properties.md
@@ -1,4 +1,4 @@
 | キー        | 種類       | 説明                                           |
 | --------- | -------- | -------------------------------------------- |
 | `action`  | `string` | 実行されたアクション. Can be `published` or `updated`. |
-| `package` | `オブジェクト` | Information about the package.               |
\ No newline at end of file
+| `package` | `オブジェクト` | Information about the package.               |
diff --git a/translations/ja-JP/data/reusables/webhooks/page_build_short_desc.md b/translations/ja-JP/data/reusables/webhooks/page_build_short_desc.md
index 7c5be712c388..dda5755d8870 100644
--- a/translations/ja-JP/data/reusables/webhooks/page_build_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/page_build_short_desc.md
@@ -1 +1 @@
-Represents an attempted build of a GitHub Pages site, whether successful or not. A push to a GitHub Pages enabled branch (`gh-pages` for project pages, `master` for user and organization pages) triggers this event.
\ No newline at end of file
+Represents an attempted build of a {% data variables.product.prodname_pages %} site, whether successful or not. A push to a {% data variables.product.prodname_pages %} enabled branch (`gh-pages` for project pages, the default branch for user and organization pages) triggers this event.
diff --git a/translations/ja-JP/data/reusables/webhooks/payload_url.md b/translations/ja-JP/data/reusables/webhooks/payload_url.md
index 3a3fde655ce3..f48cdfee0e5c 100644
--- a/translations/ja-JP/data/reusables/webhooks/payload_url.md
+++ b/translations/ja-JP/data/reusables/webhooks/payload_url.md
@@ -1 +1 @@
-The payload URL is the URL of the server that will receive the webhook `POST` requests.
\ No newline at end of file
+The payload URL is the URL of the server that will receive the webhook `POST` requests.
diff --git a/translations/ja-JP/data/reusables/webhooks/ping_short_desc.md b/translations/ja-JP/data/reusables/webhooks/ping_short_desc.md
index 41986f6a5dc7..862ace3a6c90 100644
--- a/translations/ja-JP/data/reusables/webhooks/ping_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/ping_short_desc.md
@@ -1 +1 @@
-新しいwebhookが作成されると、シンプルな`ping`イベントが送信され、webhookが正しくセットアップされたことを知らせます。 このイベントは保存されないので、[Events API](/v3/activity/events/)を通じて取り出すことはできません。 [Ping a repository webhook](/v3/repos/hooks/#ping-a-repository-webhook)エンドポイントを呼べば、`ping`をもう一度トリガーできます。
+新しいwebhookが作成されると、シンプルな`ping`イベントが送信され、webhookが正しくセットアップされたことを知らせます。 This event isnt stored so it isn't retrievable via the [Events API](/rest/reference/activity#ping-a-repository-webhook) endpoint.
diff --git a/translations/ja-JP/data/reusables/webhooks/project_card_properties.md b/translations/ja-JP/data/reusables/webhooks/project_card_properties.md
index 36b1c6ae5687..386b7fb63ed2 100644
--- a/translations/ja-JP/data/reusables/webhooks/project_card_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/project_card_properties.md
@@ -4,4 +4,4 @@
 | `変更`                  | `オブジェクト` | The changes to the project card if the action was `edited` or `converted`.                                                   |
 | `changes[note][from]` | `string` | The previous version of the note if the action was `edited` or `converted`.                                                  |
 | `after_id`            | `整数`     | The id of the card that this card now follows if the action was "moved". Will be `null` if it is the first card in a column. |
-| `project_card`        | `オブジェクト` | The [project card](/v3/projects/cards) itself.                                                                               |
\ No newline at end of file
+| `project_card`        | `オブジェクト` | The [project card](/v3/projects/cards) itself.                                                                               |
diff --git a/translations/ja-JP/data/reusables/webhooks/project_card_short_desc.md b/translations/ja-JP/data/reusables/webhooks/project_card_short_desc.md
index 3a474c89ecee..bbea9ea6c407 100644
--- a/translations/ja-JP/data/reusables/webhooks/project_card_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/project_card_short_desc.md
@@ -1 +1 @@
-Activity related to project cards. {% data reusables.webhooks.action_type_desc %} For more information, see the "[project cards](/v3/projects/cards)" REST API.
\ No newline at end of file
+Activity related to project cards. {% data reusables.webhooks.action_type_desc %} For more information, see the "[project cards](/v3/projects/cards)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/project_column_properties.md b/translations/ja-JP/data/reusables/webhooks/project_column_properties.md
index c11d36bfc8c2..401b11b24575 100644
--- a/translations/ja-JP/data/reusables/webhooks/project_column_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/project_column_properties.md
@@ -4,4 +4,4 @@
 | `変更`                  | `オブジェクト` | The changes to the project column if the action was `edited`.                                                                       |
 | `changes[name][from]` | `string` | The previous version of the name if the action was `edited`.                                                                        |
 | `after_id`            | `整数`     | The id of the column that this column now follows if the action was "moved". Will be `null` if it is the first column in a project. |
-| `project_column`      | `オブジェクト` | The [project column](/v3/projects/columns) itself.                                                                                  |
\ No newline at end of file
+| `project_column`      | `オブジェクト` | The [project column](/v3/projects/columns) itself.                                                                                  |
diff --git a/translations/ja-JP/data/reusables/webhooks/project_column_short_desc.md b/translations/ja-JP/data/reusables/webhooks/project_column_short_desc.md
index 31cc257267b0..19ac3f6412c8 100644
--- a/translations/ja-JP/data/reusables/webhooks/project_column_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/project_column_short_desc.md
@@ -1 +1 @@
-Activity related to columns in a project board. {% data reusables.webhooks.action_type_desc %} For more information, see the "[project columns](/v3/projects/columns)" REST API.
\ No newline at end of file
+Activity related to columns in a project board. {% data reusables.webhooks.action_type_desc %} For more information, see the "[project columns](/v3/projects/columns)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/project_properties.md b/translations/ja-JP/data/reusables/webhooks/project_properties.md
index 6aa727752df4..acd6b65d3d29 100644
--- a/translations/ja-JP/data/reusables/webhooks/project_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/project_properties.md
@@ -4,4 +4,4 @@
 | `変更`                  | `オブジェクト` | The changes to the project if the action was `edited`.                                                               |
 | `changes[name][from]` | `string` | The previous version of the name if the action was `edited`.                                                         |
 | `changes[body][from]` | `string` | The previous version of the body if the action was `edited`.                                                         |
-| `project`             | `オブジェクト` | The [project](/v3/projects/) itself.                                                                                 |
\ No newline at end of file
+| `project`             | `オブジェクト` | The [project](/v3/projects/) itself.                                                                                 |
diff --git a/translations/ja-JP/data/reusables/webhooks/project_short_desc.md b/translations/ja-JP/data/reusables/webhooks/project_short_desc.md
index c5f8a804a47c..6f18da5d6957 100644
--- a/translations/ja-JP/data/reusables/webhooks/project_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/project_short_desc.md
@@ -1 +1 @@
-Activity related to project boards. {% data reusables.webhooks.action_type_desc %} For more information, see the "[projects](/v3/projects)" REST API.
\ No newline at end of file
+Activity related to project boards. {% data reusables.webhooks.action_type_desc %} For more information, see the "[projects](/v3/projects)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/public_short_desc.md b/translations/ja-JP/data/reusables/webhooks/public_short_desc.md
index 925a4bfeddc5..9333dc3841cc 100644
--- a/translations/ja-JP/data/reusables/webhooks/public_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/public_short_desc.md
@@ -1 +1 @@
-When a private repository is made public.  Without a doubt: the best {% data variables.product.product_name %} event. 
\ No newline at end of file
+When a private repository is made public.  Without a doubt: the best {% data variables.product.product_name %} event. 
diff --git a/translations/ja-JP/data/reusables/webhooks/pull_request_event_api_properties.md b/translations/ja-JP/data/reusables/webhooks/pull_request_event_api_properties.md
index 2cefb79ea0ad..8f68bd46814e 100644
--- a/translations/ja-JP/data/reusables/webhooks/pull_request_event_api_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/pull_request_event_api_properties.md
@@ -1,3 +1,3 @@
 | キー       | 種類       | 説明                                                                                                                                                                           |
 | -------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `action` | `string` | 実行されたアクション. Can be one of `opened`, `closed`, `reopened`, `assigned`, `unassigned`, `review_requested`, `review_request_removed`, `labeled`, `unlabeled`, and `synchronize`. |
\ No newline at end of file
+| `action` | `string` | 実行されたアクション. Can be one of `opened`, `closed`, `reopened`, `assigned`, `unassigned`, `review_requested`, `review_request_removed`, `labeled`, `unlabeled`, and `synchronize`. |
diff --git a/translations/ja-JP/data/reusables/webhooks/pull_request_properties.md b/translations/ja-JP/data/reusables/webhooks/pull_request_properties.md
index b2619258bb68..21544ccd9e8d 100644
--- a/translations/ja-JP/data/reusables/webhooks/pull_request_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/pull_request_properties.md
@@ -1 +1 @@
-`number`|`integer` | The pull request number. `changes`|`object`| The changes to the comment if the action was `edited`. `changes[title][from]`|`string` | The previous version of the title if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `pull_request`|`object` | The [pull request](/v3/pulls) itself.
\ No newline at end of file
+`number`|`integer` | The pull request number. `changes`|`object`| The changes to the comment if the action was `edited`. `changes[title][from]`|`string` | The previous version of the title if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `pull_request`|`object` | The [pull request](/v3/pulls) itself.
diff --git a/translations/ja-JP/data/reusables/webhooks/pull_request_review_comment_event_api_properties.md b/translations/ja-JP/data/reusables/webhooks/pull_request_review_comment_event_api_properties.md
index 880273148312..e606eabb55a0 100644
--- a/translations/ja-JP/data/reusables/webhooks/pull_request_review_comment_event_api_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/pull_request_review_comment_event_api_properties.md
@@ -1,3 +1,3 @@
 | キー       | 種類       | 説明                                                             |
 | -------- | -------- | -------------------------------------------------------------- |
-| `action` | `string` | The action that was performed on the comment. `created `になりうる。 |
\ No newline at end of file
+| `action` | `string` | The action that was performed on the comment. `created `になりうる。 |
diff --git a/translations/ja-JP/data/reusables/webhooks/pull_request_review_comment_properties.md b/translations/ja-JP/data/reusables/webhooks/pull_request_review_comment_properties.md
index 85341dd38525..a38df37d8c7d 100644
--- a/translations/ja-JP/data/reusables/webhooks/pull_request_review_comment_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/pull_request_review_comment_properties.md
@@ -1 +1 @@
-`changes`|`object`| The changes to the comment if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `pull_request`|`object` | The [pull request](/v3/pulls/) the comment belongs to. `comment`|`object` | The [comment](/v3/pulls/comments) itself.
\ No newline at end of file
+`changes`|`object`| The changes to the comment if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `pull_request`|`object` | The [pull request](/v3/pulls/) the comment belongs to. `comment`|`object` | The [comment](/v3/pulls/comments) itself.
diff --git a/translations/ja-JP/data/reusables/webhooks/pull_request_review_comment_short_desc.md b/translations/ja-JP/data/reusables/webhooks/pull_request_review_comment_short_desc.md
index 0dbf1f6974da..7b05ee9a9a19 100644
--- a/translations/ja-JP/data/reusables/webhooks/pull_request_review_comment_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/pull_request_review_comment_short_desc.md
@@ -1 +1 @@
-Activity related to pull request review comments in the pull request's unified diff. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull request review comments](/v3/pulls/comments/)" REST API.
\ No newline at end of file
+Activity related to pull request review comments in the pull request's unified diff. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull request review comments](/v3/pulls/comments/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/pull_request_review_comment_webhook_properties.md b/translations/ja-JP/data/reusables/webhooks/pull_request_review_comment_webhook_properties.md
index 0034c0c87746..58ed157537b1 100644
--- a/translations/ja-JP/data/reusables/webhooks/pull_request_review_comment_webhook_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/pull_request_review_comment_webhook_properties.md
@@ -1,3 +1,3 @@
 | キー       | 種類       | 説明                                                                                             |
 | -------- | -------- | ---------------------------------------------------------------------------------------------- |
-| `action` | `string` | The action that was performed on the comment. Can be one of `created`, `edited`, or `deleted`. |
\ No newline at end of file
+| `action` | `string` | The action that was performed on the comment. Can be one of `created`, `edited`, or `deleted`. |
diff --git a/translations/ja-JP/data/reusables/webhooks/pull_request_review_properties.md b/translations/ja-JP/data/reusables/webhooks/pull_request_review_properties.md
index e67510cb6288..df38b34ad799 100644
--- a/translations/ja-JP/data/reusables/webhooks/pull_request_review_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/pull_request_review_properties.md
@@ -3,4 +3,4 @@
 | `action`              | `string` | 実行されたアクション. Can be one of:
    • `submitted` - A pull request review is submitted into a non-pending state.
    • `edited` - The body of a review has been edited.
    • `dismissed` - A review has been dismissed.
              |
 | `pull_request`        | `オブジェクト` | The [pull request](/v3/pulls/) the review pertains to.       |
 | `レビュー`                | `オブジェクト` | The review that was affected.                                |
-| `changes[body][from]` | `string` | The previous version of the body if the action was `edited`. |
\ No newline at end of file
+| `changes[body][from]` | `string` | The previous version of the body if the action was `edited`. |
diff --git a/translations/ja-JP/data/reusables/webhooks/pull_request_review_short_desc.md b/translations/ja-JP/data/reusables/webhooks/pull_request_review_short_desc.md
index a92f0dd3bb24..07b263364d7f 100644
--- a/translations/ja-JP/data/reusables/webhooks/pull_request_review_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/pull_request_review_short_desc.md
@@ -1 +1 @@
-Activity related to pull request reviews. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull request reviews](/v3/pulls/reviews/)" REST API.
\ No newline at end of file
+Activity related to pull request reviews. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull request reviews](/v3/pulls/reviews/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/pull_request_short_desc.md b/translations/ja-JP/data/reusables/webhooks/pull_request_short_desc.md
index c88a5120c8f4..ea9e435d0328 100644
--- a/translations/ja-JP/data/reusables/webhooks/pull_request_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/pull_request_short_desc.md
@@ -1 +1 @@
-Activity related to pull requests. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull requests](/v3/pulls/)" REST API.
\ No newline at end of file
+Activity related to pull requests. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull requests](/v3/pulls/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/pull_request_webhook_properties.md b/translations/ja-JP/data/reusables/webhooks/pull_request_webhook_properties.md
index b595a1ac3466..e6571e457a86 100644
--- a/translations/ja-JP/data/reusables/webhooks/pull_request_webhook_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/pull_request_webhook_properties.md
@@ -1,3 +1,3 @@
 | キー       | 種類       | 説明                                                                                                                                                                                                                                                                                                                                                                                                                                    |
 | -------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `action` | `string` | 実行されたアクション. Can be one of  `opened`, `edited`, `closed`, `assigned`, `unassigned`, `review_requested`, `review_request_removed`, `ready_for_review`, `labeled`, `unlabeled`, `synchronize`, `locked`, `unlocked`, or `reopened`. If the action is `closed` and the `merged` key is `false`, the pull request was closed with unmerged commits. If the action is `closed` and the `merged` key is `true`, the pull request was merged. |
\ No newline at end of file
+| `action` | `string` | 実行されたアクション. Can be one of  `opened`, `edited`, `closed`, `assigned`, `unassigned`, `review_requested`, `review_request_removed`, `ready_for_review`, `labeled`, `unlabeled`, `synchronize`, `locked`, `unlocked`, or `reopened`. If the action is `closed` and the `merged` key is `false`, the pull request was closed with unmerged commits. If the action is `closed` and the `merged` key is `true`, the pull request was merged. |
diff --git a/translations/ja-JP/data/reusables/webhooks/push_short_desc.md b/translations/ja-JP/data/reusables/webhooks/push_short_desc.md
index 53583a273873..9d434a42fb49 100644
--- a/translations/ja-JP/data/reusables/webhooks/push_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/push_short_desc.md
@@ -1 +1 @@
-One or more commits are pushed to a repository branch or tag.
\ No newline at end of file
+One or more commits are pushed to a repository branch or tag.
diff --git a/translations/ja-JP/data/reusables/webhooks/release_event_api_properties.md b/translations/ja-JP/data/reusables/webhooks/release_event_api_properties.md
index 8e541d5a9179..a699d7c2e675 100644
--- a/translations/ja-JP/data/reusables/webhooks/release_event_api_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/release_event_api_properties.md
@@ -1,3 +1,3 @@
 | キー       | 種類       | 説明                              |
 | -------- | -------- | ------------------------------- |
-| `action` | `string` | 実行されたアクション. Can be `published`. |
\ No newline at end of file
+| `action` | `string` | 実行されたアクション. Can be `published`. |
diff --git a/translations/ja-JP/data/reusables/webhooks/release_properties.md b/translations/ja-JP/data/reusables/webhooks/release_properties.md
index 1cbe3b9da878..9d59b8aae4aa 100644
--- a/translations/ja-JP/data/reusables/webhooks/release_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/release_properties.md
@@ -1 +1 @@
-`changes[body][from]` |`string` | アクションが`edited`だった場合の、以前のバージョンのbody。 `changes[name][from]` |`string` | アクションが`edited`だった場合の、以前のバージョンのname。 `release`|`object` | [release](/v3/repos/releases/#get-a-release)オブジェクト。
\ No newline at end of file
+`changes[body][from]` |`string` | アクションが`edited`だった場合の、以前のバージョンのbody。 `changes[name][from]` |`string` | アクションが`edited`だった場合の、以前のバージョンのname。 `release`|`object` | [release](/rest/reference/repos/#get-a-release)オブジェクト。
diff --git a/translations/ja-JP/data/reusables/webhooks/release_short_desc.md b/translations/ja-JP/data/reusables/webhooks/release_short_desc.md
index b3250fbf11ec..e3a9a3bb3a3c 100644
--- a/translations/ja-JP/data/reusables/webhooks/release_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/release_short_desc.md
@@ -1 +1 @@
-Activity related to a release. {% data reusables.webhooks.action_type_desc %} For more information, see the "[releases](/v3/repos/releases/)" REST API.
\ No newline at end of file
+Activity related to a release. {% data reusables.webhooks.action_type_desc %} For more information, see the "[releases](/v3/repos/releases/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/release_webhook_properties.md b/translations/ja-JP/data/reusables/webhooks/release_webhook_properties.md
index fb423c48b75f..ffd7a5802a77 100644
--- a/translations/ja-JP/data/reusables/webhooks/release_webhook_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/release_webhook_properties.md
@@ -1,3 +1,3 @@
-| キー       | 種類       | 説明                                                                                                                                                                                                                                                                                                           |
-| -------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `action` | `string` | 実行されたアクション. Can be one of:
    • `published`: a release, pre-release, or draft of a release is published
      • {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}
    • `unpublished`: a release or pre-release is deleted
    • `created`: a draft is saved, or a release or pre-release is published without previously being saved as a draft
    • `edited`: a release, pre-release, or draft release is edited
    • `deleted`: a release, pre-release, or draft release is deleted
    • `prereleased`: a pre-release is created
    • `released`: a release or draft of a release is published, or a pre-release is changed to a release
      • {% endif %} |
\ No newline at end of file
+| キー       | 種類       | 説明                                                                                                                                                                                                                                 |
+| -------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `action` | `string` | 実行されたアクション. Can be one of:
      • `published`: a release, pre-release, or draft of a release is published
      • `unpublished`: a release or pre-release is deleted
      • `created`: a draft is saved, or a release or pre-release is published without previously being saved as a draft
      • `edited`: a release, pre-release, or draft release is edited
      • `deleted`: a release, pre-release, or draft release is deleted
      • `prereleased`: a pre-release is created
      • `released`: a release or draft of a release is published, or a pre-release is changed to a release
        •  |
diff --git a/translations/ja-JP/data/reusables/webhooks/repo_desc.md b/translations/ja-JP/data/reusables/webhooks/repo_desc.md
index a61104a4ba83..27cc4f74c02c 100644
--- a/translations/ja-JP/data/reusables/webhooks/repo_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/repo_desc.md
@@ -1 +1 @@
-`repository` | `object` | The [`repository`](/v3/repos/#get-a-repository) where the event occured.
\ No newline at end of file
+`repository` | `object` | The [`repository`](/v3/repos/#get-a-repository) where the event occured.
diff --git a/translations/ja-JP/data/reusables/webhooks/repository_import_properties.md b/translations/ja-JP/data/reusables/webhooks/repository_import_properties.md
index 5c563a2ff8f6..dd659fb1c031 100644
--- a/translations/ja-JP/data/reusables/webhooks/repository_import_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/repository_import_properties.md
@@ -1,3 +1,3 @@
 | キー      | 種類       | 説明                                                                                      |
 | ------- | -------- | --------------------------------------------------------------------------------------- |
-| `ステータス` | `string` | The final state of the import. This can be one of `success`, `cancelled`, or `failure`. |
\ No newline at end of file
+| `ステータス` | `string` | The final state of the import. This can be one of `success`, `cancelled`, or `failure`. |
diff --git a/translations/ja-JP/data/reusables/webhooks/repository_import_short_desc.md b/translations/ja-JP/data/reusables/webhooks/repository_import_short_desc.md
index 2d30661c839a..056531b0195c 100644
--- a/translations/ja-JP/data/reusables/webhooks/repository_import_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/repository_import_short_desc.md
@@ -1 +1 @@
-Activity related to a repository being imported to GitHub. {% data reusables.webhooks.action_type_desc %} For more information, see the "[source imports](/v3/migrations/source_imports/)" REST API.
\ No newline at end of file
+Activity related to a repository being imported to GitHub. {% data reusables.webhooks.action_type_desc %} For more information, see the "[source imports](/v3/migrations/source_imports/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/repository_short_desc.md b/translations/ja-JP/data/reusables/webhooks/repository_short_desc.md
index b7c3f660a8a0..df290ac0ea83 100644
--- a/translations/ja-JP/data/reusables/webhooks/repository_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/repository_short_desc.md
@@ -1 +1 @@
-Activity related to a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[repositories](/v3/repos/)" REST API.
\ No newline at end of file
+Activity related to a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[repositories](/v3/repos/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/repository_vulnerability_alert_properties.md b/translations/ja-JP/data/reusables/webhooks/repository_vulnerability_alert_properties.md
index 6638f977e226..a79b91787c48 100644
--- a/translations/ja-JP/data/reusables/webhooks/repository_vulnerability_alert_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/repository_vulnerability_alert_properties.md
@@ -1,4 +1,4 @@
 | キー       | 種類       | 説明                                                                |
 | -------- | -------- | ----------------------------------------------------------------- |
 | `action` | `string` | 実行されたアクション. This can be one of `create`, `dismiss`, or `resolve`. |
-| `アラート`   | `オブジェクト` | The security alert of the vulnerable dependency.                  |
\ No newline at end of file
+| `アラート`   | `オブジェクト` | The security alert of the vulnerable dependency.                  |
diff --git a/translations/ja-JP/data/reusables/webhooks/repository_vulnerability_alert_short_desc.md b/translations/ja-JP/data/reusables/webhooks/repository_vulnerability_alert_short_desc.md
index fca14830b0b3..575e66985292 100644
--- a/translations/ja-JP/data/reusables/webhooks/repository_vulnerability_alert_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/repository_vulnerability_alert_short_desc.md
@@ -1 +1 @@
-リポジトリ内のセキュリティ脆弱性アラートに関連するアクティビティ。 {% data reusables.webhooks.action_type_desc %} 詳しい情報については「[脆弱性のある依存関係に対するセキュリティアラートについて](/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies)」を参照してください。
\ No newline at end of file
+リポジトリ内のセキュリティ脆弱性アラートに関連するアクティビティ。 {% data reusables.webhooks.action_type_desc %} 詳しい情報については「[脆弱性のある依存関係に対するセキュリティアラートについて](/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies)」を参照してください。
diff --git a/translations/ja-JP/data/reusables/webhooks/secret.md b/translations/ja-JP/data/reusables/webhooks/secret.md
index 119e13a93770..d4d128984aec 100644
--- a/translations/ja-JP/data/reusables/webhooks/secret.md
+++ b/translations/ja-JP/data/reusables/webhooks/secret.md
@@ -1 +1 @@
-Setting a webhook secret allows you to ensure that `POST` requests sent to the payload URL are from GitHub. When you set a secret, you'll receive the `X-Hub-Signature` header in the webhook `POST` request. For more details on how to use the secret and the `X-Hub-Signature` header to secure your webhook payloads, see "[Securing your webhooks](/webhooks/securing/)."
\ No newline at end of file
+Setting a webhook secret allows you to ensure that `POST` requests sent to the payload URL are from {% data variables.product.product_name %}. When you set a secret, you'll receive the {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}`X-Hub-Signature` and `X-Hub-Signature-256` headers{% else if currentVersion ver_lt "enterprise-server@2.23" %}`X-Hub-Signature` header{% else if currentVersion == "private-instances@latest" %}`X-Hub-Signature-256` header{% endif %} in the webhook `POST` request. For more information on how to use a secret with a signature header to secure your webhook payloads, see "[Securing your webhooks](/webhooks/securing/)."
diff --git a/translations/ja-JP/data/reusables/webhooks/sender_desc.md b/translations/ja-JP/data/reusables/webhooks/sender_desc.md
index d3c9f888bc19..218063f9e078 100644
--- a/translations/ja-JP/data/reusables/webhooks/sender_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/sender_desc.md
@@ -1 +1 @@
-`sender` | `object` | The user that triggered the event.
\ No newline at end of file
+`sender` | `object` | The user that triggered the event.
diff --git a/translations/ja-JP/data/reusables/webhooks/sponsorship_event_api_properties.md b/translations/ja-JP/data/reusables/webhooks/sponsorship_event_api_properties.md
index 01576e89a491..f0abfe527201 100644
--- a/translations/ja-JP/data/reusables/webhooks/sponsorship_event_api_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/sponsorship_event_api_properties.md
@@ -1,3 +1,3 @@
 | キー       | 種類       | 説明                                 |
 | -------- | -------- | ---------------------------------- |
-| `action` | `string` | 実行されたアクション. This can be `created`. |
\ No newline at end of file
+| `action` | `string` | 実行されたアクション. This can be `created`. |
diff --git a/translations/ja-JP/data/reusables/webhooks/sponsorship_properties.md b/translations/ja-JP/data/reusables/webhooks/sponsorship_properties.md
index 6506db181710..939d7fd0ea13 100644
--- a/translations/ja-JP/data/reusables/webhooks/sponsorship_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/sponsorship_properties.md
@@ -1 +1 @@
-`effective_date` | `string` | The `pending_cancellation` and `pending_tier_change` event types will include the date the cancellation or tier change will take effect. `changes[tier][from]` | `object` | The `tier_changed` and `pending_tier_change` will include the original tier before the change or pending change. For more information, see the [pending tier change payload](/webhooks/event-payloads#webhook-payload-example-when-someone-downgrades-a-sponsorship). `changes[privacy_level][from]` | `string` | The `edited` event types include the details about the change when someone edits a sponsorship to change the privacy.
\ No newline at end of file
+`effective_date` | `string` | The `pending_cancellation` and `pending_tier_change` event types will include the date the cancellation or tier change will take effect. `changes[tier][from]` | `object` | The `tier_changed` and `pending_tier_change` will include the original tier before the change or pending change. For more information, see the [pending tier change payload](/webhooks/event-payloads#webhook-payload-example-when-someone-downgrades-a-sponsorship). `changes[privacy_level][from]` | `string` | The `edited` event types include the details about the change when someone edits a sponsorship to change the privacy.
diff --git a/translations/ja-JP/data/reusables/webhooks/sponsorship_short_desc.md b/translations/ja-JP/data/reusables/webhooks/sponsorship_short_desc.md
index cb6cdccf21dc..2f62ffe8d86a 100644
--- a/translations/ja-JP/data/reusables/webhooks/sponsorship_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/sponsorship_short_desc.md
@@ -1 +1 @@
-Activity related to a sponsorship listing. {% data reusables.webhooks.action_type_desc %} For more information, see "[About GitHub Sponsors](/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors)".
\ No newline at end of file
+Activity related to a sponsorship listing. {% data reusables.webhooks.action_type_desc %} For more information, see "[About GitHub Sponsors](/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors)".
diff --git a/translations/ja-JP/data/reusables/webhooks/sponsorship_webhook_properties.md b/translations/ja-JP/data/reusables/webhooks/sponsorship_webhook_properties.md
index dd9e6ec0b7bd..04b95206bd76 100644
--- a/translations/ja-JP/data/reusables/webhooks/sponsorship_webhook_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/sponsorship_webhook_properties.md
@@ -1,3 +1,3 @@
 | キー       | 種類       | 説明                                                                                                                                 |
 | -------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------- |
-| `action` | `string` | 実行されたアクション. This can be one of `created`, `cancelled`, `edited`, `tier_changed`, `pending_cancellation`, or `pending_tier_change`. |
\ No newline at end of file
+| `action` | `string` | 実行されたアクション. This can be one of `created`, `cancelled`, `edited`, `tier_changed`, `pending_cancellation`, or `pending_tier_change`. |
diff --git a/translations/ja-JP/data/reusables/webhooks/star_properties.md b/translations/ja-JP/data/reusables/webhooks/star_properties.md
index f3b3aa7ba859..52e0bc54a0ef 100644
--- a/translations/ja-JP/data/reusables/webhooks/star_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/star_properties.md
@@ -1,4 +1,4 @@
-| キー           | 種類       | 説明                                                                                                                   |
-| ------------ | -------- | -------------------------------------------------------------------------------------------------------------------- |
-| `action`     | `string` | 実行されたアクション。 Can be `created` or `deleted`.                                                                           |
-| `starred_at` | `string` | The time the star was created. {% data reusables.shortdesc.iso_8601 %} Will be `null` for the `deleted` action. |
\ No newline at end of file
+| キー           | 種類       | 説明                                                                                                              |
+| ------------ | -------- | --------------------------------------------------------------------------------------------------------------- |
+| `action`     | `string` | 実行されたアクション。 Can be `created` or `deleted`.                                                                      |
+| `starred_at` | `string` | The time the star was created. {% data reusables.shortdesc.iso_8601 %} Will be `null` for the `deleted` action. |
diff --git a/translations/ja-JP/data/reusables/webhooks/star_short_desc.md b/translations/ja-JP/data/reusables/webhooks/star_short_desc.md
index eac484160fed..f4fb6634197e 100644
--- a/translations/ja-JP/data/reusables/webhooks/star_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/star_short_desc.md
@@ -1 +1 @@
-Activity related to a repository being starred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[starring](/v3/activity/starring/)" REST API.
\ No newline at end of file
+Activity related to a repository being starred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[starring](/v3/activity/starring/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/status_short_desc.md b/translations/ja-JP/data/reusables/webhooks/status_short_desc.md
index 8d28713099d2..754f871add59 100644
--- a/translations/ja-JP/data/reusables/webhooks/status_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/status_short_desc.md
@@ -1 +1 @@
-When the status of a Git commit changes. {% data reusables.webhooks.action_type_desc %} For more information, see the "[statuses](/v3/repos/statuses/)" REST API.
\ No newline at end of file
+When the status of a Git commit changes. {% data reusables.webhooks.action_type_desc %} For more information, see the "[statuses](/v3/repos/statuses/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/team_add_short_desc.md b/translations/ja-JP/data/reusables/webhooks/team_add_short_desc.md
index 8ec43f107b21..bf33defeed0f 100644
--- a/translations/ja-JP/data/reusables/webhooks/team_add_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/team_add_short_desc.md
@@ -1 +1 @@
-[リポジトリがTeamに追加された](/v3/teams/#add-or-update-team-repository-permissions)。
\ No newline at end of file
+[リポジトリがTeamに追加された](/v3/teams/#add-or-update-team-repository-permissions)。
diff --git a/translations/ja-JP/data/reusables/webhooks/team_short_desc.md b/translations/ja-JP/data/reusables/webhooks/team_short_desc.md
index 8faf762fe915..fdcf742789ee 100644
--- a/translations/ja-JP/data/reusables/webhooks/team_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/team_short_desc.md
@@ -1 +1 @@
-Activity related to an organization's team. {% data reusables.webhooks.action_type_desc %} For more information, see the "[teams](/v3/teams/)" REST API.
\ No newline at end of file
+Activity related to an organization's team. {% data reusables.webhooks.action_type_desc %} For more information, see the "[teams](/v3/teams/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/watch_properties.md b/translations/ja-JP/data/reusables/webhooks/watch_properties.md
index 4d58007c1d6b..e23ed0fd7c0e 100644
--- a/translations/ja-JP/data/reusables/webhooks/watch_properties.md
+++ b/translations/ja-JP/data/reusables/webhooks/watch_properties.md
@@ -1,3 +1,3 @@
 | キー       | 種類       | 説明                                            |
 | -------- | -------- | --------------------------------------------- |
-| `action` | `string` | 実行されたアクション. Currently, can only be `started`. |
\ No newline at end of file
+| `action` | `string` | 実行されたアクション. Currently, can only be `started`. |
diff --git a/translations/ja-JP/data/reusables/webhooks/watch_short_desc.md b/translations/ja-JP/data/reusables/webhooks/watch_short_desc.md
index a40fc1893db2..a853027b12ef 100644
--- a/translations/ja-JP/data/reusables/webhooks/watch_short_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/watch_short_desc.md
@@ -1 +1 @@
-When someone stars a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[starring](/v3/activity/starring/)" REST API.
\ No newline at end of file
+When someone stars a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[starring](/v3/activity/starring/)" REST API.
diff --git a/translations/ja-JP/data/reusables/webhooks/webhooks_ssl.md b/translations/ja-JP/data/reusables/webhooks/webhooks_ssl.md
index 987a85576227..c0d40e639296 100644
--- a/translations/ja-JP/data/reusables/webhooks/webhooks_ssl.md
+++ b/translations/ja-JP/data/reusables/webhooks/webhooks_ssl.md
@@ -1 +1 @@
-If your "Payload URL" is a secure site (HTTPS), you will have the option to configure the SSL verification settings. If your "Payload URL" is not secure (HTTP), GitHub will not display this option. By default, GitHub verifies the SSL certificate of your website when delivering webhook payloads. SSL verification helps ensure that hook payloads are delivered to your URL endpoint securely. You have the option to disable SSL, but we recommend keeping **Enable SSL verification** selected.
\ No newline at end of file
+If your "Payload URL" is a secure site (HTTPS), you will have the option to configure the SSL verification settings. If your "Payload URL" is not secure (HTTP), GitHub will not display this option. By default, GitHub verifies the SSL certificate of your website when delivering webhook payloads. SSL verification helps ensure that hook payloads are delivered to your URL endpoint securely. You have the option to disable SSL, but we recommend keeping **Enable SSL verification** selected.
diff --git a/translations/ja-JP/data/reusables/webhooks/workflow_run_desc.md b/translations/ja-JP/data/reusables/webhooks/workflow_run_desc.md
index 25d67bab0223..8866577116c7 100644
--- a/translations/ja-JP/data/reusables/webhooks/workflow_run_desc.md
+++ b/translations/ja-JP/data/reusables/webhooks/workflow_run_desc.md
@@ -1,4 +1,4 @@
 
 This event occurs when a workflow run is requested or completed, and allows you to execute a workflow based on the finished result of another workflow. For example, if your `pull_request` workflow generates build artifacts, you can create a new workflow that uses `workflow_run` to analyze the results and add a comment to the original pull request.
 
-The workflow started by the `workflow_run` event is able to access the secrets and write tokens used by the original workflow.
\ No newline at end of file
+The workflow started by the `workflow_run` event is able to access the secrets and write tokens used by the original workflow.
diff --git a/translations/ja-JP/data/variables/command_line.yml b/translations/ja-JP/data/variables/command_line.yml
index 4816981ce2e9..805c67903e68 100644
--- a/translations/ja-JP/data/variables/command_line.yml
+++ b/translations/ja-JP/data/variables/command_line.yml
@@ -1,5 +1,5 @@
 ---
-#Use this variable wherever backticks are necessary: http://git.io/AArkqA
+#Use this variable wherever backticks are necessary: https://github.com/github/docs-internal/pull/1176#discussion-diff-19853931
 backticks: >-
   {% if currentVersion == "free-pro-team@latest" %}github.com{% else %}[hostname]{% endif %}
 #Use this variable within codeblocks (because it includes HTML! Which only renders in shell codeblocks!)
diff --git a/translations/ja-JP/data/variables/contact.yml b/translations/ja-JP/data/variables/contact.yml
index 92186780d360..59df18be25a5 100644
--- a/translations/ja-JP/data/variables/contact.yml
+++ b/translations/ja-JP/data/variables/contact.yml
@@ -1,18 +1,17 @@
 ---
 contact_ent_support: '[GitHub Enterprise Support](https://enterprise.githubsupport.com/hc/en-us) または [GitHub Premium Support](https://premium.githubsupport.com)'
 contact_support: >-
-  {% if currentVersion == "free-pro-team@latest" %}[GitHub Support](https://support.github.com/contact)または [GitHub Premium Support](https://premium.githubsupport.com){% else %}GitHub Enterprise サイト管理者{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[GitHub Support](https://support.github.com/contact) or [GitHub Premium Support](https://premium.githubsupport.com){% else %}your GitHub Enterprise site administrator{% endif %}
 report_abuse: >-
-  {% if currentVersion == "free-pro-team@latest" %}[不正利用の申し立て](https://github.com/contact/report-abuse){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Report abuse](https://github.com/contact/report-abuse){% endif %}
 report_content: >-
-  {% if currentVersion == "free-pro-team@latest" %}[コンテンツの申し立て](https://github.com/contact/report-content){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Report content](https://github.com/contact/report-content){% endif %}
 contact_dmca: >-
-  {% if currentVersion == "free-pro-team@latest" %}[著作権侵害の申し立て](https://github.com/contact/dmca){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Copyright claims form](https://github.com/contact/dmca){% endif %}
 contact_privacy: >-
-  {% if currentVersion == "free-pro-team@latest" %}[プライバシーに関する連絡フォーム](https://github.com/contact/privacy){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Privacy contact form](https://github.com/contact/privacy){% endif %}
 contact_enterprise_sales: '[GitHubの営業チーム](https://enterprise.github.com/contact)'
 contact_feedback_actions: '[GitHub Actionsのフィードバックフォーム](https://support.github.com/contact/feedback?contact[category]=actions)'
-contact_partner_engineering: '[partnerengineering@github.com](mailto:partnerengineering@github.com)'
 #The team that provides Standard Support
 enterprise_support: 'GitHub Enterprise Support'
 #The larger team that includes Enterprise Support and Premium Support
diff --git a/translations/ja-JP/data/variables/explore.yml b/translations/ja-JP/data/variables/explore.yml
index 954e67c9f713..e9d43c423085 100644
--- a/translations/ja-JP/data/variables/explore.yml
+++ b/translations/ja-JP/data/variables/explore.yml
@@ -1,7 +1,7 @@
 ---
 explore_github: >-
-  {% if currentVersion == "free-pro-team@latest" %}[GitHub 探訪](https://github.com/explore){% else %}GitHub 探訪 (`https://[hostname]/explore`){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Explore GitHub](https://github.com/explore){% else %}Explore GitHub (`https://[hostname]/explore`){% endif %}
 your_stars_page: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Star ページ](https://github.com/stars){% else %}Star ページ(`https://[hostname]/stars`){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[stars page](https://github.com/stars){% else %}stars page (`https://[hostname]/stars`){% endif %}
 trending_page: >-
-  {% if currentVersion == "free-pro-team@latest" %}[トレンドページ](https://github.com/trending){% else %}トレンドページ (`https://[hostname]/trending`){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Trending page](https://github.com/trending){% else %}Trending page (`https://[hostname]/trending`){% endif %}
diff --git a/translations/ja-JP/data/variables/gists.yml b/translations/ja-JP/data/variables/gists.yml
index 57b7e1cd21c2..9d1fea10acf4 100644
--- a/translations/ja-JP/data/variables/gists.yml
+++ b/translations/ja-JP/data/variables/gists.yml
@@ -1,7 +1,7 @@
 ---
 gist_homepage: >-
-  {% if currentVersion == "free-pro-team@latest" %}[gist ホームページ](https://gist.github.com/){% else %}gist ホームページ、`http(s)://[hostname]/gist` あるいはサブドメインが有効化されている場合は `http(s)://gist.[hostname]`{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[gist home page](https://gist.github.com/){% else %}gist home page, `http(s)://[hostname]/gist` or `http(s)://gist.[hostname]` if subdomains are enabled {% endif %}
 gist_search_url: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Gist 検索](https://gist.github.com/search){% else %}Gist 検索、`http(s)://[hostname]/gist/search` あるいはサブドメインが有効化されている場合は `http(s)://gist.[hostname]/search`{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Gist Search](https://gist.github.com/search){% else %}Gist Search, `http(s)://[hostname]/gist/search` or `http(s)://gist.[hostname]/search` if subdomains are enabled{% endif %}
 discover_url: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Discover](https://gist.github.com/discover){% else %}Discover、`http(s)://[hostname]/gist/discover` あるいはサブドメインが有効化されている場合は `http(s)://gist.[hostname]/discover`{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Discover](https://gist.github.com/discover){% else %}Discover, `http(s)://[hostname]/gist/discover` or `http(s)://gist.[hostname]/discover` if subdomains are enabled{% endif %}
diff --git a/translations/ja-JP/data/variables/notifications.yml b/translations/ja-JP/data/variables/notifications.yml
index 4a6aa1e0d10a..441bdba328c2 100644
--- a/translations/ja-JP/data/variables/notifications.yml
+++ b/translations/ja-JP/data/variables/notifications.yml
@@ -1,5 +1,5 @@
 ---
 no_reply_address: >-
-  {% if currentVersion == "free-pro-team@latest" %}`noreply@github.com`{% else %}サイト管理者が設定した no-reply メールアドレス{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}`noreply@github.com`{% else %}the no-reply email address configured by your site administrator{% endif %}
 cc_address: >-
-  {% if currentVersion == "free-pro-team@latest" %}`@noreply.github.com`{% else %}サイト管理者が設定した no-reply メールアドレスに基づく{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}`@noreply.github.com`{% else %}based on the no-reply email address configured by your site administrator{% endif %}
diff --git a/translations/ja-JP/data/variables/product.yml b/translations/ja-JP/data/variables/product.yml
index 803d07868d7c..6647ba97dd50 100644
--- a/translations/ja-JP/data/variables/product.yml
+++ b/translations/ja-JP/data/variables/product.yml
@@ -19,7 +19,7 @@ prodname_ghe_cloud: 'GitHub Enterprise Cloud'
 prodname_ghe_one: 'GitHub One'
 ## Use these variables when referring specifically to a location within a product
 product_location: >-
-  {% if currentVersion == "free-pro-team@latest" %}GitHub{% else %}使用している GitHub Enterprise Serverインスタンス{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}GitHub{% else %}your GitHub Enterprise Server instance{% endif %}
 product_location_enterprise: 'GitHub Enterprise Server インスタンス'
 prodname_free_user: 'GitHub Free'
 prodname_pro: 'GitHub Pro'
@@ -56,12 +56,9 @@ prodname_github_app: 'GitHub App'
 prodname_github_apps: 'GitHub Apps'
 prodname_oauth_app: 'OAuth App'
 #API and developer docs
-prodname_dev_docs: 'GitHub 開発者ドキュメンテーション'
 prodname_enterprise_api: 'GitHub Enterprise Server API'
-prodname_support_forum: 'GitHub API Development and Support Forum'
 prodname_support_forum_with_url: '[GitHub API Development and Support Forum](https://github.community/c/github-api-development-and-support/37)'
 prodname_unfurls: 'Content Attachments'
-prodname_component_kit: 'GitHub Component Kit'
 #GitHub Actions
 ## Use this variable only when referring to GitHub Actions the product. When referring to the thing that someone creates using the product, call it an action (small a). See the terminology page of the Brand Guide for more.
 prodname_actions: 'GitHub Actions'
@@ -80,9 +77,8 @@ prodname_matching_fund: 'GitHub Sponsors Matching Fund'
 prodname_advanced_security: 'Advanced Security'
 #Codespaces
 prodname_codespaces: 'Codespaces'
-prodname_vscode: 'Visual Studio Code'
 prodname_vs_codespaces: 'Visual Studio Codespaces'
-prodname_vs: 'Visual Studio'
+prodname_github_codespaces: 'GitHub Codespaces'
 #GitHub resources: blog, jobs, Learning Lab
 prodname_gcf: 'GitHub Community Support'
 prodname_blog: 'GitHub ブログ'
@@ -110,15 +106,18 @@ prodname_code_scanning: 'code scanning'
 prodname_code_scanning_capc: 'Code scanning'
 prodname_codeql_runner: 'CodeQL runner'
 prodname_advisory_database: 'GitHub Advisory Database'
-prodname_codeql_workflow: 'CodeQL Analysis workflow'
+prodname_codeql_workflow: 'CodeQL analysis workflow'
+#Visual Studio
+prodname_vs: 'Visual Studio'
+prodname_vscode: 'Visual Studio Code'
+prodname_vss_ghe: 'Visual Studio subscription with GitHub Enterprise'
+prodname_vss_admin_portal_with_url: 'the [administrator portal for Visual Studio subscriptions](https://visualstudio.microsoft.com/subscriptions-administration/)'
 #GitHub Dependabot
 prodname_dependabot: 'GitHub Dependabot'
 prodname_dependabot_short: 'Dependabot'
 prodname_dependabot_alerts: 'GitHub Dependabotアラート'
 prodname_dependabot_security_updates: 'GitHub Dependabotセキュリティアップデート'
 prodname_dependabot_version_updates: 'GitHub Dependabotバージョンアップデート'
-#GitHub Policies
-prodname_policies: 'GitHub Policies'
 #GitHub Archive Program
 prodname_archive: 'GitHub Archive Program'
 prodname_arctic_vault: 'Arctic Code Vault'
@@ -127,9 +126,9 @@ product_url: >-
   {% if currentVersion == "free-pro-team@latest" %}github.com{% else %}[hostname]{% endif %}
 pricing_url: 'https://github.com/pricing'
 signin_link: >-
-  {% if currentVersion == "free-pro-team@latest" %}[サインイン](https://github.com/login){% else %}サインイン (`https://[hostname]/login`){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Sign in](https://github.com/login){% else %}Sign in (`https://[hostname]/login`){% endif %}
 signout_link: >-
-  {% if currentVersion == "free-pro-team@latest" %}[サインアウト](https://github.com/logout){% else %}サインアウト (`https://[hostname]/logout`){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Sign out](https://github.com/logout){% else %}Sign out (`https://[hostname]/logout`){% endif %}
 raw_github_com: >-
   {% if currentVersion == "free-pro-team@latest" %}raw.githubusercontent.com{% else %}[hostname]/user/repo/raw{% endif %}
 #GitHub Enterprise Server past versions
diff --git a/translations/ja-JP/data/variables/search.yml b/translations/ja-JP/data/variables/search.yml
index 774b0cfcab1a..f22c85c91625 100644
--- a/translations/ja-JP/data/variables/search.yml
+++ b/translations/ja-JP/data/variables/search.yml
@@ -1,11 +1,5 @@
 ---
 advanced_url: >-
-  {% if currentVersion == "free-pro-team@latest" %}[高度な検索](https://github.com/search/advanced) ページ{% else %}高度な検索ページ (`https://[hostname]/search/advanced`){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[advanced search](https://github.com/search/advanced) page{% else %}advanced search page (`https://[hostname]/search/advanced`){% endif %}
 search_page_url: >-
-  {% if currentVersion == "free-pro-team@latest" %}[検索](https://github.com/search) ページ{% else %}検索ページ (`https://[hostname]/search`){% endif %}
-search_highlighting_link: >-
-  ハイライトされた検索結果を受信する方法の詳細については、[テキストマッチメタデータ](#text-match-metadata)を参照してください。
-search_query_description: >-
-  クエリには1つ以上の検索キーワードと修飾子が含まれます。修飾子を使うと、検索をGitHubの特定の領域に限定できます。REST APIはGitHub.comと同じ修飾子をサポートします。クエリのフォーマットについてさらに学ぶには、[検索クエリの構築](#constructing-a-search-query)を参照してください。
-order_description: >-
-  返される最初の検索結果が、マッチが最も多かったもの（'desc'）になるか、マッチが最も少なかったもの（'asc'）になるかを決めます。このパラメータは、'sort'を渡していないかぎり無視されます。デフォルト:'desc'
+  {% if currentVersion == "free-pro-team@latest" %}[search](https://github.com/search) page{% else %}search page (`https://[hostname]/search`){% endif %}
diff --git a/translations/ko-KR/content/actions/creating-actions/about-actions.md b/translations/ko-KR/content/actions/creating-actions/about-actions.md
index 789cbde41c64..fb3cd025b409 100644
--- a/translations/ko-KR/content/actions/creating-actions/about-actions.md
+++ b/translations/ko-KR/content/actions/creating-actions/about-actions.md
@@ -20,7 +20,8 @@ versions:
 You can create actions by writing custom code that interacts with your repository in any way you'd like, including integrating with {% data variables.product.prodname_dotcom %}'s APIs and any publicly available third-party API. For example, an action can publish npm modules, send SMS alerts when urgent issues are created, or deploy production-ready code.
 
 {% if currentVersion == "free-pro-team@latest" %}
-You can write your own actions to use in your workflow or share the actions you build with the {% data variables.product.prodname_dotcom %} community. To share actions you've built, your repository must be public.
+You can write your own actions to use in your workflow or share the actions you build with the
+{% data variables.product.prodname_dotcom %} community. To share actions you've built, your repository must be public.
 {% endif %}
 
 Actions can run directly on a machine or in a Docker container. You can define an action's inputs, outputs, and environment variables.
@@ -60,7 +61,8 @@ A _composite run steps_ action allows you to combine multiple workflow run steps
 If you're developing an action for other people to use, we recommend keeping the action in its own repository instead of bundling it with other application code. This allows you to version, track, and release the action just like any other software.
 
 {% if currentVersion == "free-pro-team@latest" %}
-Storing an action in its own repository makes it easier for the {% data variables.product.prodname_dotcom %} community to discover the action, narrows the scope of the code base for developers fixing issues and extending the action, and decouples the action's versioning from the versioning of other application code.
+Storing an action in its own repository makes it easier for the
+{% data variables.product.prodname_dotcom %} community to discover the action, narrows the scope of the code base for developers fixing issues and extending the action, and decouples the action's versioning from the versioning of other application code.
 {% endif %}
 
 {% if currentVersion == "free-pro-team@latest" %}If you're building an action that you don't plan to make available to the public, you {% else %} You{% endif %} can store the action's files in any location in your repository. If you plan to combine action, workflow, and application code in a single repository, we recommend storing actions in the `.github` directory. For example, `.github/actions/action-a` and `.github/actions/action-b`.
@@ -82,7 +84,7 @@ This section explains how you can use release management to distribute updates t
 
 If you're developing an action for other people to use, we recommend using release management to control how you distribute updates. Users can expect an action's major version to include necessary critical fixes and security patches, while still remaining compatible with their existing workflows. You should consider releasing a new major version whenever your changes affect compatibility.
 
-Under this release management approach, users should not be referencing an action's `master` branch, as it's likely to contain the latest code and consequently might be unstable. Instead, you can recommend that your users specify a major version when using your action, and only direct them to a more specific version if they encounter issues.
+Under this release management approach, users should not be referencing an action's default branch, as it's likely to contain the latest code and consequently might be unstable. Instead, you can recommend that your users specify a major version when using your action, and only direct them to a more specific version if they encounter issues.
 
 To use a specific action version, users can configure their {% data variables.product.prodname_actions %} workflow to target a tag, a commit's SHA, or a branch named for a release.
 
@@ -141,7 +143,7 @@ We recommend creating a README file to help people learn how to use your action.
 
 ### Comparing {% data variables.product.prodname_actions %} to {% data variables.product.prodname_github_apps %}
 
-{% data variables.product.prodname_marketplace %} offers tools to improve your workflow. Understanding the differences and the benefits of each tool will allow you to select the best tool for your job. For more information about building actions and apps, see "[About GitHub Actions](/actions/getting-started-with-github-actions/about-github-actions)" and "[About apps](/apps/about-apps/)."
+{% data variables.product.prodname_marketplace %} offers tools to improve your workflow. Understanding the differences and the benefits of each tool will allow you to select the best tool for your job. For more information about building apps, see "[About apps](/apps/about-apps/)."
 
 #### Strengths of GitHub Actions and GitHub Apps
 
diff --git a/translations/ko-KR/content/actions/creating-actions/creating-a-composite-run-steps-action.md b/translations/ko-KR/content/actions/creating-actions/creating-a-composite-run-steps-action.md
index c556f87ddc94..eb43f3a49bd0 100644
--- a/translations/ko-KR/content/actions/creating-actions/creating-a-composite-run-steps-action.md
+++ b/translations/ko-KR/content/actions/creating-actions/creating-a-composite-run-steps-action.md
@@ -36,7 +36,7 @@ Before you begin, you'll create a {% data variables.product.product_name %} repo
   echo "Goodbye"
   ```
 
-1. From your terminal, make `goodbye.sh` executable and check it into your repository.
+3. From your terminal, make `goodbye.sh` executable.
 
   ```shell
   chmod +x goodbye.sh
@@ -85,13 +85,26 @@ Before you begin, you'll create a {% data variables.product.product_name %} repo
 
   For more information about how to use `github.action_path`, see "[`github context`](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)".
 
-1. Create a new label. This example uses a label called `v1` for the main branch. For more information, see "[Creating a label ](/github/managing-your-work-on-github/creating-a-label)."
+1. From your terminal, check in your `action.yml` file.
+
+  ```shell
+  git add action.yml
+  git commit -m "Add action"
+  git push
+  ```
+
+1. From your terminal, add a tag. This example uses a tag called `v1`. For more information, see "[About actions](/actions/creating-actions/about-actions#using-release-management-for-actions)."
+
+  ```shell
+  git tag -a -m "Description of this release" v1
+  git push --follow-tags
+  ```
 
 ### Testing out your action in a workflow
 
 The following workflow code uses the completed hello world action that you made in "[Creating an action metadata file](/actions/creating-actions/creating-a-composite-run-steps-action#creating-an-action-metadata-file)".
 
-Copy the workflow code into a `.github/workflows/main.yml` file in another repository, but replace `actions/hello-world-composite-run-steps-action@v1` with the repository and label you created. You can also replace the `who-to-greet` input with your name.
+Copy the workflow code into a `.github/workflows/main.yml` file in another repository, but replace `actions/hello-world-composite-run-steps-action@v1` with the repository and tag you created. You can also replace the `who-to-greet` input with your name.
 
 {% raw %}
 **.github/workflows/main.yml**
diff --git a/translations/ko-KR/content/actions/creating-actions/creating-a-docker-container-action.md b/translations/ko-KR/content/actions/creating-actions/creating-a-docker-container-action.md
index 12f00cec2742..f9d1f55a671d 100644
--- a/translations/ko-KR/content/actions/creating-actions/creating-a-docker-container-action.md
+++ b/translations/ko-KR/content/actions/creating-actions/creating-a-docker-container-action.md
@@ -1,6 +1,6 @@
 ---
 title: Creating a Docker container action
-intro: This guide shows you the minimal steps required to build a Docker container action.
+intro: 'This guide shows you the minimal steps required to build a Docker container action.'
 product: '{% data reusables.gated-features.actions %}'
 redirect_from:
   - /articles/creating-a-docker-container-action
diff --git a/translations/ko-KR/content/actions/creating-actions/creating-a-javascript-action.md b/translations/ko-KR/content/actions/creating-actions/creating-a-javascript-action.md
index a7342f806894..60cb037c1dc5 100644
--- a/translations/ko-KR/content/actions/creating-actions/creating-a-javascript-action.md
+++ b/translations/ko-KR/content/actions/creating-actions/creating-a-javascript-action.md
@@ -77,9 +77,9 @@ This file defines the `who-to-greet` input and `time` output. It also tells the
 
 The actions toolkit is a collection of Node.js packages that allow you to quickly build JavaScript actions with more consistency.
 
-The toolkit [`@actions/core`](https://github.com/actions/toolkit/tree/master/packages/core) package provides an interface to the workflow commands, input and output variables, exit statuses, and debug messages.
+The toolkit [`@actions/core`](https://github.com/actions/toolkit/tree/main/packages/core) package provides an interface to the workflow commands, input and output variables, exit statuses, and debug messages.
 
-The toolkit also offers a [`@actions/github`](https://github.com/actions/toolkit/tree/master/packages/github) package that returns an authenticated Octokit REST client and access to GitHub Actions contexts.
+The toolkit also offers a [`@actions/github`](https://github.com/actions/toolkit/tree/main/packages/github) package that returns an authenticated Octokit REST client and access to GitHub Actions contexts.
 
 The toolkit offers more than the `core` and `github` packages. For more information, see the [actions/toolkit](https://github.com/actions/toolkit) repository.
 
@@ -119,7 +119,7 @@ try {
 }
 ```
 
-If an error is thrown in the above `index.js` example, `core.setFailed(error.message);` uses the actions toolkit [`@actions/core`](https://github.com/actions/toolkit/tree/master/packages/core) package to log a message and set a failing exit code. For more information, see "[Setting exit codes for actions](/actions/creating-actions/setting-exit-codes-for-actions)."
+If an error is thrown in the above `index.js` example, `core.setFailed(error.message);` uses the actions toolkit [`@actions/core`](https://github.com/actions/toolkit/tree/main/packages/core) package to log a message and set a failing exit code. For more information, see "[Setting exit codes for actions](/actions/creating-actions/setting-exit-codes-for-actions)."
 
 
 ### Creating a README
@@ -258,4 +258,8 @@ jobs:
 
 From your repository, click the **Actions** tab, and select the latest workflow run. You should see "Hello Mona the Octocat" or the name you used for the `who-to-greet` input and the timestamp printed in the log.
 
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+![A screenshot of using your action in a workflow](/assets/images/help/repository/javascript-action-workflow-run-updated.png)
+{% else %}
 ![A screenshot of using your action in a workflow](/assets/images/help/repository/javascript-action-workflow-run.png)
+{% endif %}
\ No newline at end of file
diff --git a/translations/ko-KR/content/actions/creating-actions/index.md b/translations/ko-KR/content/actions/creating-actions/index.md
index bc085b64c319..966e98032bd1 100644
--- a/translations/ko-KR/content/actions/creating-actions/index.md
+++ b/translations/ko-KR/content/actions/creating-actions/index.md
@@ -6,6 +6,7 @@ redirect_from:
   - /github/automating-your-workflow-with-github-actions/building-actions
   - /actions/automating-your-workflow-with-github-actions/building-actions
   - /actions/building-actions
+  - /articles/creating-a-github-action/
 versions:
   free-pro-team: '*'
   enterprise-server: '>=2.22'
diff --git a/translations/ko-KR/content/actions/creating-actions/metadata-syntax-for-github-actions.md b/translations/ko-KR/content/actions/creating-actions/metadata-syntax-for-github-actions.md
index 46d80810c99b..fb6d34e11971 100644
--- a/translations/ko-KR/content/actions/creating-actions/metadata-syntax-for-github-actions.md
+++ b/translations/ko-KR/content/actions/creating-actions/metadata-syntax-for-github-actions.md
@@ -42,7 +42,6 @@ Action metadata files use YAML syntax. If you're new to YAML, you can read "[Lea
 
 This example configures two inputs: numOctocats and octocatEyeColor. The numOctocats input is not required and will default to a value of '1'. The octocatEyeColor input is required and has no default value. Workflow files that use this action must use the `with` keyword to set an input value for octocatEyeColor. For more information about the `with` syntax, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepswith)."
 
-
 ```yaml
 inputs:
   numOctocats:
@@ -54,7 +53,6 @@ inputs:
     required: true
 ```
 
-
 When you specify an input to an action in a workflow file or use a default input value, {% data variables.product.prodname_dotcom %} creates an environment variable for the input with the name `INPUT_`. The environment variable created converts input names to uppercase letters and replaces spaces with `_` characters.
 
 For example, if a workflow defined the numOctocats and octocatEyeColor inputs, the action code could read the values of the inputs using the `INPUT_NUMOCTOCATS` and `INPUT_OCTOCATEYECOLOR` environment variables.
@@ -243,7 +241,7 @@ For more information, see "[`github context`](/actions/reference/context-and-exp
 
 ##### **`runs.steps.env`**
 
-**Optional**  Sets a `map` of environment variables for only that step. If you want to modify the environment variable stored in the workflow, use `echo "::set-env name={name}::{value}"` in a composite run step.
+**Optional**  Sets a `map` of environment variables for only that step. If you want to modify the environment variable stored in the workflow, use {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}`echo "{name}={value}" >> $GITHUB_ENV`{% else %}`echo "::set-env name={name}::{value}"`{% endif %} in a composite run step.
 
 ##### **`runs.steps.working-directory`**
 
diff --git a/translations/ko-KR/content/actions/creating-actions/setting-exit-codes-for-actions.md b/translations/ko-KR/content/actions/creating-actions/setting-exit-codes-for-actions.md
index ca3470ca93be..d329dc9af4b3 100644
--- a/translations/ko-KR/content/actions/creating-actions/setting-exit-codes-for-actions.md
+++ b/translations/ko-KR/content/actions/creating-actions/setting-exit-codes-for-actions.md
@@ -24,7 +24,7 @@ versions:
 
 ### Setting a failure exit code in a JavaScript action
 
-If you are creating a JavaScript action, you can use the actions toolkit [`@actions/core`](https://github.com/actions/toolkit/tree/master/packages/core) package to log a message and set a failure exit code. 예시:
+If you are creating a JavaScript action, you can use the actions toolkit [`@actions/core`](https://github.com/actions/toolkit/tree/main/packages/core) package to log a message and set a failure exit code. 예시:
 
 ```javascript
 try {
diff --git a/translations/ko-KR/content/actions/guides/about-continuous-integration.md b/translations/ko-KR/content/actions/guides/about-continuous-integration.md
new file mode 100644
index 000000000000..cf480c9c8b52
--- /dev/null
+++ b/translations/ko-KR/content/actions/guides/about-continuous-integration.md
@@ -0,0 +1,63 @@
+---
+title: About continuous integration
+intro: 'You can create custom continuous integration (CI) and continuous deployment (CD) workflows directly in your {% data variables.product.prodname_dotcom %} repository with {% data variables.product.prodname_actions %}.'
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /articles/about-continuous-integration
+  - /github/automating-your-workflow-with-github-actions/about-continuous-integration
+  - /actions/automating-your-workflow-with-github-actions/about-continuous-integration
+  - /actions/building-and-testing-code-with-continuous-integration/about-continuous-integration
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### About continuous integration
+
+Continuous integration (CI) is a software practice that requires frequently committing code to a shared repository. Committing code more often detects errors sooner and reduces the amount of code a developer needs to debug when finding the source of an error. Frequent code updates also make it easier to merge changes from different members of a software development team. This is great for developers, who can spend more time writing code and less time debugging errors or resolving merge conflicts.
+
+When you commit code to your repository, you can continuously build and test the code to make sure that the commit doesn't introduce errors. Your tests can include code linters (which check style formatting), security checks, code coverage, functional tests, and other custom checks.
+
+Building and testing your code requires a server. You can build and test updates locally before pushing code to a repository, or you can use a CI server that checks for new code commits in a repository.
+
+### About continuous integration using {% data variables.product.prodname_actions %}
+
+CI using {% data variables.product.prodname_actions %} offers workflows that can build the code in your repository and run your tests. Workflows can run on {% data variables.product.prodname_dotcom %}-hosted virtual machines, or on machines that you host yourself. For more information, see "[Virtual environments for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)," and "[About self-hosted runners](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)."
+
+You can configure your CI workflow to run when a {% data variables.product.product_name %} event occurs (for example, when new code is pushed to your repository), on a set schedule, or when an external event occurs using the repository dispatch webhook.
+
+{% data variables.product.product_name %} runs your CI tests and provides the results of each test in the pull request, so you can see whether the change in your branch introduces an error. When all CI tests in a workflow pass, the changes you pushed are ready to be reviewed by a team member or merged. When a test fails, one of your changes may have caused the failure.
+
+When you set up CI in your repository, {% data variables.product.product_name %} analyzes the code in your repository and recommends CI workflows based on the language and framework in your repository. For example, if you use [Node.js](https://nodejs.org/en/), {% data variables.product.product_name %} will suggest a template file that installs your Node.js packages and runs your tests. You can use the CI workflow template suggested by {% data variables.product.product_name %}, customize the suggested template, or create your own custom workflow file to run your CI tests.
+
+![Screenshot of suggested continuous integration templates](/assets/images/help/repository/ci-with-actions-template-picker.png)
+
+In addition to helping you set up CI workflows for your project, you can use {% data variables.product.prodname_actions %} to create workflows across the full software development life cycle. For example, you can use actions to deploy, package, or release your project. For more information, see "[About {% data variables.product.prodname_actions %}](/articles/about-github-actions)."
+
+For a definition of common terms, see "[Core concepts for {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)."
+
+### Supported languages
+
+{% data variables.product.product_name %} offers CI workflow templates for a variety of languages and frameworks.
+
+Browse the complete list of CI workflow templates offered by {% data variables.product.product_name %} in the {% if currentVersion == "free-pro-team@latest" %}[actions/starter-workflows](https://github.com/actions/starter-workflows/tree/main/ci) repository{% else %} `actions/starter-workflows` repository on {% data variables.product.product_location %}{% endif %}.
+
+### Notifications for workflow runs
+
+{% data reusables.repositories.workflow-notifications %}
+
+### Status badges for workflow runs
+
+{% data reusables.repositories.actions-workflow-status-badge-into %}
+
+For more information, see "[Configuring a workflow](/articles/configuring-a-workflow)."
+
+### 더 읽을거리
+
+- "[Setting up continuous integration using {% data variables.product.prodname_actions %}](/articles/setting-up-continuous-integration-using-github-actions)"
+{% if currentVersion == "free-pro-team@latest" %}
+- "[Managing billing for {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)"
+{% endif %}
diff --git a/translations/ko-KR/content/actions/guides/about-packaging-with-github-actions.md b/translations/ko-KR/content/actions/guides/about-packaging-with-github-actions.md
new file mode 100644
index 000000000000..4f6a16ade588
--- /dev/null
+++ b/translations/ko-KR/content/actions/guides/about-packaging-with-github-actions.md
@@ -0,0 +1,48 @@
+---
+title: About packaging with GitHub Actions
+intro: 'You can set up workflows in {% data variables.product.prodname_actions %} to produce packages and upload them to {% data variables.product.prodname_registry %} or another package hosting provider.'
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/about-packaging-with-github-actions
+  - /actions/publishing-packages-with-github-actions/about-packaging-with-github-actions
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### About packaging steps
+
+A packaging step is a common part of a continuous integration or continuous delivery workflow. After building and testing your application, a runnable or deployable artifact is produced in the form of a package. For example, a continuous integration workflow for a Java project may run `mvn package` to produce a JAR file. Or, a CI workflow for a Node.js application may create a Docker container.
+
+Depending on the kind of application you're building, this package can be downloaded locally for manual testing, made available for users to download, or deployed to a staging or production environment.
+
+### Packaging in continuous integration workflows
+
+Creating a package at the end of a continuous integration workflow can help during code reviews on a pull request. After building and testing your code, a packaging step can produce a runnable or deployable artifact. Your workflow can then take that artifact and upload it as part of the workflow.
+
+Now, when reviewing a pull request, you'll be able to look at the workflow run and download the artifact that was produced.
+
+![Download artifact drop-down menu](/assets/images/help/repository/artifact-drop-down.png)
+
+This will let you run the code in the pull request on your machine, which can help with debugging or testing the pull request.
+
+### Workflows for publishing packages
+
+In addition to uploading packaging artifacts for testing in a continuous integration workflow, you can create workflows that build your project and publish packages to a package registry.
+
+* **Publish packages to {% data variables.product.prodname_registry %}**
+  {% data variables.product.prodname_registry %} can act as a package hosting service for many types of packages. You can choose to share your packages with all of {% data variables.product.prodname_dotcom %}, or private packages to share with collaborators or an organization. For more information, see "[About {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/about-github-packages)."
+
+  You may want to publish packages to {% data variables.product.prodname_registry %} on every push into the default branch. This will allow developers on your project to always be able to run and test the latest build out of master easily, by installing it from {% data variables.product.prodname_registry %}.
+
+* **Publish packages to a package registry**  
+  For many projects, publishing to a package registry is performed whenever a new version of a project is released. For example, a project that produces a JAR file may upload new releases to the Maven Central repository. Or, a .NET project may produce a nuget package and upload it to the NuGet Gallery.
+
+  You can automate this by creating a workflow that publishes packages to a package registry on every release creation. For more information, see "[Creating releases](/github/administering-a-repository/creating-releases)."
+
+### 더 읽을거리
+
+- "[Publishing Node.js packages](/actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages)"
diff --git a/translations/ko-KR/content/actions/guides/about-service-containers.md b/translations/ko-KR/content/actions/guides/about-service-containers.md
new file mode 100644
index 000000000000..ceeba28c1ca8
--- /dev/null
+++ b/translations/ko-KR/content/actions/guides/about-service-containers.md
@@ -0,0 +1,117 @@
+---
+title: About service containers
+intro: 'You can use service containers to connect databases, web services, memory caches, and other tools to your workflow.'
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/about-service-containers
+  - /actions/configuring-and-managing-workflows/about-service-containers
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### About service containers
+
+Service containers are Docker containers that provide a simple and portable way for you to host services that you might need to test or operate your application in a workflow. For example, your workflow might need to run integration tests that require access to a database and memory cache.
+
+You can configure service containers for each job in a workflow. {% data variables.product.prodname_dotcom %} creates a fresh Docker container for each service configured in the workflow, and destroys the service container when the job completes. Steps in a job can communicate with all service containers that are part of the same job.
+
+{% data reusables.github-actions.docker-container-os-support %}
+
+### Communicating with service containers
+
+You can configure jobs in a workflow to run directly on a runner machine or in a Docker container. Communication between a job and its service containers is different depending on whether a job runs directly on the runner machine or in a container.
+
+#### Running jobs in a container
+
+When you run jobs in a container, {% data variables.product.prodname_dotcom %} connects service containers to the job using Docker's user-defined bridge networks. For more information, see "[Use bridge networks](https://docs.docker.com/network/bridge/)" in the Docker documentation.
+
+Running the job and services in a container simplifies network access. You can access a service container using the label you configure in the workflow. The hostname of the service container is automatically mapped to the label name. For example, if you create a service container with the label `redis`, the hostname of the service container is `redis`.
+
+You don't need to configure any ports for service containers. By default, all containers that are part of the same Docker network expose all ports to each other, and no ports are exposed outside of the Docker network.
+
+#### Running jobs on the runner machine
+
+When running jobs directly on the runner machine, you can access service containers using `localhost:` or `127.0.0.1:`. {% data variables.product.prodname_dotcom %} configures the container network to enable communication from the service container to the Docker host.
+
+When a job runs directly on a runner machine, the service running in the Docker container does not expose its ports to the job on the runner by default. You need to map ports on the service container to the Docker host. For more information, see "[Mapping Docker host and service container ports](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)."
+
+### Creating service containers
+
+You can use the `services` keyword to create service containers that are part of a job in your workflow. For more information, see [`jobs..services`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idservices).
+
+This example creates a service called `redis` in a job called `container-job`. The Docker host in this example is the `node:10.18-jessie` container.
+
+{% raw %}
+```yaml
+name: Redis container example
+on: push
+
+jobs:
+  # Label of the container job
+  container-job:
+    # Containers must run in Linux based operating systems
+    runs-on: ubuntu-latest
+    # Docker Hub image that `container-job` executes in
+    container: node:10.18-jessie
+
+    # Service containers to run with `container-job`
+    services:
+      # Label used to access the service container
+      redis:
+        # Docker Hub image
+        image: redis
+```
+{% endraw %}
+
+### Mapping Docker host and service container ports
+
+If your job runs in a Docker container, you do not need to map ports on the host or the service container. If your job runs directly on the runner machine, you'll need to map any required service container ports to ports on the host runner machine.
+
+You can map service containers ports to the Docker host using the `ports` keyword. For more information, see [`jobs..services`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idservices).
+
+| Value of `ports` | 설명                                                                                   |
+| ---------------- | ------------------------------------------------------------------------------------ |
+| `8080:80`        | Maps TCP port 80 in the container to port 8080 on the Docker host.                   |
+| `8080:80/udp`    | Maps UDP port 80 in the container to port 8080 on the Docker host.                   |
+| `8080/udp`       | Map a randomly chosen UDP port in the container to UDP port 8080 on the Docker host. |
+
+When you map ports using the `ports` keyword, {% data variables.product.prodname_dotcom %} uses the `--publish` command to publish the container’s ports to the Docker host. For more information, see "[Docker container networking](https://docs.docker.com/config/containers/container-networking/)" in the Docker documentation.
+
+When you specify the Docker host port but not the container port, the container port is randomly assigned to a free port. {% data variables.product.prodname_dotcom %} sets the assigned container port in the service container context. For example, for a `redis` service container, if you configured the Docker host port 5432, you can access the corresponding container port using the `job.services.redis.ports[5432]` context. For more information, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions#job-context)."
+
+#### Example mapping Redis ports
+
+This example maps the service container `redis` port 6379 to the Docker host port 6379.
+
+{% raw %}
+```yaml
+name: Redis Service Example
+on: push
+
+jobs:
+  # Label of the container job
+  runner-job:
+    # You must use a Linux environment when using service containers or container jobs
+    runs-on: ubuntu-latest
+
+    # Service containers to run with `runner-job`
+    services:
+      # Label used to access the service container
+      redis:
+        # Docker Hub image
+        image: redis
+        #
+        ports:
+          # Opens tcp port 6379 on the host and service container
+          - 6379:6379
+```
+{% endraw %}
+
+### 더 읽을거리
+
+- "[Creating Redis service containers](/actions/automating-your-workflow-with-github-actions/creating-redis-service-containers)"
+- "[Creating PostgreSQL service containers](/actions/automating-your-workflow-with-github-actions/creating-postgresql-service-containers)"
diff --git a/translations/ko-KR/content/actions/guides/building-and-testing-java-with-ant.md b/translations/ko-KR/content/actions/guides/building-and-testing-java-with-ant.md
new file mode 100644
index 000000000000..ef34837e3a22
--- /dev/null
+++ b/translations/ko-KR/content/actions/guides/building-and-testing-java-with-ant.md
@@ -0,0 +1,109 @@
+---
+title: Building and testing Java with Ant
+intro: You can create a continuous integration (CI) workflow in GitHub Actions to build and test your Java project with Ant.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/building-and-testing-java-with-ant
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introduction
+
+This guide shows you how to create a workflow that performs continuous integration (CI) for your Java project using the Ant build system. The workflow you create will allow you to see when commits to a pull request cause build or test failures against your default branch; this approach can help ensure that your code is always healthy. You can extend your CI workflow to upload artifacts from a workflow run.
+
+{% data variables.product.prodname_dotcom %}-hosted runners have a tools cache with pre-installed software, which includes Java Development Kits (JDKs) and Ant. For a list of software and the pre-installed versions for JDK and Ant, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)".
+
+### 빌드전 요구 사양
+
+You should be familiar with YAML and the syntax for {% data variables.product.prodname_actions %}. For more information, see:
+- "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)"
+- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)"
+
+We recommend that you have a basic understanding of Java and the Ant framework. For more information, see the [Apache Ant Manual](https://ant.apache.org/manual/).
+
+{% data reusables.actions.enterprise-setup-prereq %}
+
+### Starting with an Ant workflow template
+
+{% data variables.product.prodname_dotcom %} provides an Ant workflow template that will work for most Ant-based Java projects. For more information, see the [Ant workflow template](https://github.com/actions/starter-workflows/blob/main/ci/ant.yml).
+
+To get started quickly, you can choose the preconfigured Ant template when you create a new workflow. For more information, see the "[{% data variables.product.prodname_actions %} quickstart](/actions/quickstart)."
+
+You can also add this workflow manually by creating a new file in the `.github/workflows` directory of your repository.
+
+{% raw %}
+```yaml
+name: Java CI
+
+on: [push]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up JDK 1.8
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Build with Ant
+        run: ant -noinput -buildfile build.xml
+```
+{% endraw %}
+
+This workflow performs the following steps:
+
+1. The `checkout` step downloads a copy of your repository on the runner.
+2. The `setup-java` step configures the Java 1.8 JDK.
+3. The "Build with Ant" step runs the default target in your `build.xml` in non-interactive mode.
+
+The default workflow templates are excellent starting points when creating your build and test workflow, and you can customize the template to suit your project’s needs.
+
+{% data reusables.github-actions.example-github-runner %}
+
+{% data reusables.github-actions.java-jvm-architecture %}
+
+### Building and testing your code
+
+You can use the same commands that you use locally to build and test your code.
+
+The starter workflow will run the default target specified in your _build.xml_ file.  Your default target will commonly be set to build classes, run tests and package classes into their distributable format, for example, a JAR file.
+
+If you use different commands to build your project, or you want to run a different target, you can specify those. For example, you may want to run the `jar` target that's configured in your _build-ci.xml_ file.
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+    with:
+      java-version: 1.8
+  - name: Run the Ant jar target
+    run: ant -noinput -buildfile build-ci.xml jar
+```
+{% endraw %}
+
+### Packaging workflow data as artifacts
+
+After your build has succeeded and your tests have passed, you may want to upload the resulting Java packages as a build artifact. This will store the built packages as part of the workflow run, and allow you to download them. Artifacts can help you test and debug pull requests in your local environment before they're merged. For more information, see "[Persisting workflow data using artifacts](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)."
+
+Ant will usually create output files like JARs, EARs, or WARs in the `build/jar` directory. You can upload the contents of that directory using the `upload-artifact` action.
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+  - run: ant -noinput -buildfile build.xml
+  - uses: actions/upload-artifact@v2
+    with:
+      name: Package
+      path: build/jar
+```
+{% endraw %}
diff --git a/translations/ko-KR/content/actions/guides/building-and-testing-java-with-gradle.md b/translations/ko-KR/content/actions/guides/building-and-testing-java-with-gradle.md
new file mode 100644
index 000000000000..f124e1d3dc7f
--- /dev/null
+++ b/translations/ko-KR/content/actions/guides/building-and-testing-java-with-gradle.md
@@ -0,0 +1,134 @@
+---
+title: Building and testing Java with Gradle
+intro: You can create a continuous integration (CI) workflow in GitHub Actions to build and test your Java project with Gradle.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/building-and-testing-java-with-gradle
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introduction
+
+This guide shows you how to create a workflow that performs continuous integration (CI) for your Java project using the Gradle build system. The workflow you create will allow you to see when commits to a pull request cause build or test failures against your default branch; this approach can help ensure that your code is always healthy. You can extend your CI workflow to cache files and upload artifacts from a workflow run.
+
+{% data variables.product.prodname_dotcom %}-hosted runners have a tools cache with pre-installed software, which includes Java Development Kits (JDKs) and Gradle. For a list of software and the pre-installed versions for JDK and Gradle, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)".
+
+### 빌드전 요구 사양
+
+You should be familiar with YAML and the syntax for {% data variables.product.prodname_actions %}. For more information, see:
+- "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)"
+- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)"
+
+We recommend that you have a basic understanding of Java and the Gradle framework. For more information, see [Getting Started](https://docs.gradle.org/current/userguide/getting_started.html) in the Gradle documentation.
+
+{% data reusables.actions.enterprise-setup-prereq %}
+
+### Starting with a Gradle workflow template
+
+{% data variables.product.prodname_dotcom %} provides a Gradle workflow template that will work for most Gradle-based Java projects. For more information, see the [Gradle workflow template](https://github.com/actions/starter-workflows/blob/main/ci/gradle.yml).
+
+To get started quickly, you can choose the preconfigured Gradle template when you create a new workflow. For more information, see the "[{% data variables.product.prodname_actions %} quickstart](/actions/quickstart)."
+
+You can also add this workflow manually by creating a new file in the `.github/workflows` directory of your repository.
+
+{% raw %}
+```yaml
+name: Java CI
+
+on: [push]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up JDK 1.8
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Build with Gradle
+        run: ./gradlew build
+```
+{% endraw %}
+
+This workflow performs the following steps:
+
+1. The `checkout` step downloads a copy of your repository on the runner.
+2. The `setup-java` step configures the Java 1.8 JDK.
+3. The "Build with Gradle" step runs the `gradlew` wrapper script to ensure that your code builds, tests pass, and a package can be created.
+
+The default workflow templates are excellent starting points when creating your build and test workflow, and you can customize the template to suit your project’s needs.
+
+{% data reusables.github-actions.example-github-runner %}
+
+{% data reusables.github-actions.java-jvm-architecture %}
+
+### Building and testing your code
+
+You can use the same commands that you use locally to build and test your code.
+
+The starter workflow will run the `build` task by default. In the default Gradle configuration, this command will download dependencies, build classes, run tests, and package classes into their distributable format, for example, a JAR file.
+
+If you use different commands to build your project, or you want to use a different task, you can specify those. For example, you may want to run the `package` task that's configured in your _ci.gradle_ file.
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+    with:
+      java-version: 1.8
+  - name: Run the Gradle package task
+    run: ./gradlew -b ci.gradle package
+```
+{% endraw %}
+
+### Caching dependencies
+
+You can cache your dependencies to speed up your workflow runs. After a successful run, your local Gradle package cache will be stored on GitHub Actions infrastructure. In future workflow runs, the cache will be restored so that dependencies don't need to be downloaded from remote package repositories. For more information, see "[Caching dependencies to speed up workflows](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)" and the [`cache` action](https://github.com/marketplace/actions/cache).
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - name: Set up JDK 1.8
+    uses: actions/setup-java@v1
+    with:
+      java-version: 1.8
+  - name: Cache Gradle packages
+    uses: actions/cache@v2
+    with:
+      path: ~/.gradle/caches
+      key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle') }}
+      restore-keys: ${{ runner.os }}-gradle
+  - name: Build with Gradle
+    run: ./gradlew build
+```
+{% endraw %}
+
+This workflow will save the contents of your local Gradle package cache, located in the `.gradle/caches` directory of the runner's home directory. The cache key will be the hashed contents of the gradle build files, so changes to them will invalidate the cache.
+
+### Packaging workflow data as artifacts
+
+After your build has succeeded and your tests have passed, you may want to upload the resulting Java packages as a build artifact. This will store the built packages as part of the workflow run, and allow you to download them. Artifacts can help you test and debug pull requests in your local environment before they're merged. For more information, see "[Persisting workflow data using artifacts](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)."
+
+Gradle will usually create output files like JARs, EARs, or WARs in the `build/libs` directory. You can upload the contents of that directory using the `upload-artifact` action.
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+  - run: ./gradlew build
+  - uses: actions/upload-artifact@v2
+    with:
+      name: Package
+      path: build/libs
+```
+{% endraw %}
diff --git a/translations/ko-KR/content/actions/guides/building-and-testing-java-with-maven.md b/translations/ko-KR/content/actions/guides/building-and-testing-java-with-maven.md
new file mode 100644
index 000000000000..8bda99df17ee
--- /dev/null
+++ b/translations/ko-KR/content/actions/guides/building-and-testing-java-with-maven.md
@@ -0,0 +1,135 @@
+---
+title: Building and testing Java with Maven
+intro: You can create a continuous integration (CI) workflow in GitHub Actions to build and test your Java project with Maven.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/building-and-testing-java-with-maven
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introduction
+
+This guide shows you how to create a workflow that performs continuous integration (CI) for your Java project using the Maven software project management tool. The workflow you create will allow you to see when commits to a pull request cause build or test failures against your default branch; this approach can help ensure that your code is always healthy. You can extend your CI workflow to cache files and upload artifacts from a workflow run.
+
+{% data variables.product.prodname_dotcom %}-hosted runners have a tools cache with pre-installed software, which includes Java Development Kits (JDKs) and Maven. For a list of software and the pre-installed versions for JDK and Maven, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)".
+
+### 빌드전 요구 사양
+
+You should be familiar with YAML and the syntax for {% data variables.product.prodname_actions %}. For more information, see:
+- "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)"
+- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)"
+
+We recommend that you have a basic understanding of Java and the Maven framework. For more information, see the [Maven Getting Started Guide](http://maven.apache.org/guides/getting-started/index.html) in the Maven documentation.
+
+{% data reusables.actions.enterprise-setup-prereq %}
+
+### Starting with a Maven workflow template
+
+{% data variables.product.prodname_dotcom %} provides a Maven workflow template that will work for most Maven-based Java projects. For more information, see the [Maven workflow template](https://github.com/actions/starter-workflows/blob/main/ci/maven.yml).
+
+To get started quickly, you can choose the preconfigured Maven template when you create a new workflow. For more information, see the "[{% data variables.product.prodname_actions %} quickstart](/actions/quickstart)."
+
+You can also add this workflow manually by creating a new file in the `.github/workflows` directory of your repository.
+
+{% raw %}
+```yaml
+name: Java CI
+
+on: [push]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up JDK 1.8
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Build with Maven
+        run: mvn -B package --file pom.xml
+```
+{% endraw %}
+
+This workflow performs the following steps:
+
+1. The `checkout` step downloads a copy of your repository on the runner.
+2. The `setup-java` step configures the Java 1.8 JDK.
+3. The "Build with Maven" step runs the Maven `package` target in non-interactive mode to ensure that your code builds, tests pass, and a package can be created.
+
+The default workflow templates are excellent starting points when creating your build and test workflow, and you can customize the template to suit your project’s needs.
+
+{% data reusables.github-actions.example-github-runner %}
+
+{% data reusables.github-actions.java-jvm-architecture %}
+
+### Building and testing your code
+
+You can use the same commands that you use locally to build and test your code.
+
+The starter workflow will run the `package` target by default. In the default Maven configuration, this command will download dependencies, build classes, run tests, and package classes into their distributable format, for example, a JAR file.
+
+If you use different commands to build your project, or you want to use a different target, you can specify those. For example, you may want to run the `verify` target that's configured in a _pom-ci.xml_ file.
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+    with:
+      java-version: 1.8
+  - name: Run the Maven verify phase
+    run: mvn -B verify --file pom-ci.xml
+```
+{% endraw %}
+
+### Caching dependencies
+
+You can cache your dependencies to speed up your workflow runs. After a successful run, your local Maven repository will be stored on GitHub Actions infrastructure. In future workflow runs, the cache will be restored so that dependencies don't need to be downloaded from remote Maven repositories. For more information, see "[Caching dependencies to speed up workflows](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)" and the [`cache` action](https://github.com/marketplace/actions/cache).
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - name: Set up JDK 1.8
+    uses: actions/setup-java@v1
+    with:
+      java-version: 1.8
+  - name: Cache Maven packages
+    uses: actions/cache@v2
+    with:
+      path: ~/.m2
+      key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }}
+      restore-keys: ${{ runner.os }}-m2
+  - name: Build with Maven
+    run: mvn -B package --file pom.xml
+```
+{% endraw %}
+
+This workflow will save the contents of your local Maven repository, located in the `.m2` directory of the runner's home directory. The cache key will be the hashed contents of _pom.xml_, so changes to _pom.xml_ will invalidate the cache.
+
+### Packaging workflow data as artifacts
+
+After your build has succeeded and your tests have passed, you may want to upload the resulting Java packages as a build artifact. This will store the built packages as part of the workflow run, and allow you to download them. Artifacts can help you test and debug pull requests in your local environment before they're merged. For more information, see "[Persisting workflow data using artifacts](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)."
+
+Maven will usually create output files like JARs, EARs, or WARs in the `target` directory. To upload those as artifacts, you can copy them into a new directory that contains artifacts to upload. For example, you can create a directory called `staging`. Then you can upload the contents of that directory using the `upload-artifact` action.
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+  - run: mvn -B package --file pom.xml
+  - run: mkdir staging && cp target/*.jar staging
+  - uses: actions/upload-artifact@v2
+    with:
+      name: Package
+      path: staging
+```
+{% endraw %}
diff --git a/translations/ko-KR/content/actions/guides/building-and-testing-nodejs.md b/translations/ko-KR/content/actions/guides/building-and-testing-nodejs.md
new file mode 100644
index 000000000000..96f5ccf70ea2
--- /dev/null
+++ b/translations/ko-KR/content/actions/guides/building-and-testing-nodejs.md
@@ -0,0 +1,276 @@
+---
+title: Building and testing Node.js
+intro: You can create a continuous integration (CI) workflow to build and test your Node.js project.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions
+  - /actions/language-and-framework-guides/using-nodejs-with-github-actions
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introduction
+
+This guide shows you how to create a continuous integration (CI) workflow that builds and tests Node.js code. If your CI tests pass, you may want to deploy your code or publish a package.
+
+### 빌드전 요구 사양
+
+We recommend that you have a basic understanding of Node.js, YAML, workflow configuration options, and how to create a workflow file. For more information, see:
+
+- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)"
+- "[Getting started with Node.js](https://nodejs.org/en/docs/guides/getting-started-guide/)"
+
+{% data reusables.actions.enterprise-setup-prereq %}
+
+### Starting with the Node.js workflow template
+
+{% data variables.product.prodname_dotcom %} provides a Node.js workflow template that will work for most Node.js projects. This guide includes npm and Yarn examples that you can use to customize the template. For more information, see the [Node.js workflow template](https://github.com/actions/starter-workflows/blob/main/ci/node.js.yml).
+
+To get started quickly, add the template to the `.github/workflows` directory of your repository.
+
+{% raw %}
+```yaml
+name: Node.js CI
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [8.x, 10.x, 12.x]
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v1
+      with:
+        node-version: ${{ matrix.node-version }}
+    - run: npm install
+    - run: npm run build --if-present
+    - run: npm test
+      env:
+        CI: true
+```
+{% endraw %}
+
+{% data reusables.github-actions.example-github-runner %}
+
+### Specifying the Node.js version
+
+The easiest way to specify a Node.js version is by using the `setup-node` action provided by {% data variables.product.prodname_dotcom %}. For more information see, [`setup-node`](https://github.com/actions/setup-node/).
+
+The `setup-node` action takes a Node.js version as an input and configures that version on the runner. The `setup-node` action finds a specific version of Node.js from the tools cache on each runner and adds the necessary binaries to `PATH`, which persists for the rest of the job. Using the `setup-node` action is the recommended way of using Node.js with {% data variables.product.prodname_actions %} because it ensures consistent behavior across different runners and different versions of Node.js. If you are using a self-hosted runner, you must install Node.js and add it to `PATH`.
+
+The template includes a matrix strategy that builds and tests your code with three Node.js versions: 8.x, 10.x, and 12.x. The 'x' is a wildcard character that matches the latest minor and patch release available for a version. Each version of Node.js specified in the `node-version` array creates a job that runs the same steps.
+
+Each job can access the value defined in the matrix `node-version` array using the `matrix` context. The `setup-node` action uses the context as the `node-version` input. The `setup-node` action configures each job with a different Node.js version before building and testing code. For more information about matrix strategies and contexts, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix)" and "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)."
+
+{% raw %}
+```yaml
+strategy:
+  matrix:
+    node-version: [8.x, 10.x, 12.x]
+
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js ${{ matrix.node-version }}
+  uses: actions/setup-node@v1
+  with:
+    node-version: ${{ matrix.node-version }}
+```
+{% endraw %}
+
+Alternatively, you can build and test with exact Node.js versions.
+
+```yaml
+strategy:
+  matrix:
+    node-version: [8.16.2, 10.17.0]
+```
+
+Or, you can build and test using a single version of Node.js too.
+
+{% raw %}
+```yaml
+name: Node.js CI
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Use Node.js
+      uses: actions/setup-node@v1
+      with:
+        node-version: '12.x'
+    - run: npm install
+    - run: npm run build --if-present
+    - run: npm test
+      env:
+        CI: true
+```
+{% endraw %}
+
+If you don't specify a Node.js version, {% data variables.product.prodname_dotcom %} uses the environment's default Node.js version. For more information, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)".
+
+### Installing dependencies
+
+{% data variables.product.prodname_dotcom %}-hosted runners have npm and Yarn dependency managers installed. You can use npm and Yarn to install dependencies in your workflow before building and testing your code. The Windows and Linux {% data variables.product.prodname_dotcom %}-hosted runners also have Grunt, Gulp, and Bower installed.
+
+You can also cache dependencies to speed up your workflow. For more information, see "[Caching dependencies to speed up your workflow](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)."
+
+#### Example using npm
+
+This example installs the dependencies defined in the *package.json* file. For more information, see [`npm install`](https://docs.npmjs.com/cli/install).
+
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    node-version: '12.x'
+- name: Install dependencies
+  run: npm install
+```
+
+Using `npm ci` installs the versions in the *package-lock.json* or *npm-shrinkwrap.json* file and prevents updates to the lock file. Using `npm ci` is generally faster than running `npm install`. For more information, see [`npm ci`](https://docs.npmjs.com/cli/ci.html) and "[Introducing `npm ci` for faster, more reliable builds](https://blog.npmjs.org/post/171556855892/introducing-npm-ci-for-faster-more-reliable)."
+
+{% raw %}
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    node-version: '12.x'
+- name: Install dependencies
+  run: npm ci
+```
+{% endraw %}
+
+#### Example using Yarn
+
+This example installs the dependencies defined in the *package.json* file. For more information, see [`yarn install`](https://yarnpkg.com/en/docs/cli/install).
+
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    node-version: '12.x'
+- name: Install dependencies
+  run: yarn
+```
+
+Alternatively, you can pass `--frozen-lockfile` to install the versions in the *yarn.lock* file and prevent updates to the *yarn.lock* file.
+
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    node-version: '12.x'
+- name: Install dependencies
+  run: yarn --frozen-lockfile
+```
+
+#### Example using a private registry and creating the .npmrc file
+
+{% data reusables.github-actions.setup-node-intro %}
+
+To authenticate to your private registry, you'll need to store your npm authentication token as a secret in your repository settings. For example, create a secret called `NPM_TOKEN`. For more information, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
+
+In the example below, the secret `NPM_TOKEN` stores the npm authentication token. The `setup-node` action configures the *.npmrc* file to read the npm authentication token from the `NODE_AUTH_TOKEN` environment variable. When using the `setup-node` action to create an *.npmrc* file, you must set the `NPM_AUTH_TOKEN` environment variable with the secret that contains your npm authentication token.
+
+Before installing dependencies, use the `setup-node` action to create the *.npmrc* file. The action has two input parameters. The `node-version` parameter sets the Node.js version, and the `registry-url` parameter sets the default registry. If your package registry uses scopes, you must use the `scope` parameter. For more information, see [`npm-scope`](https://docs.npmjs.com/misc/scope).
+
+{% raw %}
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    always-auth: true
+    node-version: '12.x'
+    registry-url: https://registry.npmjs.org
+    scope: '@octocat'
+- name: Install dependencies
+  run: npm ci
+  env:
+    NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}}
+```
+{% endraw %}
+
+The example above creates an *.npmrc* file with the following contents:
+
+```
+//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN}
+@octocat:registry=https://registry.npmjs.org/
+always-auth=true
+```
+
+#### Example caching dependencies
+
+You can cache dependencies using a unique key, and restore the dependencies when you run future workflows using the `cache` action. For more information, see "[Caching dependencies to speed up workflows](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)" and the [`cache` action](https://github.com/marketplace/actions/cache).
+
+{% raw %}
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    node-version: '12.x'
+- name: Cache Node.js modules
+  uses: actions/cache@v2
+  with:
+    # npm cache files are stored in `~/.npm` on Linux/macOS
+    path: ~/.npm 
+    key: ${{ runner.OS }}-node-${{ hashFiles('**/package-lock.json') }}
+    restore-keys: |
+      ${{ runner.OS }}-node-
+      ${{ runner.OS }}-
+- name: Install dependencies
+  run: npm ci
+```
+{% endraw %}
+
+### Building and testing your code
+
+You can use the same commands that you use locally to build and test your code. For example, if you run `npm run build` to run build steps defined in your *package.json* file and `npm test` to run your test suite, you would add those commands in your workflow file.
+
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    node-version: '12.x'
+- run: npm install
+- run: npm run build --if-present
+- run: npm test
+```
+
+### Packaging workflow data as artifacts
+
+You can save artifacts from your build and test steps to view after a job completes. For example, you may need to save log files, core dumps, test results, or screenshots. For more information, see "[Persisting workflow data using artifacts](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)."
+
+### Publishing to package registries
+
+You can configure your workflow to publish your Node.js package to a package registry after your CI tests pass. For more information about publishing to npm and {% data variables.product.prodname_registry %}, see "[Publishing Node.js packages](/actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages)."
diff --git a/translations/ko-KR/content/actions/guides/building-and-testing-python.md b/translations/ko-KR/content/actions/guides/building-and-testing-python.md
new file mode 100644
index 000000000000..5024f4dac41a
--- /dev/null
+++ b/translations/ko-KR/content/actions/guides/building-and-testing-python.md
@@ -0,0 +1,427 @@
+---
+title: Building and testing Python
+intro: You can create a continuous integration (CI) workflow to build and test your Python project.
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/using-python-with-github-actions
+  - /actions/language-and-framework-guides/using-python-with-github-actions
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introduction
+
+This guide shows you how to build, test, and publish a Python package.
+
+{% data variables.product.prodname_dotcom %}-hosted runners have a tools cache with pre-installed software, which includes Python and PyPy. You don't have to install anything! For a full list of up-to-date software and the pre-installed versions of Python and PyPy, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)".
+
+### 빌드전 요구 사양
+
+You should be familiar with YAML and the syntax for {% data variables.product.prodname_actions %}. For more information, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)."
+
+We recommend that you have a basic understanding of Python, PyPy, and pip. For more information, see:
+- [Getting started with Python](https://www.python.org/about/gettingstarted/)
+- [PyPy](https://pypy.org/)
+- [Pip package manager](https://pypi.org/project/pip/)
+
+{% data reusables.actions.enterprise-setup-prereq %}
+
+### Starting with the Python workflow template
+
+{% data variables.product.prodname_dotcom %} provides a Python workflow template that should work for most Python projects. This guide includes examples that you can use to customize the template. For more information, see the [Python workflow template](https://github.com/actions/starter-workflows/blob/main/ci/python-package.yml).
+
+To get started quickly, add the template to the `.github/workflows` directory of your repository.
+
+{% raw %}
+```yaml
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: [2.7, 3.5, 3.6, 3.7, 3.8]
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v2
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install flake8 pytest
+        if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
+    - name: Lint with flake8
+      run: |
+        # stop the build if there are Python syntax errors or undefined names
+        flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+        # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide
+        flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+    - name: Test with pytest
+      run: |
+        pytest
+```
+{% endraw %}
+
+### Specifying a Python version
+
+To use a pre-installed version of Python or PyPy on a {% data variables.product.prodname_dotcom %}-hosted runner, use the `setup-python` action. This action finds a specific version of Python or PyPy from the tools cache on each runner and adds the necessary binaries to `PATH`, which persists for the rest of the job. If a specific version of Python is not pre-installed in the tools cache, the `setup-python` action will download and set up the appropriate version from the [`python-versions`](https://github.com/actions/python-versions) repository.
+
+Using the `setup-python` action is the recommended way of using Python with {% data variables.product.prodname_actions %} because it ensures consistent behavior across different runners and different versions of Python. If you are using a self-hosted runner, you must install Python and add it to `PATH`. For more information, see the [`setup-python` action](https://github.com/marketplace/actions/setup-python).
+
+The table below describes the locations for the tools cache in each {% data variables.product.prodname_dotcom %}-hosted runner.
+
+|                          | Ubuntu                          | Mac                                      | Windows                                    |
+| ------------------------ | ------------------------------- | ---------------------------------------- | ------------------------------------------ |
+| **Tool Cache Directory** | `/opt/hostedtoolcache/*`        | `/Users/runner/hostedtoolcache/*`        | `C:\hostedtoolcache\windows\*`         |
+| **Python Tool Cache**    | `/opt/hostedtoolcache/Python/*` | `/Users/runner/hostedtoolcache/Python/*` | `C:\hostedtoolcache\windows\Python\*` |
+| **PyPy Tool Cache**      | `/opt/hostedtoolcache/PyPy/*`   | `/Users/runner/hostedtoolcache/PyPy/*`   | `C:\hostedtoolcache\windows\PyPy\*`   |
+
+If you are using a self-hosted runner, you can configure the runner to use the `setup-python` action to manage your dependencies. For more information, see [using setup-python with a self-hosted runner](https://github.com/actions/setup-python#using-setup-python-with-a-self-hosted-runner) in the `setup-python` README.
+
+{% data variables.product.prodname_dotcom %} supports semantic versioning syntax. For more information, see "[Using semantic versioning](https://docs.npmjs.com/about-semantic-versioning#using-semantic-versioning-to-specify-update-types-your-package-can-accept)" and the "[Semantic versioning specification](https://semver.org/)."
+
+#### Using multiple Python versions
+
+{% raw %}
+```yaml
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      # You can use PyPy versions in python-version.
+      # For example, pypy2 and pypy3
+      matrix:
+        python-version: [2.7, 3.5, 3.6, 3.7, 3.8]
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v2
+      with:
+        python-version: ${{ matrix.python-version }}
+    # You can test your matrix by printing the current Python version
+    - name: Display Python version
+      run: python -c "import sys; print(sys.version)"
+```
+{% endraw %}
+
+#### Using a specific Python version
+
+You can configure a specific version of python. For example, 3.8. Alternatively, you can semantic version syntax to get the latest minor release. This example uses the latest minor release of Python 3.
+
+{% raw %}
+```yaml
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python 3.x
+      uses: actions/setup-python@v2
+      with:
+        # Semantic version range syntax or exact version of a Python version
+        python-version: '3.x' 
+        # Optional - x64 or x86 architecture, defaults to x64
+        architecture: 'x64' 
+    # You can test your matrix by printing the current Python version
+    - name: Display Python version
+      run: python -c "import sys; print(sys.version)"
+```
+{% endraw %}
+
+#### Excluding a version
+
+If you specify a version of Python that is not available, `setup-python` fails with an error such as: `##[error]Version 3.4 with arch x64 not found`. The error message includes the available versions.
+
+You can also use the `exclude` keyword in your workflow if there is a configuration of Python that you do not wish to run. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategy)."
+
+{% raw %}
+```yaml
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: [2.7, 3.6, 3.7, 3.8, pypy2, pypy3]
+        exclude:
+          - os: macos-latest
+            python-version: 3.6
+          - os: windows-latest
+            python-version: 3.6
+```
+{% endraw %}
+
+#### Using the default Python version
+
+We recommend using `setup-python` to configure the version of Python used in your workflows because it helps make your dependencies explicit. If you don't use `setup-python`, the default version of Python set in `PATH` is used in any shell when you call `python`. The default version of Python varies between {% data variables.product.prodname_dotcom %}-hosted runners, which may cause unexpected changes or use an older version than expected.
+
+| {% data variables.product.prodname_dotcom %}-hosted runner | 설명                                                                                                                                                                                                                                                                                                                                                                    |
+| ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Ubuntu                                                     | Ubuntu runners have multiple versions of system Python installed under `/usr/bin/python` and `/usr/bin/python3`. The Python versions that come packaged with Ubuntu are in addition to the versions that {% data variables.product.prodname_dotcom %} installs in the tools cache.                                                                                    |
+| Windows                                                    | Excluding the versions of Python that are in the tools cache, Windows does not ship with an equivalent version of system Python. To maintain consistent behavior with other runners and to allow Python to be used out-of-the-box without the `setup-python` action, {% data variables.product.prodname_dotcom %} adds a few versions from the tools cache to `PATH`. |
+| macOS                                                      | The macOS runners have more than one version of system Python installed, in addition to the versions that are part of the tools cache. The system Python versions are located in the `/usr/local/Cellar/python/*` directory.                                                                                                                                          |
+
+### Installing dependencies
+
+{% data variables.product.prodname_dotcom %}-hosted runners have the pip package manager installed. You can use pip to install dependencies from the PyPI package registry before building and testing your code. For example, the YAML below installs or upgrades the `pip` package installer and the `setuptools` and `wheel` packages.
+
+You can also cache dependencies to speed up your workflow. For more information, see "[Caching dependencies to speed up your workflow](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)."
+
+{% raw %}
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Set up Python
+  uses: actions/setup-python@v2
+  with:
+    python-version: '3.x'
+- name: Install dependencies
+  run: python -m pip install --upgrade pip setuptools wheel
+```
+{% endraw %}
+
+#### Requirements file
+
+After you update `pip`, a typical next step is to install dependencies from *requirements.txt*.
+
+{% raw %}
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Set up Python
+  uses: actions/setup-python@v2
+  with:
+    python-version: '3.x'
+- name: Install dependencies
+  run: |
+    python -m pip install --upgrade pip
+    pip install -r requirements.txt
+```
+{% endraw %}
+
+#### Caching Dependencies
+
+You can cache pip dependencies using a unique key, and restore the dependencies when you run future workflows using the [`cache`](https://github.com/marketplace/actions/cache) action. For more information, see "[Caching dependencies to speed up workflows](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)."
+
+Pip caches dependencies in different locations, depending on the operating system of the runner. The path you'll need to cache may differ from the Ubuntu example below depending on the operating system you use. For more information, see [Python caching examples](https://github.com/actions/cache/blob/main/examples.md#python---pip).
+
+{% raw %}
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Setup Python
+  uses: actions/setup-python@v2
+  with:
+    python-version: '3.x'
+- name: Cache pip
+  uses: actions/cache@v2
+  with:
+    # This path is specific to Ubuntu
+    path: ~/.cache/pip
+    # Look to see if there is a cache hit for the corresponding requirements file
+    key: ${{ runner.os }}-pip-${{ hashFiles('requirements.txt') }}
+    restore-keys: |
+      ${{ runner.os }}-pip-
+      ${{ runner.os }}-
+- name: Install dependencies
+  run: pip install -r requirements.txt
+```
+{% endraw %}
+
+{% note %}
+
+**Note:** Depending on the number of dependencies, it may be faster to use the dependency cache. Projects with many large dependencies should see a performance increase as it cuts down the time required for downloading. Projects with fewer dependencies may not see a significant performance increase and may even see a slight decrease due to how pip installs cached dependencies. The performance varies from project to project.
+
+{% endnote %}
+
+### Testing your code
+
+You can use the same commands that you use locally to build and test your code.
+
+#### Testing with pytest and pytest-cov
+
+This example installs or upgrades `pytest` and `pytest-cov`. Tests are then run and output in JUnit format while code coverage results are output in Cobertura. For more information, see [JUnit](https://junit.org/junit5/) and [Cobertura](https://cobertura.github.io/cobertura/).
+
+{% raw %}
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Set up Python
+  uses: actions/setup-python@v2
+  with:
+    python-version: '3.x'
+- name: Install dependencies
+  run: |
+    python -m pip install --upgrade pip
+    pip install -r requirements.txt
+- name: Test with pytest
+  run: |
+    pip install pytest
+    pip install pytest-cov
+    pytest tests.py --doctest-modules --junitxml=junit/test-results.xml --cov=com --cov-report=xml --cov-report=html
+```
+{% endraw %}
+
+#### Using Flake8 to lint code
+
+The following example installs or upgrades `flake8` and uses it to lint all files. For more information, see [Flake8](http://flake8.pycqa.org/en/latest/).
+
+{% raw %}
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Set up Python
+  uses: actions/setup-python@v2
+  with:
+    python-version: '3.x'
+- name: Install dependencies
+  run: |
+    python -m pip install --upgrade pip
+    pip install -r requirements.txt
+- name: Lint with flake8
+  run: |
+    pip install flake8
+    flake8 .
+```
+{% endraw %}
+
+#### Running tests with tox
+
+With {% data variables.product.prodname_actions %}, you can run tests with tox and spread the work across multiple jobs. You'll need to invoke tox using the `-e py` option to choose the version of Python in your `PATH`, rather than specifying a specific version. For more information, see [tox](https://tox.readthedocs.io/en/latest/).
+
+{% raw %}
+```yaml
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python: [2.7, 3.7, 3.8]
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Setup Python
+        uses: actions/setup-python@v2
+        with:
+          python-version: ${{ matrix.python }}
+      - name: Install Tox and any other packages
+        run: pip install tox
+      - name: Run Tox
+        # Run tox using the version of Python in `PATH`
+        run: tox -e py
+```
+{% endraw %}
+
+### Packaging workflow data as artifacts
+
+You can upload artifacts to view after a workflow completes. For example, you may need to save log files, core dumps, test results, or screenshots. For more information, see "[Persisting workflow data using artifacts](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)."
+
+The following example demonstrates how you can use the `upload-artifact` action to archive test results from running `pytest`. For more information, see the [`upload-artifact` action](https://github.com/actions/upload-artifact).
+
+{% raw %}
+```yaml
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: [2.7, 3.5, 3.6, 3.7, 3.8]
+
+      steps:
+      - uses: actions/checkout@v2
+      - name: Setup Python # Set Python version
+        uses: actions/setup-python@v2
+        with:
+          python-version: ${{ matrix.python-version }}
+      # Install pip and pytest
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install pytest
+      - name: Test with pytest
+        run: pytest tests.py --doctest-modules --junitxml=junit/test-results-${{ matrix.python-version }}.xml
+      - name: Upload pytest test results
+        uses: actions/upload-artifact@v2
+        with:
+          name: pytest-results-${{ matrix.python-version }}
+          path: junit/test-results-${{ matrix.python-version }}.xml
+        # Use always() to always run this step to publish test results when there are test failures
+        if: ${{ always() }}
+```
+{% endraw %}
+
+### Publishing to package registries
+
+You can configure your workflow to publish your Python package to any package registry you'd like when your CI tests pass.
+
+You can store any access tokens or credentials needed to publish your package using repository secrets. The following example creates and publishes a package to PyPI using `twine` and `dist`. For more information, see "[Creating and using encrypted secrets](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
+
+{% raw %}
+```yaml
+name: Upload Python Package
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python
+      uses: actions/setup-python@v2
+      with:
+        python-version: '3.x'
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install setuptools wheel twine
+    - name: Build and publish
+      env:
+        TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }}
+        TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
+      run: |
+        python setup.py sdist bdist_wheel
+        twine upload dist/*
+```
+{% endraw %}
+
+For more information about the template workflow, see [`python-publish`](https://github.com/actions/starter-workflows/blob/main/ci/python-publish.yml).
diff --git a/translations/ko-KR/content/actions/guides/caching-dependencies-to-speed-up-workflows.md b/translations/ko-KR/content/actions/guides/caching-dependencies-to-speed-up-workflows.md
new file mode 100644
index 000000000000..497bcad57e58
--- /dev/null
+++ b/translations/ko-KR/content/actions/guides/caching-dependencies-to-speed-up-workflows.md
@@ -0,0 +1,192 @@
+---
+title: Caching dependencies to speed up workflows
+shortTitle: Caching dependencies
+intro: 'To make your workflows faster and more efficient, you can create and use caches for dependencies and other commonly reused files.'
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /github/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows
+  - /actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows
+  - /actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows
+versions:
+  free-pro-team: '*'
+---
+
+### About caching workflow dependencies
+
+Workflow runs often reuse the same outputs or downloaded dependencies from one run to another. For example, package and dependency management tools such as Maven, Gradle, npm, and Yarn keep a local cache of downloaded dependencies.
+
+Jobs on {% data variables.product.prodname_dotcom %}-hosted runners start in a clean virtual environment and must download dependencies each time, causing increased network utilization, longer runtime, and increased cost. To help speed up the time it takes to recreate these files, {% data variables.product.prodname_dotcom %} can cache dependencies you frequently use in workflows.
+
+To cache dependencies for a job, you'll need to use {% data variables.product.prodname_dotcom %}'s `cache` action. The action retrieves a cache identified by a unique key. For more information, see [`actions/cache`](https://github.com/actions/cache).
+
+{% warning %}
+
+**Warning**: We recommend that you don't store any sensitive information in the cache of public repositories. For example, sensitive information can include access tokens or login credentials stored in a file in the cache path. Also, command line interface (CLI) programs like `docker login` can save access credentials in a configuration file. Anyone with read access can create a pull request on a repository and access the contents of the cache. Forks of a repository can also create pull requests on the base branch and access caches on the base branch.
+
+{% endwarning %}
+
+### Comparing artifacts and dependency caching
+
+Artifacts and caching are similar because they provide the ability to store files on {% data variables.product.prodname_dotcom %}, but each feature offers different use cases and cannot be used interchangeably.
+
+- Use caching when you want to reuse files that don't change often between jobs or workflow runs.
+- Use artifacts when you want to save files produced by a job to view after a workflow has ended. For more information, see "[Persisting workflow data using artifacts](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)."
+
+### Restrictions for accessing a cache
+
+With `v2` of the `cache` action, you can access the cache in workflows triggered by any event that has a `GITHUB_REF`. If you are using `v1` of the `cache` action, you can only access the cache in workflows triggered by `push` and `pull_request` events, except for the `pull_request` `closed` event. For more information, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows)."
+
+A workflow can access and restore a cache created in the current branch, the base branch (including base branches of forked repositories), or the default branch (usually `main`). For example, a cache created on the default branch would be accessible from any pull request. Also, if the branch `feature-b` has the base branch `feature-a`, a workflow triggered on `feature-b` would have access to caches created in the default branch (`main`), `feature-a`, and `feature-b`.
+
+Access restrictions provide cache isolation and security by creating a logical boundary between different workflows and branches. For example, a cache created for the branch `feature-a` (with the base `main`) would not be accessible to a pull request for the branch `feature-b` (with the base `main`).
+
+### Using the `cache` action
+
+The `cache` action will attempt to restore a cache based on the `key` you provide. When the action finds a cache, the action restores the cached files to the `path` you configure.
+
+If there is no exact match, the action creates a new cache entry if the job completes successfully. The new cache will use the `key` you provided and contains the files in the `path` directory.
+
+You can optionally provide a list of `restore-keys` to use when the `key` doesn't match an existing cache. A list of `restore-keys` is useful when you are restoring a cache from another branch because `restore-keys` can partially match cache keys. For more information about matching `restore-keys`, see "[Matching a cache key](#matching-a-cache-key)."
+
+For more information, see [`actions/cache`](https://github.com/actions/cache).
+
+#### Input parameters for the `cache` action
+
+- `key`: **Required** The key created when saving a cache and the key used to search for a cache. Can be any combination of variables, context values, static strings, and functions. Keys have a maximum length of 512 characters, and keys longer than the maximum length will cause the action to fail.
+- `path`: **Required** The file path on the runner to cache or restore. The path can be an absolute path or relative to the working directory.
+  - With `v2` of the `cache` action, you can specify a single path, or multiple paths as a list. Paths can be either directories or single files, and glob patterns are supported.
+  - With `v1` of the `cache` action, only a single path is supported and it must be a directory. You cannot cache a single file.
+- `restore-keys`: **Optional** An ordered list of alternative keys to use for finding the cache if no cache hit occurred for `key`.
+
+#### Output parameters for the `cache` action
+
+- `cache-hit`: A boolean value to indicate an exact match was found for the key.
+
+#### Example using the `cache` action
+
+This example creates a new cache when the packages in `package-lock.json` file change, or when the runner's operating system changes. The cache key uses contexts and expressions to generate a key that includes the runner's operating system and a SHA-256 hash of the `package-lock.json` file.
+
+{% raw %}
+```yaml
+name: Caching with npm
+
+on: push
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+
+    - name: Cache node modules
+      uses: actions/cache@v2
+      env:
+        cache-name: cache-node-modules
+      with:
+        # npm cache files are stored in `~/.npm` on Linux/macOS
+        path: ~/.npm
+        key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }}
+        restore-keys: |
+          ${{ runner.os }}-build-${{ env.cache-name }}-
+          ${{ runner.os }}-build-
+          ${{ runner.os }}-
+
+    - name: Install Dependencies
+      run: npm install
+
+    - name: Build
+      run: npm build
+
+    - name: Test
+      run: npm test
+
+```
+{% endraw %}
+
+When `key` matches an existing cache, it's called a cache hit, and the action restores the cached files to the `path` directory.
+
+When `key` doesn't match an existing cache, it's called a cache miss, and a new cache is created if the job completes successfully. When a cache miss occurs, the action searches for alternate keys called `restore-keys`.
+
+1. If you provide `restore-keys`, the `cache` action sequentially searches for any caches that match the list of `restore-keys`.
+   - When there is an exact match, the action restores the files in the cache to the `path` directory.
+   - If there are no exact matches, the action searches for partial matches of the restore keys. When the action finds a partial match, the most recent cache is restored to the `path` directory.
+1. The `cache` action completes and the next workflow step in the job runs.
+1. If the job completes successfully, the action creates a new cache with the contents of the `path` directory.
+
+To cache files in more than one directory, you will need a step that uses the [`cache`](https://github.com/actions/cache) action for each directory. Once you create a cache, you cannot change the contents of an existing cache but you can create a new cache with a new key.
+
+#### Using contexts to create cache keys
+
+A cache key can include any of the contexts, functions, literals, and operators supported by {% data variables.product.prodname_actions %}. For more information, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)."
+
+Using expressions to create a `key` allows you to automatically create a new cache when dependencies have changed. For example, you can create a `key` using an expression that calculates the hash of an npm `package-lock.json` file.
+
+{% raw %}
+```
+npm-${{ hashFiles('package-lock.json') }}
+```
+{% endraw %}
+
+{% data variables.product.prodname_dotcom %} evaluates the expression `hash "package-lock.json"` to derive the final `key`.
+
+```
+npm-d5ea0750
+```
+
+### Matching a cache key
+
+The `cache` action first searches for cache hits for `key` and `restore-keys` in the branch containing the workflow run. If there are no hits in the current branch, the `cache` action searches for `key` and `restore-keys` in the parent branch and upstream branches.
+
+You can provide a list of restore keys to use when there is a cache miss on `key`. You can create multiple restore keys ordered from the most specific to least specific. The `cache` action searches for `restore-keys` in sequential order. When a key doesn't match directly, the action searches for keys prefixed with the restore key. If there are multiple partial matches for a restore key, the action returns the most recently created cache.
+
+#### Example using multiple restore keys
+
+{% raw %}
+```
+restore-keys: |
+  npm-foobar-${{ hashFiles('package-lock.json') }}
+  npm-foobar-
+  npm-
+```
+{% endraw %}
+
+The runner evaluates the expressions, which resolve to these `restore-keys`:
+
+{% raw %}
+```
+restore-keys: |
+  npm-foobar-d5ea0750
+  npm-foobar-
+  npm-
+```
+{% endraw %}
+
+The restore key `npm-foobar-` matches any key that starts with the string `npm-foobar-`. For example, both of the keys `npm-foobar-fd3052de` and `npm-foobar-a9b253ff` match the restore key. The cache with the most recent creation date would be used. The keys in this example are searched in the following order:
+
+1. **`npm-foobar-d5ea0750`** matches a specific hash.
+1. **`npm-foobar-`** matches cache keys prefixed with `npm-foobar-`.
+1. **`npm-`** matches any keys prefixed with `npm-`.
+
+##### Example of search priority
+
+```yaml
+key:
+  npm-feature-d5ea0750
+restore-keys: |
+  npm-feature-
+  npm-
+```
+
+For example, if a pull request contains a `feature` branch (the current scope) and targets the default branch (`main`), the action searches for `key` and `restore-keys` in the following order:
+
+1. Key `npm-feature-d5ea0750` in the `feature` branch scope
+1. Key `npm-feature-` in the `feature` branch scope
+2. Key `npm-` in the `feature` branch scope
+1. Key `npm-feature-d5ea0750` in the `main` branch scope
+3. Key `npm-feature-` in the `main` branch scope
+4. Key `npm-` in the `main` branch scope
+
+### Usage limits and eviction policy
+
+{% data variables.product.prodname_dotcom %} will remove any cache entries that have not been accessed in over 7 days. There is no limit on the number of caches you can store, but the total size of all caches in a repository is limited to 5 GB. If you exceed this limit, {% data variables.product.prodname_dotcom %} will save your cache but will begin evicting caches until the total size is less than 5 GB.
diff --git a/translations/ko-KR/content/actions/guides/creating-postgresql-service-containers.md b/translations/ko-KR/content/actions/guides/creating-postgresql-service-containers.md
new file mode 100644
index 000000000000..bde966be19ff
--- /dev/null
+++ b/translations/ko-KR/content/actions/guides/creating-postgresql-service-containers.md
@@ -0,0 +1,335 @@
+---
+title: Creating PostgreSQL service containers
+shortTitle: PostgreSQL service containers
+intro: You can create a PostgreSQL service container to use in your workflow. This guide shows examples of creating a PostgreSQL service for jobs that run in containers or directly on the runner machine.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/creating-postgresql-service-containers
+  - /actions/configuring-and-managing-workflows/creating-postgresql-service-containers
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introduction
+
+This guide shows you workflow examples that configure a service container using the Docker Hub `postgres` image. The workflow runs a script to create a PostgreSQL client and populate the client with data. To test that the workflow creates and populates the PostgreSQL client, the script prints the client's data to the console.
+
+{% data reusables.github-actions.docker-container-os-support %}
+
+### 빌드전 요구 사양
+
+{% data reusables.github-actions.service-container-prereqs %}
+
+You may also find it helpful to have a basic understanding of YAML, the syntax for {% data variables.product.prodname_actions %}, and PostgreSQL. For more information, see:
+
+- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)"
+- "[PostgreSQL tutorial](https://www.postgresqltutorial.com/)" in the PostgreSQL documentation
+
+### Running jobs in containers
+
+{% data reusables.github-actions.container-jobs-intro %}
+
+{% data reusables.github-actions.copy-workflow-file %}
+
+{% raw %}
+```yaml
+name: PostgreSQL service example
+on: push
+
+jobs:
+  # Label of the container job
+  container-job:
+    # Containers must run in Linux based operating systems
+    runs-on: ubuntu-latest
+    # Docker Hub image that `container-job` executes in
+    container: node:10.18-jessie
+
+    # Service containers to run with `container-job`
+    services:
+      # Label used to access the service container
+      postgres:
+        # Docker Hub image
+        image: postgres
+        # Provide the password for postgres
+        env:
+          POSTGRES_PASSWORD: postgres
+        # Set health checks to wait until postgres has started
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
+    steps:
+      # Downloads a copy of the code in your repository before running CI tests
+      - name: Check out repository code
+        uses: actions/checkout@v2
+
+      # Performs a clean installation of all dependencies in the `package.json` file
+      # For more information, see https://docs.npmjs.com/cli/ci.html
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Connect to PostgreSQL
+        # Runs a script that creates a PostgreSQL client, populates
+        # the client with data, and retrieves data
+        run: node client.js
+        # Environment variable used by the `client.js` script to create a new PostgreSQL client.
+        env:
+          # The hostname used to communicate with the PostgreSQL service container
+          POSTGRES_HOST: postgres
+          # The default PostgreSQL port
+          POSTGRES_PORT: 5432
+```
+{% endraw %}
+
+#### Configuring the runner job
+
+{% data reusables.github-actions.service-container-host %}
+
+{% data reusables.github-actions.postgres-label-description %}
+
+```yaml
+jobs:
+  # Label of the container job
+  container-job:
+    # Containers must run in Linux based operating systems
+    runs-on: ubuntu-latest
+    # Docker Hub image that `container-job` executes in
+    container: node:10.18-jessie
+
+    # Service containers to run with `container-job`
+    services:
+      # Label used to access the service container
+      postgres:
+        # Docker Hub image
+        image: postgres
+        # Provide the password for postgres
+        env:
+          POSTGRES_PASSWORD: postgres
+        # Set health checks to wait until postgres has started
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+```
+
+#### Configuring the steps
+
+{% data reusables.github-actions.service-template-steps %}
+
+```yaml
+steps:
+  # Downloads a copy of the code in your repository before running CI tests
+  - name: Check out repository code
+    uses: actions/checkout@v2
+
+  # Performs a clean installation of all dependencies in the `package.json` file
+  # For more information, see https://docs.npmjs.com/cli/ci.html
+  - name: Install dependencies
+    run: npm ci
+
+  - name: Connect to PostgreSQL
+    # Runs a script that creates a PostgreSQL client, populates
+    # the client with data, and retrieves data
+    run: node client.js
+    # Environment variable used by the `client.js` script to create
+    # a new PostgreSQL client.
+    env:
+      # The hostname used to communicate with the PostgreSQL service container
+      POSTGRES_HOST: postgres
+      # The default PostgreSQL port
+      POSTGRES_PORT: 5432
+```
+
+{% data reusables.github-actions.postgres-environment-variables %}
+
+The hostname of the PostgreSQL service is the label you configured in your workflow, in this case, `postgres`. Because Docker containers on the same user-defined bridge network open all ports by default, you'll be able to access the service container on the default PostgreSQL port 5432.
+
+### Running jobs directly on the runner machine
+
+When you run a job directly on the runner machine, you'll need to map the ports on the service container to ports on the Docker host. You can access service containers from the Docker host using `localhost` and the Docker host port number.
+
+{% data reusables.github-actions.copy-workflow-file %}
+
+{% raw %}
+```yaml
+name: PostgreSQL Service Example
+on: push
+
+jobs:
+  # Label of the runner job
+  runner-job:
+    # You must use a Linux environment when using service containers or container jobs
+    runs-on: ubuntu-latest
+
+    # Service containers to run with `runner-job`
+    services:
+      # Label used to access the service container
+      postgres:
+        # Docker Hub image
+        image: postgres
+        # Provide the password for postgres
+        env:
+          POSTGRES_PASSWORD: postgres
+        # Set health checks to wait until postgres has started
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          # Maps tcp port 5432 on service container to the host
+          - 5432:5432
+
+    steps:
+      # Downloads a copy of the code in your repository before running CI tests
+      - name: Check out repository code
+        uses: actions/checkout@v2
+
+      # Performs a clean installation of all dependencies in the `package.json` file
+      # For more information, see https://docs.npmjs.com/cli/ci.html
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Connect to PostgreSQL
+        # Runs a script that creates a PostgreSQL client, populates
+        # the client with data, and retrieves data
+        run: node client.js
+        # Environment variable used by the `client.js` script to create
+        # a new PostgreSQL client.
+        env:
+          # The hostname used to communicate with the PostgreSQL service container
+          POSTGRES_HOST: localhost
+          # The default PostgreSQL port
+          POSTGRES_PORT: 5432
+```
+{% endraw %}
+
+#### Configuring the runner job
+
+{% data reusables.github-actions.service-container-host-runner %}
+
+{% data reusables.github-actions.postgres-label-description %}
+
+The workflow maps port 5432 on the PostgreSQL service container to the Docker host. For more information about the `ports` keyword, see "[About service containers](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)."
+
+```yaml
+jobs:
+  # Label of the runner job
+  runner-job:
+    # You must use a Linux environment when using service containers or container jobs
+    runs-on: ubuntu-latest
+
+    # Service containers to run with `runner-job`
+    services:
+      # Label used to access the service container
+      postgres:
+        # Docker Hub image
+        image: postgres
+        # Provide the password for postgres
+        env:
+          POSTGRES_PASSWORD: postgres
+        # Set health checks to wait until postgres has started
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          # Maps tcp port 5432 on service container to the host
+          - 5432:5432
+```
+
+#### Configuring the steps
+
+{% data reusables.github-actions.service-template-steps %}
+
+```yaml
+steps:
+  # Downloads a copy of the code in your repository before running CI tests
+  - name: Check out repository code
+    uses: actions/checkout@v2
+
+  # Performs a clean installation of all dependencies in the `package.json` file
+  # For more information, see https://docs.npmjs.com/cli/ci.html
+  - name: Install dependencies
+    run: npm ci
+
+  - name: Connect to PostgreSQL
+    # Runs a script that creates a PostgreSQL client, populates
+    # the client with data, and retrieves data
+    run: node client.js
+    # Environment variable used by the `client.js` script to create
+    # a new PostgreSQL client.
+    env:
+      # The hostname used to communicate with the PostgreSQL service container
+      POSTGRES_HOST: localhost
+      # The default PostgreSQL port
+      POSTGRES_PORT: 5432
+```
+
+{% data reusables.github-actions.postgres-environment-variables %}
+
+{% data reusables.github-actions.service-container-localhost %}
+
+### Testing the PostgreSQL service container
+
+You can test your workflow using the following script, which creates a PostgreSQL client and adds a new table with some placeholder data. The script then prints the values stored in the PostgreSQL client to the terminal. Your script can use any language you'd like, but this example uses Node.js and the `pg` npm module. For more information, see the [npm pg module](https://www.npmjs.com/package/pg).
+
+You can modify *client.js* to include any PostgreSQL operations needed by your workflow. In this example, the script creates the PostgreSQL client instance, creates a table, adds placeholder data, then retrieves the data.
+
+{% data reusables.github-actions.service-container-add-script %}
+
+```javascript
+const { Client } = require('pg');
+
+const pgclient = new Client({
+    host: process.env.POSTGRES_HOST,
+    port: process.env.POSTGRES_PORT,
+    user: 'postgres',
+    password: 'postgres',
+    database: 'postgres'
+});
+
+pgclient.connect();
+
+const table = 'CREATE TABLE student(id SERIAL PRIMARY KEY, firstName VARCHAR(40) NOT NULL, lastName VARCHAR(40) NOT NULL, age INT, address VARCHAR(80), email VARCHAR(40))'
+const text = 'INSERT INTO student(firstname, lastname, age, address, email) VALUES($1, $2, $3, $4, $5) RETURNING *'
+const values = ['Mona the', 'Octocat', 9, '88 Colin P Kelly Jr St, San Francisco, CA 94107, United States', 'octocat@github.com']
+
+pgclient.query(table, (err, res) => {
+    if (err) throw err
+});
+
+pgclient.query(text, values, (err, res) => {
+    if (err) throw err
+});
+
+pgclient.query('SELECT * FROM student', (err, res) => {
+    if (err) throw err
+    console.log(err, res.rows) // Print the data in student table
+    pgclient.end()
+});
+```
+
+The script creates a new PostgreSQL `Client`, which accepts a `host` and `port` parameter. The script uses the `POSTGRES_HOST` and `POSTGRES_PORT` environment variables to set the client's IP address and port. If `host` and `port` are not defined, the default host is `localhost` and the default port is 5432.
+
+The script creates a table and populates it with placeholder data. To test that the PostgreSQL database contains the data, the script prints the contents of the table to the console log.
+
+When you run this workflow, you should see the following output in the "Connect to PostgreSQL" step confirming you created the PostgreSQL client and added data:
+
+```
+null [ { id: 1,
+    firstname: 'Mona the',
+    lastname: 'Octocat',
+    age: 9,
+    address:
+     '88 Colin P Kelly Jr St, San Francisco, CA 94107, United States',
+    email: 'octocat@github.com' } ]
+```
diff --git a/translations/ko-KR/content/actions/guides/creating-redis-service-containers.md b/translations/ko-KR/content/actions/guides/creating-redis-service-containers.md
new file mode 100644
index 000000000000..ba3278085fd9
--- /dev/null
+++ b/translations/ko-KR/content/actions/guides/creating-redis-service-containers.md
@@ -0,0 +1,325 @@
+---
+title: Creating Redis service containers
+shortTitle: Redis service containers
+intro: You can use service containers to create a Redis client in your workflow. This guide shows examples of creating a Redis service for jobs that run in containers or directly on the runner machine.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/creating-redis-service-containers
+  - /actions/configuring-and-managing-workflows/creating-redis-service-containers
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introduction
+
+This guide shows you workflow examples that configure a service container using the Docker Hub `redis` image. The workflow runs a script to create a Redis client and populate the client with data. To test that the workflow creates and populates the Redis client, the script prints the client's data to the console.
+
+{% data reusables.github-actions.docker-container-os-support %}
+
+### 빌드전 요구 사양
+
+{% data reusables.github-actions.service-container-prereqs %}
+
+You may also find it helpful to have a basic understanding of YAML, the syntax for {% data variables.product.prodname_actions %}, and Redis. For more information, see:
+
+- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)"
+- "[Getting Started with Redis](https://redislabs.com/get-started-with-redis/)" in the Redis documentation
+
+### Running jobs in containers
+
+{% data reusables.github-actions.container-jobs-intro %}
+
+{% data reusables.github-actions.copy-workflow-file %}
+
+{% raw %}
+```yaml
+name: Redis container example
+on: push
+
+jobs:
+  # Label of the container job
+  container-job:
+    # Containers must run in Linux based operating systems
+    runs-on: ubuntu-latest
+    # Docker Hub image that `container-job` executes in
+    container: node:10.18-jessie
+
+    # Service containers to run with `container-job`
+    services:
+      # Label used to access the service container
+      redis:
+        # Docker Hub image
+        image: redis
+        # Set health checks to wait until redis has started
+        options: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
+    steps:
+      # Downloads a copy of the code in your repository before running CI tests
+      - name: Check out repository code
+        uses: actions/checkout@v2
+
+      # Performs a clean installation of all dependencies in the `package.json` file
+      # For more information, see https://docs.npmjs.com/cli/ci.html
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Connect to Redis
+        # Runs a script that creates a Redis client, populates
+        # the client with data, and retrieves data
+        run: node client.js
+        # Environment variable used by the `client.js` script to create a new Redis client.
+        env:
+          # The hostname used to communicate with the Redis service container
+          REDIS_HOST: redis
+          # The default Redis port
+          REDIS_PORT: 6379
+```
+{% endraw %}
+
+#### Configuring the container job
+
+{% data reusables.github-actions.service-container-host %}
+
+{% data reusables.github-actions.redis-label-description %}
+
+```yaml
+jobs:
+  # Label of the container job
+  container-job:
+    # Containers must run in Linux based operating systems
+    runs-on: ubuntu-latest
+    # Docker Hub image that `container-job` executes in
+    container: node:10.18-jessie
+
+    # Service containers to run with `container-job`
+    services:
+      # Label used to access the service container
+      redis:
+        # Docker Hub image
+        image: redis
+        # Set health checks to wait until redis has started
+        options: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+```
+
+#### Configuring the steps
+
+{% data reusables.github-actions.service-template-steps %}
+
+```yaml
+steps:
+  # Downloads a copy of the code in your repository before running CI tests
+  - name: Check out repository code
+    uses: actions/checkout@v2
+
+  # Performs a clean installation of all dependencies in the `package.json` file
+  # For more information, see https://docs.npmjs.com/cli/ci.html
+  - name: Install dependencies
+    run: npm ci
+
+  - name: Connect to Redis
+    # Runs a script that creates a Redis client, populates
+    # the client with data, and retrieves data
+    run: node client.js
+    # Environment variable used by the `client.js` script to create a new Redis client.
+    env:
+      # The hostname used to communicate with the Redis service container
+      REDIS_HOST: redis
+      # The default Redis port
+      REDIS_PORT: 6379
+```
+
+{% data reusables.github-actions.redis-environment-variables %}
+
+The hostname of the Redis service is the label you configured in your workflow, in this case, `redis`. Because Docker containers on the same user-defined bridge network open all ports by default, you'll be able to access the service container on the default Redis port 6379.
+
+### Running jobs directly on the runner machine
+
+When you run a job directly on the runner machine, you'll need to map the ports on the service container to ports on the Docker host. You can access service containers from the Docker host using `localhost` and the Docker host port number.
+
+{% data reusables.github-actions.copy-workflow-file %}
+
+{% raw %}
+```yaml
+name: Redis runner example
+on: push
+
+jobs:
+  # Label of the runner job
+  runner-job:
+    # You must use a Linux environment when using service containers or container jobs
+    runs-on: ubuntu-latest
+
+    # Service containers to run with `runner-job`
+    services:
+      # Label used to access the service container
+      redis:
+        # Docker Hub image
+        image: redis
+        # Set health checks to wait until redis has started
+        options: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          # Maps port 6379 on service container to the host
+          - 6379:6379
+
+    steps:
+      # Downloads a copy of the code in your repository before running CI tests
+      - name: Check out repository code
+        uses: actions/checkout@v2
+
+      # Performs a clean installation of all dependencies in the `package.json` file
+      # For more information, see https://docs.npmjs.com/cli/ci.html
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Connect to Redis
+        # Runs a script that creates a Redis client, populates
+        # the client with data, and retrieves data
+        run: node client.js
+        # Environment variable used by the `client.js` script to create
+        # a new Redis client.
+        env:
+          # The hostname used to communicate with the Redis service container
+          REDIS_HOST: localhost
+          # The default Redis port
+          REDIS_PORT: 6379
+```
+{% endraw %}
+
+#### Configuring the runner job
+
+{% data reusables.github-actions.service-container-host-runner %}
+
+{% data reusables.github-actions.redis-label-description %}
+
+The workflow maps port 6379 on the Redis service container to the Docker host. For more information about the `ports` keyword, see "[About service containers](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)."
+
+```yaml
+jobs:
+  # Label of the runner job
+  runner-job:
+    # You must use a Linux environment when using service containers or container jobs
+    runs-on: ubuntu-latest
+
+    # Service containers to run with `runner-job`
+    services:
+      # Label used to access the service container
+      redis:
+        # Docker Hub image
+        image: redis
+        # Set health checks to wait until redis has started
+        options: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          # Maps port 6379 on service container to the host
+          - 6379:6379
+```
+
+#### Configuring the steps
+
+{% data reusables.github-actions.service-template-steps %}
+
+```yaml
+steps:
+  # Downloads a copy of the code in your repository before running CI tests
+  - name: Check out repository code
+    uses: actions/checkout@v2
+
+  # Performs a clean installation of all dependencies in the `package.json` file
+  # For more information, see https://docs.npmjs.com/cli/ci.html
+  - name: Install dependencies
+    run: npm ci
+
+  - name: Connect to Redis
+    # Runs a script that creates a Redis client, populates
+    # the client with data, and retrieves data
+    run: node client.js
+    # Environment variable used by the `client.js` script to create
+    # a new Redis client.
+    env:
+      # The hostname used to communicate with the Redis service container
+      REDIS_HOST: localhost
+      # The default Redis port
+      REDIS_PORT: 6379
+```
+
+{% data reusables.github-actions.redis-environment-variables %}
+
+{% data reusables.github-actions.service-container-localhost %}
+
+### Testing the Redis service container
+
+You can test your workflow using the following script, which creates a Redis client and populates the client with some placeholder data. The script then prints the values stored in the Redis client to the terminal. Your script can use any language you'd like, but this example uses Node.js and the `redis` npm module. For more information, see the [npm redis module](https://www.npmjs.com/package/redis).
+
+You can modify *client.js* to include any Redis operations needed by your workflow. In this example, the script creates the Redis client instance, adds placeholder data, then retrieves the data.
+
+{% data reusables.github-actions.service-container-add-script %}
+
+```javascript
+const redis = require("redis");
+
+// Creates a new Redis client
+// If REDIS_HOST is not set, the default host is localhost
+// If REDIS_PORT is not set, the default port is 6379
+const redisClient = redis.createClient({
+  host: process.env.REDIS_HOST,
+  port: process.env.REDIS_PORT  
+});
+
+redisClient.on("error", function(err) {
+    console.log("Error " + err);
+});
+
+// Sets the key "octocat" to a value of "Mona the octocat"
+redisClient.set("octocat", "Mona the Octocat", redis.print);
+// Sets a key to "octocat", field to "species", and "value" to "Cat and Octopus"
+redisClient.hset("species", "octocat", "Cat and Octopus", redis.print);
+// Sets a key to "octocat", field to "species", and "value" to "Dinosaur and Octopus"
+redisClient.hset("species", "dinotocat", "Dinosaur and Octopus", redis.print);
+// Sets a key to "octocat", field to "species", and "value" to "Cat and Robot"
+redisClient.hset(["species", "robotocat", "Cat and Robot"], redis.print);
+// Gets all fields in "species" key
+
+redisClient.hkeys("species", function (err, replies) {
+    console.log(replies.length + " replies:");
+    replies.forEach(function (reply, i) {
+        console.log("    " + i + ": " + reply);
+    });
+    redisClient.quit();
+});
+```
+
+The script creates a new Redis client using the `createClient` method, which accepts a `host` and `port` parameter. The script uses the `REDIS_HOST` and `REDIS_PORT` environment variables to set the client's IP address and port. If `host` and `port` are not defined, the default host is `localhost` and the default port is 6379.
+
+The script uses the `set` and `hset` methods to populate the database with some keys, fields, and values. To confirm that the Redis client contains the data, the script prints the contents of the database to the console log.
+
+When you run this workflow, you should see the following output in the "Connect to Redis" step confirming you created the Redis client and added data:
+
+```
+Reply: OK
+Reply: 1
+Reply: 1
+Reply: 1  
+3 replies:
+    0: octocat
+    1: dinotocat
+    2: robotocat
+```
diff --git a/translations/ko-KR/content/actions/guides/index.md b/translations/ko-KR/content/actions/guides/index.md
new file mode 100644
index 000000000000..42c98b828dd3
--- /dev/null
+++ b/translations/ko-KR/content/actions/guides/index.md
@@ -0,0 +1,60 @@
+---
+title: 안내서
+shortTitle: 안내서
+intro: 'These guides for {% data variables.product.prodname_actions %} include specific use cases and examples to help you configure workflows.'
+redirect_from:
+  - /actions/guides/caching-and-storing-workflow-data
+  - /actions/automating-your-workflow-with-github-actions/using-databases-and-services
+  - /actions/configuring-and-managing-workflows/using-databases-and-service-containers
+  - /actions/guides/using-databases-and-service-containers
+  - /actions/language-and-framework-guides
+  - /actions/language-and-framework-guides/github-actions-for-docker
+  - /actions/language-and-framework-guides/github-actions-for-java
+  - /actions/language-and-framework-guides/github-actions-for-javascript-and-typescript
+  - /actions/language-and-framework-guides/github-actions-for-python
+  - /actions/publishing-packages-with-github-actions
+  - /actions/building-and-testing-code-with-continuous-integration
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Creating custom continuous integration workflows
+
+You can use {% data variables.product.prodname_actions %} to create custom continuous integration (CI) workflows that build and test projects written in different programming languages.
+
+{% link_in_list /about-continuous-integration %}
+{% link_in_list /setting-up-continuous-integration-using-workflow-templates %}
+{% link_in_list /building-and-testing-nodejs %}
+{% link_in_list /building-and-testing-python %}
+{% link_in_list /building-and-testing-java-with-maven %}
+{% link_in_list /building-and-testing-java-with-gradle %}
+{% link_in_list /building-and-testing-java-with-ant %}
+
+### Publishing software packages
+
+You can automate publishing software packages as part your continuous delivery (CD) workflow. Packages can be published to any package host and to {% data reusables.gated-features.packages %}.
+
+{% link_in_list /about-packaging-with-github-actions %}
+{% link_in_list /publishing-nodejs-packages %}
+{% link_in_list /publishing-java-packages-with-maven %}
+{% link_in_list /publishing-java-packages-with-gradle %}
+{% link_in_list /publishing-docker-images %}
+
+### Caching and storing workflow data
+
+Cache dependencies and store artifacts to make your workflow runs more efficient.
+
+{% link_in_list /storing-workflow-data-as-artifacts %}
+{% link_in_list /caching-dependencies-to-speed-up-workflows %}
+
+### Using service containers in a workflow
+
+Connect services to your workflow using service containers.
+
+{% link_in_list /about-service-containers %}
+{% link_in_list /creating-redis-service-containers %}
+{% link_in_list /creating-postgresql-service-containers %}
diff --git a/translations/ko-KR/content/actions/guides/publishing-docker-images.md b/translations/ko-KR/content/actions/guides/publishing-docker-images.md
new file mode 100644
index 000000000000..7778800a8061
--- /dev/null
+++ b/translations/ko-KR/content/actions/guides/publishing-docker-images.md
@@ -0,0 +1,158 @@
+---
+title: Publishing Docker images
+intro: 'You can publish Docker images to a registry, such as Docker Hub or {% data variables.product.prodname_registry %}, as part of your continuous integration (CI) workflow.'
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/publishing-docker-images
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introduction
+
+This guide shows you how to create a workflow that performs a Docker build, and then publishes Docker images to Docker Hub or {% data variables.product.prodname_registry %}. With a single workflow, you can publish images to a single registry or to multiple registries.
+
+{% note %}
+
+**Note:** If you want to push to another third-party Docker registry, the example in the "[Publishing images to {% data variables.product.prodname_registry %}](#publishing-images-to-github-packages)" section can serve as a good template.
+
+{% endnote %}
+
+### 빌드전 요구 사양
+
+We recommend that you have a basic understanding of workflow configuration options and how to create a workflow file. For more information, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)."
+
+You might also find it helpful to have a basic understanding of the following:
+
+- "[Encrypted secrets](/actions/reference/encrypted-secrets)"
+- "[Authentication in a workflow](/actions/reference/authentication-in-a-workflow)"
+- "[Configuring Docker for use with {% data variables.product.prodname_registry %}](/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)"
+
+### About image configuration
+
+This guide assumes that you have a complete definition for a Docker image stored in a {% data variables.product.prodname_dotcom %} repository. For example, your repository must contain a _Dockerfile_, and any other files needed to perform a Docker build to create an image.
+
+In this guide, we will use the Docker `build-push-action` action to build the Docker image and push it to one or more Docker registries. For more information, see [`build-push-action`](https://github.com/marketplace/actions/build-and-push-docker-images).
+
+{% data reusables.actions.enterprise-marketplace-actions %}
+
+### Publishing images to Docker Hub
+
+{% data reusables.github-actions.release-trigger-workflow %}
+
+In the example workflow below, we use the Docker `build-push-action` action to build the Docker image and, if the build succeeds, push the built image to Docker Hub.
+
+To push to Docker Hub, you will need to have a Docker Hub account, and have a Docker Hub repository created. For more information, see "[Share images on Docker Hub](https://docs.docker.com/get-started/part3/)" in the Docker documentation.
+
+The `build-push-action` options required for Docker Hub are:
+
+* `username` and `password`: This is your Docker Hub username and password. We recommend storing your Docker Hub username and password as encrypted secrets in the your {% data variables.product.prodname_dotcom %} repository so they aren't exposed in your workflow file. For more information, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
+* `repository`: Your Docker Hub repository in the format `DOCKER-HUB-NAMESPACE/DOCKER-HUB-REPOSITORY`.
+
+{% raw %}
+```yaml
+name: Publish Docker image
+on:
+  release:
+    types: [published]
+jobs:
+  push_to_registry:
+    name: Push Docker image to Docker Hub
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out the repo
+        uses: actions/checkout@v2
+      - name: Push to Docker Hub
+        uses: docker/build-push-action@v1
+        with:
+          username: ${{ secrets.DOCKER_USERNAME }}
+          password: ${{ secrets.DOCKER_PASSWORD }}
+          repository: my-docker-hub-namespace/my-docker-hub-repository
+          tag_with_ref: true
+```
+{% endraw %}
+
+{% data reusables.github-actions.docker-tag-with-ref %}
+
+### Publishing images to {% data variables.product.prodname_registry %}
+
+{% data reusables.github-actions.release-trigger-workflow %}
+
+In the example workflow below, we use the Docker `build-push-action` action to build the Docker image, and if the build succeeds, push the built image to {% data variables.product.prodname_registry %}.
+
+The `build-push-action` options required for {% data variables.product.prodname_registry %} are:
+
+* `username`: You can use the {% raw %}`${{ github.actor }}`{% endraw %} context to automatically use the username of the user that triggered the workflow run. For more information, see "[Context and expression syntax for GitHub Actions](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)."
+* `password`: You can use the automatically-generated `GITHUB_TOKEN` secret for the password. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)."
+* `registry`: Must be set to `docker.pkg.github.com`.
+* `repository`: Must be set in the format `OWNER/REPOSITORY/IMAGE_NAME`. For example, for an image named `octo-image` stored on {% data variables.product.prodname_dotcom %} at `http://github.com/octo-org/octo-repo`, the `repository` option should be set to `octo-org/octo-repo/octo-image`.
+
+{% raw %}
+```yaml
+name: Publish Docker image
+on:
+  release:
+    types: [published]
+jobs:
+  push_to_registry:
+    name: Push Docker image to GitHub Packages
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out the repo
+        uses: actions/checkout@v2
+      - name: Push to GitHub Packages
+        uses: docker/build-push-action@v1
+        with:
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+          registry: docker.pkg.github.com
+          repository: my-org/my-repo/my-image
+          tag_with_ref: true
+
+```
+{% endraw %}
+
+{% data reusables.github-actions.docker-tag-with-ref %}
+
+### Publishing images to Docker Hub and {% data variables.product.prodname_registry %}
+
+In a single workflow, you can publish your Docker image to multiple registries by using the `build-push-action` action for each registry.
+
+The following example workflow uses the `build-push-action` steps from the previous sections ("[Publishing images to Docker Hub](#publishing-images-to-docker-hub)" and "[Publishing images to {% data variables.product.prodname_registry %}](#publishing-images-to-github-packages)") to create a single workflow that pushes to both registries.
+
+{% raw %}
+```yaml
+name: Publish Docker image
+on:
+  release:
+    types: [published]
+jobs:
+  push_to_registries:
+    name: Push Docker image to multiple registries
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out the repo
+        uses: actions/checkout@v2
+      - name: Push to Docker Hub
+        uses: docker/build-push-action@v1
+        with:
+          username: ${{ secrets.DOCKER_USERNAME }}
+          password: ${{ secrets.DOCKER_PASSWORD }}
+          repository: my-docker-hub-namespace/my-docker-hub-repository
+          tag_with_ref: true
+      - name: Push to GitHub Packages
+        uses: docker/build-push-action@v1
+        with:
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+          registry: docker.pkg.github.com
+          repository: my-org/my-repo/my-image
+          tag_with_ref: true
+```
+{% endraw %}
+
+The above workflow checks out the {% data variables.product.prodname_dotcom %} repository, and uses the `build-push-action` action twice to build and push the Docker image to Docker Hub and {% data variables.product.prodname_registry %}. For both steps, it sets the `build-push-action` option [`tag_with_ref`](https://github.com/marketplace/actions/build-and-push-docker-images#tag_with_ref) to automatically tag the built Docker image with the Git reference of the workflow event. This workflow is triggered on publishing a {% data variables.product.prodname_dotcom %} release, so the reference for both registries will be the Git tag for the release.
diff --git a/translations/ko-KR/content/actions/guides/publishing-java-packages-with-gradle.md b/translations/ko-KR/content/actions/guides/publishing-java-packages-with-gradle.md
new file mode 100644
index 000000000000..379a48545658
--- /dev/null
+++ b/translations/ko-KR/content/actions/guides/publishing-java-packages-with-gradle.md
@@ -0,0 +1,219 @@
+---
+title: Publishing Java packages with Gradle
+intro: You can use Gradle to publish Java packages to a registry as part of your continuous integration (CI) workflow.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/publishing-java-packages-with-gradle
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introduction
+
+{% data reusables.github-actions.publishing-java-packages-intro %}
+
+### 빌드전 요구 사양
+
+We recommend that you have a basic understanding of workflow files and configuration options. For more information, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)."
+
+For more information about creating a CI workflow for your Java project with Gradle, see "[Building and testing Java with Gradle](/actions/language-and-framework-guides/building-and-testing-java-with-gradle)."
+
+You may also find it helpful to have a basic understanding of the following:
+
+- "[Configuring npm for use with {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)"
+- "[Environment variables](/actions/reference/environment-variables)"
+- "[Encrypted secrets](/actions/reference/encrypted-secrets)"
+- "[Authentication in a workflow](/actions/reference/authentication-in-a-workflow)"
+
+### About package configuration
+
+The `groupId` and `artifactId` fields in the `MavenPublication` section of the _build.gradle_ file create a unique identifier for your package that registries use to link your package to a registry.  This is similar to the `groupId` and `artifactId` fields of the Maven _pom.xml_ file.  For more information, see the "[Maven Publish Plugin](https://docs.gradle.org/current/userguide/publishing_maven.html)" in the Gradle documentation.
+
+The _build.gradle_ file also contains configuration for the distribution management repositories that Gradle will publish packages to. Each repository must have a name, a deployment URL, and credentials for authentication.
+
+### Publishing packages to the Maven Central Repository
+
+Each time you create a new release, you can trigger a workflow to publish your package. The workflow in the example below runs when the `release` event triggers with type `created`. The workflow publishes the package to the Maven Central Repository if CI tests pass. For more information on the `release` event, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows#release)."
+
+You can define a new Maven repository in the publishing block of your _build.gradle_ file that points to your package repository.  For example, if you were deploying to the Maven Central Repository through the OSSRH hosting project, your _build.gradle_ could specify a repository with the name `"OSSRH"`.
+
+{% raw %}
+```groovy
+publishing {
+  ...
+
+  repositories {
+    maven {
+      name = "OSSRH"
+      url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/"
+      credentials {
+        username = System.getenv("MAVEN_USERNAME")
+        password = System.getenv("MAVEN_PASSWORD")
+      }
+    }
+  }
+}
+```
+{% endraw %}
+
+With this configuration, you can create a workflow that publishes your package to the Maven Central Repository by running the `gradle publish` command. You’ll also need to provide environment variables that contain the username and password to authenticate to the repository.
+
+In the deploy step, you’ll need to set environment variables for the username and password or token that you use to authenticate to the Maven repository. For more information, see "[Creating and using encrypted secrets](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
+
+
+{% raw %}
+```yaml
+name: Publish package to the Maven Central Repository
+on:
+  release:
+    types: [created]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Java
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Publish package
+        run: gradle publish
+        env:
+          MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
+          MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}
+```
+{% endraw %}
+
+{% data reusables.github-actions.gradle-workflow-steps %}
+1. Runs the `gradle publish` command to publish to the `OSSRH` Maven repository. The `MAVEN_USERNAME` environment variable will be set with the contents of your `OSSRH_USERNAME` secret, and the `MAVEN_PASSWORD` environment variable will be set with the contents of your `OSSRH_TOKEN` secret.
+
+   For more information about using secrets in your workflow, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
+
+### Publishing packages to {% data variables.product.prodname_registry %}
+
+Each time you create a new release, you can trigger a workflow to publish your package. The workflow in the example below runs when the `release` event triggers with type `created`. The workflow publishes the package to {% data variables.product.prodname_registry %} if CI tests pass. For more information on the `release` event, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows#release)."
+
+You can define a new Maven repository in the publishing block of your _build.gradle_ that points to {% data variables.product.prodname_registry %}.  In that repository configuration, you can also take advantage of environment variables set in your CI workflow run.  You can use the `GITHUB_ACTOR` environment variable as a username, and you can set the `GITHUB_TOKEN` environment variable with your `GITHUB_TOKEN` secret.
+
+The `GITHUB_TOKEN` exists in your repository by default and has read and write permissions for packages in the repository where the workflow runs. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)."
+
+For example, if your organization is named "octocat" and your repository is named "hello-world", then the {% data variables.product.prodname_registry %} configuration in _build.gradle_ would look similar to the below example.
+
+{% raw %}
+```groovy
+publishing {
+  ...
+
+  repositories {
+    maven {
+      name = "GitHubPackages"
+      url = "https://maven.pkg.github.com/octocat/hello-world"
+      credentials {
+        username = System.getenv("GITHUB_ACTOR")
+        password = System.getenv("GITHUB_TOKEN")
+      }
+    }
+  }
+}
+```
+{% endraw %}
+
+With this configuration, you can create a workflow that publishes your package to the Maven Central Repository by running the `gradle publish` command.
+
+{% raw %}
+```yaml
+name: Publish package to GitHub Packages
+on:
+  release:
+    types: [created]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Publish package
+        run: gradle publish
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
+
+{% data reusables.github-actions.gradle-workflow-steps %}
+1. Runs the `gradle publish` command to publish to {% data variables.product.prodname_registry %}. The `GITHUB_TOKEN` environment variable will be set with the content of the `GITHUB_TOKEN` secret.
+
+   For more information about using secrets in your workflow, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
+
+### Publishing packages to the Maven Central Repository and {% data variables.product.prodname_registry %}
+
+You can publish your packages to both the Maven Central Repository and {% data variables.product.prodname_registry %} by configuring each in your _build.gradle_ file.
+
+Ensure your _build.gradle_ file includes a repository for both your {% data variables.product.prodname_dotcom %} repository and your Maven Central Repository provider.
+
+For example, if you deploy to the Central Repository through the OSSRH hosting project, you might want to specify it in a distribution management repository with the `name` set to `OSSRH`. If you deploy to {% data variables.product.prodname_registry %}, you might want to specify it in a distribution management repository with the `name` set to `GitHubPackages`.
+
+If your organization is named "octocat" and your repository is named "hello-world", then the {% data variables.product.prodname_registry %} configuration in _build.gradle_ would look similar to the below example.
+
+{% raw %}
+```groovy
+publishing {
+  ...
+
+  repositories {
+    maven {
+      name = "OSSRH"
+      url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/"
+      credentials {
+        username = System.getenv("MAVEN_USERNAME")
+        password = System.getenv("MAVEN_PASSWORD")
+      }
+    }
+    maven {
+      name = "GitHubPackages"
+      url = "https://maven.pkg.github.com/octocat/hello-world"
+      credentials {
+        username = System.getenv("GITHUB_ACTOR")
+        password = System.getenv("GITHUB_TOKEN")
+      }
+    }
+  }
+}
+```
+{% endraw %}
+
+With this configuration, you can create a workflow that publishes your package to both the Maven Central Repository and {% data variables.product.prodname_registry %} by running the `gradle publish` command.
+
+{% raw %}
+```yaml
+name: Publish package to the Maven Central Repository and GitHub Packages
+on:
+  release:
+    types: [created]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Java
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Publish to the Maven Central Repository
+        run: gradle publish
+        env:
+          MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
+          MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
+
+{% data reusables.github-actions.gradle-workflow-steps %}
+1. Runs the `gradle publish` command to publish to the `OSSRH` Maven repository and {% data variables.product.prodname_registry %}. The `MAVEN_USERNAME` environment variable will be set with the contents of your `OSSRH_USERNAME` secret, and the `MAVEN_PASSWORD` environment variable will be set with the contents of your `OSSRH_TOKEN` secret. The `GITHUB_TOKEN` environment variable will be set with the content of the `GITHUB_TOKEN` secret.
+
+   For more information about using secrets in your workflow, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
diff --git a/translations/ko-KR/content/actions/guides/publishing-java-packages-with-maven.md b/translations/ko-KR/content/actions/guides/publishing-java-packages-with-maven.md
new file mode 100644
index 000000000000..e482de7f30b4
--- /dev/null
+++ b/translations/ko-KR/content/actions/guides/publishing-java-packages-with-maven.md
@@ -0,0 +1,210 @@
+---
+title: Publishing Java packages with Maven
+intro: You can use Maven to publish Java packages to a registry as part of your continuous integration (CI) workflow.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/publishing-java-packages-with-maven
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introduction
+
+{% data reusables.github-actions.publishing-java-packages-intro %}
+
+### 빌드전 요구 사양
+
+We recommend that you have a basic understanding of workflow files and configuration options. For more information, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)."
+
+For more information about creating a CI workflow for your Java project with Maven, see "[Building and testing Java with Maven](/actions/language-and-framework-guides/building-and-testing-java-with-maven)."
+
+You may also find it helpful to have a basic understanding of the following:
+
+- "[Configuring npm for use with {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)"
+- "[Environment variables](/actions/reference/environment-variables)"
+- "[Encrypted secrets](/actions/reference/encrypted-secrets)"
+- "[Authentication in a workflow](/actions/reference/authentication-in-a-workflow)"
+
+### About package configuration
+
+The `groupId` and `artifactId` fields in the _pom.xml_ file create a unique identifier for your package that registries use to link your package to a registry.  For more information see [Guide to uploading artifacts to the Central Repository](http://maven.apache.org/repository/guide-central-repository-upload.html) in the Apache Maven documentation.
+
+The _pom.xml_ file also contains configuration for the distribution management repositories that Maven will deploy packages to. Each repository must have a name and a deployment URL. Authentication for these repositories can be configured in the _.m2/settings.xml_ file in the home directory of the user running Maven.
+
+You can use the `setup-java` action to configure the deployment repository as well as authentication for that repository. For more information, see [`setup-java`](https://github.com/actions/setup-java).
+
+### Publishing packages to the Maven Central Repository
+
+Each time you create a new release, you can trigger a workflow to publish your package. The workflow in the example below runs when the `release` event triggers with type `created`. The workflow publishes the package to the Maven Central Repository if CI tests pass. For more information on the `release` event, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows#release)."
+
+In this workflow, you can use the `setup-java` action. This action installs the given version of the JDK into the `PATH`, but it also configures a Maven _settings.xml_ for publishing packages. By default, the settings file will be configured for {% data variables.product.prodname_registry %}, but it can be configured to deploy to another package registry, such as the Maven Central Repository. If you already have a distribution management repository configured in _pom.xml_, then you can specify that `id` during the `setup-java` action invocation.
+
+For example, if you were deploying to the Maven Central Repository through the OSSRH hosting project, your _pom.xml_ could specify a distribution management repository with the `id` of `ossrh`.
+
+{% raw %}
+```xml
+
+  ...
+  
+    
+      ossrh
+      Central Repository OSSRH
+      https://oss.sonatype.org/service/local/staging/deploy/maven2/
+    
+  
+
+```
+{% endraw %}
+
+With this configuration, you can create a workflow that publishes your package to the Maven Central Repository by specifying the repository management `id` to the `setup-java` action. You’ll also need to provide environment variables that contain the username and password to authenticate to the repository.
+
+In the deploy step, you’ll need to set the environment variables to the username that you authenticate with to the repository, and to a secret that you’ve configured with the password or token to authenticate with.  For more information, see "[Creating and using encrypted secrets](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
+
+
+{% raw %}
+```yaml
+name: Publish package to the Maven Central Repository
+on:
+  release:
+    types: [created]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Maven Central Repository
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+          server-id: ossrh
+          server-username: MAVEN_USERNAME
+          server-password: MAVEN_PASSWORD
+      - name: Publish package
+        run: mvn -B deploy
+        env:
+          MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
+          MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}
+```
+{% endraw %}
+
+This workflow performs the following steps:
+
+1. Checks out a copy of project's repository.
+1. Sets up the Java JDK, and also configures the Maven _settings.xml_ file to add authentication for the `ossrh` repository using the `MAVEN_USERNAME` and `MAVEN_PASSWORD` environment variables.
+1. {% data reusables.github-actions.publish-to-maven-workflow-step %}
+
+   For more information about using secrets in your workflow, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
+
+### Publishing packages to {% data variables.product.prodname_registry %}
+
+Each time you create a new release, you can trigger a workflow to publish your package. The workflow in the example below runs when the `release` event triggers with type `created`. The workflow publishes the package to {% data variables.product.prodname_registry %} if CI tests pass. For more information on the `release` event, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows#release)."
+
+In this workflow, you can use the `setup-java` action. This action installs the given version of the JDK into the `PATH`, and also sets up a Maven _settings.xml_ for publishing the package to {% data variables.product.prodname_registry %}. The generated _settings.xml_ defines authentication for a server with an `id` of `github`, using the `GITHUB_ACTOR` environment variable as the username and the `GITHUB_TOKEN` environment variable as the password.
+
+The `GITHUB_TOKEN` exists in your repository by default and has read and write permissions for packages in the repository where the workflow runs. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)."
+
+For a Maven-based project, you can make use of these settings by creating a distribution repository in your _pom.xml_ file with an `id` of `github` that points to your {% data variables.product.prodname_registry %} endpoint.
+
+For example, if your organization is named "octocat" and your repository is named "hello-world", then the {% data variables.product.prodname_registry %} configuration in _pom.xml_ would look similar to the below example.
+
+{% raw %}
+```xml
+
+  ...
+  
+    
+      github
+      GitHub Packages
+      https://maven.pkg.github.com/octocat/hello-world
+    
+  
+
+```
+{% endraw %}
+
+With this configuration, you can create a workflow that publishes your package to {% data variables.product.prodname_registry %} by making use of the automatically generated _settings.xml_.
+
+{% raw %}
+```yaml
+name: Publish package to GitHub Packages
+on:
+  release:
+    types: [created]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Publish package
+        run: mvn -B deploy
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
+
+This workflow performs the following steps:
+
+1. Checks out a copy of project's repository.
+1. Sets up the Java JDK, and also automatically configures the Maven _settings.xml_ file to add authentication for the `github` Maven repository to use the `GITHUB_TOKEN` environment variable.
+1. {% data reusables.github-actions.publish-to-packages-workflow-step %}
+
+   For more information about using secrets in your workflow, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
+
+### Publishing packages to the Maven Central Repository and {% data variables.product.prodname_registry %}
+
+You can publish your packages to both the Maven Central Repository and {% data variables.product.prodname_registry %} by using the `setup-java` action for each registry.
+
+Ensure your _pom.xml_ file includes a distribution management repository for both your {% data variables.product.prodname_dotcom %} repository and your Maven Central Repository provider. For example, if you deploy to the Central Repository through the OSSRH hosting project, you might want to specify it in a distribution management repository with the `id` set to `ossrh`, and you might want to specify {% data variables.product.prodname_registry %} in a distribution management repository with the `id` set to `github`.
+
+{% raw %}
+```yaml
+name: Publish package to the Maven Central Repository and GitHub Packages
+on:
+  release:
+    types: [created]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Java for publishing to Maven Central Repository
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+          server-id: ossrh
+          server-username: MAVEN_USERNAME
+          server-password: MAVEN_PASSWORD
+      - name: Publish to the Maven Central Repository
+        run: mvn -B deploy
+        env:
+          MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
+          MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}
+      - name: Set up Java for publishing to GitHub Packages
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Publish to GitHub Packages
+        run: mvn -B deploy
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
+
+This workflow calls the `setup-java` action twice.  Each time the `setup-java` action runs, it overwrites the Maven _settings.xml_ file for publishing packages.  For authentication to the repository, the _settings.xml_ file references the distribution management repository `id`, and the username and password.
+
+This workflow performs the following steps:
+
+1. Checks out a copy of project's repository.
+1. Calls `setup-java` the first time. This configures the Maven _settings.xml_ file for the `ossrh` repository, and sets the authentication options to environment variables that are defined in the next step.
+1. {% data reusables.github-actions.publish-to-maven-workflow-step %}
+1. Calls `setup-java` the second time. This automatically configures the Maven _settings.xml_ file for {% data variables.product.prodname_registry %}.
+1. {% data reusables.github-actions.publish-to-packages-workflow-step %}
+
+   For more information about using secrets in your workflow, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
diff --git a/translations/ko-KR/content/actions/guides/publishing-nodejs-packages.md b/translations/ko-KR/content/actions/guides/publishing-nodejs-packages.md
new file mode 100644
index 000000000000..3a402d35a1a2
--- /dev/null
+++ b/translations/ko-KR/content/actions/guides/publishing-nodejs-packages.md
@@ -0,0 +1,210 @@
+---
+title: Publishing Node.js packages
+intro: You can publish Node.js packages to a registry as part of your continuous integration (CI) workflow.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages
+  - /actions/language-and-framework-guides/publishing-nodejs-packages
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introduction
+
+This guide shows you how to create a workflow that publishes Node.js packages to the {% data variables.product.prodname_registry %} and npm registries after continuous integration (CI) tests pass. With a single workflow, you can publish packages to a single registry or multiple registries.
+
+### 빌드전 요구 사양
+
+We recommend that you have a basic understanding of workflow configuration options and how to create a workflow file. For more information, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)."
+
+For more information about creating a CI workflow for your Node.js project, see "[Using Node.js with {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions)."
+
+You may also find it helpful to have a basic understanding of the following:
+
+- "[Configuring npm for use with {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)"
+- "[Environment variables](/actions/reference/environment-variables)"
+- "[Encrypted secrets](/actions/reference/encrypted-secrets)"
+- "[Authentication in a workflow](/actions/reference/authentication-in-a-workflow)"
+
+### About package configuration
+
+ The `name` and `version` fields in the *package.json* file create a unique identifier that registries use to link your package to a registry. You can add a summary for the package listing page by including a `description` field in the *package.json* file. For more information, see "[Creating a package.json file](https://docs.npmjs.com/creating-a-package-json-file)" and "[Creating Node.js modules](https://docs.npmjs.com/creating-node-js-modules)" in the npm documentation.
+
+When a local *.npmrc* file exists and has a `registry` value specified, the `npm publish` command uses the registry configured in the *.npmrc* file. {% data reusables.github-actions.setup-node-intro %}
+
+You can specify the Node.js version installed on the runner using the `setup-node` action.
+
+If you add steps in your workflow to configure the `publishConfig` fields in your *package.json* file, you don't need to specify the registry-url using the `setup-node` action, but you will be limited to publishing the package to one registry. For more information, see "[publishConfig](https://docs.npmjs.com/files/package.json#publishconfig)" in the npm documentation.
+
+### Publishing packages to the npm registry
+
+Each time you create a new release, you can trigger a workflow to publish your package. The workflow in the example below runs when the `release` event triggers with type `created`. The workflow publishes the package to the npm registry if CI tests pass.
+
+To perform authenticated operations against the npm registry in your workflow, you'll need to store your npm authentication token as a secret in your repository settings. For example, create a secret called `NPM_TOKEN`. For more information, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
+
+By default, npm uses the `name` field of the *package.json* file to determine the npm registry. When publishing to a global namespace, you only need to include the package name. For example, you would publish a package named `npm-hello-world-test` to the `https://www.npmjs.com/package/npm-hello-world-test`.
+
+If you're publishing a package that includes a scope prefix, include the scope in the name of your *package.json* file. For example, if your npm scope prefix is octocat and the package name is hello-world, the `name` in your *package.json* file should be `@octocat/hello-world`. If your npm package uses a scope prefix and the package is public, you need to use the option `npm publish --access public`. This is an option that npm requires to prevent someone from publishing a private package unintentionally.
+
+This example stores the `NPM_TOKEN` secret in the `NODE_AUTH_TOKEN` environment variable. When the `setup-node` action creates an *.npmrc* file, it references the token from the `NODE_AUTH_TOKEN` environment variable.
+
+{% raw %}
+```yaml
+name: Node.js Package
+on:
+  release:
+    types: [created]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    # Setup .npmrc file to publish to npm
+    - uses: actions/setup-node@v1
+      with:
+        node-version: '12.x'
+        registry-url: 'https://registry.npmjs.org'
+    - run: npm install
+    - run: npm publish
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+```
+{% endraw %}
+
+In the example above, the `setup-node` action creates an *.npmrc* file on the runner with the following contents:
+
+```
+//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN}
+registry=https://registry.npmjs.org/
+always-auth=true
+```
+
+### Publishing packages to {% data variables.product.prodname_registry %}
+
+Each time you create a new release, you can trigger a workflow to publish your package. The workflow in the example below runs anytime the `release` event with type `created` occurs. The workflow publishes the package to {% data variables.product.prodname_registry %} if CI tests pass.
+
+By default, {% data variables.product.prodname_registry %} publishes a package in the {% data variables.product.prodname_dotcom %} repository you specify in the `name` field of the *package.json* file. For example, you would publish a package named `@my-org/test` to the `my-org/test` {% data variables.product.prodname_dotcom %} repository. For more information, see [`npm-scope`](https://docs.npmjs.com/misc/scope) in the npm documentation.
+
+To perform authenticated operations against the {% data variables.product.prodname_registry %} registry in your workflow, you can use the `GITHUB_TOKEN`. The `GITHUB_TOKEN` exists in your repository by default and has read and write permissions for packages in the repository where the workflow runs. For more information, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
+
+This example stores the `GITHUB_TOKEN` secret in the `NODE_AUTH_TOKEN` environment variable. When the `setup-node` action creates an *.npmrc* file, it references the token from the `NODE_AUTH_TOKEN` environment variable.
+
+{% raw %}
+```yaml
+name: Node.js Package
+on:
+  release:
+    types: [created]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    # Setup .npmrc file to publish to GitHub Packages
+    - uses: actions/setup-node@v1
+      with:
+        node-version: '12.x'
+        registry-url: 'https://npm.pkg.github.com'
+        # Defaults to the user or organization that owns the workflow file
+        scope: '@octocat'
+    - run: npm install
+    - run: npm publish
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
+
+The `setup-node` action creates an *.npmrc* file on the runner. When you use the `scope` input to the `setup-node` action, the *.npmrc* file includes the scope prefix. By default, the `setup-node` action sets the scope in the *.npmrc* file to the account that contains that workflow file.
+
+```
+//npm.pkg.github.com/:_authToken=${NODE_AUTH_TOKEN}
+@octocat:registry=https://npm.pkg.github.com
+always-auth=true
+```
+
+### Publishing packages using yarn
+
+If you use the Yarn package manager, you can install and publish packages using Yarn.
+
+{% raw %}
+```yaml
+name: Node.js Package
+on:
+  release:
+    types: [created]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    # Setup .npmrc file to publish to npm
+    - uses: actions/setup-node@v1
+      with:
+        node-version: '12.x'
+        registry-url: 'https://registry.npmjs.org'
+        # Defaults to the user or organization that owns the workflow file
+        scope: '@octocat' 
+    - run: yarn
+    - run: yarn publish
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+```
+{% endraw %}
+
+### Publishing packages to npm and {% data variables.product.prodname_registry %}
+
+{% note %}
+
+**Note:** If you need to publish to registries that have different scope prefixes, you'll need to modify the *package.json* file on the runner to change the scope prefix. For example, if you publish a package to the `@mona` scope for npm and `@octocat` scope for {% data variables.product.prodname_registry %}, you can replace the `@mona` scope with `@octocat` in the *package.json* file on the runner after publishing to npm and before publishing to {% data variables.product.prodname_registry %}.
+
+{% endnote %}
+
+You can publish your packages to both the npm registry and {% data variables.product.prodname_registry %} by using the `setup-node` action for each registry.
+
+If you publish a package to both registries, you'll need to ensure that your scope prefix on npm matches your {% data variables.product.prodname_dotcom %} user or organization name. To publish packages to a public registry with a scope prefix, you can use the command `npm publish --access public`. For more information, see [`npm-scope`](https://docs.npmjs.com/misc/scope) and "[Creating and publishing scoped public packages](https://docs.npmjs.com/creating-and-publishing-scoped-public-packages)" in the npm documentation.
+
+Ensure your *package.json* file includes the scope of your {% data variables.product.prodname_dotcom %} repository and npm registry. For example, if you plan to publish a package in the `octocat/npm-hello-world-test` repository to {% data variables.product.prodname_dotcom %} and https://www.npmjs.com/package/@octocat/npm-hello-world-test, the name in your *package.json* file would be `"name": "@octocat/npm-hello-world-test"`.
+
+To perform authenticated operations against the {% data variables.product.prodname_registry %} registry in your workflow, you can use the `GITHUB_TOKEN`. The `GITHUB_TOKEN` exists in your repository by default and has read and write permissions for packages in the repository where the workflow runs. For more information, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
+
+When you use the `scope` input to the `setup-node` action, the action creates an *.npmrc* file that includes the scope prefix. By default, the `setup-node` action sets the scope in the *.npmrc* file to the user or organization that owns the workflow file.
+
+This workflow calls the `setup-node` action two times. Each time the `setup-node` action runs, it overwrites the *.npmrc* file. The *.npmrc* file references the token that allows you to perform authenticated operations against the package registry from the `NODE_AUTH_TOKEN` environment variable. The workflow sets the `NODE_AUTH_TOKEN` environment variable each time the `npm publish` command is run, first with a token to publish to npm (`NPM_TOKEN`) and then with a token to publish to {% data variables.product.prodname_registry %} (`GITHUB_TOKEN`).
+
+{% raw %}
+```yaml
+name: Node.js Package
+on:
+  release:
+    types: [created]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    # Setup .npmrc file to publish to npm
+    - uses: actions/setup-node@v1
+      with:
+        node-version: '10.x'
+        registry-url: 'https://registry.npmjs.org'
+    - run: npm install
+    # Publish to npm
+    - run: npm publish --access public
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+    # Setup .npmrc file to publish to GitHub Packages
+    - uses: actions/setup-node@v1
+      with:
+        registry-url: 'https://npm.pkg.github.com'
+        # Defaults to the user or organization that owns the workflow file
+        scope: '@octocat'
+    # Publish to GitHub Packages
+    - run: npm publish
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
diff --git a/translations/ko-KR/content/actions/guides/setting-up-continuous-integration-using-workflow-templates.md b/translations/ko-KR/content/actions/guides/setting-up-continuous-integration-using-workflow-templates.md
new file mode 100644
index 000000000000..deaf7f498a01
--- /dev/null
+++ b/translations/ko-KR/content/actions/guides/setting-up-continuous-integration-using-workflow-templates.md
@@ -0,0 +1,43 @@
+---
+title: Setting up continuous integration using workflow templates
+shortTitle: Setting up CI using templates
+intro: You can set up continuous integration for your project using a workflow template that matches the language and tooling you want to use.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /articles/setting-up-continuous-integration-using-github-actions
+  - /github/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions
+  - /actions/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions
+  - /actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+Anyone with write permission to a repository can set up continuous integration (CI) using {% data variables.product.prodname_actions %}.
+
+After you set up CI, you can customize the workflow to meet your needs.
+
+{% data reusables.repositories.navigate-to-repo %}
+{% data reusables.repositories.actions-tab %}
+1. Find the template that matches the language and tooling you want to use, then click **Set up this workflow**. ![Setup workflow button](/assets/images/help/repository/setup-workflow-button.png)
+5. Click **Start commit**. ![Start commit button](/assets/images/help/repository/start-commit.png)
+{% data reusables.files.write_commit_message %}
+{% data reusables.files.choose_commit_branch %}
+{% data reusables.files.propose_new_file %}
+
+Once a push is made to your repository, you can follow the status and detailed logs of your continuous integration workflow run on {% data variables.product.prodname_dotcom %} and receive customized notifications. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)" and "[Managing a workflow run](/articles/managing-a-workflow-run)."
+
+{% data reusables.repositories.actions-workflow-status-badge-into %}
+
+For more information, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)."
+
+### 더 읽을거리
+
+- "[About continuous integration](/articles/about-continuous-integration)"
+- "[Managing a workflow run](/articles/managing-a-workflow-run)"
+{% if currentVersion == "free-pro-team@latest" %}
+- "[Managing billing for {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)"
+{% endif %}
diff --git a/translations/ko-KR/content/actions/guides/storing-workflow-data-as-artifacts.md b/translations/ko-KR/content/actions/guides/storing-workflow-data-as-artifacts.md
new file mode 100644
index 000000000000..059ed8a8584f
--- /dev/null
+++ b/translations/ko-KR/content/actions/guides/storing-workflow-data-as-artifacts.md
@@ -0,0 +1,249 @@
+---
+title: Storing workflow data as artifacts
+shortTitle: Storing workflow artifacts
+intro: Artifacts allow you to share data between jobs in a workflow and store data once that workflow has completed.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /articles/persisting-workflow-data-using-artifacts
+  - /github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts
+  - /actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts
+  - /actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### About workflow artifacts
+
+Artifacts allow you to persist data after a job has completed, and share that data with another job in the same workflow. An artifact is a file or collection of files produced during a workflow run. For example, you can use artifacts to save your build and test output after a workflow run has ended.
+
+{% data reusables.github-actions.artifact-log-retention-statement %} The retention period for a pull request restarts each time someone pushes a new commit to the pull request.
+
+These are some of the common artifacts that you can upload:
+
+- Log files and core dumps
+- Test results, failures, and screenshots
+- Binary or compressed files
+- Stress test performance output and code coverage results
+
+{% if currentVersion == "free-pro-team@latest" %}
+
+Storing artifacts uses storage space on {% data variables.product.product_name %}. {% data reusables.github-actions.actions-billing %} For more information, see "[Managing billing for {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)."
+
+{% else %}
+
+Artifacts consume storage space on the external blob storage that is configured for {% data variables.product.prodname_actions %} on {% data variables.product.product_location %}.
+
+{% endif %}
+
+Artifacts are uploaded during a workflow run, and you can view an artifact's name and size in the UI. When an artifact is downloaded using the {% data variables.product.product_name %} UI, all files that were individually uploaded as part of the artifact get zipped together into a single file. This means that billing is calculated based on the size of the uploaded artifact and not the size of the zip file.
+
+{% data variables.product.product_name %} provides two actions that you can use to upload and download build artifacts. For more information, see the {% if currentVersion == "free-pro-team@latest" %}[actions/upload-artifact](https://github.com/actions/upload-artifact) and [download-artifact](https://github.com/actions/download-artifact) actions{% else %} `actions/upload-artifact` and `download-artifact` actions on {% data variables.product.product_location %}{% endif %}.
+
+To share data between jobs:
+
+* **Uploading files**: Give the uploaded file a name and upload the data before the job ends.
+* **Downloading files**: You can only download artifacts that were uploaded during the same workflow run. When you download a file, you can reference it by name.
+
+The steps of a job share the same environment on the runner machine, but run in their own individual processes. To pass data between steps in a job, you can use inputs and outputs. For more information about inputs and outputs, see "[Metadata syntax for {% data variables.product.prodname_actions %}](/articles/metadata-syntax-for-github-actions)."
+
+### Uploading build and test artifacts
+
+You can create a continuous integration (CI) workflow to build and test your code. For more information about using {% data variables.product.prodname_actions %} to perform CI, see "[About continuous integration](/articles/about-continuous-integration)."
+
+The output of building and testing your code often produces files you can use to debug test failures and production code that you can deploy. You can configure a workflow to build and test the code pushed to your repository and report a success or failure status. You can upload the build and test output to use for deployments, debugging failed tests or crashes, and viewing test suite coverage.
+
+You can use the `upload-artifact` action to upload artifacts. When uploading an artifact, you can specify a single file or directory, or multiple files or directories. You can also exclude certain files or directories, and use wildcard patterns. We recommend that you provide a name for an artifact, but if no name is provided then `artifact` will be used as the default name. For more information on syntax, see the {% if currentVersion == "free-pro-team@latest" %}[actions/upload-artifact](https://github.com/actions/upload-artifact) action{% else %} `actions/upload-artifact` action on {% data variables.product.product_location %}{% endif %}.
+
+#### 예시
+
+For example, your repository or a web application might contain SASS and TypeScript files that you must convert to CSS and JavaScript. Assuming your build configuration outputs the compiled files in the `dist` directory, you would deploy the files in the `dist` directory to your web application server if all tests completed successfully.
+
+```
+|-- hello-world (repository)
+|   └── dist
+|   └── tests
+|   └── src
+|       └── sass/app.scss
+|       └── app.ts
+|   └── output
+|       └── test
+|   
+```
+
+This example shows you how to create a workflow for a Node.js project that `builds` the code in the `src` directory and runs the tests in the `tests` directory. You can assume that running `npm test` produces a code coverage report named `code-coverage.html` stored in the `output/test/` directory.
+
+The workflow uploads the production artifacts in the `dist` directory, but excludes any markdown files. It also and uploads the `code-coverage.html` report as another artifact.
+
+```yaml
+name: Node CI
+
+on: [push]
+
+jobs:
+  build_and_test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v2
+      - name: npm install, build, and test
+        run: |
+          npm install
+          npm run build --if-present
+          npm test
+      - name: Archive production artifacts
+        uses: actions/upload-artifact@v2
+        with:
+          name: dist-without-markdown
+          path: |
+            dist
+            !dist/**/*.md
+      - name: Archive code coverage results
+        uses: actions/upload-artifact@v2
+        with:
+          name: code-coverage-report
+          path: output/test/code-coverage.html
+```
+
+![Image of workflow upload artifact workflow run](/assets/images/help/repository/upload-build-test-artifact.png)
+
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+### Configuring a custom artifact retention period
+
+You can define a custom retention period for individual artifacts created by a workflow. When using a workflow to create a new artifact, you can use `retention-days` with the `upload-artifact` action. This example demonstrates how to set a custom retention period of 5 days for the artifact named `my-artifact`:
+
+```
+  - name: 'Upload Artifact'
+    uses: actions/upload-artifact@v2
+    with:
+      name: my-artifact
+      path: my_file.txt
+      retention-days: 5
+```
+
+The `retention-days` value cannot exceed the retention limit set by the repository, organization, or enterprise.
+{% endif %}
+
+### Downloading or deleting artifacts
+
+During a workflow run, you can use the [`download-artifact`](https://github.com/actions/download-artifact)action to download artifacts that were previously uploaded in the same workflow run.
+
+After a workflow run has been completed, you can download or delete artifacts on {% data variables.product.prodname_dotcom %} or using the REST API. For more information, see "[Downloading workflow artifacts](/actions/managing-workflow-runs/downloading-workflow-artifacts)," "[Removing workflow artifacts](/actions/managing-workflow-runs/removing-workflow-artifacts)," and the "[Artifacts REST API](/v3/actions/artifacts/)."
+
+#### Downloading artifacts during a workflow run
+
+The [`actions/download-artifact`](https://github.com/actions/download-artifact) action can be used to download previously uploaded artifacts during a workflow run.
+
+{% note %}
+
+**Note:** You can only download artifacts in a workflow that were uploaded during the same workflow run.
+
+{% endnote %}
+
+Specify an artifact's name to download an individual artifact. If you uploaded an artifact without specifying a name, the default name is `artifact`.
+
+```yaml
+- name: Download a single artifact
+  uses: actions/download-artifact@v2
+  with:
+    name: my-artifact
+```
+
+You can also download all artifacts in a workflow run by not specifying a name. This can be useful if you are working with lots of artifacts.
+
+```yaml
+- name: Download all workflow run artifacts
+  uses: actions/download-artifact@v2
+```
+
+If you download all a workflow run's artifacts, a directory for each artifact is created using its name.
+
+For more information on syntax, see the {% if currentVersion == "free-pro-team@latest" %}[actions/download-artifact](https://github.com/actions/download-artifact) action{% else %} `actions/download-artifact` action on {% data variables.product.product_location %}{% endif %}.
+
+### Passing data between jobs in a workflow
+
+You can use the `upload-artifact` and `download-artifact` actions to share data between jobs in a workflow. This example workflow illustrates how to pass data between jobs in the same workflow. For more information, see the {% if currentVersion == "free-pro-team@latest" %}[actions/upload-artifact](https://github.com/actions/upload-artifact) and [download-artifact](https://github.com/actions/download-artifact) actions{% else %} `actions/upload-artifact` and `download-artifact` actions on {% data variables.product.product_location %}{% endif %}.
+
+Jobs that are dependent on a previous job's artifacts must wait for the dependent job to complete successfully. This workflow uses the `needs` keyword to ensure that `job_1`, `job_2`, and `job_3` run sequentially. For example, `job_2` requires `job_1` using the `needs: job_1` syntax.
+
+Job 1 performs these steps:
+- Performs a math calculation and saves the result to a text file called `math-homework.txt`.
+- Uses the `upload-artifact` action to upload the `math-homework.txt` file with the name `homework`. The action places the file in a directory named `homework`.
+
+Job 2 uses the result in the previous job:
+- Downloads the `homework` artifact uploaded in the previous job. By default, the `download-artifact` action downloads artifacts to the workspace directory that the step is executing in. You can use the `path` input parameter to specify a different download directory.
+- Reads the value in the `homework/math-homework.txt` file, performs a math calculation, and saves the result to `math-homework.txt`.
+- Uploads the `math-homework.txt` file. This upload overwrites the previous upload because both of the uploads share the same name.
+
+Job 3 displays the result uploaded in the previous job:
+- Downloads the `homework` artifact.
+- Prints the result of the math equation to the log.
+
+The full math operation performed in this workflow example is `(3 + 7) x 9 = 90`.
+
+```yaml
+name: Share data between jobs
+
+on: [push]
+
+jobs:
+  job_1:
+    name: Add 3 and 7
+    runs-on: ubuntu-latest
+    steps:
+      - shell: bash
+        run: |
+          expr 3 + 7 > math-homework.txt
+      - name: Upload math result for job 1
+        uses: actions/upload-artifact@v2
+        with:
+          name: homework
+          path: math-homework.txt
+
+  job_2:
+    name: Multiply by 9
+    needs: job_1
+    runs-on: windows-latest
+    steps:
+      - name: Download math result for job 1
+        uses: actions/download-artifact@v2
+        with:
+          name: homework
+      - shell: bash
+        run: |
+          value=`cat math-homework.txt`
+          expr $value \* 9 > math-homework.txt
+      - name: Upload math result for job 2
+        uses: actions/upload-artifact@v2
+        with:
+          name: homework
+          path: math-homework.txt
+
+  job_3:
+    name: Display results
+    needs: job_2
+    runs-on: macOS-latest
+    steps:
+      - name: Download math result for job 2
+        uses: actions/download-artifact@v2
+        with:
+          name: homework
+      - name: Print the final result
+        shell: bash
+        run: |
+          value=`cat math-homework.txt`
+          echo The result is $value
+```
+
+![Workflow that passes data between jobs to perform math](/assets/images/help/repository/passing-data-between-jobs-in-a-workflow.png)
+
+{% if currentVersion == "free-pro-team@latest" %}
+
+### 더 읽을거리
+
+- "[Managing billing for {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)".
+
+{% endif %}
diff --git a/translations/ko-KR/content/actions/hosting-your-own-runners/about-self-hosted-runners.md b/translations/ko-KR/content/actions/hosting-your-own-runners/about-self-hosted-runners.md
index b39d493c1b77..48ba5968ca2a 100644
--- a/translations/ko-KR/content/actions/hosting-your-own-runners/about-self-hosted-runners.md
+++ b/translations/ko-KR/content/actions/hosting-your-own-runners/about-self-hosted-runners.md
@@ -53,6 +53,15 @@ You can use any machine as a self-hosted runner as long at it meets these requir
 * The machine has enough hardware resources for the type of workflows you plan to run. The self-hosted runner application itself only requires minimal resources.
 * If you want to run workflows that use Docker container actions or service containers, you must use a Linux machine and Docker must be installed.
 
+### Usage limits
+
+There are some limits on {% data variables.product.prodname_actions %} usage when using self-hosted runners. These limits are subject to change.
+
+{% data reusables.github-actions.usage-workflow-run-time %}
+- **Job queue time** - Each job for self-hosted runners can be queued for a maximum of 24 hours. If a self-hosted runner does not start executing the job within this limit, the job is terminated and fails to complete.
+{% data reusables.github-actions.usage-api-requests %}
+- **Job matrix** - {% data reusables.github-actions.usage-matrix-limits %}
+
 ### Supported operating systems for self-hosted runners
 
 The following operating systems are supported for the self-hosted runner application.
diff --git a/translations/ko-KR/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md b/translations/ko-KR/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md
index 3a13f56de726..6f0d8a18b8c3 100644
--- a/translations/ko-KR/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md
+++ b/translations/ko-KR/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md
@@ -51,7 +51,8 @@ You can add self-hosted runners to an enterprise, where they can be assigned to
 {% if currentVersion == "free-pro-team@latest" %}
 To add a self-hosted runner to an enterprise account, you must be an enterprise owner.
 {% else if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21"%}
-To add a self-hosted runner at the enterprise level of {% data variables.product.product_location %}, you must be a site administrator.
+To add a self-hosted runner at the enterprise level of
+{% data variables.product.product_location %}, you must be a site administrator.
 {% endif %}
 
 {% if currentVersion == "free-pro-team@latest" %}
diff --git a/translations/ko-KR/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md b/translations/ko-KR/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md
index 71635dcb18cd..58f8548dc79c 100644
--- a/translations/ko-KR/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md
+++ b/translations/ko-KR/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md
@@ -63,7 +63,8 @@ To remove a self-hosted runner from an organization, you must be an organization
 {% if currentVersion == "free-pro-team@latest" %}
 To remove a self-hosted runner from an enterprise account, you must be an enterprise owner. We recommend that you also have access to the self-hosted runner machine.
 {% else if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21"%}
-To remove a self-hosted runner at the enterprise level of {% data variables.product.product_location %}, you must be a site administrator. We recommend that you also have access to the self-hosted runner machine.
+To remove a self-hosted runner at the enterprise level of
+{% data variables.product.product_location %}, you must be a site administrator. We recommend that you also have access to the self-hosted runner machine.
 {% endif %}
 
 {% data reusables.github-actions.self-hosted-runner-reusing %}
diff --git a/translations/ko-KR/content/actions/index.md b/translations/ko-KR/content/actions/index.md
index 617ea520b400..0696a46ac8ca 100644
--- a/translations/ko-KR/content/actions/index.md
+++ b/translations/ko-KR/content/actions/index.md
@@ -33,8 +33,8 @@ versions:
 
 
 
-
        
-  
        
+
        
+  
        
     
        
       
        {% data ui.toc.getting_started %}
        
     
        
@@ -45,7 +45,7 @@ versions:
    -
    +

    {% data ui.toc.popular_articles %}

    @@ -56,7 +56,7 @@ versions:
    -
    +

    Manage workflows

    @@ -68,22 +68,28 @@ versions:
    -
    - -
    {% octicon "bookmark" width="24" %}
    -

    Create actions

    -

    A complete guide to creating and sharing actions with the community.

    -     - -
    {% octicon "rocket" width="24" %}
    -

    Starter workflows

    -

    A collection of workflow files to help you get started with GitHub Actions.

    -     - -
    {% octicon "light-bulb" width="24" %}
    -

    GitHub Actions Marketplace

    -

    Explore community actions and supercharge your workflow.

    -     +
    +
    + +
    {% octicon "bookmark" width="24" %}
    +

    Create actions

    +

    A complete guide to creating and sharing actions with the community.

    +     +
    +
    + +
    {% octicon "rocket" width="24" %}
    +

    Starter workflows

    +

    A collection of workflow files to help you get started with GitHub Actions.

    +     +
    +
    + +
    {% octicon "light-bulb" width="24" %}
    +

    GitHub Actions Marketplace

    +

    Explore community actions and supercharge your workflow.

    +     +
    @@ -91,7 +97,7 @@ versions:

    안내서

    -
    +

    Building and testing Node.js

    @@ -107,7 +113,7 @@ versions:
    -
    +

    Building and testing Python

    @@ -123,7 +129,7 @@ versions:
    -
    +

    Building and testing Java with Maven

    @@ -139,7 +145,7 @@ versions:
    -
    +

    Building and testing Java with Gradle

    @@ -155,7 +161,7 @@ versions:
    -
    +

    Building and testing Java with Ant

    @@ -171,7 +177,7 @@ versions:
    -
    +

    Publishing Node.js packages

    diff --git a/translations/ko-KR/content/actions/learn-github-actions/essential-features-of-github-actions.md b/translations/ko-KR/content/actions/learn-github-actions/essential-features-of-github-actions.md new file mode 100644 index 000000000000..f8ce1472ef39 --- /dev/null +++ b/translations/ko-KR/content/actions/learn-github-actions/essential-features-of-github-actions.md @@ -0,0 +1,95 @@ +--- +title: Essential features of GitHub Actions +shortTitle: Essential features +intro: '{% data variables.product.prodname_actions %} are designed to help you build robust and dynamic automations. This guide will show you how to craft {% data variables.product.prodname_actions %} workflows that include environment variables, customized scripts, and more.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### 개요 + +{% data variables.product.prodname_actions %} allow you to customize your workflows to meet the unique needs of your application and team. In this guide, we'll discuss some of the essential customization techniques such as using variables, running scripts, and sharing data and artifacts between jobs. + +### Using variables in your workflows + +{% data variables.product.prodname_actions %} include default environment variables for each workflow run. If you need to use custom environment variables, you can set these in your YAML workflow file. This example demonstrates how to create custom variables named `POSTGRES_HOST` and `POSTGRES_PORT`. These variables are then available to the `node client.js` script. + +```yaml +jobs: + example-job: + steps: + - name: Connect to PostgreSQL + run: node client.js + env: + POSTGRES_HOST: postgres + POSTGRES_PORT: 5432 +``` + +For more information, see "[Using environment variables](/actions/configuring-and-managing-workflows/using-environment-variables)." + +### Adding scripts to your workflow + +You can use actions to run scripts and shell commands, which are then executed on the assigned runner. This example demonstrates how an action can use the `run` keyword to execute `npm install -g bats` on the runner. + +```yaml +jobs: + example-job: + steps: + - run: npm install -g bats +``` + +For example, to run a script as an action, you can store the script in your repository and supply the path and shell type. + +```yaml +jobs: + example-job: + steps: + - name: Run build script + run: ./.github/scripts/build.sh + shell: bash +``` + +For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)." + +### Sharing data between jobs + +If your job generates files that you want to share with another job in the same workflow, or if you want to save the files for later reference, you can store them in {% data variables.product.prodname_dotcom %} as _artifacts_. Artifacts are the files created when you build and test your code. For example, artifacts might include binary or package files, test results, screenshots, or log files. Artifacts are associated with the workflow run where they were created and can be used by another job. + +For example, you can create a file and then upload it as an artifact. + +```yaml +jobs: + example-job: + name: Save output + steps: + - shell: bash + run: | + expr 1 + 1 > output.log + - name: Upload output file + uses: actions/upload-artifact@v1 + with: + name: output-log-file + path: output.log +``` + +To download an artifact from a separate workflow run, you can use the `actions/download-artifact` action. For example, you can download the artifact named `output-log-file`. + +```yaml +jobs: + example-job: + steps: + - name: Download a single artifact + uses: actions/download-artifact@v2 + with: + name: output-log-file +``` + +For more information about artifacts, see "[Persisting workflow data using artifacts](/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts)." + +### 다음 단계 + +To continue learning about {% data variables.product.prodname_actions %}, see "[Managing complex workflows](/actions/learn-github-actions/managing-complex-workflows)." diff --git a/translations/ko-KR/content/actions/learn-github-actions/finding-and-customizing-actions.md b/translations/ko-KR/content/actions/learn-github-actions/finding-and-customizing-actions.md new file mode 100644 index 000000000000..919d54c9165c --- /dev/null +++ b/translations/ko-KR/content/actions/learn-github-actions/finding-and-customizing-actions.md @@ -0,0 +1,156 @@ +--- +title: Finding and customizing actions +shortTitle: Finding and customizing actions +intro: 'Actions are the building blocks that power your workflow. A workflow can contain actions created by the community, or you can create your own actions directly within your application''s repository. This guide will show you how to discover, use, and customize actions.' +redirect_from: + - /actions/automating-your-workflow-with-github-actions/using-github-marketplace-actions + - /actions/automating-your-workflow-with-github-actions/using-actions-from-github-marketplace-in-your-workflow + - /actions/getting-started-with-github-actions/using-actions-from-github-marketplace + - /actions/getting-started-with-github-actions/using-community-workflows-and-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### 개요 + +The actions you use in your workflow can be defined in: + +- A public repository +- The same repository where your workflow file references the action +- A published Docker container image on Docker Hub + +{% data variables.product.prodname_marketplace %} is a central location for you to find actions created by the {% data variables.product.prodname_dotcom %} community. [{% data variables.product.prodname_marketplace %} page](https://github.com/marketplace/actions/) enables you to filter for actions by category. + +{% data reusables.actions.enterprise-marketplace-actions %} + +### Browsing Marketplace actions in the workflow editor + +You can search and browse actions directly in your repository's workflow editor. From the sidebar, you can search for a specific action, view featured actions, and browse featured categories. You can also view the number of stars an action has received from the {% data variables.product.prodname_dotcom %} community. + +1. In your repository, browse to the workflow file you want to edit. +1. In the upper right corner of the file view, to open the workflow editor, click {% octicon "pencil" aria-label="The edit icon" %}. ![Edit workflow file button](/assets/images/help/repository/actions-edit-workflow-file.png) +1. To the right of the editor, use the {% data variables.product.prodname_marketplace %} sidebar to browse actions. Actions with the {% octicon "verified" aria-label="The verified badge" %} badge indicate {% data variables.product.prodname_dotcom %} has verified the creator of the action as a partner organization. ![Marketplace workflow sidebar](/assets/images/help/repository/actions-marketplace-sidebar.png) + +### Adding an action to your workflow + +An action's listing page includes the action's version and the workflow syntax required to use the action. To keep your workflow stable even when updates are made to an action, you can reference the version of the action to use by specifying the Git or Docker tag number in your workflow file. + +1. Navigate to the action you want to use in your workflow. +1. Under "Installation", click {% octicon "clippy" aria-label="The edit icon" %} to copy the workflow syntax. ![View action listing](/assets/images/help/repository/actions-sidebar-detailed-view.png) +1. Paste the syntax as a new step in your workflow. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idsteps)." +1. If the action requires you to provide inputs, set them in your workflow. For information on inputs an action might require, see "[Using inputs and outputs with an action](/actions/learn-github-actions/finding-and-customizing-actions#using-inputs-and-outputs-with-an-action)." + +{% if currentVersion == "free-pro-team@latest" %} + +{% data reusables.dependabot.version-updates-for-actions %} + +{% endif %} + +### Using release management for your custom actions + +The creators of a community action have the option to use tags, branches, or SHA values to manage releases of the action. Similar to any dependency, you should indicate the version of the action you'd like to use based on your comfort with automatically accepting updates to the action. + +You will designate the version of the action in your workflow file. Check the action's documentation for information on their approach to release management, and to see which tag, branch, or SHA value to use. + +#### Using tags + +Tags are useful for letting you decide when to switch between major and minor versions, but these are more ephemeral and can be moved or deleted by the maintainer. This example demonstrates how to target an action that's been tagged as `v1.0.1`: + +```yaml +steps: + - uses: actions/javascript-action@v1.0.1 +``` + +#### Using SHAs + +If you need more reliable versioning, you should use the SHA value associated with the version of the action. SHAs are immutable and therefore more reliable than tags or branches. However this approach means you will not automatically receive updates for an action, including important bug fixes and security updates. This example targets an action's SHA: + +```yaml +steps: + - uses: actions/javascript-action@172239021f7ba04fe7327647b213799853a9eb89 +``` + +#### Using branches + +Referring to a specific branch means that the action will always use include the latest updates on the target branch, but can create problems if those updates include breaking changes. This example targets a branch named `@main`: + +```yaml +steps: + - uses: actions/javascript-action@main +``` + +For more information, see "[Using release management for actions](/actions/creating-actions/about-actions#using-release-management-for-actions)." + +### Using inputs and outputs with an action + +An action often accepts or requires inputs and generates outputs that you can use. For example, an action might require you to specify a path to a file, the name of a label, or other data it will uses as part of the action processing. + +To see the inputs and outputs of an action, check the `action.yml` or `action.yaml` in the root directory of the repository. + +In this example `action.yml`, the `inputs` keyword defines a required input called `file-path`, and includes a default value that will be used if none is specified. The `outputs` keyword defines an output called `results-file`, which tells you where to locate the results. + +```yaml +name: 'Example' +description: 'Receives file and generates output' +inputs: + file-path: # id of input + description: "Path to test script" + required: true + default: 'test-file.js' +outputs: + results-file: # id of output + description: "Path to results file" +``` + +### Referencing an action in the same repository where a workflow file uses the action + +If an action is defined in the same repository where your workflow file uses the action, you can reference the action with either the ‌`{owner}/{repo}@{ref}` or `./path/to/dir` syntax in your workflow file. + +Example repository file structure: + +``` +|-- hello-world (repository) +| |__ .github +| └── workflows +| └── my-first-workflow.yml +| └── actions +| |__ hello-world-action +| └── action.yml +``` + +Example workflow file: + +```yaml +jobs: + build: + runs-on: ubuntu-latest + steps: + # This step checks out a copy of your repository. + - uses: actions/checkout@v2 + # This step references the directory that contains the action. + - uses: ./.github/actions/hello-world-action +``` + +The `action.yml` file is used to provide metadata for the action. Learn about the content of this file in "[Metadata syntax for GitHub Actions](/actions/creating-actions/metadata-syntax-for-github-actions)" + +### Referencing a container on Docker Hub + +If an action is defined in a published Docker container image on Docker Hub, you must reference the action with the `docker://{image}:{tag}` syntax in your workflow file. To protect your code and data, we strongly recommend you verify the integrity of the Docker container image from Docker Hub before using it in your workflow. + +```yaml +jobs: + my_first_job: + steps: + - name: My first step + uses: docker://alpine:3.8 +``` + +For some examples of Docker actions, see the [Docker-image.yml workflow](https://github.com/actions/starter-workflows/blob/main/ci/docker-image.yml) and "[Creating a Docker container action](/articles/creating-a-docker-container-action)." + +### 다음 단계 + +To continue learning about {% data variables.product.prodname_actions %}, see "[Essential features of {% data variables.product.prodname_actions %}](/actions/learn-github-actions/essential-features-of-github-actions)." diff --git a/translations/ko-KR/content/actions/learn-github-actions/index.md b/translations/ko-KR/content/actions/learn-github-actions/index.md new file mode 100644 index 000000000000..8bc97d038f8e --- /dev/null +++ b/translations/ko-KR/content/actions/learn-github-actions/index.md @@ -0,0 +1,42 @@ +--- +title: Learn GitHub Actions +shortTitle: Learn GitHub Actions +intro: 'Whether you are new to {% data variables.product.prodname_actions %} or interested in learning all they have to offer, this guide will help you use {% data variables.product.prodname_actions %} to accelerate your application development workflows.' +redirect_from: + - /articles/about-github-actions + - /github/automating-your-workflow-with-github-actions/about-github-actions + - /actions/automating-your-workflow-with-github-actions/about-github-actions + - /actions/getting-started-with-github-actions + - /actions/getting-started-with-github-actions/about-github-actions + - /actions/getting-started-with-github-actions/overview + - /actions/getting-started-with-github-actions/getting-started-with-github-actions + - /articles/migrating-github-actions-from-hcl-syntax-to-yaml-syntax/ + - /actions/configuring-and-managing-workflows/configuring-a-workflow + - /articles/creating-a-workflow-with-github-actions/ + - /articles/configuring-a-workflow + - /github/automating-your-workflow-with-github-actions/configuring-a-workflow + - /actions/automating-your-workflow-with-github-actions/configuring-a-workflow + - /actions/creating-workflows/workflow-configuration-options + - /articles/configuring-workflows + - /github/automating-your-workflow-with-github-actions/configuring-workflows + - /actions/automating-your-workflow-with-github-actions/configuring-workflows + - /github/automating-your-workflow-with-github-actions/getting-started-with-github-actions + - /actions/automating-your-workflow-with-github-actions/getting-started-with-github-actions + - /actions/configuring-and-managing-workflows + - /articles/getting-started-with-github-actions + - /actions/migrating-to-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% link_with_intro /introduction-to-github-actions %} +{% link_with_intro /finding-and-customizing-actions %} +{% link_with_intro /essential-features-of-github-actions %} +{% link_with_intro /managing-complex-workflows %} +{% link_with_intro /sharing-workflows-with-your-organization %} +{% link_with_intro /security-hardening-for-github-actions %} +{% link_with_intro /migrating-from-circleci-to-github-actions %} +{% link_with_intro /migrating-from-gitlab-cicd-to-github-actions %} +{% link_with_intro /migrating-from-azure-pipelines-to-github-actions %} +{% link_with_intro /migrating-from-jenkins-to-github-actions %} diff --git a/translations/ko-KR/content/actions/learn-github-actions/introduction-to-github-actions.md b/translations/ko-KR/content/actions/learn-github-actions/introduction-to-github-actions.md new file mode 100644 index 000000000000..bf2fb4614d76 --- /dev/null +++ b/translations/ko-KR/content/actions/learn-github-actions/introduction-to-github-actions.md @@ -0,0 +1,225 @@ +--- +title: Introduction to GitHub Actions +shortTitle: Introduction to GitHub Actions +intro: 'Learn about the core concepts and various components of {% data variables.product.prodname_actions %}, and see an example that shows you how to add automation to your repository.' +redirect_from: + - /github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions + - /actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions + - /actions/getting-started-with-github-actions/core-concepts-for-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### 개요 + +{% data variables.product.prodname_actions %} help you automate tasks within your software development life cycle. {% data variables.product.prodname_actions %} are event-driven, meaning that you can run a series of commands after a specified event has occurred. For example, every time someone creates a pull request for a repository, you can automatically run a command that executes a software testing script. + +This diagram demonstrates how you can use {% data variables.product.prodname_actions %} to automatically run your software testing scripts. An event automatically triggers the _workflow_, which contains a _job_. The job then uses _steps_ to control the order in which _actions_ are run. These actions are the commands that automate your software testing. + +![Workflow overview](/assets/images/help/images/overview-actions-simple.png) + +### The components of {% data variables.product.prodname_actions %} + +Below is a list of the multiple {% data variables.product.prodname_actions %} components that work together to run jobs. You can see how these components interact with each other. + +![Component and service overview](/assets/images/help/images/overview-actions-design.png) + +#### Workflows + +The workflow is an automated procedure that you add to your repository. Workflows are made up of one or more jobs and can be scheduled or triggered by an event. The workflow can be used to build, test, package, release, or deploy a project on {% data variables.product.prodname_dotcom %}. + +#### 이벤트 + +An event is a specific activity that triggers a workflow. For example, activity can originate from {% data variables.product.prodname_dotcom %} when someone pushes a commit to a repository or when an issue or pull request is created. You can also use the repository dispatch webhook to trigger a workflow when an external event occurs. For a complete list of events that can be used to trigger workflows, see [Events that trigger workflows](/actions/reference/events-that-trigger-workflows). + +#### Jobs + +A job is a set of steps that execute on the same runner. By default, a workflow with multiple jobs will run those jobs in parallel. You can also configure a workflow to run jobs sequentially. For example, a workflow can have two sequential jobs that build and test code, where the test job is dependent on the status of the build job. If the build job fails, the test job will not run. + +#### Steps + +A step is an individual task that can run commands (known as _actions_). Each step in a job executes on the same runner, allowing the actions in that job to share data with each other. + +#### Actions + +_Actions_ are standalone commands that are combined into _steps_ to create a _job_. Actions are the smallest portable building block of a workflow. You can create your own actions, or use actions created by the {% data variables.product.prodname_dotcom %} community. To use an action in a workflow, you must include it as a step. + +#### Runners + +A runner is a server that has the {% data variables.product.prodname_actions %} runner application installed. You can use a runner hosted by {% data variables.product.prodname_dotcom %}, or you can host your own. A runner listens for available jobs, runs one job at a time, and reports the progress, logs, and results back to {% data variables.product.prodname_dotcom %}. For {% data variables.product.prodname_dotcom %}-hosted runners, each job in a workflow runs in a fresh virtual environment. + +{% data variables.product.prodname_dotcom %}-hosted runners are based on Ubuntu Linux, Microsoft Windows, and macOS. For information on {% data variables.product.prodname_dotcom %}-hosted runners, see "[Virtual environments for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/virtual-environments-for-github-hosted-runners)." If you need a different operating system or require a specific hardware configuration, you can host your own runners. For information on self-hosted runners, see "[Hosting your own runners](/actions/hosting-your-own-runners)." + +### Create an example workflow + +{% data variables.product.prodname_actions %} uses YAML syntax to define the events, jobs, and steps. These YAML files are stored in your code repository, in a directory called `.github/workflows`. + +You can create an example workflow in your repository that automatically triggers a series of commands whenever code is pushed. In this workflow, {% data variables.product.prodname_actions %} checks out the pushed code, installs the software dependencies, and runs `bats -v`. + +1. In your repository, create the `.github/workflows/` directory to store your workflow files. +1. In the `.github/workflows/` directory, create a new file called `learn-github-actions.yml` and add the following code. + ```yaml + name: learn-github-actions + on: [push] + jobs: + check-bats-version: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - uses: actions/setup-node@v1 + - run: npm install -g bats + - run: bats -v + ``` +1. Commit these changes and push them to your {% data variables.product.prodname_dotcom %} repository. + +Your new {% data variables.product.prodname_actions %} workflow file is now installed in your repository and will run automatically each time someone pushes a change to the repository. For details about a job's execution history, see "[Viewing the workflow's activity](/actions/learn-github-actions/introduction-to-github-actions#viewing-the-jobs-activity)." + +### Understanding the workflow file + +To help you understand how YAML syntax is used to create a workflow file, this section explains each line of the introduction's example: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + + ```yaml + name: learn-github-actions + ``` + + Optional - The name of the workflow as it will appear in the Actions tab of the {% data variables.product.prodname_dotcom %} repository. +
    + + ```yaml + on: [push] + ``` + + Specify the event that automatically triggers the workflow file. This example uses the push event, so that the jobs run every time someone pushes a change to the repository. You can set up the workflow to only run on certain branches, paths, or tags. For syntax examples including or excluding branches, paths, or tags, see "Workflow syntax for {% data variables.product.prodname_actions %}." +
    + + ```yaml + jobs: + ``` + + Groups together all the jobs that run in the learn-github-actions workflow file. +
    + + ```yaml + check-bats-version: + ``` + + Defines the name of the check-bats-version job stored within the jobs section. +
    + + ```yaml + runs-on: ubuntu-latest + ``` + + Configures the job to run on an Ubuntu Linux runner. This means that the job will execute on a fresh virtual machine hosted by GitHub. For syntax examples using other runners, see "Workflow syntax for {% data variables.product.prodname_actions %}." +
    + + ```yaml + steps: + ``` + + Groups together all the steps that run in the check-bats-version job. Each line nested under this section is a separate action. +
    + + ```yaml + - uses: actions/checkout@v2 + ``` + + The uses keyword tells the job to retrieve v2 of the community action named actions/checkout@v2. This is an action that checks out your repository and downloads it to the runner, allowing you to run actions against your code (such as testing tools). You must use the checkout action any time your workflow will run against the repository's code or you are using an action defined in the repository. +
    + + ```yaml + - uses: actions/setup-node@v1 + ``` + + This action installs the node software package on the runner, giving you access to the npm command. +
    + + ```yaml + - run: npm install -g bats + ``` + + The run keyword tells the job to execute a command on the runner. In this case, you are using npm to install the bats software testing package. +
    + + ```yaml + - run: bats -v + ``` + + Finally, you'll run the bats command with a parameter that outputs the software version. +
    + +#### Visualizing the workflow file + +In this diagram, you can see the workflow file you just created and how the {% data variables.product.prodname_actions %} components are organized in a hierarchy. Each step executes a single action. Steps 1 and 2 use prebuilt community actions. To find more prebuilt actions for your workflows, see "[Finding and customizing actions](/actions/learn-github-actions/finding-and-customizing-actions)." + +![Workflow overview](/assets/images/help/images/overview-actions-event.png) + + +### Viewing the job's activity + +Once your job has started running, you can view each step's activity on {% data variables.product.prodname_dotcom %}. + +{% data reusables.repositories.navigate-to-repo %} +1. Under your repository name, click **Actions**. ![Navigate to repository](/assets/images/help/images/learn-github-actions-repository.png) +1. In the left sidebar, click the workflow you want to see. ![Screenshot of workflow results](/assets/images/help/images/learn-github-actions-workflow.png) +1. Under "Workflow runs", click the name of the run you want to see. ![Screenshot of workflow runs](/assets/images/help/images/learn-github-actions-run.png) +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +1. Click on the job name to see the results of each step. ![Screenshot of workflow run details](/assets/images/help/images/overview-actions-result-updated.png) +{% else %} +1. Click on the job name to see the results of each step. ![Screenshot of workflow run details](/assets/images/help/images/overview-actions-result.png) +{% endif %} + +### 다음 단계 + +To continue learning about {% data variables.product.prodname_actions %}, see "[Finding and customizing actions](/actions/learn-github-actions/finding-and-customizing-actions)." + +### Contacting support + +{% data reusables.github-actions.contacting-support %} diff --git a/translations/ko-KR/content/actions/learn-github-actions/managing-complex-workflows.md b/translations/ko-KR/content/actions/learn-github-actions/managing-complex-workflows.md new file mode 100644 index 000000000000..8525abcfa0bf --- /dev/null +++ b/translations/ko-KR/content/actions/learn-github-actions/managing-complex-workflows.md @@ -0,0 +1,151 @@ +--- +title: Managing complex workflows +shortTitle: Managing complex workflows +intro: 'This guide shows you how to use the advanced features of {% data variables.product.prodname_actions %}, with secret management, dependent jobs, caching, build matrices, and labels.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### 개요 + +This article describes some of the advanced features of {% data variables.product.prodname_actions %} that help you work create more complex workflows. + +### Storing secrets + +If your workflows use sensitive data, such as passwords or certificates, you can save these in {% data variables.product.prodname_dotcom %} as _secrets_ and then use them in your workflows as environment variables. This means that you will be able to create and share workflows without having to embed sensitive values directly in the YAML workflow. + +This example action demonstrates how to reference an existing secret as an environment variable, and send it as a parameter to an example command. + +{% raw %} +```yaml +jobs: + example-job: + steps: + - name: Retrieve secret + env: + super_secret: ${{ secrets.SUPERSECRET }} + run: | + example-command "$SUPER_SECRET" +``` +{% endraw %} + +For more information, see "[Creating and storing encrypted secrets](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)." + +### Creating dependent jobs + +By default, the jobs in your workflow all run in parallel at the same time. So if you have a job that must only run after another job has completed, you can use the `needs` keyword to create this dependency. If one of the jobs fails, all dependent jobs are skipped; however, if you need the jobs to continue, you can define this using the [`if`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idif) conditional statement. + +In this example, the `setup`, `build`, and `test` jobs run in series, with `build` and `test` being dependent on the successful completion of the job that precedes them: + +```yaml +jobs: + setup: + runs-on: ubuntu-latest + steps: + - run: ./setup_server.sh + build: + needs: setup + steps: + - run: ./build_server.sh + test: + needs: build + runs-on: ubuntu-latest + steps: + - run: ./test_server.sh +``` + +For more information, see [`jobs..needs`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds). + +### Using a build matrix + +You can use a build matrix if you want your workflow to run tests across multiple combinations of operating systems, platforms, and languages. The build matrix is created using the `strategy` keyword, which receives the build options as an array. For example, this build matrix will run the job multiple times, using different versions of Node.js: + +{% raw %} +```yaml +jobs: + build: + runs-on: ubuntu-latest + strategy: + matrix: + node: [6, 8, 10] + steps: + - uses: actions/setup-node@v1 + with: + node-version: ${{ matrix.node }} +``` +{% endraw %} + +For more information, see [`jobs..strategy.matrix`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix). + +### Caching dependencies + +{% data variables.product.prodname_dotcom %}-hosted runners are started as fresh environments for each job, so if your jobs regularly reuse dependencies, you can consider caching these files to help improve performance. Once the cache is created, it is available to all workflows in the same repository. + +This example demonstrates how to cache the `~/.npm` directory: + +{% raw %} +```yaml +jobs: + example-job: + steps: + - name: Cache node modules + uses: actions/cache@v2 + env: + cache-name: cache-node-modules + with: + path: ~/.npm + key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }} + restore-keys: | + ${{ runner.os }}-build-${{ env.cache-name }}- +``` +{% endraw %} + +For more information, see "[Caching dependencies to speed up workflows](/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows)." + +### Using databases and service containers + +If your job requires a database or cache service, you can use the [`services`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idservices) keyword to create an ephemeral container to host the service; the resulting container is then available to all steps in that job and is removed when the job has completed. This example demonstrates how a job can use `services` to create a `postgres` container, and then use `node` to connect to the service. + +```yaml +jobs: + container-job: + runs-on: ubuntu-latest + container: node:10.18-jessie + services: + postgres: + image: postgres + steps: + - name: Check out repository code + uses: actions/checkout@v2 + - name: Install dependencies + run: npm ci + - name: Connect to PostgreSQL + run: node client.js + env: + POSTGRES_HOST: postgres + POSTGRES_PORT: 5432 +``` + +For more information, see "[Using databases and service containers](/actions/configuring-and-managing-workflows/using-databases-and-service-containers)." + +### Using labels to route workflows + +This feature helps you assign jobs to a specific self-hosted runner. If you want to be sure that a particular type of runner will process your job, you can use labels to control where jobs are executed. You can assign labels to a self-hosted runner, and then refer to these labels in your YAML workflow, ensuring that the job is routed in a predictable way. + +This example shows how a workflow can use labels to specify the required runner: + +```yaml +jobs: + example-job: + runs-on: [self-hosted, linux, x64, gpu] +``` + +For more information, see ["Using labels with self-hosted runners](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners)." + +### 다음 단계 + +To continue learning about {% data variables.product.prodname_actions %}, see "[Sharing workflows with your organization](/actions/learn-github-actions/sharing-workflows-with-your-organization)." diff --git a/translations/ko-KR/content/actions/learn-github-actions/migrating-from-azure-pipelines-to-github-actions.md b/translations/ko-KR/content/actions/learn-github-actions/migrating-from-azure-pipelines-to-github-actions.md new file mode 100644 index 000000000000..198202140253 --- /dev/null +++ b/translations/ko-KR/content/actions/learn-github-actions/migrating-from-azure-pipelines-to-github-actions.md @@ -0,0 +1,327 @@ +--- +title: Migrating from Azure Pipelines to GitHub Actions +intro: '{% data variables.product.prodname_actions %} and Azure Pipelines share several configuration similarities, which makes migrating to {% data variables.product.prodname_actions %} relatively straightforward.' +redirect_from: + - /actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Introduction + +Azure Pipelines and {% data variables.product.prodname_actions %} both allow you to create workflows that automatically build, test, publish, release, and deploy code. Azure Pipelines and {% data variables.product.prodname_actions %} share some similarities in workflow configuration: + +- Workflow configuration files are written in YAML and are stored in the code's repository. +- Workflows include one or more jobs. +- Jobs include one or more steps or individual commands. +- Steps or tasks can be reused and shared with the community. + +For more information, see "[Core concepts for {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)." + +### Key differences + +When migrating from Azure Pipelines, consider the following differences: + +- Azure Pipelines supports a legacy _classic editor_, which lets you define your CI configuration in a GUI editor instead of creating the pipeline definition in a YAML file. {% data variables.product.prodname_actions %} uses YAML files to define workflows and does not support a graphical editor. +- Azure Pipelines allows you to omit some structure in job definitions. For example, if you only have a single job, you don't need to define the job and only need to define its steps. {% data variables.product.prodname_actions %} requires explicit configuration, and YAML structure cannot be omitted. +- Azure Pipelines supports _stages_ defined in the YAML file, which can be used to create deployment workflows. {% data variables.product.prodname_actions %} requires you to separate stages into separate YAML workflow files. +- On-premises Azure Pipelines build agents can be selected with capabilities. {% data variables.product.prodname_actions %} self-hosted runners can be selected with labels. + +### Migrating jobs and steps + +Jobs and steps in Azure Pipelines are very similar to jobs and steps in {% data variables.product.prodname_actions %}. In both systems, jobs have the following characteristics: + +* Jobs contain a series of steps that run sequentially. +* Jobs run on separate virtual machines or in separate containers. +* Jobs run in parallel by default, but can be configured to run sequentially. + +### Migrating script steps + +You can run a script or a shell command as a step in a workflow. In Azure Pipelines, script steps can be specified using the `script` key, or with the `bash`, `powershell`, or `pwsh` keys. Scripts can also be specified as an input to the [Bash task](https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/utility/bash?view=azure-devops) or the [PowerShell task](https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/utility/powershell?view=azure-devops). + +In {% data variables.product.prodname_actions %}, all scripts are specified using the `run` key. To select a particular shell, you can specify the `shell` key when providing the script. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)." + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +Azure Pipelines + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +jobs: +- job: scripts + pool: + vmImage: 'windows-latest' + steps: + - script: echo "This step runs in the default shell" + - bash: echo "This step runs in bash" + - pwsh: Write-Host "This step runs in PowerShell Core" + - task: PowerShell@2 + inputs: + script: Write-Host "This step runs in PowerShell" +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + scripts: + runs-on: windows-latest + steps: + - run: echo "This step runs in the default shell" + - run: echo "This step runs in bash" + shell: bash + - run: Write-Host "This step runs in PowerShell Core" + shell: pwsh + - run: Write-Host "This step runs in PowerShell" + shell: powershell +``` +{% endraw %} +
    + +### Differences in script error handling + +In Azure Pipelines, scripts can be configured to error if any output is sent to `stderr`. {% data variables.product.prodname_actions %} does not support this configuration. + +{% data variables.product.prodname_actions %} configures shells to "fail fast" whenever possible, which stops the script immediately if one of the commands in a script exits with an error code. In contrast, Azure Pipelines requires explicit configuration to exit immediately on an error. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#exit-codes-and-error-action-preference)." + +### Differences in the default shell on Windows + +In Azure Pipelines, the default shell for scripts on Windows platforms is the Command shell (_cmd.exe_). In {% data variables.product.prodname_actions %}, the default shell for scripts on Windows platforms is PowerShell. PowerShell has several differences in built-in commands, variable expansion, and flow control. + +If you're running a simple command, you might be able to run a Command shell script in PowerShell without any changes. But in most cases, you will either need to update your script with PowerShell syntax or instruct {% data variables.product.prodname_actions %} to run the script with the Command shell instead of PowerShell. You can do this by specifying `shell` as `cmd`. + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +Azure Pipelines + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +jobs: +- job: run_command + pool: + vmImage: 'windows-latest' + steps: + - script: echo "This step runs in CMD on Windows by default" +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + run_command: + runs-on: windows-latest + steps: + - run: echo "This step runs in PowerShell on Windows by default" + - run: echo "This step runs in CMD on Windows explicitly" + shell: cmd +``` +{% endraw %} +
    + +For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#using-a-specific-shell)." + +### Migrating conditionals and expression syntax + +Azure Pipelines and {% data variables.product.prodname_actions %} can both run steps conditionally. In Azure Pipelines, conditional expressions are specified using the `condition` key. In {% data variables.product.prodname_actions %}, conditional expressions are specified using the `if` key. + +Azure Pipelines uses functions within expressions to execute steps conditionally. In contrast, {% data variables.product.prodname_actions %} uses an infix notation. For example, you must replace the `eq` function in Azure Pipelines with the `==` operator in {% data variables.product.prodname_actions %}. + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +Azure Pipelines + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +jobs: +- job: conditional + pool: + vmImage: 'ubuntu-latest' + steps: + - script: echo "This step runs with str equals 'ABC' and num equals 123" + condition: and(eq(variables.str, 'ABC'), eq(variables.num, 123)) +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + conditional: + runs-on: ubuntu-latest + steps: + - run: echo "This step runs with str equals 'ABC' and num equals 123" + if: ${{ env.str == 'ABC' && env.num == 123 }} +``` +{% endraw %} +
    + +For more information, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)." + +### Dependencies between jobs + +Both Azure Pipelines and {% data variables.product.prodname_actions %} allow you to set dependencies for a job. In both systems, jobs run in parallel by default, but job dependencies can be specified explicitly. In Azure Pipelines, this is done with the `dependsOn` key. In {% data variables.product.prodname_actions %}, this is done with the `needs` key. + +Below is an example of the syntax for each system. The workflows start a first job named `initial`, and when that job completes, two jobs named `fanout1` and `fanout2` will run. Finally, when those jobs complete, the job `fanin` will run. + + + + + + + + + + +
    +Azure Pipelines + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +jobs: +- job: initial + pool: + vmImage: 'ubuntu-latest' + steps: + - script: echo "This job will be run first." +- job: fanout1 + pool: + vmImage: 'ubuntu-latest' + dependsOn: initial + steps: + - script: echo "This job will run after the initial job, in parallel with fanout2." +- job: fanout2 + pool: + vmImage: 'ubuntu-latest' + dependsOn: initial + steps: + - script: echo "This job will run after the initial job, in parallel with fanout1." +- job: fanin: + pool: + vmImage: 'ubuntu-latest' + dependsOn: [fanout1, fanout2] + steps: + - script: echo "This job will run after fanout1 and fanout2 have finished." +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + initial: + runs-on: ubuntu-latest + steps: + - run: echo "This job will be run first." + fanout1: + runs-on: ubuntu-latest + needs: initial + steps: + - run: echo "This job will run after the initial job, in parallel with fanout2." + fanout2: + runs-on: ubuntu-latest + needs: initial + steps: + - run: echo "This job will run after the initial job, in parallel with fanout1." + fanin: + runs-on: ubuntu-latest + needs: [fanout1, fanout2] + steps: + - run: echo "This job will run after fanout1 and fanout2 have finished." +``` +{% endraw %} +
    + +For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)." + +### Migrating tasks to actions + +Azure Pipelines uses _tasks_, which are application components that can be re-used in multiple workflows. {% data variables.product.prodname_actions %} uses _actions_, which can be used to perform tasks and customize your workflow. In both systems, you can specify the name of the task or action to run, along with any required inputs as key/value pairs. + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +Azure Pipelines + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +jobs: +- job: run_python + pool: + vmImage: 'ubuntu-latest' + steps: + - task: UsePythonVersion@0 + inputs: + versionSpec: '3.7' + architecture: 'x64' + - script: python script.py +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + run_python: + runs-on: ubuntu-latest + steps: + - uses: actions/setup-python@v2 + with: + python-version: '3.7' + architecture: 'x64' + - run: python script.py +``` +{% endraw %} +
    + +You can find actions that you can use in your workflow in [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=actions), or you can create your own actions. For more information, see "[Creating actions](/actions/creating-actions)." + diff --git a/translations/ko-KR/content/actions/learn-github-actions/migrating-from-circleci-to-github-actions.md b/translations/ko-KR/content/actions/learn-github-actions/migrating-from-circleci-to-github-actions.md new file mode 100644 index 000000000000..17d1431c827d --- /dev/null +++ b/translations/ko-KR/content/actions/learn-github-actions/migrating-from-circleci-to-github-actions.md @@ -0,0 +1,447 @@ +--- +title: Migrating from CircleCI to GitHub Actions +intro: 'GitHub Actions and CircleCI share several similarities in configuration, which makes migration to GitHub Actions relatively straightforward.' +redirect_from: + - /actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Introduction + +CircleCI and {% data variables.product.prodname_actions %} both allow you to create workflows that automatically build, test, publish, release, and deploy code. CircleCI and {% data variables.product.prodname_actions %} share some similarities in workflow configuration: + +- Workflow configuration files are written in YAML and stored in the repository. +- Workflows include one or more jobs. +- Jobs include one or more steps or individual commands. +- Steps or tasks can be reused and shared with the community. + +For more information, see "[Core concepts for {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)." + +### Key differences + +When migrating from CircleCI, consider the following differences: + +- CircleCI’s automatic test parallelism automatically groups tests according to user-specified rules or historical timing information. This functionality is not built into {% data variables.product.prodname_actions %}. +- Actions that execute in Docker containers are sensitive to permissions problems since containers have a different mapping of users. You can avoid many of these problems by not using the `USER` instruction in your *Dockerfile*. For more information about the Docker filesystem on {% data variables.product.product_name %}-hosted runners, see "[Virtual environments for {% data variables.product.product_name %}-hosted runners](/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem)." + +### Migrating workflows and jobs + +CircleCI defines `workflows` in the *config.yml* file, which allows you to configure more than one workflow. {% data variables.product.product_name %} requires one workflow file per workflow, and as a consequence, does not require you to declare `workflows`. You'll need to create a new workflow file for each workflow configured in *config.yml*. + +Both CircleCI and {% data variables.product.prodname_actions %} configure `jobs` in the configuration file using similar syntax. If you configure any dependencies between jobs using `requires` in your CircleCI workflow, you can use the equivalent {% data variables.product.prodname_actions %} `needs` syntax. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)." + +### Migrating orbs to actions + +Both CircleCI and {% data variables.product.prodname_actions %} provide a mechanism to reuse and share tasks in a workflow. CircleCI uses a concept called orbs, written in YAML, to provide tasks that people can reuse in a workflow. {% data variables.product.prodname_actions %} has powerful and flexible reusable components called actions, which you build with either JavaScript files or Docker images. You can create actions by writing custom code that interacts with your repository in any way you'd like, including integrating with {% data variables.product.product_name %}'s APIs and any publicly available third-party API. For example, an action can publish npm modules, send SMS alerts when urgent issues are created, or deploy production-ready code. For more information, see "[Creating actions](/actions/creating-actions)." + +CircleCI can reuse pieces of workflows with YAML anchors and aliases. {% data variables.product.prodname_actions %} supports the most common need for reusability using build matrixes. For more information about build matrixes, see "[Managing complex workflows](/actions/learn-github-actions/managing-complex-workflows/#using-a-build-matrix)." + +### Using Docker images + + +Both CircleCI and {% data variables.product.prodname_actions %} support running steps inside of a Docker image. + +CircleCI provides a set of pre-built images with common dependencies. These images have the `USER` set to `circleci`, which causes permissions to conflict with {% data variables.product.prodname_actions %}. + +We recommend that you move away from CircleCI's pre-built images when you migrate to {% data variables.product.prodname_actions %}. In many cases, you can use actions to install the additional dependencies you need. + +For more information about the Docker filesystem, see "[Virtual environments for {% data variables.product.product_name %}-hosted runners](/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem)." + +For more information about the tools and packages available on {% data variables.product.prodname_dotcom %}-hosted virtual environments, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". + +### Using variables and secrets + +CircleCI and {% data variables.product.prodname_actions %} support setting environment variables in the configuration file and creating secrets using the CircleCI or {% data variables.product.product_name %} UI. + +For more information, see "[Using environment variables](/actions/configuring-and-managing-workflows/using-environment-variables)" and "[Creating and using encrypted secrets](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)." + +### Caching + +CircleCI and {% data variables.product.prodname_actions %} provide a method to manually cache files in the configuration file. + +Below is an example of the syntax for each system. + + + + + + + + + + +
    +CircleCI + +GitHub Actions +
    +{% raw %} +```yaml +- restore_cache: + keys: + - v1-npm-deps-{{ checksum "package-lock.json" }} + - v1-npm-deps- +``` +{% endraw %} + +{% raw %} +```yaml +- name: Cache node modules + uses: actions/cache@v2 + with: + path: ~/.npm + key: v1-npm-deps-${{ hashFiles('**/package-lock.json') }} + restore-keys: v1-npm-deps- +``` +{% endraw %} +
    + +For more information, see "[Caching dependencies to speed up workflows](/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows)." + +{% data variables.product.prodname_actions %} does not have an equivalent of CircleCI’s Docker Layer Caching (or DLC). + +### Persisting data between jobs + +Both CircleCI and {% data variables.product.prodname_actions %} provide mechanisms to persist data between jobs. + +Below is an example in CircleCI and {% data variables.product.prodname_actions %} configuration syntax. + + + + + + + + + + +
    +CircleCI + +GitHub Actions +
    +{% raw %} +```yaml +- persist_to_workspace: + root: workspace + paths: + - math-homework.txt + +... + +- attach_workspace: + at: /tmp/workspace +``` +{% endraw %} + +{% raw %} +```yaml +- name: Upload math result for job 1 + uses: actions/upload-artifact@v2 + with: + name: homework + path: math-homework.txt + +... + +- name: Download math result for job 1 + uses: actions/download-artifact@v2 + with: + name: homework +``` +{% endraw %} +
    + +For more information, see "[Persisting workflow data using artifacts](/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts)." + +### Using databases and service containers + +Both systems enable you to include additional containers for databases, caching, or other dependencies. + +In CircleCI, the first image listed in the *config.yaml* is the primary image used to run commands. {% data variables.product.prodname_actions %} uses explicit sections: use `container` for the primary container, and list additional containers in `services`. + +Below is an example in CircleCI and {% data variables.product.prodname_actions %} configuration syntax. + + + + + + + + + + +
    +CircleCI + +GitHub Actions +
    +{% raw %} +```yaml +--- +version: 2.1 + +jobs: + + ruby-26: + docker: + - image: circleci/ruby:2.6.3-node-browsers-legacy + environment: + PGHOST: localhost + PGUSER: administrate + RAILS_ENV: test + - image: postgres:10.1-alpine + environment: + POSTGRES_USER: administrate + POSTGRES_DB: ruby26 + POSTGRES_PASSWORD: "" + + working_directory: ~/administrate + + steps: + - checkout + + # Bundle install dependencies + - run: bundle install --path vendor/bundle + + # Wait for DB + - run: dockerize -wait tcp://localhost:5432 -timeout 1m + + # Setup the environment + - run: cp .sample.env .env + + # Setup the database + - run: bundle exec rake db:setup + + # Run the tests + - run: bundle exec rake + + +workflows: + version: 2 + build: + jobs: + - ruby-26 +... + +- attach_workspace: + at: /tmp/workspace +``` +{% endraw %} + +{% raw %} +```yaml +name: Containers + +on: [push] + +jobs: + build: + + runs-on: ubuntu-latest + container: circleci/ruby:2.6.3-node-browsers-legacy + + env: + PGHOST: postgres + PGUSER: administrate + RAILS_ENV: test + + services: + postgres: + image: postgres:10.1-alpine + env: + POSTGRES_USER: administrate + POSTGRES_DB: ruby25 + POSTGRES_PASSWORD: "" + ports: + - 5432:5432 + # Add a health check + options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5 + + steps: + # This Docker file changes sets USER to circleci instead of using the default user, so we need to update file permissions for this image to work on GH Actions. + # See https://docs.github.com/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem + - name: Setup file system permissions + run: sudo chmod -R 777 $GITHUB_WORKSPACE /github /__w/_temp + - uses: actions/checkout@v2 + - name: Install dependencies + run: bundle install --path vendor/bundle + - name: Setup environment configuration + run: cp .sample.env .env + - name: Setup database + run: bundle exec rake db:setup + - name: Run tests + run: bundle exec rake +``` +{% endraw %} +
    + +For more information, see "[About service containers](/actions/configuring-and-managing-workflows/about-service-containers)." + +### Complete Example + +Below is a real-world example. The left shows the actual CircleCI *config.yml* for the [thoughtbot/administrator](https://github.com/thoughtbot/administrate) repository. The right shows the {% data variables.product.prodname_actions %} equivalent. + + + + + + + + + + +
    +CircleCI + +GitHub Actions +
    +{% raw %} +```yaml +--- +version: 2.1 + +commands: + shared_steps: + steps: + - checkout + + # Restore Cached Dependencies + - restore_cache: + name: Restore bundle cache + key: administrate-{{ checksum "Gemfile.lock" }} + + # Bundle install dependencies + - run: bundle install --path vendor/bundle + + # Cache Dependencies + - save_cache: + name: Store bundle cache + key: administrate-{{ checksum "Gemfile.lock" }} + paths: + - vendor/bundle + + # Wait for DB + - run: dockerize -wait tcp://localhost:5432 -timeout 1m + + # Setup the environment + - run: cp .sample.env .env + + # Setup the database + - run: bundle exec rake db:setup + + # Run the tests + - run: bundle exec rake + +default_job: &default_job + working_directory: ~/administrate + steps: + - shared_steps + # Run the tests against multiple versions of Rails + - run: bundle exec appraisal install + - run: bundle exec appraisal rake + +jobs: + ruby-25: + <<: *default_job + docker: + - image: circleci/ruby:2.5.0-node-browsers + environment: + PGHOST: localhost + PGUSER: administrate + RAILS_ENV: test + - image: postgres:10.1-alpine + environment: + POSTGRES_USER: administrate + POSTGRES_DB: ruby25 + POSTGRES_PASSWORD: "" + + ruby-26: + <<: *default_job + docker: + - image: circleci/ruby:2.6.3-node-browsers-legacy + environment: + PGHOST: localhost + PGUSER: administrate + RAILS_ENV: test + - image: postgres:10.1-alpine + environment: + POSTGRES_USER: administrate + POSTGRES_DB: ruby26 + POSTGRES_PASSWORD: "" + + +workflows: + version: 2 + multiple-rubies: + jobs: + - ruby-26 + - ruby-25 +``` +{% endraw %} + +{% raw %} +```yaml +name: Containers + +on: [push] + +jobs: + build: + + strategy: + matrix: + ruby: [2.5, 2.6.3] + + runs-on: ubuntu-latest + + env: + PGHOST: localhost + PGUSER: administrate + RAILS_ENV: test + + services: + postgres: + image: postgres:10.1-alpine + env: + POSTGRES_USER: administrate + POSTGRES_DB: ruby25 + POSTGRES_PASSWORD: "" + ports: + - 5432:5432 + # Add a health check + options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5 + + steps: + - uses: actions/checkout@v2 + - name: Setup Ruby + uses: eregon/use-ruby-action@master + with: + ruby-version: ${{ matrix.ruby }} + - name: Cache dependencies + uses: actions/cache@v2 + with: + path: vendor/bundle + key: administrate-${{ matrix.image }}-${{ hashFiles('Gemfile.lock') }} + - name: Install postgres headers + run: sudo apt-get install libpq-dev + - name: Install dependencies + run: bundle install --path vendor/bundle + - name: Setup environment configuration + run: cp .sample.env .env + - name: Setup database + run: bundle exec rake db:setup + - name: Run tests + run: bundle exec rake + - name: Install appraisal + run: bundle exec appraisal install + - name: Run appraisal + run: bundle exec appraisal rake +``` +{% endraw %} +
    diff --git a/translations/ko-KR/content/actions/learn-github-actions/migrating-from-gitlab-cicd-to-github-actions.md b/translations/ko-KR/content/actions/learn-github-actions/migrating-from-gitlab-cicd-to-github-actions.md new file mode 100644 index 000000000000..873144e8fe04 --- /dev/null +++ b/translations/ko-KR/content/actions/learn-github-actions/migrating-from-gitlab-cicd-to-github-actions.md @@ -0,0 +1,476 @@ +--- +title: Migrating from GitLab CI/CD to GitHub Actions +intro: '{% data variables.product.prodname_actions %} and GitLab CI/CD share several configuration similarities, which makes migrating to {% data variables.product.prodname_actions %} relatively straightforward.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Introduction + +GitLab CI/CD and {% data variables.product.prodname_actions %} both allow you to create workflows that automatically build, test, publish, release, and deploy code. GitLab CI/CD and {% data variables.product.prodname_actions %} share some similarities in workflow configuration: + +- Workflow configuration files are written in YAML and are stored in the code's repository. +- Workflows include one or more jobs. +- Jobs include one or more steps or individual commands. +- Jobs can run on either managed or self-hosted machines. + +There are a few differences, and this guide will show you the important differences so that you can migrate your workflow to {% data variables.product.prodname_actions %}. + +### Jobs + +Jobs in GitLab CI/CD are very similar to jobs in {% data variables.product.prodname_actions %}. In both systems, jobs have the following characteristics: + +* Jobs contain a series of steps or scripts that run sequentially. +* Jobs can run on separate machines or in separate containers. +* Jobs run in parallel by default, but can be configured to run sequentially. + +You can run a script or a shell command in a job. In GitLab CI/CD, script steps are specified using the `script` key. In {% data variables.product.prodname_actions %}, all scripts are specified using the `run` key. + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +job1: + variables: + GIT_CHECKOUT: "true" + script: + - echo "Run your script here" +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + job1: + steps: + - uses: actions/checkout@v2 + - run: echo "Run your script here" +``` +{% endraw %} +
    + +### Runners + +Runners are machines on which the jobs run. Both GitLab CI/CD and {% data variables.product.prodname_actions %} offer managed and self-hosted variants of runners. In GitLab CI/CD, `tags` are used to run jobs on different platforms, while in {% data variables.product.prodname_actions %} it is done with the `runs-on` key. + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +windows_job: + tags: + - windows + script: + - echo Hello, %USERNAME%! + +linux_job: + tags: + - linux + script: + - echo "Hello, $USER!" +``` +{% endraw %} + +{% raw %} +```yaml +windows_job: + runs-on : windows-latest + steps: + - run: echo Hello, %USERNAME%! + +linux_job: + runs-on: ubuntu-latest + steps: + - run: echo "Hello, $USER!" +``` +{% endraw %} +
    + +For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on)." + +### Docker images + +Both GitLab CI/CD and {% data variables.product.prodname_actions %} support running jobs in a Docker image. In GitLab CI/CD, Docker images are defined with a `image` key, while in {% data variables.product.prodname_actions %} it is done with the `container` key. + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +my_job: + image: node:10.16-jessie +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + my_job: + container: node:10.16-jessie +``` +{% endraw %} +
    + +For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idcontainer)." + +### Condition and expression syntax + +GitLab CI/CD uses `rules` to determine if a job will run for a specific condition. {% data variables.product.prodname_actions %} uses the `if` keyword to prevent a job from running unless a condition is met. + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +deploy_prod: + stage: deploy + script: + - echo "Deply to production server" + rules: + - if: '$CI_COMMIT_BRANCH == "master"' +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + deploy_prod: + if: contains( github.ref, 'master') + runs-on: ubuntu-latest + steps: + - run: echo "Deply to production server" +``` +{% endraw %} +
    + +For more information, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)." + +### Dependencies between Jobs + +Both GitLab CI/CD and {% data variables.product.prodname_actions %} allow you to set dependencies for a job. In both systems, jobs run in parallel by default, but job dependencies in {% data variables.product.prodname_actions %} can be specified explicitly with the `needs` key. GitLab CI/CD also has a concept of `stages`, where jobs in a stage run concurrently, but the next stage will start when all the jobs in the previous stage have completed. You can recreate this scenario in {% data variables.product.prodname_actions %} with the `needs` key. + +Below is an example of the syntax for each system. The workflows start with two jobs named `build_a` and `build_b` running in parallel, and when those jobs complete, another job called `test_ab` will run. Finally, when `test_ab` completes, the `deploy_ab` job will run. + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +stages: + - build + - test + - deploy + +build_a: + stage: build + script: + - echo "This job will run first." + +build_b: + stage: build + script: + - echo "This job will run first, in parallel with build_a." + +test_ab: + stage: test + script: + - echo "This job will run after build_a and build_b have finished." + +deploy_ab: + stage: deploy + script: + - echo "This job will run after test_ab is complete" +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + build_a: + runs-on: ubuntu-latest + steps: + - run: echo "This job will be run first." + + build_b: + runs-on: ubuntu-latest + steps: + - run: echo "This job will be run first, in parallel with build_a" + + test_ab: + runs-on: ubuntu-latest + needs: [build_a,build_b] + steps: + - run: echo "This job will run after build_a and build_b have finished" + + deploy_ab: + runs-on: ubuntu-latest + needs: [test_ab] + steps: + - run: echo "This job will run after test_ab is complete" +``` +{% endraw %} +
    + +For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)." + +### Scheduling workflows + +Both GitLab CI/CD and {% data variables.product.prodname_actions %} allow you to run workflows at a specific interval. In GitLab CI/CD, pipeline schedules are configured with the UI, while in {% data variables.product.prodname_actions %} you can trigger a workflow on a scheduled interval with the "on" key. + +For more information, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows#scheduled-events)." + +### Variables and secrets + +GitLab CI/CD and {% data variables.product.prodname_actions %} support setting environment variables in the pipeline or workflow configuration file, and creating secrets using the GitLab or {% data variables.product.product_name %} UI. + +For more information, see "[Environment variables](/actions/reference/environment-variables)" and "[Encrypted secrets](/actions/reference/encrypted-secrets)." + +### Caching + +GitLab CI/CD and {% data variables.product.prodname_actions %} provide a method in the configuration file to manually cache workflow files. + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +image: node:latest + +cache: + key: $CI_COMMIT_REF_SLUG + paths: + - .npm/ + +before_script: + - npm ci --cache .npm --prefer-offline + +test_async: + script: + - node ./specs/start.js ./specs/async.spec.js +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + test_async: + - name: Cache node modules + uses: actions/cache@v2 + with: + path: ~/.npm + key: v1-npm-deps-${{ hashFiles('**/package-lock.json') }} + restore-keys: v1-npm-deps- +``` +{% endraw %} +
    + +For more information, see "[Caching dependencies to speed up workflows](/actions/guides/caching-dependencies-to-speed-up-workflows)." + +### Artifacts + +Both GitLab CI/CD and {% data variables.product.prodname_actions %} can upload files and directories created by a job as artifacts. In {% data variables.product.prodname_actions %}, artifacts can be used to persist data across multiple jobs. + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +script: +artifacts: + paths: + - math-homework.txt +``` +{% endraw %} + +{% raw %} +```yaml +- name: Upload math result for job 1 + uses: actions/upload-artifact@v2 + with: + name: homework + path: math-homework.txt +``` +{% endraw %} +
    + +For more information, see "[Storing workflow data as artifacts](/actions/guides/storing-workflow-data-as-artifacts)." + +### Databases and service containers + +Both systems enable you to include additional containers for databases, caching, or other dependencies. + +In GitLab CI/CD, a container for the job is specified with the `image` key, while {% data variables.product.prodname_actions %} uses the `container` key. In both systems, additional service containers are specified with the `services` key. + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +container-job: + variables: + POSTGRES_PASSWORD: postgres + # The hostname used to communicate with the + # PostgreSQL service container + POSTGRES_HOST: postgres + # The default PostgreSQL port + POSTGRES_PORT: 5432 + image: node:10.18-jessie + services: + - postgres + script: + # Performs a clean installation of all dependencies + # in the `package.json` file + - npm ci + # Runs a script that creates a PostgreSQL client, + # populates the client with data, and retrieves data + - node client.js + tags: + - docker +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + container-job: + runs-on: ubuntu-latest + container: node:10.18-jessie + + services: + postgres: + image: postgres + env: + POSTGRES_PASSWORD: postgres + + steps: + - name: Check out repository code + uses: actions/checkout@v2 + + # Performs a clean installation of all dependencies + # in the `package.json` file + - name: Install dependencies + run: npm ci + + - name: Connect to PostgreSQL + # Runs a script that creates a PostgreSQL client, + # populates the client with data, and retrieves data + run: node client.js + env: + # The hostname used to communicate with the + # PostgreSQL service container + POSTGRES_HOST: postgres + # The default PostgreSQL port + POSTGRES_PORT: 5432 +``` +{% endraw %} +
    + +For more information, see "[About service containers](/actions/guides/about-service-containers)." diff --git a/translations/ko-KR/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md b/translations/ko-KR/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md new file mode 100644 index 000000000000..5120c8308704 --- /dev/null +++ b/translations/ko-KR/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md @@ -0,0 +1,293 @@ +--- +title: Migrating from Jenkins to GitHub Actions +intro: '{% data variables.product.prodname_actions %} and Jenkins share multiple similarities, which makes migration to {% data variables.product.prodname_actions %} relatively straightforward.' +redirect_from: + - /actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Introduction + +Jenkins and {% data variables.product.prodname_actions %} both allow you to create workflows that automatically build, test, publish, release, and deploy code. Jenkins and {% data variables.product.prodname_actions %} share some similarities in workflow configuration: + +- Jenkins creates workflows using _Declarative Pipelines_, which are similar to {% data variables.product.prodname_actions %} workflow files. +- Jenkins uses _stages_ to run a collection of steps, while {% data variables.product.prodname_actions %} uses jobs to group one or more steps or individual commands. +- Jenkins and {% data variables.product.prodname_actions %} support container-based builds. For more information, see "[Creating a Docker container action](/articles/creating-a-docker-container-action)." +- Steps or tasks can be reused and shared with the community. + +For more information, see "[Core concepts for {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)." + +### Key differences + +- Jenkins has two types of syntax for creating pipelines: Declarative Pipeline and Scripted Pipeline. {% data variables.product.prodname_actions %} uses YAML to create workflows and configuration files. For more information, see "[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions)." +- Jenkins deployments are typically self-hosted, with users maintaining the servers in their own data centers. {% data variables.product.prodname_actions %} offers a hybrid cloud approach by hosting its own runners that you can use to run jobs, while also supporting self-hosted runners. For more information, see [About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners). + +### Comparing capabilities + +#### Distributing your builds + +Jenkins lets you send builds to a single build agent, or you can distribute them across multiple agents. You can also classify these agents according to various attributes, such as operating system types. + +Similarly, {% data variables.product.prodname_actions %} can send jobs to {% data variables.product.prodname_dotcom %}-hosted or self-hosted runners, and you can use labels to classify runners according to various attributes. The following table compares how the distributed build concept is implemented for both Jenkins and {% data variables.product.prodname_actions %}. + +| Jenkins | {% data variables.product.prodname_actions %} +| ---------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`agents`](https://wiki.jenkins.io/display/JENKINS/Distributed+builds) | [`runners`](/actions/learn-github-actions/introduction-to-github-actions#runners)
    [`self-hosted runners`](/actions/hosting-your-own-runners/about-self-hosted-runners) | + +#### Using sections to organize pipelines + +Jenkins splits its Declarative Pipelines into multiple sections. Similarly, {% data variables.product.prodname_actions %} organizes its workflows into separate sections. The table below compares Jenkins sections with the {% data variables.product.prodname_actions %} workflow. + +| Jenkins Directives | {% data variables.product.prodname_actions %} +| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| [`agent`](https://jenkins.io/doc/book/pipeline/syntax/#agent) | [`jobs..runs-on`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idruns-on)
    [`jobs..container`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idcontainer) | +| [`게시`](https://jenkins.io/doc/book/pipeline/syntax/#post) | | +| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#stages) | [`jobs`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobs) | +| [`steps`](https://jenkins.io/doc/book/pipeline/syntax/#steps) | [`jobs..steps`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idsteps) | + + +### Using directives + +Jenkins uses directives to manage _Declarative Pipelines_. These directives define the characteristics of your workflow and how it will execute. The table below demonstrates how these directives map to concepts within {% data variables.product.prodname_actions %}. + +| Jenkins Directives | {% data variables.product.prodname_actions %} +| ------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`environment`](https://jenkins.io/doc/book/pipeline/syntax/#environment) | [`jobs..env`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env)
    [`jobs..steps.env`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv) | +| [`options`](https://jenkins.io/doc/book/pipeline/syntax/#parameters) | [`jobs..strategy`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategy)
    [`jobs..strategy.fail-fast`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategyfail-fast)
    [`jobs..timeout-minutes`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idtimeout-minutes) | +| [`parameters`](https://jenkins.io/doc/book/pipeline/syntax/#parameters) | [`inputs`](/actions/creating-actions/metadata-syntax-for-github-actions#inputs)
    [`outputs`](/actions/creating-actions/metadata-syntax-for-github-actions#outputs) | +| [`triggers`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`on`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#on)
    [`on..types`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onevent_nametypes)
    [on..](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)
    [on..paths](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpushpull_requestpaths) | +| [`triggers { upstreamprojects() }`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`jobs..needs`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idneeds) | +| [Jenkins cron syntax](https://jenkins.io/doc/book/pipeline/syntax/#cron-syntax) | [`on.schedule`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onschedule) | +| [`단계`](https://jenkins.io/doc/book/pipeline/syntax/#stage) | [`jobs.`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_id)
    [`jobs..name`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idname) | +| [`tools`](https://jenkins.io/doc/book/pipeline/syntax/#tools) | [Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software) | +| [`input`](https://jenkins.io/doc/book/pipeline/syntax/#input) | [`inputs`](/actions/automating-your-workflow-with-github-actions/metadata-syntax-for-github-actions#inputs) | +| [`when`](https://jenkins.io/doc/book/pipeline/syntax/#when) | [`jobs..if`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idif) | + + +### Using sequential stages + +#### Parallel job processing + +Jenkins can run the `stages` and `steps` in parallel, while {% data variables.product.prodname_actions %} currently only runs jobs in parallel. + +| Jenkins Parallel | {% data variables.product.prodname_actions %} +| ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`parallel`](https://jenkins.io/doc/book/pipeline/syntax/#parallel) | [`jobs..strategy.max-parallel`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymax-parallel) | + +#### Build matrix + +Both {% data variables.product.prodname_actions %} and Jenkins let you use a build matrix to define various system combinations. + +| Jenkins | {% data variables.product.prodname_actions %} +| ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`axis`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-axes) | [`strategy/matrix`](/actions/learn-github-actions/managing-complex-workflows/#using-a-build-matrix)
    [`context`](/actions/reference/context-and-expression-syntax-for-github-actions) | +| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages) | [`steps-context`](/actions/reference/context-and-expression-syntax-for-github-actions#steps-context) | +| [`excludes`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages) | | + +#### Using steps to execute tasks + +Jenkins groups `steps` together in `stages`. Each of these steps can be a script, function, or command, among others. Similarly, {% data variables.product.prodname_actions %} uses `jobs` to execute specific groups of `steps`. + +| Jenkins steps | {% data variables.product.prodname_actions %} +| --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | +| [`script`](https://jenkins.io/doc/book/pipeline/syntax/#script) | [`jobs..steps`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idsteps) | + +### Examples of common tasks + +#### Scheduling a pipeline to run with `cron` + + + + + + + + + + +
    +Jenkins Pipeline + +{% data variables.product.prodname_actions %} Workflow +
    + + ```yaml + pipeline { + agent any + triggers { + cron('H/15 * * * 1-5') + } + } + ``` + + + + ```yaml + on: + schedule: + - cron: '*/15 * * * 1-5' + ``` + +
    + +#### Configuring environment variables in a pipeline + + + + + + + + + + +
    +Jenkins Pipeline + +{% data variables.product.prodname_actions %} Workflow +
    + + ```yaml + pipeline { + agent any + environment { + MAVEN_PATH = '/usr/local/maven' + } + } + ``` + + + + ```yaml + jobs: + maven-build: + env: + MAVEN_PATH: '/usr/local/maven' + + ``` + +
    + +#### Building from upstream projects + + + + + + + + + + +
    +Jenkins Pipeline + +{% data variables.product.prodname_actions %} Workflow +
    + + ```yaml + pipeline { + triggers { + upstream( + upstreamProjects: 'job1,job2', + threshold: hudson.model.Result.SUCCESS) + } + } + } + + ``` + + + + ```yaml + jobs: + job1: + job2: + needs: job1 + job3: + needs: [job1, job2] + + ``` + +
    + +#### Building with multiple operating systems + + + + + + + + + + +
    +Jenkins Pipeline + +{% data variables.product.prodname_actions %} Workflow +
    + + ```yaml +pipeline { + agent none + stages { + stage('Run Tests') { + parallel { + stage('Test On MacOS') { + agent { label "macos" } + tools { nodejs "node-12" } + steps { + dir("scripts/myapp") { + sh(script: "npm install -g bats") + sh(script: "bats tests") + } + } + } + stage('Test On Linux') { + agent { label "linux" } + tools { nodejs "node-12" } + steps { + dir("script/myapp") { + sh(script: "npm install -g bats") + sh(script: "bats tests") + } + } + } + } + } + } +} + ``` + + + +{% raw %} + ```yaml + name: demo-workflow + on: + push: + jobs: + test: + runs-on: ${{ matrix.os }} + strategy: + fail-fast: false + matrix: + os: [macos-latest, ubuntu-latest] + steps: + - uses: actions/checkout@v1 + - uses: actions/setup-node@v1 + with: + node-version: 12 + - run: npm install -g bats + - run: bats tests + working-directory: scripts/myapp + ``` +{% endraw %} + +
    diff --git a/translations/ko-KR/content/actions/learn-github-actions/security-hardening-for-github-actions.md b/translations/ko-KR/content/actions/learn-github-actions/security-hardening-for-github-actions.md new file mode 100644 index 000000000000..2b5ceae9d572 --- /dev/null +++ b/translations/ko-KR/content/actions/learn-github-actions/security-hardening-for-github-actions.md @@ -0,0 +1,97 @@ +--- +title: Security hardening for GitHub Actions +shortTitle: Security hardening +intro: 'Good security practices for using {% data variables.product.prodname_actions %} features.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /actions/getting-started-with-github-actions/security-hardening-for-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### 개요 + +This guide explains how to configure security hardening for certain {% data variables.product.prodname_actions %} features. If the {% data variables.product.prodname_actions %} concepts are unfamiliar, see "[Core concepts for GitHub Actions](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)." + +### Using secrets + +Sensitive values should never be stored as plaintext in workflow files, but rather as secrets. [Secrets](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets) can be configured at the organization or repository level, and allow you to store sensitive information in {% data variables.product.product_name %}. + +Secrets use [Libsodium sealed boxes](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes), so that they are encrypted before reaching {% data variables.product.product_name %}. This occurs when the secret is submitted [using the UI](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets#creating-encrypted-secrets-for-a-repository) or through the [REST API](/rest/reference/actions#secrets). This client-side encryption helps the minimize risks related to accidental logging (for example, exception logs and request logs, among others) within {% data variables.product.product_name %}'s infrastructure. Once the secret is uploaded, {% data variables.product.product_name %} is then able to decrypt it so that it can be injected into the workflow runtime. + +To help prevent accidental disclosure, {% data variables.product.product_name %} uses a mechanism that attempts to redact any secrets that appear in run logs. This redaction looks for exact matches of any configured secrets, as well as common encodings of the values, such as Base64. However, because there are multiple ways a secret value can be transformed, this redaction is not guaranteed. As a result, there are certain proactive steps and good practices you should follow to help ensure secrets are redacted, and to limit other risks associated with secrets: + +- **Never use structured data as a secret** + - Unstructured data can cause secret redaction within logs to fail, because redaction largely relies on finding an exact match for the specific secret value. For example, do not use a blob of JSON, XML, or YAML (or similar) to encapsulate a secret value, as this significantly reduces the probability the secrets will be properly redacted. Instead, create individual secrets for each sensitive value. +- **Register all secrets used within workflows** + - If a secret is used to generate another sensitive value within a workflow, that generated value should be formally [registered as a secret](https://github.com/actions/toolkit/tree/main/packages/core#setting-a-secret), so that it will be redacted if it ever appears in the logs. For example, if using a private key to generate a signed JWT to access a web API, be sure to register that JWT as a secret or else it won’t be redacted if it ever enters the log output. + - Registering secrets applies to any sort of transformation/encoding as well. If your secret is transformed in some way (such as Base64 or URL-encoded), be sure to register the new value as a secret too. +- **Audit how secrets are handled** + - Audit how secrets are used, to help ensure they’re being handled as expected. You can do this by reviewing the source code of the repository executing the workflow, and checking any actions used in the workflow. For example, check that they’re not sent to unintended hosts, or explicitly being printed to log output. + - View the run logs for your workflow after testing valid/invalid inputs, and check that secrets are properly redacted, or not shown. It's not always obvious how a command or tool you’re invoking will send errors to `STDOUT` and `STDERR`, and secrets might subsequently end up in error logs. As a result, it is good practice to manually review the workflow logs after testing valid and invalid inputs. +- **Use credentials that are minimally scoped** + - Make sure the credentials being used within workflows have the least privileges required, and be mindful that any user with write access to your repository has read access to all secrets configured in your repository. +- **Audit and rotate registered secrets** + - Periodically review the registered secrets to confirm they are still required. Remove those that are no longer needed. + - Rotate secrets periodically to reduce the window of time during which a compromised secret is valid. + +### Using third-party actions + +The individual jobs in a workflow can interact with (and compromise) other jobs. For example, a job querying the environment variables used by a later job, writing files to a shared directory that a later job processes, or even more directly by interacting with the Docker socket and inspecting other running containers and executing commands in them. + +This means that a compromise of a single action within a workflow can be very significant, as that compromised action would have access to all secrets configured on your repository, and can use the `GITHUB_TOKEN` to write to the repository. Consequently, there is significant risk in sourcing actions from third-party repositories on {% data variables.product.prodname_dotcom %}. You can help mitigate this risk by following these good practices: + +* **Pin actions to a full length commit SHA** + + Pinning an action to a full length commit SHA is currently the only way to use an action as an immutable release. Pinning to a particular SHA helps mitigate the risk of a bad actor adding a backdoor to the action's repository, as they would need to generate a SHA-1 collision for a valid Git object payload. + + {% warning %} + + **Warning:** The short version of the commit SHA is insecure and should never be used for specifying an action's Git reference. Because of how repository networks work, any user can fork the repository and push a crafted commit to it that collides with the short SHA. This causes subsequent clones at that SHA to fail because it becomes an ambiguous commit. As a result, any workflows that use the shortened SHA will immediately fail. + + {% endwarning %} +* **Audit the source code of the action** + + Ensure that the action is handling the content of your repository and secrets as expected. For example, check that secrets are not sent to unintended hosts, or are not inadvertently logged. + +* **Pin actions to a tag only if you trust the creator** + + Although pinning to a commit SHA is the most secure option, specifying a tag is more convenient and is widely used. If you’d like to specify a tag, then be sure that you trust the action's creators. The ‘Verified creator’ badge on {% data variables.product.prodname_marketplace %} is a useful signal, as it indicates that the action was written by a team whose identity has been verified by {% data variables.product.prodname_dotcom %}. Note that there is risk to this approach even if you trust the author, because a tag can be moved or deleted if a bad actor gains access to the repository storing the action. + +### Considering cross-repository access + +{% data variables.product.product_name %} is intentionally scoped for a single repository at a time. The `GITHUB_TOKEN` used in the workflow environment grants the same level of access as a write-access user, because any write-access user can access this token by creating or modifying workflow files. Users have specific permissions for each repository, so having the `GITHUB_TOKEN` for one repository grant access to another would impact the {% data variables.product.prodname_dotcom %} permission model if not implemented carefully. Similarly, caution must be taken when adding {% data variables.product.prodname_dotcom %} authentication tokens to the workflow environment, because this can also affect the {% data variables.product.prodname_dotcom %} permission model by inadvertently granting broad access to collaborators. + +We have [a plan on the {% data variables.product.prodname_dotcom %} roadmap](https://github.com/github/roadmap/issues/74) to support a flow that allows cross-repository access within {% data variables.product.product_name %}, but this is not yet a supported feature. Currently, the only way to perform privileged cross-repository interactions is to place a {% data variables.product.prodname_dotcom %} authentication token or SSH key as a secret within the workflow environment. Because many authentication token types do not allow for granular access to specific resources, there is significant risk in using the wrong token type, as it can grant much broader access than intended. + +This list describes the recommended approaches for accessing repository data within a workflow, in descending order of preference: + +1. **The `GITHUB_TOKEN` in the workflow environment** + - This token is intentionally scoped to the single repository that invoked the workflow, and has the same level of access as a write-access user on the repository. The token is created before each job begins and expires when the job is finished. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." + - The `GITHUB_TOKEN` should be used whenever possible. +2. **Repository deploy key** + - Deploy keys are one of the only credential types that grant read or write access to a single repository, and can be used to interact with another repository within a workflow. For more information, see "[Managing deploy keys](/developers/overview/managing-deploy-keys#deploy-keys)." + - Note that deploy keys can only clone and push to the repository using Git, and cannot be used to interact with the REST or GraphQL API, so they may not be appropriate for your requirements. +3. **{% data variables.product.prodname_github_app %} tokens** + - {% data variables.product.prodname_github_apps %} can be installed on select repositories, and even have granular permissions on the resources within them. You could create a {% data variables.product.prodname_github_app %} internal to your organization, install it on the repositories you need access to within your workflow, and authenticate as the installation within your workflow to access those repositories. +4. **Personal access tokens** + - You should never use personal access tokens from your own account. These tokens grant access to all repositories within the organizations that you have access to, as well as all personal repositories in your user account. This indirectly grants broad access to all write-access users of the repository the workflow is in. In addition, if you later leave an organization, workflows using this token will immediately break, and debugging this issue can be challenging. + - If a personal access token is used, it should be one that was generated for a new account that is only granted access to the specific repositories that are needed for the workflow. Note that this approach is not scalable and should be avoided in favor of alternatives, such as deploy keys. +5. **SSH keys on a user account** + - Workflows should never use the SSH keys on a user account. Similar to personal access tokens, they grant read/write permissions to all of your personal repositories as well as all the repositories you have access to through organization membership. This indirectly grants broad access to all write-access users of the repository the workflow is in. If you're intending to use an SSH key because you only need to perform repository clones or pushes, and do not need to interact with public APIs, then you should use individual deploy keys instead. + +### Hardening for self-hosted runners + +**{% data variables.product.prodname_dotcom %}-hosted** runners execute code within ephemeral and clean isolated virtual machines, meaning there is no way to persistently compromise this environment, or otherwise gain access to more information than was placed in this environment during the bootstrap process. + +**Self-hosted** runners on {% data variables.product.product_name %} do not have guarantees around running in ephemeral clean virtual machines, and can be persistently compromised by untrusted code in a workflow. + +As a result, self-hosted runners should almost [never be used for public repositories](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories) on {% data variables.product.product_name %}, because any user can open pull requests against the repository and compromise the environment. Similarly, be cautious when using self-hosted runners on private repositories, as anyone who can fork the repository and open a PR (generally those with read-access to the repository) are able to compromise the self-hosted runner environment, including gaining access to secrets and the more privileged `GITHUB_TOKEN` which grants write-access permissions on the repository. + +You should also consider the environment of the self-hosted runner machines: +- What sensitive information resides on the machine configured as a self-hosted runner? For example, private SSH keys, API access tokens, among others. +- Does the machine have network access to sensitive services? For example, Azure or AWS metadata services. The amount of sensitive information in this environment should be kept to a minimum, and you should always be mindful that any user capable of invoking workflows has access to this environment. diff --git a/translations/ko-KR/content/actions/learn-github-actions/sharing-workflows-with-your-organization.md b/translations/ko-KR/content/actions/learn-github-actions/sharing-workflows-with-your-organization.md new file mode 100644 index 000000000000..914ccb136189 --- /dev/null +++ b/translations/ko-KR/content/actions/learn-github-actions/sharing-workflows-with-your-organization.md @@ -0,0 +1,114 @@ +--- +title: Sharing workflows with your organization +shortTitle: Sharing workflows with your organization +intro: 'Learn how you can use organization features to collaborate with your team, by sharing workflow templates, secrets, and self-hosted runners.' +redirect_from: + - /actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### 개요 + +If you need to share workflows and other {% data variables.product.prodname_actions %} features with your team, then consider collaborating within a {% data variables.product.prodname_dotcom %} organization. An organization allows you to centrally store and and manage secrets, artifacts, and self-hosted runners. You can also create workflow templates in the `.github` repository and share them with other users in your organization. + +### Creating a workflow template + +Workflow templates can be created by users with write access to the organization's `.github` repository. The templates can then be used by organization members who have permission to create workflows. Workflow templates can be used to create new workflows in an organizations' public repositories; to use templates to create workflows in private repositories, the organization must be part of an enterprise or GitHub One plan. + +This procedure demonstrates how to create a workflow template and metadata file. The metadata file describes how the template is presented to users when they are creating a new workflow. + +1. If it doesn't already exist, create a new public repository named `.github` in your organization. +1. Create a directory named `workflow-templates`. +1. Create your new workflow file inside the `workflow-templates` directory. + + If you need to refer to a repository's default branch, you can use the `$default-branch` placeholder. When a workflow is created using your template, the placeholder will be automatically replaced with the name of the repository's default branch. + + For example, this file named `octo-organization-ci.yml` demonstrates a basic workflow. + + ```yaml + name: Octo Organization CI + + on: + push: + branches: [ $default-branch ] + pull_request: + branches: [ $default-branch ] + + jobs: + build: + runs-on: ubuntu-latest + + steps: + - uses: actions/checkout@v2 + + - name: Run a one-line script + run: echo Hello from Octo Organization + ``` +1. Create a metadata file inside the `workflow-templates` directory. The metadata file must have the same name as the workflow file, but instead of the `.yml` extension, it must be appended with `.properties.json`. For example, this file named `octo-organization-ci.properties.json` contains the metadata for a workflow file named `octo-organization-ci.yml`: + ```yaml + { + "name": "Octo Organization Workflow", + "description": "Octo Organization CI workflow template.", + "iconName": "example-icon", + "categories": [ + "Go" + ], + "filePatterns": [ + "package.json$", + "^Dockerfile", + ".*\\.md$" + ] + } + ``` + * `name` - **Required.** The name of the workflow template. This is displayed in the list of available templates. + * `description` - **Required.** The description of the workflow template. This is displayed in the list of available templates. + * `iconName` - **Required.** Defines an icon for the workflow's entry in the template list. The `iconName` must be an SVG icon of the same name, and must be stored in the `workflow-templates` directory. For example, a SVG file named `example-icon.svg` is referenced as `example-icon`. + * `categories` - **Optional.** Defines the language category of the workflow. When a user views the available templates, those templates that match the same language will feature more prominently. For information on the available language categories, see https://github.com/github/linguist/blob/master/lib/linguist/languages.yml. + * `filePatterns` - **Optional.** Allows the template to be used if the user's repository has a file in its root directory that matches a defined regular expression. + +To add another workflow template, add your files to the same `workflow-templates` directory. 예시: + +![Workflow template files](/assets/images/help/images/workflow-template-files.png) + +### Using a workflow template + +This procedure demonstrates how a member of your organization can find and use a workflow template to create a new workflow. An organization's workflow templates can be used by anyone who is a member of the organization. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. If your repository already has existing workflows: In the upper-left corner, click **New workflow**. ![Create a new workflow](/assets/images/help/repository/actions-new-workflow.png) +1. Your organization's workflow templates are located in their own section titled "Workflows created by _organization name_". Under the name of the template you'd like to use, click **Set up this workflow**. ![Set up this workflow](/assets/images/help/settings/actions-create-starter-workflow.png) + + +### Sharing secrets within an organization + +You can centrally manage your secrets within an organization, and then make them available to selected repositories. This also means that you can update a secret in one location, and have the change apply to all repository workflows that use the secret. + +When creating a secret in an organization, you can use a policy to limit which repositories can access that secret. For example, you can grant access to all repositories, or limit access to only private repositories or a specified list of repositories. + +{% data reusables.github-actions.permissions-statement-secrets-organization %} + +{% data reusables.organizations.navigate-to-org %} +{% data reusables.organizations.org_settings %} +{% data reusables.github-actions.sidebar-secret %} +1. Click **New secret**. +1. Type a name for your secret in the **Name** input box. +1. Enter the **Value** for your secret. +1. From the **Repository access** dropdown list, choose an access policy. +1. Click **Add secret**. + +### Share self-hosted runners within an organization + +Organization admins can add their self-hosted runners to groups, and then create policies that control which repositories can access the group. + +For more information, see "[Managing access to self-hosted runners using groups](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups)." + + +### 다음 단계 + +To continue learning about {% data variables.product.prodname_actions %}, see "[Security hardening for {% data variables.product.prodname_actions %}](/actions/learn-github-actions/security-hardening-for-github-actions)." diff --git a/translations/ko-KR/content/actions/managing-workflow-runs/adding-a-workflow-status-badge.md b/translations/ko-KR/content/actions/managing-workflow-runs/adding-a-workflow-status-badge.md new file mode 100644 index 000000000000..162499b98ad3 --- /dev/null +++ b/translations/ko-KR/content/actions/managing-workflow-runs/adding-a-workflow-status-badge.md @@ -0,0 +1,63 @@ +--- +title: Adding a workflow status badge +intro: You can display a status badge in your repository to indicate the status of your workflows. +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% data reusables.repositories.actions-workflow-status-badge-into %} + +If your workflow uses the `name` keyword, you must reference the workflow by name. If the name of your workflow contains white space, you'll need to replace the space with the URL encoded string `%20`. For more information about the `name` keyword, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#name)." + +``` +https://github.com///workflows//badge.svg +``` + +Alternatively, if your workflow doesn't have a `name`, you must reference the workflow file using the file path relative to the repository's root directory. + +{% note %} + +**Note:** Referencing the workflow file using the file path does not work if the workflow has a `name`. + +{% endnote %} + +``` +https://github.com///workflows//badge.svg +``` + +### Using a workflow name + +This Markdown example adds a status badge for a workflow with the name "Greet Everyone." The `OWNER` of the repository is the `actions` organization and the `REPOSITORY` name is `hello-world`. + +``` +![example workflow name](https://github.com/actions/hello-world/workflows/Greet%20Everyone/badge.svg) +``` + +### Using a workflow file path + +This Markdown example adds a status badge for a workflow with the file path `.github/workflows/main.yml`. The `OWNER` of the repository is the `actions` organization and the `REPOSITORY` name is `hello-world`. + +``` +![example workflow file path](https://github.com/actions/hello-world/workflows/.github/workflows/main.yml/badge.svg) +``` + +### Using the `branch` parameter + +This Markdown example adds a status badge for a branch with the name `feature-1`. + +``` +![example branch parameter](https://github.com/actions/hello-world/workflows/Greet%20Everyone/badge.svg?branch=feature-1) +``` + +### Using the `event` parameter + +This Markdown example adds a badge that displays the status of workflow runs triggered by the `pull_request` event. + +``` +![example event parameter](https://github.com/actions/hello-world/workflows/Greet%20Everyone/badge.svg?event=pull_request) +``` diff --git a/translations/ko-KR/content/actions/managing-workflow-runs/canceling-a-workflow.md b/translations/ko-KR/content/actions/managing-workflow-runs/canceling-a-workflow.md new file mode 100644 index 000000000000..031f4cb53f4c --- /dev/null +++ b/translations/ko-KR/content/actions/managing-workflow-runs/canceling-a-workflow.md @@ -0,0 +1,31 @@ +--- +title: Canceling a workflow +intro: 'You can cancel a workflow run that is in progress. When you cancel a workflow run, {% data variables.product.prodname_dotcom %} cancels all jobs and steps that are a part of that workflow.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% data reusables.repositories.permissions-statement-write %} + +### Canceling a workflow run + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. In the upper-right corner of the workflow, click **Cancel workflow**. ![Cancel check suite button](/assets/images/help/repository/cancel-check-suite.png) + +### Steps {% data variables.product.prodname_dotcom %} takes to cancel a workflow run + +When canceling workflow run, you may be running other software that uses resources that are related to the workflow run. To help you free up resources related to the workflow run, it may help to understand the steps {% data variables.product.prodname_dotcom %} performs to cancel a workflow run. + +1. To cancel the workflow run, the server re-evaluates `if` conditions for all currently running jobs. If the condition evaluates to `true`, the job will not get canceled. For example, the condition `if: always()` would evaluate to true and the job continues to run. When there is no condition, that is the equivalent of the condition `if: success()`, which only runs if the previous step finished successfully. +2. For jobs that need to be canceled, the server sends a cancellation message to all the runner machines with jobs that need to be canceled. +3. For jobs that continue to run, the server re-evaluates `if` conditions for the unfinished steps. If the condition evaluates to `true`, the step continues to run. +4. For steps that need to be canceled, the runner machine sends `SIGINT/Ctrl-C` to the step's entry process (`node` for javascript action, `docker` for container action, and `bash/cmd/pwd` when using `run` in a step). If the process doesn't exit within 7500 ms, the runner will send `SIGTERM/Ctrl-Break` to the process, then wait for 2500 ms for the process to exit. If the process is still running, the runner kills the process tree. +5. After the 5 minutes cancellation timeout period, the server will force terminate all jobs and steps that don't finish running or fail to complete the cancellation process. diff --git a/translations/ko-KR/content/actions/managing-workflow-runs/deleting-a-workflow-run.md b/translations/ko-KR/content/actions/managing-workflow-runs/deleting-a-workflow-run.md new file mode 100644 index 000000000000..18ebe8c5ccb3 --- /dev/null +++ b/translations/ko-KR/content/actions/managing-workflow-runs/deleting-a-workflow-run.md @@ -0,0 +1,23 @@ +--- +title: Deleting a workflow run +intro: 'You can delete a workflow run that has been completed, or is more than two weeks old.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% data reusables.repositories.permissions-statement-write %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +1. To delete a workflow run, use the {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} drop-down menu, and select **Delete workflow run**. + + ![Deleting a workflow run](/assets/images/help/settings/workflow-delete-run.png) +2. Review the confirmation prompt and click **Yes, permanently delete this workflow run**. + + ![Deleting a workflow run confirmation](/assets/images/help/settings/workflow-delete-run-confirmation.png) diff --git a/translations/ko-KR/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md b/translations/ko-KR/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md new file mode 100644 index 000000000000..a95381aadd6b --- /dev/null +++ b/translations/ko-KR/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md @@ -0,0 +1,45 @@ +--- +title: Disabling and enabling a workflow +intro: You can disable and re-enable a workflow using {% data variables.product.prodname_dotcom %} or the REST API. +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.23' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +Disabling a workflow allows you to stop a workflow from being triggered without having to delete the file from the repo. You can easily re-enable the workflow again on {% data variables.product.prodname_dotcom %}. You can also disable and enable a workflow using the REST API. For more information, see the "[Actions REST API](/rest/reference/actions#workflows)." + +Temporarily disabling a workflow can be useful in many scenarios. These are a few examples where disabling a workflow might be helpful: + +- A workflow error that produces too many or wrong requests, impacting external services negatively. +- A workflow that is not critical and is consuming too many minutes on your account. +- A workflow that sends requests to a service that is down. +- Workflows on a forked repository that aren't needed (for example, scheduled workflows). + +{% warning %} + +**Warning:** {% data reusables.actions.scheduled-workflows-disabled %} + +{% endwarning %} + +### Disabling a workflow + +You can manually disable a workflow so that it won't execute any workflow runs. A disabled workflow is not deleted, and can be re-enabled. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. In the left sidebar, click the workflow you want to disable. ![actions select workflow](/assets/images/actions-select-workflow.png) +1. Click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}. ![actions kebab menu](/assets/images/help/repository/actions-workflow-menu-kebab.png) +1. Click **Disable workflow**. ![actions disable workflow](/assets/images/help/repository/actions-disable-workflow.png) The disabled workflow is marked {% octicon "stop" aria-label="The stop icon" %} to indicate its status. ![actions list disabled workflow](/assets/images/help/repository/actions-find-disabled-workflow.png) + +### Enabling a workflow + +You can re-enable a workflow that was previously disabled. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. In the left sidebar, click the workflow you want to enable. ![actions select disabled workflow](/assets/images/help/repository/actions-select-disabled-workflow.png) +1. Click **Enable workflow**. ![actions enable workflow](/assets/images/help/repository/actions-enable-workflow.png) diff --git a/translations/ko-KR/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md b/translations/ko-KR/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md new file mode 100644 index 000000000000..591f96966661 --- /dev/null +++ b/translations/ko-KR/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md @@ -0,0 +1,22 @@ +--- +title: Downloading workflow artifacts +intro: You can download archived artifacts before they automatically expire. +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} By default, {% data variables.product.product_name %} stores build logs and artifacts for 90 days, and you can customize this retention period, depending on the type of repository. For more information, see "[Configuring the retention period for GitHub Actions artifacts and logs in your repository](/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository)."{% endif %} +{% if currentVersion == "enterprise-server@2.22" %} {% data variables.product.product_name %} stores full build logs and artifacts for 90 days.{% endif %} + +{% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. Under **Artifacts**, click the artifact you want to download. ![Download artifact drop-down menu](/assets/images/help/repository/artifact-drop-down.png) diff --git a/translations/ko-KR/content/actions/managing-workflow-runs/enabling-debug-logging.md b/translations/ko-KR/content/actions/managing-workflow-runs/enabling-debug-logging.md new file mode 100644 index 000000000000..f28a20c8b64e --- /dev/null +++ b/translations/ko-KR/content/actions/managing-workflow-runs/enabling-debug-logging.md @@ -0,0 +1,38 @@ +--- +title: Enabling debug logging +intro: 'If the workflow logs do not provide enough detail to diagnose why a workflow, job, or step is not working as expected, you can enable additional debug logging.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +These extra logs are enabled by setting secrets in the repository containing the workflow, so the same permissions requirements will apply: + +- {% data reusables.github-actions.permissions-statement-secrets-repository %} +- {% data reusables.github-actions.permissions-statement-secrets-organization %} +- {% data reusables.github-actions.permissions-statement-secrets-api %} + +For more information on setting secrets, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)." + +### Enabling runner diagnostic logging + +Runner diagnostic logging provides additional log files that contain information about how a runner is executing a job. Two extra log files are added to the log archive: + +* The runner process log, which includes information about coordinating and setting up runners to execute jobs. +* The worker process log, which logs the execution of a job. + +1. To enable runner diagnostic logging, set the following secret in the repository that contains the workflow: `ACTIONS_RUNNER_DEBUG` to `true`. + +1. To download runner diagnostic logs, download the log archive of the workflow run. The runner diagnostic logs are contained in the `runner-diagnostic-logs` folder. For more information on downloading logs, see "[Downloading logs](/actions/managing-workflow-runs/using-workflow-run-logs/#downloading-logs)." + +### Enabling step debug logging + +Step debug logging increases the verbosity of a job's logs during and after a job's execution. + +1. To enable step debug logging, you must set the following secret in the repository that contains the workflow: `ACTIONS_STEP_DEBUG` to `true`. + +1. After setting the secret, more debug events are shown in the step logs. For more information, see ["Viewing logs to diagnose failures"](/actions/managing-workflow-runs/using-workflow-run-logs/#viewing-logs-to-diagnose-failures). diff --git a/translations/ko-KR/content/actions/managing-workflow-runs/index.md b/translations/ko-KR/content/actions/managing-workflow-runs/index.md new file mode 100644 index 000000000000..5096b761c732 --- /dev/null +++ b/translations/ko-KR/content/actions/managing-workflow-runs/index.md @@ -0,0 +1,32 @@ +--- +title: Managing workflow runs +shortTitle: Managing workflow runs +intro: 'You can view the status and results of each step in your workflow, cancel a pending workflow, view billable job execution minutes, debug and re-run a failed workflow, search and download logs, and download artifacts.' +redirect_from: + - /actions/configuring-and-managing-workflows/managing-a-workflow-run + - /articles/viewing-your-repository-s-workflows + - /articles/viewing-your-repositorys-workflows + - /articles/managing-a-workflow-run + - /github/automating-your-workflow-with-github-actions/managing-a-workflow-run + - /actions/automating-your-workflow-with-github-actions/managing-a-workflow-run + - /actions/configuring-and-managing-workflows/configuring-and-managing-workflow-files-and-runs +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% link_in_list /viewing-workflow-run-history %} +{% link_in_list /using-workflow-run-logs %} +{% link_in_list /manually-running-a-workflow %} +{% link_in_list /re-running-a-workflow %} +{% link_in_list /canceling-a-workflow %} +{% link_in_list /disabling-and-enabling-a-workflow %} +{% link_in_list /deleting-a-workflow-run %} +{% link_in_list /viewing-job-execution-time %} +{% link_in_list /downloading-workflow-artifacts %} +{% link_in_list /removing-workflow-artifacts %} +{% link_in_list /enabling-debug-logging %} +{% link_in_list /adding-a-workflow-status-badge %} diff --git a/translations/ko-KR/content/actions/managing-workflow-runs/manually-running-a-workflow.md b/translations/ko-KR/content/actions/managing-workflow-runs/manually-running-a-workflow.md new file mode 100644 index 000000000000..2288a35e5a8b --- /dev/null +++ b/translations/ko-KR/content/actions/managing-workflow-runs/manually-running-a-workflow.md @@ -0,0 +1,31 @@ +--- +title: Manually running a workflow +intro: 'When a workflow is configured to run on the `workflow_dispatch` event, you can run the workflow using the REST API or from the Actions tab on {% data variables.product.prodname_dotcom %}.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +To run a workflow manually, the workflow must be configured to run on the `workflow_dispatch` event. For more information, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows)." + +### Running a workflow on {% data variables.product.prodname_dotcom %} + +To trigger the `workflow_dispatch` event on {% data variables.product.prodname_dotcom %}, your workflow must be in the default branch. Follow these steps to manually trigger a workflow run. + +{% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. In the left sidebar, click the workflow you want to run. ![actions select workflow](/assets/images/actions-select-workflow.png) +1. Above the list of workflow runs, select **Run workflow**. ![actions workflow dispatch](/assets/images/actions-workflow-dispatch.png) +1. Select the branch where the workflow will run and type the input parameters used by the workflow. Click **Run workflow**. ![actions manually run workflow](/assets/images/actions-manually-run-workflow.png) + +### Running a workflow using the REST API + +When using the REST API, you configure the `inputs` and `ref` as request body parameters. If the inputs are omitted, the default values defined in the workflow file are used. + +For more information about using the REST API, see the "[Create a workflow dispatch event](/rest/reference/actions/#create-a-workflow-dispatch-event)." diff --git a/translations/ko-KR/content/actions/managing-workflow-runs/re-running-a-workflow.md b/translations/ko-KR/content/actions/managing-workflow-runs/re-running-a-workflow.md new file mode 100644 index 000000000000..14b5d9226820 --- /dev/null +++ b/translations/ko-KR/content/actions/managing-workflow-runs/re-running-a-workflow.md @@ -0,0 +1,19 @@ +--- +title: Re-running a workflow +intro: You can re-run an instance of a workflow. Re-running a workflow uses the same `GITHUB_SHA` (commit SHA) and `GITHUB_REF` (Git ref) of the original event that triggered the workflow run. +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. In the upper-right corner of the workflow, use the **Re-run jobs** drop-down menu, and select **Re-run all jobs**. ![Re-run checks drop-down menu](/assets/images/help/repository/rerun-checks-drop-down.png) diff --git a/translations/ko-KR/content/actions/managing-workflow-runs/removing-workflow-artifacts.md b/translations/ko-KR/content/actions/managing-workflow-runs/removing-workflow-artifacts.md new file mode 100644 index 000000000000..df297ba2b660 --- /dev/null +++ b/translations/ko-KR/content/actions/managing-workflow-runs/removing-workflow-artifacts.md @@ -0,0 +1,41 @@ +--- +title: Removing workflow artifacts +intro: 'You can reclaim used {% data variables.product.prodname_actions %} storage by deleting artifacts before they expire on {% data variables.product.product_name %}.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Deleting an artifact + +{% warning %} + +**Warning:** Once you delete an artifact, it can not be restored. + +{% endwarning %} + +{% data reusables.repositories.permissions-statement-write %} + +{% data reusables.github-actions.artifact-log-retention-statement %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. Under **Artifacts**, click {% octicon "trashcan" aria-label="The trashcan icon" %} next to the artifact you want to remove. ![Delete artifact drop-down menu](/assets/images/help/repository/actions-delete-artifact.png) + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +### Setting the retention period for an artifact + +Retention periods for artifacts and logs can be configured at the repository, organization, and enterprise level. For more information, see "[Usage limits, billing, and administration](/actions/reference/usage-limits-billing-and-administration#artifact-and-log-retention-policy)." + +You can also define a custom retention period for individual artifacts using the `actions/upload-artifact` action in a workflow. For more information, see "[Storing workflow data as artifacts](/actions/guides/storing-workflow-data-as-artifacts#configuring-a-custom-artifact-retention-period)." + +### Finding the expiration date of an artifact + +You can use the API to confirm the date that an artifact is scheduled to be deleted. For more information, see the `expires_at` value returned by "[List artifacts for a repository](/rest/reference/actions#artifacts)." +{% endif %} \ No newline at end of file diff --git a/translations/ko-KR/content/actions/managing-workflow-runs/using-workflow-run-logs.md b/translations/ko-KR/content/actions/managing-workflow-runs/using-workflow-run-logs.md new file mode 100644 index 000000000000..7ba456e0038e --- /dev/null +++ b/translations/ko-KR/content/actions/managing-workflow-runs/using-workflow-run-logs.md @@ -0,0 +1,86 @@ +--- +title: Using workflow run logs +intro: 'You can view, search, and download the logs for each job in a workflow run.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +You can see whether a workflow run is in progress or complete from the workflow run page. You must be logged in to a {% data variables.product.prodname_dotcom %} account to view workflow run information, including for public repositories. For more information, see "[Access permissions on GitHub](/articles/access-permissions-on-github)." + +If the run is complete, you can see whether the result was a success, failure, canceled, or neutral. If the run failed, you can view and search the build logs to diagnose the failure and re-run the workflow. You can also view billable job execution minutes, or download logs and build artifacts. + +{% data variables.product.prodname_actions %} use the Checks API to output statuses, results, and logs for a workflow. {% data variables.product.prodname_dotcom %} creates a new check suite for each workflow run. The check suite contains a check run for each job in the workflow, and each job includes steps. {% data variables.product.prodname_actions %} are run as a step in a workflow. For more information about the Checks API, see "[Checks](/v3/checks/)." + +{% data reusables.github-actions.invalid-workflow-files %} + +### Viewing logs to diagnose failures + +If your workflow run fails, you can see which step caused the failure and review the failed step's build logs to troubleshoot. You can see the time it took for each step to run. You can also copy a permalink to a specific line in the log file to share with your team. {% data reusables.repositories.permissions-statement-read %} + +In addition to the steps configured in the workflow file, {% data variables.product.prodname_dotcom %} adds two additional steps to each job to set up and complete the job's execution. These steps are logged in the workflow run with the names "Set up job" and "Complete job". + +For jobs run on {% data variables.product.prodname_dotcom %}-hosted runners, "Set up job" records details of the runner's virtual environment, and includes a link to the list of preinstalled tools that were present on the runner machine. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +{% data reusables.repositories.navigate-to-job-superlinter %} +{% data reusables.repositories.view-failed-job-results-superlinter %} +{% data reusables.repositories.view-specific-line-superlinter %} + +### Searching logs + +You can search the build logs for a particular step. When you search logs, only expanded steps are included in the results. {% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +{% data reusables.repositories.navigate-to-job-superlinter %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +1. In the upper-right corner of the log output, in the **Search logs** search box, type a search query. ![Search box to search logs](/assets/images/help/repository/search-log-box-updated.png) +{% else %} +1. To expand each step you want to include in your search, click the step. ![Step name](/assets/images/help/repository/failed-check-step.png) +1. In the upper-right corner of the log output, in the **Search logs** search box, type a search query. ![Search box to search logs](/assets/images/help/repository/search-log-box.png) +{% endif %} + +### Downloading logs + +You can download the log files from your workflow run. You can also download a workflow's artifacts. For more information, see "[Persisting workflow data using artifacts](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)." {% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +{% data reusables.repositories.navigate-to-job-superlinter %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +1. In the upper right corner, click +{% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} and select **Download log archive**. + ![Download logs drop-down menu](/assets/images/help/repository/download-logs-drop-down-updated.png) +{% else %} +1. In the upper right corner, click +{% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} and select **Download log archive**. + ![Download logs drop-down menu](/assets/images/help/repository/download-logs-drop-down.png) +{% endif %} + +### Deleting logs + +You can delete the log files from your workflow run. {% data reusables.repositories.permissions-statement-write %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +1. In the upper right corner, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}. ![Kebab-horizontal icon](/assets/images/help/repository/workflow-run-kebab-horizontal-icon-updated.png) +2. To delete the log files, click the **Delete all logs** button and review the confirmation prompt. ![Delete all logs](/assets/images/help/repository/delete-all-logs-updated.png) After deleting logs, the **Delete all logs** button is removed to indicate that no log files remain in the workflow run. +{% else %} +1. In the upper right corner, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}. ![Kebab-horizontal icon](/assets/images/help/repository/workflow-run-kebab-horizontal-icon.png) +2. To delete the log files, click the **Delete all logs** button and review the confirmation prompt. ![Delete all logs](/assets/images/help/repository/delete-all-logs.png) After the logs have been deleted, the **Delete all logs** button is removed to indicate that no log files remain in the workflow run. +{% endif %} diff --git a/translations/ko-KR/content/actions/managing-workflow-runs/viewing-job-execution-time.md b/translations/ko-KR/content/actions/managing-workflow-runs/viewing-job-execution-time.md new file mode 100644 index 000000000000..709a7343a97a --- /dev/null +++ b/translations/ko-KR/content/actions/managing-workflow-runs/viewing-job-execution-time.md @@ -0,0 +1,24 @@ +--- +title: Viewing job execution time +intro: 'You can view the execution time of a job, including the billable minutes that a job accrued.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +Billable job execution minutes are only shown for jobs run on private repositories that use {% data variables.product.prodname_dotcom %}-hosted runners. There are no billable minutes when using {% data variables.product.prodname_actions %} in public repositories or for jobs run on self-hosted runners. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. Under the job summary, you can view the job's execution time. To view the billable job execution time, click **Run and billable time details**. ![Run and billable time details link](/assets/images/help/repository/view-run-billable-time.png) + + {% note %} + + **Note:** The billable time shown does not include any rounding or minute multipliers. To view your total {% data variables.product.prodname_actions %} usage, including rounding and minute multipliers, see "[Viewing your {% data variables.product.prodname_actions %} usage](/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage)." + + {% endnote %} diff --git a/translations/ko-KR/content/actions/managing-workflow-runs/viewing-workflow-run-history.md b/translations/ko-KR/content/actions/managing-workflow-runs/viewing-workflow-run-history.md new file mode 100644 index 000000000000..47ca04068ef3 --- /dev/null +++ b/translations/ko-KR/content/actions/managing-workflow-runs/viewing-workflow-run-history.md @@ -0,0 +1,18 @@ +--- +title: Viewing workflow run history +intro: You can view logs for each run of a workflow. Logs include the status for each job and step in a workflow. +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} diff --git a/translations/ko-KR/content/actions/quickstart.md b/translations/ko-KR/content/actions/quickstart.md index 1d757c49efb5..474258c04966 100644 --- a/translations/ko-KR/content/actions/quickstart.md +++ b/translations/ko-KR/content/actions/quickstart.md @@ -55,11 +55,12 @@ Committing the workflow file in your repository triggers the `push` event and ru ### Viewing your workflow results +{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.actions-tab %} -1. In the left sidebar, click the workflow you want to see. ![Workflow list in left sidebar](/assets/images/help/repository/superlinter-workflow-sidebar.png) -1. From the list of workflow runs, click the name of the run you want to see. ![Name of workflow run](/assets/images/help/repository/superlinter-run-name.png) +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} 1. In the left sidebar, click the **Lint code base** job. ![Lint code base job](/assets/images/help/repository/superlinter-lint-code-base-job.png) -2. Expand the **Run Super-Linter** step to view the results. ![Super linter workflow results](/assets/images/help/repository/super-linter-workflow-results.png) +{% data reusables.repositories.view-failed-job-results-superlinter %} ### More starter workflows diff --git a/translations/ko-KR/content/actions/reference/authentication-in-a-workflow.md b/translations/ko-KR/content/actions/reference/authentication-in-a-workflow.md new file mode 100644 index 000000000000..73fd38f3bee0 --- /dev/null +++ b/translations/ko-KR/content/actions/reference/authentication-in-a-workflow.md @@ -0,0 +1,100 @@ +--- +title: Authentication in a workflow +intro: '{% data variables.product.prodname_dotcom %} provides a token that you can use to authenticate on behalf of {% data variables.product.prodname_actions %}.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /github/automating-your-workflow-with-github-actions/authenticating-with-the-github_token + - /actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token + - /actions/configuring-and-managing-workflows/authenticating-with-the-github_token +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +Anyone with `write` access to a repository can create, read, and use secrets. + +### About the `GITHUB_TOKEN` secret + +{% data variables.product.prodname_dotcom %} automatically creates a `GITHUB_TOKEN` secret to use in your workflow. You can use the `GITHUB_TOKEN` to authenticate in a workflow run. + +When you enable {% data variables.product.prodname_actions %}, {% data variables.product.prodname_dotcom %} installs a {% data variables.product.prodname_github_app %} on your repository. The `GITHUB_TOKEN` secret is a {% data variables.product.prodname_github_app %} installation access token. You can use the installation access token to authenticate on behalf of the {% data variables.product.prodname_github_app %} installed on your repository. The token's permissions are limited to the repository that contains your workflow. For more information, see "[Permissions for the `GITHUB_TOKEN`](#permissions-for-the-github_token)." + +Before each job begins, {% data variables.product.prodname_dotcom %} fetches an installation access token for the job. The token expires when the job is finished. + +The token is also available in the `github.token` context. For more information, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)." + +### Using the `GITHUB_TOKEN` in a workflow + +To use the `GITHUB_TOKEN` secret, you must reference it in your workflow file. Using a token might include passing the token as an input to an action that requires it, or making authenticated {% data variables.product.prodname_dotcom %} API calls. + +{% data reusables.github-actions.actions-do-not-trigger-workflows %} + +#### Example passing `GITHUB_TOKEN` as an input + +This example workflow uses the [labeler action](https://github.com/actions/labeler), which requires the `GITHUB_TOKEN` as the value for the `repo-token` input parameter: + + {% raw %} + ```yaml + name: Pull request labeler + on: + - pull_request + jobs: + triage: + runs-on: ubuntu-latest + steps: + - uses: actions/labeler@v2 + with: + repo-token: ${{ secrets.GITHUB_TOKEN }} + ``` + {% endraw %} + +#### Example calling the REST API + +You can use the `GITHUB_TOKEN` to make authenticated API calls. This example workflow creates an issue using the {% data variables.product.prodname_dotcom %} REST API: + + {% raw %} + ```yaml + name: Create issue on commit + on: + - push + jobs: + create_commit: + runs-on: ubuntu-latest + steps: + - name: Create issue using REST API + run: | + curl --request POST \ + --url https://api.github.com/repos/${{ github.repository }}/issues \ + --header 'authorization: Bearer ${{ secrets.GITHUB_TOKEN }}' \ + --header 'content-type: application/json' \ + --data '{ + "title": "Automated issue for commit: ${{ github.sha }}", + "body": "This issue was automatically created by the GitHub Action workflow **${{ github.workflow }}**. \n\n The commit hash was: _${{ github.sha }}_." + }' + ``` + {% endraw %} + +### Permissions for the `GITHUB_TOKEN` + +For information about the API endpoints {% data variables.product.prodname_github_apps %} can access with each permission, see "[{% data variables.product.prodname_github_app %} Permissions](/v3/apps/permissions/)." + +| Permission | Access type | Access by forked repos | +| ------------------- | ----------- | ---------------------- | +| actions | read/write | read | +| checks | read/write | read | +| contents | read/write | read | +| deployments | read/write | read | +| issues | read/write | read | +| 메타데이터 | read | read | +| 패키지 | read/write | read | +| pull requests | read/write | read | +| repository projects | read/write | read | +| statuses | read/write | read | + +If you need a token that requires permissions that aren't available in the `GITHUB_TOKEN`, you can create a personal access token and set it as a secret in your repository: + +1. Use or create a token with the appropriate permissions for that repository. For more information, see "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token)." +1. Add the token as a secret in your workflow's repository, and refer to it using the {%raw%}`${{ secrets.SECRET_NAME }}`{% endraw %} syntax. For more information, see "[Creating and using encrypted secrets](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)." diff --git a/translations/ko-KR/content/actions/reference/context-and-expression-syntax-for-github-actions.md b/translations/ko-KR/content/actions/reference/context-and-expression-syntax-for-github-actions.md index bb2991de1bba..d29bd96190e7 100644 --- a/translations/ko-KR/content/actions/reference/context-and-expression-syntax-for-github-actions.md +++ b/translations/ko-KR/content/actions/reference/context-and-expression-syntax-for-github-actions.md @@ -81,27 +81,27 @@ The `github` context contains information about the workflow run and the event t {% data reusables.github-actions.github-context-warning %} -| Property name | 유형 | 설명 | -| ------------------------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `github` | `개체` | The top-level context available during any job or step in a workflow. | -| `github.event` | `개체` | The full event webhook payload. For more information, see "[Events that trigger workflows](/articles/events-that-trigger-workflows/)." You can access individual properties of the event using this context. | -| `github.event_path` | `문자열` | The path to the full event webhook payload on the runner. | -| `github.workflow` | `문자열` | The name of the workflow. If the workflow file doesn't specify a `name`, the value of this property is the full path of the workflow file in the repository. | -| `github.job` | `문자열` | The [`job_id`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_id) of the current job. | -| `github.run_id` | `문자열` | {% data reusables.github-actions.run_id_description %} | -| `github.run_number` | `문자열` | {% data reusables.github-actions.run_number_description %} | -| `github.actor` | `문자열` | The login of the user that initiated the workflow run. | -| `github.repository` | `문자열` | The owner and repository name. For example, `Codertocat/Hello-World`. | -| `github.repository_owner` | `문자열` | The repository owner's name. For example, `Codertocat`. | -| `github.event_name` | `문자열` | The name of the event that triggered the workflow run. | -| `github.sha` | `문자열` | The commit SHA that triggered the workflow run. | -| `github.ref` | `문자열` | The branch or tag ref that triggered the workflow run. | -| `github.head_ref` | `문자열` | The `head_ref` or source branch of the pull request in a workflow run. This property is only available when the event that triggers a workflow run is a `pull_request`. | -| `github.base_ref` | `문자열` | The `base_ref` or target branch of the pull request in a workflow run. This property is only available when the event that triggers a workflow run is a `pull_request`. | -| `github.token` | `문자열` | A token to authenticate on behalf of the GitHub App installed on your repository. This is functionally equivalent to the `GITHUB_TOKEN` secret. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)." | -| `github.workspace` | `문자열` | The default working directory for steps and the default location of your repository when using the [`checkout`](https://github.com/actions/checkout) action. | +| Property name | 유형 | 설명 | +| ------------------------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `github` | `개체` | The top-level context available during any job or step in a workflow. | | `github.action` | `문자열` | The name of the action currently running. {% data variables.product.prodname_dotcom %} removes special characters or uses the name `run` when the current step runs a script. If you use the same action more than once in the same job, the name will include a suffix with the sequence number. For example, the first script you run will have the name `run1`, and the second script will be named `run2`. Similarly, the second invocation of `actions/checkout` will be `actionscheckout2`. | -| `github.action_path` | `문자열` | The path where your action is located. You can use this path to easily access files located in the same repository as your action. This attribute is only supported in composite run steps actions. | +| `github.action_path` | `문자열` | The path where your action is located. You can use this path to easily access files located in the same repository as your action. This attribute is only supported in composite run steps actions. | +| `github.actor` | `문자열` | The login of the user that initiated the workflow run. | +| `github.base_ref` | `문자열` | The `base_ref` or target branch of the pull request in a workflow run. This property is only available when the event that triggers a workflow run is a `pull_request`. | +| `github.event` | `개체` | The full event webhook payload. For more information, see "[Events that trigger workflows](/articles/events-that-trigger-workflows/)." You can access individual properties of the event using this context. | +| `github.event_name` | `문자열` | The name of the event that triggered the workflow run. | +| `github.event_path` | `문자열` | The path to the full event webhook payload on the runner. | +| `github.head_ref` | `문자열` | The `head_ref` or source branch of the pull request in a workflow run. This property is only available when the event that triggers a workflow run is a `pull_request`. | +| `github.job` | `문자열` | The [`job_id`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_id) of the current job. | +| `github.ref` | `문자열` | The branch or tag ref that triggered the workflow run. | +| `github.repository` | `문자열` | The owner and repository name. For example, `Codertocat/Hello-World`. | +| `github.repository_owner` | `문자열` | The repository owner's name. For example, `Codertocat`. | +| `github.run_id` | `문자열` | {% data reusables.github-actions.run_id_description %} +| `github.run_number` | `문자열` | {% data reusables.github-actions.run_number_description %} +| `github.sha` | `문자열` | The commit SHA that triggered the workflow run. | +| `github.token` | `문자열` | A token to authenticate on behalf of the GitHub App installed on your repository. This is functionally equivalent to the `GITHUB_TOKEN` secret. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)." | +| `github.workflow` | `문자열` | The name of the workflow. If the workflow file doesn't specify a `name`, the value of this property is the full path of the workflow file in the repository. | +| `github.workspace` | `문자열` | The default working directory for steps and the default location of your repository when using the [`checkout`](https://github.com/actions/checkout) action. | #### **`env` context** @@ -121,17 +121,17 @@ You can only use the `env` context in the value of the `with` and `name` keys, o The `job` context contains information about the currently running job. -| Property name | 유형 | 설명 | -| ----------------------------------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `작업` | `개체` | This context changes for each job in a workflow run. You can access this context from any step in a job. | -| `job.status` | `문자열` | The current status of the job. Possible values are `success`, `failure`, or `cancelled`. | +| Property name | 유형 | 설명 | +| ----------------------------------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `작업` | `개체` | This context changes for each job in a workflow run. You can access this context from any step in a job. | | `job.container` | `개체` | Information about the job's container. For more information about containers, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idcontainer)." | -| `job.container.network` | `문자열` | The id of the container network. The runner creates the network used by all containers in a job. | -| `job.container.id` | `문자열` | The id of the container. | +| `job.container.id` | `문자열` | The id of the container. | +| `job.container.network` | `문자열` | The id of the container network. The runner creates the network used by all containers in a job. | | `job.services` | `개체` | The service containers created for a job. For more information about service containers, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idservices)." | -| `job.services..id` | `문자열` | The id of the service container. | -| `job.services..ports` | `개체` | The exposed ports of the service container. | -| `job.services..network` | `문자열` | The id of the service container network. The runner creates the network used by all containers in a job. | +| `job.services..id` | `문자열` | The id of the service container. | +| `job.services..network` | `문자열` | The id of the service container network. The runner creates the network used by all containers in a job. | +| `job.services..ports` | `개체` | The exposed ports of the service container. | +| `job.status` | `문자열` | The current status of the job. Possible values are `success`, `failure`, or `cancelled`. | #### **`steps` context** @@ -140,31 +140,31 @@ The `steps` context contains information about the steps in the current job that | Property name | 유형 | 설명 | | --------------------------------------------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `steps` | `개체` | This context changes for each step in a job. You can access this context from any step in a job. | -| `steps..outputs` | `개체` | The set of outputs defined for the step. For more information, see "[Metadata syntax for {% data variables.product.prodname_actions %}](/articles/metadata-syntax-for-github-actions#outputs)." | -| `steps..outputs.` | `문자열` | The value of a specific output. | -| `steps..outcome` | `문자열` | The result of a completed step before [`continue-on-error`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepscontinue-on-error) is applied. Possible values are `success`, `failure`, `cancelled`, or `skipped`. When a `continue-on-error` step fails, the `outcome` is `failure`, but the final `conclusion` is `success`. | +| `steps..outputs` | `개체` | The set of outputs defined for the step. For more information, see "[Metadata syntax for {% data variables.product.prodname_actions %}](/articles/metadata-syntax-for-github-actions#outputs)." | | `steps..conclusion` | `문자열` | The result of a completed step after [`continue-on-error`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepscontinue-on-error) is applied. Possible values are `success`, `failure`, `cancelled`, or `skipped`. When a `continue-on-error` step fails, the `outcome` is `failure`, but the final `conclusion` is `success`. | +| `steps..outcome` | `문자열` | The result of a completed step before [`continue-on-error`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepscontinue-on-error) is applied. Possible values are `success`, `failure`, `cancelled`, or `skipped`. When a `continue-on-error` step fails, the `outcome` is `failure`, but the final `conclusion` is `success`. | +| `steps..outputs.` | `문자열` | The value of a specific output. | #### **`runner` context** The `runner` context contains information about the runner that is executing the current job. -| Property name | 유형 | 설명 | -| ------------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `runner.os` | `문자열` | The operating system of the runner executing the job. Possible values are `Linux`, `Windows`, or `macOS`. | -| `runner.temp` | `문자열` | The path of the temporary directory for the runner. This directory is guaranteed to be empty at the start of each job, even on self-hosted runners. | -| `runner.tool_cache` | `문자열` | The path of the directory containing some of the preinstalled tools for {% data variables.product.prodname_dotcom %}-hosted runners. For more information, see "[Software installed on GitHub-hosted runners](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)." | +| Property name | 유형 | 설명 | +| ------------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `runner.os` | `문자열` | The operating system of the runner executing the job. Possible values are `Linux`, `Windows`, or `macOS`. | +| `runner.temp` | `문자열` | The path of the temporary directory for the runner. This directory is guaranteed to be empty at the start of each job, even on self-hosted runners. | +| `runner.tool_cache` | `문자열` | The path of the directory containing some of the preinstalled tools for {% data variables.product.prodname_dotcom %}-hosted runners. For more information, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". | #### **`needs` context** The `needs` context contains outputs from all jobs that are defined as a dependency of the current job. For more information on defining job dependencies, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)." -| Property name | 유형 | 설명 | -| -------------------------------------------------- | ----- | -------------------------------------------------------------------------------------------------------------- | -| `needs.` | `개체` | A single job that the current job depends on. | -| `needs..result` | `문자열` | The result of a job that the current job depends on. Possible values are `success`, `failure`, or `cancelled`. | -| `needs..outputs` | `개체` | The set of outputs of a job that the current job depends on. | -| `needs..outputs.` | `문자열` | The value of a specific output for a job that the current job depends on. | +| Property name | 유형 | 설명 | +| -------------------------------------------------- | ----- | ------------------------------------------------------------------------------------------------------------------------- | +| `needs.` | `개체` | A single job that the current job depends on. | +| `needs..outputs` | `개체` | The set of outputs of a job that the current job depends on. | +| `needs..outputs.` | `문자열` | The value of a specific output for a job that the current job depends on. | +| `needs..result` | `문자열` | The result of a job that the current job depends on. Possible values are `success`, `failure`, `cancelled`, or `skipped`. | #### Example printing context information to the log file @@ -179,7 +179,7 @@ on: push jobs: one: - runs-on: ubuntu-16.04 + runs-on: ubuntu-latest steps: - name: Dump GitHub context env: diff --git a/translations/ko-KR/content/actions/reference/encrypted-secrets.md b/translations/ko-KR/content/actions/reference/encrypted-secrets.md new file mode 100644 index 000000000000..ece5229726d0 --- /dev/null +++ b/translations/ko-KR/content/actions/reference/encrypted-secrets.md @@ -0,0 +1,221 @@ +--- +title: Encrypted secrets +intro: Encrypted secrets allow you to store sensitive information in your repository or organization. +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets + - /actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets + - /actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### About encrypted secrets + +Secrets are encrypted environment variables that you create in a repository or organization. The secrets you create are available to use in {% data variables.product.prodname_actions %} workflows. {% data variables.product.prodname_dotcom %} uses a [libsodium sealed box](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes) to help ensure that secrets are encrypted before they reach {% data variables.product.prodname_dotcom %}, and remain encrypted until you use them in a workflow. + +{% data reusables.github-actions.secrets-org-level-overview %} + +#### Naming your secrets + +The following rules apply to secret names: + +* Secret names can only contain alphanumeric characters (`[a-z]`, `[A-Z]`, `[0-9]`) or underscores (`_`). Spaces are not allowed. +* Secret names must not start with the `GITHUB_` prefix. +* Secret names must not start with a number. +* Secret names must be unique at the level they are created at. For example, a secret created at the organization-level must have a unique name at that level, and a secret created at the repository-level must have a unique name in that repository. If an organization-level secret has the same name as a repository-level secret, then the repository-level secret takes precedence. + +To help ensure that {% data variables.product.prodname_dotcom %} redacts your secret in logs, avoid using structured data as the values of secrets. For example, avoid creating secrets that contain JSON or encoded Git blobs. + +#### Accessing your secrets + +To make a secret available to an action, you must set the secret as an input or environment variable in the workflow file. Review the action's README file to learn about which inputs and environment variables the action expects. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)." + +You can use and read encrypted secrets in a workflow file if you have access to edit the file. For more information, see "[Access permissions on {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/access-permissions-on-github)." + +{% warning %} + +**Warning:** {% data variables.product.prodname_dotcom %} automatically redacts secrets printed to the log, but you should avoid printing secrets to the log intentionally. + +{% endwarning %} + +You can also manage secrets using the REST API. For more information, see "[Secrets](/v3/actions/secrets/)." + +#### Limiting credential permissions + +When generating credentials, we recommend that you grant the minimum permissions possible. For example, instead of using personal credentials, use [deploy keys](/v3/guides/managing-deploy-keys/#deploy-keys) or a service account. Consider granting read-only permissions if that's all that is needed, and limit access as much as possible. When generating a personal access token (PAT), select the fewest scopes necessary. + +### Creating encrypted secrets for a repository + +{% data reusables.github-actions.permissions-statement-secrets-repository %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.github-actions.sidebar-secret %} +1. Click **Add a new secret**. +1. Type a name for your secret in the **Name** input box. +1. Enter the value for your secret. +1. Click **Add secret**. + +If your repository can access secrets from the parent organization, then those secrets are also listed on this page. + +### Creating encrypted secrets for an organization + +When creating a secret in an organization, you can use a policy to limit which repositories can access that secret. For example, you can grant access to all repositories, or limit access to only private repositories or a specified list of repositories. + +{% data reusables.github-actions.permissions-statement-secrets-organization %} + +{% data reusables.organizations.navigate-to-org %} +{% data reusables.organizations.org_settings %} +{% data reusables.github-actions.sidebar-secret %} +1. Click **New secret**. +1. Type a name for your secret in the **Name** input box. +1. Enter the **Value** for your secret. +1. From the **Repository access** dropdown list, choose an access policy. +1. Click **Add secret**. + +### Reviewing access to organization-level secrets + +You can check which access policies are being applied to a secret in your organization. + +{% data reusables.organizations.navigate-to-org %} +{% data reusables.organizations.org_settings %} +{% data reusables.github-actions.sidebar-secret %} +1. The list of secrets includes any configured permissions and policies. 예시: ![Secrets list](/assets/images/help/settings/actions-org-secrets-list.png) +1. For more details on the configured permissions for each secret, click **Update**. + +### Using encrypted secrets in a workflow + +With the exception of `GITHUB_TOKEN`, secrets are not passed to the runner when a workflow is triggered from a forked repository. + +To provide an action with a secret as an input or environment variable, you can use the `secrets` context to access secrets you've created in your repository. For more information, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)" and "[Workflow syntax for {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)." + +{% raw %} +```yaml +steps: + - name: Hello world action + with: # Set the secret as an input + super_secret: ${{ secrets.SuperSecret }} + env: # Or as an environment variable + super_secret: ${{ secrets.SuperSecret }} +``` +{% endraw %} + +Avoid passing secrets between processes from the command line, whenever possible. Command-line processes may be visible to other users (using the `ps` command) or captured by [security audit events](https://docs.microsoft.com/en-us/windows-server/identity/ad-ds/manage/component-updates/command-line-process-auditing). To help protect secrets, consider using environment variables, `STDIN`, or other mechanisms supported by the target process. + +If you must pass secrets within a command line, then enclose them within the proper quoting rules. Secrets often contain special characters that may unintentionally affect your shell. To escape these special characters, use quoting with your environment variables. 예시: + +#### Example using Bash + +{% raw %} +```yaml +steps: + - shell: bash + env: + SUPER_SECRET: ${{ secrets.SuperSecret }} + run: | + example-command "$SUPER_SECRET" +``` +{% endraw %} + +#### Example using PowerShell + +{% raw %} +```yaml +steps: + - shell: pwsh + env: + SUPER_SECRET: ${{ secrets.SuperSecret }} + run: | + example-command "$env:SUPER_SECRET" +``` +{% endraw %} + +#### Example using Cmd.exe + +{% raw %} +```yaml +steps: + - shell: cmd + env: + SUPER_SECRET: ${{ secrets.SuperSecret }} + run: | + example-command "%SUPER_SECRET%" +``` +{% endraw %} + +### Limits for secrets + +Your workflow can have up to 100 secrets. The names of secret environment variables must be unique in a repository. + +Secrets are limited to 64 KB in size. To use secrets that are larger than 64 KB, you can store encrypted secrets in your repository and save the decryption passphrase as a secret on {% data variables.product.prodname_dotcom %}. For example, you can use `gpg` to encrypt your credentials locally before checking the file in to your repository on {% data variables.product.prodname_dotcom %}. For more information, see the "[gpg manpage](https://www.gnupg.org/gph/de/manual/r1023.html)." + +{% warning %} + +**Warning**: Be careful that your secrets do not get printed when your action runs. When using this workaround, {% data variables.product.prodname_dotcom %} does not redact secrets that are printed in logs. + +{% endwarning %} + +1. Run the following command from your terminal to encrypt the `my_secret.json` file using `gpg` and the AES256 cipher algorithm. + + ``` shell + $ gpg --symmetric --cipher-algo AES256 my_secret.json + ``` + +1. You will be prompted to enter a passphrase. Remember the passphrase, because you'll need to create a new secret on {% data variables.product.prodname_dotcom %} that uses the passphrase as the value. + +1. Create a new secret that contains the passphrase. For example, create a new secret with the name `LARGE_SECRET_PASSPHRASE` and set the value of the secret to the passphrase you selected in the step above. + +1. Copy your encrypted file into your repository and commit it. In this example, the encrypted file is `my_secret.json.gpg`. + +1. Create a shell script to decrypt the password. Save this file as `decrypt_secret.sh`. + + ``` shell + #!/bin/sh + + # Decrypt the file + mkdir $HOME/secrets + # --batch to prevent interactive command + # --yes to assume "yes" for questions + gpg --quiet --batch --yes --decrypt --passphrase="$LARGE_SECRET_PASSPHRASE" \ + --output $HOME/secrets/my_secret.json my_secret.json.gpg + ``` + +1. Ensure your shell script is executable before checking it in to your repository. + + ``` shell + $ chmod +x decrypt_secret.sh + $ git add decrypt_secret.sh + $ git commit -m "Add new decryption script" + $ git push + ``` + +1. From your workflow, use a `step` to call the shell script and decrypt the secret. To have a copy of your repository in the environment that your workflow runs in, you'll need to use the [`actions/checkout`](https://github.com/actions/checkout) action. Reference your shell script using the `run` command relative to the root of your repository. + +{% raw %} + ```yaml + name: Workflows with large secrets + + on: push + + jobs: + my-job: + name: My Job + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Decrypt large secret + run: ./.github/scripts/decrypt_secret.sh + env: + LARGE_SECRET_PASSPHRASE: ${{ secrets.LARGE_SECRET_PASSPHRASE }} + # This command is just an example to show your secret being printed + # Ensure you remove any print statements of your secrets. GitHub does + # not hide secrets that use this workaround. + - name: Test printing your secret (Remove this step in production) + run: cat $HOME/secrets/my_secret.json + ``` +{% endraw %} diff --git a/translations/ko-KR/content/actions/reference/environment-variables.md b/translations/ko-KR/content/actions/reference/environment-variables.md new file mode 100644 index 000000000000..a44beb635507 --- /dev/null +++ b/translations/ko-KR/content/actions/reference/environment-variables.md @@ -0,0 +1,69 @@ +--- +title: 환경 변수 +intro: '{% data variables.product.prodname_dotcom %} sets default environment variables for each {% data variables.product.prodname_actions %} workflow run. You can also set custom environment variables in your workflow file.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /github/automating-your-workflow-with-github-actions/using-environment-variables + - /actions/automating-your-workflow-with-github-actions/using-environment-variables + - /actions/configuring-and-managing-workflows/using-environment-variables +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### About environment variables + +{% data variables.product.prodname_dotcom %} sets default environment variables that are available to every step in a workflow run. Environment variables are case-sensitive. Commands run in actions or steps can create, read, and modify environment variables. + +To set custom environment variables, you need to specify the variables in the workflow file. You can define environment variables for a step, job, or entire workflow using the [`jobs..steps.env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv), [`jobs..env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idenv), and [`env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env) keywords. For more information, see "[Workflow syntax for {% data variables.product.prodname_dotcom %}](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)." + +```yaml +steps: + - name: Hello world + run: echo Hello world $FIRST_NAME $middle_name $Last_Name! + env: + FIRST_NAME: Mona + middle_name: The + Last_Name: Octocat +``` + +You can also use the {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}`GITHUB_ENV` environment file{% else %} `set-env` workflow command{% endif %} to set an environment variable that the following steps in a workflow can use. The {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}environment file{% else %} `set-env` command{% endif %} can be used directly by an action or as a shell command in a workflow file using the `run` keyword. For more information, see "[Workflow commands for {% data variables.product.prodname_actions %}](/actions/reference/workflow-commands-for-github-actions/#setting-an-environment-variable)." + +### Default environment variables + +We strongly recommend that actions use environment variables to access the filesystem rather than using hardcoded file paths. {% data variables.product.prodname_dotcom %} sets environment variables for actions to use in all runner environments. + +| Environment variable | 설명 | +| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `CI` | Always set to `true`. | +| `HOME` | The path to the {% data variables.product.prodname_dotcom %} home directory used to store user data. For example, `/github/home`. | +| `GITHUB_WORKFLOW` | The name of the workflow. | +| `GITHUB_RUN_ID` | {% data reusables.github-actions.run_id_description %} +| `GITHUB_RUN_NUMBER` | {% data reusables.github-actions.run_number_description %} +| `GITHUB_ACTION` | The unique identifier (`id`) of the action. | +| `GITHUB_ACTIONS` | Always set to `true` when {% data variables.product.prodname_actions %} is running the workflow. You can use this variable to differentiate when tests are being run locally or by {% data variables.product.prodname_actions %}. | +| `GITHUB_ACTOR` | The name of the person or app that initiated the workflow. For example, `octocat`. | +| `GITHUB_REPOSITORY` | The owner and repository name. For example, `octocat/Hello-World`. | +| `GITHUB_EVENT_NAME` | The name of the webhook event that triggered the workflow. | +| `GITHUB_EVENT_PATH` | The path of the file with the complete webhook event payload. For example, `/github/workflow/event.json`. | +| `GITHUB_WORKSPACE` | The {% data variables.product.prodname_dotcom %} workspace directory path. The workspace directory is a copy of your repository if your workflow uses the [actions/checkout](https://github.com/actions/checkout) action. If you don't use the `actions/checkout` action, the directory will be empty. For example, `/home/runner/work/my-repo-name/my-repo-name`. | +| `GITHUB_SHA` | The commit SHA that triggered the workflow. For example, `ffac537e6cbbf934b08745a378932722df287a53`. | +| `GITHUB_REF` | The branch or tag ref that triggered the workflow. For example, `refs/heads/feature-branch-1`. If neither a branch or tag is available for the event type, the variable will not exist. | +| `GITHUB_HEAD_REF` | Only set for forked repositories. The branch of the head repository. | +| `GITHUB_BASE_REF` | Only set for forked repositories. The branch of the base repository. | +| `GITHUB_SERVER_URL` | Returns the URL of the {% data variables.product.product_name %} server. For example: `https://{% data variables.product.product_url %}`. | +| `GITHUB_API_URL` | Returns the API URL. For example: `{% data variables.product.api_url_code %}`. | +| `GITHUB_GRAPHQL_URL` | Returns the GraphQL API URL. For example: `{% data variables.product.graphql_url_code %}`. | + +### Naming conventions for environment variables + +{% note %} + +**Note:** {% data variables.product.prodname_dotcom %} reserves the `GITHUB_` environment variable prefix for internal use by {% data variables.product.prodname_dotcom %}. Setting an environment variable or secret with the `GITHUB_` prefix will result in an error. + +{% endnote %} + +Any new environment variables you set that point to a location on the filesystem should have a `_PATH` suffix. The `HOME` and `GITHUB_WORKSPACE` default variables are exceptions to this convention because the words "home" and "workspace" already imply a location. diff --git a/translations/ko-KR/content/actions/reference/events-that-trigger-workflows.md b/translations/ko-KR/content/actions/reference/events-that-trigger-workflows.md index a8c86a815eea..46cc7cf5cb68 100644 --- a/translations/ko-KR/content/actions/reference/events-that-trigger-workflows.md +++ b/translations/ko-KR/content/actions/reference/events-that-trigger-workflows.md @@ -15,31 +15,142 @@ versions: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -### About workflow events +### Configuring workflow events -You can configure your workflow to run when webhook events are created from activity on {% data variables.product.product_name %}. Workflows can use more than one webhook event to trigger a workflow run. For more information, see "[Webhooks](/webhooks)." For more information about the `on` syntax, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#on)." +You can configure workflows to run for one or more events using the `on` workflow syntax. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#on)." + +{% data reusables.github-actions.actions-on-examples %} + +{% note %} + +**Note:** You cannot trigger new workflow runs using the `GITHUB_TOKEN`. For more information, see "[Triggering new workflows using a personal access token](#triggering-new-workflows-using-a-personal-access-token)." + +{% endnote %} The following steps occur to trigger a workflow run: -1. An event occurs on your repository, and the resulting event webhook has an associated commit SHA and Git ref. -1. The `.github/workflows` directory in your repository is searched for workflow files at the associated commit SHA or Git ref. The workflow files must be present in that commit SHA or Git ref to be considered. +1. An event occurs on your repository, and the resulting event has an associated commit SHA and Git ref. +2. The `.github/workflows` directory in your repository is searched for workflow files at the associated commit SHA or Git ref. The workflow files must be present in that commit SHA or Git ref to be considered. For example, if the event occurred on a particular repository branch, then the workflow files must be present in the repository on that branch. 1. The workflow files for that commit SHA and Git ref are inspected, and a new workflow run is triggered for any workflows that have `on:` values that match the triggering event. The workflow runs on your repository's code at the same commit SHA and Git ref that triggered the event. When a workflow runs, {% data variables.product.product_name %} sets the `GITHUB_SHA` (commit SHA) and `GITHUB_REF` (Git ref) environment variables in the runner environment. For more information, see "[Using environment variables](/actions/automating-your-workflow-with-github-actions/using-environment-variables)." +### Scheduled events + +The `schedule` event allows you to trigger a workflow at a scheduled time. + +#### `일정` + +| Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` | +| --------------------- | -------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| n/a | n/a | Last commit on default branch | Default branch | When the scheduled workflow is set to run. A scheduled workflow uses [POSIX cron syntax](https://pubs.opengroup.org/onlinepubs/9699919799/utilities/crontab.html#tag_20_25_07). For more information, see "[Triggering a workflow with events](/articles/configuring-a-workflow/#triggering-a-workflow-with-events)." | + +{% data reusables.repositories.actions-scheduled-workflow-example %} + +Cron syntax has five fields separated by a space, and each field represents a unit of time. + +``` +┌───────────── minute (0 - 59) +│ ┌───────────── hour (0 - 23) +│ │ ┌───────────── day of the month (1 - 31) +│ │ │ ┌───────────── month (1 - 12 or JAN-DEC) +│ │ │ │ ┌───────────── day of the week (0 - 6 or SUN-SAT) +│ │ │ │ │ +│ │ │ │ │ +│ │ │ │ │ +* * * * * +``` + +You can use these operators in any of the five fields: + +| Operator | 설명 | 예시 | +| -------- | -------------------- | -------------------------------------------------------------------------------------------------- | +| * | Any value | `* * * * *` runs every minute of every day. | +| , | Value list separator | `2,10 4,5 * * *` runs at minute 2 and 10 of the 4th and 5th hour of every day. | +| - | Range of values | `0 4-6 * * *` runs at minute 0 of the 4th, 5th, and 6th hour. | +| / | Step values | `20/15 * * * *` runs every 15 minutes starting from minute 20 through 59 (minutes 20, 35, and 50). | + {% note %} -**Note:** You cannot trigger new workflow runs using the `GITHUB_TOKEN`. For more information, see "[Triggering new workflows using a personal access token](#triggering-new-workflows-using-a-personal-access-token)." +**Note:** {% data variables.product.prodname_actions %} does not support the non-standard syntax `@yearly`, `@monthly`, `@weekly`, `@daily`, `@hourly`, and `@reboot`. {% endnote %} -{% data reusables.github-actions.actions-on-examples %} +You can use [crontab guru](https://crontab.guru/) to help generate your cron syntax and confirm what time it will run. To help you get started, there is also a list of [crontab guru examples](https://crontab.guru/examples.html). + +### Manual events + +You can manually trigger workflow runs. To trigger specific workflows in a repository, use the `workflow_dispatch` event. To trigger more than one workflow in a repository and create custom events and event types, use the `repository_dispatch` event. + +#### `workflow_dispatch` + +| Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` | +| ---------------------------------------------------------------- | -------------- | -------------------------------------- | ----------------------------- | +| [workflow_dispatch](/webhooks/event-payloads/#workflow_dispatch) | n/a | Last commit on the `GITHUB_REF` branch | Branch that received dispatch | + +You can configure custom-defined input properties, default input values, and required inputs for the event directly in your workflow. When the workflow runs, you can access the input values in the `github.event.inputs` context. For more information, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)." + +You can manually trigger a workflow run using the {% data variables.product.product_name %} API and from {% data variables.product.product_name %}. For more information, see "[Manually running a workflow](/actions/managing-workflow-runs/manually-running-a-workflow)." + + When you trigger the event on {% data variables.product.prodname_dotcom %}, you can provide the `ref` and any `inputs` directly on {% data variables.product.prodname_dotcom %}. For more information, see "[Using inputs and outputs with an action](/actions/learn-github-actions/finding-and-customizing-actions#using-inputs-and-outputs-with-an-action)." + + To trigger the custom `workflow_dispatch` webhook event using the REST API, you must send a `POST` request to a {% data variables.product.prodname_dotcom %} API endpoint and provide the `ref` and any required `inputs`. For more information, see the "[Create a workflow dispatch event](/rest/reference/actions/#create-a-workflow-dispatch-event)" REST API endpoint. + +##### Example workflow configuration + +This example defines the `name` and `home` inputs and prints them using the `github.event.inputs.name` and `github.event.inputs.home` contexts. If a `name` isn't provided, the default value 'Mona the Octocat' is printed. + +{% raw %} +```yaml +name: Manually triggered workflow +on: + workflow_dispatch: + inputs: + name: + description: 'Person to greet' + required: true + default: 'Mona the Octocat' + home: + description: 'location' + required: false + +jobs: + say_hello: + runs-on: ubuntu-latest + steps: + - run: | + echo "Hello ${{ github.event.inputs.name }}!" + echo "- in ${{ github.event.inputs.home }}!" +``` +{% endraw %} + +#### `repository_dispatch` + +| Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` | +| -------------------------------------------------------------------- | -------------- | -------------------------------------- | ----------------------------- | +| [repository_dispatch](/webhooks/event-payloads/#repository_dispatch) | n/a | Last commit on the `GITHUB_REF` branch | Branch that received dispatch | + +{% data reusables.github-actions.branch-requirement %} + +You can use the {% data variables.product.product_name %} API to trigger a webhook event called [`repository_dispatch`](/webhooks/event-payloads/#repository_dispatch) when you want to trigger a workflow for activity that happens outside of {% data variables.product.prodname_dotcom %}. For more information, see "[Create a repository dispatch event](/v3/repos/#create-a-repository-dispatch-event)." + +To trigger the custom `repository_dispatch` webhook event, you must send a `POST` request to a {% data variables.product.product_name %} API endpoint and provide an `event_type` name to describe the activity type. To trigger a workflow run, you must also configure your workflow to use the `repository_dispatch` event. + +##### 예시 + +By default, all `event_types` trigger a workflow to run. You can limit your workflow to run when a specific `event_type` value is sent in the `repository_dispatch` webhook payload. You define the event types sent in the `repository_dispatch` payload when you create the repository dispatch event. + +```yaml +on: + repository_dispatch: + types: [opened, deleted] +``` ### Webhook events -You can configure your workflow to run when webhook events are created on {% data variables.product.product_name %}. Some events have more than one activity type that triggers the event. If more than one activity type triggers the event, you can specify which activity types will trigger the workflow to run. +You can configure your workflow to run when webhook events are created on {% data variables.product.product_name %}. Some events have more than one activity type that triggers the event. If more than one activity type triggers the event, you can specify which activity types will trigger the workflow to run. For more information, see "[Webhooks](/webhooks)." #### `check_run` @@ -189,9 +300,9 @@ Runs your workflow anytime the `issue_comment` event occurs. {% data reusables.d {% data reusables.github-actions.branch-requirement %} -| Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` | -| ---------------------------------------------------------- | ----------------------------------------------------------------- | ----------------------------- | -------------- | -| [`issue_comment`](/v3/activity/event_types/#issue_comment) | - `created`
    - `edited`
    - `deleted`
    | Last commit on default branch | Default branch | +| Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` | +| --------------------------------------------------------- | ----------------------------------------------------------------- | ----------------------------- | -------------- | +| [`issue_comment`](/rest/reference/activity#issue_comment) | - `created`
    - `edited`
    - `deleted`
    | Last commit on default branch | Default branch | {% data reusables.developer-site.limit_workflow_to_activity_types %} @@ -265,7 +376,7 @@ on: #### `page_build` -Runs your workflow anytime someone pushes to a {% data variables.product.product_name %} Pages-enabled branch, which triggers the `page_build` event. For information about the REST API, see "[Pages](/v3/repos/pages/)." +Runs your workflow anytime someone pushes to a {% data variables.product.product_name %} Pages-enabled branch, which triggers the `page_build` event. For information about the REST API, see "[Edit repositories](/v3/repos/#edit)." {% data reusables.github-actions.branch-requirement %} @@ -489,9 +600,9 @@ on: Runs your workflow anytime the `release` event occurs. {% data reusables.developer-site.multiple_activity_types %} For information about the REST API, see "[Releases](/v3/repos/releases/)." -| Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` | -| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- | -------------- | -| [`릴리스`](/webhooks/event-payloads/#release) | - `published`{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}
    - `unpublished`
    - `created`
    - `edited`
    - `deleted`
    - `prereleased`
    - `released`{% endif %} | Last commit in the tagged release | Tag of release | +| Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` | +| ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- | -------------- | +| [`릴리스`](/webhooks/event-payloads/#release) | - `published`
    - `unpublished`
    - `created`
    - `edited`
    - `deleted`
    - `prereleased`
    - `released` | Last commit in the tagged release | Tag of release | {% data reusables.developer-site.limit_workflow_to_activity_types %} @@ -558,85 +669,6 @@ on: - requested ``` -### Scheduled events - -The `schedule` event allows you to trigger a workflow at a scheduled time. - -#### `일정` - -| Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` | -| --------------------- | -------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| n/a | n/a | Last commit on default branch | Default branch | When the scheduled workflow is set to run. A scheduled workflow uses [POSIX cron syntax](https://pubs.opengroup.org/onlinepubs/9699919799/utilities/crontab.html#tag_20_25_07). For more information, see "[Triggering a workflow with events](/articles/configuring-a-workflow/#triggering-a-workflow-with-events)." | - -{% data reusables.repositories.actions-scheduled-workflow-example %} - -Cron syntax has five fields separated by a space, and each field represents a unit of time. - -``` -┌───────────── minute (0 - 59) -│ ┌───────────── hour (0 - 23) -│ │ ┌───────────── day of the month (1 - 31) -│ │ │ ┌───────────── month (1 - 12 or JAN-DEC) -│ │ │ │ ┌───────────── day of the week (0 - 6 or SUN-SAT) -│ │ │ │ │ -│ │ │ │ │ -│ │ │ │ │ -* * * * * -``` - -You can use these operators in any of the five fields: - -| Operator | 설명 | 예시 | -| -------- | -------------------- | -------------------------------------------------------------------------------------------------- | -| * | Any value | `* * * * *` runs every minute of every day. | -| , | Value list separator | `2,10 4,5 * * *` runs at minute 2 and 10 of the 4th and 5th hour of every day. | -| - | Range of values | `0 4-6 * * *` runs at minute 0 of the 4th, 5th, and 6th hour. | -| / | Step values | `20/15 * * * *` runs every 15 minutes starting from minute 20 through 59 (minutes 20, 35, and 50). | - -{% note %} - -**Note:** {% data variables.product.prodname_actions %} does not support the non-standard syntax `@yearly`, `@monthly`, `@weekly`, `@daily`, `@hourly`, and `@reboot`. - -{% endnote %} - -You can use [crontab guru](https://crontab.guru/) to help generate your cron syntax and confirm what time it will run. To help you get started, there is also a list of [crontab guru examples](https://crontab.guru/examples.html). - -### Manual events - -You can manually trigger workflow runs. To trigger specific workflows in a repository, use the `workflow_dispatch` event. To trigger more than one workflow in a repository and create custom events and event types, use the `repository_dispatch` event. - -#### `workflow_dispatch` - -| Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` | -| ---------------------------------------------------------------- | -------------- | -------------------------------------- | ----------------------------- | -| [workflow_dispatch](/webhooks/event-payloads/#workflow_dispatch) | n/a | Last commit on the `GITHUB_REF` branch | Branch that received dispatch | - -You can manually trigger a workflow run using the {% data variables.product.product_name %} API and from {% data variables.product.product_name %}. To trigger the custom `workflow_dispatch` webhook event using the REST API, you must send a `POST` request to a {% data variables.product.prodname_dotcom %} API endpoint and provide the `ref` and any required `inputs`. For more information, see the "[Create a workflow dispatch event](/rest/reference/actions/#create-a-workflow-dispatch-event)" REST API endpoint. - - When you trigger the event on {% data variables.product.prodname_dotcom %}, you can provide the `ref` and any `inputs` directly on {% data variables.product.prodname_dotcom %}. For more information, see "[Configuring a workflow](/actions/configuring-and-managing-workflows/configuring-a-workflow#manually-running-a-workflow)." - -#### `repository_dispatch` - -| Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` | -| -------------------------------------------------------------------- | -------------- | -------------------------------------- | ----------------------------- | -| [repository_dispatch](/webhooks/event-payloads/#repository_dispatch) | n/a | Last commit on the `GITHUB_REF` branch | Branch that received dispatch | - -{% data reusables.github-actions.branch-requirement %} - -You can use the {% data variables.product.product_name %} API to trigger a webhook event called [`repository_dispatch`](/webhooks/event-payloads/#repository_dispatch) when you want to trigger a workflow for activity that happens outside of {% data variables.product.prodname_dotcom %}. For more information, see "[Create a repository dispatch event](/v3/repos/#create-a-repository-dispatch-event)." - -To trigger the custom `repository_dispatch` webhook event, you must send a `POST` request to a {% data variables.product.product_name %} API endpoint and provide an `event_type` name to describe the activity type. To trigger a workflow run, you must also configure your workflow to use the `repository_dispatch` event. - -##### 예시 - -By default, all `event_types` trigger a workflow to run. You can limit your workflow to run when a specific `event_type` value is sent in the `repository_dispatch` webhook payload. You define the event types sent in the `repository_dispatch` payload when you create the repository dispatch event. - -```yaml -on: - repository_dispatch: - types: [opened, deleted] -``` - ### Triggering new workflows using a personal access token {% data reusables.github-actions.actions-do-not-trigger-workflows %} For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." diff --git a/translations/ko-KR/content/actions/reference/index.md b/translations/ko-KR/content/actions/reference/index.md index dd3a66636bac..14ce3baec307 100644 --- a/translations/ko-KR/content/actions/reference/index.md +++ b/translations/ko-KR/content/actions/reference/index.md @@ -1,6 +1,8 @@ --- title: Reference -intro: 'Reference documentation for building actions, creating workflows, and other tools and information on {% data variables.product.prodname_actions %}.' +intro: 'Reference documentation for creating workflows, using GitHub-hosted runners, and authentication.' +redirect_from: + - /actions/configuring-and-managing-workflows/using-variables-and-secrets-in-a-workflow versions: free-pro-team: '*' enterprise-server: '>=2.22' @@ -9,9 +11,39 @@ versions: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} +### Workflow syntax + +The workflow file is written in YAML. In the YAML workflow file, you can use expression syntax to evaluate contextual information, literals, operators, and functions. Contextual information includes workflow, environment variables, secrets, and the events that triggered the workflow. When you use [`run`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun) in a workflow step to run shell commands, you can use specific workflow command syntax to set environment variables, set output parameters for subsequent steps, and set error or debug messages. + {% link_in_list /workflow-syntax-for-github-actions %} -{% link_in_list /events-that-trigger-workflows %} {% link_in_list /context-and-expression-syntax-for-github-actions %} {% link_in_list /workflow-commands-for-github-actions %} -{% link_in_list /virtual-environments-for-github-hosted-runners %} -{% link_in_list /software-installed-on-github-hosted-runners %} + +### 이벤트 + +You can configure workflows to run when specific GitHub events occur, at a scheduled time, manually, or when events outside of GitHub occur. + +{% link_in_list /events-that-trigger-workflows %} + +### Authentication and secrets + +{% data variables.product.prodname_dotcom %} provides a token that you can use to authenticate on behalf of {% data variables.product.prodname_actions %}. You can also store sensitive information as a secret in your organization or repository. {% data variables.product.prodname_dotcom %} encrypts all secrets. + +{% link_in_list /authentication-in-a-workflow %} +{% link_in_list /encrypted-secrets %} + +### {% data variables.product.prodname_dotcom %}-hosted runners + +GitHub offers hosted virtual machines to run workflows. The virtual machine contains an environment with tools, packages, and environment variables for GitHub Actions to use. + +{% link_in_list /environment-variables %} +{% link_in_list /specifications-for-github-hosted-runners %} + +{% if currentVersion == "free-pro-team@latest" %} +### Administration + +When you run workflows on {% data variables.product.prodname_dotcom %}-hosted runners, there are usage limits and potential usage charges. You can also disable or restrict the usage of {% data variables.product.prodname_actions %} in a repository and organization. + +{% link_in_list /usage-limits-billing-and-administration %} + +{% endif %} diff --git a/translations/ko-KR/content/actions/reference/specifications-for-github-hosted-runners.md b/translations/ko-KR/content/actions/reference/specifications-for-github-hosted-runners.md new file mode 100644 index 000000000000..586204ead703 --- /dev/null +++ b/translations/ko-KR/content/actions/reference/specifications-for-github-hosted-runners.md @@ -0,0 +1,149 @@ +--- +title: Specifications for GitHub-hosted runners +intro: '{% data variables.product.prodname_dotcom %} offers hosted virtual machines to run workflows. The virtual machine contains an environment of tools, packages, and settings available for {% data variables.product.prodname_actions %} to use.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /articles/virtual-environments-for-github-actions + - /github/automating-your-workflow-with-github-actions/virtual-environments-for-github-actions + - /github/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners + - /actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners + - /actions/reference/virtual-environments-for-github-hosted-runners + - /actions/reference/software-installed-on-github-hosted-runners +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### About {% data variables.product.prodname_dotcom %}-hosted runners + +A {% data variables.product.prodname_dotcom %}-hosted runner is a virtual machine hosted by {% data variables.product.prodname_dotcom %} with the {% data variables.product.prodname_actions %} runner application installed. {% data variables.product.prodname_dotcom %} offers runners with Linux, Windows, and macOS operating systems. + +When you use a {% data variables.product.prodname_dotcom %}-hosted runner, machine maintenance and upgrades are taken care of for you. You can run workflows directly on the virtual machine or in a Docker container. + +You can specify the runner type for each job in a workflow. Each job in a workflow executes in a fresh instance of the virtual machine. All steps in the job execute in the same instance of the virtual machine, allowing the actions in that job to share information using the filesystem. + +{% data reusables.github-actions.runner-app-open-source %} + +#### Cloud hosts for {% data variables.product.prodname_dotcom %}-hosted runners + +{% data variables.product.prodname_dotcom %} hosts Linux and Windows runners on Standard_DS2_v2 virtual machines in Microsoft Azure with the {% data variables.product.prodname_actions %} runner application installed. The {% data variables.product.prodname_dotcom %}-hosted runner application is a fork of the Azure Pipelines Agent. Inbound ICMP packets are blocked for all Azure virtual machines, so ping or traceroute commands might not work. For more information about the Standard_DS2_v2 machine resources, see "[Dv2 and DSv2-series](https://docs.microsoft.com/en-us/azure/virtual-machines/dv2-dsv2-series#dsv2-series)" in the Microsoft Azure documentation. + +{% data variables.product.prodname_dotcom %} uses [MacStadium](https://www.macstadium.com/) to host the macOS runners. + +#### Administrative privileges of {% data variables.product.prodname_dotcom %}-hosted runners + +The Linux and macOS virtual machines both run using passwordless `sudo`. When you need to execute commands or install tools that require more privileges than the current user, you can use `sudo` without needing to provide a password. For more information, see the "[Sudo Manual](https://www.sudo.ws/man/1.8.27/sudo.man.html)." + +Windows virtual machines are configured to run as administrators with User Account Control (UAC) disabled. For more information, see "[How User Account Control works](https://docs.microsoft.com/en-us/windows/security/identity-protection/user-account-control/how-user-account-control-works)" in the Windows documentation. + +### Supported runners and hardware resources + +Each virtual machine has the same hardware resources available. + +- 2-core CPU +- 7 GB of RAM memory +- 14 GB of SSD disk space + +{% data reusables.github-actions.supported-github-runners %} + +{% data reusables.github-actions.ubuntu-runner-preview %} + +Workflow logs list the runner used to run a job. For more information, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)." + +### Supported software + +The software tools included in {% data variables.product.prodname_dotcom %}-hosted runners are updated weekly. For the latest list of included tools for each runner operating system, see the links below: + +* [Ubuntu 20.04 LTS](https://github.com/actions/virtual-environments/blob/main/images/linux/Ubuntu2004-README.md) +* [Ubuntu 18.04 LTS](https://github.com/actions/virtual-environments/blob/main/images/linux/Ubuntu1804-README.md) +* [Ubuntu 16.04 LTS](https://github.com/actions/virtual-environments/blob/main/images/linux/Ubuntu1604-README.md) +* [Windows Server 2019](https://github.com/actions/virtual-environments/blob/main/images/win/Windows2019-Readme.md) +* [Windows Server 2016](https://github.com/actions/virtual-environments/blob/main/images/win/Windows2016-Readme.md) +* [MacOS 10.15](https://github.com/actions/virtual-environments/blob/main/images/macos/macos-10.15-Readme.md) + +{% data reusables.github-actions.ubuntu-runner-preview %} + +{% data variables.product.prodname_dotcom %}-hosted runners include the operating system's default built-in tools, in addition to the packages listed in the above references. For example, Ubuntu and macOS runners include `grep`, `find`, and `which`, among other default tools. + +Workflow logs include a link to the preinstalled tools on the runner. For more information, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)." + +If there is a tool that you'd like to request, please open an issue at [actions/virtual-environments](https://github.com/actions/virtual-environments). + +### IP addresses + +{% note %} + +**Note:** If you use an IP address allow list for your {% data variables.product.prodname_dotcom %} organization or enterprise account, you cannot use {% data variables.product.prodname_dotcom %}-hosted runners and must instead use self-hosted runners. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners)." + +{% endnote %} + +Windows and Ubuntu runners are hosted in Azure and have the same IP address ranges as Azure Data centers. Currently, all Windows and Ubuntu {% data variables.product.prodname_dotcom %}-hosted runners are in the following Azure regions: + +- East US (`eastus`) +- East US 2 (`eastus2`) +- West US 2 (`westus2`) +- Central US (`centralus`) +- South Central US (`southcentralus`) + +Microsoft updates the Azure IP address ranges weekly in a JSON file that you can download from the [Azure IP Ranges and Service Tags - Public Cloud](https://www.microsoft.com/en-us/download/details.aspx?id=56519) website. You can use this range of IP addresses if you require an allow-list to prevent unauthorized access to your internal resources. + +The JSON file contains an array called `values`. Inside that array, you can find the supported IP addresses in an object with a `name` and `id` of the Azure region, for example `"AzureCloud.eastus2"`. + +You can find the supported IP address ranges in the `"addressPrefixes"` object. This is a condensed example of the JSON file. + +```json +{ + "changeNumber": 84, + "cloud": "Public", + "values": [ + { + "name": "AzureCloud.eastus2", + "id": "AzureCloud.eastus2", + "properties": { + "changeNumber": 33, + "region": "eastus2", + "platform": "Azure", + "systemService": "", + "addressPrefixes": [ + "13.68.0.0/17", + "13.77.64.0/18", + "13.104.147.0/25", + ... + ] + } + } + ] +} +``` + +### File systems + +{% data variables.product.prodname_dotcom %} executes actions and shell commands in specific directories on the virtual machine. The file paths on virtual machines are not static. Use the environment variables {% data variables.product.prodname_dotcom %} provides to construct file paths for the `home`, `workspace`, and `workflow` directories. + +| Directory | Environment variable | 설명 | +| --------------------- | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `home` | `HOME` | Contains user-related data. For example, this directory could contain credentials from a login attempt. | +| `workspace` | `GITHUB_WORKSPACE` | Actions and shell commands execute in this directory. An action can modify the contents of this directory, which subsequent actions can access. | +| `workflow/event.json` | `GITHUB_EVENT_PATH` | The `POST` payload of the webhook event that triggered the workflow. {% data variables.product.prodname_dotcom %} rewrites this each time an action executes to isolate file content between actions. | + +For a list of the environment variables {% data variables.product.prodname_dotcom %} creates for each workflow, see "[Using environment variables](/github/automating-your-workflow-with-github-actions/using-environment-variables)." + +#### Docker container filesystem + +Actions that run in Docker containers have static directories under the `/github` path. However, we strongly recommend using the default environment variables to construct file paths in Docker containers. + +{% data variables.product.prodname_dotcom %} reserves the `/github` path prefix and creates three directories for actions. + +- `/github/home` +- `/github/workspace` - {% data reusables.repositories.action-root-user-required %} +- `/github/workflow` + +{% if currentVersion == "free-pro-team@latest" %} + +### 더 읽을거리 +- "[Managing billing for {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)" + +{% endif %} diff --git a/translations/ko-KR/content/actions/reference/usage-limits-billing-and-administration.md b/translations/ko-KR/content/actions/reference/usage-limits-billing-and-administration.md new file mode 100644 index 000000000000..927ade764aac --- /dev/null +++ b/translations/ko-KR/content/actions/reference/usage-limits-billing-and-administration.md @@ -0,0 +1,88 @@ +--- +title: 'Usage limits, billing, and administration' +intro: 'There are usage limits for {% data variables.product.prodname_actions %} workflows. Usage charges apply to repositories that go beyond the amount of free minutes and storage for a repository.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /actions/getting-started-with-github-actions/usage-and-billing-information-for-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### About billing for {% data variables.product.prodname_actions %} + +{% if currentVersion == "free-pro-team@latest" %} +{% data reusables.github-actions.actions-billing %} For more information, see "[About billing for {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions)." +{% else %} +GitHub Actions usage is free for +{% data variables.product.prodname_ghe_server %} that use self-hosted runners. +{% endif %} + +### Usage limits + +{% if currentVersion == "free-pro-team@latest" %} +There are some limits on +{% data variables.product.prodname_actions %} usage when using {% data variables.product.prodname_dotcom %}-hosted runners. These limits are subject to change. + +{% note %} + +**Note:** For self-hosted runners, different usage limits apply. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)." + +{% endnote %} + +- **Job execution time** - Each job in a workflow can run for up to 6 hours of execution time. If a job reaches this limit, the job is terminated and fails to complete. +{% data reusables.github-actions.usage-workflow-run-time %} +{% data reusables.github-actions.usage-api-requests %} +- **Concurrent jobs** - The number of concurrent jobs you can run in your account depends on your GitHub plan, as indicated in the following table. If exceeded, any additional jobs are queued. + + | GitHub plan | Total concurrent jobs | Maximum concurrent macOS jobs | + | ----------- | --------------------- | ----------------------------- | + | 무료 | 20 | 5 | + | Pro | 40 | 5 | + | Team | 60 | 5 | + | Enterprise | 180 | 50 | +- **Job matrix** - {% data reusables.github-actions.usage-matrix-limits %} +{% else %} +Usage limits apply to self-hosted runners. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)." +{% endif %} + +{% if currentVersion == "free-pro-team@latest" %} +### Usage policy +In addition to the usage limits, you must ensure that you use + +{% data variables.product.prodname_actions %} within the [GitHub Terms of Service](/articles/github-terms-of-service/). For more information on {% data variables.product.prodname_actions %}-specific terms, see the [GitHub Additional Product Terms](/github/site-policy/github-additional-product-terms#a-actions-usage). +{% endif %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +### Artifact and log retention policy + +You can configure the artifact and log retention period for your repository, organization, or enterprise account. + +{% data reusables.actions.about-artifact-log-retention %} + +For more information, see: + +- [Configuring the retention period for {% data variables.product.prodname_actions %} for artifacts and logs in your repository](/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository) +- [Configuring the retention period for {% data variables.product.prodname_actions %} for artifacts and logs in your organization](/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization) +- [Configuring the retention period for {% data variables.product.prodname_actions %} for artifacts and logs in your enterprise](/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account) +{% endif %} + +### Disabling or limiting {% data variables.product.prodname_actions %} for your repository or organization + +{% data reusables.github-actions.disabling-github-actions %} + +For more information, see: +- "[Disabling or limiting {% data variables.product.prodname_actions %} for a repository](/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository)" +- "[Disabling or limiting {% data variables.product.prodname_actions %} for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization)"{% if currentVersion == "free-pro-team@latest" %} +- "[Enforcing {% data variables.product.prodname_actions %} policies in your enterprise account](/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account)" for {% data variables.product.prodname_ghe_cloud %}{% endif %} + +### Disabling and enabling workflows + +You can enable and disable individual workflows in your repository on {% data variables.product.prodname_dotcom %}. + +{% data reusables.actions.scheduled-workflows-disabled %} + +For more information, see "[Disabling and enabling a workflow](/actions/managing-workflow-runs/disabling-and-enabling-a-workflow)." diff --git a/translations/ko-KR/content/actions/reference/workflow-commands-for-github-actions.md b/translations/ko-KR/content/actions/reference/workflow-commands-for-github-actions.md index 2307e015d70a..4d9ce7b4b895 100644 --- a/translations/ko-KR/content/actions/reference/workflow-commands-for-github-actions.md +++ b/translations/ko-KR/content/actions/reference/workflow-commands-for-github-actions.md @@ -21,7 +21,11 @@ versions: Actions can communicate with the runner machine to set environment variables, output values used by other actions, add debug messages to the output logs, and other tasks. +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +Most workflow commands use the `echo` command in a specific format, while others are invoked by writing to a file. For more information, see ["Environment files".](#environment-files) +{% else %} Workflow commands use the `echo` command in a specific format. +{% endif %} ``` bash echo "::workflow-command parameter1={data},parameter2={data}::{command value}" @@ -41,40 +45,46 @@ echo "::workflow-command parameter1={data},parameter2={data}::{command value}" ### Using workflow commands to access toolkit functions -The [actions/toolkit](https://github.com/actions/toolkit) includes a number of functions that can be executed as workflow commands. Use the `::` syntax to run the workflow commands within your YAML file; these commands are then sent to the runner over `stdout`. For example, instead of using code to set an environment variable, as below: +The [actions/toolkit](https://github.com/actions/toolkit) includes a number of functions that can be executed as workflow commands. Use the `::` syntax to run the workflow commands within your YAML file; these commands are then sent to the runner over `stdout`. For example, instead of using code to set an output, as below: ```javascript -core.exportVariable('SELECTED_COLOR', 'green'); +core.setOutput('SELECTED_COLOR', 'green'); ``` -You can use the `set-env` command in your workflow to set the same value: +You can use the `set-output` command in your workflow to set the same value: ``` yaml - name: Set selected color - run: echo '::set-env name=SELECTED_COLOR::green' + run: echo '::set-output name=SELECTED_COLOR::green' + id: random-color-generator - name: Get color - run: echo 'The selected color is' $SELECTED_COLOR + run: echo 'The selected color is' ${steps.random-color-generator.outputs.SELECTED_COLOR} ``` The following table shows which toolkit functions are available within a workflow: -| Toolkit function | Equivalent workflow command | -| --------------------- | ---------------------------------------------------- | -| `core.addPath` | `add-path` | -| `core.debug` | `debug` | -| `core.error` | `error` | -| `core.endGroup` | `endgroup` | -| `core.exportVariable` | `set-env` | -| `core.getInput` | Accessible using environment variable `INPUT_{NAME}` | -| `core.getState` | Accessible using environment variable `STATE_{NAME}` | -| `core.isDebug` | Accessible using environment variable `RUNNER_DEBUG` | -| `core.saveState` | `save-state` | -| `core.setFailed` | Used as a shortcut for `::error` and `exit 1` | -| `core.setOutput` | `set-output` | -| `core.setSecret` | `add-mask` | -| `core.startGroup` | `그룹` | -| `core.warning` | `warning file` | - +| Toolkit function | Equivalent workflow command | +| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- | +| `core.addPath` | | +| {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}Accessible using environment file `GITHUB_PATH`{% else %} `add-path` {% endif %} | | +| | | +| `core.debug` | `debug` | +| `core.error` | `error` | +| `core.endGroup` | `endgroup` | +| `core.exportVariable` | | +| {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}Accessible using environment file `GITHUB_ENV`{% else %} `set-env` {% endif %} | | +| | | +| `core.getInput` | Accessible using environment variable `INPUT_{NAME}` | +| `core.getState` | Accessible using environment variable `STATE_{NAME}` | +| `core.isDebug` | Accessible using environment variable `RUNNER_DEBUG` | +| `core.saveState` | `save-state` | +| `core.setFailed` | Used as a shortcut for `::error` and `exit 1` | +| `core.setOutput` | `set-output` | +| `core.setSecret` | `add-mask` | +| `core.startGroup` | `그룹` | +| `core.warning` | `warning file` | + +{% if currentVersion ver_lt "enterprise-server@2.23" %} ### Setting an environment variable `::set-env name={name}::{value}` @@ -86,6 +96,7 @@ Creates or updates an environment variable for any actions running next in a job ``` bash echo "::set-env name=action_state::yellow" ``` +{% endif %} ### Setting an output parameter @@ -101,6 +112,7 @@ Optionally, you can also declare output parameters in an action's metadata file. echo "::set-output name=action_fruit::strawberry" ``` +{% if currentVersion ver_lt "enterprise-server@2.23" %} ### Adding a system path `::add-path::{path}` @@ -112,12 +124,13 @@ Prepends a directory to the system `PATH` variable for all subsequent actions in ``` bash echo "::add-path::/path/to/dir" ``` +{% endif %} ### Setting a debug message `::debug::{message}` -Prints a debug message to the log. You must create a secret named `ACTIONS_STEP_DEBUG` with the value `true` to see the debug messages set by this command in the log. For more information, see "[Managing a workflow run](/actions/configuring-and-managing-workflows/managing-a-workflow-run#enabling-debug-logging)." +Prints a debug message to the log. You must create a secret named `ACTIONS_STEP_DEBUG` with the value `true` to see the debug messages set by this command in the log. For more information, see "[Enabling debug logging](/actions/managing-workflow-runs/enabling-debug-logging)." #### 예시 @@ -213,3 +226,67 @@ The `STATE_processID` variable is then exclusively available to the cleanup scri ``` javascript console.log("The running PID from the main action is: " + process.env.STATE_processID); ``` + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +## Environment Files + +During the execution of a workflow, the runner generates temporary files that can be used to perform certain actions. The path to these files are exposed via environment variables. You will need to use UTF-8 encoding when writing to these files to ensure proper processing of the commands. Multiple commands can be written to the same file, separated by newlines. + +{% warning %} + +**Warning:** Powershell does not use UTF-8 by default. Make sure you write files using the correct encoding. For example, you need to set UTF-8 encoding when you set the path: + +``` +steps: + - run: echo "mypath" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append +``` + +{% endwarning %} + +### Setting an environment variable + +`echo "{name}={value}" >> $GITHUB_ENV` + +Creates or updates an environment variable for any actions running next in a job. The action that creates or updates the environment variable does not have access to the new value, but all subsequent actions in a job will have access. Environment variables are case-sensitive and you can include punctuation. + +#### 예시 + +```bash +echo "action_state=yellow" >> $GITHUB_ENV +``` + +Running `$action_state` in a future step will now return `yellow` + +#### Multline strings +For multiline strings, you may use a delimiter with the following syntax. + +``` +{name}<<{delimiter} +{value} +{delimiter} +``` + +#### 예시 +In this example, we use `EOF` as a delimiter and set the `JSON_RESPONSE` environment variable to the value of the curl response. +``` +steps: + - name: Set the value + id: step_one + run: | + echo 'JSON_RESPONSE<> $GITHUB_ENV + curl https://httpbin.org/json >> $GITHUB_ENV + echo 'EOF' >> $GITHUB_ENV +``` + +### Adding a system path + +`echo "{path}" >> $GITHUB_PATH` + +Prepends a directory to the system `PATH` variable for all subsequent actions in the current job. The currently running action cannot access the new path variable. + +#### 예시 + +``` bash +echo "/path/to/dir" >> $GITHUB_PATH +``` +{% endif %} diff --git a/translations/ko-KR/content/actions/reference/workflow-syntax-for-github-actions.md b/translations/ko-KR/content/actions/reference/workflow-syntax-for-github-actions.md index f82994a5a37c..6b684f4357c1 100644 --- a/translations/ko-KR/content/actions/reference/workflow-syntax-for-github-actions.md +++ b/translations/ko-KR/content/actions/reference/workflow-syntax-for-github-actions.md @@ -21,10 +21,6 @@ Workflow files use YAML syntax, and must have either a `.yml` or `.yaml` file ex You must store workflow files in the `.github/workflows` directory of your repository. -### Usage limits - -{% data reusables.github-actions.github-actions-usage-limits %} - ### **`name`** The name of your workflow. {% data variables.product.prodname_dotcom %} displays the names of your workflows on your repository's actions page. If you omit `name`, {% data variables.product.prodname_dotcom %} sets it to the workflow file path relative to the root of the repository. @@ -64,8 +60,8 @@ on: push: # Sequence of patterns matched against refs/heads branches: - # Push events on master branch - - master + # Push events on main branch + - main # Push events to branches matching refs/heads/mona/octocat - 'mona/octocat' # Push events to branches matching refs/heads/releases/10 @@ -229,7 +225,7 @@ A workflow run is made up of one or more jobs. Jobs run in parallel by default. Each job runs in an environment specified by `runs-on`. -You can run an unlimited number of jobs as long as you are within the workflow usage limits. For more information, see "[Usage limits](#usage-limits)." +You can run an unlimited number of jobs as long as you are within the workflow usage limits. For more information, see "[Usage limits and billing](/actions/reference/usage-limits-billing-and-administration)" for {% data variables.product.prodname_dotcom %}-hosted runners and "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)" for self-hosted runner usage limits. If you need to find the unique identifier of a job running in a workflow run, you can use the {% data variables.product.prodname_dotcom %} API. For more information, see "[Workflow Jobs](/v3/actions/workflow-jobs)." @@ -310,7 +306,7 @@ runs-on: [self-hosted, linux] For more information, see "[About self-hosted runners](/github/automating-your-workflow-with-github-actions/about-self-hosted-runners)" and "[Using self-hosted runners in a workflow](/github/automating-your-workflow-with-github-actions/using-self-hosted-runners-in-a-workflow)." -### **`jobs..outputs`** +### **`jobs..outputs`** A `map` of outputs for a job. Job outputs are available to all downstream jobs that depend on this job. For more information on defining job dependencies, see [`jobs..needs`](#jobsjob_idneeds). @@ -393,7 +389,7 @@ You can use the `if` conditional to prevent a job from running unless a conditio A job contains a sequence of tasks called `steps`. Steps can run commands, run setup tasks, or run an action in your repository, a public repository, or an action published in a Docker registry. Not all steps run actions, but all actions run as a step. Each step runs in its own process in the runner environment and has access to the workspace and filesystem. Because steps run in their own process, changes to environment variables are not preserved between steps. {% data variables.product.prodname_dotcom %} provides built-in steps to set up and complete a job. -You can run an unlimited number of steps as long as you are within the workflow usage limits. For more information, see "[Usage limits](#usage-limits)." +You can run an unlimited number of steps as long as you are within the workflow usage limits. For more information, see "[Usage limits and billing](/actions/reference/usage-limits-billing-and-administration)" for {% data variables.product.prodname_dotcom %}-hosted runners and "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)" for self-hosted runner usage limits. #### 예시 @@ -447,7 +443,7 @@ The `my backup step` only runs when the previous step of a job fails. For more i ```yaml steps: - name: My first step - uses: monacorp/action-name@master + uses: monacorp/action-name@main - name: My backup step if: {% raw %}${{ failure() }}{% endraw %} uses: actions/heroku@master @@ -464,7 +460,7 @@ Selects an action to run as part of a step in your job. An action is a reusable We strongly recommend that you include the version of the action you are using by specifying a Git ref, SHA, or Docker tag number. If you don't specify a version, it could break your workflows or cause unexpected behavior when the action owner publishes an update. - Using the commit SHA of a released action version is the safest for stability and security. - Using the specific major action version allows you to receive critical fixes and security patches while still maintaining compatibility. It also assures that your workflow should still work. -- Using the `master` branch of an action may be convenient, but if someone releases a new major version with a breaking change, your workflow could break. +- Using the default branch of an action may be convenient, but if someone releases a new major version with a breaking change, your workflow could break. Some actions require inputs that you must set using the [`with`](#jobsjob_idstepswith) keyword. Review the action's README file to determine the inputs required. @@ -481,7 +477,7 @@ steps: # Reference a minor version of a release - uses: actions/setup-node@v1.2 # Reference a branch - - uses: actions/setup-node@master + - uses: actions/setup-node@main ``` ##### Example using a public action @@ -495,7 +491,7 @@ jobs: my_first_job: steps: - name: My first step - # Uses the master branch of a public repository + # Uses the default branch of a public repository uses: actions/heroku@master - name: My second step # Uses a specific version tag of a public repository @@ -513,7 +509,7 @@ jobs: my_first_job: steps: - name: My first step - uses: actions/aws/ec2@master + uses: actions/aws/ec2@main ``` ##### Example using action in the same repository as the workflow @@ -596,14 +592,14 @@ Using the `working-directory` keyword, you can specify the working directory of You can override the default shell settings in the runner's operating system using the `shell` keyword. You can use built-in `shell` keywords, or you can define a custom set of shell options. -| Supported platform | `shell` parameter | 설명 | Command run internally | -| ------------------ | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- | -| All | `bash` | The default shell on non-Windows platforms with a fallback to `sh`. When specifying a bash shell on Windows, the bash shell included with Git for Windows is used. | `bash --noprofile --norc -eo pipefail {0}` | -| All | `pwsh` | The PowerShell Core. {% data variables.product.prodname_dotcom %} appends the extension `.ps1` to your script name. | `pwsh -command "& '{0}'"` | -| All | `python` | Executes the python command. | `python {0}` | -| Linux / macOS | `sh` | The fallback behavior for non-Windows platforms if no shell is provided and `bash` is not found in the path. | `sh -e {0}` | -| Windows | `cmd` | {% data variables.product.prodname_dotcom %} appends the extension `.cmd` to your script name and substitutes for `{0}`. | `%ComSpec% /D /E:ON /V:OFF /S /C "CALL "{0}""`. | -| Windows | `powershell` | This is the default shell used on Windows. The Desktop PowerShell. {% data variables.product.prodname_dotcom %} appends the extension `.ps1` to your script name. | `powershell -command "& '{0}'"`. | +| Supported platform | `shell` parameter | 설명 | Command run internally | +| ------------------ | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------- | +| All | `bash` | The default shell on non-Windows platforms with a fallback to `sh`. When specifying a bash shell on Windows, the bash shell included with Git for Windows is used. | `bash --noprofile --norc -eo pipefail {0}` | +| All | `pwsh` | The PowerShell Core. {% data variables.product.prodname_dotcom %} appends the extension `.ps1` to your script name. | `pwsh -command ". '{0}'"` | +| All | `python` | Executes the python command. | `python {0}` | +| Linux / macOS | `sh` | The fallback behavior for non-Windows platforms if no shell is provided and `bash` is not found in the path. | `sh -e {0}` | +| Windows | `cmd` | {% data variables.product.prodname_dotcom %} appends the extension `.cmd` to your script name and substitutes for `{0}`. | `%ComSpec% /D /E:ON /V:OFF /S /C "CALL "{0}""`. | +| Windows | `powershell` | This is the default shell used on Windows. The Desktop PowerShell. {% data variables.product.prodname_dotcom %} appends the extension `.ps1` to your script name. | `powershell -command ". '{0}'"`. | ##### Example running a script using bash @@ -678,7 +674,7 @@ jobs: my_first_job: steps: - name: My first step - uses: actions/hello_world@master + uses: actions/hello_world@main with: first_name: Mona middle_name: The @@ -695,7 +691,7 @@ A `string` that defines the inputs for a Docker container. {% data variables.pro ```yaml steps: - name: Explain why this job ran - uses: monacorp/action-name@master + uses: monacorp/action-name@main with: entrypoint: /bin/echo args: The ${{ github.event_name }} event triggered this step. @@ -708,7 +704,6 @@ The `args` are used in place of the `CMD` instruction in a `Dockerfile`. If you 1. Use defaults that allow using the action without specifying any `args`. 1. If the action exposes a `--help` flag, or something similar, use that as the default to make your action self-documenting. - #### **`jobs..steps.with.entrypoint`** Overrides the Docker `ENTRYPOINT` in the `Dockerfile`, or sets it if one wasn't already specified. Unlike the Docker `ENTRYPOINT` instruction which has a shell and exec form, `entrypoint` keyword accepts only a single string defining the executable to be run. @@ -718,7 +713,7 @@ Overrides the Docker `ENTRYPOINT` in the `Dockerfile`, or sets it if one wasn't ```yaml steps: - name: Run a custom command - uses: monacorp/action-name@master + uses: monacorp/action-name@main with: entrypoint: /a/different/executable ``` @@ -766,7 +761,7 @@ A strategy creates a build matrix for your jobs. You can define different variat You can define a matrix of different job configurations. A matrix allows you to create multiple jobs by performing variable substitution in a single job definition. For example, you can use a matrix to create jobs for more than one supported version of a programming language, operating system, or tool. A matrix reuses the job's configuration and creates a job for each matrix you configure. -{% data reusables.github-actions.matrix-limits %} +{% data reusables.github-actions.usage-matrix-limits %} Each option you define in the `matrix` has a key and value. The keys you define become properties in the `matrix` context and you can reference the property in other areas of your workflow file. For example, if you define the key `os` that contains an array of operating systems, you can use the `matrix.os` property as the value of the `runs-on` keyword to create a job for each operating system. For more information, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)." @@ -843,7 +838,6 @@ strategy: You can use `include` to add new jobs to a build matrix. Any unmatched include configurations are added to the matrix. For example, if you want to use `node` version 12 to build on multiple operating systems, but wanted one extra experimental job using node version 13 on Ubuntu, you can use `include` to specify that additional job. - {% raw %} ```yaml runs-on: ${{ matrix.os }} @@ -952,7 +946,25 @@ jobs: #### **`jobs..container.image`** -The Docker image to use as the container to run the action. The value can be the Docker Hub image name or a public docker registry name. +The Docker image to use as the container to run the action. The value can be the Docker Hub image name or a {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.23" %}public{% endif %} registry name. + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +#### **`jobs..container.credentials`** + +{% data reusables.actions.registry-credentials %} + +##### 예시 + +{% raw %} +```yaml +container: + image: ghcr.io/owner/image + credentials: + username: ${{ github.actor }} + password: ${{ secrets.ghcr_token }} +``` +{% endraw %} +{% endif %} #### **`jobs..container.env`** @@ -1015,19 +1027,43 @@ services: - 6379/tcp ``` -#### **`jobs..services.image`** +#### **`jobs..services..image`** + +The Docker image to use as the service container to run the action. The value can be the Docker Hub image name or a {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.23" %}public{% endif %} registry name. + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +#### **`jobs..services..credentials`** + +{% data reusables.actions.registry-credentials %} + +##### 예시 -The Docker image to use as the service container to run the action. The value can be the Docker base image name or a public docker Hub or registry. +{% raw %} +```yaml +services: + myservice1: + image: ghcr.io/owner/myservice1 + credentials: + username: ${{ github.actor }} + password: ${{ secrets.ghcr_token }} + myservice2: + image: dockerhub_org/myservice2 + credentials: + username: ${{ secrets.DOCKER_USER }} + password: ${{ secrets.DOCKER_PASSWORD }} +``` +{% endraw %} +{% endif %} -#### **`jobs..services.env`** +#### **`jobs..services..env`** Sets a `map` of environment variables in the service container. -#### **`jobs..services.ports`** +#### **`jobs..services..ports`** Sets an `array` of ports to expose on the service container. -#### **`jobs..services.volumes`** +#### **`jobs..services..volumes`** Sets an `array` of volumes for the service container to use. You can use volumes to share data between services or other steps in a job. You can specify named Docker volumes, anonymous Docker volumes, or bind mounts on the host. @@ -1046,7 +1082,7 @@ volumes: - /source/directory:/destination/directory ``` -#### **`jobs..services.options`** +#### **`jobs..services..options`** Additional Docker container resource options. For a list of options, see "[`docker create` options](https://docs.docker.com/engine/reference/commandline/create/#options)." @@ -1076,16 +1112,16 @@ For more information about branch, tag, and path filter syntax, see "[`on.-`feature/your-branch` | -| `feature/**` | The `**` wildcard matches any character including slash (`/`) in branch and tag names. | -`feature/beta-a/my-branch`
    -`feature/your-branch`
    -`feature/mona/the/octocat` | -| -`master`
    -`releases/mona-the-octcat` | Matches the exact name of a branch or tag name. | -`master`
    -`releases/mona-the-octocat` | -| `'*'` | Matches all branch and tag names that don't contain a slash (`/`). The `*` character is a special character in YAML. When you start a pattern with `*`, you must use quotes. | -`master`
    -`releases` | -| `'**'` | Matches all branch and tag names. This is the default behavior when you don't use a `branches` or `tags` filter. | -`all/the/branches`
    -`every/tag` | -| `'*feature'` | The `*` character is a special character in YAML. When you start a pattern with `*`, you must use quotes. | -`mona-feature`
    -`feature`
    -`ver-10-feature` | -| `v2*` | Matches branch and tag names that start with `v2`. | -`v2`
    -`v2.0`
    -`v2.9` | -| `v[12].[0-9]+.[0-9]+` | Matches all semantic versioning tags with major version 1 or 2 | -`v1.10.1`
    -`v2.0.0` | +| Pattern | 설명 | Example matches | +| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | +| `feature/*` | The `*` wildcard matches any character, but does not match slash (`/`). | -`feature/my-branch`
    -`feature/your-branch` | +| `feature/**` | The `**` wildcard matches any character including slash (`/`) in branch and tag names. | -`feature/beta-a/my-branch`
    -`feature/your-branch`
    -`feature/mona/the/octocat` | +| -`main`
    -`releases/mona-the-octcat` | Matches the exact name of a branch or tag name. | -`main`
    -`releases/mona-the-octocat` | +| `'*'` | Matches all branch and tag names that don't contain a slash (`/`). The `*` character is a special character in YAML. When you start a pattern with `*`, you must use quotes. | -`main`
    -`releases` | +| `'**'` | Matches all branch and tag names. This is the default behavior when you don't use a `branches` or `tags` filter. | -`all/the/branches`
    -`every/tag` | +| `'*feature'` | The `*` character is a special character in YAML. When you start a pattern with `*`, you must use quotes. | -`mona-feature`
    -`feature`
    -`ver-10-feature` | +| `v2*` | Matches branch and tag names that start with `v2`. | -`v2`
    -`v2.0`
    -`v2.9` | +| `v[12].[0-9]+.[0-9]+` | Matches all semantic versioning tags with major version 1 or 2 | -`v1.10.1`
    -`v2.0.0` | #### Patterns to match file paths diff --git a/translations/ko-KR/content/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance.md b/translations/ko-KR/content/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance.md index c64cbacf410e..f61c23d45b48 100644 --- a/translations/ko-KR/content/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance.md +++ b/translations/ko-KR/content/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance.md @@ -8,7 +8,6 @@ redirect_from: - /enterprise/admin/guides/migrations/authenticating-users-for-your-github-enterprise-instance/ - /enterprise/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance - /enterprise/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance - - /enterprise/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance mapTopic: true versions: enterprise-server: '*' diff --git a/translations/ko-KR/content/admin/authentication/index.md b/translations/ko-KR/content/admin/authentication/index.md index b49f36a88751..fa91d86c3535 100644 --- a/translations/ko-KR/content/admin/authentication/index.md +++ b/translations/ko-KR/content/admin/authentication/index.md @@ -3,7 +3,6 @@ title: Authentication intro: 'You can use {% data variables.product.prodname_ghe_server %}''s built-in authentication, or choose between CAS, LDAP, or SAML to integrate your existing accounts and centrally manage user access to {% data variables.product.product_location_enterprise %}.' redirect_from: - /enterprise/admin/authentication - - /enterprise/admin/authentication versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/authentication/using-cas.md b/translations/ko-KR/content/admin/authentication/using-cas.md index 7f293bc7dc91..4dcc9529e273 100644 --- a/translations/ko-KR/content/admin/authentication/using-cas.md +++ b/translations/ko-KR/content/admin/authentication/using-cas.md @@ -25,8 +25,8 @@ versions: The following attributes are available. -| Attribute name | 유형 | 설명 | -| -------------- | ----- | --------------------------------------------------------------------- | +| Attribute name | 유형 | 설명 | +| -------------- | ----- | ---------------------------------------------------------------- | | `사용자 이름` | 필수 사항 | The {% data variables.product.prodname_ghe_server %} username. | ### Configuring CAS diff --git a/translations/ko-KR/content/admin/authentication/using-ldap.md b/translations/ko-KR/content/admin/authentication/using-ldap.md index 86a4ba7233fa..7ee7ae3071a0 100644 --- a/translations/ko-KR/content/admin/authentication/using-ldap.md +++ b/translations/ko-KR/content/admin/authentication/using-ldap.md @@ -59,19 +59,19 @@ Use these attributes to finish configuring LDAP for {% data variables.product.pr | Attribute name | 유형 | 설명 | | ------------------------------------------------ | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `Host` | 필수 사항 | The LDAP host, e.g. `ldap.example.com` or `10.0.0.30`. If the hostname is only available from your internal network, you may need to configure {% data variables.product.product_location_enterprise %}'s DNS first so it can resolve the hostname using your internal nameservers. | +| `Host` | 필수 사항 | The LDAP host, e.g. `ldap.example.com` or `10.0.0.30`. If the hostname is only available from your internal network, you may need to configure {% data variables.product.product_location_enterprise %}'s DNS first so it can resolve the hostname using your internal nameservers. | | `Port` | 필수 사항 | The port the host's LDAP services are listening on. Examples include: 389 and 636 (for LDAPS). | | `Encryption` | 필수 사항 | The encryption method used to secure communications to the LDAP server. Examples include plain (no encryption), SSL/LDAPS (encrypted from the start), and StartTLS (upgrade to encrypted communication once connected). | | `Domain search user` | 선택 사항 | The LDAP user that performs user lookups to authenticate other users when they sign in. This is typically a service account created specifically for third-party integrations. Use a fully qualified name, such as `cn=Administrator,cn=Users,dc=Example,dc=com`. With Active Directory, you can also use the `[DOMAIN]\[USERNAME]` syntax (e.g. `WINDOWS\Administrator`) for the domain search user with Active Directory. | | `Domain search password` | 선택 사항 | The password for the domain search user. | | `Administrators group` | 선택 사항 | Users in this group are promoted to site administrators when signing into your appliance. If you don't configure an LDAP Administrators group, the first LDAP user account that signs into your appliance will be automatically promoted to a site administrator. | | `Domain base` | 필수 사항 | The fully qualified `Distinguished Name` (DN) of an LDAP subtree you want to search for users and groups. You can add as many as you like; however, each group must be defined in the same domain base as the users that belong to it. If you specify restricted user groups, only users that belong to those groups will be in scope. We recommend that you specify the top level of your LDAP directory tree as your domain base and use restricted user groups to control access. | -| `Restricted user groups` | 선택 사항 | If specified, only users in these groups will be allowed to log in. You only need to specify the common names (CNs) of the groups, and you can add as many groups as you like. If no groups are specified, *all* users within the scope of the specified domain base will be able to sign in to your {% data variables.product.prodname_ghe_server %} instance. | -| `User ID` | 필수 사항 | The LDAP attribute that identifies the LDAP user who attempts authentication. Once a mapping is established, users may change their {% data variables.product.prodname_ghe_server %} usernames. This field should be `sAMAccountName` for most Active Directory installations, but it may be `uid` for other LDAP solutions, such as OpenLDAP. The default value is `uid`. | -| `Profile name` | 선택 사항 | The name that will appear on the user's {% data variables.product.prodname_ghe_server %} profile page. Unless LDAP Sync is enabled, users may change their profile names. | -| `Emails` | 선택 사항 | The email addresses for a user's {% data variables.product.prodname_ghe_server %} account. | -| `SSH keys` | 선택 사항 | The public SSH keys attached to a user's {% data variables.product.prodname_ghe_server %} account. The keys must be in OpenSSH format. | -| `GPG keys` | 선택 사항 | The GPG keys attached to a user's {% data variables.product.prodname_ghe_server %} account. | +| `Restricted user groups` | 선택 사항 | If specified, only users in these groups will be allowed to log in. You only need to specify the common names (CNs) of the groups, and you can add as many groups as you like. If no groups are specified, *all* users within the scope of the specified domain base will be able to sign in to your {% data variables.product.prodname_ghe_server %} instance. | +| `User ID` | 필수 사항 | The LDAP attribute that identifies the LDAP user who attempts authentication. Once a mapping is established, users may change their {% data variables.product.prodname_ghe_server %} usernames. This field should be `sAMAccountName` for most Active Directory installations, but it may be `uid` for other LDAP solutions, such as OpenLDAP. The default value is `uid`. | +| `Profile name` | 선택 사항 | The name that will appear on the user's {% data variables.product.prodname_ghe_server %} profile page. Unless LDAP Sync is enabled, users may change their profile names. | +| `Emails` | 선택 사항 | The email addresses for a user's {% data variables.product.prodname_ghe_server %} account. | +| `SSH keys` | 선택 사항 | The public SSH keys attached to a user's {% data variables.product.prodname_ghe_server %} account. The keys must be in OpenSSH format. | +| `GPG keys` | 선택 사항 | The GPG keys attached to a user's {% data variables.product.prodname_ghe_server %} account. | | `Disable LDAP authentication for Git operations` | 선택 사항 | If selected, [turns off](#disabling-password-authentication-for-git-operations) users' ability to use LDAP passwords to authenticate Git operations. | | `Enable LDAP certificate verification` | 선택 사항 | If selected, [turns on](#enabling-ldap-certificate-verification) LDAP certificate verification. | | `Synchronization` | 선택 사항 | If selected, [turns on](#enabling-ldap-sync) LDAP Sync. | @@ -97,6 +97,12 @@ When this option is selected, the certificate is validated to make sure: #### Enabling LDAP Sync +{% note %} + +**Note:** Teams using LDAP Sync are limited to a maximum 1499 members. + +{% endnote %} + LDAP Sync lets you synchronize {% data variables.product.prodname_ghe_server %} users and team membership against your established LDAP groups. This lets you establish role-based access control for users from your LDAP server instead of manually within {% data variables.product.prodname_ghe_server %}. For more information, see "[Creating teams](/enterprise/{{ currentVersion }}/admin/guides/user-management/creating-teams#creating-teams-with-ldap-sync-enabled)." To enable LDAP Sync, in your LDAP settings, select **Synchronize Emails**, **Synchronize SSH Keys**, or **Synchronize GPG Keys** . diff --git a/translations/ko-KR/content/admin/authentication/using-saml.md b/translations/ko-KR/content/admin/authentication/using-saml.md index 1d4de918ebdf..645bc99f3526 100644 --- a/translations/ko-KR/content/admin/authentication/using-saml.md +++ b/translations/ko-KR/content/admin/authentication/using-saml.md @@ -54,15 +54,15 @@ To configure your identity provider manually, the Assertion Consumer Service (AC These attributes are available. You can change the attribute names in the [management console](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-management-console/), with the exception of the `administrator` attribute. -| Default attribute name | 유형 | 설명 | -| ---------------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Default attribute name | 유형 | 설명 | +| ---------------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `NameID` | 필수 사항 | A persistent user identifier. Any persistent name identifier format may be used. The `NameID` element will be used for a {% data variables.product.prodname_ghe_server %} username unless one of the alternative assertions is provided. | -| `관리자` | 선택 사항 | When the value is 'true', the user will automatically be promoted as an administrator. Any other value or a non-existent value will demote the user to a normal user account. | +| `관리자` | 선택 사항 | When the value is 'true', the user will automatically be promoted as an administrator. Any other value or a non-existent value will demote the user to a normal user account. | | `사용자 이름` | 선택 사항 | The {% data variables.product.prodname_ghe_server %} username. | -| `full_name` | 선택 사항 | The name of the user displayed on their profile page. Users may change their names after provisioning. | -| `emails` | 선택 사항 | The email addresses for the user. More than one can be specified. | -| `public_keys` | 선택 사항 | The public SSH keys for the user. More than one can be specified. | -| `gpg_keys` | 선택 사항 | The GPG keys for the user. More than one can be specified. | +| `full_name` | 선택 사항 | The name of the user displayed on their profile page. Users may change their names after provisioning. | +| `emails` | 선택 사항 | The email addresses for the user. More than one can be specified. | +| `public_keys` | 선택 사항 | The public SSH keys for the user. More than one can be specified. | +| `gpg_keys` | 선택 사항 | The GPG keys for the user. More than one can be specified. | ### Configuring SAML settings diff --git a/translations/ko-KR/content/admin/configuration/accessing-the-management-console.md b/translations/ko-KR/content/admin/configuration/accessing-the-management-console.md index 41cbc60fbe43..d37b78b44a65 100644 --- a/translations/ko-KR/content/admin/configuration/accessing-the-management-console.md +++ b/translations/ko-KR/content/admin/configuration/accessing-the-management-console.md @@ -10,7 +10,6 @@ redirect_from: - /enterprise/admin/guides/installation/web-based-management-console/ - /enterprise/admin/installation/accessing-the-management-console - /enterprise/admin/configuration/accessing-the-management-console - - /enterprise/admin/configuration/accessing-the-management-console versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/configuration/command-line-utilities.md b/translations/ko-KR/content/admin/configuration/command-line-utilities.md index 862deb3a25a3..3ba1ca586a90 100644 --- a/translations/ko-KR/content/admin/configuration/command-line-utilities.md +++ b/translations/ko-KR/content/admin/configuration/command-line-utilities.md @@ -20,7 +20,8 @@ You can execute these commands from anywhere on the VM after signing in as an SS This utility sets a banner at the top of every {% data variables.product.prodname_enterprise %} page. You can use it to broadcast a message to your users. {% if currentVersion ver_gt "enterprise-server@2.21" %} -You can also set an announcement banner using the enterprise settings on {% data variables.product.product_name %}. For more information, see "[Customizing user messages on your instance](/enterprise/admin/user-management/customizing-user-messages-on-your-instance#creating-a-global-announcement-banner)." +You can also set an announcement banner using the enterprise settings on +{% data variables.product.product_name %}. For more information, see "[Customizing user messages on your instance](/enterprise/admin/user-management/customizing-user-messages-on-your-instance#creating-a-global-announcement-banner)." {% endif %} ```shell @@ -181,7 +182,6 @@ This utility allows you to control the state of the installation's maintenance m ghe-maintenance -h ``` -{% if currentVersion ver_gt "enterprise-server@2.17" %} #### ghe-motd This utility re-displays the message of the day (MOTD) that administrators see when accessing the instance via the administrative shell. The output contains an overview of the instance's state. @@ -189,7 +189,6 @@ This utility re-displays the message of the day (MOTD) that administrators see w ```shell ghe-motd ``` -{% endif %} #### ghe-nwo diff --git a/translations/ko-KR/content/admin/configuration/configuring-advanced-security-features.md b/translations/ko-KR/content/admin/configuration/configuring-advanced-security-features.md index 5965b8d0413b..e9a8a1113feb 100644 --- a/translations/ko-KR/content/admin/configuration/configuring-advanced-security-features.md +++ b/translations/ko-KR/content/admin/configuration/configuring-advanced-security-features.md @@ -5,8 +5,6 @@ intro: 'You can enable or disable {% data variables.product.prodname_advanced_se mapTopic: true redirect_from: - /enterprise/admin/configuration/configuring-advanced-security-features - - /enterprise/admin/configuration/configuring-advanced-security-features - - /enterprise/admin/configuration/configuring-advanced-security-features versions: enterprise-server: '>=2.22' --- diff --git a/translations/ko-KR/content/admin/configuration/configuring-applications.md b/translations/ko-KR/content/admin/configuration/configuring-applications.md index 9f566f192bbd..509c9228078f 100644 --- a/translations/ko-KR/content/admin/configuration/configuring-applications.md +++ b/translations/ko-KR/content/admin/configuration/configuring-applications.md @@ -15,5 +15,7 @@ You can choose the amount of time that {% data variables.product.product_locatio {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} 3. In the left sidebar, click **Applications**. ![Applications tab in the settings sidebar](/assets/images/enterprise/management-console/sidebar-applications.png) -4. Under "Avatar image cache time (seconds)", type the number of seconds that you would like {% data variables.product.product_location_enterprise %} to cache avatar images. ![Avatar image caching form field](/assets/images/enterprise/management-console/add-image-caching-value-field.png) +4. Under "Avatar image cache time (seconds)", type the number of seconds that you would like +{% data variables.product.product_location_enterprise %} to cache avatar images. +![Avatar image caching form field](/assets/images/enterprise/management-console/add-image-caching-value-field.png) {% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/ko-KR/content/admin/configuration/configuring-built-in-firewall-rules.md b/translations/ko-KR/content/admin/configuration/configuring-built-in-firewall-rules.md index bd982372e809..0b98a22cfe6d 100644 --- a/translations/ko-KR/content/admin/configuration/configuring-built-in-firewall-rules.md +++ b/translations/ko-KR/content/admin/configuration/configuring-built-in-firewall-rules.md @@ -5,7 +5,6 @@ redirect_from: - /enterprise/admin/guides/installation/configuring-firewall-settings/ - /enterprise/admin/installation/configuring-built-in-firewall-rules - /enterprise/admin/configuration/configuring-built-in-firewall-rules - - /enterprise/admin/configuration/configuring-built-in-firewall-rules versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/configuration/configuring-code-scanning-for-your-appliance.md b/translations/ko-KR/content/admin/configuration/configuring-code-scanning-for-your-appliance.md index a3dc3d136945..700e2a95021e 100644 --- a/translations/ko-KR/content/admin/configuration/configuring-code-scanning-for-your-appliance.md +++ b/translations/ko-KR/content/admin/configuration/configuring-code-scanning-for-your-appliance.md @@ -37,7 +37,9 @@ If you can't see **{% data variables.product.prodname_advanced_security %}** in {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_management_console.advanced-security-tab %} -1. Under "{% data variables.product.prodname_advanced_security %}," click **{% data variables.product.prodname_code_scanning_capc %}**. ![Checkbox to enable or disable {% data variables.product.prodname_code_scanning %}](/assets/images/enterprise/management-console/enable-code-scanning-checkbox.png) +1. Under " +{% data variables.product.prodname_advanced_security %}," click **{% data variables.product.prodname_code_scanning_capc %}**. +![Checkbox to enable or disable {% data variables.product.prodname_code_scanning %}](/assets/images/enterprise/management-console/enable-code-scanning-checkbox.png) {% data reusables.enterprise_management_console.save-settings %} @@ -47,6 +49,8 @@ If you can't see **{% data variables.product.prodname_advanced_security %}** in If you are enrolled in the {% data variables.product.prodname_actions %} beta, then {% data variables.product.prodname_ghe_server %} can run {% data variables.product.prodname_code_scanning %} using a {% data variables.product.prodname_actions %} workflow. First, you need to provision one or more self-hosted {% data variables.product.prodname_actions %} runners in your environment. You can provision self-hosted runners at the repository, organization, or enterprise account level. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners)" and "[Adding self-hosted runners](/actions/hosting-your-own-runners/adding-self-hosted-runners)." +You must ensure that Git is in the PATH variable on any self-hosted runners you use to run {% data variables.product.prodname_codeql %} actions. + #### Provisioning the action To run {% data variables.product.prodname_code_scanning %} on {% data variables.product.prodname_ghe_server %} with {% data variables.product.prodname_actions %}, the appropriate action must be available locally. You can make the action available in three ways. @@ -67,7 +71,7 @@ After you configure a self-hosted runner, users can enable {% data variables.pro ### Running {% data variables.product.prodname_code_scanning %} using the {% data variables.product.prodname_codeql_runner %} If your organization isn't taking part in the beta for {% data variables.product.prodname_actions %}, or if you don't want to use {% data variables.product.prodname_actions %}, you can run {% data variables.product.prodname_code_scanning %} using the {% data variables.product.prodname_codeql_runner %}. -The {% data variables.product.prodname_codeql_runner %} is a command-line tool that you can add to your third-party CI/CD system. The tool runs {% data variables.product.prodname_codeql %} analysis on a checkout of a {% data variables.product.prodname_dotcom %} repository. For more information, see "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)." +The {% data variables.product.prodname_codeql_runner %} is a command-line tool that you can add to your third-party CI/CD system. The tool runs {% data variables.product.prodname_codeql %} analysis on a checkout of a {% data variables.product.prodname_dotcom %} repository. For more information, see "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)." ### Disabling {% data variables.product.prodname_code_scanning %} @@ -76,5 +80,7 @@ The {% data variables.product.prodname_codeql_runner %} is a command-line tool t {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_management_console.advanced-security-tab %} -1. Under "{% data variables.product.prodname_advanced_security %}", unselect **{% data variables.product.prodname_code_scanning_capc %}**. ![Checkbox to enable or disable {% data variables.product.prodname_code_scanning %}](/assets/images/enterprise/management-console/code-scanning-disable.png) +1. Under " +{% data variables.product.prodname_advanced_security %}", unselect **{% data variables.product.prodname_code_scanning_capc %}**. +![Checkbox to enable or disable {% data variables.product.prodname_code_scanning %}](/assets/images/enterprise/management-console/code-scanning-disable.png) {% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/ko-KR/content/admin/configuration/configuring-dns-nameservers.md b/translations/ko-KR/content/admin/configuration/configuring-dns-nameservers.md index b6182e6506e4..6856350548b7 100644 --- a/translations/ko-KR/content/admin/configuration/configuring-dns-nameservers.md +++ b/translations/ko-KR/content/admin/configuration/configuring-dns-nameservers.md @@ -5,7 +5,6 @@ redirect_from: - /enterprise/admin/guides/installation/about-dns-nameservers/ - /enterprise/admin/installation/configuring-dns-nameservers - /enterprise/admin/configuration/configuring-dns-nameservers - - /enterprise/admin/configuration/configuring-dns-nameservers versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/configuration/configuring-network-settings.md b/translations/ko-KR/content/admin/configuration/configuring-network-settings.md index e2219e777495..b5d7abf7e09d 100644 --- a/translations/ko-KR/content/admin/configuration/configuring-network-settings.md +++ b/translations/ko-KR/content/admin/configuration/configuring-network-settings.md @@ -7,7 +7,6 @@ redirect_from: - /enterprise/admin/guides/installation/configuring-your-github-enterprise-network-settings/ - /enterprise/admin/installation/configuring-your-github-enterprise-server-network-settings - /enterprise/admin/configuration/configuring-network-settings - - /enterprise/admin/configuration/configuring-network-settings intro: 'Configure {% data variables.product.prodname_ghe_server %} with the DNS nameservers and hostname required in your network. You can also configure a proxy server or firewall rules. You must allow access to certain ports for administrative and user purposes.' mapTopic: true versions: diff --git a/translations/ko-KR/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md b/translations/ko-KR/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md index cb03ae1d0c42..d6bdc45deec3 100644 --- a/translations/ko-KR/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md +++ b/translations/ko-KR/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md @@ -8,7 +8,15 @@ versions: enterprise-server: '*' --- +{% note %} + +**Note:** We do not support adding additional network adapters to {% data variables.product.prodname_ghe_server %}. + +{% endnote %} + {% data reusables.enterprise_installation.open-vm-console-start %} 3. Choose to configure the `IPv4` or `IPv6` protocol. ![Options to choose the IPv4 or the IPv6 protocol](/assets/images/enterprise/network-configuration/IPv4-or-IPv6-protocol.png) 4. Configure options for the protocol you chose. ![Menu with IP protocol options](/assets/images/enterprise/network-configuration/network-settings-selection.png) {% data reusables.enterprise_installation.vm-console-done %} + + diff --git a/translations/ko-KR/content/admin/configuration/configuring-your-enterprise.md b/translations/ko-KR/content/admin/configuration/configuring-your-enterprise.md index 26fe1adf5452..74b50d6c1bc9 100644 --- a/translations/ko-KR/content/admin/configuration/configuring-your-enterprise.md +++ b/translations/ko-KR/content/admin/configuration/configuring-your-enterprise.md @@ -8,7 +8,6 @@ redirect_from: - /enterprise/admin/guides/installation/configuring-the-github-enterprise-appliance/ - /enterprise/admin/installation/configuring-the-github-enterprise-server-appliance - /enterprise/admin/configuration/configuring-your-enterprise - - /enterprise/admin/configuration/configuring-your-enterprise mapTopic: true versions: enterprise-server: '*' diff --git a/translations/ko-KR/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md b/translations/ko-KR/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md index 85343e6e182c..8991c993c050 100644 --- a/translations/ko-KR/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md +++ b/translations/ko-KR/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md @@ -37,12 +37,12 @@ Enabling {% data variables.product.prodname_github_connect %} also creates a {% Enabling {% data variables.product.prodname_github_connect %} will not allow {% data variables.product.prodname_dotcom_the_website %} users to make changes to {% data variables.product.prodname_ghe_server %}. -{% if currentVersion ver_gt "enterprise-server@2.18" %} For more information about managing enterprise accounts using the GraphQL API, see "[Enterprise accounts](/v4/guides/managing-enterprise-accounts)." -{% endif %} ### Enabling {% data variables.product.prodname_github_connect %} -1. Sign in to {% data variables.product.product_location_enterprise %} and {% data variables.product.prodname_dotcom_the_website %}. +1. Sign in to + +{% data variables.product.product_location_enterprise %} and {% data variables.product.prodname_dotcom_the_website %}. {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.settings-tab %} diff --git a/translations/ko-KR/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md b/translations/ko-KR/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md index e70faee9ff8e..f6a08240e304 100644 --- a/translations/ko-KR/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md +++ b/translations/ko-KR/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md @@ -45,7 +45,8 @@ Before enabling {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data v ``` shell $ ghe-dep-graph-enable ``` -3. Return to {% data variables.product.prodname_ghe_server %}. +3. Return to +{% data variables.product.prodname_ghe_server %}. {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.settings-tab %} diff --git a/translations/ko-KR/content/admin/configuration/enabling-subdomain-isolation.md b/translations/ko-KR/content/admin/configuration/enabling-subdomain-isolation.md index c9cbdac28135..4d52dc01a49f 100644 --- a/translations/ko-KR/content/admin/configuration/enabling-subdomain-isolation.md +++ b/translations/ko-KR/content/admin/configuration/enabling-subdomain-isolation.md @@ -16,28 +16,29 @@ Subdomain isolation mitigates cross-site scripting and other related vulnerabili When subdomain isolation is enabled, {% data variables.product.prodname_ghe_server %} replaces several paths with subdomains. {% if currentVersion ver_gt "enterprise-server@2.21" %} -To use Docker with {% data variables.product.prodname_registry %}, you must also enable subdomain isolation. For more information, see "[Configuring Docker for use with {% data variables.product.prodname_registry %}](/enterprise/{{ currentVersion }}/user/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)." +To use Docker with +{% data variables.product.prodname_registry %}, you must also enable subdomain isolation. For more information, see "[Configuring Docker for use with {% data variables.product.prodname_registry %}](/enterprise/{{ currentVersion }}/user/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)." {% data reusables.package_registry.packages-ghes-release-stage %} | {% endif %} -| Path without subdomain isolation | Path with subdomain isolation | -| --------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- | -| `http(s)://HOSTNAME/assets/` | `http(s)://assets.HOSTNAME/` | -| `http(s)://HOSTNAME/avatars/` | `http(s)://avatars.HOSTNAME/` | -| `http(s)://HOSTNAME/codeload/` | `http(s)://codeload.HOSTNAME/` | -| `http(s)://HOSTNAME/gist/` | `http(s)://gist.HOSTNAME/` | -| `http(s)://HOSTNAME/media/` | `http(s)://media.HOSTNAME/` | -| `http(s)://HOSTNAME/pages/` | `http(s)://pages.HOSTNAME/` | -| `http(s)://HOSTNAME/raw/` | `http(s)://raw.HOSTNAME/` | -| `http(s)://HOSTNAME/render/` | `http(s)://render.HOSTNAME/` | -| `http(s)://HOSTNAME/reply/` | `http(s)://reply.HOSTNAME/` | -| `http(s)://HOSTNAME/uploads/` | `http(s)://uploads.HOSTNAME/` |{% if currentVersion ver_gt "enterprise-server@2.21" %} -| N/A, Docker with {% data variables.product.prodname_registry %} will not work with subdomain isolation disabled. | `http(s)://docker.HOSTNAME/` | -| `https://HOSTNAME/_registry/npm/` | `https://npm.HOSTNAME/` | -| `https://HOSTNAME/_registry/rubygems/` | `https://rubygems.HOSTNAME/` | -| `https://HOSTNAME/_registry/maven/` | `https://maven.HOSTNAME/` | -| `https://HOSTNAME/_registry/nuget/` | `https://nuget.HOSTNAME/`{% endif %} +| Path without subdomain isolation | Path with subdomain isolation | +| ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | +| `http(s)://HOSTNAME/assets/` | `http(s)://assets.HOSTNAME/` | +| `http(s)://HOSTNAME/avatars/` | `http(s)://avatars.HOSTNAME/` | +| `http(s)://HOSTNAME/codeload/` | `http(s)://codeload.HOSTNAME/` | +| `http(s)://HOSTNAME/gist/` | `http(s)://gist.HOSTNAME/` | +| `http(s)://HOSTNAME/media/` | `http(s)://media.HOSTNAME/` | +| `http(s)://HOSTNAME/pages/` | `http(s)://pages.HOSTNAME/` | +| `http(s)://HOSTNAME/raw/` | `http(s)://raw.HOSTNAME/` | +| `http(s)://HOSTNAME/render/` | `http(s)://render.HOSTNAME/` | +| `http(s)://HOSTNAME/reply/` | `http(s)://reply.HOSTNAME/` | +| `http(s)://HOSTNAME/uploads/` | `http(s)://uploads.HOSTNAME/` |{% if currentVersion ver_gt "enterprise-server@2.21" %} +| N/A, Docker with {% data variables.product.prodname_registry %} will not work with subdomain isolation disabled. | `http(s)://docker.HOSTNAME/` | +| `https://HOSTNAME/_registry/npm/` | `https://npm.HOSTNAME/` | +| `https://HOSTNAME/_registry/rubygems/` | `https://rubygems.HOSTNAME/` | +| `https://HOSTNAME/_registry/maven/` | `https://maven.HOSTNAME/` | +| `https://HOSTNAME/_registry/nuget/` | `https://nuget.HOSTNAME/`{% endif %} ### 빌드전 요구 사양 diff --git a/translations/ko-KR/content/admin/configuration/index.md b/translations/ko-KR/content/admin/configuration/index.md index 1d77c5902de5..2e8a92d9f8a8 100644 --- a/translations/ko-KR/content/admin/configuration/index.md +++ b/translations/ko-KR/content/admin/configuration/index.md @@ -4,7 +4,6 @@ shortTitle: Configuring GitHub Enterprise intro: 'Once {% data variables.product.prodname_ghe_server %} is installed and set up, you can configure the appliance to suit your organization''s needs.' redirect_from: - /enterprise/admin/configuration - - /enterprise/admin/configuration versions: enterprise-server: '*' --- @@ -41,7 +40,7 @@ versions: {% topic_link_in_list /managing-connections-between-github-enterprise-server-and-github-enterprise-cloud %} {% link_in_list /connecting-github-enterprise-server-to-github-enterprise-cloud %} {% link_in_list /enabling-unified-search-between-github-enterprise-server-and-githubcom %} - {% link_in_list /enabling-unified-contributions-between-github-enterprise-server-and-githubcom %} + {% link_in_list /enabling-unified-contributions-between-github-enterprise-server-and-githubcom %} {% link_in_list /enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server %} {% link_in_list /enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud %} @@ -50,3 +49,11 @@ versions: {% topic_link_in_list /configuring-advanced-security-features %} {% link_in_list /configuring-code-scanning-for-your-appliance %} + +{% if currentVersion ver_gt "enterprise-server@2.21" %} +{% note %} + +**Note:** To configure {% data variables.product.prodname_actions %} or {% data variables.product.prodname_registry %} for your enterprise, see "[Managing GitHub Actions for your enterprise](/admin/github-actions)" or "[Managing GitHub Packages for your enterprise](/admin/packages)." + +{% endnote %} +{% endif %} diff --git a/translations/ko-KR/content/admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md b/translations/ko-KR/content/admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md index b77a7c500d8d..63e4e25bee0e 100644 --- a/translations/ko-KR/content/admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md +++ b/translations/ko-KR/content/admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md @@ -9,7 +9,6 @@ redirect_from: - /enterprise/admin/developer-workflow/connecting-github-enterprise-server-and-githubcom/ - /enterprise/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud - /enterprise/admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud - - /enterprise/admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/configuration/network-ports.md b/translations/ko-KR/content/admin/configuration/network-ports.md index 285f131242b9..22f72ad75da7 100644 --- a/translations/ko-KR/content/admin/configuration/network-ports.md +++ b/translations/ko-KR/content/admin/configuration/network-ports.md @@ -16,25 +16,25 @@ versions: Some administrative ports are required to configure {% data variables.product.product_location_enterprise %} and run certain features. Administrative ports are not required for basic application use by end users. -| Port | Service | 설명 | -| -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Port | Service | 설명 | +| -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 8443 | HTTPS | Secure web-based {% data variables.enterprise.management_console %}. Required for basic installation and configuration. | | 8080 | HTTP | Plain-text web-based {% data variables.enterprise.management_console %}. Not required unless SSL is disabled manually. | | 122 | SSH | Shell access for {% data variables.product.product_location_enterprise %}. Required to be open to incoming connections from all other nodes in a High Availability configuration. The default SSH port (22) is dedicated to Git and SSH application network traffic. | -| 1194/UDP | VPN | Secure replication network tunnel in High Availability configuration. Required to be open to all other nodes in the configuration. | -| 123/UDP | NTP | Required for time protocol operation. | -| 161/UDP | SNMP | Required for network monitoring protocol operation. | +| 1194/UDP | VPN | Secure replication network tunnel in High Availability configuration. Required to be open to all other nodes in the configuration. | +| 123/UDP | NTP | Required for time protocol operation. | +| 161/UDP | SNMP | Required for network monitoring protocol operation. | ### Application ports for end users Application ports provide web application and Git access for end users. -| Port | Service | 설명 | -| ---- | ------- | -------------------------------------------------------------------------------------------------------------------- | -| 443 | HTTPS | Access to the web application and Git over HTTPS. | -| 80 | HTTP | Access to the web application. All requests are redirected to the HTTPS port when SSL is enabled. | -| 22 | SSH | Access to Git over SSH. Supports clone, fetch, and push operations to public and private repositories. | -| 9418 | Git | Git protocol port supports clone and fetch operations to public repositories with unencrypted network communication. | +| Port | Service | 설명 | +| ---- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 443 | HTTPS | Access to the web application and Git over HTTPS. | +| 80 | HTTP | Access to the web application. All requests are redirected to the HTTPS port when SSL is enabled. | +| 22 | SSH | Access to Git over SSH. Supports clone, fetch, and push operations to public and private repositories. | +| 9418 | Git | Git protocol port supports clone and fetch operations to public repositories with unencrypted network communication. {% data reusables.enterprise_installation.when-9418-necessary %} {% data reusables.enterprise_installation.terminating-tls %} diff --git a/translations/ko-KR/content/admin/configuration/troubleshooting-ssl-errors.md b/translations/ko-KR/content/admin/configuration/troubleshooting-ssl-errors.md index 742c8d5945e3..98c2bf418f44 100644 --- a/translations/ko-KR/content/admin/configuration/troubleshooting-ssl-errors.md +++ b/translations/ko-KR/content/admin/configuration/troubleshooting-ssl-errors.md @@ -6,7 +6,6 @@ redirect_from: - /enterprise/admin/categories/dns-ssl-and-subdomain-configuration/ - /enterprise/admin/installation/troubleshooting-ssl-errors - /enterprise/admin/configuration/troubleshooting-ssl-errors - - /enterprise/admin/configuration/troubleshooting-ssl-errors versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/enterprise-management/about-clustering.md b/translations/ko-KR/content/admin/enterprise-management/about-clustering.md index 2fdcd8e6c1fc..ee94eff1e93c 100644 --- a/translations/ko-KR/content/admin/enterprise-management/about-clustering.md +++ b/translations/ko-KR/content/admin/enterprise-management/about-clustering.md @@ -6,7 +6,6 @@ redirect_from: - /enterprise/admin/clustering/about-clustering - /enterprise/admin/clustering/clustering-overview/ - /enterprise/admin/enterprise-management/about-clustering - - /enterprise/admin/enterprise-management/about-clustering versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/enterprise-management/about-geo-replication.md b/translations/ko-KR/content/admin/enterprise-management/about-geo-replication.md index a6356ed8beb8..573d0fa1252b 100644 --- a/translations/ko-KR/content/admin/enterprise-management/about-geo-replication.md +++ b/translations/ko-KR/content/admin/enterprise-management/about-geo-replication.md @@ -18,7 +18,7 @@ Geo DNS, such as [Amazon's Route 53 service](http://docs.aws.amazon.com/Route53/ ### 제한 사항 -Writing requests to the replica requires sending the data to the primary and all replicas. This means that the performance of all writes are limited by the slowest replica{% if currentVersion ver_gt "enterprise-server@2.17" %}, although new geo-replicas can seed the majority of their data from existing co-located geo-replicas, rather than from the primary{% endif %}. Geo-replication will not add capacity to a {% data variables.product.prodname_ghe_server %} instance or solve performance issues related to insufficient CPU or memory resources. If the primary appliance is offline, active replicas will be unable to serve any read or write requests. +Writing requests to the replica requires sending the data to the primary and all replicas. This means that the performance of all writes are limited by the slowest replica, although new geo-replicas can seed the majority of their data from existing co-located geo-replicas, rather than from the primary. Geo-replication will not add capacity to a {% data variables.product.prodname_ghe_server %} instance or solve performance issues related to insufficient CPU or memory resources. If the primary appliance is offline, active replicas will be unable to serve any read or write requests. ### Monitoring a geo-replication configuration diff --git a/translations/ko-KR/content/admin/enterprise-management/about-high-availability-configuration.md b/translations/ko-KR/content/admin/enterprise-management/about-high-availability-configuration.md index 1f5b2f3fd579..61a2810daf0e 100644 --- a/translations/ko-KR/content/admin/enterprise-management/about-high-availability-configuration.md +++ b/translations/ko-KR/content/admin/enterprise-management/about-high-availability-configuration.md @@ -52,7 +52,7 @@ To manage replication on {% data variables.product.prodname_ghe_server %}, use t The `ghe-repl-setup` command puts a {% data variables.product.prodname_ghe_server %} appliance in replica standby mode. - - An encrypted {% if currentVersion ver_gt "enterprise-server@2.17" %}WireGuard VPN{% else %}OpenVPN{% endif %} tunnel is configured for communication between the two appliances. + - An encrypted WireGuard VPN tunnel is configured for communication between the two appliances. - Database services are configured for replication and started. - Application services are disabled. Attempts to access the replica appliance over HTTP, Git, or other supported protocols will result in an "appliance in replica mode" maintenance page or error message. @@ -71,8 +71,7 @@ Run `ghe-repl-start' to start replicating against the newly configured primary. The `ghe-repl-start` command turns on active replication of all datastores. ```shell -admin@169-254-1-2:~$ ghe-repl-start{% if currentVersion ver_lt "enterprise-server@2.18" %} -Starting OpenVPN tunnel ... {% endif %} +admin@169-254-1-2:~$ ghe-repl-start Starting MySQL replication ... Starting Redis replication ... Starting Elasticsearch replication ... @@ -144,8 +143,7 @@ Stopping Pages replication ... Stopping Git replication ... Stopping MySQL replication ... Stopping Redis replication ... -Stopping Elasticsearch replication ...{% if currentVersion ver_lt "enterprise-server@2.18" %} -Stopping OpenVPN tunnel ...{% endif %} +Stopping Elasticsearch replication ... Success: replication was stopped for all services. ``` @@ -163,8 +161,7 @@ Stopping replication ... | Stopping Git replication ... | Stopping MySQL replication ... | Stopping Redis replication ... - | Stopping Elasticsearch replication ...{% if currentVersion ver_lt "enterprise-server@2.18" %} - | Stopping OpenVPN tunnel ...{% endif %} + | Stopping Elasticsearch replication ... | Success: replication was stopped for all services. Switching out of replica mode ... | Success: Replication configuration has been removed. diff --git a/translations/ko-KR/content/admin/enterprise-management/accessing-the-monitor-dashboard.md b/translations/ko-KR/content/admin/enterprise-management/accessing-the-monitor-dashboard.md index c97b178945bb..3b2cd2829c94 100644 --- a/translations/ko-KR/content/admin/enterprise-management/accessing-the-monitor-dashboard.md +++ b/translations/ko-KR/content/admin/enterprise-management/accessing-the-monitor-dashboard.md @@ -24,10 +24,10 @@ versions: Use the monitor dashboard to stay informed on your appliance's resource health and make decisions on how to fix high usage issues. -| Problem | Possible cause(s) | Recommendations | -| -------------------------------- | ---------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| High CPU usage | VM contention from other services or programs running on the same host | If possible, reconfigure other services or programs to use fewer CPU resources. To increase total CPU resources for the VM, see "[Increasing CPU or memory resources](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)." | -| High memory usage | VM contention from other services or programs running on the same host | If possible, reconfigure other services or programs to use less memory. To increase the total memory available on the VM, see "[Increasing CPU or memory resources](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)." | -| Low disk space availability | Large binaries or log files consuming disk space | If possible, host large binaries on a separate server, and compress or archive log files. If necessary, increase disk space on the VM by following the steps for your platform in "[Increasing storage capacity](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity/)." | -| Higher than usual response times | Often caused by one of the above issues | Identify and fix the underlying issues. If response times remain high, contact {% data variables.contact.contact_ent_support %}. | +| Problem | Possible cause(s) | Recommendations | +| -------------------------------- | ---------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| High CPU usage | VM contention from other services or programs running on the same host | If possible, reconfigure other services or programs to use fewer CPU resources. To increase total CPU resources for the VM, see "[Increasing CPU or memory resources](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)." | +| High memory usage | VM contention from other services or programs running on the same host | If possible, reconfigure other services or programs to use less memory. To increase the total memory available on the VM, see "[Increasing CPU or memory resources](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)." | +| Low disk space availability | Large binaries or log files consuming disk space | If possible, host large binaries on a separate server, and compress or archive log files. If necessary, increase disk space on the VM by following the steps for your platform in "[Increasing storage capacity](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity/)." | +| Higher than usual response times | Often caused by one of the above issues | Identify and fix the underlying issues. If response times remain high, contact {% data variables.contact.contact_ent_support %}. | | Elevated error rates | Software issues | Contact {% data variables.contact.contact_ent_support %} and include your support bundle. For more information, see "[Providing data to {% data variables.product.prodname_enterprise %} Support](/enterprise/{{ currentVersion}}/admin/guides/enterprise-support/providing-data-to-github-support#creating-and-sharing-support-bundles)." | diff --git a/translations/ko-KR/content/admin/enterprise-management/cluster-network-configuration.md b/translations/ko-KR/content/admin/enterprise-management/cluster-network-configuration.md index 6ea4c9e4edf6..88b61a188ea0 100644 --- a/translations/ko-KR/content/admin/enterprise-management/cluster-network-configuration.md +++ b/translations/ko-KR/content/admin/enterprise-management/cluster-network-configuration.md @@ -71,7 +71,6 @@ If a network level firewall is in place between nodes, these ports will need to | 8302/UDP | Consul | | 25827/UDP | Collectd | - ### Configuring a load balancer We recommend an external TCP-based load balancer that supports the PROXY protocol to distribute traffic across nodes. Consider these load balancer configurations: diff --git a/translations/ko-KR/content/admin/enterprise-management/configuring-clustering.md b/translations/ko-KR/content/admin/enterprise-management/configuring-clustering.md index 1677842778df..6fc9f34af1ac 100644 --- a/translations/ko-KR/content/admin/enterprise-management/configuring-clustering.md +++ b/translations/ko-KR/content/admin/enterprise-management/configuring-clustering.md @@ -6,7 +6,6 @@ redirect_from: - /enterprise/admin/clustering/managing-a-github-enterprise-server-cluster - /enterprise/admin/guides/clustering/managing-a-github-enterprise-cluster/ - /enterprise/admin/enterprise-management/configuring-clustering - - /enterprise/admin/enterprise-management/configuring-clustering mapTopic: true versions: enterprise-server: '*' diff --git a/translations/ko-KR/content/admin/enterprise-management/configuring-high-availability.md b/translations/ko-KR/content/admin/enterprise-management/configuring-high-availability.md index fbf537e0b8fe..84b7b0ae9f98 100644 --- a/translations/ko-KR/content/admin/enterprise-management/configuring-high-availability.md +++ b/translations/ko-KR/content/admin/enterprise-management/configuring-high-availability.md @@ -6,7 +6,6 @@ redirect_from: - /enterprise/admin/guides/installation/high-availability-configuration/ - /enterprise/admin/guides/installation/configuring-github-enterprise-for-high-availability/ - /enterprise/admin/enterprise-management/configuring-high-availability - - /enterprise/admin/enterprise-management/configuring-high-availability intro: '{% data variables.product.prodname_ghe_server %} supports a high availability mode of operation designed to minimize service disruption in the event of hardware failure or major network outage affecting the primary appliance.' mapTopic: true versions: diff --git a/translations/ko-KR/content/admin/enterprise-management/creating-a-high-availability-replica.md b/translations/ko-KR/content/admin/enterprise-management/creating-a-high-availability-replica.md index a9c5fc02d873..d34ccee97fd1 100644 --- a/translations/ko-KR/content/admin/enterprise-management/creating-a-high-availability-replica.md +++ b/translations/ko-KR/content/admin/enterprise-management/creating-a-high-availability-replica.md @@ -49,7 +49,7 @@ This example configuration uses a primary and two replicas, which are located in (replica2)$ ghe-repl-setup --add PRIMARY IP (replica2)$ ghe-repl-start ``` -3. By default, replicas are configured to the same datacenter{% if currentVersion ver_gt "enterprise-server@2.17" %}, and will now attempt to seed from an existing node in the same datacenter{% endif %}. Configure the replicas for different datacenters by setting a different value for the datacenter option. The specific values can be anything you would like as long as they are different from each other. Run the `ghe-repl-node` command on each node and specify the datacenter. +3. By default, replicas are configured to the same datacenter, and will now attempt to seed from an existing node in the same datacenter. Configure the replicas for different datacenters by setting a different value for the datacenter option. The specific values can be anything you would like as long as they are different from each other. Run the `ghe-repl-node` command on each node and specify the datacenter. On the primary: ```shell diff --git a/translations/ko-KR/content/admin/enterprise-management/increasing-storage-capacity.md b/translations/ko-KR/content/admin/enterprise-management/increasing-storage-capacity.md index d055dcfbab8c..ece10c6a71a9 100644 --- a/translations/ko-KR/content/admin/enterprise-management/increasing-storage-capacity.md +++ b/translations/ko-KR/content/admin/enterprise-management/increasing-storage-capacity.md @@ -4,7 +4,6 @@ intro: 'You can increase or change the amount of storage available for Git repos redirect_from: - /enterprise/admin/installation/increasing-storage-capacity - /enterprise/admin/enterprise-management/increasing-storage-capacity - - /enterprise/admin/enterprise-management/increasing-storage-capacity versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/enterprise-management/index.md b/translations/ko-KR/content/admin/enterprise-management/index.md index 22ae8971c07a..d53041ef94fe 100644 --- a/translations/ko-KR/content/admin/enterprise-management/index.md +++ b/translations/ko-KR/content/admin/enterprise-management/index.md @@ -3,9 +3,6 @@ title: 'Monitoring, managing, and updating your enterprise' intro: 'You can monitor your appliance, upgrade to a newer version, and configure clustering or high availability' redirect_from: - /enterprise/admin/enterprise-management - - /enterprise/admin/enterprise-management - - /enterprise/admin/enterprise-management - - /enterprise/admin/enterprise-management versions: enterprise-server: '*' --- @@ -19,8 +16,7 @@ versions: {% link_in_list /setting-up-external-monitoring %} {% link_in_list /configuring-collectd %} {% link_in_list /log-forwarding %} - {% link_in_list /monitoring-using-snmp %}{% if currentVersion ver_gt "enterprise-server@2.21" %} - {% link_in_list /monitoring-using-analytics %}{% endif %} + {% link_in_list /monitoring-using-snmp %} {% topic_link_in_list /updating-the-virtual-machine-and-physical-resources %} {% link_in_list /upgrade-requirements %} {% link_in_list /upgrading-github-enterprise-server %} diff --git a/translations/ko-KR/content/admin/enterprise-management/initializing-the-cluster.md b/translations/ko-KR/content/admin/enterprise-management/initializing-the-cluster.md index e0bf15b8b20a..0fdc22d211ed 100644 --- a/translations/ko-KR/content/admin/enterprise-management/initializing-the-cluster.md +++ b/translations/ko-KR/content/admin/enterprise-management/initializing-the-cluster.md @@ -17,7 +17,7 @@ versions: ### Configuring the first node -1. Connect to the node that will be designated as the `mysql-master` in `cluster.conf`. For more information, see “[About the cluster configuration file](/enterprise/{{ currentVersion }}/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)." +1. Connect to the node that will be designated as MySQL primary in `cluster.conf`. For more information, see "[About the cluster configuration file](/enterprise/{{ currentVersion }}/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)." 2. In your web browser, visit `https://:8443/setup/`. {% data reusables.enterprise_installation.upload-a-license-file %} {% data reusables.enterprise_installation.save-settings-in-web-based-mgmt-console %} @@ -43,7 +43,7 @@ This example `cluster.conf` defines a cluster with five nodes. The names of the nodes can be any valid hostname you choose. The names are set as the hostname of each node, and will also be added to `/etc/hosts` on each node, so that the nodes are locally resolvable to each other. -Specify the first cluster node you configured as the MySQL master via `mysql-server` and `mysql-master`. +Specify the first cluster node you configured as the MySQL primary via `mysql-server` and `mysql-master`. ``` [cluster] diff --git a/translations/ko-KR/content/admin/enterprise-management/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md b/translations/ko-KR/content/admin/enterprise-management/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md index 6eabc6f410b0..caaf1d320091 100644 --- a/translations/ko-KR/content/admin/enterprise-management/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md +++ b/translations/ko-KR/content/admin/enterprise-management/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md @@ -6,7 +6,6 @@ redirect_from: - /enterprise/admin/guides/installation/migrating-elasticsearch-indices-to-github-enterprise-2-14-or-later/ - /enterprise/admin/guides/installation/migrating-elasticsearch-indices-to-github-enterprise-server-2-14-or-later - /enterprise/admin/enterprise-management/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later - - /enterprise/admin/enterprise-management/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/enterprise-management/monitoring-your-appliance.md b/translations/ko-KR/content/admin/enterprise-management/monitoring-your-appliance.md index 8394ba4be0b6..4e995c9f6266 100644 --- a/translations/ko-KR/content/admin/enterprise-management/monitoring-your-appliance.md +++ b/translations/ko-KR/content/admin/enterprise-management/monitoring-your-appliance.md @@ -6,7 +6,6 @@ redirect_from: - /enterprise/admin/guides/installation/monitoring-your-github-enterprise-appliance/ - /enterprise/admin/installation/monitoring-your-github-enterprise-server-appliance - /enterprise/admin/enterprise-management/monitoring-your-appliance - - /enterprise/admin/enterprise-management/monitoring-your-appliance mapTopic: true versions: enterprise-server: '*' diff --git a/translations/ko-KR/content/admin/enterprise-management/removing-a-high-availability-replica.md b/translations/ko-KR/content/admin/enterprise-management/removing-a-high-availability-replica.md index 9696b97a8d5f..a5c633d5c3ef 100644 --- a/translations/ko-KR/content/admin/enterprise-management/removing-a-high-availability-replica.md +++ b/translations/ko-KR/content/admin/enterprise-management/removing-a-high-availability-replica.md @@ -4,7 +4,6 @@ intro: 'You can stop replication to a {% data variables.product.prodname_ghe_ser redirect_from: - /enterprise/admin/installation/removing-a-high-availability-replica - /enterprise/admin/enterprise-management/removing-a-high-availability-replica - - /enterprise/admin/enterprise-management/removing-a-high-availability-replica versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/enterprise-management/replacing-a-cluster-node.md b/translations/ko-KR/content/admin/enterprise-management/replacing-a-cluster-node.md index 0b875d91efef..4dde19d03866 100644 --- a/translations/ko-KR/content/admin/enterprise-management/replacing-a-cluster-node.md +++ b/translations/ko-KR/content/admin/enterprise-management/replacing-a-cluster-node.md @@ -4,7 +4,6 @@ intro: 'To replace a {% data variables.product.prodname_ghe_server %} node, you redirect_from: - /enterprise/admin/clustering/replacing-a-cluster-node - /enterprise/admin/enterprise-management/replacing-a-cluster-node - - /enterprise/admin/enterprise-management/replacing-a-cluster-node versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/enterprise-management/setting-up-external-monitoring.md b/translations/ko-KR/content/admin/enterprise-management/setting-up-external-monitoring.md index 47ee773985bb..f0163ff946e8 100644 --- a/translations/ko-KR/content/admin/enterprise-management/setting-up-external-monitoring.md +++ b/translations/ko-KR/content/admin/enterprise-management/setting-up-external-monitoring.md @@ -4,7 +4,6 @@ intro: 'You can monitor basic system resources on your {% data variables.product redirect_from: - /enterprise/admin/installation/setting-up-external-monitoring - /enterprise/admin/enterprise-management/setting-up-external-monitoring - - /enterprise/admin/enterprise-management/setting-up-external-monitoring versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources.md b/translations/ko-KR/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources.md index 75b0b2f2f42c..3c590160d033 100644 --- a/translations/ko-KR/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources.md +++ b/translations/ko-KR/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources.md @@ -6,7 +6,6 @@ redirect_from: - '/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-physical-resources/' - /enterprise/admin/installation/updating-the-virtual-machine-and-physical-resources - /enterprise/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources - - /enterprise/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources mapTopic: true versions: enterprise-server: '*' diff --git a/translations/ko-KR/content/admin/enterprise-support/about-support-for-advanced-security.md b/translations/ko-KR/content/admin/enterprise-support/about-support-for-advanced-security.md index 4340a20fd1a0..c55070a9cf44 100644 --- a/translations/ko-KR/content/admin/enterprise-support/about-support-for-advanced-security.md +++ b/translations/ko-KR/content/admin/enterprise-support/about-support-for-advanced-security.md @@ -70,8 +70,8 @@ When you contact {% data variables.contact.enterprise_support %} for help with { {% data reusables.support.github-can-modify-ticket-priority %} -| Priority | 설명 | -|:------------------------------------------------------------------:| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Priority | 설명 | +|:-------------------------------------------------------------:| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | {% data variables.product.support_ticket_priority_high %} | {% data variables.product.prodname_advanced_security %} is not functioning or is stopped or severely impacted such that the end user cannot reasonably continue use of the software and no workaround is available. | | {% data variables.product.support_ticket_priority_normal %} | {% data variables.product.prodname_advanced_security %} is functioning inconsistently, causing impaired end user usage and productivity. | | {% data variables.product.support_ticket_priority_low %} | {% data variables.product.prodname_advanced_security %} is functioning consistently, but the end user requests minor changes in the software, such as documentation updates, cosmetic defects, or enhancements. | diff --git a/translations/ko-KR/content/admin/enterprise-support/index.md b/translations/ko-KR/content/admin/enterprise-support/index.md index c445f19ca9ad..a66aab840af2 100644 --- a/translations/ko-KR/content/admin/enterprise-support/index.md +++ b/translations/ko-KR/content/admin/enterprise-support/index.md @@ -3,7 +3,6 @@ title: 'Working with {% data variables.contact.github_support %}' intro: 'Learn how to open a ticket and provide the {% data variables.contact.enterprise_support %} team with the information they need to resolve your issues.' redirect_from: - /enterprise/admin/enterprise-support - - /enterprise/admin/enterprise-support versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/enterprise-support/preparing-to-submit-a-ticket.md b/translations/ko-KR/content/admin/enterprise-support/preparing-to-submit-a-ticket.md index 109eaa203974..6edfaf7b3325 100644 --- a/translations/ko-KR/content/admin/enterprise-support/preparing-to-submit-a-ticket.md +++ b/translations/ko-KR/content/admin/enterprise-support/preparing-to-submit-a-ticket.md @@ -3,7 +3,6 @@ title: Preparing to submit a ticket intro: 'Help {% data variables.contact.github_support %} help you faster by following these suggestions before you open a support ticket.' redirect_from: - /enterprise/admin/enterprise-support/preparing-to-submit-a-ticket - - /enterprise/admin/enterprise-support/preparing-to-submit-a-ticket versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/enterprise-support/receiving-help-from-github-support.md b/translations/ko-KR/content/admin/enterprise-support/receiving-help-from-github-support.md index 0e3c677a395b..37b9633376ad 100644 --- a/translations/ko-KR/content/admin/enterprise-support/receiving-help-from-github-support.md +++ b/translations/ko-KR/content/admin/enterprise-support/receiving-help-from-github-support.md @@ -4,7 +4,6 @@ intro: 'If you run into trouble with {% data variables.product.product_location_ redirect_from: - /enterprise/admin/guides/enterprise-support/receiving-help-from-github-enterprise-support/ - /enterprise/admin/enterprise-support/receiving-help-from-github-support - - /enterprise/admin/enterprise-support/receiving-help-from-github-support mapTopic: true versions: enterprise-server: '*' diff --git a/translations/ko-KR/content/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server.md b/translations/ko-KR/content/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server.md index 2f8a4a6e6489..5c89f88a10d3 100644 --- a/translations/ko-KR/content/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server.md +++ b/translations/ko-KR/content/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server.md @@ -3,9 +3,6 @@ title: About using GitHub.com actions on GitHub Enterprise Server intro: '{% data variables.product.prodname_ghe_server %} includes most {% data variables.product.prodname_dotcom %}-authored actions, and has options for enabling access to other actions from {% data variables.product.prodname_dotcom_the_website %} and {% data variables.product.prodname_marketplace %}.' redirect_from: - /enterprise/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server - - /enterprise/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server - - /enterprise/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server - - /enterprise/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server versions: enterprise-server: '>=2.22' --- diff --git a/translations/ko-KR/content/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise.md b/translations/ko-KR/content/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise.md index 6085d1bc3494..0ad89a74ace7 100644 --- a/translations/ko-KR/content/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise.md +++ b/translations/ko-KR/content/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise.md @@ -3,8 +3,6 @@ title: Enforcing GitHub Actions policies for your enterprise intro: 'Enterprise administrators can manage access to {% data variables.product.prodname_actions %} in an enterprise.' redirect_from: - /enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise - - /enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise - - /enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise versions: enterprise-server: '>=2.22' --- diff --git a/translations/ko-KR/content/admin/github-actions/index.md b/translations/ko-KR/content/admin/github-actions/index.md index 4ac8f58e613c..2202fdb4d4ce 100644 --- a/translations/ko-KR/content/admin/github-actions/index.md +++ b/translations/ko-KR/content/admin/github-actions/index.md @@ -3,7 +3,6 @@ title: Managing GitHub Actions for your enterprise intro: 'Enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %}, and manage {% data variables.product.prodname_actions %} policies and settings.' redirect_from: - /enterprise/admin/github-actions - - /enterprise/admin/github-actions versions: enterprise-server: '>=2.22' --- diff --git a/translations/ko-KR/content/admin/github-actions/managing-access-to-actions-from-githubcom.md b/translations/ko-KR/content/admin/github-actions/managing-access-to-actions-from-githubcom.md index b61e474cb717..51d601c89f2e 100644 --- a/translations/ko-KR/content/admin/github-actions/managing-access-to-actions-from-githubcom.md +++ b/translations/ko-KR/content/admin/github-actions/managing-access-to-actions-from-githubcom.md @@ -4,9 +4,6 @@ intro: 'Controlling which actions on {% data variables.product.prodname_dotcom_t mapTopic: true redirect_from: - /enterprise/admin/github-actions/managing-access-to-actions-from-githubcom - - /enterprise/admin/github-actions/managing-access-to-actions-from-githubcom - - /enterprise/admin/github-actions/managing-access-to-actions-from-githubcom - - /enterprise/admin/github-actions/managing-access-to-actions-from-githubcom versions: enterprise-server: '>=2.22' --- diff --git a/translations/ko-KR/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md b/translations/ko-KR/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md index c96fc5761206..c17404e32c4a 100644 --- a/translations/ko-KR/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md +++ b/translations/ko-KR/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md @@ -69,7 +69,7 @@ You can populate the runner tool cache by running a {% data variables.product.pr path: ${{runner.tool_cache}}/tool_cache.tar.gz ``` {% endraw %} -1. Download the tool cache artifact from the workflow run. For instructions on downloading artifacts, see "[Persisting workflow data using artifacts](/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts#downloading-and-deleting-artifacts-after-a-workflow-run-is-complete)." +1. Download the tool cache artifact from the workflow run. For instructions on downloading artifacts, see "[Downloading workflow artifacts](/actions/managing-workflow-runs/downloading-workflow-artifacts)." 1. Transfer the tool cache artifact to your self hosted runner and extract it to the local tool cache directory. The default tool cache directory is `RUNNER_DIR/_work/_tool`. If the runner hasn't processed any jobs yet, you might need to create the `_work/_tool` directories. After extracting the tool cache artifact uploaded in the above example, you should have a directory structure on your self-hosted runner that is similar to the following example: diff --git a/translations/ko-KR/content/admin/index.md b/translations/ko-KR/content/admin/index.md index 89ddaf480d6e..dfbcb7a9914d 100644 --- a/translations/ko-KR/content/admin/index.md +++ b/translations/ko-KR/content/admin/index.md @@ -3,7 +3,6 @@ title: Enterprise Administrators redirect_from: - /enterprise/admin/hidden/migrating-from-github-fi/ - /enterprise/admin - - /enterprise/admin intro: 'Step-by-step guides for organizational administrators, system administrators, and security specialists who are deploying, configuring, and managing a GitHub Enterprise instance.' versions: enterprise-server: '*' diff --git a/translations/ko-KR/content/admin/installation/index.md b/translations/ko-KR/content/admin/installation/index.md index ab62d5ccd6db..ca489927cc7f 100644 --- a/translations/ko-KR/content/admin/installation/index.md +++ b/translations/ko-KR/content/admin/installation/index.md @@ -9,7 +9,6 @@ redirect_from: - /enterprise/admin/categories/general/ - /enterprise/admin/categories/logging-and-monitoring/ - /enterprise/admin/installation - - /enterprise/admin/installation versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md b/translations/ko-KR/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md index 73d620e0d78a..33ca918b2254 100644 --- a/translations/ko-KR/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md +++ b/translations/ko-KR/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md @@ -24,7 +24,8 @@ Before launching {% data variables.product.product_location_enterprise %} on Goo #### Supported machine types -{% data variables.product.prodname_ghe_server %} is supported on the following Google Compute Engine (GCE) machine types. For more information, see [the Google Cloud Platform machine types article](https://cloud.google.com/compute/docs/machine-types). | +{% data variables.product.prodname_ghe_server %} is supported on the following Google Compute Engine (GCE) machine types. For more information, see [the Google Cloud Platform machine types article](https://cloud.google.com/compute/docs/machine-types). +| {% if currentVersion != "free-pro-team@latest" %} | | High-memory | | | ------------- | diff --git a/translations/ko-KR/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md b/translations/ko-KR/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md index fbdaa9fc0204..d2b0e62f3dcb 100644 --- a/translations/ko-KR/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md +++ b/translations/ko-KR/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md @@ -29,7 +29,9 @@ versions: {% data reusables.enterprise_installation.create-ghe-instance %} -1. In OpenStack Horizon, upload the {% data variables.product.prodname_ghe_server %} image you downloaded. For instructions, see the "Upload an image" section of the OpenStack guide "[Upload and manage images](https://docs.openstack.org/horizon/latest/user/manage-images.html)." +1. In OpenStack Horizon, upload the + +{% data variables.product.prodname_ghe_server %} image you downloaded. For instructions, see the "Upload an image" section of the OpenStack guide "[Upload and manage images](https://docs.openstack.org/horizon/latest/user/manage-images.html)." {% data reusables.enterprise_installation.create-attached-storage-volume %} For instructions, see the OpenStack guide "[Create and manage volumes](https://docs.openstack.org/horizon/latest/user/manage-volumes.html)." 3. Create a security group, and add a new security group rule for each port in the table below. For instructions, see the OpenStack guide "[Configure access and security for instances](https://docs.openstack.org/horizon/latest/user/configure-access-and-security-for-instances.html)." diff --git a/translations/ko-KR/content/admin/installation/setting-up-a-github-enterprise-server-instance.md b/translations/ko-KR/content/admin/installation/setting-up-a-github-enterprise-server-instance.md index 36ece8c7bc66..92a5f510c953 100644 --- a/translations/ko-KR/content/admin/installation/setting-up-a-github-enterprise-server-instance.md +++ b/translations/ko-KR/content/admin/installation/setting-up-a-github-enterprise-server-instance.md @@ -7,7 +7,6 @@ redirect_from: - /enterprise/admin/guides/installation/provisioning-and-installation/ - /enterprise/admin/guides/installation/setting-up-a-github-enterprise-instance/ - /enterprise/admin/installation/setting-up-a-github-enterprise-server-instance - - /enterprise/admin/installation/setting-up-a-github-enterprise-server-instance mapTopic: true versions: enterprise-server: '*' diff --git a/translations/ko-KR/content/admin/overview/about-enterprise-accounts.md b/translations/ko-KR/content/admin/overview/about-enterprise-accounts.md index 0baee8e39aa7..3d1804f81f01 100644 --- a/translations/ko-KR/content/admin/overview/about-enterprise-accounts.md +++ b/translations/ko-KR/content/admin/overview/about-enterprise-accounts.md @@ -4,7 +4,6 @@ intro: 'With {% data variables.product.prodname_ghe_server %}, you can create an redirect_from: - /enterprise/admin/installation/about-enterprise-accounts - /enterprise/admin/overview/about-enterprise-accounts - - /enterprise/admin/overview/about-enterprise-accounts versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/overview/about-the-github-enterprise-server-api.md b/translations/ko-KR/content/admin/overview/about-the-github-enterprise-server-api.md index 632e69d5c16f..fc6293a2b034 100644 --- a/translations/ko-KR/content/admin/overview/about-the-github-enterprise-server-api.md +++ b/translations/ko-KR/content/admin/overview/about-the-github-enterprise-server-api.md @@ -7,7 +7,6 @@ redirect_from: - /enterprise/admin/articles/using-the-api/ - /enterprise/admin/categories/api/ - /enterprise/admin/overview/about-the-github-enterprise-server-api - - /enterprise/admin/overview/about-the-github-enterprise-server-api versions: enterprise-server: '*' --- @@ -16,5 +15,5 @@ For the complete documentation for {% data variables.product.prodname_enterprise - Perform changes to the {% data variables.enterprise.management_console %}. For more information, see "[{% data variables.enterprise.management_console %}](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#management-console)." - Collect statistics about your instance. For more information, see "[Admin stats](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#admin-stats)." -- Configure LDAP sync. For more information, see "[LDAP](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#ldap)."{% if currentVersion ver_gt "enterprise-server@2.18" %} -- Manage your enterprise account. For more information, see "[Enterprise accounts](/v4/guides/managing-enterprise-accounts)."{% endif %} +- Configure LDAP sync. For more information, see "[LDAP](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#ldap)." +- Manage your enterprise account. For more information, see "[Enterprise accounts](/v4/guides/managing-enterprise-accounts)." diff --git a/translations/ko-KR/content/admin/overview/managing-your-github-enterprise-license.md b/translations/ko-KR/content/admin/overview/managing-your-github-enterprise-license.md index 34fc94e59d9c..a35377b399b2 100644 --- a/translations/ko-KR/content/admin/overview/managing-your-github-enterprise-license.md +++ b/translations/ko-KR/content/admin/overview/managing-your-github-enterprise-license.md @@ -34,7 +34,8 @@ If you'd like to renew or add user licenses to {% data variables.product.prodnam {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.enterprise-licensing-tab %} 4. Under "Enterprise Server Instances", click {% octicon "download" aria-label="The download icon" %} to download your license file. ![Download GitHub Enterprise Server license](/assets/images/help/business-accounts/download-ghes-license.png) -5. Log into your {% data variables.product.prodname_ghe_server %} instance as a site administrator. +5. Log into your +{% data variables.product.prodname_ghe_server %} instance as a site administrator. {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.settings-tab %} @@ -63,7 +64,8 @@ You can download a JSON file from {% data variables.product.prodname_ghe_server {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.license-tab %} 5. Under "Quick links", to download a file containing your current license usage on {% data variables.product.prodname_ghe_server %}, click **Export license usage**. ![Export license usage link](/assets/images/enterprise/business-accounts/export-license-usage-link.png) -6. Navigate to {% data variables.product.prodname_ghe_cloud %}. +6. Navigate to +{% data variables.product.prodname_ghe_cloud %}. {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.enterprise-licensing-tab %} diff --git a/translations/ko-KR/content/admin/packages/configuring-packages-support-for-your-enterprise.md b/translations/ko-KR/content/admin/packages/configuring-packages-support-for-your-enterprise.md index 671f18184721..027addf08824 100644 --- a/translations/ko-KR/content/admin/packages/configuring-packages-support-for-your-enterprise.md +++ b/translations/ko-KR/content/admin/packages/configuring-packages-support-for-your-enterprise.md @@ -3,8 +3,6 @@ title: Configuring packages support for your enterprise intro: 'You can configure {% data variables.product.prodname_registry %} for your enterprise by enabling or disabling each package ecosystem.' redirect_from: - /enterprise/admin/packages/configuring-packages-support-for-your-enterprise - - /enterprise/admin/packages/configuring-packages-support-for-your-enterprise - - /enterprise/admin/packages/configuring-packages-support-for-your-enterprise versions: enterprise-server: '>=2.22' --- diff --git a/translations/ko-KR/content/admin/packages/configuring-third-party-storage-for-packages.md b/translations/ko-KR/content/admin/packages/configuring-third-party-storage-for-packages.md index 430a0d158cd5..f3dfd6acb5b1 100644 --- a/translations/ko-KR/content/admin/packages/configuring-third-party-storage-for-packages.md +++ b/translations/ko-KR/content/admin/packages/configuring-third-party-storage-for-packages.md @@ -3,8 +3,6 @@ title: Configuring third-party storage for packages intro: 'You can configure the third-party service that {% data variables.product.prodname_registry %} uses to store your enterprise''s packages.' redirect_from: - /enterprise/admin/packages/configuring-third-party-storage-for-packages - - /enterprise/admin/packages/configuring-third-party-storage-for-packages - - /enterprise/admin/packages/configuring-third-party-storage-for-packages versions: enterprise-server: '>=2.22' --- diff --git a/translations/ko-KR/content/admin/packages/enabling-github-packages-for-your-enterprise.md b/translations/ko-KR/content/admin/packages/enabling-github-packages-for-your-enterprise.md index af7895633331..55856d7cb0a0 100644 --- a/translations/ko-KR/content/admin/packages/enabling-github-packages-for-your-enterprise.md +++ b/translations/ko-KR/content/admin/packages/enabling-github-packages-for-your-enterprise.md @@ -3,10 +3,6 @@ title: Enabling GitHub Packages for your enterprise intro: 'You can start using {% data variables.product.prodname_registry %} on your instance by enabling the feature, configuring third-party storage, configuring the ecosystems you want to support, and updating your TLS certificate.' redirect_from: - /enterprise/admin/packages/enabling-github-packages-for-your-enterprise - - /enterprise/admin/packages/enabling-github-packages-for-your-enterprise - - /enterprise/admin/packages/enabling-github-packages-for-your-enterprise - - /enterprise/admin/packages/enabling-github-packages-for-your-enterprise - - /enterprise/admin/packages/enabling-github-packages-for-your-enterprise versions: enterprise-server: '>=2.22' --- diff --git a/translations/ko-KR/content/admin/packages/index.md b/translations/ko-KR/content/admin/packages/index.md index 98f825bb8d53..d677721898a2 100644 --- a/translations/ko-KR/content/admin/packages/index.md +++ b/translations/ko-KR/content/admin/packages/index.md @@ -4,8 +4,6 @@ shortTitle: GitHub Packages intro: 'You can enable {% data variables.product.prodname_registry %} for your enterprise and manage {% data variables.product.prodname_registry %} settings and allowed packaged types.' redirect_from: - /enterprise/admin/packages - - /enterprise/admin/packages - - /enterprise/admin/packages versions: enterprise-server: '>=2.22' --- diff --git a/translations/ko-KR/content/admin/policies/about-pre-receive-hooks.md b/translations/ko-KR/content/admin/policies/about-pre-receive-hooks.md index 8dedd2a70709..d8087d8b9f14 100644 --- a/translations/ko-KR/content/admin/policies/about-pre-receive-hooks.md +++ b/translations/ko-KR/content/admin/policies/about-pre-receive-hooks.md @@ -4,7 +4,6 @@ intro: '*Pre-receive hooks* are scripts that run on the {% data variables.produc redirect_from: - /enterprise/admin/developer-workflow/about-pre-receive-hooks - /enterprise/admin/policies/about-pre-receive-hooks - - /enterprise/admin/policies/about-pre-receive-hooks versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/policies/creating-a-pre-receive-hook-script.md b/translations/ko-KR/content/admin/policies/creating-a-pre-receive-hook-script.md index 8898a567ccbd..8b51c575dae7 100644 --- a/translations/ko-KR/content/admin/policies/creating-a-pre-receive-hook-script.md +++ b/translations/ko-KR/content/admin/policies/creating-a-pre-receive-hook-script.md @@ -182,7 +182,7 @@ You can test a pre-receive hook script locally before you create or update it on $ git clone git@github.com:octocat/Hello-World.git $ cd Hello-World $ git remote add test git@127.0.0.1:test.git - $ GIT_SSH_COMMAND="ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no -p 52311 -i ../id_rsa" git push -u test master + $ GIT_SSH_COMMAND="ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no -p 52311 -i ../id_rsa" git push -u test main > Warning: Permanently added '[192.168.99.100]:52311' (ECDSA) to the list of known hosts. > Counting objects: 7, done. > Delta compression using up to 4 threads. @@ -191,7 +191,7 @@ You can test a pre-receive hook script locally before you create or update it on > Total 7 (delta 0), reused 7 (delta 0) > remote: error: rejecting all pushes > To git@192.168.99.100:test.git - > ! [remote rejected] master -> master (pre-receive hook declined) + > ! [remote rejected] main -> main (pre-receive hook declined) > error: failed to push some refs to 'git@192.168.99.100:test.git' ``` diff --git a/translations/ko-KR/content/admin/policies/enforcing-policies-for-your-enterprise.md b/translations/ko-KR/content/admin/policies/enforcing-policies-for-your-enterprise.md index 800249b6863f..6d8a1b6daf81 100644 --- a/translations/ko-KR/content/admin/policies/enforcing-policies-for-your-enterprise.md +++ b/translations/ko-KR/content/admin/policies/enforcing-policies-for-your-enterprise.md @@ -3,9 +3,6 @@ title: Enforcing policies for your enterprise mapTopic: true redirect_from: - /enterprise/admin/policies/enforcing-policies-for-your-enterprise - - /enterprise/admin/policies/enforcing-policies-for-your-enterprise - - /enterprise/admin/policies/enforcing-policies-for-your-enterprise - - /enterprise/admin/policies/enforcing-policies-for-your-enterprise versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/policies/enforcing-policy-with-pre-receive-hooks.md b/translations/ko-KR/content/admin/policies/enforcing-policy-with-pre-receive-hooks.md index 4950227a035a..49c8daec918b 100644 --- a/translations/ko-KR/content/admin/policies/enforcing-policy-with-pre-receive-hooks.md +++ b/translations/ko-KR/content/admin/policies/enforcing-policy-with-pre-receive-hooks.md @@ -5,7 +5,6 @@ mapTopic: true redirect_from: - /enterprise/admin/developer-workflow/using-pre-receive-hooks-to-enforce-policy - /enterprise/admin/policies/enforcing-policy-with-pre-receive-hooks - - /enterprise/admin/policies/enforcing-policy-with-pre-receive-hooks versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md b/translations/ko-KR/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md index 983d300e5ff8..221f3cbb62d3 100644 --- a/translations/ko-KR/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md +++ b/translations/ko-KR/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md @@ -39,7 +39,7 @@ If a site administrator disallows members from creating certain types of reposit **Tip:** You can restrict the ability to change repository visibility to site administrators only. For more information, see "[Preventing users from changing a repository's visibility](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-a-repository-s-visibility)." -{% endnote %} +{% endtip %} {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} @@ -216,4 +216,3 @@ If necessary, you can prevent repository administrators from changing anonymous 7. Review the changes. To confirm, click **Yes, enable anonymous Git read access.** ![Confirm anonymous Git read access setting in pop-up window](/assets/images/enterprise/site-admin-settings/confirm-anonymous-git-read-access-for-specific-repo-as-site-admin.png) 8. Optionally, to prevent repository admins from changing this setting for this repository, select **Prevent repository admins from changing anonymous Git read access**. ![Select checkbox to prevent repository admins from changing anonymous Git read access for this repository](/assets/images/enterprise/site-admin-settings/lock_anonymous_git_access_for_specific_repo.png) - diff --git a/translations/ko-KR/content/admin/policies/index.md b/translations/ko-KR/content/admin/policies/index.md index e514e9e80b73..6dc11872c9b3 100644 --- a/translations/ko-KR/content/admin/policies/index.md +++ b/translations/ko-KR/content/admin/policies/index.md @@ -4,7 +4,6 @@ intro: 'You can set policies in {% data variables.product.prodname_enterprise %} redirect_from: - /enterprise/admin/developer-workflow - /enterprise/admin/policies - - /enterprise/admin/policies versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/user-management/adding-people-to-teams.md b/translations/ko-KR/content/admin/user-management/adding-people-to-teams.md index dd5e4748dd1c..0f174951a8b2 100644 --- a/translations/ko-KR/content/admin/user-management/adding-people-to-teams.md +++ b/translations/ko-KR/content/admin/user-management/adding-people-to-teams.md @@ -5,7 +5,6 @@ redirect_from: - /enterprise/admin/articles/adding-or-inviting-people-to-teams/ - /enterprise/admin/guides/user-management/adding-or-inviting-people-to-teams/ - /enterprise/admin/user-management/adding-people-to-teams - - /enterprise/admin/user-management/adding-people-to-teams intro: 'Once a team has been created, organization admins can add users from {% data variables.product.product_location_enterprise %} to the team and determine which repositories they have access to.' versions: enterprise-server: '*' diff --git a/translations/ko-KR/content/admin/user-management/audit-logging.md b/translations/ko-KR/content/admin/user-management/audit-logging.md index 7a20960129ae..5ada53f2b8e0 100644 --- a/translations/ko-KR/content/admin/user-management/audit-logging.md +++ b/translations/ko-KR/content/admin/user-management/audit-logging.md @@ -5,7 +5,6 @@ redirect_from: - /enterprise/admin/articles/audit-logging/ - /enterprise/admin/installation/audit-logging - /enterprise/admin/user-management/audit-logging - - /enterprise/admin/user-management/audit-logging versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/user-management/audited-actions.md b/translations/ko-KR/content/admin/user-management/audited-actions.md index 9a86d8499bb9..56ef062b80e3 100644 --- a/translations/ko-KR/content/admin/user-management/audited-actions.md +++ b/translations/ko-KR/content/admin/user-management/audited-actions.md @@ -35,8 +35,8 @@ versions: #### Instance configuration settings -| 이름 | 설명 | -| -------------------------------------------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 이름 | 설명 | +| -------------------------------------------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `business.update_member_repository_creation_permission` | A site admin restricts repository creation in organizations on the instance. For more information, see "[Restricting repository creation in your instance](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)." | | `business.clear_members_can_create_repos` | A site admin clears a restriction on repository creation in organizations on the instance. For more information, see "[Restricting repository creation in your instance](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)." | | `enterprise.config.lock_anonymous_git_access` | A site admin locks anonymous Git read access to prevent repository admins from changing existing anonymous Git read access settings for repositories on the instance. For more information, see "[Preventing users from changing anonymous Git read access](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)." | @@ -44,19 +44,19 @@ versions: #### Issues and pull requests -| 이름 | 설명 | -| ------------------------------------:| ---------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `issue.update` | An issue's body text (initial comment) changed. | -| `issue_comment.update` | A comment on an issue (other than the initial one) changed. | -| `pull_request_review_comment.delete` | A comment on a pull request was deleted. | +| 이름 | 설명 | +| ------------------------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `issue.update` | An issue's body text (initial comment) changed. | +| `issue_comment.update` | A comment on an issue (other than the initial one) changed. | +| `pull_request_review_comment.delete` | A comment on a pull request was deleted. | | `issue.destroy` | An issue was deleted from the repository. For more information, see "[Deleting an issue](/enterprise/{{ currentVersion }}/user/articles/deleting-an-issue)." | #### Organizations -| 이름 | 설명 | -| ------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `org.async_delete` | A user initiated a background job to delete an organization. | -| `org.delete` | An organization was deleted by a user-initiated background job. | +| 이름 | 설명 | +| ------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `org.async_delete` | A user initiated a background job to delete an organization. | +| `org.delete` | An organization was deleted by a user-initiated background job. | | `org.transform` | A user account was converted into an organization. For more information, see [Converting a user into an organization](/enterprise/{{ currentVersion}}/user/articles/converting-a-user-into-an-organization/). | #### Protected branches @@ -76,18 +76,18 @@ versions: #### Repositories -| 이름 | 설명 | -| ------------------------------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `repo.access` | A private repository was made public, or a public repository was made private. | +| 이름 | 설명 | +| ------------------------------------------:| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `repo.access` | A private repository was made public, or a public repository was made private. | | `repo.archive` | A repository was archived. For more information, see [Archiving and unarchiving repositories](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/). | -| `repo.add_member` | A collaborator was added to a repository. | +| `repo.add_member` | A collaborator was added to a repository. | | `repo.config` | A site admin blocked force pushes. For more information, see [Blocking force pushes to a repository](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository/) to a repository. | -| `repo.create` | A repository was created. | -| `repo.destroy` | A repository was deleted. | -| `repo.remove_member` | A collaborator was removed from a repository. | -| `repo.rename` | A repository was renamed. | -| `repo.transfer` | A user accepted a request to receive a transferred repository. | -| `repo.transfer_start` | A user sent a request to transfer a repository to another user or organization. | +| `repo.create` | A repository was created. | +| `repo.destroy` | A repository was deleted. | +| `repo.remove_member` | A collaborator was removed from a repository. | +| `repo.rename` | A repository was renamed. | +| `repo.transfer` | A user accepted a request to receive a transferred repository. | +| `repo.transfer_start` | A user sent a request to transfer a repository to another user or organization. | | `repo.unarchive` | A repository was unarchived. For more information, see [Archiving and unarchiving repositories](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/). | | `repo.config.disable_anonymous_git_access` | Anonymous Git read access is disabled for a public repository. For more information, see "[Enabling anonymous Git read access for a repository](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)." | | `repo.config.enable_anonymous_git_access` | Anonymous Git read access is enabled for a public repository. For more information, see "[Enabling anonymous Git read access for a repository](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)." | @@ -100,7 +100,7 @@ versions: | --------------------:| ----------------------------------------------------------------------------------------------- | | `staff.disable_repo` | A site admin disabled access to a repository and all of its forks. | | `staff.enable_repo` | A site admin re-enabled access to a repository and all of its forks. | -| `staff.fake_login` | A site admin signed into {% data variables.product.prodname_enterprise %} as another user. | +| `staff.fake_login` | A site admin signed into {% data variables.product.prodname_enterprise %} as another user. | | `staff.repo_unlock` | A site admin unlocked (temporarily gained full access to) one of a user's private repositories. | | `staff.unlock` | A site admin unlocked (temporarily gained full access to) all of a user's private repositories. | diff --git a/translations/ko-KR/content/admin/user-management/best-practices-for-user-security.md b/translations/ko-KR/content/admin/user-management/best-practices-for-user-security.md index 2975f1f5382a..f8f302a33586 100644 --- a/translations/ko-KR/content/admin/user-management/best-practices-for-user-security.md +++ b/translations/ko-KR/content/admin/user-management/best-practices-for-user-security.md @@ -3,7 +3,6 @@ title: Best practices for user security intro: 'Outside of instance-level security measures (SSL, subdomain isolation, configuring a firewall) that a site administrator can implement, there are steps your users can take to help protect {% data variables.product.product_location_enterprise %}.' redirect_from: - /enterprise/admin/user-management/best-practices-for-user-security - - /enterprise/admin/user-management/best-practices-for-user-security versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/user-management/creating-teams.md b/translations/ko-KR/content/admin/user-management/creating-teams.md index e3229b88fd09..1fad776262c8 100644 --- a/translations/ko-KR/content/admin/user-management/creating-teams.md +++ b/translations/ko-KR/content/admin/user-management/creating-teams.md @@ -46,7 +46,9 @@ Instances using LDAP for user authentication can use LDAP Sync to manage a team' {% data reusables.profile.access_org %} {% data reusables.organizations.new_team %} {% data reusables.organizations.team_name %} -6. Search for an LDAP group's DN to map the team to. If you don't know the DN, type the LDAP group's name. {% data variables.product.prodname_ghe_server %} will search for and autocomplete any matches. ![Mapping to the LDAP group DN](/assets/images/enterprise/orgs-and-teams/ldap-group-mapping.png) +6. Search for an LDAP group's DN to map the team to. If you don't know the DN, type the LDAP group's name. +{% data variables.product.prodname_ghe_server %} will search for and autocomplete any matches. +![Mapping to the LDAP group DN](/assets/images/enterprise/orgs-and-teams/ldap-group-mapping.png) {% data reusables.organizations.team_description %} {% data reusables.organizations.team_visibility %} {% data reusables.organizations.create-team-choose-parent %} diff --git a/translations/ko-KR/content/admin/user-management/exporting-migration-data-from-githubcom.md b/translations/ko-KR/content/admin/user-management/exporting-migration-data-from-githubcom.md index daa90147cce4..5b4046fe37f2 100644 --- a/translations/ko-KR/content/admin/user-management/exporting-migration-data-from-githubcom.md +++ b/translations/ko-KR/content/admin/user-management/exporting-migration-data-from-githubcom.md @@ -9,7 +9,6 @@ redirect_from: - /enterprise/admin/guides/migrations/preparing-the-github-com-source-organization - /enterprise/admin/guides/migrations/exporting-the-github-com-organization-s-repositories - /enterprise/admin/user-management/exporting-migration-data-from-githubcom - - /enterprise/admin/user-management/exporting-migration-data-from-githubcom versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/user-management/exporting-migration-data-from-your-enterprise.md b/translations/ko-KR/content/admin/user-management/exporting-migration-data-from-your-enterprise.md index dc35b088e351..aec6a820ffc8 100644 --- a/translations/ko-KR/content/admin/user-management/exporting-migration-data-from-your-enterprise.md +++ b/translations/ko-KR/content/admin/user-management/exporting-migration-data-from-your-enterprise.md @@ -9,7 +9,6 @@ redirect_from: - /enterprise/admin/guides/migrations/preparing-the-github-enterprise-source-instance/ - /enterprise/admin/guides/migrations/exporting-the-github-enterprise-source-repositories/ - /enterprise/admin/user-management/exporting-migration-data-from-your-enterprise - - /enterprise/admin/user-management/exporting-migration-data-from-your-enterprise versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/user-management/index.md b/translations/ko-KR/content/admin/user-management/index.md index 2acbb78c6363..8a7ef8f23fd3 100644 --- a/translations/ko-KR/content/admin/user-management/index.md +++ b/translations/ko-KR/content/admin/user-management/index.md @@ -7,7 +7,6 @@ redirect_from: - /enterprise/admin/migrations - /enterprise/admin/clustering - /enterprise/admin/user-management - - /enterprise/admin/user-management intro: 'This guide describes authentication methods for users signing in to your {% data variables.product.prodname_enterprise %} instance, how to create organizations and teams for repository access and collaboration, and suggested best practices for user security.' versions: enterprise-server: '*' diff --git a/translations/ko-KR/content/admin/user-management/managing-organizations-in-your-enterprise.md b/translations/ko-KR/content/admin/user-management/managing-organizations-in-your-enterprise.md index f8fe230ca684..ab347216400a 100644 --- a/translations/ko-KR/content/admin/user-management/managing-organizations-in-your-enterprise.md +++ b/translations/ko-KR/content/admin/user-management/managing-organizations-in-your-enterprise.md @@ -5,7 +5,6 @@ redirect_from: - /enterprise/admin/categories/admin-bootcamp/ - /enterprise/admin/user-management/organizations-and-teams - /enterprise/admin/user-management/managing-organizations-in-your-enterprise - - /enterprise/admin/user-management/managing-organizations-in-your-enterprise intro: 'Organizations are great for creating distinct groups of users within your company, such as divisions or groups working on similar projects. Public repositories that belong to an organization are accessible to users in other organizations, while private repositories are inaccessible to anyone but members of the organization.' mapTopic: true versions: diff --git a/translations/ko-KR/content/admin/user-management/managing-projects-using-jira.md b/translations/ko-KR/content/admin/user-management/managing-projects-using-jira.md index bb4213041055..fb919a17696a 100644 --- a/translations/ko-KR/content/admin/user-management/managing-projects-using-jira.md +++ b/translations/ko-KR/content/admin/user-management/managing-projects-using-jira.md @@ -7,7 +7,6 @@ redirect_from: - /enterprise/admin/developer-workflow/managing-projects-using-jira - /enterprise/admin/developer-workflow/customizing-your-instance-with-integrations - /enterprise/admin/user-management/managing-projects-using-jira - - /enterprise/admin/user-management/managing-projects-using-jira versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/user-management/managing-repositories-in-your-enterprise.md b/translations/ko-KR/content/admin/user-management/managing-repositories-in-your-enterprise.md index a1bc6699b44f..52831d237f78 100644 --- a/translations/ko-KR/content/admin/user-management/managing-repositories-in-your-enterprise.md +++ b/translations/ko-KR/content/admin/user-management/managing-repositories-in-your-enterprise.md @@ -4,7 +4,6 @@ intro: 'You can manage the settings available to repository administrators on yo redirect_from: - /enterprise/admin/user-management/repositories - /enterprise/admin/user-management/managing-repositories-in-your-enterprise - - /enterprise/admin/user-management/managing-repositories-in-your-enterprise mapTopic: true versions: enterprise-server: '*' diff --git a/translations/ko-KR/content/admin/user-management/managing-users-in-your-enterprise.md b/translations/ko-KR/content/admin/user-management/managing-users-in-your-enterprise.md index f5615a58399b..e89560fa5326 100644 --- a/translations/ko-KR/content/admin/user-management/managing-users-in-your-enterprise.md +++ b/translations/ko-KR/content/admin/user-management/managing-users-in-your-enterprise.md @@ -6,7 +6,6 @@ redirect_from: - /enterprise/admin/user-management/basic-account-settings - /enterprise/admin/user-management/user-security - /enterprise/admin/user-management/managing-users-in-your-enterprise - - /enterprise/admin/user-management/managing-users-in-your-enterprise mapTopic: true versions: enterprise-server: '*' diff --git a/translations/ko-KR/content/admin/user-management/migrating-data-to-and-from-your-enterprise.md b/translations/ko-KR/content/admin/user-management/migrating-data-to-and-from-your-enterprise.md index 8209aeca0e3f..51bb83534992 100644 --- a/translations/ko-KR/content/admin/user-management/migrating-data-to-and-from-your-enterprise.md +++ b/translations/ko-KR/content/admin/user-management/migrating-data-to-and-from-your-enterprise.md @@ -7,7 +7,6 @@ redirect_from: - /enterprise/admin/categories/migrations-and-upgrades/ - /enterprise/admin/migrations/overview - /enterprise/admin/user-management/migrating-data-to-and-from-your-enterprise - - /enterprise/admin/user-management/migrating-data-to-and-from-your-enterprise versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/user-management/monitoring-activity-in-your-enterprise.md b/translations/ko-KR/content/admin/user-management/monitoring-activity-in-your-enterprise.md index e41500d56a5d..991fef7abca5 100644 --- a/translations/ko-KR/content/admin/user-management/monitoring-activity-in-your-enterprise.md +++ b/translations/ko-KR/content/admin/user-management/monitoring-activity-in-your-enterprise.md @@ -4,9 +4,6 @@ mapTopic: true redirect_from: - /enterprise/admin/installation/monitoring-activity-on-your-github-enterprise-server-instance - /enterprise/admin/user-management/monitoring-activity-in-your-enterprise - - /enterprise/admin/user-management/monitoring-activity-in-your-enterprise - - /enterprise/admin/user-management/monitoring-activity-in-your-enterprise - - /enterprise/admin/user-management/monitoring-activity-in-your-enterprise versions: enterprise-server: '*' --- diff --git a/translations/ko-KR/content/admin/user-management/rebuilding-contributions-data.md b/translations/ko-KR/content/admin/user-management/rebuilding-contributions-data.md index 884ee223652f..71b24f03ec50 100644 --- a/translations/ko-KR/content/admin/user-management/rebuilding-contributions-data.md +++ b/translations/ko-KR/content/admin/user-management/rebuilding-contributions-data.md @@ -15,4 +15,5 @@ Whenever a commit is pushed to {% data variables.product.prodname_enterprise %}, 3. On the left side of the page, click **Admin**. ![Admin tab](/assets/images/enterprise/site-admin-settings/admin-tab.png) 4. Under **Contributions data**, click **Rebuild**. ![Rebuild button](/assets/images/enterprise/site-admin-settings/rebuild-button.png) -{% data variables.product.prodname_enterprise %} will now start background jobs to re-link commits with that user's account. ![Queued rebuild jobs](/assets/images/enterprise/site-admin-settings/rebuild-jobs.png) +{% data variables.product.prodname_enterprise %} will now start background jobs to re-link commits with that user's account. + ![Queued rebuild jobs](/assets/images/enterprise/site-admin-settings/rebuild-jobs.png) diff --git a/translations/ko-KR/content/admin/user-management/searching-the-audit-log.md b/translations/ko-KR/content/admin/user-management/searching-the-audit-log.md index d05f8ec59c3c..6abe41d7f90d 100644 --- a/translations/ko-KR/content/admin/user-management/searching-the-audit-log.md +++ b/translations/ko-KR/content/admin/user-management/searching-the-audit-log.md @@ -13,22 +13,22 @@ versions: Compose a search query from one or more key:value pairs separated by AND/OR logical operators. -| 키 | Value | -| --------------:| ------------------------------------------------------------------------------------------------------ | -| `actor_id` | ID of the user account that initiated the action | -| `actor` | Name of the user account that initiated the action | -| `oauth_app_id` | ID of the OAuth application associated with the action | +| 키 | Value | +| --------------:| -------------------------------------------------------------------------------------------------------- | +| `actor_id` | ID of the user account that initiated the action | +| `actor` | Name of the user account that initiated the action | +| `oauth_app_id` | ID of the OAuth application associated with the action | | `동작` | Name of the [audited action](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions) | -| `user_id` | ID of the user affected by the action | -| `사용자` | Name of the user affected by the action | -| `repo_id` | ID of the repository affected by the action (if applicable) | -| `repo` | Name of the repository affected by the action (if applicable) | -| `actor_ip` | IP address from which the action was initiated | -| `created_at` | Time at which the action occurred | -| `from` | View from which the action was initiated | -| `참고` | Miscellaneous event-specific information (in either plain text or JSON format) | -| `org` | Name of the organization affected by the action (if applicable) | -| `org_id` | ID of the organization affected by the action (if applicable) | +| `user_id` | ID of the user affected by the action | +| `사용자` | Name of the user affected by the action | +| `repo_id` | ID of the repository affected by the action (if applicable) | +| `repo` | Name of the repository affected by the action (if applicable) | +| `actor_ip` | IP address from which the action was initiated | +| `created_at` | Time at which the action occurred | +| `from` | View from which the action was initiated | +| `참고` | Miscellaneous event-specific information (in either plain text or JSON format) | +| `org` | Name of the organization affected by the action (if applicable) | +| `org_id` | ID of the organization affected by the action (if applicable) | For example, to see all actions that have affected the repository `octocat/Spoon-Knife` since the beginning of 2017: diff --git a/translations/ko-KR/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-a-repository-from-github-to-github-desktop.md b/translations/ko-KR/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-a-repository-from-github-to-github-desktop.md index 9fdfae53495c..2c7858449227 100644 --- a/translations/ko-KR/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-a-repository-from-github-to-github-desktop.md +++ b/translations/ko-KR/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-a-repository-from-github-to-github-desktop.md @@ -15,7 +15,9 @@ versions: {% mac %} -1. Sign in to {% data variables.product.product_location %} and {% data variables.product.prodname_desktop %} before you start to clone. +1. Sign in to + +{% data variables.product.product_location %} and {% data variables.product.prodname_desktop %} before you start to clone. {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.open-with-github-desktop %} 5. Click **Choose...** and, using the Finder window, navigate to a local path where you want to clone the repository. ![The choose button on the URL tab](/assets/images/help/desktop/clone-choose-button-url-mac.png) @@ -32,7 +34,9 @@ versions: {% windows %} -1. Sign in to {% data variables.product.product_location %} and {% data variables.product.prodname_desktop %} before you start to clone. +1. Sign in to + +{% data variables.product.product_location %} and {% data variables.product.prodname_desktop %} before you start to clone. {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.open-with-github-desktop %} 5. Click **Choose...** and, using Windows Explorer, navigate to a local path where you want to clone the repository. ![The choose button](/assets/images/help/desktop/clone-choose-button-url-win.png) diff --git a/translations/ko-KR/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop.md b/translations/ko-KR/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop.md index bb895cba213b..60a7dc7a2e44 100644 --- a/translations/ko-KR/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop.md +++ b/translations/ko-KR/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop.md @@ -19,8 +19,8 @@ You can also clone a repository directly from {% data variables.product.prodname ![Clone menu option in the Mac app](/assets/images/help/desktop/clone-file-menu-mac.png) {% data reusables.desktop.cloning-location-tab %} ![Location tabs in the Clone a repository menu](/assets/images/help/desktop/choose-repository-location-mac.png) -{% data reusables.desktop.cloning-repository-list %} -![Clone a repository list](/assets/images/help/desktop/clone-a-repository-list-mac.png) +{% data reusables.desktop.cloning-repository-list %} + ![Clone a repository list](/assets/images/help/desktop/clone-a-repository-list-mac.png) 4. Click **Choose...** and, using the Finder window, navigate to a local path where you want to clone the repository. ![The choose button](/assets/images/help/desktop/clone-choose-button-mac.png) 5. Click **Clone**. ![The clone button](/assets/images/help/desktop/clone-button-mac.png) @@ -32,8 +32,8 @@ You can also clone a repository directly from {% data variables.product.prodname ![Clone menu option in the Windows app](/assets/images/help/desktop/clone-file-menu-windows.png) {% data reusables.desktop.cloning-location-tab %} ![Location tabs in the Clone a repository menu](/assets/images/help/desktop/choose-repository-location-win.png) -{% data reusables.desktop.cloning-repository-list %} -![Clone a repository list](/assets/images/help/desktop/clone-a-repository-list-win.png) +{% data reusables.desktop.cloning-repository-list %} + ![Clone a repository list](/assets/images/help/desktop/clone-a-repository-list-win.png) 4. Click **Choose...** and, using Windows Explorer, navigate to a local path where you want to clone the repository. ![The choose button](/assets/images/help/desktop/clone-choose-button-win.png) 5. Click **Clone**. ![The clone button](/assets/images/help/desktop/clone-button-win.png) diff --git a/translations/ko-KR/content/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request.md b/translations/ko-KR/content/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request.md index 829d9640bebb..d90f981785a3 100644 --- a/translations/ko-KR/content/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request.md +++ b/translations/ko-KR/content/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request.md @@ -50,7 +50,9 @@ Before you create a pull request, you'll need to push changes to a branch on {% 1. Switch to the branch that you want to create a pull request for. For more information, see "[Switching between branches](/desktop/contributing-and-collaborating-using-github-desktop/managing-branches#switching-between-branches)." 2. Click **Create Pull Request**. {% data variables.product.prodname_desktop %} will open your default browser to take you to {% data variables.product.prodname_dotcom %}. ![The Create Pull Request button](/assets/images/help/desktop/mac-create-pull-request.png) -4. On {% data variables.product.prodname_dotcom %}, confirm that the branch in the **base:** drop-down menu is the branch where you want to merge your changes. Confirm that the branch in the **compare:** drop-down menu is the topic branch where you made your changes. ![Drop-down menus for choosing the base and compare branches](/assets/images/help/desktop/base-and-compare-branches.png) +4. On +{% data variables.product.prodname_dotcom %}, confirm that the branch in the **base:** drop-down menu is the branch where you want to merge your changes. Confirm that the branch in the **compare:** drop-down menu is the topic branch where you made your changes. + ![Drop-down menus for choosing the base and compare branches](/assets/images/help/desktop/base-and-compare-branches.png) {% data reusables.repositories.pr-title-description %} {% data reusables.repositories.create-pull-request %} @@ -60,7 +62,9 @@ Before you create a pull request, you'll need to push changes to a branch on {% 1. Switch to the branch that you want to create a pull request for. For more information, see "[Switching between branches](/desktop/contributing-and-collaborating-using-github-desktop/managing-branches#switching-between-branches)." 2. Click **Create Pull Request**. {% data variables.product.prodname_desktop %} will open your default browser to take you to {% data variables.product.prodname_dotcom %}. ![The Create Pull Request button](/assets/images/help/desktop/windows-create-pull-request.png) -3. On {% data variables.product.prodname_dotcom %}, confirm that the branch in the **base:** drop-down menu is the branch where you want to merge your changes. Confirm that the branch in the **compare:** drop-down menu is the topic branch where you made your changes. ![Drop-down menus for choosing the base and compare branches](/assets/images/help/desktop/base-and-compare-branches.png) +3. On +{% data variables.product.prodname_dotcom %}, confirm that the branch in the **base:** drop-down menu is the branch where you want to merge your changes. Confirm that the branch in the **compare:** drop-down menu is the topic branch where you made your changes. + ![Drop-down menus for choosing the base and compare branches](/assets/images/help/desktop/base-and-compare-branches.png) {% data reusables.repositories.pr-title-description %} {% data reusables.repositories.create-pull-request %} diff --git a/translations/ko-KR/content/desktop/installing-and-configuring-github-desktop/authenticating-to-github.md b/translations/ko-KR/content/desktop/installing-and-configuring-github-desktop/authenticating-to-github.md index dcfd1ed68208..cb9ee4aeab9f 100644 --- a/translations/ko-KR/content/desktop/installing-and-configuring-github-desktop/authenticating-to-github.md +++ b/translations/ko-KR/content/desktop/installing-and-configuring-github-desktop/authenticating-to-github.md @@ -37,7 +37,9 @@ Before you authenticate, {% data reusables.desktop.get-an-account %} {% data reusables.desktop.mac-select-desktop-menu %} {% data reusables.desktop.mac-select-accounts %} {% data reusables.desktop.choose-product-authenticate %} -4. To add a {% data variables.product.prodname_enterprise %} account, type your credentials under "Enterprise server address," then click **Continue**. ![The Sign In button for GitHub Enterprise](/assets/images/help/desktop/mac-sign-in-button-enterprise.png) +4. To add a +{% data variables.product.prodname_enterprise %} account, type your credentials under "Enterprise server address," then click **Continue**. + ![The Sign In button for GitHub Enterprise](/assets/images/help/desktop/mac-sign-in-button-enterprise.png) {% data reusables.desktop.retrieve-2fa %} {% endmac %} @@ -65,7 +67,9 @@ Before you authenticate, {% data reusables.desktop.get-an-account %} {% data reusables.desktop.windows-choose-options %} {% data reusables.desktop.windows-select-accounts %} {% data reusables.desktop.choose-product-authenticate %} -4. To add a {% data variables.product.prodname_enterprise %} account, type your credentials under "Enterprise server address," then click **Continue**. ![The Sign In button for GitHub Enterprise](/assets/images/help/desktop/windows-sign-in-button-enterprise.png) +4. To add a +{% data variables.product.prodname_enterprise %} account, type your credentials under "Enterprise server address," then click **Continue**. + ![The Sign In button for GitHub Enterprise](/assets/images/help/desktop/windows-sign-in-button-enterprise.png) {% data reusables.desktop.retrieve-2fa %} {% endwindows %} diff --git a/translations/ko-KR/content/desktop/installing-and-configuring-github-desktop/keyboard-shortcuts.md b/translations/ko-KR/content/desktop/installing-and-configuring-github-desktop/keyboard-shortcuts.md index c1c58307539d..332a10367342 100644 --- a/translations/ko-KR/content/desktop/installing-and-configuring-github-desktop/keyboard-shortcuts.md +++ b/translations/ko-KR/content/desktop/installing-and-configuring-github-desktop/keyboard-shortcuts.md @@ -14,53 +14,53 @@ GitHub Desktop keyboard shortcuts on macOS ### Site wide shortcuts -| Keyboard shortcut | 설명 | -| ------------------------------------ | ----------------------------------------------------------------------- | -| ⌘, | Go to Preferences | +| Keyboard shortcut | 설명 | +| ------------------------------------ | ------------------------------------------------------------------ | +| ⌘, | Go to Preferences | | ⌘H | Hide the {% data variables.product.prodname_desktop %} application | -| ⌥⌘H | Hide all other applications | -| ⌘Q | Quit {% data variables.product.prodname_desktop %} | -| ⌃⌘F | Toggle full screen view | -| ⌘0 | Reset zoom to default text size | -| ⌘= | Zoom in for larger text and graphics | -| ⌘- | Zoom out for smaller text and graphics | -| ⌥⌘I | Toggle Developer Tools | +| ⌥⌘H | Hide all other applications | +| ⌘Q | Quit {% data variables.product.prodname_desktop %} +| ⌃⌘F | Toggle full screen view | +| ⌘0 | Reset zoom to default text size | +| ⌘= | Zoom in for larger text and graphics | +| ⌘- | Zoom out for smaller text and graphics | +| ⌥⌘I | Toggle Developer Tools | ### Repositories -| Keyboard shortcut | 설명 | -| ------------------------------------ | ----------------------------------------------------------------------------------- | -| ⌘N | Add a new repository | -| ⌘O | Add a local repository | -| ⇧⌘O | Clone a repository from {% data variables.product.prodname_dotcom %} | -| ⌘T | Show a list of your repositories | -| ⌘P | Push the latest commits to {% data variables.product.prodname_dotcom %} | -| ⇧⌘P | Pull down the latest changes from {% data variables.product.prodname_dotcom %} | -| ⌘⌫ | Remove an existing repository | -| ⇧⌘G | View the repository on {% data variables.product.prodname_dotcom %} | -| ⌃` | Open repository in your preferred terminal tool | -| ⇧⌘F | Show the repository in Finder | -| ⇧⌘A | Open the repository in your preferred editor tool | -| ⌘I | Create an issue on {% data variables.product.prodname_dotcom %} | +| Keyboard shortcut | 설명 | +| ------------------------------------ | ------------------------------------------------------------------------------ | +| ⌘N | Add a new repository | +| ⌘O | Add a local repository | +| ⇧⌘O | Clone a repository from {% data variables.product.prodname_dotcom %} +| ⌘T | Show a list of your repositories | +| ⌘P | Push the latest commits to {% data variables.product.prodname_dotcom %} +| ⇧⌘P | Pull down the latest changes from {% data variables.product.prodname_dotcom %} +| ⌘⌫ | Remove an existing repository | +| ⇧⌘G | View the repository on {% data variables.product.prodname_dotcom %} +| ⌃` | Open repository in your preferred terminal tool | +| ⇧⌘F | Show the repository in Finder | +| ⇧⌘A | Open the repository in your preferred editor tool | +| ⌘I | Create an issue on {% data variables.product.prodname_dotcom %} ### Branches -| Keyboard shortcut | 설명 | -| ------------------------------------ | ---------------------------------------------------------------------------------- | -| ⌘1 | Show all your changes before committing | -| ⌘2 | Show your commit history | -| ⌘B | Show all your branches | -| ⌘G | Go to the commit summary field | -| space | Select or deselect all highlighted files | -| ⇧⌘N | Create a new branch | -| ⇧⌘R | Rename the current branch | -| ⇧⌘D | Delete the current branch | -| ⇧⌘U | Update from default branch | -| ⇧⌘B | Compare to an existing branch | -| ⇧⌘M | Merge into current branch | -| ⌃H | Show or hide stashed changes | -| ⇧⌘C | Compare branches on {% data variables.product.prodname_dotcom %} | -| ⌘R | Show the current pull request on {% data variables.product.prodname_dotcom %} | +| Keyboard shortcut | 설명 | +| ------------------------------------ | ----------------------------------------------------------------------------- | +| ⌘1 | Show all your changes before committing | +| ⌘2 | Show your commit history | +| ⌘B | Show all your branches | +| ⌘G | Go to the commit summary field | +| space | Select or deselect all highlighted files | +| ⇧⌘N | Create a new branch | +| ⇧⌘R | Rename the current branch | +| ⇧⌘D | Delete the current branch | +| ⇧⌘U | Update from default branch | +| ⇧⌘B | Compare to an existing branch | +| ⇧⌘M | Merge into current branch | +| ⌃H | Show or hide stashed changes | +| ⇧⌘C | Compare branches on {% data variables.product.prodname_dotcom %} +| ⌘R | Show the current pull request on {% data variables.product.prodname_dotcom %} {% endmac %} @@ -81,38 +81,38 @@ GitHub Desktop keyboard shortcuts on Windows ### Repositories -| Keyboard Shortcut | 설명 | -| ------------------------------------------- | ----------------------------------------------------------------------------------- | -| CtrlN | Add a new repository | -| CtrlO | Add a local repository | -| CtrlShiftO | Clone a repository from {% data variables.product.prodname_dotcom %} | -| CtrlT | Show a list of your repositories | -| CtrlP | Push the latest commits to {% data variables.product.prodname_dotcom %} | -| CtrlShiftP | Pull down the latest changes from {% data variables.product.prodname_dotcom %} | -| CtrlDelete | Remove an existing repository | -| CtrlShiftG | View the repository on {% data variables.product.prodname_dotcom %} | -| Ctrl` | Open repository in your preferred command line tool | -| CtrlShiftF | Show the repository in Explorer | -| CtrlShiftA | Open the repository in your preferred editor tool | -| CtrlI | Create an issue on {% data variables.product.prodname_dotcom %} | +| Keyboard Shortcut | 설명 | +| ------------------------------------------- | ------------------------------------------------------------------------------ | +| CtrlN | Add a new repository | +| CtrlO | Add a local repository | +| CtrlShiftO | Clone a repository from {% data variables.product.prodname_dotcom %} +| CtrlT | Show a list of your repositories | +| CtrlP | Push the latest commits to {% data variables.product.prodname_dotcom %} +| CtrlShiftP | Pull down the latest changes from {% data variables.product.prodname_dotcom %} +| CtrlDelete | Remove an existing repository | +| CtrlShiftG | View the repository on {% data variables.product.prodname_dotcom %} +| Ctrl` | Open repository in your preferred command line tool | +| CtrlShiftF | Show the repository in Explorer | +| CtrlShiftA | Open the repository in your preferred editor tool | +| CtrlI | Create an issue on {% data variables.product.prodname_dotcom %} ### Branches -| Keyboard shortcut | 설명 | -| ------------------------------------------- | ---------------------------------------------------------------------------------- | -| Ctrl1 | Show all your changes before committing | -| Ctrl2 | Show your commit history | -| CtrlB | Show all your branches | -| CtrlG | Go to the commit summary field | -| space | Select or deselect all highlighted files | -| CtrlShiftN | Create a new branch | -| CtrlShiftR | Rename the current branch | -| CtrlShiftD | Delete the current branch | -| CtrlShiftU | Update from default branch | -| CtrlShiftB | Compare to an existing branch | -| CtrlShiftM | Merge into current branch | -| CtrlH | Show or hide stashed changes | -| CtrlShiftC | Compare branches on {% data variables.product.prodname_dotcom %} | -| CtrlR | Show the current pull request on {% data variables.product.prodname_dotcom %} | +| Keyboard shortcut | 설명 | +| ------------------------------------------- | ----------------------------------------------------------------------------- | +| Ctrl1 | Show all your changes before committing | +| Ctrl2 | Show your commit history | +| CtrlB | Show all your branches | +| CtrlG | Go to the commit summary field | +| space | Select or deselect all highlighted files | +| CtrlShiftN | Create a new branch | +| CtrlShiftR | Rename the current branch | +| CtrlShiftD | Delete the current branch | +| CtrlShiftU | Update from default branch | +| CtrlShiftB | Compare to an existing branch | +| CtrlShiftM | Merge into current branch | +| CtrlH | Show or hide stashed changes | +| CtrlShiftC | Compare branches on {% data variables.product.prodname_dotcom %} +| CtrlR | Show the current pull request on {% data variables.product.prodname_dotcom %} {% endwindows %} diff --git a/translations/ko-KR/content/developers/apps/activating-beta-features-for-apps.md b/translations/ko-KR/content/developers/apps/activating-beta-features-for-apps.md index 389ecf6690b1..f349501d5f0c 100644 --- a/translations/ko-KR/content/developers/apps/activating-beta-features-for-apps.md +++ b/translations/ko-KR/content/developers/apps/activating-beta-features-for-apps.md @@ -15,7 +15,8 @@ versions: {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} -3. Select the {% data variables.product.prodname_github_app %} you want to enable a beta feature for. +3. Select the +{% data variables.product.prodname_github_app %} you want to enable a beta feature for. {% data reusables.apps.beta_feature_activation %} ### Activating beta features for {% data variables.product.prodname_oauth_app %}s diff --git a/translations/ko-KR/content/developers/apps/authorizing-oauth-apps.md b/translations/ko-KR/content/developers/apps/authorizing-oauth-apps.md index 3e7e2815e500..e9db79f2d477 100644 --- a/translations/ko-KR/content/developers/apps/authorizing-oauth-apps.md +++ b/translations/ko-KR/content/developers/apps/authorizing-oauth-apps.md @@ -54,11 +54,11 @@ When your GitHub App specifies a `login` parameter, it prompts users with a spec | 이름 | 유형 | 설명 | | -------------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `client_id` | `문자열` | **Required**. The client ID you received from GitHub when you {% if currentVersion == "free-pro-team@latest" %}[registered](https://github.com/settings/applications/new){% else %}registered{% endif %}. | +| `client_id` | `문자열` | **Required**. The client ID you received from GitHub when you {% if currentVersion == "free-pro-team@latest" %}[registered](https://github.com/settings/applications/new){% else %}registered{% endif %}. | | `redirect_uri` | `문자열` | The URL in your application where users will be sent after authorization. See details below about [redirect urls](#redirect-urls). | | `login` | `문자열` | Suggests a specific account to use for signing in and authorizing the app. | | `범위` | `문자열` | A space-delimited list of [scopes](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/). If not provided, `scope` defaults to an empty list for users that have not authorized any scopes for the application. For users who have authorized scopes for the application, the user won't be shown the OAuth authorization page with the list of scopes. Instead, this step of the flow will automatically complete with the set of scopes the user has authorized for the application. For example, if a user has already performed the web flow twice and has authorized one token with `user` scope and another token with `repo` scope, a third web flow that does not provide a `scope` will receive a token with `user` and `repo` scope. | -| `state` | `문자열` | {% data reusables.apps.state_description %} | +| `state` | `문자열` | {% data reusables.apps.state_description %} | `allow_signup` | `문자열` | Whether or not unauthenticated users will be offered an option to sign up for GitHub during the OAuth flow. The default is `true`. Use `false` when a policy prohibits signups. | #### 2. Users are redirected back to your site by GitHub @@ -71,13 +71,13 @@ Exchange this `code` for an access token: ##### 매개변수 -| 이름 | 유형 | 설명 | -| --------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| 이름 | 유형 | 설명 | +| --------------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | `client_id` | `문자열` | **Required.** The client ID you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_github_app %}. | | `client_secret` | `문자열` | **Required.** The client secret you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_github_app %}. | -| `코드` | `문자열` | **Required.** The code you received as a response to Step 1. | -| `redirect_uri` | `문자열` | The URL in your application where users are sent after authorization. | -| `state` | `문자열` | The unguessable random string you provided in Step 1. | +| `코드` | `문자열` | **Required.** The code you received as a response to Step 1. | +| `redirect_uri` | `문자열` | The URL in your application where users are sent after authorization. | +| `state` | `문자열` | The unguessable random string you provided in Step 1. | ##### 응답 @@ -135,14 +135,13 @@ Your app must request a user verification code and verification URL that the app ##### Input Parameters -| 이름 | 유형 | 설명 | -| ----------- | ----- | ---------------------------------------------------------------------------------------------------------- | +| 이름 | 유형 | 설명 | +| ----------- | ----- | ----------------------------------------------------------------------------------------------------- | | `client_id` | `문자열` | **Required.** The client ID you received from {% data variables.product.product_name %} for your app. | -| `범위` | `문자열` | The scope that your app is requesting access to. | +| `범위` | `문자열` | The scope that your app is requesting access to. | ##### 응답 - {% if currentVersion == "free-pro-team@latest" %} ```JSON { @@ -167,12 +166,12 @@ Your app must request a user verification code and verification URL that the app ##### Response parameters -| 이름 | 유형 | 설명 | -| ------------------ | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `device_code` | `문자열` | The device verification code is 40 characters and used to verify the device. | -| `user_code` | `문자열` | The user verification code is displayed on the device so the user can enter the code in a browser. This code is 8 characters with a hyphen in the middle. | +| 이름 | 유형 | 설명 | +| ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `device_code` | `문자열` | The device verification code is 40 characters and used to verify the device. | +| `user_code` | `문자열` | The user verification code is displayed on the device so the user can enter the code in a browser. This code is 8 characters with a hyphen in the middle. | | `verification_uri` | `문자열` | The verification URL where users need to enter the `user_code`: {% data variables.product.device_authorization_url %}. | -| `expires_in` | `integer` | The number of seconds before the `device_code` and `user_code` expire. The default is 900 seconds or 15 minutes. | +| `expires_in` | `integer` | The number of seconds before the `device_code` and `user_code` expire. The default is 900 seconds or 15 minutes. | | `interval` | `integer` | The minimum number of seconds that must pass before you can make a new access token request (`POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`) to complete the device authorization. For example, if the interval is 5, then you cannot make a new request until 5 seconds pass. If you make more than one request over 5 seconds, then you will hit the rate limit and receive a `slow_down` error. | #### Step 2: Prompt the user to enter the user code in a browser @@ -193,11 +192,11 @@ Once the user has authorized, the app will receive an access token that can be u ##### Input parameters -| 이름 | 유형 | 설명 | -| ------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 이름 | 유형 | 설명 | +| ------------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | `client_id` | `문자열` | **Required.** The client ID you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_oauth_app %}. | -| `device_code` | `문자열` | **Required.** The device verification code you received from the `POST {% data variables.product.oauth_host_code %}/login/device/code` request. | -| `grant_type` | `문자열` | **Required.** The grant type must be `urn:ietf:params:oauth:grant-type:device_code`. | +| `device_code` | `문자열` | **Required.** The device verification code you received from the `POST {% data variables.product.oauth_host_code %}/login/device/code` request. | +| `grant_type` | `문자열` | **Required.** The grant type must be `urn:ietf:params:oauth:grant-type:device_code`. | ##### 응답 @@ -217,15 +216,15 @@ If you make more than one access token request (`POST {% data variables.product. #### Error codes for the device flow -| Error code | 설명 | -| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Error code | 설명 | +| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `authorization_pending` | This error occurs when the authorization request is pending and the user hasn't entered the user code yet. The app is expected to keep polling the `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token` request without exceeding the [`interval`](#response-parameters), which requires a minimum number of seconds between each request. | | `slow_down` | When you receive the `slow_down` error, 5 extra seconds are added to the minimum `interval` or timeframe required between your requests using `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`. For example, if the starting interval required at least 5 seconds between requests and you get a `slow_down` error response, you must now wait a minimum of 10 seconds before making a new request for an OAuth access token. The error response includes the new `interval` that you must use. | -| `expired_token` | If the device code expired, then you will see the `token_expired` error. You must make a new request for a device code. | +| `expired_token` | If the device code expired, then you will see the `token_expired` error. You must make a new request for a device code. | | `unsupported_grant_type` | The grant type must be `urn:ietf:params:oauth:grant-type:device_code` and included as an input parameter when you poll the OAuth token request `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`. | -| `incorrect_client_credentials` | For the device flow, you must pass your app's client ID, which you can find on your app settings page. The `client_secret` is not needed for the device flow. | -| `incorrect_device_code` | The device_code provided is not valid. | -| `access_denied` | When a user clicks cancel during the authorization process, you'll receive a `access_denied` error and the user won't be able to use the verification code again. | +| `incorrect_client_credentials` | For the device flow, you must pass your app's client ID, which you can find on your app settings page. The `client_secret` is not needed for the device flow. | +| `incorrect_device_code` | The device_code provided is not valid. | +| `access_denied` | When a user clicks cancel during the authorization process, you'll receive a `access_denied` error and the user won't be able to use the verification code again. | For more information, see the "[OAuth 2.0 Device Authorization Grant](https://tools.ietf.org/html/rfc8628#section-3.5)." diff --git a/translations/ko-KR/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md b/translations/ko-KR/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md index e0ea4c44781e..cfbbf5ea3416 100644 --- a/translations/ko-KR/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md +++ b/translations/ko-KR/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md @@ -8,9 +8,6 @@ versions: enterprise-server: '*' --- - - - By default, a new OAuth App will have an automatically generated [identicon](https://github.com/blog/1586-identicons). An identicon badge looks something like this: ![Identicon](/assets/images/identicon.png) @@ -31,7 +28,7 @@ To create a custom badge: {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.oauth_apps %} {% data reusables.user-settings.modify_oauth_app %} -5. In "Application logo", drag-and-drop an image from a local folder or click **Upload new logo** to select an image from your computer. ![Upload a logo](/assets/images/oauth-apps/oauth_apps_upload_logo.png) +1. In "Application logo", drag-and-drop an image from a local folder or click **Upload new logo** to select an image from your computer. ![Upload a logo](/assets/images/oauth-apps/oauth_apps_upload_logo.png) 6. Crop your picture. When you're done, click **Set new application logo**. ![Crop and set logo](/assets/images/oauth-apps/oauth_apps_crop_and_set_logo.png) 7. In "Badge background color", type the [hexadecimal color code](http://www.color-hex.com/) of the background color for your badge. {% if currentVersion == "free-pro-team@latest" %}**Note:** The "Badge background color" input field will be visible after an application logo has been uploaded.{% endif %} diff --git a/translations/ko-KR/content/developers/apps/creating-a-github-app-from-a-manifest.md b/translations/ko-KR/content/developers/apps/creating-a-github-app-from-a-manifest.md index 722c3e8f1324..7feef22370e9 100644 --- a/translations/ko-KR/content/developers/apps/creating-a-github-app-from-a-manifest.md +++ b/translations/ko-KR/content/developers/apps/creating-a-github-app-from-a-manifest.md @@ -71,9 +71,9 @@ The `hook_attributes` object has the following key: ##### 매개변수 - | 이름 | 유형 | 설명 | - | ------- | ----- | ------------------------------------------------ | - | `state` | `문자열` | {% data reusables.apps.state_description %} | + | 이름 | 유형 | 설명 | + | ------- | ----- | ------------------------------------------- | + | `state` | `문자열` | {% data reusables.apps.state_description %} ##### 예시 diff --git a/translations/ko-KR/content/developers/apps/creating-a-github-app-using-url-parameters.md b/translations/ko-KR/content/developers/apps/creating-a-github-app-using-url-parameters.md index 153dbf35e84a..367169ee68cd 100644 --- a/translations/ko-KR/content/developers/apps/creating-a-github-app-using-url-parameters.md +++ b/translations/ko-KR/content/developers/apps/creating-a-github-app-using-url-parameters.md @@ -27,93 +27,93 @@ The complete list of available query parameters, permissions, and events is list ### {% data variables.product.prodname_github_app %} configuration parameters - | 이름 | 유형 | 설명 | - | -------------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - | `name` | `문자열` | The name of the {% data variables.product.prodname_github_app %}. Give your app a clear and succinct name. Your app cannot have the same name as an existing GitHub user, unless it is your own user or organization name. A slugged version of your app's name will be shown in the user interface when your integration takes an action. | - | `설명` | `문자열` | A description of the {% data variables.product.prodname_github_app %}. | - | `url` | `문자열` | The full URL of your {% data variables.product.prodname_github_app %}'s website homepage. | - | `callback_url` | `문자열` | The full URL to redirect to after someone authorizes an installation. This URL is used if your app needs to identify and authorize user-to-server requests. | - | `request_oauth_on_install` | `boolean` | If your app authorizes users using the OAuth flow, you can set this option to `true` to allow people to authorize the app when they install it, saving a step. If you select this option, the `setup_url` becomes unavailable and users will be redirected to your `callback_url` after installing the app. | - | `setup_url` | `문자열` | The full URL to redirect to after someone installs the {% data variables.product.prodname_github_app %} if the app requires additional setup after installation. | - | `setup_on_update` | `boolean` | Set to `true` to redirect people to the setup URL when installations have been updated, for example, after repositories are added or removed. | - | `public` | `boolean` | Set to `true` when your {% data variables.product.prodname_github_app %} is available to the public or `false` when it is only accessible to the owner of the app. | - | `webhook_url` | `문자열` | The full URL that you would like to send webhook event payloads to. | - | `webhook_secret` | `문자열` | You can specify a secret to secure your webhooks. See "[Securing your webhooks](/webhooks/securing/)" for more details. | + | 이름 | 유형 | 설명 | + | -------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | + | `name` | `문자열` | The name of the {% data variables.product.prodname_github_app %}. Give your app a clear and succinct name. Your app cannot have the same name as an existing GitHub user, unless it is your own user or organization name. A slugged version of your app's name will be shown in the user interface when your integration takes an action. | + | `설명` | `문자열` | A description of the {% data variables.product.prodname_github_app %}. | + | `url` | `문자열` | The full URL of your {% data variables.product.prodname_github_app %}'s website homepage. | + | `callback_url` | `문자열` | The full URL to redirect to after someone authorizes an installation. This URL is used if your app needs to identify and authorize user-to-server requests. | + | `request_oauth_on_install` | `boolean` | If your app authorizes users using the OAuth flow, you can set this option to `true` to allow people to authorize the app when they install it, saving a step. If you select this option, the `setup_url` becomes unavailable and users will be redirected to your `callback_url` after installing the app. | + | `setup_url` | `문자열` | The full URL to redirect to after someone installs the {% data variables.product.prodname_github_app %} if the app requires additional setup after installation. | + | `setup_on_update` | `boolean` | Set to `true` to redirect people to the setup URL when installations have been updated, for example, after repositories are added or removed. | + | `public` | `boolean` | Set to `true` when your {% data variables.product.prodname_github_app %} is available to the public or `false` when it is only accessible to the owner of the app. | + | `webhook_url` | `문자열` | The full URL that you would like to send webhook event payloads to. | + | `webhook_secret` | `문자열` | You can specify a secret to secure your webhooks. See "[Securing your webhooks](/webhooks/securing/)" for more details. | | `이벤트` | `array of strings` | Webhook events. Some webhook events require `read` or `write` permissions for a resource before you can select the event when registering a new {% data variables.product.prodname_github_app %}. See the "[{% data variables.product.prodname_github_app %} webhook events](#github-app-webhook-events)" section for available events and their required permissions. You can select multiple events in a query string. For example, `events[]=public&events[]=label`. | - | `도메인` | `문자열` | The URL of a content reference. | - | `single_file_name` | `문자열` | When you grant `read` or `write` access to the `single_file` permission, this field provides the path to the single file your {% data variables.product.prodname_github_app %} will manage. | + | `도메인` | `문자열` | The URL of a content reference. | + | `single_file_name` | `문자열` | When you grant `read` or `write` access to the `single_file` permission, this field provides the path to the single file your {% data variables.product.prodname_github_app %} will manage. | ### {% data variables.product.prodname_github_app %} permissions You can select permissions in a query string using the permission name in the following table as the query parameter name and the permission type as the query value. For example, to select `Read & write` permissions in the user interface for `contents`, your query string would include `&contents=write`. To select `Read-only` permissions in the user interface for `blocking`, your query string would include `&blocking=read`. To select `no-access` in the user interface for `checks`, your query string would not include the `checks` permission. -| Permission | 설명 | -| -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Permission | 설명 | +| -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [`administration`](/rest/reference/permissions-required-for-github-apps/#permission-on-administration) | Grants access to various endpoints for organization and repository administration. Can be one of: `none`, `read`, or `write`.{% if currentVersion == "free-pro-team@latest" %} | [`blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-blocking) | Grants access to the [Blocking Users API](/v3/users/blocking/). Can be one of: `none`, `read`, or `write`.{% endif %} -| [`checks`](/rest/reference/permissions-required-for-github-apps/#permission-on-checks) | Grants access to the [Checks API](/v3/checks/). Can be one of: `none`, `read`, or `write`. | -| `content_references` | Grants access to the "[Create a content attachment](/v3/apps/installations/#create-a-content-attachment)" endpoint. Can be one of: `none`, `read`, or `write`. | -| [`contents`](/rest/reference/permissions-required-for-github-apps/#permission-on-contents) | Grants access to various endpoints that allow you to modify repository contents. Can be one of: `none`, `read`, or `write`. | -| [`deployments`](/rest/reference/permissions-required-for-github-apps/#permission-on-deployments) | Grants access to the [Deployments API](/v3/repos/deployments/). Can be one of: `none`, `read`, or `write`. | -| [`emails`](/rest/reference/permissions-required-for-github-apps/#permission-on-emails) | Grants access to the [Emails API](/v3/users/emails/). Can be one of: `none`, `read`, or `write`. | -| [`followers`](/rest/reference/permissions-required-for-github-apps/#permission-on-followers) | Grants access to the [Followers API](/v3/users/followers/). Can be one of: `none`, `read`, or `write`. | -| [`gpg_keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-gpg-keys) | Grants access to the [GPG Keys API](/v3/users/gpg_keys/). Can be one of: `none`, `read`, or `write`. | -| [`issues`](/rest/reference/permissions-required-for-github-apps/#permission-on-issues) | Grants access to the [Issues API](/v3/issues/). Can be one of: `none`, `read`, or `write`. | -| [`keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-keys) | Grants access to the [Public Keys API](/v3/users/keys/). Can be one of: `none`, `read`, or `write`. | +| [`checks`](/rest/reference/permissions-required-for-github-apps/#permission-on-checks) | Grants access to the [Checks API](/v3/checks/). Can be one of: `none`, `read`, or `write`. | +| `content_references` | Grants access to the "[Create a content attachment](/v3/apps/installations/#create-a-content-attachment)" endpoint. Can be one of: `none`, `read`, or `write`. | +| [`contents`](/rest/reference/permissions-required-for-github-apps/#permission-on-contents) | Grants access to various endpoints that allow you to modify repository contents. Can be one of: `none`, `read`, or `write`. | +| [`deployments`](/rest/reference/permissions-required-for-github-apps/#permission-on-deployments) | Grants access to the [Deployments API](/v3/repos/deployments/). Can be one of: `none`, `read`, or `write`. | +| [`emails`](/rest/reference/permissions-required-for-github-apps/#permission-on-emails) | Grants access to the [Emails API](/v3/users/emails/). Can be one of: `none`, `read`, or `write`. | +| [`followers`](/rest/reference/permissions-required-for-github-apps/#permission-on-followers) | Grants access to the [Followers API](/v3/users/followers/). Can be one of: `none`, `read`, or `write`. | +| [`gpg_keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-gpg-keys) | Grants access to the [GPG Keys API](/v3/users/gpg_keys/). Can be one of: `none`, `read`, or `write`. | +| [`issues`](/rest/reference/permissions-required-for-github-apps/#permission-on-issues) | Grants access to the [Issues API](/v3/issues/). Can be one of: `none`, `read`, or `write`. | +| [`keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-keys) | Grants access to the [Public Keys API](/v3/users/keys/). Can be one of: `none`, `read`, or `write`. | | [`members`](/rest/reference/permissions-required-for-github-apps/#permission-on-members) | Grants access to manage an organization's members. Can be one of: `none`, `read`, or `write`.{% if currentVersion == "free-pro-team@latest" %} -| [`메타데이터`](/rest/reference/permissions-required-for-github-apps/#metadata-permissions) | Grants access to read-only endpoints that do not leak sensitive data. Can be `read` or `none`. Defaults to `read` when you set any permission, or defaults to `none` when you don't specify any permissions for the {% data variables.product.prodname_github_app %}. | +| [`메타데이터`](/rest/reference/permissions-required-for-github-apps/#metadata-permissions) | Grants access to read-only endpoints that do not leak sensitive data. Can be `read` or `none`. Defaults to `read` when you set any permission, or defaults to `none` when you don't specify any permissions for the {% data variables.product.prodname_github_app %}. | | [`organization_administration`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-administration) | Grants access to "[Update an organization](/v3/orgs/#update-an-organization)" endpoint and the [Organization Interaction Restrictions API](/v3/interactions/orgs/#set-interaction-restrictions-for-an-organization). Can be one of: `none`, `read`, or `write`.{% endif %} -| [`organization_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-hooks) | Grants access to the [Organization Webhooks API](/v3/orgs/hooks/). Can be one of: `none`, `read`, or `write`. | -| `organization_plan` | Grants access to get information about an organization's plan using the "[Get an organization](/v3/orgs/#get-an-organization)" endpoint. Can be one of: `none` or `read`. | +| [`organization_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-hooks) | Grants access to the [Organization Webhooks API](/v3/orgs/hooks/). Can be one of: `none`, `read`, or `write`. | +| `organization_plan` | Grants access to get information about an organization's plan using the "[Get an organization](/v3/orgs/#get-an-organization)" endpoint. Can be one of: `none` or `read`. | | [`organization_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects) | Grants access to the [Projects API](/v3/projects/). Can be one of: `none`, `read`, `write`, or `admin`.{% if currentVersion == "free-pro-team@latest" %} | [`organization_user_blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects) | Grants access to the [Blocking Organization Users API](/v3/orgs/blocking/). Can be one of: `none`, `read`, or `write`.{% endif %} -| [`pages`](/rest/reference/permissions-required-for-github-apps/#permission-on-pages) | Grants access to the [Pages API](/v3/repos/pages/). Can be one of: `none`, `read`, or `write`. | -| `plan` | Grants access to get information about a user's GitHub plan using the "[Get a user](/v3/users/#get-a-user)" endpoint. Can be one of: `none` or `read`. | -| [`pull_requests`](/rest/reference/permissions-required-for-github-apps/#permission-on-pull-requests) | Grants access to various pull request endpoints. Can be one of: `none`, `read`, or `write`. | -| [`repository_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-hooks) | Grants access to the [Repository Webhooks API](/v3/repos/hooks/). Can be one of: `none`, `read`, or `write`. | -| [`repository_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-projects) | Grants access to the [Projects API](/v3/projects/). Can be one of: `none`, `read`, `write`, or `admin`. | -| [`single_file`](/rest/reference/permissions-required-for-github-apps/#permission-on-single-file) | Grants access to the [Contents API](/v3/repos/contents/). Can be one of: `none`, `read`, or `write`. | -| [`starring`](/rest/reference/permissions-required-for-github-apps/#permission-on-starring) | Grants access to the [Starring API](/v3/activity/starring/). Can be one of: `none`, `read`, or `write`. | -| [`statuses`](/rest/reference/permissions-required-for-github-apps/#permission-on-statuses) | Grants access to the [Statuses API](/v3/repos/statuses/). Can be one of: `none`, `read`, or `write`. | -| [`team_discussions`](/rest/reference/permissions-required-for-github-apps/#permission-on-team-discussions) | Grants access to the [Team Discussions API](/v3/teams/discussions/) and the [Team Discussion Comments API](/v3/teams/discussion_comments/). Can be one of: `none`, `read`, or `write`. | -| `vulnerability_alerts` | Grants access to receive security alerts for vulnerable dependencies in a repository. See "[About security alerts for vulnerable dependencies](/articles/about-security-alerts-for-vulnerable-dependencies)" to learn more. Can be one of: `none` or `read`. | -| `시청` | Grants access to list and change repositories a user is subscribed to. Can be one of: `none`, `read`, or `write`. | +| [`pages`](/rest/reference/permissions-required-for-github-apps/#permission-on-pages) | Grants access to the [Pages API](/v3/repos/pages/). Can be one of: `none`, `read`, or `write`. | +| `plan` | Grants access to get information about a user's GitHub plan using the "[Get a user](/v3/users/#get-a-user)" endpoint. Can be one of: `none` or `read`. | +| [`pull_requests`](/rest/reference/permissions-required-for-github-apps/#permission-on-pull-requests) | Grants access to various pull request endpoints. Can be one of: `none`, `read`, or `write`. | +| [`repository_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-hooks) | Grants access to the [Repository Webhooks API](/v3/repos/hooks/). Can be one of: `none`, `read`, or `write`. | +| [`repository_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-projects) | Grants access to the [Projects API](/v3/projects/). Can be one of: `none`, `read`, `write`, or `admin`. | +| [`single_file`](/rest/reference/permissions-required-for-github-apps/#permission-on-single-file) | Grants access to the [Contents API](/v3/repos/contents/). Can be one of: `none`, `read`, or `write`. | +| [`starring`](/rest/reference/permissions-required-for-github-apps/#permission-on-starring) | Grants access to the [Starring API](/v3/activity/starring/). Can be one of: `none`, `read`, or `write`. | +| [`statuses`](/rest/reference/permissions-required-for-github-apps/#permission-on-statuses) | Grants access to the [Statuses API](/v3/repos/statuses/). Can be one of: `none`, `read`, or `write`. | +| [`team_discussions`](/rest/reference/permissions-required-for-github-apps/#permission-on-team-discussions) | Grants access to the [Team Discussions API](/v3/teams/discussions/) and the [Team Discussion Comments API](/v3/teams/discussion_comments/). Can be one of: `none`, `read`, or `write`. | +| `vulnerability_alerts` | Grants access to receive security alerts for vulnerable dependencies in a repository. See "[About security alerts for vulnerable dependencies](/articles/about-security-alerts-for-vulnerable-dependencies)" to learn more. Can be one of: `none` or `read`. | +| `시청` | Grants access to list and change repositories a user is subscribed to. Can be one of: `none`, `read`, or `write`. | ### {% data variables.product.prodname_github_app %} webhook events -| Webhook event name | Required permission | 설명 | -| -------------------------------------------------------------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------ | -| [`check_run`](/webhooks/event-payloads/#check_run) | `checks` | {% data reusables.webhooks.check_run_short_desc %} | -| [`check_suite`](/webhooks/event-payloads/#check_suite) | `checks` | {% data reusables.webhooks.check_suite_short_desc %} | -| [`commit_comment`](/webhooks/event-payloads/#commit_comment) | `contents` | {% data reusables.webhooks.commit_comment_short_desc %} | -| [`content_reference`](/webhooks/event-payloads/#content_reference) | `content_references` | {% data reusables.webhooks.content_reference_short_desc %} | -| [`create`](/webhooks/event-payloads/#create) | `contents` | {% data reusables.webhooks.create_short_desc %} | -| [`delete`](/webhooks/event-payloads/#delete) | `contents` | {% data reusables.webhooks.delete_short_desc %} | -| [`deployment`](/webhooks/event-payloads/#deployment) | `deployments` | {% data reusables.webhooks.deployment_short_desc %} | -| [`deployment_status`](/webhooks/event-payloads/#deployment_status) | `deployments` | {% data reusables.webhooks.deployment_status_short_desc %} | -| [`포크`](/webhooks/event-payloads/#fork) | `contents` | {% data reusables.webhooks.fork_short_desc %} | -| [`gollum`](/webhooks/event-payloads/#gollum) | `contents` | {% data reusables.webhooks.gollum_short_desc %} | -| [`issues`](/webhooks/event-payloads/#issues) | `issues` | {% data reusables.webhooks.issues_short_desc %} | -| [`issue_comment`](/webhooks/event-payloads/#issue_comment) | `issues` | {% data reusables.webhooks.issue_comment_short_desc %} | -| [`레이블`](/webhooks/event-payloads/#label) | `메타데이터` | {% data reusables.webhooks.label_short_desc %} | -| [`구성원`](/webhooks/event-payloads/#member) | `members` | {% data reusables.webhooks.member_short_desc %} | -| [`membership`](/webhooks/event-payloads/#membership) | `members` | {% data reusables.webhooks.membership_short_desc %} | +| Webhook event name | Required permission | 설명 | +| -------------------------------------------------------------------------------------- | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------- | +| [`check_run`](/webhooks/event-payloads/#check_run) | `checks` | {% data reusables.webhooks.check_run_short_desc %} +| [`check_suite`](/webhooks/event-payloads/#check_suite) | `checks` | {% data reusables.webhooks.check_suite_short_desc %} +| [`commit_comment`](/webhooks/event-payloads/#commit_comment) | `contents` | {% data reusables.webhooks.commit_comment_short_desc %} +| [`content_reference`](/webhooks/event-payloads/#content_reference) | `content_references` | {% data reusables.webhooks.content_reference_short_desc %} +| [`create`](/webhooks/event-payloads/#create) | `contents` | {% data reusables.webhooks.create_short_desc %} +| [`delete`](/webhooks/event-payloads/#delete) | `contents` | {% data reusables.webhooks.delete_short_desc %} +| [`deployment`](/webhooks/event-payloads/#deployment) | `deployments` | {% data reusables.webhooks.deployment_short_desc %} +| [`deployment_status`](/webhooks/event-payloads/#deployment_status) | `deployments` | {% data reusables.webhooks.deployment_status_short_desc %} +| [`포크`](/webhooks/event-payloads/#fork) | `contents` | {% data reusables.webhooks.fork_short_desc %} +| [`gollum`](/webhooks/event-payloads/#gollum) | `contents` | {% data reusables.webhooks.gollum_short_desc %} +| [`issues`](/webhooks/event-payloads/#issues) | `issues` | {% data reusables.webhooks.issues_short_desc %} +| [`issue_comment`](/webhooks/event-payloads/#issue_comment) | `issues` | {% data reusables.webhooks.issue_comment_short_desc %} +| [`레이블`](/webhooks/event-payloads/#label) | `메타데이터` | {% data reusables.webhooks.label_short_desc %} +| [`구성원`](/webhooks/event-payloads/#member) | `members` | {% data reusables.webhooks.member_short_desc %} +| [`membership`](/webhooks/event-payloads/#membership) | `members` | {% data reusables.webhooks.membership_short_desc %} | [`마일스톤`](/webhooks/event-payloads/#milestone) | `pull_request` | {% data reusables.webhooks.milestone_short_desc %}{% if currentVersion == "free-pro-team@latest" %} | [`org_block`](/webhooks/event-payloads/#org_block) | `organization_administration` | {% data reusables.webhooks.org_block_short_desc %}{% endif %} -| [`조직`](/webhooks/event-payloads/#organization) | `members` | {% data reusables.webhooks.organization_short_desc %} | -| [`page_build`](/webhooks/event-payloads/#page_build) | `pages` | {% data reusables.webhooks.page_build_short_desc %} | -| [`프로젝트`](/webhooks/event-payloads/#project) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_short_desc %} | -| [`project_card`](/webhooks/event-payloads/#project_card) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_card_short_desc %} | -| [`project_column`](/webhooks/event-payloads/#project_column) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_column_short_desc %} | -| [`public`](/webhooks/event-payloads/#public) | `메타데이터` | {% data reusables.webhooks.public_short_desc %} | -| [`pull_request`](/webhooks/event-payloads/#pull_request) | `pull_requests` | {% data reusables.webhooks.pull_request_short_desc %} | -| [`pull_request_review`](/webhooks/event-payloads/#pull_request_review) | `pull_request` | {% data reusables.webhooks.pull_request_review_short_desc %} | -| [`pull_request_review_comment`](/webhooks/event-payloads/#pull_request_review_comment) | `pull_request` | {% data reusables.webhooks.pull_request_review_comment_short_desc %} | -| [`푸시`](/webhooks/event-payloads/#push) | `contents` | {% data reusables.webhooks.push_short_desc %} | -| [`릴리스`](/webhooks/event-payloads/#release) | `contents` | {% data reusables.webhooks.release_short_desc %} | +| [`조직`](/webhooks/event-payloads/#organization) | `members` | {% data reusables.webhooks.organization_short_desc %} +| [`page_build`](/webhooks/event-payloads/#page_build) | `pages` | {% data reusables.webhooks.page_build_short_desc %} +| [`프로젝트`](/webhooks/event-payloads/#project) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_short_desc %} +| [`project_card`](/webhooks/event-payloads/#project_card) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_card_short_desc %} +| [`project_column`](/webhooks/event-payloads/#project_column) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_column_short_desc %} +| [`public`](/webhooks/event-payloads/#public) | `메타데이터` | {% data reusables.webhooks.public_short_desc %} +| [`pull_request`](/webhooks/event-payloads/#pull_request) | `pull_requests` | {% data reusables.webhooks.pull_request_short_desc %} +| [`pull_request_review`](/webhooks/event-payloads/#pull_request_review) | `pull_request` | {% data reusables.webhooks.pull_request_review_short_desc %} +| [`pull_request_review_comment`](/webhooks/event-payloads/#pull_request_review_comment) | `pull_request` | {% data reusables.webhooks.pull_request_review_comment_short_desc %} +| [`푸시`](/webhooks/event-payloads/#push) | `contents` | {% data reusables.webhooks.push_short_desc %} +| [`릴리스`](/webhooks/event-payloads/#release) | `contents` | {% data reusables.webhooks.release_short_desc %} | [`리포지토리`](/webhooks/event-payloads/#repository) | `메타데이터` | {% data reusables.webhooks.repository_short_desc %}{% if currentVersion == "free-pro-team@latest"%} | [`repository_dispatch`](/webhooks/event-payloads/#repository_dispatch) | `contents` | Allows integrators using GitHub Actions to trigger custom events.{% endif %} -| [`상태`](/webhooks/event-payloads/#status) | `statuses` | {% data reusables.webhooks.status_short_desc %} | -| [`팀`](/webhooks/event-payloads/#team) | `members` | {% data reusables.webhooks.team_short_desc %} | -| [`team_add`](/webhooks/event-payloads/#team_add) | `members` | {% data reusables.webhooks.team_add_short_desc %} | -| [`보기`](/webhooks/event-payloads/#watch) | `메타데이터` | {% data reusables.webhooks.watch_short_desc %} | +| [`상태`](/webhooks/event-payloads/#status) | `statuses` | {% data reusables.webhooks.status_short_desc %} +| [`팀`](/webhooks/event-payloads/#team) | `members` | {% data reusables.webhooks.team_short_desc %} +| [`team_add`](/webhooks/event-payloads/#team_add) | `members` | {% data reusables.webhooks.team_add_short_desc %} +| [`보기`](/webhooks/event-payloads/#watch) | `메타데이터` | {% data reusables.webhooks.watch_short_desc %} diff --git a/translations/ko-KR/content/developers/apps/creating-ci-tests-with-the-checks-api.md b/translations/ko-KR/content/developers/apps/creating-ci-tests-with-the-checks-api.md index cf175b85d04b..265d0ab27033 100644 --- a/translations/ko-KR/content/developers/apps/creating-ci-tests-with-the-checks-api.md +++ b/translations/ko-KR/content/developers/apps/creating-ci-tests-with-the-checks-api.md @@ -9,7 +9,6 @@ versions: --- - ### Introduction This guide will introduce you to [Github Apps](/apps/) and the [Checks API](/v3/checks/), which you'll use to build a continuous integration (CI) server that runs tests. @@ -134,6 +133,26 @@ The `requested` action requests a check run each time code is pushed to the repo You'll add this new method as a [Sinatra helper](https://github.com/sinatra/sinatra#helpers) in case you want other routes to use it too. Under `helpers do`, add this `create_check_run` method: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +``` ruby +# Create a new check run with the status queued +def create_check_run + # # At the time of writing, Octokit does not support the Checks API yet, but + # it does provide generic HTTP methods you can use: + # /v3/checks/runs/#create-a-check-run + check_run = @installation_client.post( + "repos/#{@payload['repository']['full_name']}/check-runs", + { + accept: 'application/vnd.github.v3+json', + # The name of your check run. + name: 'Octo RuboCop', + # The payload structure differs depending on whether a check run or a check suite event occurred. + head_sha: @payload['check_run'].nil? ? @payload['check_suite']['head_sha'] : @payload['check_run']['head_sha'] + } + ) +end +``` +{% else %} ``` ruby # Create a new check run with the status queued def create_check_run @@ -153,6 +172,7 @@ def create_check_run ) end ``` +{% endif %} This code calls the "[Create a check run](/v3/checks/runs/#create-a-check-run)" endpoint using the generic [HTTP `POST` method](http://octokit.github.io/octokit.rb/Octokit/Connection.html#post-instance_method). This method takes two parameters: the URL of the endpoint and the input parameters to the method. @@ -209,6 +229,43 @@ In this section, you're not going to kick off the CI test yet, but you'll walk t Let's create the `initiate_check_run` method and update the status of the check run. Add the following code to the helpers section: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +``` ruby +# Start the CI process +def initiate_check_run + # Once the check run is created, you'll update the status of the check run + # to 'in_progress' and run the CI process. When the CI finishes, you'll + # update the check run status to 'completed' and add the CI results. + + # Octokit doesn't yet support the Checks API, but it does provide generic + # HTTP methods you can use: + # /v3/checks/runs/#update-a-check-run + updated_check_run = @installation_client.patch( + "repos/#{@payload['repository']['full_name']}/check-runs/#{@payload['check_run']['id']}", + { + accept: 'application/vnd.github.v3+json', + name: 'Octo RuboCop', + status: 'in_progress', + started_at: Time.now.utc.iso8601 + } + ) + + # ***** RUN A CI TEST ***** + + # Mark the check run as complete! + updated_check_run = @installation_client.patch( + "repos/#{@payload['repository']['full_name']}/check-runs/#{@payload['check_run']['id']}", + { + accept: 'application/vnd.github.v3+json', + name: 'Octo RuboCop', + status: 'completed', + conclusion: 'success', + completed_at: Time.now.utc.iso8601 + } + ) +end +``` +{% else %} ``` ruby # Start the CI process def initiate_check_run @@ -245,6 +302,7 @@ def initiate_check_run ) end ``` +{% endif %} The code above calls the "[Update a check run](/v3/checks/runs/#update-a-check-run)" API endpoint using the generic [`patch` HTTP method](http://octokit.github.io/octokit.rb/Octokit/Connection.html#patch-instance_method) to update the check run that you already created. @@ -549,6 +607,21 @@ text = "Octo RuboCop version: #{@output['metadata']['rubocop_version']}" Now you've got all the information you need to update your check run. In the [first half of this quickstart](#step-14-updating-a-check-run), you added this code to set the status of the check run to `success`: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +``` ruby +# Mark the check run as complete! +updated_check_run = @installation_client.patch( + "repos/#{@payload['repository']['full_name']}/check-runs/#{@payload['check_run']['id']}", + { + accept: 'application/vnd.github.v3+json', + name: 'Octo RuboCop', + status: 'completed', + conclusion: 'success', + completed_at: Time.now.utc.iso8601 + } +) +``` +{% else %} ``` ruby # Mark the check run as complete! updated_check_run = @installation_client.patch( @@ -562,9 +635,36 @@ updated_check_run = @installation_client.patch( } ) ``` +{% endif %} You'll need to update that code to use the `conclusion` variable you set based on the RuboCop results (to `success` or `neutral`). You can update the code with the following: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +``` ruby +# Mark the check run as complete! And if there are warnings, share them. +updated_check_run = @installation_client.patch( + "repos/#{@payload['repository']['full_name']}/check-runs/#{@payload['check_run']['id']}", + { + accept: 'application/vnd.github.v3+json', + name: 'Octo RuboCop', + status: 'completed', + conclusion: conclusion, + completed_at: Time.now.utc.iso8601, + output: { + title: 'Octo RuboCop', + summary: summary, + text: text, + annotations: annotations + }, + actions: [{ + label: 'Fix this', + description: 'Automatically fix all linter notices.', + identifier: 'fix_rubocop_notices' + }] + } +) +``` +{% else %} ``` ruby # Mark the check run as complete! And if there are warnings, share them. updated_check_run = @installation_client.patch( @@ -589,6 +689,7 @@ updated_check_run = @installation_client.patch( } ) ``` +{% endif %} Now that you're setting a conclusion based on the status of the CI test and you've added the output from the RuboCop results, you've created a CI test! Congratulations. 🙌 diff --git a/translations/ko-KR/content/developers/apps/differences-between-github-apps-and-oauth-apps.md b/translations/ko-KR/content/developers/apps/differences-between-github-apps-and-oauth-apps.md index ced8bc405e53..32c31b7249aa 100644 --- a/translations/ko-KR/content/developers/apps/differences-between-github-apps-and-oauth-apps.md +++ b/translations/ko-KR/content/developers/apps/differences-between-github-apps-and-oauth-apps.md @@ -50,13 +50,13 @@ An _authorized_ OAuth App has access to all of the user's or organization owner' {% endnote %} -| GitHub Apps | OAuth Apps | -| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| A GitHub App can request an installation access token by using a private key with a JSON web token format out-of-band. | An OAuth app can exchange a request token for an access token after a redirect via a web request. | -| An installation token identifies the app as the GitHub Apps bot, such as @jenkins-bot. | An access token identifies the app as the user who granted the token to the app, such as @octocat. | -| Installation tokens expire after a predefined amount of time (currently 1 hour). | OAuth tokens remain active until they're revoked by the customer. | -| {% data reusables.apps.api-rate-limits-non-ghec %}{% if currentVersion == "free-pro-team@latest" %} Higher rate limits apply for {% data variables.product.prodname_ghe_cloud %}. For more information, see "[Rate limits for GitHub Apps](/developers/apps/rate-limits-for-github-apps)."{% endif %} | OAuth tokens use the user's rate limit of 5,000 requests per hour. | -| Rate limit increases can be granted both at the GitHub Apps level (affecting all installations) and at the individual installation level. | Rate limit increases are granted per OAuth App. Every token granted to that OAuth App gets the increased limit. |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} +| GitHub Apps | OAuth Apps | +| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| A GitHub App can request an installation access token by using a private key with a JSON web token format out-of-band. | An OAuth app can exchange a request token for an access token after a redirect via a web request. | +| An installation token identifies the app as the GitHub Apps bot, such as @jenkins-bot. | An access token identifies the app as the user who granted the token to the app, such as @octocat. | +| Installation tokens expire after a predefined amount of time (currently 1 hour). | OAuth tokens remain active until they're revoked by the customer. | +| {% data reusables.apps.api-rate-limits-non-ghec %}{% if currentVersion == "free-pro-team@latest" %} Higher rate limits apply for {% data variables.product.prodname_ghe_cloud %}. For more information, see "[Rate limits for GitHub Apps](/developers/apps/rate-limits-for-github-apps)."{% endif %} | OAuth tokens use the user's rate limit of 5,000 requests per hour. | +| Rate limit increases can be granted both at the GitHub Apps level (affecting all installations) and at the individual installation level. | Rate limit increases are granted per OAuth App. Every token granted to that OAuth App gets the increased limit. |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} | {% data variables.product.prodname_github_app %}s can authenticate on behalf of the user, which is called user-to-server requests. The flow to authorize is the same as the OAuth App authorization flow. User-to-server tokens can expire and be renewed with a refresh token. For more information, see "[Refreshing user-to-server access tokens](/apps/building-github-apps/refreshing-user-to-server-access-tokens/)" and "[Identifying and authorizing users for GitHub Apps](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/)." | The OAuth flow used by {% data variables.product.prodname_oauth_app %}s authorizes an {% data variables.product.prodname_oauth_app %} on behalf of the user. This is the same flow used in {% data variables.product.prodname_github_app %} user-to-server authorization. |{% endif %} ### Requesting permission levels for resources @@ -102,5 +102,5 @@ Bot accounts are specific to GitHub Apps and are built into every GitHub App. | GitHub Apps | OAuth Apps | | --------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | -| GitHub App bots do not consume a {% data variables.product.prodname_enterprise %} seat. | A machine user account consumes a {% data variables.product.prodname_enterprise %} seat. | +| GitHub App bots do not consume a {% data variables.product.prodname_enterprise %} seat. | A machine user account consumes a {% data variables.product.prodname_enterprise %} seat. | | Because a GitHub App bot is never granted a password, a customer can't sign into it directly. | A machine user account is granted a username and password to be managed and secured by the customer. | diff --git a/translations/ko-KR/content/developers/apps/editing-a-github-apps-permissions.md b/translations/ko-KR/content/developers/apps/editing-a-github-apps-permissions.md index 5526135a4641..acbef5efe59f 100644 --- a/translations/ko-KR/content/developers/apps/editing-a-github-apps-permissions.md +++ b/translations/ko-KR/content/developers/apps/editing-a-github-apps-permissions.md @@ -9,6 +9,8 @@ versions: enterprise-server: '*' --- +{% note %} + **Note:** Updated permissions won't take effect on an installation until the owner of the account or organization approves the changes. You can use the [InstallationEvent webhook](/webhooks/event-payloads/#installation) to find out when people accept new permissions for your app. One exception is [user-level permissions](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/#user-level-permissions), which don't require the account owner to approve permission changes. {% endnote %} diff --git a/translations/ko-KR/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md b/translations/ko-KR/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md index c32a25669b9a..96441ecb7be2 100644 --- a/translations/ko-KR/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md +++ b/translations/ko-KR/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md @@ -241,25 +241,25 @@ While most of your API interaction should occur using your server-to-server inst ##### Deployment Statuses -* [List deployment statuses](/v3/repos/deployments/#list-deployment-statuses) -* [Create a deployment status](/v3/repos/deployments/#create-a-deployment-status) -* [Get a deployment status](/v3/repos/deployments/#get-a-deployment-status) +* [List deployment statuses](/rest/reference/repos#list-deployment-statuses) +* [Create a deployment status](/rest/reference/repos#create-a-deployment-status) +* [Get a deployment status](/rest/reference/repos#get-a-deployment-status) ##### Deployments -* [List deployments](/v3/repos/deployments/#list-deployments) -* [Create a deployment](/v3/repos/deployments/#create-a-deployment) -* [Get a deployment](/v3/repos/deployments/#get-a-deployment){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -* [Delete a deployment](/v3/repos/deployments/#delete-a-deployment){% endif %} +* [List deployments](/rest/reference/repos#list-deployments) +* [Create a deployment](/rest/reference/repos#create-a-deployment) +* [Get a deployment](/rest/reference/repos#get-a-deployment){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +* [Delete a deployment](/rest/reference/repos#delete-a-deployment){% endif %} ##### 이벤트 -* [List public events for a network of repositories](/v3/activity/events/#list-public-events-for-a-network-of-repositories) -* [List public organization events](/v3/activity/events/#list-public-organization-events) +* [List public events for a network of repositories](/rest/reference/activity#list-public-events-for-a-network-of-repositories) +* [List public organization events](/rest/reference/activity#list-public-organization-events) ##### Feeds -* [Get feeds](/v3/activity/feeds/#get-feeds) +* [Get feeds](/rest/reference/activity#get-feeds) ##### Git Blobs @@ -273,11 +273,8 @@ While most of your API interaction should occur using your server-to-server inst ##### Git Refs -* [Create a reference](/v3/git/refs/#create-a-reference){% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -* [List references](/v3/git/refs/#list-references) -* [Get a reference](/v3/git/refs/#get-a-reference){% else %} -* [Get a reference](/v3/git/refs/#get-a-reference) -* [List matching references](/v3/git/refs/#list-matching-references){% endif %} +* [Create a reference](/v3/git/refs/#create-a-reference)* [Get a reference](/v3/git/refs/#get-a-reference) +* [List matching references](/v3/git/refs/#list-matching-references) * [Update a reference](/v3/git/refs/#update-a-reference) * [Delete a reference](/v3/git/refs/#delete-a-reference) @@ -391,12 +388,12 @@ While most of your API interaction should occur using your server-to-server inst ##### Organization Hooks -* [List organization webhooks](/v3/orgs/hooks/#list-organization-webhooks) -* [Create an organization webhook](/v3/orgs/hooks/#create-an-organization-webhook) -* [Get an organization webhook](/v3/orgs/hooks/#get-an-organization-webhook) -* [Update an organization webhook](/v3/orgs/hooks/#update-an-organization-webhook) -* [Delete an organization webhook](/v3/orgs/hooks/#delete-an-organization-webhook) -* [Ping an organization webhook](/v3/orgs/hooks/#ping-an-organization-webhook) +* [List organization webhooks](/rest/reference/orgs#webhooks/#list-organization-webhooks) +* [Create an organization webhook](/rest/reference/orgs#webhooks/#create-an-organization-webhook) +* [Get an organization webhook](/rest/reference/orgs#webhooks/#get-an-organization-webhook) +* [Update an organization webhook](/rest/reference/orgs#webhooks/#update-an-organization-webhook) +* [Delete an organization webhook](/rest/reference/orgs#webhooks/#delete-an-organization-webhook) +* [Ping an organization webhook](/rest/reference/orgs#webhooks/#ping-an-organization-webhook) {% if currentVersion == "free-pro-team@latest" %} ##### Organization Invitations @@ -619,7 +616,7 @@ While most of your API interaction should occur using your server-to-server inst * [Delete a repository](/v3/repos/#delete-a-repository) * [Compare two commits](/v3/repos/commits/#compare-two-commits) * [List repository contributors](/v3/repos/#list-repository-contributors) -* [List forks](/v3/repos/forks/#list-forks) +* [List forks](/rest/reference/repos#list-forks) * [Create a fork](/v3/repos/forks/#create-a-fork) * [List repository languages](/v3/repos/#list-repository-languages) * [List repository tags](/v3/repos/#list-repository-tags) @@ -632,13 +629,13 @@ While most of your API interaction should occur using your server-to-server inst ##### Repository Activity -* [List stargazers](/v3/activity/starring/#list-stargazers) -* [List watchers](/v3/activity/watching/#list-watchers) -* [List repositories starred by a user](/v3/activity/starring/#list-repositories-starred-by-a-user) -* [Check if a repository is starred by the authenticated user](/v3/activity/starring/#check-if-a-repository-is-starred-by-the-authenticated-user) -* [Star a repository for the authenticated user](/v3/activity/starring/#star-a-repository-for-the-authenticated-user) -* [Unstar a repository for the authenticated user](/v3/activity/starring/#unstar-a-repository-for-the-authenticated-user) -* [List repositories watched by a user](/v3/activity/watching/#list-repositories-watched-by-a-user) +* [List stargazers](/rest/reference/activity#list-stargazers) +* [List watchers](/rest/reference/activity#list-watchers) +* [List repositories starred by a user](/rest/reference/activity#list-repositories-starred-by-a-user) +* [Check if a repository is starred by the authenticated user](/rest/reference/activity#check-if-a-repository-is-starred-by-the-authenticated-user) +* [Star a repository for the authenticated user](/rest/reference/activity#star-a-repository-for-the-authenticated-user) +* [Unstar a repository for the authenticated user](/rest/reference/activity#unstar-a-repository-for-the-authenticated-user) +* [List repositories watched by a user](/rest/reference/activity#list-repositories-watched-by-a-user) {% if currentVersion == "free-pro-team@latest" %} ##### Repository Automated Security Fixes @@ -756,14 +753,14 @@ While most of your API interaction should occur using your server-to-server inst ##### Repository Pages -* [Get a GitHub Pages site](/v3/repos/pages/#get-a-github-pages-site) -* [Create a GitHub Pages site](/v3/repos/pages/#create-a-github-pages-site) -* [Update information about a GitHub Pages site](/v3/repos/pages/#update-information-about-a-github-pages-site) -* [Delete a GitHub Pages site](/v3/repos/pages/#delete-a-github-pages-site) -* [List GitHub Pages builds](/v3/repos/pages/#list-github-pages-builds) -* [Request a GitHub Pages build](/v3/repos/pages/#request-a-github-pages-build) -* [Get GitHub Pages build](/v3/repos/pages/#get-github-pages-build) -* [Get latest pages build](/v3/repos/pages/#get-latest-pages-build) +* [Get a GitHub Pages site](/rest/reference/repos#get-a-github-pages-site) +* [Create a GitHub Pages site](/rest/reference/repos#create-a-github-pages-site) +* [Update information about a GitHub Pages site](/rest/reference/repos#update-information-about-a-github-pages-site) +* [Delete a GitHub Pages site](/rest/reference/repos#delete-a-github-pages-site) +* [List GitHub Pages builds](/rest/reference/repos#list-github-pages-builds) +* [Request a GitHub Pages build](/rest/reference/repos#request-a-github-pages-build) +* [Get GitHub Pages build](/rest/reference/repos#get-github-pages-build) +* [Get latest pages build](/rest/reference/repos#get-latest-pages-build) {% if currentVersion != "free-pro-team@latest" %} ##### Repository Pre Receive Hooks @@ -776,17 +773,17 @@ While most of your API interaction should occur using your server-to-server inst ##### Repository Releases -* [List releases](/v3/repos/releases/#list-releases) -* [Create a release](/v3/repos/releases/#create-a-release) -* [Get a release](/v3/repos/releases/#get-a-release) -* [Update a release](/v3/repos/releases/#update-a-release) -* [Delete a release](/v3/repos/releases/#delete-a-release) -* [List release assets](/v3/repos/releases/#list-release-assets) -* [Get a release asset](/v3/repos/releases/#get-a-release-asset) -* [Update a release asset](/v3/repos/releases/#update-a-release-asset) -* [Delete a release asset](/v3/repos/releases/#delete-a-release-asset) -* [Get the latest release](/v3/repos/releases/#get-the-latest-release) -* [Get a release by tag name](/v3/repos/releases/#get-a-release-by-tag-name) +* [List releases](/rest/reference/repos/#list-releases) +* [Create a release](/rest/reference/repos/#create-a-release) +* [Get a release](/rest/reference/repos/#get-a-release) +* [Update a release](/rest/reference/repos/#update-a-release) +* [Delete a release](/rest/reference/repos/#delete-a-release) +* [List release assets](/rest/reference/repos/#list-release-assets) +* [Get a release asset](/rest/reference/repos/#get-a-release-asset) +* [Update a release asset](/rest/reference/repos/#update-a-release-asset) +* [Delete a release asset](/rest/reference/repos/#delete-a-release-asset) +* [Get the latest release](/rest/reference/repos/#get-the-latest-release) +* [Get a release by tag name](/rest/reference/repos/#get-a-release-by-tag-name) ##### Repository Stats diff --git a/translations/ko-KR/content/developers/apps/migrating-oauth-apps-to-github-apps.md b/translations/ko-KR/content/developers/apps/migrating-oauth-apps-to-github-apps.md index e56daaa87600..b81f4b36768a 100644 --- a/translations/ko-KR/content/developers/apps/migrating-oauth-apps-to-github-apps.md +++ b/translations/ko-KR/content/developers/apps/migrating-oauth-apps-to-github-apps.md @@ -11,7 +11,6 @@ versions: This article provides guidelines for existing integrators who are considering migrating from an OAuth App to a GitHub App. - ### Reasons for switching to GitHub Apps [GitHub Apps](/apps/) are the officially recommended way to integrate with GitHub because they offer many advantages over a pure OAuth-based integration: diff --git a/translations/ko-KR/content/developers/apps/modifying-an-oauth-app.md b/translations/ko-KR/content/developers/apps/modifying-an-oauth-app.md index 869475ce85bd..3e45db618208 100644 --- a/translations/ko-KR/content/developers/apps/modifying-an-oauth-app.md +++ b/translations/ko-KR/content/developers/apps/modifying-an-oauth-app.md @@ -9,12 +9,10 @@ versions: enterprise-server: '*' --- - - - {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.oauth_apps %} {% data reusables.user-settings.modify_oauth_app %} -5. Modify the {% data variables.product.prodname_oauth_app %} information that you'd like to change. +1. Modify the +{% data variables.product.prodname_oauth_app %} information that you'd like to change. {% data reusables.user-settings.update_oauth_app %} diff --git a/translations/ko-KR/content/developers/apps/refreshing-user-to-server-access-tokens.md b/translations/ko-KR/content/developers/apps/refreshing-user-to-server-access-tokens.md index 63df5d23b018..ca3b723edb0e 100644 --- a/translations/ko-KR/content/developers/apps/refreshing-user-to-server-access-tokens.md +++ b/translations/ko-KR/content/developers/apps/refreshing-user-to-server-access-tokens.md @@ -28,10 +28,10 @@ This callback request will send you a new access token and a new refresh token. #### 매개변수 -| 이름 | 유형 | 설명 | -| --------------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 이름 | 유형 | 설명 | +| --------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `refresh_token` | `문자열` | **Required.** The token generated when the {% data variables.product.prodname_github_app %} owner enables expiring tokens and issues a new user access token. | -| `grant_type` | `문자열` | **Required.** Value must be `refresh_token` (required by the OAuth specification). | +| `grant_type` | `문자열` | **Required.** Value must be `refresh_token` (required by the OAuth specification). | | `client_id` | `문자열` | **Required.** The client ID for your {% data variables.product.prodname_github_app %}. | | `client_secret` | `문자열` | **Required.** The client secret for your {% data variables.product.prodname_github_app %}. | diff --git a/translations/ko-KR/content/developers/apps/scopes-for-oauth-apps.md b/translations/ko-KR/content/developers/apps/scopes-for-oauth-apps.md index 7cca3aa959bc..94be43cb22a6 100644 --- a/translations/ko-KR/content/developers/apps/scopes-for-oauth-apps.md +++ b/translations/ko-KR/content/developers/apps/scopes-for-oauth-apps.md @@ -19,7 +19,8 @@ When setting up an OAuth App on GitHub, requested scopes are displayed to the us {% endnote %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -If your {% data variables.product.prodname_oauth_app %} doesn't have access to a browser, such as a CLI tool, then you don't need to specify a scope for users to authenticate to your app. For more information, see "[Authorizing OAuth apps](/developers/apps/authorizing-oauth-apps#device-flow)." +If your +{% data variables.product.prodname_oauth_app %} doesn't have access to a browser, such as a CLI tool, then you don't need to specify a scope for users to authenticate to your app. For more information, see "[Authorizing OAuth apps](/developers/apps/authorizing-oauth-apps#device-flow)." {% endif %} Check headers to see what OAuth scopes you have, and what the API action accepts: @@ -65,8 +66,8 @@ X-Accepted-OAuth-Scopes: user | **`delete_repo`** | Grants access to delete adminable repositories. | | **`write:discussion`** | Allows read and write access for team discussions. | |  `read:discussion` | Allows read access for team discussions.{% if currentVersion == "free-pro-team@latest" %} -| **`write:packages`** | Grants access to upload or publish a package in {% data variables.product.prodname_registry %}. For more information, see "[Publishing a package](/github/managing-packages-with-github-packages/publishing-a-package)". | -| **`read:packages`** | Grants access to download or install packages from {% data variables.product.prodname_registry %}. For more information, see "[Installing a package](/github/managing-packages-with-github-packages/installing-a-package)". | +| **`write:packages`** | Grants access to upload or publish a package in {% data variables.product.prodname_registry %}. For more information, see "[Publishing a package](/github/managing-packages-with-github-packages/publishing-a-package)". | +| **`read:packages`** | Grants access to download or install packages from {% data variables.product.prodname_registry %}. For more information, see "[Installing a package](/github/managing-packages-with-github-packages/installing-a-package)". | | **`delete:packages`** | Grants access to delete packages from {% data variables.product.prodname_registry %}. For more information, see "[Deleting packages](/github/managing-packages-with-github-packages/deleting-a-package)".{% endif %} | **`admin:gpg_key`** | Fully manage GPG keys. | |  `write:gpg_key` | Create, list, and view details for GPG keys. | diff --git a/translations/ko-KR/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md b/translations/ko-KR/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md index 9944b10a09c5..49f0a9a0e9fe 100644 --- a/translations/ko-KR/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md +++ b/translations/ko-KR/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md @@ -9,7 +9,6 @@ versions: --- - ### Introduction This guide will walk through the steps needed to configure a GitHub App and run it on a server. GitHub Apps require some setup steps to manage webhook events and connect the app registration on GitHub to your code. The app in this guide serves as a foundation that you can use to extend and build new GitHub Apps. diff --git a/translations/ko-KR/content/developers/apps/suspending-a-github-app-installation.md b/translations/ko-KR/content/developers/apps/suspending-a-github-app-installation.md index e964d827d9ae..caf739366085 100644 --- a/translations/ko-KR/content/developers/apps/suspending-a-github-app-installation.md +++ b/translations/ko-KR/content/developers/apps/suspending-a-github-app-installation.md @@ -17,13 +17,15 @@ versions: ### Suspending a GitHub App -To suspend a {% data variables.product.prodname_github_app %}, you must be an account owner or have admin permissions in the repository or organization where the app you want to suspend is installed. +The integrator who owns and maintains a GitHub app, also called a GitHub App owner, can suspend or unsuspend a GitHub App installation using REST API endpoints with a JWT. For more information, see the [GitHub Apps REST API](/rest/reference/apps). -You can also suspend and unsuspend {% data variables.product.prodname_github_app %} installations using the REST API. For more information, see the [GitHub Apps REST API](/v3/apps/). +People who have installed a GitHub App, also called installation owners, can only suspend or unsuspend a GitHub App through their app's installation settings. Installation owners cannot use the API to suspend or unsuspend their app installation. Before people can suspend a GitHub app installation, the GitHub App owner must opt-in to the beta release. For more information, see "[Suspending a GitHub App installation](/apps/managing-github-apps/suspending-a-github-app-installation/)." {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.github_apps %} -4. Select the {% data variables.product.prodname_github_app %} you want to suspend. ![App selection](/assets/images/github-apps/github_apps_select-app.png) +4. Select the +{% data variables.product.prodname_github_app %} you want to suspend. +![App selection](/assets/images/github-apps/github_apps_select-app.png) {% data reusables.user-settings.github_apps_advanced %} 6. Next to the suspension settings for the installation, click **Suspend** or **Unsuspend**. ![Suspend a GitHub App](/assets/images/github-apps/suspend-a-github-app.png) diff --git a/translations/ko-KR/content/developers/apps/using-the-github-api-in-your-app.md b/translations/ko-KR/content/developers/apps/using-the-github-api-in-your-app.md index 449e6712ed5f..ab62f09f74f3 100644 --- a/translations/ko-KR/content/developers/apps/using-the-github-api-in-your-app.md +++ b/translations/ko-KR/content/developers/apps/using-the-github-api-in-your-app.md @@ -10,7 +10,6 @@ versions: --- - ### Introduction This guide will help you build a GitHub App and run it on a server. The app you build will add a label to all new issues opened in the repository where the app is installed. diff --git a/translations/ko-KR/content/developers/github-marketplace/drafting-a-listing-for-your-app.md b/translations/ko-KR/content/developers/github-marketplace/drafting-a-listing-for-your-app.md index 0da8b2f8d741..7bc6b6e54221 100644 --- a/translations/ko-KR/content/developers/github-marketplace/drafting-a-listing-for-your-app.md +++ b/translations/ko-KR/content/developers/github-marketplace/drafting-a-listing-for-your-app.md @@ -40,7 +40,10 @@ To create a {% data variables.product.prodname_marketplace %} listing: ![App type selection](/assets/images/settings/apps_choose_app.png) -4. Select the app you'd like to add to {% data variables.product.prodname_marketplace %}. ![App selection for {% data variables.product.prodname_marketplace %} listing](/assets/images/github-apps/github_apps_select-app.png) +4. Select the app you'd like to add to + +{% data variables.product.prodname_marketplace %}. +![App selection for {% data variables.product.prodname_marketplace %} listing](/assets/images/github-apps/github_apps_select-app.png) {% data reusables.user-settings.edit_marketplace_listing %} 5. Once you've created a new draft listing, you'll see an overview of the sections that you'll need to visit before your {% data variables.product.prodname_marketplace %} listing will be complete. ![GitHub Marketplace listing](/assets/images/marketplace/marketplace_listing_overview.png) diff --git a/translations/ko-KR/content/developers/github-marketplace/viewing-metrics-for-your-listing.md b/translations/ko-KR/content/developers/github-marketplace/viewing-metrics-for-your-listing.md index fe55776d9baa..045237bda979 100644 --- a/translations/ko-KR/content/developers/github-marketplace/viewing-metrics-for-your-listing.md +++ b/translations/ko-KR/content/developers/github-marketplace/viewing-metrics-for-your-listing.md @@ -47,7 +47,8 @@ To access {% data variables.product.prodname_marketplace %} Insights: {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.marketplace_apps %} -4. Select the {% data variables.product.prodname_github_app %} that you'd like to view Insights for. +4. Select the +{% data variables.product.prodname_github_app %} that you'd like to view Insights for. {% data reusables.user-settings.edit_marketplace_listing %} 6. Click the **Insights** tab. 7. Optionally, select a different time period by clicking the Period dropdown in the upper-right corner of the Insights page. ![Marketplace time period](/assets/images/marketplace/marketplace_insights_time_period.png) diff --git a/translations/ko-KR/content/developers/github-marketplace/viewing-transactions-for-your-listing.md b/translations/ko-KR/content/developers/github-marketplace/viewing-transactions-for-your-listing.md index 5f87adff43f0..15ede21ee304 100644 --- a/translations/ko-KR/content/developers/github-marketplace/viewing-transactions-for-your-listing.md +++ b/translations/ko-KR/content/developers/github-marketplace/viewing-transactions-for-your-listing.md @@ -39,7 +39,8 @@ To access {% data variables.product.prodname_marketplace %} transactions: {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.marketplace_apps %} -4. Select the {% data variables.product.prodname_github_app %} that you'd like to view transactions for. +4. Select the +{% data variables.product.prodname_github_app %} that you'd like to view transactions for. {% data reusables.user-settings.edit_marketplace_listing %} 6. Click the **Transactions** tab. 7. Optionally, select a different time period by clicking the Period dropdown in the upper-right corner of the Transactions page. ![Marketplace time period](/assets/images/marketplace/marketplace_insights_time_period.png) diff --git a/translations/ko-KR/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md b/translations/ko-KR/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md index ad19c415c91c..eae7e66c499b 100644 --- a/translations/ko-KR/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md +++ b/translations/ko-KR/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md @@ -27,18 +27,18 @@ Each `marketplace_purchase` webhook payload will have the following information: | `동작` | `문자열` | The action performed to generate the webhook. Can be `purchased`, `cancelled`, `pending_change`, `pending_change_cancelled`, or `changed`. For more information, see the example webhook payloads below. **Note:** The `pending_change` and `pending_change_cancelled` payloads contain the same keys as shown in the [`changed` payload example](#example-webhook-payload-for-a-changed-event). | | `effective_date` | `문자열` | The date the `action` becomes effective. | | `sender` | `개체` | The person who took the `action` that triggered the webhook. | -| `marketplace_purchase` | `개체` | The {% data variables.product.prodname_marketplace %} purchase information. | +| `marketplace_purchase` | `개체` | The {% data variables.product.prodname_marketplace %} purchase information. | The `marketplace_purchase` object has the following keys: | 키 | 유형 | 설명 | | -------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `계정` | `개체` | The `organization` or `user` account associated with the subscription. Organization accounts will include `organization_billing_email`, which is the organization's administrative email address. To find email addresses for personal accounts, you can use the [Get the authenticated user](/v3/users/#get-the-authenticated-user) endpoint. | -| `billing_cycle` | `문자열` | Can be `yearly` or `monthly`. When the `account` owner has a free GitHub plan and has purchased a free {% data variables.product.prodname_marketplace %} plan, `billing_cycle` will be `nil`. | +| `billing_cycle` | `문자열` | Can be `yearly` or `monthly`. When the `account` owner has a free GitHub plan and has purchased a free {% data variables.product.prodname_marketplace %} plan, `billing_cycle` will be `nil`. | | `unit_count` | `integer` | Number of units purchased. | | `on_free_trial` | `boolean` | `true` when the `account` is on a free trial. | | `free_trial_ends_on` | `문자열` | The date the free trial will expire. | -| `next_billing_date` | `문자열` | The date that the next billing cycle will start. When the `account` owner has a free GitHub.com plan and has purchased a free {% data variables.product.prodname_marketplace %} plan, `next_billing_date` will be `nil`. | +| `next_billing_date` | `문자열` | The date that the next billing cycle will start. When the `account` owner has a free GitHub.com plan and has purchased a free {% data variables.product.prodname_marketplace %} plan, `next_billing_date` will be `nil`. | | `plan` | `개체` | The plan purchased by the `user` or `organization`. | The `plan` object has the following keys: diff --git a/translations/ko-KR/content/developers/overview/managing-deploy-keys.md b/translations/ko-KR/content/developers/overview/managing-deploy-keys.md index 82e3325cf07e..fcc5d295232a 100644 --- a/translations/ko-KR/content/developers/overview/managing-deploy-keys.md +++ b/translations/ko-KR/content/developers/overview/managing-deploy-keys.md @@ -10,7 +10,6 @@ versions: --- - You can manage SSH keys on your servers when automating deployment scripts using SSH agent forwarding, HTTPS with OAuth tokens, deploy keys, or machine users. ### SSH agent forwarding diff --git a/translations/ko-KR/content/developers/overview/replacing-github-services.md b/translations/ko-KR/content/developers/overview/replacing-github-services.md index 13ea935a867a..eb1925fc9e60 100644 --- a/translations/ko-KR/content/developers/overview/replacing-github-services.md +++ b/translations/ko-KR/content/developers/overview/replacing-github-services.md @@ -19,7 +19,6 @@ As an alternative to the email service, you can now start using email notificati {% endnote %} - ### Deprecation timeline - **October 1, 2018**: GitHub discontinued allowing users to install services. We removed GitHub Services from the GitHub.com user interface. diff --git a/translations/ko-KR/content/developers/webhooks-and-events/about-webhooks.md b/translations/ko-KR/content/developers/webhooks-and-events/about-webhooks.md index 2a654b6c8a27..048e5dd70366 100644 --- a/translations/ko-KR/content/developers/webhooks-and-events/about-webhooks.md +++ b/translations/ko-KR/content/developers/webhooks-and-events/about-webhooks.md @@ -9,10 +9,9 @@ versions: --- - Webhooks allow you to build or set up integrations, such as [{% data variables.product.prodname_github_app %}s](/apps/building-github-apps/) or [{% data variables.product.prodname_oauth_app %}s](/apps/building-oauth-apps/), which subscribe to certain events on GitHub.com. When one of those events is triggered, we'll send a HTTP POST payload to the webhook's configured URL. Webhooks can be used to update an external issue tracker, trigger CI builds, update a backup mirror, or even deploy to your production server. You're only limited by your imagination. -Webhooks can be installed on{% if currentVersion != "free-pro-team@latest" %} a [{% data variables.product.prodname_ghe_server %} instance](/v3/enterprise-admin/global_webhooks/),{% endif %} an [organization][org-hooks], a specific [repository][repo-hooks], or a {% data variables.product.prodname_github_app %}. Once installed, the webhook will be sent each time one or more subscribed events occurs. +Webhooks can be installed on{% if currentVersion != "free-pro-team@latest" %} a [{% data variables.product.prodname_ghe_server %} instance](/rest/reference/enterprise-admin#global-webhooks/),{% endif %} an [organization][org-hooks], a specific [repository][repo-hooks], or a {% data variables.product.prodname_github_app %}. Once installed, the webhook will be sent each time one or more subscribed events occurs. You can create up to {% if currentVersion != "free-pro-team@latest" %}250{% else %}20{% endif %} webhooks for each event on each installation target {% if currentVersion != "free-pro-team@latest" %}({% data variables.product.prodname_ghe_server %} instance, specific organization, or specific repository).{% else %}(specific organization or specific repository).{% endif %} @@ -30,5 +29,5 @@ See "[Webhook event payloads](/webhooks/event-payloads)" for the list of availab For more information about the `ping` event webhook payload, see the [`ping`](/webhooks/event-payloads/#ping) event. -[org-hooks]: /v3/orgs/hooks/ +[org-hooks]: /rest/reference/orgs#webhooks/ [repo-hooks]: /v3/repos/hooks/ diff --git a/translations/ko-KR/content/developers/webhooks-and-events/github-event-types.md b/translations/ko-KR/content/developers/webhooks-and-events/github-event-types.md index 94673fa62cdd..4adf87a23a86 100644 --- a/translations/ko-KR/content/developers/webhooks-and-events/github-event-types.md +++ b/translations/ko-KR/content/developers/webhooks-and-events/github-event-types.md @@ -16,7 +16,6 @@ The Events API can return different types of events triggered by activity on Git {% endif %} - ### Event object common properties The event objects returned from the Events API endpoints have the same structure. @@ -203,7 +202,7 @@ This event returns an empty `payload` object. | `push_id` | `integer` | Unique identifier for the push. | | `크기` | `integer` | The number of commits in the push. | | `distinct_size` | `integer` | The number of distinct commits in the push. | -| `ref` | `문자열` | The full [`git ref`](/v3/git/refs/) that was pushed. Example: `refs/heads/master`. | +| `ref` | `문자열` | The full [`git ref`](/v3/git/refs/) that was pushed. Example: `refs/heads/main`. | | `head` | `문자열` | The SHA of the most recent commit on `ref` after the push. | | `before` | `문자열` | The SHA of the most recent commit on `ref` before the push. | | `commits` | `array` | An array of commit objects describing the pushed commits. (The array includes a maximum of 20 commits. If necessary, you can use the [Commits API](/v3/repos/commits/) to fetch additional commits. This limit is applied to timeline events only and isn't applied to webhook deliveries.) | diff --git a/translations/ko-KR/content/developers/webhooks-and-events/issue-event-types.md b/translations/ko-KR/content/developers/webhooks-and-events/issue-event-types.md index 3c9c7fc50fd4..3a48cff1cbd9 100644 --- a/translations/ko-KR/content/developers/webhooks-and-events/issue-event-types.md +++ b/translations/ko-KR/content/developers/webhooks-and-events/issue-event-types.md @@ -11,7 +11,6 @@ versions: Issue events are triggered by activity in issues and pull requests and are available in the [Issue Events API](/v3/issues/events) and the [Timeline Events API](/v3/issues/timeline). Each event type specifies whether the event is available in the Issue Events or Timeline Events APIs. - GitHub's REST API considers every pull request to be an issue, but not every issue is a pull request. For this reason, the Issue Events and Timeline Events endpoints may return both issues and pull requests in the response. Pull requests have a `pull_request` property in the `issue` object. Because pull requests are issues, issue and pull request numbers do not overlap in a repository. For example, if you open your first issue in a repository, the number will be 1. If you then open a pull request, the number will be 2. Each event type specifies if the event occurs in pull request, issues, or both. ### Issue event object common properties diff --git a/translations/ko-KR/content/developers/webhooks-and-events/securing-your-webhooks.md b/translations/ko-KR/content/developers/webhooks-and-events/securing-your-webhooks.md index 7f135f37bdae..0a5ed843591b 100644 --- a/translations/ko-KR/content/developers/webhooks-and-events/securing-your-webhooks.md +++ b/translations/ko-KR/content/developers/webhooks-and-events/securing-your-webhooks.md @@ -33,9 +33,17 @@ $ export SECRET_TOKEN=your_token ### Validating payloads from GitHub -When your secret token is set, GitHub uses it to create a hash signature with each payload. +When your secret token is set, {% data variables.product.product_name %} uses it to create a hash signature with each payload. This hash signature is included with the headers of each request as {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %}`X-Hub-Signature-256`{% else if currentVersion ver_lt "enterprise-server@2.23" %}`X-Hub-Signature`{% endif %}. -This hash signature is passed along with each request in the headers as `X-Hub-Signature`. Suppose you have a basic server listening to webhooks that looks like this: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %} +{% note %} + +**Note:** For backward-compatibility, we also include the `X-Hub-Signature` header that is generated using the SHA-1 hash function. If possible, we recommend that you use the `X-Hub-Signature-256` header for improved security. The example below demonstrate using the `X-Hub-Signature-256` header. + +{% endnote %} +{% endif %} + +For example, if you have a basic server that listens for webhooks, it might be configured similar to this: ``` ruby require 'sinatra' @@ -47,7 +55,7 @@ post '/payload' do end ``` -The goal is to compute a hash using your `SECRET_TOKEN`, and ensure that the hash from GitHub matches. GitHub uses an HMAC hexdigest to compute the hash, so you could change your server to look a little like this: +The intention is to calculate a hash using your `SECRET_TOKEN`, and ensure that the result matches the hash from {% data variables.product.product_name %}. {% data variables.product.product_name %} uses an HMAC hex digest to compute the hash, so you could reconfigure your server to look a little like this: ``` ruby post '/payload' do @@ -58,16 +66,21 @@ post '/payload' do "I got some JSON: #{push.inspect}" end +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %} +def verify_signature(payload_body) + signature = 'sha256=' + OpenSSL::HMAC.hexdigest(OpenSSL::Digest.new('sha256'), ENV['SECRET_TOKEN'], payload_body) + return halt 500, "Signatures didn't match!" unless Rack::Utils.secure_compare(signature, request.env['HTTP_X_HUB_SIGNATURE_2']) +end{% else if currentVersion ver_lt "enterprise-server@2.23" %} def verify_signature(payload_body) signature = 'sha1=' + OpenSSL::HMAC.hexdigest(OpenSSL::Digest.new('sha1'), ENV['SECRET_TOKEN'], payload_body) return halt 500, "Signatures didn't match!" unless Rack::Utils.secure_compare(signature, request.env['HTTP_X_HUB_SIGNATURE']) -end +end{% endif %} ``` -Obviously, your language and server implementations may differ than this code. There are a couple of very important things to point out, however: +Your language and server implementations may differ from this example code. However, there are a number of very important things to point out: -* No matter which implementation you use, the hash signature starts with `sha1=`, using the key of your secret token and your payload body. +* No matter which implementation you use, the hash signature starts with {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or "private-instances@latest" %}`sha256=`{% else if currentVersion ver_lt "enterprise-server@2.23" %}`sha1=`{% endif %}, using the key of your secret token and your payload body. -* Using a plain `==` operator is **not advised**. A method like [`secure_compare`][secure_compare] performs a "constant time" string comparison, which renders it safe from certain timing attacks against regular equality operators. +* Using a plain `==` operator is **not advised**. A method like [`secure_compare`][secure_compare] performs a "constant time" string comparison, which helps mitigate certain timing attacks against regular equality operators. [secure_compare]: http://rubydoc.info/github/rack/rack/master/Rack/Utils.secure_compare diff --git a/translations/ko-KR/content/developers/webhooks-and-events/testing-webhooks.md b/translations/ko-KR/content/developers/webhooks-and-events/testing-webhooks.md index 4aaedae3a378..be8a04c41b59 100644 --- a/translations/ko-KR/content/developers/webhooks-and-events/testing-webhooks.md +++ b/translations/ko-KR/content/developers/webhooks-and-events/testing-webhooks.md @@ -9,7 +9,6 @@ versions: --- - Now that you've [configured your local server](/webhooks/configuring/), you might be interested in pushing your code to the limits. To that end, GitHub's webhooks view provides some tooling for testing your deployed payloads. ### Listing recent deliveries diff --git a/translations/ko-KR/content/developers/webhooks-and-events/webhook-events-and-payloads.md b/translations/ko-KR/content/developers/webhooks-and-events/webhook-events-and-payloads.md index 89398d383a7c..14c6ba12c9ed 100644 --- a/translations/ko-KR/content/developers/webhooks-and-events/webhook-events-and-payloads.md +++ b/translations/ko-KR/content/developers/webhooks-and-events/webhook-events-and-payloads.md @@ -20,7 +20,6 @@ versions: You can create webhooks that subscribe to the events listed on this page. Each webhook event includes a description of the webhook properties and an example payload. For more information, see "[Creating webhooks](/webhooks/creating/)." - ### Webhook payload object common properties Each webhook event payload also contains properties unique to the event. You can find the unique properties in the individual event type sections. @@ -28,11 +27,8 @@ Each webhook event payload also contains properties unique to the event. You can | 키 | 유형 | 설명 | | ---- | ----- | ---------------------------------------------------------------------------------------------------------------- | | `동작` | `문자열` | Most webhook payloads contain an `action` property that contains the specific activity that triggered the event. | - {% data reusables.webhooks.sender_desc %} This property is included in every webhook payload. -{% data reusables.webhooks.repo_desc %} Webhook payloads contain the - -`repository` property when the event occurs from activity in a repository. +{% data reusables.webhooks.repo_desc %} Webhook payloads contain the `repository` property when the event occurs from activity in a repository. {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} For more information, see "[Building {% data variables.product.prodname_github_app %}](/apps/building-github-apps/)." @@ -48,13 +44,14 @@ The unique properties for a webhook event are the same properties you'll find in HTTP POST payloads that are delivered to your webhook's configured URL endpoint will contain several special headers: -| Header | 설명 | -| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `X-GitHub-Event` | Name of the event that triggered the delivery. | +| Header | 설명 | +| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `X-GitHub-Event` | Name of the event that triggered the delivery. | | `X-GitHub-Delivery` | A [GUID](http://en.wikipedia.org/wiki/Globally_unique_identifier) to identify the delivery.{% if currentVersion != "free-pro-team@latest" %} -| `X-GitHub-Enterprise-Version` | The version of the {% data variables.product.prodname_ghe_server %} instance that sent the HTTP POST payload. | -| `X-GitHub-Enterprise-Host` | The hostname of the {% data variables.product.prodname_ghe_server %} instance that sent the HTTP POST payload.{% endif %} -| `X-Hub-Signature` | The HMAC hex digest of the response body. This header will be sent if the webhook is configured with a [`secret`](/v3/repos/hooks/#create-hook-config-params). The HMAC hex digest is generated using the `sha1` hash function and the `secret` as the HMAC `key`. | +| `X-GitHub-Enterprise-Version` | The version of the {% data variables.product.prodname_ghe_server %} instance that sent the HTTP POST payload. | +| `X-GitHub-Enterprise-Host` | The hostname of the {% data variables.product.prodname_ghe_server %} instance that sent the HTTP POST payload.{% endif %}{% if currentVersion != "private-instances@latest" %} +| `X-Hub-Signature` | This header is sent if the webhook is configured with a [`secret`](/v3/repos/hooks/#create-hook-config-params). This is the HMAC hex digest of the request body, and is generated using the SHA-1 hash function and the `secret` as the HMAC `key`.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} `X-Hub-Signature` is provided for compatibility with existing integrations, and we recommend that you use the more secure `X-Hub-Signature-256` instead.{% endif %}{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %} +| `X-Hub-Signature-256` | This header is sent if the webhook is configured with a [`secret`](/v3/repos/hooks/#create-hook-config-params). This is the HMAC hex digest of the request body, and is generated using the SHA-256 hash function and the `secret` as the HMAC `key`.{% endif %} Also, the `User-Agent` for the requests will have the prefix `GitHub-Hookshot/`. @@ -66,8 +63,9 @@ Also, the `User-Agent` for the requests will have the prefix `GitHub-Hookshot/`. > Host: localhost:4567 > X-GitHub-Delivery: 72d3162e-cc78-11e3-81ab-4c9367dc0958{% if currentVersion != "free-pro-team@latest" %} > X-GitHub-Enterprise-Version: 2.15.0 -> X-GitHub-Enterprise-Host: example.com{% endif %} -> X-Hub-Signature: sha1=7d38cdd689735b008b3c702edd92eea23791c5f6 +> X-GitHub-Enterprise-Host: example.com{% endif %}{% if currentVersion != "private-instances@latest" %} +> X-Hub-Signature: sha1=7d38cdd689735b008b3c702edd92eea23791c5f6{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %} +> X-Hub-Signature-256: sha256=d57c68ca6f92289e6987922ff26938930f6e66a2d161ef06abdf1859230aa23c{% endif %} > User-Agent: GitHub-Hookshot/044aadd > Content-Type: application/json > Content-Length: 6615 @@ -292,10 +290,10 @@ Only {% data variables.product.prodname_github_app %}s can receive this event. { #### Webhook payload object -| 키 | 유형 | 설명 | -| ------------ | --------------------------------------------------------------- | ---------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -| `동작` | `문자열` | The action performed. Can be `created`.{% endif %} -| `deployment` | `개체` | The [deployment](/v3/repos/deployments/#list-deployments). | +| 키 | 유형 | 설명 | +| ------------ | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +| `동작` | `문자열` | The action performed. Can be `created`.{% endif %} +| `deployment` | `개체` | The [deployment](/rest/reference/repos#list-deployments). | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} @@ -317,14 +315,14 @@ Only {% data variables.product.prodname_github_app %}s can receive this event. { #### Webhook payload object -| 키 | 유형 | 설명 | -| ---------------------------------- | --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -| `동작` | `문자열` | The action performed. Can be `created`.{% endif %} -| `deployment_status` | `개체` | The [deployment status](/v3/repos/deployments/#list-deployment-statuses). | -| `deployment_status["state"]` | `문자열` | The new state. Can be `pending`, `success`, `failure`, or `error`. | -| `deployment_status["target_url"]` | `문자열` | The optional link added to the status. | -| `deployment_status["description"]` | `문자열` | The optional human-readable description added to the status. | -| `deployment` | `개체` | The [deployment](/v3/repos/deployments/#list-deployments) that this status is associated with. | +| 키 | 유형 | 설명 | +| ---------------------------------- | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +| `동작` | `문자열` | The action performed. Can be `created`.{% endif %} +| `deployment_status` | `개체` | The [deployment status](/rest/reference/repos#list-deployment-statuses). | +| `deployment_status["state"]` | `문자열` | The new state. Can be `pending`, `success`, `failure`, or `error`. | +| `deployment_status["target_url"]` | `문자열` | The optional link added to the status. | +| `deployment_status["description"]` | `문자열` | The optional human-readable description added to the status. | +| `deployment` | `개체` | The [deployment](/rest/reference/repos#list-deployments) that this status is associated with. | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} @@ -342,7 +340,7 @@ Only {% data variables.product.prodname_github_app %}s can receive this event. { #### Availability -- GitHub Enterprise webhooks. For more information, "[Global webhooks](/v3/enterprise-admin/global_webhooks/)." +- GitHub Enterprise webhooks. For more information, "[Global webhooks](/rest/reference/enterprise-admin#global-webhooks/)." #### Webhook payload object @@ -670,17 +668,17 @@ The webhook this event is configured on was deleted. This event will only listen #### Availability {% if currentVersion != "free-pro-team@latest" %} -- GitHub Enterprise webhooks only receive `created` and `deleted` events. For more information, "[Global webhooks](/v3/enterprise-admin/global_webhooks/).{% endif %} +- GitHub Enterprise webhooks only receive `created` and `deleted` events. For more information, "[Global webhooks](/rest/reference/enterprise-admin#global-webhooks/).{% endif %} - Organization webhooks only receive the `deleted`, `added`, `removed`, `renamed`, and `invited` events - {% data variables.product.prodname_github_app %}s with the `members` permission #### Webhook payload object -| 키 | 유형 | 설명 | -| ------------ | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 키 | 유형 | 설명 | +| ------------ | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `동작` | `문자열` | The action that was performed. Can be one of:{% if currentVersion != "free-pro-team@latest" %} `created`,{% endif %} `deleted`, `renamed`, `member_added`, `member_removed`, or `member_invited`. | -| `초대` | `개체` | The invitation for the user or email if the action is `member_invited`. | -| `membership` | `개체` | The membership between the user and the organization. Not present when the action is `member_invited`. | +| `초대` | `개체` | The invitation for the user or email if the action is `member_invited`. | +| `membership` | `개체` | The membership between the user and the organization. Not present when the action is `member_invited`. | {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} @@ -747,10 +745,10 @@ Activity related to {% data variables.product.prodname_registry %}. {% data reus #### Webhook payload object -| 키 | 유형 | 설명 | -| ------- | --------- | --------------------------------------------------------------------------------- | -| `id` | `integer` | The unique identifier of the page build. | -| `build` | `개체` | The [List GitHub Pages builds](/v3/repos/pages/#list-github-pages-builds) itself. | +| 키 | 유형 | 설명 | +| ------- | --------- | -------------------------------------------------------------------------------------- | +| `id` | `integer` | The unique identifier of the page build. | +| `build` | `개체` | The [List GitHub Pages builds](/rest/reference/repos#list-github-pages-builds) itself. | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} @@ -772,11 +770,11 @@ Activity related to {% data variables.product.prodname_registry %}. {% data reus #### Webhook payload object -| 키 | 유형 | 설명 | -| -------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `zen` | `문자열` | Random string of GitHub zen. | -| `hook_id` | `integer` | The ID of the webhook that triggered the ping. | -| `후크` | `개체` | The [webhook configuration](/v3/repos/hooks/#get-a-repository-webhook). | +| 키 | 유형 | 설명 | +| -------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `zen` | `문자열` | Random string of GitHub zen. | +| `hook_id` | `integer` | The ID of the webhook that triggered the ping. | +| `후크` | `개체` | The [webhook configuration](/v3/repos/hooks/#get-a-repository-webhook). | | `hook[app_id]` | `integer` | When you register a new {% data variables.product.prodname_github_app %}, {% data variables.product.product_name %} sends a ping event to the **webhook URL** you specified during registration. The event contains the `app_id`, which is required for [authenticating](/apps/building-integrations/setting-up-and-registering-github-apps/about-authentication-options-for-github-apps/) an app. | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} @@ -972,7 +970,7 @@ Deliveries for `review_requested` and `review_request_removed` events will have | 키 | 유형 | 설명 | | -------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `ref` | `문자열` | The full [`git ref`](/v3/git/refs/) that was pushed. Example: `refs/heads/master`. | +| `ref` | `문자열` | The full [`git ref`](/v3/git/refs/) that was pushed. Example: `refs/heads/main`. | | `before` | `문자열` | The SHA of the most recent commit on `ref` before the push. | | `after` | `문자열` | The SHA of the most recent commit on `ref` after the push. | | `commits` | `array` | An array of commit objects describing the pushed commits. (The array includes a maximum of 20 commits. If necessary, you can use the [Commits API](/v3/repos/commits/) to fetch additional commits. This limit is applied to timeline events only and isn't applied to webhook deliveries.) | @@ -1044,7 +1042,7 @@ This event occurs when a {% data variables.product.prodname_github_app %} sends | 키 | 유형 | 설명 | | ---- | ----- | --------------------------------------------------------------------------- | -| `동작` | `문자열` | The action that was performed. This can be one of:
    • `created` - A repository is created.
    • `deleted` - A repository is deleted. This event type is only available to [organization hooks](/v3/orgs/hooks/)
    • `archived` - A repository is archived.
    • `unarchived` - A repository is unarchived.
      • {% if currentVersion != "free-pro-team@latest" %}
    • `anonymous_access_enabled` - A repository is [enabled for anonymous Git access](/v3/previews/#anonymous-git-access-to-repositories), `anonymous_access_disabled` - A repository is [disabled for anonymous Git access](/v3/previews/#anonymous-git-access-to-repositories)
      • {% endif %}
    • `edited` - A repository's information is edited.
    • `renamed` - A repository is renamed.
    • `transferred` - A repository is transferred.
    • `publicized` - A repository is made public.
    • `privatized` - A repository is made private.
    | +| `동작` | `문자열` | The action that was performed. This can be one of:
    • `created` - A repository is created.
    • `deleted` - A repository is deleted. This event type is only available to [organization hooks](/rest/reference/orgs#webhooks/)
    • `archived` - A repository is archived.
    • `unarchived` - A repository is unarchived.
      • {% if currentVersion != "free-pro-team@latest" %}
    • `anonymous_access_enabled` - A repository is [enabled for anonymous Git access](/v3/previews/#anonymous-git-access-to-repositories), `anonymous_access_disabled` - A repository is [disabled for anonymous Git access](/v3/previews/#anonymous-git-access-to-repositories)
      • {% endif %}
    • `edited` - A repository's information is edited.
    • `renamed` - A repository is renamed.
    • `transferred` - A repository is transferred.
    • `publicized` - A repository is made public.
    • `privatized` - A repository is made private.
    | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} @@ -1253,7 +1251,7 @@ You can only create a sponsorship webhook on {% data variables.product.prodname_ When a user is `created` or `deleted`. #### Availability -- GitHub Enterprise webhooks. For more information, "[Global webhooks](/v3/enterprise-admin/global_webhooks/)." +- GitHub Enterprise webhooks. For more information, "[Global webhooks](/rest/reference/enterprise-admin#global-webhooks/)." #### Webhook payload example @@ -1299,7 +1297,6 @@ This event occurs when someone triggers a workflow run on GitHub or sends a `POS {{ webhookPayloadsForCurrentVersion.workflow_dispatch }} {% endif %} - ### workflow_run When a {% data variables.product.prodname_actions %} workflow run is requested or completed. For more information, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows#workflow_run)." diff --git a/translations/ko-KR/content/github/administering-a-repository/about-branch-restrictions.md b/translations/ko-KR/content/github/administering-a-repository/about-branch-restrictions.md index 8f5c197dbf9d..e18de9f14fc1 100644 --- a/translations/ko-KR/content/github/administering-a-repository/about-branch-restrictions.md +++ b/translations/ko-KR/content/github/administering-a-repository/about-branch-restrictions.md @@ -9,15 +9,15 @@ versions: enterprise-server: '*' --- -When you enable branch restrictions, only users{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %} or{% endif %} teams{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, or apps{% endif %} that have been given permission can push to the protected branch. For more information, see "[Enabling branch restrictions](/articles/enabling-branch-restrictions)" and "[About protected branches](/articles/about-protected-branches)." You can view and edit the users{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %} or{% endif %} teams{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, or apps{% endif %} with push access to a protected branch in the protected branch's settings. +When you enable branch restrictions, only users, teams, or apps that have been given permission can push to the protected branch. For more information, see "[Enabling branch restrictions](/articles/enabling-branch-restrictions)" and "[About protected branches](/articles/about-protected-branches)." You can view and edit the users, teams, or apps with push access to a protected branch in the protected branch's settings. -You can only give push access to a protected branch to users{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %} or{% endif %} teams{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, or installed {% data variables.product.prodname_github_apps %}{% endif %} with `write` access to a repository. +You can only give push access to a protected branch to users, teams, or installed {% data variables.product.prodname_github_apps %} with `write` access to a repository. -People{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} and apps{% endif %} with admin permissions to a repository are always able to push to a protected branch. +People and apps with admin permissions to a repository are always able to push to a protected branch. {% tip %} -**Note:** If "Include administrators" is selected, you've enabled required status checks on the branch, and if any status checks fail, any attempt to push changes to the protected branch will also fail, even for people{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} and apps{% endif %} with admin permissions. For more information, see "[Enabling required status checks](/articles/enabling-required-status-checks)." +**Note:** If "Include administrators" is selected, you've enabled required status checks on the branch, and if any status checks fail, any attempt to push changes to the protected branch will also fail, even for people and apps with admin permissions. For more information, see "[Enabling required status checks](/articles/enabling-required-status-checks)." {% endtip %} diff --git a/translations/ko-KR/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md b/translations/ko-KR/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md index 9ba76db6438b..0eb73197dadc 100644 --- a/translations/ko-KR/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md +++ b/translations/ko-KR/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md @@ -33,8 +33,7 @@ You can filter email notifications you receive for pushes to a repository. For m {% data reusables.repositories.sidebar-notifications %} 5. Type up to two email addresses, separated by whitespace, where you'd like notifications to be sent. If you'd like to send emails to more than two accounts, set one of the email addresses to a group email address. ![Email address textbox](/assets/images/help/settings/email_services_addresses.png) 6. If you operate your own server, you can verify the integrity of emails via the **Secret** token. This token is sent with the email as the `Approved` header. If the `Approved` header matches the token you sent, you can trust that the email is from {% data variables.product.product_name %}. ![Email secret textbox](/assets/images/help/settings/email_services_token.png) -7. Optionally, select **Send from author** to have emails delivered using the committer's email address. Otherwise, emails are sent from {% data variables.notifications.no_reply_address %}. ![Email author checkbox](/assets/images/help/settings/email_services_author.png) -8. Click **Save settings**. ![Save settings button](/assets/images/help/settings/save_notification_settings.png) +7. Click **Save settings**. ![Save settings button](/assets/images/help/settings/save_notification_settings.png) ### 더 읽을거리 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} diff --git a/translations/ko-KR/content/github/administering-a-repository/about-github-dependabot-version-updates.md b/translations/ko-KR/content/github/administering-a-repository/about-github-dependabot-version-updates.md index 65e929fc82d2..617d1c7778a6 100644 --- a/translations/ko-KR/content/github/administering-a-repository/about-github-dependabot-version-updates.md +++ b/translations/ko-KR/content/github/administering-a-repository/about-github-dependabot-version-updates.md @@ -13,7 +13,9 @@ versions: {% data variables.product.prodname_dependabot %} takes the effort out of maintaining your dependencies. You can use it to ensure that your repository automatically keeps up with the latest releases of the packages and applications it depends on. -You enable {% data variables.product.prodname_dependabot_version_updates %} by checking a configuration file in to your repository. The configuration file specifies the location of the manifest, or other package definition files, stored in your repository. {% data variables.product.prodname_dependabot_short %} uses this information to check for outdated packages and applications. {% data variables.product.prodname_dependabot_short %} determines if there is a new version of a dependency by looking at the semantic versioning ([semver](https://semver.org/)) of the dependency to decide whether it should update to that version. When {% data variables.product.prodname_dependabot_short %} identifies an outdated dependency, it raises a pull request to update the manifest to the latest version of the dependency. You check that your tests pass, review the changelog and release notes included in the pull request summary, and then merge it. For more information, see "[Enabling and disabling version updates](/github/administering-a-repository/enabling-and-disabling-version-updates)." +You enable {% data variables.product.prodname_dependabot_version_updates %} by checking a configuration file in to your repository. The configuration file specifies the location of the manifest, or other package definition files, stored in your repository. {% data variables.product.prodname_dependabot_short %} uses this information to check for outdated packages and applications. {% data variables.product.prodname_dependabot_short %} determines if there is a new version of a dependency by looking at the semantic versioning ([semver](https://semver.org/)) of the dependency to decide whether it should update to that version. For certain package managers, {% data variables.product.prodname_dependabot_version_updates %} also supports vendoring. Vendored (or cached) dependencies are dependencies that are checked in to a specific directory in a repository, rather than referenced in a manifest. Vendored dependencies are available at build time even if package servers are unavailable. {% data variables.product.prodname_dependabot_version_updates %} can be configured to check vendored dependencies for new versions and update them if necessary. + +When {% data variables.product.prodname_dependabot_short %} identifies an outdated dependency, it raises a pull request to update the manifest to the latest version of the dependency. For vendored dependencies, {% data variables.product.prodname_dependabot_short %} raises a pull request to directly replace the outdated dependency with the new version. You check that your tests pass, review the changelog and release notes included in the pull request summary, and then merge it. For more information, see "[Enabling and disabling version updates](/github/administering-a-repository/enabling-and-disabling-version-updates)." If you enable security updates, {% data variables.product.prodname_dependabot %} also raises pull requests to update vulnerable dependencies. For more information, see "[Configuring {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)." @@ -35,7 +37,7 @@ If you've enabled security updates, you'll sometimes see extra pull requests for {% endnote %} -You can configure version updates for repositories that contain a dependency manifest or lock file for one of the supported package managers. +You can configure version updates for repositories that contain a dependency manifest or lock file for one of the supported package managers. For some package managers, you can also configure vendoring for dependencies. For more information, see "[Configuration options for dependency updates](/github/administering-a-repository/configuration-options-for-dependency-updates#vendor)." {% data reusables.dependabot.supported-package-managers %} diff --git a/translations/ko-KR/content/github/administering-a-repository/about-releases.md b/translations/ko-KR/content/github/administering-a-repository/about-releases.md index ef5a803f11a4..68fc47ebc097 100644 --- a/translations/ko-KR/content/github/administering-a-repository/about-releases.md +++ b/translations/ko-KR/content/github/administering-a-repository/about-releases.md @@ -25,11 +25,13 @@ You can receive notifications when new releases are published in a repository wi Anyone with read access to a repository can view and compare releases, but only people with write permissions to a repository can manage releases. For more information, see "[Managing releases in a repository](/github/administering-a-repository/managing-releases-in-a-repository)." {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -People with admin permissions to a repository can choose whether {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in the ZIP files and tarballs that {% data variables.product.product_name %} creates for each release. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)." +People with admin permissions to a repository can choose whether +{% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in the ZIP files and tarballs that {% data variables.product.product_name %} creates for each release. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)." {% endif %} {% if currentVersion == "free-pro-team@latest" %} -If a release fixes a security vulnerability, you should publish a security advisory in your repository. {% data variables.product.prodname_dotcom %} reviews each published security advisory and may use it to send {% data variables.product.prodname_dependabot_short %} alerts to affected repositories. For more information, see "[About GitHub Security Advisories](/github/managing-security-vulnerabilities/about-github-security-advisories)." +If a release fixes a security vulnerability, you should publish a security advisory in your repository. +{% data variables.product.prodname_dotcom %} reviews each published security advisory and may use it to send {% data variables.product.prodname_dependabot_short %} alerts to affected repositories. For more information, see "[About GitHub Security Advisories](/github/managing-security-vulnerabilities/about-github-security-advisories)." You can view the **Dependents** tab of the dependency graph to see which repositories and packages depend on code in your repository, and may therefore be affected by a new release. For more information, see "[About the dependency graph](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)." {% endif %} diff --git a/translations/ko-KR/content/github/administering-a-repository/changing-the-default-branch.md b/translations/ko-KR/content/github/administering-a-repository/changing-the-default-branch.md new file mode 100644 index 000000000000..b13e501938bf --- /dev/null +++ b/translations/ko-KR/content/github/administering-a-repository/changing-the-default-branch.md @@ -0,0 +1,53 @@ +--- +title: Changing the default branch +intro: 'If you have more than one branch in your repository, you can configure any branch as the default branch.' +permissions: People with admin permissions to a repository can change the default branch for the repository. +versions: + free-pro-team: '*' + enterprise-server: '*' +redirect_from: + - /github/administering-a-repository/setting-the-default-branch + - /articles/setting-the-default-branch +--- + +### About changing the default branch + +You can choose the default branch for a repository. The default branch is the base branch for pull requests and code commits. For more information about the default branch, see "[About branches](/github/collaborating-with-issues-and-pull-requests/about-branches#about-the-default-branch)." + +{% note %} + +**Note**: If you use the Git-Subversion bridge, changing the default branch will affect your `trunk` branch contents and the `HEAD` you see when you list references for the remote repository. For more information, see "[Support for Subversion clients](/github/importing-your-projects-to-github/support-for-subversion-clients)" and [git-ls-remote](https://git-scm.com/docs/git-ls-remote.html) in the Git documentation. + +{% endnote %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} + +{% data reusables.branches.set-default-branch %} + +{% endif %} + +### 빌드전 요구 사양 + +To change the default branch, your repository must have more than one branch. For more information, see "[Creating and deleting branches within your repository](/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository#creating-a-branch)." + +### Changing the default branch + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.repository-branches %} +1. Under "Default branch", to the right of the default branch name, click {% octicon "arrow-switch" aria-label="The switch icon with two arrows" %}. ![Switch icon with two arrows to the right of current default branch name](/assets/images/help/repository/repository-options-defaultbranch-change.png) +1. Use the drop-down, then click a branch name. ![Drop-down to choose new default branch](/assets/images/help/repository/repository-options-defaultbranch-drop-down.png) +1. Click **Update**. !["Update" button after choosing a new default branch](/assets/images/help/repository/repository-options-defaultbranch-update.png) +1. Read the warning, then click **I understand, update the default branch.** !["Update" button after choosing a new default branch](/assets/images/help/repository/repository-options-defaultbranch-i-understand.png) + +{% else %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.repository-branches %} +1. In the default branch drop-down, choose the new default branch. ![Default branch dropdown selector](/assets/images/help/repository/repository-options-defaultbranch.png) +1. Click **Update**. + +{% endif %} diff --git a/translations/ko-KR/content/github/administering-a-repository/configuration-options-for-dependency-updates.md b/translations/ko-KR/content/github/administering-a-repository/configuration-options-for-dependency-updates.md index 9e61e4c7a67a..ac223fe9c4a7 100644 --- a/translations/ko-KR/content/github/administering-a-repository/configuration-options-for-dependency-updates.md +++ b/translations/ko-KR/content/github/administering-a-repository/configuration-options-for-dependency-updates.md @@ -37,13 +37,14 @@ The *dependabot.yml* file must start with `version: 2` followed by an array of ` | [`schedule.time`](#scheduletime) | | Time of day to check for updates (hh:mm) | | [`schedule.timezone`](#scheduletimezone) | | Timezone for time of day (zone identifier) | | [`target-branch`](#target-branch) | | Branch to create pull requests against | +| [`vendor`](#vendor) | | Update vendored or cached dependencies | | [`versioning-strategy`](#versioning-strategy) | | How to update manifest version requirements | These options fit broadly into the following categories. - Essential set up options that you must include in all configurations: [`package-ecosystem`](#package-ecosystem), [`directory`](#directory),[`schedule.interval`](#scheduleinterval). - Options to customize the update schedule: [`schedule.time`](#scheduletime), [`schedule.timezone`](#scheduletimezone), [`schedule.day`](#scheduleday). -- Options to control which dependencies are updated: [`allow`](#allow), [`ignore`](#ignore). +- Options to control which dependencies are updated: [`allow`](#allow), [`ignore`](#ignore), [`vendor`](#vendor). - Options to add metadata to pull requests: [`reviewers`](#reviewers), [`assignees`](#assignees), [`labels`](#labels), [`milestone`](#milestone). - Options to change the behavior of the pull requests: [`target-branch`](#target-branch), [`versioning-strategy`](#versioning-strategy), [`commit-message`](#commit-message), [`rebase-strategy`](#rebase-strategy), [`pull-request-branch-name.separator`](#pull-request-branch-nameseparator). @@ -61,7 +62,7 @@ In general, security updates use any configuration options that affect pull requ ### `package-ecosystem` -**Required** You add one `package-ecosystem` element for each one package manager that you want {% data variables.product.prodname_dependabot %} to monitor for new versions. The repository must also contain a dependency manifest or lock file each of these package managers. +**Required** You add one `package-ecosystem` element for each package manager that you want {% data variables.product.prodname_dependabot_short %} to monitor for new versions. The repository must also contain a dependency manifest or lock file for each of these package managers. If you want to enable vendoring for a package manager that supports it, the vendored dependencies must be located in the required directory. For more information, see [`vendor`](#vendor) below. {% data reusables.dependabot.supported-package-managers %} @@ -307,7 +308,7 @@ updates: {% note %} -{% data variables.product.prodname_dependabot_version_updates %} can't run version updates for any dependencies in manifests containing private git dependencies or private git registries, even if you add the private dependencies to the `ignore` option of your configuration file. For more information, see "[About {% data variables.product.prodname_dependabot_version_updates %}](/github/administering-a-repository/about-github-dependabot#supported-repositories-and-ecosystems)." +**Note**: {% data variables.product.prodname_dependabot_version_updates %} can't run version updates for any dependencies in manifests containing private git dependencies or private git registries, even if you add the private dependencies to the `ignore` option of your configuration file. For more information, see "[About {% data variables.product.prodname_dependabot_version_updates %}](/github/administering-a-repository/about-github-dependabot#supported-repositories-and-ecosystems)." {% endnote %} @@ -540,6 +541,31 @@ updates: - "npm dependencies" ``` +### `vendor` + +Use the `vendor` option to tell {% data variables.product.prodname_dependabot_short %} to vendor dependencies when updating them. + +{% note %} + +Currently, {% data variables.product.prodname_dependabot_short %} only supports vendoring dependencies for Bundler. + +{% endnote %} + +```yaml +# Configure version updates for both dependencies defined in manifests and vendored dependencies + +version: 2 +updates: + - package-ecosystem: "bundler" + # Raise pull requests to update vendored dependencies that are checked in to the repository + vendor: true + directory: "/" + schedule: + interval: "weekly" +``` + +{% data variables.product.prodname_dependabot_short %} only updates the vendored dependencies located in specific directories in a repository. For Bundler, the dependencies must be in the _vendor/cache_ directory. Other file paths are not supported. For more information, see the [`bundle cache` documentation](https://bundler.io/man/bundle-cache.1.html). + ### `versioning-strategy` When {% data variables.product.prodname_dependabot %} edits a manifest file to update a version, it uses the following overall strategies: diff --git a/translations/ko-KR/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md b/translations/ko-KR/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md index 2827db00dac5..4b2121c3c5cb 100644 --- a/translations/ko-KR/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md +++ b/translations/ko-KR/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md @@ -6,7 +6,7 @@ redirect_from: - /articles/configuring-autolinks-to-reference-external-resources versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- Anyone with admin permissions to a repository can configure autolink references to link issues, pull requests,{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} commit messages, and release descriptions{% else %} and commit messages{% endif %} to external third-party services. diff --git a/translations/ko-KR/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md b/translations/ko-KR/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md new file mode 100644 index 000000000000..c759845dad4e --- /dev/null +++ b/translations/ko-KR/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md @@ -0,0 +1,18 @@ +--- +title: Configuring the retention period for GitHub Actions artifacts and logs in your repository +intro: 'You can configure the retention period for {% data variables.product.prodname_actions %} artifacts and logs in your repository.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.23' +--- + +{% data reusables.actions.about-artifact-log-retention %} + +You can also define a custom retention period for a specific artifact created by a workflow. For more information, see "[Setting the retention period for an artifact](/actions/managing-workflow-runs/removing-workflow-artifacts#setting-the-retention-period-for-an-artifact)." + +## Setting the retention period for a repository + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.settings-sidebar-actions %} +{% data reusables.github-actions.change-retention-period-for-artifacts-logs %} diff --git a/translations/ko-KR/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md b/translations/ko-KR/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md index f2e25b8d80d4..a804bc15c0d5 100644 --- a/translations/ko-KR/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md +++ b/translations/ko-KR/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md @@ -5,7 +5,7 @@ redirect_from: - /articles/customizing-your-repositorys-social-media-preview versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- Until you add an image, repository links expand to show basic information about the repository and the owner's avatar. Adding an image to your repository can help identify your project across various social platforms. diff --git a/translations/ko-KR/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md b/translations/ko-KR/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md index c7993323208d..7ef9b0f722a3 100644 --- a/translations/ko-KR/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md +++ b/translations/ko-KR/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md @@ -35,6 +35,5 @@ You can restore the head branch of a closed pull request. ### 더 읽을거리 -- "[Creating and deleting branches within your repository](/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository)"{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} +- "[Creating and deleting branches within your repository](/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository)" - "[Managing the automatic deletion of branches](/github/administering-a-repository/managing-the-automatic-deletion-of-branches)" -{% endif %} diff --git a/translations/ko-KR/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md b/translations/ko-KR/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md index b8e7f9be37a8..dc98637951aa 100644 --- a/translations/ko-KR/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md +++ b/translations/ko-KR/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md @@ -17,6 +17,8 @@ You can enable {% data variables.product.prodname_actions %} for your repository Alternatively, you can enable {% data variables.product.prodname_actions %} in your repository but limit the actions a workflow can run. {% data reusables.github-actions.enabled-local-github-actions %} +{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.23" %} + ### Managing {% data variables.product.prodname_actions %} permissions for your repository {% note %} @@ -30,6 +32,41 @@ Alternatively, you can enable {% data variables.product.prodname_actions %} in y {% data reusables.repositories.settings-sidebar-actions %} 4. Under "Actions permissions", select an option. ![Enable, disable, or limits actions for this repository](/assets/images/help/repository/enable-repo-actions.png) +{% endif %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} + +### Managing {% data variables.product.prodname_actions %} permissions for your repository + +You can disable all workflows for a repository or set a policy that configures which actions can be used in a repository. + +{% data reusables.actions.actions-use-policy-settings %} + +{% note %} + +**Note:** You might not be able to manage these settings if your organization has an overriding policy or is managed by an enterprise that has overriding policy. For more information, see "[Disabling or limiting {% data variables.product.prodname_actions %} for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization)" or {% if currentVersion == "free-pro-team@latest" %}"[Enforcing {% data variables.product.prodname_actions %} policies in your enterprise account](/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account)."{% else if currentVersion ver_gt "enterprise-server@2.21" %}"[Enforcing {% data variables.product.prodname_actions %} policies for your enterprise](/enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise)." + +{% endif %} + +{% endnote %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.settings-sidebar-actions %} +1. Under **Actions permissions**, select an option. ![Set actions policy for this organization](/assets/images/help/repository/actions-policy.png) +1. Click **Save**. + +### Allowing specific actions to run + +{% data reusables.actions.allow-specific-actions-intro %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.settings-sidebar-actions %} +1. Under **Actions permissions**, select **Allow specific actions** and add your required actions to the list. ![Add actions to allow list](/assets/images/help/repository/actions-policy-allow-list.png) +2. Click **Save**. +{% endif %} + {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} ### Enabling workflows for private repository forks diff --git a/translations/ko-KR/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md b/translations/ko-KR/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md index 5e5c86cc8913..8c9bb9257629 100644 --- a/translations/ko-KR/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md +++ b/translations/ko-KR/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md @@ -14,18 +14,18 @@ You can configure your sponsor button by editing a _FUNDING.yml_ file in your re You can add one username, package name, or project name per external funding platform and up to four custom URLs. You can add up to four sponsored developers or organizations in {% data variables.product.prodname_sponsors %}. Add each platform on a new line, using the following syntax: -| 플랫폼 | Syntax | -| ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | -| [CommunityBridge](https://communitybridge.org) | `community_bridge: PROJECT-NAME` | +| 플랫폼 | Syntax | +| ----------------------------------------------------------------------------- | ------------------------------------------------------------------------ | +| [CommunityBridge](https://communitybridge.org) | `community_bridge: PROJECT-NAME` | | [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors) | `github: USERNAME` or `github: [USERNAME, USERNAME, USERNAME, USERNAME]` | -| [IssueHunt](https://issuehunt.io/) | `issuehunt: USERNAME` | -| [Ko-fi](https://ko-fi.com/) | `ko_fi: USERNAME` | -| [Liberapay](https://en.liberapay.com/) | `liberapay: USERNAME` | -| [Open Collective](https://opencollective.com/) | `open_collective: USERNAME` | -| [Otechie](https://otechie.com/) | `otechie: USERNAME` | -| [Patreon](https://www.patreon.com/) | `patreon: USERNAME` | -| [Tidelift](https://tidelift.com/) | `tidelift: PLATFORM-NAME/PACKAGE-NAME` | -| Custom URL | `custom: LINK1` or `custom: [LINK1, LINK2, LINK3, LINK4]` | +| [IssueHunt](https://issuehunt.io/) | `issuehunt: USERNAME` | +| [Ko-fi](https://ko-fi.com/) | `ko_fi: USERNAME` | +| [Liberapay](https://en.liberapay.com/) | `liberapay: USERNAME` | +| [Open Collective](https://opencollective.com/) | `open_collective: USERNAME` | +| [Otechie](https://otechie.com/) | `otechie: USERNAME` | +| [Patreon](https://www.patreon.com/) | `patreon: USERNAME` | +| [Tidelift](https://tidelift.com/) | `tidelift: PLATFORM-NAME/PACKAGE-NAME` | +| Custom URL | `custom: LINK1` or `custom: [LINK1, LINK2, LINK3, LINK4]` | For Tidelift, use the `platform-name/package-name` syntax with the following platform names: diff --git a/translations/ko-KR/content/github/administering-a-repository/enabling-branch-restrictions.md b/translations/ko-KR/content/github/administering-a-repository/enabling-branch-restrictions.md index 73f93ca209bb..f2a70ea7259d 100644 --- a/translations/ko-KR/content/github/administering-a-repository/enabling-branch-restrictions.md +++ b/translations/ko-KR/content/github/administering-a-repository/enabling-branch-restrictions.md @@ -19,7 +19,7 @@ Anyone with admin permissions to an organization-owned repository can enable bra {% data reusables.repositories.add-branch-protection-rules %} {% data reusables.repositories.include-administrators %} 6. Under "Protect matching branches", select **Restrict who can push to matching branches**. ![Branch restriction checkbox](/assets/images/help/repository/restrict-branch.png) -8. Search for and select the people{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %} or{% endif %} teams{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, or apps{% endif %} who will have permission to push to the protected branch. ![Branch restriction search](/assets/images/help/repository/restrict-branch-search.png) +8. Search for and select the people, teams, or apps who will have permission to push to the protected branch. ![Branch restriction search](/assets/images/help/repository/restrict-branch-search.png) 9. Click **Create**. ### 더 읽을거리 diff --git a/translations/ko-KR/content/github/administering-a-repository/index.md b/translations/ko-KR/content/github/administering-a-repository/index.md index 790f6bd920cd..b7d660caa499 100644 --- a/translations/ko-KR/content/github/administering-a-repository/index.md +++ b/translations/ko-KR/content/github/administering-a-repository/index.md @@ -27,6 +27,7 @@ versions: {% link_in_list /managing-the-forking-policy-for-your-repository %} + {% link_in_list /setting-the-default-branch %} {% link_in_list /disabling-or-limiting-github-actions-for-a-repository %} {% link_in_list /managing-git-lfs-objects-in-archives-of-your-repository %} {% link_in_list /enabling-anonymous-git-read-access-for-a-repository %} @@ -41,8 +42,8 @@ versions: {% link_in_list /restoring-a-deleted-repository %} {% topic_link_in_list /managing-branches-in-your-repository %} - {% link_in_list /setting-the-default-branch %} {% link_in_list /viewing-branches-in-your-repository %} + {% link_in_list /changing-the-default-branch %} {% link_in_list /deleting-and-restoring-branches-in-a-pull-request %} {% topic_link_in_list /configuring-pull-request-merges %} {% link_in_list /about-merge-methods-on-github %} diff --git a/translations/ko-KR/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot.md b/translations/ko-KR/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot.md index fedef576332e..7b9176ac39ec 100644 --- a/translations/ko-KR/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot.md +++ b/translations/ko-KR/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot.md @@ -9,7 +9,7 @@ versions: ### About {% data variables.product.prodname_dependabot_version_updates %} for actions -Actions are often updated with bug fixes and new features to make automated processes more reliable, faster, and safer. When you enable {% data variables.product.prodname_dependabot_version_updates %} for {% data variables.product.prodname_actions %}, {% data variables.product.prodname_dependabot %} will help ensure that references to actions in a repository's *workflow.yml* file are kept up to date. For each action in the file, {% data variables.product.prodname_dependabot_short %} checks the action's reference (typically a version number or commit identifier associated with the action) against the latest version. If a more recent version of the action is available, {% data variables.product.prodname_dependabot_short %} will send you a pull request that updates the reference in the workflow file to the latest version. For more information about {% data variables.product.prodname_dependabot_version_updates %}, see "[About {% data variables.product.prodname_dependabot_version_updates %}](/github/administering-a-repository/about-github-dependabot-version-updates)." For more information about configuring workflows for {% data variables.product.prodname_actions %}, see "[Configuring a workflow](/actions/configuring-and-managing-workflows/configuring-a-workflow)." +Actions are often updated with bug fixes and new features to make automated processes more reliable, faster, and safer. When you enable {% data variables.product.prodname_dependabot_version_updates %} for {% data variables.product.prodname_actions %}, {% data variables.product.prodname_dependabot %} will help ensure that references to actions in a repository's *workflow.yml* file are kept up to date. For each action in the file, {% data variables.product.prodname_dependabot_short %} checks the action's reference (typically a version number or commit identifier associated with the action) against the latest version. If a more recent version of the action is available, {% data variables.product.prodname_dependabot_short %} will send you a pull request that updates the reference in the workflow file to the latest version. For more information about {% data variables.product.prodname_dependabot_version_updates %}, see "[About {% data variables.product.prodname_dependabot_version_updates %}](/github/administering-a-repository/about-github-dependabot-version-updates)." For more information about configuring workflows for {% data variables.product.prodname_actions %}, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." ### Enabling {% data variables.product.prodname_dependabot_version_updates %} for actions diff --git a/translations/ko-KR/content/github/administering-a-repository/managing-releases-in-a-repository.md b/translations/ko-KR/content/github/administering-a-repository/managing-releases-in-a-repository.md index 4357fbdbe145..65812434ad07 100644 --- a/translations/ko-KR/content/github/administering-a-repository/managing-releases-in-a-repository.md +++ b/translations/ko-KR/content/github/administering-a-repository/managing-releases-in-a-repository.md @@ -16,10 +16,11 @@ versions: ### About release management -You can also publish an action from a specific release in {% data variables.product.prodname_marketplace %}. For more information, see "[Publishing an action in the {% data variables.product.prodname_marketplace %}](/actions/creating-actions/publishing-actions-in-github-marketplace)." +You can also publish an action from a specific release in {% data variables.product.prodname_marketplace %}. You can also publish an action from a specific release in {% data variables.product.prodname_marketplace %}. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -You can choose whether {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in the ZIP files and tarballs that {% data variables.product.product_name %} creates for each release. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)." +You can choose whether +{% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in the ZIP files and tarballs that {% data variables.product.product_name %} creates for each release. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)." {% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} diff --git a/translations/ko-KR/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md b/translations/ko-KR/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md index 715997845bee..920ae367999d 100644 --- a/translations/ko-KR/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md +++ b/translations/ko-KR/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md @@ -5,7 +5,7 @@ redirect_from: - /articles/managing-the-automatic-deletion-of-branches versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- Anyone with admin permissions to a repository can enable or disable the automatic deletion of branches. diff --git a/translations/ko-KR/content/github/authenticating-to-github/about-authentication-to-github.md b/translations/ko-KR/content/github/authenticating-to-github/about-authentication-to-github.md index 51bd170ef098..8aadfbba58df 100644 --- a/translations/ko-KR/content/github/authenticating-to-github/about-authentication-to-github.md +++ b/translations/ko-KR/content/github/authenticating-to-github/about-authentication-to-github.md @@ -16,7 +16,6 @@ You can access your resources in {% data variables.product.product_name %} in a - Personal access token - SSH 키 - ### Authenticating in your browser You can authenticate to {% data variables.product.product_name %} in your browser in different ways. diff --git a/translations/ko-KR/content/github/authenticating-to-github/about-commit-signature-verification.md b/translations/ko-KR/content/github/authenticating-to-github/about-commit-signature-verification.md index f7799f0ce295..9331a23bd2ee 100644 --- a/translations/ko-KR/content/github/authenticating-to-github/about-commit-signature-verification.md +++ b/translations/ko-KR/content/github/authenticating-to-github/about-commit-signature-verification.md @@ -59,8 +59,9 @@ You don't need to upload your public key to {% data variables.product.product_na ### Signature verification for bots Organizations and {% data variables.product.prodname_github_app %}s that require commit signing can use bots to sign commits. If a commit or tag has a bot signature that is cryptographically verifiable, {% data variables.product.product_name %} marks the commit or tag as verified. +Signature verification for bots will only work if the request is verified and authenticated as the -Signature verification for bots will only work if the request is verified and authenticated as the {% data variables.product.prodname_github_app %} or bot and contains no custom author information, custom committer information, and no custom signature information, such as Commits API. +{% data variables.product.prodname_github_app %} or bot and contains no custom author information, custom committer information, and no custom signature information, such as Commits API. {% endif %} ### 더 읽을거리 diff --git a/translations/ko-KR/content/github/authenticating-to-github/about-ssh.md b/translations/ko-KR/content/github/authenticating-to-github/about-ssh.md index 6506698ac946..e06f2b3ee74d 100644 --- a/translations/ko-KR/content/github/authenticating-to-github/about-ssh.md +++ b/translations/ko-KR/content/github/authenticating-to-github/about-ssh.md @@ -15,12 +15,11 @@ When you set up SSH, you'll [generate an SSH key and add it to the ssh-agent](/a We recommend that you regularly [review your SSH keys list](/articles/reviewing-your-ssh-keys) and revoke any that are invalid or have been compromised. {% if currentVersion == "free-pro-team@latest" %} -If you haven't used your SSH key for a year, then {% data variables.product.prodname_dotcom %} will automatically delete your inactive SSH key as a security precaution. For more information, see "[Deleted or missing SSH keys](/articles/deleted-or-missing-ssh-keys)." +If you haven't used your SSH key for a year, then +{% data variables.product.prodname_dotcom %} will automatically delete your inactive SSH key as a security precaution. For more information, see "[Deleted or missing SSH keys](/articles/deleted-or-missing-ssh-keys)." {% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} If you're a member of an organization that provides SSH certificates, you can use your certificate to access that organization's repositories without adding the certificate to your {% data variables.product.product_name %} account. For more information, see "[About SSH certificate authorities](/articles/about-ssh-certificate-authorities)." -{% endif %} ### 더 읽을거리 diff --git a/translations/ko-KR/content/github/authenticating-to-github/about-two-factor-authentication.md b/translations/ko-KR/content/github/authenticating-to-github/about-two-factor-authentication.md index 9772ce40e3e5..478630fc958a 100644 --- a/translations/ko-KR/content/github/authenticating-to-github/about-two-factor-authentication.md +++ b/translations/ko-KR/content/github/authenticating-to-github/about-two-factor-authentication.md @@ -1,6 +1,6 @@ --- title: About two-factor authentication -intro: 'Two-factor authentication, or 2FA, is an extra layer of security used when logging into websites or apps. With 2FA, you have to log in with your username and password and provide another form of authentication that only you know or have access to.' +intro: '{% data reusables.two_fa.about-2fa %} With 2FA, you have to log in with your username and password and provide another form of authentication that only you know or have access to.' redirect_from: - /articles/about-two-factor-authentication versions: diff --git a/translations/ko-KR/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md b/translations/ko-KR/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md index 9b98f40e5ef5..401ffc74aeab 100644 --- a/translations/ko-KR/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md +++ b/translations/ko-KR/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md @@ -80,7 +80,7 @@ After adding a new SSH key to your {% data variables.product.product_name %} acc $ sudo apt-get install xclip # Downloads and installs xclip. If you don't have `apt-get`, you might need to use another installer (like `yum`) - $ xclip -sel clip < ~/.ssh/id_rsa.pub + $ xclip -selection clipboard < ~/.ssh/id_rsa.pub # Copies the contents of the id_rsa.pub file to your clipboard ``` {% tip %} diff --git a/translations/ko-KR/content/github/authenticating-to-github/authorizing-oauth-apps.md b/translations/ko-KR/content/github/authenticating-to-github/authorizing-oauth-apps.md index 674c2e740b90..33172bb4462f 100644 --- a/translations/ko-KR/content/github/authenticating-to-github/authorizing-oauth-apps.md +++ b/translations/ko-KR/content/github/authenticating-to-github/authorizing-oauth-apps.md @@ -55,7 +55,7 @@ When you want to use an {% data variables.product.prodname_oauth_app %} that int | Deployments | Deployment status access allows apps to determine if a deployment is successful against a specific commit for public and private repositories. Apps won't have access to your code. | | Gists | [Gist](https://gist.github.com) access allows apps to read or write to both your public and secret Gists. | | Hooks | [Webhooks](/webhooks) access allows apps to read or write hook configurations on repositories you manage. | -| 알림(Notifications) | Notification access allows apps to read your {% data variables.product.product_name %} notifications, such as comments on issues and pull requests. However, apps remain unable to access anything in your repositories. | +| 알림(Notifications) | Notification access allows apps to read your {% data variables.product.product_name %} notifications, such as comments on issues and pull requests. However, apps remain unable to access anything in your repositories. | | Organizations and teams | Organization and teams access allows apps to access and manage organization and team membership. | | Personal user data | User data includes information found in your user profile, like your name, e-mail address, and location. | | Repositories | Repository information includes the names of contributors, the branches you've created, and the actual files within your repository. Apps can request access for either public or private repositories on a user-wide level. | diff --git a/translations/ko-KR/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md b/translations/ko-KR/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md index 14ff82b99d08..5fce820e48c9 100644 --- a/translations/ko-KR/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md +++ b/translations/ko-KR/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md @@ -20,8 +20,7 @@ versions: 3. Check the directory listing to see if you already have a public SSH key. By default, the filenames of the public keys are one of the following: - *id_rsa.pub* - *id_ecdsa.pub* - - *id_ed25519.pub*{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} - - *id_dsa.pub*{% endif %} + - *id_ed25519.pub* If you don't have an existing public and private key pair, or don't wish to use any that are available to connect to {% data variables.product.product_name %}, then [generate a new SSH key](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent). diff --git a/translations/ko-KR/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md b/translations/ko-KR/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md index a17a856ba85e..8237a5e84678 100644 --- a/translations/ko-KR/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md +++ b/translations/ko-KR/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md @@ -11,7 +11,9 @@ versions: ### Checking your commit signature verification status -1. On {% data variables.product.product_name %}, navigate to your pull request. +1. On + +{% data variables.product.product_name %}, navigate to your pull request. {% data reusables.repositories.review-pr-commits %} 3. Next to your commit's abbreviated commit hash, there is a box that shows whether your commit signature is verified or unverified. ![Signed commit](/assets/images/help/commits/gpg-signed-commit-verified-without-details.png) 4. To view more detailed information about the commit signature, click **Verified** or **Unverified**. ![Verified signed commit](/assets/images/help/commits/gpg-signed-commit_verified_details.png) diff --git a/translations/ko-KR/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md b/translations/ko-KR/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md index 9d9335bc1424..c0b1dc9e49ab 100644 --- a/translations/ko-KR/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md +++ b/translations/ko-KR/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md @@ -91,7 +91,9 @@ When you generate or retrieve an account recovery token, an event is added to yo You can generate an account recovery token and store it with a partner recovery provider. -1. Sign in to your Facebook account, then return to {% data variables.product.product_name %}. +1. Sign in to your Facebook account, then return to + +{% data variables.product.product_name %}. {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.security %} 4. To generate a new token, under "Recovery tokens," click **Store new token**. ![Button for storing a new recovery token](/assets/images/help/settings/store-new-recovery-token.png) diff --git a/translations/ko-KR/content/github/authenticating-to-github/configuring-two-factor-authentication.md b/translations/ko-KR/content/github/authenticating-to-github/configuring-two-factor-authentication.md index 032ecb6c3b01..8b9dc874cb0c 100644 --- a/translations/ko-KR/content/github/authenticating-to-github/configuring-two-factor-authentication.md +++ b/translations/ko-KR/content/github/authenticating-to-github/configuring-two-factor-authentication.md @@ -45,7 +45,9 @@ A time-based one-time password (TOTP) application automatically generates an aut 8. On the Two-factor authentication page, do one of the following: - Scan the QR code with your mobile device's app. After scanning, the app displays a six-digit code that you can enter on {% data variables.product.product_name %}. - If you can't scan the QR code, click **enter this text code** to see a code you can copy and manually enter on {% data variables.product.product_name %} instead. ![Click enter this code](/assets/images/help/2fa/totp-click-enter-code.png) -9. The TOTP mobile application saves your {% data variables.product.product_name %} account and generates a new authentication code every few seconds. On {% data variables.product.product_name %}, on the 2FA page, type the code and click **Enable**. ![TOTP Enable field](/assets/images/help/2fa/totp-enter-code.png) +9. The TOTP mobile application saves your +{% data variables.product.product_name %} account and generates a new authentication code every few seconds. On {% data variables.product.product_name %}, on the 2FA page, type the code and click **Enable**. + ![TOTP Enable field](/assets/images/help/2fa/totp-enter-code.png) {% data reusables.two_fa.test_2fa_immediately %} {% if currentVersion == "free-pro-team@latest" %} @@ -82,29 +84,13 @@ On most devices and browsers, you can use a physical security key over USB or NF Authentication with a security key is *secondary* to authentication with a TOTP application{% if currentVersion == "free-pro-team@latest" %} or a text message{% endif %}. If you lose your security key, you'll still be able to use your phone's code to sign in. 1. You must have already configured 2FA via a TOTP mobile app{% if currentVersion == "free-pro-team@latest" %} or via SMS{% endif %}. -2. Ensure that you have a -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}WebAuthn{% else %}FIDO U2F{% endif %} compatible security key inserted into your computer. +2. Ensure that you have a WebAuthn compatible security key inserted into your computer. {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.security %} 5. Next to "Security keys", click **Add**. ![Add security keys option](/assets/images/help/2fa/add-security-keys-option.png) -6. Under "Security keys", click **Register new security key**. - {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - ![Registering a new security key](/assets/images/help/2fa/security-key-register.png) - {% else %} - ![Registering a new FIDO U2F device](/assets/images/help/2fa/register_new_fido_u2f_device.png) - {% endif %} -7. Type a nickname for the security key, then click **Add**. - {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - ![Providing a nickname for a security key](/assets/images/help/2fa/security-key-nickname.png) - {% else %} - ![Providing a nickname for a FIDO U2F device](/assets/images/help/2fa/fido_u2f_nickname.png) - {% endif %} -8. Activate your security key, following your security key's documentation. - {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - ![Prompt for a security key](/assets/images/help/2fa/security-key-prompt.png) - {% else %} - ![Prompt for a FIDO U2F device](/assets/images/help/2fa/fido_u2f_prompt_key.png) - {% endif %} +6. Under "Security keys", click **Register new security key**. ![Registering a new security key](/assets/images/help/2fa/security-key-register.png) +7. Type a nickname for the security key, then click **Add**. ![Providing a nickname for a security key](/assets/images/help/2fa/security-key-nickname.png) +8. Activate your security key, following your security key's documentation. ![Prompt for a security key](/assets/images/help/2fa/security-key-prompt.png) 9. Confirm that you've downloaded and can access your recovery codes. If you haven't already, or if you'd like to generate another set of codes, download your codes and save them in a safe place. If you lose access to your account, you can use your recovery codes to get back into your account. For more information, see "[Recovering your account if you lose your 2FA credentials](/articles/recovering-your-account-if-you-lose-your-2fa-credentials)." ![Download recovery codes button](/assets/images/help/2fa/2fa-recover-during-setup.png) {% data reusables.two_fa.test_2fa_immediately %} diff --git a/translations/ko-KR/content/github/authenticating-to-github/connecting-with-third-party-applications.md b/translations/ko-KR/content/github/authenticating-to-github/connecting-with-third-party-applications.md index b5b9525e7556..fd706a119c4e 100644 --- a/translations/ko-KR/content/github/authenticating-to-github/connecting-with-third-party-applications.md +++ b/translations/ko-KR/content/github/authenticating-to-github/connecting-with-third-party-applications.md @@ -57,7 +57,7 @@ There are several types of data that applications can request. | Deployments | Deployment status access allows applicationss to determine if a deployment is successful against a specific commit for public and private repositories. Applicationss won't have access to your code. | | Gists | [Gist](https://gist.github.com) access allows applications to read or write to both your public and secret Gists. | | Hooks | [Webhooks](/webhooks) access allows applications to read or write hook configurations on repositories you manage. | -| 알림(Notifications) | Notification access allows applicationss to read your {% data variables.product.product_name %} notifications, such as comments on issues and pull requests. However, applications remain unable to access anything in your repositories. | +| 알림(Notifications) | Notification access allows applicationss to read your {% data variables.product.product_name %} notifications, such as comments on issues and pull requests. However, applications remain unable to access anything in your repositories. | | Organizations and teams | Organization and teams access allows apps to access and manage organization and team membership. | | Personal user data | User data includes information found in your user profile, like your name, e-mail address, and location. | | Repositories | Repository information includes the names of contributors, the branches you've created, and the actual files within your repository. Applications can request access for either public or private repositories on a user-wide level. | diff --git a/translations/ko-KR/content/github/authenticating-to-github/error-bad-file-number.md b/translations/ko-KR/content/github/authenticating-to-github/error-bad-file-number.md index 7d5919790cf6..1e504f7ee019 100644 --- a/translations/ko-KR/content/github/authenticating-to-github/error-bad-file-number.md +++ b/translations/ko-KR/content/github/authenticating-to-github/error-bad-file-number.md @@ -12,7 +12,7 @@ When running remote Git commands or SSH, your connection might time out: ```shell $ ssh -vT git@{% data variables.command_line.codeblock %} -> OpenSSH_5.8p1, OpenSSL 1.0.0d 8 Feb 2011 +> OpenSSH_8.1p1, LibreSSL 2.7.3 > debug1: Connecting to {% data variables.command_line.codeblock %} [207.97.227.239] port 22. > debug1: connect to address 207.97.227.239 port 22: Connection timed out > ssh: connect to host {% data variables.command_line.codeblock %} port 22: Connection timed out diff --git a/translations/ko-KR/content/github/authenticating-to-github/error-permission-denied-publickey.md b/translations/ko-KR/content/github/authenticating-to-github/error-permission-denied-publickey.md index 696881e413b8..b0b628f57f7d 100644 --- a/translations/ko-KR/content/github/authenticating-to-github/error-permission-denied-publickey.md +++ b/translations/ko-KR/content/github/authenticating-to-github/error-permission-denied-publickey.md @@ -20,11 +20,11 @@ To make sure you are connecting to the right domain, you can enter the following ```shell $ ssh -vT git@{% data variables.command_line.codeblock %} -> OpenSSH_5.6p1, OpenSSL 0.9.8r 8 Feb 2011 +> OpenSSH_8.1p1, LibreSSL 2.7.3 > debug1: Reading configuration data /Users/you/.ssh/config -> debug1: Reading configuration data /etc/ssh_config -> debug1: Applying options for * -> debug1: Connecting to {% data variables.command_line.codeblock %} [IP ADDRESS] port 22. +> debug1: Reading configuration data /etc/ssh/ssh_config +> debug1: /etc/ssh/ssh_config line 47: Applying options for * +> debug1: Connecting to {% data variables.command_line.codeblock %} port 22. ``` The connection should be made on port 22{% if currentVersion == "free-pro-team@latest" %}, unless you're overriding settings to use [SSH over HTTPS](/articles/using-ssh-over-the-https-port){% endif %}. @@ -51,7 +51,7 @@ $ ssh -T git@{% data variables.command_line.codeblock %} {% mac %} {% data reusables.command_line.open_the_multi_os_terminal %} -2. Verify that you have a private key generated and loaded into SSH. If you're using OpenSSH 6.7 or older: +2. Verify that you have a private key generated and loaded into SSH. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell # start the ssh-agent in the background $ eval "$(ssh-agent -s)" @@ -68,6 +68,14 @@ $ ssh -T git@{% data variables.command_line.codeblock %} $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + # start the ssh-agent in the background + $ eval "$(ssh-agent -s)" + > Agent pid 59566 + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} {% endmac %} @@ -78,7 +86,7 @@ $ ssh -T git@{% data variables.command_line.codeblock %} 1. {% data reusables.desktop.windows_git_bash_turn_on_ssh_agent %} {% data reusables.desktop.windows_git_for_windows_turn_on_ssh_agent %} -2. Verify that you have a private key generated and loaded into SSH. If you're using OpenSSH 6.7 or older: +2. Verify that you have a private key generated and loaded into SSH. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) @@ -89,13 +97,18 @@ $ ssh -T git@{% data variables.command_line.codeblock %} $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} {% endwindows %} {% linux %} {% data reusables.command_line.open_the_multi_os_terminal %} -2. Verify that you have a private key generated and loaded into SSH. If you're using OpenSSH 6.7 or older: +2. Verify that you have a private key generated and loaded into SSH. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell # start the ssh-agent in the background $ eval "$(ssh-agent -s)" @@ -112,6 +125,12 @@ $ ssh -T git@{% data variables.command_line.codeblock %} $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} + {% endlinux %} @@ -119,7 +138,7 @@ The `ssh-add` command *should* print out a long string of numbers and letters. I {% tip %} -**Tip**: On most systems the default private keys (`~/.ssh/id_rsa`{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}, `~/.ssh/id_dsa`{% endif %} and `~/.ssh/identity`) are automatically added to the SSH authentication agent. You shouldn't need to run `ssh-add path/to/key` unless you override the file name when you generate a key. +**Tip**: On most systems the default private keys (`~/.ssh/id_rsa` and `~/.ssh/identity`) are automatically added to the SSH authentication agent. You shouldn't need to run `ssh-add path/to/key` unless you override the file name when you generate a key. {% endtip %} @@ -167,7 +186,7 @@ You must provide your public key to {% data variables.product.product_name %} to $ eval "$(ssh-agent -s)" > Agent pid 59566 ``` -3. Find and take a note of your public key fingerprint. If you're using OpenSSH 6.7 or older: +3. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) @@ -178,10 +197,16 @@ You must provide your public key to {% data variables.product.product_name %} to $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -6. Compare the list of SSH keys with the output from the `ssh-add` command. ![SSH key listing in {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png) +6. Compare the list of SSH keys with the output from the `ssh-add` command. +![SSH key listing in {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png) {% endmac %} @@ -193,7 +218,7 @@ You must provide your public key to {% data variables.product.product_name %} to $ ssh-agent -s > Agent pid 59566 ``` -3. Find and take a note of your public key fingerprint. If you're using OpenSSH 6.7 or older: +3. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) @@ -204,10 +229,16 @@ You must provide your public key to {% data variables.product.product_name %} to $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -6. Compare the list of SSH keys with the output from the `ssh-add` command. ![SSH key listing in {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png) +6. Compare the list of SSH keys with the output from the `ssh-add` command. +![SSH key listing in {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png) {% endwindows %} diff --git a/translations/ko-KR/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md b/translations/ko-KR/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md index 9b265fad38a7..375e58f58e78 100644 --- a/translations/ko-KR/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md +++ b/translations/ko-KR/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md @@ -10,8 +10,8 @@ versions: The error you receive may look like the following: ```shell -$ git push -u github.master -> fatal: 'github.master' does not appear to be a git repository +$ git push -u github.main +> fatal: 'github.main' does not appear to be a git repository > fatal: The remote end hung up unexpectedly $ git pull -u github diff --git a/translations/ko-KR/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md b/translations/ko-KR/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md index 23c7227ff70d..f3cd1281d140 100644 --- a/translations/ko-KR/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md +++ b/translations/ko-KR/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md @@ -81,7 +81,8 @@ If you're unable to regain access to your account, generate a one-time password 1. On Facebook, navigate to your [Security Settings](https://www.facebook.com/settings?tab=security), then click **Recover Accounts Elsewhere**. ![Facebook security settings page with Recover Accounts Elsewhere link](/assets/images/help/settings/security-facebook-security-settings-page.png) 2. Click the recovery token associated with your {% data variables.product.product_name %} account. ![List of recovery tokens stored on Facebook](/assets/images/help/settings/security-github-rae-token-on-facebook.png) 3. To redeem your account recovery token, click **Recover This Account**. A new window will open, returning you to {% data variables.product.product_name %}. ![Modal box with information about your recovery token and Recover This Account button](/assets/images/help/settings/security-recover-account-facebook.png) -4. Contact {% data variables.contact.contact_support %} to let them know that your account recovery token is ready for review. +4. 연락처 +{% data variables.contact.contact_support %} to let them know that your account recovery token is ready for review. {% endif %} ### 더 읽을거리 diff --git a/translations/ko-KR/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md b/translations/ko-KR/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md index 73e7b6cd9a0b..0e73552ba473 100644 --- a/translations/ko-KR/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md +++ b/translations/ko-KR/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md @@ -74,7 +74,7 @@ To illustrate how `git filter-branch` works, we'll show you how to remove your f "git rm --cached --ignore-unmatch PATH-TO-YOUR-FILE-WITH-SENSITIVE-DATA" \ --prune-empty --tag-name-filter cat -- --all > Rewrite 48dc599c80e20527ed902928085e7861e6b3cbe6 (266/266) - > Ref 'refs/heads/master' was rewritten + > Ref 'refs/heads/main' was rewritten ``` {% note %} @@ -89,7 +89,7 @@ To illustrate how `git filter-branch` works, we'll show you how to remove your f $ echo "YOUR-FILE-WITH-SENSITIVE-DATA" >> .gitignore $ git add .gitignore $ git commit -m "Add YOUR-FILE-WITH-SENSITIVE-DATA to .gitignore" - > [master 051452f] Add YOUR-FILE-WITH-SENSITIVE-DATA to .gitignore + > [main 051452f] Add YOUR-FILE-WITH-SENSITIVE-DATA to .gitignore > 1 files changed, 1 insertions(+), 0 deletions(-) ``` 5. Double-check that you've removed everything you wanted to from your repository's history, and that all of your branches are checked out. @@ -102,7 +102,7 @@ To illustrate how `git filter-branch` works, we'll show you how to remove your f > Writing objects: 100% (1058/1058), 148.85 KiB, done. > Total 1058 (delta 590), reused 602 (delta 378) > To https://{% data variables.command_line.codeblock %}/YOUR-USERNAME/YOUR-REPOSITORY.git - > + 48dc599...051452f master -> master (forced update) + > + 48dc599...051452f main -> main (forced update) ``` 7. In order to remove the sensitive file from [your tagged releases](/articles/about-releases), you'll also need to force-push against your Git tags: ```shell @@ -113,7 +113,7 @@ To illustrate how `git filter-branch` works, we'll show you how to remove your f > Writing objects: 100% (321/321), 331.74 KiB | 0 bytes/s, done. > Total 321 (delta 124), reused 269 (delta 108) > To https://{% data variables.command_line.codeblock %}/YOUR-USERNAME/YOUR-REPOSITORY.git - > + 48dc599...051452f master -> master (forced update) + > + 48dc599...051452f main -> main (forced update) ``` 8. Contact {% data variables.contact.contact_support %}, asking them to remove cached views and references to the sensitive data in pull requests on {% data variables.product.product_name %}. 9. Tell your collaborators to [rebase](https://git-scm.com/book/en/Git-Branching-Rebasing), *not* merge, any branches they created off of your old (tainted) repository history. One merge commit could reintroduce some or all of the tainted history that you just went to the trouble of purging. diff --git a/translations/ko-KR/content/github/authenticating-to-github/reviewing-your-security-log.md b/translations/ko-KR/content/github/authenticating-to-github/reviewing-your-security-log.md index ec0cbeea2306..fe9db34d9624 100644 --- a/translations/ko-KR/content/github/authenticating-to-github/reviewing-your-security-log.md +++ b/translations/ko-KR/content/github/authenticating-to-github/reviewing-your-security-log.md @@ -31,22 +31,22 @@ The security log lists all actions performed within the last 90 days{% if curren ### Understanding events in your security log Actions listed in your security log are grouped within the following categories: |{% endif %} -| Category Name | 설명 | -| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |{% if currentVersion == "free-pro-team@latest" %} -| `account_recovery_token` | Contains all activities related to [adding a recovery token](/articles/configuring-two-factor-authentication-recovery-methods). | -| `결제` | Contains all activities related to your billing information. | -| `marketplace_agreement_signature` | Contains all activities related to signing the {% data variables.product.prodname_marketplace %} Developer Agreement. | -| `marketplace_listing` | Contains all activities related to listing apps in {% data variables.product.prodname_marketplace %}.{% endif %} -| `oauth_access` | Contains all activities related to [{% data variables.product.prodname_oauth_app %}s](/articles/authorizing-oauth-apps) you've connected with.{% if currentVersion == "free-pro-team@latest" %} -| `payment_method` | Contains all activities related to paying for your {% data variables.product.prodname_dotcom %} subscription.{% endif %} -| `profile_picture` | Contains all activities related to your profile picture. | -| `프로젝트` | Contains all activities related to project boards. | -| `public_key` | Contains all activities related to [your public SSH keys](/articles/adding-a-new-ssh-key-to-your-github-account). | -| `repo` | Contains all activities related to the repositories you own.{% if currentVersion == "free-pro-team@latest" %} -| `sponsors` | Contains all events related to {% data variables.product.prodname_sponsors %} and sponsor buttons (see "[About {% data variables.product.prodname_sponsors %}](/articles/about-github-sponsors)" and "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)"){% endif %}{% if currentVersion != "free-pro-team@latest" %} -| `팀` | Contains all activities related to teams you are a part of.{% endif %} -| `two_factor_authentication` | Contains all activities related to [two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa). | -| `사용자` | Contains all activities related to your account. | +| Category Name | 설명 | +| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |{% if currentVersion == "free-pro-team@latest" %} +| `account_recovery_token` | Contains all activities related to [adding a recovery token](/articles/configuring-two-factor-authentication-recovery-methods). | +| `결제` | Contains all activities related to your billing information. | +| `marketplace_agreement_signature` | Contains all activities related to signing the {% data variables.product.prodname_marketplace %} Developer Agreement. | +| `marketplace_listing` | Contains all activities related to listing apps in {% data variables.product.prodname_marketplace %}.{% endif %} +| `oauth_access` | Contains all activities related to [{% data variables.product.prodname_oauth_app %}s](/articles/authorizing-oauth-apps) you've connected with.{% if currentVersion == "free-pro-team@latest" %} +| `payment_method` | Contains all activities related to paying for your {% data variables.product.prodname_dotcom %} subscription.{% endif %} +| `profile_picture` | Contains all activities related to your profile picture. | +| `프로젝트` | Contains all activities related to project boards. | +| `public_key` | Contains all activities related to [your public SSH keys](/articles/adding-a-new-ssh-key-to-your-github-account). | +| `repo` | Contains all activities related to the repositories you own.{% if currentVersion == "free-pro-team@latest" %} +| `sponsors` | Contains all events related to {% data variables.product.prodname_sponsors %} and sponsor buttons (see "[About {% data variables.product.prodname_sponsors %}](/articles/about-github-sponsors)" and "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)"){% endif %}{% if currentVersion != "free-pro-team@latest" %} +| `팀` | Contains all activities related to teams you are a part of.{% endif %} +| `two_factor_authentication` | Contains all activities related to [two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa). | +| `사용자` | Contains all activities related to your account. | A description of the events within these categories is listed below. @@ -58,37 +58,37 @@ A description of the events within these categories is listed below. | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | confirm | Triggered when you successfully [store a new token with a recovery provider](/articles/configuring-two-factor-authentication-recovery-methods). | | recover | Triggered when you successfully [redeem an account recovery token](/articles/recovering-your-account-if-you-lose-your-2fa-credentials). | -| recover_error | Triggered when a token is used but {% data variables.product.prodname_dotcom %} is not able to validate it. | +| recover_error | Triggered when a token is used but {% data variables.product.prodname_dotcom %} is not able to validate it. | #### The `billing` category -| 동작 | 설명 | -| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | +| 동작 | 설명 | +| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | | change_billing_type | Triggered when you [change how you pay](/articles/adding-or-editing-a-payment-method) for {% data variables.product.prodname_dotcom %}. | -| change_email | Triggered when you [change your email address](/articles/changing-your-primary-email-address). | +| change_email | Triggered when you [change your email address](/articles/changing-your-primary-email-address). | #### The `marketplace_agreement_signature` category -| 동작 | 설명 | -| ------ | ------------------------------------------------------------------------------------------------------- | +| 동작 | 설명 | +| ------ | -------------------------------------------------------------------------------------------------- | | create | Triggered when you sign the {% data variables.product.prodname_marketplace %} Developer Agreement. | #### The `marketplace_listing` category -| 동작 | 설명 | -| ------- | -------------------------------------------------------------------------------------------------------------------- | +| 동작 | 설명 | +| ------- | --------------------------------------------------------------------------------------------------------------- | | 승인 | Triggered when your listing is approved for inclusion in {% data variables.product.prodname_marketplace %}. | | create | Triggered when you create a listing for your app in {% data variables.product.prodname_marketplace %}. | | delist | Triggered when your listing is removed from {% data variables.product.prodname_marketplace %}. | -| redraft | Triggered when your listing is sent back to draft state. | +| redraft | Triggered when your listing is sent back to draft state. | | reject | Triggered when your listing is not accepted for inclusion in {% data variables.product.prodname_marketplace %}. | {% endif %} #### The `oauth_access` category -| 동작 | 설명 | -| ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 동작 | 설명 | +| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | create | Triggered when you [grant access to an {% data variables.product.prodname_oauth_app %}](/articles/authorizing-oauth-apps). | | destroy | Triggered when you [revoke an {% data variables.product.prodname_oauth_app %}'s access to your account](/articles/reviewing-your-authorized-integrations). | @@ -125,53 +125,53 @@ A description of the events within these categories is listed below. #### The `public_key` category -| 동작 | 설명 | -| ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 동작 | 설명 | +| ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | create | Triggered when you [add a new public SSH key to your {% data variables.product.product_name %} account](/articles/adding-a-new-ssh-key-to-your-github-account). | | delete | Triggered when you [remove a public SSH key to your {% data variables.product.product_name %} account](/articles/reviewing-your-ssh-keys). | #### The `repo` category -| 동작 | 설명 | -| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| 액세스 | Triggered when you a repository you own is [switched from "private" to "public"](/articles/making-a-private-repository-public) (or vice versa). | +| 동작 | 설명 | +| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 액세스 | Triggered when you a repository you own is [switched from "private" to "public"](/articles/making-a-private-repository-public) (or vice versa). | | add_member | Triggered when a {% data variables.product.product_name %} user is {% if currentVersion == "free-pro-team@latest" %}[invited to have collaboration access](/articles/inviting-collaborators-to-a-personal-repository){% else %}[given collaboration access](/articles/inviting-collaborators-to-a-personal-repository){% endif %} to a repository. | -| add_topic | Triggered when a repository owner [adds a topic](/articles/classifying-your-repository-with-topics) to a repository. | +| add_topic | Triggered when a repository owner [adds a topic](/articles/classifying-your-repository-with-topics) to a repository. | | archived | Triggered when a repository owner [archives a repository](/articles/about-archiving-repositories).{% if currentVersion != "free-pro-team@latest" %} -| config.disable_anonymous_git_access | Triggered when [anonymous Git read access is disabled](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) in a public repository. | -| config.enable_anonymous_git_access | Triggered when [anonymous Git read access is enabled](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) in a public repository. | -| config.lock_anonymous_git_access | Triggered when a repository's [anonymous Git read access setting is locked](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access). | +| config.disable_anonymous_git_access | Triggered when [anonymous Git read access is disabled](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) in a public repository. | +| config.enable_anonymous_git_access | Triggered when [anonymous Git read access is enabled](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) in a public repository. | +| config.lock_anonymous_git_access | Triggered when a repository's [anonymous Git read access setting is locked](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access). | | config.unlock_anonymous_git_access | Triggered when a repository's [anonymous Git read access setting is unlocked](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access).{% endif %} -| create | Triggered when [a new repository is created](/articles/creating-a-new-repository). | +| create | Triggered when [a new repository is created](/articles/creating-a-new-repository). | | destroy | Triggered when [a repository is deleted](/articles/deleting-a-repository).{% if currentVersion == "free-pro-team@latest" %} | 비활성화 | Triggered when a repository is disabled (e.g., for [insufficient funds](/articles/unlocking-a-locked-account)).{% endif %}{% if currentVersion == "free-pro-team@latest" %} | 활성화 | Triggered when a repository is re-enabled.{% endif %} -| remove_member | Triggered when a {% data variables.product.product_name %} user is [removed from a repository as a collaborator](/articles/removing-a-collaborator-from-a-personal-repository). | -| remove_topic | Triggered when a repository owner removes a topic from a repository. | -| rename | Triggered when [a repository is renamed](/articles/renaming-a-repository). | -| 전송 | Triggered when [a repository is transferred](/articles/how-to-transfer-a-repository). | -| transfer_start | Triggered when a repository transfer is about to occur. | -| unarchived | Triggered when a repository owner unarchives a repository. | +| remove_member | Triggered when a {% data variables.product.product_name %} user is [removed from a repository as a collaborator](/articles/removing-a-collaborator-from-a-personal-repository). | +| remove_topic | Triggered when a repository owner removes a topic from a repository. | +| rename | Triggered when [a repository is renamed](/articles/renaming-a-repository). | +| 전송 | Triggered when [a repository is transferred](/articles/how-to-transfer-a-repository). | +| transfer_start | Triggered when a repository transfer is about to occur. | +| unarchived | Triggered when a repository owner unarchives a repository. | {% if currentVersion == "free-pro-team@latest" %} #### The `sponsors` category -| 동작 | 설명 | -| ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| repo_funding_link_button_toggle | Triggered when you enable or disable a sponsor button in your repository (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)") | -| repo_funding_links_file_action | Triggered when you change the FUNDING file in your repository (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)") | -| sponsor_sponsorship_cancel | Triggered when you cancel a sponsorship (see "[Downgrading a sponsorship](/articles/downgrading-a-sponsorship)") | -| sponsor_sponsorship_create | Triggered when you sponsor a developer (see "[Sponsoring an open source contributor](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor#sponsoring-a-developer)") | -| sponsor_sponsorship_preference_change | Triggered when you change whether you receive email updates from a sponsored developer (see "[Managing your sponsorship](/articles/managing-your-sponsorship)") | -| sponsor_sponsorship_tier_change | Triggered when you upgrade or downgrade your sponsorship (see "[Upgrading a sponsorship](/articles/upgrading-a-sponsorship)" and "[Downgrading a sponsorship](/articles/downgrading-a-sponsorship)") | +| 동작 | 설명 | +| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| repo_funding_link_button_toggle | Triggered when you enable or disable a sponsor button in your repository (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)") | +| repo_funding_links_file_action | Triggered when you change the FUNDING file in your repository (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)") | +| sponsor_sponsorship_cancel | Triggered when you cancel a sponsorship (see "[Downgrading a sponsorship](/articles/downgrading-a-sponsorship)") | +| sponsor_sponsorship_create | Triggered when you sponsor a developer (see "[Sponsoring an open source contributor](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor#sponsoring-a-developer)") | +| sponsor_sponsorship_preference_change | Triggered when you change whether you receive email updates from a sponsored developer (see "[Managing your sponsorship](/articles/managing-your-sponsorship)") | +| sponsor_sponsorship_tier_change | Triggered when you upgrade or downgrade your sponsorship (see "[Upgrading a sponsorship](/articles/upgrading-a-sponsorship)" and "[Downgrading a sponsorship](/articles/downgrading-a-sponsorship)") | | sponsored_developer_approve | Triggered when your {% data variables.product.prodname_sponsors %} account is approved (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") | | sponsored_developer_create | Triggered when your {% data variables.product.prodname_sponsors %} account is created (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") | -| sponsored_developer_profile_update | Triggered when you edit your sponsored developer profile (see "[Editing your profile details for {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors)") | +| sponsored_developer_profile_update | Triggered when you edit your sponsored developer profile (see "[Editing your profile details for {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors)") | | sponsored_developer_request_approval | Triggered when you submit your application for {% data variables.product.prodname_sponsors %} for approval (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") | -| sponsored_developer_tier_description_update | Triggered when you change the description for a sponsorship tier (see "[Changing your sponsorship tiers](/articles/changing-your-sponsorship-tiers)") | -| sponsored_developer_update_newsletter_send | Triggered when you send an email update to your sponsors (see "[Contacting your sponsors](/articles/contacting-your-sponsors)") | +| sponsored_developer_tier_description_update | Triggered when you change the description for a sponsorship tier (see "[Changing your sponsorship tiers](/articles/changing-your-sponsorship-tiers)") | +| sponsored_developer_update_newsletter_send | Triggered when you send an email update to your sponsors (see "[Contacting your sponsors](/articles/contacting-your-sponsors)") | | waitlist_invite_sponsored_developer | Triggered when you are invited to join {% data variables.product.prodname_sponsors %} from the waitlist (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") | -| waitlist_join | Triggered when you join the waitlist to become a sponsored developer (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") | +| waitlist_join | Triggered when you join the waitlist to become a sponsored developer (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") | {% endif %} {% if currentVersion == "free-pro-team@latest" %} @@ -210,18 +210,18 @@ A description of the events within these categories is listed below. #### The `user` category -| 동작 | 설명 | -| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| add_email | Triggered when you [add a new email address](/articles/changing-your-primary-email-address). | -| create | Triggered when you create a new user account. | -| remove_email | Triggered when you remove an email address. | -| rename | Triggered when you rename your account. | -| change_password | Triggered when you change your password. | -| forgot_password | Triggered when you ask for [a password reset](/articles/how-can-i-reset-my-password). | -| login | Triggered when you log in to {% data variables.product.product_location %}. | -| failed_login | Triggered when you failed to log in successfully. | -| two_factor_requested | Triggered when {% data variables.product.product_name %} asks you for [your two-factor authentication code](/articles/accessing-github-using-two-factor-authentication). | -| show_private_contributions_count | Triggered when you [publicize private contributions on your profile](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile). | +| 동작 | 설명 | +| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| add_email | Triggered when you [add a new email address](/articles/changing-your-primary-email-address). | +| create | Triggered when you create a new user account. | +| remove_email | Triggered when you remove an email address. | +| rename | Triggered when you rename your account. | +| change_password | Triggered when you change your password. | +| forgot_password | Triggered when you ask for [a password reset](/articles/how-can-i-reset-my-password). | +| login | Triggered when you log in to {% data variables.product.product_location %}. | +| failed_login | Triggered when you failed to log in successfully. | +| two_factor_requested | Triggered when {% data variables.product.product_name %} asks you for [your two-factor authentication code](/articles/accessing-github-using-two-factor-authentication). | +| show_private_contributions_count | Triggered when you [publicize private contributions on your profile](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile). | | hide_private_contributions_count | Triggered when you [hide private contributions on your profile](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile).{% if currentVersion == "free-pro-team@latest" %} | report_content | Triggered when you [report an issue or pull request, or a comment on an issue, pull request, or commit](/articles/reporting-abuse-or-spam).{% endif %} diff --git a/translations/ko-KR/content/github/authenticating-to-github/reviewing-your-ssh-keys.md b/translations/ko-KR/content/github/authenticating-to-github/reviewing-your-ssh-keys.md index 5a1e3dfd958f..0231b1b45afb 100644 --- a/translations/ko-KR/content/github/authenticating-to-github/reviewing-your-ssh-keys.md +++ b/translations/ko-KR/content/github/authenticating-to-github/reviewing-your-ssh-keys.md @@ -20,7 +20,7 @@ You can delete unauthorized (or possibly compromised) SSH keys to ensure that an {% tip %} - **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys. ![Unverified SSH key](/assets/images/help/settings/settings-ssh-key-review-highlight.png) + **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys. {% endtip %} @@ -28,7 +28,7 @@ You can delete unauthorized (or possibly compromised) SSH keys to ensure that an 5. {% data reusables.command_line.start_ssh_agent %} -6. Find and take a note of your public key fingerprint. If you're using OpenSSH 6.7 or older: +6. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) @@ -39,6 +39,11 @@ You can delete unauthorized (or possibly compromised) SSH keys to ensure that an $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} 7. The SSH keys on {% data variables.product.product_name %} *should* match the same keys on your computer. @@ -48,21 +53,18 @@ You can delete unauthorized (or possibly compromised) SSH keys to ensure that an {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -3. On the SSH Settings page, take note of the SSH keys associated with your account. For those that you don't recognize, or that are out-of-date, click **Delete**. If there are valid SSH keys you'd like to keep, click **Approve**. ![SSH key list](/assets/images/help/settings/settings-ssh-key-review.png) +3. On the SSH Settings page, take note of the SSH keys associated with your account. For those that you don't recognize, or that are out-of-date, click Delete. If there are valid SSH keys you'd like to keep, click Approve. + ![SSH key list](/assets/images/help/settings/settings-ssh-key-review.png) {% tip %} - **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys.![Unverified SSH key](/assets/images/help/settings/settings-ssh-key-review-highlight.png) + **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys. {% endtip %} 4. Open Git Bash. If you're using Git Shell, which is included in {% data variables.product.prodname_desktop %}, open Git Shell and skip to step 6. -5. {% data reusables.desktop.windows_git_bash_turn_on_ssh_agent %} - - {% data reusables.desktop.windows_git_for_windows_turn_on_ssh_agent %} - -6. Find and take a note of your public key fingerprint. If you're using OpenSSH 6.7 or older: +5. {% data reusables.desktop.windows_git_bash_turn_on_ssh_agent %} Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) @@ -73,20 +75,20 @@ You can delete unauthorized (or possibly compromised) SSH keys to ensure that an $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} 7. The SSH keys on {% data variables.product.product_name %} *should* match the same keys on your computer. -{% endwindows %} - -{% linux %} - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.ssh %} -3. On the SSH Settings page, take note of the SSH keys associated with your account. For those that you don't recognize, or that are out-of-date, click **Delete**. If there are valid SSH keys you'd like to keep, click **Approve**. ![SSH key list](/assets/images/help/settings/settings-ssh-key-review.png) +{% data reusables.desktop.windows_git_for_windows_turn_on_ssh_agent %} On the SSH Settings page, take note of the SSH keys associated with your account. For those that you don't recognize, or that are out-of-date, click Delete. If there are valid SSH keys you'd like to keep, click Approve. + ![SSH key list](/assets/images/help/settings/settings-ssh-key-review.png) {% tip %} - **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys. ![Unverified SSH key](/assets/images/help/settings/settings-ssh-key-review-highlight.png) + **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys. {% endtip %} @@ -94,7 +96,7 @@ You can delete unauthorized (or possibly compromised) SSH keys to ensure that an 5. {% data reusables.command_line.start_ssh_agent %} -6. Find and take a note of your public key fingerprint. If you're using OpenSSH 6.7 or older: +6. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) @@ -105,6 +107,9 @@ You can delete unauthorized (or possibly compromised) SSH keys to ensure that an $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} +```shell $ ssh-add -l -E sha256 +> 2048 *SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ* /Users/*USERNAME*/.ssh/id_rsa (RSA) ```{% endif %} 7. The SSH keys on {% data variables.product.product_name %} *should* match the same keys on your computer. diff --git a/translations/ko-KR/content/github/authenticating-to-github/signing-commits.md b/translations/ko-KR/content/github/authenticating-to-github/signing-commits.md index fd8cdec4f006..b27357ca0b13 100644 --- a/translations/ko-KR/content/github/authenticating-to-github/signing-commits.md +++ b/translations/ko-KR/content/github/authenticating-to-github/signing-commits.md @@ -39,7 +39,8 @@ If you have multiple keys or are attempting to sign commits or tags with a key t $ git push # Pushes your local commits to the remote repository ``` -4. On {% data variables.product.product_name %}, navigate to your pull request. +4. On +{% data variables.product.product_name %}, navigate to your pull request. {% data reusables.repositories.review-pr-commits %} 5. To view more detailed information about the verified signature, click Verified. ![Signed commit](/assets/images/help/commits/gpg-signed-commit-verified-without-details.png) diff --git a/translations/ko-KR/content/github/authenticating-to-github/updating-your-github-access-credentials.md b/translations/ko-KR/content/github/authenticating-to-github/updating-your-github-access-credentials.md index 34f12799ceb7..b43565ee5a8a 100644 --- a/translations/ko-KR/content/github/authenticating-to-github/updating-your-github-access-credentials.md +++ b/translations/ko-KR/content/github/authenticating-to-github/updating-your-github-access-credentials.md @@ -29,11 +29,7 @@ To avoid losing your password in the future, we suggest using a secure password 1. {% data variables.product.signin_link %} to {% data variables.product.product_name %}. {% data reusables.user_settings.access_settings %} -{%- if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} {% data reusables.user_settings.security %} -{%- else %} -{% data reusables.user_settings.account_settings %} -{%- endif %} 4. Under "Change password", type your old password, a strong new password, and confirm your new password. For help creating a strong password, see "[Creating a strong password](/articles/creating-a-strong-password)" 5. Click **Update password**. diff --git a/translations/ko-KR/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md b/translations/ko-KR/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md index 646afc05759d..cbb268aa25b1 100644 --- a/translations/ko-KR/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md +++ b/translations/ko-KR/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md @@ -58,7 +58,7 @@ fi unset env ``` -If your private key is not stored in one of the default locations (like `~/.ssh/id_rsa`{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} or `~/.ssh/id_dsa`{% endif %}), you'll need to tell your SSH authentication agent where to find it. To add your key to ssh-agent, type `ssh-add ~/path/to/my_key`. For more information, see "[Generating a new SSH key and adding it to the ssh-agent](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/)" +If your private key is not stored in one of the default locations (like `~/.ssh/id_rsa`), you'll need to tell your SSH authentication agent where to find it. To add your key to ssh-agent, type `ssh-add ~/path/to/my_key`. For more information, see "[Generating a new SSH key and adding it to the ssh-agent](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/)" {% tip %} @@ -89,8 +89,7 @@ The `ssh-agent` process will continue to run until you log out, shut down your c On OS X Leopard through OS X El Capitan, these default private key files are handled automatically: -- *.ssh/id_rsa*{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -- *.ssh/id_dsa*{% endif %} +- *.ssh/id_rsa* - *.ssh/identity* The first time you use your key, you will be prompted to enter your passphrase. If you choose to save the passphrase with your keychain, you won't have to enter it again. diff --git a/translations/ko-KR/content/github/building-a-strong-community/creating-a-default-community-health-file.md b/translations/ko-KR/content/github/building-a-strong-community/creating-a-default-community-health-file.md index 073cd9ba8129..ff5c7138526b 100644 --- a/translations/ko-KR/content/github/building-a-strong-community/creating-a-default-community-health-file.md +++ b/translations/ko-KR/content/github/building-a-strong-community/creating-a-default-community-health-file.md @@ -26,14 +26,14 @@ Default files are not included in clones, packages, or downloads of individual r You can create defaults in your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %} for the following community health files: -| Community health file | 설명 | -| --------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" %} -| *CODE_OF_CONDUCT.md* | A CODE_OF_CONDUCT file defines standards for how to engage in a community. For more information, see "[Adding a code of conduct to your project](/articles/adding-a-code-of-conduct-to-your-project/)."{% endif %} -| *CONTRIBUTING.md* | A CONTRIBUTING file communicates how people should contribute to your project. For more information, see "[Setting guidelines for repository contributors](/articles/setting-guidelines-for-repository-contributors/)."{% if currentVersion == "free-pro-team@latest" %} -| *FUNDING.yml* | A FUNDING file displays a sponsor button in your repository to increase the visibility of funding options for your open source project. For more information, see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)."{% endif %} +| Community health file | 설명 | +| --------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" %} +| *CODE_OF_CONDUCT.md* | A CODE_OF_CONDUCT file defines standards for how to engage in a community. For more information, see "[Adding a code of conduct to your project](/articles/adding-a-code-of-conduct-to-your-project/)."{% endif %} +| *CONTRIBUTING.md* | A CONTRIBUTING file communicates how people should contribute to your project. For more information, see "[Setting guidelines for repository contributors](/articles/setting-guidelines-for-repository-contributors/)."{% if currentVersion == "free-pro-team@latest" %} +| *FUNDING.yml* | A FUNDING file displays a sponsor button in your repository to increase the visibility of funding options for your open source project. For more information, see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)."{% endif %} | Issue and pull request templates{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and *config.yml*{% endif %} | Issue and pull request templates customize and standardize the information you'd like contributors to include when they open issues and pull requests in your repository. For more information, see "[About issue and pull request templates](/articles/about-issue-and-pull-request-templates/)."{% if currentVersion == "free-pro-team@latest" %} -| *SECURITY.md* | A SECURITY file gives instructions for how to responsibly report a security vulnerability in your project. For more information, see "[Adding a security policy to your repository](/articles/adding-a-security-policy-to-your-repository)."{% endif %} -| *SUPPORT.md* | A SUPPORT file lets people know about ways to get help with your project. For more information, see "[Adding support resources to your project](/articles/adding-support-resources-to-your-project/)." | +| *SECURITY.md* | A SECURITY file gives instructions for how to responsibly report a security vulnerability in your project. For more information, see "[Adding a security policy to your repository](/articles/adding-a-security-policy-to-your-repository)."{% endif %} +| *SUPPORT.md* | A SUPPORT file lets people know about ways to get help with your project. For more information, see "[Adding support resources to your project](/articles/adding-support-resources-to-your-project/)." | You cannot create a default license file. License files must be added to individual repositories so the file will be included when a project is cloned, packaged, or downloaded. @@ -42,7 +42,7 @@ You cannot create a default license file. License files must be added to individ {% data reusables.repositories.create_new %} 2. Use the **Owner** drop-down menu, and select the organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %} you want to create default files for. ![Owner drop-down menu](/assets/images/help/repository/create-repository-owner.png) 3. Type **.github** as the name for your repository, and an optional description. ![Create repository field](/assets/images/help/repository/default-file-repository-name.png) -4. Choose to make the repository public. ![Radio buttons to select private or public status](/assets/images/help/repository/create-repository-public-private.png) +4. Make sure the repository status is set to **Public** (a repository for default files cannot be private). ![Radio buttons to select private or public status](/assets/images/help/repository/create-repository-public-private.png) {% data reusables.repositories.initialize-with-readme %} {% data reusables.repositories.create-repo %} 7. In the repository, create one of the supported community health files. Issue templates{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and their configuration file{% endif %} must be in a folder called `.github/ISSUE_TEMPLATE`. All other supported files must be in the root of the repository. For more information, see "[Creating new files](/articles/creating-new-files/)." diff --git a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/about-branches.md b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/about-branches.md index 79e525eec583..8fe377bda527 100644 --- a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/about-branches.md +++ b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/about-branches.md @@ -10,28 +10,30 @@ versions: --- -### Introducing branches +### About branches Branches allow you to develop features, fix bugs, or safely experiment with new ideas in a contained area of your repository. You always create a branch from an existing branch. Typically, you might create a new branch from the default branch of your repository. You can then work on this new branch in isolation from changes that other people are making to the repository. A branch you create to build a feature is commonly referred to as a feature branch or topic branch. For more information, see "[Creating and deleting branches within your repository](/articles/creating-and-deleting-branches-within-your-repository/)." -You can also use a branch to publish a {% data variables.product.prodname_pages %} site. For more information, see "[What is {% data variables.product.prodname_dotcom %} Pages?](/articles/what-is-github-pages)" +You can also use a branch to publish a {% data variables.product.prodname_pages %} site. For more information, see "[About {% data variables.product.prodname_pages %}](/articles/what-is-github-pages)." -You must have write access to a repository to create a branch, open a pull request, or delete and restore branches in a pull request. For more information, see "[Access permissions on {% data variables.product.product_name %}](/articles/access-permissions-on-github)." +You must have write access to a repository to create a branch, open a pull request, or delete and restore branches in a pull request. For more information, see "[Access permissions on {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/access-permissions-on-github)." ### About the default branch {% data reusables.branches.new-repo-default-branch %} The default branch is the branch that {% data variables.product.prodname_dotcom %} displays when anyone visits your repository. The default branch is also the initial branch that Git checks out locally out when someone clones the repository. {% data reusables.branches.default-branch-automatically-base-branch %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +By default, {% data variables.product.product_name %} names the default branch {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.23" %}`main`{% else %}`master`{% endif %} in any new repository. -By default, the default branch name is `master`, but you can set the name to anything that makes sense for your workflow. For more information on the default branch name, see "[Managing the default branch name for your repositories](/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories)." +{% data reusables.branches.set-default-branch %} -{% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} {% data reusables.branches.set-default-branch %} +{% endif %} + ### Working with branches Once you're satisfied with your work, you can open a pull request to merge the changes in the current branch (the *head* branch) into another branch (the *base* branch). For more information, see "[About pull requests](/articles/about-pull-requests)." diff --git a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md index ae76bb27cb84..54abdb7f1f1f 100644 --- a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md +++ b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md @@ -38,7 +38,7 @@ You can also choose to ignore whitespace changes to get a more accurate view of ![Diff viewing options menu](/assets/images/help/pull_requests/diff-settings-menu.png) -To simplify reviewing changes in a large pull request, you can filter the diff to only show selected file types{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}, show files you are a CODEOWNER of, hide files you have already viewed,{% endif %} or hide deleted files. For more information, see "[Filtering files in a pull request by file type](/articles/filtering-files-in-a-pull-request)." +To simplify reviewing changes in a large pull request, you can filter the diff to only show selected file types, show files you are a CODEOWNER of, hide files you have already viewed, or hide deleted files. For more information, see "[Filtering files in a pull request by file type](/articles/filtering-files-in-a-pull-request)." ![File filter drop-down menu](/assets/images/help/pull_requests/file-filter-menu.png) @@ -54,7 +54,7 @@ A two-dot diff compares two Git committish references, such as SHAs or OIDs (Obj If you want to simulate a two-dot diff in a pull request and see a comparison between the most recent versions of each branch, you can merge the base branch into your topic branch, which updates the last common ancestor between your branches. -For more information about Git commands to compare changes, see "[Git diff options ](https://git-scm.com/docs/git-diff#git-diff-emgitdiffemltoptionsgtltcommitgtltcommitgt--ltpathgt82308203)" from the _Pro Git_ book site. +For more information about Git commands to compare changes, see "[Git diff options](https://git-scm.com/docs/git-diff#git-diff-emgitdiffemltoptionsgtltcommitgtltcommitgt--ltpathgt82308203)" from the _Pro Git_ book site. ### Reasons diffs will not display - You've exceeded the total limit of files or certain file types. For more information, see "[Limits for viewing content and diffs in a repository](/articles/limits-for-viewing-content-and-diffs-in-a-repository/#diff-limits)." diff --git a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/about-forks.md b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/about-forks.md index 785ee70b046a..d9fb9ee4547c 100644 --- a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/about-forks.md +++ b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/about-forks.md @@ -23,7 +23,7 @@ In open source projects, forks are often used to iterate on ideas or changes bef {% data reusables.repositories.private_forks_inherit_permissions %} -If you want to create a new repository from the contents of an existing repository but don't want to merge your changes upstream in the future, you can duplicate the repository {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}or, if the repository is a template, use the repository as a template{% endif %}. For more information, see "[Duplicating a repository](/articles/duplicating-a-repository)"{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} and [Creating a repository from a template](/articles/creating-a-repository-from-a-template)"{% endif %}. +If you want to create a new repository from the contents of an existing repository but don't want to merge your changes upstream in the future, you can duplicate the repository or, if the repository is a template, use the repository as a template. For more information, see "[Duplicating a repository](/articles/duplicating-a-repository)" and [Creating a repository from a template](/articles/creating-a-repository-from-a-template)". ### 더 읽을거리 diff --git a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md index 9f271f36dc22..dacac35e51df 100644 --- a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md +++ b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md @@ -46,7 +46,7 @@ You can navigate between the checks summaries for various commits in a pull requ #### Skipping and requesting checks for individual commits -When a repository is set to automatically request checks for pushes, you can choose to skip checks for an individual commit you push. When a repository is _not_ set to automatically request checks for pushes, you can request checks for an individual commit you push. For more information on these settings, see "[Check Suites](/v3/checks/suites/#set-preferences-for-check-suites-on-a-repository)." +When a repository is set to automatically request checks for pushes, you can choose to skip checks for an individual commit you push. When a repository is _not_ set to automatically request checks for pushes, you can request checks for an individual commit you push. For more information on these settings, see "[Check Suites](/rest/reference/checks#update-repository-preferences-for-check-suites)." To skip or request checks for your commit, add one of the following trailer lines to the end of your commit message: diff --git a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md index ee93801ea900..5bf22210da73 100644 --- a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md +++ b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md @@ -22,7 +22,9 @@ Only the user who created the pull request can give you permission to push commi {% endnote %} -1. On {% data variables.product.product_name %}, navigate to the main page of the fork (or copy of your repository) where the pull request branch was created. +1. On + +{% data variables.product.product_name %}, navigate to the main page of the fork (or copy of your repository) where the pull request branch was created. {% data reusables.repositories.copy-clone-url %} {% data reusables.command_line.open_the_multi_os_terminal %} {% tip %} diff --git a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md index abb92c87cd4c..a5907c6b59e5 100644 --- a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md +++ b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md @@ -18,7 +18,7 @@ You can specify which branch you'd like to merge your changes into when you crea ### Changing the branch range and destination repository -By default, pull requests are based on the parent repository's [default branch](/articles/setting-the-default-branch). +By default, pull requests are based on the parent repository's default branch. For more information, see "[About branches](/github/collaborating-with-issues-and-pull-requests/about-branches#about-the-default-branch)." If the default parent repository isn't correct, you can change both the parent repository and the branch with the drop-down lists. You can also swap your head and base branches with the drop-down lists to establish diffs between reference points. References here must be branch names in your GitHub repository. diff --git a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md index a230bc172ebc..1de46c6bd2b6 100644 --- a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md +++ b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md @@ -21,7 +21,7 @@ versions: {% data reusables.pull_requests.automatically-delete-branches %} -If the branch you want to delete is the repository's default branch, you must choose a new default branch before deleting the branch. For more information, see "[Setting the default branch](/github/administering-a-repository/setting-the-default-branch)." +If the branch you want to delete is the repository's default branch, you must choose a new default branch before deleting the branch. For more information, see "[Changing the default branch](/github/administering-a-repository/changing-the-default-branch)." If the branch you want to delete is associated with an open pull request, you must merge or close the pull request before deleting the branch. For more information, see "[Merging a pull request](/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request)" or "[Closing a pull request](/github/collaborating-with-issues-and-pull-requests/closing-a-pull-request)." diff --git a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md index 912e52a17842..77c0304acaf0 100644 --- a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md +++ b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md @@ -14,14 +14,10 @@ This changes the status of the review to a review comment. When you dismiss a re {% data reusables.search.requested_reviews_search %} {% data reusables.repositories.sidebar-pr %} -{% data reusables.repositories.choose-pr-review %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} +{% data reusables.repositories.choose-pr-review %} 3. On the "Conversation" tab, scroll to the review you'd like to dismiss, then click {% octicon "chevron-down" aria-label="The down button" %}. ![Chevron icon in the merge box](/assets/images/help/pull_requests/merge_box/pull-request-open-menu.png) 4. Click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Dismiss review**. ![Kebab icon in merge box](/assets/images/help/pull_requests/merge_box/pull-request-dismiss-review.png) 5. Type your reason for dismissing the review, then click **Dismiss review**. ![Dismiss review button](/assets/images/help/pull_requests/merge_box/pull-request-dismiss-review-button.png) -{% else %} -3. On the "Conversation" tab, scroll to the review you'd like to see, then click **Dismiss review**. ![Option to dismiss a review](/assets/images/help/pull_requests/merge_box/pull-request-dismiss-review.png) -4. Type your reason for dismissing the review, then click **Dismiss review**. ![Dismiss review button](/assets/images/help/pull_requests/merge_box/pull-request-dismiss-review-button.png) -{% endif %} ### 더 읽을거리 diff --git a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md index 66bc29ca6b0d..307647ab17f7 100644 --- a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md +++ b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md @@ -9,11 +9,11 @@ versions: enterprise-server: '*' --- -You can filter files in a pull request by file extension type, such as `.html` or `.js`, no extension, {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} code ownership, {% endif %} or dotfiles. +You can filter files in a pull request by file extension type, such as `.html` or `.js`, lack of an extension, code ownership, or dotfiles. {% tip %} -**Tip:** To simplify your pull request diff view, you can also temporarily hide deleted files{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} or files you have already viewed {% endif %}in the pull request diff from the file filter drop-down menu. +**Tip:** To simplify your pull request diff view, you can also temporarily hide deleted files or files you have already viewed in the pull request diff from the file filter drop-down menu. {% endtip %} diff --git a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md index 4b37fdf1f44c..73dbca41ea25 100644 --- a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md +++ b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md @@ -45,13 +45,13 @@ If you decide you don't want the changes in a topic branch to be merged to the u 6. Click **Confirm merge**, **Confirm squash and merge**, or **Confirm rebase and merge**. 6. Optionally, [delete the branch](/articles/deleting-unused-branches). This keeps the list of branches in your repository tidy. - {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}The repository may be configured so that the head branch for a pull request is automatically deleted when you merge a pull request. For more information, see "[Managing the automatic deletion of branches](/github/administering-a-repository/managing-the-automatic-deletion-of-branches)."{% endif %} +The repository may be configured so that the head branch for a pull request is automatically deleted when you merge a pull request. For more information, see "[Managing the automatic deletion of branches](/github/administering-a-repository/managing-the-automatic-deletion-of-branches)." {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} {% note %} **Note:** {% data reusables.pull_requests.retargeted-on-branch-deletion %} -For more information, see "[About branches](/github/collaborating-with-issues-and-pull-requests/about-branches#working-with-branches)." + For more information, see "[About branches](/github/collaborating-with-issues-and-pull-requests/about-branches#working-with-branches)." {% endnote %} {% endif %} diff --git a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md index 2a569593ecba..620d3e06bf1b 100644 --- a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md +++ b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md @@ -12,7 +12,7 @@ versions: 2. Change the current working directory to your local project. 3. Check out the branch you wish to merge to. Usually, you will merge into the default branch. ```shell - $ git checkout master + $ git checkout DEFAULT_BRANCH_NAME ``` 4. Pull the desired branch from the upstream repository. This method will retain the commit history without modification. ```shell @@ -23,5 +23,5 @@ versions: 7. Review the changes and ensure they are satisfactory. 8. Push the merge to your GitHub repository. ```shell - $ git push origin master + $ git push origin DEFAULT_BRANCH_NAME ``` diff --git a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md index 4e45c5744015..82a9f8a80409 100644 --- a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md +++ b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md @@ -11,15 +11,18 @@ versions: You can only resolve merge conflicts on {% data variables.product.product_name %} that are caused by competing line changes, such as when people make different changes to the same line of the same file on different branches in your Git repository. For all other types of merge conflicts, you must resolve the conflict locally on the command line. For more information, see "[Resolving a merge conflict using the command line](/articles/resolving-a-merge-conflict-using-the-command-line/)." {% if currentVersion != "free-pro-team@latest" %} -If a site administrator disables the merge conflict editor for pull requests between repositories, you cannot use the conflict editor on {% data variables.product.product_name %} and must resolve merge conflicts on the command line. For example, if the merge conflict editor is disabled, you cannot use it on a pull request between a fork and upstream repository. +If a site administrator disables the merge conflict editor for pull requests between repositories, you cannot use the conflict editor on +{% data variables.product.product_name %} and must resolve merge conflicts on the command line. For example, if the merge conflict editor is disabled, you cannot use it on a pull request between a fork and upstream repository. {% endif %} {% warning %} {% if currentVersion ver_lt "enterprise-server@2.22" %} -**Warning:** When you resolve a merge conflict on {% data variables.product.product_name %}, the entire [base branch](/github/getting-started-with-github/github-glossary#base-branch) of your pull request is merged into the [head branch](/github/getting-started-with-github/github-glossary#head-branch), even if the head branch is the default branch of your repository or a protected branch. Make sure you really want to commit to this branch. +**Warning:** When you resolve a merge conflict on +{% data variables.product.product_name %}, the entire [base branch](/github/getting-started-with-github/github-glossary#base-branch) of your pull request is merged into the [head branch](/github/getting-started-with-github/github-glossary#head-branch), even if the head branch is the default branch of your repository or a protected branch. Make sure you really want to commit to this branch. {% else %} -**Warning:** When you resolve a merge conflict on {% data variables.product.product_name %}, the entire [base branch](/github/getting-started-with-github/github-glossary#base-branch) of your pull request is merged into the [head branch](/github/getting-started-with-github/github-glossary#head-branch). Make sure you really want to commit to this branch. If the head branch is the default branch of your repository, you'll be given the option of creating a new branch to serve as the head branch for your pull request. If the head branch is protected you won't be able to merge your conflict resolution into it, so you'll be prompted to create a new head branch. For more information, see "[About protected branches](/github/administering-a-repository/about-protected-branches)." +**Warning:** When you resolve a merge conflict on +{% data variables.product.product_name %}, the entire [base branch](/github/getting-started-with-github/github-glossary#base-branch) of your pull request is merged into the [head branch](/github/getting-started-with-github/github-glossary#head-branch). Make sure you really want to commit to this branch. If the head branch is the default branch of your repository, you'll be given the option of creating a new branch to serve as the head branch for your pull request. If the head branch is protected you won't be able to merge your conflict resolution into it, so you'll be prompted to create a new head branch. For more information, see "[About protected branches](/github/administering-a-repository/about-protected-branches)." {% endif %} {% endwarning %} diff --git a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-using-the-command-line.md b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-using-the-command-line.md index db4407c4add6..f669c9095c26 100644 --- a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-using-the-command-line.md +++ b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-using-the-command-line.md @@ -83,8 +83,8 @@ For example, if you edited a file, such as *README.md*, and another person remov 2. Generate a list of the files affected by the merge conflict. In this example, the file *README.md* has a merge conflict. ```shell $ git status - > # On branch master - > # Your branch and 'origin/master' have diverged, + > # On branch main + > # Your branch and 'origin/main' have diverged, > # and have 1 and 2 different commits each, respectively. > # (use "git pull" to merge the remote branch into yours) > # You have unmerged paths. diff --git a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md index 7a37d87b7f2b..1d09db14ba00 100644 --- a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md +++ b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md @@ -10,7 +10,7 @@ versions: ### About reviewing pull requests -You can review changes in a pull request one file at a time. While reviewing the files in a pull request, you can leave individual comments on specific changes.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} After you finish reviewing each file, you can mark the file as viewed. This collapses the file, helping you identify the files you still need to review. A progress bar in the pull request header shows the number of files you've viewed.{% endif %} After reviewing as many files as you want, you can approve the pull request or request additional changes by submitting your review with a summary comment. +You can review changes in a pull request one file at a time. While reviewing the files in a pull request, you can leave individual comments on specific changes. After you finish reviewing each file, you can mark the file as viewed. This collapses the file, helping you identify the files you still need to review. A progress bar in the pull request header shows the number of files you've viewed. After reviewing as many files as you want, you can approve the pull request or request additional changes by submitting your review with a summary comment. {% data reusables.search.requested_reviews_search_tip %} @@ -28,14 +28,12 @@ Before you submit your review, your line comments are _pending_ and only visible ![Cancel review button](/assets/images/help/pull_requests/cancel-review-button.png) -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} ### Marking a file as viewed After you finish reviewing a file, you can mark the file as viewed, and the file will collapse. If the file changes after you view the file, it will be unmarked as viewed. {% data reusables.repositories.changed-files %} 2. On the right of the header of the file you've finished reviewing, select **Viewed**. ![Viewed checkbox](/assets/images/help/pull_requests/viewed-checkbox.png) -{% endif %} ### Submitting your review diff --git a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/working-with-pre-receive-hooks.md b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/working-with-pre-receive-hooks.md index 78ce41fd0a7b..85001ffa3167 100644 --- a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/working-with-pre-receive-hooks.md +++ b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/working-with-pre-receive-hooks.md @@ -21,7 +21,7 @@ Total 3 (delta 0), reused 0 (delta 0) remote: always_reject.sh: failed with exit status 1 remote: error: rejecting all pushes To https://54.204.174.51/hodor/nope.git - ! [remote rejected] master -> master (pre-receive hook declined) + ! [remote rejected] main -> main (pre-receive hook declined) error: failed to push some refs to 'https://54.204.174.51/hodor/nope.git' ``` diff --git a/translations/ko-KR/content/github/committing-changes-to-your-project/changing-a-commit-message.md b/translations/ko-KR/content/github/committing-changes-to-your-project/changing-a-commit-message.md index 3b53ea3538f0..25f0a43dabec 100644 --- a/translations/ko-KR/content/github/committing-changes-to-your-project/changing-a-commit-message.md +++ b/translations/ko-KR/content/github/committing-changes-to-your-project/changing-a-commit-message.md @@ -13,13 +13,9 @@ versions: You can change the most recent commit message using the `git commit --amend` command. -{% warning %} - In Git, the text of the commit message is part of the commit. Changing the commit message will change the commit ID--i.e., the SHA1 checksum that names the commit. Effectively, you are creating a new commit that replaces the old one. -{% endwarning %} - -#### Commit has not been pushed online +### Commit has not been pushed online If the commit only exists in your local repository and has not been pushed to {% data variables.product.product_location %}, you can amend the commit message with the `git commit --amend` command. @@ -39,7 +35,7 @@ You can change the default text editor for Git by changing the `core.editor` set {% endtip %} -#### Amending older or multiple commit messages +### Amending older or multiple commit messages If you have already pushed the commit to {% data variables.product.product_location %}, you will have to force push a commit with an amended message. @@ -49,7 +45,7 @@ We strongly discourage force pushing, since this changes the history of your rep {% endwarning %} -**Amending the message of the most recently pushed commit** +**Changing the message of the most recently pushed commit** 1. Follow the [steps above](/articles/changing-a-commit-message#commit-has-not-been-pushed-online) to amend the commit message. 2. Use the `push --force` command to force push over the old commit. @@ -57,7 +53,7 @@ We strongly discourage force pushing, since this changes the history of your rep $ git push --force example-branch ``` -**Amending the message of older or multiple commit messages** +**Changing the message of older or multiple commit messages** If you need to amend the message for multiple commits or an older commit, you can use interactive rebase, then force push to change the commit history. @@ -93,7 +89,6 @@ If you need to amend the message for multiple commits or an older commit, you ca # # Note that empty commits are commented out ``` - 3. Replace `pick` with `reword` before each commit message you want to change. ```shell pick e499d89 Delete CNAME @@ -102,10 +97,10 @@ If you need to amend the message for multiple commits or an older commit, you ca ``` 4. Save and close the commit list file. 5. In each resulting commit file, type the new commit message, save the file, and close it. -6. Force-push the amended commits. - ```shell - $ git push --force - ``` +6. When you're ready to push your changes to GitHub, use the push --force command to force push over the old commit. +```shell +$ git push --force example-branch +``` For more information on interactive rebase, see "[Interactive mode](https://git-scm.com/docs/git-rebase#_interactive_mode)" in the Git manual. diff --git a/translations/ko-KR/content/github/committing-changes-to-your-project/commit-branch-and-tag-labels.md b/translations/ko-KR/content/github/committing-changes-to-your-project/commit-branch-and-tag-labels.md index 8c85a394b99a..26350ec24f21 100644 --- a/translations/ko-KR/content/github/committing-changes-to-your-project/commit-branch-and-tag-labels.md +++ b/translations/ko-KR/content/github/committing-changes-to-your-project/commit-branch-and-tag-labels.md @@ -14,7 +14,7 @@ If your commit is not on the default branch, an indicator will show the branches Once the commit is on the default branch, any tags that contain the commit will be shown and the default branch will be the only branch listed. -![Commit-master-label](/assets/images/help/commits/Commit-master-label.png) +![Commit-main-label](/assets/images/help/commits/Commit-master-label.png) ### 더 읽을거리 diff --git a/translations/ko-KR/content/github/committing-changes-to-your-project/comparing-commits.md b/translations/ko-KR/content/github/committing-changes-to-your-project/comparing-commits.md index 64c9823e97d5..86fda26d0d3b 100644 --- a/translations/ko-KR/content/github/committing-changes-to-your-project/comparing-commits.md +++ b/translations/ko-KR/content/github/committing-changes-to-your-project/comparing-commits.md @@ -46,7 +46,7 @@ To learn more about other comparison options, see "[Three-dot and two-dot diff c You can compare your base repository and any forked repository. This is the view that's presented when a user performs a Pull Request to a project. -To compare branches on different repositories, preface the branch names with user names. For example, by specifying `octocat:master` for `base` and `octo-org:master` for `compare`, you can compare the `master` branch of the repositories respectively owned by `octocat` and `octo-org`. +To compare branches on different repositories, preface the branch names with user names. For example, by specifying `octocat:main` for `base` and `octo-org:main` for `compare`, you can compare the `main` branch of the repositories respectively owned by `octocat` and `octo-org`. Here's an example of a [comparison between two repositories](https://github.com/octocat/linguist/compare/master...octo-org:master). diff --git a/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/about-archiving-repositories.md b/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/about-archiving-repositories.md index 1628093f1ac2..eedf53b16fa1 100644 --- a/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/about-archiving-repositories.md +++ b/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/about-archiving-repositories.md @@ -20,7 +20,7 @@ versions: Once a repository is archived, you cannot add or remove collaborators or teams. Contributors with access to the repository can only fork or star your project. -When a repository is archived, its issues, pull requests, code, labels, milestones, projects, wiki, releases, commits, tags, branches, reactions, and comments become read-only. To make changes in an archived repository, you must unarchive the repository first. +When a repository is archived, its issues, pull requests, code, labels, milestones, projects, wiki, releases, commits, tags, branches, reactions, code scanning alerts, and comments become read-only. To make changes in an archived repository, you must unarchive the repository first. You can search for archived repositories. For more information, see "[Searching for repositories](/articles/searching-for-repositories/#search-based-on-whether-a-repository-is-archived)." You can also search for issues and pull requests within archived repositories. For more information, see "[Searching issues and pull requests](/articles/searching-issues-and-pull-requests/#search-based-on-whether-a-repository-is-archived)." diff --git a/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md b/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md index af118a0c96fb..f50b3dedd64c 100644 --- a/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md +++ b/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md @@ -79,7 +79,8 @@ docs/* docs@example.com apps/ @octocat # In this example, @doctocat owns any file in the `/docs` -# directory in the root of your repository. +# directory in the root of your repository and any of its +# subdirectories. /docs/ @doctocat ``` diff --git a/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/about-repositories.md b/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/about-repositories.md index efdb9e36c800..1e6ace006855 100644 --- a/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/about-repositories.md +++ b/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/about-repositories.md @@ -15,7 +15,8 @@ You can restrict who has access to a repository by choosing the repository's vis For user-owned repositories, you can give other people collaborator access so that they can collaborate on your project. If a repository is owned by an organization, you can give organization members access permissions to collaborate on your repository. For more information, see "[Permission levels for a user account repository](/articles/permission-levels-for-a-user-account-repository/)" and "[Repository permission levels for an organization](/articles/repository-permission-levels-for-an-organization/)." {% if currentVersion == "free-pro-team@latest" %} -With {% data variables.product.prodname_free_team %} for user accounts and 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. To get advanced tooling for private repositories, you can upgrade to {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, or {% data variables.product.prodname_ghe_cloud %}. {% data reusables.gated-features.more-info %} +With +{% data variables.product.prodname_free_team %} for user accounts and 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. To get advanced tooling for private repositories, you can upgrade to {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, or {% data variables.product.prodname_ghe_cloud %}. {% data reusables.gated-features.more-info %} {% else %} Each person and organization can own unlimited repositories and invite an unlimited number of collaborators to all repositories. {% endif %} diff --git a/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md b/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md index 6da0b3d8e9df..ee1806c7663e 100644 --- a/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md +++ b/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md @@ -13,7 +13,8 @@ versions: enterprise-server: '*' --- -{% data variables.product.product_name %} uses the open source [Linguist library](https://github.com/github/linguist) to determine file languages for syntax highlighting and repository statistics. Language statistics will update after you push changes to your default branch. +{% data variables.product.product_name %} uses the open source [Linguist library](https://github.com/github/linguist) to +determine file languages for syntax highlighting and repository statistics. Language statistics will update after you push changes to your default branch. Some files are hard to identify, and sometimes projects contain more library and vendor files than their primary code. If you're receiving incorrect results, please consult the Linguist [troubleshooting guide](https://github.com/github/linguist#troubleshooting) for help. diff --git a/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md b/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md index 47a4b31b0c9e..a7c42ff26320 100644 --- a/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md +++ b/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md @@ -22,12 +22,12 @@ When you clone a repository or wiki, only Git data, such as project files and co - [문제](/v3/issues/#list-issues-for-a-repository) - [Pull requests](/v3/pulls/#list-pull-requests) -- [Forks](/v3/repos/forks/#list-forks) -- [Comments](/v3/issues/comments/#list-comments-in-a-repository) -- [Milestones](/v3/issues/milestones/#list-milestones-for-a-repository) -- [Labels](/v3/issues/labels/#list-all-labels-for-this-repository) -- [Watchers](/v3/activity/watching/#list-watchers) -- [별을 준 사람들](/v3/activity/starring/#list-stargazers) +- [Forks](/rest/reference/repos#list-forks) +- [Comments](/rest/reference/issues#list-issue-comments-for-a-repository) +- [Milestones](/rest/reference/issues#list-milestones) +- [Labels](/rest/reference/issues#list-labels-for-a-repository) +- [Watchers](/rest/reference/activity#list-watchers) +- [별을 준 사람들](/rest/reference/activity#list-stargazers) - [Projects](/v3/projects/#list-repository-projects) {% endif %} @@ -37,6 +37,7 @@ Once you have {% if currentVersion != "free-pro-team@latest" %}a local version o ### Third-party backup tools A number of self-service tools exist that automate backups of repositories. Unlike archival projects, which archive _all_ public repositories on {% data variables.product.product_name %} that have not opted out and make the data accessible to anyone, backup tools will download data from _specific_ repositories and organize it within a new branch or directory. For more information about archival projects, see "[About archiving content and data on {% data variables.product.prodname_dotcom %}](/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github#about-the-github-archive-program)." +You can back up all of a repository's Git data (such as project files and commit history), as well as much data from -You can back up all of a repository's Git data (such as project files and commit history), as well as much data from {% data variables.product.product_name %} (such as issues and pull requests), with [BackHub](https://github.com/marketplace/backhub), which creates daily recurring backups of your repositories with snapshots up to 30 days back in time. BackHub is available in {% data variables.product.prodname_marketplace %}. +{% data variables.product.product_name %} (such as issues and pull requests), with [BackHub](https://github.com/marketplace/backhub), which creates daily recurring backups of your repositories with snapshots up to 30 days back in time. BackHub is available in {% data variables.product.prodname_marketplace %}. {% endif %} diff --git a/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md b/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md index 30ec771f4ade..4c3d5acbabd0 100644 --- a/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md +++ b/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md @@ -46,7 +46,7 @@ For more information, see "[Cloning a repository from {% data variables.product. An empty repository contains no files. It's often made if you don't initialize the repository with a README when creating it. {% data reusables.repositories.navigate-to-repo %} -2. To clone your repository using the command line using HTTPS, under "Quick setup", click {% octicon "clippy" aria-label="The clipboard icon" %}. To clone the repository using an SSH key{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, including a certificate issued by your organization's SSH certificate authority,{% endif %} click **SSH**, then click {% octicon "clippy" aria-label="The clipboard icon" %}. ![Empty repository clone URL button](/assets/images/help/repository/empty-https-url-clone-button.png) +2. To clone your repository using the command line using HTTPS, under "Quick setup", click {% octicon "clippy" aria-label="The clipboard icon" %}. To clone the repository using an SSH key, including a certificate issued by your organization's SSH certificate authority, click **SSH**, then click {% octicon "clippy" aria-label="The clipboard icon" %}. ![Empty repository clone URL button](/assets/images/help/repository/empty-https-url-clone-button.png) Alternatively, to clone your repository in Desktop, click {% octicon "desktop-download" aria-label="The desktop download button" %} **Set up in Desktop** and follow the prompts to complete the clone. ![Empty repository clone desktop button](/assets/images/help/repository/empty-desktop-clone-button.png) @@ -55,7 +55,6 @@ An empty repository contains no files. It's often made if you don't initialize t {% data reusables.command_line.git-clone-url %} {% data reusables.command_line.local-clone-created %} - ### Troubleshooting cloning errors When cloning a repository it's possible that you might encounter some errors. @@ -66,7 +65,6 @@ If you're unable to clone a repository, check that: - You have permission to access the repository you want to clone. For more information, see "[Error: Repository not found](/github/creating-cloning-and-archiving-repositories/error-repository-not-found)." - The default branch you want to clone still exists. For more information, see have permission to access the repository you want to clone. For more information, see "[Error: Remote HEAD refers to nonexistent ref, unable to checkout](/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout)." - {% if currentVersion == "free-pro-team@latest" %} ### 더 읽을거리 diff --git a/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md b/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md index 1d902d3929f6..079b5ee28073 100644 --- a/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md +++ b/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md @@ -28,13 +28,13 @@ versions: {% endtip %} {% endif %} -{% data reusables.repositories.create_new %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} +{% data reusables.repositories.create_new %} 2. Optionally, to create a repository with the directory structure and files of an existing repository, use the **Choose a template** drop-down and select a template repository. You'll see template repositories that are owned by you and organizations you're a member of or that you've used before. For more information, see "[Creating a repository from a template](/articles/creating-a-repository-from-a-template)." ![Template drop-down menu](/assets/images/help/repository/template-drop-down.png){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -3. Optionally, if you chose to use a template, to include the directory structure and files from all branches in the template, and not just the default branch, select **Include all branches**. ![Include all branches checkbox](/assets/images/help/repository/include-all-branches.png){% endif %}{% endif %} +3. Optionally, if you chose to use a template, to include the directory structure and files from all branches in the template, and not just the default branch, select **Include all branches**. ![Include all branches checkbox](/assets/images/help/repository/include-all-branches.png){% endif %} 3. In the Owner drop-down, select the account you wish to create the repository on. ![Owner drop-down menu](/assets/images/help/repository/create-repository-owner.png) {% data reusables.repositories.repo-name %} {% data reusables.repositories.choose-repo-visibility %} -6. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}If you're not using a template, t{% else %}T{% endif %}here are a number of optional items you can pre-populate your repository with. If you're importing an existing repository to {% data variables.product.product_name %}, don't choose any of these options, as you may introduce a merge conflict. You can {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.15" %}add or create new files using the user interface or {% endif %}choose to add new files using the command line later. For more information, see "[Importing a Git repository using the command line](/articles/importing-a-git-repository-using-the-command-line/)," "[Adding a file to a repository using the command line](/articles/adding-a-file-to-a-repository-using-the-command-line)," and "[Addressing merge conflicts](/articles/addressing-merge-conflicts/)." +6. If you're not using a template, there are a number of optional items you can pre-populate your repository with. If you're importing an existing repository to {% data variables.product.product_name %}, don't choose any of these options, as you may introduce a merge conflict. You can add or create new files using the user interface or choose to add new files using the command line later. For more information, see "[Importing a Git repository using the command line](/articles/importing-a-git-repository-using-the-command-line/)," "[Adding a file to a repository using the command line](/articles/adding-a-file-to-a-repository-using-the-command-line)," and "[Addressing merge conflicts](/articles/addressing-merge-conflicts/)." - You can create a README, which is a document describing your project. For more information, see "[About READMEs](/articles/about-readmes/)." - You can create a *.gitignore* file, which is a set of ignore rules. For more information, see "[Ignoring files](/articles/ignoring-files)."{% if currentVersion == "free-pro-team@latest" %} - You can choose to add a software license for your project. For more information, see "[Licensing a repository](/articles/licensing-a-repository)."{% endif %} @@ -48,5 +48,4 @@ versions: - "[Managing access to your organization's repositories](/articles/managing-access-to-your-organization-s-repositories)" - [Open Source Guides](https://opensource.guide/){% if currentVersion == "free-pro-team@latest" %} -- [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}){% endif %}{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.16" %} -- "[Initializing an empty repository with a README](/articles/initializing-an-empty-repository-with-a-readme)"{% endif %} +- [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}){% endif %} diff --git a/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md b/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md index 15e38f1c7c11..181785132e91 100644 --- a/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md +++ b/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md @@ -5,7 +5,7 @@ redirect_from: - /articles/creating-a-repository-from-a-template versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- ### About repository templates diff --git a/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md b/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md index 7ed533a94205..fdf937803523 100644 --- a/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md +++ b/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md @@ -5,7 +5,7 @@ redirect_from: - /articles/creating-a-template-repository versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- Anyone with admin permissions to a repository can make the repository a template. diff --git a/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md b/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md index 880f6c7ef2bf..78fec046ab96 100644 --- a/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md +++ b/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md @@ -22,7 +22,7 @@ $ git clone https://{% data variables.command_line.codeblock %}/user/ warning: remote HEAD refers to nonexistent ref, unable to checkout. ``` -To fix the error, you'll need to be an administrator of the repository on {% data variables.product.product_location %}. You'll want to [change the default branch](/articles/setting-the-default-branch) of the repository. +To fix the error, you'll need to be an administrator of the repository on {% data variables.product.product_location %}. You'll want to [change the default branch](/github/administering-a-repository/changing-the-default-branch) of the repository. After that, you can get a list of all the available branches from the command line: @@ -31,14 +31,14 @@ $ git branch -a # Lists ALL the branches > remotes/origin/awesome > remotes/origin/more-work -> remotes/origin/new-master +> remotes/origin/new-main ``` Then, you can just switch to your new branch: ```shell -$ git checkout new-master +$ git checkout new-main # Create and checkout a tracking branch -> Branch new-master set up to track remote branch new-master from origin. -> Switched to a new branch 'new-master' +> Branch new-main set up to track remote branch new-main from origin. +> Switched to a new branch 'new-main' ``` diff --git a/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md b/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md index 522960be21c1..361c9b9159ef 100644 --- a/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md +++ b/translations/ko-KR/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md @@ -49,6 +49,7 @@ You can filter repositories based on their license or license family using the ` | | Do What The F*ck You Want To Public License | `wtfpl` | | | Educational Community License v2.0 | `ecl-2.0` | | | Eclipse Public License 1.0 | `epl-1.0` | +| | Eclipse Public License 2.0 | `epl-2.0` | | | European Union Public License 1.1 | `eupl-1.1` | | | GNU Affero General Public License v3.0 | `agpl-3.0` | | | GNU General Public License family | `gpl` | diff --git a/translations/ko-KR/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md b/translations/ko-KR/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md new file mode 100644 index 000000000000..0871503bf376 --- /dev/null +++ b/translations/ko-KR/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md @@ -0,0 +1,27 @@ +--- +title: About billing for Codespaces +intro: 'When {% data variables.product.prodname_codespaces %} becomes generally available, you will be billed for storage and compute usage.' +product: '{% data reusables.gated-features.codespaces %}' +versions: + free-pro-team: '*' +--- + +{% data reusables.codespaces.release-stage %} + +{% data reusables.codespaces.about-billing-for-codespaces %} + +Compute costs are incurred only when a codespace is active. When you're using a codespace, the codespace is active. After 30 minutes of inactivity, a codespace becomes suspended automatically. + +Compute usage is billed per hour, at a rate that depends on your codespace's instance type. During the beta, {% data variables.product.prodname_codespaces %} offers a single, Linux instance type. At general availability, we'll support three Linux instance types. + +| Instance Type (Linux) | Per-hour rate | +| --------------------------------------- | ------------- | +| Basic (2 cores, 4GB RAM, 32 GB SSD) | $0.085 | +| Standard (4 cores, 8 GB RAM, 32 GB SSD) | $0.169 | +| Premium (8 cores, 16 GB RAM, 32 GB SSD) | $0.339 | + +Compute pricing may vary for additional instance types and operating systems supported in the future. + +Each codespace also incurs monthly storage costs until you delete the codespace. Storage costs for all instance types are $0.10/GB-month. + +We'll share more information about any compute and storage usage included in each plan at general availability. diff --git a/translations/ko-KR/content/github/developing-online-with-codespaces/about-codespaces.md b/translations/ko-KR/content/github/developing-online-with-codespaces/about-codespaces.md index a07a449044ca..6c0e0d29f123 100644 --- a/translations/ko-KR/content/github/developing-online-with-codespaces/about-codespaces.md +++ b/translations/ko-KR/content/github/developing-online-with-codespaces/about-codespaces.md @@ -44,7 +44,7 @@ Each developer can create one or more codespace for any public repository, or fo ### About billing for {% data variables.product.prodname_codespaces %} -During the limited public beta, {% data variables.product.prodname_codespaces %} is free to use and users are limited to 2 codespaces. Plans and pricing will be announced prior to general availability. +{% data reusables.codespaces.about-billing-for-codespaces %} For more information, see "[About billing for {% data variables.product.prodname_codespaces %}](/github/developing-online-with-codespaces/about-billing-for-codespaces)." ### Joining the beta diff --git a/translations/ko-KR/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md b/translations/ko-KR/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md index 11cea58326ba..9b692c800fb6 100644 --- a/translations/ko-KR/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md +++ b/translations/ko-KR/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md @@ -21,7 +21,9 @@ If you don't define a configuration in your repository, {% data variables.produc You can create a default codespace configuration using a pre-built container configuration for your project type, or you can create a custom configuration specific to your project's needs. -{% data variables.product.prodname_codespaces %} uses settings contained in a file named `devcontainer.json` in the root of the repository or in a `.devcontainer` folder. You can use `devcontainer.json` to set default settings for the entire codespace environment, including the {% data variables.product.prodname_vscode %} editor, but you can also set editor-specific settings in a file named `.vscode/settings.json`. +{% data variables.product.prodname_codespaces %} uses settings contained in a configuration file named `devcontainer.json`. {% data reusables.codespaces.devcontainer-location %} + +You can use your `devcontainer.json` to set default settings for the entire codespace environment, including the {% data variables.product.prodname_vscode %} editor, but you can also set editor-specific settings in a file named `.vscode/settings.json`. Changes to a repository's codespace configuration apply only to every new codespace and do not affect any existing codespace. @@ -38,7 +40,9 @@ Each new codespace created from a branch which contains the `.devcontainer` fold ### Creating a custom codespace configuration -If none of the pre-built configurations meet your needs, you can create a custom configuration by adding a `devcontainer.json` file to the root of your repository or a `.devcontainer` folder. In the file, you can use supported configuration keys to specify aspects of the codespace's environment, like which {% data variables.product.prodname_vscode %} extensions will be installed. +If none of the pre-built configurations meet your needs, you can create a custom configuration by adding a `devcontainer.json` file. {% data reusables.codespaces.devcontainer-location %} + +In the file, you can use supported configuration keys to specify aspects of the codespace's environment, like which {% data variables.product.prodname_vscode %} extensions will be installed. {% data reusables.codespaces.vscode-settings-order %} diff --git a/translations/ko-KR/content/github/developing-online-with-codespaces/index.md b/translations/ko-KR/content/github/developing-online-with-codespaces/index.md index 7e73016b558a..d53f3e92fbc8 100644 --- a/translations/ko-KR/content/github/developing-online-with-codespaces/index.md +++ b/translations/ko-KR/content/github/developing-online-with-codespaces/index.md @@ -14,10 +14,12 @@ versions: ### Table of Contents {% link_in_list /about-codespaces %} +{% link_in_list /about-billing-for-codespaces %} {% link_in_list /configuring-codespaces-for-your-project %} {% link_in_list /creating-a-codespace %} {% link_in_list /developing-in-a-codespace %} {% link_in_list /personalizing-codespaces-for-your-account %} {% link_in_list /deleting-a-codespace %} {% link_in_list /troubleshooting-your-codespace %} -{% link_in_list /connecting-to-your-codespace-from-visual-studio-code %} +{% link_in_list /using-codespaces-in-visual-studio-code %} +{% link_in_list /using-codespaces-in-visual-studio %} diff --git a/translations/ko-KR/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md b/translations/ko-KR/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md new file mode 100644 index 000000000000..5e5d0ddf422f --- /dev/null +++ b/translations/ko-KR/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md @@ -0,0 +1,45 @@ +--- +title: Using Codespaces in Visual Studio Code +intro: 'You can develop in your codespace directly in {% data variables.product.prodname_vscode %} by connecting the {% data variables.product.prodname_vs_codespaces %} extension with your account on {% data variables.product.product_name %}.' +product: '{% data reusables.gated-features.codespaces %}' +redirect_from: + - /github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code +versions: + free-pro-team: '*' +--- + +{% data reusables.codespaces.release-stage %} + +### 빌드전 요구 사양 + +Before you can develop in a codespace directly in {% data variables.product.prodname_vscode %}, you must configure the {% data variables.product.prodname_vs_codespaces %} extension to connect to your {% data variables.product.product_name %} account. + +1. Use the {% data variables.product.prodname_vs %} Marketplace to install the [{% data variables.product.prodname_vs_codespaces %}](https://marketplace.visualstudio.com/items?itemName=ms-vsonline.vsonline) extension. For more information, see [Extension Marketplace](https://code.visualstudio.com/docs/editor/extension-gallery) in the {% data variables.product.prodname_vscode %} documentation. +2. In {% data variables.product.prodname_vscode %}, in the left sidebar, click the Extensions icon. ![The Extensions icon in {% data variables.product.prodname_vscode %}](/assets/images/help/codespaces/click-extensions-icon-vscode.png) +3. Below {% data variables.product.prodname_vs_codespaces %}, click the Manage icon, then click **Extension Settings**. ![The Extension Settings option](/assets/images/help/codespaces/select-extension-settings.png) +4. Use the Codespaces: Account Provider drop-down menu, and click **{% data variables.product.prodname_dotcom %}**. ![Setting the Account Provider to {% data variables.product.prodname_dotcom %}](/assets/images/help/codespaces/select-account-provider-vscode.png) +{% data reusables.codespaces.click-remote-explorer-icon-vscode %} +6. If {% data variables.product.prodname_codespaces %} is not already selected in the header, click **{% data variables.product.prodname_codespaces %}**. ![The {% data variables.product.prodname_codespaces %} header](/assets/images/help/codespaces/codespaces-header-vscode.png) +7. Click **Sign in to view {% data variables.product.prodname_codespaces %}...**. ![Signing in to view {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/sign-in-to-view-codespaces-vscode.png) +8. To authorize {% data variables.product.prodname_vscode %} to access your account on {% data variables.product.product_name %}, click **Allow**. +9. Sign in to {% data variables.product.product_name %} to approve the extension. + +### Creating a codespace in {% data variables.product.prodname_vscode %} + +After you connect your {% data variables.product.product_name %} account to the {% data variables.product.prodname_vs_codespaces %} extension, you can develop in a codespace that you created on {% data variables.product.product_name %} or in {% data variables.product.prodname_vscode %}. + +{% data reusables.codespaces.click-remote-explorer-icon-vscode %} +2. Click the Add icon, then click **Create New Codespace**. ![The Create new Codespace option in {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/create-codespace-vscode.png) +3. Type, then click the repository's name you want to develop in. ![Searching for repository to create a new {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/choose-repository-vscode.png) +4. Click the branch you want to develop in. ![Searching for a branch to create a new {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/choose-branch-vscode.png) + +### Opening a codespace in {% data variables.product.prodname_vscode %} + +{% data reusables.codespaces.click-remote-explorer-icon-vscode %} +2. Under Codespaces, click the codespace you want to develop in. +3. Click the Connect to Codespace icon. ![The Connect to Codespace icon in {% data variables.product.prodname_vscode %}](/assets/images/help/codespaces/click-connect-to-codespace-icon-vscode.png) + +### Deleting a codespace in {% data variables.product.prodname_vscode %} + +1. Under Codespaces, right-click the codespace you want to delete. +2. In the drop-down menu, click **Delete Codespace**. ![Deleting a codespace in {% data variables.product.prodname_dotcom %}](/assets/images/help/codespaces/delete-codespace-vscode.png) diff --git a/translations/ko-KR/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md b/translations/ko-KR/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md new file mode 100644 index 000000000000..9837bc2a7aea --- /dev/null +++ b/translations/ko-KR/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md @@ -0,0 +1,53 @@ +--- +title: Using Codespaces in Visual Studio +intro: 'You can develop in your codespace directly in {% data variables.product.prodname_vs %} by connecting with your account on {% data variables.product.product_name %}.' +product: '{% data reusables.gated-features.codespaces %}' +versions: + free-pro-team: '*' +--- + +{% note %} + +**Note:** {% data variables.product.prodname_codespaces %} is currently in limited public beta and subject to change. During the beta period, {% data variables.product.prodname_dotcom %} does not make any guarantees about the availability of {% data variables.product.prodname_codespaces %}. [Sign up for the limited public beta](https://github.com/features/codespaces/signup-vs). For more information about joining the beta, see "[About {% data variables.product.prodname_codespaces %}](/github/developing-online-with-codespaces/about-codespaces#joining-the-beta)." + +{% endnote %} + +### About Codespaces in {% data variables.product.prodname_vs %} + +You can create a codespace in {% data variables.product.prodname_vs %} to develop applications in a Windows environment. When you use a codespace in {% data variables.product.prodname_vs %}, you can browse source code, build solutions, and commit changes to your repository. + +You must create a codespace in {% data variables.product.prodname_vs %} to use it with the application. Codespaces created outside of {% data variables.product.prodname_vs %} can not currently be used with {% data variables.product.prodname_vs %}. + +### 빌드전 요구 사양 + +Before you configure a codespace in {% data variables.product.prodname_vs %}, you must download the latest version of [{% data variables.product.prodname_vs %} Preview](https://aka.ms/vspreview). + +#### Enabling the connection between {% data variables.product.prodname_vs %} and {% data variables.product.prodname_github_codespaces %} + +Connecting to {% data variables.product.prodname_github_codespaces %} with the {% data variables.product.prodname_vs %} Preview is not enabled by default, so you will first need to enable the Preview Features option. + +1. In {% data variables.product.prodname_vs %} Preview, use the Tools drop-down menu, then click **Options**. +2. Under **Environment**, select **Preview Features** and check the **Connect to {% data variables.product.prodname_github_codespaces %}** preview feature. ![Check the Connect to {% data variables.product.prodname_github_codespaces %} preview feature](/assets/images/help/codespaces/connect-to-github-codespaces-preview-feature.png) +3. You will need to restart {% data variables.product.prodname_vs %} for the feature to be available. + +### Creating a codespace in {% data variables.product.prodname_vs %} + +1. When you launch {% data variables.product.prodname_vs %}, the Start Window will show a **Connect to a codespace** button under "Get started". ![Visual Studio Start window with Connect to a codespace](/assets/images/help/codespaces/visual-studio-start-window.png) +2. Click **Connect to a codespace**. +3. Click **Sign in to {% data variables.product.prodname_dotcom %}** and follow the prompts, or click **Create one!** to create a new {% data variables.product.prodname_dotcom %} account and sign into the account. ![Visual Studio sign in to {% data variables.product.prodname_dotcom %}](/assets/images/help/codespaces/visual-studio-sign-in-to-github.png) +4. Under "Codespace details", type the repository's URL you want {% data variables.product.prodname_github_codespaces %} to clone into your codespace. +5. Optionally, use the Instance type and Suspend after drop-down menus to configure more codespace details. ![Visual Studio codespace details](/assets/images/help/codespaces/visual-studio-codespace-details.png) +6. Click **Create and Connect**. {% data variables.product.prodname_github_codespaces %} will begin preparing the codespace and open {% data variables.product.prodname_vs %} after the codespace is ready. The codespace name will appear in the remote indicator in the menu. ![Visual Studio connected to eShopOnWeb repository codespace](/assets/images/help/codespaces/visual-studio-eshoponweb-codespace.png) + +### Opening a codespace in {% data variables.product.prodname_vs %} + +1. Use the File drop-down menu, and click **Connect to a Codespace**. ![Visual Studio File Connect to a codespace menu item](/assets/images/help/codespaces/visual-studio-file-connect-to-codespace.png) +2. Under "{% data variables.product.prodname_github_codespaces %}", click the codespace you want to connect to, then click **Connect**. ![Visual Studio displaying available codespaces and details](/assets/images/help/codespaces/visual-studio-connect-codespace.png) + +### Configuring a codespace for {% data variables.product.prodname_vs %} + +The default codespace environment created by {% data variables.product.prodname_vs %} includes popular frameworks and tools such as .NET Core, Microsoft SQL Server, Python, and the Windows SDK. {% data variables.product.prodname_github_codespaces %} created with {% data variables.product.prodname_vs %} can be customized through a subset of `devcontainers.json` properties and a new tool called devinit, included with {% data variables.product.prodname_vs %}. + +#### devinit + +The [devinit](https://docs.microsoft.com/visualstudio/devinit/getting-started-with-devinit) command-line tool lets you install additional frameworks and tools into your Windows development codespaces, as well as run PowerShell scripts or modify environment variables. devinit supports a configuration file called [devinit.json](https://docs.microsoft.com/visualstudio/devinit/devinit-json), which can be added to your project for creating customized and repeatable development environments. For more information about Windows codespace configuration and devinit, see [Customize a codespace](https://docs.microsoft.com/visualstudio/ide/codespaces/customize-codespaces) in the {% data variables.product.prodname_vs %} documentation. diff --git a/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md index c4cd277641b2..cc0e24656581 100644 --- a/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md +++ b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md @@ -18,7 +18,7 @@ versions: You can use {% data variables.product.prodname_code_scanning %} to find, triage, and prioritize fixes for existing problems in your code. {% data variables.product.prodname_code_scanning_capc %} also prevents developers from introducing new problems. You can schedule scans for specific days and times, or trigger scans when a specific event occurs in the repository, such as a push. -If {% data variables.product.prodname_code_scanning %} finds a potential vulnerability or error in your code, {% data variables.product.prodname_dotcom %} displays an alert in the repository. After you fix the code that triggered the alert, {% data variables.product.prodname_dotcom %} closes the alert. For more information, see "[Managing alerts from {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." +If {% data variables.product.prodname_code_scanning %} finds a potential vulnerability or error in your code, {% data variables.product.prodname_dotcom %} displays an alert in the repository. After you fix the code that triggered the alert, {% data variables.product.prodname_dotcom %} closes the alert. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." To monitor results from {% data variables.product.prodname_code_scanning %} across your repositories or your organization, you can use the {% data variables.product.prodname_code_scanning %} API. For more information about API endpoints, see "[{% data variables.product.prodname_code_scanning_capc %}](/v3/code-scanning)." diff --git a/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md index 8d1a5ef1467c..65a9359fb4e4 100644 --- a/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md +++ b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md @@ -1,7 +1,7 @@ --- title: About integration with code scanning shortTitle: About integration -intro: 'You can perform {% data variables.product.prodname_code_scanning %} externally and then display the results in {% data variables.product.prodname_dotcom %}.' +intro: 'You can perform {% data variables.product.prodname_code_scanning %} externally and then display the results in {% data variables.product.prodname_dotcom %}, or set up webhooks that listen to {% data variables.product.prodname_code_scanning %} activity in your repository.' product: '{% data reusables.gated-features.code-scanning %}' versions: free-pro-team: '*' @@ -11,12 +11,14 @@ versions: {% data reusables.code-scanning.beta %} {% data reusables.code-scanning.enterprise-enable-code-scanning %} -As an alternative to running {% data variables.product.prodname_code_scanning %} within {% data variables.product.prodname_dotcom %}, you can perform analysis elsewhere and then upload the results. Alerts for {% data variables.product.prodname_code_scanning %} that you run externally are displayed in the same way as those for {% data variables.product.prodname_code_scanning %} that you run within {% data variables.product.prodname_dotcom %}. For more information, see "[Managing alerts from code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." - -You can use your continuous integration or continuous delivery/deployment (CI/CD) system to run {% data variables.product.prodname_dotcom %}'s {% data variables.product.prodname_codeql %} analysis and upload the results to {% data variables.product.prodname_dotcom %}. This is an alternative to using {% data variables.product.prodname_actions %} to run {% data variables.product.prodname_codeql %} analysis. For more information, see "[Running code scanning in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)." +As an alternative to running {% data variables.product.prodname_code_scanning %} within {% data variables.product.prodname_dotcom %}, you can perform analysis elsewhere and then upload the results. Alerts for {% data variables.product.prodname_code_scanning %} that you run externally are displayed in the same way as those for {% data variables.product.prodname_code_scanning %} that you run within {% data variables.product.prodname_dotcom %}. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." If you use a third-party static analysis tool that can produce results as Static Analysis Results Interchange Format (SARIF) 2.1.0 data, you can upload this to {% data variables.product.prodname_dotcom %}. For more information, see "[Uploading a SARIF file to GitHub](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)." +### Integrations with webhooks + +You can use {% data variables.product.prodname_code_scanning %} webhooks to build or set up integrations, such as [{% data variables.product.prodname_github_app %}s](/apps/building-github-apps/) or [{% data variables.product.prodname_oauth_app %}s](/apps/building-oauth-apps/), that subscribe to {% data variables.product.prodname_code_scanning %} events in your repository. For example, you could build an integration that creates an issue on {% data variables.product.product_location %} or sends you a Slack notification when a new {% data variables.product.prodname_code_scanning %} alert is added in your repository. For more information, see "[Creating webhooks](/developers/webhooks-and-events/creating-webhooks)" and "[Webhook events and payloads](/developers/webhooks-and-events/webhook-events-and-payloads#code_scanning_alert)." + ### 더 읽을거리 * "[About code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)" diff --git a/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md index 7793de95ddd7..2f126e4f1c23 100644 --- a/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md +++ b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md @@ -3,6 +3,7 @@ title: Automatically scanning your code for vulnerabilities and errors shortTitle: Scanning automatically intro: 'You can find vulnerabilities and errors in your project''s code on {% data variables.product.prodname_dotcom %}, as well as view, triage, understand, and resolve the related {% data variables.product.prodname_code_scanning %} alerts.' mapTopic: true +product: '{% data reusables.gated-features.code-scanning %}' versions: free-pro-team: '*' enterprise-server: '>=2.22' diff --git a/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md index 7195b40ce423..f9ed946bfb24 100644 --- a/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md +++ b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md @@ -12,12 +12,11 @@ versions: {% data reusables.code-scanning.beta %} {% data reusables.code-scanning.enterprise-enable-code-scanning-actions %} - ### About {% data variables.product.prodname_code_scanning %} configuration -You can run {% data variables.product.prodname_code_scanning %} within {% data variables.product.product_location %}, using {% data variables.product.prodname_actions %}, or from your continuous integration (CI) system, using the {% data variables.product.prodname_codeql_runner %}. For more information about {% data variables.product.prodname_actions %}, see "[About {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)." For more information about the {% data variables.product.prodname_codeql_runner %}, see "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)." +You can run {% data variables.product.prodname_code_scanning %} within {% data variables.product.product_location %}, using {% data variables.product.prodname_actions %}, or from your continuous integration (CI) system, using the {% data variables.product.prodname_codeql_runner %}. For more information about {% data variables.product.prodname_actions %}, see "[About {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)." For more information about the {% data variables.product.prodname_codeql_runner %}, see "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)." -This article relates to running {% data variables.product.prodname_code_scanning %} within {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_ghe_server %}{% else %}{% data variables.product.prodname_dotcom %}{% endif %}. +This article is about running {% data variables.product.prodname_code_scanning %} within {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_ghe_server %}{% else %}{% data variables.product.prodname_dotcom %}{% endif %}. Before you can configure {% data variables.product.prodname_code_scanning %} for a repository, you must enable {% data variables.product.prodname_code_scanning %} by adding a {% data variables.product.prodname_actions %} workflow to the repository. For more information, see "[Enabling {% data variables.product.prodname_code_scanning %} for a repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository)." @@ -33,7 +32,7 @@ Before you can configure {% data variables.product.prodname_code_scanning %} for 1. In the upper right corner of the file view, to open the workflow editor, click {% octicon "pencil" aria-label="The edit icon" %}. ![Edit workflow file button](/assets/images/help/repository/code-scanning-edit-workflow-button.png) 1. After you have edited the file, click **Start commit** and complete the "Commit changes" form. You can choose to commit directly to the current branch, or create a new branch and start a pull request. ![Commit update to codeql.yml workflow](/assets/images/help/repository/code-scanning-workflow-update.png) -For more information about editing workflow files, see "[Configuring a workflow](/actions/configuring-and-managing-workflows/configuring-a-workflow)." +For more information about editing workflow files, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." ### Configuring frequency @@ -82,7 +81,9 @@ This workflow scans: ### Specifying an operating system -If your code requires a specific operating system to compile, you can configure the operating system in your {% data variables.product.prodname_codeql_workflow %}. Edit the value of `jobs..runs-on` to specify the operating system for the machine that runs your {% data variables.product.prodname_code_scanning %} actions. {% if currentVersion ver_gt "enterprise-server@2.21" %}You specify the operating system by using an appropriate label as the second element in a two-element array, after `self-hosted`. +If your code requires a specific operating system to compile, you can configure the operating system in your {% data variables.product.prodname_codeql_workflow %}. Edit the value of `jobs.analyze.runs-on` to specify the operating system for the machine that runs your {% data variables.product.prodname_code_scanning %} actions. {% if currentVersion ver_gt "enterprise-server@2.21" %}You specify the operating system by using an appropriate label as the second element in a two-element array, after `self-hosted`.{% else %} + +If you choose to use a self-hosted runner for code scanning, you can specify an operating system by using an appropriate label as the second element in a two-element array, after `self-hosted`.{% endif %} ``` yaml jobs: @@ -90,27 +91,89 @@ jobs: name: Analyze runs-on: [self-hosted, ubuntu-latest] ``` -{% endif %} + +{% if currentVersion == "free-pro-team@latest" %}For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners)" and "[Adding self-hosted runners](/actions/hosting-your-own-runners/adding-self-hosted-runners)."{% endif %} {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} supports the latest versions of Ubuntu, Windows, and macOS. Typical values for this setting are therefore: `ubuntu-latest`, `windows-latest`, and `macos-latest`. For more information, see {% if currentVersion ver_gt "enterprise-server@2.21" %}"[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#self-hosted-runners)" and "[Using labels with self-hosted runners](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners){% else %}"[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on){% endif %}." -### Overriding automatic language detection +{% if currentVersion ver_gt "enterprise-server@2.21" %}You must ensure that Git is in the PATH variable on your self-hosted runners.{% else %}If you use a self-hosted runner, you must ensure that Git is in the PATH variable.{% endif %} + +### Changing the languages that are analyzed -{% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} automatically detects and scans code written in the supported languages. +{% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} automatically detects code written in the supported languages. {% data reusables.code-scanning.supported-languages %} +The default {% data variables.product.prodname_codeql_workflow %} file contains a build matrix called `language` which lists the languages in your repository that are analyzed. {% data variables.product.prodname_codeql %} automatically populates this matrix when you add {% data variables.product.prodname_code_scanning %} to a repository. Using the `language` matrix optimizes {% data variables.product.prodname_codeql %} to run each analysis in parallel. We recommend that all workflows adopt this configuration due to the performance benefits of parallelizing builds. For more information about build matrices, see "[Managing complex workflows](/actions/learn-github-actions/managing-complex-workflows#using-a-build-matrix)." + {% data reusables.code-scanning.specify-language-to-analyze %} -To override automatic language detection, add `with: languages:` to the `init` action in your {% data variables.product.prodname_codeql_workflow %}. The keywords for the supported languages are `cpp`, `csharp`, `go`, `java`, `javascript`, and `python`. +If your workflow uses the `language` matrix then {% data variables.product.prodname_codeql %} is hardcoded to analyze only the languages in the matrix. To change the languages you want to analyze, edit the value of the matrix variable. You can remove a language to prevent it being analyzed or you can add a language that was not present in the repository when {% data variables.product.prodname_code_scanning %} was enabled. For example, if the repository initially only contained JavaScript when {% data variables.product.prodname_code_scanning %} was enabled, and you later added Python code, you will need to add `python` to the matrix. -For example, the following configuration limits {% data variables.product.prodname_code_scanning %} to C/C++, C#, and Python. +```yaml +jobs: + analyze: + name: Analyze + ... + strategy: + fail-fast: false + matrix: + language: ['javascript', 'python'] +``` -``` yaml +If your workflow does not contain a matrix called `language`, then {% data variables.product.prodname_codeql %} is configured to run analysis sequentially. If you don't specify languages in the workflow, {% data variables.product.prodname_codeql %} automatically detects, and attempts to analyze, any supported languages in the repository. If you want to choose which languages to analyze, without using a matrix, you can use the `languages` parameter under the `init` action. + +```yaml - uses: github/codeql-action/init@v1 with: languages: cpp, csharp, python ``` +{% if currentVersion == "free-pro-team@latest" %} +### Analyzing Python dependencies + +For GitHub-hosted runners that use Linux only, the {% data variables.product.prodname_codeql_workflow %} will try to auto-install Python dependencies to give more results for the CodeQL analysis. You can control this behavior by specifying the `setup-python-dependencies` parameter for the action called by the "Initialize CodeQL" step. By default, this parameter is set to `true`: + +- If the repository contains code written in Python, the "Initialize CodeQL" step installs the necessary dependencies on the GitHub-hosted runner. If the auto-install succeeds, the action also sets the environment variable `CODEQL_PYTHON` to the Python executable file that includes the dependencies. + +- If the repository doesn't have any Python dependencies, or the dependencies are specified in an unexpected way, you'll get a warning and the action will continue with the remaining jobs. The action can run successfully even when there are problems interpreting dependencies, but the results may be incomplete. + +Alternatively, you can install Python dependencies manually on any operating system. You will need to add `setup-python-dependencies` and set it to `false`, as well as set `CODEQL_PYTHON` to the Python executable that includes the dependencies, as shown in this workflow extract: + +```yaml +jobs: + CodeQL-Build: + + runs-on: ubuntu-latest + + steps: + - name: Checkout repository + uses: actions/checkout@v2 + with: + fetch-depth: 2 + - name: Set up Python + uses: actions/setup-python@v2 + with: + python-version: '3.x' + - name: Install dependencies + run: | + python -m pip install --upgrade pip + if [ -f requirements.txt ]; + then pip install -r requirements.txt; + fi + # Set the `CODEQL-PYTHON` environment variable to the Python executable + # that includes the dependencies + echo "::set-env name=CODEQL_PYTHON::$(which python)" + - run: git checkout HEAD^2 + if: ${{ github.event_name == 'pull_request' }} + - name: Initialize CodeQL + uses: github/codeql-action/init@v1 + with: + languages: python + # Override the default behavior so that the action doesn't attempt + # to auto-install Python dependencies + setup-python-dependencies: false +``` +{% endif %} ### Running additional queries @@ -121,7 +184,7 @@ To add one or more queries, add a `with: queries:` entry within the `uses: githu ``` yaml - uses: github/codeql-action/init@v1 with: - - queries: COMMA-SEPARATED LIST OF PATHS + queries: COMMA-SEPARATED LIST OF PATHS ``` You can also specify query suites in the value of `queries`. Query suites are collections of queries, usually grouped by purpose or language. @@ -135,8 +198,8 @@ In the following example, the `+` symbol ensures that the specified additional q ``` yaml - uses: github/codeql-action/init@v1 with: - - config-file: ./.github/codeql/codeql-config.yml - - queries: +security-and-quality,octo-org/python-qlpack/show_ifs.ql@main + config-file: ./.github/codeql/codeql-config.yml + queries: +security-and-quality,octo-org/python-qlpack/show_ifs.ql@main ``` ### Using a custom configuration file @@ -193,7 +256,7 @@ paths-ignore: {% endnote %} -For C/C++, C#, and Java, if you want to limit {% data variables.product.prodname_code_scanning %} to specific directories in your project, you must specify appropriate build steps in the workflow. The commands you need to use to exclude a directory from the build will depend on your build system. For more information, see "[Configuring the {% data variables.product.prodname_codeql %} action for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages#adding-build-steps-for-a-compiled-language)." +For C/C++, C#, and Java, if you want to limit {% data variables.product.prodname_code_scanning %} to specific directories in your project, you must specify appropriate build steps in the workflow. The commands you need to use to exclude a directory from the build will depend on your build system. For more information, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." You can quickly analyze small portions of a monorepo when you modify code in specific directories. You'll need to both exclude directories in your build steps and use the `paths-ignore` and `paths` keywords for [`on.`](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths) in your workflow. @@ -203,9 +266,9 @@ You can quickly analyze small portions of a monorepo when you modify code in spe ### Configuring {% data variables.product.prodname_code_scanning %} for compiled languages -{% data reusables.code-scanning.autobuild-compiled-languages %} +{% data reusables.code-scanning.autobuild-compiled-languages %} {% data reusables.code-scanning.analyze-go %} -{% data reusables.code-scanning.autobuild-add-build-steps %} For more information about how to configure {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} for compiled languages, see "[Configuring the {% data variables.product.prodname_codeql %} action for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages)." +{% data reusables.code-scanning.autobuild-add-build-steps %} For more information about how to configure {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} for compiled languages, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages)." ### Accessing private repositories diff --git a/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md new file mode 100644 index 000000000000..b16824a21d4a --- /dev/null +++ b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md @@ -0,0 +1,165 @@ +--- +title: Configuring CodeQL code scanning in your CI system +shortTitle: Configuring in your CI +intro: 'You can configure how the {% data variables.product.prodname_codeql_runner %} scans the code in your project and uploads the results to {% data variables.product.prodname_dotcom %}.' +product: '{% data reusables.gated-features.code-scanning %}' +miniTocMaxHeadingLevel: 4 +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-in-your-ci-system +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta-codeql-runner %} +{% data reusables.code-scanning.beta %} +{% data reusables.code-scanning.enterprise-enable-code-scanning %} + +### About configuring {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in your CI system + +To integrate {% data variables.product.prodname_code_scanning %} into your CI system, you can use the {% data variables.product.prodname_codeql_runner %}. For more information, see "[Running {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)." + +In general, you invoke the {% data variables.product.prodname_codeql_runner %} as follows. + +``` +$ /path/to-runner/codeql-runner-OS +``` + +`/path/to-runner/` depends on where you've downloaded the {% data variables.product.prodname_codeql_runner %} on your CI system. `codeql-runner-OS` depends on the operating system you use. There are three versions of the {% data variables.product.prodname_codeql_runner %}, `codeql-runner-linux`, `codeql-runner-macos`, and `codeql-runner-win`, for Linux, macOS, and Windows systems respectively. + +To customize the way the {% data variables.product.prodname_codeql_runner %} scans your code, you can use flags, such as `--languages` and `--queries`, or you can specify custom settings in a separate configuration file. + +### Overriding automatic language detection + +The {% data variables.product.prodname_codeql_runner %} automatically detects and scans code written in the supported languages. + +{% data reusables.code-scanning.supported-languages %} + +{% data reusables.code-scanning.specify-language-to-analyze %} + +To override automatic language detection, run the `init` command with the `--languages` flag, followed by a comma-separated list of language keywords. The keywords for the supported languages are `cpp`, `csharp`, `go`, `java`, `javascript`, and `python`. + +``` +$ /path/to-runner/codeql-runner-linux init --languages cpp,java +``` + +### Running additional queries + +{% data reusables.code-scanning.run-additional-queries %} + +{% data reusables.code-scanning.codeql-query-suites %} + +To add one or more queries, pass a comma-separated list of paths to the `--queries` flag of the `init` command. You can also specify additional queries in a configuration file. + +If you also are using a configuration file for custom settings, and you are also specifying additional queries with the `--queries` flag, the {% data variables.product.prodname_codeql_runner %} uses the additional queries specified with the `--queries` flag instead of any in the configuration file. If you want to run the combined set of additional queries specified with the flag and in the configuration file, prefix the value passed to `--queries` with the `+` symbol. For more information, see "[Using a custom configuration file](#using-a-custom-configuration-file)." + +In the following example, the `+` symbol ensures that the {% data variables.product.prodname_codeql_runner %} uses the additional queries together with any queries specified in the referenced configuration file. + +``` +$ /path/to-runner/codeql-runner-linux init --config-file .github/codeql/codeql-config.yml + --queries +security-and-quality,octo-org/python-qlpack/show_ifs.ql@main +``` + +### Using a custom configuration file + +Instead of passing additional information to the {% data variables.product.prodname_codeql_runner %} commands, you can specify custom settings in a separate configuration file. + +The configuration file is a YAML file. It uses syntax similar to the workflow syntax for {% data variables.product.prodname_actions %}, as illustrated in the examples below. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions)." + +Use the `--config-file` flag of the `init` command to specify the configuration file. The value of `--config-file` is the path to the configuration file that you want to use. This example loads the configuration file _.github/codeql/codeql-config.yml_. + +``` +$ /path/to-runner/codeql-runner-linux init --config-file .github/codeql/codeql-config.yml +``` + +#### Example configuration files + +{% data reusables.code-scanning.example-configuration-files %} + +### Configuring {% data variables.product.prodname_code_scanning %} for compiled languages + +For the compiled languages C/C++, C#, and Java, {% data variables.product.prodname_codeql %} builds the code before analyzing it. {% data reusables.code-scanning.analyze-go %} + +For many common build systems, the {% data variables.product.prodname_codeql_runner %} can build the code automatically. To attempt to build the code automatically, run `autobuild` between the `init` and `analyze` steps. Note that if your repository requires a specific version of a build tool, you may need to install the build tool manually first. + +The `autobuild` process only ever attempts to build _one_ compiled language for a repository. The language automatically selected for analysis is the language with the most files. If you want to choose a language explicitly, use the `--language` flag of the `autobuild` command. + +``` +$ /path/to-runner/codeql-runner-linux autobuild --language csharp +``` + +If the `autobuild` command can't build your code, you can run the build steps yourself, between the `init` and `analyze` steps. For more information, see "[Running {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system#compiled-language-example)." + +### Uploading {% data variables.product.prodname_code_scanning %} data to {% data variables.product.prodname_dotcom %} + +By default, the {% data variables.product.prodname_codeql_runner %} uploads results from {% data variables.product.prodname_code_scanning %} when you run the `analyze` command. You can also upload SARIF files separately, by using the `upload` command. + +Once you've uploaded the data, {% data variables.product.prodname_dotcom %} displays the alerts in your repository. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository#viewing-an-alert)." + +### {% data variables.product.prodname_codeql_runner %} command reference + +The {% data variables.product.prodname_codeql_runner %} supports the following commands and flags. + +#### `init` + +Initializes the {% data variables.product.prodname_codeql_runner %} and creates a {% data variables.product.prodname_codeql %} database for each language to be analyzed. + +| Flag | 필수 사항 | Input value | +| -------------------------------- |:-----:| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `--repository` | ✓ | Name of the repository to initialize. | +| `--github-url` | ✓ | URL of the {% data variables.product.prodname_dotcom %} instance where your repository is hosted. | +| `--github-auth` | ✓ | A {% data variables.product.prodname_github_apps %} token or personal access token. | +| `--languages` | | Comma-separated list of languages to analyze. By default, the {% data variables.product.prodname_codeql_runner %} detects and analyzes all supported languages in the repository. | +| `--queries` | | Comma-separated list of additional queries to run, in addition to the default suite of security queries. | +| `--config-file` | | Path to custom configuration file. | +| `--codeql-path` | | Path to a copy of the {% data variables.product.prodname_codeql %} CLI executable to use. By default, the {% data variables.product.prodname_codeql_runner %} downloads a copy. | +| `--temp-dir` | | Directory where temporary files are stored. The default is _./codeql-runner_. | +| `--tools-dir` | | Directory where {% data variables.product.prodname_codeql %} tools and other files are stored between runs. The default is a subdirectory of the home directory. | +| `--checkout-path` | | The path to the checkout of your repository. The default is the current working directory. | +| `--debug` | | None. Prints more verbose output. | +| `-h`, `--help` | | None. Displays help for the command. | + +#### `autobuild` + +Attempts to build the code for the compiled languages C/C++, C#, and Java. For those languages, {% data variables.product.prodname_codeql %} builds the code before analyzing it. Run `autobuild` between the `init` and `analyze` steps. + +| Flag | 필수 사항 | Input value | +| --------------------------- |:-----:| ---------------------------------------------------------------------------------------------------------------------------------------------- | +| `--language` | | The language to build. By default, the {% data variables.product.prodname_codeql_runner %} builds the compiled language with the most files. | +| `--temp-dir` | | Directory where temporary files are stored. The default is _./codeql-runner_. | +| `--debug` | | None. Prints more verbose output. | +| `-h`, `--help` | | None. Displays help for the command. | + +#### `analyze` + +Analyzes the code in the {% data variables.product.prodname_codeql %} databases and uploads results to {% data variables.product.product_location %}. + +| Flag | 필수 사항 | Input value | +| -------------------------------- |:-----:| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `--repository` | ✓ | Name of the repository to analyze. | +| `--commit` | ✓ | SHA of the commit to analyze. In Git and in Azure DevOps, this corresponds to the value of `git rev-parse HEAD`. In Jenkins, this corresponds to `$GIT_COMMIT`. | +| `--ref` | ✓ | Name of the reference to analyze, for example `refs/heads/main`. In Git and in Jenkins, this corresponds to the value of `git symbolic-ref HEAD`. In Azure DevOps, this corresponds to `$(Build.SourceBranch)`. | +| `--github-url` | ✓ | URL of the {% data variables.product.prodname_dotcom %} instance where your repository is hosted. | +| `--github-auth` | ✓ | A {% data variables.product.prodname_github_apps %} token or personal access token. | +| `--checkout-path` | | The path to the checkout of your repository. The default is the current working directory. | +| `--no-upload` | | None. Stops the {% data variables.product.prodname_codeql_runner %} from uploading the results to {% data variables.product.product_location %}. | +| `--output-dir` | | Directory where the output SARIF files are stored. The default is in the directory of temporary files. | +| `--temp-dir` | | Directory where temporary files are stored. The default is _./codeql-runner_. | +| `--debug` | | None. Prints more verbose output. | +| `-h`, `--help` | | None. Displays help for the command. | + +#### `업로드` + +Uploads SARIF files to {% data variables.product.product_location %}. + +| Flag | 필수 사항 | Input value | +| -------------------------------- |:-----:| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `--sarif-file` | ✓ | SARIF file to upload, or a directory containing multiple SARIF files. | +| `--repository` | ✓ | Name of the repository that was analyzed. | +| `--commit` | ✓ | SHA of the commit that was analyzed. In Git and in Azure DevOps, this corresponds to the value of `git rev-parse HEAD`. In Jenkins, this corresponds to `$GIT_COMMIT`. | +| `--ref` | ✓ | Name of the reference that was analyzed, for example `refs/heads/main`. In Git and in Jenkins, this corresponds to the value of `git symbolic-ref HEAD`. In Azure DevOps, this corresponds to `$(Build.SourceBranch)`. | +| `--github-url` | ✓ | URL of the {% data variables.product.prodname_dotcom %} instance where your repository is hosted. | +| `--github-auth` | ✓ | A {% data variables.product.prodname_github_apps %} token or personal access token. | +| `--checkout-path` | | The path to the checkout of your repository. The default is the current working directory. | +| `--debug` | | None. Prints more verbose output. | +| `-h`, `--help` | | None. Displays help for the command. | diff --git a/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md new file mode 100644 index 000000000000..14555c4fd26f --- /dev/null +++ b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md @@ -0,0 +1,116 @@ +--- +title: Configuring the CodeQL workflow for compiled languages +shortTitle: Configuring for compiled languages +intro: 'You can configure how {% data variables.product.prodname_dotcom %} uses the {% data variables.product.prodname_codeql_workflow %} to scan code written in compiled languages for vulnerabilities and errors.' +product: '{% data reusables.gated-features.code-scanning %}' +permissions: 'People with write permissions to a repository can configure {% data variables.product.prodname_code_scanning %} for the repository.' +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages + - /github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta %} +{% data reusables.code-scanning.enterprise-enable-code-scanning-actions %} + +### About the {% data variables.product.prodname_codeql_workflow %} and compiled languages + +You enable {% data variables.product.prodname_dotcom %} to run {% data variables.product.prodname_code_scanning %} for your repository by adding a {% data variables.product.prodname_actions %} workflow to the repository. For {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %}, you add the {% data variables.product.prodname_codeql_workflow %}. For more information, see "[Enabling {% data variables.product.prodname_code_scanning %} for a repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository)." + +{% data reusables.code-scanning.edit-workflow %} +For general information about configuring +{% data variables.product.prodname_code_scanning %} and editing workflow files, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" and "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." + +### About autobuild for {% data variables.product.prodname_codeql %} + +Code scanning works by running queries against one or more databases. Each database contains a representation of all of the code in a single language in your repository. For the compiled languages C/C++, C#, and Java, the process of populating this database involves building the code and extracting data. {% data reusables.code-scanning.analyze-go %} + +{% data reusables.code-scanning.autobuild-compiled-languages %} + +If your workflow uses a `language` matrix, `autobuild` attempts to build each of the compiled languages listed in the matrix. Without a matrix `autobuild` attempts to build the supported compiled language that has the most source files in the repository. With the exception of Go, analysis of other compiled languages in your repository will fail unless you supply explicit build commands. + +{% note %} + +**Note**: If you use self-hosted runners for {% data variables.product.prodname_actions %}, you may need to install additional software to use the `autobuild` process. Additionally, if your repository requires a specific version of a build tool, you may need to install it manually. For more information, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". + +{% endnote %} + +#### C/C++ + +| Supported system type | System name | +| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | +| Operating system | Windows, macOS, and Linux | +| Build system | Windows: MSbuild and build scripts
    Linux and macOS: Autoconf, Make, CMake, qmake, Meson, Waf, SCons, Linux Kbuild, and build scripts | + +The behavior of the `autobuild` step varies according to the operating system that the extraction runs on. On Windows, the `autobuild` step attempts to autodetect a suitable build method for C/C++ using the following approach: + +1. Invoke `MSBuild.exe` on the solution (`.sln`) or project (`.vcxproj`) file closest to the root. If `autobuild` detects multiple solution or project files at the same (shortest) depth from the top level directory, it will attempt to build all of them. +2. Invoke a script that looks like a build script—_build.bat_, _build.cmd_, _and build.exe_ (in that order). + +On Linux and macOS, the `autobuild` step reviews the files present in the repository to determine the build system used: + +1. Look for a build system in the root directory. +2. If none are found, search subdirectories for a unique directory with a build system for C/C++. +3. Run an appropriate command to configure the system. + +#### C + +| Supported system type | System name | +| --------------------- | ------------------------------------------ | +| Operating system | Windows and Linux | +| Build system | .NET and MSbuild, as well as build scripts | + +The `autobuild` process attempts to autodetect a suitable build method for C# using the following approach: + +1. Invoke `dotnet build` on the solution (`.sln`) or project (`.csproj`) file closest to the root. +2. Invoke `MSbuild` (Linux) or `MSBuild.exe` (Windows) on the solution or project file closest to the root. If `autobuild` detects multiple solution or project files at the same (shortest) depth from the top level directory, it will attempt to build all of them. +3. Invoke a script that looks like a build script—_build_ and _build.sh_ (in that order, for Linux) or _build.bat_, _build.cmd_, _and build.exe_ (in that order, for Windows). + +#### Java + +| Supported system type | System name | +| --------------------- | ------------------------------------------ | +| Operating system | Windows, macOS, and Linux (no restriction) | +| Build system | Gradle, Maven and Ant | + +The `autobuild` process tries to determine the build system for Java codebases by applying this strategy: + +1. Search for a build file in the root directory. Check for Gradle then Maven then Ant build files. +2. Run the first build file found. If both Gradle and Maven files are present, the Gradle file is used. +3. Otherwise, search for build files in direct subdirectories of the root directory. If only one subdirectory contains build files, run the first file identified in that subdirectory (using the same preference as for 1). If more than one subdirectory contains build files, report an error. + +### Adding build steps for a compiled language + +{% data reusables.code-scanning.autobuild-add-build-steps %} For information on how to edit the workflow file, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)." + +After removing the `autobuild` step, uncomment the `run` step and add build commands that are suitable for your repository. The workflow `run` step runs command-line programs using the operating system's shell. You can modify these commands and add more commands to customize the build process. + +``` yaml +- run: | + make bootstrap + make release +``` + +For more information about the `run` keyword, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)." + +If your repository contains multiple compiled languages, you can specify language-specific build commands. For example, if your repository contains C/C++, C# and Java, and `autobuild` correctly builds C/C++ and C# but fails to build Java, you could use the following configuration in your workflow, after the `init` step. This specifies build steps for Java while still using `autobuild` for C/C++ and C#: + +```yaml +- if: matrix.language == 'cpp' || matrix.language == 'csharp' + name: Autobuild + uses: github/codeql-action/autobuild@v1 + +- if: matrix.language == 'java' + name: Build Java + run: | + make bootstrap + make release +``` + +For more information about the `if` conditional, see "[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsif)." + +For more tips and tricks about why `autobuild` won't build your code, see "[Troubleshooting the {% data variables.product.prodname_codeql %} workflow](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow)." + +If you added manual build steps for compiled languages and {% data variables.product.prodname_code_scanning %} is still not working on your repository, contact {% data variables.contact.contact_support %}. diff --git a/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md index 91f721aa7520..d30c234f29d7 100644 --- a/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md +++ b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md @@ -27,19 +27,87 @@ You decide how you generate {% data variables.product.prodname_code_scanning %} {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-security %} -3. To the right of "Code scanning", click **Set up code scanning**. !["Set up code scanning" button to the right of "Code scanning" in the Security Overview](/assets/images/help/security/overview-set-up-code-scanning.png) -4. Under "Get started with code scanning", click **Set up this workflow** on the {% data variables.product.prodname_codeql_workflow %} or on a third-party workflow. !["Set up this workflow" button under "Get started with code scanning" heading](/assets/images/help/repository/code-scanning-set-up-this-workflow.png) -5. Optionally, to customize how {% data variables.product.prodname_code_scanning %} scans your code, edit the workflow. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." +3. To the right of "{% data variables.product.prodname_code_scanning_capc %}", click **Set up {% data variables.product.prodname_code_scanning %}**. !["Set up {% data variables.product.prodname_code_scanning %}" button to the right of "{% data variables.product.prodname_code_scanning_capc %}" in the Security Overview](/assets/images/help/security/overview-set-up-code-scanning.png) +4. Under "Get started with {% data variables.product.prodname_code_scanning %}", click **Set up this workflow** on the {% data variables.product.prodname_codeql_workflow %} or on a third-party workflow. !["Set up this workflow" button under "Get started with {% data variables.product.prodname_code_scanning %}" heading](/assets/images/help/repository/code-scanning-set-up-this-workflow.png) +5. To customize how {% data variables.product.prodname_code_scanning %} scans your code, edit the workflow. + + Generally you can commit the {% data variables.product.prodname_codeql_workflow %} without making any changes to it. However, many of the third-party workflows require additional configuration, so read the comments in the workflow before committing. + + For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." 6. Use the **Start commit** drop-down, and type a commit message. ![Start commit](/assets/images/help/repository/start-commit-commit-new-file.png) 7. Choose whether you'd like to commit directly to the default branch, or create a new branch and start a pull request. ![Choose where to commit](/assets/images/help/repository/start-commit-choose-where-to-commit.png) 8. Click **Commit new file** or **Propose new file**. -After you commit the workflow file or create a pull request, {% data variables.product.prodname_code_scanning %} will analyze your code according to the frequency you specified in your workflow file. If you created a pull request, {% data variables.product.prodname_code_scanning %} will only analyze the code on the pull request's topic branch until you merge the pull request into the default branch of the repository. +In the default {% data variables.product.prodname_codeql_workflow %}, {% data variables.product.prodname_code_scanning %} is configured to analyze your code each time you either push a change to the default branch or any protected branches, or raise a pull request against the default branch or any protected branches. As a result, {% data variables.product.prodname_code_scanning %} will now commence. + +### Viewing the logging output from {% data variables.product.prodname_code_scanning %} + +After enabling {% data variables.product.prodname_code_scanning %} for your repository, you can watch the output of the actions as they run. + +{% data reusables.repositories.actions-tab %} + + You'll see a list that includes an entry for running the {% data variables.product.prodname_code_scanning %} workflow. + + ![Actions list showing {% data variables.product.prodname_code_scanning %} workflow](/assets/images/help/repository/code-scanning-actions-list.png) + +1. Click the entry for the {% data variables.product.prodname_code_scanning %} workflow. + +1. Click the job name on the left. For example, **Analyze (LANGUAGE)**. + + ![Log output from the {% data variables.product.prodname_code_scanning %} workflow](/assets/images/help/repository/code-scanning-logging-analyze-action.png) + +1. Review the logging output from the actions in this workflow as they run. + +1. Once all jobs are complete, you can view the details of any {% data variables.product.prodname_code_scanning %} alerts that were identified. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository#viewing-an-alert)." + +{% note %} + +**Note:** If you raised a pull request to add the {% data variables.product.prodname_code_scanning %} workflow to the repository, alerts from that pull request aren't displayed directly on the {% data variables.product.prodname_code_scanning_capc %} page until the pull request is merged. If any alerts were found you can view these, before the pull request is merged, by clicking the **_n_ alerts found** link in the banner on the {% data variables.product.prodname_code_scanning_capc %} page. + + ![Click the "n alerts found" link](/assets/images/help/repository/code-scanning-alerts-found-link.png) + +{% endnote %} + +### Understanding the pull request checks + +Each {% data variables.product.prodname_code_scanning %} workflow you enable to run on pull requests always has at least two entries listed in the checks section of a pull request. There is one entry for each of the analysis jobs in the workflow, and a final one for the results of the analysis. + +The names of the {% data variables.product.prodname_code_scanning %} analysis checks take the form: "TOOL NAME / JOB NAME (TRIGGER)." For example, for {% data variables.product.prodname_codeql %}, analysis of C++ code has the entry "{% data variables.product.prodname_codeql %} / Analyze (cpp) (pull_request)." You can click **Details** on a {% data variables.product.prodname_code_scanning %} analysis entry to see logging data. This allows you to debug a problem if the analysis job failed. For example, for {% data variables.product.prodname_code_scanning %} analysis of compiled languages, this can happen if the action can't build the code. + + ![{% data variables.product.prodname_code_scanning %} pull request checks](/assets/images/help/repository/code-scanning-pr-checks.png) + +When the {% data variables.product.prodname_code_scanning %} jobs complete, {% data variables.product.prodname_dotcom %} works out whether any alerts were added by the pull request and adds the "{% data variables.product.prodname_code_scanning_capc %} results / TOOL NAME" entry to the list of checks. After {% data variables.product.prodname_code_scanning %} has been performed at least once, you can click **Details** to view the results of the analysis. If you used a pull request to add {% data variables.product.prodname_code_scanning %} to the repository, you will initially see a "Missing analysis" message when you click **Details** on the "{% data variables.product.prodname_code_scanning_capc %} results / TOOL NAME" check. + + ![Missing analysis for commit message](/assets/images/help/repository/code-scanning-missing-analysis.png) + +#### Reasons for the "missing analysis" message + +After {% data variables.product.prodname_code_scanning %} has analyzed the code in a pull request, it needs to compare the analysis of the topic branch (the branch you used to create the pull request) with the analysis of the base branch (the branch into which you want to merge the pull request). This allows {% data variables.product.prodname_code_scanning %} to compute which alerts are newly introduced by the pull request, which alerts were already present in the base branch, and whether any existing alerts are fixed by the changes in the pull request. Initially, if you use a pull request to add {% data variables.product.prodname_code_scanning %} to a repository, the base branch has not yet been analyzed, so it's not possible to compute these details. In this case, when you click through from the results check on the pull request you will see the "Missing analysis for base commit SHA-HASH" message. + +There are other situations where there may be no analysis for the latest commit to the base branch for a pull request. These include: + +* The pull request has been raised against a branch other than the default branch or a protected branch, and this branch hasn't been analyzed. + + To check whether a branch has been scanned, go to the {% data variables.product.prodname_code_scanning_capc %} page, click the **Branch** drop-down and select the relevant branch. + + ![Choose a branch from the Branch drop-down menu](/assets/images/help/repository/code-scanning-branch-dropdown.png) + + The solution in this situation is to add the name of the base branch to the `on:push` and `on:pull_request` specification in the {% data variables.product.prodname_code_scanning %} workflow on that branch and then make a change that updates the open pull request that you want to scan. + +* The latest commit on the base branch for the pull request is currently being analyzed and analysis is not yet available. + + Wait a few minutes and then push a change to the pull request to retrigger {% data variables.product.prodname_code_scanning %}. + +* An error occurred while analyzing the latest commit on the base branch and analysis for that commit isn't available. + + Merge a trivial change into the base branch to trigger {% data variables.product.prodname_code_scanning %} on this latest commit, then push a change to the pull request to retrigger {% data variables.product.prodname_code_scanning %}. ### 다음 단계 -After you enable {% data variables.product.prodname_code_scanning %}, you can monitor analysis, view results, and further customize how you scan your code. +After enabling {% data variables.product.prodname_code_scanning %}, and allowing its actions to complete, you can: -- You can view the run status of {% data variables.product.prodname_code_scanning %} and get notifications for completed runs. For more information, see "[Managing a workflow run](/actions/configuring-and-managing-workflows/managing-a-workflow-run)" and "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)." -- After a scan completes, you can view alerts from a completed scan. For more information, see "[Managing alerts from {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." -- You can customize how {% data variables.product.prodname_code_scanning %} scans the code in your repository. For more information, see "[Configuring code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." +- View all of the {% data variables.product.prodname_code_scanning %} alerts generated for this repository. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." +- View any alerts generated for a pull request submitted after you enabled {% data variables.product.prodname_code_scanning %}. For more information, see "[Triaging {% data variables.product.prodname_code_scanning %} alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests)." +- Set up notifications for completed runs. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)." +- Investigate any problems that occur with the initial setup of {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %}. For more information, see "[Troubleshooting the {% data variables.product.prodname_codeql %} workflow](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow)." +- Customize how {% data variables.product.prodname_code_scanning %} scans the code in your repository. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." diff --git a/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md index f782e1bee6b5..d6cf4c05968e 100644 --- a/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md +++ b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md @@ -1,5 +1,6 @@ --- title: Finding security vulnerabilities and errors in your code +product: '{% data reusables.gated-features.code-scanning %}' redirect_from: - /github/managing-security-vulnerabilities/finding-security-vulnerabilities-in-your-projects-code versions: @@ -11,14 +12,17 @@ versions: {% topic_link_in_list /automatically-scanning-your-code-for-vulnerabilities-and-errors %} {% link_in_list /about-code-scanning %} + {% link_in_list /triaging-code-scanning-alerts-in-pull-requests %} {% link_in_list /enabling-code-scanning-for-a-repository %} - {% link_in_list /managing-alerts-from-code-scanning %} + {% link_in_list /managing-code-scanning-alerts-for-your-repository %} {% link_in_list /configuring-code-scanning %} - {% link_in_list /configuring-the-codeql-action-for-compiled-languages %} - {% link_in_list /troubleshooting-code-scanning %} + {% link_in_list /configuring-the-codeql-workflow-for-compiled-languages %} + {% link_in_list /troubleshooting-the-codeql-workflow %} {% topic_link_in_list /integrating-with-code-scanning %} {% link_in_list /about-integration-with-code-scanning %} - {% link_in_list /running-code-scanning-in-your-ci-system %} - {% link_in_list /configuring-code-scanning-in-your-ci-system %} {% link_in_list /uploading-a-sarif-file-to-github %} {% link_in_list /sarif-support-for-code-scanning %} +{% link_in_list /running-code-scanning-in-your-ci-system %} + {% link_in_list /configuring-code-scanning-in-your-ci-system %} + {% link_in_list /configuring-the-codeql-action-for-compiled-languages %} + {% link_in_list /managing-alerts-from-code-scanning %} diff --git a/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md index 9caa80f45c73..01a082e5015f 100644 --- a/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md +++ b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md @@ -1,8 +1,9 @@ --- title: Integrating with code scanning shortTitle: Integration -intro: 'You can integrate {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} with your existing CI systems or upload results from other tools.' +intro: 'You can integrate third-party code analysis tools with {% data variables.product.prodname_dotcom %} {% data variables.product.prodname_code_scanning %} by uploading data as SARIF files.' mapTopic: true +product: '{% data reusables.gated-features.code-scanning %}' redirect_from: - /github/finding-security-vulnerabilities-and-errors-in-your-code/managing-results-from-code-scanning versions: diff --git a/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository.md b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository.md new file mode 100644 index 000000000000..87ca81fed562 --- /dev/null +++ b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository.md @@ -0,0 +1,63 @@ +--- +title: Managing code scanning alerts for your repository +shortTitle: Managing alerts +intro: 'You can view, fix, and close alerts for potential vulnerabilities or errors in your project''s code.' +product: '{% data reusables.gated-features.code-scanning %}' +permissions: 'People with write permission to a repository can manage {% data variables.product.prodname_code_scanning %} alerts for the repository.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +redirect_from: + - /github/managing-security-vulnerabilities/managing-alerts-from-automated-code-scanning + - /github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning +--- + +{% data reusables.code-scanning.beta %} + +### About alerts from {% data variables.product.prodname_code_scanning %} + +You can set up {% data variables.product.prodname_code_scanning %} to check the code in a repository using the default {% data variables.product.prodname_codeql %} analysis, a third-party analysis, or multiple types of analysis. When the analysis is complete, the resulting alerts are displayed alongside each other in the security view of the repository. Results from third-party tools or from custom queries may not include all of the properties that you see for alerts detected by {% data variables.product.company_short %}'s default {% data variables.product.prodname_codeql %} analysis. For more information, see "[Enabling {% data variables.product.prodname_code_scanning %} for a repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository)." + +By default, {% data variables.product.prodname_code_scanning %} analyzes your code periodically on the default branch and during pull requests. For information about managing alerts on a pull request, see "[Triaging {% data variables.product.prodname_code_scanning %} alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests)." + +### About alerts details + +Each alert highlights a problem with the code and the name of the tool that identified it. You can see the line of code that triggered the alert, as well as properties of the alert, such as the severity and the nature of the problem. Alerts also tell you when the issue was first introduced. For alerts identified by {% data variables.product.prodname_codeql %} analysis, you will also see information on how to fix the problem. + +![Example alert from {% data variables.product.prodname_code_scanning %}](/assets/images/help/repository/code-scanning-alert.png) + +If you enable {% data variables.product.prodname_code_scanning %} using {% data variables.product.prodname_codeql %}, this can also detect data-flow problems in your code. Data-flow analysis finds potential security issues in code, such as: using data insecurely, passing dangerous arguments to functions, and leaking sensitive information. + +When {% data variables.product.prodname_code_scanning %} reports data-flow alerts, {% data variables.product.prodname_dotcom %} shows you how data moves through the code. {% data variables.product.prodname_code_scanning_capc %} allows you to identify the areas of your code that leak sensitive information, and that could be the entry point for attacks by malicious users. + +### Viewing an alert + +Anyone with read permission for a repository can see {% data variables.product.prodname_code_scanning %} alerts on pull requests. However, you need write permission to view a summary of alerts for repository on the **Security** tab. By default, alerts are shown for the default branch. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-security %} +{% data reusables.repositories.sidebar-code-scanning-alerts %} +{% data reusables.code-scanning.click-alert-in-list %} +5. Optionally, if the alert highlights a problem with data flow, click **Show paths** to display the path from the data source to the sink where it's used. ![Example data-flow alert](/assets/images/help/repository/code-scanning-show-paths.png) + +### Fixing an alert + +Anyone with write permission for a repository can fix an alert by committing a correction to the code. If the repository has {% data variables.product.prodname_code_scanning %} scheduled to run on pull requests, it's best to raise a pull request with your correction. This will trigger {% data variables.product.prodname_code_scanning %} analysis of the changes and test that your fix doesn't introduce any new problems. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" and "[Triaging {% data variables.product.prodname_code_scanning %} alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests)." + +### Closing an alert + +Closing an alert is a way to resolve an alert that you don't think needs to be fixed. {% data reusables.code-scanning.close-alert-examples %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-security %} +{% data reusables.repositories.sidebar-code-scanning-alerts %} +{% data reusables.code-scanning.click-alert-in-list %} +5. Select the Close drop-down menu and click a reason for closing the alert. ![Choosing reason for closing the alert via the Close drop-down](/assets/images/help/repository/code-scanning-alert-close-drop-down.png) + +{% data reusables.code-scanning.false-positive-fix-codeql %} + +### 더 읽을거리 + +- "[Triaging {% data variables.product.prodname_code_scanning %} alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests)" +- "[Enabling {% data variables.product.prodname_code_scanning %} for a repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository)" +- "[About integration with {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning)" diff --git a/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md new file mode 100644 index 000000000000..ed70c40db43f --- /dev/null +++ b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md @@ -0,0 +1,162 @@ +--- +title: Running CodeQL code scanning in your CI system +shortTitle: Running in your CI +intro: 'You can use the {% data variables.product.prodname_codeql_runner %} to perform {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in a third-party continuous integration system.' +product: '{% data reusables.gated-features.code-scanning %}' +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta-codeql-runner %} +{% data reusables.code-scanning.beta %} +{% data reusables.code-scanning.enterprise-enable-code-scanning %} + +### Using {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} with your existing CI system + +If you use a continuous integration or continuous delivery/deployment (CI/CD) system other than {% data variables.product.prodname_actions %}, you can use your existing system to run {% data variables.product.prodname_dotcom %}'s {% data variables.product.prodname_codeql %} analysis and upload the results to {% data variables.product.prodname_dotcom %}. To do this, use the {% data variables.product.prodname_codeql_runner %}. + +### About the {% data variables.product.prodname_codeql_runner %} + +{% data reusables.code-scanning.about-code-scanning %} For information, see "[About {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)." + +You can use the {% data variables.product.prodname_codeql_runner %} to run {% data variables.product.prodname_code_scanning %} on code that you're processing in a third-party continuous integration (CI) system. Alternatively, you can use {% data variables.product.prodname_actions %} to run {% data variables.product.prodname_code_scanning %} on {% data variables.product.product_location %}. For information, see "[Enabling {% data variables.product.prodname_code_scanning %} for a repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository)." + +The {% data variables.product.prodname_codeql_runner %} is a command-line tool that runs {% data variables.product.prodname_codeql %} analysis on a checkout of a {% data variables.product.prodname_dotcom %} repository. You add the runner to your third-party system, then call the runner to analyze code and upload the results to {% data variables.product.product_location %}. These results are displayed as {% data variables.product.prodname_code_scanning %} alerts in the repository. + +{% data reusables.code-scanning.codeql-runner-license %} + +### Downloading the {% data variables.product.prodname_codeql_runner %} + +You can download the {% data variables.product.prodname_codeql_runner %} from https://github.com/github/codeql-action/releases. On some operating systems, you may need to change permissions for the downloaded file before you can run it. + +On Linux: + +```shell +chmod +x codeql-runner-linux +``` + +On MacOS: + +```shell +chmod +x codeql-runner-macos +sudo xattr -d com.apple.quarantine codeql-runner-macos +``` + +On Windows, the `codeql-runner-win.exe` file usually requires no change to permissions. + +### Adding the {% data variables.product.prodname_codeql_runner %} to your CI system + +Once you have downloaded the {% data variables.product.prodname_codeql_runner %} and verified that it can be executed, you should make the runner available to each CI server that you intend to use for {% data variables.product.prodname_code_scanning %}. It is important to notice that each CI server that you intend to use for {% data variables.product.prodname_code_scanning %} needs to have the {% data variables.product.prodname_codeql_runner %}. You might configure each server to copy the runner from a central, internal location, or you could use the REST API to get the runner direct from GitHub, for example: + +```shell +wget https://github.com/github/codeql-action/releases/download/codeql-bundle-20200826/codeql-runner-linux +chmod +x codeql-runner-linux +``` + +In addition to this, each CI server also needs: + +- A {% data variables.product.prodname_github_apps %} or personal access token for the {% data variables.product.prodname_codeql_runner %} to use. For private repositories the token must have the `repo` scope. For public the token needs only the `public_repo` and `repo:security_events` scopes. For information, see "[Building {% data variables.product.prodname_github_apps %}](/developers/apps/building-github-apps)" and "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token)." +- Access to the {% data variables.product.prodname_codeql %} bundle associated with this release of the {% data variables.product.prodname_codeql_runner %}. This package contains the {% data variables.product.prodname_codeql %} CLI, queries, and libraries needed for {% data variables.product.prodname_codeql %} analysis. For information, see "[{% data variables.product.prodname_codeql %} CLI](https://help.semmle.com/codeql/codeql-cli.html)." + +The options for providing access to the {% data variables.product.prodname_codeql %} bundle are: + +1. Allow the CI servers access to {% data variables.product.prodname_dotcom_the_website %} so that the {% data variables.product.prodname_codeql_runner %} can download the bundle automatically. +1. Manually download/extract the bundle, store it with other central resources, and use the `--codeql-path` flag to specify the location of the bundle in calls to initialize the +{% data variables.product.prodname_codeql_runner %}. +{% if currentVersion != "free-pro-team@latest" %} +1. You can mirror the `github/codeql-action` repository on {% data variables.product.product_location %}. Unless you specify the `--codeql-path` flag, the runner automatically checks for the bundle in this location and on {% data variables.product.prodname_dotcom_the_website %}.{% endif %} + +### Calling the {% data variables.product.prodname_codeql_runner %} + +You should call the {% data variables.product.prodname_codeql_runner %} from the checkout location of the repository you want to analyze. The two main commands are: + +1. `init` required to initialize the runner and create a {% data variables.product.prodname_codeql %} database for each language to be analyzed. These databases are populated and analyzed by subsequent commands. +1. `analyze` required to populate the {% data variables.product.prodname_codeql %} databases, analyze them, and upload results to {% data variables.product.product_location %}. + +For both commands, you must specify the URL of {% data variables.product.product_location %}, the repository *OWNER/NAME*, and the GitHub Apps or personal access token to use for authentication. You also need to specify the location of the CodeQL bundle unless the CI server has access to download it directly from the `github/codeql-action` repository on {% data variables.product.prodname_dotcom_the_website %}{% if currentVersion != "free-pro-team@latest" %} or mirrored on {% data variables.product.product_location %}{% endif %}. + +You can configure where the {% data variables.product.prodname_codeql_runner %} stores the CodeQL bundle for future analysis on a server using the `--tools-dir` flag and where it stores temporary files during analysis using `--temp-dir`. + +To view the command-line reference for the runner, use the `-h` flag. For example, to list all commands run: `codeql-runner-OS -h`, or to list all the flags available for the `init` command run: `codeql-runner-OS init -h` (where `OS` varies according to the executable that you are using). For more information, see "[Configuring {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system#codeql-runner-command-reference)." + +#### Basic example + +This example runs {% data variables.product.prodname_codeql %} analysis on a Linux CI server for the `octo-org/example-repo` repository hosted on `{% data variables.command_line.git_url_example %}`. The process is very simple because the repository contains only languages that can be analyzed by {% data variables.product.prodname_codeql %} directly, without being built (that is, Go, JavaScript, Python, and TypeScript). + +1. Check out the repository to analyze. +1. Move into the directory where the repository is checked out. +1. Initialize the {% data variables.product.prodname_codeql_runner %} and create {% data variables.product.prodname_codeql %} databases for the languages detected. + + ```shell + $ /path/to-runner/codeql-runner-linux init --repository octo-org/example-repo + --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN + > Cleaning temp directory /srv/checkout/example-repo/codeql-runner + > ... + > Created CodeQL database at /srv/checkout/example-repo/codeql-runner/codeql_databases/javascript. + ``` + +1. Populate the {% data variables.product.prodname_codeql_runner %} databases, analyze them, and upload the results to {% data variables.product.product_name %}. + + ```shell + $ /path/to-runner/codeql-runner-linux analyze --repository octo-org/example-repo + --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN + --commit 5b6a3078b31dc346e5ce7b86837d6abbe7a18bbd --ref refs/heads/main + > Finalizing database creation + > ... + > POST /repos/octo-org/example-repo/code-scanning/sarifs - 202 in 786ms + > Successfully uploaded results + ``` + +The server has access to download the {% data variables.product.prodname_codeql %} bundle directly from the `github/codeql-action` repository on {% data variables.product.prodname_dotcom_the_website %}{% if currentVersion != "free-pro-team@latest" %} or mirrored on {% data variables.product.product_location %}{% endif %}, so there is no need to use the `--codeql-path` flag. When the analysis is complete, the {% data variables.product.prodname_codeql_runner %} uploads the results to the {% data variables.product.prodname_code_scanning %} view. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." + +#### Compiled language example + +This example is similar to the previous example, however this time the repository has code in C/C++, C#, or Java. To create a {% data variables.product.prodname_codeql %} database for these languages, the CLI needs to monitor the build. At the end of the initialization process, the runner reports the command you need to set up the environment before building the code. You need to run this command, before calling the normal CI build process, and then running the `analyze` command. + +1. Check out the repository to analyze. +1. Move into the directory where the repository is checked out. +1. Initialize the {% data variables.product.prodname_codeql_runner %} and create {% data variables.product.prodname_codeql %} databases for the languages detected. + + ```shell + $ /path/to-runner/codeql-runner-linux init --repository octo-org/example-repo-2 + --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN + > Cleaning temp directory /srv/checkout/example-repo-2/codeql-runner + > ... + > CodeQL environment output to "/srv/checkout/example-repo-2/codeql-runner/codeql-env.json" + and "/srv/checkout/example-repo-2/codeql-runner/codeql-env.sh". + Please export these variables to future processes so the build can be traced, for example by running " + . /srv/checkout/example-repo-2/codeql-runner/codeql-env.sh". + ``` + +1. Run the script generated by the `init` action to set up the environment to monitor the build. + + ```shell + $ . /srv/checkout/example-repo-2/codeql-runner/codeql-env.sh + ``` + +1. Build the code. +1. Populate the {% data variables.product.prodname_codeql %} databases, analyze them, and upload the results to GitHub. + + ```shell + $ /path/to-runner/codeql-runner-linux analyze --repository octo-org/example-repo-2 + --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN + --commit ae7b655ef30b50fb726ae7b3daa79571a39d194d --ref refs/heads/main + > Finalizing database creation + > ... + > POST /repos/octo-org/example-repo-2/code-scanning/sarifs - 202 in 573ms + > Successfully uploaded results + ``` + +{% note %} + +**Note:** If you use a containerized build, you need to run the {% data variables.product.prodname_codeql_runner %} in the container where your build task takes place. + +{% endnote %} + +### 더 읽을거리 + +- "[Configuring {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system)" +- "[Troubleshooting {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system)" diff --git a/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md index 13b4dd5fbc64..eeafd05dff2e 100644 --- a/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md +++ b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md @@ -1,7 +1,7 @@ --- title: SARIF support for code scanning shortTitle: SARIF support -intro: 'To display results from a third-party static analysis tool in your repository on {% data variables.product.prodname_dotcom %}, you''ll need your results stored in a SARIF file that supports a specific subset of the SARIF 2.1.0 JSON schema for code scanning. If you use the default {% data variables.product.prodname_codeql %} static analysis engine, then your results will display in your repository on {% data variables.product.prodname_dotcom %} automatically.' +intro: 'To display results from a third-party static analysis tool in your repository on {% data variables.product.prodname_dotcom %}, you''ll need your results stored in a SARIF file that supports a specific subset of the SARIF 2.1.0 JSON schema for {% data variables.product.prodname_code_scanning %}. If you use the default {% data variables.product.prodname_codeql %} static analysis engine, then your results will display in your repository on {% data variables.product.prodname_dotcom %} automatically.' product: '{% data reusables.gated-features.code-scanning %}' redirect_from: - /github/finding-security-vulnerabilities-and-errors-in-your-code/about-sarif-support-for-code-scanning @@ -11,27 +11,32 @@ versions: --- {% data reusables.code-scanning.beta %} -{% data reusables.code-scanning.enterprise-enable-code-scanning %} ### About SARIF support SARIF (Static Analysis Results Interchange Format) is an [OASIS Standard](https://docs.oasis-open.org/sarif/sarif/v2.1.0/sarif-v2.1.0.html) that defines an output file format. The SARIF standard is used to streamline how static analysis tools share their results. {% data variables.product.prodname_code_scanning_capc %} supports a subset of the SARIF 2.1.0 JSON schema. -To upload a SARIF file from a third-party static code analysis engine, you'll need to ensure that uploaded files use the SARIF 2.1.0 version. {% data variables.product.prodname_dotcom %} will parse the SARIF file and show alerts using the results in your repository as a part of the code scanning experience. For more information, see "[Uploading a SARIF file to {% data variables.product.prodname_dotcom %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)." For more information about the SARIF 2.1.0 JSON schema, see [`sarif-schema-2.1.0.json`](https://github.com/oasis-tcs/sarif-spec/blob/master/Schemata/sarif-schema-2.1.0.json). +To upload a SARIF file from a third-party static code analysis engine, you'll need to ensure that uploaded files use the SARIF 2.1.0 version. {% data variables.product.prodname_dotcom %} will parse the SARIF file and show alerts using the results in your repository as a part of the {% data variables.product.prodname_code_scanning %} experience. For more information, see "[Uploading a SARIF file to {% data variables.product.prodname_dotcom %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)." For more information about the SARIF 2.1.0 JSON schema, see [`sarif-schema-2.1.0.json`](https://github.com/oasis-tcs/sarif-spec/blob/master/Schemata/sarif-schema-2.1.0.json). -If you're using {% data variables.product.prodname_actions %} with the {% data variables.product.prodname_codeql_workflow %} or using the {% data variables.product.prodname_codeql_runner %}, then the {% data variables.product.prodname_code_scanning %} results will automatically use the supported subset of SARIF 2.1.0. For more information, see "[Enabling {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning)" or "[Running code scanning in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)." +If you're using {% data variables.product.prodname_actions %} with the {% data variables.product.prodname_codeql_workflow %} or using the {% data variables.product.prodname_codeql_runner %}, then the {% data variables.product.prodname_code_scanning %} results will automatically use the supported subset of SARIF 2.1.0. For more information, see "[Enabling {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning)" or "[Running {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)." -{% data variables.product.prodname_dotcom %} uses properties in the SARIF file to display alerts. For example, the `shortDescription` and `fullDescription` appear at the top of a {% data variables.product.prodname_code_scanning %} alert. The `location` allows {% data variables.product.prodname_dotcom %} to show annotations in your code file. For more information, see "[Managing alerts from {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." +{% data variables.product.prodname_dotcom %} uses properties in the SARIF file to display alerts. For example, the `shortDescription` and `fullDescription` appear at the top of a {% data variables.product.prodname_code_scanning %} alert. The `location` allows {% data variables.product.prodname_dotcom %} to show annotations in your code file. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." If you're new to SARIF and want to learn more, see Microsoft's [`SARIF tutorials`](https://github.com/microsoft/sarif-tutorials) repository. ### Preventing duplicate alerts using fingerprints -Each time the results of a new code scan are uploaded, the results are processed and alerts are added to the repository. To prevent duplicate alerts for the same problem, {% data variables.product.prodname_code_scanning %} uses fingerprints to match results across various runs so they only appear once in the latest run for the selected branch. +Each time the results of a new code scan are uploaded, the results are processed and alerts are added to the repository. To prevent duplicate alerts for the same problem, {% data variables.product.prodname_code_scanning %} uses fingerprints to match results across various runs so they only appear once in the latest run for the selected branch. This makes it possible to match alerts to the right line of code when files are edited. {% data variables.product.prodname_dotcom %} uses the `partialFingerprints` property in the OASIS standard to detect when two results are logically identical. For more information, see the "[partialFingerprints property](https://docs.oasis-open.org/sarif/sarif/v2.1.0/cs01/sarif-v2.1.0-cs01.html#_Toc16012611)" entry in the OASIS documentation. -SARIF files created by the {% data variables.product.prodname_codeql_workflow %} or using the {% data variables.product.prodname_codeql_runner %} include fingerprint data. If your SARIF file doesn't include `partialFingerprints`, the `partialFingerprints` field will be calculated if you upload the SARIF file using {% data variables.product.prodname_actions %}. For more information, see "[Uploading a SARIF file to {% data variables.product.prodname_dotcom %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github#uploading-a-code-scanning-analysis-with-github-actions)." +SARIF files created by the {% data variables.product.prodname_codeql_workflow %} or using the {% data variables.product.prodname_codeql_runner %} include fingerprint data. If you upload a SARIF file using the `upload-sarif` action and this data is missing, {% data variables.product.prodname_dotcom %} attempts to populate the `partialFingerprints` field from the source files. For more information about uploading results, see "[Uploading a SARIF file to {% data variables.product.prodname_dotcom %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github#uploading-a-code-scanning-analysis-with-github-actions)." + +If you upload a SARIF file without fingerprint data using the `/code-scanning/sarifs` API endpoint, the {% data variables.product.prodname_code_scanning %} alerts will be processed and displayed, but users may see duplicate alerts. To avoid seeing duplicate alerts, you should calculate fingerprint data and populate the `partialFingerprints` property before you upload the SARIF file. You may find the script that the `upload-sarif` action uses a helpful starting point: https://github.com/github/codeql-action/blob/main/src/fingerprints.ts. For more information about the API, see "[Upload a SARIF file](/rest/reference/code-scanning#upload-a-sarif-file)." + +### Validating your SARIF file + +You can check a SARIF file is compatible with {% data variables.product.prodname_code_scanning %} by testing it against the {% data variables.product.prodname_dotcom %} ingestion rules. For more information, visit the [Microsoft SARIF validator](https://sarifweb.azurewebsites.net/). ### Supported SARIF output file properties @@ -44,49 +49,49 @@ Any valid SARIF 2.1.0 output file can be uploaded, however, {% data variables.pr | 이름 | 설명 | | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `$schema` | **Required.** The URI of the SARIF JSON schema for version 2.1.0. For example, `https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json`. | -| `version` | **Required.** {% data variables.product.prodname_code_scanning_capc %} only supports SARIF version `2.1.0`. | +| `version` | **Required.** {% data variables.product.prodname_code_scanning_capc %} only supports SARIF version `2.1.0`. | | `runs[]` | **Required.** A SARIF file contains an array of one or more runs. Each run represents a single run of an analysis tool. For more information about a `run`, see the [`run` object](#run-object). | #### `run` object {% data variables.product.prodname_code_scanning_capc %} uses the `run` object to filter results by tool and provide information about the source of a result. The `run` object contains the `tool.driver` tool component object, which contains information about the tool that generated the results. Each `run` can only have results for one analysis tool. -| 이름 | 설명 | -| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 이름 | 설명 | +| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `tool.driver.name` | **Required.** The name of the analysis tool. {% data variables.product.prodname_code_scanning_capc %} displays the name on {% data variables.product.prodname_dotcom %} to allow you to filter results by tool. | | `tool.driver.version` | **Optional.** The version of the analysis tool. {% data variables.product.prodname_code_scanning_capc %} uses the version number to track when results may have changed due to a tool version change rather than a change in the code being analyzed. If the SARIF file includes the `semanticVersion` field, `version` is not used by {% data variables.product.prodname_code_scanning %}. | | `tool.driver.semanticVersion` | **Optional.** The version of the analysis tool, specified by the Semantic Versioning 2.0 format. {% data variables.product.prodname_code_scanning_capc %} uses the version number to track when results may have changed due to a tool version change rather than a change in the code being analyzed. If the SARIF file includes the `semanticVersion` field, `version` is not used by {% data variables.product.prodname_code_scanning %}. For more information, see "[Semantic Versioning 2.0.0](https://semver.org/)" in the Semantic Versioning documentation. | -| `tool.driver.rules[]` | **Required.** An array of `reportingDescriptor` objects that represent rules. The analysis tool uses rules to find problems in the code being analyzed. For more information, see the [`reportingDescriptor` object](#reportingdescriptor-object). | +| `tool.driver.rules[]` | **Required.** An array of `reportingDescriptor` objects that represent rules. The analysis tool uses rules to find problems in the code being analyzed. For more information, see the [`reportingDescriptor` object](#reportingdescriptor-object). | | `results[]` | **Required.** The results of the analysis tool. {% data variables.product.prodname_code_scanning_capc %} displays the results on {% data variables.product.prodname_dotcom %}. For more information, see the [`result` object](#result-object). | #### `reportingDescriptor` object -| 이름 | 설명 | -| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 이름 | 설명 | +| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | **Required.** A unique identifier for the rule. The `id` is referenced from other parts of the SARIF file and may be used by {% data variables.product.prodname_code_scanning %} to display URLs on {% data variables.product.prodname_dotcom %}. | | `name` | **Optional.** The name of the rule. {% data variables.product.prodname_code_scanning_capc %} displays the name to allow results to be filtered by rule on {% data variables.product.prodname_dotcom %}. | | `shortDescription.text` | **Required.** A concise description of the rule. {% data variables.product.prodname_code_scanning_capc %} displays the short description on {% data variables.product.prodname_dotcom %} next to the associated results. | | `fullDescription.text` | **Required.** A description of the rule. {% data variables.product.prodname_code_scanning_capc %} displays the full description on {% data variables.product.prodname_dotcom %} next to the associated results. The max number of characters is limited to 1000. | -| `defaultConfiguration.level` | **Optional.** Default severity level of the rule. {% data variables.product.prodname_code_scanning_capc %} uses severity levels to help you understand how critical the result is for a given rule. This value can be overridden by the `level` attribute in the `result` object. For more information, see the [`result` object](#result-object). Default: `warning`. | -| `help.text` | **Required.** Documentation for the rule using text format. {% data variables.product.prodname_code_scanning_capc %} displays this help documentation next to the associated results. | -| `help.markdown` | **Recommended.** Documentation for the rule using Markdown format. {% data variables.product.prodname_code_scanning_capc %} displays this help documentation next to the associated results. When `help.markdown` is available, it is displayed instead of `help.text`. | +| `defaultConfiguration.level` | **Optional.** Default severity level of the rule. {% data variables.product.prodname_code_scanning_capc %} uses severity levels to help you understand how critical the result is for a given rule. This value can be overridden by the `level` attribute in the `result` object. For more information, see the [`result` object](#result-object). Default: `warning`. | +| `help.text` | **Required.** Documentation for the rule using text format. {% data variables.product.prodname_code_scanning_capc %} displays this help documentation next to the associated results. | +| `help.markdown` | **Recommended.** Documentation for the rule using Markdown format. {% data variables.product.prodname_code_scanning_capc %} displays this help documentation next to the associated results. When `help.markdown` is available, it is displayed instead of `help.text`. | | `properties.tags[]` | **Optional.** An array of strings. {% data variables.product.prodname_code_scanning_capc %} uses `tags` to allow you to filter results on {% data variables.product.prodname_dotcom %}. For example, it is possible to filter to all results that have the tag `security`. | | `properties.precision` | **Recommended.** A string that indicates how often the results indicated by this rule are true. For example, if a rule has a known high false-positive rate, the precision should be `low`. {% data variables.product.prodname_code_scanning_capc %} orders results by precision on {% data variables.product.prodname_dotcom %} so that the results with the highest `level`, and highest `precision` are shown first. Can be one of: `very-high`, `high`, `medium`, or `low`. | #### `result` object -| 이름 | 설명 | -| --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `ruleId` | **Optional.** The unique identifier of the rule (`reportingDescriptor.id`). For more information, see the [`reportingDescriptor` object](#reportingdescriptor-object). {% data variables.product.prodname_code_scanning_capc %} uses the rule identifier to filter results by rule on {% data variables.product.prodname_dotcom %}. | -| `ruleIndex` | **Optional.** The index of the associated rule (`reportingDescriptor` object) in the tool component `rules` array. For more information, see the [`run` object](#run-object). | -| `rule` | **Optional.** A reference used to locate the rule (reporting descriptor) for this result. For more information, see the [`reportingDescriptor` object](#reportingdescriptor-object). | -| `level` | **Optional.** The severity of the result. This level overrides the default severity defined by the rule. {% data variables.product.prodname_code_scanning_capc %} uses the level to filter results by severity on {% data variables.product.prodname_dotcom %}. | -| `message.text` | **Required.** A message that describes the result. {% data variables.product.prodname_code_scanning_capc %} displays the message text as the title of the result. Only the first sentence of the message will be displayed when visible space is limited. | -| `locations[]` | **Required.** The set of locations where the result was detected. Only one location should be included unless the problem can only be corrected by making a change at every specified location. **Note:** At least one location is required for {% data variables.product.prodname_code_scanning %} to display a result. {% data variables.product.prodname_code_scanning_capc %} will use this property to decide which file to annotate with the result. Only the first value of this array is used. All other values are ignored. | +| 이름 | 설명 | +| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `ruleId` | **Optional.** The unique identifier of the rule (`reportingDescriptor.id`). For more information, see the [`reportingDescriptor` object](#reportingdescriptor-object). {% data variables.product.prodname_code_scanning_capc %} uses the rule identifier to filter results by rule on {% data variables.product.prodname_dotcom %}. | +| `ruleIndex` | **Optional.** The index of the associated rule (`reportingDescriptor` object) in the tool component `rules` array. For more information, see the [`run` object](#run-object). | +| `rule` | **Optional.** A reference used to locate the rule (reporting descriptor) for this result. For more information, see the [`reportingDescriptor` object](#reportingdescriptor-object). | +| `level` | **Optional.** The severity of the result. This level overrides the default severity defined by the rule. {% data variables.product.prodname_code_scanning_capc %} uses the level to filter results by severity on {% data variables.product.prodname_dotcom %}. | +| `message.text` | **Required.** A message that describes the result. {% data variables.product.prodname_code_scanning_capc %} displays the message text as the title of the result. Only the first sentence of the message will be displayed when visible space is limited. | +| `locations[]` | **Required.** The set of locations where the result was detected. Only one location should be included unless the problem can only be corrected by making a change at every specified location. **Note:** At least one location is required for {% data variables.product.prodname_code_scanning %} to display a result. {% data variables.product.prodname_code_scanning_capc %} will use this property to decide which file to annotate with the result. Only the first value of this array is used. All other values are ignored. | | `partialFingerprints` | **Required.** A set of strings used to track the unique identity of the result. {% data variables.product.prodname_code_scanning_capc %} uses `partialFingerprints` to accurately identify which results are the same across commits and branches. {% data variables.product.prodname_code_scanning_capc %} will attempt to use `partialFingerprints` if they exist. If you are uploading third-party SARIF files with the `upload-action`, the action will create `partialFingerprints` for you when they are not included in the SARIF file. For more information, see "[Preventing duplicate alerts using fingerprints](#preventing-duplicate-alerts-using-fingerprints)." **Note:** {% data variables.product.prodname_code_scanning_capc %} only uses the `primaryLocationLineHash`. | -| `codeFlows[].threadFlows[].locations[]` | **Optional.** An array of `location` objects for a `threadFlow` object, which describes the progress of a program through a thread of execution. A `codeFlow` object describes a pattern of code execution used to detect a result. If code flows are provided, {% data variables.product.prodname_code_scanning %} will expand code flows on {% data variables.product.prodname_dotcom %} for the relevant result. For more information, see the [`location` object](#location-object). | -| `relatedLocations[]` | A set of locations relevant to this result. {% data variables.product.prodname_code_scanning_capc %} will link to related locations when they are embedded in the result message. For more information, see the [`location` object](#location-object). | -| `suppressions[].state` | **Optional.** When the `state` is set to `accepted`, {% data variables.product.prodname_code_scanning %} will update the state of the result to `Closed` on {% data variables.product.prodname_dotcom %}. | +| `codeFlows[].threadFlows[].locations[]` | **Optional.** An array of `location` objects for a `threadFlow` object, which describes the progress of a program through a thread of execution. A `codeFlow` object describes a pattern of code execution used to detect a result. If code flows are provided, {% data variables.product.prodname_code_scanning %} will expand code flows on {% data variables.product.prodname_dotcom %} for the relevant result. For more information, see the [`location` object](#location-object). | +| `relatedLocations[]` | A set of locations relevant to this result. {% data variables.product.prodname_code_scanning_capc %} will link to related locations when they are embedded in the result message. For more information, see the [`location` object](#location-object). | +| `suppressions[].state` | **Optional.** When the `state` is set to `accepted`, {% data variables.product.prodname_code_scanning %} will update the state of the result to `Closed` on {% data variables.product.prodname_dotcom %}. | #### `location` object @@ -100,13 +105,13 @@ A location within a programming artifact, such as a file in the repository or a #### `physicalLocation` object -| 이름 | 설명 | -| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 이름 | 설명 | +| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `artifactLocation.uri` | **Required.** A URI indicating the location of an artifact, usually a file either in the repository or generated during a build. If the URI is relative, it should be relative to the root of the {% data variables.product.prodname_dotcom %} repository being analyzed. For example, main.js or src/script.js are relative to the root of the repository. If the URI is absolute, {% data variables.product.prodname_code_scanning %} can use the URI to checkout the artifact and match up files in the repository. For example, `https://github.com/github/example/blob/00/src/promiseUtils.js`. | -| `region.startLine` | **Required.** The line number of the first character in the region. | -| `region.startColumn` | **Required.** The column number of the first character in the region. | -| `region.endLine` | **Required.** The line number of the last character in the region. | -| `region.endColumn` | **Required.** The column number of the character following the end of the region. | +| `region.startLine` | **Required.** The line number of the first character in the region. | +| `region.startColumn` | **Required.** The column number of the first character in the region. | +| `region.endLine` | **Required.** The line number of the last character in the region. | +| `region.endColumn` | **Required.** The column number of the character following the end of the region. | ### SARIF output file examples @@ -119,38 +124,47 @@ This SARIF output file has example values to show the minimum required propertie ```json { - "$schema" : "https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json", - "version" : "2.1.0", - "runs" : - [ + "$schema": "https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json", + "version": "2.1.0", + "runs": [ { - "tool" : { - "driver" : { - "name" : "Tool Name" - } - }, - "results" : [ { - "message" : { - "text" : "Result text. This result does not have a rule associated." - }, - "locations" : [ { - "physicalLocation" : { - "artifactLocation" : { - "uri" : "src/build.cmd" - }, - "region" : { - "startLine" : 2, - "startColumn" : 7, - "endColumn" : 10 + "tool": { + "driver": { + "name": "Tool Name", + "rules": [ + { + "id": "R01" } + ] + } + }, + "results": [ + { + "ruleId": "R01", + "message": { + "text": "Result text. This result does not have a rule associated." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "fileURI" + }, + "region": { + "startLine": 2, + "startColumn": 7, + "endColumn": 10 + } + } } - } ], - "partialFingerprints" : { - "primaryLocationLineHash" : "39fa2ee980eb94b0:1" + ], + "partialFingerprints": { + "primaryLocationLineHash": "39fa2ee980eb94b0:1" + } } - }] - } - ] + ] + } + ] } ``` @@ -170,7 +184,7 @@ This SARIF output file has example values to show all supported SARIF properties "semanticVersion": "2.0.0", "rules": [ { - "id": "js/unused-local-variable", + "id": "3f292041e51d22005ce48f39df3585d44ce1b0ad", "name": "js/unused-local-variable", "shortDescription": { "text": "Unused variable, import, function or class" @@ -189,7 +203,7 @@ This SARIF output file has example values to show all supported SARIF properties } }, { - "id": "js/inconsistent-use-of-new", + "id": "d5b664aefd5ca4b21b52fdc1d744d7d6ab6886d0", "name": "js/inconsistent-use-of-new", "shortDescription": { "text": "Inconsistent use of 'new'" @@ -197,7 +211,6 @@ This SARIF output file has example values to show all supported SARIF properties "fullDescription": { "text": "If a function is intended to be a constructor, it should always be invoked with 'new'. Otherwise, it should always be invoked as a normal function, that is, without 'new'." }, - "defaultConfiguration": null, "properties": { "tags": [ "reliability", @@ -206,13 +219,16 @@ This SARIF output file has example values to show all supported SARIF properties ], "precision": "very-high" } + }, + { + "id": "R01" } ] } }, "results": [ { - "ruleId": "js/unused-local-variable", + "ruleId": "3f292041e51d22005ce48f39df3585d44ce1b0ad", "ruleIndex": 0, "message": { "text": "Unused variable foo." @@ -222,8 +238,7 @@ This SARIF output file has example values to show all supported SARIF properties "physicalLocation": { "artifactLocation": { "uri": "main.js", - "uriBaseId": "%SRCROOT%", - "index": 0 + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 2, @@ -239,7 +254,7 @@ This SARIF output file has example values to show all supported SARIF properties } }, { - "ruleId": "js/inconsistent-use-of-new", + "ruleId": "d5b664aefd5ca4b21b52fdc1d744d7d6ab6886d0", "ruleIndex": 1, "message": { "text": "Function resolvingPromise is sometimes invoked as a constructor (for example [here](1)), and sometimes as a normal function (for example [here](2))." @@ -248,8 +263,8 @@ This SARIF output file has example values to show all supported SARIF properties { "physicalLocation": { "artifactLocation": { - "uri": "https://github.com/github/example/blob/0000000000000000000000000000000000000000/src/promiseUtils.js", - "index": 1 + "uri": "src/promises.js", + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 2 @@ -267,8 +282,7 @@ This SARIF output file has example values to show all supported SARIF properties "physicalLocation": { "artifactLocation": { "uri": "src/ParseObject.js", - "uriBaseId": "%SRCROOT%", - "index": 3 + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 2281, @@ -285,8 +299,7 @@ This SARIF output file has example values to show all supported SARIF properties "physicalLocation": { "artifactLocation": { "uri": "src/LiveQueryClient.js", - "uriBaseId": "%SRCROOT%", - "index": 2 + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 166 @@ -299,6 +312,7 @@ This SARIF output file has example values to show all supported SARIF properties ] }, { + "ruleId": "R01", "message": { "text": "Specifying both [ruleIndex](1) and [ruleID](2) might lead to inconsistencies." }, @@ -308,8 +322,7 @@ This SARIF output file has example values to show all supported SARIF properties "physicalLocation": { "artifactLocation": { "uri": "full.sarif", - "uriBaseId": "%SRCROOT%", - "index": 0 + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 54, @@ -403,12 +416,6 @@ This SARIF output file has example values to show all supported SARIF properties } } ], - "newlineSequences": [ - "\r\n", - "\n", - "", - "" - ], "columnKind": "utf16CodeUnits" } ] diff --git a/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md new file mode 100644 index 000000000000..931419d50117 --- /dev/null +++ b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md @@ -0,0 +1,48 @@ +--- +title: Triaging code scanning alerts in pull requests +shortTitle: Triaging alerts in pull requests +intro: 'When {% data variables.product.prodname_code_scanning %} identifies a problem in a pull request, you can review the highlighted code and resolve the alert.' +product: '{% data reusables.gated-features.code-scanning %}' +permissions: 'People with write permission to a repository can resolve {% data variables.product.prodname_code_scanning %} alerts.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta %} + +### About {% data variables.product.prodname_code_scanning %} results on pull requests + +In repositories where {% data variables.product.prodname_code_scanning %} is configured as a pull request check, {% data variables.product.prodname_code_scanning %} checks the code in the pull request. By default, this is limited to pull requests that target the default branch or protected branches, but you can change this configuration within {% data variables.product.prodname_actions %} or in a third-party CI/CD system. If merging the changes would introduce new {% data variables.product.prodname_code_scanning %} alerts to the target branch, these are reported as check results in the pull request. The alerts are also shown as annotations in the **Files changed** tab of the pull request. If you have write permission for the repository, you can see any existing {% data variables.product.prodname_code_scanning %} alerts on the **Security** tab. For information about repository alerts, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." + +If {% data variables.product.prodname_code_scanning %} has any results with a severity of `error`, the check fails and the error is reported in the check results. If all the results found by {% data variables.product.prodname_code_scanning %} have lower severities, the alerts are treated as warnings or notices and the check succeeds. If your pull request targets a protected branch, and the repository owner has configured required status checks, then you must either fix or close any error alerts before the pull request can be merged. For more information, see "[About required status checks](/github/administering-a-repository/about-required-status-checks)." + +![Example pull request check status with {% data variables.product.prodname_code_scanning %} alert](/assets/images/help/repository/code-scanning-check-failure.png) + +### About {% data variables.product.prodname_code_scanning %} as a pull request check + +There are many options for configuring {% data variables.product.prodname_code_scanning %} as a pull request check, so the exact setup of each repository will vary and some will have more than one check. The check that contains the results of {% data variables.product.prodname_code_scanning %} is: **Code scanning results**. + +If the repository uses the {% data variables.product.prodname_codeql_workflow %} a **{% data variables.product.prodname_codeql %} / Analyze (LANGUAGE)** check is run for each language before the results check runs. The analysis check may fail if there are configuration problems, or if the pull request breaks the build for a language that the analysis needs to compile (for example, C/C++, C#, or Java). As with other pull request checks, you can see full details of the check failure on the **Checks** tab. For more information about configuring and troubleshooting, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" or "[Troubleshooting {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning)." + +### Triaging an alert on your pull request + +When you look at the **Files changed** tab for a pull request, you see annotations for any lines of code that triggered the alert. + +![Example {% data variables.product.prodname_code_scanning %} alert shown as an annotation in the "Files changed" view of a pull request](/assets/images/help/repository/code-scanning-pr-annotation.png) + +Some annotations contain links with extra context for the alert. In the example above, from {% data variables.product.prodname_codeql %} analysis, you can click **user-provided value** to see where the untrusted data enters the data flow (this is referred to as the source). In this case you can view the full path from the source to the code that uses the data (the sink) by clicking **Show paths**. This makes it easy to check whether the data is untrusted or if the analysis failed to recognize a data sanitization step between the source and the sink. For information about analyzing data flow using {% data variables.product.prodname_codeql %}, see "[About data flow analysis](https://help.semmle.com/QL/learn-ql/intro-to-data-flow.html)." + +For more information about an alert, click **Show more details** on the annotation. This allows you to see all of the context and metadata provided by the tool in an alert view. In the example below, you can see tags showing the severity, type, and relevant common weakness enumerations (CWEs) for the problem. The view also shows which commit introduced the problem. + +Alerts from some tools, like {% data variables.product.prodname_codeql %}, also include a description and a **Show more** link for guidance on how to fix the problem in the code. + +![Example of "Show more details" for a {% data variables.product.prodname_code_scanning %} alert in a pull request](/assets/images/help/repository/code-scanning-pr-alert.png) + +### Resolving an alert on your pull request + +Anyone with write permission for a repository can resolve alerts on a pull request. If you commit changes to the pull request this triggers a new run of the pull request checks. If your changes fix the problem, the alert is resolved and the annotation removed. + +If you don't think that an alert needs to be fixed, you can close the alert manually. {% data reusables.code-scanning.close-alert-examples %} The **Close** button is available in annotations and in the alerts view if you have write permission for the repository. + +{% data reusables.code-scanning.false-positive-fix-codeql %} diff --git a/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md new file mode 100644 index 000000000000..317698c3e0b0 --- /dev/null +++ b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md @@ -0,0 +1,52 @@ +--- +title: Troubleshooting CodeQL code scanning in your CI system +shortTitle: Troubleshooting in your CI +intro: 'If you''re having problems with the {% data variables.product.prodname_codeql_runner %}, you can troubleshoot by using these tips.' +product: '{% data reusables.gated-features.code-scanning %}' +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning-in-your-ci-system +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta-codeql-runner %} +{% data reusables.code-scanning.beta %} + +### The `init` command takes too long + +Before the {% data variables.product.prodname_codeql_runner %} can build and analyze code, it needs access to the {% data variables.product.prodname_codeql %} bundle, which contains the {% data variables.product.prodname_codeql %} CLI and the {% data variables.product.prodname_codeql %} libraries. + +When you use the {% data variables.product.prodname_codeql_runner %} for the first time on your machine, the `init` command downloads the {% data variables.product.prodname_codeql %} bundle to your machine. This download can take a few minutes. The {% data variables.product.prodname_codeql %} bundle is cached between runs, so if you use the {% data variables.product.prodname_codeql_runner %} again on the same machine, it won't download the {% data variables.product.prodname_codeql %} bundle again. + +To avoid this automatic download, you can manually download the {% data variables.product.prodname_codeql %} bundle to your machine and specify the path using the `--codeql-path` flag of the `init` command. + +### No code found during the build + +If the `analyze` command for the {% data variables.product.prodname_codeql_runner %} fails with an error `No source code was seen during the build`, this indicates that {% data variables.product.prodname_codeql %} was unable to monitor your code. Several reasons can explain such a failure. + +1. Automatic language detection identified a supported language, but there is no analyzable code of that language in the repository. A typical example is when our language detection service finds a file associated with a particular programming language like a `.h`, or `.gyp` file, but no corresponding executable code is present in the repository. To solve the problem, you can manually define the languages you want to analyze by using the `--languages` flag of the `init` command. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system)." + +1. You're analyzing a compiled language without using the `autobuild` command and you run the build steps yourself after the `init` step. For the build to work, you must set up the environment such that the {% data variables.product.prodname_codeql_runner %} can monitor the code. The `init` command generates instructions for how to export the required environment variables, so you can copy and run the script after you've run the `init` command. + - On macOS and Linux: + ```shell + $ . codeql-runner/codeql-env.sh + ``` + - On Windows, using the Command shell (`cmd`) or a batch file (`.bat`): + ```shell + > call codeql-runner\codeql-env.bat + ``` + - On Windows, using PowerShell: + ```shell + > cat codeql-runner\codeql-env.sh | Invoke-Expression + ``` + + The environment variables are also stored in the file `codeql-runner/codeql-env.json`. This file contains a single JSON object which maps environment variable keys to values. If you can't run the script generated by the `init` command, then you can use the data in JSON format instead. + + {% note %} + + **Note:** If you used the `--temp-dir` flag of the `init` command to specify a custom directory for temporary files, the path to the `codeql-env` files might be different. + + {% endnote %} + +1. The code is built in a container or on a separate machine. If you use a containerized build or if you outsource the build to another machine, make sure to run the {% data variables.product.prodname_codeql_runner %} in the container or on the machine where your build task takes place. diff --git a/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md new file mode 100644 index 000000000000..a34e7f6ac2a9 --- /dev/null +++ b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md @@ -0,0 +1,126 @@ +--- +title: Troubleshooting the CodeQL workflow +shortTitle: Troubleshooting CodeQL +intro: 'If you''re having problems with {% data variables.product.prodname_code_scanning %}, you can troubleshoot by using these tips for resolving issues.' +product: '{% data reusables.gated-features.code-scanning %}' +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta %} + +### Automatic build for a compiled language fails + +If an automatic build of code for a compiled language within your project fails, try the following troubleshooting steps. + +- Remove the `autobuild` step from your {% data variables.product.prodname_code_scanning %} workflow and add specific build steps. For information about editing the workflow, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)." For more information about replacing the `autobuild` step, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." + +- If your workflow doesn't explicitly specify the languages to analyze, {% data variables.product.prodname_codeql %} implicitly detects the supported languages in your code base. In this configuration, out of the compiled languages C/C++, C#, and Java, {% data variables.product.prodname_codeql %} only analyzes the language with the most source files. Edit the workflow and add a build matrix specifying the languages you want to analyze. The default CodeQL analysis workflow uses such a matrix. + + The following extracts from a workflow show how you can use a matrix within the job strategy to specify languages, and then reference each language within the "Initialize {% data variables.product.prodname_codeql %}" step: + + ```yaml + jobs: + analyze: + ... + strategy: + fail-fast: false + matrix: + language: ['csharp', 'cpp', 'javascript'] + + ... + + - name: Initialize {% data variables.product.prodname_codeql %} + uses: github/codeql-action/init@v1 + with: + languages: {% raw %}${{ matrix.language }}{% endraw %} + ``` + + For more information about editing the workflow, see "[Configuring code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." + +### No code found during the build + +If your workflow fails with an error `No source code was seen during the build` or `The process '/opt/hostedtoolcache/CodeQL/0.0.0-20200630/x64/codeql/codeql' failed with exit code 32`, this indicates that {% data variables.product.prodname_codeql %} was unable to monitor your code. Several reasons can explain such a failure: + +1. Automatic language detection identified a supported language, but there is no analyzable code of that language in the repository. A typical example is when our language detection service finds a file associated with a particular programming language like a `.h`, or `.gyp` file, but no corresponding executable code is present in the repository. To solve the problem, you can manually define the languages you want to analyze by updating the list of languages in the `language` matrix. For example, the following configuration will analyze only Go, and JavaScript. + + ```yaml + strategy: + fail-fast: false + matrix: + # Override automatic language detection by changing the list below + # Supported options are: + # ['csharp', 'cpp', 'go', 'java', 'javascript', 'python'] + language: ['go', 'javascript'] + ``` +For more information, see the workflow extract in "[Automatic build for a compiled language fails](#automatic-build-for-a-compiled-language-fails)" above. +1. Your {% data variables.product.prodname_code_scanning %} workflow is analyzing a compiled language (C, C++, C#, or Java), but the code was not compiled. By default, the {% data variables.product.prodname_codeql %} analysis workflow contains an `autobuild` step, however, this step represents a best effort process, and may not succeed in building your code, depending on your specific build environment. Compilation may also fail if you have removed the `autobuild` step and did not include build steps manually. For more information about specifying build steps, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." +1. Your workflow is analyzing a compiled language (C, C++, C#, or Java), but portions of your build are cached to improve performance (most likely to occur with build systems like Gradle or Bazel). Since {% data variables.product.prodname_codeql %} observes the activity of the compiler to understand the data flows in a repository, {% data variables.product.prodname_codeql %} requires a complete build to take place in order to perform analysis. +1. Your workflow is analyzing a compiled language (C, C++, C#, or Java), but compilation does not occur between the `init` and `analyze` steps in the workflow. {% data variables.product.prodname_codeql %} requires that your build happens in between these two steps in order to observe the activity of the compiler and perform analysis. +1. Your compiled code (in C, C++, C#, or Java) was compiled successfully, but {% data variables.product.prodname_codeql %} was unable to detect the compiler invocations. The most common causes are certain configuration options like running your build process in a container, if you're building using a distributed build system external to {% data variables.product.prodname_actions %} using a daemon process, or if {% data variables.product.prodname_codeql %} isn't aware of the specific compiler you are using. + + For C# projects using either `dotnet build` or `msbuild` which target .NET Core 2, you should specify `/p:UseSharedCompilation=false` in your workflow's `run` step, when you build your code. The `UseSharedCompilation` flag isn't necessary for .NET Core 3.0 and later. + + For example, the following configuration for C# will pass the flag during the first build step. + + ``` yaml + - run: | + dotnet build /p:UseSharedCompilation=false + ``` + + If you encounter another problem with your specific compiler or configuration, contact {% data variables.contact.contact_support %}. + +For more information about specifying build steps, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." + +### Portions of my repository were not analyzed using `autobuild` + +The {% data variables.product.prodname_codeql %} `autobuild` feature uses heuristics to build the code in a repository, however, sometimes this approach results in incomplete analysis of a repository. For example, when multiple `build.sh` commands exist in a single repository, the analysis may not complete since the `autobuild` step will only execute one of the commands. The solution is to replace the `autobuild` step with build steps which build all of the source code which you wish to analyze. For more information, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." + +### Error: "Server error" + +If the run of a workflow for {% data variables.product.prodname_code_scanning %} fails due to a server error, try running the workflow again. If the problem persists, contact {% data variables.contact.contact_support %}. + +### Error: "Out of disk" or "Out of memory" +On very large projects, + +{% data variables.product.prodname_codeql %} may run out of disk or memory on the runner. +{% if currentVersion == "free-pro-team@latest" %}If you encounter this issue on a hosted {% data variables.product.prodname_actions %} runner, contact {% data variables.contact.contact_support %} so that we can investigate the problem. +{% else %}If you encounter this issue, try increasing the memory on the runner.{% endif %} + +### The build takes too long + +If your build with {% data variables.product.prodname_codeql %} analysis takes too long to run, there are several approaches you can try to reduce the build time. + +#### Increase the memory or cores + +If you use self-hosted runners to run {% data variables.product.prodname_codeql %} analysis, you can increase the memory or the number of cores on those runners. + +#### Use matrix builds to parallelize the analysis + +The default {% data variables.product.prodname_codeql_workflow %} uses a build matrix of languages, which causes the analysis of each language to run in parallel. If you have specified the languages you want to analyze directly in the "Initialize CodeQL" step, analysis of each language will happen sequentially. To speed up analysis of multiple languages, modify your workflow to use a matrix. For more information, see the workflow extract in "[Automatic build for a compiled language fails](#automatic-build-for-a-compiled-language-fails)" above. + +#### Reduce the amount of code being analyzed in a single workflow + +Analysis time is typically proportional to the amount of code being analyzed. You can reduce the analysis time by reducing the amount of code being analyzed at once, for example, by excluding test code, or breaking analysis into multiple workflows that analyze only a subset of your code at a time. + +For compiled languages like Java, C, C++, and C#, {% data variables.product.prodname_codeql %} analyzes all of the code which was built during the workflow run. To limit the amount of code being analyzed, build only the code which you wish to analyze by specifying your own build steps in a `run` block. You can combine specifying your own build steps with using the `paths` or `paths-ignore` filters on the `pull_request` and `push` events to ensure that your workflow only runs when specific code is changed. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)." + +For interpreted languages like Go, JavaScript, Python, and TypeScript, that {% data variables.product.prodname_codeql %} analyzes without a specific build, you can specify additional configuration options to limit the amount of code to analyze. For more information, see "[Specifying directories to scan](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#specifying-directories-to-scan)." + +If you split your analysis into multiple workflows as described above, we still recommend that you have at least one workflow which runs on a `schedule` which analyzes all of the code in your repository. Because {% data variables.product.prodname_codeql %} analyzes data flows between components, some complex security behaviors may only be detected on a complete build. + +#### Run only during a `schedule` event + +If your analysis is still too slow to be run during `push` or `pull_request` events, then you may want to only trigger analysis on the `schedule` event. For more information, see "[Events](/actions/learn-github-actions/introduction-to-github-actions#events)." + +{% if currentVersion == "free-pro-team@latest" %} +### Results differ between analysis platforms + +If you are analyzing code written in Python, you may see different results depending on whether you run the {% data variables.product.prodname_codeql_workflow %} on Linux, macOS, or Windows. + +On GitHub-hosted runners that use Linux, the {% data variables.product.prodname_codeql_workflow %} tries to install and analyze Python dependencies, which could lead to more results. To disable the auto-install, add `setup-python-dependencies: false` to the "Initialize CodeQL" step of the workflow. For more information about configuring the analysis of Python dependencies, see "[Analyzing Python dependencies](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#analyzing-python-dependencies)." + +{% endif %} \ No newline at end of file diff --git a/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md index 9846ec3c5d7b..01caf5341f7b 100644 --- a/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md +++ b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md @@ -16,7 +16,7 @@ versions: ### About SARIF file uploads for {% data variables.product.prodname_code_scanning %} -{% data variables.product.prodname_dotcom %} creates {% data variables.product.prodname_code_scanning %} alerts in a repository using information from Static Analysis Results Interchange Format (SARIF) files. SARIF files can be uploaded to a repository using the API or {% data variables.product.prodname_actions %}. For more information, see "[Managing alerts from {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." +{% data variables.product.prodname_dotcom %} creates {% data variables.product.prodname_code_scanning %} alerts in a repository using information from Static Analysis Results Interchange Format (SARIF) files. SARIF files can be uploaded to a repository using the API or {% data variables.product.prodname_actions %}. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." You can generate SARIF files using many static analysis security testing tools, including {% data variables.product.prodname_codeql %}. The results must use SARIF version 2.1.0. For more information, see "[About SARIF support for {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-sarif-support-for-code-scanning)." @@ -24,12 +24,12 @@ You can upload the results using {% data variables.product.prodname_actions %}{% - {% data variables.product.prodname_actions %} to run the {% data variables.product.prodname_codeql %} action, there is no further action required. The {% data variables.product.prodname_codeql %} action uploads the SARIF file automatically when it completes analysis. - {% data variables.product.prodname_actions %} to run a SARIF-compatible analysis tool, you could update the workflow to include a final step that uploads the results (see below). -- The {% data variables.product.prodname_codeql_runner %}, to run {% data variables.product.prodname_code_scanning %} in your CI system, by default the runner automatically uploads results to {% data variables.product.prodname_dotcom %} on completion. If you block the automatic upload, when you are ready to upload results you can use the `upload` command (for more information, see "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)"). +- The {% data variables.product.prodname_codeql_runner %}, to run {% data variables.product.prodname_code_scanning %} in your CI system, by default the runner automatically uploads results to {% data variables.product.prodname_dotcom %} on completion. The {% data variables.product.prodname_codeql_runner %}, to run {% data variables.product.prodname_code_scanning %} in your CI system, by default the runner automatically uploads results to {% data variables.product.prodname_dotcom %} on completion. - A tool that generates results as an artifact outside of your repository, you can use the {% data variables.product.prodname_code_scanning %} API to upload the file (for more information, see "[Upload a SARIF file](/rest/reference/code-scanning#upload-a-sarif-file)"). ### Uploading a {% data variables.product.prodname_code_scanning %} analysis with {% data variables.product.prodname_actions %} -To use {% data variables.product.prodname_actions %} to upload a third-party SARIF file to a repository, you'll need a workflow. For more information, see "[About {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)" and "[Configuring a workflow](/actions/configuring-and-managing-workflows/configuring-a-workflow)". +To use {% data variables.product.prodname_actions %} to upload a third-party SARIF file to a repository, you'll need a workflow. For more information, see "[Learn {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)" and "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." Your workflow will need to use the `upload-sarif` action, which is part of the `github/codeql-action` repository. It has input parameters that you can use to configure the upload. The main input parameter you'll use is `sarif-file`, which configures the file or directory of SARIF files to be uploaded. The directory or file path is relative to the root of the repository. For more information see the [`upload-sarif` action](https://github.com/github/codeql-action/tree/HEAD/upload-sarif). @@ -43,7 +43,7 @@ You can create a new workflow that uploads SARIF files after you commit them to This example workflow runs anytime commits are pushed to the repository. The action uses the `partialFingerprints` property to determine if changes have occurred. In addition to running when commits are pushed, the workflow is scheduled to run once per week. For more information, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows)." -This workflow uploads the `results.sarif` file located in the root of the repository. For more information about creating a workflow file, see "[Configuring a workflow](/actions/configuring-and-managing-workflows/configuring-a-workflow)." +This workflow uploads the `results.sarif` file located in the root of the repository. For more information about creating a workflow file, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." Alternatively, you could modify this workflow to upload a directory of SARIF files. For example, you could place all SARIF files in a directory in the root of your repository called `sarif-output` and set the action's input parameter `sarif_file` to `sarif-output`. @@ -73,11 +73,11 @@ jobs: #### Example workflow that runs the ESLint analysis tool -If you generate your third-party SARIF file as part of a continuous integration (CI) workflow, you can add the `upload-sarif` action as a step after running your CI tests. If you don't already have a CI workflow, you can create one using a {% data variables.product.prodname_actions %} template. For more information, see "[Starting with preconfigured workflow templates](/actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates)." +If you generate your third-party SARIF file as part of a continuous integration (CI) workflow, you can add the `upload-sarif` action as a step after running your CI tests. If you don't already have a CI workflow, you can create one using a {% data variables.product.prodname_actions %} template. For more information, see the "[{% data variables.product.prodname_actions %} quickstart](/actions/quickstart)." This example workflow runs anytime commits are pushed to the repository. The action uses the `partialFingerprints` property to determine if changes have occurred. In addition to running when commits are pushed, the workflow is scheduled to run once per week. For more information, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows)." -The workflow shows an example of running the ESLint static analysis tool as a step in a workflow. The `Run ESLint` step runs the ESLint tool and outputs the `results.sarif` file. The workflow then uploads the `results.sarif` file to {% data variables.product.prodname_dotcom %} using the `upload-sarif` action. For more information about creating a workflow file, see "[Configuring a workflow](/actions/configuring-and-managing-workflows/configuring-a-workflow)." +The workflow shows an example of running the ESLint static analysis tool as a step in a workflow. The `Run ESLint` step runs the ESLint tool and outputs the `results.sarif` file. The workflow then uploads the `results.sarif` file to {% data variables.product.prodname_dotcom %} using the `upload-sarif` action. For more information about creating a workflow file, see "[Introduction to GitHub Actions](/actions/learn-github-actions/introduction-to-github-actions)." ```yml name: "ESLint analysis" @@ -109,6 +109,6 @@ jobs: ### 더 읽을거리 - "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions)" -- "[Managing a workflow run](/actions/configuring-and-managing-workflows/managing-a-workflow-run#viewing-your-workflow-history)" +- "[Viewing your workflow history](/actions/managing-workflow-runs/viewing-workflow-run-history)" - "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)" - "[Upload a SARIF file](/rest/reference/code-scanning#upload-a-sarif-file)" diff --git a/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md new file mode 100644 index 000000000000..af71f4047d5b --- /dev/null +++ b/translations/ko-KR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md @@ -0,0 +1,11 @@ +--- +title: Using CodeQL code scanning with your existing CI system +shortTitle: CodeQL CI system support +intro: 'The {% data variables.product.prodname_codeql_runner %} allows you to use your existing CI system to run {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %}.' +mapTopic: true +product: '{% data reusables.gated-features.code-scanning %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + diff --git a/translations/ko-KR/content/github/getting-started-with-github/create-a-repo.md b/translations/ko-KR/content/github/getting-started-with-github/create-a-repo.md index bb48559fd9a4..9fdce4d448e7 100644 --- a/translations/ko-KR/content/github/getting-started-with-github/create-a-repo.md +++ b/translations/ko-KR/content/github/getting-started-with-github/create-a-repo.md @@ -19,7 +19,9 @@ You can store a variety of projects in {% data variables.product.product_name %} {% 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 {% data variables.product.product_name %}." ![Field for entering a repository description](/assets/images/help/repository/create-repository-desc.png) +3. Optionally, add a description of your repository. For example, "My first repository on +{% data variables.product.product_name %}." + ![Field for entering a repository description](/assets/images/help/repository/create-repository-desc.png) {% data reusables.repositories.choose-repo-visibility %} {% data reusables.repositories.initialize-with-readme %} {% data reusables.repositories.create-repo %} diff --git a/translations/ko-KR/content/github/getting-started-with-github/fork-a-repo.md b/translations/ko-KR/content/github/getting-started-with-github/fork-a-repo.md index 2a7823434c1a..34009ccd5a33 100644 --- a/translations/ko-KR/content/github/getting-started-with-github/fork-a-repo.md +++ b/translations/ko-KR/content/github/getting-started-with-github/fork-a-repo.md @@ -61,7 +61,9 @@ If you haven't yet, you should first [set up Git](/articles/set-up-git). Don't f 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 {% data variables.product.product_name %}, navigate to **your fork** of the Spoon-Knife repository. +1. On + +{% data variables.product.product_name %}, navigate to **your fork** of the Spoon-Knife repository. {% data reusables.repositories.copy-clone-url %} {% data reusables.command_line.open_the_multi_os_terminal %} {% data reusables.command_line.change-current-directory-clone %} @@ -86,7 +88,9 @@ Now, you have a local copy of your fork of the 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 {% data variables.product.product_name %}, navigate to the [octocat/Spoon-Knife](https://github.com/octocat/Spoon-Knife) repository. +1. On + +{% data variables.product.product_name %}, navigate to the [octocat/Spoon-Knife](https://github.com/octocat/Spoon-Knife) repository. {% data reusables.repositories.copy-clone-url %} {% 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). diff --git a/translations/ko-KR/content/github/getting-started-with-github/github-for-mobile.md b/translations/ko-KR/content/github/getting-started-with-github/github-for-mobile.md index 7512a24f29f7..13c7f1b12830 100644 --- a/translations/ko-KR/content/github/getting-started-with-github/github-for-mobile.md +++ b/translations/ko-KR/content/github/getting-started-with-github/github-for-mobile.md @@ -23,6 +23,16 @@ For more information about notifications for {% data variables.product.prodname_ To install {% data variables.product.prodname_mobile %} for Android or iOS, see [{% data variables.product.prodname_mobile %}](https://github.com/mobile). +### Supported languages for {% data variables.product.prodname_mobile %} + +{% data variables.product.prodname_mobile %} is available in the following languages. + +- Japanese +- Brazilian Portuguese +- 스페인어 + +If you configure the language on your device to a supported language, {% data variables.product.prodname_mobile %} will default to the language. You can change the language for {% data variables.product.prodname_mobile %} in {% data variables.product.prodname_mobile %}'s **Settings** menu. + ### Managing Universal Links for {% data variables.product.prodname_mobile %} on iOS {% data variables.product.prodname_mobile %} automatically enables Universal Links for iOS. When you tap any {% data variables.product.product_name %} link, the destination URL will open in {% 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. diff --git a/translations/ko-KR/content/github/getting-started-with-github/githubs-products.md b/translations/ko-KR/content/github/getting-started-with-github/githubs-products.md index f379c92899bf..441315fb55b2 100644 --- a/translations/ko-KR/content/github/getting-started-with-github/githubs-products.md +++ b/translations/ko-KR/content/github/getting-started-with-github/githubs-products.md @@ -96,7 +96,7 @@ For more information about hosting your own instance of [{% data variables.produ - {% data variables.contact.github_support %} {% data variables.product.premium_plus_support_plan %} - {% data variables.product.prodname_insights %} -- {% data variables.product.prodname_advanced_security %} +- {% data variables.product.prodname_advanced_security %}{% if currentVersion == "free-pro-team@latest" %}. For more information, see "[About {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)" and "[About {% data variables.product.prodname_secret_scanning %}](/github/administering-a-repository/about-secret-scanning) (beta)."{% endif %}{% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %}. For more information, see "[About {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning) (beta)."{% endif %} - [{% data variables.product.prodname_learning %} for organizations](https://lab.github.com/organizations) For more information about signing up for {% data variables.product.prodname_ghe_one %}, contact [{% data variables.product.product_name %}'s Sales team](https://enterprise.github.com/contact). diff --git a/translations/ko-KR/content/github/getting-started-with-github/keyboard-shortcuts.md b/translations/ko-KR/content/github/getting-started-with-github/keyboard-shortcuts.md index ba8fdaa7a133..18ccfb83ed51 100644 --- a/translations/ko-KR/content/github/getting-started-with-github/keyboard-shortcuts.md +++ b/translations/ko-KR/content/github/getting-started-with-github/keyboard-shortcuts.md @@ -20,22 +20,22 @@ Below is a list of some of the available keyboard shortcuts. ### Site wide shortcuts -| Keyboard shortcut | 설명 | -| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| s or / | 검색 창 포커싱. For more information, see "[About searching on {% data variables.product.company_short %}](/articles/about-searching-on-github)." | +| Keyboard shortcut | 설명 | +| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| s or / | 검색 창 포커싱. For more information, see "[About searching on {% data variables.product.company_short %}](/articles/about-searching-on-github)." | | g n | 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 %}." | -| esc | When focused on a user, issue, or pull request hovercard, closes the hovercard and refocuses on the element the hovercard is in | +| esc | 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 | 설명 | -| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | -| g c | Go to the **Code** tab | -| g i | Go to the **Issues** tab. For more information, see "[About issues](/articles/about-issues)." | -| g p | Go to the **Pull requests** tab. For more information, see "[About pull requests](/articles/about-pull-requests)." | -| g a | Go to the **Actions** tab. For more information, see "[About Actions](/actions/getting-started-with-github-actions/about-github-actions)." | -| g b | Go to the **Projects** tab. For more information, see "[About project boards](/articles/about-project-boards)." | -| g w | Go to the **Wiki** tab. For more information, see "[About wikis](/articles/about-wikis)." | +| Keyboard shortcut | 설명 | +| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| g c | Go to the **Code** tab | +| g i | Go to the **Issues** tab. For more information, see "[About issues](/articles/about-issues)." | +| g p | Go to the **Pull requests** tab. For more information, see "[About pull requests](/articles/about-pull-requests)."{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} +| g a | Go to the **Actions** tab. For more information, see "[About Actions](/actions/getting-started-with-github-actions/about-github-actions)."{% endif %} +| g b | Go to the **Projects** tab. For more information, see "[About project boards](/articles/about-project-boards)." | +| g w | Go to the **Wiki** tab. For more information, see "[About wikis](/articles/about-wikis)." | ### Source code editing @@ -67,16 +67,16 @@ For more keyboard shortcuts, see the [CodeMirror documentation](https://codemirr ### Comments -| Keyboard shortcut | 설명 | -| --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| control b or command b | Inserts Markdown formatting for bolding text | -| control i or command i | Inserts Markdown formatting for italicizing text | -| control k or command k | Inserts Markdown formatting for creating a link | -| control shift p or command shift p | Toggles between the **Write** and **Preview** comment tabs | -| control enter | Submits a comment | +| Keyboard shortcut | 설명 | +| --------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| control b or command b | Inserts Markdown formatting for bolding text | +| control i or command i | Inserts Markdown formatting for italicizing text | +| control k or command k | Inserts Markdown formatting for creating a link | +| control shift p or command shift p | Toggles between the **Write** and **Preview** comment tabs | +| control enter | Submits a comment | | control . and then control [saved reply number] | 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" %} | control g or command g | Insert a suggestion. For more information, see "[Reviewing proposed changes in a pull request](/articles/reviewing-proposed-changes-in-a-pull-request)." |{% endif %} -| r | Quote the selected text in your reply. For more information, see "[Basic writing and formatting syntax](/articles/basic-writing-and-formatting-syntax#quoting-text)." | +| r | 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 @@ -92,13 +92,13 @@ For more keyboard shortcuts, see the [CodeMirror documentation](https://codemirr | o or enter | Open issue | ### Issues and pull requests -| Keyboard shortcut | 설명 | -| ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| q | Request a reviewer. For more information, see "[Requesting a pull request review](/articles/requesting-a-pull-request-review/)." | -| m | Set a milestone. For more information, see "[Associating milestones with issues and pull requests](/articles/associating-milestones-with-issues-and-pull-requests/)." | -| l | Apply a label. For more information, see "[Applying labels to issues and pull requests](/articles/applying-labels-to-issues-and-pull-requests/)." | +| Keyboard shortcut | 설명 | +| ------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| q | Request a reviewer. For more information, see "[Requesting a pull request review](/articles/requesting-a-pull-request-review/)." | +| m | Set a milestone. For more information, see "[Associating milestones with issues and pull requests](/articles/associating-milestones-with-issues-and-pull-requests/)." | +| l | Apply a label. For more information, see "[Applying labels to issues and pull requests](/articles/applying-labels-to-issues-and-pull-requests/)." | | a | Set an assignee. For more information, see "[Assigning issues and pull requests to other {% data variables.product.company_short %} users](/articles/assigning-issues-and-pull-requests-to-other-github-users/)." | -| cmd + shift + p or control + shift + p | Toggles between the **Write** and **Preview** tabs | +| cmd + shift + p or control + shift + p | Toggles between the **Write** and **Preview** tabs | ### Changes in pull requests diff --git a/translations/ko-KR/content/github/getting-started-with-github/saving-repositories-with-stars.md b/translations/ko-KR/content/github/getting-started-with-github/saving-repositories-with-stars.md index 50b584e57c01..d85feb1cfd7b 100644 --- a/translations/ko-KR/content/github/getting-started-with-github/saving-repositories-with-stars.md +++ b/translations/ko-KR/content/github/getting-started-with-github/saving-repositories-with-stars.md @@ -19,7 +19,8 @@ You can search, sort, and filter your starred repositories and topics on your {% 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 {% data variables.explore.your_stars_page %}. {% if currentVersion == "free-pro-team@latest" %} -You can star repositories and topics to discover similar projects on {% data variables.product.product_name %}. When you star repositories or topics, {% 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 {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)." +You can star repositories and topics to discover similar projects on +{% data variables.product.product_name %}. When you star repositories or topics, {% 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 {% 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 {% 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. diff --git a/translations/ko-KR/content/github/getting-started-with-github/types-of-github-accounts.md b/translations/ko-KR/content/github/getting-started-with-github/types-of-github-accounts.md index 0f377cf7ac56..d77e3ffcf5cc 100644 --- a/translations/ko-KR/content/github/getting-started-with-github/types-of-github-accounts.md +++ b/translations/ko-KR/content/github/getting-started-with-github/types-of-github-accounts.md @@ -13,7 +13,8 @@ versions: --- {% if currentVersion == "free-pro-team@latest" %} -For a full list of features for each {% data variables.product.product_name %} product, see "[{% data variables.product.prodname_dotcom %}'s products](/github/getting-started-with-github/githubs-products)." +For a full list of features for each +{% data variables.product.product_name %} product, see "[{% data variables.product.prodname_dotcom %}'s products](/github/getting-started-with-github/githubs-products)." {% endif %} ### Personal user accounts diff --git a/translations/ko-KR/content/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line.md b/translations/ko-KR/content/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line.md index fda72fa3eeee..f8910e819a6f 100644 --- a/translations/ko-KR/content/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line.md +++ b/translations/ko-KR/content/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line.md @@ -21,7 +21,10 @@ versions: {% mac %} -1. [Create a new repository](/articles/creating-a-new-repository) on {% data variables.product.product_location %}. To avoid errors, do not initialize the new repository with *README*, license, or `gitignore` files. You can add these files after your project has been pushed to {% data variables.product.product_name %}. ![Create New Repository drop-down](/assets/images/help/repository/repo-create.png) +1. [Create a new repository](/articles/creating-a-new-repository) on + +{% data variables.product.product_location %}. To avoid errors, do not initialize the new repository with *README*, license, or `gitignore` files. You can add these files after your project has been pushed to {% data variables.product.product_name %}. + ![Create New Repository drop-down](/assets/images/help/repository/repo-create.png) {% data reusables.command_line.open_the_multi_os_terminal %} 3. Change the current working directory to your local project. 4. Initialize the local directory as a Git repository. @@ -48,7 +51,7 @@ versions: ``` 9. [Push the changes](/articles/pushing-commits-to-a-remote-repository/) in your local repository to {% data variables.product.product_location %}. ```shell - $ git push -u origin master + $ git push -u origin main # Pushes the changes in your local repository up to the remote repository you specified as the origin ``` @@ -56,7 +59,10 @@ versions: {% windows %} -1. [Create a new repository](/articles/creating-a-new-repository) on {% data variables.product.product_location %}. To avoid errors, do not initialize the new repository with *README*, license, or `gitignore` files. You can add these files after your project has been pushed to {% data variables.product.product_name %}. ![Create New Repository drop-down](/assets/images/help/repository/repo-create.png) +1. [Create a new repository](/articles/creating-a-new-repository) on + +{% data variables.product.product_location %}. To avoid errors, do not initialize the new repository with *README*, license, or `gitignore` files. You can add these files after your project has been pushed to {% data variables.product.product_name %}. + ![Create New Repository drop-down](/assets/images/help/repository/repo-create.png) {% data reusables.command_line.open_the_multi_os_terminal %} 3. Change the current working directory to your local project. 4. Initialize the local directory as a Git repository. @@ -83,7 +89,7 @@ versions: ``` 9. [Push the changes](/articles/pushing-commits-to-a-remote-repository/) in your local repository to {% data variables.product.product_location %}. ```shell - $ git push origin master + $ git push origin main # Pushes the changes in your local repository up to the remote repository you specified as the origin ``` @@ -91,7 +97,10 @@ versions: {% linux %} -1. [Create a new repository](/articles/creating-a-new-repository) on {% data variables.product.product_location %}. To avoid errors, do not initialize the new repository with *README*, license, or `gitignore` files. You can add these files after your project has been pushed to {% data variables.product.product_name %}. ![Create New Repository drop-down](/assets/images/help/repository/repo-create.png) +1. [Create a new repository](/articles/creating-a-new-repository) on + +{% data variables.product.product_location %}. To avoid errors, do not initialize the new repository with *README*, license, or `gitignore` files. You can add these files after your project has been pushed to {% data variables.product.product_name %}. + ![Create New Repository drop-down](/assets/images/help/repository/repo-create.png) {% data reusables.command_line.open_the_multi_os_terminal %} 3. Change the current working directory to your local project. 4. Initialize the local directory as a Git repository. @@ -118,7 +127,7 @@ versions: ``` 9. [Push the changes](/articles/pushing-commits-to-a-remote-repository/) in your local repository to {% data variables.product.product_location %}. ```shell - $ git push origin master + $ git push origin main # Pushes the changes in your local repository up to the remote repository you specified as the origin ``` diff --git a/translations/ko-KR/content/github/importing-your-projects-to-github/support-for-subversion-clients.md b/translations/ko-KR/content/github/importing-your-projects-to-github/support-for-subversion-clients.md index 1fe67686746c..13d3119425a8 100644 --- a/translations/ko-KR/content/github/importing-your-projects-to-github/support-for-subversion-clients.md +++ b/translations/ko-KR/content/github/importing-your-projects-to-github/support-for-subversion-clients.md @@ -47,7 +47,7 @@ Subversion checkouts are different: they mix the repository data in the working You can also create branches using the Subversion bridge to GitHub. -From your svn client, make sure "master" is current by updating `trunk`: +From your svn client, make sure the default branch is current by updating `trunk`: ```shell $ svn up trunk > At revision 1. diff --git a/translations/ko-KR/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md b/translations/ko-KR/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md index 2564ba3fada3..1091c2d112a8 100644 --- a/translations/ko-KR/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md +++ b/translations/ko-KR/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md @@ -19,7 +19,9 @@ versions: {% data reusables.repositories.sensitive-info-warning %} -1. On your computer, move the file you'd like to upload to {% data variables.product.product_name %} into the local directory that was created when you cloned the repository. +1. On your computer, move the file you'd like to upload to + +{% data variables.product.product_name %} into the local directory that was created when you cloned the repository. {% data reusables.command_line.open_the_multi_os_terminal %} {% data reusables.command_line.switching_directories_procedural %} {% data reusables.git.stage_for_commit %} diff --git a/translations/ko-KR/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md b/translations/ko-KR/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md index b568024203f4..3853d361f5fa 100644 --- a/translations/ko-KR/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md +++ b/translations/ko-KR/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md @@ -20,7 +20,7 @@ versions: When viewing a file on {% data variables.product.product_location %}, you usually see the version at the current head of a branch. 예시: -* [https://github.com/github/hubot/blob/**master**/README.md](https://github.com/github/hubot/blob/master/README.md) +* [https://github.com/github/hubot/blob/**master**/README.md](https://github.com/github/codeql/blob/main/README.md) refers to GitHub's `hubot` repository, and shows the `master` branch's current version of the `README.md` file. @@ -30,7 +30,7 @@ The version of a file at the head of branch can change as new commits are made, For a permanent link to the specific version of a file that you see, instead of using a branch name in the URL (i.e. the `master` part in the example above), put a commit id. This will permanently link to the exact version of the file in that commit. 예시: -* [https://github.com/github/hubot/blob/**ed25584f5ac2520a6c28547ffd0961c7abd7ea49**/README.md](https://github.com/github/hubot/blob/ed25584f5ac2520a6c28547ffd0961c7abd7ea49/README.md) +* [https://github.com/github/hubot/blob/**ed25584f5ac2520a6c28547ffd0961c7abd7ea49**/README.md](https://github.com/github/codeql/blob/b212af08a6cffbb434f3c8a2795a579e092792fd/README.md) replaces `master` with a specific commit id and the file content will not change. diff --git a/translations/ko-KR/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md b/translations/ko-KR/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md index 4121385dec82..b786a5021a10 100644 --- a/translations/ko-KR/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md +++ b/translations/ko-KR/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md @@ -9,9 +9,9 @@ versions: --- -The interactive features of the notebook, such as custom JavaScript plots, will not work in your repository on {% data variables.product.product_location %}. For an example, see [*Linking and Interactions.ipynb*](https://github.com/bokeh/bokeh-notebooks/blob/master/tutorial/06%20-%20Linking%20and%20Interactions.ipynb). +The interactive features of the notebook, such as custom JavaScript plots, will not work in your repository on {% data variables.product.product_location %}. For an example, see [*Linking and Interactions.ipynb*](https://github.com/bokeh/bokeh-notebooks/blob/main/tutorial/06%20-%20Linking%20and%20Interactions.ipynb). -To view your Jupyter notebook with JavaScript content rendered or to share your notebook files with others you can use [nbviewer](https://nbviewer.jupyter.org/). For an example, see [*Linking and Interactions.ipynb*](https://nbviewer.jupyter.org/github/bokeh/bokeh-notebooks/blob/master/tutorial/06%20-%20Linking%20and%20Interactions.ipynb) rendered on nbviewer. +To view your Jupyter notebook with JavaScript content rendered or to share your notebook files with others you can use [nbviewer](https://nbviewer.jupyter.org/). For an example, see [*Linking and Interactions.ipynb*](https://nbviewer.jupyter.org/github/bokeh/bokeh-notebooks/blob/main/tutorial/06%20-%20Linking%20and%20Interactions.ipynb) rendered on nbviewer. To view a fully interactive version of your Jupyter Notebook, you can set up a notebook server locally. For more information, see [Jupyter's official documentation](http://jupyter.readthedocs.io/en/latest/index.html). diff --git a/translations/ko-KR/content/github/managing-large-files/about-git-large-file-storage.md b/translations/ko-KR/content/github/managing-large-files/about-git-large-file-storage.md index e38c8f6dd43c..ff9b1cd02225 100644 --- a/translations/ko-KR/content/github/managing-large-files/about-git-large-file-storage.md +++ b/translations/ko-KR/content/github/managing-large-files/about-git-large-file-storage.md @@ -12,16 +12,17 @@ versions: {% data variables.large_files.product_name_short %} handles large files by storing references to the file in the repository, but not the actual file itself. To work around Git's architecture, {% data variables.large_files.product_name_short %} creates a pointer file which acts as a reference to the actual file (which is stored somewhere else). {% data variables.product.product_name %} manages this pointer file in your repository. When you clone the repository down, {% data variables.product.product_name %} uses the pointer file as a map to go and find the large file for you. {% if currentVersion == "free-pro-team@latest" %} -Using {% data variables.large_files.product_name_short %}, you can store files up to: +Using +{% data variables.large_files.product_name_short %}, you can store files up to: -| 제품 | Maximum file size | -| ------------------------------------------------------ | ----------------- | +| 제품 | Maximum file size | +| ------------------------------------------------- | ----------------- | | {% data variables.product.prodname_free_user %} | 2 GB | | {% data variables.product.prodname_pro %} | 2 GB | | {% data variables.product.prodname_team %} | 4 GB | | {% data variables.product.prodname_ghe_cloud %} | 5 GB |{% else %} - Using {% data variables.large_files.product_name_short %}, you can store files up to -{% if currentVersion ver_lt "enterprise-server@2.21" %}{% data variables.large_files.max_lfs_size %}{% else %}5 GB{% endif %} in your repository. + Using +{% data variables.large_files.product_name_short %}, you can store files up to {% if currentVersion ver_lt "enterprise-server@2.21" %}{% data variables.large_files.max_lfs_size %}{% else %}5 GB{% endif %} in your repository. {% endif %} You can also use {% data variables.large_files.product_name_short %} with {% data variables.product.prodname_desktop %}. For more information about cloning Git LFS repositories in {% data variables.product.prodname_desktop %}, see "[Cloning a repository from GitHub to GitHub Desktop](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop)." diff --git a/translations/ko-KR/content/github/managing-large-files/about-storage-and-bandwidth-usage.md b/translations/ko-KR/content/github/managing-large-files/about-storage-and-bandwidth-usage.md index aeed07271284..3f93be6abaed 100644 --- a/translations/ko-KR/content/github/managing-large-files/about-storage-and-bandwidth-usage.md +++ b/translations/ko-KR/content/github/managing-large-files/about-storage-and-bandwidth-usage.md @@ -20,7 +20,8 @@ When you commit and push a change to a file tracked with {% data variables.large - If you download a 500 MB file that's tracked with LFS, you'll use 500 MB of the repository owner's allotted bandwidth. If a collaborator pushes a change to the file and you pull the new version to your local repository, you'll use another 500 MB of bandwidth, bringing the total usage for these two downloads to 1 GB of bandwidth. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -If {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in source code archives for your repository, downloads of those archives will count towards bandwidth usage for the repository. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)." +If +{% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in source code archives for your repository, downloads of those archives will count towards bandwidth usage for the repository. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)." {% endif %} {% tip %} diff --git a/translations/ko-KR/content/github/managing-large-files/installing-git-large-file-storage.md b/translations/ko-KR/content/github/managing-large-files/installing-git-large-file-storage.md index 4b734bf2c42b..1c7694299ce3 100644 --- a/translations/ko-KR/content/github/managing-large-files/installing-git-large-file-storage.md +++ b/translations/ko-KR/content/github/managing-large-files/installing-git-large-file-storage.md @@ -57,7 +57,8 @@ versions: {% endtip %} 2. On your computer, locate the downloaded file. -3. Double click on the file called *git-lfs-windows-1.X.X.exe*, where 1.X.X is replaced with the Git LFS version you downloaded. When you open this file Windows will run a setup wizard to install {% data variables.large_files.product_name_short %}. +3. Double click on the file called *git-lfs-windows-1.X.X.exe*, where 1.X.X is replaced with the Git LFS version you downloaded. When you open this file Windows will run a setup wizard to install +{% data variables.large_files.product_name_short %}. {% data reusables.command_line.open_the_multi_os_terminal %} 5. Verify that the installation was successful: ```shell diff --git a/translations/ko-KR/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md b/translations/ko-KR/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md index 3c75bb35149b..53709021f129 100644 --- a/translations/ko-KR/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md +++ b/translations/ko-KR/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md @@ -49,12 +49,13 @@ You can also enable or disable {% data variables.product.prodname_dependabot %} {% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -When {% data variables.product.product_name %} identifies a vulnerable dependency, we send a {% data variables.product.prodname_dependabot_short %} alert to the maintainers of affected repositories with details of the vulnerability, a link to the affected file in the project, and information about a fixed version. -{% if currentVersion == "free-pro-team@latest" %}For repositories that have enabled {% data variables.product.prodname_dependabot_security_updates %}, the alert also contains a link to a pull request to update the manifest or lock file to the minimum version that resolves the vulnerability. For more information, see "[Configuring {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)."{% endif %} +When +{% data variables.product.product_name %} identifies a vulnerable dependency, we send a {% data variables.product.prodname_dependabot_short %} alert to the maintainers of affected repositories with details of the vulnerability, a link to the affected file in the project, and information about a fixed version. {% if currentVersion == "free-pro-team@latest" %}For repositories that have enabled {% data variables.product.prodname_dependabot_security_updates %}, the alert also contains a link to a pull request to update the manifest or lock file to the minimum version that resolves the vulnerability. For more information, see "[Configuring {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)."{% endif %} {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %} -When {% data variables.product.product_name %} identifies a vulnerable dependency, we send a security alert to the maintainers of affected repositories with details of the vulnerability, a link to the affected file in the project, and information about a fixed version. +When +{% data variables.product.product_name %} identifies a vulnerable dependency, we send a security alert to the maintainers of affected repositories with details of the vulnerability, a link to the affected file in the project, and information about a fixed version. {% endif %} {% warning %} @@ -68,30 +69,35 @@ When {% data variables.product.product_name %} identifies a vulnerable dependenc You can see all of the alerts that affect a particular project{% if currentVersion == "free-pro-team@latest" %} on the repository's Security tab or{% endif %} in the repository's dependency graph.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[Viewing and updating vulnerable dependencies in your repository](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository)."{% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -We send {% data variables.product.prodname_dependabot_short %} alerts to people with admin permissions in the affected repositories by default. {% data variables.product.product_name %} never publicly discloses identified vulnerabilities for any repository. -{% if currentVersion == "free-pro-team@latest" %} You can also enable {% data variables.product.prodname_dependabot_short %} alerts for additional people or teams working repositories that you own or have admin permissions for. For more information, see "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-github-dependabot-alerts)."{% endif %} +We send +{% data variables.product.prodname_dependabot_short %} alerts to people with admin permissions in the affected repositories by default. {% data variables.product.product_name %} never publicly discloses identified vulnerabilities for any repository.{% if currentVersion == "free-pro-team@latest" %} You can also enable {% data variables.product.prodname_dependabot_short %} alerts for additional people or teams working repositories that you own or have admin permissions for. For more information, see "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-github-dependabot-alerts)."{% endif %} {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %} -We send security alerts to people with admin permissions in the affected repositories by default. {% data variables.product.product_name %} never publicly discloses identified vulnerabilities for any repository. +We send security alerts to people with admin permissions in the affected repositories by default. +{% data variables.product.product_name %} never publicly discloses identified vulnerabilities for any repository. {% endif %} ### Configuring notifications for {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} {% if currentVersion == "free-pro-team@latest" %} -By default, you will receive {% data variables.product.prodname_dependabot_alerts %} by email, grouped by the specific vulnerability. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-options)." +By default, you will receive +{% data variables.product.prodname_dependabot_alerts %} by email, grouped by the specific vulnerability. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-notification-options)." {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %} -By default, if your site administrator has configured email for notifications on your instance, you will receive {% data variables.product.prodname_dependabot_alerts %} by email. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-options)." +By default, if your site administrator has configured email for notifications on your instance, you will receive +{% data variables.product.prodname_dependabot_alerts %} by email. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-notification-options)." {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion == "enterprise-server@2.21" %} -By default, if your site administrator has configured email for notifications on your instance, you will receive security alerts by email. You can also choose to receive security alerts in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#security-alert-options)." +By default, if your site administrator has configured email for notifications on your instance, you will receive security alerts by email. You can also choose to receive security alerts in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the +{% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#security-alert-notification-options)." {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.21" %} -By default, if your site administrator has configured email for notifications on your instance, you will receive security alerts by email. You can also choose to receive security alerts in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Choosing the delivery method for your notifications ](/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications)." +By default, if your site administrator has configured email for notifications on your instance, you will receive security alerts by email. You can also choose to receive security alerts in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the +{% data variables.product.product_name %} user interface. For more information, see "[Choosing the delivery method for your notifications ](/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications)." {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.20" % %} diff --git a/translations/ko-KR/content/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates.md b/translations/ko-KR/content/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates.md index c59107213859..06b60a9a3ffc 100644 --- a/translations/ko-KR/content/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates.md +++ b/translations/ko-KR/content/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates.md @@ -23,7 +23,7 @@ When you merge a pull request that contains a security update, the corresponding {% note %} -**Note** +**참고** {% data variables.product.prodname_dependabot_security_updates %} only resolve security vulnerabilities in the dependencies tracked by your dependency graph. Security updates are not created to resolve vulnerabilities in private registries or packages hosted in private repositories. However, indirect or transitive dependencies are included if they are explicitly defined in a lock file, or similar. For more information, see "[About the dependency graph](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)." Additionally, it's important to highlight that {% data variables.product.prodname_dependabot_security_updates %} automatically create pulls requests with proposed fixes to the lock files, for the dependencies detected as vulnerable. {% endnote %} @@ -42,14 +42,14 @@ You can enable {% data variables.product.prodname_dependabot_security_updates %} {% endnote %} -| Automatic enablement prerequisite | More information | -| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Repository is not a fork | "[About forks](/github/collaborating-with-issues-and-pull-requests/about-forks)" | -| Repository is not archived | "[Archiving repositories](/github/creating-cloning-and-archiving-repositories/archiving-repositories)" | +| Automatic enablement prerequisite | More information | +| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Repository is not a fork | "[About forks](/github/collaborating-with-issues-and-pull-requests/about-forks)" | +| Repository is not archived | "[Archiving repositories](/github/creating-cloning-and-archiving-repositories/archiving-repositories)" | | Repository is public, or repository is private and you have enabled read-only analysis by {% data variables.product.prodname_dotcom %}, dependency graph, and vulnerability alerts in the repository's settings | "[Managing data use settings for your private repository](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository)." | | Repository contains dependency manifest file from a package ecosystem that {% data variables.product.prodname_dotcom %} supports | "[Supported package ecosystems](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph#supported-package-ecosystems)" | -| {% data variables.product.prodname_dependabot_security_updates %} are not disabled for the repository | "[Managing {% data variables.product.prodname_dependabot_security_updates %} for your repository](#managing-github-dependabot-security-updates-for-your-repositories)" | -| Repository is not already using an integration for dependency management | "[About integrations](/github/customizing-your-github-workflow/about-integrations)" | +| {% data variables.product.prodname_dependabot_security_updates %} are not disabled for the repository | "[Managing {% data variables.product.prodname_dependabot_security_updates %} for your repository](#managing-github-dependabot-security-updates-for-your-repositories)" | +| Repository is not already using an integration for dependency management | "[About integrations](/github/customizing-your-github-workflow/about-integrations)" | If security updates are not enabled for your repository and you don't know why, first try enabling them using the instructions given in the procedural sections below. If security updates are still not working, you can [contact support](https://support.github.com/contact). diff --git a/translations/ko-KR/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md b/translations/ko-KR/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md index 217afbb26ed9..f8d2be9fcb00 100644 --- a/translations/ko-KR/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md +++ b/translations/ko-KR/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md @@ -53,7 +53,8 @@ To keep your subscriptions manageable, review your subscriptions and watched rep To customize how you'd like to receive updates for specific pull requests or issues, you can configure your preferences within the issue or pull request. For more information, see “[Triaging a single notification](/github/managing-subscriptions-and-notifications-on-github/triaging-a-single-notification#customizing-when-to-receive-future-updates-for-an-issue-or-pull-request).” {% if currentVersion == "free-pro-team@latest" %} -You can enable push notifications in the {% data variables.product.prodname_mobile %} app. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#enabling-push-notifications-with-github-for-mobile)." +You can enable push notifications in the +{% data variables.product.prodname_mobile %} app. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#enabling-push-notifications-with-github-for-mobile)." {% endif %} ### Reasons for receiving notifications diff --git a/translations/ko-KR/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md b/translations/ko-KR/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md index 2f40ee2a037f..3ffc67fcc2e5 100644 --- a/translations/ko-KR/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md +++ b/translations/ko-KR/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md @@ -44,7 +44,8 @@ The notifications inbox on {% data variables.product.product_name %}{% if curren - Group notifications in your inbox by repository or date to get a quick overview with less context switching {% if currentVersion == "free-pro-team@latest" %} -In addition, the notifications inbox on {% data variables.product.prodname_mobile %} allows you to triage notifications in dark mode and receive push notifications for direct mentions. For more information, see "[Enabling push notifications with GitHub for mobile](#enabling-push-notifications-with-github-for-mobile)" or "[GitHub for mobile](/github/getting-started-with-github/github-for-mobile)." +In addition, the notifications inbox on +{% data variables.product.prodname_mobile %} allows you to triage notifications in dark mode and receive push notifications for direct mentions. For more information, see "[Enabling push notifications with GitHub for mobile](#enabling-push-notifications-with-github-for-mobile)" or "[GitHub for mobile](/github/getting-started-with-github/github-for-mobile)." {% endif %} #### Benefits of using an email client for notifications @@ -105,10 +106,10 @@ If you believe you're receiving notifications that don't belong to you, examine Email notifications from {% data variables.product.product_name %} contain the following header information: -| Header | Information | -| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `From` address | This address will always be {% if currentVersion == "free-pro-team@latest" %}'`notifications@github.com`'{% else %}'the no-reply email address configured by your site administrator'{% endif %}. | -| `To` field | This field connects directly to the thread. If you reply to the email, you'll add a new comment to the conversation. | +| Header | Information | +| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `From` address | This address will always be {% if currentVersion == "free-pro-team@latest" %}'`notifications@github.com`'{% else %}'the no-reply email address configured by your site administrator'{% endif %}. | +| `To` field | This field connects directly to the thread. If you reply to the email, you'll add a new comment to the conversation. | | `Cc` address | {% data variables.product.product_name %} will `Cc` you if you're subscribed to a conversation. The second `Cc` email address matches the notification reason. The suffix for these notification reasons is {% data variables.notifications.cc_address %}. The possible notification reasons are:
    • `assign`: You were assigned to an issue or pull request.
    • `author`: You created an issue or pull request.
    • `comment`: You commented on an issue or pull request.
    • `manual`: There was an update to an issue or pull request you manually subscribed to.
    • `mention`: You were mentioned on an issue or pull request.
    • `push`: Someone committed to a pull request you're subscribed to.
    • `review_requested`: You or a team you're a member of was requested to review a pull request.
    • `security_alert`: {% data variables.product.prodname_dotcom %} detected a vulnerability in a repository you receive alerts for.
    • `state_change`: An issue or pull request you're subscribed to was either closed or opened.
    • `subscribed`: There was an update in a repository you're watching.
    • `team_mention`: A team you belong to was mentioned on an issue or pull request.
    • `your_activity`: You opened, commented on, or closed an issue or pull request.
    | | `mailing list` field | This field identifies the name of the repository and its owner. The format of this address is always `..{% data variables.command_line.backticks %}`. |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" % %} | `X-GitHub-Severity` field | {% data reusables.repositories.security-alerts-x-github-severity %} The possible severity levels are:
    • `low`
    • `moderate`
    • `high`
    • `critical`
    For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." |{% endif %} @@ -120,8 +121,8 @@ Email notifications from {% data variables.product.product_name %} contain the f 3. On the notifications settings page, choose how you receive notifications when: - There are updates in repositories or team discussions you're watching or in a conversation you're participating in. For more information, see "[About participating and watching notifications](#about-participating-and-watching-notifications)." - You gain access to a new repository or you've joined a new team. For more information, see "[Automatic watching](#automatic-watching)."{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} - - There are new {% data variables.product.prodname_dependabot_alerts %} in your repository. For more information, see "[{% data variables.product.prodname_dependabot_alerts %} options](#github-dependabot-alerts-options)." {% endif %}{% if currentVersion == "enterprise-server@2.21" %} - - There are new security alerts in your repository. For more information, see "[Security alert options](#security-alert-options)." {% endif %} {% if currentVersion == "free-pro-team@latest" %} + - There are new {% data variables.product.prodname_dependabot_alerts %} in your repository. For more information, see "[{% data variables.product.prodname_dependabot_alerts %} notification options](#github-dependabot-alerts-notification-options)." {% endif %}{% if currentVersion == "enterprise-server@2.21" %} + - There are new security alerts in your repository. For more information, see "[Security alert notification options](#security-alert-notification-options)." {% endif %} {% if currentVersion == "free-pro-team@latest" %} - There are workflow runs updates on repositories set up with {% data variables.product.prodname_actions %}. For more information, see "[{% data variables.product.prodname_actions %} notification options](#github-actions-notification-options)."{% endif %} ### Automatic watching @@ -157,9 +158,9 @@ If you are a member of more than one organization, you can configure each one to ![Switching your per-org email address](/assets/images/help/notifications/notifications_switching_org_email.gif) {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -### {% data variables.product.prodname_dependabot_alerts %} options +### {% data variables.product.prodname_dependabot_alerts %} notification options {% else %} -### Security alert options +### Security alert notification options {% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}Choose how you want to receive {% data variables.product.prodname_dependabot_alerts %} for repositories that you are watching. You can receive {% data variables.product.prodname_dependabot_alerts %} in your inbox, as a banner on {% data variables.product.product_name %}, on the command line, through email, or some combination of these options. @@ -176,6 +177,12 @@ If you want to receive security alerts by email, choose whether you want a weekl ![Security alerts options](/assets/images/help/notifications-v2/security-alerts-options.png) {% endif %} +{% note %} + +**Note:** You can filter your {% data variables.product.company_short %} inbox notifications by {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %} security{% endif %} alerts. For more information, see "[Managing notifications from your inbox](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox#supported-queries-for-custom-filters)." + +{% endnote %} + {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} ### {% data variables.product.prodname_actions %} notification options diff --git a/translations/ko-KR/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md b/translations/ko-KR/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md index 018143d0e1ac..d5593a412eb2 100644 --- a/translations/ko-KR/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md +++ b/translations/ko-KR/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md @@ -19,7 +19,6 @@ To access your notifications inbox, in the upper-right corner of any page, click ![Notification indicating any unread message](/assets/images/help/notifications/notifications_general_existence_indicator.png) - Your inbox shows all of the notifications that you haven't unsubscribed to or marked as **Done.** You can customize your inbox to best suit your workflow using filters, viewing all or just unread notifications, and grouping your notifications to get a quick overview. ![inbox view](/assets/images/help/notifications-v2/inbox-view.png) @@ -113,7 +112,7 @@ To filter notifications by why you've received an update, you can use the `reaso #### Supported `is:` queries -To filter notifications for specific activity on {% data variables.product.product_name %}, you can use the `is` query. For example, to only see repository invitation updates, use `is:repository-invitation`. +To filter notifications for specific activity on {% data variables.product.product_name %}, you can use the `is` query. For example, to only see repository invitation updates, use `is:repository-invitation`, and to only see {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %} security{% endif %} alerts, use `is:repository-vulnerability-alert`. - `is:check-suite` - `is:commit` diff --git a/translations/ko-KR/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md b/translations/ko-KR/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md index c7c5e7043813..d42d42257ab2 100644 --- a/translations/ko-KR/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md +++ b/translations/ko-KR/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md @@ -22,15 +22,15 @@ If you create an invalid URL using query parameters, or if you don’t have the ### Supported query parameters -| Query parameter | 예시 | -| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `본문` | `https://github.com/octo-org/octo-repo/compare/master...pull-request-test?quick_pull=1&body=Fixes+the+problem.` creates a pull request, comparing the branches `master` and `pull-request-test`, with the comment "Fixes the problem" in the pull request body. | -| `title` | `https://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report` creates an issue with the label "bug" and title "New bug report." | -| `labels` | `https://github.com/octo-org/octo-repo/compare/master...pull-request-test?quick_pull=1&labels=bug` creates a pull request, comparing the branches `master` and `pull-request-test`, with the label "bug." | -| `템플릿` | `https://github.com/octo-org/octo-repo/issues/new?template=issue_template.md` creates an issue with a template in the issue body. | -| `마일스톤` | `https://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones` creates an issue with the milestone "testing milestones." | -| `assignees` | `https://github.com/octo-org/octo-repo/issues/new?assignees=octocat` creates an issue and assigns it to @octocat. | -| `projects` | `https://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1` creates an issue with the title "Bug fix" and adds it to the organization's project board 1. | +| Query parameter | 예시 | +| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `본문` | `https://github.com/octo-org/octo-repo/compare/main...pull-request-test?quick_pull=1&body=Fixes+the+problem.` creates a pull request, comparing the branches `main` and `pull-request-test`, with the comment "Fixes the problem" in the pull request body. | +| `title` | `https://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report` creates an issue with the label "bug" and title "New bug report." | +| `labels` | `https://github.com/octo-org/octo-repo/compare/main...pull-request-test?quick_pull=1&labels=bug` creates a pull request, comparing the branches `main` and `pull-request-test`, with the label "bug." | +| `템플릿` | `https://github.com/octo-org/octo-repo/issues/new?template=issue_template.md` creates an issue with a template in the issue body. | +| `마일스톤` | `https://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones` creates an issue with the milestone "testing milestones." | +| `assignees` | `https://github.com/octo-org/octo-repo/issues/new?assignees=octocat` creates an issue and assigns it to @octocat. | +| `projects` | `https://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1` creates an issue with the title "Bug fix" and adds it to the organization's project board 1. | ### Filling issues and pull requests with custom templates diff --git a/translations/ko-KR/content/github/managing-your-work-on-github/about-issues.md b/translations/ko-KR/content/github/managing-your-work-on-github/about-issues.md index 3671d8676ab0..46fb6199d356 100644 --- a/translations/ko-KR/content/github/managing-your-work-on-github/about-issues.md +++ b/translations/ko-KR/content/github/managing-your-work-on-github/about-issues.md @@ -3,7 +3,7 @@ title: About issues intro: 'Use issues to track ideas, enhancements, tasks, or bugs for work on {% data variables.product.product_name %}.' redirect_from: - /articles/creating-issues/ - - /articles/about-issues + - /articles/about-issues/ versions: free-pro-team: '*' enterprise-server: '*' @@ -22,8 +22,8 @@ To quickly find links to recently updated issues you're subscribed to, visit you With issues, you can: - Track and prioritize your work using project boards. For more information, see "[Using project boards](/articles/about-project-boards)." - Create new issues to track out-of-scope feedback from a comment in an issue or a pull request review. For more information, see "[Opening an issue from a comment](/github/managing-your-work-on-github/opening-an-issue-from-a-comment)." -- Create issue templates to help contributors open meaningful issues. For more information, see "[About issue and pull request templates](/articles/about-issue-and-pull-request-templates)."{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -- Transfer open issues to other repositories. For more information, see "[Transferring an issue to another repository](/articles/transferring-an-issue-to-another-repository)."{% endif %} +- Create issue templates to help contributors open meaningful issues. For more information, see "[About issue and pull request templates](/articles/about-issue-and-pull-request-templates)." +- Transfer open issues to other repositories. For more information, see "[Transferring an issue to another repository](/articles/transferring-an-issue-to-another-repository)." - Pin important issues to make them easier to find, preventing duplicate issues and reducing noise. For more information, see "[Pinning an issue to your repository](/articles/pinning-an-issue-to-your-repository)." - Track duplicate issues using saved replies. For more information, see "[About saved replies](/articles/about-saved-replies)."{% if currentVersion == "free-pro-team@latest" %} - Report comments that violate {% data variables.product.prodname_dotcom %}'s [Community Guidelines](/articles/github-community-guidelines). For more information, see "[Reporting abuse or spam](/articles/reporting-abuse-or-spam)."{% endif %} diff --git a/translations/ko-KR/content/github/managing-your-work-on-github/about-labels.md b/translations/ko-KR/content/github/managing-your-work-on-github/about-labels.md index fd40f7ff1cb5..c56f8568d494 100644 --- a/translations/ko-KR/content/github/managing-your-work-on-github/about-labels.md +++ b/translations/ko-KR/content/github/managing-your-work-on-github/about-labels.md @@ -16,17 +16,17 @@ Anyone with read access to a repository can view and search the repository’s l {% data variables.product.product_name %} provides default labels in every new repository. You can use these default labels to help create a standard workflow in a repository: -| Label | 설명 | -| ------------------ | --------------------------------------------------------------------------------------------------------------------- | -| `bug` | Indicates an unexpected problem or unintended behavior{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| `문서` | Indicates a need for improvements or additions to documentation{% endif %} -| `duplicate` | Indicates similar issues or pull requests | -| `enhancement` | Indicates new feature requests | -| `good first issue` | Indicates a good issue for first-time contributors | -| `help wanted` | Indicates that a maintainer wants help on an issue or pull request | -| `invalid` | Indicates that an issue or pull request is no longer relevant | -| `question` | Indicates that an issue or pull request needs more information | -| `wontfix` | Indicates that work won't continue on an issue or pull request | +| Label | 설명 | +| ------------------ | ------------------------------------------------------------------ | +| `bug` | Indicates an unexpected problem or unintended behavior | +| `문서` | Indicates a need for improvements or additions to documentation | +| `duplicate` | Indicates similar issues or pull requests | +| `enhancement` | Indicates new feature requests | +| `good first issue` | Indicates a good issue for first-time contributors | +| `help wanted` | Indicates that a maintainer wants help on an issue or pull request | +| `invalid` | Indicates that an issue or pull request is no longer relevant | +| `question` | Indicates that an issue or pull request needs more information | +| `wontfix` | Indicates that work won't continue on an issue or pull request | Default labels are included in every new repository when the repository is created, but you can edit or delete the labels later. For more information, see "[Deleting a label](/articles/deleting-a-label/)." diff --git a/translations/ko-KR/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md b/translations/ko-KR/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md index d4ddcc2bf04d..607f4e8d13f0 100644 --- a/translations/ko-KR/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md +++ b/translations/ko-KR/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md @@ -54,15 +54,8 @@ You can put a maximum of 2,500 cards into each project column. If a column has r 1. On the right side of an issue or pull request, click **Projects {% octicon "gear" aria-label="The Gear icon" %}**. ![Project board button in sidebar](/assets/images/help/projects/sidebar-project.png) 2. Click the **Recent**, **Repository**,**User**, or **Organization** tab for the project board you would like to add to. ![Recent, Repository and Organization tabs](/assets/images/help/projects/sidebar-project-tabs.png) 3. Type the name of the project in **Filter projects** field. ![Project board search box](/assets/images/help/projects/sidebar-search-project.png) -4. Select one or more project boards where you want to add the issue or pull request. ![Selected project board](/assets/images/help/projects/sidebar-select-project.png){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -5. Click -{% octicon "triangle-down" aria-label="The down triangle icon" %}, then click the column where you want your issue or pull request. The card will move to the bottom of the project board column you select. - ![Move card to column menu](/assets/images/help/projects/sidebar-select-project-board-column-menu.png) -{% else %} -5. On the right side of an issue or pull request, click **PROJECT-BOARD-NAME (awaiting triage)**. ![Link to project board](/assets/images/help/projects/sidebar-project-board-link.png) -6. In your project board, click **{% octicon "plus" aria-label="The Plus icon" %} Add cards (1 new)**. ![Add cards button](/assets/images/help/projects/add-cards-pending-button.png) -7. Drag the card for your issue or pull request from the **Triage** section, to the desired column on the project board. Alternatively, you can move cards using keyboard shortcuts. {% data reusables.project-management.for-more-info-project-keyboard-shortcuts %} -{% endif %} +4. Select one or more project boards where you want to add the issue or pull request. ![Selected project board](/assets/images/help/projects/sidebar-select-project.png) +5. Click {% octicon "triangle-down" aria-label="The down triangle icon" %}, then click the column where you want your issue or pull request. The card will move to the bottom of the project board column you select. ![Move card to column menu](/assets/images/help/projects/sidebar-select-project-board-column-menu.png) ### 더 읽을거리 diff --git a/translations/ko-KR/content/github/managing-your-work-on-github/applying-labels-to-issues-and-pull-requests.md b/translations/ko-KR/content/github/managing-your-work-on-github/applying-labels-to-issues-and-pull-requests.md index 06feaa4fbbdb..ccc39f7a0b2a 100644 --- a/translations/ko-KR/content/github/managing-your-work-on-github/applying-labels-to-issues-and-pull-requests.md +++ b/translations/ko-KR/content/github/managing-your-work-on-github/applying-labels-to-issues-and-pull-requests.md @@ -18,7 +18,8 @@ versions: {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issue-pr %} {% data reusables.repositories.select-items-in-issue-or-pr-list %} -4. In the upper-right corner, click **Label**, then start typing the name of an existing label. Click the label's name to associate it with the selected items. ![Issues Milestone assignment drop-down](/assets/images/help/issues/issues_applying_labels_dropdown.png) +4. In the upper-right corner, click **Label**, then start typing the name of an existing label. Click the label's name to associate it with the selected items. You can also apply a label in the Labels drop-down menu within an issue or pull request. ![Issues Milestone assignment drop-down](/assets/images/help/issues/issues_applying_labels_dropdown.png) + ### 더 읽을거리 diff --git a/translations/ko-KR/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md b/translations/ko-KR/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md index ef3d35c8f7d5..00cf32af6d36 100644 --- a/translations/ko-KR/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md +++ b/translations/ko-KR/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md @@ -10,7 +10,7 @@ versions: Anyone with write permissions to a repository can assign issues and pull requests. -You can assign up to 10 people to each issue or pull request, including yourself,{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} anyone who has commented on the issue or pull request,{% endif %} anyone with write permissions to the repository, and organization members with read permissions to the repository. For more information, see "[Access permissions on {% data variables.product.prodname_dotcom %}](/articles/access-permissions-on-github)." +You can assign up to 10 people to each issue or pull request, including yourself, anyone who has commented on the issue or pull request, anyone with write permissions to the repository, and organization members with read permissions to the repository. For more information, see "[Access permissions on {% data variables.product.prodname_dotcom %}](/articles/access-permissions-on-github)." {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issue-pr %} diff --git a/translations/ko-KR/content/github/managing-your-work-on-github/disabling-issues.md b/translations/ko-KR/content/github/managing-your-work-on-github/disabling-issues.md index 7caaf9d773b1..ce7933580dcd 100644 --- a/translations/ko-KR/content/github/managing-your-work-on-github/disabling-issues.md +++ b/translations/ko-KR/content/github/managing-your-work-on-github/disabling-issues.md @@ -17,8 +17,9 @@ If you decide to enable issues again in the future, any issues that were previou {% if currentVersion == "free-pro-team@latest" %} {% tip %} +Please contact -Please contact {% data variables.contact.contact_support %} if you want to turn off issues because of abuse from strangers. +{% data variables.contact.contact_support %} if you want to turn off issues because of abuse from strangers. {% data reusables.policies.abuse %} {% endtip %} diff --git a/translations/ko-KR/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md b/translations/ko-KR/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md index f18046f38511..694ed612ac01 100644 --- a/translations/ko-KR/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md +++ b/translations/ko-KR/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md @@ -8,14 +8,14 @@ versions: enterprise-server: '*' --- -On a card, you can click any assignee{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}, milestone,{% endif %} or label to filter the project board by that qualifier. To clear the search, you can click the same assignee{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}, milestone,{% endif %} or label again. +On a card, you can click any assignee, milestone, or label to filter the project board by that qualifier. To clear the search, you can click the same assignee, milestone, or label again. You can also use the "Filter cards" search bar at the top of each project board to search for cards. You can filter cards using the following search qualifiers in any combination, or by simply typing some text you'd like to search for. - Filter cards by author using `author:USERNAME` - Filter cards by assignee using `assignee:USERNAME` or `no:assignee` -- Filter cards by label using `label:LABEL`, `label:"MULTI-WORD LABEL NAME"`, or `no:label`{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -- Filter by milestone by using `milestone:MY-MILESTONE`{% endif %} +- Filter cards by label using `label:LABEL`, `label:"MULTI-WORD LABEL NAME"`, or `no:label` +- Filter by milestone by using `milestone:MY-MILESTONE` - Filter cards by state using `state:open`, `state:closed`, or `state:merged` - Filter by review status using `review:none`, `review:required`, `review:approved`, or `review:changes_requested` - Filter by check status using `status:pending`, `status:success`, or `status:failure` diff --git a/translations/ko-KR/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md b/translations/ko-KR/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md index f6ce5e97438b..bf969eb838e0 100644 --- a/translations/ko-KR/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md +++ b/translations/ko-KR/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md @@ -11,13 +11,17 @@ versions: enterprise-server: '*' --- +{% note %} + +**Note:** The special keywords in a pull request description are interpreted when the pull request targets the repository's *default* branch. However, if the PR's base is *any other branch*, then these keywords are ignored, no links are created and merging the PR has no effect on the issues. **If you want to link a pull request to an issue using a keyword, the PR must be on the default branch.** + +{% endnote %} + ### About linked issues and pull requests You can link an issue to a pull request {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}manually or {% endif %}using a supported keyword in the pull request description. -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -When you link a pull request to the issue the pull request addresses, collaborators can see that someone is working on the issue. -{% if currentVersion ver_lt "enterprise-server@2.21" %}If the pull request and the issue are in different repositories, {% data variables.product.product_name %} will display the link after the pull request is merged, if the person who merges the pull request also has permission to close the issue.{% endif %}{% endif %} +When you link a pull request to the issue the pull request addresses, collaborators can see that someone is working on the issue. {% if currentVersion ver_lt "enterprise-server@2.21" %}If the pull request and the issue are in different repositories, {% data variables.product.product_name %} will display the link after the pull request is merged, if the person who merges the pull request also has permission to close the issue.{% endif %} When you merge a linked pull request into the default branch of a repository, its linked issue is automatically closed. For more information about the default branch, see "[Setting the default branch](/github/administering-a-repository/setting-the-default-branch)." @@ -37,7 +41,7 @@ You can manually link up to ten issues to each pull request. The issue and pull ### Linking a pull request to an issue using a keyword -You can link a pull request to an issue by using a supported keyword in the pull request's description. +You can link a pull request to an issue by using a supported keyword in the pull request's description or in a commit message (please note that the pull request must be on the default branch). * close * closes @@ -59,7 +63,7 @@ The syntax for closing keywords depends on whether the issue is in the same repo {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}Only manually linked pull requests can be manually unlinked. To unlink an issue that you linked using a keyword, you must edit the pull request description to remove the keyword.{% endif %} -You can also use closing keywords in a commit message. The issue will be closed when you merge the commit into the default branch{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, but the pull request that contains the commit will not be listed as a linked pull request{% endif %}. +You can also use closing keywords in a commit message. The issue will be closed when you merge the commit into the default branch, but the pull request that contains the commit will not be listed as a linked pull request. ### 더 읽을거리 diff --git a/translations/ko-KR/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md b/translations/ko-KR/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md index 7c1565a5f61a..a7acab9120ff 100644 --- a/translations/ko-KR/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md +++ b/translations/ko-KR/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md @@ -5,14 +5,14 @@ redirect_from: - /articles/transferring-an-issue-to-another-repository versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- To transfer an open issue to another repository, you must have write permissions on the repository the issue is in and the repository you're transferring the issue to. For more information, see "[Repository permission levels for an organization](/articles/repository-permission-levels-for-an-organization)." You can only transfer issues between repositories owned by the same user or organization account. You can't transfer an issue from a private repository to a public repository. -When you transfer an issue, comments and assignees are retained. The issue's labels{% if currentVersion ver_lt "enterprise-server@2.19" %}, projects,{% endif %} and milestones are not retained.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} This issue will stay on any user-owned or organization-wide project boards and be removed from any repository project boards. For more information, see "[About project boards](/articles/about-project-boards)."{% endif %} +When you transfer an issue, comments and assignees are retained. The issue's labels and milestones are not retained. This issue will stay on any user-owned or organization-wide project boards and be removed from any repository project boards. For more information, see "[About project boards](/articles/about-project-boards)." People or teams who are mentioned in the issue will receive a notification letting them know that the issue has been transferred to a new repository. The original URL redirects to the new issue's URL. People who don't have read permissions in the new repository will see a banner letting them know that the issue has been transferred to a new repository that they can't access. diff --git a/translations/ko-KR/content/github/receiving-notifications-about-activity-on-github/about-email-notifications.md b/translations/ko-KR/content/github/receiving-notifications-about-activity-on-github/about-email-notifications.md index 0fc02dc4d4b1..84be25b0245a 100644 --- a/translations/ko-KR/content/github/receiving-notifications-about-activity-on-github/about-email-notifications.md +++ b/translations/ko-KR/content/github/receiving-notifications-about-activity-on-github/about-email-notifications.md @@ -19,17 +19,17 @@ Each email notification that {% data variables.product.product_name %} sends con Email notifications from {% data variables.product.product_name %} contain the following header information: -| Header | Information | -| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `From` address | This address will always be 'the no-reply email address configured by your site administrator'. | -| `To` field | This field connects directly to the thread. If you reply to the email, you'll add a new comment to the conversation. | -| `Cc` address | {% data variables.product.product_name %} will `Cc` you if you're subscribed to a conversation. The second `Cc` email address matches the notification reason. The suffix for these notification reasons is {% data variables.notifications.cc_address %}. The possible notification reasons are:
    • `assign`: You were assigned to an issue or pull request.
    • `author`: You created an issue or pull request.
    • `comment`: You commented on an issue or pull request.
    • `manual`: There was an update to an issue or pull request you manually subscribed to.
    • `mention`: You were mentioned on an issue or pull request.
    • `push`: Someone committed to a pull request you're subscribed to.
    • `review_requested`: You or a team you're a member of was requested to review a pull request.
    • `security_alert`: {% data variables.product.prodname_dotcom %} detected a vulnerability in a repository you receive security alerts for.
    • `state_change`: An issue or pull request you're subscribed to was either closed or opened.
    • `subscribed`: There was an update in a repository you're watching.
    • `team_mention`: A team you belong to was mentioned on an issue or pull request.
    • `your_activity`: You opened, commented on, or closed an issue or pull request.
    | -| `mailing list` field | This field identifies the name of the repository and its owner. The format of this address is always `..{% data variables.command_line.backticks %}`. |{% if currentVersion ver_gt "enterprise-server@2.19" % %} -| `X-GitHub-Severity` field | {% data reusables.repositories.security-alerts-x-github-severity %} The possible severity levels are:
    • `low`
    • `moderate`
    • `high`
    • `critical`
    For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." |{% endif %} +| Header | Information | +| --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `From` address | This address will always be 'the no-reply email address configured by your site administrator'. | +| `To` field | This field connects directly to the thread. If you reply to the email, you'll add a new comment to the conversation. | +| `Cc` address | {% data variables.product.product_name %} will `Cc` you if you're subscribed to a conversation. The second `Cc` email address matches the notification reason. The suffix for these notification reasons is {% data variables.notifications.cc_address %}. The possible notification reasons are:
    • `assign`: You were assigned to an issue or pull request.
    • `author`: You created an issue or pull request.
    • `comment`: You commented on an issue or pull request.
    • `manual`: There was an update to an issue or pull request you manually subscribed to.
    • `mention`: You were mentioned on an issue or pull request.
    • `push`: Someone committed to a pull request you're subscribed to.
    • `review_requested`: You or a team you're a member of was requested to review a pull request.
    • `security_alert`: {% data variables.product.prodname_dotcom %} detected a vulnerability in a repository you receive security alerts for.
    • `state_change`: An issue or pull request you're subscribed to was either closed or opened.
    • `subscribed`: There was an update in a repository you're watching.
    • `team_mention`: A team you belong to was mentioned on an issue or pull request.
    • `your_activity`: You opened, commented on, or closed an issue or pull request.
    | +| `mailing list` field | This field identifies the name of the repository and its owner. The format of this address is always `..{% data variables.command_line.backticks %}`. |{% if currentVersion ver_gt "enterprise-server@2.19" % %} +| `X-GitHub-Severity` field | {% data reusables.repositories.security-alerts-x-github-severity %} The possible severity levels are:
    • `low`
    • `moderate`
    • `high`
    • `critical`
    For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." |{% endif %} ### 더 읽을거리 - "[Listing the repositories you're watching](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching)" - "[Watching and unwatching repositories](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories)" -- "[Subscribing to and unsubscribing from notifications](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)"{% if currentVersion ver_gt "enterprise-server@2.17" %} -- "[Creating gists](/articles/creating-gists)"{% endif %} +- "[Subscribing to and unsubscribing from notifications](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)" +- "[Creating gists](/articles/creating-gists)" diff --git a/translations/ko-KR/content/github/receiving-notifications-about-activity-on-github/about-notifications.md b/translations/ko-KR/content/github/receiving-notifications-about-activity-on-github/about-notifications.md index 46f7a2118e17..74b99fd5a51e 100644 --- a/translations/ko-KR/content/github/receiving-notifications-about-activity-on-github/about-notifications.md +++ b/translations/ko-KR/content/github/receiving-notifications-about-activity-on-github/about-notifications.md @@ -33,9 +33,8 @@ The notifications you receive will either be *participating* notifications or *w #### Watching notifications -{% data variables.product.product_name %} sends *watching* notifications for updates in repositories or team discussions that you're watching. {% if currentVersion ver_gt "enterprise-server@2.17" %} {% data reusables.notifications.auto-watch %}For more information, see "[Watching and unwatching repositories](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories)." - -{% endif %}You'll receive a notification when: +{% data variables.product.product_name %} sends *watching* notifications for updates in repositories or team discussions that you're watching. {% data reusables.notifications.auto-watch %}For more information, see "[Watching and unwatching repositories](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories)." +You'll receive a notification when: - An issue is opened. - A comment is added to an open issue. - A pull request is opened. diff --git a/translations/ko-KR/content/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications.md b/translations/ko-KR/content/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications.md index c94cc3084448..988bcef363b9 100644 --- a/translations/ko-KR/content/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications.md +++ b/translations/ko-KR/content/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications.md @@ -7,21 +7,12 @@ versions: ### Managing your notification settings for an issue or pull request -{% if currentVersion ver_lt "enterprise-server@2.18" %}When you subscribe to a conversation in an issue or pull request, you'll receive notifications for each update to the conversation even if you're not participating in the conversation. - -When you unsubscribe from a conversation in an issue or pull request, you'll no longer receive notifications about the conversation. If you or a team you're a member of are @mentioned in the conversation, you'll begin receiving notifications again. For more information about @mentions, see "[Basic writing and formatting syntax](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams)."{% endif %} - {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issue-pr %} 3. Choose an issue or pull request to subscribe to. -{% if currentVersion ver_gt "enterprise-server@2.17" %} 4. In the right sidebar, click **Subscribe** or **Unsubscribe**. ![Conversation Subscribe button](/assets/images/help/notifications/subscribe_button_with_gear.png) 5. To customize your notifications, click {% octicon "gear" aria-label="The gear icon" %}. ![Gear button next to Conversation Subscribe](/assets/images/help/notifications/subscribe_button_with_gear_chosen.png) -6. Select the type of notifications you want to receive for this conversation, then click **Save**. ![Conversation Subscribe options list](/assets/images/help/notifications/subscribe_options.png) -{% else %} -4. To subscribe or unsubscribe from a conversation, in the right sidebar, click **Subscribe** or **Unsubscribe**. ![Conversation Subscribe button](/assets/images/help/notifications/subscribe_button.png) -{% endif %} -You can see a list of all the issues and pull requests you're subscribed to. For more information, see "[Listing the issues and pull requests you're subscribed to](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-issues-and-pull-requests-youre-subscribed-to)." +6. Select the type of notifications you want to receive for this conversation, then click **Save**. ![Conversation Subscribe options list](/assets/images/help/notifications/subscribe_options.png) You can see a list of all the issues and pull requests you're subscribed to. For more information, see "[Listing the issues and pull requests you're subscribed to](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-issues-and-pull-requests-youre-subscribed-to)." ### Subscribing to team discussions diff --git a/translations/ko-KR/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories.md b/translations/ko-KR/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories.md index ad73f44d9b69..0d48d8a6a3e1 100644 --- a/translations/ko-KR/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories.md +++ b/translations/ko-KR/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories.md @@ -5,9 +5,7 @@ versions: enterprise-server: <2.21 --- -{% if currentVersion ver_gt "enterprise-server@2.17" %} {% data reusables.notifications.auto-watch %} For more information, see "[About notifications](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/about-notifications)." -{% endif %} You can also watch and unwatch releases in a repository. For more information, see "[Watching and unwatching releases for a repository](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-releases-for-a-repository)." diff --git a/translations/ko-KR/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md b/translations/ko-KR/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md index 500331f247cb..15671d7a9981 100644 --- a/translations/ko-KR/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md +++ b/translations/ko-KR/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md @@ -21,14 +21,16 @@ To automatically watch all team discussions for new teams you join, set your aut {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.notifications %} -{% data reusables.user_settings.automatic_watching_box %} select **Automatically watch teams**. ![Checkbox for automatically watching teams](/assets/images/help/notifications/automatic-team-discussions-watching.png) +{% data reusables.user_settings.automatic_watching_box %} select **Automatically watch teams**. +![Checkbox for automatically watching teams](/assets/images/help/notifications/automatic-team-discussions-watching.png) ### Watching a single team's discussions {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.specific_team %} -{% data reusables.organizations.watch-team-options %} click **Watch** to open your notifications options. Then click **Watching**. ![Watch options in a drop-down menu for a specific team](/assets/images/help/notifications/specific-team-watch-options.png) +{% data reusables.organizations.watch-team-options %} click **Watch** to open your notifications options. Then click **Watching**. +![Watch options in a drop-down menu for a specific team](/assets/images/help/notifications/specific-team-watch-options.png) ### Unwatching team discussions for all new teams you join @@ -36,14 +38,16 @@ If you don't want to automatically receive team discussion notifications when yo {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.notifications %} -{% data reusables.user_settings.automatic_watching_box %} unselect **Automatically watch teams**. ![Automatically watching teams setting selected by default](/assets/images/help/notifications/automatic-team-discussions-watching.png) +{% data reusables.user_settings.automatic_watching_box %} unselect **Automatically watch teams**. +![Automatically watching teams setting selected by default](/assets/images/help/notifications/automatic-team-discussions-watching.png) ### Unwatching a single team's discussions {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.specific_team %} -{% data reusables.organizations.watch-team-options %} click **Unwatch** to open your notifications options. Then click **Not watching**. ![Watch options in a drop-down menu for a specific team](/assets/images/help/notifications/specific-team-unwatch.png) +{% data reusables.organizations.watch-team-options %} click **Unwatch** to open your notifications options. Then click **Not watching**. +![Watch options in a drop-down menu for a specific team](/assets/images/help/notifications/specific-team-unwatch.png) {% note %} diff --git a/translations/ko-KR/content/github/searching-for-information-on-github/about-searching-on-github.md b/translations/ko-KR/content/github/searching-for-information-on-github/about-searching-on-github.md index 4c08199999a9..8d9a33c3505d 100644 --- a/translations/ko-KR/content/github/searching-for-information-on-github/about-searching-on-github.md +++ b/translations/ko-KR/content/github/searching-for-information-on-github/about-searching-on-github.md @@ -1,6 +1,6 @@ --- title: About searching on GitHub -intro: 'Use our powerful search tools to find what you''re looking for among the many repositories, users, and lines of code on {% data variables.product.product_name %}.' +intro: 'Our integrated search covers the many repositories, users, and lines of code on {% data variables.product.product_name %}.' redirect_from: - /articles/using-the-command-bar/ - /articles/github-search-basics/ @@ -24,6 +24,8 @@ You can search globally across all of {% data variables.product.product_name %}, - {% data reusables.search.required_login %} - {% data variables.product.prodname_pages %} sites are not searchable on {% data variables.product.product_name %}. However you can search the source content if it exists in the default branch of a repository, using code search. For more information, see "[Searching code](/articles/searching-code)." For more information about {% data variables.product.prodname_pages %}, see "[What is GitHub Pages?](/articles/what-is-github-pages/)" +- Currently our search doesn't support exact matching. +- Whenever you are searching in code files, only the first two results in each file will be returned. {% endnote %} diff --git a/translations/ko-KR/content/github/searching-for-information-on-github/searching-for-packages.md b/translations/ko-KR/content/github/searching-for-information-on-github/searching-for-packages.md index fd88a700a9fb..9bbf4f8b1585 100644 --- a/translations/ko-KR/content/github/searching-for-information-on-github/searching-for-packages.md +++ b/translations/ko-KR/content/github/searching-for-information-on-github/searching-for-packages.md @@ -15,7 +15,8 @@ versions: You can search for packages globally across all of {% data variables.product.product_name %}, or search for packages within a particular organization. For more information, see "[About searching on {% data variables.product.prodname_dotcom %}](/articles/about-searching-on-github)." {% if currentVersion != "free-pro-team@latest" %} -You can only search for packages on {% data variables.product.product_location_enterprise %}, not {% data variables.product.prodname_dotcom_the_website %}, even if {% data variables.product.prodname_github_connect %} is enabled. +You can only search for packages on +{% data variables.product.product_location_enterprise %}, not {% data variables.product.prodname_dotcom_the_website %}, even if {% data variables.product.prodname_github_connect %} is enabled. {% endif %} {% data reusables.search.syntax_tips %} @@ -24,9 +25,9 @@ You can only search for packages on {% data variables.product.product_location_e To find packages owned by a certain user or organization, use the `user` or `org` qualifier. -| Qualifier | 예시 | -| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| user:USERNAME | [**user:codertocat**](https://github.com/search?q=user%3Acodertocat&type=RegistryPackages) matches packages owned by @codertocat | +| Qualifier | 예시 | +| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| user:USERNAME | [**user:codertocat**](https://github.com/search?q=user%3Acodertocat&type=RegistryPackages) matches packages owned by @codertocat | | org:ORGNAME | [**org:github**](https://github.com/search?q=org%3Agithub&type=RegistryPackages) matches packages owned by the {% data variables.product.prodname_dotcom %} organization | ### Filtering by package visibility diff --git a/translations/ko-KR/content/github/searching-for-information-on-github/sorting-search-results.md b/translations/ko-KR/content/github/searching-for-information-on-github/sorting-search-results.md index a68568825801..dbd35e51c06c 100644 --- a/translations/ko-KR/content/github/searching-for-information-on-github/sorting-search-results.md +++ b/translations/ko-KR/content/github/searching-for-information-on-github/sorting-search-results.md @@ -18,8 +18,8 @@ To sort by interactions, reactions, author date, committer date, or how recently The `sort:interactions` qualifier sorts by the highest combined number of reactions and comments. -| Qualifier | 예시 | -| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Qualifier | 예시 | +| ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sort:interactions` or `sort:interactions-desc` | [**org:github sort:interactions**](https://github.com/search?q=org%3Agithub+sort%3Ainteractions&type=Issues) matches issues in repositories owned by {% data variables.product.product_name %}, sorted by the highest combined number of reactions and comments. | | `sort:interactions-asc` | [**org:github sort:interactions-asc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Ainteractions-asc&type=Issues) matches issues in repositories owned by {% data variables.product.product_name %}, sorted by the lowest combined number of reactions and comments. | @@ -27,8 +27,8 @@ The `sort:interactions` qualifier sorts by the highest combined number of reacti The `sort:reactions` qualifier sorts by the number or type of reactions. -| Qualifier | 예시 | -| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| Qualifier | 예시 | +| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sort:reactions` or `sort:reactions-desc` | [**org:github sort:reactions**](https://github.com/search?q=org%3Agithub+sort%3Areactions&type=Issues) matches issues in repositories owned by {% data variables.product.product_name %}, sorted by the highest number of reactions. | | `sort:reactions-asc` | [**org:github sort:reactions-asc**](https://github.com/search?q=org%3Agithub+sort%3Areactions-asc&type=Issues) matches issues in repositories owned by {% data variables.product.product_name %}, sorted by ascending number of reactions (the fewest to the most). | | sort:reactions-reaction | [**org:github sort:reactions-+1**](https://github.com/search?q=org%3Agithub+sort%3Areactions-%2B1&type=Issues) matches issues in repositories owned by {% data variables.product.product_name %}, sorted by most thumbs up (:+1:) reactions. | @@ -41,8 +41,8 @@ The `sort:reactions` qualifier sorts by the number or type of reactions. The `sort:author-date` qualifier sorts by descending or ascending author date. -| Qualifier | 예시 | -| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Qualifier | 예시 | +| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sort:author-date` or `sort:author-date-desc` | [**feature org:github sort:author-date**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Aauthor-date&type=Commits) matches commits containing the word "feature" in repositories owned by {% data variables.product.product_name %}, sorted by descending author date. | | `sort:author-date-asc` | [**feature org:github sort:author-date-asc**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Aauthor-date-asc&type=Commits) matches commits containing the word "feature" in repositories owned by {% data variables.product.product_name %}, sorted by ascending author date. | @@ -50,8 +50,8 @@ The `sort:author-date` qualifier sorts by descending or ascending author date. The `sort:committer-date` qualifier sorts by descending or ascending committer date. -| Qualifier | 예시 | -| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Qualifier | 예시 | +| --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sort:committer-date` or `sort:committer-date-desc` | [**feature org:github sort:committer-date**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Acommitter-date&type=Commits) matches commits containing the word "feature" in repositories owned by {% data variables.product.product_name %}, sorted by descending committer date. | | `sort:committer-date-asc` | [**feature org:github sort:committer-date-asc**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Acommitter-date-asc&type=Commits) matches commits containing the word "feature" in repositories owned by {% data variables.product.product_name %}, sorted by ascending committer date. | diff --git a/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md b/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md index 0c6580883ad2..6fd847871730 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md @@ -12,8 +12,8 @@ versions: Minutes reset every month, while storage usage does not. -| 제품 | Storage | Minutes (per month) | -| ------------------------------------------------------------------------ | ------- | ------------------- | +| 제품 | Storage | Minutes (per month) | +| ------------------------------------------------------------------- | ------- | ------------------- | | {% data variables.product.prodname_free_user %} | 500 MB | 2,000 | | {% data variables.product.prodname_pro %} | 1 GB | 3,000 | | {% data variables.product.prodname_free_team %} for organizations | 500 MB | 2,000 | @@ -44,7 +44,7 @@ The storage used by a repository is the total storage used by {% data variables. | macOS | $0.08 | | Windows | $0.016 | -The number of jobs you can run concurrently across all repositories in your user or organization account depends on your GitHub plan. For more information, see "[About {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/about-github-actions/#usage-limits)." +The number of jobs you can run concurrently across all repositories in your user or organization account depends on your GitHub plan. For more information, see "[Usage limits and billing](/actions/reference/usage-limits-billing-and-administration)" for {% data variables.product.prodname_dotcom %}-hosted runners and "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)" for self-hosted runner usage limits. ### Calculating minute and storage spending diff --git a/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md b/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md index 6b56f8573aa3..29ac4bbc5ea4 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md @@ -14,8 +14,8 @@ versions: Data transfer resets every month, while storage usage does not. -| 제품 | Storage | Data transfer (per month) | -| ------------------------------------------------------------------------ | ------- | ------------------------- | +| 제품 | Storage | Data transfer (per month) | +| ------------------------------------------------------------------- | ------- | ------------------------- | | {% data variables.product.prodname_free_user %} | 500MB | 1GB | | {% data variables.product.prodname_pro %} | 2GB | 10GB | | {% data variables.product.prodname_free_team %} for organizations | 500MB | 1GB | diff --git a/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md b/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md index 01b8e92f0584..bc99201f6ab1 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md @@ -49,6 +49,8 @@ Enterprise owners and billing managers can manage the spending limit for {% data {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %} -1. Under "{% data variables.product.prodname_actions %} and Packages monthly usage", click **Cost management**. ![Cost management tab](/assets/images/help/settings/cost-management-tab-enterprise.png) +1. Under " +{% data variables.product.prodname_actions %} and Packages monthly usage", click **Cost management**. + ![Cost management tab](/assets/images/help/settings/cost-management-tab-enterprise.png) {% data reusables.dotcom_billing.monthly-spending-limit %} {% data reusables.dotcom_billing.update-spending-limit %} diff --git a/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md b/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md index 30279630ecea..4fd980b82126 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md @@ -49,6 +49,8 @@ Enterprise owners and billing managers can manage the spending limit for {% data {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %} -1. Under "{% data variables.product.prodname_actions %} and Packages monthly usage", click **Cost management**. ![Cost management tab](/assets/images/help/settings/cost-management-tab-enterprise.png) +1. Under " +{% data variables.product.prodname_actions %} and Packages monthly usage", click **Cost management**. + ![Cost management tab](/assets/images/help/settings/cost-management-tab-enterprise.png) {% data reusables.dotcom_billing.monthly-spending-limit %} {% data reusables.dotcom_billing.update-spending-limit %} diff --git a/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md b/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md index 7196ba8a41dc..ec6f33569a46 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md @@ -28,7 +28,9 @@ You can upgrade your personal account from {% data variables.product.prodname_fr {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.billing %} {% data reusables.user_settings.subscriptions-tab %} -4. Next to "{% data variables.product.prodname_free_user %}", click **Upgrade**. ![Upgrade button](/assets/images/help/billing/settings_billing_user_upgrade.png) +4. Next to " +{% data variables.product.prodname_free_user %}", click **Upgrade**. + ![Upgrade button](/assets/images/help/billing/settings_billing_user_upgrade.png) {% data reusables.dotcom_billing.choose-monthly-or-yearly-billing %} {% data reusables.dotcom_billing.show-plan-details %} {% data reusables.dotcom_billing.enter-payment-info %} diff --git a/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md b/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md index 0fd91b7cc6d3..5aaa282b1206 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md @@ -6,7 +6,7 @@ versions: free-pro-team: '*' --- -You can also view the billable job execution minutes for an individual workflow run. For more information, see "[Managing a workflow run](/actions/configuring-and-managing-workflows/managing-a-workflow-run#viewing-billable-job-execution-minutes)." +You can also view the billable job execution minutes for an individual workflow run. For more information, see "[Viewing job execution time](/actions/managing-workflow-runs/viewing-job-execution-time)." ### Viewing {% data variables.product.prodname_actions %} usage for your user account @@ -43,6 +43,8 @@ Enterprise owners and billing managers can view {% data variables.product.prodna {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %} -1. Under "{% data variables.product.prodname_actions %}", view details of usage of data transfer by each organization in your enterprise account. ![Details of usage of minutes](/assets/images/help/billing/actions-minutes-enterprise.png) +1. Under " +{% data variables.product.prodname_actions %}", view details of usage of data transfer by each organization in your enterprise account. + ![Details of usage of minutes](/assets/images/help/billing/actions-minutes-enterprise.png) {% data reusables.dotcom_billing.actions-packages-storage-enterprise-account %} {% data reusables.enterprise-accounts.actions-packages-report-download-enterprise-accounts %} diff --git a/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md b/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md index b5a386cd1b40..378ee9931f53 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md @@ -41,6 +41,8 @@ Enterprise owners and billing managers can view {% data variables.product.prodna {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %} -1. Under "{% data variables.product.prodname_registry %}", view details of usage of data transfer by each organization in your enterprise account. ![Details of usage of data transfer](/assets/images/help/billing/packages-data-enterprise.png) +1. Under " +{% data variables.product.prodname_registry %}", view details of usage of data transfer by each organization in your enterprise account. + ![Details of usage of data transfer](/assets/images/help/billing/packages-data-enterprise.png) {% data reusables.dotcom_billing.actions-packages-storage-enterprise-account %} {% data reusables.enterprise-accounts.actions-packages-report-download-enterprise-accounts %} diff --git a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md index c7820688feda..bd8cc042fa35 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md @@ -25,5 +25,4 @@ For organizations that belong to an enterprise account, billing is managed at th An entity, such as a company, non-profit, or group, can agree to the Standard Terms of Service or the Corporate Terms of Service for their organization. For more information, see "[Upgrading to the Corporate Terms of Service](/articles/upgrading-to-the-corporate-terms-of-service)." -{% data reusables.organizations.enter-data-protection-agreement %} For more information, see "[Entering a data protection agreement with {% data variables.product.prodname_dotcom %} for GDPR compliance](/articles/entering-a-data-protection-agreement-with-github-for-gdpr-compliance)." {% endif %} diff --git a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md index e5cb73b9bbd7..46796cdfe1dc 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md @@ -6,7 +6,7 @@ redirect_from: - /articles/about-ssh-certificate-authorities versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- An SSH certificate is a mechanism for one SSH key to sign another SSH key. If you use an SSH certificate authority (CA) to provide your organization members with signed SSH certificates, you can add the CA to your enterprise account or organization to allow organization members to use their certificates to access organization resources. For more information, see "[Managing your organization's SSH certificate authorities](/articles/managing-your-organizations-ssh-certificate-authorities)." diff --git a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md index 590168bf58b9..677cd19f45bc 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md @@ -17,6 +17,8 @@ An outside collaborator is a person who isn't explicitly a member of your organi {% data reusables.project-management.click-menu %} {% data reusables.project-management.access-collaboration-settings %} {% data reusables.project-management.collaborator-option %} -9. Under "Search by username, full name or email address", type the outside collaborator's name, username, or {% data variables.product.prodname_dotcom %} email. ![The Collaborators section with the Octocat's username entered in the search field](/assets/images/help/projects/org-project-collaborators-find-name.png) +9. Under "Search by username, full name or email address", type the outside collaborator's name, username, or +{% data variables.product.prodname_dotcom %} email. + ![The Collaborators section with the Octocat's username entered in the search field](/assets/images/help/projects/org-project-collaborators-find-name.png) {% data reusables.project-management.add-collaborator %} {% data reusables.project-management.collaborator-permissions %} diff --git a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md index 465d06d086e4..4879e1655f4d 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md @@ -24,7 +24,9 @@ For more information about {% data variables.product.prodname_github_app %} mana {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.github-apps-settings-sidebar %} -1. Under "{% data variables.product.prodname_github_app %}s", click on the avatar of the app you'd like to add a {% data variables.product.prodname_github_app %} manager for. ![Select {% data variables.product.prodname_github_app %}](/assets/images/help/organizations/select-github-app.png) +1. Under " +{% data variables.product.prodname_github_app %}s", click on the avatar of the app you'd like to add a {% data variables.product.prodname_github_app %} manager for. +![Select {% data variables.product.prodname_github_app %}](/assets/images/help/organizations/select-github-app.png) {% data reusables.organizations.app-managers-settings-sidebar %} 1. Under "App managers", type the username of the person you want to designate as a GitHub App manager for the app, and click **Grant**. ![Add a {% data variables.product.prodname_github_app %} manager for a specific app](/assets/images/help/organizations/add-github-app-manager-for-app.png) diff --git a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md index 0f2f7ba7d923..9814e7c5cfd0 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md @@ -15,8 +15,8 @@ SAML SSO controls and secures access to organization resources like repositories After you enable SCIM, the following provisioning features are available for any users that you assign your {% data variables.product.prodname_ghe_cloud %} application to in Okta. -| Feature | 설명 | -| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Feature | 설명 | +| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Push New Users | When you create a new user in Okta, the user will receive an email to join your {% data variables.product.prodname_dotcom %} organization. | | Push User Deactivation | When you deactivate a user in Okta, Okta will remove the user from your {% data variables.product.prodname_dotcom %} organization. | | Push Profile Updates | When you update a user's profile in Okta, Okta will update the metadata for the user's membership in your {% data variables.product.prodname_dotcom %} organization. | diff --git a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md new file mode 100644 index 000000000000..5934c0738154 --- /dev/null +++ b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md @@ -0,0 +1,16 @@ +--- +title: Configuring the retention period for GitHub Actions artifacts and logs in your organization +intro: 'You can configure the retention period for {% data variables.product.prodname_actions %} artifacts and logs in your organization.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.23' +--- + +{% data reusables.actions.about-artifact-log-retention %} + +## Setting the retention period for an organization + +{% data reusables.organizations.navigate-to-org %} +{% data reusables.organizations.org_settings %} +{% data reusables.organizations.settings-sidebar-actions %} +{% data reusables.github-actions.change-retention-period-for-artifacts-logs %} diff --git a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md index 2f03e117507e..2a6807c27ca2 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md @@ -17,6 +17,8 @@ You can enable {% data variables.product.prodname_actions %} for all repositorie Alternatively, you can enable {% data variables.product.prodname_actions %} for all repositories in your organization but limit the actions a workflow can run. {% data reusables.github-actions.enabled-local-github-actions %} +{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.23" %} + ### Managing {% data variables.product.prodname_actions %} permissions for your organization {% data reusables.profile.access_profile %} @@ -26,6 +28,42 @@ Alternatively, you can enable {% data variables.product.prodname_actions %} for 1. Under **Local and third-party Actions**, select an option. ![Enable, disable, or limit actions for this organization](/assets/images/help/repository/enable-org-actions.png) 1. Click **Save**. +{% endif %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} + +### Managing {% data variables.product.prodname_actions %} permissions for your organization + +You can disable all workflows for an organization or set a policy that configures which actions can be used in an organization. + +{% data reusables.actions.actions-use-policy-settings %} + +{% note %} + +**Note:** You might not be able to manage these settings if your organization is managed by an enterprise that has overriding policy. For more information, {% if currentVersion == "free-pro-team@latest" %}"[Enforcing {% data variables.product.prodname_actions %} policies in your enterprise account](/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account)."{% else %}"[Enforcing {% data variables.product.prodname_actions %} policies for your enterprise](/enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise)."{% endif %} + +{% endnote %} + +{% data reusables.profile.access_profile %} +{% data reusables.profile.access_org %} +{% data reusables.organizations.org_settings %} +{% data reusables.organizations.settings-sidebar-actions %} +1. Under **Policies**, select an option. ![Set actions policy for this organization](/assets/images/help/organizations/actions-policy.png) +1. Click **Save**. + +### Allowing specific actions to run + +{% data reusables.actions.allow-specific-actions-intro %} + +{% data reusables.profile.access_profile %} +{% data reusables.profile.access_org %} +{% data reusables.organizations.org_settings %} +{% data reusables.organizations.settings-sidebar-actions %} +1. Under **Policies**, select **Allow specific actions** and add your required actions to the list. ![Add actions to allow list](/assets/images/help/organizations/actions-policy-allow-list.png) +1. Click **Save**. + +{% endif %} + {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} ### Enabling workflows for private repository forks diff --git a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/index.md b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/index.md index 68d0475a0af7..771bfe8a8d43 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/index.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/index.md @@ -100,6 +100,7 @@ versions: {% link_in_list /managing-the-forking-policy-for-your-organization %} {% link_in_list /disabling-or-limiting-github-actions-for-your-organization %} + {% link_in_list /configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization %} {% link_in_list /setting-permissions-for-adding-outside-collaborators %} @@ -131,7 +132,6 @@ versions: {% link_in_list /upgrading-to-the-corporate-terms-of-service %} - {% link_in_list /entering-a-data-protection-agreement-with-github-for-gdpr-compliance %} {% topic_link_in_list /migrating-to-improved-organization-permissions %} {% link_in_list /converting-an-owners-team-to-improved-organization-permissions %} diff --git a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md index f76d2a568a63..4e4ae0cfa0f7 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md @@ -1,6 +1,7 @@ --- title: Inviting users to join your organization intro: 'You can invite anyone to become a member of your organization using their {% data variables.product.product_name %} username or email address.' +permissions: Organization owners can invite users to join an organization. redirect_from: - /articles/adding-or-inviting-members-to-a-team-in-an-organization/ - /articles/inviting-users-to-join-your-organization @@ -11,9 +12,8 @@ versions: {% tip %} **Tips**: -- Only organization owners can invite users to join an organization. For more information, see "[Permission levels for an organization](/articles/permission-levels-for-an-organization)." - If your organization has a paid per-user subscription, an unused license must be available before you can invite a new member to join the organization or reinstate a former organization member. For more information, see "[About per-user pricing](/articles/about-per-user-pricing)." {% data reusables.organizations.org-invite-expiration %} -- If your organization [requires members to use two-factor authentication](/articles/requiring-two-factor-authentication-in-your-organization), users you invite must [enable two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa) before they can accept the invitation. +- If your organization requires members to use two-factor authentication, users that you invite must enable two-factor authentication before accepting the invitation. For more information, see "[Requiring two-factor authentication in your organization](/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization)" and "[Securing your account with two-factor authentication (2FA)](/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa)." {% endtip %} diff --git a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md index 122c9502f145..330c97e25149 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md @@ -24,7 +24,9 @@ versions: {% data reusables.project-management.click-menu %} {% data reusables.project-management.access-collaboration-settings %} {% data reusables.project-management.collaborator-option %} -9. Under "Search by username, full name or email address", type the collaborator's name, username, or {% data variables.product.prodname_dotcom %} email. ![The Collaborators section with the Octocat's username entered in the search field](/assets/images/help/projects/org-project-collaborators-find-name.png) +9. Under "Search by username, full name or email address", type the collaborator's name, username, or +{% data variables.product.prodname_dotcom %} email. + ![The Collaborators section with the Octocat's username entered in the search field](/assets/images/help/projects/org-project-collaborators-find-name.png) {% data reusables.project-management.add-collaborator %} {% data reusables.project-management.collaborator-permissions %} diff --git a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md index 4906cf152222..30b828ded294 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md @@ -8,6 +8,6 @@ redirect_from: - /articles/managing-git-access-to-your-organizations-repositories versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- diff --git a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md index f3b39e4a5970..6a62b904d744 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md @@ -1,6 +1,7 @@ --- title: Managing the default branch name for repositories in your organization -intro: You can set the default branch name for repositories that members create in your organization. +intro: 'You can set the default branch name for repositories that members create in your organization.' +permissions: Managing the default branch name for your repositories versions: free-pro-team: '*' enterprise-server: '>=2.23' @@ -8,12 +9,10 @@ versions: ### About the default branch name -When a member of your organization creates a new repository, {% data variables.product.prodname_dotcom %} will create a single branch and set it as the repository's default branch. {% data variables.product.prodname_dotcom %} currently names the default branch `master`, but you can set the default branch to be named anything that makes sense for your development environment. +When a member of your organization creates a new repository, {% data variables.product.prodname_dotcom %} will create a single branch and set it as the repository's default branch. You can change the name that {% data variables.product.product_name %} uses for the default branch in new repositories that members of your organization create. For more information about the default branch, see "[About branches](/github/collaborating-with-issues-and-pull-requests/about-branches#about-the-default-branch)." {% data reusables.branches.set-default-branch %} -{% data reusables.branches.rename-existing-branch %} - ### Setting the default branch name {% data reusables.profile.access_profile %} @@ -31,4 +30,4 @@ When a member of your organization creates a new repository, {% data variables.p ### 더 읽을거리 -- [Managing the default branch name for your repositories](/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories) +- /github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories diff --git a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md index 6375823ba5f0..1a5626699d5f 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md @@ -6,7 +6,7 @@ redirect_from: - /articles/managing-the-display-of-member-names-in-your-organization versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- Organization owners can manage the display of member names in an organization. diff --git a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md index cc0c2c8a6d50..b62b548e7bf7 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md @@ -6,7 +6,7 @@ redirect_from: - /articles/managing-your-organizations-ssh-certificate-authorities versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- Organization owners can manage an organization's SSH certificate authorities (CA). diff --git a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md index 578676f31b66..918c3f0f2cbb 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md @@ -22,94 +22,95 @@ Organization members can have *owner*{% if currentVersion == "free-pro-team@late {% if currentVersion == "free-pro-team@latest" %} -| Organization action | Owners | Members | Billing managers | -|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:------:|:-------:|:----------------------------------:| -| Create repositories (see "[Restricting repository creation in your organization](/articles/restricting-repository-creation-in-your-organization)" for details) | **X** | **X** | | -| View and edit billing information | **X** | | **X** | -| Invite people to join the organization | **X** | | | -| Edit and cancel invitations to join the organization | **X** | | | -| Remove members from the organization | **X** | | | -| Reinstate former members to the organization | **X** | | | -| Add and remove people from **all teams** | **X** | | | -| Promote organization members to *team maintainer* | **X** | | | -| Configure code review assignments (see "[Managing code review assignment for your team](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)") | **X** | | | -| Set scheduled reminders (see "[Managing scheduled reminders for pull requests](/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests)") | **X** | | | -| Add collaborators to **all repositories** | **X** | | | -| Access the organization audit log | **X** | | | -| Edit the organization's profile page (see "[About your organization's profile](/articles/about-your-organization-s-profile)" for details) | **X** | | | -| Verify the organization's domains (see "[Verifying your organization's domain](/articles/verifying-your-organization-s-domain)" for details) | **X** | | | -| Delete **all teams** | **X** | | | -| Delete the organization account, including all repositories | **X** | | | -| Create teams (see "[Setting team creation permissions in your organization](/articles/setting-team-creation-permissions-in-your-organization)" for details) | **X** | **X** | | -| [Move teams in an organization's hierarchy](/articles/moving-a-team-in-your-organization-s-hierarchy) | **X** | | | -| Create project boards (see "[Project board permissions for an organization](/articles/project-board-permissions-for-an-organization)" for details) | **X** | **X** | | -| See all organization members and teams | **X** | **X** | | -| @mention any visible team | **X** | **X** | | -| Can be made a *team maintainer* | **X** | **X** | | -| View organization insights (see "[Viewing insights for your organization](/articles/viewing-insights-for-your-organization)" for details) | **X** | **X** | | -| View and post public team discussions to **all teams** (see "[About team discussions](/articles/about-team-discussions)" for details) | **X** | **X** | | -| View and post private team discussions to **all teams** (see "[About team discussions](/articles/about-team-discussions)" for details) | **X** | | | -| Edit and delete team discussions in **all teams** (see "[Managing disruptive comments](/articles/managing-disruptive-comments)" for details) | **X** | | | -| Hide comments on commits, pull requests, and issues (see "[Managing disruptive comments](/articles/managing-disruptive-comments/#hiding-a-comment)" for details) | **X** | **X** | | -| Disable team discussions for an organization (see "[Disabling team discussions for your organization](/articles/disabling-team-discussions-for-your-organization)" for details) | **X** | | |{% if currentVersion == "free-pro-team@latest" %} -| Manage viewing of organization dependency insights (see "[Changing the visibility of your organization's dependency insights](/articles/changing-the-visibility-of-your-organizations-dependency-insights)" for details) | **X** | | |{% endif %} -| Set a team profile picture in **all teams** (see "[Setting your team's profile picture](/articles/setting-your-team-s-profile-picture)" for details) | **X** | | | -| Disable publication of {% data variables.product.prodname_pages %} sites from repositories in the organization (see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)" for details) | **X** | | | -| Manage security and analysis settings (see "[Managing security and analysis settings for your organization](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization)" for details) | **X** | | | -| Enable and enforce [SAML single sign-on](/articles/about-identity-and-access-management-with-saml-single-sign-on) | **X** | | | -| [Manage a user's SAML access to your organization](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization) | **X** | | | -| Manage an organization's SSH certificate authorities (see "[Managing your organization's SSH certificate authorities](/articles/managing-your-organizations-ssh-certificate-authorities)" for details) | **X** | | | -| Transfer repositories | **X** | | | -| Purchase, install, manage billing for, and cancel {% data variables.product.prodname_marketplace %} apps | **X** | | | -| List apps in {% data variables.product.prodname_marketplace %} | **X** | | | -| Receive [{% data variables.product.prodname_dependabot_alerts %} about vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) for all of an organization's repositories | **X** | | | -| Manage {% data variables.product.prodname_dependabot_security_updates %} (see "[Configuring {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)") | **X** | | | -| [Manage the forking policy](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization) | **X** | | | -| [Limit activity in public repositories in an organization](/articles/limiting-interactions-in-your-organization) | **X** | | | -| Pull (read), push (write), and clone (copy) *all repositories* in the organization | **X** | | | -| Convert organization members to [outside collaborators](#outside-collaborators) | **X** | | | -| [View people with access to an organization repository](/articles/viewing-people-with-access-to-your-repository) | **X** | | | -| [Export a list of people with access to an organization repository](/articles/viewing-people-with-access-to-your-repository/#exporting-a-list-of-people-with-access-to-your-repository) | **X** | | | -| Manage default labels (see "[Managing default labels for repositories in your organization](/articles/managing-default-labels-for-repositories-in-your-organization)") | **X** | | | -| Enable team synchronization (see "[Managing team synchronization for your organization](/github/setting-up-and-managing-organizations-and-teams/managing-team-synchronization-for-your-organization)" for details) | **X** | | | +| Organization action | Owners | Members | Billing managers | +|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:------:|:-------:|:--------------------------------------------------:| +| Create repositories (see "[Restricting repository creation in your organization](/articles/restricting-repository-creation-in-your-organization)" for details) | **X** | **X** | | +| View and edit billing information | **X** | | **X** | +| Invite people to join the organization | **X** | | | +| Edit and cancel invitations to join the organization | **X** | | | +| Remove members from the organization | **X** | | | +| Reinstate former members to the organization | **X** | | | +| Add and remove people from **all teams** | **X** | | | +| Promote organization members to *team maintainer* | **X** | | | +| Configure code review assignments (see "[Managing code review assignment for your team](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)") | **X** | | | +| Set scheduled reminders (see "[Managing scheduled reminders for pull requests](/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests)") | **X** | | | +| Add collaborators to **all repositories** | **X** | | | +| Access the organization audit log | **X** | | | +| Edit the organization's profile page (see "[About your organization's profile](/articles/about-your-organization-s-profile)" for details) | **X** | | | +| Verify the organization's domains (see "[Verifying your organization's domain](/articles/verifying-your-organization-s-domain)" for details) | **X** | | | +| Delete **all teams** | **X** | | | +| Delete the organization account, including all repositories | **X** | | | +| Create teams (see "[Setting team creation permissions in your organization](/articles/setting-team-creation-permissions-in-your-organization)" for details) | **X** | **X** | | +| [Move teams in an organization's hierarchy](/articles/moving-a-team-in-your-organization-s-hierarchy) | **X** | | | +| Create project boards (see "[Project board permissions for an organization](/articles/project-board-permissions-for-an-organization)" for details) | **X** | **X** | | +| See all organization members and teams | **X** | **X** | | +| @mention any visible team | **X** | **X** | | +| Can be made a *team maintainer* | **X** | **X** | | +| View organization insights (see "[Viewing insights for your organization](/articles/viewing-insights-for-your-organization)" for details) | **X** | **X** | | +| View and post public team discussions to **all teams** (see "[About team discussions](/articles/about-team-discussions)" for details) | **X** | **X** | | +| View and post private team discussions to **all teams** (see "[About team discussions](/articles/about-team-discussions)" for details) | **X** | | | +| Edit and delete team discussions in **all teams** (see "[Managing disruptive comments](/articles/managing-disruptive-comments)" for details) | **X** | | | +| Hide comments on commits, pull requests, and issues (see "[Managing disruptive comments](/articles/managing-disruptive-comments/#hiding-a-comment)" for details) | **X** | **X** | | +| Disable team discussions for an organization (see "[Disabling team discussions for your organization](/articles/disabling-team-discussions-for-your-organization)" for details) | **X** | | |{% if currentVersion == "free-pro-team@latest" %} +| Manage viewing of organization dependency insights (see "[Changing the visibility of your organization's dependency insights](/articles/changing-the-visibility-of-your-organizations-dependency-insights)" for details) | **X** | | |{% endif %} +| Set a team profile picture in **all teams** (see "[Setting your team's profile picture](/articles/setting-your-team-s-profile-picture)" for details) | **X** | | | +| Disable publication of {% data variables.product.prodname_pages %} sites from repositories in the organization (see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)" for details) | **X** | | | +| Manage security and analysis settings (see "[Managing security and analysis settings for your organization](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization)" for details) | **X** | | | +| Enable and enforce [SAML single sign-on](/articles/about-identity-and-access-management-with-saml-single-sign-on) | **X** | | | +| [Manage a user's SAML access to your organization](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization) | **X** | | | +| Manage an organization's SSH certificate authorities (see "[Managing your organization's SSH certificate authorities](/articles/managing-your-organizations-ssh-certificate-authorities)" for details) | **X** | | | +| Transfer repositories | **X** | | | +| Purchase, install, manage billing for, and cancel {% data variables.product.prodname_marketplace %} apps | **X** | | | +| List apps in {% data variables.product.prodname_marketplace %} | **X** | | | +| Receive [{% data variables.product.prodname_dependabot_alerts %} about vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) for all of an organization's repositories | **X** | | | +| Manage {% data variables.product.prodname_dependabot_security_updates %} (see "[Configuring {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)") | **X** | | | +| [Manage the forking policy](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization) | **X** | | | +| [Limit activity in public repositories in an organization](/articles/limiting-interactions-in-your-organization) | **X** | | | +| Pull (read), push (write), and clone (copy) *all repositories* in the organization | **X** | | | +| Convert organization members to [outside collaborators](#outside-collaborators) | **X** | | | +| [View people with access to an organization repository](/articles/viewing-people-with-access-to-your-repository) | **X** | | | +| [Export a list of people with access to an organization repository](/articles/viewing-people-with-access-to-your-repository/#exporting-a-list-of-people-with-access-to-your-repository) | **X** | | | +| Manage the default branch name (see "[Managing the default branch name for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization)") | **X** | | | +| Manage default labels (see "[Managing default labels for repositories in your organization](/articles/managing-default-labels-for-repositories-in-your-organization)") | **X** | | | +| Enable team synchronization (see "[Managing team synchronization for your organization](/github/setting-up-and-managing-organizations-and-teams/managing-team-synchronization-for-your-organization)" for details) | **X** | | | {% else %} -| Organization action | Owners | Members | -|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:------:|:---------------------------------------:| -| Invite people to join the organization | **X** | | -| Edit and cancel invitations to join the organization | **X** | | -| Remove members from the organization | **X** | | | -| Reinstate former members to the organization | **X** | | | -| Add and remove people from **all teams** | **X** | | -| Promote organization members to *team maintainer* | **X** | |{% if currentVersion ver_gt "enterprise-server@2.19" %} -| Configure code review assignments (see "[Managing code review assignment for your team](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)") | **X** | |{% endif %} -| Add collaborators to **all repositories** | **X** | | -| Access the organization audit log | **X** | | -| Edit the organization's profile page (see "[About your organization's profile](/articles/about-your-organization-s-profile)" for details) | **X** | | | -| Delete **all teams** | **X** | | -| Delete the organization account, including all repositories | **X** | | -| Create teams (see "[Setting team creation permissions in your organization](/articles/setting-team-creation-permissions-in-your-organization)" for details) | **X** | **X** | -| See all organization members and teams | **X** | **X** | -| @mention any visible team | **X** | **X** | -| Can be made a *team maintainer* | **X** | **X** | -| Transfer repositories | **X** | |{% if currentVersion ver_gt "enterprise-server@2.18" %} -| Manage an organization's SSH certificate authorities (see "[Managing your organization's SSH certificate authorities](/articles/managing-your-organizations-ssh-certificate-authorities)" for details) | **X** | |{% endif %} -| Create project boards (see "[Project board permissions for an organization](/articles/project-board-permissions-for-an-organization)" for details) | **X** | **X** | | -| View and post public team discussions to **all teams** (see "[About team discussions](/articles/about-team-discussions)" for details) | **X** | **X** | | -| View and post private team discussions to **all teams** (see "[About team discussions](/articles/about-team-discussions)" for details) | **X** | | | -| Edit and delete team discussions in **all teams** (for more information, see "[Managing disruptive comments](/articles/managing-disruptive-comments) | **X** | | | -| Hide comments on commits, pull requests, and issues (see "[Managing disruptive comments](/articles/managing-disruptive-comments/#hiding-a-comment)" for details) | **X** | **X** | **X** | -| Disable team discussions for an organization (see "[Disabling team discussions for your organization](/articles/disabling-team-discussions-for-your-organization)" for details) | **X** | | | -| Set a team profile picture in **all teams** (see "[Setting your team's profile picture](/articles/setting-your-team-s-profile-picture)" for details) | **X** | | |{% if currentVersion ver_gt "enterprise-server@2.22" %} -| Disable publication of {% data variables.product.prodname_pages %} sites from repositories in the organization (see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)" for details) | **X** | | |{% endif %} -| [Move teams in an organization's hierarchy](/articles/moving-a-team-in-your-organization-s-hierarchy) | **X** | | | -| Pull (read), push (write), and clone (copy) *all repositories* in the organization | **X** | | -| Convert organization members to [outside collaborators](#outside-collaborators) | **X** | | -| [View people with access to an organization repository](/articles/viewing-people-with-access-to-your-repository) | **X** | | -| [Export a list of people with access to an organization repository](/articles/viewing-people-with-access-to-your-repository/#exporting-a-list-of-people-with-access-to-your-repository) | **X** | |{% if currentVersion ver_gt "enterprise-server@2.19" %} -| Manage default labels (see "[Managing default labels for repositories in your organization](/articles/managing-default-labels-for-repositories-in-your-organization)") | **X** | |{% endif %} +| Organization action | Owners | Members | +|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:------:|:-----------------------------------------------------------:| +| Invite people to join the organization | **X** | | +| Edit and cancel invitations to join the organization | **X** | | +| Remove members from the organization | **X** | | | +| Reinstate former members to the organization | **X** | | | +| Add and remove people from **all teams** | **X** | | +| Promote organization members to *team maintainer* | **X** | |{% if currentVersion ver_gt "enterprise-server@2.19" %} +| Configure code review assignments (see "[Managing code review assignment for your team](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)") | **X** | |{% endif %} +| Add collaborators to **all repositories** | **X** | | +| Access the organization audit log | **X** | | +| Edit the organization's profile page (see "[About your organization's profile](/articles/about-your-organization-s-profile)" for details) | **X** | | | +| Delete **all teams** | **X** | | +| Delete the organization account, including all repositories | **X** | | +| Create teams (see "[Setting team creation permissions in your organization](/articles/setting-team-creation-permissions-in-your-organization)" for details) | **X** | **X** | +| See all organization members and teams | **X** | **X** | +| @mention any visible team | **X** | **X** | +| Can be made a *team maintainer* | **X** | **X** | +| Transfer repositories | **X** | | +| Manage an organization's SSH certificate authorities (see "[Managing your organization's SSH certificate authorities](/articles/managing-your-organizations-ssh-certificate-authorities)" for details) | **X** | | +| Create project boards (see "[Project board permissions for an organization](/articles/project-board-permissions-for-an-organization)" for details) | **X** | **X** | | +| View and post public team discussions to **all teams** (see "[About team discussions](/articles/about-team-discussions)" for details) | **X** | **X** | | +| View and post private team discussions to **all teams** (see "[About team discussions](/articles/about-team-discussions)" for details) | **X** | | | +| Edit and delete team discussions in **all teams** (for more information, see "[Managing disruptive comments](/articles/managing-disruptive-comments) | **X** | | | +| Hide comments on commits, pull requests, and issues (see "[Managing disruptive comments](/articles/managing-disruptive-comments/#hiding-a-comment)" for details) | **X** | **X** | **X** | +| Disable team discussions for an organization (see "[Disabling team discussions for your organization](/articles/disabling-team-discussions-for-your-organization)" for details) | **X** | | | +| Set a team profile picture in **all teams** (see "[Setting your team's profile picture](/articles/setting-your-team-s-profile-picture)" for details) | **X** | | |{% if currentVersion ver_gt "enterprise-server@2.22" %} +| Disable publication of {% data variables.product.prodname_pages %} sites from repositories in the organization (see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)" for details) | **X** | | |{% endif %} +| [Move teams in an organization's hierarchy](/articles/moving-a-team-in-your-organization-s-hierarchy) | **X** | | | +| Pull (read), push (write), and clone (copy) *all repositories* in the organization | **X** | | +| Convert organization members to [outside collaborators](#outside-collaborators) | **X** | | +| [View people with access to an organization repository](/articles/viewing-people-with-access-to-your-repository) | **X** | | +| [Export a list of people with access to an organization repository](/articles/viewing-people-with-access-to-your-repository/#exporting-a-list-of-people-with-access-to-your-repository) | **X** | |{% if currentVersion ver_gt "enterprise-server@2.19" %} +| Manage default labels (see "[Managing default labels for repositories in your organization](/articles/managing-default-labels-for-repositories-in-your-organization)") | **X** | |{% endif %} {% endif %} diff --git a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md index 0294e0e1f217..ab53ca833760 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md @@ -24,7 +24,9 @@ For more information about {% data variables.product.prodname_github_app %} mana {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.github-apps-settings-sidebar %} -1. Under "{% data variables.product.prodname_github_app %}s", click on the avatar of the app you'd like to remove a {% data variables.product.prodname_github_app %} manager from. ![Select {% data variables.product.prodname_github_app %}](/assets/images/help/organizations/select-github-app.png) +1. Under " +{% data variables.product.prodname_github_app %}s", click on the avatar of the app you'd like to remove a {% data variables.product.prodname_github_app %} manager from. +![Select {% data variables.product.prodname_github_app %}](/assets/images/help/organizations/select-github-app.png) {% data reusables.organizations.app-managers-settings-sidebar %} 1. Under "App managers", find the username of the person you want to remove {% data variables.product.prodname_github_app %} manager permissions from, and click **Revoke**. ![Revoke {% data variables.product.prodname_github_app %} manager permissions](/assets/images/help/organizations/github-app-manager-revoke-permissions-individual-app.png) diff --git a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md index 61f6364baf92..5b86a29d9d3d 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md @@ -16,10 +16,10 @@ People with admin permissions can manage individual and team access to an organi You can give organization members, outside collaborators, and teams of people different levels of access to repositories owned by an organization. Each permission level progressively increases access to a repository's content and settings. Choose the level that best fits each person or team's role in your project without giving people more access to the project than they need. From least access to most access, the permission levels for an organization repository are: -- **Read**: Recommended for non-code contributors who want to view or discuss your project{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -- **Triage**: Recommended for contributors who need to proactively manage issues and pull requests without write access{% endif %} -- **Write**: Recommended for contributors who actively push to your project{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -- **Maintain**: Recommended for project managers who need to manage the repository without access to sensitive or destructive actions{% endif %} +- **Read**: Recommended for non-code contributors who want to view or discuss your project +- **Triage**: Recommended for contributors who need to proactively manage issues and pull requests without write access +- **Write**: Recommended for contributors who actively push to your project +- **Maintain**: Recommended for project managers who need to manage the repository without access to sensitive or destructive actions - **Admin**: Recommended for people who need full access to the project, including sensitive and destructive actions like managing security or deleting a repository {% if currentVersion == "free-pro-team@latest" %} @@ -41,135 +41,75 @@ In addition to managing organization-level settings, organization owners have ad {% endwarning %} ### Repository access for each permission level -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -| Repository action | Read | 심사 | Write | Maintain | Admin | -|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-----:|:-----:|:-----:|:--------:|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------:| -| Pull from the person or team's assigned repositories | **X** | **X** | **X** | **X** | **X** | -| Fork the person or team's assigned repositories | **X** | **X** | **X** | **X** | **X** | -| Edit and delete their own comments | **X** | **X** | **X** | **X** | **X** | -| Open issues | **X** | **X** | **X** | **X** | **X** | -| Close issues they opened themselves | **X** | **X** | **X** | **X** | **X** | -| Reopen issues they closed themselves | **X** | **X** | **X** | **X** | **X** | -| Have an issue assigned to them | **X** | **X** | **X** | **X** | **X** | -| Send pull requests from forks of the team's assigned repositories | **X** | **X** | **X** | **X** | **X** | -| Submit reviews on pull requests | **X** | **X** | **X** | **X** | **X** | + +| Repository action | Read | 심사 | Write | Maintain | Admin | +|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-----:|:-----:|:-----:|:--------:|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:| +| Pull from the person or team's assigned repositories | **X** | **X** | **X** | **X** | **X** | +| Fork the person or team's assigned repositories | **X** | **X** | **X** | **X** | **X** | +| Edit and delete their own comments | **X** | **X** | **X** | **X** | **X** | +| Open issues | **X** | **X** | **X** | **X** | **X** | +| Close issues they opened themselves | **X** | **X** | **X** | **X** | **X** | +| Reopen issues they closed themselves | **X** | **X** | **X** | **X** | **X** | +| Have an issue assigned to them | **X** | **X** | **X** | **X** | **X** | +| Send pull requests from forks of the team's assigned repositories | **X** | **X** | **X** | **X** | **X** | +| Submit reviews on pull requests | **X** | **X** | **X** | **X** | **X** | | View published releases | **X** | **X** | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| View [GitHub Actions workflow runs](/actions/automating-your-workflow-with-github-actions/managing-a-workflow-run) | **X** | **X** | **X** | **X** | **X** |{% endif %} +| View [GitHub Actions workflow runs](/actions/automating-your-workflow-with-github-actions/managing-a-workflow-run) | **X** | **X** | **X** | **X** | **X** |{% endif %} | Edit wikis | **X** | **X** | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [Report abusive or spammy content](/articles/reporting-abuse-or-spam) | **X** | **X** | **X** | **X** | **X** |{% endif %} -| Apply labels | | **X** | **X** | **X** | **X** | -| Close, reopen, and assign all issues and pull requests | | **X** | **X** | **X** | **X** | -| Apply milestones | | **X** | **X** | **X** | **X** | -| Mark [duplicate issues and pull requests](/articles/about-duplicate-issues-and-pull-requests) | | **X** | **X** | **X** | **X** | -| Request [pull request reviews](/articles/requesting-a-pull-request-review) | | **X** | **X** | **X** | **X** | -| Push to (write) the person or team's assigned repositories | | | **X** | **X** | **X** | -| Edit and delete anyone's comments on commits, pull requests, and issues | | | **X** | **X** | **X** | -| [Hide anyone's comments](/articles/managing-disruptive-comments) | | | **X** | **X** | **X** | -| [Lock conversations](/articles/locking-conversations) | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| Transfer issues (see "[Transferring an issue to another repository](/articles/transferring-an-issue-to-another-repository)" for details) | | | **X** | **X** | **X** |{% endif %} -| [Act as a designated code owner for a repository](/articles/about-code-owners) | | | **X** | **X** | **X** | -| [Mark a draft pull request as ready for review](/articles/changing-the-stage-of-a-pull-request) | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -| [Convert a pull request to a draft](/articles/changing-the-stage-of-a-pull-request) | | | **X** | **X** | **X** |{% endif %} -| Submit reviews that affect a pull request's mergeability | | | **X** | **X** | **X** | -| [Apply suggested changes](/articles/incorporating-feedback-in-your-pull-request) to pull requests | | | **X** | **X** | **X** | +| [Report abusive or spammy content](/articles/reporting-abuse-or-spam) | **X** | **X** | **X** | **X** | **X** |{% endif %} +| Apply labels | | **X** | **X** | **X** | **X** | +| Close, reopen, and assign all issues and pull requests | | **X** | **X** | **X** | **X** | +| Apply milestones | | **X** | **X** | **X** | **X** | +| Mark [duplicate issues and pull requests](/articles/about-duplicate-issues-and-pull-requests) | | **X** | **X** | **X** | **X** | +| Request [pull request reviews](/articles/requesting-a-pull-request-review) | | **X** | **X** | **X** | **X** | +| Push to (write) the person or team's assigned repositories | | | **X** | **X** | **X** | +| Edit and delete anyone's comments on commits, pull requests, and issues | | | **X** | **X** | **X** | +| [Hide anyone's comments](/articles/managing-disruptive-comments) | | | **X** | **X** | **X** | +| [Lock conversations](/articles/locking-conversations) | | | **X** | **X** | **X** | +| Transfer issues (see "[Transferring an issue to another repository](/articles/transferring-an-issue-to-another-repository)" for details) | | | **X** | **X** | **X** | +| [Act as a designated code owner for a repository](/articles/about-code-owners) | | | **X** | **X** | **X** | +| [Mark a draft pull request as ready for review](/articles/changing-the-stage-of-a-pull-request) | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +| [Convert a pull request to a draft](/articles/changing-the-stage-of-a-pull-request) | | | **X** | **X** | **X** |{% endif %} +| Submit reviews that affect a pull request's mergeability | | | **X** | **X** | **X** | +| [Apply suggested changes](/articles/incorporating-feedback-in-your-pull-request) to pull requests | | | **X** | **X** | **X** | | Create [status checks](/articles/about-status-checks) | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| Create, edit, run, re-run, and cancel [GitHub Actions workflows](/actions/automating-your-workflow-with-github-actions/) | | | **X** | **X** | **X** |{% endif %} -| Create and edit releases | | | **X** | **X** | **X** | -| View draft releases | | | **X** | **X** | **X** | +| Create, edit, run, re-run, and cancel [GitHub Actions workflows](/actions/automating-your-workflow-with-github-actions/) | | | **X** | **X** | **X** |{% endif %} +| Create and edit releases | | | **X** | **X** | **X** | +| View draft releases | | | **X** | **X** | **X** | | Edit a repository's description | | | | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [View and install packages](/packages/publishing-and-managing-packages) | **X** | **X** | **X** | **X** | **X** | -| [Publish packages](/packages/publishing-and-managing-packages/publishing-a-package) | | | **X** | **X** | **X** | -| [Delete packages](/packages/publishing-and-managing-packages/deleting-a-package) | | | | | **X** |{% endif %} -| Manage [topics](/articles/classifying-your-repository-with-topics) | | | | **X** | **X** | -| Enable wikis and restrict wiki editors | | | | **X** | **X** | -| Enable project boards | | | | **X** | **X** | -| Configure [pull request merges](/articles/configuring-pull-request-merges) | | | | **X** | **X** | -| Configure [a publishing source for {% data variables.product.prodname_pages %}](/articles/configuring-a-publishing-source-for-github-pages) | | | | **X** | **X** | -| [Push to protected branches](/articles/about-protected-branches) | | | | **X** | **X** | +| [View and install packages](/packages/publishing-and-managing-packages) | **X** | **X** | **X** | **X** | **X** | +| [Publish packages](/packages/publishing-and-managing-packages/publishing-a-package) | | | **X** | **X** | **X** | +| [Delete packages](/packages/publishing-and-managing-packages/deleting-a-package) | | | | | **X** |{% endif %} +| Manage [topics](/articles/classifying-your-repository-with-topics) | | | | **X** | **X** | +| Enable wikis and restrict wiki editors | | | | **X** | **X** | +| Enable project boards | | | | **X** | **X** | +| Configure [pull request merges](/articles/configuring-pull-request-merges) | | | | **X** | **X** | +| Configure [a publishing source for {% data variables.product.prodname_pages %}](/articles/configuring-a-publishing-source-for-github-pages) | | | | **X** | **X** | +| [Push to protected branches](/articles/about-protected-branches) | | | | **X** | **X** | | [Create and edit repository social cards](/articles/customizing-your-repositorys-social-media-preview) | | | | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| Limit [interactions in a repository](/github/building-a-strong-community/limiting-interactions-in-your-repository) | | | | **X** | **X** |{% endif %} -| Delete an issue (see "[Deleting an issue](/articles/deleting-an-issue)") | | | | | **X** | -| Merge pull requests on protected branches, even if there are no approving reviews | | | | | **X** | -| [Define code owners for a repository](/articles/about-code-owners) | | | | | **X** | -| Add a repository to a team (see "[Managing team access to an organization repository](/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository#giving-a-team-access-to-a-repository)" for details) | | | | | **X** | -| [Manage outside collaborator access to a repository](/articles/adding-outside-collaborators-to-repositories-in-your-organization) | | | | | **X** | -| [Change a repository's visibility](/articles/restricting-repository-visibility-changes-in-your-organization) | | | | | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| Make a repository a template (see "[Creating a template repository](/articles/creating-a-template-repository)") | | | | | **X** |{% endif %} -| Change a repository's settings | | | | | **X** | -| Manage team and collaborator access to the repository | | | | | **X** | -| Edit the repository's default branch | | | | | **X** | +| Limit [interactions in a repository](/github/building-a-strong-community/limiting-interactions-in-your-repository) | | | | **X** | **X** |{% endif %} +| Delete an issue (see "[Deleting an issue](/articles/deleting-an-issue)") | | | | | **X** | +| Merge pull requests on protected branches, even if there are no approving reviews | | | | | **X** | +| [Define code owners for a repository](/articles/about-code-owners) | | | | | **X** | +| Add a repository to a team (see "[Managing team access to an organization repository](/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository#giving-a-team-access-to-a-repository)" for details) | | | | | **X** | +| [Manage outside collaborator access to a repository](/articles/adding-outside-collaborators-to-repositories-in-your-organization) | | | | | **X** | +| [Change a repository's visibility](/articles/restricting-repository-visibility-changes-in-your-organization) | | | | | **X** | +| Make a repository a template (see "[Creating a template repository](/articles/creating-a-template-repository)") | | | | | **X** | +| Change a repository's settings | | | | | **X** | +| Manage team and collaborator access to the repository | | | | | **X** | +| Edit the repository's default branch | | | | | **X** | | Manage webhooks and deploy keys | | | | | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [Enable the dependency graph](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) for a private repository | | | | | **X** | -| Receive [{% data variables.product.prodname_dependabot_alerts %} for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in a repository | | | | | **X** | -| [Dismiss {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository) | | | | | **X** | -| [Designate additional people or teams to receive {% data variables.product.prodname_dependabot_alerts %}](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository) for vulnerable dependencies | | | | | **X** | +| [Enable the dependency graph](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) for a private repository | | | | | **X** | +| Receive [{% data variables.product.prodname_dependabot_alerts %} for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in a repository | | | | | **X** | +| [Dismiss {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository) | | | | | **X** | +| [Designate additional people or teams to receive {% data variables.product.prodname_dependabot_alerts %}](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository) for vulnerable dependencies | | | | | **X** | | [Manage data use settings for your private repository](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository) | | | | | **X** |{% endif %}{% if currentVersion == "free-pro-team@latest" %}| Create [security advisories](/github/managing-security-vulnerabilities/about-github-security-advisories) | | | | | **X** |{% endif %} -| [Manage the forking policy for a repository](/github/administering-a-repository/managing-the-forking-policy-for-your-repository) | | | | | **X** | -| [Transfer repositories into the organization](/articles/restricting-repository-creation-in-your-organization) | | | | | **X** | -| [Delete or transfer repositories out of the organization](/articles/setting-permissions-for-deleting-or-transferring-repositories) | | | | | **X** | +| [Manage the forking policy for a repository](/github/administering-a-repository/managing-the-forking-policy-for-your-repository) | | | | | **X** | +| [Transfer repositories into the organization](/articles/restricting-repository-creation-in-your-organization) | | | | | **X** | +| [Delete or transfer repositories out of the organization](/articles/setting-permissions-for-deleting-or-transferring-repositories) | | | | | **X** | | [Archive repositories](/articles/about-archiving-repositories) | | | | | **X** |{% if currentVersion == "free-pro-team@latest" %} -| Display a sponsor button (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)") | | | | | **X** |{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -| Create autolink references to external resources, like JIRA or Zendesk (see "[Configuring autolinks to reference external resources](/articles/configuring-autolinks-to-reference-external-resources)") | | | | | **X** |{% endif %} - -{% else %} - -| Repository action | Read permissions | Write permissions | Admin permissions | -|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:----------------:|:-----------------:|:----------------------------------------------------------------------:| -| Pull from (read) the person or team's assigned repositories | **X** | **X** | **X** | -| Fork (copy) the person or team's assigned repositories | **X** | **X** | **X** | -| Edit and delete their own comments on commits, pull requests, and issues | **X** | **X** | **X** | -| Open issues | **X** | **X** | **X** | -| Close issues they opened themselves | **X** | **X** | **X** | -| Reopen issues they closed themselves | **X** | **X** | **X** | -| Have an issue assigned to them | **X** | **X** | **X** | -| Send pull requests from forks of the team's assigned repositories | **X** | **X** | **X** | -| Submit reviews on pull requests | **X** | **X** | **X** | -| View published releases | **X** | **X** | **X** | -| Edit wikis | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [Report abusive or spammy content](/articles/reporting-abuse-or-spam) | **X** | **X** | **X** |{% endif %} -| Push to (write) the person or team's assigned repositories | | **X** | **X** | -| Edit and delete anyone's comments on commits, pull requests, and issues | | **X** | **X** | -| [Hide anyone's comments](/articles/managing-disruptive-comments) | | **X** | **X** | -| [Lock conversations](/articles/locking-conversations) | | **X** | **X** | -| Apply labels and milestones | | **X** | **X** | -| Close, reopen, and assign all issues | | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| Mark [duplicate issues and pull requests](/articles/about-duplicate-issues-and-pull-requests) | | **X** | **X** |{% endif %} -| [Act as a designated code owner for a repository](/articles/about-code-owners) | | **X** | **X** | -| [Mark a draft pull request as ready for review](/articles/changing-the-stage-of-a-pull-request) | | **X** | **X** | -| Request [pull request reviews](/articles/requesting-a-pull-request-review) | | **X** | **X** | -| Submit reviews that affect a pull request's mergeability | | **X** | **X** | -| Apply suggested changes to pull requests (see "[Incorporating feedback in your pull request](/articles/incorporating-feedback-in-your-pull-request)" for details) | | **X** | **X** | -| Create [status checks](/articles/about-status-checks) | | **X** | **X** | -| Create and edit releases | | **X** | **X** | -| View draft releases | | **X** | **X** | -| Delete an issue (see "[Deleting an issue](/articles/deleting-an-issue)") | | | **X** | -| Merge pull requests on protected branches, even if there are no approving reviews | | | **X** | -| [Define code owners for a repository](/articles/about-code-owners) | | | **X** | -| Edit a repository's description | | | **X** | -| Manage [topics](/articles/classifying-your-repository-with-topics) | | | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| Create and edit repository social cards (see "[Customizing your repository's social media preview](/articles/customizing-your-repositorys-social-media-preview)" for details) | | | **X** |{% endif %} -| Add a repository to a team (see "[Managing team access to an organization repository](/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository#giving-a-team-access-to-a-repository)" for details) | | | **X** | -| Manage outside collaborator access to a repository (see "[Adding outside collaborators to repositories in your organization](/articles/adding-outside-collaborators-to-repositories-in-your-organization)" for details) | | | **X** |{% if currentVersion == "free-pro-team@latest" %} -| Limit [interactions in a repository](/github/building-a-strong-community/limiting-interactions-in-your-repository) | | | **X** |{% endif %} -| Change a repository's visibility (see "[Restricting repository visibility changes in your organization](/articles/restricting-repository-visibility-changes-in-your-organization)" for details) | | | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| Make a repository a template (see "[Creating a template repository](/articles/creating-a-template-repository)") | | | | | **X** |{% endif %} -| Change a repository's settings | | | **X** | -| Manage team and collaborator access to the repository | | | **X** | -| Edit the repository's default branch | | | **X** | -| Manage webhooks and deploy keys | | | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [Enable the dependency graph](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) for a private repository | | | **X** | -| Receive [{% data variables.product.prodname_dependabot_alerts %} for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in a repository | | | **X** | -| [Dismiss {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository) | | | **X** | -| [Designate additional people or teams to receive {% data variables.product.prodname_dependabot_alerts %}](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-github-dependabot-alerts) for vulnerable dependencies | | | **X** | -| [Manage data use settings for your private repository](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository) | | | **X** |{% endif %}{% if currentVersion == "free-pro-team@latest" %} -| Create [security advisories](/github/managing-security-vulnerabilities/about-github-security-advisories)") | | | **X** |{% endif %} -| [Manage the forking policy for a repository](/github/administering-a-repository/managing-the-forking-policy-for-your-repository) | | | **X** | -| Transfer repositories into the organization account (see "[Restricting repository creation in your organization](/articles/restricting-repository-creation-in-your-organization)" for details) | | | **X** | -| Delete or transfer repositories (see "[Setting permissions for deleting or transferring repositories in your organization](/articles/setting-permissions-for-deleting-or-transferring-repositories)" for details) | | | **X** | -| [Archive repositories](/articles/about-archiving-repositories) | | | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -| Create autolink references to external resources, like JIRA or Zendesk (see "[Configuring autolinks to reference external resources](/articles/configuring-autolinks-to-reference-external-resources)" | | | | | **X** |{% endif %} - -{% endif %} +| Display a sponsor button (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)") | | | | | **X** |{% endif %} +| Create autolink references to external resources, like JIRA or Zendesk (see "[Configuring autolinks to reference external resources](/articles/configuring-autolinks-to-reference-external-resources)") | | | | | **X** | ### 더 읽을거리 diff --git a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md index d9944ba07d7c..59840f61d97d 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md @@ -8,11 +8,15 @@ versions: enterprise-server: '*' --- -{% data reusables.two_fa.auth_methods_2fa %} +### About two-factor authentication for organizations + +{% data reusables.two_fa.about-2fa %} You can require all {% if currentVersion == "free-pro-team@latest" %}members, outside collaborators, and billing managers{% else %}members and outside collaborators{% endif %} in your organization to enable two-factor authentication on {% data variables.product.product_name %}. For more information about two-factor authentication, see "[Securing your account with two-factor authentication (2FA)](/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa)." -### Requirements for enforcing two-factor authentication +{% if currentVersion == "free-pro-team@latest" %} -Before you can require {% if currentVersion == "free-pro-team@latest" %}organization members, outside collaborators, and billing managers{% else %}organization members and outside collaborators{% endif %} to use 2FA, you must [enable two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa/) for your own personal account. +You can also require two-factor authentication for organizations in an enterprise. For more information, see "[Enforcing security settings in your enterprise account](/github/setting-up-and-managing-your-enterprise-account/enforcing-security-settings-in-your-enterprise-account#requiring-two-factor-authentication-for-organizations-in-your-enterprise-account)." + +{% endif %} {% warning %} @@ -24,7 +28,15 @@ Before you can require {% if currentVersion == "free-pro-team@latest" %}organiza {% endwarning %} -Before you require use of two-factor authentication, we recommend notifying {% if currentVersion == "free-pro-team@latest" %}organization members, outside collaborators, and billing managers{% else %}organization members and outside collaborators{% endif %} and asking them to set up 2FA for their accounts. You can [see if members and outside collaborators already use 2FA](/articles/viewing-whether-users-in-your-organization-have-2fa-enabled) on your organization's People page. +{% data reusables.two_fa.auth_methods_2fa %} + +### 빌드전 요구 사양 + +Before you can require {% if currentVersion == "free-pro-team@latest" %}organization members, outside collaborators, and billing managers{% else %}organization members and outside collaborators{% endif %} to use two-factor authentication, you must enable two-factor authentication for your account on {% data variables.product.product_name %}. For more information, see "[Securing your account with two-factor authentication (2FA)](/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa)." + +Before you require use of two-factor authentication, we recommend notifying {% if currentVersion == "free-pro-team@latest" %}organization members, outside collaborators, and billing managers{% else %}organization members and outside collaborators{% endif %} and asking them to set up 2FA for their accounts. You can see if members and outside collaborators already use 2FA. For more information, see "[Viewing whether users in your organization have 2FA enabled](/github/setting-up-and-managing-organizations-and-teams/viewing-whether-users-in-your-organization-have-2fa-enabled)." + +### Requiring two-factor authentication in your organization {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} diff --git a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md index 8132cfc396aa..1dddaa9bb08a 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md @@ -26,5 +26,5 @@ Organization owners can always create any type of repository. {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.member-privileges %} -5. Under "Repository creation", select {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}one or more options{% else %}a setting{% endif %}. ![Repository creation options](/assets/images/help/organizations/repo-creation-perms-radio-buttons.png) +5. Under "Repository creation", select one or more options. ![Repository creation options](/assets/images/help/organizations/repo-creation-perms-radio-buttons.png) 6. Click **Save**. diff --git a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md index 330ec8e4fb22..daee59b400a1 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md @@ -25,31 +25,31 @@ The audit log lists actions performed within the last 90 days. Only owners can a To search for specific events, use the `action` qualifier in your query. Actions listed in the audit log are grouped within the following categories: -| Category Name | 설명 | -| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |{% if currentVersion == "free-pro-team@latest" %} -| `계정` | Contains all activities related to your organization account.{% endif %}{% if currentVersion == "free-pro-team@latest" %} -| `결제` | Contains all activities related to your organization's billing.{% endif %} -| `discussion_post` | Contains all activities related to discussions posted to a team page. | -| `discussion_post_reply` | Contains all activities related to replies to discussions posted to a team page. | -| `후크` | Contains all activities related to webhooks. | -| `integration_installation_request` | Contains all activities related to organization member requests for owners to approve integrations for use in the organization. |{% if currentVersion == "free-pro-team@latest" %} -| `marketplace_agreement_signature` | Contains all activities related to signing the {% data variables.product.prodname_marketplace %} Developer Agreement. | -| `marketplace_listing` | Contains all activities related to listing apps in {% data variables.product.prodname_marketplace %}.{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -| `members_can_create_pages` | Contains all activities related to disabling the publication of {% data variables.product.prodname_pages %} sites for repositories in the organization. For more information, see "[Restricting publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)." |{% endif %} -| `org` | Contains all activities related to organization membership{% if currentVersion == "free-pro-team@latest" %} -| `org_credential_authorization` | Contains all activities related to authorizing credentials for use with SAML single sign-on.{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -| `organization_label` | Contains all activities related to default labels for repositories in your organization.{% endif %}{% if currentVersion == "free-pro-team@latest" %} -| `payment_method` | Contains all activities related to how your organization pays for GitHub.{% endif %} -| `profile_picture` | Contains all activities related to your organization's profile picture. | -| `프로젝트` | Contains all activities related to project boards. | -| `protected_branch` | Contains all activities related to protected branches. | -| `repo` | Contains all activities related to the repositories owned by your organization.{% if currentVersion == "free-pro-team@latest" %} -| `repository_content_analysis` | Contains all activities related to [enabling or disabling data use for a private repository](/articles/about-github-s-use-of-your-data). | -| `repository_dependency_graph` | Contains all activities related to [enabling or disabling the dependency graph for a private repository](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository).{% endif %} -| `repository_vulnerability_alert` | Contains all activities related to [{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies).{% if currentVersion == "free-pro-team@latest" %} -| `sponsors` | Contains all events related to sponsor buttons (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)"){% endif %}{% if currentVersion != "free-pro-team@latest" %} -| `팀` | Contains all activities related to teams in your organization.{% endif %} -| `team_discussions` | Contains activities related to managing team discussions for an organization. | +| Category Name | 설명 | +| ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" %} +| `계정` | Contains all activities related to your organization account.{% endif %}{% if currentVersion == "free-pro-team@latest" %} +| `결제` | Contains all activities related to your organization's billing.{% endif %} +| `discussion_post` | Contains all activities related to discussions posted to a team page. | +| `discussion_post_reply` | Contains all activities related to replies to discussions posted to a team page. | +| `후크` | Contains all activities related to webhooks. | +| `integration_installation_request` | Contains all activities related to organization member requests for owners to approve integrations for use in the organization. |{% if currentVersion == "free-pro-team@latest" %} +| `marketplace_agreement_signature` | Contains all activities related to signing the {% data variables.product.prodname_marketplace %} Developer Agreement. | +| `marketplace_listing` | Contains all activities related to listing apps in {% data variables.product.prodname_marketplace %}.{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +| `members_can_create_pages` | Contains all activities related to disabling the publication of {% data variables.product.prodname_pages %} sites for repositories in the organization. For more information, see "[Restricting publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)." |{% endif %} +| `org` | Contains all activities related to organization membership{% if currentVersion == "free-pro-team@latest" %} +| `org_credential_authorization` | Contains all activities related to authorizing credentials for use with SAML single sign-on.{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} +| `organization_label` | Contains all activities related to default labels for repositories in your organization.{% endif %}{% if currentVersion == "free-pro-team@latest" %} +| `payment_method` | Contains all activities related to how your organization pays for GitHub.{% endif %} +| `profile_picture` | Contains all activities related to your organization's profile picture. | +| `프로젝트` | Contains all activities related to project boards. | +| `protected_branch` | Contains all activities related to protected branches. | +| `repo` | Contains all activities related to the repositories owned by your organization.{% if currentVersion == "free-pro-team@latest" %} +| `repository_content_analysis` | Contains all activities related to [enabling or disabling data use for a private repository](/articles/about-github-s-use-of-your-data). | +| `repository_dependency_graph` | Contains all activities related to [enabling or disabling the dependency graph for a private repository](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository).{% endif %} +| `repository_vulnerability_alert` | Contains all activities related to [{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies).{% if currentVersion == "free-pro-team@latest" %} +| `sponsors` | Contains all events related to sponsor buttons (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)"){% endif %}{% if currentVersion != "free-pro-team@latest" %} +| `팀` | Contains all activities related to teams in your organization.{% endif %} +| `team_discussions` | Contains activities related to managing team discussions for an organization. | You can search for specific sets of actions using these terms. 예시: @@ -98,14 +98,14 @@ This list describes the available categories and associated events: | `billing_plan_change` | Triggered when an organization's [billing cycle](/articles/changing-the-duration-of-your-billing-cycle) changes. | | `plan_change` | Triggered when an organization's [subscription](/articles/about-billing-for-github-accounts) changes. | | `pending_plan_change` | Triggered when an organization owner or billing manager [cancels or downgrades a paid subscription](/articles/how-does-upgrading-or-downgrading-affect-the-billing-process/). | -| `pending_subscription_change` | Triggered when a [{% data variables.product.prodname_marketplace %} free trial starts or expires](/articles/about-billing-for-github-marketplace/). | +| `pending_subscription_change` | Triggered when a [{% data variables.product.prodname_marketplace %} free trial starts or expires](/articles/about-billing-for-github-marketplace/). | ##### The `billing` category -| 동작 | 설명 | -| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 동작 | 설명 | +| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | `change_billing_type` | Triggered when your organization [changes how it pays for {% data variables.product.prodname_dotcom %}](/articles/adding-or-editing-a-payment-method). | -| `change_email` | Triggered when your organization's [billing email address](/articles/setting-your-billing-email) changes. | +| `change_email` | Triggered when your organization's [billing email address](/articles/setting-your-billing-email) changes. | {% endif %} @@ -149,18 +149,18 @@ This list describes the available categories and associated events: ##### The `marketplace_agreement_signature` category -| 동작 | 설명 | -| -------- | ------------------------------------------------------------------------------------------------------- | +| 동작 | 설명 | +| -------- | -------------------------------------------------------------------------------------------------- | | `create` | Triggered when you sign the {% data variables.product.prodname_marketplace %} Developer Agreement. | ##### The `marketplace_listing` category -| 동작 | 설명 | -| --------- | -------------------------------------------------------------------------------------------------------------------- | +| 동작 | 설명 | +| --------- | --------------------------------------------------------------------------------------------------------------- | | `승인` | Triggered when your listing is approved for inclusion in {% data variables.product.prodname_marketplace %}. | | `create` | Triggered when you create a listing for your app in {% data variables.product.prodname_marketplace %}. | | `delist` | Triggered when your listing is removed from {% data variables.product.prodname_marketplace %}. | -| `redraft` | Triggered when your listing is sent back to draft state. | +| `redraft` | Triggered when your listing is sent back to draft state. | | `reject` | Triggered when your listing is not accepted for inclusion in {% data variables.product.prodname_marketplace %}. | {% endif %} @@ -171,8 +171,8 @@ This list describes the available categories and associated events: For more information, see "[Restricting publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)." -| 동작 | 설명 | -|:------ |:--------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 동작 | 설명 | +|:------ |:---------------------------------------------------------------------------------------------------------------------------------------------------- | | `활성화` | Triggered when an organization owner enables publication of {% data variables.product.prodname_pages %} sites for repositories in the organization. | | `비활성화` | Triggered when an organization owner disables publication of {% data variables.product.prodname_pages %} sites for repositories in the organization. | @@ -180,34 +180,35 @@ For more information, see "[Restricting publication of {% data variables.product ##### The `org` category -| 동작 | 설명 | -| ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest"%} -| `audit_log_export` | Triggered when an organization admin [creates an export of the organization audit log](#exporting-the-audit-log). If the export included a query, the log will list the query used and the number of audit log entries matching that query. | -| `block_user` | Triggered when an organization owner [blocks a user from accessing the organization's repositories](/articles/blocking-a-user-from-your-organization). | -| `cancel_invitation` | Triggered when an organization invitation has been revoked. | -| `disable_oauth_app_restrictions` | Triggered when an owner [disables {% data variables.product.prodname_oauth_app %} access restrictions](/articles/disabling-oauth-app-access-restrictions-for-your-organization) for your organization. | -| `disable_saml` | Triggered when an organization admin disables SAML single sign-on for an organization.{% endif %} -| `disable_member_team_creation_permission` | Triggered when an organization owner limits team creation to owners. For more information, see "[Setting team creation permissions in your organization](/articles/setting-team-creation-permissions-in-your-organization)." | -| `disable_two_factor_requirement` | Triggered when an owner disables a two-factor authentication requirement for all members{% if currentVersion == "free-pro-team@latest" %}, billing managers,{% endif %} and outside collaborators in an organization.{% if currentVersion == "free-pro-team@latest" %} -| `enable_oauth_app_restrictions` | Triggered when an owner [enables {% data variables.product.prodname_oauth_app %} access restrictions](/articles/enabling-oauth-app-access-restrictions-for-your-organization) for your organization. | -| `enable_saml` | Triggered when an organization admin [enables SAML single sign-on](/articles/enabling-and-testing-saml-single-sign-on-for-your-organization) for an organization.{% endif %} -| `enable_member_team_creation_permission` | Triggered when an organization owner allows members to create teams. For more information, see "[Setting team creation permissions in your organization](/articles/setting-team-creation-permissions-in-your-organization)." | -| `enable_two_factor_requirement` | Triggered when an owner requires two-factor authentication for all members{% if currentVersion == "free-pro-team@latest" %}, billing managers,{% endif %} and outside collaborators in an organization. | -| `invite_member` | Triggered when [a new user was invited to join your organization](/articles/adding-organization-members-to-a-team).{% if currentVersion == "free-pro-team@latest" %} -| `oauth_app_access_approved` | Triggered when an owner [grants organization access to an {% data variables.product.prodname_oauth_app %}](/articles/approving-oauth-apps-for-your-organization/). | -| `oauth_app_access_denied` | Triggered when an owner [disables a previously approved {% data variables.product.prodname_oauth_app %}'s access](/articles/denying-access-to-a-previously-approved-oauth-app-for-your-organization) to your organization. | -| `oauth_app_access_requested` | Triggered when an organization member requests that an owner grant an {% data variables.product.prodname_oauth_app %} access to your organization.{% endif %}{% if currentVersion == "free-pro-team@latest" %} -| `remove_billing_manager` | Triggered when an [owner removes a billing manager from an organization](/articles/removing-a-billing-manager-from-your-organization/) or when [two-factor authentication is required in an organization](/articles/requiring-two-factor-authentication-in-your-organization) and a billing manager doesn't use 2FA or disables 2FA. |{% endif %} -| `remove_member` | Triggered when an [owner removes a member from an organization](/articles/removing-a-member-from-your-organization/) or when [two-factor authentication is required in an organization](/articles/requiring-two-factor-authentication-in-your-organization) and an organization member doesn't use 2FA or disables 2FA. Also triggered when an [organization member removes themselves](/articles/removing-yourself-from-an-organization/) from an organization. | -| `remove_outside_collaborator` | Triggered when an owner removes an outside collaborator from an organization or when [two-factor authentication is required in an organization](/articles/requiring-two-factor-authentication-in-your-organization) and an outside collaborator does not use 2FA or disables 2FA. |{% if currentVersion == "free-pro-team@latest" %} -| `revoke_external_identity` | Triggered when an organization owner revokes a member's linked identity. For more information, see "[Viewing and managing a member's SAML access to your organization](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization#viewing-and-revoking-a-linked-identity)." | -| `revoke_sso_session` | Triggered when an organization owner revokes a member's SAML session. For more information, see "[Viewing and managing a member's SAML access to your organization](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization#viewing-and-revoking-a-linked-identity)." | -| `unblock_user` | Triggered when an organization owner [unblocks a user from an organization](/articles/unblocking-a-user-from-your-organization).{% endif %} -| `update_default_repository_permission` | Triggered when an owner changes the default repository permission level for organization members. | -| `update_member` | Triggered when an owner changes a person's role from owner to member or member to owner. | -| `update_member_repository_creation_permission` | Triggered when an owner changes the create repository permission for organization members.{% if currentVersion == "free-pro-team@latest" %} -| `update_saml_provider_settings` | Triggered when an organization's SAML provider settings are updated. | -| `update_terms_of_service` | Triggered when an organization changes between the Standard Terms of Service and the Corporate Terms of Service. For more information, see "[Upgrading to the Corporate Terms of Service](/articles/upgrading-to-the-corporate-terms-of-service)."{% endif %} +| 동작 | 설명 | +| ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest"%} +| `audit_log_export` | Triggered when an organization admin [creates an export of the organization audit log](#exporting-the-audit-log). If the export included a query, the log will list the query used and the number of audit log entries matching that query. | +| `block_user` | Triggered when an organization owner [blocks a user from accessing the organization's repositories](/articles/blocking-a-user-from-your-organization). | +| `cancel_invitation` | Triggered when an organization invitation has been revoked. | +| `disable_oauth_app_restrictions` | Triggered when an owner [disables {% data variables.product.prodname_oauth_app %} access restrictions](/articles/disabling-oauth-app-access-restrictions-for-your-organization) for your organization. | +| `disable_saml` | Triggered when an organization admin disables SAML single sign-on for an organization.{% endif %} +| `disable_member_team_creation_permission` | Triggered when an organization owner limits team creation to owners. For more information, see "[Setting team creation permissions in your organization](/articles/setting-team-creation-permissions-in-your-organization)." | +| `disable_two_factor_requirement` | Triggered when an owner disables a two-factor authentication requirement for all members{% if currentVersion == "free-pro-team@latest" %}, billing managers,{% endif %} and outside collaborators in an organization.{% if currentVersion == "free-pro-team@latest" %} +| `enable_oauth_app_restrictions` | Triggered when an owner [enables {% data variables.product.prodname_oauth_app %} access restrictions](/articles/enabling-oauth-app-access-restrictions-for-your-organization) for your organization. | +| `enable_saml` | Triggered when an organization admin [enables SAML single sign-on](/articles/enabling-and-testing-saml-single-sign-on-for-your-organization) for an organization.{% endif %} +| `enable_member_team_creation_permission` | Triggered when an organization owner allows members to create teams. For more information, see "[Setting team creation permissions in your organization](/articles/setting-team-creation-permissions-in-your-organization)." | +| `enable_two_factor_requirement` | Triggered when an owner requires two-factor authentication for all members{% if currentVersion == "free-pro-team@latest" %}, billing managers,{% endif %} and outside collaborators in an organization. | +| `invite_member` | Triggered when [a new user was invited to join your organization](/articles/adding-organization-members-to-a-team).{% if currentVersion == "free-pro-team@latest" %} +| `oauth_app_access_approved` | Triggered when an owner [grants organization access to an {% data variables.product.prodname_oauth_app %}](/articles/approving-oauth-apps-for-your-organization/). | +| `oauth_app_access_denied` | Triggered when an owner [disables a previously approved {% data variables.product.prodname_oauth_app %}'s access](/articles/denying-access-to-a-previously-approved-oauth-app-for-your-organization) to your organization. | +| `oauth_app_access_requested` | Triggered when an organization member requests that an owner grant an {% data variables.product.prodname_oauth_app %} access to your organization.{% endif %}{% if currentVersion == "free-pro-team@latest" %} +| `remove_billing_manager` | Triggered when an [owner removes a billing manager from an organization](/articles/removing-a-billing-manager-from-your-organization/) or when [two-factor authentication is required in an organization](/articles/requiring-two-factor-authentication-in-your-organization) and a billing manager doesn't use 2FA or disables 2FA. |{% endif %} +| `remove_member` | Triggered when an [owner removes a member from an organization](/articles/removing-a-member-from-your-organization/) or when [two-factor authentication is required in an organization](/articles/requiring-two-factor-authentication-in-your-organization) and an organization member doesn't use 2FA or disables 2FA. Also triggered when an [organization member removes themselves](/articles/removing-yourself-from-an-organization/) from an organization. | +| `remove_outside_collaborator` | Triggered when an owner removes an outside collaborator from an organization or when [two-factor authentication is required in an organization](/articles/requiring-two-factor-authentication-in-your-organization) and an outside collaborator does not use 2FA or disables 2FA. |{% if currentVersion == "free-pro-team@latest" %} +| `revoke_external_identity` | Triggered when an organization owner revokes a member's linked identity. For more information, see "[Viewing and managing a member's SAML access to your organization](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization#viewing-and-revoking-a-linked-identity)." | +| `revoke_sso_session` | Triggered when an organization owner revokes a member's SAML session. For more information, see "[Viewing and managing a member's SAML access to your organization](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization#viewing-and-revoking-a-linked-identity)." | +| `unblock_user` | Triggered when an organization owner [unblocks a user from an organization](/articles/unblocking-a-user-from-your-organization).{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +| `update_new_repository_default_branch_setting` | Triggered when an owner changes the name of the default branch for new repositories in the organization. For more information, see "[Managing the default branch name for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization)."{% endif %} +| `update_default_repository_permission` | Triggered when an owner changes the default repository permission level for organization members. | +| `update_member` | Triggered when an owner changes a person's role from owner to member or member to owner. | +| `update_member_repository_creation_permission` | Triggered when an owner changes the create repository permission for organization members.{% if currentVersion == "free-pro-team@latest" %} +| `update_saml_provider_settings` | Triggered when an organization's SAML provider settings are updated. | +| `update_terms_of_service` | Triggered when an organization changes between the Standard Terms of Service and the Corporate Terms of Service. For more information, see "[Upgrading to the Corporate Terms of Service](/articles/upgrading-to-the-corporate-terms-of-service)."{% endif %} {% if currentVersion == "free-pro-team@latest" %} ##### The `org_credential_authorization` category @@ -233,8 +234,8 @@ For more information, see "[Restricting publication of {% data variables.product ##### The `oauth_application` category -| 동작 | 설명 | -| --------------- | ----------------------------------------------------------------------------------------------------------------------- | +| 동작 | 설명 | +| --------------- | ------------------------------------------------------------------------------------------------------------------ | | `create` | Triggered when a new {% data variables.product.prodname_oauth_app %} is created. | | `destroy` | Triggered when an existing {% data variables.product.prodname_oauth_app %} is deleted. | | `reset_secret` | Triggered when an {% data variables.product.prodname_oauth_app %}'s client secret is reset. | @@ -274,46 +275,46 @@ For more information, see "[Restricting publication of {% data variables.product ##### The `protected_branch` category -| 동작 | 설명 | -| ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `create` | Triggered when branch protection is enabled on a branch. | -| `destroy` | Triggered when branch protection is disabled on a branch. | -| `update_admin_enforced` | Triggered when branch protection is enforced for repository administrators. | -| `update_require_code_owner_review` | Triggered when enforcement of required Code Owner review is updated on a branch. | -| `dismiss_stale_reviews` | Triggered when enforcement of dismissing stale pull requests is updated on a branch. | -| `update_signature_requirement_enforcement_level` | Triggered when enforcement of required commit signing is updated on a branch. | -| `update_pull_request_reviews_enforcement_level` | Triggered when enforcement of required pull request reviews is updated on a branch. | -| `update_required_status_checks_enforcement_level` | Triggered when enforcement of required status checks is updated on a branch. | -| `update_strict_required_status_checks_policy` | Triggered when the requirement for a branch to be up to date before merging is changed. | -| `rejected_ref_update` | Triggered when a branch update attempt is rejected. | +| 동작 | 설명 | +| ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `create` | Triggered when branch protection is enabled on a branch. | +| `destroy` | Triggered when branch protection is disabled on a branch. | +| `update_admin_enforced` | Triggered when branch protection is enforced for repository administrators. | +| `update_require_code_owner_review` | Triggered when enforcement of required Code Owner review is updated on a branch. | +| `dismiss_stale_reviews` | Triggered when enforcement of dismissing stale pull requests is updated on a branch. | +| `update_signature_requirement_enforcement_level` | Triggered when enforcement of required commit signing is updated on a branch. | +| `update_pull_request_reviews_enforcement_level` | Triggered when enforcement of required pull request reviews is updated on a branch. | +| `update_required_status_checks_enforcement_level` | Triggered when enforcement of required status checks is updated on a branch. | +| `update_strict_required_status_checks_policy` | Triggered when the requirement for a branch to be up to date before merging is changed. | +| `rejected_ref_update` | Triggered when a branch update attempt is rejected. | | `policy_override` | Triggered when a branch protection requirement is overridden by a repository administrator.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -| `update_allow_force_pushes_enforcement_level` | Triggered when force pushes are enabled or disabled for a protected branch. | -| `update_allow_deletions_enforcement_level` | Triggered when branch deletion is enabled or disabled for a protected branch. | -| `update_linear_history_requirement_enforcement_level` | Triggered when required linear commit history is enabled or disabled for a protected branch. | +| `update_allow_force_pushes_enforcement_level` | Triggered when force pushes are enabled or disabled for a protected branch. | +| `update_allow_deletions_enforcement_level` | Triggered when branch deletion is enabled or disabled for a protected branch. | +| `update_linear_history_requirement_enforcement_level` | Triggered when required linear commit history is enabled or disabled for a protected branch. | {% endif %} ##### The `repo` category -| 동작 | 설명 | -| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `액세스` | Triggered when a repository owned by an organization is [switched from "private" to "public"](/articles/making-a-private-repository-public) (or vice versa). | -| `add_member` | Triggered when a user accepts an [invitation to have collaboration access to a repository](/articles/inviting-collaborators-to-a-personal-repository). | -| `add_topic` | Triggered when a repository admin [adds a topic](/articles/classifying-your-repository-with-topics) to a repository. | +| 동작 | 설명 | +| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `액세스` | Triggered when a repository owned by an organization is [switched from "private" to "public"](/articles/making-a-private-repository-public) (or vice versa). | +| `add_member` | Triggered when a user accepts an [invitation to have collaboration access to a repository](/articles/inviting-collaborators-to-a-personal-repository). | +| `add_topic` | Triggered when a repository admin [adds a topic](/articles/classifying-your-repository-with-topics) to a repository. | | `archived` | Triggered when a repository admin [archives a repository](/articles/about-archiving-repositories).{% if currentVersion != "free-pro-team@latest" %} | `config.disable_anonymous_git_access` | Triggered when [anonymous Git read access is disabled](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) in a public repository. | | `config.enable_anonymous_git_access` | Triggered when [anonymous Git read access is enabled](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) in a public repository. | | `config.lock_anonymous_git_access` | Triggered when a repository's [anonymous Git read access setting is locked](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access). | | `config.unlock_anonymous_git_access` | Triggered when a repository's [anonymous Git read access setting is unlocked](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access).{% endif %} -| `create` | Triggered when [a new repository is created](/articles/creating-a-new-repository). | +| `create` | Triggered when [a new repository is created](/articles/creating-a-new-repository). | | `destroy` | Triggered when [a repository is deleted](/articles/deleting-a-repository).{% if currentVersion == "free-pro-team@latest" %} | `비활성화` | Triggered when a repository is disabled (e.g., for [insufficient funds](/articles/unlocking-a-locked-account)).{% endif %} -| `활성화` | Triggered when a repository is reenabled. | -| `remove_member` | Triggered when a user is [removed from a repository as a collaborator](/articles/removing-a-collaborator-from-a-personal-repository). | -| `remove_topic` | Triggered when a repository admin removes a topic from a repository. | -| `rename` | Triggered when [a repository is renamed](/articles/renaming-a-repository). | -| `전송` | Triggered when [a repository is transferred](/articles/how-to-transfer-a-repository). | -| `transfer_start` | Triggered when a repository transfer is about to occur. | -| `unarchived` | Triggered when a repository admin unarchives a repository. | +| `활성화` | Triggered when a repository is reenabled. | +| `remove_member` | Triggered when a user is [removed from a repository as a collaborator](/articles/removing-a-collaborator-from-a-personal-repository). | +| `remove_topic` | Triggered when a repository admin removes a topic from a repository. | +| `rename` | Triggered when [a repository is renamed](/articles/renaming-a-repository). | +| `전송` | Triggered when [a repository is transferred](/articles/how-to-transfer-a-repository). | +| `transfer_start` | Triggered when a repository transfer is about to occur. | +| `unarchived` | Triggered when a repository admin unarchives a repository. | {% if currentVersion == "free-pro-team@latest" %} @@ -334,13 +335,13 @@ For more information, see "[Restricting publication of {% data variables.product {% endif %} ##### The `repository_vulnerability_alert` category -| 동작 | 설명 | -| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `create` | Triggered when {% data variables.product.product_name %} creates a [{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alert for a vulnerable dependency](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in a particular repository. | -| `해결` | Triggered when someone with write access to a repository [pushes changes to update and resolve a vulnerability](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in a project dependency. | -| `해제` | Triggered when an organization owner or person with admin access to the repository dismisses a | -| {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alert about a vulnerable dependency.{% if currentVersion == "free-pro-team@latest" %} | | -| `authorized_users_teams` | Triggered when an organization owner or a member with admin permissions to the repository [updates the list of people or teams authorized to receive {% data variables.product.prodname_dependabot_short %} alerts](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-github-dependabot-alerts) for vulnerable dependencies in the repository.{% endif %} +| 동작 | 설명 | +| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `create` | Triggered when {% data variables.product.product_name %} creates a [{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alert for a vulnerable dependency](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in a particular repository. | +| `해결` | Triggered when someone with write access to a repository [pushes changes to update and resolve a vulnerability](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in a project dependency. | +| `해제` | Triggered when an organization owner or person with admin access to the repository dismisses a | +| {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alert about a vulnerable dependency.{% if currentVersion == "free-pro-team@latest" %} | | +| `authorized_users_teams` | Triggered when an organization owner or a member with admin permissions to the repository [updates the list of people or teams authorized to receive {% data variables.product.prodname_dependabot_short %} alerts](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-github-dependabot-alerts) for vulnerable dependencies in the repository.{% endif %} {% if currentVersion == "free-pro-team@latest" %} ##### The `sponsors` category @@ -401,7 +402,6 @@ Using the qualifier `country`, you can filter actions in the audit log based on {% data reusables.audit_log.exported-log-keys-and-values %} {% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} ### Using the Audit log API {% note %} @@ -419,9 +419,7 @@ To ensure a secure IP and maintain compliance for your organization, you can use The GraphQL response can include data for up to 90 to 120 days. -For example, you can make a GraphQL request to see all the new organization members added to your organization. For more information, see the "[GraphQL API Audit Log](/v4/interface/auditentry/)." - -{% endif %} +For example, you can make a GraphQL request to see all the new organization members added to your organization. For more information, see the "[GraphQL API Audit Log](/graphql/reference/interfaces#auditentry/)." ### 더 읽을거리 diff --git a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md index 8018efc6f278..9245a95bb919 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md @@ -9,7 +9,9 @@ versions: The Standard Terms of Service is an agreement between {% data variables.product.prodname_dotcom %} and you as an individual. To enter into an agreement with {% data variables.product.prodname_dotcom %} on behalf of an entity, such as a company, non-profit, or group, organization owners can upgrade to the Corporate Terms of Service. -1. Contact {% data variables.contact.contact_support %} to request an upgrade to the Corporate Terms of Service. They will enable a banner on your organization's dashboard that will allow you to accept the Corporate Terms of Service. +1. 연락처 + +{% data variables.contact.contact_support %} to request an upgrade to the Corporate Terms of Service. They will enable a banner on your organization's dashboard that will allow you to accept the Corporate Terms of Service. {% data reusables.dashboard.access-org-dashboard %} 3. At the top of the page, to the right of the Terms of Service banner, click **Sign now**. ![Sign now button](/assets/images/help/organizations/sign-now-button.png) 4. Read the information about the Corporate Terms of Service, then select **Yes, I want to sign these terms on behalf of my business.** ![Check box to sign on behalf of your business](/assets/images/help/organizations/sign-on-behalf-business.png) diff --git a/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise-account/about-enterprise-accounts.md b/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise-account/about-enterprise-accounts.md index 27f37f6bb8a5..794f20cd77f9 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise-account/about-enterprise-accounts.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise-account/about-enterprise-accounts.md @@ -25,9 +25,7 @@ For more information about the differences between {% data variables.product.pro For more information about member access and management, see "[Managing users in your enterprise account](/articles/managing-users-in-your-enterprise-account)." -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} For more information about managing enterprise accounts using the GraphQL API, see "[Enterprise accounts](/v4/guides/managing-enterprise-accounts)." -{% endif %} ### Managing organizations linked to your enterprise account diff --git a/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md b/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md new file mode 100644 index 000000000000..7a75d8c7a30d --- /dev/null +++ b/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md @@ -0,0 +1,19 @@ +--- +title: Configuring the retention period for GitHub Actions artifacts and logs in your enterprise account +intro: 'Enterprise owners can configure the retention period for {% data variables.product.prodname_actions %} artifacts and logs in an enterprise account.' +product: '{% data reusables.gated-features.enterprise-accounts %}' +miniTocMaxHeadingLevel: 4 +versions: + free-pro-team: '*' + enterprise-server: '>=2.23' +--- + +{% data reusables.actions.about-artifact-log-retention %} + +## Setting the retention period for an enterprise + +{% data reusables.enterprise_site_admin_settings.access-settings %} +{% data reusables.enterprise_site_admin_settings.business %} +{% data reusables.enterprise-accounts.policies-tab %} +{% data reusables.enterprise-accounts.actions-tab %} +{% data reusables.github-actions.change-retention-period-for-artifacts-logs %} diff --git a/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account.md b/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account.md index 0394bd847ee7..de71be296c8f 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account.md @@ -13,13 +13,26 @@ By default, {% data variables.product.prodname_actions %} is enabled in all orga For more information about {% data variables.product.prodname_actions %}, see "[About {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)." - ### Managing {% data variables.product.prodname_actions %} permissions for your enterprise account +You can disable all workflows for an enterprise or set a policy that configures which actions can be used in an organization. + +{% data reusables.actions.actions-use-policy-settings %} + {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.actions-tab %} {% data reusables.actions.enterprise-actions-permissions %} +1. Click **Save**. + +### Allowing specific actions to run + +{% data reusables.actions.allow-specific-actions-intro %} + +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.policies-tab %} +{% data reusables.enterprise-accounts.actions-tab %} +1. Under **Policies**, select **Allow specific actions** and add your required actions to the list. ![Add actions to allow list](/assets/images/help/organizations/enterprise-actions-policy-allow-list.png) ### Enabling workflows for private repository forks diff --git a/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise-account/index.md b/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise-account/index.md index e14ce1d2467f..2eac95839d7b 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise-account/index.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise-account/index.md @@ -14,6 +14,7 @@ versions: {% topic_link_in_list /managing-your-enterprise-account %} {% link_in_list /about-enterprise-accounts %} {% link_in_list /viewing-the-subscription-and-usage-for-your-enterprise-account %} + {% link_in_list /managing-licenses-for-visual-studio-subscription-with-github-enterprise %} {% topic_link_in_list /managing-users-in-your-enterprise-account %} {% link_in_list /roles-for-an-enterprise-account %} {% link_in_list /inviting-people-to-manage-your-enterprise-account %} @@ -32,3 +33,4 @@ versions: {% link_in_list /configuring-saml-single-sign-on-and-scim-for-your-enterprise-account-using-okta %} {% link_in_list /enforcing-a-policy-on-dependency-insights-in-your-enterprise-account %} {% link_in_list /enforcing-github-actions-policies-in-your-enterprise-account %} + {% link_in_list /configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account %} diff --git a/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md b/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md new file mode 100644 index 000000000000..8b45bbac27d0 --- /dev/null +++ b/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md @@ -0,0 +1,42 @@ +--- +title: Managing licenses for Visual Studio subscription with GitHub Enterprise +intro: 'You can manage {% data variables.product.prodname_enterprise %} licensing for {% data variables.product.prodname_vss_ghe %}.' +redirect_from: + - /github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-the-github-enterprise-and-visual-studio-bundle + - /github/articles/about-the-github-and-visual-studio-bundle + - /articles/about-the-github-and-visual-studio-bundle +versions: + free-pro-team: '*' +--- + +### About {% data variables.product.prodname_vss_ghe %} + +{% data variables.product.prodname_vss_ghe %} is a combined offering from Microsoft that allows a subscriber to use both {% data variables.product.prodname_enterprise %} and {% data variables.product.prodname_vs %}. {% data variables.product.prodname_vss_ghe %} is available from Microsoft under the terms of the Microsoft Enterprise Agreement. For more information, see [{% data variables.product.prodname_vss_ghe %}](https://visualstudio.microsoft.com/subscriptions/visual-studio-github/) on the {% data variables.product.prodname_vs %} website. + +After you assign a license for {% data variables.product.prodname_vss_ghe %} to a subscriber, the subscriber will use the {% data variables.product.prodname_enterprise %} portion of the license by joining an organization in your enterprise account with a user account on {% data variables.product.prodname_dotcom_the_website %}. + +For more information about {% data variables.product.prodname_enterprise %}, see "[{% data variables.product.company_short %}'s products](/github/getting-started-with-github/githubs-products#github-enterprise)." For more information about accounts on {% data variables.product.prodname_dotcom_the_website %}, see "[Types of {% data variables.product.prodname_dotcom %} accounts](/github/getting-started-with-github/types-of-github-accounts)." + +### 빌드전 요구 사양 + +1. After you buy {% data variables.product.prodname_vss_ghe %}, contact {% data variables.contact.contact_enterprise_sales %} and mention "{% data variables.product.prodname_vss_ghe %}." You'll work with the Sales team to create an enterprise account on {% data variables.product.prodname_dotcom_the_website %}. If you already have an enterprise account on {% data variables.product.prodname_dotcom_the_website %}, or if you're not sure, please tell our Sales team. + +2. Assign licenses for {% data variables.product.prodname_vss_ghe %} to subscribers in {% data variables.product.prodname_vss_admin_portal_with_url %}. For more information about assigning licenses, see [Manage {% data variables.product.prodname_vs %} subscriptions with {% data variables.product.prodname_enterprise %}](https://docs.microsoft.com/en-us/visualstudio/subscriptions/assign-github) in the Microsoft Docs. + +3. On {% data variables.product.prodname_dotcom_the_website %}, create at least one organization owned by your enterprise account. For more information, see "[Adding organizations to your enterprise account](/github/setting-up-and-managing-your-enterprise-account/adding-organizations-to-your-enterprise-account)." + +4. The subscriber must create a user account on {% data variables.product.prodname_dotcom_the_website %}, and the email address for the account must be the same email address as the email address in the {% data variables.product.prodname_vs %} portal. For more information, see "[Signing up for {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/signing-up-for-github)" and "[Managing email preferences](/github/setting-up-and-managing-your-github-user-account/managing-email-preferences)." + +### Inviting a subscriber to use {% data variables.product.prodname_enterprise %} + +To use the {% data variables.product.prodname_enterprise %} portion of the license, the subscriber must join an organization owned by your enterprise account on {% data variables.product.prodname_dotcom_the_website %}. Organization owners can invite new members to an organization. For more information, see "[Inviting users to join your organization](/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization)." + +### Viewing {% data variables.product.prodname_enterprise %} licensing + +After assigning a license for {% data variables.product.prodname_vss_ghe %} in {% data variables.product.prodname_vss_admin_portal_with_url %}, you can view the number of {% data variables.product.prodname_enterprise %} licenses available to your enterprise account. For more information, see "[Viewing the subscription and usage for your enterprise account](/github/setting-up-and-managing-your-enterprise-account/viewing-the-subscription-and-usage-for-your-enterprise-account)." + +You can also see pending {% data variables.product.prodname_enterprise %} invitations to subscribers in {% data variables.product.prodname_vss_admin_portal_with_url %}. The list of pending invitations includes subscribers who are not yet members of at least one organization in your enterprise account. For more information, see "[Viewing people in your enterprise account](/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account#viewing-members-and-outside-collaborators)." + +### 더 읽을거리 + +- [Introducing Visual Studio subscriptions with GitHub Enterprise](https://docs.microsoft.com/en-us/visualstudio/subscriptions/access-github) in the Microsoft Docs diff --git a/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account.md b/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account.md index 2efd5be9d35a..112fd470eccf 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account.md @@ -16,6 +16,7 @@ You can view enterprise owners and billing managers, as well as a list of pendin {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.people-tab %} {% data reusables.enterprise-accounts.administrators-tab %} +1. Optionally, to view a list of pending invitations, click **_NUMBER_ pending**. !["NUMBER pending" button to the right of search and filter options](/assets/images/help/enterprises/administrators-pending.png) ### Viewing members and outside collaborators @@ -25,7 +26,8 @@ You can view all the {% data variables.product.prodname_ghe_cloud %} organizatio {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.people-tab %} -3. Optionally, to view a list of outside collaborators rather than the list of members, click **Outside collaborators**. ![Outside collaborators tab on the Organization members page](/assets/images/help/business-accounts/outside-collaborators-tab.png) +1. Optionally, to view a list of outside collaborators rather than the list of members, click **Outside collaborators**. ![Outside collaborators tab on the Organization members page](/assets/images/help/business-accounts/outside-collaborators-tab.png) +1. Optionally, to view a list of pending invitations, click **_NUMBER_ pending**. !["NUMBER pending" button to the right of search and filter options](/assets/images/help/enterprises/members-pending.png) ### 더 읽을거리 diff --git a/translations/ko-KR/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md b/translations/ko-KR/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md index bed3a948c7d1..5780503b33be 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md @@ -40,7 +40,7 @@ When you sign up for an account, {% data variables.product.product_name %} provi ### Changing your profile name -You can change the name that is displayed on your profile. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}This name may also be displayed next to comments you make on private repositories owned by an organization. For more information, see "[Managing the display of member names in your organization](/articles/managing-the-display-of-member-names-in-your-organization)."{% endif %} +You can change the name that is displayed on your profile. This name may also be displayed next to comments you make on private repositories owned by an organization. For more information, see "[Managing the display of member names in your organization](/articles/managing-the-display-of-member-names-in-your-organization)." {% data reusables.user_settings.access_settings %} 2. Under "Name", type the name you want to be displayed on your profile. ![Name field in profile settings](/assets/images/help/profile/name-field.png) @@ -101,12 +101,12 @@ If you select the "Busy" option, when people @mention your username, assign you When you participate in certain programs, {% data variables.product.prodname_dotcom %} automatically displays a badge on your profile. -| Badge | Program | 설명 | -| --------------------------------------------------------------- | ------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Badge | Program | 설명 | +| --------------------------------------------------------------- | -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | {% octicon "north-star" aria-label="The North Star icon" %} | **{% data variables.product.prodname_arctic_vault %} Contributor** | If you authored any commit(s) on the default branch of a repository that was archived in the 2020 Arctic Vault program, you'll get an {% data variables.product.prodname_arctic_vault %} Contributor badge on your profile. For more information on the program, see [{% data variables.product.prodname_archive %}](https://archiveprogram.github.com). | -| {% octicon "cpu" aria-label="The Developer Program icon" %} | **Developer Program Member** | If you're a registered member of the GitHub Developer Program, building an app with the GitHub API, you'll get a Developer Program Member badge on your profile. For more information on the GitHub Developer Program, see [GitHub Developer](/program/). | -| {% octicon "heart-fill" aria-label="The GitHub Sponsor icon" %} | **GitHub Sponsor** | If you sponsored an open source contributor through {% data variables.product.prodname_sponsors %} you'll get a GitHub Sponsor badge on your profile. For more information, see "[Sponsoring open source contributors](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-open-source-contributors)." | -| {% octicon "star-fill" aria-label="The star icon" %} | **Pro** | If you use {% data variables.product.prodname_pro %} you'll get a PRO badge on your profile. For more information about {% data variables.product.prodname_pro %}, see "[{% data variables.product.prodname_dotcom %}'s products](/github/getting-started-with-github/githubs-products#github-pro)." | +| {% octicon "cpu" aria-label="The Developer Program icon" %} | **Developer Program Member** | If you're a registered member of the GitHub Developer Program, building an app with the GitHub API, you'll get a Developer Program Member badge on your profile. For more information on the GitHub Developer Program, see [GitHub Developer](/program/). | +| {% octicon "heart-fill" aria-label="The GitHub Sponsor icon" %} | **GitHub Sponsor** | If you sponsored an open source contributor through {% data variables.product.prodname_sponsors %} you'll get a GitHub Sponsor badge on your profile. For more information, see "[Sponsoring open source contributors](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-open-source-contributors)." | +| {% octicon "star-fill" aria-label="The star icon" %} | **Pro** | If you use {% data variables.product.prodname_pro %} you'll get a PRO badge on your profile. For more information about {% data variables.product.prodname_pro %}, see "[{% data variables.product.prodname_dotcom %}'s products](/github/getting-started-with-github/githubs-products#github-pro)." | ### Disabling badges on your profile diff --git a/translations/ko-KR/content/github/setting-up-and-managing-your-github-profile/why-are-my-contributions-not-showing-up-on-my-profile.md b/translations/ko-KR/content/github/setting-up-and-managing-your-github-profile/why-are-my-contributions-not-showing-up-on-my-profile.md index 290149ce6b1e..d51d3d119b66 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-your-github-profile/why-are-my-contributions-not-showing-up-on-my-profile.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-your-github-profile/why-are-my-contributions-not-showing-up-on-my-profile.md @@ -67,7 +67,7 @@ Commits are only counted if they are made in the default branch or the `gh-pages If your commits are in a non-default or non-`gh-pages` branch and you'd like them to count toward your contributions, you will need to do one of the following: - [Open a pull request](/articles/creating-a-pull-request) to have your changes merged into the default branch or the `gh-pages` branch. -- [Change the default branch](/articles/setting-the-default-branch) of the repository. +- [Change the default branch](/github/administering-a-repository/changing-the-default-branch) of the repository. {% warning %} diff --git a/translations/ko-KR/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md b/translations/ko-KR/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md index 3077c45dba61..f0309009dde6 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md @@ -8,6 +8,12 @@ versions: enterprise-server: '*' --- +{% note %} + +**Note:** You cannot change your primary email address to an email that is already set to be your backup email address. + +{% endnote %} + {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.emails %} 3. If you'd like to add a new email address to set as your primary email address, under "Add email address", type a new email address and click **Add**. ![Add another email address button](/assets/images/help/settings/add_another_email_address.png) @@ -15,7 +21,8 @@ versions: 5. To remove the old email address from your account, next to the old email, click {% octicon "trashcan" aria-label="The trashcan symbol" %}. {% if currentVersion == "free-pro-team@latest" %} -6. Verify your new primary email address. Without a verified email address, you won't be able to use all of {% data variables.product.product_name %}'s features. For more information, see "[Verifying your email address](/articles/verifying-your-email-address)." +6. Verify your new primary email address. Without a verified email address, you won't be able to use all of +{% data variables.product.product_name %}'s features. For more information, see "[Verifying your email address](/articles/verifying-your-email-address)." {% endif %} ### 더 읽을거리 diff --git a/translations/ko-KR/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md b/translations/ko-KR/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md index 0a12f9f75b73..c83ea1cfd46b 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md @@ -17,7 +17,7 @@ versions: - You will **no longer** be able to sign into the converted user account. - You will **no longer** be able to create or modify gists owned by the converted user account. - An organization **cannot** be converted back to a user. - - The SSH keys, OAuth tokens, job profile, {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} reactions, {% endif %}and associated user information, **will not** be transferred to the organization. This is only true for the user account that's being converted, not any of the user account's collaborators. + - The SSH keys, OAuth tokens, job profile, reactions, and associated user information, **will not** be transferred to the organization. This is only true for the user account that's being converted, not any of the user account's collaborators. - Any commits made with the converted user account **will no longer be linked** to that account. The commits themselves **will** remain intact. {% endwarning %} diff --git a/translations/ko-KR/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md b/translations/ko-KR/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md index a778b1de4578..c396e07c17be 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md @@ -18,7 +18,9 @@ A collaborator is a person who has permissions to a project board you own. A col {% data reusables.project-management.click-menu %} {% data reusables.project-management.access-collaboration-settings %} {% data reusables.project-management.collaborator-option %} -5. Under "Search by username, full name or email address", type the collaborator's name, username, or {% data variables.product.prodname_dotcom %} email. ![The Collaborators section with the Octocat's username entered in the search field](/assets/images/help/projects/org-project-collaborators-find-name.png) +5. Under "Search by username, full name or email address", type the collaborator's name, username, or +{% data variables.product.prodname_dotcom %} email. + ![The Collaborators section with the Octocat's username entered in the search field](/assets/images/help/projects/org-project-collaborators-find-name.png) {% data reusables.project-management.add-collaborator %} 7. The new collaborator has read permissions by default. Optionally, next to the new collaborator's name, use the drop-down menu and choose a different permission level. ![The Collaborators section with the Permissions drop-down menu selected](/assets/images/help/projects/user-project-collaborators-edit-permissions.png) diff --git a/translations/ko-KR/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md b/translations/ko-KR/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md index 4d78fe980eb5..f18aa84c017b 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md @@ -1,6 +1,6 @@ --- title: Managing the default branch name for your repositories -intro: You can set a default branch name for all new repositories that you create. +intro: 'You can set the default branch name new repositories that you create on {% data variables.product.product_location %}.' versions: free-pro-team: '*' enterprise-server: '>=2.23' @@ -8,12 +8,10 @@ versions: ### About the default branch name -{% data reusables.branches.new-repo-default-branch %} This branch is currently named `master`, but you can set the default branch name to anything that makes sense for your development environment. +When you create a new repository on {% data variables.product.product_location %}, the repository contains one branch, which is the default branch. You can change the name that {% data variables.product.product_name %} uses for the default branch in new repositories you create. For more information about the default branch, see "[About branches](/github/collaborating-with-issues-and-pull-requests/about-branches#about-the-default-branch)." {% data reusables.branches.set-default-branch %} -{% data reusables.branches.rename-existing-branch %} - ### Setting the default branch name {% data reusables.user_settings.access_settings %} @@ -24,4 +22,4 @@ versions: ### 더 읽을거리 -- [Managing the default branch name for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization) +- "[Managing the default branch name for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization)" diff --git a/translations/ko-KR/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md b/translations/ko-KR/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md index b1ebf5868897..2444dad0695c 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md @@ -26,9 +26,9 @@ The repository owner has full control of the repository. In addition to all the - [Manage a repository's topics](/articles/classifying-your-repository-with-topics){% if currentVersion == "free-pro-team@latest" %} - Manage security and analysis settings. For more information, see "[Managing security and analysis settings for your user account](/github/setting-up-and-managing-your-github-user-account/managing-security-and-analysis-settings-for-your-user-account)."{% endif %}{% if currentVersion == "free-pro-team@latest" %} - [Enable the dependency graph](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) for a private repository{% endif %}{% if currentVersion == "free-pro-team@latest" %} -- Delete packages. For more information, see "[Deleting a package](/github/managing-packages-with-github-packages/deleting-a-package)."{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} +- Delete packages. For more information, see "[Deleting a package](/github/managing-packages-with-github-packages/deleting-a-package)."{% endif %} - Create and edit repository social cards. For more information, see "[Customizing your repository's social media preview](/articles/customizing-your-repositorys-social-media-preview)." -- Make the repository a template. For more information, see "[Creating a template repository](/articles/creating-a-template-repository)."{% endif %} +- Make the repository a template. For more information, see "[Creating a template repository](/articles/creating-a-template-repository)." - Receive [{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in a repository.{% if currentVersion == "free-pro-team@latest" %} - Dismiss {% data variables.product.prodname_dependabot_alerts %} in your repository. For more information, see "[Viewing and updating vulnerable dependencies in your repository](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)." - [Manage data usage for your private repository](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository){% endif %} @@ -65,8 +65,7 @@ Collaborators on a personal repository can: - Act as a designated code owner for the repository. For more information, see "[About code owners](/articles/about-code-owners)." - Lock a conversation. For more information, see "[Locking conversations](/articles/locking-conversations)."{% if currentVersion == "free-pro-team@latest" %} - Report abusive content to {% data variables.contact.contact_support %}. For more information, see "[Reporting abuse or spam](/articles/reporting-abuse-or-spam)."{% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -- Transfer an issue to a different repository. For more information, see "[Transferring an issue to another repository](/articles/transferring-an-issue-to-another-repository)."{% endif %} +- Transfer an issue to a different repository. For more information, see "[Transferring an issue to another repository](/articles/transferring-an-issue-to-another-repository)." ### 더 읽을거리 diff --git a/translations/ko-KR/content/github/site-policy/github-additional-product-terms.md b/translations/ko-KR/content/github/site-policy/github-additional-product-terms.md index bdab08884a5b..131c0a0f475b 100644 --- a/translations/ko-KR/content/github/site-policy/github-additional-product-terms.md +++ b/translations/ko-KR/content/github/site-policy/github-additional-product-terms.md @@ -42,11 +42,11 @@ GitHub Pages are subject to some specific bandwidth and usage limits, and may no ### 5. Actions and Packages #### a. Actions Usage -GitHub Actions enables you to create custom software development lifecycle workflows directly in your GitHub repository. Each Account comes with included compute and storage quantities for use with Actions, depending on your Account plan, which can be found in the [Actions documentation](/github/automating-your-workflow-with-github-actions/about-github-actions#about-github-actions). Your Actions compute usage is displayed within [your Account settings](https://github.com/settings/billing), and you will be notified by email in advance of reaching the limit of your included quantities. If you want to use Actions beyond your included quantities, then you may [enable overages](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions). +GitHub Actions enables you to create custom software development lifecycle workflows directly in your GitHub repository. Each Account comes with included compute and storage quantities for use with Actions, depending on your Account plan, which can be found in the [Actions documentation](/actions). Your Actions compute usage is displayed within [your Account settings](https://github.com/settings/billing), and you will be notified by email in advance of reaching the limit of your included quantities. If you want to use Actions beyond your included quantities, then you may [enable overages](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions). -Compute usage for included and paid quantities is calculated in minutes based on the type of Actions you execute (e.g. Linux, Windows, macOS). The minutes used for each Action's job or task will be rounded up to the nearest minute. For included quantities and depending on the type of Action, a multiplier may be applied to the amount of time used to execute each job or task, prior to being rounded up to the nearest minute. Overage minutes are charged at the [stated per minute price](https://github.com/features/actions) based on the type of Actions you execute. Actions and Packages share storage, and your storage usage is displayed within your [account settings](https://github.com/settings/billing). For additional details about included quantity usage calculations, see the [Actions documentation](/github/automating-your-workflow-with-github-actions/about-github-actions#about-github-actions). +Compute usage for included and paid quantities is calculated in minutes based on the type of Actions you execute (e.g. Linux, Windows, macOS). The minutes used for each Action's job or task will be rounded up to the nearest minute. For included quantities and depending on the type of Action, a multiplier may be applied to the amount of time used to execute each job or task, prior to being rounded up to the nearest minute. Overage minutes are charged at the [stated per minute price](https://github.com/features/actions) based on the type of Actions you execute. Actions and Packages share storage, and your storage usage is displayed within your [account settings](https://github.com/settings/billing). For additional details about included quantity usage calculations, see the [Actions documentation](/actions). -Actions and any elements of the Action service may not be used in violation of the Agreement, the [Acceptable Use Policy](/github/site-policy/github-acceptable-use-policies), or the GitHub Actions [service limitations](/github/automating-your-workflow-with-github-actions/about-github-actions#usage-limits). Additionally, Actions should not be used for: +Actions and any elements of the Action service may not be used in violation of the Agreement, the [Acceptable Use Policy](/github/site-policy/github-acceptable-use-policies), or the GitHub Actions [service limitations](/actions/reference/usage-limits-billing-and-administration/#usage-limits). Additionally, Actions should not be used for: - cryptomining; - using our servers to disrupt, or to gain or to attempt to gain unauthorized access to, any service, device, data, account or network (other than those authorized by the [GitHub Bug Bounty program](https://bounty.github.com)) - the provision of a stand-alone or integrated application or service offering Actions or any elements of Actions for commercial purposes; diff --git a/translations/ko-KR/content/github/site-policy/github-enterprise-service-level-agreement.md b/translations/ko-KR/content/github/site-policy/github-enterprise-service-level-agreement.md index 05f57e0ebefe..7b9e3dca807c 100644 --- a/translations/ko-KR/content/github/site-policy/github-enterprise-service-level-agreement.md +++ b/translations/ko-KR/content/github/site-policy/github-enterprise-service-level-agreement.md @@ -8,8 +8,6 @@ versions: free-pro-team: '*' --- -# GitHub Enterprise Service Level Agreement - **Short version:** GitHub guarantees a 99.9% quarterly uptime commitment for the GitHub Enterprise Cloud service (the “**Service Level**” or “**SLA**”). If GitHub does not meet the SLA, then Customer will be entitled to a service credit to Customer’s account (“**Service Credits**”). For definitions of each Service feature (“**Service Feature**”) and to review historical and current Uptime, visit the [GitHub Status Page](https://www.githubstatus.com/). Capitalized terms used but not defined in this SLA have the meaning assigned in Customer’s applicable agreement. @@ -20,7 +18,7 @@ For definitions of each Service feature (“**Service Feature**”) and to revi | **Service Feature** | **Uptime Calculation** | **정의** | **Service Credits Calculation** | | --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | -| The **Service** includes the following Service Features:
    • 문제
    • 풀 리퀘스트
    • Git Operations
    • API Requests
    • Webhooks
    • Pages
    • Actions
    • Packages
    | (total minutes in a calendar quarter - Downtime) / total minutes in a calendar quarter | “**Downtime**” is a period of time where either (a) the error rate exceeds five percent (5%) in a given minute for any Service Feature or (b) the Service was unavailable as determined by a combination of GitHub's internal and external monitoring systems. | A Service Credits claim may be based on either (not both) of the following calculations:
    • 10% of the amount Customer paid for a Service Feature in a calendar quarter where the Uptime for that Service Feature was less than 99.9%, but greater than 99.0%.

      OR

    • 25% of the amount Customer paid for a Service Feature in a calendar quarter where the Uptime of that Service Feature was less than 99.0%.
    | | +| The **Service** includes the following Service Features:
    • 문제
    • 풀 리퀘스트
    • Git Operations
    • API Requests
    • Webhooks
    • Pages
    • Actions
    • Packages
    | (total minutes in a calendar quarter - Downtime) / total minutes in a calendar quarter | “**Downtime**” is a period of time where either (a) the error rate exceeds five percent (5%) in a given minute for any Service Feature or (b) the Service was unavailable as determined by a combination of GitHub's internal and external monitoring systems. | A Service Credits claim may be based on either (not both) of the following calculations:
    • 10% of the amount Customer paid for a Service Feature in a calendar quarter where the Uptime for that Service Feature was less than or equal to 99.9%, but greater than 99.0%.

      OR

    • 25% of the amount Customer paid for a Service Feature in a calendar quarter where the Uptime of that Service Feature was less than 99.0%.
    | | | **Actions** | (Total Triggered Executions – Unavailable Executions) / (Total Triggered Executions) x 100 | “**Total Triggered Executions**” is the total number of all Actions executions triggered by Customer in a calendar quarter.

    “**Unavailable Executions**” is the total number of executions within Total Triggered Executions which failed to run in a calendar quarter. An execution failed to run when the Actions history log did not capture any output five (5) minutes after the trigger was successfully fired. | Same as above | | **Packages** | Transfers Uptime = same as Actions

    Storage Uptime = 100% - Average Error Rate*

    *The Uptime Calculation excludes public usage and storage transactions that do not count toward either Total Storage Transactions or Failed Storage Transactions (including pre-authentication failures; authentication failures; attempted transactions for storage accounts over their prescribed quotas). | “**Error Rate**” is the total number of Failed Storage Transactions divided by the Total Storage Transactions during a set time interval (currently set at one hour). If the Total Storage Transactions in a given one-hour interval is zero, the error rate for that interval is 0%.

    “**Average Error Rate**” is the sum of Error Rates for each hour in a calendar quarter divided by the total number of hours in a calendar quarter. | Same as above | diff --git a/translations/ko-KR/content/github/site-policy/github-privacy-statement.md b/translations/ko-KR/content/github/site-policy/github-privacy-statement.md index 13fefc43598c..7eb8b113c6b3 100644 --- a/translations/ko-KR/content/github/site-policy/github-privacy-statement.md +++ b/translations/ko-KR/content/github/site-policy/github-privacy-statement.md @@ -11,7 +11,7 @@ versions: free-pro-team: '*' --- -Effective date: July 22, 2020 +Effective date: October 2, 2020 Thanks for entrusting GitHub Inc. (“GitHub”, “we”) with your source code, your projects, and your personal information. Holding on to your private information is a serious responsibility, and we want you to know how we're handling it. @@ -219,15 +219,15 @@ That said, the email address you have supplied [via your Git commit settings](/g #### Cookies -GitHub uses cookies to make interactions with our service easy and meaningful. Cookies are small text files that websites often store on computer hard drives or mobile devices of visitors. We use cookies (and similar technologies, like HTML5 localStorage) to keep you logged in, remember your preferences, and provide information for future development of GitHub. For security purposes, we use cookies to identify a device. By using our Website, you agree that we can place these types of cookies on your computer or device. If you disable your browser or device’s ability to accept these cookies, you will not be able to log in or use GitHub’s services. +GitHub uses cookies and similar technologies (collectively, “cookies”) to make interactions with our service easy and meaningful. Cookies are small text files that websites often store on computer hard drives or mobile devices of visitors. We use cookies to provide you our services, for example, to keep you logged in, remember your preferences, identify your device for security purposes, and provide information for future development of GitHub. By using our Website, you agree that we can place these types of cookies on your computer or device. If you disable your browser or device’s ability to accept these cookies, you will not be able to log in or use GitHub’s services. -We provide a web page on [cookies and tracking](/github/site-policy/github-subprocessors-and-cookies) that describes the cookies we set, the needs we have for those cookies, and the types of cookies they are (temporary or permanent). It also lists our third-party analytics providers and other service providers, and details exactly which parts of our Website we permit them to track. +We provide more information about [cookies on GitHub](/github/site-policy/github-subprocessors-and-cookies#cookies-on-github) on our [GitHub Subprocessors and Cookies](/github/site-policy/github-subprocessors-and-cookies) page that describes the cookies we set, the needs we have for those cookies, and the expiration of such cookies. It also lists our third-party analytics providers and how you can control your cookie preference settings for such cookies. #### Tracking and analytics We use a number of third-party analytics and service providers to help us evaluate our Users' use of GitHub, compile statistical reports on activity, and improve our content and Website performance. We only use these third-party analytics providers on certain areas of our Website, and all of them have signed data protection agreements with us that limit the type of User Personal Information they can collect and the purpose for which they can process the information. In addition, we use our own internal analytics software to provide features and improve our content and performance. -Some browsers have incorporated "Do Not Track" (DNT) features that can send a signal to the websites you visit indicating you do not wish to be tracked. GitHub responds to browser DNT signals and follows the [W3C standard for responding to DNT signals](https://www.w3.org/TR/tracking-dnt/). If you have not enabled DNT on a browser that supports it, cookies on some parts of our Website will track your online browsing activity on other online services over time, though we do not permit third parties other than our analytics and service providers to track GitHub Users' activity over time on GitHub. +Some browsers have incorporated "Do Not Track" (DNT) features that can send a signal to the websites you visit indicating you do not wish to be tracked. GitHub responds to browser DNT signals and follows the [W3C standard for responding to DNT signals](https://www.w3.org/TR/tracking-dnt/). If you have not enabled DNT on a browser that supports it, cookies on some parts of our Website will track your online browsing activity on other online services over time, though we do not permit third parties other than our analytics and service providers to track GitHub Users' activity over time on GitHub. You can read more about DNT in our [Tracking on GitHub](/github/site-policy/github-subprocessors-and-cookies#tracking-on-github) section of our [GitHub Subprocessors and Cookies](/github/site-policy/github-subprocessors-and-cookies) page. ### How GitHub secures your information diff --git a/translations/ko-KR/content/github/site-policy/github-subprocessors-and-cookies.md b/translations/ko-KR/content/github/site-policy/github-subprocessors-and-cookies.md index 09004e7ab500..90e76e0821d0 100644 --- a/translations/ko-KR/content/github/site-policy/github-subprocessors-and-cookies.md +++ b/translations/ko-KR/content/github/site-policy/github-subprocessors-and-cookies.md @@ -10,7 +10,7 @@ versions: free-pro-team: '*' --- -Effective date: **August 12, 2020** +Effective date: **October 2, 2020** GitHub provides a great deal of transparency regarding how we use your data, how we collect your data, and with whom we share your data. To that end, we provide this page, which details [our subprocessors](#github-subprocessors), how we use [cookies](#cookies-on-github), and where and how we perform any [tracking on GitHub](#tracking-on-github). @@ -19,7 +19,7 @@ GitHub provides a great deal of transparency regarding how we use your data, how When we share your information with third party subprocessors, such as our vendors and service providers, we remain responsible for it. We work very hard to maintain your trust when we bring on new vendors, and we require all vendors to enter into data protection agreements with us that restrict their processing of Users' Personal Information (as defined in the [Privacy Statement](/articles/github-privacy-statement/)). | Name of Subprocessor | Description of Processing | Location of Processing | Corporate Location | -| -------------------- | -------------------------------------------------- | ---------------------- | ------------------ | +|:-------------------- |:-------------------------------------------------- |:---------------------- |:------------------ | | Automattic | Blogging service | United States | United States | | AWS Amazon | Data hosting | United States | United States | | Braintree (PayPal) | Subscription credit card payment processor | United States | United States | @@ -28,7 +28,7 @@ When we share your information with third party subprocessors, such as our vendo | DiscoverOrg | Marketing data enrichment service | United States | United States | | Eloqua | Marketing campaign automation | United States | United States | | Google Apps | Internal company infrastructure | United States | United States | -| Google Analytics | Website analytics and performance | United States | United States | +| Google Analytics | Analytics and performance | United States | United States | | LinkedIn Navigator | Marketing data enrichment service | United States | United States | | Magic Robot | Campaign reporting (Salesforce Add-on) | United States | United States | | MailChimp | Customer ticketing mail services provider | United States | United States | @@ -49,63 +49,49 @@ When we bring on a new subprocessor who handles our Users' Personal Information, ### Cookies on GitHub -GitHub uses cookies to make interactions with our service easy and meaningful. We use cookies (and similar technologies, like HTML5 localStorage) to keep you logged in, remember your preferences, provide information for future development of GitHub, and to advertise GitHub's products and services to you on third party sites. - -A cookie is a small piece of text that our web server stores on your computer or mobile device, which your browser sends to us when you return to our site. Cookies do not necessarily identify you if you are merely visiting GitHub; however, a cookie may store a unique identifier for each logged in user. We use cookies to keep you logged in, remember your preferences, and provide information for future development of GitHub. For security reasons, we use cookies to identify a device. By using our website, you agree that we can place these types of cookies on your computer or device. If you disable your browser or device’s ability to accept these cookies, you will not be able to log in or use GitHub’s services. On certain areas of the website, we may also use cookies to identify you and/or your device to advertise GitHub products and services to you on third party sites. - -GitHub sets the following cookies on our users for the following reasons: - -| Name of Cookie | Reason | -| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- | -| `user_session` | This cookie is used to log you in. | -| `logged_in` | This cookie is used to signal to us that the user is already logged in. | -| `dotcom_user` | This cookie is used to signal to us that the user is already logged in. | -| `_gh_sess` | This cookie is used for temporary application and framework state between pages like what step the user is on in a multiple step form. | -| `tz` | This cookie allows your browser to tell us what time zone you're in. | -| `gist_user_session` | This cookie is used by Gist when running on a separate host. | -| `saml_csrf_token` | This cookie is set by SAML auth path method to associate a token with the client. | -| `saml_return_to` | This cookie is set by the SAML auth path method to maintain state during the SAML authentication loop. | -| `gist_oauth_csrf` | This cookie is set by Gist to ensure the user that started the oauth flow is the same user that completes it. | -| `__Host-user_session_same_site` | This cookie is set to ensure that browsers that support SameSite cookies can check to see if a request originates from GitHub. | -| `__Host-gist_user_session_same_site` | This cookie is set to ensure that browsers that support SameSite cookies can check to see if a request originates from GitHub. | -| `_ga` | This cookie is used by Google Analytics. | -| `_gat` | This cookie is used by Google Analytics. | -| `_gid` | This cookie is used by Google Analytics. | -| `_octo` | This cookie is used by Octolytics, our internal analytics service, to distinguish unique users and clients. | -| `tracker` | This cookie tracks the referring source for signup analytics. | - -Certain pages on our site may set other third party cookies. For example, we may embed content, such as videos, from another site that sets a cookie. While we try to minimize these third party cookies, we can’t always control what cookies this third party content sets. +GitHub uses cookies and similar technologies (collectively, “cookies”) to provide and secure our websites, as well as to analyze the usage of our websites, in order to offer you a great user experience. Please take a look at our [Privacy Statement](/github/site-policy/github-privacy-statement#our-use-of-cookies-and-tracking) if you’d like more information about cookies, and on how and why we use them. + +Since the number and names of cookies may change,the table below may be updated from time to time. + +| Service Provider | Cookie Name | 설명 | Expiration* | +|:------------------ |:------------------------------------ |:------------------------------------------------------------------------------------------------------------------------------------------ |:------------------------------------------------------------- | +| GitHub | `app_manifest_token` | This cookie is used during the App Manifest flow to maintain the state of the flow during the redirect to fetch a user session. | five minutes | +| GitHub | `cookie-preferences` | This cookie is used to track user cookie preferences. | one year | +| GitHub | `_device_id` | This cookie is used to track recognized devices. | one year | +| GitHub | `dotcom_user` | This cookie is used to signal to us that the user is already logged in. | one year | +| GitHub | `_gh_ent` | This cookie is used for temporary application and framework state between pages like what step the customer is on in a multiple step form. | two weeks | +| GitHub | `_gh_sess` | This cookie is used for temporary application and framework state between pages like what step the user is on in a multiple step form. | 세션 | +| GitHub | `gist_oauth_csrf` | This cookie is set by Gist to ensure the user that started the oauth flow is the same user that completes it. | deleted when oauth state is validated | +| GitHub | `gist_user_session` | This cookie is used by Gist when running on a separate host. | two weeks | +| GitHub | `has_recent_activity` | This cookie is used to prevent showing the security interstitial to users that have visited the app recently. | one hour | +| GitHub | `__Host-gist_user_session_same_site` | This cookie is set to ensure that browsers that support SameSite cookies can check to see if a request originates from GitHub. | two weeks | +| GitHub | `__Host-user_session_same_site` | This cookie is set to ensure that browsers that support SameSite cookies can check to see if a request originates from GitHub. | two weeks | +| GitHub | `logged_in` | This cookie is used to signal to us that the user is already logged in. | one year | +| GitHub | `marketplace_repository_ids` | This cookie is used for the marketplace installation flow. | one hour | +| GitHub | `marketplace_suggested_target_id` | This cookie is used for the marketplace installation flow. | one hour | +| GitHub | `_octo` | This cookie is used by our internal analytics service to distinguish unique users and clients. | one year | +| GitHub | `org_transform_notice` | This cookie is used to provide notice during organization transforms. | one hour | +| GitHub | `private_mode_user_session` | This cookie is used for Enterprise authentication requests. | two weeks | +| GitHub | `saml_csrf_token` | This cookie is set by SAML auth path method to associate a token with the client. | until user closes browser or completes authentication request | +| GitHub | `saml_csrf_token_legacy` | This cookie is set by SAML auth path method to associate a token with the client. | until user closes browser or completes authentication request | +| GitHub | `saml_return_to` | This cookie is set by the SAML auth path method to maintain state during the SAML authentication loop. | until user closes browser or completes authentication request | +| GitHub | `saml_return_to_legacy` | This cookie is set by the SAML auth path method to maintain state during the SAML authentication loop. | until user closes browser or completes authentication request | +| GitHub | `tz` | This cookie allows your browser to tell us what time zone you're in. | 세션 | +| GitHub | `user_session` | This cookie is used to log you in. | two weeks | +| Google Analytics** | `_ga` | This cookie is used by Google Analytics. | two years | +| Google Analytics** | `_gat` | This cookie is used by Google Analytics. | one minute | +| Google Analytics** | `_gid` | This cookie is used by Google Analytics. | one day | + +_*_ The **expiration** dates for the cookies listed below generally apply on a rolling basis. + +_**_ We use **Google Analytics** as a third party analytics service to collect information about how our website performs and how our users, in general, navigate through and use GitHub. This helps us evaluate our users' use of GitHub, compile statistical reports on activity, and improve our content and website performance. + +You can control your Google Analytics cookie preferences through our cookie preference link located at the footer of our website. In addition, Google provides further information about its own privacy practices and [offers a browser add-on to opt out of Google Analytics tracking](https://tools.google.com/dlpage/gaoptout). + +(!) Please note certain pages on our website may set other third party cookies. For example, we may embed content, such as videos, from another site that sets a cookie. While we try to minimize these third party cookies, we can’t always control what cookies this third party content sets. ### Tracking on GitHub -"[Do Not Track](https://www.eff.org/issues/do-not-track)" (DNT) is a privacy preference you can set in your browser if you do not want online services — specifically ad networks — to collect and share certain kinds of information about your online activity from third party tracking services. GitHub responds to browser DNT signals and follows the [W3C standard for responding to DNT signals](https://www.w3.org/TR/tracking-dnt/). If you would like to set your browser to signal that you would not like to be tracked, please check your browser's documentation for how to enable that signal. There are also good applications that block online tracking, such as [Privacy Badger](https://www.eff.org/privacybadger). - -If you have not enabled DNT on a browser that supports it, cookies on some parts of our website will track your online browsing activity on other online services over time, though we do not permit third parties other than our analytics and service providers to track GitHub users' activity over time on GitHub. We use these cookies to allow us to advertise GitHub products and services to you on third party websites and services. We also have agreements with certain vendors, such as analytics providers, who help us track visitors' movements on certain pages on our site. Only our vendors, who are collecting personal information on our behalf, may collect data on our pages, and we have signed data protection agreements with every vendor who collects this data on our behalf. We use the data we receive from these vendors to better understand our visitors' interests, to understand our website's performance, and to improve our content. Any analytics vendor will be listed in our Subprocessor List above, and you may see a list of every page where we collect this kind of data below. - -#### Google Analytics - -We use Google Analytics as a third party analytics service, and to track our advertising campaigns on third party websites and services. We use Google Analytics to collect information about how our website performs and how our users, in general, navigate through and use GitHub. This helps us evaluate our users' use of GitHub; compile statistical reports on activity; and improve our content and website performance. Google provides further information about its own privacy practices and [offers a browser add-on to opt out of Google Analytics tracking](https://tools.google.com/dlpage/gaoptout). - -#### Pages on GitHub where analytics may be enabled - -Pages at URLs that contain any of the following domains and paths (including any subdomains or subpaths) on our sites may have analytics or other tracking code enabled. If you would like to prevent us from collecting information about your browsing activity on GitHub, you may use a tracking blocker such as [Privacy Badger](https://www.eff.org/privacybadger) or opt out of Google Analytics tracking. - -- github.com/home (if you are logged out or do not have an account, this is the page you will see when you go to github.com) -- github.com/about -- github.blog -- github.com/enterprise -- github.com/collections -- github.com/developer-stories -- github.com/events -- github.com/explore -- github.com/features -- github.com/logos -- github.com/nonprofit -- github.com/open-source -- github.com/personal -- github.com/pricing -- github.com/ten -- github.com/trending -- resources.github.com -- de.github.com -- fr.github.com +"[Do Not Track](https://www.eff.org/issues/do-not-track)" (DNT) is a privacy preference you can set in your browser if you do not want online services to collect and share certain kinds of information about your online activity from third party tracking services. GitHub responds to browser DNT signals and follows the [W3C standard for responding to DNT signals](https://www.w3.org/TR/tracking-dnt/). If you would like to set your browser to signal that you would not like to be tracked, please check your browser's documentation for how to enable that signal. There are also good applications that block online tracking, such as [Privacy Badger](https://www.eff.org/privacybadger). + +If you have not enabled DNT on a browser that supports it, cookies on some parts of our website will track your online browsing activity on other online services over time, though we do not permit third parties other than our analytics and service providers to track GitHub users' activity over time on GitHub. We have agreements with certain vendors, such as analytics providers, who help us track visitors' movements on certain pages on our website. Only our vendors, who are collecting personal information on our behalf, may collect data on our pages, and we have signed data protection agreements with every vendor who collects this data on our behalf. We use the data we receive from these vendors to better understand our visitors' interests, to understand our website's performance, and to improve our content. Any analytics vendor will be listed in our [subprocessor list](#github-subprocessors), and you may see a list of every page where we collect this kind of data below. diff --git a/translations/ko-KR/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md b/translations/ko-KR/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md index b95f1628faac..08af58419c96 100644 --- a/translations/ko-KR/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md +++ b/translations/ko-KR/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md @@ -50,7 +50,7 @@ To join {% data variables.product.prodname_sponsors %} as an individual contribu ### Submitting your bank information -As a sponsored organization, you must receive payouts to a dedicated bank account for your organization in a supported region. You can get a business bank account through services like [Open Collective](https://opencollective.com/) and [Stripe Atlas](https://stripe.com/atlas). {% data reusables.sponsors.stripe-supported-regions %} +As a sponsored organization, you must receive payouts to a dedicated bank account for your organization in a supported region. You can get a business bank account through services like [Open Collective](https://opencollective.com/) and [Stripe Atlas](https://stripe.com/atlas). The region your organization legally operates in and the region of your bank account must match. The person setting up {% data variables.product.prodname_sponsors %} for the organization must live in the same supported region, too. {% data reusables.sponsors.stripe-supported-regions %} {% data reusables.sponsors.double-check-stripe-info %} diff --git a/translations/ko-KR/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md b/translations/ko-KR/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md index d86dccc1fb63..83f2ce29f2aa 100644 --- a/translations/ko-KR/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md +++ b/translations/ko-KR/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md @@ -50,7 +50,7 @@ After {% data variables.product.prodname_dotcom %} reviews your application, you ### Submitting your bank information -If you live in a supported region, you can follow these instructions to submit your bank information by creating a Stripe Connect account. {% data reusables.sponsors.stripe-supported-regions %} +If you live in a supported region, you can follow these instructions to submit your bank information by creating a Stripe Connect account. Your region of residence and the region of your bank account must match. {% data reusables.sponsors.stripe-supported-regions %} {% data reusables.sponsors.double-check-stripe-info %} diff --git a/translations/ko-KR/content/github/using-git/about-git-subtree-merges.md b/translations/ko-KR/content/github/using-git/about-git-subtree-merges.md index b9d92a0c5d34..f55412064cf8 100644 --- a/translations/ko-KR/content/github/using-git/about-git-subtree-merges.md +++ b/translations/ko-KR/content/github/using-git/about-git-subtree-merges.md @@ -37,7 +37,7 @@ The best way to explain subtree merges is to show by example. We will: $ touch .gitignore $ git add .gitignore $ git commit -m "initial commit" - > [master (root-commit) 3146c2a] initial commit + > [main (root-commit) 3146c2a] initial commit > 0 files changed, 0 insertions(+), 0 deletions(-) > create mode 100644 .gitignore ``` @@ -55,29 +55,29 @@ The best way to explain subtree merges is to show by example. We will: > Receiving objects: 100% (1732/1732), 528.19 KiB | 621 KiB/s, done. > Resolving deltas: 100% (1086/1086), done. > From git://github.com/octocat/Spoon-Knife - > * [new branch] master -> Spoon-Knife/master + > * [new branch] main -> Spoon-Knife/main ``` 2. Merge the `Spoon-Knife` project into the local Git project. This doesn't change any of your files locally, but it does prepare Git for the next step. If you're using Git 2.9 or above: ```shell - $ git merge -s ours --no-commit --allow-unrelated-histories spoon-knife/master + $ git merge -s ours --no-commit --allow-unrelated-histories spoon-knife/main > Automatic merge went well; stopped before committing as requested ``` If you're using Git 2.8 or below: ```shell - $ git merge -s ours --no-commit spoon-knife/master + $ git merge -s ours --no-commit spoon-knife/main > Automatic merge went well; stopped before committing as requested ``` 3. Create a new directory called **spoon-knife**, and copy the Git history of the `Spoon-Knife` project into it. ```shell - $ git read-tree --prefix=spoon-knife/ -u spoon-knife/master + $ git read-tree --prefix=spoon-knife/ -u spoon-knife/main ``` 4. Commit the changes to keep them safe. ```shell $ git commit -m "Subtree merged in spoon-knife" - > [master fe0ca25] Subtree merged in spoon-knife + > [main fe0ca25] Subtree merged in spoon-knife ``` Although we've only added one subproject, any number of subprojects can be incorporated into a Git repository. @@ -99,7 +99,7 @@ $ git pull -s subtree remotename branchname For the example above, this would be: ```shell -$ git pull -s subtree spoon-knife master +$ git pull -s subtree spoon-knife main ``` ### 더 읽을거리 diff --git a/translations/ko-KR/content/github/using-git/pushing-commits-to-a-remote-repository.md b/translations/ko-KR/content/github/using-git/pushing-commits-to-a-remote-repository.md index d58b41b493bf..8984350f015b 100644 --- a/translations/ko-KR/content/github/using-git/pushing-commits-to-a-remote-repository.md +++ b/translations/ko-KR/content/github/using-git/pushing-commits-to-a-remote-repository.md @@ -12,7 +12,7 @@ versions: The `git push` command takes two arguments: * A remote name, for example, `origin` -* A branch name, for example, `master` +* A branch name, for example, `main` 예시: @@ -20,7 +20,7 @@ The `git push` command takes two arguments: git push <REMOTENAME> <BRANCHNAME> ``` -As an example, you usually run `git push origin master` to push your local changes to your online repository. +As an example, you usually run `git push origin main` to push your local changes to your online repository. ### Renaming branches @@ -84,7 +84,7 @@ git fetch upstream > remote: Total 62 (delta 27), reused 44 (delta 9) > Unpacking objects: 100% (62/62), done. > From https://{% data variables.command_line.codeblock %}/octocat/repo -> * [new branch] master -> upstream/master +> * [new branch] main -> upstream/main ``` When you're done making local changes, you can push your local branch to GitHub and [initiate a pull request](/articles/about-pull-requests). diff --git a/translations/ko-KR/content/github/using-git/splitting-a-subfolder-out-into-a-new-repository.md b/translations/ko-KR/content/github/using-git/splitting-a-subfolder-out-into-a-new-repository.md index efb51dfd04e1..91ced35d3642 100644 --- a/translations/ko-KR/content/github/using-git/splitting-a-subfolder-out-into-a-new-repository.md +++ b/translations/ko-KR/content/github/using-git/splitting-a-subfolder-out-into-a-new-repository.md @@ -33,7 +33,7 @@ If you create a new clone of the repository, you won't lose any of your Git hist {% endtip %} {% endwindows %} - - `BRANCH-NAME`: The default branch for your current project, for example, `master` or `gh-pages`. + - `BRANCH-NAME`: The default branch for your current project, for example, `main` or `gh-pages`. ```shell $ git filter-branch --prune-empty --subdirectory-filter FOLDER-NAME BRANCH-NAME # Filter the specified branch in your directory and remove empty commits diff --git a/translations/ko-KR/content/github/using-git/using-git-rebase-on-the-command-line.md b/translations/ko-KR/content/github/using-git/using-git-rebase-on-the-command-line.md index 09c6287a73f4..54e2b7620f8d 100644 --- a/translations/ko-KR/content/github/using-git/using-git-rebase-on-the-command-line.md +++ b/translations/ko-KR/content/github/using-git/using-git-rebase-on-the-command-line.md @@ -123,7 +123,7 @@ As before, Git is showing the commit message for you to edit. You can change the Since you've altered Git history, the usual `git push origin` **will not** work. You'll need to modify the command by "force-pushing" your latest changes: ```shell -$ git push origin master --force +$ git push origin main --force ``` {% warning %} diff --git a/translations/ko-KR/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md b/translations/ko-KR/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md index 073df4faf295..a1b5ac9cf60a 100644 --- a/translations/ko-KR/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md +++ b/translations/ko-KR/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md @@ -47,7 +47,6 @@ You can use the dependency graph to: {% if currentVersion == "free-pro-team@latest" %}To generate a dependency graph, {% data variables.product.product_name %} needs read-only access to the dependency manifest and lock files for a repository. The dependency graph is automatically generated for all public repositories and you can choose to enable it for private repositories. For information about enabling or disabling it for private repositories, see "[Exploring the dependencies of a repository](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository)."{% endif %} - {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %}If the dependency graph is not available in your system, your site administrator can enable the dependency graph and {% data variables.product.prodname_dependabot_short %} alerts. For more information, see "[Enabling alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server)."{% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %} If the dependency graph is not available in your system, your site administrator can enable the dependency graph and security alerts. For more information, see "[Enabling alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server)." @@ -60,15 +59,15 @@ When the dependency graph is first enabled, any manifest and lock files for supp The recommended formats explicitly define which versions are used for all direct and all indirect dependencies. If you use these formats, your dependency graph is more accurate. It also reflects the current build set up and enables the dependency graph to report vulnerabilities in both direct and indirect dependencies.{% if currentVersion == "free-pro-team@latest" %} Indirect dependencies that are inferred from a manifest file (or equivalent) are excluded from the checks for vulnerable dependencies.{% endif %} -| Package manager | 다국어 지원 | Recommended formats | All supported formats | -| --------------------------------------------------------------- | -------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------- | -| {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} | Composer | PHP | `composer.lock` | `composer.json`, `composer.lock` |{% endif %} -| `dotnet` CLI | .NET languages (C#, C++, F#, VB) | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj` | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj`, `packages.config` | -| Maven | Java, Scala | `pom.xml` | `pom.xml` | -| npm | JavaScript | `package-lock.json` | `package-lock.json`, `package.json` | -| Python PIP | Python | `requirements.txt`, `pipfile.lock` | `requirements.txt`, `pipfile.lock`, `setup.py`* | -| RubyGems | Ruby | `Gemfile.lock` | `Gemfile.lock`, `Gemfile`, `*.gemspec` | -| Yarn | JavaScript | `yarn.lock` | `package.json`, `yarn.lock` | +| Package manager | 다국어 지원 | Recommended formats | All supported formats | +| --------------- | -------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------- | +| Composer | PHP | `composer.lock` | `composer.json`, `composer.lock` | +| `dotnet` CLI | .NET languages (C#, C++, F#, VB) | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj` | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj`, `packages.config` | +| Maven | Java, Scala | `pom.xml` | `pom.xml` | +| npm | JavaScript | `package-lock.json` | `package-lock.json`, `package.json` | +| Python PIP | Python | `requirements.txt`, `pipfile.lock` | `requirements.txt`, `pipfile.lock`, `setup.py`* | +| RubyGems | Ruby | `Gemfile.lock` | `Gemfile.lock`, `Gemfile`, `*.gemspec` | +| Yarn | JavaScript | `yarn.lock` | `package.json`, `yarn.lock` | {% note %} diff --git a/translations/ko-KR/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md b/translations/ko-KR/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md index e9f2d419593e..d0b201ffb12a 100644 --- a/translations/ko-KR/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md +++ b/translations/ko-KR/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md @@ -26,7 +26,8 @@ The dependency graph shows the dependencies{% if currentVersion == "free-pro-tea #### Dependencies view {% if currentVersion == "free-pro-team@latest" %} -Dependencies are grouped by ecosystem. You can expand a dependency to view its dependencies. For dependencies on public repositories hosted on {% data variables.product.product_name %}, you can also click a dependency to view the repository. Dependencies on private repositories, private packages, or unrecognized files are shown in plain text. +Dependencies are grouped by ecosystem. You can expand a dependency to view its dependencies. For dependencies on public repositories hosted on +{% data variables.product.product_name %}, you can also click a dependency to view the repository. Dependencies on private repositories, private packages, or unrecognized files are shown in plain text. If vulnerabilities have been detected in the repository, these are shown at the top of the view for users with access to {% data variables.product.prodname_dependabot_alerts %}. @@ -35,7 +36,8 @@ If vulnerabilities have been detected in the repository, these are shown at the {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %} -Any direct and indirect dependencies that are specified in the repository's manifest or lock files are listed, grouped by ecosystem. If vulnerabilities have been detected in the repository, these are shown at the top of the view for users with access to {% data variables.product.prodname_dependabot_short %} alerts. +Any direct and indirect dependencies that are specified in the repository's manifest or lock files are listed, grouped by ecosystem. If vulnerabilities have been detected in the repository, these are shown at the top of the view for users with access to +{% data variables.product.prodname_dependabot_short %} alerts. {% note %} @@ -98,7 +100,8 @@ You can disable the dependency graph at any time by clicking **Disable** next to If your dependency graph is empty, there may be a problem with the file containing your dependencies. Check the file to ensure that it's correctly formatted for the file type. {% if currentVersion == "free-pro-team@latest" %} -If the file is correctly formatted, then check its size. The dependency graph ignores individual manifest and lock files that are over 0.5 Mb, unless you are a {% data variables.product.prodname_enterprise %} user. It processes up to 20 manifest or lock files per repository by default, so you can split dependencies into smaller files in subdirectories of the repository.{% endif %} +If the file is correctly formatted, then check its size. The dependency graph ignores individual manifest and lock files that are over 0.5 Mb, unless you are a +{% data variables.product.prodname_enterprise %} user. It processes up to 20 manifest or lock files per repository by default, so you can split dependencies into smaller files in subdirectories of the repository.{% endif %} If a manifest or lock file is not processed, its dependencies are omitted from the dependency graph and they can't be checked for vulnerable dependencies. diff --git a/translations/ko-KR/content/github/working-with-github-pages/about-github-pages-and-jekyll.md b/translations/ko-KR/content/github/working-with-github-pages/about-github-pages-and-jekyll.md index c411dae25336..80bc0ea4cc70 100644 --- a/translations/ko-KR/content/github/working-with-github-pages/about-github-pages-and-jekyll.md +++ b/translations/ko-KR/content/github/working-with-github-pages/about-github-pages-and-jekyll.md @@ -69,7 +69,8 @@ You can add `site.github` to a post or page to add any repository references met {% data reusables.pages.add-jekyll-theme %} For more information, see "[Themes](https://jekyllrb.com/docs/themes/)" in the Jekyll documentation. {% if currentVersion == "free-pro-team@latest" %} -You can add a supported theme to your site on {% data variables.product.prodname_dotcom %}. For more information, see "[Supported themes](https://pages.github.com/themes/)" on the {% data variables.product.prodname_pages %} site and "[Adding a theme to your {% data variables.product.prodname_pages %} site with the theme chooser](/articles/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser)." +You can add a supported theme to your site on +{% data variables.product.prodname_dotcom %}. For more information, see "[Supported themes](https://pages.github.com/themes/)" on the {% data variables.product.prodname_pages %} site and "[Adding a theme to your {% data variables.product.prodname_pages %} site with the theme chooser](/articles/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser)." To use any other open source Jekyll theme hosted on {% data variables.product.prodname_dotcom %}, you can add the theme manually.{% else %} You can add a theme to your site manually.{% endif %} For more information, see{% if currentVersion == "free-pro-team@latest" %} [themes hosted on {% data variables.product.prodname_dotcom %}](https://github.com/topics/jekyll-theme) and{% else %} "[Supported themes](https://pages.github.com/themes/)" on the {% data variables.product.prodname_pages %} site and{% endif %} "[Adding a theme to your {% data variables.product.prodname_pages %} site using Jekyll](/articles/adding-a-theme-to-your-github-pages-site-using-jekyll)." diff --git a/translations/ko-KR/content/github/working-with-github-pages/about-github-pages.md b/translations/ko-KR/content/github/working-with-github-pages/about-github-pages.md index e47d90e38283..bb3bd3def29b 100644 --- a/translations/ko-KR/content/github/working-with-github-pages/about-github-pages.md +++ b/translations/ko-KR/content/github/working-with-github-pages/about-github-pages.md @@ -20,13 +20,15 @@ versions: {% data variables.product.prodname_pages %} is a static site hosting service that takes HTML, CSS, and JavaScript files straight from a repository on {% data variables.product.product_name %}, optionally runs the files through a build process, and publishes a website. You can see examples of {% data variables.product.prodname_pages %} sites in the [{% data variables.product.prodname_pages %} examples collection](https://github.com/collections/github-pages-examples). {% if currentVersion == "free-pro-team@latest" %} -You can host your site on {% data variables.product.prodname_dotcom %}'s `github.io` domain or your own custom domain. For more information, see "[Using a custom domain with {% data variables.product.prodname_pages %}](/articles/using-a-custom-domain-with-github-pages)." +You can host your site on +{% data variables.product.prodname_dotcom %}'s `github.io` domain or your own custom domain. For more information, see "[Using a custom domain with {% data variables.product.prodname_pages %}](/articles/using-a-custom-domain-with-github-pages)." {% endif %} To get started, see "[Creating a {% data variables.product.prodname_pages %} site](/articles/creating-a-github-pages-site)." {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -Organization owners can disable the publication of {% data variables.product.prodname_pages %} sites from the organization's repositories. For more information, see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)." +Organization owners can disable the publication of +{% data variables.product.prodname_pages %} sites from the organization's repositories. For more information, see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)." {% endif %} ### Types of {% data variables.product.prodname_pages %} sites @@ -44,7 +46,8 @@ For more information about how custom domains affect the URL for your site, see You can only create one user or organization site for each {% data variables.product.product_name %} account. Project sites, whether owned by an organization or a user account, are unlimited. {% if currentVersion != "free-pro-team@latest" %} -The URL where your site is available depends on whether subdomain isolation is enabled for {% data variables.product.product_location %}. +The URL where your site is available depends on whether subdomain isolation is enabled for +{% data variables.product.product_location %}. | Type of site | Subdomain isolation enabled | Subdomain isolation disabled | | ------------ | --------------------------- | ---------------------------- | @@ -132,8 +135,9 @@ Additionally, {% data variables.product.prodname_pages %} sites must refrain fro - Get-rich-quick schemes - Sexually obscene content - Content that misrepresents your identity or site purpose +If you have questions about whether your use or intended use falls into these categories, please contact -If you have questions about whether your use or intended use falls into these categories, please contact {% data variables.contact.contact_support %}. +{% data variables.contact.contact_support %}. {% endif %} ### MIME types on {% data variables.product.prodname_pages %} diff --git a/translations/ko-KR/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md b/translations/ko-KR/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md index b7dd7e8d42a3..046a4b845774 100644 --- a/translations/ko-KR/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md +++ b/translations/ko-KR/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md @@ -34,9 +34,7 @@ For more information about troubleshooting build errors, see "[Troubleshooting J We recommend testing your site locally, which allows you to see build error messages on the command line, and addressing any build failures before pushing changes to {% data variables.product.product_name %}. For more information, see "[Testing your {% data variables.product.prodname_pages %} site locally with Jekyll](/articles/testing-your-github-pages-site-locally-with-jekyll)." -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} When you create a pull request to update your publishing source on {% data variables.product.product_name %}, you can see build error messages on the **Checks** tab of the pull request. For more information, see "[About status checks](/articles/about-status-checks)." -{% endif %} When you push changes to your publishing source on {% data variables.product.product_name %}, {% data variables.product.prodname_pages %} will attempt to build your site. If the build fails, you'll receive an email at your primary email address. You'll also receive emails for build warnings. {% data reusables.pages.build-failure-email-server %} diff --git a/translations/ko-KR/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md b/translations/ko-KR/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md index f00414bb47c8..0ef391cb481c 100644 --- a/translations/ko-KR/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md +++ b/translations/ko-KR/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md @@ -21,9 +21,9 @@ People with write permissions for a repository can add a theme to a {% data vari {% data reusables.pages.navigate-publishing-source %} 2. Navigate to *_config.yml*. {% data reusables.repositories.edit-file %} -4. Add a new line to the file for the theme name. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - - To use a supported theme, t{% else %}T{% endif %}ype `theme: THEME-NAME`, replacing _THEME-NAME_ with the name of the theme as shown in the README of the theme's repository. For a list of supported themes, see "[Supported themes](https://pages.github.com/themes/)" on the {% data variables.product.prodname_pages %} site. ![Supported theme in config file](/assets/images/help/pages/add-theme-to-config-file.png){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - - To use any other Jekyll theme hosted on {% data variables.product.prodname_dotcom %}, type `remote_theme: THEME-NAME`, replacing THEME-NAME with the name of the theme as shown in the README of the theme's repository. ![Unsupported theme in config file](/assets/images/help/pages/add-remote-theme-to-config-file.png){% endif %} +4. Add a new line to the file for the theme name. + - To use a supported theme, type `theme: THEME-NAME`, replacing _THEME-NAME_ with the name of the theme as shown in the README of the theme's repository. For a list of supported themes, see "[Supported themes](https://pages.github.com/themes/)" on the {% data variables.product.prodname_pages %} site. ![Supported theme in config file](/assets/images/help/pages/add-theme-to-config-file.png) + - To use any other Jekyll theme hosted on {% data variables.product.prodname_dotcom %}, type `remote_theme: THEME-NAME`, replacing THEME-NAME with the name of the theme as shown in the README of the theme's repository. ![Unsupported theme in config file](/assets/images/help/pages/add-remote-theme-to-config-file.png) {% data reusables.files.write_commit_message %} {% data reusables.files.choose-commit-email %} {% data reusables.files.choose_commit_branch %} diff --git a/translations/ko-KR/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md b/translations/ko-KR/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md index 74bedb474038..89122faaf86c 100644 --- a/translations/ko-KR/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md +++ b/translations/ko-KR/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md @@ -24,7 +24,9 @@ Before you configure a publishing source, make sure the branch{% if currentVersi 4. Optionally, use the drop-down menu to select a folder for your publishing source. ![Drop-down menu to select a folder for publishing source](/assets/images/help/pages/publishing-source-folder-drop-down.png) 5. Click **Save**. ![Button to save changes to publishing source settings](/assets/images/help/pages/publishing-source-save.png) {% else %} -3. Under "{% data variables.product.prodname_pages %}", use the **Source** drop-down menu and select a publishing source. ![Drop down menu to select a publishing source](/assets/images/help/pages/publishing-source-drop-down.png) +3. Under " +{% data variables.product.prodname_pages %}", use the **Source** drop-down menu and select a publishing source. + ![Drop down menu to select a publishing source](/assets/images/help/pages/publishing-source-drop-down.png) {% endif %} ### Troubleshooting publishing problems with your {% data variables.product.prodname_pages %} site diff --git a/translations/ko-KR/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md b/translations/ko-KR/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md index 1fd6cc753368..bd0ce93566e1 100644 --- a/translations/ko-KR/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md +++ b/translations/ko-KR/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md @@ -40,7 +40,8 @@ To set up a `www` or custom subdomain, such as `www.example.com` or `blog.exampl {% data reusables.pages.navigate-site-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.pages.save-custom-domain %} -5. Navigate to your DNS provider and create a `CNAME` record that points your subdomain to the default domain for your site. For example, if you want to use the subdomain `www.example.com` for your user site, create a `CNAME` record that points `www.example.com` to `.github.io`. If you want to use the subdomain `www.anotherexample.com` for your organization site, create a `CNAME` record that points `www.anotherexample.com` to `.github.io`. The `CNAME` file should always point to `.github.io` or `.github.io`, excluding the repository name. {% data reusables.pages.contact-dns-provider %}{% data reusables.pages.default-domain-information %} +5. Navigate to your DNS provider and create a `CNAME` record that points your subdomain to the default domain for your site. For example, if you want to use the subdomain `www.example.com` for your user site, create a `CNAME` record that points `www.example.com` to `.github.io`. If you want to use the subdomain `www.anotherexample.com` for your organization site, create a `CNAME` record that points `www.anotherexample.com` to `.github.io`. The `CNAME` file should always point to `.github.io` or `.github.io`, excluding the repository name. +{% data reusables.pages.contact-dns-provider %}{% data reusables.pages.default-domain-information %} {% data reusables.command_line.open_the_multi_os_terminal %} 6. To confirm that your DNS record configured correctly, use the `dig` command, replacing _WWW.EXAMPLE.COM_ with your subdomain. ```shell diff --git a/translations/ko-KR/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md b/translations/ko-KR/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md index b80619b0b0f5..fb8fa64e991b 100644 --- a/translations/ko-KR/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md +++ b/translations/ko-KR/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md @@ -21,7 +21,9 @@ versions: 3. If the `gh-pages` branch was your publishing source, {% if currentVersion == "free-pro-team@latest" %}skip to step 6{% else %}your site is now unpublished and you can skip the remaining steps{% endif %}. {% data reusables.repositories.sidebar-settings %} -5. Under "{% data variables.product.prodname_pages %}", use the **Source** drop-down menu and select **None.** ![Drop down menu to select a publishing source](/assets/images/help/pages/publishing-source-drop-down.png) +5. Under " +{% data variables.product.prodname_pages %}", use the **Source** drop-down menu and select **None.** + ![Drop down menu to select a publishing source](/assets/images/help/pages/publishing-source-drop-down.png) {% data reusables.pages.update_your_dns_settings %} ### Unpublishing a user or organization site diff --git a/translations/ko-KR/content/github/working-with-github-support/about-github-support.md b/translations/ko-KR/content/github/working-with-github-support/about-github-support.md index 225ca3796330..c91e7c31732d 100644 --- a/translations/ko-KR/content/github/working-with-github-support/about-github-support.md +++ b/translations/ko-KR/content/github/working-with-github-support/about-github-support.md @@ -11,13 +11,13 @@ versions: Support options vary depending on your {% data variables.product.prodname_dotcom_the_website %} product. If you have any paid product, you can contact {% data variables.contact.github_support %}, in English. Your account may also include {% data variables.contact.premium_support %}. -| | {% data variables.product.prodname_gcf %} | Standard support | Premium support | -| ------------------------------------------------------ | ---------------------------------------------- | ---------------- | --------------- | -| {% data variables.product.prodname_free_user %} | X | | | -| {% data variables.product.prodname_pro %} | X | X | | -| {% data variables.product.prodname_team %} | X | X | | -| {% data variables.product.prodname_ghe_cloud %} | X | X | X | -| {% data variables.product.prodname_ghe_server %} | X | X | X | +| | {% data variables.product.prodname_gcf %} | Standard support | Premium support | +| -------------------------------------------------- | ----------------------------------------- | ---------------- | --------------- | +| {% data variables.product.prodname_free_user %} | X | | | +| {% data variables.product.prodname_pro %} | X | X | | +| {% data variables.product.prodname_team %} | X | X | | +| {% data variables.product.prodname_ghe_cloud %} | X | X | X | +| {% data variables.product.prodname_ghe_server %} | X | X | X | To see if there are currently any incidents affecting services on {% data variables.product.prodname_dotcom %}, or to subscribe and receive notifications of future status updates, visit {% data variables.product.prodname_dotcom %}'s [Status Page](https://www.githubstatus.com/). diff --git a/translations/ko-KR/content/github/writing-on-github/autolinked-references-and-urls.md b/translations/ko-KR/content/github/writing-on-github/autolinked-references-and-urls.md index 1c359c17a215..d4df58477e5b 100644 --- a/translations/ko-KR/content/github/writing-on-github/autolinked-references-and-urls.md +++ b/translations/ko-KR/content/github/writing-on-github/autolinked-references-and-urls.md @@ -45,15 +45,12 @@ References to a commit's SHA hash are automatically converted into shortened lin | Commit URL | https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | | SHA | a5c3785ed8d6a35868bc169f07e40e889087fd2e | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | | User@SHA | jlord@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -| Username/Repository@SHA | User/Repository@SHA: jlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord/sheetsee.js@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | +| Username/Repository@SHA | jlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord/sheetsee.js@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} ### Custom autolinks to external resources {% data reusables.repositories.autolink-references %} -{% endif %} - ### 더 읽을거리 - "[Basic writing and formatting syntax](/articles/basic-writing-and-formatting-syntax)" diff --git a/translations/ko-KR/content/github/writing-on-github/basic-writing-and-formatting-syntax.md b/translations/ko-KR/content/github/writing-on-github/basic-writing-and-formatting-syntax.md index eb3f00e8ec3f..0b2de4a8451d 100644 --- a/translations/ko-KR/content/github/writing-on-github/basic-writing-and-formatting-syntax.md +++ b/translations/ko-KR/content/github/writing-on-github/basic-writing-and-formatting-syntax.md @@ -188,13 +188,10 @@ You can bring up a list of suggested issues and pull requests within the reposit For more information, see "[Autolinked references and URLs](/articles/autolinked-references-and-urls)." -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} ### Referencing external resources {% data reusables.repositories.autolink-references %} -{% endif %} - ### Content attachments Some {% data variables.product.prodname_github_app %}s provide information in {% data variables.product.product_name %} for URLs that link to their registered domains. {% data variables.product.product_name %} renders the information provided by the app under the URL in the body or comment of an issue or pull request. diff --git a/translations/ko-KR/content/github/writing-on-github/creating-gists.md b/translations/ko-KR/content/github/writing-on-github/creating-gists.md index f0068d5caed6..495822dd4931 100644 --- a/translations/ko-KR/content/github/writing-on-github/creating-gists.md +++ b/translations/ko-KR/content/github/writing-on-github/creating-gists.md @@ -27,13 +27,10 @@ If your site administrator has disabled private mode, you can also use anonymous {% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} - You'll receive a notification when: - You are the author of a gist. - Someone mentions you in a gist. - You subscribe to a gist, by clicking **Subscribe** at the top any gist. -{% endif %} You can pin gists to your profile so other people can see them easily. For more information, see "[Pinning items to your profile](/articles/pinning-items-to-your-profile)." diff --git a/translations/ko-KR/content/graphql/guides/managing-enterprise-accounts.md b/translations/ko-KR/content/graphql/guides/managing-enterprise-accounts.md index 36a7d1303a4b..b3a65b382da6 100644 --- a/translations/ko-KR/content/graphql/guides/managing-enterprise-accounts.md +++ b/translations/ko-KR/content/graphql/guides/managing-enterprise-accounts.md @@ -5,7 +5,7 @@ redirect_from: - /v4/guides/managing-enterprise-accounts versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- ### About managing enterprise accounts with GraphQL @@ -23,7 +23,7 @@ With the Audit Log API, you can monitor when someone: - Promotes users to admin. - Changes permissions of a GitHub App. -The Audit Log API enables you to keep copies of your audit log data. For queries made with the Audit Log API, the GraphQL response can include data for up to 90 to 120 days. For a list of the fields available with the Audit Log API, see the "[AuditEntry interface](/v4/interface/auditentry/)." +The Audit Log API enables you to keep copies of your audit log data. For queries made with the Audit Log API, the GraphQL response can include data for up to 90 to 120 days. For a list of the fields available with the Audit Log API, see the "[AuditEntry interface](/graphql/reference/interfaces#auditentry/)." With the Enterprise Accounts API, you can: - List and review all of the organizations and repositories that belong to your enterprise account. diff --git a/translations/ko-KR/content/index.md b/translations/ko-KR/content/index.md index 2719012e5207..1800e3661d03 100644 --- a/translations/ko-KR/content/index.md +++ b/translations/ko-KR/content/index.md @@ -11,8 +11,6 @@ popularLinks: - /github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line - /github/using-git/managing-remote-repositories - /github/working-with-github-pages -versions: - free-pro-team: '*' - enterprise-server: '*' +versions: '*' --- diff --git a/translations/ko-KR/content/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights.md b/translations/ko-KR/content/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights.md index ae8a68971f9d..1d4e6eb41354 100644 --- a/translations/ko-KR/content/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights.md +++ b/translations/ko-KR/content/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights.md @@ -4,7 +4,7 @@ intro: '' product: '{% data reusables.gated-features.github-insights %}' permissions: 'Anyone with access to {% data variables.product.prodname_insights %} can navigate between {% data variables.product.prodname_enterprise %} and {% data variables.product.prodname_insights %}.' versions: - enterprise-server: '>=2.19' + enterprise-server: '*' --- Before you can navigate between {% data variables.product.prodname_enterprise %} and {% data variables.product.prodname_insights %}, a site administrator must enable a link between {% data variables.product.prodname_insights %} and {% data variables.product.prodname_enterprise %}. For more information, see "[Enabling a link between {% data variables.product.prodname_insights %} and {% data variables.product.prodname_enterprise %}](/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise)." diff --git a/translations/ko-KR/content/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise.md b/translations/ko-KR/content/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise.md index a07fd01a62e0..a423199ba2fd 100644 --- a/translations/ko-KR/content/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise.md +++ b/translations/ko-KR/content/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise.md @@ -7,7 +7,7 @@ redirect_from: - /github/installing-and-configuring-github-insights/navigating-between-github-insights-and-github-enterprise - /github/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise versions: - enterprise-server: '>=2.19' + enterprise-server: '*' --- After you enable the link, each user can navigate directly from {% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_insights %}. For more information, see "[Navigating between {% data variables.product.prodname_enterprise %} and {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights)." @@ -17,7 +17,8 @@ After you enable the link, each user can navigate directly from {% data variable ``` ghe-config 'app.github.insights-available' 'true' && ghe-config-apply ``` -3. Return to {% data variables.product.prodname_ghe_server %}. +3. Return to +{% data variables.product.prodname_ghe_server %}. {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.settings-tab %} diff --git a/translations/ko-KR/content/insights/installing-and-configuring-github-insights/installing-github-insights.md b/translations/ko-KR/content/insights/installing-and-configuring-github-insights/installing-github-insights.md index 6075aaab2e52..18c7f7cfefac 100644 --- a/translations/ko-KR/content/insights/installing-and-configuring-github-insights/installing-github-insights.md +++ b/translations/ko-KR/content/insights/installing-and-configuring-github-insights/installing-github-insights.md @@ -28,7 +28,8 @@ versions: To connect {% data variables.product.prodname_insights %} to {% data variables.product.prodname_enterprise %}, you must create a {% data variables.product.prodname_github_app %} in an organization on {% data variables.product.prodname_enterprise %}. A slugged version of your app's name will be shown on {% data variables.product.prodname_enterprise %} when your integration takes an action. {% data reusables.enterprise_site_admin_settings.sign-in %} -2. Navigate to the organization you'd like to connect to {% data variables.product.prodname_insights %}. +2. Navigate to the organization you'd like to connect to +{% data variables.product.prodname_insights %}. {% data reusables.organizations.org_settings %} {% data reusables.organizations.github-apps-settings-sidebar %} 5. Click **New {% data variables.product.prodname_github_app %}**. ![New GitHub App button](/assets/images/help/apps/github_apps_new.png) diff --git a/translations/ko-KR/content/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images.md b/translations/ko-KR/content/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images.md index 44e44968fb7c..702b2af741e8 100644 --- a/translations/ko-KR/content/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images.md +++ b/translations/ko-KR/content/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images.md @@ -24,8 +24,8 @@ For more information, see "[About {% data variables.product.prodname_github_cont The domain for the {% data variables.product.prodname_container_registry %} is `ghcr.io`. -| Registry | Example URL | -| ---------------------------------------------------------------------- | --------------------------------------------------- | +| Registry | Example URL | +| ----------------------------------------------------------------- | --------------------------------------------------- | | {% data variables.product.prodname_registry %} Docker registry | `docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME` | | {% data variables.product.prodname_github_container_registry %} | `ghcr.io/OWNER/IMAGE_NAME` | @@ -33,7 +33,9 @@ The domain for the {% data variables.product.prodname_container_registry %} is ` You will need to authenticate to the {% data variables.product.prodname_container_registry %} with the base URL `ghcr.io`. We recommend creating a new access token for using the {% data variables.product.prodname_container_registry %}. -{% data reusables.package_registry.authenticate-to-container-registry %} +{% data reusables.package_registry.authenticate_with_pat_for_container_registry %} + +{% data reusables.package_registry.authenticate-to-container-registry-steps %} ### Migrating a Docker image using the Docker CLI @@ -55,7 +57,9 @@ To move Docker images that you host on {% data variables.product.prodname_regist $ docker tag docker.pkg.github.com/SOURCE_OWNER/SOURCE_REPOSITORY/SOURCE_IMAGE_NAME:VERSION ghcr.io/TARGET_OWNER/TARGET_IMAGE_NAME:VERSION ``` -4. Sign in to the new {% data variables.product.prodname_container_registry %}. We recommend creating a new PAT limited to the `read:packages` and `write:packages` scopes since you no longer need the `repo` scope and your previous PAT may not have the `write:packages` scope. +4. Sign in to the new + +{% data variables.product.prodname_container_registry %}. We recommend creating a new PAT limited to the `read:packages` and `write:packages` scopes since you no longer need the `repo` scope and your previous PAT may not have the `write:packages` scope. {% raw %} ```shell $ echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin diff --git a/translations/ko-KR/content/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image.md b/translations/ko-KR/content/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image.md index 106b972193f8..0aed01edd6a7 100644 --- a/translations/ko-KR/content/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image.md +++ b/translations/ko-KR/content/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image.md @@ -62,7 +62,9 @@ https://github.com/monalisa/hello_docker $ docker tag 38f737a91f39 ghcr.io/monalisa/hello_docker:latest ``` -5. If you haven't already, authenticate to {% data variables.product.prodname_github_container_registry %}. For more information, see "[Authenticating to GitHub Container Registry](/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images#authenticating-to-github-container-registry)." +5. If you haven't already, authenticate to + +{% data variables.product.prodname_github_container_registry %}. For more information, see "[Authenticating to GitHub Container Registry](/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images#authenticating-to-github-container-registry)." {% raw %} ```shell $ echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin diff --git a/translations/ko-KR/content/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images.md b/translations/ko-KR/content/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images.md index b88041a9a062..e4e1db91970c 100644 --- a/translations/ko-KR/content/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images.md +++ b/translations/ko-KR/content/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images.md @@ -12,13 +12,15 @@ To push and pull container images owned by an organization, an organization admi ### Authenticating to {% data variables.product.prodname_github_container_registry %} -{% data reusables.package_registry.authenticate-to-container-registry %} +{% data reusables.package_registry.authenticate_with_pat_for_container_registry %} + +{% data reusables.package_registry.authenticate-to-container-registry-steps %} ### Pushing container images This example pushes the latest version of `IMAGE-NAME`. ```shell - $ docker push ghcr.io/OWNER/IMAGE_NAME.latest + $ docker push ghcr.io/OWNER/IMAGE_NAME:latest ``` This example pushes the `2.5` version of the image. @@ -40,7 +42,7 @@ To ensure you're always using the same image, you can specify the exact containe ``` 2. Remove image locally as needed. ```shell - $ docker rmi ghcr.io/OWNER/IMAGE_NAME.latest + $ docker rmi ghcr.io/OWNER/IMAGE_NAME:latest ``` 3. Pull the container image with `@YOUR_SHA_VALUE` after the image name. diff --git a/translations/ko-KR/content/packages/publishing-and-managing-packages/about-github-packages.md b/translations/ko-KR/content/packages/publishing-and-managing-packages/about-github-packages.md index 3f12d7d49120..18b81364ff01 100644 --- a/translations/ko-KR/content/packages/publishing-and-managing-packages/about-github-packages.md +++ b/translations/ko-KR/content/packages/publishing-and-managing-packages/about-github-packages.md @@ -34,7 +34,7 @@ You can review the package's README, some metadata like licensing, download stat #### About package permissions and visibility {% if currentVersion == "free-pro-team@latest" %} -| | Package registries | {% data variables.product.prodname_github_container_registry %} | +| | Package registries | {% data variables.product.prodname_github_container_registry %} | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Hosting locations | You can host multiple packages in one repository. | You can host multiple container images in one organization or user account. | | Permissions | Each package inherits the permissions of the repository where the package is hosted.

    For example, anyone with read permissions for a repository can install a package as a dependency in a project, and anyone with write permissions can publish a new package version. | For each container image, you can choose the access level that others have. The permissions for container image access are separate from your organization and repository permissions. | @@ -45,7 +45,7 @@ You can review the package's README, some metadata like licensing, download stat | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Hosting locations | You can host multiple packages in one repository. | | Permissions | Each package inherits the permissions of the repository where the package is hosted.

    For example, anyone with read permissions for a repository can install a package as a dependency in a project, and anyone with write permissions can publish a new package version. | -| Visibility | {% data reusables.package_registry.public-or-private-packages %} | +| Visibility | {% data reusables.package_registry.public-or-private-packages %} {% endif %} @@ -60,8 +60,7 @@ For more information about permissions and visibility for {% data variables.prod {% data reusables.package_registry.packages-billing %} For more information, see "[About billing for {% data variables.product.prodname_registry %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)." - -{{ site.data.reusables/package_registry/container-registry-beta-billing-note }} +{% data reusables.package_registry.container-registry-beta-billing-note %} {% endif %} ### Supported clients and formats @@ -76,8 +75,9 @@ The {% data variables.product.prodname_github_container_registry %} hosts contai | Package client | Language | Package format | 설명 | | -------------- | -------- | -------------- | ------------------------- | | Docker CLI | N/A | `Dockerfile` | Docker container support. | +For more information about the container support offered by -For more information about the container support offered by {% data variables.product.prodname_github_container_registry %}, see "[About {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry)." +{% data variables.product.prodname_github_container_registry %}, see "[About {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry)." {% endif %} #### Support for package registries @@ -144,10 +144,10 @@ For more information about configuring your package client for use with {% data {% if currentVersion == "free-pro-team@latest" %} ### About scopes and permissions for {% data variables.product.prodname_github_container_registry %} -| 범위 | 설명 | -| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `read:packages` | Download and install container images from {% data variables.product.prodname_github_container_registry %} | -| `write:packages` | Upload and publish container images to {% data variables.product.prodname_github_container_registry %} | +| 범위 | 설명 | +| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `read:packages` | Download and install container images from {% data variables.product.prodname_github_container_registry %} +| `write:packages` | Upload and publish container images to {% data variables.product.prodname_github_container_registry %} | `delete:packages` | Delete specified versions of private or public container images from {% data variables.product.prodname_github_container_registry %}. For more information, see "[Deleting a container image](/packages/managing-container-images-with-github-container-registry/deleting-a-container-image)." | To learn about available scopes and permissions for container images, see "[About {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry)" or "[Configuring access control and visibility for container images](/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images)." @@ -166,9 +166,9 @@ To use or manage a package hosted by a package registry, you must use a token wi | 범위 | 설명 | Repository permissions | | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- | -| `read:packages` | Download and install packages from {% data variables.product.prodname_registry %} | read | -| `write:packages` | Upload and publish packages to {% data variables.product.prodname_registry %} | write | -| `delete:packages` | Delete specified versions of private packages from {% data variables.product.prodname_registry %} | admin | +| `read:packages` | Download and install packages from {% data variables.product.prodname_registry %} | read | +| `write:packages` | Upload and publish packages to {% data variables.product.prodname_registry %} | write | +| `delete:packages` | Delete specified versions of private packages from {% data variables.product.prodname_registry %} | admin | | `repo` | Install, upload, and delete certain packages in private repositories (along with `read:packages`, `write:packages`, or `delete:packages`) | read, write, or admin | When you create a {% data variables.product.prodname_actions %} workflow, you can use the `GITHUB_TOKEN` to publish and install packages in {% data variables.product.prodname_registry %} without needing to store and manage a personal access token. @@ -187,7 +187,8 @@ You can configure webhooks to subscribe to package-related events, such as when ### Contacting support {% if currentVersion == "free-pro-team@latest" %} -If you have feedback or feature requests for {% data variables.product.prodname_registry %}, use the [feedback form for {% data variables.product.prodname_registry %}](https://support.github.com/contact/feedback?contact%5Bcategory%5D=github-packages). +If you have feedback or feature requests for +{% data variables.product.prodname_registry %}, use the [feedback form for {% data variables.product.prodname_registry %}](https://support.github.com/contact/feedback?contact%5Bcategory%5D=github-packages). Contact {% data variables.contact.github_support %} about {% data variables.product.prodname_registry %} using [our contact form](https://support.github.com/contact?form%5Bsubject%5D=Re:%20GitHub%20Packages) if: @@ -196,6 +197,7 @@ Contact {% data variables.contact.github_support %} about {% data variables.prod * Your published package contains sensitive data, such as GDPR violations, API Keys, or personally identifying information {% else %} -If you need support for {% data variables.product.prodname_registry %}, please contact your site administrators. +If you need support for +{% data variables.product.prodname_registry %}, please contact your site administrators. {% endif %} diff --git a/translations/ko-KR/content/packages/publishing-and-managing-packages/deleting-a-package.md b/translations/ko-KR/content/packages/publishing-and-managing-packages/deleting-a-package.md index 3804e2a0b30f..b21fce066af5 100644 --- a/translations/ko-KR/content/packages/publishing-and-managing-packages/deleting-a-package.md +++ b/translations/ko-KR/content/packages/publishing-and-managing-packages/deleting-a-package.md @@ -11,7 +11,6 @@ versions: {% data reusables.package_registry.packages-ghes-release-stage %} - {% if currentVersion == "free-pro-team@latest" %} ### About container image deletion diff --git a/translations/ko-KR/content/packages/publishing-and-managing-packages/publishing-a-package.md b/translations/ko-KR/content/packages/publishing-and-managing-packages/publishing-a-package.md index 93fbdbffb4b7..fbc13a6a796d 100644 --- a/translations/ko-KR/content/packages/publishing-and-managing-packages/publishing-a-package.md +++ b/translations/ko-KR/content/packages/publishing-and-managing-packages/publishing-a-package.md @@ -21,7 +21,8 @@ You can help people understand and use your package by providing a description a {% data reusables.package_registry.package-immutability %} {% if currentVersion == "free-pro-team@latest" %} -If a new version of a package fixes a security vulnerability, you should publish a security advisory in your repository. {% data variables.product.prodname_dotcom %} reviews each published security advisory and may use it to send {% data variables.product.prodname_dependabot_short %} alerts to affected repositories. For more information, see "[About GitHub Security Advisories](/github/managing-security-vulnerabilities/about-github-security-advisories)." +If a new version of a package fixes a security vulnerability, you should publish a security advisory in your repository. +{% data variables.product.prodname_dotcom %} reviews each published security advisory and may use it to send {% data variables.product.prodname_dependabot_short %} alerts to affected repositories. For more information, see "[About GitHub Security Advisories](/github/managing-security-vulnerabilities/about-github-security-advisories)." {% endif %} ### Publishing a package diff --git a/translations/ko-KR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md b/translations/ko-KR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md index 3fba131c1092..7613721792d7 100644 --- a/translations/ko-KR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md +++ b/translations/ko-KR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md @@ -17,11 +17,7 @@ versions: ### About Docker and {% data variables.product.prodname_registry %} -{% warning %} - -**Note:** The {% data variables.product.prodname_registry %} Docker registry will be superseded by {% data variables.product.prodname_github_container_registry %}{% if currentVersion != "free-pro-team@latest" %} in a future {% data variables.product.product_name %} release{% endif %}.{% if currentVersion == "free-pro-team@latest" %} To learn how to migrate your existing Docker images and any workflows using them, see "[Migrating to {% data variables.product.prodname_github_container_registry %} for Docker images](/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images)" and "[Getting started with {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry)."{% endif %} - -{% endwarning %} +{% data reusables.package_registry.docker_registry_deprecation_status %} When installing or publishing a docker image, {% data variables.product.prodname_registry %} does not currently support foreign layers, such as Windows images. @@ -33,6 +29,8 @@ Before you can use the Docker registry on {% data variables.product.prodname_reg ### Authenticating to {% data variables.product.prodname_registry %} +{% data reusables.package_registry.docker_registry_deprecation_status %} + {% data reusables.package_registry.authenticate-packages %} #### Authenticating with a personal access token @@ -69,6 +67,8 @@ For more information, see "[Docker login](https://docs.docker.com/engine/referen ### Publishing a package +{% data reusables.package_registry.docker_registry_deprecation_status %} + {% data variables.product.prodname_registry %} supports multiple top-level Docker images per repository. A repository can have any number of image tags. You may experience degraded service publishing or installing Docker images larger than 10GB, layers are capped at 5GB each. For more information, see "[Docker tag](https://docs.docker.com/engine/reference/commandline/tag/)" in the Docker documentation. {% data reusables.package_registry.lowercase-name-field %} @@ -104,7 +104,8 @@ For more information, see "[Docker login](https://docs.docker.com/engine/referen $ docker build -t docker.HOSTNAME/OWNER/REPOSITORY/IMAGE_NAME:VERSION PATH ``` {% endif %} -4. Publish the image to {% data variables.product.prodname_registry %}. +4. Publish the image to +{% data variables.product.prodname_registry %}. {% if currentVersion == "free-pro-team@latest" %} ```shell $ docker push docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME:VERSION @@ -122,6 +123,8 @@ For more information, see "[Docker login](https://docs.docker.com/engine/referen #### Example publishing a Docker image +{% data reusables.package_registry.docker_registry_deprecation_status %} + You can publish version 1.0 of the `monalisa` image to the `octocat/octo-app` repository using an image ID. {% if currentVersion == "free-pro-team@latest" %} @@ -180,8 +183,9 @@ $ docker push docker.HOSTNAME/octocat/octo-app/monalisa:1.0 ### Installing a package -You can use the `docker pull` command to install a docker image from {% data variables.product.prodname_registry %}, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image,{% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance, {% endif %} and *TAG_NAME* with tag for the image you want to install. {% data reusables.package_registry.lowercase-name-field %} +{% data reusables.package_registry.docker_registry_deprecation_status %} +You can use the `docker pull` command to install a docker image from {% data variables.product.prodname_registry %}, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image,{% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance, {% endif %} and *TAG_NAME* with tag for the image you want to install. {% data reusables.package_registry.lowercase-name-field %} {% if currentVersion == "free-pro-team@latest" %} ```shell @@ -199,7 +203,6 @@ $ docker pull docker.HOSTNAME/OWNER/REPOSITORY/IMAGE_NAME:TAG_NAME {% endnote %} - ### 더 읽을거리 - "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package/)" diff --git a/translations/ko-KR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-dotnet-cli-for-use-with-github-packages.md b/translations/ko-KR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-dotnet-cli-for-use-with-github-packages.md index 59327dc4253e..91bcc0b7f512 100644 --- a/translations/ko-KR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-dotnet-cli-for-use-with-github-packages.md +++ b/translations/ko-KR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-dotnet-cli-for-use-with-github-packages.md @@ -157,7 +157,6 @@ For example, the *OctodogApp* and *OctocatApp* projects will publish to the same ``` - ### Installing a package Using packages from {% data variables.product.prodname_dotcom %} in your project is similar to using packages from *nuget.org*. Add your package dependencies to your *.csproj* file, specifying the package name and version. For more information on using a *.csproj* file in your project, see "[Working with NuGet packages](https://docs.microsoft.com/en-us/nuget/consume-packages/overview-and-workflow)" in the Microsoft documentation. diff --git a/translations/ko-KR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages.md b/translations/ko-KR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages.md index 52afd529a86d..f483f359fff6 100644 --- a/translations/ko-KR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages.md +++ b/translations/ko-KR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages.md @@ -26,7 +26,8 @@ versions: You can authenticate to {% data variables.product.prodname_registry %} with Gradle using either Gradle Groovy or Kotlin DSL by editing your *build.gradle* file (Gradle Groovy) or *build.gradle.kts* file (Kotlin DSL) file to include your personal access token. You can also configure Gradle Groovy and Kotlin DSL to recognize a single package or multiple packages in a repository. {% if currentVersion != "free-pro-team@latest" %} -Replace *REGISTRY-URL* with the URL for your instance's Maven registry. If your instance has subdomain isolation enabled, use `maven.HOSTNAME`. If your instance has subdomain isolation disabled, use `HOSTNAME/_registry/maven`. In either case, replace *HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance. +Replace *REGISTRY-URL* with the URL for your instance's Maven registry. If your instance has subdomain isolation enabled, use `maven.HOSTNAME`. If your instance has subdomain isolation disabled, use `HOSTNAME/_registry/maven`. In either case, replace *HOSTNAME* with the host name of your +{% data variables.product.prodname_ghe_server %} instance. {% endif %} Replace *USERNAME* with your {% data variables.product.prodname_dotcom %} username, *TOKEN* with your personal access token, *REPOSITORY* with the name of the repository containing the package you want to publish, and *OWNER* with the name of the user or organization account on {% data variables.product.prodname_dotcom %} that owns the repository. {% data reusables.package_registry.lowercase-name-field %} @@ -120,32 +121,32 @@ publishing { ##### Example using Kotlin DSL for multiple packages in the same repository - ```shell - plugins { - `maven-publish` apply false - } +```shell +plugins { + `maven-publish` apply false +} - subprojects { - apply(plugin = "maven-publish") - configure { - repositories { - maven { - name = "GitHubPackages" - url = uri("https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}REGISTRY-URL{% endif %}/OWNER/REPOSITORY") - credentials { - username = project.findProperty("gpr.user") as String? ?: System.getenv("USERNAME") - password = project.findProperty("gpr.key") as String? ?: System.getenv("TOKEN") - } - } - } - publications { - register("gpr") { - from(components["java"]) - } - } - } - } - ``` +subprojects { + apply(plugin = "maven-publish") + configure { + repositories { + maven { + name = "GitHubPackages" + url = uri("https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}REGISTRY-URL{% endif %}/OWNER/REPOSITORY") + credentials { + username = project.findProperty("gpr.user") as String? ?: System.getenv("USERNAME") + password = project.findProperty("gpr.key") as String? ?: System.getenv("TOKEN") + } + } + } + publications { + register("gpr") { + from(components["java"]) + } + } + } +} +``` #### Authenticating with the `GITHUB_TOKEN` @@ -173,31 +174,31 @@ You can install a package by adding the package as a dependency to your project. {% data reusables.package_registry.authenticate-step %} 2. Add the package dependencies to your *build.gradle* file (Gradle Groovy) or *build.gradle.kts* file (Kotlin DSL) file. - Example using Grady Groovy: + Example using Gradle Groovy: ```shell dependencies { - implementation 'com.example:package' + implementation 'com.example:package' } ``` Example using Kotlin DSL: ```shell dependencies { - implementation("com.example:package") + implementation("com.example:package") } ``` 3. Add the maven plugin to your *build.gradle* file (Gradle Groovy) or *build.gradle.kts* file (Kotlin DSL) file. - Example using Grady Groovy: + Example using Gradle Groovy: ```shell plugins { - id 'maven' + id 'maven' } ``` Example using Kotlin DSL: ```shell plugins { - `maven` + `maven` } ``` diff --git a/translations/ko-KR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md b/translations/ko-KR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md index 31cc0e71f3ce..342be9c5c329 100644 --- a/translations/ko-KR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md +++ b/translations/ko-KR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md @@ -88,7 +88,8 @@ You can use an *.npmrc* file to configure the scope mapping for your project. In {% data reusables.package_registry.authenticate-step %} {% data reusables.package_registry.create-npmrc-owner-step %} {% data reusables.package_registry.add-npmrc-to-repo-step %} -4. Verify the name of your package in your project's *package.json*. The `name` field must contain the scope and the name of the package. For example, if your package is called "test", and you are publishing to the "My-org" {% data variables.product.prodname_dotcom %} organization, the `name` field in your *package.json* should be `@my-org/test`. +4. Verify the name of your package in your project's *package.json*. The `name` field must contain the scope and the name of the package. For example, if your package is called "test", and you are publishing to the "My-org" +{% data variables.product.prodname_dotcom %} organization, the `name` field in your *package.json* should be `@my-org/test`. {% data reusables.package_registry.verify_repository_field %} {% data reusables.package_registry.publish_package %} @@ -188,7 +189,6 @@ registry=https://HOSTNAME/_registry/npm/OWNER ``` {% endif %} - ### 더 읽을거리 - "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package/)" diff --git a/translations/ko-KR/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md b/translations/ko-KR/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md index 0137dc78a12b..794f932b5c14 100644 --- a/translations/ko-KR/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md +++ b/translations/ko-KR/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md @@ -22,7 +22,9 @@ You can extend the CI and CD capabilities of your repository by publishing or in {% data reusables.package_registry.container-registry-beta %} -If you want your workflow to authenticate to {% data variables.product.prodname_registry %} to access the {% data variables.product.prodname_container_registry %}, then we recommend using a personal access token since the `GITHUB_TOKEN` is not currently supported. For an authentication example, see "[Authenticating with the {% data variables.product.prodname_container_registry %}](/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images#authenticating-with-the-container-registry)." +{% data reusables.package_registry.authenticate_with_pat_for_container_registry %} + +For an authentication example, see "[Authenticating with the {% data variables.product.prodname_container_registry %}](/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images#authenticating-with-the-container-registry)." {% endif %} @@ -45,7 +47,8 @@ You can install packages as part of your CI flow using {% data variables.product Installing packages hosted by {% data variables.product.prodname_registry %} through {% data variables.product.prodname_actions %} requires minimal configuration or additional authentication when you use `GITHUB_TOKEN`.{% if currentVersion == "free-pro-team@latest" %} Data transfer is also free when an action installs a package. For more information, see "[About billing for {% data variables.product.prodname_registry %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)."{% endif %} {% if currentVersion == "free-pro-team@latest" %} -`GITHUB_TOKEN` cannot install packages from any private repository besides the repository where the action runs. You cannot currently use `GITHUB_TOKEN` to authenticate to {% data variables.product.prodname_github_container_registry %}. +`GITHUB_TOKEN` cannot install packages from any private repository besides the repository where the action runs. You cannot currently use `GITHUB_TOKEN` to authenticate to +{% data variables.product.prodname_github_container_registry %}. {% endif %} {% data reusables.package_registry.actions-configuration %} diff --git a/translations/ko-KR/content/rest/guides/basics-of-authentication.md b/translations/ko-KR/content/rest/guides/basics-of-authentication.md index ff31d8a0c765..fad29ce33e13 100644 --- a/translations/ko-KR/content/rest/guides/basics-of-authentication.md +++ b/translations/ko-KR/content/rest/guides/basics-of-authentication.md @@ -11,7 +11,6 @@ versions: --- - In this section, we're going to focus on the basics of authentication. Specifically, we're going to create a Ruby server (using [Sinatra][Sinatra]) that implements the [web flow][webflow] of an application in several different ways. {% tip %} @@ -48,7 +47,8 @@ end ``` Your client ID and client secret keys come from [your application's configuration page][app settings]. You should **never, _ever_** store these values in -{% data variables.product.product_name %}--or any other public place, for that matter. We recommend storing them as [environment variables][about env vars]--which is exactly what we've done here. +{% data variables.product.product_name %}--or any other public place, for that matter. We recommend storing them as +[environment variables][about env vars]--which is exactly what we've done here. Next, in _views/index.erb_, paste this content: @@ -106,7 +106,7 @@ After a successful app authentication, {% data variables.product.product_name %} #### Checking granted scopes -In the future, users will be able to [edit the scopes you requested][edit scopes post], and your application might be granted less access than you originally asked for. So, before making any requests with the token, you should check the scopes that were granted for the token by the user. +Users can edit the scopes you requested by directly changing the URL. This can grant your application less access than you originally asked for. Before making any requests with the token, check the scopes that were granted for the token by the user. For more information about requested and granted scopes, see "[Scopes for OAuth Apps](/developers/apps/scopes-for-oauth-apps#requested-scopes-and-granted-scopes)." The scopes that were granted are returned as a part of the response from exchanging a token. @@ -173,7 +173,8 @@ We can do whatever we want with our results. In this case, we'll just dump them It'd be a pretty bad model if we required users to log into the app every single time they needed to access the web page. For example, try navigating directly to `http://localhost:4567/basic`. You'll get an error. What if we could circumvent the entire "click here" process, and just _remember_ that, as long as the user's logged into -{% data variables.product.product_name %}, they should be able to access this application? Hold on to your hat, because _that's exactly what we're going to do_. +{% data variables.product.product_name %}, they should be able to access this application? Hold on to your hat, +because _that's exactly what we're going to do_. Our little server above is rather simple. In order to wedge in some intelligent authentication, we're going to switch over to using sessions for storing tokens. This will make authentication transparent to the user. @@ -302,6 +303,5 @@ Also, if we had never authorized this application to access our {% data variable [libraries]: /libraries/ [oauth scopes]: /apps/building-oauth-apps/understanding-scopes-for-oauth-apps/ [oauth scopes]: /apps/building-oauth-apps/understanding-scopes-for-oauth-apps/ -[edit scopes post]: https://developer.github.com/changes/2013-10-04-oauth-changes-coming/ [new oauth app]: https://github.com/settings/applications/new [app settings]: https://github.com/settings/developers diff --git a/translations/ko-KR/content/rest/guides/best-practices-for-integrators.md b/translations/ko-KR/content/rest/guides/best-practices-for-integrators.md index 23643156fa7d..b99e43b3d9b9 100644 --- a/translations/ko-KR/content/rest/guides/best-practices-for-integrators.md +++ b/translations/ko-KR/content/rest/guides/best-practices-for-integrators.md @@ -12,7 +12,6 @@ versions: Interested in integrating with the GitHub platform? [You're in good company](https://github.com/integrations). This guide will help you build an app that provides the best experience for your users *and* ensure that it's reliably interacting with the API. - ### Secure payloads delivered from GitHub It's very important that you secure [the payloads sent from GitHub][event-types]. Although no personal information (like passwords) is ever transmitted in a payload, leaking *any* information is not good. Some information that might be sensitive include committer email address or the names of private repositories. diff --git a/translations/ko-KR/content/rest/guides/delivering-deployments.md b/translations/ko-KR/content/rest/guides/delivering-deployments.md index 7ba5f1872e17..9b69af2d07be 100644 --- a/translations/ko-KR/content/rest/guides/delivering-deployments.md +++ b/translations/ko-KR/content/rest/guides/delivering-deployments.md @@ -12,7 +12,7 @@ versions: -The [Deployments API][deploy API] provides your projects hosted on {% data variables.product.product_name %} with the capability to launch them on a server that you own. Combined with [the Status API][status API], you'll be able to coordinate your deployments the moment your code lands on `master`. +The [Deployments API][deploy API] provides your projects hosted on {% data variables.product.product_name %} with the capability to launch them on a server that you own. Combined with [the Status API][status API], you'll be able to coordinate your deployments the moment your code lands on the default branch. This guide will use that API to demonstrate a setup that you can use. In our scenario, we will: diff --git a/translations/ko-KR/content/rest/guides/getting-started-with-the-checks-api.md b/translations/ko-KR/content/rest/guides/getting-started-with-the-checks-api.md index 8b06ff4022f3..fb30355368c8 100644 --- a/translations/ko-KR/content/rest/guides/getting-started-with-the-checks-api.md +++ b/translations/ko-KR/content/rest/guides/getting-started-with-the-checks-api.md @@ -37,8 +37,8 @@ A check run is an individual test that is part of a check suite. Each run includ ![Check runs workflow](/assets/images/check_runs.png) {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -If a check run is in a incomplete state for more than 14 days, then the check run's `conclusion` becomes `stale` and appears on {% data variables.product.prodname_dotcom %} as stale with -{% octicon "issue-reopened" aria-label="The issue-reopened icon" %}. Only {% data variables.product.prodname_dotcom %} can mark check runs as `stale`. For more information about possible conclusions of a check run, see the [`conclusion` parameter](/rest/reference/checks#create-a-check-run--parameters). +If a check run is in a incomplete state for more than 14 days, then the check run's `conclusion` becomes `stale` and appears on +{% data variables.product.prodname_dotcom %} as stale with {% octicon "issue-reopened" aria-label="The issue-reopened icon" %}. Only {% data variables.product.prodname_dotcom %} can mark check runs as `stale`. For more information about possible conclusions of a check run, see the [`conclusion` parameter](/rest/reference/checks#create-a-check-run--parameters). {% endif %} As soon as you receive the [`check_suite`](/webhooks/event-payloads/#check_suite) webhook, you can create the check run, even if the check is not complete. You can update the `status` of the check run as it completes with the values `queued`, `in_progress`, or `completed`, and you can update the `output` as more details become available. A check run can contain timestamps, a link to more details on your external site, detailed annotations for specific lines of code, and information about the analysis performed. diff --git a/translations/ko-KR/content/rest/guides/getting-started-with-the-git-database-api.md b/translations/ko-KR/content/rest/guides/getting-started-with-the-git-database-api.md index 7aca47418681..8fef6b25ef61 100644 --- a/translations/ko-KR/content/rest/guides/getting-started-with-the-git-database-api.md +++ b/translations/ko-KR/content/rest/guides/getting-started-with-the-git-database-api.md @@ -32,7 +32,7 @@ It might seem complex, but it's actually pretty simple when you understand the m {% warning %} -**Warning!** Please do not depend on using Git directly or {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}[`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference){% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}[`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference){% endif %} for updates to `merge` Git refs, because this content becomes outdated without warning. +**Warning!** Please do not depend on using Git directly or [`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference) for updates to `merge` Git refs, because this content becomes outdated without warning. {% endwarning %} @@ -42,4 +42,4 @@ If you are currently using polling methods that produce outdated `merge` Git ref 1. Receive the pull request webhook. 2. Call [`GET /repos/{owner}/{repo}/pulls/{pull_number}`](/v3/pulls/#get-a-pull-request) to start a background job for creating the merge commit candidate. -3. Poll your repository using [`GET /repos/{owner}/{repo}/pulls/{pull_number}`](/v3/pulls/#get-a-pull-request) to see if the `mergeable` attribute is `true` or `false`. You can use Git directly or {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}[`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference){% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}[`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference){% endif %} for updates to `merge` Git refs only after performing the previous steps. +3. Poll your repository using [`GET /repos/{owner}/{repo}/pulls/{pull_number}`](/v3/pulls/#get-a-pull-request) to see if the `mergeable` attribute is `true` or `false`. You can use Git directly or [`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference) for updates to `merge` Git refs only after performing the previous steps. diff --git a/translations/ko-KR/content/rest/guides/getting-started-with-the-rest-api.md b/translations/ko-KR/content/rest/guides/getting-started-with-the-rest-api.md index 572ec90bac31..850cf6a66965 100644 --- a/translations/ko-KR/content/rest/guides/getting-started-with-the-rest-api.md +++ b/translations/ko-KR/content/rest/guides/getting-started-with-the-rest-api.md @@ -10,7 +10,6 @@ versions: --- - Let's walk through core API concepts as we tackle some everyday use cases. ### 개요 @@ -55,7 +54,6 @@ $ curl -i {% data variables.product.api_url_pre %}/users/defunkt > Server: GitHub.com > Date: Sun, 11 Nov 2012 18:43:28 GMT > Content-Type: application/json; charset=utf-8 -> Connection: keep-alive > Status: 200 OK > ETag: "bfd85cbf23ac0b0c8a29bee02e7117c6" > X-RateLimit-Limit: 60 @@ -195,7 +193,8 @@ In this example, we grab only those repositories that octocat owns, not the ones #### Create a repository Fetching information for existing repositories is a common use case, but the -{% data variables.product.product_name %} API supports creating new repositories as well. To [create a repository][create repo], we need to `POST` some JSON containing the details and configuration options. +{% data variables.product.product_name %} API supports creating new repositories as well. To [create a repository][create repo], +we need to `POST` some JSON containing the details and configuration options. ```shell $ curl -i -H "Authorization: token 5199831f4dd3b79e7c5b7e0ebe75d67aa66e79d4" \ diff --git a/translations/ko-KR/content/rest/guides/rendering-data-as-graphs.md b/translations/ko-KR/content/rest/guides/rendering-data-as-graphs.md index 2d752872856b..fb7579c8cf0a 100644 --- a/translations/ko-KR/content/rest/guides/rendering-data-as-graphs.md +++ b/translations/ko-KR/content/rest/guides/rendering-data-as-graphs.md @@ -240,7 +240,7 @@ repos.each do |repo| end ``` -From there, we'll cumulatively add each language found to a "master list": +From there, we'll cumulatively add each language found to a list of languages: ``` ruby repo_langs.each do |lang, count| diff --git a/translations/ko-KR/content/rest/overview/api-previews.md b/translations/ko-KR/content/rest/overview/api-previews.md index 763d452a539a..4ba2d6b8b558 100644 --- a/translations/ko-KR/content/rest/overview/api-previews.md +++ b/translations/ko-KR/content/rest/overview/api-previews.md @@ -10,7 +10,6 @@ versions: --- - API previews let you try out new APIs and changes to existing API methods before they become part of the official GitHub API. During the preview period, we may change some features based on developer feedback. If we do make changes, we'll announce them on the [developer blog](https://developer.github.com/changes/) without advance notice. @@ -27,7 +26,7 @@ Allows you to download repositories from your GitHub user or organization accoun ### Enhanced deployments -Exercise greater control over [deployments](/v3/repos/deployments/) with more information and finer granularity. +Exercise greater control over [deployments](/rest/reference/repos#deployments) with more information and finer granularity. **Custom media type:** `ant-man-preview` **Announced:** [2016-04-06](https://developer.github.com/changes/2016-04-06-deployment-and-deployment-status-enhancements/) @@ -43,14 +42,6 @@ Get a [list of events](/v3/issues/timeline/) for an issue or pull request. **Custom media type:** `mockingbird-preview` **Announced:** [2016-05-23](https://developer.github.com/changes/2016-05-23-timeline-preview-api/) -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -### Pages - -Get more information about your [GitHub Pages](/v3/repos/pages/) site. - -**Custom media type:** `mister-fantastic-preview` **Announced:** [2016-07-06](https://developer.github.com/changes/2016-07-06-github-pages-preview-api/) -{% endif %} - {% if currentVersion != "free-pro-team@latest" %} ### Pre-receive environments @@ -120,9 +111,9 @@ Include nested team content in [team](/v3/teams/) payloads. ### Global webhooks -Enables [global webhooks](/v3/enterprise-admin/global_webhooks/) for [organization](/webhooks/event-payloads/#organization) and [user](/webhooks/event-payloads/#user) event types. This API preview is only available for {% data variables.product.prodname_ghe_server %}. +Enables [global webhooks](/rest/reference/enterprise-admin#global-webhooks/) for [organization](/webhooks/event-payloads/#organization) and [user](/webhooks/event-payloads/#user) event types. This API preview is only available for {% data variables.product.prodname_ghe_server %}. -**Custom media type:** `superpro-preview` **Announced:** [2017-12-12](/v3/enterprise-admin/global_webhooks) +**Custom media type:** `superpro-preview` **Announced:** [2017-12-12](/rest/reference/enterprise-admin#global-webhooks) {% endif %} @@ -142,15 +133,6 @@ You can now add a reason when you [lock an issue](/v3/issues/#lock-an-issue). **Custom media type:** `sailor-v-preview` **Announced:** [2018-01-10](https://developer.github.com/changes/2018-01-10-lock-reason-api-preview) {% endif %} -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -### Team discussions - -You can now use the API to manage [team discussions](/v3/teams/discussions) and [team discussion comments](/v3/teams/discussion_comments). - -**Custom media type:** `echo-preview` **Announced:** [2018-02-07](https://developer.github.com/changes/2018-02-07-team-discussions-api) - -{% endif %} - ### Require signed commits You can now use the API to manage the setting for [requiring signed commits on protected branches](/v3/repos/branches). @@ -172,11 +154,13 @@ Retrieve information from [someone's hovercard](/v3/users/#get-contextual-inform {% endif %} +{% if currentVersion ver_lt "enterprise-server@2.23" %} ### Check runs and check suites API Allows a GitHub App to run external checks on a repository's code. See the [Check runs](/v3/checks/runs/) and [Check suites](/v3/checks/suites/) APIs for more details. **Custom media type:** `antiope-preview` **Announced:** [2018-05-07](https://developer.github.com/changes/2018-05-07-new-checks-api-public-beta/) +{% endif %} {% if currentVersion != "free-pro-team@latest" %} @@ -206,7 +190,7 @@ GitHub App Manifests allow people to create preconfigured GitHub Apps. See "[Cre ### Deployment statuses -You can now update the `environment` of a [deployment status](/v3/repos/deployments/#create-a-deployment-status) and use the `in_progress` and `queued` states. When you create deployment statuses, you can now use the `auto_inactive` parameter to mark old `production` deployments as `inactive`. +You can now update the `environment` of a [deployment status](/rest/reference/repos#create-a-deployment-status) and use the `in_progress` and `queued` states. When you create deployment statuses, you can now use the `auto_inactive` parameter to mark old `production` deployments as `inactive`. **Custom media type:** `flash-preview` **Announced:** [2018-10-16](https://developer.github.com/changes/2018-10-16-deployments-environments-states-and-auto-inactive-updates/) @@ -243,7 +227,7 @@ You can use the Draft Pull Requests API and its [pull request](/v3/pulls/) endpo ### Enable and disable Pages -You can use the new endpoints in the [Pages API](/v3/repos/pages/) to enable or disable Pages. To learn more about Pages, see "[GitHub Pages Basics](/categories/github-pages-basics)". +You can use the new endpoints in the [Pages API](/rest/reference/repos#pages) to enable or disable Pages. To learn more about Pages, see "[GitHub Pages Basics](/categories/github-pages-basics)". **Custom media types:** `switcheroo-preview` **Announced:** [2019-03-14](https://developer.github.com/changes/2019-03-14-enabling-disabling-pages/) diff --git a/translations/ko-KR/content/rest/overview/endpoints-available-for-github-apps.md b/translations/ko-KR/content/rest/overview/endpoints-available-for-github-apps.md index 99648a43234a..9ae64ab8c3d2 100644 --- a/translations/ko-KR/content/rest/overview/endpoints-available-for-github-apps.md +++ b/translations/ko-KR/content/rest/overview/endpoints-available-for-github-apps.md @@ -11,7 +11,7 @@ versions: You must use an installation access token to access endpoints using your {% data variables.product.prodname_github_app %}. For more information, see "[Authenticating with {% data variables.product.prodname_github_apps %}](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)." -{% for thing in rest.operationsEnabledForApps[currentVersion] %} +{% for thing in rest.operationsEnabledForGitHubApps[currentVersion] %} {% assign category = thing[0] %} {% assign operations = thing[1] %} {% if operations.size > 0 %} diff --git a/translations/ko-KR/content/rest/overview/other-authentication-methods.md b/translations/ko-KR/content/rest/overview/other-authentication-methods.md index 75913347d3cb..9577b58cd035 100644 --- a/translations/ko-KR/content/rest/overview/other-authentication-methods.md +++ b/translations/ko-KR/content/rest/overview/other-authentication-methods.md @@ -9,9 +9,9 @@ versions: --- - While the API provides multiple methods for authentication, we strongly recommend using [OAuth](/apps/building-integrations/setting-up-and-registering-oauth-apps/) for production applications. The other methods provided are intended to be used for scripts or testing (i.e., cases where full OAuth would be overkill). Third party applications that rely on -{% data variables.product.product_name %} for authentication should not ask for or collect {% data variables.product.product_name %} credentials. Instead, they should use the [OAuth web flow](/apps/building-oauth-apps/authorizing-oauth-apps/). +{% data variables.product.product_name %} for authentication should not ask for or collect {% data variables.product.product_name %} credentials. +Instead, they should use the [OAuth web flow](/apps/building-oauth-apps/authorizing-oauth-apps/). ### Basic Authentication diff --git a/translations/ko-KR/content/rest/overview/resources-in-the-rest-api.md b/translations/ko-KR/content/rest/overview/resources-in-the-rest-api.md index e60b0391daa7..0bc5ddb440b7 100644 --- a/translations/ko-KR/content/rest/overview/resources-in-the-rest-api.md +++ b/translations/ko-KR/content/rest/overview/resources-in-the-rest-api.md @@ -11,7 +11,6 @@ versions: This describes the resources that make up the official {% data variables.product.product_name %} REST API. If you have any problems or requests, please contact {% data variables.contact.contact_support %}. - ### Current version By default, all requests to `{% data variables.product.api_url_code %}` receive the **v3** [version](/v3/versions) of the REST API. We encourage you to [explicitly request this version via the `Accept` header](/v3/media/#request-specific-version). @@ -36,7 +35,6 @@ $ curl -i {% data variables.product.api_url_pre %}/users/octocat/orgs > Server: nginx > Date: Fri, 12 Oct 2012 23:33:14 GMT > Content-Type: application/json; charset=utf-8 -> Connection: keep-alive > Status: 200 OK > ETag: "a00049ba79152d03380c34652f2cb612" > X-GitHub-Media-Type: github.v3 diff --git a/translations/ko-KR/content/rest/reference/actions.md b/translations/ko-KR/content/rest/reference/actions.md index 2671aaa7af4d..989347dfa262 100644 --- a/translations/ko-KR/content/rest/reference/actions.md +++ b/translations/ko-KR/content/rest/reference/actions.md @@ -24,6 +24,16 @@ The Artifacts API allows you to download, delete, and retrieve information about {% if operation.subcategory == 'artifacts' %}{% include rest_operation %}{% endif %} {% endfor %} +## Permissions + +The Permissions API allows you to set permissions for what organizations and repositories are allowed to run {% data variables.product.prodname_actions %}, and what actions are allowed to run. For more information, see "[Usage limits, billing, and administration](/actions/reference/usage-limits-billing-and-administration#disabling-or-limiting-github-actions-for-your-repository-or-organization)." + +You can manage self-hosted runners for an enterprise. For more information, see the "[{% data variables.product.prodname_dotcom %} Enterprise administration](/rest/reference/enterprise-admin#actions)" REST API. + +{% for operation in currentRestOperations %} + {% if operation.subcategory == 'permissions' %}{% include rest_operation %}{% endif %} +{% endfor %} + ## Secrets The Secrets API lets you create, update, delete, and retrieve information about encrypted secrets. {% data reusables.actions.about-secrets %} For more information, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)." @@ -52,7 +62,7 @@ The Self-hosted Runners Groups API allows you manage groups of self-hosted runne {% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_app %}s must have the `administration` permission for repositories or the `organization_self_hosted_runners` permission for organizations. Authenticated users must have admin access to the repository or organization to use this API. -You can manage self-hosted runner groups for an enterprise. For more information, see the "[{% data variables.product.prodname_dotcom %} Enterprise administration](/rest/reference/enterprise-admin#actions)" REST API. +You can manage self-hosted runner groups for an enterprise. For more information, see the "[{% data variables.product.prodname_dotcom %} Enterprise administration](/rest/reference/enterprise-admin##github-actions)" REST API. {% for operation in currentRestOperations %} {% if operation.subcategory == 'self-hosted-runner-groups' %}{% include rest_operation %}{% endif %} diff --git a/translations/ko-KR/content/rest/reference/activity.md b/translations/ko-KR/content/rest/reference/activity.md index 77729d12dcbe..25cfd9002489 100644 --- a/translations/ko-KR/content/rest/reference/activity.md +++ b/translations/ko-KR/content/rest/reference/activity.md @@ -138,19 +138,19 @@ When retrieving responses from the Notifications API, each payload has a key tit Here's a list of potential `reason`s for receiving a notification: -| Reason Name | 설명 | -| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `assign` | You were assigned to the issue. | -| `저자` | You created the thread. | -| `의견` | You commented on the thread. | -| `초대` | You accepted an invitation to contribute to the repository. | -| `manual` | You subscribed to the thread (via an issue or pull request). | -| `멘션` | You were specifically **@mentioned** in the content. | +| Reason Name | 설명 | +| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `assign` | You were assigned to the issue. | +| `저자` | You created the thread. | +| `의견` | You commented on the thread. | +| `초대` | You accepted an invitation to contribute to the repository. | +| `manual` | You subscribed to the thread (via an issue or pull request). | +| `멘션` | You were specifically **@mentioned** in the content. | | `review_requested` | You, or a team you're a member of, were requested to review a pull request.{% if currentVersion == "free-pro-team@latest" %} | `security_alert` | {% data variables.product.prodname_dotcom %} discovered a [security vulnerability](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in your repository.{% endif %} -| `state_change` | You changed the thread state (for example, closing an issue or merging a pull request). | -| `subscribed` | You're watching the repository. | -| `team_mention` | You were on a team that was mentioned. | +| `state_change` | You changed the thread state (for example, closing an issue or merging a pull request). | +| `subscribed` | You're watching the repository. | +| `team_mention` | You were on a team that was mentioned. | Note that the `reason` is modified on a per-thread basis, and can change, if the `reason` on a later notification is different. diff --git a/translations/ko-KR/content/rest/reference/apps.md b/translations/ko-KR/content/rest/reference/apps.md index 7f9904b7e92b..cc22cb8172f5 100644 --- a/translations/ko-KR/content/rest/reference/apps.md +++ b/translations/ko-KR/content/rest/reference/apps.md @@ -35,9 +35,7 @@ You can use this API to manage the OAuth tokens an OAuth application uses to acc The Installations API enables you to get information about installations of your GitHub App and perform actions within those installations. An _installation_ refers to any user or organization account that has installed the app. For information on how to authenticate as an installation and limit access to specific repositories, see "[Authenticating as an installation](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)." -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} To list all GitHub App installations for an organization, see "[List app installations for an organization](/v3/orgs/#list-app-installations-for-an-organization)." -{% endif %} {% for operation in currentRestOperations %} {% if operation.subcategory == 'installations' %}{% include rest_operation %}{% endif %} diff --git a/translations/ko-KR/content/rest/reference/code-scanning.md b/translations/ko-KR/content/rest/reference/code-scanning.md new file mode 100644 index 000000000000..42f1f093fec7 --- /dev/null +++ b/translations/ko-KR/content/rest/reference/code-scanning.md @@ -0,0 +1,14 @@ +--- +title: Code scanning +redirect_from: + - /v3/code-scanning +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta %} + +The {% data variables.product.prodname_code_scanning %} API lets you retrieve and update code scanning alerts from a repository. You can use the endpoints to create automated reports for the code scanning alerts in an organization or upload analysis results generated using offline code scanning tools. For more information, see "[Finding security vulnerabilities and errors in your code](/github/finding-security-vulnerabilities-and-errors-in-your-code)." + +{% include rest_operations_at_current_path %} diff --git a/translations/ko-KR/content/rest/reference/enterprise-admin.md b/translations/ko-KR/content/rest/reference/enterprise-admin.md index dff9edc85d3e..ad8f07a1dfe4 100644 --- a/translations/ko-KR/content/rest/reference/enterprise-admin.md +++ b/translations/ko-KR/content/rest/reference/enterprise-admin.md @@ -124,11 +124,10 @@ GET /scim/v2/enterprises/{enterprise}/Users/{scim_user_id} ### Supported SCIM Group attributes -| 이름 | 유형 | 설명 | -| ------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 이름 | 유형 | 설명 | +| ------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `displayName` | `문자열` | The name of the SCIM group, which must exactly match the name of the corresponding {% data variables.product.product_name %} organization. For example, if the URL of the organization is `https://github.com/octo-org`, the group name must be `octo-org`. | -| `members` | `array` | List of SCIM user IDs that are members of the group. | - +| `members` | `array` | List of SCIM user IDs that are members of the group. | {% for operation in currentRestOperations %} {% if operation.subcategory == 'scim' %}{% include rest_operation %}{% endif %} @@ -245,13 +244,13 @@ The Pre-receive Environments API allows you to create, list, update and delete e #### Pre-receive Environment -| 이름 | 유형 | 설명 | -| --------------------- | --------- | ---------------------------------------------------------------------------------------------------------------- | -| `name` | `문자열` | The name of the environment as displayed in the UI. | -| `image_url` | `문자열` | URL to the tarball that will be downloaded and extracted. | +| 이름 | 유형 | 설명 | +| --------------------- | --------- | ----------------------------------------------------------------------------------------------------------- | +| `name` | `문자열` | The name of the environment as displayed in the UI. | +| `image_url` | `문자열` | URL to the tarball that will be downloaded and extracted. | | `default_environment` | `boolean` | Whether this is the default environment that ships with {% data variables.product.prodname_ghe_server %}. | -| `download` | `개체` | This environment's download status. | -| `hooks_count` | `integer` | The number of pre-receive hooks that use this environment. | +| `download` | `개체` | This environment's download status. | +| `hooks_count` | `integer` | The number of pre-receive hooks that use this environment. | #### Pre-receive Environment Download diff --git a/translations/ko-KR/content/rest/reference/interactions.md b/translations/ko-KR/content/rest/reference/interactions.md index ddea0baed094..15c357b2503c 100644 --- a/translations/ko-KR/content/rest/reference/interactions.md +++ b/translations/ko-KR/content/rest/reference/interactions.md @@ -28,9 +28,9 @@ The Organization Interactions API allows organization owners to temporarily rest The Repository Interactions API allows people with owner or admin access to temporarily restrict which users can comment, open issues, or create pull requests in a public repository. {% data reusables.interactions.interactions-detail %} Here's more about the groups of {% data variables.product.product_name %} users: -* {% data reusables.interactions.existing-user-limit-definition %} in the respository. -* {% data reusables.interactions.contributor-user-limit-definition %} in the respository. -* {% data reusables.interactions.collaborator-user-limit-definition %} in the respository. +* {% data reusables.interactions.existing-user-limit-definition %} in the repository. +* {% data reusables.interactions.contributor-user-limit-definition %} in the repository. +* {% data reusables.interactions.collaborator-user-limit-definition %} in the repository. {% for operation in currentRestOperations %} {% if operation.subcategory == 'repos' %}{% include rest_operation %}{% endif %} diff --git a/translations/ko-KR/content/rest/reference/licenses.md b/translations/ko-KR/content/rest/reference/licenses.md index e468053b1dd6..fb755e75f8eb 100644 --- a/translations/ko-KR/content/rest/reference/licenses.md +++ b/translations/ko-KR/content/rest/reference/licenses.md @@ -18,8 +18,8 @@ If a license is matched, the license key and name returned conforms to the [SPDX - [Get a repository](/v3/repos/#get-a-repository) - [List repositories for a user](/v3/repos/#list-repositories-for-a-user) - [List organization repositories](/v3/repos/#list-organization-repositories) -- [List forks](/v3/repos/forks/#list-forks) -- [List repositories watched by a user](/v3/activity/watching/#list-repositories-watched-by-a-user) +- [List forks](/rest/reference/repos#list-forks) +- [List repositories watched by a user](/rest/reference/activity#list-repositories-watched-by-a-user) - [List team repositories](/v3/teams/#list-team-repositories) {% warning %} diff --git a/translations/ko-KR/content/rest/reference/permissions-required-for-github-apps.md b/translations/ko-KR/content/rest/reference/permissions-required-for-github-apps.md index 34215cf20794..0342b02d29b7 100644 --- a/translations/ko-KR/content/rest/reference/permissions-required-for-github-apps.md +++ b/translations/ko-KR/content/rest/reference/permissions-required-for-github-apps.md @@ -2,7 +2,7 @@ title: Permissions required for GitHub Apps intro: 'You can find the required permissions for each {% data variables.product.prodname_github_app %}-compatible endpoint.' redirect_from: - - /v3/apps/permissions --- + - /v3/apps/permissions versions: free-pro-team: '*' enterprise-server: '*' @@ -18,12 +18,11 @@ GitHub Apps have the `Read-only` metadata permission by default. The metadata pe {% data reusables.apps.metadata-permissions %} - - [`GET /`](/v3/#root-endpoint) - [`GET /codes_of_conduct`](/v3/codes_of_conduct/#get-all-codes-of-conduct) - [`GET /codes_of_conduct/:key`](/v3/codes_of_conduct/#get-a-code-of-conduct) - [`GET /emojis`](/v3/emojis/#emojis) -- [`GET /feeds`](/v3/activity/feeds/#get-feeds) +- [`GET /feeds`](/rest/reference/activity#get-feeds) - [`GET /licenses`](/v3/licenses/#get-all-commonly-used-licenses) - [`GET /licenses/:key`](/v3/licenses/#get-a-license) - [`POST /markdown`](/v3/markdown/#render-a-markdown-document) @@ -39,22 +38,22 @@ GitHub Apps have the `Read-only` metadata permission by default. The metadata pe - [`GET /repos/:owner/:repo/community/profile`](/v3/repos/community/#get-community-profile-metrics) {% endif %} - [`GET /repos/:owner/:repo/contributors`](/v3/repos/#list-repository-contributors) -- [`GET /repos/:owner/:repo/forks`](/v3/repos/forks/#list-forks) +- [`GET /repos/:owner/:repo/forks`](/rest/reference/repos#list-forks) - [`GET /repos/:owner/:repo/languages`](/v3/repos/#list-repository-languages) - [`GET /repos/:owner/:repo/license`](/v3/licenses/#get-the-license-for-a-repository) -- [`GET /repos/:owner/:repo/stargazers`](/v3/activity/starring/#list-stargazers) +- [`GET /repos/:owner/:repo/stargazers`](/rest/reference/activity#list-stargazers) - [`GET /repos/:owner/:repo/stats/code_frequency`](/v3/repos/statistics/#get-the-weekly-commit-activity) - [`GET /repos/:owner/:repo/stats/commit_activity`](/v3/repos/statistics/#get-the-last-year-of-commit-activity) - [`GET /repos/:owner/:repo/stats/contributors`](/v3/repos/statistics/#get-all-contributor-commit-activity) - [`GET /repos/:owner/:repo/stats/participation`](/v3/repos/statistics/#get-the-weekly-commit-count) - [`GET /repos/:owner/:repo/stats/punch_card`](/v3/repos/statistics/#get-the-hourly-commit-count-for-each-day) -- [`GET /repos/:owner/:repo/subscribers`](/v3/activity/watching/#list-watchers) +- [`GET /repos/:owner/:repo/subscribers`](/rest/reference/activity#list-watchers) - [`GET /repos/:owner/:repo/tags`](/v3/repos/#list-repository-tags) - [`GET /repos/:owner/:repo/topics`](/v3/repos#get-all-repository-topics) - [`GET /repositories`](/v3/repos/#list-public-repositories) - [`GET /user/repos`](/v3/repos/#list-repositories-for-the-authenticated-user) -- [`GET /user/starred`](/v3/activity/starring/#list-repositories-starred-by-a-user) -- [`GET /user/subscriptions`](/v3/activity/watching/#list-repositories-watched-by-a-user) +- [`GET /user/starred`](/rest/reference/activity#list-repositories-starred-by-a-user) +- [`GET /user/subscriptions`](/rest/reference/activity#list-repositories-watched-by-a-user) - [`GET /users`](/v3/users/#list-users) - [`GET /users/:username`](/v3/users/#get-a-user) - [`GET /users/:username/followers`](/v3/users/followers/#list-followers-of-a-user) @@ -62,10 +61,10 @@ GitHub Apps have the `Read-only` metadata permission by default. The metadata pe - [`GET /users/:username/following/:target_user`](/v3/users/followers/#check-if-a-user-follows-another-user) - [`GET /users/:username/gpg_keys`](/v3/users/gpg_keys/#list-gpg-keys-for-a-user) - [`GET /users/:username/orgs`](/v3/orgs/#list-organizations-for-a-user) -- [`GET /users/:username/received_events`](/v3/activity/events/#list-events-received-by-the-authenticated-user) -- [`GET /users/:username/received_events/public`](/v3/activity/events/#list-public-events-received-by-a-user) +- [`GET /users/:username/received_events`](/rest/reference/activity#list-events-received-by-the-authenticated-user) +- [`GET /users/:username/received_events/public`](/rest/reference/activity#list-public-events-received-by-a-user) - [`GET /users/:username/repos`](/v3/repos/#list-repositories-for-a-user) -- [`GET /users/:username/subscriptions`](/v3/activity/watching/#list-repositories-watched-by-a-user) +- [`GET /users/:username/subscriptions`](/rest/reference/activity#list-repositories-watched-by-a-user) _Collaborators_ - [`GET /repos/:owner/:repo/collaborators`](/v3/repos/collaborators/#list-repository-collaborators) @@ -78,12 +77,12 @@ _Commit comments_ - [`GET /repos/:owner/:repo/commits/:sha/comments`](/v3/repos/comments/#list-commit-comments) _이벤트_ -- [`GET /events`](/v3/activity/events/#list-public-events) -- [`GET /networks/:owner/:repo/events`](/v3/activity/events/#list-public-events-for-a-network-of-repositories) -- [`GET /orgs/:org/events`](/v3/activity/events/#list-public-organization-events) -- [`GET /repos/:owner/:repo/events`](/v3/activity/events/#list-repository-events) -- [`GET /users/:username/events`](/v3/activity/events/#list-events-for-the-authenticated-user) -- [`GET /users/:username/events/public`](/v3/activity/events/#list-public-events-for-a-user) +- [`GET /events`](/rest/reference/activity#list-public-events) +- [`GET /networks/:owner/:repo/events`](/rest/reference/activity#list-public-events-for-a-network-of-repositories) +- [`GET /orgs/:org/events`](/rest/reference/activity#list-public-organization-events) +- [`GET /repos/:owner/:repo/events`](/rest/reference/activity#list-repository-events) +- [`GET /users/:username/events`](/rest/reference/activity#list-events-for-the-authenticated-user) +- [`GET /users/:username/events/public`](/rest/reference/activity#list-public-events-for-a-user) _Git_ - [`GET /gitignore/templates`](/v3/gitignore/#get-all-gitignore-templates) @@ -169,7 +168,6 @@ _검색_ {% if currentVersion == "free-pro-team@latest" %} - [`DELETE /repos/:owner/:repo/vulnerability-alerts`](/v3/repos/#disable-vulnerability-alerts) (:write) {% endif %} -- [`POST /user/repos`](/v3/repos/#create-a-repository-for-the-authenticated-user) (:write) - [`PATCH /user/repository_invitations/:invitation_id`](/v3/repos/invitations/#accept-a-repository-invitation) (:write) - [`DELETE /user/repository_invitations/:invitation_id`](/v3/repos/invitations/#decline-a-repository-invitation) (:write) @@ -344,12 +342,10 @@ _Traffic_ _Branches_ - [`GET /repos/:owner/:repo/branches`](/v3/repos/branches/#list-branches) (:read) - [`GET /repos/:owner/:repo/branches/:branch`](/v3/repos/branches/#get-a-branch) (:read) -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - [`GET /repos/:owner/:repo/branches/:branch/protection/restrictions/apps`](/v3/repos/branches/#list-apps-with-access-to-the-protected-branch) (:write) - [`POST /repos/:owner/:repo/branches/:branch/protection/restrictions/apps`](/v3/repos/branches/#add-app-access-restrictions) (:write) - [`PUT /repos/:owner/:repo/branches/:branch/protection/restrictions/apps`](/v3/repos/branches/#set-app-access-restrictions) (:write) - [`DELETE /repos/:owner/:repo/branches/:branch/protection/restrictions/apps`](/v3/repos/branches/#remove-user-access-restrictions) (:write) -{% endif %} _Commit comments_ - [`PATCH /repos/:owner/:repo/comments/:comment_id`](/v3/repos/comments/#update-a-commit-comment) (:write) @@ -363,13 +359,8 @@ _Git_ - [`POST /repos/:owner/:repo/git/commits`](/v3/git/commits/#create-a-commit) (:write) - [`GET /repos/:owner/:repo/git/commits/:commit_id`](/v3/git/commits/#get-a-commit) (:read) - [`POST /repos/:owner/:repo/git/refs`](/v3/git/refs/#create-a-reference) (:write) -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -- [`GET /repos/:owner/:repo/git/refs/:ref`](/v3/git/refs/#get-a-reference) (:read) -- [`GET /repos/:owner/:repo/git/refs`](/v3/git/refs/#list-references) (:read) -{% else %} - [`GET /repos/:owner/:repo/git/ref/:ref`](/v3/git/refs/#get-a-reference) (:read) - [`GET /repos/:owner/:repo/git/matching-refs/:ref`](/v3/git/refs/#list-matching-references) (:read) -{% endif %} - [`PATCH /repos/:owner/:repo/git/refs/:ref`](/v3/git/refs/#update-a-reference) (:write) - [`DELETE /repos/:owner/:repo/git/refs/:ref`](/v3/git/refs/#delete-a-reference) (:write) - [`POST /repos/:owner/:repo/git/tags`](/v3/git/tags/#create-a-tag-object) (:write) @@ -401,27 +392,27 @@ _Reactions_ - [`DELETE /orgs/:org/teams/:team_slug/discussions/:discussion_number/comments/:comment_number/reactions/:reaction_id`](/v3/reactions/#delete-team-discussion-comment-reaction) (:write){% endif %} _출시_ -- [`GET /repos/:owner/:repo/releases`](/v3/repos/releases/#list-releases) (:read) -- [`POST /repos/:owner/:repo/releases`](/v3/repos/releases/#create-a-release) (:write) -- [`GET /repos/:owner/:repo/releases/:release_id`](/v3/repos/releases/#get-a-release) (:read) -- [`PATCH /repos/:owner/:repo/releases/:release_id`](/v3/repos/releases/#update-a-release) (:write) -- [`DELETE /repos/:owner/:repo/releases/:release_id`](/v3/repos/releases/#delete-a-release) (:write) -- [`GET /repos/:owner/:repo/releases/:release_id/assets`](/v3/repos/releases/#list-release-assets) (:read) -- [`GET /repos/:owner/:repo/releases/assets/:asset_id`](/v3/repos/releases/#get-a-release-asset) (:read) -- [`PATCH /repos/:owner/:repo/releases/assets/:asset_id`](/v3/repos/releases/#update-a-release-asset) (:write) -- [`DELETE /repos/:owner/:repo/releases/assets/:asset_id`](/v3/repos/releases/#delete-a-release-asset) (:write) -- [`GET /repos/:owner/:repo/releases/latest`](/v3/repos/releases/#get-the-latest-release) (:read) -- [`GET /repos/:owner/:repo/releases/tags/:tag`](/v3/repos/releases/#get-a-release-by-tag-name) (:read) +- [`GET /repos/:owner/:repo/releases`](/rest/reference/repos/#list-releases) (:read) +- [`POST /repos/:owner/:repo/releases`](/rest/reference/repos/#create-a-release) (:write) +- [`GET /repos/:owner/:repo/releases/:release_id`](/rest/reference/repos/#get-a-release) (:read) +- [`PATCH /repos/:owner/:repo/releases/:release_id`](/rest/reference/repos/#update-a-release) (:write) +- [`DELETE /repos/:owner/:repo/releases/:release_id`](/rest/reference/repos/#delete-a-release) (:write) +- [`GET /repos/:owner/:repo/releases/:release_id/assets`](/rest/reference/repos/#list-release-assets) (:read) +- [`GET /repos/:owner/:repo/releases/assets/:asset_id`](/rest/reference/repos/#get-a-release-asset) (:read) +- [`PATCH /repos/:owner/:repo/releases/assets/:asset_id`](/rest/reference/repos/#update-a-release-asset) (:write) +- [`DELETE /repos/:owner/:repo/releases/assets/:asset_id`](/rest/reference/repos/#delete-a-release-asset) (:write) +- [`GET /repos/:owner/:repo/releases/latest`](/rest/reference/repos/#get-the-latest-release) (:read) +- [`GET /repos/:owner/:repo/releases/tags/:tag`](/rest/reference/repos/#get-a-release-by-tag-name) (:read) ### Permission on "deployments" -- [`GET /repos/:owner/:repo/deployments`](/v3/repos/deployments/#list-deployments) (:read) -- [`POST /repos/:owner/:repo/deployments`](/v3/repos/deployments/#create-a-deployment) (:write) -- [`GET /repos/:owner/:repo/deployments/:deployment_id`](/v3/repos/deployments/#get-a-deployment) (:read){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -- [`DELETE /repos/:owner/:repo/deployments/:deployment_id`](/v3/repos/deployments/#delete-a-deployment) (:write){% endif %} -- [`GET /repos/:owner/:repo/deployments/:deployment_id/statuses`](/v3/repos/deployments/#list-deployment-statuses) (:read) -- [`POST /repos/:owner/:repo/deployments/:deployment_id/statuses`](/v3/repos/deployments/#create-a-deployment-status) (:write) -- [`GET /repos/:owner/:repo/deployments/:deployment_id/statuses/:status_id`](/v3/repos/deployments/#get-a-deployment-status) (:read) +- [`GET /repos/:owner/:repo/deployments`](/rest/reference/repos#list-deployments) (:read) +- [`POST /repos/:owner/:repo/deployments`](/rest/reference/repos#create-a-deployment) (:write) +- [`GET /repos/:owner/:repo/deployments/:deployment_id`](/rest/reference/repos#get-a-deployment) (:read){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +- [`DELETE /repos/:owner/:repo/deployments/:deployment_id`](/rest/reference/repos#delete-a-deployment) (:write){% endif %} +- [`GET /repos/:owner/:repo/deployments/:deployment_id/statuses`](/rest/reference/repos#list-deployment-statuses) (:read) +- [`POST /repos/:owner/:repo/deployments/:deployment_id/statuses`](/rest/reference/repos#create-a-deployment-status) (:write) +- [`GET /repos/:owner/:repo/deployments/:deployment_id/statuses/:status_id`](/rest/reference/repos#get-a-deployment-status) (:read) ### Permission on "emails" @@ -618,12 +609,12 @@ _Teams_ ### Permission on "organization hooks" -- [`GET /orgs/:org/hooks`](/v3/orgs/hooks/#list-organization-webhooks) (:read) -- [`POST /orgs/:org/hooks`](/v3/orgs/hooks/#create-an-organization-webhook) (:write) -- [`GET /orgs/:org/hooks/:hook_id`](/v3/orgs/hooks/#get-an-organization-webhook) (:read) -- [`PATCH /orgs/:org/hooks/:hook_id`](/v3/orgs/hooks/#update-an-organization-webhook) (:write) -- [`DELETE /orgs/:org/hooks/:hook_id`](/v3/orgs/hooks/#delete-an-organization-webhook) (:write) -- [`POST /orgs/:org/hooks/:hook_id/pings`](/v3/orgs/hooks/#ping-an-organization-webhook) (:write) +- [`GET /orgs/:org/hooks`](/rest/reference/orgs#webhooks/#list-organization-webhooks) (:read) +- [`POST /orgs/:org/hooks`](/rest/reference/orgs#webhooks/#create-an-organization-webhook) (:write) +- [`GET /orgs/:org/hooks/:hook_id`](/rest/reference/orgs#webhooks/#get-an-organization-webhook) (:read) +- [`PATCH /orgs/:org/hooks/:hook_id`](/rest/reference/orgs#webhooks/#update-an-organization-webhook) (:write) +- [`DELETE /orgs/:org/hooks/:hook_id`](/rest/reference/orgs#webhooks/#delete-an-organization-webhook) (:write) +- [`POST /orgs/:org/hooks/:hook_id/pings`](/rest/reference/orgs#webhooks/#ping-an-organization-webhook) (:write) _Teams_ - [`DELETE /teams/:team_id/projects/:project_id`](/v3/teams/#remove-a-project-from-a-team) (:read) @@ -668,14 +659,14 @@ _Teams_ ### Permission on "pages" -- [`GET /repos/:owner/:repo/pages`](/v3/repos/pages/#get-a-github-pages-site) (:read) -- [`POST /repos/:owner/:repo/pages`](/v3/repos/pages/#create-a-github-pages-site) (:write) -- [`PUT /repos/:owner/:repo/pages`](/v3/repos/pages/#update-information-about-a-github-pages-site) (:write) -- [`DELETE /repos/:owner/:repo/pages`](/v3/repos/pages/#delete-a-github-pages-site) (:write) -- [`GET /repos/:owner/:repo/pages/builds`](/v3/repos/pages/#list-github-pages-builds) (:read) -- [`POST /repos/:owner/:repo/pages/builds`](/v3/repos/pages/#request-a-github-pages-build) (:write) -- [`GET /repos/:owner/:repo/pages/builds/:build_id`](/v3/repos/pages/#get-github-pages-build) (:read) -- [`GET /repos/:owner/:repo/pages/builds/latest`](/v3/repos/pages/#get-latest-pages-build) (:read) +- [`GET /repos/:owner/:repo/pages`](/rest/reference/repos#get-a-github-pages-site) (:read) +- [`POST /repos/:owner/:repo/pages`](/rest/reference/repos#create-a-github-pages-site) (:write) +- [`PUT /repos/:owner/:repo/pages`](/rest/reference/repos#update-information-about-a-github-pages-site) (:write) +- [`DELETE /repos/:owner/:repo/pages`](/rest/reference/repos#delete-a-github-pages-site) (:write) +- [`GET /repos/:owner/:repo/pages/builds`](/rest/reference/repos#list-github-pages-builds) (:read) +- [`POST /repos/:owner/:repo/pages/builds`](/rest/reference/repos#request-a-github-pages-build) (:write) +- [`GET /repos/:owner/:repo/pages/builds/:build_id`](/rest/reference/repos#get-github-pages-build) (:read) +- [`GET /repos/:owner/:repo/pages/builds/latest`](/rest/reference/repos#get-latest-pages-build) (:read) ### Permission on "pull requests" @@ -853,9 +844,9 @@ _Teams_ ### Permission on "starring" -- [`GET /user/starred/:owner/:repo`](/v3/activity/starring/#check-if-a-repository-is-starred-by-the-authenticated-user) (:read) -- [`PUT /user/starred/:owner/:repo`](/v3/activity/starring/#star-a-repository-for-the-authenticated-user) (:write) -- [`DELETE /user/starred/:owner/:repo`](/v3/activity/starring/#unstar-a-repository-for-the-authenticated-user) (:write) +- [`GET /user/starred/:owner/:repo`](/rest/reference/activity#check-if-a-repository-is-starred-by-the-authenticated-user) (:read) +- [`PUT /user/starred/:owner/:repo`](/rest/reference/activity#star-a-repository-for-the-authenticated-user) (:write) +- [`DELETE /user/starred/:owner/:repo`](/rest/reference/activity#unstar-a-repository-for-the-authenticated-user) (:write) ### Permission on "statuses" diff --git a/translations/ko-KR/content/rest/reference/repos.md b/translations/ko-KR/content/rest/reference/repos.md index 21fa4ca5174a..cf176b490966 100644 --- a/translations/ko-KR/content/rest/reference/repos.md +++ b/translations/ko-KR/content/rest/reference/repos.md @@ -186,10 +186,10 @@ In {% data variables.product.prodname_pages %} API endpoints with a `status` key * `built`: The site has been built. * `errored`: Indicates an error occurred during the build. -In {% data variables.product.prodname_pages %} API endpoints that {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}support the `mister-fantastic-preview` and{% endif %} return GitHub Pages site information, the JSON responses include these fields: +In {% data variables.product.prodname_pages %} API endpoints that return GitHub Pages site information, the JSON responses include these fields: * `html_url`: The absolute URL (including scheme) of the rendered Pages site. For example, `https://username.github.io`. * `source`: An object that contains the source branch and directory for the rendered Pages site. 여기에는 다음이 포함됩니다. - - `branch`: The repository branch used to publish your [site's source files](/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site). For example, _master_ or _gh-pages_. + - `branch`: The repository branch used to publish your [site's source files](/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site). For example, _main_ or _gh-pages_. - `path`: The repository directory from which the site publishes. Will be either `/` or `/docs`. {% for operation in currentRestOperations %} @@ -216,7 +216,7 @@ The Repository Statistics API allows you to fetch the data that {% data variable Computing repository statistics is an expensive operation, so we try to return cached data whenever possible. If the data hasn't been cached when you query a repository's statistics, you'll receive a `202` response; a background job is also fired to start compiling these statistics. Give the job a few moments to complete, and then submit the request again. If the job has completed, that request will receive a `200` response with the statistics in the response body. -Repository statistics are cached by the SHA of the repository's default branch, which is usually master; pushing to the default branch resets the statistics cache. +Repository statistics are cached by the SHA of the repository's default branch; pushing to the default branch resets the statistics cache. ### Statistics exclude some types of commits diff --git a/translations/ko-KR/data/glossaries/external.yml b/translations/ko-KR/data/glossaries/external.yml index 5127a31f8885..533d7c41ad8e 100644 --- a/translations/ko-KR/data/glossaries/external.yml +++ b/translations/ko-KR/data/glossaries/external.yml @@ -180,7 +180,7 @@ - term: 기본 분기 description: >- - 다른 분기를 지정하지 않는 한 모든 끌어오기 요청 및 코드 커밋이 자동으로 수행되는 리포지토리의 기본 분기입니다. 이 분기를 일반적으로 `마스터`라고 합니다. + The base branch for new pull requests and code commits in a repository. Each repository has at least one branch, which Git creates when you initialize the repository. The first branch is usually called `main`, and is often the default branch. - term: 의존도 그래프 description: >- diff --git a/translations/ko-KR/data/graphql/graphql_previews.yml b/translations/ko-KR/data/graphql/graphql_previews.yml index b24e9283041e..4d59328a4aa2 100644 --- a/translations/ko-KR/data/graphql/graphql_previews.yml +++ b/translations/ko-KR/data/graphql/graphql_previews.yml @@ -27,57 +27,6 @@ - CreateDeploymentPayload owning_teams: - '@github/ecosystem-api' -- - title: Checks - description: This preview adds support for reading checks created by GitHub Apps. - toggled_by: ':antiope-preview' - announcement: null - updates: null - toggled_on: - - CheckAnnotationRange - - CheckAnnotationPosition - - CheckAnnotationSpan - - CheckAnnotation - - CheckAnnotationConnection.nodes - - CheckAnnotationData - - CheckAnnotationEdge.node - - CheckAnnotationLevel - - CheckConclusionState - - CheckStatusState - - CheckSuiteAutoTriggerPreference - - CheckRun - - CheckRunConnection.nodes - - CheckRunEdge.node - - CheckRunAction - - CheckRunFilter - - CheckRunOutput - - CheckRunOutputImage - - CheckRunType - - CheckSuite - - CheckSuiteConnection.nodes - - CheckSuiteEdge.node - - CheckSuiteFilter - - CreateCheckRunInput - - CreateCheckRunPayload - - CreateCheckSuiteInput - - CreateCheckSuitePayload - - Commit.checkSuites - - Mutation.createCheckRun - - Mutation.createCheckSuite - - Mutation.rerequestCheckSuite - - Mutation.updateCheckRun - - Mutation.updateCheckSuitePreferences - - Push - - RequestableCheckStatusState - - RerequestCheckSuiteInput - - RerequestCheckSuitePayload - - UpdateCheckRunInput - - UpdateCheckRunPayload - - UpdateCheckSuitePayload.checkSuite - - UpdateCheckSuitePreferencesInput - - UpdateCheckSuitePreferencesPayload - owning_teams: - - '@github/ce-extensibility' - title: >- MergeInfoPreview - More detailed information about a pull request's merge state. diff --git a/translations/ko-KR/data/products.yml b/translations/ko-KR/data/products.yml index be4aa73decce..413a59b62cb5 100644 --- a/translations/ko-KR/data/products.yml +++ b/translations/ko-KR/data/products.yml @@ -4,7 +4,7 @@ #note this file should not be translated productsInOrder: - github - - enterpriseServer + - admin - actions - 패키지 - developers @@ -12,12 +12,3 @@ productsInOrder: - graphql - insights - desktop -#TODO this can be removed when the new versioning handling is in place -hasEnterpriseUserVersions: - - github - - actions - - developers - - rest - - graphql - - insights - - 패키지 diff --git a/translations/ko-KR/data/reusables/actions/about-artifact-log-retention.md b/translations/ko-KR/data/reusables/actions/about-artifact-log-retention.md new file mode 100644 index 000000000000..aa8a5300359d --- /dev/null +++ b/translations/ko-KR/data/reusables/actions/about-artifact-log-retention.md @@ -0,0 +1,6 @@ +By default, the artifacts and log files generated by workflows are retained for 90 days before they are automatically deleted. You can adjust the retention period, depending on the type of repository: + +- For public repositories: you can change this retention period to anywhere between 1 day or 90 days. +- For private, internal, and {% data variables.product.prodname_enterprise %} repositories: you can change this retention period to anywhere between 1 day or 400 days. + +When you customize the retention period, it only applies to new artifacts and log files, and does not retroactively apply to existing objects. For managed repositories and organizations, the maximum retention period cannot exceed the limit set by the managing organization or enterprise. diff --git a/translations/ko-KR/data/reusables/actions/about-artifacts.md b/translations/ko-KR/data/reusables/actions/about-artifacts.md index 99b604753e4b..232a96ad0971 100644 --- a/translations/ko-KR/data/reusables/actions/about-artifacts.md +++ b/translations/ko-KR/data/reusables/actions/about-artifacts.md @@ -1 +1 @@ -Artifacts enable you to share data between jobs in a workflow and store data once that workflow has completed. \ No newline at end of file +Artifacts enable you to share data between jobs in a workflow and store data once that workflow has completed. diff --git a/translations/ko-KR/data/reusables/actions/about-secrets.md b/translations/ko-KR/data/reusables/actions/about-secrets.md index 94b36e1c5846..9035067f833a 100644 --- a/translations/ko-KR/data/reusables/actions/about-secrets.md +++ b/translations/ko-KR/data/reusables/actions/about-secrets.md @@ -1 +1 @@ -Encrypted secrets allow you to store sensitive information, such as access tokens, in your repository or organization. \ No newline at end of file +Encrypted secrets allow you to store sensitive information, such as access tokens, in your repository or organization. diff --git a/translations/ko-KR/data/reusables/actions/about-self-hosted-runners.md b/translations/ko-KR/data/reusables/actions/about-self-hosted-runners.md index 0e2edd274acf..5ac03cc46b28 100644 --- a/translations/ko-KR/data/reusables/actions/about-self-hosted-runners.md +++ b/translations/ko-KR/data/reusables/actions/about-self-hosted-runners.md @@ -1 +1 @@ -Self-hosted runners allow you to host your own runners and customize the environment used to run jobs in your {% data variables.product.prodname_actions %} workflows. \ No newline at end of file +Self-hosted runners allow you to host your own runners and customize the environment used to run jobs in your {% data variables.product.prodname_actions %} workflows. diff --git a/translations/ko-KR/data/reusables/actions/about-workflow-jobs.md b/translations/ko-KR/data/reusables/actions/about-workflow-jobs.md index ba8ef85e4da8..33439420967f 100644 --- a/translations/ko-KR/data/reusables/actions/about-workflow-jobs.md +++ b/translations/ko-KR/data/reusables/actions/about-workflow-jobs.md @@ -1 +1 @@ -A workflow job is a set of steps that execute on the same runner. \ No newline at end of file +A workflow job is a set of steps that execute on the same runner. diff --git a/translations/ko-KR/data/reusables/actions/about-workflow-runs.md b/translations/ko-KR/data/reusables/actions/about-workflow-runs.md index fc10b8a30547..103cdc577724 100644 --- a/translations/ko-KR/data/reusables/actions/about-workflow-runs.md +++ b/translations/ko-KR/data/reusables/actions/about-workflow-runs.md @@ -1 +1 @@ -A workflow run is an instance of your workflow that runs when the pre-configured event occurs. \ No newline at end of file +A workflow run is an instance of your workflow that runs when the pre-configured event occurs. diff --git a/translations/ko-KR/data/reusables/actions/about-workflows.md b/translations/ko-KR/data/reusables/actions/about-workflows.md index 6ff1dd709ae1..3c044274d0f5 100644 --- a/translations/ko-KR/data/reusables/actions/about-workflows.md +++ b/translations/ko-KR/data/reusables/actions/about-workflows.md @@ -1 +1 @@ -Workflows automate your software development life cycle with a wide range of tools and services. \ No newline at end of file +Workflows automate your software development life cycle with a wide range of tools and services. diff --git a/translations/ko-KR/data/reusables/actions/actions-app-actions-permissions-api.md b/translations/ko-KR/data/reusables/actions/actions-app-actions-permissions-api.md index 251474c83b40..90dc3d003980 100644 --- a/translations/ko-KR/data/reusables/actions/actions-app-actions-permissions-api.md +++ b/translations/ko-KR/data/reusables/actions/actions-app-actions-permissions-api.md @@ -1 +1 @@ -{% data variables.product.prodname_github_app %}s must have the `actions` permission to use this API. \ No newline at end of file +{% data variables.product.prodname_github_app %}s must have the `actions` permission to use this API. diff --git a/translations/ko-KR/data/reusables/actions/actions-authentication.md b/translations/ko-KR/data/reusables/actions/actions-authentication.md index 266246660c6e..a047e0b5c463 100644 --- a/translations/ko-KR/data/reusables/actions/actions-authentication.md +++ b/translations/ko-KR/data/reusables/actions/actions-authentication.md @@ -1 +1 @@ -This API is available for authenticated users, {% data variables.product.prodname_oauth_app %}s, and {% data variables.product.prodname_github_app %}s. Access tokens require [`repo` scope](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes) for private repos and [`public_repo` scope](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes) for public repos. \ No newline at end of file +This API is available for authenticated users, {% data variables.product.prodname_oauth_app %}s, and {% data variables.product.prodname_github_app %}s. Access tokens require [`repo` scope](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes) for private repos and [`public_repo` scope](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes) for public repos. diff --git a/translations/ko-KR/data/reusables/actions/actions-not-verified.md b/translations/ko-KR/data/reusables/actions/actions-not-verified.md index b2a9577daa60..cb26fa9d61f6 100644 --- a/translations/ko-KR/data/reusables/actions/actions-not-verified.md +++ b/translations/ko-KR/data/reusables/actions/actions-not-verified.md @@ -1 +1 @@ -Anyone can publish an action in {% data variables.product.prodname_marketplace %} as long as they meet the terms of service. Unlike apps, {% data variables.product.prodname_actions %} listed in {% data variables.product.prodname_marketplace %} are not verified by {% data variables.product.prodname_dotcom %}. \ No newline at end of file +Anyone can publish an action in {% data variables.product.prodname_marketplace %} as long as they meet the terms of service. Unlike apps, {% data variables.product.prodname_actions %} listed in {% data variables.product.prodname_marketplace %} are not verified by {% data variables.product.prodname_dotcom %}. diff --git a/translations/ko-KR/data/reusables/actions/actions-use-policy-settings.md b/translations/ko-KR/data/reusables/actions/actions-use-policy-settings.md new file mode 100644 index 000000000000..b25cd5eb26be --- /dev/null +++ b/translations/ko-KR/data/reusables/actions/actions-use-policy-settings.md @@ -0,0 +1,3 @@ +If you choose the option to **Allow specific actions**, there are additional options that you can configure. For more information, see "[Allowing specific actions to run](#allowing-specific-actions-to-run)." + +When you allow local actions only, the policy blocks all access to actions authored by {% data variables.product.prodname_dotcom %}. For example, the [`actions/checkout`](https://github.com/actions/checkout) would not be accessible. \ No newline at end of file diff --git a/translations/ko-KR/data/reusables/actions/allow-specific-actions-intro.md b/translations/ko-KR/data/reusables/actions/allow-specific-actions-intro.md new file mode 100644 index 000000000000..248668d773ef --- /dev/null +++ b/translations/ko-KR/data/reusables/actions/allow-specific-actions-intro.md @@ -0,0 +1,19 @@ +When you select the **Allow select actions**, there are additional options that you need to choose to configure the allowed actions: + +- **Allow actions created by {% data variables.product.prodname_dotcom %}:** You can allow all actions created by {% data variables.product.prodname_dotcom %} to be used by workflows. Actions created by {% data variables.product.prodname_dotcom %} are located in the `actions` and `github` organization. For more information, see the [`actions`](https://github.com/actions) and [`github`](https://github.com/github) organizations. +- **Allow Marketplace actions by verified creators:** You can allow all {% data variables.product.prodname_marketplace %} actions created by verified creators to be used by workflows. When GitHub has verified the creator of the action as a partner organization, the {% octicon "verified" aria-label="The verified badge" %} badge is displayed next to the action in {% data variables.product.prodname_marketplace %}. +- **Allow specified actions:** You can restrict workflows to use actions in specific organizations and repositories. + + To restrict access to specific tags or commit SHAs of an action, use the same `/@` syntax used in the workflow to select the action. For example, `actions/javascript-action@v1.0.1` to select a tag or `actions/javascript-action@172239021f7ba04fe7327647b213799853a9eb89` to select a SHA. For more information, see "[Finding and customizing actions](/actions/learn-github-actions/finding-and-customizing-actions#using-release-management-for-your-custom-actions)." + + You can use the `*` wildcard character to match patterns. For example, to allow all actions in organizations that start with `space-org`, you can specify `space-org*/*`. To add all actions in repositories that start with octocat, you can use `*/octocat*@*`. For more information about using the `*` wildcard, see "[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#filter-pattern-cheat-sheet)." + + {% if currentVersion == "free-pro-team@latest" %} + {% note %} + + **Note:** The **Allow specified actions** option is only available in public repositories with the {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} for organizations, or {% data variables.product.prodname_team %} plan. + + {% endnote %} + {% endif %} + +This procedure demonstrates how to add specific actions to the allow list. diff --git a/translations/ko-KR/data/reusables/actions/enterprise-actions-permissions.md b/translations/ko-KR/data/reusables/actions/enterprise-actions-permissions.md index fb9bd1119ddf..72c38f66bcae 100644 --- a/translations/ko-KR/data/reusables/actions/enterprise-actions-permissions.md +++ b/translations/ko-KR/data/reusables/actions/enterprise-actions-permissions.md @@ -1 +1 @@ -1. Under "Policies", select an option. ![Enable, disable, or limits actions for this enterprise account](/assets/images/help/settings/actions-enable-enterprise-account.png) \ No newline at end of file +1. Under "Policies", select an option. ![Enable, disable, or limits actions for this enterprise account](/assets/images/help/organizations/enterprise-actions-policy.png) diff --git a/translations/ko-KR/data/reusables/actions/enterprise-beta.md b/translations/ko-KR/data/reusables/actions/enterprise-beta.md index 876f328cd5c0..30eac75a9196 100644 --- a/translations/ko-KR/data/reusables/actions/enterprise-beta.md +++ b/translations/ko-KR/data/reusables/actions/enterprise-beta.md @@ -4,4 +4,4 @@ **Note:** {% data variables.product.prodname_actions %} support on {% data variables.product.prodname_ghe_server %} 2.22 is a limited public beta. To review the external storage requirements and request access to the beta, see "[Enabling {% data variables.product.prodname_actions %} and configuring storage](/enterprise/admin/github-actions/enabling-github-actions-and-configuring-storage)." {% endnote %} -{% endif %} \ No newline at end of file +{% endif %} diff --git a/translations/ko-KR/data/reusables/actions/enterprise-github-hosted-runners.md b/translations/ko-KR/data/reusables/actions/enterprise-github-hosted-runners.md index 1ef3c4ce19a6..178bf09abe72 100644 --- a/translations/ko-KR/data/reusables/actions/enterprise-github-hosted-runners.md +++ b/translations/ko-KR/data/reusables/actions/enterprise-github-hosted-runners.md @@ -4,4 +4,4 @@ **Note:** {% data variables.product.prodname_dotcom %}-hosted runners are not currently supported on {% data variables.product.prodname_ghe_server %}. You can see more information about planned future support on the [{% data variables.product.prodname_roadmap %}](https://github.com/github/roadmap/issues/72). {% endnote %} -{% endif %} \ No newline at end of file +{% endif %} diff --git a/translations/ko-KR/data/reusables/actions/registry-credentials.md b/translations/ko-KR/data/reusables/actions/registry-credentials.md new file mode 100644 index 000000000000..829539de7800 --- /dev/null +++ b/translations/ko-KR/data/reusables/actions/registry-credentials.md @@ -0,0 +1 @@ +If the image's container registry requires authentication to pull the image, you can use `credentials` to set a `map` of the `username` and `password`. The credentials are the same values that you would provide to the [`docker login`](https://docs.docker.com/engine/reference/commandline/login/) command. diff --git a/translations/ko-KR/data/reusables/actions/scheduled-workflows-disabled.md b/translations/ko-KR/data/reusables/actions/scheduled-workflows-disabled.md new file mode 100644 index 000000000000..bdec7e515b23 --- /dev/null +++ b/translations/ko-KR/data/reusables/actions/scheduled-workflows-disabled.md @@ -0,0 +1 @@ +To prevent unnecessary workflow runs, scheduled workflows may be disabled automatically. When a public repository is forked, scheduled workflows are disabled by default. In a public repository, scheduled workflows are automatically disabled when no repository activity has occurred in 60 days. diff --git a/translations/ko-KR/data/reusables/apps/general-apps-restrictions.md b/translations/ko-KR/data/reusables/apps/general-apps-restrictions.md index 20e20ff5ecf4..3d59f0f6edb2 100644 --- a/translations/ko-KR/data/reusables/apps/general-apps-restrictions.md +++ b/translations/ko-KR/data/reusables/apps/general-apps-restrictions.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}If you are using your app with GitHub Actions and want to modify workflow files, you must authenticate on behalf of the user with an OAuth token that includes the `workflow` scope. The user must have admin or write permission to the repository that contains the workflow file. For more information, see "[Understanding scopes for OAuth apps](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)."{% endif %} \ No newline at end of file +{% if currentVersion == "free-pro-team@latest" %}If you are using your app with GitHub Actions and want to modify workflow files, you must authenticate on behalf of the user with an OAuth token that includes the `workflow` scope. The user must have admin or write permission to the repository that contains the workflow file. For more information, see "[Understanding scopes for OAuth apps](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)."{% endif %} diff --git a/translations/ko-KR/data/reusables/apps/maximum-github-apps-allowed.md b/translations/ko-KR/data/reusables/apps/maximum-github-apps-allowed.md index 93e063db4cb6..e1b7a44e3c28 100644 --- a/translations/ko-KR/data/reusables/apps/maximum-github-apps-allowed.md +++ b/translations/ko-KR/data/reusables/apps/maximum-github-apps-allowed.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}A user or organization can own up to 100 GitHub Apps.{% endif %} \ No newline at end of file +{% if currentVersion == "free-pro-team@latest" %}A user or organization can own up to 100 GitHub Apps.{% endif %} diff --git a/translations/ko-KR/data/reusables/apps/maximum-oauth-apps-allowed.md b/translations/ko-KR/data/reusables/apps/maximum-oauth-apps-allowed.md index b46e9b82c9dc..9e65b80fe2a6 100644 --- a/translations/ko-KR/data/reusables/apps/maximum-oauth-apps-allowed.md +++ b/translations/ko-KR/data/reusables/apps/maximum-oauth-apps-allowed.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}A user or organization can own up to 100 OAuth apps.{% endif %} \ No newline at end of file +{% if currentVersion == "free-pro-team@latest" %}A user or organization can own up to 100 OAuth apps.{% endif %} diff --git a/translations/ko-KR/data/reusables/apps/metadata-permissions.md b/translations/ko-KR/data/reusables/apps/metadata-permissions.md index 61bc044a800f..37608ebcb59c 100644 --- a/translations/ko-KR/data/reusables/apps/metadata-permissions.md +++ b/translations/ko-KR/data/reusables/apps/metadata-permissions.md @@ -1 +1 @@ -If you set the metadata permission to `No access` and select a permission that requires repository access, GitHub will override your selection and set the metadata permission back to `Read-only`. To set the metadata permission to `No access`, you must set all permissions that require repository access to `No access` first. \ No newline at end of file +If you set the metadata permission to `No access` and select a permission that requires repository access, GitHub will override your selection and set the metadata permission back to `Read-only`. To set the metadata permission to `No access`, you must set all permissions that require repository access to `No access` first. diff --git a/translations/ko-KR/data/reusables/apps/oauth-apps-restrictions.md b/translations/ko-KR/data/reusables/apps/oauth-apps-restrictions.md index 2ae56010bacc..fa81dbf36df1 100644 --- a/translations/ko-KR/data/reusables/apps/oauth-apps-restrictions.md +++ b/translations/ko-KR/data/reusables/apps/oauth-apps-restrictions.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}If you are using your OAuth App with GitHub Actions and want to modify workflow files, your OAuth token must have the `workflow` scope and the user must have owner or write permission to the repository that contains the workflow file. For more information, see "[Understanding scopes for OAuth apps](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)."{% endif %} \ No newline at end of file +{% if currentVersion == "free-pro-team@latest" %}If you are using your OAuth App with GitHub Actions and want to modify workflow files, your OAuth token must have the `workflow` scope and the user must have owner or write permission to the repository that contains the workflow file. For more information, see "[Understanding scopes for OAuth apps](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)."{% endif %} diff --git a/translations/ko-KR/data/reusables/apps/state_description.md b/translations/ko-KR/data/reusables/apps/state_description.md index fd754d2939f2..927d8b8a0071 100644 --- a/translations/ko-KR/data/reusables/apps/state_description.md +++ b/translations/ko-KR/data/reusables/apps/state_description.md @@ -1 +1 @@ -An unguessable random string. It is used to protect against cross-site request forgery attacks. \ No newline at end of file +An unguessable random string. It is used to protect against cross-site request forgery attacks. diff --git a/translations/ko-KR/data/reusables/audit_log/audit-log-search.md b/translations/ko-KR/data/reusables/audit_log/audit-log-search.md index 94bfd149d6ef..014bd4d59b5c 100644 --- a/translations/ko-KR/data/reusables/audit_log/audit-log-search.md +++ b/translations/ko-KR/data/reusables/audit_log/audit-log-search.md @@ -8,7 +8,6 @@ The log lists the following information about each action: Note that you cannot search for entries using text. You can, however, construct search queries using a variety of filters. Many operators used when querying the log, such as `-`, `>`, or `<`, match the same format as searching across {% data variables.product.product_name %}. For more information, see "[Searching on {% data variables.product.prodname_dotcom %}](/github/searching-for-information-on-github/about-searching-on-github)." -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} #### Search based on operation Use the `operation` qualifier to limit actions to specific types of operations. 예시: @@ -20,7 +19,6 @@ Use the `operation` qualifier to limit actions to specific types of operations. * `operation:remove` finds all events where an existing resource was removed. * `operation:restore` finds all events where an existing resource was restored. * `operation:transfer` finds all events where an existing resource was transferred. -{% endif %} #### Search based on repository diff --git a/translations/ko-KR/data/reusables/branches/change-default-branch.md b/translations/ko-KR/data/reusables/branches/change-default-branch.md new file mode 100644 index 000000000000..2a44e1845aa7 --- /dev/null +++ b/translations/ko-KR/data/reusables/branches/change-default-branch.md @@ -0,0 +1 @@ +You can change the default branch for an existing repository. For more information, see "[Changing the default branch](/github/administering-a-repository/changing-the-default-branch)." diff --git a/translations/ko-KR/data/reusables/branches/default-branch-automatically-base-branch.md b/translations/ko-KR/data/reusables/branches/default-branch-automatically-base-branch.md index 9350f601c269..b7e77330c423 100644 --- a/translations/ko-KR/data/reusables/branches/default-branch-automatically-base-branch.md +++ b/translations/ko-KR/data/reusables/branches/default-branch-automatically-base-branch.md @@ -1 +1,2 @@ -The default branch is the base branch in your repository, against which all pull requests and code commits are automatically made, unless you specify a different branch. \ No newline at end of file +Unless you specify a different branch, the default branch in a repository is the base branch for new pull requests and code commits. + diff --git a/translations/ko-KR/data/reusables/branches/new-repo-default-branch.md b/translations/ko-KR/data/reusables/branches/new-repo-default-branch.md index 99628077f836..d85e1174ba7f 100644 --- a/translations/ko-KR/data/reusables/branches/new-repo-default-branch.md +++ b/translations/ko-KR/data/reusables/branches/new-repo-default-branch.md @@ -1 +1,2 @@ -When you create a repository on {% data variables.product.prodname_dotcom %} with content, the repository is initialized with a single branch, called the default branch. \ No newline at end of file +When you create a repository with content on {% data variables.product.product_location %}, {% data variables.product.product_name %} creates the repository with a single branch. This first branch in the repository is the default branch. + diff --git a/translations/ko-KR/data/reusables/branches/set-default-branch.md b/translations/ko-KR/data/reusables/branches/set-default-branch.md index a36fcc41b762..f5ff905d85ca 100644 --- a/translations/ko-KR/data/reusables/branches/set-default-branch.md +++ b/translations/ko-KR/data/reusables/branches/set-default-branch.md @@ -1 +1 @@ -If you have admin permissions to a repository, you can change the default branch to another existing branch. For more information, see "[Setting the default branch](/github/administering-a-repository/setting-the-default-branch)." +You can set the name of the default branch for new repositories. For more information, see "[Managing the default branch for your repositories](/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories)," "[Managing the default branch name for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization)," or "[Enforcing a policy on the default branch name](/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account#enforcing-a-policy-on-the-default-branch-name)." diff --git a/translations/ko-KR/data/reusables/code-scanning/analyze-go.md b/translations/ko-KR/data/reusables/code-scanning/analyze-go.md new file mode 100644 index 000000000000..56f04cb3de4a --- /dev/null +++ b/translations/ko-KR/data/reusables/code-scanning/analyze-go.md @@ -0,0 +1 @@ +{% data variables.product.prodname_codeql %} also runs a build for Go projects to set up the project. However, in contrast to the other compiled languages, all Go files in the repository are extracted, not just those that are built. Custom build commands are not supported for Go. \ No newline at end of file diff --git a/translations/ko-KR/data/reusables/code-scanning/autobuild-add-build-steps.md b/translations/ko-KR/data/reusables/code-scanning/autobuild-add-build-steps.md index 61f06aaba9d0..40b9ba69836b 100644 --- a/translations/ko-KR/data/reusables/code-scanning/autobuild-add-build-steps.md +++ b/translations/ko-KR/data/reusables/code-scanning/autobuild-add-build-steps.md @@ -1 +1 @@ -If the C/C++, C#, or Java code in your repository has a non-standard build process or if it's written in more than one compiled language, `autobuild` may fail. You will need to remove the `autobuild` step from the workflow, and manually add build steps. +If the C/C++, C#, or Java code in your repository has a non-standard build process, `autobuild` may fail. You will need to remove the `autobuild` step from the workflow, and manually add build steps. diff --git a/translations/ko-KR/data/reusables/code-scanning/autobuild-compiled-languages.md b/translations/ko-KR/data/reusables/code-scanning/autobuild-compiled-languages.md index 16f72221d6c5..1e599d813b1b 100644 --- a/translations/ko-KR/data/reusables/code-scanning/autobuild-compiled-languages.md +++ b/translations/ko-KR/data/reusables/code-scanning/autobuild-compiled-languages.md @@ -1,5 +1 @@ -For the compiled languages C/C++, C#, and Java, the `autobuild` step in the default {% data variables.product.prodname_codeql %} Analysis workflow attempts to build your code. In contrast to the other compiled languages, {% data variables.product.prodname_codeql %} analyzes Go without building the code. - -The `autobuild` process only ever attempts to build _one_ compiled language for a repository. The language automatically selected for analysis is the language with most files. - - +For the supported compiled languages, you can use the `autobuild` action in the {% data variables.product.prodname_codeql_workflow %} to build your code. This avoids you having to specify explicit build commands for C/C++, C#, and Java. diff --git a/translations/ko-KR/data/reusables/code-scanning/beta-codeql-runner.md b/translations/ko-KR/data/reusables/code-scanning/beta-codeql-runner.md new file mode 100644 index 000000000000..f83682fcfaca --- /dev/null +++ b/translations/ko-KR/data/reusables/code-scanning/beta-codeql-runner.md @@ -0,0 +1,9 @@ +{% if currentVersion == "free-pro-team@latest" %} + +{% note %} + +**Note:** The {% data variables.product.prodname_codeql_runner %} is currently in beta and subject to change. + +{% endnote %} + +{% endif %} diff --git a/translations/ko-KR/data/reusables/code-scanning/beta.md b/translations/ko-KR/data/reusables/code-scanning/beta.md index 2c4184ce1d2e..3525bc8f4aa8 100644 --- a/translations/ko-KR/data/reusables/code-scanning/beta.md +++ b/translations/ko-KR/data/reusables/code-scanning/beta.md @@ -1,5 +1,9 @@ +{% if currentVersion == "enterprise-server@2.22" %} + {% note %} -**Note:** {% data variables.product.prodname_code_scanning_capc %} is currently in beta and subject to change. {% if currentVersion == "free-pro-team@latest" %}To request access to the beta, [join the waitlist](https://github.com/features/security/advanced-security/signup).{% else %}If your organization has an {% data variables.product.prodname_advanced_security %} license, you can [join the beta program](https://resources.github.com/beta-signup/).{% endif %} +**Note:** {% data variables.product.prodname_code_scanning_capc %} is currently in beta and subject to change. For more information about taking part in the beta, [sign up here](https://resources.github.com/beta-signup/). {% endnote %} + +{% endif %} diff --git a/translations/ko-KR/data/reusables/code-scanning/click-alert-in-list.md b/translations/ko-KR/data/reusables/code-scanning/click-alert-in-list.md index a000d0f07d4c..af80aac75dac 100644 --- a/translations/ko-KR/data/reusables/code-scanning/click-alert-in-list.md +++ b/translations/ko-KR/data/reusables/code-scanning/click-alert-in-list.md @@ -1 +1 @@ -1. Under "Code scanning", click the alert you'd like to view. ![List of alerts from {% data variables.product.prodname_code_scanning %}](/assets/images/help/repository/code-scanning-click-alert.png) +1. Under "Code scanning," click the alert you'd like to explore. ![List of alerts from {% data variables.product.prodname_code_scanning %}](/assets/images/help/repository/code-scanning-click-alert.png) diff --git a/translations/ko-KR/data/reusables/code-scanning/close-alert-examples.md b/translations/ko-KR/data/reusables/code-scanning/close-alert-examples.md new file mode 100644 index 000000000000..394120901f5f --- /dev/null +++ b/translations/ko-KR/data/reusables/code-scanning/close-alert-examples.md @@ -0,0 +1 @@ +For example, an error in code that's used only for testing, or when the effort of fixing the error is greater than the potential benefit of improving the code. diff --git a/translations/ko-KR/data/reusables/code-scanning/codeql-runner-license.md b/translations/ko-KR/data/reusables/code-scanning/codeql-runner-license.md index 17283fb710b2..96d197d8dc19 100644 --- a/translations/ko-KR/data/reusables/code-scanning/codeql-runner-license.md +++ b/translations/ko-KR/data/reusables/code-scanning/codeql-runner-license.md @@ -1,10 +1,12 @@ {% note %} {% if currentVersion == "free-pro-team@latest" %} -**Note:** The {% data variables.product.prodname_codeql_runner %} uses the {% data variables.product.prodname_codeql %} CLI to analyze code and therefore has the same license conditions. It's free to use on public repositories that are maintained on {% data variables.product.prodname_dotcom_the_website %}, and available to use on private repositories that are owned by customers with an {% data variables.product.prodname_advanced_security %} license. For information, see "[{% data variables.product.product_name %} {% data variables.product.prodname_codeql %} Terms and Conditions](https://securitylab.github.com/tools/codeql/license)" and "[{% data variables.product.prodname_codeql %} CLI](https://help.semmle.com/codeql/codeql-cli.html)." +**Note:** The +{% data variables.product.prodname_codeql_runner %} uses the {% data variables.product.prodname_codeql %} CLI to analyze code and therefore has the same license conditions. It's free to use on public repositories that are maintained on {% data variables.product.prodname_dotcom_the_website %}, and available to use on private repositories that are owned by customers with an {% data variables.product.prodname_advanced_security %} license. For information, see "[{% data variables.product.product_name %} {% data variables.product.prodname_codeql %} Terms and Conditions](https://securitylab.github.com/tools/codeql/license)" and "[{% data variables.product.prodname_codeql %} CLI](https://help.semmle.com/codeql/codeql-cli.html)." {% else %} -**Note:** The {% data variables.product.prodname_codeql_runner %} is available to customers with an {% data variables.product.prodname_advanced_security %} license. +**Note:** The +{% data variables.product.prodname_codeql_runner %} is available to customers with an {% data variables.product.prodname_advanced_security %} license. {% endif %} -{% endnote %} \ No newline at end of file +{% endnote %} diff --git a/translations/ko-KR/data/reusables/code-scanning/edit-workflow.md b/translations/ko-KR/data/reusables/code-scanning/edit-workflow.md index a98b4098ad9e..98bd06f5cb10 100644 --- a/translations/ko-KR/data/reusables/code-scanning/edit-workflow.md +++ b/translations/ko-KR/data/reusables/code-scanning/edit-workflow.md @@ -1 +1 @@ -Typically, you don't need to edit the default workflow for {% data variables.product.prodname_code_scanning %}. However, if required, you can edit the workflow to customize some of the settings. For example, you can edit {% data variables.product.prodname_dotcom %}'s {% data variables.product.prodname_codeql_workflow %} to specify the frequency of scans, the languages or directories to scan, and what {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} looks for in your code. You might also need to edit the {% data variables.product.prodname_codeql_workflow %} if you use a specific set of commands to compile your code or if there is more than one compiled language in your repository. +Typically, you don't need to edit the default workflow for {% data variables.product.prodname_code_scanning %}. However, if required, you can edit the workflow to customize some of the settings. For example, you can edit {% data variables.product.prodname_dotcom %}'s {% data variables.product.prodname_codeql_workflow %} to specify the frequency of scans, the languages or directories to scan, and what {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} looks for in your code. You might also need to edit the {% data variables.product.prodname_codeql_workflow %} if you use a specific set of commands to compile your code. diff --git a/translations/ko-KR/data/reusables/code-scanning/enabling-options.md b/translations/ko-KR/data/reusables/code-scanning/enabling-options.md index 6b1c8b1a10b9..3ef6731b266a 100644 --- a/translations/ko-KR/data/reusables/code-scanning/enabling-options.md +++ b/translations/ko-KR/data/reusables/code-scanning/enabling-options.md @@ -28,4 +28,4 @@ Using {% data variables.product.prodname_actions %} (see "    Enabling {% data variables.product.prodname_code_scanning %} using actions") or generated externally and uploaded to {% data variables.product.product_name %} (see "Uploading a SARIF file to {% data variables.product.prodname_dotcom %}"). - \ No newline at end of file + diff --git a/translations/ko-KR/data/reusables/code-scanning/false-positive-fix-codeql.md b/translations/ko-KR/data/reusables/code-scanning/false-positive-fix-codeql.md new file mode 100644 index 000000000000..db3da9c9d538 --- /dev/null +++ b/translations/ko-KR/data/reusables/code-scanning/false-positive-fix-codeql.md @@ -0,0 +1 @@ +If you close a {% data variables.product.prodname_codeql %} alert as a false positive result, for example because the code uses a sanitization library that isn't supported, consider contributing to the {% data variables.product.prodname_codeql %} repository and improving the analysis. For more information about {% data variables.product.prodname_codeql %}, see "[Contributing to {% data variables.product.prodname_codeql %}](https://github.com/github/codeql/blob/main/CONTRIBUTING.md)." diff --git a/translations/ko-KR/data/reusables/code-scanning/interoperable-with-tools-that-output-sarif.md b/translations/ko-KR/data/reusables/code-scanning/interoperable-with-tools-that-output-sarif.md index 9be5fd94d166..36bed09e7273 100644 --- a/translations/ko-KR/data/reusables/code-scanning/interoperable-with-tools-that-output-sarif.md +++ b/translations/ko-KR/data/reusables/code-scanning/interoperable-with-tools-that-output-sarif.md @@ -1 +1 @@ -{% data variables.product.prodname_code_scanning_capc %} is interoperable with third-party code scanning tools that output Static Analysis Results Interchange Format (SARIF) data. SARIF is an open standard. For more information, see "[SARIF output for {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning)." \ No newline at end of file +{% data variables.product.prodname_code_scanning_capc %} is interoperable with third-party code scanning tools that output Static Analysis Results Interchange Format (SARIF) data. SARIF is an open standard. For more information, see "[SARIF output for {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning)." diff --git a/translations/ko-KR/data/reusables/code-scanning/specify-language-to-analyze.md b/translations/ko-KR/data/reusables/code-scanning/specify-language-to-analyze.md index 937acdf0ab1f..00904806ec99 100644 --- a/translations/ko-KR/data/reusables/code-scanning/specify-language-to-analyze.md +++ b/translations/ko-KR/data/reusables/code-scanning/specify-language-to-analyze.md @@ -1 +1 @@ -If your repository contains code in multiple languages, you can specify the languages you want to analyze. There are several reasons you might want to prevent a language being analyzed. For example, the project might have dependencies in a different language to the main body of your code, and you might prefer not to see alerts for those dependencies. +If your repository contains code in more than one of the supported languages, you can choose which languages you want to analyze. There are several reasons you might want to prevent a language being analyzed. For example, the project might have dependencies in a different language to the main body of your code, and you might prefer not to see alerts for those dependencies. diff --git a/translations/ko-KR/data/reusables/codespaces/about-billing-for-codespaces.md b/translations/ko-KR/data/reusables/codespaces/about-billing-for-codespaces.md new file mode 100644 index 000000000000..8a1128db5e3c --- /dev/null +++ b/translations/ko-KR/data/reusables/codespaces/about-billing-for-codespaces.md @@ -0,0 +1 @@ +{% data variables.product.prodname_codespaces %} is free to use during the beta. When {% data variables.product.prodname_codespaces %} becomes generally available, you will be billed for storage and compute usage. diff --git a/translations/ko-KR/data/reusables/codespaces/click-remote-explorer-icon-vscode.md b/translations/ko-KR/data/reusables/codespaces/click-remote-explorer-icon-vscode.md index 5e0618af02bf..c49f29679dea 100644 --- a/translations/ko-KR/data/reusables/codespaces/click-remote-explorer-icon-vscode.md +++ b/translations/ko-KR/data/reusables/codespaces/click-remote-explorer-icon-vscode.md @@ -1 +1 @@ -1. In {% data variables.product.prodname_vscode %}, in the left sidebar, click the Remote Explorer icon. ![The Remote Explorer icon in {% data variables.product.prodname_vscode %}](/assets/images/help/codespaces/click-remote-explorer-icon-vscode.png) \ No newline at end of file +1. In {% data variables.product.prodname_vscode %}, in the left sidebar, click the Remote Explorer icon. ![The Remote Explorer icon in {% data variables.product.prodname_vscode %}](/assets/images/help/codespaces/click-remote-explorer-icon-vscode.png) diff --git a/translations/ko-KR/data/reusables/codespaces/codespaces-are-per-branch.md b/translations/ko-KR/data/reusables/codespaces/codespaces-are-per-branch.md index 42d612bb9f3c..146beb47e828 100644 --- a/translations/ko-KR/data/reusables/codespaces/codespaces-are-per-branch.md +++ b/translations/ko-KR/data/reusables/codespaces/codespaces-are-per-branch.md @@ -1 +1 @@ -Each codespace is associated with a specific branch of a repository. \ No newline at end of file +Each codespace is associated with a specific branch of a repository. diff --git a/translations/ko-KR/data/reusables/codespaces/codespaces-are-personal.md b/translations/ko-KR/data/reusables/codespaces/codespaces-are-personal.md index db5fc57640aa..771fe3f97cc4 100644 --- a/translations/ko-KR/data/reusables/codespaces/codespaces-are-personal.md +++ b/translations/ko-KR/data/reusables/codespaces/codespaces-are-personal.md @@ -1 +1 @@ -Each codespace you create is only available to you. No one else can work in your codespace. \ No newline at end of file +Each codespace you create is only available to you. No one else can work in your codespace. diff --git a/translations/ko-KR/data/reusables/codespaces/connect-to-codespace-from-vscode.md b/translations/ko-KR/data/reusables/codespaces/connect-to-codespace-from-vscode.md index fc259120f3f9..045387a57b31 100644 --- a/translations/ko-KR/data/reusables/codespaces/connect-to-codespace-from-vscode.md +++ b/translations/ko-KR/data/reusables/codespaces/connect-to-codespace-from-vscode.md @@ -1 +1 @@ -You can connect to your codespace directly from {% data variables.product.prodname_vscode %}. For more information, see "[Connecting to your codespace from {% data variables.product.prodname_vscode %}](/github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code)." \ No newline at end of file +You can connect to your codespace directly from {% data variables.product.prodname_vscode %}. For more information, see "[Using Codespaces in {% data variables.product.prodname_vscode %}](/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code)." diff --git a/translations/ko-KR/data/reusables/codespaces/devcontainer-location.md b/translations/ko-KR/data/reusables/codespaces/devcontainer-location.md new file mode 100644 index 000000000000..196fc006be1a --- /dev/null +++ b/translations/ko-KR/data/reusables/codespaces/devcontainer-location.md @@ -0,0 +1 @@ +This file can be located in the root of the repository or in a folder called `.devcontainer`. If the file is located in the root of the repository, the filename must begin with a period: `.devcontainer.json`. diff --git a/translations/ko-KR/data/reusables/codespaces/navigate-to-codespaces.md b/translations/ko-KR/data/reusables/codespaces/navigate-to-codespaces.md index dd31eca7e4f8..4ba7c260e0e5 100644 --- a/translations/ko-KR/data/reusables/codespaces/navigate-to-codespaces.md +++ b/translations/ko-KR/data/reusables/codespaces/navigate-to-codespaces.md @@ -1 +1 @@ -1. At the top of any page, click **Codespaces**. ![{% data variables.product.prodname_codespaces %} link in header](/assets/images/help/codespaces/header-link.png) \ No newline at end of file +1. At the top of any page, click **Codespaces**. ![{% data variables.product.prodname_codespaces %} link in header](/assets/images/help/codespaces/header-link.png) diff --git a/translations/ko-KR/data/reusables/codespaces/release-stage.md b/translations/ko-KR/data/reusables/codespaces/release-stage.md index 15d789d79106..2fd3475ccdb2 100644 --- a/translations/ko-KR/data/reusables/codespaces/release-stage.md +++ b/translations/ko-KR/data/reusables/codespaces/release-stage.md @@ -2,4 +2,4 @@ **Note:** {% data variables.product.prodname_codespaces %} is currently in limited public beta and subject to change. During the beta period, {% data variables.product.prodname_dotcom %} does not make any guarantees about the availability of {% data variables.product.prodname_codespaces %}. For more information about joining the beta, see "[About {% data variables.product.prodname_codespaces %}](/github/developing-online-with-codespaces/about-codespaces#joining-the-beta)." -{% endnote %} \ No newline at end of file +{% endnote %} diff --git a/translations/ko-KR/data/reusables/codespaces/unsupported-repos.md b/translations/ko-KR/data/reusables/codespaces/unsupported-repos.md index bd7311a43e46..03fd9189d945 100644 --- a/translations/ko-KR/data/reusables/codespaces/unsupported-repos.md +++ b/translations/ko-KR/data/reusables/codespaces/unsupported-repos.md @@ -1 +1 @@ -During the beta, private repositories owned by organizations or any repositories owned by an organization that requires SAML single sign-on are not supported. \ No newline at end of file +During the beta, private repositories owned by organizations or any repositories owned by an organization that requires SAML single sign-on are not supported. diff --git a/translations/ko-KR/data/reusables/codespaces/use-visual-studio-features.md b/translations/ko-KR/data/reusables/codespaces/use-visual-studio-features.md index 131cd4021aa4..a5b1cf915191 100644 --- a/translations/ko-KR/data/reusables/codespaces/use-visual-studio-features.md +++ b/translations/ko-KR/data/reusables/codespaces/use-visual-studio-features.md @@ -1 +1 @@ -After you open a codespace, you can develop using {% data variables.product.prodname_vscode %}'s features, such as text editing, debugging, and Git commands. For more information, see the [{% data variables.product.prodname_vscode %} documentation](https://code.visualstudio.com/docs). +You can edit code, debug, and use Git commands while developing in a codespace with {% data variables.product.prodname_vscode %}. For more information, see the [{% data variables.product.prodname_vscode %} documentation](https://code.visualstudio.com/docs). diff --git a/translations/ko-KR/data/reusables/codespaces/you-can-see-all-your-codespaces.md b/translations/ko-KR/data/reusables/codespaces/you-can-see-all-your-codespaces.md index daeb0e9ab417..59c85e47d77d 100644 --- a/translations/ko-KR/data/reusables/codespaces/you-can-see-all-your-codespaces.md +++ b/translations/ko-KR/data/reusables/codespaces/you-can-see-all-your-codespaces.md @@ -1 +1 @@ -You can see every codespace owned by your user account at [github.com/codespaces](https://github.com/codespaces). \ No newline at end of file +You can see every codespace owned by your user account at [github.com/codespaces](https://github.com/codespaces). diff --git a/translations/ko-KR/data/reusables/command_line/git-clone-url.md b/translations/ko-KR/data/reusables/command_line/git-clone-url.md index 7acf7db839d0..0ed7dd68150d 100644 --- a/translations/ko-KR/data/reusables/command_line/git-clone-url.md +++ b/translations/ko-KR/data/reusables/command_line/git-clone-url.md @@ -1,4 +1,4 @@ 5. Type `git clone`, and then paste the URL you copied earlier. ```shell $ git clone https://{% data variables.command_line.codeblock %}/YOUR-USERNAME/YOUR-REPOSITORY - ``` \ No newline at end of file + ``` diff --git a/translations/ko-KR/data/reusables/dependabot/check-in-dependabot-yml.md b/translations/ko-KR/data/reusables/dependabot/check-in-dependabot-yml.md index 2502f32e583b..629a74058605 100644 --- a/translations/ko-KR/data/reusables/dependabot/check-in-dependabot-yml.md +++ b/translations/ko-KR/data/reusables/dependabot/check-in-dependabot-yml.md @@ -1 +1 @@ -1. Check the *dependabot.yml* configuration file in to the `.github` directory of the repository. \ No newline at end of file +1. Check the *dependabot.yml* configuration file in to the `.github` directory of the repository. diff --git a/translations/ko-KR/data/reusables/dependabot/create-dependabot-yml.md b/translations/ko-KR/data/reusables/dependabot/create-dependabot-yml.md index 910f3a210739..d8151637a32d 100644 --- a/translations/ko-KR/data/reusables/dependabot/create-dependabot-yml.md +++ b/translations/ko-KR/data/reusables/dependabot/create-dependabot-yml.md @@ -1 +1 @@ -1. Create a *dependabot.yml* configuration file. \ No newline at end of file +1. Create a *dependabot.yml* configuration file. diff --git a/translations/ko-KR/data/reusables/dependabot/default-dependencies-allow-ignore.md b/translations/ko-KR/data/reusables/dependabot/default-dependencies-allow-ignore.md index 0a1a6fde04f0..a229a6340d14 100644 --- a/translations/ko-KR/data/reusables/dependabot/default-dependencies-allow-ignore.md +++ b/translations/ko-KR/data/reusables/dependabot/default-dependencies-allow-ignore.md @@ -1 +1 @@ -By default all dependencies that are explicitly defined in a manifest or lock file are kept up to date. You can use `allow` and `ignore` to customize which dependencies to maintain with version updates. {% data variables.product.prodname_dependabot %} checks for all allowed dependencies and then filters out any ignored dependencies or versions. So a dependency that is matched by both an `allow` and an `ignore` will be ignored. \ No newline at end of file +By default all dependencies that are explicitly defined in a manifest or lock file are kept up to date. You can use `allow` and `ignore` to customize which dependencies to maintain with version updates. {% data variables.product.prodname_dependabot %} checks for all allowed dependencies and then filters out any ignored dependencies or versions. So a dependency that is matched by both an `allow` and an `ignore` will be ignored. diff --git a/translations/ko-KR/data/reusables/dependabot/dependabot-tos.md b/translations/ko-KR/data/reusables/dependabot/dependabot-tos.md index d52b0b03405b..a72c36c5a119 100644 --- a/translations/ko-KR/data/reusables/dependabot/dependabot-tos.md +++ b/translations/ko-KR/data/reusables/dependabot/dependabot-tos.md @@ -1 +1 @@ -{% data variables.product.prodname_dependabot %} and all related features are covered by [{% data variables.product.prodname_dotcom %}'s Terms of Service](/github/site-policy/github-terms-of-service). \ No newline at end of file +{% data variables.product.prodname_dependabot %} and all related features are covered by [{% data variables.product.prodname_dotcom %}'s Terms of Service](/github/site-policy/github-terms-of-service). diff --git a/translations/ko-KR/data/reusables/dependabot/option-affects-security-updates.md b/translations/ko-KR/data/reusables/dependabot/option-affects-security-updates.md index bb25d1b1fc5a..acf2a7655842 100644 --- a/translations/ko-KR/data/reusables/dependabot/option-affects-security-updates.md +++ b/translations/ko-KR/data/reusables/dependabot/option-affects-security-updates.md @@ -1 +1 @@ -Setting this option will also affect pull requests for security updates to the manifest files of this package manager, unless you use `target-branch` to check for version updates on a non-default branch. \ No newline at end of file +Setting this option will also affect pull requests for security updates to the manifest files of this package manager, unless you use `target-branch` to check for version updates on a non-default branch. diff --git a/translations/ko-KR/data/reusables/dependabot/private-dependencies.md b/translations/ko-KR/data/reusables/dependabot/private-dependencies.md index 1ba08ff8f048..dfcbae9c7300 100644 --- a/translations/ko-KR/data/reusables/dependabot/private-dependencies.md +++ b/translations/ko-KR/data/reusables/dependabot/private-dependencies.md @@ -1 +1 @@ -Currently, {% data variables.product.prodname_dependabot_version_updates %} doesn't support manifest or lock files that contain any private git dependencies or private git registries. This is because, when running version updates, {% data variables.product.prodname_dependabot_short %} must be able to resolve all dependencies from their source to verify that version updates have been successful. \ No newline at end of file +Currently, {% data variables.product.prodname_dependabot_version_updates %} doesn't support manifest or lock files that contain any private git dependencies or private git registries. This is because, when running version updates, {% data variables.product.prodname_dependabot_short %} must be able to resolve all dependencies from their source to verify that version updates have been successful. diff --git a/translations/ko-KR/data/reusables/dependabot/supported-package-managers.md b/translations/ko-KR/data/reusables/dependabot/supported-package-managers.md index f9cb69f91be6..22b7b8679281 100644 --- a/translations/ko-KR/data/reusables/dependabot/supported-package-managers.md +++ b/translations/ko-KR/data/reusables/dependabot/supported-package-managers.md @@ -1,15 +1,29 @@ -- Bundler: `bundler` -- Cargo: `cargo` -- Composer: `composer` -- Docker: `docker` -- Elm: `elm` -- git submodule: `gitsubmodule` -- GitHub Actions: `github-actions` -- Go modules: `gomod` -- Gradle: `gradle` -- Maven: `maven` -- Mix: `mix` -- npm: `npm` -- NuGet: `nuget` -- pip: `pip` -- Terraform: `terraform` +| Package manager | Supports vendoring | +| -------------------------------- |:------------------:| +| Bundler: `bundler` | **X** | +| Cargo: `cargo` | | +| Composer: `composer` | | +| Docker: `docker` | | +| Elm: `elm` | | +| git submodule: `gitsubmodule` | | +| GitHub Actions: `github-actions` | | +| Go modules: `gomod` | | +| Gradle: `gradle` | | +| Maven: `maven` | | +| Mix: `mix` | | +| npm: `npm` | | +| NuGet: `nuget` | | +| pip: `pip` | | +| Terraform: `terraform` | | + +{% note %} + +**Note**: {% data variables.product.prodname_dependabot_short %} also supports the following package managers: + +-`yarn` (v1 only) (specify `npm`) + +-`pipenv`, `pip-compile`, and `poetry` (specify `pip`) + +For example, if you use `poetry` to manage your Python dependencies and want {% data variables.product.prodname_dependabot_short %} to monitor your dependency manifest file for new versions, use `package-ecosystem: "pip"` in your *dependabot.yml* file. + +{% endnote %} diff --git a/translations/ko-KR/data/reusables/desktop/choose-a-theme.md b/translations/ko-KR/data/reusables/desktop/choose-a-theme.md index ce406d8548cb..70922847dc74 100644 --- a/translations/ko-KR/data/reusables/desktop/choose-a-theme.md +++ b/translations/ko-KR/data/reusables/desktop/choose-a-theme.md @@ -1,2 +1,2 @@ 3. Click **Appearance**. -4. Click the theme you'd like to use. Optionally, you can select **Automatically switch theme to match system** if you'd like {% data variables.product.prodname_desktop %} to always match the theme on your computer. \ No newline at end of file +4. Click the theme you'd like to use. Optionally, you can select **Automatically switch theme to match system** if you'd like {% data variables.product.prodname_desktop %} to always match the theme on your computer. diff --git a/translations/ko-KR/data/reusables/desktop/confirm-tag.md b/translations/ko-KR/data/reusables/desktop/confirm-tag.md index 50a81fdef16a..168a8b9263f3 100644 --- a/translations/ko-KR/data/reusables/desktop/confirm-tag.md +++ b/translations/ko-KR/data/reusables/desktop/confirm-tag.md @@ -1 +1 @@ -1. Click **Create Tag**. \ No newline at end of file +1. Click **Create Tag**. diff --git a/translations/ko-KR/data/reusables/desktop/create-tag.md b/translations/ko-KR/data/reusables/desktop/create-tag.md index 7fd366b8cb87..27f2b48fcb6a 100644 --- a/translations/ko-KR/data/reusables/desktop/create-tag.md +++ b/translations/ko-KR/data/reusables/desktop/create-tag.md @@ -1 +1 @@ -1. Right-click the commit and click **Create Tag...**. ![Select the create tag menu item](/assets/images/help/desktop/select-create-tag.png) \ No newline at end of file +1. Right-click the commit and click **Create Tag...**. ![Select the create tag menu item](/assets/images/help/desktop/select-create-tag.png) diff --git a/translations/ko-KR/data/reusables/desktop/revert-commit.md b/translations/ko-KR/data/reusables/desktop/revert-commit.md index 96cde101f365..ffd427559f42 100644 --- a/translations/ko-KR/data/reusables/desktop/revert-commit.md +++ b/translations/ko-KR/data/reusables/desktop/revert-commit.md @@ -1 +1 @@ -1. Right-click the commit you want to revert and click **Revert This Commit**. \ No newline at end of file +1. Right-click the commit you want to revert and click **Revert This Commit**. diff --git a/translations/ko-KR/data/reusables/desktop/select-base-branch.md b/translations/ko-KR/data/reusables/desktop/select-base-branch.md index 81cd8449bc96..de87a5d1d567 100644 --- a/translations/ko-KR/data/reusables/desktop/select-base-branch.md +++ b/translations/ko-KR/data/reusables/desktop/select-base-branch.md @@ -1 +1 @@ -1. Select either the current branch, or the default branch (usually master) to base the new branch on. +1. Use the drop-down to choose a base branch for your new branch. diff --git a/translations/ko-KR/data/reusables/dotcom_billing/add-seats.md b/translations/ko-KR/data/reusables/dotcom_billing/add-seats.md index b02298302e66..12c208025b28 100644 --- a/translations/ko-KR/data/reusables/dotcom_billing/add-seats.md +++ b/translations/ko-KR/data/reusables/dotcom_billing/add-seats.md @@ -1 +1 @@ -1. Use the **Edit** drop-down and click **Add seats**. ![Edit drop-down menu](/assets/images/help/billing/add-seats-dropdown.png) \ No newline at end of file +1. Use the **Edit** drop-down and click **Add seats**. ![Edit drop-down menu](/assets/images/help/billing/add-seats-dropdown.png) diff --git a/translations/ko-KR/data/reusables/dotcom_billing/confirm-add-seats.md b/translations/ko-KR/data/reusables/dotcom_billing/confirm-add-seats.md index bdf00645dd83..1fa76e93c439 100644 --- a/translations/ko-KR/data/reusables/dotcom_billing/confirm-add-seats.md +++ b/translations/ko-KR/data/reusables/dotcom_billing/confirm-add-seats.md @@ -1 +1 @@ -1. Click **Add seats**. ![Add seats button](/assets/images/help/billing/add-seats-button.png) \ No newline at end of file +1. Click **Add seats**. ![Add seats button](/assets/images/help/billing/add-seats-button.png) diff --git a/translations/ko-KR/data/reusables/dotcom_billing/number-of-seats.md b/translations/ko-KR/data/reusables/dotcom_billing/number-of-seats.md index e3351710e01f..9324e4073026 100644 --- a/translations/ko-KR/data/reusables/dotcom_billing/number-of-seats.md +++ b/translations/ko-KR/data/reusables/dotcom_billing/number-of-seats.md @@ -1 +1 @@ -1. Under "Add seats", type the number of seats you'd like to add. ![Add seats input](/assets/images/help/billing/add-seats-amount.png) \ No newline at end of file +1. Under "Add seats", type the number of seats you'd like to add. ![Add seats input](/assets/images/help/billing/add-seats-amount.png) diff --git a/translations/ko-KR/data/reusables/dotcom_billing/upgrade_org.md b/translations/ko-KR/data/reusables/dotcom_billing/upgrade_org.md index 8872c11814ab..60ea8fef5cbe 100644 --- a/translations/ko-KR/data/reusables/dotcom_billing/upgrade_org.md +++ b/translations/ko-KR/data/reusables/dotcom_billing/upgrade_org.md @@ -1 +1 @@ -1. If you're upgrading from {% data variables.product.prodname_free_team %}, click **Upgrade options**. If you're upgrading from {% data variables.product.prodname_team %}, use the **Edit** drop-down and click **Upgrade**. ![Upgrade options button](/assets/images/help/billing/choose-monthly-or-yearly-billing.png) \ No newline at end of file +1. If you're upgrading from {% data variables.product.prodname_free_team %}, click **Upgrade options**. If you're upgrading from {% data variables.product.prodname_team %}, use the **Edit** drop-down and click **Upgrade**. ![Upgrade options button](/assets/images/help/billing/choose-monthly-or-yearly-billing.png) diff --git a/translations/ko-KR/data/reusables/enterprise-accounts/access-enterprise.md b/translations/ko-KR/data/reusables/enterprise-accounts/access-enterprise.md index 561c0bd9e8f1..2a7bee222c99 100644 --- a/translations/ko-KR/data/reusables/enterprise-accounts/access-enterprise.md +++ b/translations/ko-KR/data/reusables/enterprise-accounts/access-enterprise.md @@ -1 +1,3 @@ -1. Navigate to your enterprise account by visiting `https://github.com/enterprises/ENTERPRISE-NAME`, replacing `ENTERPRISE-NAME` with your enterprise account's name. +1. In the top-right corner of {% data variables.product.product_name %}, click your profile photo, then click **Your enterprises**. !["Your enterprises" in drop-down menu for profile photo on GitHub](/assets/images/help/enterprises/your-enterprises.png) + +1. In the list of enterprises, click the enterprise you want to view. ![Name of an enterprise in list of your enterprises](/assets/images/help/enterprises/your-enterprises-list.png) diff --git a/translations/ko-KR/data/reusables/enterprise/rate_limit.md b/translations/ko-KR/data/reusables/enterprise/rate_limit.md index dd52413e463c..ddf01e8d889f 100644 --- a/translations/ko-KR/data/reusables/enterprise/rate_limit.md +++ b/translations/ko-KR/data/reusables/enterprise/rate_limit.md @@ -1,3 +1,4 @@ {% if currentVersion != "free-pro-team@latest" %} -Note that the limits mentioned above are the default rate limits for a {% data variables.product.prodname_ghe_server %} instance. Contact your site administrator to confirm if rate limits are enabled and how they are configured. +Note that the limits mentioned above are the default rate limits for a +{% data variables.product.prodname_ghe_server %} instance. Contact your site administrator to confirm if rate limits are enabled and how they are configured. {% endif %} diff --git a/translations/ko-KR/data/reusables/enterprise_clustering/configuration-file-heading.md b/translations/ko-KR/data/reusables/enterprise_clustering/configuration-file-heading.md index 06b1491d9115..9617fb94121d 100644 --- a/translations/ko-KR/data/reusables/enterprise_clustering/configuration-file-heading.md +++ b/translations/ko-KR/data/reusables/enterprise_clustering/configuration-file-heading.md @@ -1 +1 @@ -The cluster configuration file lists each node under a [cluster "HOSTNAME"] heading. \ No newline at end of file +The cluster configuration file lists each node under a [cluster "HOSTNAME"] heading. diff --git a/translations/ko-KR/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md b/translations/ko-KR/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md index 552d96a3b4ab..906c2b24edfe 100644 --- a/translations/ko-KR/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md +++ b/translations/ko-KR/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md @@ -1,6 +1,6 @@ -1. If you're replacing the MySQL master node or Redis master node, in `cluster.conf`, modify the `mysql-master` or `redis-master` value with the replacement node name. +1. If you're replacing the primary MySQL or Redis node, in `cluster.conf`, modify the `mysql-master` or `redis-master` value with the replacement node name. - For example, this modified `cluster.conf` file specifies a newly provisioned cluster node, `ghe-replacement-data-node-1` as the MySQL and Redis master node: 
    +  For example, this modified `cluster.conf` file specifies a newly provisioned cluster node, `ghe-replacement-data-node-1` as the primary MySQL and Redis node: 
       mysql-master = ghe-replacement-data-node-1
   redis-master = ghe-replacement-data-node-1
   
    
diff --git a/translations/ko-KR/data/reusables/enterprise_enterprise_support/submit-support-ticket-first-section.md b/translations/ko-KR/data/reusables/enterprise_enterprise_support/submit-support-ticket-first-section.md
index c28d78103404..42247032b40f 100644
--- a/translations/ko-KR/data/reusables/enterprise_enterprise_support/submit-support-ticket-first-section.md
+++ b/translations/ko-KR/data/reusables/enterprise_enterprise_support/submit-support-ticket-first-section.md
@@ -10,7 +10,9 @@
     - Choose **{% data variables.product.support_ticket_priority_high %}** to report issues impacting business operations, including {% if currentVersion == "free-pro-team@latest" %}removing sensitive data (commits, issues, pull requests, uploaded attachments) from your own accounts and organization restorations{% else %}system performance issues{% endif %}, or to report critical bugs.
     - Choose **{% data variables.product.support_ticket_priority_normal %}** to {% if currentVersion == "free-pro-team@latest" %}request account recovery or spam unflagging, report user login issues{% else %}make technical requests like configuration changes and third-party integrations{% endif %}, and to report non-critical bugs.
     - Choose **{% data variables.product.support_ticket_priority_low %}** to ask general questions and submit requests for new features, purchases, training, or health checks.{% if currentVersion != "free-pro-team@latest" %}
-1. From the "{% data variables.product.prodname_enterprise %} Series" drop-down menu, select the version of {% data variables.product.prodname_ghe_server %} you're using. ![{% data variables.product.prodname_enterprise %} Series drop-down menu](/assets/images/enterprise/support/support-ticket-ghes-series.png)
+1. From the "
+{% data variables.product.prodname_enterprise %} Series" drop-down menu, select the version of {% data variables.product.prodname_ghe_server %} you're using.
+  ![{% data variables.product.prodname_enterprise %} Series drop-down menu](/assets/images/enterprise/support/support-ticket-ghes-series.png)
 {% endif %}
 1. From the "Global Region" drop-down menu, select APAC (Asia Pacific), EMEA (Europe, the Middle East, and Africa), or Americas as your region. ![Global Region drop-down menu](/assets/images/enterprise/support/support-ticket-global-region.png)
 1. Click **Add file**, then attach the diagnostics file you downloaded to include diagnostics with your support ticket. ![Add file button](/assets/images/enterprise/support/support-ticket-add-file.png)
diff --git a/translations/ko-KR/data/reusables/enterprise_enterprise_support/submit-support-ticket-second-section.md b/translations/ko-KR/data/reusables/enterprise_enterprise_support/submit-support-ticket-second-section.md
index cd04bf7ee758..67f68c6f7e05 100644
--- a/translations/ko-KR/data/reusables/enterprise_enterprise_support/submit-support-ticket-second-section.md
+++ b/translations/ko-KR/data/reusables/enterprise_enterprise_support/submit-support-ticket-second-section.md
@@ -1,4 +1,5 @@
 1. Click **Submit**.
 
 {% if currentVersion != "free-pro-team@latest" %}
-If you chose not to include diagnostics with your support ticket, you can share diagnostic information with {% data variables.product.prodname_enterprise %} Support after submitting your support request. For more information, see "[Providing data to {% data variables.product.prodname_dotcom %} Support](/enterprise/admin/guides/enterprise-support/providing-data-to-github-support)."{% endif %}
+If you chose not to include diagnostics with your support ticket, you can share diagnostic information with
+{% data variables.product.prodname_enterprise %} Support after submitting your support request. For more information, see "[Providing data to {% data variables.product.prodname_dotcom %} Support](/enterprise/admin/guides/enterprise-support/providing-data-to-github-support)."{% endif %}
diff --git a/translations/ko-KR/data/reusables/enterprise_installation/aws-supported-instance-types.md b/translations/ko-KR/data/reusables/enterprise_installation/aws-supported-instance-types.md
index dde815abf396..7b4af4b392a5 100644
--- a/translations/ko-KR/data/reusables/enterprise_installation/aws-supported-instance-types.md
+++ b/translations/ko-KR/data/reusables/enterprise_installation/aws-supported-instance-types.md
@@ -28,11 +28,10 @@
 | ----------------- | -------------------------------------------------------------------- |
 | R4                | r4.large, r4.xlarge, r4.2xlarge, r4.4xlarge, r4.8xlarge, r4.16xlarge |
 
-| EC2 instance type | Model                                                                                                                                                                                                                                                                                                      |
-| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| EC2 instance type | Model                                                                                                                                                                                                                                                                                                                                          |
+| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | R5                | r5.large, r5.xlarge, r5.2xlarge, r5.4xlarge, r5.12xlarge, r5.24xlarge{% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.19" %}, r5n.large, r5n.xlarge, r5n.2xlarge, r5n.4xlarge, r5n.12xlarge, r5n.24xlarge, r5a.large, r5a.xlarge, r5a.2xlarge, r5a.4xlarge, r5a.12xlarge, r5a.24xlarge{% endif %}
 
-
 | EC2 instance type | Model                    |
 | ----------------- | ------------------------ |
 | X1                | x1.16xlarge, x1.32xlarge |
diff --git a/translations/ko-KR/data/reusables/enterprise_installation/hardware-rec-table.md b/translations/ko-KR/data/reusables/enterprise_installation/hardware-rec-table.md
index 5d8369bc7b59..4de4ad712004 100644
--- a/translations/ko-KR/data/reusables/enterprise_installation/hardware-rec-table.md
+++ b/translations/ko-KR/data/reusables/enterprise_installation/hardware-rec-table.md
@@ -1,13 +1,13 @@
 {% if currentVersion == "enterprise-server@2.22" %}
 
 Minimum requirements for an instance with beta features enabled are **bold** in the following table. For more information, see "[Beta features in {% data variables.product.prodname_ghe_server %} 2.22](#beta-features-in-github-enterprise-server-222)." |{% endif %}
-| User licenses                  |                                                                                                              vCPUs |                                                                                                                     Memory |                                                                                                           Attached storage | Root storage |
-|:------------------------------ | ------------------------------------------------------------------------------------------------------------------:| --------------------------------------------------------------------------------------------------------------------------:| --------------------------------------------------------------------------------------------------------------------------:| ------------:|
+| User licenses                  |                                                                                                                                  vCPUs |                                                                                                                                         Memory |                                                                                                                               Attached storage | Root storage |
+|:------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------:| ------------:|
 | Trial, demo, or 10 light users |   2{% if currentVersion == "enterprise-server@2.22" %}
    or [**4**](#beta-features-in-github-enterprise-server-222){% endif %} |   16 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**32 GB**](#beta-features-in-github-enterprise-server-222){% endif %} | 100 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**150 GB**](#beta-features-in-github-enterprise-server-222){% endif %} |       200 GB |
 | 10 to 3,000                    |   4{% if currentVersion == "enterprise-server@2.22" %}
    or [**8**](#beta-features-in-github-enterprise-server-222){% endif %} |   32 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**48 GB**](#beta-features-in-github-enterprise-server-222){% endif %} | 250 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**300 GB**](#beta-features-in-github-enterprise-server-222){% endif %} |       200 GB |
-| 3,000 to 5000                  |  8{% if currentVersion == "enterprise-server@2.22" %}
    or [**12**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                      64 GB |                                                                                                                     500 GB |       200 GB |
-| 5,000 to 8000                  | 12{% if currentVersion == "enterprise-server@2.22" %}
    or [**16**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                      96 GB |                                                                                                                     750 GB |       200 GB |
-| 8,000 to 10,000+               | 16{% if currentVersion == "enterprise-server@2.22" %}
    or [**20**](#beta-features-in-github-enterprise-server-222){% endif %} | 128 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**160 GB**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                    1000 GB |       200 GB |
+| 3,000 to 5000                  |  8{% if currentVersion == "enterprise-server@2.22" %}
    or [**12**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                                          64 GB |                                                                                                                                         500 GB |       200 GB |
+| 5,000 to 8000                  | 12{% if currentVersion == "enterprise-server@2.22" %}
    or [**16**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                                          96 GB |                                                                                                                                         750 GB |       200 GB |
+| 8,000 to 10,000+               | 16{% if currentVersion == "enterprise-server@2.22" %}
    or [**20**](#beta-features-in-github-enterprise-server-222){% endif %} | 128 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**160 GB**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                                        1000 GB |       200 GB |
 
 {% if currentVersion == "enterprise-server@2.22" %}
 
diff --git a/translations/ko-KR/data/reusables/enterprise_installation/necessary_ports.md b/translations/ko-KR/data/reusables/enterprise_installation/necessary_ports.md
index 67a4c9153201..57452976b2fa 100644
--- a/translations/ko-KR/data/reusables/enterprise_installation/necessary_ports.md
+++ b/translations/ko-KR/data/reusables/enterprise_installation/necessary_ports.md
@@ -1,12 +1,12 @@
-| Port     | Service | 설명                                                                                                                             |
-| -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------ |
-| 22       | SSH     | Git over SSH access. Clone, fetch, and push operations to public/private repositories supported.                               |
-| 25       | SMTP    | SMTP with encryption (STARTTLS) support.                                                                                       |
-| 80       | HTTP    | Web application access. *All requests are redirected to the HTTPS port when SSL is enabled.*                                   |
-| 122      | SSH     | Instance shell access. *The default SSH port (22) is dedicated to application git+ssh network traffic.*                        |
-| 161/UDP  | SNMP    | Required for network monitoring protocol operation.                                                                            |
-| 443      | HTTPS   | Web application and Git over HTTPS access.                                                                                     |
-| 1194/UDP | VPN     | Secure replication network tunnel in high availability configuration.                                                          |
-| 8080     | HTTP    | Plain-text web based {% data variables.enterprise.management_console %}. *Not required unless SSL is disabled manually.*  |
-| 8443     | HTTPS   | Secure web based {% data variables.enterprise.management_console %}. *Required for basic installation and configuration.* |
-| 9418     | Git     | Simple Git protocol port. Clone and fetch operations to public repositories only. *Unencrypted network communication.*         |
+| Port     | Service | 설명                                                                                                                                                                                      |
+| -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 22       | SSH     | Git over SSH access. Clone, fetch, and push operations to public/private repositories supported.                                                                                        |
+| 25       | SMTP    | SMTP with encryption (STARTTLS) support.                                                                                                                                                |
+| 80       | HTTP    | Web application access. *All requests are redirected to the HTTPS port when SSL is enabled.*                                                                                            |
+| 122      | SSH     | Instance shell access. *The default SSH port (22) is dedicated to application git+ssh network traffic.*                                                                                 |
+| 161/UDP  | SNMP    | Required for network monitoring protocol operation.                                                                                                                                     |
+| 443      | HTTPS   | Web application and Git over HTTPS access.                                                                                                                                              |
+| 1194/UDP | VPN     | Secure replication network tunnel in high availability configuration.                                                                                                                   |
+| 8080     | HTTP    | Plain-text web based {% data variables.enterprise.management_console %}. *Not required unless SSL is disabled manually.*                                                                |
+| 8443     | HTTPS   | Secure web based {% data variables.enterprise.management_console %}. *Required for basic installation and configuration.*                                                               |
+| 9418     | Git     | Simple Git protocol port. Clone and fetch operations to public repositories only. *Unencrypted network communication.* {% data reusables.enterprise_installation.when-9418-necessary %}
diff --git a/translations/ko-KR/data/reusables/enterprise_installation/when-9418-necessary.md b/translations/ko-KR/data/reusables/enterprise_installation/when-9418-necessary.md
new file mode 100644
index 000000000000..7eed264bd24e
--- /dev/null
+++ b/translations/ko-KR/data/reusables/enterprise_installation/when-9418-necessary.md
@@ -0,0 +1 @@
+If you have enabled private mode on your instance, then opening this port is only required if you also enabled anonymous Git read access. For more information, see "[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#configuring-anonymous-git-read-access)."
\ No newline at end of file
diff --git a/translations/ko-KR/data/reusables/enterprise_site_admin_settings/packages-tab.md b/translations/ko-KR/data/reusables/enterprise_site_admin_settings/packages-tab.md
index 7552439d3d6c..add144d1e6c8 100644
--- a/translations/ko-KR/data/reusables/enterprise_site_admin_settings/packages-tab.md
+++ b/translations/ko-KR/data/reusables/enterprise_site_admin_settings/packages-tab.md
@@ -1 +1 @@
-1. In the left sidebar, click **Packages**. ![Packages tab in management console sidebar](/assets/images/enterprise/site-admin-settings/management-console-packages-tab.png)
\ No newline at end of file
+1. In the left sidebar, click **Packages**. ![Packages tab in management console sidebar](/assets/images/enterprise/site-admin-settings/management-console-packages-tab.png)
diff --git a/translations/ko-KR/data/reusables/enterprise_user_management/manage-global-webhooks-api.md b/translations/ko-KR/data/reusables/enterprise_user_management/manage-global-webhooks-api.md
index 035e41f395c1..3e7f9ebcfa9a 100644
--- a/translations/ko-KR/data/reusables/enterprise_user_management/manage-global-webhooks-api.md
+++ b/translations/ko-KR/data/reusables/enterprise_user_management/manage-global-webhooks-api.md
@@ -1 +1 @@
-You can also use {% data variables.product.prodname_enterprise_api %} to manage global webhooks. For a complete list of actions, see "[Global webhooks](/v3/enterprise-admin/global_webhooks)."
+You can also use {% data variables.product.prodname_enterprise_api %} to manage global webhooks. For a complete list of actions, see "[Global webhooks](/rest/reference/enterprise-admin#global-webhooks)."
diff --git a/translations/ko-KR/data/reusables/files/commit-author-email-options.md b/translations/ko-KR/data/reusables/files/commit-author-email-options.md
index 08de0767aca3..d55940ff033d 100644
--- a/translations/ko-KR/data/reusables/files/commit-author-email-options.md
+++ b/translations/ko-KR/data/reusables/files/commit-author-email-options.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-If you haven't enabled email address privacy, you can choose which verified email address to author changes with when you edit, delete, or create files or merge a pull request on {% data variables.product.product_name %}. If you enabled email address privacy, then the commit author email address cannot be changed and is `@users.noreply.github.com` by default.
+If you haven't enabled email address privacy, you can choose which verified email address to author changes with when you edit, delete, or create files or merge a pull request on
+{% data variables.product.product_name %}. If you enabled email address privacy, then the commit author email address cannot be changed and is `@users.noreply.github.com` by default.
 {% endif %}
diff --git a/translations/ko-KR/data/reusables/gated-features/code-scanning.md b/translations/ko-KR/data/reusables/gated-features/code-scanning.md
new file mode 100644
index 000000000000..a1aca3e675eb
--- /dev/null
+++ b/translations/ko-KR/data/reusables/gated-features/code-scanning.md
@@ -0,0 +1 @@
+{% data variables.product.prodname_code_scanning_capc %} is available in public repositories, and in public and private repositories owned by organizations with a license for {% data variables.product.prodname_advanced_security %}. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %}
diff --git a/translations/ko-KR/data/reusables/gated-features/packages.md b/translations/ko-KR/data/reusables/gated-features/packages.md
index 19bafa5320a1..edbce971f3db 100644
--- a/translations/ko-KR/data/reusables/gated-features/packages.md
+++ b/translations/ko-KR/data/reusables/gated-features/packages.md
@@ -1,4 +1,5 @@
 {% data variables.product.prodname_registry %} is available with {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} for organizations, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, {% data variables.product.prodname_ghe_server %} 2.22, and {% data variables.product.prodname_ghe_one %}.
 {% if currentVersion == "free-pro-team@latest" %}
-
    {% data variables.product.prodname_registry %} is not available for private repositories owned by accounts using legacy per-repository plans. Also, accounts using legacy per-repository plans cannot access {% data variables.product.prodname_github_container_registry %} since these accounts are billed by repository. {% data reusables.gated-features.more-info %}
+
    
+{% data variables.product.prodname_registry %} is not available for private repositories owned by accounts using legacy per-repository plans. Also, accounts using legacy per-repository plans cannot access {% data variables.product.prodname_github_container_registry %} since these accounts are billed by repository. {% data reusables.gated-features.more-info %}
 {% endif %}
diff --git a/translations/ko-KR/data/reusables/github-actions/actions-billing.md b/translations/ko-KR/data/reusables/github-actions/actions-billing.md
index 54528ddafd95..947b31a56dda 100644
--- a/translations/ko-KR/data/reusables/github-actions/actions-billing.md
+++ b/translations/ko-KR/data/reusables/github-actions/actions-billing.md
@@ -1 +1 @@
-{% data variables.product.prodname_actions %} usage is free for public repositories. For private repositories, each {% data variables.product.prodname_dotcom %} account receives a certain amount of free minutes and storage, depending on the product used with the account.
+{% data variables.product.prodname_actions %} usage is free for public repositories and self-hosted runners. For private repositories, each {% data variables.product.prodname_dotcom %} account receives a certain amount of free minutes and storage, depending on the product used with the account.
diff --git a/translations/ko-KR/data/reusables/github-actions/actions-on-examples.md b/translations/ko-KR/data/reusables/github-actions/actions-on-examples.md
index c347798bb25c..beea3062f56b 100644
--- a/translations/ko-KR/data/reusables/github-actions/actions-on-examples.md
+++ b/translations/ko-KR/data/reusables/github-actions/actions-on-examples.md
@@ -1,14 +1,14 @@
 ##### **Example using a single event**
 
 ```yaml
-# Trigger on push
+# Triggered when code is pushed to any branch in a repository
 on: push
 ```
 
 ##### **Example using a list of events**
 
 ```yaml
-# Trigger the workflow on push or pull request
+# Triggers the workflow on push or pull request events
 on: [push, pull_request]
 ```
 
@@ -19,13 +19,13 @@ If you need to specify activity types or configuration for an event, you must co
 ```yaml
 on:
   # Trigger the workflow on push or pull request,
-  # but only for the master branch
+  # but only for the main branch
   push:
     branches:
-      - master
+      - main
   pull_request:
     branches:
-      - master
+      - main
   # Also trigger on page_build, as well as release created events
   page_build:
   release:
diff --git a/translations/ko-KR/data/reusables/github-actions/actions-unused-labels.md b/translations/ko-KR/data/reusables/github-actions/actions-unused-labels.md
index 1ffeed9d6120..3b8f8366e107 100644
--- a/translations/ko-KR/data/reusables/github-actions/actions-unused-labels.md
+++ b/translations/ko-KR/data/reusables/github-actions/actions-unused-labels.md
@@ -1 +1 @@
- Any unused labels that are not assigned to a runner will be automatically deleted within 24 hours.
\ No newline at end of file
+ Any unused labels that are not assigned to a runner will be automatically deleted within 24 hours.
diff --git a/translations/ko-KR/data/reusables/github-actions/artifact-log-retention-statement.md b/translations/ko-KR/data/reusables/github-actions/artifact-log-retention-statement.md
new file mode 100644
index 000000000000..1109967df33c
--- /dev/null
+++ b/translations/ko-KR/data/reusables/github-actions/artifact-log-retention-statement.md
@@ -0,0 +1,2 @@
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} By default, {% data variables.product.product_name %} stores build logs and artifacts for 90 days, and this retention period can be customized. For more information, see "[Usage limits, billing, and administration](/actions/reference/usage-limits-billing-and-administration#artifact-and-log-retention-policy)".{% endif %}
+{% if currentVersion == "enterprise-server@2.22" %} {% data variables.product.product_name %} stores full build logs and artifacts for 90 days.{% endif %}
diff --git a/translations/ko-KR/data/reusables/github-actions/branch-requirement.md b/translations/ko-KR/data/reusables/github-actions/branch-requirement.md
index ab6508a4520f..b8be9a7d5365 100644
--- a/translations/ko-KR/data/reusables/github-actions/branch-requirement.md
+++ b/translations/ko-KR/data/reusables/github-actions/branch-requirement.md
@@ -1,5 +1,5 @@
 {% note %}
 
-**Note:** This event will only trigger a workflow run if the workflow file is on the `master` or default branch.
+**Note:** This event will only trigger a workflow run if the workflow file is on the default branch.
 
 {% endnote %}
diff --git a/translations/ko-KR/data/reusables/github-actions/change-retention-period-for-artifacts-logs.md b/translations/ko-KR/data/reusables/github-actions/change-retention-period-for-artifacts-logs.md
new file mode 100644
index 000000000000..19398bca6ab8
--- /dev/null
+++ b/translations/ko-KR/data/reusables/github-actions/change-retention-period-for-artifacts-logs.md
@@ -0,0 +1,2 @@
+1. Under **Artifact and log retention duration**, enter a new value.
+1. Click **Save** to apply the change.
\ No newline at end of file
diff --git a/translations/ko-KR/data/reusables/github-actions/disabled-actions-description.md b/translations/ko-KR/data/reusables/github-actions/disabled-actions-description.md
index f197bca51c61..38f9cd246a8b 100644
--- a/translations/ko-KR/data/reusables/github-actions/disabled-actions-description.md
+++ b/translations/ko-KR/data/reusables/github-actions/disabled-actions-description.md
@@ -1 +1 @@
-When you disable {% data variables.product.prodname_actions %}, no workflows run in your repository.
\ No newline at end of file
+When you disable {% data variables.product.prodname_actions %}, no workflows run in your repository.
diff --git a/translations/ko-KR/data/reusables/github-actions/docker-container-os-support.md b/translations/ko-KR/data/reusables/github-actions/docker-container-os-support.md
index df010643d9d0..8dc5f40b5c72 100644
--- a/translations/ko-KR/data/reusables/github-actions/docker-container-os-support.md
+++ b/translations/ko-KR/data/reusables/github-actions/docker-container-os-support.md
@@ -2,7 +2,7 @@
 
 **Note:** If your workflows use Docker container actions or service containers, then you must use a Linux runner:
 
-* If you are using {% data variables.product.prodname_dotcom %}-hosted runners, you must use the `ubuntu-latest` runner.
+* If you are using {% data variables.product.prodname_dotcom %}-hosted runners, you must use an Ubuntu runner.
 * If you are using self-hosted runners, you must use a Linux machine as your runner and Docker must be installed.
 
 {% endnote %}
diff --git a/translations/ko-KR/data/reusables/github-actions/dockerfile-guidelines.md b/translations/ko-KR/data/reusables/github-actions/dockerfile-guidelines.md
index 2ea8f4735b5a..725fe988d98d 100644
--- a/translations/ko-KR/data/reusables/github-actions/dockerfile-guidelines.md
+++ b/translations/ko-KR/data/reusables/github-actions/dockerfile-guidelines.md
@@ -1,3 +1,3 @@
 1. Document required arguments in the action's README and omit them from the `CMD` instruction.
 1. Use defaults that allow using the action without specifying any `args`.
-1. If the action exposes a `--help` flag, or something similar, use that to make your action self-documenting.
\ No newline at end of file
+1. If the action exposes a `--help` flag, or something similar, use that to make your action self-documenting.
diff --git a/translations/ko-KR/data/reusables/github-actions/enabled-actions-description.md b/translations/ko-KR/data/reusables/github-actions/enabled-actions-description.md
index dbf2d1586ffe..3e8b54c0122a 100644
--- a/translations/ko-KR/data/reusables/github-actions/enabled-actions-description.md
+++ b/translations/ko-KR/data/reusables/github-actions/enabled-actions-description.md
@@ -1 +1 @@
-When you enable {% data variables.product.prodname_actions %}, workflows are able to run actions located within your repository and any other public repository.
\ No newline at end of file
+When you enable {% data variables.product.prodname_actions %}, workflows are able to run actions located within your repository and any other public repository.
diff --git a/translations/ko-KR/data/reusables/github-actions/enabled-local-github-actions.md b/translations/ko-KR/data/reusables/github-actions/enabled-local-github-actions.md
index 6b42f587f7ad..2eedbc2de9a0 100644
--- a/translations/ko-KR/data/reusables/github-actions/enabled-local-github-actions.md
+++ b/translations/ko-KR/data/reusables/github-actions/enabled-local-github-actions.md
@@ -1 +1 @@
-When you enable local actions only, workflows can only run actions located in your repository or organization.
\ No newline at end of file
+When you enable local actions only, workflows can only run actions located in your repository or organization.
diff --git a/translations/ko-KR/data/reusables/github-actions/expression-syntax-if.md b/translations/ko-KR/data/reusables/github-actions/expression-syntax-if.md
index d45ed4314e3a..69549fd112ee 100644
--- a/translations/ko-KR/data/reusables/github-actions/expression-syntax-if.md
+++ b/translations/ko-KR/data/reusables/github-actions/expression-syntax-if.md
@@ -1 +1 @@
-When you use expressions in an `if` conditional, you may omit the expression syntax ({% raw %}`${{ }}`{% endraw %}) because {% data variables.product.prodname_dotcom %} automatically evaluates the `if` conditional as an expression.
\ No newline at end of file
+When you use expressions in an `if` conditional, you may omit the expression syntax ({% raw %}`${{ }}`{% endraw %}) because {% data variables.product.prodname_dotcom %} automatically evaluates the `if` conditional as an expression.
diff --git a/translations/ko-KR/data/reusables/github-actions/gradle-workflow-steps.md b/translations/ko-KR/data/reusables/github-actions/gradle-workflow-steps.md
index 0d6e75db3df9..4522b7281395 100644
--- a/translations/ko-KR/data/reusables/github-actions/gradle-workflow-steps.md
+++ b/translations/ko-KR/data/reusables/github-actions/gradle-workflow-steps.md
@@ -1,4 +1,4 @@
 This workflow performs the following steps:
 
 1. Checks out a copy of project's repository.
-1. Sets up the Java JDK.
\ No newline at end of file
+1. Sets up the Java JDK.
diff --git a/translations/ko-KR/data/reusables/github-actions/permissions-statement-secrets-api.md b/translations/ko-KR/data/reusables/github-actions/permissions-statement-secrets-api.md
index 0a3741949b26..0e62bb6498c9 100644
--- a/translations/ko-KR/data/reusables/github-actions/permissions-statement-secrets-api.md
+++ b/translations/ko-KR/data/reusables/github-actions/permissions-statement-secrets-api.md
@@ -1 +1 @@
-To create secrets using the REST API, you must have write access to the repository. For more information, see "[{% data variables.product.prodname_actions %} secrets API](/v3/actions/secrets/)."
+To create secrets using the REST API, you must have write access to the repository or admin access to the organization. For more information, see "[{% data variables.product.prodname_actions %} secrets API](/v3/actions/secrets/)."
diff --git a/translations/ko-KR/data/reusables/github-actions/permissions-statement-secrets-organization.md b/translations/ko-KR/data/reusables/github-actions/permissions-statement-secrets-organization.md
index 7f9339913a67..235a52b2896c 100644
--- a/translations/ko-KR/data/reusables/github-actions/permissions-statement-secrets-organization.md
+++ b/translations/ko-KR/data/reusables/github-actions/permissions-statement-secrets-organization.md
@@ -1 +1 @@
-To create secrets at the organization level, you must have `admin` access. 
\ No newline at end of file
+To create secrets at the organization level, you must have `admin` access. 
diff --git a/translations/ko-KR/data/reusables/github-actions/permissions-statement-secrets-repository.md b/translations/ko-KR/data/reusables/github-actions/permissions-statement-secrets-repository.md
index 2c2c4430059e..0333c71723ba 100644
--- a/translations/ko-KR/data/reusables/github-actions/permissions-statement-secrets-repository.md
+++ b/translations/ko-KR/data/reusables/github-actions/permissions-statement-secrets-repository.md
@@ -1 +1 @@
-To create secrets for a user account repository, you must be the repository owner. To create secrets for an organization repository, you must have `admin` access.
\ No newline at end of file
+To create secrets for a user account repository, you must be the repository owner. To create secrets for an organization repository, you must have `admin` access.
diff --git a/translations/ko-KR/data/reusables/github-actions/private-repository-forks-overview.md b/translations/ko-KR/data/reusables/github-actions/private-repository-forks-overview.md
index d976a281d09a..7be48f36df22 100644
--- a/translations/ko-KR/data/reusables/github-actions/private-repository-forks-overview.md
+++ b/translations/ko-KR/data/reusables/github-actions/private-repository-forks-overview.md
@@ -2,4 +2,4 @@ If you rely on using forks of your private repositories, you can configure polic
 
 - **Run workflows from fork pull requests** - Allows users to run workflows from fork pull requests, using a `GITHUB_TOKEN` with read-only permission, and with no access to secrets.
 - **Send write tokens to workflows from pull requests** - Allows pull requests from forks to use a `GITHUB_TOKEN` with write permission.
-- **Send secrets to workflows from pull requests** - Makes all secrets available to the pull request.
\ No newline at end of file
+- **Send secrets to workflows from pull requests** - Makes all secrets available to the pull request.
diff --git a/translations/ko-KR/data/reusables/github-actions/publish-to-maven-workflow-step.md b/translations/ko-KR/data/reusables/github-actions/publish-to-maven-workflow-step.md
index e8e5bf28c541..24292b0b1246 100644
--- a/translations/ko-KR/data/reusables/github-actions/publish-to-maven-workflow-step.md
+++ b/translations/ko-KR/data/reusables/github-actions/publish-to-maven-workflow-step.md
@@ -1 +1 @@
-Runs the `mvn -B deploy` command to publish to the `ossrh` repository. The `MAVEN_USERNAME` environment variable will be set with the contents of your `OSSRH_USERNAME` secret, and the `MAVEN_PASSWORD` environment variable will be set with the contents of your `OSSRH_TOKEN` secret.
\ No newline at end of file
+Runs the `mvn -B deploy` command to publish to the `ossrh` repository. The `MAVEN_USERNAME` environment variable will be set with the contents of your `OSSRH_USERNAME` secret, and the `MAVEN_PASSWORD` environment variable will be set with the contents of your `OSSRH_TOKEN` secret.
diff --git a/translations/ko-KR/data/reusables/github-actions/publish-to-packages-workflow-step.md b/translations/ko-KR/data/reusables/github-actions/publish-to-packages-workflow-step.md
index 120311e8558b..aa0c63eeeac0 100644
--- a/translations/ko-KR/data/reusables/github-actions/publish-to-packages-workflow-step.md
+++ b/translations/ko-KR/data/reusables/github-actions/publish-to-packages-workflow-step.md
@@ -1 +1 @@
-Runs the `mvn -B deploy` command to publish to {% data variables.product.prodname_registry %}. The `GITHUB_TOKEN` environment variable will be set with the contents of the `GITHUB_TOKEN` secret.
\ No newline at end of file
+Runs the `mvn -B deploy` command to publish to {% data variables.product.prodname_registry %}. The `GITHUB_TOKEN` environment variable will be set with the contents of the `GITHUB_TOKEN` secret.
diff --git a/translations/ko-KR/data/reusables/github-actions/publishing-java-packages-intro.md b/translations/ko-KR/data/reusables/github-actions/publishing-java-packages-intro.md
index 57a4e97a9d58..0b66dce5a795 100644
--- a/translations/ko-KR/data/reusables/github-actions/publishing-java-packages-intro.md
+++ b/translations/ko-KR/data/reusables/github-actions/publishing-java-packages-intro.md
@@ -1 +1 @@
-This guide shows you how to create a workflow that publishes Java packages to {% data variables.product.prodname_registry %} and the Maven Central Repository. With a single workflow, you can publish packages to a single repository or to multiple repositories.
\ No newline at end of file
+This guide shows you how to create a workflow that publishes Java packages to {% data variables.product.prodname_registry %} and the Maven Central Repository. With a single workflow, you can publish packages to a single repository or to multiple repositories.
diff --git a/translations/ko-KR/data/reusables/github-actions/run_id_description.md b/translations/ko-KR/data/reusables/github-actions/run_id_description.md
index c82a4ce8b83c..e47047c28c24 100644
--- a/translations/ko-KR/data/reusables/github-actions/run_id_description.md
+++ b/translations/ko-KR/data/reusables/github-actions/run_id_description.md
@@ -1 +1 @@
-A unique number for each run within a repository. This number does not change if you re-run the workflow run.
\ No newline at end of file
+A unique number for each run within a repository. This number does not change if you re-run the workflow run.
diff --git a/translations/ko-KR/data/reusables/github-actions/run_number_description.md b/translations/ko-KR/data/reusables/github-actions/run_number_description.md
index 4c7db006d6c6..7f4c94a6224e 100644
--- a/translations/ko-KR/data/reusables/github-actions/run_number_description.md
+++ b/translations/ko-KR/data/reusables/github-actions/run_number_description.md
@@ -1 +1 @@
-A unique number for each run of a particular workflow in a repository. This number begins at 1 for the workflow's first run, and increments with each new run. This number does not change if you re-run the workflow run.
\ No newline at end of file
+A unique number for each run of a particular workflow in a repository. This number begins at 1 for the workflow's first run, and increments with each new run. This number does not change if you re-run the workflow run.
diff --git a/translations/ko-KR/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md b/translations/ko-KR/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md
index 68ee5ec4ef01..59d3343c244e 100644
--- a/translations/ko-KR/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md
+++ b/translations/ko-KR/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md
@@ -1,2 +1,2 @@
 1. In the **Self-hosted runners** section of the settings page, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} next to the runner group you'd like to configure, then click **Edit name and [organization|repository] access**. ![Manage repository permissions](/assets/images/help/settings/actions-runner-manage-permissions.png)
-1. Select a new policy from the dropdown list, or modify the runner group name.
\ No newline at end of file
+1. Select a new policy from the dropdown list, or modify the runner group name.
diff --git a/translations/ko-KR/data/reusables/github-actions/self-hosted-runner-list-group.md b/translations/ko-KR/data/reusables/github-actions/self-hosted-runner-list-group.md
index b86a8be047bc..b1512186b608 100644
--- a/translations/ko-KR/data/reusables/github-actions/self-hosted-runner-list-group.md
+++ b/translations/ko-KR/data/reusables/github-actions/self-hosted-runner-list-group.md
@@ -1 +1 @@
-1. If your runner is in a group, locate the runner group and click {% octicon "chevron-down" aria-label="The downward chevron" %} to view the list of runners. ![List runner group](/assets/images/help/settings/actions-org-enterprise-list-group-runners.png)
\ No newline at end of file
+1. If your runner is in a group, locate the runner group and click {% octicon "chevron-down" aria-label="The downward chevron" %} to view the list of runners. ![List runner group](/assets/images/help/settings/actions-org-enterprise-list-group-runners.png)
diff --git a/translations/ko-KR/data/reusables/github-actions/self-hosted-runner-list.md b/translations/ko-KR/data/reusables/github-actions/self-hosted-runner-list.md
index 315f976b7614..3e0ee5b85253 100644
--- a/translations/ko-KR/data/reusables/github-actions/self-hosted-runner-list.md
+++ b/translations/ko-KR/data/reusables/github-actions/self-hosted-runner-list.md
@@ -1 +1 @@
- 1. Locate the list of runners under "Self-hosted runners".
\ No newline at end of file
+ 1. Locate the list of runners under "Self-hosted runners".
diff --git a/translations/ko-KR/data/reusables/github-actions/self-hosted-runner-navigate-repo-and-org.md b/translations/ko-KR/data/reusables/github-actions/self-hosted-runner-navigate-repo-and-org.md
index 1072cf23d061..995eb0964f7a 100644
--- a/translations/ko-KR/data/reusables/github-actions/self-hosted-runner-navigate-repo-and-org.md
+++ b/translations/ko-KR/data/reusables/github-actions/self-hosted-runner-navigate-repo-and-org.md
@@ -1 +1 @@
-1. In your organization or repository, navigate to the main page and click {% octicon "gear" aria-label="The Settings gear" %} **Settings**.
\ No newline at end of file
+1. In your organization or repository, navigate to the main page and click {% octicon "gear" aria-label="The Settings gear" %} **Settings**.
diff --git a/translations/ko-KR/data/reusables/github-actions/self-hosted-runner-removal-impact.md b/translations/ko-KR/data/reusables/github-actions/self-hosted-runner-removal-impact.md
index da0486e69f1b..0b402934fab2 100644
--- a/translations/ko-KR/data/reusables/github-actions/self-hosted-runner-removal-impact.md
+++ b/translations/ko-KR/data/reusables/github-actions/self-hosted-runner-removal-impact.md
@@ -1 +1 @@
-This procedure permanently removes the self-hosted runner. If you only want to temporarily stop a runner from being assigned jobs, you can either shut down the machine or stop the `run` application. The runner will remain assigned in an "Offline" state, and won't execute any jobs until you restart the runner using the `run` application.
\ No newline at end of file
+This procedure permanently removes the self-hosted runner. If you only want to temporarily stop a runner from being assigned jobs, you can either shut down the machine or stop the `run` application. The runner will remain assigned in an "Offline" state, and won't execute any jobs until you restart the runner using the `run` application.
diff --git a/translations/ko-KR/data/reusables/github-actions/self-hosted-runner-reusing.md b/translations/ko-KR/data/reusables/github-actions/self-hosted-runner-reusing.md
index 0435ac7bb9ec..c15c029bdca3 100644
--- a/translations/ko-KR/data/reusables/github-actions/self-hosted-runner-reusing.md
+++ b/translations/ko-KR/data/reusables/github-actions/self-hosted-runner-reusing.md
@@ -1 +1 @@
-Alternatively, if you don't have access to the repository, organization, or enterprise on {% data variables.product.product_name %} to remove a runner, but you would like to re-use the runner machine, then you can delete the `.runner` file inside the self-hosted runner application directory. This allows the runner to be registered without having to re-download the self-hosted runner application.
\ No newline at end of file
+Alternatively, if you don't have access to the repository, organization, or enterprise on {% data variables.product.product_name %} to remove a runner, but you would like to re-use the runner machine, then you can delete the `.runner` file inside the self-hosted runner application directory. This allows the runner to be registered without having to re-download the self-hosted runner application.
diff --git a/translations/ko-KR/data/reusables/github-actions/sidebar-secret.md b/translations/ko-KR/data/reusables/github-actions/sidebar-secret.md
index 64a2802bf99f..9181cb0eaa1d 100644
--- a/translations/ko-KR/data/reusables/github-actions/sidebar-secret.md
+++ b/translations/ko-KR/data/reusables/github-actions/sidebar-secret.md
@@ -1 +1 @@
-1. In the left sidebar, click **Secrets**.
\ No newline at end of file
+1. In the left sidebar, click **Secrets**.
diff --git a/translations/ko-KR/data/reusables/github-actions/usage-api-requests.md b/translations/ko-KR/data/reusables/github-actions/usage-api-requests.md
new file mode 100644
index 000000000000..53bf8ef7e901
--- /dev/null
+++ b/translations/ko-KR/data/reusables/github-actions/usage-api-requests.md
@@ -0,0 +1 @@
+- **API requests** - You can execute up to 1000 API requests in an hour across all actions within a repository. If exceeded, additional API calls will fail, which might cause jobs to fail.
diff --git a/translations/ko-KR/data/reusables/github-actions/usage-matrix-limits.md b/translations/ko-KR/data/reusables/github-actions/usage-matrix-limits.md
new file mode 100644
index 000000000000..8ffadd1225bc
--- /dev/null
+++ b/translations/ko-KR/data/reusables/github-actions/usage-matrix-limits.md
@@ -0,0 +1 @@
+- **Job matrix** - A job matrix can generate a maximum of 256 jobs per workflow run. This limit also applies to self-hosted runners.
diff --git a/translations/ko-KR/data/reusables/github-actions/usage-workflow-run-time.md b/translations/ko-KR/data/reusables/github-actions/usage-workflow-run-time.md
new file mode 100644
index 000000000000..e3f8bee3e1e5
--- /dev/null
+++ b/translations/ko-KR/data/reusables/github-actions/usage-workflow-run-time.md
@@ -0,0 +1 @@
+- **Workflow run time** - Each workflow run is limited to 72 hours. If a workflow run reaches this limit, the workflow run is cancelled.
diff --git a/translations/ko-KR/data/reusables/github-insights/choose-key-metric.md b/translations/ko-KR/data/reusables/github-insights/choose-key-metric.md
index d7495147a32a..5e5c6e8415e2 100644
--- a/translations/ko-KR/data/reusables/github-insights/choose-key-metric.md
+++ b/translations/ko-KR/data/reusables/github-insights/choose-key-metric.md
@@ -1 +1 @@
-2. Under **{% octicon "graph" aria-label="The graph icon" %} Key metrics**, click the name of the metric you want to view. ![List of key metrics](/assets/images/help/insights/key-metrics-list.png)
\ No newline at end of file
+2. Under **{% octicon "graph" aria-label="The graph icon" %} Key metrics**, click the name of the metric you want to view. ![List of key metrics](/assets/images/help/insights/key-metrics-list.png)
diff --git a/translations/ko-KR/data/reusables/github-insights/navigate-to-key-metrics.md b/translations/ko-KR/data/reusables/github-insights/navigate-to-key-metrics.md
index c5317819af4e..90dd55186253 100644
--- a/translations/ko-KR/data/reusables/github-insights/navigate-to-key-metrics.md
+++ b/translations/ko-KR/data/reusables/github-insights/navigate-to-key-metrics.md
@@ -1 +1 @@
-1. In {% data variables.product.prodname_insights %}, click **{% octicon "graph" aria-label="The graph icon" %} Key metrics**. ![Key metrics tab](/assets/images/help/insights/key-metrics-tab.png)
\ No newline at end of file
+1. In {% data variables.product.prodname_insights %}, click **{% octicon "graph" aria-label="The graph icon" %} Key metrics**. ![Key metrics tab](/assets/images/help/insights/key-metrics-tab.png)
diff --git a/translations/ko-KR/data/reusables/gpg/private-email.md b/translations/ko-KR/data/reusables/gpg/private-email.md
index 14d4c6496922..15ea1833856c 100644
--- a/translations/ko-KR/data/reusables/gpg/private-email.md
+++ b/translations/ko-KR/data/reusables/gpg/private-email.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-To keep your email address private, use your {% data variables.product.product_name %}-provided `no-reply` email address.
+To keep your email address private, use your
+{% data variables.product.product_name %}-provided `no-reply` email address.
 {% endif %}
diff --git a/translations/ko-KR/data/reusables/identity-and-permissions/enable-team-sync-azure.md b/translations/ko-KR/data/reusables/identity-and-permissions/enable-team-sync-azure.md
index c61561e35962..85a0204931b7 100644
--- a/translations/ko-KR/data/reusables/identity-and-permissions/enable-team-sync-azure.md
+++ b/translations/ko-KR/data/reusables/identity-and-permissions/enable-team-sync-azure.md
@@ -1 +1 @@
-1. Under "Team synchronization", click **Enable for Azure AD**. ![Enable team synchronization button on security settings page](/assets/images/help/teams/enable-team-synchronization.png)
\ No newline at end of file
+1. Under "Team synchronization", click **Enable for Azure AD**. ![Enable team synchronization button on security settings page](/assets/images/help/teams/enable-team-synchronization.png)
diff --git a/translations/ko-KR/data/reusables/identity-and-permissions/enable-team-sync-okta.md b/translations/ko-KR/data/reusables/identity-and-permissions/enable-team-sync-okta.md
index c12a73bf8bea..3e8ec8b63cd8 100644
--- a/translations/ko-KR/data/reusables/identity-and-permissions/enable-team-sync-okta.md
+++ b/translations/ko-KR/data/reusables/identity-and-permissions/enable-team-sync-okta.md
@@ -1 +1 @@
-1. Under "Team synchronization", click **Enable for Okta**. ![Enable team synchronization for Okta button on security settings page](/assets/images/help/teams/enable-team-synchronization-okta.png)
\ No newline at end of file
+1. Under "Team synchronization", click **Enable for Okta**. ![Enable team synchronization for Okta button on security settings page](/assets/images/help/teams/enable-team-synchronization-okta.png)
diff --git a/translations/ko-KR/data/reusables/identity-and-permissions/supported-idps-team-sync.md b/translations/ko-KR/data/reusables/identity-and-permissions/supported-idps-team-sync.md
index 11f6e8f6ea0d..1395abe61e66 100644
--- a/translations/ko-KR/data/reusables/identity-and-permissions/supported-idps-team-sync.md
+++ b/translations/ko-KR/data/reusables/identity-and-permissions/supported-idps-team-sync.md
@@ -1,3 +1,3 @@
 You can use team synchronization with supported IdPs.
   - Azure AD
-  - Okta
\ No newline at end of file
+  - Okta
diff --git a/translations/ko-KR/data/reusables/identity-and-permissions/sync-team-with-idp-group.md b/translations/ko-KR/data/reusables/identity-and-permissions/sync-team-with-idp-group.md
index ee8c761dc0c4..8cb48608dd77 100644
--- a/translations/ko-KR/data/reusables/identity-and-permissions/sync-team-with-idp-group.md
+++ b/translations/ko-KR/data/reusables/identity-and-permissions/sync-team-with-idp-group.md
@@ -1 +1 @@
-After you enable team synchronization, team maintainers and organization owners can connect a team to an IdP group on {% data variables.product.prodname_dotcom %} or through the API. For more information, see "[Synchronizing a team with an identity provider group](/github/setting-up-and-managing-organizations-and-teams/synchronizing-a-team-with-an-identity-provider-group)" and "[Team synchronization](/v3/teams/team_sync/)."
\ No newline at end of file
+After you enable team synchronization, team maintainers and organization owners can connect a team to an IdP group on {% data variables.product.prodname_dotcom %} or through the API. For more information, see "[Synchronizing a team with an identity provider group](/github/setting-up-and-managing-organizations-and-teams/synchronizing-a-team-with-an-identity-provider-group)" and "[Team synchronization](/v3/teams/team_sync/)."
diff --git a/translations/ko-KR/data/reusables/identity-and-permissions/team-sync-disable.md b/translations/ko-KR/data/reusables/identity-and-permissions/team-sync-disable.md
index e39944fc858d..bae468826d88 100644
--- a/translations/ko-KR/data/reusables/identity-and-permissions/team-sync-disable.md
+++ b/translations/ko-KR/data/reusables/identity-and-permissions/team-sync-disable.md
@@ -2,4 +2,4 @@
 
 **Warning:** When you disable team synchronization, any team members that were assigned to a {% data variables.product.prodname_dotcom %} team through the IdP group are removed from the team and may lose access to repositories.
 
-{% endwarning %}
\ No newline at end of file
+{% endwarning %}
diff --git a/translations/ko-KR/data/reusables/identity-and-permissions/team-sync-okta-requirements.md b/translations/ko-KR/data/reusables/identity-and-permissions/team-sync-okta-requirements.md
index 568b5c7cd195..f8ebbf424675 100644
--- a/translations/ko-KR/data/reusables/identity-and-permissions/team-sync-okta-requirements.md
+++ b/translations/ko-KR/data/reusables/identity-and-permissions/team-sync-okta-requirements.md
@@ -2,4 +2,4 @@ To enable team synchronization for Okta, you or your IdP administrator must:
 
 - Enable SAML SSO and SCIM for your organization using Okta. For more information, see "[Configuring SAML single sign-on and SCIM using Okta](/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta)."
 - Provide the tenant URL for your Okta instance.
-- Generate a valid SSWS token with read-only admin permissions for your Okta installation as a service user. For more information, see [Create the token](https://developer.okta.com/docs/guides/create-an-api-token/create-the-token/) and [Service users](https://help.okta.com/en/prod/Content/Topics/Adv_Server_Access/docs/service-users.htm) in Okta's documentation.
\ No newline at end of file
+- Generate a valid SSWS token with read-only admin permissions for your Okta installation as a service user. For more information, see [Create the token](https://developer.okta.com/docs/guides/create-an-api-token/create-the-token/) and [Service users](https://help.okta.com/en/prod/Content/Topics/Adv_Server_Access/docs/service-users.htm) in Okta's documentation.
diff --git a/translations/ko-KR/data/reusables/interactions/collaborator-user-limit-definition.md b/translations/ko-KR/data/reusables/interactions/collaborator-user-limit-definition.md
index 62f4c861d7f2..718a221e6f7c 100644
--- a/translations/ko-KR/data/reusables/interactions/collaborator-user-limit-definition.md
+++ b/translations/ko-KR/data/reusables/interactions/collaborator-user-limit-definition.md
@@ -1 +1 @@
-**Collaborators only:** When you limit interactions to `collaborators_only`, users who are not collaborators will be temporarily restricted
\ No newline at end of file
+**Collaborators only:** When you limit interactions to `collaborators_only`, users who are not collaborators will be temporarily restricted
diff --git a/translations/ko-KR/data/reusables/interactions/contributor-user-limit-definition.md b/translations/ko-KR/data/reusables/interactions/contributor-user-limit-definition.md
index 134e152c9ee9..e750eb466295 100644
--- a/translations/ko-KR/data/reusables/interactions/contributor-user-limit-definition.md
+++ b/translations/ko-KR/data/reusables/interactions/contributor-user-limit-definition.md
@@ -1 +1 @@
-**Contributors only:** When you limit interactions to `contributors_only`,  users who have not previously contributed and are not collaborators will be temporarily restricted
\ No newline at end of file
+**Contributors only:** When you limit interactions to `contributors_only`,  users who have not previously contributed and are not collaborators will be temporarily restricted
diff --git a/translations/ko-KR/data/reusables/interactions/existing-user-limit-definition.md b/translations/ko-KR/data/reusables/interactions/existing-user-limit-definition.md
index 54c7d8b0b5f6..b921d4455547 100644
--- a/translations/ko-KR/data/reusables/interactions/existing-user-limit-definition.md
+++ b/translations/ko-KR/data/reusables/interactions/existing-user-limit-definition.md
@@ -1 +1 @@
-**Existing users:** When you limit interactions to `existing_users`, new users with accounts less than 24 hours old who have not previously contributed and are not collaborators will be temporarily restricted
\ No newline at end of file
+**Existing users:** When you limit interactions to `existing_users`, new users with accounts less than 24 hours old who have not previously contributed and are not collaborators will be temporarily restricted
diff --git a/translations/ko-KR/data/reusables/interactions/interactions-detail.md b/translations/ko-KR/data/reusables/interactions/interactions-detail.md
index 95ef4c017e4f..9193cd04e704 100644
--- a/translations/ko-KR/data/reusables/interactions/interactions-detail.md
+++ b/translations/ko-KR/data/reusables/interactions/interactions-detail.md
@@ -1 +1 @@
-When restrictions are enabled, only the specified group of {% data variables.product.product_name %} users will be able to participate in interactions. Restrictions expire 24 hours from the time they are set.
\ No newline at end of file
+When restrictions are enabled, only the specified group of {% data variables.product.product_name %} users will be able to participate in interactions. Restrictions expire 24 hours from the time they are set.
diff --git a/translations/ko-KR/data/reusables/issue-events/assignee-properties.md b/translations/ko-KR/data/reusables/issue-events/assignee-properties.md
index e408d915e266..60f612d89caf 100644
--- a/translations/ko-KR/data/reusables/issue-events/assignee-properties.md
+++ b/translations/ko-KR/data/reusables/issue-events/assignee-properties.md
@@ -1 +1 @@
-`assignee` | `object` | The person unassigned from this issue. `assigner` | `object` | The person who performed the unassignment for this issue.
\ No newline at end of file
+`assignee` | `object` | The person unassigned from this issue. `assigner` | `object` | The person who performed the unassignment for this issue.
diff --git a/translations/ko-KR/data/reusables/issue-events/issue-event-common-properties.md b/translations/ko-KR/data/reusables/issue-events/issue-event-common-properties.md
index 98e4e95776c4..5288291a7c5d 100644
--- a/translations/ko-KR/data/reusables/issue-events/issue-event-common-properties.md
+++ b/translations/ko-KR/data/reusables/issue-events/issue-event-common-properties.md
@@ -7,4 +7,4 @@
 | `event`      | `문자열`     | Identifies the actual type of event that occurred.                   |
 | `commit_id`  | `문자열`     | The SHA of the commit that referenced this issue.                    |
 | `commit_url` | `문자열`     | The GitHub REST API link to the commit that referenced this issue.   |
-| `created_at` | `문자열`     | The timestamp indicating when the event occurred.                    |
\ No newline at end of file
+| `created_at` | `문자열`     | The timestamp indicating when the event occurred.                    |
diff --git a/translations/ko-KR/data/reusables/issue-events/label-properties.md b/translations/ko-KR/data/reusables/issue-events/label-properties.md
index 1d616889b1a1..e97ef30a880b 100644
--- a/translations/ko-KR/data/reusables/issue-events/label-properties.md
+++ b/translations/ko-KR/data/reusables/issue-events/label-properties.md
@@ -1 +1 @@
-`label` | `object` | The label removed from the issue `label[name]` | `string` | The name of the label. `label[color]` | `string` | The hex color code. 
\ No newline at end of file
+`label` | `object` | The label removed from the issue `label[name]` | `string` | The name of the label. `label[color]` | `string` | The hex color code. 
diff --git a/translations/ko-KR/data/reusables/issue-events/project-card-properties.md b/translations/ko-KR/data/reusables/issue-events/project-card-properties.md
index 646b6a85b558..457adf5eda1c 100644
--- a/translations/ko-KR/data/reusables/issue-events/project-card-properties.md
+++ b/translations/ko-KR/data/reusables/issue-events/project-card-properties.md
@@ -1 +1 @@
-`project_card` | `object` | The project card object. `project_id` | `integer` | The unique identifier of the project card. `project_url` | `string` | The REST API URL to retrieve the project card. `column_name` | `string` | The name of the column the issue is in.
\ No newline at end of file
+`project_card` | `object` | The project card object. `project_id` | `integer` | The unique identifier of the project card. `project_url` | `string` | The REST API URL to retrieve the project card. `column_name` | `string` | The name of the column the issue is in.
diff --git a/translations/ko-KR/data/reusables/issue-events/review-dismissed-properties.md b/translations/ko-KR/data/reusables/issue-events/review-dismissed-properties.md
index 9c6f67ec8671..7232cb9ea5d3 100644
--- a/translations/ko-KR/data/reusables/issue-events/review-dismissed-properties.md
+++ b/translations/ko-KR/data/reusables/issue-events/review-dismissed-properties.md
@@ -1 +1 @@
-`dismissed_review` | `object` | The information for the dismissed review. `dismissed_review[state]` | `string` | The state the pull request was in when it was dismissed. Can be one of: `commented`, `approved`, or `changes_requested`. `dismissed_review[review_id]` | `string` | The unique identifier of the pull request's review. `dismissed_review[dismissal_message]` | `string` | The message the user included when dismissing the review. `dismissed_review[dismissal_commit_id]` | `string` | The unique identifier of the commit that dismissed the review if one exists.
\ No newline at end of file
+`dismissed_review` | `object` | The information for the dismissed review. `dismissed_review[state]` | `string` | The state the pull request was in when it was dismissed. Can be one of: `commented`, `approved`, or `changes_requested`. `dismissed_review[review_id]` | `string` | The unique identifier of the pull request's review. `dismissed_review[dismissal_message]` | `string` | The message the user included when dismissing the review. `dismissed_review[dismissal_commit_id]` | `string` | The unique identifier of the commit that dismissed the review if one exists.
diff --git a/translations/ko-KR/data/reusables/issue-events/review-request-properties.md b/translations/ko-KR/data/reusables/issue-events/review-request-properties.md
index 350f0d3ff9dd..8821c8b69e8e 100644
--- a/translations/ko-KR/data/reusables/issue-events/review-request-properties.md
+++ b/translations/ko-KR/data/reusables/issue-events/review-request-properties.md
@@ -1 +1 @@
-`requested_reviewer` | `object` | The person requested to review the pull request. `review_requester` | `object` | The person who requested a review.
\ No newline at end of file
+`requested_reviewer` | `object` | The person requested to review the pull request. `review_requester` | `object` | The person who requested a review.
diff --git a/translations/ko-KR/data/reusables/issue-events/timeline_events_object_properties.md b/translations/ko-KR/data/reusables/issue-events/timeline_events_object_properties.md
index 43c03587e7df..c7877fcb46cb 100644
--- a/translations/ko-KR/data/reusables/issue-events/timeline_events_object_properties.md
+++ b/translations/ko-KR/data/reusables/issue-events/timeline_events_object_properties.md
@@ -1 +1 @@
-This events properties do not use the same structure as the [issue event object common properties](#issue-event-object-common-properties). The following properties are returned for this event.
\ No newline at end of file
+This events properties do not use the same structure as the [issue event object common properties](#issue-event-object-common-properties). The following properties are returned for this event.
diff --git a/translations/ko-KR/data/reusables/large_files/can-include-lfs-objects-archives.md b/translations/ko-KR/data/reusables/large_files/can-include-lfs-objects-archives.md
index f0f75e6ec5de..83a7278c3796 100644
--- a/translations/ko-KR/data/reusables/large_files/can-include-lfs-objects-archives.md
+++ b/translations/ko-KR/data/reusables/large_files/can-include-lfs-objects-archives.md
@@ -2,4 +2,4 @@
 
 You can choose whether {% data variables.large_files.product_name_long %}({% data variables.large_files.product_name_short %}) objects are included in source code archives, such as ZIP files and tarballs, that {% data variables.product.product_name %} creates for your repository. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)."
 
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/translations/ko-KR/data/reusables/marketplace/cancellation-clarification.md b/translations/ko-KR/data/reusables/marketplace/cancellation-clarification.md
index f4463ad23d57..80e164b90d61 100644
--- a/translations/ko-KR/data/reusables/marketplace/cancellation-clarification.md
+++ b/translations/ko-KR/data/reusables/marketplace/cancellation-clarification.md
@@ -1 +1 @@
-When a customer cancels a {% data variables.product.prodname_marketplace %} subscription, GitHub does not automatically uninstall the app, so the customer can expect that free features will continue to function.
\ No newline at end of file
+When a customer cancels a {% data variables.product.prodname_marketplace %} subscription, GitHub does not automatically uninstall the app, so the customer can expect that free features will continue to function.
diff --git a/translations/ko-KR/data/reusables/marketplace/github_apps_preferred.md b/translations/ko-KR/data/reusables/marketplace/github_apps_preferred.md
index 04c37a99c9c5..c9ccbece0da2 100644
--- a/translations/ko-KR/data/reusables/marketplace/github_apps_preferred.md
+++ b/translations/ko-KR/data/reusables/marketplace/github_apps_preferred.md
@@ -1 +1 @@
-GitHub Apps are the officially recommended way to integrate with GitHub because they offer much more granular permissions to access data
\ No newline at end of file
+GitHub Apps are the officially recommended way to integrate with GitHub because they offer much more granular permissions to access data
diff --git a/translations/ko-KR/data/reusables/marketplace/launch-with-free.md b/translations/ko-KR/data/reusables/marketplace/launch-with-free.md
index b809c37a0e6a..15230e218b5e 100644
--- a/translations/ko-KR/data/reusables/marketplace/launch-with-free.md
+++ b/translations/ko-KR/data/reusables/marketplace/launch-with-free.md
@@ -1 +1 @@
-You can submit both an unverified and verified app. This will allow you to launch with a free version of your app. Once GitHub verifies your app, your listing will change from unverified to verified in {% data variables.product.prodname_marketplace %} and GitHub will publish your new pricing plans.
\ No newline at end of file
+You can submit both an unverified and verified app. This will allow you to launch with a free version of your app. Once GitHub verifies your app, your listing will change from unverified to verified in {% data variables.product.prodname_marketplace %} and GitHub will publish your new pricing plans.
diff --git a/translations/ko-KR/data/reusables/marketplace/unverified-apps.md b/translations/ko-KR/data/reusables/marketplace/unverified-apps.md
index d390a5e5eaf0..b7ce68277e1c 100644
--- a/translations/ko-KR/data/reusables/marketplace/unverified-apps.md
+++ b/translations/ko-KR/data/reusables/marketplace/unverified-apps.md
@@ -1 +1 @@
-Unverified apps are only offered with free plans. To list paid plans, you must submit a verified app.
\ No newline at end of file
+Unverified apps are only offered with free plans. To list paid plans, you must submit a verified app.
diff --git a/translations/ko-KR/data/reusables/notifications-v2/email-notification-caveats.md b/translations/ko-KR/data/reusables/notifications-v2/email-notification-caveats.md
index cc76d1bbe203..d300a357a9bb 100644
--- a/translations/ko-KR/data/reusables/notifications-v2/email-notification-caveats.md
+++ b/translations/ko-KR/data/reusables/notifications-v2/email-notification-caveats.md
@@ -2,4 +2,4 @@ You'll only receive notification emails if you've chosen to receive email notifi
 
 {% if currentVersion == "free-pro-team@latest" %}
 {% data reusables.user_settings.verify-org-approved-email-domain %}
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/translations/ko-KR/data/reusables/notifications-v2/manage-notifications.md b/translations/ko-KR/data/reusables/notifications-v2/manage-notifications.md
index 6bb2edb8ac82..e799c77a8a40 100644
--- a/translations/ko-KR/data/reusables/notifications-v2/manage-notifications.md
+++ b/translations/ko-KR/data/reusables/notifications-v2/manage-notifications.md
@@ -1 +1 @@
-1. In the left sidebar, under the list of repositories, use the "Manage notifications" drop-down to click **Notification settings**. ![Manage notifications drop down menu options](/assets/images/help/notifications-v2/manage-notifications-options.png)
\ No newline at end of file
+1. In the left sidebar, under the list of repositories, use the "Manage notifications" drop-down to click **Notification settings**. ![Manage notifications drop down menu options](/assets/images/help/notifications-v2/manage-notifications-options.png)
diff --git a/translations/ko-KR/data/reusables/organizations/can-require-ssh-cert.md b/translations/ko-KR/data/reusables/organizations/can-require-ssh-cert.md
index 21761d2048af..6da37763232e 100644
--- a/translations/ko-KR/data/reusables/organizations/can-require-ssh-cert.md
+++ b/translations/ko-KR/data/reusables/organizations/can-require-ssh-cert.md
@@ -1 +1 @@
-You can require that members use SSH certificates to access organization resources,{% if currentVersion ver_gt "enterprise-server@2.17" %}, unless SSH is disabled in your repository{% endif %}.
+You can require that members use SSH certificates to access organization resources,, unless SSH is disabled in your repository.
diff --git a/translations/ko-KR/data/reusables/organizations/organization-name.md b/translations/ko-KR/data/reusables/organizations/organization-name.md
index ccb829ffdb7b..bfab26cffa04 100644
--- a/translations/ko-KR/data/reusables/organizations/organization-name.md
+++ b/translations/ko-KR/data/reusables/organizations/organization-name.md
@@ -1 +1 @@
-1. Under "Organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} account{% endif %} name", type a name for your organization account. ![Field to type an organization name](/assets/images/help/organizations/new-org-name.png)
+1. Under "Organization account name", type a name for your organization account. ![Field to type an organization name](/assets/images/help/organizations/new-org-name.png)
diff --git a/translations/ko-KR/data/reusables/organizations/repository-labels.md b/translations/ko-KR/data/reusables/organizations/repository-labels.md
index 6b5d2097ead1..00425e2fb920 100644
--- a/translations/ko-KR/data/reusables/organizations/repository-labels.md
+++ b/translations/ko-KR/data/reusables/organizations/repository-labels.md
@@ -1 +1 @@
-1. In the left sidebar, click **Repository labels**. ![Repository labels tab](/assets/images/help/organizations/repo-labels-tab.png)
\ No newline at end of file
+1. In the left sidebar, click **Repository labels**. ![Repository labels tab](/assets/images/help/organizations/repo-labels-tab.png)
diff --git a/translations/ko-KR/data/reusables/package_registry/admins-can-configure-package-types.md b/translations/ko-KR/data/reusables/package_registry/admins-can-configure-package-types.md
index 82369c5e4a37..efe344932d49 100644
--- a/translations/ko-KR/data/reusables/package_registry/admins-can-configure-package-types.md
+++ b/translations/ko-KR/data/reusables/package_registry/admins-can-configure-package-types.md
@@ -4,4 +4,4 @@
 **Note:** This package type may not be available for your instance, because site administrators can enable or disable each supported package type. For more information, see "[Configuring packages support for your enterprise](/enterprise/admin/packages/configuring-packages-support-for-your-enterprise)."
 
 {% endnote %}
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/translations/ko-KR/data/reusables/package_registry/authenticate-packages.md b/translations/ko-KR/data/reusables/package_registry/authenticate-packages.md
index 11de4d874fa7..89915a62e856 100644
--- a/translations/ko-KR/data/reusables/package_registry/authenticate-packages.md
+++ b/translations/ko-KR/data/reusables/package_registry/authenticate-packages.md
@@ -1,9 +1,11 @@
 You need an access token to publish, install, and delete packages. You can use a personal access token to authenticate with your username directly to {% data variables.product.prodname_registry %} or the {% data variables.product.prodname_dotcom %} API. When you create a personal access token, you can assign the token different scopes depending on your needs.
 
 {% if currentVersion == "free-pro-team@latest" %}
-To authenticate using a {% data variables.product.prodname_actions %} workflow:
+To authenticate using a
+{% data variables.product.prodname_actions %} workflow:
 - For package registries (`PACKAGE-REGISTRY.pkg.github.com/OWNER/REPOSITORY/IMAGE-NAME`), you can use a `GITHUB_TOKEN`.
 - For the container registry (`ghcr.io/OWNER/IMAGE-NAME`), you must use a personal access token.
 {% else %}
-To authenticate to {% data variables.product.prodname_registry %} using a {% data variables.product.prodname_actions %} workflow, you must use `GITHUB_TOKEN`.
+To authenticate to
+{% data variables.product.prodname_registry %} using a {% data variables.product.prodname_actions %} workflow, you must use `GITHUB_TOKEN`.
 {% endif %}
diff --git a/translations/ko-KR/data/reusables/package_registry/authenticate-to-container-registry-steps.md b/translations/ko-KR/data/reusables/package_registry/authenticate-to-container-registry-steps.md
new file mode 100644
index 000000000000..d502dc5ee999
--- /dev/null
+++ b/translations/ko-KR/data/reusables/package_registry/authenticate-to-container-registry-steps.md
@@ -0,0 +1,25 @@
+1. Create a new personal access token (PAT) with the appropriate scopes for the tasks you want to accomplish. If your organization requires SSO, you must enable SSO for your new token.
+  {% warning %}
+
+  **Note:** If you select the `write:packages` scope, deselect the `repo` scope when creating the PAT. Adding a PAT with the `repo` scope as a secret in your repository allows the credential to be accessible to all collaborators in the repository. This gives unnecessary additional access when a PAT with the `repo` scope is used within an action. For more information on security best practices for actions, see "[Security hardening for GitHub Actions](/actions/getting-started-with-github-actions/security-hardening-for-github-actions#considering-cross-repository-access)."
+
+  {% endwarning %}
+
+    - Select the `read:packages` scope to download container images and read their metadata.
+    - Select the `write:packages` scope to download and upload container images and read and write their metadata.
+    - Select the `delete:packages` scope to delete container images.
+
+  For more information, see "[Creating a personal access token for the command line](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)."
+
+2. Save your PAT. We recommend saving your PAT as an environment variable.
+  ```shell
+  $ export CR_PAT=YOUR_TOKEN
+  ```
+3. Using the CLI for your container type, sign in to the
+{% data variables.product.prodname_github_container_registry %} service at `ghcr.io`.
+  {% raw %}
+  ```shell
+  $ echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin
+  > Login Succeeded
+  ```
+  {% endraw %}
diff --git a/translations/ko-KR/data/reusables/package_registry/authenticate_with_pat_for_container_registry.md b/translations/ko-KR/data/reusables/package_registry/authenticate_with_pat_for_container_registry.md
new file mode 100644
index 000000000000..7a08298672be
--- /dev/null
+++ b/translations/ko-KR/data/reusables/package_registry/authenticate_with_pat_for_container_registry.md
@@ -0,0 +1,9 @@
+{% if currentVersion == "free-pro-team@latest" %}
+If you want to authenticate to
+{% data variables.product.prodname_github_container_registry %} in a {% data variables.product.prodname_actions %} workflow, then you must use a personal access token (PAT). The `GITHUB_TOKEN` does not currently have the required permissions. During the {% data variables.product.prodname_github_container_registry %} beta, the only supported form of authentication is the PAT.
+
+PATs can grant broad access to your account. We recommend selecting only the necessary read, write, or delete `package` scope when creating a PAT to authenticate to the {% data variables.product.prodname_container_registry %}. Avoid including the `repo` scope in a PAT used by a GitHub Actions workflow because it gives unnecessary additional access.
+
+If you'd like to use the {% data variables.product.prodname_container_registry %} in actions during the beta, follow our security best practices for PAT use at "[Security hardening for GitHub Actions](/actions/getting-started-with-github-actions/security-hardening-for-github-actions#considering-cross-repository-access)."
+
+{% endif %}
diff --git a/translations/ko-KR/data/reusables/package_registry/docker_registry_deprecation_status.md b/translations/ko-KR/data/reusables/package_registry/docker_registry_deprecation_status.md
new file mode 100644
index 000000000000..79e9650f348f
--- /dev/null
+++ b/translations/ko-KR/data/reusables/package_registry/docker_registry_deprecation_status.md
@@ -0,0 +1,5 @@
+{% warning %}
+
+**Note:** The {% data variables.product.prodname_registry %} Docker registry will be superseded by {% data variables.product.prodname_github_container_registry %}{% if currentVersion != "free-pro-team@latest" %} in a future {% data variables.product.product_name %} release{% endif %}.{% if currentVersion == "free-pro-team@latest" %} To learn how to migrate your existing Docker images and any workflows using them, see "[Migrating to {% data variables.product.prodname_github_container_registry %} for Docker images](/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images)" and "[Getting started with {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry)."{% endif %}
+
+{% endwarning %}
diff --git a/translations/ko-KR/data/reusables/package_registry/package-immutability.md b/translations/ko-KR/data/reusables/package_registry/package-immutability.md
index e01c7c9f365c..b681b521909d 100644
--- a/translations/ko-KR/data/reusables/package_registry/package-immutability.md
+++ b/translations/ko-KR/data/reusables/package_registry/package-immutability.md
@@ -1,3 +1,5 @@
-To prevent confusion and build problems, {% data variables.product.prodname_dotcom %} permanently reserves a package's name and version number. Even if an entire package is deleted, you cannot reuse the deleted package name in any repository owned by the same account.
+**Public packages:** To prevent confusion and build problems, {% data variables.product.prodname_dotcom %} permanently reserves a package's name and version number. Even if an entire package is deleted, you cannot reuse the deleted package name in any repository owned by the same account.
+
+**Private packages:** If all versions of a private package are deleted, you can publish a package with a previously used name and version.
 
 To revise or replace a package version, we recommend you publish a new version of your package.
diff --git a/translations/ko-KR/data/reusables/pages/best-with-supported-themes.md b/translations/ko-KR/data/reusables/pages/best-with-supported-themes.md
index 50539af8e7eb..5472ce28f5ae 100644
--- a/translations/ko-KR/data/reusables/pages/best-with-supported-themes.md
+++ b/translations/ko-KR/data/reusables/pages/best-with-supported-themes.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-These instructions work best with themes that are officially supported by {% data variables.product.prodname_pages %}. For a complete list of supported themes, see "[Supported themes](https://pages.github.com/themes/)" on the {% data variables.product.prodname_pages %} site.
+These instructions work best with themes that are officially supported by
+{% data variables.product.prodname_pages %}. For a complete list of supported themes, see "[Supported themes](https://pages.github.com/themes/)" on the {% data variables.product.prodname_pages %} site.
 {% endif %}
diff --git a/translations/ko-KR/data/reusables/pre-release-program/machine-man-preview.md b/translations/ko-KR/data/reusables/pre-release-program/machine-man-preview.md
index 8fb50254cd1f..bdcee03dec6f 100644
--- a/translations/ko-KR/data/reusables/pre-release-program/machine-man-preview.md
+++ b/translations/ko-KR/data/reusables/pre-release-program/machine-man-preview.md
@@ -6,4 +6,4 @@
 `application/vnd.github.machine-man-preview+json`
 
 {% endnote %}
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/translations/ko-KR/data/reusables/pre-release-program/suspend-installation-beta.md b/translations/ko-KR/data/reusables/pre-release-program/suspend-installation-beta.md
index 3d81271d74ca..ae027690926d 100644
--- a/translations/ko-KR/data/reusables/pre-release-program/suspend-installation-beta.md
+++ b/translations/ko-KR/data/reusables/pre-release-program/suspend-installation-beta.md
@@ -1,4 +1,5 @@
 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}
-Suspending a {% data variables.product.prodname_github_app %} installation is currently in beta and subject to change. Before you can suspend a {% data variables.product.prodname_github_app %}, the app owner must enable suspending installations for the app by opting-in to the beta. To opt-in to the suspending installations beta feature, see "[Activating beta features for apps](/developers/apps/activating-beta-features-for-apps)."
+Suspending a
+{% data variables.product.prodname_github_app %} installation is currently in beta and subject to change. Before you can suspend a {% data variables.product.prodname_github_app %}, the app owner must enable suspending installations for the app by opting-in to the beta. To opt-in to the suspending installations beta feature, see "[Activating beta features for apps](/developers/apps/activating-beta-features-for-apps)."
 
 {% endif %}
diff --git a/translations/ko-KR/data/reusables/profile/profile-readme.md b/translations/ko-KR/data/reusables/profile/profile-readme.md
index 6c734861db2e..a19a3d4a30d3 100644
--- a/translations/ko-KR/data/reusables/profile/profile-readme.md
+++ b/translations/ko-KR/data/reusables/profile/profile-readme.md
@@ -1 +1 @@
-If you add a README file to the root of a public repository with the same name as your username, that README will automatically appear on your profile page. You can edit your profile README with GitHub Flavored Markdown to create a personalized section on your profile.
\ No newline at end of file
+If you add a README file to the root of a public repository with the same name as your username, that README will automatically appear on your profile page. You can edit your profile README with GitHub Flavored Markdown to create a personalized section on your profile.
diff --git a/translations/ko-KR/data/reusables/project-management/link-repos-to-project-board.md b/translations/ko-KR/data/reusables/project-management/link-repos-to-project-board.md
index d2688ed1fd4d..0a72db53b6c4 100644
--- a/translations/ko-KR/data/reusables/project-management/link-repos-to-project-board.md
+++ b/translations/ko-KR/data/reusables/project-management/link-repos-to-project-board.md
@@ -1 +1 @@
-You can link up to twenty-five repositories to your organization or user-owned project board. Linking repositories makes it easier to add issues and pull requests from those repositories to your project board using **{% octicon "plus" aria-label="The Plus icon" %} Add cards**{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} or from the issue or pull requests sidebar{% endif %}.
+You can link up to twenty-five repositories to your organization or user-owned project board. Linking repositories makes it easier to add issues and pull requests from those repositories to your project board using **{% octicon "plus" aria-label="The Plus icon" %} Add cards** or from the issue or pull requests sidebar.
diff --git a/translations/ko-KR/data/reusables/project-management/project-board-import-with-api.md b/translations/ko-KR/data/reusables/project-management/project-board-import-with-api.md
index ac8b4cdcdfc6..ba15893fea96 100644
--- a/translations/ko-KR/data/reusables/project-management/project-board-import-with-api.md
+++ b/translations/ko-KR/data/reusables/project-management/project-board-import-with-api.md
@@ -1 +1 @@
-You can use {% data variables.product.prodname_dotcom %}'s API to import a project board. For more information, see "[importProject](/v4/mutation/importproject/)."
+You can use {% data variables.product.prodname_dotcom %}'s API to import a project board. For more information, see "[importProject](/graphql/reference/mutations#importproject/)."
diff --git a/translations/ko-KR/data/reusables/projects/disabled-projects.md b/translations/ko-KR/data/reusables/projects/disabled-projects.md
index 2b10747e7e27..9f6e391db7fe 100644
--- a/translations/ko-KR/data/reusables/projects/disabled-projects.md
+++ b/translations/ko-KR/data/reusables/projects/disabled-projects.md
@@ -1 +1 @@
-You only see this event in responses when project boards have been [enabled](/articles/disabling-project-boards-in-a-repository) in the repository.
\ No newline at end of file
+You only see this event in responses when project boards have been [enabled](/articles/disabling-project-boards-in-a-repository) in the repository.
diff --git a/translations/ko-KR/data/reusables/pull_requests/automatically-delete-branches.md b/translations/ko-KR/data/reusables/pull_requests/automatically-delete-branches.md
index 8bfa120f341f..6f603ccb3b40 100644
--- a/translations/ko-KR/data/reusables/pull_requests/automatically-delete-branches.md
+++ b/translations/ko-KR/data/reusables/pull_requests/automatically-delete-branches.md
@@ -1,3 +1 @@
-{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}
 You can have head branches automatically deleted after pull requests are merged in your repository. For more information, see "[Managing the automatic deletion of branches](/articles/managing-the-automatic-deletion-of-branches)."
-{% endif %}
diff --git a/translations/ko-KR/data/reusables/pull_requests/default-commit-message-squash-merge.md b/translations/ko-KR/data/reusables/pull_requests/default-commit-message-squash-merge.md
index 4d1056d48adb..a5aa547d0c05 100644
--- a/translations/ko-KR/data/reusables/pull_requests/default-commit-message-squash-merge.md
+++ b/translations/ko-KR/data/reusables/pull_requests/default-commit-message-squash-merge.md
@@ -1 +1 @@
-For information about the default commit messages for squash merges, see "[About pull request merges](/github/collaborating-with-issues-and-pull-requests/about-pull-request-merges#merge-message-for-a-squash-merge)."
\ No newline at end of file
+For information about the default commit messages for squash merges, see "[About pull request merges](/github/collaborating-with-issues-and-pull-requests/about-pull-request-merges#merge-message-for-a-squash-merge)."
diff --git a/translations/ko-KR/data/reusables/pull_requests/mark-ready-review.md b/translations/ko-KR/data/reusables/pull_requests/mark-ready-review.md
index e06162167878..eb6b7139589d 100644
--- a/translations/ko-KR/data/reusables/pull_requests/mark-ready-review.md
+++ b/translations/ko-KR/data/reusables/pull_requests/mark-ready-review.md
@@ -1 +1 @@
-When you're ready to get feedback on your pull request, you can mark your draft pull request as ready for review. Marking a pull request as ready for review will request reviews from any code owners.
\ No newline at end of file
+When you're ready to get feedback on your pull request, you can mark your draft pull request as ready for review. Marking a pull request as ready for review will request reviews from any code owners.
diff --git a/translations/ko-KR/data/reusables/reminders/author-reviews.md b/translations/ko-KR/data/reusables/reminders/author-reviews.md
index f800bd1be4b0..51124a351886 100644
--- a/translations/ko-KR/data/reusables/reminders/author-reviews.md
+++ b/translations/ko-KR/data/reusables/reminders/author-reviews.md
@@ -1 +1 @@
-1. Optionally, to send reminders to the pull request authors after the review requests have been fulfilled, select **Remind authors after reviews** and choose the number of reviews required before a reminder is sent. ![Remind authors after reviews checkbox](/assets/images/help/settings/scheduled-reminders-remind-authors.png)
\ No newline at end of file
+1. Optionally, to send reminders to the pull request authors after the review requests have been fulfilled, select **Remind authors after reviews** and choose the number of reviews required before a reminder is sent. ![Remind authors after reviews checkbox](/assets/images/help/settings/scheduled-reminders-remind-authors.png)
diff --git a/translations/ko-KR/data/reusables/reminders/ignored-labels.md b/translations/ko-KR/data/reusables/reminders/ignored-labels.md
index a34db3d8436d..55f45c54110d 100644
--- a/translations/ko-KR/data/reusables/reminders/ignored-labels.md
+++ b/translations/ko-KR/data/reusables/reminders/ignored-labels.md
@@ -1 +1 @@
-1. Under "Ignored labels", type a comma-separated list of labels. Scheduled reminders won't include any pull requests that have one or more of these labels. ![Ignored labels field](/assets/images/help/settings/scheduled-reminders-ignored-labels-field.png)
\ No newline at end of file
+1. Under "Ignored labels", type a comma-separated list of labels. Scheduled reminders won't include any pull requests that have one or more of these labels. ![Ignored labels field](/assets/images/help/settings/scheduled-reminders-ignored-labels-field.png)
diff --git a/translations/ko-KR/data/reusables/reminders/ignored-terms.md b/translations/ko-KR/data/reusables/reminders/ignored-terms.md
index ce68dfe48045..d137ef587b1f 100644
--- a/translations/ko-KR/data/reusables/reminders/ignored-terms.md
+++ b/translations/ko-KR/data/reusables/reminders/ignored-terms.md
@@ -1 +1 @@
-1. Under "Ignored terms", type a comma-separated list of terms that may appear in titles of pull requests. Scheduled reminders won't include any pull requests that contain one or more of these terms in their titles. ![Ignored terms field](/assets/images/help/settings/scheduled-reminders-ignored-terms-field.png)
\ No newline at end of file
+1. Under "Ignored terms", type a comma-separated list of terms that may appear in titles of pull requests. Scheduled reminders won't include any pull requests that contain one or more of these terms in their titles. ![Ignored terms field](/assets/images/help/settings/scheduled-reminders-ignored-terms-field.png)
diff --git a/translations/ko-KR/data/reusables/reminders/min-age.md b/translations/ko-KR/data/reusables/reminders/min-age.md
index 5ad2ca5a0b03..4238297768f8 100644
--- a/translations/ko-KR/data/reusables/reminders/min-age.md
+++ b/translations/ko-KR/data/reusables/reminders/min-age.md
@@ -1 +1 @@
-1. Under "Minimum age", type the age of a pull request, in hours. Scheduled reminders won't include pull requests that are newer than this age limit. ![Ignored labels field](/assets/images/help/settings/scheduled-reminders-min-age-field.png)
\ No newline at end of file
+1. Under "Minimum age", type the age of a pull request, in hours. Scheduled reminders won't include pull requests that are newer than this age limit. ![Ignored labels field](/assets/images/help/settings/scheduled-reminders-min-age-field.png)
diff --git a/translations/ko-KR/data/reusables/reminders/min-staleness.md b/translations/ko-KR/data/reusables/reminders/min-staleness.md
index 14a98d4461d2..766d15b7715f 100644
--- a/translations/ko-KR/data/reusables/reminders/min-staleness.md
+++ b/translations/ko-KR/data/reusables/reminders/min-staleness.md
@@ -1 +1 @@
-1. Under "Minimum staleness", type the time since the last activity on a pull request, in hours. Scheduled reminders won't include pull requests whose last activity was more recent than this time. ![Minimum staleness field](/assets/images/help/settings/scheduled-reminders-min-staleness-field.png)
\ No newline at end of file
+1. Under "Minimum staleness", type the time since the last activity on a pull request, in hours. Scheduled reminders won't include pull requests whose last activity was more recent than this time. ![Minimum staleness field](/assets/images/help/settings/scheduled-reminders-min-staleness-field.png)
diff --git a/translations/ko-KR/data/reusables/reminders/real-time-alerts.md b/translations/ko-KR/data/reusables/reminders/real-time-alerts.md
index 6146a5751871..6c32bd6f0817 100644
--- a/translations/ko-KR/data/reusables/reminders/real-time-alerts.md
+++ b/translations/ko-KR/data/reusables/reminders/real-time-alerts.md
@@ -1 +1 @@
-1. Optionally, to receive Slack messages as soon as certain events happen, select **Enable real-time alerts** and select the events to receive real-time alerts for.
\ No newline at end of file
+1. Optionally, to receive Slack messages as soon as certain events happen, select **Enable real-time alerts** and select the events to receive real-time alerts for.
diff --git a/translations/ko-KR/data/reusables/reminders/required-labels.md b/translations/ko-KR/data/reusables/reminders/required-labels.md
index fa8a91cdafe6..b8729c3f84b8 100644
--- a/translations/ko-KR/data/reusables/reminders/required-labels.md
+++ b/translations/ko-KR/data/reusables/reminders/required-labels.md
@@ -1 +1 @@
-1. Under "Required labels", type a comma-separated list of labels. Scheduled reminders will only include pull requests that haven't already been ignored, if they have one or more of these labels. ![Required labels field](/assets/images/help/settings/scheduled-reminders-required-labels-field.png)
\ No newline at end of file
+1. Under "Required labels", type a comma-separated list of labels. Scheduled reminders will only include pull requests that haven't already been ignored, if they have one or more of these labels. ![Required labels field](/assets/images/help/settings/scheduled-reminders-required-labels-field.png)
diff --git a/translations/ko-KR/data/reusables/repositories/about-github-archive-program.md b/translations/ko-KR/data/reusables/repositories/about-github-archive-program.md
index fddb4eb43e15..36deb76d9e3b 100644
--- a/translations/ko-KR/data/reusables/repositories/about-github-archive-program.md
+++ b/translations/ko-KR/data/reusables/repositories/about-github-archive-program.md
@@ -1 +1 @@
-By default, all public repositories are included in the {% data variables.product.prodname_archive %}, a partnership between {% data variables.product.prodname_dotcom %} and organizations such as Software Heritage Foundation and Internet Archive to ensure the long-term preservation of the world's open source software.
\ No newline at end of file
+By default, all public repositories are included in the {% data variables.product.prodname_archive %}, a partnership between {% data variables.product.prodname_dotcom %} and organizations such as Software Heritage Foundation and Internet Archive to ensure the long-term preservation of the world's open source software.
diff --git a/translations/ko-KR/data/reusables/repositories/actions-workflow-status-badge-into.md b/translations/ko-KR/data/reusables/repositories/actions-workflow-status-badge-into.md
index cfaa51ac6d5c..cdbec71bed65 100644
--- a/translations/ko-KR/data/reusables/repositories/actions-workflow-status-badge-into.md
+++ b/translations/ko-KR/data/reusables/repositories/actions-workflow-status-badge-into.md
@@ -1,3 +1,3 @@
-Status badges show whether a workflow is currently failing or passing. A common place to add a status badge is in the README.md file of your repository, but you can add it to any web page you'd like. By default, badges display the status of your default branch. You can also display the status of a workflow run for a specific branch or event using the `branch` and `event` query parameters in the URL.
+A status badge shows whether a workflow is currently failing or passing. A common place to add a status badge is in the README.md file of your repository, but you can add it to any web page you'd like. By default, badges display the status of your default branch. You can also display the status of a workflow run for a specific branch or event using the `branch` and `event` query parameters in the URL.
 
 ![example status badge](/assets/images/help/repository/actions-workflow-status-badge.png)
diff --git a/translations/ko-KR/data/reusables/repositories/blocked-passwords.md b/translations/ko-KR/data/reusables/repositories/blocked-passwords.md
index ca8a2fe11312..6ab492cfc3e8 100644
--- a/translations/ko-KR/data/reusables/repositories/blocked-passwords.md
+++ b/translations/ko-KR/data/reusables/repositories/blocked-passwords.md
@@ -1,5 +1,6 @@
 {% if currentVersion == "free-pro-team@latest" %}
-When you type a password to sign in, create an account, or change your password, {% data variables.product.product_name %} will check if the password you entered is considered weak according to datasets like HaveIBeenPwned. The password may be identified as weak even if you have never used that password before.
+When you type a password to sign in, create an account, or change your password,
+{% data variables.product.product_name %} will check if the password you entered is considered weak according to datasets like HaveIBeenPwned. The password may be identified as weak even if you have never used that password before.
 
 {% data variables.product.product_name %} only inspects the password at the time you type it, and never stores the password you entered in plaintext. For more information, see [HaveIBeenPwned](https://haveibeenpwned.com/).
 {% endif %}
diff --git a/translations/ko-KR/data/reusables/repositories/copy-clone-url.md b/translations/ko-KR/data/reusables/repositories/copy-clone-url.md
index 4bff6a43e23f..2f24104d3ca8 100644
--- a/translations/ko-KR/data/reusables/repositories/copy-clone-url.md
+++ b/translations/ko-KR/data/reusables/repositories/copy-clone-url.md
@@ -2,13 +2,13 @@
 1. Under the repository name, click **Clone or download**. ![Clone or download button](/assets/images/help/repository/clone-repo-clone-url-button.png)
 2. To clone the repository using HTTPS, under "Clone with HTTPS", click
 {% octicon "clippy" aria-label="The clipboard icon" %}.
-To clone the repository using an SSH key
-{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, including a certificate issued by your organization's SSH certificate authority,{% endif %} click **Use SSH**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.
+To clone the repository using an SSH key, including a certificate issued by your organization's SSH certificate authority, click **Use SSH**, then click
+{% octicon "clippy" aria-label="The clipboard icon" %}.
 ![Clone URL button](/assets/images/help/repository/https-url-clone.png)
 {% else %}
 1. Above the list of files, click {% octicon "download" aria-label="The download icon" %} **Code**. !["Code" button](/assets/images/help/repository/code-button.png)
 1. To clone the repository using HTTPS, under "Clone with HTTPS", click
-{% octicon "clippy" aria-label="The clipboard icon" %}. To clone the repository using an SSH key{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, including a certificate issued by your organization's SSH certificate authority,{% endif %} click **Use SSH**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} To clone a repository using {% data variables.product.prodname_cli %}, click **Use {% data variables.product.prodname_cli %}**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.{% endif %}
+{% octicon "clippy" aria-label="The clipboard icon" %}. To clone the repository using an SSH key, including a certificate issued by your organization's SSH certificate authority, click **Use SSH**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} To clone a repository using {% data variables.product.prodname_cli %}, click **Use {% data variables.product.prodname_cli %}**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.{% endif %}
   ![The clipboard icon for copying the URL to clone a repository](/assets/images/help/repository/https-url-clone.png)
   {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}
   ![The clipboard icon for copying the URL to clone a repository with GitHub CLI](/assets/images/help/repository/https-url-clone-cli.png){% endif %}
diff --git a/translations/ko-KR/data/reusables/repositories/navigate-to-job-superlinter.md b/translations/ko-KR/data/reusables/repositories/navigate-to-job-superlinter.md
new file mode 100644
index 000000000000..3c79e1a1a6ab
--- /dev/null
+++ b/translations/ko-KR/data/reusables/repositories/navigate-to-job-superlinter.md
@@ -0,0 +1,5 @@
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+1. In the left sidebar, click the job you want to see. ![Lint code base job](/assets/images/help/repository/superlinter-lint-code-base-job.png)
+{% else %}
+1. In the left sidebar, click the job you want to see. ![Select a workflow job](/assets/images/help/repository/workflow-job.png)
+{% endif %}
\ No newline at end of file
diff --git a/translations/ko-KR/data/reusables/repositories/navigate-to-workflow-superlinter.md b/translations/ko-KR/data/reusables/repositories/navigate-to-workflow-superlinter.md
new file mode 100644
index 000000000000..f09a3b0ae1cb
--- /dev/null
+++ b/translations/ko-KR/data/reusables/repositories/navigate-to-workflow-superlinter.md
@@ -0,0 +1 @@
+1. In the left sidebar, click the workflow you want to see. ![Workflow list in left sidebar](/assets/images/help/repository/superlinter-workflow-sidebar.png)
\ No newline at end of file
diff --git a/translations/ko-KR/data/reusables/repositories/open-with-github-desktop.md b/translations/ko-KR/data/reusables/repositories/open-with-github-desktop.md
index 9d01c2c2d0e8..175929214321 100644
--- a/translations/ko-KR/data/reusables/repositories/open-with-github-desktop.md
+++ b/translations/ko-KR/data/reusables/repositories/open-with-github-desktop.md
@@ -1,6 +1,8 @@
 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %}
 1. Under your repository name, click **Clone or download**. ![Clone or download button](/assets/images/help/repository/clone-repo-clone-url-button.png)
-1. Click **Open in Desktop** to clone the repository and open it in {% data variables.product.prodname_desktop %}. ![Open in Desktop button](/assets/images/help/desktop/open-in-desktop-button.png)
+1. Click **Open in Desktop** to clone the repository and open it in
+{% data variables.product.prodname_desktop %}.
+![Open in Desktop button](/assets/images/help/desktop/open-in-desktop-button.png)
 {% else %}
 1. Above the list of files, click {% octicon "download" aria-label="The download icon" %} **Code**. !["Code" button](/assets/images/help/repository/code-button.png)
 1. Click
diff --git a/translations/ko-KR/data/reusables/repositories/permissions-statement-read.md b/translations/ko-KR/data/reusables/repositories/permissions-statement-read.md
index 9e957151da58..241fdd2ba86a 100644
--- a/translations/ko-KR/data/reusables/repositories/permissions-statement-read.md
+++ b/translations/ko-KR/data/reusables/repositories/permissions-statement-read.md
@@ -1 +1 @@
-People with read access to the repository can perform these steps.
\ No newline at end of file
+Read access to the repository is required to perform these steps.
diff --git a/translations/ko-KR/data/reusables/repositories/permissions-statement-write.md b/translations/ko-KR/data/reusables/repositories/permissions-statement-write.md
index 4c6e9310a6af..457fe0472478 100644
--- a/translations/ko-KR/data/reusables/repositories/permissions-statement-write.md
+++ b/translations/ko-KR/data/reusables/repositories/permissions-statement-write.md
@@ -1 +1 @@
-People with write-level access to the repository can perform these steps.
\ No newline at end of file
+Write access to the repository is required to perform these steps.
diff --git a/translations/ko-KR/data/reusables/repositories/security-alerts-x-github-severity.md b/translations/ko-KR/data/reusables/repositories/security-alerts-x-github-severity.md
index 560d9254c767..7230ee99948a 100644
--- a/translations/ko-KR/data/reusables/repositories/security-alerts-x-github-severity.md
+++ b/translations/ko-KR/data/reusables/repositories/security-alerts-x-github-severity.md
@@ -1 +1 @@
-Email notifications for {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} that affect one or more repositories include the `X-GitHub-Severity`  header field. You can use the value of the `X-GitHub-Severity` header field to filter email notifications for {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %}.
\ No newline at end of file
+Email notifications for {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} that affect one or more repositories include the `X-GitHub-Severity`  header field. You can use the value of the `X-GitHub-Severity` header field to filter email notifications for {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %}.
diff --git a/translations/ko-KR/data/reusables/repositories/select-marketplace-apps.md b/translations/ko-KR/data/reusables/repositories/select-marketplace-apps.md
index d4eece0dacab..4d959cebc7e7 100644
--- a/translations/ko-KR/data/reusables/repositories/select-marketplace-apps.md
+++ b/translations/ko-KR/data/reusables/repositories/select-marketplace-apps.md
@@ -1,3 +1,5 @@
 {% if currentVersion == "free-pro-team@latest" %}
-1. Optionally, if the personal account or organization in which you're creating uses any {% data variables.product.prodname_github_app %}s from {% data variables.product.prodname_marketplace %}, select any apps you'd like to use in the repository. ![List of your account's {% data variables.product.prodname_github_app %}s from {% data variables.product.prodname_marketplace %} and option to grant access](/assets/images/help/repository/create-repository-choose-marketplace-apps.png)
+1. Optionally, if the personal account or organization in which you're creating uses any
+{% data variables.product.prodname_github_app %}s from {% data variables.product.prodname_marketplace %}, select any apps you'd like to use in the repository.
+  ![List of your account's {% data variables.product.prodname_github_app %}s from {% data variables.product.prodname_marketplace %} and option to grant access](/assets/images/help/repository/create-repository-choose-marketplace-apps.png)
 {% endif %}
diff --git a/translations/ko-KR/data/reusables/repositories/sidebar-dependabot-alerts.md b/translations/ko-KR/data/reusables/repositories/sidebar-dependabot-alerts.md
index 74585315b209..b7eadd335c26 100644
--- a/translations/ko-KR/data/reusables/repositories/sidebar-dependabot-alerts.md
+++ b/translations/ko-KR/data/reusables/repositories/sidebar-dependabot-alerts.md
@@ -1 +1 @@
-1. In the security sidebar, click **{% data variables.product.prodname_dependabot_short %} alerts**. ![{% data variables.product.prodname_dependabot_short %} alerts tab](/assets/images/help/repository/dependabot-alerts-tab.png)
\ No newline at end of file
+1. In the security sidebar, click **{% data variables.product.prodname_dependabot_short %} alerts**. ![{% data variables.product.prodname_dependabot_short %} alerts tab](/assets/images/help/repository/dependabot-alerts-tab.png)
diff --git a/translations/ko-KR/data/reusables/repositories/view-failed-job-results-superlinter.md b/translations/ko-KR/data/reusables/repositories/view-failed-job-results-superlinter.md
new file mode 100644
index 000000000000..434994a1691a
--- /dev/null
+++ b/translations/ko-KR/data/reusables/repositories/view-failed-job-results-superlinter.md
@@ -0,0 +1,5 @@
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+1. Any failed steps are automatically expanded to display the results. ![Super linter workflow results](/assets/images/help/repository/super-linter-workflow-results-updated.png)
+{% else %}
+1. Expand the **Run Super-Linter** step to view the results. ![Super linter workflow results](/assets/images/help/repository/super-linter-workflow-results.png)
+{% endif %}
\ No newline at end of file
diff --git a/translations/ko-KR/data/reusables/repositories/view-run-superlinter.md b/translations/ko-KR/data/reusables/repositories/view-run-superlinter.md
new file mode 100644
index 000000000000..2f5d4e8b1b56
--- /dev/null
+++ b/translations/ko-KR/data/reusables/repositories/view-run-superlinter.md
@@ -0,0 +1 @@
+1. From the list of workflow runs, click the name of the run you want to see. ![Name of workflow run](/assets/images/help/repository/superlinter-run-name.png)
\ No newline at end of file
diff --git a/translations/ko-KR/data/reusables/repositories/view-run.md b/translations/ko-KR/data/reusables/repositories/view-run.md
index 4ba2c799ef4f..d2c1f73f0912 100644
--- a/translations/ko-KR/data/reusables/repositories/view-run.md
+++ b/translations/ko-KR/data/reusables/repositories/view-run.md
@@ -1 +1 @@
-1. Under "Workflow runs", click the name of the run you want to see. ![Name of workflow run](/assets/images/help/repository/run-name.png)
+1. From the list of workflow runs, click the name of the run you want to see. ![Name of workflow run](/assets/images/help/repository/run-name.png)
diff --git a/translations/ko-KR/data/reusables/repositories/view-specific-line-superlinter.md b/translations/ko-KR/data/reusables/repositories/view-specific-line-superlinter.md
new file mode 100644
index 000000000000..ae70f1762f54
--- /dev/null
+++ b/translations/ko-KR/data/reusables/repositories/view-specific-line-superlinter.md
@@ -0,0 +1,5 @@
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+1. Optionally, to get a link to a specific line in the logs, click on the step's line number. You can then copy the link from the address bar of your web browser. ![Button to copy link](/assets/images/help/repository/copy-link-button-updated.png)
+{% else %}
+1. Optionally, to get a link to a specific line in the logs, click on the step's line number. You can then copy the link from the address bar of your web browser. ![Button to copy link](/assets/images/help/repository/copy-link-button.png)
+{% endif %}
\ No newline at end of file
diff --git a/translations/ko-KR/data/reusables/saml/add-okta-application.md b/translations/ko-KR/data/reusables/saml/add-okta-application.md
index c0603c1510ee..9f1e9e2155a0 100644
--- a/translations/ko-KR/data/reusables/saml/add-okta-application.md
+++ b/translations/ko-KR/data/reusables/saml/add-okta-application.md
@@ -1 +1 @@
-2. Click **Add application**. !["Add application" button in the Okta Dashboard's Applications tab](/assets/images/help/saml/okta-add-application.png)
\ No newline at end of file
+2. Click **Add application**. !["Add application" button in the Okta Dashboard's Applications tab](/assets/images/help/saml/okta-add-application.png)
diff --git a/translations/ko-KR/data/reusables/saml/assign-yourself-to-okta.md b/translations/ko-KR/data/reusables/saml/assign-yourself-to-okta.md
index 7b2fd7293434..42cb7d475a97 100644
--- a/translations/ko-KR/data/reusables/saml/assign-yourself-to-okta.md
+++ b/translations/ko-KR/data/reusables/saml/assign-yourself-to-okta.md
@@ -1 +1 @@
-1. Assign the application to your user in Okta. For more information, see [Assign applications to users](https://help.okta.com/en/prod/Content/Topics/users-groups-profiles/usgp-assign-apps.htm) in the Okta documentation.
\ No newline at end of file
+1. Assign the application to your user in Okta. For more information, see [Assign applications to users](https://help.okta.com/en/prod/Content/Topics/users-groups-profiles/usgp-assign-apps.htm) in the Okta documentation.
diff --git a/translations/ko-KR/data/reusables/saml/click-enterprise-account-application.md b/translations/ko-KR/data/reusables/saml/click-enterprise-account-application.md
index e5d172dcb9e5..3f8b0dcf579a 100644
--- a/translations/ko-KR/data/reusables/saml/click-enterprise-account-application.md
+++ b/translations/ko-KR/data/reusables/saml/click-enterprise-account-application.md
@@ -1 +1 @@
-1. Click the label for the application you created for your enterprise account.
\ No newline at end of file
+1. Click the label for the application you created for your enterprise account.
diff --git a/translations/ko-KR/data/reusables/saml/okta-admin-button.md b/translations/ko-KR/data/reusables/saml/okta-admin-button.md
index b1f3d74979cc..ffc7938d2dde 100644
--- a/translations/ko-KR/data/reusables/saml/okta-admin-button.md
+++ b/translations/ko-KR/data/reusables/saml/okta-admin-button.md
@@ -1 +1 @@
-1. In Okta, in the upper-right corner, click **Admin**. ![Admin button in Okta](/assets/images/help/saml/okta-admin-button.png)
\ No newline at end of file
+1. In Okta, in the upper-right corner, click **Admin**. ![Admin button in Okta](/assets/images/help/saml/okta-admin-button.png)
diff --git a/translations/ko-KR/data/reusables/saml/okta-configure-api-integration.md b/translations/ko-KR/data/reusables/saml/okta-configure-api-integration.md
index 99b1aad0afae..080baa79cdb4 100644
--- a/translations/ko-KR/data/reusables/saml/okta-configure-api-integration.md
+++ b/translations/ko-KR/data/reusables/saml/okta-configure-api-integration.md
@@ -1 +1 @@
-1. Click **Configure API Integration**. !["Configure API Integration" button for Okta application](/assets/images/help/saml/okta-configure-api-integration.png)
\ No newline at end of file
+1. Click **Configure API Integration**. !["Configure API Integration" button for Okta application](/assets/images/help/saml/okta-configure-api-integration.png)
diff --git a/translations/ko-KR/data/reusables/saml/okta-edit-provisioning.md b/translations/ko-KR/data/reusables/saml/okta-edit-provisioning.md
index 00cc36e07d00..42ce899aab33 100644
--- a/translations/ko-KR/data/reusables/saml/okta-edit-provisioning.md
+++ b/translations/ko-KR/data/reusables/saml/okta-edit-provisioning.md
@@ -2,4 +2,4 @@
 11. To the right of "Create Users", select **Enable**. !["Enable" checkbox for Okta application's "Create Users" option](/assets/images/help/saml/okta-provisioning-enable-create-users.png)
 12. To the right of "Update User Attributes", select **Enable**. !["Enable" checkbox for Okta application's "Update User Attributes" option](/assets/images/help/saml/okta-provisioning-enable-update-user-attributes.png)
 13. To the right of "Deactivate Users", select **Enable**. !["Enable" checkbox for Okta application's "Deactivate Users" option](/assets/images/help/saml/okta-provisioning-enable-deactivate-users.png)
-14. Click **Save**. !["Save" button for Okta application's provisioning configuration](/assets/images/help/saml/okta-provisioning-save.png)
\ No newline at end of file
+14. Click **Save**. !["Save" button for Okta application's provisioning configuration](/assets/images/help/saml/okta-provisioning-save.png)
diff --git a/translations/ko-KR/data/reusables/saml/okta-enable-api-integration.md b/translations/ko-KR/data/reusables/saml/okta-enable-api-integration.md
index b07c86537920..29cb364628f4 100644
--- a/translations/ko-KR/data/reusables/saml/okta-enable-api-integration.md
+++ b/translations/ko-KR/data/reusables/saml/okta-enable-api-integration.md
@@ -1 +1 @@
-1. Select **Enable API integration**. !["Enable API integration" checkbox for Okta application](/assets/images/help/saml/okta-enable-api-integration.png)
\ No newline at end of file
+1. Select **Enable API integration**. !["Enable API integration" checkbox for Okta application](/assets/images/help/saml/okta-enable-api-integration.png)
diff --git a/translations/ko-KR/data/reusables/saml/okta-provisioning-tab.md b/translations/ko-KR/data/reusables/saml/okta-provisioning-tab.md
index f4a8f6cca707..b8c134b4e2ba 100644
--- a/translations/ko-KR/data/reusables/saml/okta-provisioning-tab.md
+++ b/translations/ko-KR/data/reusables/saml/okta-provisioning-tab.md
@@ -1 +1 @@
-1. Under the name of the application, click **Provisioning**. !["Provisioning" tab for Okta application](/assets/images/help/saml/okta-provisioning-tab.png)
\ No newline at end of file
+1. Under the name of the application, click **Provisioning**. !["Provisioning" tab for Okta application](/assets/images/help/saml/okta-provisioning-tab.png)
diff --git a/translations/ko-KR/data/reusables/saml/okta-save-provisioning.md b/translations/ko-KR/data/reusables/saml/okta-save-provisioning.md
index 8c863ae1dda2..15e30d210790 100644
--- a/translations/ko-KR/data/reusables/saml/okta-save-provisioning.md
+++ b/translations/ko-KR/data/reusables/saml/okta-save-provisioning.md
@@ -1 +1 @@
-1. Click **Save**. !["Save" button for Okta application's provisioning configuration](/assets/images/help/saml/okta-provisioning-tab-save.png)
\ No newline at end of file
+1. Click **Save**. !["Save" button for Okta application's provisioning configuration](/assets/images/help/saml/okta-provisioning-tab-save.png)
diff --git a/translations/ko-KR/data/reusables/saml/okta-sign-on-tab.md b/translations/ko-KR/data/reusables/saml/okta-sign-on-tab.md
index 99468b5e5a09..405f402da97f 100644
--- a/translations/ko-KR/data/reusables/saml/okta-sign-on-tab.md
+++ b/translations/ko-KR/data/reusables/saml/okta-sign-on-tab.md
@@ -1 +1 @@
-1. Under the name of the application, click **Sign on**. !["Sign on" tab for Okta application](/assets/images/help/saml/okta-sign-on-tab.png)
\ No newline at end of file
+1. Under the name of the application, click **Sign on**. !["Sign on" tab for Okta application](/assets/images/help/saml/okta-sign-on-tab.png)
diff --git a/translations/ko-KR/data/reusables/saml/okta-view-setup-instructions.md b/translations/ko-KR/data/reusables/saml/okta-view-setup-instructions.md
index 085e62499c25..fec76f61133b 100644
--- a/translations/ko-KR/data/reusables/saml/okta-view-setup-instructions.md
+++ b/translations/ko-KR/data/reusables/saml/okta-view-setup-instructions.md
@@ -1 +1 @@
-1. Under "SIGN ON METHODS", click **View Setup Instructions**. !["View Setup Instructions" button in Okta application's "Sign On" tab](/assets/images/help/saml/okta-view-setup-instructions.png)
\ No newline at end of file
+1. Under "SIGN ON METHODS", click **View Setup Instructions**. !["View Setup Instructions" button in Okta application's "Sign On" tab](/assets/images/help/saml/okta-view-setup-instructions.png)
diff --git a/translations/ko-KR/data/reusables/saml/search-ghec-okta.md b/translations/ko-KR/data/reusables/saml/search-ghec-okta.md
index c0881a1727f6..e4acdaf2ba11 100644
--- a/translations/ko-KR/data/reusables/saml/search-ghec-okta.md
+++ b/translations/ko-KR/data/reusables/saml/search-ghec-okta.md
@@ -1 +1 @@
-3. In the search field, type "GitHub Enterprise Cloud". ![Okta's "Search for an application" field](/assets/images/help/saml/okta-search-for-an-application.png)
\ No newline at end of file
+3. In the search field, type "GitHub Enterprise Cloud". ![Okta's "Search for an application" field](/assets/images/help/saml/okta-search-for-an-application.png)
diff --git a/translations/ko-KR/data/reusables/saml/use-classic-ui.md b/translations/ko-KR/data/reusables/saml/use-classic-ui.md
index abf6ff92c43b..20870f6b8c3e 100644
--- a/translations/ko-KR/data/reusables/saml/use-classic-ui.md
+++ b/translations/ko-KR/data/reusables/saml/use-classic-ui.md
@@ -1,3 +1,3 @@
 You must use the "Classic UI" in Okta. For more information, see [Organized Navigation](https://developer.okta.com/blog/2017/09/25/all-new-developer-console#new-look--feel) on the Okta blog.
 
-![Selecting "Classic UI" from Okta UI style picker above dashboard](/assets/images/help/saml/okta-classic-ui.png)
\ No newline at end of file
+![Selecting "Classic UI" from Okta UI style picker above dashboard](/assets/images/help/saml/okta-classic-ui.png)
diff --git a/translations/ko-KR/data/reusables/scim/enterprise-account-scim.md b/translations/ko-KR/data/reusables/scim/enterprise-account-scim.md
index 41d1a43470e4..1797863354c2 100644
--- a/translations/ko-KR/data/reusables/scim/enterprise-account-scim.md
+++ b/translations/ko-KR/data/reusables/scim/enterprise-account-scim.md
@@ -1 +1 @@
-If you're participating in the private beta for user provisioning for enterprise accounts, when you enable SAML for your enterprise account, SCIM provisioning and deprovisioning is enabled by default in {% data variables.product.product_name %}. You can use provisioning to manage organization membership by configuring SCIM in your IdP.
\ No newline at end of file
+If you're participating in the private beta for user provisioning for enterprise accounts, when you enable SAML for your enterprise account, SCIM provisioning and deprovisioning is enabled by default in {% data variables.product.product_name %}. You can use provisioning to manage organization membership by configuring SCIM in your IdP.
diff --git a/translations/ko-KR/data/reusables/secret-scanning/beta.md b/translations/ko-KR/data/reusables/secret-scanning/beta.md
index 13b1cc30155a..68ed06f9c93a 100644
--- a/translations/ko-KR/data/reusables/secret-scanning/beta.md
+++ b/translations/ko-KR/data/reusables/secret-scanning/beta.md
@@ -2,4 +2,4 @@
 
 **Note:** {% data variables.product.prodname_secret_scanning_caps %} for private repositories is currently in beta and subject to change. To request access to the beta, [join the waitlist](https://github.com/features/security/advanced-security/signup).
 
-{% endnote %}
\ No newline at end of file
+{% endnote %}
diff --git a/translations/ko-KR/data/reusables/security/security-and-analysis-features-enable-read-only.md b/translations/ko-KR/data/reusables/security/security-and-analysis-features-enable-read-only.md
index 34ccd94fd4d5..9941a34ca334 100644
--- a/translations/ko-KR/data/reusables/security/security-and-analysis-features-enable-read-only.md
+++ b/translations/ko-KR/data/reusables/security/security-and-analysis-features-enable-read-only.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-If you enable security and analysis features, {% data variables.product.company_short %} performs read-only analysis on your repository. For more information, see "[About {% data variables.product.company_short %}'s use of your data](/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data)."
-{% endif %}
\ No newline at end of file
+If you enable security and analysis features,
+{% data variables.product.company_short %} performs read-only analysis on your repository. For more information, see "[About {% data variables.product.company_short %}'s use of your data](/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data)."
+{% endif %}
diff --git a/translations/ko-KR/data/reusables/shortdesc/iso_8601.md b/translations/ko-KR/data/reusables/shortdesc/iso_8601.md
index ff04e176b2e3..6f3fbed64c03 100644
--- a/translations/ko-KR/data/reusables/shortdesc/iso_8601.md
+++ b/translations/ko-KR/data/reusables/shortdesc/iso_8601.md
@@ -1 +1 @@
-This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`.
\ No newline at end of file
+This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`.
diff --git a/translations/ko-KR/data/reusables/sponsors/edit-featured-work.md b/translations/ko-KR/data/reusables/sponsors/edit-featured-work.md
index 6272fd015c8b..cbdc873914f3 100644
--- a/translations/ko-KR/data/reusables/sponsors/edit-featured-work.md
+++ b/translations/ko-KR/data/reusables/sponsors/edit-featured-work.md
@@ -1,3 +1,3 @@
 1. Optionally, choose the repositories that are showcased on your {% data variables.product.prodname_sponsors %} profile.
     - To the right of "Featured work", click **Edit**. ![Edit button for featured work](/assets/images/help/sponsors/featured-work-edit-button.png)
-    - Select up to 6 repositories, then click **Save**. ![Checkboxes to select repositories](/assets/images/help/sponsors/featured-work-select.png)
\ No newline at end of file
+    - Select up to 6 repositories, then click **Save**. ![Checkboxes to select repositories](/assets/images/help/sponsors/featured-work-select.png)
diff --git a/translations/ko-KR/data/reusables/sponsors/meet-the-team.md b/translations/ko-KR/data/reusables/sponsors/meet-the-team.md
index 3edbfe23bdc8..5b92cf58dffd 100644
--- a/translations/ko-KR/data/reusables/sponsors/meet-the-team.md
+++ b/translations/ko-KR/data/reusables/sponsors/meet-the-team.md
@@ -2,4 +2,4 @@
     - To the right of "Meet the team", click **Edit**.  
       ![Edit organization members to profile button](/assets/images/help/sponsors/edit-org-members-profile-button.png)
     - Select up to six organization members, then click **Save**. ![Select highlighted organization members](/assets/images/help/sponsors/select-highlighted-org-members.png)
-    - Optionally, under each highlighted member's name, type a description of the member. ![Description for highlighted organization members](/assets/images/help/sponsors/description-highlighted-org-members.png)
\ No newline at end of file
+    - Optionally, under each highlighted member's name, type a description of the member. ![Description for highlighted organization members](/assets/images/help/sponsors/description-highlighted-org-members.png)
diff --git a/translations/ko-KR/data/reusables/sponsors/navigate-to-your-goals-tab.md b/translations/ko-KR/data/reusables/sponsors/navigate-to-your-goals-tab.md
index fec98000f9b6..cea6796834db 100644
--- a/translations/ko-KR/data/reusables/sponsors/navigate-to-your-goals-tab.md
+++ b/translations/ko-KR/data/reusables/sponsors/navigate-to-your-goals-tab.md
@@ -1 +1 @@
-1. In the left sidebar, click **Your goals**. ![Your goals tab](/assets/images/help/sponsors/your-goals-tab.png)
\ No newline at end of file
+1. In the left sidebar, click **Your goals**. ![Your goals tab](/assets/images/help/sponsors/your-goals-tab.png)
diff --git a/translations/ko-KR/data/reusables/sponsors/opt-in-to-being-featured.md b/translations/ko-KR/data/reusables/sponsors/opt-in-to-being-featured.md
index bbd09ae633ec..eaa87f3cf2d5 100644
--- a/translations/ko-KR/data/reusables/sponsors/opt-in-to-being-featured.md
+++ b/translations/ko-KR/data/reusables/sponsors/opt-in-to-being-featured.md
@@ -1 +1 @@
-1. Optionally, select **Opt-in to potentially being featured on github.com/sponsors**. ![Checkbox to opt-in to being featured](/assets/images/help/sponsors/opt-in-to-being-featured.png)
\ No newline at end of file
+1. Optionally, select **Opt-in to potentially being featured on github.com/sponsors**. ![Checkbox to opt-in to being featured](/assets/images/help/sponsors/opt-in-to-being-featured.png)
diff --git a/translations/ko-KR/data/reusables/sponsors/publish-goal.md b/translations/ko-KR/data/reusables/sponsors/publish-goal.md
index 68190018e7b8..7febeb4a951a 100644
--- a/translations/ko-KR/data/reusables/sponsors/publish-goal.md
+++ b/translations/ko-KR/data/reusables/sponsors/publish-goal.md
@@ -1 +1 @@
-1. Click **Publish**. ![Publish button](/assets/images/help/sponsors/publish-goal-button.png)
\ No newline at end of file
+1. Click **Publish**. ![Publish button](/assets/images/help/sponsors/publish-goal-button.png)
diff --git a/translations/ko-KR/data/reusables/sponsors/retire-goal.md b/translations/ko-KR/data/reusables/sponsors/retire-goal.md
index bf0e01c5a3ce..c686c8ef1b74 100644
--- a/translations/ko-KR/data/reusables/sponsors/retire-goal.md
+++ b/translations/ko-KR/data/reusables/sponsors/retire-goal.md
@@ -1,2 +1,2 @@
 1. At the bottom of the page, click **Retire**. ![The Retire button](/assets/images/help/sponsors/retire-goal-button.png)
-2. Read the warning, then click **OK**. ![Warning about retiring a goal](/assets/images/help/sponsors/confirm-retire-goal.png)
\ No newline at end of file
+2. Read the warning, then click **OK**. ![Warning about retiring a goal](/assets/images/help/sponsors/confirm-retire-goal.png)
diff --git a/translations/ko-KR/data/reusables/sponsors/save-profile.md b/translations/ko-KR/data/reusables/sponsors/save-profile.md
index 57b2d4b31f67..01f7b8a711dc 100644
--- a/translations/ko-KR/data/reusables/sponsors/save-profile.md
+++ b/translations/ko-KR/data/reusables/sponsors/save-profile.md
@@ -1 +1 @@
-1. Click **Update profile**.
\ No newline at end of file
+1. Click **Update profile**.
diff --git a/translations/ko-KR/data/reusables/sponsors/set-a-goal.md b/translations/ko-KR/data/reusables/sponsors/set-a-goal.md
index 4d4098c6af11..943723255016 100644
--- a/translations/ko-KR/data/reusables/sponsors/set-a-goal.md
+++ b/translations/ko-KR/data/reusables/sponsors/set-a-goal.md
@@ -1 +1 @@
-1. Under "Your goals", click **Set a goal**. ![Set a goal button ](/assets/images/help/sponsors/set-a-goal-button.png)
\ No newline at end of file
+1. Under "Your goals", click **Set a goal**. ![Set a goal button ](/assets/images/help/sponsors/set-a-goal-button.png)
diff --git a/translations/ko-KR/data/reusables/sponsors/short-bio.md b/translations/ko-KR/data/reusables/sponsors/short-bio.md
index db494ee33f90..387246f51616 100644
--- a/translations/ko-KR/data/reusables/sponsors/short-bio.md
+++ b/translations/ko-KR/data/reusables/sponsors/short-bio.md
@@ -1 +1 @@
-1. Under "Short bio", type a brief description of yourself and your work. ![Short bio field](/assets/images/help/sponsors/short-bio.png)
\ No newline at end of file
+1. Under "Short bio", type a brief description of yourself and your work. ![Short bio field](/assets/images/help/sponsors/short-bio.png)
diff --git a/translations/ko-KR/data/reusables/sponsors/stripe-supported-regions.md b/translations/ko-KR/data/reusables/sponsors/stripe-supported-regions.md
index b7b781475a25..e89949ce86e7 100644
--- a/translations/ko-KR/data/reusables/sponsors/stripe-supported-regions.md
+++ b/translations/ko-KR/data/reusables/sponsors/stripe-supported-regions.md
@@ -1 +1 @@
-For a list of supported regions, see [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors).
+For a list of supported regions, see [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors#countries).
diff --git a/translations/ko-KR/data/reusables/sponsors/you-can-be-a-sponsored-developer.md b/translations/ko-KR/data/reusables/sponsors/you-can-be-a-sponsored-developer.md
index cab20e5d2af2..28b8e06b5e66 100644
--- a/translations/ko-KR/data/reusables/sponsors/you-can-be-a-sponsored-developer.md
+++ b/translations/ko-KR/data/reusables/sponsors/you-can-be-a-sponsored-developer.md
@@ -1 +1 @@
-Anyone who contributes to an open source project and has a bank account in a supported region is eligible to become a sponsored developer. Contributions include but are not limited to bug reports, issue triage, code, documentation, leadership, business development, project management, mentorship, and design. If you live in a region that isn't already supported by {% data variables.product.prodname_sponsors %}, you can sign up for the waitlist to participate in the beta of {% data variables.product.prodname_sponsors %}. To see if {% data variables.product.prodname_sponsors %} is available in your area, see [the list of supported regions](https://github.com/sponsors#regions).
+Anyone who contributes to an open source project and lives in a supported region is eligible to become a sponsored developer. Contributions include but are not limited to bug reports, issue triage, code, documentation, leadership, business development, project management, mentorship, and design. If you live in a region that isn't already supported by {% data variables.product.prodname_sponsors %}, you can sign up for the waitlist to participate in the beta of {% data variables.product.prodname_sponsors %}.
diff --git a/translations/ko-KR/data/reusables/sponsors/you-can-be-a-sponsored-organization.md b/translations/ko-KR/data/reusables/sponsors/you-can-be-a-sponsored-organization.md
index 7b6f8a085e58..8b1a3ed050da 100644
--- a/translations/ko-KR/data/reusables/sponsors/you-can-be-a-sponsored-organization.md
+++ b/translations/ko-KR/data/reusables/sponsors/you-can-be-a-sponsored-organization.md
@@ -1 +1 @@
-Any organization that contributes to an open source project and has a dedicated bank account in a supported region is eligible to become a sponsored organization. If you live in a region that isn't already supported by {% data variables.product.prodname_sponsors %}, join the waitlist at [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors).
+Any organization that contributes to an open source project and legally operates in a supported region is eligible to become a sponsored organization. If your organization operates in a region that isn't already supported by {% data variables.product.prodname_sponsors %}, join the waitlist at [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors).
diff --git a/translations/ko-KR/data/reusables/ssh/dsa-support.md b/translations/ko-KR/data/reusables/ssh/dsa-support.md
index 4cbfdb1a5495..7f6f3c22f4d2 100644
--- a/translations/ko-KR/data/reusables/ssh/dsa-support.md
+++ b/translations/ko-KR/data/reusables/ssh/dsa-support.md
@@ -1,5 +1,5 @@
 {% note %}
 
-**Note:** {% if currentVersion != "free-pro-team@latest" or currentVersion ver_lt "enterprise-server@2.19" %}DSA keys were deprecated in OpenSSH 7.0. If your operating system uses OpenSSH, you'll need to use an alternate type of key when setting up SSH, such as an RSA key. For instance, if your operating system is macOS Sierra, you can set up SSH using an RSA key.{% else %}DSA keys (SSH-DSS) are no longer supported. Existing keys will continue to function, but you cannot add new DSA keys to your {% data variables.product.product_name %} account.{% endif %}
+**Note:** DSA keys (SSH-DSS) are no longer supported. Existing keys will continue to function, but you cannot add new DSA keys to your {% data variables.product.product_name %} account.
 
 {% endnote %}
diff --git a/translations/ko-KR/data/reusables/support/about-premium-plans.md b/translations/ko-KR/data/reusables/support/about-premium-plans.md
index 057fd076d69a..5c2b87b82938 100644
--- a/translations/ko-KR/data/reusables/support/about-premium-plans.md
+++ b/translations/ko-KR/data/reusables/support/about-premium-plans.md
@@ -3,16 +3,16 @@
 
 There are two {% data variables.contact.premium_support %} plans: Premium and Premium Plus / {% data variables.product.microsoft_premium_plus_support_plan %}.
 
-|                       | {% data variables.product.premium_support_plan %} | {% data variables.product.premium_plus_support_plan %} |
-| --------------------- | -------------------------------------------------------- | ------------------------------------------------------------- |
-| Hours of operation    | 24 x 7                                                   | 24 x 7                                                        |
-| Initial response time | 
    • 30 minutes for {% data variables.product.support_ticket_priority_urgent %}
    • 4 hours for {% data variables.product.support_ticket_priority_high %}
                                    | 
    • 30 minutes for {% data variables.product.support_ticket_priority_urgent %}
    • 4 hours for {% data variables.product.support_ticket_priority_high %}
                                         |
-| Support channels      | 
    • Online ticket submission
    • Phone support
                                    | 
    • Online ticket submission
    • Phone support
    • Screen share for critical issues
                                         |
-| 연습                    | Access to premium content                                | 
    • Access to premium content
    • 1 virtual training class per year
                                         |
-| Authorized contacts   | 10                                                       | 25                                                            |
-| 리소스                   | Priority ticket handling                                 | 
    • Priority ticket handling
    • Named Technical Support Account Manager
                                         |
-| Scheduled checks      | Bi-annual health check and reporting                     | 
    • Quarterly health check and reporting
    • Quarterly account reviews
                                         |
-| Administration        |                                                          | 4 hours of Managed Services per month                         |
+|                       | {% data variables.product.premium_support_plan %} | {% data variables.product.premium_plus_support_plan %}
+| --------------------- | --------------------------------------------------- | -------------------------------------------------------- |
+| Hours of operation    | 24 x 7                                              | 24 x 7                                                   |
+| Initial response time | 
    • 30 minutes for {% data variables.product.support_ticket_priority_urgent %}
    • 4 hours for {% data variables.product.support_ticket_priority_high %}
                               | 
    • 30 minutes for {% data variables.product.support_ticket_priority_urgent %}
    • 4 hours for {% data variables.product.support_ticket_priority_high %}
                                    |
+| Support channels      | 
    • Online ticket submission
    • Phone support
                               | 
    • Online ticket submission
    • Phone support
    • Screen share for critical issues
                                    |
+| 연습                    | Access to premium content                           | 
    • Access to premium content
    • 1 virtual training class per year
                                    |
+| Authorized contacts   | 10                                                  | 25                                                       |
+| 리소스                   | Priority ticket handling                            | 
    • Priority ticket handling
    • Named Technical Support Account Manager
                                    |
+| Scheduled checks      | Bi-annual health check and reporting                | 
    • Quarterly health check and reporting
    • Quarterly account reviews
                                    |
+| Administration        |                                                     | 4 hours of Managed Services per month                    |
 
   {% note %}
 
diff --git a/translations/ko-KR/data/reusables/support/ghec-premium-priorities.md b/translations/ko-KR/data/reusables/support/ghec-premium-priorities.md
index 138803d69565..092c4aafc384 100644
--- a/translations/ko-KR/data/reusables/support/ghec-premium-priorities.md
+++ b/translations/ko-KR/data/reusables/support/ghec-premium-priorities.md
@@ -1,6 +1,6 @@
-|                              Priority                              | 설명                                                                                                                                                                                                                                                                                                      | 예시                        |
-|:------------------------------------------------------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
-| {% data variables.product.support_ticket_priority_urgent %} | Production workflows for your organization or enterprise on {% data variables.product.prodname_ghe_cloud %} are failing due to critical service errors or outages, and the failure directly impacts the operation of your business.                                                              | 
    • Errors or outages on {% data variables.product.prodname_dotcom_the_website %} affect core Git or web application functionality for all members of your organization or enterprise
     |
-|  {% data variables.product.support_ticket_priority_high %}  | Account or security issues with your organization or enterprise on {% data variables.product.prodname_ghe_cloud %} are causing limited impact to your business.                                                                                                                                  | 
    • An organization or enterprise owner has unintentionally deleted an organization
    • An organization or enterprise member has uploaded sensitive data in a commit, issue, pull request, or issue attachment
     |
+|                           Priority                            | 설명                                                                                                                                                                                                                                                                                            | 예시                        |
+|:-------------------------------------------------------------:| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
+| {% data variables.product.support_ticket_priority_urgent %} | Production workflows for your organization or enterprise on {% data variables.product.prodname_ghe_cloud %} are failing due to critical service errors or outages, and the failure directly impacts the operation of your business.                                                         | 
    • Errors or outages on {% data variables.product.prodname_dotcom_the_website %} affect core Git or web application functionality for all members of your organization or enterprise
     |
+|  {% data variables.product.support_ticket_priority_high %}  | Account or security issues with your organization or enterprise on {% data variables.product.prodname_ghe_cloud %} are causing limited impact to your business.                                                                                                                             | 
    • An organization or enterprise owner has unintentionally deleted an organization
    • An organization or enterprise member has uploaded sensitive data in a commit, issue, pull request, or issue attachment
     |
 | {% data variables.product.support_ticket_priority_normal %} | Members of your organization or enterprise on {% data variables.product.prodname_ghe_cloud %} are experiencing limited or moderate issues with {% data variables.product.prodname_dotcom_the_website %}, or you have general concerns or questions about your organization or enterprise. | 
    • Questions about using APIs and features for your organization or enterprise
    • Issues with tools for organization data migration that {% data variables.product.company_short %} provides
    • Features related to your organization or enterprise not working as expected
    • General security questions about your organization or enterprise
     |
-|  {% data variables.product.support_ticket_priority_low %}   | You have a question or suggestion about your organization or enterprise on {% data variables.product.prodname_ghe_cloud %} that is not time-sensitive, or does not otherwise block the productivity of your team.                                                                                | 
    • Excessive resource usage for your organization or enterprise
    • Requests for health checks
    • Help with using Gists, notifications, wikis, {% data variables.product.prodname_pages %}, {% data variables.product.prodname_desktop %}, Atom, or other peripheral services or features with your organization or enterprise
    • Feature requests
    • Product feedback
     |
+|  {% data variables.product.support_ticket_priority_low %}   | You have a question or suggestion about your organization or enterprise on {% data variables.product.prodname_ghe_cloud %} that is not time-sensitive, or does not otherwise block the productivity of your team.                                                                           | 
    • Excessive resource usage for your organization or enterprise
    • Requests for health checks
    • Help with using Gists, notifications, wikis, {% data variables.product.prodname_pages %}, {% data variables.product.prodname_desktop %}, Atom, or other peripheral services or features with your organization or enterprise
    • Feature requests
    • Product feedback
     |
diff --git a/translations/ko-KR/data/reusables/support/ghes-priorities.md b/translations/ko-KR/data/reusables/support/ghes-priorities.md
index a8d64d709870..89caf1223f78 100644
--- a/translations/ko-KR/data/reusables/support/ghes-priorities.md
+++ b/translations/ko-KR/data/reusables/support/ghes-priorities.md
@@ -1,6 +1,6 @@
-|                              Priority                              | 설명                                                                                                                                                                                                                                                       | 예시                        |
-|:------------------------------------------------------------------:| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
+|                           Priority                            | 설명                                                                                                                                                                                                                                             | 예시                        |
+|:-------------------------------------------------------------:| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
 | {% data variables.product.support_ticket_priority_urgent %} | {% data variables.product.prodname_ghe_server %} is failing in a production environment, and the failure directly impacts the operation of your business.

    _{% data reusables.support.priority-urgent-english-only %}_ | 
    • Errors or outages that affect core Git or web application functionality for all users
    • Severe performance degradation for majority of users
    • Full or rapidly filling storage
    • Inability to install a renewed license file
    • Security incident
    • Loss of administrative access to the instance with no known workaround
    • Failure to restore a backup to a production environment
     |
-|  {% data variables.product.support_ticket_priority_high %}  | {% data variables.product.prodname_ghe_server %} is failing in a production environment, but impact on your business is limited.                                                                                                                  | 
    • Performance degradation that reduces productivity for many users
    • Reduced redundancy from failure of High Availability (HA) or cluster nodes
    • Failure to back up instance
    • Failure to restore a backup to a test or staging environment that could compromise successful restoration to a production environment
     |
-| {% data variables.product.support_ticket_priority_normal %} | You're experiencing limited or moderate issues with {% data variables.product.prodname_ghe_server %}, or you have general concerns or questions about the operation of your instance.                                                             | 
    • Problems in a test or staging environment
    • Advice on using {% data variables.product.prodname_dotcom %} APIs and features, or questions about configuring third-party integrations from your instance
    • Issues with tools for user data migration that {% data variables.product.company_short %} provides
    • 업그레이드
    • Bug reports
    • Features not working as expected
    • General security questions
     |
-|  {% data variables.product.support_ticket_priority_low %}   | You have a question or suggestion about {% data variables.product.prodname_ghe_server %} that is not time-sensitive, or does not otherwise block the productivity of your team.                                                                   | 
    • Feature requests
    • Product feedback
    • Requests for health checks (available for customers with a {% data variables.product.premium_support_plan %} only at this time)
    • Notifying {% data variables.product.company_short %} of planned maintenance on your instance
     |
+|  {% data variables.product.support_ticket_priority_high %}  | {% data variables.product.prodname_ghe_server %} is failing in a production environment, but impact on your business is limited.                                                                                                             | 
    • Performance degradation that reduces productivity for many users
    • Reduced redundancy from failure of High Availability (HA) or cluster nodes
    • Failure to back up instance
    • Failure to restore a backup to a test or staging environment that could compromise successful restoration to a production environment
     |
+| {% data variables.product.support_ticket_priority_normal %} | You're experiencing limited or moderate issues with {% data variables.product.prodname_ghe_server %}, or you have general concerns or questions about the operation of your instance.                                                        | 
    • Problems in a test or staging environment
    • Advice on using {% data variables.product.prodname_dotcom %} APIs and features, or questions about configuring third-party integrations from your instance
    • Issues with tools for user data migration that {% data variables.product.company_short %} provides
    • 업그레이드
    • Bug reports
    • Features not working as expected
    • General security questions
     |
+|  {% data variables.product.support_ticket_priority_low %}   | You have a question or suggestion about {% data variables.product.prodname_ghe_server %} that is not time-sensitive, or does not otherwise block the productivity of your team.                                                              | 
    • Feature requests
    • Product feedback
    • Requests for health checks (available for customers with a {% data variables.product.premium_support_plan %} only at this time)
    • Notifying {% data variables.product.company_short %} of planned maintenance on your instance
     |
diff --git a/translations/ko-KR/data/reusables/support/priority-urgent-english-only.md b/translations/ko-KR/data/reusables/support/priority-urgent-english-only.md
index a33de1c4dfdb..17c2e6a1565d 100644
--- a/translations/ko-KR/data/reusables/support/priority-urgent-english-only.md
+++ b/translations/ko-KR/data/reusables/support/priority-urgent-english-only.md
@@ -1 +1 @@
-Support for tickets with {% data variables.product.support_ticket_priority_urgent %} priority is only available in the English language.
\ No newline at end of file
+Support for tickets with {% data variables.product.support_ticket_priority_urgent %} priority is only available in the English language.
diff --git a/translations/ko-KR/data/reusables/support/service-level-agreement-response-times.md b/translations/ko-KR/data/reusables/support/service-level-agreement-response-times.md
index 89188a659fe7..145cd883c449 100644
--- a/translations/ko-KR/data/reusables/support/service-level-agreement-response-times.md
+++ b/translations/ko-KR/data/reusables/support/service-level-agreement-response-times.md
@@ -2,7 +2,7 @@
 
 For tickets you submit, support is available 24 hours a day, 7 days per week. The initial response time guaranteed by the SLA is dependent on the priority level of the ticket. Response time begins when {% data variables.contact.premium_support %} sets the priority level of the ticket. A response does not mean the issue has been resolved.
 
-| Ticket priority level                                              | Initial response time |
-| ------------------------------------------------------------------ | --------------------- |
+| Ticket priority level                                         | Initial response time |
+| ------------------------------------------------------------- | --------------------- |
 | {% data variables.product.support_ticket_priority_urgent %} | 30 minutes            |
 | {% data variables.product.support_ticket_priority_high %}   | 4 hours               |
diff --git a/translations/ko-KR/data/reusables/two_fa/about-2fa.md b/translations/ko-KR/data/reusables/two_fa/about-2fa.md
new file mode 100644
index 000000000000..704cb699cc2e
--- /dev/null
+++ b/translations/ko-KR/data/reusables/two_fa/about-2fa.md
@@ -0,0 +1 @@
+Two-factor authentication (2FA) is an extra layer of security used when logging into websites or apps.
diff --git a/translations/ko-KR/data/reusables/two_fa/after-2fa-add-security-key.md b/translations/ko-KR/data/reusables/two_fa/after-2fa-add-security-key.md
index 12b44b4dba0e..271169e10a7a 100644
--- a/translations/ko-KR/data/reusables/two_fa/after-2fa-add-security-key.md
+++ b/translations/ko-KR/data/reusables/two_fa/after-2fa-add-security-key.md
@@ -1 +1 @@
-After you configure 2FA using a mobile app{% if currentVersion == "free-pro-team@latest" %} or via text message{% endif %}, you can add a security key, like a fingerprint reader or Windows Hello. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}The technology that enables authentication with a security key is called WebAuthn. WebAuthn is the successor to U2F and works in all modern browsers. For more information, see "[WebAuthn](https://webauthn.guide/)" and "[Can I Use](https://caniuse.com/#search=webauthn)."{% else %}FIDO U2F authentication is currently available for the Chrome, Firefox, and Opera browsers.{% endif %}
+After you configure 2FA using a mobile app{% if currentVersion == "free-pro-team@latest" %} or via text message{% endif %}, you can add a security key, like a fingerprint reader or Windows Hello. The technology that enables authentication with a security key is called WebAuthn. WebAuthn is the successor to U2F and works in all modern browsers. For more information, see "[WebAuthn](https://webauthn.guide/)" and "[Can I Use](https://caniuse.com/#search=webauthn)."
diff --git a/translations/ko-KR/data/reusables/two_fa/auth_methods_2fa.md b/translations/ko-KR/data/reusables/two_fa/auth_methods_2fa.md
index 4f83642f2453..c6ecc76d27f9 100644
--- a/translations/ko-KR/data/reusables/two_fa/auth_methods_2fa.md
+++ b/translations/ko-KR/data/reusables/two_fa/auth_methods_2fa.md
@@ -1,10 +1,10 @@
 {% if currentVersion != "free-pro-team@latest" %}
 ### Authentication methods that support 2FA
 
-| Authentication Method                             | 설명                                                                                                                                          | Two-factor authentication support                                                                                                                                                                                             |
-| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Authentication Method                             | 설명                                                                                                                                     | Two-factor authentication support                                                                                                                                                                                                        |
+| ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Built-in                                          | Authentication is performed against user accounts that are stored on the {% data variables.product.prodname_ghe_server %} appliance. | Supported and managed on the {% data variables.product.prodname_ghe_server %} appliance. Organization administrators can require 2FA to be enabled for members of the organization. |{% if currentVersion != "free-pro-team@latest" %}
-| Built-in authentication with an identity provider | Authentication is performed against user accounts that are stored on the identity provider.                                                 | Dependant on the identity provider.{% endif %}
-| LDAP                                              | Allows integration with your company directory service for authentication.                                                                  | Supported and managed on the {% data variables.product.prodname_ghe_server %} appliance. Organization administrators can require 2FA to be enabled for members of the organization.                                    |
-| SAML                                              | Authentication is performed on an external identity provider.                                                                               | {% data reusables.two_fa.2fa_not_supported_with_saml_and_cas %}                                                                                                                                                    |
-| CAS                                               | Single sign-on service is provided by an external server.                                                                                   | {% data reusables.two_fa.2fa_not_supported_with_saml_and_cas %}{% endif %}
+| Built-in authentication with an identity provider | Authentication is performed against user accounts that are stored on the identity provider.                                            | Dependant on the identity provider.{% endif %}
+| LDAP                                              | Allows integration with your company directory service for authentication.                                                             | Supported and managed on the {% data variables.product.prodname_ghe_server %} appliance. Organization administrators can require 2FA to be enabled for members of the organization.                                                    |
+| SAML                                              | Authentication is performed on an external identity provider.                                                                          | {% data reusables.two_fa.2fa_not_supported_with_saml_and_cas %}
+| CAS                                               | Single sign-on service is provided by an external server.                                                                              | {% data reusables.two_fa.2fa_not_supported_with_saml_and_cas %}{% endif %}
diff --git a/translations/ko-KR/data/reusables/user_settings/export-data.md b/translations/ko-KR/data/reusables/user_settings/export-data.md
index 829998c0239c..857cba63b9c9 100644
--- a/translations/ko-KR/data/reusables/user_settings/export-data.md
+++ b/translations/ko-KR/data/reusables/user_settings/export-data.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-You can export and review the metadata that {% data variables.product.product_name %} stores about your personal account.
+You can export and review the metadata that
+{% data variables.product.product_name %} stores about your personal account.
 {% endif %}
diff --git a/translations/ko-KR/data/reusables/user_settings/password-authentication-deprecation.md b/translations/ko-KR/data/reusables/user_settings/password-authentication-deprecation.md
index 247a5f7442f4..ade0a4e28d59 100644
--- a/translations/ko-KR/data/reusables/user_settings/password-authentication-deprecation.md
+++ b/translations/ko-KR/data/reusables/user_settings/password-authentication-deprecation.md
@@ -1 +1 @@
-Password-based authentication for Git is deprecated, and we recommend using a personal access token (PAT) when prompted for a password instead, which is more secure. Treat your token just like a password. For more information, see "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token)."
\ No newline at end of file
+Password-based authentication for Git is deprecated, and we recommend using a personal access token (PAT) when prompted for a password instead, which is more secure. Treat your token just like a password. For more information, see "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token)."
diff --git a/translations/ko-KR/data/reusables/user_settings/sudo-mode-popup.md b/translations/ko-KR/data/reusables/user_settings/sudo-mode-popup.md
index 5e8aad086348..32f716ffacac 100644
--- a/translations/ko-KR/data/reusables/user_settings/sudo-mode-popup.md
+++ b/translations/ko-KR/data/reusables/user_settings/sudo-mode-popup.md
@@ -1 +1 @@
-1. If prompted, confirm your {% data variables.product.product_name %} password. ![Sudo mode dialog](/assets/images/help/settings/sudo_mode_popup.png)
\ No newline at end of file
+1. If prompted, confirm your {% data variables.product.product_name %} password. ![Sudo mode dialog](/assets/images/help/settings/sudo_mode_popup.png)
diff --git a/translations/ko-KR/data/reusables/webhooks/action_type_desc.md b/translations/ko-KR/data/reusables/webhooks/action_type_desc.md
index 3342e6e1c6ec..43e5cb80e4f5 100644
--- a/translations/ko-KR/data/reusables/webhooks/action_type_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/action_type_desc.md
@@ -1 +1 @@
-The type of activity is specified in the `action` property of the payload object.
\ No newline at end of file
+The type of activity is specified in the `action` property of the payload object.
diff --git a/translations/ko-KR/data/reusables/webhooks/app_desc.md b/translations/ko-KR/data/reusables/webhooks/app_desc.md
index 9dbfd79e4d6f..e81bab2cf4dc 100644
--- a/translations/ko-KR/data/reusables/webhooks/app_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/app_desc.md
@@ -1 +1 @@
-`installation` | `object` | The {% data variables.product.prodname_github_app %} installation. Webhook payloads contain the `installation` property when the event is configured for and sent to a {% data variables.product.prodname_github_app %}.
\ No newline at end of file
+`installation` | `object` | The {% data variables.product.prodname_github_app %} installation. Webhook payloads contain the `installation` property when the event is configured for and sent to a {% data variables.product.prodname_github_app %}.
diff --git a/translations/ko-KR/data/reusables/webhooks/check_run_properties.md b/translations/ko-KR/data/reusables/webhooks/check_run_properties.md
index 8549c7bc45f8..e9769631cc51 100644
--- a/translations/ko-KR/data/reusables/webhooks/check_run_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/check_run_properties.md
@@ -1,10 +1,10 @@
-| 키                              | 유형        | 설명                                                                                                                                                                                                                                                                                                                    |
-| ------------------------------ | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `동작`                           | `문자열`     | The action performed. Can be one of: 
    •  `created` - A new check run was created.
    •  `completed` - The `status` of the check run is `completed`.
    •  `rerequested` - Someone requested to re-run your check run from the pull request UI. See "[About status checks](/articles/about-status-checks#checks)" for more details about the GitHub UI. When you receive a `rerequested` action, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run). Only the {% data variables.product.prodname_github_app %} that someone requests to re-run the check will receive the `rerequested` payload.
    •  `requested_action` - Someone requested an action your app provides to be taken. Only the {% data variables.product.prodname_github_app %} someone requests to perform an action will receive the `requested_action` payload. To learn more about check runs and requested actions, see "[Check runs and requested actions](/v3/checks/runs/#check-runs-and-requested-actions)."
                                                                                                                                                                                                                                                             |
-| `check_run`                    | `개체`      | The [check_run](/v3/checks/runs/#get-a-check-run).                                                                                                                                                                                                                                                                    |
-| `check_run[status]`            | `문자열`     | The current status of the check run. Can be `queued`, `in_progress`, or `completed`.                                                                                                                                                                                                                                  |
+| 키                              | 유형        | 설명                                                                                                                                                                                                                                                                                                                                                        |
+| ------------------------------ | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `동작`                           | `문자열`     | The action performed. Can be one of: 
    •  `created` - A new check run was created.
    •  `completed` - The `status` of the check run is `completed`.
    •  `rerequested` - Someone requested to re-run your check run from the pull request UI. See "[About status checks](/articles/about-status-checks#checks)" for more details about the GitHub UI. When you receive a `rerequested` action, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run). Only the {% data variables.product.prodname_github_app %} that someone requests to re-run the check will receive the `rerequested` payload.
    •  `requested_action` - Someone requested an action your app provides to be taken. Only the {% data variables.product.prodname_github_app %} someone requests to perform an action will receive the `requested_action` payload. To learn more about check runs and requested actions, see "[Check runs and requested actions](/v3/checks/runs/#check-runs-and-requested-actions)."
                                                                                                                                                                                                                                                                                                 |
+| `check_run`                    | `개체`      | The [check_run](/v3/checks/runs/#get-a-check-run).                                                                                                                                                                                                                                                                                                        |
+| `check_run[status]`            | `문자열`     | The current status of the check run. Can be `queued`, `in_progress`, or `completed`.                                                                                                                                                                                                                                                                      |
 | `check_run[conclusion]`        | `문자열`     | The result of the completed check run. Can be one of `success`, `failure`, `neutral`, `cancelled`, `timed_out`,  {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}`action_required` or `stale`{% else %}or `action_required`{% endif %}. This value will be `null` until the check run has `completed`. |
-| `check_run[name]`              | `문자열`     | The name of the check run.                                                                                                                                                                                                                                                                                            |
-| `check_run[check_suite][id]`   | `integer` | The id of the check suite that this check run is part of.                                                                                                                                                                                                                                                             |
-| `requested_action`             | `개체`      | The action requested by the user.                                                                                                                                                                                                                                                                                     |
-| `requested_action[identifier]` | `문자열`     | The integrator reference of the action requested by the user.                                                                                                                                                                                                                                                         |
\ No newline at end of file
+| `check_run[name]`              | `문자열`     | The name of the check run.                                                                                                                                                                                                                                                                                                                                |
+| `check_run[check_suite][id]`   | `integer` | The id of the check suite that this check run is part of.                                                                                                                                                                                                                                                                                                 |
+| `requested_action`             | `개체`      | The action requested by the user.                                                                                                                                                                                                                                                                                                                         |
+| `requested_action[identifier]` | `문자열`     | The integrator reference of the action requested by the user.                                                                                                                                                                                                                                                                                             |
diff --git a/translations/ko-KR/data/reusables/webhooks/check_run_short_desc.md b/translations/ko-KR/data/reusables/webhooks/check_run_short_desc.md
index 305bd1626e33..19fd0846b885 100644
--- a/translations/ko-KR/data/reusables/webhooks/check_run_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/check_run_short_desc.md
@@ -1 +1 @@
-Check run activity has occurred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[check runs](/v3/checks/runs/)" REST API.
\ No newline at end of file
+Check run activity has occurred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[check runs](/v3/checks/runs/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/check_suite_properties.md b/translations/ko-KR/data/reusables/webhooks/check_suite_properties.md
index 087030117dd9..4d05630160ec 100644
--- a/translations/ko-KR/data/reusables/webhooks/check_suite_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/check_suite_properties.md
@@ -1,10 +1,10 @@
-| 키                            | 유형      | 설명                                                                                                                                                                                                                                                                                                                                                         |
-| ---------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `동작`                         | `문자열`   | The action performed. Can be:
    • `completed` - All check runs in a check suite have completed.
    • `requested` - Occurs when new code is pushed to the app's repository. When you receive the `requested` action events, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run).
    • `rerequested` - Occurs when someone requests to re-run the entire check suite from the pull request UI. When you receive the `rerequested` action events, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run). See "[About status checks](/articles/about-status-checks#checks)" for more details about the GitHub UI.
                                                                                                                                                                                                                                                                                                         |
-| `check_suite`                | `개체`    | The [check_suite](/v3/checks/suites/).                                                                                                                                                                                                                                                                                                                     |
-| `check_suite[head_branch]`   | `문자열`   | The head branch name the changes are on.                                                                                                                                                                                                                                                                                                                   |
-| `check_suite[head_sha]`      | `문자열`   | The SHA of the most recent commit for this check suite.                                                                                                                                                                                                                                                                                                    |
-| `check_suite[status]`        | `문자열`   | The summary status for all check runs that are part of the check suite. Can be `requested`, `in_progress`, or `completed`.                                                                                                                                                                                                                                 |
+| 키                            | 유형      | 설명                                                                                                                                                                                                                                                                                                                                                                                             |
+| ---------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `동작`                         | `문자열`   | The action performed. Can be:
    • `completed` - All check runs in a check suite have completed.
    • `requested` - Occurs when new code is pushed to the app's repository. When you receive the `requested` action events, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run).
    • `rerequested` - Occurs when someone requests to re-run the entire check suite from the pull request UI. When you receive the `rerequested` action events, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run). See "[About status checks](/articles/about-status-checks#checks)" for more details about the GitHub UI.
                                                                                                                                                                                                                                                                                                                                             |
+| `check_suite`                | `개체`    | The [check_suite](/v3/checks/suites/).                                                                                                                                                                                                                                                                                                                                                         |
+| `check_suite[head_branch]`   | `문자열`   | The head branch name the changes are on.                                                                                                                                                                                                                                                                                                                                                       |
+| `check_suite[head_sha]`      | `문자열`   | The SHA of the most recent commit for this check suite.                                                                                                                                                                                                                                                                                                                                        |
+| `check_suite[status]`        | `문자열`   | The summary status for all check runs that are part of the check suite. Can be `requested`, `in_progress`, or `completed`.                                                                                                                                                                                                                                                                     |
 | `check_suite[conclusion]`    | `문자열`   | The summary conclusion for all check runs that are part of the check suite. Can be one of `success`, `failure`, `neutral`, `cancelled`, `timed_out`,  {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}`action_required` or `stale`{% else %}or `action_required`{% endif %}. This value will be `null` until the check run has `completed`. |
-| `check_suite[url]`           | `문자열`   | URL that points to the check suite API resource.                                                                                                                                                                                                                                                                                                           |
-| `check_suite[pull_requests]` | `array` | An array of pull requests that match this check suite. A pull request matches a check suite if they have the same `head_sha` and `head_branch`. When the check suite's `head_branch` is in a forked repository it will be `null` and the `pull_requests` array will be empty.                                                                              |
\ No newline at end of file
+| `check_suite[url]`           | `문자열`   | URL that points to the check suite API resource.                                                                                                                                                                                                                                                                                                                                               |
+| `check_suite[pull_requests]` | `array` | An array of pull requests that match this check suite. A pull request matches a check suite if they have the same `head_sha` and `head_branch`. When the check suite's `head_branch` is in a forked repository it will be `null` and the `pull_requests` array will be empty.                                                                                                                  |
diff --git a/translations/ko-KR/data/reusables/webhooks/check_suite_short_desc.md b/translations/ko-KR/data/reusables/webhooks/check_suite_short_desc.md
index f7197fc59e48..00c4c00937f9 100644
--- a/translations/ko-KR/data/reusables/webhooks/check_suite_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/check_suite_short_desc.md
@@ -1 +1 @@
-Check suite activity has occurred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[check suites](/v3/checks/suites/)" REST API.
\ No newline at end of file
+Check suite activity has occurred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[check suites](/v3/checks/suites/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/code_scanning_alert_event_short_desc.md b/translations/ko-KR/data/reusables/webhooks/code_scanning_alert_event_short_desc.md
index e246022ed42e..e5163ce2d013 100644
--- a/translations/ko-KR/data/reusables/webhooks/code_scanning_alert_event_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/code_scanning_alert_event_short_desc.md
@@ -1 +1 @@
-Activity related to code scanning alerts in a repository. The type of activity is specified in the action property of the payload object. For more information, see “[About code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning).”
\ No newline at end of file
+Activity related to code scanning alerts in a repository. The type of activity is specified in the action property of the payload object. For more information, see “[About code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning).”
diff --git a/translations/ko-KR/data/reusables/webhooks/commit_comment_properties.md b/translations/ko-KR/data/reusables/webhooks/commit_comment_properties.md
index 6e7e97251a54..ba4d31184d10 100644
--- a/translations/ko-KR/data/reusables/webhooks/commit_comment_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/commit_comment_properties.md
@@ -1,4 +1,4 @@
 | 키    | 유형    | 설명                                                                       |
 | ---- | ----- | ------------------------------------------------------------------------ |
 | `동작` | `문자열` | The action performed. Can be `created`.                                  |
-| `의견` | `개체`  | The [commit comment](/v3/repos/comments/#get-a-commit-comment) resource. |
\ No newline at end of file
+| `의견` | `개체`  | The [commit comment](/v3/repos/comments/#get-a-commit-comment) resource. |
diff --git a/translations/ko-KR/data/reusables/webhooks/commit_comment_short_desc.md b/translations/ko-KR/data/reusables/webhooks/commit_comment_short_desc.md
index 918e0279b925..20e258a1ea1f 100644
--- a/translations/ko-KR/data/reusables/webhooks/commit_comment_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/commit_comment_short_desc.md
@@ -1 +1 @@
-A commit comment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[commit comment](/v3/repos/comments/)" REST API.
\ No newline at end of file
+A commit comment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[commit comment](/v3/repos/comments/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/content_reference_short_desc.md b/translations/ko-KR/data/reusables/webhooks/content_reference_short_desc.md
index b7880d039d3a..5187dbb40bc8 100644
--- a/translations/ko-KR/data/reusables/webhooks/content_reference_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/content_reference_short_desc.md
@@ -1 +1 @@
-A new content reference is `created`. A new content reference is created when the body or comment of an issue or pull request includes a URL that matches a configured content reference domain. For more information, see "[Using content attachments](/apps/using-content-attachments/)" to learn more about content references and attachments.
\ No newline at end of file
+A new content reference is `created`. A new content reference is created when the body or comment of an issue or pull request includes a URL that matches a configured content reference domain. For more information, see "[Using content attachments](/apps/using-content-attachments/)" to learn more about content references and attachments.
diff --git a/translations/ko-KR/data/reusables/webhooks/create_properties.md b/translations/ko-KR/data/reusables/webhooks/create_properties.md
index 13f932e361ec..9db3dd7722df 100644
--- a/translations/ko-KR/data/reusables/webhooks/create_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/create_properties.md
@@ -1,6 +1,6 @@
-| 키               | 유형    | 설명                                                                                                                                                                                                   |
-| --------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `ref`           | `문자열` | {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}The [`git ref`](/v3/git/refs/#get-a-reference) resource.{% else %}The [`git ref`](/v3/git/refs/#get-a-reference) resource.{% endif %}
-| `ref_type`      | `문자열` | The type of Git ref object created in the repository. Can be either `branch` or `tag`.                                                                                                               |
-| `master_branch` | `문자열` | The name of the repository's default branch (usually `master`).                                                                                                                                      |
-| `설명`            | `문자열` | The repository's current description.                                                                                                                                                                |
\ No newline at end of file
+| 키               | 유형    | 설명                                                                                                                                                                                            |
+| --------------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `ref`           | `문자열` | The [`git ref`](/v3/git/refs/#get-a-reference) resource.                                                                                                                                      |
+| `ref_type`      | `문자열` | The type of Git ref object created in the repository. Can be either `branch` or `tag`.                                                                                                        |
+| `master_branch` | `문자열` | The name of the repository's default branch (usually {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.23" %}`main`{% else %}`master`{% endif %}). |
+| `설명`            | `문자열` | The repository's current description.                                                                                                                                                         |
diff --git a/translations/ko-KR/data/reusables/webhooks/create_short_desc.md b/translations/ko-KR/data/reusables/webhooks/create_short_desc.md
index 0140bfadf5c2..a43ab3994391 100644
--- a/translations/ko-KR/data/reusables/webhooks/create_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/create_short_desc.md
@@ -1 +1 @@
-A Git branch or tag is created. For more information, see the "[Git data](/v3/git/)" REST API.
\ No newline at end of file
+A Git branch or tag is created. For more information, see the "[Git data](/v3/git/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/delete_properties.md b/translations/ko-KR/data/reusables/webhooks/delete_properties.md
index cfdc1e51f1c1..2e175627aa1b 100644
--- a/translations/ko-KR/data/reusables/webhooks/delete_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/delete_properties.md
@@ -1,4 +1,4 @@
-| 키          | 유형    | 설명                                                                                                                                                                                                   |
-| ---------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `ref`      | `문자열` | {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}The [`git ref`](/v3/git/refs/#get-a-reference) resource.{% else %}The [`git ref`](/v3/git/refs/#get-a-reference) resource.{% endif %}
-| `ref_type` | `문자열` | The type of Git ref oject deleted in the repository. Can be `branch` or `tag`.                                                                                                                       |
\ No newline at end of file
+| 키          | 유형    | 설명                                                                             |
+| ---------- | ----- | ------------------------------------------------------------------------------ |
+| `ref`      | `문자열` | The [`git ref`](/v3/git/refs/#get-a-reference) resource.                       |
+| `ref_type` | `문자열` | The type of Git ref oject deleted in the repository. Can be `branch` or `tag`. |
diff --git a/translations/ko-KR/data/reusables/webhooks/delete_short_desc.md b/translations/ko-KR/data/reusables/webhooks/delete_short_desc.md
index 60568e8b0958..7557d8e4edb3 100644
--- a/translations/ko-KR/data/reusables/webhooks/delete_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/delete_short_desc.md
@@ -1 +1 @@
-A Git branch or tag is deleted. For more information, see the "[Git data](/v3/git/)" REST API.
\ No newline at end of file
+A Git branch or tag is deleted. For more information, see the "[Git data](/v3/git/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/deploy_key_properties.md b/translations/ko-KR/data/reusables/webhooks/deploy_key_properties.md
index 19ad70e967ad..ed2b560f1de2 100644
--- a/translations/ko-KR/data/reusables/webhooks/deploy_key_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/deploy_key_properties.md
@@ -1,4 +1,4 @@
 | 키    | 유형    | 설명                                                             |
 | ---- | ----- | -------------------------------------------------------------- |
 | `동작` | `문자열` | The action performed. Can be either `created` or `deleted`.    |
-| `키`  | `개체`  | The [`deploy key`](/v3/repos/keys/#get-a-deploy-key) resource. |
\ No newline at end of file
+| `키`  | `개체`  | The [`deploy key`](/v3/repos/keys/#get-a-deploy-key) resource. |
diff --git a/translations/ko-KR/data/reusables/webhooks/deploy_key_short_desc.md b/translations/ko-KR/data/reusables/webhooks/deploy_key_short_desc.md
index 551eef44c5cc..c83fe68579c6 100644
--- a/translations/ko-KR/data/reusables/webhooks/deploy_key_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/deploy_key_short_desc.md
@@ -1 +1 @@
-A deploy key is added or removed from a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[Deploy keys](/v3/repos/keys/)" REST API.
\ No newline at end of file
+A deploy key is added or removed from a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[Deploy keys](/v3/repos/keys/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/deployment_short_desc.md b/translations/ko-KR/data/reusables/webhooks/deployment_short_desc.md
index 75683350b9df..249535a29dc8 100644
--- a/translations/ko-KR/data/reusables/webhooks/deployment_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/deployment_short_desc.md
@@ -1 +1 @@
-A deployment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[deployment](/v3/repos/deployments/#list-deployments)" REST API.
\ No newline at end of file
+A deployment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[deployment](/rest/reference/repos#list-deployments)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/deployment_status_short_desc.md b/translations/ko-KR/data/reusables/webhooks/deployment_status_short_desc.md
index 11953ea072e4..d58bd3e0efed 100644
--- a/translations/ko-KR/data/reusables/webhooks/deployment_status_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/deployment_status_short_desc.md
@@ -1 +1 @@
-A deployment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[deployment statuses](/v3/repos/deployments/#list-deployment-statuses)" REST API.
\ No newline at end of file
+A deployment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[deployment statuses](/rest/reference/repos#list-deployment-statuses)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/enterprise_short_desc.md b/translations/ko-KR/data/reusables/webhooks/enterprise_short_desc.md
index 999949bcbb50..07659be69c50 100644
--- a/translations/ko-KR/data/reusables/webhooks/enterprise_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/enterprise_short_desc.md
@@ -1 +1 @@
-A site or repository administrator enables or disables anonymous Git read access. See "[Allowing admins to enable anonymous Git read access to public repositories](/enterprise/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories)" for more details. This event is not available in the Events API.
\ No newline at end of file
+A site or repository administrator enables or disables anonymous Git read access. See "[Allowing admins to enable anonymous Git read access to public repositories](/enterprise/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories)" for more details. This event is not available in the Events API.
diff --git a/translations/ko-KR/data/reusables/webhooks/events_api_payload.md b/translations/ko-KR/data/reusables/webhooks/events_api_payload.md
index b40c9904faf8..d63dfb496eb9 100644
--- a/translations/ko-KR/data/reusables/webhooks/events_api_payload.md
+++ b/translations/ko-KR/data/reusables/webhooks/events_api_payload.md
@@ -1 +1 @@
-The [event object](#event-object-common-properties) includes properties that are common for all events. Each event object includes a `payload` property and the value is unique to each event type. The `payload` object for this event is described below.
\ No newline at end of file
+The [event object](#event-object-common-properties) includes properties that are common for all events. Each event object includes a `payload` property and the value is unique to each event type. The `payload` object for this event is described below.
diff --git a/translations/ko-KR/data/reusables/webhooks/fork_properties.md b/translations/ko-KR/data/reusables/webhooks/fork_properties.md
index f4863706c636..986947343071 100644
--- a/translations/ko-KR/data/reusables/webhooks/fork_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/fork_properties.md
@@ -1,3 +1,3 @@
 | 키        | 유형   | 설명                                                                |
 | -------- | ---- | ----------------------------------------------------------------- |
-| `forkee` | `개체` | The created [`repository`](/v3/repos/#get-a-repository) resource. |
\ No newline at end of file
+| `forkee` | `개체` | The created [`repository`](/v3/repos/#get-a-repository) resource. |
diff --git a/translations/ko-KR/data/reusables/webhooks/fork_short_desc.md b/translations/ko-KR/data/reusables/webhooks/fork_short_desc.md
index a294851f9c96..60f88625b01f 100644
--- a/translations/ko-KR/data/reusables/webhooks/fork_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/fork_short_desc.md
@@ -1 +1 @@
-A user forks a repository. For more information, see the "[forks](/v3/repos/forks/)" REST API.
\ No newline at end of file
+A user forks a repository. For more information, see the "[forks](/v3/repos/forks/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/gollum_properties.md b/translations/ko-KR/data/reusables/webhooks/gollum_properties.md
index af04884108fe..12898e1c6434 100644
--- a/translations/ko-KR/data/reusables/webhooks/gollum_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/gollum_properties.md
@@ -5,4 +5,4 @@
 | `pages[][title]`     | `문자열`   | The current page title.                                                  |
 | `pages[][action]`    | `문자열`   | The action that was performed on the page. Can be `created` or `edited`. |
 | `pages[][sha]`       | `문자열`   | The latest commit SHA of the page.                                       |
-| `pages[][html_url]`  | `문자열`   | Points to the HTML wiki page.                                            |
\ No newline at end of file
+| `pages[][html_url]`  | `문자열`   | Points to the HTML wiki page.                                            |
diff --git a/translations/ko-KR/data/reusables/webhooks/gollum_short_desc.md b/translations/ko-KR/data/reusables/webhooks/gollum_short_desc.md
index 88d8dacb57e5..03bef9d2699c 100644
--- a/translations/ko-KR/data/reusables/webhooks/gollum_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/gollum_short_desc.md
@@ -1 +1 @@
-A wiki page is created or updated. For more information, see the "[About wikis](/github/building-a-strong-community/about-wikis)".
\ No newline at end of file
+A wiki page is created or updated. For more information, see the "[About wikis](/github/building-a-strong-community/about-wikis)".
diff --git a/translations/ko-KR/data/reusables/webhooks/installation_properties.md b/translations/ko-KR/data/reusables/webhooks/installation_properties.md
index 3d475b7d2d4b..97b4d2685f0e 100644
--- a/translations/ko-KR/data/reusables/webhooks/installation_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/installation_properties.md
@@ -1,4 +1,4 @@
 | 키              | 유형      | 설명                                                                     |
 | -------------- | ------- | ---------------------------------------------------------------------- |
 | `동작`           | `문자열`   | The action that was performed. Can be one of:
    • `created` - Someone installs a {% data variables.product.prodname_github_app %}.
    • `deleted` - Someone uninstalls a {% data variables.product.prodname_github_app %}
      • {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}
    • `suspend` - Someone suspends a {% data variables.product.prodname_github_app %} installation.
    • `unsuspend` - Someone unsuspends a {% data variables.product.prodname_github_app %} installation.
      • {% endif %}
    • `new_permissions_accepted` - Someone accepts new permissions for a {% data variables.product.prodname_github_app %} installation. When a {% data variables.product.prodname_github_app %} owner requests new permissions, the person who installed the {% data variables.product.prodname_github_app %} must accept the new permissions request. 
     |
-| `repositories` | `array` | An array of repository objects that the insatllation can access.       |
\ No newline at end of file
+| `repositories` | `array` | An array of repository objects that the insatllation can access.       |
diff --git a/translations/ko-KR/data/reusables/webhooks/installation_repositories_properties.md b/translations/ko-KR/data/reusables/webhooks/installation_repositories_properties.md
index 63dde0520393..09d34ec2c2a6 100644
--- a/translations/ko-KR/data/reusables/webhooks/installation_repositories_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/installation_repositories_properties.md
@@ -3,4 +3,4 @@
 | `동작`                   | `문자열`   | The action that was performed. Can be either `added` or `removed`.                    |
 | `repository_selection` | `문자열`   | The choice of repositories the installation is on. Can be either `selected` or `all`. |
 | `repositories_added`   | `array` | An array of repository objects, which were added to the installation.                 |
-| `repositories_removed` | `array` | An array of repository objects, which were removed from the installation.             |
\ No newline at end of file
+| `repositories_removed` | `array` | An array of repository objects, which were removed from the installation.             |
diff --git a/translations/ko-KR/data/reusables/webhooks/installation_repositories_short_desc.md b/translations/ko-KR/data/reusables/webhooks/installation_repositories_short_desc.md
index b01eeca22efe..63166ba6e220 100644
--- a/translations/ko-KR/data/reusables/webhooks/installation_repositories_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/installation_repositories_short_desc.md
@@ -1 +1 @@
-Activity related to repositories being added to a GitHub App installation. {% data reusables.webhooks.action_type_desc %} For more information, see the "[GitHub App installation](/v3/apps/)" REST API.
\ No newline at end of file
+Activity related to repositories being added to a GitHub App installation. {% data reusables.webhooks.action_type_desc %} For more information, see the "[GitHub App installation](/v3/apps/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/installation_short_desc.md b/translations/ko-KR/data/reusables/webhooks/installation_short_desc.md
index 0a19aef9b5d0..4abc1de643b4 100644
--- a/translations/ko-KR/data/reusables/webhooks/installation_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/installation_short_desc.md
@@ -1 +1 @@
-Activity related to a GitHub App installation. {% data reusables.webhooks.action_type_desc %} For more information, see the "[GitHub App installation](/v3/apps/)" REST API.
\ No newline at end of file
+Activity related to a GitHub App installation. {% data reusables.webhooks.action_type_desc %} For more information, see the "[GitHub App installation](/v3/apps/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/issue_comment_properties.md b/translations/ko-KR/data/reusables/webhooks/issue_comment_properties.md
index 1cc3962f11bf..b983deb16f16 100644
--- a/translations/ko-KR/data/reusables/webhooks/issue_comment_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/issue_comment_properties.md
@@ -1 +1 @@
-`changes`|`object` | The changes to the comment if the action was `edited`. `changes[body][from]` |`string` | The previous version of the body if the action was `edited`. `issue`|`object` | The [issue](/v3/issues/) the comment belongs to. `comment`|`object` | The [comment](/v3/issues/comments/) itself.
\ No newline at end of file
+`changes`|`object` | The changes to the comment if the action was `edited`. `changes[body][from]` |`string` | The previous version of the body if the action was `edited`. `issue`|`object` | The [issue](/v3/issues/) the comment belongs to. `comment`|`object` | The [comment](/v3/issues/comments/) itself.
diff --git a/translations/ko-KR/data/reusables/webhooks/issue_comment_short_desc.md b/translations/ko-KR/data/reusables/webhooks/issue_comment_short_desc.md
index 0c12ec707b62..cc07764d1919 100644
--- a/translations/ko-KR/data/reusables/webhooks/issue_comment_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/issue_comment_short_desc.md
@@ -1 +1 @@
-Activity related to an issue comment. {% data reusables.webhooks.action_type_desc %} For more information, see the "[issue comments](/v3/issues/comments/)" REST API.
\ No newline at end of file
+Activity related to an issue comment. {% data reusables.webhooks.action_type_desc %} For more information, see the "[issue comments](/v3/issues/comments/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/issue_comment_webhook_properties.md b/translations/ko-KR/data/reusables/webhooks/issue_comment_webhook_properties.md
index b2aa7f0d3984..6cbe445e3c83 100644
--- a/translations/ko-KR/data/reusables/webhooks/issue_comment_webhook_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/issue_comment_webhook_properties.md
@@ -1,3 +1,3 @@
 | 키    | 유형    | 설명                                                                                             |
 | ---- | ----- | ---------------------------------------------------------------------------------------------- |
-| `동작` | `문자열` | The action that was performed on the comment. Can be one of `created`, `edited`, or `deleted`. |
\ No newline at end of file
+| `동작` | `문자열` | The action that was performed on the comment. Can be one of `created`, `edited`, or `deleted`. |
diff --git a/translations/ko-KR/data/reusables/webhooks/issue_event_api_properties.md b/translations/ko-KR/data/reusables/webhooks/issue_event_api_properties.md
index e6f8a29c6eca..5abdf4524e89 100644
--- a/translations/ko-KR/data/reusables/webhooks/issue_event_api_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/issue_event_api_properties.md
@@ -1,3 +1,3 @@
 | 키    | 유형    | 설명                                                                                                                                |
 | ---- | ----- | --------------------------------------------------------------------------------------------------------------------------------- |
-| `동작` | `문자열` | The action that was performed. Can be one of `opened`, `closed`, `reopened`, `assigned`, `unassigned`, `labeled`, or `unlabeled`. |
\ No newline at end of file
+| `동작` | `문자열` | The action that was performed. Can be one of `opened`, `closed`, `reopened`, `assigned`, `unassigned`, `labeled`, or `unlabeled`. |
diff --git a/translations/ko-KR/data/reusables/webhooks/issue_properties.md b/translations/ko-KR/data/reusables/webhooks/issue_properties.md
index 84db05eb2bfe..c146faa96802 100644
--- a/translations/ko-KR/data/reusables/webhooks/issue_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/issue_properties.md
@@ -1 +1 @@
-`issue`|`object` | The [issue](/v3/issues) itself. `changes`|`object`| The changes to the issue if the action was `edited`. `changes[title][from]`|`string` | The previous version of the title if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `assignee`|`object` | The optional user who was assigned or unassigned from the issue. `label`|`object` | The optional label that was added or removed from the issue.
\ No newline at end of file
+`issue`|`object` | The [issue](/v3/issues) itself. `changes`|`object`| The changes to the issue if the action was `edited`. `changes[title][from]`|`string` | The previous version of the title if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `assignee`|`object` | The optional user who was assigned or unassigned from the issue. `label`|`object` | The optional label that was added or removed from the issue.
diff --git a/translations/ko-KR/data/reusables/webhooks/issue_webhook_properties.md b/translations/ko-KR/data/reusables/webhooks/issue_webhook_properties.md
index 47e3ef07db1d..76160560270b 100644
--- a/translations/ko-KR/data/reusables/webhooks/issue_webhook_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/issue_webhook_properties.md
@@ -1,3 +1,3 @@
 | 키    | 유형    | 설명                                                                                                                                                                                                                                               |
 | ---- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `동작` | `문자열` | The action that was performed. Can be one of `opened`, `edited`, `deleted`, `pinned`, `unpinned`, `closed`, `reopened`, `assigned`, `unassigned`, `labeled`, `unlabeled`, `locked`, `unlocked`,  `transferred`, `milestoned`, or `demilestoned`. |
\ No newline at end of file
+| `동작` | `문자열` | The action that was performed. Can be one of `opened`, `edited`, `deleted`, `pinned`, `unpinned`, `closed`, `reopened`, `assigned`, `unassigned`, `labeled`, `unlabeled`, `locked`, `unlocked`,  `transferred`, `milestoned`, or `demilestoned`. |
diff --git a/translations/ko-KR/data/reusables/webhooks/issues_short_desc.md b/translations/ko-KR/data/reusables/webhooks/issues_short_desc.md
index fea9fc0cfcd8..7dadec073bb6 100644
--- a/translations/ko-KR/data/reusables/webhooks/issues_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/issues_short_desc.md
@@ -1 +1 @@
-Activity related to an issue. {% data reusables.webhooks.action_type_desc %} For more information, see the "[issues](/v3/issues/comments/)" REST API.
\ No newline at end of file
+Activity related to an issue. {% data reusables.webhooks.action_type_desc %} For more information, see the "[issues](/v3/issues/comments/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/label_short_desc.md b/translations/ko-KR/data/reusables/webhooks/label_short_desc.md
index ca095139a6d2..c5f7178d8a4c 100644
--- a/translations/ko-KR/data/reusables/webhooks/label_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/label_short_desc.md
@@ -1 +1 @@
-Activity related to an issue. {% data reusables.webhooks.action_type_desc %} For more information, see the "[labels](/v3/issues/labels/)" REST API.
\ No newline at end of file
+Activity related to an issue. {% data reusables.webhooks.action_type_desc %} For more information, see the "[labels](/v3/issues/labels/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/member_event_api_properties.md b/translations/ko-KR/data/reusables/webhooks/member_event_api_properties.md
index edcd9c36d5e5..21850735ad31 100644
--- a/translations/ko-KR/data/reusables/webhooks/member_event_api_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/member_event_api_properties.md
@@ -1,3 +1,3 @@
 | 키    | 유형    | 설명                                                                                                       |
 | ---- | ----- | -------------------------------------------------------------------------------------------------------- |
-| `동작` | `문자열` | The action that was performed. Can be `added` to indicate a user accepted an invitation to a repository. |
\ No newline at end of file
+| `동작` | `문자열` | The action that was performed. Can be `added` to indicate a user accepted an invitation to a repository. |
diff --git a/translations/ko-KR/data/reusables/webhooks/member_properties.md b/translations/ko-KR/data/reusables/webhooks/member_properties.md
index 7fde9d65f4b7..d9e1757f404e 100644
--- a/translations/ko-KR/data/reusables/webhooks/member_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/member_properties.md
@@ -1 +1 @@
-`member`|`object` | The [user](/v3/users/) that was added. `changes`|`object`| The changes to the collaborator permissions if the action was `edited`. `changes[old_permission][from]`|`string` | The previous permissions of the collaborator if the action was `edited`.
\ No newline at end of file
+`member`|`object` | The [user](/v3/users/) that was added. `changes`|`object`| The changes to the collaborator permissions if the action was `edited`. `changes[old_permission][from]`|`string` | The previous permissions of the collaborator if the action was `edited`.
diff --git a/translations/ko-KR/data/reusables/webhooks/member_short_desc.md b/translations/ko-KR/data/reusables/webhooks/member_short_desc.md
index 9447f245ed0a..2e8289677381 100644
--- a/translations/ko-KR/data/reusables/webhooks/member_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/member_short_desc.md
@@ -1 +1 @@
-Activity related to repository collaborators. {% data reusables.webhooks.action_type_desc %} For more information, see the "[collaborators](/v3/repos/collaborators/)" REST API.
\ No newline at end of file
+Activity related to repository collaborators. {% data reusables.webhooks.action_type_desc %} For more information, see the "[collaborators](/v3/repos/collaborators/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/member_webhook_properties.md b/translations/ko-KR/data/reusables/webhooks/member_webhook_properties.md
index ae57c1b4b8a8..d03ca487bdf2 100644
--- a/translations/ko-KR/data/reusables/webhooks/member_webhook_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/member_webhook_properties.md
@@ -1,3 +1,3 @@
 | 키    | 유형    | 설명                                                                     |
 | ---- | ----- | ---------------------------------------------------------------------- |
-| `동작` | `문자열` | The action that was performed. Can be one of:
    •  `added` - A user accepts an invitation to a repository.
    • `removed` - A user is removed as a collaborator in a repository.
    • `edited` - A user's collaborator permissios have changed. 
     |
\ No newline at end of file
+| `동작` | `문자열` | The action that was performed. Can be one of:
    •  `added` - A user accepts an invitation to a repository.
    • `removed` - A user is removed as a collaborator in a repository.
    • `edited` - A user's collaborator permissios have changed. 
     |
diff --git a/translations/ko-KR/data/reusables/webhooks/membership_properties.md b/translations/ko-KR/data/reusables/webhooks/membership_properties.md
index 3f9c8bb1ccf8..6869d846fccd 100644
--- a/translations/ko-KR/data/reusables/webhooks/membership_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/membership_properties.md
@@ -3,4 +3,4 @@
 | `동작`  | `문자열` | The action that was performed. Can be `added` or `removed`. |
 | `범위`  | `문자열` | The scope of the membership. Currently, can only be `team`. |
 | `구성원` | `개체`  | The [user](/v3/users/) that was added or removed.           |
-| `팀`   | `개체`  | The [team](/v3/teams/) for the membership.                  |
\ No newline at end of file
+| `팀`   | `개체`  | The [team](/v3/teams/) for the membership.                  |
diff --git a/translations/ko-KR/data/reusables/webhooks/membership_short_desc.md b/translations/ko-KR/data/reusables/webhooks/membership_short_desc.md
index 4ffa7e0d72c0..e557eea9026a 100644
--- a/translations/ko-KR/data/reusables/webhooks/membership_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/membership_short_desc.md
@@ -1 +1 @@
-Activity related to team membership. {% data reusables.webhooks.action_type_desc %} For more information, see the "[team members](/v3/teams/members/)" REST API.
\ No newline at end of file
+Activity related to team membership. {% data reusables.webhooks.action_type_desc %} For more information, see the "[team members](/v3/teams/members/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/milestone_properties.md b/translations/ko-KR/data/reusables/webhooks/milestone_properties.md
index f6ea842c8cf9..e912e2f7c729 100644
--- a/translations/ko-KR/data/reusables/webhooks/milestone_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/milestone_properties.md
@@ -5,4 +5,4 @@
 | `changes`                    | `개체`  | The changes to the milestone if the action was `edited`.                                            |
 | `changes[description][from]` | `문자열` | The previous version of the description if the action was `edited`.                                 |
 | `changes[due_on][from]`      | `문자열` | The previous version of the due date if the action was `edited`.                                    |
-| `changes[title][from]`       | `문자열` | The previous version of the title if the action was `edited`.                                       |
\ No newline at end of file
+| `changes[title][from]`       | `문자열` | The previous version of the title if the action was `edited`.                                       |
diff --git a/translations/ko-KR/data/reusables/webhooks/milestone_short_desc.md b/translations/ko-KR/data/reusables/webhooks/milestone_short_desc.md
index 0e6f857a512a..6b6bd073ceab 100644
--- a/translations/ko-KR/data/reusables/webhooks/milestone_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/milestone_short_desc.md
@@ -1 +1 @@
-Activity related to milestones. {% data reusables.webhooks.action_type_desc %} For more information, see the "[milestones](/v3/issues/milestones/)" REST API.
\ No newline at end of file
+Activity related to milestones. {% data reusables.webhooks.action_type_desc %} For more information, see the "[milestones](/v3/issues/milestones/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/org_block_short_desc.md b/translations/ko-KR/data/reusables/webhooks/org_block_short_desc.md
index 379de19da9fc..7c3896f63c8d 100644
--- a/translations/ko-KR/data/reusables/webhooks/org_block_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/org_block_short_desc.md
@@ -1 +1 @@
-Activity related to people being blocked in an organization. {% data reusables.webhooks.action_type_desc %} For more information, see the "[blocking organization users](/v3/orgs/blocking/)" REST API.
\ No newline at end of file
+Activity related to people being blocked in an organization. {% data reusables.webhooks.action_type_desc %} For more information, see the "[blocking organization users](/v3/orgs/blocking/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/org_desc.md b/translations/ko-KR/data/reusables/webhooks/org_desc.md
index e763e6d6b614..8b344e764cde 100644
--- a/translations/ko-KR/data/reusables/webhooks/org_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/org_desc.md
@@ -1 +1 @@
-`organization` | `object` | Webhook payloads contain the [`organization`](/v3/orgs/#get-an-organization) object when the webhook is configured for an organization or the event occurs from activity in a repository owned by an organization.
\ No newline at end of file
+`organization` | `object` | Webhook payloads contain the [`organization`](/v3/orgs/#get-an-organization) object when the webhook is configured for an organization or the event occurs from activity in a repository owned by an organization.
diff --git a/translations/ko-KR/data/reusables/webhooks/organization_short_desc.md b/translations/ko-KR/data/reusables/webhooks/organization_short_desc.md
index 131d20fc3de8..895b584aaf26 100644
--- a/translations/ko-KR/data/reusables/webhooks/organization_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/organization_short_desc.md
@@ -1 +1 @@
-Activity related to an organization and its members. {% data reusables.webhooks.action_type_desc %} For more information, see the "[organizations](/v3/orgs/)" REST API.
\ No newline at end of file
+Activity related to an organization and its members. {% data reusables.webhooks.action_type_desc %} For more information, see the "[organizations](/v3/orgs/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/package_properties.md b/translations/ko-KR/data/reusables/webhooks/package_properties.md
index bdd2425a375f..c8f1e886132e 100644
--- a/translations/ko-KR/data/reusables/webhooks/package_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/package_properties.md
@@ -1,4 +1,4 @@
 | 키     | 유형    | 설명                                                              |
 | ----- | ----- | --------------------------------------------------------------- |
 | `동작`  | `문자열` | The action that was performed. Can be `published` or `updated`. |
-| `패키지` | `개체`  | Information about the package.                                  |
\ No newline at end of file
+| `패키지` | `개체`  | Information about the package.                                  |
diff --git a/translations/ko-KR/data/reusables/webhooks/page_build_short_desc.md b/translations/ko-KR/data/reusables/webhooks/page_build_short_desc.md
index 7c5be712c388..dda5755d8870 100644
--- a/translations/ko-KR/data/reusables/webhooks/page_build_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/page_build_short_desc.md
@@ -1 +1 @@
-Represents an attempted build of a GitHub Pages site, whether successful or not. A push to a GitHub Pages enabled branch (`gh-pages` for project pages, `master` for user and organization pages) triggers this event.
\ No newline at end of file
+Represents an attempted build of a {% data variables.product.prodname_pages %} site, whether successful or not. A push to a {% data variables.product.prodname_pages %} enabled branch (`gh-pages` for project pages, the default branch for user and organization pages) triggers this event.
diff --git a/translations/ko-KR/data/reusables/webhooks/payload_url.md b/translations/ko-KR/data/reusables/webhooks/payload_url.md
index 3a3fde655ce3..f48cdfee0e5c 100644
--- a/translations/ko-KR/data/reusables/webhooks/payload_url.md
+++ b/translations/ko-KR/data/reusables/webhooks/payload_url.md
@@ -1 +1 @@
-The payload URL is the URL of the server that will receive the webhook `POST` requests.
\ No newline at end of file
+The payload URL is the URL of the server that will receive the webhook `POST` requests.
diff --git a/translations/ko-KR/data/reusables/webhooks/ping_short_desc.md b/translations/ko-KR/data/reusables/webhooks/ping_short_desc.md
index 8cdd735b78c5..139c6735e2fd 100644
--- a/translations/ko-KR/data/reusables/webhooks/ping_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/ping_short_desc.md
@@ -1 +1 @@
-When you create a new webhook, we'll send you a simple `ping` event to let you know you've set up the webhook correctly. This event isnt stored so it isn't retrievable via the [Events API](/v3/activity/events/). You can trigger a `ping` again by calling the [Ping a repository webhook](/v3/repos/hooks/#ping-a-repository-webhook) endpoint.
+When you create a new webhook, we'll send you a simple `ping` event to let you know you've set up the webhook correctly. This event isnt stored so it isn't retrievable via the [Events API](/rest/reference/activity#ping-a-repository-webhook) endpoint.
diff --git a/translations/ko-KR/data/reusables/webhooks/project_card_properties.md b/translations/ko-KR/data/reusables/webhooks/project_card_properties.md
index 6f85bc8dd216..668ce5ae4268 100644
--- a/translations/ko-KR/data/reusables/webhooks/project_card_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/project_card_properties.md
@@ -4,4 +4,4 @@
 | `changes`             | `개체`      | The changes to the project card if the action was `edited` or `converted`.                                                   |
 | `changes[note][from]` | `문자열`     | The previous version of the note if the action was `edited` or `converted`.                                                  |
 | `after_id`            | `integer` | The id of the card that this card now follows if the action was "moved". Will be `null` if it is the first card in a column. |
-| `project_card`        | `개체`      | The [project card](/v3/projects/cards) itself.                                                                               |
\ No newline at end of file
+| `project_card`        | `개체`      | The [project card](/v3/projects/cards) itself.                                                                               |
diff --git a/translations/ko-KR/data/reusables/webhooks/project_card_short_desc.md b/translations/ko-KR/data/reusables/webhooks/project_card_short_desc.md
index 3a474c89ecee..bbea9ea6c407 100644
--- a/translations/ko-KR/data/reusables/webhooks/project_card_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/project_card_short_desc.md
@@ -1 +1 @@
-Activity related to project cards. {% data reusables.webhooks.action_type_desc %} For more information, see the "[project cards](/v3/projects/cards)" REST API.
\ No newline at end of file
+Activity related to project cards. {% data reusables.webhooks.action_type_desc %} For more information, see the "[project cards](/v3/projects/cards)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/project_column_properties.md b/translations/ko-KR/data/reusables/webhooks/project_column_properties.md
index b49134a676d5..82e7d2e64bdc 100644
--- a/translations/ko-KR/data/reusables/webhooks/project_column_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/project_column_properties.md
@@ -4,4 +4,4 @@
 | `changes`             | `개체`      | The changes to the project column if the action was `edited`.                                                                       |
 | `changes[name][from]` | `문자열`     | The previous version of the name if the action was `edited`.                                                                        |
 | `after_id`            | `integer` | The id of the column that this column now follows if the action was "moved". Will be `null` if it is the first column in a project. |
-| `project_column`      | `개체`      | The [project column](/v3/projects/columns) itself.                                                                                  |
\ No newline at end of file
+| `project_column`      | `개체`      | The [project column](/v3/projects/columns) itself.                                                                                  |
diff --git a/translations/ko-KR/data/reusables/webhooks/project_column_short_desc.md b/translations/ko-KR/data/reusables/webhooks/project_column_short_desc.md
index 31cc257267b0..19ac3f6412c8 100644
--- a/translations/ko-KR/data/reusables/webhooks/project_column_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/project_column_short_desc.md
@@ -1 +1 @@
-Activity related to columns in a project board. {% data reusables.webhooks.action_type_desc %} For more information, see the "[project columns](/v3/projects/columns)" REST API.
\ No newline at end of file
+Activity related to columns in a project board. {% data reusables.webhooks.action_type_desc %} For more information, see the "[project columns](/v3/projects/columns)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/project_properties.md b/translations/ko-KR/data/reusables/webhooks/project_properties.md
index f4799211db53..4adc45332fc0 100644
--- a/translations/ko-KR/data/reusables/webhooks/project_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/project_properties.md
@@ -4,4 +4,4 @@
 | `changes`             | `개체`  | The changes to the project if the action was `edited`.                                                               |
 | `changes[name][from]` | `문자열` | The previous version of the name if the action was `edited`.                                                         |
 | `changes[body][from]` | `문자열` | The previous version of the body if the action was `edited`.                                                         |
-| `프로젝트`                | `개체`  | The [project](/v3/projects/) itself.                                                                                 |
\ No newline at end of file
+| `프로젝트`                | `개체`  | The [project](/v3/projects/) itself.                                                                                 |
diff --git a/translations/ko-KR/data/reusables/webhooks/project_short_desc.md b/translations/ko-KR/data/reusables/webhooks/project_short_desc.md
index c5f8a804a47c..6f18da5d6957 100644
--- a/translations/ko-KR/data/reusables/webhooks/project_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/project_short_desc.md
@@ -1 +1 @@
-Activity related to project boards. {% data reusables.webhooks.action_type_desc %} For more information, see the "[projects](/v3/projects)" REST API.
\ No newline at end of file
+Activity related to project boards. {% data reusables.webhooks.action_type_desc %} For more information, see the "[projects](/v3/projects)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/public_short_desc.md b/translations/ko-KR/data/reusables/webhooks/public_short_desc.md
index 925a4bfeddc5..9333dc3841cc 100644
--- a/translations/ko-KR/data/reusables/webhooks/public_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/public_short_desc.md
@@ -1 +1 @@
-When a private repository is made public.  Without a doubt: the best {% data variables.product.product_name %} event. 
\ No newline at end of file
+When a private repository is made public.  Without a doubt: the best {% data variables.product.product_name %} event. 
diff --git a/translations/ko-KR/data/reusables/webhooks/pull_request_event_api_properties.md b/translations/ko-KR/data/reusables/webhooks/pull_request_event_api_properties.md
index 9cf021070ec1..97ac57155191 100644
--- a/translations/ko-KR/data/reusables/webhooks/pull_request_event_api_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/pull_request_event_api_properties.md
@@ -1,3 +1,3 @@
 | 키    | 유형    | 설명                                                                                                                                                                                              |
 | ---- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `동작` | `문자열` | The action that was performed. Can be one of `opened`, `closed`, `reopened`, `assigned`, `unassigned`, `review_requested`, `review_request_removed`, `labeled`, `unlabeled`, and `synchronize`. |
\ No newline at end of file
+| `동작` | `문자열` | The action that was performed. Can be one of `opened`, `closed`, `reopened`, `assigned`, `unassigned`, `review_requested`, `review_request_removed`, `labeled`, `unlabeled`, and `synchronize`. |
diff --git a/translations/ko-KR/data/reusables/webhooks/pull_request_properties.md b/translations/ko-KR/data/reusables/webhooks/pull_request_properties.md
index b2619258bb68..21544ccd9e8d 100644
--- a/translations/ko-KR/data/reusables/webhooks/pull_request_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/pull_request_properties.md
@@ -1 +1 @@
-`number`|`integer` | The pull request number. `changes`|`object`| The changes to the comment if the action was `edited`. `changes[title][from]`|`string` | The previous version of the title if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `pull_request`|`object` | The [pull request](/v3/pulls) itself.
\ No newline at end of file
+`number`|`integer` | The pull request number. `changes`|`object`| The changes to the comment if the action was `edited`. `changes[title][from]`|`string` | The previous version of the title if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `pull_request`|`object` | The [pull request](/v3/pulls) itself.
diff --git a/translations/ko-KR/data/reusables/webhooks/pull_request_review_comment_event_api_properties.md b/translations/ko-KR/data/reusables/webhooks/pull_request_review_comment_event_api_properties.md
index 9e7e3c9e4d1d..58c167238792 100644
--- a/translations/ko-KR/data/reusables/webhooks/pull_request_review_comment_event_api_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/pull_request_review_comment_event_api_properties.md
@@ -1,3 +1,3 @@
 | 키    | 유형    | 설명                                                              |
 | ---- | ----- | --------------------------------------------------------------- |
-| `동작` | `문자열` | The action that was performed on the comment. Can be `created`. |
\ No newline at end of file
+| `동작` | `문자열` | The action that was performed on the comment. Can be `created`. |
diff --git a/translations/ko-KR/data/reusables/webhooks/pull_request_review_comment_properties.md b/translations/ko-KR/data/reusables/webhooks/pull_request_review_comment_properties.md
index 85341dd38525..a38df37d8c7d 100644
--- a/translations/ko-KR/data/reusables/webhooks/pull_request_review_comment_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/pull_request_review_comment_properties.md
@@ -1 +1 @@
-`changes`|`object`| The changes to the comment if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `pull_request`|`object` | The [pull request](/v3/pulls/) the comment belongs to. `comment`|`object` | The [comment](/v3/pulls/comments) itself.
\ No newline at end of file
+`changes`|`object`| The changes to the comment if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `pull_request`|`object` | The [pull request](/v3/pulls/) the comment belongs to. `comment`|`object` | The [comment](/v3/pulls/comments) itself.
diff --git a/translations/ko-KR/data/reusables/webhooks/pull_request_review_comment_short_desc.md b/translations/ko-KR/data/reusables/webhooks/pull_request_review_comment_short_desc.md
index 0dbf1f6974da..7b05ee9a9a19 100644
--- a/translations/ko-KR/data/reusables/webhooks/pull_request_review_comment_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/pull_request_review_comment_short_desc.md
@@ -1 +1 @@
-Activity related to pull request review comments in the pull request's unified diff. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull request review comments](/v3/pulls/comments/)" REST API.
\ No newline at end of file
+Activity related to pull request review comments in the pull request's unified diff. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull request review comments](/v3/pulls/comments/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/pull_request_review_comment_webhook_properties.md b/translations/ko-KR/data/reusables/webhooks/pull_request_review_comment_webhook_properties.md
index b2aa7f0d3984..6cbe445e3c83 100644
--- a/translations/ko-KR/data/reusables/webhooks/pull_request_review_comment_webhook_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/pull_request_review_comment_webhook_properties.md
@@ -1,3 +1,3 @@
 | 키    | 유형    | 설명                                                                                             |
 | ---- | ----- | ---------------------------------------------------------------------------------------------- |
-| `동작` | `문자열` | The action that was performed on the comment. Can be one of `created`, `edited`, or `deleted`. |
\ No newline at end of file
+| `동작` | `문자열` | The action that was performed on the comment. Can be one of `created`, `edited`, or `deleted`. |
diff --git a/translations/ko-KR/data/reusables/webhooks/pull_request_review_properties.md b/translations/ko-KR/data/reusables/webhooks/pull_request_review_properties.md
index 50a0a88b7eb5..efe385b708e9 100644
--- a/translations/ko-KR/data/reusables/webhooks/pull_request_review_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/pull_request_review_properties.md
@@ -3,4 +3,4 @@
 | `동작`                  | `문자열` | The action that was performed. Can be one of:
    • `submitted` - A pull request review is submitted into a non-pending state.
    • `edited` - The body of a review has been edited.
    • `dismissed` - A review has been dismissed.
     |
 | `pull_request`        | `개체`  | The [pull request](/v3/pulls/) the review pertains to.                 |
 | `검토`                  | `개체`  | The review that was affected.                                          |
-| `changes[body][from]` | `문자열` | The previous version of the body if the action was `edited`.           |
\ No newline at end of file
+| `changes[body][from]` | `문자열` | The previous version of the body if the action was `edited`.           |
diff --git a/translations/ko-KR/data/reusables/webhooks/pull_request_review_short_desc.md b/translations/ko-KR/data/reusables/webhooks/pull_request_review_short_desc.md
index a92f0dd3bb24..07b263364d7f 100644
--- a/translations/ko-KR/data/reusables/webhooks/pull_request_review_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/pull_request_review_short_desc.md
@@ -1 +1 @@
-Activity related to pull request reviews. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull request reviews](/v3/pulls/reviews/)" REST API.
\ No newline at end of file
+Activity related to pull request reviews. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull request reviews](/v3/pulls/reviews/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/pull_request_short_desc.md b/translations/ko-KR/data/reusables/webhooks/pull_request_short_desc.md
index c88a5120c8f4..ea9e435d0328 100644
--- a/translations/ko-KR/data/reusables/webhooks/pull_request_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/pull_request_short_desc.md
@@ -1 +1 @@
-Activity related to pull requests. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull requests](/v3/pulls/)" REST API.
\ No newline at end of file
+Activity related to pull requests. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull requests](/v3/pulls/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/pull_request_webhook_properties.md b/translations/ko-KR/data/reusables/webhooks/pull_request_webhook_properties.md
index f28374eb2bfc..258aac4a8f81 100644
--- a/translations/ko-KR/data/reusables/webhooks/pull_request_webhook_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/pull_request_webhook_properties.md
@@ -1,3 +1,3 @@
 | 키    | 유형    | 설명                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
 | ---- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `동작` | `문자열` | The action that was performed. Can be one of  `opened`, `edited`, `closed`, `assigned`, `unassigned`, `review_requested`, `review_request_removed`, `ready_for_review`, `labeled`, `unlabeled`, `synchronize`, `locked`, `unlocked`, or `reopened`. If the action is `closed` and the `merged` key is `false`, the pull request was closed with unmerged commits. If the action is `closed` and the `merged` key is `true`, the pull request was merged. |
\ No newline at end of file
+| `동작` | `문자열` | The action that was performed. Can be one of  `opened`, `edited`, `closed`, `assigned`, `unassigned`, `review_requested`, `review_request_removed`, `ready_for_review`, `labeled`, `unlabeled`, `synchronize`, `locked`, `unlocked`, or `reopened`. If the action is `closed` and the `merged` key is `false`, the pull request was closed with unmerged commits. If the action is `closed` and the `merged` key is `true`, the pull request was merged. |
diff --git a/translations/ko-KR/data/reusables/webhooks/push_short_desc.md b/translations/ko-KR/data/reusables/webhooks/push_short_desc.md
index 53583a273873..9d434a42fb49 100644
--- a/translations/ko-KR/data/reusables/webhooks/push_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/push_short_desc.md
@@ -1 +1 @@
-One or more commits are pushed to a repository branch or tag.
\ No newline at end of file
+One or more commits are pushed to a repository branch or tag.
diff --git a/translations/ko-KR/data/reusables/webhooks/release_event_api_properties.md b/translations/ko-KR/data/reusables/webhooks/release_event_api_properties.md
index 45a1678c4956..5c47166d3dd1 100644
--- a/translations/ko-KR/data/reusables/webhooks/release_event_api_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/release_event_api_properties.md
@@ -1,3 +1,3 @@
 | 키    | 유형    | 설명                                                 |
 | ---- | ----- | -------------------------------------------------- |
-| `동작` | `문자열` | The action that was performed. Can be `published`. |
\ No newline at end of file
+| `동작` | `문자열` | The action that was performed. Can be `published`. |
diff --git a/translations/ko-KR/data/reusables/webhooks/release_properties.md b/translations/ko-KR/data/reusables/webhooks/release_properties.md
index f9fa6700c8ba..969aefd9d705 100644
--- a/translations/ko-KR/data/reusables/webhooks/release_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/release_properties.md
@@ -1 +1 @@
-`changes[body][from]` |`string` | The previous version of the body if the action was `edited`. `changes[name][from]` |`string` | The previous version of the name if the action was `edited`. `release`|`object` | The [release](/v3/repos/releases/#get-a-release) object.
\ No newline at end of file
+`changes[body][from]` |`string` | The previous version of the body if the action was `edited`. `changes[name][from]` |`string` | The previous version of the name if the action was `edited`. `release`|`object` | The [release](/rest/reference/repos/#get-a-release) object.
diff --git a/translations/ko-KR/data/reusables/webhooks/release_short_desc.md b/translations/ko-KR/data/reusables/webhooks/release_short_desc.md
index b3250fbf11ec..e3a9a3bb3a3c 100644
--- a/translations/ko-KR/data/reusables/webhooks/release_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/release_short_desc.md
@@ -1 +1 @@
-Activity related to a release. {% data reusables.webhooks.action_type_desc %} For more information, see the "[releases](/v3/repos/releases/)" REST API.
\ No newline at end of file
+Activity related to a release. {% data reusables.webhooks.action_type_desc %} For more information, see the "[releases](/v3/repos/releases/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/release_webhook_properties.md b/translations/ko-KR/data/reusables/webhooks/release_webhook_properties.md
index 674c35636e70..3ad5426c06ec 100644
--- a/translations/ko-KR/data/reusables/webhooks/release_webhook_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/release_webhook_properties.md
@@ -1,3 +1,3 @@
-| 키    | 유형    | 설명                                                                                                                                                                                                                                                                                                                              |
-| ---- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `동작` | `문자열` | The action that was performed. Can be one of:
    • `published`: a release, pre-release, or draft of a release is published
      • {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}
    • `unpublished`: a release or pre-release is deleted
    • `created`: a draft is saved, or a release or pre-release is published without previously being saved as a draft
    • `edited`: a release, pre-release, or draft release is edited
    • `deleted`: a release, pre-release, or draft release is deleted
    • `prereleased`: a pre-release is created
    • `released`: a release or draft of a release is published, or a pre-release is changed to a release
      • {% endif %} |
\ No newline at end of file
+| 키    | 유형    | 설명                                                                                                                                                                                                                                                    |
+| ---- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `동작` | `문자열` | The action that was performed. Can be one of:
      • `published`: a release, pre-release, or draft of a release is published
      • `unpublished`: a release or pre-release is deleted
      • `created`: a draft is saved, or a release or pre-release is published without previously being saved as a draft
      • `edited`: a release, pre-release, or draft release is edited
      • `deleted`: a release, pre-release, or draft release is deleted
      • `prereleased`: a pre-release is created
      • `released`: a release or draft of a release is published, or a pre-release is changed to a release
        •  |
diff --git a/translations/ko-KR/data/reusables/webhooks/repo_desc.md b/translations/ko-KR/data/reusables/webhooks/repo_desc.md
index a61104a4ba83..27cc4f74c02c 100644
--- a/translations/ko-KR/data/reusables/webhooks/repo_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/repo_desc.md
@@ -1 +1 @@
-`repository` | `object` | The [`repository`](/v3/repos/#get-a-repository) where the event occured.
\ No newline at end of file
+`repository` | `object` | The [`repository`](/v3/repos/#get-a-repository) where the event occured.
diff --git a/translations/ko-KR/data/reusables/webhooks/repository_import_properties.md b/translations/ko-KR/data/reusables/webhooks/repository_import_properties.md
index 9cb65d3e6b9e..040eb52cfafd 100644
--- a/translations/ko-KR/data/reusables/webhooks/repository_import_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/repository_import_properties.md
@@ -1,3 +1,3 @@
 | 키    | 유형    | 설명                                                                                      |
 | ---- | ----- | --------------------------------------------------------------------------------------- |
-| `상태` | `문자열` | The final state of the import. This can be one of `success`, `cancelled`, or `failure`. |
\ No newline at end of file
+| `상태` | `문자열` | The final state of the import. This can be one of `success`, `cancelled`, or `failure`. |
diff --git a/translations/ko-KR/data/reusables/webhooks/repository_import_short_desc.md b/translations/ko-KR/data/reusables/webhooks/repository_import_short_desc.md
index 2d30661c839a..056531b0195c 100644
--- a/translations/ko-KR/data/reusables/webhooks/repository_import_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/repository_import_short_desc.md
@@ -1 +1 @@
-Activity related to a repository being imported to GitHub. {% data reusables.webhooks.action_type_desc %} For more information, see the "[source imports](/v3/migrations/source_imports/)" REST API.
\ No newline at end of file
+Activity related to a repository being imported to GitHub. {% data reusables.webhooks.action_type_desc %} For more information, see the "[source imports](/v3/migrations/source_imports/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/repository_short_desc.md b/translations/ko-KR/data/reusables/webhooks/repository_short_desc.md
index b7c3f660a8a0..df290ac0ea83 100644
--- a/translations/ko-KR/data/reusables/webhooks/repository_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/repository_short_desc.md
@@ -1 +1 @@
-Activity related to a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[repositories](/v3/repos/)" REST API.
\ No newline at end of file
+Activity related to a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[repositories](/v3/repos/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/repository_vulnerability_alert_properties.md b/translations/ko-KR/data/reusables/webhooks/repository_vulnerability_alert_properties.md
index f2e04f40a20e..64491d67ec6e 100644
--- a/translations/ko-KR/data/reusables/webhooks/repository_vulnerability_alert_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/repository_vulnerability_alert_properties.md
@@ -1,4 +1,4 @@
 | 키    | 유형    | 설명                                                                                   |
 | ---- | ----- | ------------------------------------------------------------------------------------ |
 | `동작` | `문자열` | The action that was performed. This can be one of `create`, `dismiss`, or `resolve`. |
-| `경고` | `개체`  | The security alert of the vulnerable dependency.                                     |
\ No newline at end of file
+| `경고` | `개체`  | The security alert of the vulnerable dependency.                                     |
diff --git a/translations/ko-KR/data/reusables/webhooks/repository_vulnerability_alert_short_desc.md b/translations/ko-KR/data/reusables/webhooks/repository_vulnerability_alert_short_desc.md
index 9eab73f38a49..635c979d782d 100644
--- a/translations/ko-KR/data/reusables/webhooks/repository_vulnerability_alert_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/repository_vulnerability_alert_short_desc.md
@@ -1 +1 @@
-Activity related to security vulnerability alerts in a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[About security alerts for vulerable dependencies](/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies)".
\ No newline at end of file
+Activity related to security vulnerability alerts in a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[About security alerts for vulerable dependencies](/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies)".
diff --git a/translations/ko-KR/data/reusables/webhooks/secret.md b/translations/ko-KR/data/reusables/webhooks/secret.md
index 119e13a93770..d4d128984aec 100644
--- a/translations/ko-KR/data/reusables/webhooks/secret.md
+++ b/translations/ko-KR/data/reusables/webhooks/secret.md
@@ -1 +1 @@
-Setting a webhook secret allows you to ensure that `POST` requests sent to the payload URL are from GitHub. When you set a secret, you'll receive the `X-Hub-Signature` header in the webhook `POST` request. For more details on how to use the secret and the `X-Hub-Signature` header to secure your webhook payloads, see "[Securing your webhooks](/webhooks/securing/)."
\ No newline at end of file
+Setting a webhook secret allows you to ensure that `POST` requests sent to the payload URL are from {% data variables.product.product_name %}. When you set a secret, you'll receive the {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}`X-Hub-Signature` and `X-Hub-Signature-256` headers{% else if currentVersion ver_lt "enterprise-server@2.23" %}`X-Hub-Signature` header{% else if currentVersion == "private-instances@latest" %}`X-Hub-Signature-256` header{% endif %} in the webhook `POST` request. For more information on how to use a secret with a signature header to secure your webhook payloads, see "[Securing your webhooks](/webhooks/securing/)."
diff --git a/translations/ko-KR/data/reusables/webhooks/sender_desc.md b/translations/ko-KR/data/reusables/webhooks/sender_desc.md
index d3c9f888bc19..218063f9e078 100644
--- a/translations/ko-KR/data/reusables/webhooks/sender_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/sender_desc.md
@@ -1 +1 @@
-`sender` | `object` | The user that triggered the event.
\ No newline at end of file
+`sender` | `object` | The user that triggered the event.
diff --git a/translations/ko-KR/data/reusables/webhooks/sponsorship_event_api_properties.md b/translations/ko-KR/data/reusables/webhooks/sponsorship_event_api_properties.md
index ac99018a9f34..df76edd6ea74 100644
--- a/translations/ko-KR/data/reusables/webhooks/sponsorship_event_api_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/sponsorship_event_api_properties.md
@@ -1,3 +1,3 @@
 | 키    | 유형    | 설명                                                    |
 | ---- | ----- | ----------------------------------------------------- |
-| `동작` | `문자열` | The action that was performed. This can be `created`. |
\ No newline at end of file
+| `동작` | `문자열` | The action that was performed. This can be `created`. |
diff --git a/translations/ko-KR/data/reusables/webhooks/sponsorship_properties.md b/translations/ko-KR/data/reusables/webhooks/sponsorship_properties.md
index 6506db181710..939d7fd0ea13 100644
--- a/translations/ko-KR/data/reusables/webhooks/sponsorship_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/sponsorship_properties.md
@@ -1 +1 @@
-`effective_date` | `string` | The `pending_cancellation` and `pending_tier_change` event types will include the date the cancellation or tier change will take effect. `changes[tier][from]` | `object` | The `tier_changed` and `pending_tier_change` will include the original tier before the change or pending change. For more information, see the [pending tier change payload](/webhooks/event-payloads#webhook-payload-example-when-someone-downgrades-a-sponsorship). `changes[privacy_level][from]` | `string` | The `edited` event types include the details about the change when someone edits a sponsorship to change the privacy.
\ No newline at end of file
+`effective_date` | `string` | The `pending_cancellation` and `pending_tier_change` event types will include the date the cancellation or tier change will take effect. `changes[tier][from]` | `object` | The `tier_changed` and `pending_tier_change` will include the original tier before the change or pending change. For more information, see the [pending tier change payload](/webhooks/event-payloads#webhook-payload-example-when-someone-downgrades-a-sponsorship). `changes[privacy_level][from]` | `string` | The `edited` event types include the details about the change when someone edits a sponsorship to change the privacy.
diff --git a/translations/ko-KR/data/reusables/webhooks/sponsorship_short_desc.md b/translations/ko-KR/data/reusables/webhooks/sponsorship_short_desc.md
index cb6cdccf21dc..2f62ffe8d86a 100644
--- a/translations/ko-KR/data/reusables/webhooks/sponsorship_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/sponsorship_short_desc.md
@@ -1 +1 @@
-Activity related to a sponsorship listing. {% data reusables.webhooks.action_type_desc %} For more information, see "[About GitHub Sponsors](/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors)".
\ No newline at end of file
+Activity related to a sponsorship listing. {% data reusables.webhooks.action_type_desc %} For more information, see "[About GitHub Sponsors](/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors)".
diff --git a/translations/ko-KR/data/reusables/webhooks/sponsorship_webhook_properties.md b/translations/ko-KR/data/reusables/webhooks/sponsorship_webhook_properties.md
index cd62f8d8a63e..44366865d7c9 100644
--- a/translations/ko-KR/data/reusables/webhooks/sponsorship_webhook_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/sponsorship_webhook_properties.md
@@ -1,3 +1,3 @@
 | 키    | 유형    | 설명                                                                                                                                                    |
 | ---- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `동작` | `문자열` | The action that was performed. This can be one of `created`, `cancelled`, `edited`, `tier_changed`, `pending_cancellation`, or `pending_tier_change`. |
\ No newline at end of file
+| `동작` | `문자열` | The action that was performed. This can be one of `created`, `cancelled`, `edited`, `tier_changed`, `pending_cancellation`, or `pending_tier_change`. |
diff --git a/translations/ko-KR/data/reusables/webhooks/star_properties.md b/translations/ko-KR/data/reusables/webhooks/star_properties.md
index b2afcb1776ed..40d69bb4dbf3 100644
--- a/translations/ko-KR/data/reusables/webhooks/star_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/star_properties.md
@@ -1,4 +1,4 @@
-| 키            | 유형    | 설명                                                                                                                   |
-| ------------ | ----- | -------------------------------------------------------------------------------------------------------------------- |
-| `동작`         | `문자열` | The action performed. Can be `created` or `deleted`.                                                                 |
-| `starred_at` | `문자열` | The time the star was created. {% data reusables.shortdesc.iso_8601 %} Will be `null` for the `deleted` action. |
\ No newline at end of file
+| 키            | 유형    | 설명                                                                                                              |
+| ------------ | ----- | --------------------------------------------------------------------------------------------------------------- |
+| `동작`         | `문자열` | The action performed. Can be `created` or `deleted`.                                                            |
+| `starred_at` | `문자열` | The time the star was created. {% data reusables.shortdesc.iso_8601 %} Will be `null` for the `deleted` action. |
diff --git a/translations/ko-KR/data/reusables/webhooks/star_short_desc.md b/translations/ko-KR/data/reusables/webhooks/star_short_desc.md
index eac484160fed..f4fb6634197e 100644
--- a/translations/ko-KR/data/reusables/webhooks/star_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/star_short_desc.md
@@ -1 +1 @@
-Activity related to a repository being starred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[starring](/v3/activity/starring/)" REST API.
\ No newline at end of file
+Activity related to a repository being starred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[starring](/v3/activity/starring/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/status_short_desc.md b/translations/ko-KR/data/reusables/webhooks/status_short_desc.md
index 8d28713099d2..754f871add59 100644
--- a/translations/ko-KR/data/reusables/webhooks/status_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/status_short_desc.md
@@ -1 +1 @@
-When the status of a Git commit changes. {% data reusables.webhooks.action_type_desc %} For more information, see the "[statuses](/v3/repos/statuses/)" REST API.
\ No newline at end of file
+When the status of a Git commit changes. {% data reusables.webhooks.action_type_desc %} For more information, see the "[statuses](/v3/repos/statuses/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/team_add_short_desc.md b/translations/ko-KR/data/reusables/webhooks/team_add_short_desc.md
index 5ef912458fe4..914535a21208 100644
--- a/translations/ko-KR/data/reusables/webhooks/team_add_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/team_add_short_desc.md
@@ -1 +1 @@
-When a [repository is added to a team](/v3/teams/#add-or-update-team-repository-permissions).
\ No newline at end of file
+When a [repository is added to a team](/v3/teams/#add-or-update-team-repository-permissions).
diff --git a/translations/ko-KR/data/reusables/webhooks/team_short_desc.md b/translations/ko-KR/data/reusables/webhooks/team_short_desc.md
index 8faf762fe915..fdcf742789ee 100644
--- a/translations/ko-KR/data/reusables/webhooks/team_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/team_short_desc.md
@@ -1 +1 @@
-Activity related to an organization's team. {% data reusables.webhooks.action_type_desc %} For more information, see the "[teams](/v3/teams/)" REST API.
\ No newline at end of file
+Activity related to an organization's team. {% data reusables.webhooks.action_type_desc %} For more information, see the "[teams](/v3/teams/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/watch_properties.md b/translations/ko-KR/data/reusables/webhooks/watch_properties.md
index 7c339478c896..7ca3480c1008 100644
--- a/translations/ko-KR/data/reusables/webhooks/watch_properties.md
+++ b/translations/ko-KR/data/reusables/webhooks/watch_properties.md
@@ -1,3 +1,3 @@
 | 키    | 유형    | 설명                                                               |
 | ---- | ----- | ---------------------------------------------------------------- |
-| `동작` | `문자열` | The action that was performed. Currently, can only be `started`. |
\ No newline at end of file
+| `동작` | `문자열` | The action that was performed. Currently, can only be `started`. |
diff --git a/translations/ko-KR/data/reusables/webhooks/watch_short_desc.md b/translations/ko-KR/data/reusables/webhooks/watch_short_desc.md
index a40fc1893db2..a853027b12ef 100644
--- a/translations/ko-KR/data/reusables/webhooks/watch_short_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/watch_short_desc.md
@@ -1 +1 @@
-When someone stars a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[starring](/v3/activity/starring/)" REST API.
\ No newline at end of file
+When someone stars a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[starring](/v3/activity/starring/)" REST API.
diff --git a/translations/ko-KR/data/reusables/webhooks/webhooks_ssl.md b/translations/ko-KR/data/reusables/webhooks/webhooks_ssl.md
index 987a85576227..c0d40e639296 100644
--- a/translations/ko-KR/data/reusables/webhooks/webhooks_ssl.md
+++ b/translations/ko-KR/data/reusables/webhooks/webhooks_ssl.md
@@ -1 +1 @@
-If your "Payload URL" is a secure site (HTTPS), you will have the option to configure the SSL verification settings. If your "Payload URL" is not secure (HTTP), GitHub will not display this option. By default, GitHub verifies the SSL certificate of your website when delivering webhook payloads. SSL verification helps ensure that hook payloads are delivered to your URL endpoint securely. You have the option to disable SSL, but we recommend keeping **Enable SSL verification** selected.
\ No newline at end of file
+If your "Payload URL" is a secure site (HTTPS), you will have the option to configure the SSL verification settings. If your "Payload URL" is not secure (HTTP), GitHub will not display this option. By default, GitHub verifies the SSL certificate of your website when delivering webhook payloads. SSL verification helps ensure that hook payloads are delivered to your URL endpoint securely. You have the option to disable SSL, but we recommend keeping **Enable SSL verification** selected.
diff --git a/translations/ko-KR/data/reusables/webhooks/workflow_run_desc.md b/translations/ko-KR/data/reusables/webhooks/workflow_run_desc.md
index 25d67bab0223..8866577116c7 100644
--- a/translations/ko-KR/data/reusables/webhooks/workflow_run_desc.md
+++ b/translations/ko-KR/data/reusables/webhooks/workflow_run_desc.md
@@ -1,4 +1,4 @@
 
 This event occurs when a workflow run is requested or completed, and allows you to execute a workflow based on the finished result of another workflow. For example, if your `pull_request` workflow generates build artifacts, you can create a new workflow that uses `workflow_run` to analyze the results and add a comment to the original pull request.
 
-The workflow started by the `workflow_run` event is able to access the secrets and write tokens used by the original workflow.
\ No newline at end of file
+The workflow started by the `workflow_run` event is able to access the secrets and write tokens used by the original workflow.
diff --git a/translations/ko-KR/data/variables/command_line.yml b/translations/ko-KR/data/variables/command_line.yml
index 4816981ce2e9..805c67903e68 100644
--- a/translations/ko-KR/data/variables/command_line.yml
+++ b/translations/ko-KR/data/variables/command_line.yml
@@ -1,5 +1,5 @@
 ---
-#Use this variable wherever backticks are necessary: http://git.io/AArkqA
+#Use this variable wherever backticks are necessary: https://github.com/github/docs-internal/pull/1176#discussion-diff-19853931
 backticks: >-
   {% if currentVersion == "free-pro-team@latest" %}github.com{% else %}[hostname]{% endif %}
 #Use this variable within codeblocks (because it includes HTML! Which only renders in shell codeblocks!)
diff --git a/translations/ko-KR/data/variables/contact.yml b/translations/ko-KR/data/variables/contact.yml
index 4bdc082175a9..dda3137566e9 100644
--- a/translations/ko-KR/data/variables/contact.yml
+++ b/translations/ko-KR/data/variables/contact.yml
@@ -12,7 +12,6 @@ contact_privacy: >-
   {% if currentVersion == "free-pro-team@latest" %}[Privacy contact form](https://github.com/contact/privacy){% endif %}
 contact_enterprise_sales: '[GitHub''s Sales team](https://enterprise.github.com/contact)'
 contact_feedback_actions: '[Feedback form for GitHub Actions](https://support.github.com/contact/feedback?contact[category]=actions)'
-contact_partner_engineering: '[partnerengineering@github.com](mailto:partnerengineering@github.com)'
 #The team that provides Standard Support
 enterprise_support: 'GitHub Enterprise Support'
 #The larger team that includes Enterprise Support and Premium Support
diff --git a/translations/ko-KR/data/variables/product.yml b/translations/ko-KR/data/variables/product.yml
index 62b0f2f31a59..dc314aa800c4 100644
--- a/translations/ko-KR/data/variables/product.yml
+++ b/translations/ko-KR/data/variables/product.yml
@@ -56,12 +56,9 @@ prodname_github_app: 'GitHub 앱'
 prodname_github_apps: 'GitHub Apps'
 prodname_oauth_app: 'OAuth 앱'
 #API and developer docs
-prodname_dev_docs: 'the GitHub Developer documentation'
 prodname_enterprise_api: 'the GitHub Enterprise Server API'
-prodname_support_forum: 'GitHub API Development and Support Forum'
 prodname_support_forum_with_url: '[GitHub API Development and Support Forum](https://github.community/c/github-api-development-and-support/37)'
 prodname_unfurls: 'Content Attachments'
-prodname_component_kit: 'GitHub Component Kit'
 #GitHub Actions
 ## Use this variable only when referring to GitHub Actions the product. When referring to the thing that someone creates using the product, call it an action (small a). See the terminology page of the Brand Guide for more.
 prodname_actions: 'GitHub Actions'
@@ -80,9 +77,8 @@ prodname_matching_fund: 'GitHub 스폰서 매칭 펀드'
 prodname_advanced_security: 'Advanced Security'
 #Codespaces
 prodname_codespaces: 'Codespaces'
-prodname_vscode: 'Visual Studio Code'
 prodname_vs_codespaces: 'Visual Studio Codespaces'
-prodname_vs: 'Visual Studio'
+prodname_github_codespaces: 'GitHub Codespaces'
 #GitHub resources: blog, jobs, Learning Lab
 prodname_gcf: 'GitHub Community Support'
 prodname_blog: 'the GitHub Blog'
@@ -110,15 +106,18 @@ prodname_code_scanning: 'code scanning'
 prodname_code_scanning_capc: 'Code scanning'
 prodname_codeql_runner: 'CodeQL runner'
 prodname_advisory_database: 'GitHub Advisory Database'
-prodname_codeql_workflow: 'CodeQL Analysis workflow'
+prodname_codeql_workflow: 'CodeQL analysis workflow'
+#Visual Studio
+prodname_vs: 'Visual Studio'
+prodname_vscode: 'Visual Studio Code'
+prodname_vss_ghe: 'Visual Studio subscription with GitHub Enterprise'
+prodname_vss_admin_portal_with_url: 'the [administrator portal for Visual Studio subscriptions](https://visualstudio.microsoft.com/subscriptions-administration/)'
 #GitHub Dependabot
 prodname_dependabot: 'GitHub Dependabot'
 prodname_dependabot_short: 'Dependabot'
 prodname_dependabot_alerts: 'GitHub Dependabot alerts'
 prodname_dependabot_security_updates: 'GitHub Dependabot security updates'
 prodname_dependabot_version_updates: 'GitHub Dependabot version updates'
-#GitHub Policies
-prodname_policies: 'GitHub Policies'
 #GitHub Archive Program
 prodname_archive: 'GitHub Archive Program'
 prodname_arctic_vault: 'Arctic Code Vault'
diff --git a/translations/ko-KR/data/variables/search.yml b/translations/ko-KR/data/variables/search.yml
index cba17097ca1d..f22c85c91625 100644
--- a/translations/ko-KR/data/variables/search.yml
+++ b/translations/ko-KR/data/variables/search.yml
@@ -3,9 +3,3 @@ advanced_url: >-
   {% if currentVersion == "free-pro-team@latest" %}[advanced search](https://github.com/search/advanced) page{% else %}advanced search page (`https://[hostname]/search/advanced`){% endif %}
 search_page_url: >-
   {% if currentVersion == "free-pro-team@latest" %}[search](https://github.com/search) page{% else %}search page (`https://[hostname]/search`){% endif %}
-search_highlighting_link: >-
-  For more details about how to receive highlighted search results, see [Text match metadata](#text-match-metadata).
-search_query_description: >-
-  The query contains one or more search keywords and qualifiers. Qualifiers allow you to limit your search to specific areas of GitHub. The REST API supports the same qualifiers as GitHub.com. To learn more about the format of the query, see [Constructing a search query](#constructing-a-search-query).
-order_description: >-
-  Determines whether the first search result returned is the highest number of matches (`desc`) or lowest number of matches (`asc`). This parameter is ignored unless you provide `sort`. Default: `desc`
diff --git a/translations/pt-BR/content/actions/creating-actions/about-actions.md b/translations/pt-BR/content/actions/creating-actions/about-actions.md
index a2b831dada50..fa3cc49a7176 100644
--- a/translations/pt-BR/content/actions/creating-actions/about-actions.md
+++ b/translations/pt-BR/content/actions/creating-actions/about-actions.md
@@ -20,7 +20,8 @@ versions:
 Você pode criar ações gravando códigos personalizados que interajam com o seu repositório da maneira que você quiser, inclusive fazendo integrações com as APIs do {% data variables.product.prodname_dotcom %} e qualquer API de terceiros disponível publicamente. Por exemplo, as ações podem publicar módulos npm, enviar alertas SMS quando problemas urgentes forem criados ou implantar códigos prontos para produção.
 
 {% if currentVersion == "free-pro-team@latest" %}
-É possível gravar suas próprias ações para uso no fluxo de trabalho ou compartilhar as ações que você compilar com a comunidade do {% data variables.product.prodname_dotcom %}. Para compartilhar as ações que você compilou, seu repositório deve ser público.
+Você pode escrever suas próprias ações para usar no seu fluxo de trabalho ou compartilhar as ações que você cria com a
+comunidade de {% data variables.product.prodname_dotcom %}. Para compartilhar as ações que você compilou, seu repositório deve ser público.
 {% endif %}
 
 As ações podem ser executadas diretamente em uma máquina ou em um contêiner Docker. É possível definir as entradas, saídas e variáveis do ambiente de uma ação.
@@ -60,19 +61,20 @@ Uma ação de _etapas de execução compostas_ permite que você combine várias
 Se você estiver desenvolvendo uma ação a ser usada por outras pessoas, recomendamos manter a ação no próprio repositório em vez de criar um pacote dela com outro código de aplicativo. Assim, você poderá controlar as versões e monitorar a ação como qualquer outro software.
 
 {% if currentVersion == "free-pro-team@latest" %}
-Ao armazenar uma ação no seu próprio repositório, fica mais fácil para a comunidade do {% data variables.product.prodname_dotcom %} descobrir a ação. Além disso, você restringe o escopo da base de código para os desenvolvedores corrigirem problemas e desenvolverem a ação, bem como separa o controle de versões da ação e o controle de versões de outros códigos de aplicativo.
+Armazenar uma ação no seu próprio repositório torna mais fácil para a
+comunidade de {% data variables.product.prodname_dotcom %} descobrir a ação, reduz o escopo da base de código para desenvolvedores que corrigem problemas e estendem a ação e desdobra o versionamento da ação do controle de outro código do aplicativo.
 {% endif %}
 
-Se estiver criando uma ação que não pretende disponibilizar ao público, você poderá armazenar os arquivos da ação em qualquer local no seu repositório. Se você planeja combinar ação, fluxo de trabalho e aplicativo em um só repositório, recomendamos armazenar as ações no diretório `.github`. Por exemplo, `.github/actions/action-a` e `.github/actions/action-b`.
+{% if currentVersion == "free-pro-team@latest" %}Se você estiver criando uma ação que não planeja disponibilizar ao público, você {% else %} Você{% endif %} pode armazenar os arquivos de ação em qualquer local do seu repositório. Se você planeja combinar ação, fluxo de trabalho e aplicativo em um só repositório, recomendamos armazenar as ações no diretório `.github`. Por exemplo, `.github/actions/action-a` e `.github/actions/action-b`.
 
 ### Usar o gerenciamento da versão para ações
 
-Para garantir que sua ação seja compatível com {% data variables.product.prodname_ghe_server %}, você deve ter certeza de que não usa referências codificadas para {% data variables.product.prodname_dotcom %} URLs de API. Em vez disso, você deve usar variáveis ambientais para se referir à API {% data variables.product.prodname_dotcom %} :
+Para garantir que sua ação seja compatível com {% data variables.product.prodname_ghe_server %}, você deve se certificar de que você não usa quaisquer referências codificadas para URLs da API de {% data variables.product.prodname_dotcom %}. Em vez disso, você deve usar variáveis de ambiente para referir-se à API de {% data variables.product.prodname_dotcom %}:
 
 - Crie e valide uma versão em um branch da versão (como a `versão/v1`) antes de criar a tag da versão (por exemplo, `v1.0.2`).
 - Para GraphQL, use a variável ambiente `GITHUB_GRAPHQL_URL` .
 
-Para obter mais informações, consulte "[variáveis do ambiente Default](/actions/configuring-and-managing-workflows/using-environment-variables#default-environment-variables).".
+Para obter mais informações, consulte "[Variáveis de ambiente padrão](/actions/configuring-and-managing-workflows/using-environment-variables#default-environment-variables)".
 
 ### Usar o gerenciamento da versão para ações
 
@@ -82,7 +84,7 @@ Esta seção explica como você pode usar o gerenciamento de versões para distr
 
 Se você estiver desenvolvendo uma ação para outras pessoas usarem, recomendamos que você use o gerenciamento de versão para controlar como você distribui as atualizações. Os usuários podem esperar que a versão principal de uma ação inclua as correções críticas necessárias e os pachtes ao mesmo tempo em que permanece compatível com seus fluxos de trabalho existentes. Você deve considerar lançar uma nova versão principal sempre que as suas alterações afetarem a compatibilidade.
 
-Nessa abordagem de gerenciamento de versão, os usuários não devem fazer referência ao branch-`mestre` de uma ação, uma vez que é provável que contenha o último código e poderá, consequentemente, ser instável. Em vez disso, você pode recomendar que os usuários especifiquem uma versão principal ao usar a sua ação e direcioná-los para uma versão mais específica somente se encontrarem problemas.
+Nessa abordagem de gerenciamento de versão, os usuários não devem fazer referência ao branch-padrão da ação, uma vez que é provável que contenha o último código e, consequentemente, pode ser instável. Em vez disso, você pode recomendar que os usuários especifiquem uma versão principal ao usar a sua ação e direcioná-los para uma versão mais específica somente se encontrarem problemas.
 
 Para usar uma versão de ação específica, os usuários podem configurar seu fluxo de trabalho{% data variables.product.prodname_actions %} para atingir uma tag, um SHA do commit ou um branch nomeado para uma versão.
 
@@ -141,7 +143,7 @@ Se você planeja compartilhar sua ação publicamente, é recomendável criar um
 
 ### Comparando {% data variables.product.prodname_actions %} com {% data variables.product.prodname_github_apps %}
 
-{% data variables.product.prodname_marketplace %} oferece ferramentas para melhorar o seu fluxo de trabalho. Entender as diferenças e os benefícios de cada ferramenta ajudará você a selecionar a melhor ferramenta para o seu trabalho. Para obter mais informações sobre a criação de ações e aplicativos, consulte "[Sobre GitHub Actions](/actions/getting-started-with-github-actions/about-github-actions)" e "[Sobre aplicativos](/apps/about-apps/)".
+{% data variables.product.prodname_marketplace %} oferece ferramentas para melhorar o seu fluxo de trabalho. Entender as diferenças e os benefícios de cada ferramenta ajudará você a selecionar a melhor ferramenta para o seu trabalho. Para obter mais informações sobre a criação de aplicativos, consulte "[Sobre aplicativos](/apps/about-apps/)".
 
 #### Vantagens do GitHub Actions e dos aplicativos GitHub
 
diff --git a/translations/pt-BR/content/actions/creating-actions/creating-a-composite-run-steps-action.md b/translations/pt-BR/content/actions/creating-actions/creating-a-composite-run-steps-action.md
index 2c9c1296fa91..4d8ab5337e56 100644
--- a/translations/pt-BR/content/actions/creating-actions/creating-a-composite-run-steps-action.md
+++ b/translations/pt-BR/content/actions/creating-actions/creating-a-composite-run-steps-action.md
@@ -36,7 +36,7 @@ Antes de começar, você criará um repositório {% data variables.product.produ
   echo "Goodbye"
   ```
 
-1. No seu terminal, torne o `goodbye.sh` executável e marque-o no seu repositório.
+3. From your terminal, make `goodbye.sh` executable.
 
   ```shell
   chmod +x goodbye.sh
@@ -85,13 +85,26 @@ Antes de começar, você criará um repositório {% data variables.product.produ
 
   Para obter mais informações sobre como usar `github.action_path`, consulte "[`github context`](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)".
 
-1. Criar nova etiqueta. Esse exemplo usa uma etiqueta chamada `v1` para o branch principal. Para obter mais informações, consulte "[Criar uma etiqueta](/github/managing-your-work-on-github/creating-a-label)".
+1. No terminal, verifique no seu arquivo `action.yml`.
+
+  ```shell
+  git add action.yml
+  git commit -m "Add action"
+  git push
+  ```
+
+1. From your terminal, add a tag. This example uses a tag called `v1`. Para obter mais informações, consulte "[Sobre ações](/actions/creating-actions/about-actions#using-release-management-for-actions)".
+
+  ```shell
+  git tag -a -m "Description of this release" v1
+  git push --follow-tags
+  ```
 
 ### Testar sua ação em um fluxo de trabalho
 
 O código de fluxo de trabalho a seguir usa a ação hello world completa que você fez em "[Criando uma ação arquivo de metadados](/actions/creating-actions/creating-a-composite-run-steps-action#creating-an-action-metadata-file)".
 
-Copie o código do fluxo de trabalho em um arquivo `.github/workflows/main.yml` em outro repositório, mas substitua `actions/hello-world-composite-run-steps-action@v1` pelo repositório e a etiqueta que você criou. Você também pode substituir a entrada `who-to-greet` pelo seu nome.
+Copy the workflow code into a `.github/workflows/main.yml` file in another repository, but replace `actions/hello-world-composite-run-steps-action@v1` with the repository and tag you created. Você também pode substituir a entrada `who-to-greet` pelo seu nome.
 
 {% raw %}
 **.github/workflows/main.yml**
diff --git a/translations/pt-BR/content/actions/creating-actions/creating-a-docker-container-action.md b/translations/pt-BR/content/actions/creating-actions/creating-a-docker-container-action.md
index 9b8550e88d42..10f5eb902b4e 100644
--- a/translations/pt-BR/content/actions/creating-actions/creating-a-docker-container-action.md
+++ b/translations/pt-BR/content/actions/creating-actions/creating-a-docker-container-action.md
@@ -1,6 +1,6 @@
 ---
 title: Criar uma ação de contêiner Docker
-intro: Este guia apresenta as etapas mínimas exigidas para criar uma ação de contêiner Docker.
+intro: 'Este guia apresenta as etapas mínimas exigidas para criar uma ação de contêiner Docker.'
 product: '{% data reusables.gated-features.actions %}'
 redirect_from:
   - /articles/creating-a-docker-container-action
@@ -92,7 +92,7 @@ O {% data variables.product.prodname_dotcom %} criará uma imagem a partir do se
 
 Você pode escolher qualquer imagem Docker de base e, portanto, qualquer linguagem para sua ação. O exemplo de script de shell a seguir usa a variável de entrada `who-to-greet` para imprimir "Hello [who-to-greet]" no arquivo de log.
 
-Na sequência, o script obtém a hora atual e a configura como uma variável de saída que pode ser usada pelas ações executadas posteriormente em um trabalho. Para que {% data variables.product.prodname_dotcom %} reconheça as variáveis de saída, você deve usar um comando do fluxo de trabalho em uma sintaxe específica: `echo "::set-output name=::"`. Para obter mais informações, consulte "[Comandos do fluxo de trabalho para {% data variables.product.prodname_actions %}](/actions/reference/workflow-commands-for-github-actions#setting-an-output-parameter)".
+Na sequência, o script obtém a hora atual e a configura como uma variável de saída que pode ser usada pelas ações executadas posteriormente em um trabalho. Para que {% data variables.product.prodname_dotcom %} reconheça as variáveis de saída, você deverá usar um comando do fluxo de trabalho em uma sintaxe específica: `echo "::set-output name=::"`. Para obter mais informações, consulte "[Comandos do fluxo de trabalho para {% data variables.product.prodname_actions %}](/actions/reference/workflow-commands-for-github-actions#setting-an-output-parameter)".
 
 1. Crie um novo arquivo `entrypoint.sh` no diretório `hello-world-docker-action`.
 
diff --git a/translations/pt-BR/content/actions/creating-actions/creating-a-javascript-action.md b/translations/pt-BR/content/actions/creating-actions/creating-a-javascript-action.md
index 0bc71a9293bb..3e920af82b9f 100644
--- a/translations/pt-BR/content/actions/creating-actions/creating-a-javascript-action.md
+++ b/translations/pt-BR/content/actions/creating-actions/creating-a-javascript-action.md
@@ -77,9 +77,9 @@ Esse arquivo define a entrada `who-to-greet` e a saída `time`. O arquivo també
 
 O conjunto de ferramentas de ações é uma coleção de pacotes Node.js que permite a rápida criação de ações JavaScript com mais consistência.
 
-O pacote do kit de ferramentas [`@actions/core`](https://github.com/actions/toolkit/tree/master/packages/core) fornece uma interface com os comandos do fluxo de trabalho, variáveis de entrada e saída, status de saída e mensagens de depuração.
+O pacote do kit de ferramentas [`@actions/core`](https://github.com/actions/toolkit/tree/main/packages/core) fornece uma interface com os comandos do fluxo de trabalho, variáveis de entrada e saída, status de saída e mensagens de depuração.
 
-O conjunto de ferramentas também oferece um pacote [`@actions/github`](https://github.com/actions/toolkit/tree/master/packages/github) que retorna um cliente REST Octokit autenticado e acesso aos contexto do GitHub Actions.
+O conjunto de ferramentas também oferece um pacote [`@actions/github`](https://github.com/actions/toolkit/tree/main/packages/github) que retorna um cliente REST Octokit autenticado e acesso aos contexto do GitHub Actions.
 
 O conjunto de ferramentas oferece mais do que pacotes `core` and `github`. Para obter mais informações, consulte o repositório [ações/conjuntos de ferramentas](https://github.com/actions/toolkit).
 
@@ -119,7 +119,7 @@ try {
 }
 ```
 
-Se um erro for lançado no exemplo `index.js` acima, `core.setFailed(error.message);` usará o pacote do conjunto de ferramentas de ações [`@actions/core`](https://github.com/actions/toolkit/tree/master/packages/core) para registrar uma mensagem em log e definir um código de saída de falha. Para obter mais informações, consulte "[Definindo os códigos de saída para as ações](/actions/creating-actions/setting-exit-codes-for-actions)".
+Se um erro for lançado no exemplo `index.js` acima, `core.setFailed(error.message);` usará o pacote do conjunto de ferramentas de ações [`@actions/core`](https://github.com/actions/toolkit/tree/main/packages/core) para registrar uma mensagem em log e definir um código de saída de falha. Para obter mais informações, consulte "[Definindo os códigos de saída para as ações](/actions/creating-actions/setting-exit-codes-for-actions)".
 
 
 ### Criar LEIAME
@@ -258,4 +258,8 @@ trabalhos:
 
 No seu repositório, clique na aba **Ações** e selecione a última execução do fluxo de trabalho. Você deverá ver "Hello Mona the Octocat" ou o nome que você usou como entrada em `who-to-greet` e o horário impresso no log.
 
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+![Uma captura de tela de sua ação em um fluxo de trabalho](/assets/images/help/repository/javascript-action-workflow-run-updated.png)
+{% else %}
 ![Uma captura de tela de sua ação em um fluxo de trabalho](/assets/images/help/repository/javascript-action-workflow-run.png)
+{% endif %}
\ No newline at end of file
diff --git a/translations/pt-BR/content/actions/creating-actions/index.md b/translations/pt-BR/content/actions/creating-actions/index.md
index 81151fc7b0e0..31d64ba8892c 100644
--- a/translations/pt-BR/content/actions/creating-actions/index.md
+++ b/translations/pt-BR/content/actions/creating-actions/index.md
@@ -6,6 +6,7 @@ redirect_from:
   - /github/automating-your-workflow-with-github-actions/building-actions
   - /actions/automating-your-workflow-with-github-actions/building-actions
   - /actions/building-actions
+  - /artigos/criando-a-github-action/
 versions:
   free-pro-team: '*'
   enterprise-server: '>=2.22'
diff --git a/translations/pt-BR/content/actions/creating-actions/metadata-syntax-for-github-actions.md b/translations/pt-BR/content/actions/creating-actions/metadata-syntax-for-github-actions.md
index bd78761d2ab6..9e74be3d9660 100644
--- a/translations/pt-BR/content/actions/creating-actions/metadata-syntax-for-github-actions.md
+++ b/translations/pt-BR/content/actions/creating-actions/metadata-syntax-for-github-actions.md
@@ -42,7 +42,6 @@ Arquivos de metadados de ação usam a sintaxe YAML. Se você não souber o que
 
 Este exemplo configura duas entradas: numOctocats e octocatEyeColor. A entrada numOctocats não é necessária e assumirá o valor '1'. A entrada octocatEyeColor é necessária e não tem valor padrão. Arquivos de fluxo de trabalho que usam essa ação devem usar a palavra-chave `with` (com) para definir um valor de entrada para octocatEyeColor. Para obter mais informações sobre a sintaxe `with` (com), consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepswith)".
 
-
 ```yaml
 inputs:
   numOctocats:
@@ -54,7 +53,6 @@ inputs:
     required: true
 ```
 
-
 Quando você especifica uma entrada para uma ação em um arquivo de fluxo de trabalho ou usa um valor de entrada padrão, o {% data variables.product.prodname_dotcom %} cria uma variável de ambiente para a entrada com o nome `INPUT_`. A variável de ambiente criada altera os nomes de entrada para letras maiúsculas e substitui espaços por caracteres `_`.
 
 Por exemplo, se um fluxo de trabalho definiu as entradas numOctocats e octocatEyeColor, o código da ação lê os valores das entradas usando as variáveis de ambiente `INPUT_NUMOCTOCATS` e `INPUT_OCTOCATEYECOLOR`.
@@ -243,7 +241,7 @@ Para obter mais informações, consulte "[`github context`](/actions/reference/c
 
 ##### **`runs.steps.env`**
 
-**Opcional**  Define um `mapa` de variáveis de ambiente apenas para essa etapa. Se você deseja modificar a variável de ambiente armazenada no fluxo de trabalho, use `echo "::set-env name={name}::{value}"` em uma etapa de execução compostoa.
+**Opcional**  Define um `mapa` de variáveis de ambiente apenas para essa etapa. Se você quiser modificar a variável de ambiente armazenada no fluxo de trabalho, use {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 2" %}`echo "{name}={value}" >> $GITHUB_ENV`{% else %}`echo "::set-env name={name}::{value}"`{% endif %} em uma etapa de execução composta.
 
 ##### **`runs.steps.working-directory`**
 
diff --git a/translations/pt-BR/content/actions/creating-actions/publishing-actions-in-github-marketplace.md b/translations/pt-BR/content/actions/creating-actions/publishing-actions-in-github-marketplace.md
index 6f52517e97dd..cdd85e3052c4 100644
--- a/translations/pt-BR/content/actions/creating-actions/publishing-actions-in-github-marketplace.md
+++ b/translations/pt-BR/content/actions/creating-actions/publishing-actions-in-github-marketplace.md
@@ -24,9 +24,9 @@ As ações são publicadas em {% data variables.product.prodname_marketplace %}
 - Cada repositório deve conter uma ação única.
 - O arquivo de metadados da ação (`action.yml` ou `action.yaml`) deve estar no diretório-raiz do repositório.
 - O `nome` do arquivo de metadados da ação deve ser único.
-  - O `nome` não pode corresponder a um nome de uma ação existente publicado em {% data variables.product.prodname_marketplace %}.
+  - O `nome` não pode corresponder ao nome de uma ação publicado em {% data variables.product.prodname_marketplace %}.
   - O `nome` não pode corresponder a um usuário ou organização em {% data variables.product.prodname_dotcom %}, a menos que o usuário ou o proprietário da organização esteja publicando a ação. Por exemplo, somente {% data variables.product.prodname_dotcom %} a organização pode publicar uma ação denominada `GitHub`.
-  - O `nome` não pode corresponder a uma categoria existente {% data variables.product.prodname_marketplace %}.
+  - O `nome` não pode corresponder a uma categoria {% data variables.product.prodname_marketplace %}.
   - {% data variables.product.prodname_dotcom %} reserva os nomes de recursos {% data variables.product.prodname_dotcom %}.
 
 ### Publicar uma ação
diff --git a/translations/pt-BR/content/actions/creating-actions/setting-exit-codes-for-actions.md b/translations/pt-BR/content/actions/creating-actions/setting-exit-codes-for-actions.md
index f714ea264e8f..450fe7d325cd 100644
--- a/translations/pt-BR/content/actions/creating-actions/setting-exit-codes-for-actions.md
+++ b/translations/pt-BR/content/actions/creating-actions/setting-exit-codes-for-actions.md
@@ -24,7 +24,7 @@ O {% data variables.product.prodname_dotcom %} usa o código de saída para defi
 
 ### Definir um código de saída de falha em uma ação JavaScript
 
-Se estiver criando uma ação JavaScript, você poderá usar o pacote [`@actions/core`](https://github.com/actions/toolkit/tree/master/packages/core) do conjunto de ferramentas de ações para registrar em log uma mensagem e definir um código de saída de falha. Por exemplo:
+Se estiver criando uma ação JavaScript, você poderá usar o pacote [`@actions/core`](https://github.com/actions/toolkit/tree/main/packages/core) do conjunto de ferramentas de ações para registrar em log uma mensagem e definir um código de saída de falha. Por exemplo:
 
 ```javascript
 try {
diff --git a/translations/pt-BR/content/actions/guides/about-continuous-integration.md b/translations/pt-BR/content/actions/guides/about-continuous-integration.md
new file mode 100644
index 000000000000..324fe19c9563
--- /dev/null
+++ b/translations/pt-BR/content/actions/guides/about-continuous-integration.md
@@ -0,0 +1,63 @@
+---
+title: Sobre integração contínua
+intro: 'Você pode criar fluxos de trabalho personalizados de integração contínua (CI) e implantação contínua (CD) diretamente no seu repositório de {% data variables.product.prodname_dotcom %} com as {% data variables.product.prodname_actions %}.'
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /articles/about-continuous-integration
+  - /github/automating-your-workflow-with-github-actions/about-continuous-integration
+  - /actions/automating-your-workflow-with-github-actions/about-continuous-integration
+  - /actions/building-and-testing-code-with-continuous-integration/about-continuous-integration
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Sobre integração contínua
+
+A integração contínua (CI, Continuous Integration) é uma prática de software que exige commits frequentes de códigos para um repositório compartilhado. Fazer commits de códigos com frequência detecta erros com mais antecedência e reduz a quantidade de código necessária para depuração quando os desenvolvedores chegam à origem de um erro. As atualizações frequentes de código também facilitam o merge de alterações dos integrantes de uma equipe de desenvolvimento de software. Assim, os desenvolvedores podem se dedicar mais à gravação de códigos e se preocupar menos com erros de depuração ou conflitos de merge.
+
+Ao fazer commit do seu repositório, você pode continuamente compilar e testar o código para garantir que o commit não insira erros. Seus testes podem incluir linters de código (que verificam formatação de estilo), verificações de segurança, cobertura de código, testes funcionais e outras verificações personalizadas.
+
+Para compilar e testar seu código, é necessário usar um servidor. Você pode criar e testar atualizações no local antes de fazer push do código para um repositório, ou pode usar um servidor de CI que verifica os novos commits de código em um repositório.
+
+### Sobre integração contínua usando {% data variables.product.prodname_actions %}
+
+A CI que usa {% data variables.product.prodname_actions %} oferece fluxos de trabalho que podem criar o código no seu repositório e executar os seus testes. Fluxos de trabalho podem ser executados em máquinas virtuais hospedadas em {% data variables.product.prodname_dotcom %} ou em máquinas que você mesmo hospeda. Para obter mais informações, consulte "[Ambientes virtuais para executores hospedados em {% data variables.product.prodname_dotcom %}](/actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)," e "[Sobre executores auto-hospedados](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)."
+
+Você pode configurar seu fluxo de trabalho de CI para ser executado quando ocorre um evento de {% data variables.product.product_name %} (por exemplo, quando um novo código é enviado para o repositório), em uma programação definida, ou quando um evento externo ocorre usando o webhook de envio do repositório.
+
+{% data variables.product.product_name %} executa seus testes de CI e fornece os resultados de cada teste no pull request para que você possa ver se a mudança no seu branch introduz um erro. Quando todos os testes de CI em um fluxo de trabalho forem aprovados, as alterações que passaram por push estarão prontas para a revisão de um integrante da equipe ou para o merge. Se algum teste falhar, uma de suas alterações pode ter causado a falha.
+
+Ao configurar o CI no seu repositório, {% data variables.product.product_name %} analisa o código no seu repositório e recomenda fluxos de trabalho CI baseados no idioma e na estrutura do seu repositório. Por exemplo, se você usar o [Node.js](https://nodejs.org/en/), {% data variables.product.product_name %} irá sugerir um arquivo de modelo que instala seus pacotes Node.js e executa seus testes. Você pode usar o modelo do fluxo de trabalho de CI sugerido por {% data variables.product.product_name %}, personalizar o modelo sugerido ou criar o seu próprio arquivo de fluxo de trabalho personalizado para executar seus testes de CI.
+
+![Captura de tela dos modelos sugeridos de integração contínua](/assets/images/help/repository/ci-with-actions-template-picker.png)
+
+Além de ajudá-lo a configurar fluxos de trabalho de CI para seu projeto, você pode usar {% data variables.product.prodname_actions %} para criar fluxos de trabalho ao longo de todo o ciclo de vida de desenvolvimento do software. Por exemplo, você pode usar ações para implantar, criar pacotes ou lançar uma versão do seu projeto. Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_actions %}](/articles/about-github-actions)".
+
+Para obter uma definição de termos comuns, consulte "[Conceitos básicos de {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)".
+
+### Linguagens compatíveis
+
+{% data variables.product.product_name %} oferece modelos de fluxo de trabalho de CI para uma variedade de linguagens e estruturas.
+
+Pesquise a lista completa dos modelos de fluxo de trabalho de CI oferecidos por {% data variables.product.product_name %} no repositório {% if currentVersion == "free-pro-team@latest" %}[actions/starter-workflows](https://github.com/actions/starter-workflows/tree/main/ci) {% else %} e no repositório `actions/starter-workflows` em {% data variables.product.product_location %}{% endif %}.
+
+### Notificações para execução de fluxo de trabalho
+
+{% data reusables.repositories.workflow-notifications %}
+
+### Selos de status para execução de fluxo de trabalho
+
+{% data reusables.repositories.actions-workflow-status-badge-into %}
+
+Para obter mais informações, consulte "[Configurar fluxo de trabalho](/articles/configuring-a-workflow)."
+
+### Leia mais
+
+- "[Configurar a integração contínua usando {% data variables.product.prodname_actions %}](/articles/setting-up-continuous-integration-using-github-actions)"
+{% if currentVersion == "free-pro-team@latest" %}
+- "[Gerenciar a cobrança para {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)"
+{% endif %}
diff --git a/translations/pt-BR/content/actions/guides/about-packaging-with-github-actions.md b/translations/pt-BR/content/actions/guides/about-packaging-with-github-actions.md
new file mode 100644
index 000000000000..9ff581a456c3
--- /dev/null
+++ b/translations/pt-BR/content/actions/guides/about-packaging-with-github-actions.md
@@ -0,0 +1,47 @@
+---
+title: Sobre o empacotamento com GitHub Actions
+intro: 'Você pode configurar fluxos de trabalho em {% data variables.product.prodname_actions %} para produzir pacotes e fazer o upload em {% data variables.product.prodname_registry %} ou em outro fornecedor de hospedagem do pacote.'
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/about-packaging-with-github-actions
+  - /actions/publishing-packages-with-github-actions/about-packaging-with-github-actions
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Sobre as etapas do empacotamento
+
+Uma etapa de empacotamento é uma parte comum de um fluxo de trabalho de integração contínua ou de continuous delivery. Após criar e testar o seu aplicativo, será produzido um artefato executável ou aplicável produzido na forma de um pacote. Por exemplo, um fluxo de trabalho de integração contínua para um projeto Java pode executar o `pacote mvn` para produzir um arquivo JAR. Ou um fluxo de trabalho CI para um aplicativo Node.js pode criar um contêiner Docker.
+
+Dependendo do tipo de aplicativo que você estiver criando, este pacote pode ser baixado localmente para teste manual, disponibilizado para download dos usuários ou implementado em um ambiente de teste ou produção.
+
+### Empacotamento em fluxos de trabalho de integração contínua
+
+Criar um pacote ao fim de um fluxo de trabalho de integração contínua pode ajudar durante as análises de código ou durante o pull request. Após criar e testar o seu código, uma etapa de empacotamento pode produzir um artefato executável ou aplicável. Em seguida, o seu fluxo de trabalho pode pegar esse artefato e fazer o upload como parte do fluxo de trabalho.
+
+Agora, ao revisar um pull request, você poderá ver a execução do fluxo de trabalho e fazer o download do artefato produzido.
+
+![Menu suspenso do para fazer download do artefato](/assets/images/help/repository/artifact-drop-down.png)
+
+Isso permitirá que você execute o código no pull request em sua máquina, o que pode ajudar a depurar ou testar o pull request.
+
+### Fluxos de trabalho para publicação de pacotes
+
+Além de fazer o upload dos artefatos de empacotamento para teste em um fluxo de trabalho de integração contínua, você poderá criar fluxos de trabalho que criam o seu projeto e publicam pacotes no pacote de registro.
+
+* **Publicar pacotes para {% data variables.product.prodname_registry %}**
+  {% data variables.product.prodname_registry %} pode atuar como um serviço de hospedagem de pacotes para vários tipos de pacotes. Você pode escolher compartilhar os seus pacotes com todos {% data variables.product.prodname_dotcom %} ou compartilhar pacotes privados com colaboradores ou uma organização. Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/about-github-packages)."
+
+  Você pode querer publicar pacotes em {% data variables.product.prodname_registry %} em cada push no branch padrão. Isso fará com que os desenvolvedores no seu projeto sempre consigam executar e testar facilmente a última criação feita a partir do mestre, instalando-a a partir de {% data variables.product.prodname_registry %}.
+
+* **Publicar pacotes em um registro de pacote** Para muitos projetos, a publicação de um registro de pacote é realizada sempre que uma versão nova de um projeto é lançada. Por exemplo, um projeto que produz um arquivo JAR pode fazer o upload de novas versões no repositório central do Maven. Ou um projeto .NET pode produzir um pacote nuget e fazer o upload na Galeria NuGet.
+
+  Você pode automatizar isso criando um fluxo de trabalho que publica pacotes em um registro de pacote em cada versão. Para obter mais informações, consulte "[Criando versões](/github/administering-a-repository/creating-releases)."
+
+### Leia mais
+
+- "[Publicando pacotes Node.js](/actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages)"
diff --git a/translations/pt-BR/content/actions/guides/about-service-containers.md b/translations/pt-BR/content/actions/guides/about-service-containers.md
new file mode 100644
index 000000000000..d46a142665c8
--- /dev/null
+++ b/translations/pt-BR/content/actions/guides/about-service-containers.md
@@ -0,0 +1,117 @@
+---
+title: Sobre os contêineres de serviço
+intro: 'Você pode usar contêineres de serviço para conectar bancos de dados, serviços web, memória cache e outras ferramentas ao seu fluxo de trabalho.'
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/about-service-containers
+  - /actions/configuring-and-managing-workflows/about-service-containers
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Sobre os contêineres de serviço
+
+Os contêineres de serviço são contêineres Docker que fornecem uma forma simples e portátil para os seus serviços de hospedagem que você pode precisar testar ou operar a sua aplicação em um fluxo de trabalho. Por exemplo, o seu fluxo de trabalho pode precisar executar testes de integração que necessitem de acesso a um banco de dados e a uma memória cache.
+
+Você pode configurar os contêineres de serviço para cada trabalho em um fluxo de trabalho. {% data variables.product.prodname_dotcom %} cria um novo contêiner Docker para cada serviço configurado no fluxo de trabalho e destrói o contêiner de serviço quando o trabalho é concluído. As etapas em um trabalho podem comunicar-se com todos os contêineres de serviço que fazem parte do mesmo trabalho.
+
+{% data reusables.github-actions.docker-container-os-support %}
+
+### Comunicar-se com os contêineres de serviço
+
+Você pode configurar trabalhos em um fluxo de trabalho para ser executados diretamente em uma máquina executora ou em um contêiner Docker. A comunicação entre o trabalho e seus contêineres de serviço é diferente, dependendo se um trabalho é executado diretamente na máquina executora ou em um contêiner.
+
+#### Executar trabalhos em um contêiner
+
+Ao executar trabalhos em um contêiner, {% data variables.product.prodname_dotcom %} conecta os contêineres de serviço ao trabalho suando as redes de ponte definidas pelo usuário do Docker. Para obter mais informações, consulte "["Usar redes de ponte](https://docs.docker.com/network/bridge/)" na documentação do Docker.
+
+Executar o trabalho e os serviços em um contêiner simplifica o acesso à rede. Você pode acessar um contêiner de serviço usando a etiqueta que você configurar no fluxo de trabalho. O nome de host do contêiner do serviço é mapeado automaticamente de acordo com o nome da etiqueta. Por exemplo, se você criar um contêiner de serviço com a etiqueta `redis`, o nome de host do contêiner de serviço será `redis`.
+
+Você não precisa configurar nenhuma porta para os contêineres de serviço. Por padrão, todos os contêineres que fazem parte da mesma rede do Docker expõem todas as portas entre si e nenhuma porta é exposta fora da rede do Docker.
+
+#### Executar trabalhos na máquina executora
+
+Ao executar trabalhos diretamente na máquina executora, você poderá acessar os contêineres de serviço usando `localhost:` ou `127.0.0.1:`. {% data variables.product.prodname_dotcom %} configura a rede do contêiner para habilitar a comunicação a partir do contêiner de serviço com o host do Docker.
+
+Quando um trabalho é executado diretamente em uma máquina executora, o serviço executado no contêiner do Docker não expõe suas portas ao trabalho no executor por padrão. Você deve mapear as portas no contêiner de serviço com o host do Docker. Para obter mais informações, consulte "[Mapeando o host do Docker e as portas do contêiner de serviço](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)".
+
+### Criar contêineres de serviço
+
+Você pode usar a palavra-chave `serviços` para criar contêineres de serviço que fazem parte de um trabalho no seu fluxo de trabalho. Para obter mais informações, consulte [`trabalhos..serviços`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idservices).
+
+Este exemplo cria um serviço denominado `redis` em um trabalho denominado `container-job`. O host do Docker, neste exemplo, é o contêiner `node:10.18-jessie`.
+
+{% raw %}
+```yaml
+nome: Exemplo de contêiner Redis
+em: push
+
+trabalhos:
+  # Etiqueta do trabalho do contêiner
+  container-job:
+    # Os contêineres devem ser executados em sistemas operacionais baseados no Linux
+    runs-on: ubuntu-latest
+    # Imagem do Docker Hub em que o `container-job` é executado
+    container: node:10.18-jessie
+
+    # Contêineres de serviço a serem executados com `container-job`
+    serviços:
+      # Etiqueta usada para acessar o contêiner de serviço
+      redis:
+        # Imagem do Docker Hub
+        imagem: redis
+```
+{% endraw %}
+
+### Mapear o host do Docker e as portas do contêiner de serviço
+
+Se o seu trabalho for executado em um contêiner do Docker, você não precisará mapear as portas no host ou no contêiner de serviço. Se o seu trabalho for executado diretamente na máquina executora, você precisará mapear todas as portas do contêiner de serviço necessárias com as portas na máquina executora do host.
+
+Você pode mapear as portas dos contêineres de serviço com o host do Docker usando a palavra-chave `portas`. Para obter mais informações, consulte [`trabalhos..serviços`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idservices).
+
+| Valor das `portas` | Descrição                                                                                        |
+| ------------------ | ------------------------------------------------------------------------------------------------ |
+| `8080:80`          | Mapeia a porta 80 TCP no contêiner com a porta 8080 no host do Docker.                           |
+| `8080:80/udp`      | Mapeia a porta 80 UDP no contêiner com a porta 8080 no host do Docker.                           |
+| `8080/udp`         | Mapeia a porta UDP escolhida aleatoriamente no contêiner com a porta 8080 UDP no host do Docker. |
+
+Ao mapear portas usando a palavra-chave `portas`, {% data variables.product.prodname_dotcom %}usa o comando `--publicar` para publicar as portas do contêiner no host do Docker. Para obter mais informações, consulte "[Rede do contêiner do Docker](https://docs.docker.com/config/containers/container-networking/)" na documentação do Docker.
+
+Ao especificar a porta do host do Docker mas não a porta do contêiner, a porta do contêiner será atribuída aleatoriamente a uma porta livre. {% data variables.product.prodname_dotcom %} define a porta do contêiner atribuída no contexto do contêiner de serviço. Por exemplo, para um contêiner de serviço `redis`, se você configurou a porta 5432 do host do Docker, você poderá acessar a porta do contêiner correspondente usando o contexto `job.services.redis.ports[5432]`. Para obter mais informações, consulte "[Contexto e sintaxe de expressão para {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions#job-context)".
+
+#### Exemplo de mapeamento de portas Redis
+
+Este exemplo mapeia a porta 6379 do contêiner de serviço `redis` com a porta 6379 do host do Docker.
+
+{% raw %}
+```yaml
+nome: Exemplo de serviço Redis
+em: push
+
+trabalhos:
+  # Etiqueta do trabalho do contêiner
+  runner-job:
+    # YoVocê deve usar um ambiente Linux ao usar os contêineres de serviço ou os trabalhos do contêiner
+    runs-on: ubuntu-latest
+
+    # Contêineres de serviço a ser executados com `runner-job`
+    serviços:
+      # Etiqueta usada para acessar o contêiner de serviço
+      redis:
+        # Imagem do Docker Hubm
+        image: redis
+        #
+        portas:
+          # Abre a porta 6379 tcp no host e no contêiner de serviço
+          - 6379:6379
+```
+{% endraw %}
+
+### Leia mais
+
+- [Criando contêineres de serviço Redis](/actions/automating-your-workflow-with-github-actions/creating-redis-service-containers)"
+- [Criando contêineres de serviço PostgreSQL](/actions/automating-your-workflow-with-github-actions/creating-postgresql-service-containers)"
diff --git a/translations/pt-BR/content/actions/guides/building-and-testing-java-with-ant.md b/translations/pt-BR/content/actions/guides/building-and-testing-java-with-ant.md
new file mode 100644
index 000000000000..fac5e27b7209
--- /dev/null
+++ b/translations/pt-BR/content/actions/guides/building-and-testing-java-with-ant.md
@@ -0,0 +1,109 @@
+---
+title: Criar e estar o Java com o Ant
+intro: Você pode criar um fluxo de trabalho de integração contínua (CI) no GitHub Actions para criar e testar o seu projeto Java com o Ant.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/building-and-testing-java-with-ant
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introdução
+
+Este guia mostra como criar um fluxo de trabalho que realiza a integração contínua (CI) para o seu projeto Java usando o sistema de criação do Ant. O fluxo de trabalho que você criar permitirá que você veja quando commits em um pull request gerarão falhas de criação ou de teste em comparação com o seu branch-padrão. Essa abordagem pode ajudar a garantir que seu código seja sempre saudável. Você pode estender seu fluxo de trabalho de CI para enviar artefatos a partir da execução de um fluxo de trabalho.
+
+Os executores hospedados em {% data variables.product.prodname_dotcom %} têm uma cache de ferramentas com com software pré-instalado, que inclui kits de desenvolvimento Java (JDKs) e Ant. Para uma lista de software e as versões pré-instaladas para JDK e Ant, consulte "[Especificações para executores hospedados em {% data variables.product.prodname_dotcom %}](/actions/reference/specifications-for-github-hosted-runners/#supported-software)".
+
+### Pré-requisitos
+
+Você deve estar familiarizado com o YAML e a sintaxe do {% data variables.product.prodname_actions %}. Para obter mais informações, consulte:
+- "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)"
+- "[Aprenda {% data variables.product.prodname_actions %}](/actions/learn-github-actions)"
+
+Recomendamos que você tenha um entendimento básico da estrutura do Java e do Ant. Para obter mais informações, consulte o [Manual do Apache Ant](https://ant.apache.org/manual/).
+
+{% data reusables.actions.enterprise-setup-prereq %}
+
+### Introdução com o modelo do fluxo de trabalho do Ant
+
+{% data variables.product.prodname_dotcom %} fornece um modelo de fluxo de trabalho Ant que funcionará para a maioria dos projetos Java baseados no Ant. Para obter mais informações, consulte o [modelo do fluxo de trabalho do Ant](https://github.com/actions/starter-workflows/blob/main/ci/ant.yml).
+
+Para começar rapidamente, você pode escolher o modelo do Ant pré-configurado ao criar um novo fluxo de trabalho. Para obter mais informações, consulte o início rápido "[{% data variables.product.prodname_actions %}](/actions/quickstart)".
+
+Você também pode adicionar este fluxo de trabalho manualmente, criando um novo arquivo no diretório `.github/workflows` do seu repositório.
+
+{% raw %}
+```yaml
+nome: Java CI
+
+em: [push]
+
+trabalho:
+  build:
+    runs-on: ubuntu-latest
+
+    etapa:
+      - usa: actions/checkout@v2
+      - nome: Configure JDK 1.
+        uso: actionp-java@v1
+        com:
+          java-version: 1.
+      - nome: Construir com Ant
+        executar: ant -noinput -buildfile build.xml
+```
+{% endraw %}
+
+Este fluxo de trabalho executa os seguintes passos:
+
+1. O `checkout` faz o download de uma cópia do seu repositório no executor.
+2. A etapa `setup-java` configura o Java 1.8 JDK.
+3. A etapa "Criar com Ant" executa o alvo-padrão em seu `build.xml` de modo não interativo.
+
+Os modelos-padrão do fluxo de trabalho são excelentes pontos de partida ao criar seu fluxo de trabalho de compilação e teste, e você pode personalizar o modelo para atender às necessidades do seu projeto.
+
+{% data reusables.github-actions.example-github-runner %}
+
+{% data reusables.github-actions.java-jvm-architecture %}
+
+### Criar e testar seu código
+
+Você pode usar os mesmos comandos usados localmente para criar e testar seu código.
+
+O fluxo de trabalho inicial executará o alvo-padrão especificado no arquivo _build.xml_.  Seu alvo-padrão será comumente definido para criar classes, executar testes e classes de pacote em seu formato distribuível como, por exemplo, um arquivo JAR.
+
+Se você usa comandos diferentes para criar seu projeto ou se você quer executar um alvo diferente, você poderá especificá-los. Por exemplo, você pode desejar executar o `jar` alvo configurado no arquivo _build-ci.xml_.
+
+{% raw %}
+```yaml
+etapas:
+  - usa: actions/checkout@v2
+  - usa: actions/setup-java@v1
+    com:
+      java-version: 1.8
+  - nome: Executa o alvo do Ant jar
+    executa: ant -noinput -buildfile build-ci.xml jar
+```
+{% endraw %}
+
+### Empacotar dados do fluxo de trabalho como artefatos
+
+Após a sua criação ter sido criada com sucesso e os seus testes aprovados, é possível que você deseje fazer o upload dos Java resultantes como um artefato de criação. Isso armazenará os pacotes criados como parte da execução do fluxo de trabalho e permitirá que você faça o download desses pacotes. Os artefatos podem ajudá-lo a testar e depurar os pull requests no seu ambiente local antes de serem mesclados. Para obter mais informações, consulte "[Dados recorrentes do fluxo de trabalho que usam artefatos](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)".
+
+De modo geral, o Ant cria arquivos de saída como JARs, EARs ou WARs no diretório `build/jar`. Você pode fazer upload do conteúdo desse diretório usando a ação `upload-artefact`.
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+  - run: ant -noinput -buildfile build.xml
+  - uses: actions/upload-artifact@v2
+    with:
+      name: Package
+      path: build/jar
+```
+{% endraw %}
diff --git a/translations/pt-BR/content/actions/guides/building-and-testing-java-with-gradle.md b/translations/pt-BR/content/actions/guides/building-and-testing-java-with-gradle.md
new file mode 100644
index 000000000000..7afadb442f5d
--- /dev/null
+++ b/translations/pt-BR/content/actions/guides/building-and-testing-java-with-gradle.md
@@ -0,0 +1,134 @@
+---
+title: Criar e estar o Java com o Gradle
+intro: Você pode criar um fluxo de trabalho de integração contínua (CI) no GitHub Actions para criar e testar o seu projeto Java com o Gradle.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/building-and-testing-java-with-gradle
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introdução
+
+Este guia mostra como criar um fluxo de trabalho que realiza a integração contínua (CI) para o seu projeto Java usando o sistema de criação do Gradle. O fluxo de trabalho que você criar permitirá que você veja quando commits em um pull request gerarão falhas de criação ou de teste em comparação com o seu branch-padrão. Essa abordagem pode ajudar a garantir que seu código seja sempre saudável. Você pode estender seu fluxo de trabalho de CI para memorizar arquivos e fazer o upload de artefatos a partir da execução de um fluxo de trabalho.
+
+Os executores hospedados em {% data variables.product.prodname_dotcom %} têm uma cache de ferramentas com com software pré-instalado, que inclui kits de desenvolvimento Java (JDKs) e Gradle. Para obter uma lista de software e as versões pré-instaladas para JDK e Gradle, consulte "[Especificações para executores hospedados em {% data variables.product.prodname_dotcom %}](/actions/reference/specifications-for-github-hosted-runners/#supported-software)".
+
+### Pré-requisitos
+
+Você deve estar familiarizado com o YAML e a sintaxe do {% data variables.product.prodname_actions %}. Para obter mais informações, consulte:
+- "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)"
+- "[Aprenda {% data variables.product.prodname_actions %}](/actions/learn-github-actions)"
+
+Recomendamos que você tenha um entendimento básico da estrutura do Java e do Gradle. Para obter mais informações, consulte "[Introdução](https://docs.gradle.org/current/userguide/getting_started.html)" na documentação do Gradle.
+
+{% data reusables.actions.enterprise-setup-prereq %}
+
+### Introdução com um modelo de fluxo de trabalho do Gradle
+
+{% data variables.product.prodname_dotcom %} fornece um modelo de fluxo de trabalho Gradle que funcionará para a maioria dos projetos Java baseados no Gradle. Para obter mais informações, consulte o [modelo do fluxo de trabalho do Gradle](https://github.com/actions/starter-workflows/blob/main/ci/gradle.yml).
+
+Para começar rapidamente, você pode escolher o modelo do Gradle pré-configurado ao criar um novo fluxo de trabalho. Para obter mais informações, consulte o início rápido "[{% data variables.product.prodname_actions %}](/actions/quickstart)".
+
+Você também pode adicionar este fluxo de trabalho manualmente, criando um novo arquivo no diretório `.github/workflows` do seu repositório.
+
+{% raw %}
+```yaml
+nome: Java CI
+
+em: [push]
+
+trabalhos:
+  criar:
+    runs-on: ubuntu-latest
+
+    etapas:
+      - usa: actions/checkout@v2
+      - nome: Set up JDK 1.8
+        usa: actions/setup-java@v1
+        com:
+          java-version: 1.8
+      - nome: Criar com Gradle
+        executar: ./gradlew build
+```
+{% endraw %}
+
+Este fluxo de trabalho executa os seguintes passos:
+
+1. O `checkout` faz o download de uma cópia do seu repositório no executor.
+2. A etapa `setup-java` configura o Java 1.8 JDK.
+3. A etapa "Criar com Gradle" executa o script wrapper `gradlew` para garantir que o seu código seja criado, o seu teste seja aprovado e que seja possível criar um pacote.
+
+Os modelos-padrão do fluxo de trabalho são excelentes pontos de partida ao criar seu fluxo de trabalho de compilação e teste, e você pode personalizar o modelo para atender às necessidades do seu projeto.
+
+{% data reusables.github-actions.example-github-runner %}
+
+{% data reusables.github-actions.java-jvm-architecture %}
+
+### Criar e testar seu código
+
+Você pode usar os mesmos comandos usados localmente para criar e testar seu código.
+
+O fluxo de tarbalho inicial executará a tarefa `criar` por padrão. Na configuração-padrão do Gradle, este comando irá baixar dependências, criar classes, executar testes e classes de pacotes em seu formato distribuível, como, por exemplo, um arquivo JAR.
+
+Se você usa comandos diferentes para criar seu projeto ou se você desejar usar uma atividade diferente, você poderá especificá-los. Por exemplo, é possível que você deseje executar a tarefa `pacote` configurada no seu arquivo _ci.gradle_.
+
+{% raw %}
+```yaml
+etapas:
+  - usa: actions/checkout@v2
+  - ususaes: actions/setup-java@v1
+    com:
+      java-version: 1.8
+  - Nome: Executa a tarefa do pacote do Gradle
+    executar: ./gradlew -b ci.gradle package
+```
+{% endraw %}
+
+### Memorizar dependências
+
+Você pode armazenar as suas dependências para acelerar as execuções do seu fluxo de trabalho. Após a conclusão bem-sucedida, a sua cache do pacote do Gradle local será armazenada na infraestrutura do GitHub Actions. Para os fluxos de trabalho futuros, a cache será restaurada para que as dependências não precisem ser baixadas dos repositórios de pacotes remotos. Para obter mais informações, consulte "[Memorizando dependências para acelerar os fluxos de trabalho](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)" e a ação [`cache`](https://github.com/marketplace/actions/cache).
+
+{% raw %}
+```yaml
+etapas:
+  - usa: actions/checkout@v2
+  - nome: Set up JDK 1.8
+    usa: actions/setup-java@v1
+    com:
+      java-version: 1.8
+  - nome: Cache Gradle packages
+    usa: actions/cache@v2
+    com:
+      caminho: ~/.gradle/caches
+      Chave: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle') }}
+      restore-keys: ${{ runner.os }}-gradle
+  - Nome: Criar com Gradle
+    executar: ./gradlew build
+```
+{% endraw %}
+
+Este fluxo de trabalho salvará o conteúdo da sua cache local do pacote Gradle, localizado no diretório `.gradle/caches` do diretório principal do executor. A chave da cache será o conteúdo em hash dos arquivos de criação do Gradle. Portanto, suas alterações irão invalidar a cache.
+
+### Empacotar dados do fluxo de trabalho como artefatos
+
+Após a sua criação ter sido criada com sucesso e os seus testes aprovados, é possível que você deseje fazer o upload dos Java resultantes como um artefato de criação. Isso armazenará os pacotes criados como parte da execução do fluxo de trabalho e permitirá que você faça o download desses pacotes. Os artefatos podem ajudá-lo a testar e depurar os pull requests no seu ambiente local antes de serem mesclados. Para obter mais informações, consulte "[Dados recorrentes do fluxo de trabalho que usam artefatos](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)".
+
+De modo geral, o Gradle cria arquivos de saída como JARs, EARs ou WARs no diretório `build/libs`. Você pode fazer upload do conteúdo desse diretório usando a ação `upload-artefact`.
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+  - run: ./gradlew build
+  - uses: actions/upload-artifact@v2
+    with:
+      name: Package
+      path: build/libs
+```
+{% endraw %}
diff --git a/translations/pt-BR/content/actions/guides/building-and-testing-java-with-maven.md b/translations/pt-BR/content/actions/guides/building-and-testing-java-with-maven.md
new file mode 100644
index 000000000000..a2c46a5af98e
--- /dev/null
+++ b/translations/pt-BR/content/actions/guides/building-and-testing-java-with-maven.md
@@ -0,0 +1,135 @@
+---
+title: Criar e estar o Java com o Maven
+intro: Você pode criar um fluxo de trabalho de integração contínua (CI) no GitHub Actions para criar e testar o seu projeto Java com o Maven.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/building-and-testing-java-with-maven
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introdução
+
+Este guia mostra como criar um fluxo de trabalho que realiza a integração contínua (CI) para o seu projeto Java usando a ferramenta de gerenciamento de projeto do software Maven. O fluxo de trabalho que você criar permitirá que você veja quando commits em um pull request gerarão falhas de criação ou de teste em comparação com o seu branch-padrão. Essa abordagem pode ajudar a garantir que seu código seja sempre saudável. Você pode estender seu fluxo de trabalho de CI para memorizar arquivos e fazer o upload de artefatos a partir da execução de um fluxo de trabalho.
+
+Os executores hospedados em {% data variables.product.prodname_dotcom %} têm uma cache de ferramentas com um software pré-instalado, que inclui kits de desenvolvimento Java (JDKs) e Maven. Para uma lista de software e as versões pré-instaladas para JDK e Maven, consulte "[Especificações para executores hospedados em {% data variables.product.prodname_dotcom %}](/actions/reference/specifications-for-github-hosted-runners/#supported-software)".
+
+### Pré-requisitos
+
+Você deve estar familiarizado com o YAML e a sintaxe do {% data variables.product.prodname_actions %}. Para obter mais informações, consulte:
+- "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)"
+- "[Aprenda {% data variables.product.prodname_actions %}](/actions/learn-github-actions)"
+
+Recomendamos que você tenha um entendimento básico da estrutura do Java e do Maven. Para obter mais informações, consulte "[Guia de introdução ao Maven](http://maven.apache.org/guides/getting-started/index.html)" na documentação do Maven.
+
+{% data reusables.actions.enterprise-setup-prereq %}
+
+### Introdução com um modelo de fluxo de trabalho do Maven
+
+{% data variables.product.prodname_dotcom %} fornece um modelo de fluxo de trabalho Maven que funcionará para a maioria dos projetos Java baseados no Maven. Para obter mais informações, consulte o [modelo do fluxo de trabalho do Maven](https://github.com/actions/starter-workflows/blob/main/ci/maven.yml).
+
+Para começar rapidamente, você pode escolher o modelo do Maven pré-configurado ao criar um novo fluxo de trabalho. Para obter mais informações, consulte o início rápido "[{% data variables.product.prodname_actions %}](/actions/quickstart)".
+
+Você também pode adicionar este fluxo de trabalho manualmente, criando um novo arquivo no diretório `.github/workflows` do seu repositório.
+
+{% raw %}
+```yaml
+nome: Java CI
+
+em: [push]
+
+trabalhos:
+  criar:
+    runs-on: ubuntu-latest
+
+    etapas:
+      - usa: actions/checkout@v2
+      - nome: Set up JDK 1.8
+        usa: actions/setup-java@v1
+        com:
+          java-version: 1.8
+      - nome: Criado com Maven
+        executar: mvn -B package --file pom.xml
+```
+{% endraw %}
+
+Este fluxo de trabalho executa os seguintes passos:
+
+1. O `checkout` faz o download de uma cópia do seu repositório no executor.
+2. A etapa `setup-java` configura o Java 1.8 JDK.
+3. A etapa "Construir com Maven" executa o `pacote`-alvo Maven alvo de modo não interativo para garantir que seu código de seja criado, o seu teste seja aprovado e que seja possível criar um pacote.
+
+Os modelos-padrão do fluxo de trabalho são excelentes pontos de partida ao criar seu fluxo de trabalho de compilação e teste, e você pode personalizar o modelo para atender às necessidades do seu projeto.
+
+{% data reusables.github-actions.example-github-runner %}
+
+{% data reusables.github-actions.java-jvm-architecture %}
+
+### Criar e testar seu código
+
+Você pode usar os mesmos comandos usados localmente para criar e testar seu código.
+
+O fluxo de trabalho inicial executará o `pacote`-alvo por padrão. Na configuração-padrão do Maven, este comando fará o download das dependências, criará classes, executará testes e classes de pacotes em seu formato distribuível, como, por exemplo, um arquivo JAR.
+
+Se você usa comandos diferentes para criar seu projeto ou se desejar usar um alvo diferente, você poderá especificá-los. Por exemplo, você pode desejar executar o alvo de `verificar`, configurado em um arquivo _pom-ci.xml_.
+
+{% raw %}
+```yaml
+etapas:
+  - usa: actions/checkout@v2
+  - usa: actions/setup-java@v1
+    com:
+      java-version: 1.8
+  - nome: Executar a fase de verificação do Maven
+    executar: mvn -B verify --file pom-ci.xml
+```
+{% endraw %}
+
+### Memorizar dependências
+
+Você pode armazenar as suas dependências para acelerar as execuções do seu fluxo de trabalho. Após a conclusão bem-sucedida, o seu repositório local do Maven será armazenado na infraestrutura do GitHub Actions. Para os fluxos de trabalho futuros, a cache será restaurada para que as dependências não precisem ser baixadas dos repositórios remotos do Maven. Para obter mais informações, consulte "[Memorizando dependências para acelerar os fluxos de trabalho](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)" e a ação [`cache`](https://github.com/marketplace/actions/cache).
+
+{% raw %}
+```yaml
+etapas:
+  - usa: actions/checkout@v2
+  - nome: Set up JDK 1.8
+    usa: actions/setup-java@v1
+    cpm:
+      java-version: 1.8
+  - nome: Cache Maven packages
+    usa: actions/cache@v2
+    com:
+      caminho: ~/.m2
+      chave: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }}
+      restore-keys: ${{ runner.os }}-m2
+  - nome: Construir com Maven
+    executar: mvn -B package --file pom.xml
+```
+{% endraw %}
+
+Este fluxo de trabalho salvará o conteúdo do repositório local do Maven, localizado no diretório `.m2` do diretório inicial do executor. A chave da cache será o conteúdo em hash do _pom.xml_. Portanto, as alterações em _pom.xml_ invalidarão a cache.
+
+### Empacotar dados do fluxo de trabalho como artefatos
+
+Após a sua criação ter sido criada com sucesso e os seus testes aprovados, é possível que você deseje fazer o upload dos Java resultantes como um artefato de criação. Isso armazenará os pacotes criados como parte da execução do fluxo de trabalho e permitirá que você faça o download desses pacotes. Os artefatos podem ajudá-lo a testar e depurar os pull requests no seu ambiente local antes de serem mesclados. Para obter mais informações, consulte "[Dados recorrentes do fluxo de trabalho que usam artefatos](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)".
+
+De modo geral, o Maven criará arquivos de saída como JARs, EARs ou WARs no diretório `alvo`. Para fazer o upload como artefatos, você pode copiá-los em um novo diretório que contém artefatos a serem subidos. Por exemplo, você pode criar um diretório denominado `treinamento`. Em seguida, você pode fazer o upload do conteúdo desse diretório usando a ação `upload-artifact`.
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+  - run: mvn -B package --file pom.xml
+  - run: mkdir staging && cp target/*.jar staging
+  - uses: actions/upload-artifact@v2
+    with:
+      name: Package
+      path: staging
+```
+{% endraw %}
diff --git a/translations/pt-BR/content/actions/guides/building-and-testing-nodejs.md b/translations/pt-BR/content/actions/guides/building-and-testing-nodejs.md
new file mode 100644
index 000000000000..1746a423e8bd
--- /dev/null
+++ b/translations/pt-BR/content/actions/guides/building-and-testing-nodejs.md
@@ -0,0 +1,276 @@
+---
+title: Criar e testar Node.js
+intro: É possível criar um fluxo de trabalho de integração contínua (CI) para criar e testar o seu projeto Node.js.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions
+  - /actions/language-and-framework-guides/using-nodejs-with-github-actions
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introdução
+
+Este guia mostra como criar um fluxo de trabalho de integração contínua (CI) que cria e testa o código Node.js. Se o seu teste de CI for aprovado, é possível que você deseje publicar seu código ou um pacote.
+
+### Pré-requisitos
+
+Recomendamos que você tenha um entendimento básico do Node.js, YAML, das opções de configuração do fluxo de trabalho e de como criar um arquivo do fluxo de trabalho. Para obter mais informações, consulte:
+
+- "[Aprenda {% data variables.product.prodname_actions %}](/actions/learn-github-actions)"
+- "[Começar com Node.js](https://nodejs.org/en/docs/guides/getting-started-guide/)"
+
+{% data reusables.actions.enterprise-setup-prereq %}
+
+### Introdução com o modelo de workflow do Node.js
+
+O {% data variables.product.prodname_dotcom %} fornece um modelo de fluxo de trabalho do Node.js que funcionará para a maioria dos projetos Node.js. Esse guia inclui exemplos de npm e Yarn que você pode usar para personalizar o modelo. Para obter mais informações, consulte o [modelo do fluxo de trabalho do Node.js](https://github.com/actions/starter-workflows/blob/main/ci/node.js.yml).
+
+Para iniciar rapidamente, adicione o modelo ao diretório `.github/workflows` do repositório.
+
+{% raw %}
+```yaml
+Nome: Node.js CI
+
+em: [push]
+
+trabalhos:
+  criar:
+
+    runs-on: ubuntu-latest
+
+    estratégia:
+      matriz:
+        node-version: [8.x, 10.x, 12.x]
+
+    etapas:
+    - usa: actions/checkout@v2
+    - nome: Use Node.js ${{ matrix.node-version }}
+      usa: actions/setup-node@v1
+      com:
+        node-version: ${{ matrix.node-version }}
+    - executa: npm install
+    - executa: npm run build --if-present
+    - executa: npm test
+      env:
+        CI: true
+```
+{% endraw %}
+
+{% data reusables.github-actions.example-github-runner %}
+
+### Especificar a versão do Node.js
+
+A maneira mais fácil de especificar uma versão do Node.js é usar a ação `setup-node` fornecida pelo {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte [`setup-node`](https://github.com/actions/setup-node/).
+
+A ação `setup-node` considera uma versão do Node.js como uma entrada e configura essa versão no executor. A ação `setup-node` localiza uma versão específica do Node.js da cache das ferramentas em casa executor e adiciona os binários necessários ao `PATH`, que persiste no resto do trabalho. Usar a ação `setup-node` é a forma recomendada de usar o Node.js com {% data variables.product.prodname_actions %}, pois garante um comportamento consistente nos diferentes executores e nas diferentes versões do Node.js. Se você estiver usando um executor auto-hospedado, você deverá instalar o Node.js e adicioná-lo ao `PATH`.
+
+O modelo inclui uma estratégia de matriz que cria e testa o seu código com três versões do Node.js: 8.x, 10.x, e 12.x. O "x" é um caractere curinga que corresponde à última versão menor e à versão do patch disponível para uma versão. Cada versão do Node.js especificada na matriz `node-version` cria uma tarefa que executa as mesmas etapas.
+
+Cada trabalho pode acessar o valor definido na matriz `node-version` usando o contexto `matriz`. A ação `setup-node` usa o contexto como entrada de `node-version`. A ação `setup-node` configura cada tarefa com uma versão diferente de Node.js antes de criar e testar o código. Para obter mais informações sobre os contextos e estratégias da matriz, consulte ""[Sintaxe do fluxo de trabalho para {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix)" e "[Contexto e sintaxe de expressão para {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)".
+
+{% raw %}
+```yaml
+estratégia:
+  matriz:
+    node-version: [8.x, 10.x, 12.x]
+
+etapas:
+- usa: actions/checkout@v2
+- Nome: Use Node.js ${{ matrix.node-version }}
+  usa: actions/setup-node@v1
+  com:
+    node-version: ${{ matrix.node-version }}
+```
+{% endraw %}
+
+Como alternativa, você pode criar e fazes testes com versões exatas do Node.js.
+
+```yaml
+estratégia:
+  matriz:
+    node-version: [8.16.2, 10.17.0]
+```
+
+Você também pode criar e testar usando uma versão única do Node.js.
+
+{% raw %}
+```yaml
+Nome: Node.js CI
+
+em: [push]
+
+trabalhos:
+  criar:
+
+    runs-on: ubuntu-latest
+
+    etapas:
+    - usa: actions/checkout@v2
+    - Nome: Usa o Node.js
+      usa: actions/setup-node@v1
+      com:
+        node-version: '12.x'
+    - executar: npm install
+    - executar: npm run build --if-present
+    - executar: npm test
+      env:
+        CI: true
+```
+{% endraw %}
+
+Se você não especificar uma versão do Node.js, o {% data variables.product.prodname_dotcom %} usará a versão-padrão do Node.js do ambiente. Para obter mais informações, consulte "[Especificações para executores hospedados no {% data variables.product.prodname_dotcom %}](/actions/reference/specifications-for-github-hosted-runners/#supported-software)".
+
+### Instalar dependências
+
+Executores hospedados em {% data variables.product.prodname_dotcom %} têm gerenciadores de dependências npm e Yarn instalados. Você pode usar o npm e o Yarn para instalar dependências no seu fluxo de trabalho antes de criar e testar seu código. Os executores do Windows e Linux hospedados em {% data variables.product.prodname_dotcom %} também têm o Grunt, Gulp, e Bower instalado.
+
+Você também pode memorizar as dependências para acelerar seu fluxo de trabalho. Para obter mais informações, consulte "[Memorizando dependências para acelerar seu fluxo de trabalho](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)".
+
+#### Exemplo de uso do npm
+
+Este exemplo instala as dependências definidas no arquivo *package.json*. Para obter mais informações, consulte [`instalação do npm`](https://docs.npmjs.com/cli/install).
+
+```yaml
+etapas:
+- usa: actions/checkout@v2
+- nome: Use Node.js
+  usa: actions/setup-node@v1
+  com:
+    node-version: '12.x'
+- nome: Instalar dependências
+  executar: npm install
+```
+
+O uso do `npm ci` instala as versões no arquivo *package-lock.json* ou *npm-shrinkwrap.json* e impede as atualizações do arquivo de bloqueio. Usar `npm ci` geralmente é mais rápido que executar a `instalação do npm`. Para obter mais informações, consulte [`npm ci`](https://docs.npmjs.com/cli/ci.html) e "[Introduzindo `npm` para criações mais rápidas e confiáveis](https://blog.npmjs.org/post/171556855892/introducing-npm-ci-for-faster-more-reliable)".
+
+{% raw %}
+```yaml
+etapas:
+- usa: actions/checkout@v2
+- nome: Use Node.js
+  usa: actions/setup-node@v1
+  com:
+    node-version: '12.x'
+- nome: Instalar dependências
+  executar: npm ci
+```
+{% endraw %}
+
+#### Exemplo de uso do Yarn
+
+Este exemplo instala as dependências definidas no arquivo *package.json*. Para obter mais informações, consulte [`instalação do yarn`](https://yarnpkg.com/en/docs/cli/install).
+
+```yaml
+etapas:
+- usa: actions/checkout@v2
+- nome: Use Node.js
+  usa: actions/setup-node@v1
+  com:
+    node-version: '12.x'
+- nome: Instalar dependências
+  executar: yarn
+```
+
+Como alternativa, você pode aprovar o `--frozen-lockfile` para instalar as versões no arquivo *yarn.lock* e impedir atualizações no arquivo *yarn.lock*.
+
+```yaml
+etapas:
+- usa: actions/checkout@v2
+- nome: Use Node.js
+  usa: actions/setup-node@v1
+  com:
+    node-version: '12.x'
+- nome: Instalar dependências
+  executar: yarn --frozen-lockfile
+```
+
+#### Exemplo do uso de um registro privado e de criação o arquivo .npmrc
+
+{% data reusables.github-actions.setup-node-intro %}
+
+Para fazer a autenticação no seu registro privado, você deverá armazenar seu token de autenticação npm como um segredo nas configurações do seu repositório. Por exemplo, crie um segredo denominado `NPM_TOKEN`. Para obter mais informações, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)".
+
+No exemplo abaixo, o segredo `NPM_TOKEN` armazena o token de autenticação npm. A ação `setup-node` configura o arquivo *.npmrc* para ler o token de autenticação npm a partir da variável de ambiente `NODE_AUTH_TOKEN`. Ao usar a ação `setup-node` para criar um arquivo *.npmrc*, você deverá definir a variável de ambiente `NPM_AUTH_TOKEN` com o segredo que contém seu token de autenticação npm.
+
+Antes de instalar as dependências, use a ação `setup-node` para criar o arquivo *.npmrc* file. A ação tem dois parâmetros de entrada. O parâmetro `node-version` define a versão do Node.js e o parâmetro `registry-url` define o registro-padrão. Se o registro do seu pacote usar escopos, você deverá usar o parâmetro `escopo`. Para obter mais informações, consulte [`npm-scope`](https://docs.npmjs.com/misc/scope).
+
+{% raw %}
+```yaml
+etapas:
+- usa: actions/checkout@v2
+- nome: Use Node.js
+  usa: actions/setup-node@v1
+  com:
+    always-auth: true
+    node-version: '12.x'
+    registry-url: https://registry.npmjs.org
+    escopo: '@octocat'
+- nome: Instalar dependências
+  executar: npm ci
+  env:
+    NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}}
+```
+{% endraw %}
+
+O exemplo acima cria um arquivo *.npmrc* com o conteúdo a seguir:
+
+```
+//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN}
+@octocat:registry=https://registry.npmjs.org/
+always-auth=true
+```
+
+#### Exemplo de memorização de dependências
+
+Você pode memorizar dependências usando uma chave única e restaurar as dependências ao executar fluxos de trabalho futuros usando a ação `cache`. Para obter mais informações, consulte "[Memorizando dependências para acelerar os fluxos de trabalho](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)" e a ação [`cache`](https://github.com/marketplace/actions/cache).
+
+{% raw %}
+```yaml
+etapas:
+- usa: actions/checkout@v2
+- nome: Use Node.js
+  usa: actions/setup-node@v1
+  com:
+    node-version: '12.x'
+- nome: Cache Node.js modules
+  usa: actions/cache@v2
+  com:
+    # Os arquivos da cache do npm estão armazenados em `~/.npm` no Linux/macOS
+    caminho: ~/.npm 
+    chave: ${{ runner.OS }}-node-${{ hashFiles('**/package-lock.json') }}
+    restore-keys: |
+      ${{ runner.OS }}-node-
+      ${{ runner.OS }}-
+- nome: Instalar dependências
+  executar: npm ci
+```
+{% endraw %}
+
+### Criar e testar seu código
+
+Você pode usar os mesmos comandos usados localmente para criar e testar seu código. Por exemplo, se você executar `criação da execução do npm` para executar os passos de compilação definidos no seu arquivo *package.json* e o `teste do npm` para executar seu conjunto de testes, você adicionaria esses comandos no seu arquivo de fluxo de trabalho.
+
+```yaml
+etapas:
+- usa: actions/checkout@v2
+- nome: Use Node.js
+  usa: actions/setup-node@v1
+  com:
+    node-version: '12.x'
+- executar: npm install
+- executar: npm run build --if-present
+- executar: npm test
+```
+
+### Empacotar dados do fluxo de trabalho como artefatos
+
+Você pode salvar artefatos das suas etapas de criação e teste para serem visualizados após a conclusão de um trabalho. Por exemplo, é possível que você precise salvar os arquivos de registro, os despejos de núcleo, os resultados de teste ou capturas de tela. Para obter mais informações, consulte "[Dados recorrentes do fluxo de trabalho que usam artefatos](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)".
+
+### Publicar nos registros do pacote
+
+Você pode configurar o seu fluxo de trabalho para publicar o seu pacote Node.js em um pacote de registro após os seus testes de CI serem aprovados. Para obter mais informações sobre a publicação no npm e em {% data variables.product.prodname_registry %}, consulte "[Publicando pacotes do Node.js](/actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages)".
diff --git a/translations/pt-BR/content/actions/guides/building-and-testing-python.md b/translations/pt-BR/content/actions/guides/building-and-testing-python.md
new file mode 100644
index 000000000000..1ced3ffe2c29
--- /dev/null
+++ b/translations/pt-BR/content/actions/guides/building-and-testing-python.md
@@ -0,0 +1,427 @@
+---
+title: Criar e testar o Python
+intro: É possível criar um fluxo de trabalho de integração contínua (CI) para criar e testar o seu projeto Python.
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/using-python-with-github-actions
+  - /actions/language-and-framework-guides/using-python-with-github-actions
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introdução
+
+Este guia mostra como criar, testar e publicar um pacote no Python.
+
+Os executores hospedados em {% data variables.product.prodname_dotcom %} possuem uma cache de ferramentas com um software pré-instalado, que inclui o Python e o PyPy. Você não precisa instalar nada! Para obter uma lista completa do software atualizado e das versões pré-instaladas do Python e PyPy, consulte "[Especificações para executores hospedados em {% data variables.product.prodname_dotcom %}](/actions/reference/specifications-for-github-hosted-runners/#supported-software)".
+
+### Pré-requisitos
+
+Você deve estar familiarizado com o YAML e a sintaxe do {% data variables.product.prodname_actions %}. Para obter mais informações, consulte "[Aprenda {% data variables.product.prodname_actions %}](/actions/learn-github-actions)".
+
+Recomendamos que você tenha um entendimento básico do Python, PyPy e pip. Para obter mais informações, consulte:
+- [Primeiros passos com o Python](https://www.python.org/about/gettingstarted/)
+- [PyPy](https://pypy.org/)
+- [Gerenciador de pacotes do Pip](https://pypi.org/project/pip/)
+
+{% data reusables.actions.enterprise-setup-prereq %}
+
+### Introdução com o modelo do fluxo de trabalho do Python
+
+O {% data variables.product.prodname_dotcom %} fornece um modelo de fluxo de trabalho do Python que deve funcionar na maioria dos projetos Python. Este guia inclui exemplos que você pode usar para personalizar o modelo. Para obter mais informações, consulte o [modelo de fluxo de trabalho do Python](https://github.com/actions/starter-workflows/blob/main/ci/python-package.yml).
+
+Para iniciar rapidamente, adicione o modelo ao diretório `.github/workflows` do repositório.
+
+{% raw %}
+```yaml
+nome: Pacote do Python
+
+em: [push]
+
+trabalhos:
+  criar:
+
+    runs-on: ubuntu-latest
+    estratégia:
+      matriz:
+        python-version: [2.7, 3.5, 3.6, 3.7, 3.8]
+
+    etapas:
+    - usa: actions/checkout@v2
+    - nome: Configura o Python ${{ matrix.python-version }}
+      usa: actions/setup-python@v2
+      com:
+        python-version: ${{ matrix.python-version }}
+    - nome: Instalar dependências
+      executar: |
+        python -m pip install --upgrade pip
+        pip install flake8 pytest
+        if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
+    - nome : Lint with flake8
+      executar: |
+        # interrompe a criação em caso de erros de sintaxe do Python ou de nomes indefinidos
+        flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+        # exit-zero trata todos os errors como avisos. O editor do GitHub tem 127 caracteres
+        flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+    - nome: Testar com pytest
+      executar: |
+        pytest
+```
+{% endraw %}
+
+### Especificar uma versão do Python
+
+Para usar uma versão pré-instalada do Python ou do PyPy em um executor hospedado em {% data variables.product.prodname_dotcom %}, use a ação `setup-python`. Esta ação encontra uma versão específica do Python ou do PyPy na cache das ferramenatas em cada executor e adiciona os binários necessários ao `PATH`, que persiste para o restante do trabalho. Se uma versão específica do Python não for pré-instalada na cache de ferramentas, a `setup-python` ação fará o download e irá configurar a versão apropriada do repositório [`python-versions`](https://github.com/actions/python-versions).
+
+Using the `setup-action` is the recommended way of using Python with {% data variables.product.prodname_actions %} because it ensures consistent behavior across different runners and different versions of Python. Se você estiver usando um executor auto-hospedado, você deverá instalar Python e adicioná-lo ao `PATH`. Para obter mais informações, consulte a ação [`setup-python`](https://github.com/marketplace/actions/setup-python).
+
+A tabela abaixo descreve os locais para o armazenamento de ferramentas em cada executor hospedado em {% data variables.product.prodname_dotcom %}.
+
+|                                      | Ubuntu                          | Mac                                      | Windows                                    |
+| ------------------------------------ | ------------------------------- | ---------------------------------------- | ------------------------------------------ |
+| **Diretório da cache da ferramenta** | `/opt/hostedtoolcache/*`        | `/Users/runner/hostedtoolcache/*`        | `C:\hostedtoolcache\windows\*`         |
+| **Cache da ferramenta do Python**    | `/opt/hostedtoolcache/Python/*` | `/Users/runner/hostedtoolcache/Python/*` | `C:\hostedtoolcache\windows\Python\*` |
+| **Cache da ferramenta do PyPy**      | `/opt/hostedtoolcache/PyPy/*`   | `/Users/runner/hostedtoolcache/PyPy/*`   | `C:\hostedtoolcache\windows\PyPy\*`   |
+
+Se você estiver usando um executor auto-hospedado, você poderá configurá-lo para usar a ação `setup-python` para gerenciar suas dependências. Para obter mais informações, consulte [usando o setup-python com um executor auto-hospedado](https://github.com/actions/setup-python#using-setup-python-with-a-self-hosted-runner) na LEIAME do `setup-python`.
+
+O {% data variables.product.prodname_dotcom %} é compatível com a sintaxe semântica de versionamento. Para obter mais informações, consulte "[Usar o versionamento semântico](https://docs.npmjs.com/about-semantic-versioning#using-semantic-versioning-to-specify-update-types-your-package-can-accept)" e "[Especificação do versionamento semântico](https://semver.org/)".
+
+#### Usar várias versões do Python
+
+{% raw %}
+```yaml
+nome: Pacote Python
+
+em: [push]
+
+trabalhos:
+  criar:
+
+    runs-on: ubuntu-latest
+    estratégia:
+      # Você pode usar as versões do PyPy em python-version.
+      # Por exemplo, pypy2 and pypy3
+      matriz:
+        python-version: [2.7, 3.5, 3.6, 3.7, 3.8]
+
+    etapas:
+    - usa: actions/checkout@v2
+    - nome: Configura o Python ${{ matrix.python-version }}
+      usa: actions/setup-python@v2
+      com:
+        python-version: ${{ matrix.python-version }}
+    # Você pode testar a sua matriz imprimindo a versão atual do Python
+    - nome: Exibe a versão do Python
+      executar: python -c "import sys; print(sys.version)"
+```
+{% endraw %}
+
+#### Usar uma versão específica do Python
+
+Você pode configurar uma versão específica do python. Por exemplo, 3,8. Como alternativa, você pode usar a sintaxe da versão semântica para obter a última versão secundária. Este exemplo usa a última versão secundária do Python 3.
+
+{% raw %}
+```yaml
+nome: Pacote Python
+
+em: [push]
+
+trabalhos:
+  criar:
+
+    runs-on: ubuntu-latest
+
+    etapas:
+    - usa: actions/checkout@v2
+    - nome: Configura Python 3.x
+      usa: actions/setup-python@v2
+      com:
+        # Sintaxe do intervalo da versão semântica ou versão exata de uma versão do Python
+        python-version: '3.x' 
+        # Opcional - x64 or x86 architecture, defaults to x64
+        arquitetura: 'x64' 
+    # Você pode testar a sua matriz imprimindo a versão atual do Python
+    - nome: Exibir uma versão do Python
+      executar: python -c "import sys; print(sys.version)"
+```
+{% endraw %}
+
+#### Excluir uma versão
+
+Se especificar uma versão do Python que estiver indisponível, `setup-python` ocorrerá uma falha com um erro como: `##[error]Version 3.4 with arch x64 not found`. A mensagem de erro inclui as versões disponíveis.
+
+Também é possível usar a palavra-chave `excluir` no seu fluxo de trabalho se houver uma configuração do Python que você não deseja executar. Para obter mais informações, consulte a sintaxe "[ para {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategy)."
+
+{% raw %}
+```yaml
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: [2.7, 3.6, 3.7, 3.8, pypy2, pypy3]
+        exclude:
+          - os: macos-latest
+            python-version: 3.6
+          - os: windows-latest
+            python-version: 3.6
+```
+{% endraw %}
+
+#### Usar a versão padrão do Python
+
+Recomendamos usar `setup-python` para configurar a versão do Python usada nos seus fluxos de trabalho, porque isso ajuda a deixar as suas dependências explícitas. Se você não usar `setup-python`, a versão padrão do Python definida em `PATH` será usada em qualquer shell quando você chamar `python`. A versão-padrão do Python varia entre executores hospedados no {% data variables.product.prodname_dotcom %}, o que pode causar mudanças inesperadas ou usar uma versão mais antiga do que o esperado.
+
+| Executor hospedado em{% data variables.product.prodname_dotcom %} | Descrição                                                                                                                                                                                                                                                                                                                                                                                                |
+| ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Ubuntu                                                            | Os executores do Ubuntu têm várias versões do sistema do Python instaladas em `/usr/bin/python` e `/usr/bin/python3`. As versões do Python que vêm empacotadas com o Ubuntu são adicionais às versões que o {% data variables.product.prodname_dotcom %} instala na cache das ferramentas.                                                                                                               |
+| Windows                                                           | Excluindo as versões do Python que estão na cache de ferramentas, o Windows não é compatível com uma versão equivalente do sistema do Python. Para manter um comportamento consistente com outros executores e permitir que o Python seja usado de forma inovadora sem a ação `setup-python` , {% data variables.product.prodname_dotcom %} adiciona algumas versões da cache das ferramentas ao `PATH`. |
+| macOS                                                             | Os executores do macOS têm mais de uma versão do sistema do Python instalada, além das versões que fazem parte da cache de ferramentas. As versões do sistema do Python estão localizadas no diretório `/usr/local/Cellar/python/*`.                                                                                                                                                                     |
+
+### Instalar dependências
+
+Os executores hospedados em {% data variables.product.prodname_dotcom %} têm instalado o gerenciador do pacote pip. Você pode usar o pip para instalar dependências do registro de pacotes do PyPI antes de criar e testar o seu código. Por exemplo, o YAML abaixo instala ou atualiza o instalador de pacotes `pip` e as os pacotes `setuptools` e `wheel`.
+
+Você também pode memorizar as dependências para acelerar seu fluxo de trabalho. Para obter mais informações, consulte "[Memorizando dependências para acelerar seu fluxo de trabalho](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)".
+
+{% raw %}
+```yaml
+etapas:
+- usa: actions/checkout@v2
+- nome: Configurar Python
+  usa: actions/setup-python@v2
+  com:
+    python-version: '3.x'
+- Nome: Instalar dependências
+  executar: python -m pip install --upgrade pip setuptools wheel
+```
+{% endraw %}
+
+#### Arquivo de requisitos
+
+Depois de atualizar o `pip`, um o próximo passo típico é instalar as dependências de *requirements.txt*.
+
+{% raw %}
+```yaml
+etapas:
+- usa: actions/checkout@v2
+- nome: Configurar Python
+  usa: actions/setup-python@v2
+  com:
+    python-version: '3.x'
+- nome: Instalar dependências
+  executar: |
+    python -m pip install --upgrade pip
+    pip install -r requirements.txt
+```
+{% endraw %}
+
+#### Memorizar dependências
+
+Você pode armazenar dependências do pip usando uma chave única e restaurar as dependências quando você executar fluxos de trabalho futuros usando a ação [`cache`](https://github.com/marketplace/actions/cache). Para obter mais informações, consulte "[Memorizando dependências para acelerar fluxos de trabalho](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)".
+
+O Pip armazena dependências em diferentes locais, dependendo do sistema operacional do executor. O caminho que você precisa efetuar o armazenamento em cache pode ser diferente do exemplo do Ubuntu abaixo, dependendo do sistema operacional que você usa. Para obter mais informações, consulte [Exemplos de armazenamento em cache do Python](https://github.com/actions/cache/blob/main/examples.md#python---pip).
+
+{% raw %}
+```yaml
+etapas:
+- usa: actions/checkout@v2
+- nome: Setup Python
+  usa: actions/setup-python@v2
+  com:
+    python-version: '3.x'
+- nome: Cache pip
+  usa: actions/cache@v2
+  com:
+    # Este caminho é específico para o Ubuntu
+    caminho: ~/.cache/pip
+    # Observe se há uma correspondência da cache para o arquivo de requisitos correspondente
+    chave: ${{ runner.os }}-pip-${{ hashFiles('requirements.txt') }}
+    restore-keys: |
+      ${{ runner.os }}-pip-
+      ${{ runner.os }}-
+- nome: Instalar dependências
+  executar: pip install -r requirements.txt
+```
+{% endraw %}
+
+{% note %}
+
+**Observação:** Dependendo do número de dependências, pode ser mais rápido para usar o armazenamento de dependências. Os projetos com muitas dependências grandes devem ver um aumento no desempenho conforme reduz o tempo necessário para fazer o download. Os projetos com menos dependências podem não ver um aumento significativo no desempenho e até mesmo ver um ligeiro diminuir devido à forma como o pip instala dependências armazenadas em cache. O desempenho varia de projeto para projeto.
+
+{% endnote %}
+
+### Testar seu código
+
+Você pode usar os mesmos comandos usados localmente para criar e testar seu código.
+
+#### Testar com pytest e pytest-cov
+
+Este exemplo instala ou atualiza `pytest` e `pytest-cov`. Em seguida, os testes são executados e retornados no formato JUnit enquanto os resultados da cobertura do código são emitidos em Cobertura. Para obter mais informações, consulte [JUnit](https://junit.org/junit5/) e [Cobertura](https://cobertura.github.io/cobertura/).
+
+{% raw %}
+```yaml
+etapas:
+- usa: actions/checkout@v2
+- nome: Set up Python
+  usa: actions/setup-python@v2
+  com:
+    python-version: '3.x'
+- nome: Instalar dependências
+  executar: |
+    python -m pip install --upgrade pip
+    pip install -r requirements.txt
+- Nome: Testar com pytest
+  executar: |
+    pip install pytest
+    pip install pytest-cov
+    pytest tests.py --doctest-modules --junitxml=junit/test-results.xml --cov=com --cov-report=xml --cov-report=html
+```
+{% endraw %}
+
+#### UsarFlake8 para código lint
+
+O exemplo a seguir instala ou atualiza o `flake8` e o usa para limpar todos os arquivos. Para obter mais informações, consulte [Flake8](http://flake8.pycqa.org/en/latest/).
+
+{% raw %}
+```yaml
+etapas:
+- usa: actions/checkout@v2
+- nome: Configurar Python
+  usa: actions/setup-python@v2
+  com:
+    python-version: '3.x'
+- nome: Instalar dependências
+  executar: |
+    python -m pip install --upgrade pip
+    pip install -r requirements.txt
+- nome: Lint with flake8
+  run: |
+    pip install flake8
+    flake8 .
+```
+{% endraw %}
+
+#### Executar testes com tox
+
+Com {% data variables.product.prodname_actions %}, você pode executar testes com tox e distribuir o trabalho para vários trabalhos. Você precisará invocar tox usando a opção `-e py` para escolher a versão do Python no seu `PATH`, em vez de especificar uma versão específica. Para obter mais informações, consulte [tox](https://tox.readthedocs.io/en/latest/).
+
+{% raw %}
+```yaml
+nome: Pacote Python
+
+em: [push]
+
+trabalhos:
+  criar:
+
+    runs-on: ubuntu-latest
+    estratégia:
+      matriz:
+        python: [2.7, 3.7, 3.8]
+
+    etapa:
+      - usa: actions/checkout@v2
+      - nome: Setup Python
+        usa: actions/setup-python@v2
+        com:
+          python-version: ${{ matrix.python }}
+      - nome: Instalar Toxe e todos os outros pacotes
+        executar: pip install tox
+      - nome: Executar Tox
+        # Executar tox usando a versão do Python no `PATH`
+        run: tox -e py
+```
+{% endraw %}
+
+### Empacotar dados do fluxo de trabalho como artefatos
+
+Você pode fazer o upload de artefatos para visualização após a conclusão de um fluxo de trabalho. Por exemplo, é possível que você precise salvar os arquivos de registro, os despejos de núcleo, os resultados de teste ou capturas de tela. Para obter mais informações, consulte "[Dados recorrentes do fluxo de trabalho que usam artefatos](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)".
+
+O exemplo a seguir demonstra como você pode usar a ação `upload-artefact` para arquivar os resultados de teste da execução do `pytest`. Para obter mais informações, consulte a ação <[`upload-artifact`](https://github.com/actions/upload-artifact).
+
+{% raw %}
+```yaml
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: [2.7, 3.5, 3.6, 3.7, 3.8]
+
+      steps:
+      - uses: actions/checkout@v2
+      - name: Setup Python # Set Python version
+        uses: actions/setup-python@v2
+        with:
+          python-version: ${{ matrix.python-version }}
+      # Install pip and pytest
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install pytest
+      - name: Test with pytest
+        run: pytest tests.py --doctest-modules --junitxml=junit/test-results-${{ matrix.python-version }}.xml
+      - name: Upload pytest test results
+        uses: actions/upload-artifact@v2
+        with:
+          name: pytest-results-${{ matrix.python-version }}
+          path: junit/test-results-${{ matrix.python-version }}.xml
+        # Use always() to always run this step to publish test results when there are test failures
+        if: ${{ always() }}
+```
+{% endraw %}
+
+### Publicar nos registros do pacote
+
+Você pode configurar o seu fluxo de trabalho para publicar seu pacote de Python em qualquer registro de pacote que você desejar quando forem aprovados os seus testes de CI.
+
+Você pode armazenar qualquer token de acesso ou credenciais necessárias para publicar seu pacote usando segredos do repositório. O exemplo a seguir cria e publica um pacote no PyPI usando `twine` e `dist`. Para obter mais informações, consulte "[Criando e usando segredos encriptados](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)".
+
+{% raw %}
+```yaml
+Nome: Fazer o upload no pacote Python
+
+em:
+  versão:
+    tipos: [created]
+
+trabalhos:
+  implementar:
+    runs-on: ubuntu-latest
+    etapas:
+    - usa: actions/checkout@v2
+    - nome: Configurar Python
+      usa: actions/setup-python@v2
+      com:
+        python-version: '3.x'
+    - nome: Instalar dependências
+      executar: |
+        python -m pip install --upgrade pip
+        pip install setuptools wheel twine
+    - nome: Criar e publicar
+      env:
+        TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }}
+        TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
+      executar: |
+        python setup.py sdist bdist_wheel
+        twine upload dist/*
+```
+{% endraw %}
+
+Para obter mais informações sobre o fluxo de trabalho de template, consulte [`python-publish`](https://github.com/actions/starter-workflows/blob/main/ci/python-publish.yml).
diff --git a/translations/pt-BR/content/actions/guides/caching-dependencies-to-speed-up-workflows.md b/translations/pt-BR/content/actions/guides/caching-dependencies-to-speed-up-workflows.md
new file mode 100644
index 000000000000..89a0019428b9
--- /dev/null
+++ b/translations/pt-BR/content/actions/guides/caching-dependencies-to-speed-up-workflows.md
@@ -0,0 +1,192 @@
+---
+title: Memorizar dependências para acelerar os fluxos de trabalho
+shortTitle: Memorizar dependências
+intro: 'Para agilizar os seus fluxos de trabalho e torná-los mais eficientes, você pode criar e usar caches para dependências e outros arquivos reutilizados geralmente.'
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /github/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows
+  - /actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows
+  - /actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows
+versions:
+  free-pro-team: '*'
+---
+
+### Sobre a memorização das dependências do fluxo de trabalho
+
+As execuções do fluxo de trabalho geralmente reutilizam as mesmas saídas ou dependências baixadas de uma execução para outra. Por exemplo, as ferramentas de gerenciamento de pacotes e de dependência, como, por exemplo, Maven, Gradle, npm e Yarn mantêm uma cache local de dependências baixadas.
+
+Os trabalhos nos executores hospedados em {% data variables.product.prodname_dotcom %} começam em um ambiente virtual limpo e devem baixar as dependências todas as vezes, o que gera uma maior utilização da rede, maior tempo de execução e aumento dos custos. Para ajudar a acelerar o tempo que leva para recrear esses arquivos, {% data variables.product.prodname_dotcom %} pode memorizar as dependências que você usa frequentemente nos fluxos de trabalho.
+
+Para memorizar as dependências para um trabalho, você precisará usar a ação `cache` do {% data variables.product.prodname_dotcom %}. A ação recupera uma cache identificada por uma chave única. Para obter mais informações, consulte [`ações/cache`](https://github.com/actions/cache).
+
+{% warning %}
+
+**Alerta**: Recomendamos que você não armazene nenhuma informação confidencial na cache dos repositórios públicos. Por exemplo, as informações confidenciais podem incluir tokens de acesso ou credenciais de login armazenadas em um arquivo no caminho da cache. Além disso, os programas de interface da linha de comando (CLI) como o `login do Docker` pode salvar as credenciais de acesso em um arquivo de configuração. Qualquer pessoa com acesso de leitura pode criar um pull request em um repositório e acessar o conteúdo da cache. As bifurcações de um repositório também podem criar pull requests no branch-base e acessar as caches no branch-base.
+
+{% endwarning %}
+
+### Comparando artefatos e memorização de dependência
+
+Os artefatos são similares, pois fornecem a habilidade de armazenar arquivos em {% data variables.product.prodname_dotcom %}, mas cada recurso oferece usos diferentes e não podem ser usados de forma intercambiável.
+
+- Use a memorização quando desejar reutilizar os arquivos que não mudam com frequência entre trabalhos ou execuções de fluxos de trabalho.
+- Use artefatos quando desejar salvar arquivos produzidos por um trabalho a ser visualizado após a conclusão de um fluxo de trabalho. Para obter mais informações, consulte "[Dados recorrentes do fluxo de trabalho que usam artefatos](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)".
+
+### Restrições para acessar uma cache
+
+Com `v2` da ação da `cache`, você pode acessar a cache nos fluxos de trabalho ativados por qualquer evento que tem um `GITHUB_REF`. Se você estiver usando `v1` da ação da `cache`, você só poderá acessar a cache em fluxos de trabalho ativados por eventos de `push` e `pull_request`, exceto para o evento `fechado` de `pull_request`. Para obter mais informações, consulte "[Eventos que acionam fluxos de trabalho](/actions/reference/events-that-trigger-workflows)".
+
+Um fluxo de trabalho pode acessar e restaurar um cache criado no branch atual, no branch de base (incluindo branches base de repositórios bifurcados) ou no branch-padrão (geralmente `principal`). Por exemplo, um cache criado no branch-padrão pode ser acessado a partir de qualquer pull request. Além disso, se o branch `feature-b` tiver o branch de base `feature-a`, um fluxo de trabalho acionado em `feature-b` teria acesso a caches criados no branch-padrão (`principal`), `feature-a` e `feature-b`.
+
+As restrições de acesso fornecem o isolamento da cache e a segurança ao criar um limite lógico entre os diferentes fluxos e branches. Por exemplo, um cache criado para o branch `feature-a` (com a base no `principal`) não seria acessível para um pull request para o branch `feature-b` (com a base no `principal`).
+
+### Usar a ação `cache`
+
+A ação `cache` tentará restaurar uma cache com base na `chave` que você fornecer. Quando a ação encontrar uma cache, ela irá restaurar os arquivos memorizados no `caminho` que você configurar.
+
+Se não houver uma correspondência perfeita, a ação criará uma nova entrada da cache se o trabalho for concluído com sucesso. A nova cache usará a `chave` que você forneceu e conterá os arquivos no diretório do `caminho`.
+
+Como alternativa, você pode fornecer uma lista de `chaves de restauração` a serem usadas quando a `chave` não corresponder à cache existente. Uma lista de `chaves de restauração` é importante quando você está tentando restaurar uma cache de outro branch, pois `as chaves de restauração`=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introdução
+
+Este guia mostra exemplos de fluxo de trabalho que configuram um contêiner de serviço usando a imagem `postgres` do Docker Hub. O fluxo de trabalho executa um script para criar um cliente PostgreSQL e preencher os dados do cliente. Para testar se o fluxo de trabalho cria e preenche o cliente PostgreSQL, o script imprime os dados do cliente no console.
+
+{% data reusables.github-actions.docker-container-os-support %}
+
+### Pré-requisitos
+
+{% data reusables.github-actions.service-container-prereqs %}
+
+Também pode ser útil ter um entendimento básico de YAML, a sintaxe para {% data variables.product.prodname_actions %} e PostgreSQL. Para obter mais informações, consulte:
+
+- "[Aprenda {% data variables.product.prodname_actions %}](/actions/learn-github-actions)"
+- "[Tutorial do PostgreSQL](https://www.postgresqltutorial.com/)" na documentação do PostgreSQL
+
+### Executar trabalhos em contêineres
+
+{% data reusables.github-actions.container-jobs-intro %}
+
+{% data reusables.github-actions.copy-workflow-file %}
+
+{% raw %}
+```yaml
+nome: exemplo de serviço PostgreSQL
+em: push
+
+trabalhos:
+  # Etiqueta do trabalho do contêiner
+  container-job:
+    # Os contêineres devem ser executados em sistemas operacionais baseados no Linux
+    runs-on: ubuntu-latest
+    # Imagem do Docker Hub em que o `container-job` é executado
+    contêiner: node:10.18-jessie
+
+    # Contêineres de serviço a serem executados com `container-job`
+    serviços:
+      # Etiqueta usada para acessar o contêiner de serviço
+      postgres:
+        # Imagem do Docker Hub
+        imagem: postgres
+        # Fornece a senha para postgres
+        env:
+          POSTGRES_PASSWORD: postgres
+        # Define verificações gerais até a inicialização do postgres
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
+    etapas:
+      # Faz o download de uma cópia do código no seu repositório antes de executar testes de CI
+      - nome: Verifica o código do repositório
+        usa: actions/checkout@v2
+
+      # Realiza uma instalação limpa de todas as dependências no arquivo `package.json`
+      # Para obter mais informações, consulte https://docs.npmjs.com/cli/ci.html
+      - nome: Instalar dependências
+        executar: npm ci
+
+      - nome: Conectar-se ao PostgreSQL
+        # Executa um script que cria um cliente PostgreSQL client, preenche
+        # os dados do cliente e recupera dados
+        executar: node client.js
+        # Variável de ambiente usada pelo script `client.js` para criar um novo PostgreSQL client.
+        env:
+          # O nome do host usado para comunicar-se com o contêiner de serviço do PostgreSQL
+          POSTGRES_HOST: postgres
+          # A porta-padrão do PostgreSQL
+          POSTGRES_PORT: 5432
+```
+{% endraw %}
+
+#### Configurar o trabalho executor
+
+{% data reusables.github-actions.service-container-host %}
+
+{% data reusables.github-actions.postgres-label-description %}
+
+```yaml
+trabalhos:
+  # Etiqueta do trabalho do contêiner
+  container-job:
+    # Os contêineres devem ser executados em sistemas operacionais baseados no Linux
+    runs-on: ubuntu-latest
+    # Imagem do Docker Hub em que o `container-job` é executado
+    contêiner: node:10.18-jessie
+
+    # Contêineres de serviço a serem executados com `container-job`
+    serviços:
+      # Etiqueta usada para acessar o contêiner de serviço
+      postgres:
+        # Imagem do Docker Hub
+        imagem: postgres
+        # Fornece a senha para o postgres
+        env:
+          POSTGRES_PASSWORD: postgres
+        # Define as verificações gerais até a inicialização do postgres
+        opções: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+```
+
+#### Configurar as etapas
+
+{% data reusables.github-actions.service-template-steps %}
+
+```yaml
+etapas:
+  # Faz o download de uma cópia do código no seu repositório antes de executar testes de CI
+  - nome: Verifica o código do repositório
+    usa: actions/checkout@v2
+
+  # Executa uma instalação limpa de todas as dependências no arquivo `package.json`
+  # Para obter mais informações, consulte https://docs.npmjs.com/cli/ci.html
+  - Nome: Instalar dependências
+    executar: npm ci
+
+  - nome: Conectar-se ao PostgreSQL
+    # Executa um script que cria um cliente PostgreSQL client, preenche
+    # os dados do cliente e recupera dados
+    executar: node client.js
+    # Variável do ambiente usada pelo script `client.js` script para criar
+    # um novo cliente PostgreSQL.
+    env:
+      # O nome do host usado para comunicar-se com o contêiner de serviço do PostgreSQL
+      POSTGRES_HOST: postgres
+      # A porta-padrão do PostgreSQL
+      POSTGRES_PORT: 5432
+```
+
+{% data reusables.github-actions.postgres-environment-variables %}
+
+O nome do host do serviço do PostgreSQL é a etiqueta que você configurou no seu fluxo de trabalho, nesse caso, `postgres`. Uma vez que os contêineres do Docker na mesma rede da ponte definida pelo usuário abrem todas as portas por padrão, você poderá acessar o contêiner de serviço na porta-padrão 5432 do PostgreSQL.
+
+### Executar trabalhos diretamente na máquina executora
+
+Ao executar um trabalho diretamente na máquina executora, você deverá mapear as portas no contêiner de serviço com as portas no host do Docker. Você pode acessar os contêineres de serviço do host do Docker usando `localhost` e o número da porta do host do Docker.
+
+{% data reusables.github-actions.copy-workflow-file %}
+
+{% raw %}
+```yaml
+nome: Exemplo de serviço do PostgreSQL
+em: push
+
+trabalhos:
+  # Etiqueta do trabalho executor
+  runner-job:
+    # Você deve usar um ambiente do Linux ao usar os contêineres de serviço ou os trabalhos do contêiner
+    runs-on: ubuntu-latest
+
+    # Os serviços dos contêineres a serem executados com `runner-job`
+    serviços:
+      # Etiqueta usada para acessar o contêiner de serviço
+      postgres:
+        # Imagem do Docker Hub
+        imagem: postgres
+        # Fornece a senha para postgres
+        env:
+          POSTGRES_PASSWORD: postgres
+        # Define verificações gerais até a inicialização do postgres
+        opções: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        portas:
+          # Mapeia a porta port 5432 tcp no contêiner de serviço com o host
+          - 5432:5432
+
+    etapas:
+      # Faz o download de uma cópia do código no seu repositório antes de executar um teste de CI
+      - nome: Verifica o código do repositório
+        usa: actions/checkout@v2
+
+      # Realiza uma instalação limpa de todas as dependências no arquivo `package.json`
+      # Para obter mais informações, consulte https://docs.npmjs.com/cli/ci.html
+      - nome: Instalar dependências
+        executar: npm ci
+
+      - nome: Conectar-se ao PostgreSQL
+        # Executa um script que cria um cliente PostgreSQL, preenche
+        # os dados do cliente e recupera dados
+        executar: node client.js
+        # Variável de ambiente usada pelo script `client.js` para criar
+        # um novo cliente PostgreSQL.
+        env:
+          # O nome do host usado para comunicar-se com o contêiner de serviço PostgreSQL
+          POSTGRES_HOST: localhost
+          # A porta-padrão do PostgreSQL
+          POSTGRES_PORT: 5432
+```
+{% endraw %}
+
+#### Configurar o trabalho executor
+
+{% data reusables.github-actions.service-container-host-runner %}
+
+{% data reusables.github-actions.postgres-label-description %}
+
+O fluxo de trabalho mapeia a porta 5432 no contêiner de serviço do PostgreSQL com o host do Docker. Para obter mais informações sobre a palavra-chave `portas`, consulte "[Sobre contêineres de serviço](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)".
+
+```yaml
+trabalhos:
+  # Etiqueta do trabalho executor
+  runner-job:
+    # Você deve usar um ambiente do Linux ao usar os contêineres de serviço ou trabalhos do contêiner
+    runs-on: ubuntu-latest
+
+    # Contêineres de serviços a serem executados com `runner-job`
+    serviços:
+      # Etiqueta usada para acessar o contêiner de serviço
+      postgres:
+        # Imagem do Docker Hub
+        image: postgres
+        # Fornece a senha para postgres
+        env:
+          POSTGRES_PASSWORD: postgres
+        # Define verificações gerais até a inicialização do postgres
+        opções: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        portas:
+          # Mapeia a porta port 5432 tcp no contêiner de serviço com o host
+          - 5432:5432
+```
+
+#### Configurar as etapas
+
+{% data reusables.github-actions.service-template-steps %}
+
+```yaml
+etapas:
+  # Faz o download de uma cópia do código no seu repositório antes de executar testes de CI
+  - nome: Verifica o código do repositório
+    usa: actions/checkout@v2
+
+  # Executa uma instalação limpa de todas as dependências no arquivo `package.json`
+  # Para obter mais informações, consulte https://docs.npmjs.com/cli/ci.html
+  - Nome: Instalar dependências
+    executar: npm ci
+
+  - nome: Conectar-se ao PostgreSQL
+    # Executa um script que cria um cliente PostgreSQL client, preenche
+    # os dados do cliente e recupera dados
+    executar: node client.js
+    # Variável do ambiente usada pelo script `client.js` script para criar
+    # um novo cliente PostgreSQL.
+    env:
+      # O nome do host usado para comunicar-se com o contêiner de serviço do PostgreSQL
+      POSTGRES_HOST: localhost
+      # A porta-padrão do PostgreSQL
+      POSTGRES_PORT: 5432
+```
+
+{% data reusables.github-actions.postgres-environment-variables %}
+
+{% data reusables.github-actions.service-container-localhost %}
+
+### Testar o contêiner de serviço do PostgreSQL
+
+Você pode testar o seu fluxo de trabalho usando o script a seguir, que cria um cliente PostgreSQL e adiciona uma tabela com alguns dados com espaços reservados. Em seguida, o script imprime no terminal os valores armazenados no cliente PostgreSQL. O seu script pode usar qualquer linguagem que você desejar, mas este exemplo usa Node.js e o módulo npm `pg`. Para obter mais informações, consulte [módulo npm pg](https://www.npmjs.com/package/pg).
+
+Você pode modificar o *client.js* para incluir qualquer operação do PostgreSQL exigida pelo seu fluxo de trabalho. Neste exemplo, o script cria a instância do cliente PostgreSQL, cria uma tabela, adiciona dados de espaços reservados e, em seguida, recupera os dados.
+
+{% data reusables.github-actions.service-container-add-script %}
+
+```javascript
+const { Client } = require('pg');
+
+const pgclient = new Client({
+    host: process.env.POSTGRES_HOST,
+    porta: process.env.POSTGRES_PORT,
+    usuário: 'postgres',
+    senha: 'postgres',
+    banco de dados: 'postgres'
+});
+
+pgclient.connect();
+
+const table = 'CREATE TABLE student(id SERIAL PRIMARY KEY, firstName VARCHAR(40) NOT NULL, lastName VARCHAR(40) NOT NULL, age INT, address VARCHAR(80), email VARCHAR(40))'
+const text = 'INSERT INTO student(firstname, lastname, age, address, email) VALUES($1, $2, $3, $4, $5) RETURNING *'
+const values = ['Mona the', 'Octocat', 9, '88 Colin P Kelly Jr St, San Francisco, CA 94107, United States', 'octocat@github.com']
+
+pgclient.query(table, (err, res) => {
+    if (err) throw err
+});
+
+pgclient.query(text, values, (err, res) => {
+    if (err) throw err
+});
+
+pgclient.query('SELECT * FROM student', (err, res) => {
+    if (err) throw err
+    console.log(err, res.rows) // Print the data in student table
+    pgclient.end()
+});
+```
+
+O script cria um novo `Client` PostgreSQL, que aceita um `host` e o parâmetro da `porta`. O script usa as variáveis de ambiente `POSTGRES_HOST` e `POSTGRES_PORT` para definir o endereço IP e a porta do cliente. Se o `host` e a `porta` não forem definidos, o host-padrão será `localhost` e a porta-padrão será 5432.
+
+O script cria uma tabela e preenche com dados de espaço reservado. Para testar se o banco de dados do PostgreSQL contém os dados, o script imprime o conteúdo da tabela no registro do console.
+
+Ao executar este fluxo de trabalho, você deve ver a saída a seguir na etapa "Conectar-se ao PostgreSQL", que confirma que você criou o cliente PostgreSQL e adicionou dados:
+
+```
+null [ { id: 1,
+    primeiro nome: 'Mona the',
+    último nome: 'Octocat',
+    idade: 9,
+    endereço:
+     '88 Colin P Kelly Jr St, São Francisco, CA 94107, Estados Unidos',
+    e-mail: 'octocat@github.com' } ]
+```
diff --git a/translations/pt-BR/content/actions/guides/creating-redis-service-containers.md b/translations/pt-BR/content/actions/guides/creating-redis-service-containers.md
new file mode 100644
index 000000000000..2889b501366e
--- /dev/null
+++ b/translations/pt-BR/content/actions/guides/creating-redis-service-containers.md
@@ -0,0 +1,325 @@
+---
+title: Criar contêineres de serviço Redis
+shortTitle: Contêineres de serviço do Redis
+intro: Você pode usar os contêineres de serviço para criar um cliente Redis no seu fluxo de trabalho. Este guia mostra exemplos de criação de serviço Redis para trabalhos executados em contêineres ou diretamente na máquina executora.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/creating-redis-service-containers
+  - /actions/configuring-and-managing-workflows/creating-redis-service-containers
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introdução
+
+Este guia mostra os exemplos do seu fluxo de trabalho que configuram um contêiner de serviço usando a imagem `redis` do Docker Hub. O fluxo de trabalho executa um script para criar um cliente Redis e preencher os dados do cliente. Para testar se o fluxo de trabalho cria e preenche o cliente Redis, o script imprime os dados do cliente no console.
+
+{% data reusables.github-actions.docker-container-os-support %}
+
+### Pré-requisitos
+
+{% data reusables.github-actions.service-container-prereqs %}
+
+Também pode ser útil ter um entendimento básico de YAML, a sintaxe para {% data variables.product.prodname_actions %} e Redis. Para obter mais informações, consulte:
+
+- "[Aprenda {% data variables.product.prodname_actions %}](/actions/learn-github-actions)"
+- "[Introdução ao Redis](https://redislabs.com/get-started-with-redis/)" na documentação do Redis
+
+### Executar trabalhos em contêineres
+
+{% data reusables.github-actions.container-jobs-intro %}
+
+{% data reusables.github-actions.copy-workflow-file %}
+
+{% raw %}
+```yaml
+nome: exemplo do contêiner Redis
+em: push
+
+trabalhos:
+  # Etiqueta do trabalho do contêiner
+  container-job:
+    # Os contêineres devem ser executados em sistemas operacionais baseados no Linux
+    runs-on: ubuntu-latest
+    # Imagem do Docker Hub em que o `container-job` é executado
+    contêiner: node:10.18-jessie
+
+    # Contêineres de serviço a serem executados com `container-job`
+    serviços:
+      # Etiqueta usada para acessar o contêiner de serviço
+      redis:
+        # Imagem do Docker Hub
+        imagem: redis
+        # Define verificações gerais até a inicialização do redis
+        opções: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
+    etapas:
+      # Faz o download de uma cópia do código no seu repositório antes de executar os testes de CI
+      - nome: Verifica o código do repositório
+        usa: actions/checkout@v2
+
+      # Realiza uma instalação limpa de todas as dependências no arquivo `package.json`
+      # Para obter mais informações, consulte https://docs.npmjs.com/cli/ci.html
+      - nome: Instalar dependências
+        executar: npm ci
+
+      - nome: Conectar-se ao Redis
+        # Executa um script que cria um cliente Redis, preenche
+        # os dados do cliente e recupera dados
+        executar: node client.js
+        # Variável do ambiente usada pelo script `client.js` para criar um novo Redis.
+        env:
+          # O nome do host usado para comunicar-se com o contêiner de serviço do Redis
+          REDIS_HOST: redis
+          # The default Redis port
+          REDIS_PORT: 6379
+```
+{% endraw %}
+
+#### Configurar o trabalho do contêiner
+
+{% data reusables.github-actions.service-container-host %}
+
+{% data reusables.github-actions.redis-label-description %}
+
+```yaml
+trabalhos:
+  # Etiqueta do trabalho do contêiner
+  container-job:
+    # Os contêineres devem ser executados em sistemas operacionais baseados no Linux
+    runs-on: ubuntu-latest
+    # Imagem do Docker Hub em que o `container-job` é executado
+    contêiner: node:10.18-jessie
+
+    # Contêineres de serviço a serem executados com `container-job`
+    serviços:
+      # Etiqueta usada para acessar o contêiner de serviço
+      redis:
+        # Imagem do Docker Hub
+        imagem: redis
+        # Define verificações gerais até a inicialização do redis
+        opções: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+```
+
+#### Configurar as etapas
+
+{% data reusables.github-actions.service-template-steps %}
+
+```yaml
+etapas:
+  # Faz o download de uma cópia do código no seu repositório antes de executar testes de CI
+  - nome: Verifica o código do repositório
+    usa: actions/checkout@v2
+
+  # Realiza uma instalação limpa de todas as dependências do arquivo `package.json`
+  # Para obter mais informações, consulte https://docs.npmjs.com/cli/ci.html
+  - nome: Instalar dependências
+    executar: npm ci
+
+  - nome: Conectar-se ao Redis
+    # Executa um script que cria um cliente Redis client, preenche
+    # os dados do cliente e recupera dados
+    executar: node client.js
+    # Variável do ambiente usada pelo script `client.js` para criar um novo cliente Redis.
+    env:
+      # O nome do host usado para comunicar-se com o contêiner de serviço do Redis
+      REDIS_HOST: redis
+      # A porta-padrão do Redis
+      REDIS_PORT: 6379
+```
+
+{% data reusables.github-actions.redis-environment-variables %}
+
+O nome do host do serviço Redis é a etiqueta que você configurou no seu fluxo de trabalho, nesse caso `redis`. Uma vez que os contêineres do Docker na mesma rede da ponte definida pelo usuário abrem todas as portas por padrão, você poderá acessar o contêiner de serviço na porta-padrão 6379 do Redis.
+
+### Executar trabalhos diretamente na máquina executora
+
+Ao executar um trabalho diretamente na máquina executora, você deverá mapear as portas no contêiner de serviço com as portas no host do Docker. Você pode acessar os contêineres de serviço do host do Docker usando `localhost` e o número da porta do host do Docker.
+
+{% data reusables.github-actions.copy-workflow-file %}
+
+{% raw %}
+```yaml
+nome: Exemplo do executor do Redis
+em: push
+
+trabalhos:
+  # Etiqueta do trabalho executor
+  runner-job:
+    # Você deve usar um ambiente do Linux ao usar contêineres de serviço ou trabalhos de contêiner
+    runs-on: ubuntu-latest
+
+    # Contêineres de serviço a serem executados com `runner-job`
+    serviços:
+      # Etiqueta usada para acessar o contêiner de serviço
+      redis:
+        # Imagem do Docker Hub
+        imagem: redis
+        # Define verificações gerais até a inicialização do redis
+        opções: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        portas:
+          # Mapeia a porta port 6379 no contêiner de serviço com o host
+          - 6379:6379
+
+    etapas:
+      # Faz um download de uma cópia do código no seu repositório antes de executar testes de CI
+      - nome: Verifica o código do repositório
+        usa: actions/checkout@v2
+
+      # Realiza uma instalação limpa de todas as dependências no arquivo `package.json`
+      # Para obter mais informações, consulte https://docs.npmjs.com/cli/ci.html
+      - nome: Instalar dependências
+        executar: npm ci
+
+      - nome: Conectar-se ao Redis
+        # Executa um script que cria um cliente Redis, preenche
+        # os dados do cliente e recupera dados
+        executar: node client.js
+        # Variável do ambiente usada pelo script `client.js` para criar
+        # um novo cliente Redis.
+        env:
+          # O nome do host usado para comunicar-se com o contêiner de serviço Reds
+          REDIS_HOST: localhost
+          # A porta-padrão do Redis
+          REDIS_PORT: 6379
+```
+{% endraw %}
+
+#### Configurar o trabalho executor
+
+{% data reusables.github-actions.service-container-host-runner %}
+
+{% data reusables.github-actions.redis-label-description %}
+
+O fluxo de trabalho mapeia a porta 6379 no contêiner de serviço do Redis com o host do Docker. Para obter mais informações sobre a palavra-chave `portas`, consulte "[Sobre contêineres de serviço](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)".
+
+```yaml
+trabalhos:
+  # Etiqueta do trabalho executor
+  runner-job:
+    # Você deve usar um ambiente do Linux ao usar contêineres de serviço ou trabalhos de contêiner
+    runs-on: ubuntu-latest
+
+    # Contêineres de serviço a serem executados com `runner-job`
+    serviços:
+      # Etiqueta usada para acessar o contêiner de serviço
+      redis:
+        # Imagem do Docker Hub
+        imagem: redis
+        # Define as verificações gerais até a inicialização do redis
+        opções: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        portas:
+          # Mapeia a porta 6379 no contêiner de serviço com o host
+          - 6379:6379
+```
+
+#### Configurar as etapas
+
+{% data reusables.github-actions.service-template-steps %}
+
+```yaml
+etapas:
+  # Faz o download de uma cópia do código no seu repositório antes de executar os testes de CI
+  - nome: Verifica o código do repositório
+    usa: actions/checkout@v2
+
+  # Realiza uma instalação limpa de todas as dependências no arquivo `package.json`
+  # Para obter mais informações, consulte https://docs.npmjs.com/cli/ci.html
+  - nome: Instalar dependências
+    executar: npm ci
+
+  - nome: Conectar-se ao Redis
+    # Executa um script que cria um cliente Redis, preenche
+    # os dados do cliente e recupera os dados
+    executar: node client.js
+    # Variável do ambiente usada pelo script `client.js` para criar
+    # um novo cliente Redis.
+    env:
+      # O nome do host usado para comunicar-se com o contêiner de serviço Redis
+      REDIS_HOST: localhost
+      # A porta-padrão Redis
+      REDIS_PORT: 6379
+```
+
+{% data reusables.github-actions.redis-environment-variables %}
+
+{% data reusables.github-actions.service-container-localhost %}
+
+### Testar o contêiner de serviço Redis
+
+Você pode testar o seu fluxo de trabalho usando o script a seguir, que cria um cliente Redis e adiciona uma tabela com alguns dados com espaços reservados. Em seguida, o script imprime no terminal os valores armazenados no cliente Redis. O seu script pode usar qualquer linguagem que você desejar, mas este exemplo usa Node.js e o módulo npm `redis`. Para obter mais informações, consulte o [módulo redis npm](https://www.npmjs.com/package/redis).
+
+Você pode modificar o *client.js* para incluir qualquer operação necessária para o seu fluxo de trabalho. Neste exemplo, o script cria a instância do cliente Redis, cria uma tabela, adiciona dados de espaços reservados e, em seguida, recupera os dados.
+
+{% data reusables.github-actions.service-container-add-script %}
+
+```javascript
+const redis = require("redis");
+
+// Cria um novo cliente Redis
+// Se REDIS_HOST não for definido, o host-padrão será localhost
+// Se REDIS_PORT não for definido, a porta-padrão será 6379
+const redisClient = redis.createClient({
+  host: process.env.REDIS_HOST,
+  port: process.env.REDIS_PORT  
+});
+
+redisClient.on("error", function(err) {
+    console.log("Error " + err);
+});
+
+// Define a chave "octocat" como um valor de "Mona the octocat"
+redisClient.set("octocat", "Mona the Octocat", redis.print);
+// Define uma chave como "octocat", campo de "species", e "value" como "Cat and Octopus"
+redisClient.hset("species", "octocat", "Cat and Octopus", redis.print);
+// Define uma chave como "octocat", campo de "species", e "value" como "Dinosaur and Octopus"
+redisClient.hset("species", "dinotocat", "Dinosaur and Octopus", redis.print);
+// Define uma chave como "octocat", campo de "species", e "value" como "Cat and Robot"
+redisClient.hset(["species", "robotocat", "Cat and Robot"], redis.print);
+// Obtém todos os campos na chave "species"
+
+redisClient.hkeys("species", function (err, replies) {
+    console.log(replies.length + " replies:");
+    replies.forEach(function (reply, i) {
+        console.log("    " + i + ": " + reply);
+    });
+    redisClient.quit();
+});
+```
+
+O script cria um novo cliente Redis, usando o método `createClient`, que aceita um `host` e um parâmetro da `porta`. O script usa as variáveis do ambiente `REDIS_HOST` e `REDIS_PORT` para definir o endereço IP e a porta do cliente. Se o `host` e a `porta` não forem definidos, o host-padrão será `localhost` e a porta-padrão será 6379.
+
+O script usa os métodos `set` e `hset` para preencher o banco de dados com algumas chaves, campos e valores. Para confirmar se o cliente Redis contém os dados, o script imprime o conteúdo do banco de dados no registro do console.
+
+Ao executar este fluxo de trabalho, você deve ver a saída a seguir na etapa "Conectar-se ao Redis", confirmando que você criou o cliente Redis e adicionou os dados:
+
+```
+Resposta: OK
+Resposta: 1
+Resposta: 1
+Resposta: 1  
+3 respostas:
+    0: octocat
+    1: dinotocat
+    2: robotocat
+```
diff --git a/translations/pt-BR/content/actions/guides/index.md b/translations/pt-BR/content/actions/guides/index.md
new file mode 100644
index 000000000000..4f418b86012d
--- /dev/null
+++ b/translations/pt-BR/content/actions/guides/index.md
@@ -0,0 +1,60 @@
+---
+title: Guias
+shortTitle: Guias
+intro: 'Estes guias para {% data variables.product.prodname_actions %} incluem casos de uso específicos e exemplos para ajudar você a configurar fluxos de trabalho.'
+redirect_from:
+  - /actions/guides/caching-and-storing-workflow-data
+  - /actions/automating-your-workflow-with-github-actions/using-databases-and-services
+  - /actions/configuring-and-managing-workflows/using-databases-and-service-containers
+  - /actions/guides/using-databases-and-service-containers
+  - /actions/language-and-framework-guides
+  - /actions/language-and-framework-guides/github-actions-for-docker
+  - /actions/language-and-framework-guides/github-actions-for-java
+  - /actions/language-and-framework-guides/github-actions-for-javascript-and-typescript
+  - /actions/language-and-framework-guides/github-actions-for-python
+  - /actions/publishing-packages-with-github-actions
+  - /actions/building-and-testing-code-with-continuous-integration
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Criar fluxos de trabalho personalizados de integração contínua
+
+Você pode usar o {% data variables.product.prodname_actions %} para criar fluxos de trabalho personalizados de integração contínua (CI) que criam e testam projetos escritos em diferentes linguagens de programação.
+
+{% link_in_list /about-continuous-integration %}
+{% link_in_list /setting-up-continuous-integration-using-workflow-templates %}
+{% link_in_list /building-and-testing-nodejs %}
+{% link_in_list /building-and-testing-python %}
+{% link_in_list /building-and-testing-java-with-maven %}
+{% link_in_list /building-and-testing-java-with-gradle %}
+{% link_in_list /building-and-testing-java-with-ant %}
+
+### Publicar pacotes de software
+
+Você pode automatizar pacotes de software de publicação como parte do fluxo de trabalho de entrega contínua (CD). Os pacotes podem ser publicados em qualquer host de pacote e em {% data reusables.gated-features.packages %}.
+
+{% link_in_list /about-packaging-with-github-actions %}
+{% link_in_list /publishing-nodejs-packages %}
+{% link_in_list /publishing-java-packages-with-maven %}
+{% link_in_list /publishing-java-packages-with-gradle %}
+{% link_in_list /publishing-docker-images %}
+
+### Memorizando e armazenando os dados do fluxo de trabalho
+
+Memorize as dependências e armazene os artefatos para fazer com que o seu fluxo de trabalho seja executado de modo mais eficiente.
+
+{% link_in_list /storing-workflow-data-as-artifacts %}
+{% link_in_list /caching-dependencies-to-speed-up-workflows %}
+
+### Usar contêineres de serviço em um fluxo de trabalho
+
+Conecte os serviços ao seu fluxo de trabalho usando contêineres de serviço.
+
+{% link_in_list /about-service-containers %}
+{% link_in_list /creating-redis-service-containers %}
+{% link_in_list /creating-postgresql-service-containers %}
diff --git a/translations/pt-BR/content/actions/guides/publishing-docker-images.md b/translations/pt-BR/content/actions/guides/publishing-docker-images.md
new file mode 100644
index 000000000000..7b4704474356
--- /dev/null
+++ b/translations/pt-BR/content/actions/guides/publishing-docker-images.md
@@ -0,0 +1,158 @@
+---
+title: Publicar imagens do Docker
+intro: 'Você pode publicar imagens Docker para um registro, como o Docker Hub ou {% data variables.product.prodname_registry %}, como parte do seu fluxo de trabalho de integração contínua (CI).'
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/publishing-docker-images
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introdução
+
+Este guia mostra como criar um fluxo de trabalho que realiza uma criação do Docker e, em seguida, publica imagens do Docker no Docker Hub ou no {% data variables.product.prodname_registry %}. Com um único fluxo de trabalho, você pode publicar imagens em um único registro ou em vários registros.
+
+{% note %}
+
+**Observação:** Se você desejar fazer push para outro registro do Docker de terceiros, o exemplo na seção "[Publicar imagens em {% data variables.product.prodname_registry %}](#publishing-images-to-github-packages)" poderá servir como um bom modelo.
+
+{% endnote %}
+
+### Pré-requisitos
+
+Recomendamos que você tenha um entendimento básico das opções de configuração do fluxo de trabalho e de como criar um arquivo do fluxo de trabalho. Para obter mais informações, consulte "[Aprenda {% data variables.product.prodname_actions %}](/actions/learn-github-actions)".
+
+Você também pode achar útil ter um entendimento básico do seguinte:
+
+- "[Segredos criptografados](/actions/reference/encrypted-secrets)"
+- "[Autenticação em um fluxo de trabalho](/actions/reference/authentication-in-a-workflow)"
+- "[Configurar o Docker para uso com o {% data variables.product.prodname_registry %}](/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)"
+
+### Sobre a configuração da imagem
+
+Este guia pressupõe que você tem uma definição completa para uma imagem Docker armazenada em um repositório {% data variables.product.prodname_dotcom %}. Por exemplo, seu repositório deve conter um _arquivo Docker_ e quaisquer outros arquivos necessários para executar uma criação do Docker para criar uma imagem.
+
+Neste guia, usaremos a ação `build-push-action` do Docker para criar a imagem do Docker e enviá-la para um ou mais registros do Docker. Para obter mais informações, consulte [`build-push-action`](https://github.com/marketplace/actions/build-and-push-docker-images).
+
+{% data reusables.actions.enterprise-marketplace-actions %}
+
+### Publicar imagens no Docker Hub
+
+{% data reusables.github-actions.release-trigger-workflow %}
+
+No exemplo do fluxo de trabalho abaixo, usamos a ação `build-push-action` do Docker para criar a imagem e, se a construção for bem-sucedida, faça o push da imagem criada para o Docker Hub.
+
+Para fazer push para o Docker Hub, você deverá ter uma conta Docker Hub e ter criado um repositório Docker Hub. Para obter mais informações, consulte "[Compartilhar imagens no Docker Hub](https://docs.docker.com/get-started/part3/)" na documentação do Docker.
+
+As opções `build-push-action` necessárias para o Docker Hub são:
+
+* `nome de usuário` e `senha`: Este é o seu nome de usuário e senha do Docker Hub. Recomendamos armazenar seu nome de usuário e senha do Docker Hub como segredos encriptados no repositório {% data variables.product.prodname_dotcom %} para que não sejam expostos no seu arquivo de fluxo de trabalho. Para obter mais informações, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)".
+* `repositório`: Seu repositório do Docker Hub no formato `DOCKER-HUB-NAMESPACE/DOCKER-HUB-REPOSITORY`.
+
+{% raw %}
+```yaml
+nome: Publicar imagem do Docker
+em:
+  versão:
+    tipos: [published]
+trabalhos:
+  push_to_registry:
+    Nome: Push Docker image to Docker Hub
+    runs-on: ubuntu-latest
+    etapas:
+      - nome: Verificar repo
+        usa: actions/checkout@v2
+      - nome: Push to Docker Hub
+        usa: docker/build-push-action@v1
+        com:
+          nome de usuário: ${{ secrets.DOCKER_USERNAME }}
+          senha: ${{ secrets.DOCKER_PASSWORD }}
+          repositório: my-docker-hub-namespace/my-docker-hub-repository
+          tag_with_ref: true
+```
+{% endraw %}
+
+{% data reusables.github-actions.docker-tag-with-ref %}
+
+### Publicar imagens em {% data variables.product.prodname_registry %}
+
+{% data reusables.github-actions.release-trigger-workflow %}
+
+No exemplo abaixo, usamos a ação `build-push-action` do Docker para criar a imagem do Docker, e se a criação for bem-sucedida, faça o push da imagem criada para {% data variables.product.prodname_registry %}.
+
+As opções de `build-push-action` necessárias para {% data variables.product.prodname_registry %} são:
+
+* `nome de usuário`: Você pode usar o contexto {% raw %}`${{ github.actor }}`{% endraw %} para usar automaticamente o nome de usuário que acionou a execução do fluxo de trabalho. Para obter mais informações, consulte "[Contexto e sintaxe de expressão para GitHub Actions](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)".
+* `senha`: Você pode usar o segredo `GITHUB_TOKEN` gerado automaticamente para a senha. Para obter mais informações, consulte "[Permissões para o GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)".
+* `registro`: Deve ser definido como `docker.pkg.github.com`.
+* `repositório`: Deve ser definido no formato `OWNER/REPOSITORY/IMAGE_NAME`. Por exemplo, para uma imagem denominada `octo-image` armazenada no {% data variables.product.prodname_dotcom %} em `http://github. Um/octo-org/octo-repo`, a opção `repositório` deve ser definida como `octo-org/octo-repo/octo-image`.
+
+{% raw %}
+```yaml
+nome: Publish Docker image
+em:
+  versão:
+    tipos: [published]
+trabalhos:
+  push_to_registry:
+    nome: Push Docker image to GitHub Packages
+    runs-on: ubuntu-latest
+    etapas:
+      - nome: Check out the repo
+        usa: actions/checkout@v2
+      - nome: Push to GitHub Packages
+        usa: docker/build-push-action@v1
+        com:
+          nome de usuário: ${{ github.actor }}
+          senha: ${{ secrets.GITHUB_TOKEN }}
+          registro: docker.pkg.github.com
+          repositório: my-org/my-repo/my-image
+          tag_with_ref: true
+
+```
+{% endraw %}
+
+{% data reusables.github-actions.docker-tag-with-ref %}
+
+### Publicar imagens no Docker Hub e {% data variables.product.prodname_registry %}
+
+Em um único fluxo de trabalho, você pode publicar sua imagem do Docker em vários registros usando a ação `build-push-action` para cada registro.
+
+O exemplo do fluxo de trabalho a seguir usa as etapas `build-push-action` das seções anteriores ("[Publicar imagens para o Docker Hub](#publishing-images-to-docker-hub)" e "[Publicar imagens em {% data variables.product.prodname_registry %}](#publishing-images-to-github-packages)") para criar um único fluxo de trabalho que faça push em ambos os registros.
+
+{% raw %}
+```yaml
+nome: Publicar imagem do Docker
+em:
+  versão:
+    tipos: [published]
+trabalhos:
+  push_to_registries:
+    nome: Fazer push da imagem do Docker em múltiplos registros
+    runs-on: ubuntu-latest
+    etapas:
+      - nome: Verificar o repo
+        usa: actions/checkout@v2
+      - nome: Push to Docker Hub
+        usa: docker/build-push-action@v1
+        with:
+          nome de usuário: ${{ secrets.DOCKER_USERNAME }}
+          senha: ${{ secrets.DOCKER_PASSWORD }}
+          repositório: my-docker-hub-namespace/my-docker-hub-repository
+          tag_with_ref: true
+      - nome: Push to GitHub Packages
+        usa: docker/build-push-action@v1
+        com:
+          nome de usuário: ${{ github.actor }}
+          senha: ${{ secrets.GITHUB_TOKEN }}
+          registro: docker.pkg.github.com
+          repositório: my-org/my-repo/my-image
+          tag_with_ref: true
+```
+{% endraw %}
+
+O fluxo de trabalho acima verifica o repositório {% data variables.product.prodname_dotcom %} e usa a ação `construção-push-action` duas vezes para criar e fazer push da imagem do Docker Hub e {% data variables.product.prodname_registry %}. Para ambas as etapas, ele define a opção `construção-push-action` [`tag_with_ref`](https://github.com/marketplace/actions/build-and-push-docker-images#tag_with_ref) para marcar automaticamente a imagem do Docker criada com a referêcia do Git do evento do fluxo de trabalho. Este fluxo de trabalho é acionado na publicação de uma versão do {% data variables.product.prodname_dotcom %}. Portanto, a referência para ambos os registros será a tag do Git para a versão.
diff --git a/translations/pt-BR/content/actions/guides/publishing-java-packages-with-gradle.md b/translations/pt-BR/content/actions/guides/publishing-java-packages-with-gradle.md
new file mode 100644
index 000000000000..724bc0bb8123
--- /dev/null
+++ b/translations/pt-BR/content/actions/guides/publishing-java-packages-with-gradle.md
@@ -0,0 +1,219 @@
+---
+title: Publicar pacotes Java com Gradle
+intro: Você pode usar o Gradle para publicar pacotes Java para um registro como parte do seu fluxo de trabalho de integração contínua (CI).
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/publishing-java-packages-with-gradle
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introdução
+
+{% data reusables.github-actions.publishing-java-packages-intro %}
+
+### Pré-requisitos
+
+Recomendamos que você tenha um entendimento básico dos arquivos de fluxo de trabalho e das opções de configuração. Para obter mais informações, consulte "[Aprenda {% data variables.product.prodname_actions %}](/actions/learn-github-actions)".
+
+Para obter mais informações sobre a criação de um fluxo de trabalho de CI para seu projeto Java com Gradle, consulte "[Criando e testando o Java com Gradle](/actions/language-and-framework-guides/building-and-testing-java-with-gradle)"
+
+Você também pode achar útil ter um entendimento básico do seguinte:
+
+- "[Configurar o npm para uso com o {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)"
+- "[Variáveis de ambiente](/actions/reference/environment-variables)"
+- "[Segredos criptografados](/actions/reference/encrypted-secrets)"
+- "[Autenticação em um fluxo de trabalho](/actions/reference/authentication-in-a-workflow)"
+
+### Sobre a configuração do pacote
+
+Os campos `groupId` e `artefactId` na seção `MavenPublication` do arquivo _build.gradle_ criam um identificador exclusivo para o seu pacote que os registros usam para vinculá-lo a um registro.  Isto é semelhante aos campos `groupId` e `artifactId` do arquivo Maven _pom.xml_.  Para obter mais informações, consulte o "[Plugin de publicação do Maven](https://docs.gradle.org/current/userguide/publishing_maven.html)" na documentação do Gradle.
+
+O arquivo _build.gradle_ também contém a configuração para os repositórios de gerenciamento de distribuição nos quais o Gradle publicará pacotes. Cada repositório deve ter um nome, uma URL de implementação e e credenciais para autenticação.
+
+### Publicar pacotes no Repositório Central do Maven
+
+Cada vez que você criar uma nova versão, você poderá acionar um fluxo de trabalho para publicar o seu pacote. O fluxo de trabalho no exemplo abaixo é executado quando o evento `versão` é acionado com o tipo `criado`. O fluxo de trabalho publica o pacote no Repositório Central Maven se o teste de CI for aprovado. Para obter mais informações sobre o evento da `versão`, consulte "[Eventos que acionam fluxos de trabalho](/actions/reference/events-that-trigger-workflows#release)".
+
+É possível definir um novo repositório do Maven no bloco de publicação do seu arquivo _build.gradle_ que aponta para o repositório de pacotes.  Por exemplo, se você estava fazendo uma implementaão no Central Repositório do Maven por meio do projeto de hospedagem OSSRH, seu _build.gradle_ poderá especificar um repositório com o nome `"OSSRH"`.
+
+{% raw %}
+```groovy
+publicando {
+  ...
+
+  repositories {
+    maven {
+      name = "OSSRH"
+      url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/"
+      credentials {
+        username = System.getenv("MAVEN_USERNAME")
+        password = System.getenv("MAVEN_PASSWORD")
+      }
+    }
+  }
+}
+```
+{% endraw %}
+
+Com essa configuração, é possível criar um fluxo de trabalho que publica seu pacote no Repositório Central do Maven ao executar o comando `publicação do gradle`. Você também deverá fornecer variáveis de ambiente que contenham o nome de usuário e senha para fazer a autenticação no repositório.
+
+Na etapa de implementação, você deverá definir variáveis de ambiente para o nome de usuário e senha ou token usado para fazer a autenticação no repositório do Maven. Para obter mais informações, consulte "[Criando e usando segredos encriptados](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)".
+
+
+{% raw %}
+```yaml
+nome: Publicar pacote no Repositório Central do Maven
+em:
+  versão:
+    tipos: [created]
+trabalhos:
+  publicar:
+    runs-on: ubuntu-latest
+    etapas:
+      - usa: actions/checkout@v2
+      - nome: Configurar Java
+        usa: actions/setup-java@v1
+        com:
+          java-version: 1.8
+      - nome: Publicar pacote
+        executar: gradle publish
+        env:
+          MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
+          MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}
+```
+{% endraw %}
+
+{% data reusables.github-actions.gradle-workflow-steps %}
+1. Executa o comando `publicação do gradle` para fazer a publicação no repositório do Maven `OSSRH`. A variável de ambiente `MAVEN_USERNAME` será definida com o conteúdo do seu segredo `OSSRH_USERNAME`, e a variável de ambiente `MAVEN_PASSWORD` será definida com o conteúdo do seu segredo `OSSRH_TOKEN`.
+
+   Para obter mais informações sobre o uso de segredos no seu fluxo de trabalho, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)".
+
+### Publicar pacotes em {% data variables.product.prodname_registry %}
+
+Cada vez que você criar uma nova versão, você poderá acionar um fluxo de trabalho para publicar o seu pacote. O fluxo de trabalho no exemplo abaixo é executado quando o evento `versão` é acionado com o tipo `criado`. O fluxo de trabalho publica o pacote em {% data variables.product.prodname_registry %} se o teste de CI for aprovado. Para obter mais informações sobre o evento da `versão`, consulte "[Eventos que acionam fluxos de trabalho](/actions/reference/events-that-trigger-workflows#release)".
+
+Você pode definir um novo repositório do Maven no bloco de publicação do _build.gradle_ que aponta para {% data variables.product.prodname_registry %}.  Nessa configuração do repositório, também é possível aproveitar as variáveis de ambiente definidas na execução do fluxo de trabalho de CI.  Você pode usar a variável de ambiente `GITHUB_ACTOR` como um nome de usuário e você pode definir a variável de ambiente `GITHUB_TOKEN` com seu segredo `GITHUB_TOKEN`.
+
+O `GITHUB_TOKEN` existe no repositório por padrão e tem permissões de leitura e gravação para pacotes no repositório em que o fluxo de trabalho é executado. Para obter mais informações, consulte "[Autenticação com o GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)".
+
+Por exemplo, se sua organização é denominado "octocat" e seu repositório é denominado de "hello-world", a configuração do {% data variables.product.prodname_registry %} no _build.gradle_ será parecida ao exemplo abaixo.
+
+{% raw %}
+```groovy
+publicando {
+  ...
+
+  repositories {
+    maven {
+      name = "GitHubPackages"
+      url = "https://maven.pkg.github.com/octocat/hello-world"
+      credentials {
+        username = System.getenv("GITHUB_ACTOR")
+        password = System.getenv("GITHUB_TOKEN")
+      }
+    }
+  }
+}
+```
+{% endraw %}
+
+Com essa configuração, é possível criar um fluxo de trabalho que publica seu pacote no Repositório Central do Maven ao executar o comando `publicação do gradle`.
+
+{% raw %}
+```yaml
+nome: Publicar pacote nos pacotes do GitHub
+em:
+  versão:
+    tipos: [created]
+trabalhos:
+  publicar:
+    runs-on: ubuntu-latest
+    etapas:
+      - usa: actions/checkout@v2
+      - usa: actions/setup-java@v1
+        com:
+          java-version: 1.8
+      - nome: Publicar pacote
+        executar: publicação do gradle
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
+
+{% data reusables.github-actions.gradle-workflow-steps %}
+1. Executa o comando `publicação do gradle` para publicar no {% data variables.product.prodname_registry %}. A variável de ambiente `GITHUB_TOKEN` será definida com o conteúdo do segredo `GITHUB_TOKEN`.
+
+   Para obter mais informações sobre o uso de segredos no seu fluxo de trabalho, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)".
+
+### Publicar imagens no Repositório Central do Maven e em {% data variables.product.prodname_registry %}
+
+Você pode publicar seus pacotes no Repositório Central Maven e em {% data variables.product.prodname_registry %}, configurando cada um no seu arquivo _build.gradle_.
+
+Certifique-se de que seu arquivo _build.gradle_ inclua um repositório para seu repositório {% data variables.product.prodname_dotcom %} e seu provedor do Repositório Central do Maven.
+
+Por exemplo, se fizer a implementação no Repositório Central por meio do projecto de hospedagem OSSRH, é possível que você deseje especificá-lo em um repositório de gerenciamento de distribuição com o `nome` definido como `OSSRH`. Se você fizer a implementação em {% data variables.product.prodname_registry %}, é possível que você deseje especificá-lo em um repositório de gerenciamento de distribuição com o nome `` definido como `GitHubPackages`.
+
+Se sua organização for denominada "octocat" e seu repositório for denominado "hello-world", a configuração de {% data variables.product.prodname_registry %} em _build.gradle_ será parecida ao exemplo abaixo.
+
+{% raw %}
+```groovy
+publicando {
+  ...
+
+  repositories {
+    maven {
+      name = "OSSRH"
+      url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/"
+      credentials {
+        username = System.getenv("MAVEN_USERNAME")
+        password = System.getenv("MAVEN_PASSWORD")
+      }
+    }
+    maven {
+      name = "GitHubPackages"
+      url = "https://maven.pkg.github.com/octocat/hello-world"
+      credentials {
+        username = System.getenv("GITHUB_ACTOR")
+        password = System.getenv("GITHUB_TOKEN")
+      }
+    }
+  }
+}
+```
+{% endraw %}
+
+Com esta configuração, você pode criar um fluxo de trabalho que publica seu pacote no Repositório Central do Maven e em {% data variables.product.prodname_registry %}, executando o comando `publicação do gradle`.
+
+{% raw %}
+```yaml
+nome: Publicar pacote no Repositório Central do Maven e nos Pacotes do GitHub
+em:
+  versão:
+    tipos: [created]
+trabalhos:
+  publicar:
+    runs-on: ubuntu-latest
+    etapas:
+      - usa: actions/checkout@v2
+      - nome: Configura o Java
+        usa: actions/setup-java@v1
+        com:
+          java-version: 1.8
+      - nome: Publica no Repositório Central do Maven
+        executa: publicação do gradle
+        env:
+          MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
+          MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
+
+{% data reusables.github-actions.gradle-workflow-steps %}
+1. Executa o comando `publicação do gradle` para publicar no repositório do Maven `OSSRH` e em {% data variables.product.prodname_registry %}. A variável de ambiente `MAVEN_USERNAME` será definida com o conteúdo do seu segredo `OSSRH_USERNAME`, e a variável de ambiente `MAVEN_PASSWORD` será definida com o conteúdo do seu segredo `OSSRH_TOKEN`. A variável de ambiente `GITHUB_TOKEN` será definida com o conteúdo do segredo `GITHUB_TOKEN`.
+
+   Para obter mais informações sobre o uso de segredos no seu fluxo de trabalho, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)".
diff --git a/translations/pt-BR/content/actions/guides/publishing-java-packages-with-maven.md b/translations/pt-BR/content/actions/guides/publishing-java-packages-with-maven.md
new file mode 100644
index 000000000000..0fbe0a25454b
--- /dev/null
+++ b/translations/pt-BR/content/actions/guides/publishing-java-packages-with-maven.md
@@ -0,0 +1,210 @@
+---
+title: Publicar pacotes Java com Maven
+intro: Você pode usar o Maven para publicar pacotes Java para um registro como parte do seu fluxo de trabalho de integração contínua (CI).
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/publishing-java-packages-with-maven
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introdução
+
+{% data reusables.github-actions.publishing-java-packages-intro %}
+
+### Pré-requisitos
+
+Recomendamos que você tenha um entendimento básico dos arquivos de fluxo de trabalho e das opções de configuração. Para obter mais informações, consulte "[Aprenda {% data variables.product.prodname_actions %}](/actions/learn-github-actions)".
+
+Para obter mais informações sobre a criação de um fluxo de trabalho de CI para seu projeto Java com Maven, consulte "[Criando e testando o Java com Maven](/actions/language-and-framework-guides/building-and-testing-java-with-maven)"
+
+Você também pode achar útil ter um entendimento básico do seguinte:
+
+- "[Configurar o npm para uso com o {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)"
+- "[Variáveis de ambiente](/actions/reference/environment-variables)"
+- "[Segredos criptografados](/actions/reference/encrypted-secrets)"
+- "[Autenticação em um fluxo de trabalho](/actions/reference/authentication-in-a-workflow)"
+
+### Sobre a configuração do pacote
+
+Os campos `groupId` e `artefactId` no arquivo _x-id="4">pom.xml_ criam a um identificador exclusivo para o seu pacote que os registros usam para vincular o seu pacote a um registro.  Para obter mais informações, consulte [Guia para fazer o upload de artefatos no Repositório Central](http://maven.apache.org/repository/guide-central-repository-upload.html) na documentação do Apache Maven.
+
+O arquivo _pom.xml_ também contém a configuração para os repositórios de gerenciamento de distribuição nos quais o Maven implementará pacotes. Cada repositório deve ter um nome e uma URL de implementação. A autenticação para estes repositórios pode ser configurada no arquivo _.m2/settings.xml_ no diretório inicial do usuário que está executando o Maven.
+
+É possível usar a ação de `setup-java` para configurar o repositório de imeplementação, bem como a autenticação para esse repositório. Para obter mais informações, consulte [`setup-java`](https://github.com/actions/setup-java).
+
+### Publicar pacotes no Repositório Central do Maven
+
+Cada vez que você criar uma nova versão, você poderá acionar um fluxo de trabalho para publicar o seu pacote. O fluxo de trabalho no exemplo abaixo é executado quando o evento `versão` é acionado com o tipo `criado`. O fluxo de trabalho publica o pacote no Repositório Central Maven se o teste de CI for aprovado. Para obter mais informações sobre o evento da `versão`, consulte "[Eventos que acionam fluxos de trabalho](/actions/reference/events-that-trigger-workflows#release)".
+
+Neste fluxo de trabalho, você pode usar a ação `setup-java`. Esta ação instala uma determinada versão do JDK no `PATH`, mas também define _settings.xml_ do Maven para publicação de pacotes. Por padrão, o arquivo de configurações será definido como {% data variables.product.prodname_registry %}. No entanto, ele pode ser configurado para implementar outro registro de pacote, como, por exemplo, o Repositório Central do Maven. Se você já tem um repositório de gerenciamento de distribuição configurado em _pom.xml_, você poderá especificar esse `id` durante a chamada da ação `setup-java`.
+
+Por exemplo, se você estava implantando no Repositório Central do Maven por meio do projeto de hospedagem OSSRH, seu _pom.xml_ poderia especificar um repositório de gerenciamento de distribuição com o `id` de `ossrh`.
+
+{% raw %}
+```xml
+
+  ...
+  
+    
+      ossrh
+      Central Repository OSSRH
+      https://oss.sonatype.org/service/local/staging/deploy/maven2/
+    
+  
+
+```
+{% endraw %}
+
+Com esta configuração, é possível criar um fluxo de trabalho que publique seu pacote no Repositório Central do Maven especificando o `id` do gerenciamento do repositório para a ação `setup-java`. Você também deverá fornecer variáveis de ambiente que contenham o nome de usuário e senha para fazer a autenticação no repositório.
+
+Na etapa de implementação, você deverá definir as variáveis de ambiente para o nome de usuário com o qual deseja fazer a autenticação no repositório e para um segredo que você configurou com a senha ou token para autenticação.  Para obter mais informações, consulte "[Criando e usando segredos encriptados](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)".
+
+
+{% raw %}
+```yaml
+nome: Publicar pacote no Repositório Central do Maven
+em:
+  versão:
+    tipos: [created]
+trabalhos:
+  publicar:
+    runs-on: ubuntu-latest
+    etapas:
+      - usa: actions/checkout@v2
+      - nome: Configurar no Repositório Central do Maven
+        usa: actions/setup-java@v1
+        com:
+          java-version: 1.8
+          server-id: ossrh
+          server-username: MAVEN_USERNAME
+          server-password: MAVEN_PASSWORD
+      - nome: Publicar pacote
+        executar: mvn -B deploy
+        env:
+          MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
+          MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}
+```
+{% endraw %}
+
+Este fluxo de trabalho executa os seguintes passos:
+
+1. Verifica uma cópia do repositório do projeto.
+1. Configura o Java JDK e o arquivo _settings.xml_ do Maven para adicionar autenticação ao repositório `ossrh` usando as variáveis de ambiente `MAVEN_USERNAME` e `MAVEN_PASSWORD`.
+1. {% data reusables.github-actions.publish-to-maven-workflow-step %}
+
+   Para obter mais informações sobre o uso de segredos no seu fluxo de trabalho, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)".
+
+### Publicar pacotes em {% data variables.product.prodname_registry %}
+
+Cada vez que você criar uma nova versão, você poderá acionar um fluxo de trabalho para publicar o seu pacote. O fluxo de trabalho no exemplo abaixo é executado quando o evento `versão` é acionado com o tipo `criado`. O fluxo de trabalho publica o pacote em {% data variables.product.prodname_registry %} se o teste de CI for aprovado. Para obter mais informações sobre o evento da `versão`, consulte "[Eventos que acionam fluxos de trabalho](/actions/reference/events-that-trigger-workflows#release)".
+
+Neste fluxo de trabalho, você pode usar a ação `setup-java`. Esta ação instala a versão determinada do JDK no `PATH`, e também configura _settings.xml_ do Maven para a publicação {% data variables.product.prodname_registry %}. O _settings.xml_ gerado define a autenticação para um servidor com um `id` do `github`, usando a variável de ambiente `GITHUB_ACTOR` como o nome de usuário e a variável de ambiente `GITHUB_TOKEN` como a senha.
+
+O `GITHUB_TOKEN` existe no repositório por padrão e tem permissões de leitura e gravação para pacotes no repositório em que o fluxo de trabalho é executado. Para obter mais informações, consulte "[Autenticação com o GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)".
+
+Para um projeto baseado no Maven, você pode usar essas configurações ao criar um repositório de distribuição no seu arquivo _pom.xml_ com um `id` do `github` que aponta para seu ponto final {% data variables.product.prodname_registry %}.
+
+Por exemplo, se sua organização é denominada "octocat" e seu repositório é denominado "hello-world", a configuração do {% data variables.product.prodname_registry %} no _pom.xml_ será parecida ao exemplo abaixo.
+
+{% raw %}
+```xml
+
+  ...
+  
+    
+      github
+      GitHub Packages
+      https://maven.pkg.github.com/octocat/hello-world
+    
+  
+
+```
+{% endraw %}
+
+Com esta configuração, você pode criar um fluxo de trabalho que publica seu pacote em {% data variables.product.prodname_registry %}, fazendo uso do _settings.xml_ gerado automaticamente.
+
+{% raw %}
+```yaml
+nome: Publicar pacote nos pacotes do GitHub
+em:
+  versão:
+    tipos: [created]
+trabalhos:
+  publicar:
+    runs-on: ubuntu-latest
+    etapas:
+      - usa: actions/checkout@v2
+      - usa: actions/setup-java@v1
+        com:
+          java-version: 1.8
+      - nome: Publicar pacote
+        executar: mvn -B deploy
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
+
+Este fluxo de trabalho executa os seguintes passos:
+
+1. Verifica uma cópia do repositório do projeto.
+1. Configura o Java JDK e também configura automaticamente o arquivo _settings.xml_ do Maven para adicionar autenticação para o repositório do `github` do Maven para usar a variável de ambiente `GITHUB_TOKEN`.
+1. {% data reusables.github-actions.publish-to-packages-workflow-step %}
+
+   Para obter mais informações sobre o uso de segredos no seu fluxo de trabalho, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)".
+
+### Publicar imagens no Repositório Central do Maven e em {% data variables.product.prodname_registry %}
+
+Você pode publicar seus pacotes no Repositório Central Maven e em {% data variables.product.prodname_registry %}, usando a ação de `setup-java` para cada registro.
+
+Certifique-se de que seu arquivo _pom.xml_ inclui um repositório de gerenciamento de distribuição tanto para seu repositório {% data variables.product.prodname_dotcom %} como para o seu provedor de Repositório Central do Maven. Por exemplo, se você fizer a implementação em um Repositório Central por meio do projeto de hospedagem OSSRH, é possível que você deseje especificá-la em um repositório de gerenciamento de distribuição com o `id` definido como `ossrh`. Além disso, você pode desejar especificar {% data variables.product.prodname_registry %} em um repositório de gerenciamento de distribuição com o `id` definido como `github`.
+
+{% raw %}
+```yaml
+nome: Publicar pacote no Repositório Central do Maven e nos Pacotes do GitHub
+em:
+  versão:
+    tipos: [created]
+trabalhos:
+  publicar:
+    runs-on: ubuntu-latest
+    etapas:
+      - usar: actions/checkout@v2
+      - nome: Configurar o Java para publicação no Repositório Central do Maven
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+          server-id: ossrh
+          server-username: MAVEN_USERNAME
+          server-password: MAVEN_PASSWORD
+      - nome: Publicar no Repositório Central do Maven
+        run: mvn -B deploy
+        env:
+          MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
+          MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}
+      - name: Set up Java for publishing to GitHub Packages
+        usa: actions/setup-java@v1
+        com:
+          java-version: 1.8
+      - nome: Publicar nos pacotes do GitHub
+        executar: mvn -B deploy
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
+
+Este fluxo de trabalho chama a ação `setup-java` duas vezes.  Cada vez que a ação `setup-java` é executada, ela sobrescreve o arquivo _settings.xml_ do Maven para a publicação de pacotes.  Para autenticação no repositório, o arquivo _settings.xml_ faz referência ao `ID`do repositório de gerenciamento de distribuição e ao nome de usuário e senha.
+
+Este fluxo de trabalho executa os seguintes passos:
+
+1. Verifica uma cópia do repositório do projeto.
+1. Chama `setup-java` pela primeira vez. Isso configura o arquivo _settings.xml_ do Maven para o repositório `ossrh` e define as opções de autenticação para variáveis de ambiente definidas na próxima etapa.
+1. {% data reusables.github-actions.publish-to-maven-workflow-step %}
+1. Chama `setup-java` pela segunda vez. Isso configura automaticamente o arquivo _settings.xml_ do Maven para {% data variables.product.prodname_registry %}.
+1. {% data reusables.github-actions.publish-to-packages-workflow-step %}
+
+   Para obter mais informações sobre o uso de segredos no seu fluxo de trabalho, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)".
diff --git a/translations/pt-BR/content/actions/guides/publishing-nodejs-packages.md b/translations/pt-BR/content/actions/guides/publishing-nodejs-packages.md
new file mode 100644
index 000000000000..2883119128bf
--- /dev/null
+++ b/translations/pt-BR/content/actions/guides/publishing-nodejs-packages.md
@@ -0,0 +1,210 @@
+---
+title: Publicar pacotes do Node.js
+intro: Você pode publicar pacotes do Node.js em um registro como parte do seu fluxo de trabalho de integração contínua (CI).
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages
+  - /actions/language-and-framework-guides/publishing-nodejs-packages
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introdução
+
+Este guia mostra como criar um fluxo de trabalho que publica pacotes do Node.js em {% data variables.product.prodname_registry %} e nos registros npm após os testes de integração contínua (CI) serem aprovados. Com um único fluxo de trabalho, você pode publicar pacotes em um único registro ou em vários registros.
+
+### Pré-requisitos
+
+Recomendamos que você tenha um entendimento básico das opções de configuração do fluxo de trabalho e de como criar um arquivo do fluxo de trabalho. Para obter mais informações, consulte "[Aprenda {% data variables.product.prodname_actions %}](/actions/learn-github-actions)".
+
+Para obter mais informações sobre a criação de um fluxo de trabalho de CI para seu projeto Node.js, consulte "[Usando Node.js com {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions)".
+
+Você também pode achar útil ter um entendimento básico do seguinte:
+
+- "[Configurar o npm para uso com o {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)"
+- "[Variáveis de ambiente](/actions/reference/environment-variables)"
+- "[Segredos criptografados](/actions/reference/encrypted-secrets)"
+- "[Autenticação em um fluxo de trabalho](/actions/reference/authentication-in-a-workflow)"
+
+### Sobre a configuração do pacote
+
+ Os campos `nome` e `versão` no arquivo *package.json* cria um identificador único que os registros usam para vincular seu pacote a um registro. Você pode adicionar um resumo para página de listagem do pacote ao incluir um campo `descrição` no arquivo *package.json*. Para obter mais informações, consulte "[Criando um pacote package.json](https://docs.npmjs.com/creating-a-package-json-file)" e "[Criando módulos Node.js](https://docs.npmjs.com/creating-node-js-modules)" na documentação do npm.
+
+Quando um arquivo *.npmrc* local existe e tem um valor de `registro` especificado, o comando `publicação do npm` usa o registro configurado no arquivo *.npmrc*. {% data reusables.github-actions.setup-node-intro %}
+
+Você pode especificar a versão do Node.js instalada no executor usando a ação `setup-node`.
+
+Se você adicionar etapas ao seu fluxo de trabalho para configurar os campos `publishConfig` no seu arquivo *package.json*, você não precisará especificar o registry-url usando a ação de `setup-node`. No entanto, você estará limitado à publicação do pacote em um registro. Para obter mais informações, consulte "[publishConfig](https://docs.npmjs.com/files/package.json#publishconfig)" na documentação npm.
+
+### Publicar pacotes no registro npm
+
+Cada vez que você criar uma nova versão, você poderá acionar um fluxo de trabalho para publicar o seu pacote. O fluxo de trabalho no exemplo abaixo é executado quando o evento `versão` é acionado com o tipo `criado`. O fluxo de trabalho publica o pacote no registro npm se o teste de CI for aprovado.
+
+Para executar operações autenticadas com o registro npm em seu fluxo de trabalho, você deverá armazenar seu token de autenticação npm como um segredo nas configurações do repositório. Por exemplo, crie um segredo denominado `NPM_TOKEN`. Para obter mais informações, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)".
+
+Por padrão, o npm usa o campo `nome` do arquivo *package.json* para determinar o registro do npm. Ao publicar em um namespace global, você precisa incluir apenas o nome do pacote. Por exemplo, você publicaria um pacote denominado `npm-hello-world-test` em `https://www.npmjs.com/package/npm-hello-world-test`.
+
+Se você estiver publicando um pacote que inclui um prefixo de escopo, inclua o escopo no nome do arquivo *package.json*. Por exemplo, se o prefixo de escopo do npm é octocat e o nome do pacote é hello-world, o `nome` no seu arquivo *package.json* deverá ser `@octocat/hello-world`. Se seu pacote npm usar um prefixo de escopo e for público, você deverá usar a opção `npm publish --access public`. Essa é uma opção que o npm requer para impedir que alguém publique um pacote privado de forma não intencional.
+
+Este exemplo armazena o segredo `NPM_TOKEN` na variável de ambiente `NODE_AUTH_TOKEN`. Quando a ação `setup-node` cria um arquivo *.npmrc*, ela faz referência ao token da variável de ambiente `NODE_AUTH_TOKEN`.
+
+{% raw %}
+```yaml
+nome: Pacote Node.js
+em:
+  versão:
+    tipos: [created]
+trabalhos:
+  criar:
+    runs-on: ubuntu-latest
+    etapas:
+    - usa: actions/checkout@v2
+    # Configura o arquivo .npmrc a ser publicado no npm
+    - usa: actions/setup-node@v1
+      com:
+        node-version: '12.x'
+        registry-url: 'https://registry.npmjs.org'
+    - executar: npm install
+    - executar: npm publish
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+```
+{% endraw %}
+
+No exemplo acima, a ação `setup-node` cria um arquivo *.npmrc* no executor com o conteúdo a seguir:
+
+```
+//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN}
+registry=https://registry.npmjs.org/
+always-auth=true
+```
+
+### Publicar pacotes em {% data variables.product.prodname_registry %}
+
+Cada vez que você criar uma nova versão, você poderá acionar um fluxo de trabalho para publicar o seu pacote. O fluxo de trabalho no exemplo abaixo é executado sempre que ocorre o evento `versão` com o tipo `criado`. O fluxo de trabalho publica o pacote em {% data variables.product.prodname_registry %} se o teste de CI for aprovado.
+
+Por padrão, o {% data variables.product.prodname_registry %} publica um pacote no repositório {% data variables.product.prodname_dotcom %} que você especificar no campo `nome` do arquivo *package.json*. Por exemplo, você publicaria um pacote denominado `@my-org/test` no repositório `my-org/test` do {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte [`npm-scope`](https://docs.npmjs.com/misc/scope) na documentação do npm.
+
+Para realizar operações autenticadas no registro do {% data variables.product.prodname_registry %} em seu fluxo de trabalho, você pode usar o `GITHUB_TOKEN`. O `GITHUB_TOKEN` existe no repositório por padrão e tem permissões de leitura e gravação para pacotes no repositório em que o fluxo de trabalho é executado. Para obter mais informações, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)".
+
+Este exemplo armazena o segredo `GITHUB_TOKEN` na variável de ambiente `NODE_AUTH_TOKEN`. Quando a ação `setup-node` cria um arquivo *.npmrc*, ela faz referência ao token da variável de ambiente `NODE_AUTH_TOKEN`.
+
+{% raw %}
+```yaml
+nome: Pacote Node.js
+em:
+  versão:
+    tipos: [created]
+trabalhos:
+  criar:
+    runs-on: ubuntu-latest
+    etapas:
+    - usa: actions/checkout@v2
+    # Configura o arquivo .npmrc a ser publicado nos pacotes do GitHub
+    - usa: actions/setup-node@v1
+      com:
+        node-version: '12.x'
+        registry-url: 'https://npm.pkg.github.com'
+        # Tem como padrão o usuário ou organização proprietário do arquivo do fluxo de trabalho
+        escopo: '@octocat'
+    - executar: npm install
+    - run: npm publish
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
+
+A ação `setup-node` cria um arquivo *.npmrc* no executor. Ao usar a entrada do `escopo` para a ação `setup-node`, o arquivo *.npmrc* incluirá o prefixo do escopo. Por padrão, a ação `setup-node` define o escopo no arquivo *.npmrc* na conta que contém esse arquivo do fluxo de trabalho.
+
+```
+//npm.pkg.github.com/:_authToken=${NODE_AUTH_TOKEN}
+@octocat:registry=https://npm.pkg.github.com
+always-auth=true
+```
+
+### Publicar pacotes usando o yarn
+
+Se você usar o gerenciador de pacotes Yarn, você poderá instalar e publicar pacotes usando o Yarn.
+
+{% raw %}
+```yaml
+nome: Pacote Node.js
+em:
+  versão:
+    tipos: [created]
+trabalhos:
+  criar:
+    runs-on: ubuntu-latest
+    etapas:
+    - usa: actions/checkout@v2
+    # Configura o arquivo .npmrc a ser publicado no npm
+    - usa: actions/setup-node@v1
+      com:
+        node-version: '12.x'
+        registry-url: 'https://registry.npmjs.org'
+        # Tem como padrão o usuário ou a organização que é proprietário do arquivo do fluxo de trabalho
+        escopo: '@octocat' 
+    - executar: yarn
+    - executar: yarn publish
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+```
+{% endraw %}
+
+### Publicar pacotes no npm e em {% data variables.product.prodname_registry %}
+
+{% note %}
+
+**Nota:** Se você precisar publicar para registros que têm diferentes prefixos de escopo, você deverá modificar o arquivo *package.json* no executor para alterar o prefixo de escopo. Por exemplo, se você publicar um pacote no escopo `@mona` para o npm e para o escopo `@octocat` para {% data variables.product.prodname_registry %}, você poderá substituir o escopo `@mona` por `@octocat` no arquivo *package.json* no executor, após fazer a publicação no npm e antes de publicar em {% data variables.product.prodname_registry %}.
+
+{% endnote %}
+
+Você pode publicar seus pacotes no registro do npm e em {% data variables.product.prodname_registry %}, usando a ação de `setup-node` para cada registro.
+
+Se você publicar um pacote em ambos os registros, você deverá garantir que seu prefixo de escopo no npm corresponda ao nome do usuário ou da organização do {% data variables.product.prodname_dotcom %}. Para publicar pacotes em um registro público com um prefixo de escopo, você pode usar o comando `npm publish --access public`. Para obter mais informações, consulte [`npm-scope`](https://docs.npmjs.com/misc/scope) e "[Criar e publicar pacotes públicos com escopos](https://docs.npmjs.com/creating-and-publishing-scoped-public-packages)" na documentação do npm.
+
+Certifique-se de que seu arquivo *package.json* inclua o escopo do seu repositório {% data variables.product.prodname_dotcom %} e o registro npm. Por exemplo, se você planeja publicar um pacote no repositório `octocat/npm-hello-world-test` em {% data variables.product.prodname_dotcom %} e em https://www.npmjs. om/package/@octocat/npm-hello-world-test, o nome no arquivo do seu *package.json* seria `"name": "@octocat/npm-hello-world-test"`.
+
+Para realizar operações autenticadas no registro do {% data variables.product.prodname_registry %} em seu fluxo de trabalho, você pode usar o `GITHUB_TOKEN`. O `GITHUB_TOKEN` existe no repositório por padrão e tem permissões de leitura e gravação para pacotes no repositório em que o fluxo de trabalho é executado. Para obter mais informações, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)".
+
+Ao usar a entrada do `escopo` para a ação `setup-node`, esta cria um arquivo *.npmrc* que inclui o prefixo do escopo. Por padrão, a ação `setup-node` define o escopo no arquivo *.npmrc* para o usuário ou organização proprietário do arquivo do fluxo de trabalho.
+
+Este fluxo de trabalho chama a ação `setup-node` duas vezes. Cada vez que a ação `setup-node` é executada, ela substitui o arquivo *.npmrc*. O arquivo *.npmrc* faz referência ao token que permite que você execute operações autenticadas com o registro do pacote a partir da variável de ambiente `NODE_AUTH_TOKEN`. O fluxo de trabalho define a variável de ambiente `NODE_AUTH_TOKEN` toda vez que o comando `publicação do npm` é executado. Primeiro com um token para publicar no npm (`NPM_TOKEN`) e, em seguida, com um token para publicar em {% data variables.product.prodname_registry %} (`GITHUB_TOKEN`).
+
+{% raw %}
+```yaml
+nome: Pacote Node.js
+em:
+  versão:
+    tipos: [created]
+trabalhos:
+  criar:
+    runs-on: ubuntu-latest
+    etapas:
+    - usa: actions/checkout@v2
+    # Configura o arquivo .npmrc a ser publicado no npm
+    - usa: actions/setup-node@v1
+      com:
+        node-version: '10.x'
+        registry-url: 'https://registry.npmjs.org'
+    - executa: npm install
+    # Publica no npm
+    - executa: npm publish --access public
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+    # Configura o arquivo .npmrc a ser publicado nos pacotes do GitHub
+    - usa: actions/setup-node@v1
+      com:
+        registry-url: 'https://npm.pkg.github.com'
+        # Tem como padrão o usuário ou a organização proprietário do arquivo do fluxo de trabalho
+        escopo: '@octocat'
+    # Publicar nos pacotes do GitHub
+    - executar: npm publish
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
diff --git a/translations/pt-BR/content/actions/guides/setting-up-continuous-integration-using-workflow-templates.md b/translations/pt-BR/content/actions/guides/setting-up-continuous-integration-using-workflow-templates.md
new file mode 100644
index 000000000000..631a3792dde6
--- /dev/null
+++ b/translations/pt-BR/content/actions/guides/setting-up-continuous-integration-using-workflow-templates.md
@@ -0,0 +1,49 @@
+---
+title: Configurar a integração contínua usando modelos de fluxo de trabalho
+shortTitle: Configurar CI usando modelos
+intro: É possível configurar a integração contínua no seu projeto usando um modelo de fluxo de trabalho correspondente ao idioma e à ferramenta que você quer usar.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /articles/setting-up-continuous-integration-using-github-actions
+  - /github/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions
+  - /actions/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions
+  - /actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+Qualquer pessoa com permissões de gravação em um repositório pode configurar a integração contínua (CI, Continuous Integration) usando o {% data variables.product.prodname_actions %}.
+
+Depois de configurar a CI, você pode personalizar o fluxo de trabalho conforme as suas demandas.
+
+{% data reusables.repositories.navigate-to-repo %}
+{% data reusables.repositories.actions-tab %}
+1. Localize o modelo correspondente ao idioma e às ferramentas que você quer usar. Em seguida, clique em **Set up this workflow** (Configurar este fluxo de trabalho). ![Botão Setup workflow (Configurar fluxo de trabalho)](/assets/images/help/repository/setup-workflow-button.png)
+5. Clique em **Start commit** (Iniciar commit). ![Botão Start commit (Iniciar commit)](/assets/images/help/repository/start-commit.png)
+{% data reusables.files.write_commit_message %}
+{% data reusables.files.choose_commit_branch %}
+{% data reusables.files.propose_new_file %}
+
+Depois de fazer push no seu repositório, você pode acompanhar o status e os logs detalhados do fluxo de trabalho de integração contínua no {% data variables.product.prodname_dotcom %} e receber notificações personalizadas. Para obter mais informações, consulte "[Configurando notificações](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)" e "
+Gerenciando a execução do fluxo de trabalho".
         
+
+{% data reusables.repositories.actions-workflow-status-badge-into %}
+
+Para obter mais informações, consulte "[Aprenda {% data variables.product.prodname_actions %}](/actions/learn-github-actions)".
+
+
+
+### Leia mais
+
+- [Sobre integração contínua](/articles/about-continuous-integration)
+- [Gerenciar a execução de fluxos de trabalho](/articles/managing-a-workflow-run) 
+  
+  {% if currentVersion == "free-pro-team@latest" %}
+
+- "[Gerenciar a cobrança para {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)" 
+  
+  {% endif %}
diff --git a/translations/pt-BR/content/actions/guides/storing-workflow-data-as-artifacts.md b/translations/pt-BR/content/actions/guides/storing-workflow-data-as-artifacts.md
new file mode 100644
index 000000000000..ba042a23d1d1
--- /dev/null
+++ b/translations/pt-BR/content/actions/guides/storing-workflow-data-as-artifacts.md
@@ -0,0 +1,249 @@
+---
+title: Armazenar dados do fluxo de trabalho como artefatos
+shortTitle: Armazenando artefatos do fluxo de trabalho
+intro: Artefatos permitem que você compartilhe dados entre trabalhos em um fluxo e armazene dados quando o fluxo de trabalho estiver concluído.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /articles/persisting-workflow-data-using-artifacts
+  - /github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts
+  - /actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts
+  - /actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Sobre artefatos de fluxos de trabalho
+
+Os artefatos permitem que você persista com os dados após um trabalho ter sido concluído e compartilhe os dados com outro trabalho no mesmo fluxo de trabalho. Um artefato é um arquivo ou uma coleção de arquivos produzidos durante a execução de um fluxo de trabalho. Por exemplo, você pode usar artefatos para salvar a sua criação e testar a saída após uma conclusão da execução do fluxo de trabalho.
+
+{% data reusables.github-actions.artifact-log-retention-statement %} O período de retenção para um pull request reinicia toda vez que alguém fizer um push de um novo commit para o pull request.
+
+Esses são alguns dos artefatos comuns cujo upload você pode fazer:
+
+- Arquivos de log e descartes de memória;
+- Resultados de testes, falhas e capturas de tela;
+- Arquivos binários ou comprimidos
+- Resultados de teste de estresse e resultados de cobertura do código.
+
+{% if currentVersion == "free-pro-team@latest" %}
+
+Armazenar artefatos consome espaço de armazenamento em {% data variables.product.product_name %}. {% data reusables.github-actions.actions-billing %} Para mais informações, consulte "[Gerenciando cobrança para {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)".
+
+{% else %}
+
+Os artefatos expiram automaticamente após 90 dias, mas você pode recuperar armazenamento utilizado {% data variables.product.prodname_actions %}, excluindo os artefatos antes de expirarem em {% data variables.product.product_name %}.
+
+{% endif %}
+
+Faz-se o upload dos artefatos durante a execução de um fluxo de trabalho e você pode visualizar o nome e o tamanho do artefato na UI. Quando se faz o download de um artefato usando a UI {% data variables.product.product_name %}, todos os arquivos cujo upload foi feito individualmente como parte do get do artefato zipado em um arquivo único. Isso significa que a cobrança é calculada com base no tamanho do artefato subido e não com base no tamanho do arquivo zip.
+
+O {% data variables.product.product_name %} fornece duas ações que você pode usar para fazer upload e baixar artefatos de compilação. Para mais informações veja o {% if currentVersion == "free-pro-team@latest" %}[actions/upload-artifact](https://github.com/actions/upload-artifact) e [download-artefact](https://github.com/actions/download-artifact) ações{% else %} `actions/upload-artefact` e `download-artefact` ações em {% data variables.product.product_location %}{% endif %}.
+
+Para compartilhar dados entre trabalhos:
+
+* **Fazendo o upload dos arquivos**: Fornece ao arquivo subido um nome e faz o upload dos dados antes da conclusão do trabalho.
+* **Fazendo o download dos arquivos**: Você pode apenas fazer o download dos artefatos que foram subidos durante a mesma execução do fluxo de trabalho. Ao fazer o download de um arquivo, você pode fazer referenciá-lo pelo nome.
+
+As etapas de um trabalho compartilham o mesmo ambiente na máquina executora, mas são executados em seus próprios processos individuais. Para transmitir dados entre etapas de um trabalho, você pode usar entradas e saídas. Para obter mais informações sobre entradas e saídas, consulte "[Sintaxe de metadados para o {% data variables.product.prodname_actions %}](/articles/metadata-syntax-for-github-actions)".
+
+### Fazer upload da compilação e testar artefatos
+
+Você pode criar um fluxo de trabalho de integração contínua (CI) para criar e testar o seu código. Para obter mais informações sobre o uso do {% data variables.product.prodname_actions %} para executar CI, consulte "[Sobre integração contínua](/articles/about-continuous-integration)."
+
+A saída da compilação e teste de seu código muitas vezes produz arquivos que podem ser usados para depurar falhas em testes e códigos de produção que você pode implantar. É possível configurar um fluxo de trabalho para compilar e testar o código com push no repositório e relatar um status de sucesso ou falha. Você pode fazer upload da saída de compilação e teste para usar em implantações, para depurar falhas e testes com falhas e visualizar a cobertura do conjunto de teste.
+
+Você pode usar a ação `upload-artifact` para fazer o upload dos artefatos. Ao fazer o upload de um artefato, você pode especificar um arquivo ou diretório único, ou vários arquivos ou diretórios. Você também pode excluir certos arquivos ou diretórios e usar padrões coringa. Recomendamos que você forneça um nome para um artefato, mas se nenhum nome for fornecido, `artefato` será usado como nome-padrão. Para mais informações sobre sintaxe, consulte a ação {% if currentVersion == "free-pro-team@latest" %}[actions/upload-artifact](https://github.com/actions/upload-artifact) {% else %} `actions/upload-artifact` em {% data variables.product.product_location %}{% endif %}.
+
+#### Exemplo
+
+Por exemplo, o seu repositório ou um aplicativo web pode conter arquivos SASS e TypeScript que você deve converter para CSS e JavaScript. Pressupondo que sua configuração de compilação envia os arquivos compilados para o diretório `dist`, você implementaria os arquivos no diretório `dist` no seu servidor de aplicativo web, se todos os testes foram concluídos com sucesso.
+
+```
+|-- hello-world (repository)
+|   └── dist
+|   └── tests
+|   └── src
+|       └── sass/app.scss
+|       └── app.ts
+|   └── output
+|       └── test
+|   
+```
+
+Esse exemplo mostra como criar um fluxo de trabalho para um projeto Node.js que `builds` (compila) o código no diretório `src` e executa os testes no diretório `tests`. Você pode partir do princípio que executar `npm test` produz um relatório de cobertura de código denominado `code-coverage.html`, armazenado no diretório `output/test/`.
+
+O fluxo de trabalho faz o upload dos artefatos de produção no diretório `dist`, mas exclui todos os arquivos de markdown. Ele também e faz o upload do relatório de `code-coverage.html` como outro artefato.
+
+```yaml
+name: Node CI
+
+on: [push]
+
+jobs:
+  build_and_test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v2
+      - name: npm install, build, and test
+        run: |
+          npm install
+          npm run build --if-present
+          npm test
+      - name: Archive production artifacts
+        uses: actions/upload-artifact@v2
+        with:
+          name: dist-without-markdown
+          path: |
+            dist
+            !dist/**/*.md
+      - name: Archive code coverage results
+        uses: actions/upload-artifact@v2
+        with:
+          name: code-coverage-report
+          path: output/test/code-coverage.html
+```
+
+![Imagem de execução de fluxo de trabalho de artefato carregado em fluxo de trabalho](/assets/images/help/repository/upload-build-test-artifact.png)
+
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+### Configurar um período de retenção do artefato personalizado
+
+Você pode definir um período de retenção personalizado para artefatos individuais criados por um fluxo de trabalho. Ao usar um fluxo de trabalho para criar um novo artefato, você pode usar `retention-days` com a ação `upload-artifact`. Este exemplo demonstra como definir um período de retenção personalizado de 5 dias para o artefato denominado `my-artifact`:
+
+```
+  - name: 'Upload Artifact'
+    uses: actions/upload-artifact@v2
+    with:
+      name: my-artifact
+      path: my_file.txt
+      retention-days: 5
+```
+
+O valor `retention-days` não pode exceder o limite de retenção definido pelo repositório, organização ou empresa.
+{% endif %}
+
+### Fazer o download ou excluir artefatos
+
+Durante a execução de um fluxo de trabalho, você pode usar a ação [`download-artifact`](https://github.com/actions/download-artifact)para fazer o download de artefatos previamente carregados na mesma execução de fluxo de trabalho.
+
+Após a conclusão da execução de um fluxo de trabalho, você pode fazer o download ou excluir artefatos em {% data variables.product.prodname_dotcom %} ou usar a API REST. Para obter mais informações, consulte "[Fazer o download de artefatos de fluxo de trabalho](/actions/managing-workflow-runs/downloading-workflow-artifacts), "[Remover artefatos do fluxo de trabalho](/actions/managing-workflow-runs/removing-workflow-artifacts)" e "[Artefatos da REST API](/v3/actions/artifacts/)".
+
+#### Fazer o download dos artefatos durante a execução de um fluxo de trabalho
+
+A ação [`actions/download-artefact`](https://github.com/actions/download-artifact) pode ser usada para fazer o download de artefatos previamente carregados durante a execução de um fluxo de trabalho.
+
+{% note %}
+
+**Observação:** Você só pode baixar artefatos em um fluxo de trabalho que foram carregados durante a mesma execução do fluxo de trabalho.
+
+{% endnote %}
+
+Especifique o nome de um artefato para fazer o download de um artefato individual. Se você fez o upload de um artefato sem especificar um nome, o nome-padrão será `artefato`.
+
+```yaml
+- name: Download a single artifact
+  uses: actions/download-artifact@v2
+  with:
+    name: my-artifact
+```
+
+Você também pode baixar todos os artefatos em uma execução de fluxo de trabalho sem especificar um nome. Isso pode ser útil se você estiver trabalhando com muitos artefatos.
+
+```yaml
+- name: Download all workflow run artifacts
+  uses: actions/download-artifact@v2
+```
+
+Se você fizer o download de todos os artefatos da execução de um fluxo de trabalho, será criado um diretório para cada artefato usando seu nome.
+
+Para mais informações sobre a sintaxe, consulte a ação {% if currentVersion == "free-pro-team@latest" %}[actions/download-artifact](https://github.com/actions/download-artifact) {% else %} `actions/download-artifact` em {% data variables.product.product_location %}{% endif %}.
+
+### Transmitir dados entre trabalhos em um fluxo
+
+Você pode usar as ações `upload-artifact` e `download-artifact` para compartilhar os dados entre os trabalhos em um fluxo de trabalho. Este exemplo de fluxo de trabalho ilustra como transmitir dados entre trabalhos em um mesmo fluxo. Para mais informações veja o {% if currentVersion == "free-pro-team@latest" %}[actions/upload-artifact](https://github.com/actions/upload-artifact) e [download-artefact](https://github.com/actions/download-artifact) ações{% else %} `actions/upload-artefact` e `download-artefact` ações em {% data variables.product.product_location %}{% endif %}.
+
+Os trabalhos que são dependentes de artefatos de um trabalho anterior devem aguardar a finalização do trabalho dependente. Esse fluxo de trabalho usa a palavra-chave `needs` para garantir que `job_1`, `job_2` e `job_3` sejam executados sequencialmente. Por exemplo, `job_2` requer `job_1` usando a sintaxe `needs: job_1`.
+
+O Job 1 (Trabalho 1) executa estas etapas:
+- Realiza um cálculo de correspondência e salva o resultado em um arquivo de texto denominado `math-homework.txt`.
+- Usa a ação `upload-artifact` para fazer upload do arquivo `math-homework.txt` com o nome `homework`. A ação coloca o arquivo em um diretório denominado `homework`.
+
+O Job 2 (Trabalho 2) usa o resultado do trabalho anterior:
+- Baixa o artefato `homework` carregado no trabalho anterior. Por padrão, a ação `download-artifact` baixa artefatos no diretório da área de trabalho no qual a etapa está sendo executada. Você pode usar o parâmetro da entrada do `caminho` para especificar um diretório diferente para o download.
+- Lê o valor no arquivo `homework/math-homework.txt`, efetua um cálculo matemático e salva o resultado em `math-homework.txt`.
+- Faz upload do arquivo `math-homework.txt`. Esse upload sobrescreve o upload anterior, pois ambos compartilham o mesmo nome.
+
+O Job 3 (Trabalho 3) mostra o resultado carregado no trabalho anterior:
+- Baixa o artefato `homework`.
+- Imprime o resultado da operação matemática no log.
+
+A operação matemática completa executada nesse fluxo de trabalho é `(3 + 7) x 9 = 90`.
+
+```yaml
+name: Share data between jobs
+
+on: [push]
+
+jobs:
+  job_1:
+    name: Add 3 and 7
+    runs-on: ubuntu-latest
+    steps:
+      - shell: bash
+        run: |
+          expr 3 + 7 > math-homework.txt
+      - name: Upload math result for job 1
+        uses: actions/upload-artifact@v2
+        with:
+          name: homework
+          path: math-homework.txt
+
+  job_2:
+    name: Multiply by 9
+    needs: job_1
+    runs-on: windows-latest
+    steps:
+      - name: Download math result for job 1
+        uses: actions/download-artifact@v2
+        with:
+          name: homework
+      - shell: bash
+        run: |
+          value=`cat math-homework.txt`
+          expr $value \* 9 > math-homework.txt
+      - name: Upload math result for job 2
+        uses: actions/upload-artifact@v2
+        with:
+          name: homework
+          path: math-homework.txt
+
+  job_3:
+    name: Display results
+    needs: job_2
+    runs-on: macOS-latest
+    steps:
+      - name: Download math result for job 2
+        uses: actions/download-artifact@v2
+        with:
+          name: homework
+      - name: Print the final result
+        shell: bash
+        run: |
+          value=`cat math-homework.txt`
+          echo The result is $value
+```
+
+![Fluxo de trabalho que transmite dados entre trabalhos para executar cálculos matemáticos](/assets/images/help/repository/passing-data-between-jobs-in-a-workflow.png)
+
+{% if currentVersion == "free-pro-team@latest" %}
+
+### Leia mais
+
+- "[Gerenciando cobrança para {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)".
+
+{% endif %}
diff --git a/translations/pt-BR/content/actions/hosting-your-own-runners/about-self-hosted-runners.md b/translations/pt-BR/content/actions/hosting-your-own-runners/about-self-hosted-runners.md
index 8599ef547d93..2a3a148714ca 100644
--- a/translations/pt-BR/content/actions/hosting-your-own-runners/about-self-hosted-runners.md
+++ b/translations/pt-BR/content/actions/hosting-your-own-runners/about-self-hosted-runners.md
@@ -53,6 +53,15 @@ Você pode usar qualquer máquina como um executor auto-hospedado, desde que ela
 * A máquina tem recursos de hardware suficientes para o tipo de fluxos de trabalho que você planeja executar. O aplicativo do executor auto-hospedado requer apenas recursos mínimos.
 * Se você desejar executar fluxos de trabalho que usam ações do contêiner do Docker ou dos contêineres de serviço, você deverá usar uma máquina Linux e o Docker deve estar instalados.
 
+### Limites de uso
+
+Existem alguns limites sobre o uso de {% data variables.product.prodname_actions %} ao usar executores auto-hospedados. Estes limites estão sujeitos a mudanças.
+
+{% data reusables.github-actions.usage-workflow-run-time %}
+- **Tempo de fila de tarefas** - Cada trabalho para executores auto-hospedados pode ser enfileirado por um máximo de 24 horas. Se um executor auto-hospedado não começar a executar a tarefa dentro deste limite, a tarefa será encerrada e não será concluída.
+{% data reusables.github-actions.usage-api-requests %}
+- **Matriz de vagas** - {% data reusables.github-actions.usage-matrix-limits %}
+
 ### Sistemas operacionais compatíveis com executores auto-hospedados
 
 Os sistemas operacionais a seguir são compatíveis com o aplicativo de execução auto-hospedado.
diff --git a/translations/pt-BR/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md b/translations/pt-BR/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md
index bb9ba83b66f7..ddda813cb8c6 100644
--- a/translations/pt-BR/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md
+++ b/translations/pt-BR/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md
@@ -1,6 +1,6 @@
 ---
 title: Adicionar executores auto-hospedados
-intro: 'Você pode adicionar um executor auto-hospedado a {% data variables.product.prodname_actions %}.'
+intro: 'Você pode adicionar um executor auto-hospedado a {{ site.data.variables.product.prodname_actions }}.'
 redirect_from:
   - /github/automating-your-workflow-with-github-actions/adding-self-hosted-runners
   - /actions/automating-your-workflow-with-github-actions/adding-self-hosted-runners
@@ -51,7 +51,8 @@ Você pode adicionar executores auto-hospedados a uma empresa, onde podem ser at
 {% if currentVersion == "free-pro-team@latest" %}
 Para adicionar um executor auto-hospedado a uma conta corporativa, você deve ser proprietário da organização.
 {% else if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21"%}
-Para adicionar um executor auto-hospedado no nível empresa do {% data variables.product.product_location %}, você deve ser um administrador do site.
+Para adicionar um executor auto-hospedado no nível de empresa de
+{% data variables.product.product_location %}, você deve ser um administrador do site.
 {% endif %}
 
 {% if currentVersion == "free-pro-team@latest" %}
diff --git a/translations/pt-BR/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md b/translations/pt-BR/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md
index 34aa5c7e025b..39ef9703651e 100644
--- a/translations/pt-BR/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md
+++ b/translations/pt-BR/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md
@@ -13,7 +13,7 @@ versions:
 {% data reusables.actions.enterprise-beta %}
 {% data reusables.actions.enterprise-github-hosted-runners %}
 
-### Verificar o status de um executor auto-hospedado usando {% data variables.product.prodname_dotcom %}
+### Verificar o status de um executor auto-hospedado usando {{ site.data.variables.product.prodname_dotcom }}
 
 {% data reusables.github-actions.self-hosted-runner-management-permissions-required %}
 
diff --git a/translations/pt-BR/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md b/translations/pt-BR/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md
index 6082b61787f5..a28c7f47f6a3 100644
--- a/translations/pt-BR/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md
+++ b/translations/pt-BR/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md
@@ -1,6 +1,6 @@
 ---
 title: Remover executores auto-hospedados
-intro: 'Você pode remover um executor auto-hospedado de {% data variables.product.prodname_actions %} permantentemente.'
+intro: 'Você pode remover um executor auto-hospedado de {{ site.data.variables.product.prodname_actions }} permantentemente.'
 redirect_from:
   - /github/automating-your-workflow-with-github-actions/removing-self-hosted-runners
   - /actions/automating-your-workflow-with-github-actions/removing-self-hosted-runners
@@ -63,7 +63,8 @@ Para remover um executor auto-hospedado de uma organização, você deve ser um
 {% if currentVersion == "free-pro-team@latest" %}
 Para remover um executor auto-hospedado de uma conta corporativa, você deve ser um proprietário corporativo. Recomendamos que você também tenha acesso à máquina do executor auto-hospedado.
 {% else if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21"%}
-Para remover um executor auto-hospedado de uma organização, você deve ser um proprietário da organização. Recomendamos que você também tenha acesso à máquina do executor auto-hospedado.
+Para remover um executor auto-hospedado no nível da empresa de
+{% data variables.product.product_location %}, você deve ser um administrador do site. Recomendamos que você também tenha acesso à máquina do executor auto-hospedado.
 {% endif %}
 
 {% data reusables.github-actions.self-hosted-runner-reusing %}
diff --git a/translations/pt-BR/content/actions/index.md b/translations/pt-BR/content/actions/index.md
index a20a70e5f1e2..09bd83f878a5 100644
--- a/translations/pt-BR/content/actions/index.md
+++ b/translations/pt-BR/content/actions/index.md
@@ -33,8 +33,8 @@ versions:
 
 
 
-
        
-  
        
+
        
+  
        
     
        
       
        {% data ui.toc.getting_started %}
        
     
        
@@ -45,7 +45,7 @@ versions:
    -
    +

    {% data ui.toc.popular_articles %}

    @@ -56,7 +56,7 @@ versions:
    -
    +

    Gerenciar fluxos de trabalho

    @@ -68,22 +68,28 @@ versions:
    -
    - -
    {% octicon "bookmark" width="24" %}
    -

    Create actions

    -

    A complete guide to creating and sharing actions with the community.

    -     - -
    {% octicon "rocket" width="24" %}
    -

    Starter workflows

    -

    A collection of workflow files to help you get started with GitHub Actions.

    -     - -
    {% octicon "light-bulb" width="24" %}
    -

    GitHub Actions Marketplace

    -

    Explore community actions and supercharge your workflow.

    -     +
    +
    + +
    {% octicon "bookmark" width="24" %}
    +

    Create actions

    +

    A complete guide to creating and sharing actions with the community.

    +     +
    +
    + +
    {% octicon "rocket" width="24" %}
    +

    Starter workflows

    +

    A collection of workflow files to help you get started with GitHub Actions.

    +     +
    +
    + +
    {% octicon "light-bulb" width="24" %}
    +

    GitHub Actions Marketplace

    +

    Explore community actions and supercharge your workflow.

    +     +
    @@ -91,7 +97,7 @@ versions:

    Guias

    -
    +

    Building and testing Node.js

    @@ -107,7 +113,7 @@ versions:
    -
    +

    Building and testing Python

    @@ -123,7 +129,7 @@ versions:
    -
    +

    Building and testing Java with Maven

    @@ -139,7 +145,7 @@ versions:
    -
    +

    Building and testing Java with Gradle

    @@ -155,7 +161,7 @@ versions:
    -
    +

    Building and testing Java with Ant

    @@ -171,7 +177,7 @@ versions:
    -
    +

    Publishing Node.js packages

    diff --git a/translations/pt-BR/content/actions/learn-github-actions/essential-features-of-github-actions.md b/translations/pt-BR/content/actions/learn-github-actions/essential-features-of-github-actions.md new file mode 100644 index 000000000000..9488aa6f7202 --- /dev/null +++ b/translations/pt-BR/content/actions/learn-github-actions/essential-features-of-github-actions.md @@ -0,0 +1,95 @@ +--- +title: Recursos essenciais do GitHub Actions +shortTitle: Recursos essenciais +intro: '{% data variables.product.prodname_actions %} foram projetados para ajudar você a construir automações robustas e dinâmicas. Este guia irá mostrar como criar fluxos de trabalho de {% data variables.product.prodname_actions %} que incluem variáveis de ambiente, scripts personalizados e muito mais.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Visão Geral + +{% data variables.product.prodname_actions %} permite que você personalize seus fluxos de trabalho para atender às necessidades únicas de seu aplicativo e equipe. Neste guia, discutiremos algumas das técnicas de personalização essenciais, como o uso de variáveis, a execução de scripts e o compartilhamento de dados e artefatos entre trabalhos. + +### Usar variáveis em seus fluxos de trabalho + +{% data variables.product.prodname_actions %} incluem variáveis de ambiente-padrão para cada execução de fluxo de trabalho. Se precisar usar variáveis de ambiente personalizadas, você pode defini-las no seu arquivo de fluxo de trabalho YAML. Este exemplo demonstra como criar variáveis personalizadas denominadas `POSTGRES_HOST` e `POSTGRES_PORT`. Essas variáveis estão disponíveis para o script do `node client.js`. + +```yaml +jobs: + example-job: + steps: + - name: Connect to PostgreSQL + run: node client.js + env: + POSTGRES_HOST: postgres + POSTGRES_PORT: 5432 +``` + +Para obter mais informações, consulte "[Usando variáveis de ambiente](/actions/configuring-and-managing-workflows/using-environment-variables)". + +### Adicionar scripts ao seu fluxo de trabalho + +Você pode usar ações para executar scripts e comandos de shell, que são executados no executor atribuído. Este exemplo demonstra como uma ação pode usar a palavra-chave `executar` para executar `npm instalar -g morcegos` no executor. + +```yaml +jobs: + example-job: + steps: + - run: npm install -g bats +``` + +Por exemplo, para executar um script como uma ação, você pode armazenar o script no repositório e fornecer o tipo do caminho e do shell. + +```yaml +jobs: + example-job: + steps: + - name: Run build script + run: ./.github/scripts/build.sh + shell: bash +``` + +Para obter mais informações, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)". + +### Compartilhar dados entre trabalhos + +Se o seu trabalho gera arquivos que você deseja compartilhar com outro trabalho no mesmo fluxo de trabalho, ou se você quiser salvar os arquivos para referência posterior, você pode armazená-los em {% data variables.product.prodname_dotcom %} como _artefatos_. Artefatos são os arquivos que surgem quando você compila e testa seu código. Por exemplo, os artefatos podem incluir arquivos binários ou de pacotes, resultados de testes, capturas de tela ou arquivos de log. Os artefatos estão associados à execução do fluxo de trabalho em que foram criados e podem ser usados por outro trabalho. + +Por exemplo, você pode criar um arquivo e, em seguida, carregá-lo como um artefato. + +```yaml +jobs: + example-job: + name: Save output + steps: + - shell: bash + run: | + expr 1 + 1 > output.log + - name: Upload output file + uses: actions/upload-artifact@v1 + with: + name: output-log-file + path: output.log +``` + +Para fazer o download de um artefato de uma execução de fluxo de trabalho separado, você pode usar a ação `actions/download-artefact`. Por exemplo, você pode fazer o download do artefato denominado `log-file`. + +```yaml +jobs: + example-job: + steps: + - name: Download a single artifact + uses: actions/download-artifact@v2 + with: + name: output-log-file +``` + +Para obter mais informações sobre artefatos, consulte "[Persistir dados de fluxo de trabalho usando artefatos](/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts)". + +### Próximas etapas + +Para continuar aprendendo sobre {% data variables.product.prodname_actions %}, consulte "[Gerenciar fluxos de trabalho complexos](/actions/learn-github-actions/managing-complex-workflows)". diff --git a/translations/pt-BR/content/actions/learn-github-actions/finding-and-customizing-actions.md b/translations/pt-BR/content/actions/learn-github-actions/finding-and-customizing-actions.md new file mode 100644 index 000000000000..27acef164a8f --- /dev/null +++ b/translations/pt-BR/content/actions/learn-github-actions/finding-and-customizing-actions.md @@ -0,0 +1,156 @@ +--- +title: Procurar e personalizar ações +shortTitle: Procurar e personalizar ações +intro: 'Ações são os blocos de construção que alimentam seu fluxo de trabalho. Um fluxo de trabalho pode conter ações criadas pela comunidade, ou você pode criar suas próprias ações diretamente no repositório do seu aplicativo. Este guia mostrará como descobrir, usar e personalizar ações.' +redirect_from: + - /actions/automating-your-workflow-with-github-actions/using-github-marketplace-actions + - /actions/automating-your-workflow-with-github-actions/using-actions-from-github-marketplace-in-your-workflow + - /actions/getting-started-with-github-actions/using-actions-from-github-marketplace + - /actions/getting-started-with-github-actions/using-community-workflows-and-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Visão Geral + +As ações que você usa no seu fluxo de trabalho podem ser definidas em: + +- Um repositório público +- O mesmo repositório onde o arquivo do fluxo de trabalho faz referência à ação +- Uma imagem publicada do contêiner Docker no Docker Hub + +{% data variables.product.prodname_marketplace %} é um local central para você encontrar ações criadas pela comunidade {% data variables.product.prodname_dotcom %}. [A páginade {% data variables.product.prodname_marketplace %}](https://github.com/marketplace/actions/) permite filtrar para ações por categoria. + +{% data reusables.actions.enterprise-marketplace-actions %} + +### Navegação nas ações do Marketplace no editor de fluxo de trabalho + +Você pode pesquisar ações diretamente no seu editor do seu fluxo de trabalho do repositório. Na barra lateral, você pode pesquisar uma ação específica, visualizar ações em destaque e pesquisar categorias em destaque. Você também pode visualizar o número de estrelas que uma ação recebeu da comunidade {% data variables.product.prodname_dotcom %}. + +1. No seu repositório, pesquise o arquivo do fluxo de trabalho que você deseja editar. +1. No canto superior direito da vista do arquivo, clique em {% octicon "pencil" aria-label="The edit icon" %} para abrir o editor do fluxo de trabalho. ![Edite o botão do arquivo do fluxo de trabalho](/assets/images/help/repository/actions-edit-workflow-file.png) +1. No lado direito do editor, use a barra lateral {% data variables.product.prodname_marketplace %} para procurar ações. As ações com o selo de {% octicon "verified" aria-label="The verified badge" %} indicam que {% data variables.product.prodname_dotcom %} verificou o criador da ação como uma organização parceira. ![Barra lateral do fluxo de trabalho do Marketplace](/assets/images/help/repository/actions-marketplace-sidebar.png) + +### Adicionar uma ação ao seu fluxo de trabalho + +Uma página de lista de ações incluem a versão da ação e a sintaxe do fluxo de trabalho necessárias para usar a ação. Para manter seu fluxo de trabalho estável mesmo quando atualizações são feitas em uma ação, você pode fazer referência à versão da ação a ser usada especificando o Git ou da tag do Docker no arquivo de fluxo de trabalho. + +1. Navegue para a ação que você deseja usar no seu fluxo de trabalho. +1. Em "Instalação", clique em {% octicon "clippy" aria-label="The edit icon" %} para copiar a sintaxe do fluxo de trabalho. ![Visualizar lista de ação](/assets/images/help/repository/actions-sidebar-detailed-view.png) +1. Cole a sintaxe como uma nova etapa no seu fluxo de trabalho. Para obter mais informações, consulte a sintaxe "[ para {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idsteps)." +1. Se a ação exigir que você forneça entradas, defina-as no seu fluxo de trabalho. Para obter informações sobre entradas uma ação pode exigir, consulte "[Usar entradas e saídas com uma ação](/actions/learn-github-actions/finding-and-customizing-actions#using-inputs-and-outputs-with-an-action)". + +{% if currentVersion == "free-pro-team@latest" %} + +{% data reusables.dependabot.version-updates-for-actions %} + +{% endif %} + +### Usar o gerenciamento de versões para suas ações personalizadas + +Os criadores de uma ação da comunidade têm a opção de usar tags, branches ou valores do SHA para gerenciar as versçoes da ação. Semelhante a qualquer dependência, você deve indicar a versão da ação que gostaria de usar com para o seu conforto para aceitar automaticamente as atualizações da ação. + +Você irá designar a versão da ação no seu arquivo de fluxo de trabalho. Verifique a documentação da ação para informações sobre suas abordagens de gerenciamento de versões e para ver qual tag, branch ou valor de SHA usar. + +#### Usar tags + +As tags são úteis para permitir que você decida quando alternar entre versões maiores e menores, mas estas são mais efêmeras e podem ser movidas ou excluídas pelo mantenedor. Este exemplo demonstra como direcionar uma ação que foi marcada como `v1.0.1`: + +```yaml +etapas: + - usa: actions/javascript-action@v1.0.1 +``` + +#### Usar SHAs + +Se você precisar de uma versão mais confiável, você deverá usar o valor de SHA associado à versão da ação. Os SHAs são imutáveis e, portanto, mais confiáveis que tags ou branches. No entanto, esta abordagem significa que você não receberá automaticamente atualizações de uma ação, incluindo correções de erros importantes e atualizações de segurança. Este exemplo tem como alvo a ação do SHA: + +```yaml +etapas: + - usa: actions/javascript-action@172239021f7ba04fe7327647b213799853a9eb89 +``` + +#### Usar branches + +Fazer referência a um branch específico significa que a ação sempre incluirá as atualizações mais recentes no branch de destino, mas pode criar problemas se essas atualizações incluírem alterações significativas. Este exemplo é direcionado a um branch denominado `@main`: + +```yaml +steps: + - uses: actions/javascript-action@main +``` + +Para obter mais informações, consulte "[Usar o gerenciamento de versões para ações](/actions/creating-actions/about-actions#using-release-management-for-actions)". + +### Usar entradas e saídas com uma ação + +Uma ação geralmente aceita ou exige entradas e gera saídas que você pode usar. Por exemplo, uma ação pode exigir que você especifique um caminho para um arquivo, o nome de uma etiqueta ou outros dados que usará como parte do processamento da ação. + +Para ver as entradas e saídas de uma ação, verifique a `action.yml` ou `action.yaml` no diretório-raiz do repositório. + +Neste exemplo `action.yml`, a palavra-chave `entradas` define uma entrada obrigatória denominada `file-path` e inclui um valor-padrão que será usado, caso nenhum valor seja especificado. A palavra-chave `saídas` define uma saída denominada `results-file`, que diz onde localizar os resultados. + +```yaml +name: 'Example' +description: 'Receives file and generates output' +inputs: + file-path: # id of input + description: "Path to test script" + required: true + default: 'test-file.js' +outputs: + results-file: # id of output + description: "Path to results file" +``` + +### Referenciando uma ação no mesmo repositório onde um arquivo de fluxo de trabalho usa a ação + +Se uma ação for definida no mesmo repositório onde seu arquivo de fluxo de trabalho usa a ação, você pode referenciar a ação com o`{owner}/{repo}@{ref}` ou `./path/to/dir` sintaxe no seu arquivo de fluxo de trabalho. + +Estrutura de arquivos do repositório de exemplo: + +``` +|-- Hello-world (repositório) +| |__ .github +| fluxos de trabalho └sadessa +| └➤➤ my-first-workflow.yml +| ações └➤➤ +| |__ Hello-world-action +| └➤➤ ação.yml +``` + +Arquivo de fluxo de trabalho de exemplo: + +```yaml +empregos: + construir: + runs-on: ubuntu-latest + passos: + # Esta etapa confere uma cópia do seu repositório. + - usa: ações/checkout@v2 + # Esta etapa faz referência ao diretório que contém a ação. + - usa: ./.github/actions/hello-world-action +``` + +O arquivo `action.yml` é usado para fornecer metadados para a ação. Saiba mais sobre o conteúdo deste arquivo em "[Sintaxe de metadados para o GitHub Actions](/actions/creating-actions/metadata-syntax-for-github-actions)" + +### Referenciando um contêiner no Docker Hub + +Se uma ação for definida em uma imagem de contêiner Docker publicada no Docker Hub, você deve fazer referência à ação com o `docker://{image}:{tag}` sintaxe em seu arquivo de fluxo de trabalho. Para proteger seu código e dados, recomendamos fortemente que verifique a integridade da imagem do contêiner Docker do Docker Hub antes de usá-la em seu fluxo de trabalho. + +```yaml +empregos: + my_first_job: + passos: + - nome: Meu primeiro passo + usa: docker://alpine:3.8 +``` + +Para ver alguns exemplos de ações do Docker, consulte o [Fluxo de trabalho Docker-image.yml](https://github.com/actions/starter-workflows/blob/main/ci/docker-image.yml) e "[Criar uma ação de contêiner do Docker](/articles/creating-a-docker-container-action)." + +### Próximas etapas + +Para continuar aprendendo mais sobre {% data variables.product.prodname_actions %}, consulte "[Recursos essenciais de {% data variables.product.prodname_actions %}](/actions/learn-github-actions/essential-features-of-github-actions)". diff --git a/translations/pt-BR/content/actions/learn-github-actions/index.md b/translations/pt-BR/content/actions/learn-github-actions/index.md new file mode 100644 index 000000000000..3d2262a1e52a --- /dev/null +++ b/translations/pt-BR/content/actions/learn-github-actions/index.md @@ -0,0 +1,42 @@ +--- +title: Aprenda o GitHub Actions +shortTitle: Aprenda o GitHub Actions +intro: 'Seja você novo em {% data variables.product.prodname_actions %} ou interessado em aprender tudo o que tem a oferecer, este guia ajudará você a usar {% data variables.product.prodname_actions %} para acelerar seus fluxos de trabalho de desenvolvimento de aplicativos.' +redirect_from: + - /articles/about-github-actions + - /github/automating-your-workflow-with-github-actions/about-github-actions + - /actions/automating-your-workflow-with-github-actions/about-github-actions + - /actions/getting-started-with-github-actions + - /actions/getting-started-with-github-actions/about-github-actions + - /actions/getting-started-with-github-actions/overview + - /actions/getting-started-with-github-actions/getting-started-with-github-actions + - /articles/migrating-github-actions-from-hcl-syntax-to-yaml-syntax/ + - /actions/configuring-and-managing-workflows/configuring-a-workflow + - /artigos/criando-um-fluxo de trabalho-com-github-actions/ + - /artigos/configuração-a-fluxo de trabalho + - /github/automating-your-workflow-with-github-actions/configuring-a-workflow + - /ações/automatizando-seu-fluxo de trabalho-com-github-actions/configurando-um-fluxo de trabalho + - /ações/criação de fluxos de trabalho/opções de configuração de fluxo de trabalho + - /articles/configuring-workflows + - /github/automating-your-workflow-with-github-actions/configuring-workflows + - /actions/automating-your-workflow-with-github-actions/configuring-workflows + - /github/automating-your-workflow-with-github-actions/getting-started-with-github-actions + - /actions/automating-your-workflow-with-github-actions/getting-started-with-github-actions + - /actions/configuring-and-managing-workflows + - /articles/getting-started-with-github-actions + - /actions/migrating-to-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% link_with_intro /introduction-to-github-actions %} +{% link_with_intro /finding-and-customizing-actions %} +{% link_with_intro /essential-features-of-github-actions %} +{% link_with_intro /managing-complex-workflows %} +{% link_with_intro /sharing-workflows-with-your-organization %} +{% link_with_intro /security-hardening-for-github-actions %} +{% link_with_intro /migrating-from-circleci-to-github-actions %} +{% link_with_intro /migrating-from-gitlab-cicd-to-github-actions %} +{% link_with_intro /migrating-from-azure-pipelines-to-github-actions %} +{% link_with_intro /migrating-from-jenkins-to-github-actions %} diff --git a/translations/pt-BR/content/actions/learn-github-actions/introduction-to-github-actions.md b/translations/pt-BR/content/actions/learn-github-actions/introduction-to-github-actions.md new file mode 100644 index 000000000000..7e35c3df9a2e --- /dev/null +++ b/translations/pt-BR/content/actions/learn-github-actions/introduction-to-github-actions.md @@ -0,0 +1,225 @@ +--- +title: Introdução ao GitHub Actions +shortTitle: Introdução ao GitHub Actions +intro: 'Aprenda sobre os conceitos principais e vários componentes de {% data variables.product.prodname_actions %} e veja um exemplo que mostre como adicionar automação ao seu repositório.' +redirect_from: + - /github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions + - /actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions + - /actions/getting-started-with-github-actions/core-concepts-for-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Visão Geral + +{% data variables.product.prodname_actions %} ajuda você a automatizar tarefas dentro de seu ciclo de vida de desenvolvimento de software. {% data variables.product.prodname_actions %} são orientados por eventos, o que significa que você pode executar uma série de comandos após um evento especificado ocorrer. Por exemplo, cada vez que alguém cria um pull request para um repositório, você pode executar automaticamente um comando que executa um script de teste do software. + +Este diagrama demonstra como você pode usar {% data variables.product.prodname_actions %} para executar automaticamente seus scripts de teste de software. Um evento aciona automaticamente o _fluxo de trabalho_, que contém um _trabalho_. Em seguida, o trabalho usa _etapas_ para controlar a ordem em que as _ações_ são executadas. Estas ações são os comandos que automatizam o teste do seu software. + +![Visão geral do fluxo de trabalho](/assets/images/help/images/overview-actions-simple.png) + +### Componentes de {% data variables.product.prodname_actions %} + +Abaixo está uma lista dos múltiplos componentes de {% data variables.product.prodname_actions %} que trabalham em conjunto para executar os trabalhos. Você pode ver como esses componentes interagem uns com os outros. + +![Visão geral do componente e do serviço](/assets/images/help/images/overview-actions-design.png) + +#### Fluxos de trabalho + +O fluxo de trabalho é um procedimento automatizado que você adiciona ao seu repositório. Os fluxos de trabalho são constituídos por um ou mais trabalhos e podem ser programados ou ativados por um evento. O fluxo de trabalho pode ser usado para criar, testar, empacotar, publicar ou implantar um projeto em {% data variables.product.prodname_dotcom %}. + +#### Eventos + +Um evento é uma atividade específica que aciona um fluxo de trabalho. Por exemplo, uma atividade pode originar de {% data variables.product.prodname_dotcom %} quando alguém faz o push de um commit em um repositório ou quando são criados um problema ou um pull request. Também é possível usar o webhook de envio de repositório para acionar um fluxo de trabalho quando ocorrer um evento externo. Para obter uma lista completa de eventos que podem ser usados para acionar fluxos de trabalho, consulte [Eventos que acionam fluxos de trabalho](/actions/reference/events-that-trigger-workflows). + +#### Trabalhos + +Um trabalho é um conjunto de etapas executadas no mesmo executor. Por padrão, um fluxo de trabalho com vários trabalhos executará esses trabalhos em paralelo. Também é possível configurar um fluxo de trabalho para executar trabalhos sequencialmente. Por exemplo, um fluxo de trabalho pode ter dois trabalhos sequenciais que criam e testam códigos. em que o trabalho de teste depende do status do trabalho de criação. Se ocorrer uma falha no trabalho de criação, o trabalho de teste não será executado. + +#### Etapas + +Uma etapa é uma tarefa individual que pode executar comandos (conhecidos como _ações_). Cada etapa de um trabalho é executada no mesmo executor, permitindo que as ações naquele trabalho compartilhem dados entre si. + +#### Ações + +_Ações_ são comandos autônomos combinados em _etapas_ para criar um _trabalho_. As ações são o menor bloco de criação portátil de um fluxo de trabalho. Você pode criar as suas próprias ações ou usar ações criadas pela comunidade de {% data variables.product.prodname_dotcom %}. Para usar uma ação em um fluxo de trabalho, você deverá incluí-la como uma etapa. + +#### Executores + +Um executor é um servidor com a aplicação de executor de {% data variables.product.prodname_actions %} instalada. Você pode usar um executor hospedado em {% data variables.product.prodname_dotcom %} ou você pode hospedar seu próprio. Um executor escuta trabalhos disponíveis, executa um trabalho de cada vez e relata o progresso, os registros e os resultados de volta para {% data variables.product.prodname_dotcom %}. Para executores hospedados em {% data variables.product.prodname_dotcom %}, cada trabalho em um fluxo de trabalho é executado em um novo ambiente virtual. + +Os executores hospedados em {% data variables.product.prodname_dotcom %}runners são baseados no Ubuntu Linux, Microsoft Windows e macOS. Para informações sobre executores hospedados em {% data variables.product.prodname_dotcom %}, consulte "[Ambientes virtuais para executores hospedados em {% data variables.product.prodname_dotcom %}-](/actions/reference/virtual-environments-for-github-hosted-runners)". Se você precisar de um sistema operacional diferente ou precisar de uma configuração de hardware específica, você poderá hospedar seus próprios executores. Para obter informações sobre executores auto-hospedados, consulte "[Hospedar seus próprios executores](/actions/hosting-your-own-runners)". + +### Criar um exemplo de fluxo de trabalho + +{% data variables.product.prodname_actions %} usa sintaxe de YAML para definir os eventos, trabalhos e etapas. Esses arquivos de YAML são armazenados no seu repositório de código em um diretório denominado `.github/workflows`. + +Você pode criar um exemplo de fluxo de trabalho no repositório que aciona automaticamente uma série de comandos sempre que o código for carregado. Neste fluxo de trabalho, {% data variables.product.prodname_actions %} verifica o código enviado, instala as dependências do software e executa `bats -v`. + +1. No seu repositório, crie o diretório `.github/workflows/` para armazenar seus arquivos do fluxo de trabalho. +1. No diretório `.github/workflows/`, crie um novo arquivo denominado `learn-github-actions.yml` e adicione o código a seguir. + ```yaml + name: learn-github-actions + on: [push] + jobs: + check-bats-version: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - uses: actions/setup-node@v1 + - run: npm install -g bats + - run: bats -v + ``` +1. Faça commit dessas alterações e faça push para o seu repositório do {% data variables.product.prodname_dotcom %}. + +Seu novo arquivo de fluxo de trabalho de {% data variables.product.prodname_actions %} agora está instalado no seu repositório e será executado automaticamente toda vez que alguém fizer push de uma alteração no repositório. Para obter detalhes sobre o histórico de execução de um trabalho, consulte "[Visualizar a atividade do fluxo de trabalho](/actions/learn-github-actions/introduction-to-github-actions#viewing-the-jobs-activity)". + +### Entender o arquivo de fluxo de trabalho + +Para ajudar você a entender como a sintaxe de YAML é usada para criar um arquivo de fluxo de trabalho, esta seção explica cada linha do exemplo Introdução: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + + ```yaml + name: learn-github-actions + ``` + + Opcional - Como o nome do fluxo de trabalho irá aparecer na aba Ações do repositório de {% data variables.product.prodname_dotcom %}. +
    + + ```yaml + on: [push] + ``` + + Especifica o evento que aciona automaticamente o arquivo do fluxo de trabalho. Este exemplo usa o evento push para que os trabalhos sejam executados toda vez que alguém fizer uma alteração no repositório. É possível definir o fluxo de trabalho para ser executado somente em determinados branches, caminhos ou tags. Para obter exemplos de sintaxe, incluindo ou excluindo branches, caminhos ou tags, consulte "Sintaxe de fluxo de trabalho para {% data variables.product.prodname_actions %}" +
    + + ```yaml + jobs: + ``` + + Agrupa todos os trabalhos executados no arquivo de fluxo de trabalho learn-github-actions. +
    + + ```yaml + check-bats-version: + ``` + + Define o nome do trabalho check-bats-version armazenado na seção trabalhos. +
    + + ```yaml + runs-on: ubuntu-latest + ``` + + Configura o trabalho a ser executado em um executor do Ubuntu Linux. Isto significa que o trabalho será executado em uma nova máquina virtual hospedada pelo GitHub. Para obter exemplos de sintaxe usando outros executores, consulte "Sintaxe de fluxo de trabalho para {% data variables.product.prodname_actions %}." +
    + + ```yaml + steps: + ``` + + Agrupa todos os passos são executados no trabalho check-bats-version. Cada linha aninhada nesta seção é uma ação separada. +
    + + ```yaml + - uses: actions/checkout@v2 + ``` + + A palavra-chave usa diz ao trabalho para recuperar v2 da ação da comunidade com o nome actions/checkout@v2. Esta é uma ação que verifica seu repositório e o faz o download do runner, permitindo que você execute ações contra seu código (como, por exemplo, ferramentas de teste). Você deve usar a ação de checkout sempre que o fluxo de trabalho for executado no código do repositório ou você estiver usando uma ação definida no repositório. +
    + + ```yaml + - uses: actions/setup-node@v1 + ``` + + Esta ação instala o pacote do software nó no executor, dando acesso ao comando npm. +
    + + ```yaml + - run: npm install -g bats + ``` + + A palavra-chave executar diz ao trabalho para executar um comando no executor. Neste caso, você está usando o npm para instalar o pacote de teste do software bats. +
    + + ```yaml + - run: bats -v + ``` + + Por fim, você executará o comando bats com um parâmetro que produz a versão do software. +
    + +#### Visualizar o arquivo de fluxo de trabalho + +Neste diagrama, você pode ver o arquivo de fluxo de trabalho que acabou de criar e como os componentes de {% data variables.product.prodname_actions %} estão organizados em uma hierarquia. Cada etapa executa uma única ação. As etapas 1 e 2 usam ações de comunidade pré-criadas. Para encontrar mais ações pré-criadas para seus fluxos de trabalho, consulte "[Encontrar e personalizar ações](/actions/learn-github-actions/finding-and-customizing-actions)". + +![Visão geral do fluxo de trabalho](/assets/images/help/images/overview-actions-event.png) + + +### Visualizar a atividade do trabalho + +Assim que seu trabalho começar a funcionar, você pode ver as atividades de cada etapa em {% data variables.product.prodname_dotcom %}. + +{% data reusables.repositories.navigate-to-repo %} +1. No nome do seu repositório, clique em **Ações**. ![Acesse o repositório](/assets/images/help/images/learn-github-actions-repository.png) +1. Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver. ![Captura de tela dos resultados do fluxo de trabalho](/assets/images/help/images/learn-github-actions-workflow.png) +1. Em "Execuções do fluxo de trabalho", clique no nome da execução que você deseja ver. ![Captura de tela das execuções do fluxo de trabalho](/assets/images/help/images/learn-github-actions-run.png) +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +1. Clique no nome do trabalho para ver os resultados de cada etapa. ![Captura de tela dos detalhes de execução do fluxo de trabalho](/assets/images/help/images/overview-actions-result-updated.png) +{% else %} +1. Clique no nome do trabalho para ver os resultados de cada etapa. ![Captura de tela dos detalhes de execução do fluxo de trabalho](/assets/images/help/images/overview-actions-result.png) +{% endif %} + +### Próximas etapas + +Para continuar aprendendo sobre {% data variables.product.prodname_actions %}, consulte "[Encontrar e personalizar ações](/actions/learn-github-actions/finding-and-customizing-actions)". + +### Entrar em contato com o suporte + +{% data reusables.github-actions.contacting-support %} diff --git a/translations/pt-BR/content/actions/learn-github-actions/managing-complex-workflows.md b/translations/pt-BR/content/actions/learn-github-actions/managing-complex-workflows.md new file mode 100644 index 000000000000..3f0a3b30befe --- /dev/null +++ b/translations/pt-BR/content/actions/learn-github-actions/managing-complex-workflows.md @@ -0,0 +1,151 @@ +--- +title: Gerenciar fluxos de trabalhos complexos +shortTitle: Gerenciar fluxos de trabalhos complexos +intro: 'Este aba mostra como usar os recursos avançados de {% data variables.product.prodname_actions %}, com gestão de segredos, trabalhos dependentes, armazenamento em cache, criação de matrizes e etiquetas.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Visão Geral + +Este artigo descreve alguns dos recursos avançados de {% data variables.product.prodname_actions %} que ajudam você a trabalhar criar fluxos de trabalho mais complexos. + +### Armazenar segredos + +Se os seus fluxos de trabalho usarem dados confidenciais, como senhas ou certificados, você pode salvá-los em {% data variables.product.prodname_dotcom %} como _segredos_ e usá-los nos seus fluxos de trabalho como variáveis de ambiente. Isto significa que você poderá criar e compartilhar fluxos de trabalho sem ter de incorporar valores sensíveis diretamente no fluxo de trabalho de YAML. + +Esta ação de exemplo demonstra como fazer referência a um segredo existente como uma variável de ambiente e enviá-lo como um parâmetro para um comando de exemplo. + +{% raw %} +```yaml +jobs: + example-job: + steps: + - name: Retrieve secret + env: + super_secret: ${{ secrets.SUPERSECRET }} + run: | + example-command "$SUPER_SECRET" +``` +{% endraw %} + +Para obter mais informações, consulte "[Criar e armazenar segredos encriptados](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)". + +### Criar trabalhos dependentes + +Por padrão, os trabalhos do seu fluxo de trabalho são executadas em paralelo e ao mesmo tempo. Portanto, se você tem um trabalho que só deve ser executado após a conclusão de outro trabalho, você pode usar a palavra-chave `needs` para criar esta dependência. Se um dos trabalhos falhar, todos os trabalhos dependentes serão suprimidos. No entanto, se você precisa que os trabalhos continuem, você pode definir isso usando a declaração condicional [`se`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idif). + +Neste exemplo, os trabalhos de `configuração`, `criação` e `teste` executados em série, com `criação` e `teste` sendo dependentes da conclusão bem-sucedida do trabalho que os precede: + +```yaml +jobs: + setup: + runs-on: ubuntu-latest + steps: + - run: ./setup_server.sh + build: + needs: setup + steps: + - run: ./build_server.sh + test: + needs: build + runs-on: ubuntu-latest + steps: + - run: ./test_server.sh +``` + +Para obter mais informações, consulte [`jobs..needs`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds). + +### Usar uma matriz de criação + +Você pode usar uma matriz de criação se quiser que seu fluxo de trabalho execute testes em várias combinações de sistemas operacionais, plataformas e linguagens. A matriz de criação é criada usando a palavra-chave `estratégia`, que recebe as opções de compilação como um array. Por exemplo, essa matriz de criação irá executar o trabalho várias vezes, usando diferentes versões do Node.js: + +{% raw %} +```yaml +jobs: + build: + runs-on: ubuntu-latest + strategy: + matrix: + node: [6, 8, 10] + steps: + - uses: actions/setup-node@v1 + with: + node-version: ${{ matrix.node }} +``` +{% endraw %} + +Para obter mais informações, consulte [`>jobs..strategy.matrix`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix). + +### Memorizar dependências + +Executores hospedados em {% data variables.product.prodname_dotcom %} são iniciados como ambientes novos para cada trabalho. Portanto, se os seus trabalhos reutilizam dependências regularmente, você pode considerar fazer armazenamento em cache desses arquivos para ajudar a melhorar o desempenho. Após a criação do armazenamento em cache, ele fica disponível para todos os fluxos de trabalho no mesmo repositório. + +Este exemplo demonstra como armazenar em cache o diretório `~/.npm`: + +{% raw %} +```yaml +jobs: + example-job: + steps: + - name: Cache node modules + uses: actions/cache@v2 + env: + cache-name: cache-node-modules + with: + path: ~/.npm + key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }} + restore-keys: | + ${{ runner.os }}-build-${{ env.cache-name }}- +``` +{% endraw %} + +Para obter mais informações, consulte "[Memorizando dependências para acelerar fluxos de trabalho](/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows)". + +### Usar bancos de dados e contêineres de serviço + +Se sua tarefa exigir um banco de dados ou serviço de cache, você poderá usar a palavra-chave [`serviços`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idservices) para criar um contêiner efêmero para hospedar o serviço; o contêiner resultante ficará disponível em todas as etapas do trabalho e será removido quando o trabalho for concluído. Este exemplo demonstra como um trabalho pode usar `serviços` para criar um contêiner `postgres` e, em seguida, usar o `nó` para conectar-se ao serviço. + +```yaml +jobs: + container-job: + runs-on: ubuntu-latest + container: node:10.18-jessie + services: + postgres: + image: postgres + steps: + - name: Check out repository code + uses: actions/checkout@v2 + - name: Install dependencies + run: npm ci + - name: Connect to PostgreSQL + run: node client.js + env: + POSTGRES_HOST: postgres + POSTGRES_PORT: 5432 +``` + +Para obter mais informações, consulte "[Usar bancos de dados e contêineres de serviço](/actions/configuring-and-managing-workflows/using-databases-and-service-containers)". + +### Usar etiquetas para encaminhar fluxos de trabalho + +Esse recurso ajuda você a atribuir tarefas a um executor auto-hospedado específico. Se você quiser ter certeza de que um determinado tipo de executor irá processar seu trabalho, você pode usar etiquetas para controlar os locais onde os trabalhos são executados. Você pode atribuir etiquetas a um corredor auto-hospedado e, em seguida, consultá-las no fluxo de trabalho de YAML, garantindo que o trabalho seja encaminhado de uma forma previsível. + +Este exemplo mostra como um fluxo de trabalho pode usar etiquetas para especificar o executor obrigatório: + +```yaml +jobs: + example-job: + runs-on: [self-hosted, linux, x64, gpu] +``` + +Para obter mais informações, consulte ["Usar etiquetas com executores auto-hospedados](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners)". + +### Próximas etapas + +Para continuar aprendendo sobre {% data variables.product.prodname_actions %}, consulte "[Compartilhar fluxos de trabalho com a sua organização](/actions/learn-github-actions/sharing-workflows-with-your-organization)". diff --git a/translations/pt-BR/content/actions/learn-github-actions/migrating-from-azure-pipelines-to-github-actions.md b/translations/pt-BR/content/actions/learn-github-actions/migrating-from-azure-pipelines-to-github-actions.md new file mode 100644 index 000000000000..6749f2202603 --- /dev/null +++ b/translations/pt-BR/content/actions/learn-github-actions/migrating-from-azure-pipelines-to-github-actions.md @@ -0,0 +1,327 @@ +--- +title: Migrar do Azure Pipelines para o GitHub Actions +intro: 'O {% data variables.product.prodname_actions %} e o Azure Pipelines compartilham várias semelhanças de configuração, o que torna a migração para {% data variables.product.prodname_actions %} relativamente simples.' +redirect_from: + - /actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Introdução + +O Azure Pipelines e o {% data variables.product.prodname_actions %} permitem criar fluxos de trabalho que automaticamente criam, testam, publicam, lançam e implantam códigos. O Azure Pipelines e o {% data variables.product.prodname_actions %} compartilham algumas similaridades na configuração do fluxo de trabalho: + +- Os arquivos de configuração do fluxo de trabalho são gravados YAML e armazenados no repositório do código. +- Os fluxos de trabalho incluem um ou mais trabalhos. +- Os trabalhos incluem uma ou mais etapas ou comandos individuais. +- É possível reutilizar e compartilhar novamente etapas ou tarefas com a comunidade. + +Para obter mais informações, consulte "[Conceitos básicos para {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)". + +### Principais diferenças + +Ao migrar do Azure Pipelines, considere as diferenças a seguir: + +- O Azure Pipelines suporta um legado do _editor clássico_, que permite que você defina sua configuração de CI em um editor GUI em vez de criar a definição do pipeline em um arquivo YAML. O {% data variables.product.prodname_actions %} usa arquivos YAML para definir fluxos de trabalho e não é compatível com um editor gráfico. +- O Azure Pipelines permite que você omita algumas estruturas nas definições de trabalho. Por exemplo, se você tem apenas um único trabalho, não é necessário definir o trabalho. Você precisa definir apenas as etapas. O {% data variables.product.prodname_actions %} requer configuração explícita e não é possível omitir a estrutura do YAML. +- O Azure Pipelines é compatível com as _etapas_ definidas no arquivo YAML, que pode ser usado para criar fluxos de trabalho de implantação. O {% data variables.product.prodname_actions %} exige que você que você separe as etapas em arquivos separados do fluxo de trabalho do YAML. +- É possível selecionar os agentes de criação locais do Azure Pipelines com recursos. {% data variables.product.prodname_actions %} executores auto-hospedados podem ser selecionados com etiquetas. + +### Migrar trabalhos e etapas + +Os trabalhos e as etapas no Azure Pipelines são muito semelhantes a trabalhos e etapas do {% data variables.product.prodname_actions %}. Em ambos os sistemas, os trabalhos têm as características a seguir: + +* Os trabalhos contêm uma série de etapas executadas em sequência. +* Os trabalhos são executados em máquinas virtuais separadas ou em contêineres separados. +* Por padrão, os trabalhos executados em paralelo, mas podem ser configuradas para serem executados em sequência. + +### Migrar etapas de script + +Você pode executar um script ou um comando de shell como uma etapa em um fluxo de trabalho. No Azure Pipelines, as etapas do script podem ser especificadas usando a chave `script`, ou usando as chaves `bash`, `powershell`, ou `pwsh`. É possível especificar os scripts como entrada para uma [tarefa de Bash](https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/utility/bash?view=azure-devops) ou a como uma [tarefa de PowerShell](https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/utility/powershell?view=azure-devops). + +Em {% data variables.product.prodname_actions %}, todos os scripts são especificados usando a chave `executar`. Para selecionar um shell específico, você pode especificar a chave `shell` ao fornecer o script. Para obter mais informações, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)". + +Abaixo, há um exemplo da sintaxe para cada sistema: + + + + + + + + + + +
    +Azure Pipelines + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +trabalhos: +- trabalho: scripts + pool: + vmImage: 'windows-latest' + etapas: + - script: echo "Esta etapa é executada no shell-padrão" + - bash: echo "Esta etapa é executada em bash" + - pwsh: Write-Host "Esta etapa é executada no centro do PowerShell" + - tarefa: PowerShell@2 + entrada: + script: Write-Host "Esta etapa é executada em PowerShell" +``` +{% endraw %} + +{% raw %} +```yaml +trabalhos: + scripts: + runs-on: windows-latest + etapas: + - executar: echo "Esta etapa é executada no shell-padrão" + - run: echo "Esta etapa é executada em bash" + shell: bash + - executar : Write-Host "Esta etapa é executada no centro do PowerShell" + shell: pwsh + - run: Write-Host "Esta etapa é executada no PowerShell" + shell: powershell +``` +{% endraw %} +
    + +### Diferenças na manipulação de erros de script + +No Azure Pipelines, os scripts podem ser configurados com erro se houver uma saída for enviada para `stderr`. {% data variables.product.prodname_actions %} não suporta esta configuração. + +{% data variables.product.prodname_actions %} configura shells como "falha rápida" sempre que possível, que interrompe o script imediatamente caso um dos comandos em um script saia com um código de erro. Em contrapartida, o Azure Pipelines exige uma configuração explícita para sair imediatamente de um erro. Para obter mais informações, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#exit-codes-and-error-action-preference)". + +### Diferenças no shell-padrão no Windows + +No Azure Pipelines, o shell-padrão para scripts nas plataformas do Windows é o shell de comando (_cmd.exe_). Em {% data variables.product.prodname_actions %}, o shell-padrão para os scripts nas plataformas do Windows é o PowerShell. O PowerShell tem várias diferenças em comandos integrados, expansão de variáveis e controle de fluxo. + +Se você estiver executando um comando simples, você poderá executar um script do shell do comando no PowerShell sem alterações. No entanto, na maioria dos casos, você deverá atualizar seu script com sintaxe PowerShell ou instruir {% data variables.product.prodname_actions %} para executar o script com a shell de comando em vez de executar o PowerShell. Você pode fazer isso especificando o `shell` como `cmd`. + +Abaixo, há um exemplo da sintaxe para cada sistema: + + + + + + + + + + +
    +Azure Pipelines + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +trabalhos: +- trabalho: run_command + pool: + vmImage: 'windows-latest' + trabalhos: + - script: echo "Esta etapa é executada em CMD no Windows por padrão" +``` +{% endraw %} + +{% raw %} +```yaml +trabalhos: + run_command: + runs-on: windows-latest + steps: + - executar: echo "Esta etapa é executada no PowerShell no Windows por padrão" + - executar: echo "Esta etapa é executada em CMD no Windows explicitamente" + shell: cmd +``` +{% endraw %} +
    + +Para obter mais informações, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#using-a-specific-shell)". + +### Migrar condicionais e sintaxe de expressão + +O Azure Pipelines e {% data variables.product.prodname_actions %} podem executar as etapas condicionalmente. No Azure Pipelines, expressões condicionais são especificadas usando a chave `condição`. Em {% data variables.product.prodname_actions %}, as expressões condicionais são especificadas usando a chave `se`. + +O Azure Pipelines usa funções dentro de expressões para executar as etapas condicionalmente. Em contrapartida, {% data variables.product.prodname_actions %} usa uma notação de infixo. Por exemplo, você deve substituir a função `eq` no Azure Pipelines pelo operador `==` em {% data variables.product.prodname_actions %}. + +Abaixo, há um exemplo da sintaxe para cada sistema: + + + + + + + + + + +
    +Azure Pipelines + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +trabalhos: +- trabalho: condicional + pool: + vmImage: 'ubuntu-latest' + etapas: + - script: echo "Esta etapa é executada com str equals 'ABC' and num equals 123" + condição: and(eq(variables.str, 'ABC'), eq(variables.num, 123)) +``` +{% endraw %} + +{% raw %} +```yaml +trabalhos: + condicional: + runs-on: ubuntu-latest + etapas: + - executar: echo "Esta etapa é executada com str equals 'ABC' and num equals 123" + if: ${{ env.str == 'ABC' && env.num == 123 }} +``` +{% endraw %} +
    + +Para obter mais informações, consulte "[Contexto e sintaxe de expressão para {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)". + +### Dependências entre trabalhos + +Tanto o Pipelines Azure quanto o {% data variables.product.prodname_actions %} permitem que você defina as dependências para um trabalho. Em ambos os sistemas, os trabalhos são executados em paralelo por padrão, mas as dependências do trabalho podem ser especificadas explicitamente. No Azure Pipelines, isso é feito com a chave `dependsOn`. Em {% data variables.product.prodname_actions %}, isso é feito com a chave `needs`. + +Abaixo, há um exemplo da sintaxe para cada sistema. O fluxo de trabalho inicia um primeiro trabalho denominado `inicial` e, quando esse trabalho é concluído, dois trabalhos denominados `fanout1` e `fanout2` serão executados. Por fim, quando esses trabalhos forem concluídos, o trabalho `fanin` será executado. + + + + + + + + + + +
    +Azure Pipelines + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +trabalhos: +- trabalho: inicial + pool: + vmImage: 'ubuntu-latest' + etapas: + - script: echo "Este trabalho será executado primeiro." +- trabalho: fanout1 + pool: + vmImage: 'ubuntu-latest' + dependsOn: inicial + etapas: + - script: echo "Este trabalho será executado após o trabalho inicial, em paralelo com o fanout2." +- trabalho: fanout2 + pool: + vmImage: 'ubuntu-latest' + dependsOn: inicial + etapas: + - script: echo "Este trabalho será executado após o trabalho inicial, em paralelo com fanout1." +- trabalho: fanin: + pool: + vmImage: 'ubuntu-latest' + dependsOn: [fanout1, fanout2] + etapas: + - script: echo "Este trabalho será executado após fanout1 e fanout2 serem concluídos." +``` +{% endraw %} + +{% raw %} +```yaml +trabalhos: + inicial: + runs-on: ubuntu-latest + etapas: + - executar: echo "Este trabalho será executado primeiro." + fanout1: + runs-on: ubuntu-latest + needs: inicial + etapas: + - run: echo "Este trabalho será executado após o trabalho inicial, em paralelo com fanout2." + fanout2: + runs-on: ubuntu-latest + needs: inicial + etapas: + - run: echo "Este trabalho será executado após o trabalho inicial, em paralelo com fanout1." + fanin: + runs-on: ubuntu-latest + needs: [fanout1, fanout2] + etapas: + - executar: echo "Este trabalho será executado após fanout1 e fanout2 serem concluídos." +``` +{% endraw %} +
    + +Para obter mais informações, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)". + +### Migrar tarefas para ações + +O Azure Pipelines usa as _tarefas_, que são componentes do aplicativo que podem ser reutilizados em vários fluxos de trabalho. O {% data variables.product.prodname_actions %} usa as _ações_, que podem ser usadas para realizar tarefas e personalizar seu fluxo de trabalho. Em ambos os sistemas, é possível especificar o nome da tarefa ou ação a executar, junto com quaisquer entradas necessárias como pares chave/valor. + +Abaixo, há um exemplo da sintaxe para cada sistema: + + + + + + + + + + +
    +Azure Pipelines + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +trabalhos: +- trabalho: run_python + pool: + vmImage: 'ubuntu-latest' + etapas: + - tarefa: UsePythonVersion@0 + entradas: + versionSpec: '3.7' + architecture: 'x64' + - script: python script.py +``` +{% endraw %} + +{% raw %} +```yaml +trabalhos: + run_python: + runs-on: ubuntu-latest + etapas: + - usa: actions/setup-python@v2 + com: + python-version: '3.7' + arquitetura: 'x64' + - executar: python script.py +``` +{% endraw %} +
    + +Você pode encontrar ações que podem ser usadas em seu fluxo de trabalho em [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=actions) ou você pode criar suas próprias ações. Para obter mais informações, consulte "[Criar ações](/actions/creating-actions)". + diff --git a/translations/pt-BR/content/actions/learn-github-actions/migrating-from-circleci-to-github-actions.md b/translations/pt-BR/content/actions/learn-github-actions/migrating-from-circleci-to-github-actions.md new file mode 100644 index 000000000000..bfd0cd507dc2 --- /dev/null +++ b/translations/pt-BR/content/actions/learn-github-actions/migrating-from-circleci-to-github-actions.md @@ -0,0 +1,447 @@ +--- +title: Migrar do CircleCI para o GitHub Actions +intro: 'O GitHub Actions e o CircleCI compartilham várias semelhanças em termos de configuração, o que torna a migração para o GitHub Actions relativamente fácil.' +redirect_from: + - /actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Introdução + +O CircleCI e {% data variables.product.prodname_actions %} permitem criar fluxos de trabalho que criam, testam, publicam, lançam e implementam código automaticamente. O CircleCI e o {% data variables.product.prodname_actions %} compartilham algumas semelhanças em termos de configuração do fluxo de trabalho: + +- Os arquivos de configuração do fluxo de trabalho são gravados no YAML e armazenados no repositório. +- Os fluxos de trabalho incluem um ou mais trabalhos. +- Os trabalhos incluem uma ou mais etapas ou comandos individuais. +- É possível reutilizar e compartilhar novamente etapas ou tarefas com a comunidade. + +Para obter mais informações, consulte "[Conceitos básicos para {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)". + +### Principais diferenças + +Ao fazer a migração do CircleCI, considere as seguintes diferenças: + +- O paralelismo do teste automático do CircleCI agrupa automaticamente os testes de acordo com regras especificadas pelo usuário ou com informações históricas de temporização. Esta funcionalidade não foi criada em {% data variables.product.prodname_actions %}. +- As ações que são executadas em contêineres Docker são sensíveis a problemas de permissões, uma vez que os contêineres têm um mapeamento diferente de usuários. Você pode evitar muitos desses problemas se não usar a instrução `USUÁRIO` no seu *arquivo Docker*. Para obter mais informações sobre o sistema de arquivos Docker, consulte "[Ambientes virtuais para executores hospedados em {% data variables.product.product_name %}](/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem)". + +### Migrar fluxos de trabalhos e trabalhos + +O CircleCI define os `fluxos de trabalho` no arquivo *config.yml*, o que permite configurar mais de um fluxo de trabalho. O {% data variables.product.product_name %} exige um arquivo de fluxo de trabalho por fluxo de trabalho e, consequentemente, não exige que você declare os `fluxos de trabalho`. Será necessário criar um novo arquivo de fluxo de trabalho para cada fluxo de trabalho configurado em *config.yml*. + +Tanto o CircleCI quanto o {% data variables.product.prodname_actions %} configuram `trabalhos` no arquivo de configuração usando uma sintaxe similar. Se você configurar qualquer dependência entre trabalhos usando `requires` em seu fluxo de trabalho CircleCI, você poderá usar a sintaxe equivalente {% data variables.product.prodname_actions %} `needs`. Para obter mais informações, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)". + +### Migrar orbes para ações + +Tanto o CircleCI quanto o {% data variables.product.prodname_actions %} fornecem um mecanismo para reutilizar e compartilhar tarefas em um fluxo de trabalho. O CircleCI usa um conceito chamado orbs, escrito em YAML, para fornecer tarefas que as pessoas podem reutilizar em um fluxo de trabalho. O {% data variables.product.prodname_actions %} tem componentes potentes, reutilizáveis e flexíveis denominados ações, que você cria com arquivos JavaScript ou imagens Docker. Você pode criar ações gravando códigos personalizados que interajam com o seu repositório da maneira que você quiser, inclusive fazendo integrações com as APIs do {% data variables.product.product_name %} e qualquer API de terceiros disponível publicamente. Por exemplo, as ações podem publicar módulos npm, enviar alertas SMS quando problemas urgentes forem criados ou implantar códigos prontos para produção. Para obter mais informações, consulte "[Criar ações](/actions/creating-actions)". + +O CircleCI pode reutilizar partes dos fluxos de trabalho com âncoras e aliases YAML. O {% data variables.product.prodname_actions %} suporta a necessidade mais comum de reutilização usando matrizes de criação. Para obter mais informações sobre matrizes de criação, consulte "[Gerenciar fluxos de trabalho complexos](/actions/learn-github-actions/managing-complex-workflows/#using-a-build-matrix)". + +### Usar imagens do Docker + + +Tanto o CircleCI quanto o {% data variables.product.prodname_actions %} suportam executar etapas dentro de uma imagem do Docker. + +O CircleCI fornece um conjunto de imagens pré-construídas com dependências comuns. Estas imagens têm o `USUÁRIO` definido como `circleci`, o que faz com que as permissões entrem em conflito com {% data variables.product.prodname_actions %}. + +Recomendamos que você se afaste das imagens pré-criadas do CircleCI, ao migrar para {% data variables.product.prodname_actions %}. Em muitos casos, você pode usar ações para instalar as dependências adicionais de que você precisa. + +Para obter mais informações sobre o sistema de arquivos Docker, consulte "[Ambientes virtuais para executores hospedados em {% data variables.product.product_name %}](/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem)". + +Para obter mais informações sobre as ferramentas e pacotes disponíveis em ambientes virtuais hospedados em {% data variables.product.prodname_dotcom %}, consulte "[Especificações para executores hospedados em {% data variables.product.prodname_dotcom %}](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". + +### Usar variáveis e segredos + +O CircleCI e o {% data variables.product.prodname_actions %} suportam configurações das variáveis de ambiente no arquivo de configuração e criação de segredos usando o CircleCI ou a interface de usuário do {% data variables.product.product_name %}. + +Para obter mais informações, consulte "[Usar variáveis de ambiente](/actions/configuring-and-managing-workflows/using-environment-variables)" e "[Criar e usar segredos encriptados](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)". + +### Armazenar em cache + +O CircleCI e o {% data variables.product.prodname_actions %} fornecem um método para armazenar arquivos de cache no arquivo de configuração manualmente. + +Abaixo, há um exemplo da sintaxe para cada sistema. + + + + + + + + + + +
    +CircleCI + +GitHub Actions +
    +{% raw %} +```yaml +- restore_cache: + keys: + - v1-npm-deps-{{ checksum "package-lock.json" }} + - v1-npm-deps- +``` +{% endraw %} + +{% raw %} +```yaml +- nome: Módulos do nó da cache + usa: actions/cache@v2 + com: + caminho: ~/.npm + key: v1-npm-deps-${{ hashFiles('**/package-lock.json') }} + restore-keys: v1-npm-deps- +``` +{% endraw %} +
    + +Para obter mais informações, consulte "[Memorizando dependências para acelerar fluxos de trabalho](/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows)". + +{% data variables.product.prodname_actions %} não tem o equivalente ao Docker Layer Caching (DLC) do CircleCI. + +### Dados persistentes entre trabalhos + +Tanto a CircleCI quanto a {% data variables.product.prodname_actions %} fornecem mecanismos para persistir dados entre trabalhos. + +Abaixo está um exemplo no CircleCI e na sintaxe de configuração do {% data variables.product.prodname_actions %}. + + + + + + + + + + +
    +CircleCI + +GitHub Actions +
    +{% raw %} +```yaml +- persist_to_workspace: + root: workspace + paths: + - math-homework.txt + +... + +- attach_workspace: + at: /tmp/workspace +``` +{% endraw %} + +{% raw %} +```yaml +- name: Upload math result for job 1 + uses: actions/upload-artifact@v2 + with: + name: homework + path: math-homework.txt + +... + +- name: Download math result for job 1 + uses: actions/download-artifact@v2 + with: + name: homework +``` +{% endraw %} +
    + +Para obter mais informações, consulte "[Dados persistentes do fluxo de trabalho que usam artefatos](/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts)". + +### Usar bancos de dados e contêineres de serviço + +Ambos os sistemas permitem que você inclua contêineres adicionais para bases de dados, memorização ou outras dependências. + +No CircleCI, a primeira imagem listada no *config.yaml* é a imagem principal usada para executar comandos. O {% data variables.product.prodname_actions %} usa seções explícitas: usa o`contêiner` para o contêiner primário e lista contêineres adicionais em `serviços`. + +Abaixo está um exemplo no CircleCI e na sintaxe de configuração do {% data variables.product.prodname_actions %}. + + + + + + + + + + +
    +CircleCI + +GitHub Actions +
    +{% raw %} +```yaml +--- +version: 2.1 + +trabalhos: + + ruby-26: + docker: + - image: circleci/ruby:2.6.3-node-browsers-legacy + ambiente: + PGHOST: localhost + PGUSER: administrate + RAILS_ENV: test + - imagem: postgres:10.1-alpine + ambiente: + POSTGRES_USER: administrate + POSTGRES_DB: ruby26 + POSTGRES_PASSWORD: "" + + working_directory: ~/administrate + + steps: + - checkout + + # Agrupar a instalação de dependências + - run: bundle install --path vendor/bundle + + # Aguardar DB + - executar: dockerize -wait tcp://localhost:5432 -timeout 1m + + # Configurar o ambiente + - run: cp .sample.env .env + + # Configurar o banco de dados + - run: bundle exec rake db:setup + + # Executar os testes + - run: bundle exec rake + + +fluxos de trabalho: + version: 2 + criar: + trabalhos: + - ruby-26 +... + +- attach_workspace: + at: /tmp/workspace +``` +{% endraw %} + +{% raw %} +```yaml +nome: Contêineres + +em: [push] + +trabalhos: + construir: + + runs-on: ubuntu-latest + contêiner: circleci/ruby:2.6.3-node-browsers-legacy + + env: + PGHOST: postgres + PGUSER: administrate + RAILS_ENV: test + + serviços: + postgres: + imagem: postgres:10.1-alpine + env: + POSTGRES_USER: administrate + POSTGRES_DB: ruby25 + POSTGRES_PASSWORD: "" + portas: + - 5432:5432 + # Adicionar uma verificação geral + opções: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5 + + etapas: + # Este arquivo Docker altera as configurações de USUÁRIO para circleci em vez de usar o usuário-padrão. Portanto, precisamos atualizar as permissões do arquivo para esta imagem funcionar no Actions. + # Veja https://docs.github.com/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem + - name: Configurar permissões do sistema de arquivos + run: sudo chmod -R 777 $GITHUB_WORKSPACE /github /__w/_temp + - uses: actions/checkout@v2 + - name: Instalar dependências + run: bundle install --path vendor/bundle + - name: Configuração do ambiente de instalação + run: cp .sample.env .env + - name: Configurar banco de dados + run: bundle exec rake db:setup + - name: Executar testes + run: bundle exec rake +``` +{% endraw %} +
    + +Para obter mais informações, consulte "[Sobre contêineres de serviço](/actions/configuring-and-managing-workflows/about-service-containers)". + +### Exemplo completo + +Abaixo, há um exemplo concreto. O lado esquerdo mostra o CircleCI *config.yml* atual para o repositório [thoughtbot/administrador](https://github.com/thoughtbot/administrate). O lado direito mostra o equivalente {% data variables.product.prodname_actions %}. + + + + + + + + + + +
    +CircleCI + +GitHub Actions +
    +{% raw %} +```yaml +--- +versão: 2.1 + +comandos: + shared_steps: + etapas: + - checkout + + # Restaurar dependências memorizadas + - restore_cache: + nome: Restore bundle cache + chave: administrate-{{ checksum "Gemfile.lock" }} + + # Agrupar instalação de dependências + - executar: bundle install --path vendor/bundle + + # Memorizar dependências + - save_cache: + nome: Armazenar agrupamento da cache + chave: administrate-{{ checksum "Gemfile.lock" }} + caminho: + - vendor/bundle + + # Aguardar DB + - executar: dockerize -wait tcp://localhost:5432 -timeout 1m + + # Configurar o ambiente + - executar: cp .sample.env .env + + # Configurar o ambiente + - executar: bundle exec rake db:setup + + # Executar os testes + - executar: bundle exec rake + +default_job: &default_job + working_directory: ~/administrate + etapas: + - shared_steps + # Executar os testes com múltiplas versões do Rails + - executar: bundle exec appraisal install + - executar: bundle exec appraisal rake + +trabalhos: + ruby-25: + <<: *default_job + docker: + - image: circleci/ruby:2.5.0-node-browsers + environment: + PGHOST: localhost + PGUSER: administrate + RAILS_ENV: test + - image: postgres:10.1-alpine + environment: + POSTGRES_USER: administrate + POSTGRES_DB: ruby25 + POSTGRES_PASSWORD: "" + + ruby-26: + <<: *default_job + docker: + - image: circleci/ruby:2.6.3-node-browsers-legacy + environment: + PGHOST: localhost + PGUSER: administrate + RAILS_ENV: test + - image: postgres:10.1-alpine + environment: + POSTGRES_USER: administrate + POSTGRES_DB: ruby26 + POSTGRES_PASSWORD: "" + + +fluxos de trabalho: + versão: 2 + multiple-rubies: + trabalhos: + - ruby-26 + - ruby-25 +``` +{% endraw %} + +{% raw %} +```yaml +nome: Contêineres + +em: [push] + +trabalhos: + criar: + + estratégia: + matriz: + ruby: [2.5, 2.6.3] + + runs-on: ubuntu-latest + + env: + PGHOST: localhost + PGUSER: administrate + RAILS_ENV: test + + serviços: + postgres: + imagem: postgres:10.1-alpine + env: + POSTGRES_USER: administrate + POSTGRES_DB: ruby25 + POSTGRES_PASSWORD: "" + portas: + - 5432:5432 + # Adicionar verificação geral + options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5 + + etapas: + - usa: actions/checkout@v2 + - nome: Configurar Ruby + usa: eregon/use-ruby-action@master + com: + ruby-version: ${{ matrix.ruby }} + - nome: Memorizar dependências + usa: actions/cache@v2 + com: + caminho: vendor/bundle + chave: administrate-${{ matrix.image }}-${{ hashFiles('Gemfile.lock') }} + - nome: Instalar títulos do postgres + executar : sudo apt-get install libpq-dev + - nome: Install dependencies + executar : bundle install --path vendor/bundle + - Nome: Definir configuração do ambiente + executar: cp .sample.env .env + - nome: Configurar banco de dados + executar: bundle exec rake db:setup + - nome: Executar testes + executar: bundle exec rake + - nome: Install appraisal + executar: bundle exec appraisal install + - Nome: Run appraisal + executar: bundle exec appraisal rake +``` +{% endraw %} +
    diff --git a/translations/pt-BR/content/actions/learn-github-actions/migrating-from-gitlab-cicd-to-github-actions.md b/translations/pt-BR/content/actions/learn-github-actions/migrating-from-gitlab-cicd-to-github-actions.md new file mode 100644 index 000000000000..2172d1ef1c2e --- /dev/null +++ b/translations/pt-BR/content/actions/learn-github-actions/migrating-from-gitlab-cicd-to-github-actions.md @@ -0,0 +1,476 @@ +--- +title: Fazer a migração do GitLab CI/CD para o GitHub Actions +intro: '{% data variables.product.prodname_actions %} e GitLab CI/CD compartilham várias semelhanças de configuração, o que faz com que a migração para {% data variables.product.prodname_actions %} seja relativamente simples.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Introdução + +O GitLab CI/CD e {% data variables.product.prodname_actions %} permitem criar fluxos de trabalho que criam, testam, publicam, lançam e implantam códigos automaticamente. O GitLab CI/CD e {% data variables.product.prodname_actions %} compartilham algumas semelhanças na configuração do fluxo de trabalho: + +- Os arquivos de configuração do fluxo de trabalho são gravados YAML e armazenados no repositório do código. +- Os fluxos de trabalho incluem um ou mais trabalhos. +- Os trabalhos incluem uma ou mais etapas ou comandos individuais. +- Os trabalhos podem ser executados em máquinas gerenciadas ou auto-hospedadas. + +Existem algumas diferenças e este guia irá mostrar a você as diferenças importantes para que você possa fazer a migração do seu fluxo de trabalho para {% data variables.product.prodname_actions %}. + +### Trabalhos + +Os trabalhos no GitLab CI/CD são muito semelhantes aos trabalhos em {% data variables.product.prodname_actions %}. Em ambos os sistemas, os trabalhos têm as características a seguir: + +* Os trabalhos contêm uma série de etapas ou scripts executados sequencialmente. +* Os trabalhos podem ser executados em máquinas separadas ou em contêineres separados. +* Por padrão, os trabalhos executados em paralelo, mas podem ser configuradas para serem executados em sequência. + +Você pode executar um script ou um comando de shell em um trabalho. No GitLab CI/CD, as etapas do script são especificadas usando a chave do `script`. Em {% data variables.product.prodname_actions %}, todos os scripts são especificados usando a chave `executar`. + +Abaixo, há um exemplo da sintaxe para cada sistema: + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +job1: + variables: + GIT_CHECKOUT: "true" + script: + - echo "Run your script here" +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + job1: + steps: + - uses: actions/checkout@v2 + - run: echo "Run your script here" +``` +{% endraw %} +
    + +### Executores + +Os executores são máquinas nas quais os trabalhos são executados. Tanto GitLab CI/CD quanto {% data variables.product.prodname_actions %} oferecem variantes de executores gerenciadas e auto-hospedadas. No GitLab CI/CD, as `tags` são usadas para executar trabalhos em diferentes plataformas, enquanto em {% data variables.product.prodname_actions %} é feito com a chave `runs-on`. + +Abaixo, há um exemplo da sintaxe para cada sistema: + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +windows_job: + tags: + - windows + script: + - echo Hello, %USERNAME%! + +linux_job: + tags: + - linux + script: + - echo "Hello, $USER!" +``` +{% endraw %} + +{% raw %} +```yaml +windows_job: + runs-on : windows-latest + steps: + - run: echo Hello, %USERNAME%! + +linux_job: + runs-on: ubuntu-latest + steps: + - run: echo "Hello, $USER!" +``` +{% endraw %} +
    + +Para obter mais informações, consulte "[Sintaxe do fluxo de trabalho para {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on)." + +### Imagens do Docker + +Tanto o GitLab CI/CD quanto o {% data variables.product.prodname_actions %} são compatíveis com trabalhos executados em uma imagem do Docker. No GitLab CI/CD, as imagens do Docker são definidas com uma chave de `imagem`, enquanto em {% data variables.product.prodname_actions %} isso é feito com a chave `contêiner`. + +Abaixo, há um exemplo da sintaxe para cada sistema: + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +my_job: + image: node:10.16-jessie +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + my_job: + container: node:10.16-jessie +``` +{% endraw %} +
    + +Para obter mais informações, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idcontainer)". + +### Condição e sintaxe de expressão + +O GitLab CI/CD usa as `regras` para determinar se um trabalho será executado para uma condição específica. {% data variables.product.prodname_actions %} usa a palavra-chave `se` para evitar que um trabalho seja executado a menos que uma condição seja atendida. + +Abaixo, há um exemplo da sintaxe para cada sistema: + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +deploy_prod: + stage: deploy + script: + - echo "Deply to production server" + rules: + - if: '$CI_COMMIT_BRANCH == "master"' +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + deploy_prod: + if: contains( github.ref, 'master') + runs-on: ubuntu-latest + steps: + - run: echo "Deply to production server" +``` +{% endraw %} +
    + +Para obter mais informações, consulte "[Contexto e sintaxe de expressão para {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)". + +### Dependências entre trabalhos + +Tanto o GitLab CI/CD quanto o {% data variables.product.prodname_actions %} permitem que você defina dependências para um trabalho. Em ambos os sistemas, os trabalhos executados em paralelo por padrão, mas dependências de trabalho em {% data variables.product.prodname_actions %} podem ser especificados explicitamente com a chave `needs`. O GitLab CI/CD também tem o conceito de `stages`, em que os trabalhos em um estágio são executados paralelamente, mas o próximo stage terá início depois de terminados todos os trabalho no stage anterior. Você pode recriar esse cenário em {% data variables.product.prodname_actions %} com a chave `needs`. + +Abaixo, há um exemplo da sintaxe para cada sistema. Os fluxos de trabalho iniciam com dois trabalhos denominados `build_a` e `build_b` sendo executados paralelamente e, após a conclusão desses trabalhos, será executado outro trabalho denominado `test_ab`. Por fim, quando `test_ab` é concluído, o trabalho `deploy_ab` será executado. + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +stages: + - build + - test + - deploy + +build_a: + stage: build + script: + - echo "This job will run first." + +build_b: + stage: build + script: + - echo "This job will run first, in parallel with build_a." + +test_ab: + stage: test + script: + - echo "This job will run after build_a and build_b have finished." + +deploy_ab: + stage: deploy + script: + - echo "This job will run after test_ab is complete" +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + build_a: + runs-on: ubuntu-latest + steps: + - run: echo "This job will be run first." + + build_b: + runs-on: ubuntu-latest + steps: + - run: echo "This job will be run first, in parallel with build_a" + + test_ab: + runs-on: ubuntu-latest + needs: [build_a,build_b] + steps: + - run: echo "This job will run after build_a and build_b have finished" + + deploy_ab: + runs-on: ubuntu-latest + needs: [test_ab] + steps: + - run: echo "This job will run after test_ab is complete" +``` +{% endraw %} +
    + +Para obter mais informações, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)". + +### Agendar fluxos de trabalho + +Tanto o GitLab CI/CD quanto o {% data variables.product.prodname_actions %} permitem que você execute fluxos de trabalho em um intervalo específico. No GitLab CI/CD, a programação de pipeline é configurada com a interface do usuário, enquanto em {% data variables.product.prodname_actions %} você pode acionar um fluxo de trabalho em um intervalo programado com a chave "ligado". + +Para obter mais informações, consulte "[Eventos que acionam fluxos de trabalho](/actions/reference/events-that-trigger-workflows#scheduled-events)". + +### Variáveis e segredos + +O GitLab CI/CD e {% data variables.product.prodname_actions %} são compatíveis com as variáveis de ambiente no pipeline u no arquivo de configuração do fluxo de trabalho e ao criar segredos usando o GitLab ou a interface de usuário de {% data variables.product.product_name %}. + +Para obter mais informações, consulte "[Variáveis de ambiente](/actions/reference/environment-variables)" e "[Segredos criptografados](/actions/reference/encrypted-secrets)". + +### Armazenar em cache + +GitLab CI/CD e {% data variables.product.prodname_actions %} fornecem um método no arquivo de configuração para armazenar os arquivos do fluxo de trabalho manualmente. + +Abaixo, há um exemplo da sintaxe para cada sistema: + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +image: node:latest + +cache: + key: $CI_COMMIT_REF_SLUG + paths: + - .npm/ + +before_script: + - npm ci --cache .npm --prefer-offline + +test_async: + script: + - node ./specs/start.js ./specs/async.spec.js +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + test_async: + - name: Cache node modules + uses: actions/cache@v2 + with: + path: ~/.npm + key: v1-npm-deps-${{ hashFiles('**/package-lock.json') }} + restore-keys: v1-npm-deps- +``` +{% endraw %} +
    + +Para obter mais informações, consulte "[Memorizar dependências para acelerar fluxos de trabalho](/actions/guides/caching-dependencies-to-speed-up-workflows)". + +### Artefatos + +Tanto o GitLab CI/CD quanto o {% data variables.product.prodname_actions %} podem fazer upload de arquivos e diretórios criados por um trabalho como artefatos. Em {% data variables.product.prodname_actions %}, os artefatos podem ser usados para persistir dados em vários trabalhos. + +Abaixo, há um exemplo da sintaxe para cada sistema: + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +script: +artifacts: + paths: + - math-homework.txt +``` +{% endraw %} + +{% raw %} +```yaml +- name: Upload math result for job 1 + uses: actions/upload-artifact@v2 + with: + name: homework + path: math-homework.txt +``` +{% endraw %} +
    + +Para obter mais informações, consulte "[Armazenar dados de fluxo de trabalho como artefatos](/actions/guides/storing-workflow-data-as-artifacts)". + +### Bancos de dados e contêineres de serviço + +Ambos os sistemas permitem que você inclua contêineres adicionais para bases de dados, memorização ou outras dependências. + +No GitLab CI/CD, um contêiner para o trabalho é especificado com a chave `imagem`, enquanto {% data variables.product.prodname_actions %} usa a chave `contêiner`. Nos dois sistemas, os contêineres de serviço adicionais são especificados com a chave serviços.

    + +

    Abaixo, há um exemplo da sintaxe para cada sistema:

    + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +container-job: + variables: + POSTGRES_PASSWORD: postgres + # The hostname used to communicate with the + # PostgreSQL service container + POSTGRES_HOST: postgres + # The default PostgreSQL port + POSTGRES_PORT: 5432 + image: node:10.18-jessie + services: + - postgres + script: + # Performs a clean installation of all dependencies + # in the `package.json` file + - npm ci + # Runs a script that creates a PostgreSQL client, + # populates the client with data, and retrieves data + - node client.js + tags: + - docker +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + container-job: + runs-on: ubuntu-latest + container: node:10.18-jessie + + services: + postgres: + image: postgres + env: + POSTGRES_PASSWORD: postgres + + steps: + - name: Check out repository code + uses: actions/checkout@v2 + + # Performs a clean installation of all dependencies + # in the `package.json` file + - name: Install dependencies + run: npm ci + + - name: Connect to PostgreSQL + # Runs a script that creates a PostgreSQL client, + # populates the client with data, and retrieves data + run: node client.js + env: + # The hostname used to communicate with the + # PostgreSQL service container + POSTGRES_HOST: postgres + # The default PostgreSQL port + POSTGRES_PORT: 5432 +``` +{% endraw %} +
    + +

    Para obter mais informações, consulte "Sobre contêineres de serviço."

    diff --git a/translations/pt-BR/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md b/translations/pt-BR/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md new file mode 100644 index 000000000000..1bf9327f9599 --- /dev/null +++ b/translations/pt-BR/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md @@ -0,0 +1,293 @@ +--- +title: Migrar do Jenkins para o GitHub Actions +intro: 'O {% data variables.product.prodname_actions %} e o Jenkins compartilham múltiplas semelhanças, o que torna a migração para {% data variables.product.prodname_actions %} relativamente simples.' +redirect_from: + - /actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Introdução + +O Jenkins e o {% data variables.product.prodname_actions %} permitem criar fluxos de trabalho que criam, testam, publicam, lançam e implementam código automaticamente. O Jenkins e o {% data variables.product.prodname_actions %} compartilham algumas semelhanças em termos de configuração do fluxo de trabalho: + +- O Jenkins cria fluxos de trabalho usando _Declarative Pipelines_, que são semelhantes aos arquivos do fluxo de trabalho {% data variables.product.prodname_actions %}. +- O Jenkins usa _stages_ para executar uma coleção de etapas, enquanto o {% data variables.product.prodname_actions %} usa trabalhos para agrupar uma ou mais etapas ou comandos individuais. +- O Jenkins e o {% data variables.product.prodname_actions %} são compatíveis com criações baseadas em contêineres. Para obter mais informações, consulte "[Criar uma ação de contêiner do Docker](/articles/creating-a-docker-container-action)". +- É possível reutilizar e compartilhar novamente etapas ou tarefas com a comunidade. + +Para obter mais informações, consulte "[Conceitos básicos para {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)". + +### Principais diferenças + +- O Jenkins tem dois tipos de sintaxe para a criação de pipelines: Declarative Pipeline e Scripted Pipeline. O {% data variables.product.prodname_actions %} usa o YAML para criar fluxos de trabalho e arquivos de configuração. Para obter mais informações, consulte "[Sintaxe do fluxo de trabalho para o GitHub Actions](/actions/reference/workflow-syntax-for-github-actions)". +- As implementações do Jenkins são tipicamente auto-hospedadas, com usuários mantendo os servidores em seus próprios centros de dados. O {% data variables.product.prodname_actions %} oferece uma abordagem de nuvem híbrida, hospedando seus próprios executores que você pode usar para executar trabalhos, ao mesmo tempo em que também oferece suporte aos executores auto-hospedados. Para obter mais informações, consulte [Sobre os executores auto-hospedados](/actions/hosting-your-own-runners/about-self-hosted-runners). + +### Comparar recursos + +#### Distribuir suas criações + +O Jenkins permite que se envie criações para um único agente de criação, ou você pode distribuí-las entre vários agentes. Você também pode classificar esses agentes de acordo com vários atributos, como, por exemplo, tipos de sistema operacional. + +De modo similar, o {% data variables.product.prodname_actions %} pode enviar trabalhos para executores hospedados em {% data variables.product.prodname_dotcom %} ou executores auto-hospedados, e você pode usar as etiquetas para classificar os executores de acordo com vários atributos. A tabela a seguir compara como o conceito de criação distribuída é implementado tanto para o Jenkins e quanto para o {% data variables.product.prodname_actions %}. + +| Jenkins | {% data variables.product.prodname_actions %} +| ----------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`agentes`](https://wiki.jenkins.io/display/JENKINS/Distributed+builds) | [`executores`](/actions/learn-github-actions/introduction-to-github-actions#runners)
    [`executores auto-hospedados`](/actions/hosting-your-own-runners/about-self-hosted-runners) | + +#### Usar seções para organizar pipelines + +O Jenkins divide seus Declarative Pipelines em múltiplas seções. De forma similar, o {% data variables.product.prodname_actions %} organiza seus fluxos de trabalho em seções separadas. A tabela abaixo compara as seções do Jenkins com o fluxo de trabalho {% data variables.product.prodname_actions %}. + +| Diretivas do Jenkins | {% data variables.product.prodname_actions %} +| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| [`agente`](https://jenkins.io/doc/book/pipeline/syntax/#agent) | [`jobs..runs-on`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idruns-on)
    [`jobs..container`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idcontainer) | +| [`post`](https://jenkins.io/doc/book/pipeline/syntax/#post) | | +| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#stages) | [`jobs`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobs) | +| [`steps`](https://jenkins.io/doc/book/pipeline/syntax/#steps) | [`jobs..steps`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idsteps) | + + +### Usar diretivas + +O Jenkins usa diretivas para gerenciar os _Declarative Pipelines_. Essas diretivas definem as características do seu fluxo de trabalho e como ele será executado. A tabela abaixo demonstra como estas diretivas são mapeadas com conceitos dentro do {% data variables.product.prodname_actions %}. + +| Diretivas do Jenkins | {% data variables.product.prodname_actions %} +| ---------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`ambiente`](https://jenkins.io/doc/book/pipeline/syntax/#environment) | [`jobs..env`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env)
    [`jobs..steps.env`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv) | +| [`options`](https://jenkins.io/doc/book/pipeline/syntax/#parameters) | [`jobs..strategy`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategy)
    [`jobs..strategy.fail-fast`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategyfail-fast)
    [`jobs..timeout-minutes`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idtimeout-minutes) | +| [`parâmetros`](https://jenkins.io/doc/book/pipeline/syntax/#parameters) | [`entradas`](/actions/creating-actions/metadata-syntax-for-github-actions#inputs)
    [`saídas`](/actions/creating-actions/metadata-syntax-for-github-actions#outputs) | +| [`gatilhos`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`em`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#on)
    [`on..types`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onevent_nametypes)
    [on..](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)
    [on..paths](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpushpull_requestpaths) | +| [`aciona { upstreamprojects() }`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`jobs..needs`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idneeds) | +| [Sintaxe cron do Jenkins](https://jenkins.io/doc/book/pipeline/syntax/#cron-syntax) | [`on.schedule`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onschedule) | +| [`stage`](https://jenkins.io/doc/book/pipeline/syntax/#stage) | [`jobs.`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_id)
    [`jobs..name`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idname) | +| [`tools`](https://jenkins.io/doc/book/pipeline/syntax/#tools) | [Especificações para executores hospedados em {% data variables.product.prodname_dotcom %}](/actions/reference/specifications-for-github-hosted-runners/#supported-software) | +| [`entrada`](https://jenkins.io/doc/book/pipeline/syntax/#input) | [`inputs`](/actions/automating-your-workflow-with-github-actions/metadata-syntax-for-github-actions#inputs) | +| [`quando`](https://jenkins.io/doc/book/pipeline/syntax/#when) | [`jobs..if`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idif) | + + +### Usar estágios sequenciais + +#### Processamento paralelo do trabalho + +O Jenkins pode executar os `stages` e as `etapas` em paralelo, enquanto o {% data variables.product.prodname_actions %} está executando os trabalhos em paralelo. + +| Jenkins em paralelo | {% data variables.product.prodname_actions %} +| ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`paralelo`](https://jenkins.io/doc/book/pipeline/syntax/#parallel) | [`jobs..strategy.max-parallel`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymax-parallel) | + +#### Criar matriz + +Tanto o {% data variables.product.prodname_actions %} quanto o Jenkins permitem que você use uma matriz de criação para definir várias combinações de sistema. + +| Jenkins | {% data variables.product.prodname_actions %} +| ---------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`eixo`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-axes) | [`estratégia/matriz`](/actions/learn-github-actions/managing-complex-workflows/#using-a-build-matrix)
    [`contexto`](/actions/reference/context-and-expression-syntax-for-github-actions) | +| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages) | [`steps-context`](/actions/reference/context-and-expression-syntax-for-github-actions#steps-context) | +| [`exclui`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages) | | + +#### Usar passos para executar tarefas + +O Jenkins agrupa as `etapas` em `stages`. Cada uma dessas etapas pode ser um script, função ou comando, entre outros. Da mesma forma, o {% data variables.product.prodname_actions %} usa `trabalhos` para executar grupos específicos de `etapas`. + +| Etapas do Jenkins | {% data variables.product.prodname_actions %} +| --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | +| [`script`](https://jenkins.io/doc/book/pipeline/syntax/#script) | [`jobs..steps`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idsteps) | + +### Exemplos de tarefas comuns + +#### Agendar um pipeline para ser executado com `cron` + + + + + + + + + + +
    +Pipeline do Jenkins + +Fluxo de trabalho do {% data variables.product.prodname_actions %} +
    + + ```yaml + pipeline { + agent any + triggers { + cron('H/15 * * * 1-5') + } + } + ``` + + + + ```yaml + on: + schedule: + - cron: '*/15 * * * 1-5' + ``` + +
    + +#### Configurar variáveis de ambiente em um pipeline + + + + + + + + + + +
    +Pipeline do Jenkins + +Fluxo de trabalho do {% data variables.product.prodname_actions %} +
    + + ```yaml + pipeline { + agent any + environment { + MAVEN_PATH = '/usr/local/maven' + } + } + ``` + + + + ```yaml + jobs: + maven-build: + env: + MAVEN_PATH: '/usr/local/maven' + + ``` + +
    + +#### Criar projetos projetos de upstream + + + + + + + + + + +
    +Pipeline do Jenkins + +Fluxo de trabalho do {% data variables.product.prodname_actions %} +
    + + ```yaml + pipeline { + triggers { + upstream( + upstreamProjects: 'job1,job2', + threshold: hudson.model.Result.SUCCESS) + } + } + } + + ``` + + + + ```yaml + jobs: + job1: + job2: + needs: job1 + job3: + needs: [job1, job2] + + ``` + +
    + +#### Criar com vários sistemas operacionais + + + + + + + + + + +
    +Pipeline do Jenkins + +Fluxo de trabalho do {% data variables.product.prodname_actions %} +
    + + ```yaml +pipeline { + agent none + stages { + stage('Run Tests') { + parallel { + stage('Test On MacOS') { + agent { label "macos" } + tools { nodejs "node-12" } + steps { + dir("scripts/myapp") { + sh(script: "npm install -g bats") + sh(script: "bats tests") + } + } + } + stage('Test On Linux') { + agent { label "linux" } + tools { nodejs "node-12" } + steps { + dir("script/myapp") { + sh(script: "npm install -g bats") + sh(script: "bats tests") + } + } + } + } + } + } +} + ``` + + + +{% raw %} + ```yaml + nome: demo-workflow + em: + push: + trabalhos: + teste: + runs-on: ${{ matrix.os }} + estratégia: + fail-fast: false + matriz: + os: [macos-latest, ubuntu-latest] + etapas: + - usa: actions/checkout@v1 + - usa: actions/setup-node@v1 + com: + node-version: 12 + - executar: npm install -g bats + - executar: bats tests + working-directory: scripts/myapp + ``` +{% endraw %} + +
    diff --git a/translations/pt-BR/content/actions/learn-github-actions/security-hardening-for-github-actions.md b/translations/pt-BR/content/actions/learn-github-actions/security-hardening-for-github-actions.md new file mode 100644 index 000000000000..057658578bd2 --- /dev/null +++ b/translations/pt-BR/content/actions/learn-github-actions/security-hardening-for-github-actions.md @@ -0,0 +1,97 @@ +--- +title: Fortalecimento de segurança para o GitHub Actions +shortTitle: Fortalecimento de segurança +intro: 'Boas práticas de segurança para usar recursos do {% data variables.product.prodname_actions %}.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /actions/getting-started-with-github-actions/security-hardening-for-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Visão Geral + +Este guia explica como configurar o fortalecimento de segurança para certos recursos de {% data variables.product.prodname_actions %}. Se os conceitos do {% data variables.product.prodname_actions %} forem desconhecidos, consulte "[Principais conceitos para o GitHub Actions](/actions/getting-started-with-github-actions/core-concepts-for-github-actions) + +### Usar segredos + +Valores sensíveis nunca devem ser armazenados como texto simples em arquivos de fluxo de trabalho, mas como segredos. [Os segredos](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets) podem ser configurados no nível da organização ou do repositório e permitem que você armazene informações confidenciais em {% data variables.product.product_name %}. + +Os segredos usam [caixas fechadas de Libsodium](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes) de modo que sejam criptografadas antes de atingir {% data variables.product.product_name %}. Isso ocorre quando o segredo é enviado [usando a interface de usuário](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets#creating-encrypted-secrets-for-a-repository) ou através da [API REST](/rest/reference/actions#secrets). Esta criptografia do lado do cliente ajuda a minimizar os riscos relacionados ao registro acidental (por exemplo, registros de exceções e de solicitação, entre outros) dentro da infraestrutura do {% data variables.product.product_name %}. Uma vez realizado o upload do segredo, o {% data variables.product.product_name %} poderá descriptografá-lo para que possa ser injetado no tempo de execução do fluxo de trabalho. + +Para ajudar a prevenir a divulgação acidental, o {% data variables.product.product_name %} usa um mecanismo que tenta redigir quaisquer segredos que aparecem nos registros de execução. Esta redação procura correspondências exatas de quaisquer segredos configurados, bem como codificações comuns dos valores, como Base64. No entanto, como há várias maneiras de transformar o valor de um segredo, essa anulação não é garantida. Como resultado, existem certas etapas proativas e boas práticas que você deve seguir para ajudar a garantir que os segredos sejam editados, e para limitar outros riscos associados aos segredos: + +- **Nunca usar dados estruturados como um segredo** + - Os dados não estruturados podem fazer com que ocorra uma falha na redação secreta nos registros, porque a redação depende, em grande parte, de encontrar uma correspondência exata para o valor específico do segredo. Por exemplo, não use um blob de JSON, XML, ou YAML (ou similar) para encapsular o valor de um segredo, já que isso reduz significativamente a probabilidade de os segredos serem devidamente redigidos. Em vez disso, crie segredos individuais para cada valor sensível. +- **Registre todos os segredos usados nos fluxos de trabalho** + - Se um segredo for usado para gerar outro valor sensível dentro de um fluxo de trabalho, esse valor gerado deve ser formalmente [registrado como um segredo](https://github.com/actions/toolkit/tree/main/packages/core#setting-a-secret) para que seja reproduzido se alguma vez aparecer nos registros. Por exemplo, se, ao usar uma chave privada para gerar um JWT assinado para acessar uma API web, certifique-se de registrar que JWT é um segredo ou não será redigido se entrar na saída de do registro. + - O registro de segredos também aplica-se a qualquer tipo de transformação/codificação. Se seu segredo foi transformado de alguma forma (como Base64 ou URL codificada), certifique-se de registrar o novo valor como um segredo também. +- **Audite como segredos são tratados** + - Audite como os segredos são usados, para ajudar a garantir que estejam sendo tratados conforme o esperado. Você pode fazer isso revisando o código-fonte do repositório que executa o fluxo de trabalho e verificando quaisquer ações usadas no fluxo de trabalho. Por exemplo, verifique se eles não são enviados para hosts não pretendidos, ou impressos explicitamente na saída de um registro. + - Visualize os registros de execução do seu fluxo de trabalho depois de testar entradas válidas/inválidas e, em seguida, verifique se os segredos estão sendo editados corretamente ou não são mostrados. Nem sempre é sempre óbvio como um comando ou ferramenta que você está invocando irá enviar erros para `STDOUT` e `STDERR`, e os segredos podem depois acabar em registros de erro. Como resultado, considera-se uma boa prática rever manualmente os registros do fluxo de trabalho depois de testar entradas válidas e inválidas. +- **Use as credenciais que tenham escopos mínimos** + - Certifique-se de que as credenciais usadas nos fluxos de trabalho têm o menor privilégio necessário e esteja ciente de que qualquer usuário com acesso de gravação ao repositório terá acesso de leitura a todos os segredos configurados no seu repositório. +- **Audite e gire os segredos registrados** + - Reveja, periodicamente, os segredos registrados para confirmar se ainda são necessários. Remova aqueles que não são mais necessários. + - Gire os segredos periodicamente para reduzir a janela de tempo durante a qual um segredo comprometido é válido. + +### Usando ações de terceiros + +Os trabalhos individuais em fluxo de trabalho podem interagir com (e comprometer) outros trabalhos. Por exemplo, um trabalho que consulta as variáveis de ambiente usadas por um trabalho posterior, que escreve arquivos para um diretório compartilhado que um trabalho posterior processa, ou ainda mais diretamente, que interage com o conector do Docker e inspeciona outros contêineres em execução e executa comandos neles. + +Isso significa que comprometer uma única ação dentro de um fluxo de trabalho pode ser muito significativo, uma vez que essa ação comprometida teria acesso a todos os segredos configurados no seu repositório e pode usar o `GITHUB_TOKEN` para gravar no repositório. Consequentemente, há um risco significativo em fornecer de ações de repositórios de terceiros no {% data variables.product.prodname_dotcom %}. Você pode ajudar a mitigar esse risco seguindo estas boas práticas: + +* **Fixe as ações para um commit SHA de comprimento completo** + + Fixar uma ação para um commit SHA de comprimento completo é, atualmente, a única maneira de usar uma ação como uma versão imutável. Fixar um SHA em particular ajuda a mitigar o risco de um ator malicioso adicionar uma porta traseira ao repositório da ação, porque precisariam gerar uma colisão de SHA-1 para uma carga válida do objeto de Git. + + {% warning %} + + **Aviso:** A versão curta do commit SHA é insegura e nunca deve ser usada para especificar a referência do Git de uma ação. Devido ao modo como funcionam as redes de repositório, qualquer usuário pode bifurcar o repositório e fazer push de um commit criado que colida com o SHA curto. Isso faz com que os clones subsequentes falhem nesse SHA, pois se converte em um commit ambíguo. Como resultado, todos os fluxos de trabalho que usam o SHA encurtado falharão imediatamente. + + {% endwarning %} +* **Audite o código-fonte da ação** + + Certifique-se de que a ação está tratando o conteúdo do seu repositório e os segredos, como esperado. Por exemplo, verifique se os segredos não são enviados para os hosts não intencionais, ou se não são registrados inadvertidamente. + +* **Fixe ações em uma etiqueta apenas se confiar no criador** + + Embora a fixação de um commit de SHA seja a opção mais segura, especificar uma etiqueta é a opção mais conveniente, além de ser amplamente usada. Se você desejar de especificar uma etiqueta, certifique-se de que você confia nos criadores da ação. O selo "Criador verificado" em {% data variables.product.prodname_marketplace %} é um sinal útil, já que indica que a ação foi escrita por uma equipe cuja identidade foi verificada por {% data variables.product.prodname_dotcom %}. Observe que há risco para esta abordagem, mesmo que você confie no autor, porque uma etiqueta pode ser movida ou excluída se um ator malicioso obtiver acesso ao repositório que armazena a ação. + +### Considerar acesso entre repositórios + +O {% data variables.product.product_name %} tem um escopo intencional para um único repositório por vez. O `GITHUB_TOKEN` usado no ambiente de fluxo de trabalho concede o mesmo nível de acesso que um usuário com acesso de gravação, porque qualquer usuário com acesso de gravação pode acessar esse token criando ou modificando arquivos de fluxo de trabalho. Os usuários têm permissões específicas para cada repositório. Portanto, fazer com que o `GITHUB_TOKEN` para um repositório conceda acesso a outro impactaria o modelo de permissão {% data variables.product.prodname_dotcom %} se não for implementado cuidadosamente. Da mesma forma, deve-se ter cuidado ao adicionar tokens de autenticação do {% data variables.product.prodname_dotcom %} ao ambiente do fluxo de trabalho, porque isto também pode afetar o modelo de permissão de {% data variables.product.prodname_dotcom %} concedendo, inadvertidamente, amplo acesso aos colaboradores. + +Temos [ um plano no roteiro de {% data variables.product.prodname_dotcom %}](https://github.com/github/roadmap/issues/74) para suportar um fluxo que permite o acesso de todos os repositórios em {% data variables.product.product_name %}, embora ainda não seja um recurso compatível. Atualmente, a única maneira de executar interações privilegiadas entre repositórios é colocar um token de autenticação do {% data variables.product.prodname_dotcom %} ou chave SSH como um segredo dentro do ambiente de fluxo de trabalho. Uma vez que muitos tipos de token de autenticação não permitem acesso granular a recursos específicos, há um risco significativo no uso do tipo incorreto de token, pois ele pode conceder acesso muito mais amplo do que o pretendido. + +Esta lista descreve as abordagens recomendadas para acessar os dados do repositório dentro de um fluxo de trabalho, em ordem decrescente de preferência: + +1. **O `GITHUB_TOKEN` no ambiente de fluxo de trabalho** + - Este token tem um escopo intencional para o único repositório que invocou o fluxo de trabalho, e tem o mesmo nível de acesso que um usuário de acesso de gravação no repositório. O token é criado antes de cada trabalho começar e expira quando o trabalho é finalizado. Para obter mais informações, consulte "[Autenticação com o GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)". + - O `GITHUB_TOKEN` deve ser usado sempre que possível. +2. **Chave de implantação do repositório** + - Chaves de implantação são um dos únicos tipos de credenciais que concedem acesso de leitura ou gravação a um único repositório, e podem ser usadas para interagir com outro repositório dentro de um fluxo de trabalho. Para obter mais informações, consulte "[Gerenciar chaves de implantação](/developers/overview/managing-deploy-keys#deploy-keys)". + - Observe que as chaves de implantação só podem clonar e fazer push para o repositório usando o Git, e não podem ser usada para interagir com a API REST ou o GraphQL. Portanto, elas podem não ser apropriadas para os suas necessidades. +3. **Tokens de {% data variables.product.prodname_github_app %}** + - {% data variables.product.prodname_github_apps %} podem ser instalados em repositórios selecionados e até mesmo ter permissões granulares nos recursos dentro deles. É possível criar um {% data variables.product.prodname_github_app %} interno na sua organização, instalá-lo nos repositórios os quais você precisa acessar dentro do seu fluxo de trabalho, e autenticar como instalação dentro de seu fluxo de trabalho para acessar esses repositórios. +4. **Tokens de acesso pessoal** + - Você nunca deve usar tokens de acesso pessoais da sua própria conta. Esses tokens concedem acesso a todos os repositórios nas organizações às quais você tem acesso, bem como a todos os repositórios pessoais na sua conta de usuário. Isto concede indiretamente amplo acesso a todos os usuários com acesso de gravação do repositório no qual se encontra o fluxo de trabalho. Além disso, se você deixar uma organização mais adiante, os fluxos de trabalho que usam este token falharão imediatamente e a depuração deste problema pode ser difícil. + - Se um token de acesso pessoal for usado, ele deverá ser gerado para uma nova conta que só tenha acesso aos repositórios específicos necessários para o fluxo de trabalho. Observe que esta abordagem não é escalável e deve ser evitada em detrimento de alternativas, como as chaves de implantação. +5. **Chaves SSH em uma conta de usuário** + - Os fluxos de trabalho nunca devem usar as chaves SSH em uma conta de usuário. Semelhante aos tokens de acesso pessoais, eles concedem permissões de leitura/gravação a todos os seus repositórios pessoais, bem como a todos os repositórios aos quais você tem acesso por meio da associação à organização. Isto concede indiretamente amplo acesso a todos os usuários com acesso de gravação do repositório no qual se encontra o fluxo de trabalho. Se você pretende usar uma chave SSH porque você só precisa executar clones ou push do repositório, e não precisar interagir com APIs públicas, você deverá usar chaves de implantação individuais. + +### Fortalecimento para executores auto-hospedados + +Os executores ** hospedados em {% data variables.product.prodname_dotcom %}** executam o código dentro de máquinas virtuais efêmeras e limpas e isoladas. Isso quer isto dizer que não há maneira de comprometer persistentemente este ambiente ou obter, de outra forma, acesso a mais informações do que foram colocadas neste ambiente durante o processo de inicialização. + +Executores **auto-hospedados** em {% data variables.product.product_name %} não têm garantias com relação ao funcionamento em máquinas virtuais limpas efêmeras e podem ser persistentemente comprometidos por código não confiável em um fluxo de trabalho. + +Como resultado, os executores auto-hospedados quase [nunca devem ser usados para repositórios públicos](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories) em {% data variables.product.product_name %}, porque qualquer usuário pode abrir pull requests contra o repositório e comprometer o ambiente. Da mesma forma, tenha cuidado ao usar executores auto-hospedados em repositórios privados, uma vez que qualquer pessoa que possa bifurcar o repositório e abrir um PR (geralmente aqueles com acesso de leitura ao repositório) são capazes de comprometer o ambiente de executores auto-hospedados, incluindo a obtenção de acesso a segredos e `GITHUB_TOKEN` mais privilegiado, que concede permissões de gravação no repositório. + +Você também deve considerar o ambiente das máquinas de executores auto-hospedadas: +- Que informação sensível reside na máquina configurada como um executor auto-hospedado? Por exemplo, chaves SSH privadas, tokens de acesso à API, entre outros. +- A máquina tem acesso à rede a serviços sensíveis? Por exemplo, serviços de metadados do Azure ou AWS. A quantidade de informações confidenciais neste ambiente deve ser limitada ao mínimo, e você deve estar sempre ciente de que qualquer usuário capaz de invocar fluxos de trabalho terá acesso a esse ambiente. diff --git a/translations/pt-BR/content/actions/learn-github-actions/sharing-workflows-with-your-organization.md b/translations/pt-BR/content/actions/learn-github-actions/sharing-workflows-with-your-organization.md new file mode 100644 index 000000000000..4829ced3cea7 --- /dev/null +++ b/translations/pt-BR/content/actions/learn-github-actions/sharing-workflows-with-your-organization.md @@ -0,0 +1,114 @@ +--- +title: Compartilhar fluxos de trabalho com a sua organização +shortTitle: Compartilhar fluxos de trabalho com a sua organização +intro: 'Aprenda como usar recursos da organização para colaborar com a sua equipe, compartilhando modelos de fluxo de trabalho, segredos e executores auto-hospedados.' +redirect_from: + - /actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Visão Geral + +Se você precisar compartilhar fluxos de trabalho e outros recursos de {% data variables.product.prodname_actions %} com a sua equipe, considere colaborar dentro de uma organização de {% data variables.product.prodname_dotcom %}. Uma organização permite que você armazene e gerencie centralmente segredos, artefatos e executores auto-hospedados. Você também pode criar modelos de fluxo de trabalho no repositório `.github` e compartilhá-los com outros usuários na sua organização. + +### Criar um modelo do fluxo de trabalho + +Os modelos do fluxo de trabalh podem ser criados por usuários com acesso de gravação ao repositório `.github` da organização. Em seguida, os modelos podem ser usados por integrantes da organização com permissão para criar fluxos de trabalho. Os modelos do fluxo de trabalho podem ser usados para criar novos fluxos de trabalho nos repositórios públicos de uma organização; para usar modelos para criar fluxos de trabalho em repositórios privados, a organização deve fazer parte de um plano corporativo ou do GitHub One. + +Este procedimento demonstra como criar um modelo de fluxo de trabalho e um arquivo de metadados. O arquivo de metadados descreve como o modelo é apresentado aos usuários quando estão criando um novo fluxo de trabalho. + +1. Se já não existir, crie um novo repositório público denominado `.github` na sua organização. +1. Crie um diretório denominado `workflow-templates`. +1. Crie seu novo arquivo de fluxo de trabalho dentro do diretório `workflow-templates`. + + Se você precisar referir-se ao branch-padrão de um repositório, você poderá usar o espaço reservado `branch$default`. Quando um fluxo de trabalho é criado usando seu modelo, o espaço reservado será automaticamente substituído pelo nome do branch-padrão do repositório. + + Por exemplo, este arquivo denominado `octo-organization-ci.yml` demonstra um fluxo de trabalho básico. + + ```yaml + name: Octo Organization CI + + on: + push: + branches: [ $default-branch ] + pull_request: + branches: [ $default-branch ] + + jobs: + build: + runs-on: ubuntu-latest + + steps: + - uses: actions/checkout@v2 + + - name: Run a one-line script + run: echo Hello from Octo Organization + ``` +1. Crie um arquivo de metadados dentro do diretório `workflow-templates`. O arquivo de metadados deve ter o mesmo nome do arquivo de fluxo de trabalho, mas em vez da extensão `.yml`, deve-se adicionar `.properties.json`. Por exemplo, este arquivo denominado `octo-organization-ci.properties.json` contém os metadados para um arquivo de fluxo de trabalho denominado `octo-organization-ci.yml`: + ```yaml + { + "name": "Octo Organization Workflow", + "description": "Octo Organization CI workflow template.", + "iconName": "example-icon", + "categories": [ + "Go" + ], + "filePatterns": [ + "package.json$", + "^Dockerfile", + ".*\\.md$" + ] + } + ``` + * `nome` - **Obrigatório.** O nome do modelo de fluxo de trabalho. Isto é exibido na lista de modelos disponíveis. + * `descrição` - **Obrigatória.** A descrição do modelo de fluxo de trabalho. Isto é exibido na lista de modelos disponíveis. + * `iconName` - **Obrigatório.** Define um ícone para a entrada do fluxo de trabalho na lista de modelos. O `iconName` deve ser um ícone SVG com o mesmo nome e deve ser armazenado no diretório `workflow-templates`. Por exemplo, um arquivo SVG denominado `exemplo-icon.svg` é referenciado como `example-icon`. + * `categorias` - **Opcional.** Define a categoria de idioma do fluxo de trabalho. Quando um usuário visualiza os modelos disponíveis, esses modelos que correspondem àao mesmo idioma terão mais destaque. Para obter informações sobre as categorias de idioma disponíveis, consulte https://github.com/github/linguist/blob/master/lib/linguist/languages.yml. + * `filePatterns` - **Opcional.** Permite que o modelo seja usado se o repositório do usuário tiver um arquivo no diretório-raiz que corresponde a uma expressão regular definida. + +Para adicionar outro modelo de fluxo de trabalho, adicione seus arquivos ao mesmo diretório `workflow-templates`. Por exemplo: + +![Arquivos do modelo do fluxo de trabalho](/assets/images/help/images/workflow-template-files.png) + +### Usar um modelo do fluxo de trabalho + +Este procedimento demonstra como um membro da sua organização pode localizar e usar um modelo de fluxo de trabalho para criar um novo fluxo de trabalho. Os modelos de fluxo de trabalho de uma organização podem ser usados por qualquer pessoa que seja integrante da organização. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. Caso o seu repositório tenha fluxos de trabalho existentes: No canto superior esquerdo, clique em **Novo fluxo de trabalho**. ![Criar um novo fluxo de trabalho](/assets/images/help/repository/actions-new-workflow.png) +1. Os modelos de fluxo de trabalho da sua organização estão localizados em sua própria seção intitulada "Fluxos de trabalho criados pelo _nome da organização_". Sob, nome do template que você gostaria de usar, clique em **Configurar este fluxo de trabalho**. ![Configurar este fluxo de trabalho](/assets/images/help/settings/actions-create-starter-workflow.png) + + +### Compartilhar segredos dentro de uma organização + +Você pode gerenciar seus segredos centralmente dentro de uma organização e, em seguida, disponibilizá-los para repositórios selecionados. Isso também significa que você pode atualizar um segredo em um único local e fazer com que a alteração seja aplicada em todos os fluxos de trabalho do repositório que usam o segredo. + +Ao criar um segredo em uma organização, você pode usar uma política para limitar quais repositórios podem acessar esse segredo. Por exemplo, você pode conceder acesso a todos os repositórios ou limitar o acesso a apenas repositórios privados ou a uma lista específica de repositórios. + +{% data reusables.github-actions.permissions-statement-secrets-organization %} + +{% data reusables.organizations.navigate-to-org %} +{% data reusables.organizations.org_settings %} +{% data reusables.github-actions.sidebar-secret %} +1. Clique em **Novo segredo**. +1. Digite um nome para o seu segredo na caixa de entrada **Nome**. +1. Insira o **Valor** para o seu segredo. +1. Na lista suspensa **Acesso do repositório**, escolha uma política de acesso. +1. Clique em **Add secret** (Adicionar segredo). + +### Compartilhe executores auto-hospedados dentro de uma organização + +Os administradores da organização podem adicionar seus executores auto-hospedados para grupos e, em seguida, criar políticas que controlam quais repositórios podem acessar o grupo. + +Para obter mais informações, consulte "[Gerenciando acesso a runners auto-hospedados usando grupos](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups)". + + +### Próximas etapas + +Para continuar aprendendo mais sobre {% data variables.product.prodname_actions %}, consulte "[Aumento da segurança para {% data variables.product.prodname_actions %}](/actions/learn-github-actions/security-hardening-for-github-actions). diff --git a/translations/pt-BR/content/actions/managing-workflow-runs/adding-a-workflow-status-badge.md b/translations/pt-BR/content/actions/managing-workflow-runs/adding-a-workflow-status-badge.md new file mode 100644 index 000000000000..64447b964c64 --- /dev/null +++ b/translations/pt-BR/content/actions/managing-workflow-runs/adding-a-workflow-status-badge.md @@ -0,0 +1,63 @@ +--- +title: Adicionar um selo de status de fluxo de trabalho +intro: Você pode exibir um selo de status no seu repositório para indicar o status dos seus fluxos de trabalho. +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% data reusables.repositories.actions-workflow-status-badge-into %} + +Se o seu fluxo de trabalho usar o nome `` palavra-chave, você deve fazer referência ao fluxo de trabalho pelo nome. Se o nome do seu fluxo de trabalho contiver espaço branco, você precisará substituir o espaço pela sequência codificada por URL `%20`. Para obter mais informações sobre a palavra-chave `name`, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#name)". + +``` +https://github.com///fluxos de trabalho//badge.svg +``` + +Alternativamente, se o seu fluxo de trabalho não tiver um nome ``, você deve fazer referência ao arquivo de fluxo de trabalho usando o caminho do arquivo em relação ao diretório raiz do repositório. + +{% note %} + +**Nota:** Fazer referência ao arquivo de fluxo de trabalho usando o caminho do arquivo não funciona se o fluxo de trabalho tiver um nome ``. + +{% endnote %} + +``` +https://github.com///fluxos de trabalho//badge.svg +``` + +### Usar um nome de fluxo de trabalho + +Este exemplo de Markdown adiciona um crachá de status para um fluxo de trabalho com o nome "Cumprimente a Todos". O proprietário `do repositório é a ações` organização e o nome repositório `é `hello-world . + +``` +! [nome do fluxo de trabalho de exemplo] (https://github.com/actions/hello-world/workflows/Greet%20Everyone/badge.svg) +``` + +### Usar um caminho de arquivo de fluxo de trabalho + +Este exemplo de Markdown adiciona um crachá de status para um fluxo de trabalho com o caminho do arquivo `.github/workflows/main.yml`. O proprietário `do repositório é a ações` organização e o nome repositório `é `hello-world . + +``` +! [exemplo caminho do arquivo de fluxo de trabalho] (https://github.com/actions/hello-world/workflows/.github/workflows/main.yml/badge.svg) +``` + +### Usando o parâmetro `branch` + +Este exemplo de Markdown adiciona um crachá de status para uma filial com o nome `recurso-1`. + +``` +! [parâmetro de ramo de exemplo] (https://github.com/actions/hello-world/workflows/Greet%20Everyone/badge.svg?branch=feature-1) +``` + +### Usar o parâmetro `evento` + +Este exemplo de Markdown adiciona um crachá que exibe o status das corridas de fluxo de trabalho desencadeadas pelo `pull_request` evento. + +``` +! [parâmetro de evento de exemplo] (https://github.com/actions/hello-world/workflows/Greet%20Everyone/badge.svg?event=pull_request) +``` diff --git a/translations/pt-BR/content/actions/managing-workflow-runs/canceling-a-workflow.md b/translations/pt-BR/content/actions/managing-workflow-runs/canceling-a-workflow.md new file mode 100644 index 000000000000..014e40c95d57 --- /dev/null +++ b/translations/pt-BR/content/actions/managing-workflow-runs/canceling-a-workflow.md @@ -0,0 +1,31 @@ +--- +title: Cancelar um fluxo de trabalho +intro: 'Você pode cancelar a execução de um fluxo de trabalho em andamento. Ao cancelar a execução de um fluxo de trabalho, o {% data variables.product.prodname_dotcom %} cancela todos os trabalhos e as etapas que integram esse fluxo de trabalho.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% data reusables.repositories.permissions-statement-write %} + +### Cancelar a execução do fluxo de trabalho + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. No canto superior direito do fluxo de trabalho, clique em **Cancelar fluxo de trabalho**. ![Botão Cancel check suite (Cancelar conjunto de verificações)](/assets/images/help/repository/cancel-check-suite.png) + +### Etapas que o {% data variables.product.prodname_dotcom %} realiza para cancelar uma execução de fluxo de trabalho + +Ao cancelar a execução do fluxo de trabalho, você poderá estar executando outro software que utiliza recursos relacionados à execução do fluxo de trabalho. Para ajudar você a liberar recursos relacionados à execução do fluxo de trabalho, pode ser útil entender as etapas que {% data variables.product.prodname_dotcom %} realiza para cancelar a execução de um fluxo de trabalho. + +1. Para cancelar a execução do fluxo de trabalho, o servidor avalia novamente as condições `if` para todas as tarefas em execução atualmente. Se a condição for avaliada como `verdadeira`, o trabalho não será cancelado. Por exemplo, a condição `if: always()` seria avaliada como verdadeira e o trabalho continuaria a ser executado. Quando não há nenhuma condição, isso é equivalente à condição `if: success()`, que só é executado se a etapa anterior foi concluída com sucesso. +2. Para trabalhos que devem ser cancelados, o servidor envia uma mensagem de cancelamento para todas as máquinas dos executores com trabalhos que precisam ser cancelados. +3. Para os trabalhos que continuam a ser executados, o servidor avalia as condições `if` para as etapas não concluídas. Se a condição for avaliada como `verdadeiro`, a etapa continuará sendo executada. +4. Para etapas que precisam ser canceladas, a máquina do executor envia `SIGINT/Ctrl-C` para o processo de entrada da etapa (`nó` para ação javascript, `docker` para ação de contêiner e `bash/cmd/pwd` quando estiver usando `execução` em uma etapa). Se o processo não sair em 7500 ms, o executor enviará `SIGTERM/Ctrl-Break` para o processo. Em seguida, espere 2500 ms para que o processo saia. Se o processo ainda estiver em execução, o corredor finalizará abruptamente a árvore do processo. +5. Após o tempo-limite de cancelamento de 5 minutos, o servidor irá forçar o encerramento de todos os trabalhos e etapas que não terminarem de ser executadas ou não concluírem o processo de cancelamento. diff --git a/translations/pt-BR/content/actions/managing-workflow-runs/deleting-a-workflow-run.md b/translations/pt-BR/content/actions/managing-workflow-runs/deleting-a-workflow-run.md new file mode 100644 index 000000000000..889472b157f1 --- /dev/null +++ b/translations/pt-BR/content/actions/managing-workflow-runs/deleting-a-workflow-run.md @@ -0,0 +1,23 @@ +--- +title: Eliminar execução de um fluxo de trabalho +intro: 'Você pode excluir uma execução do fluxo de trabalho que foi concluída ou que tem mais de duas semanas.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% data reusables.repositories.permissions-statement-write %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +1. Para excluir a execução de um fluxo de trabalho, use o menu suspenso {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} e selecione **Excluir execução de fluxo de trabalho**. + + ![Eliminar execução de um fluxo de trabalho](/assets/images/help/settings/workflow-delete-run.png) +2. Revise a solicitação de confirmação e clique em **Sim, excluir permanentemente esta execução do fluxo de trabalho**. + + ![Excluir uma confirmação de execução de fluxo de trabalho](/assets/images/help/settings/workflow-delete-run-confirmation.png) diff --git a/translations/pt-BR/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md b/translations/pt-BR/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md new file mode 100644 index 000000000000..7675c2e57948 --- /dev/null +++ b/translations/pt-BR/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md @@ -0,0 +1,45 @@ +--- +title: Desabilitar e habilitar um fluxo de trabalho +intro: Você pode desabilitar e reabilitar um fluxo de trabalho usando {% data variables.product.prodname_dotcom %} ou a API REST. +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.23' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +Desabilitar um fluxo de trabalho permite que você impeça que um fluxo de trabalho seja acionado sem ter de excluir o arquivo do repositório. Você pode facilmente reabilitar o fluxo de trabalho novamente em {% data variables.product.prodname_dotcom %}. Também é possível desabilitar e habilitar um fluxo de trabalho usando a API REST. Para obter mais informações, consulte a "[Ações da REST API](/rest/reference/actions#workflows)". + +Desabilitar temporariamente um fluxo de trabalho pode ser útil em vários cenários. Estes são alguns exemplos em que desabilitar um fluxo de trabalho pode ser útil: + +- Um erro de fluxo de trabalho que produz muitas solicitações ou solicitações erradas, afetando negativamente os serviços externos. +- Um fluxo de trabalho que não é crítico e está consumindo muitos minutos na sua conta. +- Um fluxo de trabalho que envia solicitações para um serviço que não está ativo. +- Fluxos de trabalho em um repositório bifurcado desnecessários (por exemplo, fluxos de trabalho agendados). + +{% warning %} + +**Aviso:** {% data reusables.actions.scheduled-workflows-disabled %} + +{% endwarning %} + +### Desabilitar um fluxo de trabalho + +Você pode desabilitar manualmente um fluxo de trabalho para que não realize qualquer execução de fluxo de trabalho. Um fluxo de trabalho desabilitado não é excluído e pode ser reabilitado. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. Na barra lateral esquerda, clique no fluxo de trabalho que deseja desabilitar. ![ações selecionam fluxo de trabalho](/assets/images/actions-select-workflow.png) +1. Clique em {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}. ![menu de ações kebab](/assets/images/help/repository/actions-workflow-menu-kebab.png) +1. Clique **Desabilitar fluxo de trabalho**. ![actions disable workflow](/assets/images/help/repository/actions-disable-workflow.png) O fluxo de trabalho desabilitado está marcado {% octicon "stop" aria-label="The stop icon" %} para indicar seu status. ![lista de ações desabilitada no fluxo de trabalho](/assets/images/help/repository/actions-find-disabled-workflow.png) + +### Habilitar um fluxo de trabalho + +Você pode habilitar novamente um fluxo de trabalho que foi desabilitado anteriormente. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. Na barra lateral esquerda, clique no fluxo de trabalho que deseja habilitar. ![ações selecionam um fluxo de trabalho desativado](/assets/images/help/repository/actions-select-disabled-workflow.png) +1. Clique em **Habilitar o fluxo de trabalho**. ![ações habilitam fluxo de trabalho](/assets/images/help/repository/actions-enable-workflow.png) diff --git a/translations/pt-BR/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md b/translations/pt-BR/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md new file mode 100644 index 000000000000..1d72a57b169e --- /dev/null +++ b/translations/pt-BR/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md @@ -0,0 +1,22 @@ +--- +title: Fazer o download de artefatos do fluxo de trabalho +intro: Você pode fazer o download de artefatos arquivados antes que expirem automaticamente. +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 2" %} Por padrão, {% data variables.product.product_name %} armazena registros e artefatos por 90 dias, e você pode personalizar este período de retenção, dependendo do tipo de repositório. Para obter mais informações, consulte "[Configurar o período de retenção para artefatos e registros do GitHub Actions no seu repositório](/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository)".{% endif %} +{% if currentVersion == "enterprise-server@2.22" %} {% data variables.product.product_name %} armazena registros de criação completos e artefatos por 90 dias.{% endif %} + +{% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. Em **Artefatos**, clique no artefato que deseja baixar. ![Menu suspenso do para fazer download do artefato](/assets/images/help/repository/artifact-drop-down.png) diff --git a/translations/pt-BR/content/actions/managing-workflow-runs/enabling-debug-logging.md b/translations/pt-BR/content/actions/managing-workflow-runs/enabling-debug-logging.md new file mode 100644 index 000000000000..483598d3c7bc --- /dev/null +++ b/translations/pt-BR/content/actions/managing-workflow-runs/enabling-debug-logging.md @@ -0,0 +1,38 @@ +--- +title: Habilitar log de depuração +intro: 'Se os logs do fluxo de trabalho não fornecerem detalhes suficientes para diagnosticar o motivo pelo qual um fluxo de trabalho, um trabalho ou uma etapa não está funcionando como esperado, habilite o log de depuração adicional.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +Esses registros adicionais são habilitados pela definição dos segredos no repositório que contém o fluxo de trabalho. Portanto, aplicam-se os mesmos requisitos de permissão: + +- {% data reusables.github-actions.permissions-statement-secrets-repository %} +- {% data reusables.github-actions.permissions-statement-secrets-organization %} +- {% data reusables.github-actions.permissions-statement-secrets-api %} + +Para obter mais informações sobre segredos de configuração, consulte "[Criar e usar segredos criptografados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". + +### Habilitar log de diagnóstico do runner + +O log de diagnóstico do executor fornece arquivos de log adicionais que contêm informações sobre como um executor está executando um trabalho. Dois arquivos de log extras foram adicionados ao arquivo de log: + +* O log de processo do runner, que inclui informações sobre a coordenação e a configuração de runners para executar trabalhos. +* O log de processo do worker, que registra em log a execução de um trabalho. + +1. Para habilitar o log de diagnóstico do runner, defina a seguinte chave secreta no repositório que contém o fluxo de trabalho: `ACTIONS_RUNNER_DEBUG` como `true`. + +1. Para baixar os logs de diagnóstico do runner, baixe o arquivo de log da execução de fluxo de trabalho. Os logs de diagnóstico do runner ficam na pasta `runner-diagnostic-logs`. Para obter mais informações sobre o download de logs, consulte "[Fazer download de registros](/actions/managing-workflow-runs/using-workflow-run-logs/#downloading-logs)". + +### Habilitar log de depuração da etapa + +O log de depuração da etapa aumenta o detalhamento dos logs de um trabalho durante e depois da execução dele. + +1. Para habilitar o log de diagnóstico da etapa, defina a seguinte chave secreta no repositório que contém o fluxo de trabalho: `ACTIONS_STEP_DEBUG` como `true`. + +1. Após a configuração da chave secreta, mais eventos de depuração são exibidos nos logs da etapa. Para obter mais informações, consulte ["Exibir logs para diagnosticar falhas"](/actions/managing-workflow-runs/using-workflow-run-logs/#viewing-logs-to-diagnose-failures). diff --git a/translations/pt-BR/content/actions/managing-workflow-runs/index.md b/translations/pt-BR/content/actions/managing-workflow-runs/index.md new file mode 100644 index 000000000000..d0199b7c0698 --- /dev/null +++ b/translations/pt-BR/content/actions/managing-workflow-runs/index.md @@ -0,0 +1,32 @@ +--- +title: Gerenciar fluxos de trabalho +shortTitle: Gerenciar fluxos de trabalho +intro: 'Você pode visualizar o status e os resultados de cada etapa no seu fluxo de trabalho, cancelar um fluxo de trabalho pendente, visualizar os minutos de execução do trabalho faturável, depurar e reexecutar o fluxo de trabalho com falha, pesquisar e fazer o download de registros e de artefatos.' +redirect_from: + - /actions/configuring-and-managing-workflows/managing-a-workflow-run + - /articles/viewing-your-repository-s-workflows + - /articles/viewing-your-repositorys-workflows + - /articles/managing-a-workflow-run + - /github/automating-your-workflow-with-github-actions/managing-a-workflow-run + - /actions/automating-your-workflow-with-github-actions/managing-a-workflow-run + - /actions/configuring-and-managing-workflows/configuring-and-managing-workflow-files-and-runs +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% link_in_list /viewing-workflow-run-history %} +{% link_in_list /using-workflow-run-logs %} +{% link_in_list /manually-running-a-workflow %} +{% link_in_list /re-running-a-workflow %} +{% link_in_list /canceling-a-workflow %} +{% link_in_list /disabling-and-enabling-a-workflow %} +{% link_in_list /deleting-a-workflow-run %} +{% link_in_list /viewing-job-execution-time %} +{% link_in_list /downloading-workflow-artifacts %} +{% link_in_list /removing-workflow-artifacts %} +{% link_in_list /enabling-debug-logging %} +{% link_in_list /adding-a-workflow-status-badge %} diff --git a/translations/pt-BR/content/actions/managing-workflow-runs/manually-running-a-workflow.md b/translations/pt-BR/content/actions/managing-workflow-runs/manually-running-a-workflow.md new file mode 100644 index 000000000000..02f16e6dcb74 --- /dev/null +++ b/translations/pt-BR/content/actions/managing-workflow-runs/manually-running-a-workflow.md @@ -0,0 +1,31 @@ +--- +title: Executando manualmente um fluxo de trabalho +intro: 'Quando um fluxo de trabalho é configurado para ser executado no evento `workflow_dispatch`, você pode executar o fluxo de trabalho usando a API REST ou na aba Ações em {% data variables.product.prodname_dotcom %}.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +Para executar um fluxo de trabalho manualmente, o fluxo de trabalho deve ser configurado para ser executado no evento `workflow_dispatch`. Para obter mais informações, consulte "[Eventos que acionam fluxos de trabalho](/actions/reference/events-that-trigger-workflows)". + +### Executar um fluxo de trabalho em {% data variables.product.prodname_dotcom %} + +Para acionar o evento `workflow_dispatch` em {% data variables.product.prodname_dotcom %}, seu fluxo de trabalho deve estar no branch-padrão. Siga estas etapas para acionar manualmente uma execução do fluxo de trabalho. + +{% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. Na barra lateral esquerda, clique no fluxo de trabalho que deseja executar. ![ações selecionam fluxo de trabalho](/assets/images/actions-select-workflow.png) +1. Acima da lista de execuções de fluxo de trabalho, selecione **Executar**de fluxo de trabalho . ![expedição de fluxo de trabalho ações](/assets/images/actions-workflow-dispatch.png) +1. Selecione o ramo onde o fluxo de trabalho será executado e digite os parâmetros de entrada usados pelo fluxo de trabalho. Clique em **Executar**de fluxo de trabalho . ![ações executar manualmente fluxo de trabalho](/assets/images/actions-manually-run-workflow.png) + +### Executar um fluxo de trabalho usando a API REST + +Ao usar a API REST, você configura as entradas de `` e `ref` como parâmetros do corpo de solicitação. Se as entradas forem omitidas, os valores padrão definidos no arquivo de fluxo de trabalho ão usados. + +Para obter mais informações sobre como usar a API REST, consulte o "[Criar um evento de expedição de fluxo de trabalho](/rest/reference/actions/#create-a-workflow-dispatch-event)." diff --git a/translations/pt-BR/content/actions/managing-workflow-runs/re-running-a-workflow.md b/translations/pt-BR/content/actions/managing-workflow-runs/re-running-a-workflow.md new file mode 100644 index 000000000000..c68ead7ac9a1 --- /dev/null +++ b/translations/pt-BR/content/actions/managing-workflow-runs/re-running-a-workflow.md @@ -0,0 +1,19 @@ +--- +title: Reexecutar um fluxo de trabalho +intro: Você pode reexecutar uma instância de um fluxo de trabalho. Reexecutar um fluxo de trabalho usa o mesmo `GITHUB_SHA` (commit SHA) e `GITHUB_REF` (Git ref) do evento original que acionou a execução do fluxo de trabalho. +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. No canto superior direito do fluxo de trabalho, use o menu suspenso **Reexecutar trabalhos** e selecione **Reexecutar todos os trabalhos**. ![Menu suspenso Re-run checks (Executar verificações novamente)](/assets/images/help/repository/rerun-checks-drop-down.png) diff --git a/translations/pt-BR/content/actions/managing-workflow-runs/removing-workflow-artifacts.md b/translations/pt-BR/content/actions/managing-workflow-runs/removing-workflow-artifacts.md new file mode 100644 index 000000000000..13f31fd2653f --- /dev/null +++ b/translations/pt-BR/content/actions/managing-workflow-runs/removing-workflow-artifacts.md @@ -0,0 +1,41 @@ +--- +title: Remover artefatos de fluxo de trabalho +intro: 'Você pode recuperar o armazenamento de {% data variables.product.prodname_actions %} utilizado, excluindo artefatos antes de expirarem em {% data variables.product.product_name %}.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Excluir um artefato + +{% warning %} + +**Aviso:** Após a exclusão de um artefato, este não poderá ser restaurado. + +{% endwarning %} + +{% data reusables.repositories.permissions-statement-write %} + +{% data reusables.github-actions.artifact-log-retention-statement %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. Em **Artefatos**, clique em {% octicon "trashcan" aria-label="The trashcan icon" %} ao lado do artefato que você deseja remover. ![Menu suspenso para excluir o artefato](/assets/images/help/repository/actions-delete-artifact.png) + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +### Definir o período de retenção para um artefato + +Os períodos de retenção para artefatos e registros podem ser configurados no repositório, organização e no nível corporativo. Para obter mais informações, consulte "[Limites de uso, cobrança e administração](/actions/reference/usage-limits-billing-and-administration#artifact-and-log-retention-policy)". + +Você também pode definir um período de retenção personalizado para artefatos individuais usando a ação `actions/upload-artefato` em um fluxo de trabalho. Para obter mais informações, consulte "[Armazenar dados de fluxo de trabalho como artefatos](/actions/guides/storing-workflow-data-as-artifacts#configuring-a-custom-artifact-retention-period)". + +### Localizar a data de expiração de um artefato + +Você pode usar a API para confirmar a data em que um artefato está agendado para ser excluído. Para obter mais informações, consulte o valor `expires_at` valor retornado por "[Listar artefatos para um repositório](/rest/reference/actions#artifacts). " +{% endif %} \ No newline at end of file diff --git a/translations/pt-BR/content/actions/managing-workflow-runs/using-workflow-run-logs.md b/translations/pt-BR/content/actions/managing-workflow-runs/using-workflow-run-logs.md new file mode 100644 index 000000000000..1ef38c4f7b2f --- /dev/null +++ b/translations/pt-BR/content/actions/managing-workflow-runs/using-workflow-run-logs.md @@ -0,0 +1,86 @@ +--- +title: Usar registros de execução do fluxo de trabalho +intro: 'Você pode visualizar, pesquisar e fazer download dos logs para cada trabalho em uma execução de fluxo de trabalho.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +Na página de execução de fluxo de trabalho, você pode verificar se a execução está em andamento ou foi concluída. Você deve estar conectado a uma conta {% data variables.product.prodname_dotcom %} para visualizar as informações da execução do seu fluxo de trabalho, incluindo os repositórios públicos. Para obter mais informações, consulte "[Permissões de acesso no GitHub](/articles/access-permissions-on-github)". + +Se a execução estiver concluída, será possível ver se o resultado teve êxito, se houve falha, se foi cancelado ou se ficou neutro. Em caso de falha, você poderá exibir e pesquisar os logs de criação para diagnosticar a falha e executar o fluxo de trabalho novamente. Você também pode visualizar os minutos da execução do trabalho faturável ou fazer o download dos registros e criar artefatos. + +O {% data variables.product.prodname_actions %} usa a API de Verificação para mostrar os status, resultados e logs de um fluxo de trabalho. O {% data variables.product.prodname_dotcom %} cria um novo conjunto de verificações para cada execução de fluxo de trabalho. O conjunto de verificações contêm uma execução de verificação para cada trabalho no fluxo de trabalho, e cada trabalho inclui etapas. As ações do {% data variables.product.prodname_actions %} são executadas como etapas no fluxo de trabalho. Para obter mais informações sobre a API de verificações, consulte "[Verificações](/v3/checks/)". + +{% data reusables.github-actions.invalid-workflow-files %} + +### Exibir logs para diagnosticar falhas + +Se houver falha na execução do fluxo de trabalho, você poderá ver qual etapa causou a falha e revisar os logs de criação da etapa com falha para resolver os problemas. Também é possível ver a duração da execução de cada etapa. Além disso, você pode copiar um permalink para determinada linha no arquivo de log a fim de compartilhar com a sua equipe. {% data reusables.repositories.permissions-statement-read %} + +Além das etapas configuradas no arquivo do fluxo de trabalho, {% data variables.product.prodname_dotcom %} acrescenta duas etapas adicionais a cada trabalho para configurar e concluir a execução do trabalho. Estas etapas estão registradas na execução do fluxo de trabalho com os nomes "Configurar trabalho" e "Concluir trabalho". + +Para trabalhos executados em executores hospedados no {% data variables.product.prodname_dotcom %}, "Configurar trabalho" registra os detalhes do ambiente virtual do executor e inclui um link para a lista de ferramentas pré-instaladas que estavam presentes na máquina do executor. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +{% data reusables.repositories.navigate-to-job-superlinter %} +{% data reusables.repositories.view-failed-job-results-superlinter %} +{% data reusables.repositories.view-specific-line-superlinter %} + +### Pesquisar logs + +É possível pesquisar os logs de criação em determinadas etapas. Na pesquisa dos logs, somente as etapas expandidas são incluídas nos resultados. {% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +{% data reusables.repositories.navigate-to-job-superlinter %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +1. No canto superior direito da saída do log, na caixa **Search logs** (Pesquisar logs), digite um termo de consulta. ![Caixa de pesquisa de logs](/assets/images/help/repository/search-log-box-updated.png) +{% else %} +1. Para expandir cada etapa que você pretende incluir na pesquisa, clique na etapa.![Nome da etapa](/assets/images/help/repository/failed-check-step.png) +1. No canto superior direito da saída do log, na caixa **Search logs** (Pesquisar logs), digite um termo de consulta. ![Caixa de pesquisa de logs](/assets/images/help/repository/search-log-box.png) +{% endif %} + +### Fazer download dos registros + +Você pode fazer o download dos arquivos de registro da execução do seu fluxo de trabalho. Você também pode fazer o download dos artefatos de um fluxo de trabalho. Para obter mais informações, consulte "[Dados recorrentes do fluxo de trabalho que usam artefatos](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)". {% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +{% data reusables.repositories.navigate-to-job-superlinter %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +1. In the upper right corner, click +{% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} and select **Download log archive**. + ![Menu suspenso Download logs (Baixar logs)](/assets/images/help/repository/download-logs-drop-down-updated.png) +{% else %} +1. In the upper right corner, click +{% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} and select **Download log archive**. + ![Menu suspenso Download logs (Baixar logs)](/assets/images/help/repository/download-logs-drop-down.png) +{% endif %} + +### Excluir registros + +Você pode excluir arquivos de registro da execução do seu fluxo de trabalho. {% data reusables.repositories.permissions-statement-write %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +1. No canto superior direito, clique em {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}. ![Ícone horizontal do kebab](/assets/images/help/repository/workflow-run-kebab-horizontal-icon-updated.png) +2. Para excluir os arquivos de registro, clique no botão **Excluir todos os registros** e revise a instrução de confirmação. ![Delete all logs](/assets/images/help/repository/delete-all-logs-updated.png)Após excluir os registros, o botão **Excluir todos os registros** será removido para indicar que não restaram arquivos de registro na execução do fluxo de trabalho. +{% else %} +1. No canto superior direito, clique em {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}. ![Ícone horizontal do kebab](/assets/images/help/repository/workflow-run-kebab-horizontal-icon.png) +2. Para excluir os arquivos de registro, clique no botão **Excluir todos os registros** e revise a instrução de confirmação. ![Delete all logs](/assets/images/help/repository/delete-all-logs.png) After the logs have been deleted, the **Delete all logs** button is removed to indicate that no log files remain in the workflow run. +{% endif %} diff --git a/translations/pt-BR/content/actions/managing-workflow-runs/viewing-job-execution-time.md b/translations/pt-BR/content/actions/managing-workflow-runs/viewing-job-execution-time.md new file mode 100644 index 000000000000..de546bd8cc1f --- /dev/null +++ b/translations/pt-BR/content/actions/managing-workflow-runs/viewing-job-execution-time.md @@ -0,0 +1,24 @@ +--- +title: Visualizar o tempo de execução do trabalho +intro: 'Você pode visualizar o tempo de execução de um trabalho, incluindo os minutos faturáveis que um trabalho acumulou.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +Os minutos de execução de um trabalho faturável são exibidos para trabalhos executados em repositórios privados que usam executores hospedados em {% data variables.product.prodname_dotcom %}. Não há minutos faturáveis ao usar {% data variables.product.prodname_actions %} nos repositórios públicos ou para trabalhos executados em executores auto-hospedados. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. No resumo do trabalho, você pode ver o tempo de execução do trabalho. Para visualizar o tempo faturável de execução do trabalho, clique em **Informações de tempo de execução e de tempo faturável**. ![Link com informações sobre o tempo faturável e execução](/assets/images/help/repository/view-run-billable-time.png) + + {% note %} + + **Observação:**O tempo faturável exibido não inclui arredondamentos ou multiplicadores de minutos. Para visualizar o uso total de {% data variables.product.prodname_actions %}, incluindo arredondamento e multiplicadores de minutos, consulte "[Visualizando o seu uso {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage)". + + {% endnote %} diff --git a/translations/pt-BR/content/actions/managing-workflow-runs/viewing-workflow-run-history.md b/translations/pt-BR/content/actions/managing-workflow-runs/viewing-workflow-run-history.md new file mode 100644 index 000000000000..78f71c6b1951 --- /dev/null +++ b/translations/pt-BR/content/actions/managing-workflow-runs/viewing-workflow-run-history.md @@ -0,0 +1,18 @@ +--- +title: Visualizar o histórico de execução do fluxo de trabalho +intro: Você pode visualizar registros para cada execução de um fluxo de trabalho. Os registros incluem a situação de cada trabalho e a etapa de um fluxo de trabalho. +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} diff --git a/translations/pt-BR/content/actions/quickstart.md b/translations/pt-BR/content/actions/quickstart.md new file mode 100644 index 000000000000..0b381cfc2806 --- /dev/null +++ b/translations/pt-BR/content/actions/quickstart.md @@ -0,0 +1,75 @@ +--- +title: Início rápido para GitHub Actions +intro: 'Adicione um fluxo de trabalho do {% data variables.product.prodname_actions %} a um repositório existente em até 5 minutos ou menos.' +allowTitleToDifferFromFilename: true +redirect_from: + - /actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Introdução + +Você só precisa de um repositório de {% data variables.product.prodname_dotcom %} existente para criar e executar um fluxo de trabalho de {% data variables.product.prodname_actions %}. Neste guia, você adicionará um fluxo de trabalho que cria várias linguagens de codificação usando a [Ação de Super-Linter de {% data variables.product.prodname_dotcom %}](https://github.com/github/super-linter). O fluxo de trabalho usa o Super-Linter para validar o seu código-fonte toda vez que um novo commit é subido para o seu repositório. + +### Criar o seu primeiro fluxo de trabalho + +1. Do seu repositório no {% data variables.product.prodname_dotcom %}, crie um novo arquivo no diretório `.github/workflows` denominado `superlinter.yml`. Para obter mais informações, consulte "[Criar arquivos](/github/managing-files-in-a-repository/creating-new-files)". +2. Copie o conteúdo de YAML a seguir para o arquivo `superlinter.yml`. **Observação:** Se seu branch-padrão não for `principal`, atualize o valor de `DEFAULT_BRANCH` para corresponder ao nome do branch-padrão do seu repositório. + {% raw %} + ```yaml + name: Super-Linter + + # Run this workflow every time a new commit pushed to your repository + on: push + + jobs: + # Set the job key. The key is displayed as the job name + # when a job name is not provided + super-lint: + # Name the Job + name: Lint code base + # Set the type of machine to run on + runs-on: ubuntu-latest + + steps: + # Checks out a copy of your repository on the ubuntu-latest machine + - name: Checkout code + uses: actions/checkout@v2 + + # Runs the Super-Linter action + - name: Run Super-Linter + uses: github/super-linter@v3 + env: + DEFAULT_BRANCH: main + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + ``` + {% endraw %} +3. Para executar seu fluxo de trabalho, desça a barra de rolagem da página e selecione **Criar um novo branch para este commit e iniciar um pull request**. Em seguida, para criar um pull request, clique em **Propor novo arquivo**. ![Arquivo do fluxo de trabalho do commit](/assets/images/commit-workflow-file.png) + +Fazer commit do arquivo de fluxo de trabalho no repositório aciona o evento `push` e executa seu fluxo de trabalho. + +### Visualizar seus resultados do fluxo de trabalho + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +1. Na barra lateral esquerda, clique no trabalho **Lint de código-bsee**. ![Lint do trabalho do código-base](/assets/images/help/repository/superlinter-lint-code-base-job.png) +{% data reusables.repositories.view-failed-job-results-superlinter %} + +### Mais fluxos de trabalho iniciais + +O {% data variables.product.prodname_dotcom %} fornece modelos de fluxo de trabalho pré-configurados com os quais você pode começar para automatizar ou criar fluxos de trabalho de integração contínua. Você pode pesquisar a lista completa de modelos de fluxo de trabalho no repositório de {% if currentVersion == "free-pro-team@latest" %}[actions/starter-workflows](https://github.com/actions/starter-workflows) repository{% else %} `actions/starter-workflows` e no repositório {% data variables.product.product_location %}{% endif %}. + +### Próximas etapas + +O fluxo de trabalho do super-linter que você acabou de adicionar é executado sempre que o código é enviado para o seu repositório para ajudá-lo a detectar erros e inconsistências no seu código. Mas este é apenas o início do que você pode fazer com {% data variables.product.prodname_actions %}. O seu repositório pode conter vários fluxos de trabalho que ativam diferentes tarefas com base em diferentes eventos. O {% data variables.product.prodname_actions %} pode ajudá-lo a automatizar quase todos os aspectos dos processos de desenvolvimento do seu aplicativo. Pronto para começar? Aqui estão alguns recursos úteis para dar seus próximos passos com {% data variables.product.prodname_actions %}: + +- "[Aprenda {% data variables.product.prodname_actions %}](/actions/learn-github-actions)" para obter um tutorial aprofundado +- "[Guias](/actions/guides)" para casos e exemplos específicos de uso +- [github/super-linter](https://github.com/github/super-linter) para obter mais informações sobre a configuração da ação de Super-Linter diff --git a/translations/pt-BR/content/actions/reference/authentication-in-a-workflow.md b/translations/pt-BR/content/actions/reference/authentication-in-a-workflow.md new file mode 100644 index 000000000000..a85cc7913062 --- /dev/null +++ b/translations/pt-BR/content/actions/reference/authentication-in-a-workflow.md @@ -0,0 +1,100 @@ +--- +title: Autenticação em um fluxo de trabalho +intro: '{% data variables.product.prodname_dotcom %} fornece um token que você pode usar para autenticar em nome de {% data variables.product.prodname_actions %}.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /github/automating-your-workflow-with-github-actions/authenticating-with-the-github_token + - /actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token + - /actions/configuring-and-managing-workflows/authenticating-with-the-github_token +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +Qualquer pessoa com acesso de `gravar` em um repositório pode criar, ler e usar secredos. + +### Sobre o segredo `GITHUB_TOKEN` + +O {% data variables.product.prodname_dotcom %} cria automaticamente um segredo `GITHUB_TOKEN` para uso no fluxo de trabalho. Você pode usar o `GITHUB_TOKEN` para autenticar em uma execução de fluxo de trabalho. + +Ao habilitar {% data variables.product.prodname_actions %}, {% data variables.product.prodname_dotcom %} instala um {% data variables.product.prodname_github_app %} no seu repositório. O segredo `GITHUB_TOKEN` é um token de acesso de instalação {% data variables.product.prodname_github_app %}. Você pode usar o token de acesso de instalação para autenticar em nome do {% data variables.product.prodname_github_app %} instalado no seu repositório. As permissões do token são restritas ao repositório do fluxo de trabalho. Para obter mais informações, consulte "[Permissões para o `GITHUB_TOKEN`](#permissions-for-the-github_token)". + +Antes de iniciar cada trabalho, {% data variables.product.prodname_dotcom %} busca um token de acesso de instalação para o trabalho. O token expira quando o trabalho é concluído. + +O token também está disponível no contexto `github.token`. Para obter mais informações, consulte "[Contexto e sintaxe de expressão para {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)". + +### Usar o `GITHUB_TOKEN` em um fluxo de trabalho + +Para usar o segredo `GITHUB_TOKEN`, você deve referenciá-lo no arquivo do fluxo de trabalho. Usar um token pode compreender disponibilizar o token como uma entrada para uma ação que o exige ou fazer solicitações de API {% data variables.product.prodname_dotcom %} autenticadas. + +{% data reusables.github-actions.actions-do-not-trigger-workflows %} + +#### Exemplo de passar um `GITHUB_TOKEN` como uma entrada + +Este exemplo de fluxo de trabalho usa a [ação etiquetadora](https://github.com/actions/labeler), que exige o `GITHUB_TOKEN` como o valor para o parâmetro de entrada do `token`: + + {% raw %} + ```yaml + name: Pull request labeler + on: + - pull_request + jobs: + triage: + runs-on: ubuntu-latest + steps: + - uses: actions/labeler@v2 + with: + repo-token: ${{ secrets.GITHUB_TOKEN }} + ``` + {% endraw %} + +#### Exemplo de acessar o API REST + +Você pode usar o `GITHUB_TOKEN` para fazer chamadas de API autenticada. Este exemplo de fluxo de trabalho cria um problema usando a API REST de {% data variables.product.prodname_dotcom %}: + + {% raw %} + ```yaml + name: Create issue on commit + on: + - push + jobs: + create_commit: + runs-on: ubuntu-latest + steps: + - name: Create issue using REST API + run: | + curl --request POST \ + --url https://api.github.com/repos/${{ github.repository }}/issues \ + --header 'authorization: Bearer ${{ secrets.GITHUB_TOKEN }}' \ + --header 'content-type: application/json' \ + --data '{ + "title": "Automated issue for commit: ${{ github.sha }}", + "body": "This issue was automatically created by the GitHub Action workflow **${{ github.workflow }}**. \n\n O hash do commit foi: _${{ github.sha }}_." + }' + ``` + {% endraw %} + +### Permissões para o `GITHUB_TOKEN` + +Para obter informações sobre os pontos de extremidade da API que {% data variables.product.prodname_github_apps %} pode acessar com cada permissão, consulte "[Permissões de {% data variables.product.prodname_github_app %}](/v3/apps/permissions/). " + +| Permissão | Tipo de acesso | Acesso pelos repositórios bifurcados | +| ----------------------- | ---------------- | ------------------------------------ | +| ações | leitura/gravação | leitura | +| Verificações | leitura/gravação | leitura | +| Conteúdo | leitura/gravação | leitura | +| Implantações | leitura/gravação | leitura | +| Problemas | leitura/gravação | leitura | +| metadados | leitura | leitura | +| pacotes | leitura/gravação | leitura | +| Pull requests | leitura/gravação | leitura | +| Projetos de repositório | leitura/gravação | leitura | +| Status | leitura/gravação | leitura | + +Se você precisa de um token que exige premissões que não estão disponíveis no `GITHUB_TOKEN`, é possível criar um token de acesso pessoal e configurá-lo como um segredo no repositório: + +1. Use ou crie um token com as permissões adequadas para o repositório. Para mais informação, consulte "[Criando um token de acesso pessoal](/github/authenticating-to-github/creating-a-personal-access-token)." +1. Adicione o token como um segredo no repositório do fluxo de trabalho e refira-se a ele usando a sintaxe {%raw%}`${{ secrets.SECRET_NAME }}`{% endraw %}. Para obter mais informações, consulte "[Criando e usando segredos encriptados](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". diff --git a/translations/pt-BR/content/actions/reference/context-and-expression-syntax-for-github-actions.md b/translations/pt-BR/content/actions/reference/context-and-expression-syntax-for-github-actions.md index 1c2039c65060..0bc9771e71e3 100644 --- a/translations/pt-BR/content/actions/reference/context-and-expression-syntax-for-github-actions.md +++ b/translations/pt-BR/content/actions/reference/context-and-expression-syntax-for-github-actions.md @@ -81,27 +81,27 @@ O contexto `github` context contém informações sobre a execução do fluxo de {% data reusables.github-actions.github-context-warning %} -| Nome da propriedade | Tipo | Descrição | -| ------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `github` | `objeto` | Contexto de nível mais alto disponível em qualquer trabalho ou etapa de um fluxo de trabalho. | -| `github.event` | `objeto` | Carga de evento de webhook completa. Para obter mais informações, consulte "[Eventos que acionam fluxos de trabalho](/articles/events-that-trigger-workflows/)". Você pode acessar as propriedades individuais do evento usando este contexto. | -| `github.event_path` | `string` | O caminho para a carga completa do evento do webhook no executor. | -| `github.workflow` | `string` | Nome do fluxo de trabalho. Se o fluxo de trabalho não determina um `name` (nome), o valor desta propriedade é o caminho completo do arquivo do fluxo de trabalho no repositório. | -| `github.job` | `string` | O [`job_id`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_id) do trabalho atual. | -| `github.run_id` | `string` | {% data reusables.github-actions.run_id_description %} | -| `github.run_number` | `string` | {% data reusables.github-actions.run_number_description %} | -| `github.actor` | `string` | Login do usuário que iniciou a execução do fluxo de trabalho. | -| `github.repository` | `string` | Nome do repositório e o proprietário. Por exemplo, `Codertocat/Hello-World`. | -| `github.repository_owner` | `string` | O nome do proprietário do repositório. Por exemplo, `Codertocat`. | -| `github.event_name` | `string` | Nome do evento que acionou a execução do fluxo de trabalho. | -| `github.sha` | `string` | Commit SHA que acionou a execução do fluxo de trabalho. | -| `github.ref` | `string` | Branch ou ref tag que acionou a execução do fluxo de trabalho. | -| `github.head_ref` | `string` | `head_ref` ou branch de origem da pull request em uma execução de fluxo de trabalho. Essa propriedade só está disponível quando o evento que aciona a execução do fluxo de trabalho é uma `pull_request`. | -| `github.base_ref` | `string` | `base_ref` ou branch alvo da pull request em uma execução de fluxo de trabalho. Essa propriedade só está disponível quando o evento que aciona a execução do fluxo de trabalho é uma `pull_request`. | -| `github.token` | `string` | Um token para fazer a autenticação em nome do aplicativo GitHub instalado no seu repositório. Isso é funcionalmente equivalente ao segredo `GITHUB_TOKEN`. Para obter mais informações, consulte "[Permissões para o GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)". | -| `github.workspace` | `string` | O diretório-padrão de trabalho para etapas e a localização-padrão do repositório ao usar a ação [`checkout-`](https://github.com/actions/checkout). | +| Nome da propriedade | Tipo | Descrição | +| ------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `github` | `objeto` | Contexto de nível mais alto disponível em qualquer trabalho ou etapa de um fluxo de trabalho. | | `github.action` | `string` | O nome da ação atualmente em execução. O {% data variables.product.prodname_dotcom %} remove os caracteres especiais ou usa o nome `executar` quando a etapa atual executa um script. Se você usar a mesma ação mais de uma vez no mesmo trabalho, o nome incluirá um sufixo com o número de sequência. Por exemplo, o primeiro script que você executa será denominado `run1`, e o segundo script será denominado `run2`. Da mesma forma, a segunda invocação de `actions/checkout` será `actionscheckout2`. | -| `github.action_path` | `string` | O caminho onde está localizada a sua ação. Você pode usar esse caminho para acessar facilmente os arquivos localizados no mesmo repositório que sua ação. Este atributo só é suportado em ações de etapas de execução compostas. | +| `github.action_path` | `string` | O caminho onde está localizada a sua ação. Você pode usar esse caminho para acessar facilmente os arquivos localizados no mesmo repositório que sua ação. Este atributo só é suportado em ações de etapas de execução compostas. | +| `github.actor` | `string` | Login do usuário que iniciou a execução do fluxo de trabalho. | +| `github.base_ref` | `string` | `base_ref` ou branch alvo da pull request em uma execução de fluxo de trabalho. Essa propriedade só está disponível quando o evento que aciona a execução do fluxo de trabalho é uma `pull_request`. | +| `github.event` | `objeto` | Carga de evento de webhook completa. Para obter mais informações, consulte "[Eventos que acionam fluxos de trabalho](/articles/events-that-trigger-workflows/)". Você pode acessar as propriedades individuais do evento usando este contexto. | +| `github.event_name` | `string` | Nome do evento que acionou a execução do fluxo de trabalho. | +| `github.event_path` | `string` | O caminho para a carga completa do evento do webhook no executor. | +| `github.head_ref` | `string` | `head_ref` ou branch de origem da pull request em uma execução de fluxo de trabalho. Essa propriedade só está disponível quando o evento que aciona a execução do fluxo de trabalho é uma `pull_request`. | +| `github.job` | `string` | O [`job_id`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_id) do trabalho atual. | +| `github.ref` | `string` | Branch ou ref tag que acionou a execução do fluxo de trabalho. | +| `github.repository` | `string` | Nome do repositório e o proprietário. Por exemplo, `Codertocat/Hello-World`. | +| `github.repository_owner` | `string` | O nome do proprietário do repositório. Por exemplo, `Codertocat`. | +| `github.run_id` | `string` | {% data reusables.github-actions.run_id_description %} +| `github.run_number` | `string` | {% data reusables.github-actions.run_number_description %} +| `github.sha` | `string` | Commit SHA que acionou a execução do fluxo de trabalho. | +| `github.token` | `string` | Um token para fazer a autenticação em nome do aplicativo GitHub instalado no seu repositório. Isso é funcionalmente equivalente ao segredo `GITHUB_TOKEN`. Para obter mais informações, consulte "[Permissões para o GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)". | +| `github.workflow` | `string` | Nome do fluxo de trabalho. Se o fluxo de trabalho não determina um `name` (nome), o valor desta propriedade é o caminho completo do arquivo do fluxo de trabalho no repositório. | +| `github.workspace` | `string` | O diretório-padrão de trabalho para etapas e a localização-padrão do repositório ao usar a ação [`checkout-`](https://github.com/actions/checkout). | #### **Contexto `env`** @@ -121,17 +121,17 @@ Você só pode usar o contexto `env` no valor de `com` e as chaves do `nome` ou O contexto `job` (trabalho) contém informações sobre o trabalho atualmente em execução. -| Nome da propriedade | Tipo | Descrição | -| ----------------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `trabalho` | `objeto` | Esse contexto altera cada trabalho em uma execução de fluxo de trabalho. Você pode acessar esse contexto em qualquer etapa de um trabalho. | -| `job.status` | `string` | Status atual do trabalho. Possíveis valores são `success`, `failure` ou `cancelled`. | +| Nome da propriedade | Tipo | Descrição | +| ----------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `trabalho` | `objeto` | Esse contexto altera cada trabalho em uma execução de fluxo de trabalho. Você pode acessar esse contexto em qualquer etapa de um trabalho. | | `job.container` | `objeto` | Informações sobre o contêiner do trabalho. Para obter mais informações sobre contêineres, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idcontainer)". | -| `job.container.network` | `string` | Identificação da rede do contêiner. O executor cria a rede usada por todos os contêineres em um trabalho. | -| `job.container.id` | `string` | Identificação do contêiner. | +| `job.container.id` | `string` | Identificação do contêiner. | +| `job.container.network` | `string` | Identificação da rede do contêiner. O executor cria a rede usada por todos os contêineres em um trabalho. | | `job.services` | `objeto` | Contêineres de serviços criados para um trabalho. Para obter mais informações sobre contêineres de serviço, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idservices)". | -| `job.services..id` | `string` | Identificação do contêiner de serviço. | -| `job.services..ports` | `objeto` | As portas expostas do contêiner de serviço. | -| `job.services..network` | `string` | Identificação da rede do contêiner de serviço. O executor cria a rede usada por todos os contêineres em um trabalho. | +| `job.services..id` | `string` | Identificação do contêiner de serviço. | +| `job.services..network` | `string` | Identificação da rede do contêiner de serviço. O executor cria a rede usada por todos os contêineres em um trabalho. | +| `job.services..ports` | `objeto` | As portas expostas do contêiner de serviço. | +| `job.status` | `string` | Status atual do trabalho. Possíveis valores são `success`, `failure` ou `cancelled`. | #### **Contexto `etapas`** @@ -140,31 +140,31 @@ O contexto `steps` (etapas) contém informações sobre as etapas já executadas | Nome da propriedade | Tipo | Descrição | | --------------------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `steps` | `objeto` | Esse contexto altera cada etapa em um trabalho. Você pode acessar esse contexto em qualquer etapa de um trabalho. | -| `steps..outputs` | `objeto` | Conjunto de saídas definidas para a etapa. Para obter mais informações, consulte "[Sintaxe de metadados para o {% data variables.product.prodname_actions %}](/articles/metadata-syntax-for-github-actions#outputs)". | -| `steps..outputs.` | `string` | Valor de uma saída específica. | -| `steps..outcome` | `string` | O resultado de uma etapa concluída antes de [`continue-on-error`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepscontinue-on-error) ser aplicado. Os valores possíveis são: `sucesso`, `falha`, `cancelado`ou `ignorado`. Quando ocorre uma falha na etapa de `continue-on-error`, o `resultado` será `falha`, mas a conclusão `final` será `sucesso`. | +| `steps..outputs` | `objeto` | Conjunto de saídas definidas para a etapa. Para obter mais informações, consulte "[Sintaxe de metadados para o {% data variables.product.prodname_actions %}](/articles/metadata-syntax-for-github-actions#outputs)". | | `steps..conclusion` | `string` | O resultado de uma etapa concluída após [`continue-on-error`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepscontinue-on-error) ser aplicado. Os valores possíveis são: `sucesso`, `falha`, `cancelado`ou `ignorado`. Quando ocorre uma falha na etapa de `continue-on-error`, o `resultado` será `falha`, mas a conclusão `final` será `sucesso`. | +| `steps..outcome` | `string` | O resultado de uma etapa concluída antes de [`continue-on-error`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepscontinue-on-error) ser aplicado. Os valores possíveis são: `sucesso`, `falha`, `cancelado`ou `ignorado`. Quando ocorre uma falha na etapa de `continue-on-error`, o `resultado` será `falha`, mas a conclusão `final` será `sucesso`. | +| `steps..outputs.` | `string` | Valor de uma saída específica. | #### **Contexto do `executor`** O contexto do `executor` contém informações sobre o executor que está executando o trabalho atual. -| Nome da propriedade | Tipo | Descrição | -| ------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `runner.os` | `string` | O sistema operacional do executor que está executando o trabalho. Os valores possíveis são: `Linux`, `Windows` ou `macOS`. | -| `runner.temp` | `string` | O caminho do diretório temporário para o executor. É certo que este diretório estará vazio no início de cada trabalho, mesmo em executores auto-hospedados. | -| `runner.tool_cache` | `string` | O caminho do diretório que contém algumas das ferramentas pré-instaladas para executores hospedados no {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte "[Software instalado nos executores hospedados no GitHub](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)". | +| Nome da propriedade | Tipo | Descrição | +| ------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `runner.os` | `string` | O sistema operacional do executor que está executando o trabalho. Os valores possíveis são: `Linux`, `Windows` ou `macOS`. | +| `runner.temp` | `string` | O caminho do diretório temporário para o executor. É certo que este diretório estará vazio no início de cada trabalho, mesmo em executores auto-hospedados. | +| `runner.tool_cache` | `string` | O caminho do diretório que contém algumas das ferramentas pré-instaladas para executores hospedados no {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte "[Especificações para executores hospedados no {% data variables.product.prodname_dotcom %}](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". | #### **Contexto `needs`** O contexto `needs` contém saídas de todos os trabalhos definidos como uma dependência do trabalho atual. Para obter mais informações sobre a definição de dependências de tarefas, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)". -| Nome da propriedade | Tipo | Descrição | -| -------------------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------- | -| `needs.` | `objeto` | Um único trabalho do qual o trabalho atual depende. | -| `needs..result` | `string` | O resultado de um trabalho do qual depende o trabalho atual. Possíveis valores são `success`, `failure` ou `cancelled`. | -| `needs..outputs` | `objeto` | O conjunto de saídas de um trabalho do qual o trabalho atual depende. | -| `needs..outputs.` | `string` | O valor de uma saída específica para um trabalho do qual o trabalho atual depende. | +| Nome da propriedade | Tipo | Descrição | +| -------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------ | +| `needs.` | `objeto` | Um único trabalho do qual o trabalho atual depende. | +| `needs..outputs` | `objeto` | O conjunto de saídas de um trabalho do qual o trabalho atual depende. | +| `needs..outputs.` | `string` | O valor de uma saída específica para um trabalho do qual o trabalho atual depende. | +| `needs..result` | `string` | O resultado de um trabalho do qual depende o trabalho atual. Os valores possíveis são: `sucesso`, `falha`, `cancelado`ou `ignorado`. | #### Exemplo de impressão de informações de contexto no arquivo de log @@ -179,7 +179,7 @@ on: push jobs: one: - runs-on: ubuntu-16.04 + runs-on: ubuntu-latest steps: - name: Dump GitHub context env: diff --git a/translations/pt-BR/content/actions/reference/encrypted-secrets.md b/translations/pt-BR/content/actions/reference/encrypted-secrets.md new file mode 100644 index 000000000000..587155dbdd95 --- /dev/null +++ b/translations/pt-BR/content/actions/reference/encrypted-secrets.md @@ -0,0 +1,221 @@ +--- +title: Segredos criptografados +intro: Os segredos encriptados permitem que você armazene informações confidenciais no seu repositório ou organização. +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets + - /actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets + - /actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Sobre os segredos encriptados + +Segredos são variáveis de ambiente encriptadas que você cria em um repositório ou organização. Os segredos que você cria estão disponíveis para utilização nos fluxos de trabalho em {% data variables.product.prodname_actions %}. O {% data variables.product.prodname_dotcom %} usa uma [caixa selada de libsodium](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes) para ajudar a garantir que os segredos sejam criptografados antes de chegar ao {% data variables.product.prodname_dotcom %} e permanecer criptografados até que você os use em um fluxo de trabalho. + +{% data reusables.github-actions.secrets-org-level-overview %} + +#### Nomear os seus segredos + +As regras a seguir aplicam-se aos nomes dos segredos: + +* Os nomes dos segredos podem conter apenas caracteres alfanuméricos (`[a-z]`, `[A-Z]`, `[0-9]`) or sublinhado (`_`). Não são permitidos espaços. +* Os nomes dos segredos não devem começar com o prefixo `GITHUB_`. +* Os nomes dos segredos não devem começar com um número. +* Os nomes dos segredos devem ser únicos no nível em que são criados. Por exemplo, um segredo criado no nível da organização deve ter um nome único nesse nível, e um segredo criado no nível do repositório deve ter um nome único nesse repositório. Se o segredo do nível de uma organização tiver o mesmo nome do segredo do nível do repositório, o segredo do nível do repositório prevalecerá. + +Para ajudar a garantir que {% data variables.product.prodname_dotcom %} remova o seu segredo dos registros, evite usar dados estruturados como valores dos segredos. Por exemplo, evite criar segredos que contêm JSON ou Git blobs. + +#### Acessar os seus segredos + +Para disponibilizar um segredo para uma ação, você deve configurá-lo como uma entrada ou variável de ambiente no arquivo do fluxo de trabalho. Revise o arquivo LEIAME da ação para saber quais entradas e variáveis de ambientes a ação exige. Para obter mais informações, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)". + +Você pode usar e ler segredos encriptados em um arquivo de fluxo de trabalho se tiver permissão para editar o arquivo. Para obter mais informações, consulte "[Permissões de acesso em {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/access-permissions-on-github)." + +{% warning %} + +**Aviso:** {% data variables.product.prodname_dotcom %} elimina automaticamente os segredos impressos no registro, mas você deve evitar a impressão intencional de segredos no log. + +{% endwarning %} + +Você também pode gerenciar segredos usando o API REST. Para obter mais informações, consulte "[Segredos](/v3/actions/secrets/)". + +#### Permissões limitadas de credenciais + +Ao gerar credenciais, recomendamos que você conceda as permissões mínimas possíveis. Por exemplo, em vez de usar credenciais pessoais, use [chaves de implantação](/v3/guides/managing-deploy-keys/#deploy-keys) ou uma conta de serviço. Considere conceder permissões somente leitura se isso o necessário e limite o acesso tanto quanto possível. Ao gerar um token de acesso pessoal (PAT), selecione o menor escopo necessário. + +### Criar segredos encriptados para um repositório + +{% data reusables.github-actions.permissions-statement-secrets-repository %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.github-actions.sidebar-secret %} +1. Clique em **Adicionar novo segredo**. +1. Digite um nome para o seu segredo na caixa de entrada **Nome**. +1. Insira o valor para o seu segredo. +1. Clique em **Add secret** (Adicionar segredo). + +Se o seu repositório puder acessar segredos a partir da organização-mãe, esses segredos também serão listados nesta página. + +### Criar segredos encriptados para uma organização + +Ao criar um segredo em uma organização, você pode usar uma política para limitar quais repositórios podem acessar esse segredo. Por exemplo, você pode conceder acesso a todos os repositórios ou limitar o acesso a apenas repositórios privados ou a uma lista específica de repositórios. + +{% data reusables.github-actions.permissions-statement-secrets-organization %} + +{% data reusables.organizations.navigate-to-org %} +{% data reusables.organizations.org_settings %} +{% data reusables.github-actions.sidebar-secret %} +1. Clique em **Novo segredo**. +1. Digite um nome para o seu segredo na caixa de entrada **Nome**. +1. Insira o **Valor** para o seu segredo. +1. Na lista suspensa **Acesso do repositório**, escolha uma política de acesso. +1. Clique em **Add secret** (Adicionar segredo). + +### Rever o acesso para os segredos do nível da organização + +Você pode verificar quais políticas de acesso são aplicadas a um segredo na sua organização. + +{% data reusables.organizations.navigate-to-org %} +{% data reusables.organizations.org_settings %} +{% data reusables.github-actions.sidebar-secret %} +1. A lista de segredos inclui quaisquer permissões e políticas configuradas. Por exemplo: ![Lista de segredos](/assets/images/help/settings/actions-org-secrets-list.png) +1. Para obter mais detalhes sobre as permissões configuradas para cada segredo, clique em **Atualizar**. + +### Usando segredos encriptados em um fluxo de trabalho + +Com exceção do `GITHUB_TOKEN`, os segredos não são disponibilizados para o executor quando um fluxo de trabalho é acionado a partir de um repositório bifurcado. + +Para fornecer uma ação com um segredo como uma entrada ou variável de ambiente, você pode usar o contexto de `segredos` para acessar os segredos que você criou no seu repositório. Para obter mais informações, consulte "[Contexto e sintaxe de expressão para {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)" e "[Sintaxe do fluxo de trabalho para {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)." + +{% raw %} +```yaml +steps: + - name: Hello world action + with: # Configura o segredo como uma entrada + super_secret: ${{ secrets.SuperSecret }} + env: # Ou como uma variável de ambiente + super_secret: ${{ secrets.SuperSecret }} +``` +{% endraw %} + +Evite a transmissão de segredos entre processos da linha de comando sempre que possível. Os processos da linha de comando podem ser visíveis para outros usuários (usando o comando `ps`) ou capturado por [eventos de auditoria de segurança](https://docs.microsoft.com/en-us/windows-server/identity/ad-ds/manage/component-updates/command-line-process-auditing). Para ajudar a proteger os segredos, considere o uso de variáveis de ambiente, `STDIN`, ou outros mecanismos compatíveis com o processo de destino. + +Se você passar segredos dentro de uma linha de comando, inclua-os dentro das regras de aspas corretas. Muitas vezes, os segredos contêm caracteres especiais que não intencionalmente podem afetar o seu shell. Para escapar desses caracteres especiais, use aspas com suas variáveis de ambiente. Por exemplo: + +#### Exemplo de uso do Bash + +{% raw %} +```yaml +etapas: + - shell: bash + env: + SUPER_SECRET: ${{ secrets.SuperSecret }} + run: | + example-command "$SUPER_SECRET" +``` +{% endraw %} + +#### Exemplo de uso do PowerShell + +{% raw %} +```yaml +etapas: + - shell: pwsh + env: + SUPER_SECRET: ${{ secrets.SuperSecret }} + run: | + example-command "$env:SUPER_SECRET" +``` +{% endraw %} + +#### Exemplo de uso do Cmd.exe + +{% raw %} +```yaml +etapas: + - shell: cmd + env: + SUPER_SECRET: ${{ secrets.SuperSecret }} + run: | + example-command "%SUPER_SECRET%" +``` +{% endraw %} + +### Limites para segredos + +O seu fluxo de trabalho pode ter até 100 segredos. Os nomes das variáveis do ambiente de segredo devem ser únicas em um repositório. + +Os segredos são limitados a 64 kB. Para usar segredos maiores que 64 kB, você pode armazenar segredos criptografados no seu repositório e salvar a frase secreta de descodificação como um segredo no {% data variables.product.prodname_dotcom %}. Por exemplo, você pode usar `gpg` para criptografar suas credenciais localmente antes de colocar o arquivo no repositório do {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte a "[página do manual gpg](https://www.gnupg.org/gph/de/manual/r1023.html)". + +{% warning %} + +**Aviso**: cuide para seus segredos não serem impressos quando a ação é executada. Quando usar essa alternativa, o {% data variables.product.prodname_dotcom %} não eliminará segredos que estão impressos nos logs. + +{% endwarning %} + +1. Execute o seguinte comando no seu terminal para criptografar o arquivo `my_secret.json` usando `gpg` e o algoritmo de cifragem AES256. + + ``` shell + $ gpg --symmetric --cipher-algo AES256 my_secret.json + ``` + +1. Você receberá a solicitação para inserir a frase secreta. Guarde a frase secreta, pois você precisará criar um novo segredo no {% data variables.product.prodname_dotcom %} que usa a frase secreta como valor. + +1. Criar um novo segredo que contém a frase secreta. Por exemplo, crie um novo segredo com o nome `LARGE_SECRET_PASSPHRASE` e defina o valor do segredo para a frase secreta que você escolheu na etapa anterior. + +1. Copie o arquivo criptografado no repositório e faça commit. Nesse exemplo, o arquivo criptografado é `my_secret.json.gpg`. + +1. Crie um script shell para decifrar a senha. Salve o arquivo como `decrypt_secret.sh`. + + ``` shell + #!/bin/sh + + # Decrypt the file + mkdir $HOME/secrets + # --lote para evitar o comando interativo + # --sim para supor "sim" para as perguntas + gpg --quiet --batch --yes --decrypt --passphrase="$LARGE_SECRET_PASSPHRASE" \ + --output $HOME/secrets/my_secret.json my_secret.json.gpg + ``` + +1. Confirme que o shell script é executável antes de colocá-lo no repositório. + + ``` shell + $ chmod +x decrypt_secret.sh + $ git add decrypt_secret.sh + $ git commit -m "Add new decryption script" + $ git push + ``` + +1. A partir de seu fluxo de trabalho, use `step` para chamar o shell script e decifrar o segredo. Para ter uma cópia do seu repositório no ambiente em que o seu fluxo de trabalho é executado, você deverá executar a ação [`actions/checkout`](https://github.com/actions/checkout). Faça referência ao shell script usando o comando `run` relativo à raiz do repositório. + +{% raw %} + ```yaml + nome: Fluxos de trabalho com grandes segredos + + : empurrar + + empregos: + meu trabalho: + nome: My Job + runs-on: ubuntu-latest + steps: + - usa: actions/checkout@v2 + - nome: Descriptografar grandes segredos + executar: ./.github/scripts/decrypt_secret.sh + env: + LARGE_SECRET_PASSPHRASE: ${{ secrets.LARGE_SECRET_PASSPHRASE }} + # Este comando é apenas um exemplo para mostrar seu segredo sendo impresso + # Certifique-se de remover quaisquer declarações impressas de seus segredos. O GitHub + # não oculta segredos que usam essa alternativa. + - name: Test printing your secret (Remove this step in production) + run: cat $HOME/secrets/my_secret.json + ``` +{% endraw %} diff --git a/translations/pt-BR/content/actions/reference/environment-variables.md b/translations/pt-BR/content/actions/reference/environment-variables.md new file mode 100644 index 000000000000..4e64e97ff3f1 --- /dev/null +++ b/translations/pt-BR/content/actions/reference/environment-variables.md @@ -0,0 +1,69 @@ +--- +title: Variáveis de ambiente +intro: '{% data variables.product.prodname_dotcom %} define as variáveis do ambiente para cada execução do fluxo de trabalho {% data variables.product.prodname_actions %}. Você também pode definir variáveis de ambiente personalizadas no seu arquivo do fluxo de trabalho.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /github/automating-your-workflow-with-github-actions/using-environment-variables + - /actions/automating-your-workflow-with-github-actions/using-environment-variables + - /actions/configuring-and-managing-workflows/using-environment-variables +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Sobre as variáveis de ambiente + +{% data variables.product.prodname_dotcom %} define as variáveis-padrão do ambiente disponíveis para cada etapa da execução de um fluxo de trabalho. As variáveis de ambiente diferenciam entre maiúsculas e minúsculas. Os comandos executados em ações ou etapas podem criar, ler e modificar as variáveis do ambiente. + +Para definir as variáveis do ambiente personalizadas, você deverá especificar as variáveis no arquivo do fluxo de trabalho. Você pode definir as variáveis de ambiente para uma etapa, trabalho ou para todo o fluxo de trabalho usando as palavras-chave [`jobs..steps.env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv), [`jobs..env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idenv), e [`env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env). Para obter mais informações, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_dotcom %}](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)". + +```yaml +passos: + - nome: Olá mundo + run: echo Hello world $FIRST_NAME $middle_name $Last_Name! + env: + FIRST_NAME: Mona + middle_name: The + Last_Name: Octocat +``` + +Você também pode usar o {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 2" %} arquivo de ambiente `GITHUB_ENV` {% else %} comando de fluxo de trabalho `set-env` {% endif %} para definir uma variável de ambiente que as seguintes etapas em um fluxo de trabalho podem usar. O {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 2" %}arquivo de ambiente{% else %} comando `set-env` {% endif %} pode ser usado diretamente por uma ação ou como um comando de shell em um arquivo de fluxo de trabalho usando a palavra-chave `executar`. Para obter mais informações, consulte "[Comandos do fluxo de trabalho para {% data variables.product.prodname_actions %}](/actions/reference/workflow-commands-for-github-actions/#setting-an-environment-variable)". + +### Variáveis padrão de ambiente + +É altamente recomendável que as ações usem as variáveis do ambiente para acessar o sistema do arquivo em vez de usar os caminhos do arquivo com codificação rígida. {% data variables.product.prodname_dotcom %} define as variáveis de ambiente para ações a serem usadas em todos os ambientes executores. + +| Variável de ambiente | Descrição | +| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `CI` | Definido sempre como `verdadeiro`. | +| `HOME` | Caminho para o diretório inicial do {% data variables.product.prodname_dotcom %} usado para armazenar dados do usuário. Por exemplo, `/github/home`. | +| `GITHUB_WORKFLOW` | Nome do fluxo de trabalho. | +| `GITHUB_RUN_ID` | {% data reusables.github-actions.run_id_description %} +| `GITHUB_RUN_NUMBER` | {% data reusables.github-actions.run_number_description %} +| `GITHUB_ACTION` | Identificador único (`id`) da ação. | +| `GITHUB_ACTIONS` | Definido sempre como `verdadeiro` quando {% data variables.product.prodname_actions %} estiver executando o fluxo de trabalho. Você pode usar esta variável para diferenciar quando os testes estão sendo executados localmente ou por {% data variables.product.prodname_actions %}. | +| `GITHUB_ACTOR` | Nome da pessoa ou aplicativo que iniciou o fluxo de trabalho. Por exemplo, `octocat`. | +| `GITHUB_REPOSITORY` | Nome do repositório e o proprietário. Por exemplo, `octocat/Hello-World`. | +| `GITHUB_EVENT_NAME` | Nome do evento de webhook que acionou o workflow. | +| `GITHUB_EVENT_PATH` | Caminho do arquivo com a carga completa do evento webhook. Por exemplo, `/github/workflow/event.json`. | +| `GITHUB_WORKSPACE` | Caminho do diretório do espaço de trabalho do {% data variables.product.prodname_dotcom %}. O diretório de área de trabalho é uma cópia do repositório se o fluxo de trabalho usar a ação [actions/checkout](https://github.com/actions/checkout). Se você não usar a ação `actions/checkout`, o diretório estará vazio. Por exemplo, `/home/runner/work/my-repo-name/my-repo-name`. | +| `GITHUB_SHA` | Commit SHA que acionou o fluxo de trabalho. Por exemplo, `ffac537e6cbbf934b08745a378932722df287a53`. | +| `GITHUB_REF` | Branch ou ref tag que acionou o fluxo de trabalho. Por exemplo, `refs/heads/feature-branch-1`. Se não houver branch ou tag disponível para o tipo de evento, a variável não existirá. | +| `GITHUB_HEAD_REF` | Configurado somente para repositórios bifurcados. O branch do repositório head. | +| `GITHUB_BASE_REF` | Configurado somente para repositórios bifurcados. O branch do repositório base. | +| `GITHUB_SERVER_URL` | Retorna a URL do servidor {% data variables.product.product_name %}. Por exemplo: `https://github.com`. | +| `GITHUB_API_URL` | Retorna a URL da API. Por exemplo: `https://api.github.com`. | +| `GITHUB_GRAPHQL_URL` | Retorna a URL API do GraphQL. Por exemplo: `https://api.github.com/graphql`. | + +### Convenções de nomenclatura para variáveis de ambiente + +{% note %} + +**Observação**{% data variables.product.prodname_dotcom %} reserva o prefixo da variável de ambiente `GITHUB_` para uso interno por {% data variables.product.prodname_dotcom %}. Definir uma variável de ambiente ou segredo com o prefixo `GITHUB_` resultará em erro. + +{% endnote %} + +Qualquer variável de ambiente nova que você definir e apontar para um local no sistema de arquivos deve ter um sufixo `_PATH`. As variáveis padrão `HOME` e `GITHUB_WORKSPACE` são exceções a essa convenção porque as palavras "inicial" e "espaço de trabalho" já indicam o local. diff --git a/translations/pt-BR/content/actions/reference/events-that-trigger-workflows.md b/translations/pt-BR/content/actions/reference/events-that-trigger-workflows.md index a0a8a2287d75..012d1004275f 100644 --- a/translations/pt-BR/content/actions/reference/events-that-trigger-workflows.md +++ b/translations/pt-BR/content/actions/reference/events-that-trigger-workflows.md @@ -15,31 +15,142 @@ versions: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -### Sobre eventos de fluxo de trabalho +### Configurar eventos de fluxo de trabalho -Você pode configurar a execução de seu fluxo de trabalho quando eventos webhook são criados a partir da atividade no {% data variables.product.product_name %}. Os fluxos de trabalho podem usar mais de um evento webhook para acionar a execução de um fluxo de trabalho. Para obter mais informações, consulte "[Webhooks](/webhooks). Para obter mais informações sobre a sintaxe `on`, consulte "[Sintaxe de fluxo de trabalho do {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#on)". +É possível configurar fluxos de trabalho para serem executados por um ou mais eventos usando a a sintaxe do fluxo de trabalho `on`. Para obter mais informações, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#on)". + +{% data reusables.github-actions.actions-on-examples %} + +{% note %} + +**Observação:** Você não pode acionar novas execuções do fluxo de trabalho usando o `GITHUB_TOKEN`. Para obter mais informações, consulte "[Acionando novos fluxos de trabalho usando um token de acesso pessoal](#triggering-new-workflows-using-a-personal-access-token)". + +{% endnote %} As etapas a seguir ocorrem para acionar a execução de um fluxo de trabalho: -1. Um evento ocorre no seu repositório e o webhook do evento resultante tem um commit SHA e um Git ref associado. -1. É feita uma pesquisa no diretório `.github/workflows` com relação aos arquivos do fluxo de trabalho no SHA ou Git ref associado. Os arquivos do fluxo de trabalho devem estar presentes nesse commit SHA ou no Git ref para serem considerados. +1. Um evento ocorre no seu repositório e o evento resultante tem um commit de SHA e ref de Git associados. +2. É feita uma pesquisa no diretório `.github/workflows` com relação aos arquivos do fluxo de trabalho no SHA ou Git ref associado. Os arquivos do fluxo de trabalho devem estar presentes nesse commit SHA ou no Git ref para serem considerados. Por exemplo, se o evento ocorreu em um determinado branch do repositório, os arquivos do fluxo de trabalho devem estar presentes no repositório desse branch. 1. Os arquivos do fluxo de trabalho para o commit SHA e Git ref são inspecionados, e aciona-se uma nova execução de fluxo de trabalho para quaisquer fluxos de trabalho com valores `on:` que correspondem ao evento de acionado. O fluxo de trabalho é executado no código do seu repositório no mesmo commit SHA e Git ref que acionou o evento. Quando um fluxo de trabalho é executado, o {% data variables.product.product_name %} configura as variáveis de ambiente `GITHUB_SHA` (commit SHA) e `GITHUB_REF` (Git ref) no ambiente do executor. Para obter mais informações, consulte "[Usando variáveis de ambiente](/actions/automating-your-workflow-with-github-actions/using-environment-variables)". +### Eventos programados + +O evento `agenda` permite que você acione um fluxo de trabalho em um horário agendado. + +#### `schedule` + +| Carga de evento webhook | Tipos de atividade | `GITHUB_SHA` | `GITHUB_REF` | +| ----------------------- | ------------------ | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| n/a | n/a | Último commit no branch padrão | Branch padrão | Quando a execução do fluxo de trabalho programado é definida. Um fluxo de trabalho programado usa a [sintaxe cron POSIX](https://pubs.opengroup.org/onlinepubs/9699919799/utilities/crontab.html#tag_20_25_07). Para obter mais informações, consulte "[Acionar um fluxo de trabalho com eventos](/articles/configuring-a-workflow/#triggering-a-workflow-with-events)". | + +{% data reusables.repositories.actions-scheduled-workflow-example %} + +A sintaxe cron tem cinco campos separados por um espaço, e cada campo representa uma unidade de tempo. + +``` +┌───────────── minuto (0 - 59) +│ ┌───────────── hora (0 - 23) +│ │ ┌───────────── dia do mês (1 - 31) +│ │ │ ┌───────────── mês (1 - 12 ou JAN-DEZ) +│ │ │ │ ┌───────────── dia da semana (0 - 6 ou DOM-SAB) +│ │ │ │ │ +│ │ │ │ │ +│ │ │ │ │ +* * * * * +``` + +Você pode usar estes operadores em qualquer um dos cinco campos: + +| Operador | Descrição | Exemplo | +| -------- | --------------------------- | ----------------------------------------------------------------------------------------------- | +| * | Qualquer valor | `* * * * *` executa cada minuto de todos os dias. | +| , | Separador de lista de valor | `2,10 4,5 * * *` executa no minuto 2 e 10 da quarta e quinta hora de todos os dias. | +| - | Intervalo de valores | `0 4-6 * * *` executa no minuto 0 da quarta, quinta e sexta hora. | +| / | Valores de etapa | `20/15 * * * *` executa a cada 15 minutos começando do miuto 20 até o 59 (minutos 20, 35 e 50). | + {% note %} -**Observação:** Você não pode acionar novas execuções do fluxo de trabalho usando o `GITHUB_TOKEN`. Para obter mais informações, consulte "[Acionando novos fluxos de trabalho usando um token de acesso pessoal](#triggering-new-workflows-using-a-personal-access-token)". +**Observação:** o {% data variables.product.prodname_actions %} não é compatível com a sintaxe não padrão `@yearly`, `@monthly`, `@weekly`, `@daily`, `@hourly` e `@reboot`. {% endnote %} -{% data reusables.github-actions.actions-on-examples %} +Você pode usar [crontab guru](https://crontab.guru/) para ajudar a gerar a sintaxe cron e confirmar a hora em que ela será executada. Para ajudar você a começar, há também uma lista de [exemplos de crontab guru](https://crontab.guru/examples.html). + +### Eventos manuais + +Você pode acionar as execuções de fluxo de trabalho manualmente. Para acionar fluxos de trabalho específicos em um repositório, use o evento `workflow_dispatch`. Para acionar mais de um fluxo de trabalho em um repositório e criar eventos personalizados e tipos de eventos, use o evento `repository_dispatch`. + +#### `workflow_dispatch` + +| Carga de evento webhook | Tipos de atividade | `GITHUB_SHA` | `GITHUB_REF` | +| ---------------------------------------------------------------- | ------------------ | --------------------------------------------- | ------------------------ | +| [workflow_dispatch](/webhooks/event-payloads/#workflow_dispatch) | n/a | Último commit de merge no branch `GITHUB_REF` | Branch que recebeu envio | + +É possível configurar as propriedades de entrada definidas por personalização, os valores-padrão de entrada e as entradas obrigatórias para o evento diretamente no seu fluxo de trabalho. Quando o fluxo de trabalho é executado, você pode acessar os valores de entrada no `github.event.inputs` contexto. Para obter mais informações, consulte "[Contexto e sintaxe de expressão para {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)". + +Você pode acionar manualmente uma execução de fluxo de trabalho usando a API do {% data variables.product.product_name %} e do {% data variables.product.product_name %}. Para obter mais informações, consulte "[Executando um fluxo de trabalho manualmente](/actions/managing-workflow-runs/manually-running-a-workflow)." + + Ao ativar o evento em {% data variables.product.prodname_dotcom %}, você poderá fornecer a `ref` e quaisquer `entradas` diretamente no {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte "[Usar entradas e saídas com uma ação](/actions/learn-github-actions/finding-and-customizing-actions#using-inputs-and-outputs-with-an-action)". + + Para acionar o evento do webhook `workflow_dispatch` usando a API REST, você deve enviar uma solicitação `POST` para um ponto de extremidade da API do {% data variables.product.prodname_dotcom %} e fornecer o `ref` e qualquer `entrada` necessária. Para obter mais informações, consulte o ponto de extremidade da API REST "[Criar um evento de envio de fluxo de trabalho](/rest/reference/actions/#create-a-workflow-dispatch-event)". + +##### Exemplo de configuração de fluxo de trabalho + +Este exemplo define o nome `` e `entradas de` domésticas e as imprime usando os contextos `github.event.inputs.name` e `github.event.inputs.home` . Se um `nome` não for fornecido, o valor padrão 'Mona, o Octocat' será impresso. + +{% raw %} +```yaml +nome: Fluxo de trabalho acionado manualmente +em: + workflow_dispatch: entradas + : + nome: + descrição: 'Pessoa para cumprimentar' + necessário: verdadeiro + padrão: 'Mona, o Octocat ' + casa: + descrição: 'localização' + necessário: falsos trabalhos de + +: + say_hello: + run-on: ubuntu-mais recente + passos: + - executar: | + eco "Olá ${{ github.event.inputs.name }}!" + eco "- em ${{ github.event.inputs.home }}!" +``` +{% endraw %} + +#### `repository_dispatch` + +| Carga de evento webhook | Tipos de atividade | `GITHUB_SHA` | `GITHUB_REF` | +| -------------------------------------------------------------------- | ------------------ | --------------------------------------------- | ------------------------ | +| [repository_dispatch](/webhooks/event-payloads/#repository_dispatch) | n/a | Último commit de merge no branch `GITHUB_REF` | Branch que recebeu envio | + +{% data reusables.github-actions.branch-requirement %} + +Você pode usar a API do {% data variables.product.product_name %} para acionar um evento do webhook denominado [`repository_dispatch`](/webhooks/event-payloads/#repository_dispatch) quando quiser acionar um fluxo de trabalho para uma atividade que ocorre fora do {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte "[Criar um evento de despacho de repositório](/v3/repos/#create-a-repository-dispatch-event)." + +Para acionar o evento webhook `repository_dispatch` personalizado, envie uma solicitação `POST` para um ponto de extremidade da API do {% data variables.product.product_name %} e forneça um nome de `event_type` para descrever o tipo de atividade. Para acionar a execução de um fluxo de trabalho, configure também o fluxo de trabalho para usar o evento `repository_dispatch`. + +##### Exemplo + +Por padrão, todos os `event_types` acionam a execução de um fluxo de trabalho. É possível limitar a execução do fluxo de trabalho quando um valor `event_type` específico for enviado na carga do webhook `repository_dispatch`. Você define os tipos de eventos enviados na carga `repository_dispatch` ao criar o evento de despacho de repositório. + +```yaml +em: + repository_dispatch: + tipos: [opened, deleted] +``` ### Eventos webhook -É possível configurar o fluxo de trabalho para ser executado quando eventos webhook forem criados no GitHub. Alguns eventos são acionados por mais de um tipo de atividade. Se mais de um tipo de atividade acionar o evento, especifique quais tipos de atividade ativarão a execução do fluxo de trabalho. +É possível configurar o fluxo de trabalho para ser executado quando eventos webhook forem criados no GitHub. Alguns eventos são acionados por mais de um tipo de atividade. Se mais de um tipo de atividade acionar o evento, especifique quais tipos de atividade ativarão a execução do fluxo de trabalho. Para obter mais informações, consulte "[Webhooks](/webhooks). #### `check_run` @@ -121,7 +232,7 @@ on: #### `implantação` -Executa o fluxo de trabalho sempre que alguém cria uma implantação, o que aciona o evento `deployment`. Implantações criadas com um commit SHA podem não ter um Git ref. Para obter informações sobre a API REST, consulte "[Implantações](/v3/repos/deployments/)". +Executa o fluxo de trabalho sempre que alguém cria uma implantação, o que aciona o evento `deployment`. Implantações criadas com um commit SHA podem não ter um Git ref. Para obter informações sobre a API REST, consulte "[Implantações](/rest/reference/repos#deployments)". | Carga de evento webhook | Tipos de atividade | `GITHUB_SHA` | `GITHUB_REF` | | ----------------------------------------------------- | ------------------ | ----------------------- | ------------------------------------------------ | @@ -136,7 +247,7 @@ on: #### `implantação_status` -Executa o fluxo de trabalho sempre que um terceiro fornece um status de implantação, o que aciona o evento `deployment_status`. Implantações criadas com um commit SHA podem não ter um Git ref. Para obter informações sobre a API REST, consulte "[Criar um status de implantação](/v3/repos/deployments/#create-a-deployment-status)". +Executa o fluxo de trabalho sempre que um terceiro fornece um status de implantação, o que aciona o evento `deployment_status`. Implantações criadas com um commit SHA podem não ter um Git ref. Para obter informações sobre a API REST, consulte "[Criar um status de implantação](/rest/reference/repos#create-a-deployment-status)". | Carga de evento webhook | Tipos de atividade | `GITHUB_SHA` | `GITHUB_REF` | | ------------------------------------------------------------------- | ------------------ | ----------------------- | ------------------------------------------------ | @@ -185,13 +296,13 @@ on: #### `issue_comment` -Executa o fluxo de trabalho sempre que o evento `issue_comment` ocorre. {% data reusables.developer-site.multiple_activity_types %} Para obter informações sobre a API REST, consulte "[Comentários do problema](/v3/issues/comments/)". +Executa o fluxo de trabalho sempre que o evento `issue_comment` ocorre. {% data reusables.developer-site.multiple_activity_types %} Para obter informações sobre a API REST, consulte "[Comentários do problema](/developers/webhooks-and-events/webhook-events-and-payloads#issue_comment)". {% data reusables.github-actions.branch-requirement %} -| Carga de evento webhook | Tipos de atividade | `GITHUB_SHA` | `GITHUB_REF` | -| ---------------------------------------------------------- | ----------------------------------------------------------------- | ------------------------------ | ------------- | -| [`issue_comment`](/v3/activity/event_types/#issue_comment) | - `created`
    - `edited`
    - `deleted`
    | Último commit no branch padrão | Branch padrão | +| Carga de evento webhook | Tipos de atividade | `GITHUB_SHA` | `GITHUB_REF` | +| --------------------------------------------------------- | ----------------------------------------------------------------- | ------------------------------ | ------------- | +| [`issue_comment`](/rest/reference/activity#issue_comment) | - `created`
    - `edited`
    - `deleted`
    | Último commit no branch padrão | Branch padrão | {% data reusables.developer-site.limit_workflow_to_activity_types %} @@ -265,7 +376,7 @@ on: #### `page_build` -Executa o fluxo de trabalho sempre que alguém faz push em um branch habilitado para o {% data variables.product.product_name %} Pages, o que aciona o evento `page_build`. Para obter informações sobre a API REST, consulte "[Páginas](/v3/repos/pages/)". +Executa o fluxo de trabalho sempre que alguém faz push em um branch habilitado para o {% data variables.product.product_name %} Pages, o que aciona o evento `page_build`. Para obter informações sobre a API REST, consulte "[Páginas](/rest/reference/repos#pages)". {% data reusables.github-actions.branch-requirement %} @@ -489,9 +600,9 @@ em: Executa o fluxo de trabalho sempre que o evento `release` ocorre. {% data reusables.developer-site.multiple_activity_types %} Para obter informações sobre a API REST, consulte "[Versões](/v3/repos/releases/)". -| Carga de evento webhook | Tipos de atividade | `GITHUB_SHA` | `GITHUB_REF` | -| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- | ------------- | -| [`versão`](/webhooks/event-payloads/#release) | - `publicado`{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}
    - `não publicado`
    - `criado`
    - `editado`
    - `excluído`
    - `pré-lançado`
    - `lançado`{% endif %} | Último commit na versão com tag | Tag da versão | +| Carga de evento webhook | Tipos de atividade | `GITHUB_SHA` | `GITHUB_REF` | +| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- | ------------- | +| [`versão`](/webhooks/event-payloads/#release) | - `publicado`
    - `não publicado`
    - `criado`
    - `editado`
    - `excluído`
    - `pré-lançado`
    - `lançado` | Último commit na versão com tag | Tag da versão | {% data reusables.developer-site.limit_workflow_to_activity_types %} @@ -558,85 +669,6 @@ on: - requested ``` -### Eventos programados - -O evento `agenda` permite que você acione um fluxo de trabalho em um horário agendado. - -#### `schedule` - -| Carga de evento webhook | Tipos de atividade | `GITHUB_SHA` | `GITHUB_REF` | -| ----------------------- | ------------------ | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| n/a | n/a | Último commit no branch padrão | Branch padrão | Quando a execução do fluxo de trabalho programado é definida. Um fluxo de trabalho programado usa a [sintaxe cron POSIX](https://pubs.opengroup.org/onlinepubs/9699919799/utilities/crontab.html#tag_20_25_07). Para obter mais informações, consulte "[Acionar um fluxo de trabalho com eventos](/articles/configuring-a-workflow/#triggering-a-workflow-with-events)". | - -{% data reusables.repositories.actions-scheduled-workflow-example %} - -A sintaxe cron tem cinco campos separados por um espaço, e cada campo representa uma unidade de tempo. - -``` -┌───────────── minuto (0 - 59) -│ ┌───────────── hora (0 - 23) -│ │ ┌───────────── dia do mês (1 - 31) -│ │ │ ┌───────────── mês (1 - 12 ou JAN-DEZ) -│ │ │ │ ┌───────────── dia da semana (0 - 6 ou DOM-SAB) -│ │ │ │ │ -│ │ │ │ │ -│ │ │ │ │ -* * * * * -``` - -Você pode usar estes operadores em qualquer um dos cinco campos: - -| Operador | Descrição | Exemplo | -| -------- | --------------------------- | ----------------------------------------------------------------------------------------------- | -| * | Qualquer valor | `* * * * *` executa cada minuto de todos os dias. | -| , | Separador de lista de valor | `2,10 4,5 * * *` executa no minuto 2 e 10 da quarta e quinta hora de todos os dias. | -| - | Intervalo de valores | `0 4-6 * * *` executa no minuto 0 da quarta, quinta e sexta hora. | -| / | Valores de etapa | `20/15 * * * *` executa a cada 15 minutos começando do miuto 20 até o 59 (minutos 20, 35 e 50). | - -{% note %} - -**Observação:** o {% data variables.product.prodname_actions %} não é compatível com a sintaxe não padrão `@yearly`, `@monthly`, `@weekly`, `@daily`, `@hourly` e `@reboot`. - -{% endnote %} - -Você pode usar [crontab guru](https://crontab.guru/) para ajudar a gerar a sintaxe cron e confirmar a hora em que ela será executada. Para ajudar você a começar, há também uma lista de [exemplos de crontab guru](https://crontab.guru/examples.html). - -### Eventos manuais - -Você pode acionar as execuções de fluxo de trabalho manualmente. Para acionar fluxos de trabalho específicos em um repositório, use o evento `workflow_dispatch`. Para acionar mais de um fluxo de trabalho em um repositório e criar eventos personalizados e tipos de eventos, use o evento `repository_dispatch`. - -#### `workflow_dispatch` - -| Carga de evento webhook | Tipos de atividade | `GITHUB_SHA` | `GITHUB_REF` | -| ---------------------------------------------------------------- | ------------------ | --------------------------------------------- | ------------------------ | -| [workflow_dispatch](/webhooks/event-payloads/#workflow_dispatch) | n/a | Último commit de merge no branch `GITHUB_REF` | Branch que recebeu envio | - -Você pode acionar manualmente uma execução de fluxo de trabalho usando a API do {% data variables.product.product_name %} e do {% data variables.product.product_name %}. Para acionar o evento do webhook `workflow_dispatch` usando a API REST, você deve enviar uma solicitação `POST` para um ponto de extremidade da API do {% data variables.product.prodname_dotcom %} e fornecer o `ref` e qualquer `entrada` necessária. Para obter mais informações, consulte o ponto de extremidade da API REST "[Criar um evento de envio de fluxo de trabalho](/rest/reference/actions/#create-a-workflow-dispatch-event)". - - Ao ativar o evento em {% data variables.product.prodname_dotcom %}, você poderá fornecer a `ref` e quaisquer `entradas` diretamente no {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte "[Configurar fluxo de trabalho](/actions/configuring-and-managing-workflows/configuring-a-workflow#manually-running-a-workflow)." - -#### `repository_dispatch` - -| Carga de evento webhook | Tipos de atividade | `GITHUB_SHA` | `GITHUB_REF` | -| -------------------------------------------------------------------- | ------------------ | --------------------------------------------- | ------------------------ | -| [repository_dispatch](/webhooks/event-payloads/#repository_dispatch) | n/a | Último commit de merge no branch `GITHUB_REF` | Branch que recebeu envio | - -{% data reusables.github-actions.branch-requirement %} - -Você pode usar a API do {% data variables.product.product_name %} para acionar um evento do webhook denominado [`repository_dispatch`](/webhooks/event-payloads/#repository_dispatch) quando quiser acionar um fluxo de trabalho para uma atividade que ocorre fora do {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte "[Criar um evento de despacho de repositório](/v3/repos/#create-a-repository-dispatch-event)." - -Para acionar o evento webhook `repository_dispatch` personalizado, envie uma solicitação `POST` para um ponto de extremidade da API do {% data variables.product.product_name %} e forneça um nome de `event_type` para descrever o tipo de atividade. Para acionar a execução de um fluxo de trabalho, configure também o fluxo de trabalho para usar o evento `repository_dispatch`. - -##### Exemplo - -Por padrão, todos os `event_types` acionam a execução de um fluxo de trabalho. É possível limitar a execução do fluxo de trabalho quando um valor `event_type` específico for enviado na carga do webhook `repository_dispatch`. Você define os tipos de eventos enviados na carga `repository_dispatch` ao criar o evento de despacho de repositório. - -```yaml -em: - repository_dispatch: - tipos: [opened, deleted] -``` - ### Acionar novos fluxos de trabalho usando um token de acesso pessoal {% data reusables.github-actions.actions-do-not-trigger-workflows %} Para obter mais informações, consulte "[Efetuando a autenticação com o GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)". diff --git a/translations/pt-BR/content/actions/reference/index.md b/translations/pt-BR/content/actions/reference/index.md index f5c2b8a8cac0..3c098b0320b4 100644 --- a/translations/pt-BR/content/actions/reference/index.md +++ b/translations/pt-BR/content/actions/reference/index.md @@ -1,6 +1,8 @@ --- title: Referência -intro: 'Documentação de referência para ações de criação, criação de fluxos de trabalho e outras ferramentas e informações em {% data variables.product.prodname_actions %}.' +intro: 'Documentação de referência para criar fluxos de trabalho, usando executores hospedados no GitHub e autenticação.' +redirect_from: + - /actions/configuring-and-managing-workflows/using-variables-and-secrets-in-a-workflow versions: free-pro-team: '*' enterprise-server: '>=2.22' @@ -9,9 +11,39 @@ versions: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} +### Sintaxe de fluxo de trabalho + +O arquivo do fluxo de trabalho foi escrito em YAML. No arquivo de fluxo de trabalho de YAML, é possível usar a sintaxe de expressão para avaliar informações contextuais, literais, operadores e funções. As informações contextuais incluem fluxo de trabalho, variáveis de ambiente, segredos e eventos que acionaram o fluxo de trabalho. Ao usar [`executar`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun) em um fluxo de trabalho para executar comandos de shell, você pode usar uma sintaxe específica de comando de fluxo de trabalho para definir variáveis de ambiente, definir parâmetros de saída para etapas subsequentes e definir erros ou mensagens de depuração. + {% link_in_list /workflow-syntax-for-github-actions %} -{% link_in_list /events-that-trigger-workflows %} {% link_in_list /context-and-expression-syntax-for-github-actions %} {% link_in_list /workflow-commands-for-github-actions %} -{% link_in_list /virtual-environments-for-github-hosted-runners %} -{% link_in_list /software-installed-on-github-hosted-runners %} + +### Eventos + +Você pode configurar fluxos de trabalho para serem executados quando eventos específicos do GitHub ocorrerem, em um horário agendado, manualmente ou quando eventos estiverem fora do GitHub. + +{% link_in_list /events-that-trigger-workflows %} + +### Autenticação e segredos + +{% data variables.product.prodname_dotcom %} fornece um token que você pode usar para autenticar em nome de {% data variables.product.prodname_actions %}. Você também pode armazenar informações confidenciais como um segredo na sua organização ou repositório. {% data variables.product.prodname_dotcom %} criptografa todos os segredos. + +{% link_in_list /authentication-in-a-workflow %} +{% link_in_list /encrypted-secrets %} + +### Runners hospedados no {% data variables.product.prodname_dotcom %} + +O GitHub oferece máquinas virtuais hospedadas para executar fluxos de trabalho. A máquina virtual contém um ambiente com ferramentas, pacotes e variáveis de ambiente para o GitHub Actions usar. + +{% link_in_list /environment-variables %} +{% link_in_list /specifications-for-github-hosted-runners %} + +{% if currentVersion == "free-pro-team@latest" %} +### Administração + +Ao executar fluxos de trabalho em executores hospedados em {% data variables.product.prodname_dotcom %}, existem limites de uso e taxas de uso em potencial. Você também pode desabilitar ou restringir o uso de {% data variables.product.prodname_actions %} em um repositório e organização. + +{% link_in_list /usage-limits-billing-and-administration %} + +{% endif %} diff --git a/translations/pt-BR/content/actions/reference/specifications-for-github-hosted-runners.md b/translations/pt-BR/content/actions/reference/specifications-for-github-hosted-runners.md new file mode 100644 index 000000000000..7c9a854e15a9 --- /dev/null +++ b/translations/pt-BR/content/actions/reference/specifications-for-github-hosted-runners.md @@ -0,0 +1,149 @@ +--- +title: Especificações para executores hospedados no GitHub +intro: 'O {% data variables.product.prodname_dotcom %} oferece máquinas virtuais hospedadas para executar fluxos de trabalho. A máquina virtual tem um ambiente de ferramentas, pacotes e configurações disponíveis para uso no {% data variables.product.prodname_actions %}.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /articles/virtual-environments-for-github-actions + - /github/automating-your-workflow-with-github-actions/virtual-environments-for-github-actions + - /github/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners + - /actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners + - /actions/reference/virtual-environments-for-github-hosted-runners + - /actions/reference/software-installed-on-github-hosted-runners +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Sobre os executores hospedados no {% data variables.product.prodname_dotcom %} + +Um executor hospedado no {% data variables.product.prodname_dotcom %} é uma máquina virtual hospedada pelo {% data variables.product.prodname_dotcom %} com o aplicativo do executor {% data variables.product.prodname_actions %} instalado. O {% data variables.product.prodname_dotcom %} oferece executores com os sistemas operacionais Linux, Windows e macOS. + +Ao usar um executor hospedada no {% data variables.product.prodname_dotcom %}, a manutenção e as atualizações da máquina são feitas para você. É possível executar fluxos de trabalho diretamente na máquina virtual ou em um contêiner Docker. + +Você pode especificar o tipo de executor para cada trabalho em um fluxo de trabalho. Cada trabalho em um fluxo de trabalho é executado em uma nova instância da máquina virtual. Todas as etapas de um trabalho são executadas na mesma instância da máquina virtual, o que permite que ações de cada trabalho compartilhem informações usando o sistema de arquivos. + +{% data reusables.github-actions.runner-app-open-source %} + +#### Hosts da nuvem para os executores hospedados em {% data variables.product.prodname_dotcom %} + +O {% data variables.product.prodname_dotcom %} hospeda executores do Linux e Windows no Standard_DS2_v2 máquinas virtuais no Microsoft Azure com o aplicativo do executor {% data variables.product.prodname_actions %} instalado. A o aplicativo do executor hospedado no {% data variables.product.prodname_dotcom %} é uma bifurcação do agente do Azure Pipelines. Os pacotes ICMP de entrada estão bloqueados para todas as máquinas virtuais do Azure. Portanto, é possível que os comandos ping ou traceroute não funcionem. Para obter mais informações sobre os recursos da máquina Standard_DS2_v2, consulte "[Dv2 e DSv2-series](https://docs.microsoft.com/en-us/azure/virtual-machines/dv2-dsv2-series#dsv2-series)" na documentação do Microsoft Azure. + +O {% data variables.product.prodname_dotcom %} usa [MacStadium](https://www.macstadium.com/) para hospedar os executores do macOS. + +#### Privilégios administrativos os executores hospedados no {% data variables.product.prodname_dotcom %} + +As máquinas virtuais Linux e macOS executam usando autenticação sem senha `sudo`. Quando precisar executar comandos ou instalar ferramentas que exigem mais permissões que o usuário atual possui, você pode usar `sudo` sem a necessidade de fornecer uma senha. Para obter mais informações, consulte o "[Manual do Sudo](https://www.sudo.ws/man/1.8.27/sudo.man.html)". + +As máquinas virtuais do Windows estão configuradas para ser executadas como administradores com Controle de Conta de Usuário (UAC) desativado. Para obter mais informações, consulte "[Como funciona o Controle de Conta de Usuário](https://docs.microsoft.com/en-us/windows/security/identity-protection/user-account-control/how-user-account-control-works)" na documentação do Windows. + +### Executores e recursos de hardware compatíveis + +Cada máquina virtual tem os mesmos recursos de hardware disponíveis. + +- CPU dual core +- 7 GB de memória RAM +- 14 GB de espaço de disco SSD + +{% data reusables.github-actions.supported-github-runners %} + +{% data reusables.github-actions.ubuntu-runner-preview %} + +Lista de registros de fluxo de trabalho do executor usado para executar um trabalho. Para obter mais informações, consulte "[Visualizar histórico de execução de fluxo de trabalho](/actions/managing-workflow-runs/viewing-workflow-run-history)". + +### Software compatível + +As ferramentas do software incluídas em executores hospedados em {% data variables.product.prodname_dotcom %} são atualizadas semanalmente. Para a lista mais recente das ferramentas incluídas para cada sistema operacional do executor, consulte os links abaixo: + +* [Ubuntu 20.04 LTS](https://github.com/actions/virtual-environments/blob/main/images/linux/Ubuntu2004-README.md) +* [Ubuntu 18.04 LTS](https://github.com/actions/virtual-environments/blob/main/images/linux/Ubuntu1804-README.md) +* [Ubuntu 16.04 LTS](https://github.com/actions/virtual-environments/blob/main/images/linux/Ubuntu1604-README.md) +* [Windows Server 2019](https://github.com/actions/virtual-environments/blob/main/images/win/Windows2019-Readme.md) +* [Windows Server 2016](https://github.com/actions/virtual-environments/blob/main/images/win/Windows2016-Readme.md) +* [MacOS 10.15](https://github.com/actions/virtual-environments/blob/main/images/macos/macos-10.15-Readme.md) + +{% data reusables.github-actions.ubuntu-runner-preview %} + +Executores hospedados no {% data variables.product.prodname_dotcom %} incluem as ferramentas integradas padrão do sistema operacional, além dos pacotes listados nas referências acima. Por exemplo, os executores do Ubuntu e do macOS incluem `grep`, `find` e `which`, entre outras ferramentas-padrão. + +Os registros do fluxo de trabalho incluem um link para as ferramentas pré-instaladas no executor. Para obter mais informações, consulte "[Visualizar histórico de execução de fluxo de trabalho](/actions/managing-workflow-runs/viewing-workflow-run-history)". + +Se houver uma ferramenta que você queira solicitar, abra um problema em [actions/virtual-environments](https://github.com/actions/virtual-environments). + +### Endereços IP + +{% note %} + +**Observação:** Se você usar uma lista de permissões de endereço IP para a sua organização ou conta corporativa de {% data variables.product.prodname_dotcom %}, você não poderá usar executores hospedados em {% data variables.product.prodname_dotcom %}. Em vez disso, deverá usar executores auto-hospedados. Para obter mais informações, consulte "[Sobre os executores auto-hospedados](/actions/hosting-your-own-runners/about-self-hosted-runners)." + +{% endnote %} + +Executores do Windows e Ubuntu são hospedados no Azure e têm os mesmos intervalos de endereços IP dos centros de dados Azure. Atualmente, todos os executores hospedados em {% data variables.product.prodname_dotcom %} do Windows e Ubuntu encontram-se nas seguintes regiões do Azure: + +- Leste dos EUA (`eastus`) +- Leste dos EUA 2 (`eastus2`) +- Oeste dos EU 2 (`westus2`) +- Centro dos EUA (`centralus`) +- Centro-sul dos EUA (`southcentralus`) + +A Microsoft atualiza os intervalos de endereços IP Azure semanalmente em um arquivo JSON que você pode baixar no site [Azure intervalos IP e tags de serviço - nuvem pública](https://www.microsoft.com/en-us/download/details.aspx?id=56519). Você pode usar esse intervalo de endereços IP se precisar de uma lista de permissão para evitar acesso não-autorizado em seus recursos internos. + +O arquivo JSON contém um array chamado `values` (valores). Dentro desse array, você pode encontrar os endereços IP suportados em um objeto com `nome` e `id` da região Azure, por exemplo `"AzureCloud. astus2"`. + +Você pode encontrar os intervalos de endereços IP compatíveis no objeto `"addressPrefixes"`. Este é um exemplo resumido do arquivo JSON. + +```json +{ + "changeNumber": 84, + "cloud": "Public", + "values": [ + { + "name": "AzureCloud.eastus2", + "id": "AzureCloud.eastus2", + "properties": { + "changeNumber": 33, + "region": "eastus2", + "platform": "Azure", + "systemService": "", + "addressPrefixes": [ + "13.68.0.0/17", + "13.77.64.0/18", + "13.104.147.0/25", + ... + ] + } + } + ] +} +``` + +### Sistemas de arquivos + +O {% data variables.product.prodname_dotcom %} executa ações e comandos de shell em diretórios específicos na máquina virtual. Os caminhos dos arquivos nas máquinas virtuais não são estáticos. Use as variáveis de ambiente que {% data variables.product.prodname_dotcom %} fornece para construir caminhos de arquivos para os diretórios `home`, `workspace` e `workflow`. + +| Diretório | Variável de ambiente | Descrição | +| --------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `casa` | `HOME` | Contém dados relacionados ao usuário. Por exemplo, esse diretório pode conter credenciais de uma tentativa de login. | +| `área de trabalho` | `GITHUB_WORKSPACE` | As ações e comandos do shell executados neste diretório. Uma ação pode modificar o conteúdo desse diretório, que fica acessível nas ações subsequentes. | +| `workflow/event.json` | `GITHUB_EVENT_PATH` | A carga `POST` do evento webhook que acionou o fluxo de trabalho. O {% data variables.product.prodname_dotcom %} o rescreve sempre que uma ação é executada para isolar o conteúdo do arquivo entre as ações. | + +Para obter uma lista das variáveis de ambiente que {% data variables.product.prodname_dotcom %} cria para cada fluxo de trabalho, consulte "[Usar variáveis de ambiente](/github/automating-your-workflow-with-github-actions/using-environment-variables)". + +#### Sistema de arquivos do contêiner Docker + +Ações executadas em contêineres Docker têm diretórios estáticos no caminho `/github`. No entanto, é altamente recomendável usar as variáveis de ambiente padrão para elaborar caminhos de arquivos em contêineres do Docker. + +O {% data variables.product.prodname_dotcom %} reserva o prefixo de caminho `/github` e cria três diretórios para ações. + +- `/github/home` +- `/github/workspace` - {% data reusables.repositories.action-root-user-required %} +- `/github/workflow` + +{% if currentVersion == "free-pro-team@latest" %} + +### Leia mais +- "[Gerenciar a cobrança para {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)" + +{% endif %} diff --git a/translations/pt-BR/content/actions/reference/usage-limits-billing-and-administration.md b/translations/pt-BR/content/actions/reference/usage-limits-billing-and-administration.md new file mode 100644 index 000000000000..a3a5ea800c9e --- /dev/null +++ b/translations/pt-BR/content/actions/reference/usage-limits-billing-and-administration.md @@ -0,0 +1,88 @@ +--- +title: 'Limites de uso, cobrança e administração' +intro: 'Existem limites de uso para fluxos de trabalho de {% data variables.product.prodname_actions %}. As taxas de uso são aplicadas a repositórios que vão além da quantidade de minutos grátis e armazenamento de um repositório.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /actions/getting-started-with-github-actions/usage-and-billing-information-for-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Sobre a cobrança do {% data variables.product.prodname_actions %} + +{% if currentVersion == "free-pro-team@latest" %} +{% data reusables.github-actions.actions-billing %} Para obter mais informações, consulte "[Sobre a cobrança do {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions)". +{% else %} +O uso do GitHub Actions é grátis para +{% data variables.product.prodname_ghe_server %} que usam executores auto-hospedados. +{% endif %} + +### Limites de uso + +{% if currentVersion == "free-pro-team@latest" %} +Existem alguns limites em +uso de {% data variables.product.prodname_actions %} ao usar executores hospedados em {% data variables.product.prodname_dotcom %}. Estes limites estão sujeitos a mudanças. + +{% note %} + +**Nota:** Para executores auto-hospedados, aplicam-se diferentes limites de uso. Para obter mais informações, consulte "[Sobre os executores auto-hospedados](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)." + +{% endnote %} + +- **Tempo de execução de tarefas ** - Cada trabalho em um fluxo de trabalho pode ser executado por até 6 horas de tempo de execução. Se um trabalho atingir esse limite, o trabalho será terminado e não será completado. +{% data reusables.github-actions.usage-workflow-run-time %} +{% data reusables.github-actions.usage-api-requests %} +- **Tarefas correntes** - O número de trabalhos simultâneos que você pode executar em sua conta depende do seu plano GitHub, conforme indicado na tabela a seguir. Se excedido, quaisquer tarefas adicionais serão colocadas na fila. + + | Plano GitHub | Total de tarefas simultâneas | Máximo de tarefas macOS simultâneas | + | ------------ | ---------------------------- | ----------------------------------- | + | Grátis | 20 | 5 | + | Pro | 40 | 5 | + | Equipe | 60 | 5 | + | Enterprise | 180 | 50 | +- **Matriz de vagas** - {% data reusables.github-actions.usage-matrix-limits %} +{% else %} +Os limites de uso aplicam-se a executores auto-hospedados. Para obter mais informações, consulte "[Sobre os executores auto-hospedados](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)." +{% endif %} + +{% if currentVersion == "free-pro-team@latest" %} +### Política de uso +Além dos limites de uso, você deve garantir que você usa + +{% data variables.product.prodname_actions %} dentro dos [Termos de Serviço do GitHub](/articles/github-terms-of-service/). Para obter mais informações sobre termos específicos de {% data variables.product.prodname_actions %}, consulte os [Termos adicionais do produto do GitHub](/github/site-policy/github-additional-product-terms#a-actions-usage). +{% endif %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +### Artefato e política de retenção de registro + +É possível configurar o artefato e o período de retenção de registro para o seu repositório, organização ou conta corporativa. + +{% data reusables.actions.about-artifact-log-retention %} + +Para obter mais informações, consulte: + +- [Configurar o período de retenção para {% data variables.product.prodname_actions %} para artefatos e registros no seu repositório](/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository) +- [Configurar o período de retenção para {% data variables.product.prodname_actions %} para artefatos e registros na sua organização](/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization) +- [Configurar o período de retenção para {% data variables.product.prodname_actions %} para artefatos e registros na sua empresa](/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account) +{% endif %} + +### Desativar ou limitar {% data variables.product.prodname_actions %} para o seu repositório ou organização + +{% data reusables.github-actions.disabling-github-actions %} + +Para obter mais informações, consulte: +- "[Desabilitar ou limitar {% data variables.product.prodname_actions %} para um repositório](/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository)" +- "[Desabilitar ou limitar {% data variables.product.prodname_actions %} para a sua organização](/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization)"{% if currentVersion == "free-pro-team@latest" %} +- "[Aplicar as políticas de {% data variables.product.prodname_actions %} na sua conta corporativa](/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account)" para {% data variables.product.prodname_ghe_cloud %}{% endif %} + +### Desabilitar e habilitar fluxos de trabalho + +Você pode habilitar e desabilitar os fluxos de trabalho individuais no seu repositório em {% data variables.product.prodname_dotcom %}. + +{% data reusables.actions.scheduled-workflows-disabled %} + +Para obter mais informações, consulte "[Desabilitar e habilitar um fluxo de trabalho](/actions/managing-workflow-runs/disabling-and-enabling-a-workflow)". diff --git a/translations/pt-BR/content/actions/reference/workflow-commands-for-github-actions.md b/translations/pt-BR/content/actions/reference/workflow-commands-for-github-actions.md index bce7c34070e0..002343cf6b74 100644 --- a/translations/pt-BR/content/actions/reference/workflow-commands-for-github-actions.md +++ b/translations/pt-BR/content/actions/reference/workflow-commands-for-github-actions.md @@ -21,7 +21,11 @@ versions: As ações podem comunicar-se com a máquina do executor para definir as variáveis de ambiente, valores de saída usados por outras ações, adicionar mensagens de depuração aos registros de saída e outras tarefas. +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +A maioria dos comandos de fluxo de trabalho usa o comando `echo` em um formato específico, enquanto outros são chamados escrevendo um arquivo. Para obter mais informações, consulte ["Arquivos de ambiente".](#environment-files) +{% else %} Os comandos do gluxo de trabalho usam o comando `echo` em um formato específico. +{% endif %} ``` bash echo "::workflow-command parameter1={data},parameter2={data}::{command value}" @@ -41,40 +45,46 @@ echo "::workflow-command parameter1={data},parameter2={data}::{command value}" ### Usar comandos do fluxo de trabalho para acessar funções do kit de de ferramentas -O [actions/toolkit](https://github.com/actions/toolkit) inclui uma quantidade de funções que podem ser executadas como comandos do fluxo de trabalho. Use a sintaxe `::` para executar os comandos do fluxo de trabalho no arquivo YAML. Em seguida, esses comandos serão enviados para a o executor por meio do `stdout`. Por exemplo, em vez de usar o código para definir uma variável de ambiente, como abaixo: +O [actions/toolkit](https://github.com/actions/toolkit) inclui uma quantidade de funções que podem ser executadas como comandos do fluxo de trabalho. Use a sintaxe `::` para executar os comandos do fluxo de trabalho no arquivo YAML. Em seguida, esses comandos serão enviados para a o executor por meio do `stdout`. Por exemplo, em vez de usar o código para definir uma saída, como abaixo: ```javascript -core.exportVariable('SELECTED_COLOR', 'green'); +core.setOutput('SELECTED_COLOR', 'green'); ``` -Você pode usar o comando `set-env` no seu fluxo de trabalho para definir o mesmo valor: +Você pode usar o comando `set-output` no seu fluxo de trabalho para definir o mesmo valor: ``` yaml - - nome: Define a cor selecionada - executar: echo '::set-env name=SELECTED_COLOR::green' - - nome: Get color - executar: echo 'A cor selecionada é ' $SELECTED_COLOR + - name: Set selected color + run: echo '::set-output name=SELECTED_COLOR::green' + id: random-color-generator + - name: Get color + run: echo 'The selected color is' ${steps.random-color-generator.outputs.SELECTED_COLOR} ``` A tabela a seguir mostra quais funções do conjunto de ferramentas estão disponíveis dentro de um fluxo de trabalho: -| Função do kit de ferramentas | Comando equivalente do fluxo de trabalho | -| ---------------------------- | ---------------------------------------------------------------- | -| `core.addPath` | `add-path` | -| `core.debug` | `debug` | -| `core.error` | `erro` | -| `core.endGroup` | `endgroup` | -| `core.exportVariable` | `set-env` | -| `core.getInput` | Acessível por meio do uso da variável de ambiente `INPUT_{NAME}` | -| `core.getState` | Acessível por meio do uso da variável de ambiente `STATE_{NAME}` | -| `core.isDebug` | Acessível por meio do uso da variável de ambiente `RUNNER_DEBUG` | -| `core.saveState` | `save-state` | -| `core.setFailed` | Usado como um atalho para `::error` e `exit 1` | -| `core.setOutput` | `set-output` | -| `core.setSecret` | `add-mask` | -| `core.startGroup` | `grupo` | -| `core.warning` | `arquivo de aviso` | - +| Função do kit de ferramentas | Comando equivalente do fluxo de trabalho | +| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | +| `core.addPath` | | +| {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}Accessible using environment file `GITHUB_PATH`{% else %} `add-path` {% endif %} | | +| | | +| `core.debug` | `debug` | +| `core.error` | `erro` | +| `core.endGroup` | `endgroup` | +| `core.exportVariable` | | +| {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}Accessible using environment file `GITHUB_ENV`{% else %} `set-env` {% endif %} | | +| | | +| `core.getInput` | Acessível por meio do uso da variável de ambiente `INPUT_{NAME}` | +| `core.getState` | Acessível por meio do uso da variável de ambiente `STATE_{NAME}` | +| `core.isDebug` | Acessível por meio do uso da variável de ambiente `RUNNER_DEBUG` | +| `core.saveState` | `save-state` | +| `core.setFailed` | Usado como um atalho para `::error` e `exit 1` | +| `core.setOutput` | `set-output` | +| `core.setSecret` | `add-mask` | +| `core.startGroup` | `grupo` | +| `core.warning` | `arquivo de aviso` | + +{% if currentVersion ver_lt "enterprise-server@2.23" %} ### Definir uma variável de ambiente `::set-env name={name}::{value}` @@ -86,6 +96,7 @@ Cria ou atualiza uma variável de ambiente para quaisquer ações a serem execut ``` bash echo "::set-env name=action_state::yellow" ``` +{% endif %} ### Definir um parâmetro de saída @@ -101,6 +112,7 @@ Opcionalmente, você também pode declarar os parâmetros de saída no arquivo d echo "::set-output name=action_fruit::strawberry" ``` +{% if currentVersion ver_lt "enterprise-server@2.23" %} ### Adicionar um caminho do sistema `::add-path::{path}` @@ -112,12 +124,13 @@ Agrega um diretório à variável de sistema `PATH` para todas as ações subseq ``` bash echo "::add-path::/path/to/dir" ``` +{% endif %} ### Configurar uma mensagem de depuração `::debug::{message}` -Imprime uma mensagem de erro no log. Você deve criar um segredo nomeado `ACTIONS_STEP_DEBUG` com o valor `true` para ver as mensagens de erro configuradas por esse comando no log. Para obter mais informações, consulte "[Gerenciar a execução de fluxos de trabalho](/actions/configuring-and-managing-workflows/managing-a-workflow-run#enabling-debug-logging)". +Imprime uma mensagem de erro no log. Você deve criar um segredo nomeado `ACTIONS_STEP_DEBUG` com o valor `true` para ver as mensagens de erro configuradas por esse comando no log. Para obter mais informações, consulte "[Habilitar o registro de depuração](/actions/managing-workflow-runs/enabling-debug-logging)". #### Exemplo @@ -141,7 +154,7 @@ echo "::warning file=app.js,line=1,col=5::Missing semicolon" `::error file={name},line={line},col={col}::{message}` -Cria uma mensagem de erro e a imprime no log. Como opção, você pode fornecer um nome de arquivo (`file`), número de linha (`line`) e número de coluna (`col`) onde o aviso ocorreu. +Cria uma mensagem de erro e a imprime no log. Cria uma mensagem de erro e a imprime no log. Como opção, você pode fornecer um nome de arquivo (`file`), número de linha (`line`) e número de coluna (`col`) onde o aviso ocorreu. #### Exemplo @@ -213,3 +226,67 @@ A variável `STATE_processID` está exclusivamente disponível para o script de ``` javascript console.log("O PID em execução a partir da ação principal é: " + process.env.STATE_processID); ``` + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +## Arquivos de Ambiente + +Durante a execução de um fluxo de trabalho, o executor gera arquivos temporários que podem ser usados para executar certas ações. O caminho para esses arquivos são expostos através de variáveis de ambiente. Você precisará usar a codificação UTF-8 ao escrever para esses arquivos para garantir o processamento adequado dos comandos. Vários comandos podem ser escritos no mesmo arquivo, separados por novas linhas. + +{% warning %} + +**Aviso:** O Powershell não usa UTF-8 por padrão. Certifique-se de escrever os arquivos usando a codificação correta. Por exemplo, você deve definir a codificação UTF-8 ao definir o caminho: + +``` +steps: + - run: echo "mypath" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append +``` + +{% endwarning %} + +### Definir uma variável de ambiente + +`echo "{name}={value}" >> $GITHUB_ENV` + +Cria ou atualiza uma variável de ambiente para quaisquer ações a serem executadas em seguida no trabalho. A ação que cria ou atualiza a variável de ambiente não tem acesso a um valor novo, mas todas as ações subsequentes em um trabalho terão. As variáveis de ambiente diferenciam maiúsculas de minúsculas e podem ter pontuação. + +#### Exemplo + +```bash +echo "action_state=yellow" >> $GITHUB_ENV +``` + +Executar `$action_state` em uma etapa futura agora retornará `amarelo` + +#### Strings de linha múltipla +Para strings linha múltipla, você pode usar um delimitador com a seguinte sintaxe. + +``` +{name}<<{delimiter} +{value} +{delimiter} +``` + +#### Exemplo +Neste exemplo, usamos `EOF` como um delimitador e definimos a variável de ambiente `JSON_RESPONSE` como o valor da resposta de curl. +``` +steps: + - name: Set the value + id: step_one + run: | + echo 'JSON_RESPONSE<> $GITHUB_ENV + curl https://httpbin.org/json >> $GITHUB_ENV + echo 'EOF' >> $GITHUB_ENV +``` + +### Adicionar um caminho do sistema + +`echo "{path}" >> $GITHUB_PATH` + +Agrega um diretório à variável de sistema `PATH` para todas as ações subsequentes no trabalho atual. A ação que está em execução não pode acessar a nova variável de caminho. + +#### Exemplo + +``` bash +echo "/path/to/dir" >> $GITHUB_PATH +``` +{% endif %} diff --git a/translations/pt-BR/content/actions/reference/workflow-syntax-for-github-actions.md b/translations/pt-BR/content/actions/reference/workflow-syntax-for-github-actions.md index 434539d1e558..3087efbc82fe 100644 --- a/translations/pt-BR/content/actions/reference/workflow-syntax-for-github-actions.md +++ b/translations/pt-BR/content/actions/reference/workflow-syntax-for-github-actions.md @@ -21,10 +21,6 @@ Arquivos de fluxo de trabalho usam sintaxe YAML e devem ter uma extensão de arq Você deve armazenar os arquivos de fluxo de trabalho no diretório `.github/workflows` do seu repositório. -### Limites de uso - -{% data reusables.github-actions.github-actions-usage-limits %} - ### **`name`** Nome do fluxo de trabalho. O {% data variables.product.prodname_dotcom %} exibe os nomes dos fluxos de trabalho na página de ações do repositório. Se você omitir o `nome`, o {% data variables.product.prodname_dotcom %} irá defini-lo como o caminho do arquivo do fluxo de trabalho relativo à raiz do repositório. @@ -60,17 +56,17 @@ As palavras-chave `branches`, `branches-ignore`, `tags` e `tags-ignore` aceitam Os padrões definidos nos `branches` e `tags` são avaliados relativamente ao nome do Git ref. Por exemplo, definir o padrão `mona/octocat` nos `branches` corresponde ao Git ref `refs/heads/mona/octocat`. O padrão `releases/**` corresponderá ao Git ref `refs/heads/releases/10`. ```yaml -em: +on: push: - # Sequência de padrões que correspondem a refs/heads + # Sequence of patterns matched against refs/heads branches: - # Push de eventos no branch-mestre - - mestre - # Push de eventos para branches que correspondem a refs/heads/mona/octocat + # Push events on main branch + - main + # Push events to branches matching refs/heads/mona/octocat - 'mona/octocat' - # Push de eventos para branches que correspondem a refs/heads/releases/10 + # Push events to branches matching refs/heads/releases/10 - 'releases/**' - # Sequência de padrões que correspondem a refs/tags + # Sequence of patterns matched against refs/tags tags: - v1 # Push events to v1 tag - v1.* # Push events to v1.0, v1.1, and v1.9 tags @@ -229,7 +225,7 @@ A execução de um fluxo de trabalho consiste em um ou mais trabalhos. Por padr Cada trabalho é executado em um ambiente especificado por `runs-on`. -Você pode executar quantos trabalhos desejar, desde que esteja dentro dos limites de uso do fluxo de trabalho. Para obter mais informações, consulte "[Limites de uso](#usage-limits)". +Você pode executar quantos trabalhos desejar, desde que esteja dentro dos limites de uso do fluxo de trabalho. Para obter mais informações, consulte "[Limites de uso e cobrança](/actions/reference/usage-limits-billing-and-administration)" para executores hospedados em {% data variables.product.prodname_dotcom %} e "[Sobre executores auto-hospedados](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)" para limites de uso de executores auto-hospedados. Se você precisar encontrar o identificador exclusivo de um trabalho e execução em um fluxo de trabalho, você poderá usar a API {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte "[Trabalhos do fluxo de trabalho](/v3/actions/workflow-jobs)". @@ -310,7 +306,7 @@ runs-on: [self-hosted, linux] Para obter mais informações, consulte "[Sobre executores auto-hospedados](/github/automating-your-workflow-with-github-actions/about-self-hosted-runners)" e "[Usar executores auto-hospedados em um fluxo de trabalho](/github/automating-your-workflow-with-github-actions/using-self-hosted-runners-in-a-workflow)." -### **`jobs..outputs`** +### **`jobs..outputs`** Um `mapa` de saídas para um trabalho. As saídas de trabalho estão disponíveis para todos os trabalhos downstream que dependem deste trabalho. Para obter mais informações sobre a definição de dependências de trabalhos, consulte [`jobs..needs`](#jobsjob_idneeds). @@ -393,7 +389,7 @@ Você pode usar a condicional `if` (se) para evitar que um trabalho seja executa Trabalhos contêm sequências de tarefas chamadas `steps`. As etapas podem executar comandos, executar trabalhos de configuração ou executar ações no seu repositório, em repositórios públicos, ou ações publicadas em registros do Docker. Nem todas as etapas executam ações, mas todas as ações são executadas como etapas. Cada etapa é executada em seu próprio processo no ambiente do executor, tendo acesso ao espaço de trabalho e ao sistema de arquivos. Como as etapas são executadas em seus próprios processos, as alterações nas variáveis de ambiente não são preservadas entre as etapas. O {% data variables.product.prodname_dotcom %} fornece etapas integradas para configurar e concluir trabalhos. -Você pode executar quantas etapas quiser, desde que esteja dentro dos limites de uso do fluxo de trabalho. Para obter mais informações, consulte "[Limites de uso](#usage-limits)". +Você pode executar quantas etapas quiser, desde que esteja dentro dos limites de uso do fluxo de trabalho. Para obter mais informações, consulte "[Limites de uso e cobrança](/actions/reference/usage-limits-billing-and-administration)" para executores hospedados em {% data variables.product.prodname_dotcom %} e "[Sobre executores auto-hospedados](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)" para limites de uso de executores auto-hospedados. #### Exemplo @@ -445,12 +441,12 @@ etapas: A função `my backup step` (minha etapa de backup) somente é executada quando houver falha em uma etapa anterior do trabalho. Para obter mais informações, consulte "[Contexto e sintaxe de expressão para {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions#job-status-check-functions)". ```yaml -etapas: - - nome: Minha primeira etapa - usa: monacorp/action-name@master - - nome: Minha etapa de backup - se: {% raw %}${{ failure() }}{% endraw %} - usa: actions/heroku@master +steps: + - name: My first step + uses: monacorp/action-name@main + - name: My backup step + if: {% raw %}${{ failure() }}{% endraw %} + uses: actions/heroku@master ``` #### **`jobs..steps.name`** @@ -464,7 +460,7 @@ Seleciona uma ação para executar como parte de uma etapa no trabalho. A ação É altamente recomendável incluir a versão da ação que você está usando ao especificar um número de tag Docker, SHA ou ref do Git. Se você não especificar uma versão, ela poderá interromper seus fluxos de trabalho ou causar um comportamento inesperado quando o proprietário da ação publicar uma atualização. - Usar o commit SHA de uma versão de ação lançada é a maneira mais garantida de obter estabilidade e segurança. - Usar a versão principal da ação permite receber correções importantes e patches de segurança sem perder a compatibilidade. Fazer isso também garante o funcionamento contínuo do fluxo de trabalho. -- Usar o branch `master` de uma ação pode ser conveniente, mas pode gerar problemas no fluxo de trabalho caso uma nova versão principal seja lançada. +- Usar o branch-padrão de uma ação pode ser conveniente, mas se alguém lançar uma nova versão principal com uma mudança significativa, seu fluxo de trabalho poderá ter problemas. Algumas ações requerem entradas que devem ser definidas com a palavra-chave [`with`](#jobsjob_idstepswith) (com). Revise o arquivo README da ação para determinar as entradas obrigatórias. @@ -473,15 +469,15 @@ Ações são arquivos JavaScript ou contêineres Docker. Se a ação em uso for ##### Exemplo usando ações com versão ```yaml -etapas: - # Referência a um commit específico - - usa: actions/setup-node@74bc508 - # Referência a uma versão principal da versão - - usa: actions/setup-node@v1 - # Referência a uma versão menor da versão - - usa: actions/setup-node@v1.2 - # Referência a um branch - - usa: actions/setup-node@master +steps: + # Reference a specific commit + - uses: actions/setup-node@74bc508 + # Reference the major version of a release + - uses: actions/setup-node@v1 + # Reference a minor version of a release + - uses: actions/setup-node@v1.2 + # Reference a branch + - uses: actions/setup-node@main ``` ##### Exemplo usando uma ação pública @@ -491,15 +487,15 @@ etapas: Você pode especificar um branch, ref ou SHA em um repositório público {% data variables.product.prodname_dotcom %}. ```yaml -trabalhos: +jobs: my_first_job: - etapas: - - nome: Minha primeira etapa - # Usa o branch-mestre de um repositório público - usa: actions/heroku@master - - nome: Minha segunda etapa - # Usa a tag de uma versão específica de um repositório público - usa: actions/aws@v2.0.1 + steps: + - name: My first step + # Uses the default branch of a public repository + uses: actions/heroku@master + - name: My second step + # Uses a specific version tag of a public repository + uses: actions/aws@v2.0.1 ``` ##### Exemplo usando uma ação pública em um subdiretório @@ -510,10 +506,10 @@ Subdiretório em um repositório público do {% data variables.product.prodname_ ```yaml jobs: - meu_primeiro_trabalho: + my_first_job: steps: - - name: minha primeira etapa - uses: actions/aws/ec2@master + - name: My first step + uses: actions/aws/ec2@main ``` ##### Exemplo usando a ação no mesmo repositório que o fluxo de trabalho @@ -599,11 +595,11 @@ Você pode anular as configurações padrão de shell no sistema operacional do | Plataforma compatível | Parâmetro `shell` | Descrição | Comando executado internamente | | --------------------- | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- | | Todas | `bash` | O shell padrão em plataformas que não sejam Windows como uma alternativa para `sh`. Ao especificar um shell bash no Windows, é utilizado o shell bash incluído no Git para Windows. | `bash --noprofile --norc -eo pipefail {0}` | -| Todas | `pwsh` | Powershell Core. O {% data variables.product.prodname_dotcom %} anexa a extensão `.ps1` ao nome do script. | `pwsh -command "& '{0}'"` | +| Todas | `pwsh` | Powershell Core. O {% data variables.product.prodname_dotcom %} anexa a extensão `.ps1` ao nome do script. | `pwsh -command ". '{0}'"` | | Todas | `python` | Executa o comando python. | `python {0}` | | Linux / macOS | `sh` | Comportamento alternativo para plataformas que não sejam Windows se nenhum shell for fornecido e o `bash` não for encontrado no caminho. | `sh -e {0}` | -| Windows | `cmd` | O {% data variables.product.prodname_dotcom %} anexa a extensão `.cmd` ao nome do script e a substitui por `{0}`. | `%ComSpec% /D /E:ON /V:OFF /S /C "CALL "{0}""`. | -| Windows | `powershell` | Essa é a shell padrão usada no Windows. PowerShell Desktop. O {% data variables.product.prodname_dotcom %} anexa a extensão `.ps1` ao nome do script. | `powershell -command "& '{0}'"`. | +| Windows | `cmd` | O {% data variables.product.prodname_dotcom %} anexa a extensão `.cmd` ao nome do script e a substitui por `{0}`. | `%ComSpec% /D /E:ON /V:OFF /S /C "CALL "{0}""`. | +| Windows | `powershell` | Essa é a shell padrão usada no Windows. PowerShell Desktop. O {% data variables.product.prodname_dotcom %} anexa a extensão `.ps1` ao nome do script. | `powershell -command ". '{0}'"`. | ##### Exemplo de execução de um script usando bash: @@ -675,10 +671,10 @@ Define os três parâmetros de entrada (`first_name`, `middle_name` e `last_name ```yaml jobs: - meu_primeiro_trabalho: + my_first_job: steps: - - name: Minha primeira etapa - uses: actions/hello_world@master + - name: My first step + uses: actions/hello_world@main with: first_name: Mona middle_name: The @@ -694,11 +690,11 @@ Uma `string` que define as entradas para um contêiner Docker. O {% data variabl {% raw %} ```yaml steps: - - name: Explica por que o trabalho foi executado - uses: monacorp/action-name@master + - name: Explain why this job ran + uses: monacorp/action-name@main with: entrypoint: /bin/echo - args: O evento ${{ github.event_name }} acionou esta etapa. + args: The ${{ github.event_name }} event triggered this step. ``` {% endraw %} @@ -708,7 +704,6 @@ steps: 1. Use padrões que permitam o uso da ação sem especificação de `args`. 1. Se a ação expõe um sinalizador `--help` ou similar, use isso como padrão para que a ação se documente automaticamente. - #### **`jobs..steps.with.entrypoint`** Anula o `ENTRYPOINT` Docker no `Dockerfile` ou define-o caso ainda não tenha sido especificado. Diferentemente da instrução Docker `ENTRYPOINT` que tem um formulário shell e exec, a palavra-chave `entrypoint` aceita apena uma única string que define o executável. @@ -718,7 +713,7 @@ Anula o `ENTRYPOINT` Docker no `Dockerfile` ou define-o caso ainda não tenha si ```yaml steps: - name: Run a custom command - uses: monacorp/action-name@master + uses: monacorp/action-name@main with: entrypoint: /a/different/executable ``` @@ -766,7 +761,7 @@ Estratégias criam matrizes de compilação para os trabalhos. Você pode defini Você pode definir uma matriz de diferentes configurações de trabalho. Uma matriz permite que você crie vários trabalhos que realizam a substituição de variável em uma definição de trabalho único. Por exemplo, você pode usar uma matriz para criar trabalhos para mais de uma versão compatível de uma linguagem de programação, sistema operacional ou ferramenta. Uma matriz reutiliza a configuração do trabalho e cria trabalho para cada matriz que você configurar. -{% data reusables.github-actions.matrix-limits %} +{% data reusables.github-actions.usage-matrix-limits %} Cada opção que você define na `matriz` tem uma chave e um valor. As chaves que você define tornam-se propriedades no contexto da `matriz` e você pode fazer referência à propriedade em outras áreas do seu arquivo de fluxo de trabalho. Por exemplo, se você definir a chave `os` que contém um array de sistemas operacionais, você poderá usar a propriedade `matrix.os` como o valor da palavra-chave `runs-on` para criar um trabalho para cada sistema operacional. Para obter mais informações, consulte "[Contexto e sintaxe de expressão para {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)". @@ -843,7 +838,6 @@ estratégia: Você pode usar `incluir` para adicionar novos trabalhos a uma matriz de criação. Qualquer configuração sem correspondência de incluir será adicionadas à matriz. Por exemplo, se você quiser usar a versão 12 do `nó` para compilar em vários sistemas operacionais, mas quiser uma tarefa experimental extra usando o node 13 no Ubuntu, você poderá usar `incluir` para especificar essa tarefa adicional. - {% raw %} ```yaml runs-on: ${{ matrix.os }} @@ -952,7 +946,25 @@ jobs: #### **`jobs..container.image`** -Imagem Docker a ser usada como contêiner para executar a ação. O valor pode ser o nome da imagem do Docker Hub ou um nome de registro do Docker público. +Imagem Docker a ser usada como contêiner para executar a ação. O valor pode ser o nome da imagem do Docker Hub ou um {% if currentVersion != "free-pro-team@latest" e currentVersion ver_lt "enterprise-server@2.23" %}nome de registro público{% endif %}. + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +#### **`jobs..container.credentials`** + +{% data reusables.actions.registry-credentials %} + +##### Exemplo + +{% raw %} +```yaml +container: + image: ghcr.io/owner/image + credentials: + username: ${{ github.actor }} + password: ${{ secrets.ghcr_token }} +``` +{% endraw %} +{% endif %} #### **`jobs..container.env`** @@ -1015,19 +1027,43 @@ serviços: - 6379/tcp ``` -#### **`jobs..services.image`** +#### **`jobs..services..image`** + +Imagem Docker a ser usada como contêiner de serviço para executar a ação. O valor pode ser o nome da imagem do Docker Hub ou um {% if currentVersion != "free-pro-team@latest" e currentVersion ver_lt "enterprise-server@2.23" %}nome de registro público{% endif %}. + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +#### **`jobs..services..credentials`** + +{% data reusables.actions.registry-credentials %} + +##### Exemplo -Imagem Docker a ser usada como contêiner de serviço para executar a ação. O valor pode ser o nome da imagem de base do Docker Hub ou um hub ou registro do Docker público. +{% raw %} +```yaml +services: + myservice1: + image: ghcr.io/owner/myservice1 + credentials: + username: ${{ github.actor }} + password: ${{ secrets.ghcr_token }} + myservice2: + image: dockerhub_org/myservice2 + credentials: + username: ${{ secrets.DOCKER_USER }} + password: ${{ secrets.DOCKER_PASSWORD }} +``` +{% endraw %} +{% endif %} -#### **`jobs..services.env`** +#### **`jobs..services..env`** Define um `maá` das variáveis de ambiente no contêiner do serviço. -#### **`jobs..services.ports`** +#### **`jobs..services..ports`** Define um `array` de portas para expor no contêiner de serviço. -#### **`jobs..services.volumes`** +#### **`jobs..services..volumes`** Define um `array` de volumes para uso do contêiner de serviço. É possível usar volumes para compartilhar dados entre serviços ou outras etapas em um trabalho. Você pode especificar volumes de nome Docker, volumes Docker anônimos ou vincular montagens no host. @@ -1046,7 +1082,7 @@ volumes: - /source/directory:/destination/directory ``` -#### **`jobs..services.options`** +#### **`jobs..services..options`** Opções adicionais de recursos do contêiner Docker. Para obter uma lista de opções, consulte "[opções `docker create`](https://docs.docker.com/engine/reference/commandline/create/#options)". @@ -1076,16 +1112,16 @@ Para obter mais informações sobre a sintaxe de filtros de branches, tags e cam #### Padrões para corresponder branches e tags -| Padrão | Descrição | Exemplos de correspondências | -| ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -| `feature/*` | O caractere curinga `*` corresponde a qualquer caractere, mas não à barra (`/`). | -`feature/my-branch`
    -`feature/your-branch` | -| `feature/**` | `**` correspondem a qualquer caractere, incluindo a barra (`/`) em nomes de branches e tags. | -`feature/beta-a/my-branch`
    -`feature/your-branch`
    -`feature/mona/the/octocat` | -| -`master`
    -`releases/mona-the-octcat` | Corresponde ao nome exato de um branch ou tag. | -`master`
    -`releases/mona-the-octocat` | -| `'*'` | Corresponde a todos os nomes de branches e tags que não contêm uma barra (`/`). O caractere `*` é um caractere especial em YAML. Ao inciar um padrão com `*`, você deve usar aspas. | -`master`
    -`releases` | -| `'**'` | Corresponde a todos os nomes de branches e tags. Esse é o comportamento padrão quando você não usa um filtro de `branches` ou `tags`. | -`all/the/branches`
    -`every/tag` | -| `'*feature'` | O caractere `*` é um caractere especial em YAML. Ao inciar um padrão com `*`, você deve usar aspas. | -`mona-feature`
    -`feature`
    -`ver-10-feature` | -| `v2*` | Corresponde aos nomes de branches e tags que iniciam com `v2`. | -`v2`
    -`v2.0`
    -`v2.9` | -| `v[12].[0-9]+.[0-9]+` | Corresponde a todas as tags de versão semântica com a versão principal 1 ou 2 | -`v1.10.1`
    -`v2.0.0` | +| Padrão | Descrição | Exemplos de correspondências | +| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | +| `feature/*` | O caractere curinga `*` corresponde a qualquer caractere, mas não à barra (`/`). | -`feature/my-branch`
    -`feature/your-branch` | +| `feature/**` | `**` correspondem a qualquer caractere, incluindo a barra (`/`) em nomes de branches e tags. | -`feature/beta-a/my-branch`
    -`feature/your-branch`
    -`feature/mona/the/octocat` | +| -`main`
    -`releases/mona-the-octcat` | Corresponde ao nome exato de um branch ou tag. | -`main`
    -`releases/mona-the-octocat` | +| `'*'` | Corresponde a todos os nomes de branches e tags que não contêm uma barra (`/`). O caractere `*` é um caractere especial em YAML. Ao inciar um padrão com `*`, você deve usar aspas. | -`main`
    -`releases` | +| `'**'` | Corresponde a todos os nomes de branches e tags. Esse é o comportamento padrão quando você não usa um filtro de `branches` ou `tags`. | -`all/the/branches`
    -`every/tag` | +| `'*feature'` | O caractere `*` é um caractere especial em YAML. Ao inciar um padrão com `*`, você deve usar aspas. | -`mona-feature`
    -`feature`
    -`ver-10-feature` | +| `v2*` | Corresponde aos nomes de branches e tags que iniciam com `v2`. | -`v2`
    -`v2.0`
    -`v2.9` | +| `v[12].[0-9]+.[0-9]+` | Corresponde a todas as tags de versão semântica com a versão principal 1 ou 2 | -`v1.10.1`
    -`v2.0.0` | #### Padrões para corresponder a caminhos de arquivos diff --git a/translations/pt-BR/content/admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider.md b/translations/pt-BR/content/admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider.md index 7b34dddb3b5b..cf497476a602 100644 --- a/translations/pt-BR/content/admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider.md +++ b/translations/pt-BR/content/admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider.md @@ -46,6 +46,6 @@ Quando aceitar o convite, o usuário poderá fazer login com seu próprio nome d ### Leia mais -- /enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap +- /enterprise/{{ page.version }}/admin/guides/user-management/using-ldap - [Usar SAML](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-saml) - [Usar CAS](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-cas) diff --git a/translations/pt-BR/content/admin/authentication/using-cas.md b/translations/pt-BR/content/admin/authentication/using-cas.md index 76496fdf31be..f38cbf60fa4b 100644 --- a/translations/pt-BR/content/admin/authentication/using-cas.md +++ b/translations/pt-BR/content/admin/authentication/using-cas.md @@ -5,7 +5,7 @@ redirect_from: - /enterprise/admin/articles/about-cas-authentication/ - /enterprise/admin/user-management/using-cas - /enterprise/admin/authentication/using-cas -intro: 'O CAS é um protocolo de logon único (SSO) para vários aplicativos da web. Uma conta de usuário CAS não consome uma {% if currentVersion ver_gt "enterprise-server@2.16" %}licença de{% else %}usuário{% endif %} até o usuário fazer login.' +intro: 'O CAS é um protocolo de logon único (SSO) para vários aplicativos da web. Uma conta de usuário CAS não ocupa uma {% if currentVersion ver_gt "enterprise-server@2.16" %}licença de usuário{% else %}estação{% endif %} até que o usuário se conecte.' versions: enterprise-server: '*' --- @@ -25,8 +25,8 @@ versions: Os atributos a seguir estão disponíveis. -| Nome do atributo | Tipo | Descrição | -| ----------------- | ----------- | --------------------------------------------------------------------------- | +| Nome do atributo | Tipo | Descrição | +| ----------------- | ----------- | ---------------------------------------------------------------------- | | `nome de usuário` | Obrigatório | Nome do usuário no {% data variables.product.prodname_ghe_server %}. | ### Configurar o CAS diff --git a/translations/pt-BR/content/admin/authentication/using-ldap.md b/translations/pt-BR/content/admin/authentication/using-ldap.md index 8d1985020bfa..defe408ae9f2 100644 --- a/translations/pt-BR/content/admin/authentication/using-ldap.md +++ b/translations/pt-BR/content/admin/authentication/using-ldap.md @@ -59,19 +59,19 @@ Use estes atributos para finalizar a configuração LDAP na {% data variables.pr | Nome do atributo | Tipo | Descrição | | --------------------------------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `Host` | Obrigatório | Host LDAP, por exemplo, `ldap.example.com` ou `10.0.0.30`. Se o nome do host só estiver disponível na rede interna, talvez seja necessário configurar antes o DNS da {% data variables.product.product_location_enterprise %} para que ele resolva o nome do host usando seus servidores de nomes internos. | +| `Host` | Obrigatório | Host LDAP, por exemplo, `ldap.example.com` ou `10.0.0.30`. Se o nome do host só estiver disponível na rede interna, talvez seja necessário configurar antes o DNS da {% data variables.product.product_location_enterprise %} para que ele resolva o nome do host usando seus servidores de nomes internos. | | `Porta` | Obrigatório | Porta em que os serviços de host LDAP estão escutando. Por exemplo: 389 e 636 (para LDAPS). | | `Criptografia` | Obrigatório | Método de criptografia usado para proteger as comunicações com o servidor LDAP. Por exemplo, básico (sem criptografia), SSL/LDAPS (criptografia desde o início) e StartTLS (atualizar para comunicação com criptografia no momento da conexão). | | `Usuário de pesquisa de domínio` | Opcional | Usuário LDAP que faz consultas de usuários para autenticar outros usuários quando eles fazem login. Em geral, é uma conta de serviço criada especificamente para integrações de terceiros. Use um nome totalmente qualificado, como `cn=Administrador,cn=Usuários,dc=Exemplo,dc=com`. Com o Active Directory, também é possível usar a sintaxe `[DOMAIN]\[USERNAME]` (por exemplo, `WINDOWS\Administrator`) para o usuário de pesquisa de domínio. | | `Senha de pesquisa de domínio` | Opcional | Senha do usuário de pesquisa de domínio. | | `Grupos de administradores` | Opcional | Ao fazerem login no seu appliance, os usuários deste grupo são promovidos a administradores do site. Se você não configurar um grupo de administradores LDAP, a primeira conta de usuário LDAP que acessar seu appliance será automaticamente promovida a administrador do site. | | `Base de domínio` | Obrigatório | `Distinguished Name` (DN) totalmente qualificado de uma subárvore LDAP em que você pretende procurar usuários e grupos. Você pode adicionar quantos quiser, mas cada grupo deve ser definido na mesma base de domínio que os usuários pertencentes a ele. Se você especificar grupos de usuários restritos, somente os usuários pertencentes a esses grupos estarão no escopo. É recomendável especificar o nível superior da sua árvore de diretórios LDAP como base de domínio e usar grupos de usuários restritos para controlar o acesso. | -| `Grupos de usuários restritos` | Opcional | Se especificados, somente os usuários desses grupos poderão efetuar login. Você só precisa especificar os nomes comuns (CNs, Common Names) dos grupos e adicionar quantos grupos quiser. Se não houver grupos especificados, *todos* os usuários no escopo da base de domínio especificada poderão fazer login na sua instância do {% data variables.product.prodname_ghe_server %}. | -| `ID de usuário` | Obrigatório | Atributo LDAP que identifica o usuário LDAP que tenta fazer a autenticação. Quando houver mapeamento estabelecido, os usuários poderão alterar seus nomes de usuário no {% data variables.product.prodname_ghe_server %}. Este campo deve ser `sAMAccountName` para a maioria das instalações do Active Directory, mas pode ser `uid` para outras soluções LDAP, como OpenLDAP. O valor padrão é `uid`. | -| `Nome de perfil` | Opcional | Nome exibido na págin de perfil do usuário no {% data variables.product.prodname_ghe_server %}. Se a Sincronização LDAP estiver habilitada, os usuários poderão alterar seus nomes de perfil. | -| `E-mails` | Opcional | Endereço de e-mail para a conta de usuário no {% data variables.product.prodname_ghe_server %}. | -| `Chaves SSH` | Opcional | Chaves SSH públicas vinculadas à conta de um usuário no {% data variables.product.prodname_ghe_server %}. As chaves devem estar no formato OpenSSH. | -| `Chaves GPG` | Opcional | Chaves GPG vinculadas à conta de um usuário no {% data variables.product.prodname_ghe_server %}. | +| `Grupos de usuários restritos` | Opcional | Se especificados, somente os usuários desses grupos poderão efetuar login. Você só precisa especificar os nomes comuns (CNs, Common Names) dos grupos e adicionar quantos grupos quiser. Se não houver grupos especificados, *todos* os usuários no escopo da base de domínio especificada poderão fazer login na sua instância do {% data variables.product.prodname_ghe_server %}. | +| `ID de usuário` | Obrigatório | Atributo LDAP que identifica o usuário LDAP que tenta fazer a autenticação. Quando houver mapeamento estabelecido, os usuários poderão alterar seus nomes de usuário no {% data variables.product.prodname_ghe_server %}. Este campo deve ser `sAMAccountName` para a maioria das instalações do Active Directory, mas pode ser `uid` para outras soluções LDAP, como OpenLDAP. O valor padrão é `uid`. | +| `Nome de perfil` | Opcional | Nome exibido na págin de perfil do usuário no {% data variables.product.prodname_ghe_server %}. Se a Sincronização LDAP estiver habilitada, os usuários poderão alterar seus nomes de perfil. | +| `E-mails` | Opcional | Endereço de e-mail para a conta de usuário no {% data variables.product.prodname_ghe_server %}. | +| `Chaves SSH` | Opcional | Chaves SSH públicas vinculadas à conta de um usuário no {% data variables.product.prodname_ghe_server %}. As chaves devem estar no formato OpenSSH. | +| `Chaves GPG` | Opcional | Chaves GPG vinculadas à conta de um usuário no {% data variables.product.prodname_ghe_server %}. | | `Desabilitar autenticação LDAP em operações no Git` | Opcional | Se estiver selecionada, essa opção [desativa](#disabling-password-authentication-for-git-operations) o recurso dos usuários para usar senhas LDAP a fim de autenticar as operações no Git. | | `Habilitar verificação certificada LDAP` | Opcional | Se estiver selecionada, essa opção [desativa](#enabling-ldap-certificate-verification) a verificação de certificado LDAP. | | `Sincronização` | Opcional | Se estiver selecionada, essa opção [ativa](#enabling-ldap-sync) a Sincronização LDAP. | @@ -97,6 +97,12 @@ Quando esta opção estiver selecionada, o certificado será validado para garan #### Habilitar a Sincronização LDAP +{% note %} + +**Observação:** As equipes que usam Sincronização LDAP são limitadas a um máximo de 1499 integrantes. + +{% endnote %} + A Sincronização LDAP permite sincronizar os usuários do {% data variables.product.prodname_ghe_server %} e a associação da equipe nos seus grupos LDAP estabelecidos. Assim, é possível estabelecer o controle de acesso baseado em função para os usuários do seu servidor LDAP, em vez de fazer isso manualmente no {% data variables.product.prodname_ghe_server %}. Para obter mais informações, consulte "[Criar equipes](/enterprise/{{ currentVersion }}/admin/guides/user-management/creating-teams#creating-teams-with-ldap-sync-enabled)". Para habilitar a Sincronização LDAP, selecione **Synchronize Emails** (Sincronizar e-mails), **Synchronize SSH Keys** (Sincronizar chaves SSH) ou **Synchronize GPG Keys** (Sincronizar chaves GPG) nas configurações LDAP. diff --git a/translations/pt-BR/content/admin/authentication/using-saml.md b/translations/pt-BR/content/admin/authentication/using-saml.md index d317e6269cf3..86d13394fa49 100644 --- a/translations/pt-BR/content/admin/authentication/using-saml.md +++ b/translations/pt-BR/content/admin/authentication/using-saml.md @@ -33,7 +33,7 @@ O elemento `NameID` é obrigatório, mesmo que os outros atributos estejam prese {% note %} -**Observação**: Se o `NameID` para um usuário for alterado no IdP, o usuário verá uma mensagem de erro ao tentar entrar na sua instância do {% data variables.product.prodname_ghe_server %}. {% if currentVersion ver_gt "enterprise-server@2.21" %}Para restaurar o acesso do usuário, você precisa atualizar o mapeamento do `NameID` da conta do usuário. Para obter mais informações, consulte "[Atualizar o `NameIDo`](#updating-a-users-saml-nameid) do SAML.{% else %} Para obter mais informações, consulte "[Erro: 'Outro usuário já possui a conta'](#error-another-user-already-owns-the-account)."{% endif %} +**Observação**: Se o `NameID` para um usuário for alterado no IdP, o usuário verá uma mensagem de erro ao tentar entrar na sua instância do {% data variables.product.prodname_ghe_server %}. {% if currentVersion ver_gt "enterprise-server@2.21" %}Para restaurar o acesso do usuário, você deverá atualizar o mapeamento de `NameID` da conta do usuário. Para obter mais informações, consulte "[Atualizar o `NameIDo`](#updating-a-users-saml-nameid) do SAML.{% else %} Para obter mais informações, consulte "[Erro: 'Outro usuário já possui a conta'](#error-another-user-already-owns-the-account)."{% endif %} {% endnote %} @@ -54,15 +54,15 @@ Para configurar seu provedor de identidade manualmente, a URL do serviço de con Os atributos a seguir estão disponíveis. Você pode alterar seus nomes no [console de gerenciamento](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-management-console/), exceto o atributo `administrator`. -| Nome padrão do atributo | Tipo | Descrição | -| ----------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Nome padrão do atributo | Tipo | Descrição | +| ----------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `NameID` | Obrigatório | Identificador de usuário persistente. Qualquer formato de identificador de nome persistente pode ser usado. O elemento `NameID` será usado para um nome de usuário do {% data variables.product.prodname_ghe_server %}, a menos que uma das declarações alternativas seja fornecida. | -| `administrador` | Opcional | Quando o valor for 'true', o usuário será promovido automaticamente como administrador. Qualquer outro valor ou um valor não existente rebaixará o usuário para uma conta regular. | +| `administrador` | Opcional | Quando o valor for 'true', o usuário será promovido automaticamente como administrador. Qualquer outro valor ou um valor não existente rebaixará o usuário para uma conta regular. | | `nome de usuário` | Opcional | Nome do usuário no {% data variables.product.prodname_ghe_server %}. | -| `full_name` | Opcional | Nome do usuário exibido na página de perfil. Após o provisionamento, os usuários podem alterar seus nomes. | -| `emails` | Opcional | Endereços de e-mail para o usuário. É possível especificar mais de um. | -| `public_keys` | Opcional | Chaves SSH públicas para o usuário. É possível especificar mais de um. | -| `gpg_keys` | Opcional | Chaves chaves GPG para o usuário. É possível especificar mais de um. | +| `full_name` | Opcional | Nome do usuário exibido na página de perfil. Após o provisionamento, os usuários podem alterar seus nomes. | +| `emails` | Opcional | Endereços de e-mail para o usuário. É possível especificar mais de um. | +| `public_keys` | Opcional | Chaves SSH públicas para o usuário. É possível especificar mais de um. | +| `gpg_keys` | Opcional | Chaves chaves GPG para o usuário. É possível especificar mais de um. | ### Definir configurações SAML @@ -88,7 +88,7 @@ Os atributos a seguir estão disponíveis. Você pode alterar seus nomes no [con {% if currentVersion ver_gt "enterprise-server@2.21" %} -### Revogar o acesso à {% data variables.product.product_location_enterprise %} +### Revogar o acesso à {{ site.data.variables.product.product_location_enterprise }} {% data reusables.enterprise_site_admin_settings.access-settings %} 2. Selecione **SAML**. ![Barra lateral "Todos os usuários" nas configurações de administrador do site](/assets/images/enterprise/site-admin-settings/all-users.png) @@ -144,7 +144,7 @@ Quando o usuário inicia a sessão novamente, {% data variables.product.prodname > Outro usuário já possui a conta. Solicite ao administrador que verifique o registro de autenticação. -De modo geral, a mensagem indica que o nome de usuário ou endereço de email da pessoa foi alterado no IdP. {% if currentVersion ver_gt "enterprise-server@2.21" %}Certifique-se de que o mapeamento do `NameID` para a conta do usuário no {% data variables.product.prodname_ghe_server %} corresponde ao `NameID` do usuário no seu IdP. Para obter mais informações, consulte "[Atualizar o `NameID`](#updating-a-users-saml-nameid) do SAML.{% else %}Para obter ajuda para atualizar o mapeamento do `NameID`, entre em contato com {% data variables.contact.contact_ent_support %}.{% endif %} +De modo geral, a mensagem indica que o nome de usuário ou endereço de email da pessoa foi alterado no IdP. {% if currentVersion ver_gt "enterprise-server@2. 1" %}Certifique-se de que o mapeamento de `NomeID` para a conta do usuário em {% data variables.product.prodname_ghe_server %} corresponde ao `NomeID` do usuário no seu IdP. Para obter mais informações, consulte "[Atualizar o `NameID`](#updating-a-users-saml-nameid) do SAML.{% else %}Para obter ajuda para atualizar o mapeamento do `NameID`, entre em contato com {% data variables.contact.contact_ent_support %}.{% endif %} #### Se a resposta SAML não estiver assinada ou se a assinatura não corresponder ao conteúdo, o log de autenticação mostrará a seguinte mensagem de erro: diff --git a/translations/pt-BR/content/admin/configuration/command-line-utilities.md b/translations/pt-BR/content/admin/configuration/command-line-utilities.md index 8ba5ed25618f..60a8f4dd7e62 100644 --- a/translations/pt-BR/content/admin/configuration/command-line-utilities.md +++ b/translations/pt-BR/content/admin/configuration/command-line-utilities.md @@ -20,7 +20,8 @@ Depois de entrar como usuário administrador com SSH, você pode executar esses Este utilitário insere um banner no topo de cada página do {% data variables.product.prodname_enterprise %}. Você pode usá-lo para enviar uma comunicação a todos os usuários. {% if currentVersion ver_gt "enterprise-server@2.21" %} -Você também pode definir um banner de anúncio usando as configurações empresariais no {% data variables.product.product_name %}. Para obter mais informações, consulte "[Personalizar mensagens de usuário na instância](/enterprise/admin/user-management/customizing-user-messages-on-your-instance#creating-a-global-announcement-banner)". +Você também pode definir um banner de anúncio usando as configurações corporativas em +{% data variables.product.product_name %}. Para obter mais informações, consulte "[Personalizar mensagens de usuário na instância](/enterprise/admin/user-management/customizing-user-messages-on-your-instance#creating-a-global-announcement-banner)". {% endif %} ```shell @@ -181,7 +182,6 @@ Este utilitário permite controlar o estado do modo de manutenção da instalaç ghe-maintenance -h ``` -{% if currentVersion ver_gt "enterprise-server@2.17" %} #### ghe-motd Este utilitário exibe novamente a mensagem do dia (MOTD) que os administradores veem quando acessam a instância através do shell administrativo. A saída contém uma visão geral do estado da instância. @@ -189,7 +189,6 @@ Este utilitário exibe novamente a mensagem do dia (MOTD) que os administradores ```shell ghe-motd ``` -{% endif %} #### ghe-nwo diff --git a/translations/pt-BR/content/admin/configuration/configuring-a-hostname.md b/translations/pt-BR/content/admin/configuration/configuring-a-hostname.md index bcb74ef31f80..7744f500b662 100644 --- a/translations/pt-BR/content/admin/configuration/configuring-a-hostname.md +++ b/translations/pt-BR/content/admin/configuration/configuring-a-hostname.md @@ -1,6 +1,6 @@ --- title: Configurar nome de host -intro: 'Em vez de usar um endereço IP codificado, é recomendável definir um nome de host para o seu appliance.' +intro: Em vez de usar um endereço IP codificado, é recomendável definir um nome de host para o seu appliance. redirect_from: - /enterprise/admin/guides/installation/configuring-hostnames/ - /enterprise/admin/installation/configuring-a-hostname diff --git a/translations/pt-BR/content/admin/configuration/configuring-applications.md b/translations/pt-BR/content/admin/configuration/configuring-applications.md index 1579f3f1ec17..fd2074b59d74 100644 --- a/translations/pt-BR/content/admin/configuration/configuring-applications.md +++ b/translations/pt-BR/content/admin/configuration/configuring-applications.md @@ -15,5 +15,7 @@ Você pode escolher por quanto tempo a {% data variables.product.product_locatio {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} 3. Na barra lateral esquerda, clique em **Applications** (Aplicativos). ![Guia Applications (Aplicativos) na barra lateral Settings (Configurações)](/assets/images/enterprise/management-console/sidebar-applications.png) -4. Em "Avatar image cache time (seconds)" (Tempo de cache para imagem do avatar [segundos]), digite por quantos segundos você deseja que a {% data variables.product.product_location_enterprise %} armazene as imagens do avatar em cache. ![Campo de formulário imagem de avatar em cache](/assets/images/enterprise/management-console/add-image-caching-value-field.png) +4. Em "Avatar de Cache de Imagem (segundos)", digite o número de segundos que você gostaria +{% data variables.product.product_location_enterprise %} para armazenar em cache imagens de avatar. +![Campo de formulário imagem de avatar em cache](/assets/images/enterprise/management-console/add-image-caching-value-field.png) {% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/pt-BR/content/admin/configuration/configuring-code-scanning-for-your-appliance.md b/translations/pt-BR/content/admin/configuration/configuring-code-scanning-for-your-appliance.md index 55cfdae9915a..f50161dfbfdf 100644 --- a/translations/pt-BR/content/admin/configuration/configuring-code-scanning-for-your-appliance.md +++ b/translations/pt-BR/content/admin/configuration/configuring-code-scanning-for-your-appliance.md @@ -37,7 +37,9 @@ Se você não puder ver **{% data variables.product.prodname_advanced_security % {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_management_console.advanced-security-tab %} -1. Em "{% data variables.product.prodname_advanced_security %}," clique em **{% data variables.product.prodname_code_scanning_capc %}**. ![Caixa de seleção para habilitar ou desabilitar {% data variables.product.prodname_code_scanning %}](/assets/images/enterprise/management-console/enable-code-scanning-checkbox.png) +1. Em " +{% data variables.product.prodname_advanced_security %}," clique em **{% data variables.product.prodname_code_scanning_capc %}**. +![Caixa de seleção para habilitar ou desabilitar {% data variables.product.prodname_code_scanning %}](/assets/images/enterprise/management-console/enable-code-scanning-checkbox.png) {% data reusables.enterprise_management_console.save-settings %} @@ -47,6 +49,8 @@ Se você não puder ver **{% data variables.product.prodname_advanced_security % Se você estiver inscrito no beta de {% data variables.product.prodname_actions %}, {% data variables.product.prodname_ghe_server %} poderá executar {% data variables.product.prodname_code_scanning %} usando um fluxo de trabalho de {% data variables.product.prodname_actions %}. Primeiro, você precisa fornecer um ou mais executores auto-hospedados de {% data variables.product.prodname_actions %} em seu ambiente. É possível fornecer executores auto-hospedados no nível da conta do repositório, organização ou empresa. Para obter mais informações, consulte "[Sobre executores auto-hospedados](/actions/hosting-your-own-runners/about-self-hosted-runners)" e "[Adicionar executores auto-hospedados](/actions/hosting-your-own-runners/adding-self-hosted-runners)". +Você deve garantir que o Git esteja na variável do PATH em qualquer executor auto-hospedados que você usar para executar ações de {% data variables.product.prodname_codeql %}. + #### Provisionar a ação Para executar {% data variables.product.prodname_code_scanning %} em {% data variables.product.prodname_ghe_server %} com {% data variables.product.prodname_actions %}, a ação apropriada deve estar disponível localmente. Você pode disponibilizar a ação de três maneiras. @@ -67,7 +71,7 @@ Depois de configurar um executor auto-hospedado, os usuários podem habilitar o ### Executar {% data variables.product.prodname_code_scanning %} usando o {% data variables.product.prodname_codeql_runner %} Se sua organização não está participando da versão beta do {% data variables.product.prodname_actions %} ou se você não desejar usar {% data variables.product.prodname_actions %}, você poderá executar {% data variables.product.prodname_code_scanning %} usando o {% data variables.product.prodname_codeql_runner %}. -O {% data variables.product.prodname_codeql_runner %} é uma ferramenta de linha de comando que você pode adicionar ao seu sistema CI/CD de terceiros. A ferramenta executa a análise do {% data variables.product.prodname_codeql %} em um checkout de um repositório do {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte "[Executar o {% data variables.product.prodname_code_scanning %} no seu sistema de CI](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)". +O {% data variables.product.prodname_codeql_runner %} é uma ferramenta de linha de comando que você pode adicionar ao seu sistema CI/CD de terceiros. A ferramenta executa a análise do {% data variables.product.prodname_codeql %} em um checkout de um repositório do {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte "[Executar o {% data variables.product.prodname_code_scanning %} no seu sistema de CI](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)". ### Desabilitar {% data variables.product.prodname_code_scanning %} @@ -76,5 +80,7 @@ O {% data variables.product.prodname_codeql_runner %} é uma ferramenta de linha {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_management_console.advanced-security-tab %} -1. Em "{% data variables.product.prodname_advanced_security %}", desmarque **{% data variables.product.prodname_code_scanning_capc %}**. ![Caixa de seleção para habilitar ou desabilitar {% data variables.product.prodname_code_scanning %}](/assets/images/enterprise/management-console/code-scanning-disable.png) +1. Em " +{% data variables.product.prodname_advanced_security %}", desmarque **{% data variables.product.prodname_code_scanning_capc %}**. +![Caixa de seleção para habilitar ou desabilitar {% data variables.product.prodname_code_scanning %}](/assets/images/enterprise/management-console/code-scanning-disable.png) {% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/pt-BR/content/admin/configuration/configuring-rate-limits.md b/translations/pt-BR/content/admin/configuration/configuring-rate-limits.md index c5c7a6107a3b..89d96f73a8f9 100644 --- a/translations/pt-BR/content/admin/configuration/configuring-rate-limits.md +++ b/translations/pt-BR/content/admin/configuration/configuring-rate-limits.md @@ -13,7 +13,7 @@ versions: Habilitar limites de taxa na {% data variables.product.prodname_enterprise_api %} pode impedir o uso excessivo de recursos por usuários individuais ou não autenticados. Para obter mais informações, consulte "[Recursos na API REST](/rest/overview/resources-in-the-rest-api#rate-limiting)". {% if currentVersion ver_gt "enterprise-server@2.21" %} -Habilitar limites de taxa na {% data variables.product.prodname_enterprise_api %} pode impedir o uso excessivo de recursos por usuários individuais ou não autenticados. Para obter mais informações, consulte "[Limitação de taxa](/enterprise/{{ currentVersion }}/v3/#rate-limiting)". +Habilitar limites de taxa na {{ site.data.variables.product.prodname_enterprise_api }} pode impedir o uso excessivo de recursos por usuários individuais ou não autenticados. Para obter mais informações, consulte "[Limitação de taxa](/enterprise/{{ page.version }}/v3/#rate-limiting)". {% endif %} {% note %} diff --git a/translations/pt-BR/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md b/translations/pt-BR/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md index d2d797c14c92..15f8c211977f 100644 --- a/translations/pt-BR/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md +++ b/translations/pt-BR/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md @@ -8,7 +8,15 @@ versions: enterprise-server: '*' --- +{% note %} + +**Observação:** Não suportamos a inclusão de adaptadores de rede adicionais para {% data variables.product.prodname_ghe_server %}. + +{% endnote %} + {% data reusables.enterprise_installation.open-vm-console-start %} 3. Escolha configurar o protocolo `IPv4` ou `IPv6`. ![Escolha entre os protocolos IPv4 ou IPv6](/assets/images/enterprise/network-configuration/IPv4-or-IPv6-protocol.png) 4. Configure as opções para o protocolo escolhido. ![Menu com opções de protocolo IP](/assets/images/enterprise/network-configuration/network-settings-selection.png) {% data reusables.enterprise_installation.vm-console-done %} + + diff --git a/translations/pt-BR/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md b/translations/pt-BR/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md index 578b200a35c1..ab7dcb7745e7 100644 --- a/translations/pt-BR/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md +++ b/translations/pt-BR/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md @@ -26,7 +26,7 @@ Ao conectar a {% data variables.product.product_location_enterprise %} ao {% dat - O nome do cliente da sua licença do {% data variables.product.prodname_ghe_server %}; - O nome de host da {% data variables.product.product_location_enterprise %}; - A versão da {% data variables.product.product_location_enterprise %}; -- A conta corporativa ou organização no {% data variables.product.prodname_dotcom_the_website %} conectada à {% data variables.product.product_location_enterprise %}; +- A conta da organização ou empresa em {% data variables.product.prodname_dotcom_the_website %} que estiver conectada a {% data variables.product.product_location_enterprise %} - O token de autenticação usado pela {% data variables.product.product_location_enterprise %} para fazer solicitações ao {% data variables.product.prodname_dotcom_the_website %}. Habilitar o {% data variables.product.prodname_github_connect %} também cria um {% data variables.product.prodname_github_app %} pertencente à sua conta corporativa ou organização do {% data variables.product.prodname_ghe_cloud %}. O {% data variables.product.prodname_ghe_server %} usa as credenciais do {% data variables.product.prodname_github_app %} para fazer solicitações ao {% data variables.product.prodname_dotcom_the_website %}. @@ -37,12 +37,12 @@ O {% data variables.product.prodname_ghe_server %} armazena as credenciais do {% Habilitar o {% data variables.product.prodname_github_connect %} não permitirá que os usuários do {% data variables.product.prodname_dotcom_the_website %} façam alterações no {% data variables.product.prodname_ghe_server %}. -{% if currentVersion ver_gt "enterprise-server@2.18" %} Para obter mais informações sobre o gerenciamento de contas corporativas usando a API GraphQL, consulte "[Contas corporativas](/v4/guides/managing-enterprise-accounts)". -{% endif %} ### Habilitar o {% data variables.product.prodname_github_connect %} -1. Entre na {% data variables.product.product_location_enterprise %} e no {% data variables.product.prodname_dotcom_the_website %}. +1. Fazer login em + +{% data variables.product.product_location_enterprise %} e {% data variables.product.prodname_dotcom_the_website %}. {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.settings-tab %} diff --git a/translations/pt-BR/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md b/translations/pt-BR/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md index 718a972e131f..e2d5058e0c6f 100644 --- a/translations/pt-BR/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md +++ b/translations/pt-BR/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md @@ -1,70 +1,65 @@ --- -title: Enabling alerts for vulnerable dependencies on GitHub Enterprise Server -intro: 'You can connect {% data variables.product.product_location_enterprise %} to {% data variables.product.prodname_ghe_cloud %} and enable {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies in repositories in your instance.' +title: Habilitar alertas para dependências vulneráveis no GitHub Enterprise Server +intro: 'Você pode conectar {% data variables.product.product_location_enterprise %} a {% data variables.product.prodname_ghe_cloud %} e habilitar {% if currentVersion ver_gt "enterprise-server@2. 1" %}{% data variables.product.prodname_dependabot_short %}{% else %}alertas de segurança{% endif %} para dependências vulneráveis nos repositórios na sua instância.' redirect_from: - /enterprise/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server - /enterprise/admin/configuration/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server - /enterprise/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server - - /enterprise/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server - - /enterprise/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server - - /enterprise/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server - - /enterprise/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server -permissions: 'Site administrators for {% data variables.product.prodname_ghe_server %} who are also owners of the connected {% data variables.product.prodname_ghe_cloud %} organization or enterprise account can enable {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %}.' +permissions: 'Os administradores do site de {% data variables.product.prodname_ghe_server %} que também são proprietários da organização ou conta corporativa conectada {% data variables.product.prodname_ghe_cloud %} podem habilitar {% if currentVersion ver_gt "enterprise-server@2. 1" %}{% data variables.product.prodname_dependabot_short %}{% else %}alertas de segurança{% endif %} para dependências vulneráveis em {% data variables.product.prodname_ghe_server %}.' versions: enterprise-server: '*' --- -### About alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %} +### Sobre alertas para dependências vulneráveis no {% data variables.product.prodname_ghe_server %} -{% data reusables.repositories.tracks-vulnerabilities %} For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." +{% data reusables.repositories.tracks-vulnerabilities %} Para obter mais informações, consulte "[Sobre alertas de dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)". -You can connect {% data variables.product.product_location_enterprise %} to {% data variables.product.prodname_dotcom_the_website %}, then sync vulnerability data to your instance and generate {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts in repositories with a vulnerable dependency. +Você pode conectar {% data variables.product.product_location_enterprise %} a {% data variables.product.prodname_dotcom_the_website %} e, em seguida, sincronizar os dados de vulnerabilidade na instância e gerar {% if currentVersion ver_gt "enterprise-server@2. 1" %}{% data variables.product.prodname_dependabot_short %}{% else %}alertas de segurança{% endif %} em repositórios com uma dependência vulnerável. -After connecting {% data variables.product.product_location_enterprise %} to {% data variables.product.prodname_dotcom_the_website %} and enabling {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies, vulnerability data is synced from {% data variables.product.prodname_dotcom_the_website %} to your instance once every hour. You can also choose to manually sync vulnerability data at any time. No code or information about code from {% data variables.product.product_location_enterprise %} is uploaded to {% data variables.product.prodname_dotcom_the_website %}. +Depois de conectar {% data variables.product.product_location_enterprise %} a {% data variables.product.prodname_dotcom_the_website %} e habilitar {% if currentVersion ver_gt "enterprise-server@2. 1" %}{% data variables.product.prodname_dependabot_short %}{% else %}alertas de segurança{% endif %} para dependências vulneráveis, os dados de vulnerabilidade serão sincronizados de {% data variables.product.prodname_dotcom_the_website %} para a sua instância uma vez por hora. Também é possível sincronizar os dados de vulnerabilidade manualmente a qualquer momento. Nenhum código ou informações sobre o código da {% data variables.product.product_location_enterprise %} são carregados para o {% data variables.product.prodname_dotcom_the_website %}. -{% if currentVersion ver_gt "enterprise-server@2.21" %}When {% data variables.product.product_location_enterprise %} receives information about a vulnerability, it will identify repositories in your instance that use the affected version of the dependency and send {% data variables.product.prodname_dependabot_short %} alerts to owners and people with admin access in those repositories. They can customize how they receive {% data variables.product.prodname_dependabot_short %} alerts. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/#configuring-notifications-for-github-dependabot-alerts)." +{% if currentVersion ver_gt "enterprise-server@2. 1" %}Quando {% data variables.product.product_location_enterprise %} recebe informações sobre uma vulnerabilidade, ele identificará repositórios na sua instância que usam a versão afetada da dependência e enviará alertas de {% data variables.product.prodname_dependabot_short %} para proprietários e pessoas com acesso de administrador nesses repositórios. Eles podem personalizar a forma como recebem os alertas de {% data variables.product.prodname_dependabot_short %}. Para obter mais informações, consulte "[Sobre alertas para dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/#configuring-notifications-for-github-dependabot-alerts)" {% endif %} -{% if currentVersion ver_lt "enterprise-server@2.21" or currentVersion == "enterprise-server@2.21" %}When {% data variables.product.product_location_enterprise %} receives information about a vulnerability, it will identify repositories in your instance that use the affected version of the dependency and send security alerts to owners and people with admin access in those repositories. They can customize how they receive security alerts. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/#configuring-notifications-for-security-alerts)." +{% if currentVersion ver_lt "enterprise-server@2.21" or currentVersion == "enterprise-server@2. 1" %}Quando {% data variables.product.product_location_enterprise %} recebe informações sobre uma vulnerabilidade, ele identificará repositórios na sua instância que usam a versão afetada da dependência e enviará alertas de segurança a proprietários e pessoas com acesso de administrador nesses repositórios. É possível personalizar o recebimento dos alertas de segurança. Para obter mais informações, consulte "[Sobre alertas para dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/#configuring-notifications-for-security-alerts)" {% endif %} {% if currentVersion ver_gt "enterprise-server@2.21" %} -### Enabling {% data variables.product.prodname_dependabot_short %} alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %} +### Habilitar alertas de {% data variables.product.prodname_dependabot_short %} para dependências vulneráveis em {% data variables.product.prodname_ghe_server %} {% else %} -### Enabling security alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %} +### Habilitar alertas de segurança para dependências vulneráveis no {% data variables.product.prodname_ghe_server %} {% endif %} -Before enabling {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies on {% data variables.product.product_location_enterprise %}, you must connect {% data variables.product.product_location_enterprise %} to {% data variables.product.prodname_dotcom_the_website %}. For more information, see "[Connecting {% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_ghe_cloud %}](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)." +Antes de habilitar {% if currentVersion ver_gt "enterprise-server@2. 1" %}{% data variables.product.prodname_dependabot_short %}{% else %}alertas de segurança{% endif %} de dependências vulneráveis em {% data variables.product.product_location_enterprise %}, você deve conectar {% data variables.product.product_location_enterprise %} a {% data variables.product.prodname_dotcom_the_website %}. Para obter mais informações, consulte "[Conectar o {% data variables.product.prodname_ghe_server %} ao {% data variables.product.prodname_ghe_cloud %}](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)". -{% if currentVersion ver_gt "enterprise-server@2.20" %} +{% if currentVersion ver_gt "enterprise-server@2.20" %} -{% if currentVersion ver_gt "enterprise-server@2.21" %}We recommend configuring {% data variables.product.prodname_dependabot_short %} alerts without notifications for the first few days to avoid an overload of emails. After a few days, you can enable notifications to receive {% data variables.product.prodname_dependabot_short %} alerts as usual.{% endif %} +{% if currentVersion ver_gt "enterprise-server@2.21" %}Recomendamos configurar alertas de {% data variables.product.prodname_dependabot_short %} sem notificações para os primeiros dias a fim de evitar uma sobrecarga de e-mails. Após alguns dias, você poderá habilitar as notificações para receber alertas de {% data variables.product.prodname_dependabot_short %}, como de costume.{% endif %} -{% if currentVersion == "enterprise-server@2.21" %}We recommend configuring security alerts without notifications for the first few days to avoid an overload of emails. After a few days, you can enable notifications to receive security alerts as usual.{% endif %} +{% if currentVersion == "enterprise-server@2.21" %}Recomendamos configurar alertas de segurança sem notificações nos primeiros dias para evitar uma sobrecarga de e-mails. Após alguns dias, você pode habilitar notificações para receber alertas de segurança como de costume.{% endif %} {% endif %} {% data reusables.enterprise_site_admin_settings.sign-in %} -1. In the administrative shell, enable the {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies on {% data variables.product.product_location_enterprise %}: +1. No shell administrativo, habilite os {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}alertas de segurança{% endif %} de dependências vulneráveis em {% data variables.product.product_location_enterprise %}: ``` shell $ ghe-dep-graph-enable ``` -3. Return to {% data variables.product.prodname_ghe_server %}. +3. Retornar para +{% data variables.product.prodname_ghe_server %}. {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.github-connect-tab %}{% if currentVersion ver_gt "enterprise-server@2.20" %} -5. Under "Repositories can be scanned for vulnerabilities", use the drop-down menu and select **Enabled without notifications**. Optionally, to enable alerts with notifications, select **Enabled with notifications**.{% else %} -5. Under "Repositories can be scanned for vulnerabilities", use the drop-down menu and select **Enabled**. +5. Em "Repositories can be scanned for vulnerabilities" (Os repositórios podem ser examinados para vulnerabilidades), use o menu suspenso e clique em **Enabled without notifications** (Habilitado sem notificações). Opcionalmente, para habilitar alertas com notificações, selecione **Enabled with notifications**(Habilitado com notificações).{% else %} +5. Em "Repositories can be scanned for vulnerabilities" (Verificar vulnerabilidades nos repositórios), use o menu suspenso e clique em **Enabled** (Habilitado). {% endif %} - ![Drop-down menu to enable scanning repositories for vulnerabilities](/assets/images/enterprise/site-admin-settings/enable-vulnerability-scanning-in-repositories.png) + ![Menu suspenso para habilitar a verificação vulnerabilidades nos repositórios](/assets/images/enterprise/site-admin-settings/enable-vulnerability-scanning-in-repositories.png) -### Viewing vulnerable dependencies on {% data variables.product.prodname_ghe_server %} +### Exibir dependências vulneráveis no {% data variables.product.prodname_ghe_server %} -You can view all vulnerabilities in {% data variables.product.product_location_enterprise %} and manually sync vulnerability data from {% data variables.product.prodname_dotcom_the_website %} to update the list. +Você pode exibir todas as vulnerabilidades na {% data variables.product.product_location_enterprise %} e sincronizar manualmente os dados de vulnerabilidade do {% data variables.product.prodname_dotcom_the_website %} para atualizar a lista. {% data reusables.enterprise_site_admin_settings.access-settings %} -2. In the left sidebar, click **Vulnerabilities**. - ![Vulnerabilities tab in the site admin sidebar](/assets/images/enterprise/business-accounts/vulnerabilities-tab.png) -3. To sync vulnerability data, click **Sync Vulnerabilities now**. - ![Sync vulnerabilities now button](/assets/images/enterprise/site-admin-settings/sync-vulnerabilities-button.png) +2. Na barra lateral esquerda, clique em **Vulnerabilities** (Vulnerabilidades). ![Guia Vulnerabilities (Vulnerabilidades) na barra lateral de administração do site](/assets/images/enterprise/business-accounts/vulnerabilities-tab.png) +3. Para sincronizar os dados de vulnerabilidade, clique em **Sync Vulnerabilities now** (Sincronizar vulnerabilidades agora). ![Botão Sync Vulnerabilities now (Sincronizar vulnerabilidades agora)](/assets/images/enterprise/site-admin-settings/sync-vulnerabilities-button.png) diff --git a/translations/pt-BR/content/admin/configuration/enabling-subdomain-isolation.md b/translations/pt-BR/content/admin/configuration/enabling-subdomain-isolation.md index efab5b6b072e..82b7c9bb2b41 100644 --- a/translations/pt-BR/content/admin/configuration/enabling-subdomain-isolation.md +++ b/translations/pt-BR/content/admin/configuration/enabling-subdomain-isolation.md @@ -16,28 +16,29 @@ O isolamento de subdomínios reduz os problemas de script entre sites e outras v Quando o isolamento do subdomínio está ativado, o {% data variables.product.prodname_ghe_server %} substitui vários caminhos pelos subdomínios. {% if currentVersion ver_gt "enterprise-server@2.21" %} -Para usar o Docker com {% data variables.product.prodname_registry %}, você deve habilitar o isolamento de subdomínio. Para obter mais informações, consulte "[Configurar Docker para uso com o {% data variables.product.prodname_registry %}](/enterprise/{{ currentVersion }}/user/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)". +Para usar o Docker com +{% data variables.product.prodname_registry %}, você também deve habilitar o isolamento de subdomínio. Para obter mais informações, consulte "[Configurar Docker para uso com o {% data variables.product.prodname_registry %}](/enterprise/{{ currentVersion }}/user/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)". {% data reusables.package_registry.packages-ghes-release-stage %} | {% endif %} -| Caminho sem isolamento de subdomínio | Caminho com isolamento de subdomínio | -| ------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- | -| `http(s)://HOSTNAME/assets/` | `http(s)://assets.HOSTNAME/` | -| `http(s)://HOSTNAME/avatars/` | `http(s)://avatars.HOSTNAME/` | -| `http(s)://HOSTNAME/codeload/` | `http(s)://codeload.HOSTNAME/` | -| `http(s)://HOSTNAME/gist/` | `http(s)://gist.HOSTNAME/` | -| `http(s)://HOSTNAME/media/` | `http(s)://media.HOSTNAME/` | -| `http(s)://HOSTNAME/pages/` | `http(s)://pages.HOSTNAME/` | -| `http(s)://HOSTNAME/raw/` | `http(s)://raw.HOSTNAME/` | -| `http(s)://HOSTNAME/render/` | `http(s)://render.HOSTNAME/` | -| `http(s)://HOSTNAME/reply/` | `http(s)://reply.HOSTNAME/` | -| `http(s)://HOSTNAME/uploads/` | `http(s)://uploads.HOSTNAME/` |{% if currentVersion ver_gt "enterprise-server@2.21" %} -| N/A, Docker com {% data variables.product.prodname_registry %} não funcionará com o isolamento de subdomínio desabilitado. | `http(s)://uploads.HOSTNAME/` | -| `https://HOSTNAME/_registry/npm/` | `https://npm.HOSTNAME/` | -| `https://HOSTNAME/_registry/rubygems/` | `https://rubygems.HOSTNAME/` | -| `https://HOSTNAME/_registry/maven/` | `https://maven.HOSTNAME/` | -| `https://HOSTNAME/_registry/nuget/` | `https://nuget.HOSTNAME/`{% endif %} +| Caminho sem isolamento de subdomínio | Caminho com isolamento de subdomínio | +| -------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | +| `http(s)://HOSTNAME/assets/` | `http(s)://assets.HOSTNAME/` | +| `http(s)://HOSTNAME/avatars/` | `http(s)://avatars.HOSTNAME/` | +| `http(s)://HOSTNAME/codeload/` | `http(s)://codeload.HOSTNAME/` | +| `http(s)://HOSTNAME/gist/` | `http(s)://gist.HOSTNAME/` | +| `http(s)://HOSTNAME/media/` | `http(s)://media.HOSTNAME/` | +| `http(s)://HOSTNAME/pages/` | `http(s)://pages.HOSTNAME/` | +| `http(s)://HOSTNAME/raw/` | `http(s)://raw.HOSTNAME/` | +| `http(s)://HOSTNAME/render/` | `http(s)://render.HOSTNAME/` | +| `http(s)://HOSTNAME/reply/` | `http(s)://reply.HOSTNAME/` | +| `http(s)://HOSTNAME/uploads/` | `http(s)://uploads.HOSTNAME/` |{% if currentVersion ver_gt "enterprise-server@2.21" %} +| N/A, Docker com {% data variables.product.prodname_registry %} não funcionará com o isolamento de subdomínio desabilitado. | `http(s)://uploads.HOSTNAME/` | +| `https://HOSTNAME/_registry/npm/` | `https://npm.HOSTNAME/` | +| `https://HOSTNAME/_registry/rubygems/` | `https://rubygems.HOSTNAME/` | +| `https://HOSTNAME/_registry/maven/` | `https://maven.HOSTNAME/` | +| `https://HOSTNAME/_registry/nuget/` | `https://nuget.HOSTNAME/`{% endif %} ### Pré-requisitos diff --git a/translations/pt-BR/content/admin/configuration/index.md b/translations/pt-BR/content/admin/configuration/index.md index 7bfd300511fb..12c6846c6e97 100644 --- a/translations/pt-BR/content/admin/configuration/index.md +++ b/translations/pt-BR/content/admin/configuration/index.md @@ -40,7 +40,7 @@ versions: {% topic_link_in_list /managing-connections-between-github-enterprise-server-and-github-enterprise-cloud %} {% link_in_list /connecting-github-enterprise-server-to-github-enterprise-cloud %} {% link_in_list /enabling-unified-search-between-github-enterprise-server-and-githubcom %} - {% link_in_list /enabling-unified-contributions-between-github-enterprise-server-and-githubcom %} + {% link_in_list /enabling-unified-contributions-between-github-enterprise-server-and-githubcom %} {% link_in_list /enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server %} {% link_in_list /enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud %} @@ -49,3 +49,11 @@ versions: {% topic_link_in_list /configuring-advanced-security-features %} {% link_in_list /configuring-code-scanning-for-your-appliance %} + +{% if currentVersion ver_gt "enterprise-server@2.21" %} +{% note %} + +**Observação:** Para configurar {% data variables.product.prodname_actions %} ou {% data variables.product.prodname_registry %} para sua empresa, veja "[Gerenciar o GitHub Actions para a sua empresa](/admin/github-actions)" ou "[Gerenciar pacotes do GitHub para a sua empresa](/admin/packages)". + +{% endnote %} +{% endif %} diff --git a/translations/pt-BR/content/admin/configuration/network-ports.md b/translations/pt-BR/content/admin/configuration/network-ports.md index 77a8ebb9f456..305a7c32a7ba 100644 --- a/translations/pt-BR/content/admin/configuration/network-ports.md +++ b/translations/pt-BR/content/admin/configuration/network-ports.md @@ -16,25 +16,25 @@ versions: Certas portas administrativas são obrigatórias para configurar a {% data variables.product.product_location_enterprise %} e executar determinados recursos. Não é preciso haver portas administrativas para os usuários finais aproveitarem os recursos básicos do aplicativo. -| Porta | Serviço | Descrição | -| -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Porta | Serviço | Descrição | +| -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 8443 | HTTPS | {% data variables.enterprise.management_console %} seguro na web. Obrigatória para instalação e configuração básicas. | | 8080 | HTTP | {% data variables.enterprise.management_console %} de texto simples na web. Não é obrigatória, a menos que o SSL seja desativado manualmente. | | 122 | SSH | Acesso de shell à {% data variables.product.product_location_enterprise %}. É obrigatório ficar aberta para conexões de entrada de todos os outros nós em configurações de Alta Disponibilidade. A porta SSH padrão (22) é dedicada ao tráfego de rede de aplicativos Git e SSH. | -| 1194/UDP | VPN | Túnel de rede de replicação segura em configurações de Alta Disponibilidade. É obrigatório ficar aberta para todos os outros nós na configuração. | -| 123/UDP | NTP | Obrigatória para operações de protocolo de tempo. | -| 161/UDP | SNMP | Obrigatória para operações de protocolo de monitoramento de rede. | +| 1194/UDP | VPN | Túnel de rede de replicação segura em configurações de Alta Disponibilidade. É obrigatório ficar aberta para todos os outros nós na configuração. | +| 123/UDP | NTP | Obrigatória para operações de protocolo de tempo. | +| 161/UDP | SNMP | Obrigatória para operações de protocolo de monitoramento de rede. | ### Portas de aplicativo para usuários finais As portas de aplicativo fornecem aplicativos da web e acesso dos usuários finais ao Git. -| Porta | Serviço | Descrição | -| ----- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------- | -| 443 | HTTPS | Acesso ao aplicativo da web e ao Git por HTTPS. | -| 80 | HTTP | Acesso ao aplicativo da web. Todas as solicitações são redirecionadas para a porta HTTPS quando o SSL está ativado. | -| 22 | SSH | Acesso ao Git por SSH. Compatível com operações de clonagem, fetch e push em repositórios públicos e privados. | -| 9418 | Git | A porta do protocolo Git é compatível com operações de clonagem e fetch em repositórios públicos com comunicação de rede não criptografada. | +| Porta | Serviço | Descrição | +| ----- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| 443 | HTTPS | Acesso ao aplicativo da web e ao Git por HTTPS. | +| 80 | HTTP | Acesso ao aplicativo da web. Todas as solicitações são redirecionadas para a porta HTTPS quando o SSL está ativado. | +| 22 | SSH | Acesso ao Git por SSH. Compatível com operações de clonagem, fetch e push em repositórios públicos e privados. | +| 9418 | Git | A porta do protocolo Git é compatível com operações de clonagem e fetch em repositórios públicos com comunicação de rede não criptografada. {% data reusables.enterprise_installation.when-9418-necessary %} {% data reusables.enterprise_installation.terminating-tls %} diff --git a/translations/pt-BR/content/admin/configuration/site-admin-dashboard.md b/translations/pt-BR/content/admin/configuration/site-admin-dashboard.md index e8b5ee006a1b..7394ee02c5d2 100644 --- a/translations/pt-BR/content/admin/configuration/site-admin-dashboard.md +++ b/translations/pt-BR/content/admin/configuration/site-admin-dashboard.md @@ -15,7 +15,7 @@ Para acessar o painel, clique em {% octicon "rocket" aria-label="The rocket ship ### Pesquisar -Neste espaço, é possível iniciar o {% data variables.enterprise.management_console %} para gerenciar configurações do appliance virtual, como domínio, autenticação e SSL. +Neste espaço, é possível iniciar o {{ site.data.variables.enterprise.management_console }} para gerenciar configurações do appliance virtual, como domínio, autenticação e SSL. {% else %} @@ -162,7 +162,7 @@ Esta categoria controla a forma como o índice [Problemas][] é reparado. Você ### Todos os usuários -Aqui você verá todos os usuários que foram suspensos da {% data variables.product.product_location_enterprise %} e poderá [iniciar uma auditoria de chave SSH](/enterprise/{{ currentVersion }}/admin/guides/user-management/auditing-ssh-keys). +Aqui você verá todos os usuários que foram suspensos da {{ site.data.variables.product.product_location_enterprise }} e poderá [iniciar uma auditoria de chave SSH](/enterprise/{{ page.version }}/admin/guides/user-management/auditing-ssh-keys). {% endif %} diff --git a/translations/pt-BR/content/admin/enterprise-management/about-geo-replication.md b/translations/pt-BR/content/admin/enterprise-management/about-geo-replication.md index 342647f9dfdd..276dcbdce0a1 100644 --- a/translations/pt-BR/content/admin/enterprise-management/about-geo-replication.md +++ b/translations/pt-BR/content/admin/enterprise-management/about-geo-replication.md @@ -18,7 +18,7 @@ As solicitações do Git e as solicitações específicas do servidor de arquivo ### Limitações -As solicitações de gravação para a réplica exigem o envio dos dados para o servidor principal e todas as réplicas. Ou seja, o desempenho de todas as gravações fica limitado pela réplica mais lenta {% if currentVersion ver_gt "enterprise-server@2.17" %}, embora as novas réplicas geográficas possam propagar a maioria de seus dados das réplicas geográficas localizadas existentes, em vez de propagar a partir do principal {% endif %}. A replicação geográfica não aumentará a capacidade de uma instância do {% data variables.product.prodname_ghe_server %} nem resolverá problemas de desempenho relacionados a CPU ou recursos de memória insuficientes. Se o appliance primário estiver offline, as réplicas ativas não poderão atender a solicitações de leitura ou gravação. +As solicitações de gravação para a réplica exigem o envio dos dados para o servidor principal e todas as réplicas. Isso significa que o desempenho de todas as gravações é limitado pela réplica mais lenta, embora novas georréplicas possam semear a maioria de seus dados a partir de georréplicas colocalizadas existentes, ao invés das primárias. A replicação geográfica não aumentará a capacidade de uma instância do {% data variables.product.prodname_ghe_server %} nem resolverá problemas de desempenho relacionados a CPU ou recursos de memória insuficientes. Se o appliance primário estiver offline, as réplicas ativas não poderão atender a solicitações de leitura ou gravação. ### Monitorar a configuração da replicação geográfica diff --git a/translations/pt-BR/content/admin/enterprise-management/about-high-availability-configuration.md b/translations/pt-BR/content/admin/enterprise-management/about-high-availability-configuration.md index 982bd84f9992..50e870c3917a 100644 --- a/translations/pt-BR/content/admin/enterprise-management/about-high-availability-configuration.md +++ b/translations/pt-BR/content/admin/enterprise-management/about-high-availability-configuration.md @@ -52,7 +52,7 @@ Para gerenciar a replicação no {% data variables.product.prodname_ghe_server % O comando `ghe-repl-setup` deixa o appliance do {% data variables.product.prodname_ghe_server %} em modo de espera de réplica. - - Um túnel criptografado {% if currentVersion ver_gt "enterprise-server@2.17" %}WireGuard VPN{% else %}OpenVPN{% endif %} é configurado para a comunicação entre os dois appliances. + - Um túnel VPN WireGuard criptografado é configurado para comunicação entre os dois aparelhos. - Os serviços de banco de dados são configurados para replicação e iniciados. - Os serviços de aplicativos ficam desabilitados. As tentativas de acessar o appliance réplica por HTTP, Git ou outros protocolos com suporte levarão a uma página de manutenção "appliance em modo de réplica" ou a uma mensagem de erro. @@ -71,8 +71,7 @@ Execute `ghe-repl-start' para começar a replicar em relação ao primário rec O comando `ghe-repl-start` habilita a replicação ativa de todos os armazenamentos de dados. ```shell -admin@169-254-1-2:~$ ghe-repl-start{% if currentVersion ver_lt "enterprise-server@2.18" %} -Starting OpenVPN tunnel ... {% endif %} +admin@169-254-1-2:~$ ghe-repl-start Starting MySQL replication ... Iniciando replicação Redis... Iniciando replicação Elasticsearch... @@ -144,8 +143,7 @@ Parando replicação Pages... Parando replicação Git... Parando replicação MySQL... Parando replicação Redis... -Parando replicação Elasticsearch...{% if currentVersion ver_lt "enterprise-server@2.18" %} -Parando túnel OpenVPN...{% endif %} +Parando replicação Elasticsearch... Sucesso: replicação parada em todos os serviços. ``` @@ -163,8 +161,7 @@ Parando replicação... | Parando replicação Git... | Parando replicação MySQL... | Parando replicação Redis... - | Parando replicação Elasticsearch...{% if currentVersion ver_lt "enterprise-server@2.18" %} - | Parando túnel OpenVPN...{% endif %} + | Parando replicação Elasticsearch... | Sucesso: replicação parada em todos os serviços. Alternando modo réplica... | Sucesso: configuração de replicação removida. diff --git a/translations/pt-BR/content/admin/enterprise-management/accessing-the-monitor-dashboard.md b/translations/pt-BR/content/admin/enterprise-management/accessing-the-monitor-dashboard.md index 0869ee00f57e..d251eaf49623 100644 --- a/translations/pt-BR/content/admin/enterprise-management/accessing-the-monitor-dashboard.md +++ b/translations/pt-BR/content/admin/enterprise-management/accessing-the-monitor-dashboard.md @@ -24,10 +24,10 @@ versions: Use o painel de monitoramento para se manter a par da integridade dos recursos do seu appliance e decidir como corrigir os problemas de uso excessivo. -| Problema | Possíveis causas | Recomendações | -| ----------------------------------------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Uso excessivo de CPU | Contenção da VM por outros serviços ou programas executados no mesmo host | Se possível, reconfigure outros serviços ou programas para usar menos recursos de CPU. Para otimizar todos os recursos de CPU na VM, consulte "[Otimizar os recursos de CPU ou memória](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)". | -| Uso excessivo de memória | Contenção da VM por outros serviços ou programas executados no mesmo host | Se possível, reconfigure outros serviços ou programas para usar menos memória. Para otimizar o uso da memória disponível na VM, consulte "[Otimizar os recursos de CPU ou memória](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)". | -| Pouco espaço em disco | Consumo do espaço em disco por arquivos grandes binários ou de log | Se possível, hospede os arquivos binários grandes em outro servidor e compacte ou arquive os arquivos de log. Se necessário, aumente o espaço em disco na VM seguindo as etapas da sua plataforma em "[Aumentar a capacidade de armazenamento](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity/)". | -| Tempos de resposta maiores do que o comum | Costuma ser causado por um dos problemas acima | Identifique e corrija os problema subjacentes. Se os tempos de resposta continuarem altos, entre em contato com o {% data variables.contact.contact_ent_support %}. | +| Problema | Possíveis causas | Recomendações | +| ----------------------------------------- | ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Uso excessivo de CPU | Contenção da VM por outros serviços ou programas executados no mesmo host | Se possível, reconfigure outros serviços ou programas para usar menos recursos de CPU. Para otimizar todos os recursos de CPU na VM, consulte "[Otimizar os recursos de CPU ou memória](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)". | +| Uso excessivo de memória | Contenção da VM por outros serviços ou programas executados no mesmo host | Se possível, reconfigure outros serviços ou programas para usar menos memória. Para otimizar o uso da memória disponível na VM, consulte "[Otimizar os recursos de CPU ou memória](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)". | +| Pouco espaço em disco | Consumo do espaço em disco por arquivos grandes binários ou de log | Se possível, hospede os arquivos binários grandes em outro servidor e compacte ou arquive os arquivos de log. Se necessário, aumente o espaço em disco na VM seguindo as etapas da sua plataforma em "[Aumentar a capacidade de armazenamento](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity/)". | +| Tempos de resposta maiores do que o comum | Costuma ser causado por um dos problemas acima | Identifique e corrija os problema subjacentes. Se os tempos de resposta continuarem altos, entre em contato com o {% data variables.contact.contact_ent_support %}. | | Altos índices de erro | Problemas de software | Entre em contato com o {% data variables.contact.contact_ent_support %} e inclua seu pacote de suporte. Para obter mais informações, consulte "[Enviar dados ao suporte do {% data variables.product.prodname_enterprise %}](/enterprise/{{ currentVersion}}/admin/guides/enterprise-support/providing-data-to-github-support#creating-and-sharing-support-bundles)". | diff --git a/translations/pt-BR/content/admin/enterprise-management/cluster-network-configuration.md b/translations/pt-BR/content/admin/enterprise-management/cluster-network-configuration.md index 42bb63f7833e..141dfd563d0b 100644 --- a/translations/pt-BR/content/admin/enterprise-management/cluster-network-configuration.md +++ b/translations/pt-BR/content/admin/enterprise-management/cluster-network-configuration.md @@ -12,7 +12,7 @@ versions: A composição de rede mais simples para o clustering é deixar os nós em uma única LAN. Se um cluster abranger sub-redes, não recomendamos configurar quaisquer regras de firewall entre as redes. A latência entre os nós deve ser inferior a 1 milissegundo. -{% if currentVersion ver_gt "enterprise-server@2.21" %}Para alta disponibilidade, a latência entre a rede com os nós ativos e a rede com os nós passivos deve ser inferior a 70 milissegundos. Não recomendamos configurar um firewall entre as duas redes.{% endif %} +{% if currentVersion ver_gt "enterprise-server@2. 1" %}Para alta disponibilidade, a latência entre a rede com os nós ativos e a rede com os nós passivos deve ser inferior a 70 milissegundos. Não recomendamos configurar um firewall entre as duas redes.{% endif %} #### Portas de aplicativo para usuários finais @@ -71,7 +71,6 @@ Se houver um firewall no nível da rede entre os nós, essas portas terão que e | 8302/UDP | Consul | | 25827/UDP | Collectd | - ### Configurar um balanceador de carga É recomendável usar um balanceador de carga baseado em TCP compatível com o protocolo PROXY para distribuir o tráfego entre os nós. Veja estas configurações de balanceador de carga: diff --git a/translations/pt-BR/content/admin/enterprise-management/creating-a-high-availability-replica.md b/translations/pt-BR/content/admin/enterprise-management/creating-a-high-availability-replica.md index 02d05a7f90f4..eb192b87a019 100644 --- a/translations/pt-BR/content/admin/enterprise-management/creating-a-high-availability-replica.md +++ b/translations/pt-BR/content/admin/enterprise-management/creating-a-high-availability-replica.md @@ -49,7 +49,7 @@ Este exemplo de configuração usa um primário e duas réplicas, localizados em (replica2)$ ghe-repl-setup --add PRIMARY IP (replica2)$ ghe-repl-start ``` -3. Por padrão, as réplicas são configuradas no mesmo datacenter{% if currentVersion ver_gt "enterprise-server@2.17" %} e agora vão tentar propagar a partir de um nó existente no mesmo datacenter{% endif %}. Configure as réplicas para datacenters diferentes definindo outros valores na opção do datacenter. Você pode especificar os valores que preferir, desde que sejam diferentes uns dos outros. Execute o comando `ghe-repl-node` em cada nó e especifique o datacenter. +3. Por padrão, as réplicas são configuradas no mesmo centro de dados e agora tentarão propagar a partir de um nó existente no mesmo centro de dados. Configure as réplicas para datacenters diferentes definindo outros valores na opção do datacenter. Você pode especificar os valores que preferir, desde que sejam diferentes uns dos outros. Execute o comando `ghe-repl-node` em cada nó e especifique o datacenter. No primário: ```shell diff --git a/translations/pt-BR/content/admin/enterprise-management/index.md b/translations/pt-BR/content/admin/enterprise-management/index.md index 112d92c7714e..616faf4a4762 100644 --- a/translations/pt-BR/content/admin/enterprise-management/index.md +++ b/translations/pt-BR/content/admin/enterprise-management/index.md @@ -1,18 +1,14 @@ --- -title: 'Monitoring, managing, and updating your enterprise' -intro: 'You can monitor your appliance, upgrade to a newer version, and configure clustering or high availability' +title: 'Monitorar, gerenciar e atualizar a sua empresa' +intro: 'Você pode monitorar o seu aplicativo, atualizar para uma versão mais recente e configurar o agrupamento ou alta disponibilidade' redirect_from: - /enterprise/admin/enterprise-management - - /enterprise/admin/enterprise-management - - /enterprise/admin/enterprise-management - - /enterprise/admin/enterprise-management - - /enterprise/admin/enterprise-management versions: enterprise-server: '*' --- -### Table of Contents +### Índice {% topic_link_in_list /monitoring-your-appliance %} {% link_in_list /accessing-the-monitor-dashboard %} @@ -20,8 +16,7 @@ versions: {% link_in_list /setting-up-external-monitoring %} {% link_in_list /configuring-collectd %} {% link_in_list /log-forwarding %} - {% link_in_list /monitoring-using-snmp %}{% if currentVersion ver_gt "enterprise-server@2.21" %} - {% link_in_list /monitoring-using-analytics %}{% endif %} + {% link_in_list /monitoring-using-snmp %} {% topic_link_in_list /updating-the-virtual-machine-and-physical-resources %} {% link_in_list /upgrade-requirements %} {% link_in_list /upgrading-github-enterprise-server %} diff --git a/translations/pt-BR/content/admin/enterprise-management/initializing-the-cluster.md b/translations/pt-BR/content/admin/enterprise-management/initializing-the-cluster.md index 4991221623a9..1ebf1964adec 100644 --- a/translations/pt-BR/content/admin/enterprise-management/initializing-the-cluster.md +++ b/translations/pt-BR/content/admin/enterprise-management/initializing-the-cluster.md @@ -17,7 +17,7 @@ versions: ### Configurar o primeiro nó -1. Conecte-se ao nó a ser designado como `mysql-master` no `cluster.conf`. Para obter mais informações, consulte “[Sobre o arquivo de configuração do cluster](/enterprise/{{ currentVersion }}/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)." +1. Conecte-se ao nó que será designado como principal no MySQL no `cluster.conf`. Para obter mais informações, consulte "[Sobre o arquivo de configuração do cluster](/enterprise/{{ currentVersion }}/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)". 2. No navegador, acesse `https://:8443/setup/`. {% data reusables.enterprise_installation.upload-a-license-file %} {% data reusables.enterprise_installation.save-settings-in-web-based-mgmt-console %} @@ -43,7 +43,7 @@ O exemplo `cluster.conf` define um cluster com cinco nós. Os nomes dos nós podem ser qualquer nome de host válido. Cada nome é definido como nome de host e será adicionado a `/etc/hosts` em cada nó. Assim, os nós podem ser resolvidos localmente entre si. -Especifique o primeiro nó de cluster configurado como MySQL master `mysql-server` e `mysql-master`. +Especifique o primeiro nó do cluster que você configurou como principal do MySQL via `mysql-server` e `mysql-master`. ``` [cluster] diff --git a/translations/pt-BR/content/admin/enterprise-management/monitoring-cluster-nodes.md b/translations/pt-BR/content/admin/enterprise-management/monitoring-cluster-nodes.md index 6d6c8ba3409d..7a98efc59c12 100644 --- a/translations/pt-BR/content/admin/enterprise-management/monitoring-cluster-nodes.md +++ b/translations/pt-BR/content/admin/enterprise-management/monitoring-cluster-nodes.md @@ -1,103 +1,106 @@ --- -title: Monitoring cluster nodes -intro: 'A {% data variables.product.prodname_ghe_server %} cluster is comprised of redundant services that are distributed across two or more nodes. If an individual service or an entire node were to fail, it should not be immediately apparent to users of the cluster. However since performance and redundancy are affected, it is important to monitor the health of a {% data variables.product.prodname_ghe_server %} cluster.' +title: Monitorar nós de cluster +intro: 'Um cluster do {% data variables.product.prodname_ghe_server %} é formado por serviços redundantes distribuídos em dois ou mais nós. Em caso de falha de um serviço ou de um nó inteiro, a falha não será aparente de imediato para os usuários do cluster. No entanto, como o desempenho e a redundância são afetados, é importante monitorar a integridade de um cluster do {% data variables.product.prodname_ghe_server %}.' redirect_from: - /enterprise/admin/clustering/monitoring-cluster-nodes - /enterprise/admin/enterprise-management/monitoring-cluster-nodes versions: enterprise-server: '*' --- -### Manually checking cluster status -{% data variables.product.prodname_ghe_server %} has a built-in command line utility for monitoring the health of the cluster. From the administrative shell, running the `ghe-cluster-status` command executes a series of health checks on each node including verification of connectivity and service status. The output shows all test results including the text `ok` or `error`. For example, to only display failing tests, run: +### Verificar o status do cluster manualmente + +O {% data variables.product.prodname_ghe_server %} tem um utilitário integrado de linha de comando para monitorar a integridade do cluster. No shell administrativo, acionar o comando `ghe-cluster-status` executa uma série de verificações de integridade em cada nó, verificando também o status do serviço e da conectividade. A saída mostra todos os resultados de teste, inclusive o texto `ok` ou `erro`. Por exemplo, para exibir somente os testes com falha, execute: ```shell -admin@ghe-data-node-0:~$ ghe-cluster-status | grep error -> mysql-replication ghe-data-node-0: error Stopped -> mysql cluster: error +admin@ghe-data-node-0:~$ status-ghe-cluster | grep erro +> mysql-replicacao no-dados-ghe-0: erro Parado +> mysql cluster: erro ``` {% note %} -**Note:** If there are no failing tests, this command produces no output. This indicates the cluster is healthy. +**Observação:** se não houver testes com falha, o comando não vai gerar saída. Nesse caso, a integridade do cluster terá sido preservada. {% endnote %} -### Monitoring cluster status with Nagios +### Monitorar o status do cluster com o Nagios -You can configure [Nagios](https://www.nagios.org/) to monitor {% data variables.product.prodname_ghe_server %}. In addition to monitoring basic connectivity to each of the cluster nodes, you can check the cluster status by configuring Nagios to use the `ghe-cluster-status -n` command. This returns output in a format that Nagios understands. +É possível configurar o [Nagios](https://www.nagios.org/) para monitorar o {% data variables.product.prodname_ghe_server %}. Além de monitorar a conectividade básica para cada nó do cluster, você pode verificar o status do cluster configurando o Nagios para usar o comando `ghe-cluster-status -n`. Fazer isso gera uma saída em um formato que o Nagios consegue interpretar. -#### Prerequisites -* Linux host running Nagios. -* Network access to the {% data variables.product.prodname_ghe_server %} cluster. +#### Pré-requisitos +* Host Linux com Nagios; +* Acesso de rede ao cluster do {% data variables.product.prodname_ghe_server %}. -#### Configuring the Nagios host -1. Generate an SSH key with a blank passphrase. Nagios uses this to authenticate to the {% data variables.product.prodname_ghe_server %} cluster. +#### Configurar o host do Nagios +1. Gere uma chave SSH com a frase secreta em branco. O Nagios usa essa informação para fazer a autenticação ao cluster do {% data variables.product.prodname_ghe_server %}. ```shell nagiosuser@nagios:~$ ssh-keygen -t rsa -b 4096 - > Generating public/private rsa key pair. - > Enter file in which to save the key (/home/nagiosuser/.ssh/id_rsa): - > Enter passphrase (empty for no passphrase): leave blank by pressing enter - > Enter same passphrase again: press enter again - > Your identification has been saved in /home/nagiosuser/.ssh/id_rsa. - > Your public key has been saved in /home/nagiosuser/.ssh/id_rsa.pub. + > Gerando par de chaves rsa pública/privada. + > Digite o arquivo no qual salvar a chave (/home/nagiosuser/.ssh/id_rsa): + > Digite a frase secreta (vazia para nenhuma frase secreta): deixe em branco pressionando enter + > Digite a mesma frase secreta novamente: pressione enter novamente + > Sua identificação foi salva em /home/nagiosuser/.ssh/id_rsa. + > Sua chave pública foi salva no /home/nagiosuser/.ssh/id_rsa.pub. ``` {% danger %} - **Security Warning:** An SSH key without a passphrase can pose a security risk if authorized for full access to a host. Limit this key's authorization to a single read-only command. + **Aviso de segurança:** chaves SSH sem senha podem representar um risco de segurança se tiverem permissão de acesso total a um host. Limite o acesso desse tipo de chave a comandos de somente leitura. {% enddanger %} -2. Copy the private key (`id_rsa`) to the `nagios` home folder and set the appropriate ownership. +2. Copie a chave privada (`id_rsa`) para a pasta inicial `nagios` e defina a propriedade adequada. ```shell nagiosuser@nagios:~$ sudo cp .ssh/id_rsa /var/lib/nagios/.ssh/ nagiosuser@nagios:~$ sudo chown nagios:nagios /var/lib/nagios/.ssh/id_rsa ``` -3. To authorize the public key to run *only* the `ghe-cluster-status -n` command, use a `command=` prefix in the `/data/user/common/authorized_keys` file. From the administrative shell on any node, modify this file to add the public key generated in step 1. For example: `command="/usr/local/bin/ghe-cluster-status -n" ssh-rsa AAAA....` +3. Para autorizar a chave pública a executar *somente* o comando `ghe-cluster-status-n`, use o prefixo `command=` no arquivo `/data/user/common/authorized_keys`. No shell administrativo de qualquer nó, modifique esse arquivo para incluir a chave pública gerada na etapa 1. Por exemplo: `command="/usr/local/bin/ghe-cluster-status -n" ssh-rsa AAAA....` -4. Validate and copy the configuration to each node in the cluster by running `ghe-cluster-config-apply` on the node where you modified the `/data/user/common/authorized_keys` file. +4. Valide e copie a configuração para cada nó do cluster executando `ghe-cluster-config-apply` no nó em que você modificou o arquivo `/data/user/common/authorized_keys`. ```shell admin@ghe-data-node-0:~$ ghe-cluster-config-apply - > Validating configuration + > Validando a configuração > ... - > Finished cluster configuration + > Configuração de cluster concluída ``` -5. To test that the Nagios plugin can successfully execute the command, run it interactively from Nagios host. +5. Para testar se o plugin do Nagios consegue executar o comando, execute-o de forma interativa no host do Nagios. ```shell nagiosuser@nagios:~$ /usr/lib/nagios/plugins/check_by_ssh -l admin -p 122 -H hostname -C "ghe-cluster-status -n" -t 30 - > OK - No errors detected + > OK - Nenhum erro detectado ``` -6. Create a command definition in your Nagios configuration. - ###### Example definition +6. Crie uma definição de comando na sua configuração do Nagios. + + ###### Definição de exemplo ``` - define command { - command_name check_ssh_ghe_cluster - command_line $USER1$/check_by_ssh -H $HOSTADDRESS$ -C "ghe-cluster-status -n" -l admin -p 122 -t 30 + definir comando { + nome_comando verificar_ssh_ghe_cluster + linha_comando $USER1$/verificar_por_ssh -H $HOSTADDRESS$ -C "status-cluster-ghe -n" -l admin -p 122 -t 30 } ``` -7. Add this command to a service definition for a node in the {% data variables.product.prodname_ghe_server %} cluster. +7. Adicione este comando a uma definição de serviço para um nó no cluster do {% data variables.product.prodname_ghe_server %}. + - ###### Example definition + ###### Definição de exemplo ``` - define host{ - use generic-host - host_name ghe-data-node-0 - alias ghe-data-node-0 - address 10.11.17.180 + definir host{ + uso host-genérico + nome_host nó-dados-ghe-0 + alias nó-dados-ghe-0 + endereço 10.11.17.180 } - define service{ - use generic-service - host_name ghe-data-node-0 - service_description GitHub Cluster Status - check_command check_ssh_ghe_cluster + definir serviço{ + uso serviço-genérico + nome_host nó-dados-ghe-0 + descrição_serviço Status GitHub Cluster + verificar_comando verificar_cluster_ssh_ghe } ``` -Once you add the definition to Nagios, the service check executes according to your configuration. You should be able to see the newly configured service in the Nagios web interface. +Depois de adicionar a definição ao Nagios, a verificação de serviço será executada conforme a sua configuração. Você deve conseguir ver o serviço recém-configurado na interface da web do Nagios. -![Nagios Example](/assets/images/enterprise/cluster/nagios-example.png) +![Exemplo Nagios](/assets/images/enterprise/cluster/nagios-example.png) diff --git a/translations/pt-BR/content/admin/enterprise-support/about-github-enterprise-support.md b/translations/pt-BR/content/admin/enterprise-support/about-github-enterprise-support.md index 249ee0ce6da8..b011324b8888 100644 --- a/translations/pt-BR/content/admin/enterprise-support/about-github-enterprise-support.md +++ b/translations/pt-BR/content/admin/enterprise-support/about-github-enterprise-support.md @@ -57,7 +57,7 @@ Para problemas urgentes, fornecemos suporte em inglês 44 horas por dia, 7 dias #### Feriados nos Estados Unidos -O {% data variables.contact.enterprise_support %} observa esses feriados dos EUA. O {% data variables.contact.enterprise_support %} observa os feriados americanos, embora nossa equipe de suporte global esteja disponível para responder tíquetes urgentes. +O {% data variables.contact.enterprise_support %} observa esses feriados dos EUA. O {{ site.data.variables.contact.enterprise_support }} observa os feriados americanos, embora nossa equipe de suporte global esteja disponível para responder tíquetes urgentes. | EUA Feriado | Data observada em {{ "now" | date: "%Y" }} | | ----------------------- | ----------------------------- | ------------- | diff --git a/translations/pt-BR/content/admin/enterprise-support/about-support-for-advanced-security.md b/translations/pt-BR/content/admin/enterprise-support/about-support-for-advanced-security.md index b6a3da4555b8..3780d47a7c21 100644 --- a/translations/pt-BR/content/admin/enterprise-support/about-support-for-advanced-security.md +++ b/translations/pt-BR/content/admin/enterprise-support/about-support-for-advanced-security.md @@ -70,8 +70,8 @@ Ao entrar em contato com {% data variables.contact.enterprise_support %}, para a {% data reusables.support.github-can-modify-ticket-priority %} -| Prioridade | Descrição | -|:------------------------------------------------------------------:| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Prioridade | Descrição | +|:-------------------------------------------------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | {% data variables.product.support_ticket_priority_high %} | O {% data variables.product.prodname_advanced_security %} não está funcionando, ou está parado ou seriamente afetado, de modo que o usuário final não pode razoavelmente continuar o uso do software e nenhuma solução alternativa está disponível. | | {% data variables.product.support_ticket_priority_normal %} | O {% data variables.product.prodname_advanced_security %} está funcionando de maneira inconsistente, causando prejuízo no uso e na produtividade do usuário final. | | {% data variables.product.support_ticket_priority_low %} | {% data variables.product.prodname_advanced_security %} está funcionando de maneira consistente, mas o usuário final solicita pequenas alterações no software, como atualizações de documentação, defeitos estéticos ou aprimoramentos. | diff --git a/translations/pt-BR/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md b/translations/pt-BR/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md index d37421f8dfc9..3297b3aca2e8 100644 --- a/translations/pt-BR/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md +++ b/translations/pt-BR/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md @@ -69,7 +69,7 @@ Você pode preencher o cache da ferramenta do executor, executando um fluxo de t path: ${{runner.tool_cache}}/tool_cache.tar.gz ``` {% endraw %} -1. Faça o download do artefato do cache da ferramenta da execução do fluxo de trabalho. Para obter instruções sobre o download de artefatos, consulte "[Persistindo dados de fluxo de trabalho usando artefatos](/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts#downloading-and-deleting-artifacts-after-a-workflow-run-is-complete)". +1. Faça o download do artefato do cache da ferramenta da execução do fluxo de trabalho. Para obter instruções sobre o download de artefatos, consulte "[Fazer download de artefatos de fluxo de trabalho](/actions/managing-workflow-runs/downloading-workflow-artifacts)". 1. Transfira o artefato de cache das ferramentas para o seu executor hospedado e extraia-o para o diretório de cache das ferramentas locais. O diretório de cache da ferramenta padrão é `RUNNER_DIR/_work/_tool`. Se o executor ainda não processou nenhum trabalho, você pode precisar criar os diretórios `_work/_tool`. Após extrair o artefato de cache da ferramenta carregado no exemplo acima, você deve ter uma estrutura de diretório no seu executor auto-hospedado semelhante ao exemplo a seguir: diff --git a/translations/pt-BR/content/admin/index.md b/translations/pt-BR/content/admin/index.md index daa477d4acfb..29d310a05934 100644 --- a/translations/pt-BR/content/admin/index.md +++ b/translations/pt-BR/content/admin/index.md @@ -1,5 +1,5 @@ --- -title: Enterprise Administrators +title: Administradores da Empresa redirect_from: - /enterprise/admin/hidden/migrating-from-github-fi/ - /enterprise/admin diff --git a/translations/pt-BR/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md b/translations/pt-BR/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md index daafbcd929bd..d87d5a4f73f8 100644 --- a/translations/pt-BR/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md +++ b/translations/pt-BR/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md @@ -24,7 +24,8 @@ Antes de iniciar a {% data variables.product.product_location_enterprise %} no G #### Tipos de máquina compatíveis -O {% data variables.product.prodname_ghe_server %} é compatível nos seguintes tipos de máquina do Google Compute Engine (GCE). Para obter mais informações, consulte o [artigo sobre tipos de máquina do Google Cloud Platform](https://cloud.google.com/compute/docs/machine-types). | +O {% data variables.product.prodname_ghe_server %} é compatível nos seguintes tipos de máquina do Google Compute Engine (GCE). Para obter mais informações, consulte o [artigo sobre tipos de máquina do Google Cloud Platform](https://cloud.google.com/compute/docs/machine-types). +| {% if currentVersion != "free-pro-team@latest" %} | | Memória alta | | | ------------- | diff --git a/translations/pt-BR/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md b/translations/pt-BR/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md index b14bea6e6b5d..9773ae62a469 100644 --- a/translations/pt-BR/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md +++ b/translations/pt-BR/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md @@ -29,7 +29,9 @@ versions: {% data reusables.enterprise_installation.create-ghe-instance %} -1. No OpenStack Horizon, faça upload da imagem do {% data variables.product.prodname_ghe_server %} que você baixou. Para obter instruções, consulte a seção "Fazer upload de uma imagem" do guia OpenStack "[Fazer upload e gerenciar imagens](https://docs.openstack.org/horizon/latest/user/manage-images.html)". +1. No OpenStack Horizon, faça o upload do + +imagem de {% data variables.product.prodname_ghe_server %} que você baixou. Para obter instruções, consulte a seção "Fazer upload de uma imagem" do guia OpenStack "[Fazer upload e gerenciar imagens](https://docs.openstack.org/horizon/latest/user/manage-images.html)". {% data reusables.enterprise_installation.create-attached-storage-volume %} Para obter instruções, consulte o guia OpenStack "[Criar e gerenciar volumes](https://docs.openstack.org/horizon/latest/user/manage-volumes.html)". 3. Crie um grupo de segurança e adicione uma nova regra de grupo de segurança para cada porta na tabela abaixo. Para ver as instruções, consulte o guia do OpenStack "[Configurar o acesso e a segurança nas instâncias](https://docs.openstack.org/horizon/latest/user/configure-access-and-security-for-instances.html)". diff --git a/translations/pt-BR/content/admin/overview/about-enterprise-accounts.md b/translations/pt-BR/content/admin/overview/about-enterprise-accounts.md index c856d47748bb..e0ad6206142f 100644 --- a/translations/pt-BR/content/admin/overview/about-enterprise-accounts.md +++ b/translations/pt-BR/content/admin/overview/about-enterprise-accounts.md @@ -10,7 +10,7 @@ versions: ### Sobre as contas corporativas do {% data variables.product.prodname_ghe_server %} -Uma conta corporativa permite que você gerencie múltiplas organizações de {% data variables.product.prodname_dotcom %} e instâncias de {% data variables.product.prodname_ghe_server %}. Sua conta corporativa deve ter um manipulador, como uma conta pessoal ou organizacional no {% data variables.product.prodname_dotcom %}. Os administradores corporativos podem gerenciar configurações e preferências, como: +Uma conta corporativa permite que você gerencie múltiplas organizações {% data variables.product.prodname_dotcom %} e instâncias {% data variables.product.prodname_ghe_server %}. Sua conta corporativa deve ter um manipulador, como uma conta pessoal ou organizacional no {% data variables.product.prodname_dotcom %}. Os administradores corporativos podem gerenciar configurações e preferências, como: - Acesso e gerenciamento de integrantes (integrantes da organização, colaboradores externos) - Faturamento e uso de instâncias de ({% data variables.product.prodname_ghe_server %}, licenças de usuário, pacotes de {% data variables.large_files.product_name_short %}) diff --git a/translations/pt-BR/content/admin/overview/about-the-github-enterprise-server-api.md b/translations/pt-BR/content/admin/overview/about-the-github-enterprise-server-api.md index ec8bbcb60222..2686c7f2c042 100644 --- a/translations/pt-BR/content/admin/overview/about-the-github-enterprise-server-api.md +++ b/translations/pt-BR/content/admin/overview/about-the-github-enterprise-server-api.md @@ -15,5 +15,5 @@ Para a documentação completa para {% data variables.product.prodname_enterpris - Fazer alterações no {% data variables.enterprise.management_console %}. Para obter mais informações, consulte "[{% data variables.enterprise.management_console %}](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#management-console)." - Coletar dados estatísticos sobre a sua instância. Para obter mais informações, consulte "[Estatísticas do administrador](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#admin-stats)". -- Configurar a sincronização LDAP. Para obter mais informações, consulte "[LDAP](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#admin-stats)".{% if currentVersion ver_gt "enterprise-server@2.18" %} -- Gerenciar sua conta corporativa. Para obter mais informações, consulte "[Contas corporativas](/v4/guides/managing-enterprise-accounts)".{% endif %} +- Configurar a sincronização LDAP. Para obter mais informações, consulte "[LDAP](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#admin-stats)". +- Gerenciar sua conta corporativa. Para obter mais informações, consulte "[Contas corporativas](/v4/guides/managing-enterprise-accounts)". diff --git a/translations/pt-BR/content/admin/overview/managing-your-github-enterprise-license.md b/translations/pt-BR/content/admin/overview/managing-your-github-enterprise-license.md index 4ac4f9a3878a..41d8536fa1e5 100644 --- a/translations/pt-BR/content/admin/overview/managing-your-github-enterprise-license.md +++ b/translations/pt-BR/content/admin/overview/managing-your-github-enterprise-license.md @@ -34,7 +34,8 @@ Caso queira renovar ou adicionar licenças de usuário com o {% data variables.p {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.enterprise-licensing-tab %} 4. Em "Enterprise Server Instances", clique em {% octicon "download" aria-label="The download icon" %} para fazer o download do seu arquivo de licença. ![Baixar licença do GitHub Enterprise Server](/assets/images/help/business-accounts/download-ghes-license.png) -5. Faça login na sua instância do {% data variables.product.prodname_ghe_server %} como administrador do site. +5. Faça login no seu +Instância de {% data variables.product.prodname_ghe_server %} como administrador do site. {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.settings-tab %} @@ -63,7 +64,8 @@ Para sincronizar manualmente o uso das licenças de usuário entre as duas impla {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.license-tab %} 5. Em "Quick links" (Links rápidos), para baixar um arquivo com o uso da sua licença atual no {% data variables.product.prodname_ghe_server %}, clique em **Export license usage** (Exportar uso de licença). ![Exportar link de uso de licença](/assets/images/enterprise/business-accounts/export-license-usage-link.png) -6. Navegue até o {% data variables.product.prodname_ghe_cloud %}. +6. Navegar para +{% data variables.product.prodname_ghe_cloud %}. {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.enterprise-licensing-tab %} diff --git a/translations/pt-BR/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md b/translations/pt-BR/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md index b4cb64b269f9..acb7acca0f9f 100644 --- a/translations/pt-BR/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md +++ b/translations/pt-BR/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md @@ -1,6 +1,6 @@ --- -title: Enforcing repository management policies in your enterprise -intro: 'Enterprise owners can enforce certain repository management policies for all organizations owned by an enterprise account, or allow policies to be set in each organization.' +title: Aplicar as políticas de gerenciamento do repositório na sua empresa +intro: 'Os proprietários corporativos podem aplicar determinadas políticas de gerenciamento de repositórios para todas as organizações pertencentes a uma conta corporativa ou permitir que as políticas sejam definidas em cada organização.' redirect_from: - /enterprise/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance - /enterprise/admin/guides/user-management/preventing-users-from-changing-a-repository-s-visibility @@ -29,15 +29,15 @@ versions: enterprise-server: '*' --- -### Configuring the default visibility of new repositories on your appliance +### Configurar a visibilidade padrão de novos repositórios no appliance -Each time someone creates a new repository on {% data variables.product.product_location_enterprise %}, that person must choose a visibility for the repository. When you configure a default visibility setting for the instance, you choose which visibility is selected by default. For more information on repository visibility, see "[About repository visibility](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)." +Cada vez que alguém criar um novo repositório no {% data variables.product.product_location_enterprise %}, essa pessoa deve escolher uma visibilidade para o repositório. Ao optar por uma configuração de visibilidade padrão para a instância, você escolhe qual visibilidade será selecionada por padrão. Para obter mais informações sobre a visibilidade de repositório, consulte "[Sobre a visibilidade do repositório](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)". -If a site administrator disallows members from creating certain types of repositories, members will not be able to create that type of repository even if the visibility setting defaults to that type. For more information, see "[Restricting repository creation in your instance](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)." +Se um administrador do site impedir que os membros criem certos tipos de repositórios, os membros não serão capazes de criar esse tipo de repositório, mesmo se a configuração de visibilidade for padrão para esse tipo. Para obter mais informações, consulte "[Restringir a criação de repositórios na instância](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)". {% tip %} -**Tip:** You can restrict the ability to change repository visibility to site administrators only. For more information, see "[Preventing users from changing a repository's visibility](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-a-repository-s-visibility)." +**Dica:** é possível restringir a capacidade de alterar a visibilidade do repositório apenas a administradores do site. Para obter mais informações, consulte "[Impedir os usuários de alterarem a visibilidade do repositório](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-a-repository-s-visibility)". {% endtip %} @@ -49,26 +49,25 @@ If a site administrator disallows members from creating certain types of reposit {% data reusables.enterprise-accounts.settings-tab %} {% endif %} {% data reusables.enterprise-accounts.options-tab %} -1. Under "Default repository visibility", use the drop-down menu and select a default visibility. - ![Drop-down menu to choose the default repository visibility for your instance](/assets/images/enterprise/site-admin-settings/default-repository-visibility-settings.png) +1. Em "Default repository visibility" (Visibilidade padrão do repositório), clique no menu suspenso e selecione uma visibilidade padrão.![Menu suspenso para definir a visibilidade padrão do repositório da instância](/assets/images/enterprise/site-admin-settings/default-repository-visibility-settings.png) {% data reusables.enterprise_installation.image-urls-viewable-warning %} -### Setting a policy for changing a repository's visibility +### Definir uma política para alterar a visibilidade de um repositório -When you prevent members from changing repository visibility, only site administrators have the ability to make public repositories private or make private repositories public. +Se você impedir que os integrantes alterem a visibilidade do repositório, somente os administradores do site poderão tornar privados os repositórios públicos ou tornar públicos os repositórios privados. -If a site administrator has restricted repository creation to organization owners only, then members will not be able to change repository visibility. If a site administrator has restricted member repository creation to private repositories only, then members will only be able to change repositories from public to private. For more information, see "[Setting a policy for repository creation](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)." +Se um administrador do site tiver restringido a criação do repositório somente aos proprietários da organização, os integrantes não poderão alterar a visibilidade do repositório. Além disso, se o administrador do site restringir a criação de repositórios apenas aos repositórios privados, os integrantes só conseguirão tornar privados os repositórios públicos. Para obter mais informações, consulte "[Definir uma política para a criação de repositórios](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)". {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.repositories-tab %} -5. Under "Repository visibility change", review the information about changing the setting. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} +5. Em "Repository visibility change" (Alteração da visibilidade do repositório), revise as informações sobre a alteração da configuração. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} {% data reusables.enterprise-accounts.repository-visibility-policy %} -### Setting a policy for repository creation +### Definir uma política para a criação de repositório {% data reusables.organizations.repo-creation-constants %} @@ -76,35 +75,34 @@ If a site administrator has restricted repository creation to organization owner {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.repositories-tab %} -5. Under "Repository creation", review the information about changing the setting. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} +5. Em "Repository creation" (Criação de repositório), revise as informações sobre como alterar a configuração. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} {% if currentVersion ver_gt "enterprise-server@2.19" %} {% data reusables.enterprise-accounts.repo-creation-policy %} {% data reusables.enterprise-accounts.repo-creation-types %} {% else %} -6. Under "Repository creation", use the drop-down menu and choose a policy. - ![Drop-down menu with repository creation policies](/assets/images/enterprise/site-admin-settings/repository-creation-drop-down.png) +6. Em "Repository creation" (Criação de repositórios), use o menu suspenso e escolha uma política. ![Menu suspenso com opções de políticas de criação de repositórios](/assets/images/enterprise/site-admin-settings/repository-creation-drop-down.png) {% endif %} -### Setting a policy for repository deletion and transfer +### Definir uma política de exclusão e transferência de repositório {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.repositories-tab %} -5. Under "Repository deletion and transfer", review the information about changing the setting. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} +5. Em "Repository deletion and transfer" (Exclusão e transferência de repositórios), revise as informações sobre como alterar as configurações. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} {% data reusables.enterprise-accounts.repository-deletion-policy %} -### Setting a policy for Git push limits +### Definir uma política para limites de push do Git -To keep your repository size manageable and prevent performance issues, you can configure a file size limit for repositories on your instance. +Para manter o tamanho do repositório gerenciável e evitar problemas de desempenho, você pode configurar um limite de tamanho de arquivo para os repositórios em sua instância. -By default, when you enforce repository upload limits, people cannot add or update files larger than 100 MB. +Por padrão, quando você impõe os limites de upload do repositório, as pessoas não podem adicionar ou atualizar arquivos maiores que 100 MB. {% if currentVersion ver_lt "enterprise-server@2.20" %} {% tip %} -**Note:** Only files larger than {% data variables.large_files.warning_size %} will be checked against the Git push limit. If you need to set a lower push limit, contact {% data variables.contact.contact_ent_support %} for assistance. +**Observação:** o limite de push do Git será verificado somente em arquivos com mais de {% data variables.large_files.warning_size %}. Se quiser definir um limite de push mais baixo, entre em contato com o {% data variables.contact.contact_ent_support %} para obter assistência. {% endtip %} {% endif %} @@ -117,14 +115,12 @@ By default, when you enforce repository upload limits, people cannot add or upda {% data reusables.enterprise-accounts.settings-tab %} {% endif %} {% data reusables.enterprise-accounts.options-tab %} -4. Under "Repository upload limit", use the drop-down menu and click a maximum object size. -![Drop-down menu with maximum object size options](/assets/images/enterprise/site-admin-settings/repo-upload-limit-dropdown.png) -5. Optionally, to enforce a maximum upload limit for all repositories on {% data variables.product.product_location_enterprise %}, select **Enforce on all repositories** -![Enforce maximum object size on all repositories option](/assets/images/enterprise/site-admin-settings/all-repo-upload-limit-option.png) +4. Em "Repository upload limit" (Limite de upload de repositório), use o menu suspenso e clique para definir o tamanho máximo do objeto. ![Menu suspenso com opções de tamanho máximo de objeto](/assets/images/enterprise/site-admin-settings/repo-upload-limit-dropdown.png) +5. Opcionalmente, para aplicar um limite de upload máximo para todos os repositórios no {% data variables.product.product_location_enterprise %}, selecione **Limitar todos os repositórios** ![Opção de limitar o tamanho máximo de objeto em todos os repositórios](/assets/images/enterprise/site-admin-settings/all-repo-upload-limit-option.png) -### Configuring the merge conflict editor for pull requests between repositories +### Configurar o editor de conflitos de merge para pull requests entre repositórios -Requiring users to resolve merge conflicts locally on their computer can prevent people from inadvertently writing to an upstream repository from a fork. +Solicitar que os usuário resolvam conflitos de merge em seus respectivos computadores pode impedir gravações inadvertidas em repositórios upstream a partir de uma bifurcação. {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} @@ -134,14 +130,13 @@ Requiring users to resolve merge conflicts locally on their computer can prevent {% data reusables.enterprise-accounts.settings-tab %} {% endif %} {% data reusables.enterprise-accounts.options-tab %} -1. Under "Conflict editor for pull requests between repositories", use the drop-down menu, and click **Disabled**. - ![Drop-down menu with option to disable the merge conflict editor](/assets/images/enterprise/settings/conflict-editor-settings.png) +1. Em "Conflict editor for pull requests between repositories" (Editor de conflitos para pull requests entre repositórios), use o menu suspenso e clique em **Disabled** (Desabilitar). ![Menu suspenso com opção para desabilitar o editor de conflito de merge](/assets/images/enterprise/settings/conflict-editor-settings.png) -### Configuring force pushes +### Configurar pushes forçados -Each repository inherits a default force push setting from the settings of the user account or organization to which it belongs. Likewise, each organization and user account inherits a default force push setting from the force push setting for the entire appliance. If you change the force push setting for the appliance, it will change for all repositories owned by any user or organization. +Cada repositório herda uma configuração padrão de push forçado das configurações da conta de usuário ou da organização à qual pertence. Da mesma forma, cada organização e conta de usuário herda uma configuração padrão de push forçado a partir da configuração de push forçado para todo o appliance. Se você alterar a configuração de push forçado no appliance, ela será alterada em todos os repositórios pertencentes a qualquer usuário ou organização. -#### Blocking all force pushes on your appliance +#### Bloquear todos as pushes forçados no seu dispositivo {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} @@ -151,11 +146,10 @@ Each repository inherits a default force push setting from the settings of the u {% data reusables.enterprise-accounts.settings-tab %} {% endif %} {% data reusables.enterprise-accounts.options-tab %} -4. Under "Force pushes", use the drop-down menu, and click **Allow**, **Block** or **Block to the default branch**. -![Force pushes dropdown](/assets/images/enterprise/site-admin-settings/force-pushes-dropdown.png) -5. Optionally, select **Enforce on all repositories**, which will override organization and repository level settings for force pushes. +4. Em "Force pushes" (Pushes forçados), use o menu suspenso e clique em **Allow** (Permitir), **Block** (Bloquear) ou **Block to the default branch** (Bloquear no branch padrão). ![Menu suspenso pushes forçados](/assets/images/enterprise/site-admin-settings/force-pushes-dropdown.png) +5. Você também pode selecionar a opção **Enforce on all repositories** (Forçar em todos os repositórios), que substituirá as configurações no nível da organização e do repositório por push forçados. -#### Blocking force pushes to a specific repository +#### Bloquear pushes forçados para um repositório específico {% data reusables.enterprise_site_admin_settings.override-policy %} @@ -165,14 +159,13 @@ Each repository inherits a default force push setting from the settings of the u {% data reusables.enterprise_site_admin_settings.click-repo %} {% data reusables.enterprise_site_admin_settings.admin-top-tab %} {% data reusables.enterprise_site_admin_settings.admin-tab %} -4. Select **Block** or **Block to the default branch** under **Push and Pull**. - ![Block force pushes](/assets/images/enterprise/site-admin-settings/repo/repo-block-force-pushes.png) +4. Selecione **Block** (Bloquear) ou **Block to the default branch** (Bloquear no branch padrão) em **Push and Pull** (Operações de push e pull). ![Bloquear pushes forçados](/assets/images/enterprise/site-admin-settings/repo/repo-block-force-pushes.png) -#### Blocking force pushes to repositories owned by a user account or organization +#### Bloquear pushes forçados em repositórios pertencentes a uma organização ou conta de usuário -Repositories inherit force push settings from the user account or organization to which they belong. User accounts and organizations in turn inherit their force push settings from the force push settings for the entire appliance. +Os repositórios herdam as configurações de push forçado da conta do usuário ou da organização à qual pertencem. Por sua vez, as organizações e contas de usuário herdam suas configurações de push forçado a partir das configurações de push forçado para todo o appliance. -You can override the default inherited settings by configuring the settings for a user account or organization. +Você pode substituir as configurações padrão herdadas definindo as configurações da conta de usuário ou da organização. {% data reusables.enterprise_site_admin_settings.sign-in %} {% data reusables.enterprise_site_admin_settings.access-settings %} @@ -180,28 +173,26 @@ You can override the default inherited settings by configuring the settings for {% data reusables.enterprise_site_admin_settings.click-user-or-org %} {% data reusables.enterprise_site_admin_settings.admin-top-tab %} {% data reusables.enterprise_site_admin_settings.admin-tab %} -5. Under "Repository default settings" in the "Force pushes" section, select - - **Block** to block force pushes to all branches. - - **Block to the default branch** to only block force pushes to the default branch. - ![Block force pushes](/assets/images/enterprise/site-admin-settings/user/user-block-force-pushes.png) -6. Optionally, select **Enforce on all repositories** to override repository-specific settings. Note that this will **not** override an appliance-wide policy. - ![Block force pushes](/assets/images/enterprise/site-admin-settings/user/user-block-all-force-pushes.png) +5. Em "Repository default settings" (Configurações padrão do repositório) na seção "Force pushes" (Pushes forçados), selecione + - **Block** (Bloquear) para bloquear os pushes forçados em todos os branches. + - **Block to the default branch** (Bloquear no branch padrão) para bloquear os pushes forçados apenas no branch padrão. ![Bloquear pushes forçados](/assets/images/enterprise/site-admin-settings/user/user-block-force-pushes.png) +6. Você também pode selecionar a opção **Enforce on all repositories** (Forçar em todos os repositórios), que substituirá as configurações específicas do repositório. Observe que essa ação **não** substitui políticas no nível do appliance. ![Bloquear pushes forçados](/assets/images/enterprise/site-admin-settings/user/user-block-all-force-pushes.png) -### Configuring anonymous Git read access +### Configurar o acesso de leitura anônimo do Git {% data reusables.enterprise_user_management.disclaimer-for-git-read-access %} -If you have [enabled private mode](/enterprise/admin/configuration/enabling-private-mode) on your instance, you can allow repository administrators to enable anonymous Git read access to public repositories. +Se você [habilitou o modo privado](/enterprise/admin/configuration/enabling-private-mode) na sua instância, você pode permitir que os administradores de repositórios habilitem o acesso de leitura anônimo do Git aos repositórios públicos. -Enabling anonymous Git read access allows users to bypass authentication for custom tools on your instance. When you or a repository administrator enable this access setting for a repository, unauthenticated Git operations (and anyone with network access to {% data variables.product.prodname_ghe_server %}) will have read access to the repository without authentication. +Habilitar o acesso de leitura anônimo do Git permite que os usuários ignorem a autenticação para ferramentas personalizadas em sua instância. Quando você ou um administrador de repositório habilitar essa configuração de acesso em um repositório, as operações não autenticadas do Git (e qualquer pessoa com acesso de rede ao {% data variables.product.prodname_ghe_server %}) terão acesso de leitura sem autenticação ao repositório. -If necessary, you can prevent repository administrators from changing anonymous Git access settings for repositories on {% data variables.product.product_location_enterprise %} by locking the repository's access settings. After you lock a repository's Git read access setting, only a site administrator can change the setting. +Se necessário, você pode impedir que os administradores do repositório alterem as configurações anônimas de acesso do Git para os repositórios em {% data variables.product.product_location_enterprise %}, bloqueando as configurações de acesso do repositório. Após o bloqueio, somente um administrador de site poderá alterar a configuração do acesso de leitura anônimo do Git. {% data reusables.enterprise_site_admin_settings.list-of-repos-with-anonymous-git-read-access-enabled %} {% data reusables.enterprise_user_management.exceptions-for-enabling-anonymous-git-read-access %} -#### Setting anonymous Git read access for all repositories +#### Definir o acesso de leitura anônimo do Git para todos os repositórios {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} @@ -211,23 +202,18 @@ If necessary, you can prevent repository administrators from changing anonymous {% data reusables.enterprise-accounts.settings-tab %} {% endif %} {% data reusables.enterprise-accounts.options-tab %} -4. Under "Anonymous Git read access", use the drop-down menu, and click **Enabled**. -![Anonymous Git read access drop-down menu showing menu options "Enabled" and "Disabled"](/assets/images/enterprise/site-admin-settings/enable-anonymous-git-read-access.png) -3. Optionally, to prevent repository admins from changing anonymous Git read access settings in all repositories on your instance, select **Prevent repository admins from changing anonymous Git read access**. -![Select checkbox to prevent repository admins from changing anonymous Git read access settings for all repositories on your instance](/assets/images/enterprise/site-admin-settings/globally-lock-repos-from-changing-anonymous-git-read-access.png) +4. Em "Anonymous Git read access" (Acesso de leitura anônimo do Git), use o menu suspenso e clique em **Enabled** (Habilitado). ![Menu suspenso de acesso de leitura anônimo do Git com as opções "Enabled" (Habilitado) e "Disabled" (Desabilitado) +](/assets/images/enterprise/site-admin-settings/enable-anonymous-git-read-access.png) +3. Para impedir que os administradores de repositório alterem as configurações de acesso de leitura anônimo do Git em todos os repositórios da instância, você também pode selecionar **Prevent repository admins from changing anonymous Git read access** (Impedir administradores de repositório de alterarem o acesso de leitura anônimo do Git). ![Marcar a caixa de seleção para impedir que administradores de repositório alterem as configurações de acesso de leitura anônimo do Git em todos os repositórios da instância](/assets/images/enterprise/site-admin-settings/globally-lock-repos-from-changing-anonymous-git-read-access.png) -#### Setting anonymous Git read access for a specific repository +#### Definir acesso de leitura anônimo do Git para um repositório específico {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.repository-search %} {% data reusables.enterprise_site_admin_settings.click-repo %} {% data reusables.enterprise_site_admin_settings.admin-top-tab %} {% data reusables.enterprise_site_admin_settings.admin-tab %} -6. Under "Danger Zone", next to "Enable Anonymous Git read access", click **Enable**. -!["Enabled" button under "Enable anonymous Git read access" in danger zone of a repository's site admin settings ](/assets/images/enterprise/site-admin-settings/site-admin-enable-anonymous-git-read-access.png) -7. Review the changes. To confirm, click **Yes, enable anonymous Git read access.** -![Confirm anonymous Git read access setting in pop-up window](/assets/images/enterprise/site-admin-settings/confirm-anonymous-git-read-access-for-specific-repo-as-site-admin.png) -8. Optionally, to prevent repository admins from changing this setting for this repository, select **Prevent repository admins from changing anonymous Git read access**. -![Select checkbox to prevent repository admins from changing anonymous Git read access for this repository](/assets/images/enterprise/site-admin-settings/lock_anonymous_git_access_for_specific_repo.png) - +6. Em "Danger Zone" (Zona de perigo), ao lado de "Enable anonymous Git read access" (Habilitar acesso de leitura anônimo do Git), clique em **Enable** (Habilitar). ![Botão "Enabled" (Habilitado) na opção "Enable anonymous Git read access" (Habilitar acesso de leitura anônimo do Git) na zona de perigo das configurações de administração do site ](/assets/images/enterprise/site-admin-settings/site-admin-enable-anonymous-git-read-access.png) +7. Revise as alterações. Para confirmar, clique em **Yes, enable anonymous Git read access** (Sim, permitir acesso de leitura anônimo ao Git). ![Confirmar configuração de acesso de leitura anônimo do Git na janela pop-up](/assets/images/enterprise/site-admin-settings/confirm-anonymous-git-read-access-for-specific-repo-as-site-admin.png) +8. Para impedir que os administradores de repositório alterem a configuração nesse repositório, você também pode selecionar **Prevent repository admins from changing anonymous Git read access** (Impedir administradores de repositório de alterarem o acesso de leitura anônimo do Git). ![Marcar a caixa de seleção para impedir que administradores de repositório alterem as configurações de acesso de leitura anônimo do Git em todos os repositórios da instância](/assets/images/enterprise/site-admin-settings/lock_anonymous_git_access_for_specific_repo.png) diff --git a/translations/pt-BR/content/admin/user-management/audit-logging.md b/translations/pt-BR/content/admin/user-management/audit-logging.md index 112d0ed68665..198d0de3ba36 100644 --- a/translations/pt-BR/content/admin/user-management/audit-logging.md +++ b/translations/pt-BR/content/admin/user-management/audit-logging.md @@ -34,5 +34,5 @@ Oct 26 01:42:08 github-ent github_audit: {:created_at=>1351215728326, :actor_ip= Este exemplo mostra que houve push dos commits para um repositório. ``` -Oct 26 02:19:31 github-ent github_audit: { "pid":22860, "ppid":22859, "program":"receive-pack", "git_dir":"/data/repositories/some-user/some-repository.git", "hostname":"github-ent", "pusher":"some-user", "real_ip":"10.0.0.51", "user_agent":"git/1.7.10.4", "repo_id":1, "repo_name":"some-user/some-repository", "transaction_id":"b031b7dc7043c87323a75f7a92092ef1456e5fbaef995c68", "frontend_ppid":1, "repo_public":true, "user_name":"some-user", "user_login":"some-user", "frontend_pid":18238, "frontend":"github-ent", "user_email":"some-user@github.example.com", "user_id":2, "pgroup":"github-ent_22860", "status":"post_receive_hook", "features":" report-status side-band-64k", "received_objects":3, "receive_pack_size":243, "non_fast_forward":false, "current_ref":"refs/heads/master" } +Oct 26 02:19:31 github-ent github_audit: { "pid":22860, "ppid":22859, "program":"receive-pack", "git_dir":"/data/repositories/some-user/some-repository.git", "hostname":"github-ent", "pusher":"some-user", "real_ip":"10.0.0.51", "user_agent":"git/1.7.10.4", "repo_id":1, "repo_name":"some-user/some-repository", "transaction_id":"b031b7dc7043c87323a75f7a92092ef1456e5fbaef995c68", "frontend_ppid":1, "repo_public":true, "user_name":"some-user", "user_login":"some-user", "frontend_pid":18238, "frontend":"github-ent", "user_email":"some-user@github.example.com", "user_id":2, "pgroup":"github-ent_22860", "status":"post_receive_hook", "features":" report-status side-band-64k", "received_objects":3, "receive_pack_size":243, "non_fast_forward":false, "current_ref":"refs/heads/main" } ``` diff --git a/translations/pt-BR/content/admin/user-management/audited-actions.md b/translations/pt-BR/content/admin/user-management/audited-actions.md index 175f14f2ceef..90b8c1b0c8ff 100644 --- a/translations/pt-BR/content/admin/user-management/audited-actions.md +++ b/translations/pt-BR/content/admin/user-management/audited-actions.md @@ -35,8 +35,8 @@ versions: #### Configurações de instância -| Nome | Descrição | -| -------------------------------------------------------:| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Nome | Descrição | +| -------------------------------------------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `business.update_member_repository_creation_permission` | Um administrador do site restringe a criação de repositórios em organizações na instância. Para obter mais informações, consulte "[Restringir a criação de repositórios na instância](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)". | | `business.clear_members_can_create_repos` | Um administrador do site retira uma restrição de criação de repositórios nas organizações na instância. Para obter mais informações, consulte "[Restringir a criação de repositórios na instância](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)". | | `enterprise.config.lock_anonymous_git_access` | Um administrador do site bloqueia acessos de leitura anônimos do Git para impedir que os administradores do repositório alterem as configurações de acessos de leitura anônimos do Git existentes nos repositórios na instância. Para obter mais informações, consulte "[Impedir os usuários de alterarem o acesso de leitura anônimo do Git](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)". | @@ -44,19 +44,19 @@ versions: #### Problemas e pull requests -| Nome | Descrição | -| ------------------------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `issue.update` | O texto de um problema (comentário inicial) foi alterado. | -| `issue_comment.update` | Um comentário em um problema (que não seja o inicial) foi alterado. | -| `pull_request_review_comment.delete` | Foi excluído um comentário em um pull request. | +| Nome | Descrição | +| ------------------------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `issue.update` | O texto de um problema (comentário inicial) foi alterado. | +| `issue_comment.update` | Um comentário em um problema (que não seja o inicial) foi alterado. | +| `pull_request_review_comment.delete` | Foi excluído um comentário em um pull request. | | `issue.destroy` | Um problema foi excluído do repositório. Para obter mais informações, consulte "[Excluir um problema](/enterprise/{{ currentVersion }}/user/articles/deleting-an-issue)". | #### Organizações -| Nome | Descrição | -| ------------------:| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `org.async_delete` | Um usuário iniciou um trabalho em segundo plano para excluir uma organização. | -| `org.delete` | Uma organização foi excluída por um trabalho em segundo plano iniciado pelo usuário. | +| Nome | Descrição | +| ------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `org.async_delete` | Um usuário iniciou um trabalho em segundo plano para excluir uma organização. | +| `org.delete` | Uma organização foi excluída por um trabalho em segundo plano iniciado pelo usuário. | | `org.transform` | A conta de usuário foi convertida em organização. Para obter mais informações, consulte [Converter usuário em organização](/enterprise/{{ currentVersion}}/user/articles/converting-a-user-into-an-organization/). | #### Branches protegidos @@ -76,18 +76,18 @@ versions: #### Repositórios -| Nome | Descrição | -| ------------------------------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `repo.access` | Um repositório privado passou a ser público, ou um repositório público passou a ser privado. | +| Nome | Descrição | +| ------------------------------------------:| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `repo.access` | Um repositório privado passou a ser público, ou um repositório público passou a ser privado. | | `repo.archive` | Um repositório foi arquivado. Para obter mais informações, consulte [Arquivar e cancelar o arquivamento de repositórios](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/). | -| `repo.add_member` | Um colaborador foi adicionado ao repositório. | +| `repo.add_member` | Um colaborador foi adicionado ao repositório. | | `repo.config` | Um administrador do site bloqueou a opção de forçar pushes. Para obter mais informações, consulte [Bloquear pushes forçados em um repositório](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository/). | -| `repo.create` | Um repositório foi criado. | -| `repo.destroy` | Um repositório foi excluído. | -| `repo.remove_member` | Um colaborador foi removido do repositório. | -| `repo.rename` | Um repositório foi renomeado. | -| `repo.transfer` | Um usuário aceitou uma solicitação para receber um repositório transferido. | -| `repo.transfer_start` | Um usuário enviou uma solicitação para transferir um repositório a outro usuário ou organização. | +| `repo.create` | Um repositório foi criado. | +| `repo.destroy` | Um repositório foi excluído. | +| `repo.remove_member` | Um colaborador foi removido do repositório. | +| `repo.rename` | Um repositório foi renomeado. | +| `repo.transfer` | Um usuário aceitou uma solicitação para receber um repositório transferido. | +| `repo.transfer_start` | Um usuário enviou uma solicitação para transferir um repositório a outro usuário ou organização. | | `repo.unarchive` | Um repositório teve o arquivamento cancelado. Para obter mais informações, consulte [Arquivar e cancelar o arquivamento de repositórios](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/). | | `repo.config.disable_anonymous_git_access` | O acesso de leitura anônimo do Git está desabilitado em um repositório público. Para obter mais informações, consulte "[Habilitar acesso de leitura anônimo do Git para um repositório](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)". | | `repo.config.enable_anonymous_git_access` | O acesso de leitura anônimo do Git está habilitado em um repositório público. Para obter mais informações, consulte "[Habilitar acesso de leitura anônimo do Git para um repositório](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)". | @@ -100,7 +100,7 @@ versions: | --------------------:| -------------------------------------------------------------------------------------------------------------------------- | | `staff.disable_repo` | Um administrador do site desabilitou o acesso a um repositório e a todas as suas bifurcações. | | `staff.enable_repo` | Um administrador do site habilitou novamente o acesso a um repositório e a todas as suas bifurcações. | -| `staff.fake_login` | Um administrador do site fez login no {% data variables.product.prodname_enterprise %} como outro usuário. | +| `staff.fake_login` | Um administrador do site fez login no {% data variables.product.prodname_enterprise %} como outro usuário. | | `staff.repo_unlock` | Um administrador do site desbloqueou (obteve acesso total temporariamente a) um dos repositórios privados de um usuário. | | `staff.unlock` | Um administrador do site desbloqueou (obteve acesso total temporariamente a) todos os repositórios privados de um usuário. | diff --git a/translations/pt-BR/content/admin/user-management/configuring-email-for-notifications.md b/translations/pt-BR/content/admin/user-management/configuring-email-for-notifications.md index 2e249604bf08..a7d5565dc450 100644 --- a/translations/pt-BR/content/admin/user-management/configuring-email-for-notifications.md +++ b/translations/pt-BR/content/admin/user-management/configuring-email-for-notifications.md @@ -44,7 +44,7 @@ Se quiser permitir o recebimento de respostas para os e-mails de notificação, 1. A porta 25 da instância deve estar acessível para o seu servidor SMTP. 2. Crie um registro A que aponte para `reply.[hostname]`. Dependendo do provedor DNS e da configuração do host da instância, você poderá criar um único registro A que aponte para `*.[hostname]`. 3. Crie um registro MX que aponte para `reply.[hostname]`, de forma que os e-mails desse domínio sejam roteados para a instância. -4. Crie um registro MX que aponte `noreply.[hostname]` para `[hostname]`, de forma que as respostas ao endereço `cc` nos e-mails de notificação sejam roteadas para a instância. Para obter mais informações, consulte {% if currentVersion ver_gt "enterprise-server@2.20" %}"[Configurando notificações](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications){% else %}"[Sobre notificações de e-mail](/github/receiving-notifications-about-activity-on-github/about-email-notifications)"{% endif %}." +4. Crie um registro MX que aponte `noreply.[hostname]` para `[hostname]`, de forma que as respostas ao endereço `cc` nos e-mails de notificação sejam roteadas para a instância. Para obter mais informações, consulte {% if currentVersion ver_gt "enterprise-server@2.20" %}"[Configurar notificações](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications){% else %}"[Sobre notificações de e-mail](/github/receiving-notifications-about-activity-on-github/about-email-notifications){% endif %}". Com essas definições de DNS, agora você pode testar se a configuração funciona. diff --git a/translations/pt-BR/content/admin/user-management/creating-teams.md b/translations/pt-BR/content/admin/user-management/creating-teams.md index c119129132b6..28b76d12799e 100644 --- a/translations/pt-BR/content/admin/user-management/creating-teams.md +++ b/translations/pt-BR/content/admin/user-management/creating-teams.md @@ -28,7 +28,7 @@ Fazer uma combinação prudente de equipes é uma forma poderosa de controlar o ### Criar equipes com a Sincronização LDAP habilitada -Instâncias que usam o LDAP para fazer autenticação de usuários podem usar a Sincronização LDAP para gerenciar os integrantes de uma equipe. Configurar o **Distinguished Name (DN)** (nome diferenciado) no campo **LDAP group** (grupo LDAP) mapeará uma equipe a um grupo LDAP ou servidor LDAP. Se você usar a Sincronização LDAP para gerenciar os integrantes de uma equipe, não será possível gerenciar a sua equipe na {% data variables.product.product_location_enterprise %}. Quando a Sincronização LDAP estiver habilitada, a equipe mapeada sincronizará seus integrantes em segundo plano e periodicamente no intervalo configurado. Para obter mais informações, consulte "[Habilitar a Sincronização LDAP](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)". +Instâncias que usam o LDAP para fazer autenticação de usuários podem usar a Sincronização LDAP para gerenciar os integrantes de uma equipe. Configurar o **Distinguished Name (DN)** (nome diferenciado) no campo **LDAP group** (grupo LDAP) mapeará uma equipe a um grupo LDAP ou servidor LDAP. Se você usar a Sincronização LDAP para gerenciar os integrantes de uma equipe, não será possível gerenciar a sua equipe na {% data variables.product.product_location_enterprise %}. Quando a Sincronização LDAP estiver habilitada, a equipe mapeada sincronizará seus integrantes em segundo plano e periodicamente no intervalo configurado. Para obter mais informações, consulte "[Habilitar a Sincronização LDAP](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)". {% data reusables.enterprise_user_management.ldap-sync-nested-teams %} @@ -36,17 +36,19 @@ Instâncias que usam o LDAP para fazer autenticação de usuários podem usar a **Notas:** - A Sincronização LDAP gerencia somente a lista de integrantes da equipe. Você deve gerenciar os repositórios e permissões da equipe pelo {% data variables.product.prodname_ghe_server %}. -- Se um grupo LDAP mapeado para um DN for removido, por exemplo, se o grupo LDAP for excluído, todos os integrantes serão removidos da equipe sincronizada do {% data variables.product.prodname_ghe_server %}. Para corrigir o problema, mapeie a equipe para um novo DN, adicione novamente os integrantes e [sincronize manualmente o mapeamento](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap/#manually-syncing-ldap-accounts). +- Se um grupo LDAP mapeado para um DN for removido, por exemplo, se o grupo LDAP for excluído, todos os integrantes serão removidos da equipe sincronizada do {% data variables.product.prodname_ghe_server %}. Para corrigir o problema, mapeie a equipe para um novo DN, adicione novamente os integrantes e [sincronize manualmente o mapeamento](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap/#manually-syncing-ldap-accounts). - Quando a Sincronização LDAP estiver ativada, se uma pessoa for removida de um repositório, ela perderá o acesso. No entanto, suas bifurcações não serão excluídas. Se a pessoa for adicionada a uma equipe e tiver acesso ao repositório original da organização dentro de três meses, seu acesso às bifurcações será restaurado automaticamente na sincronização seguinte. {% endwarning %} -1. Verifique se a [sincronização LDAP está habilitada](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#enabling-ldap-sync). +1. Verifique se a [sincronização LDAP está habilitada](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#enabling-ldap-sync). {% data reusables.profile.enterprise_access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.new_team %} {% data reusables.organizations.team_name %} -6. Pesquise um DN do grupo do LDAP ao qual a equipe será mapeada. Se você não souber o DN, digite o nome do grupo do LDAP. O {% data variables.product.prodname_ghe_server %} vai buscar correspondências e preenchimentos automáticos. ![Mapear grupo LDAP para DN](/assets/images/enterprise/orgs-and-teams/ldap-group-mapping.png) +6. Pesquise um DN do grupo do LDAP ao qual a equipe será mapeada. Se você não souber o DN, digite o nome do grupo do LDAP. +O {% data variables.product.prodname_ghe_server %} vai buscar correspondências e preenchimentos automáticos. +![Mapear grupo LDAP para DN](/assets/images/enterprise/orgs-and-teams/ldap-group-mapping.png) {% data reusables.organizations.team_description %} {% data reusables.organizations.team_visibility %} {% data reusables.organizations.create-team-choose-parent %} diff --git a/translations/pt-BR/content/admin/user-management/customizing-user-messages-on-your-instance.md b/translations/pt-BR/content/admin/user-management/customizing-user-messages-on-your-instance.md index f86f745fd0fb..19887f54a998 100644 --- a/translations/pt-BR/content/admin/user-management/customizing-user-messages-on-your-instance.md +++ b/translations/pt-BR/content/admin/user-management/customizing-user-messages-on-your-instance.md @@ -3,7 +3,7 @@ title: Personalizar mensagens de usuário na instância redirect_from: - /enterprise/admin/user-management/creating-a-custom-sign-in-message/ - /enterprise/admin/user-management/customizing-user-messages-on-your-instance -intro: 'É possível criar {% if currentVersion ver_gt "enterprise-server@2.15" %}mensagens personalizadas que os usuários verão nas páginas de entrada e saída{% else %}uma mensagem personalizada que os usuários verão na página de entrada{% endif %}.' +intro: 'Você pode criar mensagens personalizadas que os usuários verão nas páginas de login e logout{% if currentVersion ver_gt "enterprise-server@2. 1" %} ou em um banner de anúncio na parte superior de cada página{% endif %}.' versions: enterprise-server: '*' --- diff --git a/translations/pt-BR/content/admin/user-management/managing-dormant-users.md b/translations/pt-BR/content/admin/user-management/managing-dormant-users.md index 9254b6d3096e..44dab780c370 100644 --- a/translations/pt-BR/content/admin/user-management/managing-dormant-users.md +++ b/translations/pt-BR/content/admin/user-management/managing-dormant-users.md @@ -1,46 +1,38 @@ --- -title: Managing dormant users +title: Gerenciar usuários inativos redirect_from: - /enterprise/admin/articles/dormant-users/ - /enterprise/admin/articles/viewing-dormant-users/ - /enterprise/admin/articles/determining-whether-a-user-account-is-dormant/ - /enterprise/admin/user-management/managing-dormant-users - - /enterprise/admin/user-management/managing-dormant-users - - /enterprise/admin/user-management/managing-dormant-users - - /enterprise/admin/user-management/managing-dormant-users - - /enterprise/admin/user-management/managing-dormant-users -intro: A user account is considered to be dormant if it has not been active for at least a month. You may choose to suspend dormant users to free up user licenses. +intro: Uma conta de usuário é considerada inativa se não estiver ativa por no mínimo um mês. Você pode optar por suspender usuários inativos para liberar licenças de usuário. versions: enterprise-server: '*' --- -"Activity" includes, but is not limited to: -- Signing in to {% data variables.product.prodname_ghe_server %}. -- Commenting on issues and pull requests. -- Creating, deleting, watching, and starring repositories. +O termo "atividade" inclui, entre outros: +- Fazer login no {% data variables.product.prodname_ghe_server %}; +- Fazer comentários em problemas ou pull requests; +- Criar, excluir, ver e marcar repositórios como favoritos; - Pushing commits.{% if currentVersion ver_gt "enterprise-server@2.21" %} -- Accessing resources by using a personal access token or SSH key.{% endif %} +- Acessar recursos usando um token de acesso pessoal ou chave SSH.{% endif %} -### Viewing dormant users +### Exibir usuários inativos -You can view a list of all dormant users who have not been suspended and who are not site administrators. +É possível exibir uma lista de todos os usuários inativos que não foram suspensos e que não são administradores do site. {% data reusables.enterprise_site_admin_settings.access-settings %} -3. In the left sidebar, click **Dormant users**. -![Dormant users tab](/assets/images/enterprise/site-admin-settings/dormant-users-tab.png) -4. To suspend all the dormant users in this list, at the top of the page, click **Suspend all**. -![Suspend all button](/assets/images/enterprise/site-admin-settings/suspend-all.png) +3. Na barra lateral esquerda, clique em **Dormant users** (Usuários inativos). ![Guia Dormant users (Usuários inativos)](/assets/images/enterprise/site-admin-settings/dormant-users-tab.png) +4. Para suspender todos os usuários inativos nesta lista, na parte superior da página, clique em **Suspend all** (Suspender todos). ![Botão Suspend all (Suspender todos)](/assets/images/enterprise/site-admin-settings/suspend-all.png) -### Determining whether a user account is dormant +### Determinar se uma conta de usuário está inativa {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.search-user %} {% data reusables.enterprise_site_admin_settings.click-user %} -5. In the **User info** section, a red dot with the word "Dormant" indicates the user account is dormant, and a green dot with the word "Active" indicates the user account is active. -![Dormant user account](/assets/images/enterprise/stafftools/dormant-user.png) -![Active user account](/assets/images/enterprise/stafftools/active-user.png) +5. Na seção **User info** (Informações de usuário), um ponto vermelho com a palavra "Inativo" indica que a conta do usuário está inativa, e um ponto verde com a palavra "Ativo" indica que a conta do usuário está ativa. ![Conta de usuário inativa](/assets/images/enterprise/stafftools/dormant-user.png) ![Conta de usuário ativa](/assets/images/enterprise/stafftools/active-user.png) -### Configuring the dormancy threshold +### Configurar o limite de inatividade {% data reusables.enterprise_site_admin_settings.dormancy-threshold %} @@ -52,5 +44,4 @@ You can view a list of all dormant users who have not been suspended and who are {% data reusables.enterprise-accounts.settings-tab %} {% endif %} {% data reusables.enterprise-accounts.options-tab %} -4. Under "Dormancy threshold", use the drop-down menu, and click the desired dormancy threshold. -![The Dormancy threshold drop-down menu](/assets/images/enterprise/site-admin-settings/dormancy-threshold-menu.png) +4. Em "Dormancy threshold" (Limite de inatividade), use o menu suspenso e clique no limite de inatividade desejado.![Menu suspenso do limite de inatividade](/assets/images/enterprise/site-admin-settings/dormancy-threshold-menu.png) diff --git a/translations/pt-BR/content/admin/user-management/promoting-or-demoting-a-site-administrator.md b/translations/pt-BR/content/admin/user-management/promoting-or-demoting-a-site-administrator.md index e67ed288dc8b..eb3d65092274 100644 --- a/translations/pt-BR/content/admin/user-management/promoting-or-demoting-a-site-administrator.md +++ b/translations/pt-BR/content/admin/user-management/promoting-or-demoting-a-site-administrator.md @@ -4,14 +4,14 @@ redirect_from: - /enterprise/admin/articles/promoting-a-site-administrator/ - /enterprise/admin/articles/demoting-a-site-administrator/ - /enterprise/admin/user-management/promoting-or-demoting-a-site-administrator -intro: Os administradores do site podem promover qualquer conta de usuário como administrador do site e rebaixar administradores do site para usuários regulares. +intro: 'Os administradores do site podem promover qualquer conta de usuário como administrador do site e rebaixar administradores do site para usuários regulares.' versions: enterprise-server: '*' --- {% tip %} -**Observação:** se a [Sincronização LDAP estiver habilitada](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#enabling-ldap-sync) e o atributo `Administrators group` estiver definido ao [configurar o acesso LDAP para os usuários](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#configuring-ldap-with-your-github-enterprise-server-instance), esses usuários terão automaticamente acesso de administrador do site em suas respectivas instâncias. Nesse caso, você não pode promover manualmente os usuários pelas etapas abaixo.Será preciso adicioná-los ao grupo de administradores LDAP. +**Observação:** se a [Sincronização LDAP estiver habilitada](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#enabling-ldap-sync) e o atributo `Administrators group` estiver definido ao [configurar o acesso LDAP para os usuários](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#configuring-ldap-with-your-github-enterprise-server-instance), esses usuários terão automaticamente acesso de administrador do site em suas respectivas instâncias. Nesse caso, você não pode promover manualmente os usuários pelas etapas abaixo.Será preciso adicioná-los ao grupo de administradores LDAP. {% endtip %} diff --git a/translations/pt-BR/content/admin/user-management/rebuilding-contributions-data.md b/translations/pt-BR/content/admin/user-management/rebuilding-contributions-data.md index 387063dfb906..9e5f6f3a6024 100644 --- a/translations/pt-BR/content/admin/user-management/rebuilding-contributions-data.md +++ b/translations/pt-BR/content/admin/user-management/rebuilding-contributions-data.md @@ -15,4 +15,5 @@ Sempre que é enviado para o {% data variables.product.prodname_enterprise %}, o 3. À esquerda na página, clique em **Admin** (Administrador). ![Guia Admin (Administrador)](/assets/images/enterprise/site-admin-settings/admin-tab.png) 4. Em **Contributions data** (Dados de contribuição), clique em **Rebuild** (Recompilar). ![Botão Rebuild (Recompilar)](/assets/images/enterprise/site-admin-settings/rebuild-button.png) -{% data variables.product.prodname_enterprise %} will now start background jobs to re-link commits with that user's account. ![Trabalhos recompilados em fila](/assets/images/enterprise/site-admin-settings/rebuild-jobs.png) +{% data variables.product.prodname_enterprise %} will now start background jobs to re-link commits with that user's account. + ![Trabalhos recompilados em fila](/assets/images/enterprise/site-admin-settings/rebuild-jobs.png) diff --git a/translations/pt-BR/content/admin/user-management/requiring-two-factor-authentication-for-an-organization.md b/translations/pt-BR/content/admin/user-management/requiring-two-factor-authentication-for-an-organization.md index 7753bf9ce5fe..ba0b2492eb27 100644 --- a/translations/pt-BR/content/admin/user-management/requiring-two-factor-authentication-for-an-organization.md +++ b/translations/pt-BR/content/admin/user-management/requiring-two-factor-authentication-for-an-organization.md @@ -1,6 +1,6 @@ --- title: Exigir autenticação de dois fatores na organização -intro: Você pode exigir que integrantes da organização e colaboradores externos habilitem a autenticação de dois fatores em suas contas pessoais para dificultar o acesso de elementos mal-intencionados a repositórios e configurações da organização. +intro: 'Você pode exigir que integrantes da organização e colaboradores externos habilitem a autenticação de dois fatores em suas contas pessoais para dificultar o acesso de elementos mal-intencionados a repositórios e configurações da organização.' redirect_from: - /enterprise/admin/user-management/requiring-two-factor-authentication-for-an-organization versions: diff --git a/translations/pt-BR/content/admin/user-management/searching-the-audit-log.md b/translations/pt-BR/content/admin/user-management/searching-the-audit-log.md index 60ce3dfeec5f..62faeb1d8856 100644 --- a/translations/pt-BR/content/admin/user-management/searching-the-audit-log.md +++ b/translations/pt-BR/content/admin/user-management/searching-the-audit-log.md @@ -13,22 +13,22 @@ versions: Crie uma consulta de pesquisa com um ou mais pares chave-valor separados por operadores lógicos AND/OR. -| Tecla | Valor | -| --------------:| -------------------------------------------------------------------------------------------------- | -| `actor_id` | ID da conta do usuário que iniciou a ação. | -| `actor` | Nome da conta do usuário que iniciou a ação. | -| `oauth_app_id` | ID do aplicativo OAuth associado à ação. | +| Tecla | Valor | +| --------------:| ---------------------------------------------------------------------------------------------------- | +| `actor_id` | ID da conta do usuário que iniciou a ação. | +| `actor` | Nome da conta do usuário que iniciou a ação. | +| `oauth_app_id` | ID do aplicativo OAuth associado à ação. | | `Ação` | Nome da [ação auditada](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions). | -| `user_id` | ID do usuário afetado pela ação. | -| `usuário` | Nome do usuário afetado pela ação. | -| `repo_id` | ID do repositório afetado pela ação (se aplicável). | -| `repo` | Nome do repositório afetado pela ação (se aplicável). | -| `actor_ip` | Endereço IP do qual a ação foi iniciada. | -| `created_at` | Hora em que a ação ocorreu. | -| `from` | Exibição da qual a ação foi iniciada. | -| `note` | Informações diversas sobre eventos específicos (em texto sem formatação ou formato JSON). | -| `org` | Nome da organização afetada pela ação (se aplicável). | -| `org_id` | ID da organização afetada pela ação (se aplicável). | +| `user_id` | ID do usuário afetado pela ação. | +| `usuário` | Nome do usuário afetado pela ação. | +| `repo_id` | ID do repositório afetado pela ação (se aplicável). | +| `repo` | Nome do repositório afetado pela ação (se aplicável). | +| `actor_ip` | Endereço IP do qual a ação foi iniciada. | +| `created_at` | Hora em que a ação ocorreu. | +| `from` | Exibição da qual a ação foi iniciada. | +| `note` | Informações diversas sobre eventos específicos (em texto sem formatação ou formato JSON). | +| `org` | Nome da organização afetada pela ação (se aplicável). | +| `org_id` | ID da organização afetada pela ação (se aplicável). | Por exemplo, para ver todas as ações que afetaram o repositório `octocat/Spoon-Knife` desde o início de 2017: diff --git a/translations/pt-BR/content/admin/user-management/suspending-and-unsuspending-users.md b/translations/pt-BR/content/admin/user-management/suspending-and-unsuspending-users.md index 33137aaf78ac..f8472935326e 100644 --- a/translations/pt-BR/content/admin/user-management/suspending-and-unsuspending-users.md +++ b/translations/pt-BR/content/admin/user-management/suspending-and-unsuspending-users.md @@ -27,7 +27,7 @@ Antes de suspender os administradores do site, você deve rebaixá-los para usu {% tip %} -**Observação:** se a [Sincronização LDAP estiver habilitada](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#enabling-ldap-sync) para a {% data variables.product.product_location_enterprise %}, os usuários serão suspensos automaticamente quando forem removidos do servidor de diretório LDAP. Quando a Sincronização LDAP estiver habilitada para a sua instância, os métodos normais de suspensão do usuário ficarão desabilitados. +**Observação:** se a [Sincronização LDAP estiver habilitada](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#enabling-ldap-sync) para a {% data variables.product.product_location_enterprise %}, os usuários serão suspensos automaticamente quando forem removidos do servidor de diretório LDAP. Quando a Sincronização LDAP estiver habilitada para a sua instância, os métodos normais de suspensão do usuário ficarão desabilitados. {% endtip %} diff --git a/translations/pt-BR/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-a-repository-from-github-to-github-desktop.md b/translations/pt-BR/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-a-repository-from-github-to-github-desktop.md index b5d945387bda..8e2f215fcce4 100644 --- a/translations/pt-BR/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-a-repository-from-github-to-github-desktop.md +++ b/translations/pt-BR/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-a-repository-from-github-to-github-desktop.md @@ -15,7 +15,9 @@ versions: {% mac %} -1. Entre no {% data variables.product.product_location %} e no {% data variables.product.prodname_desktop %} antes de começar a clonar. +1. Fazer login em + +{% data variables.product.product_location %} e {% data variables.product.prodname_desktop %} antes de começar a clonar. {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.open-with-github-desktop %} 5. Clique em **Choose...** (Escolher...). Em seguida, navegue pela janela Finder (Localizador) até o local em que você pretende clonar o repositório. ![Botão Choose (Escolher) na guia URL](/assets/images/help/desktop/clone-choose-button-url-mac.png) @@ -32,7 +34,9 @@ versions: {% windows %} -1. Entre no {% data variables.product.product_location %} e no {% data variables.product.prodname_desktop %} antes de começar a clonar. +1. Fazer login em + +{% data variables.product.product_location %} e {% data variables.product.prodname_desktop %} antes de começar a clonar. {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.open-with-github-desktop %} 5. Clique em **Choose...** (Escolher...). Em seguida, navegue pelo Windows Explorer (Explorador do Windows) até o local em que você pretende clonar o repositório. ![Botão Choose (Escolher)](/assets/images/help/desktop/clone-choose-button-url-win.png) diff --git a/translations/pt-BR/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop.md b/translations/pt-BR/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop.md index 764e18a1813f..f2da3718b946 100644 --- a/translations/pt-BR/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop.md +++ b/translations/pt-BR/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop.md @@ -19,8 +19,8 @@ Também é possível clonar um repositório diretamente no {% data variables.pro ![Opção de menu Clone (Clonar) no app Mac](/assets/images/help/desktop/clone-file-menu-mac.png) {% data reusables.desktop.cloning-location-tab %} ![Guias Location (Local) no menu Clone a repository (Clonar um repositório)](/assets/images/help/desktop/choose-repository-location-mac.png) -{% data reusables.desktop.cloning-repository-list %} -![Clonar uma lista de repositórios](/assets/images/help/desktop/clone-a-repository-list-mac.png) +{% data reusables.desktop.cloning-repository-list %} + ![Clonar uma lista de repositórios](/assets/images/help/desktop/clone-a-repository-list-mac.png) 4. Clique em **Choose...** (Escolher...). Em seguida, navegue pela janela Finder (Localizador) até o local em que você pretende clonar o repositório. ![Botão Choose (Escolher)](/assets/images/help/desktop/clone-choose-button-mac.png) 5. Clique em **Clone** (Clonar). ![Botão Clone (Clonar)](/assets/images/help/desktop/clone-button-mac.png) @@ -32,8 +32,8 @@ Também é possível clonar um repositório diretamente no {% data variables.pro ![Opção de menu Clone (Clonar) no app Windows](/assets/images/help/desktop/clone-file-menu-windows.png) {% data reusables.desktop.cloning-location-tab %} ![Guias Location (Local) no menu Clone a repository (Clonar um repositório)](/assets/images/help/desktop/choose-repository-location-win.png) -{% data reusables.desktop.cloning-repository-list %} -![Clonar uma lista de repositórios](/assets/images/help/desktop/clone-a-repository-list-win.png) +{% data reusables.desktop.cloning-repository-list %} + ![Clonar uma lista de repositórios](/assets/images/help/desktop/clone-a-repository-list-win.png) 4. Clique em **Choose...** (Escolher...). Em seguida, navegue pelo Windows Explorer (Explorador do Windows) até o local em que você pretende clonar o repositório. ![Botão Choose (Escolher)](/assets/images/help/desktop/clone-choose-button-win.png) 5. Clique em **Clone** (Clonar). ![Botão Clone (Clonar)](/assets/images/help/desktop/clone-button-win.png) diff --git a/translations/pt-BR/content/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request.md b/translations/pt-BR/content/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request.md index 9910171e985d..6c9dea328666 100644 --- a/translations/pt-BR/content/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request.md +++ b/translations/pt-BR/content/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request.md @@ -50,7 +50,9 @@ Antes de criar um pull request, você deverá fazer push das alterações em um 1. Alterne para o branch para o qual você deseja criar um pull request. Para obter mais informações, consulte "[Alternar branches](/desktop/contributing-and-collaborating-using-github-desktop/managing-branches#switching-between-branches)". 2. Clique em **Create Pull Request** (Criar pull request). {% data variables.product.prodname_desktop %} abrirá o seu navegador-padrão para levar você a {% data variables.product.prodname_dotcom %}. ![O botão Criar Pull Request](/assets/images/help/desktop/mac-create-pull-request.png) -4. Em {% data variables.product.prodname_dotcom %}, confirme se o branch no menu suspenso **base:** é o branch onde você deseja fazer merge das suas alterações. Confirme se o branch no menu suspenso **compare:** é o branch de tópico em que você fez suas alterações. ![Menus suspenso para escolher a base e comparar os branches](/assets/images/help/desktop/base-and-compare-branches.png) +4. Em +{% data variables.product.prodname_dotcom %}, confirme que o branch no menu suspenso **base:** é o branch em que você deseja fazer merge das suas alterações. Confirme se o branch no menu suspenso **compare:** é o branch de tópico em que você fez suas alterações. + ![Menus suspenso para escolher a base e comparar os branches](/assets/images/help/desktop/base-and-compare-branches.png) {% data reusables.repositories.pr-title-description %} {% data reusables.repositories.create-pull-request %} @@ -60,7 +62,9 @@ Antes de criar um pull request, você deverá fazer push das alterações em um 1. Alterne para o branch para o qual você deseja criar um pull request. Para obter mais informações, consulte "[Alternar branches](/desktop/contributing-and-collaborating-using-github-desktop/managing-branches#switching-between-branches)". 2. Clique em **Create Pull Request** (Criar pull request). {% data variables.product.prodname_desktop %} abrirá o seu navegador-padrão para levar você a {% data variables.product.prodname_dotcom %}. ![O botão Criar Pull Request](/assets/images/help/desktop/windows-create-pull-request.png) -3. Em {% data variables.product.prodname_dotcom %}, confirme se o branch no menu suspenso **base:** é o branch onde você deseja fazer merge das suas alterações. Confirme se o branch no menu suspenso **compare:** é o branch de tópico em que você fez suas alterações. ![Menus suspenso para escolher a base e comparar os branches](/assets/images/help/desktop/base-and-compare-branches.png) +3. Em +{% data variables.product.prodname_dotcom %}, confirme que o branch no menu suspenso **base:** é o branch em que você deseja fazer merge das suas alterações. Confirme se o branch no menu suspenso **compare:** é o branch de tópico em que você fez suas alterações. + ![Menus suspenso para escolher a base e comparar os branches](/assets/images/help/desktop/base-and-compare-branches.png) {% data reusables.repositories.pr-title-description %} {% data reusables.repositories.create-pull-request %} diff --git a/translations/pt-BR/content/desktop/installing-and-configuring-github-desktop/authenticating-to-github.md b/translations/pt-BR/content/desktop/installing-and-configuring-github-desktop/authenticating-to-github.md index 1e03e687c059..7d2686ac6d34 100644 --- a/translations/pt-BR/content/desktop/installing-and-configuring-github-desktop/authenticating-to-github.md +++ b/translations/pt-BR/content/desktop/installing-and-configuring-github-desktop/authenticating-to-github.md @@ -37,7 +37,9 @@ Antes de autenticar, {% data reusables.desktop.get-an-account %} {% data reusables.desktop.mac-select-desktop-menu %} {% data reusables.desktop.mac-select-accounts %} {% data reusables.desktop.choose-product-authenticate %} -4. Para adicionar uma conta no {% data variables.product.prodname_enterprise %}, digite suas credenciais em "Endereço de servidor corporativo" e clique em **Continuar**. ![Botão Sign In (Entrar) do GitHub Enterprise](/assets/images/help/desktop/mac-sign-in-button-enterprise.png) +4. Para adicionar uma +conta de {% data variables.product.prodname_enterprise %}, digite as suas credenciais em "Endereço do servidor Enterprise" e clique em **Continuar**. + ![Botão Sign In (Entrar) do GitHub Enterprise](/assets/images/help/desktop/mac-sign-in-button-enterprise.png) {% data reusables.desktop.retrieve-2fa %} {% endmac %} @@ -65,7 +67,9 @@ Antes de autenticar, {% data reusables.desktop.get-an-account %} {% data reusables.desktop.windows-choose-options %} {% data reusables.desktop.windows-select-accounts %} {% data reusables.desktop.choose-product-authenticate %} -4. Para adicionar uma conta no {% data variables.product.prodname_enterprise %}, digite suas credenciais em "Endereço de servidor corporativo" e clique em **Continuar**. ![Botão Sign In (Entrar) do GitHub Enterprise](/assets/images/help/desktop/windows-sign-in-button-enterprise.png) +4. Para adicionar uma +conta de {% data variables.product.prodname_enterprise %}, digite as suas credenciais em "Endereço do servidor Enterprise" e clique em **Continuar**. + ![Botão Sign In (Entrar) do GitHub Enterprise](/assets/images/help/desktop/windows-sign-in-button-enterprise.png) {% data reusables.desktop.retrieve-2fa %} {% endwindows %} diff --git a/translations/pt-BR/content/desktop/installing-and-configuring-github-desktop/keyboard-shortcuts.md b/translations/pt-BR/content/desktop/installing-and-configuring-github-desktop/keyboard-shortcuts.md index 8628a7869eec..e1b7d1ce071a 100644 --- a/translations/pt-BR/content/desktop/installing-and-configuring-github-desktop/keyboard-shortcuts.md +++ b/translations/pt-BR/content/desktop/installing-and-configuring-github-desktop/keyboard-shortcuts.md @@ -14,53 +14,53 @@ Atalhos de teclado do GitHub Desktop no macOS ### Atalhos para o site -| Atalho | Descrição | -| ------------------------------------ | -------------------------------------------------------------------------- | -| ⌘, | Ir para Preferences (Preferências) | -| ⌘H | Ocultar o aplicativo do {% data variables.product.prodname_desktop %} | -| ⌥⌘H | Ocultar todos os outros aplicativos | -| ⌘Q | Sair do {% data variables.product.prodname_desktop %} | -| ⌃⌘F | Alternar a exibição em tela cheia | -| ⌘0 | Redefinir o zoom para o tamanho de texto padrão | -| ⌘= | Aumentar o zoom em textos e imagens | -| ⌘- | Diminuir o zoom em textos e imagens | -| ⌥⌘I | Alternar as ferramentas de desenvolvedor | +| Atalho | Descrição | +| ------------------------------------ | --------------------------------------------------------------------- | +| ⌘, | Ir para Preferences (Preferências) | +| ⌘H | Ocultar o aplicativo do {% data variables.product.prodname_desktop %} +| ⌥⌘H | Ocultar todos os outros aplicativos | +| ⌘Q | Sair do {% data variables.product.prodname_desktop %} +| ⌃⌘F | Alternar a exibição em tela cheia | +| ⌘0 | Redefinir o zoom para o tamanho de texto padrão | +| ⌘= | Aumentar o zoom em textos e imagens | +| ⌘- | Diminuir o zoom em textos e imagens | +| ⌥⌘I | Alternar as ferramentas de desenvolvedor | ### Repositórios -| Atalho | Descrição | -| ------------------------------------ | ------------------------------------------------------------------------------------- | -| ⌘N | Adicionar um novo repositório | -| ⌘O | Adicionar um repositório local | -| ⇧⌘O | Clonar um repositório do {% data variables.product.prodname_dotcom %} | -| ⌘T | Exibir uma lista dos repositórios | -| ⌘P | Usar os commits mais recentes do {% data variables.product.prodname_dotcom %} | -| ⇧⌘P | Usar as alterações mais recentes do {% data variables.product.prodname_dotcom %} | -| ⌘⌫ | Remover um repositório | -| ⇧⌘G | Exibir o repositório no {% data variables.product.prodname_dotcom %} | -| ⌃` | Abrir o repositório na sua ferramenta de terminal preferida | -| ⇧⌘F | Exibir o repositório no Localizador | -| ⇧⌘A | Abrir o repositório na sua ferramenta de edição preferida | -| ⌘I | Criar um problema em {% data variables.product.prodname_dotcom %} | +| Atalho | Descrição | +| ------------------------------------ | -------------------------------------------------------------------------------- | +| ⌘N | Adicionar um novo repositório | +| ⌘O | Adicionar um repositório local | +| ⇧⌘O | Clonar um repositório do {% data variables.product.prodname_dotcom %} +| ⌘T | Exibir uma lista dos repositórios | +| ⌘P | Usar os commits mais recentes do {% data variables.product.prodname_dotcom %} +| ⇧⌘P | Usar as alterações mais recentes do {% data variables.product.prodname_dotcom %} +| ⌘⌫ | Remover um repositório | +| ⇧⌘G | Exibir o repositório no {% data variables.product.prodname_dotcom %} +| ⌃` | Abrir o repositório na sua ferramenta de terminal preferida | +| ⇧⌘F | Exibir o repositório no Localizador | +| ⇧⌘A | Abrir o repositório na sua ferramenta de edição preferida | +| ⌘I | Criar um problema em {% data variables.product.prodname_dotcom %} ### Branches -| Atalho | Descrição | -| ------------------------------------ | -------------------------------------------------------------------------------- | -| ⌘1 | Exibir todas as alterações antes de fazer o commit | -| ⌘2 | Exibir o histórico de commits | -| ⌘B | Exibir todos os branches | -| ⌘G | Ir para o campo de resumo de commits | -| space (Espaço) | Selecione ou desmarque todos os arquivos destacados | -| ⇧⌘N | Criar um branch | -| ⇧⌘R | Renomear o branch atual | -| ⇧⌘D | Excluir o branch atual | -| ⇧⌘U | Atualizar o branch padrão | -| ⇧⌘B | Comparar a outro branch | -| ⇧⌘M | Fazer um merge com o branch atual | -| ⌃H | Exibir ou ocultar alterações stashed | -| ⇧⌘C | Comparar branches no {% data variables.product.prodname_dotcom %} | -| ⌘R | Exibir a pull request atual no {% data variables.product.prodname_dotcom %} | +| Atalho | Descrição | +| ------------------------------------ | --------------------------------------------------------------------------- | +| ⌘1 | Exibir todas as alterações antes de fazer o commit | +| ⌘2 | Exibir o histórico de commits | +| ⌘B | Exibir todos os branches | +| ⌘G | Ir para o campo de resumo de commits | +| space (Espaço) | Selecione ou desmarque todos os arquivos destacados | +| ⇧⌘N | Criar um branch | +| ⇧⌘R | Renomear o branch atual | +| ⇧⌘D | Excluir o branch atual | +| ⇧⌘U | Atualizar o branch padrão | +| ⇧⌘B | Comparar a outro branch | +| ⇧⌘M | Fazer um merge com o branch atual | +| ⌃H | Exibir ou ocultar alterações stashed | +| ⇧⌘C | Comparar branches no {% data variables.product.prodname_dotcom %} +| ⌘R | Exibir a pull request atual no {% data variables.product.prodname_dotcom %} {% endmac %} @@ -81,38 +81,38 @@ Atalhos de teclado do GitHub Desktop no Windows ### Repositórios -| Atalho de teclado | Descrição | -| ------------------------------------------- | ------------------------------------------------------------------------------------- | -| CtrlN | Adicionar um novo repositório | -| CtrlO | Adicionar um repositório local | -| CtrlShiftO | Clonar um repositório do {% data variables.product.prodname_dotcom %} | -| CtrlT | Exibir uma lista dos repositórios | -| CtrlP | Usar os commits mais recentes do {% data variables.product.prodname_dotcom %} | -| CtrlShiftP | Usar as alterações mais recentes do {% data variables.product.prodname_dotcom %} | -| CtrlDelete | Remover um repositório | -| CtrlShiftG | Exibir o repositório no {% data variables.product.prodname_dotcom %} | -| Ctrl` | Abrir o repositório na sua ferramenta de linha de comando preferida | -| CtrlShiftF | Exibir o repositório no Explorador | -| CtrlShiftA | Abrir o repositório na sua ferramenta de edição preferida | -| CtrlI | Criar um problema em {% data variables.product.prodname_dotcom %} | +| Atalho de teclado | Descrição | +| ------------------------------------------- | -------------------------------------------------------------------------------- | +| CtrlN | Adicionar um novo repositório | +| CtrlO | Adicionar um repositório local | +| CtrlShiftO | Clonar um repositório do {% data variables.product.prodname_dotcom %} +| CtrlT | Exibir uma lista dos repositórios | +| CtrlP | Usar os commits mais recentes do {% data variables.product.prodname_dotcom %} +| CtrlShiftP | Usar as alterações mais recentes do {% data variables.product.prodname_dotcom %} +| CtrlDelete | Remover um repositório | +| CtrlShiftG | Exibir o repositório no {% data variables.product.prodname_dotcom %} +| Ctrl` | Abrir o repositório na sua ferramenta de linha de comando preferida | +| CtrlShiftF | Exibir o repositório no Explorador | +| CtrlShiftA | Abrir o repositório na sua ferramenta de edição preferida | +| CtrlI | Criar um problema em {% data variables.product.prodname_dotcom %} ### Branches -| Atalho | Descrição | -| ------------------------------------------- | -------------------------------------------------------------------------------- | -| Ctrl1 | Exibir todas as alterações antes de fazer o commit | -| Ctrl2 | Exibir o histórico de commits | -| CtrlB | Exibir todos os branches | -| CtrlG | Ir para o campo de resumo de commits | -| space (Espaço) | Selecione ou desmarque todos os arquivos destacados | -| CtrlShiftN | Criar um branch | -| CtrlShiftR | Renomear o branch atual | -| CtrlShiftD | Excluir o branch atual | -| CtrlShiftU | Atualizar o branch padrão | -| CtrlShiftB | Comparar a outro branch | -| CtrlShiftM | Fazer um merge com o branch atual | -| CtrlH | Exibir ou ocultar alterações stashed | -| CtrlShiftC | Comparar branches no {% data variables.product.prodname_dotcom %} | -| CtrlR | Exibir a pull request atual no {% data variables.product.prodname_dotcom %} | +| Atalho | Descrição | +| ------------------------------------------- | --------------------------------------------------------------------------- | +| Ctrl1 | Exibir todas as alterações antes de fazer o commit | +| Ctrl2 | Exibir o histórico de commits | +| CtrlB | Exibir todos os branches | +| CtrlG | Ir para o campo de resumo de commits | +| space (Espaço) | Selecione ou desmarque todos os arquivos destacados | +| CtrlShiftN | Criar um branch | +| CtrlShiftR | Renomear o branch atual | +| CtrlShiftD | Excluir o branch atual | +| CtrlShiftU | Atualizar o branch padrão | +| CtrlShiftB | Comparar a outro branch | +| CtrlShiftM | Fazer um merge com o branch atual | +| CtrlH | Exibir ou ocultar alterações stashed | +| CtrlShiftC | Comparar branches no {% data variables.product.prodname_dotcom %} +| CtrlR | Exibir a pull request atual no {% data variables.product.prodname_dotcom %} {% endwindows %} diff --git a/translations/pt-BR/content/developers/apps/about-apps.md b/translations/pt-BR/content/developers/apps/about-apps.md index aa1cd18ad56d..7489f6cb6fde 100644 --- a/translations/pt-BR/content/developers/apps/about-apps.md +++ b/translations/pt-BR/content/developers/apps/about-apps.md @@ -11,7 +11,7 @@ versions: enterprise-server: '*' --- -Os aplicativos no {% data variables.product.prodname_dotcom %} permitem que você automatize e melhore seu fluxo de trabalho. Você pode criar aplicativos para melhorar seu fluxo de trabalho. {% if currentVersion == "free-pro-team@latest" %} Você também pode compartilhar ou vender aplicativos em [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace). Para aprender como listar um aplicativo no {% data variables.product.prodname_marketplace %}, consulte "[Introdução ao GitHub Marketplace](/marketplace/getting-started/)".{% endif %} +Os aplicativos no {% data variables.product.prodname_dotcom %} permitem que você automatize e melhore seu fluxo de trabalho. Você pode criar aplicativos para melhorar o seu fluxo de trabalho.{% if currentVersion == "free-pro-team@latest" %} Você também pode compartilhar ou vender aplicativos em [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace). Para aprender como listar um aplicativo no {% data variables.product.prodname_marketplace %}, consulte "[Introdução ao GitHub Marketplace](/marketplace/getting-started/)".{% endif %} {% data reusables.marketplace.github_apps_preferred %}, mas o GitHub é compatível com {% data variables.product.prodname_oauth_app %}s e {% data variables.product.prodname_github_apps %}. Para obter informações sobre a escolha de um tipo de aplicativo, consulte "[Sobre aplicativos](/apps/about-apps/)" e "[Diferenças entre os aplicativos.](/apps/differences-between-apps/) @@ -41,10 +41,10 @@ Tenha isso em mente ao criar {% data variables.product.prodname_github_apps %}: * O {% data variables.product.prodname_github_app %} deve conectar-se a uma conta pessoal ou organização. * Não espere que o {% data variables.product.prodname_github_app %} saiba e faça tudo o que um usuário pode fazer. * Não use {% data variables.product.prodname_github_app %}, se você precisa apenas de um serviço de "Login com GitHub". No entanto, um {% data variables.product.prodname_github_app %} pode usar um [fluxo de identificação de usuário](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/) para iniciar sessão de usuários em _e_ fazer outras coisas. -* Não crie um {% data variables.product.prodname_github_app %} se você _apenas_ desejar atuar como um usuário do GitHub e fazer tudo o que o usuário pode fazer.{% if currentVersion == "free-pro-team@latest" %} +* Não crie um {% data variables.product.prodname_github_app %} se você _apenas_ quiser atuar como um usuário do GitHub e fazer tudo o que o usuário pode fazer.{% if currentVersion == "free-pro-team@latest" %} * {% data reusables.apps.general-apps-restrictions %}{% endif %} -Para começar a desenvolver {% data variables.product.prodname_github_apps %}, comece com "[Criando um {% data variables.product.prodname_github_app %}](/apps/building-github-apps/creating-a-github-app/).{% if currentVersion == "free-pro-team@latest" %} Para aprender como usar {% data variables.product.prodname_github_app %} manifestos, que permitem que as pessoas criem {% data variables.product.prodname_github_apps %} pré-configurados, consulte "[Criando {% data variables.product.prodname_github_apps %} a partir de um manifesto](/apps/building-github-apps/creating-github-apps-from-a-manifest/).{% endif %} +Para começar a desenvolver {% data variables.product.prodname_github_apps %}, comece com "[Criar um {% data variables.product.prodname_github_app %}](/apps/building-github-apps/creating-a-github-app/). {% if currentVersion == "free-pro-team@latest" %} Para aprender como usar manifestos de {% data variables.product.prodname_github_app %}, que permite às pessoas criar {% data variables.product.prodname_github_apps %} pré-configurados, consulte "[Criar {% data variables.product.prodname_github_apps %} a partir de um manifesto](/apps/building-github-apps/creating-github-apps-from-a-manifest/).{% endif %} ### Sobre {% data variables.product.prodname_oauth_app %}s @@ -63,7 +63,7 @@ Tenha isso em mente ao criar {% data variables.product.prodname_oauth_app %}s: * Um {% data variables.product.prodname_oauth_app %} deve sempre atuar como o usuário autenticado {% data variables.product.prodname_dotcom %} em todo o {% data variables.product.prodname_dotcom %} (por exemplo, ao fornecer notificações de usuário). * Um {% data variables.product.prodname_oauth_app %} pode ser usado como um provedor de identidade, habilitando um "Login com {% data variables.product.prodname_dotcom %}" para o usuário autenticado. * Não crie um {% data variables.product.prodname_oauth_app %}, se desejar que seu aplicativo atue em um único repositório. Com o escopo do OAuth do `repositório`, {% data variables.product.prodname_oauth_app %}s podem agir em _todos os_ os repositórios dos usuários autenticados. -* Não crie um {% data variables.product.prodname_oauth_app %} para atuar como um aplicativo para sua equipe ou empresa. {% data variables.product.prodname_oauth_app %}s efetuam a autenticação como um único usuário. Portanto, se uma pessoa criar um {% data variables.product.prodname_oauth_app %} para uma empresa usar e depois sair da empresa, ninguém mais terá acesso a ele.{% if currentVersion == "free-pro-team@latest" %} +* Não crie um {% data variables.product.prodname_oauth_app %} para atuar como um aplicativo para sua equipe ou empresa. {% data variables.product.prodname_oauth_app %}s efetuam a autenticação como um único usuário. Portanto, se uma pessoa criar um {% data variables.product.prodname_oauth_app %} para a empresa usar e depois sair da empresa, ninguém mais terá acesso a ele.{% if currentVersion == "free-pro-team@latest" %} * {% data reusables.apps.oauth-apps-restrictions %}{% endif %} Para obter mais informações sobre {% data variables.product.prodname_oauth_app %}, consulte "[Criar um {% data variables.product.prodname_oauth_app %}](/apps/building-oauth-apps/creating-an-oauth-app/)" e "[Registrando seu aplicativo](/v3/guides/basics-of-authentication/#registering-your-app)". diff --git a/translations/pt-BR/content/developers/apps/activating-beta-features-for-apps.md b/translations/pt-BR/content/developers/apps/activating-beta-features-for-apps.md index bb623eff003e..52d20e2c2f69 100644 --- a/translations/pt-BR/content/developers/apps/activating-beta-features-for-apps.md +++ b/translations/pt-BR/content/developers/apps/activating-beta-features-for-apps.md @@ -15,7 +15,8 @@ versions: {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} -3. Selecione o {% data variables.product.prodname_github_app %} para o qual você deseja habilitar um recurso do beta. +3. Selecione o +{% data variables.product.prodname_github_app %} para o qual você deseja habilitar um recurso beta. {% data reusables.apps.beta_feature_activation %} ### Ativar recursos do beta para {% data variables.product.prodname_oauth_app %}s diff --git a/translations/pt-BR/content/developers/apps/authenticating-with-github-apps.md b/translations/pt-BR/content/developers/apps/authenticating-with-github-apps.md index 7e688ddb28d2..35bb00954c2c 100644 --- a/translations/pt-BR/content/developers/apps/authenticating-with-github-apps.md +++ b/translations/pt-BR/content/developers/apps/authenticating-with-github-apps.md @@ -37,7 +37,7 @@ Para gerar uma chave privada: {% endnote %} ### Verificar chaves privadas -O {% data variables.product.product_name %} gera uma impressão digital para cada par de chave privada e pública usando uma função hash {% if currentVersion ver_lt "enterprise-server@2.23" %}SHA-1{% else %}SHA-256{% endif %}. Você pode verificar se a sua chave privada corresponde à chave pública armazenada no {% data variables.product.product_name %}, gerando a impressão digital da sua chave privada e comparando-a com a impressão digital exibida no {% data variables.product.product_name %}. +{% data variables.product.product_name %} gera uma impressão digital para cada par de chave privada e pública usando a função de hash {% if currentVersion ver_lt "enterprise-server@2.23" %}SHA-1{% else %}SHA-256{% endif %} Você pode verificar se a sua chave privada corresponde à chave pública armazenada no {% data variables.product.product_name %}, gerando a impressão digital da sua chave privada e comparando-a com a impressão digital exibida no {% data variables.product.product_name %}. Para verificar uma chave privada: diff --git a/translations/pt-BR/content/developers/apps/authorizing-oauth-apps.md b/translations/pt-BR/content/developers/apps/authorizing-oauth-apps.md index 100ccb114f39..87f8be697567 100644 --- a/translations/pt-BR/content/developers/apps/authorizing-oauth-apps.md +++ b/translations/pt-BR/content/developers/apps/authorizing-oauth-apps.md @@ -1,5 +1,5 @@ --- -title: Autorizar aplicativos OAuth +title: Authorizing OAuth Apps intro: '{% data reusables.shortdesc.authorizing_oauth_apps %}' redirect_from: - /apps/building-integrations/setting-up-and-registering-oauth-apps/about-authorization-options-for-oauth-apps/ @@ -13,83 +13,84 @@ versions: enterprise-server: '*' --- -A implementação do OAuth de {% data variables.product.product_name %} é compatível com o [tipo de autorização para a concessão de código](https://tools.ietf.org/html/rfc6749#section-4.1){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} e com a [concessão de autorização para dispositivos](https://tools.ietf.org/html/rfc8628) do OAuth 2.0 para as aplicações que não têm acesso a um navegador web{% endif %}. +{% data variables.product.product_name %}'s OAuth implementation supports the standard [authorization code grant type](https://tools.ietf.org/html/rfc6749#section-4.1){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} and the OAuth 2.0 [Device Authorization Grant](https://tools.ietf.org/html/rfc8628) for apps that don't have access to a web browser{% endif %}. -Se você desejar ignorar a autorização do seu aplicativo da forma-padrão, como no teste do seu aplicativo, você poderá usar o fluxo do aplicativo [que não é web](#non-web-application-flow). +If you want to skip authorizing your app in the standard way, such as when testing your app, you can use the [non-web application flow](#non-web-application-flow). {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -Para autorizar o seu aplicativo OAuth, considere qual fluxo de autorização melhor se adequa ao seu aplicativo. +To authorize your OAuth app, consider which authorization flow best fits your app. -- [Fluxo de aplicativos web](#web-application-flow): Usado para autorizar usuários para aplicativos OAuth padrão executados no navegador. (O [tipo implícito de concessão](https://tools.ietf.org/html/rfc6749#section-4.2) não é compatível) -- [fluxo de dispositivo](#device-flow): Usado para aplicativos sem cabeçalho, como ferramentas de CLI. +- [web application flow](#web-application-flow): Used to authorize users for standard OAuth apps that run in the browser. (The [implicit grant type](https://tools.ietf.org/html/rfc6749#section-4.2) is not supported.) +- [device flow](#device-flow): Used for headless apps, such as CLI tools. {% else %} -Para os aplicativos-padrão que são executados no navegador, use o [fluxo do aplicativo web](#web-application-flow) para obter um código de autorização e trocá-lo por um token. (O [tipo implícito de concessão](https://tools.ietf.org/html/rfc6749#section-4.2) não é compatível) +For standard apps that run in the browser, use the [web application flow](#web-application-flow) to obtain an authorization code and exchange it for a token. (The [implicit grant type](https://tools.ietf.org/html/rfc6749#section-4.2) is not supported.) {% endif %} -### Fluxo do aplicativo web +### Web application flow {% note %} -**Observação:** Se você está criando um aplicativo GitHub, você ainda pode usar o fluxo do aplicativo web OAuth, mas a configuração tem algumas diferenças importantes. Consulte "[Identificando e autorizando usuários para aplicativos GitHub](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/)" para obter mais informações. +**Note:** If you are building a GitHub App, you can still use the OAuth web application flow, but the setup has some important differences. See "[Identifying and authorizing users for GitHub Apps](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/)" for more information. {% endnote %} -O fluxo do aplicativo web para autorizar os usuários para seu aplicativo é: +The web application flow to authorize users for your app is: -1. Os usuários são redirecionados para solicitar sua identidade do GitHub -2. Os usuários são redirecionados de volta para o seu site pelo GitHub -3. Seu aplicativo acessa a API com o token de acesso do usuário +1. Users are redirected to request their GitHub identity +2. Users are redirected back to your site by GitHub +3. Your app accesses the API with the user's access token -#### 1. Solicitar identidade do GitHub de um usuário +#### 1. Request a user's GitHub identity GET {% data variables.product.oauth_host_code %}/login/oauth/authorize -Quando seu aplicativo GitHub especifica um parâmetro do `login`, ele solicita aos usuários com uma conta específica que podem usar para iniciar sessão e autorizar seu aplicativo. +When your GitHub App specifies a `login` parameter, it prompts users with a specific account they can use for signing in and authorizing your app. -##### Parâmetros +##### Parameters -| Nome | Tipo | Descrição | -| -------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `client_id` | `string` | **Obrigatório**. O ID do cliente que você recebeu do GitHub quando você {% if currentVersion == "free-pro-team@latest" %}[fez o cadastro](https://github.com/settings/applications/new){% else %}registrados{% endif %}. | -| `redirect_uri` | `string` | A URL no seu aplicativo para o qual os usuários serão enviados após a autorização. Veja os detalhes abaixo sobre [redirecionamento das urls](#redirect-urls). | -| `login` | `string` | Sugere uma conta específica para iniciar a sessão e autorizar o aplicativo. | -| `escopo` | `string` | Uma lista de [escopos](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/) delimitada por espaço. Caso não seja fornecido, o `escopo`-padrão será uma lista vazia para usuários que não autorizaram nenhum escopo para o aplicativo. Para usuários que têm escopos autorizados para o aplicativo, a página de autorização OAuth com a lista de escopos não será exibida para o usuário. Em vez disso, esta etapa do fluxo será concluída automaticamente com o conjunto de escopos que o usuário autorizou para o aplicativo. Por exemplo, se um usuário já executou o fluxo web duas vezes e autorizou um token com escopo do `usuário` e outro token com o escopo do `repositório`, um terceiro fluxo web que não fornece um escopo `` receberá um token com os escopos do `usuário` e do `repositório`. | -| `estado` | `string` | {% data reusables.apps.state_description %} | -| `allow_signup` | `string` | Independentemente de os usuários serem autenticados, eles receberão uma opção para inscrever-se no GitHub durante o fluxo do OAuth. O padrão é `verdadeiro`. Use `falso` quando uma política proibir inscrições. | +Name | Type | Description +-----|------|-------------- +`client_id`|`string` | **Required**. The client ID you received from GitHub when you {% if currentVersion == "free-pro-team@latest" %}[registered](https://github.com/settings/applications/new){% else %}registered{% endif %}. +`redirect_uri`|`string` | The URL in your application where users will be sent after authorization. See details below about [redirect urls](#redirect-urls). +`login` | `string` | Suggests a specific account to use for signing in and authorizing the app. +`scope`|`string` | A space-delimited list of [scopes](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/). If not provided, `scope` defaults to an empty list for users that have not authorized any scopes for the application. For users who have authorized scopes for the application, the user won't be shown the OAuth authorization page with the list of scopes. Instead, this step of the flow will automatically complete with the set of scopes the user has authorized for the application. For example, if a user has already performed the web flow twice and has authorized one token with `user` scope and another token with `repo` scope, a third web flow that does not provide a `scope` will receive a token with `user` and `repo` scope. +`state` | `string` | {% data reusables.apps.state_description %} +`allow_signup`|`string` | Whether or not unauthenticated users will be offered an option to sign up for GitHub during the OAuth flow. The default is `true`. Use `false` when a policy prohibits signups. -#### 2. Os usuários são redirecionados de volta para o seu site pelo GitHub +#### 2. Users are redirected back to your site by GitHub -Se o usuário aceitar a sua solicitação, o {% data variables.product.product_name %} redireciona de volta para seu site com `código` temporário em um parâmetro de código, bem como o estado que você forneceu na etapa anterior em um `parâmetro de estado`. O código temporário irá expirar após 10 minutos. Se os estados não corresponderem, significa que uma terceira criou a solicitação, e você deverá abortar o processo. +If the user accepts your request, {% data variables.product.product_name %} redirects back to your site with a temporary `code` in a code parameter as well as the state you provided in the previous step in a `state` parameter. The temporary code will expire after 10 minutes. If the states don't match, then a third party created the request, and you should abort the process. -Troque este `código` por um token de acesso: +Exchange this `code` for an access token: POST {% data variables.product.oauth_host_code %}/login/oauth/access_token -##### Parâmetros +##### Parameters -| Nome | Tipo | Descrição | -| --------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `client_id` | `string` | **Obrigatório.** O ID do cliente que você recebeu do {% data variables.product.product_name %} para o seu {% data variables.product.prodname_github_app %}. | -| `client_secret` | `string` | **Obrigatório.** O segredo do cliente que recebeu do {% data variables.product.product_name %} para o seu {% data variables.product.prodname_github_app %}. | -| `código` | `string` | **Obrigatório.** O código que você recebeu como resposta ao Passo 1. | -| `redirect_uri` | `string` | A URL do seu aplicativo para onde os usuários são enviados após a autorização. | -| `estado` | `string` | A string aleatória inexplicável que você forneceu na etapa 1. | +Name | Type | Description +-----|------|-------------- +`client_id` | `string` | **Required.** The client ID you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_github_app %}. +`client_secret` | `string` | **Required.** The client secret you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_github_app %}. +`code` | `string` | **Required.** The code you received as a response to Step 1. +`redirect_uri` | `string` | The URL in your application where users are sent after authorization. +`state` | `string` | The unguessable random string you provided in Step 1. -##### Resposta +##### Response -Por padrão, a resposta assume o seguinte formato: +By default, the response takes the following form: access_token=e72e16c7e42f292c6912e7710c838347ae178b4a&token_type=bearer -Você também pode receber o conteúdo em diferentes formatos, dependendo do cabeçalho Aceitar: +You can also receive the content in different formats depending on the Accept +header: Accept: application/json {"access_token":"e72e16c7e42f292c6912e7710c838347ae178b4a", "scope":"repo,gist", "token_type":"bearer"} - + Accept: application/xml bearer @@ -97,51 +98,50 @@ Você também pode receber o conteúdo em diferentes formatos, dependendo do cab e72e16c7e42f292c6912e7710c838347ae178b4a -#### 3. Use o token de acesso para acessar a API +#### 3. Use the access token to access the API -O token de acesso permite que você faça solicitações para a API em nome de um usuário. +The access token allows you to make requests to the API on a behalf of a user. - Autorização: token OUTH-TOKEN + Authorization: token OAUTH-TOKEN GET {% data variables.product.api_url_code %}/user -Por exemplo, no cURL você pode definir o cabeçalho de autorização da seguinte forma: +For example, in curl you can set the Authorization header like this: ```shell curl -H "Authorization: token OAUTH-TOKEN" {% data variables.product.api_url_pre %}/user ``` {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -### Fluxo de dispositivo +### Device flow {% note %} -**Observação:** O fluxo do dispositivo está na versão beta pública e sujeito a alterações.{% if currentVersion == "free-pro-team@latest" %} Para ativar este recurso beta, consulte "[Ativar recursos beta para aplicativos](/developers/apps/activating-beta-features-for-apps)."{% endif %} +**Note:** The device flow is in public beta and subject to change.{% if currentVersion == "free-pro-team@latest" %} To enable this beta feature, see "[Activating beta features for apps](/developers/apps/activating-beta-features-for-apps)."{% endif %} {% endnote %} -O fluxo de dispositivos permite que você autorize usuários para um aplicativo sem cabeçalho, como uma ferramenta de CLI ou um gerenciador de credenciais do Git. +The device flow allows you to authorize users for a headless app, such as a CLI tool or Git credential manager. -#### Visão geral do fluxo do dispositivo +#### Overview of the device flow -1. O seu aplicativo solicita o dispositivo e o código de verificação do usuário e obtém a URL de autorização em que o usuário digitará o código de verificação do usuário. -2. O aplicativo solicita que o usuário insira um código de verificação em {% data variables.product.device_authorization_url %}. -3. O aplicativo pesquisa status de autenticação do usuário. Uma vez que o usuário tenha autorizado o dispositivo, o aplicativo poderá fazer chamadas de API com um novo token de acesso. +1. Your app requests device and user verification codes and gets the authorization URL where the user will enter the user verification code. +2. The app prompts the user to enter a user verification code at {% data variables.product.device_authorization_url %}. +3. The app polls for the user authentication status. Once the user has authorized the device, the app will be able to make API calls with a new access token. -#### Passo 1: O aplicativo solicita o dispositivo e os códigos de verificação de usuário do GitHub +#### Step 1: App requests the device and user verification codes from GitHub POST {% data variables.product.oauth_host_code %}/login/device/code -O seu aplicativo deve solicitar um código de verificação e uma URL de verificação que o aplicativo usará para solicitar que o usuário seja autenticado na próxima etapa. Essa solicitação também retorna um código de verificação de dispositivo que o aplicativo deve usar para receber um token de acesso e verificar o status da autenticação do usuário. - -##### Parâmetros de entrada +Your app must request a user verification code and verification URL that the app will use to prompt the user to authenticate in the next step. This request also returns a device verification code that the app must use to receive an access token and check the status of user authentication. -| Nome | Tipo | Descrição | -| ----------- | -------- | -------------------------------------------------------------------------------------------------------------------------- | -| `client_id` | `string` | **Obrigatório.** O ID do cliente que você recebeu do {% data variables.product.product_name %} para o seu aplicativo. | -| `escopo` | `string` | O escopo ao qual o seu aplicativo está solicitando acesso. | +##### Input Parameters -##### Resposta +Name | Type | Description +-----|------|-------------- +`client_id` | `string` | **Required.** The client ID you received from {% data variables.product.product_name %} for your app. +`scope` | `string` | The scope that your app is requesting access to. +##### Response {% if currentVersion == "free-pro-team@latest" %} ```JSON @@ -165,41 +165,41 @@ O seu aplicativo deve solicitar um código de verificação e uma URL de verific ``` {% endif %} -##### Parâmetros de resposta +##### Response parameters -| Nome | Tipo | Descrição | -| ------------------ | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `device_code` | `string` | O código de verificação do dispositivo tem 40 caracteres e é usado para verificar o dispositivo. | -| `user_code` | `string` | O código de verificação do usuário é exibido no dispositivo para que o usuário possa inserir o código no navegador. Este código tem 8 caracteres com um hífen no meio. | -| `verification_uri` | `string` | A URL de verificação em que os usuários devem digitar o código do usuário ``: {% data variables.product.device_authorization_url %}. | -| `expires_in` | `inteiro` | O número de segundos antes dos códigos `device_code` e `user_code` expirarem. O padrão é 900 segundos ou 15 minutos. | -| `interval` | `inteiro` | O número mínimo de segundos que decorridos antes de você poder fazer uma nova solicitação de token de acesso (`POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`) para concluir a autorização do dispositivo. Por exemplo, se o intervalo for 5, você não poderá fazer uma nova solicitação a partir de 5 segundos. Se você fizer mais de uma solicitação em 5 segundos, você atingirá o limite de taxa e receberá uma mensagem de erro `slow_down`. | +Name | Type | Description +-----|------|-------------- +`device_code` | `string` | The device verification code is 40 characters and used to verify the device. +`user_code` | `string` | The user verification code is displayed on the device so the user can enter the code in a browser. This code is 8 characters with a hyphen in the middle. +`verification_uri` | `string` | The verification URL where users need to enter the `user_code`: {% data variables.product.device_authorization_url %}. +`expires_in` | `integer`| The number of seconds before the `device_code` and `user_code` expire. The default is 900 seconds or 15 minutes. +`interval` | `integer` | The minimum number of seconds that must pass before you can make a new access token request (`POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`) to complete the device authorization. For example, if the interval is 5, then you cannot make a new request until 5 seconds pass. If you make more than one request over 5 seconds, then you will hit the rate limit and receive a `slow_down` error. -#### Passo 2: Solicite ao usuário que insira o código do usuário em um navegador +#### Step 2: Prompt the user to enter the user code in a browser -O seu dispositivo mostrará o código de verificação do usuário e solicitará que o usuário insira o código em {% data variables.product.device_authorization_url %}. +Your device will show the user verification code and prompt the user to enter the code at {% data variables.product.device_authorization_url %}. - ![Campo para digitar o código de verificação do usuário exibido no seu dispositivo](/assets/images/github-apps/device_authorization_page_for_user_code.png) + ![Field to enter the user verification code displayed on your device](/assets/images/github-apps/device_authorization_page_for_user_code.png) -#### Passo 3: O aplicativo solicita que o GitHub verifique se o usuário autorizou o dispositivo +#### Step 3: App polls GitHub to check if the user authorized the device POST {% data variables.product.oauth_host_code %}/login/oauth/access_token -O seu aplicativo fará solicitações de autorização do dispositivo que pesquisem `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`, até que o dispositivo e códigos de usuário expirem ou o usuário autorizem com sucesso o aplicativo com um código de usuário válido. O aplicativo deve usar o `intervalo` mínimo de sondagem recuperado na etapa 1 para evitar erros de limite de taxa. Para obter mais informações, consulte "[Limites de taxa para o fluxo do dispositivo](#rate-limits-for-the-device-flow)". +Your app will make device authorization requests that poll `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`, until the device and user codes expire or the user has successfully authorized the app with a valid user code. The app must use the minimum polling `interval` retrieved in step 1 to avoid rate limit errors. For more information, see "[Rate limits for the device flow](#rate-limits-for-the-device-flow)." -O usuário deve inserir um código válido em de 15 minutos (ou 900 segundos). Após 15 minutos, você deverá solicitar um novo código de autorização do dispositivo com `POST {% data variables.product.oauth_host_code %}/login/dispositivo/código`. +The user must enter a valid code within 15 minutes (or 900 seconds). After 15 minutes, you will need to request a new device authorization code with `POST {% data variables.product.oauth_host_code %}/login/device/code`. -Uma vez que o usuário tenha autorizado, o aplicativo receberá um token de acesso que poderá ser usado para fazer solicitações para a API em nome de um usuário. +Once the user has authorized, the app will receive an access token that can be used to make requests to the API on behalf of a user. -##### Parâmetros de entrada +##### Input parameters -| Nome | Tipo | Descrição | -| ------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `client_id` | `string` | **Obrigatório.** O ID do cliente que você recebeu do {% data variables.product.product_name %} para o seu {% data variables.product.prodname_oauth_app %}. | -| `device_code` | `string` | **Obrigatório.** O código de verificação do dispositivo que você recebeu da solicitação `POST {% data variables.product.oauth_host_code %}/login/dispositivo/código`. | -| `grant_type` | `string` | **Obrigatório.** O tipo de concessão deve ser `urn:ietf:params:oauth:grant-type:device_code`. | +Name | Type | Description +-----|------|-------------- +`client_id` | `string` | **Required.** The client ID you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_oauth_app %}. +`device_code` | `string` | **Required.** The device verification code you received from the `POST {% data variables.product.oauth_host_code %}/login/device/code` request. +`grant_type` | `string` | **Required.** The grant type must be `urn:ietf:params:oauth:grant-type:device_code`. -##### Resposta +##### Response ```json { @@ -209,44 +209,50 @@ Uma vez que o usuário tenha autorizado, o aplicativo receberá um token de aces } ``` -#### Limites de taxa para o fluxo do dispositivo +#### Rate limits for the device flow -Quando um usuário envia o código de verificação no navegador, existe um limite de taxa máximo de 50 submissões em uma hora por aplicativo. +When a user submits the verification code on the browser, there is a there is a rate limit of 50 submissions in an hour per application. -Se você fizer mais de uma solicitação de token de acesso (`POST {% data variables.product.oauth_host_code %}/login/oauth/oaccess_token`) no período mínimo necessário entre solicitações (ou `intervalo`), você atingirá o limite de taxa e receberá uma resposta de erro `slow_down`. A resposta de erro `slow_down`adiciona 5 segundos ao último `intervalo`. Para obter mais informações, consulte [Erros para o fluxo do dispositivo](#errors-for-the-device-flow). +If you make more than one access token request (`POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`) within the required minimum timeframe between requests (or `interval`), you'll hit the rate limit and receive a `slow_down` error response. The `slow_down` error response adds 5 seconds to the last `interval`. For more information, see the [Errors for the device flow](#errors-for-the-device-flow). -#### Códigos de erro para o fluxo do dispositivo +#### Error codes for the device flow -| Código do erro | Descrição | -| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `authorization_pending` | Este erro ocorre quando a solicitação de autorização está pendente e o usuário ainda não inseriu o código do usuário. Espera-se que o aplicativo continue fazendo a sondagem da solicitação `POST {% data variables.product.oauth_host_code %}/login/oauth/oaccess_token` sem exceder o [`intervalo`](#response-parameters), que exige um número mínimo de segundos entre cada solicitação. | -| `slow_down` | Ao receber o erro `slow_down`, são adicionados 5 segundos extras ao intervalo mínimo `` ou período de tempo necessário entre as suas solicitações usando `POST {% data variables.product.oauth_host_code %}/login/oauth/oaccess_token`. Por exemplo, se o intervalo inicial for necessário pelo menos 5 segundos entre as solicitações e você receber uma resposta de erro de `slow_down`, você deverá aguardar pelo menos 10 segundos antes de fazer uma nova solicitação para um token de acesso OAuth. A resposta de erro inclui o novo `intervalo` que você deve usar. | -| `expired_token` | Se o código do dispositivo expirou, você verá o erro `token_expired`. Você deve fazer uma nova solicitação para um código de dispositivo. | -| `unsupported_grant_type` | O tipo de concessão deve ser `urn:ietf:params:oauth:grant-type:device_code` e incluído como um parâmetro de entrada quando você faz a sondagem da solicitação do token do OAuth `POST {% data variables.product.oauth_host_code %}/login/oauth/oaccess_token`. | -| `incorrect_client_credentials` | Para o fluxo do dispositivo, você deve passar o ID de cliente do aplicativo, que pode ser encontrado na página de configurações do aplicativo. O `client_secret` não é necessário para o fluxo do dispositivo. | -| `incorrect_device_code` | O device_code fornecido não é válido. | -| `access_denied` | Quando um usuário clica em cancelar durante o processo de autorização, você receberá uma mensagem de erro de `access_denied` e o usuário não poderá usar o código de verificação novamente. | +| Error code | Description | +|----|----| +| `authorization_pending`| This error occurs when the authorization request is pending and the user hasn't entered the user code yet. The app is expected to keep polling the `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token` request without exceeding the [`interval`](#response-parameters), which requires a minimum number of seconds between each request. | +| `slow_down` | When you receive the `slow_down` error, 5 extra seconds are added to the minimum `interval` or timeframe required between your requests using `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`. For example, if the starting interval required at least 5 seconds between requests and you get a `slow_down` error response, you must now wait a minimum of 10 seconds before making a new request for an OAuth access token. The error response includes the new `interval` that you must use. +| `expired_token` | If the device code expired, then you will see the `token_expired` error. You must make a new request for a device code. +| `unsupported_grant_type` | The grant type must be `urn:ietf:params:oauth:grant-type:device_code` and included as an input parameter when you poll the OAuth token request `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`. +| `incorrect_client_credentials` | For the device flow, you must pass your app's client ID, which you can find on your app settings page. The `client_secret` is not needed for the device flow. +| `incorrect_device_code` | The device_code provided is not valid. +| `access_denied` | When a user clicks cancel during the authorization process, you'll receive a `access_denied` error and the user won't be able to use the verification code again. -Para obter mais informações, consulte "[Concessão de Autorização do Dispositivo OAuth 2.0](https://tools.ietf.org/html/rfc8628#section-3.5)". +For more information, see the "[OAuth 2.0 Device Authorization Grant](https://tools.ietf.org/html/rfc8628#section-3.5)." {% endif %} -### Fluxo do aplicativo que não são da web +### Non-Web application flow -A autenticação que não é da web está disponível para situações limitadas como testes. Se necessário, você pode usar a [autenticação básica](/v3/auth#basic-authentication) para criar um token de acesso usando a sua [página pessoal de configurações de tokens de acesso](/articles/creating-an-access-token-for-command-line-use). Essa técnica permite ao usuário revogar o acesso a qualquer momento. +Non-web authentication is available for limited situations like testing. If you need to, you can use [Basic Authentication](/v3/auth#basic-authentication) to create a personal access token using your [Personal access tokens settings page](/articles/creating-an-access-token-for-command-line-use). This technique enables the user to revoke access at any time. {% note %} -**Observação:** Quando usar o fluxo do aplicativo que não é web para criar um token do OAuth2, certifique-se de entender como [trabalhar com a autenticação de dois fatores](/v3/auth/#working-with-two-factor-authentication) se você ou seus usuários tiverem a autenticação de dois fatores habilitada. +**Note:** When using the non-web application flow to create an OAuth2 token, make sure to understand how to [work with +two-factor authentication](/v3/auth/#working-with-two-factor-authentication) if +you or your users have two-factor authentication enabled. {% endnote %} -### URLs de redirecionamento +### Redirect URLs + +The `redirect_uri` parameter is optional. If left out, GitHub will +redirect users to the callback URL configured in the OAuth Application +settings. If provided, the redirect URL's host and port must exactly +match the callback URL. The redirect URL's path must reference a +subdirectory of the callback URL. -O parâmetro `redirect_uri` é opcional. Se ignorado, o GitHub redirecionará os usuários para a URL de retorno de chamada definida nas configurações do aplicativo OAuth. Se fornecido, o host e porta do URL de redirecionamento deve exatamente corresponder à URL de retorno de chamada. O caminho da URL de redirecionamento deve fazer referência uma subpasta da URL de retorno de chamada. + CALLBACK: http://example.com/path - RETORNO DE CHAMADA: http://example.com/path - GOOD: http://example.com/path GOOD: http://example.com/path/subdir/other BAD: http://example.com/bar @@ -255,29 +261,29 @@ O parâmetro `redirect_uri` é opcional. Se ignorado, o GitHub redirecionará os BAD: http://oauth.example.com:8080/path BAD: http://example.org -#### URLs de redirecionamento do Localhost +#### Localhost redirect urls -O parâmetro opcional `redirect_uri` também pode ser usado para URLs do localhhost. Se o aplicativo especificar uma URL do localhost e uma porta, após a autorização, os usuários do aplicativo serão redirecionados para a URL e porta fornecidas. O `redirect_uri` não precisa corresponder à porta especificada na URL de retorno de chamada do aplicativo. +The optional `redirect_uri` parameter can also be used for localhost URLs. If the application specifies a localhost URL and a port, then after authorizing the application users will be redirected to the provided URL and port. The `redirect_uri` does not need to match the port specified in the callback url for the app. -Para a URL de retorno de chamada `http://localhost/path`, você poderá usar este `redirect_uri`: +For the `http://localhost/path` callback URL, you can use this `redirect_uri`: http://localhost:1234/path -### Criar vários tokens para aplicativos OAuth +### Creating multiple tokens for OAuth Apps -Você pode criar vários tokens para uma combinação de usuário/aplicativo/escopo para criar tokens para casos de uso específicos. +You can create multiple tokens for a user/application/scope combination to create tokens for specific use cases. -Isso é útil se o seu aplicativo OAuth for compatível com um fluxo de trabalho que usa o GitHub para iniciar sessão e exigir apenas informações básicas do usuário. Outro fluxo de trabalho pode exigir acesso aos repositórios privados de um usuário. Ao usar vários tokens, o seu aplicativo OAuth pode realizar o fluxo web para cada caso, solicitando apenas os escopos necessários. Se um usuário usar apenas seu aplicativo para iniciar a sessão, ele nunca será obrigado a conceder acesso do aplicativo OAuth aos seus repositórios privados. +This is useful if your OAuth App supports one workflow that uses GitHub for sign-in and only requires basic user information. Another workflow may require access to a user's private repositories. Using multiple tokens, your OAuth App can perform the web flow for each use case, requesting only the scopes needed. If a user only uses your application to sign in, they are never required to grant your OAuth App access to their private repositories. -Há um limite para o número de tokens emitidos por combinação de usuário/aplicativo/escopo. Se seu aplicativo solicitar tokens suficientes para ultrapassar um dos limites, os tokens antigos _com o mesmo escopo sendo solicitado_ irão parar de funcionar. +There is a limit to the number of tokens that are issued per user/application/scope combination. If your application requests enough tokens to go over one of the limits, older tokens _with the same scope being requested_ will stop working. {% data reusables.apps.deletes_ssh_keys %} -### Direcionar os usuários para revisar seus acessos +### Directing users to review their access -Você pode vincular informações sobre a autorização de um aplicativo OAuth para que os usuários possam revisar e revogar as autorizações do seu aplicativo. +You can link to authorization information for an OAuth App so that users can review and revoke their application authorizations. -Para criar esse vínculo, você precisará do `client_id` dos aplicativos OAuth, que você recebeu do GitHub quando fez o cadastro no aplicativo. +To build this link, you'll need your OAuth Apps `client_id` that you received from GitHub when you registered the application. ``` {% data variables.product.oauth_host_code %}/settings/connections/applications/:client_id @@ -285,14 +291,14 @@ Para criar esse vínculo, você precisará do `client_id` dos aplicativos OAuth, {% tip %} -**Dica:** Para saber mais sobre os recursos que seu aplicativo OAuth pode acessar para um usuário, consulte "[Descobrindo recursos para um usuário](/v3/guides/discovering-resources-for-a-user/). " +**Tip:** To learn more about the resources that your OAuth App can access for a user, see "[Discovering resources for a user](/v3/guides/discovering-resources-for-a-user/)." {% endtip %} -### Solução de Problemas +### Troubleshooting -* "[Solucionando erros de solicitação de autorização](/apps/managing-oauth-apps/troubleshooting-authorization-request-errors)" -* "[Solucionando erros na requisição de token de acesso do aplicativo OAuth](/apps/managing-oauth-apps/troubleshooting-oauth-app-access-token-request-errors)" +* "[Troubleshooting authorization request errors](/apps/managing-oauth-apps/troubleshooting-authorization-request-errors)" +* "[Troubleshooting OAuth App access token request errors](/apps/managing-oauth-apps/troubleshooting-oauth-app-access-token-request-errors)" {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -* "[Erros do fluxo do dispositivo](#errors-for-the-device-flow)" +* "[Device flow errors](#errors-for-the-device-flow)" {% endif %} diff --git a/translations/pt-BR/content/developers/apps/creating-a-custom-badge-for-your-github-app.md b/translations/pt-BR/content/developers/apps/creating-a-custom-badge-for-your-github-app.md index 872543de5f6b..53b6eee0f319 100644 --- a/translations/pt-BR/content/developers/apps/creating-a-custom-badge-for-your-github-app.md +++ b/translations/pt-BR/content/developers/apps/creating-a-custom-badge-for-your-github-app.md @@ -14,7 +14,7 @@ Por padrão, um aplicativo GitHub novo terá um [identicon](https://github.com/b Após criar um aplicativo GitHub, você poderá personalizar o selo do seu aplicativo fazendo o upload de um logotipo e selecionando uma cor de fundo. Um selo é uma imagem de logotipo quadrado dentro de um distintivo circular. Você pode escolher uma cor de fundo para o selo, que poderá distinguir seu aplicativo visualmente. -Seu logotipo deve ser um arquivo PNG, JPG ou GIF com tamanho inferior a 1 MB. Para obter a melhor qualidade de renderização, recomendamos um tamanho de imagem de, pelo menos, 200px x 200px. {% if currentVersion == "free-pro-team@latest" %}Consulte "[Dicas para imagens de logotipo e selo](/marketplace/listing-on-github-marketplace/writing-github-marketplace-listing-descriptions/#guidelines-for-logos)" para obter mais orientações sobre a personalização de selos.{% endif %} +Seu logotipo deve ser um arquivo PNG, JPG ou GIF com tamanho inferior a 1 MB. Para obter a melhor qualidade de renderização, recomendamos um tamanho de imagem de, pelo menos, 200px x 200px. {% if currentVersion == "free-pro-team@latest" %}Veja "[Dicas para imagens de logotipo e selos](/marketplace/listing-on-github-marketplace/writing-github-marketplace-listing-descriptions/#guidelines-for-logos)" para obter mais orientações sobre a personalização dos selos.{% endif %} {% if currentVersion == "free-pro-team@latest" %} @@ -30,7 +30,7 @@ Para criar um selo personalizado: {% data reusables.user-settings.modify_github_app %} 5. Em "Exibir informações", arraste e solte uma imagem de uma pasta local ou clique em **Fazer upload de um logotipo** para selecionar uma imagem do seu computador. ![Faça o upload de um logotipo](/assets/images/github-apps/github_apps_upload_logo.png) 6. Recorte sua imagem. Ao terminar, clique em **Definir novo avatar**. ![Corte e defina o logotipo ](/assets/images/github-apps/github_apps_crop_and_set_avatar.png) -7. Em "Cor de fundo do selo", digite o [código de cor hexadecimal](http://www.color-hex.com/) da cor de fundo para o seu selo. {% if currentVersion == "free-pro-team@latest" %}**Observação:** O campo de entrada da "Cor de fundo do selo" só aparecerá depois que você fizer o upload de um logo tipo do aplicativo.{% endif %} ![Cor de fundo do selo](/assets/images/github-apps/github_apps_badge_background_color.png) +7. Em "Cor de fundo do selo", digite o [código de cor hexadecimal](http://www.color-hex.com/) da cor de fundo para o seu selo. {% if currentVersion == "free-pro-team@latest" %}**Observação:** O campo de entrada "Cor de fundo do selo" só aparecerá depois que você enviar um logotipo do aplicativo.{% endif %} ![Cor de fundo do selo](/assets/images/github-apps/github_apps_badge_background_color.png) {% if currentVersion == "free-pro-team@latest" %} diff --git a/translations/pt-BR/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md b/translations/pt-BR/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md index 8d5593039696..3adb7e2f3dfd 100644 --- a/translations/pt-BR/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md +++ b/translations/pt-BR/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md @@ -8,16 +8,13 @@ versions: enterprise-server: '*' --- - - - Por padrão, um aplicativo OAuth novo terá um [identicon](https://github.com/blog/1586-identicons) gerado automaticamente. O selo do identicon assemelha-se a isso: ![Identicon](/assets/images/identicon.png) Após criar um aplicativo OAuth, você poderá personalizar o selo do seu aplicativo fazendo o upload de um logotipo e selecionando uma cor de fundo. Um selo é uma imagem de logotipo quadrado dentro de um distintivo circular. Você pode escolher uma cor de fundo para o selo, que pode ser usado para distinguir seu aplicativo visualmente. -Seu logotipo deve ser um arquivo PNG, JPG ou GIF com tamanho inferior a 1 MB. Para obter a melhor qualidade de renderização, recomendamos um tamanho de imagem de, pelo menos, 200px x 200px. {% if currentVersion == "free-pro-team@latest" %}Consulte "[Dicas para imagens de logotipo e selo](/marketplace/listing-on-github-marketplace/writing-github-marketplace-listing-descriptions/#guidelines-for-logos)" para obter mais orientações sobre a personalização de selos.{% endif %} +Seu logotipo deve ser um arquivo PNG, JPG ou GIF com tamanho inferior a 1 MB. Para obter a melhor qualidade de renderização, recomendamos um tamanho de imagem de, pelo menos, 200px x 200px. {% if currentVersion == "free-pro-team@latest" %}Veja "[Dicas para imagens de logotipo e selos](/marketplace/listing-on-github-marketplace/writing-github-marketplace-listing-descriptions/#guidelines-for-logos)" para obter mais orientações sobre a personalização dos selos.{% endif %} {% if currentVersion == "free-pro-team@latest" %} @@ -31,10 +28,10 @@ Para criar um selo personalizado: {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.oauth_apps %} {% data reusables.user-settings.modify_oauth_app %} -5. Em "Logotipo do aplicativo", arraste e solte uma imagem de uma pasta local ou clique em **Fazer upload de um logotipo** para selecionar uma imagem do seu computador. ![Faça o upload de um logotipo](/assets/images/oauth-apps/oauth_apps_upload_logo.png) +1. Em "Logotipo do aplicativo", arraste e solte uma imagem de uma pasta local ou clique em **Fazer upload de um logotipo** para selecionar uma imagem do seu computador. ![Faça o upload de um logotipo](/assets/images/oauth-apps/oauth_apps_upload_logo.png) 6. Recorte sua imagem. Ao terminar, clique **Definir o novo logotipo do aplicativo**. ![Corte e defina o logotipo](/assets/images/oauth-apps/oauth_apps_crop_and_set_logo.png) 7. Em "Cor de fundo do selo", digite o [código de cor hexadecimal](http://www.color-hex.com/) da cor de fundo para o seu selo. -{% if currentVersion == "free-pro-team@latest" %}**Observação:** O campo de entrada da "Cor de fundo do selo" ficará visível após o upload do logotipo do aplicativo.{% endif %} +{% if currentVersion == "free-pro-team@latest" %}**Observação:** O campo de entrada "Cor de fundo do selo" ficará visível após o upload de um logotipo do aplicativo.{% endif %} ![Cor de fundo do selo](/assets/images/oauth-apps/oauth_apps_badge_background_color.png) {% data reusables.user-settings.update_oauth_app %} diff --git a/translations/pt-BR/content/developers/apps/creating-a-github-app-from-a-manifest.md b/translations/pt-BR/content/developers/apps/creating-a-github-app-from-a-manifest.md index 6510d3cfea5f..cfd8744a4e78 100644 --- a/translations/pt-BR/content/developers/apps/creating-a-github-app-from-a-manifest.md +++ b/translations/pt-BR/content/developers/apps/creating-a-github-app-from-a-manifest.md @@ -71,9 +71,9 @@ O objeto `hook_attributes` tem a chave a seguir: ##### Parâmetros - | Nome | Tipo | Descrição | - | -------- | -------- | ------------------------------------------------ | - | `estado` | `string` | {% data reusables.apps.state_description %} | + | Nome | Tipo | Descrição | + | -------- | -------- | ------------------------------------------- | + | `estado` | `string` | {% data reusables.apps.state_description %} ##### Exemplos diff --git a/translations/pt-BR/content/developers/apps/creating-a-github-app-using-url-parameters.md b/translations/pt-BR/content/developers/apps/creating-a-github-app-using-url-parameters.md index 3bee283d72fe..d718d3f89bdd 100644 --- a/translations/pt-BR/content/developers/apps/creating-a-github-app-using-url-parameters.md +++ b/translations/pt-BR/content/developers/apps/creating-a-github-app-using-url-parameters.md @@ -1,6 +1,6 @@ --- -title: Criar um aplicativo GitHub usando parâmetros de URL -intro: 'Você pode pré-selecionar as configurações de um novo {% data variables.product.prodname_github_app %} usando URL [parâmetros de consulta](https://en.wikipedia.org/wiki/Query_string) para definir rapidamente a configuração do novo {% data variables.product.prodname_github_app %}.' +title: Creating a GitHub App using URL parameters +intro: 'You can preselect the settings of a new {% data variables.product.prodname_github_app %} using URL [query parameters](https://en.wikipedia.org/wiki/Query_string) to quickly set up the new {% data variables.product.prodname_github_app %}''s configuration.' redirect_from: - /apps/building-github-apps/creating-github-apps-using-url-parameters versions: @@ -9,111 +9,111 @@ versions: --- -### Sobre parâmetros de URL do {% data variables.product.prodname_github_app %}. +### About {% data variables.product.prodname_github_app %} URL parameters -Você pode adicionar parâmetros de consulta a essas URLs para pré-selecionar a configuração de um {% data variables.product.prodname_github_app %} em uma conta pessoal ou de organização: -* **Conta de usuário:** `https://github.com/settings/apps/new` -* **Conta de organização:** `https://github.com/organizations/:org/settings/apps/new` +You can add query parameters to these URLs to preselect the configuration of a {% data variables.product.prodname_github_app %} on a personal or organization account: +* **User account:** `https://github.com/settings/apps/new` +* **Organization account:** `https://github.com/organizations/:org/settings/apps/new` -A pessoa que está criando o aplicativo pode editar os valores pré-selecionados a partir da página de registro do {% data variables.product.prodname_github_app %}, antes de enviar o aplicativo. Se você não incluir os parâmetros necessários na string de consulta da URL, como, por exemplo, o `nome`, a pessoa que criar o aplicativo deverá inserir um valor antes de enviar o aplicativo. +The person creating the app can edit the preselected values from the {% data variables.product.prodname_github_app %} registration page, before submitting the app. If you do not include required parameters in the URL query string, like `name`, the person creating the app will need to input a value before submitting the app. -A URL a seguir cria um novo aplicativo pública denominado `octocat-github-app` com uma descrição pré-configurada e URL de chamada de retorno. Esta URL também seleciona permissões de leitura e gravação para `verificações`, inscreve-se nos eventos webhook de     check_run` e check_suite` e seleciona a opção de solicitar autorização do usuário (OAuth) durante a instalação: +The following URL creates a new public app called `octocat-github-app` with a preconfigured description and callback URL. This URL also selects read and write permissions for `checks`, subscribes to the `check_run` and `check_suite` webhook events, and selects the option to request user authorization (OAuth) during installation: ``` https://github.com/settings/apps/new?name=octocat-github-app&description=An%20Octocat%20App&callback_url=https://example.com&request_oauth_on_install=true&public=true&checks=write&events[]=check_run&events[]=check_suite ``` -Lista completa de parâmetros de consulta, permissões e eventos disponíveis encontra-se nas seções abaixo. +The complete list of available query parameters, permissions, and events is listed in the sections below. -### Parâmetros de configuração do {% data variables.product.prodname_github_app %} +### {% data variables.product.prodname_github_app %} configuration parameters - | Nome | Tipo | Descrição | - | -------------------------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - | `name` | `string` | O nome do {% data variables.product.prodname_github_app %}. Dê um nome claro e sucinto ao seu aplicativo. Seu aplicativo não pode ter o mesmo nome de um usuário existente no GitHub, a menos que seja o seu próprio nome de usuário ou da sua organização. Uma versão movida do nome do seu aplicativo será exibida na interface do usuário quando sua integração realizar uma ação. | - | `descrição` | `string` | Uma descrição do {% data variables.product.prodname_github_app %}. | - | `url` | `string` | A URL completa da página inicial do site do seu {% data variables.product.prodname_github_app %}. | - | `callback_url` | `string` | A URL completa para onde redirecionar após alguém autorizar uma instalação. Esta URL é usada se o aplicativo precisar identificar e autorizar solicitações de usuário para servidor. | - | `request_oauth_on_install` | `boolean` | Se seu aplicativo autoriza usuários a usar o fluxo OAuth, você poderá definir essa opção como `verdadeiro` para permitir que pessoas autorizem o aplicativo ao instalá-lo, economizando um passo. Se você selecionar esta opção, `setup_url` irá tornar-se indisponível e os usuários serão redirecionados para sua `callback_url` após instalar o aplicativo. | - | `setup_url` | `string` | A URL completa para redirecionamento após alguém instalar o {% data variables.product.prodname_github_app %}, se o aplicativo precisar de configuração adicional após a instalação. | - | `setup_on_update` | `boolean` | Defina como `verdadeiro` para redirecionar as pessoas para a URL de configuração quando as instalações forem atualizadas, por exemplo, após os repositórios serem adicionados ou removidos. | - | `público` | `boolean` | Defina `verdadeiro` quando seu {% data variables.product.prodname_github_app %} estiver disponível para o público ou como `falso` quando só for acessível pelo proprietário do aplicativo. | - | `webhook_url` | `string` | A URL completa para a qual você deseja enviar as cargas do evento de webhook. | - | `webhook_secret` | `string` | Você pode especificar um segredo para proteger seus webhooks. Consulte "[Protegendo seus webhooks](/webhooks/securing/)" para obter mais detalhes. | - | `eventos` | `array de strigns` | Eventos webhook. Alguns eventos de webhook exigem permissões de `leitura` ou `gravação` para um recurso antes de poder selecionar o evento ao registrar um novo {% data variables.product.prodname_github_app %}, . Consulte a seção "[{% data variables.product.prodname_github_app %} eventos de webhook](#github-app-webhook-events)" para eventos disponíveis e suas permissões necessárias. Você pode selecionar vários eventos em uma string de consulta. Por exemplo, `eventos[]=public&eventos[]=label`. | - | `domínio` | `string` | A URL de uma referência de conteúdo. | - | `single_file_name` | `string` | Ao conceder acesso de `leitura` ou `gravação` à permissão `single_file`, este campo fornecerá o caminho o para o único arquivo que seu {% data variables.product.prodname_github_app %} irá gerenciar. | + Name | Type | Description +-----|------|------------- +`name` | `string` | The name of the {% data variables.product.prodname_github_app %}. Give your app a clear and succinct name. Your app cannot have the same name as an existing GitHub user, unless it is your own user or organization name. A slugged version of your app's name will be shown in the user interface when your integration takes an action. +`description` | `string` | A description of the {% data variables.product.prodname_github_app %}. +`url` | `string` | The full URL of your {% data variables.product.prodname_github_app %}'s website homepage. +`callback_url` | `string` | The full URL to redirect to after someone authorizes an installation. This URL is used if your app needs to identify and authorize user-to-server requests. +`request_oauth_on_install` | `boolean` | If your app authorizes users using the OAuth flow, you can set this option to `true` to allow people to authorize the app when they install it, saving a step. If you select this option, the `setup_url` becomes unavailable and users will be redirected to your `callback_url` after installing the app. +`setup_url` | `string` | The full URL to redirect to after someone installs the {% data variables.product.prodname_github_app %} if the app requires additional setup after installation. +`setup_on_update` | `boolean` | Set to `true` to redirect people to the setup URL when installations have been updated, for example, after repositories are added or removed. +`public` | `boolean` | Set to `true` when your {% data variables.product.prodname_github_app %} is available to the public or `false` when it is only accessible to the owner of the app. +`webhook_url` | `string` | The full URL that you would like to send webhook event payloads to. +`webhook_secret` | `string` | You can specify a secret to secure your webhooks. See "[Securing your webhooks](/webhooks/securing/)" for more details. +`events` | `array of strings` | Webhook events. Some webhook events require `read` or `write` permissions for a resource before you can select the event when registering a new {% data variables.product.prodname_github_app %}. See the "[{% data variables.product.prodname_github_app %} webhook events](#github-app-webhook-events)" section for available events and their required permissions. You can select multiple events in a query string. For example, `events[]=public&events[]=label`. +`domain` | `string` | The URL of a content reference. +`single_file_name` | `string` | When you grant `read` or `write` access to the `single_file` permission, this field provides the path to the single file your {% data variables.product.prodname_github_app %} will manage. -### Permissões do {% data variables.product.prodname_github_app %} +### {% data variables.product.prodname_github_app %} permissions -Você pode selecionar permissões em uma string de consultas usando o nome da permissão na tabela a seguir como o nome do parâmetro de consulta e o tipo de permissão como valor da consulta. Por exemplo, para selecionar permissões de `Leitura & gravação` na interface de usuário para `conteúdo`, sua string de consulta incluiria `&contents=write`. Para selecionar as permissões `Somente leitura` na interface de usuário para `bloquear`, sua string de consulta incluiria `&blocking=read`. Para selecionar `sem acesso` na interface do usuário para `verificações`, sua string de consulta não incluiria a permissão `verificações`. +You can select permissions in a query string using the permission name in the following table as the query parameter name and the permission type as the query value. For example, to select `Read & write` permissions in the user interface for `contents`, your query string would include `&contents=write`. To select `Read-only` permissions in the user interface for `blocking`, your query string would include `&blocking=read`. To select `no-access` in the user interface for `checks`, your query string would not include the `checks` permission. -| Permissão | Descrição | -| -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`administração`](/rest/reference/permissions-required-for-github-apps/#permission-on-administration) | Concede acesso a vários pontos finais para administração de organização e repositório. Pode ser: `nenhum`, `leitura` ou `gravação`.{% if currentVersion == "free-pro-team@latest" %} -| [`bloqueio`](/rest/reference/permissions-required-for-github-apps/#permission-on-blocking) | Concede acesso à [API de usuários de bloqueio](/v3/users/blocking/). Pode ser: `nenhum`, `leitura` ou `gravação`.{% endif %} -| [`Verificações`](/rest/reference/permissions-required-for-github-apps/#permission-on-checks) | Concede acesso à [API de verificação](/v3/checks/). Pode ser: `nenhum`, `leitura` ou `gravação`. | -| `content_references` | Concede acesso ao ponto final "[Criar um anexo de conteúdo](/v3/apps/installations/#create-a-content-attachment). Pode ser: `nenhum`, `leitura` ou `gravação`. | -| [`Conteúdo`](/rest/reference/permissions-required-for-github-apps/#permission-on-contents) | Concede acesso a vários pontos finais que permitem modificar o conteúdo do repositório. Pode ser: `nenhum`, `leitura` ou `gravação`. | -| [`Implantações`](/rest/reference/permissions-required-for-github-apps/#permission-on-deployments) | Concede acesso à [API de implementação](/v3/repos/deployments/). Pode ser: `nenhum`, `leitura` ou `gravação`. | -| [`emails`](/rest/reference/permissions-required-for-github-apps/#permission-on-emails) | Concede acesso à [API de e-mails](/v3/users/emails/). Pode ser: `nenhum`, `leitura` ou `gravação`. | -| [`seguidores`](/rest/reference/permissions-required-for-github-apps/#permission-on-followers) | Concede acesso à [API de seguidores](/v3/users/followers/). Pode ser: `nenhum`, `leitura` ou `gravação`. | -| [`gpg_keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-gpg-keys) | Concede acesso à [API de chaves de GPG](/v3/users/gpg_keys/). Pode ser: `nenhum`, `leitura` ou `gravação`. | -| [`Problemas`](/rest/reference/permissions-required-for-github-apps/#permission-on-issues) | Concede acesso à [API de problemas](/v3/issues/). Pode ser: `nenhum`, `leitura` ou `gravação`. | -| [`chaves`](/rest/reference/permissions-required-for-github-apps/#permission-on-keys) | Concede acesso à [API de chaves públicas](/v3/users/keys/). Pode ser: `nenhum`, `leitura` ou `gravação`. | -| [`members`](/rest/reference/permissions-required-for-github-apps/#permission-on-members) | Concede acesso para gerenciar os membros de uma organização. Pode ser: `nenhum`, `leitura` ou `gravação`.{% if currentVersion == "free-pro-team@latest" %} -| [`metadados`](/rest/reference/permissions-required-for-github-apps/#metadata-permissions) | Concede acesso a pontos finais somente leitura que não vazam dados confidenciais. Pode ser `leitura ` ou `nenhum`. O padrão é `leitura`, ao definir qualquer permissão, ou `nenhum` quando você não especificar nenhuma permissão para o {% data variables.product.prodname_github_app %}. | -| [`organization_administration`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-administration) | Concede acesso ao ponto final "[Atualizar uma organização](/v3/orgs/#update-an-organization)" ponto final e Pa [API de restrições de interação da organização](/v3/interactions/orgs/#set-interaction-restrictions-for-an-organization). Pode ser: `nenhum`, `leitura` ou `gravação`.{% endif %} -| [`organization_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-hooks) | Concede acesso à [API de webhooks da organização](/v3/orgs/hooks/). Pode ser: `nenhum`, `leitura` ou `gravação`. | -| `organization_plan` | Concede acesso para obter informações sobre o plano de uma organização usando o ponto final "[Obter uma organização](/v3/orgs/#get-an-organization)". Pode ser: `nenhum` ou `leitura`. | -| [`organization_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects) | Concede acesso à [API de Projetos](/v3/projects/). Pode ser: `nenhum`, `leitura`, `gravação` ou `administrador`.{% if currentVersion == "free-pro-team@latest" %} -| [`organization_user_blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects) | Concede acesso à [API de usuários de bloqueio da organização](/v3/orgs/blocking/). Pode ser: `nenhum`, `leitura` ou `gravação`.{% endif %} -| [`Páginas`](/rest/reference/permissions-required-for-github-apps/#permission-on-pages) | Concede acesso à [API de páginas](/v3/repos/pages/). Pode ser: `nenhum`, `leitura` ou `gravação`. | -| `plano` | Concede acesso para obter informações sobre o plano de um usuário do GitHub que usa o ponto final "[Obter um usuário](/v3/users/#get-a-user)". Pode ser: `nenhum` ou `leitura`. | -| [`pull_requests`](/rest/reference/permissions-required-for-github-apps/#permission-on-pull-requests) | Concede acesso a vários pontos finais do pull request. Pode ser: `nenhum`, `leitura` ou `gravação`. | -| [`repository_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-hooks) | Concede acesso à [API de webhooks do repositório](/v3/repos/hooks/). Pode ser: `nenhum`, `leitura` ou `gravação`. | -| [`repository_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-projects) | Concede acesso à [API de Projetos](/v3/projects/). Pode ser: `nenhum`, `leutra`, `gravação` ou `administrador`. | -| [`single_file`](/rest/reference/permissions-required-for-github-apps/#permission-on-single-file) | Concede acesso à [API de conteúdo](/v3/repos/contents/). Pode ser: `nenhum`, `leitura` ou `gravação`. | -| [`estrela`](/rest/reference/permissions-required-for-github-apps/#permission-on-starring) | Concede acesso à [API estrelada](/v3/activity/starring/). Pode ser: `nenhum`, `leitura` ou `gravação`. | -| [`Status`](/rest/reference/permissions-required-for-github-apps/#permission-on-statuses) | Concede acesso à [API de status](/v3/repos/statuses/). Pode ser: `nenhum`, `leitura` ou `gravação`. | -| [`team_discussions`](/rest/reference/permissions-required-for-github-apps/#permission-on-team-discussions) | Concede acesso à [API de discussões de equipe](/v3/teams/discussions/) e à [API de comentários de discussão de equipe](/v3/teams/discussion_comments/). Pode ser: `nenhum`, `leitura` ou `gravação`. | -| `vulnerability_alerts` | Concede acesso a alertas de segurança para dependências vulneráveis em um repositório. Consulte "[Sobre alertas de segurança para dependências vulneráveis](/articles/about-security-alerts-for-vulnerable-dependencies)" para saber mais. Pode ser: `nenhum` ou `leitura`. | -| `inspecionando` | Concede acesso à lista e alterações de repositórios que um usuário assinou. Pode ser: `nenhum`, `leitura` ou `gravação`. | +Permission | Description +---------- | ----------- +[`administration`](/rest/reference/permissions-required-for-github-apps/#permission-on-administration) | Grants access to various endpoints for organization and repository administration. Can be one of: `none`, `read`, or `write`.{% if currentVersion == "free-pro-team@latest" %} +[`blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-blocking) | Grants access to the [Blocking Users API](/v3/users/blocking/). Can be one of: `none`, `read`, or `write`.{% endif %} +[`checks`](/rest/reference/permissions-required-for-github-apps/#permission-on-checks) | Grants access to the [Checks API](/v3/checks/). Can be one of: `none`, `read`, or `write`. +`content_references` | Grants access to the "[Create a content attachment](/v3/apps/installations/#create-a-content-attachment)" endpoint. Can be one of: `none`, `read`, or `write`. +[`contents`](/rest/reference/permissions-required-for-github-apps/#permission-on-contents) | Grants access to various endpoints that allow you to modify repository contents. Can be one of: `none`, `read`, or `write`. +[`deployments`](/rest/reference/permissions-required-for-github-apps/#permission-on-deployments) | Grants access to the [Deployments API](/rest/reference/repos#deployments). Can be one of: `none`, `read`, or `write`. +[`emails`](/rest/reference/permissions-required-for-github-apps/#permission-on-emails) | Grants access to the [Emails API](/v3/users/emails/). Can be one of: `none`, `read`, or `write`. +[`followers`](/rest/reference/permissions-required-for-github-apps/#permission-on-followers) | Grants access to the [Followers API](/v3/users/followers/). Can be one of: `none`, `read`, or `write`. +[`gpg_keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-gpg-keys) | Grants access to the [GPG Keys API](/v3/users/gpg_keys/). Can be one of: `none`, `read`, or `write`. +[`issues`](/rest/reference/permissions-required-for-github-apps/#permission-on-issues) | Grants access to the [Issues API](/v3/issues/). Can be one of: `none`, `read`, or `write`. +[`keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-keys) | Grants access to the [Public Keys API](/v3/users/keys/). Can be one of: `none`, `read`, or `write`. +[`members`](/rest/reference/permissions-required-for-github-apps/#permission-on-members) | Grants access to manage an organization's members. Can be one of: `none`, `read`, or `write`.{% if currentVersion == "free-pro-team@latest" %} +[`metadata`](/rest/reference/permissions-required-for-github-apps/#metadata-permissions) | Grants access to read-only endpoints that do not leak sensitive data. Can be `read` or `none`. Defaults to `read` when you set any permission, or defaults to `none` when you don't specify any permissions for the {% data variables.product.prodname_github_app %}. +[`organization_administration`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-administration) | Grants access to "[Update an organization](/v3/orgs/#update-an-organization)" endpoint and the [Organization Interaction Restrictions API](/v3/interactions/orgs/#set-interaction-restrictions-for-an-organization). Can be one of: `none`, `read`, or `write`.{% endif %} +[`organization_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-hooks) | Grants access to the [Organization Webhooks API](/rest/reference/orgs#webhooks/). Can be one of: `none`, `read`, or `write`. +`organization_plan` | Grants access to get information about an organization's plan using the "[Get an organization](/v3/orgs/#get-an-organization)" endpoint. Can be one of: `none` or `read`. +[`organization_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects) | Grants access to the [Projects API](/v3/projects/). Can be one of: `none`, `read`, `write`, or `admin`.{% if currentVersion == "free-pro-team@latest" %} +[`organization_user_blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects) | Grants access to the [Blocking Organization Users API](/v3/orgs/blocking/). Can be one of: `none`, `read`, or `write`.{% endif %} +[`pages`](/rest/reference/permissions-required-for-github-apps/#permission-on-pages) | Grants access to the [Pages API](/rest/reference/repos#pages). Can be one of: `none`, `read`, or `write`. +`plan` | Grants access to get information about a user's GitHub plan using the "[Get a user](/v3/users/#get-a-user)" endpoint. Can be one of: `none` or `read`. +[`pull_requests`](/rest/reference/permissions-required-for-github-apps/#permission-on-pull-requests) | Grants access to various pull request endpoints. Can be one of: `none`, `read`, or `write`. +[`repository_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-hooks) | Grants access to the [Repository Webhooks API](/v3/repos/hooks/). Can be one of: `none`, `read`, or `write`. +[`repository_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-projects) | Grants access to the [Projects API](/v3/projects/). Can be one of: `none`, `read`, `write`, or `admin`. +[`single_file`](/rest/reference/permissions-required-for-github-apps/#permission-on-single-file) | Grants access to the [Contents API](/v3/repos/contents/). Can be one of: `none`, `read`, or `write`. +[`starring`](/rest/reference/permissions-required-for-github-apps/#permission-on-starring) | Grants access to the [Starring API](/v3/activity/starring/). Can be one of: `none`, `read`, or `write`. +[`statuses`](/rest/reference/permissions-required-for-github-apps/#permission-on-statuses) | Grants access to the [Statuses API](/v3/repos/statuses/). Can be one of: `none`, `read`, or `write`. +[`team_discussions`](/rest/reference/permissions-required-for-github-apps/#permission-on-team-discussions) | Grants access to the [Team Discussions API](/v3/teams/discussions/) and the [Team Discussion Comments API](/v3/teams/discussion_comments/). Can be one of: `none`, `read`, or `write`. +`vulnerability_alerts`| Grants access to receive security alerts for vulnerable dependencies in a repository. See "[About security alerts for vulnerable dependencies](/articles/about-security-alerts-for-vulnerable-dependencies)" to learn more. Can be one of: `none` or `read`. +`watching` | Grants access to list and change repositories a user is subscribed to. Can be one of: `none`, `read`, or `write`. -### Eventos webhook do {% data variables.product.prodname_github_app %} +### {% data variables.product.prodname_github_app %} webhook events -| Nome do evento webhook | Permissão necessária | Descrição | -| -------------------------------------------------------------------------------------- | ------------------------------------------------ | --------------------------------------------------------------------------------------------- | -| [`check_run`](/webhooks/event-payloads/#check_run) | `Verificações` | {% data reusables.webhooks.check_run_short_desc %} | -| [`check_suite`](/webhooks/event-payloads/#check_suite) | `Verificações` | {% data reusables.webhooks.check_suite_short_desc %} | -| [`commit_comment`](/webhooks/event-payloads/#commit_comment) | `Conteúdo` | {% data reusables.webhooks.commit_comment_short_desc %} | -| [`content_reference`](/webhooks/event-payloads/#content_reference) | `content_references` | {% data reusables.webhooks.content_reference_short_desc %} | -| [`create`](/webhooks/event-payloads/#create) | `Conteúdo` | {% data reusables.webhooks.create_short_desc %} | -| [`delete`](/webhooks/event-payloads/#delete) | `Conteúdo` | {% data reusables.webhooks.delete_short_desc %} | -| [`implantação`](/webhooks/event-payloads/#deployment) | `Implantações` | {% data reusables.webhooks.deployment_short_desc %} | -| [`implantação_status`](/webhooks/event-payloads/#deployment_status) | `Implantações` | {% data reusables.webhooks.deployment_status_short_desc %} | -| [`bifurcação`](/webhooks/event-payloads/#fork) | `Conteúdo` | {% data reusables.webhooks.fork_short_desc %} | -| [`gollum`](/webhooks/event-payloads/#gollum) | `Conteúdo` | {% data reusables.webhooks.gollum_short_desc %} | -| [`Problemas`](/webhooks/event-payloads/#issues) | `Problemas` | {% data reusables.webhooks.issues_short_desc %} | -| [`issue_comment`](/webhooks/event-payloads/#issue_comment) | `Problemas` | {% data reusables.webhooks.issue_comment_short_desc %} | -| [`etiqueta`](/webhooks/event-payloads/#label) | `metadados` | {% data reusables.webhooks.label_short_desc %} | -| [`integrante`](/webhooks/event-payloads/#member) | `members` | {% data reusables.webhooks.member_short_desc %} | -| [`filiação`](/webhooks/event-payloads/#membership) | `members` | {% data reusables.webhooks.membership_short_desc %} | -| [`marco`](/webhooks/event-payloads/#milestone) | `pull_request` | {% data reusables.webhooks.milestone_short_desc %}{% if currentVersion == "free-pro-team@latest" %} -| [`org_block`](/webhooks/event-payloads/#org_block) | `organization_administration` | {% data reusables.webhooks.org_block_short_desc %}{% endif %} -| [`organização`](/webhooks/event-payloads/#organization) | `members` | {% data reusables.webhooks.organization_short_desc %} | -| [`page_build`](/webhooks/event-payloads/#page_build) | `Páginas` | {% data reusables.webhooks.page_build_short_desc %} | -| [`project`](/webhooks/event-payloads/#project) | `repository_projects` ou `organization_projects` | {% data reusables.webhooks.project_short_desc %} | -| [`project_card`](/webhooks/event-payloads/#project_card) | `repository_projects` ou `organization_projects` | {% data reusables.webhooks.project_card_short_desc %} | -| [`project_column`](/webhooks/event-payloads/#project_column) | `repository_projects` ou `organization_projects` | {% data reusables.webhooks.project_column_short_desc %} | -| [`público`](/webhooks/event-payloads/#public) | `metadados` | {% data reusables.webhooks.public_short_desc %} | -| [`pull_request`](/webhooks/event-payloads/#pull_request) | `pull_requests` | {% data reusables.webhooks.pull_request_short_desc %} | -| [`pull_request_review`](/webhooks/event-payloads/#pull_request_review) | `pull_request` | {% data reusables.webhooks.pull_request_review_short_desc %} | -| [`pull_request_review_comment`](/webhooks/event-payloads/#pull_request_review_comment) | `pull_request` | {% data reusables.webhooks.pull_request_review_comment_short_desc %} | -| [`push`](/webhooks/event-payloads/#push) | `Conteúdo` | {% data reusables.webhooks.push_short_desc %} | -| [`versão`](/webhooks/event-payloads/#release) | `Conteúdo` | {% data reusables.webhooks.release_short_desc %} | -| [`repositório`](/webhooks/event-payloads/#repository) | `metadados` | {% data reusables.webhooks.repository_short_desc %}{% if currentVersion == "free-pro-team@latest"%} -| [`repository_dispatch`](/webhooks/event-payloads/#repository_dispatch) | `Conteúdo` | Permite aos integradores que usam o GitHub Actions acionar eventos personalizados.{% endif %} -| [`status`](/webhooks/event-payloads/#status) | `Status` | {% data reusables.webhooks.status_short_desc %} | -| [`equipe`](/webhooks/event-payloads/#team) | `members` | {% data reusables.webhooks.team_short_desc %} | -| [`team_add`](/webhooks/event-payloads/#team_add) | `members` | {% data reusables.webhooks.team_add_short_desc %} | -| [`inspecionar`](/webhooks/event-payloads/#watch) | `metadados` | {% data reusables.webhooks.watch_short_desc %} | +Webhook event name | Required permission | Description +------------------ | ------------------- | ----------- +[`check_run`](/webhooks/event-payloads/#check_run) |`checks` | {% data reusables.webhooks.check_run_short_desc %} +[`check_suite`](/webhooks/event-payloads/#check_suite) |`checks` | {% data reusables.webhooks.check_suite_short_desc %} +[`commit_comment`](/webhooks/event-payloads/#commit_comment) | `contents` | {% data reusables.webhooks.commit_comment_short_desc %} +[`content_reference`](/webhooks/event-payloads/#content_reference) |`content_references` | {% data reusables.webhooks.content_reference_short_desc %} +[`create`](/webhooks/event-payloads/#create) | `contents` | {% data reusables.webhooks.create_short_desc %} +[`delete`](/webhooks/event-payloads/#delete) | `contents` | {% data reusables.webhooks.delete_short_desc %} +[`deployment`](/webhooks/event-payloads/#deployment) | `deployments` | {% data reusables.webhooks.deployment_short_desc %} +[`deployment_status`](/webhooks/event-payloads/#deployment_status) | `deployments` | {% data reusables.webhooks.deployment_status_short_desc %} +[`fork`](/webhooks/event-payloads/#fork) | `contents` | {% data reusables.webhooks.fork_short_desc %} +[`gollum`](/webhooks/event-payloads/#gollum) | `contents` | {% data reusables.webhooks.gollum_short_desc %} +[`issues`](/webhooks/event-payloads/#issues) | `issues` | {% data reusables.webhooks.issues_short_desc %} +[`issue_comment`](/webhooks/event-payloads/#issue_comment) | `issues` | {% data reusables.webhooks.issue_comment_short_desc %} +[`label`](/webhooks/event-payloads/#label) | `metadata` | {% data reusables.webhooks.label_short_desc %} +[`member`](/webhooks/event-payloads/#member) | `members` | {% data reusables.webhooks.member_short_desc %} +[`membership`](/webhooks/event-payloads/#membership) | `members` | {% data reusables.webhooks.membership_short_desc %} +[`milestone`](/webhooks/event-payloads/#milestone) | `pull_request` | {% data reusables.webhooks.milestone_short_desc %}{% if currentVersion == "free-pro-team@latest" %} +[`org_block`](/webhooks/event-payloads/#org_block) | `organization_administration` | {% data reusables.webhooks.org_block_short_desc %}{% endif %} +[`organization`](/webhooks/event-payloads/#organization) | `members` | {% data reusables.webhooks.organization_short_desc %} +[`page_build`](/webhooks/event-payloads/#page_build) | `pages` | {% data reusables.webhooks.page_build_short_desc %} +[`project`](/webhooks/event-payloads/#project) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_short_desc %} +[`project_card`](/webhooks/event-payloads/#project_card) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_card_short_desc %} +[`project_column`](/webhooks/event-payloads/#project_column) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_column_short_desc %} +[`public`](/webhooks/event-payloads/#public) | `metadata` | {% data reusables.webhooks.public_short_desc %} +[`pull_request`](/webhooks/event-payloads/#pull_request) | `pull_requests` | {% data reusables.webhooks.pull_request_short_desc %} +[`pull_request_review`](/webhooks/event-payloads/#pull_request_review) | `pull_request` | {% data reusables.webhooks.pull_request_review_short_desc %} +[`pull_request_review_comment`](/webhooks/event-payloads/#pull_request_review_comment) | `pull_request` | {% data reusables.webhooks.pull_request_review_comment_short_desc %} +[`push`](/webhooks/event-payloads/#push) | `contents` | {% data reusables.webhooks.push_short_desc %} +[`release`](/webhooks/event-payloads/#release) | `contents` | {% data reusables.webhooks.release_short_desc %} +[`repository`](/webhooks/event-payloads/#repository) |`metadata` | {% data reusables.webhooks.repository_short_desc %}{% if currentVersion == "free-pro-team@latest"%} +[`repository_dispatch`](/webhooks/event-payloads/#repository_dispatch) | `contents` | Allows integrators using GitHub Actions to trigger custom events.{% endif %} +[`status`](/webhooks/event-payloads/#status) | `statuses` | {% data reusables.webhooks.status_short_desc %} +[`team`](/webhooks/event-payloads/#team) | `members` | {% data reusables.webhooks.team_short_desc %} +[`team_add`](/webhooks/event-payloads/#team_add) | `members` | {% data reusables.webhooks.team_add_short_desc %} +[`watch`](/webhooks/event-payloads/#watch) | `metadata` | {% data reusables.webhooks.watch_short_desc %} diff --git a/translations/pt-BR/content/developers/apps/creating-a-github-app.md b/translations/pt-BR/content/developers/apps/creating-a-github-app.md index 463f745c41db..0e07875b2376 100644 --- a/translations/pt-BR/content/developers/apps/creating-a-github-app.md +++ b/translations/pt-BR/content/developers/apps/creating-a-github-app.md @@ -10,7 +10,7 @@ versions: enterprise-server: '*' --- -{% if currentVersion == "free-pro-team@latest" %}Para aprender como usar manifestos do aplicativo GitHub que permitem que pessoas criem aplicativos GitHub pré-configurados, consulte "[Criando aplicativos GitHub a partir de um manifesto](/apps/building-github-apps/creating-github-apps-from-a-manifest/).{% endif %} +{% if currentVersion == "free-pro-team@latest" %}Para aprender como usar Manifestos do aplicativo GitHub, que permite às pessoas criar aplicativos GitHub pré-configurados, consulte "[Criar aplicativos GitHub a partir de um manifesto](/apps/building-github-apps/creating-github-apps-from-a-manifest/).{% endif %} {% if currentVersion == "free-pro-team@latest" %} {% note %} diff --git a/translations/pt-BR/content/developers/apps/creating-ci-tests-with-the-checks-api.md b/translations/pt-BR/content/developers/apps/creating-ci-tests-with-the-checks-api.md index 0a602c3c5ba0..96346b1dfa7f 100644 --- a/translations/pt-BR/content/developers/apps/creating-ci-tests-with-the-checks-api.md +++ b/translations/pt-BR/content/developers/apps/creating-ci-tests-with-the-checks-api.md @@ -9,7 +9,6 @@ versions: --- - ### Introdução Este guia irá apresentá-lo aos [aplicativos Github](/apps/) e à [API de verificação](/v3/checks/), que você usará para criar um servidor de integração contínua (CI) que executa testes. @@ -134,6 +133,26 @@ A ação `solicitada` solicita uma execução de verificação cada vez que o c Você irá adicionar este novo método como um [Auxiliar do Sinatra](https://github.com/sinatra/sinatra#helpers), caso deseje que outros encaminhamentos o usem também. Em `auxiliares do`, adicione este método `create_check_run`: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +``` ruby +# Create a new check run with the status queued +def create_check_run + # # At the time of writing, Octokit does not support the Checks API yet, but + # it does provide generic HTTP methods you can use: + # /v3/checks/runs/#create-a-check-run + check_run = @installation_client.post( + "repos/#{@payload['repository']['full_name']}/check-runs", + { + accept: 'application/vnd.github.v3+json', + # The name of your check run. + nome: 'Octo RuboCop', + # A estrutura da carga difere dependendo da ocorrência de um evento de execução de verificação ou de conjunto de verificações. + head_sha: @payload['check_run'].nil? ? @payload['check_suite']['head_sha'] : @payload['check_run']['head_sha'] + } + ) +end +``` +{% else %} ``` ruby # Criar uma nova execução de verificação com o status em fila def create_check_run @@ -153,6 +172,7 @@ def create_check_run ) end ``` +{% endif %} Este código chama o ponto final "[Criar uma execução de verificação](/v3/checks/runs/#create-a-check-run)" que usa o método genérico [HTTP `POST`](http://octokit.github.io/octokit.rb/Octokit/Connection.html#post-instance_method). Este método tem dois parâmetros: a URL do ponto final e os parâmetros de entrada do método. @@ -209,6 +229,43 @@ Nesta seção, você não vai iniciar o teste de CI ainda, mas você verá como Vamos criar o método `initiate_check_run` e atualizar o status da execução de verificação. Adicione o seguinte código à seção auxiliar: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +``` ruby +# Iniciar o processo de CI +def initiate_check_run + # Uma vez criada a execução de verificação, você irá atualizar o status da verificação de execução + # para 'in_progress' e executar o processo de CI. Após a conclusão da CI, você + # irá atualizar o status da execução de verificação para "concluído" e irá adicionar os resultados de CI. + + # Octokit doesn't yet support the Checks API, but it does provide generic + # HTTP methods you can use: + # /v3/checks/runs/#update-a-check-run + updated_check_run = @installation_client.patch( + "repos/#{@payload['repository']['full_name']}/check-runs/#{@payload['check_run']['id']}", + { + accept: 'application/vnd.github.v3+json', + name: 'Octo RuboCop', + status: 'in_progress', + started_at: Time.now.utc.iso8601 + } + ) + + # ***** RUN A CI TEST ***** + + # Mark the check run as complete! + updated_check_run = @installation_client.patch( + "repos/#{@payload['repository']['full_name']}/check-runs/#{@payload['check_run']['id']}", + { + accept: 'application/vnd.github.v3+json', + name: 'Octo RuboCop', + status: 'completed', + conclusion: 'success', + completed_at: Time.now.utc.iso8601 + } + ) +end +``` +{% else %} ``` ruby # Iniciar o processo de CI def initiate_check_run @@ -245,6 +302,7 @@ def initiate_check_run ) end ``` +{% endif %} O código acima chama o ponto final da API "[Atualizar uma execução de verificação](/v3/checks/runs/#update-a-check-run)" usando o método genérico [`patch` HTTP](http://octokit.github.io/octokit.rb/Octokit/Connection.html#patch-instance_method) para atualizar a verificação que você já criou. @@ -549,6 +607,21 @@ text = "Octo RuboCop version: #{@output['metadata']['rubocop_version']}" Agora você tem todas as informações de que precisa para atualizar sua execução de verificação. Na [primeira metade deste início rápido](#step-14-updating-a-check-run), você adicionou este código para definir o status da execução de verificação de `sucesso`: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +``` ruby +# Marque a verificação como concluída! +updated_check_run = @installation_client.patch( + "repos/#{@payload['repository']['full_name']}/check-runs/#{@payload['check_run']['id']}", + { + accept: 'application/vnd.github.v3+json', + name: 'Octo RuboCop', + status: 'completed', + conclusion: 'success', + completed_at: Time.now.utc.iso8601 + } +) +``` +{% else %} ``` ruby # Marque a verificação como concluída! updated_check_run = @installation_client.patch( @@ -562,9 +635,36 @@ updated_check_run = @installation_client.patch( } ) ``` +{% endif %} Você deverá atualizar esse código para usar a variável de `Conclusão` definida com base nos resultados do RuboCop (para `sucesso` Ou `neutro`). Você pode atualizar o código com o seguinte: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +``` ruby +# Marque a verificação como concluída! E, se houver avisos, compartilhe-os. +updated_check_run = @installation_client.patch( + "repos/#{@payload['repository']['full_name']}/check-runs/#{@payload['check_run']['id']}", + { + accept: 'application/vnd.github.v3+json', + name: 'Octo RuboCop', + status: 'completed', + conclusion: conclusion, + completed_at: Time.now.utc.iso8601, + output: { + title: 'Octo RuboCop', + summary: summary, + text: text, + annotations: annotations + }, + actions: [{ + label: 'Fix this', + description: 'Automatically fix all linter notices.', + identifier: 'fix_rubocop_notices' + }] + } +) +``` +{% else %} ``` ruby # Marque a verificação como concluída! E, se houver avisos, compartilhe-os. updated_check_run = @installation_client.patch( @@ -589,10 +689,11 @@ updated_check_run = @installation_client.patch( } ) ``` +{% endif %} Agora que você está definindo uma conclusão com base no status do teste CI e que você adicionou a saída dos resultados do RuboCop, você criou um teste de CI! Parabéns. 🙌 -O código acima também adiciona um recurso ao seu servidor de CI denominado [ações solicitadas](https://developer.github.com/changes/2018-05-23-request-actions-on-checks/) por meio do objeto `ações`. {% if currentVersion == "free-pro-team@latest" %}(Observe que isto não está relacionado ao [GitHub Actions](/actions).) {% endif %}As ações solicitadas adicionam um botão à aba **Verificações** no GitHub que permite que alguém solicite execução de verificação para tomar medidas adicionais. A ação adicional é completamente configurável pelo seu aplicativo. Por exemplo, uma vez que o RuboCop tem um recurso para corrigir automaticamente os erros que encontra no código Ruby, seu servidor de CI pode usar um botão de ações solicitadas para permitir que as pessoas solicitem correções automáticas de erros. Quando alguém clica no botão, o aplicativo recebe o evento de `check_run` com uma ação `requested_action`. Cada ação solicitada tem um `identificador` que o aplicativo usa para determinar em qual botão foi clicado. +O código acima também adiciona um recurso ao seu servidor de CI denominado [ações solicitadas](https://developer.github.com/changes/2018-05-23-request-actions-on-checks/) por meio do objeto `ações`. {% if currentVersion == "free-pro-team@latest" %}(Observe que isso não se relaciona ao [GitHub Actions](/actions).) {% endif %}As ações solicitadas adicionam um botão à aba **Verificações** no GitHub que permite que alguém solicite execução de verificação para tomar medidas adicionais. A ação adicional é completamente configurável pelo seu aplicativo. Por exemplo, uma vez que o RuboCop tem um recurso para corrigir automaticamente os erros que encontra no código Ruby, seu servidor de CI pode usar um botão de ações solicitadas para permitir que as pessoas solicitem correções automáticas de erros. Quando alguém clica no botão, o aplicativo recebe o evento de `check_run` com uma ação `requested_action`. Cada ação solicitada tem um `identificador` que o aplicativo usa para determinar em qual botão foi clicado. O código acima ainda não exige que o RuboCop corrija erros automaticamente. Você irá adicionar isso na próxima seção. Mas, primeiro, dê uma olhada no teste de CI que você acabou de criar ao iniciar o servidor `template_server.rb` novamente e ao criar um novo pull request: diff --git a/translations/pt-BR/content/developers/apps/differences-between-github-apps-and-oauth-apps.md b/translations/pt-BR/content/developers/apps/differences-between-github-apps-and-oauth-apps.md index 613ddb892894..d73900f4a551 100644 --- a/translations/pt-BR/content/developers/apps/differences-between-github-apps-and-oauth-apps.md +++ b/translations/pt-BR/content/developers/apps/differences-between-github-apps-and-oauth-apps.md @@ -50,13 +50,13 @@ Um aplicativo OAuth _authorized_ tem acesso a todos os recursos acessíveis do u {% endnote %} -| Aplicativos do GitHub | Aplicativos OAuth | -| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Um aplicativo GitHub pode solicitar um token de acesso de instalação usando uma chave privada com um formato de token do JSON fora da banda. | Um aplicativo OAuth pode trocar um token de solicitação por um token de acesso após um redirecionamento por meio de uma solicitação da web. | -| Um token de instalação identifica o aplicativo como o bot do aplicativo GitHub, como, por exemplo, @jenkins-bot. | Um token de acesso identifica o aplicativo como o usuário que concedeu o token ao aplicativo, como, por exemplo, o @octocat. | -| Os tokens de instalação expiram após um tempo predefinido (atualmente, 1 hora). | Os tokens do OAuth permanecem ativos até que sejam cancelados pelo cliente. | -| {% data reusables.apps.api-rate-limits-non-ghec %}{% if currentVersion == "free-pro-team@latest" %} Aplicam-se limites de taxa mais altos para {% data variables.product.prodname_ghe_cloud %}. Para obter mais informações, consulte "[Limites de taxas para os aplicativos GitHub](/developers/apps/rate-limits-for-github-apps)."{% endif %} | Os tokens do OAuth usam o limite de taxa de usuário de 5.000 solicitações por hora. | -| Os aumentos no limite de taxa pode ser concedido tanto no nível do aplicativo GitHub (afetando todas as instalações) quanto no nível de instalação individual. | Os aumentos no limite de taxa são concedidos pelo aplicativo OAuth. Todo token concedido para que o aplicativo OAuth obtém um aumento do limite. |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} +| Aplicativos do GitHub | Aplicativos OAuth | +| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Um aplicativo GitHub pode solicitar um token de acesso de instalação usando uma chave privada com um formato de token do JSON fora da banda. | Um aplicativo OAuth pode trocar um token de solicitação por um token de acesso após um redirecionamento por meio de uma solicitação da web. | +| Um token de instalação identifica o aplicativo como o bot do aplicativo GitHub, como, por exemplo, @jenkins-bot. | Um token de acesso identifica o aplicativo como o usuário que concedeu o token ao aplicativo, como, por exemplo, o @octocat. | +| Os tokens de instalação expiram após um tempo predefinido (atualmente, 1 hora). | Os tokens do OAuth permanecem ativos até que sejam cancelados pelo cliente. | +| {% data reusables.apps.api-rate-limits-non-ghec %}{% if currentVersion == "free-pro-team@latest" %} Limites de taxa mais alto aplicam-se a {% data variables.product.prodname_ghe_cloud %}. Para obter mais informações, consulte "[Limites de taxas para os aplicativos GitHub](/developers/apps/rate-limits-for-github-apps)."{% endif %} | Os tokens do OAuth usam o limite de taxa de usuário de 5.000 solicitações por hora. | +| Os aumentos no limite de taxa pode ser concedido tanto no nível do aplicativo GitHub (afetando todas as instalações) quanto no nível de instalação individual. | Os aumentos no limite de taxa são concedidos pelo aplicativo OAuth. Todo token concedido para que o aplicativo OAuth obtém um aumento do limite. |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} | {% data variables.product.prodname_github_app %}s podem efetuar a autenticação em nome do usuário, o que é denominado solicitações de usuário para servidor. O fluxo para autorizar é o mesmo que o fluxo de autorização do aplicativo OAuth. Os tokens de usuário para servidor podem expirar e ser renovados com um token de atualização. Para obter mais informações, consulte "[Atualizando tokens de acesso do usuário para servidor](/apps/building-github-apps/refreshing-user-to-server-access-tokens/)" e "[identificando e autorizando os usuários para os aplicativos GitHub](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/)". | O fluxo do OAuth usado por {% data variables.product.prodname_oauth_app %}s autoriza um {% data variables.product.prodname_oauth_app %} em nome do usuário. Este é o mesmo fluxo de uso na autorização de usuário para servidor do {% data variables.product.prodname_github_app %}. |{% endif %} ### Solicitar níveis de permissão para os recursos @@ -100,7 +100,7 @@ Contas de usuário de máquina são contas de usuário baseadas no OAuth que sep As contas do bot são específicas para os aplicativos GitHub e são construídas em todos os aplicativos GitHub. -| Aplicativos do GitHub | Aplicativos OAuth | -| ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- | -| Os bots do aplicativo GitHub não consomem uma estação {% data variables.product.prodname_enterprise %}. | Uma conta de usuário de máquina consome uma estação {% data variables.product.prodname_enterprise %}. | -| Como um bot do aplicativo GitHub nunca recebe uma senha, um cliente não pode entrar diretamente nele. | Um nome de usuário e senha são concedidos a uma conta de usuário de máquina para ser gerenciada e protegida pelo cliente. | +| Aplicativos do GitHub | Aplicativos OAuth | +| ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | +| Os bots do aplicativo GitHub não consomem uma estação {% data variables.product.prodname_enterprise %}. | Uma conta de usuário de máquina consome uma estação {% data variables.product.prodname_enterprise %}. | +| Como um bot do aplicativo GitHub nunca recebe uma senha, um cliente não pode entrar diretamente nele. | Um nome de usuário e senha são concedidos a uma conta de usuário de máquina para ser gerenciada e protegida pelo cliente. | diff --git a/translations/pt-BR/content/developers/apps/editing-a-github-apps-permissions.md b/translations/pt-BR/content/developers/apps/editing-a-github-apps-permissions.md index 81fff7a88b35..04829311e513 100644 --- a/translations/pt-BR/content/developers/apps/editing-a-github-apps-permissions.md +++ b/translations/pt-BR/content/developers/apps/editing-a-github-apps-permissions.md @@ -1,5 +1,5 @@ --- -title: Editing a GitHub App's permissions +title: Editar permissões do aplicativo GitHub intro: '{% data reusables.shortdesc.editing_permissions_for_github_apps %}' redirect_from: - /apps/building-integrations/managing-github-apps/editing-a-github-app-s-permissions/ @@ -11,22 +11,16 @@ versions: {% note %} -**Note:** Updated permissions won't take effect on an installation until the owner of the account or organization approves the changes. You can use the [InstallationEvent webhook](/webhooks/event-payloads/#installation) to find out when people accept new permissions for your app. One exception is [user-level permissions](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/#user-level-permissions), which don't require the account owner to approve permission changes. +**Observação:** As permissões atualizadas não terão efeito sobre uma instalação até que o proprietário da conta ou organização aprove as alterações. Você pode usar o [webhook do InstallationEvent](/webhooks/event-payloads/#installation) para descobrir quando as pessoas aceitam novas permissões para seu aplicativo. Uma exceção são as [permissões de nível de usuário](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/#user-level-permissions), que não exigem que o proprietário da conta aprove as alterações de permissão. {% endnote %} {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.github_apps %} -4. Select the GitHub App whose permissions you want to change. -![App selection](/assets/images/github-apps/github_apps_select-app.png) -5. In the left sidebar, click **Permissions & webhooks**. -![Permissions and webhooks](/assets/images/github-apps/github_apps_permissions_and_webhooks.png) -6. Modify the permissions you'd like to change. For each type of permission, select either "Read-only", "Read & write", or "No access" from the dropdown. -![Permissions selections for your GitHub App](/assets/images/github-apps/github_apps_permissions_post2dot13.png) -7. In "Subscribe to events", select any events to which you'd like to subscribe your app. -![Permissions selections for subscribing your GitHub App to events](/assets/images/github-apps/github_apps_permissions_subscribe_to_events.png) -8. Optionally, in "Add a note to users", add a note telling your users why you are changing the permissions that your GitHub App requests. -![Input box to add a note to users explaining why your GitHub App permissions have changed](/assets/images/github-apps/github_apps_permissions_note_to_users.png) -9. Click **Save changes**. -![Button to save permissions changes](/assets/images/github-apps/github_apps_save_changes.png) +4. Selecione o aplicativo GitHub cujas permissões você deseja alterar. ![Seleção de aplicativo](/assets/images/github-apps/github_apps_select-app.png) +5. Na barra lateral esquerda, clique em **Permissions & webhooks** (Permissões e webhooks). ![Permissões e webhooks](/assets/images/github-apps/github_apps_permissions_and_webhooks.png) +6. Modifique as permissões que você deseja alterar. Para cada tipo de permissão, selecione "Somente leitura", "Ler & gravar" ou "Sem acesso" no menu suspenso. ![Seleção de permissões para o seu aplicativo GitHub](/assets/images/github-apps/github_apps_permissions_post2dot13.png) +7. Em "Assinar eventos", selecione quaisquer eventos que você deseja que seu aplicativo assine. ![Seleção de permissões para seu aplicativo GitHub assinar eventos](/assets/images/github-apps/github_apps_permissions_subscribe_to_events.png) +8. Opcionalmente, em "Adicionar uma observação para os usuários", adicione uma observação informando aos usuários o por que você esta mudando as permissões que o seu aplicativo GitHub solicita. ![Caixa de entrada para adicionar uma observação aos usuários explicando por que as permissões do seu aplicativo GitHub foram alteradas](/assets/images/github-apps/github_apps_permissions_note_to_users.png) +9. Clique em **Save changes** (Salvar alterações). ![Botão para salvar alterações de permissões](/assets/images/github-apps/github_apps_save_changes.png) diff --git a/translations/pt-BR/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md b/translations/pt-BR/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md index d9fde11dfbdd..95d7ec2ffca2 100644 --- a/translations/pt-BR/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md +++ b/translations/pt-BR/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md @@ -1,5 +1,5 @@ --- -title: Identificar e autorizar usuários para aplicativos GitHub +title: Identifying and authorizing users for GitHub Apps intro: '{% data reusables.shortdesc.identifying_and_authorizing_github_apps %}' redirect_from: - /early-access/integrations/user-identification-authorization/ @@ -13,80 +13,80 @@ versions: {% data reusables.pre-release-program.expiring-user-access-tokens-beta %} -Quando o seu aplicativo GitHub age em nome de um usuário, ele realiza solicitações de usuário para servidor. Essas solicitações devem ser autorizadas com o token de acesso de um usuário. As solicitações de usuário para servidor incluem a solicitação de dados para um usuário, como determinar quais repositórios devem ser exibidos para um determinado usuário. Essas solicitações também incluem ações acionadas por um usuário, como executar uma criação. +When your GitHub App acts on behalf of a user, it performs user-to-server requests. These requests must be authorized with a user's access token. User-to-server requests include requesting data for a user, like determining which repositories to display to a particular user. These requests also include actions triggered by a user, like running a build. {% data reusables.apps.expiring_user_authorization_tokens %} -### Identificando usuários no seu site +### Identifying users on your site -Para autorizar usuários para aplicativos-padrão executados no navegador, use o [fluxo de aplicativo web](#web-application-flow). +To authorize users for standard apps that run in the browser, use the [web application flow](#web-application-flow). {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -Para autorizar usuários para aplicativos sem acesso direto ao navegador, como ferramentas de CLI ou gerentes de credenciais do Git, use o [fluxo de dispositivos](#device-flow). O fluxo de dispositivo usa o OAuth 2.0 [Concessão de autorização do dispositivo](https://tools.ietf.org/html/rfc8628). +To authorize users for headless apps without direct access to the browser, such as CLI tools or Git credential managers, use the [device flow](#device-flow). The device flow uses the OAuth 2.0 [Device Authorization Grant](https://tools.ietf.org/html/rfc8628). {% endif %} -### Fluxo do aplicativo web +### Web application flow -Ao usar o fluxo de aplicativo web, o processo para identificar usuários no seu site é: +Using the web application flow, the process to identify users on your site is: -1. Os usuários são redirecionados para solicitar sua identidade do GitHub -2. Os usuários são redirecionados de volta para o seu site pelo GitHub -3. Seu aplicativo GitHub acessa a API com o token de acesso do usuário +1. Users are redirected to request their GitHub identity +2. Users are redirected back to your site by GitHub +3. Your GitHub App accesses the API with the user's access token -Se você selecionar **Solicitar autorização de usuário (OAuth) durante a instalação** ao criar ou modificar seu aplicativo, a etapa 1 será concluída durante a instalação do aplicativo. Para obter mais informações, consulte "[Autorizando usuários durante a instalação](/apps/installing-github-apps/#authorizing-users-during-installation)". +If you select **Request user authorization (OAuth) during installation** when creating or modifying your app, step 1 will be completed during app installation. For more information, see "[Authorizing users during installation](/apps/installing-github-apps/#authorizing-users-during-installation)." -#### 1. Solicitar identidade do GitHub de um usuário +#### 1. Request a user's GitHub identity GET {% data variables.product.oauth_host_code %}/login/oauth/authorize -Quando seu aplicativo GitHub especifica um parâmetro do `login`, ele solicita aos usuários com uma conta específica que podem usar para iniciar sessão e autorizar seu aplicativo. +When your GitHub App specifies a `login` parameter, it prompts users with a specific account they can use for signing in and authorizing your app. -##### Parâmetros +##### Parameters -| Nome | Tipo | Descrição | -| -------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `client_id` | `string` | **Obrigatório.** O ID do cliente para o seu aplicativo GitHub. Você pode encontrá-lo em suas [configurações do aplicativo GitHub](https://github.com/settings/apps) quando você selecionar seu aplicativo. | -| `redirect_uri` | `string` | A URL no seu aplicativo para o qual os usuários serão enviados após a autorização. Isso deve corresponder exatamente à URL fornecida no campo **URL de chamada de retorno de autorização do usuário** ao configurar o seu aplicativo GitHub e não pode conter nenhum parâmetro adicional. | -| `estado` | `string` | Isso deve conter uma string aleatória para proteger contra ataques falsificados e pode conter quaisquer outros dados arbitrários. | -| `login` | `string` | Sugere uma conta específica para iniciar a sessão e autorizar o aplicativo. | +Name | Type | Description +-----|------|------------ +`client_id` | `string` | **Required.** The client ID for your GitHub App. You can find this in your [GitHub App settings](https://github.com/settings/apps) when you select your app. +`redirect_uri` | `string` | The URL in your application where users will be sent after authorization. This must be an exact match to the URL you provided in the **User authorization callback URL** field when setting up your GitHub App and can't contain any additional parameters. +`state` | `string` | This should contain a random string to protect against forgery attacks and could contain any other arbitrary data. +`login` | `string` | Suggests a specific account to use for signing in and authorizing the app. {% note %} -**Observação:** Você não precisa fornecer escopos na sua solicitação de autorização. Ao contrário do OAuth tradicional, o token de autorização é limitado às permissões associadas ao seu aplicativo GitHub e às do usuário. +**Note:** You don't need to provide scopes in your authorization request. Unlike traditional OAuth, the authorization token is limited to the permissions associated with your GitHub App and those of the user. {% endnote %} -#### 2. Os usuários são redirecionados de volta para o seu site pelo GitHub +#### 2. Users are redirected back to your site by GitHub -Se o usuário aceitar o seu pedido, O GitHub irá fazer o redirecionamento para seu site com um `código temporário` em um parâmetro de código, bem como o estado que você forneceu na etapa anterior em um parâmetro do `estado`. Se os estados não corresponderem, o pedido foi criado por terceiros e o processo deve ser abortado. +If the user accepts your request, GitHub redirects back to your site with a temporary `code` in a code parameter as well as the state you provided in the previous step in a `state` parameter. If the states don't match, the request was created by a third party and the process should be aborted. {% note %} -**Observação:** Se você selecionar **Solicitar autorização de usuário (OAuth) durante a instalação** ao criar ou modificar seu aplicativo, o GitHub irá retornar um `código temporário` que você precisará trocar por um token de acesso. O parâmetro `estado` não é retornado quando o GitHub inicia o fluxo OAuth durante a instalação do aplicativo. +**Note:** If you select **Request user authorization (OAuth) during installation** when creating or modifying your app, GitHub returns a temporary `code` that you will need to exchange for an access token. The `state` parameter is not returned when GitHub initiates the OAuth flow during app installation. {% endnote %} -Troque este `código` por um token de acesso. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} Quando os tokens expirados estão habilitados, o token de acesso irá expirar em 8 horas e o token de atualização irá expirar em 6 meses. Toda vez que você atualizar o token, você receberá um novo token de atualização. Para mais informação, consulte "[Refreshing user-to-server access tokens](/apps/building-github-apps/refreshing-user-to-server-access-tokens/)." +Exchange this `code` for an access token. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} When expiring tokens are enabled, the access token expires in 8 hours and the refresh token expires in 6 months. Every time you refresh the token, you get a new refresh token. For more information, see "[Refreshing user-to-server access tokens](/apps/building-github-apps/refreshing-user-to-server-access-tokens/)." -Os tokens de usuário expirados atualmente fazem parte da expiração do token beta de usuário para servidor e estão sujeitos a alterações. Para optar por participar do recurso beta do token de usuário para servidor com expiração, consulte "[Ativar os recursos beta para aplicativos](/developers/apps/activating-beta-features-for-apps)".{% endif %} +Expiring user tokens are currently part of the user-to-server token expiration beta and subject to change. To opt-in to the user-to-server token expiration beta feature, see "[Activating beta features for apps](/developers/apps/activating-beta-features-for-apps)."{% endif %} POST {% data variables.product.oauth_host_code %}/login/oauth/access_token -##### Parâmetros +##### Parameters -| Nome | Tipo | Descrição | -| --------------- | -------- | ------------------------------------------------------------------------------ | -| `client_id` | `string` | **Obrigatório.** O ID do cliente para o seu aplicativo GitHub. | -| `client_secret` | `string` | **Obrigatório.** O segredo do cliente do seu aplicativo GitHub. | -| `código` | `string` | **Obrigatório.** O código que você recebeu como resposta ao Passo 1. | -| `redirect_uri` | `string` | A URL do seu aplicativo para onde os usuários são enviados após a autorização. | -| `estado` | `string` | A string aleatória inexplicável que você forneceu na etapa 1. | +Name | Type | Description +-----|------|------------ +`client_id` | `string` | **Required.** The client ID for your GitHub App. +`client_secret` | `string` | **Required.** The client secret for your GitHub App. +`code` | `string` | **Required.** The code you received as a response to Step 1. +`redirect_uri` | `string` | The URL in your application where users are sent after authorization. +`state` | `string` | The unguessable random string you provided in Step 1. -##### Resposta +##### Response {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -Por padrão, a resposta assume o seguinte formato. Os parâmetros de resposta `expires_in`, `atualizar_token`, e `refresh_token_expires_in` são apenas retornados quando você ativar o beta para expirar os tokens de acesso do usuário para servidor. +By default, the response takes the following form. The response parameters `expires_in`, `refresh_token`, and `refresh_token_expires_in` are only returned when you enable the beta for expiring user-to-server access tokens. ``` { @@ -100,832 +100,829 @@ Por padrão, a resposta assume o seguinte formato. Os parâmetros de resposta `e ``` {% else %} -Por padrão, a resposta assume o seguinte formato: +By default, the response takes the following form: access_token=e72e16c7e42f292c6912e7710c838347ae178b4a&token_type=bearer {% endif %} -#### 3. Seu aplicativo GitHub acessa a API com o token de acesso do usuário +#### 3. Your GitHub App accesses the API with the user's access token -O token de acesso do usuário permite que o aplicativo GitHub faça solicitações para a API em nome de um usuário. +The user's access token allows the GitHub App to make requests to the API on behalf of a user. - Autorização: token OUTH-TOKEN + Authorization: token OAUTH-TOKEN GET {% data variables.product.api_url_code %}/user -Por exemplo, no cURL você pode definir o cabeçalho de autorização da seguinte forma: +For example, in curl you can set the Authorization header like this: ```shell curl -H "Authorization: token OAUTH-TOKEN" {% data variables.product.api_url_pre %}/user ``` {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -### Fluxo de dispositivo +### Device flow {% note %} -**Observação:** O fluxo do dispositivo está na versão beta pública e sujeito a alterações.{% if currentVersion == "free-pro-team@latest" %} Para ativar este recurso beta, consulte "[Ativar recursos beta para aplicativos](/developers/apps/activating-beta-features-for-apps)."{% endif %} +**Note:** The device flow is in public beta and subject to change.{% if currentVersion == "free-pro-team@latest" %} To enable this beta feature, see "[Activating beta features for apps](/developers/apps/activating-beta-features-for-apps)."{% endif %} {% endnote %} -O fluxo de dispositivos permite que você autorize usuários para um aplicativo sem cabeçalho, como uma ferramenta de CLI ou um gerenciador de credenciais do Git. +The device flow allows you to authorize users for a headless app, such as a CLI tool or Git credential manager. -Para obter mais informações sobre autorização de usuários que usam o fluxo do dispositivo, consulte "[Autorizar aplicativos OAuth](/developers/apps/authorizing-oauth-apps#device-flow)". +For more information about authorizing users using the device flow, see "[Authorizing OAuth Apps](/developers/apps/authorizing-oauth-apps#device-flow)". {% endif %} -### Verifique quais recursos de instalação um usuário pode acessar +### Check which installation's resources a user can access {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %} {% data reusables.pre-release-program.machine-man-preview %} {% data reusables.pre-release-program.api-preview-warning %} {% endif %} -Depois de ter um token OAuth para um usuário, você pode verificar quais instalações o usuário poderá acessar. +Once you have an OAuth token for a user, you can check which installations that user can access. Authorization: token OAUTH-TOKEN GET /user/installations -Você também pode verificar quais repositórios são acessíveis a um usuário para uma instalação. +You can also check which repositories are accessible to a user for an installation. Authorization: token OAUTH-TOKEN GET /user/installations/:installation_id/repositories -Você pode encontrar mais informações em: [Listar instalações de aplicativos acessíveis para o token de acesso do usuário](/v3/apps/installations/#list-app-installations-accessible-to-the-user-access-token) e [Listar repositórios acessíveis para o token de acesso do usuário](/v3/apps/installations/#list-repositories-accessible-to-the-user-access-token). +More details can be found in: [List app installations accessible to the user access token](/v3/apps/installations/#list-app-installations-accessible-to-the-user-access-token) and [List repositories accessible to the user access token](/v3/apps/installations/#list-repositories-accessible-to-the-user-access-token). -### Tratar uma autorização revogada do aplicativo GitHub +### Handling a revoked GitHub App authorization -Se um usuário revogar sua autorização de um aplicativo GitHub, o aplicativo receberá o webhook [`github_app_authorization`](/webhooks/event-payloads/#github_app_authorization) por padrão. Os aplicativos GitHub não podem cancelar a assinatura deste evento. {% data reusables.webhooks.authorization_event %} +If a user revokes their authorization of a GitHub App, the app will receive the [`github_app_authorization`](/webhooks/event-payloads/#github_app_authorization) webhook by default. GitHub Apps cannot unsubscribe from this event. {% data reusables.webhooks.authorization_event %} -### Permissões no nível do usuário +### User-level permissions -Você pode adicionar permissões de nível de usuário ao seu aplicativo GitHub para acessar os recursos de usuários, como, por exemplo, e-mails de usuários, concedidos por usuários individuais como parte do fluxo de autorização do usuário [](#identifying-users-on-your-site). As permissões de nível de usuário diferem das [permissões do repositório do nível de organização](/v3/apps/permissions/), que são concedidas no momento da instalação em uma conta de organização ou usuário. +You can add user-level permissions to your GitHub App to access user resources, such as user emails, that are granted by individual users as part of the [user authorization flow](#identifying-users-on-your-site). User-level permissions differ from [repository and organization-level permissions](/v3/apps/permissions/), which are granted at the time of installation on an organization or user account. -Você pode selecionar permissões de nível de usuário nas configurações do seu aplicativo GitHub na seção **Permissões de usuário** na página **Permissões & webhooks**. Para obter mais informações sobre como selecionar permissões, consulte "[Editando permissões de um aplicativo GitHub](/apps/managing-github-apps/editing-a-github-app-s-permissions/)". +You can select user-level permissions from within your GitHub App's settings in the **User permissions** section of the **Permissions & webhooks** page. For more information on selecting permissions, see "[Editing a GitHub App's permissions](/apps/managing-github-apps/editing-a-github-app-s-permissions/)." -Quando um usuário instala seu aplicativo em sua conta, o prompt de instalação listará as permissões de nível de usuário que seu aplicativo solicita e explicará que o aplicativo pode pedir essas permissões a usuários individuais. +When a user installs your app on their account, the installation prompt will list the user-level permissions your app is requesting and explain that the app can ask individual users for these permissions. -Como as permissões de nível de usuário são concedidas em uma base de usuário individual, você poderá adicioná-las ao aplicativo existente sem pedir que os usuários façam a atualização. No entanto, você precisa enviar usuários existentes através do fluxo de autorização do usuário para autorizar a nova permissão e obter um novo token de usuário para servidor para essas solicitações. +Because user-level permissions are granted on an individual user basis, you can add them to your existing app without prompting users to upgrade. You will, however, need to send existing users through the user authorization flow to authorize the new permission and get a new user-to-server token for these requests. -### Solicitações de usuário para servidor +### User-to-server requests -Embora a maior parte da interação da sua API deva ocorrer usando os tokens de acesso de servidor para servidor, certos pontos de extremidade permitem que você execute ações por meio da API usando um token de acesso do usuário. Seu aplicativo pode fazer as seguintes solicitações usando pontos de extremidade do [GraphQL v4](/v4/) ou [REST v3](/v3/). +While most of your API interaction should occur using your server-to-server installation access tokens, certain endpoints allow you to perform actions via the API using a user access token. Your app can make the following requests using [GraphQL v4](/v4/) or [REST v3](/v3/) endpoints. -#### Pontos de extremidade compatíveis +#### Supported endpoints {% if currentVersion == "free-pro-team@latest" %} -##### Executores de ações - -* [Listar aplicativos executores para um repositório](/v3/actions/self-hosted-runners/#list-runner-applications-for-a-repository) -* [Listar executores auto-hospedados para um repositório](/v3/actions/self-hosted-runners/#list-self-hosted-runners-for-a-repository) -* [Obter um executor auto-hospedado para um repositório](/v3/actions/self-hosted-runners/#get-a-self-hosted-runner-for-a-repository) -* [Excluir um executor auto-hospedado de um repositório](/v3/actions/self-hosted-runners/#delete-a-self-hosted-runner-from-a-repository) -* [Criar um token de registro para um repositório](/v3/actions/self-hosted-runners/#create-a-registration-token-for-a-repository) -* [Criar um token de remoção para um repositório](/v3/actions/self-hosted-runners/#create-a-remove-token-for-a-repository) -* [Listar aplicativos executores para uma organização](/v3/actions/self-hosted-runners/#list-runner-applications-for-an-organization) -* [Listar executores auto-hospedados para uma organização](/v3/actions/self-hosted-runners/#list-self-hosted-runners-for-an-organization) -* [Obter um executor auto-hospedado para uma organização](/v3/actions/self-hosted-runners/#get-a-self-hosted-runner-for-an-organization) -* [Excluir um executor auto-hospedado de uma organização](/v3/actions/self-hosted-runners/#delete-a-self-hosted-runner-from-an-organization) -* [Criar um token de registro para uma organização](/v3/actions/self-hosted-runners/#create-a-registration-token-for-an-organization) -* [Criar um token de remoção para uma organização](/v3/actions/self-hosted-runners/#create-a-remove-token-for-an-organization) - -##### Segredos de ações - -* [Obter uma chave pública do repositório](/v3/actions/secrets/#get-a-repository-public-key) -* [Listar segredos do repositório](/v3/actions/secrets/#list-repository-secrets) -* [Obter um segredo do repositório](/v3/actions/secrets/#get-a-repository-secret) -* [Criar ou atualizar o segredo de um repositório](/v3/actions/secrets/#create-or-update-a-repository-secret) -* [Excluir o segredo de um repositório](/v3/actions/secrets/#delete-a-repository-secret) -* [Obter chave pública de uma organização](/v3/actions/secrets/#get-an-organization-public-key) -* [Listar segredos da organização](/v3/actions/secrets/#list-organization-secrets) -* [Obter segredo de uma organização](/v3/actions/secrets/#get-an-organization-secret) -* [Criar ou atualizar o segredo de uma organização](/v3/actions/secrets/#create-or-update-an-organization-secret) -* [Listar repositórios selecionados para o segredo de uma organização](/v3/actions/secrets/#list-selected-repositories-for-an-organization-secret) -* [Definir repositórios selecionados para o segredo de uma organização](/v3/actions/secrets/#set-selected-repositories-for-an-organization-secret) -* [Adicionar o repositório selecionado ao segredo de uma organização](/v3/actions/secrets/#add-selected-repository-to-an-organization-secret) -* [Remover o repositório selecionado do segredo de uma organização](/v3/actions/secrets/#remove-selected-repository-from-an-organization-secret) -* [Excluir o segredo de uma organização](/v3/actions/secrets/#delete-an-organization-secret) +##### Actions Runners + +* [List runner applications for a repository](/v3/actions/self-hosted-runners/#list-runner-applications-for-a-repository) +* [List self-hosted runners for a repository](/v3/actions/self-hosted-runners/#list-self-hosted-runners-for-a-repository) +* [Get a self-hosted runner for a repository](/v3/actions/self-hosted-runners/#get-a-self-hosted-runner-for-a-repository) +* [Delete a self-hosted runner from a repository](/v3/actions/self-hosted-runners/#delete-a-self-hosted-runner-from-a-repository) +* [Create a registration token for a repository](/v3/actions/self-hosted-runners/#create-a-registration-token-for-a-repository) +* [Create a remove token for a repository](/v3/actions/self-hosted-runners/#create-a-remove-token-for-a-repository) +* [List runner applications for an organization](/v3/actions/self-hosted-runners/#list-runner-applications-for-an-organization) +* [List self-hosted runners for an organization](/v3/actions/self-hosted-runners/#list-self-hosted-runners-for-an-organization) +* [Get a self-hosted runner for an organization](/v3/actions/self-hosted-runners/#get-a-self-hosted-runner-for-an-organization) +* [Delete a self-hosted runner from an organization](/v3/actions/self-hosted-runners/#delete-a-self-hosted-runner-from-an-organization) +* [Create a registration token for an organization](/v3/actions/self-hosted-runners/#create-a-registration-token-for-an-organization) +* [Create a remove token for an organization](/v3/actions/self-hosted-runners/#create-a-remove-token-for-an-organization) + +##### Actions Secrets + +* [Get a repository public key](/v3/actions/secrets/#get-a-repository-public-key) +* [List repository secrets](/v3/actions/secrets/#list-repository-secrets) +* [Get a repository secret](/v3/actions/secrets/#get-a-repository-secret) +* [Create or update a repository secret](/v3/actions/secrets/#create-or-update-a-repository-secret) +* [Delete a repository secret](/v3/actions/secrets/#delete-a-repository-secret) +* [Get an organization public key](/v3/actions/secrets/#get-an-organization-public-key) +* [List organization secrets](/v3/actions/secrets/#list-organization-secrets) +* [Get an organization secret](/v3/actions/secrets/#get-an-organization-secret) +* [Create or update an organization secret](/v3/actions/secrets/#create-or-update-an-organization-secret) +* [List selected repositories for an organization secret](/v3/actions/secrets/#list-selected-repositories-for-an-organization-secret) +* [Set selected repositories for an organization secret](/v3/actions/secrets/#set-selected-repositories-for-an-organization-secret) +* [Add selected repository to an organization secret](/v3/actions/secrets/#add-selected-repository-to-an-organization-secret) +* [Remove selected repository from an organization secret](/v3/actions/secrets/#remove-selected-repository-from-an-organization-secret) +* [Delete an organization secret](/v3/actions/secrets/#delete-an-organization-secret) {% endif %} {% if currentVersion == "free-pro-team@latest" %} -##### Artefatos +##### Artifacts -* [Listar artefatos para um repositório](/v3/actions/artifacts/#list-artifacts-for-a-repository) -* [Listar artefatos executados por fluxo de trabalho](/v3/actions/artifacts/#list-workflow-run-artifacts) -* [Obter um artefato](/v3/actions/artifacts/#get-an-artifact) -* [Excluir um artefato](/v3/actions/artifacts/#delete-an-artifact) -* [Fazer o download de um artefato](/v3/actions/artifacts/#download-an-artifact) +* [List artifacts for a repository](/v3/actions/artifacts/#list-artifacts-for-a-repository) +* [List workflow run artifacts](/v3/actions/artifacts/#list-workflow-run-artifacts) +* [Get an artifact](/v3/actions/artifacts/#get-an-artifact) +* [Delete an artifact](/v3/actions/artifacts/#delete-an-artifact) +* [Download an artifact](/v3/actions/artifacts/#download-an-artifact) {% endif %} -##### Execuções de verificação +##### Check Runs -* [Criar uma verificação de execução](/v3/checks/runs/#create-a-check-run) -* [Obter uma verificação de execução](/v3/checks/runs/#get-a-check-run) -* [Atualizar uma execução de verificação](/v3/checks/runs/#update-a-check-run) -* [Listar anotações de execução de verificação](/v3/checks/runs/#list-check-run-annotations) -* [Listar execuções de verificações em um conjunto de verificações](/v3/checks/runs/#list-check-runs-in-a-check-suite) -* [Listar execuções de verificação para uma referência do GIt](/v3/checks/runs/#list-check-runs-for-a-git-reference) +* [Create a check run](/v3/checks/runs/#create-a-check-run) +* [Get a check run](/v3/checks/runs/#get-a-check-run) +* [Update a check run](/v3/checks/runs/#update-a-check-run) +* [List check run annotations](/v3/checks/runs/#list-check-run-annotations) +* [List check runs in a check suite](/v3/checks/runs/#list-check-runs-in-a-check-suite) +* [List check runs for a Git reference](/v3/checks/runs/#list-check-runs-for-a-git-reference) -##### conjuntos de verificações +##### Check Suites -* [Criar um conjunto de verificações](/v3/checks/suites/#create-a-check-suite) -* [Obter um conjunto de verificações](/v3/checks/suites/#get-a-check-suite) -* [Ressolicitar um conjunto de verificação](/v3/checks/suites/#rerequest-a-check-suite) -* [Atualizar preferências do repositório para conjuntos de verificações](/v3/checks/suites/#update-repository-preferences-for-check-suites) -* [Listar os conjuntos de verificação para uma referência do Git](/v3/checks/suites/#list-check-suites-for-a-git-reference) +* [Create a check suite](/v3/checks/suites/#create-a-check-suite) +* [Get a check suite](/v3/checks/suites/#get-a-check-suite) +* [Rerequest a check suite](/v3/checks/suites/#rerequest-a-check-suite) +* [Update repository preferences for check suites](/v3/checks/suites/#update-repository-preferences-for-check-suites) +* [List check suites for a Git reference](/v3/checks/suites/#list-check-suites-for-a-git-reference) -##### Códigos de conduta +##### Codes Of Conduct -* [Obter todos os códigos de conduta](/v3/codes_of_conduct/#get-all-codes-of-conduct) -* [Obter um código de conduta](/v3/codes_of_conduct/#get-a-code-of-conduct) +* [Get all codes of conduct](/v3/codes_of_conduct/#get-all-codes-of-conduct) +* [Get a code of conduct](/v3/codes_of_conduct/#get-a-code-of-conduct) -##### Status da implementação +##### Deployment Statuses -* [Listar status de implementação](/v3/repos/deployments/#list-deployment-statuses) -* [Criar um status de implementação](/v3/repos/deployments/#create-a-deployment-status) -* [Obter um status de implementação](/v3/repos/deployments/#get-a-deployment-status) +* [List deployment statuses](/rest/reference/repos#list-deployment-statuses) +* [Create a deployment status](/rest/reference/repos#create-a-deployment-status) +* [Get a deployment status](/rest/reference/repos#get-a-deployment-status) -##### Implantações +##### Deployments -* [Listar implementações](/v3/repos/deployments/#list-deployments) -* [Criar uma implementação](/v3/repos/deployments/#create-a-deployment) -* [Obter uma implementação](/v3/repos/deployments/#get-a-deployment){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -* [Excluir uma implementação](/v3/repos/deployments/#delete-a-deployment){% endif %} +* [List deployments](/rest/reference/repos#list-deployments) +* [Create a deployment](/rest/reference/repos#create-a-deployment) +* [Get a deployment](/rest/reference/repos#get-a-deployment){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +* [Delete a deployment](/rest/reference/repos#delete-a-deployment){% endif %} -##### Eventos +##### Events -* [Listar eventos públicos de uma rede de repositórios](/v3/activity/events/#list-public-events-for-a-network-of-repositories) -* [Listar eventos públicos da organização](/v3/activity/events/#list-public-organization-events) +* [List public events for a network of repositories](/rest/reference/activity#list-public-events-for-a-network-of-repositories) +* [List public organization events](/rest/reference/activity#list-public-organization-events) ##### Feeds -* [Obter feeds](/v3/activity/feeds/#get-feeds) +* [Get feeds](/rest/reference/activity#get-feeds) -##### Blobs do Git +##### Git Blobs -* [Criar um blob](/v3/git/blobs/#create-a-blob) -* [Obter um blob](/v3/git/blobs/#get-a-blob) +* [Create a blob](/v3/git/blobs/#create-a-blob) +* [Get a blob](/v3/git/blobs/#get-a-blob) -##### Commits do Git +##### Git Commits -* [Criar um commit](/v3/git/commits/#create-a-commit) -* [Obter um commit](/v3/git/commits/#get-a-commit) +* [Create a commit](/v3/git/commits/#create-a-commit) +* [Get a commit](/v3/git/commits/#get-a-commit) -##### Refs do Git +##### Git Refs -* [Criar uma referência](/v3/git/refs/#create-a-reference){% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -* [Listar referências](/v3/git/refs/#list-references) -* [Obter uma referência](/v3/git/refs/#get-a-reference){% else %} -* [Obter uma referência](/v3/git/refs/#get-a-reference) -* [Lista de referências correspondentes](/v3/git/refs/#list-matching-references){% endif %} -* [Atualizar uma referência](/v3/git/refs/#update-a-reference) -* [Excluir uma referência](/v3/git/refs/#delete-a-reference) +* [Create a reference](/v3/git/refs/#create-a-reference)* [Get a reference](/v3/git/refs/#get-a-reference) +* [List matching references](/v3/git/refs/#list-matching-references) +* [Update a reference](/v3/git/refs/#update-a-reference) +* [Delete a reference](/v3/git/refs/#delete-a-reference) -##### Tags do Git +##### Git Tags -* [Criar um objeto de tag](/v3/git/tags/#create-a-tag-object) -* [Obter uma tag](/v3/git/tags/#get-a-tag) +* [Create a tag object](/v3/git/tags/#create-a-tag-object) +* [Get a tag](/v3/git/tags/#get-a-tag) -##### Árvores do Git +##### Git Trees -* [Criar uma árvore](/v3/git/trees/#create-a-tree) -* [Obter uma árvore](/v3/git/trees/#get-a-tree) +* [Create a tree](/v3/git/trees/#create-a-tree) +* [Get a tree](/v3/git/trees/#get-a-tree) -##### Modelos do Gitignore +##### Gitignore Templates -* [Obter todos os modelos do gitignore](/v3/gitignore/#get-all-gitignore-templates) -* [Obter um modelo do gitignore](/v3/gitignore/#get-a-gitignore-template) +* [Get all gitignore templates](/v3/gitignore/#get-all-gitignore-templates) +* [Get a gitignore template](/v3/gitignore/#get-a-gitignore-template) -##### Instalações +##### Installations -* [Listar repositórios acessíveis ao token de acesso do usuário](/v3/apps/installations/#list-repositories-accessible-to-the-user-access-token) +* [List repositories accessible to the user access token](/v3/apps/installations/#list-repositories-accessible-to-the-user-access-token) {% if currentVersion == "free-pro-team@latest" %} -##### Limites de interação - -* [Obter restrições de interação para uma organização](/v3/interactions/orgs/#get-interaction-restrictions-for-an-organization) -* [Definir restrições de interação para uma organização](/v3/interactions/orgs/#set-interaction-restrictions-for-an-organization) -* [Remover restrições de interação para uma organização](/v3/interactions/orgs/#remove-interaction-restrictions-for-an-organization) -* [Obter restrições de interação para um repositório](/v3/interactions/repos/#get-interaction-restrictions-for-a-repository) -* [Definir restrições de interação para um repositório](/v3/interactions/repos/#set-interaction-restrictions-for-a-repository) -* [Remover restrições de interação para um repositório](/v3/interactions/repos/#remove-interaction-restrictions-for-a-repository) +##### Interaction Limits + +* [Get interaction restrictions for an organization](/v3/interactions/orgs/#get-interaction-restrictions-for-an-organization) +* [Set interaction restrictions for an organization](/v3/interactions/orgs/#set-interaction-restrictions-for-an-organization) +* [Remove interaction restrictions for an organization](/v3/interactions/orgs/#remove-interaction-restrictions-for-an-organization) +* [Get interaction restrictions for a repository](/v3/interactions/repos/#get-interaction-restrictions-for-a-repository) +* [Set interaction restrictions for a repository](/v3/interactions/repos/#set-interaction-restrictions-for-a-repository) +* [Remove interaction restrictions for a repository](/v3/interactions/repos/#remove-interaction-restrictions-for-a-repository) {% endif %} -##### Responsáveis pelo problema +##### Issue Assignees -* [Adicionar responsáveis a um problema](/v3/issues/assignees/#add-assignees-to-an-issue) -* [Remover responsáveis de um problema](/v3/issues/assignees/#remove-assignees-from-an-issue) +* [Add assignees to an issue](/v3/issues/assignees/#add-assignees-to-an-issue) +* [Remove assignees from an issue](/v3/issues/assignees/#remove-assignees-from-an-issue) -##### Comentários do problema +##### Issue Comments -* [Listar comentários do problema](/v3/issues/comments/#list-issue-comments) -* [Criar um comentário do problema](/v3/issues/comments/#create-an-issue-comment) -* [Listar comentários de problemas para um repositório](/v3/issues/comments/#list-issue-comments-for-a-repository) -* [Obter um comentário do issue](/v3/issues/comments/#get-an-issue-comment) -* [Atualizar um comentário do problema](/v3/issues/comments/#update-an-issue-comment) -* [Excluir comentário do problema](/v3/issues/comments/#delete-an-issue-comment) +* [List issue comments](/v3/issues/comments/#list-issue-comments) +* [Create an issue comment](/v3/issues/comments/#create-an-issue-comment) +* [List issue comments for a repository](/v3/issues/comments/#list-issue-comments-for-a-repository) +* [Get an issue comment](/v3/issues/comments/#get-an-issue-comment) +* [Update an issue comment](/v3/issues/comments/#update-an-issue-comment) +* [Delete an issue comment](/v3/issues/comments/#delete-an-issue-comment) -##### Eventos do problema +##### Issue Events -* [Listar eventos do problema](/v3/issues/events/#list-issue-events) +* [List issue events](/v3/issues/events/#list-issue-events) -##### Linha do tempo do problema +##### Issue Timeline -* [Listar eventos da linha do tempo para um problema](/v3/issues/timeline/#list-timeline-events-for-an-issue) +* [List timeline events for an issue](/v3/issues/timeline/#list-timeline-events-for-an-issue) -##### Problemas +##### Issues -* [Listar problemas atribuídos ao usuário autenticado](/v3/issues/#list-issues-assigned-to-the-authenticated-user) -* [Listar responsáveis](/v3/issues/assignees/#list-assignees) -* [Verificar se um usuário pode ser atribuído](/v3/issues/assignees/#check-if-a-user-can-be-assigned) -* [Listar problemas do repositório](/v3/issues/#list-repository-issues) -* [Cria um problema](/v3/issues/#create-an-issue) -* [Obter um problema](/v3/issues/#get-an-issue) -* [Atualizar um problema](/v3/issues/#update-an-issue) -* [Bloquear um problema](/v3/issues/#lock-an-issue) -* [Desbloquear um problema](/v3/issues/#unlock-an-issue) +* [List issues assigned to the authenticated user](/v3/issues/#list-issues-assigned-to-the-authenticated-user) +* [List assignees](/v3/issues/assignees/#list-assignees) +* [Check if a user can be assigned](/v3/issues/assignees/#check-if-a-user-can-be-assigned) +* [List repository issues](/v3/issues/#list-repository-issues) +* [Create an issue](/v3/issues/#create-an-issue) +* [Get an issue](/v3/issues/#get-an-issue) +* [Update an issue](/v3/issues/#update-an-issue) +* [Lock an issue](/v3/issues/#lock-an-issue) +* [Unlock an issue](/v3/issues/#unlock-an-issue) {% if currentVersion == "free-pro-team@latest" %} -##### Trabalhos +##### Jobs -* [Obter um trabalho para uma execução de fluxo de trabalho](/v3/actions/workflow-jobs/#get-a-job-for-a-workflow-run) -* [Fazer o download dos registros de trabalho para execução de um fluxo de trabalho](/v3/actions/workflow-jobs/#download-job-logs-for-a-workflow-run) -* [Listar tarefas para execução de um fluxo de trabalho](/v3/actions/workflow-jobs/#list-jobs-for-a-workflow-run) +* [Get a job for a workflow run](/v3/actions/workflow-jobs/#get-a-job-for-a-workflow-run) +* [Download job logs for a workflow run](/v3/actions/workflow-jobs/#download-job-logs-for-a-workflow-run) +* [List jobs for a workflow run](/v3/actions/workflow-jobs/#list-jobs-for-a-workflow-run) {% endif %} -##### Etiquetas +##### Labels -* [Listar etiquetas para um problema](/v3/issues/labels/#list-labels-for-an-issue) -* [Adicionar etiquetas a um problema](/v3/issues/labels/#add-labels-to-an-issue) -* [Definir etiquetas para um problema](/v3/issues/labels/#set-labels-for-an-issue) -* [Remover todas as etiquetas de um problema](/v3/issues/labels/#remove-all-labels-from-an-issue) -* [Remover uma etiqueta de um problema](/v3/issues/labels/#remove-a-label-from-an-issue) -* [Listar etiquetas para um repositório](/v3/issues/labels/#list-labels-for-a-repository) -* [Criar uma etiqueta](/v3/issues/labels/#create-a-label) -* [Obter uma etiqueta](/v3/issues/labels/#get-a-label) -* [Atualizar uma etiqueta](/v3/issues/labels/#update-a-label) -* [Excluir uma etiqueta](/v3/issues/labels/#delete-a-label) -* [Obter etiquetas para cada problema em um marco](/v3/issues/labels/#list-labels-for-issues-in-a-milestone) +* [List labels for an issue](/v3/issues/labels/#list-labels-for-an-issue) +* [Add labels to an issue](/v3/issues/labels/#add-labels-to-an-issue) +* [Set labels for an issue](/v3/issues/labels/#set-labels-for-an-issue) +* [Remove all labels from an issue](/v3/issues/labels/#remove-all-labels-from-an-issue) +* [Remove a label from an issue](/v3/issues/labels/#remove-a-label-from-an-issue) +* [List labels for a repository](/v3/issues/labels/#list-labels-for-a-repository) +* [Create a label](/v3/issues/labels/#create-a-label) +* [Get a label](/v3/issues/labels/#get-a-label) +* [Update a label](/v3/issues/labels/#update-a-label) +* [Delete a label](/v3/issues/labels/#delete-a-label) +* [Get labels for every issue in a milestone](/v3/issues/labels/#list-labels-for-issues-in-a-milestone) -##### Licenças +##### Licenses -* [Obter todas as licenças comumente usadas](/v3/licenses/#get-all-commonly-used-licenses) -* [Obtenha uma licença](/v3/licenses/#get-a-license) +* [Get all commonly used licenses](/v3/licenses/#get-all-commonly-used-licenses) +* [Get a license](/v3/licenses/#get-a-license) -##### markdown +##### Markdown -* [Renderizar um documento markdown](/v3/markdown/#render-a-markdown-document) -* [Renderizar um documento markdown no modo bruto](/v3/markdown/#render-a-markdown-document-in-raw-mode) +* [Render a Markdown document](/v3/markdown/#render-a-markdown-document) +* [Render a markdown document in raw mode](/v3/markdown/#render-a-markdown-document-in-raw-mode) ##### Meta * [Meta](/v3/meta/#meta) -##### Marcos +##### Milestones -* [Listar marcos](/v3/issues/milestones/#list-milestones) -* [Criar um marco](/v3/issues/milestones/#create-a-milestone) -* [Obter um marco](/v3/issues/milestones/#get-a-milestone) -* [Atualizar um marco](/v3/issues/milestones/#update-a-milestone) -* [Excluir um marco](/v3/issues/milestones/#delete-a-milestone) +* [List milestones](/v3/issues/milestones/#list-milestones) +* [Create a milestone](/v3/issues/milestones/#create-a-milestone) +* [Get a milestone](/v3/issues/milestones/#get-a-milestone) +* [Update a milestone](/v3/issues/milestones/#update-a-milestone) +* [Delete a milestone](/v3/issues/milestones/#delete-a-milestone) -##### Hooks da organização +##### Organization Hooks -* [Listar webhooks da organização](/v3/orgs/hooks/#list-organization-webhooks) -* [Criar um webhook da organização](/v3/orgs/hooks/#create-an-organization-webhook) -* [Obter um webhook da organização](/v3/orgs/hooks/#get-an-organization-webhook) -* [Atualizar um webhook da organização](/v3/orgs/hooks/#update-an-organization-webhook) -* [Excluir um webhook da organização](/v3/orgs/hooks/#delete-an-organization-webhook) -* [Consultar um webhook da organização](/v3/orgs/hooks/#ping-an-organization-webhook) +* [List organization webhooks](/rest/reference/orgs#webhooks/#list-organization-webhooks) +* [Create an organization webhook](/rest/reference/orgs#webhooks/#create-an-organization-webhook) +* [Get an organization webhook](/rest/reference/orgs#webhooks/#get-an-organization-webhook) +* [Update an organization webhook](/rest/reference/orgs#webhooks/#update-an-organization-webhook) +* [Delete an organization webhook](/rest/reference/orgs#webhooks/#delete-an-organization-webhook) +* [Ping an organization webhook](/rest/reference/orgs#webhooks/#ping-an-organization-webhook) {% if currentVersion == "free-pro-team@latest" %} -##### Convites da organização +##### Organization Invitations -* [Listar convites pendentes para organizações](/v3/orgs/members/#list-pending-organization-invitations) -* [Criar um convite de organização](/v3/orgs/members/#create-an-organization-invitation) -* [Listar equipes de convite da organização](/v3/orgs/members/#list-organization-invitation-teams) +* [List pending organization invitations](/v3/orgs/members/#list-pending-organization-invitations) +* [Create an organization invitation](/v3/orgs/members/#create-an-organization-invitation) +* [List organization invitation teams](/v3/orgs/members/#list-organization-invitation-teams) {% endif %} -##### Integrantes da organização +##### Organization Members -* [Listar integrantes da organização](/v3/orgs/members/#list-organization-members) -* [Verificar associação da organização para um usuário](/v3/orgs/members/#check-organization-membership-for-a-user) -* [Remover um membro da organização](/v3/orgs/members/#remove-an-organization-member) -* [Obter a associação de uma organização para um usuário](/v3/orgs/members/#get-organization-membership-for-a-user) -* [Definir associação de organização para um usuário](/v3/orgs/members/#set-organization-membership-for-a-user) -* [Remover associação de organização para um usuário](/v3/orgs/members/#remove-organization-membership-for-a-user) -* [Listar membros públicos da organização](/v3/orgs/members/#list-public-organization-members) -* [Verificar a associação da organização pública para um usuário](/v3/orgs/members/#check-public-organization-membership-for-a-user) -* [Definir associação à organização pública para o usuário autenticado](/v3/orgs/members/#set-public-organization-membership-for-the-authenticated-user) -* [Remover associação à organização pública para o usuário autenticado](/v3/orgs/members/#remove-public-organization-membership-for-the-authenticated-user) +* [List organization members](/v3/orgs/members/#list-organization-members) +* [Check organization membership for a user](/v3/orgs/members/#check-organization-membership-for-a-user) +* [Remove an organization member](/v3/orgs/members/#remove-an-organization-member) +* [Get organization membership for a user](/v3/orgs/members/#get-organization-membership-for-a-user) +* [Set organization membership for a user](/v3/orgs/members/#set-organization-membership-for-a-user) +* [Remove organization membership for a user](/v3/orgs/members/#remove-organization-membership-for-a-user) +* [List public organization members](/v3/orgs/members/#list-public-organization-members) +* [Check public organization membership for a user](/v3/orgs/members/#check-public-organization-membership-for-a-user) +* [Set public organization membership for the authenticated user](/v3/orgs/members/#set-public-organization-membership-for-the-authenticated-user) +* [Remove public organization membership for the authenticated user](/v3/orgs/members/#remove-public-organization-membership-for-the-authenticated-user) -##### Colaboradores externos da organização +##### Organization Outside Collaborators -* [Listar colaboradores externos para uma organização](/v3/orgs/outside_collaborators/#list-outside-collaborators-for-an-organization) -* [Converter um integrante da organização em colaborador externo](/v3/orgs/outside_collaborators/#convert-an-organization-member-to-outside-collaborator) -* [Remover colaboradores externos de uma organização](/v3/orgs/outside_collaborators/#remove-outside-collaborator-from-an-organization) +* [List outside collaborators for an organization](/v3/orgs/outside_collaborators/#list-outside-collaborators-for-an-organization) +* [Convert an organization member to outside collaborator](/v3/orgs/outside_collaborators/#convert-an-organization-member-to-outside-collaborator) +* [Remove outside collaborator from an organization](/v3/orgs/outside_collaborators/#remove-outside-collaborator-from-an-organization) {% if currentVersion != "free-pro-team@latest" %} -##### Hooks pre-receive da organização +##### Organization Pre Receive Hooks -* [Listar hooks pre-receive para uma organização](/enterprise/user/rest/reference/enterprise-admin#list-pre-receive-hooks-for-an-organization) -* [Obter um hook pre-receive para uma organização](/enterprise/user/rest/reference/enterprise-admin#get-a-pre-receive-hook-for-an-organization) -* [Atualizar a aplicação do hook pre-receive para uma organização](/enterprise/user/rest/reference/enterprise-admin#update-pre-receive-hook-enforcement-for-an-organization) -* [Remover a aplicação do hook pre-receive para uma organização](/enterprise/user/rest/reference/enterprise-admin#remove-pre-receive-hook-enforcement-for-an-organization) +* [List pre-receive hooks for an organization](/enterprise/user/rest/reference/enterprise-admin#list-pre-receive-hooks-for-an-organization) +* [Get a pre-receive hook for an organization](/enterprise/user/rest/reference/enterprise-admin#get-a-pre-receive-hook-for-an-organization) +* [Update pre-receive hook enforcement for an organization](/enterprise/user/rest/reference/enterprise-admin#update-pre-receive-hook-enforcement-for-an-organization) +* [Remove pre-receive hook enforcement for an organization](/enterprise/user/rest/reference/enterprise-admin#remove-pre-receive-hook-enforcement-for-an-organization) {% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -##### Projetos da aquipe da organização +##### Organization Team Projects -* [Listar projetos da equipe](/v3/teams/#list-team-projects) -* [Verificar permissões da equipe para um projeto](/v3/teams/#check-team-permissions-for-a-project) -* [Adicionar ou atualizar as permissões do projeto da equipe](/v3/teams/#add-or-update-team-project-permissions) -* [Remover um projeto de uma equipe](/v3/teams/#remove-a-project-from-a-team) +* [List team projects](/v3/teams/#list-team-projects) +* [Check team permissions for a project](/v3/teams/#check-team-permissions-for-a-project) +* [Add or update team project permissions](/v3/teams/#add-or-update-team-project-permissions) +* [Remove a project from a team](/v3/teams/#remove-a-project-from-a-team) {% endif %} -##### Repositórios da equipe da organização +##### Organization Team Repositories -* [Listar repositórios da equipe](/v3/teams/#list-team-repositories) -* [Verificar permissões da equipe para um repositório](/v3/teams/#check-team-permissions-for-a-repository) -* [Adicionar ou atualizar as permissões do repositório da equipe](/v3/teams/#add-or-update-team-repository-permissions) -* [Remover um repositório de uma equipe](/v3/teams/#remove-a-repository-from-a-team) +* [List team repositories](/v3/teams/#list-team-repositories) +* [Check team permissions for a repository](/v3/teams/#check-team-permissions-for-a-repository) +* [Add or update team repository permissions](/v3/teams/#add-or-update-team-repository-permissions) +* [Remove a repository from a team](/v3/teams/#remove-a-repository-from-a-team) {% if currentVersion == "free-pro-team@latest" %} -##### Sincronizar equipe da organização +##### Organization Team Sync -* [Listar grupos de idp para uma equipe](/v3/teams/team_sync/#list-idp-groups-for-a-team) -* [Criar ou atualizar conexões do grupo de idp](/v3/teams/team_sync/#create-or-update-idp-group-connections) -* [Listar grupos de IdP para uma organização](/v3/teams/team_sync/#list-idp-groups-for-an-organization) +* [List idp groups for a team](/v3/teams/team_sync/#list-idp-groups-for-a-team) +* [Create or update idp group connections](/v3/teams/team_sync/#create-or-update-idp-group-connections) +* [List IdP groups for an organization](/v3/teams/team_sync/#list-idp-groups-for-an-organization) {% endif %} -##### Equipes da organização +##### Organization Teams -* [Listar equipes](/v3/teams/#list-teams) -* [Criar uma equipe](/v3/teams/#create-a-team) -* [Obter uma equipe por nome](/v3/teams/#get-a-team-by-name) +* [List teams](/v3/teams/#list-teams) +* [Create a team](/v3/teams/#create-a-team) +* [Get a team by name](/v3/teams/#get-a-team-by-name) {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.21" %} -* [Obter uma equipe](/v3/teams/#get-a-team) +* [Get a team](/v3/teams/#get-a-team) {% endif %} -* [Atualizar uma equipe](/v3/teams/#update-a-team) -* [Excluir uma equipe](/v3/teams/#delete-a-team) +* [Update a team](/v3/teams/#update-a-team) +* [Delete a team](/v3/teams/#delete-a-team) {% if currentVersion == "free-pro-team@latest" %} -* [Listar convites pendentes da equipe](/v3/teams/members/#list-pending-team-invitations) +* [List pending team invitations](/v3/teams/members/#list-pending-team-invitations) {% endif %} -* [Listar integrantes da equipe](/v3/teams/members/#list-team-members) -* [Obter a associação à equipe para um usuário](/v3/teams/members/#get-team-membership-for-a-user) -* [Adicionar ou atualizar membros de equipe para um usuário](/v3/teams/members/#add-or-update-team-membership-for-a-user) -* [Remover associação à equipe para um usuário](/v3/teams/members/#remove-team-membership-for-a-user) -* [Listar equipes secundárias](/v3/teams/#list-child-teams) -* [Listar equipes para o usuário autenticado](/v3/teams/#list-teams-for-the-authenticated-user) - -##### Organizações - -* [Listar organizações](/v3/orgs/#list-organizations) -* [Obter uma organização](/v3/orgs/#get-an-organization) -* [Atualizar uma organização](/v3/orgs/#update-an-organization) -* [Listar associações de organizações para os usuários autenticados](/v3/orgs/members/#list-organization-memberships-for-the-authenticated-user) -* [Obter uma associação de organização para o usuário autenticado](/v3/orgs/members/#get-an-organization-membership-for-the-authenticated-user) -* [Atualizar uma associação de organização para o usuário autenticado](/v3/orgs/members/#update-an-organization-membership-for-the-authenticated-user) -* [Listar organizações para o usuário autenticado](/v3/orgs/#list-organizations-for-the-authenticated-user) -* [Listar organizações para um usuário](/v3/orgs/#list-organizations-for-a-user) +* [List team members](/v3/teams/members/#list-team-members) +* [Get team membership for a user](/v3/teams/members/#get-team-membership-for-a-user) +* [Add or update team membership for a user](/v3/teams/members/#add-or-update-team-membership-for-a-user) +* [Remove team membership for a user](/v3/teams/members/#remove-team-membership-for-a-user) +* [List child teams](/v3/teams/#list-child-teams) +* [List teams for the authenticated user](/v3/teams/#list-teams-for-the-authenticated-user) + +##### Organizations + +* [List organizations](/v3/orgs/#list-organizations) +* [Get an organization](/v3/orgs/#get-an-organization) +* [Update an organization](/v3/orgs/#update-an-organization) +* [List organization memberships for the authenticated user](/v3/orgs/members/#list-organization-memberships-for-the-authenticated-user) +* [Get an organization membership for the authenticated user](/v3/orgs/members/#get-an-organization-membership-for-the-authenticated-user) +* [Update an organization membership for the authenticated user](/v3/orgs/members/#update-an-organization-membership-for-the-authenticated-user) +* [List organizations for the authenticated user](/v3/orgs/#list-organizations-for-the-authenticated-user) +* [List organizations for a user](/v3/orgs/#list-organizations-for-a-user) {% if currentVersion == "free-pro-team@latest" %} -##### Autorizações de credencial das organizações +##### Organizations Credential Authorizations -* [Listar autorizações do SAML SSO para uma organização](/v3/orgs/#list-saml-sso-authorizations-for-an-organization) -* [Remover uma autorização do SAML SSO para uma organização](/v3/orgs/#remove-a-saml-sso-authorization-for-an-organization) +* [List SAML SSO authorizations for an organization](/v3/orgs/#list-saml-sso-authorizations-for-an-organization) +* [Remove a SAML SSO authorization for an organization](/v3/orgs/#remove-a-saml-sso-authorization-for-an-organization) {% endif %} {% if currentVersion == "free-pro-team@latest" %} -##### Scim das organizações - -* [Listar identidades provisionadas de SCIM](/v3/scim/#list-scim-provisioned-identities) -* [Provisionamento e convite para um usuário de SCIM](/v3/scim/#provision-and-invite-a-scim-user) -* [Obter informações de provisionamento de SCIM para um usuário](/v3/scim/#get-scim-provisioning-information-for-a-user) -* [Definir informações de SCIM para um usuário provisionado](/v3/scim/#set-scim-information-for-a-provisioned-user) -* [Atualizar um atributo para um usuário de SCIM](/v3/scim/#update-an-attribute-for-a-scim-user) -* [Excluir um usuário de SCIM de uma organização](/v3/scim/#delete-a-scim-user-from-an-organization) +##### Organizations Scim + +* [List SCIM provisioned identities](/v3/scim/#list-scim-provisioned-identities) +* [Provision and invite a SCIM user](/v3/scim/#provision-and-invite-a-scim-user) +* [Get SCIM provisioning information for a user](/v3/scim/#get-scim-provisioning-information-for-a-user) +* [Set SCIM information for a provisioned user](/v3/scim/#set-scim-information-for-a-provisioned-user) +* [Update an attribute for a SCIM user](/v3/scim/#update-an-attribute-for-a-scim-user) +* [Delete a SCIM user from an organization](/v3/scim/#delete-a-scim-user-from-an-organization) {% endif %} {% if currentVersion == "free-pro-team@latest" %} -##### Importação de fonte - -* [Obter um status de importação](/v3/migrations/source_imports/#get-an-import-status) -* [Iniciar importação](/v3/migrations/source_imports/#start-an-import) -* [Atualizar uma importação](/v3/migrations/source_imports/#update-an-import) -* [Cancelar uma importação](/v3/migrations/source_imports/#cancel-an-import) -* [Obtenha autores do commit](/v3/migrations/source_imports/#get-commit-authors) -* [Mapear um autor de commit](/v3/migrations/source_imports/#map-a-commit-author) -* [Obter arquivos grandes](/v3/migrations/source_imports/#get-large-files) -* [Atualizar preferência de LFS do Git](/v3/migrations/source_imports/#update-git-lfs-preference) +##### Source Imports + +* [Get an import status](/v3/migrations/source_imports/#get-an-import-status) +* [Start an import](/v3/migrations/source_imports/#start-an-import) +* [Update an import](/v3/migrations/source_imports/#update-an-import) +* [Cancel an import](/v3/migrations/source_imports/#cancel-an-import) +* [Get commit authors](/v3/migrations/source_imports/#get-commit-authors) +* [Map a commit author](/v3/migrations/source_imports/#map-a-commit-author) +* [Get large files](/v3/migrations/source_imports/#get-large-files) +* [Update Git LFS preference](/v3/migrations/source_imports/#update-git-lfs-preference) {% endif %} -##### Colaboradores do projeto - -* [Listar colaboradores do projeto](/v3/projects/collaborators/#list-project-collaborators) -* [Adicionar colaborador do projeto](/v3/projects/collaborators/#add-project-collaborator) -* [Remover colaborador do projeto](/v3/projects/collaborators/#remove-project-collaborator) -* [Obter permissão de projeto para um usuário](/v3/projects/collaborators/#get-project-permission-for-a-user) - -##### Projetos - -* [Listar projetos da organização](/v3/projects/#list-organization-projects) -* [Criar um projeto da organização](/v3/projects/#create-an-organization-project) -* [Obter um projeto](/v3/projects/#get-a-project) -* [Atualizar um projeto](/v3/projects/#update-a-project) -* [Excluir um projeto](/v3/projects/#delete-a-project) -* [Listar colunas do projeto](/v3/projects/columns/#list-project-columns) -* [Criar uma coluna do projeto](/v3/projects/columns/#create-a-project-column) -* [Obter uma coluna do projeto](/v3/projects/columns/#get-a-project-column) -* [Atualizar uma coluna do projeto](/v3/projects/columns/#update-a-project-column) -* [Excluir uma coluna do projeto](/v3/projects/columns/#delete-a-project-column) -* [Listar cartões do projeto](/v3/projects/cards/#list-project-cards) -* [Criar um cartão de projeto](/v3/projects/cards/#create-a-project-card) -* [Mover uma coluna do projeto](/v3/projects/columns/#move-a-project-column) -* [Obter um cartão do projeto](/v3/projects/cards/#get-a-project-card) -* [Atualizar um cartão do projeto](/v3/projects/cards/#update-a-project-card) -* [Excluir um cartão do projeto](/v3/projects/cards/#delete-a-project-card) -* [Mover um cartão do projeto](/v3/projects/cards/#move-a-project-card) -* [Listar projetos do repositório](/v3/projects/#list-repository-projects) -* [Criar um projeto do repositório](/v3/projects/#create-a-repository-project) - -##### Commentários pull - -* [Listar comentários de revisão em um pull request](/v3/pulls/comments/#list-review-comments-on-a-pull-request) -* [Criar um comentário de revisão para um pull request](/v3/pulls/comments/#create-a-review-comment-for-a-pull-request) -* [Listar comentários de revisão em um repositório](/v3/pulls/comments/#list-review-comments-in-a-repository) -* [Obter um comentário de revisão para um pull request](/v3/pulls/comments/#get-a-review-comment-for-a-pull-request) -* [Atualizar um comentário de revisão para um pull request](/v3/pulls/comments/#update-a-review-comment-for-a-pull-request) -* [Excluir um comentário de revisão para um pull request](/v3/pulls/comments/#delete-a-review-comment-for-a-pull-request) - -##### Eventos de revisão de pull request - -* [Ignorar uma revisão para um pull request](/v3/pulls/reviews/#dismiss-a-review-for-a-pull-request) -* [Enviar uma revisão para um pull request](/v3/pulls/reviews/#submit-a-review-for-a-pull-request) - -##### Solicitações de revisão de pull request - -* [Listar revisores solicitados para um pull request](/v3/pulls/review_requests/#list-requested-reviewers-for-a-pull-request) -* [Solicitar revisores para um pull request](/v3/pulls/review_requests/#request-reviewers-for-a-pull-request) -* [Remover revisores solicitados de um pull request](/v3/pulls/review_requests/#remove-requested-reviewers-from-a-pull-request) - -##### Revisões de pull request - -* [Listar comentários para um pull request](/v3/pulls/reviews/#list-reviews-for-a-pull-request) -* [Criar uma revisão para um pull request](/v3/pulls/reviews/#create-a-review-for-a-pull-request) -* [Obter uma revisão para um pull request](/v3/pulls/reviews/#get-a-review-for-a-pull-request) -* [Atualizar uma revisão para um pull request](/v3/pulls/reviews/#update-a-review-for-a-pull-request) -* [Listar comentários para uma revisão de pull request](/v3/pulls/reviews/#list-comments-for-a-pull-request-review) +##### Project Collaborators + +* [List project collaborators](/v3/projects/collaborators/#list-project-collaborators) +* [Add project collaborator](/v3/projects/collaborators/#add-project-collaborator) +* [Remove project collaborator](/v3/projects/collaborators/#remove-project-collaborator) +* [Get project permission for a user](/v3/projects/collaborators/#get-project-permission-for-a-user) + +##### Projects + +* [List organization projects](/v3/projects/#list-organization-projects) +* [Create an organization project](/v3/projects/#create-an-organization-project) +* [Get a project](/v3/projects/#get-a-project) +* [Update a project](/v3/projects/#update-a-project) +* [Delete a project](/v3/projects/#delete-a-project) +* [List project columns](/v3/projects/columns/#list-project-columns) +* [Create a project column](/v3/projects/columns/#create-a-project-column) +* [Get a project column](/v3/projects/columns/#get-a-project-column) +* [Update a project column](/v3/projects/columns/#update-a-project-column) +* [Delete a project column](/v3/projects/columns/#delete-a-project-column) +* [List project cards](/v3/projects/cards/#list-project-cards) +* [Create a project card](/v3/projects/cards/#create-a-project-card) +* [Move a project column](/v3/projects/columns/#move-a-project-column) +* [Get a project card](/v3/projects/cards/#get-a-project-card) +* [Update a project card](/v3/projects/cards/#update-a-project-card) +* [Delete a project card](/v3/projects/cards/#delete-a-project-card) +* [Move a project card](/v3/projects/cards/#move-a-project-card) +* [List repository projects](/v3/projects/#list-repository-projects) +* [Create a repository project](/v3/projects/#create-a-repository-project) + +##### Pull Comments + +* [List review comments on a pull request](/v3/pulls/comments/#list-review-comments-on-a-pull-request) +* [Create a review comment for a pull request](/v3/pulls/comments/#create-a-review-comment-for-a-pull-request) +* [List review comments in a repository](/v3/pulls/comments/#list-review-comments-in-a-repository) +* [Get a review comment for a pull request](/v3/pulls/comments/#get-a-review-comment-for-a-pull-request) +* [Update a review comment for a pull request](/v3/pulls/comments/#update-a-review-comment-for-a-pull-request) +* [Delete a review comment for a pull request](/v3/pulls/comments/#delete-a-review-comment-for-a-pull-request) + +##### Pull Request Review Events + +* [Dismiss a review for a pull request](/v3/pulls/reviews/#dismiss-a-review-for-a-pull-request) +* [Submit a review for a pull request](/v3/pulls/reviews/#submit-a-review-for-a-pull-request) + +##### Pull Request Review Requests + +* [List requested reviewers for a pull request](/v3/pulls/review_requests/#list-requested-reviewers-for-a-pull-request) +* [Request reviewers for a pull request](/v3/pulls/review_requests/#request-reviewers-for-a-pull-request) +* [Remove requested reviewers from a pull request](/v3/pulls/review_requests/#remove-requested-reviewers-from-a-pull-request) + +##### Pull Request Reviews + +* [List reviews for a pull request](/v3/pulls/reviews/#list-reviews-for-a-pull-request) +* [Create a review for a pull request](/v3/pulls/reviews/#create-a-review-for-a-pull-request) +* [Get a review for a pull request](/v3/pulls/reviews/#get-a-review-for-a-pull-request) +* [Update a review for a pull request](/v3/pulls/reviews/#update-a-review-for-a-pull-request) +* [List comments for a pull request review](/v3/pulls/reviews/#list-comments-for-a-pull-request-review) ##### Pulls -* [Listar pull requests](/v3/pulls/#list-pull-requests) -* [Criar um pull request](/v3/pulls/#create-a-pull-request) -* [Obter um pull request](/v3/pulls/#get-a-pull-request) -* [Atualizar um pull request](/v3/pulls/#update-a-pull-request) -* [Listar commits em um pull request](/v3/pulls/#list-commits-on-a-pull-request) -* [Listar arquivos de pull requests](/v3/pulls/#list-pull-requests-files) -* [Verifiarse um pull request foi mesclado](/v3/pulls/#check-if-a-pull-request-has-been-merged) -* [Mesclar um pull request (Botão de mesclar)](/v3/pulls/#merge-a-pull-request) - -##### Reações - -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}* [Excluir uma reação](/v3/reactions/#delete-a-reaction-legacy){% else %}* [Excluir uma reação](/v3/reactions/#delete-a-reaction){% endif %} -* [Listar reações para um comentário de commit](/v3/reactions/#list-reactions-for-a-commit-comment) -* [Criar reação para um comentário de commit](/v3/reactions/#create-reaction-for-a-commit-comment) -* [Listar reações para um problema](/v3/reactions/#list-reactions-for-an-issue) -* [Criar reação para um problema](/v3/reactions/#create-reaction-for-an-issue) -* [Listar reações para um comentário do problema](/v3/reactions/#list-reactions-for-an-issue-comment) -* [Criar reação para um comentário do problema](/v3/reactions/#create-reaction-for-an-issue-comment) -* [Listar reações para um comentário de revisão de pull request](/v3/reactions/#list-reactions-for-a-pull-request-review-comment) -* [Criar reação para um comentário de revisão de pull request](/v3/reactions/#create-reaction-for-a-pull-request-review-comment) -* [Listar reações para um comentário de discussão de equipe](/v3/reactions/#list-reactions-for-a-team-discussion-comment) -* [Criar reação para um comentário de discussão em equipe](/v3/reactions/#create-reaction-for-a-team-discussion-comment) -* [Listar reações para uma discussão de equipe](/v3/reactions/#list-reactions-for-a-team-discussion) -* [Criar reação para uma discussão de equipe](/v3/reactions/#create-reaction-for-a-team-discussion){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -* [Excluir uma reação de comentário de commit](/v3/reactions/#delete-a-commit-comment-reaction) -* [Excluir uma reação do problema](/v3/reactions/#delete-an-issue-reaction) -* [Excluir uma reação a um comentário do commit](/v3/reactions/#delete-an-issue-comment-reaction) -* [Excluir reação de comentário do pull request](/v3/reactions/#delete-a-pull-request-comment-reaction) -* [Excluir reação para discussão em equipe](/v3/reactions/#delete-team-discussion-reaction) -* [Excluir reação de comentário para discussão de equipe](/v3/reactions/#delete-team-discussion-comment-reaction){% endif %} - -##### Repositórios - -* [Listar repositórios da organização](/v3/repos/#list-organization-repositories) -* [Criar um repositório para o usuário autenticado](/v3/repos/#create-a-repository-for-the-authenticated-user) -* [Obter um repositório](/v3/repos/#get-a-repository) -* [Atualizar um repositório](/v3/repos/#update-a-repository) -* [Excluir um repositório](/v3/repos/#delete-a-repository) -* [Comparar dois commits](/v3/repos/commits/#compare-two-commits) -* [Listar contribuidores do repositório](/v3/repos/#list-repository-contributors) -* [Listar bifurcações](/v3/repos/forks/#list-forks) -* [Criar uma bifurcação](/v3/repos/forks/#create-a-fork) -* [Listar idiomas do repositório](/v3/repos/#list-repository-languages) -* [Listar tags do repositório](/v3/repos/#list-repository-tags) -* [Listar equipes do repositório](/v3/repos/#list-repository-teams) -* [Transferir um repositório](/v3/repos/#transfer-a-repository) -* [Listar repositórios públicos](/v3/repos/#list-public-repositories) -* [Listar repositórios para o usuário autenticado](/v3/repos/#list-repositories-for-the-authenticated-user) -* [Listar repositórios para um usuário](/v3/repos/#list-repositories-for-a-user) -* [Criar repositório usando um modelo de repositório](/v3/repos/#create-repository-using-a-repository-template) - -##### Atividade do repositório - -* [Listar observadores](/v3/activity/starring/#list-stargazers) -* [Listar inspetores](/v3/activity/watching/#list-watchers) -* [Listar repositórios favoritados pelo usuário](/v3/activity/starring/#list-repositories-starred-by-a-user) -* [Verificar se um repositório foi favoritado pelo usuário autenticado](/v3/activity/starring/#check-if-a-repository-is-starred-by-the-authenticated-user) -* [Favorite um repositório para o usuário autenticado](/v3/activity/starring/#star-a-repository-for-the-authenticated-user) -* [Desmarque um repositório como favorito para o usuário autenticado](/v3/activity/starring/#unstar-a-repository-for-the-authenticated-user) -* [Listar repositórios inspecionados por um usuário](/v3/activity/watching/#list-repositories-watched-by-a-user) +* [List pull requests](/v3/pulls/#list-pull-requests) +* [Create a pull request](/v3/pulls/#create-a-pull-request) +* [Get a pull request](/v3/pulls/#get-a-pull-request) +* [Update a pull request](/v3/pulls/#update-a-pull-request) +* [List commits on a pull request](/v3/pulls/#list-commits-on-a-pull-request) +* [List pull requests files](/v3/pulls/#list-pull-requests-files) +* [Check if a pull request has been merged](/v3/pulls/#check-if-a-pull-request-has-been-merged) +* [Merge a pull request (Merge Button)](/v3/pulls/#merge-a-pull-request) + +##### Reactions + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}* [Delete a reaction](/v3/reactions/#delete-a-reaction-legacy){% else %}* [Delete a reaction](/v3/reactions/#delete-a-reaction){% endif %} +* [List reactions for a commit comment](/v3/reactions/#list-reactions-for-a-commit-comment) +* [Create reaction for a commit comment](/v3/reactions/#create-reaction-for-a-commit-comment) +* [List reactions for an issue](/v3/reactions/#list-reactions-for-an-issue) +* [Create reaction for an issue](/v3/reactions/#create-reaction-for-an-issue) +* [List reactions for an issue comment](/v3/reactions/#list-reactions-for-an-issue-comment) +* [Create reaction for an issue comment](/v3/reactions/#create-reaction-for-an-issue-comment) +* [List reactions for a pull request review comment](/v3/reactions/#list-reactions-for-a-pull-request-review-comment) +* [Create reaction for a pull request review comment](/v3/reactions/#create-reaction-for-a-pull-request-review-comment) +* [List reactions for a team discussion comment](/v3/reactions/#list-reactions-for-a-team-discussion-comment) +* [Create reaction for a team discussion comment](/v3/reactions/#create-reaction-for-a-team-discussion-comment) +* [List reactions for a team discussion](/v3/reactions/#list-reactions-for-a-team-discussion) +* [Create reaction for a team discussion](/v3/reactions/#create-reaction-for-a-team-discussion){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +* [Delete a commit comment reaction](/v3/reactions/#delete-a-commit-comment-reaction) +* [Delete an issue reaction](/v3/reactions/#delete-an-issue-reaction) +* [Delete a reaction to a commit comment](/v3/reactions/#delete-an-issue-comment-reaction) +* [Delete a pull request comment reaction](/v3/reactions/#delete-a-pull-request-comment-reaction) +* [Delete team discussion reaction](/v3/reactions/#delete-team-discussion-reaction) +* [Delete team discussion comment reaction](/v3/reactions/#delete-team-discussion-comment-reaction){% endif %} + +##### Repositories + +* [List organization repositories](/v3/repos/#list-organization-repositories) +* [Create a repository for the authenticated user](/v3/repos/#create-a-repository-for-the-authenticated-user) +* [Get a repository](/v3/repos/#get-a-repository) +* [Update a repository](/v3/repos/#update-a-repository) +* [Delete a repository](/v3/repos/#delete-a-repository) +* [Compare two commits](/v3/repos/commits/#compare-two-commits) +* [List repository contributors](/v3/repos/#list-repository-contributors) +* [List forks](/rest/reference/repos#list-forks) +* [Create a fork](/v3/repos/forks/#create-a-fork) +* [List repository languages](/v3/repos/#list-repository-languages) +* [List repository tags](/v3/repos/#list-repository-tags) +* [List repository teams](/v3/repos/#list-repository-teams) +* [Transfer a repository](/v3/repos/#transfer-a-repository) +* [List public repositories](/v3/repos/#list-public-repositories) +* [List repositories for the authenticated user](/v3/repos/#list-repositories-for-the-authenticated-user) +* [List repositories for a user](/v3/repos/#list-repositories-for-a-user) +* [Create repository using a repository template](/v3/repos/#create-repository-using-a-repository-template) + +##### Repository Activity + +* [List stargazers](/rest/reference/activity#list-stargazers) +* [List watchers](/rest/reference/activity#list-watchers) +* [List repositories starred by a user](/rest/reference/activity#list-repositories-starred-by-a-user) +* [Check if a repository is starred by the authenticated user](/rest/reference/activity#check-if-a-repository-is-starred-by-the-authenticated-user) +* [Star a repository for the authenticated user](/rest/reference/activity#star-a-repository-for-the-authenticated-user) +* [Unstar a repository for the authenticated user](/rest/reference/activity#unstar-a-repository-for-the-authenticated-user) +* [List repositories watched by a user](/rest/reference/activity#list-repositories-watched-by-a-user) {% if currentVersion == "free-pro-team@latest" %} -##### Correções de segurança automatizadas no repositório +##### Repository Automated Security Fixes -* [Habilitar as correções de segurança automatizadas](/v3/repos/#enable-automated-security-fixes) -* [Desabilitar as correções de segurança automatizadas](/v3/repos/#disable-automated-security-fixes) +* [Enable automated security fixes](/v3/repos/#enable-automated-security-fixes) +* [Disable automated security fixes](/v3/repos/#disable-automated-security-fixes) {% endif %} -##### Branches do repositório - -* [Listar branches](/v3/repos/branches/#list-branches) -* [Obter um branch](/v3/repos/branches/#get-a-branch) -* [Obter proteção do branch](/v3/repos/branches/#get-branch-protection) -* [Atualizar proteção do branch](/v3/repos/branches/#update-branch-protection) -* [Excluir proteção do branch](/v3/repos/branches/#delete-branch-protection) -* [Obter proteção do branch do administrador](/v3/repos/branches/#get-admin-branch-protection) -* [Definir proteção do branch de administrador](/v3/repos/branches/#set-admin-branch-protection) -* [Excluir proteção do branch de administrador](/v3/repos/branches/#delete-admin-branch-protection) -* [Obter proteção de revisão do pull request](/v3/repos/branches/#get-pull-request-review-protection) -* [Atualizar proteção de revisão do pull request](/v3/repos/branches/#update-pull-request-review-protection) -* [Excluir proteção de revisão do pull request](/v3/repos/branches/#delete-pull-request-review-protection) -* [Obter proteção de assinatura do commit](/v3/repos/branches/#get-commit-signature-protection) -* [Criar proteção de assinatura do commit](/v3/repos/branches/#create-commit-signature-protection) -* [Excluir proteção de assinatura do commit](/v3/repos/branches/#delete-commit-signature-protection) -* [Obter proteção contra verificações de status](/v3/repos/branches/#get-status-checks-protection) -* [Atualizar proteção da verificação de status](/v3/repos/branches/#update-status-check-potection) -* [Remover proteção da verificação de status](/v3/repos/branches/#remove-status-check-protection) -* [Obter todos os contextos de verificação de status](/v3/repos/branches/#get-all-status-check-contexts) -* [Adicionar contextos de verificação de status](/v3/repos/branches/#add-status-check-contexts) -* [Definir contextos de verificação de status](/v3/repos/branches/#set-status-check-contexts) -* [Remover contextos de verificação de status](/v3/repos/branches/#remove-status-check-contexts) -* [Obter restrições de acesso](/v3/repos/branches/#get-access-restrictions) -* [Excluir restrições de acesso](/v3/repos/branches/#delete-access-restrictions) -* [Listar equipes com acesso ao branch protegido](/v3/repos/branches/#list-teams-with-access-to-the-protected-branch) -* [Adicionar restrições de acesso da equipe](/v3/repos/branches/#add-team-access-restrictions) -* [Definir restrições de acesso da equipe](/v3/repos/branches/#set-team-access-restrictions) -* [Remover restrição de acesso da equipe](/v3/repos/branches/#remove-team-access-restrictions) -* [Listar restrições de usuário do branch protegido](/v3/repos/branches/#list-users-with-access-to-the-protected-branch) -* [Adicionar restrições de acesso do usuário](/v3/repos/branches/#add-user-access-restrictions) -* [Definir restrições de acesso do usuário](/v3/repos/branches/#set-user-access-restrictions) -* [Remover restrições de acesso do usuário](/v3/repos/branches/#remove-user-access-restrictions) -* [Mesclar um branch](/v3/repos/merging/#merge-a-branch) - -##### Colaboradores do repositório - -* [Listar colaboradores do repositório](/v3/repos/collaborators/#list-repository-collaborators) -* [Verifique se um usuário é colaborador de um repositório](/v3/repos/collaborators/#check-if-a-user-is-a-repository-collaborator) -* [Adicionar colaborador de repositório](/v3/repos/collaborators/#add-a-repository-collaborator) -* [Remover um colaborador de repositório](/v3/repos/collaborators/#remove-a-repository-collaborator) -* [Obter permissões de repositório para um usuário](/v3/repos/collaborators/#get-repository-permissions-for-a-user) - -##### Comentários do commit do repositório - -* [Listar comentários de commit para um repositório](/v3/repos/comments/#list-commit-comments-for-a-repository) -* [Obter um comentário de commit](/v3/repos/comments/#get-a-commit-comment) -* [Atualizar um comentário de commit](/v3/repos/comments/#update-a-commit-comment) -* [Excluir um comentário de commit](/v3/repos/comments/#delete-a-commit-comment) -* [Listar comentários de commit](/v3/repos/comments/#list-commit-comments) -* [Criar um comentário de commit](/v3/repos/comments/#create-a-commit-comment) - -##### Commits do repositório - -* [Listar commits](/v3/repos/commits/#list-commits) -* [Obter um commit](/v3/repos/commits/#get-a-commit) -* [Listar branches para o commit principal](/v3/repos/commits/#list-branches-for-head-commit) -* [Listar pull requests associados ao commit](/v3/repos/commits/#list-pull-requests-associated-with-commit) - -##### Comunidade do repositório - -* [Obter o código de conduta para um repositório](/v3/codes_of_conduct/#get-the-code-of-conduct-for-a-repository) +##### Repository Branches + +* [List branches](/v3/repos/branches/#list-branches) +* [Get a branch](/v3/repos/branches/#get-a-branch) +* [Get branch protection](/v3/repos/branches/#get-branch-protection) +* [Update branch protection](/v3/repos/branches/#update-branch-protection) +* [Delete branch protection](/v3/repos/branches/#delete-branch-protection) +* [Get admin branch protection](/v3/repos/branches/#get-admin-branch-protection) +* [Set admin branch protection](/v3/repos/branches/#set-admin-branch-protection) +* [Delete admin branch protection](/v3/repos/branches/#delete-admin-branch-protection) +* [Get pull request review protection](/v3/repos/branches/#get-pull-request-review-protection) +* [Update pull request review protection](/v3/repos/branches/#update-pull-request-review-protection) +* [Delete pull request review protection](/v3/repos/branches/#delete-pull-request-review-protection) +* [Get commit signature protection](/v3/repos/branches/#get-commit-signature-protection) +* [Create commit signature protection](/v3/repos/branches/#create-commit-signature-protection) +* [Delete commit signature protection](/v3/repos/branches/#delete-commit-signature-protection) +* [Get status checks protection](/v3/repos/branches/#get-status-checks-protection) +* [Update status check potection](/v3/repos/branches/#update-status-check-potection) +* [Remove status check protection](/v3/repos/branches/#remove-status-check-protection) +* [Get all status check contexts](/v3/repos/branches/#get-all-status-check-contexts) +* [Add status check contexts](/v3/repos/branches/#add-status-check-contexts) +* [Set status check contexts](/v3/repos/branches/#set-status-check-contexts) +* [Remove status check contexts](/v3/repos/branches/#remove-status-check-contexts) +* [Get access restrictions](/v3/repos/branches/#get-access-restrictions) +* [Delete access restrictions](/v3/repos/branches/#delete-access-restrictions) +* [List teams with access to the protected branch](/v3/repos/branches/#list-teams-with-access-to-the-protected-branch) +* [Add team access restrictions](/v3/repos/branches/#add-team-access-restrictions) +* [Set team access restrictions](/v3/repos/branches/#set-team-access-restrictions) +* [Remove team access restriction](/v3/repos/branches/#remove-team-access-restrictions) +* [List user restrictions of protected branch](/v3/repos/branches/#list-users-with-access-to-the-protected-branch) +* [Add user access restrictions](/v3/repos/branches/#add-user-access-restrictions) +* [Set user access restrictions](/v3/repos/branches/#set-user-access-restrictions) +* [Remove user access restrictions](/v3/repos/branches/#remove-user-access-restrictions) +* [Merge a branch](/v3/repos/merging/#merge-a-branch) + +##### Repository Collaborators + +* [List repository collaborators](/v3/repos/collaborators/#list-repository-collaborators) +* [Check if a user is a repository collaborator](/v3/repos/collaborators/#check-if-a-user-is-a-repository-collaborator) +* [Add a repository collaborator](/v3/repos/collaborators/#add-a-repository-collaborator) +* [Remove a repository collaborator](/v3/repos/collaborators/#remove-a-repository-collaborator) +* [Get repository permissions for a user](/v3/repos/collaborators/#get-repository-permissions-for-a-user) + +##### Repository Commit Comments + +* [List commit comments for a repository](/v3/repos/comments/#list-commit-comments-for-a-repository) +* [Get a commit comment](/v3/repos/comments/#get-a-commit-comment) +* [Update a commit comment](/v3/repos/comments/#update-a-commit-comment) +* [Delete a commit comment](/v3/repos/comments/#delete-a-commit-comment) +* [List commit comments](/v3/repos/comments/#list-commit-comments) +* [Create a commit comment](/v3/repos/comments/#create-a-commit-comment) + +##### Repository Commits + +* [List commits](/v3/repos/commits/#list-commits) +* [Get a commit](/v3/repos/commits/#get-a-commit) +* [List branches for head commit](/v3/repos/commits/#list-branches-for-head-commit) +* [List pull requests associated with commit](/v3/repos/commits/#list-pull-requests-associated-with-commit) + +##### Repository Community + +* [Get the code of conduct for a repository](/v3/codes_of_conduct/#get-the-code-of-conduct-for-a-repository) {% if currentVersion == "free-pro-team@latest" %} -* [Obter métricas do perfil da comunidade](/v3/repos/community/#get-community-profile-metrics) +* [Get community profile metrics](/v3/repos/community/#get-community-profile-metrics) {% endif %} -##### Conteúdo do repositório +##### Repository Contents -* [Fazer o download de um arquivo do repositório](/v3/repos/contents/#download-a-repository-archive) -* [Obter conteúdo de repositório](/v3/repos/contents/#get-repository-content) -* [Criar ou atualizar conteúdo do arquivo](/v3/repos/contents/#create-or-update-file-contents) -* [Excluir um arquivo](/v3/repos/contents/#delete-a-file) -* [Obter um LEIAME do repositório](/v3/repos/contents/#get-a-repository-readme) -* [Obter a licença para um repositório](/v3/licenses/#get-the-license-for-a-repository) +* [Download a repository archive](/v3/repos/contents/#download-a-repository-archive) +* [Get repository content](/v3/repos/contents/#get-repository-content) +* [Create or update file contents](/v3/repos/contents/#create-or-update-file-contents) +* [Delete a file](/v3/repos/contents/#delete-a-file) +* [Get a repository README](/v3/repos/contents/#get-a-repository-readme) +* [Get the license for a repository](/v3/licenses/#get-the-license-for-a-repository) {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -##### Envio de eventos do repositório +##### Repository Event Dispatches -* [Criar um evento de envio de repositório](/v3/repos/#create-a-repository-dispatch-event) +* [Create a repository dispatch event](/v3/repos/#create-a-repository-dispatch-event) {% endif %} -##### Hooks do repositório +##### Repository Hooks -* [Listar webhooks de repositório](/v3/repos/hooks/#list-repository-webhooks) -* [Criar um webhook do repositório](/v3/repos/hooks/#create-a-repository-webhook) -* [Obter um webhook do repositório](/v3/repos/hooks/#get-a-repository-webhook) -* [Atualizar um webhook do repositório](/v3/repos/hooks/#update-a-repository-webhook) -* [Excluir um webhook do repositório](/v3/repos/hooks/#delete-a-repository-webhook) -* [Fazer ping no webhook de um repositório](/v3/repos/hooks/#ping-a-repository-webhook) -* [Testar o webhook do repositório de push](/v3/repos/hooks/#test-the-push-repository-webhook) +* [List repository webhooks](/v3/repos/hooks/#list-repository-webhooks) +* [Create a repository webhook](/v3/repos/hooks/#create-a-repository-webhook) +* [Get a repository webhook](/v3/repos/hooks/#get-a-repository-webhook) +* [Update a repository webhook](/v3/repos/hooks/#update-a-repository-webhook) +* [Delete a repository webhook](/v3/repos/hooks/#delete-a-repository-webhook) +* [Ping a repository webhook](/v3/repos/hooks/#ping-a-repository-webhook) +* [Test the push repository webhook](/v3/repos/hooks/#test-the-push-repository-webhook) -##### Convites do repositório +##### Repository Invitations -* [Listar convites para repositórios](/v3/repos/invitations/#list-repository-invitations) -* [Atualizar um convite para um repositório](/v3/repos/invitations/#update-a-repository-invitation) -* [Excluir um convite para um repositório](/v3/repos/invitations/#delete-a-repository-invitation) -* [Listar convites de repositório para o usuário autenticado](/v3/repos/invitations/#list-repository-invitations-for-the-authenticated-user) -* [Aceitar um convite de repositório](/v3/repos/invitations/#accept-a-repository-invitation) -* [Recusar um convite de repositório](/v3/repos/invitations/#decline-a-repository-invitation) +* [List repository invitations](/v3/repos/invitations/#list-repository-invitations) +* [Update a repository invitation](/v3/repos/invitations/#update-a-repository-invitation) +* [Delete a repository invitation](/v3/repos/invitations/#delete-a-repository-invitation) +* [List repository invitations for the authenticated user](/v3/repos/invitations/#list-repository-invitations-for-the-authenticated-user) +* [Accept a repository invitation](/v3/repos/invitations/#accept-a-repository-invitation) +* [Decline a repository invitation](/v3/repos/invitations/#decline-a-repository-invitation) -##### Chaves de repositório +##### Repository Keys -* [Listar chaves de implantação](/v3/repos/keys/#list-deploy-keys) -* [Criar uma chave de implantação](/v3/repos/keys/#create-a-deploy-key) -* [Obter uma chave de implantação](/v3/repos/keys/#get-a-deploy-key) -* [Excluir uma chave de implantação](/v3/repos/keys/#delete-a-deploy-key) +* [List deploy keys](/v3/repos/keys/#list-deploy-keys) +* [Create a deploy key](/v3/repos/keys/#create-a-deploy-key) +* [Get a deploy key](/v3/repos/keys/#get-a-deploy-key) +* [Delete a deploy key](/v3/repos/keys/#delete-a-deploy-key) -##### Páginas do repositório +##### Repository Pages -* [Obter um site do GitHub Pages](/v3/repos/pages/#get-a-github-pages-site) -* [Criar um site do GitHub Pages](/v3/repos/pages/#create-a-github-pages-site) -* [Atualizar informações sobre um site do GitHub Pages](/v3/repos/pages/#update-information-about-a-github-pages-site) -* [Excluir um site do GitHub Pages](/v3/repos/pages/#delete-a-github-pages-site) -* [Listar criações do GitHub Pages](/v3/repos/pages/#list-github-pages-builds) -* [Solicitar uma criação do GitHub Pages](/v3/repos/pages/#request-a-github-pages-build) -* [Obter uma criação do GitHub Pages](/v3/repos/pages/#get-github-pages-build) -* [Obter a última criação de páginas](/v3/repos/pages/#get-latest-pages-build) +* [Get a GitHub Pages site](/rest/reference/repos#get-a-github-pages-site) +* [Create a GitHub Pages site](/rest/reference/repos#create-a-github-pages-site) +* [Update information about a GitHub Pages site](/rest/reference/repos#update-information-about-a-github-pages-site) +* [Delete a GitHub Pages site](/rest/reference/repos#delete-a-github-pages-site) +* [List GitHub Pages builds](/rest/reference/repos#list-github-pages-builds) +* [Request a GitHub Pages build](/rest/reference/repos#request-a-github-pages-build) +* [Get GitHub Pages build](/rest/reference/repos#get-github-pages-build) +* [Get latest pages build](/rest/reference/repos#get-latest-pages-build) {% if currentVersion != "free-pro-team@latest" %} -##### Hooks pre-receive do repositório +##### Repository Pre Receive Hooks -* [Listar hooks pre-receive para um repositório](/enterprise/user/rest/reference/enterprise-admin#list-pre-receive-hooks-for-a-repository) -* [Obter um hook pre-receive para um repositório](/enterprise/user/rest/reference/enterprise-admin#get-a-pre-receive-hook-for-a-repository) -* [Atualizar a aplicação de um hook pre-receive para um repositório](/enterprise/user/rest/reference/enterprise-admin#update-pre-receive-hook-enforcement-for-a-repository) -* [Remover a aplicação de um hook pre-receive para um repositório](/enterprise/user/rest/reference/enterprise-admin#remove-pre-receive-hook-enforcement-for-a-repository) +* [List pre-receive hooks for a repository](/enterprise/user/rest/reference/enterprise-admin#list-pre-receive-hooks-for-a-repository) +* [Get a pre-receive hook for a repository](/enterprise/user/rest/reference/enterprise-admin#get-a-pre-receive-hook-for-a-repository) +* [Update pre-receive hook enforcement for a repository](/enterprise/user/rest/reference/enterprise-admin#update-pre-receive-hook-enforcement-for-a-repository) +* [Remove pre-receive hook enforcement for a repository](/enterprise/user/rest/reference/enterprise-admin#remove-pre-receive-hook-enforcement-for-a-repository) {% endif %} -##### Versões do repositório +##### Repository Releases -* [Listar versões](/v3/repos/releases/#list-releases) -* [Criar uma versão](/v3/repos/releases/#create-a-release) -* [Obter uma versão](/v3/repos/releases/#get-a-release) -* [Atualizar uma versão](/v3/repos/releases/#update-a-release) -* [Excluir uma versão](/v3/repos/releases/#delete-a-release) -* [Listar ativos da versão](/v3/repos/releases/#list-release-assets) -* [Obter um ativo da versão](/v3/repos/releases/#get-a-release-asset) -* [Atualizar um ativo da versão](/v3/repos/releases/#update-a-release-asset) -* [Excluir um ativo da versão](/v3/repos/releases/#delete-a-release-asset) -* [Obter a atualização mais recente](/v3/repos/releases/#get-the-latest-release) -* [Obter uma versão pelo nome da tag](/v3/repos/releases/#get-a-release-by-tag-name) +* [List releases](/rest/reference/repos/#list-releases) +* [Create a release](/rest/reference/repos/#create-a-release) +* [Get a release](/rest/reference/repos/#get-a-release) +* [Update a release](/rest/reference/repos/#update-a-release) +* [Delete a release](/rest/reference/repos/#delete-a-release) +* [List release assets](/rest/reference/repos/#list-release-assets) +* [Get a release asset](/rest/reference/repos/#get-a-release-asset) +* [Update a release asset](/rest/reference/repos/#update-a-release-asset) +* [Delete a release asset](/rest/reference/repos/#delete-a-release-asset) +* [Get the latest release](/rest/reference/repos/#get-the-latest-release) +* [Get a release by tag name](/rest/reference/repos/#get-a-release-by-tag-name) -##### Estatísticas do repositório +##### Repository Stats -* [Obter a atividade semanal do commit](/v3/repos/statistics/#get-the-weekly-commit-activity) -* [Obter o último ano da atividade de commit](/v3/repos/statistics/#get-the-last-year-of-commit-activity) -* [Obter toda a atividade do commit do contribuidor](/v3/repos/statistics/#get-all-contributor-commit-activity) -* [Obter a contagem semanal do commit](/v3/repos/statistics/#get-the-weekly-commit-count) -* [Obter a contagem do commit por hora para cada dia](/v3/repos/statistics/#get-the-hourly-commit-count-for-each-day) +* [Get the weekly commit activity](/v3/repos/statistics/#get-the-weekly-commit-activity) +* [Get the last year of commit activity](/v3/repos/statistics/#get-the-last-year-of-commit-activity) +* [Get all contributor commit activity](/v3/repos/statistics/#get-all-contributor-commit-activity) +* [Get the weekly commit count](/v3/repos/statistics/#get-the-weekly-commit-count) +* [Get the hourly commit count for each day](/v3/repos/statistics/#get-the-hourly-commit-count-for-each-day) {% if currentVersion == "free-pro-team@latest" %} -##### Alertas de vulnerabilidade de repositório +##### Repository Vulnerability Alerts -* [Habilitar alertas de vulnerabilidade](/v3/repos/#enable-vulnerability-alerts) -* [Desabilitar alertas de vulnerabilidade](/v3/repos/#disable-vulnerability-alerts) +* [Enable vulnerability alerts](/v3/repos/#enable-vulnerability-alerts) +* [Disable vulnerability alerts](/v3/repos/#disable-vulnerability-alerts) {% endif %} -##### Raiz +##### Root -* [Ponto de extremidade raiz](/v3/#root-endpoint) +* [Root endpoint](/v3/#root-endpoint) * [Emojis](/v3/emojis/#emojis) -* [Obter status do limite de taxa para o usuário autenticado](/v3/rate_limit/#get-rate-limit-status-for-the-authenticated-user) +* [Get rate limit status for the authenticated user](/v3/rate_limit/#get-rate-limit-status-for-the-authenticated-user) -##### Pesquisar +##### Search -* [Buscar código](/v3/search/#search-code) -* [Pesquisar commits](/v3/search/#search-commits) -* [Pesquisar etiquetas](/v3/search/#search-labels) -* [Pesquisar repositórios](/v3/search/#search-repositories) -* [Pesquisar tópicos](/v3/search/#search-topics) -* [Pesquisar usuários](/v3/search/#search-users) +* [Search code](/v3/search/#search-code) +* [Search commits](/v3/search/#search-commits) +* [Search labels](/v3/search/#search-labels) +* [Search repositories](/v3/search/#search-repositories) +* [Search topics](/v3/search/#search-topics) +* [Search users](/v3/search/#search-users) -##### Status +##### Statuses -* [Obter o status combinado para uma referência específica](/v3/repos/statuses/#get-the-combined-status-for-a-specific-reference) -* [Listar status de commit para uma referência](/v3/repos/statuses/#list-commit-statuses-for-a-reference) -* [Criar um status de commit](/v3/repos/statuses/#create-a-commit-status) +* [Get the combined status for a specific reference](/v3/repos/statuses/#get-the-combined-status-for-a-specific-reference) +* [List commit statuses for a reference](/v3/repos/statuses/#list-commit-statuses-for-a-reference) +* [Create a commit status](/v3/repos/statuses/#create-a-commit-status) -##### Discussões de equipe +##### Team Discussions -* [Listar discussões](/v3/teams/discussions/#list-discussions) -* [Criar discussão](/v3/teams/discussions/#create-a-discussion) -* [Obter discussão](/v3/teams/discussions/#get-a-discussion) -* [Atualizar uma discussão](/v3/teams/discussions/#update-a-discussion) -* [Excluir uma discussão](/v3/teams/discussions/#delete-a-discussion) -* [Listar comentários da discussão](/v3/teams/discussion_comments/#list-discussion-comments) -* [Criar um comentário da discussão](/v3/teams/discussion_comments/#create-a-discussion-comment) -* [Obter um comentário da discussão](/v3/teams/discussion_comments/#get-a-discussion-comment) -* [Atualizar um comentário da discussão](/v3/teams/discussion_comments/#update-a-discussion-comment) -* [Excluir um comentário da discussão](/v3/teams/discussion_comments/#delete-a-discussion-comment) +* [List discussions](/v3/teams/discussions/#list-discussions) +* [Create a discussion](/v3/teams/discussions/#create-a-discussion) +* [Get a discussion](/v3/teams/discussions/#get-a-discussion) +* [Update a discussion](/v3/teams/discussions/#update-a-discussion) +* [Delete a discussion](/v3/teams/discussions/#delete-a-discussion) +* [List discussion comments](/v3/teams/discussion_comments/#list-discussion-comments) +* [Create a discussion comment](/v3/teams/discussion_comments/#create-a-discussion-comment) +* [Get a discussion comment](/v3/teams/discussion_comments/#get-a-discussion-comment) +* [Update a discussion comment](/v3/teams/discussion_comments/#update-a-discussion-comment) +* [Delete a discussion comment](/v3/teams/discussion_comments/#delete-a-discussion-comment) -##### Tópicos +##### Topics -* [Obter todos os tópicos do repositório](/v3/repos#get-all-repository-topics) -* [Substituir todos os tópicos do repositório](/v3/repos/#replace-all-repository-topics) +* [Get all repository topics](/v3/repos#get-all-repository-topics) +* [Replace all repository topics](/v3/repos/#replace-all-repository-topics) {% if currentVersion == "free-pro-team@latest" %} -##### Tráfego +##### Traffic -* [Obter clones do repositório](/v3/repos/traffic/#get-repository-clones) -* [Obter caminhos de referência superior](/v3/repos/traffic/#get-top-referral-paths) -* [Obter fontes de referência superior](/v3/repos/traffic/#get-top-referral-sources) -* [Obter visualizações de páginas](/v3/repos/traffic/#get-page-views) +* [Get repository clones](/v3/repos/traffic/#get-repository-clones) +* [Get top referral paths](/v3/repos/traffic/#get-top-referral-paths) +* [Get top referral sources](/v3/repos/traffic/#get-top-referral-sources) +* [Get page views](/v3/repos/traffic/#get-page-views) {% endif %} {% if currentVersion == "free-pro-team@latest" %} -##### Bloquear usuário - -* [Listar usuários bloqueados pelo usuário autenticado](/v3/users/blocking/#list-users-blocked-by-the-authenticated-user) -* [Verificar se um usuário está bloqueado pelo usuário autenticado](/v3/users/blocking/#check-if-a-user-is-blocked-by-the-authenticated-user) -* [Listar usuários bloqueados por uma organização](/v3/orgs/blocking/#list-users-blocked-by-an-organization) -* [Verificar se um usuário está bloqueado por uma organização](/v3/orgs/blocking/#check-if-a-user-is-blocked-by-an-organization) -* [Bloquear um usuário de uma organização](/v3/orgs/blocking/#block-a-user-from-an-organization) -* [Desbloquear um usuário de uma organização](/v3/orgs/blocking/#unblock-a-user-from-an-organization) -* [Bloquear usuário](/v3/users/blocking/#block-a-user) -* [Desbloquear usuário](/v3/users/blocking/#unblock-a-user) +##### User Blocking + +* [List users blocked by the authenticated user](/v3/users/blocking/#list-users-blocked-by-the-authenticated-user) +* [Check if a user is blocked by the authenticated user](/v3/users/blocking/#check-if-a-user-is-blocked-by-the-authenticated-user) +* [List users blocked by an organization](/v3/orgs/blocking/#list-users-blocked-by-an-organization) +* [Check if a user is blocked by an organization](/v3/orgs/blocking/#check-if-a-user-is-blocked-by-an-organization) +* [Block a user from an organization](/v3/orgs/blocking/#block-a-user-from-an-organization) +* [Unblock a user from an organization](/v3/orgs/blocking/#unblock-a-user-from-an-organization) +* [Block a user](/v3/users/blocking/#block-a-user) +* [Unblock a user](/v3/users/blocking/#unblock-a-user) {% endif %} -##### Emails do usuário +##### User Emails {% if currentVersion == "free-pro-team@latest" %} -* [Configurar visibilidade do e-mail principal para o usuário autenticado](/v3/users/emails/#set-primary-email-visibility-for-the-authenticated-user) +* [Set primary email visibility for the authenticated user](/v3/users/emails/#set-primary-email-visibility-for-the-authenticated-user) {% endif %} -* [Listar endereços de e-mail para o usuário autenticado](/v3/users/emails/#list-email-addresses-for-the-authenticated-user) -* [Adicionar endereço(s) de e-mail](/v3/users/emails/#add-an-email-address-for-the-authenticated-user) -* [Excluir endereço(s) de e-mail](/v3/users/emails/#delete-an-email-address-for-the-authenticated-user) -* [Listar endereços de e-mail públicos para o usuário autenticado](/v3/users/emails/#list-public-email-addresses-for-the-authenticated-user) +* [List email addresses for the authenticated user](/v3/users/emails/#list-email-addresses-for-the-authenticated-user) +* [Add email address(es)](/v3/users/emails/#add-an-email-address-for-the-authenticated-user) +* [Delete email address(es)](/v3/users/emails/#delete-an-email-address-for-the-authenticated-user) +* [List public email addresses for the authenticated user](/v3/users/emails/#list-public-email-addresses-for-the-authenticated-user) -##### Seguidores do usuário +##### User Followers -* [Listar seguidores de um usuário](/v3/users/followers/#list-followers-of-a-user) -* [Listar as pessoas que um usuário segue](/v3/users/followers/#list-the-people-a-user-follows) -* [Verificar se uma pessoa é seguida pelo usuário autenticado](/v3/users/followers/#check-if-a-person-is-followed-by-the-authenticated-user) -* [Seguir um usuário](/v3/users/followers/#follow-a-user) -* [Deixar de seguir um usuário](/v3/users/followers/#unfollow-a-user) -* [Verificar se um usuário segue outro usuário](/v3/users/followers/#check-if-a-user-follows-another-user) +* [List followers of a user](/v3/users/followers/#list-followers-of-a-user) +* [List the people a user follows](/v3/users/followers/#list-the-people-a-user-follows) +* [Check if a person is followed by the authenticated user](/v3/users/followers/#check-if-a-person-is-followed-by-the-authenticated-user) +* [Follow a user](/v3/users/followers/#follow-a-user) +* [Unfollow a user](/v3/users/followers/#unfollow-a-user) +* [Check if a user follows another user](/v3/users/followers/#check-if-a-user-follows-another-user) -##### Chaves Gpg do usuário +##### User Gpg Keys -* [Listar chaves GPG para o usuário autenticado](/v3/users/gpg_keys/#list-gpg-keys-for-the-authenticated-user) -* [Criar uma chave GPG para o usuário autenticado](/v3/users/gpg_keys/#create-a-gpg-key-for-the-authenticated-user) -* [Obter uma chave GPG para o usuário autenticado](/v3/users/gpg_keys/#get-a-gpg-key-for-the-authenticated-user) -* [Excluir uma chave GPG para o usuário autenticado](/v3/users/gpg_keys/#delete-a-gpg-key-for-the-authenticated-user) -* [Listar chaves gpg para um usuário](/v3/users/gpg_keys/#list-gpg-keys-for-a-user) +* [List GPG keys for the authenticated user](/v3/users/gpg_keys/#list-gpg-keys-for-the-authenticated-user) +* [Create a GPG key for the authenticated user](/v3/users/gpg_keys/#create-a-gpg-key-for-the-authenticated-user) +* [Get a GPG key for the authenticated user](/v3/users/gpg_keys/#get-a-gpg-key-for-the-authenticated-user) +* [Delete a GPG key for the authenticated user](/v3/users/gpg_keys/#delete-a-gpg-key-for-the-authenticated-user) +* [List gpg keys for a user](/v3/users/gpg_keys/#list-gpg-keys-for-a-user) -##### Chaves públicas do usuário +##### User Public Keys -* [Listar chaves SSH públicas para o usuário autenticado](/v3/users/keys/#list-public-ssh-keys-for-the-authenticated-user) -* [Criar uma chave SSH pública para o usuário autenticado](/v3/users/keys/#create-a-public-ssh-key-for-the-authenticated-user) -* [Obter uma chave SSH pública para o usuário autenticado](/v3/users/keys/#get-a-public-ssh-key-for-the-authenticated-user) -* [Excluir uma chave SSH pública para o usuário autenticado](/v3/users/keys/#delete-a-public-ssh-key-for-the-authenticated-user) -* [Listar chaves públicas para um usuário](/v3/users/keys/#list-public-keys-for-a-user) +* [List public SSH keys for the authenticated user](/v3/users/keys/#list-public-ssh-keys-for-the-authenticated-user) +* [Create a public SSH key for the authenticated user](/v3/users/keys/#create-a-public-ssh-key-for-the-authenticated-user) +* [Get a public SSH key for the authenticated user](/v3/users/keys/#get-a-public-ssh-key-for-the-authenticated-user) +* [Delete a public SSH key for the authenticated user](/v3/users/keys/#delete-a-public-ssh-key-for-the-authenticated-user) +* [List public keys for a user](/v3/users/keys/#list-public-keys-for-a-user) -##### Usuários +##### Users -* [Obter o usuário autenticado](/v3/users/#get-the-authenticated-user) -* [Listar instalações de aplicativos acessíveis ao token de acesso do usuário](/v3/apps/installations/#list-app-installations-accessible-to-the-user-access-token) +* [Get the authenticated user](/v3/users/#get-the-authenticated-user) +* [List app installations accessible to the user access token](/v3/apps/installations/#list-app-installations-accessible-to-the-user-access-token) {% if currentVersion == "free-pro-team@latest" %} -* [Listar assinaturas para o usuário autenticado](/v3/apps/marketplace/#list-subscriptions-for-the-authenticated-user) +* [List subscriptions for the authenticated user](/v3/apps/marketplace/#list-subscriptions-for-the-authenticated-user) {% endif %} -* [Listar usuários](/v3/users/#list-users) -* [Obter um usuário](/v3/users/#get-a-user) +* [List users](/v3/users/#list-users) +* [Get a user](/v3/users/#get-a-user) {% if currentVersion == "free-pro-team@latest" %} -##### Execuções do fluxo de trabalho - -* [Listar execuções do fluxo de trabalho para um repositório](/v3/actions/workflow-runs/#list-workflow-runs-for-a-repository) -* [Obter execução de um fluxo de trabalho](/v3/actions/workflow-runs/#get-a-workflow-run) -* [Cancelar execução de um fluxo de trabalho](/v3/actions/workflow-runs/#cancel-a-workflow-run) -* [Fazer o download dos registros de execução do fluxo de trabalho](/v3/actions/workflow-runs/#download-workflow-run-logs) -* [Excluir registros de execução do fluxo de trabalho](/v3/actions/workflow-runs/#delete-workflow-run-logs) -* [Rexecutar um fluxo de trabalho](/v3/actions/workflow-runs/#re-run-a-workflow) -* [Listar execuções do fluxo de trabalho](/v3/actions/workflow-runs/#list-workflow-runs) -* [Obter uso da execução do fluxo de trabalho](/v3/actions/workflow-runs/#get-workflow-run-usage) +##### Workflow Runs + +* [List workflow runs for a repository](/v3/actions/workflow-runs/#list-workflow-runs-for-a-repository) +* [Get a workflow run](/v3/actions/workflow-runs/#get-a-workflow-run) +* [Cancel a workflow run](/v3/actions/workflow-runs/#cancel-a-workflow-run) +* [Download workflow run logs](/v3/actions/workflow-runs/#download-workflow-run-logs) +* [Delete workflow run logs](/v3/actions/workflow-runs/#delete-workflow-run-logs) +* [Re run a workflow](/v3/actions/workflow-runs/#re-run-a-workflow) +* [List workflow runs](/v3/actions/workflow-runs/#list-workflow-runs) +* [Get workflow run usage](/v3/actions/workflow-runs/#get-workflow-run-usage) {% endif %} {% if currentVersion == "free-pro-team@latest" %} -##### Fluxos de trabalho +##### Workflows -* [Listar fluxos de trabalho do repositório](/v3/actions/workflows/#list-repository-workflows) -* [Obter um fluxo de trabalho](/v3/actions/workflows/#get-a-workflow) -* [Obter uso do workflow](/v3/actions/workflows/#get-workflow-usage) +* [List repository workflows](/v3/actions/workflows/#list-repository-workflows) +* [Get a workflow](/v3/actions/workflows/#get-a-workflow) +* [Get workflow usage](/v3/actions/workflows/#get-workflow-usage) {% endif %} diff --git a/translations/pt-BR/content/developers/apps/installing-github-apps.md b/translations/pt-BR/content/developers/apps/installing-github-apps.md index 3e2e332d703b..e4bfd3a3201e 100644 --- a/translations/pt-BR/content/developers/apps/installing-github-apps.md +++ b/translations/pt-BR/content/developers/apps/installing-github-apps.md @@ -1,6 +1,6 @@ --- title: Instalar aplicativos GitHub -intro: 'Quando seu aplicativo é público, qualquer pessoa pode instalar seu aplicativo em um repositório por meio do {% if currentVersion == "free-pro-team@latest" %} o {% data variables.product.prodname_marketplace %} ou {% endif %}de uma URL de instalação. Quando seu app é privado, você só pode instalar o aplicativo em repositórios dos quais você é proprietário.' +intro: 'Quando seu aplicativo for público, qualquer pessoa pode instalar seu aplicativo nos seus repositórios através de{% if currentVersion == "free-pro-team@latest" %} {% data variables.product.prodname_marketplace %} ou {% endif %}uma URL de instalação. Quando seu app é privado, você só pode instalar o aplicativo em repositórios dos quais você é proprietário.' redirect_from: - /apps/installing-github-apps versions: diff --git a/translations/pt-BR/content/developers/apps/migrating-oauth-apps-to-github-apps.md b/translations/pt-BR/content/developers/apps/migrating-oauth-apps-to-github-apps.md index 4c945a3ac878..319cc573b288 100644 --- a/translations/pt-BR/content/developers/apps/migrating-oauth-apps-to-github-apps.md +++ b/translations/pt-BR/content/developers/apps/migrating-oauth-apps-to-github-apps.md @@ -11,7 +11,6 @@ versions: Este artigo fornece orientações para integradores existentes que estão considerando a migração de um aplicativo OAuth para um aplicativo GitHub. - ### Razões para alternar para aplicativos GitHub [Os aplicativos GitHub](/apps/) são a forma oficialmente recomendada de integrar-se ao GitHub, pois oferecem muitas vantagens em relação a uma integração pura baseada no OAuth: diff --git a/translations/pt-BR/content/developers/apps/modifying-an-oauth-app.md b/translations/pt-BR/content/developers/apps/modifying-an-oauth-app.md index 6572dc4c49a8..54ca98713f9f 100644 --- a/translations/pt-BR/content/developers/apps/modifying-an-oauth-app.md +++ b/translations/pt-BR/content/developers/apps/modifying-an-oauth-app.md @@ -9,12 +9,10 @@ versions: enterprise-server: '*' --- - - - {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.oauth_apps %} {% data reusables.user-settings.modify_oauth_app %} -5. Modifique as informações do {% data variables.product.prodname_oauth_app %} que você gostaria de alterar. +1. Modifique as +informações de {% data variables.product.prodname_oauth_app %} que você gostaria de mudar. {% data reusables.user-settings.update_oauth_app %} diff --git a/translations/pt-BR/content/developers/apps/refreshing-user-to-server-access-tokens.md b/translations/pt-BR/content/developers/apps/refreshing-user-to-server-access-tokens.md index eb1e129758a7..8302b72f9276 100644 --- a/translations/pt-BR/content/developers/apps/refreshing-user-to-server-access-tokens.md +++ b/translations/pt-BR/content/developers/apps/refreshing-user-to-server-access-tokens.md @@ -28,10 +28,10 @@ Esta solicitação de retorno de chamada enviará um novo token de acesso e um n #### Parâmetros -| Nome | Tipo | Descrição | -| --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Nome | Tipo | Descrição | +| --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `refresh_token` | `string` | **Obrigatório.** O token gerado quando o proprietário do {% data variables.product.prodname_github_app %} habilita tokens expirados e emite um novo token de acesso do usuário. | -| `grant_type` | `string` | **Obrigatório.** O valor deve ser `refresh_token` (exigido pela especificação do OAuth). | +| `grant_type` | `string` | **Obrigatório.** O valor deve ser `refresh_token` (exigido pela especificação do OAuth). | | `client_id` | `string` | **Obrigatório.** O ID do cliente para o seu {% data variables.product.prodname_github_app %}. | | `client_secret` | `string` | **Obrigatório.** O segredo do cliente para o seu {% data variables.product.prodname_github_app %}. | diff --git a/translations/pt-BR/content/developers/apps/scopes-for-oauth-apps.md b/translations/pt-BR/content/developers/apps/scopes-for-oauth-apps.md index 64d69ba79140..ff5b4dc33152 100644 --- a/translations/pt-BR/content/developers/apps/scopes-for-oauth-apps.md +++ b/translations/pt-BR/content/developers/apps/scopes-for-oauth-apps.md @@ -1,5 +1,5 @@ --- -title: Escopos para aplicativos OAuth +title: Scopes for OAuth Apps intro: '{% data reusables.shortdesc.understanding_scopes_for_oauth_apps %}' redirect_from: - /apps/building-integrations/setting-up-and-registering-oauth-apps/about-scopes-for-oauth-apps/ @@ -10,19 +10,19 @@ versions: enterprise-server: '*' --- -Ao configurar um aplicativo OAuth no GitHub, os escopos solicitados são exibidos para o usuário no formulário de autorização. +When setting up an OAuth App on GitHub, requested scopes are displayed to the user on the authorization form. {% note %} -**Observação:** Se você está criando um aplicativo no GitHub, você não precisa fornecer escopos na sua solicitação de autorização. Para obter mais informações sobre isso, consulte "[Identificar e autorizar usuários para aplicativos GitHub](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/)". +**Note:** If you're building a GitHub App, you don’t need to provide scopes in your authorization request. For more on this, see "[Identifying and authorizing users for GitHub Apps](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/)." {% endnote %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -Se seu {% data variables.product.prodname_oauth_app %} não tiver acesso a um navegador, como uma ferramenta de CLI, você não precisará especificar um escopo para que os usuários efetuem a autenticação no seu aplicativo. Para obter mais informações, consulte "[Autorizar aplicativos OAuth](/developers/apps/authorizing-oauth-apps#device-flow)". +If your {% data variables.product.prodname_oauth_app %} doesn't have access to a browser, such as a CLI tool, then you don't need to specify a scope for users to authenticate to your app. For more information, see "[Authorizing OAuth apps](/developers/apps/authorizing-oauth-apps#device-flow)." {% endif %} -Verifique os cabeçalhos para ver quais escopos do OAuth você tem e o que a ação da API aceita: +Check headers to see what OAuth scopes you have, and what the API action accepts: ```shell $ curl -H "Authorization: token OAUTH-TOKEN" {% data variables.product.api_url_pre %}/users/codertocat -I @@ -31,51 +31,52 @@ X-OAuth-Scopes: repo, user X-Accepted-OAuth-Scopes: user ``` -* `X-OAuth-Scopes` lista o escopo que seu token autorizou. -* `X-Accepted-OAuth-Scopes` lista os escopos verificados pela ação. - -### Escopos disponíveis - -| Nome | Descrição | -| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **`(sem escopo)`** | Concede acesso somente leitura a informações públicas (inclui informações do perfil do usuário público, informações do repositório público e gists){% if currentVersion != "free-pro-team@latest" %} -| **`site_admin`** | Concede acesso de administrador aos pontos de extremidades da API de administração [{% data variables.product.prodname_ghe_server %}](/v3/enterprise-admin).{% endif %} -| **`repo`** | Concede acesso total a repositórios privados e públicos. Isso inclui acesso de leitura/gravação ao código, status do commit, repositório e projetos da organização, convites, colaboradores, adição de associações de equipe, status de implantação e webhooks de repositórios para repositórios e organizações públicos e privados. Também concede capacidade para gerenciar projetos de usuário. | -|  `repo:status` | Concede acesso de leitura/gravação aos status do commit do repositório público e privado. Esse escopo só é necessário para conceder a outros usuários ou serviços acesso a status de compromisso de repositórios privados *sem* conceder acesso ao código. | -|  `repo_deployment` | Concede acesso aos [status de implantação](/v3/repos/deployments) para repositórios públicos e privados. Esse escopo só é necessário para conceder a outros usuários ou serviços acesso ao status de implantação, *sem* conceder acesso ao código. | -|  `public_repo` | Limita o acesso a repositórios públicos. Isso inclui acesso de leitura/gravação em código, status de commit, projetos de repositório, colaboradores e status de implantação de repositórios e organizações públicos. Também é necessário para repositórios públicos marcados com uma estrela. | -|  `repo:invite` | Concede habilidades de aceitar/recusar convites para colaborar em um repositório. Este escopo só é necessário para conceder a outros usuários ou serviços acesso a convites *sem* conceder acesso ao código.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21"%} -|  `security_events` | Concede acesso de leitura e escrita a eventos de segurança na [API {% data variables.product.prodname_code_scanning %}](/v3/code-scanning).{% endif %} -| **`admin:repo_hook`** | Concede acesso de leitura, gravação e ping aos hooks do repositório em repositórios públicos e privados. O escopos do `repo` e `public_repo` concede acesso total aos repositórios, incluindo hooks de repositório. Use o escopo `admin:repo_hook` para limitar o acesso apenas a hooks de repositório. | -|  `write:repo_hook` | Concede acesso de leitura, escrita e ping para os hooks em repositórios públicos ou privados. | -|  `read:repo_hook` | Concede acesso de leitura e ping para hooks em repositórios públicos ou privados. | -| **`admin:org`** | Gerencia totalmente a organização e suas equipes, projetos e associações. | -|  `write:org` | Acesso de leitura e gravação à associação da organização, aos projetos da organização e à associação da equipe. | -|  `read:org` | Acesso somente leitura à associação da organização, aos projetos da organização e à associação da equipe. | -| **`admin:public_key`** | Gerenciar totalmente as chaves públicas. | -|  `write:public_key` | Criar, listar e visualizar informações das chaves públicas. | -|  `read:public_key` | Listar e visualizar informações para as chaves públicas. | -| **`admin:org_hook`** | Concede acesso de leitura, gravação, ping e e exclusão de hooks da organização. **Observação:** Os tokens do OAuth só serão capazes de realizar essas ações nos hooks da organização que foram criados pelo aplicativo OAuth. Os tokens de acesso pessoal só poderão realizar essas ações nos hooks da organização criados por um usuário. | -| **`gist`** | Concede acesso de gravação aos gists. | -| **`notificações`** | Condece:
    * acesso de gravação a notificações de um usuário
    * acesso para marcar como leitura nos threads
    * acesso para inspecionar e não inspecionar um repositório e
    * acesso de leitura, gravação e exclusão às assinaturas dos threads. | -| **`usuário`** | Concede acesso de leitura/gravação apenas às informações do perfil. Observe que este escopo inclui `user:email` e `user:follow`. | -|  `read:user` | Concede acesso para ler as informações do perfil de um usuário. | -|  `usuário:email` | Concede acesso de leitura aos endereços de e-mail de um usuário. | -|  `user:follow` | Concede acesso para seguir ou deixar de seguir outros usuários. | -| **`delete_repo`** | Concede acesso para excluir repositórios administráveis. | -| **`write:discussion`** | Permite acesso de leitura e gravação para discussões da equipe. | -|  `leia:discussion` | Permite acesso de leitura para discussões da equipe.{% if currentVersion == "free-pro-team@latest" %} -| **`write:packages`** | Concede acesso ao para fazer o upload ou publicação de um pacote no {% data variables.product.prodname_registry %}. Para obter mais informações, consulte "[Publicar um pacote](/github/managing-packages-with-github-packages/publishing-a-package)". | -| **`read:packages`** | Concede acesso ao download ou instalação de pacotes do {% data variables.product.prodname_registry %}. Para obter mais informações, consulte "[Instalando um pacote](/github/managing-packages-with-github-packages/installing-a-package)". | -| **`delete:packages`** | Concede acesso para excluir pacotes de {% data variables.product.prodname_registry %}. Para obter mais informações, consulte "[Excluir pacotes](/github/managing-packages-with-github-packages/deleting-a-package)".{% endif %} -| **`admin:gpg_key`** | Gerenciar totalmente as chaves GPG. | -|  `write:gpg_key` | Criar, listar e visualizar informações das chaves GPG. | -|  `read:gpg_key` | Listar e visualizar informações das chaves GPG.{% if currentVersion == "free-pro-team@latest" %} -| **`fluxo de trabalho`** | Concede a capacidade de adicionar e atualizar arquivos do fluxo de trabalho do {% data variables.product.prodname_actions %}. Os arquivos do fluxo de trabalho podem ser confirmados sem este escopo se o mesmo arquivo (com o mesmo caminho e conteúdo) existir em outro branch no mesmo repositório.{% endif %} +* `X-OAuth-Scopes` lists the scopes your token has authorized. +* `X-Accepted-OAuth-Scopes` lists the scopes that the action checks for. + +### Available scopes + +Name | Description +-----|-----------| +**`(no scope)`** | Grants read-only access to public information (includes public user profile info, public repository info, and gists){% if currentVersion != "free-pro-team@latest" %} +**`site_admin`** | Grants site administrators access to [{% data variables.product.prodname_ghe_server %} Administration API endpoints](/v3/enterprise-admin).{% endif %} +**`repo`** | Grants full access to private and public repositories. That includes read/write access to code, commit statuses, repository and organization projects, invitations, collaborators, adding team memberships, deployment statuses, and repository webhooks for public and private repositories and organizations. Also grants ability to manage user projects. + `repo:status`| Grants read/write access to public and private repository commit statuses. This scope is only necessary to grant other users or services access to private repository commit statuses *without* granting access to the code. + `repo_deployment`| Grants access to [deployment statuses](/v3/repos/deployments) for public and private repositories. This scope is only necessary to grant other users or services access to deployment statuses, *without* granting access to the code. + `public_repo`| Limits access to public repositories. That includes read/write access to code, commit statuses, repository projects, collaborators, and deployment statuses for public repositories and organizations. Also required for starring public repositories. + `repo:invite` | Grants accept/decline abilities for invitations to collaborate on a repository. This scope is only necessary to grant other users or services access to invites *without* granting access to the code.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21"%} + `security_events` | Grants read and write access to security events in the [{% data variables.product.prodname_code_scanning %} API](/v3/code-scanning).{% endif %} +**`admin:repo_hook`** | Grants read, write, ping, and delete access to repository hooks in public and private repositories. The `repo` and `public_repo` scopes grants full access to repositories, including repository hooks. Use the `admin:repo_hook` scope to limit access to only repository hooks. + `write:repo_hook` | Grants read, write, and ping access to hooks in public or private repositories. + `read:repo_hook`| Grants read and ping access to hooks in public or private repositories. +**`admin:org`** | Fully manage the organization and its teams, projects, and memberships. + `write:org`| Read and write access to organization membership, organization projects, and team membership. + `read:org`| Read-only access to organization membership, organization projects, and team membership. +**`admin:public_key`** | Fully manage public keys. + `write:public_key`| Create, list, and view details for public keys. + `read:public_key`| List and view details for public keys. +**`admin:org_hook`** | Grants read, write, ping, and delete access to organization hooks. **Note:** OAuth tokens will only be able to perform these actions on organization hooks which were created by the OAuth App. Personal access tokens will only be able to perform these actions on organization hooks created by a user. +**`gist`** | Grants write access to gists. +**`notifications`** | Grants:
    * read access to a user's notifications
    * mark as read access to threads
    * watch and unwatch access to a repository, and
    * read, write, and delete access to thread subscriptions. +**`user`** | Grants read/write access to profile info only. Note that this scope includes `user:email` and `user:follow`. + `read:user`| Grants access to read a user's profile data. + `user:email`| Grants read access to a user's email addresses. + `user:follow`| Grants access to follow or unfollow other users. +**`delete_repo`** | Grants access to delete adminable repositories. +**`write:discussion`** | Allows read and write access for team discussions. + `read:discussion` | Allows read access for team discussions.{% if currentVersion == "free-pro-team@latest" %} +**`write:packages`** | Grants access to upload or publish a package in {% data variables.product.prodname_registry %}. For more information, see "[Publishing a package](/github/managing-packages-with-github-packages/publishing-a-package)". +**`read:packages`** | Grants access to download or install packages from {% data variables.product.prodname_registry %}. For more information, see "[Installing a package](/github/managing-packages-with-github-packages/installing-a-package)". +**`delete:packages`** | Grants access to delete packages from {% data variables.product.prodname_registry %}. For more information, see "[Deleting packages](/github/managing-packages-with-github-packages/deleting-a-package)".{% endif %} +**`admin:gpg_key`** | Fully manage GPG keys. + `write:gpg_key`| Create, list, and view details for GPG keys. + `read:gpg_key`| List and view details for GPG keys.{% if currentVersion == "free-pro-team@latest" %} +**`workflow`** | Grants the ability to add and update {% data variables.product.prodname_actions %} workflow files. Workflow files can be committed without this scope if the same file (with both the same path and contents) exists on another branch in the same repository.{% endif %} {% note %} -**Observação:** O seu aplicativo OAuth pode solicitar os escopos no redirecionamento inicial. Você pode especificar vários escopos separando-os com um espaço: +**Note:** Your OAuth App can request the scopes in the initial redirection. You +can specify multiple scopes by separating them with a space: https://github.com/login/oauth/authorize? client_id=...& @@ -83,16 +84,31 @@ X-Accepted-OAuth-Scopes: user {% endnote %} -### Escopos solicitados e escopos concedidos +### Requested scopes and granted scopes -O atributo `escopo` lista os escopos adicionados ao token que foram concedido pelo usuário. Normalmente, estes escopos são idênticos aos que você solicitou. No entanto, os usuários podem editar seus escopos, concedendo, efetivamente, ao seu aplicativo um acesso menor do que você solicitou originalmente. Além disso, os usuários podem editar o escopo do token depois que o fluxo do OAuth for concluído. Você deve ter em mente esta possibilidade e ajustar o comportamento do seu aplicativo de acordo com isso. +The `scope` attribute lists scopes attached to the token that were granted by +the user. Normally, these scopes will be identical to what you requested. +However, users can edit their scopes, effectively +granting your application less access than you originally requested. Also, users +can edit token scopes after the OAuth flow is completed. +You should be aware of this possibility and adjust your application's behavior +accordingly. -É importante lidar com casos de erro em que um usuário escolhe conceder menos acesso do que solicitado originalmente. Por exemplo, os aplicativos podem alertar ou informar aos seus usuários que a funcionalidade será reduzida ou não serão capazes de realizar algumas ações. +It's important to handle error cases where a user chooses to grant you +less access than you originally requested. For example, applications can warn +or otherwise communicate with their users that they will see reduced +functionality or be unable to perform some actions. -Além disso, os aplicativos sempre podem enviar os usuários de volta através do fluxo para obter permissão adicional, mas não se esqueça de que os usuários sempre podem dizer não. +Also, applications can always send users back through the flow again to get +additional permission, but don’t forget that users can always say no. -Confira o [Príncípios do guia de autenticação](/guides/basics-of-authentication/), que fornece dicas para lidar com escopos de token modificável. +Check out the [Basics of Authentication guide](/guides/basics-of-authentication/), which +provides tips on handling modifiable token scopes. -### Escopos normalizados +### Normalized scopes -Ao solicitar vários escopos, o token é salvo com uma lista normalizada de escopos, descartando aqueles que estão implicitamente incluídos pelo escopo solicitado. Por exemplo, a solicitação do usuário `user,gist,user:email` irá gerar apenas um token com escopos de `usuário` e `gist`, desde que o acesso concedido com o escopo `user:email` esteja incluído no escopo `usuário`. +When requesting multiple scopes, the token is saved with a normalized list +of scopes, discarding those that are implicitly included by another requested +scope. For example, requesting `user,gist,user:email` will result in a +token with `user` and `gist` scopes only since the access granted with +`user:email` scope is included in the `user` scope. diff --git a/translations/pt-BR/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md b/translations/pt-BR/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md index 1416f4fdc4c9..dc3507c4d249 100644 --- a/translations/pt-BR/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md +++ b/translations/pt-BR/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md @@ -9,12 +9,11 @@ versions: --- - ### Introdução Este guia irá analisar os passos necessários para configurar um aplicativo GitHub e executá-lo em um servidor. Os aplicativos GitHub exigem algumas etapas de configuração para gerenciar eventos do webhook e conectar o registro do aplicativo no GitHub ao seu código. O aplicativo neste guia serve como base que você pode usar para estender e criar novos aplicativos no GitHub. -Ao final deste guia, você aprenderá a registrar um aplicativo GitHub e configurar um servidor web para receber eventos de webhook. Você aprenderá a usar uma ferramenta denominada Smee para capturar cargas do webhook e encaminhá-las para seu ambiente de desenvolvimento local. O aplicativo do modelo você irá configurar nesta seção não fará nada especial nesse momento, mas servirá como uma estrutura que você pode usar para começar a escrever o código do aplicativo usando a API ou concluindo outros [guias de início rápido](/apps/quickstart-guides/). {% if currentVersion == "free-pro-team@latest" %}Você pode conferir exemplos bem-sucedidos de aplicativos no [GitHub Marketplace](https://github.com/marketplace) e em [Trabalhos com GitHub](https://github.com/works-with).{% endif %} +Ao final deste guia, você aprenderá a registrar um aplicativo GitHub e configurar um servidor web para receber eventos de webhook. Você aprenderá a usar uma ferramenta denominada Smee para capturar cargas do webhook e encaminhá-las para seu ambiente de desenvolvimento local. O aplicativo do modelo você irá configurar nesta seção não fará nada especial nesse momento, mas servirá como uma estrutura que você pode usar para começar a escrever o código do aplicativo usando a API ou concluindo outros [guias de início rápido](/apps/quickstart-guides/). {% if currentVersion == "free-pro-team@latest" %}Você pode conferir exemplos bem sucedidos de aplicativos no [GitHub Marketplace](https://github.com/marketplace) e em [Funciona com o GitHub](https://github.com/works-with).{% endif %} Após concluir este projeto, você entenderá como efetuar a autenticação como um aplicativo GitHub e uma instalação, bem como e como esses métodos de autenticação são diferentes. diff --git a/translations/pt-BR/content/developers/apps/suspending-a-github-app-installation.md b/translations/pt-BR/content/developers/apps/suspending-a-github-app-installation.md index e8a5e2dcdd19..a14fc4a18833 100644 --- a/translations/pt-BR/content/developers/apps/suspending-a-github-app-installation.md +++ b/translations/pt-BR/content/developers/apps/suspending-a-github-app-installation.md @@ -17,13 +17,15 @@ versions: ### Suspender um aplicativo GitHub -Para suspender um {% data variables.product.prodname_github_app %}, você deve ser proprietário de uma conta ou ter permissões de administrador no repositório ou organização em que o aplicativo que você deseja suspender está instalado. +O integrador que possui e mantém um aplicativo GitHub, também chamado de proprietário do aplicativo GitHub, pode suspender ou cancelar a suspensão de uma instalação do aplicativo GitHub usando pontos de extremidade da API REST com JWT. Para obter mais informações, consulte a [API REST do aplicativo GitHub](/rest/reference/apps). -Você também pode suspender e cancelar instalações do {% data variables.product.prodname_github_app %} usando a API REST. Para obter mais informações, consulte a [API REST do aplicativo GitHub](/v3/apps/). +Pessoas que instalaram um aplicativo GitHub, também chamado de proprietários de instalação, só podem suspender ou cancelar a suspensão de um aplicativo GitHub através das configurações de instalação do aplicativo. Os proprietários de instalação não podem usar a API para suspender ou cancelar a suspensão da instalação do aplicativo. Antes que as pessoas possam suspender a instalação do aplicativo GitHub, o proprietário do aplicativo deve optar pela versão beta. Para obter mais informações, consulte "[Suspender uma instalação do aplicativo GitHub](/apps/managing-github-apps/suspending-a-github-app-installation/)." {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.github_apps %} -4. Selecione o {% data variables.product.prodname_github_app %} que você deseja suspender. ![Seleção de aplicativo](/assets/images/github-apps/github_apps_select-app.png) +4. Selecione o +{% data variables.product.prodname_github_app %} você deseja suspender. +![Seleção de aplicativo](/assets/images/github-apps/github_apps_select-app.png) {% data reusables.user-settings.github_apps_advanced %} 6. Ao lado das configurações de suspensão para a instalação, clique em **Suspender** ou **Cancelar a suspensão**. ![Suspender um aplicativo GitHub](/assets/images/github-apps/suspend-a-github-app.png) diff --git a/translations/pt-BR/content/developers/apps/using-the-github-api-in-your-app.md b/translations/pt-BR/content/developers/apps/using-the-github-api-in-your-app.md index 7a311dede117..f711c9e1c49b 100644 --- a/translations/pt-BR/content/developers/apps/using-the-github-api-in-your-app.md +++ b/translations/pt-BR/content/developers/apps/using-the-github-api-in-your-app.md @@ -10,7 +10,6 @@ versions: --- - ### Introdução Este guia irá ajudá-lo a criar um aplicativo GitHub e executá-lo em um servidor. O aplicativo que você criar adicionará uma etiqueta a todos os novos problemas abertos no repositório onde o aplicativo está instalado. @@ -22,7 +21,7 @@ Este projeto orientará você no seguinte: {% data reusables.apps.app-ruby-guides %} -Uma concluídas as etapas, você estará pronto para desenvolver outros tipos de integrações usando o conjunto completo das APIS do GitHub. {% if currentVersion == "free-pro-team@latest" %}Você pode conferir exemplos bem-sucedidos de aplicativos no [GitHub Marketplace](https://github.com/marketplace) e em [Trabalhos com GitHub](https://github.com/works-with).{% endif %} +Uma concluídas as etapas, você estará pronto para desenvolver outros tipos de integrações usando o conjunto completo das APIS do GitHub. {% if currentVersion == "free-pro-team@latest" %}Você pode conferir exemplos bem sucedidos de aplicativos no [GitHub Marketplace](https://github.com/marketplace) e em [Funciona com o GitHub](https://github.com/works-with).{% endif %} ### Pré-requisitos @@ -231,5 +230,5 @@ Aqui estão algumas ideias do que você pode fazer a seguir: * Quando o bot adiciona a etiqueta com sucesso, é exibida uma mensagem no Terminal. (Dica: compare o ID da etiqueta `needs-response` com o ID da etiqueta na carga como uma condição para sua mensagem para que a mensagem seja exibida somente quando a etiqueta relevante for adicionada e não qualquer outra etiqueta.) * Adicione uma página inicial ao seu aplicativo e conecte um [encaminhamento do Sinatra](https://github.com/sinatra/sinatra#routes) para isso. * Mova o seu código para um servidor hospedado (como o Heroku). Não se esqueça de atualizar as configurações do seu aplicativo com o novo domínio. -* Compartilhe seu projeto ou receba orientações no {% data variables.product.prodname_support_forum_with_url %}{% if currentVersion == "free-pro-team@latest" %} +* Compartilhe o seu projeto ou receba orientação em {% data variables.product.prodname_support_forum_with_url %}{% if currentVersion == "free-pro-team@latest" %} * Você construiu um aplicativo novo brilhante que você considera que outras pessoas podem achar útil? [Adicione-o ao GitHub Marketplace](/apps/marketplace/creating-and-submitting-your-app-for-approval/)!{% endif %} diff --git a/translations/pt-BR/content/developers/github-marketplace/drafting-a-listing-for-your-app.md b/translations/pt-BR/content/developers/github-marketplace/drafting-a-listing-for-your-app.md index 95ba4681d690..5e8cc8969081 100644 --- a/translations/pt-BR/content/developers/github-marketplace/drafting-a-listing-for-your-app.md +++ b/translations/pt-BR/content/developers/github-marketplace/drafting-a-listing-for-your-app.md @@ -40,7 +40,10 @@ Para criar uma listagem do {% data variables.product.prodname_marketplace %}: ![Seleção do tipo de aplicativo](/assets/images/settings/apps_choose_app.png) -4. Selecione o aplicativo que você gostaria de adicionar ao {% data variables.product.prodname_marketplace %}. ![Seleção de aplicativo para listagem do {% data variables.product.prodname_marketplace %}](/assets/images/github-apps/github_apps_select-app.png) +4. Selecione o aplicativo que você gostaria de adicionar a + +{% data variables.product.prodname_marketplace %}. +![Seleção de aplicativo para listagem do {% data variables.product.prodname_marketplace %}](/assets/images/github-apps/github_apps_select-app.png) {% data reusables.user-settings.edit_marketplace_listing %} 5. Uma vez criado um novo rascunho da listagem, você verá um resumo das seções que você precisará visitar antes da sua listagem do {% data variables.product.prodname_marketplace %} ser concluída. ![Listagem do GitHub Marketplace](/assets/images/marketplace/marketplace_listing_overview.png) diff --git a/translations/pt-BR/content/developers/github-marketplace/viewing-metrics-for-your-listing.md b/translations/pt-BR/content/developers/github-marketplace/viewing-metrics-for-your-listing.md index b1b2253cc4b6..45b9ce17e8a4 100644 --- a/translations/pt-BR/content/developers/github-marketplace/viewing-metrics-for-your-listing.md +++ b/translations/pt-BR/content/developers/github-marketplace/viewing-metrics-for-your-listing.md @@ -47,7 +47,8 @@ Para acessar as perspectivas do {% data variables.product.prodname_marketplace % {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.marketplace_apps %} -4. Selecione o {% data variables.product.prodname_github_app %} para o qual você gostaria de ver perspectivas. +4. Selecione o +{% data variables.product.prodname_github_app %} para o qual você gostaria de ver Insights. {% data reusables.user-settings.edit_marketplace_listing %} 6. Clique na aba **Perspectivas**. 7. Opcionalmente, selecione um período de tempo diferente, clicando no menu suspenso Período, no canto superior direito da página de Insights. ![Período de tempo do Marketplace](/assets/images/marketplace/marketplace_insights_time_period.png) diff --git a/translations/pt-BR/content/developers/github-marketplace/viewing-transactions-for-your-listing.md b/translations/pt-BR/content/developers/github-marketplace/viewing-transactions-for-your-listing.md index f8eff1f2188c..c5f6b3052066 100644 --- a/translations/pt-BR/content/developers/github-marketplace/viewing-transactions-for-your-listing.md +++ b/translations/pt-BR/content/developers/github-marketplace/viewing-transactions-for-your-listing.md @@ -39,7 +39,8 @@ Para acessar as transações do {% data variables.product.prodname_marketplace % {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.marketplace_apps %} -4. Selecione o {% data variables.product.prodname_github_app %} cujas transações você gostaria de ver. +4. Selecione o +{% data variables.product.prodname_github_app %} para o qual você gostaria de ver as transações. {% data reusables.user-settings.edit_marketplace_listing %} 6. Clique na aba **Transações**. 7. Opcionalmente, selecione um período de tempo diferente, clicando no período suspenso no canto superior direito da página de transações. ![Período de tempo do Marketplace](/assets/images/marketplace/marketplace_insights_time_period.png) diff --git a/translations/pt-BR/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md b/translations/pt-BR/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md index 3c80a9d47bde..d1f994614698 100644 --- a/translations/pt-BR/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md +++ b/translations/pt-BR/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md @@ -27,18 +27,18 @@ Cada carga útil do webhook de `marketplace_purchase` terá as seguintes informa | `Ação` | `string` | A ação realizada para gerar o webhook. Pode ser `comprado`, `cancelado`, `pending_change`, `pending_change_cancelled`, ou `alterado`. Para obter mais informações, consulte o exemplo de cargas de webhook abaixo. **Observação:** As cargas `pending_change` e `pending_change_cancelled` contêm as mesmas chaves mostradas no exemplo na carga [`alterado` da carga](#example-webhook-payload-for-a-changed-event). | | `effective_date` | `string` | A data da `ação` entra em vigor. | | `remetente` | `objeto` | A pessoa que realizou a `ação` que acionou o webhook. | -| `marketplace_purchase` | `objeto` | Informações de compra do {% data variables.product.prodname_marketplace %}. | +| `marketplace_purchase` | `objeto` | Informações de compra do {% data variables.product.prodname_marketplace %}. | O objeto `marketplace_purchase` tem as seguintes chaves: | Tecla | Tipo | Descrição | | -------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `conta` | `objeto` | A conta da `organização` ou do `usuário` associada à assinatura. As contas da organização incluirão `organization_billing_email`, que é o endereço de e-mail administrativo da organização. Para encontrar endereços de e-mail para contas pessoais, você pode usar o ponto de extremidade [Obter o usuário autenticado](/v3/users/#get-the-authenticated-user). | -| `billing_cycle` | `string` | Pode ser `anual` ou `mensal`. Quando a o proprietário da `conta` tem um plano grátis do GitHub e comprou um plano grátis do {% data variables.product.prodname_marketplace %}, o `billing_cycle` será `nulo`. | +| `billing_cycle` | `string` | Pode ser `anual` ou `mensal`. Quando a o proprietário da `conta` tem um plano grátis do GitHub e comprou um plano grátis do {% data variables.product.prodname_marketplace %}, o `billing_cycle` será `nulo`. | | `unit_count` | `inteiro` | Número de unidades compradas. | | `on_free_trial` | `boolean` | `verdadeiro` quando a `conta` está em um teste grátis. | | `free_trial_ends_on` | `string` | A data em que o teste grátis expirará. | -| `next_billing_date` | `string` | A data em que começará o próximo ciclo de faturamento. Quando o proprietário da `conta` tem um plano grátis do GitHub.com e comprou um plano grátis do {% data variables.product.prodname_marketplace %}, o `next_billing_date` será `nulo`. | +| `next_billing_date` | `string` | A data em que começará o próximo ciclo de faturamento. Quando o proprietário da `conta` tem um plano grátis do GitHub.com e comprou um plano grátis do {% data variables.product.prodname_marketplace %}, o `next_billing_date` será `nulo`. | | `plano` | `objeto` | O plano comprado pelo usuário `` ou `organização`. | O objeto `plano` tem as chaves a seguir: diff --git a/translations/pt-BR/content/developers/overview/managing-deploy-keys.md b/translations/pt-BR/content/developers/overview/managing-deploy-keys.md index c9377fa5f695..92e7fcaec02e 100644 --- a/translations/pt-BR/content/developers/overview/managing-deploy-keys.md +++ b/translations/pt-BR/content/developers/overview/managing-deploy-keys.md @@ -10,7 +10,6 @@ versions: --- - Você pode gerenciar chaves SSH em seus servidores ao automatizar scripts de implantação usando o encaminhamento do agente SSH, HTTPS com tokens do OAuth, chaves de implantação ou usuários de máquina. ### Encaminhamento de agente SSH diff --git a/translations/pt-BR/content/developers/overview/replacing-github-services.md b/translations/pt-BR/content/developers/overview/replacing-github-services.md index a9020ace9a58..60aebb918fda 100644 --- a/translations/pt-BR/content/developers/overview/replacing-github-services.md +++ b/translations/pt-BR/content/developers/overview/replacing-github-services.md @@ -19,7 +19,6 @@ Como uma alternativa ao serviço de e-mail, agora você pode começar a usar not {% endnote %} - ### Linha do tempo da depreciação - **1 de outubro de 2018**: o GitHub foi suspenso, permitindo que os usuários instalassem serviços. Removemos o GitHub Services da interface de usuário do GitHub.com. diff --git a/translations/pt-BR/content/developers/overview/using-ssh-agent-forwarding.md b/translations/pt-BR/content/developers/overview/using-ssh-agent-forwarding.md index 8a326c2224fe..0e29d5020b72 100644 --- a/translations/pt-BR/content/developers/overview/using-ssh-agent-forwarding.md +++ b/translations/pt-BR/content/developers/overview/using-ssh-agent-forwarding.md @@ -93,7 +93,7 @@ Antes de fazer suas chaves funcionarem por meio do encaminhamento de agentes, pr ```shell $ ssh -v example.com # Connect to example.com with verbose debug output -> OpenSSH_5.6p1, OpenSSL 0.9.8r 8 Feb 2011 +> OpenSSH_8.1p1, LibreSSL 2.7.3 > debug1: Reading configuration data /Users/you/.ssh/config > debug1: Applying options for example.com > debug1: Reading configuration data /etc/ssh_config diff --git a/translations/pt-BR/content/developers/webhooks-and-events/about-webhooks.md b/translations/pt-BR/content/developers/webhooks-and-events/about-webhooks.md index 21da05c35a82..64b973bcf586 100644 --- a/translations/pt-BR/content/developers/webhooks-and-events/about-webhooks.md +++ b/translations/pt-BR/content/developers/webhooks-and-events/about-webhooks.md @@ -1,6 +1,6 @@ --- -title: Sobre webhooks -intro: Aprenda os princípios básicos de como os webhooks funcionam para ajudá-lo a criar e configurar integrações. +title: About webhooks +intro: Learn the basics of how webhooks work to help you build and set up integrations. redirect_from: - /webhooks versions: @@ -9,26 +9,25 @@ versions: --- +Webhooks allow you to build or set up integrations, such as [{% data variables.product.prodname_github_app %}s](/apps/building-github-apps/) or [{% data variables.product.prodname_oauth_app %}s](/apps/building-oauth-apps/), which subscribe to certain events on GitHub.com. When one of those events is triggered, we'll send a HTTP POST payload to the webhook's configured URL. Webhooks can be used to update an external issue tracker, trigger CI builds, update a backup mirror, or even deploy to your production server. You're only limited by your imagination. -Os webhooks permitem que você crie ou configure integrações, como [{% data variables.product.prodname_github_app %}s](/apps/building-github-apps/) ou [{% data variables.product.prodname_oauth_app %}s](/apps/building-oauth-apps/), que assinam determinados eventos no GitHub.com. Quando um desses eventos é acionado, enviaremos uma carga de POST por HTTP POST para a URL de configuração do webhook. Os webhooks podem ser usados para atualizar um rastreador de problemas externo, acionar criações de CI, atualizar um espelho de backup, ou até mesmo fazer uma implantação no seu servidor de produção. A sua imaginação é o único limite. +Webhooks can be installed on{% if currentVersion != "free-pro-team@latest" %} a [{% data variables.product.prodname_ghe_server %} instance](/rest/reference/enterprise-admin#global-webhooks/),{% endif %} an [organization][org-hooks], a specific [repository][repo-hooks], or a {% data variables.product.prodname_github_app %}. Once installed, the webhook will be sent each time one or more subscribed events occurs. -Os webhooks podem ser instalados em{% if currentVersion != "free-pro-team@latest" %} uma instância do [{% data variables.product.prodname_ghe_server %}](/v3/enterprise-admin/global_webhooks/),{% endif %} uma [organização][org-hooks], um repositório [específico][repo-hooks]ou em um {% data variables.product.prodname_github_app %}. Uma vez instalado, o webhook será enviado cada vez que ocorrer um ou mais eventos assinados. +You can create up to {% if currentVersion != "free-pro-team@latest" %}250{% else %}20{% endif %} webhooks for each event on each installation target {% if currentVersion != "free-pro-team@latest" %}({% data variables.product.prodname_ghe_server %} instance, specific organization, or specific repository).{% else %}(specific organization or specific repository).{% endif %} -Você pode criar até {% if currentVersion != "free-pro-team@latest" %}250{% else %}20{% endif %} webhooks para cada evento em cada destino de instalação {% if currentVersion != "free-pro-team@latest" %}instância({% data variables.product.prodname_ghe_server %} de organização específica ou repositório específico).{% else %}(organização específica ou repositório específico).{% endif %} - -### Eventos +### Events {% data reusables.webhooks.webhooks_intro %} -Cada evento corresponde a um certo conjunto de ações que podem ocorrer na sua organização e/ou repositório. Por exemplo, se você assinar o evento `problemas`, você receberá cargas detalhadas toda vez que uma tarefa for aberta, fechada, etiquetada, etc. +Each event corresponds to a certain set of actions that can happen to your organization and/or repository. For example, if you subscribe to the `issues` event you'll receive detailed payloads every time an issue is opened, closed, labeled, etc. -Consulte "[Cargas de evento do eebhook](/webhooks/event-payloads)" para a lista de eventos de webhook disponíveis e suas cargas. +See "[Webhook event payloads](/webhooks/event-payloads)" for the list of available webhook events and their payloads. -### Evento de ping +### Ping event {% data reusables.webhooks.ping_short_desc %} -Para obter mais informações sobre a carga do webhook do evento de `ping`, consulte o evento [`ping`](/webhooks/event-payloads/#ping). +For more information about the `ping` event webhook payload, see the [`ping`](/webhooks/event-payloads/#ping) event. -[org-hooks]: /v3/orgs/hooks/ +[org-hooks]: /rest/reference/orgs#webhooks/ [repo-hooks]: /v3/repos/hooks/ diff --git a/translations/pt-BR/content/developers/webhooks-and-events/github-event-types.md b/translations/pt-BR/content/developers/webhooks-and-events/github-event-types.md index 376718aa3323..2009e1d381cf 100644 --- a/translations/pt-BR/content/developers/webhooks-and-events/github-event-types.md +++ b/translations/pt-BR/content/developers/webhooks-and-events/github-event-types.md @@ -16,7 +16,6 @@ A API de eventos pode retornar diferentes tipos de eventos acionados por ativida {% endif %} - ### Propriedades comuns do objeto de evento Os objetos de evento retornados dos pontos de extremidade da API de eventos têm a mesma estrutura. diff --git a/translations/pt-BR/content/developers/webhooks-and-events/issue-event-types.md b/translations/pt-BR/content/developers/webhooks-and-events/issue-event-types.md index d01eaf526737..f10d6deafcf3 100644 --- a/translations/pt-BR/content/developers/webhooks-and-events/issue-event-types.md +++ b/translations/pt-BR/content/developers/webhooks-and-events/issue-event-types.md @@ -11,7 +11,6 @@ versions: Eventos de problemas são acionados pela atividade em problemas e pull requests e estão disponíveis na [API de eventos de problemas](/v3/issues/events) e na [API de eventos da linha do tempo](/v3/issues/timeline). Cada tipo de evento especifica se o evento está disponível nos eventos do problema ou na API de eventos da linha do tempo. - A API REST do GitHub considera que todo pull request é um problema, mas nem todos os problemas são pull request. Por este motivo, os eventos de problemas e os pontos de extremidade dos eventos da linha do tempo podem retornar problemas e pull requests na resposta. Pull requests têm uma propriedade `pull_request` no objeto `problema`. Como os pull requests são problemas, os números de problemas e pull requests não se sobrepõem em um repositório. Por exemplo, se você abrir seu primeiro problema em um repositório, o número será 1. Se você abrir um pull request, o número será 2. Cada tipo de evento especifica se o evento ocorre em um pull request, em um problema ou em ambos. ### Propriedades comuns do objeto de evento do problema diff --git a/translations/pt-BR/content/developers/webhooks-and-events/securing-your-webhooks.md b/translations/pt-BR/content/developers/webhooks-and-events/securing-your-webhooks.md index afc6c0934c17..1035e10af1c0 100644 --- a/translations/pt-BR/content/developers/webhooks-and-events/securing-your-webhooks.md +++ b/translations/pt-BR/content/developers/webhooks-and-events/securing-your-webhooks.md @@ -33,9 +33,17 @@ $ export SECRET_TOKEN=your_token ### Validar cargas do GitHub -Ao definir o seu token secreto, o GitHub usa-o para criar uma assinatura de hash com cada carga. +Quando seu token secreto está definido, {% data variables.product.product_name %} use-o para criar uma assinatura de hash com cada carga. Esta assinatura de hash está incluída com os cabeçalhos de cada solicitação como {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 2" ou versão atual == "private-instances@latest" %}`X-Hub-Signature-256`{% else if currentVersion ver_lt "enterprise-server@2.23" %}`X-Hub-Signature`{% endif %}. -Esta assinatura de hash é passada junto com cada solicitação nos cabeçalhos como `X-Hub-Signature`. Suponha que você tem um servidor básico que ouve webhooks que se parece com isto: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %} +{% note %} + +**Observação:** Para compatibilidade com versões anteriores, também incluímos o cabeçalho `X-Hub-Signature` gerado usando a função de hash SHA-1. Se possível, recomendamos que você use o cabeçalho `X-Hub-Signature-256` para melhorar a segurança. O exemplo abaixo demonstra o uso do cabeçalho `X-Hub-Signature-256`. + +{% endnote %} +{% endif %} + +Por exemplo, se você tem um servidor básico que ouve webhooks, ele poderá ser configurado de forma semelhante a isso: ``` ruby require 'sinatra' @@ -47,7 +55,7 @@ post '/payload' do end ``` -O objetivo é calcular um hash usando seu `SECRET_TOKEN` e garantir que o hash do GitHub corresponda com esse. O GitHub usa um hexdigest de HMAC para calcular o hash para que você possa alterar seu servidor para ficar um pouco parecido com isto: +O objetivo é calcular um hash usando seu `SECRET_TOKEN` e garantir que o resultado corresponda ao hash de {% data variables.product.product_name %}. {% data variables.product.product_name %} usa um resumo hexadecimal HMAC para calcular o hash. Portanto, você pode reconfigurar o seu servidor para que se pareça mais ou menos assim: ``` ruby post '/payload' do @@ -58,16 +66,21 @@ post '/payload' do "I got some JSON: #{push.inspect}" end +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %} +def verify_signature(payload_body) + signature = 'sha256=' + OpenSSL::HMAC.hexdigest(OpenSSL::Digest.new('sha256'), ENV['SECRET_TOKEN'], payload_body) + return halt 500, "Signatures didn't match!" unless Rack::Utils.secure_compare(signature, request.env['HTTP_X_HUB_SIGNATURE_2']) +end{% else if currentVersion ver_lt "enterprise-server@2.23" %} def verify_signature(payload_body) signature = 'sha1=' + OpenSSL::HMAC.hexdigest(OpenSSL::Digest.new('sha1'), ENV['SECRET_TOKEN'], payload_body) return halt 500, "Signatures didn't match!" unless Rack::Utils.secure_compare(signature, request.env['HTTP_X_HUB_SIGNATURE']) -end +end{% endif %} ``` -Obviamente, as implementações da sua linguagem e servidor podem ser diferentes deste código. No entanto, há duas coisas muito importantes a assinalar: +A sua linguagem e implementações do servidor podem ser diferentes deste código de exemplo. No entanto, há uma série de aspectos muito importantes a destacar: -* Não importa qual implementação você usa, a assinatura de hash começa com `sha1=` e usa a chave de seu token secreto e seu texto de carga. +* Não importa qual implementação você use, a assinatura de hash começa com {% if currentVersion == "free-pro-team@latest" ou currentVersion ver_gt "enterprise-server@2. 2" ou "private-instances@latest" %}`sha256=`{% else if currentVersion ver_lt "enterprise-server@2. 3" %}`sha1=`{% endif %}, usando a chave do seu token secreto e o seu texto da carga. -* Não **se recomenda** usar um operador simples de`==`. Um método como o [`secure_compare`][secure_compare] executa uma comparação de string de "tempo constante", que o protege de certos ataques em tempo útil contra operadores regulares da igualdade. +* Não **se recomenda** usar um operador simples de`==`. Um método como [`secure_compare`][secure_compare] executa uma comparação de strings "tempo constante", o que ajuda a mitigar certos ataques de tempo contra operadores de igualdade regular. [secure_compare]: http://rubydoc.info/github/rack/rack/master/Rack/Utils.secure_compare diff --git a/translations/pt-BR/content/developers/webhooks-and-events/testing-webhooks.md b/translations/pt-BR/content/developers/webhooks-and-events/testing-webhooks.md index 173f400b88db..a248aec068c3 100644 --- a/translations/pt-BR/content/developers/webhooks-and-events/testing-webhooks.md +++ b/translations/pt-BR/content/developers/webhooks-and-events/testing-webhooks.md @@ -9,7 +9,6 @@ versions: --- - Agora que você [configurou seu servidor local](/webhooks/configuring/), você pode estar interessado em fazer push do seu código em seus limites. Para isso, a visualização de webhooks do GitHub fornece algumas ferramentas para testar suas cargas implantadas. ### Listar as entregas recentes diff --git a/translations/pt-BR/content/developers/webhooks-and-events/webhook-events-and-payloads.md b/translations/pt-BR/content/developers/webhooks-and-events/webhook-events-and-payloads.md index 1059f51daae3..8493562c897e 100644 --- a/translations/pt-BR/content/developers/webhooks-and-events/webhook-events-and-payloads.md +++ b/translations/pt-BR/content/developers/webhooks-and-events/webhook-events-and-payloads.md @@ -20,7 +20,6 @@ versions: Você pode criar webhooks que assinam os eventos listados nesta página. Cada evento de webhook inclui uma descrição das propriedades do webhook e uma carga de exemplo. Para obter mais informações, consulte "[Criar webhooks](/webhooks/creating/)." - ### Propriedades comuns do objeto da carga do webhook Cada carga do evento do webhook também contém propriedades únicas para o evento. Você pode encontrar as propriedades únicas nas seções individuais de tipos de evento. @@ -28,11 +27,8 @@ Cada carga do evento do webhook também contém propriedades únicas para o even | Tecla | Tipo | Descrição | | ------ | -------- | ---------------------------------------------------------------------------------------------------------------------- | | `Ação` | `string` | A maioria das cargas de webhook contém uma ação `` propriedade que contém a atividade específica que acionou o evento. | - {% data reusables.webhooks.sender_desc %} Esta propriedade está incluída em todas as cargas do webhook. -{% data reusables.webhooks.repo_desc %} As cargas do webhook contêm a propriedade - -`repository` quando ocorre o evento a partir da atividade em um repositório. +{% data reusables.webhooks.repo_desc %} As cargas do webhook contêm a propriedade `repository` quando ocorre o evento a partir da atividade em um repositório. {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} Para obter mais informações, consulte "[Criar um {% data variables.product.prodname_github_app %}](/apps/building-github-apps/). @@ -48,13 +44,14 @@ As propriedades únicas para um evento de webhook são as mesmas que você encon As cargas de HTTP POST que são entregues no ponto de extremidade da URL configurado do seu webhook conterão vários cabeçalhos especiais: -| Header | Descrição | -| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `X-GitHub-Event` | Nome do evento que ativou a entrega. | +| Header | Descrição | +| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `X-GitHub-Event` | Nome do evento que ativou a entrega. | | `X-GitHub-Delivery` | Um [GUID](http://en.wikipedia.org/wiki/Globally_unique_identifier) para identificar a entrega.{% if currentVersion != "free-pro-team@latest" %} -| `X-GitHub-Enterprise-Version` | A versão da instância do {% data variables.product.prodname_ghe_server %} que enviou a carga do HTTP POST. | -| `X-GitHub-Enterprise-Host` | O nome do host da instância do {% data variables.product.prodname_ghe_server %} que enviou a carga HTTP POST.{% endif %} -| `X-Hub-Signature` | O resumo hexadecimal de HMAC no texto da resposta. Este cabeçalho será enviado se o webhook for configurado com um [`secredo`](/v3/repos/hooks/#create-hook-config-params). O resumo hexadecimal de HMAC é gerado usando a função hash `sha1` e o `segredo` como a `chave` de HMAC. | +| `X-GitHub-Enterprise-Version` | A versão da instância do {% data variables.product.prodname_ghe_server %} que enviou a carga do HTTP POST. | +| `X-GitHub-Enterprise-Host` | O nome de host da instância do {% data variables.product.prodname_ghe_server %} que enviou a carga HTTP POST.{% endif %}{% if currentVersion != "private-instances@latest" %} +| `X-Hub-Signature` | Este cabeçalho é enviado se o webhook for configurado com um [`secreto`](/v3/repos/hooks/#create-hook-config-params). Este é o resumo hexadecimal HMAC do texto da solicitação e é gerado usando a função hash SHA-1 e o `segredo` como a `chave` HMAC.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} `X-Hub-Signature` é fornecido para compatibilidade com integrações existentes, e recomendamos que você use um `X-Hub-Signature-256` mais seguro.{% endif %}{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %} +| `X-Hub-Signature-256` | Este cabeçalho é enviado se o webhook for configurado com um [`secreto`](/v3/repos/hooks/#create-hook-config-params). Este é o resumo hexadecimal HMAC do texto da solicitação e é gerado usando a função hash SHA-256 e a `segredo` como a `chave` HMAC.{% endif %} Além disso, o `User-Agent` para as solicitações terá o prefixo `GitHub-Hookshot/`. @@ -66,8 +63,9 @@ Além disso, o `User-Agent` para as solicitações terá o prefixo `GitHub-Hooks > Host: localhost:4567 > X-GitHub-Delivery: 72d3162e-cc78-11e3-81ab-4c9367dc0958{% if currentVersion != "free-pro-team@latest" %} > X-GitHub-Enterprise-Version: 2.15.0 -> X-GitHub-Enterprise-Host: example.com{% endif %} -> X-Hub-Signature: sha1=7d38cdd689735b008b3c702edd92eea23791c5f6 +> X-GitHub-Enterprise-Host: example.com{% endif %}{% if currentVersion != "private-instances@latest" %} +> X-Hub-Signature: sha1=7d38cdd689735b008b3c702edd92eea23791c5f6{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %} +> X-Hub-Signature-256: sha256=d57c68ca6f92289e6987922ff26938930f6e66a2d161ef06abdf1859230aa23c{% endif %} > User-Agent: GitHub-Hookshot/044aadd > Content-Type: application/json > Content-Length: 6615 @@ -292,10 +290,10 @@ Apenas os {% data variables.product.prodname_github_app %}s podem receber este e #### Objeto da carga do webhook -| Tecla | Tipo | Descrição | -| ------------- | --------------------------------------------------------------- | ----------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -| `Ação` | `string` | A ação realizada. Pode ser `criado`.{% endif %} -| `implantação` | `objeto` | The [implantação](/v3/repos/deployments/#list-deployments). | +| Tecla | Tipo | Descrição | +| ------------- | --------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +| `Ação` | `string` | A ação realizada. Pode ser `criado`.{% endif %} +| `implantação` | `objeto` | The [implantação](/rest/reference/repos#list-deployments). | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} @@ -317,14 +315,14 @@ Apenas os {% data variables.product.prodname_github_app %}s podem receber este e #### Objeto da carga do webhook -| Tecla | Tipo | Descrição | -| ---------------------------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -| `Ação` | `string` | A ação realizada. Pode ser `criado`.{% endif %} -| `implantação_status` | `objeto` | O [estado de implantação](/v3/repos/deployments/#list-deployment-statuses). | -| `deployment_status["state"]` | `string` | O novo estado. Pode ser `pendente`, `sucesso`, `falha` ou `erro`. | -| `deployment_status["target_url"]` | `string` | O link opcional adicionado ao status. | -| `deployment_status["description"]` | `string` | A descrição opcional legível para pessoas adicionada ao status. | -| `implantação` | `objeto` | A [implantação](/v3/repos/deployments/#list-deployments) à qual este status está associado. | +| Tecla | Tipo | Descrição | +| ---------------------------------- | --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +| `Ação` | `string` | A ação realizada. Pode ser `criado`.{% endif %} +| `implantação_status` | `objeto` | O [estado de implantação](/rest/reference/repos#list-deployment-statuses). | +| `deployment_status["state"]` | `string` | O novo estado. Pode ser `pendente`, `sucesso`, `falha` ou `erro`. | +| `deployment_status["target_url"]` | `string` | O link opcional adicionado ao status. | +| `deployment_status["description"]` | `string` | A descrição opcional legível para pessoas adicionada ao status. | +| `implantação` | `objeto` | A [implantação](/rest/reference/repos#list-deployments) à qual este status está associado. | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} @@ -342,7 +340,7 @@ Apenas os {% data variables.product.prodname_github_app %}s podem receber este e #### Disponibilidade -- Webhooks do GitHub Enterprise. Para obter mais informações, consulte "[Webhooks globais](/v3/enterprise-admin/global_webhooks/)". +- Webhooks do GitHub Enterprise. Para obter mais informações, consulte "[Webhooks globais](/rest/reference/enterprise-admin#global-webhooks/)". #### Objeto da carga do webhook @@ -759,7 +757,7 @@ Para obter uma descrição detalhada desta carga e da carga para cada tipo de `a #### Disponibilidade {% if currentVersion != "free-pro-team@latest" %} -- Os webhooks do GitHub Enterprise recebem apenas eventos `criados` e `excluídos`. Para mais informações, consulte "[Webhooks globais](/v3/enterprise-admin/global_webhooks/).{% endif %} +- Os webhooks do GitHub Enterprise recebem apenas eventos `criados` e `excluídos`. Para mais informações, consulte "[Webhooks globais](/rest/reference/enterprise-admin#global-webhooks/).{% endif %} - Os webhooks da organização recebem apenas os eventos `excluídos`, `adicionados`, `removidos`, `renomeado` e `convidados` - Os {% data variables.product.prodname_github_app %}s com a permissão     membros` @@ -845,10 +843,10 @@ Atividade relacionada a {% data variables.product.prodname_registry %}. {% data #### Objeto da carga do webhook -| Tecla | Tipo | Descrição | -| ------- | --------- | ---------------------------------------------------------------------------------- | -| `id` | `inteiro` | O identificador exclusivo da criação de páginas. | -| `build` | `objeto` | A [Listar as criações do GitHub Pages](/v3/repos/pages/#list-github-pages-builds). | +| Tecla | Tipo | Descrição | +| ------- | --------- | --------------------------------------------------------------------------------------- | +| `id` | `inteiro` | O identificador exclusivo da criação de páginas. | +| `build` | `objeto` | A [Listar as criações do GitHub Pages](/rest/reference/repos#list-github-pages-builds). | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} @@ -870,11 +868,11 @@ Atividade relacionada a {% data variables.product.prodname_registry %}. {% data #### Objeto da carga do webhook -| Tecla | Tipo | Descrição | -| -------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `zen` | `string` | String aleatória do Github zen. | -| `hook_id` | `inteiro` | O ID do webhook que acionou o ping. | -| `hook` | `objeto` | A [configuração do webhook](/v3/repos/hooks/#get-a-repository-webhook). | +| Tecla | Tipo | Descrição | +| -------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `zen` | `string` | String aleatória do Github zen. | +| `hook_id` | `inteiro` | O ID do webhook que acionou o ping. | +| `hook` | `objeto` | A [configuração do webhook](/v3/repos/hooks/#get-a-repository-webhook). | | `hook[app_id]` | `inteiro` | Ao registrar um novo {% data variables.product.prodname_github_app %}, {% data variables.product.product_name %} envia um evento de ping para a **URL do webhook** que você especificou no registro. O evento contém o `app_id`, que é necessário para a [efetuar a autenticação](/apps/building-integrations/setting-up-and-registering-github-apps/about-authentication-options-for-github-apps/) em um aplicativo. | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} @@ -1142,7 +1140,7 @@ Este evento ocorre quando um {% data variables.product.prodname_github_app %} en | Tecla | Tipo | Descrição | | ------ | -------- | ---------------------------------------------------------------------------------- | -| `Ação` | `string` | A ação que foi executada. Este pode ser um dos seguintes:
    • `created` - Um repositório foi criado.
    • `deleted` - Um repositório foi excluído. Este tipo de evento está disponível apenas para [hooks de organização](/v3/orgs/hooks/)
    • `archived` - Um repositório está arquivado.
    • `unarchived` - Um repositório não está arquivado.
      • {% if currentVersion != "free-pro-team@latest" %}
    • `anonymous_access_enabled` - Um repositório está [habilitado para acesso anônimo do Git](/v3/previews/#anonymous-git-access-to-repositories), `anonymous_access_disabled` - Um repositório está [desabilitado para acesso anônimo do Git](/v3/previews/#anonymous-git-access-to-repositories)
      • {% endif %}
    • `edited` - As informações de um repositório são editadas.
    • `renamed` - Um repositório é renomeado.
    • `transferred` - Um repositório é transferido.
    • `publicized` - Um repositório é publicado.
    • `privatizado` - Um repositório é privatizado.
    | +| `Ação` | `string` | A ação que foi executada. Este pode ser um dos seguintes:
    • `created` - Um repositório foi criado.
    • `deleted` - Um repositório foi excluído. Este tipo de evento está disponível apenas para [hooks de organização](/rest/reference/orgs#webhooks/)
    • `archived` - Um repositório está arquivado.
    • `unarchived` - Um repositório não está arquivado.
      • {% if currentVersion != "free-pro-team@latest" %}
    • `anonymous_access_enabled` - Um repositório está [habilitado para acesso anônimo do Git](/v3/previews/#anonymous-git-access-to-repositories), `anonymous_access_disabled` - Um repositório está [desabilitado para acesso anônimo do Git](/v3/previews/#anonymous-git-access-to-repositories)
      • {% endif %}
    • `edited` - As informações de um repositório são editadas.
    • `renamed` - Um repositório é renomeado.
    • `transferred` - Um repositório é transferido.
    • `publicized` - Um repositório é publicado.
    • `privatizado` - Um repositório é privatizado.
    | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} @@ -1363,7 +1361,7 @@ Você só pode criar um webhook de patrocínio em {% data variables.product.prod Quando um usuário é `criado` ou `excluído`. #### Disponibilidade -- Webhooks do GitHub Enterprise. Para obter mais informações, consulte "[Webhooks globais](/v3/enterprise-admin/global_webhooks/)". +- Webhooks do GitHub Enterprise. Para obter mais informações, consulte "[Webhooks globais](/rest/reference/enterprise-admin#global-webhooks/)". #### Exemplo de carga de webhook @@ -1409,7 +1407,6 @@ Esse evento ocorre quando alguém aciona a execução de um fluxo de trabalho no {{ webhookPayloadsForCurrentVersion.workflow_dispatch }} {% endif %} - ### workflow_run Quando uma execução do fluxo de trabalho de {% data variables.product.prodname_actions %} for solicitada ou concluída. Para obter mais informações, consulte "[Eventos que acionam fluxos de trabalho](/actions/reference/events-that-trigger-workflows#workflow_run)". diff --git a/translations/pt-BR/content/github/administering-a-repository/about-branch-restrictions.md b/translations/pt-BR/content/github/administering-a-repository/about-branch-restrictions.md index 717aa4ba2f91..6dd52af92413 100644 --- a/translations/pt-BR/content/github/administering-a-repository/about-branch-restrictions.md +++ b/translations/pt-BR/content/github/administering-a-repository/about-branch-restrictions.md @@ -1,6 +1,6 @@ --- title: Sobre restrições de branch -intro: 'Os branches em repositórios que pertencem às organizações podem ser configurados para que apenas determinados usuários{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %} ou{% endif %} equipes{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} ou apps{% endif %} possam fazer push no branch.' +intro: 'Branches em repositórios pertencentes a organizações podem ser configurados para que apenas determinados usuários{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 8" %},{% else %} ou{% endif %} equipes{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 8" %} ou aplicativos{% endif %} possam fazer push para o branch.' product: '{% data reusables.gated-features.branch-restrictions %}' redirect_from: - /articles/about-branch-restrictions @@ -9,15 +9,15 @@ versions: enterprise-server: '*' --- -Quando você habilita restrições de branch, somente usuários{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %} ou{% endif %} equipes{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, ou apps{% endif %} que receberam permissão podem fazer push no branch protegido. Quando você habilita restrições de branch, somente usuários{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %} ou{% endif %} equipes{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, ou apps{% endif %} que receberam permissão podem fazer push no branch protegido. É possível exibir e editar os usuários{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %} ou{% endif %} equipes{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, ou apps{% endif %} com acesso push a um branch protegido nas configurações do branch protegido. +Ao habilitar as restrições de branches, apenas usuários, equipes ou aplicativos com permissão podem fazer push para o branch protegido. Quando você habilita restrições de branch, somente usuários{% if page.version == "dotcom" or page.version ver_gt "2.18" %},{% else %} ou{% endif %} equipes{% if page.version == "dotcom" or page.version ver_gt "2.18" %}, ou apps{% endif %} que receberam permissão podem fazer push no branch protegido. Você pode visualizar e editar usuários, equipes ou aplicativos com acesso de push a um branch protegido nas configurações do branch protegido. -Você pode dar acesso push a um branch protegido apenas a usuários{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %} ou{% endif %} equipes{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, ou {% data variables.product.prodname_github_apps %}{% endif %} instalados com acesso `write` a um repositório. +Você só pode dar acesso de push a um branch protegido a usuários, equipes ou {% data variables.product.prodname_github_apps %} instalados com acesso de `gravação` a um repositório. -Pessoas{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} e apps{% endif %} com permissões de administrador a um repositório sempre podem fazer push em um branch protegido. +As pessoas e os aplicativos com permissões de administrador em um repositório sempre conseguem fazer push em um branch protegido. {% tip %} -**Observação:** se "Include administrators" (Incluir administradores) estiver selecionada, significa que você habilitou as verificações de status obrigatórias no branch, e se quaisquer verificações de status falharem, qualquer tentativa de fazer push de alterações no branch protegido também irá falhar, mesmo para pessoas{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} e apps{% endif %} com permissões de administrador. Para obter mais informações, consulte "[Habilitando verificações de status obrigatórias](/articles/enabling-required-status-checks)". +**Observação:** se "Incluir administradores estiver selecionada, significa que você habilitou as verificações de status obrigatórias no branch, e se quaisquer verificações de status falharem, qualquer tentativa de fazer push de alterações no branch protegido também irá falhar, mesmo para pessoas e aplicativos com permissões de administrador. Para obter mais informações, consulte "[Habilitando verificações de status obrigatórias](/articles/enabling-required-status-checks)". {% endtip %} diff --git a/translations/pt-BR/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md b/translations/pt-BR/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md index 6cc93dd54765..2f6ef8691c07 100644 --- a/translations/pt-BR/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md +++ b/translations/pt-BR/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md @@ -24,8 +24,8 @@ Cada notificação de e-mail para um push no repositório lista os novos commits - Os arquivos que foram alterados como parte do commit - A mensagem do commit; -É possível filtrar notificações de e-mail que você recebe para pushes em um repositório. Para obter mais informações, consulte {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[Configurando notificações](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#filtering-email-notifications){% else %}"[Sobre e-mails de notificação](/github/receiving-notifications-about-activity-on-github/about-email-notifications)"." Você também pode desativar notificações por email para pushes. Para obter mais informações, consulte " -[Escolher o método de entrega das suas notificações](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications){% endif %}".

    +É possível filtrar notificações de e-mail que você recebe para pushes em um repositório. Para obter mais informações, consulte {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 0" %}"[Configurar notificações](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#filtering-email-notifications){% else %}"[Sobre e-mails de notificação](/github/receiving-notifications-about-activity-on-github/about-email-notifications)". Você também pode desativar notificações por email para pushes. Para obter mais informações, consulte " +[Escolher o método de entrega das suas notificações](/enterprise/{{ page.version }}/user/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications){% endif %}".

    @@ -45,9 +45,7 @@ Cada notificação de e-mail para um push no repositório lista os novos commits 6. Se você é quem opera o seu próprio servidor, será possível verificar a integridade dos e-mails por meio do token **Secret**. Esse token é enviado com o e-mail como o header `Approved`. Se o header `Approved` corresponder ao token enviado, você poderá confiar que esse e-mail é do {% data variables.product.product_name %}. ![Caixa de texto do segredo do e-mail](/assets/images/help/settings/email_services_token.png) -7. Como opção, selecione **Send from author** (Enviar do autor) para que os e-mails sejam entregues usando o endereço de e-mail do committer. Caso contrário, os e-mails serão enviados de {% data variables.notifications.no_reply_address %}. ![Caixa de seleção do autor do email](/assets/images/help/settings/email_services_author.png) - -8. Clique em **Save settings** (Salvar configurações). ![Botão Save settings (Salvar configurações)](/assets/images/help/settings/save_notification_settings.png) +7. Clique em **Save settings** (Salvar configurações). ![Botão Save settings (Salvar configurações)](/assets/images/help/settings/save_notification_settings.png) diff --git a/translations/pt-BR/content/github/administering-a-repository/about-github-dependabot-version-updates.md b/translations/pt-BR/content/github/administering-a-repository/about-github-dependabot-version-updates.md index a6f45039b69b..3f3f7b03d8bd 100644 --- a/translations/pt-BR/content/github/administering-a-repository/about-github-dependabot-version-updates.md +++ b/translations/pt-BR/content/github/administering-a-repository/about-github-dependabot-version-updates.md @@ -13,7 +13,9 @@ versions: O {% data variables.product.prodname_dependabot %} facilita a manutenção de suas dependências. Você pode usá-lo para garantir que seu repositório se mantenha atualizado automaticamente com as versões mais recentes dos pacotes e aplicações do qual ele depende. -Você habilita o {% data variables.product.prodname_dependabot_version_updates %} verificando um arquivo de configuração no seu repositório. O arquivo de configuração especifica a localização do manifesto ou outros arquivos de definição de pacote, armazenados no seu repositório. O {% data variables.product.prodname_dependabot_short %} usa essas informações para verificar pacotes e aplicativos desatualizados. {% data variables.product.prodname_dependabot_short %} determina se há uma nova versão de uma dependência observando a versão semântica ([semver](https://semver.org/)) da dependência para decidir se deve atualizar para essa versão. Quando {% data variables.product.prodname_dependabot_short %} identifica uma dependência desatualizada, ele cria uma pull request para atualizar o manifesto para a última versão da dependência. Você verifica se os seus testes passam, revisa o changelog e lança observações incluídas no resumo do pull request e, em seguida, faz a mesclagem. Para obter detalhes, consulte "[Habilitando e desabilitando atualizações da versão](/github/administering-a-repository/enabling-and-disabling-version-updates)." +Você habilita o {% data variables.product.prodname_dependabot_version_updates %} verificando um arquivo de configuração no seu repositório. O arquivo de configuração especifica a localização do manifesto ou outros arquivos de definição de pacote, armazenados no seu repositório. O {% data variables.product.prodname_dependabot_short %} usa essas informações para verificar pacotes e aplicativos desatualizados. {% data variables.product.prodname_dependabot_short %} determina se há uma nova versão de uma dependência observando a versão semântica ([semver](https://semver.org/)) da dependência para decidir se deve atualizar para essa versão. Para certos gerentes de pacote, {% data variables.product.prodname_dependabot_version_updates %} também é compatível com armazenamento. Dependências de vendor (ou armazenadas) são dependências registradas em um diretório específico em um repositório, em vez de referenciadas em um manifesto. Dependências de vendor estão disponíveis no tempo de criação, ainda que os servidores de pacote estejam indisponíveis. {% data variables.product.prodname_dependabot_version_updates %} pode ser configurado para verificar as dependências de vendor para novas versões e atualizá-las, se necessário. + +Quando {% data variables.product.prodname_dependabot_short %} identifica uma dependência desatualizada, ele cria uma pull request para atualizar o manifesto para a última versão da dependência. Para dependências de vendor, {% data variables.product.prodname_dependabot_short %} levanta um pull request para substituir diretamente a dependência desatualizada pela nova versão. Você verifica se os seus testes passam, revisa o changelog e lança observações incluídas no resumo do pull request e, em seguida, faz a mesclagem. Para obter detalhes, consulte "[Habilitando e desabilitando atualizações da versão](/github/administering-a-repository/enabling-and-disabling-version-updates)." Se você habilitar atualizações de segurança, {% data variables.product.prodname_dependabot %} também promove pull requests para atualizar dependências vulneráveis. Para obter mais informações, consulte "[Configurando {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)." @@ -35,7 +37,7 @@ Se tiver habilitado atualizações de segurança, às vezes você verá atualiza {% endnote %} -É possível configurar atualizações de versão para repositórios que contenham um manifesto de dependência ou arquivo de bloqueio para um dos gerentes de pacotes suportados. +É possível configurar atualizações de versão para repositórios que contenham um manifesto de dependência ou arquivo de bloqueio para um dos gerentes de pacotes suportados. Para alguns gerenciadores de pacotes, você também pode configurar o armazenamento para dependências. Para obter mais informações, consulte "[Opções de configuração para atualizações de dependências](/github/administering-a-repository/configuration-options-for-dependency-updates#vendor)". {% data reusables.dependabot.supported-package-managers %} diff --git a/translations/pt-BR/content/github/administering-a-repository/about-protected-branches.md b/translations/pt-BR/content/github/administering-a-repository/about-protected-branches.md index c53ccb33cfd7..55b27efd0464 100644 --- a/translations/pt-BR/content/github/administering-a-repository/about-protected-branches.md +++ b/translations/pt-BR/content/github/administering-a-repository/about-protected-branches.md @@ -24,7 +24,7 @@ As regras de branch protegido que mencionam um caractere especial, como `*`, `?` ### Configurações de proteção de branch -Quando você cria uma regra de proteção de branch em um repositório, colaboradores não podem forçar push para o branch protegido ou excluir o branch{% if currentVersion == "free-pro-team@latest" %} por padrão{% endif %}. Você pode habilitar outras configurações de proteção de branch. Para obter informações, consulte "[Definir a possibilidade de mesclagem de pull requests](/github/administering-a-repository/defining-the-mergeability-of-pull-requests)". +Ao criar uma regra de proteção de branch em um repositório, os colaboradores não podem fazer push forçado no branch protegido ou excluir o branch{% if currentVersion == "free-pro-team@latest" %} por padrão{% endif %}. Você pode habilitar outras configurações de proteção de branch. Para obter informações, consulte "[Definir a possibilidade de mesclagem de pull requests](/github/administering-a-repository/defining-the-mergeability-of-pull-requests)". ### Leia mais diff --git a/translations/pt-BR/content/github/administering-a-repository/about-releases.md b/translations/pt-BR/content/github/administering-a-repository/about-releases.md index f8a4951ef7cd..e64c3b6cd3b8 100644 --- a/translations/pt-BR/content/github/administering-a-repository/about-releases.md +++ b/translations/pt-BR/content/github/administering-a-repository/about-releases.md @@ -20,12 +20,13 @@ Versões são iterações de software implementáveis que você pode empacotar e As versões se baseiam em [tags Git](https://git-scm.com/book/en/Git-Basics-Tagging), que marcam um ponto específico no histórico do seu repositório. Uma data de tag pode ser diferente de uma data de versão, já que elas podem ser criadas em momentos diferentes. Para obter mais informações sobre como visualizar as tags existentes, consulte "[Visualizar tags e versões do seu repositório](/github/administering-a-repository/viewing-your-repositorys-releases-and-tags)". -Você pode receber notificações quando novas versões são publicadas em um repositório sem receber notificações sobre outras atualizações para o repositório. Para obter mais informações, consulte {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[Visualizando suas assinaturas](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions){% else %}"[Inspecionando e desinspecionando versões para um repositório](/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-releases-for-a-repository){% endif %}." +Você pode receber notificações quando novas versões são publicadas em um repositório sem receber notificações sobre outras atualizações para o repositório. Para obter mais informações, consulte {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 0" %}"[Visualizar as suas assinaturas](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions){% else %}"[Inspecionar e não inspecionar as versões de um repositório](/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-releases-for-a-repository){% endif %}." Qualquer pessoa com acesso de leitura a um repositório pode ver e comparar versões, mas somente pessoas com permissões de gravação a um repositório podem gerenciar versões. Para obter mais informações, consulte "[Gerenciando versões em um repositório](/github/administering-a-repository/managing-releases-in-a-repository)." {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -Pessoas com permissões de administrador para um repositório podem escolher se objetos {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) estão incluídos nos arquivos ZIP e tarballs que {% data variables.product.product_name %} cria para cada versão. Para obter mais informações, consulte " +Pessoas com permissões de administrador para um repositório podem escolher se +{% data variables.large_files.product_name_long %} os objetos de ({% data variables.large_files.product_name_short %}) estão incluídos nos arquivos ZIP e tarballs que {% data variables.product.product_name %} cria para cada versão. Para obter mais informações, consulte " [Gerenciando {% data variables.large_files.product_name_short %} objetos nos arquivos de seu repositório](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)".

    @@ -33,7 +34,9 @@ Pessoas com permissões de administrador para um repositório podem escolher se {% if currentVersion == "free-pro-team@latest" %} -Se uma versão consertar uma vulnerabilidade de segurança, você deverá publicar uma consultoria de segurança no seu repositório. {% data variables.product.prodname_dotcom %} revisa cada consultoria de segurança publicada e pode usá-la para enviar alertas de {% data variables.product.prodname_dependabot_short %} para repositórios afetados. Para obter mais informações, consulte "[Sobre as consultorias de segurança do GitHub](/github/managing-security-vulnerabilities/about-github-security-advisories)." +Se uma versão consertar uma vulnerabilidade de segurança, você deverá publicar uma consultoria de segurança no seu repositório. + +{% data variables.product.prodname_dotcom %} revisa cada consultoria de segurança publicada e pode usá-la para enviar alertas de {% data variables.product.prodname_dependabot_short %} para repositórios afetados. Para obter mais informações, consulte "[Sobre as consultorias de segurança do GitHub](/github/managing-security-vulnerabilities/about-github-security-advisories)." Você pode visualizar a aba **Dependentes** do gráfico de dependências para ver quais repositórios e pacotes dependem do código no repositório e pode, portanto, ser afetado por uma nova versão. Para obter mais informações, consulte "[Sobre o gráfico de dependência](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)". diff --git a/translations/pt-BR/content/github/administering-a-repository/about-required-commit-signing.md b/translations/pt-BR/content/github/administering-a-repository/about-required-commit-signing.md index f3da4260d754..1caf99d276bf 100644 --- a/translations/pt-BR/content/github/administering-a-repository/about-required-commit-signing.md +++ b/translations/pt-BR/content/github/administering-a-repository/about-required-commit-signing.md @@ -11,9 +11,9 @@ versions: Se você aplicou proteções de branch no repositório, será possível configurar a assinatura de commit obrigatória. Para obter mais informações, consulte "[Configurar branches protegidos](/articles/configuring-protected-branches/)". -Ao habilitar a assinatura de commit obrigatória em um branch, os colaboradores {% if currentVersion == "free-pro-team@latest" %}e bots{% endif %} podem somente fazer push de commits que estiverem assinados e verificados ao branch. Para obter mais informações, consulte "[Sobre verificação de assinatura commit](/articles/about-commit-signature-verification)". +Ao habilitar o login de commit necessário em um branch, os contribuidores de {% if currentVersion == "free-pro-team@latest" %}e bots{% endif %} só podem fazer push de commits que foram assinados e verificados no branch. Para obter mais informações, consulte "[Sobre verificação de assinatura commit](/articles/about-commit-signature-verification)". -Você sempre pode fazer push de commits locais para o branch se os commits forem assinados e verificados. {% if currentVersion == "free-pro-team@latest" %}Você também pode mesclar commits assinados e verificados no branch usando uma pull request no {% data variables.product.product_name %}. No entanto, você não pode combinar por squash e fazer o merge de uma pull request no branch em {% data variables.product.product_name %}, a menos que você seja o autor da pull request.{% else %} No entanto, você não pode mesclar as pull requests no branch no {% data variables.product.product_name %}.{% endif %} Você pode {% if currentVersion == "free-pro-team@latest" %}combinar por squash e {% endif %}merge pull requests localmente. Para obter mais informações, consulte "[Verificando pull requests localmente](/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally).{% if currentVersion == "free-pro-team@latest" %} Para obter mais informações sobre os métodos de merge, consulte "[Sobre métodos de merge no {% data variables.product.prodname_dotcom %}](/github/administering-a-repository/about-merge-methods-on-github)."{% endif %} +Você sempre pode fazer push de commits locais para o branch se os commits forem assinados e verificados. {% if currentVersion == "free-pro-team@latest" %}Você também pode fazer merge de commits assinados e verificados no branch usando um pull request em {% data variables.product.product_name %}. No entanto, você não pode realizar a combinação por squash e fazer o merge de um pull request no branch em {% data variables.product.product_name %} a menos que você seja o autor do pull request.{% else %}No entanto, você não pode fazer merge de pull requests no branch em {% data variables.product.product_name %}.{% endif %} Você pode {% if currentVersion == "free-pro-team@latest" %}fazer combinação por squash e {% endif %} fazer merge de pull requests localmente. Para obter mais informações, consulte "[Verificar de pull requests localmente](/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally). {% if currentVersion == "free-pro-team@latest" %} Para obter mais informações sobre métodos de merge, consulte "[Sobre métodos de merge em {% data variables.product.prodname_dotcom %}](/github/administering-a-repository/about-merge-methods-on-github).{% endif %} {% note %} diff --git a/translations/pt-BR/content/github/administering-a-repository/changing-the-default-branch.md b/translations/pt-BR/content/github/administering-a-repository/changing-the-default-branch.md new file mode 100644 index 000000000000..81cf6a09a378 --- /dev/null +++ b/translations/pt-BR/content/github/administering-a-repository/changing-the-default-branch.md @@ -0,0 +1,53 @@ +--- +title: Alterar o branch-padrão +intro: 'Se você tiver mais de um branch no seu repositório, você poderá configurar qualquer branch como o branch-padrão.' +permissions: Pessoas com permissões de administrador em um repositório podem alterar o branch-padrão do repositório. +versions: + free-pro-team: '*' + enterprise-server: '*' +redirect_from: + - /github/administering-a-repository/setting-the-default-branch + - /articles/setting-the-default-branch +--- + +### Sobre mudar o branch-padrão + +Você pode escolher o branch-padrão para um repositório. O branch-padrão é o branch de base para pull requests e commits de código. Para obter mais informações sobre o branch padrão, consulte "[Sobre branches](/github/collaborating-with-issues-and-pull-requests/about-branches#about-the-default-branch)". + +{% note %} + +**Observação**: Se você usar a ponte Git-Subversion, a alteração do branch-padrão afetará o conteúdo do seu `trunk` e o `HEAD` que você visualiza ao listar referências para o repositório remoto. Para obter mais informações, consulte "[Suporte para clientes do Subversion](/github/importing-your-projects-to-github/support-for-subversion-clients)" e [git-ls-remote](https://git-scm.com/docs/git-ls-remote.html) na documentação do Git. + +{% endnote %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} + +{% data reusables.branches.set-default-branch %} + +{% endif %} + +### Pré-requisitos + +Para alterar o branch-padrão, seu repositório deve ter mais de um branch. Para obter mais informações, consulte "[Criar e excluir branches em seu repositório](/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository#creating-a-branch)". + +### Alterar o branch-padrão + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.repository-branches %} +1. Em "branch-padrão", à direita do nome do branch-padrão, clique em {% octicon "arrow-switch" aria-label="The switch icon with two arrows" %}. ![Alterne o ícone com duas setas para a direita do nome do branch-padrão atual](/assets/images/help/repository/repository-options-defaultbranch-change.png) +1. Use o menu suspenso e clique em um nome de branch. ![Menu suspenso para escolher o novo branch-padrão](/assets/images/help/repository/repository-options-defaultbranch-drop-down.png) +1. Clique em **Atualizar**. ![Botão "Atualizar" após escolher um novo branch-padrão](/assets/images/help/repository/repository-options-defaultbranch-update.png) +1. Leia o alerta e clique em **Eu entendo. Atualize o branch-padrão.** ![Botão "Atualizar" após escolher um novo branch-padrão](/assets/images/help/repository/repository-options-defaultbranch-i-understand.png) + +{% else %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.repository-branches %} +1. No menu suspenso do branch-padrão, selecione o novo branch-padrão. ![Seletor suspenso de branch padrão](/assets/images/help/repository/repository-options-defaultbranch.png) +1. Clique em **Atualizar**. + +{% endif %} diff --git a/translations/pt-BR/content/github/administering-a-repository/classifying-your-repository-with-topics.md b/translations/pt-BR/content/github/administering-a-repository/classifying-your-repository-with-topics.md index df42d6dfb6fe..1adf59df661f 100644 --- a/translations/pt-BR/content/github/administering-a-repository/classifying-your-repository-with-topics.md +++ b/translations/pt-BR/content/github/administering-a-repository/classifying-your-repository-with-topics.md @@ -1,6 +1,6 @@ --- -title: Classificar repositório com tópicos -intro: 'Para ajudar outras pessoas a encontrar seu projeto e a contribuir com ele, você pode adicionar tópicos ao repositório relacionados à intenção do projeto, área de assunto, grupos de afinidade ou outras características importantes.' +title: Classifying your repository with topics +intro: 'To help other people find and contribute to your project, you can add topics to your repository related to your project''s intended purpose, subject area, affinity groups, or other important qualities.' redirect_from: - /articles/about-topics/ - /articles/classifying-your-repository-with-topics @@ -9,30 +9,36 @@ versions: enterprise-server: '*' --- -### Sobre tópicos +### About topics -Com tópicos, você pode explorar repositórios em uma área de assunto específica, encontrar projetos com os quais contribuir e descobrir novas soluções para um problema específico. Os tópicos aparecem na página principal de um repositório. É possível clicar no nome de um tópico para {% if currentVersion == "free-pro-team@latest" %}ver tópicos relacionados e uma lista de outros repositórios classificados com esse tópico{% else %}pesquisar outros repositórios com esse tópico{% endif %}. +With topics, you can explore repositories in a particular subject area, find projects to contribute to, and discover new solutions to a specific problem. Topics appear on the main page of a repository. You can click a topic name to {% if currentVersion == "free-pro-team@latest" %}see related topics and a list of other repositories classified with that topic{% else %}search for other repositories with that topic{% endif %}. -![Página principal do repositório de teste mostrando tópicos](/assets/images/help/repository/os-repo-with-topics.png) +![Main page of the test repository showing topics](/assets/images/help/repository/os-repo-with-topics.png) -Para procurar os tópicos mais usados, vá para https://github.com/topics/. +To browse the most used topics, go to https://github.com/topics/. -{% if currentVersion == "free-pro-team@latest" %}Você pode contribuir com o conjunto de tópicos apresentados do {% data variables.product.product_name %} no repositório [github/explore](https://github.com/github/explore). {% endif %} +{% if currentVersion == "free-pro-team@latest" %}You can contribute to {% data variables.product.product_name %}'s set of featured topics in the [github/explore](https://github.com/github/explore) repository. {% endif %} -Os administradores de repositório podem adicionar qualquer tópico que desejarem a um repositório. Os tópicos úteis para classificar um repositório incluem a finalidade pretendida do repositório, área de assunto, comunidade ou linguagem.{% if currentVersion == "free-pro-team@latest" %}Além disso, o {% data variables.product.product_name %} analisa o conteúdo do repositório público e gera tópicos sugeridos que os administradores de repositório podem aceitar ou rejeitar. O conteúdo do repositório privado não é analisado e não recebe sugestões de tópico.{% endif %} +Repository admins can add any topics they'd like to a repository. Helpful topics to classify a repository include the repository's intended purpose, subject area, community, or language.{% if currentVersion == "free-pro-team@latest" %} Additionally, {% data variables.product.product_name %} analyzes public repository content and generates suggested topics that repository admins can accept or reject. Private repository content is not analyzed and does not receive topic suggestions.{% endif %} -Os repositórios públicos e privados podem ter tópicos, embora você veja apenas repositórios privados aos quais tem acesso nos resultados da pesquisa do tópico. +Public and private repositories can have topics, although you will only see private repositories that you have access to in topic search results. -Você pode pesquisar repositórios que são associados a um tópico específico. Para obter mais informações, consulte "[Pesquisar repositórios](/articles/searching-for-repositories#search-by-topic)". Também é possível pesquisar uma lista de tópicos no {% data variables.product.product_name %}. Para obter mais informações, consulte "[Pesquisar tópicos](/articles/searching-topics)". +You can search for repositories that are associated with a particular topic. For more information, see "[Searching for repositories](/articles/searching-for-repositories#search-by-topic)." You can also search for a list of topics on {% data variables.product.product_name %}. For more information, see "[Searching topics](/articles/searching-topics)." -### Adicionar tópicos ao repositório +### Adding topics to your repository {% data reusables.repositories.navigate-to-repo %}{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %} -2. Abaixo da descrição do repositório, clique em **Add topics** (Adicionar tópicos). ![Adicionar link de tópicos na página principal de um repositório](/assets/images/help/repository/add-topics-link.png) -3. Digite o tópico que deseja adicionar ao repositório e digite um espaço. ![Formulário para inserir tópicos](/assets/images/help/repository/add-topic-form.png) -4. Depois que acabar de adicionar tópicos, clique em **Done** (Concluído). ![Formulário com uma lista de tópicos e botão Done (Concluído)](/assets/images/help/repository/add-topics-done-button.png) +2. Under your repository description, click **Add topics**. + ![Add topics link on a repository's main page](/assets/images/help/repository/add-topics-link.png) +3. Type the topic you want to add to your repository, then type a space. + ![Form to enter topics](/assets/images/help/repository/add-topic-form.png) +4. After you've finished adding topics, click **Done**. + ![Form with a list of topics and Done button](/assets/images/help/repository/add-topics-done-button.png) {% else %} -2. À direita de "Sobre", clique em {% octicon "gear" aria-label="The Gear icon" %}. ![Ícone de engrenagem na página principal de um repositório](/assets/images/help/repository/edit-repository-details-gear.png) -3. Em "Tópicos", digite o tópico que você deseja adicionar ao seu repositório e, em seguida, digite um espaço. ![Formulário para inserir tópicos](/assets/images/help/repository/add-topic-form.png) -4. Depois que acabar de adicionar tópicos, clique em **Salvar alterações**. ![Botão de "Salvar alterações" em "Editar detalhes do repositório"](/assets/images/help/repository/edit-repository-details-save-changes-button.png) +2. To the right of "About", click {% octicon "gear" aria-label="The Gear icon" %}. + ![Gear icon on main page of a repository](/assets/images/help/repository/edit-repository-details-gear.png) +3. Under "Topics", type the topic you want to add to your repository, then type a space. + ![Form to enter topics](/assets/images/help/repository/add-topic-form.png) +4. After you've finished adding topics, click **Save changes**. + !["Save changes" button in "Edit repository details"](/assets/images/help/repository/edit-repository-details-save-changes-button.png) {% endif %} diff --git a/translations/pt-BR/content/github/administering-a-repository/configuration-options-for-dependency-updates.md b/translations/pt-BR/content/github/administering-a-repository/configuration-options-for-dependency-updates.md index 6fdd18807750..a54314f5da61 100644 --- a/translations/pt-BR/content/github/administering-a-repository/configuration-options-for-dependency-updates.md +++ b/translations/pt-BR/content/github/administering-a-repository/configuration-options-for-dependency-updates.md @@ -37,13 +37,14 @@ O arquivo *dependabot.yml* deve começar com `versão: 2` seguido por uma série | [`schedule.time`](#scheduletime) | | Hora do dia para procurar atualizações (hh:mm) | | [`schedule.timezone`](#scheduletimezone) | | Fuso horário para hora do dia (identificador de zona) | | [`target-branch`](#target-branch) | | Branch para criar pull requests contra | +| [`vendor`](#vendor) | | Atualizar dependências de vendor ou armazenadas em cache | | [`versioning-strategy`](#versioning-strategy) | | Como atualizar os requisitos da versão do manifesto | Estas opções se encaixam, geralmente, nas seguintes categorias. - Opções de configuração essenciais que você deve incluir em todas as configurações: [`package-ecosystem`](#package-ecosystem), [`directory`](#directory),[`schedule.interval`](#scheduleinterval). - Opções para personalizar o agendamento da atualização: [`schedule.time`](#scheduletime), [`schedule.timezone`](#scheduletimezone), [`schedule.day`](#scheduleday). -- Opções para controlar quais dependências são atualizadas: [`allow`](#allow), [`ignore`](#ignore). +- Opções para controlar quais dependências são atualizadas: [`allow`](#allow), [`ignore`](#ignore), [`vendor`](#vendor). - Opções para adicionar metadata a pull requests: [`reviewers`](#reviewers), [`assignees`](#assignees), [`labels`](#labels), [`milestone`](#milestone). - Opções para alterar o comportamento dos pull requests: [`target-branch`](#target-branch), [`versioning-strategy`](#versioning-strategy), [`commit-message`](#commit-message), [`rebase-strategy`](#rebase-strategy), [`pull-request-branch-name.separator`](#pull-request-branch-nameseparator). @@ -61,7 +62,7 @@ Em geral, as atualizações de segurança usam quaisquer opções de configuraç ### `package-ecosystem` -**Obrigatório** Você adiciona um elemento `package-ecosystem` para cada gerenciador de pacotes que você deseja que {% data variables.product.prodname_dependabot %} monitore para novas versões. O repositório também deve conter um manifesto de dependência ou um arquivo de bloqueio de cada um desses gerentes de pacotes. +**Obrigatório** Você adiciona um elemento de `package-ecosystem` para cada gerenciador de pacotes que você deseja que {% data variables.product.prodname_dependabot_short %} monitore para novas versões. O repositório também deve conter um manifesto de dependência ou um arquivo de bloqueio para cada um desses gerenciadores de pacotes. Se você quiser habilitar o vendoring para um gerente de pacotes com o qual é compatível, as dependências do vendor devem estar localizadas no diretório necessário. Para obter mais informações, consulte o [`vendor`](#vendor) abaixo. {% data reusables.dependabot.supported-package-managers %} @@ -307,7 +308,7 @@ atualizações: {% note %} -O {% data variables.product.prodname_dependabot_version_updates %} não pode executar atualizações de versão para quaisquer dependências no manifesto que contém dependências do Git privadas ou registros Git privados, mesmo se você adicionar as dependências privadas à opção de `ignorar` do seu arquivo de configuração. Para obter mais informações, consulte "[Sobre o {% data variables.product.prodname_dependabot_version_updates %}](/github/administering-a-repository/about-github-dependabot#supported-repositories-and-ecosystems)". +**Observação**: {% data variables.product.prodname_dependabot_version_updates %} não pode executar atualizações de versão para nenhuma dependência no manifesto que contém dependências do git privadas ou registros do git privados, mesmo que você adicione as dependências privadas à opção `ignorar` do seu arquivo de configuração. Para obter mais informações, consulte "[Sobre o {% data variables.product.prodname_dependabot_version_updates %}](/github/administering-a-repository/about-github-dependabot#supported-repositories-and-ecosystems)". {% endnote %} @@ -540,6 +541,31 @@ updates: - "npm dependencies" ``` +### `vendor` + +Use a opção `vendor` para dizer {% data variables.product.prodname_dependabot_short %} para dependências de vendor ao atualizá-las. + +{% note %} + +Atualmente, {% data variables.product.prodname_dependabot_short %} é compatível apenas com as dependências de vendoring para o Bundler. + +{% endnote %} + +```yaml +# Configure version updates for both dependencies defined in manifests and vendored dependencies + +version: 2 +updates: + - package-ecosystem: "bundler" + # Raise pull requests to update vendored dependencies that are checked in to the repository + vendor: true + directory: "/" + schedule: + interval: "weekly" +``` + +{% data variables.product.prodname_dependabot_short %} atualiza apenas as dependências de vendor localizadas em diretórios específicos em um repositório. Para o Bundler, as dependências devem estar no diretório _vendor/cache_. Outros caminhos de arquivo não são compatíveis. Para obter mais informações, consulte a documentação [`cache do bundle`](https://bundler.io/man/bundle-cache.1.html). + ### `versioning-strategy` Quando {% data variables.product.prodname_dependabot %} edita um arquivo arquivo manifesto para atualizar uma versão, ele usa as seguintes estratégias globais: diff --git a/translations/pt-BR/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md b/translations/pt-BR/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md index fba54eae3df8..fae95022e37c 100644 --- a/translations/pt-BR/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md +++ b/translations/pt-BR/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md @@ -6,10 +6,10 @@ redirect_from: - /articles/configuring-autolinks-to-reference-external-resources versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- -Qualquer pessoa com permissão de administrador em um repositório pode configurar referências de link automático para vincular problemas, pull requests,{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} mensagens de commit, descrições e versões{% else %} e mensagens de commit{% endif %} para serviços externos de terceiros. +Qualquer pessoa com permissões de administrador para um repositório pode configurar referências de link automático para vincular problemas, pull requests{% if currentVersion == "free-pro-team@latest" ou currentVersion ver_gt "enterprise-server@2. 1" %} mensagens de commit e descrições de versão{% else %} e mensagens de commit{% endif %} para serviços externos de terceiros. Se você usa o Zendesk para acompanhar tíquetes relatados pelo usuário, por exemplo, é possível fazer referência a um número de tíquete na pull request que você abre para corrigir o problema. diff --git a/translations/pt-BR/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md b/translations/pt-BR/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md new file mode 100644 index 000000000000..36eea5c0d420 --- /dev/null +++ b/translations/pt-BR/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md @@ -0,0 +1,18 @@ +--- +title: Configurar o período de retenção para artefatos e registros do GitHub Actions no seu repositório +intro: 'Você pode configurar o período de retenção para artefatos e registros de {% data variables.product.prodname_actions %} no seu repositório.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.23' +--- + +{% data reusables.actions.about-artifact-log-retention %} + +Você também pode definir um período de retenção personalizado para um artefato específico criado por um fluxo de trabalho. Para obter mais informações, consulte "[Definir o período de retenção para um artefato](/actions/managing-workflow-runs/removing-workflow-artifacts#setting-the-retention-period-for-an-artifact)". + +## Definir o período de retenção para um repositório + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.settings-sidebar-actions %} +{% data reusables.github-actions.change-retention-period-for-artifacts-logs %} diff --git a/translations/pt-BR/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md b/translations/pt-BR/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md index 1d35f2b547dd..d81ba96e1605 100644 --- a/translations/pt-BR/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md +++ b/translations/pt-BR/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md @@ -5,7 +5,7 @@ redirect_from: - /articles/customizing-your-repositorys-social-media-preview versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- Até você adicionar uma imagem, os links de repositório se expandem para mostrar informações básicas sobre o repositório e o avatar do proprietário. Adicionar uma imagem ao repositório ajuda a identificar seu projeto em várias plataformas sociais. diff --git a/translations/pt-BR/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md b/translations/pt-BR/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md index b7ab1f202a04..242c01fbb778 100644 --- a/translations/pt-BR/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md +++ b/translations/pt-BR/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md @@ -35,6 +35,5 @@ Você pode excluir um branch que esteja associado a uma pull request se a pull r ### Leia mais -- "[Criar e excluir branches dentro do seu repositório](/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository)"{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} +- "[Criar e excluir branches dentro do seu repositório](/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository)" - "[Gerenciando a exclusão automática de branches](/github/administering-a-repository/managing-the-automatic-deletion-of-branches)" -{% endif %} diff --git a/translations/pt-BR/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md b/translations/pt-BR/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md index ee3289b60aa0..1fbefd369a80 100644 --- a/translations/pt-BR/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md +++ b/translations/pt-BR/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md @@ -17,11 +17,13 @@ versions: Como alternativa, você pode habilitar o {% data variables.product.prodname_actions %} em seu repositório, mas limitar as ações que um fluxo de trabalho pode ser executado. {% data reusables.github-actions.enabled-local-github-actions %} +{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.23" %} + ### Gerenciando as permissões do {% data variables.product.prodname_actions %} para o seu repositório {% note %} -**Nota:** Talvez você não seja capaz de gerenciar essas configurações se sua organização tem uma política de substituição ou é gerenciada por uma conta corporativa que tem uma política de substituição. Para mais informações, consulte "[Desabilitando ou limitando {% data variables.product.prodname_actions %} para sua organização](/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization)" ou "[Forçando políticas do {% data variables.product.prodname_actions %} na sua conta corporativa](/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account)". +**Nota:** Talvez você não seja capaz de gerenciar essas configurações se sua organização tem uma política de substituição ou é gerenciada por uma conta corporativa que tem uma política de substituição. Para obter mais informações, consulte "[Desabilitar ou limitar {% data variables.product.prodname_actions %} para a sua organização](/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization)" ou {% if currentVersion == "free-pro-team@latest" %}"[Aplicar políticas de {% data variables.product.prodname_actions %} na sua conta corporativa](/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account). {% else if currentVersion ver_gt "enterprise-server@2.21"%}"[Aplicar políticas de {% data variables.product.prodname_actions %} para a sua empresa](/enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise)."{% endif %} {% endnote %} @@ -30,6 +32,41 @@ Como alternativa, você pode habilitar o {% data variables.product.prodname_acti {% data reusables.repositories.settings-sidebar-actions %} 4. Em "Permissões do Actions", selecione uma opção. ![Habilitar, desabilitar ou limitar ações para este repositório](/assets/images/help/repository/enable-repo-actions.png) +{% endif %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} + +### Gerenciando as permissões do {% data variables.product.prodname_actions %} para o seu repositório + +É possível desabilitar todos os fluxos de trabalho para um repositório ou definir uma política que configura quais ações podem ser usadas em um repositório. + +{% data reusables.actions.actions-use-policy-settings %} + +{% note %} + +**Nota:** Talvez você não seja capaz de gerenciar essas configurações se sua organização tem uma política de substituição ou é gerenciada por uma conta corporativa que tem uma política de substituição. Para mais informações, consulte "[Desabilitar ou limitar {% data variables.product.prodname_actions %} para a sua organização](/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization)" ou {% if currentVersion == "free-pro-team@latest" %}"[Aplicar políticas de {% data variables.product.prodname_actions %} na sua conta corporativa](/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account). {% else if currentVersion ver_gt "enterprise-server@2.21" %}"[Aplicar políticas de {% data variables.product.prodname_actions %} para a sua empresa](/enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise)." + +{% endif %} + +{% endnote %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.settings-sidebar-actions %} +1. Em **Permissões de ações**, selecione uma opção. ![Definir política de ações para esta organização](/assets/images/help/repository/actions-policy.png) +1. Clique em **Salvar**. + +### Permitir a execução de ações específicas + +{% data reusables.actions.allow-specific-actions-intro %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.settings-sidebar-actions %} +1. Em **Permissões de ações**, selecione **Permitir ações específicas** e adicione as suas ações necessárias à lista. ![Adicionar ações para permitir lista](/assets/images/help/repository/actions-policy-allow-list.png) +2. Clique em **Salvar**. +{% endif %} + {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} ### Habilitar fluxos de trabalho para bifurcações privadas do repositório diff --git a/translations/pt-BR/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md b/translations/pt-BR/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md index 43df06d5a34d..5c7711ba16b4 100644 --- a/translations/pt-BR/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md +++ b/translations/pt-BR/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md @@ -14,18 +14,18 @@ Para configurar o botão de patrocinador, edite um arquivo _FUNDING.yml_ na past Você pode adicionar um nome de usuário, de pacote ou de projeto por plataforma de financiamento externa e até quatro URLs personalizadas. Você pode adicionar até quatro organizações ou desenvolvedores patrocinados no {% data variables.product.prodname_sponsors %}. Adicione cada plataforma em uma nova linha, usando a seguinte sintaxe: -| Plataforma | Sintaxe | -| ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | -| [CommunityBridge](https://communitybridge.org) | `community_bridge: PROJECT-NAME` | +| Plataforma | Sintaxe | +| ----------------------------------------------------------------------------- | ------------------------------------------------------------------------ | +| [CommunityBridge](https://communitybridge.org) | `community_bridge: PROJECT-NAME` | | [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors) | `github: USERNAME` or `github: [USERNAME, USERNAME, USERNAME, USERNAME]` | -| [IssueHunt](https://issuehunt.io/) | `issuehunt: USERNAME` | -| [Ko-fi](https://ko-fi.com/) | `ko_fi: USERNAME` | -| [Liberapay](https://en.liberapay.com/) | `liberapay: USERNAME` | -| [Open Collective](https://opencollective.com/) | `open_collective: USERNAME` | -| [Otechie](https://otechie.com/) | `otechie: USERNAME` | -| [Patreon](https://www.patreon.com/) | `patreon: USERNAME` | -| [Tidelift](https://tidelift.com/) | `tidelift: PLATFORM-NAME/PACKAGE-NAME` | -| URL personalizado | `custom: LINK1` ou `custom: [LINK1, LINK2, LINK3, LINK4]` | +| [IssueHunt](https://issuehunt.io/) | `issuehunt: USERNAME` | +| [Ko-fi](https://ko-fi.com/) | `ko_fi: USERNAME` | +| [Liberapay](https://en.liberapay.com/) | `liberapay: USERNAME` | +| [Open Collective](https://opencollective.com/) | `open_collective: USERNAME` | +| [Otechie](https://otechie.com/) | `otechie: USERNAME` | +| [Patreon](https://www.patreon.com/) | `patreon: USERNAME` | +| [Tidelift](https://tidelift.com/) | `tidelift: PLATFORM-NAME/PACKAGE-NAME` | +| URL personalizado | `custom: LINK1` ou `custom: [LINK1, LINK2, LINK3, LINK4]` | Em Tidelift, use a sintaxe `platform-name/package-name` com os seguintes nomes de plataforma: diff --git a/translations/pt-BR/content/github/administering-a-repository/enabling-and-disabling-version-updates.md b/translations/pt-BR/content/github/administering-a-repository/enabling-and-disabling-version-updates.md index 2daee06ffcf2..5ac90261d4bd 100644 --- a/translations/pt-BR/content/github/administering-a-repository/enabling-and-disabling-version-updates.md +++ b/translations/pt-BR/content/github/administering-a-repository/enabling-and-disabling-version-updates.md @@ -14,7 +14,7 @@ Você habilita {% data variables.product.prodname_dependabot_version_updates %}, {% data reusables.dependabot.initial-updates %} Para obter mais informações, consulte "[Personalizar atualizações de dependência](/github/administering-a-repository/customizing-dependency-updates)". -### Habilitar o {% data variables.product.prodname_dependabot_version_updates %} +### Habilitar {% data variables.product.prodname_dependabot_version_updates %} {% note %} diff --git a/translations/pt-BR/content/github/administering-a-repository/enabling-branch-restrictions.md b/translations/pt-BR/content/github/administering-a-repository/enabling-branch-restrictions.md index b14ed77a94e1..334b3d53e599 100644 --- a/translations/pt-BR/content/github/administering-a-repository/enabling-branch-restrictions.md +++ b/translations/pt-BR/content/github/administering-a-repository/enabling-branch-restrictions.md @@ -1,6 +1,6 @@ --- title: Habilitar restrições de branch -intro: 'Você pode impor restrições de branch para que apenas determinados usuários{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %} ou{% endif %} equipes{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, ou apps{% endif %} possam fazer push em um branch protegido em repositórios de propriedade de sua organização.' +intro: 'Você pode aplicar restrições de branch para que apenas determinados usuários{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 8" %},{% else %} ou{% endif %} equipes{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 8" %} ou aplicativos{% endif %} possam fazer push em um branch protegido em repositórios pertencentes à sua organização.' product: '{% data reusables.gated-features.branch-restrictions %}' redirect_from: - /articles/enabling-branch-restrictions @@ -19,7 +19,7 @@ Qualquer pessoa com permissões de administrador em um repositório organization {% data reusables.repositories.add-branch-protection-rules %} {% data reusables.repositories.include-administrators %} 6. Em "Proteger os branches correspondentes", selecione **Restringir quem pode fazer push em branches correspondentes**. ![Caixa de seleção Branch restriction (Restrição de branch)](/assets/images/help/repository/restrict-branch.png) -8. Pesquise e selecione as pessoas{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %} ou{% endif %} equipes{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} ou apps{% endif %} que terão permissão para fazer push no branch protegido. ![Pesquisa de restrição de branch](/assets/images/help/repository/restrict-branch-search.png) +8. Procurar e selecionar pessoas, equipes ou aplicativos que tenham permissão para fazer push para o branch protegido. ![Pesquisa de restrição de branch](/assets/images/help/repository/restrict-branch-search.png) 9. Clique em **Criar**. ### Leia mais diff --git a/translations/pt-BR/content/github/administering-a-repository/enabling-force-pushes-to-a-protected-branch.md b/translations/pt-BR/content/github/administering-a-repository/enabling-force-pushes-to-a-protected-branch.md index 05fef5de7026..3cb9b4f7ebf3 100644 --- a/translations/pt-BR/content/github/administering-a-repository/enabling-force-pushes-to-a-protected-branch.md +++ b/translations/pt-BR/content/github/administering-a-repository/enabling-force-pushes-to-a-protected-branch.md @@ -1,31 +1,32 @@ --- -title: Habilitar push forçado para um branch protegido -intro: Você pode permitir push forçado em um branch protegido. +title: Enabling force pushes to a protected branch +intro: You can allow force pushes to a protected branch. product: '{% data reusables.gated-features.protected-branches %}' versions: free-pro-team: '*' enterprise-server: '>=2.20' --- -Qualquer pessoa com permissões de administrador em um repositório pode habilitar push forçado. +Anyone with admin permissions to a repository can enable force pushes. -### Sobre push forçado para branches protegidos +### About force pushes to protected branches -Por padrão, pushes forçados são bloqueados em todos os branches protegidos. Quando você habilitar push forçado em um branch protegido, qualquer pessoa com, pelo menos, permissões de gravação no repositório pode forçar o push ao branch, incluindo aqueles com permissões de administrador. +By default, force pushes are blocked on all protected branches. When you enable force pushes to a protected branch, anyone with at least write permissions to the repository can force push to the branch, including those with admin permissions. -Habilitar push forçado não irá substituir quaisquer outras regras de proteção de branch. Por exemplo, se um branch exigir um histórico de commit linear, você não poderá forçar commits a mesclar commits para esse branch. +Enabling force pushes will not override any other branch protection rules. For example, if a branch requires a linear commit history, you cannot force push merge commits to that branch. -{% if currentVersion != "free-pro-team@latest" %}Você não pode habilitar pushes forçados para um branch protegido se um administrador do site bloquear push forçados para todos os branches do seu repositório. Para obter mais informações, consulte "[Bloqueando push forçado para repositórios de propriedade de uma conta de usuário ou organização](/enterprise/{{ currentVersion }}/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization)." +{% if currentVersion != "free-pro-team@latest" %}You cannot enable force pushes for a protected branch if a site administrator has blocked force pushes to all branches in your repository. For more information, see "[Blocking force pushes to repositories owned by a user account or organization](/enterprise/{{ currentVersion }}/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization)." -Se um administrador do site bloquear pushes forçados apenas para o branch padrão, você ainda pode habilitar pushes forçados para qualquer outro branch protegido.{% endif %} +If a site administrator has blocked force pushes to the default branch only, you can still enable force pushes for any other protected branch.{% endif %} {% data reusables.repositories.protected-branches-options %} -### Habilitando pushes forçados +### Enabling force pushes {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.repositories.repository-branches %} {% data reusables.repositories.add-branch-protection-rules %} -6. Em "Regras aplicadas a todos incluindo administradores", selecione **Permitir pushes forçados**. ![Permitir opção push forçado](/assets/images/help/repository/allow-force-pushes.png) -7. Clique em **Criar**. +6. Under "Rules applied to everyone including administrators", select **Allow force pushes**. +![Allow force pushes option](/assets/images/help/repository/allow-force-pushes.png) +7. Click **Create**. diff --git a/translations/pt-BR/content/github/administering-a-repository/index.md b/translations/pt-BR/content/github/administering-a-repository/index.md index fc0eeb96cadb..75e575261776 100644 --- a/translations/pt-BR/content/github/administering-a-repository/index.md +++ b/translations/pt-BR/content/github/administering-a-repository/index.md @@ -27,6 +27,7 @@ versions: {% link_in_list /managing-the-forking-policy-for-your-repository %} + {% link_in_list /configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository %} {% link_in_list /disabling-or-limiting-github-actions-for-a-repository %} {% link_in_list /managing-git-lfs-objects-in-archives-of-your-repository %} {% link_in_list /enabling-anonymous-git-read-access-for-a-repository %} @@ -41,8 +42,8 @@ versions: {% link_in_list /restoring-a-deleted-repository %} {% topic_link_in_list /managing-branches-in-your-repository %} - {% link_in_list /setting-the-default-branch %} {% link_in_list /viewing-branches-in-your-repository %} + {% link_in_list /changing-the-default-branch %} {% link_in_list /deleting-and-restoring-branches-in-a-pull-request %} {% topic_link_in_list /configuring-pull-request-merges %} {% link_in_list /about-merge-methods-on-github %} diff --git a/translations/pt-BR/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot.md b/translations/pt-BR/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot.md index 0ff392e9962a..a31259c2b851 100644 --- a/translations/pt-BR/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot.md +++ b/translations/pt-BR/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot.md @@ -9,7 +9,7 @@ versions: ### Sobre {% data variables.product.prodname_dependabot_version_updates %} para ações -Ações são frequentemente atualizadas com correções de bugs e novos recursos para tornar os processos automatizados mais confiáveis, mais rápidos e mais seguros. Quando você habilitar {% data variables.product.prodname_dependabot_version_updates %} para {% data variables.product.prodname_actions %}, o {% data variables.product.prodname_dependabot %} ajudará a garantir que referências a ações em um arquivo *workflow.yml* de um repositório são mantidas atualizadas. Para cada ação no arquivo, {% data variables.product.prodname_dependabot_short %} verifica a referência da ação (tipicamente, um número de versão ou identificador de commit associado à ação) em relação à versão mais recente. Se uma versão mais recente da ação estiver disponível, o {% data variables.product.prodname_dependabot_short %} enviará para você uma pull request que atualizará a referência no arquivo de fluxo de trabalho para a versão mais recente. Para obter mais informações sobre o {% data variables.product.prodname_dependabot_version_updates %}, consulte "[Sobre {% data variables.product.prodname_dependabot_version_updates %}](/github/administering-a-repository/about-github-dependabot-version-updates)". Para obter informações sobre a configuração de fluxos de trabalho para {% data variables.product.prodname_actions %}, consulte "[Configurar um fluxo de trabalho](/actions/configuring-and-managing-workflows/configuring-a-workflow)." +Ações são frequentemente atualizadas com correções de bugs e novos recursos para tornar os processos automatizados mais confiáveis, mais rápidos e mais seguros. Quando você habilitar {% data variables.product.prodname_dependabot_version_updates %} para {% data variables.product.prodname_actions %}, o {% data variables.product.prodname_dependabot %} ajudará a garantir que referências a ações em um arquivo *workflow.yml* de um repositório são mantidas atualizadas. Para cada ação no arquivo, {% data variables.product.prodname_dependabot_short %} verifica a referência da ação (tipicamente, um número de versão ou identificador de commit associado à ação) em relação à versão mais recente. Se uma versão mais recente da ação estiver disponível, o {% data variables.product.prodname_dependabot_short %} enviará para você uma pull request que atualizará a referência no arquivo de fluxo de trabalho para a versão mais recente. Para obter mais informações sobre o {% data variables.product.prodname_dependabot_version_updates %}, consulte "[Sobre {% data variables.product.prodname_dependabot_version_updates %}](/github/administering-a-repository/about-github-dependabot-version-updates)". Para obter mais informações sobre a configuração dos fluxos de trabalho para {% data variables.product.prodname_actions %}, consulte "[Aprender {% data variables.product.prodname_actions %}](/actions/learn-github-actions)". ### Habilitando {% data variables.product.prodname_dependabot_version_updates %} para ações diff --git a/translations/pt-BR/content/github/administering-a-repository/managing-releases-in-a-repository.md b/translations/pt-BR/content/github/administering-a-repository/managing-releases-in-a-repository.md index c130e1fea38c..26edf78ce91e 100644 --- a/translations/pt-BR/content/github/administering-a-repository/managing-releases-in-a-repository.md +++ b/translations/pt-BR/content/github/administering-a-repository/managing-releases-in-a-repository.md @@ -16,10 +16,11 @@ versions: ### Sobre o gerenciamento da versão -Você também pode publicar uma ação de uma versão específica em {% data variables.product.prodname_marketplace %}. Para obter mais informações, consulte "[Publicar uma ação no {% data variables.product.prodname_marketplace %}](/actions/creating-actions/publishing-actions-in-github-marketplace)" +Você também pode publicar uma ação de uma versão específica em {% data variables.product.prodname_marketplace %}. Para obter mais informações, consulte "Publicar uma ação no {% data variables.product.prodname_marketplace %}" {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -Você pode escolher se objetos {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) estão incluídos nos arquivos ZIP e tarballs que {% data variables.product.product_name %} cria para cada versão. Para obter mais informações, consulte " +Você pode escolher se +{% data variables.large_files.product_name_long %} os objetos de ({% data variables.large_files.product_name_short %}) estão incluídos nos arquivos ZIP e tarballs que {% data variables.product.product_name %} cria para cada versão. Para obter mais informações, consulte " [Gerenciando {% data variables.large_files.product_name_short %} objetos nos arquivos de seu repositório](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)".

    {% endif %} @@ -62,7 +63,7 @@ Você pode escolher se objetos {% data variables.large_files.product_name_long % 9. Se estiver pronto para tornar pública a sua versão, clique em **Publish release** (Publicar versão). Para trabalhar na versão posteriormente, clique em **Save draft** (Salvar rascunho). ![Botões Publish release (Publicar versão) e Draft release (Rascunhar versão)](/assets/images/help/releases/release_buttons.png) -Você também pode criar automaticamente uma versão a partir da linha de comando ou em um script. Para obter mais informações, consulte "[Versões](/v3/repos/releases/#create-a-release)". +Você também pode criar automaticamente uma versão a partir da linha de comando ou em um script. Para obter mais informações, consulte "[Versões](/rest/reference/repos/#create-a-release)". diff --git a/translations/pt-BR/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md b/translations/pt-BR/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md index f607ec4da365..36de0a960c33 100644 --- a/translations/pt-BR/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md +++ b/translations/pt-BR/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md @@ -5,7 +5,7 @@ redirect_from: - /articles/managing-the-automatic-deletion-of-branches versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- Qualquer pessoa com permissões de administrador em um repositório pode habilitar ou desabilitar a exclusão automática de branches. diff --git a/translations/pt-BR/content/github/administering-a-repository/managing-the-forking-policy-for-your-repository.md b/translations/pt-BR/content/github/administering-a-repository/managing-the-forking-policy-for-your-repository.md index f55d92ff6b22..64d67b9a3c40 100644 --- a/translations/pt-BR/content/github/administering-a-repository/managing-the-forking-policy-for-your-repository.md +++ b/translations/pt-BR/content/github/administering-a-repository/managing-the-forking-policy-for-your-repository.md @@ -1,6 +1,6 @@ --- title: Gerenciando a política de bifurcação para seu repositório -intro: 'Você pode permitir ou impedir a bifurcação de um repositório privado específico{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} ou interno{% endif %} pertencente a uma organização.' +intro: 'Você pode permitir ou impedir a bifurcação de um repositório privado{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 9" %} ou interno específicos{% endif %} pertencente a uma organização.' redirect_from: - /articles/allowing-people-to-fork-a-private-repository-owned-by-your-organization - /github/administering-a-repository/allowing-people-to-fork-a-private-repository-owned-by-your-organization @@ -10,7 +10,7 @@ versions: enterprise-server: '*' --- -Um proprietário de organização deve permitir bifurcações de repositórios privados{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} e internos{% endif %} no nível da organização antes que você possa permitir ou impedir bifurcações de um repositório específico. Para obter mais informações, consulte "[Gerenciando a política de bifurcação para sua organização](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization)". +Um proprietário da organização deve permitir bifurcações dos repositórios privados{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 9" %} e ou internos{% endif %} no nível da organização antes de permitir ou não permitir bifurcações em um repositório específico. Para obter mais informações, consulte "[Gerenciando a política de bifurcação para sua organização](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization)". {% data reusables.organizations.internal-repos-enterprise %} diff --git a/translations/pt-BR/content/github/administering-a-repository/setting-repository-visibility.md b/translations/pt-BR/content/github/administering-a-repository/setting-repository-visibility.md index 3ce9df24d797..17a75233fbbc 100644 --- a/translations/pt-BR/content/github/administering-a-repository/setting-repository-visibility.md +++ b/translations/pt-BR/content/github/administering-a-repository/setting-repository-visibility.md @@ -19,16 +19,16 @@ Recomendamos revisar as seguintes advertências antes de alterar a visibilidade #### Tornar um repositório privado - * O {% data variables.product.prodname_dotcom %} destacará bifurcações públicas do repositório público e as colocará em uma nova rede. As bifurcações públicas não se tornam privadas. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}Se você alterar a visibilidade de um repositório interno para privado, o {% data variables.product.prodname_dotcom %} removerá bifurcações que pertencem a qualquer usuário sem acesso ao repositório privado recente.{% endif %} Para obter mais informações, consulte "[O que acontece com as bifurcações quando um repositório é excluído ou altera a visibilidade?](/articles/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility#changing-a-public-repository-to-a-private-repository)" + * O {% data variables.product.prodname_dotcom %} destacará bifurcações públicas do repositório público e as colocará em uma nova rede. As bifurcações públicas não se tornam privadas. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 9" %}Se você alterar a visibilidade de um repositório interno para privado, {% data variables.product.prodname_dotcom %} removerá as bifurcações que pertencem a qualquer usuário sem acesso ao repositório privado recente.{% endif %} Para obter mais informações, consulte "[O que acontece com as bifurcações quando um repositório é excluído ou altera a visibilidade?](/articles/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility#changing-a-public-repository-to-a-private-repository)" {% if currentVersion == "free-pro-team@latest" %}* Se você estiver usando {% data variables.product.prodname_free_user %} para contas de usuários ou organizações, alguns recursos não estarão disponíveis no repositório depois que você alterar a visibilidade para privada. {% data reusables.gated-features.more-info %} * Qualquer site publicado do {% data variables.product.prodname_pages %} terá sua publicação cancelada automaticamente. Se você adicionou um domínio personalizado ao site do {% data variables.product.prodname_pages %}, deverá remover ou atualizar os registros de DNS antes de tornar o repositório privado para evitar o risco de uma aquisição de domínio. Para obter mais informações, consulte "[Gerenciar um domínio personalizado para seu site do {% data variables.product.prodname_pages %}](/articles/managing-a-custom-domain-for-your-github-pages-site)". * O {% data variables.product.prodname_dotcom %} não incluirá mais o repositório no {% data variables.product.prodname_archive %}. Para obter mais informações, consulte "[Sobre como arquivar conteúdo e dados no {% data variables.product.prodname_dotcom %}](/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github#about-the-github-archive-program)".{% endif %} - {% if currentVersion != "free-pro-team@latest" %}* Acesso de leitura anônimo do Git não está mais disponível. Para obter mais informações, consulte "[Habilitar acesso de leitura anônimo do Git para um repositório](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)".{% endif %} + {% if currentVersion != "free-pro-team@latest" %}* Anonymous Git read access is no longer available. Para obter mais informações, consulte "[Habilitar acesso de leitura anônimo do Git para um repositório](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)".{% endif %} #### Tornar um repositório público * O {% data variables.product.prodname_dotcom %} irá destacar bifurcações privadas e transformá-las em um repositório privado independente. Para obter mais informações, consulte "[O que acontece com as bifurcações quando um repositório é excluído ou muda de visibilidade?](/articles/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility#changing-a-private-repository-to-a-public-repository)" - * Se você estiver convertendo seu repositório privado em um repositório público como parte de um movimento para a criação de um projeto de código aberto, consulte os [Guias de código aberto](http://opensource.guide) para obter diretrizes e dicas úteis.{% if currentVersion == "free-pro-team@latest" %} Você também pode fazer um curso grátis sobre gerenciamento de projeto de Projeto com o [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}). Quando seu repositório é público, você também pode visualizar o perfil da comunidade do repositório para ver se os projetos atendem às práticas recomendadas de suporte aos contribuidores. Para obter mais informações, consulte "[Exibir o perfil da comunidade](/articles/viewing-your-community-profile)."{% endif %} + * Se você estiver convertendo seu repositório privado em um repositório público, como parte de um movimento para a criação de um projeto de código aberto, consulte os [Guias de Código Aberto](http://opensource.guide) para obter dicas e diretrizes úteis.{% if currentVersion == "free-pro-team@latest" %} Você também pode fazer um curso grátis sobre como gerenciar um projeto de código aberto com [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}). Quando seu repositório é público, você também pode visualizar o perfil da comunidade do repositório para ver se os projetos atendem às práticas recomendadas de suporte aos contribuidores. Para obter mais informações, consulte "[Exibir o perfil da comunidade](/articles/viewing-your-community-profile)."{% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} diff --git a/translations/pt-BR/content/github/administering-a-repository/transferring-a-repository.md b/translations/pt-BR/content/github/administering-a-repository/transferring-a-repository.md index ab6bc1f7f400..d2982a3eca52 100644 --- a/translations/pt-BR/content/github/administering-a-repository/transferring-a-repository.md +++ b/translations/pt-BR/content/github/administering-a-repository/transferring-a-repository.md @@ -21,14 +21,14 @@ versions: Quando você transfere um repositório para um novo proprietário, ele pode administrar imediatamente o conteúdo do repositório, além de problemas, pull requests, versões, quadros de projeto e configurações. -Pré-requisitos para transferências de repositório: {% if currentVersion == "free-pro-team@latest" %} +Pré-requisitos para as transferências de repositórios: {% if currentVersion == "free-pro-team@latest" %} - Quando você transfere um repositório que possui para outra conta de usuário, o novo proprietário recebe um e-mail de confirmação. O e-mail de confirmação inclui instruções para aceitar a transferência. Se o novo proprietário não aceitar a transferência em um dia, o convite vai expirar.{% endif %} - Para transferir um repositório que você possui para uma organização, é preciso ter permissão para criar um repositório na organização de destino. - A conta de destino não deve ter um repositório com o mesmo nome ou uma bifurcação na mesma rede. - O proprietário original do repositório é adicionado como colaborador no repositório transferido. Os outros colaboradores do repositório transferido permanecem intactos. - Bifurcações privadas não podem ser transferidas. -{% if currentVersion == "free-pro-team@latest" %}Se você transferir um repositório privado para uma conta de usuário ou organização {% data variables.product.prodname_free_user %}, o repositório perderá o acesso a recursos como branches protegidos e {% data variables.product.prodname_pages %}. {% data reusables.gated-features.more-info %}{% endif %} +{% if currentVersion == "free-pro-team@latest" %}Se você transferir um repositório privado para uma conta de usuário ou organização de {% data variables.product.prodname_free_user %} o repositório perderá acesso a recursos como branches protegidos e {% data variables.product.prodname_pages %}. {% data reusables.gated-features.more-info %}{% endif %} #### O que é transferido com um repositório? @@ -36,7 +36,7 @@ Quando você transfere um repositório, também são transferidos problemas, pul - Se o repositório transferido for uma bifurcação, continuará associado ao repositório upstream. - Se o repositório transferido tiver alguma bifurcação, ela permanecerá associada ao repositório depois que a transferência for concluída. -- Se o repositório transferido usar {% data variables.large_files.product_name_long %}, todos os objetos {% data variables.large_files.product_name_short %} serão automaticamente movidos. Como essa transferência ocorre em segundo plano, a transferência poderá demorar algum tempo se você tiver um grande número de objetos {% data variables.large_files.product_name_short %} ou se os objetos {% data variables.large_files.product_name_short %} em si forem grandes.{% if currentVersion == "free-pro-team@latest" %} Antes de transferir um repositório que utilize {% data variables.large_files.product_name_short %}, verifique se a conta de recebimento tem pacotes de dados suficientes para armazenar os objetos {% data variables.large_files.product_name_short %} que serão movidos. Para obter mais informações sobre como adicionar armazenamento para contas de usuário, consulte "[Atualizar {% data variables.large_files.product_name_long %}](/articles/upgrading-git-large-file-storage)".{% endif %} +- Se o repositório transferido usar {% data variables.large_files.product_name_long %}, todos os objetos {% data variables.large_files.product_name_short %} serão automaticamente movidos. Esta transferência ocorre em segundo plano. Portanto, se você tiver um número grande de objetos de {% data variables.large_files.product_name_short %} ou se os próprios objetos de {% data variables.large_files.product_name_short %} forem grandes, poderá levar um tempo para que a transferência ocorra.{% if currentVersion == "free-pro-team@latest" %} Antes de transferir um repositório que usa {% data variables.large_files.product_name_short %}, certifique-se de que a conta de recebimento tenha pacotes de dados suficientes para armazenar os objetos de {% data variables.large_files.product_name_short %} para os quais você irá efetuar a transferência. Para obter mais informações sobre como adicionar armazenamento para contas de usuário, consulte "[Atualizar {% data variables.large_files.product_name_long %}](/articles/upgrading-git-large-file-storage)".{% endif %} - Quando um repositório é transferido entre duas contas de usuário, as atribuições de problemas são mantidas intactas. Quando você transfere um repositório de uma conta de usuário para uma organização, os problemas atribuídos a integrantes da organização permanecem intactos, e todos os outros responsáveis por problemas são destituídos. Somente proprietários da organização têm permissão para criar novas atribuições de problemas. Quando você transfere um repositório de uma organização para uma conta de usuário, são mantidos somente os problemas atribuídos ao proprietário do repositório. Todos os outros responsáveis por problemas são removidos. - Se o repositório transferido contiver um site do {% data variables.product.prodname_pages %}, os links para o repositório do Git na web e por meio de atividade do Git serão redirecionados. No entanto, não redirecionamos o {% data variables.product.prodname_pages %} associado ao repositório. - Todos os links para o local do repositório anterior são automaticamente redirecionados para o novo local. Quando você usar `git clone`, `git fetch` ou `git push` em um repositório transferido, esses comandos serão redirecionados para a nova URL ou local do repositório. No entanto, para evitar confusão, recomendamos que qualquer clone local seja atualizado para apontar para a nova URL do repositório. Use `git remote` na linha de comando para fazer isso: @@ -57,7 +57,7 @@ Depois que um repositório for transferido para uma organização, os privilégi É possível transferir seu repositório para qualquer conta de usuário que aceite transferência de repositório. Quando um repositório é transferido entre duas contas de usuário, o proprietário e os colaboradores do repositório original são automaticamente adicionados como colaboradores ao novo repositório. -{% if currentVersion == "free-pro-team@latest" %}Se você publicou um site do {% data variables.product.prodname_pages %} em um repositório privado e adicionou um domínio personalizado, talvez seja conveniente remover ou atualizar seus registros DNS antes de transferir o repositório, para evitar o risco de tomada de controle do domínio. Para obter mais informações, consulte "[Gerenciar um domínio personalizado para seu site do {% data variables.product.prodname_pages %}](/articles/managing-a-custom-domain-for-your-github-pages-site)".{% endif %} +{% if currentVersion == "free-pro-team@latest" %}Se você publicou um site de {% data variables.product.prodname_pages %} em um repositório privado e adicionou um domínio personalizado antes de transferir o repositório, você deverá remover ou atualizar seus registros de DNS para evitar o risco de perda de domínio. Para obter mais informações, consulte "[Gerenciar um domínio personalizado para seu site do {% data variables.product.prodname_pages %}](/articles/managing-a-custom-domain-for-your-github-pages-site)".{% endif %} {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} diff --git a/translations/pt-BR/content/github/administering-a-repository/viewing-deployment-activity-for-your-repository.md b/translations/pt-BR/content/github/administering-a-repository/viewing-deployment-activity-for-your-repository.md index b0c131695380..74702ebea7fb 100644 --- a/translations/pt-BR/content/github/administering-a-repository/viewing-deployment-activity-for-your-repository.md +++ b/translations/pt-BR/content/github/administering-a-repository/viewing-deployment-activity-for-your-repository.md @@ -14,7 +14,7 @@ versions: {% endnote %} -Se o fluxo de trabalho de implantação de um repositório estiver integrado ao {% data variables.product.product_name %} por meio da API de implantações ou de um app do [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace/category/deployment), pessoas com acesso de leitura ao repositório poderão ter uma visão geral de todas as implantações atuais e ver um log de atividades de implantação passadas. Para obter mais informações, consulte "[Deployments](/v3/repos/deployments/)" (Implantações). +Se o fluxo de trabalho de implantação de um repositório estiver integrado ao {% data variables.product.product_name %} por meio da API de implantações ou de um app do [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace/category/deployment), pessoas com acesso de leitura ao repositório poderão ter uma visão geral de todas as implantações atuais e ver um log de atividades de implantação passadas. Para obter mais informações, consulte "[Deployments](/rest/reference/repos#deployments)" (Implantações). Também é possível ver informações de implantação na guia "Conversation" (Conversa) de uma pull request. diff --git a/translations/pt-BR/content/github/authenticating-to-github/about-authentication-to-github.md b/translations/pt-BR/content/github/authenticating-to-github/about-authentication-to-github.md index 832037461370..d24dd35913de 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/about-authentication-to-github.md +++ b/translations/pt-BR/content/github/authenticating-to-github/about-authentication-to-github.md @@ -16,7 +16,6 @@ Você pode acessar seus recursos em {% data variables.product.product_name %} de - Token de acesso de pessoal - Chave SSH - ### Efetuar a autenticação no seu navegador Você pode efetuar a autenticação no {% data variables.product.product_name %} no seu navegador de diferentes formas. @@ -56,4 +55,4 @@ Você pode acessar repositórios no {% data variables.product.product_name %} pe * Você pode trabalhar com todos os repositórios no {% data variables.product.product_name %} por meio de SSH, embora os firewalls e proxys possam se recusar a permitir conexões de SSH. Usar o SSH exige que você gere um par de chave pública/privada de SSH no seu computador local e adicione a chave pública à sua conta de {% data variables.product.product_name %}. Sempre que usar o Git para efetuar a autenticação com {% data variables.product.product_name %}, será solicitado que você digite a senha da sua chave SSH, a menos que você [tenha armazenado a chave](/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent#adding-your-ssh-key-to-the-ssh-agent). Para obter mais informações, consulte "[Gerar uma nova chave SSH e adicioná-la ao ssh-agent](/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)". -{% if currentVersion == "free-pro-team@latest" %}Para usar um token de acesso pessoal ou chave SSH para acessar os recursos que pertencem a uma organização que usa o logon único SAML, você também deve autorizar o token pessoal ou chave SSH. Para obter mais informações consulte "[Autorizar um token de acesso pessoal para usar com logon único SAML](/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on)" ou "[Autorizando uma chave SSH para uso com o logon único SAML](/github/authenticating-to-github/authorizing-an-ssh-key-for-use-with-saml-single-sign-on).{% endif %} +{% if currentVersion == "free-pro-team@latest" %}Para usar um token de acesso pessoal ou chave SSH para acessar recursos pertencentes a uma organização que usa o logon único do SAML, você também deve autorizar o token pessoal ou chave SSH. Para obter mais informações consulte "[Autorizar um token de acesso pessoal para usar com logon único SAML](/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on)" ou "[Autorizando uma chave SSH para uso com o logon único SAML](/github/authenticating-to-github/authorizing-an-ssh-key-for-use-with-saml-single-sign-on).{% endif %} diff --git a/translations/pt-BR/content/github/authenticating-to-github/about-commit-signature-verification.md b/translations/pt-BR/content/github/authenticating-to-github/about-commit-signature-verification.md index de3ce3663426..7ab9b55d75aa 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/about-commit-signature-verification.md +++ b/translations/pt-BR/content/github/authenticating-to-github/about-commit-signature-verification.md @@ -1,6 +1,6 @@ --- title: Sobre a verificação de assinatura de commit -intro: 'Usando GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} ou S/MIME{% endif %}, você pode assinar tags e commits localmente. Esses commits ou tags são marcados como verificados no {% data variables.product.product_name %} para que outras pessoas tenham a segurança de que as alterações vêm de uma fonte confiável.' +intro: 'Usar o GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} ou S/MIME{% endif %}, você pode assinar tags e commits localmente. Esses commits ou tags são marcados como verificados no {% data variables.product.product_name %} para que outras pessoas tenham a segurança de que as alterações vêm de uma fonte confiável.' redirect_from: - /articles/about-gpg-commit-and-tag-signatures/ - /articles/about-gpg/ @@ -22,7 +22,7 @@ Os administradores do repositório podem impor a assinatura de commit obrigatór Você pode conferir o status de verificação de seus commits ou tags assinados no {% data variables.product.product_name %} e ver por que as assinaturas de commit podem não ter sido verificadas. Para obter mais informações, consulte "[Conferir o status de verificação da assinatura de commit ou tag](/articles/checking-your-commit-and-tag-signature-verification-status)". -{% if currentVersion == "free-pro-team@latest" %} {% data variables.product.product_name %} usará automaticamente o GPG para assinar os commits que você fizer usando a interface web do {% data variables.product.product_name %}, exceto quando você faz combinação por squash e mescla pull request do qual você não é o autor. Commits assinados por {% data variables.product.product_name %} terão um status de verificado em {% data variables.product.product_name %}. É possível verificar a assinatura localmente usando a chave pública disponível em https://github.com/web-flow.gpg.{% endif %} +{% if currentVersion == "free-pro-team@latest" %} {% data variables.product.product_name %} usará automaticamente o GPG para assinar commits que você criar usando a interface web do {% data variables.product.product_name %}, exceto quando você faz combinação por squash e merge de um pull request do qual você não é o autor. Commits assinados por {% data variables.product.product_name %} terão um status de verificado em {% data variables.product.product_name %}. É possível verificar a assinatura localmente usando a chave pública disponível em https://github.com/web-flow.gpg.{% endif %} ### Verificação da assinatura de commit GPG @@ -59,8 +59,9 @@ Não é preciso fazer upload da chave pública no {% data variables.product.prod ### Verificação de assinatura para bots Organizações e {% data variables.product.prodname_github_app %}s que exigem assinatura de commit podem usar bots para assinar commits. Se um commit ou uma tag tiver uma assinatura de bot que possa ser verificada de maneira criptográfica, o {% data variables.product.product_name %} marcará o commit ou tag como verificado. +A verificação de assinatura para bots só funcionará se a solicitação for verificada e autenticada como -A verificação de assinatura para bots somente funcionará se a solicitação for verificada e autenticada como o {% data variables.product.prodname_github_app %} ou bot e se não tiver informações de autor personalizadas, informações de committer personalizadas e nenhuma informação de assinatura personalizada, como API de commits. +{% data variables.product.prodname_github_app %} ou bot e não contiver informações de autor personalizadas, informações do committer personalizadas e nenhuma informação de assinatura personalizada, como a API de Commits. {% endif %} ### Leia mais diff --git a/translations/pt-BR/content/github/authenticating-to-github/about-ssh.md b/translations/pt-BR/content/github/authenticating-to-github/about-ssh.md index 52df6a191376..7a8eaa9faa0b 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/about-ssh.md +++ b/translations/pt-BR/content/github/authenticating-to-github/about-ssh.md @@ -10,17 +10,16 @@ versions: Ao configurar o SSH, você vai [gerar uma chave SSH e adicioná-la ao ssh-agent](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) e, em seguida, [adicionar a chave à sua conta do {% data variables.product.product_name %}](/articles/adding-a-new-ssh-key-to-your-github-account). Adicionar a chave SSH ao ssh-agent garante que sua chave SSH tenha uma camada extra de segurança por meio do uso de uma frase secreta. Para obter mais informações, consulte "[Trabalhar com frases secretas da chave SSH](/articles/working-with-ssh-key-passphrases)". -{% if currentVersion == "free-pro-team@latest" %}Para usar sua chave SSH com um repositório pertencente a uma organização que usa SAML de logon único, você precisará autorizá-la primeiro. Para obter mais informações, consulte "[Autorizar uma chave SSH para uso com logon único de SAML](/articles/authorizing-an-ssh-key-for-use-with-saml-single-sign-on)".{% endif %} +{% if currentVersion == "free-pro-team@latest" %}Para usar a sua chave SSH com um repositório pertencente a uma organização que usa o login único SAML, primeiro você precisará autorizá-lo. Para obter mais informações, consulte "[Autorizar uma chave SSH para uso com logon único de SAML](/articles/authorizing-an-ssh-key-for-use-with-saml-single-sign-on)".{% endif %} É recomendável [revisar regularmente sua lista de chaves SSH](/articles/reviewing-your-ssh-keys) e revogar qualquer uma que esteja inválida ou tenha sido comprometida. {% if currentVersion == "free-pro-team@latest" %} -Se você ficou sem usar a chave SSH por um ano, o {% data variables.product.prodname_dotcom %} excluirá automaticamente essa chave SSH inativa como uma medida de segurança. Para obter mais informações, consulte "[Chaves SSH excluídas ou ausentes](/articles/deleted-or-missing-ssh-keys)". +Se você não usou a sua chave SSH por um ano, +{% data variables.product.prodname_dotcom %} irá apagar automaticamente sua chave SSH inativa como uma precaução de segurança. Para obter mais informações, consulte "[Chaves SSH excluídas ou ausentes](/articles/deleted-or-missing-ssh-keys)". {% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} Se for integrante de uma organização que fornece certificados SSH, você poderá usar seu certificado para acessar os repositórios dessa organização, sem adicionar o certificado à sua conta {% data variables.product.product_name %}. Para obter mais informações, consulte "[Sobre autoridades certificadas SSH](/articles/about-ssh-certificate-authorities)". -{% endif %} ### Leia mais diff --git a/translations/pt-BR/content/github/authenticating-to-github/about-two-factor-authentication.md b/translations/pt-BR/content/github/authenticating-to-github/about-two-factor-authentication.md index 79df56555482..b7e30c899ab6 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/about-two-factor-authentication.md +++ b/translations/pt-BR/content/github/authenticating-to-github/about-two-factor-authentication.md @@ -1,6 +1,6 @@ --- title: Sobre a autenticação de dois fatores -intro: 'A autenticação de dois fatores, ou 2FA, é uma camada extra de segurança usada no logon em sites ou apps. Com a 2FA, você tem que entrar com seu nome de usuário e senha e fornecer outra forma de autenticação que apenas você saiba ou tenha acesso.' +intro: '{% data reusables.two_fa.about-2fa %} Com 2FA, você deve efetuar o login com seu nome de usuário e senha e fornecer outra forma de autenticação que você conheça ou tenha acesso.' redirect_from: - /articles/about-two-factor-authentication versions: @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -No {% data variables.product.product_name %}, a segunda forma de autenticação é um código gerado por um aplicativo no seu dispositivo móvel{% if currentVersion == "free-pro-team@latest" %} ou enviado como uma mensagem de texto (SMS){% endif %}. Após habilitação da 2FA, o {% data variables.product.product_name %} gera um código de autenticação sempre que alguém tenta entrar na sua conta do {% data variables.product.product_name %}. A única maneira de alguém entrar na sua conta é se ele souber sua senha e tiver acesso ao código de autenticação no seu telefone. +Por {% data variables.product.product_name %}, a segunda forma de autenticação é um código que é gerado por um aplicativo no dispositivo móvel{% if currentVersion == "free-pro-team@latest" %} ou enviado como mensagem de texto (SMS){% endif %}. Após habilitação da 2FA, o {% data variables.product.product_name %} gera um código de autenticação sempre que alguém tenta entrar na sua conta do {% data variables.product.product_name %}. A única maneira de alguém entrar na sua conta é se ele souber sua senha e tiver acesso ao código de autenticação no seu telefone. {% data reusables.two_fa.after-2fa-add-security-key %} @@ -34,6 +34,6 @@ Para obter mais informações, consulte "[Acessar o {% data variables.product.pr ### Exigir autenticação de dois fatores em sua organização -Os proprietários da organização podem exigir que integrantes da organização{% if currentVersion == "free-pro-team@latest" %}, gerentes de cobrança{% endif %} e colaboradores externos usem a autenticação de dois fatores para proteger suas contas pessoais. Para obter mais informações, consulte "[Exigir autenticação de dois fatores em sua organização](/articles/requiring-two-factor-authentication-in-your-organization)". +Os proprietários da organização podem exigir que os integrantes da organização{% if currentVersion == "free-pro-team@latest" %}, gerentes de cobrança{% endif %} e colaboradores externos usem a autenticação de dois fatores para proteger suas contas pessoais. Para obter mais informações, consulte "[Exigir autenticação de dois fatores em sua organização](/articles/requiring-two-factor-authentication-in-your-organization)". {% data reusables.two_fa.auth_methods_2fa %} diff --git a/translations/pt-BR/content/github/authenticating-to-github/accessing-github-using-two-factor-authentication.md b/translations/pt-BR/content/github/authenticating-to-github/accessing-github-using-two-factor-authentication.md index 336d00d540b9..7d88118af591 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/accessing-github-using-two-factor-authentication.md +++ b/translations/pt-BR/content/github/authenticating-to-github/accessing-github-using-two-factor-authentication.md @@ -15,7 +15,7 @@ Com a autenticação de dois fatores habilitada, você deverá fornecer um códi ### Fornecer um código 2FA ao entrar no site -Depois de entrar no {% data variables.product.product_name %} usando sua senha, será solicitado que você forneça um código de autenticação de {% if currentVersion == "free-pro-team@latest" %}uma mensagem de texto ou{% endif %} do seu app TOTP. +Depois de efetuar a o login em {% data variables.product.product_name %} usando a sua senha, será solicitado que você forneça um código de autenticação de {% if currentVersion == "free-pro-team@latest" %}uma mensagem de texto ou{% endif %} do seu aplicativo TOTP. O {% data variables.product.product_name %} solicitará seu código de autenticação 2FA novamente apenas se você se desconectar, for usar um novo dispositivo ou a sessão expirar. diff --git a/translations/pt-BR/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md b/translations/pt-BR/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md index 19463eb6b0ef..75dc66926230 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md +++ b/translations/pt-BR/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md @@ -78,10 +78,10 @@ Depois de adicionar uma nova chave SSH à sua conta do {% data variables.product ```shell $ sudo apt-get install xclip - # Baixa e instala xclip. Se você não tiver `apt-get`, talvez seja necessário usar outro instalador (como o `yum`) + # Baixa e instala xclip. If you don't have `apt-get`, you might need to use another installer (like `yum`) - $ xclip -sel clip < ~/.ssh/id_rsa.pub - # Copia o conteúdo do arquivo id_rsa.pub na área de transferência + $ xclip -selection clipboard < ~/.ssh/id_rsa.pub + # Copies the contents of the id_rsa.pub file to your clipboard ``` {% tip %} diff --git a/translations/pt-BR/content/github/authenticating-to-github/associating-an-email-with-your-gpg-key.md b/translations/pt-BR/content/github/authenticating-to-github/associating-an-email-with-your-gpg-key.md index e1a3928ac866..553990006334 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/associating-an-email-with-your-gpg-key.md +++ b/translations/pt-BR/content/github/authenticating-to-github/associating-an-email-with-your-gpg-key.md @@ -25,7 +25,7 @@ Se você estiver usando uma chave GPG que corresponda à identidade do committer ```shell $ gpg> adduid ``` -6. Siga as solicitações para fornecer seu nome verdadeiro, endereço de e-mail e quaisquer comentários. Você pode modificar as entradas escolhendo `N`, `C` ou `E`. {% data reusables.gpg.private-email %} {% if currentVersion == "free-pro-team@latest" %} Para obter mais informações, consulte "[Configurar o endereço de e-mail do commit](/articles/setting-your-commit-email-address)."{% endif %} +6. Siga as solicitações para fornecer seu nome verdadeiro, endereço de e-mail e quaisquer comentários. Você pode modificar as entradas escolhendo `N`, `C` ou `E`. {% data reusables.gpg.private-email %} {% if currentVersion == "free-pro-team@latest" %} Para obter mais informações, consulte "[Definir o seu endereço de e-mail de commit](/articles/setting-your-commit-email-address){% endif %} ```shell Real Name: Octocat Email address: octocat@github.com diff --git a/translations/pt-BR/content/github/authenticating-to-github/authorizing-oauth-apps.md b/translations/pt-BR/content/github/authenticating-to-github/authorizing-oauth-apps.md index efe2de56e824..23b0563962e8 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/authorizing-oauth-apps.md +++ b/translations/pt-BR/content/github/authenticating-to-github/authorizing-oauth-apps.md @@ -55,7 +55,7 @@ Os {% data variables.product.prodname_oauth_app %} podem solicitar vários tipos | Implantações | O acesso ao status da implantação permite que os apps determinem se uma implantação foi bem-sucedida em relação a um commit específico para repositórios públicos e privados. Os apps não terão acesso ao seu código. | | Gists | O acesso ao [Gist](https://gist.github.com) permite que os apps leiam ou gravem em seus Gists secretos e públicos. | | Hooks | O acesso aos [webhooks](/webhooks) permite que os apps leiam ou gravem configurações de hook em repositórios que você gerencia. | -| Notificações | O acesso à notificação permite que os apps leiam as notificações do {% data variables.product.product_name %}, como comentários sobre problemas ou pull requests. No entanto, os apps continuam sem poder acessar nada nos repositórios. | +| Notificações | O acesso à notificação permite que os apps leiam as notificações do {% data variables.product.product_name %}, como comentários sobre problemas ou pull requests. No entanto, os apps continuam sem poder acessar nada nos repositórios. | | Organizações e equipes | O acesso às organizações e equipes permite que os apps acessem e gerenciem a associação à organização e à equipe. | | Dados pessoais do usuário | Os dados do usuário incluem informações encontradas no seu perfil de usuário, como nome, endereço de e-mail e localização. | | Repositórios | As informações de repositório incluem os nomes dos contribuidores, os branches que você criou e os arquivos reais dentro do repositório. Os apps podem solicitar acesso para repositórios públicos ou privados em um nível amplo de usuário. | diff --git a/translations/pt-BR/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md b/translations/pt-BR/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md index 5b91c494de7b..c892f772fd61 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md +++ b/translations/pt-BR/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md @@ -20,8 +20,7 @@ versions: 3. Verifique a listagem do diretório para verificar se você já tem uma chave SSH pública. Por padrão, os nomes de arquivo das chaves públicas são um dos seguintes: - *id_rsa.pub* - *id_ecdsa.pub* - - *id_ed25519.pub*{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} - - *id_dsa.pub*{% endif %} + - *id_ed25519.pub* Se você não tiver um par de chaves pública e privada ou não deseja usar algum que esteja disponível para conectar-se a {% data variables.product.product_name %}, [gere uma nova chave SSH](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent). diff --git a/translations/pt-BR/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md b/translations/pt-BR/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md index 6110cf7580b7..279fe69eed83 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md +++ b/translations/pt-BR/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md @@ -11,7 +11,9 @@ versions: ### Confirmar o status de verificação da assinatura do commit -1. No {% data variables.product.product_name %}, navegue até sua pull request. +1. Em + +{% data variables.product.product_name %}, navegue até o seu pull request. {% data reusables.repositories.review-pr-commits %} 3. Ao lado do hash de commit abreviado do seu commit, há uma caixa que mostra se a assinatura do commit foi verificada ou não. ![Commit assinado](/assets/images/help/commits/gpg-signed-commit-verified-without-details.png) 4. Para exibir informações mais detalhadas sobre a assinatura do commit, clique em **Verified** (Verificada) ou **Unverified** (Não verificada). ![Commit assinado verificado](/assets/images/help/commits/gpg-signed-commit_verified_details.png) diff --git a/translations/pt-BR/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md b/translations/pt-BR/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md index ee7652aa98f6..a82112d050f0 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md +++ b/translations/pt-BR/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md @@ -91,7 +91,9 @@ Quando você gera ou recupera um token de recuperação de conta, um evento é a Você pode gerar um token de recuperação de conta e armazená-lo com um provedor de recuperação parceiro. -1. Entre na sua conta do Facebook e retorne para o {% data variables.product.product_name %}. +1. Efetue o login na sua conta do Facebook e volte para + +{% data variables.product.product_name %}. {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.security %} 4. Para gerar um token, em "Recovery tokens" (Tokens de recuperação), clique em **Store new token** (Armazenar novo token). ![Botão para armazenar um novo token de recuperação](/assets/images/help/settings/store-new-recovery-token.png) diff --git a/translations/pt-BR/content/github/authenticating-to-github/configuring-two-factor-authentication.md b/translations/pt-BR/content/github/authenticating-to-github/configuring-two-factor-authentication.md index 84f74a6e5fc3..988df4163155 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/configuring-two-factor-authentication.md +++ b/translations/pt-BR/content/github/authenticating-to-github/configuring-two-factor-authentication.md @@ -11,14 +11,14 @@ versions: enterprise-server: '*' --- -Você pode configurar a autenticação de dois fatores usando um app móvel{% if currentVersion == "free-pro-team@latest" %} ou por mensagem de texto{% endif %}. Também é possível adicionar uma chave de segurança. +Você pode configurar a autenticação de dois fatores usando um aplicativo móvel{% if currentVersion == "free-pro-team@latest" %} ou por meio de mensagem de texto{% endif %}. Também é possível adicionar uma chave de segurança. -É enfaticamente recomendável usar um aplicativo de senhas avulsas por tempo limitado (TOTP, Time-based One-Time Password) para configurar a 2FA.{% if currentVersion == "free-pro-team@latest" %} Os aplicativos TOTP são mais confiáveis que o SMS, especialmente para locais fora dos Estados Unidos.{% endif %} Os apps TOTP aceitam o backup seguro dos seus códigos de autenticação na nuvem e podem ser restaurados caso você perca o acesso ao seu dispositivo. +É altamente recomendável o uso de uma senha de uso único (TOTP) para configurar a 2FA.{% if currentVersion == "free-pro-team@latest" %} Os aplicativos TOTP são mais confiáveis que SMS, especialmente para localidades fora dos Estados Unidos.{% endif %} Os aplicativos TOTP são compatíveis com o backup seguro dos seus códigos de autenticação na nuvem e podem ser restaurados se você perder o acesso ao seu dispositivo. {% warning %} **Aviso:** -- Se você for um integrante{% if currentVersion == "free-pro-team@latest" %}, gerente de cobrança{% endif %} ou colaborador externo de um repositório privado em uma organização que exige a autenticação de dois fatores, será preciso deixar a organização para que seja possível desabilitar a 2FA no {% data variables.product.product_location %}. +- Se você é integrante{% if currentVersion == "free-pro-team@latest" %}, gerente de cobrança,{% endif %} ou colaborador externo de um repositório privado de uma organização que exige autenticação de dois fatores, você deve deixar a organização antes de desativar a 2FA em {% data variables.product.product_location %}. - Ao desabilitar a 2FA, você perderá acesso automaticamente à organização e a qualquer bifurcação privada que tenha dos repositórios privados da organização. Para recuperar o acesso à organização e às bifurcações, reabilite a autenticação de dois fatores e entre em contato com um proprietário da organização. {% endwarning %} @@ -45,7 +45,9 @@ Um aplicativo de senhas avulsas por tempo limitado (TOTP, Time-based One-Time Pa 8. Na página de autenticação de dois fatores, siga um destes procedimentos: - Faça a leitura do código QR com o app do dispositivo móvel. Após a leitura, o app exibirá um código de seis dígitos que pode ser inserido no {% data variables.product.product_name %}. - Se não for possível ler o código QR, clique em **enter this text code** (digite este código de texto) para ver um código que pode ser copiado e inserido manualmente no {% data variables.product.product_name %}. ![Clique para inserir este código](/assets/images/help/2fa/totp-click-enter-code.png) -9. O aplicativo móvel TOTP salva sua conta do {% data variables.product.product_name %} e gera um código de autenticação a cada segundo. Na página de 2FA do {% data variables.product.product_name %}, digite o código e clique em **Enable** (Habilitar). ![Campo para habilitar TOTP](/assets/images/help/2fa/totp-enter-code.png) +9. O aplicativo móvel TOTP salva a sua +conta de {% data variables.product.product_name %} e gera um novo código de autenticação em poucos segundos. Na página de 2FA do {% data variables.product.product_name %}, digite o código e clique em **Enable** (Habilitar). + ![Campo para habilitar TOTP](/assets/images/help/2fa/totp-enter-code.png) {% data reusables.two_fa.test_2fa_immediately %} {% if currentVersion == "free-pro-team@latest" %} @@ -79,32 +81,16 @@ Antes de usar esse método, certifique-se de que é possível receber mensagens Na maioria dos dispositivos e navegadores, você pode usar uma chave de segurança física por USB ou NFC. Alguns navegadores podem usar um leitor de impressões digitais, reconhecimento facial ou senha/PIN no seu dispositivo como chave de segurança. -A autenticação com uma chave de segurança é *uma alternativa* à autenticação com um aplicativo TOTP{% if currentVersion == "free-pro-team@latest" %} ou uma mensagem de texto{% endif %}. Se você perder sua chave de segurança, você poderá usar o código do seu telefone para entrar. +A autenticação com uma chave de segurança é *secundária* para a autenticação com um aplicativo TOTP{% if currentVersion == "free-pro-team@latest" %} ou uma mensagem de texto{% endif %}. Se você perder sua chave de segurança, você poderá usar o código do seu telefone para entrar. -1. Você já deve ter configurado a 2FA usando um app móvel TOTP{% if currentVersion == "free-pro-team@latest" %} ou por SMS{% endif %}. -2. Certifique-se de que você tenha uma -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}chave de segurança compatível com WebAuthn{% else %}FIDO U2F{% endif %} inserida no computador. +1. Você deve ter configurado a 2FA por meio de um aplicativo móvel TOTP{% if currentVersion == "free-pro-team@latest" %} ou por SMS{% endif %}. +2. Certifique-se de que você tem uma chave de segurança compatível com o WebAuthn inserido em seu computador. {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.security %} 5. Ao lado de "Security keys" (Chaves de segurança), clique em **Add** (Adicionar). ![Opção para adicionar chaves de segurança](/assets/images/help/2fa/add-security-keys-option.png) -6. Em "Security keys" (Chaves de segurança), clique em **Register new security key** (Registrar nova chave de segurança). - {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - ![Registrar uma nova chave de segurança](/assets/images/help/2fa/security-key-register.png) - {% else %} - ![Registrar um novo dispositivo FIDO U2F](/assets/images/help/2fa/register_new_fido_u2f_device.png) - {% endif %} -7. Digite um apelido para a chave de segurança e clique em **Add** (Adicionar). - {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - ![Fornecer um apelido para uma chave de segurança](/assets/images/help/2fa/security-key-nickname.png) - {% else %} - ![Fornecer um apelido para um dispositivo FIDO U2F](/assets/images/help/2fa/fido_u2f_nickname.png) - {% endif %} -8. Ative a chave de segurança seguindo as orientações na documentação da sua chave de segurança. - {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - ![Solicitação de chave de segurança](/assets/images/help/2fa/security-key-prompt.png) - {% else %} - ![Solicitação para um dispositivo FIDO U2F](/assets/images/help/2fa/fido_u2f_prompt_key.png) - {% endif %} +6. Em "Security keys" (Chaves de segurança), clique em **Register new security key** (Registrar nova chave de segurança). ![Registrar uma nova chave de segurança](/assets/images/help/2fa/security-key-register.png) +7. Digite um apelido para a chave de segurança e clique em **Add** (Adicionar). ![Fornecer um apelido para uma chave de segurança](/assets/images/help/2fa/security-key-nickname.png) +8. Ative a chave de segurança seguindo as orientações na documentação da sua chave de segurança. ![Solicitação de chave de segurança](/assets/images/help/2fa/security-key-prompt.png) 9. Verifique se você baixou e pode acessar os códigos de recuperação. Se ainda não os baixou ou se deseja gerar outro conjunto de códigos, baixe seus códigos e salve-os em um local seguro. Caso perca o acesso à sua conta, é possível usar os códigos de recuperação para voltar a ela. Para obter mais informações, consulte "[Recuperar sua conta se você perder as credenciais da 2FA](/articles/recovering-your-account-if-you-lose-your-2fa-credentials)". ![Botão para download de códigos de recuperação](/assets/images/help/2fa/2fa-recover-during-setup.png) {% data reusables.two_fa.test_2fa_immediately %} diff --git a/translations/pt-BR/content/github/authenticating-to-github/connecting-with-third-party-applications.md b/translations/pt-BR/content/github/authenticating-to-github/connecting-with-third-party-applications.md index 2cfbfc60b2e9..76700ed5feba 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/connecting-with-third-party-applications.md +++ b/translations/pt-BR/content/github/authenticating-to-github/connecting-with-third-party-applications.md @@ -57,7 +57,7 @@ Há vários tipos de dados que os aplicativos podem solicitar. | Implantações | O acesso ao status da implantação permite que os aplicativos determinem se uma implantação foi bem-sucedida em relação a um commit específico para repositórios públicos e privados. Os aplicativos não terão acesso ao seu código. | | Gists | O acesso ao [Gist](https://gist.github.com) permite que os aplicativos leiam ou gravem em seus Gists secretos e públicos. | | Hooks | O acesso aos [webhooks](/webhooks) permite que os aplicativos leiam ou gravem configurações de hook em repositórios que você gerencia. | -| Notificações | O acesso à notificação permite que os aplicativos leiam as notificações do {% data variables.product.product_name %}, como comentários sobre problemas ou pull requests. No entanto, os aplicativos continuam sem poder acessar nada nos repositórios. | +| Notificações | O acesso à notificação permite que os aplicativos leiam as notificações do {% data variables.product.product_name %}, como comentários sobre problemas ou pull requests. No entanto, os aplicativos continuam sem poder acessar nada nos repositórios. | | Organizações e equipes | O acesso às organizações e equipes permite que os apps acessem e gerenciem a associação à organização e à equipe. | | Dados pessoais do usuário | Os dados do usuário incluem informações encontradas no seu perfil de usuário, como nome, endereço de e-mail e localização. | | Repositórios | As informações de repositório incluem os nomes dos contribuidores, os branches que você criou e os arquivos reais dentro do repositório. Os aplicativos podem solicitar acesso para repositórios públicos ou privados em um nível amplo de usuário. | diff --git a/translations/pt-BR/content/github/authenticating-to-github/creating-a-personal-access-token.md b/translations/pt-BR/content/github/authenticating-to-github/creating-a-personal-access-token.md index b6b5aa237b5f..ba766cb2fd57 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/creating-a-personal-access-token.md +++ b/translations/pt-BR/content/github/authenticating-to-github/creating-a-personal-access-token.md @@ -13,7 +13,7 @@ versions: Os tokens de acesso pessoal (PATs) são uma alternativa para o uso de senhas para autenticação no {% data variables.product.product_name %} ao usar a [API do GitHub](/v3/auth/#via-oauth-and-personal-access-tokens) ou a [linha de comando](#using-a-token-on-the-command-line). -{% if currentVersion == "free-pro-team@latest" %}Se você deseja usar um PAT para acessar recursos que pertencem a uma organização que usa o SAML SSO, você deverá autorizar o PAT. Para mais informações consulte "[Sobre autenticação com logon único SAML](/articles/about-authentication-with-saml-single-sign-on)" e "[Autorizando um token de acesso pessoal para uso com logon único SAML](/articles/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on).{% endif %} +{% if currentVersion == "free-pro-team@latest" %}Se você deseja usar um PAT para acessar recursos pertencentes a uma organização que usa SAML SSO, você deve autorizar o PAT. Para mais informações consulte "[Sobre autenticação com logon único SAML](/articles/about-authentication-with-saml-single-sign-on)" e "[Autorizando um token de acesso pessoal para uso com logon único SAML](/articles/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on).{% endif %} {% if currentVersion == "free-pro-team@latest" %}{% data reusables.user_settings.removes-personal-access-tokens %}{% endif %} @@ -27,7 +27,7 @@ Os tokens de acesso pessoal (PATs) são uma alternativa para o uso de senhas par 5. Dê ao seu token um nome descritivo. ![Campo Token description (Descrição do token)](/assets/images/help/settings/token_description.png) 6. Selecione os escopos, ou as permissões, aos quais deseja conceder esse token. Para usar seu token para acessar repositórios da linha de comando, selecione **repo**. ![Selecionar escopos do token](/assets/images/help/settings/token_scopes.gif) 7. Clique em **Generate token** (Gerar token). ![Botão Generate token (Gerar token)](/assets/images/help/settings/generate_token.png) -8. Clique em {% octicon "clippy" aria-label="The copy to clipboard icon" %} para copiar o token na sua área de transferência. Por motivos de segurança, após sair da página, você não poderá ver o token novamente.{% if currentVersion == "free-pro-team@latest" %} ![Newly created token](/assets/images/help/settings/personal_access_tokens.png){% else %} +8. Clique em {% octicon "clippy" aria-label="The copy to clipboard icon" %} para copiar o token na sua área de transferência. Por motivos de segurança, depois que você sair da página, você não poderá ver o token novamente.{% if currentVersion == "free-pro-team@latest" %} ![Newly created token](/assets/images/help/settings/personal_access_tokens.png){% else %} ![Newly created token](/assets/images/help/settings/personal_access_tokens_ghe.png){% endif %} {% warning %} diff --git a/translations/pt-BR/content/github/authenticating-to-github/disabling-two-factor-authentication-for-your-personal-account.md b/translations/pt-BR/content/github/authenticating-to-github/disabling-two-factor-authentication-for-your-personal-account.md index 90bae8b6b57d..159fd2d0cc46 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/disabling-two-factor-authentication-for-your-personal-account.md +++ b/translations/pt-BR/content/github/authenticating-to-github/disabling-two-factor-authentication-for-your-personal-account.md @@ -12,7 +12,7 @@ versions: {% warning %} -**Aviso:** se você for integrante{% if currentVersion == "free-pro-team@latest" %}, gerente de cobrança{% endif %} ou colaborador externo em um repositório público de uma organização que requeira autenticação de dois fatores e desabilitar a 2FA, será automaticamente removido da organização e perderá acesso aos repositórios. Para recuperar o acesso à organização, torne a habilitar a autenticação de dois fatores e entre em contato com um proprietário da organização. +**Aviso:** Se você é integrante{% if currentVersion == "free-pro-team@latest" %}, gerente de cobrança,{% endif %} ou colaborador externo em um repositório público de uma organização que exige autenticação de dois fatores e você desativa a 2FA, você será automaticamente removido da organização e perderá o acesso aos repositórios. Para recuperar o acesso à organização, torne a habilitar a autenticação de dois fatores e entre em contato com um proprietário da organização. {% endwarning %} diff --git a/translations/pt-BR/content/github/authenticating-to-github/error-bad-file-number.md b/translations/pt-BR/content/github/authenticating-to-github/error-bad-file-number.md index bff876356594..a5648d9c3dfb 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/error-bad-file-number.md +++ b/translations/pt-BR/content/github/authenticating-to-github/error-bad-file-number.md @@ -12,7 +12,7 @@ Ao executar SSH ou comandos do Git remotos, o tempo limite da conexão pode expi ```shell $ ssh -vT git@{% data variables.command_line.codeblock %} -> OpenSSH_5.8p1, OpenSSL 1.0.0d 8 Feb 2011 +> OpenSSH_8.1p1, LibreSSL 2.7.3 > debug1: Connecting to {% data variables.command_line.codeblock %} [207.97.227.239] port 22. > debug1: connect to address 207.97.227.239 port 22: Connection timed out > ssh: connect to host {% data variables.command_line.codeblock %} port 22: Connection timed out diff --git a/translations/pt-BR/content/github/authenticating-to-github/error-permission-denied-publickey.md b/translations/pt-BR/content/github/authenticating-to-github/error-permission-denied-publickey.md index 725798b0e390..75af14ce4136 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/error-permission-denied-publickey.md +++ b/translations/pt-BR/content/github/authenticating-to-github/error-permission-denied-publickey.md @@ -1,6 +1,6 @@ --- -title: 'Erro: permissão negada (publickey)' -intro: Uma mensagem de erro "Permission denied" (permissão negada) indica que o servidor rejeitou a sua conexão. Existem diferentes razões para isso acontecer. Os exemplos mais comuns estão descritos abaixo. +title: 'Error: Permission denied (publickey)' +intro: 'A "Permission denied" error means that the server rejected your connection. There could be several reasons why, and the most common examples are explained below.' redirect_from: - /articles/error-permission-denied-publickey versions: @@ -8,50 +8,50 @@ versions: enterprise-server: '*' --- -### O comando `sudo` deve ser usado com o Git? +### Should the `sudo` command be used with Git? -Você não deve usar o comando `sudo` com o Git. Caso você tenha uma *razão muito boa* para usar `sudo`, assegure-se de usá-lo com todos os comandos (talvez seja melhor usar `su` para obter um shell como root nesse ponto). Se você [gerar chaves SSH](/articles/generating-an-ssh-key) sem `sudo` e depois tentar usar um comando como `sudo git push`, você não estará usando as mesmas chaves que gerou. +You should not be using the `sudo` command with Git. If you have a *very good reason* you must use `sudo`, then ensure you are using it with every command (it's probably just better to use `su` to get a shell as root at that point). If you [generate SSH keys](/articles/generating-an-ssh-key) without `sudo` and then try to use a command like `sudo git push`, you won't be using the same keys that you generated. -### Verifique se está conectado ao servidor correto +### Check that you are connecting to the correct server -Sabemos que digitar é difícil. Preste atenção ao que digita; você não conseguirá se conectar a "githib.com" ou "guthub.com". Em alguns casos, uma rede corporativa também pode causar problemas ao resolver o registro DNS. +Typing is hard, we all know it. Pay attention to what you type; you won't be able to connect to "githib.com" or "guthub.com". In some cases, a corporate network may cause issues resolving the DNS record as well. -Insira o segunte comando para confirmar que está conectado ao domínio correto: +To make sure you are connecting to the right domain, you can enter the following command: ```shell $ ssh -vT git@{% data variables.command_line.codeblock %} -> OpenSSH_5.6p1, OpenSSL 0.9.8r 8 Feb 2011 -> debug1: Lendo dados de configuração /Users/you/.ssh/config -> debug1: Lendo dados de configuração /etc/ssh_config -> debug1: Solicitando opções para * -> debug1: Conectando a {% data variables.command_line.codeblock %} [IP ADDRESS] port 22. +> OpenSSH_8.1p1, LibreSSL 2.7.3 +> debug1: Reading configuration data /Users/you/.ssh/config +> debug1: Reading configuration data /etc/ssh/ssh_config +> debug1: /etc/ssh/ssh_config line 47: Applying options for * +> debug1: Connecting to {% data variables.command_line.codeblock %} port 22. ``` -A conexão deve ser feita na porta 22{% if currentVersion == "free-pro-team@latest" %}, a não ser que você esteja substituindo as configurações para usar [SSH na porta HTTPS](/articles/using-ssh-over-the-https-port){% endif %}. +The connection should be made on port 22{% if currentVersion == "free-pro-team@latest" %}, unless you're overriding settings to use [SSH over HTTPS](/articles/using-ssh-over-the-https-port){% endif %}. -### Sempre utilize o usuário "git" +### Always use the "git" user -Todas as conexões devem ser feitas como usuário "git", inclusive aquelas para URLs remotas. Se você tentar se conectar com o seu {% data variables.product.product_name %} nome de usuário, ocorrerá um erro: +All connections, including those for remote URLs, must be made as the "git" user. If you try to connect with your {% data variables.product.product_name %} username, it will fail: ```shell $ ssh -T GITHUB-USERNAME@{% data variables.command_line.codeblock %} -> Permissão negada (publickey). +> Permission denied (publickey). ``` -Se houver uma falha na conexão ao usar um URL remoto com seu nome de usuário {% data variables.product.product_name %}, você pode [alterar a URL remota para o usuário "git"](/articles/changing-a-remote-s-url/). +If your connection failed and you're using a remote URL with your {% data variables.product.product_name %} username, you can [change the remote URL to use the "git" user](/articles/changing-a-remote-s-url/). -Verifique sua conexão digitando: +You should verify your connection by typing: ```shell $ ssh -T git@{% data variables.command_line.codeblock %} -> Olá username! Você conseguiu se autenticar... +> Hi username! You've successfully authenticated... ``` -### Garanta que você tem uma chave que está em uso +### Make sure you have a key that is being used {% mac %} {% data reusables.command_line.open_the_multi_os_terminal %} -2. Verifique se você tem uma chave privada gerada e carregada em SSH. Se estiver usando OpenSSH 6.7 ou anterior: +2. Verify that you have a private key generated and loaded into SSH. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell # start the ssh-agent in the background $ eval "$(ssh-agent -s)" @@ -60,7 +60,7 @@ $ ssh -T git@{% data variables.command_line.codeblock %} > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` - Se estiver usando OpenSSH 6.8 ou posterior: + If you're using OpenSSH 6.8 or newer: ```shell # start the ssh-agent in the background $ eval "$(ssh-agent -s)" @@ -68,6 +68,14 @@ $ ssh -T git@{% data variables.command_line.codeblock %} $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + # start the ssh-agent in the background + $ eval "$(ssh-agent -s)" + > Agent pid 59566 + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} {% endmac %} @@ -78,24 +86,29 @@ $ ssh -T git@{% data variables.command_line.codeblock %} 1. {% data reusables.desktop.windows_git_bash_turn_on_ssh_agent %} {% data reusables.desktop.windows_git_for_windows_turn_on_ssh_agent %} -2. Verifique se você tem uma chave privada gerada e carregada em SSH. Se estiver usando OpenSSH 6.7 ou anterior: +2. Verify that you have a private key generated and loaded into SSH. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` - Se estiver usando OpenSSH 6.8 ou posterior: + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} {% endwindows %} {% linux %} {% data reusables.command_line.open_the_multi_os_terminal %} -2. Verifique se você tem uma chave privada gerada e carregada em SSH. Se estiver usando OpenSSH 6.7 ou anterior: +2. Verify that you have a private key generated and loaded into SSH. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell # start the ssh-agent in the background $ eval "$(ssh-agent -s)" @@ -104,7 +117,7 @@ $ ssh -T git@{% data variables.command_line.codeblock %} > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` - Se estiver usando OpenSSH 6.8 ou posterior: + If you're using OpenSSH 6.8 or newer: ```shell # start the ssh-agent in the background $ eval "$(ssh-agent -s)" @@ -112,120 +125,138 @@ $ ssh -T git@{% data variables.command_line.codeblock %} $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} + {% endlinux %} -O comando `ssh-add` *deverá* imprimir uma string longa com números e letras. Caso isso não aconteça, você deverá [gerar uma nova chave SSH](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) e associá-la a {% data variables.product.product_name %}. +The `ssh-add` command *should* print out a long string of numbers and letters. If it does not print anything, you will need to [generate a new SSH key](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) and associate it with {% data variables.product.product_name %}. {% tip %} -**Dica**: Na maioria dos sistemas, as chaves privadas padrão (`~/.ssh/id_rsa`{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}, `~/. sh/id_dsa`{% endif %} and `~/.ssh/identity`) são adicionadas automaticamente ao agente de autenticação SSH. Não há necessidade de executar `ssh-add path/to/key`, a não ser que você substitua o nome do arquivo ao gerar uma chave. +**Tip**: On most systems the default private keys (`~/.ssh/id_rsa` and `~/.ssh/identity`) are automatically added to the SSH authentication agent. You shouldn't need to run `ssh-add path/to/key` unless you override the file name when you generate a key. {% endtip %} -#### Obter mais detalhes +#### Getting more details -Você também pode verificar a chave que está sendo usada tentando se conectar a `git@{% data variables.command_line.backticks %}`: +You can also check that the key is being used by trying to connect to `git@{% data variables.command_line.backticks %}`: ```shell $ ssh -vT git@{% data variables.command_line.codeblock %} > ... -> debug1: Arquivo de identificação /Users/you/.ssh/id_rsa type -1 -> debug1: Arquivo de identificação /Users/you/.ssh/id_rsa-cert type -1 -> debug1: Arquivo de identificação /Users/you/.ssh/id_dsa type -1 -> debug1: Arquivo de identificação /Users/you/.ssh/id_dsa-cert type -1 +> debug1: identity file /Users/you/.ssh/id_rsa type -1 +> debug1: identity file /Users/you/.ssh/id_rsa-cert type -1 +> debug1: identity file /Users/you/.ssh/id_dsa type -1 +> debug1: identity file /Users/you/.ssh/id_dsa-cert type -1 > ... -> debug1: Autenticações que podem prosseguir: publickey -> debug1: Próximo método de autenticação: publickey -> debug1: Tentando chave privada: /Users/you/.ssh/id_rsa -> debug1: Tentando chave privada: /Users/you/.ssh/id_dsa -> debug1: Não há mais métodos de autenticação para tentar. -> Permissão negada (publickey). +> debug1: Authentications that can continue: publickey +> debug1: Next authentication method: publickey +> debug1: Trying private key: /Users/you/.ssh/id_rsa +> debug1: Trying private key: /Users/you/.ssh/id_dsa +> debug1: No more authentication methods to try. +> Permission denied (publickey). ``` -Nesse exemplo, não temos nenhuma chave SSH para usar. "-1" ao final das linhas "arquivo de identificação" indica que o SSH não conseguiu encontrar um arquivo para usar. Mais adiante, as linhas "Tentando chave privada" também indicam que o arquivo não foi encontrado. Se existisse um arquivo, as linhas seriam respectivamente "1" e "Apresentando chave pública": +In that example, we did not have any keys for SSH to use. The "-1" at the end of the "identity file" lines means SSH couldn't find a file to use. Later on, the "Trying private key" lines also indicate that no file was found. If a file existed, those lines would be "1" and "Offering public key", respectively: ```shell $ ssh -vT git@{% data variables.command_line.codeblock %} > ... -> debug1: arquivo de identificação /Users/you/.ssh/id_rsa type 1 +> debug1: identity file /Users/you/.ssh/id_rsa type 1 > ... -> debug1: Autenticações que podem prosseguir: publickey -> debug1: Próximo método de autenticação: publickey -> debug1: Apresentando chave pública RSA: /Users/you/.ssh/id_rsa +> debug1: Authentications that can continue: publickey +> debug1: Next authentication method: publickey +> debug1: Offering RSA public key: /Users/you/.ssh/id_rsa ``` -### Verifique se a chave pública está associada à sua conta +### Verify the public key is attached to your account -Forneça sua chave pública a {% data variables.product.product_name %} para estabelecer uma conexão segura. +You must provide your public key to {% data variables.product.product_name %} to establish a secure connection. {% mac %} -1. Abra o terminal. -2. Inicie o SSH agent em segundo plano. +1. Open Terminal. +2. Start SSH agent in the background. ```shell $ eval "$(ssh-agent -s)" > Agent pid 59566 ``` -3. Encontre e anote a impressão digital da chave pública. Se estiver usando OpenSSH 6.7 ou anterior: +3. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` - Se estiver usando OpenSSH 6.8 ou posterior: + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -6. Compare a lista de chaves SSH com a saída do comando `ssh-add`. ![Lista de chaves SSH em {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png) +6. Compare the list of SSH keys with the output from the `ssh-add` command. +![SSH key listing in {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png) {% endmac %} {% windows %} -1. Abra a linha de comando. -2. Inicie o SSH agent em segundo plano. +1. Open the command line. +2. Start SSH agent in the background. ```shell $ ssh-agent -s > Agent pid 59566 ``` -3. Encontre e anote a impressão digital da chave pública. Se estiver usando OpenSSH 6.7 ou anterior: +3. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` - Se estiver usando OpenSSH 6.8 ou posterior: + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -6. Compare a lista de chaves SSH com a saída do comando `ssh-add`. ![Lista de chaves SSH em {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png) +6. Compare the list of SSH keys with the output from the `ssh-add` command. +![SSH key listing in {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png) {% endwindows %} {% linux %} -1. Abra o terminal. -2. Inicie o SSH agent em segundo plano. +1. Open Terminal. +2. Start SSH agent in the background. ```shell $ eval "$(ssh-agent -s)" > Agent pid 59566 ``` -3. Encontre e anote a impressão digital da chave pública. Se estiver usando OpenSSH 6.7 ou anterior: +3. Find and take a note of your public key fingerprint. If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` - Se estiver usando OpenSSH 6.8 ou posterior: + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) @@ -233,14 +264,15 @@ Forneça sua chave pública a {% data variables.product.product_name %} para est {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -6. Compare a lista de chaves SSH com a saída do comando `ssh-add`. ![Lista de chaves SSH em {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png) +6. Compare the list of SSH keys with the output from the `ssh-add` command. +![SSH key listing in {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png) {% endlinux %} -Caso não consiga ver sua chave pública em {% data variables.product.product_name %}, seeá necessário [adicionar a chave SSH a {% data variables.product.product_name %}](/articles/adding-a-new-ssh-key-to-your-github-account) para associá-la ao seu computador. +If you don't see your public key in {% data variables.product.product_name %}, you'll need to [add your SSH key to {% data variables.product.product_name %}](/articles/adding-a-new-ssh-key-to-your-github-account) to associate it with your computer. {% warning %} -**Aviso**: se você encontrar uma chave SSH com a qual não esteja familiarizado em {% data variables.product.product_name %}, delete-a imediatamente e entre em contato com {% data variables.contact.contact_support %} para obter ajuda. Uma chave pública desconhecida pode indicar um possível problema de segurança. Para obter mais informações, consulte "[Revisar as chaves SSH](/articles/reviewing-your-ssh-keys)". +**Warning**: If you see an SSH key you're not familiar with on {% data variables.product.product_name %}, delete it immediately and contact {% data variables.contact.contact_support %}, for further help. An unidentified public key may indicate a possible security concern. For more information, see "[Reviewing your SSH keys](/articles/reviewing-your-ssh-keys)." {% endwarning %} diff --git a/translations/pt-BR/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-userother-repo.md b/translations/pt-BR/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-userother-repo.md index 610f4a6575c6..da113710b00c 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-userother-repo.md +++ b/translations/pt-BR/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-userother-repo.md @@ -1,6 +1,6 @@ --- title: 'Erro: permissão de usuário/repo negada a outro usuário/repo' -intro: O erro indica que a chave inserida está associada a outro repositório como uma chave de implantação e não tem acesso ao repositório que você está tentando entrar. +intro: 'O erro indica que a chave inserida está associada a outro repositório como uma chave de implantação e não tem acesso ao repositório que você está tentando entrar.' redirect_from: - /articles/error-permission-to-user-repo-denied-to-user-other-repo - /articles/error-permission-to-userrepo-denied-to-userother-repo diff --git a/translations/pt-BR/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md b/translations/pt-BR/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md index f803ee3fdb7d..e6e7fb249aea 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md +++ b/translations/pt-BR/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md @@ -10,8 +10,8 @@ versions: Você receberá a seguinte mensagem de erro: ```shell -$ git push -u github.master -> fatal: 'github.master' não parece um repositório git +$ git push -u github.main +> fatal: 'github.main' não parece um repositório git > fatal: A ponta remote desligou inesperadamente $ git pull -u github diff --git a/translations/pt-BR/content/github/authenticating-to-github/generating-a-new-gpg-key.md b/translations/pt-BR/content/github/authenticating-to-github/generating-a-new-gpg-key.md index 724bebf07cdd..fc00e6cf3c79 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/generating-a-new-gpg-key.md +++ b/translations/pt-BR/content/github/authenticating-to-github/generating-a-new-gpg-key.md @@ -14,7 +14,7 @@ versions: {% note %} -**Observação:** antes de gerar uma nova chave GPG, confirme se verificou seu endereço de e-mail. Caso seu endereço de e-mail não tenha sido verificado, você não conseguirá assinar commits e tags com GPG.{% if currentVersion == "free-pro-team@latest" %} Para obter mais informações, consulte "[Verificar seu endereço de e-mail](/articles/verifying-your-email-address)".{% endif %} +**Observação:** antes de gerar uma nova chave GPG, confirme se verificou seu endereço de e-mail. Se você não verificou seu endereço de e-mail, você não conseguirá assinar commits e tags com GPG.{% if currentVersion == "free-pro-team@latest" %} Para obter mais informações, consulte "[Verificar seu endereço de e-mail](/articles/verifying-your-email-address)".{% endif %} {% endnote %} @@ -37,7 +37,7 @@ versions: {% note %} - **Obervação:** quando solicitado a digitar seu endereço de e-mail, confirme que inseriu o endereço de e-mail verificado da sua conta GitHub. {% data reusables.gpg.private-email %} {% if currentVersion == "free-pro-team@latest" %} Para obter mais informações, consulte "[Verificar seu endereço de e-mail](/articles/verifying-your-email-address)" e "[Configurar o commit de seu endereço de e-mail](/articles/setting-your-commit-email-address)".{% endif %} + **Obervação:** quando solicitado a digitar seu endereço de e-mail, confirme que inseriu o endereço de e-mail verificado da sua conta GitHub. {% data reusables.gpg.private-email %} {% if currentVersion == "free-pro-team@latest" %} Para mais informações, consulte "[Verificar seu endereço de e-mail](/articles/verifying-your-email-address)" e "[Definir seu endereço de e-mail do commit](/articles/setting-your-commit-email-address).{% endif %} {% endnote %} diff --git a/translations/pt-BR/content/github/authenticating-to-github/managing-commit-signature-verification.md b/translations/pt-BR/content/github/authenticating-to-github/managing-commit-signature-verification.md index d305d54a02e2..207cb9959029 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/managing-commit-signature-verification.md +++ b/translations/pt-BR/content/github/authenticating-to-github/managing-commit-signature-verification.md @@ -1,6 +1,6 @@ --- title: Gerenciar a verificação de assinatura de commit -intro: 'Você pode assinar localmente seu trabalho usando GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} ou S/MIME{% endif %}. O {% data variables.product.product_name %} verificará essas assinaturas, assim as pessoas saberão que seus commits tem origem em uma fonte confiável.{% if currentVersion == "free-pro-team@latest" %} O {% data variables.product.product_name %} assinará automaticamente os commits que você fez com a interface web do {% data variables.product.product_name %}.{% endif %}' +intro: 'Você pode assinar o seu trabalho localmente usando o GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} ou S/MIME{% endif %}. {% data variables.product.product_name %} irá verificar essas assinaturas para que outras pessoas saibam que seus commits vêm de uma fonte de confiança. {% if currentVersion == "free-pro-team@latest" %} {% data variables.product.product_name %} irá assinar automaticamente os commits que você fizer usando a interface da web.{% data variables.product.product_name %}{% endif %}' redirect_from: - /articles/generating-a-gpg-key/ - /articles/signing-commits-with-gpg/ diff --git a/translations/pt-BR/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md b/translations/pt-BR/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md index 28e859b39586..0b9c55f835de 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md +++ b/translations/pt-BR/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md @@ -81,7 +81,8 @@ Se você não conseguir recuperar o acesso à sua conta, gere uma de uso único 1. No Facebook, acesse [Security Settings](https://www.facebook.com/settings?tab=security) (Configurações de segurança) e clique em **Recover Accounts Elsewhere** (Recuperação de contas em outro lugar). ![Página de configurações de segurança do Facebook com link Recuperação de contas em outro lugar](/assets/images/help/settings/security-facebook-security-settings-page.png) 2. Clique no token de recuperação associado à sua conta {% data variables.product.product_name %}. ![Lista de tokens de recuperação armazenados no Facebook](/assets/images/help/settings/security-github-rae-token-on-facebook.png) 3. Para acessar seu token de recuperação de conta, clique em **Recover This Account** (Recuperar esta conta). Uma nova janela abrirá, retornando ao {% data variables.product.product_name %}. ![Caixa modal com informações sobre seu token de recuperação e botão Recover This Account (Recuperar esta conta)](/assets/images/help/settings/security-recover-account-facebook.png) -4. Entre em contato com o {% data variables.contact.contact_support %} para informá-los que seu token de recuperação de conta está pronto para ser verificado. +4. Contato +{% data variables.contact.contact_support %} para que saibam que o seu token de recuperação de conta está pronto para ser revisado. {% endif %} ### Leia mais diff --git a/translations/pt-BR/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md b/translations/pt-BR/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md index bbf59ca3aad6..697f8f1e69e7 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md +++ b/translations/pt-BR/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md @@ -74,7 +74,7 @@ Para demonstrar como o `git filter-branch` funciona, mostraremos como remover o "git rm --cached --ignore-unmatch PATH-TO-YOUR-FILE-WITH-SENSITIVE-DATA" \ --prune-empty --tag-name-filter cat -- --all > Rewrite 48dc599c80e20527ed902928085e7861e6b3cbe6 (266/266) - > Ref 'refs/heads/master' was rewritten + > Ref 'refs/heads/main' was rewritten ``` {% note %} @@ -89,7 +89,7 @@ Para demonstrar como o `git filter-branch` funciona, mostraremos como remover o $ echo "YOUR-FILE-WITH-SENSITIVE-DATA" >> .gitignore $ git add .gitignore $ git commit -m "Add YOUR-FILE-WITH-SENSITIVE-DATA to .gitignore" - > [master 051452f] Add YOUR-FILE-WITH-SENSITIVE-DATA to .gitignore + > [main 051452f] Add YOUR-FILE-WITH-SENSITIVE-DATA to .gitignore > 1 files changed, 1 insertions(+), 0 deletions(-) ``` 5. Verifique se você removeu todo o conteúdo desejado do histórico do repositório e fez checkout de todos os branches. @@ -102,7 +102,7 @@ Para demonstrar como o `git filter-branch` funciona, mostraremos como remover o > Writing objects: 100% (1058/1058), 148.85 KiB, done. > Total 1058 (delta 590), reused 602 (delta 378) > To https://{% data variables.command_line.codeblock %}/YOUR-USERNAME/YOUR-REPOSITORY.git - > + 48dc599...051452f master -> master (forced update) + > + 48dc599...051452f main -> main (forced update) ``` 7. Para remover o arquivo com dados confidenciais das [versões com tag](/articles/about-releases), você também precisará forçar o push das tags do Git: ```shell @@ -113,7 +113,7 @@ Para demonstrar como o `git filter-branch` funciona, mostraremos como remover o > Writing objects: 100% (321/321), 331.74 KiB | 0 bytes/s, done. > Total 321 (delta 124), reused 269 (delta 108) > To https://{% data variables.command_line.codeblock %}/YOUR-USERNAME/YOUR-REPOSITORY.git - > + 48dc599...051452f master -> master (forced update) + > + 48dc599...051452f main -> main (forced update) ``` 8. Entre em contato com o {% data variables.contact.contact_support %} e solicite a remoção das visualizações em cache e das referências aos dados confidenciais em pull requests no {% data variables.product.product_name %}. 9. Peça para os colaboradores [fazerem rebase](https://git-scm.com/book/en/Git-Branching-Rebasing), *e não* merge, nos branches criados a partir do histórico antigo do repositório. Um commit de merge poderia reintroduzir o histórico antigo completo (ou parte dele) que você acabou de se dar ao trabalho de corrigir. diff --git a/translations/pt-BR/content/github/authenticating-to-github/reviewing-your-security-log.md b/translations/pt-BR/content/github/authenticating-to-github/reviewing-your-security-log.md index 39b4624a5bcf..38e933477191 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/reviewing-your-security-log.md +++ b/translations/pt-BR/content/github/authenticating-to-github/reviewing-your-security-log.md @@ -1,6 +1,6 @@ --- -title: Revisar seus logs de segurança -intro: Você pode revisar o log de segurança da sua conta de usuário para entender melhor as ações que você realizou e ações realizadas por outras pessoas que envolvem você. +title: Reviewing your security log +intro: You can review the security log for your user account to better understand actions you've performed and actions others have performed that involve you. redirect_from: - /articles/reviewing-your-security-log versions: @@ -8,233 +8,238 @@ versions: enterprise-server: '*' --- -### Acessar o log de segurança +### Accessing your security log -O log de segurança lista todas as ações realizadas nos últimos 90 dias{% if currentVersion ver_lt "enterprise-server@2.20" %}, até 50{% endif %}. +The security log lists all actions performed within the last 90 days{% if currentVersion ver_lt "enterprise-server@2.20" %}, up to 50{% endif %}. {% data reusables.user_settings.access_settings %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -2. Na barra lateral de configurações do usuário, clique em **log de segurança**. ![Aba do log de segurança](/assets/images/help/settings/audit-log-tab.png) +2. In the user settings sidebar, click **Security log**. + ![Security log tab](/assets/images/help/settings/audit-log-tab.png) {% else %} {% data reusables.user_settings.security %} -3. O log é exibido em "Security history" (Histórico de segurança). ![Log de segurança](/assets/images/help/settings/user_security_log.png) -4. Clique em uma entrada para ver mais informações sobre o evento. ![Log de segurança](/assets/images/help/settings/user_security_history_action.png) +3. Under "Security history," your log is displayed. + ![Security log](/assets/images/help/settings/user_security_log.png) +4. Click on an entry to see more information about the event. + ![Security log](/assets/images/help/settings/user_security_history_action.png) {% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -### Pesquisar no seu registro de segurança +### Searching your security log {% data reusables.audit_log.audit-log-search %} -#### Pesquisar com base na ação +#### Search based on the action performed {% else %} -### Entender eventos no seu log de segurança - -As ações listadas no seu log de segurança são agrupadas nas categorias a seguir: ^\\{% endif %} -| Nome da categoria | Descrição | -| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" %} -| `account_recovery_token` | Contém todas as atividade relacionadas a [adicionar um token de recuperação](/articles/configuring-two-factor-authentication-recovery-methods). | -| `cobrança` | Contém todas as atividades relacionadas às suas informações de cobrança. | -| `marketplace_agreement_signature` | Contém todas as atividades relacionadas à assinatura do Contrato de desenvolvedor do {% data variables.product.prodname_marketplace %}. | -| `marketplace_listing` | Contém todas as atividades relacionadas aos aplicativos listados no {% data variables.product.prodname_marketplace %}.{% endif %} -| `oauth_access` | Contém todas as atividades relacionadas aos [{% data variables.product.prodname_oauth_app %}s](/articles/authorizing-oauth-apps) com os quais você se conectou.{% if currentVersion == "free-pro-team@latest" %} -| `payment_method` | Contém todas as atividades relacionadas ao pagamento da sua assinatura do {% data variables.product.prodname_dotcom %}.{% endif %} -| `profile_picture` | Contém todas as atividades relacionadas à imagem do seu perfil. | -| `project` | Contém todas as atividades relacionadas aos quadros de projeto. | -| `public_key` | Contém todas as atividades relacionadas às [chaves SSH públicas](/articles/adding-a-new-ssh-key-to-your-github-account). | -| `repo` | Contém todas as atividades relacionadas aos repositórios que você possui.{% if currentVersion == "free-pro-team@latest" %} -| `sponsors` | Contém todos os eventos relacionados ao {% data variables.product.prodname_sponsors %} e botões de patrocinador (consulte "[Sobre {% data variables.product.prodname_sponsors %}](/articles/about-github-sponsors)" e "[Exibir um botão de patrocinador no seu repositório](/articles/displaying-a-sponsor-button-in-your-repository)"){% endif %}{% if currentVersion != "free-pro-team@latest" %} -| `equipe` | Contém todas as atividades relacionadas a equipes das quais você faz parte.{% endif %} -| `two_factor_authentication` | Contém todas as atividades relacionadas à [autenticação de dois fatores](/articles/securing-your-account-with-two-factor-authentication-2fa). | -| `usuário` | Contém todas as atividades relacionadas à sua conta. | - -Uma descrição dos eventos nessas categoria é exibida abaixo. +### Understanding events in your security log + +Actions listed in your security log are grouped within the following categories: +{% endif %} + +| Category Name | Description +|------------------|-------------------{% if currentVersion == "free-pro-team@latest" %} +| `account_recovery_token` | Contains all activities related to [adding a recovery token](/articles/configuring-two-factor-authentication-recovery-methods). +| `billing` | Contains all activities related to your billing information. +| `marketplace_agreement_signature` | Contains all activities related to signing the {% data variables.product.prodname_marketplace %} Developer Agreement. +| `marketplace_listing` | Contains all activities related to listing apps in {% data variables.product.prodname_marketplace %}.{% endif %} +| `oauth_access` | Contains all activities related to [{% data variables.product.prodname_oauth_app %}s](/articles/authorizing-oauth-apps) you've connected with.{% if currentVersion == "free-pro-team@latest" %} +| `payment_method` | Contains all activities related to paying for your {% data variables.product.prodname_dotcom %} subscription.{% endif %} +| `profile_picture` | Contains all activities related to your profile picture. +| `project` | Contains all activities related to project boards. +| `public_key` | Contains all activities related to [your public SSH keys](/articles/adding-a-new-ssh-key-to-your-github-account). +| `repo` | Contains all activities related to the repositories you own.{% if currentVersion == "free-pro-team@latest" %} +| `sponsors` | Contains all events related to {% data variables.product.prodname_sponsors %} and sponsor buttons (see "[About {% data variables.product.prodname_sponsors %}](/articles/about-github-sponsors)" and "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)"){% endif %}{% if currentVersion != "free-pro-team@latest" %} +| `team` | Contains all activities related to teams you are a part of.{% endif %} +| `two_factor_authentication` | Contains all activities related to [two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa). +| `user` | Contains all activities related to your account. + +A description of the events within these categories is listed below. {% if currentVersion == "free-pro-team@latest" %} -#### Categoria `account_recovery_token` +#### The `account_recovery_token` category -| Ação | Descrição | -| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | -| confirm | Acionada quando você [armazena um novo token com um provedor de recuperação](/articles/configuring-two-factor-authentication-recovery-methods). | -| recover | Acionada quando você [resgata um token de recuperação de conta](/articles/recovering-your-account-if-you-lose-your-2fa-credentials). | -| recover_error | Acionada quando um token é usado, mas o {% data variables.product.prodname_dotcom %} não consegue validá-lo. | +| Action | Description +|------------------|------------------- +| confirm | Triggered when you successfully [store a new token with a recovery provider](/articles/configuring-two-factor-authentication-recovery-methods). +| recover | Triggered when you successfully [redeem an account recovery token](/articles/recovering-your-account-if-you-lose-your-2fa-credentials). +| recover_error | Triggered when a token is used but {% data variables.product.prodname_dotcom %} is not able to validate it. -#### Categoria `billing` +#### The `billing` category -| Ação | Descrição | -| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | -| change_billing_type | Acionada quando você [altera o modo de pagamento](/articles/adding-or-editing-a-payment-method) do {% data variables.product.prodname_dotcom %}. | -| change_email | Acionada quando você [altera o endereço de e-mail](/articles/changing-your-primary-email-address). | +| Action | Description +|------------------|------------------- +| change_billing_type | Triggered when you [change how you pay](/articles/adding-or-editing-a-payment-method) for {% data variables.product.prodname_dotcom %}. +| change_email | Triggered when you [change your email address](/articles/changing-your-primary-email-address). -#### Categoria `marketplace_agreement_signature` +#### The `marketplace_agreement_signature` category -| Ação | Descrição | -| ------ | ------------------------------------------------------------------------------------------------------------------ | -| create | Acionada quando você assina o Contrato de desenvolvedor do {% data variables.product.prodname_marketplace %}. | +| Action | Description +|------------------|------------------- +| create | Triggered when you sign the {% data variables.product.prodname_marketplace %} Developer Agreement. -#### Categoria `marketplace_listing` +#### The `marketplace_listing` category -| Ação | Descrição | -| ------- | ----------------------------------------------------------------------------------------------------------------- | -| aprovar | Acionada quando sua lista é aprovada para inclusão no {% data variables.product.prodname_marketplace %}. | -| create | Acionada quando você cria uma lista para seu app no {% data variables.product.prodname_marketplace %}. | -| delist | Acionada quando sua lista é removida do {% data variables.product.prodname_marketplace %}. | -| redraft | Triggered when your listing is sent back to draft state. | -| reject | Acionada quando sua lista não é aprovada para inclusão no {% data variables.product.prodname_marketplace %}. | +| Action | Description +|------------------|------------------- +| approve | Triggered when your listing is approved for inclusion in {% data variables.product.prodname_marketplace %}. +| create | Triggered when you create a listing for your app in {% data variables.product.prodname_marketplace %}. +| delist | Triggered when your listing is removed from {% data variables.product.prodname_marketplace %}. +| redraft | Triggered when your listing is sent back to draft state. +| reject | Triggered when your listing is not accepted for inclusion in {% data variables.product.prodname_marketplace %}. {% endif %} -#### Categoria `oauth_access` +#### The `oauth_access` category -| Ação | Descrição | -| ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| create | Acionada quando você [concede acesso a um {% data variables.product.prodname_oauth_app %}](/articles/authorizing-oauth-apps). | -| destroy | Acionada quando você [revoga o acesso de um {% data variables.product.prodname_oauth_app %}a sua conta](/articles/reviewing-your-authorized-integrations). | +| Action | Description +|------------------|------------------- +| create | Triggered when you [grant access to an {% data variables.product.prodname_oauth_app %}](/articles/authorizing-oauth-apps). +| destroy | Triggered when you [revoke an {% data variables.product.prodname_oauth_app %}'s access to your account](/articles/reviewing-your-authorized-integrations). {% if currentVersion == "free-pro-team@latest" %} -#### Categoria `payment_method` +#### The `payment_method` category -| Ação | Descrição | -| ------ | ---------------------------------------------------------------------------------------------------------- | -| clear | Acionada quando [um método de pagamento](/articles/removing-a-payment-method) registrado é removido. | -| create | Acionada quando um novo método de pagamento, como um novo cartão de crédito ou conta PayPal, é adicionado. | -| update | Acionada quando um método de pagamento é atualizado. | +| Action | Description +|------------------|------------------- +| clear | Triggered when [a payment method](/articles/removing-a-payment-method) on file is removed. +| create | Triggered when a new payment method is added, such as a new credit card or PayPal account. +| update | Triggered when an existing payment method is updated. {% endif %} -#### Categoria `profile_picture` - -| Ação | Descrição | -| ------ | --------------------------------------------------------------------------------------------------------- | -| update | Acionada quando você [configura ou atualiza sua foto do perfil](/articles/setting-your-profile-picture/). | - -#### Categoria `project` - -| Ação | Descrição | -| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------- | -| `create` | Acionada quando um quadro de projeto é criado. | -| `rename` | Acionada quando um quadro de projeto é renomeado. | -| `update` | Acionada quando um quadro de projeto é atualizado. | -| `delete` | Acionada quando um quadro de projeto é excluído. | -| `link` | Acionada quando um repositório é vinculado a um quadro de projeto. | -| `unlink` | Acionada quando um repositório é desvinculado de um quadro de projeto. | -| `project.access` | Acionada quando a visibilidade de um quadro de projeto é alterada. | -| `update_user_permission` | Acionada quando um colaborador externo é adicionado ou removido de um quadro de projeto ou tem seu nível de permissão alterado. | - -#### Categoria `public_key` - -| Ação | Descrição | -| ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| create | Acionada quando você [adiciona uma nova chave SSH pública a sua conta do {% data variables.product.product_name %}](/articles/adding-a-new-ssh-key-to-your-github-account). | -| delete | Acionada quando você [remove uma chave SSH pública da sua conta do {% data variables.product.product_name %}](/articles/reviewing-your-ssh-keys). | - -#### Categoria `repo` - -| Ação | Descrição | -| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| access | Acionada quando um repositório seu é [alterado de "privado" para "público"](/articles/making-a-private-repository-public) (ou vice-versa). | -| add_member | Acionada quando um usuário do {% data variables.product.product_name %} {% if currentVersion == "free-pro-team@latest" %}[é convidado para ter acesso de colaboração](/articles/inviting-collaborators-to-a-personal-repository){% else %}[recebe acesso de colaboração](/articles/inviting-collaborators-to-a-personal-repository){% endif %} em um repositório. | -| add_topic | Acionada quando um proprietário do repositório [adiciona um tópico](/articles/classifying-your-repository-with-topics) a um repositório. | -| archived | Acionada quando um proprietário do repositório [arquiva um repositório](/articles/about-archiving-repositories).{% if currentVersion != "free-pro-team@latest" %} -| config.disable_anonymous_git_access | Acionada quando um [acesso de leitura anônimo do Git é desabilitado](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) em um repositório público. | -| config.enable_anonymous_git_access | Acionada quando um [acesso de leitura anônimo do Git é habilitado](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) em um repositório público. | -| config.lock_anonymous_git_access | Acionada quando a [configuração de acesso de leitura anônimo do Git de um repositório é bloqueada](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access). | -| config.unlock_anonymous_git_access | Acionada quando a [configuração de acesso de leitura anônimo do Git de um repositório é desbloqueada](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access).{% endif %} -| create | Acionada quando [um repositório é criado](/articles/creating-a-new-repository). | -| destroy | Acionada quando [um repositório é excluído](/articles/deleting-a-repository).{% if currentVersion == "free-pro-team@latest" %} -| desabilitar | Acionada quando um repositório é desabilitado (por exemplo, por [recursos financeiros insuficientes](/articles/unlocking-a-locked-account)).{% endif %}{% if currentVersion == "free-pro-team@latest" %} -| habilitar | Acionada quando um repositório é habilitado novamente.{% endif %} -| remove_member | Acionada quando um usuário do {% data variables.product.product_name %} é [removido de um repositório como um colaborador](/articles/removing-a-collaborator-from-a-personal-repository). | -| remove_topic | Acionada quando um proprietário do repositório remove um tópico de um repositório. | -| rename | Acionada quando [um repositório é renomeado](/articles/renaming-a-repository). | -| transferir | Acionada quando [um repositório é transferido](/articles/how-to-transfer-a-repository). | -| transfer_start | Acionada quando uma transferência de repositório está prestes a ocorrer. | -| unarchived | Acionada quando um proprietário do repositório desarquiva um repositório. | +#### The `profile_picture` category + +| Action | Description +|------------------|------------------- +| update | Triggered when you [set or update your profile picture](/articles/setting-your-profile-picture/). + +#### The `project` category + +| Action | Description +|--------------------|--------------------- +| `create` | Triggered when a project board is created. +| `rename` | Triggered when a project board is renamed. +| `update` | Triggered when a project board is updated. +| `delete` | Triggered when a project board is deleted. +| `link` | Triggered when a repository is linked to a project board. +| `unlink` | Triggered when a repository is unlinked from a project board. +| `project.access` | Triggered when a project board's visibility is changed. +| `update_user_permission` | Triggered when an outside collaborator is added to or removed from a project board or has their permission level changed. + +#### The `public_key` category + +| Action | Description +|------------------|------------------- +| create | Triggered when you [add a new public SSH key to your {% data variables.product.product_name %} account](/articles/adding-a-new-ssh-key-to-your-github-account). +| delete | Triggered when you [remove a public SSH key to your {% data variables.product.product_name %} account](/articles/reviewing-your-ssh-keys). + +#### The `repo` category + +| Action | Description +|------------------|------------------- +| access | Triggered when you a repository you own is [switched from "private" to "public"](/articles/making-a-private-repository-public) (or vice versa). +| add_member | Triggered when a {% data variables.product.product_name %} user is {% if currentVersion == "free-pro-team@latest" %}[invited to have collaboration access](/articles/inviting-collaborators-to-a-personal-repository){% else %}[given collaboration access](/articles/inviting-collaborators-to-a-personal-repository){% endif %} to a repository. +| add_topic | Triggered when a repository owner [adds a topic](/articles/classifying-your-repository-with-topics) to a repository. +| archived | Triggered when a repository owner [archives a repository](/articles/about-archiving-repositories).{% if currentVersion != "free-pro-team@latest" %} +| config.disable_anonymous_git_access | Triggered when [anonymous Git read access is disabled](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) in a public repository. +| config.enable_anonymous_git_access | Triggered when [anonymous Git read access is enabled](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) in a public repository. +| config.lock_anonymous_git_access | Triggered when a repository's [anonymous Git read access setting is locked](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access). +| config.unlock_anonymous_git_access | Triggered when a repository's [anonymous Git read access setting is unlocked](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access).{% endif %} +| create | Triggered when [a new repository is created](/articles/creating-a-new-repository). +| destroy | Triggered when [a repository is deleted](/articles/deleting-a-repository).{% if currentVersion == "free-pro-team@latest" %} +| disable | Triggered when a repository is disabled (e.g., for [insufficient funds](/articles/unlocking-a-locked-account)).{% endif %}{% if currentVersion == "free-pro-team@latest" %} +| enable | Triggered when a repository is re-enabled.{% endif %} +| remove_member | Triggered when a {% data variables.product.product_name %} user is [removed from a repository as a collaborator](/articles/removing-a-collaborator-from-a-personal-repository). +| remove_topic | Triggered when a repository owner removes a topic from a repository. +| rename | Triggered when [a repository is renamed](/articles/renaming-a-repository). +| transfer | Triggered when [a repository is transferred](/articles/how-to-transfer-a-repository). +| transfer_start | Triggered when a repository transfer is about to occur. +| unarchived | Triggered when a repository owner unarchives a repository. {% if currentVersion == "free-pro-team@latest" %} -#### Categoria `sponsors` - -| Ação | Descrição | -| ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| repo_funding_link_button_toggle | Acionada quando você habilita ou desabilita um botão de patrocinador no repositório (consulte "[Exibir um botão de patrocinador no seu repositório](/articles/displaying-a-sponsor-button-in-your-repository)") | -| repo_funding_links_file_action | Acionada quando você altera o arquivo FUNDING no repositório (consulte "[Exibir botão de patrocinador no repositório](/articles/displaying-a-sponsor-button-in-your-repository)") | -| sponsor_sponsorship_cancel | Acionada quando você cancela um patrocínio (consulte "[Fazer downgrade de um patrocínio](/articles/downgrading-a-sponsorship)") | -| sponsor_sponsorship_create | Acionadas quando você patrocina um desenvolvedor (consulte "[Patrocinar um colaborador de código aberto](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor#sponsoring-a-developer)") | -| sponsor_sponsorship_preference_change | Acionada quando você altera o recebimento de atualizações de e-mail de um desenvolvedor patrocinado (consulte "[Gerenciar o patrocínio](/articles/managing-your-sponsorship)") | -| sponsor_sponsorship_tier_change | Acionada quando você faz upgrade ou downgrade do patrocínio (consulte "[Atualizar um patrocínio](/articles/upgrading-a-sponsorship)" e "[Fazer downgrade de um patrocínio](/articles/downgrading-a-sponsorship)") | -| sponsored_developer_approve | Acionada quando sua conta do {% data variables.product.prodname_sponsors %} é aprovada (ver "[Configuração de {% data variables.product.prodname_sponsors %} para sua conta de usuário](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") | -| sponsored_developer_create | Acionada quando sua conta de {% data variables.product.prodname_sponsors %} é criada (consulte "[Configurar {% data variables.product.prodname_sponsors %} para sua conta de usuário](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") | -| sponsored_developer_profile_update | Acionada quando você edita seu perfil de desenvolvedor patrocinado (consulte "[Editar informações de perfil para {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors)") | -| sponsored_developer_request_approval | Acionada quando você enviar seu aplicativo para {% data variables.product.prodname_sponsors %} para aprovação (consulte "[Configurar {% data variables.product.prodname_sponsors %} para sua conta de usuário](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") | -| sponsored_developer_tier_description_update | Acionada quando você altera a descrição de um nível de patrocínio (consulte "[Alterar níveis de patrocínio](/articles/changing-your-sponsorship-tiers)") | -| sponsored_developer_update_newsletter_send | Acionada quando você envia uma atualização por e-mail aos patrocinadores (consulte "[Entrar em contato com os patrocinadores](/articles/contacting-your-sponsors)") | -| waitlist_invite_sponsored_developer | Acionada quando você é convidado a juntar-se a {% data variables.product.prodname_sponsors %} a partir da lista de espera (consulte "[Configurar {% data variables.product.prodname_sponsors %} para sua conta de usuário](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") | -| waitlist_join | Acionada quando você se junta à lista de espera para tornar-se um desenvolvedor patrocinado (consulte "[Configurar {% data variables.product.prodname_sponsors %} para sua conta de usuário](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") | +#### The `sponsors` category + +| Action | Description +|------------------|------------------- +| repo_funding_link_button_toggle | Triggered when you enable or disable a sponsor button in your repository (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)") +| repo_funding_links_file_action | Triggered when you change the FUNDING file in your repository (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)") +| sponsor_sponsorship_cancel | Triggered when you cancel a sponsorship (see "[Downgrading a sponsorship](/articles/downgrading-a-sponsorship)") +| sponsor_sponsorship_create | Triggered when you sponsor a developer (see "[Sponsoring an open source contributor](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor#sponsoring-a-developer)") +| sponsor_sponsorship_preference_change | Triggered when you change whether you receive email updates from a sponsored developer (see "[Managing your sponsorship](/articles/managing-your-sponsorship)") +| sponsor_sponsorship_tier_change | Triggered when you upgrade or downgrade your sponsorship (see "[Upgrading a sponsorship](/articles/upgrading-a-sponsorship)" and "[Downgrading a sponsorship](/articles/downgrading-a-sponsorship)") +| sponsored_developer_approve | Triggered when your {% data variables.product.prodname_sponsors %} account is approved (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") +| sponsored_developer_create | Triggered when your {% data variables.product.prodname_sponsors %} account is created (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") +| sponsored_developer_profile_update | Triggered when you edit your sponsored developer profile (see "[Editing your profile details for {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors)") +| sponsored_developer_request_approval | Triggered when you submit your application for {% data variables.product.prodname_sponsors %} for approval (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") +| sponsored_developer_tier_description_update | Triggered when you change the description for a sponsorship tier (see "[Changing your sponsorship tiers](/articles/changing-your-sponsorship-tiers)") +| sponsored_developer_update_newsletter_send | Triggered when you send an email update to your sponsors (see "[Contacting your sponsors](/articles/contacting-your-sponsors)") +| waitlist_invite_sponsored_developer | Triggered when you are invited to join {% data variables.product.prodname_sponsors %} from the waitlist (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") +| waitlist_join | Triggered when you join the waitlist to become a sponsored developer (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") {% endif %} {% if currentVersion == "free-pro-team@latest" %} -#### A categoria `successor_invitation` - -| Ação | Descrição | -| -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| aceitar | Acionada quando você aceita um convite de sucessão (consulte "[Manter a continuidade da propriedade dos repositórios da conta do seu usuário](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") | -| cancelar | Acionado quando você cancela um convite de sucessão (consulte"[Manter a continuidade da propriedade dos repositórios da conta do seu usuário](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") | -| create | Acionado quando você cria um convite de sucessão (consulte "[Manter a continuidade da propriedade dos repositórios da conta do usuário](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") | -| recusar | Acionado quando você recusa um convite de sucessão (consulte "[Manter a continuidade da propriedade dos repositórios da conta do usuário](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") | -| revogar | Acionado quando você revoga um convite de sucessão (consulte "[Manter a continuidade da propriedade dos repositórios da sua conta de usuário](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") | +#### The `successor_invitation` category + +| Action | Description +|------------------|------------------- +| accept | Triggered when you accept a succession invitation (see "[Maintaining ownership continuity of your user account's repositories](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") +| cancel | Triggered when you cancel a succession invitation (see "[Maintaining ownership continuity of your user account's repositories](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") +| create | Triggered when you create a succession invitation (see "[Maintaining ownership continuity of your user account's repositories](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") +| decline | Triggered when you decline a succession invitation (see "[Maintaining ownership continuity of your user account's repositories](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") +| revoke | Triggered when you revoke a succession invitation (see "[Maintaining ownership continuity of your user account's repositories](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") {% endif %} {% if currentVersion != "free-pro-team@latest" %} -#### Categoria `team` +#### The `team` category -| Ação | Descrição | -| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | -| add_member | Acionada quando um integrante de uma organização à qual você pertence [adiciona você em uma equipe](/articles/adding-organization-members-to-a-team). | -| add_repository | Acionada quando uma equipe da qual você faz parte recebe o controle de um repositório. | -| create | Acionada quando uma equipe é criada em uma organização à qual você pertence. | -| destroy | Acionada quando uma equipe da qual você faz parte é excluída da organização. | -| remove_member | Acionada quando um integrante de uma organização é [removido de uma equipe](/articles/removing-organization-members-from-a-team) da qual você faz parte. | -| remove_repository | Acionada quando um repositório deixa de ser controlado por uma equipe. | +| Action | Description +|------------------|------------------- +| add_member | Triggered when a member of an organization you belong to [adds you to a team](/articles/adding-organization-members-to-a-team). +| add_repository | Triggered when a team you are a member of is given control of a repository. +| create | Triggered when a new team in an organization you belong to is created. +| destroy | Triggered when a team you are a member of is deleted from the organization. +| remove_member | Triggered when a member of an organization is [removed from a team](/articles/removing-organization-members-from-a-team) you are a member of. +| remove_repository | Triggered when a repository is no longer under a team's control. {% endif %} -#### Categoria `two_factor_authentication` - -| Ação | Descrição | -| -------- | ---------------------------------------------------------------------------------------------------------------------------------- | -| enabled | Acionada quando a [autenticação de dois fatores](/articles/securing-your-account-with-two-factor-authentication-2fa) é habilitada. | -| disabled | Acionada quando a autenticação de dois fatores é desabilitada. | - -#### Categoria `user` - -| Ação | Descrição | -| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| add_email | Acionada quando você [adiciona um novo endereço de e-mail](/articles/changing-your-primary-email-address). | -| create | Acionada quando você cria uma conta de usuário. | -| remove_email | Acionada quando você remove um endereço de e-mail. | -| rename | Acionada quando você renomeia sua conta. | -| change_password | Acionada quando você altera a senha. | -| forgot_password | Acionada quando você solicita [a redefinição da senha](/articles/how-can-i-reset-my-password). | -| login | Acionada quando você faz login no {% data variables.product.product_location %}. | -| failed_login | Acionada quando você não consegue fazer login. | -| two_factor_requested | Acionada quando o {% data variables.product.product_name %} solicita o [código da autenticação de dois fatores](/articles/accessing-github-using-two-factor-authentication). | -| show_private_contributions_count | Acionada quando você [exibe contribuições privadas no seu perfil](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile). | -| hide_private_contributions_count | Acionada quando você [oculta as contribuições privadas no seu perfil](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile).{% if currentVersion == "free-pro-team@latest" %} -| report_content | Acionada quando você [denuncia um problema ou uma pull request, ou um comentário em um problema, uma pull request, ou commit](/articles/reporting-abuse-or-spam).{% endif %} - -#### Categoria `user_status` - -| Ação | Descrição | -| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| update | Acionada quando você configura ou altera o status no perfil. Para obter mais informações, consulte "[Configurar um status](/articles/personalizing-your-profile/#setting-a-status)". | -| destroy | Acionada quando você remove o status no perfil. | +#### The `two_factor_authentication` category + +| Action | Description +|------------------|------------------- +| enabled | Triggered when [two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa) is enabled. +| disabled | Triggered when two-factor authentication is disabled. + +#### The `user` category + +| Action | Description +|--------------------|--------------------- +| add_email | Triggered when you [add a new email address](/articles/changing-your-primary-email-address). +| create | Triggered when you create a new user account. +| remove_email | Triggered when you remove an email address. +| rename | Triggered when you rename your account. +| change_password | Triggered when you change your password. +| forgot_password | Triggered when you ask for [a password reset](/articles/how-can-i-reset-my-password). +| login | Triggered when you log in to {% data variables.product.product_location %}. +| failed_login | Triggered when you failed to log in successfully. +| two_factor_requested | Triggered when {% data variables.product.product_name %} asks you for [your two-factor authentication code](/articles/accessing-github-using-two-factor-authentication). +| show_private_contributions_count | Triggered when you [publicize private contributions on your profile](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile). +| hide_private_contributions_count | Triggered when you [hide private contributions on your profile](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile).{% if currentVersion == "free-pro-team@latest" %} +| report_content | Triggered when you [report an issue or pull request, or a comment on an issue, pull request, or commit](/articles/reporting-abuse-or-spam).{% endif %} + +#### The `user_status` category + +| Action | Description +|--------------------|--------------------- +| update | Triggered when you set or change the status on your profile. For more information, see "[Setting a status](/articles/personalizing-your-profile/#setting-a-status)." +| destroy | Triggered when you clear the status on your profile. {% if currentVersion == "free-pro-team@latest" %} -### Exportar o seu log de segurança +### Exporting your security log {% data reusables.audit_log.export-log %} {% data reusables.audit_log.exported-log-keys-and-values %} diff --git a/translations/pt-BR/content/github/authenticating-to-github/reviewing-your-ssh-keys.md b/translations/pt-BR/content/github/authenticating-to-github/reviewing-your-ssh-keys.md index 9baac7911766..71ea5e3d0586 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/reviewing-your-ssh-keys.md +++ b/translations/pt-BR/content/github/authenticating-to-github/reviewing-your-ssh-keys.md @@ -1,6 +1,6 @@ --- -title: Revisar suas chaves SSH -intro: 'Para manter suas credenciais protegidas, você deve auditar regularmente as chaves SSH e as chaves de implantação, bem como revisar os aplicativos autorizados que acessam sua conta do {% data variables.product.product_name %}.' +title: Reviewing your SSH keys +intro: 'To keep your credentials secure, you should regularly audit your SSH keys, deploy keys, and review authorized applications that access your {% data variables.product.product_name %} account.' redirect_from: - /articles/keeping-your-application-access-tokens-safe/ - /articles/keeping-your-ssh-keys-and-application-access-tokens-safe/ @@ -10,37 +10,43 @@ versions: enterprise-server: '*' --- -Você pode excluir chaves SSH não autorizadas (ou potencialmente comprometidas) para evitar que invasores tenham acesso aos seus repositórios. Você também pode aprovar as chaves SSh que são válidas. +You can delete unauthorized (or possibly compromised) SSH keys to ensure that an attacker no longer has access to your repositories. You can also approve existing SSH keys that are valid. {% mac %} {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -3. Na página das chaves SSH, anote as chaves SSH associadas à sua conta. Para as chaves não reconhecidas ou desatualizadas, clique em **Delete** (Excluir). Se houver chaves SSH válidas que deseja manter, clique em **Approve** (Aprovar). ![Lista de chaves SSH](/assets/images/help/settings/settings-ssh-key-review.png) +3. On the SSH Settings page, take note of the SSH keys associated with your account. For those that you don't recognize, or that are out-of-date, click **Delete**. If there are valid SSH keys you'd like to keep, click **Approve**. + ![SSH key list](/assets/images/help/settings/settings-ssh-key-review.png) {% tip %} - **Observação:** quando estiver auditando as chaves SSH devido a um erro em uma operação do Git, a chave não verificada que causou o [erro de auditoria da chave SSH](/articles/error-we-re-doing-an-ssh-key-audit) estará em destaque na lista de chaves SSH. ![Chave SSH não verificada](/assets/images/help/settings/settings-ssh-key-review-highlight.png) + **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys. {% endtip %} -4. Abra o terminal. +4. Open Terminal. 5. {% data reusables.command_line.start_ssh_agent %} -6. Encontre e anote a impressão digital da chave pública. Se estiver usando OpenSSH 6.7 ou anterior: +6. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` - Se estiver usando OpenSSH 6.8 ou posterior: + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} -7. As chaves SSH keys {% data variables.product.product_name %} *devem* corresponder às chaves no computador. +7. The SSH keys on {% data variables.product.product_name %} *should* match the same keys on your computer. {% endmac %} @@ -48,33 +54,39 @@ Você pode excluir chaves SSH não autorizadas (ou potencialmente comprometidas) {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -3. Na página das chaves SSH, anote as chaves SSH associadas à sua conta. Para as chaves não reconhecidas ou desatualizadas, clique em **Delete** (Excluir). Se houver chaves SSH válidas que deseja manter, clique em **Approve** (Aprovar). ![Lista de chaves SSH](/assets/images/help/settings/settings-ssh-key-review.png) +3. On the SSH Settings page, take note of the SSH keys associated with your account. For those that you don't recognize, or that are out-of-date, click **Delete**. If there are valid SSH keys you'd like to keep, click **Approve**. + ![SSH key list](/assets/images/help/settings/settings-ssh-key-review.png) {% tip %} - **Observação:** quando estiver auditando as chaves SSH devido a um erro em uma operação do Git, a chave não verificada que causou o [erro de auditoria da chave SSH](/articles/error-we-re-doing-an-ssh-key-audit) estará em destaque na lista de chaves SSH.![Chave SSH não verificada](/assets/images/help/settings/settings-ssh-key-review-highlight.png) + **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys. {% endtip %} -4. Abra o Git Bash. Se estiver usando o Git Shell, que faz parte do {% data variables.product.prodname_desktop %}, abra o Git Shell e passe para a etapa 6. +4. Open Git Bash. If you're using Git Shell, which is included in {% data variables.product.prodname_desktop %}, open Git Shell and skip to step 6. 5. {% data reusables.desktop.windows_git_bash_turn_on_ssh_agent %} {% data reusables.desktop.windows_git_for_windows_turn_on_ssh_agent %} -6. Encontre e anote a impressão digital da chave pública. Se estiver usando OpenSSH 6.7 ou anterior: +6. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` - Se estiver usando OpenSSH 6.8 ou posterior: + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} -7. As chaves SSH keys {% data variables.product.product_name %} *devem* corresponder às chaves no computador. +7. The SSH keys on {% data variables.product.product_name %} *should* match the same keys on your computer. {% endwindows %} @@ -82,36 +94,42 @@ Você pode excluir chaves SSH não autorizadas (ou potencialmente comprometidas) {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -3. Na página das chaves SSH, anote as chaves SSH associadas à sua conta. Para as chaves não reconhecidas ou desatualizadas, clique em **Delete** (Excluir). Se houver chaves SSH válidas que deseja manter, clique em **Approve** (Aprovar). ![Lista de chaves SSH](/assets/images/help/settings/settings-ssh-key-review.png) +3. On the SSH Settings page, take note of the SSH keys associated with your account. For those that you don't recognize, or that are out-of-date, click **Delete**. If there are valid SSH keys you'd like to keep, click **Approve**. + ![SSH key list](/assets/images/help/settings/settings-ssh-key-review.png) {% tip %} - **Observação:** quando estiver auditando as chaves SSH devido a um erro em uma operação do Git, a chave não verificada que causou o [erro de auditoria da chave SSH](/articles/error-we-re-doing-an-ssh-key-audit) estará em destaque na lista de chaves SSH. ![Chave SSH não verificada](/assets/images/help/settings/settings-ssh-key-review-highlight.png) + **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys. {% endtip %} -4. Abra o terminal. +4. Open Terminal. 5. {% data reusables.command_line.start_ssh_agent %} -6. Encontre e anote a impressão digital da chave pública. Se estiver usando OpenSSH 6.7 ou anterior: +6. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` - Se estiver usando OpenSSH 6.8 ou posterior: + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} -7. As chaves SSH keys {% data variables.product.product_name %} *devem* corresponder às chaves no computador. +7. The SSH keys on {% data variables.product.product_name %} *should* match the same keys on your computer. {% endlinux %} {% warning %} -**Aviso**: se você encontrar uma chave SSH com a qual não esteja familiarizado em {% data variables.product.product_name %}, delete-a imediatamente e entre em contato com o {% data variables.contact.contact_support %} para obter ajuda. Uma chave pública desconhecida pode indicar um possível problema de segurança. +**Warning**: If you see an SSH key you're not familiar with on {% data variables.product.product_name %}, delete it immediately and contact {% data variables.contact.contact_support %} for further help. An unidentified public key may indicate a possible security concern. {% endwarning %} diff --git a/translations/pt-BR/content/github/authenticating-to-github/signing-commits.md b/translations/pt-BR/content/github/authenticating-to-github/signing-commits.md index 052e3a87b935..ee755e72db2f 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/signing-commits.md +++ b/translations/pt-BR/content/github/authenticating-to-github/signing-commits.md @@ -1,6 +1,6 @@ --- title: Assinar commits -intro: 'Você pode assinar commits localmente usando GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} ou S/MIME{% endif %}.' +intro: 'Você pode assinar os commits localmente usando GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} ou S/MIME{% endif %}.' redirect_from: - /articles/signing-commits-and-tags-using-gpg/ - /articles/signing-commits-using-gpg/ @@ -39,7 +39,8 @@ Se você tiver várias chaves ou estiver tentando assinar commits ou tags com um $ git push # Pushes your local commits to the remote repository ``` -4. No {% data variables.product.product_name %}, navegue até sua pull request. +4. Em +{% data variables.product.product_name %}, navegue até o seu pull request. {% data reusables.repositories.review-pr-commits %} 5. Para exibir informações mais detalhadas sobre a assinatura verificada, clique em Verified (Verificada). ![Commit assinado](/assets/images/help/commits/gpg-signed-commit-verified-without-details.png) diff --git a/translations/pt-BR/content/github/authenticating-to-github/telling-git-about-your-signing-key.md b/translations/pt-BR/content/github/authenticating-to-github/telling-git-about-your-signing-key.md index 1d614b1b6ce9..0c302a077e3a 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/telling-git-about-your-signing-key.md +++ b/translations/pt-BR/content/github/authenticating-to-github/telling-git-about-your-signing-key.md @@ -1,6 +1,6 @@ --- title: Informar ao Git sobre a chave de assinatura -intro: 'Para assinar commits localmente, é preciso informar ao Git que há uma chave GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} ou X.509{% endif %} que você deseja usar.' +intro: 'Para assinar os commits localmente, você precisa informar ao Git que existe um GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 4" %} ou chave X.509{% endif %} que deseja usar.' redirect_from: - /articles/telling-git-about-your-gpg-key/ - /articles/telling-git-about-your-signing-key diff --git a/translations/pt-BR/content/github/authenticating-to-github/updating-your-github-access-credentials.md b/translations/pt-BR/content/github/authenticating-to-github/updating-your-github-access-credentials.md index 40e39b205207..d87218d66e41 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/updating-your-github-access-credentials.md +++ b/translations/pt-BR/content/github/authenticating-to-github/updating-your-github-access-credentials.md @@ -12,7 +12,7 @@ versions: ### Solicitar uma nova senha -1. Para solicitar uma nova senha, visite {% if currentVersion == "free-pro-team@latest" %}https://{% data variables.product.product_url %}/password_reset{% else %}`https://{% data variables.product.product_url %}/password_reset`{% endif %}. +1. Para solicitar uma nova senha, acesse {% if currentVersion == "free-pro-team@latest" %}https://{% data variables.product.product_url %}/password_reset{% else %}`https://{% data variables.product.product_url %}/password_reset`{% endif %}. 2. Digite o endereço de e-mail associado à sua conta pessoal do {% data variables.product.product_name %} e clique em **Send password reset email** (Enviar e-mail de redefinição de senha). O e-mail será enviado para o endereço de e-mail de backup, se você tiver um configurado. ![Caixa de diálogo para solicitar e-mail de redefinição de senha](/assets/images/help/settings/password-recovery-email-request.png) 3. Nós enviaremos por e-mail um link para você redefinir sua senha. Clique nele em até 3 horas após o recebimento do e-mail. Se você não receber o e-mail com o link, verifique sua pasta de spam. 4. Depois de clicar no link contido no e-mail, você precisará digitar uma nova senha.![Caixa para recuperar senha](/assets/images/help/settings/password_recovery_page.png) @@ -29,11 +29,7 @@ Para evitar que você perca a senha, sugerimos que você use um gerenciador de s 1. {% data variables.product.signin_link %} para o {% data variables.product.product_name %}. {% data reusables.user_settings.access_settings %} -{%- if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} {% data reusables.user_settings.security %} -{%- else %} -{% data reusables.user_settings.account_settings %} -{%- endif %} 4. Em "Change password" (Alterar senha), insira a senha antiga, digite uma nova senha forte e confirme a nova senha. Consulte "[Criar uma senha forte](/articles/creating-a-strong-password)" para obter ajuda sobre esse assunto. 5. Clique em **Update password** (Atualizar senha). diff --git a/translations/pt-BR/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md b/translations/pt-BR/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md index 1d52a7934cf2..e6dd14d32894 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md +++ b/translations/pt-BR/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md @@ -60,7 +60,7 @@ fi unset env ``` -Se sua chave privada não for armazenada em um dos locais-padrão (como `~/.ssh/id_rsa`{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} ou `~/. sh/id_dsa`{% endif %}), você deverá informar ao seu agente de autenticação SSH onde encontrá-la. Para adicionar a chave ao ssh-agent, digite `ssh-add ~/path/to/my_key`. Para obter mais informações, consulte "[Gerar uma nova chave SSH e adicioná-la ao ssh-agent](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/)". +Se sua chave privada não estiver armazenada em um dos locais-padrão (como `~/. sh/id_rsa`), você precisará dizer ao seu agente de autenticação SSH onde encontrá-la. Para adicionar a chave ao ssh-agent, digite `ssh-add ~/path/to/my_key`. Para obter mais informações, consulte "[Gerar uma nova chave SSH e adicioná-la ao ssh-agent](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/)". {% tip %} @@ -91,8 +91,7 @@ O processo do `ssh-agent` continuará sendo executado até você fazer logoff, d No OS X Leopard até o OS X El Capitan, estes arquivos padrão de chave privada são processados de forma automática: -- *.ssh/id_rsa*{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -- *.ssh/id_dsa*{% endif %} +- *.ssh/id_rsa* - *.ssh/identity* Na primeira vez que você usar a chave, precisará digitar sua frase secreta. Se você optar por salvar a frase secreta com a keychain, não precisará digitá-la novamente. diff --git a/translations/pt-BR/content/github/building-a-strong-community/about-issue-and-pull-request-templates.md b/translations/pt-BR/content/github/building-a-strong-community/about-issue-and-pull-request-templates.md index bc5c1e0ad3a4..552bd1efd491 100644 --- a/translations/pt-BR/content/github/building-a-strong-community/about-issue-and-pull-request-templates.md +++ b/translations/pt-BR/content/github/building-a-strong-community/about-issue-and-pull-request-templates.md @@ -10,7 +10,7 @@ versions: Depois que você cria modelos de problema e pull request no repositório, os contribuidores podem usá-los para abrir problemas ou descrever as alterações propostas nas respectivas pull requests, de acordo com as diretrizes de contribuição do repositório. Para obter mais informações sobre como adicionar diretrizes de contribuição a um repositório, consulte "[Configurar diretrizes para contribuidores de repositório](/articles/setting-guidelines-for-repository-contributors)". -Você pode criar um problema padrão e modelos de pull request para sua organização {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} ou conta de usuário{% endif %}. Para obter mais informações, consulte "[Criando um arquivo padrão de integridade da comunidade](/github/building-a-strong-community/creating-a-default-community-health-file)." +É possível criar modelos-padrão de problema e pull request para a organização{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 9" %} ou conta de usuário{% endif %}. Para obter mais informações, consulte "[Criando um arquivo padrão de integridade da comunidade](/github/building-a-strong-community/creating-a-default-community-health-file)." ### Modelos de problema diff --git a/translations/pt-BR/content/github/building-a-strong-community/about-team-discussions.md b/translations/pt-BR/content/github/building-a-strong-community/about-team-discussions.md index 03ea431cbf2c..101c4f51bc02 100644 --- a/translations/pt-BR/content/github/building-a-strong-community/about-team-discussions.md +++ b/translations/pt-BR/content/github/building-a-strong-community/about-team-discussions.md @@ -26,7 +26,7 @@ Quando alguém posta ou responde a uma discussão pública na página de uma equ {% tip %} -**Dica:** dependendo das suas configurações de notificação, você receberá atualizações por e-mail, pela página de notificações da web no {% data variables.product.product_name %}, ou por ambos. Para obter mais informações, consulte {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[Configurando notificações](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications){% else %}"[Sobre notificações de e-mail](/github/receiving-notifications-about-activity-on-github/about-email-notifications)" e "[Sobre notificações da web](/github/receiving-notifications-about-activity-on-github/about-web-notifications){% endif %}." +**Dica:** dependendo das suas configurações de notificação, você receberá atualizações por e-mail, pela página de notificações da web no {% data variables.product.product_name %}, ou por ambos. Para obter mais informações, consulte {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 0" %}"[Configurar notificações](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications){% else %}"[Sobre notificações de e-mail](/github/receiving-notifications-about-activity-on-github/about-email-notifications)e "[Sobre notificações web](/github/receiving-notifications-about-activity-on-github/about-web-notifications){% endif %}." {% endtip %} @@ -34,7 +34,7 @@ Por padrão, se seu nome de usuário for mencionado em uma discussão de equipe, Para desativar notificações de discussões de equipe, você pode cancelar a assinatura de uma postagem de discussão específica ou alterar as configurações de notificação para cancelar a inspeção ou ignorar completamente discussões de uma equipe específica. É possível assinar para receber notificações de uma postagem de discussão específica se você estiver cancelando a inspeção de discussões dessa equipe. -Para obter mais informações, consulte {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[Visualizando suas assinaturas](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions){% else %}"[Cadastrar-se e descadastrar-se para receber notificações](/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications){% endif %}" e "[Equipes aninhadas](/articles/about-teams/#nested-teams)." +Para obter mais informações, consulte {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 0" %}"[Visualizar as suas assinaturas](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions){% else %}"[Assinar e cancelar a assinatura das notificações](/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications){% endif %}" e "[Equipes aninhadas](/articles/about-teams/#nested-teams)" ### Leia mais diff --git a/translations/pt-BR/content/github/building-a-strong-community/about-wikis.md b/translations/pt-BR/content/github/building-a-strong-community/about-wikis.md index b772067f5fbb..55c9e61a64e2 100644 --- a/translations/pt-BR/content/github/building-a-strong-community/about-wikis.md +++ b/translations/pt-BR/content/github/building-a-strong-community/about-wikis.md @@ -1,6 +1,6 @@ --- title: Sobre wikis -intro: Você pode hospedar a documentação para seu repositório em um wiki para que outras pessoas possam usar e contribuir com seu projeto. +intro: 'Você pode hospedar a documentação para seu repositório em um wiki para que outras pessoas possam usar e contribuir com seu projeto.' redirect_from: - /articles/about-github-wikis/ - /articles/about-wikis diff --git a/translations/pt-BR/content/github/building-a-strong-community/adding-support-resources-to-your-project.md b/translations/pt-BR/content/github/building-a-strong-community/adding-support-resources-to-your-project.md index 63e071c62997..4689ed243c34 100644 --- a/translations/pt-BR/content/github/building-a-strong-community/adding-support-resources-to-your-project.md +++ b/translations/pt-BR/content/github/building-a-strong-community/adding-support-resources-to-your-project.md @@ -12,7 +12,7 @@ Para direcionar pessoas a recursos de suporte específicos, é possível adicion ![Diretrizes de suporte](/assets/images/help/issues/support_guidelines_in_issue.png) -Você pode criar recursos de suporte padrão para sua organização{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} ou conta de usuário{% endif %}. Para obter mais informações, consulte "[Criando um arquivo padrão de integridade da comunidade](/github/building-a-strong-community/creating-a-default-community-health-file)." +Você pode criar recursos-padrão de suporte para a sua organização{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} ou conta de usuário{% endif %}. Para obter mais informações, consulte "[Criando um arquivo padrão de integridade da comunidade](/github/building-a-strong-community/creating-a-default-community-health-file)." {% tip %} diff --git a/translations/pt-BR/content/github/building-a-strong-community/blocking-a-user-from-your-personal-account.md b/translations/pt-BR/content/github/building-a-strong-community/blocking-a-user-from-your-personal-account.md index 25e1d768929f..4ec91d674c55 100644 --- a/translations/pt-BR/content/github/building-a-strong-community/blocking-a-user-from-your-personal-account.md +++ b/translations/pt-BR/content/github/building-a-strong-community/blocking-a-user-from-your-personal-account.md @@ -1,6 +1,6 @@ --- title: Bloquear usuário da conta pessoal -intro: É possível bloquear um usuário para negar a ele acesso aos seus repositórios e atividades e para impedi-lo de enviar notificações a você. +intro: 'É possível bloquear um usuário para negar a ele acesso aos seus repositórios e atividades e para impedi-lo de enviar notificações a você.' redirect_from: - /articles/blocking-a-user-from-your-personal-account versions: diff --git a/translations/pt-BR/content/github/building-a-strong-community/configuring-issue-templates-for-your-repository.md b/translations/pt-BR/content/github/building-a-strong-community/configuring-issue-templates-for-your-repository.md index 374d07fac9dd..525a1d4bf791 100644 --- a/translations/pt-BR/content/github/building-a-strong-community/configuring-issue-templates-for-your-repository.md +++ b/translations/pt-BR/content/github/building-a-strong-community/configuring-issue-templates-for-your-repository.md @@ -24,7 +24,7 @@ versions: 7. Para definir automaticamente um título de problema padrão, atribua o problema a pessoas com acesso de leitura ao repositório ou aplique etiquetas ao modelo de problema. Informe esses detalhes em "Optional additional information" (Informações adicionais opcionais). Você também pode adicionar esses detalhes no modelo de problema com `title`, `labels` ou `assignees` em um formato de página inicial do YAML. ![Informações adicionais para modelo de problema](/assets/images/help/repository/additional-issue-template-info.png) 8. Quando tiver terminado de editar e visualizar o modelo, clique em **Propose changes** (Propor alterações) no canto superior direito da página. ![Botão Propose changes (Propor alterações)](/assets/images/help/repository/propose-changes-button.png) 9. Insira uma mensagem do commit descrevendo as alterações. ![Campo de mensagem do commit do modelo de problema](/assets/images/help/repository/issue-template-commit-message-field.png) -10. Abaixo dos campos de mensagem do commit, decida se vai fazer commit do seu modelo diretamente no branch padrão ou se vai criar um branch e abrir uma pull request. Para obter mais informações sobre pull requests, consulte "[Sobre pull requests](/articles/about-pull-requests)". ![Commit do modelo de problema com opção para mestre ou abrir pull request](/assets/images/help/repository/issue-template-commit-to-master-or-open-pull-request.png) +10. Abaixo dos campos de mensagem do commit, decida se vai fazer commit do seu modelo diretamente no branch padrão ou se vai criar um branch e abrir uma pull request. Para obter mais informações sobre pull requests, consulte "[Sobre pull requests](/articles/about-pull-requests)". ![Commit do modelo de problema com opção para principal ou abrir pull request](/assets/images/help/repository/issue-template-commit-to-master-or-open-pull-request.png) 11. Clique em **Commit changes** (Fazer commit das alterações). Assim que essas alterações passarem por merge no branch padrão, o modelo será disponibilizado para os contribuidores usarem quando abrirem novos problemas no repositório. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} diff --git a/translations/pt-BR/content/github/building-a-strong-community/creating-a-default-community-health-file.md b/translations/pt-BR/content/github/building-a-strong-community/creating-a-default-community-health-file.md index 8d86a6be7819..ab58d57f7b28 100644 --- a/translations/pt-BR/content/github/building-a-strong-community/creating-a-default-community-health-file.md +++ b/translations/pt-BR/content/github/building-a-strong-community/creating-a-default-community-health-file.md @@ -11,38 +11,38 @@ versions: ### Sobre arquivos padrão de integridade da comunidade -Você pode adicionar arquivos padrão de integridade da comunidade à raiz de um repositório público chamado `.github` que é de propriedade de uma organização{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} ou de uma conta de usuário{% endif %}. +Você pode adicionar arquivos de integridade padrão da comunidade à raiz de um repositório público denominado `.github` que é propriedade de uma organização{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} ou conta de usuário{% endif %}. {% data variables.product.product_name %} usará e exibirá arquivos padrão para qualquer repositório público de propriedade da conta que não tenha seu próprio arquivo desse tipo em nenhum dos seguintes locais: - a raiz do repositório - a pasta `.github` - a pasta `docs` -Por exemplo, qualquer pessoa que cria um problema ou uma pull request em um repositório público que não tem o próprio arquivo CONTRIBUTING verá um link para o arquivo CONTRIBUTING padrão. Se um repositório tiver quaisquer arquivos em sua própria pasta `.github/ISSUE_TEMPLATE` {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}, incluindo modelos de problemas ou um arquivo *config.yml* ,{% endif %} nenhum conteúdo da pasta padrão `.github/ISSUE_TEMPLATE` será usado. +Por exemplo, qualquer pessoa que cria um problema ou uma pull request em um repositório público que não tem o próprio arquivo CONTRIBUTING verá um link para o arquivo CONTRIBUTING padrão. Se um repositório tiver algum arquivo na própria pasta `.github/ISSUE_TEMPLATE` {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 9" %}, incluindo modelos de problemas ou um arquivo *config.yml*,{% endif %} nenhum conteúdo da pasta-padrão `.github/ISSUE_TEMPLATE` será usado. Os arquivos padrão não são incluídos em clones, pacotes ou downloads de repositórios individuais, pois eles são armazenados somente no repositório `.github`. ### Tipos de arquivo compatíveis -Você pode criar padrões em sua organização{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} ou conta de usuário{% endif %} para os seguintes arquivo de integridade da comunidade: +Você pode criar padrões na sua organização{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 9" %} ou conta de usuário{% endif %} para os seguintes arquivos de integridade da comunidade: -| Arquivo de integridade da comunidade | Descrição | -| --------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" %} -| *CODE_OF_CONDUCT.md* | Um arquivo CODE_OF_CONDUCT define os padrões de como ingressar em uma comunidade. Para obter mais informações, consulte "[Adicionar um código de conduta ao projeto](/articles/adding-a-code-of-conduct-to-your-project/)".{% endif %} -| *CONTRIBUTING.md* | Um arquivo CONTRIBUTING comunica como as pessoas devem contribuir com o seu projeto. Para obter mais informações, consulte "[Configurar diretrizes para contribuidores de repositório](/articles/setting-guidelines-for-repository-contributors/)".{% if currentVersion == "free-pro-team@latest" %} -| *FUNDING.yml* | Um arquivo FUNDING exibe um botão de patrocinador no repositório para aumentar a visibilidade das opções de financiamento para seu projeto de código aberto. Para obter mais informações, consulte "[Exibir um botão de patrocinador no seu repositório](/articles/displaying-a-sponsor-button-in-your-repository)".{% endif %} -| Modelos de problema e pull request{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} e *config.yml*{% endif %} | Os modelos de problema e pull request personalizam e padronizam as informações que você deseja que contribuidores incluam quando eles abrem problemas e pull requests no seu repositório. Para obter mais informações, consulte "[Sobre modelos de problema e pull request](/articles/about-issue-and-pull-request-templates/)".{% if currentVersion == "free-pro-team@latest" %} -| *SECURITY.md* | Um arquivo SECURITY fornece instruções sobre como relatar com responsabilidade uma vulnerabilidade de segurança em seu projeto. Para obter mais informações, consulte "[Adicionar uma política de segurança ao seu repositório](/articles/adding-a-security-policy-to-your-repository)".{% endif %} -| *SUPPORT.md* | Um arquivo SUPPORT permite que as pessoas conheçam maneiras de obter ajudar com seu projeto. Para obter mais informações, consulte "[Adicionar recursos de suporte ao projeto](/articles/adding-support-resources-to-your-project/)". | +| Arquivo de integridade da comunidade | Descrição | +| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" %} +| *CODE_OF_CONDUCT.md* | Um arquivo CODE_OF_CONDUCT define os padrões de como ingressar em uma comunidade. Para obter mais informações, consulte "[Adicionar um código de conduta ao projeto](/articles/adding-a-code-of-conduct-to-your-project/)".{% endif %} +| *CONTRIBUTING.md* | Um arquivo CONTRIBUTING comunica como as pessoas devem contribuir com o seu projeto. Para obter mais informações, consulte "[Definir diretrizes para contribuidores de repositórios](/articles/setting-guidelines-for-repository-contributors/)".{% if currentVersion == "free-pro-team@latest" %} +| *FUNDING.yml* | Um arquivo FUNDING exibe um botão de patrocinador no repositório para aumentar a visibilidade das opções de financiamento para seu projeto de código aberto. Para obter mais informações, consulte "[Exibir um botão de patrocinador no seu repositório](/articles/displaying-a-sponsor-button-in-your-repository)".{% endif %} +| Modelos de problemas e pull request{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} e *config.yml*{% endif %} | Os modelos de problema e pull request personalizam e padronizam as informações que você deseja que contribuidores incluam quando eles abrem problemas e pull requests no seu repositório. Para obter mais informações, consulte "[Sobre problemas e modelos de pull request](/articles/about-issue-and-pull-request-templates/).{% if currentVersion == "free-pro-team@latest" %} +| *SECURITY.md* | Um arquivo SECURITY fornece instruções sobre como relatar com responsabilidade uma vulnerabilidade de segurança em seu projeto. Para obter mais informações, consulte "[Adicionar uma política de segurança ao seu repositório](/articles/adding-a-security-policy-to-your-repository)".{% endif %} +| *SUPPORT.md* | Um arquivo SUPPORT permite que as pessoas conheçam maneiras de obter ajudar com seu projeto. Para obter mais informações, consulte "[Adicionar recursos de suporte ao projeto](/articles/adding-support-resources-to-your-project/)". | Você não pode criar um arquivo de licença padrão. Os arquivos de licença devem ser adicionados a repositórios individuais para que o arquivo seja incluído quando um projeto for clonado, empacotado ou baixado. ### Criar um repositório para arquivos padrão {% data reusables.repositories.create_new %} -2. Use o menu suspenso **Proprietário** e selecione a organização{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} ou conta de usuário{% endif %} para as quais você deseja criar arquivo padrão. ![Menu suspenso Owner (Proprietário)](/assets/images/help/repository/create-repository-owner.png) +2. Use o menu suspenso **Proprietário** e selecione a organização{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 9" %} ou conta de usuário{% endif %} para a qual você deseja criar arquivos-padrão. ![Menu suspenso Owner (Proprietário)](/assets/images/help/repository/create-repository-owner.png) 3. Digite **.github** como o nome para seu repositório e uma descrição opcional. ![Campo Create repository (Criar repositório)](/assets/images/help/repository/default-file-repository-name.png) -4. Escolha tornar o repositório público. ![Botões de opção para selecionar status privado ou público](/assets/images/help/repository/create-repository-public-private.png) +4. Make sure the repository status is set to **Public** (a repository for default files cannot be private). ![Botões de opção para selecionar status privado ou público](/assets/images/help/repository/create-repository-public-private.png) {% data reusables.repositories.initialize-with-readme %} {% data reusables.repositories.create-repo %} -7. No repositório, crie um dos arquivos compatíveis de integridade da comunidade. Modelos de problema{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} e seu arquivo de configuração{% endif %} devem estar em uma pasta chamada `.github/ISSUE_TEMPLATE`. Todos os outros arquivos compatíveis devem estar na raiz do repositório. Para obter mais informações, consulte "[Criar arquivos](/articles/creating-new-files/)". +7. No repositório, crie um dos arquivos compatíveis de integridade da comunidade. Os modelos de problema{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 9" %} e o seu arquivo de configuração{% endif %} devem estar em uma pasta denominada `.github/ISSUE_TEMPLATE`. Todos os outros arquivos compatíveis devem estar na raiz do repositório. Para obter mais informações, consulte "[Criar arquivos](/articles/creating-new-files/)". diff --git a/translations/pt-BR/content/github/building-a-strong-community/creating-a-pull-request-template-for-your-repository.md b/translations/pt-BR/content/github/building-a-strong-community/creating-a-pull-request-template-for-your-repository.md index dd6e7a3154bd..1c7ffe70c508 100644 --- a/translations/pt-BR/content/github/building-a-strong-community/creating-a-pull-request-template-for-your-repository.md +++ b/translations/pt-BR/content/github/building-a-strong-community/creating-a-pull-request-template-for-your-repository.md @@ -12,7 +12,7 @@ Para obter mais informações, consulte "[Sobre modelos de problema e pull reque Você pode criar um subdiretório *PULL_REQUEST_TEMPLATE/* em qualquer uma das pastas compatíveis para conter vários modelos de pull request, bem como usar o parâmetro de consulta `template` para especificar o modelo que preencherá o texto da pull request. Para obter mais informações, consulte "[Sobre automação de problemas e pull requests com parâmetros de consulta](/articles/about-automation-for-issues-and-pull-requests-with-query-parameters)". -Você pode criar modelos de pull request padrão para sua organização{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} ou conta de usuário{% endif %}. Para obter mais informações, consulte "[Criando um arquivo padrão de integridade da comunidade](/github/building-a-strong-community/creating-a-default-community-health-file)." +Você pode criar modelos-padrão de pull request para a sua organização{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} ou conta de usuário{% endif %}. Para obter mais informações, consulte "[Criando um arquivo padrão de integridade da comunidade](/github/building-a-strong-community/creating-a-default-community-health-file)." ### Adicionar um modelo de pull request diff --git a/translations/pt-BR/content/github/building-a-strong-community/documenting-your-project-with-wikis.md b/translations/pt-BR/content/github/building-a-strong-community/documenting-your-project-with-wikis.md index b66361a570dc..dcf230002c4d 100644 --- a/translations/pt-BR/content/github/building-a-strong-community/documenting-your-project-with-wikis.md +++ b/translations/pt-BR/content/github/building-a-strong-community/documenting-your-project-with-wikis.md @@ -1,6 +1,6 @@ --- title: Documentar seu projeto com wikis -intro: Você pode usar um wiki para compartilhar informações longas e detalhadas sobre seu projeto. +intro: 'Você pode usar um wiki para compartilhar informações longas e detalhadas sobre seu projeto.' redirect_from: - /categories/49/articles/ - /categories/wiki/ diff --git a/translations/pt-BR/content/github/building-a-strong-community/editing-wiki-content.md b/translations/pt-BR/content/github/building-a-strong-community/editing-wiki-content.md index b63c166d4c89..d8d1f2dd4a68 100644 --- a/translations/pt-BR/content/github/building-a-strong-community/editing-wiki-content.md +++ b/translations/pt-BR/content/github/building-a-strong-community/editing-wiki-content.md @@ -1,6 +1,6 @@ --- title: Editar conteúdo de wiki -intro: Você pode adicionar imagens e links no conteúdo do seu wiki e usar alguns formatos do MediaWiki compatíveis. +intro: 'Você pode adicionar imagens e links no conteúdo do seu wiki e usar alguns formatos do MediaWiki compatíveis.' redirect_from: - /articles/adding-links-to-wikis/ - /articles/how-do-i-add-links-to-my-wiki/ diff --git a/translations/pt-BR/content/github/building-a-strong-community/locking-conversations.md b/translations/pt-BR/content/github/building-a-strong-community/locking-conversations.md index 0161c4ba1ec4..5e86b60383ee 100644 --- a/translations/pt-BR/content/github/building-a-strong-community/locking-conversations.md +++ b/translations/pt-BR/content/github/building-a-strong-community/locking-conversations.md @@ -1,6 +1,6 @@ --- -title: Bloquear conversas -intro: 'Proprietários e colaboradores de repositórios e pessoas com acesso de gravação em um repositório podem bloquear permanentemente ou temporariamente conversas sobre problemas, pull requests e commits para neutralizar uma interação acalorada.' +title: Locking conversations +intro: 'Repository owners and collaborators, and people with write access to a repository, can lock conversations on issues, pull requests, and commits permanently or temporarily to defuse a heated interaction.' redirect_from: - /articles/locking-conversations versions: @@ -8,28 +8,32 @@ versions: enterprise-server: '*' --- -É apropriado bloquear uma conversa quando toda ela não é construtiva ou infringe o código de conduta da sua comunidade{% if currentVersion == "free-pro-team@latest" %} ou das [Diretrizes da comunidade](/articles/github-community-guidelines) do GitHub{% endif %}. Quando você bloqueia uma conversa, você também pode especificar o motivo, que é visível publicamente. +It's appropriate to lock a conversation when the entire conversation is not constructive or violates your community's code of conduct{% if currentVersion == "free-pro-team@latest" %} or GitHub's [Community Guidelines](/articles/github-community-guidelines){% endif %}. When you lock a conversation, you can also specify a reason, which is publicly visible. -Bloquear uma conversa cria um evento na linha do tempo visível a qualquer um com acesso de leitura ao repositório. No entanto, o nome de usuário da pessoa que bloqueou a conversa somente pode ser visualizado pelas pessoas com acesso de gravação ao repositório. Para qualquer pessoa sem acesso de gravação, o evento na linha do tempo é anônimo. +Locking a conversation creates a timeline event that is visible to anyone with read access to the repository. However, the username of the person who locked the conversation is only visible to people with write access to the repository. For anyone without write access, the timeline event is anonymized. -![Evento anônimo de linha do tempo de uma conversa bloqueada](/assets/images/help/issues/anonymized-timeline-entry-for-locked-conversation.png) +![Anonymized timeline event for a locked conversation](/assets/images/help/issues/anonymized-timeline-entry-for-locked-conversation.png) -Quando uma conversa é bloqueada, somente [pessoas com acesso de gravação](/articles/repository-permission-levels-for-an-organization/) e [proprietários e colaboradores de repositórios](/articles/permission-levels-for-a-user-account-repository/#collaborator-access-on-a-repository-owned-by-a-user-account) podem adicionar, ocultar ou excluir comentários. +While a conversation is locked, only [people with write access](/articles/repository-permission-levels-for-an-organization/) and [repository owners and collaborators](/articles/permission-levels-for-a-user-account-repository/#collaborator-access-on-a-repository-owned-by-a-user-account) can add, hide, and delete comments. -Para pesquisar conversas bloqueadas em um repositório que não está arquivado, é posível usar os qualificadores de pesquisa `is:locked` e `archived:false`. As conversas são automaticamente bloqueadas em repositórios arquivados. Para obter mais informações, consulte "[Pesquisar problemas e pull requests](/articles/searching-issues-and-pull-requests#search-based-on-whether-a-conversation-is-locked)". +To search for locked conversations in a repository that is not archived, you can use the search qualifiers `is:locked` and `archived:false`. Conversations are automatically locked in archived repositories. For more information, see "[Searching issues and pull requests](/articles/searching-issues-and-pull-requests#search-based-on-whether-a-conversation-is-locked)." -1. Como opção, escreva um comentário explicando por que você está bloqueando a conversa. -2. Na margem direita do problema ou pull request ou acima da caixa de comentários na página de commit, clique em **Lock conversation** (Bloquear conversa). ![Link Lock conversation (Bloquear conversa)](/assets/images/help/repository/lock-conversation.png) -3. Opcionalmente, selecione um motivo para bloquear a conversa. ![Menu Reason for locking a conversation (Motivo para bloquear uma conversa)](/assets/images/help/repository/locking-conversation-reason-menu.png) -4. Leia as informações sobre bloqueio de conversas e clique em **Lock conversation on this issue** (Bloquear conversa sobre este problema), **Lock conversation on this pull request** (Bloquear conversa sobre esta pull request) ou **Lock conversation on this commit** (Bloquear conversa sobre este commit). ![Caixa de diálogo Confirm lock with a reason (Confirmar bloqueio com um motivo)](/assets/images/help/repository/lock-conversation-confirm-with-reason.png) -5. Quando você quiser desbloquear a conversa, clique em **Unlock conversation** (Desbloquear conversa). ![Link Unlock conversation (Desbloquear conversa)](/assets/images/help/repository/unlock-conversation.png) +1. Optionally, write a comment explaining why you're locking the conversation. +2. In the right margin of the issue or pull request, or above the comment box on the commit page, click **Lock conversation**. +![Lock conversation link](/assets/images/help/repository/lock-conversation.png) +3. Optionally, choose a reason for locking the conversation. +![Reason for locking a conversation menu](/assets/images/help/repository/locking-conversation-reason-menu.png) +4. Read the information about locking conversations and click **Lock conversation on this issue**, **Lock conversation on this pull request**, or **Lock conversation on this commit**. +![Confirm lock with a reason dialog box](/assets/images/help/repository/lock-conversation-confirm-with-reason.png) +5. When you're ready to unlock the conversation, click **Unlock conversation**. +![Unlock conversation link](/assets/images/help/repository/unlock-conversation.png) -### Leia mais +### Further reading -- "[Configurar seu projeto para contribuições úteis](/articles/setting-up-your-project-for-healthy-contributions)" -- "[Usando modelos para encorajar problemas úteis e pull requests](/github/building-a-strong-community/using-templates-to-encourage-useful-issues-and-pull-requests)" -- "[Gerenciando comentários disruptivos](/articles/managing-disruptive-comments)"{% if currentVersion == "free-pro-team@latest" %} -- "[Mantendo sua segurança no {% data variables.product.prodname_dotcom %}](/github/building-a-strong-community/maintaining-your-safety-on-github)" -- "[Denunciar abuso ou spam](/articles/reporting-abuse-or-spam)" -- "[Limitando interações em seu repositório](/github/building-a-strong-community/limiting-interactions-in-your-repository)" +- "[Setting up your project for healthy contributions](/articles/setting-up-your-project-for-healthy-contributions)" +- "[Using templates to encourage useful issues and pull requests](/github/building-a-strong-community/using-templates-to-encourage-useful-issues-and-pull-requests)" +- "[Managing disruptive comments](/articles/managing-disruptive-comments)"{% if currentVersion == "free-pro-team@latest" %} +- "[Maintaining your safety on {% data variables.product.prodname_dotcom %}](/github/building-a-strong-community/maintaining-your-safety-on-github)" +- "[Reporting abuse or spam](/articles/reporting-abuse-or-spam)" +- "[Limiting interactions in your repository](/github/building-a-strong-community/limiting-interactions-in-your-repository)" {% endif %} diff --git a/translations/pt-BR/content/github/building-a-strong-community/managing-disruptive-comments.md b/translations/pt-BR/content/github/building-a-strong-community/managing-disruptive-comments.md index 92f8a67683e7..809825ccfb66 100644 --- a/translations/pt-BR/content/github/building-a-strong-community/managing-disruptive-comments.md +++ b/translations/pt-BR/content/github/building-a-strong-community/managing-disruptive-comments.md @@ -1,6 +1,6 @@ --- -title: Gerenciar comentários conflituosos -intro: 'Você pode {% if currentVersion == "free-pro-team@latest" %}ocultar, editar,{% else %}editar{% endif %} ou excluir comentários sobre problemas, pull request e commits.' +title: Managing disruptive comments +intro: 'You can {% if currentVersion == "free-pro-team@latest" %}hide, edit,{% else %}edit{% endif %} or delete comments on issues, pull requests, and commits.' redirect_from: - /articles/editing-a-comment/ - /articles/deleting-a-comment/ @@ -10,69 +10,76 @@ versions: enterprise-server: '*' --- -### Ocultar um comentário +### Hiding a comment -Qualquer pessoa com acesso de gravação em um repositório podem ocultar comentários sobre problemas, pull requests e commits. +Anyone with write access to a repository can hide comments on issues, pull requests, and commits. -Se um comentário não diz respeito ao assunto, está desatualizado ou resolvido, pode ser que você queira ocultar o comentário para manter o foco da discussão ou fazer uma pull request mais simples para navegar e revisar. Comentários ocultos são minimizados, mas as pessoas com acesso de leitura no repositório podem expandi-los. +If a comment is off-topic, outdated, or resolved, you may want to hide a comment to keep a discussion focused or make a pull request easier to navigate and review. Hidden comments are minimized but people with read access to the repository can expand them. -![Comentário minimizado](/assets/images/help/repository/hidden-comment.png) +![Minimized comment](/assets/images/help/repository/hidden-comment.png) -1. Navegue até o comentário que deseja ocultar. -2. No canto superior direito do comentário, clique em {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} e em **Hide** (Ocultar). ![Ícone horizontal kebab e menu comment moderation (moderação de comentários) mostrando as opções edit, hide, delete (editar, ocultar, excluir)](/assets/images/help/repository/comment-menu.png) -3. Com o menu suspenso "Choose a reason" (Selecione um motivo), clique em um motivo para ocultar o comentário. Depois clique em **Hide comment** (Ocultar comentário). +1. Navigate to the comment you'd like to hide. +2. In the upper-right corner of the comment, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Hide**. + ![The horizontal kebab icon and comment moderation menu showing the edit, hide, delete options](/assets/images/help/repository/comment-menu.png) +3. Using the "Choose a reason" drop-down menu, click a reason to hide the comment. Then click, **Hide comment**. {% if currentVersion == "free-pro-team@latest" %} - ![Menu suspenso Choose reason for hiding comment (Selecione um motivo para ocultar o comentário)](/assets/images/help/repository/choose-reason-for-hiding-comment.png) + ![Choose reason for hiding comment drop-down menu](/assets/images/help/repository/choose-reason-for-hiding-comment.png) {% else %} - ![Menu suspenso Choose reason for hiding comment (Selecione um motivo para ocultar o comentário)](/assets/images/help/repository/choose-reason-for-hiding-comment-ghe.png) + ![Choose reason for hiding comment drop-down menu](/assets/images/help/repository/choose-reason-for-hiding-comment-ghe.png) {% endif %} -### Mostrar um comentário +### Unhiding a comment -Qualquer pessoa com acesso de gravação em um repositório pode reexibir comentários sobre problemas, pull requests e commits. +Anyone with write access to a repository can unhide comments on issues, pull requests, and commits. -1. Navegue até o comentário que deseja mostrar. -2. No canto superior direito do comentário, clique em **{% octicon "fold" aria-label="The fold icon" %} Show comment** (Mostrar comentário). ![Mostrar texto de comentário](/assets/images/help/repository/hidden-comment-show.png) -3. No lado direito do comentário expandido, clique em {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} e **Unhide** (Mostrar). ![Ícone horizontal kebab e menu comment moderation (moderação de comentários) mostrando as opções edit, unhide, delete (editar, mostrar, excluir)](/assets/images/help/repository/comment-menu-hidden.png) +1. Navigate to the comment you'd like to unhide. +2. In the upper-right corner of the comment, click **{% octicon "fold" aria-label="The fold icon" %} Show comment**. + ![Show comment text](/assets/images/help/repository/hidden-comment-show.png) +3. On the right side of the expanded comment, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then **Unhide**. + ![The horizontal kebab icon and comment moderation menu showing the edit, unhide, delete options](/assets/images/help/repository/comment-menu-hidden.png) -### Editar um comentário +### Editing a comment -Qualquer pessoa com acesso de gravação em um repositório pode editar comentários sobre problemas, pull requests e commits. +Anyone with write access to a repository can edit comments on issues, pull requests, and commits. -É apropriado editar um comentário e remover conteúdo que não contribui para a conversa e infringe o código de conduta da sua comunidade{% if currentVersion == "free-pro-team@latest" %} ou as [Diretrizes da comunidade](/articles/github-community-guidelines) do GitHub{% endif %}. +It's appropriate to edit a comment and remove content that doesn't contribute to the conversation and violates your community's code of conduct{% if currentVersion == "free-pro-team@latest" %} or GitHub's [Community Guidelines](/articles/github-community-guidelines){% endif %}. -Quando editar um comentário, anote a localização de onde o comentário foi removido e, opcionalmente, os motivos para a remoção. +When you edit a comment, note the location that the content was removed from and optionally, the reason for removing it. -Qualquer pessoa com acesso de leitura em um repositório pode visualizar o histórico de edição do comentário. O menu suspenso **edited** (editado) na parte superior do comentário tem um histório de edições mostrando o usuário e o horário de cada edição. +Anyone with read access to a repository can view a comment's edit history. The **edited** dropdown at the top of the comment contains a history of edits showing the user and timestamp for each edit. -![Comentário com observação adicional que o conteúdo foi redacted (suprimido)](/assets/images/help/repository/content-redacted-comment.png) +![Comment with added note that content was redacted](/assets/images/help/repository/content-redacted-comment.png) -Autores do comentário e pessoas com acesso de gravação a um repositório podem excluir informações confidenciais do histórico de edição de um comentário. Para obter mais informações, consulte "[Controlar as alterações em um comentário](/github/building-a-strong-community/tracking-changes-in-a-comment)". +Comment authors and anyone with write access to a repository can also delete sensitive information from a comment's edit history. For more information, see "[Tracking changes in a comment](/github/building-a-strong-community/tracking-changes-in-a-comment)." -1. Navegue até o comentário que deseja editar. -2. No canto superior direito do comentário, clique em{% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} e em **Edit** (Editar). ![Ícone horizontal kebab e menu comment moderation (moderação de comentários) mostrando as opções edit, hide, delete e report (editar, ocultar, excluir e denunciar)](/assets/images/help/repository/comment-menu.png) -3. Na janela do comentário, exclua o conteúdo que deseja remover e digite `[REDACTED]` para substitui-lo. ![Janela de comentário com conteúdo redacted (suprimido)](/assets/images/help/issues/redacted-content-comment.png) -4. Na parte inferior do comentário, digite uma observação indicando que editou o comentário e, opcionalmente, o motivo da edição. ![Janela de comentário com observação adicional que o conteúdo foi redacted (suprimido)](/assets/images/help/issues/note-content-redacted-comment.png) -5. Clique em **Update comment** (Atualizar comentário). +1. Navigate to the comment you'd like to edit. +2. In the upper-right corner of the comment, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Edit**. + ![The horizontal kebab icon and comment moderation menu showing the edit, hide, delete, and report options](/assets/images/help/repository/comment-menu.png) +3. In the comment window, delete the content you'd like to remove, then type `[REDACTED]` to replace it. + ![Comment window with redacted content](/assets/images/help/issues/redacted-content-comment.png) +4. At the bottom of the comment, type a note indicating that you have edited the comment, and optionally, why you edited the comment. + ![Comment window with added note that content was redacted](/assets/images/help/issues/note-content-redacted-comment.png) +5. Click **Update comment**. -### Excluir um comentário +### Deleting a comment -Qualquer pessoa com acesso de gravação em um repositório pode excluir comentários sobre problemas, pull requests e commits. Proprietários de organização, mantenedores de equipes e o autor do comentário também podem excluir um comentário na página da equipe. +Anyone with write access to a repository can delete comments on issues, pull requests, and commits. Organization owners, team maintainers, and the comment author can also delete a comment on a team page. -Excluir um comentário é o seu último recurso como moderador. É adequado excluir um comentário se o comentário em sua totalidade não contribui com conteúdo construtivo para uma conversa e infringe o código de conduta da sua comunidade{% if currentVersion == "free-pro-team@latest" %} ou as [Diretrizes da comunidade](/articles/github-community-guidelines) do GitHub{% endif %}. +Deleting a comment is your last resort as a moderator. It's appropriate to delete a comment if the entire comment adds no constructive content to a conversation and violates your community's code of conduct{% if currentVersion == "free-pro-team@latest" %} or GitHub's [Community Guidelines](/articles/github-community-guidelines){% endif %}. -Excluir um comentário cria um evento na linha do tempo visível a qualquer um com acesso de leitura no repositório. No entanto, o nome de usuário da pessoa que excluiu o comentário somente pode ser visualizado pelas pessoas com acesso de gravação ao repositório. Para qualquer pessoa sem acesso de gravação, o evento na linha do tempo é anônimo. +Deleting a comment creates a timeline event that is visible to anyone with read access to the repository. However, the username of the person who deleted the comment is only visible to people with write access to the repository. For anyone without write access, the timeline event is anonymized. -![Evento anônimo de linha do tempo de um comentário excluído](/assets/images/help/issues/anonymized-timeline-entry-for-deleted-comment.png) +![Anonymized timeline event for a deleted comment](/assets/images/help/issues/anonymized-timeline-entry-for-deleted-comment.png) -Se o comentário contém algum conteúdo construtivo que contribui para a conversa sobre o problema ou pull request, você pode editar o comentário. +If a comment contains some constructive content that adds to the conversation in the issue or pull request, you can edit the comment instead. {% note %} -**Observação:** o comentário inicial (ou texto) de um problema ou pull request não pode ser excluído. Entretanto, você pode editar textos de problemas e pull requests para remover conteúdo indesejável. +**Note:** The initial comment (or body) of an issue or pull request can't be deleted. Instead, you can edit issue and pull request bodies to remove unwanted content. {% endnote %} -1. Navegue até o comentário que deseja excluir. -2. No canto superior direito do comentário, clique em {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} e em **Delete** (Excluir). ![Ícone horizontal kebab e menu comment moderation (moderação de comentários) mostrando as opções edit, hide, delete e report (editar, ocultar, excluir e denunciar)](/assets/images/help/repository/comment-menu.png) -3. Opcionalmente, escreva um comentário informando que você deletou o comentário e por quê. +1. Navigate to the comment you'd like to delete. +2. In the upper-right corner of the comment, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Delete**. + ![The horizontal kebab icon and comment moderation menu showing the edit, hide, delete, and report options](/assets/images/help/repository/comment-menu.png) +3. Optionally, write a comment noting that you deleted a comment and why. diff --git a/translations/pt-BR/content/github/building-a-strong-community/pinning-a-team-discussion.md b/translations/pt-BR/content/github/building-a-strong-community/pinning-a-team-discussion.md index dd33ac7e3909..c64be7ab123b 100644 --- a/translations/pt-BR/content/github/building-a-strong-community/pinning-a-team-discussion.md +++ b/translations/pt-BR/content/github/building-a-strong-community/pinning-a-team-discussion.md @@ -1,6 +1,6 @@ --- title: Fixar uma discussão de equipe -intro: Você pode fixar discussões importantes nas páginas da equipe da organização para facilitar a consulta e desafixar discussões que não são mais relevantes. +intro: 'Você pode fixar discussões importantes nas páginas da equipe da organização para facilitar a consulta e desafixar discussões que não são mais relevantes.' redirect_from: - /articles/pinning-a-team-discussion versions: diff --git a/translations/pt-BR/content/github/building-a-strong-community/reporting-abuse-or-spam.md b/translations/pt-BR/content/github/building-a-strong-community/reporting-abuse-or-spam.md index 8cbc921b9140..ef60acd04692 100644 --- a/translations/pt-BR/content/github/building-a-strong-community/reporting-abuse-or-spam.md +++ b/translations/pt-BR/content/github/building-a-strong-community/reporting-abuse-or-spam.md @@ -58,7 +58,7 @@ Se o conteúdo denunciado estiver ativado para um repositório público, você t - "[Configurar seu projeto para contribuições úteis](/articles/setting-up-your-project-for-healthy-contributions)" - "[Usando modelos para encorajar problemas úteis e pull requests](/github/building-a-strong-community/using-templates-to-encourage-useful-issues-and-pull-requests)" -- "[Gerenciando comentários disruptivos](/articles/managing-disruptive-comments)"{% if currentVersion == "free-pro-team@latest" %} +- "[Gerenciar comentários disruptivos](/articles/managing-disruptive-comments)"{% if currentVersion == "free-pro-team@latest" %} - "[Mantendo sua segurança no {% data variables.product.prodname_dotcom %}](/github/building-a-strong-community/maintaining-your-safety-on-github)" - "[Limitando interações em seu repositório](/github/building-a-strong-community/limiting-interactions-in-your-repository)"{% endif %} - "[Controlar as alterações em um comentário](/articles/tracking-changes-in-a-comment)" diff --git a/translations/pt-BR/content/github/building-a-strong-community/setting-guidelines-for-repository-contributors.md b/translations/pt-BR/content/github/building-a-strong-community/setting-guidelines-for-repository-contributors.md index 3ee11a24b3b9..997d049cb328 100644 --- a/translations/pt-BR/content/github/building-a-strong-community/setting-guidelines-for-repository-contributors.md +++ b/translations/pt-BR/content/github/building-a-strong-community/setting-guidelines-for-repository-contributors.md @@ -19,7 +19,7 @@ Para contribuidores, as diretrizes ajudam a verificar se eles estão enviando pu Para proprietários e contribuidores, as diretrizes de contribuição economizam tempo e evitam aborrecimentos causados por pull requests ou problemas incorretos que precisam ser rejeitados e enviados novamente. -Você pode criar diretrizes de contribuição padrão para sua organização{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} ou conta de usuário{% endif %}. Para obter mais informações, consulte "[Criando um arquivo padrão de integridade da comunidade](/github/building-a-strong-community/creating-a-default-community-health-file)." +Você pode criar diretrizes de contribuição padrão para a organização{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} ou conta de usuário{% endif %}. Para obter mais informações, consulte "[Criando um arquivo padrão de integridade da comunidade](/github/building-a-strong-community/creating-a-default-community-health-file)." {% tip %} @@ -51,6 +51,6 @@ Caso tenha dúvidas, estes são alguns bons exemplos de diretrizes de contribui - [Diretrizes de contribuição](https://github.com/opengovernment/opengovernment/blob/master/CONTRIBUTING.md) do Open Government. ### Leia mais -- Seção "[Iniciar um projeto de código aberto](https://opensource.guide/starting-a-project/)" de Guias de código aberto{% if currentVersion == "free-pro-team@latest" %} +- A seção "Guias de código aberto"[Iniciar um projeto de código aberto](https://opensource.guide/starting-a-project/)"{% if currentVersion == "free-pro-team@latest" %} - [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}){% endif %} - "[Adicionar uma licença a um repositório](/articles/adding-a-license-to-a-repository)" diff --git a/translations/pt-BR/content/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions.md b/translations/pt-BR/content/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions.md index 1bd57bfceb1f..067bbef7b383 100644 --- a/translations/pt-BR/content/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions.md +++ b/translations/pt-BR/content/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions.md @@ -1,6 +1,6 @@ --- title: Configurar projeto para contribuições úteis -intro: Os mantenedores de repositório podem definir diretrizes de contribuição para ajudar os colaboradores a fazer contribuições relevantes e úteis a um projeto. +intro: 'Os mantenedores de repositório podem definir diretrizes de contribuição para ajudar os colaboradores a fazer contribuições relevantes e úteis a um projeto.' redirect_from: - /articles/helping-people-contribute-to-your-project/ - /articles/setting-up-your-project-for-healthy-contributions diff --git a/translations/pt-BR/content/github/building-a-strong-community/tracking-changes-in-a-comment.md b/translations/pt-BR/content/github/building-a-strong-community/tracking-changes-in-a-comment.md index 1dfb64c1d94d..0d5f7e5e9438 100644 --- a/translations/pt-BR/content/github/building-a-strong-community/tracking-changes-in-a-comment.md +++ b/translations/pt-BR/content/github/building-a-strong-community/tracking-changes-in-a-comment.md @@ -28,5 +28,5 @@ Quando você exclui informações confidenciais do histórico de edição do com ### Leia mais -{% if currentVersion == "free-pro-team@latest" %}- "[Denunciar abuso ou spam](/articles/reporting-abuse-or-spam)"{% endif %} +{% if currentVersion == "free-pro-team@latest" %}- "[Relatar abuso ou spam](/articles/reporting-abuse-or-spam)"{% endif %} - "[Editar um comentário](/articles/editing-a-comment)" diff --git a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-branches.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-branches.md index d58b0ba23724..76407d888b07 100644 --- a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-branches.md +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-branches.md @@ -1,6 +1,6 @@ --- title: Sobre branches -intro: Use um branch para isolar o trabalho de desenvolvimento sem afetar outros branches no repositório. Cada repositório tem um branch padrão e pode ter vários outros branches. Você pode fazer merge de um branch em outro branch usando uma pull request. +intro: 'Use um branch para isolar o trabalho de desenvolvimento sem afetar outros branches no repositório. Cada repositório tem um branch padrão e pode ter vários outros branches. Você pode fazer merge de um branch em outro branch usando uma pull request.' redirect_from: - /articles/working-with-protected-branches/ - /articles/about-branches @@ -10,28 +10,30 @@ versions: --- -### O que são branches? +### Sobre branches Os branches permitem que você desenvolva recursos, corrija erros ou experimente com segurança novas ideias em uma área contida do seu repositório. Você sempre cria um branch a partir de um branch existente. Normalmente, você pode criar um novo branch a partir do branch-padrão do seu repositório. Você então poderá trabalhar nesse novo branch isolado das mudanças que outras pessoas estão fazendo no repositório. Um branch que você cria para produzir um recurso é comumente referido como um branch de recurso ou branch de tópico. Para obter mais informações, consulte "[Criar e excluir branches em seu repositório](/articles/creating-and-deleting-branches-within-your-repository/)". -Também é possível usar um branch para publicar um site do {% data variables.product.prodname_pages %}. Para obter mais informações, consulte "[O que é {% data variables.product.prodname_dotcom %} Pages?](/articles/what-is-github-pages)" +Também é possível usar um branch para publicar um site do {% data variables.product.prodname_pages %}. Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_pages %}](/articles/what-is-github-pages)". -Você deve ter acesso de gravação em um repositório para criar um branch, abrir uma pull request ou excluir e restaurar branches em uma pull request. Para obter mais informações, consulte "[Permissões de acesso no {% data variables.product.product_name %}](/articles/access-permissions-on-github)". +Você deve ter acesso de gravação em um repositório para criar um branch, abrir uma pull request ou excluir e restaurar branches em uma pull request. Para obter mais informações, consulte "[Permissões de acesso em {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/access-permissions-on-github)." ### Sobre o branch-padrão {% data reusables.branches.new-repo-default-branch %} O branch-padrão é o branch que {% data variables.product.prodname_dotcom %} exibe quando alguém visita o seu repositório. O branch-padrão é também o branch inicial que o Git verifica localmente quando alguém clona o repositório. {% data reusables.branches.default-branch-automatically-base-branch %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +Por padrão, {% data variables.product.product_name %} nomeia o branch-padrão {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 3" %}`o principal`{% else %}`mestre`{% endif %} em qualquer novo repositório. -Por padrão, o nome padrão do branch-padrão é `mestre`, mas você pode definir o nome como qualquer coisa que faça sentido para o seu fluxo de trabalho. Para obter mais informações sobre o nome do branch-padrão, consulte "[Gerenciar o nome do branch-padrão para os seus repositórios](/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories). +{% data reusables.branches.change-default-branch %} -{% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} {% data reusables.branches.set-default-branch %} +{% endif %} + ### Trabalhando com branches Quando estiver satisfeito com seu trabalho, você poderá abrir uma pull request para fazer merge das alterações do branch atual (o branch *head*) com outro branch (o branch *base*). Para obter mais informações, consulte "[Sobre pull requests](/articles/about-pull-requests)". @@ -71,7 +73,7 @@ Quando um branch estiver protegido: - Se as verificações de status obrigatórias forem habilitadas no branch, não será possível fazer merge das alterações no branch até que todos os testes de CI obrigatórios sejam aprovados. Para obter mais informações, consulte "[Sobre verificações de status](/articles/about-status-checks)". - Se as revisões obrigatórias de pull request forem habilitadas no branch, não será possível fazer merge de alterações no branch até que todos os requisitos na política da revisão de pull request tenham sido atendidos. Para obter mais informações, consulte "[Fazer merge de uma pull request](/articles/merging-a-pull-request)". - Se a revisão obrigatória de um proprietário do código for habilitada em um branch, e uma pull request modificar o código que tem um proprietário, um proprietário do código deverá aprovar a pull request para que ela possa passar por merge. Para obter mais informações, consulte "[Sobre proprietários do código](/articles/about-code-owners)". -- Se a assinatura de commit obrigatória for habilitada em um branch, não será possível fazer push de qualquer commit no branch que não esteja assinado e verificado. Para obter mais informações, consulte "[Sobre a verificação da assinatura de commit](/articles/about-commit-signature-verification)" e "[Sobre a assinatura de commit obrigatória](/articles/about-required-commit-signing)".{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} +- Se a assinatura de commit obrigatória for habilitada em um branch, não será possível fazer push de qualquer commit no branch que não esteja assinado e verificado. Para obter mais informações, consulte "[Sobre verificação de assinatura de commit](/articles/about-commit-signature-verification)" e "[Sobre a assinatura de commit necessária](/articles/about-required-commit-signing). {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} - Se você usar o editor de conflitos do {% data variables.product.prodname_dotcom %} para corrigir conflitos para uma pull request que você criou de um branch protegido, o {% data variables.product.prodname_dotcom %} ajuda você a criar um branch alternativo para o pull request, para que sua resolução de conflitos possa ser mesclada. Para obter mais informações, consulte "[Resolvendo um conflito de merge no {% data variables.product.prodname_dotcom %}](/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github)".{% endif %} ### Leia mais diff --git a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md index 27be5fdff54a..ef5682ad0872 100644 --- a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md @@ -38,7 +38,7 @@ Também é possível optar por ignorar alterações de espaço em branco para ob ![Menu de opções para exibição de diff](/assets/images/help/pull_requests/diff-settings-menu.png) -Para simplificar a revisão das alterações em uma pull request extensa, é possível filtrar o diff para mostrar apenas os tipos de arquivo selecionados{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}, mostrar arquivos dos quais você é CODEOWNER, ocultar arquivos que você já visualizou {% endif %} ou ocultar arquivos excluídos. Para obter mais informações, consulte "[Filtrar aquivos em uma pull request por tipo de arquivo](/articles/filtering-files-in-a-pull-request)". +Para simplificar a revisão das alterações em um pull request extenso, é possível filtrar o diff para mostrar apenas os tipos de arquivo selecionados, mostrar arquivos dos quais você é CODEOWNER, ocultar arquivos que você já visualizou ou ocultar arquivos excluídos. Para obter mais informações, consulte "[Filtrar aquivos em uma pull request por tipo de arquivo](/articles/filtering-files-in-a-pull-request)". ![Menu suspenso File filter (Filtro de arquivo)](/assets/images/help/pull_requests/file-filter-menu.png) @@ -54,7 +54,7 @@ Um diff de dois pontos compara duas referências de committish do Git, como SHAs Se desejar simular um diff de dois pontos em uma pull request e ver uma comparação entre as versões mais recentes de cada branch, você poderá fazer merge do branch base no branch de tópico, o que atualiza o último ancestral comum entre seus branches. -Para obter mais informações sobre os comandos do Git para comparar alterações, consulte "[Opções de diff do Git](https://git-scm.com/docs/git-diff#git-diff-emgitdiffemltoptionsgtltcommitgtltcommitgt--ltpathgt82308203)" no book site do _Pro Git_. +Para obter mais informações sobre os comandos do Git para comparar alterações, consulte "[Opções de diff do Git](https://git-scm.com/docs/git-diff#git-diff-emgitdiffemltoptionsgtltcommitgtltcommitgt--ltpathgt82308203)" no site do livro do _Pro Git_. ### Motivos pelos quais os diffs não serão exibidos - Você excedeu o limite total de arquivos ou de determinados tipos de arquivo. Para obter mais informações, consulte "[Limites para exibição de conteúdo e diffs em um repositório](/articles/limits-for-viewing-content-and-diffs-in-a-repository/#diff-limits)". diff --git a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github.md index 29f290963b10..3467492ee0eb 100644 --- a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github.md +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github.md @@ -19,7 +19,7 @@ Os problemas são úteis para discutir detalhes específicos de um projeto, como ### Reagir às ideias nos comentários -Você pode concordar ou discordar de uma ideia em uma conversa. Quando você adiciona uma reação a um comentário ou ao texto de uma discussão de equipe, de um problema ou de uma pull request, as pessoas inscritas na conversa não receberão uma notificação. Para obter mais informações sobre assinaturas, consulte {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[Sobre notificações](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}"[Cadastrando-se e descadastrando-se de notificações](/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)"{% endif %}." +Você pode concordar ou discordar de uma ideia em uma conversa. Quando você adiciona uma reação a um comentário ou ao texto de uma discussão de equipe, de um problema ou de uma pull request, as pessoas inscritas na conversa não receberão uma notificação. Para obter mais informações sobre assinaturas, consulte {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 0" %}"[Sobre as notificações](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}"[Assinar e cancelar assinatura das notificações](/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications){% endif %}". ![Exemplo de um problema com reações](/assets/images/help/repository/issue-reactions.png) diff --git a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-forks.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-forks.md index e92a82267794..b27d75063cf7 100644 --- a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-forks.md +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-forks.md @@ -17,13 +17,13 @@ Bifurcar um repositório é semelhante a copiar um repositório, com duas grande {% data reusables.repositories.desktop-fork %} -Excluir uma bifurcação não exclui o repositório upstream original. Você pode fazer quaisquer alterações que quiser em sua bifurcação — adicionar colaboradores, renomear arquivos, gerar {% data variables.product.prodname_pages %}— sem efeito no original.{% if currentVersion == "free-pro-team@latest" %} Você não pode restaurar um repositório bifurcado excluído. Para obter mais informações, consulte "[Restaurar um repositório excluído](/articles/restoring-a-deleted-repository)".{% endif %} +Excluir uma bifurcação não exclui o repositório upstream original. Você pode fazer as alterações que desejar na sua bifurcação — adicionar colaboradores, renomear arquivos, gerar {% data variables.product.prodname_pages %}— sem efeito no original.{% if currentVersion == "free-pro-team@latest" %} Você não pode restaurar um repositório excluído. Para obter mais informações, consulte "[Restaurar um repositório excluído](/articles/restoring-a-deleted-repository)".{% endif %} Em projetos de código aberto, as bifurcações são usadas com frequência para iterar ideias ou alterações antes que elas sejam oferecidas de volta ao repositório upstream. Ao fazer alterações em sua bifurcação user-owned e abrir uma pull request que compara seu trabalho com o repositório upstream, você pode dar a qualquer pessoa com acesso push ao repositório upstream permissão para fazer push das alterações no seu branch de pull requests. Isso agiliza a colaboração ao permitir que os mantenedores de repositório façam commits ou executem testes localmente em seu branch de pull requests a partir de uma bifurcação de propriedade do usuário antes de fazer merge. Você não pode dar permissões de push a uma bifurcação de propriedade de uma organização. {% data reusables.repositories.private_forks_inherit_permissions %} -Se desejar criar um novo repositório a partir do conteúdo de um repositório existente, mas não quiser fazer merge do upstream de alterações no futuro, você poderá duplicar o repositório {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}ou, se o repositório for um modelo, usar o repositório como um modelo{% endif %}. Para obter mais informações, consulte "[Duplicar um repositório](/articles/duplicating-a-repository)"{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} e "[Criar um repositório de um modelo](/articles/creating-a-repository-from-a-template)"{% endif %}. +Se você desejar criar um novo repositório a partir do conteúdo de um repositório existente, mas não desejar mesclar suas alterações a montante no futuro, Você pode duplicar o repositório ou, se o repositório for um modelo, você poderá usar o repositório como um modelo. Para obter mais informações, consulte "[Duplicar um repositório](/articles/duplicating-a-repository)" e "[Criar um repositório de um modelo](/articles/creating-a-repository-from-a-template)". ### Leia mais diff --git a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-merge-conflicts.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-merge-conflicts.md index cd5afc0bed7f..43c89164db65 100644 --- a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-merge-conflicts.md +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-merge-conflicts.md @@ -1,6 +1,6 @@ --- title: Sobre conflitos de merge -intro: Os conflitos de merge acontecem quando você faz merge de branches que têm commits concorrentes e o Git precisa da sua ajuda para decidir quais alterações incorporar n merge final. +intro: 'Os conflitos de merge acontecem quando você faz merge de branches que têm commits concorrentes e o Git precisa da sua ajuda para decidir quais alterações incorporar n merge final.' redirect_from: - /articles/about-merge-conflicts versions: diff --git a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-reviews.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-reviews.md index ef44099c506a..9ae4f6ec345c 100644 --- a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-reviews.md +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-reviews.md @@ -12,11 +12,11 @@ versions: Após a abertura de uma pull request, qualquer pessoa com acesso *de leitura* pode revisar e comentar nas alterações que ela propõe. Você também pode sugerir alterações específicas às linhas de código, que o autor pode aplicar diretamente a partir da pull request. Para obter mais informações, consulte "[Revisar alterações propostas em uma pull request](/articles/reviewing-proposed-changes-in-a-pull-request)". -Os proprietários de repositório e colaboradores podem solicitar uma revisão de pull request de uma pessoa específica. Os integrantes da organização também podem solicitar uma revisão de pull request de uma equipe com acesso de leitura ao repositório. Para obter mais informações, consulte "[Solicitar uma revisão de pull request](/articles/requesting-a-pull-request-review)". {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}Você pode especificar um subconjunto de integrantes da equipe que será automaticamente responsável no lugar de toda a equipe. Para obter mais informações, consulte "[Gerenciando a responsabilidade pela revisão de código para sua equipe](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)."{% endif %} +Os proprietários de repositório e colaboradores podem solicitar uma revisão de pull request de uma pessoa específica. Os integrantes da organização também podem solicitar uma revisão de pull request de uma equipe com acesso de leitura ao repositório. Para obter mais informações, consulte "[Solicitar uma revisão de pull request](/articles/requesting-a-pull-request-review)". {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 9" %}Você pode especificar um subconjunto de integrantes da equipe a ser atribuído automaticamente no lugar de toda a equipe. Para obter mais informações, consulte "[Gerenciando a responsabilidade pela revisão de código para sua equipe](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)."{% endif %} As revisões permitem discussão das alterações propostas e ajudam a garantir que as alterações atendam às diretrizes de contribuição do repositório e outros padrões de qualidade. Você pode definir quais indivíduos ou equipes possuem determinados tipos de área de código em um arquivo CODEOWNERS. Quando uma pull request modifica código que tem um proprietário definido, esse indivíduo ou equipe será automaticamente solicitado como um revisor. Para obter mais informações, consulte "[Sobre proprietários de código](/articles/about-code-owners/)". -{% if currentVersion == "free-pro-team@latest" %}Você pode agendar lembretes para pull requests que precisam ser revisadas. Para obter mais informações, consulte "[Gerenciando os lembretes agendados para pull request](/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests)."{% endif %} +{% if currentVersion == "free-pro-team@latest" %}Você pode agendar lembretes para pull requests que deve ser revisados. Para obter mais informações, consulte "[Gerenciando os lembretes agendados para pull request](/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests)."{% endif %} ![Header de revisão solicitando alterações com comentários em linha](/assets/images/help/pull_requests/review-header-with-line-comment.png) diff --git a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md index b6bbbe5fc58d..ffdefb360c7f 100644 --- a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md @@ -46,7 +46,7 @@ Você pode navegar entre os resumos das verificações de vários commits em uma #### Ignorar e solicitar verificações para commits individuais -Quando um repositório é definido para solicitar verificações por pushes automaticamente, você pode optar por ignorar as verificações para um commit individual do qual fez push. Quando um repositório _não_ é definido para solicitar verificações por pushes automaticamente, você pode solicitar verificações para um commit individual do qual fez push. Para obter mais informações sobre essas configurações, consulte "[Conjuntos de verificações](/v3/checks/suites/#set-preferences-for-check-suites-on-a-repository)". +Quando um repositório é definido para solicitar verificações por pushes automaticamente, você pode optar por ignorar as verificações para um commit individual do qual fez push. Quando um repositório _não_ é definido para solicitar verificações por pushes automaticamente, você pode solicitar verificações para um commit individual do qual fez push. Para obter mais informações sobre essas configurações, consulte "[Conjuntos de verificações](/rest/reference/checks#update-repository-preferences-for-check-suites)". Para ignorar ou solicitar verificações para seu commit, adicione uma das seguintes linhas de trailer ao fim da mensagem do commit: diff --git a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/changing-the-stage-of-a-pull-request.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/changing-the-stage-of-a-pull-request.md index 22439bd67fb8..41b060b1d325 100644 --- a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/changing-the-stage-of-a-pull-request.md +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/changing-the-stage-of-a-pull-request.md @@ -1,6 +1,6 @@ --- title: Alterar o stage de uma pull request -intro: 'Você pode marcar uma pull request de rascunho como pronta para revisão{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} ou converter uma pull request para rascunho{% endif %}.' +intro: 'Você pode marcar um rascunho de pull request como pronto para a revisão{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 0" %} ou converter um pull request em um rascunho{% endif %}.' permissions: Pessoas com permissões de gravação em um repositório e autores de pull request podem alterar o stage de uma pull request. product: '{% data reusables.gated-features.draft-prs %}' redirect_from: diff --git a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally.md index 42efaa4cb816..3b2d83878696 100644 --- a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally.md +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally.md @@ -18,7 +18,7 @@ versions: ### Modificar uma pull request ativa no local {% data reusables.repositories.sidebar-pr %} -2. Na lista de pull requests, clique na pull request que você gostaria de modificar.{% if currentVersion == "free-pro-team@latest" %} +2. Na lista de pull requests, clique no pull request que deseja modificar.{% if currentVersion == "free-pro-team@latest" %} 3. Para escolher onde você gostaria de abrir a pull request, selecione **Abrir com o menu suspenso {% octicon "triangle-down" aria-label="The down triangle icon" %}** e clique em uma das abas. ![Link to access command line pull request instructions](/assets/images/help/pull_requests/open-with-button.png){% else %} 3. Na caixa de merge, clique em **instruções para linha de comando**. Siga a sequência de etapas para rebaixar a pull request proposta. ![Link para acessar instruções de pull request da linha de comando](/assets/images/help/pull_requests/pull_request_show_command_line_merge.png) 4. Como opção, para exibir as alterações propostas no {% data variables.product.prodname_desktop %}, clique em **abrir em {% data variables.product.prodname_desktop %}**. ![Link para abrir uma pull request localmente no Desktop](/assets/images/help/desktop/open-pr-in-desktop.png){% endif %} diff --git a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/collaborating-on-repositories-with-code-quality-features.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/collaborating-on-repositories-with-code-quality-features.md index 0ec3a9d3dc81..95ca378e1e12 100644 --- a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/collaborating-on-repositories-with-code-quality-features.md +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/collaborating-on-repositories-with-code-quality-features.md @@ -1,6 +1,6 @@ --- -title: Colaborar nos repositórios com recursos de qualidade de código -intro: 'Os recursos de qualidade do fluxo de trabalho, como status, {% if currentVersion != "free-pro-team@latest" %}hooks pre-receive, {% endif %}branches protegidos e verificações de status obrigatórias ajudam os colaboradores a fazer contribuições que atendem às condições definidas pela organização e por administradores de repositório.' +title: Collaborating on repositories with code quality features +intro: 'Workflow quality features like statuses, {% if currentVersion != "free-pro-team@latest" %}pre-receive hooks, {% endif %}protected branches, and required status checks help collaborators make contributions that meet conditions set by organization and repository administrators.' mapTopic: true redirect_from: - /articles/collaborating-on-repositories-with-code-quality-features-enabled/ diff --git a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request.md index 3fc57e5d0828..0c8bce9c2341 100644 --- a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request.md +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request.md @@ -54,5 +54,5 @@ Qualquer pessoa que inspeciona a pull request ou o repositório receberá uma no ### Leia mais - "[Criar um link permanente em um trecho de código](/articles/creating-a-permanent-link-to-a-code-snippet/)" -{% if currentVersion == "free-pro-team@latest" %}- "[Denunciar abuso ou spam](/articles/reporting-abuse-or-spam)" +{% if currentVersion == "free-pro-team@latest" %}- "[Relatar abuso ou spam](/articles/reporting-abuse-or-spam)" {% endif %} diff --git a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md index ae1a58e2c13b..bffdf8b73bea 100644 --- a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md @@ -22,7 +22,9 @@ Somente o usuário que criou a pull request pode dar a você permissão para faz {% endnote %} -1. No {% data variables.product.product_name %}, navegue até a página principal da bifurcação (ou cópia do repositório) onde o branch da pull request foi criado. +1. Em + +{% data variables.product.product_name %}, acesse a página principal da bifurcação (ou cópia do seu repositório) onde o branch do pull request foi criado. {% data reusables.repositories.copy-clone-url %} {% data reusables.command_line.open_the_multi_os_terminal %} {% tip %} diff --git a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md index ac7c576255b0..8a9affa92c34 100644 --- a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md @@ -18,7 +18,7 @@ Qualquer pessoa com permissões de leitura em um repositório pode criar uma pul ### Alterar o intervalo de branches e o repositório de destino -Por padrão, as pull requests são baseadas no [branch padrão](/articles/setting-the-default-branch) do repositório principal. +Por padrão, as pull requests são baseadas no [branch padrão](/articles/setting-the-default-branch) do repositório principal. Para obter mais informações, consulte "[Sobre branches](/github/collaborating-with-issues-and-pull-requests/about-branches#about-the-default-branch)". Se o repositório principal padrão não estiver correto, você poderá alterar o repositório principal e o branch com as listas suspensas. Também é possível trocar o head e os branches base com as listas suspensas para estabelecer diffs entre pontos de referência. As referências aqui devem ser nomes de branch no seu repositório do GitHub. diff --git a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md index 7fafd87b2cce..bb80ba590a16 100644 --- a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md @@ -14,14 +14,10 @@ Isso altera o status da revisão para um comentário de revisão. Quando você i {% data reusables.search.requested_reviews_search %} {% data reusables.repositories.sidebar-pr %} -{% data reusables.repositories.choose-pr-review %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} +{% data reusables.repositories.choose-pr-review %} 3. Na guia "Conversation" (Conversa), role até a revisão a ser ignorada e clique em {% octicon "chevron-down" aria-label="The down button" %}. ![Ícone de divisa na caixa de merge](/assets/images/help/pull_requests/merge_box/pull-request-open-menu.png) 4. Clique em {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} e depois em **Dismiss review** (Ignorar revisão). ![Ícone de kebab na caixa de merge](/assets/images/help/pull_requests/merge_box/pull-request-dismiss-review.png) 5. Digite o motivo para ignorá-la e clique em **Dismiss review** (Ignorar revisão). ![Botão Dismiss review (Ignorar revisão)](/assets/images/help/pull_requests/merge_box/pull-request-dismiss-review-button.png) -{% else %} -3. Na guia "Conversation" (Conversa), role até a revisão que deseja ver e clique em **Dismiss review** (Ignorar revisão). ![Opção de ignorar uma revisão](/assets/images/help/pull_requests/merge_box/pull-request-dismiss-review.png) -4. Digite o motivo para ignorá-la e clique em **Dismiss review** (Ignorar revisão). ![Botão Dismiss review (Ignorar revisão)](/assets/images/help/pull_requests/merge_box/pull-request-dismiss-review-button.png) -{% endif %} ### Leia mais diff --git a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md index 5c8f02acb28e..23c4687b7648 100644 --- a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md @@ -9,11 +9,11 @@ versions: enterprise-server: '*' --- -Você pode filtrar arquivos em uma pull request pelo tipo de extensão do arquivo, como `.html` ou `.js`, sem extensão, {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} propriedade de código, {% endif %} ou dotfiles. +Você pode filtrar arquivos em um pull request por tipo de extensão de arquivo, como `. tml` ou `.js`, falta de uma extensão, propriedade de código ou dotfiles. {% tip %} -**Dica:** para simplificar a visualização do diff da pull request, também é possível ocultar temporariamente os arquivos excluídos{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} ou aqueles que você já visualizou {% endif %}no diff da pull request, a partir menu suspenso file filter (filtro de arquivo). +**Dica:** para simplificar a visualização do diff do pull request, também é possível ocultar temporariamente os arquivos excluídos ou aqueles que você já visualizou no diff do pull request a partir menu suspenso Filtro de arquivo. {% endtip %} diff --git a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md index 2cb493808c13..b06ce84ecbee 100644 --- a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md @@ -45,7 +45,7 @@ Se decidir que não quer que as alterações em um branch de tópico sofram merg 6. Clique em **Confirm merge** (Confirmar merge), **Confirm squash and merge** (Confirmar combinação por squash e merge) ou **Confirm rebase and merge** (Confirmar rebase e merge). 6. Opcionalmente, [exclua o branch](/articles/deleting-unused-branches). Assim, a lista de branches do repositório ficará limpa. - {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}O repositório pode ser configurado para que o branch principal de uma pull request seja excluído automaticamente quando você faz o merge em uma pull request. Para obter mais informações, consulte "[Gerenciar a exclusão automática de branches](/github/administering-a-repository/managing-the-automatic-deletion-of-branches)".{% endif %} +O repositório pode ser configurado para que o branch principal de um pull request seja excluído automaticamente quando você faz o merge de um pull request. Para obter mais informações, consulte "[Gerenciar a exclusão automática de branches](/github/administering-a-repository/managing-the-automatic-deletion-of-branches)". {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} {% note %} diff --git a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md index 056f9d734048..0cc7b70f116e 100644 --- a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md @@ -12,7 +12,7 @@ versions: 2. Altere o diretório de trabalho atual referente ao seu projeto local. 3. Faça checkout do branch que deseja fazer merge. Normalmente, você fará o merge no branch-padrão. ```shell - $ git checkout master + $ git checkout DEFAULT_BRANCH_NAME ``` 4. Faça pull do branch desejado do repositório upstream. Esse método guardará o histórico do commit sem modificações. ```shell @@ -23,5 +23,5 @@ versions: 7. Revise as alterações e certifique-se de que são adequadas. 8. Faça push do merge para o seu repositório GitHub. ```shell - $ git push origin master + $ git push origin DEFAULT_BRANCH_NAME ``` diff --git a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/requesting-a-pull-request-review.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/requesting-a-pull-request-review.md index fe78583ec422..8b9afeabf4d6 100644 --- a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/requesting-a-pull-request-review.md +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/requesting-a-pull-request-review.md @@ -10,7 +10,7 @@ versions: Proprietários e colaboradores de um repositório pertencente a uma conta de usuário podem atribuir revisões de pull requests. Os integrantes da organização com permissões de triagem em um repositório podem atribuir uma revisão de pull request. -Os proprietários e colaboradores podem atribuir uma revisão de pull request a qualquer pessoa que recebeu explicitamente [acesso de leitura](/articles/access-permissions-on-github) em um repositório pertencente a um usuário. Os integrantes da organização podem atribuir uma revisão de pull request para qualquer pessoa ou equipe com acesso de leitura em um repositório. O revisor ou a equipe receberão uma notificação informando que você solicitou a revisão de uma pull request. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}Se você solicitar uma revisão de uma equipe e a atribuição de revisão de código estiver ativada, integrantes específicos serão solicitados e a equipe será removida como revisora. Para obter mais informações, consulte "[Gerenciando a responsabilidade pela revisão de código para sua equipe](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)."{% endif %} +Os proprietários e colaboradores podem atribuir uma revisão de pull request a qualquer pessoa que recebeu explicitamente [acesso de leitura](/articles/access-permissions-on-github) em um repositório pertencente a um usuário. Os integrantes da organização podem atribuir uma revisão de pull request para qualquer pessoa ou equipe com acesso de leitura em um repositório. O revisor ou a equipe receberão uma notificação informando que você solicitou a revisão de uma pull request. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 9" %}Se você solicitou uma revisão de uma equipe e a atribuição de código está habilitada serão solicitados integrantes específicos e a equipe será removida como revisora. Para obter mais informações, consulte "[Gerenciando a responsabilidade pela revisão de código para sua equipe](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)."{% endif %} {% note %} diff --git a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md index 8b609c33622a..1b9ed3f8d809 100644 --- a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md @@ -1,6 +1,6 @@ --- -title: Resolver um conflito de merge no GitHub -intro: Você pode resolver conflitos de merge simples que envolvem alterações concorrentes na linha usando o editor de conflitos. +title: Resolving a merge conflict on GitHub +intro: 'You can resolve simple merge conflicts that involve competing line changes on GitHub, using the conflict editor.' redirect_from: - /articles/resolving-a-merge-conflict-on-github versions: @@ -8,50 +8,56 @@ versions: enterprise-server: '*' --- -Você só pode resolver conflitos de merge no {% data variables.product.product_name %} causados por alterações concorrentes na linha, como quando as pessoas fazem alterações diferentes na mesma linha do mesmo arquivo em diferentes branches no seu repositório Git. Para todos os outros tipos de conflito de merge, você deve resolver o conflito localmente na linha de comando. Para obter mais informações, consulte "[Resolver um conflito de merge usando a linha de comando](/articles/resolving-a-merge-conflict-using-the-command-line/)". +You can only resolve merge conflicts on {% data variables.product.product_name %} that are caused by competing line changes, such as when people make different changes to the same line of the same file on different branches in your Git repository. For all other types of merge conflicts, you must resolve the conflict locally on the command line. For more information, see "[Resolving a merge conflict using the command line](/articles/resolving-a-merge-conflict-using-the-command-line/)." {% if currentVersion != "free-pro-team@latest" %} -Se um administrador do site desabilitar o editor de conflitos de merge para pull requests entre repositórios, você não poderá usar o editor de conflitos no {% data variables.product.product_name %} e deverá resolver os conflitos de merge na linha de comando. Por exemplo, se o editor de conflitos de merge estiver desabilitado, você não poderá usá-lo em uma pull request entre uma bifurcação e um repositório upstream. +If a site administrator disables the merge conflict editor for pull requests between repositories, you cannot use the conflict editor on {% data variables.product.product_name %} and must resolve merge conflicts on the command line. For example, if the merge conflict editor is disabled, you cannot use it on a pull request between a fork and upstream repository. {% endif %} {% warning %} {% if currentVersion ver_lt "enterprise-server@2.22" %} -**Aviso:** Ao resolver um conflito de merge em {% data variables.product.product_name %}, todo o [branch-base](/github/getting-started-with-github/github-glossary#base-branch) do seu pull request é mesclado no [cabeçalho do branch](/github/getting-started-with-github/github-glossary#head-branch), mesmo que o cabeçalho do branch seja o branch-padrão do seu repositório ou um branch protegido. Verifique se você deseja realmente fazer commit para esse branch. +**Warning:** When you resolve a merge conflict on {% data variables.product.product_name %}, the entire [base branch](/github/getting-started-with-github/github-glossary#base-branch) of your pull request is merged into the [head branch](/github/getting-started-with-github/github-glossary#head-branch), even if the head branch is the default branch of your repository or a protected branch. Make sure you really want to commit to this branch. {% else %} -**Aviso:** Quando você resolve um conflito de merge no {% data variables.product.product_name %}, todo o [branch base](/github/getting-started-with-github/github-glossary#base-branch) da sua pull request é mesclada ao [branch head](/github/getting-started-with-github/github-glossary#head-branch). Verifique se você deseja realmente fazer commit para esse branch. Se o branch do cabeçalho for o branch-padrão do seu repositório, você terá a opção de criar um novo branch para servir como o branch do cabeçalho para o seu pull request. Se o branch head estiver protegido, você não será capaz de mesclar sua resolução de conflitos nele, então você será solicitado a criar um novo branch head. Para obter mais informações, consulte "[Sobre branches protegidos](/github/administering-a-repository/about-protected-branches)". +**Warning:** When you resolve a merge conflict on {% data variables.product.product_name %}, the entire [base branch](/github/getting-started-with-github/github-glossary#base-branch) of your pull request is merged into the [head branch](/github/getting-started-with-github/github-glossary#head-branch). Make sure you really want to commit to this branch. If the head branch is the default branch of your repository, you'll be given the option of creating a new branch to serve as the head branch for your pull request. If the head branch is protected you won't be able to merge your conflict resolution into it, so you'll be prompted to create a new head branch. For more information, see "[About protected branches](/github/administering-a-repository/about-protected-branches)." {% endif %} {% endwarning %} {% data reusables.repositories.sidebar-pr %} -1. Na lista "Pull Requests", clique na pull request que tem um conflito de merge que você deseja resolver. -1. Próximo à parte inferior da pull request, clique em **Resolve conflicts** (Resolver conflitos). ![Botão de resolução de conflitos de merge](/assets/images/help/pull_requests/resolve-merge-conflicts-button.png) +1. In the "Pull Requests" list, click the pull request with a merge conflict that you'd like to resolve. +1. Near the bottom of your pull request, click **Resolve conflicts**. +![Resolve merge conflicts button](/assets/images/help/pull_requests/resolve-merge-conflicts-button.png) {% tip %} - **Dica:** se o botão **Resolve conflicts** (Resolver conflitos) estiver desativado, o conflito de merge da pull request é muito complexo para ser resolvido no {% data variables.product.product_name %}{% if currentVersion != "free-pro-team@latest" %} ou o administrador do site desabilitou o editor de conflitos para pull requests entre repositórios{% endif %}. Você deve resolver o conflito de merge usando um cliente Git alternativo, ou usando o Git na linha de comando. Para obter mais informações, consulte "[Resolver um conflito de merge usando a linha de comando](/articles/resolving-a-merge-conflict-using-the-command-line)". + **Tip:** If the **Resolve conflicts** button is deactivated, your pull request's merge conflict is too complex to resolve on {% data variables.product.product_name %}{% if currentVersion != "free-pro-team@latest" %} or the site administrator has disabled the conflict editor for pull requests between repositories{% endif %}. You must resolve the merge conflict using an alternative Git client, or by using Git on the command line. For more information see "[Resolving a merge conflict using the command line](/articles/resolving-a-merge-conflict-using-the-command-line)." {% endtip %} {% data reusables.pull_requests.decide-how-to-resolve-competing-line-change-merge-conflict %} - ![Exemplo de exibição de conflito de merge com marcadores de conflito](/assets/images/help/pull_requests/view-merge-conflict-with-markers.png) -1. Se houver mais de um conflito de merge no arquivo, role para baixo até o próximo conjunto de marcadores de conflito e repita as etapas quatro e cinco para resolver o conflito de merge. -1. Depois de resolver todos os conflitos do arquivo, clique em **Mark as resolved** (Marcar como resolvido). ![Clique no botão marcar como resolvido](/assets/images/help/pull_requests/mark-as-resolved-button.png) -1. Se você tiver mais de um arquivo com um conflito, selecione o próximo arquivo que deseja editar no lado esquerdo da página abaixo de "conflicting files" (arquivos conflitantes) e repita as etapas de quatro a sete até resolver todos os conflitos de merge da pull request. ![Selecione o próximo arquivo conflitante, se aplicável](/assets/images/help/pull_requests/resolve-merge-conflict-select-conflicting-file.png) -1. Depois de resolver todos os conflitos de merge, clique em **Commit merge** (Fazer commit do merge). Isso incorpora todo o branch base ao branch head. ![Resolve merge conflicts button](/assets/images/help/pull_requests/merge-conflict-commit-changes.png){% if currentVersion ver_lt "enterprise-server@2.22" %} -1. Se solicitado, revise o branch presente no commit. Se desejar fazer commit desse branch, clique em **I understand, update _BRANCH_** (Eu entendo, atualizar BRANCH). ![Janela de confirmação do conflito de merge](/assets/images/help/pull_requests/merge-conflict-confirmation.png){% else %} -1. Se solicitado, revise o branch presente no commit. - - Se o branch head for o branch padrão do repositório, você pode escolher atualizar este branch com as mudanças que você fez para resolver o conflito, ou criar um novo branch e usar isso como o branch head da pull request. ![Solicitar a revisão do branch que será atualizado](/assets/images/help/pull_requests/conflict-resolution-merge-dialog-box.png) - - Se você escolher criar um novo branch, digite um nome para o branch. - - Se o branch head de sua pull request estiver protegido, você deve criar um novo branch. Você não terá a opção de atualizar o branch protegido. - - Clique em **Criar branch e atualizar meu pull request** ou **Eu entendi, continuar atualizando _BRANCH_**. O texto do botão corresponde à ação que você está executando. + ![View merge conflict example with conflict markers](/assets/images/help/pull_requests/view-merge-conflict-with-markers.png) +1. If you have more than one merge conflict in your file, scroll down to the next set of conflict markers and repeat steps four and five to resolve your merge conflict. +1. Once you've resolved all the conflicts in the file, click **Mark as resolved**. + ![Click mark as resolved button](/assets/images/help/pull_requests/mark-as-resolved-button.png) +1. If you have more than one file with a conflict, select the next file you want to edit on the left side of the page under "conflicting files" and repeat steps four through seven until you've resolved all of your pull request's merge conflicts. + ![Select next conflicting file if applicable](/assets/images/help/pull_requests/resolve-merge-conflict-select-conflicting-file.png) +1. Once you've resolved all your merge conflicts, click **Commit merge**. This merges the entire base branch into your head branch. + ![Resolve merge conflicts button](/assets/images/help/pull_requests/merge-conflict-commit-changes.png){% if currentVersion ver_lt "enterprise-server@2.22" %} +1. If prompted, review the branch that you are committing to. If you want to commit to this branch, click **I understand, update _BRANCH_**. +![Merge conflict confirmation window](/assets/images/help/pull_requests/merge-conflict-confirmation.png){% else %} +1. If prompted, review the branch that you are committing to. + + If the head branch is the default branch of the repository, you can choose either to update this branch with the changes you made to resolve the conflict, or to create a new branch and use this as the head branch of the pull request. + ![Prompt to review the branch that will be updated](/assets/images/help/pull_requests/conflict-resolution-merge-dialog-box.png) + + If you choose to create a new branch, enter a name for the branch. + + If the head branch of your pull request is protected you must create a new branch. You won't get the option to update the protected branch. + + Click **Create branch and update my pull request** or **I understand, continue updating _BRANCH_**. The button text corresponds to the action you are performing. {% endif %} -1. Para fazer merge da pull request, clique em **Merge pull request** (Fazer merge da pull request). Para obter mais informações sobre outras opções de merge da pull request, consulte "[Fazer merge de uma pull request](/articles/merging-a-pull-request/)". +1. To merge your pull request, click **Merge pull request**. For more information about other pull request merge options, see "[Merging a pull request](/articles/merging-a-pull-request/)." -### Leia mais +### Further reading -- "[Sobre merges de pull request](/articles/about-pull-request-merges)" +- "[About pull request merges](/articles/about-pull-request-merges)" diff --git a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md index 3c7c9f4708c3..847451bb7273 100644 --- a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md @@ -10,7 +10,7 @@ versions: ### Sobre revisões de pull requests -Você pode revisar as alterações em um arquivo de pull request por vez. Ao revisar os arquivos em uma pull request, você pode deixar comentários individuais sobre alterações específicas.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} Quando terminar de revisar o arquivo, pode marcá-lo como visualizado. Isso aninha o arquivo e ajuda a identificar os arquivos que ainda precisam ser revisadas. Uma barra de progresso no header da pull request mostra o número de arquivos visualizados.{% endif %} Depois de revisar os arquivos desejados, você pode aprovar a pull request ou solicitar alterações adicionais enviando sua revisão com um comentário resumido. +Você pode revisar as alterações em um arquivo de pull request por vez. Ao revisar os arquivos em um pull request, você pode deixar comentários individuais em alterações específicas. Após terminar de revisar cada arquivo, você pode marcar o arquivo como visualizado. Isso aninha o arquivo e ajuda a identificar os arquivos que ainda precisam ser revisadas. Uma barra de progresso no cabeçalho do pull request mostra o número de arquivos que você visualizou. Depois de revisar todos os arquivos você desejar, você pode aprovar a solicitação de pull ou solicitar alterações adicionais enviando a sua revisão com um comentário resumido. {% data reusables.search.requested_reviews_search_tip %} @@ -28,14 +28,12 @@ Antes de enviar a revisão, os comentários em linha ficam com status _pendente_ ![Botão Cancel review (Cancelar revisão)](/assets/images/help/pull_requests/cancel-review-button.png) -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} ### Marcar um arquivo como visualizado Quando terminar de revisar um arquivo, você pode marcar o arquivo como visualizado, e o arquivo será aninhado. Se o arquivo for alterado após ser visualizado, será desmarcado como visualizado. {% data reusables.repositories.changed-files %} 2. À direta do cabeçalho do arquivo revisado, selecione **Viewed** (Visualizado). ![Caixa de seleção visualizado](/assets/images/help/pull_requests/viewed-checkbox.png) -{% endif %} ### Enviar a revisão diff --git a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/working-with-pre-receive-hooks.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/working-with-pre-receive-hooks.md index bfa79c204ab4..7bce5080750f 100644 --- a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/working-with-pre-receive-hooks.md +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/working-with-pre-receive-hooks.md @@ -1,6 +1,6 @@ --- title: Trabalhar com hooks pre-receive -intro: Os *hooks pre-receive* impõem regras para contribuições antes que o push dos commits possa ser feito em um repositório. +intro: 'Os *hooks pre-receive* impõem regras para contribuições antes que o push dos commits possa ser feito em um repositório.' redirect_from: - /articles/working-with-pre-receive-hooks versions: diff --git a/translations/pt-BR/content/github/committing-changes-to-your-project/changing-a-commit-message.md b/translations/pt-BR/content/github/committing-changes-to-your-project/changing-a-commit-message.md index b5ceaff2b0e7..ba8395fc1441 100644 --- a/translations/pt-BR/content/github/committing-changes-to-your-project/changing-a-commit-message.md +++ b/translations/pt-BR/content/github/committing-changes-to-your-project/changing-a-commit-message.md @@ -13,13 +13,9 @@ versions: Você pode alterar a mensagem do commit mais recente usando o comando `git commit --amend`. -{% warning %} - No Git, o texto da mensagem do commit faz parte do commit. Alterar a mensagem do commit mudará a ID do commit, isto é, a soma de verificação SHA1 que nomeia o commit. Efetivamente, você está criando um commit que substitui o antigo. -{% endwarning %} - -#### Não foi feito push online do commit +### Não foi feito push online do commit Se o commit existir em seu repositório local e não tiver sido publicado no {% data variables.product.product_location %}, você poderá corrigir a mensagem do commit com o comando `git commit --amend`. @@ -39,7 +35,7 @@ Você pode alterar o editor de texto padrão do Git mudando a configuração `co {% endtip %} -#### Corrigir mensagens do commit antigas ou em grandes quantidades +### Corrigir mensagens do commit antigas ou em grandes quantidades Se você já tiver feito push do commit no {% data variables.product.product_location %}, será necessário forçar o push de um commit com uma mensagem corrigida. @@ -49,7 +45,7 @@ O recomendável é evitar tanto quanto possível o push forçado, uma vez que is {% endwarning %} -**Corrigir a mensagem do commit com push mais recente** +**Alterar a mensagem do commit enviado mais recentemente** 1. Siga as [etapas acima](/articles/changing-a-commit-message#commit-has-not-been-pushed-online) para corrigir a mensagem do commit. 2. Use o comando `push --force` para forçar o push sobre o commit antigo. @@ -57,7 +53,7 @@ O recomendável é evitar tanto quanto possível o push forçado, uma vez que is $ git push --force example-branch ``` -**Corrigir mensagens do commit antigas ou em grandes quantidades** +**Alterar a mensagem das mensagens mais antigas ou múltiplas do commit** Se precisar corrigir a mensagem de vários commits ou de um commit antigo, você pode usar o rebase interativo e, em seguida, forçar o push para alterar o histórico do commit. @@ -93,7 +89,6 @@ Se precisar corrigir a mensagem de vários commits ou de um commit antigo, você # # Observe que commits vazios são comentados ``` - 3. Substitua `pick` por `reword` antes de cada mensagem do commit que deseja alterar. ```shell pick e499d89 Delete CNAME @@ -102,10 +97,10 @@ Se precisar corrigir a mensagem de vários commits ou de um commit antigo, você ``` 4. Salve e feche o arquivo da lista de commits. 5. Em cada arquivo de commit resultante, digite a nova mensagem do commit, salve o arquivo e feche-o. -6. Force o push dos commits corrigidos. - ```shell - $ git push --force - ``` +6. Quando estiver pronto para fazer push das suas alterações para o GitHub, use o comando push --force para fazer push forçado sobre o commit antigo. +```shell +$ git push --force example-branch +``` Para obter mais informações sobre rebase interativo, consulte a seção sobre o "[modo interativo](https://git-scm.com/docs/git-rebase#_interactive_mode)" no manual do Git. diff --git a/translations/pt-BR/content/github/committing-changes-to-your-project/commit-branch-and-tag-labels.md b/translations/pt-BR/content/github/committing-changes-to-your-project/commit-branch-and-tag-labels.md index f461677802e2..2b59faea298e 100644 --- a/translations/pt-BR/content/github/committing-changes-to-your-project/commit-branch-and-tag-labels.md +++ b/translations/pt-BR/content/github/committing-changes-to-your-project/commit-branch-and-tag-labels.md @@ -14,7 +14,7 @@ Se seu commit não estiver no branch padrão, um indicador mostrará os branches Assim que o commit estiver no branch padrão, todas as tags que contêm o commit serão mostradas e o branch padrão será o único branch listado. -![Commit-master-label](/assets/images/help/commits/Commit-master-label.png) +![Commit-main-label](/assets/images/help/commits/Commit-master-label.png) ### Leia mais diff --git a/translations/pt-BR/content/github/committing-changes-to-your-project/commit-exists-on-github-but-not-in-my-local-clone.md b/translations/pt-BR/content/github/committing-changes-to-your-project/commit-exists-on-github-but-not-in-my-local-clone.md index 44adfb47337a..3421f2f094b9 100644 --- a/translations/pt-BR/content/github/committing-changes-to-your-project/commit-exists-on-github-but-not-in-my-local-clone.md +++ b/translations/pt-BR/content/github/committing-changes-to-your-project/commit-exists-on-github-but-not-in-my-local-clone.md @@ -1,5 +1,5 @@ --- -title: 'O commit aparece no GitHub, mas não no meu clone local' +title: O commit aparece no GitHub, mas não no meu clone local intro: 'Às vezes, um commit poderá ser visto no {% data variables.product.product_name %}, mas não existirá no clone local do repositório.' redirect_from: - /articles/commit-exists-on-github-but-not-in-my-local-clone diff --git a/translations/pt-BR/content/github/committing-changes-to-your-project/comparing-commits.md b/translations/pt-BR/content/github/committing-changes-to-your-project/comparing-commits.md index 9e287d22ad3b..fe9b9ada7b99 100644 --- a/translations/pt-BR/content/github/committing-changes-to-your-project/comparing-commits.md +++ b/translations/pt-BR/content/github/committing-changes-to-your-project/comparing-commits.md @@ -26,9 +26,9 @@ Veja a seguir um exemplo de uma [comparação entre dois branches](https://githu ### Comparar tags -A comparação de tags de versão irá mostrar alterações no seu repositório desde a última versão. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} Para obter mais informações, consulte "[Comparar versões](/github/administering-a-repository/comparing-releases)."{% endif %} +A comparação de tags de versão irá mostrar alterações no seu repositório desde a última versão. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} Para obter mais informações, consulte "[Comparar versões](/github/administering-a-repository/comparing-releases)".{% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}Para comparar tags, você pode selecionar um nome de tag no menu suspenso `compare` na parte superior da página.{% else %} Em vez de digitar um nome do branch, digite o nome da sua tag no menu suspenso `compare`.{% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 0" %}Para comparar tags, você pode selecionar o nome de uma tag no menu suspenso `comparar` na parte superior da página.{% else %} Em vez de digitar o nome de um branch, digite o nome da sua tag no menu suspenso `comparar`.{% endif %} Veja a seguir o exemplo de uma [comparação entre duas tags](https://github.com/octocat/linguist/compare/v2.2.0...octocat:v2.3.3). @@ -46,7 +46,7 @@ Para saber mais sobre outras opções de comparação, consulte "[Comparações Você pode comparar seu repositório base e qualquer repositório bifurcado. Essa é a exibição que é apresentada quando um usuário executa uma pull request em um projeto. -Para comparar branches em repositórios diferentes, anteceda os nomes do branch com nomes de usuários. Por exemplo, especificando `octocat:master` para `base` e `octo-org:master` para `compare`, você pode comparar o branch `master` dos repositórios respectivamente possuídos por `octocat` e `octo-org`. +Para comparar branches em repositórios diferentes, anteceda os nomes do branch com nomes de usuários. Por exemplo, ao especificar o `octocat:main` para `base` e `octo-org:main` para `compare`você pode comparar o branch `principal` dos repositórios respectivamente que pertencem a `octocat` e `octo-org`. Veja a seguir o exemplo de uma [comparação entre dois repositórios](https://github.com/octocat/linguist/compare/master...octo-org:master). diff --git a/translations/pt-BR/content/github/committing-changes-to-your-project/creating-a-commit-with-multiple-authors.md b/translations/pt-BR/content/github/committing-changes-to-your-project/creating-a-commit-with-multiple-authors.md index 092ede059d03..079e81663f51 100644 --- a/translations/pt-BR/content/github/committing-changes-to-your-project/creating-a-commit-with-multiple-authors.md +++ b/translations/pt-BR/content/github/committing-changes-to-your-project/creating-a-commit-with-multiple-authors.md @@ -1,8 +1,6 @@ --- -title: Criar um commit com vários autores -intro: |- - Você pode atribuir um commit a mais de um autor adicionando um ou mais trailers "Co-authored-by" à mensagem do commit. Os commits coautorados podem ser vistos no {% data variables.product.product_name %}{% if currentVersion != "free-pro-team@latest" %} e podem ser incluídos no gráfico de contribuições de perfil e nas estatísticas - do repositório{% endif %}. +title: Creating a commit with multiple authors +intro: 'You can attribute a commit to more than one author by adding one or more `Co-authored-by` trailers to the commit''s message. Co-authored commits are visible on {% data variables.product.product_name %}{% if currentVersion != "free-pro-team@latest" %} and can be included in the profile contributions graph and the repository''s statistics{% endif %}.' redirect_from: - /articles/creating-a-commit-with-multiple-authors versions: @@ -10,41 +8,41 @@ versions: enterprise-server: '*' --- -### Informações obrigatórias do coautor +### Required co-author information -Para poder adicionar um coautor a um commit, você deve saber o e-mail adequado a ser usado para cada coautor. Para que o commit do coautor conte como uma contribuição, você deve usar o e-mail associado à conta do {% data variables.product.product_name %} dele. +Before you can add a co-author to a commit, you must know the appropriate email to use for each co-author. For the co-author's commit to count as a contribution, you must use the email associated with their {% data variables.product.product_name %} account. {% if currentVersion == "free-pro-team@latest" %} -Se uma pessoa optar por manter o respectivo endereço de e-mail privado, você deverá usar o e-mail `no-reply` dela fornecido pelo {% data variables.product.product_name %} para proteger a privacidade. Caso contrário, o e-mail do coautor estará disponível para o público na mensagem do commit. Se desejar manter seu e-mail privado, você poderá usar um e-mail `no-reply` fornecido pelo {% data variables.product.product_name %} para operações de Git e pedir que outros coautores listem seu e-mail `no-reply` nos trailers de commit. +If a person chooses to keep their email address private, you should use their {% data variables.product.product_name %}-provided `no-reply` email to protect their privacy. Otherwise, the co-author's email will be available to the public in the commit message. If you want to keep your email private, you can choose to use a {% data variables.product.product_name %}-provided `no-reply` email for Git operations and ask other co-authors to list your `no-reply` email in commit trailers. -Para obter mais informações, consulte "[Setting your commit email address](/articles/setting-your-commit-email-address)." +For more information, see "[Setting your commit email address](/articles/setting-your-commit-email-address)." {% tip %} - **Dica:** você pode ajudar um coautor a encontrar o endereço de e-mail de preferência dele compartilhando essas informações: - - Para encontrar o e-mail `no-reply` fornecido pelo {% data variables.product.product_name %}, navegue até a página de configurações do e-mail em "Keep my email address private" (Manter meu endereço de e-mail privado). - - Para encontrar o e-mail usado para configurar o Git no seu computador, execute `git config user.email` na linha de comando. + **Tip:** You can help a co-author find their preferred email address by sharing this information: + - To find your {% data variables.product.product_name %}-provided `no-reply` email, navigate to your email settings page under "Keep my email address private." + - To find the email you used to configure Git on your computer, run `git config user.email` on the command line. {% endtip %} {% endif %} -### Criar commits coautorados usando o {% data variables.product.prodname_desktop %} +### Creating co-authored commits using {% data variables.product.prodname_desktop %} -Você pode usar o {% data variables.product.prodname_desktop %} para criar um commit com um coautor. Para obter mais informações, consulte "[Escrever uma mensagem do commit e fazer push das alterações](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project#3-write-a-commit-message-and-push-your-changes)" e [{% data variables.product.prodname_desktop %}](https://desktop.github.com). +You can use {% data variables.product.prodname_desktop %} to create a commit with a co-author. For more information, see "[Write a commit message and push your changes](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project#3-write-a-commit-message-and-push-your-changes)" and [{% data variables.product.prodname_desktop %}](https://desktop.github.com). -![Adicionar um coautor à mensagem do commit](/assets/images/help/desktop/co-authors-demo-hq.gif) +![Add a co-author to the commit message](/assets/images/help/desktop/co-authors-demo-hq.gif) -### Criar commits coautorados na linha de comando +### Creating co-authored commits on the command line {% data reusables.pull_requests.collect-co-author-commit-git-config-info %} {% data reusables.pull_requests.commit-message-with-trailer-beginning %} -3. Na próxima linha da mensagem do commit, digite `Co-authored-by: name ` com informações específicas para cada coautor. Depois das informações do coautor, adicione aspas de fechamento. +3. On the next line of the commit message, type `Co-authored-by: name ` with specific information for each co-author. After the co-author information, add a closing quotation mark. - Se estiver adicionando vários coautores, dê a cada um a própria linha e o trailer de commit `Co-authored-by:`. + If you're adding multiple co-authors, give each co-author their own line and `Co-authored-by:` commit trailer. ```shell $ git commit -m "Refactor usability tests. > @@ -53,26 +51,27 @@ Você pode usar o {% data variables.product.prodname_desktop %} para criar um co Co-authored-by: another-name <another-name@example.com>" ``` -O novo commit e a mensagem aparecerão no {% data variables.product.product_location %} na próxima vez que você fizer push. Para obter mais informações, consulte "[Fazer push das alterações em um repositório remoto](/articles/pushing-commits-to-a-remote-repository/)". +The new commit and message will appear on {% data variables.product.product_location %} the next time you push. For more information, see "[Pushing changes to a remote repository](/articles/pushing-commits-to-a-remote-repository/)." -### Criar commits coautorados no {% data variables.product.product_name %} +### Creating co-authored commits on {% data variables.product.product_name %} -Depois que fizer alterações em um arquivo usando o editor web no {% data variables.product.product_name %}, você poderá criar um commit coautorado adicionando um trailer `Co-authored-by:` à mensagem do commit. +After you've made changes in a file using the web editor on {% data variables.product.product_name %}, you can create a co-authored commit by adding a `Co-authored-by:` trailer to the commit's message. {% data reusables.pull_requests.collect-co-author-commit-git-config-info %} -2. Depois de fazer as alterações juntos, na parte inferior da página, digite uma mensagem de commit curta e significativa que descreve as alterações feitas. ![Mensagem do commit para sua alteração](/assets/images/help/repository/write-commit-message-quick-pull.png) -3. Na caixa de texto abaixo da mensagem do commit, adicione `Co-authored-by: name ` com informações específicas para cada coautor. Se estiver adicionando vários coautores, dê a cada um a própria linha e o trailer de commit `Co-authored-by:`. +2. After making your changes together, at the bottom of the page, type a short, meaningful commit message that describes the changes you made. + ![Commit message for your change](/assets/images/help/repository/write-commit-message-quick-pull.png) +3. In the text box below your commit message, add `Co-authored-by: name ` with specific information for each co-author. If you're adding multiple co-authors, give each co-author their own line and `Co-authored-by:` commit trailer. - ![Exemplo de trailer de coautor da mensagem do commit na segunda caixa de texto da mensagem do commit](/assets/images/help/repository/write-commit-message-co-author-trailer.png) -4. Clique em **Commit changes** (Fazer commit de alterações) ou **Propose changes** (Propor alterações). + ![Commit message co-author trailer example in second commit message text box](/assets/images/help/repository/write-commit-message-co-author-trailer.png) +4. Click **Commit changes** or **Propose changes**. -O novo commit e a mensagem aparecerão no {% data variables.product.product_location %}. +The new commit and message will appear on {% data variables.product.product_location %}. -### Leia mais +### Further reading {% if currentVersion != "free-pro-team@latest" %} -- "[Exibir contribuições no perfil](/articles/viewing-contributions-on-your-profile)" -- "[Por que minhas contribuições não aparecem no meu perfil?](/articles/why-are-my-contributions-not-showing-up-on-my-profile)"{% endif %} -- "[Exibir um resumo da atividade do repositório](/articles/viewing-a-summary-of-repository-activity)" -- "[Exibir contribuidores de um projeto](/articles/viewing-a-projects-contributors)" -- "[Alterar uma mensagem do commit](/articles/changing-a-commit-message)" -- "[Fazer commit e revisar alterações no seu projeto](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project#3-write-a-commit-message-and-push-your-changes)" na documentação do {% data variables.product.prodname_desktop %} +- "[Viewing contributions on your profile](/articles/viewing-contributions-on-your-profile)" +- "[Why are my contributions not showing up on my profile?](/articles/why-are-my-contributions-not-showing-up-on-my-profile)"{% endif %} +- "[Viewing a summary of repository activity](/articles/viewing-a-summary-of-repository-activity)" +- "[Viewing a project's contributors](/articles/viewing-a-projects-contributors)" +- "[Changing a commit message](/articles/changing-a-commit-message)" +- "[Committing and reviewing changes to your project](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project#3-write-a-commit-message-and-push-your-changes)" in the {% data variables.product.prodname_desktop %} documentation diff --git a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/about-archiving-repositories.md b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/about-archiving-repositories.md index 7ce54fe16715..826ce3095fb2 100644 --- a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/about-archiving-repositories.md +++ b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/about-archiving-repositories.md @@ -20,7 +20,7 @@ versions: Depois que um repositório é arquivado, não é possível adicionar nem remover colaboradores ou equipes. Os contribuidores com acesso ao repositório podem apenas bifurcar ou marcar com estrela seu projeto. -Quando um repositório é arquivado, seus problemas, pull requests, código, etiquetas, marcos, projetos, wiki, versões, commits, tags, branches, reações e comentários se tornam somente leitura. Para fazer alterações em um repositório arquivado, você deve desarquivar o repositório primeiro. +Quando um repositório é arquivado, seus problemas, pull requests, código, etiquetas, marcos, projetos, wiki, versões, commits, tags, branches, reações, alertas de varredura de código e comentários tornam-se somente leitura. Para fazer alterações em um repositório arquivado, você deve desarquivar o repositório primeiro. É possível pesquisar repositórios arquivados. Para obter mais informações, consulte "[Pesquisar repositórios](/articles/searching-for-repositories/#search-based-on-whether-a-repository-is-archived)". Para obter mais informações, consulte "[Pesquisa de repositórios](/articles/searching-for-repositories/#search-based-on-whether-a-repository-is-archived)". Para obter mais informações, consulte "[Pesquisa de problemas e pull requests](/articles/searching-issues-and-pull-requests/#search-based-on-whether-a-repository-is-archived)". diff --git a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md index d3a34e4e9670..5eeaf622e2ae 100644 --- a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md +++ b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md @@ -20,7 +20,7 @@ Solicita-se automaticamente que os proprietários do código revisem quando algu Quando alguém com permissões de administrador ou proprietário tiver habilitado revisões obrigatórias, se desejar, ele também poderá exigir aprovação de um proprietário do código para que o autor possa fazer merge de uma pull request no repositório. Para obter mais informações, consulte "[Habilitar revisões obrigatórias para pull requests](/github/administering-a-repository/enabling-required-reviews-for-pull-requests)". -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}Se uma equipe tiver habilitado as tarefas de revisão de código, as aprovações individuais não satisfarão o requisito para a aprovação do proprietário do código em um branch protegido. Para obter mais informações, consulte "[Gerenciando a responsabilidade pela revisão de código para sua equipe](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)."{% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 9" %}Se uma equipe habilitou as atribuições de revisão de código, as aprovações individuais não irão satisfazer o requisito para a aprovação do proprietário do código em um branch protegido. Para obter mais informações, consulte "[Gerenciando a responsabilidade pela revisão de código para sua equipe](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)."{% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} Se um arquivo tiver um proprietário do código, você poderá ver quem é o proprietário do código antes de abrir um pull request. No repositório, é possível pesquisar o arquivo e passar o mouse sobre @@ -78,8 +78,9 @@ docs/* docs@example.com # em qualquer lugar do seu repositório. apps/ @octocat -# Neste exemplo, @doctocat tem qualquer arquivo no diretório -# `/docs` na raiz do seu repositório. +# In this example, @doctocat owns any file in the `/docs` +# directory in the root of your repository and any of its +# subdirectories. /docs/ @doctocat ``` diff --git a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/about-readmes.md b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/about-readmes.md index bbdf9165b379..3a9fd65bc680 100644 --- a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/about-readmes.md +++ b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/about-readmes.md @@ -10,7 +10,7 @@ versions: enterprise-server: '*' --- -Um arquivo README, com {% if currentVersion == "free-pro-team@latest" %}uma [licença de repositório](/articles/licensing-a-repository), [diretrizes de contribuição](/articles/setting-guidelines-for-repository-contributors) e um [código de conduta](/articles/adding-a-code-of-conduct-to-your-project){% else %}uma [licença de repositório](/articles/licensing-a-repository) e [diretrizes de contribuição](/articles/setting-guidelines-for-repository-contributors){% endif %}, ajuda você a comunicar expectativas e a gerenciar contribuições para seu projeto. +Um arquivo LEIAME, junto com {% if currentVersion == "free-pro-team@latest" %}a [licença de repositório](/articles/licensing-a-repository), [diretrizes de contribuição](/articles/setting-guidelines-for-repository-contributors) e um [código de conduta](/articles/adding-a-code-of-conduct-to-your-project){% else %}uma [licença de repositório](/articles/licensing-a-repository) e diretrizes de contribuição [](/articles/setting-guidelines-for-repository-contributors){% endif %} ajudam você a comunicar as expectativas e gerenciar contribuições para o seu projeto. Um LEIAME, muitas vezes, é o primeiro item que um visitante verá ao visitar seu repositório. Os arquivos LEIAME geralmente incluem informações sobre: - O que o projeto faz diff --git a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/about-repositories.md b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/about-repositories.md index 8810faa43ffc..8f34ead56d40 100644 --- a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/about-repositories.md +++ b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/about-repositories.md @@ -15,7 +15,8 @@ Você pode possuir repositórios individualmente ou compartilhar a propriedade d Para repositórios possuídos pelo usuário, você pode fornecer a outras pessoas acesso de colaborador para que elas possam colaborar no seu projeto. Se um repositório pertencer a uma organização, você poderá fornecer aos integrantes da organização permissões de acesso para colaboração no seu repositório. Para obter mais informações, consulte "[Níveis de permissão para uma repositório de conta de usuário](/articles/permission-levels-for-a-user-account-repository/)" e "[Níveis de permissão de repositório para uma organização](/articles/repository-permission-levels-for-an-organization/)". {% if currentVersion == "free-pro-team@latest" %} -Com o {% data variables.product.prodname_free_team %} em contas de usuário e organizações, você pode trabalhar com colaboradores ilimitados em repositórios públicos ilimitados, com um conjunto completo de recursos, ou em repositórios privados ilimitados com um conjunto de recursos limitados. Para obter ferramentas avançadas para repositórios privados, você pode fazer o upgrade para {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %} ou {% data variables.product.prodname_ghe_cloud %}. {% data reusables.gated-features.more-info %} +Com +{% data variables.product.prodname_free_team %} para contas de usuário e organizações, você pode trabalhar com colaboradores ilimitados em repositórios públicos ilimitados com um conjunto completo de recursos, ou repositórios privados ilimitados com uma funcionalidade limitada. Para obter ferramentas avançadas para repositórios privados, você pode fazer o upgrade para {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %} ou {% data variables.product.prodname_ghe_cloud %}. {% data reusables.gated-features.more-info %} {% else %} Cada pessoa e organização podem ter repositórios ilimitados e convidar um número ilimitado de colaboradores para todos os repositórios. {% endif %} diff --git a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md index c1e506a4e1ed..8d39dc768868 100644 --- a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md +++ b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md @@ -13,7 +13,8 @@ versions: enterprise-server: '*' --- -O {% data variables.product.product_name %} usa a [biblioteca Linguist](https://github.com/github/linguist) de código aberto para determinar as linguagens de arquivo para destaque da sintaxe e estatísticas de repositório. As estatísticas da linguagem serão atualizadas após você fazer push de alterações no seu branch-padrão. +{% data variables.product.product_name %} usa [Biblioteca Linguist](https://github.com/github/linguist) a de código aberto para +determinar as linguagens de arquivo para destacar a sintaxe e estatísticas do repositório. As estatísticas da linguagem serão atualizadas após você fazer push de alterações no seu branch-padrão. Alguns arquivos são difíceis de identificar e, às vezes, os projetos contêm mais arquivos de fornecedor e biblioteca do que código primário. Se estiver recebendo resultados incorretos, consulte o [guia de solução de problemas](https://github.com/github/linguist#troubleshooting) do Linguist para obter ajuda. diff --git a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/about-repository-visibility.md b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/about-repository-visibility.md index 2b5aa41d636e..d8c3f2ea37c5 100644 --- a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/about-repository-visibility.md +++ b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/about-repository-visibility.md @@ -1,36 +1,35 @@ --- -title: Sobre a visibilidade do repositório -intro: 'É possível restringir quem tem acesso a um repositório, escolhendo a visibilidade de um repositório: {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} público, interno ou privado{% else %} público ou privado{% endif %}.' +title: About repository visibility +intro: 'You can restrict who has access to a repository by choosing a repository''s visibility: {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}public, internal, or private{% else %} public or private{% endif %}.' versions: free-pro-team: '*' enterprise-server: '*' --- -### Sobre a visibilidade do repositório +### About repository visibility -Ao criar um repositório, você pode optar por tornar o repositório público ou privado. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}Se você estiver criando o repositório em uma organização{% if currentVersion == "free-pro-team@latest" %} que é propriedade de uma conta corporativa{% endif %}, você também poderá optar por tornar o repositório interno.{% endif %} +When you create a repository, you can choose to make the repository public or private. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}If you're creating the repository in an organization{% if currentVersion == "free-pro-team@latest" %} that is owned by an enterprise account{% endif %}, you can also choose to make the repository internal.{% endif %} -{% if currentVersion != "free-pro-team@latest" %}Se {% data variables.product.product_location_enterprise %} não estiver em modo privado ou atrás de um firewall, os repositórios p{% else %}P{% endif %}úblicos poderão ser acessados por qualquer pessoa na internet.{% if currentVersion != "free-pro-team@latest" %} Caso contrário, todos os repositórios públicos estarão disponíveis para todos que usarem o {% data variables.product.product_location_enterprise %}, incluindo os colaboradores externos.{% endif %} Os repositórios privados só poderão ser acessados por você ou por pessoas pessoas com as quais você compartilha explicitamente o acesso, e,para repositórios de organização, [alguns integrantes da organização](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization). {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}Os rpositórios internos podem ser acessados pelos {% if currentVersion == "free-pro-team@latest" %}integrantes da sua conta corporativa{% else %}e pelos integrantes de qualquer organização na sua instância{% endif %}. Para obter mais informações, consulte "[Sobre repositórios internos](#about-internal-repositories)."{% endif %} +{% if currentVersion != "free-pro-team@latest" %}If {% data variables.product.product_location_enterprise %} is not in private mode or behind a firewall, p{% else %}P{% endif %}ublic repositories are accessible to everyone on the internet.{% if currentVersion != "free-pro-team@latest" %} Otherwise, public repositories are available to everyone using {% data variables.product.product_location_enterprise %}, including outside collaborators.{% endif %} Private repositories are only accessible to you, people you explicitly share access with, and, for organization repositories, [certain organization members](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization). {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}Internal repositories are accessible to {% if currentVersion == "free-pro-team@latest" %}members of your enterprise account{% else %}members of any organization on your instance{% endif %}. For more information, see "[About internal repositories](#about-internal-repositories)."{% endif %} -Os proprietários da organização sempre têm acesso a todos os repositórios criados em uma organização. Para obter mais informações, consulte "[Níveis de permissão de repositório para uma organização](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization)". +Organization owners always have access to every repository created in an organization. For more information, see "[Repository permission levels for an organization](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization)." -As pessoas com permissões de administrador para um repositório podem alterar a visibilidade de um repositório existente. Para obter mais informações, consulte "[Configurar visibilidade do repositório](/github/administering-a-repository/setting-repository-visibility)". +People with admin permissions for a repository can change an existing repository's visibility. For more information, see "[Setting repository visibility](/github/administering-a-repository/setting-repository-visibility)." {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -### Sobre repositórios internos +### About internal repositories {% note %} -**Observação:** {% data reusables.gated-features.internal-repos %} +**Note:** {% data reusables.gated-features.internal-repos %} {% endnote %} -{% data reusables.repositories.about-internal-repos %} Para obter mais informações sobre o innersource, consulte a documentação técnica do {% data variables.product.prodname_dotcom %}"[Uma introdução ao innersource](https://resources.github.com/whitepapers/introduction-to-innersource/)". +{% data reusables.repositories.about-internal-repos %} For more information on innersource, see {% data variables.product.prodname_dotcom %}'s whitepaper "[An introduction to innersource](https://resources.github.com/whitepapers/introduction-to-innersource/)." -Todos os {% if currentVersion == "free-pro-team@latest" %}integrantes da empresa{% else %}integrantes da organização{% endif %} têm permissões de leitura no repositório interno, mas repositórios internos não são visíveis para pessoas {% if currentVersion == "free-pro-team@latest" %}de fora da conta corporativa{% else %}que não são membros de uma organização{% endif %}, incluindo colaboradores externos nos repositórios da organização. Para mais informações consulte {% if currentVersion == "free-pro-team@latest" %}"[Funções para uma conta corporativa](/articles/roles-for-an-enterprise-account#enterprise-members)" e {% endif %}"[Níveis de permissão do repositório para uma organização](/articles/repository-permission-levels-for-an-organization)". +All {% if currentVersion == "free-pro-team@latest" %}enterprise members{% else %}organization members{% endif %} have read permissions to the internal repository, but internal repositories are not visible to people {% if currentVersion == "free-pro-team@latest" %}outside of the enterprise account{% else %}who are not members of an organization{% endif %}, including outside collaborators on organization repositories. For more information, see {% if currentVersion == "free-pro-team@latest" %}"[Roles for an enterprise account](/articles/roles-for-an-enterprise-account#enterprise-members)" and {% endif %}"[Repository permission levels for an organization](/articles/repository-permission-levels-for-an-organization)." {% data reusables.repositories.internal-repo-default %} -Se um usuário for removido de -{% if currentVersion == "free-pro-team@latest" %}uma conta corporativa{% else %}todas as organizações na instância{% endif %} das bifurcações dos usuários de repositórios internos serão removidas automaticamente. +If a user is removed from {% if currentVersion == "free-pro-team@latest" %}an enterprise account{% else %}all organizations on the instance{% endif %}, that user's forks of internal repositories are removed automatically. {% endif %} diff --git a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md index d5b2186b49f8..5364873fbeb0 100644 --- a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md +++ b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md @@ -1,42 +1,41 @@ --- -title: Fazer backup de um repositório -intro: 'Você pode usar o{% if currentVersion != "free-pro-team@latest" %} Git e{% endif %} a API {% if currentVersion == "free-pro-team@latest" %}ou uma ferramenta de terceiros {% endif %}para fazer backup do seu repositório.' +title: Backing up a repository +intro: 'You can use{% if currentVersion != "free-pro-team@latest" %} Git and{% endif %} the API {% if currentVersion == "free-pro-team@latest" %}or a third-party tool {% endif %}to back up your repository.' redirect_from: - - Backing up a repository + - /articles/backing-up-a-repository versions: free-pro-team: '*' enterprise-server: '*' --- - {% if currentVersion == "free-pro-team@latest" %} -Para baixar um arquivo do seu repositório, você pode usar a API para usuário ou migrações da organização. Para obter mais informações, consulte "[Migrações](/v3/migrations/)". +To download an archive of your repository, you can use the API for user or organization migrations. For more information, see "[Migrations](/v3/migrations/)." {% else %} -Você pode baixar e fazer backup dos repositórios manualmente: +You can download and back up your repositories manually: -- Para baixar os dados Git de um repositório no computador local, é preciso clonar o repositório. Para obter mais informações, consulte "[Clonar um repositório](/articles/cloning-a-repository)". -- Também é possível baixar o wiki do repositório. Para obter mais informações, consulte "[Adicionar ou editar páginas wiki](/articles/adding-or-editing-wiki-pages)". +- To download a repository's Git data to your local machine, you'll need to clone the repository. For more information, see "[Cloning a repository](/articles/cloning-a-repository)." +- You can also download your repository's wiki. For more information, see "[Adding or editing wiki pages](/articles/adding-or-editing-wiki-pages)." -Quando você clona um repositório ou wiki, somente os dados Git, como arquivos e histórico de commits do projeto, são baixados. Você pode usar nossa API para exportar outros elementos do seu repositório do {% data variables.product.product_name %} para o computador local: +When you clone a repository or wiki, only Git data, such as project files and commit history, is downloaded. You can use our API to export other elements of your {% data variables.product.product_name %} repository to your local machine: -- [Problemas](/v3/issues/#list-issues-for-a-repository) +- [Issues](/v3/issues/#list-issues-for-a-repository) - [Pull requests](/v3/pulls/#list-pull-requests) -- [Bifurcações](/v3/repos/forks/#list-forks) -- [Comentários](/v3/issues/comments/#list-comments-in-a-repository) -- [Marcos](/v3/issues/milestones/#list-milestones-for-a-repository) -- [Etiquetas](/v3/issues/labels/#list-all-labels-for-this-repository) -- [Inspetores](/v3/activity/watching/#list-watchers) -- [observador](/v3/activity/starring/#list-stargazers) -- [Projetos](/v3/projects/#list-repository-projects) +- [Forks](/rest/reference/repos#list-forks) +- [Comments](/rest/reference/issues#list-issue-comments-for-a-repository) +- [Milestones](/rest/reference/issues#list-milestones) +- [Labels](/rest/reference/issues#list-labels-for-a-repository) +- [Watchers](/rest/reference/activity#list-watchers) +- [Stargazers](/rest/reference/activity#list-stargazers) +- [Projects](/v3/projects/#list-repository-projects) {% endif %} -Assim que tiver {% if currentVersion != "free-pro-team@latest" %}uma versão local de todo o conteúdo do qual deseja fazer backup, você poderá criar um arquivo zip e {% else %}baixado seu arquivo, você poderá{% endif %}copiá-lo em um disco rígido externo e/ou fazer upload dele em um serviço de backup baseado na nuvem, como o [Google Drive](https://www.google.com/drive/) ou [Dropbox](https://www.dropbox.com/). +Once you have {% if currentVersion != "free-pro-team@latest" %}a local version of all the content you want to back up, you can create a zip archive and {% else %}downloaded your archive, you can {% endif %}copy it to an external hard drive and/or upload it to a cloud-based backup service such as [Google Drive](https://www.google.com/drive/) or [Dropbox](https://www.dropbox.com/). {% if currentVersion == "free-pro-team@latest" %} -### Ferramentas de backup de terceiros +### Third-party backup tools -Existem várias ferramentas de autoatendimento que automatizam backups de repositórios. Ao contrário de projetos arquivados, que arquivam _todos_ os repositórios públicos em {% data variables.product.product_name %} que não tenham optado por não participar e tornam os dados acessíveis para todos, as ferramentas de backup irão fazer o download dos dados de repositórios _específicos_ e organizá-los em um novo branch ou diretório. Para obter mais informações sobre projetos de arquivamento, consulte "[Sobre arquivamento de conteúdo e dados no {% data variables.product.prodname_dotcom %}](/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github#about-the-github-archive-program)". +A number of self-service tools exist that automate backups of repositories. Unlike archival projects, which archive _all_ public repositories on {% data variables.product.product_name %} that have not opted out and make the data accessible to anyone, backup tools will download data from _specific_ repositories and organize it within a new branch or directory. For more information about archival projects, see "[About archiving content and data on {% data variables.product.prodname_dotcom %}](/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github#about-the-github-archive-program)." -Você pode fazer backup de todos os dados Git de um repositório (como arquivos e histórico de commits do projeto), bem como de dados do {% data variables.product.product_name %} (como problemas e pull requests), com o [BackHub](https://github.com/marketplace/backhub), que cria backups recorrentes diariamente dos seus repositórios com instantâneos de até 30 dias atrás. O BackHub está disponível no {% data variables.product.prodname_marketplace %}. +You can back up all of a repository's Git data (such as project files and commit history), as well as much data from {% data variables.product.product_name %} (such as issues and pull requests), with [BackHub](https://github.com/marketplace/backhub), which creates daily recurring backups of your repositories with snapshots up to 30 days back in time. BackHub is available in {% data variables.product.prodname_marketplace %}. {% endif %} diff --git a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md index 2c3468d48744..060c3c1cb560 100644 --- a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md +++ b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md @@ -46,7 +46,7 @@ Para obter mais informações, consulte "[Clonar um repositório do {% data vari Um repositório vazio não contém arquivos. Muitas vezes, isso é feito se você não inicializar o repositório com um LEIAME ao criá-lo. {% data reusables.repositories.navigate-to-repo %} -2. Para clonar seu repositório usando a linha de comando usando HTTPS, em "Configuração rápida", clique no {% octicon "clippy" aria-label="The clipboard icon" %}. Para clonar o repositório usando uma chave SSH{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, incluindo um certificado emitido pela autoridade de certificado SSH da sua organização{% endif %} clique em **SSH** e, em seguida, clique em {% octicon "clippy" aria-label="The clipboard icon" %}. ![Botão da URL para clonar o repositório vazio](/assets/images/help/repository/empty-https-url-clone-button.png) +2. Para clonar seu repositório usando a linha de comando usando HTTPS, em "Configuração rápida", clique no {% octicon "clippy" aria-label="The clipboard icon" %}. Para clonar o repositório usando uma chave SSH, incluindo um certificado emitido pela autoridade de certificação SSH da sua organização, clique em **SSH** e, em seguida, clique em {% octicon "clippy" aria-label="The clipboard icon" %}. ![Botão da URL para clonar o repositório vazio](/assets/images/help/repository/empty-https-url-clone-button.png) Como alternativa, para clonar seu repositório para área de trabalho, clique em {% octicon "desktop-download" aria-label="The desktop download button" %} **Configurar na área de trabalho** e seguir as instruções para concluir o clone. ![Botão da área de trabalho para clonar o repositório vazio](/assets/images/help/repository/empty-desktop-clone-button.png) @@ -55,7 +55,6 @@ Um repositório vazio não contém arquivos. Muitas vezes, isso é feito se voc {% data reusables.command_line.git-clone-url %} {% data reusables.command_line.local-clone-created %} - ### Solucionar problemas de erros de clonagem Ao clonar um repositório, é possível que você encontre alguns erros. @@ -66,7 +65,6 @@ Se você não conseguir clonar um repositório, verifique se: - Você tem permissão para acessar o repositório que você deseja clonar. Para obter mais informações, consulte "[Erro: Repositório não encontrado](/github/creating-cloning-and-archiving-repositories/error-repository-not-found)". - O branch-padrão que você deseja clonar ainda existe. Para obter mais informações, consulte a permissão para acessar o repositório que você deseja clonar. Para ibter mais informações, consulte "[Erro: o HEAD remoto refere-se a uma ref inexistente, incapaz de fazer checkout](/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout)". - {% if currentVersion == "free-pro-team@latest" %} ### Leia mais diff --git a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md index 3dd3e29fcfb2..646561bfeb75 100644 --- a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md +++ b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md @@ -28,15 +28,15 @@ versions: {% endtip %} {% endif %} -{% data reusables.repositories.create_new %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} +{% data reusables.repositories.create_new %} 2. Se desejar, para criar um repositório com a estrutura de diretório e arquivos de um repositório existente, use o menu suspenso **Choose a template** (Escolher um modelo) e selecione um repositório de modelo. Você verá repositórios de modelo que pertencem a você e às organizações das quais você é integrante ou que usou antes. Para obter mais informações, consulte "[Criar um repositório a partir de um modelo](/articles/creating-a-repository-from-a-template)". ![Template drop-down menu](/assets/images/help/repository/template-drop-down.png){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -3. Opcionalmente, se você escolheu usar um modelo para incluir a estrutura do diretório e arquivos de todos os branches no modelo, e não apenas o branch-padrão, selecione **Incluir todos os branches**. ![Include all branches checkbox](/assets/images/help/repository/include-all-branches.png){% endif %}{% endif %} +3. Opcionalmente, se você escolheu usar um modelo para incluir a estrutura do diretório e arquivos de todos os branches no modelo, e não apenas o branch-padrão, selecione **Incluir todos os branches**. ![Include all branches checkbox](/assets/images/help/repository/include-all-branches.png){% endif %} 3. No menu suspenso Proprietário, selecione a conta na qual deseja criar o repositório.![Menu suspenso Owner (Proprietário)](/assets/images/help/repository/create-repository-owner.png) {% data reusables.repositories.repo-name %} {% data reusables.repositories.choose-repo-visibility %} -6. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}Se não for usar um modelo, {% else %}h{% endif %}á vários itens opcionais com os quais você pode preencher previamente seu repositório. Se for importar um repositório existente para o {% data variables.product.product_name %}, não escolha qualquer uma destas opções, pois isso poderá criar um conflito de merge. É possível {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.15" %}adicionar ou criar arquivos usando a interface do usuário ou {% endif %}optar por adicionar novos arquivos posteriormente usando a linha de comando. Para obter mais informações, consulte "[Importar um repositório Git usando a linha de comando](/articles/importing-a-git-repository-using-the-command-line/)", "[Adicionar um arquivo a um repositório usando a linha de comando](/articles/adding-a-file-to-a-repository-using-the-command-line)" e "[Solucionar conflitos de merge](/articles/addressing-merge-conflicts/)." +6. Se você não estiver usando um modelo, haverá um número de itens opcionais com os quais você pode preencher previamente o seu repositório. Se for importar um repositório existente para o {% data variables.product.product_name %}, não escolha qualquer uma destas opções, pois isso poderá criar um conflito de merge. É possível adicionar ou criar arquivos usando a interface de usuário ou optar por adicionar novos arquivos posteriormente usando a linha de comando. Para obter mais informações, consulte "[Importar um repositório Git usando a linha de comando](/articles/importing-a-git-repository-using-the-command-line/)", "[Adicionar um arquivo a um repositório usando a linha de comando](/articles/adding-a-file-to-a-repository-using-the-command-line)" e "[Solucionar conflitos de merge](/articles/addressing-merge-conflicts/)." - Você pode criar um LEIAME, que é um documento que descreve seu projeto. Para obter mais informações, consulte "[Sobre arquivos LEIAME](/articles/about-readmes/)". - - Você pode criar um arquivo *.gitignore*, que é um conjunto de regras com instruções para ignorar. Para obter mais informações, consulte "[Ignorar arquivos](/articles/ignoring-files)".{% if currentVersion == "free-pro-team@latest" %} + - Você pode criar um arquivo *.gitignore*, que é um conjunto de regras com instruções para ignorar. Para obter mais informações, consulte "[Ignorar arquivos](/articles/ignoring-files)."{% if currentVersion == "free-pro-team@latest" %} - Você pode optar por adicionar uma licença de software para seu projeto. Para obter mais informações, consulte "[Licenciar um repositório](/articles/licensing-a-repository)".{% endif %} {% data reusables.repositories.select-marketplace-apps %} {% data reusables.repositories.create-repo %} @@ -48,5 +48,4 @@ versions: - "[Gerenciar acessos aos repositórios da organização](/articles/managing-access-to-your-organization-s-repositories)" - [Guias de código aberto](https://opensource.guide/){% if currentVersion == "free-pro-team@latest" %} -- [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}){% endif %}{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.16" %} -- "[Inicializar um repositório vazio com um LEIAME](/articles/initializing-an-empty-repository-with-a-readme)"{% endif %} +- [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}){% endif %} diff --git a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md index fc78004466fd..dade074a8735 100644 --- a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md +++ b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md @@ -5,7 +5,7 @@ redirect_from: - /articles/creating-a-repository-from-a-template versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- ### Sobre modelos de repositório diff --git a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md index ebde41ce18ce..985918901d8d 100644 --- a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md +++ b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md @@ -1,19 +1,20 @@ --- -title: Criar um repositório de modelos -intro: 'Você pode converter um repositório existente em um modelo, para que você e outras pessoas possam gerar novos repositórios com a mesma estrutura de diretório{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}, branches,{% endif %} e arquivos.' +title: Creating a template repository +intro: 'You can make an existing repository a template, so you and others can generate new repositories with the same directory structure{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}, branches,{% endif %} and files.' redirect_from: - /articles/creating-a-template-repository versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- -Qualquer pessoa com permissões de administrador em um repositório pode transformar o repositório em um modelo. +Anyone with admin permissions to a repository can make the repository a template. -Para criar um repositório de modelos, é preciso criar um repositório e, em seguida, torná-lo um modelo. Para obter mais informações sobre como criar um repositório, consulte "[Criar um repositório](/articles/creating-a-new-repository)". +To create a template repository, you must create a repository, then make the repository a template. For more information about creating a repository, see "[Creating a new repository](/articles/creating-a-new-repository)." -Depois de converter o seu repositório em um modelo, qualquer pessoa com acesso ao repositório poderá gerar um novo repositório com a mesma estrutura de diretório e arquivos do branch-padrão.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} Eles também podem optar por incluir todos os outros branches no seu repositório.{% endif %} Para obter mais informações, consulte "[Criar um repositório a partir de um modelo](/articles/creating-a-repository-from-a-template)". +After you make your repository a template, anyone with access to the repository can generate a new repository with the same directory structure and files as your default branch.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} They can also choose to include all the other branches in your repository.{% endif %} For more information, see "[Creating a repository from a template](/articles/creating-a-repository-from-a-template)." {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} -3. Selecione **Template repository** (Repositório de modelos). ![Caixa de seleção para transformar um repositório em modelo](/assets/images/help/repository/template-repository-checkbox.png) +3. Select **Template repository**. + ![Checkbox to make a repository a template](/assets/images/help/repository/template-repository-checkbox.png) diff --git a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md index 3d219bbca134..8141864a6024 100644 --- a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md +++ b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md @@ -22,7 +22,7 @@ $ git clone https://{% data variables.command_line.codeblock %}/user/ aviso: HEAD remote faz referência a um ref inexistente, não é possível fazer checkout. ``` -Para corrigir o erro, você precisa ser o administrador do repositório em {% data variables.product.product_location %}. Você deverá [ alterar o branch padrão](/articles/setting-the-default-branch) do repositório. +Para corrigir o erro, você precisa ser o administrador do repositório em {% data variables.product.product_location %}. Você deverá [ alterar o branch padrão](/github/administering-a-repository/changing-the-default-branch) do repositório. Depois de fazer isso, você obterá uma lista de todos os branches disponíveis a partir da linha de comando: diff --git a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/error-repository-not-found.md b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/error-repository-not-found.md index 869a632372c3..7dbef3c63f5c 100644 --- a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/error-repository-not-found.md +++ b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/error-repository-not-found.md @@ -1,6 +1,6 @@ --- title: 'Erro: repositório não encontrado' -intro: '{% if currentVersion == "free-pro-team@latest" %}Se você encontrar esse erro ao clonar um repositório, significa que o repositório não existe ou você não tem permissão para acessá-lo. Existem algumas soluções para esse erro, dependendo do motivo.{% else %}Ao encontrar esse erro ao clonar um repositório, significa que o repositório não existe, você não tem permissão para acessá-lo ou a instância do GitHub Enterprise está em modo privado. Existem algumas soluções para esse erro, dependendo do motivo.{% endif %}' +intro: '{% if currentVersion == "free-pro-team@latest" %}Se você vir este erro ao clonar um repositório, isto significa que o repositório não existe ou que você não tem permissão para acessá-lo. Existem algumas soluções para esse erro, dependendo do motivo.{% else %}Ao encontrar esse erro ao clonar um repositório, significa que o repositório não existe, você não tem permissão para acessá-lo ou a instância do GitHub Enterprise está em modo privado. Existem algumas soluções para esse erro, dependendo do motivo.{% endif %}' redirect_from: - /articles/error-repository-not-found versions: diff --git a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/https-cloning-errors.md b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/https-cloning-errors.md index 4bce1a9c5a52..a219262354d3 100644 --- a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/https-cloning-errors.md +++ b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/https-cloning-errors.md @@ -1,6 +1,6 @@ --- title: Erros de clonagem HTTPs -intro: Existem alguns erros comuns ao usar HTTPS com o Git. Esses erros normalmente indicam que você tem uma versão antiga do Git ou que você não tem acesso ao repositório. +intro: 'Existem alguns erros comuns ao usar HTTPS com o Git. Esses erros normalmente indicam que você tem uma versão antiga do Git ou que você não tem acesso ao repositório.' redirect_from: - /articles/error-the-requested-url-returned-error-403/ - /articles/error-the-requested-url-returned-error-401/ diff --git a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md index 7455f4a0757b..88f4298670cb 100644 --- a/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md +++ b/translations/pt-BR/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md @@ -17,7 +17,7 @@ Você não tem qualquer obrigação de escolher uma licença. Entretanto, sem um {% note %} -**Observação:** se você publicar seu código-fonte em um repositório público no GitHub, {% if currentVersion == "free-pro-team@latest" %}de acordo com os [Termos de Serviço](/articles/github-terms-of-service), {% endif %}outros usuários do GitHub têm o direito de visualizar e bifurcar seu repositório dentro do site GitHub. Se você já criou um repositório público e não quer mais que os usuários tenham acesso a ele, você pode transformar seu repositório em privado. Ao converter um repositório público em repositório privado, as bifurcações ou cópias locais criadas por outros usuários continuam existindo. Para obter mais informações, consulte "[Converter um repositório público em privado](/articles/making-a-public-repository-private)". +**Observação:** Se você publicar seu código-fonte em um repositório público no GitHub, {% if currentVersion == "free-pro-team@latest" %}de acordo com os [termos de serviço](/articles/github-terms-of-service), {% endif %}outros usuários do GitHub terão o direito de visualizar e bifurcar o seu repositório no site do GitHub. Se você já criou um repositório público e não quer mais que os usuários tenham acesso a ele, você pode transformar seu repositório em privado. Ao converter um repositório público em repositório privado, as bifurcações ou cópias locais criadas por outros usuários continuam existindo. Para obter mais informações, consulte "[Converter um repositório público em privado](/articles/making-a-public-repository-private)". {% endnote %} @@ -49,6 +49,7 @@ Como uma prática recomendada, incentivamos que você inclua o arquivo da licen | | Licença Do What The F*ck You Want To Public | `wtfpl` | | | Licença Educational Community v2.0 | `ecl-2.0` | | | Licença Pública Eclipse 1.0 | `epl-1.0` | +| | Licença Pública Eclipse 2.0 | `epl-2.0` | | | Licença Pública da União Europeia 1.1 | `eupl-1.1` | | | Licença Pública Geral Affero GNU v3.0 | `agpl-3.0` | | | Família de Licença Pública Geral GNU | `gpl` | @@ -89,5 +90,5 @@ O objetivo das iniciativas de licenciamento de código aberto do GitHub é ofere ### Leia mais -- Seção do Open Source Guide (Guia de código aberto) "[O aspecto legal do código aberto](https://opensource.guide/legal/)"{% if currentVersion == "free-pro-team@latest" %} +- A seção "Guias de código aberto"[O lado Jurídico de código aberto](https://opensource.guide/legal/)"{% if currentVersion == "free-pro-team@latest" %} - [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}){% endif %} diff --git a/translations/pt-BR/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md b/translations/pt-BR/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md new file mode 100644 index 000000000000..07276ac1122d --- /dev/null +++ b/translations/pt-BR/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md @@ -0,0 +1,27 @@ +--- +title: Sobre a cobrança para codespaces +intro: 'Quando {% data variables.product.prodname_codespaces %} se torna geralmente disponível, você será cobrado para armazenamento e uso de computação.' +product: '{% data reusables.gated-features.codespaces %}' +versions: + free-pro-team: '*' +--- + +{% data reusables.codespaces.release-stage %} + +{% data reusables.codespaces.about-billing-for-codespaces %} + +Os custos de computação só são incorridos quando um código está ativo. Ao usar um codespace, significa que o código está ativo. Após 30 minutos de inatividade, um codespace é suspenso automaticamente. + +O uso de computação é faturado por hora, a uma taxa que depende do tipo da instância do seu codespace. Durante o beta, {% data variables.product.prodname_codespaces %} oferece um tipo de instância único do Linux. Na disponibilidade geral, vamos suportar três tipos de instância do Linux. + +| Tipo de Instância (Linux) | Taxa por hora | +| ---------------------------------------- | ------------- | +| Básico (2 cores, 4GB RAM, 32 GB SSD) | $ 0,085 | +| Padrão (4 cores, 8 GB de RAM, 32 GB SSD) | $ 0,169 | +| Premium (8 cores, 16 GB RAM, 32 GB SSD) | $ 0,339 | + +O preço computacional pode variar para outros tipos de instância e sistemas operacionais suportados no futuro. + +Cada codespace também incorre em custos de armazenamento mensal até você excluir o codespace. Os custos de armazenamento para todos os tipos de instância são $ 0,10/GB por mês. + +Compartilharemos mais informações sobre qualquer uso de computação e armazenamento incluído em cada plano em termos de disponibilidade geral. diff --git a/translations/pt-BR/content/github/developing-online-with-codespaces/about-codespaces.md b/translations/pt-BR/content/github/developing-online-with-codespaces/about-codespaces.md index 2de1ec414fe7..bd92c65f7351 100644 --- a/translations/pt-BR/content/github/developing-online-with-codespaces/about-codespaces.md +++ b/translations/pt-BR/content/github/developing-online-with-codespaces/about-codespaces.md @@ -44,7 +44,7 @@ Todos os desenvolvedores podem criar um ou mais codespaces para qualquer reposit ### Sobre a cobrança do {% data variables.product.prodname_codespaces %} -Durante o beta público limitado, {% data variables.product.prodname_codespaces %} pode ser usado livremente e os usuários estão limitados a 2 codespaces. Os planos e os preços serão anunciados antes da disponibilidade para o público em geral. +{% data reusables.codespaces.about-billing-for-codespaces %} Para obter mais informações, consulte "[Sobre a cobrança do {% data variables.product.prodname_codespaces %}](/github/developing-online-with-codespaces/about-billing-for-codespaces)". ### Juntar-se ao beta diff --git a/translations/pt-BR/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md b/translations/pt-BR/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md index 28b297e1b7c0..1c1de419fdad 100644 --- a/translations/pt-BR/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md +++ b/translations/pt-BR/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md @@ -21,7 +21,9 @@ Se você não definir uma configuração no repositório, o {% data variables.pr É possível criar uma configuração-padrão do codespace usando uma configuração de contêiner pré-criada para seu tipo de projeto, ou você pode criar uma configuração personalizada específica para as necessidades do seu projeto. -O {% data variables.product.prodname_codespaces %} usa as configurações contidas em um arquivo denominado `devcontainer.json` na raiz do repositório ou na pasta `.devcontainer`. Você pode usar `devcontainer.json` para definir as configurações-padrão para todo o ambiente de código, incluindo o editor de {% data variables.product.prodname_vscode %}, mas você também pode definir configurações específicas do editor em um arquivo denominado `.vscode/settings.json`. +{% data variables.product.prodname_codespaces %} usa configurações contidas em um arquivo de configuração denominado `devcontainer.json`. {% data reusables.codespaces.devcontainer-location %} + +Você pode usar o seu `devcontainer.json` para definir as configurações-padrão para todo o ambiente de código, incluindo o editor de {% data variables.product.prodname_vscode %}, mas você também pode definir configurações específicas do editor em um arquivo denominado `.vscode/settings.json`. As alterações na configuração do codespace de um repositório aplicam-se apenas a cada novo codespace e não afetam nenhum codespace existente. @@ -38,7 +40,9 @@ Cada novo codespace criado a partir de um branch que contém a pasta `.devcontai ### Criar uma configuração personalizada de codespace -Se nenhuma das configurações pré-criadas atenderem às suas necessidades, você poderá criar uma configuração personalizada adicionando um arquivo `devcontainer.json` à raiz do seu repositório ou a uma pasta `.devcontainer`. No arquivo, você pode usar chaves de configuração compatíveis para especificar os aspectos do ambiente do código, como quais extensões do {% data variables.product.prodname_vscode %} serão instaladas. +Se nenhuma das configurações pré-criadas atender às suas necessidades, você poderá criar uma configuração personalizada adicionando um arquivo `devcontainer.json`. {% data reusables.codespaces.devcontainer-location %} + +No arquivo, você pode usar chaves de configuração compatíveis para especificar os aspectos do ambiente do código, como quais extensões do {% data variables.product.prodname_vscode %} serão instaladas. {% data reusables.codespaces.vscode-settings-order %} diff --git a/translations/pt-BR/content/github/developing-online-with-codespaces/creating-a-codespace.md b/translations/pt-BR/content/github/developing-online-with-codespaces/creating-a-codespace.md index b846a65ed9d1..418cf49899ea 100644 --- a/translations/pt-BR/content/github/developing-online-with-codespaces/creating-a-codespace.md +++ b/translations/pt-BR/content/github/developing-online-with-codespaces/creating-a-codespace.md @@ -2,7 +2,7 @@ title: Criar um codespace intro: Você pode criar um codespace para uma branch em um repositório para fazer o desenvolvimento on-line. product: '{% data reusables.gated-features.codespaces %}' -permissions: Qualquer pessoa pode criar um codespace para qualquer repositório público ou para qualquer repositório que pertence à sua conta de usuário. +permissions: 'Qualquer pessoa pode criar um codespace para qualquer repositório público ou para qualquer repositório que pertence à sua conta de usuário.' redirect_from: - /github/developing-online-with-github-codespaces/creating-a-codespace versions: diff --git a/translations/pt-BR/content/github/developing-online-with-codespaces/index.md b/translations/pt-BR/content/github/developing-online-with-codespaces/index.md index 405ca37fd605..9cef2e35f9c2 100644 --- a/translations/pt-BR/content/github/developing-online-with-codespaces/index.md +++ b/translations/pt-BR/content/github/developing-online-with-codespaces/index.md @@ -14,10 +14,12 @@ versions: ### Índice {% link_in_list /about-codespaces %} +{% link_in_list /about-billing-for-codespaces %} {% link_in_list /configuring-codespaces-for-your-project %} {% link_in_list /creating-a-codespace %} {% link_in_list /developing-in-a-codespace %} {% link_in_list /personalizing-codespaces-for-your-account %} {% link_in_list /deleting-a-codespace %} {% link_in_list /troubleshooting-your-codespace %} -{% link_in_list /connecting-to-your-codespace-from-visual-studio-code %} +{% link_in_list /using-codespaces-in-visual-studio-code %} +{% link_in_list /using-codespaces-in-visual-studio %} diff --git a/translations/pt-BR/content/github/developing-online-with-codespaces/troubleshooting-your-codespace.md b/translations/pt-BR/content/github/developing-online-with-codespaces/troubleshooting-your-codespace.md index c319610f19b7..8cb60671a5c5 100644 --- a/translations/pt-BR/content/github/developing-online-with-codespaces/troubleshooting-your-codespace.md +++ b/translations/pt-BR/content/github/developing-online-with-codespaces/troubleshooting-your-codespace.md @@ -1,6 +1,6 @@ --- title: Solucionar problemas do seu codespace -intro: 'É possível solucionar problemas com um codespace, buscando problemas conhecidos no repositório `microsoft/vscode`.' +intro: É possível solucionar problemas com um codespace, buscando problemas conhecidos no repositório `microsoft/vscode`. product: '{% data reusables.gated-features.codespaces %}' redirect_from: - /github/developing-online-with-github-codespaces/troubleshooting-your-codespace diff --git a/translations/pt-BR/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md b/translations/pt-BR/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md new file mode 100644 index 000000000000..a7db1b93425f --- /dev/null +++ b/translations/pt-BR/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md @@ -0,0 +1,45 @@ +--- +title: Usar espaços de código no Visual Studio Code +intro: 'Você pode desenvolver seu codespace diretamente em {% data variables.product.prodname_vscode %}, conectando a extensão de {% data variables.product.prodname_vs_codespaces %} à sua conta no {% data variables.product.product_name %}.' +product: '{% data reusables.gated-features.codespaces %}' +redirect_from: + - /github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code +versions: + free-pro-team: '*' +--- + +{% data reusables.codespaces.release-stage %} + +### Pré-requisitos + +Antes de poder desenvolver em um código diretamente em {% data variables.product.prodname_vscode %}, você deverá configurar a extensão {% data variables.product.prodname_vs_codespaces %} para conectar-se à sua conta do {% data variables.product.product_name %}. + +1. Use o {% data variables.product.prodname_vs %} Marketplace para instalar a extensão [{% data variables.product.prodname_vs_codespaces %}](https://marketplace.visualstudio.com/items?itemName=ms-vsonline.vsonline). Para obter mais informações, consulte [Extensão do Marketplace](https://code.visualstudio.com/docs/editor/extension-gallery) na documentação do {% data variables.product.prodname_vscode %}. +2. Clique no ícone Extensões na barra lateral esquerda do {% data variables.product.prodname_vscode %}. ![O ícone das extensões em {% data variables.product.prodname_vscode %}](/assets/images/help/codespaces/click-extensions-icon-vscode.png) +3. Abaixo do {% data variables.product.prodname_vs_codespaces %}, clique no ícone Gerenciar e, em seguida, clique em **Configurações de extensão**. ![A opção Configurações de extensão](/assets/images/help/codespaces/select-extension-settings.png) +4. Use o menu suspenso "Vsonline: Provedor de Conta", e selecione {% data variables.product.prodname_dotcom %}. ![Definir o provedor de conta para {% data variables.product.prodname_dotcom %}](/assets/images/help/codespaces/select-account-provider-vscode.png) +{% data reusables.codespaces.click-remote-explorer-icon-vscode %} +6. Se {% data variables.product.prodname_codespaces %} não estiver selecionado no cabeçalho, clique em **{% data variables.product.prodname_codespaces %}**. ![Cabeçalho do {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/codespaces-header-vscode.png) +7. Clique em **Iniciar sessão para visualizar {% data variables.product.prodname_codespaces %}...**. ![Registrar-se para visualizar {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/sign-in-to-view-codespaces-vscode.png) +8. Para autorizar o {% data variables.product.prodname_vscode %} a acessar sua conta no {% data variables.product.product_name %}, clique em **Permitir**. +9. Registre-se e, {% data variables.product.product_name %} para aprovar a extensão. + +### Criar um codespace em {% data variables.product.prodname_vscode %} + +Depois de conectar sua conta de {% data variables.product.product_name %} à extensão de {% data variables.product.prodname_vs_codespaces %}, você pode desenvolver em um codespace que você criou no {% data variables.product.product_name %} ou em {% data variables.product.prodname_vscode %}. + +{% data reusables.codespaces.click-remote-explorer-icon-vscode %} +2. Clique no ícone Adicionar e, em seguida, clique em **Criar novo codespace**. ![A opção "Criar novo codespace" em {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/create-codespace-vscode.png) +3. Digite e, em seguida, clique no nome do repositório no qual você deseja desenvolver. ![Pesquisar um repositório para criar um novo {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/choose-repository-vscode.png) +4. Clique na branch no qual você deseja desenvolver. ![Pesquisar um branch para criar um novo {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/choose-branch-vscode.png) + +### Abrir um codespace em {% data variables.product.prodname_vscode %} + +{% data reusables.codespaces.click-remote-explorer-icon-vscode %} +2. Em Codespaces, clique no codespace que você deseja desenvolver. +3. Clique no ícone Conectar-se ao Codespace. ![Ícone de conectar-se a um Codespace em {% data variables.product.prodname_vscode %}](/assets/images/help/codespaces/click-connect-to-codespace-icon-vscode.png) + +### Excluir um codespace em {% data variables.product.prodname_vscode %} + +1. Em codespaces, clique com o botão direito no codespace que você deseja excluir. +2. No menu suspenso, clique em **Excluir o codespace**. ![Excluir um codespace em {% data variables.product.prodname_dotcom %}](/assets/images/help/codespaces/delete-codespace-vscode.png) diff --git a/translations/pt-BR/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md b/translations/pt-BR/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md new file mode 100644 index 000000000000..c6db8c6e2821 --- /dev/null +++ b/translations/pt-BR/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md @@ -0,0 +1,53 @@ +--- +title: Usar Codespaces no Visual Studio +intro: 'Você pode desenvolver seu código diretamente em {% data variables.product.prodname_vs %} conectando-se com sua conta no {% data variables.product.product_name %}.' +product: '{% data reusables.gated-features.codespaces %}' +versions: + free-pro-team: '*' +--- + +{% note %} + +**Observação:** {% data variables.product.prodname_codespaces %} está atualmente em versão beta pública limitada e sujeito a alterações. Durante o período beta, {% data variables.product.prodname_dotcom %} não faz nenhuma garantia sobre a disponibilidade de {% data variables.product.prodname_codespaces %}. [Cadastre-se para o beta público limitado](https://github.com/features/codespaces/signup-vs). Para obter mais informações sobre fontes de publicação, consulte "[About {% data variables.product.prodname_codespaces %}](/github/developing-online-with-codespaces/about-codespaces#joining-the-beta)." + +{% endnote %} + +### Sobre os espaços de código no {% data variables.product.prodname_vs %} + +Você pode criar um código no {% data variables.product.prodname_vs %} para desenvolver aplicativos em um ambiente Windows. Ao usar um código em {% data variables.product.prodname_vs %}, você pode navegar pelo código-fonte, criar soluções e fazer commit de alterações no seu repositório. + +Você deve criar um codespace em {% data variables.product.prodname_vs %} para usá-lo com o aplicativo. Os codespaces criados fora do {% data variables.product.prodname_vs %} não podem ser usados atualmente com {% data variables.product.prodname_vs %}. + +### Pré-requisitos + +Antes de configurar um código em {% data variables.product.prodname_vs %}, você deve fazer o download da última versão da pré-visualização de [{% data variables.product.prodname_vs %}](https://aka.ms/vspreview). + +#### Habilitar a conexão entre {% data variables.product.prodname_vs %} e {% data variables.product.prodname_github_codespaces %} + +A conexão ao {% data variables.product.prodname_github_codespaces %} com a pré-visualização de {% data variables.product.prodname_vs %} não está habilitado por padrão. Portanto, você primeiro deverá habilitar o recurso de pré-visualização. + +1. Na visualização do {% data variables.product.prodname_vs %}, use o menu suspenso Ferramentas e, em seguida, clique em **Opções**. +2. Em **Ambiente**, selecione **Recursos de pré-visualização** e verifique o recurso de pré-visualização **Conectar a {% data variables.product.prodname_github_codespaces %}**. ![Verifique o recurso de pré-visualização conectar ao {% data variables.product.prodname_github_codespaces %}](/assets/images/help/codespaces/connect-to-github-codespaces-preview-feature.png) +3. Será necessário reiniciar o {% data variables.product.prodname_vs %} para que o recurso esteja disponível. + +### Criar um codespace em {% data variables.product.prodname_vs %} + +1. Quando você iniciar o {% data variables.product.prodname_vs %}, a Janela Inicial irá exibir um botão **Conectar-se a um codespace** em "Iniciar". ![Janela de início do Visual Studio com a conexão a um codespace](/assets/images/help/codespaces/visual-studio-start-window.png) +2. Clique em **Conectar-se a um codespace**. +3. Clique em **Efetuar login em {% data variables.product.prodname_dotcom %}** e siga as instruções ou clique em **Criar uma!** para criar uma nova conta de {% data variables.product.prodname_dotcom %} e entrar na conta. ![Login do Visual Studio em {% data variables.product.prodname_dotcom %}](/assets/images/help/codespaces/visual-studio-sign-in-to-github.png) +4. Em "Informações de codespace", digite a URL do repositório que você deseja que o {% data variables.product.prodname_github_codespaces %} clone no seu codespace. +5. Opcionalmente, use o tipo de instância e suspenda após os menus suspensos para configurar mais informações do codespace. ![Detalhes do codespace do Visual Studio](/assets/images/help/codespaces/visual-studio-codespace-details.png) +6. Clique em **Criar e conectar**. {% data variables.product.prodname_github_codespaces %} começará a preparar o codespace e abrirá {% data variables.product.prodname_vs %} depois que o codespace estiver pronto. O nome do codespace será exibido no indicador remoto no menu. ![Visual Studio conectado ao codespace do repositório do eShopOnWeb](/assets/images/help/codespaces/visual-studio-eshoponweb-codespace.png) + +### Abrir um codespace em {% data variables.product.prodname_vs %} + +1. Use o menu suspenso de arquivos e clique em **Conectar a um codespace**. ![Conexão do Arquivo do Visual Studio a um item de menu do codespace](/assets/images/help/codespaces/visual-studio-file-connect-to-codespace.png) +2. Em "{% data variables.product.prodname_github_codespaces %}", clique no codespace ao qual você deseja conectar-se e, em seguida, clique em **Conectar**. ![Visual Studio exibe codespaces e informações disponíveis](/assets/images/help/codespaces/visual-studio-connect-codespace.png) + +### Configurar um codespace para {% data variables.product.prodname_vs %} + +O ambiente de codespace padrão criado pelo {% data variables.product.prodname_vs %} inclui estruturas e ferramentas populares como .NET Core, Microsoft SQL Server, Python e Windows SDK. O {% data variables.product.prodname_github_codespaces %} criado com {% data variables.product.prodname_vs %} pode ser personalizado por meio de um subconjunto de propriedades do `devcontainers.json` e uma nova ferramenta denominada devinit, incluída com o {% data variables.product.prodname_vs %}. + +#### devinit + +A ferramenta de linha de comando [devinit](https://docs.microsoft.com/visualstudio/devinit/getting-started-with-devinit) permite que você instale estruturas adicionais e ferramentas em seus códigos de desenvolvimento do Windows, além de executar scripts de PowerShell ou modificar variáveis de ambiente. A devinit é compatível com um arquivo de configuração denominado [devinit.json](https://docs.microsoft.com/visualstudio/devinit/devinit-json), que pode ser adicionado ao seu projeto para criar ambientes de desenvolvimento personalizados e repetíveis. Para obter mais informações sobre a configuração do codespace do Windows e sobre a devinit, consulte [Personalizar um codespace](https://docs.microsoft.com/visualstudio/ide/codespaces/customize-codespaces) na documentação do {% data variables.product.prodname_vs %}. diff --git a/translations/pt-BR/content/github/extending-github/getting-started-with-the-api.md b/translations/pt-BR/content/github/extending-github/getting-started-with-the-api.md index 6d19adb08b94..0f913074419c 100644 --- a/translations/pt-BR/content/github/extending-github/getting-started-with-the-api.md +++ b/translations/pt-BR/content/github/extending-github/getting-started-with-the-api.md @@ -16,5 +16,5 @@ Para obter mais informações sobre a API, consulte a [API REST do GitHub](/rest ### Leia mais -- "[Backup de um repositório](/articles/backing-up-a-repository)"{% if currentVersion == "free-pro-team@latest" %} +- "[Fazer backup de um repositório](/articles/backing-up-a-repository)"{% if currentVersion == "free-pro-team@latest" %} - "[Sobre integrações](/articles/about-integrations)"{% endif %} diff --git a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md index defb7d667560..ff27712b4928 100644 --- a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md +++ b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md @@ -18,7 +18,7 @@ versions: You can use {% data variables.product.prodname_code_scanning %} to find, triage, and prioritize fixes for existing problems in your code. {% data variables.product.prodname_code_scanning_capc %} also prevents developers from introducing new problems. You can schedule scans for specific days and times, or trigger scans when a specific event occurs in the repository, such as a push. -If {% data variables.product.prodname_code_scanning %} finds a potential vulnerability or error in your code, {% data variables.product.prodname_dotcom %} displays an alert in the repository. After you fix the code that triggered the alert, {% data variables.product.prodname_dotcom %} closes the alert. For more information, see "[Managing alerts from {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." +If {% data variables.product.prodname_code_scanning %} finds a potential vulnerability or error in your code, {% data variables.product.prodname_dotcom %} displays an alert in the repository. After you fix the code that triggered the alert, {% data variables.product.prodname_dotcom %} closes the alert. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." To monitor results from {% data variables.product.prodname_code_scanning %} across your repositories or your organization, you can use the {% data variables.product.prodname_code_scanning %} API. For more information about API endpoints, see "[{% data variables.product.prodname_code_scanning_capc %}](/v3/code-scanning)." diff --git a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md index c19dde349863..cdb4640984c7 100644 --- a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md +++ b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md @@ -1,7 +1,7 @@ --- title: Sobre integração com a varredura de código shortTitle: Sobre a integração -intro: 'Você pode executar {% data variables.product.prodname_code_scanning %} externamente e, em seguida, exibir os resultados em {% data variables.product.prodname_dotcom %}.' +intro: 'Você pode executar {% data variables.product.prodname_code_scanning %} externamente e depois exibir os resultados em {% data variables.product.prodname_dotcom %} ou configurar webhooks que escutem a atividade de {% data variables.product.prodname_code_scanning %} no seu repositório.' product: '{% data reusables.gated-features.code-scanning %}' versions: free-pro-team: '*' @@ -11,14 +11,16 @@ versions: {% data reusables.code-scanning.beta %} {% data reusables.code-scanning.enterprise-enable-code-scanning %} -Como alternativa para executar o {% data variables.product.prodname_code_scanning %} dentro do {% data variables.product.prodname_dotcom %}, você pode realizar a análise em outro lugar e, posteriormente, fazer o upload dos resultados. Alertas para {% data variables.product.prodname_code_scanning %} que você executa externamente são exibidos da mesma forma que os alertas para {% data variables.product.prodname_code_scanning %} que você executa dentro de {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte "[Gerenciar alertas do varredura de código](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." - -Você pode usar o seu sistema de integração contínua ou de entrega/implantação contínua (CI/CD) para executar a análise de {% data variables.product.prodname_codeql %} do {% data variables.product.prodname_dotcom %} e carregar os resultados para {% data variables.product.prodname_dotcom %}. Esta é uma alternativa ao uso de {% data variables.product.prodname_actions %} para executar a análise de {% data variables.product.prodname_codeql %}. Para obter mais informações, consulte "[Executar a verificação de código no seu sistema de CI](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)". +Como alternativa para executar o {% data variables.product.prodname_code_scanning %} dentro do {% data variables.product.prodname_dotcom %}, você pode realizar a análise em outro lugar e, posteriormente, fazer o upload dos resultados. Alertas para {% data variables.product.prodname_code_scanning %} que você executa externamente são exibidos da mesma forma que os alertas para {% data variables.product.prodname_code_scanning %} que você executa dentro de {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte "[Gerenciar alertas de {% data variables.product.prodname_code_scanning %} para o seu repositório](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)". Se você usar uma ferramenta de análise estática de terceiros que pode produzir dados de resultados como Formato de Intercâmbio de Resultados de Análise Estática (SARIF) 2.1.0, você pode fazer o upload desses dados em {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte "[Fazer o upload de um arquivo SARIF para o GitHub](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)". +### Integrações com webhooks + +Você pode usar {% data variables.product.prodname_code_scanning %} webhooks para criar ou configurar integrações, tais como [{% data variables.product.prodname_github_app %}s](/apps/building-github-apps/) ou [{% data variables.product.prodname_oauth_app %}s](/apps/building-oauth-apps/), que assinam os eventos {% data variables.product.prodname_code_scanning %} no seu repositório. Por exemplo, você poderia criar uma integração que criasse um problema no {% data variables.product.product_location %} ou que envia uma notificação do Slack quando um novo alerta de {% data variables.product.prodname_code_scanning %} for adicionado ao seu repositório. Para obter mais informações, consulte "[Criar webhooks](/developers/webhooks-and-events/creating-webhooks)" e "[Eventos de Webhook e cargas](/developers/webhooks-and-events/webhook-events-and-payloads#code_scanning_alert)". + ### Leia mais -* "[Sobre a varredura de código](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)" -* "[Configurar a verificação de código no seu sistema de CI](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-in-your-ci-system)" -* "[Suporte de SARIF para a varredura de código](/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning)" +* "[Sobre {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)" +* "[Usar {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} com seu sistema de CI existente +* "[Suporte do SARIF para {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning)" diff --git a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md index bba407e275dc..e0f16c30b6de 100644 --- a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md +++ b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md @@ -3,6 +3,7 @@ title: Analisar automaticamente seu código com relação a vulnerabilidades e e shortTitle: Fazer varredura automaticamente intro: 'Você pode encontrar vulnerabilidades e erros no código do seu projeto no {% data variables.product.prodname_dotcom %}.' mapTopic: true +product: '{% data reusables.gated-features.code-scanning %}' versions: free-pro-team: '*' enterprise-server: '>=2.22' diff --git a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md index 574506a6d7c1..af2300e7a3c5 100644 --- a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md +++ b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md @@ -1,8 +1,8 @@ --- -title: Configurar a varredura do código -intro: 'Você pode configurar como o {% data variables.product.prodname_dotcom %} faz a varredura do código no seu projeto com relação a vulnerabilidades e erros.' +title: Configuring code scanning +intro: 'You can configure how {% data variables.product.prodname_dotcom %} scans the code in your project for vulnerabilities and errors.' product: '{% data reusables.gated-features.code-scanning %}' -permissions: 'Pessoas com permissões de gravação para um repositório podem configurar {% data variables.product.prodname_code_scanning %} para o repositório.' +permissions: 'People with write permissions to a repository can configure {% data variables.product.prodname_code_scanning %} for the repository.' miniTocMaxHeadingLevel: 4 versions: free-pro-team: '*' @@ -12,75 +12,80 @@ versions: {% data reusables.code-scanning.beta %} {% data reusables.code-scanning.enterprise-enable-code-scanning-actions %} +### About {% data variables.product.prodname_code_scanning %} configuration -### Sobre a configuração do {% data variables.product.prodname_code_scanning %} +You can run {% data variables.product.prodname_code_scanning %} within {% data variables.product.product_location %}, using {% data variables.product.prodname_actions %}, or from your continuous integration (CI) system, using the {% data variables.product.prodname_codeql_runner %}. For more information about {% data variables.product.prodname_actions %}, see "[About {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)." For more information about the {% data variables.product.prodname_codeql_runner %}, see "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)." -Você pode executar {% data variables.product.prodname_code_scanning %} em {% data variables.product.product_location %}, usando {% data variables.product.prodname_actions %} ou a partir do seu sistema de integração contínua (CI), usando o {% data variables.product.prodname_codeql_runner %}. Para obter mais informações sobre {% data variables.product.prodname_actions %}, consulte "[Sobre {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)." Para obter mais informações sobre o {% data variables.product.prodname_codeql_runner %}, consulte "[Executar {% data variables.product.prodname_code_scanning %} no seu sistema de CI](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)". +This article is about running {% data variables.product.prodname_code_scanning %} within {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_ghe_server %}{% else %}{% data variables.product.prodname_dotcom %}{% endif %}. -Este artigo está relacionado à execução de {% data variables.product.prodname_code_scanning %} dentro de {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_ghe_server %}{% else %}{% data variables.product.prodname_dotcom %}{% endif %}. - -Antes de poder configurar o {% data variables.product.prodname_code_scanning %} para um repositório, você deve habilitar o {% data variables.product.prodname_code_scanning %} adicionando um fluxo de trabalho do {% data variables.product.prodname_actions %} ao repositório. Para obter mais informações, consulte "[Habilitando {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning). +Before you can configure {% data variables.product.prodname_code_scanning %} for a repository, you must enable {% data variables.product.prodname_code_scanning %} by adding a {% data variables.product.prodname_actions %} workflow to the repository. For more information, see "[Enabling {% data variables.product.prodname_code_scanning %} for a repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository)." {% data reusables.code-scanning.edit-workflow %} -A análise de {% data variables.product.prodname_codeql %} é apenas um tipo de {% data variables.product.prodname_code_scanning %} que você pode fazer em {% data variables.product.prodname_dotcom %}. {% data variables.product.prodname_marketplace %}{% if currentVersion ver_gt "enterprise-server@2.21" %} em {% data variables.product.prodname_dotcom_the_website %}{% endif %} contém outros fluxos de trabalho de {% data variables.product.prodname_code_scanning %} que você pode usar. {% if currentVersion == "free-pro-team@latest" %}Você pode encontrar uma seleção destes na página "Comece com {% data variables.product.prodname_code_scanning %}", que você pode acessar na aba **{% octicon "shield" aria-label="The shield symbol" %} Segurança**.{% endif %} Os exemplos específicos fornecidos neste artigo estão relacionados ao arquivo de {% data variables.product.prodname_codeql_workflow %}. +{% data variables.product.prodname_codeql %} analysis is just one type of {% data variables.product.prodname_code_scanning %} you can do in {% data variables.product.prodname_dotcom %}. {% data variables.product.prodname_marketplace %}{% if currentVersion ver_gt "enterprise-server@2.21" %} on {% data variables.product.prodname_dotcom_the_website %}{% endif %} contains other {% data variables.product.prodname_code_scanning %} workflows you can use. {% if currentVersion == "free-pro-team@latest" %}You can find a selection of these on the "Get started with {% data variables.product.prodname_code_scanning %}" page, which you can access from the **{% octicon "shield" aria-label="The shield symbol" %} Security** tab.{% endif %} The specific examples given in this article relate to the {% data variables.product.prodname_codeql_workflow %} file. -### Editing a code scanning workflow +### Editing a {% data variables.product.prodname_code_scanning %} workflow -O {% data variables.product.prodname_dotcom %} salva arquivos de fluxo de trabalho no diretório _.github/workflows_ do seu repositório. You can find the workflow by searching for its file name. For example, the default workflow file for CodeQL code scanning is called `codeql-analysis.yml`. +{% data variables.product.prodname_dotcom %} saves workflow files in the _.github/workflows_ directory of your repository. You can find a workflow you have enabled by searching for its file name. For example, by default, the workflow file for {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} is called _codeql-analysis.yml_. -1. No seu repositório, pesquise o arquivo do fluxo de trabalho que você deseja editar. -1. No canto superior direito da vista do arquivo, clique em {% octicon "pencil" aria-label="The edit icon" %} para abrir o editor do fluxo de trabalho. ![Edite o botão do arquivo do fluxo de trabalho](/assets/images/help/repository/code-scanning-edit-workflow-button.png) -1. Depois de ter editado o arquivo, clique em **Iniciar commit** e preencha o formulário "Alterações do commit". Você pode escolher o "commit" diretamente no branch atual ou criar um novo branch e iniciar um pull request. ![Atualização do commit para o fluxo de trabalho do codeql.yml](/assets/images/help/repository/code-scanning-workflow-update.png) +1. In your repository, browse to the workflow file you want to edit. +1. In the upper right corner of the file view, to open the workflow editor, click {% octicon "pencil" aria-label="The edit icon" %}. +![Edit workflow file button](/assets/images/help/repository/code-scanning-edit-workflow-button.png) +1. After you have edited the file, click **Start commit** and complete the "Commit changes" form. You can choose to commit directly to the current branch, or create a new branch and start a pull request. +![Commit update to codeql.yml workflow](/assets/images/help/repository/code-scanning-workflow-update.png) -Para obter mais informações sobre edição de arquivos de fluxo de trabalho, consulte "[Configurar um fluxo de trabalho](/actions/configuring-and-managing-workflows/configuring-a-workflow)". +For more information about editing workflow files, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." -### Configurar a frequência +### Configuring frequency -Você pode fazer a varredura de código de forma pré-programada ou quando ocorrerem eventos específicos em um repositório. +You can configure the {% data variables.product.prodname_codeql_workflow %} to scan code on a schedule or when specific events occur in a repository. -A varredura do código a cada push para o repositório, e toda vez que um pull request é criado, isso impede que os desenvolvedores introduzam novas vulnerabilidades e erros no código. A varredura do código de forma pré-programada informa as últimas vulnerabilidades e erros de {% data variables.product.company_short %}, que os pesquisadores de segurança e da comunidade, mesmo quando desenvolvedores não estão mantendo o repositório de forma ativa. +Scanning code when someone pushes a change, and whenever a pull request is created, prevents developers from introducing new vulnerabilities and errors into the code. Scanning code on a schedule informs you about the latest vulnerabilities and errors that {% data variables.product.company_short %}, security researchers, and the community discover, even when developers aren't actively maintaining the repository. -#### Fazer a varredura no push +#### Scanning on push -Se você usar o fluxo de trabalho padrão, o {% data variables.product.prodname_code_scanning %} fará a varredura do código no repositório uma vez por semana, além das varreduras acionadas pelos eventos. Para ajustar essa programação, edite o valor `CRON` no fluxo de trabalho. Para obter mais informações, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#on)". +By default, the {% data variables.product.prodname_codeql_workflow %} uses the `on.push` event to trigger a code scan on every push to the default branch of the repository and any protected branches. For {% data variables.product.prodname_code_scanning %} to be triggered on a specified branch, the workflow must exist in that branch. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#on)." -#### Fazer a varredura de pull requests +#### Scanning pull requests -**Observação**: As palavras-chave `caminhos` e `paths-ignore` usadas no contexto do arquivo de configuração de {% data variables.product.prodname_code_scanning %} não devem ser confundidas com as mesmas palavras-chave quando usadas para `on..paths`. Quando estão acostumados a modificar `on.` em um arquivo de fluxo de trabalho, eles determinam se as ações serão executadas quando alguém modificar o código nos diretórios especificados. Para obter mais informações, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)". +The default {% data variables.product.prodname_codeql_workflow %} uses the `pull_request` event to trigger a code scan on the `HEAD` commit of a pull request against the default branch. {% if currentVersion ver_gt "enterprise-server@2.21" %}The `pull_request` event is not triggered if the pull request was opened from a private fork.{% else %}If a pull request is from a private fork, the `pull_request` event will only be triggered if you've selected the "Run workflows from fork pull requests" option in the repository settings. For more information, see "[Disabling or limiting {% data variables.product.prodname_actions %} for a repository](/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository#enabling-workflows-for-private-repository-forks)."{% endif %} -Para obter mais informações sobre o evento `pull_request` , consulte "[Sintaxe de fluxo de trabalho para {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)". +For more information about the `pull_request` event, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)." -#### Fazer a varredura de forma pré-programada +#### Scanning on a schedule -O fluxo de trabalho padrão do {% data variables.product.prodname_code_scanning %} usa o evento `on.push` para acionar uma varredura de código em cada push para qualquer branch que contém o arquivo de fluxo de trabalho. Para ajustar essa programação, edite o valor `CRON` no fluxo de trabalho. Para obter mais informações, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onschedule)". +If you use the default {% data variables.product.prodname_codeql_workflow %}, the workflow will scan the code in your repository once a week, in addition to the scans triggered by events. To adjust this schedule, edit the `cron` value in the workflow. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onschedule)." {% note %} -**Observação**: {% data variables.product.prodname_dotcom %} executa apenas trabalhos programados que estão em fluxos de trabalho no branch-padrão. Alterar a programação de um fluxo de trabalho em qualquer outro branch não terá efeito até que você mescle o branch com o branch-padrão. +**Note**: {% data variables.product.prodname_dotcom %} only runs scheduled jobs that are in workflows on the default branch. Changing the schedule in a workflow on any other branch has no effect until you merge the branch into the default branch. {% endnote %} -#### Exemplo +#### Example -O exemplo a seguir mostra um {% data variables.product.prodname_codeql_workflow %} para um repositório em particular que possui um branch-padrão denominado `principal` e um branch protegido denominado `protegido`. +The following example shows a {% data variables.product.prodname_codeql_workflow %} for a particular repository that has a default branch called `main` and one protected branch called `protected`. ``` yaml on: push: + branches: [main, protected] pull_request: + branches: [main] schedule: - cron: '0 15 * * 0' ``` -Este fluxo de trabalho faz a varredura: -* Cada push para o branch-padrão e o branch protegido -* Cada pull request para o branch-padrão -* O branch-padrão às 15h. todo domingo +This workflow scans: +* Every push to the default branch and the protected branch +* Every pull request to the default branch +* The default branch at 3 P.M. every Sunday + +### Specifying an operating system -### Especificar um sistema operacional +If your code requires a specific operating system to compile, you can configure the operating system in your {% data variables.product.prodname_codeql_workflow %}. Edit the value of `jobs.analyze.runs-on` to specify the operating system for the machine that runs your {% data variables.product.prodname_code_scanning %} actions. {% if currentVersion ver_gt "enterprise-server@2.21" %}You specify the operating system by using an appropriate label as the second element in a two-element array, after `self-hosted`.{% else %} -Se seu código exigir um sistema operacional específico para compilar, você poderá configurar o sistema operacional em seu {% data variables.product.prodname_codeql_workflow %}. Edite o valor de `jobs..runs-on` para especificar o sistema operacional para a máquina que executa suas ações em {% data variables.product.prodname_code_scanning %}. {% if currentVersion ver_gt "enterprise-server@2.21" %}Você especifica o sistema operacional usando uma etiqueta apropriada como segundo elemento em um array de dois elementos, depois de `auto-hospedado`. +If you choose to use a self-hosted runner for code scanning, you can specify an operating system by using an appropriate label as the second element in a two-element array, after `self-hosted`.{% endif %} ``` yaml jobs: @@ -88,59 +93,122 @@ jobs: name: Analyze runs-on: [self-hosted, ubuntu-latest] ``` -{% endif %} -O {% data variables.product.prodname_code_scanning_capc %} é compatível com as versões mais recentes do macOS, Ubuntu, e Windows. Portanto, os valores típicos para essa configuração são `ubuntu-latest`, `windows-latest` e `macos-latest`. Para obter mais informações, consulte "[Sintaxe do fluxo de trabalho para o GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on)". +{% if currentVersion == "free-pro-team@latest" %}For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners)" and "[Adding self-hosted runners](/actions/hosting-your-own-runners/adding-self-hosted-runners)."{% endif %} + +{% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} supports the latest versions of Ubuntu, Windows, and macOS. Typical values for this setting are therefore: `ubuntu-latest`, `windows-latest`, and `macos-latest`. For more information, see {% if currentVersion ver_gt "enterprise-server@2.21" %}"[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#self-hosted-runners)" and "[Using labels with self-hosted runners](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners){% else %}"[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on){% endif %}." -### Sobrescrever a detecção automática de linguagem +{% if currentVersion ver_gt "enterprise-server@2.21" %}You must ensure that Git is in the PATH variable on your self-hosted runners.{% else %}If you use a self-hosted runner, you must ensure that Git is in the PATH variable.{% endif %} -{% data reusables.code-scanning.autobuild-add-build-steps %} For more information about how to configure {% data variables.product.prodname_code_scanning %} for compiled languages, see "[Configuring {% data variables.product.prodname_code_scanning %} for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages)." +### Changing the languages that are analyzed + +{% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} automatically detects code written in the supported languages. {% data reusables.code-scanning.supported-languages %} +The default {% data variables.product.prodname_codeql_workflow %} file contains a build matrix called `language` which lists the languages in your repository that are analyzed. {% data variables.product.prodname_codeql %} automatically populates this matrix when you add {% data variables.product.prodname_code_scanning %} to a repository. Using the `language` matrix optimizes {% data variables.product.prodname_codeql %} to run each analysis in parallel. We recommend that all workflows adopt this configuration due to the performance benefits of parallelizing builds. For more information about build matrices, see "[Managing complex workflows](/actions/learn-github-actions/managing-complex-workflows#using-a-build-matrix)." + {% data reusables.code-scanning.specify-language-to-analyze %} -Para substituir a detecção automática de linguagem, adicione `with:languages:` à ação `init` no seu fluxo de trabalho. As palavras-chave para as linguagens compatíveis são `cpp`, `csharp`, `go`, `java`, `javascript` e `python`. +If your workflow uses the `language` matrix then {% data variables.product.prodname_codeql %} is hardcoded to analyze only the languages in the matrix. To change the languages you want to analyze, edit the value of the matrix variable. You can remove a language to prevent it being analyzed or you can add a language that was not present in the repository when {% data variables.product.prodname_code_scanning %} was enabled. For example, if the repository initially only contained JavaScript when {% data variables.product.prodname_code_scanning %} was enabled, and you later added Python code, you will need to add `python` to the matrix. -Por exemplo, a configuração a seguir limita {% data variables.product.prodname_code_scanning %} para C/C++, C#, e Python. +```yaml +jobs: + analyze: + name: Analyze + ... + strategy: + fail-fast: false + matrix: + language: ['javascript', 'python'] +``` + +If your workflow does not contain a matrix called `language`, then {% data variables.product.prodname_codeql %} is configured to run analysis sequentially. If you don't specify languages in the workflow, {% data variables.product.prodname_codeql %} automatically detects, and attempts to analyze, any supported languages in the repository. If you want to choose which languages to analyze, without using a matrix, you can use the `languages` parameter under the `init` action. -``` yaml +```yaml - uses: github/codeql-action/init@v1 with: languages: cpp, csharp, python -``` +``` +{% if currentVersion == "free-pro-team@latest" %} +### Analyzing Python dependencies -### Executar consultas adicionais +For GitHub-hosted runners that use Linux only, the {% data variables.product.prodname_codeql_workflow %} will try to auto-install Python dependencies to give more results for the CodeQL analysis. You can control this behavior by specifying the `setup-python-dependencies` parameter for the action called by the "Initialize CodeQL" step. By default, this parameter is set to `true`: + +- If the repository contains code written in Python, the "Initialize CodeQL" step installs the necessary dependencies on the GitHub-hosted runner. If the auto-install succeeds, the action also sets the environment variable `CODEQL_PYTHON` to the Python executable file that includes the dependencies. + +- If the repository doesn't have any Python dependencies, or the dependencies are specified in an unexpected way, you'll get a warning and the action will continue with the remaining jobs. The action can run successfully even when there are problems interpreting dependencies, but the results may be incomplete. + +Alternatively, you can install Python dependencies manually on any operating system. You will need to add `setup-python-dependencies` and set it to `false`, as well as set `CODEQL_PYTHON` to the Python executable that includes the dependencies, as shown in this workflow extract: + +```yaml +jobs: + CodeQL-Build: + + runs-on: ubuntu-latest + + steps: + - name: Checkout repository + uses: actions/checkout@v2 + with: + fetch-depth: 2 + - name: Set up Python + uses: actions/setup-python@v2 + with: + python-version: '3.x' + - name: Install dependencies + run: | + python -m pip install --upgrade pip + if [ -f requirements.txt ]; + then pip install -r requirements.txt; + fi + # Set the `CODEQL-PYTHON` environment variable to the Python executable + # that includes the dependencies + echo "::set-env name=CODEQL_PYTHON::$(which python)" + - run: git checkout HEAD^2 + if: ${{ github.event_name == 'pull_request' }} + - name: Initialize CodeQL + uses: github/codeql-action/init@v1 + with: + languages: python + # Override the default behavior so that the action doesn't attempt + # to auto-install Python dependencies + setup-python-dependencies: false +``` +{% endif %} + +### Running additional queries {% data reusables.code-scanning.run-additional-queries %} -Para adicionar uma ou mais consultas, adicione uma entrada `with: queries:` na seção `uses: github/codeql-action/init@v1` do fluxo de trabalho. +To add one or more queries, add a `with: queries:` entry within the `uses: github/codeql-action/init@v1` section of the workflow. ``` yaml - uses: github/codeql-action/init@v1 with: - - queries: COMMA-SEPARATED LIST OF PATHS + queries: COMMA-SEPARATED LIST OF PATHS ``` -Você também pode executar suítes de consultas adicionais especificando-os em um arquivo de configuração. Os suítes de consulta são coleções de consultas, geralmente agrupados por finalidade ou linguagem. +You can also specify query suites in the value of `queries`. Query suites are collections of queries, usually grouped by purpose or language. {% data reusables.code-scanning.codeql-query-suites %} -Você pode executar consultas adicionais especificando-as em um arquivo de configuração. Se você desejar executar o conjunto combinado de consultas adicionais especificadas aqui e no arquivo de configuração, determine previamente o valor de `consultas` no fluxo de trabalho com o símbolo `+`. Para obter exemplos de arquivos de configuração, consulte "[Exemplo de arquivos de configuração](#example-configuration-files)". +If you are also using a configuration file for custom settings, any additional queries specified in your workflow are used instead of any specified in the configuration file. If you want to run the combined set of additional queries specified here and in the configuration file, prefix the value of `queries` in the workflow with the `+` symbol. For more information, see "[Using a custom configuration file](#using-a-custom-configuration-file)." -Para incluir um ou mais suites de consulta, adicione uma seção `consultas` ao seu arquivo de configuração. +In the following example, the `+` symbol ensures that the specified additional queries are used together with any queries specified in the referenced configuration file. ``` yaml -queries: - - name: DESCRIPTION OF YOUR CHOICE - uses: PATH +- uses: github/codeql-action/init@v1 + with: + config-file: ./.github/codeql/codeql-config.yml + queries: +security-and-quality,octo-org/python-qlpack/show_ifs.ql@main ``` -### Usar uma ferramenta de varredura de código de terceiros +### Using a custom configuration file -Como alternativa à especificação de quais consultas executar no arquivo de fluxo de trabalho, você poderá fazer isso em um arquivo de configuração separado. Você também pode usar um arquivo de configuração para desativar as consultas-padrão e especificar quais diretórios escanear durante a análise. +As an alternative to specifying which queries to run in the workflow file, you can do this in a separate configuration file. You can also use a configuration file to disable the default queries and to specify which directories to scan during analysis. -No arquivo de workflow use o parâmetro `config-file` da ação `init` para especificar o caminho para o arquivo de configuração que você deseja usar. Este exemplo carrega o arquivo de configuração _./.github/codeql/codeql-config.yml_. +In the workflow file, use the `config-file` parameter of the `init` action to specify the path to the configuration file you want to use. This example loads the configuration file _./.github/codeql/codeql-config.yml_. ``` yaml - uses: github/codeql-action/init@v1 @@ -148,11 +216,11 @@ No arquivo de workflow use o parâmetro `config-file` da ação `init` para espe config-file: ./.github/codeql/codeql-config.yml ``` -O arquivo de configuração pode ser localizado no repositório local ou em um repositório remoto público. Para repositórios remotos, você pode usar a sintaxe _owner/repository/file.yml@branch_. As configurações no arquivo são escritas no formato YAML. - -#### Especificar consultas adicionais +The configuration file can be located within the local repository, or in a public, remote repository. For remote repositories, you can use the _owner/repository/file.yml@branch_ syntax. The settings in the file are written in YAML format. + +#### Specifying additional queries -Você especifica consultas adicionais em um array de `consultas`. Cada elemento do array contém um parâmetro de `uso` com um valor que identifica um único arquivo de consulta, um diretório que contém arquivos de consulta ou um arquivo de definição do conjunto de consulta. +You specify additional queries in a `queries` array. Each element of the array contains a `uses` parameter with a value that identifies a single query file, a directory containing query files, or a query suite definition file. ``` yaml queries: @@ -161,17 +229,17 @@ queries: - uses: ./codeql-qlpacks/complex-python-qlpack/rootAndBar.qls ``` -Opcionalmente, você pode dar um nome a cada elemento do array, conforme mostrado nos exemplos de arquivos de configuração abaixo. +Optionally, you can give each array element a name, as shown in the example configuration files below. -Para obter mais informações sobre consultas adicionais, consulte "[Executar consultas adicionais](#running-additional-queries) acima. +For more information about additional queries, see "[Running additional queries](#running-additional-queries)" above. -#### Desativar as consultas-padrão +#### Disabling the default queries -Se você desejar apenas executar consultas personalizadas, você poderá desabilitar as consultas de segurança padrão adicionando `disable-default-queries: true` ao seu arquivo de configuração. +If you only want to run custom queries, you can disable the default security queries by using `disable-default-queries: true`. -#### Especificar diretórios para serem varridos +#### Specifying directories to scan -Para as linguagens interpretadas com as quais {% data variables.product.prodname_codeql %} é compatível (Python e JavaScript/TypeScript), você pode restringir {% data variables.product.prodname_code_scanning %} para arquivos em diretórios específicos adicionando um array de `caminhos` para o arquivo de configuração. Você pode excluir os arquivos em diretórios específicos das varreduras, adicionando um array de `paths-ignore`. +For the interpreted languages that {% data variables.product.prodname_codeql %} supports (Python and JavaScript/TypeScript), you can restrict {% data variables.product.prodname_code_scanning %} to files in specific directories by adding a `paths` array to the configuration file. You can exclude the files in specific directories from scans by adding a `paths-ignore` array. ``` yaml paths: @@ -183,37 +251,37 @@ paths-ignore: {% note %} -**Observação**: +**Note**: -* As palavras-chave `caminhos` e `paths-ignore`, usados no contexto do arquivo de configuração do {% data variables.product.prodname_code_scanning %}, não deve ser confundido com as mesmas palavras-chave usadas para `on..paths` em um fluxo de trabalho. Quando estão acostumados a modificar `on.` em um fluxo de trabalho, eles determinam se as ações serão executadas quando alguém modifica o código nos diretórios especificados. Para obter mais informações, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)". -* `**` **Note**: `**` characters can only be at the start or end of a line, or surrounded by slashes, and you can't mix `**` and other characters. Por exemplo, `foo/**`, `**/foo` e `foo/**/bar` são todos de sintaxe permitida, mas `**foo` não é. No entanto, você pode usar estrelas únicas junto com outros caracteres, conforme mostrado no exemplo. Você precisará colocar entre aspas qualquer coisa que contenha um caractere `*`. +* The `paths` and `paths-ignore` keywords, used in the context of the {% data variables.product.prodname_code_scanning %} configuration file, should not be confused with the same keywords when used for `on..paths` in a workflow. When they are used to modify `on.` in a workflow, they determine whether the actions will be run when someone modifies code in the specified directories. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)." +* `**` characters can only be at the start or end of a line, or surrounded by slashes, and you can't mix `**` and other characters. For example, `foo/**`, `**/foo`, and `foo/**/bar` are all allowed syntax, but `**foo` isn't. However you can use single stars along with other characters, as shown in the example. You'll need to quote anything that contains a `*` character. {% endnote %} -Para C/C++, C#, e Java, se você desejar limitar {% data variables.product.prodname_code_scanning %} a diretórios específicos no seu projeto, você deverá especificar etapas de criação apropriadas no fluxo de trabalho. Os comandos que você precisa usar para excluir um diretório da criação dependerão do seu sistema de criação. Para obter mais informações, consulte "[Configurar a ação de {% data variables.product.prodname_codeql %} para linguagens compiladas](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages#adding-build-steps-for-a-compiled-language)". +For C/C++, C#, and Java, if you want to limit {% data variables.product.prodname_code_scanning %} to specific directories in your project, you must specify appropriate build steps in the workflow. The commands you need to use to exclude a directory from the build will depend on your build system. For more information, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." -Você pode rapidamente analisar pequenas partes de um monorepo ao modificar o código em diretórios específicos. Você deverá excluir diretórios nas suas etapas de criação e usar as palavras-chave `paths-ignore` e `caminhos` para [`on.`](https://help.github.com/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths) no seu arquivo de fluxo de trabalho. +You can quickly analyze small portions of a monorepo when you modify code in specific directories. You'll need to both exclude directories in your build steps and use the `paths-ignore` and `paths` keywords for [`on.`](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths) in your workflow. -#### Exemplo de arquivo de configuração +#### Example configuration files {% data reusables.code-scanning.example-configuration-files %} -### Configurar o {% data variables.product.prodname_code_scanning %} para linguagens compiladas +### Configuring {% data variables.product.prodname_code_scanning %} for compiled languages -{% data reusables.code-scanning.autobuild-compiled-languages %} +{% data reusables.code-scanning.autobuild-compiled-languages %} {% data reusables.code-scanning.analyze-go %} -{% data reusables.code-scanning.autobuild-add-build-steps %} Para obter mais informações sobre como configurar {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} para linguagens compiladas, consulte "[Configurar a ação do {% data variables.product.prodname_codeql %} para linguagens compiladas](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages)". +{% data reusables.code-scanning.autobuild-add-build-steps %} For more information about how to configure {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} for compiled languages, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages)." -### Acessar repositórios privados +### Accessing private repositories -Se o seu fluxo de trabalho para {% data variables.product.prodname_code_scanning %} acessar repositórios privados no {% data variables.product.prodname_dotcom %}, você deverá configurar o Git para efetuar a autenticação com um token de acesso pessoal. Defina o segredo no ambiente do executor usando `jobs..steps.env` no seu fluxo de trabalho antes de qualquer ação do {% data variables.product.prodname_codeql %}. Para mais informações consulte "[Criar um token de acesso pessoal para a linha de comando](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)" e "[Criar e armazenar segredos criptografados](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)". +If your workflow for {% data variables.product.prodname_code_scanning %} accesses a private repository, other than the repository that contains the workflow, you'll need to configure Git to authenticate with a personal access token. Define the secret in the runner environment by using `jobs..steps.env` in your workflow before any {% data variables.product.prodname_codeql %} actions. For more information, see "[Creating a personal access token for the command line](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)" and "[Creating and storing encrypted secrets](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)." -Por exemplo, a configuração a seguir faz com que o Git substitua todas as URLs para os repositórios `github/foo`, `github/bar` e `github/baz` em {% data variables.product.prodname_dotcom_the_website %} por URLs que incluem o token de acesso pessoal que você armazena na variável de ambiente `ACCESS_TOKEN`. +For example, the following configuration has Git replace the full URLs to the `github/foo`, `github/bar`, and `github/baz` repositories on {% data variables.product.prodname_dotcom_the_website %} with URLs that include the personal access token that you store in the `ACCESS_TOKEN` environment variable. {% raw %} ```yaml steps: -- name: Configure access to private repository on GitHub.com +- name: Configure access to private repositories env: TOKEN: ${{ secrets.ACCESS_TOKEN }} run: | @@ -223,6 +291,6 @@ steps: ``` {% endraw %} -### {% data variables.product.prodname_code_scanning_capc %} usa {% data variables.product.prodname_actions %}. +### Uploading {% data variables.product.prodname_code_scanning %} data to {% data variables.product.prodname_dotcom %} -Você pode exibir análise de código de uma ferramenta de terceiros em {% data variables.product.prodname_dotcom %}, adicionando a ação de `upload-sarif` ao seu fluxo de trabalho. Você pode fazer o upload de dados de análise de código com a ação `upload-sarif`. Para obter mais informações, consulte "[Fazer o upload de um arquivo SARIF para o GitHub](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)". +{% data variables.product.prodname_dotcom %} can display code analysis data generated externally by a third-party tool. You can upload code analysis data with the `upload-sarif` action. For more information, see "[Uploading a SARIF file to GitHub](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)." diff --git a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md new file mode 100644 index 000000000000..907b1cd3d961 --- /dev/null +++ b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md @@ -0,0 +1,165 @@ +--- +title: Configurar a varredura de código do CodeQL no seu sistema de de CI +shortTitle: Configurar na sua CI +intro: 'Você pode configurar como o {% data variables.product.prodname_codeql_runner %} faz a varredura do código no seu projeto e faz o upload dos resultados para o {% data variables.product.prodname_dotcom %}.' +product: '{% data reusables.gated-features.code-scanning %}' +miniTocMaxHeadingLevel: 4 +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-in-your-ci-system +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta-codeql-runner %} +{% data reusables.code-scanning.beta %} +{% data reusables.code-scanning.enterprise-enable-code-scanning %} + +### Sobre a configuração de {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} no seu sistema de CI + +Para integrar {% data variables.product.prodname_code_scanning %} ao seu sistema de CI, você pode usar o {% data variables.product.prodname_codeql_runner %}. Para obter mais informações, consulte "[Executar {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} no seu sistema de CI](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)". + +De modo geral, você invoca o {% data variables.product.prodname_codeql_runner %} da seguinte forma. + +``` +$ /path/to-runner/codeql-runner-OS +``` + +`/path/to-runner/` depende do local onde você fez o download do {% data variables.product.prodname_codeql_runner %} no seu sistema de CI. `codeql-runner-OS` depende do sistema operacional que você usa. Existem três versões do {% data variables.product.prodname_codeql_runner %}, `codeql-runner-linux`, `codeql-runner-macos` e `codeql-runner-win`, para os sistemas Linux, macOS e Windows, respectivamente. + +Para personalizar a maneira como o {% data variables.product.prodname_codeql_runner %} faz a varredura do seu código, você pode usar sinalizadores, como `--languages` e `--queries`, ou você pode especificar configurações personalizadas em um arquivo de configuração separado. + +### Sobrescrever a detecção automática de linguagem + +O {% data variables.product.prodname_codeql_runner %} detecta e faz a varredura automática do código escrito nas linguagens compatíveis. + +{% data reusables.code-scanning.supported-languages %} + +{% data reusables.code-scanning.specify-language-to-analyze %} + +Para substituir a detecção automática de idioma, execute o comando `init` com o sinalizador `--languages`, seguido de uma lista de palavras-chave de linguagem separada por vírgulas. As palavras-chave para as linguagens compatíveis são `cpp`, `csharp`, `go`, `java`, `javascript` e `python`. + +``` +$ /path/to-runner/codeql-runner-linux init --languages cpp,java +``` + +### Executar consultas adicionais + +{% data reusables.code-scanning.run-additional-queries %} + +{% data reusables.code-scanning.codeql-query-suites %} + +Para adicionar uma ou mais consultas, passe uma lista de caminhos separados por vírgulas para o sinalizador `--queries` do comando `init`. Você também pode especificar consultas adicionais em um arquivo de configuração. + +Se você também estiver usando um arquivo de configuração para configurações personalizadas, e você também estiver especificando consultas adicionais com o sinalizador `--queries`, o {% data variables.product.prodname_codeql_runner %} usará as consultas adicionais especificadas com o sinalizador `--queries` em vez de qualquer um no arquivo de configuração. Se você desejar executar o conjunto combinado de consultas adicionais especificadas com o sinalizador e no arquivo de configuração, determine previamente o valor passado para `--queries` com o símbolo `+`. Para obter exemplos de arquivos de configuração, consulte "[Exemplo de arquivos de configuração](#example-configuration-files)". + +No exemplo a seguir,. o símbolo `+` garante que o {% data variables.product.prodname_codeql_runner %} usará as consultas adicionais junto com quaisquer consultas especificadas no arquivo de configuração referenciado. + +``` +$ /path/to-runner/codeql-runner-linux init --config-file .github/codeql/codeql-config.yml + --queries +security-and-quality,octo-org/python-qlpack/show_ifs.ql@main +``` + +### Usar uma ferramenta de varredura de código de terceiros + +Em vez de passar informações adicionais para os comandos de {% data variables.product.prodname_codeql_runner %}, você pode especificar configurações personalizadas em um arquivo de configuração separado. + +O arquivo de configuração é um arquivo YAML. Ele usa uma sintaxe semelhante à sintaxe do fluxo de trabalho do {% data variables.product.prodname_actions %}, conforme ilustrado nos exemplos abaixo. Para obter mais informações, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions)". + +Use o sinalizador `--config-file` do comando `init` para especificar o arquivo de configuração. O valor de `--config-file` é o caminho para o arquivo de configuração que você deseja usar. Este exemplo carrega o arquivo de configuração _.github/codeql/codeql-config.yml_. + +``` +$ /path/to-runner/codeql-runner-linux init --config-file .github/codeql/codeql-config.yml +``` + +#### Exemplo de arquivo de configuração + +{% data reusables.code-scanning.example-configuration-files %} + +### Configurar o {% data variables.product.prodname_code_scanning %} para linguagens compiladas + +Para as linguagens compiladas C/C++, C#, e Java, o {% data variables.product.prodname_codeql %} constrói o código antes de analisá-lo. {% data reusables.code-scanning.analyze-go %} + +Para muitos sistemas de criação comuns, o {% data variables.product.prodname_codeql_runner %} pode construir o código automaticamente. Para tentar construir o código automaticamente, execute `autobuild` entre `init` e `analise` as etapas. Observe que, se seu repositório precisar de uma versão específica de uma ferramenta de criação, primeiro você precisará instalar a ferramenta de criação manualmente. + +O processo `autobuild` sempre tenta criar _uma_ linguagem compilada para um repositório. A linguagem selecionada automaticamente para análise é a linguagem com mais arquivos. Se você quiser escolher um idioma explicitamente, use o sinalizador `--language` do comando `autobuild`. + +``` +$ /path/to-runner/codeql-runner-linux autobuild --language csharp +``` + +Se o comando `autobuild` não puder criar o seu código, você poderá executar as etapas de compilação, entre as etapas de `init` e de `análise`. Para obter mais informações, consulte "[Executar {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} no seu sistema de CI](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system#compiled-language-example)". + +### {% data variables.product.prodname_code_scanning_capc %} usa {% data variables.product.prodname_actions %}. + +Por padrão, o {% data variables.product.prodname_codeql_runner %} faz o upload dos resultados a partir de {% data variables.product.prodname_code_scanning %} quando você executa o comando de `análise`. Você também pode carregar arquivos do SARIF separadamente, usando o comando `upload`. + +Depois de enviar os dados, o {% data variables.product.prodname_dotcom %} exibirá os alertas no seu repositório. Para obter mais informações, consulte "[Gerenciar alertas de {% data variables.product.prodname_code_scanning %} para o seu repositório](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository#viewing-an-alert)". + +### Comando de referência de {% data variables.product.prodname_codeql_runner %} + +O {% data variables.product.prodname_codeql_runner %} é compatível os seguintes comandos e sinalizadores. + +#### `init` + +Inicializa o {% data variables.product.prodname_codeql_runner %} e cria um banco de dados de {% data variables.product.prodname_codeql %} para cada linguagem a ser analisada. + +| Sinalizador | Obrigatório | Valor de entrada | +| -------------------------------- |:-----------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `--repository` | ✓ | Nome do repositório a ser inicializado. | +| `--github-url` | ✓ | URL da instância do {% data variables.product.prodname_dotcom %} onde seu repositório está hospedado. | +| `--github-auth` | ✓ | Um token de {% data variables.product.prodname_github_apps %} ou token de acesso pessoal. | +| `--languages` | | Lista de linguagens para análise separada por vírgulas. Por padrão, o {% data variables.product.prodname_codeql_runner %} detecta e analisa todas as linguagens compatíveis no repositório. | +| `--queries` | | Lista separada por vírgulas de consultas adicionais a serem executadas, além do conjunto-padrão de consultas de segurança. | +| `--config-file` | | Caminho para o arquivo de configuração personalizado. | +| `--codeql-path` | | Caminho para uma cópia do CLI de {% data variables.product.prodname_codeql %} executável a ser usado. Por padrão, o {% data variables.product.prodname_codeql_runner %} faz o download de uma cópia. | +| `--temp-dir` | | Diretório onde os arquivos temporários são armazenados. O padrão é _./codeql-runner_. | +| `--tools-dir` | | Diretório onde as ferramentas de {% data variables.product.prodname_codeql %} e outros arquivos são armazenados entre as execuções. O padrão é um subdiretório do diretório home. | +| `--checkout-path` | | O caminho para o checkout do seu repositório. O padrão é o diretório de trabalho atual. | +| `--debug` | | Nenhum. Imprime mais resultados verbose. | +| `-h`, `--help` | | Nenhum. Exibe ajuda para o comando. | + +#### `autobuild` + +Tenta construir o código para as linguagens compiladas C/C++, C# e Java. Para essas linguagens, {% data variables.product.prodname_codeql %} cria o código antes de analisá-lo. Executar `autobuild` entre as etapas de `init` e `analise`. + +| Sinalizador | Obrigatório | Valor de entrada | +| --------------------------- |:-----------:| ------------------------------------------------------------------------------------------------------------------------------------------- | +| `--language` | | A linguagem a ser criada. Por padrão, o {% data variables.product.prodname_codeql_runner %} cria a linguagem compilada com mais arquivos. | +| `--temp-dir` | | Diretório onde os arquivos temporários são armazenados. O padrão é _./codeql-runner_. | +| `--debug` | | Nenhum. Imprime mais resultados verbose. | +| `-h`, `--help` | | Nenhum. Exibe ajuda para o comando. | + +#### `analyze` + +Analisa o código nos bancos de dados do {% data variables.product.prodname_codeql %} e faz o upload dos resultados para o {% data variables.product.product_location %}. + +| Sinalizador | Obrigatório | Valor de entrada | +| -------------------------------- |:-----------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `--repository` | ✓ | Nome do repositório a ser analisado. | +| `--commit` | ✓ | SHA do commit a ser analisado. No Git e no Azure DevOps, isso corresponde ao valor de `git rev-parse HEAD`. No Jenkins, isso corresponde a `$GIT_COMMIT`. | +| `--ref` | ✓ | Nome da referência para análise, por exemplo `refs/heads/main`. No Git e no Jenkins, isso corresponde ao valor de `git simbolic-ref HEAD`. No Azure DevOps, isso corresponde a `$(Build.SourceBranch)`. | +| `--github-url` | ✓ | URL da instância do {% data variables.product.prodname_dotcom %} onde seu repositório está hospedado. | +| `--github-auth` | ✓ | Um token de {% data variables.product.prodname_github_apps %} ou token de acesso pessoal. | +| `--checkout-path` | | O caminho para o checkout do seu repositório. O padrão é o diretório de trabalho atual. | +| `--no-upload` | | Nenhum. Impede que o {% data variables.product.prodname_codeql_runner %} faça o upload dos resultados para {% data variables.product.product_location %}. | +| `--output-dir` | | Diretório onde os arquivos SARIF de saída são armazenados. O padrão está no diretório de arquivos temporários. | +| `--temp-dir` | | Diretório onde os arquivos temporários são armazenados. O padrão é _./codeql-runner_. | +| `--debug` | | Nenhum. Imprime mais resultados verbose. | +| `-h`, `--help` | | Nenhum. Exibe ajuda para o comando. | + +#### `fazer upload` + +Faz o upload dos arquivos SARIF para {% data variables.product.product_location %}. + +| Sinalizador | Obrigatório | Valor de entrada | +| -------------------------------- |:-----------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `--sarif-file` | ✓ | O arquivo SARIF a ser subido ou um diretório que contém vários arquivos SARIF. | +| `--repository` | ✓ | Nome do repositório que foi analisado. | +| `--commit` | ✓ | SHA do commit que foi analisado. No Git e no Azure DevOps, isso corresponde ao valor de `git rev-parse HEAD`. No Jenkins, isso corresponde a `$GIT_COMMIT`. | +| `--ref` | ✓ | Nome da referência que foi analisada, por exemplo `refs/heads/main`. No Git e no Jenkins, isso corresponde ao valor de `git simbolic-ref HEAD`. No Azure DevOps, isso corresponde a `$(Build.SourceBranch)`. | +| `--github-url` | ✓ | URL da instância do {% data variables.product.prodname_dotcom %} onde seu repositório está hospedado. | +| `--github-auth` | ✓ | Um token de {% data variables.product.prodname_github_apps %} ou token de acesso pessoal. | +| `--checkout-path` | | O caminho para o checkout do seu repositório. O padrão é o diretório de trabalho atual. | +| `--debug` | | Nenhum. Imprime mais resultados verbose. | +| `-h`, `--help` | | Nenhum. Exibe ajuda para o comando. | diff --git a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md new file mode 100644 index 000000000000..e3d7464b327a --- /dev/null +++ b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md @@ -0,0 +1,116 @@ +--- +title: Configurar o fluxo de trabalho do CodeQL para linguagens compiladas +shortTitle: Configurar para linguagens compiladas +intro: 'Você pode configurar como o {% data variables.product.prodname_dotcom %} usa o {% data variables.product.prodname_codeql_workflow %} para varrer o código escrito em linguagens compiladas para obter vulnerabilidades e erros.' +product: '{% data reusables.gated-features.code-scanning %}' +permissions: 'Pessoas com permissões de gravação para um repositório podem configurar {% data variables.product.prodname_code_scanning %} para o repositório.' +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages + - /github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta %} +{% data reusables.code-scanning.enterprise-enable-code-scanning-actions %} + +### Sobre o {% data variables.product.prodname_codeql_workflow %} e linguagens compiladas + +Para habilitar o {% data variables.product.prodname_code_scanning %} para seu repositório, você deve adicionar ao repositório um fluxo de trabalho do {% data variables.product.prodname_actions %} que inclui análise do {% data variables.product.prodname_codeql %}. Para {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %}, você adiciona o {% data variables.product.prodname_codeql_workflow %}. Para obter mais informações, consulte "[Habilitando {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning). + +{% data reusables.code-scanning.edit-workflow %} +Para informações gerais sobre configuração +{% data variables.product.prodname_code_scanning %} e editar arquivos do fluxo de trabalho, consulte "[Configurar {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" e "[Aprender {% data variables.product.prodname_actions %}](/actions/learn-github-actions)". + +### Sobre a autobuild para {% data variables.product.prodname_codeql %} + +A varredura de código funciona executando consultas contra um ou mais bancos de dados. Cada banco de dados contém uma representação de todo o código em uma linguagem única no seu repositório. Para as linguagens compiladas de C/C++, C#, e Java, o processo de preenchimento deste banco de dados envolve a construção do código e extração de dados. {% data reusables.code-scanning.analyze-go %} + +{% data reusables.code-scanning.autobuild-compiled-languages %} + +Se o fluxo de trabalho usar uma matriz de `linguagem`, `autobuild` tentará criar cada uma das linguagens compiladas listadas na matriz. Sem uma matriz, `autobuild` tenta criar a linguagem compilada compatível que tem mais arquivos de origem no repositório. Com exceção de Go, a análise de outras linguagens compatíveis no repositório irá falhar, a menos que você forneça comandos de criação explícitos. + +{% note %} + +**Observação**: Se você usa executores auto-hospedados para {% data variables.product.prodname_actions %}, talvez seja necessário instalar um software adicional para usar o processo de `autobuild`. Além disso, se seu repositório precisar de uma versão específica de uma ferramenta de criação, talvez seja necessário instalá-lo manualmente. Para obter mais informações, consulte "[Especificações para executores hospedados no {% data variables.product.prodname_dotcom %}](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". + +{% endnote %} + +#### C/C++ + +| Tipo de sistema compatível | Nome do sistema | +| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | +| Sistema operacional | Windows, macOS e Linux | +| Sistema de criação | Windows: MSbuild e scripts de criação
    Linux e macOS: Autoconf, Make, CMake, qmake, Meson, Waf, SCons, Linux Kbuild e scripts | + +O comportamento da etapa de     autobuild` varia de acordo com o sistema operacional em que a extração é executada. No Windows, o autobuild` tenta detectar automaticamente um método de criação adequado para C/C++ usando a seguinte abordagem: + +1. Invocar `MSBuild.exe` sobre a solução (`.sln`) ou arquivo (`.vcxproj`) de projeto mais próximo da raiz. Se o `autobuild` detectar várias soluções ou arquivos de projeto na mesma profundidade (mais curta) do diretório de nível superior, ele tentará criar todos eles. +2. Invoca um script que se parece com um script de criação-_build.bat_, _build.cmd_, _e build.exe_ (nessa ordem). + +No Linux e no macOS, a etapa de `autobuild` revisa os arquivos presentes no repositório para determinar o sistema de criação usado: + +1. Procure um sistema de criação no diretório-raiz. +2. Se nenhum for encontrado, procure um diretório único nos subdiretórios com um sistema de criação para C/C++. +3. Execute um comando apropriado para configurar o sistema. + +#### C + +| Tipo de sistema compatível | Nome do sistema | +| -------------------------- | ---------------------------------- | +| Sistema operacional | Windows e Linux | +| Sistema de criação | .NET, MSbuild e scripts de criação | + +O processo de `autobuild` tenta detectar automaticamente um método de criação adequado para C# usando a seguinte abordagem: + +1. Invocar o arquivo `dotnet build` na solução (`.sln`) ou projeto (`.csproj`) mais próximo da raiz. +2. Invocar `MSbuild` (Linux) ou `MSBuild.exe` (Windows) na solução ou no arquivo do projeto mais próximo da raiz. Se o `autobuild` detectar várias soluções ou arquivos de projeto na mesma profundidade (mais curta) do diretório de nível superior, ele tentará criar todos eles. +3. Invoca um script que parece um script de criação—_build_ e _build.sh_ (nessa ordem, para o Linux) ou _build.bat_, _build.cmd_, _e build.exe_ (nessa ordem para o Windows). + +#### Java + +| Tipo de sistema compatível | Nome do sistema | +| -------------------------- | -------------------------------------- | +| Sistema operacional | Windows, macOS e Linux (sem restrição) | +| Sistema de criação | Gradle, Maven e Ant | + +O processo de `autobuild` tenta determinar o sistema de criação para bases de código do Java aplicando esta estratégia: + +1. Procurar um arquivo de criação no diretório-raiz. Verifique o arquivos do Gradle, do Maven e, em seguida, do Ant. +2. Execute o primeiro arquivo de criação encontrado. Se os arquivos do Gradle e do Maven estiverem presentes, será usado o arquivo do Gradle. +3. Caso contrário, procure arquivos de criação nos subdiretórios diretos do diretório-raiz. Se apenas um subdiretório contiver arquivos de criação, execute o primeiro arquivo identificado nesse subdiretório (usando a mesma preferência de 1). Se mais de um subdiretório conter arquivos de criação, relate um erro. + +### Adicionar passos de criação a uma linguagem compilada + +{% data reusables.code-scanning.autobuild-add-build-steps %} Para obter informações sobre como editar o arquivo de fluxo de trabalho, consulte "[Configurar o {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)". + +Depois de remover a etapa de `autobuild`, remova o comentário da etapa `executar` e adicione comandos de criação adequados ao seu repositório. A etapa do fluxo de trabalho `executar` executa programas da linha de comando que usam o shell do sistema operacional. Você pode modificar esses comandos e adicionar mais comandos para personalizar o processo de criação. + +``` yaml +- run: | + make bootstrap + make release +``` + +Para obter mais informações sobre a palavra-chave `executar`, consulte "[Sintaxe de fluxo de trabalho para {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)". + +Se seu repositório contém várias linguagens compiladas, você pode especificar comandos de compilação específicos da linguagem. Por exemplo, se o seu repositório contém C/C++, C# e Java, e o `autobuild` cria C/C++ e C# corretamente mas falha ao criar Java, você poderia utilizar a configuração a seguir no seu fluxo de trabalho, após a etapa `init`. Isto especifica etapas de criação para Java ao mesmo tempo que usa `autobuild` para C/C++ e C#: + +```yaml +- if: matrix.language == 'cpp' || matrix.language == 'csharp' + name: Autobuild + uses: github/codeql-action/autobuild@v1 + +- if: matrix.language == 'java' + name: Build Java + run: | + make bootstrap + make release +``` + +Para obter mais informações sobre `se` condicional, consulte "[Sintaxe de fluxo de trabalho para o GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsif). + +Para obter mais dicas e truques sobre por que o`autobuild` não criará o seu código, consulte[Solução de problemas sobre o fluxo de trabalho do {% data variables.product.prodname_codeql %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow)". + +Se você adicionou etapas de criação manual para linguagens compiladas, mas o {% data variables.product.prodname_code_scanning %} ainda não está funcionando no seu repositório, entre em contato com {% data variables.contact.contact_support %}. diff --git a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md index 14a835f18f1a..f4cabb2462b7 100644 --- a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md +++ b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md @@ -27,23 +27,91 @@ You decide how you generate {% data variables.product.prodname_code_scanning %} {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-security %} -3. To the right of "Code scanning", click **Set up code scanning**. - !["Set up code scanning" button to the right of "Code scanning" in the Security Overview](/assets/images/help/security/overview-set-up-code-scanning.png) -4. Under "Get started with code scanning", click **Set up this workflow** on the {% data variables.product.prodname_codeql_workflow %} or on a third-party workflow. - !["Set up this workflow" button under "Get started with code scanning" heading](/assets/images/help/repository/code-scanning-set-up-this-workflow.png) -5. Optionally, to customize how {% data variables.product.prodname_code_scanning %} scans your code, edit the workflow. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." +3. To the right of "{% data variables.product.prodname_code_scanning_capc %}", click **Set up {% data variables.product.prodname_code_scanning %}**. + !["Set up {% data variables.product.prodname_code_scanning %}" button to the right of "{% data variables.product.prodname_code_scanning_capc %}" in the Security Overview](/assets/images/help/security/overview-set-up-code-scanning.png) +4. Under "Get started with {% data variables.product.prodname_code_scanning %}", click **Set up this workflow** on the {% data variables.product.prodname_codeql_workflow %} or on a third-party workflow. + !["Set up this workflow" button under "Get started with {% data variables.product.prodname_code_scanning %}" heading](/assets/images/help/repository/code-scanning-set-up-this-workflow.png) +5. To customize how {% data variables.product.prodname_code_scanning %} scans your code, edit the workflow. + + Generally you can commit the {% data variables.product.prodname_codeql_workflow %} without making any changes to it. However, many of the third-party workflows require additional configuration, so read the comments in the workflow before committing. + + For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." 6. Use the **Start commit** drop-down, and type a commit message. ![Start commit](/assets/images/help/repository/start-commit-commit-new-file.png) 7. Choose whether you'd like to commit directly to the default branch, or create a new branch and start a pull request. ![Choose where to commit](/assets/images/help/repository/start-commit-choose-where-to-commit.png) 8. Click **Commit new file** or **Propose new file**. -After you commit the workflow file or create a pull request, {% data variables.product.prodname_code_scanning %} will analyze your code according to the frequency you specified in your workflow file. If you created a pull request, {% data variables.product.prodname_code_scanning %} will only analyze the code on the pull request's topic branch until you merge the pull request into the default branch of the repository. +In the default {% data variables.product.prodname_codeql_workflow %}, {% data variables.product.prodname_code_scanning %} is configured to analyze your code each time you either push a change to the default branch or any protected branches, or raise a pull request against the default branch or any protected branches. As a result, {% data variables.product.prodname_code_scanning %} will now commence. + +### Viewing the logging output from {% data variables.product.prodname_code_scanning %} + +After enabling {% data variables.product.prodname_code_scanning %} for your repository, you can watch the output of the actions as they run. + +{% data reusables.repositories.actions-tab %} + + You'll see a list that includes an entry for running the {% data variables.product.prodname_code_scanning %} workflow. + + ![Actions list showing {% data variables.product.prodname_code_scanning %} workflow](/assets/images/help/repository/code-scanning-actions-list.png) + +1. Click the entry for the {% data variables.product.prodname_code_scanning %} workflow. + +1. Click the job name on the left. For example, **Analyze (LANGUAGE)**. + + ![Log output from the {% data variables.product.prodname_code_scanning %} workflow](/assets/images/help/repository/code-scanning-logging-analyze-action.png) + +1. Review the logging output from the actions in this workflow as they run. + +1. Once all jobs are complete, you can view the details of any {% data variables.product.prodname_code_scanning %} alerts that were identified. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository#viewing-an-alert)." + +{% note %} + +**Note:** If you raised a pull request to add the {% data variables.product.prodname_code_scanning %} workflow to the repository, alerts from that pull request aren't displayed directly on the {% data variables.product.prodname_code_scanning_capc %} page until the pull request is merged. If any alerts were found you can view these, before the pull request is merged, by clicking the **_n_ alerts found** link in the banner on the {% data variables.product.prodname_code_scanning_capc %} page. + + ![Click the "n alerts found" link](/assets/images/help/repository/code-scanning-alerts-found-link.png) + +{% endnote %} + +### Understanding the pull request checks + +Each {% data variables.product.prodname_code_scanning %} workflow you enable to run on pull requests always has at least two entries listed in the checks section of a pull request. There is one entry for each of the analysis jobs in the workflow, and a final one for the results of the analysis. + +The names of the {% data variables.product.prodname_code_scanning %} analysis checks take the form: "TOOL NAME / JOB NAME (TRIGGER)." For example, for {% data variables.product.prodname_codeql %}, analysis of C++ code has the entry "{% data variables.product.prodname_codeql %} / Analyze (cpp) (pull_request)." You can click **Details** on a {% data variables.product.prodname_code_scanning %} analysis entry to see logging data. This allows you to debug a problem if the analysis job failed. For example, for {% data variables.product.prodname_code_scanning %} analysis of compiled languages, this can happen if the action can't build the code. + + ![{% data variables.product.prodname_code_scanning %} pull request checks](/assets/images/help/repository/code-scanning-pr-checks.png) + +When the {% data variables.product.prodname_code_scanning %} jobs complete, {% data variables.product.prodname_dotcom %} works out whether any alerts were added by the pull request and adds the "{% data variables.product.prodname_code_scanning_capc %} results / TOOL NAME" entry to the list of checks. After {% data variables.product.prodname_code_scanning %} has been performed at least once, you can click **Details** to view the results of the analysis. If you used a pull request to add {% data variables.product.prodname_code_scanning %} to the repository, you will initially see a "Missing analysis" message when you click **Details** on the "{% data variables.product.prodname_code_scanning_capc %} results / TOOL NAME" check. + + ![Missing analysis for commit message](/assets/images/help/repository/code-scanning-missing-analysis.png) + +#### Reasons for the "missing analysis" message + +After {% data variables.product.prodname_code_scanning %} has analyzed the code in a pull request, it needs to compare the analysis of the topic branch (the branch you used to create the pull request) with the analysis of the base branch (the branch into which you want to merge the pull request). This allows {% data variables.product.prodname_code_scanning %} to compute which alerts are newly introduced by the pull request, which alerts were already present in the base branch, and whether any existing alerts are fixed by the changes in the pull request. Initially, if you use a pull request to add {% data variables.product.prodname_code_scanning %} to a repository, the base branch has not yet been analyzed, so it's not possible to compute these details. In this case, when you click through from the results check on the pull request you will see the "Missing analysis for base commit SHA-HASH" message. + +There are other situations where there may be no analysis for the latest commit to the base branch for a pull request. These include: + +* The pull request has been raised against a branch other than the default branch or a protected branch, and this branch hasn't been analyzed. + + To check whether a branch has been scanned, go to the {% data variables.product.prodname_code_scanning_capc %} page, click the **Branch** drop-down and select the relevant branch. + + ![Choose a branch from the Branch drop-down menu](/assets/images/help/repository/code-scanning-branch-dropdown.png) + + The solution in this situation is to add the name of the base branch to the `on:push` and `on:pull_request` specification in the {% data variables.product.prodname_code_scanning %} workflow on that branch and then make a change that updates the open pull request that you want to scan. + +* The latest commit on the base branch for the pull request is currently being analyzed and analysis is not yet available. + + Wait a few minutes and then push a change to the pull request to retrigger {% data variables.product.prodname_code_scanning %}. + +* An error occurred while analyzing the latest commit on the base branch and analysis for that commit isn't available. + + Merge a trivial change into the base branch to trigger {% data variables.product.prodname_code_scanning %} on this latest commit, then push a change to the pull request to retrigger {% data variables.product.prodname_code_scanning %}. ### Next steps -After you enable {% data variables.product.prodname_code_scanning %}, you can monitor analysis, view results, and further customize how you scan your code. +After enabling {% data variables.product.prodname_code_scanning %}, and allowing its actions to complete, you can: -- You can view the run status of {% data variables.product.prodname_code_scanning %} and get notifications for completed runs. For more information, see "[Managing a workflow run](/actions/configuring-and-managing-workflows/managing-a-workflow-run)" and "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)." -- After a scan completes, you can view alerts from a completed scan. For more information, see "[Managing alerts from {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." -- You can customize how {% data variables.product.prodname_code_scanning %} scans the code in your repository. For more information, see "[Configuring code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." +- View all of the {% data variables.product.prodname_code_scanning %} alerts generated for this repository. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." +- View any alerts generated for a pull request submitted after you enabled {% data variables.product.prodname_code_scanning %}. For more information, see "[Triaging {% data variables.product.prodname_code_scanning %} alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests)." +- Set up notifications for completed runs. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)." +- Investigate any problems that occur with the initial setup of {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %}. For more information, see "[Troubleshooting the {% data variables.product.prodname_codeql %} workflow](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow)." +- Customize how {% data variables.product.prodname_code_scanning %} scans the code in your repository. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." diff --git a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md index 4f57dac62da7..873f202e7af2 100644 --- a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md +++ b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md @@ -1,5 +1,6 @@ --- title: Encontrar vulnerabilidades e erros de segurança no seu código +product: '{% data reusables.gated-features.code-scanning %}' redirect_from: - /github/managing-security-vulnerabilities/finding-security-vulnerabilities-in-your-projects-code versions: @@ -11,14 +12,17 @@ versions: {% topic_link_in_list /automatically-scanning-your-code-for-vulnerabilities-and-errors %} {% link_in_list /about-code-scanning %} + {% link_in_list /triaging-code-scanning-alerts-in-pull-requests %} {% link_in_list /enabling-code-scanning %} - {% link_in_list /managing-alerts-from-code-scanning %} + {% link_in_list /managing-code-scanning-alerts-for-your-repository %} {% link_in_list /configuring-code-scanning %} - {% link_in_list /configuring-the-codeql-action-for-compiled-languages %} - {% link_in_list /troubleshooting-code-scanning %} + {% link_in_list /configuring-the-codeql-workflow-for-compiled-languages %} + {% link_in_list /troubleshooting-the-codeql-workflow %} {% topic_link_in_list /managing-results-from-code-scanning %} {% link_in_list /about-integration-with-code-scanning %} - {% link_in_list /running-code-scanning-in-your-ci-system %} - {% link_in_list /configuring-code-scanning-in-your-ci-system %} {% link_in_list /uploading-a-sarif-file-to-github %} {% link_in_list /sarif-support-for-code-scanning %} +{% topic_link_in_list /using-codeql-code-scanning-with-your-existing-ci-system %} + {% link_in_list /running-codeql-code-scanning-in-your-ci-system %} + {% link_in_list /configuring-codeql-code-scanning-in-your-ci-system %} + {% link_in_list /troubleshooting-codeql-code-scanning-in-your-ci-system %} diff --git a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md index 9bce7265f7c0..9a079833bb6b 100644 --- a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md +++ b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md @@ -1,8 +1,9 @@ --- title: Integrar com varredura de código shortTitle: Integração -intro: 'Você pode integrar {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} aos seus sistemas de CI existentes ou fazer upload dos resultados a partir de outras ferramentas.' +intro: 'Você pode integrar ferramentas de análise de código de terceiros com {% data variables.product.prodname_dotcom %} {% data variables.product.prodname_code_scanning %} fazendo o upload de dados como arquivos SARIF.' mapTopic: true +product: '{% data reusables.gated-features.code-scanning %}' redirect_from: - /github/finding-security-vulnerabilities-and-errors-in-your-code/managing-results-from-code-scanning versions: diff --git a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository.md b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository.md new file mode 100644 index 000000000000..aaac7cc98dba --- /dev/null +++ b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository.md @@ -0,0 +1,63 @@ +--- +title: Gerenciar alertas de verificação de código para o seu repositório +shortTitle: Gerenciando alertas +intro: 'Você pode visualizar, corrigir e fechar alertas de possíveis vulnerabilidades ou erros no código do seu projeto.' +product: '{% data reusables.gated-features.code-scanning %}' +permissions: 'As pessoas com permissão de gravação em um repositório podem gerenciar alertas de {% data variables.product.prodname_code_scanning %} do repositório.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +redirect_from: + - /github/managing-security-vulnerabilities/managing-alerts-from-automated-code-scanning + - /github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning +--- + +{% data reusables.code-scanning.beta %} + +### Sobre os alertas de {% data variables.product.prodname_code_scanning %} + +Você pode configurar {% data variables.product.prodname_code_scanning %} para verificar o código em um repositório usando a análise-padrão de {% data variables.product.prodname_codeql %}, uma análise de terceiros ou vários tipos de análise. Quando a análise for concluída, os alertas resultantes serão exibidos lado a lado na visualização de segurança do repositório. Os resultados de ferramentas de terceiros ou de consultas personalizadas podem não incluir todas as propriedades que você vê para alertas detectados pela análise-padrão {% data variables.product.prodname_codeql %} de {% data variables.product.company_short %}. Para obter mais informações, consulte "[Habilitando {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning). + +Por padrão, {% data variables.product.prodname_code_scanning %} analisa seu código periodicamente no branch-padrão e durante os pull requests. Para obter informações sobre o gerenciamento de alertas em um pull request, consulte "[Triar aletras de {% data variables.product.prodname_code_scanning %} em pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests)". + +### Sobre detalhes de alertas + +Cada alerta destaca um problema com o código e o nome da ferramenta que o identificou. Você pode ver a linha de código que acionou o alerta, bem como propriedades do alerta, como, por exemplo, a gravidade e a natureza do problema. Os alertas também informam quando o problema foi introduzido pela primeira vez. Para os alertas identificados pela análise do {% data variables.product.prodname_codeql %} , você também verá informações sobre como corrigir o problema. + +![Exemplo de alerta de {% data variables.product.prodname_code_scanning %}](/assets/images/help/repository/code-scanning-alert.png) + +Se você habilitar o {% data variables.product.prodname_code_scanning %} usando {% data variables.product.prodname_codeql %}, isso também poderá detectar problemas no fluxo de dados no seu código. A análise do fluxo de dados encontra potenciais problemas de segurança no código, tais como: usar dados de forma insegura, passar argumentos perigosos para funções e vazar informações confidenciais. + +Quando {% data variables.product.prodname_code_scanning %} relata alertas de fluxo de dados, {% data variables.product.prodname_dotcom %} mostra como os dados se movem através do código. {% data variables.product.prodname_code_scanning_capc %} permite que você identifique as áreas do seu código que vazam informações confidenciais que poderia ser o ponto de entrada para ataques de usuários maliciosos. + +### Visualizar um alerta + +Qualquer pessoa com permissão de leitura para um repositório pode ver alertas de {% data variables.product.prodname_code_scanning %} em pull requests. No entanto, você precisa de permissão de gravação para ver um resumo de alertas de repositório na aba **Segurança**. Por padrão, os alertas são exibidos para o branch-padrão. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-security %} +{% data reusables.repositories.sidebar-code-scanning-alerts %} +{% data reusables.code-scanning.click-alert-in-list %} +5. Opcionalmente, se o alerta destacar um problema com o fluxo de dados, clique em **Mostrar caminhos** para exibir o caminho da fonte de dados até o destino onde é usado. ![Exemplo de alerta de fluxo de dados](/assets/images/help/repository/code-scanning-show-paths.png) + +### Corrigir um alerta + +Qualquer pessoa com permissão de gravação para um repositório pode corrigir um alerta, fazendo o commit de uma correção do código. Se o repositório tiver {% data variables.product.prodname_code_scanning %} agendado para ser executado em pull requests, recomenda-se registrar um pull request com sua correção. Isso ativará a análise de {% data variables.product.prodname_code_scanning %} referente às alterações e irá testar se sua correção não apresenta nenhum problema novo. Para obter mais informações, consulte "[Configurar {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" e " "[Testar alertas de {% data variables.product.prodname_code_scanning %} em pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests)". + +### Fechar um alerta + +Fechar um alerta é uma maneira de resolver um alerta que você considera que não precisa ser corrigido. {% data reusables.code-scanning.close-alert-examples %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-security %} +{% data reusables.repositories.sidebar-code-scanning-alerts %} +{% data reusables.code-scanning.click-alert-in-list %} +5. Selecione o menu suspenso de Fechar e clique em um motivo para fechar o alerta. ![Escolher o motivo para fechar o alerta no menu suspenso Fechar](/assets/images/help/repository/code-scanning-alert-close-drop-down.png) + +{% data reusables.code-scanning.false-positive-fix-codeql %} + +### Leia mais + +- "[Triar alertas de {% data variables.product.prodname_code_scanning %} em pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests)" +- "[Habilitar {% data variables.product.prodname_code_scanning %} para um repositório](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository)" +- "[Sobre a integração com {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning)" diff --git a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md new file mode 100644 index 000000000000..5b7faf0e62b0 --- /dev/null +++ b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md @@ -0,0 +1,161 @@ +--- +title: Running CodeQL code scanning in your CI system +shortTitle: Running in your CI +intro: 'You can use the {% data variables.product.prodname_codeql_runner %} to perform {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in a third-party continuous integration system.' +product: '{% data reusables.gated-features.code-scanning %}' +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta-codeql-runner %} +{% data reusables.code-scanning.beta %} +{% data reusables.code-scanning.enterprise-enable-code-scanning %} + +### Using {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} with your existing CI system + +If you use a continuous integration or continuous delivery/deployment (CI/CD) system other than {% data variables.product.prodname_actions %}, you can use your existing system to run {% data variables.product.prodname_dotcom %}'s {% data variables.product.prodname_codeql %} analysis and upload the results to {% data variables.product.prodname_dotcom %}. To do this, use the {% data variables.product.prodname_codeql_runner %}. + +### About the {% data variables.product.prodname_codeql_runner %} + +{% data reusables.code-scanning.about-code-scanning %} For information, see "[About {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)." + +You can use the {% data variables.product.prodname_codeql_runner %} to run {% data variables.product.prodname_code_scanning %} on code that you're processing in a third-party continuous integration (CI) system. Alternatively, you can use {% data variables.product.prodname_actions %} to run {% data variables.product.prodname_code_scanning %} on {% data variables.product.product_location %}. For information, see "[Enabling {% data variables.product.prodname_code_scanning %} for a repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository)." + +The {% data variables.product.prodname_codeql_runner %} is a command-line tool that runs {% data variables.product.prodname_codeql %} analysis on a checkout of a {% data variables.product.prodname_dotcom %} repository. You add the runner to your third-party system, then call the runner to analyze code and upload the results to {% data variables.product.product_location %}. These results are displayed as {% data variables.product.prodname_code_scanning %} alerts in the repository. + +{% data reusables.code-scanning.codeql-runner-license %} + +### Downloading the {% data variables.product.prodname_codeql_runner %} + +You can download the {% data variables.product.prodname_codeql_runner %} from https://github.com/github/codeql-action/releases. On some operating systems, you may need to change permissions for the downloaded file before you can run it. + +On Linux: + +```shell +chmod +x codeql-runner-linux +``` + +On MacOS: + +```shell +chmod +x codeql-runner-macos +sudo xattr -d com.apple.quarantine codeql-runner-macos +``` + +On Windows, the `codeql-runner-win.exe` file usually requires no change to permissions. + +### Adding the {% data variables.product.prodname_codeql_runner %} to your CI system + +Once you have downloaded the {% data variables.product.prodname_codeql_runner %} and verified that it can be executed, you should make the runner available to each CI server that you intend to use for {% data variables.product.prodname_code_scanning %}. It is important to notice that each CI server that you intend to use for {% data variables.product.prodname_code_scanning %} needs to have the {% data variables.product.prodname_codeql_runner %}. You might configure each server to copy the runner from a central, internal location, or you could use the REST API to get the runner direct from GitHub, for example: + +```shell +wget https://github.com/github/codeql-action/releases/download/codeql-bundle-20200826/codeql-runner-linux +chmod +x codeql-runner-linux +``` + +In addition to this, each CI server also needs: + +- A {% data variables.product.prodname_github_apps %} or personal access token for the {% data variables.product.prodname_codeql_runner %} to use. For private repositories the token must have the `repo` scope. For public the token needs only the `public_repo` and `repo:security_events` scopes. For information, see "[Building {% data variables.product.prodname_github_apps %}](/developers/apps/building-github-apps)" and "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token)." +- Access to the {% data variables.product.prodname_codeql %} bundle associated with this release of the {% data variables.product.prodname_codeql_runner %}. This package contains the {% data variables.product.prodname_codeql %} CLI, queries, and libraries needed for {% data variables.product.prodname_codeql %} analysis. For information, see "[{% data variables.product.prodname_codeql %} CLI](https://help.semmle.com/codeql/codeql-cli.html)." + +The options for providing access to the {% data variables.product.prodname_codeql %} bundle are: + +1. Allow the CI servers access to {% data variables.product.prodname_dotcom_the_website %} so that the {% data variables.product.prodname_codeql_runner %} can download the bundle automatically. +1. Manually download/extract the bundle, store it with other central resources, and use the `--codeql-path` flag to specify the location of the bundle in calls to initialize the {% data variables.product.prodname_codeql_runner %}. +{% if currentVersion != "free-pro-team@latest" %} +1. You can mirror the `github/codeql-action` repository on {% data variables.product.product_location %}. Unless you specify the `--codeql-path` flag, the runner automatically checks for the bundle in this location and on {% data variables.product.prodname_dotcom_the_website %}.{% endif %} + +### Calling the {% data variables.product.prodname_codeql_runner %} + +You should call the {% data variables.product.prodname_codeql_runner %} from the checkout location of the repository you want to analyze. The two main commands are: + +1. `init` required to initialize the runner and create a {% data variables.product.prodname_codeql %} database for each language to be analyzed. These databases are populated and analyzed by subsequent commands. +1. `analyze` required to populate the {% data variables.product.prodname_codeql %} databases, analyze them, and upload results to {% data variables.product.product_location %}. + +For both commands, you must specify the URL of {% data variables.product.product_location %}, the repository *OWNER/NAME*, and the GitHub Apps or personal access token to use for authentication. You also need to specify the location of the CodeQL bundle unless the CI server has access to download it directly from the `github/codeql-action` repository on {% data variables.product.prodname_dotcom_the_website %}{% if currentVersion != "free-pro-team@latest" %} or mirrored on {% data variables.product.product_location %}{% endif %}. + +You can configure where the {% data variables.product.prodname_codeql_runner %} stores the CodeQL bundle for future analysis on a server using the `--tools-dir` flag and where it stores temporary files during analysis using `--temp-dir`. + +To view the command-line reference for the runner, use the `-h` flag. For example, to list all commands run: `codeql-runner-OS -h`, or to list all the flags available for the `init` command run: `codeql-runner-OS init -h` (where `OS` varies according to the executable that you are using). For more information, see "[Configuring {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system#codeql-runner-command-reference)." + +#### Basic example + +This example runs {% data variables.product.prodname_codeql %} analysis on a Linux CI server for the `octo-org/example-repo` repository hosted on `{% data variables.command_line.git_url_example %}`. The process is very simple because the repository contains only languages that can be analyzed by {% data variables.product.prodname_codeql %} directly, without being built (that is, Go, JavaScript, Python, and TypeScript). + +1. Check out the repository to analyze. +1. Move into the directory where the repository is checked out. +1. Initialize the {% data variables.product.prodname_codeql_runner %} and create {% data variables.product.prodname_codeql %} databases for the languages detected. + + ```shell + $ /path/to-runner/codeql-runner-linux init --repository octo-org/example-repo + --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN + > Cleaning temp directory /srv/checkout/example-repo/codeql-runner + > ... + > Created CodeQL database at /srv/checkout/example-repo/codeql-runner/codeql_databases/javascript. + ``` + +1. Populate the {% data variables.product.prodname_codeql_runner %} databases, analyze them, and upload the results to {% data variables.product.product_name %}. + + ```shell + $ /path/to-runner/codeql-runner-linux analyze --repository octo-org/example-repo + --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN + --commit 5b6a3078b31dc346e5ce7b86837d6abbe7a18bbd --ref refs/heads/main + > Finalizing database creation + > ... + > POST /repos/octo-org/example-repo/code-scanning/sarifs - 202 in 786ms + > Successfully uploaded results + ``` + +The server has access to download the {% data variables.product.prodname_codeql %} bundle directly from the `github/codeql-action` repository on {% data variables.product.prodname_dotcom_the_website %}{% if currentVersion != "free-pro-team@latest" %} or mirrored on {% data variables.product.product_location %}{% endif %}, so there is no need to use the `--codeql-path` flag. When the analysis is complete, the {% data variables.product.prodname_codeql_runner %} uploads the results to the {% data variables.product.prodname_code_scanning %} view. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." + +#### Compiled language example + +This example is similar to the previous example, however this time the repository has code in C/C++, C#, or Java. To create a {% data variables.product.prodname_codeql %} database for these languages, the CLI needs to monitor the build. At the end of the initialization process, the runner reports the command you need to set up the environment before building the code. You need to run this command, before calling the normal CI build process, and then running the `analyze` command. + +1. Check out the repository to analyze. +1. Move into the directory where the repository is checked out. +1. Initialize the {% data variables.product.prodname_codeql_runner %} and create {% data variables.product.prodname_codeql %} databases for the languages detected. + + ```shell + $ /path/to-runner/codeql-runner-linux init --repository octo-org/example-repo-2 + --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN + > Cleaning temp directory /srv/checkout/example-repo-2/codeql-runner + > ... + > CodeQL environment output to "/srv/checkout/example-repo-2/codeql-runner/codeql-env.json" + and "/srv/checkout/example-repo-2/codeql-runner/codeql-env.sh". + Please export these variables to future processes so the build can be traced, for example by running " + . /srv/checkout/example-repo-2/codeql-runner/codeql-env.sh". + ``` + +1. Run the script generated by the `init` action to set up the environment to monitor the build. + + ```shell + $ . /srv/checkout/example-repo-2/codeql-runner/codeql-env.sh + ``` + +1. Build the code. +1. Populate the {% data variables.product.prodname_codeql %} databases, analyze them, and upload the results to GitHub. + + ```shell + $ /path/to-runner/codeql-runner-linux analyze --repository octo-org/example-repo-2 + --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN + --commit ae7b655ef30b50fb726ae7b3daa79571a39d194d --ref refs/heads/main + > Finalizing database creation + > ... + > POST /repos/octo-org/example-repo-2/code-scanning/sarifs - 202 in 573ms + > Successfully uploaded results + ``` + +{% note %} + +**Note:** If you use a containerized build, you need to run the {% data variables.product.prodname_codeql_runner %} in the container where your build task takes place. + +{% endnote %} + +### Further reading + +- "[Configuring {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system)" +- "[Troubleshooting {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system)" diff --git a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md index 15d626887dd1..6030b3a435ab 100644 --- a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md +++ b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md @@ -11,27 +11,32 @@ versions: --- {% data reusables.code-scanning.beta %} -{% data reusables.code-scanning.enterprise-enable-code-scanning %} ### Sobre o suporte SARIF SARIF (Formato de Intercâmbio de Resultados de Análise Estática) é um [OASIS Padrão](https://docs.oasis-open.org/sarif/sarif/v2.1.0/sarif-v2.1.0.html) que define um formato do arquivo de saída. O padrão SARIF é usado para simplificar como as ferramentas de análise estáticas compartilham seus resultados. O {% data variables.product.prodname_code_scanning_capc %} é compatível com um subconjunto do esquema SARIF 2.1.0 JSON. -Para fazer o upload de um arquivo SARIF a partir de um mecanismo de análise de código estático de terceiros, você deverá garantir que os arquivos carregados usem a versão SARIF 2.1.0. O {% data variables.product.prodname_dotcom %} analisará o arquivo SARIF e exibirá alertas utilizando os resultados no seu repositório como parte da experiência de varredura de código. Para obter mais informações, consulte "[Enviar um arquivo SARIF para o {% data variables.product.prodname_dotcom %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)". Para obter mais informações sobre o esquema SARIF 2.1.0 JSON, consulte [`sarif-schema-2.1.0.json`](https://github.com/oasis-tcs/sarif-spec/blob/master/Schemata/sarif-schema-2.1.0.json). +Para fazer o upload de um arquivo SARIF a partir de um mecanismo de análise de código estático de terceiros, você deverá garantir que os arquivos carregados usem a versão SARIF 2.1.0. Para fazer o upload de um arquivo SARIF a partir de um mecanismo de análise de código estático de terceiros, você deverá garantir que os arquivos carregados usem a versão SARIF 2.1.0. Para obter mais informações, consulte "[Enviar um arquivo SARIF para o {% data variables.product.prodname_dotcom %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)". Para obter mais informações sobre o esquema SARIF 2.1.0 JSON, consulte [`sarif-schema-2.1.0.json`](https://github.com/oasis-tcs/sarif-spec/blob/master/Schemata/sarif-schema-2.1.0.json). Se o seu arquivo SARIF não incluir `partialFingerprints`, o campo `partialFingerprints` será calculado quando você fizer o upload do arquivo SARIF usando {% data variables.product.prodname_actions %}. Para obter mais informações, consulte "[Fazer o upload de um arquivo SARIF para o {% data variables.product.prodname_dotcom %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github#uploading-a-code-scanning-analysis-with-github-actions)". -{% data variables.product.prodname_dotcom %} usa propriedades no arquivo SARIF para exibir alertas. Por exemplo, `shortDescription` e `fullDescription` aparecem na parte superior de um alerta de {% data variables.product.prodname_code_scanning %}. O `local` permite que {% data variables.product.prodname_dotcom %} mostre anotações no seu arquivo de código. Para obter mais informações, consulte "[Gerenciando alertas do {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." +{% data variables.product.prodname_dotcom %} usa propriedades no arquivo SARIF para exibir alertas. Por exemplo, `shortDescription` e `fullDescription` aparecem na parte superior de um alerta de {% data variables.product.prodname_code_scanning %}. O `local` permite que {% data variables.product.prodname_dotcom %} mostre anotações no seu arquivo de código. Para obter mais informações, consulte "[Gerenciar alertas de {% data variables.product.prodname_code_scanning %} para o seu repositório](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)". Se você for novo no SARIF e quiser saber mais, consulte o repositório da Microsoft de[`Tutoriais do SARIF`](https://github.com/microsoft/sarif-tutorials). ### Impedir alertas duplicados usando impressões digitais -Cada vez que um fluxo de trabalho do {% data variables.product.prodname_actions %} executa uma nova varredura de código, os resultados de cada execução são processados e os alertas são adicionados ao repositório. Para evitar alertas duplicados para o mesmo problema, {% data variables.product.prodname_code_scanning %} usa impressões digitais para corresponder aos resultados em várias execuções, para que apareçam apenas uma vez na última execução do ramo selecionado. +Cada vez que um fluxo de trabalho do {% data variables.product.prodname_actions %} executa uma nova varredura de código, os resultados de cada execução são processados e os alertas são adicionados ao repositório. Para evitar alertas duplicados para o mesmo problema, {% data variables.product.prodname_code_scanning %} usa impressões digitais para corresponder aos resultados em várias execuções, para que apareçam apenas uma vez na última execução do ramo selecionado. Isto torna possível combinar alertas com a linha de código correta quando os arquivos são editados. O {% data variables.product.prodname_dotcom %} usa a propriedade `partialFingerprints` no padrão OASIS para detectar quando dois resultados são idênticos logicamente. Para obter mais informações, consulte a entrada "[partialFingerprints property](https://docs.oasis-open.org/sarif/sarif/v2.1.0/cs01/sarif-v2.1.0-cs01.html#_Toc16012611)" na documentação do OASIS. -OS arquivos do SARIF criados pelo {% data variables.product.prodname_codeql_workflow %} ou usando {% data variables.product.prodname_codeql_runner %} incluem dados de impressão digital. Se o seu arquivo SARIF não incluir `partialFingerprints`, o campo `partialFingerprints` será calculado se você fizer o upload do arquivo SARIF usando {% data variables.product.prodname_actions %}. Para obter mais informações, consulte "[Fazer o upload de um arquivo SARIF para o {% data variables.product.prodname_dotcom %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github#uploading-a-code-scanning-analysis-with-github-actions)". +OS arquivos do SARIF criados pelo {% data variables.product.prodname_codeql_workflow %} ou usando {% data variables.product.prodname_codeql_runner %} incluem dados de impressão digital. Se você enviar um arquivo SARIF usando a ação `upload-sarif` e estes dados estiverem faltando, {% data variables.product.prodname_dotcom %} tenta preencher o campo `partialFingerprints` a partir dos arquivos de origem. Para obter mais informações sobre o upload de resultados, consulte "[Fazer o upload de um arquivo SARIF para o {% data variables.product.prodname_dotcom %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github#uploading-a-code-scanning-analysis-with-github-actions)". + +Se o seu arquivo SARIF não incluir `partialFingerprints`, o campo `partialFingerprints` será calculado quando você fizer o upload do arquivo SARIF usando {% data variables.product.prodname_actions %}. Para evitar ver alertas duplicados, você deve calcular dados de impressão digital e preencher a propriedade `partialFingerprints` antes de enviar o arquivo SARIF. Você pode encontrar o script que a ação `upload-sarif` usa como um ponto inicial útil: https://github.com/github/codeql-action/blob/main/src/fingerprints.ts. Para obter mais informações sobre a API, consulte "[Fazer o upload de um arquivo SARIF](/rest/reference/code-scanning#upload-a-sarif-file)". + +### Validar seu arquivo SARIF + +Você pode marcar um arquivo SARIF compatível com {% data variables.product.prodname_code_scanning %} testando-o com as regras de ingestão de {% data variables.product.prodname_dotcom %}. Para obter mais informações, acesse o [validador do Microsoft SARIF](https://sarifweb.azurewebsites.net/). ### Propriedades compatíveis do arquivo de saída SARIF @@ -44,49 +49,49 @@ Se você usar um mecanismo de análise de código diferente de {% data variables | Nome | Descrição | | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `$schema` | **Obrigatório.** A URI do esquema SARIF JSON para a versão 2.1.0. Por exemplo, `https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json`. | -| `versão` | **Obrigatório.** {% data variables.product.prodname_code_scanning_capc %} é compatível apenas com a versão `2.1.0` do SARIF. | +| `versão` | **Obrigatório.** {% data variables.product.prodname_code_scanning_capc %} é compatível apenas com a versão `2.1.0` do SARIF. | | `runs[]` | **Obrigatório.** Um arquivo SARIF contém um array de uma ou mais execuções. Cada execução representa uma execução única de uma ferramenta de análise. Para obter mais informações sobre uma `execução`, consulte o objeto [`executar`](#run-object). | #### Objeto `run` O {% data variables.product.prodname_code_scanning_capc %} usa o objeto `executar` para filtrar resultados por ferramenta e fornecer informações sobre a fonte de um resultado. O objeto `executar` contém o objeto `tool.driver` do componente da ferramenta, que contém informações sobre a ferramenta que gerou os resultados. Cada `execução` pode ter resultados apenas para uma ferramenta de análise. -| Nome | Descrição | -| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Nome | Descrição | +| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `tool.driver.name` | **Obrigatório.** O nome da ferramenta de análise. {% data variables.product.prodname_code_scanning_capc %} exibe o nome em {% data variables.product.prodname_dotcom %} para permitir que você filtre resultados por ferramenta. | | `tool.driver.version` | **Opcional.** A versão da ferramenta de análise. O {% data variables.product.prodname_code_scanning_capc %} usa o número da versão para fazer o monitoramento quando os resultados podem ter mudado devido a uma mudança na versão da ferramenta em vez de uma mudança no código que está sendo analisado. Se o arquivo SARIF incluir o campo `semanticVersion`, {% data variables.product.prodname_code_scanning %} não usará `versão`. | | `tool.driver.semanticVersion` | **Opcional.** A versão da ferramenta de análise especificada pelo formato Semantic Versioning 2.0. O {% data variables.product.prodname_code_scanning_capc %} usa o número da versão para fazer o monitoramento quando os resultados podem ter mudado devido a uma mudança na versão da ferramenta em vez de uma mudança no código que está sendo analisado. Se o arquivo SARIF incluir o campo `semanticVersion`, {% data variables.product.prodname_code_scanning %} não usará `versão`. Para obter mais informações, consulte "[Semantic Versioning 2.0.0](https://semver.org/)" na documentação de Semantic Versioning. | -| `tool.driver.rules[]` | **Obrigatório.** Um array de objetos `reportingDescriptor` que representam regras. A ferramenta de análise usa regras para encontrar problemas no código que está sendo analisado. Para obter mais informações, consulte o objeto [`reportingDescriptor`](#reportingdescriptor-object). | +| `tool.driver.rules[]` | **Obrigatório.** Um array de objetos `reportingDescriptor` que representam regras. A ferramenta de análise usa regras para encontrar problemas no código que está sendo analisado. Para obter mais informações, consulte o objeto [`reportingDescriptor`](#reportingdescriptor-object). | | `results[]` | **Obrigatório.** Os resultados da ferramenta de análise. {% data variables.product.prodname_code_scanning_capc %} exibe os resultados em {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte o objeto [`resultado`](#result-object). | #### Objeto `reportingDescriptor` -| Nome | Descrição | -| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Nome | Descrição | +| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | **Obrigatório.** Um identificador exclusivo para a regra. O id `` é referenciado a partir de outras partes do arquivo SARIF e pode ser usado por {% data variables.product.prodname_code_scanning %} para exibir URLs em {% data variables.product.prodname_dotcom %}. | | `name` | **Opcional.** O nome da regra. {% data variables.product.prodname_code_scanning_capc %} exibe o nome para permitir que os resultados sejam filtrados pela regra em {% data variables.product.prodname_dotcom %}. | | `shortDescription.text` | **Obrigatório.** Uma descrição concisa da regra. {% data variables.product.prodname_code_scanning_capc %} exibe a breve descrição em {% data variables.product.prodname_dotcom %} ao lado dos resultados associados. | | `fullDescription.text` | **Obrigatório.** Uma descrição da regra. {% data variables.product.prodname_code_scanning_capc %} exibe a descrição completa em {% data variables.product.prodname_dotcom %} ao lado dos resultados associados. O número máximo de caracteres é 1000. | -| `defaultConfiguration.level` | **Opcional.** Gravidade-padrão da regra. {% data variables.product.prodname_code_scanning_capc %} usa níveis de gravidade para ajudar você a entender quão crítico é o resultado para uma determinada regra. Esse valor pode ser substituído pelo atributo de `nível` no objeto `resultado`. Para obter mais informações, consulte o objeto [`resultado`](#result-object). Padrão: `alerta`. | -| `help.text` | **Obrigatório.** Documentação para a regra usando o formato de texto. O {% data variables.product.prodname_code_scanning_capc %} exibe essa documentação de ajuda ao lado dos resultados associados. | -| `help.markdown` | **Recomendado.** Documentação para a regra que o formato Markdown. O {% data variables.product.prodname_code_scanning_capc %} exibe essa documentação de ajuda ao lado dos resultados associados. Quando `help.markdown` estiver disponível, será exibido em vez de `help.text`. | +| `defaultConfiguration.level` | **Opcional.** Gravidade-padrão da regra. {% data variables.product.prodname_code_scanning_capc %} usa níveis de gravidade para ajudar você a entender quão crítico é o resultado para uma determinada regra. Esse valor pode ser substituído pelo atributo de `nível` no objeto `resultado`. Para obter mais informações, consulte o objeto [`resultado`](#result-object). Padrão: `alerta`. | +| `help.text` | **Obrigatório.** Documentação para a regra usando o formato de texto. O {% data variables.product.prodname_code_scanning_capc %} exibe essa documentação de ajuda ao lado dos resultados associados. | +| `help.markdown` | **Recomendado.** Documentação para a regra que o formato Markdown. O {% data variables.product.prodname_code_scanning_capc %} exibe essa documentação de ajuda ao lado dos resultados associados. Quando `help.markdown` estiver disponível, será exibido em vez de `help.text`. | | `properties.tags[]` | **Opcional.** Um array de strings. {% data variables.product.prodname_code_scanning_capc %} usa `tags` para permitir que você filtre resultados em {% data variables.product.prodname_dotcom %}. Por exemplo, é possível filtrar para todos os resultados que têm a tag `segurança`. | | `properties.precision` | **Recomendado.** Uma string que indica quantas vezes os resultados indicados por esta regra são verdadeiros. Por exemplo, se uma regra tem uma alta taxa conhecida de falsos-positivos, a precisão deve ser `baixa`. {% data variables.product.prodname_code_scanning_capc %} ordena os resultados por precisão em {% data variables.product.prodname_dotcom %} de modo que os resultados com o mais alto `nível` e a mais alta `precisão` sejam exibidos primeiro. Pode ser: `very-high`, `high`, `medium` ou `low`. | #### Objeto `resultado` -| Nome | Descrição | -| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `ruleId` | **Opcional.** O identificador exclusivo da regra (`reportingDescriptor.id`). Para obter mais informações, consulte o objeto [`reportingDescriptor`](#reportingdescriptor-object). {% data variables.product.prodname_code_scanning_capc %} usa o identificador da regra para filtrar os resultados por regra em {% data variables.product.prodname_dotcom %}. | -| `ruleIndex` | **Opcional.** O índice da regra associada (objeto `reportingDescriptor`) no array `regras` no componente da ferramenta. Para obter mais informações, consulte o objeto [`executar`](#run-object). | -| `rule` | **Opcional.** Uma referência usada para localizar a regra (descritor de relatório) para este resultado. Para obter mais informações, consulte o objeto [`reportingDescriptor`](#reportingdescriptor-object). | -| `level` | **Opcional.** A gravidade do resultado. Esse nível sobrepõe a severidade-padrão definida pela regra. {% data variables.product.prodname_code_scanning_capc %} usa o nível para filtrar resultados por gravidade em {% data variables.product.prodname_dotcom %}. | -| `message.text` | **Obrigatório.** Uma mensagem que descreve o resultado. {% data variables.product.prodname_code_scanning_capc %} exibe o texto da mensagem como o título do resultado. Apenas a primeira frase da mensagem será exibida quando o espaço visível for limitado. | -| `locations[]` | **Obrigatório.** O conjunto de locais onde o resultado foi detectado. Só um local deve ser incluído, a não ser que o problema só possa ser corrigido fazendo uma alteração em cada local especificado. **Observação:** Pelo menos um local é necessário para {% data variables.product.prodname_code_scanning %} apresentar um resultado. {% data variables.product.prodname_code_scanning_capc %} usará essa propriedade para decidir qual arquivo fazer anotações com o resultado. Apenas o primeiro valor desse array é usado. Todos os outros valores são ignorados. | +| Nome | Descrição | +| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `ruleId` | **Opcional.** O identificador exclusivo da regra (`reportingDescriptor.id`). Para obter mais informações, consulte o objeto [`reportingDescriptor`](#reportingdescriptor-object). {% data variables.product.prodname_code_scanning_capc %} usa o identificador da regra para filtrar os resultados por regra em {% data variables.product.prodname_dotcom %}. | +| `ruleIndex` | **Opcional.** O índice da regra associada (objeto `reportingDescriptor`) no array `regras` no componente da ferramenta. Para obter mais informações, consulte o objeto [`executar`](#run-object). | +| `rule` | **Opcional.** Uma referência usada para localizar a regra (descritor de relatório) para este resultado. Para obter mais informações, consulte o objeto [`reportingDescriptor`](#reportingdescriptor-object). | +| `level` | **Opcional.** A gravidade do resultado. Esse nível sobrepõe a severidade-padrão definida pela regra. {% data variables.product.prodname_code_scanning_capc %} usa o nível para filtrar resultados por gravidade em {% data variables.product.prodname_dotcom %}. | +| `message.text` | **Obrigatório.** Uma mensagem que descreve o resultado. {% data variables.product.prodname_code_scanning_capc %} exibe o texto da mensagem como o título do resultado. Apenas a primeira frase da mensagem será exibida quando o espaço visível for limitado. | +| `locations[]` | **Obrigatório.** O conjunto de locais onde o resultado foi detectado. Só um local deve ser incluído, a não ser que o problema só possa ser corrigido fazendo uma alteração em cada local especificado. **Observação:** Pelo menos um local é necessário para {% data variables.product.prodname_code_scanning %} apresentar um resultado. {% data variables.product.prodname_code_scanning_capc %} usará essa propriedade para decidir qual arquivo fazer anotações com o resultado. Apenas o primeiro valor desse array é usado. Todos os outros valores são ignorados. | | `partialFingerprints` | **Obrigatório.** Um conjunto de strings usado para rastrear a identidade única do resultado. {% data variables.product.prodname_code_scanning_capc %} usa `partialFingerprints` para identificar com precisão quais resultados são os mesmos em todos os commits e branches. O {% data variables.product.prodname_code_scanning_capc %} tentará usar `partialFingerprints`, se existirem. Se você estiver fazendo upload de arquivos SARIF de terceiros com `upload-action`, a ação irá criar `partialFingerprints` para você quando não estiverem incluídos no arquivo SARIF. Para obter mais informações, consulte "[Prevenir alertas duplicados usando impressões digitais](#preventing-duplicate-alerts-using-fingerprints)". **Observação:** {% data variables.product.prodname_code_scanning_capc %} usa apenas `primaryLocationLineHash`. | -| `codeFlows[].threadFlows[].locations[]` | **Opcional.** Uma array de objetos `local` para um objeto `threadFlow`, que descreve o progresso de um programa por meio de um thread de execução. Um objeto `codeFlow` descreve um padrão de execução de código usado para detectar um resultado. Se forem fornecidos fluxos de código, {% data variables.product.prodname_code_scanning %} irá expandir os fluxos de código em {% data variables.product.prodname_dotcom %} para o resultado relevante. Para obter mais informações, consulte o objeto [`local`](#location-object). | -| `relatedLocations[]` | Um conjunto de locais relevantes para este resultado. {% data variables.product.prodname_code_scanning_capc %} irá vincular a locais relacionados quando forem incorporados à mensagem do resultado. Para obter mais informações, consulte o objeto [`local`](#location-object). | -| `suppressions[].state` | **Opcional.** Quando o `estado` for definido como `aceito`, {% data variables.product.prodname_code_scanning %} irá atualizar o estado do resultado para `Fechado` em {% data variables.product.prodname_dotcom %}. | +| `codeFlows[].threadFlows[].locations[]` | **Opcional.** Uma array de objetos `local` para um objeto `threadFlow`, que descreve o progresso de um programa por meio de um thread de execução. Um objeto `codeFlow` descreve um padrão de execução de código usado para detectar um resultado. Se forem fornecidos fluxos de código, {% data variables.product.prodname_code_scanning %} irá expandir os fluxos de código em {% data variables.product.prodname_dotcom %} para o resultado relevante. Para obter mais informações, consulte o objeto [`local`](#location-object). | +| `relatedLocations[]` | Um conjunto de locais relevantes para este resultado. {% data variables.product.prodname_code_scanning_capc %} irá vincular a locais relacionados quando forem incorporados à mensagem do resultado. Para obter mais informações, consulte o objeto [`local`](#location-object). | +| `suppressions[].state` | **Opcional.** Quando o `estado` for definido como `aceito`, {% data variables.product.prodname_code_scanning %} irá atualizar o estado do resultado para `Fechado` em {% data variables.product.prodname_dotcom %}. | #### Objeto `local` @@ -100,13 +105,13 @@ Um local dentro de um artefato de programação, como, por exemplo, um arquivo n #### Objeto `physicalLocation` -| Nome | Descrição | -| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Nome | Descrição | +| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `artifactLocation.uri` | **Obrigatório.** Um URI indicando o local de um artefato, geralmente um arquivo no repositório ou gerado durante uma criação. Se o URI for relativo, ele deverá ser relativo à raiz do repositório do {% data variables.product.prodname_dotcom %} que está sendo analisado. Por exemplo, main.js ou src/script.js são relativos à raiz do repositório. Se o URI for absoluto, o {% data variables.product.prodname_code_scanning %} poderá usar o URI para fazer checkout do artefato e corresponder os arquivos no repositório. Por exemplo, `https://github.com/github/example/blob/00/src/promiseUtils.js`. | -| `region.startLine` | **Obrigatório.** O número da linha do primeiro caractere na região. | -| `region.startColumn` | **Obrigatório.** O número da coluna do primeiro caractere na região. | -| `region.endLine` | **Requerido.** O número da linha do último caractere na região. | -| `region.endColumn` | **Obrigatório.** O número da coluna do caractere após o final da região. | +| `region.startLine` | **Obrigatório.** O número da linha do primeiro caractere na região. | +| `region.startColumn` | **Obrigatório.** O número da coluna do primeiro caractere na região. | +| `region.endLine` | **Requerido.** O número da linha do último caractere na região. | +| `region.endColumn` | **Obrigatório.** O número da coluna do caractere após o final da região. | ### Exemplos de arquivos de saída SARIF @@ -119,38 +124,47 @@ Este arquivo de saída SARIF tem exemplo de valores para mostrar as propriedades ```json { - "$schema" : "https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json", - "version" : "2.1.0", - "runs" : - [ + "$schema": "https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json", + "version": "2.1.0", + "runs": [ { - "tool" : { - "driver" : { - "name" : "Tool Name" - } - }, - "results" : [ { - "message" : { - "text" : "Result text. Este resultado não tem nenhuma regra associada." - }, - "locations" : [ { - "physicalLocation" : { - "artifactLocation" : { - "uri" : "src/build.cmd" - }, - "region" : { - "startLine" : 2, - "startColumn" : 7, - "endColumn" : 10 + "tool": { + "driver": { + "name": "Tool Name", + "rules": [ + { + "id": "R01" } + ] + } + }, + "results": [ + { + "ruleId": "R01", + "message": { + "text": "Result text. Este resultado não tem nenhuma regra associada." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "fileURI" + }, + "region": { + "startLine": 2, + "startColumn": 7, + "endColumn": 10 + } + } } - } ], - "partialFingerprints" : { - "primaryLocationLineHash" : "39fa2ee980eb94b0:1" + ], + "partialFingerprints": { + "primaryLocationLineHash": "39fa2ee980eb94b0:1" + } } - }] - } - ] + ] + } + ] } ``` @@ -170,7 +184,7 @@ Este arquivo de saída SARIF tem valores de exemplo para mostrar todas as propri "semanticVersion": "2.0.0", "rules": [ { - "id": "js/unused-local-variable", + "id": "3f292041e51d22005ce48f39df3585d44ce1b0ad", "name": "js/unused-local-variable", "shortDescription": { "text": "Unused variable, import, function or class" @@ -189,7 +203,7 @@ Este arquivo de saída SARIF tem valores de exemplo para mostrar todas as propri } }, { - "id": "js/inconsistent-use-of-new", + "id": "d5b664aefd5ca4b21b52fdc1d744d7d6ab6886d0", "name": "js/inconsistent-use-of-new", "shortDescription": { "text": "Inconsistent use of 'new'" @@ -197,7 +211,6 @@ Este arquivo de saída SARIF tem valores de exemplo para mostrar todas as propri "fullDescription": { "text": "If a function is intended to be a constructor, it should always be invoked with 'new'. Otherwise, it should always be invoked as a normal function, that is, without 'new'." }, - "defaultConfiguration": null, "properties": { "tags": [ "reliability", @@ -206,13 +219,16 @@ Este arquivo de saída SARIF tem valores de exemplo para mostrar todas as propri ], "precision": "very-high" } + }, + { + "id": "R01" } ] } }, "results": [ { - "ruleId": "js/unused-local-variable", + "ruleId": "3f292041e51d22005ce48f39df3585d44ce1b0ad", "ruleIndex": 0, "message": { "text": "Unused variable foo." @@ -222,8 +238,7 @@ Este arquivo de saída SARIF tem valores de exemplo para mostrar todas as propri "physicalLocation": { "artifactLocation": { "uri": "main.js", - "uriBaseId": "%SRCROOT%", - "index": 0 + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 2, @@ -239,7 +254,7 @@ Este arquivo de saída SARIF tem valores de exemplo para mostrar todas as propri } }, { - "ruleId": "js/inconsistent-use-of-new", + "ruleId": "d5b664aefd5ca4b21b52fdc1d744d7d6ab6886d0", "ruleIndex": 1, "message": { "text": "Function resolvingPromise is sometimes invoked as a constructor (for example [here](1)), and sometimes as a normal function (for example [here](2))." @@ -248,8 +263,8 @@ Este arquivo de saída SARIF tem valores de exemplo para mostrar todas as propri { "physicalLocation": { "artifactLocation": { - "uri": "https://github.com/github/example/blob/0000000000000000000000000000000000000000/src/promiseUtils.js", - "index": 1 + "uri": "src/promises.js", + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 2 @@ -267,8 +282,7 @@ Este arquivo de saída SARIF tem valores de exemplo para mostrar todas as propri "physicalLocation": { "artifactLocation": { "uri": "src/ParseObject.js", - "uriBaseId": "%SRCROOT%", - "index": 3 + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 2281, @@ -285,8 +299,7 @@ Este arquivo de saída SARIF tem valores de exemplo para mostrar todas as propri "physicalLocation": { "artifactLocation": { "uri": "src/LiveQueryClient.js", - "uriBaseId": "%SRCROOT%", - "index": 2 + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 166 @@ -299,6 +312,7 @@ Este arquivo de saída SARIF tem valores de exemplo para mostrar todas as propri ] }, { + "ruleId": "R01", "message": { "text": "Specifying both [ruleIndex](1) and [ruleID](2) might lead to inconsistencies." }, @@ -308,8 +322,7 @@ Este arquivo de saída SARIF tem valores de exemplo para mostrar todas as propri "physicalLocation": { "artifactLocation": { "uri": "full.sarif", - "uriBaseId": "%SRCROOT%", - "index": 0 + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 54, @@ -403,12 +416,6 @@ Este arquivo de saída SARIF tem valores de exemplo para mostrar todas as propri } } ], - "newlineSequences": [ - "\r\n", - "\n", - "", - "
 " - ], "columnKind": "utf16CodeUnits" } ] diff --git a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md new file mode 100644 index 000000000000..126fbaa52934 --- /dev/null +++ b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md @@ -0,0 +1,48 @@ +--- +title: Alertas de varredura de código de triagem em pull requests +shortTitle: Alertas de triagem em pull requests +intro: 'Quando {% data variables.product.prodname_code_scanning %} identifica um problema em um pull request, você poderá revisar o código destacado e resolver o alerta.' +product: '{% data reusables.gated-features.code-scanning %}' +permissions: 'As pessoas com permissão de gravação em um repositório podem resolver alertas de {% data variables.product.prodname_code_scanning %}.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta %} + +### Sobre os resultados de {% data variables.product.prodname_code_scanning %} em pull requests + +Em repositórios onde {% data variables.product.prodname_code_scanning %} está configurado como uma verificação de pull request, {% data variables.product.prodname_code_scanning %} verifica o código no pull request. Por padrão, isso é limitado a pull requests que visam o branch-padrão ou os branches protegidos, mas você pode alterar esta configuração em {% data variables.product.prodname_actions %} ou em um sistema de CI/CD de terceiros. Se o merge das alterações introduziria novos alertas de {% data variables.product.prodname_code_scanning %} no branch de destino, estes serão relatados como resultados de verificação no pull request. Os alertas também são exibidos como anotações na aba **Arquivos alterados** do pull request. Se você tiver permissão de gravação no repositório, você poderá ver qualquer alerta de {% data variables.product.prodname_code_scanning %} existente na aba **Segurança**. Para obter informações sobre os alertas do repositório, consulte "[Gerenciar alertas de {% data variables.product.prodname_code_scanning %} do repositório](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)". + +Se {% data variables.product.prodname_code_scanning %} tiver algum resultado com uma gravidade de `erro`, ocorre uma falha na verificação e o erro é relatado nos resultados de verificação. Se todos os resultados encontrados por {% data variables.product.prodname_code_scanning %} tiverem gravidades menores, os alertas são tratados como avisos ou notas e a verificação é considerada bem-sucedida. Se seu pull request for direcionado a um branch protegido, e o proprietário do repositório tiver configurado as verificações de status necessárias, você deverá corrigir ou fechar todos alertas de erro antes que o pull request possa ser mesclado. Para obter mais informações, consulte "[Sobre verificações de status obrigatórias](/github/administering-a-repository/about-required-status-checks)". + +![Exemplo de status de verificação de pull request com alerta de {% data variables.product.prodname_code_scanning %}](/assets/images/help/repository/code-scanning-check-failure.png) + +### Sobre {% data variables.product.prodname_code_scanning %} como uma verificação de pull request + +Há muitas opções para configurar {% data variables.product.prodname_code_scanning %} como uma verificação de pull request. Portanto, a configuração exata de cada repositório irá variar e alguns terão mais de uma verificação. A verificação que contém os resultados de {% data variables.product.prodname_code_scanning %} é: **Resultados da varredura de código**. + +Se o repositório usar a {% data variables.product.prodname_codeql_workflow %} uma **{% data variables.product.prodname_codeql %} / Analyze (LANGUAGE)**, executa-se a verificação para cada linguagem antes que a verificação de resultados seja executada. A verificação de análise pode falhar se houver problemas de configuração ou se o pull request altera a criação para uma linguagem que a análise precisa para compilar (por exemplo, C/C++, C#, ou Java). Assim como com outras verificações de pull request, você poderá ver informações completas da falha de verificação na aba de **Verificações**. Para obter mais informações sobre configuração e solução de problemas, consulte "[Configurar {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" ou "[Solução de problemas de {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning)". + +### Triar de um alerta no seu pull request + +Quando você olha para a aba **Arquivos alterados** para um pull request, você vê anotações para todas as linhas de código que acionaram o alerta. + +![Exemplo de alerta de {% data variables.product.prodname_code_scanning %} exibido como uma anotação na visualização "Arquivos alterados" de um pull request](/assets/images/help/repository/code-scanning-pr-annotation.png) + +Algumas anotações contêm links com contexto extra para o alerta. No exemplo acima, da análise de {% data variables.product.prodname_codeql %}, você pode clicar em **valor fornecido pelo usuário** para ver onde os dados não confiáveis entram no fluxo de dados (isso é referido como a fonte). Neste caso, você pode visualizar o caminho completo da fonte até o código que usa os dados (o destino), clicando em **Mostrar caminhos**. Isto faz com que seja fácil verificar se os dados não são confiáveis ou se a análise não reconheceu uma etapa de sanitização de dados entre a fonte e o destino. Para obter informações sobre a análise do fluxo de dados usando {% data variables.product.prodname_codeql %}, consulte "[Sobre a análise do fluxo de dados](https://help.semmle.com/QL/learn-ql/intro-to-data-flow.html)". + +Para obter mais informações sobre um alerta, clique em **Mostrar mais informações** na anotação. Isso permite que você veja todos os contextos e metadados fornecidos pela ferramenta em uma exibição de alerta. No exemplo abaixo, você pode ver tags que mostram a gravidade, o tipo e as enumerações de fraquezas comuns relevantes (CWEs) para o problema. A vista mostra também quais commits introduziram o problema. + +Alertas de algumas ferramentas, como {% data variables.product.prodname_codeql %}, também incluem uma descrição e um link **Mostrar mais** para orientação sobre como corrigir o problema no código. + +![Exemplo de "Mostrar mais informações" para uma alerta de {% data variables.product.prodname_code_scanning %} em um pull request](/assets/images/help/repository/code-scanning-pr-alert.png) + +### Resolver um alerta no seu pull request + +Qualquer pessoa com permissão de gravação em um repositório pode resolver alertas em um pull request. Se você fizer commit de alterações na solicitação do pull request, isto acionará uma nova execução das verificações do pull request. Se suas alterações corrigirem o problema, o alerta será resolvido e a anotação removida. + +Se você não considerar que um alerta deve ser corrigido, você poderá fechar o alerta manualmente. {% data reusables.code-scanning.close-alert-examples %} O botão **Fechar** está disponível nas anotações e no modo de exibição de alertas se você tiver permissão de gravação no repositório. + +{% data reusables.code-scanning.false-positive-fix-codeql %} diff --git a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md new file mode 100644 index 000000000000..62c9477e4800 --- /dev/null +++ b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md @@ -0,0 +1,52 @@ +--- +title: Solução de problemas de varredura de código do CodeQL no seu sistema de CI +shortTitle: Solução de problemas na sua CI +intro: 'Se você tiver problemas com {% data variables.product.prodname_codeql_runner %}, você poderá solucionar esses problemas usando essas dicas.' +product: '{% data reusables.gated-features.code-scanning %}' +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning-in-your-ci-system +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta-codeql-runner %} +{% data reusables.code-scanning.beta %} + +### O comando `init` leva muito tempo + +Antes de o {% data variables.product.prodname_codeql_runner %} poder criar e analisar o código, ele precisa acessar o pacote de {% data variables.product.prodname_codeql %} que contém a CLI de {% data variables.product.prodname_codeql %} e as bibliotecas de {% data variables.product.prodname_codeql %}. + +Ao usar o {% data variables.product.prodname_codeql_runner %} pela primeira vez na sua máquina, o comando `init` faz o download do pacote de {% data variables.product.prodname_codeql %} para a sua máquina. Este download pode levar alguns minutos. O pacote de {% data variables.product.prodname_codeql %} fica armazenado em cache entre as execuções. Portanto, se você usar o {% data variables.product.prodname_codeql_runner %} novamente na mesma máquina, ele não fará o download do pacote de {% data variables.product.prodname_codeql %} novamente. + +Para evitar este download automático, você pode fazer o download manualmente do pacote de {% data variables.product.prodname_codeql %} para a sua máquina e especificar o caminho usando o parâmetro `--codeql-path` do comando `init`. + +### Nenhum código encontrado durante a criação + +Se o comando `analisar` para o {% data variables.product.prodname_codeql_runner %} falhar com um erro `Nenhum código fonte foi visto durante a criação`, isto indica que {% data variables.product.prodname_codeql %} não conseguiu monitorar o seu código. Há várias explicações para essa falha. + +1. A detecção automática da linguagem identificou uma linguagem compatível, mas não há código analisável dessa linguagem no repositório. Um exemplo típico é quando nosso serviço de detecção de linguagem encontra um arquivo associado a uma determinada linguagem de programação, como um arquivo `.h`, or `.gyp`, mas nenhum código executável correspondente está presente no repositório. Para resolver o problema, você pode definir manualmente as linguagens que você deseja analisar usando o sinalizador `--languages` do comando `init`. Para obter mais informações, consulte "[Configurar o {% data variables.product.prodname_code_scanning %} no seu sistema de CI](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system)". + +1. Você está analisando uma linguagem compilada sem usar o comando `autobuild` e você mesmo executa os passos de criação após a etapa `init`. Para que a criação funcione, você deve configurar o ambiente de modo que {% data variables.product.prodname_codeql_runner %} possa monitorar o código. O comando `init` gera instruções sobre como exportar as variáveis de ambiente necessárias. Portanto, você pode copiar e executar o script depois de executar o comando `init`. + - No macOS e no Linux: + ```shell + $ . codeql-runner/codeql-env.sh + ``` + - No Windows, usando o shell de comando (`cmd`) ou um arquivo de lote (`.bat`): + ```shell + > call codeql-runner\codeql-env.bat + ``` + - No Windows, usando o PowerShell: + ```shell + > cat codeql-runner\codeql-env.sh | Invoke-Expression + ``` + + As variáveis de ambiente também são armazenadas no arquivo `codeql-runner/codeql-env.json`. Este arquivo contém um único objeto JSON que mapeia chaves de variável de ambiente com valores. Se você não conseguir executar o script gerado pelo comando `init`, você poderá usar os dados no formato JSON. + + {% note %} + + **Observação:**Se você usou o sinalizador `--temp-dir` do comando `init` para especificar um diretório personalizado para arquivos temporários, o caminho para os arquivos `codeql-env` podem ser diferentes. + + {% endnote %} + +1. O código é criado em um contêiner ou em uma máquina separada. Se você usar uma criação em contêiner ou se você externalizar a criação para outra máquina, certifique-se de executar {% data variables.product.prodname_codeql_runner %} no contêiner ou na máquina onde a tarefa de criação ocorrer. diff --git a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md new file mode 100644 index 000000000000..f42dbb3db617 --- /dev/null +++ b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md @@ -0,0 +1,125 @@ +--- +title: Troubleshooting the CodeQL workflow +shortTitle: Troubleshooting CodeQL +intro: 'If you''re having problems with {% data variables.product.prodname_code_scanning %}, you can troubleshoot by using these tips for resolving issues.' +product: '{% data reusables.gated-features.code-scanning %}' +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta %} + +### Automatic build for a compiled language fails + +If an automatic build of code for a compiled language within your project fails, try the following troubleshooting steps. + +- Remove the `autobuild` step from your {% data variables.product.prodname_code_scanning %} workflow and add specific build steps. For information about editing the workflow, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)." For more information about replacing the `autobuild` step, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." + +- If your workflow doesn't explicitly specify the languages to analyze, {% data variables.product.prodname_codeql %} implicitly detects the supported languages in your code base. In this configuration, out of the compiled languages C/C++, C#, and Java, {% data variables.product.prodname_codeql %} only analyzes the language with the most source files. Edit the workflow and add a build matrix specifying the languages you want to analyze. The default CodeQL analysis workflow uses such a matrix. + + The following extracts from a workflow show how you can use a matrix within the job strategy to specify languages, and then reference each language within the "Initialize {% data variables.product.prodname_codeql %}" step: + + ```yaml + jobs: + analyze: + ... + strategy: + fail-fast: false + matrix: + language: ['csharp', 'cpp', 'javascript'] + + ... + + - name: Initialize {% data variables.product.prodname_codeql %} + uses: github/codeql-action/init@v1 + with: + languages: {% raw %}${{ matrix.language }}{% endraw %} + ``` + + For more information about editing the workflow, see "[Configuring code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." + +### No code found during the build + +If your workflow fails with an error `No source code was seen during the build` or `The process '/opt/hostedtoolcache/CodeQL/0.0.0-20200630/x64/codeql/codeql' failed with exit code 32`, this indicates that {% data variables.product.prodname_codeql %} was unable to monitor your code. Several reasons can explain such a failure: + +1. Automatic language detection identified a supported language, but there is no analyzable code of that language in the repository. A typical example is when our language detection service finds a file associated with a particular programming language like a `.h`, or `.gyp` file, but no corresponding executable code is present in the repository. To solve the problem, you can manually define the languages you want to analyze by updating the list of languages in the `language` matrix. For example, the following configuration will analyze only Go, and JavaScript. + + ```yaml + strategy: + fail-fast: false + matrix: + # Override automatic language detection by changing the list below + # Supported options are: + # ['csharp', 'cpp', 'go', 'java', 'javascript', 'python'] + language: ['go', 'javascript'] + ``` +For more information, see the workflow extract in "[Automatic build for a compiled language fails](#automatic-build-for-a-compiled-language-fails)" above. +1. Your {% data variables.product.prodname_code_scanning %} workflow is analyzing a compiled language (C, C++, C#, or Java), but the code was not compiled. By default, the {% data variables.product.prodname_codeql %} analysis workflow contains an `autobuild` step, however, this step represents a best effort process, and may not succeed in building your code, depending on your specific build environment. Compilation may also fail if you have removed the `autobuild` step and did not include build steps manually. For more information about specifying build steps, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." +1. Your workflow is analyzing a compiled language (C, C++, C#, or Java), but portions of your build are cached to improve performance (most likely to occur with build systems like Gradle or Bazel). Since {% data variables.product.prodname_codeql %} observes the activity of the compiler to understand the data flows in a repository, {% data variables.product.prodname_codeql %} requires a complete build to take place in order to perform analysis. +1. Your workflow is analyzing a compiled language (C, C++, C#, or Java), but compilation does not occur between the `init` and `analyze` steps in the workflow. {% data variables.product.prodname_codeql %} requires that your build happens in between these two steps in order to observe the activity of the compiler and perform analysis. +1. Your compiled code (in C, C++, C#, or Java) was compiled successfully, but {% data variables.product.prodname_codeql %} was unable to detect the compiler invocations. The most common causes are certain configuration options like running your build process in a container, if you're building using a distributed build system external to {% data variables.product.prodname_actions %} using a daemon process, or if {% data variables.product.prodname_codeql %} isn't aware of the specific compiler you are using. + + For C# projects using either `dotnet build` or `msbuild` which target .NET Core 2, you should specify `/p:UseSharedCompilation=false` in your workflow's `run` step, when you build your code. The `UseSharedCompilation` flag isn't necessary for .NET Core 3.0 and later. + + For example, the following configuration for C# will pass the flag during the first build step. + + ``` yaml + - run: | + dotnet build /p:UseSharedCompilation=false + ``` + + If you encounter another problem with your specific compiler or configuration, contact {% data variables.contact.contact_support %}. + +For more information about specifying build steps, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." + +### Portions of my repository were not analyzed using `autobuild` + +The {% data variables.product.prodname_codeql %} `autobuild` feature uses heuristics to build the code in a repository, however, sometimes this approach results in incomplete analysis of a repository. For example, when multiple `build.sh` commands exist in a single repository, the analysis may not complete since the `autobuild` step will only execute one of the commands. The solution is to replace the `autobuild` step with build steps which build all of the source code which you wish to analyze. For more information, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." + +### Error: "Server error" + +If the run of a workflow for {% data variables.product.prodname_code_scanning %} fails due to a server error, try running the workflow again. If the problem persists, contact {% data variables.contact.contact_support %}. + +### Error: "Out of disk" or "Out of memory" + +On very large projects, {% data variables.product.prodname_codeql %} may run out of disk or memory on the runner. +{% if currentVersion == "free-pro-team@latest" %}If you encounter this issue on a hosted {% data variables.product.prodname_actions %} runner, contact {% data variables.contact.contact_support %} so that we can investigate the problem. +{% else %}If you encounter this issue, try increasing the memory on the runner.{% endif %} + +### The build takes too long + +If your build with {% data variables.product.prodname_codeql %} analysis takes too long to run, there are several approaches you can try to reduce the build time. + +#### Increase the memory or cores + +If you use self-hosted runners to run {% data variables.product.prodname_codeql %} analysis, you can increase the memory or the number of cores on those runners. + +#### Use matrix builds to parallelize the analysis + +The default {% data variables.product.prodname_codeql_workflow %} uses a build matrix of languages, which causes the analysis of each language to run in parallel. If you have specified the languages you want to analyze directly in the "Initialize CodeQL" step, analysis of each language will happen sequentially. To speed up analysis of multiple languages, modify your workflow to use a matrix. For more information, see the workflow extract in "[Automatic build for a compiled language fails](#automatic-build-for-a-compiled-language-fails)" above. + +#### Reduce the amount of code being analyzed in a single workflow + +Analysis time is typically proportional to the amount of code being analyzed. You can reduce the analysis time by reducing the amount of code being analyzed at once, for example, by excluding test code, or breaking analysis into multiple workflows that analyze only a subset of your code at a time. + +For compiled languages like Java, C, C++, and C#, {% data variables.product.prodname_codeql %} analyzes all of the code which was built during the workflow run. To limit the amount of code being analyzed, build only the code which you wish to analyze by specifying your own build steps in a `run` block. You can combine specifying your own build steps with using the `paths` or `paths-ignore` filters on the `pull_request` and `push` events to ensure that your workflow only runs when specific code is changed. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)." + +For interpreted languages like Go, JavaScript, Python, and TypeScript, that {% data variables.product.prodname_codeql %} analyzes without a specific build, you can specify additional configuration options to limit the amount of code to analyze. For more information, see "[Specifying directories to scan](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#specifying-directories-to-scan)." + +If you split your analysis into multiple workflows as described above, we still recommend that you have at least one workflow which runs on a `schedule` which analyzes all of the code in your repository. Because {% data variables.product.prodname_codeql %} analyzes data flows between components, some complex security behaviors may only be detected on a complete build. + +#### Run only during a `schedule` event + +If your analysis is still too slow to be run during `push` or `pull_request` events, then you may want to only trigger analysis on the `schedule` event. For more information, see "[Events](/actions/learn-github-actions/introduction-to-github-actions#events)." + +{% if currentVersion == "free-pro-team@latest" %} +### Results differ between analysis platforms + +If you are analyzing code written in Python, you may see different results depending on whether you run the {% data variables.product.prodname_codeql_workflow %} on Linux, macOS, or Windows. + +On GitHub-hosted runners that use Linux, the {% data variables.product.prodname_codeql_workflow %} tries to install and analyze Python dependencies, which could lead to more results. To disable the auto-install, add `setup-python-dependencies: false` to the "Initialize CodeQL" step of the workflow. For more information about configuring the analysis of Python dependencies, see "[Analyzing Python dependencies](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#analyzing-python-dependencies)." + +{% endif %} \ No newline at end of file diff --git a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md index f677f6c6ba16..23f0938c8e5e 100644 --- a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md +++ b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md @@ -16,20 +16,20 @@ versions: ### Sobre os uploads de arquivos SARIF para {% data variables.product.prodname_code_scanning %} -O {% data variables.product.prodname_dotcom %} cria alertas de {% data variables.product.prodname_code_scanning %} em um repositório usando informações de arquivos de Formato Intercâmbio de Resultados de Análise Estática (SARIF). Os arquivos SARIF podem ser enviados para um repositório usando a API ou {% data variables.product.prodname_actions %}. Para obter mais informações, consulte "[Gerenciando alertas do {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." +O {% data variables.product.prodname_dotcom %} cria alertas de {% data variables.product.prodname_code_scanning %} em um repositório usando informações de arquivos de Formato Intercâmbio de Resultados de Análise Estática (SARIF). Os arquivos SARIF podem ser enviados para um repositório usando a API ou {% data variables.product.prodname_actions %}. Para obter mais informações, consulte "[Gerenciar alertas de {% data variables.product.prodname_code_scanning %} para o seu repositório](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)". Você pode gerar arquivos SARIF usando muitas ferramentas de teste de segurança de análise estática, incluindo {% data variables.product.prodname_codeql %}. Para fazer o upload dos resultados das ferramentas de terceiros, você deve usar o formato Intercâmbio de Resultados de Análise Estática (SARIF) 2.1.0. Para obter mais informações, consulte "[Sobre o suporte do SARIF para a varredura de código](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-sarif-support-for-code-scanning)". -Você pode enviar os resultados usando {% data variables.product.prodname_actions %}{% if currentVersion == "enterprise-server@2.22" %} (disponível se a sua organização está participando do programa beta){% endif %}, a API de {% data variables.product.prodname_code_scanning %} ou {% data variables.product.prodname_codeql_runner %}. O melhor método de upload dependerá de como você gera o arquivo SARIF. Por exemplo, se você usar: +Você pode fazer o upload dos resultados usando {% data variables.product.prodname_actions %}{% if currentVersion == "enterprise-server@2. 2" %} (disponível se sua organização participa do programa beta){% endif %}, a API de {% data variables.product.prodname_code_scanning %} ou {% data variables.product.prodname_codeql_runner %}. O melhor método de upload dependerá de como você gera o arquivo SARIF. Por exemplo, se você usar: - {% data variables.product.prodname_actions %} para executar a ação {% data variables.product.prodname_codeql %}, não haverá nenhuma ação adicional necessária. A ação {% data variables.product.prodname_codeql %} faz o upload do arquivo SARIF automaticamente quando ele conclui a análise. - O arquivo SARIF pode ser gerado a partir de uma ferramenta de análise compatível com o SARIF, que você executa no mesmo fluxo de trabalho de {% data variables.product.prodname_actions %} usado para fazer o upload do arquivo. -- {% data variables.product.prodname_dotcom %} exibirá alertas de {% data variables.product.prodname_code_scanning %} do arquivo SARIF carregado em seu repositório. Para obter mais informações, consulte "[Gerenciando alertas do {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." +- {% data variables.product.prodname_dotcom %} exibirá alertas de {% data variables.product.prodname_code_scanning %} do arquivo SARIF carregado em seu repositório. Se você bloquear o upload automático, quando você estiver pronto para fazer o upload de resultados, você poderá usar o comando `upload` (para obter mais informações, consulte "[Executar {% data variables.product.prodname_code_scanning %} no seu sistema de CI](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)"). - Uma ferramenta que gera resultados como um artefato fora do seu repositório, você pode usar a API de {% data variables.product.prodname_code_scanning %} para fazer o upload do arquivo (para obter mais informações, consulte "[Fazer o upload de um arquivo SARIF](/rest/reference/code-scanning#upload-a-sarif-file)"). ### Fazer o upload uma análise de {% data variables.product.prodname_code_scanning %} com {% data variables.product.prodname_actions %} -Para fazer o upload de um arquivo SARIF de terceiros para {% data variables.product.prodname_dotcom %}, você precisará de um fluxo de trabalho de {% data variables.product.prodname_actions %}. Para obter mais informações, consulte "[Sobre o {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)" e "[Configurar um fluxo de trabalho](/actions/configuring-and-managing-workflows/configuring-a-workflow)". +Para fazer o upload de um arquivo SARIF de terceiros para {% data variables.product.prodname_dotcom %}, você precisará de um fluxo de trabalho de {% data variables.product.prodname_actions %}. Para obter mais informações, consulte "[Aprender {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)" e "[Aprender {% data variables.product.prodname_actions %}](/actions/learn-github-actions)". O seu fluxo de trabalho precisará usar a ação `upload-sarif`, que tem parâmetros de entrada que você pode usar para configurar o upload. Ele tem parâmetros de entrada que você pode usar para configurar o upload. O parâmetro de entrada principal que você usará é `sarif-file`, que configura o arquivo ou diretório dos arquivos SARIF a serem carregados. O diretório ou caminho do arquivo é relativo à raiz do repositório. Para mais informações, consulte a ação [`upload-sarif`](https://github.com/github/codeql-action/tree/HEAD/upload-sarif). @@ -43,7 +43,7 @@ Você pode criar um novo fluxo de trabalho que faz o upload de arquivos SARIF ap Este exemplo de fluxo de trabalho é executado sempre que os commits são carregados no repositório. A ação usa a propriedade `partialFingerprints` para determinar se houve alterações. Além de executar quando os commits são carregados, o fluxo de trabalho está programado para ser executado uma vez por semana. Para obter mais informações, consulte "[Eventos que acionam fluxos de trabalho](/actions/reference/events-that-trigger-workflows)". -Este fluxo de trabalho faz o upload do arquivo `results.sarif` localizado na raiz do repositório. Para obter mais informações sobre a criação de um arquivo de fluxo de trabalho, consulte "[Configurar um fluxo de trabalho](/actions/configuring-and-managing-workflows/configuring-a-workflow)". +Este fluxo de trabalho faz o upload do arquivo `results.sarif` localizado na raiz do repositório. Para obter mais informações sobre a criação de um arquivo de fluxo de trabalho, consulte "[Aprender {% data variables.product.prodname_actions %}](/actions/learn-github-actions)". Como alternativa, você pode modificar este fluxo de trabalho para fazer upload de um diretório de arquivos SARIF. Por exemplo, você pode colocar todos os arquivos SARIF em um diretório na raiz do seu repositório denominado `sarif-output` e definir o parâmetro de entrada da ação `sarif_file` como `sarif-output`. @@ -73,11 +73,11 @@ jobs: #### Exemplo de fluxo de trabalho que executa a ferramenta de análise ESLint -Se você gerar seu arquivo SARIF de terceiros como parte de um fluxo de trabalho de integração contínua (CI), você poderá adicionar a ação `upload-sarif` como um passo depois de executar seus testes de CI. Se você ainda não tiver um fluxo de trabalho de CI, você poderá criar um usando um modelo de {% data variables.product.prodname_actions %}. Para obter mais informações, consulte "[Iniciando com modelos de fluxo de trabalho pré-configurados](/actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates)". +Se você gerar seu arquivo SARIF de terceiros como parte de um fluxo de trabalho de integração contínua (CI), você poderá adicionar a ação `upload-sarif` como um passo depois de executar seus testes de CI. Se você ainda não tiver um fluxo de trabalho de CI, você poderá criar um usando um modelo de {% data variables.product.prodname_actions %}. Para obter mais informações, consulte o início rápido "[{% data variables.product.prodname_actions %}](/actions/quickstart)". Este exemplo de fluxo de trabalho é executado sempre que os commits são carregados no repositório. A ação usa a propriedade `partialFingerprints` para determinar se houve alterações. Além de executar quando os commits são carregados, o fluxo de trabalho está programado para ser executado uma vez por semana. Para obter mais informações, consulte "[Eventos que acionam fluxos de trabalho](/actions/reference/events-that-trigger-workflows)". -O fluxo de trabalho mostra um exemplo de execução da ferramenta de análise estática ESLint como uma etapa de um fluxo de trabalho. A etapa `Executar ESLint` executa a ferramenta ESLint e produz o arquivo `results.sarif`. Em seguida, o fluxo de trabalho faz o upload do arquivo `results.sarif` para {% data variables.product.prodname_dotcom %} usando a ação `upload-sarif`. Para obter mais informações sobre a criação de um arquivo de fluxo de trabalho, consulte "[Configurar um fluxo de trabalho](/actions/configuring-and-managing-workflows/configuring-a-workflow)". +O fluxo de trabalho mostra um exemplo de execução da ferramenta de análise estática ESLint como uma etapa de um fluxo de trabalho. A etapa `Executar ESLint` executa a ferramenta ESLint e produz o arquivo `results.sarif`. Em seguida, o fluxo de trabalho faz o upload do arquivo `results.sarif` para {% data variables.product.prodname_dotcom %} usando a ação `upload-sarif`. Para obter mais informações sobre a criação de um arquivo de fluxo de trabalho, consulte "[Introdução ao GitHub Actions](/actions/learn-github-actions/introduction-to-github-actions)". ```yml name: "ESLint analysis" @@ -109,6 +109,6 @@ jobs: ### Leia mais - "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions)" -- [Gerenciar a execução de fluxos de trabalho](/actions/configuring-and-managing-workflows/managing-a-workflow-run#viewing-your-workflow-history) -- "[Executar {% data variables.product.prodname_code_scanning %} no seu sistema de CI](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)" +- "[Visualizar o seu histórico de fluxo de trabalho](/actions/managing-workflow-runs/viewing-workflow-run-history)" +- "[Executar {% data variables.product.prodname_code_scanning %} no seu sistema de CI](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)" - "[Fazer o upload de um arquivo SARIF](/rest/reference/code-scanning#upload-a-sarif-file)" diff --git a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md new file mode 100644 index 000000000000..e0a110c8a745 --- /dev/null +++ b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md @@ -0,0 +1,11 @@ +--- +title: Usar a varredura de código do CodeQL com o seu sistema CI existente +shortTitle: Suporte ao sistema do CodeQL de CI +intro: 'O {% data variables.product.prodname_codeql_runner %} permite usar seu sistema de CI existente para executar {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %}.' +mapTopic: true +product: '{% data reusables.gated-features.code-scanning %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + diff --git a/translations/pt-BR/content/github/getting-started-with-github/access-permissions-on-github.md b/translations/pt-BR/content/github/getting-started-with-github/access-permissions-on-github.md index 92896426f65f..51e292622f8c 100644 --- a/translations/pt-BR/content/github/getting-started-with-github/access-permissions-on-github.md +++ b/translations/pt-BR/content/github/getting-started-with-github/access-permissions-on-github.md @@ -17,7 +17,7 @@ Um repositório pertencente a uma conta de usuário tem dois níveis de permiss ### Contas da organização -Os integrantes da organização podem ter funções de *proprietário*{% if currentVersion == "free-pro-team@latest" %}, *gerente de cobrança*{% endif %} ou *integrante*. Os proprietários têm acesso administrativo completo à sua organização{% if currentVersion == "free-pro-team@latest" %}, enquanto os gerentes de cobrança podem gerenciar configurações de cobrança{% endif %}. O integrante é a função padrão de todos os outros. Você pode gerenciar as permissões de acesso para vários integrantes por vez com equipes. Para obter mais informações, consulte: +Os integrantes da organização podem ter funções de *proprietário*{% if currentVersion == "free-pro-team@latest" %}, *gerente de cobrança*,{% endif %} ou *integrante*. Os proprietários têm acesso pleno à organização{% if currentVersion == "free-pro-team@latest" %}, enquanto os gerentes de cobrança podem gerenciar as configurações de cobrança{% endif %}. O integrante é a função padrão de todos os outros. Você pode gerenciar as permissões de acesso para vários integrantes por vez com equipes. Para obter mais informações, consulte: - "[Níveis de permissão para uma organização](/articles/permission-levels-for-an-organization)" - "[Permissões de quadro de projeto para uma organização](/articles/project-board-permissions-for-an-organization)" - "[Níveis de permissão do repositório para uma organização](/articles/repository-permission-levels-for-an-organization)" diff --git a/translations/pt-BR/content/github/getting-started-with-github/be-social.md b/translations/pt-BR/content/github/getting-started-with-github/be-social.md index a590974f24c0..bea76619a431 100644 --- a/translations/pt-BR/content/github/getting-started-with-github/be-social.md +++ b/translations/pt-BR/content/github/getting-started-with-github/be-social.md @@ -21,7 +21,7 @@ Clique em **Follow** (Seguir) na página do perfil de uma pessoa para segui-la. ### Inspecionar um repositório -Você pode inspecionar um repositório para receber notificações de novos problemas e pull requests. Quando o proprietário atualiza o repositório, você vê as alterações no seu painel pessoal. Para obter mais informações, consulte {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[Visualizando suas assinaturas](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions){% else %}"[Assistindo e desassistindo repositórios](/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories){% endif %}." +Você pode inspecionar um repositório para receber notificações de novos problemas e pull requests. Quando o proprietário atualiza o repositório, você vê as alterações no seu painel pessoal. Para obter mais informações, consulte {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 0" %}"[Visualizar suas assinaturas](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions){% else %}"[Inspecionar e não inspecionar repositórios](/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories){% endif %}." Clique em **Watch** (Inspecionar) no topo de um repositório para inspecioná-lo. diff --git a/translations/pt-BR/content/github/getting-started-with-github/create-a-repo.md b/translations/pt-BR/content/github/getting-started-with-github/create-a-repo.md index 71135474f701..2205deccd848 100644 --- a/translations/pt-BR/content/github/getting-started-with-github/create-a-repo.md +++ b/translations/pt-BR/content/github/getting-started-with-github/create-a-repo.md @@ -19,7 +19,9 @@ Você pode armazenar vários projetos nos repositórios do {% data variables.pro {% data reusables.repositories.create_new %} 2. Digite um nome curto e fácil de memorizar para seu repositório. Por exemplo, "olá mundo". ![Campo para inserir um nome de repositório](/assets/images/help/repository/create-repository-name.png) -3. Se desejar, adicione uma descrição do repositório. Por exemplo, "Meu primeiro repositório no {% data variables.product.product_name %}". ![Campo para inserir uma descrição do repositório](/assets/images/help/repository/create-repository-desc.png) +3. Se desejar, adicione uma descrição do repositório. Por exemplo, "Meu primeiro repositório no +{% data variables.product.product_name %}." + ![Campo para inserir uma descrição do repositório](/assets/images/help/repository/create-repository-desc.png) {% data reusables.repositories.choose-repo-visibility %} {% data reusables.repositories.initialize-with-readme %} {% data reusables.repositories.create-repo %} diff --git a/translations/pt-BR/content/github/getting-started-with-github/following-people.md b/translations/pt-BR/content/github/getting-started-with-github/following-people.md index 6655966934b5..1e1521428643 100644 --- a/translations/pt-BR/content/github/getting-started-with-github/following-people.md +++ b/translations/pt-BR/content/github/getting-started-with-github/following-people.md @@ -1,6 +1,6 @@ --- title: Seguir pessoas -intro: 'É possível seguir pessoas em {% data variables.product.product_name %} para receber notificações sobre as atividades delas {% if currentVersion == "free-pro-team@latest" %} e descobrir projetos nas comunidades em que elas estão inseridas.{% endif %}.' +intro: 'Você pode seguir pessoas em {% data variables.product.product_name %} para receber notificações sobre sua atividade{% if currentVersion == "free-pro-team@latest" %} e descobrir projetos nas suas comunidades{% endif %}.' redirect_from: - /articles/following-people versions: @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -Você verá as atividades públicas das pessoas que você segue na visualização de atividades do feed de notícias.{% if currentVersion == "free-pro-team@latest" %} Se alguém que você segue coloca uma estrela em um repositório público, o {% data variables.product.product_name %} pode reomendá-lo a você nas visualizações de descobertas do seu feed de notícias.{% endif %} Para seguir alguém, vá até a página de perfil da pessoa e clique em **Follow** (Seguir) abaixo da imagem de perfil. +Ao seguir pessoas, você verá sua atividade pública na exibição de atividades do seu feed de notícias.{% if currentVersion == "free-pro-team@latest" %} Se alguém que você segue favoritar um repositório público, {% data variables.product.product_name %} pode recomendar o repositório para você na visualização de descoberta do seu feed de notícias.{% endif %} Para seguir alguém, visite sua página de perfil e clique em **Seguir** na imagem de perfil. ![Botão Follow user (Seguir usuário)](/assets/images/help/profile/follow-user-button.png) diff --git a/translations/pt-BR/content/github/getting-started-with-github/fork-a-repo.md b/translations/pt-BR/content/github/getting-started-with-github/fork-a-repo.md index 27fff817005e..e02475118ca9 100644 --- a/translations/pt-BR/content/github/getting-started-with-github/fork-a-repo.md +++ b/translations/pt-BR/content/github/getting-started-with-github/fork-a-repo.md @@ -61,7 +61,9 @@ Se ainda não o fez, primeiro [configure o Git](/articles/set-up-git). Lembre-se Agora você tem uma bifurcação do repositório Spoon-Knife, mas não os arquivos daquele repositório em seu computador. Vamos criar um clone da sua bifurcação localmente em seu computador. -1. Em {% data variables.product.product_name %}, vá até **your fork** (sua bifurcação) no repositório Spoon-Knife. +1. Em + +{% data variables.product.product_name %}, acesse a **sua bifurcação** do repositório Spoon-Knife. {% data reusables.repositories.copy-clone-url %} {% data reusables.command_line.open_the_multi_os_terminal %} {% data reusables.command_line.change-current-directory-clone %} @@ -86,7 +88,9 @@ Agora você já tem uma cópia local de sua bifurcação do repositório Spoon-K Ao bifurcar um projeto para propor mudanças no repositório original, é possível configurar o Git para fazer pull de mudanças do repositório original ou upstream no clone local de sua bifurcação. -1. Em {% data variables.product.product_name %}, vá até o repositório [octocat/Spoon-Knife](https://github.com/octocat/Spoon-Knife). +1. Em + +{% data variables.product.product_name %}, acesse o repositório [octocat/Spoon-Knife](https://github.com/octocat/Spoon-Knife). {% data reusables.repositories.copy-clone-url %} {% data reusables.command_line.open_the_multi_os_terminal %} 4. Mude os diretórios do local que você clonou a bifurcação na [Etapa 2: Crie um clone local de sua bifurcação](#step-2-create-a-local-clone-of-your-fork). @@ -128,7 +132,7 @@ Você pode fazer alterações em uma bifurcação, incluindo: Bifurque um repositório para começar a contribuir com um projeto. {% data reusables.repositories.you-can-fork %} -{% if currentVersion == "free-pro-team@latest" %}Você pode navegar em [Explore](https://github.com/explore) (Explorar) para encontrar projetos e começar a contribuir com repositórios de código aberto. Para obter mais informações, consulte "[Encontrar maneiras de contribuir para o código aberto em {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)." +{% if currentVersion == "free-pro-team@latest" %}Você pode procurar [Explorar](https://github.com/explore) para encontrar projetos e começar a contribuir para repositórios de código aberto. Para obter mais informações, consulte "[Encontrar maneiras de contribuir para o código aberto em {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)." {% endif %} diff --git a/translations/pt-BR/content/github/getting-started-with-github/git-and-github-learning-resources.md b/translations/pt-BR/content/github/getting-started-with-github/git-and-github-learning-resources.md index 38d32e57fed4..bbc9a758202e 100644 --- a/translations/pt-BR/content/github/getting-started-with-github/git-and-github-learning-resources.md +++ b/translations/pt-BR/content/github/getting-started-with-github/git-and-github-learning-resources.md @@ -54,6 +54,6 @@ O {% data variables.product.prodname_dotcom %} oferece [aulas presenciais](https Um [curso online e interativo sobre o Git](http://www.codeschool.com/courses/git-real) da [Code School](http://codeschool.com) tem sete níveis com dezenas de exercícios em formato de jogos divertidos. Fique à vontade para adaptar nossos [modelos .gitignore](https://github.com/github/gitignore) de acordo com as suas necessidades. -Amplie seu alcance {% data variables.product.prodname_dotcom %} com {% if currentVersion == "free-pro-team@latest" %}[integrações](/articles/about-integrations){% else %}integrações{% endif %} ou instalando [{% data variables.product.prodname_desktop %}](https://desktop.github.com) o robusto editor de texto [Atom](https://atom.io). +Estenda o seu alcance de {% data variables.product.prodname_dotcom %} por meio de {% if currentVersion == "free-pro-team@latest" %}[integrações](/articles/about-integrations){% else %}integrações{% endif %}, ou instalando [{% data variables.product.prodname_desktop %}](https://desktop.github.com) e o robusto editor de texto [Atom](https://atom.io). Saiba como iniciar e desenvolver seu projeto de código aberto em [Open Source Guides](https://opensource.guide/) (Guias de Código aberto). diff --git a/translations/pt-BR/content/github/getting-started-with-github/github-for-mobile.md b/translations/pt-BR/content/github/getting-started-with-github/github-for-mobile.md index fbbdc92d93fa..573806c84a69 100644 --- a/translations/pt-BR/content/github/getting-started-with-github/github-for-mobile.md +++ b/translations/pt-BR/content/github/getting-started-with-github/github-for-mobile.md @@ -23,6 +23,16 @@ Para mais informações sobre notificações para {% data variables.product.prod Para instalar {% data variables.product.prodname_mobile %} para Android ou iOS, consulte [{% data variables.product.prodname_mobile %}](https://github.com/mobile). +### Idiomas compatíveis com {% data variables.product.prodname_mobile %} + +{% data variables.product.prodname_mobile %} está disponível nos seguintes idiomas. + +- Japanese +- Português do Brasil +- Spanish + +Se você configurar o idioma do seu dispositivo para um idioma compatível, {% data variables.product.prodname_mobile %} será o idioma-padrão. Você pode alterar o idioma para {% data variables.product.prodname_mobile %} no no menu **Configurações** de {% data variables.product.prodname_mobile %}. + ### Gerenciando links universais para {% data variables.product.prodname_mobile %} no iOS {% data variables.product.prodname_mobile %} ativa automaticamente o Universal Links para iOS. Quando você clica em qualquer link {% data variables.product.product_name %}, a URL de destino vai abrir em {% data variables.product.prodname_mobile %} em vez do Safari. Para obter mais informações, consulte [Universal Links](https://developer.apple.com/ios/universal-links/) no site de desenvolvedor da Apple diff --git a/translations/pt-BR/content/github/getting-started-with-github/githubs-products.md b/translations/pt-BR/content/github/getting-started-with-github/githubs-products.md index edca58c98a08..06bb3eaa00a9 100644 --- a/translations/pt-BR/content/github/getting-started-with-github/githubs-products.md +++ b/translations/pt-BR/content/github/getting-started-with-github/githubs-products.md @@ -96,7 +96,7 @@ O {% data variables.product.prodname_ghe_one %} inclui [{% data variables.produc - {% data variables.contact.github_support %} {% data variables.product.premium_plus_support_plan %} - {% data variables.product.prodname_insights %} -- {% data variables.product.prodname_advanced_security %} +- {% data variables.product.prodname_advanced_security %}{% if currentVersion == "free-pro-team@latest" %}. Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)" e "[Sobre {% data variables.product.prodname_secret_scanning %}](/github/administering-a-repository/about-secret-scanning) (beta).{% endif %}{% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %}. Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning) (beta)."{% endif %} - [{% data variables.product.prodname_learning %} para organizações](https://lab.github.com/organizations) Para obter mais informações sobre a inscrição em {% data variables.product.prodname_ghe_one %}, entre em contato com a equipe de vendas do [{% data variables.product.product_name %}](https://enterprise.github.com/contact). diff --git a/translations/pt-BR/content/github/getting-started-with-github/keyboard-shortcuts.md b/translations/pt-BR/content/github/getting-started-with-github/keyboard-shortcuts.md index c8edaa56b98b..890bd0f8078d 100644 --- a/translations/pt-BR/content/github/getting-started-with-github/keyboard-shortcuts.md +++ b/translations/pt-BR/content/github/getting-started-with-github/keyboard-shortcuts.md @@ -20,22 +20,22 @@ Veja abaixo uma lista dos atalhos de teclado disponíveis. ### Atalhos para o site -| Atalho | Descrição | -| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| s or / | Evidencia a barra de pesquisa. For more information, see "[About searching on {% data variables.product.company_short %}](/articles/about-searching-on-github)." | -| g n | Vai para suas notificações. Para obter mais informações, consulte {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[Sobre notificações](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}"[Sobre notificações](/github/receiving-notifications-about-activity-on-github/about-notifications)"{% endif %}." | -| esc | Quando direcionado a um hovercard de usuário, problema ou pull request, fecha o hovercard e redireciona para o elemento no qual o hovercard está | +| Atalho | Descrição | +| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| s or / | Evidencia a barra de pesquisa. Para obter mais informações, consulte "[Sobre pesquisar no {% data variables.product.company_short %}](/articles/about-searching-on-github)". | +| g n | Vai para suas notificações. Para obter mais informações, consulte {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 0" %}"[Sobre as notificações](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}"[Sobre as notificações](/github/receiving-notifications-about-activity-on-github/about-notifications){% endif %}". | +| esc | Quando direcionado a um hovercard de usuário, problema ou pull request, fecha o hovercard e redireciona para o elemento no qual o hovercard está | ### Repositórios -| Atalho | Descrição | -| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | -| g c | Vai para a aba **Code** (Código) | -| g i | Vai para a aba **Issues** (Problemas). Para obter mais informações, consulte "[Sobre problemas](/articles/about-issues)". | -| g p | Vai para a aba **Pull requests**. Para obter mais informações, consulte "[Sobre pull requests](/articles/about-pull-requests)". | -| g a | Acesse a aba de **Ações**. Para obter mais informações, consulte "[Sobre ações](/actions/getting-started-with-github-actions/about-github-actions)". | -| g b | Vai para a aba **Projects** (Projetos). Para obter mais informações, consulte "[Sobre quadros de projeto](/articles/about-project-boards)". | -| g w | Vai para a aba **Wiki**. Para obter mais informações, consulte "[Sobre wikis](/articles/about-wikis)". | +| Atalho | Descrição | +| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| g c | Vai para a aba **Code** (Código) | +| g i | Vai para a aba **Issues** (Problemas). Para obter mais informações, consulte "[Sobre problemas](/articles/about-issues)". | +| g p | Vai para a aba **Pull requests**. Para obter mais informações, consulte "[Sobre pull requests](/articles/about-pull-requests)."{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} +| g a | Acesse a aba de **Ações**. Para obter mais informações, consulte "[Sobre ações](/actions/getting-started-with-github-actions/about-github-actions)".{% endif %} +| g b | Vai para a aba **Projects** (Projetos). Para obter mais informações, consulte "[Sobre quadros de projeto](/articles/about-project-boards)". | +| g w | Vai para a aba **Wiki**. Para obter mais informações, consulte "[Sobre wikis](/articles/about-wikis)". | ### Edição de código-fonte @@ -67,16 +67,16 @@ Para mais atalhos de teclado, consulte a [Documentação CodeMirror](https://cod ### Comentários -| Atalho | Descrição | -| -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| control b ou command b | Insere formatação Markdown para texto em negrito | -| control i ou command i | Insere formatação Markdown para texto em itálico | -| control k ou command k | Insere formatação Markdown para criar um link | -| control shift p ou command shift p | Alterna entre as abas de comentários **Write** (Escrever) e **Preview** (Visualizar) | -| control enter | Envia um comentário | -| control . e control [número de resposta salvo] | Abre o menu de respostas salvas e autocompleta o campo de comentário com uma resposta salva. Para obter mais informações, consulte "[Sobre respostas salvas](/articles/about-saved-replies)".{% if currentVersion == "free-pro-team@latest" %} +| Atalho | Descrição | +| -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| control b ou command b | Insere formatação Markdown para texto em negrito | +| control i ou command i | Insere formatação Markdown para texto em itálico | +| control k ou command k | Insere formatação Markdown para criar um link | +| control shift p ou command shift p | Alterna entre as abas de comentários **Write** (Escrever) e **Preview** (Visualizar) | +| control enter | Envia um comentário | +| control . e control [número de resposta salvo] | Abre o menu de respostas salvas e autocompleta o campo de comentário com uma resposta salva. Para obter mais informações, consulte "[Sobre respostas salvas](/articles/about-saved-replies)."{% if currentVersion == "free-pro-team@latest" %} | control g ou command g | Insere uma sugestão. Para obter mais informações, consulte "[Revisar alterações propostas em uma pull request](/articles/reviewing-proposed-changes-in-a-pull-request)". |{% endif %} -| r | Cita o texto selecionado em sua resposta. Para obter mais informações, consulte "[Sintaxe básica de gravação e formatação](/articles/basic-writing-and-formatting-syntax#quoting-text)". | +| r | Cita o texto selecionado em sua resposta. Para obter mais informações, consulte "[Sintaxe básica de gravação e formatação](/articles/basic-writing-and-formatting-syntax#quoting-text)". | ### Listas de problemas e pull requests @@ -92,13 +92,13 @@ Para mais atalhos de teclado, consulte a [Documentação CodeMirror](https://cod | o ou enter | Abre um problema | ### Problemas e pull requests -| Atalho | Descrição | -| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| q | Solicita um revisor. Para obter mais informações, consulte "[Solicitar uma revisão de pull request](/articles/requesting-a-pull-request-review/)". | -| m | Define um marco. Para obter mais informações, consulte "[Associar marcos a problemas e pull requests](/articles/associating-milestones-with-issues-and-pull-requests/)". | -| l | Aplica uma etiqueta. Para obter mais informações, consulte "[Aplicar etiquetas a problemas e pull requests](/articles/applying-labels-to-issues-and-pull-requests/)". | +| Atalho | Descrição | +| ------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| q | Solicita um revisor. Para obter mais informações, consulte "[Solicitar uma revisão de pull request](/articles/requesting-a-pull-request-review/)". | +| m | Define um marco. Para obter mais informações, consulte "[Associar marcos a problemas e pull requests](/articles/associating-milestones-with-issues-and-pull-requests/)". | +| l | Aplica uma etiqueta. Para obter mais informações, consulte "[Aplicar etiquetas a problemas e pull requests](/articles/applying-labels-to-issues-and-pull-requests/)". | | a | Define um responsável. Para obter mais informações, consulte "[Atribuir problemas e pull requests a outros usuários {% data variables.product.company_short %}](/articles/assigning-issues-and-pull-requests-to-other-github-users/)". | -| cmd + shift + p ou control + shift + p | Alterna entre as abas **Write** (Escrever) e **Preview** (Visualizar) | +| cmd + shift + p ou control + shift + p | Alterna entre as abas **Write** (Escrever) e **Preview** (Visualizar) | ### Alterações em pull requests @@ -109,7 +109,7 @@ Para mais atalhos de teclado, consulte a [Documentação CodeMirror](https://cod | j | Move a seleção para baixo na lista | | k | Move a seleção para cima na lista | | cmd + shift + enter | Adiciona um comentário único no diff da pull request | -| alt e clique | Alterna entre opções de recolhimento e expansão de todos os comentários de revisão desatualizados em uma pull request ao manter pressionada a tecla `alt` e clicar em **Mostrar desatualizados** ou **Ocultar desatualizados**.|{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +| alt e clique | Alterna entre recolhimento e expansão de todos os comentários de revisão desatualizados em um pull request ao manter pressionada a tecla `alt` e clicar em **Mostrar desatualizado** ou **Ocultar desatualizado**. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} | Clique, em seguida shift e clique | Comente em várias linhas de uma pull request clicando em um número de linha, mantendo pressionado shift, depois clique em outro número de linha. Para obter mais informações, consulte "[Comentando em uma pull request](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request#adding-line-comments-to-a-pull-request)."|{% endif %} ### Quadros de projeto diff --git a/translations/pt-BR/content/github/getting-started-with-github/saving-repositories-with-stars.md b/translations/pt-BR/content/github/getting-started-with-github/saving-repositories-with-stars.md index daf562de91ae..41b1fa0a47e6 100644 --- a/translations/pt-BR/content/github/getting-started-with-github/saving-repositories-with-stars.md +++ b/translations/pt-BR/content/github/getting-started-with-github/saving-repositories-with-stars.md @@ -1,6 +1,6 @@ --- title: Salvar repositórios com estrelas -intro: 'Você pode salvar repositórios{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.16" %} e tópicos{% endif %} com estrelas para monitorar os projetos que considerar interessantes,{% if currentVersion == "free-pro-team@latest" %} e descobrir conteúdo relacionado no seu feed de notícias{% endif %}.' +intro: 'Você pode favoritar repositórios{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 6" %} e tópicos{% endif %} para acompanhar os projetos que você considera interessantes{% if currentVersion == "free-pro-team@latest" %} e descobrir o conteúdo relacionado no feed de notícias{% endif %}.' redirect_from: - /articles/stars/ - /articles/about-stars/ @@ -19,7 +19,8 @@ Você pode pesquisar, classificar e filtrar seus repositórios e tópicos com es A estrela facilita a localização posterior de um repositório ou tópico. Você pode ver todos os repositórios e tópicos marcados com estrelas acessando sua {% data variables.explore.your_stars_page %}. {% if currentVersion == "free-pro-team@latest" %} -Você pode marcar repositórios e tópicos com estrelas para descobrir projetos similares no {% data variables.product.product_name %}. Quando você marca repositórios ou tópicos com estrelas, o {% data variables.product.product_name %} pode recomendar um conteúdo relacionado na exibição de descoberta do seu feed de notícias. Para obter mais informações, consulte "[Encontrar maneiras de contribuir para o código aberto em {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)." +Você pode favoritar repositórios e tópicos para descobrir projetos semelhantes em +{% data variables.product.product_name %}. Quando você marca repositórios ou tópicos com estrelas, o {% data variables.product.product_name %} pode recomendar um conteúdo relacionado na exibição de descoberta do seu feed de notícias. Para obter mais informações, consulte "[Encontrar maneiras de contribuir para o código aberto em {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)." {% endif %} Marcar um repositório com estrelas também demonstra apreciação ao trabalho do mantenedor de repositório. Muitas classificações de repositórios do {% data variables.product.prodname_dotcom %} dependem do número de estrelas do repositório. Além disso, o [Explore](https://github.com/explore) mostra os repositórios populares com base no número de estrelas do repositório. diff --git a/translations/pt-BR/content/github/getting-started-with-github/set-up-git.md b/translations/pt-BR/content/github/getting-started-with-github/set-up-git.md index d26e5235805a..faffcd9ffd0d 100644 --- a/translations/pt-BR/content/github/getting-started-with-github/set-up-git.md +++ b/translations/pt-BR/content/github/getting-started-with-github/set-up-git.md @@ -18,7 +18,7 @@ versions: Para usar o Git na linha de comando, você precisará fazer download, instalar e configurar o Git no computador. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} Você também pode instalar {% data variables.product.prodname_cli %} para usar {% data variables.product.product_name %} na linha de comando. Para obter mais informações sobre {% data variables.product.prodname_cli %}, consulte a documentação de [{% data variables.product.prodname_cli %}](https://cli.github.com/manual/) .{% endif %} -Se quiser trabalhar com o Git , mas não quiser usar a linha de comando, você poderá baixar e instalar o cliente do [{% data variables.product.prodname_desktop %}]({% data variables.product.desktop_link %}). Para obter mais informações, consulte "[Instalar e configurar o {% data variables.product.prodname_desktop %}](/desktop/installing-and-configuring-github-desktop/)". +Se quiser trabalhar com o Git, mas não quiser usar a linha de comando, você poderá baixar e instalar o cliente do [{% data variables.product.prodname_desktop %}]({% data variables.product.desktop_link %}). Para obter mais informações, consulte "[Instalar e configurar o {% data variables.product.prodname_desktop %}](/desktop/installing-and-configuring-github-desktop/)". Se não precisar trabalhar nos arquivos localmente, o {% data variables.product.product_name %} permite a execução de diversas ações relacionadas ao Git diretamente no navegador, incluindo: diff --git a/translations/pt-BR/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-server.md b/translations/pt-BR/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-server.md index dbad643d4b36..340ef1b0e1fb 100644 --- a/translations/pt-BR/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-server.md +++ b/translations/pt-BR/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-server.md @@ -13,7 +13,7 @@ versions: Você pode solicitar uma versão de avaliação por 45 dias do {% data variables.product.prodname_ghe_server %}. A versão de avaliação será instalada como um appliance virtual, com opções para implementação local ou na nuvem. Consulte a lista de plataformas de visualização compatíveis em "[Configurar uma instância do GitHub Enterprise Server](/enterprise/admin/installation/setting-up-a-github-enterprise-server-instance)". -{% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}Alertas de Segurança{% endif %} e {% data variables.product.prodname_github_connect %} não estão disponíveis atualmente nos testes de {% data variables.product.prodname_ghe_server %}. Para uma demonstração desses recursos, entre em contato com {% data variables.contact.contact_enterprise_sales %}. Para obter mais informações sobre esses recursos, consulte "[Sobre alertas para dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)" e "[Conectando {% data variables.product.prodname_ghe_server %} a {% data variables.product.prodname_dotcom_the_website %}](/enterprise/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)". +{% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}Alertas {% endif %} de segurança e {% data variables.product.prodname_github_connect %} não estão atualmente disponíveis em testes de {% data variables.product.prodname_ghe_server %}. Para uma demonstração desses recursos, entre em contato com {% data variables.contact.contact_enterprise_sales %}. Para obter mais informações sobre esses recursos, consulte "[Sobre alertas para dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)" e "[Conectando {% data variables.product.prodname_ghe_server %} a {% data variables.product.prodname_dotcom_the_website %}](/enterprise/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)". As versões de avaliação também estão disponíveis para {% data variables.product.prodname_ghe_cloud %}. Para obter mais informações, consulte "[Configurar uma versão de avaliação do {% data variables.product.prodname_ghe_cloud %}](/articles/setting-up-a-trial-of-github-enterprise-cloud)". diff --git a/translations/pt-BR/content/github/getting-started-with-github/supported-browsers.md b/translations/pt-BR/content/github/getting-started-with-github/supported-browsers.md index c93600a7951b..0d8c6d938f3d 100644 --- a/translations/pt-BR/content/github/getting-started-with-github/supported-browsers.md +++ b/translations/pt-BR/content/github/getting-started-with-github/supported-browsers.md @@ -4,7 +4,7 @@ redirect_from: - /articles/why-doesn-t-graphs-work-with-ie-8/ - /articles/why-don-t-graphs-work-with-ie8/ - /articles/supported-browsers -intro: 'Nós projetamos o {% data variables.product.product_name %} para ser compatível com os navegadores web mais recentes. Oferecemos suporte às versões atuais de [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 %}e [Microsoft Edge](https://www.microsoft.com/en-us/windows/microsoft-edge).' +intro: 'Nós projetamos o {% data variables.product.product_name %} para ser compatível com os navegadores web mais recentes. Nós suportamos as versões atuais de [Chrome](https://www.google.com/chrome/), [Firefox](http://www.mozilla.org/firefox/), [Safari](http://www.apple. om/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: '*' diff --git a/translations/pt-BR/content/github/getting-started-with-github/types-of-github-accounts.md b/translations/pt-BR/content/github/getting-started-with-github/types-of-github-accounts.md index 5d3bfbacca42..034b8d6b7a74 100644 --- a/translations/pt-BR/content/github/getting-started-with-github/types-of-github-accounts.md +++ b/translations/pt-BR/content/github/getting-started-with-github/types-of-github-accounts.md @@ -1,6 +1,6 @@ --- title: Tipos de contas do GitHub -intro: 'Sua conta de usuário é o que identifica você no {% data variables.product.product_location %}. Ela pode ser integrante de qualquer número de organizações.{% if currentVersion == "free-pro-team@latest" %} As organizações podem pertencer a contas corporativas.{% endif %}' +intro: 'Sua conta de usuário é o que identifica você no {% data variables.product.product_location %}. A sua conta de usuário pode ser integrante de qualquer quantidade de organizações{% if currentVersion == "free-pro-team@latest" %} As organizações podem pertencer às contas corporativas.{% endif %}' redirect_from: - /manage-multiple-clients/ - /managing-clients/ @@ -13,7 +13,8 @@ versions: --- {% if currentVersion == "free-pro-team@latest" %} -Para uma lista completa de recursos para cada {% data variables.product.product_name %} produto, consulte produtos do "[{% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/githubs-products)." +Para obter uma lista completa de recursos para cada +produto de {% data variables.product.product_name %}, consulte "[ produtos de {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/githubs-products)." {% endif %} ### Contas de usuário pessoais @@ -71,6 +72,6 @@ Com contas corporativas, é possível gerenciar centralmente a política e a cob ### Leia mais -{% if currentVersion == "free-pro-team@latest" %}- "[Inscrever-se em uma nova conta do {% data variables.product.prodname_dotcom %}](/articles/signing-up-for-a-new-github-account)" +{% if currentVersion == "free-pro-team@latest" %}- "[Inscrevendo-se em uma nova conta {% data variables.product.prodname_dotcom %}](/articles/signing-up-for-a-new-github-account)" - "[Produtos do {% data variables.product.prodname_dotcom %}](/articles/githubs-products)"{% endif %} - "[Criar uma conta de organização](/articles/creating-a-new-organization-account)" diff --git a/translations/pt-BR/content/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line.md b/translations/pt-BR/content/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line.md index f0573edab0b8..f292767d3f9b 100644 --- a/translations/pt-BR/content/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line.md +++ b/translations/pt-BR/content/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line.md @@ -21,7 +21,10 @@ versions: {% mac %} -1. [Crie um repositório ](/articles/creating-a-new-repository) no {% data variables.product.product_location %}. Para evitar erros, não inicialize o novo repositório com os arquivos *LEIAME*, de licença ou `gitignore`. É possível adicionar esses arquivos após push do projeto no {% data variables.product.product_name %}. ![Menu suspenso Create New Repository (Criar novo repositório)](/assets/images/help/repository/repo-create.png) +1. [Crie um repositório ](/articles/creating-a-new-repository) no + +{% data variables.product.product_location %}. Para evitar erros, não inicialize o novo repositório com os arquivos *LEIAME*, de licença ou `gitignore`. É possível adicionar esses arquivos após push do projeto no {% data variables.product.product_name %}. + ![Menu suspenso Create New Repository (Criar novo repositório)](/assets/images/help/repository/repo-create.png) {% data reusables.command_line.open_the_multi_os_terminal %} 3. Altere o diretório de trabalho atual referente ao seu projeto local. 4. Inicialize o diretório local como um repositório Git. @@ -48,7 +51,7 @@ versions: ``` 9. [Faça push das alterações](/articles/pushing-commits-to-a-remote-repository/) no seu repositório local para o {% data variables.product.product_location %}. ```shell - $ git push -u origin master + $ git push -u origin main # Pushes the changes in your local repository up to the remote repository you specified as the origin ``` @@ -56,7 +59,10 @@ versions: {% windows %} -1. [Crie um repositório ](/articles/creating-a-new-repository) no {% data variables.product.product_location %}. Para evitar erros, não inicialize o novo repositório com os arquivos *LEIAME*, de licença ou `gitignore`. É possível adicionar esses arquivos após push do projeto no {% data variables.product.product_name %}. ![Menu suspenso Create New Repository (Criar novo repositório)](/assets/images/help/repository/repo-create.png) +1. [Crie um repositório ](/articles/creating-a-new-repository) no + +{% data variables.product.product_location %}. Para evitar erros, não inicialize o novo repositório com os arquivos *LEIAME*, de licença ou `gitignore`. É possível adicionar esses arquivos após push do projeto no {% data variables.product.product_name %}. + ![Menu suspenso Create New Repository (Criar novo repositório)](/assets/images/help/repository/repo-create.png) {% data reusables.command_line.open_the_multi_os_terminal %} 3. Altere o diretório de trabalho atual referente ao seu projeto local. 4. Inicialize o diretório local como um repositório Git. @@ -83,7 +89,7 @@ versions: ``` 9. [Faça push das alterações](/articles/pushing-commits-to-a-remote-repository/) no seu repositório local para o {% data variables.product.product_location %}. ```shell - $ git push origin master + $ git push origin main # Pushes the changes in your local repository up to the remote repository you specified as the origin ``` @@ -91,7 +97,10 @@ versions: {% linux %} -1. [Crie um repositório ](/articles/creating-a-new-repository) no {% data variables.product.product_location %}. Para evitar erros, não inicialize o novo repositório com os arquivos *LEIAME*, de licença ou `gitignore`. É possível adicionar esses arquivos após push do projeto no {% data variables.product.product_name %}. ![Menu suspenso Create New Repository (Criar novo repositório)](/assets/images/help/repository/repo-create.png) +1. [Crie um repositório ](/articles/creating-a-new-repository) no + +{% data variables.product.product_location %}. Para evitar erros, não inicialize o novo repositório com os arquivos *LEIAME*, de licença ou `gitignore`. É possível adicionar esses arquivos após push do projeto no {% data variables.product.product_name %}. + ![Menu suspenso Create New Repository (Criar novo repositório)](/assets/images/help/repository/repo-create.png) {% data reusables.command_line.open_the_multi_os_terminal %} 3. Altere o diretório de trabalho atual referente ao seu projeto local. 4. Inicialize o diretório local como um repositório Git. @@ -118,7 +127,7 @@ versions: ``` 9. [Faça push das alterações](/articles/pushing-commits-to-a-remote-repository/) no seu repositório local para o {% data variables.product.product_location %}. ```shell - $ git push origin master + $ git push origin main # Pushes the changes in your local repository up to the remote repository you specified as the origin ``` diff --git a/translations/pt-BR/content/github/importing-your-projects-to-github/importing-a-git-repository-using-the-command-line.md b/translations/pt-BR/content/github/importing-your-projects-to-github/importing-a-git-repository-using-the-command-line.md index b036bfe27665..64a1a04ae919 100644 --- a/translations/pt-BR/content/github/importing-your-projects-to-github/importing-a-git-repository-using-the-command-line.md +++ b/translations/pt-BR/content/github/importing-your-projects-to-github/importing-a-git-repository-using-the-command-line.md @@ -1,6 +1,6 @@ --- title: Importar um repositório Git usando a linha de comando -intro: '{% if currentVersion == "free-pro-team@latest" %}Caso o [Importador do GitHub](/articles/importing-a-repository-with-github-importer) não seja adequado para seus propósitos, por exemplo, quando seu código existente está hospedado em uma rede privada, recomendamos importar usando a linha de comando.{% else %}Importar projetos Git usando a linha de comando é indicado quando seu código existente está hospedado em uma rede privada.{% endif %}' +intro: '{% if currentVersion == "free-pro-team@latest" %}Se [Importador do GitHub](/articles/importing-a-repository-with-github-importer) não for adequado para os seus propósitos como se o seu código existente estivesse hospedado em uma rede privada, recomendamos realizar a importação usando a linha de comando.{% else %}Importar projetos do Git usando a linha de comando é adequado quando seu código existente está hospedado em uma rede privada.{% endif %}' redirect_from: - /articles/importing-a-git-repository-using-the-command-line versions: diff --git a/translations/pt-BR/content/github/importing-your-projects-to-github/importing-source-code-to-github.md b/translations/pt-BR/content/github/importing-your-projects-to-github/importing-source-code-to-github.md index da49b6165a34..b68c376dbe20 100644 --- a/translations/pt-BR/content/github/importing-your-projects-to-github/importing-source-code-to-github.md +++ b/translations/pt-BR/content/github/importing-your-projects-to-github/importing-source-code-to-github.md @@ -1,6 +1,6 @@ --- title: Importar código-fonte para o GitHub -intro: 'É possível importar repositórios para o GitHub com o {% if currentVersion == "free-pro-team@latest" %}Importador do GitHub, linha de comando,{% else %}linha de comando{% endif %} ou ferramentas externas de migração.' +intro: 'Você pode importar repositórios para o GitHub usando o {% if currentVersion == "free-pro-team@latest" %}Importador do GitHub, a linha de comando,{% else %}a linha de comando{% endif %} ou ferramentas de migração externa.' redirect_from: - /articles/importing-an-external-git-repository/ - /articles/importing-from-bitbucket/ diff --git a/translations/pt-BR/content/github/importing-your-projects-to-github/what-are-the-differences-between-subversion-and-git.md b/translations/pt-BR/content/github/importing-your-projects-to-github/what-are-the-differences-between-subversion-and-git.md index 61787503cea6..f666b326d844 100644 --- a/translations/pt-BR/content/github/importing-your-projects-to-github/what-are-the-differences-between-subversion-and-git.md +++ b/translations/pt-BR/content/github/importing-your-projects-to-github/what-are-the-differences-between-subversion-and-git.md @@ -35,9 +35,9 @@ Os projetos do Git também são armazenados em um único diretório. No entanto, Um fluxo de trabalho do Git fica assim: * Um repositório do Git armazena o histórico completo de todos os branches e tags dentro do diretório *.git*. -* A versão estável mais recente está dentro do branch `master`. +* A última versão estável está contida no branch-padrão. * O trabalho de recurso ativo é desenvolvido em branches separados. -* Quando um recurso é concluído, o branch dele passa por merge em `master` e é excluído. +* Quando um recurso é concluído, o branch de recurso é mesclado no branch-padrão e excluído. Ao contrário do SVN, a estrutura de diretórios no Git permanece a mesma, mas o conteúdo dos arquivos é alterado de acordo com o branch que você possui. diff --git a/translations/pt-BR/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md b/translations/pt-BR/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md index 90fdcc23bb22..8f2f1cd78c8d 100644 --- a/translations/pt-BR/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md +++ b/translations/pt-BR/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md @@ -19,7 +19,9 @@ versions: {% data reusables.repositories.sensitive-info-warning %} -1. No seu computador, mova o arquivo do qual deseja fazer upload para o {% data variables.product.product_name %}, no diretório local que foi criado quando o repositório foi clonado. +1. No seu computador, mova o arquivo para o qual você gostaria de fazer o upload + +{% data variables.product.product_name %} para o diretório local que foi criado quando você clonou o repositório. {% data reusables.command_line.open_the_multi_os_terminal %} {% data reusables.command_line.switching_directories_procedural %} {% data reusables.git.stage_for_commit %} diff --git a/translations/pt-BR/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository.md b/translations/pt-BR/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository.md index 4d0ecd560314..1b8b0f1c49d8 100644 --- a/translations/pt-BR/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository.md +++ b/translations/pt-BR/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository.md @@ -1,8 +1,6 @@ --- title: Adicionar um arquivo a um repositório -intro: |- - Você pode fazer upload e commit de um arquivo existente em um repositório - do {% data variables.product.product_name %}. Arraste e solte um arquivo em qualquer diretório na árvore de arquivos ou faça upload de arquivos da página principal do repositório. +intro: "Você pode fazer upload e commit de um arquivo existente em um repositório\n do {% data variables.product.product_name %}. Arraste e solte um arquivo em qualquer diretório na árvore de arquivos ou faça upload de arquivos da página principal do repositório." redirect_from: - /articles/adding-a-file-to-a-repository versions: diff --git a/translations/pt-BR/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md b/translations/pt-BR/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md index 6e388d31f652..fea4bfac23bf 100644 --- a/translations/pt-BR/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md +++ b/translations/pt-BR/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md @@ -20,7 +20,7 @@ versions: Ao visualizar um arquivo em {% data variables.product.product_location %}, normalmente você vê a versão do head atual de um branch. Por exemplo: -* [https://github.com/github/hubot/blob/**master**/README.md](https://github.com/github/hubot/blob/master/README.md) +* [https://github.com/github/hubot/blob/**master**/README.md](https://github.com/github/codeql/blob/main/README.md) refere-se ao repositório `hubot` do GitHub e apresenta a versão atual do branch `master` do arquivo `README.md`. @@ -30,7 +30,7 @@ A versão de um arquivo no head de um branch pode ser modificada assim que novos Para um link permanente em uma versão específica de um arquivo que você vê, em vez de usar o nome do branch na URL (por exemplo: a parte `master` no exemplo acima), coloque o ID do commit. Isso vinculará permanentemente a versão exata do arquivo naquele commit. Por exemplo: -* [https://github.com/github/hubot/blob/**ed25584f5ac2520a6c28547ffd0961c7abd7ea49**/README.md](https://github.com/github/hubot/blob/ed25584f5ac2520a6c28547ffd0961c7abd7ea49/README.md) +* [https://github.com/github/hubot/blob/**ed25584f5ac2520a6c28547ffd0961c7abd7ea49**/README.md](https://github.com/github/codeql/blob/b212af08a6cffbb434f3c8a2795a579e092792fd/README.md) substitui `master` com um ID específico do commit e o conteúdo do arquivo não será modificado. diff --git a/translations/pt-BR/content/github/managing-files-in-a-repository/moving-a-file-to-a-new-location-using-the-command-line.md b/translations/pt-BR/content/github/managing-files-in-a-repository/moving-a-file-to-a-new-location-using-the-command-line.md index 0f775c0a7783..464f3b3dc50e 100644 --- a/translations/pt-BR/content/github/managing-files-in-a-repository/moving-a-file-to-a-new-location-using-the-command-line.md +++ b/translations/pt-BR/content/github/managing-files-in-a-repository/moving-a-file-to-a-new-location-using-the-command-line.md @@ -1,6 +1,6 @@ --- title: Mover um arquivo para um novo local usando a linha de comando -intro: 'Você pode usar a linha de comando para mover arquivos dentro de um repositório, removendo o arquivo do local antigo e adicionando-o ao novo local.' +intro: Você pode usar a linha de comando para mover arquivos dentro de um repositório, removendo o arquivo do local antigo e adicionando-o ao novo local. redirect_from: - /articles/moving-a-file-to-a-new-location-using-the-command-line versions: diff --git a/translations/pt-BR/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md b/translations/pt-BR/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md index fe54fd250b37..b289b73483b0 100644 --- a/translations/pt-BR/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md +++ b/translations/pt-BR/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md @@ -9,9 +9,9 @@ versions: --- -Os recursos interativos do notebook, como plots personalizados de JavaScript, não funcionam no seu repositório no {% data variables.product.product_location %}. Para ver um exemplo, consulte [*Linking and Interactions.ipynb*](https://github.com/bokeh/bokeh-notebooks/blob/master/tutorial/06%20-%20Linking%20and%20Interactions.ipynb). +Os recursos interativos do notebook, como plots personalizados de JavaScript, não funcionam no seu repositório no {% data variables.product.product_location %}. Para ver um exemplo, consulte [*Linking and Interactions.ipynb*](https://github.com/bokeh/bokeh-notebooks/blob/main/tutorial/06%20-%20Linking%20and%20Interactions.ipynb). -Para exibir o Jupyter Notebook com conteúdo JavaScript renderizado ou compartilhar arquivos do seu notebook com outras pessoas, use [nbviewer](https://nbviewer.jupyter.org/). Para ver um exemplo, consulte [*Linking and Interactions.ipynb*](https://nbviewer.jupyter.org/github/bokeh/bokeh-notebooks/blob/master/tutorial/06%20-%20Linking%20and%20Interactions.ipynb) renderizado no nbviewer. +Para exibir o Jupyter Notebook com conteúdo JavaScript renderizado ou compartilhar arquivos do seu notebook com outras pessoas, use [nbviewer](https://nbviewer.jupyter.org/). Para ver um exemplo, consulte [*Linking and Interactions.ipynb*](https://nbviewer.jupyter.org/github/bokeh/bokeh-notebooks/blob/main/tutorial/06%20-%20Linking%20and%20Interactions.ipynb) renderizado no nbviewer. Para exibir uma versão totalmente interativa do Jupyter Notebook, configure um servidor de notebook localmente. Para obter mais informações, consulte a [documentação oficial do Jupyter](http://jupyter.readthedocs.io/en/latest/index.html). diff --git a/translations/pt-BR/content/github/managing-large-files/about-git-large-file-storage.md b/translations/pt-BR/content/github/managing-large-files/about-git-large-file-storage.md index 3d85620392ff..81c3b123eedb 100644 --- a/translations/pt-BR/content/github/managing-large-files/about-git-large-file-storage.md +++ b/translations/pt-BR/content/github/managing-large-files/about-git-large-file-storage.md @@ -12,16 +12,17 @@ versions: O {% data variables.large_files.product_name_short %} manipula arquivos grandes armazenando referências ao arquivo no repositório, mas não no próprio arquivo. Para trabalhar em torno da arquitetura do Git, o {% data variables.large_files.product_name_short %} cria um arquivo de ponteiro que atua como uma referência ao arquivo real (que é armazenado em algum outro lugar). O {% data variables.product.product_name %} gerencia esse arquivo de ponteiro no seu repositório. Quando você clona o repositório, o {% data variables.product.product_name %} usa o arquivo de ponteiro como um mapa para encontrar o arquivo grande para você. {% if currentVersion == "free-pro-team@latest" %} -Ao usar {% data variables.large_files.product_name_short %}, você pode armazenar arquivos até: +Ao usar +{% data variables.large_files.product_name_short %}, você pode armazenar arquivos até: -| Produto | Tamanho máximo do arquivo | -| ------------------------------------------------------ | ------------------------- | +| Produto | Tamanho máximo do arquivo | +| ------------------------------------------------- | ------------------------- | | {% data variables.product.prodname_free_user %} | 2 GB | | {% data variables.product.prodname_pro %} | 2 GB | | {% data variables.product.prodname_team %} | 4 GB | | {% data variables.product.prodname_ghe_cloud %} | 5 GB |{% else %} - Ao usar {% data variables.large_files.product_name_short %}, você pode armazenar arquivos até -{% if currentVersion ver_lt "enterprise-server@2.21" %}{% data variables.large_files.max_lfs_size %}{% else %}5 GB{% endif %} no seu repositório. + Ao usar +{% data variables.large_files.product_name_short %}, você pode armazenar arquivos de até {% if currentVersion ver_lt "enterprise-server@2.21" %}{% data variables.large_files.max_lfs_size %}{% else %}5 GB{% endif %} no seu repositório. {% endif %} Também é possível usar o {% data variables.large_files.product_name_short %} com o {% data variables.product.prodname_desktop %}. Para obter mais informações sobre como clonar repositórios LFS do Git no {% data variables.product.prodname_desktop %}, consulte "[Clonar um repositório do GitHub no GitHub Desktop](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop)". diff --git a/translations/pt-BR/content/github/managing-large-files/about-storage-and-bandwidth-usage.md b/translations/pt-BR/content/github/managing-large-files/about-storage-and-bandwidth-usage.md index 6bd1f1576aeb..d2fdab32363a 100644 --- a/translations/pt-BR/content/github/managing-large-files/about-storage-and-bandwidth-usage.md +++ b/translations/pt-BR/content/github/managing-large-files/about-storage-and-bandwidth-usage.md @@ -20,7 +20,8 @@ Por exemplo: - Se você baixar um arquivo de 500 MB que é rastreado com o LFS, serão usados 500 MB da largura de banda alocada do proprietário do repositório. Se um colaborador fizer push de uma alteração no arquivo e você fizer pull da nova versão no repositório local, serão usados outros 500 MB de largura de banda, totalizando 1 GB de uso total da largura de banda para esses dois downloads. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -Se {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) os objetos forem incluídos nos arquivos de código-fonte para o seu repositório, os downloads desses arquivos contarão para o uso de largura de banda para o repositório. Para obter mais informações, consulte " +Se +{% data variables.large_files.product_name_long %} objetos de ({% data variables.large_files.product_name_short %}) estiverem incluídos nos arquivos do código-fonte do seu repositório, os downloads desses arquivos contarão para o uso de banda larga no repositório. Para obter mais informações, consulte " [Gerenciando {% data variables.large_files.product_name_short %} objetos nos arquivos de seu repositório](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)".

    {% endif %} diff --git a/translations/pt-BR/content/github/managing-large-files/conditions-for-large-files.md b/translations/pt-BR/content/github/managing-large-files/conditions-for-large-files.md index cbeef0682b14..1331e8abd0c5 100644 --- a/translations/pt-BR/content/github/managing-large-files/conditions-for-large-files.md +++ b/translations/pt-BR/content/github/managing-large-files/conditions-for-large-files.md @@ -16,4 +16,4 @@ Se você tentar adicionar ou atualizar um arquivo maior do que {% data variables ### Pushes bloqueados para arquivos grandes -{% if currentVersion != "free-pro-team@latest" %}Por padrão, {% endif %}{% data variables.product.product_name %} bloqueia pushes que excedem {% data variables.large_files.max_github_size %}. {% if currentVersion != "free-pro-team@latest" %}No entanto, um administrador do site pode configurar um limite diferente para sua instância do {% data variables.product.prodname_ghe_server %}. Para obter mais informações, consulte "[Definir limites de push do Git](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-git-push-limits)".{% endif %} +{% if currentVersion != "free-pro-team@latest" %}Por padrão, blocos do {% endif %}{% data variables.product.product_name %} fazem pushes que excedem {% data variables.large_files.max_github_size %}. {% if currentVersion != "free-pro-team@latest" %}No entanto, um administrador do site pode configurar um limite diferente para a sua instância de {% data variables.product.prodname_ghe_server %}. Para obter mais informações, consulte "[Definir limites de push do Git](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-git-push-limits)".{% endif %} diff --git a/translations/pt-BR/content/github/managing-large-files/installing-git-large-file-storage.md b/translations/pt-BR/content/github/managing-large-files/installing-git-large-file-storage.md index 734ff56f3d00..dbc9e54bcdf9 100644 --- a/translations/pt-BR/content/github/managing-large-files/installing-git-large-file-storage.md +++ b/translations/pt-BR/content/github/managing-large-files/installing-git-large-file-storage.md @@ -57,7 +57,8 @@ versions: {% endtip %} 2. Em seu computador, localize o arquivo que foi baixado. -3. Clique duas vezes sobre o arquivo denominado *git-lfs-windows-1.X.X.exe*, onde 1.X.X é substituído pela versão Git LFS que você baixou. Quando você abrir esse arquivo, o Windows executará um assistente de configuração para instalar o {% data variables.large_files.product_name_short %}. +3. Clique duas vezes sobre o arquivo denominado *git-lfs-windows-1.X.X.exe*, onde 1.X.X é substituído pela versão Git LFS que você baixou. Ao abrir este arquivo, o Windows irá executar um assistente de configuração para instalar +{% data variables.large_files.product_name_short %}. {% data reusables.command_line.open_the_multi_os_terminal %} 5. Verifique se a instalação foi bem-sucedida: ```shell diff --git a/translations/pt-BR/content/github/managing-large-files/removing-files-from-git-large-file-storage.md b/translations/pt-BR/content/github/managing-large-files/removing-files-from-git-large-file-storage.md index e6f0e14150bc..9290d04394dc 100644 --- a/translations/pt-BR/content/github/managing-large-files/removing-files-from-git-large-file-storage.md +++ b/translations/pt-BR/content/github/managing-large-files/removing-files-from-git-large-file-storage.md @@ -1,6 +1,6 @@ --- -title: Remover arquivos do Git Large File Storage -intro: 'Se o {% data variables.large_files.product_name_short %} estiver configurado no repositório, você poderá remover todos os arquivos ou um subconjunto de arquivos do {% data variables.large_files.product_name_short %}.' +title: Removing files from Git Large File Storage +intro: 'If you''ve set up {% data variables.large_files.product_name_short %} for your repository, you can remove all files or a subset of files from {% data variables.large_files.product_name_short %}.' redirect_from: - /articles/removing-files-from-git-large-file-storage versions: @@ -8,45 +8,45 @@ versions: enterprise-server: '*' --- -### Remover um único arquivo +### Removing a single file -1. Remova o arquivo do histórico do repositório do Git usando o comando `filter-branch` ou o BFG Repo Cleaner. Para obter mais informações, consulte "[Remover dados confidenciais do repositório](/articles/removing-sensitive-data-from-a-repository)". -2. Acesse o arquivo *.gitattributes* . +1. Remove the file from the repository's Git history using either the `filter-branch` command or BFG Repo-Cleaner. For detailed information on using these, see "[Removing sensitive data from a repository](/articles/removing-sensitive-data-from-a-repository)." +2. Navigate to your *.gitattributes* file. {% note %} - **Observação:** o arquivo *.gitattributes* geralmente é salvo no repositório local. Em alguns casos, você pode ter criado um arquivo *.gitattributes* glocal que contém todas as associações do {% data variables.large_files.product_name_short %}. + **Note:** Your *.gitattributes* file is generally saved within your local repository. In some cases, you may have created a global *.gitattributes* file that contains all of your {% data variables.large_files.product_name_short %} associations. {% endnote %} -3. Encontre e remova a regra de acompanhamento associada do {% data variables.large_files.product_name_short %} no arquivo *.gitattributes*. -4. Salve e feche o arquivo *.gitattributes*. +3. Find and remove the associated {% data variables.large_files.product_name_short %} tracking rule within the *.gitattributes* file. +4. Save and exit the *.gitattributes* file. -### Remover todos os arquivos de um repositório do {% data variables.large_files.product_name_short %} +### Removing all files within a {% data variables.large_files.product_name_short %} repository -1. Remova os arquivos do histórico do Git no repositório usando o comando `filter-branch` ou o BFG Repo-Cleaner. Para obter mais informações, consulte "[Remover dados confidenciais do repositório](/articles/removing-sensitive-data-from-a-repository)". -2. Como opção, para desinstalar o {% data variables.large_files.product_name_short %} do repositório, execute: +1. Remove the files from the repository's Git history using either the `filter-branch` command or BFG Repo-Cleaner. For detailed information on using these, see "[Removing sensitive data from a repository](/articles/removing-sensitive-data-from-a-repository)." +2. Optionally, to uninstall {% data variables.large_files.product_name_short %} in the repository, run: ```shell $ git lfs uninstall ``` - Para versões do {% data variables.large_files.product_name_short %} inferiores à 1.1.0, execute: + For {% data variables.large_files.product_name_short %} versions below 1.1.0, run: ```shell $ git lfs uninit ``` -### Objetos do {% data variables.large_files.product_name_short %} no repositório +### {% data variables.large_files.product_name_short %} objects in your repository -Quando você remove os arquivos do {% data variables.large_files.product_name_short %}, os objetos do {% data variables.large_files.product_name_short %} permanecem no armazenamento remoto{% if currentVersion == "free-pro-team@latest" %} e são considerados na cota de armazenamento do {% data variables.large_files.product_name_short %}{% endif %}. +After you remove files from {% data variables.large_files.product_name_short %}, the {% data variables.large_files.product_name_short %} objects still exist on the remote storage{% if currentVersion == "free-pro-team@latest" %} and will continue to count toward your {% data variables.large_files.product_name_short %} storage quota{% endif %}. -Para remover os objetos do {% data variables.large_files.product_name_short %} de um repositório, {% if currentVersion == "free-pro-team@latest" %}exclua e recrie o repositório. Ao excluir um repositório, todos os problemas associados, estrelas e bifurcações também serão excluídos. Para obter mais informações, consulte "[Excluir um repositório](/github/administering-a-repository/deleting-a-repository)".{% else %}entre em contato com o administrador do {% data variables.product.prodname_enterprise %} para arquivar os objetos. Os objetos arquivados são excluídos após três meses.{% endif %} +To remove {% data variables.large_files.product_name_short %} objects from a repository, {% if currentVersion == "free-pro-team@latest" %}delete and recreate the repository. When you delete a repository, any associated issues, stars, and forks are also deleted. For more information, see "[Deleting a repository](/github/administering-a-repository/deleting-a-repository)."{% else %}contact your {% data variables.product.prodname_enterprise %} administrator to archive the objects. Archived objects are purged after three months.{% endif %} {% note %} -**Observação:** se você removeu um único arquivo e tem outros objetos do {% data variables.large_files.product_name_short %} que deseja manter no repositório, reconfigure os arquivos associados do {% data variables.large_files.product_name_short %} depois de excluir e recriar o repositório. Para obter mais informações, consulte "[Remover um único arquivo](#removing-a-single-file)" e "[Configurar {% data variables.large_files.product_name_long %}](/github/managing-large-files/configuring-git-large-file-storage)". +**Note:** If you removed a single file and have other {% data variables.large_files.product_name_short %} objects that you'd like to keep in your repository, after deleting and recreating your repository, reconfigure your {% data variables.large_files.product_name_short %}-associated files. For more information, see "[Removing a single file](#removing-a-single-file)" and "[Configuring {% data variables.large_files.product_name_long %}](/github/managing-large-files/configuring-git-large-file-storage)." {% endnote %} -### Leia mais +### Further reading -- "[Sobre o {% data variables.large_files.product_name_long %}](/articles/about-git-large-file-storage)" -- "[Colaboração com o {% data variables.large_files.product_name_long %}](/articles/collaboration-with-git-large-file-storage/)" -- "[Instalar o {% data variables.large_files.product_name_long %}](/articles/installing-git-large-file-storage)" +- "[About {% data variables.large_files.product_name_long %}](/articles/about-git-large-file-storage)" +- "[Collaboration with {% data variables.large_files.product_name_long %}](/articles/collaboration-with-git-large-file-storage/)" +- "[Installing {% data variables.large_files.product_name_long %}](/articles/installing-git-large-file-storage)" diff --git a/translations/pt-BR/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md b/translations/pt-BR/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md index 73b8dce6840a..0ce617f2fdb2 100644 --- a/translations/pt-BR/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md +++ b/translations/pt-BR/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md @@ -77,15 +77,15 @@ We send security alerts to people with admin permissions in the affected reposit ### Configuring notifications for {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} {% if currentVersion == "free-pro-team@latest" %} -By default, you will receive {% data variables.product.prodname_dependabot_alerts %} by email, grouped by the specific vulnerability. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-options)." +By default, you will receive {% data variables.product.prodname_dependabot_alerts %} by email, grouped by the specific vulnerability. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-notification-options)." {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %} -By default, if your site administrator has configured email for notifications on your instance, you will receive {% data variables.product.prodname_dependabot_alerts %} by email. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-options)." +By default, if your site administrator has configured email for notifications on your instance, you will receive {% data variables.product.prodname_dependabot_alerts %} by email. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-notification-options)." {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion == "enterprise-server@2.21" %} -By default, if your site administrator has configured email for notifications on your instance, you will receive security alerts by email. You can also choose to receive security alerts in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#security-alert-options)." +By default, if your site administrator has configured email for notifications on your instance, you will receive security alerts by email. You can also choose to receive security alerts in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#security-alert-notification-options)." {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.21" %} diff --git a/translations/pt-BR/content/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates.md b/translations/pt-BR/content/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates.md index 993353f8f06e..32072a2aac18 100644 --- a/translations/pt-BR/content/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates.md +++ b/translations/pt-BR/content/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates.md @@ -23,8 +23,8 @@ Ao mesclar um pull request que contém uma atualização de segurança, o alerta {% note %} -**Observação** -{% data variables.product.prodname_dependabot_security_updates %} apenas resolve vulnerabilidades de segurança nas dependências rastreadas pelo seu gráfico de dependências. As atualizações de segurança não são criadas para resolver vulnerabilidades em registros privados ou pacotes hospedados em repositórios privados. No entanto, as dependências indiretas ou transitórias são incluídas se forem definidas explicitamente em um arquivo bloqueado ou similar. Para obter mais informações, consulte "[Sobre o gráfico de dependência](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)". Além disso, é importante destacar que o {% data variables.product.prodname_dependabot_security_updates %} cria automaticamente pull requests com correções propostas para os arquivos bloqueados, para as dependências identificadas como vulneráveis. +**Observação** +{% data variables.product.prodname_dependabot_security_updates %} resolve apenas vulnerabilidades de segurança nas dependências rastreadas pelo seu gráfico de dependências. As atualizações de segurança não são criadas para resolver vulnerabilidades em registros privados ou pacotes hospedados em repositórios privados. No entanto, as dependências indiretas ou transitórias são incluídas se forem definidas explicitamente em um arquivo bloqueado ou similar. Para obter mais informações, consulte "[Sobre o gráfico de dependência](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)". Além disso, é importante destacar que o {% data variables.product.prodname_dependabot_security_updates %} cria automaticamente pull requests com correções propostas para os arquivos bloqueados, para as dependências identificadas como vulneráveis. {% endnote %} @@ -42,14 +42,14 @@ O {% data variables.product.prodname_dotcom %} habilita automaticamente o {% dat {% endnote %} -| Pré-requisito de habilitação automática | Mais informações | -| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| O repositório não é uma bifurcação | "[Sobre bifurcações](/github/collaborating-with-issues-and-pull-requests/about-forks)" | -| Repositório não está arquivado | "[Arquivar repositórios](/github/creating-cloning-and-archiving-repositories/archiving-repositories)" | +| Pré-requisito de habilitação automática | Mais informações | +| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| O repositório não é uma bifurcação | "[Sobre bifurcações](/github/collaborating-with-issues-and-pull-requests/about-forks)" | +| Repositório não está arquivado | "[Arquivar repositórios](/github/creating-cloning-and-archiving-repositories/archiving-repositories)" | | O repositório é público ou o repositório é privado e você ativou a análise somente leitura por {% data variables.product.prodname_dotcom %}, dependência gráfico e alertas de vulnerabilidade nas configurações do repositório | "[Gerenciar configurações de uso de dados para seu repositório privado](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository)". | | O repositório contém o arquivo de manifesto de dependência de um ecossistema de pacote compatível com o {% data variables.product.prodname_dotcom %} | "[Ecossistemas de pacotes compatíveis](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph#supported-package-ecosystems)" | -| {% data variables.product.prodname_dependabot_security_updates %} não estão desativadas para o repositório | "[Gerenciar {% data variables.product.prodname_dependabot_security_updates %} para o seu repositório](#managing-github-dependabot-security-updates-for-your-repositories)" | -| O repositório já não está utilizando uma integração para o gerenciamento de dependências | "[Sobre integrações](/github/customizing-your-github-workflow/about-integrations)" | +| {% data variables.product.prodname_dependabot_security_updates %} não estão desativadas para o repositório | "[Gerenciar {% data variables.product.prodname_dependabot_security_updates %} para o seu repositório](#managing-github-dependabot-security-updates-for-your-repositories)" | +| O repositório já não está utilizando uma integração para o gerenciamento de dependências | "[Sobre integrações](/github/customizing-your-github-workflow/about-integrations)" | Se as atualizações de segurança não estiverem habilitadas para o seu repositório e você não souber o motivo, primeiro tente habilitá-las utilizando as instruções fornecidas nas seções de procedimento abaixo. Se, ainda assim, as atualizações de segurança não funcionarem, você poderá [entrar em contato com o suporte](https://support.github.com/contact). diff --git a/translations/pt-BR/content/github/managing-security-vulnerabilities/managing-vulnerabilities-in-your-projects-dependencies.md b/translations/pt-BR/content/github/managing-security-vulnerabilities/managing-vulnerabilities-in-your-projects-dependencies.md index 4b091c08112d..c281c2b263e6 100644 --- a/translations/pt-BR/content/github/managing-security-vulnerabilities/managing-vulnerabilities-in-your-projects-dependencies.md +++ b/translations/pt-BR/content/github/managing-security-vulnerabilities/managing-vulnerabilities-in-your-projects-dependencies.md @@ -1,6 +1,6 @@ --- title: Gerenciar vulnerabilidades nas dependências de seu projeto -intro: 'Você pode acompanhar as dependências do seu repositório e receber alertas de segrurança de {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}{% endif %} quando {% data variables.product.product_name %} detecta dependências vulneráveis.' +intro: 'Você pode acompanhar as dependências do repositório e receber {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 1" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}alertas de segurança{% endif %} quando {% data variables.product.product_name %} detecta dependências vulneráveis.' mapTopic: true redirect_from: - /articles/updating-your-project-s-dependencies/ diff --git a/translations/pt-BR/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md b/translations/pt-BR/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md index 5034da22252f..be4d5e747623 100644 --- a/translations/pt-BR/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md +++ b/translations/pt-BR/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md @@ -44,7 +44,7 @@ Para cancelar a inscrição de conversas que você se inscreveu automaticamente, ### Personalizando notificações e assinaturas -Você pode optar por visualizar suas notificações através da caixa de entrada de notificações em [https://github.com/notifications](https://github.com/notifications){% if currentVersion == "free-pro-team@latest" %} e no aplicativo {% data variables.product.prodname_mobile %}{% endif %}, através do seu e-mail ou de alguma combinação destas opções. +Você pode optar por visualizar suas notificações através da caixa de entrada de notificações [https://github. um/notificações](https://github.com/notifications){% if currentVersion == "free-pro-team@latest" %} e no {% data variables.product.prodname_mobile %} aplicativo{% endif %}, através do seu e-mail ou de uma combinação dessas opções. Para personalizar os tipos de atualizações que você gostaria de receber e para onde enviar essas atualizações, configure suas configurações de notificação. Para obter mais informações, consulte “[Configurando notificações](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications)". @@ -53,20 +53,21 @@ Para manter suas assinaturas gerenciáveis, revise suas assinaturas e os reposit Para personalizar como você gostaria de receber atualizações de pull requests ou problemas específicos, é possível configurar suas preferências dentro do problema ou da pull request. Para obter mais informações, consulte “[Fazendo triagem de uma só notificação](/github/managing-subscriptions-and-notifications-on-github/triaging-a-single-notification#customizing-when-to-receive-future-updates-for-an-issue-or-pull-request)". {% if currentVersion == "free-pro-team@latest" %} -Você pode habilitar notificações de push no app {% data variables.product.prodname_mobile %}. Para obter mais informações, consulte “[Configurando notificações](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#enabling-push-notifications-with-github-for-mobile)". +Você pode habilitar notificações push no +aplicativo {% data variables.product.prodname_mobile %}. Para obter mais informações, consulte “[Configurando notificações](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#enabling-push-notifications-with-github-for-mobile)". {% endif %} ### Motivos para receber notificações -Sua caixa de entrada está configurada com filtros padrão, que representam as razões mais comuns para que as pessoas precisem acompanhar suas notificações. Para obter mais informações sobre filtros na caixa de entrada, consulte "[Gerenciar notificações de sua caixa de entrada](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox#default-notification-filters)". +Sua caixa de entrada está configurada com filtros-padrão, que representam as razões mais comuns para que as pessoas precisem acompanhar suas notificações. Para obter mais informações sobre filtros na caixa de entrada, consulte "[Gerenciar notificações de sua caixa de entrada](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox#default-notification-filters)". Sua caixa de entrada mostra as `razões` de você estar recebendo notificações como uma etiqueta. ![Etiquetas de razões na caixa de entrada](/assets/images/help/notifications-v2/reasons-as-labels-in-inbox.png) -Você pode filtrar sua caixa de entrada pelo motivo pelo qual está inscrito nas notificações. Por exemplo, para ver apenas pull requests onde alguém solicitou sua revisão, você pode usar o filtro de consulta `review-requested`. +Você pode filtrar sua caixa de entrada pelo motivo pelo qual está inscrito nas notificações. Por exemplo, para ver apenas pull requests em que alguém solicitou sua revisão, você pode usar o filtro de consulta `review-requested`. -![Filtrar notificações por revisar razão solicitada ](/assets/images/help/notifications-v2/review-requested-reason.png) +![Filtrar notificações por revisão da razão solicitada](/assets/images/help/notifications-v2/review-requested-reason.png) Se você configurou as notificações para serem enviadas por e-mail e acredita que está recebendo notificações que não pertencem a você, considere a resolução de problemas com cabeçalhos de e-mail, que mostram o destinatário pretendido. Para obter mais informações, consulte “[Configurando notificações](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#filtering-email-notifications)". @@ -82,7 +83,7 @@ Em sua caixa de entrada, você também pode fazer triagem de várias notificaç ### Personalizando sua caixa de entrada de notificações -Para focar em um grupo de notificações na sua caixa de entrada em {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} ou {% data variables.product.prodname_mobile %}{% endif %}, você pode criar filtros personalizados. Por exemplo, você pode criar um filtro personalizado para um projeto de código aberto para o qual contribui e somente visualizar notificações para esse repositório em que você é mencionado. Para obter mais informações, consulte "[Gerenciando notificações de sua caixa de entrada](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox)". Para mais exemplos de como personalizar a triagem de seu fluxo de trabalho, consulte "[Personalizando um fluxo de trabalho para triagem de suas notificações.](/github/managing-subscriptions-and-notifications-on-github/customizing-a-workflow-for-triaging-your-notifications) +Para se concentrar em um grupo de notificações na sua caixa de entrada em {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} ou em {% data variables.product.prodname_mobile %}{% endif %}, você pode criar filtros personalizados. Por exemplo, você pode criar um filtro personalizado para um projeto de código aberto para o qual contribui e somente visualizar notificações para esse repositório em que você é mencionado. Para obter mais informações, consulte "[Gerenciando notificações de sua caixa de entrada](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox)". Para mais exemplos de como personalizar a triagem de seu fluxo de trabalho, consulte "[Personalizando um fluxo de trabalho para triagem de suas notificações.](/github/managing-subscriptions-and-notifications-on-github/customizing-a-workflow-for-triaging-your-notifications) ### Política de retenção de notificações diff --git a/translations/pt-BR/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md b/translations/pt-BR/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md index 35e1284863d2..82721ad95ff1 100644 --- a/translations/pt-BR/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md +++ b/translations/pt-BR/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md @@ -1,6 +1,6 @@ --- -title: Configuring notifications -intro: 'Choose the type of activity on {% data variables.product.product_name %} that you want to receive notifications for and how you want these updates delivered.' +title: Configurar notificações +intro: 'Escolha o tipo de atividade no {% data variables.product.product_name %} do qual você deseja receber notificações e a forma como deseja que essas atualizações sejam entregues.' redirect_from: - /articles/about-web-notifications - /format-of-notification-emails/ @@ -18,62 +18,63 @@ versions: enterprise-server: '>=2.21' --- -### Notification delivery options +### Opções de entrega de notificação -You have three basic options for notification delivery: - - the notifications inbox on {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} - - the notifications inbox on {% data variables.product.prodname_mobile %}, which syncs with the inbox on {% data variables.product.product_name %}{% endif %} - - an email client that uses a verified email address, which can also sync with the notifications inbox on {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} and {% data variables.product.prodname_mobile %}{% endif %} +Você tem três opções básicas para a entrega de notificação: + - a caixa de entrada de notificações em {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} + - a caixa de entrada de notificações em {% data variables.product.prodname_mobile %}, que sincroniza com a caixa de entrada em {% data variables.product.product_name %}{% endif %} + - um cliente de e-mail que usa um endereço de e-mail verificado, que também pode sincronizar com a caixa de entrada de {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} e {% data variables.product.prodname_mobile %}{% endif %} {% if currentVersion == "free-pro-team@latest" %} -{% data reusables.notifications-v2.notifications-inbox-required-setting %} For more information, see "[Choosing your notification settings](#choosing-your-notification-settings)." +{% data reusables.notifications-v2.notifications-inbox-required-setting %} Para obter mais informações, consulte "[Escolhendo suas configurações de notificação](#choosing-your-notification-settings)". {% endif %} {% data reusables.notifications-v2.tip-for-syncing-email-and-your-inbox-on-github %} -#### Benefits of the notifications inbox +#### Benefícios da caixa de entrada de notificações -The notifications inbox on {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} and {% data variables.product.prodname_mobile %}{% endif %} includes triaging options designed specifically for your {% data variables.product.product_name %} notifications flow, including options to: - - Triage multiple notifications at once. - - Mark completed notifications as **Done** and remove them from your inbox. To view all of your notifications marked as **Done**, use the `is:done` query. - - Save a notification to review later. Saved notifications are flagged in your inbox and kept indefinitely. To view all of your saved notifications, use the `is:saved` query. - - Unsubscribe and remove a notification from your inbox. - - Preview the issue, pull request, or team discussion where the notification originates on {% data variables.product.product_name %} from within the notifications inbox. - - See one of the latest reasons you're receiving a notification from your inbox with a `reasons` label. - - Create custom filters to focus on different notifications when you want. - - Group notifications in your inbox by repository or date to get a quick overview with less context switching +A caixa de entrada de notificações em {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} e {% data variables.product.prodname_mobile %}{% endif %} inclui opções de triagem projetadas especificamente para o seu fluxo de notificações de {% data variables.product.product_name %} e inclui opções para: + - Fazer triagem de várias notificações ao mesmo tempo. + - Marcar as notificações concluídas como **Concluído** e removê-las da sua caixa de entrada. Para ver todas as suas notificações marcadas como **Concluído**, use a consulta `is:done`. + - Salvar uma notificação para revisar mais tarde. As notificações salvas são sinalizadas na sua caixa de entrada e mantidas indefinidamente. Para visualizar todas as suas notificações salvas, use a consulta `is:saved`. + - Cancelar inscrição e remover uma notificação da sua caixa de entrada. + - Visualizar o problema, a pull request ou uma discussão em equipe onde a notificação se origina no {% data variables.product.product_name %} de dentro da caixa de entrada de notificações. + - Ver uma das últimas razões pelas quais você está recebendo uma notificação de sua caixa de entrada com uma etiqueta `razões`. + - Criar filtros personalizados para focar em notificações diferentes quando quiser. + - Notificações em grupo em sua caixa de entrada por repositório ou data para obter uma visão geral rápida com menos comutação de contexto {% if currentVersion == "free-pro-team@latest" %} -In addition, the notifications inbox on {% data variables.product.prodname_mobile %} allows you to triage notifications in dark mode and receive push notifications for direct mentions. For more information, see "[Enabling push notifications with GitHub for mobile](#enabling-push-notifications-with-github-for-mobile)" or "[GitHub for mobile](/github/getting-started-with-github/github-for-mobile)." +Além disso, a caixa de entrada de notificações em +{% data variables.product.prodname_mobile %} permite que você faça triagem de notificações no modo escuro e receba notificações push para menções diretas. Para obter mais informações, consulte "[Habilitar notificações push com GitHub para celular](#enabling-push-notifications-with-github-for-mobile)" ou "[GitHub para celular](/github/getting-started-with-github/github-for-mobile)". {% endif %} -#### Benefits of using an email client for notifications +#### Benefícios da utilização de um cliente de e-mail para notificações -One benefit of using an email client is that all of your notifications can be kept indefinitely depending on your email client's storage capacity. Your inbox notifications are only kept for 5 months unless you've marked them as **Saved**. **Saved** notifications are kept indefinitely. For more information about your inbox's retention policy, see "[About notifications](/github/managing-subscriptions-and-notifications-on-github/about-notifications#notification-retention-policy)." +Um benefício de usar um cliente de e-mail é que todas as suas notificações podem ser mantidas indefinidamente, dependendo da capacidade de armazenamento do seu cliente de e-mail. Suas notificações na caixa de entrada só serão mantidas por 5 meses, a menos que você as tenha marcado como **Salvas**. As notificações **Saved** (Salvas) são mantidas indefinidamente. Para obter mais informações sobre a política de retenção da sua caixa de entrada, consulte "[Sobre notificações](/github/managing-subscriptions-and-notifications-on-github/about-notifications#notification-retention-policy)". -Sending notifications to your email client also allows you to customize your inbox according to your email client's settings, which can include custom or color-coded labels. +O envio de notificações para o cliente de e-mail também permite que você personalize sua caixa de entrada de acordo com as configurações do cliente de e-mail que pode incluir etiquetas personalizadas ou codificadas por cores. -Email notifications also allow flexibility with the types of notifications you receive and allow you to choose different email addresses for updates. For example, you can send certain notifications for a repository to a verified personal email address. For more information, about your email customization options, see "[Customizing your email notifications](#customizing-your-email-notifications)." +As notificações de e-mail também permitem flexibilidade com os tipos de notificações que você recebe e permitem que você escolha diferentes endereços de e-mail para atualizações. Por exemplo, você pode enviar determinadas notificações para um repositório para um endereço de e-mail pessoal verificado. Para obter mais informações, sobre suas opções de personalização de e-mail, consulte "[Personalizando suas notificações de e-mail](#customizing-your-email-notifications)." -### About participating and watching notifications +### Sobre notificações de participação e inspeção -When you watch a repository, you're subscribing to updates for activity in that repository. Similarly, when you watch a specific team's discussions, you're subscribing to all conversation updates on that team's page. To see repositories that you're watching, see [https://github.com/watching](https://github.com/watching). For more information, see "[Managing subscriptions and notifications on GitHub](/github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github)." +Quando você inspeciona um repositório, você assina atualizações de atividade nesse repositório. Da mesma forma, quando você inspeciona as discussões de uma equipe específica, você está inscrito em todas as atualizações de conversa na página daquela equipe. Para ver os repositórios que você está inspecionando, consulte [https://github.com/watching](https://github.com/watching). Para obter mais informações, consulte "[Gerenciando assinaturas e notificações do GitHub](/github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github)". -Anytime you comment in a conversation or when someone @mentions your username, you are _participating_ in a conversation. By default, you are automatically subscribed to a conversation when you participate in it. You can unsubscribe from a conversation you've participated in manually by clicking **Unsubscribe** on the issue or pull request or through the **Unsubscribe** option in the notifications inbox. +A qualquer momento que você comentar em uma conversa ou quando alguém @mencionar seu nome de usuário, você estará _participando_ de uma conversa. Por padrão, você é inscrito automaticamente em uma conversa ao participar dela. Você pode cancelar manualmente a inscrição de uma conversa que você participou, clicando em **Cancelar inscrição** no problema ou na pull request ou através da opção **Cancelar inscrição** na caixa de entrada de notificações. -For conversations you're watching or participating in, you can choose whether you want to receive notifications by email or through the notifications inbox on {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} and {% data variables.product.prodname_mobile %}{% endif %}. +Para conversas que você está inspecionando ou participando, você pode escolher se deseja receber notificações por e-mail ou através da caixa de entrada em {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} e {% data variables.product.prodname_mobile %}{% endif %}. -![Participating and watching notifications options](/assets/images/help/notifications-v2/participating-and-watching-options.png) +![Opções de notificações de participação e inspeção](/assets/images/help/notifications-v2/participating-and-watching-options.png) -For example: - - If you don't want notifications to be sent to your email, unselect **email** for participating and watching notifications. - - If you want to receive notifications by email when you've participated in a conversation, then you can select **email** under "Participating". +Por exemplo: + - Se você não quiser que as notificações sejam enviadas para o seu e-mail, desmarque **e-mail** para participar e inspecionar as notificações. + - Se quiser receber notificações por e-mail quando você participou de uma conversa, então selecione **e-mail** abaixo de "Participar". -If you do not enable watching or participating notifications for web{% if currentVersion == "free-pro-team@latest" %} and mobile{% endif %}, then your notifications inbox will not have any updates. +Se você não permite assistir ou participar de notificações da web{% if currentVersion == "free-pro-team@latest" %} e móvel{% endif %}, sua caixa de entrada de notificações não terá nenhuma atualização. -### Customizing your email notifications +### Personalizando suas notificações por e-mail -After enabling email notifications, {% data variables.product.product_name %} will send notifications to you as multipart emails that contain both HTML and plain text copies of the content. Email notification content includes any Markdown, @mentions, emojis, hash-links, and more, that appear in the original content on {% data variables.product.product_name %}. If you only want to see the text in the email, you can configure your email client to display the plain text copy only. +Após habilitar as notificações de e-mail, o {% data variables.product.product_name %} enviará notificações a você como e-mails em diversas partes que contêm cópias do conteúdo em HTML e texto sem formatação. O conteúdo da notificação de e-mail inclui markdown, @menção, emojis, links por hash e muito mais, que aparecem no conteúdo original do {% data variables.product.product_name %}. Se você quiser ver apenas o texto do e-mail, configure o cliente de e-mail para exibir apenas a cópia do texto sem formatação. {% data reusables.notifications.outbound_email_tip %} @@ -81,132 +82,135 @@ After enabling email notifications, {% data variables.product.product_name %} wi {% if currentVersion == "free-pro-team@latest" %} -If you're using Gmail, you can click a button beside the notification email to visit the original issue or pull request that generated the notification. +Se estiver usando o Gmail, você poderá clicar em um botão junto ao e-mail de notificação para acessar o problema ou a pull request original que gerou a notificação. -![Buttons in Gmail](/assets/images/help/notifications/gmail-buttons.png) +![Botões no Gmail](/assets/images/help/notifications/gmail-buttons.png) {% endif %} -Choose a default email address where you want to send updates for conversations you're participating in or watching. You can also specify which activity on {% data variables.product.product_name %} you want to receive updates for using your default email address. For example, choose whether you want updates to your default email from: - - Comments on issues and pull requests. - - Pull request reviews. - - Pull request pushes. - - Your own updates, such as when you open, comment on, or close an issue or pull request. +Escolha um endereço de e-mail padrão para enviar atualizações de conversas que você está participando ou inspecionando. Você também pode especificar qual atividade no {% data variables.product.product_name %} você deseja receber atualizações usando seu endereço de e-mail padrão. Por exemplo, escolha se você quer atualizações do seu e-mail padrão de: + - Comentários em problemas ou pull requests. + - Revisões de pull request. + - Pushes de pull request. + - Suas próprias atualizações, como quando você abre, comenta ou encerra um problema ou uma pull request. -Depending on the organization that owns the repository, you can also send notifications to different email addresses for specific repositories. For example, you can send notifications for a specific public repository to a verified personal email address. Your organization may require the email address to be verified for a specific domain. For more information, see “[Choosing where your organization’s email notifications are sent](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#choosing-where-your-organizations-email-notifications-are-sent)." +Dependendo da organização proprietária do repositório, também é possível enviar notificações para diferentes endereços de e-mail para repositórios específicos. Por exemplo, você pode enviar notificações para um repositório público específico para um endereço de e-mail pessoal verificado. Sua organização pode exigir que o endereço de e-mail seja verificado para um domínio específico. Para obter mais informações, consulte “[Escolhendo para onde as notificações de e-mail de sua organização serão enviadas](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#choosing-where-your-organizations-email-notifications-are-sent)". {% data reusables.notifications-v2.email-notification-caveats %} -### Filtering email notifications +### Filtrar notificações de e-mail -Each email notification that {% data variables.product.product_name %} sends contains header information. The header information in every email is consistent, so you can use it in your email client to filter or forward all {% data variables.product.product_name %} notifications, or certain types of {% data variables.product.product_name %} notifications. +Cada notificação de e-mail que o {% data variables.product.product_name %} envia contém informações de header. As informações de header em cada e-mail são consistentes, de modo que é possível usá-las no cliente de e-mail para filtrar ou encaminhar todas as notificações do {% data variables.product.product_name %} ou determinados tipos de notificação do {% data variables.product.product_name %}. -If you believe you're receiving notifications that don't belong to you, examine the `X-GitHub-Recipient` and `X-GitHub-Recipient-Address` headers. These headers show who the intended recipient is. Depending on your email setup, you may receive notifications intended for another user. +Se você acredita que está recebendo notificações que não pertencem a você, examine os headers `X-GitHub-Recipient` e `X-GitHub-Recipient-Address`. Estes headers mostram quem é o destinatário pretendido. Dependendo de sua configuração de e-mail, você pode receber notificações destinadas a outro usuário. -Email notifications from {% data variables.product.product_name %} contain the following header information: +As notificações de e-mail do {% data variables.product.product_name %} contêm as seguintes informações de header: -| Header | Information | -| --- | --- | -| `From` address | This address will always be {% if currentVersion == "free-pro-team@latest" %}'`notifications@github.com`'{% else %}'the no-reply email address configured by your site administrator'{% endif %}. | -| `To` field | This field connects directly to the thread. If you reply to the email, you'll add a new comment to the conversation. | -| `Cc` address | {% data variables.product.product_name %} will `Cc` you if you're subscribed to a conversation. The second `Cc` email address matches the notification reason. The suffix for these notification reasons is {% data variables.notifications.cc_address %}. The possible notification reasons are:
    • `assign`: You were assigned to an issue or pull request.
    • `author`: You created an issue or pull request.
    • `comment`: You commented on an issue or pull request.
    • `manual`: There was an update to an issue or pull request you manually subscribed to.
    • `mention`: You were mentioned on an issue or pull request.
    • `push`: Someone committed to a pull request you're subscribed to.
    • `review_requested`: You or a team you're a member of was requested to review a pull request.
    • `security_alert`: {% data variables.product.prodname_dotcom %} detected a vulnerability in a repository you receive alerts for.
    • `state_change`: An issue or pull request you're subscribed to was either closed or opened.
    • `subscribed`: There was an update in a repository you're watching.
    • `team_mention`: A team you belong to was mentioned on an issue or pull request.
    • `your_activity`: You opened, commented on, or closed an issue or pull request.
    | -| `mailing list` field | This field identifies the name of the repository and its owner. The format of this address is always `..{% data variables.command_line.backticks %}`. |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" % %} -| `X-GitHub-Severity` field | {% data reusables.repositories.security-alerts-x-github-severity %} The possible severity levels are:
    • `low`
    • `moderate`
    • `high`
    • `critical`
    For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." |{% endif %} +| Header | Informações | +| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Endereço do `remetente` | Este endereço será sempre {% if currentVersion == "free-pro-team@latest" %}'`notifications@github. om`'{% else %}'endereço de e-mail de não responda configurado pelo administrador do site'{% endif %}. | +| Campo `To` | Esse campo conecta-se diretamente ao thread. Se você responder ao e-mail, será adicionado um novo comentário à conversa. | +| Endereço de `Cc` | O {% data variables.product.product_name %} colocará você em cópia (`Cc`) se você estiver inscrito para uma conversa. O segundo endereço de e-mail de `Cc` corresponde ao motivo da notificação. O sufixo para esses motivos de notificação é {% data variables.notifications.cc_address %}. Os possíveis motivos de notificação são:
    • 'assign': você foi atribuído a um problema ou uma pull request.
    • 'author': você criou um problema ou uma pull request.
    • 'comment': você comentou um problema ou uma pull request.
    • 'manual': houve uma atualização em um problema ou uma pull request para o(a) qual você assinou manualmente.
    • 'mention': você foi mencionado em um problema ou uma pull request.
    • 'push': alguém fez commit em uma pull request que você assinou.
    • 'review_requested': você ou uma equipe da qual faz você faz parte foi solicitado para revisar uma pull request.
    • 'security_alert': o {% data variables.product.prodname_dotcom %} detectou uma vulnerabilidade em um repositório para o qual você recebe alertas de segurança.
    • 'state_change': um problema ou uma pull request que você assinou foi fechado(a) ou aberto(a).
    • 'subscribed': houve uma atualização em um repositório que você está inspecionando.
    • 'team_mention': uma equipe a qual você pertence foi mencionada em um problema ou uma pull request.
    • 'your_activity': você abriu, comentou ou fechou um problema ou uma pull request.
    | +| campo `mailing list` | Esse campo identifica o nome do repositório e seu proprietário. O formato desse endereço é sempre `..{% data variables.command_line.backticks %}`. |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" % %} +| campo `X-GitHub-Severity` | {% data reusables.repositories.security-alerts-x-github-severity %} Os níveis possíveis de gravidade são:
    • `low`
    • `moderate`
    • `high`
    • `critical`
    Para obter mais informações, consulte "[Sobre alertas para dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)" |{% endif %} -### Choosing your notification settings +### Escolhendo suas configurações de notificação {% data reusables.notifications.access_notifications %} {% data reusables.notifications-v2.manage-notifications %} -3. On the notifications settings page, choose how you receive notifications when: - - There are updates in repositories or team discussions you're watching or in a conversation you're participating in. For more information, see "[About participating and watching notifications](#about-participating-and-watching-notifications)." - - You gain access to a new repository or you've joined a new team. For more information, see "[Automatic watching](#automatic-watching)."{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} - - There are new {% data variables.product.prodname_dependabot_alerts %} in your repository. For more information, see "[{% data variables.product.prodname_dependabot_alerts %} options](#github-dependabot-alerts-options)." {% endif %}{% if currentVersion == "enterprise-server@2.21" %} - - There are new security alerts in your repository. For more information, see "[Security alert options](#security-alert-options)." {% endif %} {% if currentVersion == "free-pro-team@latest" %} - - There are workflow runs updates on repositories set up with {% data variables.product.prodname_actions %}. For more information, see "[{% data variables.product.prodname_actions %} notification options](#github-actions-notification-options)."{% endif %} +3. Na página de configurações de notificações, escolha como receber notificações quando: + - Há atualizações em repositórios ou discussões de equipe que você está inspecionando ou em uma conversa na qual você está participando. Para obter mais informações, consulte "[Sobre notificações de participação e inspeção](#about-participating-and-watching-notifications)". + - Você obtém acesso a um novo repositório ou se juntou a uma nova equipe. Para obter mais informações, consulte "[Inspeção automática](#automatic-watching)."{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} + - Há novos {% if page.version == 'dotcom' %} {% data variables.product.prodname_dependabot_alerts %} {% else %} alertas de segurança {% endif %} em seu repositório. Para obter mais informações, consulte "[{% data variables.product.prodname_dependabot_alerts %} opções de notificação](#github-dependabot-alerts-notification-options)". {% endif %}{% if currentVersion == "enterprise-server@2.21" %} + - Existem novos alertas de segurança no seu repositório. Para obter mais informações, consulte "[Opções de notificação de alerta de segurança](#security-alert-notification-options)". {% endif %} {% if currentVersion == "free-pro-team@latest" %} + - Há atualizações de fluxo de trabalho nos repositórios configurados com o {% data variables.product.prodname_actions %}. Para obter mais informações, consulte "[{% data variables.product.prodname_actions %} opções de notificação](#github-actions-notification-options)".{% endif %} -### Automatic watching +### Inspeção automática -By default, anytime you gain access to a new repository, you will automatically begin watching that repository. Anytime you join a new team, you will automatically be subscribed to updates and receive notifications when that team is @mentioned. If you don't want to automatically be subscribed, you can unselect the automatic watching options. +Por padrão, sempre que você obtiver acesso a um novo repositório, você começará a inspecionar aquele repositório automaticamente. Sempre que você entrar em uma nova equipe, você será automaticamente inscrito em atualizações e receberá notificações quando essa equipe for @mencionada. Se você não quiser ser automaticamente inscrito, você pode desmarcar as opções de inspeção automática. - ![Automatic watching options](/assets/images/help/notifications-v2/automatic-watching-options.png) + ![Opções de inspeção automática](/assets/images/help/notifications-v2/automatic-watching-options.png) -If "Automatically watch repositories" is disabled, then you will not automatically watch your own repositories. You must navigate to your repository page and choose the watch option. +Se "Inspecionar repositórios automaticamente" estiver desativado, então você não inspecionará automaticamente seus próprios repositórios. É necessário navegar na página do seu repositório e escolher a opção de inspeção. -### Choosing where your organization’s email notifications are sent +### Escolhendo para onde as notificações de e-mail da sua organização são enviadas -If you belong to an organization, you can choose the email account you want notifications for organization activity sent to. For example, if you belong to an organization for work, you may want your notifications sent to your work email address, rather than your personal address. +Se pertencer a uma organização, você poderá escolher a conta de e-mail em que deseja receber as notificações da atividade da organização. Por exemplo, se pertencer a uma organização para fins de trabalho, talvez você queira receber as notificações no seu endereço de e-mail profissional, e não no endereço pessoal. {% data reusables.notifications-v2.email-notification-caveats %} {% data reusables.notifications.access_notifications %} {% data reusables.notifications-v2.manage-notifications %} -3. Under "Default notification email", select the email address you'd like notifications sent to. -![Default notification email address drop-down](/assets/images/help/notifications/notifications_primary_email_for_orgs.png) -4. Click **Save**. +3. Em "Default notification email" (E-mail padrão de notificação), selecione o endereço de e-mail em que você quer receber as notificações. + ![Menu suspenso de endereço de e-mail padrão de notificação](/assets/images/help/notifications/notifications_primary_email_for_orgs.png) +4. Clique em **Salvar**. -#### Customizing email routes per organization +#### Personalizar rotas de e-mail por organização -If you are a member of more than one organization, you can configure each one to send notifications to any of{% if currentVersion == "free-pro-team@latest" %} your verified email addresses{% else %} the email addressed you've added to your {% data variables.product.product_name %} account{% endif %}. {% if currentVersion == "free-pro-team@latest" %} For more information, see "[Verifying your email address](/articles/verifying-your-email-address)."{% endif %} +Se você for integrante de mais de uma organização, você poderá configurar cada uma para enviar notificações a qualquer um de{% if currentVersion == "free-pro-team@latest" %} seus endereços de e-mail verificados{% else %} o e-mail que você adicionou à sua conta de {% data variables.product.product_name %}{% endif %}. {% if currentVersion == "free-pro-team@latest" %} Para obter mais informações, consulte "[verificar o seu endereço de e-mail](/articles/verifying-your-email-address)".{% endif %} {% data reusables.notifications.access_notifications %} {% data reusables.notifications-v2.manage-notifications %} -3. Under "Custom routing," find your organization's name in the list. -![List of organizations and email addresses](/assets/images/help/notifications/notifications_org_emails.png) -4. Click **Edit** next to the email address you want to change. -![Editing an organization's email addresses](/assets/images/help/notifications/notifications_edit_org_emails.png) -5. Select one of your verified email addresses, then click **Save**. -![Switching your per-org email address](/assets/images/help/notifications/notifications_switching_org_email.gif) +3. Na lista em "Custom routing" (Encaminhamento personalizado), localize o nome da sua organização. + ![Lista de organizações e endereços de e-mail](/assets/images/help/notifications/notifications_org_emails.png) +4. Clique em **Edit** (Editar) ao lado do endereço de e-mail que você pretende alterar. ![Editar endereços de e-mail da organização](/assets/images/help/notifications/notifications_edit_org_emails.png) +5. Selecione um dos seus endereços de e-mail verificados e clique em **Save** (Salvar). + ![Alterar o endereço de e-mail por organização](/assets/images/help/notifications/notifications_switching_org_email.gif) {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -### {% data variables.product.prodname_dependabot_alerts %} options +### Opções de notificação {% data variables.product.prodname_dependabot_alerts %} {% else %} -### Security alert options +### Opções de notificação de alerta de segurança {% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}Choose how you want to receive {% data variables.product.prodname_dependabot_alerts %} for repositories that you are watching. You can receive {% data variables.product.prodname_dependabot_alerts %} in your inbox, as a banner on {% data variables.product.product_name %}, on the command line, through email, or some combination of these options. +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}Escolha como deseja receber {% data variables.product.prodname_dependabot_alerts %} para os repositórios que você está inspecionando. Você pode receber {% if page.version == 'dotcom' %} {% data variables.product.prodname_dependabot_alerts %} {% else %} alertas de segurança {% endif %} na sua caixa de entrada, como um banner no {% data variables.product.product_name %}, na linha de comando, por email ou alguma combinação dessas opções. -If you want to receive {% data variables.product.prodname_dependabot_alerts %} by email, choose whether you want a weekly email summary of vulnerabilities for up 10 repositories or a new email each time a vulnerability is detected. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)."{% endif %} +Se quiser receber {% data variables.product.prodname_dependabot_alerts %} por e-mail, escolha se você deseja receber um resumo semanal de vulnerabilidades para até 10 repositórios ou se deseja receber um novo email cada vez que uma vulnerabilidade for detectada. Para obter mais informações, consulte "[Sobre alertas para dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)". {% endif %} -{% if currentVersion == "enterprise-server@2.21" %}Choose how you want to receive security alerts for repositories that you are watching. You can receive security alerts in your inbox, as a banner on {% data variables.product.product_name %}, on the command line, through email, or some combination of these options. +{% if currentVersion == "enterprise-server@2.21" %}Escolha como deseja receber alertas de segurança para os repositórios que você está inspecionando. Você pode receber alertas de segurança na sua caixa de entrada, como um banner no {% data variables.product.product_name %}, na linha de comando, por e-mail ou alguma combinação dessas opções. -If you want to receive security alerts by email, choose whether you want a weekly email summary of vulnerabilities for up 10 repositories or a new email each time a vulnerability is detected. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)."{% endif %} +Se você desejar receber alertas de segurança por e-mail, escolha se você deseja receber um resumo semanal de vulnerabilidades para até 10 repositórios ou se deseja receber um novo e-mail cada vez que uma vulnerabilidade for detectada. Para obter mais informações, consulte "[Sobre alertas para dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)". {% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} - ![{% data variables.product.prodname_dependabot_short %} alerts options](/assets/images/help/notifications-v2/dependabot-alerts-options.png) + ![Opções de alertas {% data variables.product.prodname_dependabot_short %} ](/assets/images/help/notifications-v2/dependabot-alerts-options.png) {% else %} - ![Security alerts options](/assets/images/help/notifications-v2/security-alerts-options.png) + ![Opções de alerta de segurança](/assets/images/help/notifications-v2/security-alerts-options.png) {% endif %} +{% note %} + +**Observação:** Você pode filtrar as notificações da sua caixa de entrada de {% data variables.product.company_short %} por {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 1" %}{% data variables.product.prodname_dependabot_short %}{% else %} alertas de segurança{% endif %}. Para obter mais informações, consulte "[Gerenciando notificações de sua caixa de entrada](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox#supported-queries-for-custom-filters)". + +{% endnote %} + {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -### {% data variables.product.prodname_actions %} notification options +### Opções de notificação {% data variables.product.prodname_actions %} -Choose how you want to receive workflow run updates for repositories that you are watching that are set up with {% data variables.product.prodname_actions %}. You can also choose to only receive notifications for failed workflow runs. +Escolha como você deseja receber atualizações de execução de fluxo de trabalho para repositórios que você está inspecionando que estão configurados com o {% data variables.product.prodname_actions %}. Você também pode optar por receber apenas notificações de execução de fluxo de trabalho falha. - ![Notification options for {% data variables.product.prodname_actions %}](/assets/images/help/notifications-v2/github-actions-notification-options.png) + ![Opções de alertas {% data variables.product.prodname_dependabot_short %}](/assets/images/help/notifications-v2/github-actions-notification-options.png) {% endif %} {% if currentVersion == "free-pro-team@latest" %} -### Enabling push notifications with {% data variables.product.prodname_mobile %} +### Habilitando notificações push com {% data variables.product.prodname_mobile %} -When you install {% data variables.product.prodname_mobile %}, you will automatically be opted into web notifications. You can then enable push notifications for direct mentions within the app. +Quando você instalar {% data variables.product.prodname_mobile %}, você será automaticamente incluído em notificações da web. Você poderá então ativar notificações push para menções diretas no app. -You can only receive notifications for pushes to repositories on {% data variables.product.prodname_mobile %} at this time. +Você só pode receber notificações de pushes para repositórios no {% data variables.product.prodname_mobile %} neste momento. -#### Enabling push notifications with {% data variables.product.prodname_ios %} +#### Habilitando notificações push com {% data variables.product.prodname_ios %} -1. Above "Home", tap your profile photo. -2. To view your settings, tap {% octicon "gear" aria-label="The Gear icon" %}. - ![Settings icon for GitHub for iOS](/assets/images/help/mobile/ios-settings-icon.png) -3. To update your notification settings, tap **Push notifications**. -4. To turn on push notifications for direct mentions, use the **Direct Mentions** toggle. +1. Acima de "Home", clique na foto do seu perfil. +2. Para ver suas configurações, clique em {% octicon "gear" aria-label="The Gear icon" %}. ![Ícone de configurações para GitHub para iOS](/assets/images/help/mobile/ios-settings-icon.png) +3. Para atualizar suas configurações de notificação, clique em **Notificações push**. +4. Para ativar as notificações push para menções diretas, use a alternância **Menções Diretas**. -#### Enabling push notifications with {% data variables.product.prodname_android %} +#### Habilitando notificações push com {% data variables.product.prodname_android %} -1. Above "Home", tap your profile photo. -2. To view your settings, tap {% octicon "gear" aria-label="The Gear icon" %}. - ![Settings icon for GitHub for Android](/assets/images/help/mobile/android-settings-icon.png) -3. To turn on push notifications for direct mentions, use the **Direct mentions** toggle. +1. Acima de "Home", clique na foto do seu perfil. +2. Para ver suas configurações, clique em {% octicon "gear" aria-label="The Gear icon" %}. ![Ícone de configurações para GitHub para iOS](/assets/images/help/mobile/android-settings-icon.png) +3. Para ativar as notificações push para menções diretas, use a alternância **Menções Diretas**. {% endif %} diff --git a/translations/pt-BR/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md b/translations/pt-BR/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md index 5dda009cb10f..74b9fb8fc5c3 100644 --- a/translations/pt-BR/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md +++ b/translations/pt-BR/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md @@ -1,6 +1,6 @@ --- title: Gerenciamento de notificações da sua caixa de entrada -intro: 'Utilize sua caixa de entrada para rapidamente fazer triagem e sincronizar suas notificações do e-mail{% if currentVersion == "free-pro-team@latest" %} e o aparelho móvel{% endif %}.' +intro: 'Use a sua caixa de entrada para rapidamente rastrear e sincronizar as notificações entre os e-mails{% if currentVersion == "free-pro-team@latest" %} e dispositivos móveis{% endif %}.' redirect_from: - /articles/marking-notifications-as-read - /articles/saving-notifications-for-later @@ -19,7 +19,6 @@ Para acessar sua caixa de entrada de notificações, no canto superior direito d ![Notificação indicando qualquer mensagem não lida](/assets/images/help/notifications/notifications_general_existence_indicator.png) - Sua caixa de entrada mostra todas as notificações que você não cancelou sua inscrição ou marcou como **Concluído.** Você pode personalizar sua caixa de entrada para melhor se adequar ao seu fluxo de trabalho usando filtros, visualizando todas ou apenas notificações não lidas e agrupando suas notificações para obter uma visão geral. ![visualização da caixa de entrada](/assets/images/help/notifications-v2/inbox-view.png) @@ -113,7 +112,7 @@ Para filtrar notificações por motivos pelos quais recebeu uma atualização, v #### Consultas suportadas `is:` -Para filtrar notificações para uma atividade específica no {% data variables.product.product_name %}, você pode usar a consulta `is`. Por exemplo, para ver apenas atualizações de convite do repositório, use `is:repository-invitation`. +Para filtrar notificações para uma atividade específica no {% data variables.product.product_name %}, você pode usar a consulta `is`. Por exemplo, para visualizar apenas atualizações de convite do repositório, use `is:repository-invitation` e para visualizar apenas {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 1" %}{% data variables.product.prodname_dependabot_short %}{% else %} alertas de segurança{% endif %}, use `is:repository-vulnerability-alert`. - `is:check-suite` - `is:commit` diff --git a/translations/pt-BR/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md b/translations/pt-BR/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md index 0269a949ec15..fde2dea8c2a8 100644 --- a/translations/pt-BR/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md +++ b/translations/pt-BR/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md @@ -10,7 +10,7 @@ Para ajudá-lo a entender suas assinaturas e decidir se deseja cancelar sua assi {% note %} -**Observação:** Em vez de cancelar a assinatura, você tem a opção de ignorar um repositório. Nesse caso, você deixará de receber notificações. Não recomendamos ignorar repositórios porque você não será notificado caso seja @mencionado. {% if currentVersion == "free-pro-team@latest" %}Se você estiver sendo incomodado e quiser ignorar um repositório, [entre em contato com o suporte](/contact) para que possamos ajudá-lo. {% data reusables.policies.abuse %}{% endif %} +**Observação:** Em vez de cancelar a assinatura, você tem a opção de ignorar um repositório. Nesse caso, você deixará de receber notificações. Não recomendamos ignorar repositórios porque você não será notificado caso seja @mencionado. {% if currentVersion == "free-pro-team@latest" %}Se você está identificando abuso e deseja ignorar um repositório, [entre em contato com o suporte](/contact) para que possamos ajudar. {% data reusables.policies.abuse %}{% endif %} {% endnote %} diff --git a/translations/pt-BR/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md b/translations/pt-BR/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md index c19b55fb8d27..6ffbfb1bdfa7 100644 --- a/translations/pt-BR/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md +++ b/translations/pt-BR/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md @@ -22,15 +22,15 @@ Se você criar um URL inválido usando parâmetros de consulta, ou se não tiver ### Parâmetros de consulta compatíveis -| Parâmetro de consulta | Exemplo | -| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `texto` | `https://github.com/octo-org/octo-repo/compare/master...pull-request-test?quick_pull=1&body=Fixes+the+problem.` cria uma pull request, comparando os branches `master` e `pull-request-test`, com o comentário "Corrige o problema" no texto da pull request. | -| `title` | `https://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report` cria um problema com a etiqueta "erro" e o título "Novo relatório de erros". | -| `etiquetas` | `https://github.com/octo-org/octo-repo/compare/master...pull-request-test?quick_pull=1&labels=bug` cria uma pull request, comparando os branches `master` e `pull-request-test`, com a etiqueta "erro". | -| `modelo` | `https://github.com/octo-org/octo-repo/issues/new?template=issue_template.md` cria um problema com um modelo no texto do problema. | -| `marco` | `https://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones` cria um problema com o marco "marcos de teste". | -| `assignees` | `https://github.com/octo-org/octo-repo/issues/new?assignees=octocat` cria um problema e o atribui a @octocat. | -| `projetos` | `https://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1` cria um problema com o título "Correção de erro" e o adiciona ao quadro de projeto 1 da organização. | +| Parâmetro de consulta | Exemplo | +| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `texto` | `https://github.com/octo-org/octo-repo/compare/main...pull-request-test?quick_pull=1&body=Fixes+the+problem.` cria um pull request que compara os branches `main` and `pull-request-test`, com o comentário "Corrige o problema" no texto do pull request. | +| `title` | `https://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report` cria um problema com a etiqueta "erro" e o título "Novo relatório de erros". | +| `etiquetas` | `https://github.com/octo-org/octo-repo/compare/main...pull-request-test?quick_pull=1&labels=bug` cria um pull request que compara os branches `main` e `pull-request-test` com a etiqueta "erro". | +| `modelo` | `https://github.com/octo-org/octo-repo/issues/new?template=issue_template.md` cria um problema com um modelo no texto do problema. | +| `marco` | `https://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones` cria um problema com o marco "marcos de teste". | +| `assignees` | `https://github.com/octo-org/octo-repo/issues/new?assignees=octocat` cria um problema e o atribui a @octocat. | +| `projetos` | `https://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1` cria um problema com o título "Correção de erro" e o adiciona ao quadro de projeto 1 da organização. | ### Preencher problemas e pull requests com modelos personalizados diff --git a/translations/pt-BR/content/github/managing-your-work-on-github/about-automation-for-project-boards.md b/translations/pt-BR/content/github/managing-your-work-on-github/about-automation-for-project-boards.md index 117691848769..b2236a36c8ee 100644 --- a/translations/pt-BR/content/github/managing-your-work-on-github/about-automation-for-project-boards.md +++ b/translations/pt-BR/content/github/managing-your-work-on-github/about-automation-for-project-boards.md @@ -32,5 +32,5 @@ A automação do quadro de projeto também pode ajudar as equipes a desenvolver A automação do quadro de projeto permite o acompanhamento do andamento por padrão. Os cartões em colunas com as predefinições "Tarefas pendentes", "Em andamento" ou "Concluído" contam no andamento geral do projeto. {% data reusables.project-management.project-progress-locations %} ### Leia mais -- "[Configurar a automação para quadros de projeto](/articles/configuring-automation-for-project-boards)"{% if currentVersion == "free-pro-team@latest" %} +- "[Configurar automação para quadros de projeto](/articles/configuring-automation-for-project-boards)"{% if currentVersion == "free-pro-team@latest" %} - "[Copiar um quadro de projeto](/articles/copying-a-project-board)"{% endif %} diff --git a/translations/pt-BR/content/github/managing-your-work-on-github/about-issues.md b/translations/pt-BR/content/github/managing-your-work-on-github/about-issues.md index 455f45a3c293..7c232844f04e 100644 --- a/translations/pt-BR/content/github/managing-your-work-on-github/about-issues.md +++ b/translations/pt-BR/content/github/managing-your-work-on-github/about-issues.md @@ -3,7 +3,7 @@ title: Sobre problemas intro: 'Use problemas para rastrear ideias, aprimoramentos, tarefas ou erros para trabalhar no {% data variables.product.product_name %}.' redirect_from: - /articles/creating-issues/ - - /articles/about-issues + - /articles/about-issues/ versions: free-pro-team: '*' enterprise-server: '*' @@ -13,7 +13,7 @@ Você pode coletar feedback, reportar erros de software e organizar tarefas que {% data reusables.pull_requests.close-issues-using-keywords %} -Para se manter atualizado sobre os comentários mais recentes em um problema, você pode inspecionar um problema a fim de recebe notificações sobre os últimos comentários. Para obter mais informações, consulte {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[Sobre notificações](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}"[Sobre notificações](/github/receiving-notifications-about-activity-on-github/about-notifications)"{% endif %}." +Para se manter atualizado sobre os comentários mais recentes em um problema, você pode inspecionar um problema a fim de recebe notificações sobre os últimos comentários. Para obter mais informações, consulte {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 0" %}"[Sobre as notificações](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}"[Sobre as notificações](/github/receiving-notifications-about-activity-on-github/about-notifications){% endif %}". Para encontrar links para problemas atualizados recentemente nos quais você está inscrito, visite seu painel. Para obter mais informações, consulte "[Sobre seu painel pessoal](/articles/about-your-personal-dashboard)". @@ -22,10 +22,10 @@ Para encontrar links para problemas atualizados recentemente nos quais você est Com problemas, você pode: - Acompanhar e priorizar seu trabalho usando quadros de projeto. Para obter mais informações, consulte "[Usar quadros de projeto](/articles/about-project-boards)". - Criar novos problemas para rastrear feedbacks fora do escopo a partir de um comentário em um problema ou de uma revisão de pull request. Para obter mais informações, consulte "[Abrir um problema a partir de um comentário](/github/managing-your-work-on-github/opening-an-issue-from-a-comment)". -- Criar modelos de problema para ajudar os contribuidores a abrir problemas significativos. Para obter mais informações, consulte "[Sobre modelos de problema e pull request](/articles/about-issue-and-pull-request-templates)".{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -- Transferir problemas abertos para outros repositórios. Para obter mais informações, consulte "[Transferir um problema para outro repositório](/articles/transferring-an-issue-to-another-repository)".{% endif %} +- Criar modelos de problema para ajudar os contribuidores a abrir problemas significativos. Para obter mais informações, consulte "[Sobre modelos de problema e pull request](/articles/about-issue-and-pull-request-templates)". +- Transferir problemas abertos para outros repositórios. Para obter mais informações, consulte "[Transferir um problema para outro repositório](/articles/transferring-an-issue-to-another-repository)". - Fixar problemas importantes para que seja mais fácil encontrá-los, evitando a duplicação de problemas e reduzindo ruídos. Para obter mais informações, consulte "[Fixar um problema no seu repositório](/articles/pinning-an-issue-to-your-repository)". -- Acompanhar problemas duplicados usando respostas salvas. Para obter mais informações, consulte "[Sobre respostas salvas](/articles/about-saved-replies)".{% if currentVersion == "free-pro-team@latest" %} +- Acompanhar problemas duplicados usando respostas salvas. Para obter mais informações, consulte "[Sobre respostas salvas](/articles/about-saved-replies)."{% if currentVersion == "free-pro-team@latest" %} - Relatar comentários que violam as [Diretrizes da comunidade](/articles/github-community-guidelines) do {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte "[Relatar abuso ou spam](/articles/reporting-abuse-or-spam)".{% endif %} Os problemas também podem ser [atribuídos a outros usuários](/articles/assigning-issues-and-pull-requests-to-other-github-users), [marcados com etiquetas](/articles/applying-labels-to-issues-and-pull-requests) para pesquisa mais rápida e [agrupados com marcos](/articles/creating-and-editing-milestones-for-issues-and-pull-requests). diff --git a/translations/pt-BR/content/github/managing-your-work-on-github/about-labels.md b/translations/pt-BR/content/github/managing-your-work-on-github/about-labels.md index 1d9a57e05d91..259b214975dd 100644 --- a/translations/pt-BR/content/github/managing-your-work-on-github/about-labels.md +++ b/translations/pt-BR/content/github/managing-your-work-on-github/about-labels.md @@ -16,17 +16,17 @@ Qualquer pessoa com acesso de leitura a um repositório pode exibir e pesquisar O {% data variables.product.product_name %} fornece etiquetas padrão para todos os repositórios novos. Você pode usar essas etiquetas padrão para ajudar com a criação de um fluxo de trabalho padronizado em um repositório: -| Etiqueta | Descrição | -| ------------------ | -------------------------------------------------------------------------------------------------------------------------- | -| `bug` | Indica um problema inesperado ou comportamento involuntário{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| `documentation` | Indica a necessidade de aprimoramentos ou adições à documentação{% endif %} -| `duplicate` | Indica problemas ou pull requests semelhantes | -| `enhancement` | Indica novas solicitações de recurso | -| `good first issue` | Indica um bom problema para contribuidores principiantes | -| `help wanted` | Indica que um mantenedor deseja ajudar em um problema ou uma pull request | -| `invalid` | Indica que um problema ou uma pull request não é mais relevante | -| `question` | Indica que um problema ou uma pull request precisa de mais informações | -| `wontfix` | Indica que o trabalho não continuará em um problema ou uma pull request | +| Etiqueta | Descrição | +| ------------------ | ------------------------------------------------------------------------- | +| `bug` | Indica um problema inesperado ou um comportamento indesejado | +| `documentation` | Indica a necessidade de aprimoramentos ou adições à documentação | +| `duplicate` | Indica problemas ou pull requests semelhantes | +| `enhancement` | Indica novas solicitações de recurso | +| `good first issue` | Indica um bom problema para contribuidores principiantes | +| `help wanted` | Indica que um mantenedor deseja ajudar em um problema ou uma pull request | +| `invalid` | Indica que um problema ou uma pull request não é mais relevante | +| `question` | Indica que um problema ou uma pull request precisa de mais informações | +| `wontfix` | Indica que o trabalho não continuará em um problema ou uma pull request | Etiquetas padrão são incluídas em todos os novos repositórios quando criados, mas você pode editar ou excluir as etiquetas posteriormente. Para obter mais informações, consulte "[Excluir uma etiqueta](/articles/deleting-a-label/)". diff --git a/translations/pt-BR/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md b/translations/pt-BR/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md index 28adeb637554..650bcb40efa1 100644 --- a/translations/pt-BR/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md +++ b/translations/pt-BR/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md @@ -54,15 +54,8 @@ Você pode adicionar cartões de problema ou pull request ao seu quadro de proje 1. No lado direito de um problema ou uma pull request, clique em **Projects (Projetos) {% octicon "gear" aria-label="The Gear icon" %}**. ![Botão Project board (Quadro de projeto) na barra lateral](/assets/images/help/projects/sidebar-project.png) 2. Clique na aba **Recent** (Recente), **Repository** (Repositório), **User** (Usuário) ou **Organization** (Organização) do quadro de projeto ao qual deseja adicionar. ![Guias Recent (Recente), Repository (Repositório) e Organization (Organização)](/assets/images/help/projects/sidebar-project-tabs.png) 3. Digite o nome do projeto no campo **Filter projects** (Filtrar projetos). ![Caixa de pesquisa Project board (Quadro de projeto)](/assets/images/help/projects/sidebar-search-project.png) -4. Selecione um ou mais quadros de projetos onde você deseja adicionar o problema ou pull request. ![Quadro de projeto selecionado](/assets/images/help/projects/sidebar-select-project.png){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -5. Clique em -{% octicon "triangle-down" aria-label="The down triangle icon" %} e, em seguida, clique na coluna onde você quer seu problema ou pull request. O cartão irá para a parte inferior da coluna do quadro de projeto que você selecionou. - ![Menu Move card to column (Mover cartão para coluna)](/assets/images/help/projects/sidebar-select-project-board-column-menu.png) -{% else %} -5. No lado direito de um problema ou uma pull request, clique em **NOME DO QUADRO DE PROJETO (awaiting triage)** (aguardando triagem). ![Link para o quadro de projeto](/assets/images/help/projects/sidebar-project-board-link.png) -6. No quadro de projeto, clique em **{% octicon "plus" aria-label="The Plus icon" %} Add cards (1 new)** (Adicionar cartão) (1 novo). ![Botão Add cards (Adicionar cartões)](/assets/images/help/projects/add-cards-pending-button.png) -7. Arraste o cartão do problema ou da pull request da seção **Triage** (Triagem) para a coluna desejada no quadro de projeto. Como alternativa, você pode mover cartões usando os atalhos de teclado. {% data reusables.project-management.for-more-info-project-keyboard-shortcuts %} -{% endif %} +4. Selecione um ou mais quadros de projeto ao qual você deseja adicionar o problema ou pull request. ![Quadro de projeto selecionado](/assets/images/help/projects/sidebar-select-project.png) +5. Clique em {% octicon "triangle-down" aria-label="The down triangle icon" %} e depois na coluna onde você quer seu problema ou pull request. O cartão irá para a parte inferior da coluna do quadro de projeto que você selecionou. ![Menu Move card to column (Mover cartão para coluna)](/assets/images/help/projects/sidebar-select-project-board-column-menu.png) ### Leia mais diff --git a/translations/pt-BR/content/github/managing-your-work-on-github/applying-labels-to-issues-and-pull-requests.md b/translations/pt-BR/content/github/managing-your-work-on-github/applying-labels-to-issues-and-pull-requests.md index 058b7b5cfedc..c3835dd799ce 100644 --- a/translations/pt-BR/content/github/managing-your-work-on-github/applying-labels-to-issues-and-pull-requests.md +++ b/translations/pt-BR/content/github/managing-your-work-on-github/applying-labels-to-issues-and-pull-requests.md @@ -11,14 +11,15 @@ versions: {% tip %} -**Dica:** também é possível aplicar uma etiqueta no menu suspenso Labels (Etiquetas) em um problema ou uma pull request. +**Dica:** Você pode aplicar até um máximo de 100 etiquetas para problemas e pull requests. {% endtip %} {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issue-pr %} {% data reusables.repositories.select-items-in-issue-or-pr-list %} -4. No canto superior direito, clique em **Label** (Etiqueta) e comece a digitar o nome de uma etiqueta existente. Clique no nome da etiqueta para associá-la aos itens selecionados. ![Menu suspenso atribuição Marco Problemas](/assets/images/help/issues/issues_applying_labels_dropdown.png) +4. No canto superior direito, clique em **Label** (Etiqueta) e comece a digitar o nome de uma etiqueta existente. Clique no nome da etiqueta para associá-la aos itens selecionados. Você também pode aplicar uma etiqueta no menu suspenso de etiquetas dentro de um problema ou pull request. ![Menu suspenso atribuição Marco Problemas](/assets/images/help/issues/issues_applying_labels_dropdown.png) + ### Leia mais diff --git a/translations/pt-BR/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md b/translations/pt-BR/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md index 9a307173fcba..e57d7c04f882 100644 --- a/translations/pt-BR/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md +++ b/translations/pt-BR/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md @@ -10,7 +10,7 @@ versions: Qualquer pessoa com permissões de gravação em um repositório pode atribuir problemas e pull requests. -Você pode atribuir até 10 pessoas a cada problema ou pull request, incluindo a si mesmo,{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} qualquer pessoa que tenha comentado sobre o problema ou a pull request, {% endif %} qualquer pessoa com permissões de gravação no repositório e integrantes da organização com permissões de leitura no repositório. Para obter mais informações, consulte "[Permissões de acesso no {% data variables.product.prodname_dotcom %}](/articles/access-permissions-on-github)". +Você pode atribuir até 10 pessoas a cada problema ou pull request, incluindo a si mesmo, qualquer pessoa que comentou sobre o problema ou pull request, qualquer pessoa com permissões de gravação no repositório e integrantes da organização com permissões de leitura no repositório. Para obter mais informações, consulte "[Permissões de acesso no {% data variables.product.prodname_dotcom %}](/articles/access-permissions-on-github)". {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issue-pr %} diff --git a/translations/pt-BR/content/github/managing-your-work-on-github/disabling-issues.md b/translations/pt-BR/content/github/managing-your-work-on-github/disabling-issues.md index 699a38bb1918..cfd3b6ceeeb4 100644 --- a/translations/pt-BR/content/github/managing-your-work-on-github/disabling-issues.md +++ b/translations/pt-BR/content/github/managing-your-work-on-github/disabling-issues.md @@ -1,6 +1,6 @@ --- title: Desabilitar problemas -intro: 'Se você não aceita contribuições ou relatórios de erros, convém desativar problemas do seu repositório.' +intro: Se você não aceita contribuições ou relatórios de erros, convém desativar problemas do seu repositório. redirect_from: - /articles/disabling-issues versions: @@ -17,8 +17,9 @@ Se você decidir habilitar problemas novamente no futuro, qualquer problema que {% if currentVersion == "free-pro-team@latest" %} {% tip %} +Entre em contato com -Entre em contato com {% data variables.contact.contact_support %} caso queira desativar problemas por causa de abuso de estranhos. +{% data variables.contact.contact_support %} se quiser desativar os problemas em razão de abuso de estranhos. {% data reusables.policies.abuse %} {% endtip %} diff --git a/translations/pt-BR/content/github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests.md b/translations/pt-BR/content/github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests.md index b882d1a0352f..53a67879b052 100644 --- a/translations/pt-BR/content/github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests.md +++ b/translations/pt-BR/content/github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests.md @@ -1,6 +1,6 @@ --- -title: Anexar arquivos em problemas e pull requests -intro: 'Ao abrir um problema ou atualizar uma pull request, é possível usar a publicação de anexos para fazer upload de imagens de recursos propostos ou capturas de tela de erros.' +title: File attachments on issues and pull requests +intro: 'When you open issue or update a pull request, you can use issue attachments to upload images of proposed features or screenshots of bugs.' redirect_from: - /articles/issue-attachments/ - /articles/file-attachments-on-issues-and-pull-requests @@ -8,34 +8,33 @@ versions: free-pro-team: '*' enterprise-server: '*' --- - {% warning %} -**Aviso:** caso você inclua uma imagem para uma pull request ou comentário de problemas, qualquer pessoa poderá ver a URL anônima de imagem sem autenticação, mesmo se a pull request estiver em um repositório privado{% if currentVersion != "free-pro-team@latest" %} ou se o modo privado estiver habilitado{% endif %}. Para manter imagens confidenciais privadas, use uma rede privada ou um servidor que requer autenticação. {% if currentVersion == "free-pro-team@latest" %}Para obter mais informações sobre URLs anônimas, consulte "[Sobre URLs anônimos de imagem](/articles/about-anonymized-image-urls)".{% endif %} +**Warning:** If you add an image to a pull request or issue comment, anyone can view the anonymized image URL without authentication, even if the pull request is in a private repository{% if currentVersion != "free-pro-team@latest" %}, or if private mode is enabled{% endif %}. To keep sensitive images private, serve them from a private network or server that requires authentication. {% if currentVersion == "free-pro-team@latest" %}For more information on anonymized URLs see "[About anonymized image URLs](/articles/about-anonymized-image-urls)".{% endif %} {% endwarning %} -Para anexar um arquivo a uma conversa sobre um problema ou pull request, arraste-o e solte-o dentro da caixa de comentários. Como alternativa, você pode clicar na barra na parte inferior da caixa de comentários para navegar, selecionar e adicionar um arquivo do seu computador. +To attach a file to an issue or pull request conversation, drag and drop it into the comment box. Alternatively, you can click the bar at the bottom of the comment box to browse, select, and add a file from your computer. -![Selecionar anexos do computador](/assets/images/help/pull_requests/select-bar.png) +![Select attachments from computer](/assets/images/help/pull_requests/select-bar.png) {% tip %} -**Dica:** se estiver usando o Chrome, também é possível copiar e colar imagens diretamente na caixa. +**Tip:** If you're using Chrome, you can also copy-and-paste images directly into the box. {% endtip %} -O tamanho máximo é de 25MB para arquivos e 10MB para imagens. +The maximum size for files is 25MB and the maximum size for images is 10MB. -Arquivos compatíveis: +We support these files: * PNG (*.png*) * GIF (*.gif*) * JPEG (*.jpg*) -* Arquivos log (*.log*) -* Documentos do Microsoft Word (*.docx*), Powerpoint (*.pptx*), e Excel (*.xlsx*) -* Arquivos de texto (*.txt*) +* Log files (*.log*) +* Microsoft Word (*.docx*), Powerpoint (*.pptx*), and Excel (*.xlsx*) documents +* Text files (*.txt*) * PDFs (*.pdf*) * ZIP (*.zip*, *.gz*) -![Anexos GIF animados](/assets/images/help/pull_requests/dragging_images.gif) +![Attachments animated GIF](/assets/images/help/pull_requests/dragging_images.gif) diff --git a/translations/pt-BR/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md b/translations/pt-BR/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md index fa5a2bbde939..0c0797d902e2 100644 --- a/translations/pt-BR/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md +++ b/translations/pt-BR/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md @@ -8,20 +8,20 @@ versions: enterprise-server: '*' --- -Em um cartão, clique em qualquer responsável{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}, marco{% endif %} ou etiqueta para usar esse qualificador para filtrar no quadro de projetos. Para limpar a pesquisa, clique novamente no mesmo responsável{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}, marco{% endif %} ou etiqueta. +Em um cartão, você pode clicar em qualquer responsável, marco ou etiqueta para filtrar o quadro de projeto por esse qualificador. Para limpar a pesquisa, você pode clicar no mesmo responsável, marco ou etiqueta novamente. Também é possível usar a barra de pesquisa "Filter cards" (Fitrar cartões) que está na parte superior de cada quadro de projetos para pesquisar por cartões. Você pode filtrar cartões usando os seguintes qualificadores de pesquisa em qualquer combinação ou simplesmente digitando algum texto que você gostaria de pesquisar. - Filtrar cartões por autor com `author:USERNAME` - Filtrar cartões por responsável com `assignee:USERNAME` ou `no:assignee` -- Filtrar cartões por etiqueta com `label:LABEL`, `label:"MULTI-WORD LABEL NAME"` ou `no:label`{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -- Filtrar por marco com `milestone:MY-MILESTONE`{% endif %} +- Filtrar cartões por etiqueta usando `label:LABEL`, `label:"MULTI-WORD LABEL NAME"` ou `no:label` +- Filtrar por marco com `milestone:MY-MILESTONE` - Filtrar cartões por estado com `state:open`, `state:closed` ou `state:merged` - Filtrar por status de revisão com `review:none`, `review:required`, `review:approved` ou `review:changes_requested` - Filtrar cartões por status de verificação com `status:pending`, `status:success` ou `status:failure` - Filtrar cartões por tipo com `type:issue`, `type:pr` ou `type:note` - Filtrar cartões por estado e tipo com `is:open`, `is:closed` ou `is:merged`; e `is:issue`, `is:pr` ou `is:note` -- Filtrar cartões por problemas vinculados a uma pull request por uma referência de fechamento usando `linked:pr`{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +- Filtrar cartões por problemas vinculados a um pull request por uma referência de fechamento usando `linked:pr`{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 0" %} - Filtrar cartões por repositório em um quadro de projetos de toda a organização usando `repo:ORGANIZATION/REPOSITORY`{% endif %} 1. Navegue até o quadro de projetos que contém os cartões que você deseja filtrar. diff --git a/translations/pt-BR/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests-by-milestone.md b/translations/pt-BR/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests-by-milestone.md index 15d1d88c8117..645fdc8e1963 100644 --- a/translations/pt-BR/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests-by-milestone.md +++ b/translations/pt-BR/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests-by-milestone.md @@ -14,7 +14,7 @@ versions: - Se preferir filtrar problemas e pull requests com a barra de pesquisa, use a sintaxe de pesquisa de marco. Para um marco denominado My Milestone (Meu Marco), a sintaxe de pesquisa deve ser: `milestone:"My Milestone"`. - Para limpar a seleção de filtro, clique em **Clear current search query, filters, and sorts** (Limpar consulta atual, filtros e ordenar). -- Você também pode filtrar problemas ou pull requests usando o {% data variables.product.prodname_cli %}. For more information, see "[`gh issue list`](https://cli.github.com/manual/gh_issue_list)" or "[`gh pr list`](https://cli.github.com/manual/gh_pr_list)" in the {% data variables.product.prodname_cli %} documentation. +- Você também pode filtrar problemas ou pull requests usando o {% data variables.product.prodname_cli %}. Para mais informações, consulte a "[`lista de problemas do gh`](https://cli.github.com/manual/gh_issue_list)" ou "[`lista pr do gh`](https://cli.github.com/manual/gh_pr_list)" na documentação de {% data variables.product.prodname_cli %}. {% endtip %} diff --git a/translations/pt-BR/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md b/translations/pt-BR/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md index 81d33bc8af2f..9c64551c3d1c 100644 --- a/translations/pt-BR/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md +++ b/translations/pt-BR/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md @@ -1,6 +1,6 @@ --- title: Vinculando uma pull request a um problema -intro: 'Você pode vincular uma pull request a um problema {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} para mostrar que uma correção está em andamento e para{% endif %} fechar automaticamente o problema quando a pull request for mesclada.' +intro: 'Você pode vincular um pull request a um problema {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 8" %} mostra que uma correção está em andamento e{% endif %} fecha automaticamente o problema quando o pull request é mesclado.' redirect_from: - /articles/closing-issues-via-commit-message/ - /articles/closing-issues-via-commit-messages/ @@ -11,13 +11,17 @@ versions: enterprise-server: '*' --- +{% note %} + +**Note:** The special keywords in a pull request description are interpreted when the pull request targets the repository's *default* branch. However, if the PR's base is *any other branch*, then these keywords are ignored, no links are created and merging the PR has no effect on the issues. **If you want to link a pull request to an issue using a keyword, the PR must be on the default branch.** + +{% endnote %} + ### Sobre problemas e pull requests vinculados -Você pode vincular um problema a uma pull request {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}manualmente ou {% endif %}usando uma palavra-chave suportada na descrição da pull request. +Você pode vincular um problema a um pull request {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 0" %}manualmente ou {% endif %}usando uma palavra-chave compatível na descrição do pull request. -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -Quando você vincula uma pull request ao problema que a pull request tem de lidar, os colaboradores poderão ver que alguém está trabalhando no problema. -{% if currentVersion ver_lt "enterprise-server@2.21" %}Se a pull request e o problema estiverem em repositórios diferentes, {% data variables.product.product_name %} exibirá o link depois que a pull request sofrer merge, se a pessoa que faz o merge da pull request também tiver permissão para encerrar o problema.{% endif %}{% endif %} +Quando você vincula uma pull request ao problema que a pull request tem de lidar, os colaboradores poderão ver que alguém está trabalhando no problema. {% if currentVersion ver_lt "enterprise-server@2. 1" %}Se o pull request e o problema estiverem em repositórios diferentes, {% data variables.product.product_name %} mostrará o link após o merge do pull request, se a pessoa que mescla o pull request também tiver permissão para fechar o problema.{% endif %} Quando você mescla uma pull request vinculada no branch padrão de um repositório, o problema vinculado será fechado automaticamente. Para obter mais informações sobre o branch padrão, consulte "[Configurado o branch padrão](/github/administering-a-repository/setting-the-default-branch). " @@ -37,7 +41,7 @@ Você pode vincular manualmente até dez problemas para cada pull request. O pro ### Vinculando uma pull request a um problema usando uma palavra-chave -Você pode vincular uma pull request a um problema usando uma palavra-chave suportada na descrição da pull request. +You can link a pull request to an issue by using a supported keyword in the pull request's description or in a commit message (please note that the pull request must be on the default branch). * close * closes @@ -57,9 +61,9 @@ A sintaxe para fechar palavras-chave depende se o problema está no mesmo reposi | Problema em um repositório diferente | *KEYWORD* *OWNER*/*REPOSITORY*#*ISSUE-NUMBER* | `Fixes octo-org/octo-repo#100` | | Múltiplos problemas | Usar sintaxe completa para cada problema | `Resolves #10, resolves #123, resolves octo-org/octo-repo#100` | -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}Somente pull requests vinculadas manualmente podem ser desvinculadas. Para desvincular um problema que você vinculou usando uma palavra-chave, você deve editar a descrição da pull request para remover a palavra-chave.{% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}Apenas pull requests vinculados manualmente podem ser desvinculados. Para desvincular um problema que você vinculou usando uma palavra-chave, você deve editar a descrição da pull request para remover a palavra-chave.{% endif %} -Você também pode usar palavras-chave de fechamento em uma mensagem de commit. O problema será encerrado quando você mesclar o commit no branch padrão{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, mas a pull request que contém o commit não será listada como uma pull request vinculada{% endif %}. +Você também pode usar palavras-chave de fechamento em uma mensagem de commit. O problema será encerrado quando você mesclar o commit no branch padrão, mas o pull request que contém o commit não será listado como um pull request vinculado. ### Leia mais diff --git a/translations/pt-BR/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md b/translations/pt-BR/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md index a3e98dbb7e98..c8a11c3759d5 100644 --- a/translations/pt-BR/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md +++ b/translations/pt-BR/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md @@ -5,14 +5,14 @@ redirect_from: - /articles/transferring-an-issue-to-another-repository versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- Para transferir um problema aberto para outro repositório, é preciso ter permissões de gravação no repositório em que o problema está e no repositório para onde você está transferindo o problema. Para obter mais informações, consulte "[Níveis de permissão do repositório para organizações](/articles/repository-permission-levels-for-an-organization)". Você somente pode transferir problemas entre repositórios pertencentes à mesma conta de usuário ou organização. É possível transferir um problema de um repositório privado para um repositório público. -Quando você transfere um problema, os comentários e responsáveis são mantidos. As etiquetas do problema{% if currentVersion ver_lt "enterprise-server@2.19" %}, projetos,{% endif %} e marcos do problema não são preservados.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} Esse problema ficará nos quadros de projeto pertencentes a qualquer usuário proprietário ou quadro de projeto da organização e será removido de quaisquer quadros de projeto de repositório. Para obter mais informações, consulte "[Sobre quadros de projeto](/articles/about-project-boards)."{% endif %} +Quando você transfere um problema, os comentários e responsáveis são mantidos. As etiquetas e os marcos do problema não são retidos. Esse problema permanecerá em qualquer quadro de projeto pertencente ao usuário ou à organização e será removido dos quadros de projeto de todos os repositórios. Para obter mais informações, consulte "[Sobre quadros de projeto](/articles/about-project-boards)". As pessoas ou equipes mencionadas no problema receberão uma notificação informando que o problema foi transferido para um novo repositório. O URL original redirecionará para o novo URL do problema. As pessoas que não tenham permissões de leitura no novo repositório verão um banner informando que o problema foi transferido para um novo repositório ao qual elas não têm acesso. diff --git a/translations/pt-BR/content/github/managing-your-work-on-github/using-search-to-filter-issues-and-pull-requests.md b/translations/pt-BR/content/github/managing-your-work-on-github/using-search-to-filter-issues-and-pull-requests.md index d7ec4b43b4a2..a50c9d9a1b52 100644 --- a/translations/pt-BR/content/github/managing-your-work-on-github/using-search-to-filter-issues-and-pull-requests.md +++ b/translations/pt-BR/content/github/managing-your-work-on-github/using-search-to-filter-issues-and-pull-requests.md @@ -39,7 +39,7 @@ Para pull requests, você também pode usar a pesquisa para: - Filtrar pull requests nas quais um revisor tenha solicitado alterações: `state:open type:pr review:changes_requested` - Filtrar pull requests por [revisor](/articles/about-pull-request-reviews/): `state:open type:pr reviewed-by:octocat` - Filtrar pull requests pelo usuário específico [solicitado para revisão](/articles/requesting-a-pull-request-review): `state:open type:pr review-requested:octocat` -- Filtrar pull requests pela equipe solicitada para revisão: `state:open type:pr team-review-requested:github/atom`{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +- Filtre pull requests pela equipe solicitada para revisão: `state:open type:pr team-review-requested:github/atom`{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} - Filtro por pull requests que estão vinculadas a um problema que a pull request pode concluir: `linked:issue`{% endif %} ### Leia mais diff --git a/translations/pt-BR/content/github/managing-your-work-on-github/viewing-all-of-your-issues-and-pull-requests.md b/translations/pt-BR/content/github/managing-your-work-on-github/viewing-all-of-your-issues-and-pull-requests.md index 14e43a1dc1f5..87e57a70f214 100644 --- a/translations/pt-BR/content/github/managing-your-work-on-github/viewing-all-of-your-issues-and-pull-requests.md +++ b/translations/pt-BR/content/github/managing-your-work-on-github/viewing-all-of-your-issues-and-pull-requests.md @@ -15,4 +15,4 @@ Os painéis de problemas e pull requests estão disponíveis na parte superior d ### Leia mais -- {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}”[Visualizando suas assinaturas](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions#reviewing-repositories-that-youre-watching){% else %}”[Listando os repositórios que você está acompanhando](/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching){% endif %}" +- {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 0" %}"[Visualizar as suas assinaturas](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions#reviewing-repositories-that-youre-watching){% else %}"[Listar os repositórios que você está inspecionando](/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching){% endif %}" diff --git a/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/about-email-notifications.md b/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/about-email-notifications.md index a32545fc8950..ae97d3bb36ab 100644 --- a/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/about-email-notifications.md +++ b/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/about-email-notifications.md @@ -19,17 +19,17 @@ Cada notificação de e-mail que o {% data variables.product.product_name %} env As notificações de e-mail do {% data variables.product.product_name %} contêm as seguintes informações de header: -| Header | Informações | -| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| Endereço do `remetente` | Este endereço sempre será "o endereço de email configurado no-reply pelo seu administrador do site". | -| Campo `To` | Esse campo conecta-se diretamente ao thread. Se você responder ao e-mail, será adicionado um novo comentário à conversa. | -| Endereço de `Cc` | O {% data variables.product.product_name %} colocará você em cópia (`Cc`) se você estiver inscrito para uma conversa. O segundo endereço de e-mail de `Cc` corresponde ao motivo da notificação. O sufixo para esses motivos de notificação é {% data variables.notifications.cc_address %}. Os possíveis motivos de notificação são:
    • 'assign': você foi atribuído a um problema ou uma pull request.
    • 'author': você criou um problema ou uma pull request.
    • 'comment': você comentou um problema ou uma pull request.
    • 'manual': houve uma atualização em um problema ou uma pull request para o(a) qual você assinou manualmente.
    • 'mention': você foi mencionado em um problema ou uma pull request.
    • 'push': alguém fez commit em uma pull request que você assinou.
    • 'review_requested': você ou uma equipe da qual faz você faz parte foi solicitado para revisar uma pull request.
    • 'security_alert': o {% data variables.product.prodname_dotcom %} detectou uma vulnerabilidade em um repositório para o qual você recebe alertas de segurança.
    • 'state_change': um problema ou uma pull request que você assinou foi fechado(a) ou aberto(a).
    • 'subscribed': houve uma atualização em um repositório que você está inspecionando.
    • 'team_mention': uma equipe a qual você pertence foi mencionada em um problema ou uma pull request.
    • 'your_activity': você abriu, comentou ou fechou um problema ou uma pull request.
    | -| campo `mailing list` | Esse campo identifica o nome do repositório e seu proprietário. O formato desse endereço é sempre `..{% data variables.command_line.backticks %}`. |{% if currentVersion ver_gt "enterprise-server@2.19" % %} -| campo `X-GitHub-Severity` | {% data reusables.repositories.security-alerts-x-github-severity %} Os níveis possíveis de gravidade são:
    • `low`
    • `moderate`
    • `high`
    • `critical`
    Para obter mais informações, consulte "[Sobre alertas para dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)" |{% endif %} +| Header | Informações | +| --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Endereço do `remetente` | Este endereço sempre será "o endereço de email configurado no-reply pelo seu administrador do site". | +| Campo `To` | Esse campo conecta-se diretamente ao thread. Se você responder ao e-mail, será adicionado um novo comentário à conversa. | +| Endereço de `Cc` | O {% data variables.product.product_name %} colocará você em cópia (`Cc`) se você estiver inscrito para uma conversa. O segundo endereço de e-mail de `Cc` corresponde ao motivo da notificação. O sufixo para esses motivos de notificação é {% data variables.notifications.cc_address %}. Os possíveis motivos de notificação são:
    • 'assign': você foi atribuído a um problema ou uma pull request.
    • 'author': você criou um problema ou uma pull request.
    • 'comment': você comentou um problema ou uma pull request.
    • 'manual': houve uma atualização em um problema ou uma pull request para o(a) qual você assinou manualmente.
    • 'mention': você foi mencionado em um problema ou uma pull request.
    • 'push': alguém fez commit em uma pull request que você assinou.
    • 'review_requested': você ou uma equipe da qual faz você faz parte foi solicitado para revisar uma pull request.
    • 'security_alert': o {% data variables.product.prodname_dotcom %} detectou uma vulnerabilidade em um repositório para o qual você recebe alertas de segurança.
    • 'state_change': um problema ou uma pull request que você assinou foi fechado(a) ou aberto(a).
    • 'subscribed': houve uma atualização em um repositório que você está inspecionando.
    • 'team_mention': uma equipe a qual você pertence foi mencionada em um problema ou uma pull request.
    • 'your_activity': você abriu, comentou ou fechou um problema ou uma pull request.
    | +| campo `mailing list` | Esse campo identifica o nome do repositório e seu proprietário. O formato desse endereço é sempre `..{% data variables.command_line.backticks %}`. |{% if currentVersion ver_gt "enterprise-server@2.19" % %} +| campo `X-GitHub-Severity` | {% data reusables.repositories.security-alerts-x-github-severity %} Os níveis possíveis de gravidade são:
    • `low`
    • `moderate`
    • `high`
    • `critical`
    Para obter mais informações, consulte "[Sobre alertas para dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)" |{% endif %} ### Leia mais -- "Listar os repositórios que você está inspecionando](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching)" +- "[Listar os repositórios que você está inspecionando](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching)" - "Fazer a inspeção e cancelar a inspeção de repositórios](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories)" -- "[Fazer a assinatura e cancelar a assinatura de notificações](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)"{% if currentVersion ver_gt "enterprise-server@2.17" %} -- "[Criar gists](/articles/creating-gists)"{% endif %} +- "[Assinando e cancelando notificações](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)" +- "[Criar gists](/articles/creating-gists)" diff --git a/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/about-notifications.md b/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/about-notifications.md index ea62aef16e63..e4d0d20f5814 100644 --- a/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/about-notifications.md +++ b/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/about-notifications.md @@ -33,9 +33,8 @@ O {% data variables.product.product_name %} envia notificações *de participaç #### Notificações de inspeção -O {% data variables.product.product_name %} envia notificações *de inspeção* para atualizações em repositórios ou discussões de equipe que você está inspecionando. {% if currentVersion ver_gt "enterprise-server@2.17" %} {% data reusables.notifications.auto-watch %}Para obter mais informações, consulte "[Fazer a inspeção e cancelar a inspeção de repositórios](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories)". - -{% endif %}Você receberá uma notificação quando: +O {% data variables.product.product_name %} envia notificações *de inspeção* para atualizações em repositórios ou discussões de equipe que você está inspecionando. {% data reusables.notifications.auto-watch %}Para obter mais informações, consulte "[Inspecionar e deixar de inspecionar repositórios](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories)". +Você receberá uma notificação quando: - Um problema for aberto. - Um comentário for adicionado a um problema aberto. - Uma pull request for aberta. @@ -50,7 +49,7 @@ Também é possível procurar em seu painel atividades de pessoas que você segu ### Leia mais -- "Listar os repositórios que você está inspecionando](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching)" +- "[Listar os repositórios que você está inspecionando](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching)" - "Fazer a inspeção e cancelar a inspeção de repositórios](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories)" - "Listar os repositórios que você está inspecionando](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching)" +- "[Listar os repositórios que você está inspecionando](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching)" - "Fazer a inspeção e cancelar a inspeção de repositórios](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories)" -- "[Fazer a assinatura e cancelar a assinatura de notificações](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)" +- "[Assinando e cancelando notificações](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)" diff --git a/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/accessing-your-notifications.md b/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/accessing-your-notifications.md index 7683267bfed3..fbd100ca373e 100644 --- a/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/accessing-your-notifications.md +++ b/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/accessing-your-notifications.md @@ -20,4 +20,4 @@ Se as notificações de e-mail estiverem configuradas, você poderá acessar as ### Leia mais - "[Sobre notificações](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/about-notifications)" -- "Listar os repositórios que você está inspecionando](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching)" +- "[Listar os repositórios que você está inspecionando](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching)" diff --git a/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/listing-the-issues-and-pull-requests-youre-subscribed-to.md b/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/listing-the-issues-and-pull-requests-youre-subscribed-to.md index 0b144d152924..331b12a367e0 100644 --- a/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/listing-the-issues-and-pull-requests-youre-subscribed-to.md +++ b/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/listing-the-issues-and-pull-requests-youre-subscribed-to.md @@ -9,12 +9,17 @@ As listas de assinatura não incluem todos os problemas e pull requests dos repo ### Visualizar uma lista de suas assinaturas -1. No canto superior direito de qualquer página, clique em {% octicon "bell" aria-label="The notifications bell" %}. Se você desabilitou as notificações da web e não vê o ícone de sino, é possível navegar para . Para obter mais informações, consulte "[Escolher o método de entrega das suas notificações](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications)". ![Notificação indicando qualquer mensagem não lida](/assets/images/help/notifications/notifications_general_existence_indicator.png) -2. Clique em **Assinaturas** ![Aba Subscriptions (Assinaturas)](/assets/images/help/notifications/subscriptions-tab.png) +1. No canto superior direito de qualquer página, clique em {% octicon "bell" aria-label="The notifications bell" %}. Se você desabilitou as notificações da web e não vê o ícone de sino, é possível navegar para . Para obter mais informações, consulte " +[Escolher o método de entrega das suas notificações](/enterprise/{{ page.version }}/user/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications)". ![Notificação indicando qualquer mensagem não lida](/assets/images/help/notifications/notifications_general_existence_indicator.png)

    + + 2 Clique em **Assinaturas** ![Aba Subscriptions (Assinaturas)](/assets/images/help/notifications/subscriptions-tab.png) + + ### Cancelar assinatura de problemas e pull requests Você pode cancelar a assinatura de problemas e pull requests diretamente em sua lista de assinaturas. 1. À esquerda de cada problema ou pull request que você quer cancelar a assinatura, marque a caixa de seleção. ![Caixa de seleção para cancelar assinatura](/assets/images/help/notifications/unsubscribe-checkbox.png) + 2. No campo superior direito da página, clique em **Unsubscribe** (Cancelar assinatura). ![Botão Unsubscribe (Cancelar assinatura)](/assets/images/help/notifications/unsubscribe-button.png) diff --git a/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching.md b/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching.md index 2359835bc644..4b51d9e4235e 100644 --- a/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching.md +++ b/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching.md @@ -1,6 +1,6 @@ --- title: Listar os repositórios que você inspeciona -intro: 'Você pode ter uma visão geral de todos os repositórios que inspeciona, assim pode remover aqueles que não tem mais interesse em receber notificações.' +intro: Você pode ter uma visão geral de todos os repositórios que inspeciona, assim pode remover aqueles que não tem mais interesse em receber notificações. versions: enterprise-server: <2.21 --- diff --git a/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/saving-notifications-for-later.md b/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/saving-notifications-for-later.md index dbeec250e3d2..3983f73e9b74 100644 --- a/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/saving-notifications-for-later.md +++ b/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/saving-notifications-for-later.md @@ -26,5 +26,5 @@ Quando você salva uma notificação, ela é movida para a guia Saved for later ### Leia mais - "[Sobre notificações](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/about-notifications)" -- "[Acessando suas notificações](/enterprise/{}/user/github/receiving-notifications-about-activity-on-github/accessing-your-notifications)" +- "[Acessar as suas notificações](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/accessing-your-notifications)" - "[Marcando notificações como lidas](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/marking-notifications-as-read)" diff --git a/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications.md b/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications.md index ae3ee1274147..64719fe8d61a 100644 --- a/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications.md +++ b/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications.md @@ -7,21 +7,12 @@ versions: ### Gerenciar configurações de notificação sobre um problema ou uma pull request -{% if currentVersion ver_lt "enterprise-server@2.18" %}Quando você faz assinatura para uma conversa em um problema ou uma pull request, recebe notificações sobre cada atualização na conversa, mesmo que não esteja participando dela. - -Quando você cancela a assinatura de uma conversa em um problema ou uma pull request, deixa de receber notificações sobre ela. Se a conversa fizer menção a você ou a uma equipe da qual faça parte, você começará a receber notificações novamente. Para obter mais informações sobre @menções, consulte "[Sintaxe básica de gravação e formatação](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams)".{% endif %} - {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issue-pr %} 3. Escolha um problema ou uma pull request para assinar. -{% if currentVersion ver_gt "enterprise-server@2.17" %} 4. Na barra lateral direita, clique em **Subscribe** (Fazer assinatura) ou em **Unsubscribe** (Cancelar assinatura). ![Botão Conversation Subscribe (Assinatura de conversas)](/assets/images/help/notifications/subscribe_button_with_gear.png) 5. Para personalizar as notificações, clique em {% octicon "gear" aria-label="The gear icon" %}. ![Botão de configuração ao lado de Conversation Subscribe (Assinatura de conversas)](/assets/images/help/notifications/subscribe_button_with_gear_chosen.png) -6. Selecione o tipo de notificações que deseja receber sobre esta conversa e clique em **Save** (Salvar). ![Lista de opções Conversation Subscribe (Assinatura de conversas)](/assets/images/help/notifications/subscribe_options.png) -{% else %} -4. Para fazer ou cancelar a assinatura de uma conversa, clique em **Subscribe** (Fazer assinatura) ou em **Unsubscribe** (Cancelar assinatura) na barra lateral direita. ![Botão Conversation Subscribe (Assinatura de conversas)](/assets/images/help/notifications/subscribe_button.png) -{% endif %} -Você pode ver uma lista de todos os problemas e pull requests que assinou. Para obter mais informações, consulte "[Listar os problemas e as pull requests que você assinou](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-issues-and-pull-requests-youre-subscribed-to)". +6. Selecione o tipo de notificações que deseja receber sobre esta conversa e clique em **Save** (Salvar). ![Conversation Subscribe options list](/assets/images/help/notifications/subscribe_options.png) Você pode visualizar uma lista de todos os problemas e pull requests que assinou. Para obter mais informações, consulte "[Listar os problemas e as pull requests que você assinou](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-issues-and-pull-requests-youre-subscribed-to)". ### Fazer assinatura para discussões de equipe @@ -49,4 +40,4 @@ Você pode ver uma lista de todos os problemas e pull requests que assinou. Para - "[Sobre conversas no {% data variables.product.product_name %}](/articles/about-conversations-on-github)" - "    Fazer a inspeção e cancelar a inspeção de repositórios](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories)" -- "Listar os repositórios que você está inspecionando](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching)" +- "[Listar os repositórios que você está inspecionando](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching)" diff --git a/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories.md b/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories.md index 2190e211f050..ae547a25ad1e 100644 --- a/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories.md +++ b/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories.md @@ -5,9 +5,7 @@ versions: enterprise-server: <2.21 --- -{% if currentVersion ver_gt "enterprise-server@2.17" %} {% data reusables.notifications.auto-watch %} Para obter mais informações, consulte [Sobre notificações](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/about-notifications)." -{% endif %} Também é possível inspecionar e cancelar versões em um repositório. Para obter mais informações, consulte "[Fazer a inspeção e cancelar a inspeção de versões para um repositório](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-releases-for-a-repository)". @@ -35,11 +33,11 @@ Também é possível inspecionar e cancelar versões em um repositório. Para ob {% note %} -**Observação:** você também pode optar por ignorar um repositório. Nesse caso, você deixará de receber notificações. Não recomendamos ignorar repositórios porque você não será notificado caso seja @mencionado. {% if currentVersion == "free-pro-team@latest" %}Se você estiver sendo incomodado e quiser ignorar um repositório, [entre em contato com o suporte](/contact) para que possamos ajudá-lo. {% data reusables.policies.abuse %}{% endif %} +**Observação:** você também pode optar por ignorar um repositório. Nesse caso, você deixará de receber notificações. Não recomendamos ignorar repositórios porque você não será notificado caso seja @mencionado. {% if currentVersion == "free-pro-team@latest" %}Se você estiver passando por abuso e deseja ignorar um repositório, [entre em contato com o suporte](/contact) para que possamos ajudar. {% data reusables.policies.abuse %}{% endif %} {% endnote %} ### Leia mais -- "[Fazer a assinatura e cancelar a assinatura de notificações](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)" -- "Listar os repositórios que você está inspecionando](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching)" +- "[Assinando e cancelando notificações](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)" +- "[Listar os repositórios que você está inspecionando](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching)" diff --git a/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md b/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md index 0608847b82e7..12d122819675 100644 --- a/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md +++ b/translations/pt-BR/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md @@ -5,7 +5,7 @@ versions: enterprise-server: <2.21 --- -Por padrão, você recebe automaticamente notificações sobre discussões de equipes das quais é um integrante. Se você não quiser receber certas notificações sobre uma discussão de equipe, cancele a inspeção dessa equipe. Você também pode fazer ou cancelar a assinatura em determinadas postagens de discussão de equipe. Para obter mais informações, consulte "[Sobre discussões de equipe](/articles/about-team-discussions)" e "1>Fazer ou cancelar a assinatura de notificações". +Por padrão, você recebe automaticamente notificações sobre discussões de equipes das quais é um integrante. Se você não quiser receber certas notificações sobre uma discussão de equipe, cancele a inspeção dessa equipe. Você também pode fazer ou cancelar a assinatura em determinadas postagens de discussão de equipe. Para obter mais informações, consulte "[Sobre discussões na equipe](/articles/about-team-discussions)" e "[Assinar e cancelar a assinatura de notificações](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)". Caso você não queira inspecionar discussões de equipe automaticamente quando se tornar um integrante de novas equipes, atualize as configurações automáticas de inspeção. @@ -21,14 +21,16 @@ Para inspecionar automaticamente todas as discussões de equipe das novas equipe {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.notifications %} -{% data reusables.user_settings.automatic_watching_box %} selecione **Automatically watch teams** (Inspecionar equipes automaticamente). ![Caixa de seleção para inspecionar equipes automaticamente](/assets/images/help/notifications/automatic-team-discussions-watching.png) +{% data reusables.user_settings.automatic_watching_box %} selecione **Automatically watch teams** (Inspecionar equipes automaticamente). +![Caixa de seleção para inspecionar equipes automaticamente](/assets/images/help/notifications/automatic-team-discussions-watching.png) ### Inspecionar as discussões de uma única equipe {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.specific_team %} -{% data reusables.organizations.watch-team-options %} clique em **Watch** (Inspecionar) para abrir suas opções de notificações. Em seguida, clique em **Watching** (Inspecionar). ![Opções de inspeção em um menu suspenso para uma equipe específica](/assets/images/help/notifications/specific-team-watch-options.png) +{% data reusables.organizations.watch-team-options %} clique em **Watch** (Inspecionar) para abrir suas opções de notificações. Em seguida, clique em **Watching** (Inspecionar). +![Opções de inspeção em um menu suspenso para uma equipe específica](/assets/images/help/notifications/specific-team-watch-options.png) ### Cancelar a inspeção de todas as discussões de equipe das novas equipes em que você ingressar @@ -36,14 +38,16 @@ Se você não quiser receber automaticamente notificações sobre discussões de {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.notifications %} -{% data reusables.user_settings.automatic_watching_box %} desmarque **Automatically watch teams** (Inspecionar equipes automaticamente). ![Configuração Automatically watching teams (Inspecionar equipes automaticamente) selecionada por padrão](/assets/images/help/notifications/automatic-team-discussions-watching.png) +{% data reusables.user_settings.automatic_watching_box %} desmarque **Automatically watch teams** (Inspecionar equipes automaticamente). +![Configuração Automatically watching teams (Inspecionar equipes automaticamente) selecionada por padrão](/assets/images/help/notifications/automatic-team-discussions-watching.png) ### Cancelar a inspeção das discussões de uma única equipe {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.specific_team %} -{% data reusables.organizations.watch-team-options %} clique em **Unwatch** (Cancelar inspeção) para abrir suas opções de notificações. Em seguida, clique em **Not watching** (Não inspecionar). ![Opções de inspeção em um menu suspenso para uma equipe específica](/assets/images/help/notifications/specific-team-unwatch.png) +{% data reusables.organizations.watch-team-options %} clique em **Unwatch** (Cancelar inspeção) para abrir suas opções de notificações. Em seguida, clique em **Not watching** (Não inspecionar). +![Opções de inspeção em um menu suspenso para uma equipe específica](/assets/images/help/notifications/specific-team-unwatch.png) {% note %} diff --git a/translations/pt-BR/content/github/searching-for-information-on-github/about-searching-on-github.md b/translations/pt-BR/content/github/searching-for-information-on-github/about-searching-on-github.md index dc44cfa074e6..13fc4eca2fa0 100644 --- a/translations/pt-BR/content/github/searching-for-information-on-github/about-searching-on-github.md +++ b/translations/pt-BR/content/github/searching-for-information-on-github/about-searching-on-github.md @@ -24,6 +24,8 @@ Você pode pesquisar globalmente em todo o {% data variables.product.product_nam - {% data reusables.search.required_login %} - Os sites do {% data variables.product.prodname_pages %} não são pesquisáveis no {% data variables.product.product_name %}. No entanto, você pode pesquisar o conteúdo da fonte, se ele existir no branch padrão de um repositório, usando a pesquisa de código. Para obter mais informações, consulte "[Pesquisar código](/articles/searching-code)". Para obter mais informações sobre o {% data variables.product.prodname_pages %}, consulte "[O que é o GitHub Pages?](/articles/what-is-github-pages/)" +- Atualmente, a nossa pesquisa não é compatível com correspondência exata. +- Sempre que você estiver pesquisando em arquivos de código, serão retornados apenas os dois primeiros resultados de cada arquivo. {% endnote %} diff --git a/translations/pt-BR/content/github/searching-for-information-on-github/searching-code.md b/translations/pt-BR/content/github/searching-for-information-on-github/searching-code.md index 5f459d22dfae..91423039857c 100644 --- a/translations/pt-BR/content/github/searching-for-information-on-github/searching-code.md +++ b/translations/pt-BR/content/github/searching-for-information-on-github/searching-code.md @@ -22,7 +22,7 @@ Devido à complexidade da pesquisa de códigos, a execução das pesquisas apres - {% data reusables.search.required_login %} - O código em [bifurcações](/articles/about-forks) só poderá ser pesquisado se a bifurcação tiver mais estrelas do que o repositório principal. Bifurcações com menos estrelas do que o repositório principal **não** são indexadas para pesquisa de códigos. Para incluir bifurcações com mais estrelas que o repositório principal delas nos resultados da pesquisa, você precisará adicionar `fork:true` ou `fork:only` à sua consulta. Para obter mais informações, consulte "[Pesquisar em bifurcações](/articles/searching-in-forks)". -- Apenas o _branch-padrão_ é indexado para a busca de código.{% if currentVersion == "free-pro-team@latest" %} +- Apenas o _branch-padrão_ é indexado para pesquisa de código.{% if currentVersion == "free-pro-team@latest" %} - Somente arquivos com menos de 384 KB são pesquisados.{% else %}* Somente arquivos com menos de 5 MB são pesquisados. - Somente os primeiros 500 KB de cada arquivo são pesquisados.{% endif %} - Somente repositórios com menos de 500.000 arquivos são pesquisados. @@ -101,5 +101,5 @@ O qualificador `extension` identifica os arquivos de código com uma determinada ### Leia mais - "[Ordenar os resultados da pesquisa](/articles/sorting-search-results/)" -- "[Pesquisar nas bifurcações](/articles/searching-in-forks)"{% if currentVersion == "free-pro-team@latest" %} +- "[Pesquisar e, bifurcações](/articles/searching-in-forks)"{% if currentVersion == "free-pro-team@latest" %} - "[Navegar pelo código em {% data variables.product.prodname_dotcom %}](/github/managing-files-in-a-repository/navigating-code-on-github)"{% endif %} diff --git a/translations/pt-BR/content/github/searching-for-information-on-github/searching-commits.md b/translations/pt-BR/content/github/searching-for-information-on-github/searching-commits.md index 08d86c78da15..e728eb38370b 100644 --- a/translations/pt-BR/content/github/searching-for-information-on-github/searching-commits.md +++ b/translations/pt-BR/content/github/searching-for-information-on-github/searching-commits.md @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -Você pode pesquisar commits globalmente no {% data variables.product.product_name %} ou pesquisar em uma organização ou um repositório específico. For more information, see "[About searching on {% data variables.product.company_short %}](/articles/about-searching-on-github)." +Você pode pesquisar commits globalmente no {% data variables.product.product_name %} ou pesquisar em uma organização ou um repositório específico. Para obter mais informações, consulte "[Sobre pesquisar no {% data variables.product.company_short %}](/articles/about-searching-on-github)". Quando você pesquisa commits, somente o [branch padrão](/articles/about-branches) de um repositório é pesquisado. diff --git a/translations/pt-BR/content/github/searching-for-information-on-github/searching-for-packages.md b/translations/pt-BR/content/github/searching-for-information-on-github/searching-for-packages.md index dfdd1e5961a3..f6d2f519931d 100644 --- a/translations/pt-BR/content/github/searching-for-information-on-github/searching-for-packages.md +++ b/translations/pt-BR/content/github/searching-for-information-on-github/searching-for-packages.md @@ -15,7 +15,8 @@ versions: É possível procurar pacotes globalmente em todos os {% data variables.product.product_name %} ou pesquisar pacotes dentro de uma determinada organização. Para obter mais informações, consulte "[Sobre a pesquisa no {% data variables.product.prodname_dotcom %}](/articles/about-searching-on-github)". {% if currentVersion != "free-pro-team@latest" %} -Para encontrar pacotes que pertencem a um determinado usuário ou organização, use o `usuário` ou `org` qualificador. +Você só pode pesquisar pacotes em +{% data variables.product.product_location_enterprise %}, não em {% data variables.product.prodname_dotcom_the_website %}, mesmo se {% data variables.product.prodname_github_connect %} estiver habilitado. {% endif %} {% data reusables.search.syntax_tips %} @@ -24,10 +25,10 @@ Para encontrar pacotes que pertencem a um determinado usuário ou organização, Para encontrar pacotes que pertencem a um determinado usuário ou organização, use o `usuário` ou `org` qualificador. -| Qualifier | Exemplo | -| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| user:USERNAME | [**user:codertocat**](https://github.com/search?q=user%3Acodertocat&type=RegistryPackages) corresponde pacotes que pertencem ao @codertocat | -| org:ORGNAME | [**org:github**](https://github.com/search?q=org%3Agithub&type=RegistryPackages) corresponde pacotes que pertencem à organização do {% data variables.product.prodname_dotcom %} | +| Qualifier | Exemplo | +| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| user:USERNAME | [**user:codertocat**](https://github.com/search?q=user%3Acodertocat&type=RegistryPackages) corresponde pacotes que pertencem ao @codertocat | +| org:ORGNAME | [**org:github**](https://github.com/search?q=org%3Agithub&type=RegistryPackages) corresponde pacotes que pertencem à organização do {% data variables.product.prodname_dotcom %} ### Filtrar por visibilidade do pacote diff --git a/translations/pt-BR/content/github/searching-for-information-on-github/searching-issues-and-pull-requests.md b/translations/pt-BR/content/github/searching-for-information-on-github/searching-issues-and-pull-requests.md index bcae12c2ba8a..e10b204a261d 100644 --- a/translations/pt-BR/content/github/searching-for-information-on-github/searching-issues-and-pull-requests.md +++ b/translations/pt-BR/content/github/searching-for-information-on-github/searching-issues-and-pull-requests.md @@ -9,7 +9,7 @@ versions: enterprise-server: '*' --- -Você pode pesquisar problemas e pull requests globalmente no {% data variables.product.product_name %} ou pesquisar em uma organização específica. For more information, see "[About searching on {% data variables.product.company_short %}](/articles/about-searching-on-github)." +Você pode pesquisar problemas e pull requests globalmente no {% data variables.product.product_name %} ou pesquisar em uma organização específica. Para obter mais informações, consulte "[Sobre pesquisar no {% data variables.product.company_short %}](/articles/about-searching-on-github)". {% tip %} @@ -229,7 +229,7 @@ Você pode filtrar problemas e pull requests pelo número de reações usando o ### Pesquisar por pull requests de rascunho Você pode filtrar por pull requests de rascunho. Para obter mais informações, consulte "[Sobre pull requests](/articles/about-pull-requests#draft-pull-requests)". -| Qualificador | Examplo | ------------- | -------------{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} | `draft:true` | [**draft:true**](https://github.com/search?q=draft%3Atrue) corresponde a rascunhos de pull requests. | `draft:false` | [**draft:false**](https://github.com/search?q=draft%3Afalse) corresponde a pull requests prontos para revisão.{% else %} | `is:draft` | [**is:draft**](https://github.com/search?q=is%3Adraft) corresponde a rascunhos de pull requests.{% endif %} +| Qualifier | Example | ------------- | -------------{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} | `draft:true` | [**draft:true**](https://github.com/search?q=draft%3Atrue) matches draft pull requests. | `draft:false` | [**draft:false**](https://github.com/search?q=draft%3Afalse) corresponde a pull requests prontos para revisão.{% else %} | `is:draft` | [**is:draft**](https://github.com/search?q=is%3Adraft) corresponde a rascunhos de pull requests.{% endif %} ### Pesquisar por status de revisão e revisor da pull request diff --git a/translations/pt-BR/content/github/searching-for-information-on-github/searching-users.md b/translations/pt-BR/content/github/searching-for-information-on-github/searching-users.md index e8cdb6272ee3..3169e3ad89f6 100644 --- a/translations/pt-BR/content/github/searching-for-information-on-github/searching-users.md +++ b/translations/pt-BR/content/github/searching-for-information-on-github/searching-users.md @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -Você pode pesquisar usuários globalmente no {% data variables.product.product_name %}. For more information, see "[About searching on {% data variables.product.company_short %}](/articles/about-searching-on-github)." +Você pode pesquisar usuários globalmente no {% data variables.product.product_name %}. Para obter mais informações, consulte "[Sobre pesquisar no {% data variables.product.company_short %}](/articles/about-searching-on-github)". {% data reusables.search.syntax_tips %} diff --git a/translations/pt-BR/content/github/searching-for-information-on-github/searching-wikis.md b/translations/pt-BR/content/github/searching-for-information-on-github/searching-wikis.md index 6fbc9b92a609..479e7e0a8be3 100644 --- a/translations/pt-BR/content/github/searching-for-information-on-github/searching-wikis.md +++ b/translations/pt-BR/content/github/searching-for-information-on-github/searching-wikis.md @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -Você pode pesquisar wikis globalmente no {% data variables.product.product_name %} ou pesquisar em uma organização ou um repositório específico. For more information, see "[About searching on {% data variables.product.company_short %}](/articles/about-searching-on-github)." +Você pode pesquisar wikis globalmente no {% data variables.product.product_name %} ou pesquisar em uma organização ou um repositório específico. Para obter mais informações, consulte "[Sobre pesquisar no {% data variables.product.company_short %}](/articles/about-searching-on-github)". {% data reusables.search.syntax_tips %} diff --git a/translations/pt-BR/content/github/searching-for-information-on-github/sorting-search-results.md b/translations/pt-BR/content/github/searching-for-information-on-github/sorting-search-results.md index 3f67a5692ee7..b3fb3fb49699 100644 --- a/translations/pt-BR/content/github/searching-for-information-on-github/sorting-search-results.md +++ b/translations/pt-BR/content/github/searching-for-information-on-github/sorting-search-results.md @@ -18,8 +18,8 @@ Para ordenar por interações, reações, data de criação, data do committer e O qualificador `sort:interactions` ordena pelo maior número combinado de reações e comentários. -| Qualifier | Exemplo | -| ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Qualifier | Exemplo | +| ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sort:interactions` ou `sort:interactions-desc` | [**org:github sort:interactions**](https://github.com/search?q=org%3Agithub+sort%3Ainteractions&type=Issues) identifica os problemas nos repositórios do {% data variables.product.product_name %} ordenados pelo maior número combinado de reações e comentários. | | `sort:interactions-asc` | [**org:github sort:interactions-asc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Ainteractions-asc&type=Issues) identifica os problemas nos repositórios do {% data variables.product.product_name %} ordenados pelo menor número combinado de reações e comentários. | @@ -27,8 +27,8 @@ O qualificador `sort:interactions` ordena pelo maior número combinado de reaç O qualificador `sort:reactions` ordena pelo número ou tipo de reações. -| Qualifier | Exemplo | -| ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Qualifier | Exemplo | +| ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sort:reactions` ou `sort:reactions-desc` | [**org:github sort:reactions**](https://github.com/search?q=org%3Agithub+sort%3Areactions&type=Issues) identifica os problemas nos repositórios do {% data variables.product.product_name %} ordenados pelo maior número de reações. | | `sort:reactions-asc` | [**org:github sort:reactions-asc**](https://github.com/search?q=org%3Agithub+sort%3Areactions-asc&type=Issues) identifica os problemas nos repositórios do {% data variables.product.product_name %} ordenados pelo número crescente de reações (do menor para o maior). | | sort:reactions-reaction | [**org:github sort:reactions-+1**](https://github.com/search?q=org%3Agithub+sort%3Areactions-%2B1&type=Issues) identifica os problemas nos repositórios do {% data variables.product.product_name %} ordenados pelo maior número de reações de curtida (:+1:). | @@ -41,8 +41,8 @@ O qualificador `sort:reactions` ordena pelo número ou tipo de reações. O qualificador `sort:author-date` ordena de forma crescente ou decrescente por data de criação. -| Qualifier | Exemplo | -| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Qualifier | Exemplo | +| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sort:author-date` ou `sort:author-date-desc` | [**feature org:github sort:author-date**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Aauthor-date&type=Commits) identifica os commits que contêm a palavra "feature" nos repositórios do {% data variables.product.product_name %} ordenados de forma decrescente por data de criação. | | `sort:author-date-asc` | [**feature org:github sort:author-date-asc**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Aauthor-date-asc&type=Commits) identifica os commits que contêm a palavra "feature" nos repositórios do {% data variables.product.product_name %} ordenados de forma crescente por data de criação. | @@ -50,8 +50,8 @@ O qualificador `sort:author-date` ordena de forma crescente ou decrescente por d O qualificador `sort:committer-date` ordena de forma crescente ou decrescente por data do committer. -| Qualifier | Exemplo | -| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| Qualifier | Exemplo | +| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sort:committer-date` ou `sort:committer-date-desc` | [**feature org:github sort:committer-date**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Acommitter-date&type=Commits) identifica os commits que contêm a palavra "feature" nos repositórios do {% data variables.product.product_name %} ordenados de forma decrescente por data do committer. | | `sort:committer-date-asc` | [**feature org:github sort:committer-date-asc**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Acommitter-date-asc&type=Commits) identifica os commits que contêm a palavra "feature" nos repositórios do {% data variables.product.product_name %} ordenados de forma crescente por data do committer. | diff --git a/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md b/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md index ab72f078bf58..814c3ffc1efa 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md @@ -12,8 +12,8 @@ versions: Os minutos são reiniciados todos os meses, mas o uso do armazenamento não. -| Produto | Armazenamento | Minutos (por mês) | -| ------------------------------------------------------------------------ | ------------- | ----------------- | +| Produto | Armazenamento | Minutos (por mês) | +| ------------------------------------------------------------------- | ------------- | ----------------- | | {% data variables.product.prodname_free_user %} | 500 MB | 2.000 | | {% data variables.product.prodname_pro %} | 1 GB | 3.000 | | {% data variables.product.prodname_free_team %} para organizações | 500 MB | 2.000 | @@ -44,7 +44,7 @@ O armazenamento usado por um repositório é o armazenamento total usado por art | macOS | $0,08 | | Windows | $0,016 | -O número de trabalhos que você pode executar simultaneamente em todos os repositórios em sua conta de usuário ou organização depende do seu plano GitHub. Para obter mais informações, consulte "[Sobre o {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/about-github-actions/#usage-limits)". +O número de trabalhos que você pode executar simultaneamente em todos os repositórios em sua conta de usuário ou organização depende do seu plano GitHub. Para obter mais informações, consulte "[Limites de uso e cobrança](/actions/reference/usage-limits-billing-and-administration)" para executores hospedados em {% data variables.product.prodname_dotcom %} e "[Sobre executores auto-hospedados](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)" para limites de uso de executores auto-hospedados. ### Calculando minutos e gastos de armazenamento diff --git a/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md b/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md index f1900cf50f4c..b77d93457b5b 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md @@ -14,8 +14,8 @@ versions: A transferência de dados é reiniciada todos os meses, mas o uso do armazenamento não. -| Produto | Armazenamento | Transferência de dados (por mês) | -| ------------------------------------------------------------------------ | ------------- | -------------------------------- | +| Produto | Armazenamento | Transferência de dados (por mês) | +| ------------------------------------------------------------------- | ------------- | -------------------------------- | | {% data variables.product.prodname_free_user %} | 500MB | 1GB | | {% data variables.product.prodname_pro %} | 2GB | 10GB | | {% data variables.product.prodname_free_team %} para organizações | 500MB | 1GB | diff --git a/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/changing-the-duration-of-your-billing-cycle.md b/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/changing-the-duration-of-your-billing-cycle.md index dc40a63a44e8..fa82e3936e4c 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/changing-the-duration-of-your-billing-cycle.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/changing-the-duration-of-your-billing-cycle.md @@ -1,6 +1,6 @@ --- title: Alterar a duração do ciclo de cobrança -intro: 'Você pode pagar pela assinatura da sua conta, bem como de outros recursos e produtos pagos em um ciclo de cobrança mensal ou anual.' +intro: Você pode pagar pela assinatura da sua conta, bem como de outros recursos e produtos pagos em um ciclo de cobrança mensal ou anual. redirect_from: - /articles/monthly-and-yearly-billing/ - /articles/switching-between-monthly-and-yearly-billing-for-your-personal-account/ diff --git a/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md b/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md index 226515bd82db..505d45813792 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md @@ -49,6 +49,8 @@ Proprietários de organizações e gestores de faturamento podem gerenciar o lim {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %} -1. Em "{% data variables.product.prodname_actions %} e Pacotes de uso mensal", clique em **Gestão de custos**. ![Aba de gestão de custos](/assets/images/help/settings/cost-management-tab-enterprise.png) +1. Em " +{% data variables.product.prodname_actions %} e pacotes de uso mensal", clique em **Gestão de custo**. + ![Aba de gestão de custos](/assets/images/help/settings/cost-management-tab-enterprise.png) {% data reusables.dotcom_billing.monthly-spending-limit %} {% data reusables.dotcom_billing.update-spending-limit %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md b/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md index fcc644d071c5..0ece59b57755 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md @@ -49,6 +49,8 @@ Proprietários de organizações e gestores de faturamento podem gerenciar o lim {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %} -1. Em "{% data variables.product.prodname_actions %} e Pacotes de uso mensal", clique em **Gestão de custos**. ![Aba de gestão de custos](/assets/images/help/settings/cost-management-tab-enterprise.png) +1. Em " +{% data variables.product.prodname_actions %} e pacotes de uso mensal", clique em **Gestão de custo**. + ![Aba de gestão de custos](/assets/images/help/settings/cost-management-tab-enterprise.png) {% data reusables.dotcom_billing.monthly-spending-limit %} {% data reusables.dotcom_billing.update-spending-limit %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md b/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md index 8028bdb0a9f5..95ec438ffa78 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md @@ -28,7 +28,9 @@ Você pode atualizar sua conta pessoal do {% data variables.product.prodname_fre {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.billing %} {% data reusables.user_settings.subscriptions-tab %} -4. Ao lado de "{% data variables.product.prodname_free_user %}", clique em **Upgrade** (Atualizar). ![Botão Upgrade (Atualizar)](/assets/images/help/billing/settings_billing_user_upgrade.png) +4. Ao lado de " +{% data variables.product.prodname_free_user %}", clique em **Atualizar**. + ![Botão Upgrade (Atualizar)](/assets/images/help/billing/settings_billing_user_upgrade.png) {% data reusables.dotcom_billing.choose-monthly-or-yearly-billing %} {% data reusables.dotcom_billing.show-plan-details %} {% data reusables.dotcom_billing.enter-payment-info %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md b/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md index 6cf1bbbbd609..85cf49487755 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md @@ -6,7 +6,7 @@ versions: free-pro-team: '*' --- -Você também pode visualizar os minutos de execução do trabalho faturáveis para uma execução de fluxo de trabalho individual. Para obter mais informações, consulte "[Gerenciar a execução de fluxos de trabalho](/actions/configuring-and-managing-workflows/managing-a-workflow-run#viewing-billable-job-execution-minutes)". +Você também pode visualizar os minutos de execução do trabalho faturáveis para uma execução de fluxo de trabalho individual. Para obter mais informações, consulte "[Visualizar o tempo de execução do trabalho](/actions/managing-workflow-runs/viewing-job-execution-time)". ### Visualizando o uso de {% data variables.product.prodname_actions %} para sua conta de usuário @@ -43,6 +43,8 @@ Proprietários de organizações e gestores de faturamento podem visualizar o us {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %} -1. Em "{% data variables.product.prodname_actions %}", veja os detalhes do uso de transferência de dados por cada organização em sua conta corporativa. ![Detalhes do uso de minutos](/assets/images/help/billing/actions-minutes-enterprise.png) +1. Em " +{% data variables.product.prodname_actions %}", visualize os detalhes do uso da transferência de dados por organização na sua conta corporativa. + ![Detalhes do uso de minutos](/assets/images/help/billing/actions-minutes-enterprise.png) {% data reusables.dotcom_billing.actions-packages-storage-enterprise-account %} {% data reusables.enterprise-accounts.actions-packages-report-download-enterprise-accounts %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md b/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md index 9854324ad134..ddde5a5f06f6 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md @@ -41,6 +41,8 @@ Proprietários de organizações e gestores de faturamento podem visualizar o us {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %} -1. Em "{% data variables.product.prodname_registry %}", veja os detalhes do uso de transferência de dados por cada organização em sua conta corporativa. ![Detalhes do uso da transferência de dados](/assets/images/help/billing/packages-data-enterprise.png) +1. Em " +{% data variables.product.prodname_registry %}", veja os detalhes do uso da transferência de dados por organização na sua conta corporativa. + ![Detalhes do uso da transferência de dados](/assets/images/help/billing/packages-data-enterprise.png) {% data reusables.dotcom_billing.actions-packages-storage-enterprise-account %} {% data reusables.enterprise-accounts.actions-packages-report-download-enterprise-accounts %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md index a539b8c783b1..b12f5ee83917 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md @@ -25,5 +25,4 @@ Para organizações que pertencem a uma conta corporativa, a cobrança é gerenc Uma entidade, como uma empresa, não lucrativa, ou um grupo, pode concordar com os Termos de serviço padrão ou os Termos de serviço corporativos para a respectiva organização. Para obter mais informações, consulte "[Atualizar para os Termos de serviço corporativos](/articles/upgrading-to-the-corporate-terms-of-service)". -{% data reusables.organizations.enter-data-protection-agreement %} Para obter mais informações, consulte "[Inserir um contato de proteção de dados com o {% data variables.product.prodname_dotcom %} para conformidade com o regulamento GDPR](/articles/entering-a-data-protection-agreement-with-github-for-gdpr-compliance)". {% endif %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md index f2c6cdac9a22..0e2422ad6385 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md @@ -6,12 +6,12 @@ redirect_from: - /articles/about-ssh-certificate-authorities versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- Um certificado SSH é um mecanismo utilizado para uma chave SSH assinar outra chave SSH. Se você usa uma autoridade certificada (CA) SSH para fornecer certificados SSH aos integrantes da organização, você pode adicionar a CA em sua conta corporativa ou organização para permitir que integrantes da organização usem os certificados deles para acessar os recursos da organização. Para obter mais informações, consulte "[Gerenciar a autoridade certificada de SSH da organização](/articles/managing-your-organizations-ssh-certificate-authorities)". -Depois de adicionar uma CA SSH à sua organização ou conta corporativa, você pode usar a CA para assinar certificados SSH de cliente para integrantes da organização. Integrantes da organização podem usar os certificados assinados para acessar os repositórios da sua organização (e somente os repositórios da sua organização) no Git. Você pode exigir que os integrantes usem certificados SSH para acessar os recursos da organização.{% if currentVersion == "free-pro-team@latest" %} Para obter mais informações, consulte "[Aplicar configurações de segurança na conta corporativa](/articles/enforcing-security-settings-in-your-enterprise-account#managing-your-enterprise-accounts-ssh-certificate-authorities)".{% endif %} +Depois de adicionar uma CA SSH à sua organização ou conta corporativa, você pode usar a CA para assinar certificados SSH de cliente para integrantes da organização. Integrantes da organização podem usar os certificados assinados para acessar os repositórios da sua organização (e somente os repositórios da sua organização) no Git. Você pode exigir que os integrantes usem certificados SSH para acessar os recursos da organização.{% if currentVersion == "free-pro-team@latest" %} Para obter mais informações, consulte "[Aplicar configurações de segurança na sua conta corporativa](/articles/enforcing-security-settings-in-your-enterprise-account#managing-your-enterprise-accounts-ssh-certificate-authorities)".{% endif %} Por exemplo, você pode desenvolver um sistema interno que emite um novo certificado para seus desenvolvedores todas as manhãs. Cada desenvolvedor pode usar o certificado diário para trabalhar nos repositórios da organização no {% data variables.product.product_name %}. No final do dia, o certificado pode expirar automaticamente, protegendo seus repositórios caso o certificado seja adulterado mais tarde. diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/about-teams.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/about-teams.md index 163cf8f69acf..a84b2414425a 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/about-teams.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/about-teams.md @@ -21,7 +21,7 @@ Para obter mais informações, consulte: {% if currentVersion != "free-pro-team@latest" %} -Você também pode usar a sincronização LDAP para sincronizar os integrantes da equipe da {% data variables.product.product_location_enterprise %} e funções de equipe com os grupos LDAP estabelecidos. Isso permite estabelecer o controle de acesso baseado em função para usuários do servidor LDAP em vez de manualmente na {% data variables.product.product_location_enterprise %}. Para obter mais informações, consulte "[Habilitar a Sincronização LDAP](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)". +Você também pode usar a sincronização LDAP para sincronizar os integrantes e funções da equipe da {% data variables.product.product_location_enterprise %} com os grupos LDAP estabelecidos. Isso permite estabelecer o controle de acesso baseado em função para usuários do servidor LDAP em vez de manualmente na {% data variables.product.product_location_enterprise %}. Para obter mais informações, consulte "[Habilitar a Sincronização LDAP](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)". {% endif %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/about-your-organization-dashboard.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/about-your-organization-dashboard.md index 0b0210078539..40d77f2390fc 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/about-your-organization-dashboard.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/about-your-organization-dashboard.md @@ -28,7 +28,7 @@ Na barra lateral esquerda do painel, é possível acessar os principais reposit Na seção "All activity" (Todas as atividades) do seu feed de notícias, você pode ver atualizações de outras equipes e repositórios em sua organização. -A seção "All activity" (Todas as atividades) mostra todas as últimas atividades na organização, inclusive atividades em repositórios que você não assina e de pessoas que você não está seguindo. Para obter mais informações, consulte {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"Sobre notificações](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}"[Inspecionar e não inspecionar repositórios](/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories){% endif %}" e "[Seguir pessoas](/articles/following-people)." +A seção "All activity" (Todas as atividades) mostra todas as últimas atividades na organização, inclusive atividades em repositórios que você não assina e de pessoas que você não está seguindo. Para obter mais informações, consulte {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 0" %}"Sobre notificações](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}"[Inspecionar e deixar de inspecionar repositórios](/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories){% endif %}" e "[Seguir pessoas](/articles/following-people)." Por exemplo, o feed de notícias da organização mostra atualizações quando alguém na organização: - Cria um branch. diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/about-your-organizations-news-feed.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/about-your-organizations-news-feed.md index 771baca247d7..56f1cfdc818f 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/about-your-organizations-news-feed.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/about-your-organizations-news-feed.md @@ -17,4 +17,5 @@ O feed de notícias de uma organização mostra a atividade de outras pessoas no 1. {% data variables.product.signin_link %} na sua conta do {% data variables.product.product_name %}. 2. Abra o seu {% data reusables.user_settings.personal_dashboard %}. 3. Clique no alternador de contexto da conta no canto superior esquerdo da página. ![Botão do alternador de contexto no Enterprise](/assets/images/help/organizations/account_context_switcher.png) -4. Selecione uma organização no menu suspenso.{% if currentVersion == "free-pro-team@latest" %}![Context switcher menu in dotcom](/assets/images/help/organizations/account-context-switcher-selected-dotcom.png){% else %}![Context switcher menu in Enterprise](/assets/images/help/organizations/account_context_switcher.png){% endif %} +4. Selecione uma organização no menu suspenso.{% if currentVersion == "free-pro-team@latest" %} ![Context switcher menu in dotcom](/assets/images/help/organizations/account-context-switcher-selected-dotcom.png){% else %} +![Context switcher menu in Enterprise](/assets/images/help/organizations/account_context_switcher.png){% endif %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md index 28925b7b4b82..be116f9a95cb 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md @@ -17,6 +17,8 @@ Um colaborador externo é uma pessoa que não é explicitamente um integrante da {% data reusables.project-management.click-menu %} {% data reusables.project-management.access-collaboration-settings %} {% data reusables.project-management.collaborator-option %} -9. Em "Search by username, full name or email address" (Pesquisar por nome de usuário, nome completo ou endereço de e-mail), digite o nome do colaborador externo, nome de usuário ou e-mail no {% data variables.product.prodname_dotcom %}. ![A seção Collaborators (Colaboradores) com o nome de usuário Octocat inserido no campo de pesquisa](/assets/images/help/projects/org-project-collaborators-find-name.png) +9. Em "Pesquisar por nome de usuário, nome completo ou endereço de e-mail", digite o nome do colaborador, ou +e-mail de {% data variables.product.prodname_dotcom %}. + ![A seção Collaborators (Colaboradores) com o nome de usuário Octocat inserido no campo de pesquisa](/assets/images/help/projects/org-project-collaborators-find-name.png) {% data reusables.project-management.add-collaborator %} {% data reusables.project-management.collaborator-permissions %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md index cd352f77f66b..8b7d9ebcd48e 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md @@ -24,7 +24,9 @@ Para obter mais informações sobre as permissões de gerente do {% data variabl {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.github-apps-settings-sidebar %} -1. Em "{% data variables.product.prodname_github_app %}s", clique no avatar do app ao qual deseja adicionar um gerente do {% data variables.product.prodname_github_app %}. ![Selecione {% data variables.product.prodname_github_app %}](/assets/images/help/organizations/select-github-app.png) +1. Em " +{% data variables.product.prodname_github_app %}s", clique no avatar do aplicativo ao qual você deseja adicionar um gerente de {% data variables.product.prodname_github_app %}. +![Selecione {% data variables.product.prodname_github_app %}](/assets/images/help/organizations/select-github-app.png) {% data reusables.organizations.app-managers-settings-sidebar %} 1. Em "App managers" (Gerentes de app), digite o nome de usuário da pessoa que deseja designar como gerente do aplicativo GitHub e clique em **Grant** (Conceder). ![Adicionar um gerente do {% data variables.product.prodname_github_app %} para um app específico](/assets/images/help/organizations/add-github-app-manager-for-app.png) diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/adding-organization-members-to-a-team.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/adding-organization-members-to-a-team.md index 11a0c795705c..6b112565b6de 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/adding-organization-members-to-a-team.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/adding-organization-members-to-a-team.md @@ -1,6 +1,6 @@ --- -title: Adicionar integrantes da organização a uma equipe -intro: 'As pessoas com permissões de proprietário ou mantenedor de equipe podem adicionar integrantes da organização às equipes. As pessoas com permissões de proprietário também podem {% if currentVersion == "free-pro-team@latest" %}convidar não integrantes para ingressar em{% else %}adicionar não integrantes a{% endif %} uma equipe e na organização.' +title: Adding organization members to a team +intro: 'People with owner or team maintainer permissions can add organization members to teams. People with owner permissions can also {% if currentVersion == "free-pro-team@latest" %}invite non-members to join{% else %}add non-members to{% endif %} a team and the organization.' redirect_from: - /articles/adding-organization-members-to-a-team-early-access-program/ - /articles/adding-organization-members-to-a-team @@ -15,13 +15,14 @@ versions: {% data reusables.profile.access_org %} {% data reusables.organizations.specific_team %} {% data reusables.organizations.team_members_tab %} -6. Acima da lista de integrantes da equipe, clique em **Adicionar um integrante**. ![Botão Add member (Adicionar integrante)](/assets/images/help/teams/add-member-button.png) +6. Above the list of team members, click **Add a member**. +![Add member button](/assets/images/help/teams/add-member-button.png) {% data reusables.organizations.invite_to_team %} {% data reusables.organizations.review-team-repository-access %} {% if currentVersion == "free-pro-team@latest" %}{% data reusables.organizations.cancel_org_invite %}{% endif %} -### Leia mais +### Further reading -- "[Sobre equipes](/articles/about-teams)" -- "[Gerenciar o acesso da equipe a um repositório da organização](/articles/managing-team-access-to-an-organization-repository)" +- "[About teams](/articles/about-teams)" +- "[Managing team access to an organization repository](/articles/managing-team-access-to-an-organization-repository)" diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md index 346aeeb6d519..982b4996200c 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md @@ -15,8 +15,8 @@ O SAML SSO controla e protege o acesso a recursos da organização, como reposit Após ativar o SCIM, os seguintes recursos de provisionamento estarão disponíveis para qualquer usuário ao qual você atribuir seu aplicativo do {% data variables.product.prodname_ghe_cloud %} no Okta. -| Funcionalidade | Descrição | -| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Funcionalidade | Descrição | +| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Fazer push de novos usuários | Ao criar um novo usuário no Okta, ele receberá um e-mail para juntar-se à sua organização do {% data variables.product.prodname_dotcom %}. | | Fazer push de desativações de usuário | Ao desativar um usuário no Okta, este removerá o usuário da sua organização de {% data variables.product.prodname_dotcom %}. | | Fazer push das atualização de perfil | Ao atualizar o perfil de um usuário no Okta, este atualizará os metadados para a associação do usuário na sua organização de {% data variables.product.prodname_dotcom %}. | diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md new file mode 100644 index 000000000000..1dfd60daa225 --- /dev/null +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md @@ -0,0 +1,16 @@ +--- +title: Configurar o período de retenção para artefatos e registros do GitHub Actions na sua organização +intro: 'Você pode configurar o período de retenção para artefatos e registros de {% data variables.product.prodname_actions %} da sua organização.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.23' +--- + +{% data reusables.actions.about-artifact-log-retention %} + +## Definir o período de retenção para uma organização + +{% data reusables.organizations.navigate-to-org %} +{% data reusables.organizations.org_settings %} +{% data reusables.organizations.settings-sidebar-actions %} +{% data reusables.github-actions.change-retention-period-for-artifacts-logs %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-member-to-an-outside-collaborator.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-member-to-an-outside-collaborator.md index 262f14225f31..82e530a1261a 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-member-to-an-outside-collaborator.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-member-to-an-outside-collaborator.md @@ -23,7 +23,7 @@ Para obter mais informações, consulte "[Níveis de permissão para uma organiz Recomendamos rever o acesso dos membros da organização aos repositórios para garantir que seu o acesso seja como você espera. Para obter mais informações, consulte "[Gerenciar o acesso de um indivíduo ao repositório de uma organização](/articles/managing-an-individual-s-access-to-an-organization-repository)". -Na conversão de um integrante da organização em um colaborador externo, os privilégios dele como integrante da organização ficam salvos por três meses para que seja possível restaurar os privilégios de associação se você{% if currentVersion == "free-pro-team@latest" %}convidá-lo para reingressar{% else %} adicioná-lo de volta{% endif %} na organização dentro desse período. Para obter mais informações, consulte "[Restabelecer ex-integrantes da organização](/articles/reinstating-a-former-member-of-your-organization)". +Ao converter um integrante da organização em um colaborador externo, seus privilégios como integrantes da organização serão salvos por três meses para que você possa restaurar seus privilégios de associação se você{% if currentVersion == "free-pro-team@latest" %} convidá-los a juntar-se novamente{% else %} adicione-os à{% endif %} sua organização nesse período de tempo. Para obter mais informações, consulte "[Restabelecer ex-integrantes da organização](/articles/reinstating-a-former-member-of-your-organization)". {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/converting-an-outside-collaborator-to-an-organization-member.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/converting-an-outside-collaborator-to-an-organization-member.md index 88b634739162..be985f927923 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/converting-an-outside-collaborator-to-an-organization-member.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/converting-an-outside-collaborator-to-an-organization-member.md @@ -1,6 +1,6 @@ --- -title: Remover um colaborador externo em integrante da organização -intro: 'Se desejar fornecer a um colaborador externo nos repositórios da sua organização permissões mais amplas dentro da organização, você poderá {% if currentVersion == "free-pro-team@latest" %}convidá-lo a se tornar um integrante{% else %}torná-lo um integrante{% endif %} da organização.' +title: Converting an outside collaborator to an organization member +intro: 'If you would like to give an outside collaborator on your organization''s repositories broader permissions within your organization, you can {% if currentVersion == "free-pro-team@latest" %}invite them to become a member of{% else %}make them a member of{% endif %} the organization.' redirect_from: - /articles/converting-an-outside-collaborator-to-an-organization-member versions: @@ -10,10 +10,10 @@ versions: {% tip %} -**Dicas**: -- Somente proprietários da organização podem {% if currentVersion == "free-pro-team@latest" %}convidar usuários para ingressar em{% else %}adicionar usuários a{% endif %} uma organização. Para obter mais informações, consulte "[Níveis de permissão para uma organização](/articles/permission-levels-for-an-organization)".{% if currentVersion == "free-pro-team@latest" %} -- Se a organização tiver uma assinatura paga por usuário, ela deverá ter uma licença não utilizada disponível para você poder convidar um integrante para participar da organização ou restabelecer um ex-integrante da organização. Para obter mais informações, consulte "[Sobre preços por usuário](/articles/about-per-user-pricing)". {% data reusables.organizations.org-invite-expiration %}{% endif %} -- Se a organização [exigir que os integrantes usem a autenticação de dois fatores](/articles/requiring-two-factor-authentication-in-your-organization), os usuários {% if currentVersion == "free-pro-team@latest" %}que você convida deverão [habilitar a autenticação de dois fatores](/articles/securing-your-account-with-two-factor-authentication-2fa) para que possam aceitar o convite.{% else %}deverão [habilitar a autenticação de dois fatores](/articles/securing-your-account-with-two-factor-authentication-2fa) para que você possa adicioná-los à organização.{% endif %} +**Tips**: +- Only organization owners can {% if currentVersion == "free-pro-team@latest" %}invite users to join{% else %}add users to{% endif %} an organization. For more information, see "[Permission levels for an organization](/articles/permission-levels-for-an-organization)."{% if currentVersion == "free-pro-team@latest" %} +- If your organization is on a paid per-user subscription, an unused license must be available before you can invite a new member to join the organization or reinstate a former organization member. For more information, see "[About per-user pricing](/articles/about-per-user-pricing)." {% data reusables.organizations.org-invite-expiration %}{% endif %} +- If your organization [requires members to use two-factor authentication](/articles/requiring-two-factor-authentication-in-your-organization), users {% if currentVersion == "free-pro-team@latest" %}you invite must [enable two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa) before they can accept the invitation.{% else %}must [enable two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa) before you can add them to the organization.{% endif %} {% endtip %} @@ -22,10 +22,9 @@ versions: {% data reusables.organizations.people %} {% data reusables.organizations.people_tab_outside_collaborators %} {% if currentVersion == "free-pro-team@latest" %} -5. À direita do nome do colaborador externo que você deseja que se torne um membro, use o -{% octicon "gear" aria-label="The gear icon" %} menu suspenso e clique em **Convidar para a organização**.![Convidar colaboradores externos para a organização](/assets/images/help/organizations/invite_outside_collaborator_to_organization.png) +5. To the right of the name of the outside collaborator you want to become a member, use the {% octicon "gear" aria-label="The gear icon" %} drop-down menu and click **Invite to organization**.![Invite outside collaborators to organization](/assets/images/help/organizations/invite_outside_collaborator_to_organization.png) {% else %} -5. À direita do nome do colaborador externo que você deseja que se torne integrante, clique em **Invite to organization** (Convidar para a organização).![Convidar colaboradores externos para a organização](/assets/images/enterprise/orgs-and-teams/invite_outside_collabs_to_org.png) +5. To the right of the name of the outside collaborator you want to become a member, click **Invite to organization**.![Invite outside collaborators to organization](/assets/images/enterprise/orgs-and-teams/invite_outside_collabs_to_org.png) {% endif %} {% data reusables.organizations.choose-to-restore-privileges %} {% data reusables.organizations.choose-user-role-send-invitation %} @@ -33,6 +32,6 @@ versions: {% data reusables.organizations.user_must_accept_invite_email %} {% data reusables.organizations.cancel_org_invite %} {% endif %} -### Leia mais +### Further reading -- "[Converter um integrante da organização em colaborador externo](/articles/converting-an-organization-member-to-an-outside-collaborator)" +- "[Converting an organization member to an outside collaborator](/articles/converting-an-organization-member-to-an-outside-collaborator)" diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch.md index 71ed69676361..89377c3b5d98 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch.md @@ -13,7 +13,7 @@ Quando você cria uma organização do zero, ela não tem repositórios associad {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.organizations %} {% data reusables.organizations.new-organization %} -4. Siga as instruções para criar sua organização. {% if currentVersion == "free-pro-team@latest" %}Para obter mais informações sobre os planos disponíveis para sua equipe, consulte "[{% data variables.product.prodname_dotcom %}'s products](/articles/githubs-products)".{% endif %} +4. Siga as instruções para criar sua organização. {% if currentVersion == "free-pro-team@latest" %}Para obter mais informações sobre os planos disponíveis para a sua equipe, consulte "[ produtos de {% data variables.product.prodname_dotcom %}](/articles/githubs-products)".{% endif %} ### Leia mais diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/deleting-an-organization-account.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/deleting-an-organization-account.md index d471626fc034..5264ff5295ad 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/deleting-an-organization-account.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/deleting-an-organization-account.md @@ -1,6 +1,6 @@ --- title: Excluir uma conta de organização -intro: 'Quando você exclui uma organização, todos os repositórios, bifurcações de repositórios privados, wikis, problemas, pull requests e páginas de projeto ou de organização são excluídos também. {% if currentVersion == "free-pro-team@latest" %}O nome da organização fica disponível para uso em uma nova conta de usuário ou de organização, e a cobrança cessa.{% endif %}' +intro: 'Quando você exclui uma organização, todos os repositórios, bifurcações de repositórios privados, wikis, problemas, pull requests e páginas de projeto ou de organização são excluídos também. {% if currentVersion == "free-pro-team@latest" %}O nome da organização fica disponível para uso em uma nova conta de usuário ou organização, e a cobrança será encerrada{% endif %}' redirect_from: - /articles/deleting-an-organization-account versions: diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md index 59e535631c63..88ac265be8e1 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md @@ -17,6 +17,8 @@ Você pode habilitar o {% data variables.product.prodname_actions %} para todos Como alternativa, você pode habilitar o {% data variables.product.prodname_actions %} para todos os repositórios na sua organização e limitar as ações que um fluxo de trabalho pode executar. {% data reusables.github-actions.enabled-local-github-actions %} +{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.23" %} + ### Gerenciar as permissões de {% data variables.product.prodname_actions %} para a sua organização {% data reusables.profile.access_profile %} @@ -26,6 +28,42 @@ Como alternativa, você pode habilitar o {% data variables.product.prodname_acti 1. Em **Ações locais e de terceiros**, selecione uma opção. ![Habilitar, desabilitar ou limitar ações para esta organização](/assets/images/help/repository/enable-org-actions.png) 1. Clique em **Salvar**. +{% endif %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} + +### Gerenciar as permissões de {% data variables.product.prodname_actions %} para a sua organização + +Você pode desabilitar todos os fluxos de trabalho para uma organização ou definir uma política que configura quais ações podem ser usadas em uma organização. + +{% data reusables.actions.actions-use-policy-settings %} + +{% note %} + +**Observação:** Talvez você não consiga gerenciar essas configurações se a sua organização for gerenciada por uma empresa que tem uma política de substituição. Para obter mais informações, {% if currentVersion == "free-pro-team@latest" %}"[Aplicar políticas de {% data variables.product.prodname_actions %} na sua conta corporativa](/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account).{% else %}"[Aplicar políticas de {% data variables.product.prodname_actions %} para a sua empresa](/enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise).{% endif %} + +{% endnote %} + +{% data reusables.profile.access_profile %} +{% data reusables.profile.access_org %} +{% data reusables.organizations.org_settings %} +{% data reusables.organizations.settings-sidebar-actions %} +1. Em **Políticas**, selecione uma opção. ![Definir política de ações para esta organização](/assets/images/help/organizations/actions-policy.png) +1. Clique em **Salvar**. + +### Permitir a execução de ações específicas + +{% data reusables.actions.allow-specific-actions-intro %} + +{% data reusables.profile.access_profile %} +{% data reusables.profile.access_org %} +{% data reusables.organizations.org_settings %} +{% data reusables.organizations.settings-sidebar-actions %} +1. Em **Políticas**, selecione **Permitir ações específicas** e adicione as suas ações necessárias à lista. ![Adicionar ações para permitir lista](/assets/images/help/organizations/actions-policy-allow-list.png) +1. Clique em **Salvar**. + +{% endif %} + {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} ### Habilitar fluxos de trabalho para bifurcações privadas do repositório diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization.md index a360f67eb3d1..f3231626ad45 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization.md @@ -1,26 +1,28 @@ --- -title: Desabilitar a publicação de sites do GitHub Pages para sua organização -intro: 'É possível impedir que os integrantes da sua organização publiquem sites do {% data variables.product.prodname_pages %} em repositórios na organização.' -permissions: 'Os proprietários da organização podem desabilitar a publicação de sites do {% data variables.product.prodname_pages %} em repositórios na organização.' +title: Disabling publication of GitHub Pages sites for your organization +intro: 'You can prevent members of your organization from publishing {% data variables.product.prodname_pages %} sites from repositories in the organization.' +permissions: 'Organization owners can disable publication of {% data variables.product.prodname_pages %} sites from repositories in the organization.' product: '{% data reusables.gated-features.pages %}' versions: free-pro-team: '*' enterprise-server: '>2.22' --- -### Sobre as restrições na publicação de sites do {% data variables.product.prodname_pages %} +### About restrictions on publication of {% data variables.product.prodname_pages %} sites -Você pode controlar se os integrantes da sua organização podem publicar sites de repositórios na sua organização usando o {% data variables.product.prodname_pages %}. Para obter mais informações sobre {% data variables.product.prodname_pages %}, consulte "[Sobre {% data variables.product.prodname_pages %}](/github/working-with-github-pages/about-github-pages)." +You can control whether members of your organization can publish websites from repositories in your organization using {% data variables.product.prodname_pages %}. For more information about {% data variables.product.prodname_pages %}, see "[About {% data variables.product.prodname_pages %}](/github/working-with-github-pages/about-github-pages)." -{% if currentVersion != "free-pro-team@latest" %}Se o administrador do seu site habilitou páginas públicas, {% endif %} os sites do {% data variables.product.prodname_pages %} ficarão publicamente disponíveis na internet, Mesmo que o repositório para o site seja privado{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} ou interno{% endif %}. For more information, see{% if currentVersion != "free-pro-team@latest" %} "[Configuring {% data variables.product.prodname_pages %} on your appliance](/enterprise/admin/installation/configuring-github-pages-on-your-appliance#making-github-pages-publicly-accessible)" and{% endif %} "[About repository visibility](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)." +{% if currentVersion != "free-pro-team@latest" %}If your site administrator has enabled Public Pages, {% endif %}{% data variables.product.prodname_pages %} sites are publicly available on the internet, even if the repository for the site is private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %}. For more information, see{% if currentVersion != "free-pro-team@latest" %} "[Configuring {% data variables.product.prodname_pages %} on your appliance](/enterprise/admin/installation/configuring-github-pages-on-your-appliance#making-github-pages-publicly-accessible)" and{% endif %} "[About repository visibility](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)." -### Desabilitar publicação de sites do {% data variables.product.prodname_pages %} +### Disabling publication of {% data variables.product.prodname_pages %} sites -Depois de desabilitar a publicação de sites do {% data variables.product.prodname_pages %} , qualquer site publicado permanecerá publicado. Você pode remover manualmente a publicação do site. Para obter mais informações, consulte "[Cancelar a publicação de um site do {% data variables.product.prodname_pages %}](/github/working-with-github-pages/unpublishing-a-github-pages-site)". +After you disable publication of {% data variables.product.prodname_pages %} sites, any published site will remain published. You can manually unpublish the site. For more information, see "[Unpublishing a {% data variables.product.prodname_pages %} site](/github/working-with-github-pages/unpublishing-a-github-pages-site)." {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.member-privileges %} -1. Em "Criação de páginas, desmarque **Permitir que os integrantes publiquem sites**. ![Caixa de seleção não marcada para a opção "Permitir que os membros publiquem sites"](/assets/images/help/organizations/org-settings-pages-disable-publication-checkbox.png) -1. Clique em **Salvar**. ![Botão "Salvar" para a opção "Permitir que os integrantes publiquem sites"](/assets/images/help/organizations/org-settings-pages-disable-publication-save-button.png) +1. Under "Pages creation", unselect **Allow members to publish sites**. + ![Unselected checkbox for "Allow members to publish sites" option](/assets/images/help/organizations/org-settings-pages-disable-publication-checkbox.png) +1. Click **Save**. + !["Save" button for "Allow members to publish sites" option](/assets/images/help/organizations/org-settings-pages-disable-publication-save-button.png) diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/enabling-and-testing-saml-single-sign-on-for-your-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/enabling-and-testing-saml-single-sign-on-for-your-organization.md index 9860b1cd5239..f424b7b6d4b4 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/enabling-and-testing-saml-single-sign-on-for-your-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/enabling-and-testing-saml-single-sign-on-for-your-organization.md @@ -1,6 +1,6 @@ --- title: Habilitar e testar logon único de SAML para sua organização -intro: 'Os administradores e proprietários da organização podem habilitar o logon único (SSO, Single Sign-On) de SAML para adicionar uma camada extra de segurança à organização.' +intro: Os administradores e proprietários da organização podem habilitar o logon único (SSO, Single Sign-On) de SAML para adicionar uma camada extra de segurança à organização. product: '{% data reusables.gated-features.saml-sso %}' redirect_from: - /articles/enabling-and-testing-saml-single-sign-on-for-your-organization diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/enforcing-saml-single-sign-on-for-your-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/enforcing-saml-single-sign-on-for-your-organization.md index 4bf22cc3278f..2fa95782c70b 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/enforcing-saml-single-sign-on-for-your-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/enforcing-saml-single-sign-on-for-your-organization.md @@ -1,6 +1,6 @@ --- title: Aplicar logon único de SAML para sua organização -intro: 'Administradores e proprietários da organização podem aplicar logon único (SSO, Single Sign-On) de SAML para que todos os integrantes da organização precisem se autenticar por meio de um provedor de identidade.' +intro: Administradores e proprietários da organização podem aplicar logon único (SSO, Single Sign-On) de SAML para que todos os integrantes da organização precisem se autenticar por meio de um provedor de identidade. product: '{% data reusables.gated-features.saml-sso %}' redirect_from: - /articles/enforcing-saml-single-sign-on-for-your-organization diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/index.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/index.md index cd6065dec4a9..a999fc78c203 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/index.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/index.md @@ -100,6 +100,7 @@ versions: {% link_in_list /managing-the-forking-policy-for-your-organization %} {% link_in_list /disabling-or-limiting-github-actions-for-your-organization %} + {% link_in_list /configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization %} {% link_in_list /setting-permissions-for-adding-outside-collaborators %} @@ -131,7 +132,6 @@ versions: {% link_in_list /upgrading-to-the-corporate-terms-of-service %} - {% link_in_list /entering-a-data-protection-agreement-with-github-for-gdpr-compliance %} {% topic_link_in_list /migrating-to-improved-organization-permissions %} {% link_in_list /converting-an-owners-team-to-improved-organization-permissions %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md index 678554365f04..c473f20458c1 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md @@ -1,6 +1,7 @@ --- title: Convidar usuários para sua organização intro: 'É possível convidar qualquer pessoa para integrar sua organização usando o nome de usuário {% data variables.product.product_name %} ou endereço de e-mail dela.' +permissions: Os proprietários da organização podem convidar usuários para participar de uma organização. redirect_from: - /articles/adding-or-inviting-members-to-a-team-in-an-organization/ - /articles/inviting-users-to-join-your-organization @@ -11,9 +12,8 @@ versions: {% tip %} **Dicas**: -- Somente proprietários da organização podem convidar usuários para participar de uma organização. Para obter mais informações, consulte "[Níveis de permissão para uma organização](/articles/permission-levels-for-an-organization)". - Se a organização tiver uma assinatura paga por usuário, ela deverá ter uma licença não utilizada disponível para você poder convidar um integrante para participar da organização ou restabelecer um ex-integrante da organização. Para obter mais informações, consulte "[Sobre preços por usuário](/articles/about-per-user-pricing)". {% data reusables.organizations.org-invite-expiration %} -- Se sua organização [exigir que integrantes usem autenticação de dois fatores](/articles/requiring-two-factor-authentication-in-your-organization), os usuários que você convida deverão [habilitar a autenticação de dois fatores](/articles/securing-your-account-with-two-factor-authentication-2fa) antes de aceitar o convite. +- Se a sua organização exige que os integrantes usem a autenticação de dois fatores, os usuários que você convidar deverão ativar a autenticação de dois fatores antes de aceitar o convite. Para mais informações, consulte "[Exigir a autenticação de dois fatores na sua organização](/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization)" e[Proteger a sua conta com a autenticação de dois fatores (2FA)](/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa)". {% endtip %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md index acfae1f3bf1b..af9c150dcec9 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md @@ -24,7 +24,9 @@ versions: {% data reusables.project-management.click-menu %} {% data reusables.project-management.access-collaboration-settings %} {% data reusables.project-management.collaborator-option %} -9. Em "Search by username, full name or email address" (Pesquisar por nome de usuário, nome completo ou endereço de e-mail), digite o nome, o nome de usuário ou o e-mail do colaborador no {% data variables.product.prodname_dotcom %}. ![A seção Collaborators (Colaboradores) com o nome de usuário Octocat inserido no campo de pesquisa](/assets/images/help/projects/org-project-collaborators-find-name.png) +9. Em "Pesquisar por nome de usuário, nome completo ou endereço de e-mail", digite o nome do colaborador, nome de usuário, ou +e-mail de {% data variables.product.prodname_dotcom %}. + ![A seção Collaborators (Colaboradores) com o nome de usuário Octocat inserido no campo de pesquisa](/assets/images/help/projects/org-project-collaborators-find-name.png) {% data reusables.project-management.add-collaborator %} {% data reusables.project-management.collaborator-permissions %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-repository.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-repository.md index 09d5c6b26850..bd15010aa0e5 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-repository.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-repository.md @@ -30,5 +30,5 @@ Ao remover um colaborador de um repositório de sua organização, o colaborador ### Leia mais -{% if currentVersion == "free-pro-team@latest" %}- "[Restringir interações no repositório](/articles/limiting-interactions-with-your-repository)"{% endif %} +{% if currentVersion == "free-pro-team@latest" %}- "[Limitar interações com o seu repositório](/articles/limiting-interactions-with-your-repository)"{% endif %} - "[Níveis de permissão do repositório para uma organização](/articles/repository-permission-levels-for-an-organization)" diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md index d51ec3fefe74..57d6fcd3a17f 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md @@ -1,6 +1,6 @@ --- title: Gerenciar acesso do Git aos repositórios da organização -intro: 'Você pode adicionar uma autoridade certificada (CA, certificate authority) SSH em sua organização e permitir que os integrantes acessem os repositórios da organização no Git usando as chaves assinadas pela CA SSH.' +intro: Você pode adicionar uma autoridade certificada (CA, certificate authority) SSH em sua organização e permitir que os integrantes acessem os repositórios da organização no Git usando as chaves assinadas pela CA SSH. mapTopic: true product: '{% data reusables.gated-features.ssh-certificate-authorities %}' redirect_from: @@ -8,6 +8,6 @@ redirect_from: - /articles/managing-git-access-to-your-organizations-repositories versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-membership-in-your-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-membership-in-your-organization.md index dde31f8a0f80..9315d75365a5 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-membership-in-your-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-membership-in-your-organization.md @@ -1,6 +1,6 @@ --- title: Gerenciar associação na organização -intro: 'Depois de criar a organização, é possível {% if currentVersion == "free-pro-team@latest" %}convidar pessoas para se tornarem{% else %}adicionar pessoas como{% endif %} integrantes da organização. Você também pode remover integrantes da organização e restabelecer ex-integrantes.' +intro: 'Depois de criar a sua organização, você pode {% if currentVersion == "free-pro-team@latest" %}convide pessoas para se tornar {% else %}adicionar pessoas como{% endif %} integrantes da organização. Você também pode remover integrantes da organização e restabelecer ex-integrantes.' redirect_from: - /articles/removing-a-user-from-your-organization/ - /articles/managing-membership-in-your-organization diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository.md index c5204f462119..2cf02c42cd8f 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository.md @@ -1,6 +1,6 @@ --- title: Gerenciar o acesso da equipe em um repositório da organização -intro: Você pode conceder e remover o acesso da equipe a um repositório ou mudar o nível de permissão dela no repositório. +intro: 'Você pode conceder e remover o acesso da equipe a um repositório ou mudar o nível de permissão dela no repositório.' redirect_from: - /articles/managing-team-access-to-an-organization-repository-early-access-program/ - /articles/managing-team-access-to-an-organization-repository diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md index e7d17c889de3..dd3e45744ae1 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md @@ -1,18 +1,17 @@ --- title: Gerenciar o nome de branch-padrão para repositórios na sua organização -intro: É possível definir o nome do branch-padrão para repositórios que os integrantes criam na sua organização. +intro: 'Você pode definir o nome do branch-padrão para repositórios que os integrantes criam na sua organização em {% data variables.product.product_location %}.' +permissions: Os proprietários da organização podem gerenciar o nome do branch-padrão para novos repositórios na organização. versions: free-pro-team: '*' enterprise-server: '>=2.23' --- -### Sobre o nome do branch-padrão +### Sobre o gerenciamento do nome do brancc-padrão -Quando um membro da sua organização cria um novo repositório, o {% data variables.product.prodname_dotcom %} criará um único branch e o irá defini-lo como branch-padrão do repositório. {% data variables.product.prodname_dotcom %} atualmente nomeia o branch-padrão `mestre`, mas você pode definir o branch-padrão com qualquer nome que faça sentido para o seu ambiente de desenvolvimento. +Quando um integrante da sua organização cria um novo repositório na sua organização, o repositório contém um branch, que é o branch-padrão. Você pode alterar o nome que {% data variables.product.product_name %} usa para o branch-padrão em novos repositórios que os integrantes da sua organização criam. Para obter mais informações sobre o branch padrão, consulte "[Sobre branches](/github/collaborating-with-issues-and-pull-requests/about-branches#about-the-default-branch)". -{% data reusables.branches.set-default-branch %} - -{% data reusables.branches.rename-existing-branch %} +{% data reusables.branches.change-default-branch %} ### Definir o nome do branch-padrão @@ -23,7 +22,7 @@ Quando um membro da sua organização cria um novo repositório, o {% data varia 3. Em "Branch padrão do repositório", clique em **Alterar o nome do branch-padrão agora**. ![Botão de sobrescrever](/assets/images/help/organizations/repo-default-name-button.png) {% note %} - **Observação:** Se o proprietário da empresa já aplicou uma política para o nome-padrão, você não conseguirá alterá-la aqui. Você conseguirá definir o branch-padrão em repositórios individuais. Para obter mais informações, consulte "[Exigir uma política com o nome do branch-padrão](/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account#enforcing-a-policy-on-the-default-branch-name)" e "[Definir o branch-padrão](/github/administering-a-repository/setting-the-default-branch)". + **Observação:** Se o proprietário da empresa já aplicou uma política para o nome-padrão, você não conseguirá alterá-la aqui. Você conseguirá definir o branch-padrão em repositórios individuais. Para obter mais informações, consulte "[Aplicar uma política com o nome do branch-padrão](/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account#enforcing-a-policy-on-the-default-branch-name)" e "[Alterar o branch-padrão](/github/administering-a-repository/changing-the-default-branch)". {% endnote %} 4. Digite o nome-padrão que você gostaria de usar para novos branches. ![Caixa de texto para digitar o nome-padrão](/assets/images/help/organizations/repo-default-name-text.png) @@ -31,4 +30,4 @@ Quando um membro da sua organização cria um novo repositório, o {% data varia ### Leia mais -- [Gerenciar o nome do branch-padrão para seus repositórios](/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories) +- "[Gerenciar o nome do branch-padrão para seus repositórios](/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories)" diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md index 7319834a5b1d..63db08e0346c 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md @@ -6,7 +6,7 @@ redirect_from: - /articles/managing-the-display-of-member-names-in-your-organization versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- Proprietários de organização podem gerenciar a exibição do nome de integrantes na organização. diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization.md index 345c6036c689..a46bfe90821e 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization.md @@ -1,6 +1,6 @@ --- title: Gerenciar a política de bifurcação da sua organização -intro: 'Você pode permitir ou impedir a bifurcação de qualquer repositório privado{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} e interno{% endif %} que pertence à sua organização.' +intro: 'Você pode permitir ou impedir a bifurcação de qualquer repositórios privado{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 9" %} e{% endif %} e internos pertencentes à sua organização.' redirect_from: - /articles/allowing-people-to-fork-private-repositories-in-your-organization - /github/setting-up-and-managing-organizations-and-teams/allowing-people-to-fork-private-repositories-in-your-organization @@ -10,9 +10,9 @@ versions: enterprise-server: '*' --- -Por padrão, as novas organizações estão configuradas para não permitir a bifurcação de repositórios privados{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} e internos{% endif %}. +Por padrão, as novas organizações são configuradas para impedir a bifurcação de repositórios privado{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} e internos {% endif %}. -Se você permitir a bifurcação de repositórios privados{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} e internos{% endif %} no nível da organização você também poderá configurar a capacidade de bifurcar um repositório privado{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} ou interno{% endif %}. Para obter mais informações, consulte "[Gerenciar a política de bifurcação do seu repositório](/github/administering-a-repository/managing-the-forking-policy-for-your-repository)". +Se você permite a bifurcação de repositórios privados{% if currentVersion == "free-pro-team@latest" ou currentVersion ver_gt "enterprise-server@2. 9" %} e internos{% endif %} no nível da organização você também pode configurar a capacidade de bifurcar um repositório privado específico{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 9" %} ou repositório interno{% endif %}. Para obter mais informações, consulte "[Gerenciar a política de bifurcação do seu repositório](/github/administering-a-repository/managing-the-forking-policy-for-your-repository)". {% data reusables.organizations.internal-repos-enterprise %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md index 58571b38e3a1..1e17504ac6b6 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md @@ -6,7 +6,7 @@ redirect_from: - /articles/managing-your-organizations-ssh-certificate-authorities versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- Proprietários da organização podem gerenciar as autoridades certificadas (CA, certificate authorities) de SSH da organização. diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/organizing-members-into-teams.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/organizing-members-into-teams.md index 86016ab4aead..b6a9a9077438 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/organizing-members-into-teams.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/organizing-members-into-teams.md @@ -1,6 +1,6 @@ --- title: Organizar integrantes em equipes -intro: 'Você pode agrupar os integrantes da organização em equipes que reflitam sua empresa ou a estrutura do grupo, com permissões de acesso em cascata e menções.' +intro: Você pode agrupar os integrantes da organização em equipes que reflitam sua empresa ou a estrutura do grupo, com permissões de acesso em cascata e menções. redirect_from: - /articles/setting-up-teams-improved-organization-permissions/ - /articles/setting-up-teams-for-accessing-organization-repositories/ diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md index f6e6ffd110ee..c645cd71b889 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md @@ -11,7 +11,7 @@ versions: ### Níveis de permissão da organização -Os integrantes da organização podem ter funções de *proprietário*{% if currentVersion == "free-pro-team@latest" %}, *gerente de cobrança*{% endif %} ou *integrante*: +Os integrantes da organização podem ter funções de *proprietário*{% if currentVersion == "free-pro-team@latest" %}, *gerente de cobrança*,{% endif %} ou *integrante*: - **Proprietários** têm acesso administrativo total à sua organização. Essa função deve ser limitada a não menos que duas pessoas na sua organização. Para obter mais informações, consulte "[Manter a continuidade da propriedade para a sua organização](/github/setting-up-and-managing-organizations-and-teams/maintaining-ownership-continuity-for-your-organization)". {% if currentVersion == "free-pro-team@latest" %} @@ -22,94 +22,95 @@ Os integrantes da organização podem ter funções de *proprietário*{% if curr {% if currentVersion == "free-pro-team@latest" %} -| Ação da organização | Proprietários | Integrantes | Gerentes de cobrança | -|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-------------:|:-----------:|:----------------------------------:| -| Criar repositórios (consulte "[Restringir a criação de repositórios na organização](/articles/restricting-repository-creation-in-your-organization)" para detalhes) | **X** | **X** | | -| Visualizar e editar informações de cobrança | **X** | | **X** | -| Convidar pessoas para integrar a organização | **X** | | | -| Editar e cancelar convites para integrar a organização | **X** | | | -| Remover integrantes da organização | **X** | | | -| Restabelecer ex-integrantes da organização | **X** | | | -| Adicionar e remover pessoas de **todas as equipes** | **X** | | | -| Promover integrantes da organização a *mantenedor de equipe* | **X** | | | -| Configurar as atribuições de revisão de código (consulte "[Gerenciar a atribuição de revisão de código para a sua equipe](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)") | **X** | | | -| Definir lembretes agendados (consulte "[Gerenciar lembretes agendados para pull requests](/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests)") | **X** | | | -| Adicionar colaboradores em **todos os repositórios** | **X** | | | -| Acessar o log de auditoria da organização | **X** | | | -| Editar a página de perfil da organização (consulte "[Sobre o perfil da sua organização](/articles/about-your-organization-s-profile)" para detalhes) | **X** | | | -| Verificar os domínios da organização (consulte "[Verificar o domínio da sua organização](/articles/verifying-your-organization-s-domain)" para detalhes) | **X** | | | -| Excluir **todas as equipes** | **X** | | | -| Excluir a conta da organização, inclusive todos os repositórios | **X** | | | -| Criar equipes (consulte "[Configurar permissões de criação de equipes na organização](/articles/setting-team-creation-permissions-in-your-organization)" para detalhes) | **X** | **X** | | -| [Mover equipes na hierarquia da organização](/articles/moving-a-team-in-your-organization-s-hierarchy) | **X** | | | -| Criar quadros de projetos (consulte "[Permissões de quadro de projeto para uma organização](/articles/project-board-permissions-for-an-organization)" para detalhes) | **X** | **X** | | -| Ver todos os integrantes e equipes da organização | **X** | **X** | | -| @mencionar qualquer equipe visível | **X** | **X** | | -| Poder se tornar um *mantenedor de equipe* | **X** | **X** | | -| Visualizar as informações da organização (consulte "[Visualizar informações da organização](/articles/viewing-insights-for-your-organization)" para detalhes) | **X** | **X** | | -| Visualizar e publicar discussões de equipe públicas para **todas as equipes** (consulte "[Sobre discussões de equipe](/articles/about-team-discussions)" para detalhes) | **X** | **X** | | -| Visualizar e publicar discussões de equipe privadas para **todas as equipes** (consulte "[Sobre discussões de equipe](/articles/about-team-discussions)" para detalhes) | **X** | | | -| Editar e excluir discussões de equipe em **todas as equipes** (consulte "[Gerenciar comentários conflituosos](/articles/managing-disruptive-comments)" para detalhes) | **X** | | | -| Ocultar comentários em commits, pull requests e problemas (consulte "[Gerenciar comentários conflituosos](/articles/managing-disruptive-comments/#hiding-a-comment)" para detalhes) | **X** | **X** | | -| Desabilitar discussões de equipe na organização (consulte "[Desabilitar discussões de equipe em sua organização](/articles/disabling-team-discussions-for-your-organization)" para detalhes) | **X** | | |{% if currentVersion == "free-pro-team@latest" %} -| Gerenciar a visualização de informações de dependência da organização (consulte "[Alterar a visibilidade das informações de dependência da organização](/articles/changing-the-visibility-of-your-organizations-dependency-insights)" para detalhes) | **X** | | |{% endif %} -| Definir uma foto de perfil da equipe para **todas as equipes** (consulte "[Definir uma foto de perfil de sua equipe](/articles/setting-your-team-s-profile-picture)" para detalhes) | **X** | | | -| Desabilitar a publicação de sites do {% data variables.product.prodname_pages %} em repositórios na organização (consulte "[Desabilitar a publicação de sites de {% data variables.product.prodname_pages %} para a sua organização](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)" para obter informações) | **X** | | | -| Gerenciar as configurações de segurança e análise (consulte "[Gerenciar as configurações de segurança e análise para a sua organização](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization)" para obter mais informações) | **X** | | | -| Habilitar e executar [logon único SAML](/articles/about-identity-and-access-management-with-saml-single-sign-on) | **X** | | | -| [Gerenciar o acesso de SAML de um usuário à sua organização](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization) | **X** | | | -| Gerenciar uma autoridade certificada de SSH da organização (consulte "[Gerenciar a autoridade certificada de SSH da organização](/articles/managing-your-organizations-ssh-certificate-authorities)" para detalhes) | **X** | | | -| Transferir repósitórios | **X** | | | -| Comprar, instalar, gerenciar cobranças e cancelar aplicativos do {% data variables.product.prodname_marketplace %} | **X** | | | -| Listar aplicativos no {% data variables.product.prodname_marketplace %} | **X** | | | -| Recebe [{% data variables.product.prodname_dependabot_alerts %} sobre dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) para todos os repositórios de uma organização | **X** | | | -| Gerenciar {% data variables.product.prodname_dependabot_security_updates %} (consulte "[Configurar {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)") | **X** | | | -| [Gerenciar a política de bifurcação](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization) | **X** | | | -| [Limitar a atividade em repositórios públicos na organização](/articles/limiting-interactions-in-your-organization) | **X** | | | -| Fazer pull (ler), fazer push (gravar) e clonar (copiar) *todos os repositórios* na organização | **X** | | | -| Converter integrantes da organização em [colaboradores externos](#outside-collaborators) | **X** | | | -| [Exibir as pessoas com acesso a um repositório da organização](/articles/viewing-people-with-access-to-your-repository) | **X** | | | -| [Exportar uma lista das pessoas com acesso a um repositório da organização](/articles/viewing-people-with-access-to-your-repository/#exporting-a-list-of-people-with-access-to-your-repository) | **X** | | | -| Gerenciar etiquetas padrão (consulte "[Gerenciar etiquetas padrão nos repositórios da organização](/articles/managing-default-labels-for-repositories-in-your-organization)") | **X** | | | -| Habilitar sincronização de equipes (consulte "[Gerenciar sincronização de equipe para a sua organização](/github/setting-up-and-managing-organizations-and-teams/managing-team-synchronization-for-your-organization)" para obter informações) | **X** | | | +| Ação da organização | Proprietários | Integrantes | Gerentes de cobrança | +|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-------------:|:-----------:|:--------------------------------------------------:| +| Criar repositórios (consulte "[Restringir a criação de repositórios na organização](/articles/restricting-repository-creation-in-your-organization)" para detalhes) | **X** | **X** | | +| Visualizar e editar informações de cobrança | **X** | | **X** | +| Convidar pessoas para integrar a organização | **X** | | | +| Editar e cancelar convites para integrar a organização | **X** | | | +| Remover integrantes da organização | **X** | | | +| Restabelecer ex-integrantes da organização | **X** | | | +| Adicionar e remover pessoas de **todas as equipes** | **X** | | | +| Promover integrantes da organização a *mantenedor de equipe* | **X** | | | +| Configurar as atribuições de revisão de código (consulte "[Gerenciar a atribuição de revisão de código para a sua equipe](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)") | **X** | | | +| Definir lembretes agendados (consulte "[Gerenciar lembretes agendados para pull requests](/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests)") | **X** | | | +| Adicionar colaboradores em **todos os repositórios** | **X** | | | +| Acessar o log de auditoria da organização | **X** | | | +| Editar a página de perfil da organização (consulte "[Sobre o perfil da sua organização](/articles/about-your-organization-s-profile)" para detalhes) | **X** | | | +| Verificar os domínios da organização (consulte "[Verificar o domínio da sua organização](/articles/verifying-your-organization-s-domain)" para detalhes) | **X** | | | +| Excluir **todas as equipes** | **X** | | | +| Excluir a conta da organização, inclusive todos os repositórios | **X** | | | +| Criar equipes (consulte "[Configurar permissões de criação de equipes na organização](/articles/setting-team-creation-permissions-in-your-organization)" para detalhes) | **X** | **X** | | +| [Mover equipes na hierarquia da organização](/articles/moving-a-team-in-your-organization-s-hierarchy) | **X** | | | +| Criar quadros de projetos (consulte "[Permissões de quadro de projeto para uma organização](/articles/project-board-permissions-for-an-organization)" para detalhes) | **X** | **X** | | +| Ver todos os integrantes e equipes da organização | **X** | **X** | | +| @mencionar qualquer equipe visível | **X** | **X** | | +| Poder se tornar um *mantenedor de equipe* | **X** | **X** | | +| Visualizar as informações da organização (consulte "[Visualizar informações da organização](/articles/viewing-insights-for-your-organization)" para detalhes) | **X** | **X** | | +| Visualizar e publicar discussões de equipe públicas para **todas as equipes** (consulte "[Sobre discussões de equipe](/articles/about-team-discussions)" para detalhes) | **X** | **X** | | +| Visualizar e publicar discussões de equipe privadas para **todas as equipes** (consulte "[Sobre discussões de equipe](/articles/about-team-discussions)" para detalhes) | **X** | | | +| Editar e excluir discussões de equipe em **todas as equipes** (consulte "[Gerenciar comentários conflituosos](/articles/managing-disruptive-comments)" para detalhes) | **X** | | | +| Ocultar comentários em commits, pull requests e problemas (consulte "[Gerenciar comentários conflituosos](/articles/managing-disruptive-comments/#hiding-a-comment)" para detalhes) | **X** | **X** | | +| Desabilitar discussões de equipe na organização (consulte "[Desabilitar discussões de equipe em sua organização](/articles/disabling-team-discussions-for-your-organization)" para detalhes) | **X** | | |{% if currentVersion == "free-pro-team@latest" %} +| Gerenciar a visualização de informações de dependência da organização (consulte "[Alterar a visibilidade das informações de dependência da organização](/articles/changing-the-visibility-of-your-organizations-dependency-insights)" para detalhes) | **X** | | |{% endif %} +| Definir uma foto de perfil da equipe para **todas as equipes** (consulte "[Definir uma foto de perfil de sua equipe](/articles/setting-your-team-s-profile-picture)" para detalhes) | **X** | | | +| Desabilitar a publicação de sites do {% data variables.product.prodname_pages %} em repositórios na organização (consulte "[Desabilitar a publicação de sites de {% data variables.product.prodname_pages %} para a sua organização](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)" para obter informações) | **X** | | | +| Gerenciar as configurações de segurança e análise (consulte "[Gerenciar as configurações de segurança e análise para a sua organização](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization)" para obter mais informações) | **X** | | | +| Habilitar e executar [logon único SAML](/articles/about-identity-and-access-management-with-saml-single-sign-on) | **X** | | | +| [Gerenciar o acesso de SAML de um usuário à sua organização](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization) | **X** | | | +| Gerenciar uma autoridade certificada de SSH da organização (consulte "[Gerenciar a autoridade certificada de SSH da organização](/articles/managing-your-organizations-ssh-certificate-authorities)" para detalhes) | **X** | | | +| Transferir repósitórios | **X** | | | +| Comprar, instalar, gerenciar cobranças e cancelar aplicativos do {% data variables.product.prodname_marketplace %} | **X** | | | +| Listar aplicativos no {% data variables.product.prodname_marketplace %} | **X** | | | +| Recebe [{% data variables.product.prodname_dependabot_alerts %} sobre dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) para todos os repositórios de uma organização | **X** | | | +| Gerenciar {% data variables.product.prodname_dependabot_security_updates %} (consulte "[Configurar {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)") | **X** | | | +| [Gerenciar a política de bifurcação](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization) | **X** | | | +| [Limitar a atividade em repositórios públicos na organização](/articles/limiting-interactions-in-your-organization) | **X** | | | +| Fazer pull (ler), fazer push (gravar) e clonar (copiar) *todos os repositórios* na organização | **X** | | | +| Converter integrantes da organização em [colaboradores externos](#outside-collaborators) | **X** | | | +| [Exibir as pessoas com acesso a um repositório da organização](/articles/viewing-people-with-access-to-your-repository) | **X** | | | +| [Exportar uma lista das pessoas com acesso a um repositório da organização](/articles/viewing-people-with-access-to-your-repository/#exporting-a-list-of-people-with-access-to-your-repository) | **X** | | | +| Gerenciar o nome do branch-padrão (consulte "[Gerenciar o nome do branch-padrão para repositórios na sua organização](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization)") | **X** | | | +| Gerenciar etiquetas padrão (consulte "[Gerenciar etiquetas padrão nos repositórios da organização](/articles/managing-default-labels-for-repositories-in-your-organization)") | **X** | | | +| Habilitar sincronização de equipes (consulte "[Gerenciar sincronização de equipe para a sua organização](/github/setting-up-and-managing-organizations-and-teams/managing-team-synchronization-for-your-organization)" para obter informações) | **X** | | | {% else %} -| Ação da organização | Proprietários | Integrantes | -|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-------------:|:---------------------------------------:| -| Convidar pessoas para integrar a organização | **X** | | -| Editar e cancelar convites para integrar a organização | **X** | | -| Remover integrantes da organização | **X** | | | -| Restabelecer ex-integrantes da organização | **X** | | | -| Adicionar e remover pessoas de **todas as equipes** | **X** | | -| Promover integrantes da organização a *mantenedor de equipe* | **X** | |{% if currentVersion ver_gt "enterprise-server@2.19" %} -| Configurar as atribuições de revisão de código (consulte "[Gerenciar a atribuição de revisão de código para a sua equipe](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)") | **X** | |{% endif %} -| Adicionar colaboradores em **todos os repositórios** | **X** | | -| Acessar o log de auditoria da organização | **X** | | -| Editar a página de perfil da organização (consulte "[Sobre o perfil da sua organização](/articles/about-your-organization-s-profile)" para detalhes) | **X** | | | -| Excluir **todas as equipes** | **X** | | -| Excluir a conta da organização, inclusive todos os repositórios | **X** | | -| Criar equipes (consulte "[Configurar permissões de criação de equipes na organização](/articles/setting-team-creation-permissions-in-your-organization)" para detalhes) | **X** | **X** | -| Ver todos os integrantes e equipes da organização | **X** | **X** | -| @mencionar qualquer equipe visível | **X** | **X** | -| Poder se tornar um *mantenedor de equipe* | **X** | **X** | -| Transferir repósitórios | **X** | |{% if currentVersion ver_gt "enterprise-server@2.18" %} -| Gerenciar uma autoridade certificada de SSH da organização (consulte "[Gerenciar a autoridade certificada de SSH da organização](/articles/managing-your-organizations-ssh-certificate-authorities)" para detalhes) | **X** | |{% endif %} -| Criar quadros de projetos (consulte "[Permissões de quadro de projeto para uma organização](/articles/project-board-permissions-for-an-organization)" para detalhes) | **X** | **X** | | -| Visualizar e publicar discussões de equipe públicas para **todas as equipes** (consulte "[Sobre discussões de equipe](/articles/about-team-discussions)" para detalhes) | **X** | **X** | | -| Visualizar e publicar discussões de equipe privadas para **todas as equipes** (consulte "[Sobre discussões de equipe](/articles/about-team-discussions)" para detalhes) | **X** | | | -| Editar e excluir discussões de equipe em **todas as equipes** (para obter mais informações, consulte "[Gerenciar comentários conflituosos](/articles/managing-disruptive-comments) | **X** | | | -| Ocultar comentários em commits, pull requests e problemas (consulte "[Gerenciar comentários conflituosos](/articles/managing-disruptive-comments/#hiding-a-comment)" para detalhes) | **X** | **X** | **X** | -| Desabilitar discussões de equipe na organização (consulte "[Desabilitar discussões de equipe em sua organização](/articles/disabling-team-discussions-for-your-organization)" para detalhes) | **X** | | | -| Definir uma foto de perfil da equipe para **todas as equipes** (consulte "[Definir uma foto de perfil de sua equipe](/articles/setting-your-team-s-profile-picture)" para detalhes) | **X** | | |{% if currentVersion ver_gt "enterprise-server@2.22" %} -| Desabilitar a publicação de sites do {% data variables.product.prodname_pages %} em repositórios na organização (consulte "[Desabilitar a publicação de sites de {% data variables.product.prodname_pages %} para a sua organização](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)" para obter informações) | **X** | | |{% endif %} -| [Mover equipes na hierarquia da organização](/articles/moving-a-team-in-your-organization-s-hierarchy) | **X** | | | -| Fazer pull (ler), fazer push (gravar) e clonar (copiar) *todos os repositórios* na organização | **X** | | -| Converter integrantes da organização em [colaboradores externos](#outside-collaborators) | **X** | | -| [Exibir as pessoas com acesso a um repositório da organização](/articles/viewing-people-with-access-to-your-repository) | **X** | | -| [Exportar uma lista das pessoas com acesso a um repositório da organização](/articles/viewing-people-with-access-to-your-repository/#exporting-a-list-of-people-with-access-to-your-repository) | **X** | |{% if currentVersion ver_gt "enterprise-server@2.19" %} -| Gerenciar etiquetas padrão (consulte "[Gerenciar etiquetas padrão nos repositórios da organização](/articles/managing-default-labels-for-repositories-in-your-organization)") | **X** | |{% endif %} +| Ação da organização | Proprietários | Integrantes | +|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-------------:|:-----------------------------------------------------------:| +| Convidar pessoas para integrar a organização | **X** | | +| Editar e cancelar convites para integrar a organização | **X** | | +| Remover integrantes da organização | **X** | | | +| Restabelecer ex-integrantes da organização | **X** | | | +| Adicionar e remover pessoas de **todas as equipes** | **X** | | +| Promover integrantes da organização a *mantenedor de equipe* | **X** | |{% if currentVersion ver_gt "enterprise-server@2.19" %} +| Configurar as atribuições de revisão de código (consulte "[Gerenciar a atribuição de revisão de código para a sua equipe](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)") | **X** | |{% endif %} +| Adicionar colaboradores em **todos os repositórios** | **X** | | +| Acessar o log de auditoria da organização | **X** | | +| Editar a página de perfil da organização (consulte "[Sobre o perfil da sua organização](/articles/about-your-organization-s-profile)" para detalhes) | **X** | | | +| Excluir **todas as equipes** | **X** | | +| Excluir a conta da organização, inclusive todos os repositórios | **X** | | +| Criar equipes (consulte "[Configurar permissões de criação de equipes na organização](/articles/setting-team-creation-permissions-in-your-organization)" para detalhes) | **X** | **X** | +| Ver todos os integrantes e equipes da organização | **X** | **X** | +| @mencionar qualquer equipe visível | **X** | **X** | +| Poder se tornar um *mantenedor de equipe* | **X** | **X** | +| Transferir repósitórios | **X** | | +| Gerenciar uma autoridade certificada de SSH da organização (consulte "[Gerenciar a autoridade certificada de SSH da organização](/articles/managing-your-organizations-ssh-certificate-authorities)" para detalhes) | **X** | | +| Criar quadros de projetos (consulte "[Permissões de quadro de projeto para uma organização](/articles/project-board-permissions-for-an-organization)" para detalhes) | **X** | **X** | | +| Visualizar e publicar discussões de equipe públicas para **todas as equipes** (consulte "[Sobre discussões de equipe](/articles/about-team-discussions)" para detalhes) | **X** | **X** | | +| Visualizar e publicar discussões de equipe privadas para **todas as equipes** (consulte "[Sobre discussões de equipe](/articles/about-team-discussions)" para detalhes) | **X** | | | +| Editar e excluir discussões de equipe em **todas as equipes** (para obter mais informações, consulte "[Gerenciar comentários conflituosos](/articles/managing-disruptive-comments) | **X** | | | +| Ocultar comentários em commits, pull requests e problemas (consulte "[Gerenciar comentários conflituosos](/articles/managing-disruptive-comments/#hiding-a-comment)" para detalhes) | **X** | **X** | **X** | +| Desabilitar discussões de equipe na organização (consulte "[Desabilitar discussões de equipe em sua organização](/articles/disabling-team-discussions-for-your-organization)" para detalhes) | **X** | | | +| Definir uma foto de perfil da equipe para **todas as equipes** (consulte "[Definir uma foto de perfil de sua equipe](/articles/setting-your-team-s-profile-picture)" para detalhes) | **X** | | |{% if currentVersion ver_gt "enterprise-server@2.22" %} +| Desabilitar a publicação de sites do {% data variables.product.prodname_pages %} em repositórios na organização (consulte "[Desabilitar a publicação de sites de {% data variables.product.prodname_pages %} para a sua organização](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)" para obter informações) | **X** | | |{% endif %} +| [Mover equipes na hierarquia da organização](/articles/moving-a-team-in-your-organization-s-hierarchy) | **X** | | | +| Fazer pull (ler), fazer push (gravar) e clonar (copiar) *todos os repositórios* na organização | **X** | | +| Converter integrantes da organização em [colaboradores externos](#outside-collaborators) | **X** | | +| [Exibir as pessoas com acesso a um repositório da organização](/articles/viewing-people-with-access-to-your-repository) | **X** | | +| [Exportar uma lista das pessoas com acesso a um repositório da organização](/articles/viewing-people-with-access-to-your-repository/#exporting-a-list-of-people-with-access-to-your-repository) | **X** | |{% if currentVersion ver_gt "enterprise-server@2.19" %} +| Gerenciar etiquetas padrão (consulte "[Gerenciar etiquetas padrão nos repositórios da organização](/articles/managing-default-labels-for-repositories-in-your-organization)") | **X** | |{% endif %} {% endif %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-require-two-factor-authentication-in-your-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-require-two-factor-authentication-in-your-organization.md index b0f37dc4cbd5..c8be742eba0c 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-require-two-factor-authentication-in-your-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-require-two-factor-authentication-in-your-organization.md @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -Recomendamos que você notifique os {% if currentVersion == "free-pro-team@latest" %}integrantes, colaboradores externos e gerentes de cobrança da organização{% else %}integrantes e colaboradores externos da organização{% endif %} no mínimo uma semana antes de você exigir a 2FA na organização. +Recomendamos que você notifique {% if currentVersion == "free-pro-team@latest" %}os integrantes da organização, colaboradores externos e os gerentes de cobrança{% else %}integrantes da organização e colaboradores externos{% endif %} a pelo menos uma semana antes de exigir 2FA na sua organização. Se você exigir o uso da autenticação de dois fatores na organização, os integrantes, colaboradores externos e gerentes de cobrança (inclusive contas bots) que não usam 2FA serão removidos da organização e perderão acesso aos repositórios dela. Eles também perderão acesso às bifurcações dos repositórios privados da organização. diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-member-of-your-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-member-of-your-organization.md index 1a79727e7104..70ae57f4ff19 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-member-of-your-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-member-of-your-organization.md @@ -1,6 +1,6 @@ --- title: Restabelecer ex-integrantes da organização -intro: 'Os proprietários da organização podem {% if currentVersion == "free-pro-team@latest" %}convidar ex-integrantes da organização a voltar a juntar-se{% else %}e adicinar ex-integrantes {% endif%} à sua organização e escolher se deseja restaurar a função anterior, as permissões de acesso, as bifurcações e as configurações dessa pessoa.' +intro: 'Os proprietários da organização podem {% if currentVersion == "free-pro-team@latest" %}convidar os antigos integrantes da organização para juntar-se novamente a{% else %}adicionar ex-integrantes à{% endif%} sua organização e escolher se desejam restaurar as funções anteriores da pessoa, acessar as permissões, bifurcações e configurações.' redirect_from: - /articles/reinstating-a-former-member-of-your-organization versions: @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -Se você [remover um usuário da organização](/articles/removing-a-member-from-your-organization), [converter um integrante da organização em um colaborador externo](/articles/converting-an-organization-member-to-an-outside-collaborator), ou se um usuário for removido da organização porque você [exigiu que os integrantes e colaboradores externos habilitassem a autenticação de dois fatores (2FA)](/articles/requiring-two-factor-authentication-in-your-organization), as configurações e os privilégios de acesso do usuário serão mantidos por três meses. Você poderá restaurar os privilégios do usuário se {% if currentVersion =="free-pro-team@latest" %}convidá-lo{% else %}adicioná-lo{% endif %} novamente na organização durante esse período. +Se você [remover um usuário da organização](/articles/removing-a-member-from-your-organization), [converter um integrante da organização em um colaborador externo](/articles/converting-an-organization-member-to-an-outside-collaborator), ou se um usuário for removido da organização porque você [exigiu que os integrantes e colaboradores externos habilitassem a autenticação de dois fatores (2FA)](/articles/requiring-two-factor-authentication-in-your-organization), as configurações e os privilégios de acesso do usuário serão mantidos por três meses. Você pode restaurar os privilégios do usuário se você {% if currentVersion =="free-pro-team@latest" %}convidá-los{% else %}adicioná-los{% endif %} à organização nesse período de tempo. {% data reusables.two_fa.send-invite-to-reinstate-user-before-2fa-is-enabled %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-outside-collaborators-access-to-your-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-outside-collaborators-access-to-your-organization.md index cc8630688a7c..90f63f350be0 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-outside-collaborators-access-to-your-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-outside-collaborators-access-to-your-organization.md @@ -1,6 +1,6 @@ --- -title: Restabelecer o acesso de um ex-colaborador externo à organização -intro: 'Se você exigiu a autenticação de dois fatores na organização e um colaborador externo foi removido da organização por não ter a 2FA habilitada, poderá restabelecer as permissões de acesso do ex-colaborador externo nas configurações, nas bifurcações e nos repositórios da organização.' +title: Reinstating a former outside collaborator's access to your organization +intro: 'If you required two-factor authentication in your organization and an outside collaborator was removed from the organization for not having 2FA enabled, you can reinstate a former outside collaborator''s access permissions for organization repositories, forks, and settings.' redirect_from: - /articles/reinstating-a-former-outside-collaborator-s-access-to-your-organization - /articles/reinstating-a-former-outside-collaborators-access-to-your-organization @@ -9,25 +9,25 @@ versions: enterprise-server: '*' --- -Se o acesso de um colaborador externo aos repositórios privados da organização foi removido porque você passou a [exigir a autenticação de dois fatores para integrantes e colaboradores externos](/articles/requiring-two-factor-authentication-in-your-organization), as configurações e os privilégios de acesso do usuário serão mantidos por três meses. Você poderá restaurar os privilégios do usuário se {% if currentVersion == "free-pro-team@latest" %}convidá-lo{% else %}adicioná-lo{% endif %} novamente na organização durante esse período. +If an outside collaborator's access to your organization's private repositories is removed because you've [required members and outside collaborators to enable two-factor authentication](/articles/requiring-two-factor-authentication-in-your-organization), the user's access privileges and settings are saved for three months. You can restore the user's privileges if you {% if currentVersion == "free-pro-team@latest" %}invite{% else %}add{% endif %} them back to the organization within that time frame. {% data reusables.two_fa.send-invite-to-reinstate-user-before-2fa-is-enabled %} -Ao restabelecer um ex-colaborador externo, você pode restaurar: - - O acesso anterior do usuário aos repositórios da organização - - As bifurcações privadas de repositórios de propriedade da organização - - A associação nas equipes da organização - - Os acessos e permissões anteriores nos repositórios da organização - - As estrelas dos repositórios da organização - - As atribuições de problemas na organização - - As assinaturas do repositório (configurações de notificação para inspecionar, não inspecionar ou ignorar as atividades de um repositório) +When you reinstate a former outside collaborator, you can restore: + - The user's former access to organization repositories + - Any private forks of repositories owned by the organization + - Membership in the organization's teams + - Previous access and permissions for the organization's repositories + - Stars for organization repositories + - Issue assignments in the organization + - Repository subscriptions (notification settings for watching, not watching, or ignoring a repository's activity) {% tip %} -**Dicas**: - - Somente proprietários da organização podem restabelecer o acesso de um colaborador externo à organização. Para obter mais informações, consulte "[Níveis de permissão para uma organização](/articles/permission-levels-for-an-organization)". - - O fluxo de restabelecimento de um integrante no {% data variables.product.product_location %} pode usar o termo "integrante" para descrever o restabelecimento de um colaborador externo, mas se você restabelecer o usuário e mantiver os privilégios anteriores, ele terá apenas as [permissões anteriores de colaborador externo](/articles/permission-levels-for-an-organization/#outside-collaborators).{% if currentVersion == "free-pro-team@latest" %} - - Se a organização tiver uma assinatura paga por usuário, ela deverá ter uma licença não utilizada disponível para você poder convidar um integrante para participar da organização ou restabelecer um ex-integrante da organização. Para obter mais informações, consulte "[Sobre preços por usuário](/articles/about-per-user-pricing)."{% endif %} +**Tips**: + - Only organization owners can reinstate outside collaborators' access to an organization. For more information, see "[Permission levels for an organization](/articles/permission-levels-for-an-organization)." + - The reinstating a member flow on {% data variables.product.product_location %} may use the term "member" to describe reinstating an outside collaborator but if you reinstate this person and keep their previous privileges, they will only have their previous [outside collaborator permissions](/articles/permission-levels-for-an-organization/#outside-collaborators).{% if currentVersion == "free-pro-team@latest" %} + - If your organization has a paid per-user subscription, an unused license must be available before you can invite a new member to join the organization or reinstate a former organization member. For more information, see "[About per-user pricing](/articles/about-per-user-pricing)."{% endif %} {% endtip %} @@ -37,35 +37,37 @@ Ao restabelecer um ex-colaborador externo, você pode restaurar: {% data reusables.organizations.invite_member_from_people_tab %} {% data reusables.organizations.reinstate-user-type-username %} {% if currentVersion == "free-pro-team@latest" %} -6. Escolha restaurar os privilégios anteriores do colaborador externo na organização clicando em **Invite and reinstate** (Convidar e restabelecer) ou escolha apagar os privilégios anteriores e definir novas permissões de acesso clicando em **Invite and start fresh** (Convidar e começar do zero). +6. Choose to restore the outside collaborator's previous privileges in the organization by clicking **Invite and reinstate** or choose to clear their previous privileges and set new access permissions by clicking **Invite and start fresh**. {% warning %} - **Aviso:** se quiser converter um colaborador externo em um integrante da organização, selecione **Invite and start fresh** (Convidar e começar do zero) e escolha uma nova função para a pessoa. Mas se você optar por começar do zero, as bifurcações privadas de repositórios da organização desse usuário serão perdidas. Para converter o ex-colaborador externo em um integrante da organização *e* manter as bifurcações privadas dele, selecione **Invite and reinstate** (Convidar e restabelecer). Quando a pessoa aceitar o convite, você poderá fazer a conversão [convidando a pessoa para participar da organização como um integrante](/articles/converting-an-outside-collaborator-to-an-organization-member). + **Warning:** If you want to upgrade the outside collaborator to a member of your organization, then choose **Invite and start fresh** and choose a new role for this person. Note, however, that this person's private forks of your organization's repositories will be lost if you choose to start fresh. To make the former outside collaborator a member of your organization *and* keep their private forks, choose **Invite and reinstate** instead. Once this person accepts the invitation, you can convert them to an organization member by [inviting them to join the organization as a member](/articles/converting-an-outside-collaborator-to-an-organization-member). {% endwarning %} - ![Escolher se deseja restaurar as configurações](/assets/images/help/organizations/choose_whether_to_restore_org_member_info.png) + ![Choose to restore settings or not](/assets/images/help/organizations/choose_whether_to_restore_org_member_info.png) {% else %} -6. Escolha restaurar os privilégios anteriores do colaborador externo na organização clicando em **Add and reinstate** (Adicionar e restabelecer) ou escolha apagar os privilégios anteriores e definir novas permissões de acesso clicando em **Add and start fresh** (Adicionar e começar do zero). +6. Choose to restore the outside collaborator's previous privileges in the organization by clicking **Add and reinstate** or choose to clear their previous privileges and set new access permissions by clicking **Add and start fresh**. {% warning %} - **Aviso:** se quiser converter um colaborador externo em um integrante da organização, selecione **Add and start fresh** (Adicionar e começar do zero) e escolha uma nova função para a pessoa. Mas se você optar por começar do zero, as bifurcações privadas de repositórios da organização desse usuário serão perdidas. Para converter o ex-colaborador externo em um integrante da organização *e* manter as bifurcações privadas dele, selecione **Add and reinstate** (Adicionar e restabelecer). Em seguida, converta-o em integrante da organização [adicionando ele à organização como um integrante](/articles/converting-an-outside-collaborator-to-an-organization-member). + **Warning:** If you want to upgrade the outside collaborator to a member of your organization, then choose **Add and start fresh** and choose a new role for this person. Note, however, that this person's private forks of your organization's repositories will be lost if you choose to start fresh. To make the former outside collaborator a member of your organization *and* keep their private forks, choose **Add and reinstate** instead. Then, you can convert them to an organization member by [adding them to the organization as a member](/articles/converting-an-outside-collaborator-to-an-organization-member). {% endwarning %} - ![Escolher se deseja restaurar as configurações](/assets/images/help/organizations/choose_whether_to_restore_org_member_info_ghe.png) + ![Choose to restore settings or not](/assets/images/help/organizations/choose_whether_to_restore_org_member_info_ghe.png) {% endif %} {% if currentVersion == "free-pro-team@latest" %} -7. Se você apagou os privilégios anteriores de um ex-colaborador externo, escolha uma função para o usuário e adicione-o em algumas equipes (opcional), depois clique em **Send invitation** (Enviar convite). ![Opções Role and team (Função e equipe) e botão send invitation (enviar convite)](/assets/images/help/organizations/add-role-send-invitation.png) +7. If you cleared the previous privileges for a former outside collaborator, choose a role for the user and optionally add them to some teams, then click **Send invitation**. + ![Role and team options and send invitation button](/assets/images/help/organizations/add-role-send-invitation.png) {% else %} -7. Se você apagou os privilégios anteriores de um ex-colaborador externo, escolha uma função para o usuário e adicione-o em algumas equipes (opcional), depois clique em **Add member** (Adicionar integrante). ![Opções Role and team (Função e equipe) e botão add member (adicionar integrante)](/assets/images/help/organizations/add-role-add-member.png) +7. If you cleared the previous privileges for a former outside collaborator, choose a role for the user and optionally add them to some teams, then click **Add member**. + ![Role and team options and add member button](/assets/images/help/organizations/add-role-add-member.png) {% endif %} {% if currentVersion == "free-pro-team@latest" %} -8. A pessoa convidada receberá um e-mail com um convite para participar da organização. Ela precisará aceitar o convite antes de se tornar um colaborador externo na organização. {% data reusables.organizations.cancel_org_invite %} +8. The invited person will receive an email inviting them to the organization. They will need to accept the invitation before becoming an outside collaborator in the organization. {% data reusables.organizations.cancel_org_invite %} {% endif %} -### Leia mais +### Further Reading -- "[Níveis de permissão do repositório para uma organização](/articles/repository-permission-levels-for-an-organization)" +- "[Repository permission levels for an organization](/articles/repository-permission-levels-for-an-organization)" diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md index 541b22e0aa62..dcf925aa3870 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md @@ -24,7 +24,9 @@ Para obter mais informações sobre as permissões de gerente do {% data variabl {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.github-apps-settings-sidebar %} -1. Em "{% data variables.product.prodname_github_app %}s", clique no avatar do app no qual deseja remover um gerente do {% data variables.product.prodname_github_app %}. ![Selecione {% data variables.product.prodname_github_app %}](/assets/images/help/organizations/select-github-app.png) +1. Em " +{% data variables.product.prodname_github_app %}s", clique no avatar do aplicativo do qual deseja remover um gerente de {% data variables.product.prodname_github_app %}. +![Selecione {% data variables.product.prodname_github_app %}](/assets/images/help/organizations/select-github-app.png) {% data reusables.organizations.app-managers-settings-sidebar %} 1. Em "App managers" (Gerentes do app), encontre o nome de usuário da pessoa da qual deseja remover as permissões de gerente do {% data variables.product.prodname_github_app %} e clique em **Revoke** (Revogar). ![Revogue as permissões de gerente do {% data variables.product.prodname_github_app %}](/assets/images/help/organizations/github-app-manager-revoke-permissions-individual-app.png) diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/removing-organization-members-from-a-team.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/removing-organization-members-from-a-team.md index ea6c0d162256..1ce11302a974 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/removing-organization-members-from-a-team.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/removing-organization-members-from-a-team.md @@ -1,6 +1,6 @@ --- title: Remover integrantes da organização de uma equipe -intro: Os usuários com permissões de *proprietário* ou *mantenedor de equipe* podem remover integrantes de uma equipe. Isso pode ser necessário se um usuário não precisar mais acessar um repositório ao qual a equipe tem acesso ou se um usuário deixar de participar dos projetos de uma equipe. +intro: 'Os usuários com permissões de *proprietário* ou *mantenedor de equipe* podem remover integrantes de uma equipe. Isso pode ser necessário se um usuário não precisar mais acessar um repositório ao qual a equipe tem acesso ou se um usuário deixar de participar dos projetos de uma equipe.' redirect_from: - /articles/removing-organization-members-from-a-team-early-access-program/ - /articles/removing-organization-members-from-a-team diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/renaming-an-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/renaming-an-organization.md index 93d9c52ceef4..849d2a5e3b9e 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/renaming-an-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/renaming-an-organization.md @@ -28,7 +28,7 @@ Depois que você altera o nome da organização, o nome antigo da organização #### Alterações que não são automáticas Depois de alterar o nome da organização: -- Os links para a página de perfil da organização anterior, como `https://{% data variables.command_line.backticks %}/previousorgname`, retornarão um erro 404. Recomendamos que você atualize os links para a organização de outros sites{% if currentVersion == "free-pro-team@latest" %}, como os perfis do LinkedIn ou do Twitter{% endif %}. +- Os links para a página de perfil da organização anterior, como `https://{% data variables.command_line.backticks %}/previousorgname`, retornarão um erro 404. Recomendamos que você atualize os links para a sua organização a partir de outros sites{% if currentVersion == "free-pro-team@latest" %}, como, por exemplo, os seus perfis do LinkedIn ou do Twitter{% endif %}. - As solicitações de API que usam o nome antigo da organização retornarão um erro 404. Recomendamos que você atualize o nome da organização nas solicitações de API. - Não há nenhum redirecionamento automático da [@menção](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams) para equipes que usam o nome antigo da organização. diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md index b89d4ae3f5f1..0a56857b54ba 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md @@ -16,10 +16,10 @@ Usuários com permissões de administrador podem gerenciar acessos individuais e Você pode atribuir diferentes níveis de acesso aos repositórios de propriedade de uma organização a integrantes, colaboradores externos e equipes da organização. Cada nível de permissão aumenta progressivamente o acesso ao conteúdo e às configurações de um repositório. Escolha o nível mais adequado para a função de cada pessoa ou equipe do projeto, sem dar aos usuários um acesso mais abrangente do que o necessário. Do acesso mais restritivo ao acesso mais abrangente, estes são os níveis de permissão de um repositório da organização: -- **Read** (Leitura): recomendado para contribuidores que não escrevem códigos e desejam visualizar ou discutir o projeto{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -- **Triage** (Triagem): recomendado para contribuidores que precisam gerenciar proativamente problemas e pull requests sem acesso de gravação{% endif %} -- **Write** (Gravação): recomendado para contribuidores que proativamente fazem push no projeto{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -- **Maintain** (Manutenção): recomendado para gerentes de projeto que precisam gerenciar o repositório, mas não devem ter acesso a ações destrutivas ou confidenciais{% endif %} +- **Read** (Leitura): recomendado para contribuidores que não escrevem códigos e desejam visualizar ou discutir o projeto +- **Triage** (Triagem): recomendado para contribuidores que precisam gerenciar proativamente problemas e pull requests sem acesso de gravação +- **Write** (Gravação): recomendado para contribuidores que proativamente fazem push no projeto +- **Maintain** (Manutenção): recomendado para gerentes de projeto que precisam gerenciar o repositório, mas não devem ter acesso a ações destrutivas ou confidenciais - **Admin** (Administrador): recomendado para usuários que precisam ter acesso completo ao projeto, incluindo ações confidenciais e destrutivas, como gerenciar a segurança e excluir um repositório {% if currentVersion == "free-pro-team@latest" %} @@ -41,135 +41,75 @@ Além de gerenciar as configurações da organização, os proprietários da org {% endwarning %} ### Acesso ao repositório de cada nível de permissão -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -| Ação no repositório | Leitura | Triagem | Gravação | Manutenção | Administrador | -|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-------:|:-------:|:--------:|:----------:|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------:| -| Fazer pull nos repositórios atribuídos ao usuário ou à equipe | **X** | **X** | **X** | **X** | **X** | -| Bifurcar os repositórios atribuídos ao usuário ou à equipe | **X** | **X** | **X** | **X** | **X** | -| Editar e excluir seus próprios comentários | **X** | **X** | **X** | **X** | **X** | -| Criar problemas | **X** | **X** | **X** | **X** | **X** | -| Fechar os problemas que eles criaram | **X** | **X** | **X** | **X** | **X** | -| Reabrir problemas que eles fecharam | **X** | **X** | **X** | **X** | **X** | -| Ter um problema atribuído a eles | **X** | **X** | **X** | **X** | **X** | -| Enviar pull requests de bifurcações dos repositórios atribuídos à equipe | **X** | **X** | **X** | **X** | **X** | -| Enviar revisões em pull requests | **X** | **X** | **X** | **X** | **X** | -| Exibir as versões publicadas | **X** | **X** | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| Visualizar [execuções de fluxo de trabalho no GitHub Actions](/actions/automating-your-workflow-with-github-actions/managing-a-workflow-run) | **X** | **X** | **X** | **X** | **X** |{% endif %} -| Editar wikis | **X** | **X** | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [Denunciar conteúdo abusivo ou spam](/articles/reporting-abuse-or-spam) | **X** | **X** | **X** | **X** | **X** |{% endif %} -| Aplicar etiquetas | | **X** | **X** | **X** | **X** | -| Fechar, reabrir e atribuir todos os problemas e pull requests | | **X** | **X** | **X** | **X** | -| Aplicar marcos | | **X** | **X** | **X** | **X** | -| Marcar [problemas e pull requests duplicados](/articles/about-duplicate-issues-and-pull-requests) | | **X** | **X** | **X** | **X** | -| Solicitar [revisões de pull requests](/articles/requesting-a-pull-request-review) | | **X** | **X** | **X** | **X** | -| Fazer push (gravar) nos repositórios atribuídos ao usuário ou à equipe | | | **X** | **X** | **X** | -| Editar e excluir comentários de qualquer usuário em commits, pull request e problemas | | | **X** | **X** | **X** | -| [Ocultar comentários de qualquer usuário](/articles/managing-disruptive-comments) | | | **X** | **X** | **X** | -| [Bloquear conversas](/articles/locking-conversations) | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| Transferir problemas (consulte "[Transferir um problema para outro repositório](/articles/transferring-an-issue-to-another-repository)" para obter mais informações) | | | **X** | **X** | **X** |{% endif %} -| [Atuar como um proprietário do código designado de um repositório](/articles/about-code-owners) | | | **X** | **X** | **X** | -| [Marcar uma pull request de rascunho como pronta para revisão](/articles/changing-the-stage-of-a-pull-request) | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -| [Converter um pull request em rascunho](/articles/changing-the-stage-of-a-pull-request) | | | **X** | **X** | **X** |{% endif %} -| Enviar revisões que afetam a capacidade de merge de uma pull request | | | **X** | **X** | **X** | -| [Aplicar alterações sugeridas](/articles/incorporating-feedback-in-your-pull-request) a pull requests | | | **X** | **X** | **X** | -| Criar [verificações de status](/articles/about-status-checks) | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| Criar, editar, executar, reexecutar e cancelar [fluxos de trabalho no GitHub Actions](/actions/automating-your-workflow-with-github-actions/) | | | **X** | **X** | **X** |{% endif %} -| Criar e editar versões | | | **X** | **X** | **X** | -| Exibir versões de rascunho | | | **X** | **X** | **X** | -| Editar a descrição de um repositório | | | | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [Visualizar e instalar pacotes](/packages/publishing-and-managing-packages) | **X** | **X** | **X** | **X** | **X** | -| [Publicar pacotes](/packages/publishing-and-managing-packages/publishing-a-package) | | | **X** | **X** | **X** | -| [Excluir pacotes](/packages/publishing-and-managing-packages/deleting-a-package) | | | | | **X** |{% endif %} -| Gerenciar [tópicos](/articles/classifying-your-repository-with-topics) | | | | **X** | **X** | -| Habilitar wikis e restringir editores de wiki | | | | **X** | **X** | -| Habilitar quadros de projeto | | | | **X** | **X** | -| Configurar [merges de pull request](/articles/configuring-pull-request-merges) | | | | **X** | **X** | -| Configurar [uma fonte de publicação para {% data variables.product.prodname_pages %}](/articles/configuring-a-publishing-source-for-github-pages) | | | | **X** | **X** | -| [Fazer push em branches protegidos](/articles/about-protected-branches) | | | | **X** | **X** | -| [Criar e editar cartões sociais do repositório](/articles/customizing-your-repositorys-social-media-preview) | | | | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| Limitar [interações em um repositório](/github/building-a-strong-community/limiting-interactions-in-your-repository) | | | | **X** | **X** |{% endif %} -| Excluir um problema (consulte "[Excluir um problema](/articles/deleting-an-issue)") | | | | | **X** | -| Fazer merge de pull requests em branches protegidos, mesmo sem revisões de aprovação | | | | | **X** | -| [Definir os proprietários do código de um repositório](/articles/about-code-owners) | | | | | **X** | -| Adicionar um repositório a uma equipe (consulte "[Gerenciar o acesso da equipe ao repositório de uma organização](/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository#giving-a-team-access-to-a-repository)" para obter informações) | | | | | **X** | -| [Gerenciar o acesso dos colaboradores externos a um repositório](/articles/adding-outside-collaborators-to-repositories-in-your-organization) | | | | | **X** | -| [Alterar a visibilidade de um repositório](/articles/restricting-repository-visibility-changes-in-your-organization) | | | | | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| Criar um modelo de repositório (consulte "[Criar um modelo de repositório](/articles/creating-a-template-repository)") | | | | | **X** |{% endif %} -| Alterar as configurações do repositório | | | | | **X** | -| Gerenciar o acesso de equipe e de colaborador ao repositório | | | | | **X** | -| Editar o branch padrão do repositório | | | | | **X** | -| Gerenciar webhooks e chaves de implantação | | | | | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [Habilitar o gráfico de dependências](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) em um repositório privado | | | | | **X** | -| Receber [{% data variables.product.prodname_dependabot_alerts %} para dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) em um repositório | | | | | **X** | -| [Ignorar {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository) | | | | | **X** | -| [Designar outras pessoas ou equipes para receber {% data variables.product.prodname_dependabot_alerts %}](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository) para as dependências vulneráveis | | | | | **X** | -| [Gerenciar as configurações do uso de dados para seu repositório privado](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository) | | | | | **X**,{% endif %}{% if currentVersion == "free-pro-team@latest" %}├Criar [consultorias de segurança](/github/managing-security-vulnerabilities/about-github-security-advisories) ├├├├├ **X** |{% endif %} -| [Gerenciar a política de bifurcação de um repositório](/github/administering-a-repository/managing-the-forking-policy-for-your-repository) | | | | | **X** | -| [Transferir repositório na organização](/articles/restricting-repository-creation-in-your-organization) | | | | | **X** | -| [Excluir ou transferir repositórios na organização](/articles/setting-permissions-for-deleting-or-transferring-repositories) | | | | | **X** | -| [Arquivar repositórios](/articles/about-archiving-repositories) | | | | | **X** |{% if currentVersion == "free-pro-team@latest" %} -| Exibir um botão de patrocinador (consulte "[Exibir um botão de patrocinador no seu repositório](/articles/displaying-a-sponsor-button-in-your-repository)") | | | | | **X** |{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -| Criar referências de link automático para recursos externos, como JIRA ou Zendesk (consulte "[Configurar links automáticos para apontar para recursos externos](/articles/configuring-autolinks-to-reference-external-resources)") | | | | | **X** |{% endif %} - -{% else %} - -| Ação no repositório | Permissões de leitura | Permissões de gravação | Permissões de administrador | -|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:---------------------:|:----------------------:|:----------------------------------------------------------------------:| -| Fazer pull (ler) nos repositórios atribuídos ao usuário ou à equipe | **X** | **X** | **X** | -| Bifurcar (copiar) os repositórios atribuídos ao usuário ou à equipe | **X** | **X** | **X** | -| Editar e excluir seus próprios comentários em commits, pull request e problemas | **X** | **X** | **X** | -| Criar problemas | **X** | **X** | **X** | -| Fechar os problemas que eles criaram | **X** | **X** | **X** | -| Reabrir problemas que eles fecharam | **X** | **X** | **X** | -| Ter um problema atribuído a eles | **X** | **X** | **X** | -| Enviar pull requests de bifurcações dos repositórios atribuídos à equipe | **X** | **X** | **X** | -| Enviar revisões em pull requests | **X** | **X** | **X** | -| Exibir as versões publicadas | **X** | **X** | **X** | -| Editar wikis | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [Denunciar conteúdo abusivo ou spam](/articles/reporting-abuse-or-spam) | **X** | **X** | **X** |{% endif %} -| Fazer push (gravar) nos repositórios atribuídos ao usuário ou à equipe | | **X** | **X** | -| Editar e excluir comentários de qualquer usuário em commits, pull request e problemas | | **X** | **X** | -| [Ocultar comentários de qualquer usuário](/articles/managing-disruptive-comments) | | **X** | **X** | -| [Bloquear conversas](/articles/locking-conversations) | | **X** | **X** | -| Aplicar etiquetas e marcos | | **X** | **X** | -| Fechar, reabrir e atribuir todos os problemas | | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| Marcar [problemas e pull requests duplicados](/articles/about-duplicate-issues-and-pull-requests) | | **X** | **X** |{% endif %} -| [Atuar como um proprietário do código designado de um repositório](/articles/about-code-owners) | | **X** | **X** | -| [Marcar uma pull request de rascunho como pronta para revisão](/articles/changing-the-stage-of-a-pull-request) | | **X** | **X** | -| Solicitar [revisões de pull requests](/articles/requesting-a-pull-request-review) | | **X** | **X** | -| Enviar revisões que afetam a capacidade de merge de uma pull request | | **X** | **X** | -| Aplicar alterações sugeridas a pull requests (consulte "[Incluir feedback na pull request](/articles/incorporating-feedback-in-your-pull-request)" para obter mais informações) | | **X** | **X** | -| Criar [verificações de status](/articles/about-status-checks) | | **X** | **X** | -| Criar e editar versões | | **X** | **X** | -| Exibir versões de rascunho | | **X** | **X** | -| Excluir um problema (consulte "[Excluir um problema](/articles/deleting-an-issue)") | | | **X** | -| Fazer merge de pull requests em branches protegidos, mesmo sem revisões de aprovação | | | **X** | -| [Definir os proprietários do código de um repositório](/articles/about-code-owners) | | | **X** | -| Editar a descrição de um repositório | | | **X** | -| Gerenciar [tópicos](/articles/classifying-your-repository-with-topics) | | | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| Criar e editar cartões sociais do repositório (consulte "[Personalizar a exibição das redes sociais do repositório](/articles/customizing-your-repositorys-social-media-preview)" para obter mais informações) | | | **X** |{% endif %} -| Adicionar um repositório a uma equipe (consulte "[Gerenciar o acesso da equipe ao repositório de uma organização](/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository#giving-a-team-access-to-a-repository)" para obter informações) | | | **X** | -| Gerenciar o acesso dos colaboradores externos a um repositório (consulte "[Adicionar colaboradores externos a repositórios na sua organização](/articles/adding-outside-collaborators-to-repositories-in-your-organization)" para obter mais informações) | | | **X** |{% if currentVersion == "free-pro-team@latest" %} -| Limitar [interações em um repositório](/github/building-a-strong-community/limiting-interactions-in-your-repository) | | | **X** |{% endif %} -| Alterar a visibilidade de um repositório (consulte "[Restringir alterações da visibilidade do repositório na organização](/articles/restricting-repository-visibility-changes-in-your-organization)" para obter mais informações) | | | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| Criar um modelo de repositório (consulte "[Criar um modelo de repositório](/articles/creating-a-template-repository)") | | | | | **X** |{% endif %} -| Alterar as configurações do repositório | | | **X** | -| Gerenciar o acesso de equipe e de colaborador ao repositório | | | **X** | -| Editar o branch padrão do repositório | | | **X** | -| Gerenciar webhooks e chaves de implantação | | | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [Habilitar o gráfico de dependências](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) em um repositório privado | | | **X** | -| Receber [{% data variables.product.prodname_dependabot_alerts %} para dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) em um repositório | | | **X** | -| [Ignorar {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository) | | | **X** | -| [Designar outras pessoas ou equipes para receber {% data variables.product.prodname_dependabot_alerts %}](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-github-dependabot-alerts) para as dependências vulneráveis | | | **X** | -| [Gerenciar as configurações do uso de dados para seu repositório privado](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository) | | | **X** |{% endif %}{% if currentVersion == "free-pro-team@latest" %} -| Criar [consultorias de segurança](/github/managing-security-vulnerabilities/about-github-security-advisories)") | | | **X** |{% endif %} -| [Gerenciar a política de bifurcação de um repositório](/github/administering-a-repository/managing-the-forking-policy-for-your-repository) | | | **X** | -| Transferir repositórios para a conta da organização (consulte "[Restringir a criação de repositórios na organização](/articles/restricting-repository-creation-in-your-organization)" para obter mais informações) | | | **X** | -| Excluir ou transferir repositórios (consulte "[Configurar permissões para excluir ou transferir repositórios na organização](/articles/setting-permissions-for-deleting-or-transferring-repositories)" para obter mais informações) | | | **X** | -| [Arquivar repositórios](/articles/about-archiving-repositories) | | | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -| Criar referências de link automático para recursos externos, como JIRA ou Zendesk (consulte "[Configurar links automáticos para apontar para recursos externos](/articles/configuring-autolinks-to-reference-external-resources)" | | | | | **X** |{% endif %} -{% endif %} +| Ação no repositório | Leitura | Triagem | Gravação | Manutenção | Administrador | +|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-------:|:-------:|:--------:|:----------:|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:| +| Fazer pull nos repositórios atribuídos ao usuário ou à equipe | **X** | **X** | **X** | **X** | **X** | +| Bifurcar os repositórios atribuídos ao usuário ou à equipe | **X** | **X** | **X** | **X** | **X** | +| Editar e excluir seus próprios comentários | **X** | **X** | **X** | **X** | **X** | +| Criar problemas | **X** | **X** | **X** | **X** | **X** | +| Fechar os problemas que eles criaram | **X** | **X** | **X** | **X** | **X** | +| Reabrir problemas que eles fecharam | **X** | **X** | **X** | **X** | **X** | +| Ter um problema atribuído a eles | **X** | **X** | **X** | **X** | **X** | +| Enviar pull requests de bifurcações dos repositórios atribuídos à equipe | **X** | **X** | **X** | **X** | **X** | +| Enviar revisões em pull requests | **X** | **X** | **X** | **X** | **X** | +| Exibir as versões publicadas | **X** | **X** | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} +| Visualizar [execuções de fluxo de trabalho no GitHub Actions](/actions/automating-your-workflow-with-github-actions/managing-a-workflow-run) | **X** | **X** | **X** | **X** | **X** |{% endif %} +| Editar wikis | **X** | **X** | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} +| [Denunciar conteúdo abusivo ou spam](/articles/reporting-abuse-or-spam) | **X** | **X** | **X** | **X** | **X** |{% endif %} +| Aplicar etiquetas | | **X** | **X** | **X** | **X** | +| Fechar, reabrir e atribuir todos os problemas e pull requests | | **X** | **X** | **X** | **X** | +| Aplicar marcos | | **X** | **X** | **X** | **X** | +| Marcar [problemas e pull requests duplicados](/articles/about-duplicate-issues-and-pull-requests) | | **X** | **X** | **X** | **X** | +| Solicitar [revisões de pull requests](/articles/requesting-a-pull-request-review) | | **X** | **X** | **X** | **X** | +| Fazer push (gravar) nos repositórios atribuídos ao usuário ou à equipe | | | **X** | **X** | **X** | +| Editar e excluir comentários de qualquer usuário em commits, pull request e problemas | | | **X** | **X** | **X** | +| [Ocultar comentários de qualquer usuário](/articles/managing-disruptive-comments) | | | **X** | **X** | **X** | +| [Bloquear conversas](/articles/locking-conversations) | | | **X** | **X** | **X** | +| Transferir problemas (consulte "[Transferir um problema para outro repositório](/articles/transferring-an-issue-to-another-repository)" para obter mais informações) | | | **X** | **X** | **X** | +| [Atuar como um proprietário do código designado de um repositório](/articles/about-code-owners) | | | **X** | **X** | **X** | +| [Marcar uma pull request de rascunho como pronta para revisão](/articles/changing-the-stage-of-a-pull-request) | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +| [Converter um pull request em rascunho](/articles/changing-the-stage-of-a-pull-request) | | | **X** | **X** | **X** |{% endif %} +| Enviar revisões que afetam a capacidade de merge de uma pull request | | | **X** | **X** | **X** | +| [Aplicar alterações sugeridas](/articles/incorporating-feedback-in-your-pull-request) a pull requests | | | **X** | **X** | **X** | +| Criar [verificações de status](/articles/about-status-checks) | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} +| Criar, editar, executar, reexecutar e cancelar [fluxos de trabalho no GitHub Actions](/actions/automating-your-workflow-with-github-actions/) | | | **X** | **X** | **X** |{% endif %} +| Criar e editar versões | | | **X** | **X** | **X** | +| Exibir versões de rascunho | | | **X** | **X** | **X** | +| Editar a descrição de um repositório | | | | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} +| [Visualizar e instalar pacotes](/packages/publishing-and-managing-packages) | **X** | **X** | **X** | **X** | **X** | +| [Publicar pacotes](/packages/publishing-and-managing-packages/publishing-a-package) | | | **X** | **X** | **X** | +| [Excluir pacotes](/packages/publishing-and-managing-packages/deleting-a-package) | | | | | **X** |{% endif %} +| Gerenciar [tópicos](/articles/classifying-your-repository-with-topics) | | | | **X** | **X** | +| Habilitar wikis e restringir editores de wiki | | | | **X** | **X** | +| Habilitar quadros de projeto | | | | **X** | **X** | +| Configurar [merges de pull request](/articles/configuring-pull-request-merges) | | | | **X** | **X** | +| Configurar [uma fonte de publicação para {% data variables.product.prodname_pages %}](/articles/configuring-a-publishing-source-for-github-pages) | | | | **X** | **X** | +| [Fazer push em branches protegidos](/articles/about-protected-branches) | | | | **X** | **X** | +| [Criar e editar cartões sociais do repositório](/articles/customizing-your-repositorys-social-media-preview) | | | | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} +| Limitar [interações em um repositório](/github/building-a-strong-community/limiting-interactions-in-your-repository) | | | | **X** | **X** |{% endif %} +| Excluir um problema (consulte "[Excluir um problema](/articles/deleting-an-issue)") | | | | | **X** | +| Fazer merge de pull requests em branches protegidos, mesmo sem revisões de aprovação | | | | | **X** | +| [Definir os proprietários do código de um repositório](/articles/about-code-owners) | | | | | **X** | +| Adicionar um repositório a uma equipe (consulte "[Gerenciar o acesso da equipe ao repositório de uma organização](/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository#giving-a-team-access-to-a-repository)" para obter informações) | | | | | **X** | +| [Gerenciar o acesso dos colaboradores externos a um repositório](/articles/adding-outside-collaborators-to-repositories-in-your-organization) | | | | | **X** | +| [Alterar a visibilidade de um repositório](/articles/restricting-repository-visibility-changes-in-your-organization) | | | | | **X** | +| Criar um modelo de repositório (consulte "[Criar um modelo de repositório](/articles/creating-a-template-repository)") | | | | | **X** | +| Alterar as configurações do repositório | | | | | **X** | +| Gerenciar o acesso de equipe e de colaborador ao repositório | | | | | **X** | +| Editar o branch padrão do repositório | | | | | **X** | +| Gerenciar webhooks e chaves de implantação | | | | | **X** |{% if currentVersion == "free-pro-team@latest" %} +| [Habilitar o gráfico de dependências](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) em um repositório privado | | | | | **X** | +| Receber [{% data variables.product.prodname_dependabot_alerts %} para dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) em um repositório | | | | | **X** | +| [Ignorar {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository) | | | | | **X** | +| [Designar outras pessoas ou equipes para receber {% data variables.product.prodname_dependabot_alerts %}](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository) para as dependências vulneráveis | | | | | **X** | +| [Gerenciar as configurações do uso de dados para seu repositório privado](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository) | | | | | **X** |{% endif %}{% if currentVersion == "free-pro-team@latest" %}| Crie [consultorias de segurança](/github/managing-security-vulnerabilities/about-github-security-advisories) | | | | | **X** |{% endif %} +| [Gerenciar a política de bifurcação de um repositório](/github/administering-a-repository/managing-the-forking-policy-for-your-repository) | | | | | **X** | +| [Transferir repositório na organização](/articles/restricting-repository-creation-in-your-organization) | | | | | **X** | +| [Excluir ou transferir repositórios na organização](/articles/setting-permissions-for-deleting-or-transferring-repositories) | | | | | **X** | +| [Arquivar repositórios](/articles/about-archiving-repositories) | | | | | **X** |{% if currentVersion == "free-pro-team@latest" %} +| Exibir um botão de patrocinador (consulte "[Exibir um botão de patrocinador no seu repositório](/articles/displaying-a-sponsor-button-in-your-repository)") | | | | | **X** |{% endif %} +| Criar referências de link automático para recursos externos, como JIRA ou Zendesk (consulte "[Configurar links automáticos para apontar para recursos externos](/articles/configuring-autolinks-to-reference-external-resources)") | | | | | **X** | ### Leia mais diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md index 6f28060b13d0..df236c7f4949 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md @@ -1,6 +1,6 @@ --- title: Exigir autenticação de dois fatores em sua organização -intro: 'Os proprietários da organização podem exigir que os {% if currentVersion == "free-pro-team@latest" %}integrantes, colaboradores externos e gerentes de cobrança da organização{% else %}integrantes e colaboradores externos da organização{% endif %} habilitem a autenticação de dois fatores em suas contas pessoais para dificultar o acesso aos repositórios e às configurações da organização.' +intro: 'Os proprietários da organização podem exigir que os {% if currentVersion == "free-pro-team@latest" %}integrantes da organização, colaboradores externos e gerentes de cobrança{% else %}membros da organização e colaboradores externos{% endif %} habilitem a autenticação de dois fatores para suas contas pessoais, tornando mais difícil para atores maliciosos acessar os repositórios e configurações de uma organização.' redirect_from: - /articles/requiring-two-factor-authentication-in-your-organization versions: @@ -8,23 +8,35 @@ versions: enterprise-server: '*' --- -{% data reusables.two_fa.auth_methods_2fa %} +### Sobre a autenticação de dois fatores para organizações + +{% data reusables.two_fa.about-2fa %} Você pode exigir que todos os {% if currentVersion == "free-pro-team@latest" %}integrantes, colaboradores externos e gerentes de cobrança {% else %}integrantes e colaboradores externos na sua organização{% endif %} habilitem a autenticação de dois fatores em {% data variables.product.product_name %}. Para obter mais informações sobre a autenticação de dois fatores, consulte "[Proteger a sua conta com autenticação de dois fatores (2FA)](/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa)". -### Requisitos para exigir a autenticação de dois fatores +{% if currentVersion == "free-pro-team@latest" %} -Antes de poder exigir que os {% if currentVersion == "free-pro-team@latest" %}integrantes, colaboradores externos e gerentes de cobrança da organização{% else %}integrantes e colaboradores externos da organização{% endif %} usem 2FA, você deve [habilitar a autenticação de dois fatores](/articles/securing-your-account-with-two-factor-authentication-2fa/) na sua própria conta pessoal. +Você também pode exigir autenticação de dois fatores para as organizações de uma empresa. Para obter mais informações, consulte "[Aplicar as configurações de segurança na conta corporativa](/github/setting-up-and-managing-your-enterprise-account/enforcing-security-settings-in-your-enterprise-account#requiring-two-factor-authentication-for-organizations-in-your-enterprise-account)". + +{% endif %} {% warning %} **Avisos:** -- Se você exigir o uso da autenticação de dois fatores na organização, os {% if currentVersion == "free-pro-team@latest" %}integrantes, colaboradores externos e gerentes de cobrança{% else %}integrantes e colaboradores externos{% endif %} da sua organização (incluindo contas bot) que não usam a 2FA serão removidos da organização e perderão acesso aos repositórios dela. Eles também perderão acesso às bifurcações dos repositórios privados da organização. Se eles habilitarem a autenticação de dois fatores for habilitada na conta pessoal em até três meses após a remoção da organização, você poderá [restabelecer as configurações e os privilégios de acesso deles](/articles/reinstating-a-former-member-of-your-organization). -- Se um proprietário, integrante,{% if currentVersion == "free-pro-team@latest" %} gerente de cobrança{% endif %} ou colaborador externo da organização desabilitar a 2FA em sua conta pessoal depois que você tiver habilitado a autenticação de dois fatores obrigatória, ele será automaticamente removido da organização. +- Ao exigir o uso da autenticação de dois fatores para a sua organização, {% if currentVersion == "free-pro-team@latest" %}os integrantes, colaboradores externos e gerentes de cobrança{% else %}integrantes e colaboradores externos{% endif %} (incluindo contas bot) que não usarem a 2FA serão removidos da organização e perderão acesso aos seus repositórios. Eles também perderão acesso às bifurcações dos repositórios privados da organização. Se eles habilitarem a autenticação de dois fatores for habilitada na conta pessoal em até três meses após a remoção da organização, você poderá [restabelecer as configurações e os privilégios de acesso deles](/articles/reinstating-a-former-member-of-your-organization). +- Se um proprietário da organização, integrante{% if currentVersion == "free-pro-team@latest" %} gerente de cobrança,{% endif %} ou colaborador externo desabilitar a 2FA para sua conta pessoal depois que você habilitar a autenticação de dois fatores, eles serão automaticamente removidos da organização. - Se você for o único proprietário de uma organização que exige autenticação de dois fatores, não poderá desabilitar a 2FA na sua conta pessoal sem desabilitar a autenticação de dois fatores obrigatória na organização. {% endwarning %} -Antes de exigir o uso da autenticação de dois fatores, recomendamos que você notifique os {% if currentVersion == "free-pro-team@latest" %}integrantes, colaboradores externos e gerentes de cobrança da organização{% else %}integrantes e colaboradores externos da organização{% endif %} e peça para eles configurarem a 2FA nas contas deles. Você pode [ver se os integrantes e colaboradores externos já usam a 2FA](/articles/viewing-whether-users-in-your-organization-have-2fa-enabled) na página People (Pessoas) da organização. +{% data reusables.two_fa.auth_methods_2fa %} + +### Pré-requisitos + +Antes de poder exigir que {% if currentVersion == "free-pro-team@latest" %}os integrantes da organização, colaboradores externos e gerentes de cobrança{% else %}integrantes da organização e colaboradores externos{% endif %} usem a autenticação de dois fatores, você deve habilitá-la para a sua conta em {% data variables.product.product_name %}. Para obter mais informações, consulte "[Proteger sua conta com autenticação de dois fatores (2FA)](/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa)". + +Antes de exigir o uso da autenticação de dois fatores, recomendamos notificar os {% if currentVersion == "free-pro-team@latest" %}integrantes da organização, colaboradores externos e gerentes de cobrança {% else %}integrantes da organização e colaboradores externos{% endif %} e solicitar que configurem a 2FA para suas contas. Você pode ver se os integrantes e colaboradores externos já estão usando a 2FA. Para obter mais informações, consulte "[Ver se os usuários na organização têm a 2FA habilitada](/github/setting-up-and-managing-organizations-and-teams/viewing-whether-users-in-your-organization-have-2fa-enabled)". + +### Exigir autenticação de dois fatores em sua organização {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} @@ -47,7 +59,7 @@ Para exibir as pessoas que foram removidas automaticamente da organização por {% data reusables.audit_log.audit_log_sidebar_for_org_admins %} 4. Faça a pesquisa. Para pesquisar: - Integrantes da organização removidos, use `action:org.remove_member` na pesquisa - - Colaboradores externos removidos, use `action:org.remove_outside_collaborator` na pesquisa{% if currentVersion == "free-pro-team@latest" %} + - Colaboradores externos removidos, use `action:org.remove_outside_collaborator` na sua consulta de pesquisa{% if currentVersion == "free-pro-team@latest" %} - Gerentes de cobrança removidos, use `action:org.remove_billing_manager`na pesquisa{% endif %} Você também pode exibir as pessoas que foram removidas da organização usando um [intervalo de tempo](/articles/reviewing-the-audit-log-for-your-organization/#search-based-on-time-of-action) na pesquisa. diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md index c28fecd44248..c370e39fb581 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md @@ -8,11 +8,11 @@ versions: enterprise-server: '*' --- -Você pode escolher se os integrantes podem criar repositórios na sua organização. Se você permitir que os integrantes criem repositórios, você poderá escolher quais tipos de repositórios os integrantes poderão criar.{% if currentVersion == "free-pro-team@latest" %} Para permitir que os integrantes criem apenas repositórios privados, a sua organização deverá usar o {% data variables.product.prodname_ghe_cloud %}.{% endif %} Para obter mais informações, consulte "[Sobre a visibilidade do repositório](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)". +Você pode escolher se os integrantes podem criar repositórios na sua organização. Se você permitir que os integrantes criem repositórios, você poderá escolher quais tipos de repositórios os integrantes poderão criar.{% if currentVersion == "free-pro-team@latest" %} Para permitir que os integrantes criem apenas repositórios privados, a sua organização deve usar {% data variables.product.prodname_ghe_cloud %}.{% endif %} Para obter mais informações, consulte "[Sobre a visibilidade do repositório](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)". Os proprietários da organização sempre podem criar qualquer tipo de repositório. -{% if currentVersion == "free-pro-team@latest" %}Proprietários de empresas{% else %}administradores do site{% endif %} podem restringir as opções disponíveis para a política de criação de repositório da sua organização. Para obter mais informações, consulte {% if currentVersion == "free-pro-team@latest" %}"[Aplicar as políticas de gerenciamento do repositório na sua conta corporativa](/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account).{% else %}"[Restringir a criação do repositório na sua instância](/enterprise/admin/user-management/restricting-repository-creation-in-your-instance)."{% endif %} +{% if currentVersion == "free-pro-team@latest" %}Os proprietários da empresa{% else %}administradores do site{% endif %} podem restringir as opções disponíveis para você para a política de criação de repositório da sua organização. Para obter mais informações, consulte {% if currentVersion == "free-pro-team@latest" %}"[Aplicar políticas de gerenciamento do repositório na sua conta corporativa](/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account).{% else %}"[Restringir a criação do repositório na sua instância](/enterprise/admin/user-management/restricting-repository-creation-in-your-instance)."{% endif %} {% warning %} @@ -26,5 +26,5 @@ Os proprietários da organização sempre podem criar qualquer tipo de repositó {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.member-privileges %} -5. Em "Repository creation" (Criação de repositório), selecione {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}uma ou mais opções{% else %}uma configuração{% endif %}. ![Opções de criação de repositório](/assets/images/help/organizations/repo-creation-perms-radio-buttons.png) +5. Em "Criação do repositório", selecione uma ou mais opções. ![Opções de criação de repositório](/assets/images/help/organizations/repo-creation-perms-radio-buttons.png) 6. Clique em **Salvar**. diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md index f256f2c28fdb..b0029b8eeabf 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md @@ -202,7 +202,8 @@ For more information, see "[Restricting publication of {% data variables.product | `remove_outside_collaborator` | Triggered when an owner removes an outside collaborator from an organization or when [two-factor authentication is required in an organization](/articles/requiring-two-factor-authentication-in-your-organization) and an outside collaborator does not use 2FA or disables 2FA. |{% if currentVersion == "free-pro-team@latest" %} | `revoke_external_identity` | Triggered when an organization owner revokes a member's linked identity. For more information, see "[Viewing and managing a member's SAML access to your organization](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization#viewing-and-revoking-a-linked-identity)." | `revoke_sso_session` | Triggered when an organization owner revokes a member's SAML session. For more information, see "[Viewing and managing a member's SAML access to your organization](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization#viewing-and-revoking-a-linked-identity)." -| `unblock_user` | Triggered when an organization owner [unblocks a user from an organization](/articles/unblocking-a-user-from-your-organization).{% endif %} +| `unblock_user` | Triggered when an organization owner [unblocks a user from an organization](/articles/unblocking-a-user-from-your-organization).{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +| `update_new_repository_default_branch_setting` | Triggered when an owner changes the name of the default branch for new repositories in the organization. For more information, see "[Managing the default branch name for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization)."{% endif %} | `update_default_repository_permission` | Triggered when an owner changes the default repository permission level for organization members. | `update_member` | Triggered when an owner changes a person's role from owner to member or member to owner. | `update_member_repository_creation_permission` | Triggered when an owner changes the create repository permission for organization members.{% if currentVersion == "free-pro-team@latest" %} @@ -400,7 +401,6 @@ Using the qualifier `country`, you can filter actions in the audit log based on {% data reusables.audit_log.exported-log-keys-and-values %} {% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} ### Using the Audit log API {% note %} @@ -418,9 +418,7 @@ To ensure a secure IP and maintain compliance for your organization, you can use The GraphQL response can include data for up to 90 to 120 days. -For example, you can make a GraphQL request to see all the new organization members added to your organization. For more information, see the "[GraphQL API Audit Log](/v4/interface/auditentry/)." - -{% endif %} +For example, you can make a GraphQL request to see all the new organization members added to your organization. For more information, see the "[GraphQL API Audit Log](/graphql/reference/interfaces#auditentry/)." ### Further reading diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/reviewing-your-organizations-installed-integrations.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/reviewing-your-organizations-installed-integrations.md index f1f6360e54b3..83bcbe3dd4f6 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/reviewing-your-organizations-installed-integrations.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/reviewing-your-organizations-installed-integrations.md @@ -1,6 +1,6 @@ --- -title: Revisar as integrações instaladas da organização -intro: Você pode revisar os níveis de permissão das integrações instaladas da organização e configurar o acesso de cada integração aos repositórios da organização. +title: Reviewing your organization's installed integrations +intro: You can review the permission levels for your organization's installed integrations and configure each integration's access to organization repositories. redirect_from: - /articles/reviewing-your-organization-s-installed-integrations - /articles/reviewing-your-organizations-installed-integrations @@ -12,9 +12,12 @@ versions: {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} -4. Na barra lateral esquerda, clique em **Installed {% data variables.product.prodname_github_app %}s** ({% data variables.product.prodname_github_app %}s instalados). ![Guia Installed {% data variables.product.prodname_github_app %}s ({% data variables.product.prodname_github_app %}s instalados) na barra lateral de configurações da organização](/assets/images/help/organizations/org-settings-installed-github-apps.png) -5. Próximo do {% data variables.product.prodname_github_app %} que deseja revisar, clique em **Configure** (Configurar). ![Botão Configure (Configurar)](/assets/images/help/organizations/configure-installed-integration-button.png) -6. Revise o acesso ao repositório e as permissões de {% data variables.product.prodname_github_app %}s. ![Opção para fornecer ao {% data variables.product.prodname_github_app %} acesso a todos os repositórios ou a repositórios específicos](/assets/images/help/organizations/toggle-integration-repo-access.png) - - Para fornecer acesso ao {% data variables.product.prodname_github_app %} em todos os repositórios da organização, selecione **All repositories** (Todos os repositórios). - - Para selecionar repositórios específicos para fornecer acesso ao aplicativo, selecione **Only select repositories** (Somente os repositórios selecionados) e insira o nome do repositório. -7. Clique em **Salvar**. +4. In the left sidebar, click **Installed {% data variables.product.prodname_github_app %}s**. + ![Installed {% data variables.product.prodname_github_app %}s tab in the organization settings sidebar](/assets/images/help/organizations/org-settings-installed-github-apps.png) +5. Next to the {% data variables.product.prodname_github_app %} you'd like to review, click **Configure**. + ![Configure button](/assets/images/help/organizations/configure-installed-integration-button.png) +6. Review the {% data variables.product.prodname_github_app %}'s permissions and repository access. + ![Option to give the {% data variables.product.prodname_github_app %} access to all repositories or specific repositories](/assets/images/help/organizations/toggle-integration-repo-access.png) + - To give the {% data variables.product.prodname_github_app %} access to all of your organization's repositories, select **All repositories**. + - To choose specific repositories to give the application access to, select **Only select repositories**, then type a repository name. +7. Click **Save**. diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/setting-base-permissions-for-an-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/setting-base-permissions-for-an-organization.md index a0a4cf03597b..7b4f9697aac8 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/setting-base-permissions-for-an-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/setting-base-permissions-for-an-organization.md @@ -11,7 +11,7 @@ versions: É possível definir as permissões básicas que se aplicam a todos os integrantes da organização ao acessar qualquer um dos repositórios da organização. As permissões básicas não se aplicam a colaboradores externos. -{% if currentVersion == "free-pro-team@latest" %}Por padrão, os integrantes de uma organização terão permissão de **leitura** nos repositórios da organização.{% endif %} +{% if currentVersion == "free-pro-team@latest" %}Por padrão, os integrantes de uma organização terão permissões de **Leitura** nos repositórios da organização.{% endif %} Se alguém com permissão de administrador no repositório de uma organização conceder a um membro um nível de permissão mais alto para o repositório, o nível mais alto de permissão irá substituir a permissão básica. diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-adding-outside-collaborators.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-adding-outside-collaborators.md index 4ee63c035fcf..9f038f84ec7b 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-adding-outside-collaborators.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-adding-outside-collaborators.md @@ -1,6 +1,6 @@ --- -title: Configurar permissões para adicionar colaboradores externos -intro: 'Para proteger os dados da organização e o o número de licenças pagas usadas, você pode permitir que somente proprietários convidem colaboradores externos para os repositórios da organização.' +title: Setting permissions for adding outside collaborators +intro: 'To protect your organization''s data and the number of paid licenses used in your organization, you can allow only owners to invite outside collaborators to organization repositories.' product: '{% data reusables.gated-features.restict-add-collaborator %}' redirect_from: - /articles/restricting-the-ability-to-add-outside-collaborators-to-organization-repositories/ @@ -10,7 +10,7 @@ versions: enterprise-server: '*' --- -Os proprietários da organização e integrantes com privilégios de administrador para um repositório podem convidar colaboradores externos para trabalhar no repositório. Você também pode restringir as permissões de convites de colaboradores externos para apenas proprietários de organizações. +Organization owners, and members with admin privileges for a repository, can invite outside collaborators to work on the repository. You can also restrict outside collaborator invite permissions to only organization owners. {% data reusables.organizations.outside-collaborators-use-seats %} @@ -18,6 +18,7 @@ Os proprietários da organização e integrantes com privilégios de administrad {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.member-privileges %} -5. Em "Convites para o repositório", selecione **Permitir que os membros convidem colaboradores externos para repositórios desta organização**.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} ![Checkbox to allow members to invite outside collaborators to organization repositories](/assets/images/help/organizations/repo-invitations-checkbox-updated.png){% else %} -![Checkbox to allow members to invite outside collaborators to organization repositories](/assets/images/help/organizations/repo-invitations-checkbox.png){% endif %} -6. Clique em **Salvar**. +5. Under "Repository invitations", select **Allow members to invite outside collaborators to repositories for this organization**.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} + ![Checkbox to allow members to invite outside collaborators to organization repositories](/assets/images/help/organizations/repo-invitations-checkbox-updated.png){% else %} + ![Checkbox to allow members to invite outside collaborators to organization repositories](/assets/images/help/organizations/repo-invitations-checkbox.png){% endif %} +6. Click **Save**. diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/transferring-organization-ownership.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/transferring-organization-ownership.md index 2617480c8ef8..665904a4f0e9 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/transferring-organization-ownership.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/transferring-organization-ownership.md @@ -3,7 +3,7 @@ title: Transferir a propriedade da organização redirect_from: - /articles/needs-polish-how-do-i-give-ownership-to-an-organization-to-someone-else/ - /articles/transferring-organization-ownership -intro: 'Para tornar outra pessoa a proprietária de uma conta da organização, é preciso adicionar um novo proprietário{% if currentVersion == "free-pro-team@latest" %}, verificar se as informações de cobrança estão atualizadas{% endif %} e remover a si mesmo da conta.' +intro: 'Para tornar outra pessoa proprietária de uma conta de organização, você deve adicionar um novo proprietário{% if currentVersion == "free-pro-team@latest" %}, certifique-se de que as informações de cobrança estejam atualizadas,{% endif %} e, em seguida, remova o usuário da conta.' versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md index d3652f94028b..279d45446217 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md @@ -9,7 +9,9 @@ versions: Os Termos de serviço padrão são um acordo entre o {% data variables.product.prodname_dotcom %} e você como indivíduo. Para fazer um acordo com o {% data variables.product.prodname_dotcom %} em nome de uma entidade, como uma empresa, um grupo ou uma organização sem fins lucrativos, os proprietários da organização podem atualizar para os Termos de serviço corporativos. -1. Entre em contato com o {% data variables.contact.contact_support %} para solicitar uma atualização para os Termos de serviço corporativos. Será habilitado um banner no painel da organização que permitirá que você aceite os Termos de serviço corporativos. +1. Contato + +{% data variables.contact.contact_support %} para solicitar uma atualização para os Termos de Serviço Corporativos. Será habilitado um banner no painel da organização que permitirá que você aceite os Termos de serviço corporativos. {% data reusables.dashboard.access-org-dashboard %} 3. Na parte superior da página, à direita do banner dos Termos de serviço, clique em **Sign now** (Assinar agora). ![Botão Sign now (Assinar agora)](/assets/images/help/organizations/sign-now-button.png) 4. Leia as informações sobre os Termos de serviço corporativos e selecione **Yes, I want to sign these terms on behalf of my business** (Sim, quero assinar estes termos em nome da minha empresa). ![Caixa de seleção para assinar em nome da empresa](/assets/images/help/organizations/sign-on-behalf-business.png) diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/viewing-whether-users-in-your-organization-have-2fa-enabled.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/viewing-whether-users-in-your-organization-have-2fa-enabled.md index c3c599fd6363..73eeb5b4b655 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/viewing-whether-users-in-your-organization-have-2fa-enabled.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/viewing-whether-users-in-your-organization-have-2fa-enabled.md @@ -10,7 +10,7 @@ versions: {% note %} -**Observação:** você pode exigir que todos os integrantes{% if currentVersion == "free-pro-team@latest" %}, inclusive proprietários, gerentes de cobrança e{% else %} e{% endif %} colaboradores externos na sua organização tenham a autenticação de dois fatores habilitada. Para obter mais informações, consulte "[Exigir autenticação de dois fatores em sua organização](/articles/requiring-two-factor-authentication-in-your-organization)". +**Observação:** Você pode exigir que todos os integrantes{% if currentVersion == "free-pro-team@latest" %}, incluindo proprietários, gerentes de cobrança e{% else %} e{% endif %} colaboradores externos na sua organização possuem autenticação de dois fatores habilitada. Para obter mais informações, consulte "[Exigir autenticação de dois fatores em sua organização](/articles/requiring-two-factor-authentication-in-your-organization)". {% endnote %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/about-enterprise-accounts.md b/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/about-enterprise-accounts.md index 841d81f9d209..85468de630e6 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/about-enterprise-accounts.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/about-enterprise-accounts.md @@ -12,7 +12,7 @@ versions: ### Sobre contas corporativas -Uma conta corporativa permite que você gerencie múltiplas organizações de {% data variables.product.prodname_dotcom %} e instâncias de {% data variables.product.prodname_ghe_server %}. Sua conta corporativa deve ter um manipulador, como uma conta pessoal ou organizacional no {% data variables.product.prodname_dotcom %}. Os administradores corporativos podem gerenciar configurações e preferências, como: +Uma conta corporativa permite que você gerencie múltiplas organizações {% data variables.product.prodname_dotcom %} e instâncias {% data variables.product.prodname_ghe_server %}. Sua conta corporativa deve ter um manipulador, como uma conta pessoal ou organizacional no {% data variables.product.prodname_dotcom %}. Os administradores corporativos podem gerenciar configurações e preferências, como: - Acesso e gerenciamento de integrantes (integrantes da organização, colaboradores externos) - Faturamento e uso de instâncias de ({% data variables.product.prodname_ghe_server %}, licenças de usuário, pacotes de {% data variables.large_files.product_name_short %}) @@ -25,9 +25,7 @@ Para obter mais informações sobre o {% data variables.product.prodname_ghe_clo Para obter mais informações sobre acesso e gerenciamento de integrantes, consulte "[Gerenciar usuários na sua conta corporativa](/articles/managing-users-in-your-enterprise-account)". -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} Para obter mais informações sobre o gerenciamento de contas corporativas usando a API GraphQL, consulte "[Contas corporativas](/v4/guides/managing-enterprise-accounts)". -{% endif %} ### Gerenciar organizações vinculadas à sua conta corporativa diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md b/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md new file mode 100644 index 000000000000..2dd90d2327b6 --- /dev/null +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md @@ -0,0 +1,19 @@ +--- +title: Configurar o período de retenção para artefatos e registros do GitHub Actions na sua conta corporativa +intro: 'Os proprietários de empresas podem configurar o período de retenção para artefatos e registros de {% data variables.product.prodname_actions %} de uma conta corporativa.' +product: '{% data reusables.gated-features.enterprise-accounts %}' +miniTocMaxHeadingLevel: 4 +versions: + free-pro-team: '*' + enterprise-server: '>=2.23' +--- + +{% data reusables.actions.about-artifact-log-retention %} + +## Definir o período de retenção para uma empresa + +{% data reusables.enterprise_site_admin_settings.access-settings %} +{% data reusables.enterprise_site_admin_settings.business %} +{% data reusables.enterprise-accounts.policies-tab %} +{% data reusables.enterprise-accounts.actions-tab %} +{% data reusables.github-actions.change-retention-period-for-artifacts-logs %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account.md b/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account.md index c166dde7d0cb..680009b0c144 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account.md @@ -13,13 +13,26 @@ Por padrão, {% data variables.product.prodname_actions %} é habilitado em toda Para obter mais informações sobre {% data variables.product.prodname_actions %}, consulte "[Sobre {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)." - ### Gerenciar as permissões de {% data variables.product.prodname_actions %} para a sua conta corporativa +Você pode desabilitar todos os fluxos de trabalho para uma empresa ou definir uma política que configura quais ações podem ser usadas em uma organização. + +{% data reusables.actions.actions-use-policy-settings %} + {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.actions-tab %} {% data reusables.actions.enterprise-actions-permissions %} +1. Clique em **Salvar**. + +### Permitir a execução de ações específicas + +{% data reusables.actions.allow-specific-actions-intro %} + +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.policies-tab %} +{% data reusables.enterprise-accounts.actions-tab %} +1. Em **Políticas**, selecione **Permitir ações específicas** e adicione as suas ações necessárias à lista. ![Adicionar ações para permitir lista](/assets/images/help/organizations/enterprise-actions-policy-allow-list.png) ### Habilitar fluxos de trabalho para bifurcações privadas do repositório diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/enforcing-project-board-policies-in-your-enterprise-account.md b/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/enforcing-project-board-policies-in-your-enterprise-account.md index c4920678617e..5cd0a8db84d0 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/enforcing-project-board-policies-in-your-enterprise-account.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/enforcing-project-board-policies-in-your-enterprise-account.md @@ -1,6 +1,6 @@ --- title: Aplicar políticas de quadros de projeto na conta corporativa -intro: Os proprietários corporativos podem aplicar determinadas políticas de quadros de projeto para todas as organizações pertencentes a uma conta corporativa ou permitir que as políticas sejam definidas em cada organização. +intro: 'Os proprietários corporativos podem aplicar determinadas políticas de quadros de projeto para todas as organizações pertencentes a uma conta corporativa ou permitir que as políticas sejam definidas em cada organização.' product: '{% data reusables.gated-features.enterprise-accounts %}' redirect_from: - /articles/enforcing-project-board-settings-for-organizations-in-your-business-account/ diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account.md b/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account.md index b84ec94c2c84..894cd7ff4155 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account.md @@ -1,6 +1,6 @@ --- title: Aplicar políticas de gerenciamento de repositórios na conta corporativa -intro: Os proprietários corporativos podem aplicar determinadas políticas de gerenciamento de repositórios para todas as organizações pertencentes a uma conta corporativa ou permitir que as políticas sejam definidas em cada organização. +intro: 'Os proprietários corporativos podem aplicar determinadas políticas de gerenciamento de repositórios para todas as organizações pertencentes a uma conta corporativa ou permitir que as políticas sejam definidas em cada organização.' product: '{% data reusables.gated-features.enterprise-accounts %}' redirect_from: - /articles/enforcing-repository-management-settings-for-organizations-in-your-business-account/ diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/enforcing-team-policies-in-your-enterprise-account.md b/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/enforcing-team-policies-in-your-enterprise-account.md index 6b0971341144..d5a3153b82cd 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/enforcing-team-policies-in-your-enterprise-account.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/enforcing-team-policies-in-your-enterprise-account.md @@ -1,6 +1,6 @@ --- title: Aplicar políticas de equipe na conta corporativa -intro: Os proprietários corporativos podem aplicar determinadas políticas de equipe para todas as organizações pertencentes a uma conta corporativa ou permitir que as políticas sejam definidas em cada organização. +intro: 'Os proprietários corporativos podem aplicar determinadas políticas de equipe para todas as organizações pertencentes a uma conta corporativa ou permitir que as políticas sejam definidas em cada organização.' product: '{% data reusables.gated-features.enterprise-accounts %}' redirect_from: - /articles/enforcing-team-settings-for-organizations-in-your-business-account/ diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/index.md b/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/index.md index 213a796c000c..9eaddb3935b2 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/index.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/index.md @@ -14,6 +14,7 @@ versions: {% topic_link_in_list /managing-your-enterprise-account %} {% link_in_list /about-enterprise-accounts %} {% link_in_list /viewing-the-subscription-and-usage-for-your-enterprise-account %} + {% link_in_list /managing-licenses-for-visual-studio-subscription-with-github-enterprise %} {% topic_link_in_list /managing-users-in-your-enterprise-account %} {% link_in_list /roles-for-an-enterprise-account %} {% link_in_list /inviting-people-to-manage-your-enterprise-account %} @@ -32,3 +33,4 @@ versions: {% link_in_list /configuring-saml-single-sign-on-and-scim-for-your-enterprise-account-using-okta %} {% link_in_list /enforcing-a-policy-on-dependency-insights-in-your-enterprise-account %} {% link_in_list /enforcing-github-actions-policies-in-your-enterprise-account %} + {% link_in_list /configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md b/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md new file mode 100644 index 000000000000..e4dc2706426f --- /dev/null +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md @@ -0,0 +1,42 @@ +--- +title: Gerenciar licenças para a assinatura do Visual Studio com o GitHub Enterprise +intro: 'Você pode gerenciar o licenciamento de {% data variables.product.prodname_enterprise %} para {% data variables.product.prodname_vss_ghe %}.' +redirect_from: + - /github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-the-github-enterprise-and-visual-studio-bundle + - /github/articles/about-the-github-and-visual-studio-bundle + - /articles/about-the-github-and-visual-studio-bundle +versions: + free-pro-team: '*' +--- + +### Sobre o {% data variables.product.prodname_vss_ghe %} + +{% data variables.product.prodname_vss_ghe %} é uma oferta combinada da Microsoft que permite que um assinante use {% data variables.product.prodname_enterprise %} e {% data variables.product.prodname_vs %}. {% data variables.product.prodname_vss_ghe %} está disponível na Microsoft nos termos do Contrato da Microsoft. Para obter mais informações, consulte [{% data variables.product.prodname_vss_ghe %}](https://visualstudio.microsoft.com/subscriptions/visual-studio-github/) no site {% data variables.product.prodname_vs %} + +Depois de atribuir uma licença de {% data variables.product.prodname_vss_ghe %} a um assinante, o integrante usará a parte {% data variables.product.prodname_enterprise %} da licença, juntando-se a uma organização na sua conta corporativa com uma conta de usuário no {% data variables.product.prodname_dotcom_the_website %}. + +Para obter mais informações sobre o {% data variables.product.prodname_enterprise %}, consulte "[Produtos do {% data variables.product.company_short %}](/github/getting-started-with-github/githubs-products#github-enterprise)". Para obter mais informações sobre contas em {% data variables.product.prodname_dotcom_the_website %}, consulte "[Tipos de contas de {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/types-of-github-accounts)". + +### Pré-requisitos + +1. Depois de comprar {% data variables.product.prodname_vss_ghe %}, entre em contato com {% data variables.contact.contact_enterprise_sales %} e mencione "{% data variables.product.prodname_vss_ghe %}". Você trabalhará com a equipe de vendas para criar uma conta empresarial em {% data variables.product.prodname_dotcom_the_website %}. Se você já possui uma conta corporativa em {% data variables.product.prodname_dotcom_the_website %}, ou se não tiver certeza, informe a nossa equipe de vendas. + +2. Atribua licenças para {% data variables.product.prodname_vss_ghe %} aos assinantes em {% data variables.product.prodname_vss_admin_portal_with_url %}. Para obter mais informações sobre a atribuição de licenças, consulte [Gerenciar assinaturas de {% data variables.product.prodname_vs %} com {% data variables.product.prodname_enterprise %}](https://docs.microsoft.com/en-us/visualstudio/subscriptions/assign-github) na documentação da Microsoft. + +3. Em {% data variables.product.prodname_dotcom_the_website %}, crie pelo menos uma organização pertencente à conta corporativa. Para obter mais informações, consulte "[Adicionar organizações à sua conta corporativa](/github/setting-up-and-managing-your-enterprise-account/adding-organizations-to-your-enterprise-account)". + +4. O assinante deve criar uma conta de usuário em {% data variables.product.prodname_dotcom_the_website %} e o endereço de e-mail para a conta deve ser o mesmo endereço de e-mail que o endereço de e-mail no portal {% data variables.product.prodname_vs %}. Para obter mais informações, consulte "[Inscrever-se em {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/signing-up-for-github)" e " "[Gerenciar preferências de e-mail](/github/setting-up-and-managing-your-github-user-account/managing-email-preferences)". + +### Convidar um assinante para usar {% data variables.product.prodname_enterprise %} + +Para usar a parte de {% data variables.product.prodname_enterprise %} da licença, o integrante deve participar de uma organização pertencente à sua conta corporativa em {% data variables.product.prodname_dotcom_the_website %}. Os proprietários da organização podem convidar novos integrantes para uma organização. Para obter mais informações, consulte "[Convidar usuários para participar da sua organização](/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization)". + +### Visualizar licenciamento de {% data variables.product.prodname_enterprise %} + +Depois de atribuir uma licença para {% data variables.product.prodname_vss_ghe %} em {% data variables.product.prodname_vss_admin_portal_with_url %}, você pode visualizar o número de licenças de {% data variables.product.prodname_enterprise %} disponíveis para a sua conta corporativa. Para obter mais informações, consulte "[Exibir a assinatura e o uso de sua conta corporativa](/github/setting-up-and-managing-your-enterprise-account/viewing-the-subscription-and-usage-for-your-enterprise-account)". + +Você também pode ver convites pendentes de {% data variables.product.prodname_enterprise %} para inscritos em {% data variables.product.prodname_vss_admin_portal_with_url %}. A lista de convites pendentes inclui assinantes que ainda não são integrantes de pelo menos uma organização na sua conta corporativa. Para obter mais informações, consulte "[Exibir pessoas na conta corporativa](/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account#viewing-members-and-outside-collaborators)". + +### Leia mais + +- [Apresentar as assinaturas do Visual Studio com GitHub Enterprise](https://docs.microsoft.com/en-us/visualstudio/subscriptions/access-github) na documentação da Microsoft diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account.md b/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account.md index 0318e83ad7bb..b9f3813183ea 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account.md @@ -16,6 +16,7 @@ Você pode exibir proprietários corporativos e gerentes de cobrança, além de {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.people-tab %} {% data reusables.enterprise-accounts.administrators-tab %} +1. Opcionalmente, para ver uma lista de convites pendentes, clique em **_NÚMERO_ pendente**. ![Botão "NÚMERO pendente" à direita das opções de pesquisa e filtro](/assets/images/help/enterprises/administrators-pending.png) ### Exibir integrantes e colaboradores externos @@ -25,7 +26,8 @@ Você pode exibir todas as organizações do {% data variables.product.prodname_ {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.people-tab %} -3. Como alternativa, clique em **Outside collaborators** (Colaboradores externos) para exibir uma lista deles em vez de uma lista de integrantes. ![Guia Outside collaborators (Colaboradores externos) na página Organization members (Integrantes da organização)](/assets/images/help/business-accounts/outside-collaborators-tab.png) +1. Como alternativa, clique em **Outside collaborators** (Colaboradores externos) para exibir uma lista deles em vez de uma lista de integrantes. ![Guia Outside collaborators (Colaboradores externos) na página Organization members (Integrantes da organização)](/assets/images/help/business-accounts/outside-collaborators-tab.png) +1. Opcionalmente, para ver uma lista de convites pendentes, clique em **_NÚMERO_ pendente**. ![Botão "NÚMERO pendente" à direita das opções de pesquisa e filtro](/assets/images/help/enterprises/members-pending.png) ### Leia mais diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/about-your-organizations-profile.md b/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/about-your-organizations-profile.md index d592e5597e8f..6a2c4d38a039 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/about-your-organizations-profile.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/about-your-organizations-profile.md @@ -11,7 +11,7 @@ versions: Se desejar, você pode optar por adicionar uma descrição, um local, um site e um endereço de e-mail para sua organização, além de fixar repositórios importantes no topo da página. -{% if currentVersion == "free-pro-team@latest" %}Para confirmar a identidade da organização e exibir um selo "Verificado" na página do perfil da organização, você deve verificar os domínios da organização com o {% data variables.product.product_name %}. Par obter mais informações, consulte "[Verificar o domínio da sua organização](/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain)." +{% if currentVersion == "free-pro-team@latest" %}Para confirmar a identidade da sua organização e exibir um selo "Verificado" na página de perfil da sua organização, você deve verificar os domínios da sua organização com {% data variables.product.product_name %}. Par obter mais informações, consulte "[Verificar o domínio da sua organização](/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain)." ![Exemplo de página de perfil verificada da organização](/assets/images/help/profile/org_profile_verified.png) {% else %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/about-your-profile.md b/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/about-your-profile.md index f4ddb96351be..663f596cdf81 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/about-your-profile.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/about-your-profile.md @@ -26,7 +26,7 @@ Elas também podem ver: - Repositórios e gists que você possui ou com os quais contribui. Você pode exibir seu melhor trabalho fixando repositórios e gists no seu perfil. Para obter mais informações, consulte "[Fixar itens no seu perfil](/github/setting-up-and-managing-your-github-profile/pinning-items-to-your-profile)". - Repositórios que você salvou com estrela. Para obter mais informações, consulte "[Salvar repositórios com estrelas](/articles/saving-repositories-with-stars/)" -- Uma visão geral da sua atividade em organizações, repositórios e equipes nos quais você está mais ativo. Para obter mais informações, consulte "[Exibir uma visão geral da sua atividade no seu perfil](/articles/showing-an-overview-of-your-activity-on-your-profile).{% if currentVersion == "free-pro-team@latest" %} +- Uma visão geral da sua atividade em organizações, repositórios e equipes nos quais você está mais ativo. Para obter mais informações, consulte "[Exibir uma visão geral da sua atividade no seu perfil.](/articles/showing-an-overview-of-your-activity-on-your-profile){% if currentVersion == "free-pro-team@latest" %} - Selos que anunciam sua participação em programas como {% data variables.product.prodname_arctic_vault %}, {% data variables.product.prodname_sponsors %} ou o no programa de desenvolvedor de {% data variables.product.company_short %}. - Se você está usando o {% data variables.product.prodname_pro %}. Para obter mais informações, consulte "[Personalizar seu perfil](/articles/personalizing-your-profile)".{% endif %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md b/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md index 2500d324c3b1..3a14572dab08 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md @@ -40,7 +40,7 @@ Ao se inscrever em uma conta, o {% data variables.product.product_name %} fornec ### Alterar seu nome de perfil -Você pode alterar o nome que é exbido em seu perfil. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}Esse nome também pode ser exibido ao lado de seus comentários em repositórios privados pertencentes a uma organização. Para obter mais informações, consulte "[Gerenciar a exibição de nomes de integrantes na organização](/articles/managing-the-display-of-member-names-in-your-organization)".{% endif %} +Você pode alterar o nome que é exbido em seu perfil. Este nome também pode ser exibido ao lado dos comentários que você fizer em repositórios privados pertencentes a uma organização. Para obter mais informações, consulte "[Gerenciar a exibição de nomes de integrantes na organização](/articles/managing-the-display-of-member-names-in-your-organization)". {% data reusables.user_settings.access_settings %} 2. Em "Name" (Nome), digite o nome que deseja exibir em seu perfil. ![Campo nome em configurações de perfil](/assets/images/help/profile/name-field.png) @@ -101,12 +101,12 @@ Se você selecionar a opção "Busy" (Ocupado), quando as pessoas fizerem @menç Ao participar de determinados programas, {% data variables.product.prodname_dotcom %} exibe automaticamente um selo no seu perfil. -| Selo | Programa | Descrição | -| --------------------------------------------------------------- | ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Selo | Programa | Descrição | +| --------------------------------------------------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | {% octicon "north-star" aria-label="The North Star icon" %} | **{% data variables.product.prodname_arctic_vault %} Colaborador** | Se você criou algum(ns) commit(s) no branch-padrão de um repositório arquivado no programa Cofre do Ártico 2020, você receberá um selo de contribuidor de {% data variables.product.prodname_arctic_vault %} no seu perfil. Para obter mais informações sobre o programa, consulte [{% data variables.product.prodname_archive %}](https://archiveprogram.github.com). | -| {% octicon "cpu" aria-label="The Developer Program icon" %} | **Integrante do programa de desenvolvedores** | Se você for um integrante registrado do Programa de Desenvolvedor do GitHub, ao criar um aplicativo com a API do GitHub, você receberá um selo de integrante do programa de desenvolvedor no seu perfil. Para obter mais informações sobre o Programa de Desenvolvedor do GitHub, consulte o [Desenvolvedor do GitHub](/program/). | -| {% octicon "heart-fill" aria-label="The GitHub Sponsor icon" %} | **Patrocinador do GitHub** | Se você patrocinou um contribuidor de código aberto por meio de {% data variables.product.prodname_sponsors %}, você receberá um selo de patrocinador no seu perfil. Para obter mais informações, consulte "[Patrocinar contribuidores de código aberto](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-open-source-contributors)". | -| {% octicon "star-fill" aria-label="The star icon" %} | **Pro** | Se você usar {% data variables.product.prodname_pro %}, você receberá um selo PRO no seu perfil. Para obter mais informações sobre o {% data variables.product.prodname_pro %}, consulte "[Produtos do {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/githubs-products#github-pro)". | +| {% octicon "cpu" aria-label="The Developer Program icon" %} | **Integrante do programa de desenvolvedores** | Se você for um integrante registrado do Programa de Desenvolvedor do GitHub, ao criar um aplicativo com a API do GitHub, você receberá um selo de integrante do programa de desenvolvedor no seu perfil. Para obter mais informações sobre o Programa de Desenvolvedor do GitHub, consulte o [Desenvolvedor do GitHub](/program/). | +| {% octicon "heart-fill" aria-label="The GitHub Sponsor icon" %} | **Patrocinador do GitHub** | Se você patrocinou um contribuidor de código aberto por meio de {% data variables.product.prodname_sponsors %}, você receberá um selo de patrocinador no seu perfil. Para obter mais informações, consulte "[Patrocinar contribuidores de código aberto](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-open-source-contributors)". | +| {% octicon "star-fill" aria-label="The star icon" %} | **Pro** | Se você usar {% data variables.product.prodname_pro %}, você receberá um selo PRO no seu perfil. Para obter mais informações sobre o {% data variables.product.prodname_pro %}, consulte "[Produtos do {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/githubs-products#github-pro)". | ### Desabilitar selos no seu perfil diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/pinning-items-to-your-profile.md b/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/pinning-items-to-your-profile.md index 1b48fc09d318..ceaddc1cb766 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/pinning-items-to-your-profile.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/pinning-items-to-your-profile.md @@ -1,6 +1,6 @@ --- title: Fixar itens no seu perfil -intro: 'Você pode fixar {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.16" %}gists e {% endif %}repositórios em seu perfil para que outras pessoas possam ver mais rapidamente os seus melhores trabalhos.' +intro: 'Você pode fixar {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 6" %}gists e {% endif %}repositórios no seu perfil para que outras pessoas possam ver rapidamente o seu melhor trabalho.' redirect_from: - /articles/pinning-repositories-to-your-profile/ - /articles/pinning-items-to-your-profile diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/viewing-contributions-on-your-profile.md b/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/viewing-contributions-on-your-profile.md index 5787f4b9be35..7235446fd174 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/viewing-contributions-on-your-profile.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/viewing-contributions-on-your-profile.md @@ -25,7 +25,7 @@ Na sua página de perfil, determinadas ações contam como contribuições: - Fazer commit no branch `gh-pages` ou no branch padrão de um repositório - Abrir um problema - Propor uma pull request -- Enviar uma revisão de pull request{% if currentVersion != "free-pro-team@latest" %} +- Enviar um pull request{% if currentVersion != "free-pro-team@latest" %} - Fazer coautoria de commits no branch `gh-pages` ou no branch padrão do repositório{% endif %} {% data reusables.pull_requests.pull_request_merges_and_contributions %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/why-are-my-contributions-not-showing-up-on-my-profile.md b/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/why-are-my-contributions-not-showing-up-on-my-profile.md index 4f3d742a35b7..bd1d0e0c78b7 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/why-are-my-contributions-not-showing-up-on-my-profile.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/why-are-my-contributions-not-showing-up-on-my-profile.md @@ -40,7 +40,7 @@ Depois de fazer um commit que atenda aos requisitos para ser contabilizado como #### Você não adicionou o e-mail do commit no Git ao seu perfil -Os commits devem ser feitos com um endereço de e-mail adicionado à sua conta de {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} ou o {% data variables.product.product_name %} fornecido `noreply` endereço de e-mail fornecido nas suas configurações de e-mail{% endif %} para aparecer no seu gráfico de contribuições.{% if currentVersion == "free-pro-team@latest" %} Para obter mais informações sobre endereços de e-mail `noreply`, consulte[Configurar o seu endereço de e-mail do commit](/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address#about-commit-email-addresses)."{% endif %} +Commits devem ser feitos com um endereço de e-mail adicionado à sua conta do {% data variables.product.product_name %} {% if currentVersion == "free-pro-team@latest" %} ou o endereço de e-mail `noreply` fornecido por {% data variables.product.product_name %} a você nas suas configurações de e-mail{% endif %} para aparecer no seu gráfico de contribuições.{% if currentVersion == "free-pro-team@latest" %} Para onter mais informações sobre endereços de e-mail`noreply`, consulte "[Definir o seu endereço de e-mail do commit](/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address#about-commit-email-addresses).{% endif %} Você pode verificar o endereço de e-mail usado para um commit adicionando `.patch` ao final de uma URL de commit; por exemplo, https://github.com/octocat/octocat.github.io/commit/67c0afc1da354d8571f51b6f0af8f2794117fd10.patch: @@ -67,7 +67,7 @@ Os commits só são contados se forem feitos no branch-padrão ou no branch `gh- Se os commits estiverem em um branch que não seja `gh-pages` ou o padrão e você quiser que eles sejam contabilizados para suas contribuições, precisará seguir um destes procedimentos: - [Abrir uma pull request](/articles/creating-a-pull-request) para que ocorra o merge das alterações no branch `gh-pages` ou padrão. -- [Alterar o branch padrão](/articles/setting-the-default-branch) do repositório. +- [Alterar o branch padrão](/github/administering-a-repository/changing-the-default-branch) do repositório. {% warning %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/about-your-personal-dashboard.md b/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/about-your-personal-dashboard.md index 7b882df2490f..78d461cfe84f 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/about-your-personal-dashboard.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/about-your-personal-dashboard.md @@ -46,7 +46,7 @@ Para obter mais informações sobre como atribuir estrelas a repositórios e seg ### Explorar repositórios recomendados -Na seção "Explorar repositórios" no lado direito do painel, é possível explorar repositórios recomendados nas suas comunidades. As recomendações são baseadas em repositórios que você favoritou ou visitou, as pessoas que você segue e a atividade nos repositórios aos quais você tem acesso.{% if currentVersion == "free-pro-team@latest" %} Para obter mais informações, consulte "[Encontrar formas de contribuir com código aberto no {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)."{% endif %} +Na seção "Explorar repositórios" no lado direito do painel, é possível explorar repositórios recomendados nas suas comunidades. As recomendações têm por base repositórios que você marcou com uma estrela ou visitou, as pessoas que você segue e a atividade nos repositórios aos quais você tem acesso.{% if currentVersion == "free-pro-team@latest" %} Para obter mais informações, consulte "[Encontrar maneiras de contribuir com código aberto em {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github).{% endif %} ### Leia mais diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/changing-your-github-username.md b/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/changing-your-github-username.md index 0b859127c60d..8140f491016e 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/changing-your-github-username.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/changing-your-github-username.md @@ -1,6 +1,6 @@ --- -title: Alterar seu nome de usuário do GitHub -intro: 'Você pode alterar seu nome de usuário do {% data variables.product.product_name %} a qualquer momento.' +title: Changing your GitHub username +intro: 'You can change your {% data variables.product.product_name %} username at any time.' redirect_from: - /articles/how-to-change-your-username/ - /articles/changing-your-github-user-name/ @@ -12,46 +12,50 @@ versions: enterprise-server: '*' --- -### Sobre alterações no nome de usuário +### About username changes -Você pode alterar seu nome de usuário para outro que não esteja em uso no momento.{% if currentVersion == "free-pro-team@latest" %} Se o nome de usuário desejado não estiver disponível, você será informado se é possível solicitar a liberação dele quando digitá-lo. +You can change your username to another username that is not currently in use.{% if currentVersion == "free-pro-team@latest" %} If the username you want is not available, you'll see information about whether you can request the username to be released when you type in the desired username. -Se o nome de usuário não estiver qualificado para liberação e você não detém uma marca comercial para este nome de usuário, é possível escolher outro ou manter o atual. O {% data variables.contact.github_support %} não pode liberar o nome de usuário indisponível para você. Para obter mais informações, consulte "[Alterar nome de usuário](#changing-your-username)".{% endif %} +If the username is not eligible for release and you don't hold a trademark for the username, you can choose another username or keep your current username. {% data variables.contact.github_support %} cannot release the unavailable username for you. For more information, see "[Changing your username](#changing-your-username)."{% endif %} -Depois de alterar seu nome de usuário, o nome antigo será disponibilizado para reivindicação por qualquer pessoa. A maioria das referências aos seus repositórios sob o nome de usuário antigo muda automaticamente para o novo nome de usuário. No entanto, alguns links para seu perfil não são redirecionados automaticamente. +After changing your username, your old username becomes available for anyone else to claim. Most references to your repositories under the old username automatically change to the new username. However, some links to your profile won't automatically redirect. -O {% data variables.product.product_name %} não pode configurar redirecionamentos para: -- [@menções](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams) usando o nome de usuário antigo -- Links para [gists](/articles/creating-gists) que incluem o nome de usuário antigo +{% data variables.product.product_name %} cannot set up redirects for: +- [@mentions](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams) using your old username +- Links to [gists](/articles/creating-gists) that include your old username -### Referências de repositório +### Repository references -Após alteração do nome de usuário, o {% data variables.product.product_name %} redirecionará automaticamente as referências para os repositórios. -- Os links da web para repositórios existentes continuarão funcionando. Esse processo pode demorar alguns minutos para ser concluído após a alteração. -- A linha de comando que faz push dos clones do repositório local para as URLs de controle do remote continuarão funcionando. +After you change your username, {% data variables.product.product_name %} will automatically redirect references to your repositories. +- Web links to your existing repositories will continue to work. This can take a few minutes to complete after you make the change. +- Command line pushes from your local repository clones to the old remote tracking URLs will continue to work. -Se o novo proprietário do seu antigo nome de usuário criar um repositório com o mesmo nome do seu repositório, isso substituirá a entrada de redirecionamento e o seu redirecionamento para de funcionar. Por conta dessa possibilidade, é recomendável atualizar todas as URLs existentes do repositório remote após alteração do seu nome de usuário. Para obter mais informações, consulte "[Alterar o URL de um remote](/articles/changing-a-remote-s-url)". +If the new owner of your old username creates a repository with the same name as your repository, that will override the redirect entry and your redirect will stop working. Because of this possibility, we recommend you update all existing remote repository URLs after changing your username. For more information, see "[Changing a remote's URL](/articles/changing-a-remote-s-url)." -### Links para a página de perfil anterior +### Links to your previous profile page -Após alteração do nome de usuário, os links para sua página de perfil anterior, como `https://{% data variables.command_line.backticks %}/previoususername`, retornarão um erro 404. É recomendável atualizar qualquer link para sua conta do {% data variables.product.product_name %} de qualquer lugar{% if currentVersion == "free-pro-team@latest" %}, como seu perfil no LinkedIn ou Twitter{% endif %}. +After changing your username, links to your previous profile page, such as `https://{% data variables.command_line.backticks %}/previoususername`, will return a 404 error. We recommend updating any links to your {% data variables.product.product_name %} account from elsewhere{% if currentVersion == "free-pro-team@latest" %}, such as your LinkedIn or Twitter profile{% endif %}. -### Seus commits no Git +### Your Git commits -{% if currentVersion == "free-pro-team@latest"%}Os commits do Git que estavam associados ao seu endereço de e-mail `noreply` fornecido pelo {% data variables.product.product_name %} não serão atribuídos ao seu novo nome de usuário e não aparecerão no gráfico de contribuições.{% endif %} Se seus commits do Git estiverem associados a outro endereço de e-mail que você [adicionou à sua conta do GitHub](/articles/adding-an-email-address-to-your-github-account), {% if currentVersion == "free-pro-team@latest"%}incluindo o endereço de e-mail `noreply` fornecido pelo {% data variables.product.product_name %} com base na ID, {% endif %}eles continuarão sendo atribuídos a você e aparecerão no gráfico de contribuição depois da alteração do nome de usuário. Para obter mais informações sobre como configurar o endereço de e-mail, consulte "[Configurar o endereço de e-mail do commit](/articles/setting-your-commit-email-address)". +{% if currentVersion == "free-pro-team@latest"%}Git commits that were associated with your {% data variables.product.product_name %}-provided `noreply` email address won't be attributed to your new username and won't appear in your contributions graph.{% endif %} If your Git commits are associated with another email address you've [added to your GitHub account](/articles/adding-an-email-address-to-your-github-account), {% if currentVersion == "free-pro-team@latest"%}including the ID-based {% data variables.product.product_name %}-provided `noreply` email address, {% endif %}they'll continue to be attributed to you and appear in your contributions graph after you've changed your username. For more information on setting your email address, see "[Setting your commit email address](/articles/setting-your-commit-email-address)." -### Alterar nome de usuário +### Changing your username {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.account_settings %} -3. Na seção "Change username" (Alterar nome de usuário), clique em **Change username** (Alterar nome de usuário). ![Change Username button](/assets/images/help/settings/settings-change-username.png){% if currentVersion == "free-pro-team@latest" %} -4. Leia os avisos sobre a mudança de seu nome de usuário. Se você ainda quiser alterar seu nome de usuário, clique em **I understand, let's change my username** (Compreendo, vamos alterar meu nome de usuário). ![Botão de aviso Change Username (Alterar nome de usuário)](/assets/images/help/settings/settings-change-username-warning-button.png) -5. Digite um novo nome de usuário. ![Campo New Username (Novo nome de usuário)](/assets/images/help/settings/settings-change-username-enter-new-username.png) -6. Se o nome que você escolheu estiver disponível, clique em **Change my username** (Alterar meu nome de usuário). Se o nome que você escolheu estiver indisponível, tente um nome de usuário diferente ou uma das sugestões que aparecem. ![Botão de aviso Change Username (Alterar nome de usuário)](/assets/images/help/settings/settings-change-my-username-button.png) +3. In the "Change username" section, click **Change username**. + ![Change Username button](/assets/images/help/settings/settings-change-username.png){% if currentVersion == "free-pro-team@latest" %} +4. Read the warnings about changing your username. If you still want to change your username, click **I understand, let's change my username**. + ![Change Username warning button](/assets/images/help/settings/settings-change-username-warning-button.png) +5. Type a new username. + ![New username field](/assets/images/help/settings/settings-change-username-enter-new-username.png) +6. If the username you've chosen is available, click **Change my username**. If the username you've chosen is unavailable, you can try a different username or one of the suggestions you see. + ![Change Username warning button](/assets/images/help/settings/settings-change-my-username-button.png) {% endif %} -### Leia mais +### Further reading -- "[Alterar o URL de um remote](/articles/changing-a-remote-s-url)" -- "[Por que meus commits estão vinculados ao usuário errado?](/articles/why-are-my-commits-linked-to-the-wrong-user)"{% if currentVersion == "free-pro-team@latest" %} -- "[{% data variables.product.prodname_dotcom %} Política de nome de usuário](/articles/github-username-policy)"{% endif %} +- "[Changing a remote's URL](/articles/changing-a-remote-s-url)" +- "[Why are my commits linked to the wrong user?](/articles/why-are-my-commits-linked-to-the-wrong-user)"{% if currentVersion == "free-pro-team@latest" %} +- "[{% data variables.product.prodname_dotcom %} Username Policy](/articles/github-username-policy)"{% endif %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md b/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md index 974c28ae0970..5569cbb1de73 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md @@ -8,6 +8,12 @@ versions: enterprise-server: '*' --- +{% note %} + +**Observação:** Você não pode alterar seu endereço de e-mail principal para um e-mail que já está definido como seu endereço de e-mail de backup. + +{% endnote %} + {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.emails %} 3. Se desejar adicionar um novo endereço de e-mail para definir como endereço de e-mail principal, em "Add email address" (Adicionar endereço de e-mail), digite um novo endereço de e-mail e clique em **Add** (Adicionar). ![Botão para adicionar outro endereço de e-mail](/assets/images/help/settings/add_another_email_address.png) @@ -15,7 +21,8 @@ versions: 5. Para remover o endereço de e-mail antigo da sua conta, ao lado do e-mail antigo, clique em {% octicon "trashcan" aria-label="The trashcan symbol" %}. {% if currentVersion == "free-pro-team@latest" %} -6. Verifique o novo endereço de e-mail principal. Sem um endereço de e-mail verificado, você não poderá usar todos os recursos do {% data variables.product.product_name %}. Para obter mais informações, consulte "[Verificar o endereço de e-mail](/articles/verifying-your-email-address)". +6. Verifique o novo endereço de e-mail principal. Sem um endereço de e-mail verificado, você não será conseguirá usar todos os +recursos de {% data variables.product.product_name %}. Para obter mais informações, consulte "[Verificar o endereço de e-mail](/articles/verifying-your-email-address)". {% endif %} ### Leia mais diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md index 8067066648bd..c7e8423e0725 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md @@ -17,7 +17,7 @@ versions: - Você **não poderá** mais entrar na conta do usuário convertido. - Você **não poderá** mais criar nem modificar gists pertencentes à conta do usuário convertido. - Uma organização **não pode** ser convertida de volta em um usuário. - - As chaves SSH, os tokens OAuth, o perfil de trabalho, {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} as reações {% endif %}e as informações do usuário associadas, **não** serão transferidos para a organização. Isso é válido apenas para a conta de usuário que está sendo convertida, e não para colaboradores da conta de usuário. + - As chaves SSH, os tokens do OAuth, o perfil de trabalho, as reações e as informações do usuário associadas, **não** serão transferidos para a organização. Isso é válido apenas para a conta de usuário que está sendo convertida, e não para colaboradores da conta de usuário. - Qualquer commit feito com a conta do usuário convertido **não será mais vinculado** a essa conta. Os commits em si **permanecerão** intactos. {% endwarning %} @@ -35,7 +35,7 @@ Se quiser que sua organização tenha o mesmo nome que atualmente você está us Você também pode converter sua conta de usuário pessoal diretamente em uma organização. A conversão da conta: - Preserva os repositórios como estão sem a necessidade de transferi-los para outra conta manualmente - Convida automaticamente colaboradores para equipes com permissões equivalentes às que tinham antes - {% if currentVersion == "free-pro-team@latest" %}- Para contas de usuário no {% data variables.product.prodname_pro %}, faz a transição da cobrança automaticamente para o [{% data variables.product.prodname_team %} pago](/articles/about-billing-for-github-accounts) sem a necessidade de inserir novamente as informações de pagamento, ajustar o ciclo de cobrança ou pagar em dobro{% endif %} + {% if currentVersion == "free-pro-team@latest" %}- Para contas de usuário em {% data variables.product.prodname_pro %}, transforma automaticamente a cobrança para [os {% data variables.product.prodname_team %}pagos](/articles/about-billing-for-github-accounts) sem a necessidade de inserir novamente as informações de pagamento, ajustar seu ciclo de cobrança ou de pagamento duplo a qualquer momento{% endif %} 1. Crie uma conta pessoal, que você usará para entrar no GitHub e acessar a organização e seus repositórios após conversão. 2. [Saia das organizações](/articles/removing-yourself-from-an-organization) nas quais a conta de usuário que você está convertendo ingressou. @@ -56,5 +56,5 @@ Você também pode converter sua conta de usuário pessoal diretamente em uma or ### Leia mais - "[Configurar equipes](/articles/setting-up-teams)" -{% if currentVersion == "free-pro-team@latest" %}- "[Convidar usuários para ingressar na organização](/articles/inviting-users-to-join-your-organization)"{% endif %} +{% if currentVersion == "free-pro-team@latest" %}- "[Convidar usuários para participar da sua organização](/articles/inviting-users-to-join-your-organization)"{% endif %} - "[Acessar uma organização](/articles/accessing-an-organization)" diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/deleting-your-user-account.md b/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/deleting-your-user-account.md index 6ce194c4ed1f..ebf2c2d53cd7 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/deleting-your-user-account.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/deleting-your-user-account.md @@ -9,9 +9,9 @@ versions: enterprise-server: '*' --- -A exclusão da conta de usuário remove todos os repositórios, bifurcações de repositórios privados, wikis, problemas, pull requests e páginas pertencentes à sua conta. {% if currentVersion == "free-pro-team@latest" %} Os problemas e as pull requests que você criou e os comentários que você fez nos repositórios pertencentes a outros usuários não serão excluídos. Em vez disso, eles serão associados ao nosso [usuário fantasma](https://github.com/ghost).{% else %}Os problemas e as pull requests que você criou e os comentários que você fez nos repositórios pertencentes a outros usuários não serão excluídos.{% endif %} +A exclusão da conta de usuário remove todos os repositórios, bifurcações de repositórios privados, wikis, problemas, pull requests e páginas pertencentes à sua conta. {% if currentVersion == "free-pro-team@latest" %} Os problemas e pull requests que você criou e comentários que você fez em repositórios pertencentes a outros usuários não serão excluídos - em vez disso, eles serão associados ao nosso [Usuário fantasma](https://github.com/ghost).{% else %}Problemas e pull requests que você criou e comentários que você fez em repositórios pertencentes a outros usuários não serão excluídos.{% endif %} -{% if currentVersion == "free-pro-team@latest" %} O nome da conta também fica disponível para ser usado por qualquer pessoa em uma nova conta, e a cobrança cessa. O endereço de e-mail associado à conta fica disponível para ser usado com uma conta diferente do {% data variables.product.product_name %}. {% endif %} +{% if currentVersion == "free-pro-team@latest" %} O nome da conta também fica disponível para qualquer pessoa usar em uma nova conta e paramos de efetuar a cobrança. O endereço de e-mail associado à conta fica disponível para ser usado com uma conta diferente do {% data variables.product.product_name %}. {% endif %} Se você for o único proprietário de uma organização, transfira a propriedade para outra pessoa ou exclua a organização para poder excluir sua conta de usuário. Caso haja outros proprietários na organização, remova a si mesmo da organização para poder excluir sua conta de usuário. @@ -38,7 +38,7 @@ Antes de excluir sua conta de usuário, faça uma cópia de todos os repositóri - Se você for o único proprietário da organização, transfira a propriedade para outra pessoa ou exclua sua organização. - Caso haja outros proprietários na organização, remova a si mesmo da organização. ![Botão Account deletion (Exclusão de conta)](/assets/images/help/settings/settings-account-delete.png) 4. Na caixa de diálogo "Make sure you want to do this" (Certifique-se de que você quer fazer isso), conclua as etapas descritas para confirmar que está ciente do que acontecerá quando sua conta for excluída: ![Caixa de diálogo de confirmação Delete account (Excluir conta)](/assets/images/help/settings/settings-account-deleteconfirm.png) - {% if currentVersion == "free-pro-team@latest" %}- Lembre-se de que todos os repositórios, bifurcações de repositórios privados, wikis, problemas, pull requests e páginas pertencentes à sua conta serão excluídos, a cobrança cessará e seu nome de usuário ficará disponível para ser usado por qualquer pessoa no {% data variables.product.product_name %}. + {% if currentVersion == "free-pro-team@latest" %}- Lembre-se de que todos os repositórios, bifurcações de repositórios privados, wikis, problemas, pull requests e páginas da sua conta serão excluídos, sua cobrança será encerrada, e o seu nome de usuário estará disponível para qualquer pessoa para uso em {% data variables.product.product_name %}. {% else %}- Lembre-se de que todos os repositórios, bifurcações de repositórios privados, wikis, problemas, pull requests e páginas pertencentes à sua conta serão excluídos e seu nome de usuário ficará disponível para ser usado por qualquer pessoa no {% data variables.product.product_name %}. {% endif %}- No primeiro campo, digite seu nome de usuário ou e-mail do {% data variables.product.product_name %}. - No segundo campo, digite a frase do prompt. diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository.md b/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository.md index 09acb453622f..9dfc05ff7e2c 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository.md @@ -1,6 +1,6 @@ --- title: Convidar colaboradores para um repositório pessoal -intro: 'Você pode {% if currentVersion == "free-pro-team@latest" %}convidar usuários para se tornarem{% else %}adicionar usuários como{% endif %} colaboradores em seu repositório pessoal.' +intro: 'Você pode {% if currentVersion == "free-pro-team@latest" %}convidar usuários para se tornarem{% else %}adicionar usuários como{% endif %} colaboradores do seu repositório pessoal.' redirect_from: - /articles/how-do-i-add-a-collaborator/ - /articles/adding-collaborators-to-a-personal-repository/ @@ -29,7 +29,7 @@ Os repositórios de propriedade de uma organização podem conceder mais acesso 1. Pergunte o nome de usuário da pessoa que você está convidando como colaborador. -{% if currentVersion == "free-pro-team@latest" %} Caso ela ainda não tenha um nome de usuário, pode se inscrever para o {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte "[Inscrever-se para uma nova conta do {% data variables.product.prodname_dotcom %}](/articles/signing-up-for-a-new-github-account)".{% endif %}" +{% if currentVersion == "free-pro-team@latest" %} Se eles ainda não têm um nome de usuário, eles podem se inscrever em {% data variables.product.prodname_dotcom %} Para obter mais informações, consulte "[Inscrever-se para uma nova conta de {% data variables.product.prodname_dotcom %}](/articles/signing-up-for-a-new-github-account)".{% endif %} {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} {% if currentVersion == "free-pro-team@latest" %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md b/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md index f841a7ab19dd..908b15bf2fcc 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md @@ -18,7 +18,9 @@ Um colaborador é uma pessoa com permissões em um quadro de projeto pertencente {% data reusables.project-management.click-menu %} {% data reusables.project-management.access-collaboration-settings %} {% data reusables.project-management.collaborator-option %} -5. Em "Search by username, full name or email address" (Pesquisar por nome de usuário, nome completo ou endereço de e-mail), digite o nome, o nome de usuário ou o e-mail do colaborador no {% data variables.product.prodname_dotcom %}. ![A seção Collaborators (Colaboradores) com o nome de usuário Octocat inserido no campo de pesquisa](/assets/images/help/projects/org-project-collaborators-find-name.png) +5. Em "Pesquisar por nome de usuário, nome completo ou endereço de e-mail", digite o nome do colaborador, nome de usuário, ou +e-mail de {% data variables.product.prodname_dotcom %}. + ![A seção Collaborators (Colaboradores) com o nome de usuário Octocat inserido no campo de pesquisa](/assets/images/help/projects/org-project-collaborators-find-name.png) {% data reusables.project-management.add-collaborator %} 7. O novo colaborador tem acessos de leitura por padrão. Como opção, ao lado do nome do novo colaborador, use o menu suspenso e escolha um nível de permissão diferente. ![Seção Collaborators (Colaboradores) com menu suspenso Permissions (Permissões) selecionado](/assets/images/help/projects/user-project-collaborators-edit-permissions.png) diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/managing-security-and-analysis-settings-for-your-user-account.md b/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/managing-security-and-analysis-settings-for-your-user-account.md index 6ece74334240..d0296d942b49 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/managing-security-and-analysis-settings-for-your-user-account.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/managing-security-and-analysis-settings-for-your-user-account.md @@ -35,4 +35,4 @@ Para obter uma visão geral da segurança do repositório, consulte "[Sobre como - "[Sobre o gráfico de dependências](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)" - "[Gerenciar vulnerabilidades nas dependências do seu projeto](/github/managing-security-vulnerabilities/managing-vulnerabilities-in-your-projects-dependencies)" -{% if currentVersion == "free-pro-team@latest" %}- "[Manter suas dependências atualizadas automaticamente](/github/administering-a-repository/keeping-your-dependencies-updated-automatically)"{% endif %} +{% if currentVersion == "free-pro-team@latest" %}- "[Manter as suas dependências atualizadas automaticamente](/github/administering-a-repository/keeping-your-dependencies-updated-automatically)"{% endif %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md b/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md index 0479a2c325e7..b612becec80f 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md @@ -1,18 +1,16 @@ --- title: Gerenciar o nome do branch-padrão para seus repositórios -intro: Você pode definir um nome do branch-padrão para todos os novos repositórios que você criar. +intro: 'Você pode definir os novos repositórios com nome do branch-padrão que você cria em {% data variables.product.product_location %}.' versions: free-pro-team: '*' enterprise-server: '>=2.23' --- -### Sobre o nome do branch-padrão +### Sobre o gerenciamento do nome do brancc-padrão -{% data reusables.branches.new-repo-default-branch %} Este branch é atualmente denominado `mestre`, mas você pode definir o nome do branch-padrão como qualquer coisa que faça sentido para seu ambiente de desenvolvimento. +Ao criar um novo repositório em {% data variables.product.product_location %}, o repositório conterá um branch, que será o branch-padrão. Você pode alterar o nome que {% data variables.product.product_name %} usa para o branch-padrão em novos repositórios que você criar. Para obter mais informações sobre o branch padrão, consulte "[Sobre branches](/github/collaborating-with-issues-and-pull-requests/about-branches#about-the-default-branch)". -{% data reusables.branches.set-default-branch %} - -{% data reusables.branches.rename-existing-branch %} +{% data reusables.branches.change-default-branch %} ### Definir o nome do branch-padrão @@ -24,4 +22,4 @@ versions: ### Leia mais -- [Gerenciar o nome de branch-padrão para repositórios na sua organização](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization) +- "[Gerenciar o nome do branch-padrão para repositórios na sua organização](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization)" diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md b/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md index c9bc0e50e6d7..c6ebc8a604b9 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md @@ -1,6 +1,6 @@ --- -title: Níveis de permissão para um repositório de conta de usuário -intro: 'Um repositório pertencente a uma conta de usuário tem dois níveis de permissão: *proprietário do repositório* e *colaboradores*.' +title: Permission levels for a user account repository +intro: 'A repository owned by a user account has two permission levels: the *repository owner* and *collaborators*.' redirect_from: - /articles/permission-levels-for-a-user-account-repository versions: @@ -10,65 +10,64 @@ versions: {% tip %} -**Dica:** Se você precisar de acesso de leitura e gravação mais granular em um repositório de propriedade de sua conta de usuário, considere transferir o repositório para uma organização. Para obter mais informações, consulte "[Transferir um repositório](/articles/transferring-a-repository)". +**Tip:** If you require more granular read/write access to a repository owned by your user account, consider transferring the repository to an organization. For more information, see "[Transferring a repository](/articles/transferring-a-repository)." {% endtip %} -#### Acesso de proprietário em um repositório de propriedade de uma conta de usuário +#### Owner access on a repository owned by a user account -O proprietário do repositório tem controle total do repositório. Além de todas as permissões concedidas aos colaboradores de repositório, o proprietário do repositório pode: +The repository owner has full control of the repository. In addition to all the permissions allowed by repository collaborators, the repository owner can: -- {% if currentVersion == "free-pro-team@latest" %}[Convidar colaboradores](/articles/inviting-collaborators-to-a-personal-repository){% else %}[Adicionar colaboradores](/articles/inviting-collaborators-to-a-personal-repository){% endif %} -- Alterar a visibilidade do repositório (de [pública para privada](/articles/making-a-public-repository-private) ou de [privada para pública](/articles/making-a-private-repository-public)){% if currentVersion == "free-pro-team@latest" %} -- [Restringir interações no repositório](/articles/limiting-interactions-with-your-repository){% endif %} -- Fazer merge de uma pull request em um branch protegido, mesmo sem revisões de aprovação -- [Excluir o repositório](/articles/deleting-a-repository) -- [Gerenciar os tópicos de um repositório](/articles/classifying-your-repository-with-topics){% if currentVersion == "free-pro-team@latest" %} -- Gerenciar configurações de segurança e análise. Para obter mais informações, consulte "[Gerenciar configurações de segurança e análise para sua conta de usuário](/github/setting-up-and-managing-your-github-user-account/managing-security-and-analysis-settings-for-your-user-account)".{% endif %}{% if currentVersion == "free-pro-team@latest" %} -- [Habilitar o gráfico de dependências](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) para um repositório privado{% endif %}{% if currentVersion == "free-pro-team@latest" %} -- Excluir pacotes. Para obter mais informações, consulte "[Excluir um pacote](/github/managing-packages-with-github-packages/deleting-a-package)".{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -- Criar e editar cartões sociais do repositório. Para obter mais informações, consulte "[Personalizar a exibição das redes sociais do repositório](/articles/customizing-your-repositorys-social-media-preview)". -- Transformar o repositório em um modelo. Para obter mais informações, consulte "[Criar um repositório modelo](/articles/creating-a-template-repository)".{% endif %} -- Receber [{% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}alertas de segurança{% endif %} para dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) em um repositório{% if currentVersion == "free-pro-team@latest" %} -- Ignorar {% data variables.product.prodname_dependabot_alerts %} no seu repositório. Para obter mais informações, consulte "[Visualizar e atualizar dependências vulneráveis no seu repositório](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository). " -- [Gerenciar o uso de dados para o seu repositório privado](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository){% endif %} -- [Definir os proprietários do código do repositório](/articles/about-code-owners) -- [Arquivar repositórios](/articles/about-archiving-repositories){% if currentVersion == "free-pro-team@latest" %} -- Criar consultorias de segurança. Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_security_advisories %}](/github/managing-security-vulnerabilities/about-github-security-advisories)". -- Exibir um botão de patrocinador. Para obter mais informações, consulte "[Exibir um botão de patrocinador no seu repositório](/articles/displaying-a-sponsor-button-in-your-repository)".{% endif %} +- {% if currentVersion == "free-pro-team@latest" %}[Invite collaborators](/articles/inviting-collaborators-to-a-personal-repository){% else %}[Add collaborators](/articles/inviting-collaborators-to-a-personal-repository){% endif %} +- Change the visibility of the repository (from [public to private](/articles/making-a-public-repository-private), or from [private to public](/articles/making-a-private-repository-public)){% if currentVersion == "free-pro-team@latest" %} +- [Limit interactions with a repository](/articles/limiting-interactions-with-your-repository){% endif %} +- Merge a pull request on a protected branch, even if there are no approving reviews +- [Delete the repository](/articles/deleting-a-repository) +- [Manage a repository's topics](/articles/classifying-your-repository-with-topics){% if currentVersion == "free-pro-team@latest" %} +- Manage security and analysis settings. For more information, see "[Managing security and analysis settings for your user account](/github/setting-up-and-managing-your-github-user-account/managing-security-and-analysis-settings-for-your-user-account)."{% endif %}{% if currentVersion == "free-pro-team@latest" %} +- [Enable the dependency graph](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) for a private repository{% endif %}{% if currentVersion == "free-pro-team@latest" %} +- Delete packages. For more information, see "[Deleting a package](/github/managing-packages-with-github-packages/deleting-a-package)."{% endif %} +- Create and edit repository social cards. For more information, see "[Customizing your repository's social media preview](/articles/customizing-your-repositorys-social-media-preview)." +- Make the repository a template. For more information, see "[Creating a template repository](/articles/creating-a-template-repository)." +- Receive [{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in a repository.{% if currentVersion == "free-pro-team@latest" %} +- Dismiss {% data variables.product.prodname_dependabot_alerts %} in your repository. For more information, see "[Viewing and updating vulnerable dependencies in your repository](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)." +- [Manage data usage for your private repository](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository){% endif %} +- [Define code owners for the repository](/articles/about-code-owners) +- [Archive repositories](/articles/about-archiving-repositories){% if currentVersion == "free-pro-team@latest" %} +- Create security advisories. For more information, see "[About {% data variables.product.prodname_security_advisories %}](/github/managing-security-vulnerabilities/about-github-security-advisories)." +- Display a sponsor button. For more information, see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)."{% endif %} -Só existe um **único proprietário** de um repositório pertencente a uma conta de usuário. Essa permissão não pode ser compartilhada com outra conta de usuário. Para transferir a propriedade de um repositório a outro usuário, consulte "[Como transferir um repositório](/articles/how-to-transfer-a-repository)". +There is only **one owner** of a repository owned by a user account; this permission cannot be shared with another user account. To transfer ownership of a repository to another user, see "[How to transfer a repository](/articles/how-to-transfer-a-repository)." -#### Acesso de colaborador em um repositório de propriedade de uma conta de usuário +#### Collaborator access on a repository owned by a user account {% note %} -**Observação:** Em um repositório privado, proprietários de repositórios podem conceder somente acesso de gravação aos colaboradores. Os colaboradores não podem ter acesso somente leitura a repositórios pertencentes a uma conta de usuário. +**Note:** In a private repository, repository owners can only grant write access to collaborators. Collaborators can't have read-only access to repositories owned by a user account. {% endnote %} -Em um repositório pessoal, os colaboradores podem: +Collaborators on a personal repository can: -- Fazer push para (gravar), fazer pull de (ler) e bifurcar (copiar) o repositório -- Criar, aplicar e excluir etiquetas e marcos -- Abrir, fechar, reabrir e atribuir problemas -- Editar e excluir comentários em commits, pull request e problemas -- Marcar um problema ou pull request como duplicata. Para obter mais informações, consulte "[Sobre problemas e pull requests duplicados](/articles/about-duplicate-issues-and-pull-requests)". -- Abrir, fazer merge e fechar pull requests -- Aplicar as alterações sugeridas em pull requests. Para obter mais informações, consulte "[Incluir feedback na pull request](/articles/incorporating-feedback-in-your-pull-request)". -- Enviar pull requests das bifurcações do repositório{% if currentVersion == "free-pro-team@latest" %} -- Publicar, visualizar e instalar pacotes. Para obter mais informações, consulte "[Publicar e gerenciar pacotes](/github/managing-packages-with-github-packages/publishing-and-managing-packages)".{% endif %} -- Criar e editar Wikis -- Criar e editar versões. Para obter mais informações, consulte "[Gerenciar versões em um repositório](/github/administering-a-repository/managing-releases-in-a-repository). -- Remover a si mesmos como colaboradores do repositório -- Enviar uma revisão de uma pull request que afetará a capacidade de merge dela -- Atuar como um proprietário do código designado do repositório. Para obter mais informações, consulte "[Sobre proprietários do código](/articles/about-code-owners)". -- Bloquear uma conversa. Para obter mais informações, consulte "[Bloquear conversas](/articles/locking-conversations)".{% if currentVersion == "free-pro-team@latest" %} -- Denunciar conteúdo abusivo para o {% data variables.contact.contact_support %}. Para obter mais informações, consulte "[Relatar abuso ou spam](/articles/reporting-abuse-or-spam)".{% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -- Transferir um problema para um repositório diferente. Para obter mais informações, consulte "[Transferir um problema para outro repositório](/articles/transferring-an-issue-to-another-repository)".{% endif %} +- Push to (write), pull from (read), and fork (copy) the repository +- Create, apply, and delete labels and milestones +- Open, close, re-open, and assign issues +- Edit and delete comments on commits, pull requests, and issues +- Mark an issue or pull request as a duplicate. For more information, see "[About duplicate issues and pull requests](/articles/about-duplicate-issues-and-pull-requests)." +- Open, merge and close pull requests +- Apply suggested changes to pull requests. For more information, see "[Incorporating feedback in your pull request](/articles/incorporating-feedback-in-your-pull-request)." +- Send pull requests from forks of the repository{% if currentVersion == "free-pro-team@latest" %} +- Publish, view, and install packages. For more information, see "[Publishing and managing packages](/github/managing-packages-with-github-packages/publishing-and-managing-packages)."{% endif %} +- Create and edit Wikis +- Create and edit releases. For more information, see "[Managing releases in a repository](/github/administering-a-repository/managing-releases-in-a-repository). +- Remove themselves as collaborators on the repository +- Submit a review on a pull request that will affect its mergeability +- Act as a designated code owner for the repository. For more information, see "[About code owners](/articles/about-code-owners)." +- Lock a conversation. For more information, see "[Locking conversations](/articles/locking-conversations)."{% if currentVersion == "free-pro-team@latest" %} +- Report abusive content to {% data variables.contact.contact_support %}. For more information, see "[Reporting abuse or spam](/articles/reporting-abuse-or-spam)."{% endif %} +- Transfer an issue to a different repository. For more information, see "[Transferring an issue to another repository](/articles/transferring-an-issue-to-another-repository)." -### Leia mais +### Further reading -- "[Convidar colaboradores para um repositório pessoal](/articles/inviting-collaborators-to-a-personal-repository)" -- "[Níveis de permissão do repositório para uma organização](/articles/repository-permission-levels-for-an-organization)" +- "[Inviting collaborators to a personal repository](/articles/inviting-collaborators-to-a-personal-repository)" +- "[Repository permission levels for an organization](/articles/repository-permission-levels-for-an-organization)" diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address.md b/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address.md index ccc566adc1c4..71f099cf3285 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address.md @@ -21,7 +21,7 @@ O {% data variables.product.product_name %} usa o endereço de e-mail do commit Para operações do Git baseadas na web, você pode configurar o endereço de e-mail do commit no {% data variables.product.product_name %}. Para commits cujo push é feito usando a linha de comando, você pode configurar o endereço de e-mail do commmit no Git. -{% if currentVersion == "free-pro-team@latest" %}Os commits feitos antes da alteração do endereço de e-mail do commit continuarão associados ao endereço de e-mail anterior.{% else %}Depois de alterar o endereço de e-mail do commit no {% data variables.product.product_name %}, o novo endereço de e-mail ficará visível por padrão em todas as próximas operações do Git baseadas na web. Os commits feitos antes da alteração do endereço de e-mail do commit continuarão associados ao endereço de e-mail anterior.{% endif %} +{% if currentVersion == "free-pro-team@latest" %}Todos os commits que você fez antes de alterar o seu endereço de e-mail de commit ainda estão associados ao seu endereço de e-mail anterior.{% else %}Depois de alterar o seu endereço de e-mail de commit no dia {% data variables.product.product_name %}, o novo endereço de e-mail ficará visível em todas as suas operações futuras baseadas na web do Git por padrão. Os commits feitos antes da alteração do endereço de e-mail do commit continuarão associados ao endereço de e-mail anterior.{% endif %} {% if currentVersion == "free-pro-team@latest" %} @@ -33,11 +33,11 @@ Para operações do Git baseadas na web, você pode configurar o endereço de e- {% endif %} -{% if currentVersion == "free-pro-team@latest" %}Se não quiser usar seu endereço de e-mail pessoal, você poderá usar um endereço de e-mail `no-reply` fornecido pelo {% data variables.product.product_name %} como o endereço de e-mail do commit. Para usar o endereço de e-mail `noreply` para commits cujo push é feito usando a linha de comando, use esse endereço de e-mail ao configurar o endereço de e-mail do commit no Git. Para usar o endereço `noreply` para operações do Git baseadas na web, configure o endereço de e-mail do commit no GitHub e selecione **Keep my email address private** (Manter meu endereço de e-mail privado). +{% if currentVersion == "free-pro-team@latest" %}Se você desejar manter o seu endereço de e-mail pessoal privado, você poderá usar um endereço de e-mail `no-reply` fornecido por {% data variables.product.product_name %} como seu endereço de e-mail de commit. Para usar o endereço de e-mail `noreply` para commits cujo push é feito usando a linha de comando, use esse endereço de e-mail ao configurar o endereço de e-mail do commit no Git. Para usar o endereço `noreply` para operações do Git baseadas na web, configure o endereço de e-mail do commit no GitHub e selecione **Keep my email address private** (Manter meu endereço de e-mail privado). Você também pode optar por bloquear os commits cujo push é feito usando a linha de comando que expõem seu endereço de e-mail pessoal. Para obter mais informações, consulte "[Bloquear pushes de linha de comando que mostrem endereços de e-mail pessoais](/articles/blocking-command-line-pushes-that-expose-your-personal-email-address)".{% endif %} -Para garantir que os commits sejam atribuídos a você e apareçam no gráfico de contribuições, use um endereço de e-mail que tenha [adicionado à conta do GitHub](/articles/adding-an-email-address-to-your-github-account/){% if currentVersion == "free-pro-team@latest" %} ou o endreço de e-mail `noreply` fornecido pelo {% data variables.product.product_name %} nas configurações do e-mail{% endif %}. +Para garantir que os commits sejam atribuídos a você e que apareçam no seu gráfico de contribuições, use um endereço de e-mail que você [adicionou à sua conta do GitHub](/articles/adding-an-email-address-to-your-github-account/){% if currentVersion == "free-pro-team@latest" %} ou o endereço de e-mail `noreply` fornecido por {% data variables.product.product_name %} nas suas configurações de e-mail{% endif %}. {% if currentVersion == "free-pro-team@latest" %} diff --git a/translations/pt-BR/content/github/site-policy/github-acceptable-use-policies.md b/translations/pt-BR/content/github/site-policy/github-acceptable-use-policies.md index 1bc86fd45979..7751adda5d11 100644 --- a/translations/pt-BR/content/github/site-policy/github-acceptable-use-policies.md +++ b/translations/pt-BR/content/github/site-policy/github-acceptable-use-policies.md @@ -66,14 +66,14 @@ Qualquer pessoa, entidade ou serviço que colete dados do Serviço deve estar em ### 7. Uso excessivo da largura de banda As limitações de largura de banda do Serviço variam com base nos recursos que você usa. Se constatarmos que seu uso de largura de banda é significativamente excessivo em relação a outros usuários com recursos similares, reservamos o direito de suspender sua Conta, reduzir a hospedagem de seu arquivo ou até mesmo limitar sua atividade até que você possa reduzir seu consumo de largura de banda. Também reservamos o direito — depois de fornecer aviso prévio — de excluir repositórios que avaliamos estar colocando pressão indevida em nossa infraestrutura. Para obter orientação sobre o uso aceitável do armazenamento de objetos em repositórios, consulte "[Qual é a minha cota de disco?](/github/managing-large-files/what-is-my-disk-quota)". Para obter mais detalhes sobre as limitações de largura de banda de recursos específicos, consulte os [Termos Adicionais do Produto GitHub](/github/site-policy/github-additional-product-terms). -### 8. Advertising on GitHub +### 8. Publicidade no GitHub **Versão reduzida:***Geralmente não proibimos o uso do GitHub para publicidade. No entanto, esperamos que nossos usuários sigam certas limitações, de forma que o GitHub não se torne um paraíso do spam. Ninguém quer isso.* Embora entendamos que você pode querer promover seu Conteúdo publicando nomes de patrocinadores ou logotipos em sua Conta, o foco principal do Conteúdo postado em ou através de sua Conta para o Serviço não deve ser a publicidade ou o marketing promocional. Isto inclui Conteúdo publicado em ou através de Pages, pacotes, repositórios e todas as outras partes do Serviço. Você pode incluir imagens estáticas, links e texto promocional nos documentos LEIAME ou seções de descrição do projeto associadas à sua Conta, mas eles devem estar relacionados ao projeto que você está hospedando no GitHub. Você não pode fazer propaganda em Contas de outros Usuários, por exemplo, postando conteúdo em massa excessivo ou monetizado em "problemas". Você não pode promover ou distribuir conteúdo ou atividade ilegal ou proibida por nossos [Termos de Serviço](/github/site-policy/github-terms-of-service/), [Diretrizes da Comunidade](/github/site-policy/github-community-guidelines/), ou [Política de Uso Aceitável](/github/site-policy/github-acceptable-use-policies/), incluindo a atividade em massa excessiva automatizada (por exemplo, spamming), esquemas do tipo fique rico rápido e erros de representação ou armadilhas relacionados com sua promoção. -Se você decidir postar quaisquer materiais promocionais em sua Conta, você é o único responsável por cumprir todas as leis e regulamentos aplicáveis, inclusive, sem limitações, as Diretrizes da Comissão Federal de Comércio dos EUA sobre Endossos e Depoimentos. Federal Trade Commission's Guidelines on Endorsements and Testimonials. Nós nos reservamos o direito de remover quaisquer materiais promocionais ou anúncios que, a nosso exclusivo critério, violem quaisquer termos ou políticas do GitHub. +Se você decidir postar quaisquer materiais promocionais em sua Conta, você é o único responsável por cumprir todas as leis e regulamentos aplicáveis, inclusive, sem limitações, as Diretrizes da Comissão Federal de Comércio dos EUA sobre Endossos e Depoimentos. Diretrizes da Comissão Federal do Comércio sobre Recomendações e Depoimentos. Nós nos reservamos o direito de remover quaisquer materiais promocionais ou anúncios que, a nosso exclusivo critério, violem quaisquer termos ou políticas do GitHub. ### 9. Spam e Atividade Inautêntica no GitHub Atividade em massa excessiva automatizada e atividade coordenada inautêntica, como spamming, são proibidas no GitHub. As atividades proibidas incluem: diff --git a/translations/pt-BR/content/github/site-policy/github-additional-product-terms.md b/translations/pt-BR/content/github/site-policy/github-additional-product-terms.md index c6713782da0a..0ac38489f844 100644 --- a/translations/pt-BR/content/github/site-policy/github-additional-product-terms.md +++ b/translations/pt-BR/content/github/site-policy/github-additional-product-terms.md @@ -42,11 +42,11 @@ O GitHub Pages está sujeito a limites específicos de uso e largura de banda e ### 5. Ações e Pacotes #### a. Uso das Ações -As Ações GitHub permitem criar fluxos de trabalho personalizados do ciclo de vida de desenvolvimento de softwares diretamente no seu repositório GitHub. Cada Conta vem com quantidades de computação e armazenamento incluídas para uso com Ações, dependendo do seu plano de conta, que podem ser encontradas na [documentação de Ações](/github/automating-your-workflow-with-github-actions/about-github-actions#about-github-actions). O uso de computação de suas Ações está disponível em [suas configurações de Conta](https://github.com/settings/billing), e você será notificado por e-mail antes de atingir o limite das quantidades incluídas. Se você deseja usar ações além das quantidades incluídas, poderá [permitir excedentes](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions). +As Ações GitHub permitem criar fluxos de trabalho personalizados do ciclo de vida de desenvolvimento de softwares diretamente no seu repositório GitHub. Cada Conta vem com quantidades de computação e armazenamento incluídas para uso com Ações, dependendo do seu plano de conta, que podem ser encontradas na [documentação de Ações](/actions). O uso de computação de suas Ações está disponível em [suas configurações de Conta](https://github.com/settings/billing), e você será notificado por e-mail antes de atingir o limite das quantidades incluídas. Se você deseja usar ações além das quantidades incluídas, poderá [permitir excedentes](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions). -O uso da computação para quantidades incluídas e pagas é calculado em minutos, com base no tipo de Ações que você executa (por exemplo, Linux, Windows, macOS). Os minutos usados ​​para cada trabalho ou tarefa da Ação serão arredondados para o minuto mais próximo. Para quantidades incluídas e dependendo do tipo de Ação, um multiplicador pode ser aplicado à quantidade de tempo usada para executar cada tarefa ou trabalho, antes de ser arredondada para o minuto mais próximo. Minutos excedentes são cobrados na [base de preço por minuto](https://github.com/features/actions) nos tipos de Ações que você executa. Ações e Pacotes compartilham armazenamento e seu uso de armazenamento é mostrado nas [configurações de conta](https://github.com/settings/billing). Para obter detalhes adicionais sobre os cálculos de uso da quantidade, consulte a [documentação de Ações](/github/automating-your-workflow-with-github-actions/about-github-actions#about-github-actions). +O uso da computação para quantidades incluídas e pagas é calculado em minutos, com base no tipo de Ações que você executa (por exemplo, Linux, Windows, macOS). Os minutos usados ​​para cada trabalho ou tarefa da Ação serão arredondados para o minuto mais próximo. Para quantidades incluídas e dependendo do tipo de Ação, um multiplicador pode ser aplicado à quantidade de tempo usada para executar cada tarefa ou trabalho, antes de ser arredondada para o minuto mais próximo. Minutos excedentes são cobrados na [base de preço por minuto](https://github.com/features/actions) nos tipos de Ações que você executa. Ações e Pacotes compartilham armazenamento e seu uso de armazenamento é mostrado nas [configurações de conta](https://github.com/settings/billing). Para obter informações adicionais sobre os cálculos de uso de quantidade incluída, consulte a [documentação de Ações](/actions). -Ações e quaisquer elementos do serviço de Ação não podem ser usados ​​em violação ao Acordo, à [Política de Uso Aceitável](/github/site-policy/github-acceptable-use-policies), ou às [limitações de serviço](/github/automating-your-workflow-with-github-actions/about-github-actions#usage-limits) das Ações do GitHub. Além disso, as Ações não devem ser usadas para: +Ações e quaisquer elementos do serviço de Ação não podem ser usados ​​em violação ao Acordo, à [Política de Uso Aceitável](/github/site-policy/github-acceptable-use-policies), ou às [limitações de serviço](/actions/reference/usage-limits-billing-and-administration/#usage-limits) das Ações do GitHub. Além disso, as Ações não devem ser usadas para: - mineração de criptomoedas; - usar nossos servidores para interromper ou ganhar ou tentar ganhar acesso não autorizado a qualquer serviço, dispositivo, dados, conta ou rede (a menos que autorizado pelo [programa GitHub Bug Bounty](https://bounty.github.com)) - fornecimento de um aplicativo ou serviço independente ou integrado que ofereça Ações ou quaisquer elementos de Ações para fins comerciais; diff --git a/translations/pt-BR/content/github/site-policy/github-and-trade-controls.md b/translations/pt-BR/content/github/site-policy/github-and-trade-controls.md index f1e62285754b..adf108e0203c 100644 --- a/translations/pt-BR/content/github/site-policy/github-and-trade-controls.md +++ b/translations/pt-BR/content/github/site-policy/github-and-trade-controls.md @@ -9,25 +9,25 @@ versions: free-pro-team: '*' --- -GitHub.com, GitHub Enterprise Server, e as informações que você enviar para qualquer produto podem estar sujeitas a regulamentações de controle de negociação, inclusive sob Regulamentos da Administração de Exportação dos EUA (EAR). Export Administration Regulations (the EAR). +GitHub.com, GitHub Enterprise Server, e as informações que você enviar para qualquer produto podem estar sujeitas a regulamentações de controle de negociação, inclusive sob Regulamentos da Administração de Exportação dos EUA (EAR). Regulamentos Administrativos de Exportação (EAR). O objetivo do GitHub é ser a plataforma global para a colaboração de desenvolvedores, não importa onde os desenvolvedores estiverem. Levamos a sério a nossa responsabilidade de examinar minuciosamente as ordens governamentais para ter a certeza de que os usuários e clientes não sejam impactados para além do que seja exigido por lei. Isso inclui manter serviços de repositórios públicos, incluindo os destinados a projetos de código aberto, disponíveis e acessíveis para apoiar comunicações pessoais que envolvam desenvolvedores em regiões sancionadas. -To comply with U.S. Para cumprir as leis de controle de negociação dos EUA, o GitHub realizou algumas alterações necessárias na forma como conduzimos nossos serviços. As U.S. trade controls laws evolve, we will continue to work with U.S. À medida que as leis de controle de negociação dos EUA evoluem, continuaremos a trabalhar com os reguladores dos EUA para saber em que medida podemos oferecer serviços gratuitos de colaboração em código aos desenvolvedores de mercados sancionados. Acreditamos que oferecer esses serviços grátis apoia os EUA. Acreditamos que oferecer esses serviços gratuitos ajuda a política externa dos EUA de incentivo ao livre fluxo de informação e à liberdade de expressão nesses mercados. Para saber mais sobre nossa abordagem e como as sanções afetam a colaboração do software global, leia nosso [blog sobre sanções](https://github.blog/2019-09-12-global-software-collaboration-in-the-face-of-sanctions/). +Para estar em conformidade com os E.U.A. Para cumprir as leis de controle de negociação dos EUA, o GitHub realizou algumas alterações necessárias na forma como conduzimos nossos serviços. Como as leis de controle de comércio evoluem, continuaremos a trabalhar com as leis À medida que as leis de controle de negociação dos EUA evoluem, continuaremos a trabalhar com os reguladores dos EUA para saber em que medida podemos oferecer serviços gratuitos de colaboração em código aos desenvolvedores de mercados sancionados. Acreditamos que oferecer esses serviços grátis apoia os EUA. Acreditamos que oferecer esses serviços gratuitos ajuda a política externa dos EUA de incentivo ao livre fluxo de informação e à liberdade de expressão nesses mercados. Para saber mais sobre nossa abordagem e como as sanções afetam a colaboração do software global, leia nosso [blog sobre sanções](https://github.blog/2019-09-12-global-software-collaboration-in-the-face-of-sanctions/). -Embora tenhamos fornecido as seguintes informações para sua conveniência, em última análise, é sua responsabilidade garantir que o seu uso de produtos e serviços GitHub esteja de acordo com todas as leis e regulamentações aplicáveis, incluindo as leis de controle exportação dos EUA. export control laws. +Embora tenhamos fornecido as seguintes informações para sua conveniência, em última análise, é sua responsabilidade garantir que o seu uso de produtos e serviços GitHub esteja de acordo com todas as leis e regulamentações aplicáveis, incluindo as leis de controle exportação dos EUA. de controle de exportação dos EUA. ### Panorama da exportação #### GitHub.com -De acordo com nossos [Termos de Serviço](/articles/github-terms-of-service), os usuários só podem acessar e usar o GitHub.com em conformidade com a lei aplicável, incluindo as leis de controle de exportação e sanções dos EUA. export control and sanctions laws. +De acordo com nossos [Termos de Serviço](/articles/github-terms-of-service), os usuários só podem acessar e usar o GitHub.com em conformidade com a lei aplicável, incluindo as leis de controle de exportação e sanções dos EUA. leis de controle das exportações e sanções. -Os usuários são responsáveis por garantir que o conteúdo que eles desenvolvem e compartilham no GitHub.com esteja em conformidade com as leis de controle de exportação dos EUA, incluindo o EAR e os Regulamentos de Tráfego Internacional de Armas dos EUA (ITAR). export control laws, including the EAR and the U.S. International Traffic in Arms Regulations (ITAR). A oferta de serviço hospedado na nuvem disponível no [GitHub.com](https://github.com) não foi projetado para hospedar dados sujeitos ao ITAR e, atualmente, não oferece a capacidade de restringir o acesso a repositório por país. Se você estiver procurando colaborar em ITAR ou em outros dados controlados por exportação, recomendamos que você considere o [GitHub Enterprise Server](https://enterprise.github.com), a oferta local do GitHub. +Os usuários são responsáveis por garantir que o conteúdo que eles desenvolvem e compartilham no GitHub.com esteja em conformidade com as leis de controle de exportação dos EUA, incluindo o EAR e os Regulamentos de Tráfego Internacional de Armas dos EUA (ITAR). leis de controle de exportação, incluindo a EAR e os EUA Tráfego Internacional em Regulamentos de Armas (ITAR). A oferta de serviço hospedado na nuvem disponível no [GitHub.com](https://github.com) não foi projetado para hospedar dados sujeitos ao ITAR e, atualmente, não oferece a capacidade de restringir o acesso a repositório por país. Se você estiver procurando colaborar em ITAR ou em outros dados controlados por exportação, recomendamos que você considere o [GitHub Enterprise Server](https://enterprise.github.com), a oferta local do GitHub. -EUA As leis de controle de negociação dos EUA restringem quais serviços o GitHub.com pode tornar disponíveis para usuários em determinados países e territórios. GitHub may allow users in or ordinarily resident in countries and territories subject to U.S. O GitHub pode permitir que usuários que residem normalmente em países e territórios sujeitos a sanções dos EUA acessem determinados serviços GitHub.com gratuitos para comunicação pessoal, de acordo com autorizações emitidas pelo Departamento de Controle de Ativos Estrangeiros do Departamento do Tesouro dos EUA (OFAC). Treasury Department’s Office of Foreign Assets Controls (OFAC). Pessoas localizadas ou normalmente residentes nesses países e territórios são proibidas de usar proxies de IP, VPNs, ou outros métodos para disfarçar sua localização ao acessar os serviços do GitHub.com para comunicações não comerciais e pessoais. +EUA As leis de controle de negociação dos EUA restringem quais serviços o GitHub.com pode tornar disponíveis para usuários em determinados países e territórios. O GitHub pode permitir aos usuários que residem normalmente em países e territórios sujeitos aos E.U.A. O GitHub pode permitir que usuários que residem normalmente em países e territórios sujeitos a sanções dos EUA acessem determinados serviços GitHub.com gratuitos para comunicação pessoal, de acordo com autorizações emitidas pelo Departamento de Controle de Ativos Estrangeiros do Departamento do Tesouro dos EUA (OFAC). Gabinete do Tesouro de Controle de Ativos Externos (OFAC). Pessoas localizadas ou normalmente residentes nesses países e territórios são proibidas de usar proxies de IP, VPNs, ou outros métodos para disfarçar sua localização ao acessar os serviços do GitHub.com para comunicações não comerciais e pessoais. -Specially Designated Nationals (SDNs) and other denied or blocked parties under U.S. Nacionais Especialmente Designados (SDNs) e outros grupos negados ou bloqueados pelas leis dos EUA e outras aplicáveis são proibidos de acessar ou usar o GitHub.com. Além disso, os usuários não podem usar o GitHub.com para ou em nome de tais entidades, incluindo os governos de países sancionados. Além disso, GitHub.com não pode ser utilizado para fins proibidos conforme as leis de controle de exportação aplicáveis, incluindo usos finais proibidos descritos em [17 CFR 744](https://www.ecfr.gov/cgi-bin/text-idx?SID=ad384e1f1e017076f8c0136f322f0a4c&mc=true&node=pt15.2.744&rgn=div5). +Nacionais Designados Especialmente (SDNs) e outras partes negadas ou bloqueadas nos termos dos EUA Nacionais Especialmente Designados (SDNs) e outros grupos negados ou bloqueados pelas leis dos EUA e outras aplicáveis são proibidos de acessar ou usar o GitHub.com. Além disso, os usuários não podem usar o GitHub.com para ou em nome de tais entidades, incluindo os governos de países sancionados. Além disso, GitHub.com não pode ser utilizado para fins proibidos conforme as leis de controle de exportação aplicáveis, incluindo usos finais proibidos descritos em [17 CFR 744](https://www.ecfr.gov/cgi-bin/text-idx?SID=ad384e1f1e017076f8c0136f322f0a4c&mc=true&node=pt15.2.744&rgn=div5). #### GitHub Enterprise Server @@ -39,7 +39,7 @@ O GitHub Enterprise Server não pode ser vendido, exportado ou reexportado para ### Perguntas frequentes -#### Em que países e territórios são aplicadas sanções governamentais dos EUA? government sanctions applied? +#### Em que países e territórios são aplicadas sanções governamentais dos EUA? aplicadas sanções governamentais? Crimeia, Cuba, Irã, Coreia do Norte e Síria. @@ -47,7 +47,7 @@ Crimeia, Cuba, Irã, Coreia do Norte e Síria. No caso raro de uma conta ser afetada não intencionalmente ou por engano, temos um processo de apelação para abordar essas instâncias. -Se um usuário individual ou administrador de organização acredita ter sido erroneamente sinalizado, então esse usuário tem a oportunidade de recorrer do sinalizador, fornecendo informações de verificação ao GitHub. Se o GitHub receber informações suficientes para verificar se o usuário ou a organização não estão afiliados a uma jurisdição sancionada ou restrita por sanções econômicas dos EUA, então o sinalizador será removido. economic sanctions, then the flag will be removed. Por favor, consulte o [formulário de solicitação de apelação para conta individual](https://airtable.com/shrGBcceazKIoz6pY) e o [formulário de solicitação de apelação para conta organizacional](https://airtable.com/shrB2je5RBkqLEt5D). +Se um usuário individual ou administrador de organização acredita ter sido erroneamente sinalizado, então esse usuário tem a oportunidade de recorrer do sinalizador, fornecendo informações de verificação ao GitHub. Se o GitHub receber informações suficientes para verificar se o usuário ou a organização não estão afiliados a uma jurisdição sancionada ou restrita por sanções econômicas dos EUA, então o sinalizador será removido. sanções econômicas. Portanto, o sinalizador será removido. Por favor, consulte o [formulário de solicitação de apelação para conta individual](https://airtable.com/shrGBcceazKIoz6pY) e o [formulário de solicitação de apelação para conta organizacional](https://airtable.com/shrB2je5RBkqLEt5D). #### A viagem para essas regiões pode ser impactada? @@ -57,7 +57,7 @@ Viajar para essas regiões pode impactar o status de sua conta, mas a disponibil O GitHub está comprometido em continuar a oferecer serviços gratuitos de repositório público para desenvolvedores com contas individuais e organizacionais em regiões sancionadas pelos EUA. Isso inclui acesso limitado a serviços gratuitos, como repositórios públicos para projetos de código aberto (e páginas públicas associadas), gists públicos e minutos de Ação gratuitos alocados, apenas para comunicações pessoais, e não para fins comerciais. -However, due to U.S. Devido às restrições legais de controles comerciais dos EUA, o GitHub não pode fornecer serviços de repositório privados e serviços pagos a contas em regiões sancionadas pelos EUA. sanctioned regions like North Korea, Iran, Syria, and Crimea. A restrição suspende o acesso a serviços de repositório privados e serviços pagos, como disponibilidade de repositórios privados gratuitos ou pagos, gists secretas, minutos de Ação pagos, Sponsors (patrocinadores) e serviços do GitHub Marketplace. +No entanto, devido aos Estados Unidos Devido às restrições legais de controles comerciais dos EUA, o GitHub não pode fornecer serviços de repositório privados e serviços pagos a contas em regiões sancionadas pelos EUA. regiões sancionadas como a Coreia do Norte, o Irã, Síria e a Crimeia. A restrição suspende o acesso a serviços de repositório privados e serviços pagos, como disponibilidade de repositórios privados gratuitos ou pagos, gists secretas, minutos de Ação pagos, Sponsors (patrocinadores) e serviços do GitHub Marketplace. Para contas organizacionais pagas, os usuários podem ter acesso limitado aos seus repositórios públicos, que foram rebaixados para repositórios arquivados somente leitura. Para contas organizacionais gratuitas em regiões sancionadas, no entanto, os usuários continuarão a ter acesso total a repositórios públicos gratuitos para projetos de código aberto (e Páginas públicas associadas), gists públicos e minutos de Ação alocados gratuitos. @@ -65,11 +65,11 @@ O GitHub continuará defendendo junto com os EUA. O GitHub continuará defendend #### Como você define esses usuários específicos? -Se o GitHub determinar que um usuário ou cliente está localizado em uma região sujeita às restrições de controle de negociação dos EUA, ou que um usuário está restrito pelas sanções econômicas dos EUA, então a conta afiliada será limitada para cumprir esses requisitos legais. trade control restrictions, or a user is otherwise restricted under U.S. economic sanctions, then the affiliated account has been restricted to comply with those legal requirements. A determinação da localização do usuário e cliente para implementar essas restrições legais deriva de várias fontes, incluindo endereços IP e histórico de pagamentos. A nacionalidade e a etnia não são utilizadas para sinalizar usuários para restrições de sanções. +Se o GitHub determinar que um usuário ou cliente está localizado em uma região sujeita às restrições de controle de negociação dos EUA, ou que um usuário está restrito pelas sanções econômicas dos EUA, então a conta afiliada será limitada para cumprir esses requisitos legais. restrições de controle comercial, ou um usuário tem restrições de outra forma nos EUA sanções econômicas. Portanto a conta afiliada foi restrita para cumprir esses requisitos legais. A determinação da localização do usuário e cliente para implementar essas restrições legais deriva de várias fontes, incluindo endereços IP e histórico de pagamentos. A nacionalidade e a etnia não são utilizadas para sinalizar usuários para restrições de sanções. #### Como as contas da organização são impactadas? -Se uma organização tiver sede em, ou as principais pessoas ou membros de uma organização mostram laços suficientes a, um território ou país sancionado, ou se a organização parecer estar sujeita às sanções econômicas dos EUA, então a conta da organização e a conta do proprietário afiliado serão limitadas. economic sanctions, then the organization account and the affiliated owner account will be restricted. +Se uma organização tiver sede em, ou as principais pessoas ou membros de uma organização mostram laços suficientes a, um território ou país sancionado, ou se a organização parecer estar sujeita às sanções econômicas dos EUA, então a conta da organização e a conta do proprietário afiliado serão limitadas. sanções econômicas e, posteriormente, a conta de organização e a conta de proprietário afiliado serão restritas. A restrição suspende o acesso a serviços de repositório privados e serviços pagos, como disponibilidade de repositórios privados gratuitos ou pagos, gists secretas, minutos de Ação pagos, Sponsors (patrocinadores) e serviços do GitHub Marketplace. Para contas organizacionais pagas associadas com regiões sancionadas, os usuários podem ter acesso limitado aos seus repositórios públicos, que foram rebaixados para repositórios arquivados somente leitura. Para contas organizacionais gratuitas em regiões sancionadas, os usuários continuarão a ter acesso total a repositórios públicos gratuitos para projetos de código aberto (e Páginas públicas associadas), gists públicos e minutos de Ação alocados gratuitos. @@ -79,5 +79,5 @@ Os usuários de contas individuais gratuitas podem tornar repositórios privados #### Os usuários restritos à negociação podem acessar dados de repositório privado (por exemplo, baixando ou excluindo dados do repositório)? -Infelizmente, a nossa interpretação da lei não nos dá a opção de permitir downloads ou exclusão de conteúdo de repositórios privados até que seja autorizado de outra forma pelo governo dos EUA. government. We will strongly advocate, with U.S. Defenderemos, fortemente, junto dos órgãos reguladores dos EUA, o direito de usuários restritos à negociação protegerem o conteúdo de seus repositórios privados. Também defenderemos uma maior disponibilidade de serviços do GitHub para desenvolvedores em mercados sancionados, e reforçaremos ainda mais a importância da colaboração de códigos no apoio a comunicações pessoais para desenvolvedores em todo o mundo. +Infelizmente, a nossa interpretação da lei não nos dá a opção de permitir downloads ou exclusão de conteúdo de repositórios privados até que seja autorizado de outra forma pelo governo dos EUA. governo. Defenderemos energicamente com os EUA. Defenderemos, fortemente, junto dos órgãos reguladores dos EUA, o direito de usuários restritos à negociação protegerem o conteúdo de seus repositórios privados. Também defenderemos uma maior disponibilidade de serviços do GitHub para desenvolvedores em mercados sancionados, e reforçaremos ainda mais a importância da colaboração de códigos no apoio a comunicações pessoais para desenvolvedores em todo o mundo. diff --git a/translations/pt-BR/content/github/site-policy/github-community-forum-code-of-conduct.md b/translations/pt-BR/content/github/site-policy/github-community-forum-code-of-conduct.md index 50eb5e541393..69dc8e1ad957 100644 --- a/translations/pt-BR/content/github/site-policy/github-community-forum-code-of-conduct.md +++ b/translations/pt-BR/content/github/site-policy/github-community-forum-code-of-conduct.md @@ -60,7 +60,7 @@ As seguintes regras não são rígidas, elas apenas auxiliam no julgamento human #### *O que não é permitido* -- **Ameaças de violência.** Você não pode ameaçar e ser violento com terceiros ou usar o site para organizar, promover ou incitar atos de violência ou terrorismo no mundo real. Pense cuidadosamente sobre as palavras que você usa, as imagens que você publica, e até mesmo o software que você escreve, e como podem ser interpretados pelos outros. Mesmo que pretenda fazer uma piada, isso poderá ser interpretado de outra forma. If you think that someone else might interpret the content you post as a threat, or as promoting violence or terrorism, stop. Não publique isso. Em casos excepcionais, podemos relatar ameaças de violência às autoridades competentes, se acreditarmos que pode haver um risco genuíno de danos físicos ou uma ameaça à segurança pública. +- **Ameaças de violência.** Você não pode ameaçar e ser violento com terceiros ou usar o site para organizar, promover ou incitar atos de violência ou terrorismo no mundo real. Pense cuidadosamente sobre as palavras que você usa, as imagens que você publica, e até mesmo o software que você escreve, e como podem ser interpretados pelos outros. Mesmo que pretenda fazer uma piada, isso poderá ser interpretado de outra forma. Se você acha que outra pessoa pode interpretar o conteúdo que você postou como uma ameaça, ou como uma promoção da violência ou como terrorismo, pare. Não publique isso. Em casos excepcionais, podemos relatar ameaças de violência às autoridades competentes, se acreditarmos que pode haver um risco genuíno de danos físicos ou uma ameaça à segurança pública. - **Discurso de ódio e discriminação.** Embora não seja proibido abordar temas como idade, tamanho corporal, deficiência, etnia, identidade de gênero e expressão, nível de experiência, nacionalidade, aparência pessoal, raça, religião ou identidade e orientação sexual, não toleramos discursos que ataquem uma pessoa ou grupo de pessoas com base em quem são. Apenas perceba que falar sobre esses ou outros tópicos sensíveis pode fazer com que outros se sintam indesejáveis, ou talvez até mesmo inseguros, se abordados de forma agressiva ou insultante. Esperamos que os nossos membros da Comunidade sejam respeitosos quando discutirem temas sensíveis. diff --git a/translations/pt-BR/content/github/site-policy/github-corporate-terms-of-service.md b/translations/pt-BR/content/github/site-policy/github-corporate-terms-of-service.md index a16817495edc..1c8491c84e35 100644 --- a/translations/pt-BR/content/github/site-policy/github-corporate-terms-of-service.md +++ b/translations/pt-BR/content/github/site-policy/github-corporate-terms-of-service.md @@ -99,7 +99,7 @@ Para criar uma conta, o Cliente deve atender às seguintes condições: * O login de um Usuário não pode ser compartilhado por várias pessoas. -- Customer must not use the Products (a) in violation of export control or sanctions laws of the United States or any other applicable jurisdiction; (b) if it is located in or ordinarily resident in a country or territory subject to comprehensive to comprehensive sanctions administered by the U.S. Office of Foreign Assets Control (OFAC); or (c) if it is or is working on behalf of a [Specially Designated National (SDN)](https://www.treasury.gov/resource-center/sanctions/SDN-List/Pages/default.aspx) or a person subject to similar blocking or denied party prohibitions. Para obter mais informações, por favor veja nossa [política de Controles de Exportação](/articles/github-and-export-controls). +- O cliente não deve utilizar os Produtos (a) em violação do controle das exportações ou da legislação sancionatória dos Estados Unidos ou de qualquer outra jurisdição aplicável; (b) se estiver localizado ou normalmente domiciliado em país ou território sujeito a sanções abrangentes administradas pelo governo dos EUA. O Escritório e Controle de Ativos Estrangeiros (OFAC); ou (c) se estiver trabalhando em nome de uma [Nacional Especialmente Designado (SDN)](https://www.treasury.gov/resource-center/sanctions/SDN-List/Pages/default.aspx) ou de pessoa sujeita a bloqueios semelhantes ou proibições de partes negadas. Para obter mais informações, por favor veja nossa [política de Controles de Exportação](/articles/github-and-export-controls). #### 3. Segurança da conta O Cliente é responsável por: (i) todo o Conteúdo publicado e a atividade que ocorre sob sua Conta Corporativa; (ii) manter a segurança de suas credenciais de login da conta; e (iii) [prontamente notificar o GitHub](https://github.com/contact) após tomar conhecimento de qualquer uso ou acesso não autorizado do Serviço através de sua conta. O GitHub não será responsabilizado por qualquer perda ou dano causado se o Cliente não cumprir o disposto nesta Seção B. @@ -111,9 +111,9 @@ Em algumas situações, os termos de terceiros podem ser aplicados ao uso do Git Se o cliente é dos EUA. Se o Cliente for uma entidade do governo dos EUA ou que acessa ou usa o Serviço em instalações governamentais, a [Emenda do Governo Federal dos EUA](https://help.github.com/articles/amendment-to-github-terms-of-service-applicable-to-us-federal-government-users) se aplicará e o Cliente concorda com as disposições dela. Aplica-se a alteração do Governo Federal e o Cliente concorda com suas disposições. #### 6. Acordo de Nível de Serviço de Nuvem Empresarial -GitHub’s quarterly uptime commitment for GitHub Enterprise Cloud is provided in the [Enterprise Service Level Agreement](/github/site-policy/github-enterprise-service-level-agreement). If Customer signed up for GitHub Enterprise Cloud, then Customer will be entitled to a service credit if GitHub does not meet its service level. +O compromisso trimestral de tempo de atividade do GitHub para o GitHub Enterprise Cloud é fornecido no [Contrato de Nível de Serviço Empresarial](/github/site-policy/github-enterprise-service-level-agreement). Se o cliente inscreveu-se no GitHub Enterprise Cloud, ele terá direito a um crédito de serviço se o GitHub não atender ao seu nível de serviço. -### C. Compliance with Laws; Acceptable Use; Privacy +### C. Cumprimento das leis; Uso aceitável; Privacidade #### 1. Cumprimento de leis e regulamentos O uso dos Produtos pelo Cliente não deve violar quaisquer leis aplicáveis, inclusive leis de direitos autorais ou de marcas registradas, leis de controle de exportação ou regulamentos em sua jurisdição. @@ -124,29 +124,29 @@ O uso do Serviço pelo Cliente deve estar em conformidade com a [Política de Us #### 3. Privacidade A [Declaração de Privacidade do GitHub](/articles/github-privacy-statement) e o [Adendo de Proteção de Dados do GitHub](/github/site-policy/github-data-protection-addendum) fornecem aviso detalhado das práticas de privacidade e uso de dados do GitHub, bem como do processamento e das obrigações de segurança do GitHub no que diz respeito aos Dados Pessoais do Cliente. Qualquer pessoa, entidade ou serviço que colete dados do Serviço deve estar em conformidade com a Declaração de Privacidade do GitHub, especialmente no que diz respeito à coleta de Informações Pessoais dos Usuários (conforme definido na Declaração de Privacidade do GitHub). Se o Cliente coletar qualquer Informação pessoal do usuário no GitHub, só a utilizará para a finalidade para a qual o Usuário externo o autorizou. O Cliente protegerá essas Informações pessoais, e o Cliente responderá prontamente a reclamações, solicitações de remoção e pedidos para "não contatar" do GitHub ou de Usuários externos. -### D. Content Responsibility; Ownership; License Rights +### D. Responsabilidade pelo conteúdo; Propriedade; Direitos de licença #### 1. Responsabilidade pelo conteúdo gerado pelo usuário O Cliente pode criar ou fazer upload do Conteúdo gerado pelo usuário ao usar o Serviço. O Cliente é o único responsável por qualquer Conteúdo Gerado pelo Usuário que ele poste, faça upload, vincule ou disponibilize por meio do Serviço, independentemente da forma desse Conteúdo Gerado pelo Usuário. O GitHub não é responsável por qualquer exibição ao público ou uso indevido de Conteúdo gerado pelo usuário. -#### 2. Ownership of Content, Right to Post, and License Grants +#### 2. Propriedade do conteúdo, Direito de postar; Concessões de licença O Cliente mantém a propriedade do Conteúdo que o Cliente cria ou possui. O Cliente reconhece que: (a) é responsável pelo Conteúdo do cliente, (b) só enviará o Conteúdo que o Cliente tem direito de postar (como Conteúdo de terceiros ou gerados pelo Usuário), e (c) o Cliente cumprirá integralmente todas as licenças de terceiros relacionadas ao Conteúdo que o Cliente posta. O Cliente concede os direitos estabelecidos nas Seções D.3 a D.6, gratuitamente, e para as finalidades identificadas nessas seções até ao momento em que o Cliente remover o Conteúdo dos servidores do GitHub, exceto para Conteúdo que o Cliente tenha postado publicamente e que os Usuários Externos tenham bifurcado. Nesse caso, a licença será perpétua até que todas as Bifurcações do Conteúdo do Cliente tenham sido removidas dos servidores do GitHub. Se o Cliente fizer upload do Conteúdo do cliente que já vem com uma licença que concede ao GitHub as permissões necessárias para executar o Serviço, nenhuma licença adicional será necessária. #### 3. Concessão de licença para nós O Cliente concede ao GitHub o direito de armazenar, analisar e exibir o Conteúdo do cliente e fazer cópias acessórias somente conforme necessário para fornecer o Serviço. Isso inclui o direito de copiar o Conteúdo do cliente para o banco de dados do GitHub e fazer backups; exibir o Conteúdo do cliente para ele e para quem o Cliente resolver mostrá-lo; analisar o Conteúdo do cliente em um índice de pesquisa ou analisá-lo nos servidores do GitHub; compartilhar o Conteúdo do cliente com Usuários externos com os quais o Cliente opte por compartilhá-lo; e executar o Conteúdo do cliente caso seja algo como música ou vídeo. Esses direitos se aplicam a Repositórios públicos e privados. Esta licença não concede ao GitHub o direito de vender o Conteúdo do cliente, distribuí-lo ou utilizá-lo fora do Serviço. O Cliente concede ao GitHub os direitos de que precisa para usar o Conteúdo do cliente sem atribuição e fazer adaptações razoáveis dele, conforme necessário, para fornecer o Serviço. -#### 4. License Grant to External Users +#### 4. Concessão de licença a usuários externos Qualquer Conteúdo que o Cliente posta publicamente, como problemas, comentários e contribuições a repositórios de Usuários Externos, pode ser visualizado por outras pessoas. Ao definir quais repositórios serão visualizados publicamente, o Cliente concorda em permitir que Usuários externos visualizem e bifurquem os repositórios do Cliente. Se o Cliente define páginas e repositórios para serem visualizados publicamente, ele concede a Usuários Externos uma licença mundial e não exclusiva para usar, exibir e executar o Conteúdo do Cliente por meio do Serviço e reproduzi-lo exclusivamente no Serviço conforme permitido através da funcionalidade fornecida pelo GitHub (por exemplo, através de Bifurcação). O Cliente pode conceder mais direitos ao Conteúdo do Cliente se o Cliente adotar uma licença. Se o cliente estiver fazendo upload de um Conteúdo do cliente que ele não criou nem possuiu, será responsável por garantir que o Conteúdo do cliente carregado seja licenciado sob os termos que concedem essas permissões a Usuários externos #### 5. Contribuições na licença de repositório Sempre que o Cliente faz uma contribuição a um repositório que contém notificação de uma licença, o Cliente licencia essa contribuição nos mesmos termos e concorda que tem o direito de licenciá-la nesses termos. Se o Cliente tiver um contrato separado para licenciar as contribuições em termos diferentes, como um contrato de licença de colaborador, esse contrato será substituído. -#### 6. Moral Rights +#### 6. Direitos Morais O Cliente detém todos os direitos morais ao Conteúdo do cliente que ele carrega, publica ou envia para qualquer parte do Serviço, inclusive os direitos de integridade e atribuição. No entanto, o Cliente renuncia a esses direitos e concorda em não fazê-los valer contra o GitHub somente no intuito de permitir que o GitHub exerça razoavelmente os direitos concedidos na Seção D, mas não de outra forma. ### E. Repositórios privados -#### 1. Control +#### 1. Controle O Cliente é responsável por gerenciar o acesso a seus Repositórios Privados, incluindo convites, controle administrativo de Organizações e equipes e de acesso. #### 2. Confidencialidade @@ -155,21 +155,21 @@ O GitHub considera o Conteúdo do cliente nos Repositórios privados do Cliente #### 3. Access Os funcionários do GitHub só podem acessar os Repositórios Privados do Cliente (i) com o consentimento e o conhecimento do Cliente, para fins de suporte, ou (ii) quando o acesso for exigido por motivos de segurança. O Cliente pode optar por permitir o acesso adicional a seus Repositórios privados. Por exemplo, o Cliente pode habilitar vários serviços ou recursos do GitHub que exigem direitos adicionais ao Conteúdo do cliente em Repositórios privados. Esses direitos podem variar de acordo com o serviço ou recurso, mas o GitHub continuará a tratar o Conteúdo do cliente nos Repositórios privados do Cliente como Informações confidenciais do Cliente. Se esses serviços ou recursos exigirem direitos além dos necessários para oferecer o Serviço, o GitHub apresentará uma explicação sobre esses direitos. -#### 4. Exclusions +#### 4. Exclusões Se o GitHub tiver motivos para acreditar que o Conteúdo de um Repositório privado viola a lei ou o presente Contrato, o GitHub tem o direito de acessar, analisar e remover esse Conteúdo. Além disso, o GitHub pode ser [obrigado, por lei,](/github/site-policy/github-privacy-statement#for-legal-disclosure) a divulgar o Conteúdo dos Repositórios Privados do Cliente. A menos que estipulado de outra forma por requisitos dispostos na lei ou em resposta a uma ameaça à segurança ou outro risco para a segurança, o GitHub avisará sobre tais ações. ### F. Avisos de Propriedade Intelectual -#### 1. GitHub's Rights to Content +#### 1. Direitos do GitHub ao conteúdo A aparência do Serviço é Copyright © GitHub, Inc. Todos os direitos reservados. O Cliente não pode duplicar, copiar ou reutilizar qualquer parte dos elementos ou conceitos de design visual, JavaScript ou HTML/CSS sem a permissão expressa por escrito do GitHub. -#### 2. GitHub Trademarks and Logos +#### 2. Logotipos e marcas registradas do GitHub Se o Cliente quiser usar as marcas registradas do GitHub, deverá seguir todas as diretrizes de marca registrada do GitHub, inclusive aquelas na [página de logotipos do GitHub](https://github.com/logos). #### 3. Licença para as Políticas GitHub Este Contrato é licenciado sob a [Licença Creative Commons Zero](https://creativecommons.org/publicdomain/zero/1.0/). Para ver os detalhes, consulte nosso [repositório da Política do Site](https://github.com/github/site-policy#license). -#### 4. Copyright Infringement and DMCA Policy +#### 4. Violação de direitos autorais e política DMCA Se o Cliente for proprietário de direitos autorais e acreditar que o Conteúdo no Serviço viola os direitos autorais do Cliente, ele poderá notificar o GitHub de acordo com a [Lei dos Direitos Autorais do Milênio Digital](/articles/dmca-takedown-policy/) (DMCA – Digital Millenium Copyright Act Policy) usando o [Formulário DMCA](https://github.com/contact/dmca) ou pelo e-mail copyright@github.com. #### 5. Direitos de Propriedade Intelectual Reservados @@ -178,10 +178,10 @@ Como acordado entre as Partes, o GitHub possui todos os direitos, títulos e int ### G. Termos Adicionais do Produto GitHub Alguns recursos do Serviço podem estar sujeitos a termos adicionais definidos nos [Termos do Produto Adicional do GitHub](/github/site-policy/github-additional-product-terms). Ao acessar ou usar esses recursos, o Cliente concorda com os Termos do Produto Adicional do GitHub. -### H. Subscription Licenses +### H. Licenças de assinatura As Licenças de assinatura são concedidas por Usuário, e vários Usuários não podem usar a mesma Licença de assinatura. O Cliente só pode reatribuir uma Licença de assinatura a um novo Usuário após 90 (noventa) dias da última reatribuição dessa licença, a menos que a reatribuição se deva a (i) perda ou falha de hardware permanente; (ii) rescisão do contrato ou demissão do Usuário; ou (iii) realocação temporária de Licenças de assinatura para cobrir a ausência de um Usuário. Quando o Cliente reatribui uma Licença de assinatura de um Usuário para outro, deve bloquear o acesso do Usuário anterior à Licença de assinatura e às Organizações do Cliente. -### I. Affiliates +### I. Afiliados Os Afiliados do Cliente estão autorizados a utilizar os Produtos de acordo com este Contrato, desde que o Cliente permaneça plenamente responsável pelo acesso deles e pela utilização dos Produtos. ### J. Pagamento @@ -192,10 +192,10 @@ Os Afiliados do Cliente estão autorizados a utilizar os Produtos de acordo com **Pagamento com Base no Uso** Alguns recursos de Serviço são cobrados com base no seu uso. Uma quantidade limitada destes recursos de Serviço pode ser incluída no seu plano por um termo limitado sem custos adicionais. Se você optar por comprar recursos de Serviço pagos além da quantidade incluída no seu plano, você paga por esses recursos de Serviço com base no seu uso real no mês anterior. O pagamento mensal em atraso desses pedidos será cobrado periodicamente, contanto que para clientes faturados. Recursos de Serviço pago são cobrados com antecedência. Veja [Termos do Produto Adicionais GitHub para mais detalhes](/github/site-policy/github-additional-product-terms). -#### 2. Purchasing Additional Subscription Licenses +#### 2. Compra de licenças de assinatura adicionais O Cliente pode obter Licenças de Assinatura adicionais neste Contrato enviando uma solicitação pelo Serviço ou por meio da equipe de vendas. Se o Cliente comprar as Licenças de assinatura adicionais, terá de pagar as Taxas em vigor no momento da compra, divididas pelo saldo do Período de assinatura aplicável. Após a renovação das Licenças de assinatura do Cliente por outro Período de assinatura, o GitHub faturará todas as Licenças de assinatura de uma só vez anualmente, a menos que especificado de outra forma em um Formulário de pedido. -#### 3. Professional Services Credits. +#### 3. Créditos de serviços profissionais. Se o Cliente usa Créditos de serviços profissionais para pagar Serviços profissionais, após o recebimento de uma SOW pelo Cliente, os Créditos de serviços profissionais aplicáveis serão deduzidos do saldo de Créditos de serviços profissionais do Cliente. O Cliente é responsável por garantir que seu pedido de compra emitido ao GitHub para os Serviços profissionais reflita os preços estabelecidos na SOW. Se houver alguma diferença entre os preços listados na SOW e na ordem de compra do Cliente, o preço na SOW prevalecerá. As Partes concordam que as SOWs a pagar por meio de Créditos de serviços profissionais não precisam ser assinadas por qualquer uma das Partes para serem válidas e aplicáveis. Todos os Créditos de serviços profissionais não são reembolsáveis e devem ser usados dentro do prazo estipulado no Formulário de pedido. Caso contrário, serão cancelados automaticamente. O Cliente não poderá aplicar Créditos de serviços profissionais a despesas de viagem e hospedagem, que devem ser faturadas separadamente. #### 4. Autorização @@ -209,7 +209,7 @@ Este Contrato é válido a partir da Data do Início da Vigência e continuará #### 2. Rescisão por Conveniência; Cancelamento de Conta Qualquer das Partes pode rescindir um Formulário de Pedido (se aplicável) ou este Contrato, sem causa, mediante aviso prévio de pelo menos trinta (30) dias de antecedência por escrito. Se o Cliente optar por rescindir um Formulário de pedido ou o Contrato, é responsabilidade do Cliente cancelar corretamente a respectiva conta com o GitHub acessando Configurações na barra de navegação global, na parte superior da tela. O GitHub não cancela contas em resposta a solicitações por telefone ou e-mail. -#### 3. Termination for Material Breach +#### 3. Rescisão por violação de contrato Qualquer das Partes poderá rescindir este Contrato imediatamente, mediante notificação, se a outra Parte descumprir alguma clásula deste Contrato e não conseguir corrigir a violação no prazo de trinta (30) dias a partir da data em que receber a notificação. O GitHub pode rescindir este Contrato se a Conta do Cliente for suspensa por mais de 90 dias. #### 4. Efeito da Rescisão @@ -243,7 +243,7 @@ _Isenção de Serviço._ O GitHub fornece o Serviço **"COMO ESTÁ"** e **"CONFO _Isenção de Visualizações Beta._ O Cliente pode optar por usar Visualizações Beta a seu exclusivo critério. As Visualizações Beta podem não ser compatíveis, podem ser alteradas a qualquer momento sem aviso prévio e podem não ser tão confiáveis ou disponíveis como o Serviço. As Visualizações Beta não estão sujeitas às mesmas medidas de segurança e auditoria a que o Serviço esteve e está sujeito. O GitHub não terá nenhuma responsabilidade decorrentes das Visualizações Beta ou relacionadas a elas. **O Cliente usa Visualizações Beta por sua própria conta e risco.** -### N. Limitations of Liability +### N. Limitações de responsabilidade **_Danos indiretos._ Na medida máxima permitida pela lei aplicável, em nenhum caso a parte será responsável perante a outra ou perante terceiros por qualquer dano indireto, especial, acidental, punitivo ou consequente (incluindo por perda de lucros, receitas, ou dados) ou pelo custo da obtenção de produtos de substituição decorrentes ou relacionados com este Contrato, seja qual for a causa, se essa responsabilidade resulta de qualquer reclamação baseada no contrato, garantia, dano (incluindo negligência), responsabilidade estrita ou não, e se uma parte foi ou não aconselhada sobre a possibilidade de tais danos.** **_Limitação de Responsabilidade Total._ Na medida máxima permitida pela lei aplicável, em nenhum caso a responsabilidade total cumulativa de qualquer das partes nos termos deste Contrato, de todas as causas de ação, e todas as teorias de responsabilidade, excederão as Taxas que o Cliente pagou efetivamente ao GitHub durante os 12 meses anteriores à reclamação que deu origem a tal responsabilidade. No caso de produtos e serviços (incluindo o uso dos Produtos) que são fornecidos gratuitamente, a responsabilidade do GitHub é limitada a danos diretos até US$ 5.000. Para Visualizações Beta, a responsabilidade do GitHub é limitada a danos diretos de até US$ 500.** @@ -266,7 +266,7 @@ Se o Cliente tiver um conflito com um ou mais Usuários, o Cliente libera o GitH ### P. Confidencialidade Nenhuma das Partes usará as Informações confidenciais da outra Parte, exceto conforme permitido neste Contrato. Cada Parte concorda em manter a confiança e proteger as Informações confidenciais da outra Parte usando pelo menos o mesmo nível de cuidado que ela utiliza para suas próprias informações de natureza semelhante, mas em qualquer caso, pelo menos um grau razoável de cuidado. Cada Parte concorda em tomar todas as precauções razoáveis para evitar qualquer divulgação não autorizada das Informações Confidenciais da outra Parte, incluindo, sem limitação, a divulgação de tais Informações Confidenciais somente para os seus Representantes que (i) tenham necessidade de conhecer essas informações, (ii) sejam partes em acordos apropriados suficientes para cumprir esta Seção P, e (iii) sejam informados das restrições de utilização e divulgação previstas nesta Seção P. Cada Parte é responsável por todos os atos e omissões dos seus Representantes. As obrigações acima mencionadas não restringirão nenhuma das Partes de divulgar Informações Confidenciais da outra Parte, de acordo com a ordem ou exigência de um tribunal, agência administrativa, ou outro órgão governamental, _contanto que_ a Parte requerida para fazer tal divulgação dê uma notificação razoável à outra Parte para permitir que tal pedido ou exigência seja contestada, a menos que tal aviso seja proibido por lei. As restrições estabelecidas nesta Seção P sobreviverão à rescisão ou à expiração deste Contrato. -### Q. Professional Services +### Q. Serviços profissionais O GitHub fornecerá uma SOW detalhando os Serviços profissionais que tenham sido solicitados pelo Cliente. O GitHub executará os Serviços profissionais descritos em cada SOW. O GitHub controlará a forma e os meios pelos quais os Serviços Profissionais são executados e reserva-se o direito de determinar os funcionários designados. O GitHub pode usar terceiros para executar os Serviços profissionais, desde que o GitHub permaneça responsável pelos atos e omissões deles. O Cliente reconhece e concorda que o GitHub detém todos os direitos, títulos e interesses referentes a tudo o que for usado ou desenvolvido em relação à execução dos Serviços profissionais, inclusive software, ferramentas, especificações, ideias, conceitos, invenções, processos, técnicas e know-how. Na medida em que o GitHub oferece qualquer coisa ao Cliente ao realizar os Serviços Profissionais, o GitHub concede ao Cliente uma licença não exclusiva, não transferível, mundial, sem direitos de autor e com prazo limitado para usar as entregas disponíveis durante o termo deste Contrato, apenas em conjunto com o uso do Serviço pelo Cliente. ### R. Alterações no Serviço ou Termos @@ -288,10 +288,10 @@ O Cliente pode fornecer feedback ao GitHub sobre os Produtos. O feedback é volu #### 3. Não cessão Nenhuma das Partes poderá ceder ou transferir este Contrato, integral ou parcialmente, sem o consentimento prévio por escrito da outra Parte. Esse consentimento não será mantido sem motivo e qualquer tentativa de fazê-lo será considerada nula e sem efeito. A exceção é que o GitHub poderá ceder este Contrato na íntegra, mediante notificação à outra Parte, mas sem o consentimento dela, em uma fusão, aquisição, reorganização societária ou venda de todos ou quase todos os negócios ou ativos da Parte cedente. -#### 4. Waiver +#### 4. Garantia Uma das Partes neste Contrato só poderá renunciar a suas obrigações se o pedido for feito por escrito e assinado por um representante autorizado da outra Parte. Nenhuma falha ou atraso de uma das Partes deste Contrato no exercício de qualquer direito aqui descrito funcionará como renúncia do mesmo, nem qualquer exercício único ou parcial impedirá qualquer outro exercício do mesmo ou o exercício de qualquer direito disposto na lei ou na justiça. -#### 5. Severability +#### 5. Divisibilidade Se qualquer disposição deste Contrato for considerada ilegal, inválida ou inexequível por um tribunal competente, as Partes modificarão ou corrigirão o presente Contrato para dar o máximo de efeito possível a essa disposição. Qualquer disposição que não possa ser modificada ou corrigida desta forma será considerada excluída e as disposições remanescentes deste Contrato continuarão em pleno vigor e efeito. #### 6. Alterações; Contrato Completo; Ordem da Precedência @@ -300,7 +300,7 @@ Este Contrato só pode ser modificado por uma alteração escrita assinada por u #### 7. Comunicação Se o Cliente exibir publicamente o nome de sua empresa ou organização em sua conta ou exibir publicamente suas marcas registradas ou logotipos em sua página de perfil, o Cliente permite que o GitHub use o nome de sua empresa ou organização para identificar o Cliente como cliente GitHub em materiais promocionais. O Cliente pode revogar esta permissão ocultando o nome da sua empresa ou organização da exibição pública e notificando por escrito o GitHub para parar de usar o nome da sua organização em materiais promocionais. No entanto, o GitHub não tem nenhuma obrigação de remover ou recolher qualquer uso ou distribuição prévia dos materiais promocionais. -#### 8. Force Majeure +#### 8. Força Maior O GitHub será dispensado da responsabilidade quando não for possível cumprir qualquer obrigação deste Contrato devido a causas extraordinárias além do controle razoável, como fenômenos da natureza, desastres naturais, greves, bloqueios, tumultos, atos de guerra, epidemias ou falhas de energia, telecomunicações ou rede. #### 9. Contratados Independentes diff --git a/translations/pt-BR/content/github/site-policy/github-enterprise-server-license-agreement.md b/translations/pt-BR/content/github/site-policy/github-enterprise-server-license-agreement.md index 265cab40c714..5ca3943ef009 100644 --- a/translations/pt-BR/content/github/site-policy/github-enterprise-server-license-agreement.md +++ b/translations/pt-BR/content/github/site-policy/github-enterprise-server-license-agreement.md @@ -166,7 +166,7 @@ As Partes se defenderão mutuamente contra reivindicações de terceiros, como e **18.4** *Usuários do Governo.* Os Produtos e a Documentação foram desenvolvidos apenas com fundos privados e são considerados como "Software de Computação Comercial" e "Documentação de Software de Computação Comercial" conforme descrito nos Regulamentos Federais de Aquisição 12.212 e 27.405-3 e Suplemento ao Regulamento Federal de Aquisição de Defesa 227.7202-3. Os Produtos são licenciados para o usuário final do Governo dos EUA como software de computador de uso restrito e dados de direitos limitados. Nenhum dado técnico ou software de computador é desenvolvido neste Contrato. Qualquer uso, divulgação, modificação, distribuição ou reprodução dos Produtos ou da Documentação pelo Governo dos EUA ou por seus contratados estão sujeitos às restrições estabelecidas neste Contrato. Todos os outros usos são proibidos. -**18.5** *Exportação.* Os Produtos estão sujeitos a restrições de exportação e sanções administradas pelo Governo dos EUA e restrições de importação por determinados governos estrangeiros, e o Cliente cumprirá todas as leis e regulamentos aplicáveis de exportação e importação no uso dos Produtos pelo Cliente. Os Produtos estão sujeitos a restrições de exportação pelo Governo dos EUA e a restrições de importação por determinados governos estrangeiros, e o Cliente cumprirá todas as leis e regulamentações de exportação e importação aplicáveis ao fazer uso dos Produtos. O Cliente não deve, nem deve permitir que terceiros remova ou exporte dos Estados Unidos ou permita a exportação ou reexportação de qualquer parte dos Produtos ou de qualquer produto direto dos mesmos: (i) para qualquer país ou território sob embargo ou que apoie terroristas (ou para cidadãos ou residentes nessa categoria de país); (ii) a qualquer pessoa na Lista de Entidades ou Tabela de Pedidos de Negação do Departamento de Comércio dos EUA, qualquer pessoa bloqueada de acordo com as regras administradas pelo Escritório de Controle de Ativos Estrangeiros dos EUA, incluindo qualquer pessoa na Lista de Nacionais Especialmente Designados ou entidades de "Governo" de países sancionados ou qualquer pessoa sujeita a outras listas de pessoas proibidas ou sancionadas aplicáveis; (iii) para qualquer país ou território para o qual essa exportação ou reexportação seja restrita ou proibida, ou para o qual o governo dos EUA ou qualquer agência do mesmo exija uma licença de exportação ou outra aprovação governamental no momento da exportação ou reexportação, sem primeiro obter licença ou aprovação; ou (iv) qualquer outra forma de violação de quaisquer exportações, sanções ou restrições, leis ou regulamentos de importação de qualquer agência ou autoridade dos Estados Unidos ou de outros países. Lista de Entidades do Departamento de Comércio ou Tabela de Indeferimento de Pedidos, qualquer pessoa bloqueada, de acordo com as regras administradas pelos EUA. Office of Foreign Assets Control, including anyone on the List of Specially Designated Nationals or sanctioned country “Government” entities, or anyone subject to other applicable prohibited or sanctioned persons lists; (iii) to any country or territory to which such export or re-export is restricted or prohibited, or as to which the U.S. government or any agency thereof requires an export license or other governmental approval at the time of export or re-export without first obtaining such license or approval; or (iv) otherwise in violation of any export, sanctions, or import restrictions, laws or regulations of any United States or foreign agency or authority. O Cliente declara e garante que o Cliente não está não está localizado em, não está sob o controle de, ou não é cidadão nem residente de nenhum desses países ou territórios proibidos nem consta de nenhuma dessas listas proibidas. O GitHub Enterprise Server é um appliance virtual auto-hospedado que pode ser executado dentro do seu próprio datacenter ou nuvem virtual privativa do Cliente. Como tal, o GitHub Enterprise Server pode ser usado para armazenar ITAR ou outras informações de exportação controlada. No entanto, o Cliente é responsável por garantir tal conformidade. O Cliente reconhece e concorda que os Produtos estão proibidos de serem usados ​​para o design ou desenvolvimento de armas nucleares, químicas ou biológicas ou tecnologia de mísseis sem a permissão prévia necessária do governo dos EUA. government. +**18.5** *Exportação.* Os Produtos estão sujeitos a restrições de exportação e sanções administradas pelo Governo dos EUA e restrições de importação por determinados governos estrangeiros, e o Cliente cumprirá todas as leis e regulamentos aplicáveis de exportação e importação no uso dos Produtos pelo Cliente. Os Produtos estão sujeitos a restrições de exportação pelo Governo dos EUA e a restrições de importação por determinados governos estrangeiros, e o Cliente cumprirá todas as leis e regulamentações de exportação e importação aplicáveis ao fazer uso dos Produtos. O Cliente não deve, nem deve permitir que terceiros remova ou exporte dos Estados Unidos ou permita a exportação ou reexportação de qualquer parte dos Produtos ou de qualquer produto direto dos mesmos: (i) para qualquer país ou território sob embargo ou que apoie terroristas (ou para cidadãos ou residentes nessa categoria de país); (ii) a qualquer pessoa na Lista de Entidades ou Tabela de Pedidos de Negação do Departamento de Comércio dos EUA, qualquer pessoa bloqueada de acordo com as regras administradas pelo Escritório de Controle de Ativos Estrangeiros dos EUA, incluindo qualquer pessoa na Lista de Nacionais Especialmente Designados ou entidades de "Governo" de países sancionados ou qualquer pessoa sujeita a outras listas de pessoas proibidas ou sancionadas aplicáveis; (iii) para qualquer país ou território para o qual essa exportação ou reexportação seja restrita ou proibida, ou para o qual o governo dos EUA ou qualquer agência do mesmo exija uma licença de exportação ou outra aprovação governamental no momento da exportação ou reexportação, sem primeiro obter licença ou aprovação; ou (iv) qualquer outra forma de violação de quaisquer exportações, sanções ou restrições, leis ou regulamentos de importação de qualquer agência ou autoridade dos Estados Unidos ou de outros países. Lista de Entidades do Departamento de Comércio ou Tabela de Indeferimento de Pedidos, qualquer pessoa bloqueada, de acordo com as regras administradas pelos EUA. O Gabinete de Controle de Ativos Estrangeiros, incluindo qualquer pessoa da Lista de Nacionais Especialmente Designados ou entidades de "Governo" do país sancionado, ou quem estiver sujeito a outras listas de pessoas proibidas ou sancionadas aplicáveis; (iii) para qualquer país ou território para o qual a exportação ou reexportação seja restrita ou proibida, para as quais o o governo ou qualquer agência dos EUA exigir uma licença de exportação ou outra aprovação do governo no momento da exportação ou reexportação sem primeiro obter essa licença ou aprovação; ou (iv) de outra forma violando qualquer tipo de exportação, sanções, ou restrições à importação, leis ou regulamentos de qualquer autoridade ou agência ou autoridade dos Estados Unidos ou estrangeiras. O Cliente declara e garante que o Cliente não está não está localizado em, não está sob o controle de, ou não é cidadão nem residente de nenhum desses países ou territórios proibidos nem consta de nenhuma dessas listas proibidas. O GitHub Enterprise Server é um appliance virtual auto-hospedado que pode ser executado dentro do seu próprio datacenter ou nuvem virtual privativa do Cliente. Como tal, o GitHub Enterprise Server pode ser usado para armazenar ITAR ou outras informações de exportação controlada. No entanto, o Cliente é responsável por garantir tal conformidade. O Cliente reconhece e concorda que os Produtos estão proibidos de serem usados ​​para o design ou desenvolvimento de armas nucleares, químicas ou biológicas ou tecnologia de mísseis sem a permissão prévia necessária do governo dos EUA. governo. **18.6** *Nenhuma publicidade sem permissão.* O GitHub pode identificar o Cliente como clientes atuais e potenciais. No entanto, o GitHub não poderá usar o nome ou o logotipo do Cliente em qualquer material publicitário ou de marketing sem a permissão do Cliente. diff --git a/translations/pt-BR/content/github/site-policy/github-enterprise-service-level-agreement.md b/translations/pt-BR/content/github/site-policy/github-enterprise-service-level-agreement.md index 06259f4b31d6..1a0e28548208 100644 --- a/translations/pt-BR/content/github/site-policy/github-enterprise-service-level-agreement.md +++ b/translations/pt-BR/content/github/site-policy/github-enterprise-service-level-agreement.md @@ -1,5 +1,5 @@ --- -title: GitHub Enterprise Service Level Agreement +title: Contrato de Nível de Serviço do GitHub Enterprise redirect_from: - /github-enterprise-cloud-addendum/ - /github-business-cloud-addendum/ @@ -8,26 +8,24 @@ versions: free-pro-team: '*' --- -# GitHub Enterprise Service Level Agreement +**Versão curta:** O GitHub garante um compromisso de 99,8% de tempo de atividade trimestral para o serviço de nuvem do GitHub Enterprise (o “**Nível de Serviço**ou “**SLA**”). Se o GitHub não atender ao SLA, o Cliente terá direito a um crédito de serviço para a conta do Cliente (“**Créditos de Serviço**"). -**Short version:** GitHub guarantees a 99.9% quarterly uptime commitment for the GitHub Enterprise Cloud service (the “**Service Level**” or “**SLA**”). If GitHub does not meet the SLA, then Customer will be entitled to a service credit to Customer’s account (“**Service Credits**”). +Para definições de cada recurso de serviço (“**Recurso de serviço**”) e para revisar a versão histórica e atual, acesse a [Página de Status do GitHub](https://www.githubstatus.com/). Os termos em maiúsculas usados, mas não definidos neste SLA, têm o significado atribuído ao contrato aplicável do cliente. -For definitions of each Service feature (“**Service Feature**”) and to review historical and current Uptime, visit the [GitHub Status Page](https://www.githubstatus.com/). Capitalized terms used but not defined in this SLA have the meaning assigned in Customer’s applicable agreement. +## Garantia de tempo de atividade -## Uptime Guarantee +“**Tempo de atividade**” é a porcentagem do total de minutos possíveis que o Serviço estava disponível em um determinado trimestre. O GitHub compromete-se a manter um tempo de atividade de pelo menos 99,9% para o Serviço. O cálculo do tempo de atividade para cada Recurso de Serviço é descrito abaixo (“**Cálculo de Tempo de Atividade**"). Se o GitHub não atender ao SLA, O cliente terá direito a Créditos de Serviço com base no cálculo abaixo (“**Cálculo de Créditos de Serviço**"). Observe que o tempo de inatividade não afeta todos os clientes ao mesmo tempo ou da mesma forma. -“**Uptime**” is the percentage of total possible minutes the Service was available in a given calendar quarter. GitHub commits to maintain at least 99.9% Uptime for the Service. The Uptime calculation for each Service Feature is described below (“**Uptime Calculation**”). If GitHub does not meet the SLA, Customer will be entitled to Service Credits based on the calculation below (“**Service Credits Calculation**”). Note, Downtime does not affect every customer at the same time or in the same way. +| **Recurso de serviço** | **Cálculo do tempo de atividade** | **Definições** | **Cálculo dos créditos de serviço** | +| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | +| O **serviço** inclui os recursos de serviço a seguir:
    • Problemas
    • Pull Requests
    • Operações do Git
    • Solicitações da API
    • Webhooks
    • Pages
    • Ações
    • Pacotes
    | (total de minutos em um trimestre do calendário - tempo de inatividade) / total de minutos em um trimestre do calendário | “**Tempo de inatividade**” é um período de tempo em que (a) a taxa de erro excede 5% (cinco por cento) em um dado minuto para qualquer Recurso de Serviço ou (b) o Serviço ficou indisponível conforme determinado por uma combinação de sistemas de monitoramento interno e externo do GitHub. | Uma reivindicação de Serviço Créditos pode ser baseada em qualquer um (não em ambos) dos seguintes cálculos:
    • 10% do montante que o Cliente pagou por um recurso de serviço em um trimestre de calendário, em que o tempo de atividade para este recurso de serviço foi inferior ou igual a 99,9%, mas superior a 99,0%.

      OU

    • 25% do montante que o Cliente pagou por um recurso de serviço em um trimestre do calendário, em que o tempo de atividade foi inferior a 99,0%.
    | | +| **Ações** | (Total de Execuções Acionadas – Execuções Indisponíveis) / (Total de Execuções Acionadas) x 100 | “**Total de execuções acionadas**” é o número total de todas as execuções de ações acionadas pelo Cliente em um trimestre do calendário.

    “**Execuções Indisponíveis**" é o número total de execuções no Total de Execuções Acionadas que não foram executadas em um trimestre da agenda. Falha ao executar uma execução quando o registro do histórico de ações não capturou nenhuma saída 5 (cinco) minutos após o gatilho ter sido acionado com sucesso. | Igual ao de acima | +| **Pacotes** | Tempo de atividade de transferência = mesmo que ações

    Tempo de atividade de armazenamento = 100% - Taxa média de erro*

    *O cálculo do tempo de atividade exclui o uso público e as transações de armazenamento que não contam nem para Transações de Armazenamento Total ou Transações com falha de Armazenamento (incluindo falhas de pré-autenticação; falhas de autenticação; tentativas de transações para contas de armazenamento acima das suas cotas prescritas). | “**Taxa de erro**" é o número total de Transações de Falhas de Armazenamento dividido pelas Transações Totais de Armazenamento durante um intervalo de tempo definido (definido atualmente em uma hora). Se as Transações de Armazenamento Total em um determinado intervalo de uma hora for zero, a taxa de erro para esse intervalo será 0%.

    “**Taxa de erro média**” é a soma das taxas de erro por cada hora em um trimestre do calendário dividido pelo número total de horas em um trimestre do calendário. | Igual ao de acima | -| **Service Feature** | **Uptime Calculation** | **Definições** | **Service Credits Calculation** | -| --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | -| The **Service** includes the following Service Features:
    • Problemas
    • Pull Requests
    • Git Operations
    • API Requests
    • Webhooks
    • Pages
    • Actions
    • Packages
    | (total minutes in a calendar quarter - Downtime) / total minutes in a calendar quarter | “**Downtime**” is a period of time where either (a) the error rate exceeds five percent (5%) in a given minute for any Service Feature or (b) the Service was unavailable as determined by a combination of GitHub's internal and external monitoring systems. | A Service Credits claim may be based on either (not both) of the following calculations:
    • 10% of the amount Customer paid for a Service Feature in a calendar quarter where the Uptime for that Service Feature was less than 99.9%, but greater than 99.0%.

      OR

    • 25% of the amount Customer paid for a Service Feature in a calendar quarter where the Uptime of that Service Feature was less than 99.0%.
    | | -| **Actions** | (Total Triggered Executions – Unavailable Executions) / (Total Triggered Executions) x 100 | “**Total Triggered Executions**” is the total number of all Actions executions triggered by Customer in a calendar quarter.

    “**Unavailable Executions**” is the total number of executions within Total Triggered Executions which failed to run in a calendar quarter. An execution failed to run when the Actions history log did not capture any output five (5) minutes after the trigger was successfully fired. | Same as above | -| **Packages** | Transfers Uptime = same as Actions

    Storage Uptime = 100% - Average Error Rate*

    *The Uptime Calculation excludes public usage and storage transactions that do not count toward either Total Storage Transactions or Failed Storage Transactions (including pre-authentication failures; authentication failures; attempted transactions for storage accounts over their prescribed quotas). | “**Error Rate**” is the total number of Failed Storage Transactions divided by the Total Storage Transactions during a set time interval (currently set at one hour). If the Total Storage Transactions in a given one-hour interval is zero, the error rate for that interval is 0%.

    “**Average Error Rate**” is the sum of Error Rates for each hour in a calendar quarter divided by the total number of hours in a calendar quarter. | Same as above | +## Exclusões +São excluídos do Cálculo de Tempo de Atividade as falhas de recursos de serviço resultantes de (i) atos, omissões ou abuso do Serviço, incluindo violações do Contrato; (ii) falha na conexão à internet do Cliente; (iii) fatores fora do controle razoável do GitHub, incluindo eventos de força maior; ou (iv) equipamento do Cliente, serviços ou outra tecnologia. -## Exclusions -Excluded from the Uptime Calculation are Service Feature failures resulting from (i) Customer’s acts, omissions, or misuse of the Service including violations of the Agreement; (ii) failure of Customer’s internet connectivity; (iii) factors outside GitHub's reasonable control, including force majeure events; or (iv) Customer’s equipment, services, or other technology. +## Serviço de resgate de crédito +Se o GitHub não atender a este SLA, O cliente só poderá resgatar Créditos de Serviço mediante solicitação por escrito ao GitHub no prazo de 30 (trinta) dias a partir do final do trimestre do calendário. As solicitações por escrito do resgate de Créditos de Serviço devem ser enviadas para o [Suporte GitHub](https://support.github.com/contact). -## Service Credits Redemption -If GitHub does not meet this SLA, Customer may redeem Service Credits only upon written request to GitHub within thirty (30) days of the end of the calendar quarter. Written requests for Service Credits redemption should be sent to [GitHub Support](https://support.github.com/contact). - -Service Credits may take the form of a refund or credit to Customer’s account, cannot be exchanged into a cash amount, are limited to a maximum of ninety (90) days of paid service per calendar quarter, require Customer to have paid any outstanding invoices, and expire upon termination of Customer’s agreement with GitHub. Service Credits are the sole and exclusive remedy for any failure by GitHub to meet any obligations in this SLA. +Os Créditos de Serviço podem assumir a forma de reembolso ou crédito para a conta do cliente, não podem ser trocados por um valor em dinheiro, estão limitados a um máximo de 90 (noventa) dias de serviço pago por trimestre do calendário, exigem que o cliente tenha pago qualquer fatura pendente e que expiram após a rescisão do acordo do Cliente com o GitHub. Os Serviço Créditos são o remédio único e exclusivo para qualquer falha do GitHub em cumprir quaisquer obrigações neste SLA. diff --git a/translations/pt-BR/content/github/site-policy/github-enterprise-subscription-agreement.md b/translations/pt-BR/content/github/site-policy/github-enterprise-subscription-agreement.md index 7d2d85ba1501..1f5917ae86e7 100644 --- a/translations/pt-BR/content/github/site-policy/github-enterprise-subscription-agreement.md +++ b/translations/pt-BR/content/github/site-policy/github-enterprise-subscription-agreement.md @@ -165,7 +165,7 @@ Os Produtos foram desenvolvidos exclusivamente com fundos privados e são consid #### 1.13.3 Exportação. -Os Produtos estão sujeitos a restrições de exportação por parte dos EUA. Os Produtos estão sujeitos a restrições de exportação pelo Governo dos EUA e a restrições de importação por determinados governos estrangeiros, e o Cliente cumprirá todas as leis e regulamentações de exportação e importação aplicáveis ao fazer uso dos Produtos. O cliente não deve remover ou exportar dos Estados Unidos (nem permitir que algum terceiro o faça) ou permitir a exportação ou reexportação de qualquer parte dos Produtos ou de qualquer produto direto deles: (i) para qualquer país sob embargo ou que apoie terroristas (ou para cidadãos ou residentes nessa categoria de país); (ii) para qualquer pessoa na lista de cidadãos designados especialmente (SDN – Specially Designated Nationals) do Departamento do Tesouro dos Estados Unidos ou da tabela de negação de ordens (Table of Deny Orders) do Departamento de Comércio dos Estados Unidos; (iii) para qualquer país em que essa exportação ou reexportação seja restrita ou proibida ou no qual o Governo dos EUA ou qualquer órgão do mesmo exija uma licença de exportação ou outra aprovação governamental no momento da exportação ou reexportação sem que ela seja obtida primeiro; ou (iv) que, de qualquer outra forma, violem quaisquer regulamentos, leis ou restrições de exportação ou importação de qualquer autoridade ou órgão internacional ou norte-americano. Commerce Department's Table of Denial Orders or U.S. Treasury Department's list of Specially Designated Nationals; (iii) to any country to which such export or re-export is restricted or prohibited, or as to which the U.S. government or any agency thereof requires an export license or other governmental approval at the time of export or re-export without first obtaining such license or approval; or (iv) otherwise in violation of any export or import restrictions, laws or regulations of any United States or foreign agency or authority. O Cliente declara e garante que (a) não está não está localizado em, não está sob o controle de ou não é cidadão nem residente de nenhum desses países proibidos nem consta de nenhuma dessas listas proibidas e que (b) nenhum dos dados do Cliente são controlados pelas normas para o tráfico internacional de armas (ITAR – International Traffic in Arms Regulations) dos EUA. International Traffic in Arms Regulations. O cliente reconhece e concorda que os Produtos não podem ser usados para o projeto ou o desenvolvimento de armas nucleares, químicas ou biológicas ou tecnologia de mísseis sem a permissão prévia do Governo dos EUA. Government. +Os Produtos estão sujeitos a restrições de exportação por parte dos EUA. Os Produtos estão sujeitos a restrições de exportação pelo Governo dos EUA e a restrições de importação por determinados governos estrangeiros, e o Cliente cumprirá todas as leis e regulamentações de exportação e importação aplicáveis ao fazer uso dos Produtos. O cliente não deve remover ou exportar dos Estados Unidos (nem permitir que algum terceiro o faça) ou permitir a exportação ou reexportação de qualquer parte dos Produtos ou de qualquer produto direto deles: (i) para qualquer país sob embargo ou que apoie terroristas (ou para cidadãos ou residentes nessa categoria de país); (ii) para qualquer pessoa na lista de cidadãos designados especialmente (SDN – Specially Designated Nationals) do Departamento do Tesouro dos Estados Unidos ou da tabela de negação de ordens (Table of Deny Orders) do Departamento de Comércio dos Estados Unidos; (iii) para qualquer país em que essa exportação ou reexportação seja restrita ou proibida ou no qual o Governo dos EUA ou qualquer órgão do mesmo exija uma licença de exportação ou outra aprovação governamental no momento da exportação ou reexportação sem que ela seja obtida primeiro; ou (iv) que, de qualquer outra forma, violem quaisquer regulamentos, leis ou restrições de exportação ou importação de qualquer autoridade ou órgão internacional ou norte-americano. Tabela de Indeferimento do Departamento do Comércio ou dos EUA. Lista do Departamento do Tesouro dos Nacionais Designados Especialmente; (iii) para qualquer país para o qual essas exportações ou reexportações sejam restritas ou proibidas, ou do qual o governo ou qualquer agência dos EUA exigir uma licença de exportação ou outra aprovação do governo no momento da exportação ou reexportação sem primeiro obter essa licença ou aprovação; ou (iv) de outra forma violando qualquer tipo de exportação ou restrições à importação, leis ou regulamentos de qualquer autoridade ou agência ou autoridade dos Estados Unidos ou estrangeiras. O Cliente declara e garante que (a) não está não está localizado em, não está sob o controle de ou não é cidadão nem residente de nenhum desses países proibidos nem consta de nenhuma dessas listas proibidas e que (b) nenhum dos dados do Cliente são controlados pelas normas para o tráfico internacional de armas (ITAR – International Traffic in Arms Regulations) dos EUA. Tráfego Internacional nos Regulamentos do Armamento. O cliente reconhece e concorda que os Produtos não podem ser usados para o projeto ou o desenvolvimento de armas nucleares, químicas ou biológicas ou tecnologia de mísseis sem a permissão prévia do Governo dos EUA. Governo. #### 1.13.4 Nenhuma publicidade sem permissão. @@ -259,7 +259,7 @@ Para criar uma conta, o Cliente deve atender às seguintes condições: **(ii)** O login de um Usuário não pode ser compartilhado por várias pessoas. -**(iii)** O Cliente não deverá usar o Serviço (a) se isso violar o controle de exportação ou as leis de sanções dos Estados Unidos ou de qualquer outra jurisdição aplicável; (b) se ele estiver localizado ou residir normalmente em um país ou território sujeito a sanções abrangentes administradas pelo Escritório de Controle de Ativos Estrangeiros (OFAC – Office of Foreign Assets Control) do Departamento do Tesouro Americano ou (c) se o Cliente é ou representa um [cidadão designado especialmente](https://www.treasury.gov/resource-center/sanctions/SDN-List/Pages/default.aspx) (SDN – Specially Designated National) ou uma pessoa sujeita a bloqueio semelhante ou a proibições partidárias negadas. Office of Foreign Assets Control (OFAC), or (c) if Customer is or is working on behalf of a [Specially Designated National (SDN)](https://www.treasury.gov/resource-center/sanctions/SDN-List/Pages/default.aspx) or a person subject to similar blocking or denied party prohibitions. Para obter mais informações, consulte a [Política de controles de exportação do GitHub](/articles/github-and-export-controls). +**(iii)** O Cliente não deverá usar o Serviço (a) se isso violar o controle de exportação ou as leis de sanções dos Estados Unidos ou de qualquer outra jurisdição aplicável; (b) se ele estiver localizado ou residir normalmente em um país ou território sujeito a sanções abrangentes administradas pelo Escritório de Controle de Ativos Estrangeiros (OFAC – Office of Foreign Assets Control) do Departamento do Tesouro Americano ou (c) se o Cliente é ou representa um [cidadão designado especialmente](https://www.treasury.gov/resource-center/sanctions/SDN-List/Pages/default.aspx) (SDN – Specially Designated National) ou uma pessoa sujeita a bloqueio semelhante ou a proibições partidárias negadas. O Escritório e Controle de Ativos Estrangeiros (OFAC); ou (c) se o Cliente estiver trabalhando em nome de um [Nacional Especialmente Designado (SDN)](https://www.treasury.gov/resource-center/sanctions/SDN-List/Pages/default.aspx) ou de pessoa sujeita a bloqueios semelhantes ou proibições de partes negadas. Para obter mais informações, consulte a [Política de controles de exportação do GitHub](/articles/github-and-export-controls). #### 3.1.3 Segurança da conta. @@ -269,7 +269,7 @@ O cliente é responsável por: (i) todo o Conteúdo postado e pela atividade que Em algumas situações, os termos de terceiros podem ser aplicados ao uso do serviço pelo Cliente. Por exemplo, o Cliente pode ser integrante de uma Organização com seus próprios termos ou contratos de licença. O cliente poderá baixar um aplicativo que se integra ao Serviço ou utilizar o Serviço para autenticar em outro serviço. Embora este Contrato seja o acordo completo do GitHub com o Cliente, os termos de outras partes regem as relações dele com o Cliente. -#### 3.1.5 Termos do Governo Federal do EUA. Federal Government Terms. +#### 3.1.5 Termos do Governo Federal do EUA. Termos do Governo Federal. Se o cliente é dos EUA. If Customer is a U.S. federal government agency or otherwise accessing or using any portion of the Service in a government capacity, the [U.S. Federal Government Amendment](/articles/amendment-to-github-terms-of-service-applicable-to-us-federal-government-users) applies, and Customer agrees to its provisions. Aplica-se a alteração do Governo Federal e o Cliente concorda com suas disposições. @@ -341,7 +341,7 @@ O GitHub tem o direito de suspender a qualquer momento o acesso parcial ou total ### 3.7 Contrato de Nível de Serviço. -GitHub’s quarterly uptime commitment for the Service is provided in the [Enterprise Service Level Agreement](/github/site-policy/github-enterprise-service-level-agreement). Customer will be entitled to a service credit if GitHub does not meet its service level. +O compromisso trimestral do GitHub com o Serviço é fornecido no [Contrato de Nível de Serviço Empresarial](/github/site-policy/github-enterprise-service-level-agreement). O cliente terá direito a um crédito de serviço se o GitHub não atender ao seu nível de serviço. ### 3.8 Alterações no serviço. O GitHub altera o Serviço através de Atualizações e adição de novos recursos. Sujeito à Seção 3,7, o GitHub se reserva o direito de, a qualquer momento, modificar ou interromper, temporária ou permanentemente, o Serviço (ou qualquer parte dele), com ou sem aviso prévio. @@ -374,7 +374,7 @@ Alguns recursos do Serviço podem estar sujeitos a termos adicionais definidos n **"Conta corporativa"** significa uma conta criada por um Usuário em nome de uma entidade. -**"Customer"** means, collectively, the company or organization that has entered into this Agreement with GitHub by clicking on the "I AGREE" or similar button or by accessing the Products, its Affiliates and Representatives. +**"Cliente"** significa, coletivamente, a empresa ou organização que entrou neste Contrato com o GitHub, clicando no botão "EU CONCORDO", ou semelhante, ou acessando os Produtos, seus Afiliados e Representantes. **"Conteúdo do cliente"** significa Conteúdo que o cliente cria, possui ou para o qual o cliente detém os direitos. @@ -390,7 +390,7 @@ Alguns recursos do Serviço podem estar sujeitos a termos adicionais definidos n **"Feedback"** significa ideias, conhecimento, algoritmos, contribuições de código, sugestões, solicitações de aprimoramento, recomendações ou qualquer outro feedback sobre produtos ou serviços do GitHub. -**“Fees”** means the fees Customer is required to pay GitHub to (i) use the Products during the applicable Subscription Term or (ii) receive Professional Services, as such fees are reflected on an Order Form or SOW. +**"Taxas"** significa as taxas que o Cliente é obrigado a pagar ao GitHub (i) usar os Produtos durante o Termo de Assinatura aplicável ou (ii) receber Serviços Profissionais, como essas taxas são refletidas em um formulário de pedido ou SOW. **"Bifurcação"** significa copiar o Conteúdo de um repositório para outro. diff --git a/translations/pt-BR/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md b/translations/pt-BR/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md index a8ca41da39a3..c079aa0894c1 100644 --- a/translations/pt-BR/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md +++ b/translations/pt-BR/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md @@ -1,6 +1,6 @@ --- -title: O GitHub Insights e a proteção de dados para sua organização -intro: '{% data variables.product.prodname_insights %} analisa seus dados {% data variables.product.prodname_ghe_server %}. Esses dados podem incluir dados pessoais de indivíduos em sua organização que podem ter o direito de entender como esses dados pessoais estão sendo usados.' +title: GitHub Insights and data protection for your organization +intro: '{% data variables.product.prodname_insights %} analyzes your {% data variables.product.prodname_ghe_server %} data. This data could include personal data of individuals in your organization who may have the right to understand how such personal data is being used.' product: '{% data reusables.gated-features.github-insights %}' redirect_from: - /github/installing-and-configuring-github-insights/github-insights-and-data-protection-for-your-organization @@ -9,38 +9,38 @@ versions: enterprise-server: '*' --- -Para obter mais informações sobre os termos que regem {% data variables.product.prodname_insights %}, consulte o seu contrato de assinatura do {% data variables.product.prodname_ghe_one %}. +For more information about the terms that govern {% data variables.product.prodname_insights %}, see your {% data variables.product.prodname_ghe_one %} subscription agreement. -Para evitar dúvidas, nenhuma das informações acima devem ser consideradas aconselhamento legal fornecido por {% data variables.product.prodname_dotcom %}. Você é responsável por proteger sua própria análise legal das informações fornecidas neste documento e pelo seu cumprimento das leis de privacidade e proteção de dados. Fica a seu critério exclusivo usar {% data variables.product.prodname_insights %} para processar os dados dos seus funcionários e usuários e, se você fizer isso, você é o único responsável por realizar esse processamento em conformidade com a lei aplicável. +For the avoidance of doubt, none of the foregoing information should be considered legal advice provided by {% data variables.product.prodname_dotcom %}. You are responsible for securing your own legal analysis of the information provided herein and for your compliance with privacy and data protection laws. It is up to you whether to use {% data variables.product.prodname_insights %} to process your employees’ and users’ data, and if you do so, you are solely responsible for conducting such processing in compliance with applicable law. -### Funções e responsabilidades da organização +### The organization’s roles and responsibilities -Ao usar o {% data variables.product.prodname_insights %}, sua organização é o controlador de dados porque sua organização determina se, como e por que {% data variables.product.prodname_insights %} processará os dados pessoais de qualquer indivíduo. Sua organização é a única responsável por garantir que você esteja cumprindo com todas as leis aplicáveis no processamento de dados com {% data variables.product.prodname_insights %}. +When using {% data variables.product.prodname_insights %}, your organization is the data controller because your organization determines whether, how, and why {% data variables.product.prodname_insights %} will process any individual’s personal data. Your organization is solely responsible for ensuring that you are complying with all applicable laws in processing data with {% data variables.product.prodname_insights %}. -### Recomendação de privacidade de dados +### Data privacy recommendations -Você tem total controle sobre quais métricas, relatórios, repositórios e contribuidores incluir antes de iniciar o uso do {% data variables.product.prodname_insights %}. Os dados que você processa com {% data variables.product.prodname_insights %} só podem ser retirados da sua instalação do {% data variables.product.prodname_ghe_server %}. Considere equilibrar os riscos versus os benefícios da análise de dados pessoais. +You have full control over which metrics, reports, repositories, and contributors to include before beginning use of {% data variables.product.prodname_insights %}. The data you process with {% data variables.product.prodname_insights %} can only be pulled from your installation of {% data variables.product.prodname_ghe_server %}. Consider balancing the risks versus the benefits of analyzing personal data. -- **Desenvolva um plano de análise claro**: você deve entender claramente o que você quer analisar e por quê, e, em seguida, considere como {% data variables.product.prodname_insights %} pode ajudá-lo a encontrar essas respostas. +- **Develop a clear analysis plan**: You must understand clearly what you want to analyze and why, and then consider how {% data variables.product.prodname_insights %} may help you find those answers. -- **Considere uma avaliação de impacto de proteção de dados**: Se seu uso proposto de {% data variables.product.prodname_insights %} envolver processamento de dados pessoais, considere a conclusão de uma avaliação de impacto de proteção de dados ou a conclusão de uma análise jurídica formal do seu uso planejado. +- **Consider a data protection impact assessment**: If your proposed use of {% data variables.product.prodname_insights %} involves processing personal data, consider completing a data protection impact assessment or otherwise completing formal legal analysis of your planned use. -### Decida quais dados usar +### Decide what data to use -- **Decida quais repositórios incluir**: Antes de iniciar uma análise em {% data variables.product.prodname_insights %}, considere quais repositórios incluir. Os administradores podem incluir repositórios quando estiverem adicionando organizações e podem habilitar e desabilitar repositórios a qualquer momento. Para obter mais informações sobre como adicionar organizações ao {% data variables.product.prodname_insights %}, consulte "[Gerenciar organizações](/insights/installing-and-configuring-github-insights/managing-organizations). Para obter mais informações sobre como ativar e desativar repositórios, consulte "[Gerenciar repositórios](/insights/installing-and-configuring-github-insights/managing-repositories)". +- **Decide which repositories to include**: Before you start an analysis in {% data variables.product.prodname_insights %}, consider which repositories to include. Administrators can include repositories when adding organizations and can enable and disable repositories at any time. For more information on adding organizations to {% data variables.product.prodname_insights %}, see "[Managing organizations](/insights/installing-and-configuring-github-insights/managing-organizations)." For more information on enabling and disabling repositories, see "[Managing repositories](/insights/installing-and-configuring-github-insights/managing-repositories)." -- **Decida quais métricas e relatórios incluir**: Os administradores podem ativar e desativar as métricas e relatórios disponíveis para todos os usuários a qualquer momento. Os administradores controlam os dados do {% data variables.product.prodname_insights %} aos quais os usuários têm acesso na sua instalação do {% data variables.product.prodname_ghe_server %}. Para obter mais informações, consulte "[Gerenciar métricas e relatórios disponíveis](/insights/installing-and-configuring-github-insights/managing-available-metrics-and-reports)" +- **Decide which metrics and reports to include**: Administrators can enable and disable metrics and reports available for all users at any time. Administrators control the {% data variables.product.prodname_insights %} data that users have access to in your installation of {% data variables.product.prodname_ghe_server %}. For more information, see "[Managing available metrics and reports](/insights/installing-and-configuring-github-insights/managing-available-metrics-and-reports)." -- **Decida quais contribuidores incluir**: Os administradores podem desativar os dados de um colaborador específico de serem processados nas métricas e relatórios. Para obter mais informações sobre o gerenciamento de dados do contribuidor, consulte "[Gerenciar contribuidores e equipes](/insights/installing-and-configuring-github-insights/managing-contributors-and-teams)". +- **Decide which contributors to include**: Administrators can disable a specific contributor’s data from being processed in the metrics and reports. For more information on managing contributor data, see "[Managing contributors and teams](/insights/installing-and-configuring-github-insights/managing-contributors-and-teams)." -### Direitos do usuário +### User rights -Sob vários regulamentos de proteção de dados, como o Regulamento Geral de Proteção de Dados (RGPD), usuários podem ter o direito de solicitar a exclusão de processamento, acesso e correção ou solicitar a exclusão de seus dados pessoais. Como controlador de dados, sua organização deve avaliar se uma solicitação específica do usuário é válida e, se for o caso, tomar medidas para atender à solicitação. +Under various data protection regulations, such as the General Data Protection Regulation (GDPR), users may have the right to request exclusion from processing, access, and correction, or to request deletion of their personal data. As the data controller, your organization should evaluate whether a particular user request is valid and, if appropriate, take action to fulfill the request. -- **Exclusão de processamento**: Os usuários podem ter o direito de ter seus dados pessoais excluídos do processamento. Os administradores têm a capacidade de remover do processamento os dados de um contribuinte em {% data variables.product.prodname_insights %} e os relatórios e métricas resultantes excluirão os dados do contribuidor apropriadamente. Para obter mais informações, consulte "[Gerenciar contribuidores e equipes](/insights/installing-and-configuring-github-insights/managing-contributors-and-teams)." +- **Exclusion of processing**: Users may have the right to have their personal data excluded from being processed. Administrators have the ability to remove a contributor’s data from being processed in {% data variables.product.prodname_insights %}, and the resulting reports and metrics will exclude the contributor’s data accordingly. For more information, see "[Managing contributors and teams](/insights/installing-and-configuring-github-insights/managing-contributors-and-teams)." -- **Acesso**: Os usuários podem ter o direito de exigir quais dados pessoais estão sendo processados. Cada métrica e cada relatório tem uma descrição detalhada dos dados pessoais que estão sendo processados. Para obter mais informações, consulte "[Mérticas disponíveis com o {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights)". Os dados brutos estão disponíveis através da API do {% data variables.product.prodname_enterprise %}. Sua organização é responsável por quaisquer decisões de processamento de dados pessoais e pelo cumprimento de tais solicitações. +- **Access**: Users may have the right to demand to see what personal data is being processed. Each metric and report has a detailed description of what personal data is being processed. For more information, see "[Metrics available with {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights)." Raw data is available through the {% data variables.product.prodname_enterprise %} API. Your organization is responsible for any decisions to process personal data and for fulfilling any such requests. -- **Correção e exclusão**: Os usuários podem ter o direito de corrigir ou excluir seus dados pessoais. Os dados usados em {% data variables.product.prodname_insights %} são derivados de dados existentes que você adiciona ou gera a partir da instalação do seu {% data variables.product.prodname_ghe_server %}. A correção e a exclusão devem seguir o processo existente da sua organização para corrigir e excluir dados de {% data variables.product.prodname_ghe_server %}. +- **Correction and deletion**: Users may have the right to rectify or delete their personal data. The data used in {% data variables.product.prodname_insights %} is derived from the existing data you add to or generate from your {% data variables.product.prodname_ghe_server %} installation. Correction and deletion should follow your organization's existing process to correct and delete data from {% data variables.product.prodname_ghe_server %}. -- **Transparência em relação ao processamento**: Cada métrica e relatório tem uma descrição detalhada de quais dados pessoais estão sendo processados. Para obter mais informações, consulte "[Mérticas disponíveis com o {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights)". +- **Transparency regarding processing**: Each metric and report has a detailed description of what personal data is being processed. For more information, see "[Metrics available with {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights)." diff --git a/translations/pt-BR/content/github/site-policy/github-marketplace-developer-agreement.md b/translations/pt-BR/content/github/site-policy/github-marketplace-developer-agreement.md index d43166457fd8..345811a3b5e8 100644 --- a/translations/pt-BR/content/github/site-policy/github-marketplace-developer-agreement.md +++ b/translations/pt-BR/content/github/site-policy/github-marketplace-developer-agreement.md @@ -193,7 +193,7 @@ As partes são contratantes independentes. Este Acordo não cria uma relação d ### 15. AVISO -Todos os avisos a serem fornecidos pelo GitHub ao Desenvolvedor, regidos por este Contrato, podem ser entregues por escrito (i) via serviço de entrega reconhecido nacionalmente ("Courier") ou pelo correio dos EUA para o endereço de contato fornecido pelo Desenvolvedor ao GitHub; ou (ii) via correio eletrônico para o endereço de correio eletrônico fornecido pelo Desenvolvedor. mail to the contact mailing address provided by Developer to GitHub; or (ii) electronic mail to the electronic mail address provided by Developer. Developer must give notice to GitHub in writing by Courier or U.S. O Desenvolvedor deve remeter o aviso ao GitHub, por escrito, pelo Courier, ou pelo correio dos Estados Unidos, para o seguinte endereço: GitHub, Inc., Attn: Legal Department, 88 Colin P. Kelly Jr. Street, San Francisco, CA 94107 USA. Todos os avisos serão avaliados imediatamente após a entrega por correio eletrônico, ou se de outra forma entregues, mediante o recebimento ou, o que vier primeiro, dois (2) dias úteis após serem depositados no correio ou entregues a um Courier, conforme permitido acima. +Todos os avisos a serem fornecidos pelo GitHub ao Desenvolvedor, regidos por este Contrato, podem ser entregues por escrito (i) via serviço de entrega reconhecido nacionalmente ("Courier") ou pelo correio dos EUA para o endereço de contato fornecido pelo Desenvolvedor ao GitHub; ou (ii) via correio eletrônico para o endereço de correio eletrônico fornecido pelo Desenvolvedor. correio para o endereço de contato fornecido pelo desenvolvedor para o GitHub, ou (ii) endereço eletrônico para o endereço de e-mail eletrônico fornecido pelo desenvolvedor. Desenvolvedor deve avisar o GitHub por escrito pelo correio ou pelos EUA. O Desenvolvedor deve remeter o aviso ao GitHub, por escrito, pelo Courier, ou pelo correio dos Estados Unidos, para o seguinte endereço: GitHub, Inc., Attn: Legal Department, 88 Colin P. Kelly Jr. Street, San Francisco, CA 94107 USA. Todos os avisos serão avaliados imediatamente após a entrega por correio eletrônico, ou se de outra forma entregues, mediante o recebimento ou, o que vier primeiro, dois (2) dias úteis após serem depositados no correio ou entregues a um Courier, conforme permitido acima. ### 16. LEI REGENTE @@ -224,7 +224,7 @@ Este Anexo à Proteção de Dados (este "Anexo") está anexado e faz parte do Co **A1-3. Cumprimento das leis de transferência de dados** -- a. Conformidade do GitHub. O GitHub está cumpre as leis aplicáveis de proteção de dados. O GitHub depende das Cláusulas Contratuais Padrão ("SCC") para todas as transferências para fora da União Europeia, Espaço Econômico Europeu, Reino Unido e Suíça para prestar os seus serviços. Além disso, o GitHub é certificado na relação entre UE e EUA. e entre a Suíça e os EUA. Estruturas de Escudo de Privacidade e os compromissos que elas implicam, embora o GitHub não dependa da relação entre a UE e os EUA. Privacy Shield Framework as a legal basis for transfers of Personal Information in light of the judgment of the Court of Justice of the EU in Case C-311/18. O GitHub só transferirá Informações Pessoais para o Desenvolvedor para os fins limitados e especificados para os quais foram coletadas. +- a. Conformidade do GitHub. O GitHub está cumpre as leis aplicáveis de proteção de dados. O GitHub depende das Cláusulas Contratuais Padrão ("SCC") para todas as transferências para fora da União Europeia, Espaço Econômico Europeu, Reino Unido e Suíça para prestar os seus serviços. Além disso, o GitHub é certificado na relação entre UE e EUA. e entre a Suíça e os EUA. Estruturas de Escudo de Privacidade e os compromissos que elas implicam, embora o GitHub não dependa da relação entre a UE e os EUA. Estrutura do Escudo de Privacidade como base jurídica para transferências de Informações Pessoais à luz do acórdão do Tribunal de Justiça da UE no processo C-311/18. O GitHub só transferirá Informações Pessoais para o Desenvolvedor para os fins limitados e especificados para os quais foram coletadas. - b. Conformidade do Desenvolvedor. O desenvolvedor representa e garante que cumprirá (i) as leis de proteção de dados aplicáveis; e (ii) cumprirá os requisitos do Espaço Econômico Europeu e da legislação suíça em matéria de proteção de dados relativos à coleta, utilização, transferência, retenção ou outro processamento de Informações Pessoais do Espaço Econômico Europeu, do Reino Unido e da Suíça. Todas as transferências de Informações Pessoais para um país terceiro ou uma organização internacional estarão sujeitas às salvaguardas apropriadas, conforme descrito no Artigo 46 do RGPD e tais transferências e salvaguardas serão documentadas de acordo com o Artigo 30(2) do RGPD. **A1-4. Proteção de dados** diff --git a/translations/pt-BR/content/github/site-policy/github-pre-release-program.md b/translations/pt-BR/content/github/site-policy/github-pre-release-program.md index f51b025676ba..209b72a65651 100644 --- a/translations/pt-BR/content/github/site-policy/github-pre-release-program.md +++ b/translations/pt-BR/content/github/site-policy/github-pre-release-program.md @@ -48,7 +48,7 @@ Este Contrato é um acordo legal entre você ("você", "seu") e o GitHub, Inc. ( ### 7. Controle de exportação - Você não tem permissão para exportar ou reexportar nenhuma das nossas Informações Confidenciais, exceto conforme autorizado pela lei dos Estados Unidos e pelas leis da jurisdição em que as Informações Confidenciais foram obtidas. Particularmente, você não está autorizado a exportar ou reexportar nossas Informações Confidenciais para qualquer país embargado pelos EUA, para qualquer pessoa na lista de Nacionais Especialmente Designados do Departamento do Tesouro dos EUA, ou para qualquer pessoa na Lista de Pessoas e Entidades do Departamento de Comércio dos EUA. países embargados, para qualquer um nos Estados Unidos Treasury Department's list of Specially Designated Nationals, or to anyone on the U.S. Department of Commerce Denied Person's List or Entity List. Ao aderir ao Programa de Pré-lançamento ou receber qualquer uma de nossas Informações Confidenciais, você declara e garante que não está localizado em nenhum desses países ou em qualquer lista. + Você não tem permissão para exportar ou reexportar nenhuma das nossas Informações Confidenciais, exceto conforme autorizado pela lei dos Estados Unidos e pelas leis da jurisdição em que as Informações Confidenciais foram obtidas. Particularmente, você não está autorizado a exportar ou reexportar nossas Informações Confidenciais para qualquer país embargado pelos EUA, para qualquer pessoa na lista de Nacionais Especialmente Designados do Departamento do Tesouro dos EUA, ou para qualquer pessoa na Lista de Pessoas e Entidades do Departamento de Comércio dos EUA. países embargados, para qualquer um nos Estados Unidos Lista do Departamento do Tesouro dos Nacionais Designados Especialmente ou para qualquer pessoa dos EUA. Departamento de Comércio da Lista de Pessoas Indeferidas ou Lista de Entidades. Ao aderir ao Programa de Pré-lançamento ou receber qualquer uma de nossas Informações Confidenciais, você declara e garante que não está localizado em nenhum desses países ou em qualquer lista. ### 8. Direitos Proprietários @@ -56,7 +56,7 @@ Este Contrato é um acordo legal entre você ("você", "seu") e o GitHub, Inc. ( ### 9. Usuários do Governo - Se você é uma entidade governamental, esta Seção se aplica a você. Algumas de nossas Informações Confidenciais podem ser consideradas "Itens Comerciais", conforme definido em 48 C.F.R. §2.101, consistindo em "Commercial Computer Software" e "Commercial Computer Software Documentation", pois tais termos são usados em 48 C.F.R. §12.212 ou 48 C.F.R. §227.7202, conforme aplicável. §2.101, consisting of “Commercial Computer Software” and “Commercial Computer Software Documentation”, as such terms are used in 48 C.F.R. §12.212 ou 48 C.F.R. §227.7202, conforme aplicável. Consistente com 48 C.F.R. §12.212 ou 48 C.F.R. §227.7202-1 through 227.7202-4, as applicable, the Commercial Computer Software and Commercial Computer Software Documentation are being licensed to U.S. Consistente com 48 C.F.R. §12.212 ou 48 C.F.R. §227.7202-1 até 227.7202-4, conforme aplicável, o Software Comercial de Computador e a Documentação de Software Comercial de Computador estão sendo licenciadas aos usuários finais do governo dos EUA (a) apenas como Itens Comerciais e (b) com apenas esses direitos que são concedidos a todos os outros usuários finais de acordo com os termos e condições aqui apresentados. GitHub, Inc. 88 Colin P. Kelly Street, San Francisco, CA 94107. + Se você é uma entidade governamental, esta Seção se aplica a você. Algumas de nossas Informações Confidenciais podem ser consideradas "Itens Comerciais", conforme definido em 48 C.F.R. §2.101, consistindo em "Commercial Computer Software" e "Commercial Computer Software Documentation", pois tais termos são usados em 48 C.F.R. §12.212 ou 48 C.F.R. §227.7202, conforme aplicável. §2.101, que consiste em “Software Computadores Comerciais” e “Documentação de Software de Computador Comercial”, uma vez que esses termos são utilizados em 48 C.F.R. §12.212 ou 48 C.F.R. §227.7202, conforme aplicável. Consistente com 48 C.F.R. §12.212 ou 48 C.F.R. §227.7202-1 a 227.7202-4, conforme aplicável, o Software de Computador Comercial e a documentação do Software de Computador Comercial estão sendo licenciados nos EUA. Consistente com 48 C.F.R. §12.212 ou 48 C.F.R. §227.7202-1 até 227.7202-4, conforme aplicável, o Software Comercial de Computador e a Documentação de Software Comercial de Computador estão sendo licenciadas aos usuários finais do governo dos EUA (a) apenas como Itens Comerciais e (b) com apenas esses direitos que são concedidos a todos os outros usuários finais de acordo com os termos e condições aqui apresentados. GitHub, Inc. 88 Colin P. Kelly Street, San Francisco, CA 94107. ### 10. Desenvolvimento Independente @@ -78,7 +78,7 @@ Este Contrato é um acordo legal entre você ("você", "seu") e o GitHub, Inc. ( As partes deste Acordo são contratantes independentes. Nenhuma das partes será considerado empregado, agente, parceiro, franqueador, franqueado ou representante legal do outro para qualquer finalidade e nenhuma das partes terá qualquer direito, poder ou autoridade para criar qualquer obrigação ou responsabilidade em nome do outro. -### 14. Assignment +### 14. Atividade Você não está autorizado a atribuir ou transferir este Contrato, ou qualquer um de seus direitos sob ele, no todo ou em parte, por operação da lei ou de outra forma, sem o nosso consentimento prévio por escrito. diff --git a/translations/pt-BR/content/github/site-policy/github-privacy-statement.md b/translations/pt-BR/content/github/site-policy/github-privacy-statement.md index d4eada7f4c18..c42fd3dd1de5 100644 --- a/translations/pt-BR/content/github/site-policy/github-privacy-statement.md +++ b/translations/pt-BR/content/github/site-policy/github-privacy-statement.md @@ -11,7 +11,7 @@ versions: free-pro-team: '*' --- -Data de entrada em vigor: 22 de Julho de 2020 +Data de vigência: 2 de outubro de 2020 Agradecemos por confiar seu código-fonte, seus projetos e suas informações pessoais à GitHub Inc. (“GitHub” ou “nós”). Manter suas informações pessoais em segurança é uma responsabilidade que levamos a sério, e queremos mostrar como fazemos esse trabalho. @@ -219,15 +219,15 @@ Com isso, o endereço de e-mail que você informou [nas suas configurações de #### Cookies -O GitHub usa cookies para tornar as interações com nosso serviço fáceis e significativas. Cookies são pequenos arquivos de texto que os sites costumam armazenar nos discos rígidos de computadores ou dispositivos móveis de visitantes. Usamos cookies (e tecnologias afins, como HTML5 localStorage) para manter a sua conexão ativa, lembrar de suas preferências e dar informações para o desenvolvimento futuro do GitHub. Por motivos de segurança, usamos cookies para identificar um dispositivo. Ao usar o nosso Site, você concorda que podemos inserir esses tipos de cookies no seu computador ou dispositivo. Se você desativar o navegador ou a capacidade de o seu dispositivo aceitar cookies, não será possível fazer login nem usar os serviços do GitHub. +O GitHub usa cookies e tecnologias similares (coletivamente, denominados “cookies”) para tornar as interações com nosso serviço fáceis e significativas. Cookies são pequenos arquivos de texto que os sites costumam armazenar nos discos rígidos de computadores ou dispositivos móveis de visitantes. Usamos cookies para fornecer nossos serviços como, por exemplo, para manter você conectado, para lembrar as suas preferências, identificar o seu dispositivo para fins de segurança e fornecer informações para o desenvolvimento futuro do GitHub. Ao usar o nosso Site, você concorda que podemos inserir esses tipos de cookies no seu computador ou dispositivo. Se você desativar o navegador ou a capacidade de o seu dispositivo aceitar cookies, não será possível fazer login nem usar os serviços do GitHub. -Mantemos uma página na internet sobre [cookies e rastreamento](/github/site-policy/github-subprocessors-and-cookies) que descreve nossos cookies, as necessidades que temos para criar esses cookies e quais são os tipos de cookies mantemos (temporários ou permanentes). A página também lista nossos provedores de análise de terceiros e provedores de outros serviços, detalhando exatamente em quais partes do nosso Site eles têm permissão de monitoramento. +Fornecemos mais informações sobre [cookies no GitHub](/github/site-policy/github-subprocessors-and-cookies#cookies-on-github) na nossa página [Subprocessadores e Cookies do GitHub](/github/site-policy/github-subprocessors-and-cookies) que descreve os cookies que definimos, a necessidade que temos para esses cookies e a expiração desses cookies. Ele também lista nossos provedores terceiros de análise e como você pode controlar suas configurações de preferência de cookies para esses cookies. #### Rastreamento e análise Usamos vários provedores de análise e de serviços de terceiros para ajudar a avaliar o uso dos nossos Usuários do GitHub, compilar relatórios estatísticos sobre a atividade e melhorar nosso conteúdo e o desempenho do nosso Site. Usamos esses provedores de análise de terceiros somente em determinadas áreas do nosso Site, e todos eles celebraram acordos de proteção de dados conosco que definem o tipo de Informações Pessoais de Usuário que podem coletar e os fins do processamento de informações. Ademais, usamos nosso próprio software interno de análise para oferecer recursos e melhorar nosso conteúdo e desempenho. -Alguns navegadores integraram recursos de "Não Rastrear" (DNT) que podem enviar um sinal aos sites que você acessa indicando que você não concorda com o rastreamento. O GitHub responde aos sinais de DNT dos navegadores e segue o [padrão do W3C de resposta aos sinais de DNT](https://www.w3.org/TR/tracking-dnt/). Caso você não tenha habilitado o DNT em um navegador compatível com esse recurso, os cookies de algumas partes do nosso Site rastrearão sua atividade de navegação online em outros serviços online ao longo do tempo, embora não permitamos que terceiros além de nossos provedores de análise e serviços monitorem a atividade dos Usuários do GitHub ao longo do tempo no GitHub. +Alguns navegadores integraram recursos de "Não Rastrear" (DNT) que podem enviar um sinal aos sites que você acessa indicando que você não concorda com o rastreamento. O GitHub responde aos sinais de DNT dos navegadores e segue o [padrão do W3C de resposta aos sinais de DNT](https://www.w3.org/TR/tracking-dnt/). Caso você não tenha habilitado o DNT em um navegador compatível com esse recurso, os cookies de algumas partes do nosso Site rastrearão sua atividade de navegação online em outros serviços online ao longo do tempo, embora não permitamos que terceiros além de nossos provedores de análise e serviços monitorem a atividade dos Usuários do GitHub ao longo do tempo no GitHub. Você pode ler mais sobre DNT na nossa seção [Acompanhamento do GitHub](/github/site-policy/github-subprocessors-and-cookies#tracking-on-github) da nossa página de [Subprocessadores e Cookies do GitHub](/github/site-policy/github-subprocessors-and-cookies). ### Como o GitHub protege suas informações @@ -248,7 +248,7 @@ Nenhum método de transmissão ou método de armazenamento eletrônico é 100% s ### Práticas globais de privacidade do GitHub -GitHub, Inc. and, for those in the European Economic Area, the United Kingdom, and Switzerland, GitHub B.V. are the controllers responsible for the processing of your personal information in connection with the Service, except (a) with respect to personal information that was added to a repository by its contributors, in which case the owner of that repository is the controller and GitHub is the processor (or, if the owner acts as a processor, GitHub will be the subprocessor); or (b) when you and GitHub have entered into a separate agreement that covers data privacy (such as a Data Processing Agreement). +GitHub, Inc. e, para aqueles do Espaço Econômico Europeu, Reino Unido e Suíça, os B.V. do GitHub são os controladores responsáveis pelo processamento das suas informações pessoais com relação ao Serviço, exceto (a) no que diz respeito a informações pessoais adicionadas a um repositório pelos seus contribuidores, em cujo caso, o proprietário desse repositório é o controlador e o GitHub é o processador (ou, se o proprietário atuar como processador, o GitHub será o subprocessador); ou (b) quando você e o GitHub tiverem celebrado um acordo separado que cubra a privacidade de dados (como um Contrato de Processamento de Dados). Nossos endereços são: diff --git a/translations/pt-BR/content/github/site-policy/github-registered-developer-agreement.md b/translations/pt-BR/content/github/site-policy/github-registered-developer-agreement.md index 6b5104c706a2..48158a971c2e 100644 --- a/translations/pt-BR/content/github/site-policy/github-registered-developer-agreement.md +++ b/translations/pt-BR/content/github/site-policy/github-registered-developer-agreement.md @@ -82,7 +82,7 @@ Este Contrato é um acordo legal entre você ("você") e o GitHub, Inc. ("GitHub 12. **Controle de exportação** - Você não tem permissão para exportar ou reexportar nenhuma das nossas Informações Confidenciais, exceto conforme autorizado pela lei dos Estados Unidos e pelas leis da jurisdição em que as Informações Confidenciais foram obtidas. Particularmente, você não está autorizado a exportar ou reexportar nossas Informações Confidenciais para qualquer país embargado pelos EUA, para qualquer pessoa na lista de Nacionais Especialmente Designados do Departamento do Tesouro dos EUA, ou para qualquer pessoa na Lista de Pessoas e Entidades do Departamento de Comércio dos EUA. países embargados, para qualquer um nos Estados Unidos Treasury Department's list of Specially Designated Nationals, or to anyone on the U.S. Department of Commerce Denied Person's List or Entity List. Ao aderir ao Programa ou receber qualquer uma de nossas Informações Confidenciais, você declara e garante que não está localizado em nenhum desses países ou em qualquer lista. + Você não tem permissão para exportar ou reexportar nenhuma das nossas Informações Confidenciais, exceto conforme autorizado pela lei dos Estados Unidos e pelas leis da jurisdição em que as Informações Confidenciais foram obtidas. Particularmente, você não está autorizado a exportar ou reexportar nossas Informações Confidenciais para qualquer país embargado pelos EUA, para qualquer pessoa na lista de Nacionais Especialmente Designados do Departamento do Tesouro dos EUA, ou para qualquer pessoa na Lista de Pessoas e Entidades do Departamento de Comércio dos EUA. países embargados, para qualquer um nos Estados Unidos Lista do Departamento do Tesouro dos Nacionais Designados Especialmente ou para qualquer pessoa dos EUA. Departamento de Comércio da Lista de Pessoas Indeferidas ou Lista de Entidades. Ao aderir ao Programa ou receber qualquer uma de nossas Informações Confidenciais, você declara e garante que não está localizado em nenhum desses países ou em qualquer lista. 13. **Direitos Proprietários** @@ -90,7 +90,7 @@ Este Contrato é um acordo legal entre você ("você") e o GitHub, Inc. ("GitHub 14. **Usuários do Governo** - Se você é uma entidade governamental, esta Seção se aplica a você. Algumas de nossas Informações Confidenciais podem ser consideradas "Itens Comerciais", conforme definido em 48 C.F.R. §2.101, consistindo em "Commercial Computer Software" e "Commercial Computer Software Documentation", pois tais termos são usados em 48 C.F.R. §12.212 ou 48 C.F.R. §227.7202, conforme aplicável. §2.101, consisting of “Commercial Computer Software” and “Commercial Computer Software Documentation”, as such terms are used in 48 C.F.R. §12.212 ou 48 C.F.R. §227.7202, conforme aplicável. Consistente com 48 C.F.R. §12.212 ou 48 C.F.R. §227.7202-1 through 227.7202-4, as applicable, the Commercial Computer Software and Commercial Computer Software Documentation are being licensed to U.S. Consistente com 48 C.F.R. §12.212 ou 48 C.F.R. §227.7202-1 até 227.7202-4, conforme aplicável, o Software Comercial de Computador e a Documentação de Software Comercial de Computador estão sendo licenciadas aos usuários finais do governo dos EUA (a) apenas como Itens Comerciais e (b) com apenas esses direitos que são concedidos a todos os outros usuários finais de acordo com os termos e condições aqui apresentados. GitHub, Inc. 88 Colin P. Kelly Street, San Francisco, CA 94107. + Se você é uma entidade governamental, esta Seção se aplica a você. Algumas de nossas Informações Confidenciais podem ser consideradas "Itens Comerciais", conforme definido em 48 C.F.R. §2.101, consistindo em "Commercial Computer Software" e "Commercial Computer Software Documentation", pois tais termos são usados em 48 C.F.R. §12.212 ou 48 C.F.R. §227.7202, conforme aplicável. §2.101, que consiste em “Software Computadores Comerciais” e “Documentação de Software de Computador Comercial”, uma vez que esses termos são utilizados em 48 C.F.R. §12.212 ou 48 C.F.R. §227.7202, conforme aplicável. Consistente com 48 C.F.R. §12.212 ou 48 C.F.R. §227.7202-1 a 227.7202-4, conforme aplicável, o Software de Computador Comercial e a documentação do Software de Computador Comercial estão sendo licenciados nos EUA. Consistente com 48 C.F.R. §12.212 ou 48 C.F.R. §227.7202-1 até 227.7202-4, conforme aplicável, o Software Comercial de Computador e a Documentação de Software Comercial de Computador estão sendo licenciadas aos usuários finais do governo dos EUA (a) apenas como Itens Comerciais e (b) com apenas esses direitos que são concedidos a todos os outros usuários finais de acordo com os termos e condições aqui apresentados. GitHub, Inc. 88 Colin P. Kelly Street, San Francisco, CA 94107. 15. **Desenvolvimento Independente** @@ -104,7 +104,7 @@ Este Contrato é um acordo legal entre você ("você") e o GitHub, Inc. ("GitHub As partes deste Acordo são contratantes independentes. Nenhum de nós será considerado empregado, agente, sócio, franqueador, franqueado ou representante legal do outro para qualquer finalidade e nenhum de nós terá qualquer direito, poder ou autoridade para criar qualquer obrigação ou responsabilidade em nome do outro. -18. **Assignment** +18. **Atividade** Você não está autorizado a atribuir ou transferir este Contrato, ou qualquer um de seus direitos sob ele, no todo ou em parte, por operação da lei ou de outra forma, sem o nosso consentimento prévio por escrito. diff --git a/translations/pt-BR/content/github/site-policy/github-sponsors-additional-terms.md b/translations/pt-BR/content/github/site-policy/github-sponsors-additional-terms.md index 28aaf3e22af3..2c273f1dccbf 100644 --- a/translations/pt-BR/content/github/site-policy/github-sponsors-additional-terms.md +++ b/translations/pt-BR/content/github/site-policy/github-sponsors-additional-terms.md @@ -94,7 +94,7 @@ O Programa fornece a você a capacidade de oferecer Assinaturas. Se você decidi O Programa ou Serviço pode fornecer a você a possibilidade de aceitar uma doação ou outro tipo de Patrocínio direto de outro Usuário, sem uma oferta de Assinatura. Entretanto, como o GitHub não concretiza esses tipos de Patrocínios, você deve estabelecer uma conta comercial com um fornecedor de serviços de pagamento terceiro (por exemplo, Stripe) e estar sujeito aos termos, condições e políticas de privacidade da conta comercial daquele fornecedor de serviços. Quaisquer valores disponibilizados a você, doações ou outros, serão pagos diretamente na sua conta comercial e não serão incluídos em quaisquer Pagamentos ao Desenvolvedor Patrocinado. Você concorda que não apresentará nenhuma reivindicação ou recurso contra o GitHub relacionado a doações, e quaisquer disputas relacionadas a uma doação serão unicamente entre você e o fornecedor de serviços de pagamento terceiro. Você é responsável pelo cumprimento de quaisquer contratos, políticas, leis ou regulamentos de fornecedores de serviços de pagamento terceiros que possam ser aplicáveis. Para sua comodidade, o GitHub pode optar por fornecer a você informações ou um relatório sobre o valor de doações feitas. ##### 3.3.3. Publicidade. -Embora entendamos que você pode querer promover seus Patrocinadores publicando seus nomes ou logotipos em sua conta, o foco principal do Conteúdo de Desenvolvedor Patrocinado não deve ser a publicidade ou o marketing promocional. Além disso, você não poderá aderir a qualquer contrato de publicidade para promover qualquer produto ou marca, pois isso é proibido pelo [Contrato](/github/site-policy/github-terms-of-service) ou pelas Diretrizes da Comunidade GitHub. Se você decidir hospedar quaisquer materiais publicitários ou promocionais em seu Conteúdo de Desenvolvedor Patrocinado, você é o único responsável por cumprir todas as leis e regulamentos aplicáveis, inclusive, sem limitações, as Diretrizes sobre Endossos e Testemunhos da Comissão Federal de Comércio dos EUA. Federal Trade Commission's Guidelines on Endorsements and Testimonials. +Embora entendamos que você pode querer promover seus Patrocinadores publicando seus nomes ou logotipos em sua conta, o foco principal do Conteúdo de Desenvolvedor Patrocinado não deve ser a publicidade ou o marketing promocional. Além disso, você não poderá aderir a qualquer contrato de publicidade para promover qualquer produto ou marca, pois isso é proibido pelo [Contrato](/github/site-policy/github-terms-of-service) ou pelas Diretrizes da Comunidade GitHub. Se você decidir hospedar quaisquer materiais publicitários ou promocionais em seu Conteúdo de Desenvolvedor Patrocinado, você é o único responsável por cumprir todas as leis e regulamentos aplicáveis, inclusive, sem limitações, as Diretrizes sobre Endossos e Testemunhos da Comissão Federal de Comércio dos EUA. Diretrizes da Comissão Federal do Comércio sobre Recomendações e Depoimentos. ### 4. Termos Financeiros. diff --git a/translations/pt-BR/content/github/site-policy/github-statement-against-modern-slavery-and-child-labor.md b/translations/pt-BR/content/github/site-policy/github-statement-against-modern-slavery-and-child-labor.md index e663c566ec93..170553f0c808 100644 --- a/translations/pt-BR/content/github/site-policy/github-statement-against-modern-slavery-and-child-labor.md +++ b/translations/pt-BR/content/github/site-policy/github-statement-against-modern-slavery-and-child-labor.md @@ -42,7 +42,7 @@ A cadeia de fornecedores do GitHub consiste em bens e serviços para nossos prod **O Padrão de Conduta do GitHub** proíbe condutas inseguras e ilegais, incluindo o uso consciente, a participação, o apoio ou a tolerância à escravidão moderna (escravidão, trabalho forçado ou obrigatório, tráfico, servidão ou trabalhadores presos, coagidos ou obrigados) ou ao trabalho infantil. -O GitHub está em conformidade com as leis que proíbem o tráfico e o trabalho infantil nas jurisdições em que opera, incluindo o [Regulamento Federal de Aquisição dos EUA 22.17 sobre a luta contra o tráfico de seres humanos](https://www.govinfo.gov/content/pkg/CFR-2009-title48-vol1/pdf/CFR-2009-title48-vol1-part22-subpart22-17.pdf). Federal Acquisition Regulation 22.17 on combatting human trafficking. +O GitHub está em conformidade com as leis que proíbem o tráfico e o trabalho infantil nas jurisdições em que opera, incluindo o [Regulamento Federal de Aquisição dos EUA 22.17 sobre a luta contra o tráfico de seres humanos](https://www.govinfo.gov/content/pkg/CFR-2009-title48-vol1/pdf/CFR-2009-title48-vol1-part22-subpart22-17.pdf). Regulamento 2.17 da Aquisição Federal sobre o combate ao tráfico de seres humanos. Além disso, o GitHub estabeleceu uma parceria com o Programa FairHotel, o que significa que o GitHub encoraja os seus funcionários a escolherem os hotéis endossados pelo FairHotel, certificando que os trabalhadores têm salários justos, benefícios adequados e têm suas opiniões ouvidas no ambiente de trabalho. Ser um parceiro do FairHotel também significa que o GitHub oferece negócios para hotéis como um empregador justo. diff --git a/translations/pt-BR/content/github/site-policy/github-subprocessors-and-cookies.md b/translations/pt-BR/content/github/site-policy/github-subprocessors-and-cookies.md index edfdefe096f7..0d15a034ff17 100644 --- a/translations/pt-BR/content/github/site-policy/github-subprocessors-and-cookies.md +++ b/translations/pt-BR/content/github/site-policy/github-subprocessors-and-cookies.md @@ -10,7 +10,7 @@ versions: free-pro-team: '*' --- -Entrada em vigor: **12 de agosto de 2020** +Data de vigência: **2 de outubro 2020** O GitHub fornece um grande acordo de transparência em relação à forma como usamos seus dados, como os coletamos e com quem compartilhamos. Para tanto, nós fornecemos esta página, que detalha [nossos subprocessadores](#github-subprocessors), como usamos [cookies](#cookies-on-github), e onde e como executamos qualquer [rastreamento no GitHub](#tracking-on-github). @@ -19,7 +19,7 @@ O GitHub fornece um grande acordo de transparência em relação à forma como u Quando compartilhamos suas informações com terceiros subprocessadores, tais como nossos fornecedores e provedores de serviços, permanecemos responsáveis por elas. Trabalhamos muito duro para manter sua confiança quando trazemos novos fornecedores, e exigimos que todos os fornecedores se submetam a contratos de proteção de dados conosco que restringem seu processamento de Informações Pessoais dos Usuários (conforme definido na [Declaração de Privacidade](/articles/github-privacy-statement/)). | Nome do subprocessador | Descrição do processamento | Local do Processamento | Localização corporativa | -| ---------------------- | --------------------------------------------------------------------- | ---------------------- | ----------------------- | +|:---------------------- |:--------------------------------------------------------------------- |:---------------------- |:----------------------- | | Automattic | Serviço de blogs | Estados Unidos | Estados Unidos | | AWS Amazon | Hospedagem de dados | Estados Unidos | Estados Unidos | | Braintree (PayPal) | Processador de pagamento de assinatura com cartão de crédito | Estados Unidos | Estados Unidos | @@ -28,7 +28,7 @@ Quando compartilhamos suas informações com terceiros subprocessadores, tais co | DiscoverOrg | Serviço de enriquecimento de dados de marketing | Estados Unidos | Estados Unidos | | Eloqua | Automatização da campanha marketing | Estados Unidos | Estados Unidos | | Google Apps | Infraestrutura interna da empresa | Estados Unidos | Estados Unidos | -| Google Analytics | Análise e desempenho de sites | Estados Unidos | Estados Unidos | +| Google Analytics | Análise e desempenho | Estados Unidos | Estados Unidos | | LinkedIn Navigator | Serviço de enriquecimento de dados de marketing | Estados Unidos | Estados Unidos | | Magic Robot | Relatórios de campanha (Complemento para Vendas) | Estados Unidos | Estados Unidos | | MailChimp | Fornecedor de serviços de correio para emissão de bilhetes a clientes | Estados Unidos | Estados Unidos | @@ -49,63 +49,49 @@ Quando trouxermos um novo subprocessador que lida com as Informações Pessoais ### Cookies no GitHub -O GitHub usa cookies para tornar as interações com nosso serviço fáceis e significativas. Usamos cookies (e tecnologias similares, como HTML5 localStorage) para mantê-lo conectado, lembrar de suas preferências, fornecer informações para o desenvolvimento futuro do GitHub e anunciar os produtos e serviços do GitHub para você em sites de terceiros. - -Um cookie é um pequeno pedaço de texto que nosso servidor web armazena em seu computador ou dispositivo móvel, que seu navegador nos envia quando você retorna ao nosso site. Os cookies não necessariamente o identificam se você está apenas visitando o GitHub; no entanto, um cookie pode armazenar um identificador exclusivo para cada usuário conectado. Usamos cookies para mantermos você logado, lembrarmos de suas preferências e fornecermos informações para o desenvolvimento futuro do GitHub. Por motivos de segurança, usamos cookies para identificar um dispositivo. Ao usar o nosso site, você concorda que podemos inserir esses tipos de cookies no seu computador ou dispositivo. Se você desativar o navegador ou a capacidade de o seu dispositivo aceitar cookies, não será possível fazer login nem usar os serviços do GitHub. Em determinadas áreas do site, também podemos usar cookies para identificar você e/ou seu dispositivo a fim de anunciar produtos e serviços no GitHub para você em sites de terceiros. - -O GitHub define os seguintes cookies para os nossos usuários pelos seguintes motivos: - -| Nome do Cookie | Motivo | -| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `user_session` | Este cookie é usado para fazer seu login. | -| `logged_in` | Este cookie é usado para sinalizar que o usuário já está logado. | -| `dotcom_user` | Este cookie é usado para sinalizar que o usuário já está logado. | -| `_gh_sess` | Este cookie é usado para aplicação temporária e para o estado do framework entre páginas, como por exemplo, em qual etapa o usuário está em um formulário de várias etapas. | -| `tz` | Este cookie permite que seu navegador nos diga em que fuso horário você está. | -| `gist_user_session` | Este cookie é usado pelo Gist ao ser executado em um host separado. | -| `saml_csrf_token` | Este cookie é definido pelo método de caminho de autenticação SAML para associar um token ao cliente. | -| `saml_return_to` | Este cookie é definido pelo método de caminho de autenticação SAML para manter o estado durante o loop de autenticação SAML. | -| `gist_oauth_csrf` | Este cookie é definido pelo Gist para garantir que o usuário que iniciou o fluxo de autenticação seja o mesmo usuário que o completa. | -| `__Host-user_session_same_site` | Este cookie foi definido para garantir que os navegadores que suportam cookies do SameSite possam verificar se uma solicitação é originária do GitHub. | -| `__Host-gist_user_session_same_site` | Este cookie foi definido para garantir que os navegadores que suportam cookies do SameSite possam verificar se uma solicitação é originária do GitHub. | -| `_ga` | Este cookie é usado pelo Google Analytics. | -| `_gat` | Este cookie é usado pelo Google Analytics. | -| `_gid` | Este cookie é usado pelo Google Analytics. | -| `_octo` | Este cookie é usado pela Octolytics, nosso serviço de análise interna, para distinguir usuários e clientes únicos. | -| `tracker` | Este cookie rastreia a fonte de referência para análise de inscrição. | - -Algumas páginas em nosso site podem definir cookies de terceiros. Por exemplo, podemos incorporar conteúdo, como vídeos, de outro site que define um cookie. Embora tentemos minimizar esses cookies de terceiros, nem sempre podemos controlar quais cookies esse conteúdo de terceiros define. +O GitHub usa cookies e tecnologias semelhantes (coletivamente denominados “cookies”) para fornecer e proteger nossos sites, bem como analisar o uso dos nossos sites, para oferecer a você uma ótima experiência de usuário. Consulte nossa [Declaração de privacidade](/github/site-policy/github-privacy-statement#our-use-of-cookies-and-tracking) se você quiser saber mais informações sobre cookies e sobre como e por que os usamos. + +Como o número e os nomes dos cookies podem mudar, a tabela abaixo pode ser atualizada de vez em quando. + +| Provedor de serviço | Nome do cookie | Descrição | Vencimento* | +|:------------------- |:------------------------------------ |:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:---------------------------------------------------------------------------- | +| GitHub | `app_manifest_token` | Este cookie é usado durante o fluxo do manifesto do aplicativo para manter o estado do fluxo durante o redirecionamento para buscar uma sessão do usuário. | cinco minutos | +| GitHub | `cookie-preferences` | Este cookie é usado para rastrear preferências de cookie do usuário. | um ano | +| GitHub | `_device_id` | Este cookie é usado para rastrear dispositivos reconhecidos. | um ano | +| GitHub | `dotcom_user` | Este cookie é usado para sinalizar que o usuário já está logado. | um ano | +| GitHub | `_gh_ent` | Este cookie é usado para aplicação temporária e para o estado da estrutura entre páginas, como em que etapa o cliente se encontra em um processo de várias etapas. | duas semanas | +| GitHub | `_gh_sess` | Este cookie é usado para aplicação temporária e para o estado do framework entre páginas, como por exemplo, em qual etapa o usuário está em um formulário de várias etapas. | sessão | +| GitHub | `gist_oauth_csrf` | Este cookie é definido pelo Gist para garantir que o usuário que iniciou o fluxo de autenticação seja o mesmo usuário que o completa. | excluído quando o estado do oauth é validado | +| GitHub | `gist_user_session` | Este cookie é usado pelo Gist ao ser executado em um host separado. | duas semanas | +| GitHub | `has_recent_activity` | Este cookie é usado para impedir a exibição de intersticial de segurança para usuários que visitaram o aplicativo recentemente. | uma hora | +| GitHub | `__Host-gist_user_session_same_site` | Este cookie foi definido para garantir que os navegadores que suportam cookies do SameSite possam verificar se uma solicitação é originária do GitHub. | duas semanas | +| GitHub | `__Host-user_session_same_site` | Este cookie foi definido para garantir que os navegadores que suportam cookies do SameSite possam verificar se uma solicitação é originária do GitHub. | duas semanas | +| GitHub | `logged_in` | Este cookie é usado para sinalizar que o usuário já está logado. | um ano | +| GitHub | `marketplace_repository_ids` | Este cookie é usado para o fluxo de instalação do marketplace. | uma hora | +| GitHub | `marketplace_suggested_target_id` | Este cookie é usado para o fluxo de instalação do marketplace. | uma hora | +| GitHub | `_octo` | Este cookie é usado pelo nosso serviço interno de análise para distinguir usuários e clientes únicos. | um ano | +| GitHub | `org_transform_notice` | Este cookie é usado para fornecer aviso durante a transformação da organização. | uma hora | +| GitHub | `private_mode_user_session` | Este cookie é usado para solicitações de autenticação da empresa. | duas semanas | +| GitHub | `saml_csrf_token` | Este cookie é definido pelo método de caminho de autenticação SAML para associar um token ao cliente. | até que o usuário feche o navegador ou conclua a solicitação de autenticação | +| GitHub | `saml_csrf_token_legacy` | Este cookie é definido pelo método de caminho de autenticação SAML para associar um token ao cliente. | até que o usuário feche o navegador ou conclua a solicitação de autenticação | +| GitHub | `saml_return_to` | Este cookie é definido pelo método de caminho de autenticação SAML para manter o estado durante o loop de autenticação SAML. | até que o usuário feche o navegador ou conclua a solicitação de autenticação | +| GitHub | `saml_return_to_legacy` | Este cookie é definido pelo método de caminho de autenticação SAML para manter o estado durante o loop de autenticação SAML. | até que o usuário feche o navegador ou conclua a solicitação de autenticação | +| GitHub | `tz` | Este cookie permite que seu navegador nos diga em que fuso horário você está. | sessão | +| GitHub | `user_session` | Este cookie é usado para fazer seu login. | duas semanas | +| Google Analytics** | `_ga` | Este cookie é usado pelo Google Analytics. | dois anos | +| Google Analytics** | `_gat` | Este cookie é usado pelo Google Analytics. | um minuto | +| Google Analytics** | `_gid` | Este cookie é usado pelo Google Analytics. | um dia | + +_*_ A data de **expiração** para os cookies listados abaixo geralmente se aplicam em uma base contínua. + +_**_ Utilizamos o **Google Analytics** como um serviço de análise de terceiros para coletar informações sobre o desempenho do nosso site e como nossos usuários navegam e usam o GitHub de modo geral. Isso nos ajuda a avaliar o uso do GitHub pelos nossos usuários, compilar relatórios estatísticos sobre atividades e melhorar nosso conteúdo e desempenho do site. + +Você pode controlar suas preferências de cookie do Google Analytics através do nosso link de preferência de cookie, localizado no rodapé do nosso site. Além disso, o Google fornece mais informações sobre suas próprias práticas de privacidade e [oferece um complemento do navegador para desativar o acompanhamento do Google Analytics](https://tools.google.com/dlpage/gaoptout). + +(!) Observe que certas páginas do nosso site podem definir outros cookies de terceiros. Por exemplo, podemos incorporar conteúdo, como vídeos, de outro site que define um cookie. Embora tentemos minimizar esses cookies de terceiros, nem sempre podemos controlar quais cookies esse conteúdo de terceiros define. ### Rastreamento no GitHub -"[Não rastreie](https://www.eff.org/issues/do-not-track)" (DNT) é uma preferência de privacidade que você pode definir em seu navegador se você não quiser que serviços online - especificamente redes de anúncios - coletem e compartilhem certos tipos de informações sobre sua atividade online a partir de serviços de rastreamento de terceiros. O GitHub responde aos sinais de DNT dos navegadores e segue o [padrão do W3C de resposta aos sinais de DNT](https://www.w3.org/TR/tracking-dnt/). Se você deseja configurar seu navegador para sinalizar que não gostaria de ser rastreado, verifique a documentação do seu navegador para saber como ativar essa sinalização. Há também bons aplicativos que bloqueiam o rastreamento online, como [Badger de Privacidade](https://www.eff.org/privacybadger). - -Caso você não tenha habilitado o DNT em um navegador compatível com esse recurso, os cookies de algumas partes do nosso site rastrearão sua atividade de navegação online em outros serviços online ao longo do tempo, embora não permitamos que terceiros além de nossos provedores de análise e serviços monitorem a atividade dos usuários do GitHub ao longo do tempo no GitHub. Usamos esses cookies para nos permitir anunciar produtos e serviços do GitHub a você em sites e serviços de terceiros. Também temos contratos com certos fornecedores, como provedores de análise, que nos ajudam a rastrear os movimentos dos visitantes em determinadas páginas do nosso site. Apenas nossos fornecedores, que estão coletando informações pessoais em nosso nome, podem coletar dados em nossas páginas, e assinamos contratos de proteção de dados com cada fornecedor que recolhe esses dados em nosso nome. Usamos os dados que recebemos desses fornecedores para entender melhor os interesses de nossos visitantes, entender o desempenho de nosso site e melhorar nosso conteúdo. Qualquer fornecedor de análise será listado em nossa Lista de Subprocessadores acima, e você pode ver uma lista de cada página onde coletamos esse tipo de dados abaixo. - -#### Google Analytics - -Usamos o Google Analytics como um serviço de análise terceirizado e para rastrear nossas campanhas de publicidade em sites e serviços de terceiros. Usamos o Google Analytics para coletar informações sobre o desempenho do nosso site e como nossos usuários, em geral, navegam e usam o GitHub. Isso nos ajuda a avaliar o uso do GitHub por nossos usuários; compilar relatórios estatísticos sobre a atividade; e melhorar o conteúdo e desempenho do nosso site. O Google fornece mais informações sobre suas próprias práticas de privacidade e [oferece um complemento do navegador para desativar o rastreamento do Google Analytics](https://tools.google.com/dlpage/gaoptout). - -#### Páginas no GitHub onde o analytics pode estar ativado - -Páginas em URLs que contenham qualquer um dos seguintes domínios e caminhos (incluindo quaisquer subdomínios ou subcaminhos) em nossos sites podem ter o analytics ou outro código de rastreamento ativado. Se quiser nos impedir de coletar informações sobre sua atividade de navegação no GitHub, você pode usar um bloqueador de rastreamento, como o [Badger de Privacidade](https://www.eff.org/privacybadger) ou desativar o rastreamento do Google Analytics. - -- github.com/home (se você está desconectado ou não tem uma conta, esta é a página que você verá quando visitar github.com) -- github.com/about -- github.blog -- github.com/enterprise -- github.com/collections -- github.com/developer-stories -- github.com/events -- github.com/explore -- github.com/features -- github.com/logos -- github.com/nonprofit -- github.com/open-source -- github.com/personal -- github.com/pricing -- github.com/ten -- github.com/trending -- resources.github.com -- de.github.com -- fr.github.com +"[Não rastrear](https://www.eff.org/issues/do-not-track)" (DNT) é uma preferência de privacidade que você pode definir no seu navegador se não quiser que os serviços on-line coletem e compartilhem certos tipos de informações sobre asua atividade on-line de serviços de rastreamento de terceiros. O GitHub responde aos sinais de DNT dos navegadores e segue o [padrão do W3C de resposta aos sinais de DNT](https://www.w3.org/TR/tracking-dnt/). Se você deseja configurar seu navegador para sinalizar que não gostaria de ser rastreado, verifique a documentação do seu navegador para saber como ativar essa sinalização. Há também bons aplicativos que bloqueiam o rastreamento online, como [Badger de Privacidade](https://www.eff.org/privacybadger). + +Caso você não tenha habilitado o DNT em um navegador compatível com esse recurso, os cookies de algumas partes do nosso site rastrearão sua atividade de navegação online em outros serviços online ao longo do tempo, embora não permitamos que terceiros além de nossos provedores de análise e serviços monitorem a atividade dos usuários do GitHub ao longo do tempo no GitHub. Temos acordos com certos fornecedores, como fornecedores de análise, que nos ajudam a rastrear os movimentos dos visitantes em determinadas páginas no nosso site. Apenas nossos fornecedores, que estão coletando informações pessoais em nosso nome, podem coletar dados em nossas páginas, e assinamos contratos de proteção de dados com cada fornecedor que recolhe esses dados em nosso nome. Usamos os dados que recebemos desses fornecedores para entender melhor os interesses de nossos visitantes, entender o desempenho de nosso site e melhorar nosso conteúdo. Qualquer fornecedor de análise será listado na nossa [lista de subprocessadores](#github-subprocessors), e você pode ver uma lista de cada página em que coletamos esse tipo de dados abaixo. diff --git a/translations/pt-BR/content/github/site-policy/github-supplemental-terms-for-microsoft-volume-licensing.md b/translations/pt-BR/content/github/site-policy/github-supplemental-terms-for-microsoft-volume-licensing.md index 9ce8ac9a3199..c55011a2c814 100644 --- a/translations/pt-BR/content/github/site-policy/github-supplemental-terms-for-microsoft-volume-licensing.md +++ b/translations/pt-BR/content/github/site-policy/github-supplemental-terms-for-microsoft-volume-licensing.md @@ -43,25 +43,25 @@ O GitHub concede ao Cliente uma licença não exclusiva, não transferível, mun Exceto quando expressamente permitido por lei ou por licença de terceiros aplicável, o Cliente e suas Afiliadas não deve (nem permitir que algum terceiro o faça): (i) sublicenciar, vender, alugar, arrendar, transferir, ceder ou redistribuir o Software; (ii) hospedar o Software em benefício de terceiros; (iii) divulgar ou permitir que terceiros acessem o Software, exceto conforme expressamente permitido nesta Seção 1; (iv) hackear ou modificar a Chave de licença, ou evitar ou alterar qualquer processo de registro de licença; (v) exceto no caso de Modificações do cliente, modificar ou criar trabalhos derivados do Software ou mesclar o Software com outro software; (vi) desmontar, descompilar, ignorar qualquer ofuscação de código ou, de outra forma, fazer engenharia reversa do Software ou tentar derivar seu código-fonte, parcial ou totalmente; (vii) modificar, obscurecer ou excluir avisos de direitos de propriedade incluídos no Software ou na Documentação; ou (viii) usar ou copiar o Software ou a Documentação de alguma forma não expressamente permitida por esses Termos Suplementares do GitHub. -### 1.3 Delivery. +### 1.3 Entrega. -O GitHub disponibilizará a Chave de licença ser baixada pelo Cliente em um site seguro e protegido por senha. All deliveries under this Section 1 will be electronic. Para evitar dúvidas, o Cliente é responsável pela instalação de qualquer Software e reconhece que o GitHub não tem mais nenhuma obrigação de entrega em relação ao Software após o recebimento da Chave de licença pelo Cliente. À medida que as Atualizações forem sendo emitidas, o GitHub as disponibilizará para download no mesmo site. O Cliente deve atualizar o Software em uma base comercialmente razoável, mas não menos de 01 (uma) vez por ano. O Cliente é responsável por manter a confidencialidade dos nomes de usuário e das senhas do Cliente. +O GitHub disponibilizará a Chave de licença ser baixada pelo Cliente em um site seguro e protegido por senha. Todas as entregas nesta Seção 1 serão eletrônicas. Para evitar dúvidas, o Cliente é responsável pela instalação de qualquer Software e reconhece que o GitHub não tem mais nenhuma obrigação de entrega em relação ao Software após o recebimento da Chave de licença pelo Cliente. À medida que as Atualizações forem sendo emitidas, o GitHub as disponibilizará para download no mesmo site. O Cliente deve atualizar o Software em uma base comercialmente razoável, mas não menos de 01 (uma) vez por ano. O Cliente é responsável por manter a confidencialidade dos nomes de usuário e das senhas do Cliente. -### 1.4 Verification. +### 1.4 Verificação. A pedido do GitHub, o Cliente fornecerá prontamente ao GitHub um relatório gerado pelo Software verificando se o cliente está usando o Software de acordo com esses Termos Complementares do GitHub. O GitHub cobrará do Cliente por qualquer uso adicional, a partir da data em que o uso excedeu os termos desses Termos Complementares do GitHub -### 1.5 Support +### 1.5 Suporte O GitHub fornecerá suporte técnico para o Software, conforme descrito no Contrato de Clientes da Microsoft. O GitHub pode fornecer ofertas de Suporte aprimorado para o Software e o Serviço (incluindo as ofertas Premium, Premium Plus e Suporte Direto de Engenharia) de acordo com os [termos de Suporte](/enterprise/admin/enterprise-support/about-github-premium-support-for-github-enterprise)e no nível de Suporte, Taxas e Termo de Assinatura especificados em um Formulário de Pedido ou SOW. Não obstante qualquer coisa em contrário no Contrato com o Cliente Microsoft, (i) o GitHub aplicará esforços razoáveis para corrigir qualquer material, erros reproduzíveis no Software após a notificação ao Cliente de um erro, mas não será responsável por fornecer Suporte quando (a) alguém (além do GitHub) modifique o Software; (b) o Cliente altere seu sistema operacional ou ambiente de forma a afetar negativamente o Software ou seu desempenho; (c) o Cliente usa o Software de uma maneira diferente da autorizada sob o Contrato com o Cliente Microsoft, nesta Seção 1 ou na Documentação; ou (d) haja um acidente ou negligência do Cliente, ou uso indevido do Software; e (ii) o GitHub só dará suporte a uma determinada versão por um (1) ano a partir da data de lançamento original, ou seis (6) meses da última Atualização da Versão, o que for mais longo. -### 1.6 Updates; Releases. +### 1.6 Atualizações; Versões. -#### 1.6.1 Generally. +#### 1.6.1 De forma geral. O GitHub disponibilizará atualizações e versões do Software ao Cliente no mesmo site seguro em que o Cliente baixou o Software e a Chave de licença. -#### 1.6.2 Supported Releases. +#### 1.6.2 Versões compatíveis. O GitHub só dará Suporte a uma determinada Versão do Software por 01 (um) ano a partir da data da Versão original ou 06 (seis) meses a partir da última Atualização da Versão, o que for mais longo. Se o Cliente necessitar de Suporte para Versões anteriores do Software, deverá pagar por esse Suporte de acordo com os termos de um Formulário de pedido ou uma SOW acordados mutuamente. @@ -77,19 +77,19 @@ Se o uso planejado do GitHub Insights ou do Learning Lab for Enterprise Server e O GitHub garante que, por noventa (90) dias a partir da data em que for disponibilizado para download inicial, o Software não modificado estará substancialmente em conformidade com sua Documentação. O GitHub não garante que o uso do Software pelo Cliente será ininterrupto ou que a operação do Software será isenta de erros. Esta garantia não se aplicará se o Cliente modificar ou usar o Software de qualquer forma que não seja expressamente permitida por esta Seção 1 e pela Documentação. A única obrigação do GitHub, e o único remédio do Cliente, para qualquer violação desta garantia limitada será conforme estabelecido no Contrato com o Cliente da Microsoft. -## SECTION 2: GITHUB ENTERPRISE CLOUD TERMS OF SERVICE +## SEÇÃO 2: TERMOS DE SERVIÇO DO GITHUB ENTERPRISE CLOUD -Upon creation of a Corporate Account and/or an Organization on the Service by Customer or by GitHub on Customer’s behalf, this Section 2 details terms applicable to Customer’s use of the Service. +Após a criação de uma Conta corporativa e/ou uma Organização no Serviço pelo Cliente ou pelo GitHub em nome do Cliente, esta Seção 2 detalha os termos aplicáveis ao uso do Serviço pelo Cliente. -### 2.1 Account Terms. +### 2.1 Termos da conta. -#### 2.1.1 Account Controls. +#### 2.1.1 Controles da conta. **(i) Usuários**. O Cliente reconhece que os Usuários mantêm o controle administrativo final sobre suas contas individuais e o Conteúdo dentro delas. [Termos de Serviço Padrão do GitHub](/github/site-policy/github-terms-of-service) rege o uso do Serviço pelos Usuários, exceto no que diz respeito às atividades dos Usuários, sob esta Seção 2. - **(ii) Organizations.** Customer retains ultimate administrative control over any Organization created on Customer’s behalf and User-Generated Content posted to the repositories within its Organization(s), subject to this Section 2. This Section 2 will govern the use of Customer’s Organization(s). + **(ii) Organizações**. O Cliente mantém o controle administrativo definitivo sobre qualquer Organização criada em nome do Cliente e qualquer Conteúdo gerado pelo Usuário que seja postado nos repositórios dentro das Organizações, sujeitos a esta Seção 2. Esta Seção 2 regerá o uso das Organizações do Cliente. -#### 2.1.2 Account Requirements. +#### 2.1.2 Requisitos da conta. Para criar uma conta, o Cliente deve atender às seguintes condições: @@ -97,91 +97,91 @@ Para criar uma conta, o Cliente deve atender às seguintes condições: **(ii)** O login de um Usuário não pode ser compartilhado por várias pessoas. -**(iii)** O Cliente não deverá usar o Serviço (a) se isso violar o controle de exportação ou as leis de sanções dos Estados Unidos ou de qualquer outra jurisdição aplicável; (b) se ele estiver localizado ou residir normalmente em um país ou território sujeito a sanções abrangentes administradas pelo Escritório de Controle de Ativos Estrangeiros (OFAC – Office of Foreign Assets Control) do Departamento do Tesouro Americano ou (c) se o Cliente é ou representa um [cidadão designado especialmente](https://www.treasury.gov/resource-center/sanctions/SDN-List/Pages/default.aspx) (SDN – Specially Designated National) ou uma pessoa sujeita a bloqueio semelhante ou a proibições partidárias negadas. Office of Foreign Assets Control (OFAC), or (c) if Customer is or is working on behalf of a [Specially Designated National (SDN)](https://www.treasury.gov/resource-center/sanctions/SDN-List/Pages/default.aspx) or a person subject to similar blocking or denied party prohibitions. Para obter mais informações, consulte a [Política de Controles Comerciais do GitHub](/github/site-policy/github-and-trade-controls). +**(iii)** O Cliente não deverá usar o Serviço (a) se isso violar o controle de exportação ou as leis de sanções dos Estados Unidos ou de qualquer outra jurisdição aplicável; (b) se ele estiver localizado ou residir normalmente em um país ou território sujeito a sanções abrangentes administradas pelo Escritório de Controle de Ativos Estrangeiros (OFAC – Office of Foreign Assets Control) do Departamento do Tesouro Americano ou (c) se o Cliente é ou representa um [cidadão designado especialmente](https://www.treasury.gov/resource-center/sanctions/SDN-List/Pages/default.aspx) (SDN – Specially Designated National) ou uma pessoa sujeita a bloqueio semelhante ou a proibições partidárias negadas. O Escritório e Controle de Ativos Estrangeiros (OFAC); ou (c) se o Cliente estiver trabalhando em nome de um [Nacional Especialmente Designado (SDN)](https://www.treasury.gov/resource-center/sanctions/SDN-List/Pages/default.aspx) ou de pessoa sujeita a bloqueios semelhantes ou proibições de partes negadas. Para obter mais informações, consulte a [Política de Controles Comerciais do GitHub](/github/site-policy/github-and-trade-controls). -#### 2.1.3 Account Security. +#### 2.1.3 Segurança da conta. -O cliente é responsável por: (i) todo o Conteúdo postado e pela atividade que ocorre na Conta corporativa dele; (ii) manter a segurança de suas credenciais de login de conta; e (iii) [notificar o GitHub](https://support.github.com/contact) prontamente ao tomar conhecimento de qualquer uso não autorizado ou acesso ao Serviço por meio de sua conta. GitHub will not be liable for any loss or damage from Customer’s failure to comply with this Section 2.1.3. +O cliente é responsável por: (i) todo o Conteúdo postado e pela atividade que ocorre na Conta corporativa dele; (ii) manter a segurança de suas credenciais de login de conta; e (iii) [notificar o GitHub](https://support.github.com/contact) prontamente ao tomar conhecimento de qualquer uso não autorizado ou acesso ao Serviço por meio de sua conta. O GitHub não será responsabilizado por qualquer perda ou dano causado se o Cliente não cumprir o disposto nesta Seção 2.1.3. -#### 2.1.4 Additional Terms. +#### 2.1.4 Termos adicionais. Em algumas situações, os termos de terceiros podem ser aplicados ao uso do serviço pelo Cliente. Por exemplo, o Cliente pode ser integrante de uma Organização com seus próprios termos ou contratos de licença. O cliente poderá baixar um aplicativo que se integra ao Serviço ou utilizar o Serviço para autenticar em outro serviço. Embora o Contrato com o Cliente Microsoft, incluindo esses Termos Complementares do GitHub, sejam o contrato completo do GitHub com o Cliente, os termos de outras partes regem seus relacionamentos com o Cliente. -#### 2.1.5 Termos do Governo Federal do EUA. Federal Government Terms. +#### 2.1.5 Termos do Governo Federal do EUA. Termos do Governo Federal. Se o cliente é dos EUA. Se o Cliente for uma agência do Governo Federal dos EUA ou que acessa ou usa qualquer parte do Serviço em instalações governamentais, a [Emenda do Governo Federal dos EUA](https://help.github.com/github/site-policy/amendment-to-github-terms-of-service-applicable-to-us-federal-government-users) se aplicará e o cliente concordará com as disposições dela. Aplica-se a alteração do Governo Federal e o Cliente concorda com suas disposições. -### 2.2 Compliance with Laws; Acceptable Use; Privacy. +### 2.2 Cumprimento das leis; Uso aceitável; Privacidade. -#### 2.2.1 Compliance with Laws and Regulations. +#### 2.2.1 Cumprimento de leis e regulamentos. O uso do Serviço pelo Cliente não deve violar os regulamentos ou as leis aplicáveis na sua jurisdição, como leis de direitos autorais ou de marcas registradas e leis de controle de exportação. -#### 2.2.2 Acceptable Use. +#### 2.2.2 Uso aceitável. O uso do Serviço pelo Cliente deve estar em conformidade com as [Políticas de Uso Aceitável do GitHub](/github/site-policy/github-acceptable-use-policies) e as [Diretrizes da Comunidade do GitHub](/github/site-policy/github-community-guidelines). O Cliente não deve usar o Serviço em qualquer jurisdição para atividade ou Conteúdo ilegal, obsceno, ofensivo ou fraudulento, como defender ou causar danos, interferir ou violar a integridade ou a segurança de uma rede ou um sistema, enganar os filtros, enviar vírus ou código nocivo e mensagens não solicitadas, abusivas ou enganosas ou violar direitos de terceiros. -#### 2.2.3 Privacy. +#### 2.2.3 Privacidade. A [Declaração de Privacidade do GitHub](/github/site-policy/github-privacy-statement) e o [Adendo de Proteção de Dados do GitHub](/github/site-policy/github-data-protection-addendum) fornecem aviso detalhado das práticas de privacidade e uso de dados do GitHub, bem como do processamento e das obrigações de segurança do GitHub no que diz respeito aos Dados Pessoais do Cliente. Qualquer pessoa, entidade ou serviço que colete dados do Serviço deve estar em conformidade com a [Declaração de Privacidade do GitHub](/github/site-policy/github-privacy-statement), especialmente no que diz respeito à coleta de Informações Pessoais dos Usuários (conforme definido na Declaração de Privacidade do GitHub). Se o Cliente coletar qualquer Informação pessoal do usuário no GitHub, só a utilizará para a finalidade para a qual o Usuário externo o autorizou. O Cliente protegerá essas Informações pessoais, e o Cliente responderá prontamente a reclamações, solicitações de remoção e pedidos para "não contatar" do GitHub ou de Usuários externos. -### 2.3 Content Responsibility; Ownership; License Rights. +### 2.3 Responsabilidade pelo conteúdo; Propriedade; Direitos de licença. -#### 2.3.1 Responsibility for User-Generated Content. +#### 2.3.1 Responsabilidade pelo conteúdo gerado pelo usuário. O Cliente pode criar ou fazer upload do Conteúdo gerado pelo usuário ao usar o Serviço. O Cliente é o único responsável por qualquer Conteúdo gerado pelo usuário que ele poste, faça upload, vincule ou disponibilize por meio do Serviço, independentemente da forma desse Conteúdo gerado pelo usuário. O GitHub não é responsável por qualquer exibição ao público ou uso indevido de Conteúdo gerado pelo usuário. -#### 2.3.2 Ownership of Content, Right to Post, and License Grants. +#### 2.3.2 Propriedade do conteúdo, Direito de postar; Concessões de licença. **(i)** O Cliente mantém a propriedade do Conteúdo que o Cliente cria ou possui. O Cliente reconhece que: (a) é responsável pelo Conteúdo do cliente, (b) só enviará o Conteúdo que o Cliente tem direito de postar (como Conteúdo de terceiros ou gerados pelo Usuário), e (c) o Cliente cumprirá integralmente todas as licenças de terceiros relacionadas ao Conteúdo que o Cliente posta. -**(ii)** Customer grants the rights set forth in Sections 2.3.3 through 2.3.6, free of charge and for the purposes identified in those sections until such time as Customer removes Customer Content from GitHub servers, except for Content Customer has posted publicly and that External Users have Forked, in which case the license is perpetual until such time as all Forks of Customer Content have been removed from GitHub servers. Se o Cliente fizer upload do Conteúdo do cliente que já vem com uma licença que concede ao GitHub as permissões necessárias para executar o Serviço, nenhuma licença adicional será necessária. +**(ii)** O Cliente concede os direitos estabelecidos nas Seções 2.3.3 a 2.3.6 gratuitamente e para as finalidades identificadas nessas seções até ao momento em que o Cliente remove o Conteúdo do cliente dos servidores do GitHub, exceto para Conteúdo que o Cliente tenha postado publicamente e que os Usuários externos tenham bifurcado. Nesse caso, a licença será perpétua até que todas as Bifurcações do Conteúdo do cliente tenham sido removidas dos servidores do GitHub. Se o Cliente fizer upload do Conteúdo do cliente que já vem com uma licença que concede ao GitHub as permissões necessárias para executar o Serviço, nenhuma licença adicional será necessária. -#### 2.3.3 License Grant to GitHub. +#### 2.3.3 Concessão de licença ao GitHub. O Cliente concede ao GitHub o direito de armazenar, analisar e exibir o Conteúdo do cliente e fazer cópias acessórias somente conforme necessário para fornecer o Serviço. Isso inclui o direito de copiar o Conteúdo do cliente para o banco de dados do GitHub e fazer backups; exibir o Conteúdo do cliente para ele e para quem o Cliente resolver mostrá-lo; analisar o Conteúdo do cliente em um índice de pesquisa ou analisá-lo nos servidores do GitHub; compartilhar o Conteúdo do cliente com Usuários externos com os quais o Cliente opte por compartilhá-lo; e executar o Conteúdo do cliente caso seja algo como música ou vídeo. Esses direitos se aplicam a Repositórios públicos e privados. Esta licença não concede ao GitHub o direito de vender o Conteúdo do cliente, distribuí-lo ou utilizá-lo fora do Serviço. O Cliente concede ao GitHub os direitos de que precisa para usar o Conteúdo do cliente sem atribuição e fazer adaptações razoáveis dele, conforme necessário, para fornecer o Serviço. -#### 2.3.4 License Grant to External Users. +#### 2.3.4 Concessão de licença a usuários externos. **(i)** Qualquer Conteúdo que o Cliente posta publicamente, como problemas, comentários e contribuições a repositórios de Usuários externos, pode ser visualizado por outras pessoas. Ao definir quais repositórios serão visualizados publicamente, o Cliente concorda em permitir que Usuários externos visualizem e bifurquem os repositórios do Cliente. **(ii)** Se o cliente define páginas e repositórios para serem visualizados publicamente, ele concede a Usuários externos uma licença mundial e não exclusiva para usar, exibir e executar o Conteúdo do cliente por meio do Serviço e reproduzi-lo exclusivamente no Serviço conforme permitido através da funcionalidade fornecida pelo GitHub (por exemplo, através de bifurcando). O Cliente poderá conceder direitos adicionais ao Conteúdo do Cliente se o Cliente [adotar uma licença](/github/building-a-strong-community/adding-a-license-to-a-repository#including-an-open-source-license-in-your-repository). Se o cliente estiver fazendo upload de um Conteúdo do cliente que ele não criou nem possuiu, será responsável por garantir que o Conteúdo do cliente carregado seja licenciado sob os termos que concedem essas permissões a Usuários externos. -#### 2.3.5 Contributions Under Repository License. +#### 2.3.5 Contribuições na licença de repositório. Sempre que o Cliente faz uma contribuição a um repositório que contém notificação de uma licença, o Cliente licencia essa contribuição nos mesmos termos e concorda que tem o direito de licenciá-la nesses termos. Se o Cliente tiver um contrato separado para licenciar as contribuições em termos diferentes, como um contrato de licença de colaborador, esse contrato será substituído. -#### 2.3.6 Moral Rights. +#### 2.3.6 Direitos morais. O Cliente detém todos os direitos morais ao Conteúdo do cliente que ele carrega, publica ou envia para qualquer parte do Serviço, inclusive os direitos de integridade e atribuição. No entanto, o Cliente renuncia a esses direitos e concorda em não fazê-los valer contra o GitHub somente no intuito de permitir que o GitHub exerça razoavelmente os direitos concedidos na Seção 2.3, mas não o contrário. ### 2.4 Repositórios privados. -#### 2.4.1 Control. +#### 2.4.1 Controle. O Cliente é responsável por gerenciar o acesso a seus Repositórios privados, incluindo convites, encerramento do acesso e controle administrativo de Organizações e equipes. -#### 2.4.2 Confidentiality. +#### 2.4.2 Confidencialidade. O GitHub considera o Conteúdo do cliente nos Repositórios privados do Cliente como Informações confidenciais do Cliente. O GitHub protegerá e manterá estritamente confidencial o Conteúdo do Cliente dos Repositórios Privados de acordo com a disposição de confidencialidade aplicável no Contrato com o Cliente Microsoft. -#### 2.4.3 Access. +#### 2.4.3 Acesso. O GitHub só pode acessar os Repositórios privados do Cliente (i) com o consentimento e o conhecimento do Cliente, para fins de suporte, ou (ii) quando o acesso for exigido por motivos de segurança. O Cliente pode optar por permitir o acesso adicional a seus Repositórios privados. Por exemplo, o Cliente pode habilitar vários serviços ou recursos do GitHub que exigem direitos adicionais ao Conteúdo do cliente em Repositórios privados. Esses direitos podem variar de acordo com o serviço ou recurso, mas o GitHub continuará a tratar o Conteúdo do cliente nos Repositórios privados do Cliente como Informações confidenciais do Cliente. Se esses serviços ou recursos exigirem direitos além dos necessários para oferecer o Serviço, o GitHub apresentará uma explicação sobre esses direitos. -#### 2.4.4 Exclusions. +#### 2.4.4 Exclusões. Se o GitHub tiver motivos para acreditar que o Conteúdo de um Repositório privado viola a lei ou desses Termos Complementares do GitHub, o GitHub tem o direito de acessar, revisar e remover esse Conteúdo. Além disso, o GitHub pode ser obrigado por lei a divulgar o Conteúdo de Repositórios privados do Cliente. A menos que estipulado de outra forma por requisitos dispostos na lei ou em resposta a uma ameaça à segurança ou outro risco para a segurança, o GitHub avisará sobre tais ações. ### 2.5. Avisos de propriedade intelectual. -#### 2.5.1 GitHub's Rights to Content. +#### 2.5.1 Direitos do GitHub ao conteúdo. A aparência do Serviço é Copyright © GitHub, Inc. Todos os direitos reservados. O Cliente não pode duplicar, copiar ou reutilizar qualquer parte dos elementos ou conceitos de design visual, JavaScript ou HTML/CSS sem a permissão expressa por escrito do GitHub. -#### 2.5.2 Copyright Infringement and DMCA Policy. +#### 2.5.2 Violação de direitos autorais e política DMCA. Se o Cliente for proprietário de direitos autorais e acreditar que o Conteúdo no Serviço viola seus direitos autorais, ele poderá notificar o GitHub de acordo com a [Lei dos Direitos Autorais do Milênio Digital](https://github.com/contact/dmca) (DMCA – Digital Millenium Copyright Act Policy) usando o [Formulário DMCA](https://github.com/contact/dmca-notice) ou pelo e-mail copyright@github.com. -#### 2.5.3 GitHub Trademarks and Logos. +#### 2.5.3 Logotipos e marcas registradas do GitHub. Se o Cliente quiser usar as marcas registradas do GitHub, deverá seguir todas as diretrizes de marca registrada do GitHub, inclusive aquelas na [página Uso e logotipos do GitHub](https://github.com/logos). -### 2.6 Suspension. +### 2.6 Suspensão. O GitHub tem o direito de suspender o acesso a toda ou qualquer parte do Serviço, incluindo a remoção do Conteúdo a qualquer momento por violação do Contrato com o Cliente Microsoft, incluindo esses Termos Complementares do GitHub, ou para proteger a integridade, operacionalidade e segurança do Serviço, em vigor imediatamente, com ou sem aviso prévio. A menos que seja proibido por lei ou por processo legal ou para evitar danos iminentes ao Serviço ou a terceiros, o GitHub geralmente emite um aviso na forma de banner ou por e-mail no momento ou antes de tal suspensão. A seu critério e com boa fé, o GitHub ajustará qualquer suspensão conforme necessário para preservar a integridade, a operacionalidade e a segurança do Serviço. @@ -189,11 +189,11 @@ O GitHub tem o direito de suspender o acesso a toda ou qualquer parte do Serviç Para fins contratuais, o Cliente (1) consente em receber comunicados em forma eletrônica através do endereço de e-mail que enviou ou através do Serviço; e (2) concorda que todos os Termos de Serviço, contratos, avisos, divulgações, e outras comunicações que o GitHub efetua eletronicamente atendem a qualquer requisito legal que essas mesmas comunicações atenderiam se escritas em papel. Esta seção não afeta os direitos inalienáveis do Cliente. -### 2.8 Service Level Agreement. +### 2.8 Contrato de Nível de Serviço. -GitHub’s quarterly uptime commitment for the Service is provided in the [Enterprise Service Level Agreement](/github/site-policy/github-enterprise-service-level-agreement). Customer will be entitled to a service credit if GitHub does not meet its service level. +O compromisso trimestral do GitHub com o Serviço é fornecido no [Contrato de Nível de Serviço Empresarial](/github/site-policy/github-enterprise-service-level-agreement). O cliente terá direito a um crédito de serviço se o GitHub não atender ao seu nível de serviço. -### 2.9 Service Changes. +### 2.9 Alterações no serviço. O GitHub altera o Serviço através de Atualizações e adição de novos recursos. Sujeito à Seção 2.8, o GitHub se reserva o direito de, a qualquer momento, modificar ou interromper, temporária ou permanentemente, o Serviço (ou qualquer parte dele), com ou sem aviso prévio. @@ -203,17 +203,17 @@ Alguns recursos do Serviço podem estar sujeitos a termos adicionais definidos n ## SEÇÃO 3: DISPOSIÇÕES GERAIS. -This Section 3 sets forth the terms and conditions applicable to Customer’s purchase and use of any of the Products. +Esta Seção 3 estabelece os termos e as condições aplicáveis à compra e à utilização de qualquer um dos Produtos pelo Cliente. ### 3.1 Termo; Rescisão; Efeito da Rescisão. -#### 3.1.1 Term. +#### 3.1.1 Vigência. Esses Termos Complementares do GitHub continuarão vigentes até serem rescindidos por uma das Partes, de acordo com esta Seção 3.1. #### 3.1.2 Rescisão por Conveniência; Cancelamento de Conta. Qualquer uma das Partes pode rescindir um Formulário de Pedido ou estes Termos Complementares do GitHub, sem motivo, com pelo menos 30 (trinta) dias de aviso prévio por escrito antes do término do Período de Assinatura atual. Se o Cliente optar por rescindir um Formulário de pedido ou os Termos Complementares do GitHub, é responsabilidade do Cliente cancelar corretamente a respectiva conta com o GitHub acessando Configurações na barra de navegação global, na parte superior da tela. O GitHub não cancela contas em resposta a solicitações por telefone ou e-mail. -#### 3.1.3 Termination for Material Breach. +#### 3.1.3 Rescisão por quebra de contrato. Qualquer das Partes poderá rescindir estes Termos Complementares do GitHub imediatamente, mediante notificação, se a outra Parte descumprir uma obrigação material sob esses Termos Complementares do GitHub e não conseguir corrigir a violação no prazo de trinta (30) dias a partir da data em que receber a notificação. O GitHub pode rescindir estes Termos Complementares do GitHub se a Conta do Cliente for suspensa por mais de 90 dias. #### 3.1.4 Efeito da rescisão. diff --git a/translations/pt-BR/content/github/site-policy/github-terms-of-service.md b/translations/pt-BR/content/github/site-policy/github-terms-of-service.md index 3cef1b8f39b7..8c1f4a791f73 100644 --- a/translations/pt-BR/content/github/site-policy/github-terms-of-service.md +++ b/translations/pt-BR/content/github/site-policy/github-terms-of-service.md @@ -54,7 +54,7 @@ Data de vigência: 2 de abril de 2020 ### B. Termos da conta **Versão curta:** *Contas e Organizações do Usuário têm controles administrativos diferentes; uma pessoa precisa criar sua Conta; você deve ter 13 anos ou mais; deve fornecer um endereço de e-mail válido e não pode ter mais de uma Conta gratuita. Você é o único responsável por sua Conta e tudo o que acontece enquanto você estiver logado ou usando sua Conta. Você é responsável por manter sua Conta segura.* -#### 1. Account Controls +#### 1. Controles da conta - Usuários. Sujeito a estes Termos, você mantém o controle administrativo final sobre sua Conta de Usuário e o Conteúdo dentro dela. - Organizações. O "proprietário" de uma Organização que foi criada sob estes Termos tem o controle administrativo supremo sobre essa Organização e sobre o Conteúdo dentro dela. No Serviço, um proprietário pode gerenciar acesso de Usuário aos dados e projetos da Organização. Uma Organização pode ter vários proprietários, mas deve haver pelo menos uma Conta de Usuário designada como proprietário de uma Organização. Se você é o proprietário de uma Organização sob estes Termos, nós consideramos que você é responsável pelas ações que são executadas naquela Organização ou através dela. @@ -69,7 +69,7 @@ Temos algumas regras simples para Contas de Usuário no Serviço do GitHub. - Uma pessoa ou entidade legal não pode manter mais de uma Conta gratuita (se você optar por controlar uma conta de máquina também, sem problemas, mas só pode ser usada para executar uma máquina). - Você deve ter 13 anos ou mais. Embora nos sintamos felizes ao vermos os brilhantes codificadores se entusiasmarem ao aprender a programar, temos de cumprir a legislação dos Estados Unidos. O GitHub não direciona nosso Serviço para crianças com menos de 13 anos, e nós não permitimos quaisquer Usuários com menos de 13 anos no nosso Serviço. Se soubermos de qualquer Usuário menor de 13 anos, vamos [encerrar a Conta de Usuário imediatamente](#l-cancellation-and-termination). Se você for residente de um país fora dos Estados Unidos, a idade mínima do seu país pode ser maior; num caso destes, você é responsável por cumprir as leis do seu país. - Seu login pode ser usado apenas por uma pessoa — ou seja, um único login não pode ser compartilhado por várias pessoas. Uma organização paga só pode fornecer acesso ao número de Contas de Usuário que sua assinatura permite. -- Você não pode usar o GitHub em violação do controle de exportação ou das leis de sanções dos Estados Unidos ou de qualquer outra jurisdição aplicável. Você não pode usar o GitHub se você é ou está trabalhando em nome de um [Nacional Especialmente Designado (SDN)](https://www.treasury.gov/resource-center/sanctions/SDN-List/Pages/default.aspx) ou uma pessoa sujeita a bloqueios semelhantes ou proibições de parte negada administradas por uma agência do governo dos EUA. government agency. O GitHub pode permitir que pessoas em certos países ou territórios sancionados acessem certos serviços do GitHub de acordo com as autorizações do governo dos Estados Unidos. government authorizations. Para obter mais informações, por favor veja nossa [política de Controles de Exportação](/articles/github-and-export-controls). +- Você não pode usar o GitHub em violação do controle de exportação ou das leis de sanções dos Estados Unidos ou de qualquer outra jurisdição aplicável. Você não pode usar o GitHub se você é ou está trabalhando em nome de um [Nacional Especialmente Designado (SDN)](https://www.treasury.gov/resource-center/sanctions/SDN-List/Pages/default.aspx) ou uma pessoa sujeita a bloqueios semelhantes ou proibições de parte negada administradas por uma agência do governo dos EUA. agência do governo. O GitHub pode permitir que pessoas em certos países ou territórios sancionados acessem certos serviços do GitHub de acordo com as autorizações do governo dos Estados Unidos. autorizações do governo. Para obter mais informações, por favor veja nossa [política de Controles de Exportação](/articles/github-and-export-controls). #### 4. Segurança da Conta de Usuário Você é responsável por manter sua Conta segura enquanto usa nosso Serviço. Nós oferecemos ferramentas como a autenticação de dois fatores para ajudá-lo a manter a segurança de sua Conta, mas o conteúdo de sua Conta e sua segurança são de sua responsabilidade. @@ -77,7 +77,7 @@ Você é responsável por manter sua Conta segura enquanto usa nosso Serviço. N - Você é responsável por manter a segurança de sua Conta e senha. O GitHub não pode e não será responsabilizado por qualquer perda ou dano causado por sua falha em cumprir com esta obrigação de segurança. - Você irá rapidamente [notificar o GitHub](https://support.github.com/contact) se estiver ciente de qualquer uso não autorizado de, ou acesso a, nosso Serviço através de sua Conta, incluindo qualquer uso não autorizado de sua senha ou Conta. -#### 5. Additional Terms +#### 5. Termos adicionais Em algumas situações, os termos de terceiros podem ser aplicados ao seu uso do GitHub. Por exemplo, você pode ser integrante de uma organização no GitHub com seus próprios termos ou contratos de licença. Você poderá baixar um aplicativo que se integra ao GitHub; ou utilizar o GitHub para autenticar em outro serviço. Por favor, esteja ciente de que, embora esses Termos representem nosso acordo total com você, os termos de terceiros governam suas relações com você. Se você é um Usuário do governo ou, de outro modo, acessar ou usar qualquer Serviço GitHub em uma competência do governo, esta [Emenda do Governo aos Termos de Serviço do GitHub](/articles/amendment-to-github-terms-of-service-applicable-to-u-s-federal-government-users/) se aplica a você, e você concorda com as suas disposições. @@ -100,7 +100,7 @@ Você pode criar ou fazer upload do conteúdo gerado pelo usuário usando o Serv #### 2. O GitHub pode remover conteúdo Não pré-avaliamos o Conteúdo Gerado pelo Usuário, mas temos o direito (embora não tenhamos a obrigação) de recusar ou remover qualquer Conteúdo Gerado pelo Usuário que, em nosso exclusivo critério, viole quaisquer [termos ou políticas no GitHub](/github/site-policy). -#### 3. Ownership of Content, Right to Post, and License Grants +#### 3. Propriedade do conteúdo, Direito de postar; Concessões de licença Você mantém a propriedade e a responsabilidade pelo seu conteúdo. Se você está postando qualquer coisa que você não criou ou não possui os direitos, você concorda que é responsável por qualquer conteúdo que você publique; que você só enviará Conteúdo que você tem o direito de publicar; e que você esteja em total conformidade com licenças de terceiros relacionadas ao Conteúdo que você publicar. Porque você retem a propriedade e a responsabilidade do seu conteúdo, precisamos que você nos conceda — e outros usuários do GitHub — certas permissões legais, listadas nas Seções D.4 — D.7. Estas concessões de licença se aplicam ao Seu Conteúdo. Se você fizer upload de Conteúdo que já vem com uma licença que concede ao GitHub as permissões que precisamos para executar nosso Serviço, nenhuma licença adicional é necessária. Você compreende que não receberá nenhum pagamento por qualquer um dos direitos concedidos nas Seções D.4 — D.7. As licenças que você nos concede terminarão quando você remover Seu Conteúdo de nossos servidores, a menos que outros Usuários o tenham bifurcado. @@ -120,7 +120,7 @@ Sempre que você fizer uma contribuição a um repositório que contém notifica Não é assim que as coisas já funcionam? Sim. Isso é amplamente aceito como a norma na comunidade de código aberto; é comumente referido pela abreviatura "entrada=saída". Estamos apenas tornando isso explícito. -#### 7. Moral Rights +#### 7. Direitos Morais Você mantém todos os direitos morais do Seu Conteúdo que você faz upload, publica ou envia em qualquer parte do Serviço, incluindo os direitos de integridade e atribuição. No entanto, você renuncia a esses direitos e concorda em não fazê-los valer contra nós, no intuito de permitir que exerçamos razoavelmente os direitos concedidos na Seção D.4, mas não de outra maneira. Na medida em que este contrato não é aplicável pela legislação aplicável, você concede ao GitHub os direitos que precisamos para usar Seu Conteúdo sem atribuição e fazer adaptações razoáveis do Seu Conteúdo conforme necessário para renderizar o Site e fornecer o Serviço. @@ -142,10 +142,10 @@ Os funcionários do GitHub somente podem acessar o conteúdo de seus repositóri Você pode optar por habilitar acesso adicional a seus repositórios privados. Por exemplo: - Você pode habilitar vários serviços do GitHub ou recursos que requerem direitos adicionais ao Seu Conteúdo em repositórios privados. Estes direitos podem variar, dependendo do serviço ou recurso, mas o GitHub continuará a tratar seu Conteúdo do repositório privado como confidencial. Se esses serviços ou recursos exigem direitos além daqueles que precisamos fornecer no Serviço GitHub, forneceremos uma explicação desses direitos. -#### 4. Exclusions +#### 4. Exclusões Se tivermos razões para acreditar que os conteúdos de um repositório privado estão violando a lei ou estes Termos, temos o direito de acessar, revisar e removê-los. Além disso, podemos ser [obrigados, por lei,](/github/site-policy/github-privacy-statement#for-legal-disclosure) a divulgar o conteúdo de seus repositórios privados. -### F. Copyright Infringement and DMCA Policy +### F. Violação de direitos autorais e política DMCA Se você acredita que o conteúdo em nosso site viola seus direitos autorais, por favor, entre em contato conosco de acordo com nossa [Política Digital Millennium Copyright Act](/articles/dmca-takedown-policy/). Se você é um proprietário de direitos autorais e acredita que o conteúdo no GitHub viola seus direitos, por favor, entre em contato conosco via [formulário DMCA](https://github.com/contact/dmca) ou envie e-mail para copyright@github.com. Poderá haver consequências jurídicas para o envio de um aviso de remoção falso ou leviano. Antes de enviar uma solicitação de remoção, você deve considerar usos legais, tais como uso justo e usos licenciados. Nós encerraremos as Contas de [infratores reiterados](/articles/dmca-takedown-policy/#e-repeated-infringement) desta política. @@ -153,10 +153,10 @@ Nós encerraremos as Contas de [infratores reiterados](/articles/dmca-takedown-p ### G. Avisos de Propriedade Intelectual **Versão curta:** *Nós somos proprietários do serviço e de todo o nosso conteúdo. Para que você use nosso conteúdo, nós lhe damos certos direitos relativos a ele, mas você só pode usar nosso conteúdo da forma que permitimos.* -#### 1. GitHub's Rights to Content +#### 1. Direitos do GitHub ao conteúdo GitHub e nossos licenciadores, fornecedores, agentes, e/ou nossos provedores de conteúdo detêm a propriedade de todos os direitos de propriedade intelectual de qualquer tipo relacionados ao Site e Serviço. Reservamo-nos todos os direitos que não lhe são expressamente concedidos neste Contrato ou por lei. O visual e a impressão do Site e do Serviço estão protegidos sob direitos autorais de © GitHub, Inc. Todos os direitos reservados. Você não pode duplicar, copiar ou reutilizar qualquer parte do HTML/CSS, Javascript ou conceitos e elementos de design visual sem permissão escrita expressa do GitHub. -#### 2. GitHub Trademarks and Logos +#### 2. Logotipos e marcas registradas do GitHub Se você gostaria de usar as marcas registradas do GitHub, você deve seguir todas as nossas diretrizes sobre a marca registrada, incluindo as da nossa página de logomarcas: https://github.com/logos. #### 3. Licença para as Políticas GitHub diff --git a/translations/pt-BR/content/github/site-policy/githubs-notice-about-the-california-consumer-privacy-act.md b/translations/pt-BR/content/github/site-policy/githubs-notice-about-the-california-consumer-privacy-act.md index 6dbe6bb41dc5..2710f560c709 100644 --- a/translations/pt-BR/content/github/site-policy/githubs-notice-about-the-california-consumer-privacy-act.md +++ b/translations/pt-BR/content/github/site-policy/githubs-notice-about-the-california-consumer-privacy-act.md @@ -62,7 +62,7 @@ Embora a tabela abaixo contenha informações sobre as categorias de informaçõ | Quaisquer categorias de informações pessoais descritas na subdivisão (e) do Cal. Civ. Code §1798.80 (que define “informações pessoais” como “qualquer informação que identifique, relacione-se, descreva ou possa ser associada com um indivíduo em particular" — com exemplos incluindo nome, endereço, cartão de crédito ou número do cartão de débito — e exclui informações disponíveis publicamente) | Informações que o consumidor fornece diretamente | Processar os responsáveis por atividades maliciosas, enganosas, fraudulentas ou ilegais.

    Execução de serviços em nome do provedor de negócios ou serviços | Prestadores de serviços, agentes da lei | Esta categoria de informações pessoais foi divulgada para fins comerciais ou de negócios | | Características das classificações protegidas sob a lei da Califórnia ou lei federal (como gênero, idade) | Informações que o consumidor pode optar por fornecer diretamente | Serviços de desempenho (perfil de usuário) | Provedores de serviço | Esta categoria de informações pessoais foi divulgada para fins comerciais ou de negócios | | Informações comerciais (tais como informações sobre produtos ou serviços comprados, obtidos ou tomados, ou outros históricos ou tendências de compra ou consumo) | Informação que o consumidor fornece direta ou automaticamente através da interação com os nossos Serviços | Depuração para identificar e reparar erros que prejudicam a funcionalidade pretendida existente

    Execução de serviços em nome do provedor de negócios ou serviços | Provedores de serviço | Esta categoria de informações pessoais foi divulgada para fins comerciais ou de negócios | | Informações sobre a internet ou outras informações de atividades de rede eletrônica (como histórico de navegação, histórico de pesquisa e informações sobre a interação de um consumidor com um site ou aplicativo na internet) | Informações que o consumidor fornece automaticamente através de sua interação com nossos Serviços | Detectar incidentes de segurança, proteger contra atividades maliciosas, enganosas, fraudulentas ou ilegais, e processar os responsáveis por essa atividade

    Depuração para identificar e reparar erros que prejudicam a funcionalidade pretendida existente

    Execução de serviços em nome do provedor de negócios ou serviços

    Realização de pesquisas internas para desenvolvimento e demonstração tecnológica

    Realizar atividades para verificar ou manter a qualidade ou segurança de um serviço, e melhorar, atualizar ou aprimorar o serviço | Prestadores de serviços, clientes aplicáveis, agentes da lei | Esta categoria de informações pessoais foi divulgada para fins comerciais ou de negócios | - Dados de geolocalização (como endereço IP) | Informações que o consumidor fornece automaticamente através de sua interação com nossos Serviços | Detectar incidentes de segurança, proteger contra atividades maliciosas, enganosas, fraudulentas ou ilegais, e processar os responsáveis por essa atividade

    Depuração para identificar e reparar erros que prejudicam a funcionalidade pretendida existente

    Execução de serviços em nome do provedor de negócios ou serviços

    Empreender pesquisa interna para desenvolvimento tecnológico e demonstração

    Realizar atividades para verificar ou manter a qualidade ou segurança de um serviço, e melhorar, atualizar ou aprimorar o serviço | Prestadores de serviços, clientes aplicáveis, agentes da lei | Esta categoria de informações pessoais foi divulgada para fins comerciais ou de negócios | Informações de áudio, eletrônica, visual ou similares | Informações que o consumidor pode optar por fornecer diretamente | Execução de serviços (perfil do usuário) | Prestadores de serviços | Esta categoria de informações pessoais foi divulgada para fins comerciais ou de negócios | Informações profissionais ou relacionadas ao emprego | Informações que o consumidor pode optar por fornecer diretamente | Execução de serviços (perfil do usuário) | Prestadores de serviços | Esta categoria de informações pessoais foi divulgada para fins comerciais ou de negócios| Informações de educação que não estão disponíveis publicamente pessoalmente identificáveis | Esta categoria de informações pessoais foi divulgada para fins comerciais ou de negócios | Informações definidas na Lei de Direitos Educacionais e Privacidade da Família (20 U.S.C. Sec. Sec. 1232g; 34 C.F.R. Part 99) | Information consumer may choose to provide directly | Performing services (user profile) | Service providers | This category of personal information has been disclosed for a business or commercial purpose | Inferences drawn from any of the information identified in this table to create a profile about a consumer reflecting the consumer’s preferences | Information consumer provides directly or automatically through their interaction with our Services | Performing services on behalf of the business or service provider | Service providers | This category of personal information has been disclosed for a business or commercial purpose | + Dados de geolocalização (como endereço IP) | Informações que o consumidor fornece automaticamente através de sua interação com nossos Serviços | Detectar incidentes de segurança, proteger contra atividades maliciosas, enganosas, fraudulentas ou ilegais, e processar os responsáveis por essa atividade

    Depuração para identificar e reparar erros que prejudicam a funcionalidade pretendida existente

    Execução de serviços em nome do provedor de negócios ou serviços

    Empreender pesquisa interna para desenvolvimento tecnológico e demonstração

    Realizar atividades para verificar ou manter a qualidade ou segurança de um serviço, e melhorar, atualizar ou aprimorar o serviço | Prestadores de serviços, clientes aplicáveis, agentes da lei | Esta categoria de informações pessoais foi divulgada para fins comerciais ou de negócios | Informações de áudio, eletrônica, visual ou similares | Informações que o consumidor pode optar por fornecer diretamente | Execução de serviços (perfil do usuário) | Prestadores de serviços | Esta categoria de informações pessoais foi divulgada para fins comerciais ou de negócios | Informações profissionais ou relacionadas ao emprego | Informações que o consumidor pode optar por fornecer diretamente | Execução de serviços (perfil do usuário) | Prestadores de serviços | Esta categoria de informações pessoais foi divulgada para fins comerciais ou de negócios| Informações de educação que não estão disponíveis publicamente pessoalmente identificáveis | Esta categoria de informações pessoais foi divulgada para fins comerciais ou de negócios | Informações definidas na Lei de Direitos Educacionais e Privacidade da Família (20 U.S.C. Sec. Sec. 1232g; 34 C.F.R. Parte 99) | Informações que o consumidor pode optar por fornecer diretamente | Prestação de serviços (perfil do usuário) | Prestadores de serviços | Esta categoria de informações pessoais foi divulgada para fins comerciais ou de negócios | Inferências extraídas de qualquer uma das informações identificadas nesta tabela para criar um perfil sobre um consumidor refletindo as preferências do consumidor | Informações que o consumidor fornece direta ou automaticamente através de sua interação com nossos Serviços | Execução de serviços em nome do prestador de serviços ou empresas | Prestadores de serviços | Esta categoria de informações pessoais foi divulgada para fins comerciais ou de negócios | ## Isenções no âmbito da CCPA diff --git a/translations/pt-BR/content/github/site-policy/guide-to-submitting-a-dmca-counter-notice.md b/translations/pt-BR/content/github/site-policy/guide-to-submitting-a-dmca-counter-notice.md index 56207b33d9c0..4237ce7c6ac6 100644 --- a/translations/pt-BR/content/github/site-policy/guide-to-submitting-a-dmca-counter-notice.md +++ b/translations/pt-BR/content/github/site-policy/guide-to-submitting-a-dmca-counter-notice.md @@ -10,17 +10,17 @@ versions: Este guia descreve as informações de que o GitHub precisa para processar um contra-aviso em uma solicitação de retirada DMCA. Se você tiver dúvidas mais gerais sobre o que é a DMCA ou como o GitHub processa solicitações de retirada DMCA, por favor, reveja nossa [Política de Aviso de Retirada DMCA](/articles/dmca-takedown-policy). -Se você acredita que seu conteúdo no GitHub foi erroneamente desabilitado por uma solicitação de retirada DMCA, você tem o direito de contestá-la, enviando um contra-aviso. Se o fizer, esperaremos entre 10 a 14 dias, e então reativaremos seu conteúdo, a menos que o proprietário dos direitos autorais inicie uma ação judicial contra você antes disso. Nossa forma de contra-aviso descrita abaixo é consistente com o formulário sugerido pelo estatuto DMCA, que pode ser encontrado no site oficial do Escritório de Direitos Autorais dos Estados Unidos: . Copyright Office's official website: . +Se você acredita que seu conteúdo no GitHub foi erroneamente desabilitado por uma solicitação de retirada DMCA, você tem o direito de contestá-la, enviando um contra-aviso. Se o fizer, esperaremos entre 10 a 14 dias, e então reativaremos seu conteúdo, a menos que o proprietário dos direitos autorais inicie uma ação judicial contra você antes disso. Nossa forma de contra-aviso descrita abaixo é consistente com o formulário sugerido pelo estatuto DMCA, que pode ser encontrado no site oficial do Escritório de Direitos Autorais dos Estados Unidos: . Site oficial do escritório de direitos autorais: . Como em todas as questões jurídicas, é sempre melhor consultar um profissional sobre suas dúvidas ou situação específica. Incentivamos a fazê-lo antes de tomar quaisquer medidas que possam impactar seus direitos. Este guia não é um aconselhamento jurídico e não deve ser tomado como tal. ### Antes de começar -***Diga a verdade.*** A DMCA requer que você jure pelos fatos relatados no seu contra-aviso, *sob pena de perjúrio*. Nos Estados Unidos, é crime federal mentir intencionalmente numa declaração juramentada. (*Veja* [Código dos EUA, Título 18, Seção 1621](https://www.gpo.gov/fdsys/pkg/USCODE-2011-title18/html/USCODE-2011-title18-partI-chap79-sec1621.htm). Code, Title 18, Section 1621.) (*Veja* [Código dos EUA, Título 18, Seção 1621](https://www.gpo.gov/fdsys/pkg/USCODE-2011-title18/html/USCODE-2011-title18-partI-chap79-sec1621.htm).) O envio de informações falsas também pode resultar em responsabilidade civil — ou seja, você poderia ser processado por danos financeiros. +***Diga a verdade.*** A DMCA requer que você jure pelos fatos relatados no seu contra-aviso, *sob pena de perjúrio*. Nos Estados Unidos, é crime federal mentir intencionalmente numa declaração juramentada. (*Veja* [Código dos EUA, Título 18, Seção 1621](https://www.gpo.gov/fdsys/pkg/USCODE-2011-title18/html/USCODE-2011-title18-partI-chap79-sec1621.htm). Código, Título 18, Seção 1621.) (*Veja* [Código dos EUA, Título 18, Seção 1621](https://www.gpo.gov/fdsys/pkg/USCODE-2011-title18/html/USCODE-2011-title18-partI-chap79-sec1621.htm).) O envio de informações falsas também pode resultar em responsabilidade civil — ou seja, você poderia ser processado por danos financeiros. ***Investigação.*** Enviar um contra-aviso DMCA pode ter consequências legais reais. Se a parte reclamante discordar que o aviso de retirada dela foi um erro, ela pode decidir instaurar uma queixa contra você para manter o conteúdo desativado. Você deve conduzir uma investigação exaustiva sobre as alegações feitas no aviso de retirada e, provavelmente, falar com um advogado antes de enviar um contra-aviso. -***Você precisa ter uma boa razão para enviar um contra-aviso.*** Para registrar um contra-aviso, você deve ter "o entendimento, de boa-fé, de que o material foi removido ou desabilitado como resultado de erro ou identificação incorreta do material a ser removido ou desabilitado". ([U.S. Code, Title 17, Section 512(g)](https://www.copyright.gov/title17/92chap5.html#512).) ([Código EUA, Título 17, Seção 512(g)](http://www.copyright.gov/title17/92chap5.html#512)) A decisão de explicar por que você acredita que houve um erro depende de você e de seu advogado, mas você *realmente* precisa identificar um erro antes de enviar um contra-aviso. No passado, recebemos contra-avisos que citavam erros no aviso de retirada, tais como: a parte reclamante não possui os direitos de autor; eu tenho uma licença; o código foi publicado sob uma licença de código aberto que permite meu uso; ou a reclamação não conta o fato de que meu uso está protegido pela doutrina de uso justo. É claro que poderiam existir outros defeitos em relação ao aviso de retirada. +***Você precisa ter uma boa razão para enviar um contra-aviso.*** Para registrar um contra-aviso, você deve ter "o entendimento, de boa-fé, de que o material foi removido ou desabilitado como resultado de erro ou identificação incorreta do material a ser removido ou desabilitado". ([U.S. Código, Título 17, Seção 512(g)](https://www.copyright.gov/title17/92chap5.html#512).) ([Código EUA, Título 17, Seção 512(g)](http://www.copyright.gov/title17/92chap5.html#512)) A decisão de explicar por que você acredita que houve um erro depende de você e de seu advogado, mas você *realmente* precisa identificar um erro antes de enviar um contra-aviso. No passado, recebemos contra-avisos que citavam erros no aviso de retirada, tais como: a parte reclamante não possui os direitos de autor; eu tenho uma licença; o código foi publicado sob uma licença de código aberto que permite meu uso; ou a reclamação não conta o fato de que meu uso está protegido pela doutrina de uso justo. É claro que poderiam existir outros defeitos em relação ao aviso de retirada. ***As leis de direitos autorais são complicadas.*** Às vezes, um aviso de retirada pode alegar violação de uma forma que parece atípica ou indireta. As leis de direitos autorais são complicadas e podem dar origem a alguns resultados inesperados. Em alguns casos, um aviso de retirada pode alegar que o seu código-fonte infringe os direitos por causa do que ele pode fazer após ser compilado e executado. Por exemplo: - O aviso pode afirmar que seu software é usado para [contornar controles de acesso](https://www.copyright.gov/title17/92chap12.html) de trabalhos protegidos por direitos autorais. diff --git a/translations/pt-BR/content/github/site-policy/guide-to-submitting-a-dmca-takedown-notice.md b/translations/pt-BR/content/github/site-policy/guide-to-submitting-a-dmca-takedown-notice.md index 0a12a5a1b2ff..993a01b77df9 100644 --- a/translations/pt-BR/content/github/site-policy/guide-to-submitting-a-dmca-takedown-notice.md +++ b/translations/pt-BR/content/github/site-policy/guide-to-submitting-a-dmca-takedown-notice.md @@ -10,13 +10,13 @@ versions: Este guia descreve as informações de que o GitHub precisa para processar uma solicitação de retirada DMCA. Se você tiver dúvidas mais gerais sobre o que é a DMCA ou como o GitHub processa solicitações de retirada DMCA, por favor, reveja nossa [Política de Aviso de Retirada DMCA](/articles/dmca-takedown-policy). -Devido ao tipo de conteúdo que o GitHub hospeda (principalmente código de software) e a forma como o conteúdo é gerenciado (com o Git), precisamos que as queixas sejam as mais específicas possíveis. Essas diretrizes destinam-se a tornar o processamento dos alegados avisos de infração o mais simples possível. A nossa forma de aviso descrita abaixo é consistente com o formulário sugerido pelo estatuto DMCA, que pode ser encontrado no site oficial do Escritório de Direitos Autorais dos Estados Unidos: . Copyright Office's official website: . +Devido ao tipo de conteúdo que o GitHub hospeda (principalmente código de software) e a forma como o conteúdo é gerenciado (com o Git), precisamos que as queixas sejam as mais específicas possíveis. Essas diretrizes destinam-se a tornar o processamento dos alegados avisos de infração o mais simples possível. A nossa forma de aviso descrita abaixo é consistente com o formulário sugerido pelo estatuto DMCA, que pode ser encontrado no site oficial do Escritório de Direitos Autorais dos Estados Unidos: . Site oficial do escritório de direitos autorais: . Como em todas as questões jurídicas, é sempre melhor consultar um profissional sobre suas dúvidas ou situação específica. Incentivamos a fazê-lo antes de tomar quaisquer medidas que possam impactar seus direitos. Este guia não é um aconselhamento jurídico e não deve ser tomado como tal. ### Antes de começar -***Diga a verdade.*** A DMCA requer que você jure pelos fatos relatados na reclamação dos direitos autorais, *sob pena de perjúrio*. Nos Estados Unidos, é crime federal mentir intencionalmente numa declaração juramentada. (*Veja* [Código dos EUA, Título 18, Seção 1621](https://www.gpo.gov/fdsys/pkg/USCODE-2011-title18/html/USCODE-2011-title18-partI-chap79-sec1621.htm). Code, Title 18, Section 1621.) O envio de informações falsas também poderia resultar em responsabilidade civil — ou seja, você poderia ser processado por danos financeiros. A própria DMCA [prevê danos](https://en.wikipedia.org/wiki/Online_Copyright_Infringement_Liability_Limitation_Act#%C2%A7_512(f)_Misrepresentations) contra qualquer pessoa que, intencionalmente, deturpe materialmente o material ou a atividade que está sendo alvo de denúncia de violação de direitos autorais. +***Diga a verdade.*** A DMCA requer que você jure pelos fatos relatados na reclamação dos direitos autorais, *sob pena de perjúrio*. Nos Estados Unidos, é crime federal mentir intencionalmente numa declaração juramentada. (*Veja* [Código dos EUA, Título 18, Seção 1621](https://www.gpo.gov/fdsys/pkg/USCODE-2011-title18/html/USCODE-2011-title18-partI-chap79-sec1621.htm). Código, Título 18, Seção 1621.) O envio de informações falsas também poderia resultar em responsabilidade civil — ou seja, você poderia ser processado por danos financeiros. A própria DMCA [prevê danos](https://en.wikipedia.org/wiki/Online_Copyright_Infringement_Liability_Limitation_Act#%C2%A7_512(f)_Misrepresentations) contra qualquer pessoa que, intencionalmente, deturpe materialmente o material ou a atividade que está sendo alvo de denúncia de violação de direitos autorais. ***Investigue.*** Milhões de usuários e organizações dedicam seus corações e mentes aos projetos para os quais eles contribuem e criam no GitHub. Apresentar uma queixa DMCA contra um projeto deste tipo é uma acusação jurídica grave que acarreta consequências reais para pessoas reais. Por causa disso, solicitamos que procedam a uma investigação minuciosa e consultem um advogado antes de apresentar um requerimento para se certificar de que tal uso não seja realmente permitido. diff --git a/translations/pt-BR/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md b/translations/pt-BR/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md index abbe77db5535..cbd0b88af275 100644 --- a/translations/pt-BR/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md +++ b/translations/pt-BR/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md @@ -125,7 +125,7 @@ No caso das contas da organização, podemos fornecer o(s) nome(s) e endereço(s Por favor, note que a informação disponível varia de caso a caso. Algumas das informações são opcionais para os usuários fornecerem. Noutros casos, podemos não ter recolhido ou mantido a informação. - -**Com uma ordem judicial *ou* um mandado de busca** — Não divulgaremos os logs de acesso à conta, a menos que sejamos obrigados a fazê-lo por (i) uma ordem judicial emitida conforme 18 U.S.C. Seção 2703(d), sobre a demonstração de fatos específicos e articuláveis que mostrem que há razões razoáveis para acreditar que a informação solicitada é relevante e material para uma investigação criminal em curso; ou (ii) um mandado de busca emitido nos termos dos procedimentos descritos nas Regras Federais de Processo Penal ou procedimentos de autorização estatal equivalentes, mediante demonstração de uma causa provável. Section 2703(d), upon a showing of specific and articulable facts showing that there are reasonable grounds to believe that the information sought is relevant and material to an ongoing criminal investigation; or (ii) a search warrant issued under the procedures described in the Federal Rules of Criminal Procedure or equivalent state warrant procedures, upon a showing of probable cause. Além das informações da conta de usuário não públicas listadas acima podemos fornecer logs de acesso à conta em resposta a uma ordem judicial ou mandado de busca, que podem incluir: +**Com uma ordem judicial *ou* um mandado de busca** — Não divulgaremos os logs de acesso à conta, a menos que sejamos obrigados a fazê-lo por (i) uma ordem judicial emitida conforme 18 U.S.C. Seção 2703(d), sobre a demonstração de fatos específicos e articuláveis que mostrem que há razões razoáveis para acreditar que a informação solicitada é relevante e material para uma investigação criminal em curso; ou (ii) um mandado de busca emitido nos termos dos procedimentos descritos nas Regras Federais de Processo Penal ou procedimentos de autorização estatal equivalentes, mediante demonstração de uma causa provável. Seção 2703(d), após a demonstração de fatos específicos e articuláveis que mostrem que há razões razoáveis para acreditar que a informação solicitada é relevante e material para uma investigação criminal em curso; ou (ii) um mandado de busca emitido de acordo com os procedimentos descritos no Regimento Federal de Assuntos Penal ou procedimentos de mandado de Estado equivalente, após a demonstração de uma causa provável. Além das informações da conta de usuário não públicas listadas acima podemos fornecer logs de acesso à conta em resposta a uma ordem judicial ou mandado de busca, que podem incluir: - Quaisquer logs que revelaria os movimentos de um usuário ao longo de um período de tempo - Configurações de conta ou repositório privado (por exemplo, quais usuários têm certas permissões, etc.) @@ -149,7 +149,7 @@ Reservamo-nos o direito de solicitar o reembolso dos custos administrativos asso ### Conservação de dados -We will take steps to preserve account records for up to 90 days upon formal request from U.S. law enforcement in connection with official criminal investigations, and pending the issuance of a court order or other process. +Vamos tomar medidas para preservar os registros das conta por até 90 dias mediante solicitação formal dos EUA. aplicação da lei relacionada a investigações criminais oficiais e aguardando a emissão de uma decisão judicial ou outro processo. ### Envio de solicitação @@ -176,7 +176,7 @@ Por favor, conceda-nos pelo menos duas semanas para que possamos analisar o seu ### Pedidos de aplicação de lei estrangeira -Como empresa dos Estados Unidos sediada na Califórnia, o GitHub não é obrigado a fornecer dados a governos estrangeiros em resposta a processo judicial emitido por autoridades estrangeiras. As autoridades responsáveis pela aplicação da lei estrangeira que desejem solicitar informações ao GitHub deverão entrar em contato com o Gabinete de Assuntos Internacionais da Divisão Penal do Departamento de Justiça dos Estados Unidos. O GitHub responderá prontamente às solicitações que forem emitidas via tribunal dos EUA, por meio de um contrato de assistência jurídica mútua (“MLAT”) ou carta rogatória. court by way of a mutual legal assistance treaty (“MLAT”) or letter rogatory. +Como empresa dos Estados Unidos sediada na Califórnia, o GitHub não é obrigado a fornecer dados a governos estrangeiros em resposta a processo judicial emitido por autoridades estrangeiras. As autoridades responsáveis pela aplicação da lei estrangeira que desejem solicitar informações ao GitHub deverão entrar em contato com o Gabinete de Assuntos Internacionais da Divisão Penal do Departamento de Justiça dos Estados Unidos. O GitHub responderá prontamente às solicitações que forem emitidas via tribunal dos EUA, por meio de um contrato de assistência jurídica mútua (“MLAT”) ou carta rogatória. tribunal por meio de um tratado de assistência jurídica mútua (“MLAT”) ou de uma rogatória. ### Perguntas diff --git a/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors-for-open-source-contributors.md b/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors-for-open-source-contributors.md index 36cdf9a6b699..3cb48b60dae8 100644 --- a/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors-for-open-source-contributors.md +++ b/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors-for-open-source-contributors.md @@ -1,5 +1,5 @@ --- -title: 'Sobre o GitHub Sponsors [Patrocinadores do GitHub] para contribuidores de código aberto' +title: Sobre o GitHub Sponsors [Patrocinadores do GitHub] para contribuidores de código aberto intro: 'Ao fornecer valor a um projeto de código aberto, você pode se tornar um contribuidor patrocinado para receber pagamentos pelo seu trabalho.' redirect_from: - /articles/about-github-sponsors-for-sponsored-developers diff --git a/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors.md b/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors.md index 76c917081954..15a3efb43db4 100644 --- a/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors.md +++ b/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors.md @@ -1,5 +1,5 @@ --- -title: 'Editando os detalhes do seu perfil para o GitHub Sponsors [Patrocinadores do GitHub]' +title: Editando os detalhes do seu perfil para o GitHub Sponsors [Patrocinadores do GitHub] intro: Você pode atualizar as informações que são visualizadas pelos possíveis patrocinadores sobre o seu trabalho. redirect_from: - /articles/editing-your-sponsored-developer-profile diff --git a/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md b/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md index f0cff8ca12ff..9231e0ba4f7c 100644 --- a/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md +++ b/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md @@ -50,7 +50,7 @@ Para se juntar ao {% data variables.product.prodname_sponsors %} como colaborado ### Enviando informações bancárias -Como organização patrocinada, você deve receber pagamentos em uma conta bancária exclusiva para sua organização em uma região apoiada. Você pode ter uma conta bancária jurídica por meio de serviços como [Open Collective](https://opencollective.com/) e [Stripe Atlas](https://stripe.com/atlas). {% data reusables.sponsors.stripe-supported-regions %} +Como organização patrocinada, você deve receber pagamentos em uma conta bancária exclusiva para sua organização em uma região apoiada. Você pode ter uma conta bancária jurídica por meio de serviços como [Open Collective](https://opencollective.com/) e [Stripe Atlas](https://stripe.com/atlas). A região em que sua organização opera legalmente e a região da sua conta bancária devem corresponder. A pessoa que criou o {% data variables.product.prodname_sponsors %} para a organização também deve morar na mesma região suportada. {% data reusables.sponsors.stripe-supported-regions %} {% data reusables.sponsors.double-check-stripe-info %} diff --git a/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md b/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md index 07e011221406..47e5bc753432 100644 --- a/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md +++ b/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md @@ -50,7 +50,7 @@ Depois de {% data variables.product.prodname_dotcom %} avaliar sua solicitação ### Enviando informações bancárias -Se você vive em uma região aceita, você pode seguir essas instruções para enviar informações bancárias criando uma conta do Stripe Connect. {% data reusables.sponsors.stripe-supported-regions %} +Se você vive em uma região aceita, você pode seguir essas instruções para enviar informações bancárias criando uma conta do Stripe Connect. A sua região de residência e a região da sua conta bancária devem corresponder. {% data reusables.sponsors.stripe-supported-regions %} {% data reusables.sponsors.double-check-stripe-info %} diff --git a/translations/pt-BR/content/github/using-git/about-git-subtree-merges.md b/translations/pt-BR/content/github/using-git/about-git-subtree-merges.md index 0bfe6aa80b49..3bce6207279f 100644 --- a/translations/pt-BR/content/github/using-git/about-git-subtree-merges.md +++ b/translations/pt-BR/content/github/using-git/about-git-subtree-merges.md @@ -37,7 +37,7 @@ A melhor maneira de explicar merges de subárvore é mostrar com exemplo. O que $ touch .gitignore $ git add .gitignore $ git commit -m "initial commit" - > [master (root-commit) 3146c2a] initial commit + > [main (root-commit) 3146c2a] initial commit > 0 files changed, 0 insertions(+), 0 deletions(-) > create mode 100644 .gitignore ``` @@ -55,29 +55,29 @@ A melhor maneira de explicar merges de subárvore é mostrar com exemplo. O que > Receiving objects: 100% (1732/1732), 528.19 KiB | 621 KiB/s, done. > Resolving deltas: 100% (1086/1086), done. > From git://github.com/octocat/Spoon-Knife - > * [new branch] master -> Spoon-Knife/master + > * [new branch] main -> Spoon-Knife/main ``` 2. Faça merge do projeto `Spoon-Knife` no projeto Git local. Isso não muda qualquer um de seus arquivos localmente, mas prepara o Git para a próxima etapa. Se você estiver usando o Git 2.9 ou superior: ```shell - $ git merge -s ours --no-commit --allow-unrelated-histories spoon-knife/master + $ git merge -s ours --no-commit --allow-unrelated-histories spoon-knife/main > Automatic merge went well; stopped before committing as requested ``` Se estiver usando o Git 2.8 ou abaixo: ```shell - $ git merge -s ours --no-commit spoon-knife/master + $ git merge -s ours --no-commit spoon-knife/main > Automatic merge went well; stopped before committing as requested ``` 3. Crie um diretório chamado **spoon-knife** e copie o histórico do projeto `Spoon-Knife` do Git nele. ```shell - $ git read-tree --prefix=spoon-knife/ -u spoon-knife/master + $ git read-tree --prefix=spoon-knife/ -u spoon-knife/main ``` 4. Faça commit das alterações para mantê-las seguras. ```shell $ git commit -m "Subtree merged in spoon-knife" - > [master fe0ca25] Subtree merged in spoon-knife + > [main fe0ca25] Subtree merged in spoon-knife ``` Embora tenhamos adicionado apenas um subprojeto, qualquer número de subprojetos pode ser incorporado a um repositório Git. @@ -99,7 +99,7 @@ $ git pull -s subtree remotename branchname Para o exemplo acima, o comando seria: ```shell -$ git pull -s subtree spoon-knife master +$ git pull -s subtree spoon-knife main ``` ### Leia mais diff --git a/translations/pt-BR/content/github/using-git/dealing-with-non-fast-forward-errors.md b/translations/pt-BR/content/github/using-git/dealing-with-non-fast-forward-errors.md index 2dbdbcb05483..2a9414537f8b 100644 --- a/translations/pt-BR/content/github/using-git/dealing-with-non-fast-forward-errors.md +++ b/translations/pt-BR/content/github/using-git/dealing-with-non-fast-forward-errors.md @@ -11,9 +11,9 @@ versions: Se outra pessoa tiver feito push no mesmo branch que você, o Git não poderá fazer push das alterações: ```shell -$ git push origin master +$ git push origin main > To https://{% data variables.command_line.codeblock %}/USERNAME/REPOSITORY.git -> ! [rejected] master -> master (non-fast-forward) +> ! [rejected] main -> main (non-fast-forward) > error: failed to push some refs to 'https://{% data variables.command_line.codeblock %}/USERNAME/REPOSITORY.git' > To prevent you from losing history, non-fast-forward updates were rejected > Merge the remote changes (e.g. 'git pull') before pushing again. See the diff --git a/translations/pt-BR/content/github/using-git/getting-changes-from-a-remote-repository.md b/translations/pt-BR/content/github/using-git/getting-changes-from-a-remote-repository.md index b04d101acd28..1b4fe7390186 100644 --- a/translations/pt-BR/content/github/using-git/getting-changes-from-a-remote-repository.md +++ b/translations/pt-BR/content/github/using-git/getting-changes-from-a-remote-repository.md @@ -20,7 +20,7 @@ $ git clone https://{% data variables.command_line.codeblock %}/USERNAME <REMOTENAME> <BRANCHNAME> ``` -Como um exemplo, você normalmente executa `git push origin master` para fazer push de suas alterações locais para seu repositório online. +Como exemplo, você normalmente executa o `git push origin main` para fazer push das suas alterações locais para o seu repositório on-line. ### Renomear branches @@ -84,7 +84,7 @@ git fetch upstream > remote: Total 62 (delta 27), reutilizados 44 (delta 9) > Descompactação de objetos: 100% (62/62), concluída. > From https://{% data variables.command_line.codeblock %}/octocat/repo -> * [novo branch] master -> upstream/master +> * [new branch] main -> upstream/main ``` Quando finalizar as alterações locais, você pode fazer push do seu branch local para o GitHub e [iniciar uma pull request](/articles/about-pull-requests). diff --git a/translations/pt-BR/content/github/using-git/splitting-a-subfolder-out-into-a-new-repository.md b/translations/pt-BR/content/github/using-git/splitting-a-subfolder-out-into-a-new-repository.md index d421d7c14d22..fdc0bcda23c2 100644 --- a/translations/pt-BR/content/github/using-git/splitting-a-subfolder-out-into-a-new-repository.md +++ b/translations/pt-BR/content/github/using-git/splitting-a-subfolder-out-into-a-new-repository.md @@ -33,7 +33,7 @@ Se você criar um clone do repositório, não perderá nenhuma alteração ou hi {% endtip %} {% endwindows %} - - `BRANCH-NAME`: o branch padrão do projeto atual, como `master` ou `gh-pages`. + - `BRANCH-NAME`: O branch-padrão para seu projeto atual, por exemplo, `main` ou `gh-pages`. ```shell $ git filter-branch --prune-empty --subdirectory-filter FOLDER-NAME BRANCH-NAME # Filtra o branch especificado no diretório e remove os commits vazios diff --git a/translations/pt-BR/content/github/using-git/which-remote-url-should-i-use.md b/translations/pt-BR/content/github/using-git/which-remote-url-should-i-use.md index 434c08fb48cd..74c533757a5e 100644 --- a/translations/pt-BR/content/github/using-git/which-remote-url-should-i-use.md +++ b/translations/pt-BR/content/github/using-git/which-remote-url-should-i-use.md @@ -31,7 +31,7 @@ Quando você aplicar `git clone`, `git fetch`, `git pull` ou `git push` a um rep {% endtip %} - {% if currentVersion == "free-pro-team@latest" %}Se você prefere usar o SSH mas não consegue conectar-se pela porta 22, você poderá usar o SSH através da porta HTTPS. Para obter mais informações, consulte "[Usar SSH através da porta HTTPS](/github/authenticating-to-github/using-ssh-over-the-https-port)".{% endif %} + {% if currentVersion == "free-pro-team@latest" %}Se você preferir usar SSH mas não pode conectar-se pela porta 22, você pode usar SSH através da porta HTTPS. Para obter mais informações, consulte "[Usar SSH através da porta HTTPS](/github/authenticating-to-github/using-ssh-over-the-https-port)".{% endif %} ### Clonar com URLs de SSH diff --git a/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/about-repository-graphs.md b/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/about-repository-graphs.md index 565579dbc5bd..92b66362301f 100644 --- a/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/about-repository-graphs.md +++ b/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/about-repository-graphs.md @@ -9,7 +9,7 @@ versions: enterprise-server: '*' --- -Os gráficos de um repositório fornecem informações sobre o tráfego do {% if currentVersion == "free-pro-team@latest" %}, projetos que dependem do repositório,{% endif %} contribuidores e commits do repositório, além de bifurcações e rede de um repositório. Se você mantém um repositório, é possível usar esses dados para entender melhor quem está usando o repositório e por que está usando. +Os gráficos de um repositório fornecem informações sobre {% if currentVersion == "free-pro-team@latest" %} tráfego, projetos que dependem do repositório,{% endif %} contribuidores e commits no repositório e bifurcações de um repositório e rede. Se você mantém um repositório, é possível usar esses dados para entender melhor quem está usando o repositório e por que está usando. {% if currentVersion == "free-pro-team@latest" %} diff --git a/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md b/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md index 3ebfd0eae0c5..069c3b38eda2 100644 --- a/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md +++ b/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md @@ -47,7 +47,6 @@ You can use the dependency graph to: {% if currentVersion == "free-pro-team@latest" %}To generate a dependency graph, {% data variables.product.product_name %} needs read-only access to the dependency manifest and lock files for a repository. The dependency graph is automatically generated for all public repositories and you can choose to enable it for private repositories. For information about enabling or disabling it for private repositories, see "[Exploring the dependencies of a repository](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository)."{% endif %} - {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %}If the dependency graph is not available in your system, your site administrator can enable the dependency graph and {% data variables.product.prodname_dependabot_short %} alerts. For more information, see "[Enabling alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server)."{% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %} If the dependency graph is not available in your system, your site administrator can enable the dependency graph and security alerts. For more information, see "[Enabling alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server)." @@ -62,7 +61,7 @@ The recommended formats explicitly define which versions are used for all direct | Package manager | Languages | Recommended formats | All supported formats | | --- | --- | --- | ---| -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}| Composer | PHP | `composer.lock` | `composer.json`, `composer.lock` |{% endif %} +| Composer | PHP | `composer.lock` | `composer.json`, `composer.lock` | | `dotnet` CLI | .NET languages (C#, C++, F#, VB) | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj` | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj`, `packages.config` | | Maven | Java, Scala | `pom.xml` | `pom.xml` | | npm | JavaScript | `package-lock.json` | `package-lock.json`, `package.json`| diff --git a/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/accessing-basic-repository-data.md b/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/accessing-basic-repository-data.md index 2c1b4d3b7072..b4f526e830ea 100644 --- a/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/accessing-basic-repository-data.md +++ b/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/accessing-basic-repository-data.md @@ -1,6 +1,6 @@ --- title: Acessar dados básicos do repositório -intro: 'Você pode exibir informações básicas sobre um repositório, como a atividade do repositório{% if currentVersion == "free-pro-team@latest" %}, o tráfego{% endif %} e a atividade de contribuição.' +intro: 'Você pode visualizar as informações básicas sobre um repositório, como a atividade do repositório{% if currentVersion == "free-pro-team@latest" %}, tráfego{% endif %} e atividade de contribuição.' mapTopic: true redirect_from: - /articles/accessing-basic-repository-data diff --git a/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md b/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md index 243094df2c95..e36be4de5df1 100644 --- a/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md +++ b/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md @@ -1,6 +1,6 @@ --- title: Explorar as dependências de um repositório -intro: 'Ao usar o gráfico de dependência, você pode ver os pacotes dos quais o seu projeto depende{% if currentVersion == "free-pro-team@latest" %} e os repositórios que dependem dele{% endif %}. Além disso, você pode ver todas as vulnerabilidades detectadas nas suas dependências.' +intro: 'Ao usar o gráfico de dependência, você pode ver os pacotes dos quais o projeto depende {% if currentVersion == "free-pro-team@latest" %} e os repositórios que dependem dele{% endif %}. Além disso, você pode ver todas as vulnerabilidades detectadas nas suas dependências.' redirect_from: - /articles/listing-the-packages-that-a-repository-depends-on - /github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on @@ -26,7 +26,8 @@ O gráfico de dependências mostra as dependências{% if currentVersion == "free #### Vista de dependências {% if currentVersion == "free-pro-team@latest" %} -As dependências são agrupadas por ecossistema. Você pode expandir sua dependência para visualizar suas dependências. Para dependências em repositórios públicos hospedadas no {% data variables.product.product_name %}, você também pode clicar em uma dependência para visualizar o repositório. Dependências de repositórios privados, pacotes privados ou arquivos não reconhecidos são exibidos em texto sem formatação. +As dependências são agrupadas por ecossistema. Você pode expandir sua dependência para visualizar suas dependências. Para dependências de repositórios públicos hospedados em +{% data variables.product.product_name %}, você também pode clicar em uma dependência para visualizar o repositório. Dependências de repositórios privados, pacotes privados ou arquivos não reconhecidos são exibidos em texto sem formatação. Se foram detectadas vulnerabilidades no repositório, estas são exibidas na parte superior da visualização para usuários com acesso ao {% data variables.product.prodname_dependabot_alerts %}. @@ -35,7 +36,8 @@ Se foram detectadas vulnerabilidades no repositório, estas são exibidas na par {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %} -Todas as dependências diretas e indiretas especificadas no manifesto do repositório ou arquivos de bloqueio são listadas e agrupadas pelo ecossistema. Se foram detectadas vulnerabilidades no repositório, estas serão exibidas na parte superior da visualização para usuários com acesso a alertas do {% data variables.product.prodname_dependabot_short %}. +Todas as dependências diretas e indiretas especificadas no manifesto do repositório ou arquivos de bloqueio são listadas e agrupadas pelo ecossistema. Se foram detectadas vulnerabilidades no repositório, estas serão exibidas na parte superior da visualização para usuários com acesso ao +Alertas de {% data variables.product.prodname_dependabot_short %}. {% note %} @@ -98,7 +100,8 @@ Você pode desabilitar o gráfico de dependências a qualquer momento clicando e Se seu gráfico de dependências estiver vazio, poderá haver um problema com o arquivo que contém suas dependências. Selecione o arquivo para garantir que ele esteja corretamente formatado para o tipo de arquivo. {% if currentVersion == "free-pro-team@latest" %} -Se o arquivo estiver formatado corretamente, verifique o seu tamanho. O gráfico de dependências ignora arquivos de manifesto individual e os arquivos e bloqueio com tamanho superior a Mb, a menos que você seja um usuário do {% data variables.product.prodname_enterprise %}. Ele processa até 20 arquivos de manifesto ou de bloqueio por repositório por padrão; logo você pode dividir dependências em arquivos menores em subdiretórios do repositório.{% endif %} +Se o arquivo estiver formatado corretamente, verifique o seu tamanho. O gráfico de dependências ignora manifesto individual e arquivos de bloqueio com tamanho superior a 0,5 Mb, a menos que você seja um +usuário de {% data variables.product.prodname_enterprise %}. Ele processa até 20 arquivos de manifesto ou de bloqueio por repositório por padrão; logo você pode dividir dependências em arquivos menores em subdiretórios do repositório.{% endif %} Se um arquivo de manifesto ou de bloqueio não for processado, suas dependências serão omitidas no gráfico de dependências e não será possível verificar se há dependências. diff --git a/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/understanding-connections-between-repositories.md b/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/understanding-connections-between-repositories.md index c840df396873..64b9ed469b86 100644 --- a/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/understanding-connections-between-repositories.md +++ b/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/understanding-connections-between-repositories.md @@ -1,6 +1,6 @@ --- title: Entender conexões entre repositórios -intro: 'Para entender melhor as conexões existentes entre os repositórios, exiba a rede de um repositório{% if currentVersion == "free-pro-team@latest" %}, os projetos que dependem do repositório{% endif %} e as bifurcações dele.' +intro: 'Você pode entender melhor as conexões existentes entre repositórios, visualizando a rede de um repositório{% if currentVersion == "free-pro-team@latest" %}, projetos que dependem do repositório,{% endif %} e suas bifurcações.' mapTopic: true redirect_from: - /articles/understanding-connections-between-repositories diff --git a/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/viewing-a-projects-contributors.md b/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/viewing-a-projects-contributors.md index ae6dc34aa491..6fd41a710498 100644 --- a/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/viewing-a-projects-contributors.md +++ b/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/viewing-a-projects-contributors.md @@ -1,6 +1,6 @@ --- title: Exibir contribuidores do projeto -intro: 'Você pode ver quem contribuiu com commits para um repositório{% if currentVersion == "free-pro-team@latest" %} e as dependências dele{% endif %}.' +intro: 'Você pode ver quem contribuiu com commits em um repositório{% if currentVersion == "free-pro-team@latest" %} e suas dependências{% endif %}.' redirect_from: - /articles/i-don-t-see-myself-in-the-contributions-graph/ - /articles/viewing-contribution-activity-in-a-repository/ @@ -13,7 +13,7 @@ versions: ### Sobre contribuidores -No gráfico de contribuidores, você pode visualizar os 100 principais contribuidores de um repositório{% if currentVersion != "free-pro-team@latest" %}, incluindo coautores de commits{% endif %}. Commits de merge e commits vazios não são contabilizados como contribuições para este gráfico. +Você pode visualizar os 100 principais contribuidores de um repositório{% if currentVersion != "free-pro-team@latest" %}, incluindo coautores,{% endif %} no gráfico de contribuidores. Commits de merge e commits vazios não são contabilizados como contribuições para este gráfico. {% if currentVersion == "free-pro-team@latest" %} Você também pode ver uma lista de pessoas que contribuíram para as dependências Python do projeto. Para acessar essa lista de contribuidores da comunidade, visite `https://github.com/REPO-OWNER/REPO-NAME/community_contributors`. diff --git a/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/viewing-traffic-to-a-repository.md b/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/viewing-traffic-to-a-repository.md index 0114b5ec8572..5597ba968207 100644 --- a/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/viewing-traffic-to-a-repository.md +++ b/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/viewing-traffic-to-a-repository.md @@ -1,27 +1,28 @@ --- -title: Exibir tráfego para um repositório -intro: 'No gráfico de tráfego, qualquer pessoa com acesso push a um repositório pode visualizar o tráfego dele, inclusive clones completos (e não fetches), visitantes nos últimos 14 dias, sites de referência e conteúdo popular.' -product: 'Este gráfico de informações do repositório está disponível nos repositórios públicos com {% data variables.product.prodname_free_user %} e {% data variables.product.prodname_free_team %} para organizações, e em repositórios públicos e privados com {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %} e {% data variables.product.prodname_ghe_cloud %}.{% if currentVersion == "free-pro-team@latest" %} Para obter mais informações, consulte "[Sobre gráficos do repositório](/articles/about-repository-graphs)" and "[{% data variables.product.prodname_dotcom %}''s products](/articles/github-s-products)."{% endif %}' +title: Viewing traffic to a repository +intro: 'Anyone with push access to a repository can view its traffic, including full clones (not fetches), visitors from the past 14 days, referring sites, and popular content in the traffic graph.' +product: 'This repository insights graph is available in public repositories with {% data variables.product.prodname_free_user %} and {% data variables.product.prodname_free_team %} for organizations, and in public and private repositories with {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, and {% data variables.product.prodname_ghe_cloud %}.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[About repository graphs](/articles/about-repository-graphs)" and "[{% data variables.product.prodname_dotcom %}''s products](/articles/github-s-products)."{% endif %}' redirect_from: - /articles/viewing-traffic-to-a-repository versions: free-pro-team: '*' --- -A partir dos links indicados nos caminhos especificados, é possível navegar para sites de referência, exceto mecanismos de pesquisa e o {% data variables.product.product_name %} em si. O conteúdo popular tem links para o conteúdo específico que gerou o tráfego. +You can navigate to referring sites, excluding search engines and {% data variables.product.product_name %} itself, from the links the specific paths were referred from. The popular content links to the specific content that generated traffic. -Os sites de referência e o conteúdo popular são ordenados por exibições e visitantes exclusivos. As informações sobre visitantes e clones completos são atualizadas a cada hora, enquanto que as seções de conteúdo popular e sites de referência são atualizadas diariamente. Todos os dados no gráfico de tráfego usam o fuso horário UTC+0, independentemente de onde você está localizado. +Referring sites and popular content are ordered by views and unique visitors. Full clones and visitor information update hourly, while referring sites and popular content sections update daily. All data in the traffic graph uses the UTC+0 timezone, regardless of your location. {% tip %} -**Dica:** passe o mouse sobre um dia específico no gráfico de tráfego para visualizar os dados exatos desse dia. +**Tip:** You can hover over a specific day in the traffic graph to view the exact data for that day. {% endtip %} -![Gráficos de tráfego do repositório com dica de ferramenta](/assets/images/help/graphs/repo_traffic_graphs_tooltip_dotcom.png) +![Repository traffic graphs with tooltip](/assets/images/help/graphs/repo_traffic_graphs_tooltip_dotcom.png) -### Acessar o gráfico de tráfego +### Accessing the traffic graph {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.accessing-repository-graphs %} -3. Na barra lateral esquerda, clique em **Tráfego**. ![Guia Traffic (Tráfego)](/assets/images/help/graphs/traffic_tab.png) +3. In the left sidebar, click **Traffic**. +![Traffic tab](/assets/images/help/graphs/traffic_tab.png) diff --git a/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/visualizing-commits-in-a-repository.md b/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/visualizing-commits-in-a-repository.md index a6c5604bcf4b..c011b9810730 100644 --- a/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/visualizing-commits-in-a-repository.md +++ b/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/visualizing-commits-in-a-repository.md @@ -1,6 +1,6 @@ --- title: Visualizar commits em um repositório -intro: 'No gráfico de commits, é possível ver todos os commits feitos em um repositório no ano passado (exceto commits de merge).' +intro: No gráfico de commits, é possível ver todos os commits feitos em um repositório no ano passado (exceto commits de merge). product: '{% data reusables.gated-features.repository-insights %}' redirect_from: - /articles/visualizing-commits-in-a-repository diff --git a/translations/pt-BR/content/github/working-with-github-pages/about-github-pages-and-jekyll.md b/translations/pt-BR/content/github/working-with-github-pages/about-github-pages-and-jekyll.md index d8be53d3c7d8..471a793cc72a 100644 --- a/translations/pt-BR/content/github/working-with-github-pages/about-github-pages-and-jekyll.md +++ b/translations/pt-BR/content/github/working-with-github-pages/about-github-pages-and-jekyll.md @@ -69,9 +69,10 @@ Você pode adicionar `site.github` a uma publicação ou página para incluir me {% data reusables.pages.add-jekyll-theme %} Para obter mais informações, consulte "[Temas](https://jekyllrb.com/docs/themes/)" na documentação do Jekyll. {% if currentVersion == "free-pro-team@latest" %} -É possível adicionar um tema compatível ao seu site no {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte "[Temas compatíveis](https://pages.github.com/themes/)" no site do {% data variables.product.prodname_pages %} e "[Adicionar um tema ao seu site do {% data variables.product.prodname_pages %} com o seletor de temas](/articles/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser)". +Você pode adicionar um tema compatível ao seu site em +{% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte "[Temas compatíveis](https://pages.github.com/themes/)" no site do {% data variables.product.prodname_pages %} e "[Adicionar um tema ao seu site do {% data variables.product.prodname_pages %} com o seletor de temas](/articles/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser)". -Para usar qualquer outro tema Jekyll de código aberto hospedado no {% data variables.product.prodname_dotcom %}, você pode adicionar o tema manualmente.{% else %} Você pode adicionar um tema ao seu site manualmente.{% endif %} Para obter mais informações, consulte{% if currentVersion == "free-pro-team@latest" %} [temas hospedados no {% data variables.product.prodname_dotcom %}](https://github.com/topics/jekyll-theme) e{% else %} "[Temas compatíveis](https://pages.github.com/themes/)" no site do {% data variables.product.prodname_pages %} e{% endif %} "[Adicionar um tema ao seu site do {% data variables.product.prodname_pages %} usando o Jekyll](/articles/adding-a-theme-to-your-github-pages-site-using-jekyll)". +Para usar qualquer outro tema de código aberto do Jekyll hospedado em {% data variables.product.prodname_dotcom %}, você pode adicionar o tema manualmente.{% else %} Você pode adicionar um tema ao seu site manualmente.{% endif %} Para mais informações, consulte {% if currentVersion == "free-pro-team@latest" %} [temas hospedados em {% data variables.product.prodname_dotcom %}](https://github.com/topics/jekyll-theme) e{% else %} "[Temas compatíveis](https://pages.github.com/themes/)no site de {% data variables.product.prodname_pages %} e{% endif %} "[Adicionar um tema ao seu site de {% data variables.product.prodname_pages %} usando Jekyll](/articles/adding-a-theme-to-your-github-pages-site-using-jekyll)". Você pode substituir qualquer um dos padrões do seu tema editando os arquivos do tema. Para obter mais informações, consulte a documentação do seu tema e "[Substituir padrões do tema](https://jekyllrb.com/docs/themes/#overriding-theme-defaults)" na documentação do Jekyll. diff --git a/translations/pt-BR/content/github/working-with-github-pages/about-github-pages.md b/translations/pt-BR/content/github/working-with-github-pages/about-github-pages.md index dd6a6226aabd..fa9b721ea8ba 100644 --- a/translations/pt-BR/content/github/working-with-github-pages/about-github-pages.md +++ b/translations/pt-BR/content/github/working-with-github-pages/about-github-pages.md @@ -20,22 +20,24 @@ versions: O {% data variables.product.prodname_pages %} é um serviço de hospedagem de site estático que usa arquivos HTML, CSS e JavaScript diretamente de um repositório no {% data variables.product.product_name %} e, como opção, executa os arquivos por meio de um processo e publica um site. Você pode ver exemplos de sites do {% data variables.product.prodname_pages %} na [coleção de exemplos do {% data variables.product.prodname_pages %}](https://github.com/collections/github-pages-examples). {% if currentVersion == "free-pro-team@latest" %} -É possível hospedar seu site no domínio `github.io` do {% data variables.product.prodname_dotcom %} ou no seu próprio domínio personalizado. Para obter mais informações, consulte "[Usar um domínio personalizado com o {% data variables.product.prodname_pages %}](/articles/using-a-custom-domain-with-github-pages)". +Você pode hospedar seu site em +no domínio `github.io` de {% data variables.product.prodname_dotcom %}de `github.io` ou no seu próprio domínio personalizado. Para obter mais informações, consulte "[Usar um domínio personalizado com o {% data variables.product.prodname_pages %}](/articles/using-a-custom-domain-with-github-pages)". {% endif %} Para começar, consulte "[Criar um site do {% data variables.product.prodname_pages %}](/articles/creating-a-github-pages-site)". {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -Os proprietários da organização podem desabilitar a publicação de sites do {% data variables.product.prodname_pages %} nos repositórios da organização. Para obter mais informações, consulte "[Desabilitar a publicação de sites de {% data variables.product.prodname_pages %} para sua organização](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)". +Os proprietários da organização podem desabilitar a publicação de +sites de {% data variables.product.prodname_pages %} nos repositórios da organização. Para obter mais informações, consulte "[Desabilitar a publicação de sites de {% data variables.product.prodname_pages %} para sua organização](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)". {% endif %} ### Tipos de site do {% data variables.product.prodname_pages %} Há três tipos de site do {% data variables.product.prodname_pages %}: projeto, usuário e organização. Os sites de projeto são conectados a um projeto específico hospedado no {% data variables.product.product_name %}, como uma biblioteca do JavaScript ou um conjunto de receitas. Os sites de usuário e organização são conectados a uma conta específica do {% data variables.product.product_name %}. -Para publicar um site de usuário, você deve criar um repositório pertencente à sua conta de usuário que se chama {% if currentVersion == "free-pro-team@latest" %}`.github.io`{% else %}`.`{% endif %}. Para publicar um site de organização, você deve criar um repositório pertencente a uma organização que se chama {% if currentVersion == "free-pro-team@latest" %}`.github.io`{% else %}`.`{% endif %}. {% if currentVersion == "free-pro-team@latest" %}A menos que você esteja usando um domínio personalizado, os sites de usuário e organização estarão disponíveis em `http(s)://.github.io` ou `http(s)://.github.io`.{% endif %} +Para publicar um site de usuário, você deve criar um repositório pertencente à sua conta de usuário denominada {% if currentVersion == "free-pro-team@latest" %}`. ithub.io`{% else %}`.`{% endif %}. Para publicar um site da organização, você deve criar um repositório pertencente a uma organização denominada {% if currentVersion == "free-pro-team@latest" %}`.github.io`{% else %}`.`{% endif %}. {% if currentVersion == "free-pro-team@latest" %}A menos que você esteja usando um domínio personalizado, os sites de usuário e organização estarão disponíveis em `http(s)://.github.io` ou `http(s)://.github.io`.{% endif %} -Os arquivos de origem de um site de projeto são armazenados no mesmo repositório que o respectivo projeto. {% if currentVersion == "free-pro-team@latest" %}A menos que você esteja usando um domínio personalizado, os sites de projeto estarão disponíveis em `http(s)://.github.io/` ou `http(s)://.github.io/`.{% endif %} +Os arquivos de origem de um site de projeto são armazenados no mesmo repositório que o respectivo projeto. {% if currentVersion == "free-pro-team@latest" %}A menos que você esteja usando um domínio personalizado, os sites de projeto estão disponíveis em `http(s)://. .github.io` ou `http(s)://.github.io/`.{% endif %} {% if currentVersion == "free-pro-team@latest" %} Para obter mais informações sobre como os domínios personalizados afetam o URL do seu site, consulte "[Sobre domínios personalizados e {% data variables.product.prodname_pages %}](/articles/about-custom-domains-and-github-pages)". @@ -44,7 +46,8 @@ Para obter mais informações sobre como os domínios personalizados afetam o UR Você pode criar apenas um site de usuário ou organização para cada conta do {% data variables.product.product_name %}. Os sites de projeto, sejam eles de uma conta de organização ou de usuário, são ilimitados. {% if currentVersion != "free-pro-team@latest" %} -O URL onde o site estará disponível depende da habilitação do isolamento do subdomínio para o {% data variables.product.product_location %}. +A URL em que o site está disponível depende da habilitação do isolamento de subdomínio para +{% data variables.product.product_location %}. | Tipo de site | Isolamento de subdomínio habilitado | Isolamento de subdomínio desabilitado | | ------------ | ----------------------------------- | ------------------------------------- | @@ -76,7 +79,7 @@ Se existir uma fonte de publicação padrão no repositório, o {% data variable Se você desejar manter os arquivos de origem do seu site em outro local, você poderá alterar a fonte de publicação do seu site. É possível publicar o site a partir de qualquer branch no repositório, a partir da raiz do repositório nesse branch, `/` ou a partir da pasta `/docs` nesse branch. Para obter mais informações, consulte "[Configurar uma fonte de publicação para seu site do {% data variables.product.prodname_pages %}](/articles/configuring-a-publishing-source-for-your-github-pages-site#choosing-a-publishing-source)". -Se você escolher a pasta `/docs` de qualquer branch como a fonte de publicação, o {% data variables.product.prodname_pages %} lerá tudo a ser publicado no seu site{% if currentVersion == "free-pro-team@latest" %}, inclusive o arquivo _CNAME_,{% endif %} na pasta `/docs`.{% if currentVersion == "free-pro-team@latest" %} Por exemplo, quando você edita o domínio personalizado usando as configurações do {% data variables.product.prodname_pages %}, o domínio personalizado grava em `/docs/CNAME`. Para obter mais informações sobre arquivos _CNAME_, consulte "[Gerenciar um domínio personalizado para seu site do {% data variables.product.prodname_pages %}](/articles/managing-a-custom-domain-for-your-github-pages-site)".{% endif %} +Se você escolher a pasta `/docs` de qualquer branch como fonte de publicação, {% data variables.product.prodname_pages %} lerá tudo para publicar o seu site{% if currentVersion == "free-pro-team@latest" %}, incluindo o arquivo _CNAME_ ,{% endif %} da pasta `/docs` .{% if currentVersion == "free-pro-team@latest" %} Por exemplo, quando você editar o seu domínio personalizado através das configurações {% data variables.product.prodname_pages %}, o domínio personalizado escreverá em `/docs/CNAME`. Para obter mais informações sobre arquivos _CNAME_, consulte "[Gerenciar um domínio personalizado para seu site do {% data variables.product.prodname_pages %}](/articles/managing-a-custom-domain-for-your-github-pages-site)".{% endif %} {% else %} @@ -86,7 +89,7 @@ A fonte de publicação padrão para um site de projeto é o branch `gh-pages`. Os sites de projeto também podem ser publicados do branch `master` ou de uma pasta `/docs` no branch `master`. Para publicar o site de uma dessas fontes, é preciso configurar uma fonte de publicação diferente. Para obter mais informações, consulte "[Configurar uma fonte de publicação para seu site do {% data variables.product.prodname_pages %}](/articles/configuring-a-publishing-source-for-your-github-pages-site#choosing-a-publishing-source)". - Se você escolher a pasta `/docs` no branch `master` como a fonte de publicação, o {% data variables.product.prodname_pages %} lerá tudo a ser publicado no seu site{% if currentVersion == "free-pro-team@latest" %}, inclusive o arquivo _CNAME_,{% endif %} na pasta `/docs`.{% if currentVersion == "free-pro-team@latest" %} Por exemplo, quando você edita o domínio personalizado usando as configurações do {% data variables.product.prodname_pages %}, o domínio personalizado grava em `/docs/CNAME`. Para obter mais informações sobre arquivos _CNAME_, consulte "[Gerenciar um domínio personalizado para seu site do {% data variables.product.prodname_pages %}](/articles/managing-a-custom-domain-for-your-github-pages-site)".{% endif %} + Se você escolher a pasta `/docs` do branch `master` como fonte de publicação, {% data variables.product.prodname_pages %} lerá tudo para publicar o seu site{% if currentVersion == "free-pro-team@latest" %}, incluindo o arquivo _CNAME_ {% endif %} da pasta `/docs`.{% if currentVersion == "free-pro-team@latest" %} Por exemplo, ao editar o seu domínio personalizado através das configurações de {% data variables.product.prodname_pages %}, o domínio personalizado escreverá a `/docs/CNAME`. Para obter mais informações sobre arquivos _CNAME_, consulte "[Gerenciar um domínio personalizado para seu site do {% data variables.product.prodname_pages %}](/articles/managing-a-custom-domain-for-your-github-pages-site)".{% endif %} Você não pode publicar seu site de projeto de qualquer outro branch, mesmo que o branch padrão não seja `master` ou `gh-pages`. @@ -94,7 +97,7 @@ Os sites de projeto também podem ser publicados do branch `master` ou de uma pa ### Geradores de site estáticos -O {% data variables.product.prodname_pages %} publica qualquer arquivo estático do qual você faz push no repositório. É possível criar seus próprios arquivos estáticos ou usar um gerador de site estático para que ele crie o site para você. Também pode personalizar seu próprio processo de criação localmente ou em outro servidor. É recomendável usar o Jekyll, um gerador de site estático com suporte integrado para {% data variables.product.prodname_pages %} e um processo de compilação simplificado. Para obter mais informações, consulte "[Sobre o {% data variables.product.prodname_pages %} e o Jekyll](/articles/about-github-pages-and-jekyll)". +O {% data variables.product.prodname_pages %} publica qualquer arquivo estático do qual você faz push no repositório. É possível criar seus próprios arquivos estáticos ou usar um gerador de site estático para que ele crie o site para você. Também pode personalizar seu próprio processo de criação localmente ou em outro servidor. É recomendável usar o Jekyll, um gerador de site estático com suporte integrado para {% data variables.product.prodname_pages %} e um processo de compilação simplificado. Para obter mais informações, consulte "[Sobre o {% data variables.product.prodname_pages %} e o JJekyll](/articles/about-github-pages-and-jekyll)". O {% data variables.product.prodname_pages %} usará o Jekyll para criar seu site por padrão. Se quiser usar um gerador de site estático diferente do Jekyll, desabilite o processo de compilação do Jekyll criando um arquivo vazio chamado `.nojekyll` na raiz da fonte de publicação e siga as instruções do gerador de site estático para criar seu site localmente. @@ -111,10 +114,10 @@ O {% data variables.product.prodname_pages %} não aceita linguagens de servidor {% endif %} Os sites do {% data variables.product.prodname_pages %} estão sujeitos ao seguintes limites de uso: - - Os repositórios de origem do {% data variables.product.prodname_pages %} têm um limite recomendado de 1 GB.{% if currentVersion == "free-pro-team@latest" %} Para obter mais informações, consulte "[Qual é a minha cota de disco?"](/articles/what-is-my-disk-quota/#file-and-repository-size-limitations){% endif %} + - Repositórios de origem de {% data variables.product.prodname_pages %} têm um limite recomendado de 1 GB.{% if currentVersion == "free-pro-team@latest" %} Para obter mais informações, consulte "[Qual é a minha cota de disco?"](/articles/what-is-my-disk-quota/#file-and-repository-size-limitations){% endif %} - Os sites do {% data variables.product.prodname_pages %} publicados não podem ter mais de 1 GB. {% if currentVersion == "free-pro-team@latest" %} - - Os sites do {% data variables.product.prodname_pages %} têm um limite *flexível* de largura de banda de 100 GB por mês. + - Sites de {% data variables.product.prodname_pages %} têm um limite de banda larga *flexível* de 100 GB por mês. - Os sites do {% data variables.product.prodname_pages %} têm um limite *flexível* de 10 compilações por hora. Se o seu site exceder essas cotas de uso, talvez não possamos atender a ele ou você receba um e-mail formal do {% data variables.contact.contact_support %} sugerindo estratégias para reduzir o impacto do site em nossos servidores, como colocar uma rede de distribuição de conteúdo (CDN, Content Distribution Network) de terceiros na frente do site, usar outros recursos do {% data variables.product.prodname_dotcom %}, como versões, ou migrar para outro serviço de hospedagem que possa atender melhor às suas necessidades. @@ -132,8 +135,9 @@ Além disso, os sites do {% data variables.product.prodname_pages %} não devem - Esquemas para enriquecer rapidamente - Conteúdo sexual obsceno - Conteúdo que deturpe sua identidade ou a finalidade do site +Caso não tenha certeza se o seu uso ou o uso previsto se enquadra nessas categorias, entre em contato com o -Caso não tenha certeza se o seu uso ou o uso previsto se enquadra nessas categorias, entre em contato com o {% data variables.contact.contact_support %}. +{% data variables.contact.contact_support %}. {% endif %} ### Tipos de MIME no {% data variables.product.prodname_pages %} diff --git a/translations/pt-BR/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md b/translations/pt-BR/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md index f7660eef9518..5f1db9b664a4 100644 --- a/translations/pt-BR/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md +++ b/translations/pt-BR/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md @@ -13,7 +13,7 @@ versions: ### Sobre erros de criação do Jekyll -Às vezes, o {% data variables.product.prodname_pages %} não tentará criar seu site depois que você fizer push das alterações na fonte de publicação do site.{% if currentVersion == "free-pro-team@latest" %} +Às vezes, {% data variables.product.prodname_pages %} não tentará criar seu site depois que você fizer push das alterações na fonte de publicação do site.{% if currentVersion == "free-pro-team@latest" %} - A pessoa que fez push das alterações não verificou o endereço de e-mail dela. Para obter mais informações, consulte "[Verificar o endereço de e-mail](/articles/verifying-your-email-address)".{% endif %} - Você está fazendo push com uma chave de implantação. Se desejar automatizar pushes para o repositório do seu site, você poderá configurar um usuário de máquina. Para obter mais informações, consulte "[Gerenciar chaves de implantação](/v3/guides/managing-deploy-keys/#machine-users)". - Você está usando um serviço de CI que não está configurado para criar sua fonte de publicação. Por exemplo, Travis CI não criará o branch `gh-pages`, a menos que você adicione o branch a uma lista segura. Para obter mais informações, consulte "[Personalizar a criação](https://docs.travis-ci.com/user/customizing-the-build/#safelisting-or-blocklisting-branches)" em Travis CI ou na documentação do seu serviço de CI. @@ -34,9 +34,7 @@ Para obter informações sobre como solucionar problemas de erros de criação, É recomendável testar o site no local, o que permite ver mensagens de erro de criação na linha de comando e solucionar qualquer falha de criação antes de fazer push das alterações no {% data variables.product.product_name %}. Para obter mais informações, consulte "[Testar seu site do {% data variables.product.prodname_pages %} localmente com o Jekyll](/articles/testing-your-github-pages-site-locally-with-jekyll)". -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} Quando você cria uma pull request para atualizar a fonte de publicação no {% data variables.product.product_name %}, é possível ver mensagens de erro de criação na guia **Checks** (Verificações) da pull request. Para obter mais informações, consulte "[Sobre verificações de status](/articles/about-status-checks)". -{% endif %} Quando você fizer push das alterações na fonte de publicação no {% data variables.product.product_name %}, o {% data variables.product.prodname_pages %} tentará criar seu site. Se a criação falhar, você receberá um e-mail no seu endereço de e-mail principal. Você também receberá e-mails para avisos de criação. {% data reusables.pages.build-failure-email-server %} diff --git a/translations/pt-BR/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md b/translations/pt-BR/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md index b0fdcef93e49..ac288fa9306d 100644 --- a/translations/pt-BR/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md +++ b/translations/pt-BR/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md @@ -21,9 +21,9 @@ Pessoas com permissões de gravação para um repositório podem adicionar um te {% data reusables.pages.navigate-publishing-source %} 2. Navegue até *_config.yml*. {% data reusables.repositories.edit-file %} -4. Adicione uma nova linha ao arquivo para o nome do tema. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - - Para usar um tema compatível, d{% else %}D{% endif %}igite `theme: THEME-NAME`, substituindo _THEME-NAME_ pelo nome do tema, como mostrado no LEIAME do repositório do tema. Para obter uma lista de temas compatíveis, consulte "[Temas compatíveis](https://pages.github.com/themes/)" no site do {% data variables.product.prodname_pages %}. ![Supported theme in config file](/assets/images/help/pages/add-theme-to-config-file.png){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - - Para usar qualquer outro tema do Jekyll hospedado em {% data variables.product.prodname_dotcom %}, digite `remote_theme: THEME-NAME`, substituindo THEME-NAME pelo nome do tema, como mostrado no LEIAME do repositório do tema. ![Unsupported theme in config file](/assets/images/help/pages/add-remote-theme-to-config-file.png){% endif %} +4. Adicione uma nova linha ao arquivo para o nome do tema. + - Para usar um tema compatível, digite `theme: THEME-NAME`, substituindo _THEME-NAME_ pelo nome do tema, conforme mostrado no LEIAME do repositório do tema. Para obter uma lista de temas compatíveis, consulte "[Temas compatíveis](https://pages.github.com/themes/)" no site do {% data variables.product.prodname_pages %}. ![Tema compatível no arquivo de configuração](/assets/images/help/pages/add-theme-to-config-file.png) + - Para usar qualquer outro tema do Jekyll hospedado em {% data variables.product.prodname_dotcom %}, digite `remote_theme: THEME-NAME`, substituindo THEME-NAME pelo nome do tema, como mostrado no LEIAME do repositório do tema. ![Tema não compatível no arquivo de configuração](/assets/images/help/pages/add-remote-theme-to-config-file.png) {% data reusables.files.write_commit_message %} {% data reusables.files.choose-commit-email %} {% data reusables.files.choose_commit_branch %} diff --git a/translations/pt-BR/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md b/translations/pt-BR/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md index 4f029c0af4e5..00f063139e0e 100644 --- a/translations/pt-BR/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md +++ b/translations/pt-BR/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md @@ -1,6 +1,6 @@ --- title: Configurar uma fonte de publicação para o site do GitHub Pages -intro: 'Se você usar a fonte de publicação padrão do site do {% data variables.product.prodname_pages %}, seu site será publicado automaticamente. Você também pode optar por publicar o {% if currentVersion ver_lt "enterprise-server@2.23" %} site{% endif %} do projeto a partir de um branch ou pasta diferente.' +intro: 'Se você usar a fonte de publicação padrão do site do {% data variables.product.prodname_pages %}, seu site será publicado automaticamente. Você também pode optar por publicar o seu{% if currentVersion ver_lt "enterprise-server@2.23" %} site do projeto{% endif %} a partir de um branch ou pasta diferente.' redirect_from: - /articles/configuring-a-publishing-source-for-github-pages/ - /articles/configuring-a-publishing-source-for-your-github-pages-site @@ -15,7 +15,7 @@ Para obter mais informações sobre fontes de publicação, consulte "[Sobre o { ### Escolher uma fonte de publicação -Before you configure a publishing source, make sure the branch{% if currentVersion ver_lt "enterprise-server@2.22" %} or folder{% endif %} you want to use as your publishing source already exists in your repository.{% if currentVersion ver_lt "enterprise-server@2.22" %} For example, before you can publish your project site from the `/docs` folder on the `master` branch of your repository, you or a collaborator must create a `/docs` folder on the default `master` branch of your repository.{% endif %} +Antes de configurar uma fonte de publicação, certifique-se o branch{% if currentVersion ver_lt "enterprise-server@2. 3" %} ou pasta{% endif %} que você deseja usar como fonte de publicação já existe no repositório.{% if currentVersion ver_lt "enterprise-server@2. 3" %} Por exemplo, antes de poder publicar seu site de projeto na pasta `/docs` no `mestre` branch do repositório, um colaborador deverá criar uma pasta `/docs` no branch `mestre` padrão do seu repositório.{% endif %} {% data reusables.pages.navigate-site-repo %} {% data reusables.repositories.sidebar-settings %} @@ -24,11 +24,13 @@ Before you configure a publishing source, make sure the branch{% if currentVersi 4. Opcionalmente, use o menu suspenso para selecionar uma pasta para sua fonte de publicação. ![Menu suspenso para selecionar uma pasta para a fonte de publicação](/assets/images/help/pages/publishing-source-folder-drop-down.png) 5. Clique em **Salvar**. ![Botão para salvar alterações nas configurações da fonte de publicação](/assets/images/help/pages/publishing-source-save.png) {% else %} -3. No "{% data variables.product.prodname_pages %}", use o menu suspenso **Source** (Fonte) e selecione uma fonte de publicação. ![Menu suspenso para selecionar uma fonte de publicação](/assets/images/help/pages/publishing-source-drop-down.png) +3. Em " +{% data variables.product.prodname_pages %}", use o menu suspenso **Fonte** e selecione uma fonte de publicação. + ![Menu suspenso para selecionar uma fonte de publicação](/assets/images/help/pages/publishing-source-drop-down.png) {% endif %} ### Solucionar problemas de publicação com o site do {% data variables.product.prodname_pages %} {% data reusables.pages.admin-must-push %} -If you choose the `docs` folder on {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}any{% else %}the `master`{% endif %} branch as your publishing source, then later remove the `/docs` folder from that branch in your repository, your site won't build and you'll get a page build error message for a missing `/docs` folder. Para obter informações, consulte [Solucionar problemas de erros de criação do Jekyll para sites do {% data variables.product.prodname_pages %}](/articles/troubleshooting-jekyll-build-errors-for-github-pages-sites#missing-docs-folder)". +Se você escolher a pasta `docs` em {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 2" %}qualquer{% else %}o `master`{% endif %} branch como fonte de publicação, remova a pasta `/docs` do branch do repositório. Seu site não será criado e você receberá uma mensagem de erro de criação de página para uma pasta `/docs` ausente. Para obter informações, consulte [Solucionar problemas de erros de criação do Jekyll para sites do {% data variables.product.prodname_pages %}](/articles/troubleshooting-jekyll-build-errors-for-github-pages-sites#missing-docs-folder)". diff --git a/translations/pt-BR/content/github/working-with-github-pages/creating-a-github-pages-site-with-jekyll.md b/translations/pt-BR/content/github/working-with-github-pages/creating-a-github-pages-site-with-jekyll.md index 574ce837ed51..86907ab801db 100644 --- a/translations/pt-BR/content/github/working-with-github-pages/creating-a-github-pages-site-with-jekyll.md +++ b/translations/pt-BR/content/github/working-with-github-pages/creating-a-github-pages-site-with-jekyll.md @@ -1,24 +1,24 @@ --- -title: Criar um site do GitHub Pages com o Jekyll -intro: 'É possível usar o Jekyll para criar um site do {% data variables.product.prodname_pages %} em um repositório novo ou existente.' +title: Creating a GitHub Pages site with Jekyll +intro: 'You can use Jekyll to create a {% data variables.product.prodname_pages %} site in a new or existing repository.' product: '{% data reusables.gated-features.pages %}' redirect_from: - /articles/creating-a-github-pages-site-with-jekyll -permissions: 'Pessoas com permissões de administrador para um repositório podem criar um site do {% data variables.product.prodname_pages %} com o Jekyll.' +permissions: 'People with admin permissions for a repository can create a {% data variables.product.prodname_pages %} site with Jekyll.' versions: free-pro-team: '*' enterprise-server: '*' --- -### Pré-requisitos +### Prerequisites -Antes de poder usar o Jekyll para criar um site do {% data variables.product.prodname_pages %}, você precisa instalar o Jekyll e o Git. Para obter mais informações, consulte [Instalação](https://jekyllrb.com/docs/installation/) na documentação do Jekyll e "[Configurar o Git](/articles/set-up-git)". +Before you can use Jekyll to create a {% data variables.product.prodname_pages %} site, you must install Jekyll and Git. For more information, see [Installation](https://jekyllrb.com/docs/installation/) in the Jekyll documentation and "[Set up Git](/articles/set-up-git)." {% data reusables.pages.recommend-bundler %} {% data reusables.pages.jekyll-install-troubleshooting %} -### Criar um repositório para seu site +### Creating a repository for your site {% data reusables.pages.new-or-existing-repo %} @@ -29,58 +29,59 @@ Antes de poder usar o Jekyll para criar um site do {% data variables.product.pro {% data reusables.pages.create-repo-name %} {% data reusables.repositories.choose-repo-visibility %} -### Criar seu site +### Creating your site {% data reusables.pages.must-have-repo-first %} {% data reusables.command_line.open_the_multi_os_terminal %} -2. Se você ainda não tem uma cópia do seu repositório, navegue até o local onde deseja armazenar os arquivos de origem do seu site, substituindo _PARENT-FOLDER_ pela pasta que deverá conter a pasta do repositório. +2. If you don't already have a local copy of your repository, navigate to the location where you want to store your site's source files, replacing _PARENT-FOLDER_ with the folder you want to contain the folder for your repository. ```shell $ cd PARENT-FOLDER ``` -3. Caso você ainda não o tenha feito, inicialize um repositório Git local, substituindo _REPOSITORY-NAME_ pelo nome do seu repositório. +3. If you haven't already, initialize a local Git repository, replacing _REPOSITORY-NAME_ with the name of your repository. ```shell $ git init REPOSITORY-NAME > Initialized empty Git repository in /Users/octocat/my-site/.git/ - # Cria uma nova pasta no seu computador, inicializada como um repositório Git - ``` - 4. Altere os diretórios no repositório. + # Creates a new folder on your computer, initialized as a Git repository + ``` + 4. Change directories to the repository. ```shell $ cd REPOSITORY-NAME - # Altera o diretório de trabalho + # Changes the working directory ``` {% data reusables.pages.decide-publishing-source %} {% data reusables.pages.navigate-publishing-source %} - Por exemplo, se você escolheu publicar o seu site a partir da pasta `documentação` no branch-padrão, crie e altere os diretórios na pasta `documentação`. + For example, if you chose to publish your site from the `docs` folder on the default branch, create and change directories to the `docs` folder. ```shell $ mkdir docs - # Cria uma nova pasta chamada docs + # Creates a new folder called docs $ cd docs ``` - Se você optou por publicar seu site a partir do branch `gh-pages`, crie e faça checkout do branch `gh-pages`. + If you chose to publish your site from the `gh-pages` branch, create and checkout the `gh-pages` branch. ```shell $ git checkout --orphan gh-pages - # Cria um novo branch, sem histórico ou conteúdo, chamado gh-pages e alterna para o branch gh-pages + # Creates a new branch, with no history or contents, called gh-pages and switches to the gh-pages branch ``` - 7. Para criar um novo site do Jekyll, use o comando `jekyll new`, substituindo _VERSION_ pela versão atual de dependências do Jekyll. Para obter mais informações, consulte "[Versões de dependências](https://pages.github.com/versions/)" no site do {% data variables.product.prodname_pages %}. - - Se você instalou o bundler: + 7. To create a new Jekyll site, use the `jekyll new` command, replacing _VERSION_ with the current dependency version for Jekyll. For more information, see "[Dependency versions](https://pages.github.com/versions/)" on the {% data variables.product.prodname_pages %} site. + - If you installed Bundler: ```shell $ bundle exec jekyll VERSION new . - # Cria um site do Jekyll no diretório atual + # Creates a Jekyll site in the current directory ``` - - Se você não tem o bundler instalado: + - If you don't have Bundler installed: ```shell $ jekyll VERSION new . - # Cria um site do Jekyll no diretório atual + # Creates a Jekyll site in the current directory ``` -8. Abra o Gemfile que foi criado e siga as instruções nos comentários do Gemfile para usar o {% data variables.product.prodname_pages %}. ![Instruções para atualizar o Gemfile](/assets/images/help/pages/gemfile-instructions.png) -9. Para que a linha `gem "github-pages"` fique com a aparência mostrada a seguir, atualize-a substituindo _VERSION_ pela versão atual de dependências para `github-pages`. Para obter mais informações, consulte "[Versões de dependências](https://pages.github.com/versions/)" no site do {% data variables.product.prodname_pages %}. +8. Open the Gemfile that was created and follow the instructions in the Gemfile's comments to use {% data variables.product.prodname_pages %}. + ![Instructions for updating Gemfile](/assets/images/help/pages/gemfile-instructions.png) +9. Update the `gem "github-pages"` line so that the line looks like this, replacing _VERSION_ with the current dependency version for `github-pages`. For more information, see "[Dependency versions](https://pages.github.com/versions/)" on the {% data variables.product.prodname_pages %} site. ```shell gem "github-pages", "~> VERSION", group: :jekyll_plugins ``` -10. Salve e feche o Gemfile. -11. Como alternativa, teste seu site localmente. Para obter mais informações, consulte "[Testar seu site do {% data variables.product.prodname_pages %} localmente com o Jekyll](/articles/testing-your-github-pages-site-locally-with-jekyll)". -12. Adicione seu repositório do {% data variables.product.product_name %} como um remote, substituindo {% if currentVersion != "free-pro-team@latest" %}_HOSTNAME_ pelo nome de host do appliance{% endif %} _USER_ pela conta a que pertence o repositório{% if currentVersion != "free-pro-team@latest" %}{% endif %} e _REPOSITORY_ pelo nome do repositório. +10. Save and close the Gemfile. +11. Optionally, test your site locally. For more information, see "[Testing your {% data variables.product.prodname_pages %} site locally with Jekyll](/articles/testing-your-github-pages-site-locally-with-jekyll)." +12. Add your {% data variables.product.product_name %} repository as a remote, replacing {% if currentVersion != "free-pro-team@latest" %}_HOSTNAME_ with your appliance's hostname,{% endif %} _USER_ with the account that owns the repository{% if currentVersion != "free-pro-team@latest" %},{% endif %} and _REPOSITORY_ with the name of the repository. ```shell {% if currentVersion == "free-pro-team@latest" %} $ git remote add origin https://github.com/USER/REPOSITORY.git @@ -88,7 +89,7 @@ $ git remote add origin https://github.com/USER/REPOSITORY.git $ git remote add origin https://HOSTNAME/USER/REPOSITORY.git {% endif %} ``` -13. Faça push no repositório para o {% data variables.product.product_name %}, substituindo _BRANCH_ pelo nome do branch em que você está trabalhando. +13. Push the repository to {% data variables.product.product_name %}, replacing _BRANCH_ with the name of the branch you're working on. ```shell $ git push -u origin BRANCH ``` @@ -99,8 +100,8 @@ $ git remote add origin https://HOSTNAME/USER/REPOSITORY.github.io//{% else %}`http(s):///pages///{% endif %}about/contact-us.md`. +Você pode adicionar mais páginas ao seu site criando novos arquivos. Cada arquivo ficará disponível no site na mesma estrutura de diretórios que a fonte de publicação. Por exemplo, se a fonte de publicação para o seu site de projeto for o branch `gh-pages`, e você criar um novo arquivo chamado `/about/contact-us.md` no branch `gh-pages`, o arquivo estará disponível em {% if currentVersion == "free-pro-team@latest" %}`https://.github.io//{% else %}`http(s):///pages///{% endif %}about/contact-us.md`. -Também é possível adicionar um tema para personalizar a aparência do site. Para obter mais informações, consulte {% if currentVersion == "free-pro-team@latest" %}"[Adicionar um tema ao site do {% data variables.product.prodname_pages %} com o seletor de temas](/articles/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser){% else %}"[Adicionar um tema ao site do {% data variables.product.prodname_pages %} usando o Jekyll](/articles/adding-a-theme-to-your-github-pages-site-using-jekyll){% endif %}". +Também é possível adicionar um tema para personalizar a aparência do site. Para mais informações consulte {% if currentVersion == "free-pro-team@latest" %}"[Adicionar um tema ao site de {% data variables.product.prodname_pages %} com o seletor de temas](/articles/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser){% else %}"[Adicionar um tema ao site de {% data variables.product.prodname_pages %} usando o Jekyll](/articles/adding-a-theme-to-your-github-pages-site-using-jekyll){% endif %}." -Para personalizar seu site ainda mais, você pode usar o Jekyll, um gerador de site estático com suporte integrado para o {% data variables.product.prodname_pages %}. Para obter mais informações, consulte "[Sobre o {% data variables.product.prodname_pages %} e o Jekyll](/articles/about-github-pages-and-jekyll)". +Para personalizar seu site ainda mais, você pode usar o Jekyll, um gerador de site estático com suporte integrado para o {% data variables.product.prodname_pages %}. Para obter mais informações, consulte "[Sobre o {% data variables.product.prodname_pages %} e o JJekyll](/articles/about-github-pages-and-jekyll)". ### Leia mais diff --git a/translations/pt-BR/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md b/translations/pt-BR/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md index 9eed34e358fa..04ef67b0c177 100644 --- a/translations/pt-BR/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md +++ b/translations/pt-BR/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md @@ -40,7 +40,8 @@ Para configurar um `www` ou subdomínio personalizado, como `www.example.com` ou {% data reusables.pages.navigate-site-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.pages.save-custom-domain %} -5. Navegue até o provedor DNS e crie um registro `CNAME` que aponte seu subdomínio para o domínio padrão do seu site. Por exemplo, se você quiser usar o subdomínio `www.example.com` para seu site de usuário, crie um registro `CNAME` que aponte `www.example.com` para `.github.io`. Se você desejar usar o subdomínio `www.anotherexample.com` no seu site da organização, crie um registro `CNAME` que aponte `www. notherexample.com` para `.github.io`. O arquivo `CNAME` sempre deve apontar para `.github.io` ou `.github.io`, excluindo o nome do repositório. {% data reusables.pages.contact-dns-provider %}{% data reusables.pages.default-domain-information %} +5. Navegue até o provedor DNS e crie um registro `CNAME` que aponte seu subdomínio para o domínio padrão do seu site. Por exemplo, se você quiser usar o subdomínio `www.example.com` para seu site de usuário, crie um registro `CNAME` que aponte `www.example.com` para `.github.io`. Se você desejar usar o subdomínio `www.anotherexample.com` no seu site da organização, crie um registro `CNAME` que aponte `www. notherexample.com` para `.github.io`. O arquivo `CNAME` sempre deve apontar para `.github.io` ou `.github.io`, excluindo o nome do repositório. +{% data reusables.pages.contact-dns-provider %}{% data reusables.pages.default-domain-information %} {% data reusables.command_line.open_the_multi_os_terminal %} 6. Para confirmar que o registro DNS foi configurado corretamente, use o comando `dig`, substituindo _WW.EXAMPLE.COM_ pelo seu subdomínio. ```shell diff --git a/translations/pt-BR/content/github/working-with-github-pages/troubleshooting-jekyll-build-errors-for-github-pages-sites.md b/translations/pt-BR/content/github/working-with-github-pages/troubleshooting-jekyll-build-errors-for-github-pages-sites.md index 16b40d330e87..1ed03b1e523d 100644 --- a/translations/pt-BR/content/github/working-with-github-pages/troubleshooting-jekyll-build-errors-for-github-pages-sites.md +++ b/translations/pt-BR/content/github/working-with-github-pages/troubleshooting-jekyll-build-errors-for-github-pages-sites.md @@ -1,6 +1,6 @@ --- -title: Solucionar problemas de erros de criação do Jekyll para sites do GitHub Pages -intro: 'Você pode usar mensagens de erro de criação do Jekyll para solucionar problemas com seu site do {% data variables.product.prodname_pages %}.' +title: Troubleshooting Jekyll build errors for GitHub Pages sites +intro: 'You can use Jekyll build error messages to troubleshoot problems with your {% data variables.product.prodname_pages %} site.' redirect_from: - /articles/page-build-failed-missing-docs-folder/ - /articles/page-build-failed-invalid-submodule/ @@ -30,158 +30,158 @@ versions: enterprise-server: '*' --- -### Solucionar problemas de erros de criação +### Troubleshooting build errors -Se o Jekyll encontrar um erro ao criar seu site do {% data variables.product.prodname_pages %} localmente ou no {% data variables.product.product_name %}, você poderá usar mensagens de erro para solucionar problemas. Para obter mais informações sobre mensagens de erro e como visualizá-las, consulte "[Sobre erros de criação do Jekyll para sites do {% data variables.product.prodname_pages %}](/articles/about-jekyll-build-errors-for-github-pages-sites)". +If Jekyll encounters an error building your {% data variables.product.prodname_pages %} site locally or on {% data variables.product.product_name %}, you can use error messages to troubleshoot. For more information about error messages and how to view them, see "[About Jekyll build errors for {% data variables.product.prodname_pages %} sites](/articles/about-jekyll-build-errors-for-github-pages-sites)." -Se você recebeu uma mensagem de erro genérica, verifique os problemas comuns. -- Você está usando plugins incompatíveis. Para obter mais informações, consulte "[Sobre o {% data variables.product.prodname_pages %} e o Jekyll](/articles/about-github-pages-and-jekyll#plugins)".{% if currentVersion == "free-pro-team@latest" %} -- Seu repositório excedeu os limites de tamanho. Para obter mais informações, consulte "[Qual é a minha quota de disco?](/articles/what-is-my-disk-quota)"{% endif %} -- Você alterou a configuração `source` no arquivo *_config.yml*. {% data variables.product.prodname_pages %} substitui essa configuração durante o processo de criação. -- Um nome de arquivo na fonte de publicação contém dois pontos (`:`), o que não é permitido. +If you received a generic error message, check for common issues. +- You're using unsupported plugins. For more information, see "[About {% data variables.product.prodname_pages %} and Jekyll](/articles/about-github-pages-and-jekyll#plugins)."{% if currentVersion == "free-pro-team@latest" %} +- Your repository has exceeded our repository size limits. For more information, see "[What is my disk quota?](/articles/what-is-my-disk-quota)"{% endif %} +- You changed the `source` setting in your *_config.yml* file. {% data variables.product.prodname_pages %} overrides this setting during the build process. +- A filename in your publishing source contains a colon (`:`) which is not supported. -Se você recebeu uma mensagem de erro específica, revise abaixo as informações de solução de problemas relativas à mensagem de erro. +If you received a specific error message, review the troubleshooting information for the error message below. -Depois que tiver corrigido os possíveis erros, faça push das alterações para a fonte de publicação do seu site para ativar outra criação no {% data variables.product.product_name %}. +After you've fixed any errors, push the changes to your site's publishing source to trigger another build on {% data variables.product.product_name %}. -### Erro no arquivo de configuração +### Config file error -Este erro significa que ocorreu falha na criação do seu site porque o arquivo *_config.yml* contém erros de sintaxe. +This error means that your site failed to build because the *_config.yml* file contains syntax errors. -Para solucionar problemas, verifique se o arquivo *_config.yml* segue estas regras: +To troubleshoot, make sure that your *_config.yml* file follows these rules: {% data reusables.pages.yaml-rules %} {% data reusables.pages.yaml-linter %} -### Esta é uma data/hora inválida +### Date is not a valid datetime -Este erro significa que uma das páginas do seu site inclui uma data/hora inválida. +This error means that one of the pages on your site includes an invalid datetime. -Para solucionar problemas, pesquise o arquivo na mensagem de erro e os layouts do arquivo para as exigências de qualquer filtro de data do Liquid. Verifique se alguma variável passada em filtros de data do Liquid tem valores em todos os casos e nunca passa `nil` ou `""`. Para obter mais informações, consulte "[Filtros do Liquid](https://help.shopify.com/en/themes/liquid/filters)" na documentação do Liquid. +To troubleshoot, search the file in the error message and the file's layouts for calls to any date-related Liquid filters. Make sure that any variables passed into date-related Liquid filters have values in all cases and never pass `nil` or `""`. For more information, see "[Liquid filters](https://help.shopify.com/en/themes/liquid/filters)" in the Liquid documentation. -### O arquivo não existe no diretório includes +### File does not exist in includes directory -Este erro significa que o código faz referência a um arquivo que não existe no diretório *_includes*. +This error means that your code references a file that doesn't exist in your *_includes* directory. -{% data reusables.pages.search-for-includes %} Se algum dos arquivos a que você fez referência não estiver no diretório *_includes*, copie ou mova os arquivos para o diretório *_includes*. +{% data reusables.pages.search-for-includes %} If any of the files you've referenced aren't in the *_includes* directory, copy or move the files into the *_includes* directory. -### O arquivo é um link simbólico +### File is a symlink -Este erro significa que o código faz referência a um arquivo com link simbólico que não existe na fonte de publicação do seu site. +This error means that your code references a symlinked file that does not exist in the publishing source for your site. -{% data reusables.pages.search-for-includes %} Se algum dos arquivos a que você fez referência for com link simbólico, copie ou mova os arquivos para o diretório *_includes*. +{% data reusables.pages.search-for-includes %} If any of the files you've referenced are symlinked, copy or move the files into the *_includes* directory. -### Arquivo codificado por UTF-8 incorretamente +### File is not properly UTF-8 encoded -Este erro significa que você usou caracteres não latinos, como `日本語`, sem avisar ao computador que esperava esses símbolos. +This error means that you used non-Latin characters, like `日本語`, without telling the computer to expect these symbols. -Para solucionar problemas, force a codificação UTF-8 adicionando a seguinte linha ao arquivo *_config.yml*: +To troubleshoot, force UTF-8 encoding by adding the following line to your *_config.yml* file: ``` encoding: UTF-8 ``` -### Linguagem inválida do realçador +### Invalid highlighter language -Este erro significa que você especificou algum realçador de sintaxe diferente de [Rouge](https://github.com/jneen/rouge) ou [Pygments](http://pygments.org/) no arquivo de configuração. +This error means that you specified any syntax highlighter other than [Rouge](https://github.com/jneen/rouge) or [Pygments](http://pygments.org/) in your configuration file. -Para solucionar problemas, atualize o arquivo *_config.yml* para especificar [Rouge](https://github.com/jneen/rouge) ou [Pigmentos](http://pygments.org/). Para obter mais informações, consulte "[Sobre o {% data variables.product.product_name %} e o Jekyll](/articles/about-github-pages-and-jekyll#syntax-highlighting)". +To troubleshoot, update your *_config.yml* file to specify [Rouge](https://github.com/jneen/rouge) or [Pygments](http://pygments.org/). For more information, see "[About {% data variables.product.product_name %} and Jekyll](/articles/about-github-pages-and-jekyll#syntax-highlighting)." -### Data de postagem inválida +### Invalid post date -Este erro significa que uma postagem no seu site contém uma data inválida no nome de arquivo ou na página inicial YAML. +This error means that a post on your site contains an invalid date in the filename or YAML front matter. -Para solucionar problemas, verifique se todas as datas estão no formato YYYY-MM-DD HH:MM:SS para UTC e se são datas reais do calendário. Para especificar um fuso horário com um intervalo de tempo UTC, use o formato YYYY-MM-DD HH:MM:SS +/-TTTT (ano-mês-dia horas:minutos:segundos +/-TTTT), como `2014-04-18 11:30:00 +0800`. +To troubleshoot, make sure all dates are formatted as YYYY-MM-DD HH:MM:SS for UTC and are actual calendar dates. To specify a time zone with an offset from UTC, use the format YYYY-MM-DD HH:MM:SS +/-TTTT, like `2014-04-18 11:30:00 +0800`. -Se você especificar um formato de data no arquivo *_config.yml*, verifique se o formato está correto. +If you specify a date format in your *_config.yml* file, make sure the format is correct. -### SCSS ou Sass inválido +### Invalid Sass or SCSS -Este erro significa que seu repositório contém um arquivo Sass ou SCSS com conteúdo inválido. +This error means your repository contains a Sass or SCSS file with invalid content. -Para solucionar problemas, revise o número de linha incluído na mensagem de erro referente a Sass ou SCSS inválido. Para ajudar a prevenir erros no futuro, instale um linter Sass ou SCSS para seu editor de texto favorito. +To troubleshoot, review the line number included in the error message for invalid Sass or SCSS. To help prevent future errors, install a Sass or SCSS linter for your favorite text editor. -### Submódulo inválido +### Invalid submodule -Este erro significa que seu repositório inclui um submódulo que não foi inicializado corretamente. +This error means that your repository includes a submodule that hasn't been properly initialized. {% data reusables.pages.remove-submodule %} -Caso queira utilizar o submódulo, lembre-se de usar `https://` quando fizer referência ao submódulo (a não `http://`) e de que o submódulo está em um repositório público. +If do you want to use the submodule, make sure you use `https://` when referencing the submodule (not `http://`) and that the submodule is in a public repository. -### YAML inválido no arquivo de dados +### Invalid YAML in data file -Este erro significa que um ou mais arquivos na pasta *_data* contém YAML inválido. +This error means that one of more files in the *_data* folder contains invalid YAML. -Para solucionar problemas, verifique se os arquivos YAML na pasta *_data* seguem estas regras: +To troubleshoot, make sure the YAML files in your *_data* folder follow these rules: {% data reusables.pages.yaml-rules %} {% data reusables.pages.yaml-linter %} -Para obter mais informações sobre arquivos de dados do Jekyll, consulte ""[Arquivos de dados](https://jekyllrb.com/docs/datafiles/)" na documentação do Jekyll. +For more information about Jekyll data files, see "[Data Files](https://jekyllrb.com/docs/datafiles/)" in the Jekyll documentation. -### Erros de markdown +### Markdown errors -Este erro significa que seu repositório contém erros de markdown. +This error means that your repository contains Markdown errors. -Para solucionar problemas, verifique se você está usando um processador markdown compatível. Para obter mais informações, consulte "[Definir um processador markdown para seu site do {% data variables.product.prodname_pages %} usando o Jekyll](/articles/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll)". +To troubleshoot, make sure you are using a supported Markdown processor. For more information, see "[Setting a Markdown processor for your {% data variables.product.prodname_pages %} site using Jekyll](/articles/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll)." -Em seguida, verifique se o arquivo na mensagem de erro usa uma sintaxe markdown válida. Para obter mais informações, consulte "[Markdown: sintaxe](https://daringfireball.net/projects/markdown/syntax)" no Daring Fireball. +Then, make sure the file in the error message uses valid Markdown syntax. For more information, see "[Markdown: Syntax](https://daringfireball.net/projects/markdown/syntax)" on Daring Fireball. -### Pasta docs ausente +### Missing docs folder -Este erro significa que você escolheu a pasta `docs` em um branch como a sua fonte de publicação, mas não há nenhuma pasta de `docs` na raiz do seu repositório naquele branch. +This error means that you have chosen the `docs` folder on a branch as your publishing source, but there is no `docs` folder in the root of your repository on that branch. -Para solucionar esse problema, se a pasta `documentação` foi movida acidentalmente, tente mover a pasta `docs` de volta para a raiz do repositório no branch que você escolheu para a sua fonte de publicação. Se a pasta `docs` tiver sido excluída acidentalmente, siga um destes procedimentos: -- Use o Git para reverter ou desfazer a exclusão. Para obter mais informações, consulte "[git-revert](https://git-scm.com/docs/git-revert.html)" na documentação do Git. -- Crie uma nova pasta de `documentação` na raiz do repositório no branch que você escolheu para a sua fonte de publicação e adicione os arquivos de origem do site à pasta. Para obter mais informações, consulte "[Criar arquivos](/articles/creating-new-files)". -- Altere a fonte de publicação. Para obter mais informações, consulte "[Configurar uma fonte de publicação do {% data variables.product.prodname_pages %}](/articles/configuring-a-publishing-source-for-github-pages)". +To troubleshoot, if your `docs` folder was accidentally moved, try moving the `docs` folder back to the root of your repository on the branch you chose for your publishing source. If the `docs` folder was accidentally deleted, you can either: +- Use Git to revert or undo the deletion. For more information, see "[git-revert](https://git-scm.com/docs/git-revert.html)" in the Git documentation. +- Create a new `docs` folder in the root of your repository on the branch you chose for your publishing source and add your site's source files to the folder. For more information, see "[Creating new files](/articles/creating-new-files)." +- Change your publishing source. For more information, see "[Configuring a publishing source for {% data variables.product.prodname_pages %}](/articles/configuring-a-publishing-source-for-github-pages)." -### Submódulo ausente +### Missing submodule -Este erro significa que seu repositório inclui um submódulo que não existe ou não foi inicializado corretamente. +This error means that your repository includes a submodule that doesn't exist or hasn't been properly initialized. {% data reusables.pages.remove-submodule %} -Se você quiser usar um submódulo, inicialize-o. Para obter mais informações, consulte "[Ferramentas Git - Submódulos](https://git-scm.com/book/en/v2/Git-Tools-Submodules)" no livro _Pro Git_. +If you do want to use a submodule, initialize the submodule. For more information, see "[Git Tools - Submodules](https://git-scm.com/book/en/v2/Git-Tools-Submodules)" in the _Pro Git_ book. -### Permalinks relativos configurados +### Relative permalinks configured -Este erro significa que você tem permalinks relativos, que não são compatíveis com o {% data variables.product.prodname_pages %} no arquivo *_config.yml*. +This errors means that you have relative permalinks, which are not supported by {% data variables.product.prodname_pages %}, in your *_config.yml* file. -Permalinks são URLs permanentes que fazem referência a uma determinada página no seu site. Os permalinks absolutos iniciam com a raiz do site, enquanto os permalinks relativos iniciam com a pasta que contém a página referenciada. O {% data variables.product.prodname_pages %} e o Jekyll não são mais compatíveis com permalinks relativos. Para obter mais informações sobre permalinks, consulte "[Permalinks](https://jekyllrb.com/docs/permalinks/)" na documentação do Jekyll. +Permalinks are permanent URLs that reference a particular page on your site. Absolute permalinks begin with the root of the site, while relative permalinks begin with the folder containing the referenced page. {% data variables.product.prodname_pages %} and Jekyll no longer support relative permalinks. For more information about permalinks, see "[Permalinks](https://jekyllrb.com/docs/permalinks/)" in the Jekyll documentation. -Para solucionar problemas, remova a linha `relative_permalinks` do arquivo *_config.yml* e reformate os permalinks relativos no site com permalinks absolutos. Para obter mais informações, consulte "[Editar arquivos no repositório](/articles/editing-files-in-your-repository)". +To troubleshoot, remove the `relative_permalinks` line from your *_config.yml* file and reformat any relative permalinks in your site with absolute permalinks. For more information, see "[Editing files in your repository](/articles/editing-files-in-your-repository)." -### O link simbólico não existe no repositório do site +### Symlink does not exist within your site's repository -Este erro significa que seu site inclui um link simbólico que não existe na fonte de publicação do site. Para obter mais informações sobre links simbólicos, consulte "[Link simbólico](https://en.wikipedia.org/wiki/Symbolic_link)" na Wikipédia. +This error means that your site includes a symbolic link (symlink) that does not exist in the publishing source for your site. For more information about symlinks, see "[Symbolic link](https://en.wikipedia.org/wiki/Symbolic_link)" on Wikipedia. -Para solucionar problemas, determine se o arquivo na mensagem de erro é usado para criar o site. Se ele não for ou se você não quiser que o arquivo seja um link simbólico, exclua o arquivo. Se o arquivo de link simbólico for necessário para criar seu site, verifique se o arquivo ou o diretório a que ele faz referência está na fonte de publicação do site. Para incluir ativos externos, considere usar {% if currentVersion == "free-pro-team@latest" %}`submódulo do Git` ou {% endif %}um gerenciador de pacotes terceirizado como o [Bower](https://bower.io/).{% if currentVersion == "free-pro-team@latest" %} Para obter mais informações, consulte "[Usar submódulos com o {% data variables.product.prodname_pages %}](/articles/using-submodules-with-github-pages)".{% endif %} +To troubleshoot, determine if the file in the error message is used to build your site. If not, or if you don't want the file to be a symlink, delete the file. If the symlinked file is necessary to build your site, make sure the file or directory the symlink references is in the publishing source for your site. To include external assets, consider using {% if currentVersion == "free-pro-team@latest" %}`git submodule` or {% endif %}a third-party package manager such as [Bower](https://bower.io/).{% if currentVersion == "free-pro-team@latest" %} For more information, see "[Using submodules with {% data variables.product.prodname_pages %}](/articles/using-submodules-with-github-pages)."{% endif %} -### Erro de sintaxe no loop 'for' +### Syntax error in 'for' loop -Este erro significa que o código inclui sintaxe inválida em uma declaração de loop `for` do Liquid. +This error means that your code includes invalid syntax in a Liquid `for` loop declaration. -Para solucionar problemas, verifique se todos os loops `for` no arquivo da mensagem de erro têm sintaxe adequada. Para obter mais informações sobre a sintaxe adequada para loops `for`, consulte "[Tags de Iteração](https://help.shopify.com/en/themes/liquid/tags/iteration-tags#for)" na documentação do Liquid. +To troubleshoot, make sure all `for` loops in the file in the error message have proper syntax. For more information about proper syntax for `for` loops, see "[Iteration tags](https://help.shopify.com/en/themes/liquid/tags/iteration-tags#for)" in the Liquid documentation. -### Tag fechada incorretamente +### Tag not properly closed -Esta mensagem de erro significa que o código inclui uma tag lógica que foi fechada incorretamente. Por exemplo, {% raw %}`{% capture example_variable %}` deve ser fechada por `{% endcapture %}`{% endraw %}. +This error message means that your code includes a logic tag that is not properly closed. For example, {% raw %}`{% capture example_variable %}` must be closed by `{% endcapture %}`{% endraw %}. -Para solucionar problemas, verifique se todas as tags lógicas no arquivo da mensagem de erro estão fechadas corretamente. Para obter mais informações, consulte "[Tags do Liquid](https://help.shopify.com/en/themes/liquid/tags)" na documentação do Liquid. +To troubleshoot, make sure all logic tags in the file in the error message are properly closed. For more information, see "[Liquid tags](https://help.shopify.com/en/themes/liquid/tags)" in the Liquid documentation. -### Tag terminada incorretamente +### Tag not properly terminated -Este erro significa que o código inclui uma tag de saída que não foi terminada corretamente. Por exemplo, {% raw %}`{{ page.title }` em vez de `{{ page.title }}`{% endraw %}. +This error means that your code includes an output tag that is not properly terminated. For example, {% raw %}`{{ page.title }` instead of `{{ page.title }}`{% endraw %}. -Para solucionar problemas, verifique se todas as tags de saída no arquivo da mensagem de erro estão terminadas com `}}`. Para obter mais informações, consulte "[Objetos do Liquid](https://help.shopify.com/en/themes/liquid/objects)" na documentação do Liquid. +To troubleshoot, make sure all output tags in the file in the error message are terminated with `}}`. For more information, see "[Liquid objects](https://help.shopify.com/en/themes/liquid/objects)" in the Liquid documentation. -### Erro de tag desconhecida +### Unknown tag error -Este erro significa que o código contém uma tag do Liquid não reconhecida. +This error means that your code contains an unrecognized Liquid tag. -Para solucionar problemas, verifique se todas as tags do Liquid no arquivo da mensagem de erro correspondem a variáveis padrão do Jekyll e se não há erros de digitação nos nomes das tags. Para obter uma lista de variáveis padrão, consulte "[Variáveis](https://jekyllrb.com/docs/variables/)" na documentação do Jekyll. +To troubleshoot, make sure all Liquid tags in the file in the error message match Jekyll's default variables and there are no typos in the tag names. For a list of default varibles, see "[Variables](https://jekyllrb.com/docs/variables/)" in the Jekyll documentation. -Plugins incompatíveis são uma fonte comum de tags não reconhecidas. Se você usar um plugin incompatível ao gerar seu site localmente e fazer push dos arquivos estáticos para o {% data variables.product.product_name %}, verifique se o plugin não está inserindo tags que não estão nas variáveis padrão do Jekyll. Para obter uma lista de plugins compatíveis, consulte "[Sobre o {% data variables.product.prodname_pages %} e o Jekyll](/articles/about-github-pages-and-jekyll#plugins)". +Unsupported plugins are a common source of unrecognized tags. If you use an unsupported plugin in your site by generating your site locally and pushing your static files to {% data variables.product.product_name %}, make sure the plugin is not introducing tags that are not in Jekyll's default variables. For a list of supported plugins, see "[About {% data variables.product.prodname_pages %} and Jekyll](/articles/about-github-pages-and-jekyll#plugins)." diff --git a/translations/pt-BR/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md b/translations/pt-BR/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md index 833acac26472..9e9ffcada5e2 100644 --- a/translations/pt-BR/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md +++ b/translations/pt-BR/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md @@ -1,6 +1,6 @@ --- title: Cancelar a publicação de um site do GitHub Pages -intro: 'Você pode cancelar a publicação do seu site do {% data variables.product.prodname_pages %} para que ele não esteja mais disponível para {% if currentVersion == "free-pro-team@latest" %}o público{% else %}qualquer pessoa que use o {% data variables.product.product_location %}{% endif %}.' +intro: 'Você pode cancelar a publicação do seu site de {% data variables.product.prodname_pages %} para que o site não esteja mais disponível para {% if currentVersion == "free-pro-team@latest" %}o público{% else %}qualquer pessoa que usa {% data variables.product.product_location %}{% endif %}.' redirect_from: - /articles/how-do-i-unpublish-a-project-page/ - /articles/unpublishing-a-project-page/ @@ -19,9 +19,11 @@ versions: {% data reusables.repositories.navigate-to-repo %} 2. Se existir um branch `gh-pages` no repositório, exclua o branch `gh-pages`. Para obter mais informações, consulte "[Criar e excluir branches em seu repositório](/articles/creating-and-deleting-branches-within-your-repository#deleting-a-branch)". 3. Se o branch `gh-pages` tiver sido sua fonte de publicação, -{% if currentVersion == "free-pro-team@latest" %}passe para a etapa 6{% else %}agora a publicação do seu site está cancelada e você pode passar para as etapas restantes{% endif %}. +{% if currentVersion == "free-pro-team@latest" %}pule para a etapa 6{% else %}o seu site agora não está publicado e você pode pular as outras etapas{% endif %}. {% data reusables.repositories.sidebar-settings %} -5. No "{% data variables.product.prodname_pages %}", use o menu suspenso **Source** (Fonte) e selecione **None** (Nenhuma). ![Menu suspenso para selecionar uma fonte de publicação](/assets/images/help/pages/publishing-source-drop-down.png) +5. Em " +{% data variables.product.prodname_pages %}", use o menu suspenso **Origem** e selecione **Nenhum.** + ![Menu suspenso para selecionar uma fonte de publicação](/assets/images/help/pages/publishing-source-drop-down.png) {% data reusables.pages.update_your_dns_settings %} ### Cancelar a publicação de um site de usuário ou organização diff --git a/translations/pt-BR/content/github/working-with-github-support/about-github-support.md b/translations/pt-BR/content/github/working-with-github-support/about-github-support.md index a25f86dc25c9..5fbbbd90c75e 100644 --- a/translations/pt-BR/content/github/working-with-github-support/about-github-support.md +++ b/translations/pt-BR/content/github/working-with-github-support/about-github-support.md @@ -11,13 +11,13 @@ versions: As opções de suporte variam dependendo do seu produto {% data variables.product.prodname_dotcom_the_website %}. Se você tiver qualquer produto pago, pode entrar em contato com {% data variables.contact.github_support %}, em inglês. Sua conta também pode incluir {% data variables.contact.premium_support %}. -| | {% data variables.product.prodname_gcf %} | Suporte Padrão | Suporte premium | -| ------------------------------------------------------ | ---------------------------------------------- | -------------- | --------------- | -| {% data variables.product.prodname_free_user %} | X | | | -| {% data variables.product.prodname_pro %} | X | X | | -| {% data variables.product.prodname_team %} | X | X | | -| {% data variables.product.prodname_ghe_cloud %} | X | X | X | -| {% data variables.product.prodname_ghe_server %} | X | X | X | +| | {% data variables.product.prodname_gcf %} | Suporte Padrão | Suporte premium | +| -------------------------------------------------- | ----------------------------------------- | -------------- | --------------- | +| {% data variables.product.prodname_free_user %} | X | | | +| {% data variables.product.prodname_pro %} | X | X | | +| {% data variables.product.prodname_team %} | X | X | | +| {% data variables.product.prodname_ghe_cloud %} | X | X | X | +| {% data variables.product.prodname_ghe_server %} | X | X | X | Para verificar se, atualmente, há algum incidente afetando os serviços no {% data variables.product.prodname_dotcom %} ou para se inscrever e receber notificações de atualizações de status futuras, visite a [página de status](https://www.githubstatus.com/) do {% data variables.product.prodname_dotcom %}. diff --git a/translations/pt-BR/content/github/writing-on-github/autolinked-references-and-urls.md b/translations/pt-BR/content/github/writing-on-github/autolinked-references-and-urls.md index b9e89ecb02c3..5c5aad618f40 100644 --- a/translations/pt-BR/content/github/writing-on-github/autolinked-references-and-urls.md +++ b/translations/pt-BR/content/github/writing-on-github/autolinked-references-and-urls.md @@ -45,15 +45,12 @@ As referências em um hash SHA de commit são convertidas automaticamente em lin | URL do commit | https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | | SHA | a5c3785ed8d6a35868bc169f07e40e889087fd2e | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | | User@SHA | jlord@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -| Username/Repository@SHA | User/Repository@SHA: jlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord/sheetsee.js@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | +| Username/Repository@SHA | jlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord/sheetsee.js@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} ### Links automáticos personalizados para recursos externos {% data reusables.repositories.autolink-references %} -{% endif %} - ### Leia mais - "[Sintaxe básica de gravação e formatação](/articles/basic-writing-and-formatting-syntax)" diff --git a/translations/pt-BR/content/github/writing-on-github/basic-writing-and-formatting-syntax.md b/translations/pt-BR/content/github/writing-on-github/basic-writing-and-formatting-syntax.md index ba68bdbaceba..3cf28bde8b4e 100644 --- a/translations/pt-BR/content/github/writing-on-github/basic-writing-and-formatting-syntax.md +++ b/translations/pt-BR/content/github/writing-on-github/basic-writing-and-formatting-syntax.md @@ -170,7 +170,7 @@ Para obter mais informações, consulte "[Sobre listas de tarefas](/articles/abo ### Mencionar pessoas e equipes -Você pode mencionar uma pessoa ou [equipe](/articles/setting-up-teams/) no {% data variables.product.product_name %} digitando `@` mais o nome de usuário ou nome da equipe. Isto desencadeará uma notificação e chamará a sua atenção para a conversa. As pessoas também receberão uma notificação se você editar um comentário para mencionar o respectivo nome de usuário ou da equipe. Para obter mais informações, sobre notificações, consulte {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[Sobre notificações](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}"[Sobre notificações](/github/receiving-notifications-about-activity-on-github/about-notifications)"{% endif %}." +Você pode mencionar uma pessoa ou [equipe](/articles/setting-up-teams/) no {% data variables.product.product_name %} digitando `@` mais o nome de usuário ou nome da equipe. Isto desencadeará uma notificação e chamará a sua atenção para a conversa. As pessoas também receberão uma notificação se você editar um comentário para mencionar o respectivo nome de usuário ou da equipe. Para obter mais informações sobre notificações, consulte {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 0" %}"[Sobre as notificações](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}"[Sobre as notificações](/github/receiving-notifications-about-activity-on-github/about-notifications){% endif %}". `@github/suporte O que você acha dessas atualizações?` @@ -188,20 +188,17 @@ Você pode trazer à tona uma lista de problemas e pull requests sugeridos no re Para obter mais informações, consulte "[Referências e URLs vinculados automaticamente](/articles/autolinked-references-and-urls)". -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} ### Fazer referência a recursos externos {% data reusables.repositories.autolink-references %} -{% endif %} - ### Anexos de conteúdo Alguns {% data variables.product.prodname_github_app %}s fornecem informações no {% data variables.product.product_name %} para URLs que são vinculados aos respectivos domínios registrados. O {% data variables.product.product_name %} renderiza as informações fornecidas pelo app sob o URL no texto ou comentário de um problema ou uma pull request. ![Anexo de conteúdo](/assets/images/help/writing/content-attachment.png) -Para ver anexos de conteúdo, você deve ter um {% data variables.product.prodname_github_app %} que use a API Content Attachments (anexos de conteúdo) instalada no repositório.{% if currentVersion == "free-pro-team@latest" %} Para obter mais informações, consulte "[Instalar um app em sua conta pessoal](/articles/installing-an-app-in-your-personal-account)" e "[Instalar um app em sua organização](/articles/installing-an-app-in-your-organization)".{% endif %} +Para ver os anexos de conteúdo, é necessário ter um {% data variables.product.prodname_github_app %} que use a API de anexos de conteúdo instalada no repositório.{% if currentVersion == "free-pro-team@latest" %} Para mais informações, consulte "[Instalar um aplicativo na sua conta pessoal](/articles/installing-an-app-in-your-personal-account)" e "[Instalar um aplicativo na sua organização](/articles/installing-an-app-in-your-organization).{% endif %} Os anexos de conteúdo não serão exibidos para URLs que fazem parte de um link markdown. diff --git a/translations/pt-BR/content/github/writing-on-github/creating-gists.md b/translations/pt-BR/content/github/writing-on-github/creating-gists.md index 01b67df46072..227740563169 100644 --- a/translations/pt-BR/content/github/writing-on-github/creating-gists.md +++ b/translations/pt-BR/content/github/writing-on-github/creating-gists.md @@ -17,7 +17,7 @@ Cada gist é um repositório Git, o que significa que ele pode ser bifurcado e c Os gists podem ser públicos ou secretos. Os gists públicos são mostrados no {% data variables.gists.discover_url %}, onde as pessoas podem navegar por novos gists à medida que eles são criados. Eles também são pesquisáveis, de modo que é possível usá-los se desejar que outras pessoas encontrem e vejam seu trabalho. {% data reusables.gist.cannot-convert-public-gists-to-secret %} -Os gists secretos não são mostrados no {% data variables.gists.discover_url %}{% if currentVersion != "free-pro-team@latest" %},{% endif %} e não são pesquisáveis. {% data reusables.gist.cannot-convert-public-gists-to-secret %} Os gists secretos não são privados. Se você enviar a URL de um gist secreto a uma amigo, ele poderá vê-la. No entanto, se alguém que você não conhece descobrir a URL, ele também poderá ver seu gist. Se precisar manter seu código longe de olhares curiosos, pode ser mais conveniente [criar um repositório privado](/articles/creating-a-new-repository). +Os gists de segredos não aparecem em {% data variables.gists.discover_url %}{% if currentVersion != "free-pro-team@latest" %},{% endif %} e não são pesquisáveis. {% data reusables.gist.cannot-convert-public-gists-to-secret %} Os gists secretos não são privados. Se você enviar a URL de um gist secreto a uma amigo, ele poderá vê-la. No entanto, se alguém que você não conhece descobrir a URL, ele também poderá ver seu gist. Se precisar manter seu código longe de olhares curiosos, pode ser mais conveniente [criar um repositório privado](/articles/creating-a-new-repository). {% if currentVersion != "free-pro-team@latest" %} @@ -27,13 +27,10 @@ Se o administrador do site tiver desabilitado o modo privado, você também pode {% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} - Você receberá uma notificação quando: - Você for o autor de um gist. - Alguém mencionar você em um gist. - Você assinar um gist, clicando em **Subscribe** (Assinar) no topo de qualquer gist. -{% endif %} Você pode fixar os gists no seu perfil para que outras pessoas possam vê-los facilmente. Para obter mais informações, consulte "[Fixar itens ao seu perfil](/articles/pinning-items-to-your-profile)". diff --git a/translations/pt-BR/content/graphql/guides/managing-enterprise-accounts.md b/translations/pt-BR/content/graphql/guides/managing-enterprise-accounts.md index ab0689a5d7bf..f04329b844d2 100644 --- a/translations/pt-BR/content/graphql/guides/managing-enterprise-accounts.md +++ b/translations/pt-BR/content/graphql/guides/managing-enterprise-accounts.md @@ -5,7 +5,7 @@ redirect_from: - /v4/guides/managing-enterprise-accounts versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- ### Sobre o gerenciamento de contas corporativas com o GraphQL @@ -23,7 +23,7 @@ Com a API de Log de Auditoria, você pode monitorar quando alguém: - Promove usuários a admininistradores. - Altera as permissões de um aplicativo GitHub. -A API de Log de Auditoria permite que você mantenha cópias dos seus dados do log de auditoria. Para consultas feitas com a API do Log de Auditoria, a resposta do GraphQL pode incluir dados de 90 a 120 dias. Para obter uma lista dos campos disponíveis na API do Log de Auditoria, consulte a "[interface AuditEntry](/v4/interface/auditentry/)". +A API de Log de Auditoria permite que você mantenha cópias dos seus dados do log de auditoria. Para consultas feitas com a API do Log de Auditoria, a resposta do GraphQL pode incluir dados de 90 a 120 dias. Para obter uma lista dos campos disponíveis na API do Log de Auditoria, consulte a "[interface AuditEntry](/graphql/reference/interfaces#auditentry/)". Com a API de Contas corporativas, você pode: - Listar e revisar todas as organizações e repositórios que pertencem à conta corporativa. diff --git a/translations/pt-BR/content/index.md b/translations/pt-BR/content/index.md index 7ad8da6f19a6..97d640e20cba 100644 --- a/translations/pt-BR/content/index.md +++ b/translations/pt-BR/content/index.md @@ -1,5 +1,5 @@ --- -title: 'Documentação de Ajuda do {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %}.com{% endif %}' +title: '{% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %}.com{% endif %} Documentação de ajuda' gettingStartedLinks: - /github/getting-started-with-github/set-up-git - /github/authenticating-to-github/connecting-to-github-with-ssh @@ -11,8 +11,6 @@ popularLinks: - /github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line - /github/using-git/managing-remote-repositories - /github/working-with-github-pages -versions: - free-pro-team: '*' - enterprise-server: '*' +versions: '*' --- diff --git a/translations/pt-BR/content/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights.md b/translations/pt-BR/content/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights.md index c20f393ee815..1a55c22715e9 100644 --- a/translations/pt-BR/content/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights.md +++ b/translations/pt-BR/content/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights.md @@ -4,7 +4,7 @@ intro: '' product: '{% data reusables.gated-features.github-insights %}' permissions: 'Qualquer pessoa com acesso ao {% data variables.product.prodname_insights %} pode navegar entre {% data variables.product.prodname_enterprise %} e {% data variables.product.prodname_insights %}.' versions: - enterprise-server: '>=2.19' + enterprise-server: '*' --- Antes de poder navegar entre {% data variables.product.prodname_enterprise %} e {% data variables.product.prodname_insights %}, um administrador do site deve habilitar o link entre {% data variables.product.prodname_insights %} e {% data variables.product.prodname_enterprise %}. Para obter mais informações, consulte "[Habilitar um link entre {% data variables.product.prodname_insights %} e {% data variables.product.prodname_enterprise %}](/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise)". diff --git a/translations/pt-BR/content/insights/installing-and-configuring-github-insights/about-github-insights.md b/translations/pt-BR/content/insights/installing-and-configuring-github-insights/about-github-insights.md index 1062fcd89191..0deea7498bfb 100644 --- a/translations/pt-BR/content/insights/installing-and-configuring-github-insights/about-github-insights.md +++ b/translations/pt-BR/content/insights/installing-and-configuring-github-insights/about-github-insights.md @@ -20,7 +20,7 @@ Pessoas com permissões de administrador para {% data variables.product.prodname ### Entrar em contato com o suporte -Você pode receber suporte para {% data variables.product.prodname_insights %} de {% data variables.contact.github_support %}. Para obter mais informações, consulte {% if currentVersion == "free-pro-team@latest" %}"[Enviar um tíquete](/github/working-with-github-support/submitting-a-ticket)."{% else %}"[Entrando em contato com {% data variables.contact.github_support %}](/enterprise/{{ currentVersion }}/admin/enterprise-support/reaching-github-support)."{% endif %} +Você pode receber suporte para {% data variables.product.prodname_insights %} de {% data variables.contact.github_support %}. Para obter mais informações, consulte {% if currentVersion == "free-pro-team@latest" %}"[Enviar um tíquete](/github/working-with-github-support/submitting-a-ticket)."{% else %}"[Atingir {% data variables.contact.github_support %}](/enterprise/{{ currentVersion }}/admin/enterprise-support/reaching-github-support)".{% endif %} ### Leia mais diff --git a/translations/pt-BR/content/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise.md b/translations/pt-BR/content/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise.md index bc841357b732..acd79d26b022 100644 --- a/translations/pt-BR/content/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise.md +++ b/translations/pt-BR/content/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise.md @@ -7,7 +7,7 @@ redirect_from: - /github/installing-and-configuring-github-insights/navigating-between-github-insights-and-github-enterprise - /github/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise versions: - enterprise-server: '>=2.19' + enterprise-server: '*' --- Após habilitar o link, cada usuário poderá navegar diretamente de {% data variables.product.prodname_ghe_server %} para {% data variables.product.prodname_insights %}. Para obter mais informações, consulte "[Navegando entre {% data variables.product.prodname_enterprise %} e {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights)". @@ -17,7 +17,8 @@ Após habilitar o link, cada usuário poderá navegar diretamente de {% data var ``` ghe-config 'app.github.insights-available' 'true' && ghe-config-apply ``` -3. Volte para o {% data variables.product.prodname_ghe_server %}. +3. Retornar para +{% data variables.product.prodname_ghe_server %}. {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.settings-tab %} diff --git a/translations/pt-BR/content/insights/installing-and-configuring-github-insights/installing-github-insights.md b/translations/pt-BR/content/insights/installing-and-configuring-github-insights/installing-github-insights.md index aff8b5342622..2578298d27b6 100644 --- a/translations/pt-BR/content/insights/installing-and-configuring-github-insights/installing-github-insights.md +++ b/translations/pt-BR/content/insights/installing-and-configuring-github-insights/installing-github-insights.md @@ -28,7 +28,8 @@ versions: Para conectar {% data variables.product.prodname_insights %} a {% data variables.product.prodname_enterprise %}, você deve criar um {% data variables.product.prodname_github_app %} em uma organização no {% data variables.product.prodname_enterprise %}. Uma versão com slug do nome do seu aplicativo será exibida no {% data variables.product.prodname_enterprise %} quando sua integração executar uma ação. {% data reusables.enterprise_site_admin_settings.sign-in %} -2. Navegue até a organização que você gostaria de conectar ao {% data variables.product.prodname_insights %}. +2. Acesse a organização à qual você deseja conectar-se +{% data variables.product.prodname_insights %}. {% data reusables.organizations.org_settings %} {% data reusables.organizations.github-apps-settings-sidebar %} 5. Clique em **Novo {% data variables.product.prodname_github_app %}**. ![Botão novo aplicativo do GitHub](/assets/images/help/apps/github_apps_new.png) diff --git a/translations/pt-BR/content/insights/installing-and-configuring-github-insights/managing-permissions-in-github-insights.md b/translations/pt-BR/content/insights/installing-and-configuring-github-insights/managing-permissions-in-github-insights.md index b40d40dc6446..28ef6d8613bd 100644 --- a/translations/pt-BR/content/insights/installing-and-configuring-github-insights/managing-permissions-in-github-insights.md +++ b/translations/pt-BR/content/insights/installing-and-configuring-github-insights/managing-permissions-in-github-insights.md @@ -9,6 +9,6 @@ versions: {% data reusables.github-insights.permissions-levels %} -Se você desejar conceder permissões de administrador a alguém que não é administrador do site no {% data variables.product.prodname_enterprise %}, entre em contato com {% data variables.contact.github_support %}. Para obter mais informações, consulte {% if currentVersion == "free-pro-team@latest" %}"[Enviar um tíquete](/github/working-with-github-support/submitting-a-ticket)."{% else %}"[Entrando em contato com {% data variables.contact.github_support %}](/enterprise/{{ currentVersion }}/admin/enterprise-support/reaching-github-support)."{% endif %} +Se você desejar conceder permissões de administrador a alguém que não é administrador do site no {% data variables.product.prodname_enterprise %}, entre em contato com {% data variables.contact.github_support %}. Para obter mais informações, consulte {% if currentVersion == "free-pro-team@latest" %}"[Enviar um tíquete](/github/working-with-github-support/submitting-a-ticket)."{% else %}"[Atingir {% data variables.contact.github_support %}](/enterprise/{{ currentVersion }}/admin/enterprise-support/reaching-github-support)".{% endif %} Para remover o acesso de um usuário de {% data variables.product.prodname_insights %}, você deve remover o usuário de {% data variables.product.prodname_enterprise %}. diff --git a/translations/pt-BR/content/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images.md b/translations/pt-BR/content/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images.md index b008ff5be280..9e1d50fdc565 100644 --- a/translations/pt-BR/content/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images.md +++ b/translations/pt-BR/content/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images.md @@ -24,8 +24,8 @@ Para obter mais informações, consulte "[Sobre {% data variables.product.prodna O domínio para o {% data variables.product.prodname_container_registry %} é `ghcr.io`. -| Registro | Exemplo de URL | -| ---------------------------------------------------------------------- | --------------------------------------------------- | +| Registro | Exemplo de URL | +| ----------------------------------------------------------------- | --------------------------------------------------- | | Registro Docker de {% data variables.product.prodname_registry %} | `docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME` | | {% data variables.product.prodname_github_container_registry %} | `ghcr.io/OWNER/IMAGE_NAME` | @@ -33,7 +33,9 @@ O domínio para o {% data variables.product.prodname_container_registry %} é `g Você deverá efetuar a autenticação no {% data variables.product.prodname_container_registry %} com a URL de base `ghcr.io`. Recomendamos criar um novo token de acesso para usar o {% data variables.product.prodname_container_registry %}. -{% data reusables.package_registry.authenticate-to-container-registry %} +{% data reusables.package_registry.authenticate_with_pat_for_container_registry %} + +{% data reusables.package_registry.authenticate-to-container-registry-steps %} ### Fazer a migração de uma imagem do Docker usando a CLI do Docker @@ -55,7 +57,9 @@ Para mover imagens do Docker que você hospeda no registro do Docker do {% data $ docker tag docker.pkg.github.com/SOURCE_OWNER/SOURCE_REPOSITORY/SOURCE_IMAGE_NAME:VERSION ghcr.io/TARGET_OWNER/TARGET_IMAGE_NAME:VERSION ``` -4. Faça login no novo {% data variables.product.prodname_container_registry %}. Recomendamos criar um novo PAT limitado aos escopos `read:packages` e `write: packages` já que você não precisa mais do escopo `repositório` e seu PAT anterior pode não ter o escopo `write:packages`. +4. Fazer login no novo + +{% data variables.product.prodname_container_registry %}. Recomendamos criar um novo PAT limitado aos escopos `read:packages` e `write: packages` já que você não precisa mais do escopo `repositório` e seu PAT anterior pode não ter o escopo `write:packages`. {% raw %} ```shell $ echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin diff --git a/translations/pt-BR/content/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image.md b/translations/pt-BR/content/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image.md index dd799a26f830..b8097bdfb075 100644 --- a/translations/pt-BR/content/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image.md +++ b/translations/pt-BR/content/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image.md @@ -62,7 +62,9 @@ https://github.com/monalisa/hello_docker $ docker tag 38f737a91f39 ghcr.io/monalisa/hello_docker:latest ``` -5. Se você ainda não o fez, efetue a autenticação no {% data variables.product.prodname_github_container_registry %}. Para obter mais informações, consulte "[Efetuar a autenticação no GitHub Container Registry](/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images#authenticating-to-github-container-registry)". +5. Se você ainda não o fez, efetue a autenticação em + +{% data variables.product.prodname_github_container_registry %}. Para obter mais informações, consulte "[Efetuar a autenticação no GitHub Container Registry](/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images#authenticating-to-github-container-registry)". {% raw %} ```shell $ echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin diff --git a/translations/pt-BR/content/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images.md b/translations/pt-BR/content/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images.md index 90c922de4b84..50e25039f030 100644 --- a/translations/pt-BR/content/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images.md +++ b/translations/pt-BR/content/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images.md @@ -12,13 +12,15 @@ Para fazer push e pull das imagens de contêiner pertencentes a uma organizaçã ### Autenticar-se no {% data variables.product.prodname_github_container_registry %} -{% data reusables.package_registry.authenticate-to-container-registry %} +{% data reusables.package_registry.authenticate_with_pat_for_container_registry %} + +{% data reusables.package_registry.authenticate-to-container-registry-steps %} ### Fazer push das imagens do contêiner Este exemplo faz push da versão mais recente de `IMAGE-NAME`. ```shell - $ docker push ghcr.io/OWNER/IMAGE_NAME.latest + $ docker push ghcr.io/OWNER/IMAGE_NAME:latest ``` Este exemplo faz push da versão `2.5` da imagem. @@ -40,7 +42,7 @@ Para garantir que você esteja sempre usando a mesma imagem, você pode especifi ``` 2. Remova a imagem localmente, conforme necessário. ```shell - $ docker rmi ghcr.io/OWNER/IMAGE_NAME.latest + $ docker rmi ghcr.io/OWNER/IMAGE_NAME:latest ``` 3. Faça pull da imagem do contêiner com `@YOUR_SHA_VALUE` após o nome da imagem. diff --git a/translations/pt-BR/content/packages/publishing-and-managing-packages/about-github-packages.md b/translations/pt-BR/content/packages/publishing-and-managing-packages/about-github-packages.md index 42c8e7a998aa..58223a88b763 100644 --- a/translations/pt-BR/content/packages/publishing-and-managing-packages/about-github-packages.md +++ b/translations/pt-BR/content/packages/publishing-and-managing-packages/about-github-packages.md @@ -34,18 +34,18 @@ You can configure webhooks to subscribe to package-related events, such as when #### Sobre permissões e visibilidade de pacotes {% if currentVersion == "free-pro-team@latest" %} -| | Registros de pacotes | {% data variables.product.prodname_github_container_registry %} | +| | Registros de pacotes | {% data variables.product.prodname_github_container_registry %} | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Locais de hospedagem | Você pode hospedar vários pacotes em um só repositório. | Você pode hospedar várias imagens de contêiner em uma organização ou conta de usuário. | -| Permissões | {% data reusables.package_registry.public-or-private-packages %} You can use {% data variables.product.prodname_dotcom %} roles and teams to limit who can install or publish each package, as packages inherit the permissions of the repository. Anyone with read permissions for a repository can install a package as a dependency in a project, and anyone with write permissions can publish a new package version. | Para cada imagem de container, você pode escolher o nível de acesso que os outros têm. As permissões para acesso a imagens do contêiner são separadas da sua organização e das permissões do repositório. | +| Permissões | {{ site.data.reusables.package_registry.public-or-private-packages }} You can use {{ site.data.variables.product.prodname_dotcom }} roles and teams to limit who can install or publish each package, as packages inherit the permissions of the repository. Anyone with read permissions for a repository can install a package as a dependency in a project, and anyone with write permissions can publish a new package version. | Para cada imagem de container, você pode escolher o nível de acesso que os outros têm. As permissões para acesso a imagens do contêiner são separadas da sua organização e das permissões do repositório. | Visibilidade | {% data reusables.package_registry.public-or-private-packages %} | Você pode definir a visibilidade de cada uma de suas imagens de contêiner. Uma imagem privada de contêiner só é visível para pessoas e equipes às quais é fornecido acesso na sua organização. Qualquer pessoa pode ver uma imagem pública de contêiner. | acesso anônimo | N/A | Você pode acessar imagens de contêineres públicas anonimamente. {% else %} | | Registros de pacotes | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Locais de hospedagem | Você pode hospedar vários pacotes em um só repositório. | -| Permissões | {% data reusables.package_registry.public-or-private-packages %} You can use {% data variables.product.prodname_dotcom %} roles and teams to limit who can install or publish each package, as packages inherit the permissions of the repository. Anyone with read permissions for a repository can install a package as a dependency in a project, and anyone with write permissions can publish a new package version. | -| Visibilidade | {% data reusables.package_registry.public-or-private-packages %} | +| Permissões | {{ site.data.reusables.package_registry.public-or-private-packages }} You can use {{ site.data.variables.product.prodname_dotcom }} roles and teams to limit who can install or publish each package, as packages inherit the permissions of the repository. Anyone with read permissions for a repository can install a package as a dependency in a project, and anyone with write permissions can publish a new package version. | +| Visibilidade | {% data reusables.package_registry.public-or-private-packages %} {% endif %} @@ -60,8 +60,7 @@ Para obter mais informações sobre permissões e visibilidade para {% data vari {% data reusables.package_registry.packages-billing %} Para obter mais informações, consulte "[Sobre a cobrança do {% data variables.product.prodname_registry %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)". - -{{ site.data.reusables/package_registry/container-registry-beta-billing-note }} +{% data reusables.package_registry.container-registry-beta-billing-note %} {% endif %} ### Clientes e formatos compatíveis @@ -76,8 +75,9 @@ O {% data variables.product.prodname_github_container_registry %} hospeda contê | Cliente do pacote | Linguagem | Formato do pacote | Descrição | | ----------------- | --------- | ----------------- | ----------------------------------------------- | | arquivo Docker | N/A | `arquivo Docker` | Plataforma de gerenciamento de contêiner Docker | +Para mais informações sobre o suporte do contêiner oferecido por -Para obter mais informações sobre o suporte ao contêiner oferecido por {% data variables.product.prodname_github_container_registry %}, consulte "[Sobre {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry)". +{% data variables.product.prodname_github_container_registry %}, consulte "[Sobre {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry). {% endif %} #### Suporte para registros de pacotes @@ -144,10 +144,10 @@ Para obter mais informações sobre como configurar o seu cliente de pacote para {% if currentVersion == "free-pro-team@latest" %} ### About tokens -| Escopo | Descrição | -| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `read:packages` | Faça o download e instale as imagens de contêiner de {% data variables.product.prodname_github_container_registry %} | -| `write:packages` | Faça o upload e publique as imagens do contêiner para {% data variables.product.prodname_github_container_registry %} | +| Escopo | Descrição | +| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `read:packages` | Faça o download e instale as imagens de contêiner de {% data variables.product.prodname_github_container_registry %} +| `write:packages` | Faça o upload e publique as imagens do contêiner para {% data variables.product.prodname_github_container_registry %} | `delete:packages` | Exclua versões especificadas de imagens privadas ou públicas de contêiner do {% data variables.product.prodname_github_container_registry %}. Para obter mais informações, consulte "[Excluir uma imagem de contêiner](/packages/managing-container-images-with-github-container-registry/deleting-a-container-image)". | Para aprender sobre escopos e permissões disponíveis para imagens de contêiner, ver "[Sobre {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry)" ou "[Configurar controle de acesso e visibilidade para imagens de contêiner](/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images)". @@ -166,9 +166,9 @@ Por exemplo: | Escopo | Descrição | Permissões do repositório | | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- | -| `read:packages` | Faça o download e instale pacotes do {% data variables.product.prodname_registry %} | leitura | -| `write:packages` | Faça o upload e publique os pacotes em {% data variables.product.prodname_registry %} | gravação | -| `delete:packages` | Excluir versões especificadas de pacotes privados de {% data variables.product.prodname_registry %} | administrador | +| `read:packages` | Faça o download e instale pacotes do {% data variables.product.prodname_registry %} | leitura | +| `write:packages` | Faça o upload e publique os pacotes em {% data variables.product.prodname_registry %} | gravação | +| `delete:packages` | Excluir versões especificadas de pacotes privados de {% data variables.product.prodname_registry %} | administrador | | `repo` | Instalar, fazer upload e excluir certos pacotes em repositórios privados (junto com `read:packages`, `write:packages`, ou `delete:packages`) | leitura, gravação ou administrador | Ao criar um fluxo de trabalho de {% data variables.product.prodname_actions %}, você pode usar o `GITHUB_TOKEN` para publicar e instalar pacotes no {% data variables.product.prodname_registry %} sem precisar armazenar e gerenciar um token de acesso pessoal. @@ -180,14 +180,15 @@ Para obter mais informações, consulte: ### Gerenciar pacotes -Você pode excluir uma versão de um pacote privado no {% data variables.product.product_name %} ou usar a API do GraphQL. Ao usar a API do GraphQL para consultar e excluir pacotes privados, você deve usar o mesmo token que você usa para efetuar a autenticação no {% data variables.product.prodname_registry %}. Para obter mais informações, consulte "[Excluir um pacote](/packages/publishing-and-managing-packages/deleting-a-package)" e "[Formando chamadas com GraphQL](/v4/guides/forming-calls/)". +Você pode excluir uma versão de um pacote privado em {% data variables.product.product_name %} ou usar a API do GraphQL. Ao usar a API do GraphQL para consultar e excluir pacotes privados, você deve usar o mesmo token que você usa para efetuar a autenticação no {% data variables.product.prodname_registry %}. Para obter mais informações, consulte "[Excluir um pacote](/packages/publishing-and-managing-packages/deleting-a-package)" e "[Formando chamadas com GraphQL](/v4/guides/forming-calls/)". Você pode configurar webhooks para assinar eventos relacionados aos pacotes, como quando um pacote é publicado ou atualizado. Para obter mais informações, consulte o evento de webhook de "[`pacote`](/webhooks/event-payloads/#package)". ### Entrar em contato com o suporte {% if currentVersion == "free-pro-team@latest" %} -Se você tiver comentários ou solicitações de recursos para {% data variables.product.prodname_registry %}, use o [formulário de feedback para {% data variables.product.prodname_registry %}](https://support.github.com/contact/feedback?contact%5Bcategory%5D=github-packages). +Se você tiver feedback ou pedidos de recursos para +{% data variables.product.prodname_registry %}, use o [formulário de feedback para {% data variables.product.prodname_registry %}](https://support.github.com/contact/feedback?contact%5Bcategory%5D=github-packages). Entre em contato com {% data variables.contact.github_support %} sobre {% data variables.product.prodname_registry %} usando o [nosso formulário de contato](https://support.github.com/contact?form%5Bsubject%5D=Re:%20GitHub%20Packages) se: @@ -196,6 +197,7 @@ Entre em contato com {% data variables.contact.github_support %} sobre {% data v * Seu pacote publicado contém dados confidenciais, como violações do RGPD, chaves API ou informações de identificação pessoal {% else %} -Se você precisar de suporte para {% data variables.product.prodname_registry %}, entre em contato com os administradores do seu site. +Se precisar de suporte para +{% data variables.product.prodname_registry %}, entre em contato com os administradores do site. {% endif %} diff --git a/translations/pt-BR/content/packages/publishing-and-managing-packages/deleting-a-package.md b/translations/pt-BR/content/packages/publishing-and-managing-packages/deleting-a-package.md index 828c230aee3b..68b3b3db5d9e 100644 --- a/translations/pt-BR/content/packages/publishing-and-managing-packages/deleting-a-package.md +++ b/translations/pt-BR/content/packages/publishing-and-managing-packages/deleting-a-package.md @@ -11,7 +11,6 @@ versions: {% data reusables.package_registry.packages-ghes-release-stage %} - {% if currentVersion == "free-pro-team@latest" %} ### Sobre a exclusão de imagem de contêiner diff --git a/translations/pt-BR/content/packages/publishing-and-managing-packages/installing-a-package.md b/translations/pt-BR/content/packages/publishing-and-managing-packages/installing-a-package.md index 6fae1b919bc2..cce1eeea5086 100644 --- a/translations/pt-BR/content/packages/publishing-and-managing-packages/installing-a-package.md +++ b/translations/pt-BR/content/packages/publishing-and-managing-packages/installing-a-package.md @@ -20,7 +20,7 @@ Depois de encontrar um pacote, você pode ler a descrição e as instruções de ### Instalar um pacote -You can install a package from {% data variables.product.prodname_registry %} using any supported package client by following the same general guidelines. +Você pode instalar um pacote de {% data variables.product.prodname_registry %} usando qualquer {% if currentVersion == "free-pro-team@latest" %}tipo de pacote cliente compatível{% else %}pacote habilitado para sua instância{% endif %}, seguindo as mesmas diretrizes gerais. 1. Efetue a autenticação com {% data variables.product.prodname_registry %} usando as instruções para seu cliente de pacote. Para obter mais informações, consulte "[Sobre tokens](/packages/publishing-and-managing-packages/about-github-packages#authenticating-to-github-packages)". 2. Instale o pacote usando as instruções para seu cliente de pacote. diff --git a/translations/pt-BR/content/packages/publishing-and-managing-packages/publishing-a-package.md b/translations/pt-BR/content/packages/publishing-and-managing-packages/publishing-a-package.md index 33bb7b7600c3..801b9d81bfbb 100644 --- a/translations/pt-BR/content/packages/publishing-and-managing-packages/publishing-a-package.md +++ b/translations/pt-BR/content/packages/publishing-and-managing-packages/publishing-a-package.md @@ -21,12 +21,13 @@ Você pode ajudar as pessoas a entender e usar seu pacote fornecendo uma descri {% data reusables.package_registry.package-immutability %} {% if currentVersion == "free-pro-team@latest" %} -Se uma nova versão de um pacote corrigir uma vulnerabilidade de segurança, você deverá publicar uma consultoria de segurança no seu repositório. {% data variables.product.prodname_dotcom %} revisa cada consultoria de segurança publicada e pode usá-la para enviar alertas de {% data variables.product.prodname_dependabot_short %} para repositórios afetados. Para obter mais informações, consulte "[Sobre as consultorias de segurança do GitHub](/github/managing-security-vulnerabilities/about-github-security-advisories)." +Se uma nova versão de um pacote corrigir uma vulnerabilidade de segurança, você deverá publicar uma consultoria de segurança no seu repositório. +{% data variables.product.prodname_dotcom %} revisa cada consultoria de segurança publicada e pode usá-la para enviar alertas de {% data variables.product.prodname_dependabot_short %} para repositórios afetados. Para obter mais informações, consulte "[Sobre as consultorias de segurança do GitHub](/github/managing-security-vulnerabilities/about-github-security-advisories)." {% endif %} ### Publicar um pacote -You can publish a package to {% data variables.product.prodname_registry %} using any supported package client by following the same general guidelines. +Você pode publicar um pacote em {% data variables.product.prodname_registry %} usando qualquer {% if currentVersion == "free-pro-team@latest" %}cliente do pacote compatível{% else %}pacote habilitado para sua instância{% endif %}, seguindo as mesmas diretrizes gerais. 1. Crie ou use um token de acesso existente com os escopos apropriados para a tarefa que você deseja realizar. Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_registry %}](/packages/publishing-and-managing-packages/about-github-packages#authenticating-to-github-packages)." 2. Efetue a autenticação em {% data variables.product.prodname_registry %} usando seu token de acesso e as instruções para seu cliente do pacote. diff --git a/translations/pt-BR/content/packages/publishing-and-managing-packages/viewing-packages.md b/translations/pt-BR/content/packages/publishing-and-managing-packages/viewing-packages.md index 1b014a27fff6..ea3dab214232 100644 --- a/translations/pt-BR/content/packages/publishing-and-managing-packages/viewing-packages.md +++ b/translations/pt-BR/content/packages/publishing-and-managing-packages/viewing-packages.md @@ -1,6 +1,6 @@ --- title: Visualizar pacotes -intro: É possível ver informações sobre pacotes publicados em um repositório e limitar os resultados por organização ou usuário. +intro: 'É possível ver informações sobre pacotes publicados em um repositório e limitar os resultados por organização ou usuário.' product: '{% data reusables.gated-features.packages %}' redirect_from: - /articles/viewing-a-repositorys-packages diff --git a/translations/pt-BR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-apache-maven-for-use-with-github-packages.md b/translations/pt-BR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-apache-maven-for-use-with-github-packages.md index 6e64d05f0ced..13b5a865bcc4 100644 --- a/translations/pt-BR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-apache-maven-for-use-with-github-packages.md +++ b/translations/pt-BR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-apache-maven-for-use-with-github-packages.md @@ -1,6 +1,6 @@ --- -title: Configurar o Apache Maven para uso com o GitHub Packages -intro: 'Você pode configurar o Apache Maven para publicar pacotes no {% data variables.product.prodname_registry %} e usar pacotes armazenados no {% data variables.product.prodname_registry %} como dependências em um projeto Java.' +title: Configuring Apache Maven for use with GitHub Packages +intro: 'You can configure Apache Maven to publish packages to {% data variables.product.prodname_registry %} and to use packages stored on {% data variables.product.prodname_registry %} as dependencies in a Java project.' product: '{% data reusables.gated-features.packages %}' redirect_from: - /articles/configuring-apache-maven-for-use-with-github-package-registry @@ -13,28 +13,28 @@ versions: {% data reusables.package_registry.packages-ghes-release-stage %} -**Note:** When installing or publishing a docker image, {% data variables.product.prodname_registry %} does not currently support foreign layers, such as Windows images. +{% data reusables.package_registry.admins-can-configure-package-types %} -### Autenticar-se no {% data variables.product.prodname_registry %} +### Authenticating to {% data variables.product.prodname_registry %} {% data reusables.package_registry.authenticate-packages %} -#### Efetuando a autenticação com um token de acesso pessoal +#### Authenticating with a personal access token {% data reusables.package_registry.required-scopes %} -Você pode efetuar a autenticação no {% data variables.product.prodname_registry %} com o Apache Maven editando seu arquivo *~/.m2/settings.xml* para incluir seu token de acesso pessoal. Criar um novo arquivo *~/.m2/settings.xml*, caso não exista um. +You can authenticate to {% data variables.product.prodname_registry %} with Apache Maven by editing your *~/.m2/settings.xml* file to include your personal access token. Create a new *~/.m2/settings.xml* file if one doesn't exist. -Na etiqueta `servidores`, adicione uma etiqueta `servidor` secundário com um `Id`, substituindo *USERNAME* pelo o seu nome de usuário {% data variables.product.prodname_dotcom %} e *Token* pelo seu token de acesso pessoal. +In the `servers` tag, add a child `server` tag with an `id`, replacing *USERNAME* with your {% data variables.product.prodname_dotcom %} username, and *TOKEN* with your personal access token. -Na etiqueta `repositórios`, configure um repositório mapeando o `id` do repositório com o `id` que você adicionou na etiqueta `servidor` que contém as suas credenciais. In the `repositories` tag, configure a repository by mapping the `id` of the repository to the `id` you added in the `server` tag containing your credentials. {% data reusables.package_registry.lowercase-name-field %} +In the `repositories` tag, configure a repository by mapping the `id` of the repository to the `id` you added in the `server` tag containing your credentials. Replace {% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance, {% endif %}*REPOSITORY* with the name of the repository you'd like to publish a package to or install a package from, and *OWNER* with the name of the user or organization account that owns the repository. {% data reusables.package_registry.lowercase-name-field %} -Se desejar interagir com vários repositórios, você poderá adicionar cada repositório para separar os `repositório` secundários na etiqueta `repositórios`, mapeando o `ID` de cada um com as credenciais na etiqueta `servidores`. +If you want to interact with multiple repositories, you can add each repository to separate `repository` children in the `repositories` tag, mapping the `id` of each to the credentials in the `servers` tag. {% data reusables.package_registry.apache-maven-snapshot-versions-supported %} {% if currentVersion != "free-pro-team@latest" %} -Se sua instância tem o isolamento de subdomínio habilitado: +If your instance has subdomain isolation enabled: {% endif %} ``` @@ -60,7 +60,7 @@ Se sua instância tem o isolamento de subdomínio habilitado: github GitHub OWNER Apache Maven Packages - https://maven.pkg.github.com/OWNER/REPOSITORY + https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}maven.HOSTNAME{% endif %}/OWNER/REPOSITORY @@ -77,7 +77,7 @@ Se sua instância tem o isolamento de subdomínio habilitado: ``` {% if currentVersion != "free-pro-team@latest" %} -Se sua instância tem o isolamento de subdomínio desabilitado: +If your instance has subdomain isolation disabled: ``` ` elemento do arquivo *pom.xml*. O {% data variables.product.prodname_dotcom %} fará a correspondência do repositório com base nesse campo. Como o nome do repositório também faz parte do elemento `distributionManagement`, não há etapas adicionais para publicar vários pacotes no mesmo repositório. +If you would like to publish multiple packages to the same repository, you can include the URL of the repository in the `` element of the *pom.xml* file. {% data variables.product.prodname_dotcom %} will match the repository based on that field. Since the repository name is also part of the `distributionManagement` element, there are no additional steps to publish multiple packages to the same repository. -Para obter mais informações sobre como criar um pacote, consulte a [documentação maven.apache.org](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html). +For more information on creating a package, see the [maven.apache.org documentation](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html). -1. Edit the `distributionManagement` element of the *pom.xml* file located in your package directory, replacing `OWNER` with the name of the user or organization account that owns the repository and `REPOSITORY` with the name of the repository containing your project. - -{% if currentVersion != "free-pro-team@latest" %}*NOME DE HOST* com o nome de host da sua instância de {% data variables.product.prodname_ghe_server %} {% endif %}`PROPRIETÁRIO` com o nome do usuário ou conta da organização proprietária do repositório e `REPOSITÓRIO` com o nome do repositório que contém o seu projeto. +1. Edit the `distributionManagement` element of the *pom.xml* file located in your package directory, replacing {% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance, {% endif %}`OWNER` with the name of the user or organization account that owns the repository and `REPOSITORY` with the name of the repository containing your project. {% if currentVersion != "free-pro-team@latest" %} - Se sua instância tem o isolamento de subdomínio habilitado: + If your instance has subdomain isolation enabled: {% endif %} ``` github GitHub OWNER Apache Maven Packages - https://maven.pkg.github.com/OWNER/REPOSITORY + https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}maven.HOSTNAME{% endif %}/OWNER/REPOSITORY ``` {% if currentVersion != "free-pro-team@latest" %} - Se sua instância tem o isolamento de subdomínio desabilitado: + If your instance has subdomain isolation disabled: ``` @@ -158,7 +156,7 @@ Para obter mais informações sobre como criar um pacote, consulte a [documenta ``` {% endif %} -2. Publique o pacote. +2. Publish the package. ```shell $ mvn deploy @@ -166,12 +164,12 @@ Para obter mais informações sobre como criar um pacote, consulte a [documenta {% data reusables.package_registry.viewing-packages %} -### Instalar um pacote +### Installing a package -Para instalar um pacote de Apache Maven a partir do {% data variables.product.prodname_registry %}, edite o arquivo *pom.xml* para incluir o pacote como uma dependência. Se você desejar instalar pacotes de mais de um repositório, adicione uma etiqueta de `repositório` para cada um. Para obter mais informações sobre como usar o arquivo *pom.xml* no seu projeto, consulte "[Introdução a POM](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html)" na documentação do Apache Maven. +To install an Apache Maven package from {% data variables.product.prodname_registry %}, edit the *pom.xml* file to include the package as a dependency. If you want to install packages from more than one repository, add a `repository` tag for each. For more information on using a *pom.xml* file in your project, see "[Introduction to the POM](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html)" in the Apache Maven documentation. {% data reusables.package_registry.authenticate-step %} -2. Adicione as dependências do pacote ao elemento `dependências` do arquivo *pom.xml* do seu projeto, substituindo `com.exemplo:test` pelo seu pacote. +2. Add the package dependencies to the `dependencies` element of your project *pom.xml* file, replacing `com.example:test` with your package. ``` @@ -182,13 +180,13 @@ Para instalar um pacote de Apache Maven a partir do {% data variables.product.pr ``` -3. Instale o pacote. +3. Install the package. ```shell $ mvn install ``` -### Leia mais +### Further reading -- "[Configurar o Gradle para uso com o {% data variables.product.prodname_registry %}](/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages)" -- "[Excluir um pacote](/packages/publishing-and-managing-packages/deleting-a-package/)" +- "[Configuring Gradle for use with {% data variables.product.prodname_registry %}](/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages)" +- "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package/)" diff --git a/translations/pt-BR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md b/translations/pt-BR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md index 404fbf932bd3..59c0d2c8b81b 100644 --- a/translations/pt-BR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md +++ b/translations/pt-BR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md @@ -1,6 +1,6 @@ --- -title: Configurar o Docker para usar com o GitHub Packages -intro: 'Você pode configurar o cliente do Docker para usar o {% data variables.product.prodname_registry %} para publicar e recuperar imagens do Docker.' +title: Configuring Docker for use with GitHub Packages +intro: 'You can configure the Docker client to use {% data variables.product.prodname_registry %} to publish and retrieve docker images.' product: '{% data reusables.gated-features.packages %}' redirect_from: - /articles/configuring-docker-for-use-with-github-package-registry @@ -13,35 +13,33 @@ versions: {% data reusables.package_registry.packages-ghes-release-stage %} -**Note:** When installing or publishing a docker image, {% data variables.product.prodname_registry %} does not currently support foreign layers, such as Windows images. +{% data reusables.package_registry.admins-can-configure-package-types %} -### Autenticar-se no {% data variables.product.prodname_registry %} +### About Docker and {% data variables.product.prodname_registry %} -{% warning %} +{% data reusables.package_registry.docker_registry_deprecation_status %} -Using the Docker image ID, tag the docker image, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image, and *VERSION* with package version at build time. - -{% endwarning %} - -Ao instalar ou publicar uma imagem do docker, o {% data variables.product.prodname_registry %} não é compatível camadas externas, como imagens do Windows. +When installing or publishing a docker image, {% data variables.product.prodname_registry %} does not currently support foreign layers, such as Windows images. {% if currentVersion != "free-pro-team@latest" %} -Antes de poder usar o registro do Docker no {% data variables.product.prodname_registry %}, o administrador do site para {% data variables.product.product_location_enterprise %} deve habilitar o suporte do Docker e o isolamento do subdomínio para a sua instância. Para obter mais informações, consulte "[Gerenciar pacotes do GitHub para a sua empresa](/enterprise/admin/packages)". +Before you can use the Docker registry on {% data variables.product.prodname_registry %}, the site administrator for {% data variables.product.product_location_enterprise %} must enable Docker support and subdomain isolation for your instance. For more information, see "[Managing GitHub Packages for your enterprise](/enterprise/admin/packages)." {% endif %} -### Autenticar-se no {% data variables.product.prodname_registry %} +### Authenticating to {% data variables.product.prodname_registry %} + +{% data reusables.package_registry.docker_registry_deprecation_status %} {% data reusables.package_registry.authenticate-packages %} -#### Efetuando a autenticação com um token de acesso pessoal +#### Authenticating with a personal access token {% data reusables.package_registry.required-scopes %} -Você pode efetuar a autenticação no {% data variables.product.prodname_registry %} usando o comando de login do `docker`. +You can authenticate to {% data variables.product.prodname_registry %} with Docker using the `docker` login command. -Para manter suas credenciais seguras, recomendamos que você salve seu token de acesso pessoal em um arquivo local no seu computador e use o sinalizador `--password-stdin` do Docker que lê o seu token a partir de um arquivo local. +To keep your credentials secure, we recommend you save your personal access token in a local file on your computer and use Docker's `--password-stdin` flag, which reads your token from a local file. {% if currentVersion == "free-pro-team@latest" %} {% raw %} @@ -59,31 +57,32 @@ Para manter suas credenciais seguras, recomendamos que você salve seu token de {% endraw %} {% endif %} -To use this example login command, replace `USERNAME` with your {% data variables.product.prodname_dotcom %} username and `~/TOKEN.txt` with the file path to your personal access token for {% data variables.product.prodname_dotcom %}. +To use this example login command, replace `USERNAME` with your {% data variables.product.product_name %} username{% if currentVersion != "free-pro-team@latest" %}, `HOSTNAME` with the URL for {% data variables.product.product_location_enterprise %},{% endif %} and `~/TOKEN.txt` with the file path to your personal access token for {% data variables.product.product_name %}. -Para obter mais informações, consulte "[Login do Docker](https://docs.docker.com/engine/reference/commandline/login/#provide-a-password-using-stdin)". +For more information, see "[Docker login](https://docs.docker.com/engine/reference/commandline/login/#provide-a-password-using-stdin)." -#### Efetuando a autenticação com o `GITHUB_TOKEN` +#### Authenticating with the `GITHUB_TOKEN` {% data reusables.package_registry.package-registry-with-github-tokens %} -### Publicar um pacote +### Publishing a package + +{% data reusables.package_registry.docker_registry_deprecation_status %} -O {% data variables.product.prodname_registry %} aceita várias imagens do Docker de nível superior por repositório. Um repositório pode ter qualquer número de tags de imagem. Você poderá conhecer uma publicação de serviço degradada ou instalar imagens do Docker com tamanho superior a 10 GB. As camadas são limitadas em 5 GB cada. Para obter mais informações, consulte "[Tag do Docker](https://docs.docker.com/engine/reference/commandline/tag/)" na documentação Docker. +{% data variables.product.prodname_registry %} supports multiple top-level Docker images per repository. A repository can have any number of image tags. You may experience degraded service publishing or installing Docker images larger than 10GB, layers are capped at 5GB each. For more information, see "[Docker tag](https://docs.docker.com/engine/reference/commandline/tag/)" in the Docker documentation. {% data reusables.package_registry.lowercase-name-field %} {% data reusables.package_registry.viewing-packages %} -1. Determine o nome da imagem e o ID da sua imagem do docker usando `imagens do docker`. +1. Determine the image name and ID for your docker image using `docker images`. ```shell $ docker images > < > > REPOSITORY TAG IMAGE ID CREATED SIZE > IMAGE_NAME VERSION IMAGE_ID 4 weeks ago 1.11MB ``` -2. If you haven't already built a docker image for the package, build the image, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image, *VERSION* with package version at build time, and *PATH* to the image if it isn't in the current working directory. -{% if currentVersion != "free-pro-team@latest" %} *HOSTNAME* com o nome de host de {% data variables.product.product_location_enterprise %},{% endif %} e *VERSÃO* com a versão do pacote no momento da criação. +2. Using the Docker image ID, tag the docker image, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image,{% if currentVersion != "free-pro-team@latest" %} *HOSTNAME* with the hostname of {% data variables.product.product_location_enterprise %},{% endif %} and *VERSION* with package version at build time. {% if currentVersion == "free-pro-team@latest" %} ```shell $ docker tag IMAGE_ID docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME:VERSION @@ -93,8 +92,7 @@ O {% data variables.product.prodname_registry %} aceita várias imagens do Docke $ docker tag IMAGE_ID docker.HOSTNAME/OWNER/REPOSITORY/IMAGE_NAME:VERSION ``` {% endif %} -3. Se você ainda não criou uma imagem do docker para o pacote, crie a imagem, substituindo *PROPRIETÁRIO* pelo nome do usuário ou conta de organização proprietária do repositório, *REPOSITÓRIO* pelo o nome do repositório que contém o seu projeto, *IMAGE_NAME* pelo o nome do pacote ou imagem, *VERSÃO* com a versão do pacote no momento da criação, -{% if currentVersion != "free-pro-team@latest" %} *HOSTNAME* pelo o nome de host de {% data variables.product.product_location_enterprise %},{% endif %} e *PATH* para a imagem se não estiver no diretório de trabalho atual. +3. If you haven't already built a docker image for the package, build the image, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image, *VERSION* with package version at build time,{% if currentVersion != "free-pro-team@latest" %} *HOSTNAME* with the hostname of {% data variables.product.product_location_enterprise %},{% endif %} and *PATH* to the image if it isn't in the current working directory.s {% if currentVersion == "free-pro-team@latest" %} ```shell $ docker build -t docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME:VERSION PATH @@ -104,7 +102,7 @@ O {% data variables.product.prodname_registry %} aceita várias imagens do Docke $ docker build -t docker.HOSTNAME/OWNER/REPOSITORY/IMAGE_NAME:VERSION PATH ``` {% endif %} -4. Publicar a imagem no {% data variables.product.prodname_registry %}. +4. Publish the image to {% data variables.product.prodname_registry %}. {% if currentVersion == "free-pro-team@latest" %} ```shell $ docker push docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME:VERSION @@ -116,13 +114,15 @@ O {% data variables.product.prodname_registry %} aceita várias imagens do Docke {% endif %} {% note %} - **Observação:** Você deve enviar sua imagem usando `IMAGE_NAME:VERSION` e não `IMAGE_NAME:SHA`. + **Note:** You must push your image using `IMAGE_NAME:VERSION` and not using `IMAGE_NAME:SHA`. {% endnote %} -#### Exemplo de publicação de uma imagem do Docker +#### Example publishing a Docker image -Você pode publicar a versão 1.0 da imagem de `monalisa` para o repositório `octocat/octo-app` usando um ID de imagem. +{% data reusables.package_registry.docker_registry_deprecation_status %} + +You can publish version 1.0 of the `monalisa` image to the `octocat/octo-app` repository using an image ID. {% if currentVersion == "free-pro-team@latest" %} ```shell @@ -155,16 +155,15 @@ $ docker push docker.HOSTNAME/octocat/octo-app/monalisa:1.0 {% endif %} -Você pode publicar uma nova imagem do Docker pela primeira vez e nomeá-la como `monalisa`. +You can publish a new Docker image for the first time and name it `monalisa`. {% if currentVersion == "free-pro-team@latest" %} ```shell # Build the image with docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME:VERSION # Assumes Dockerfile resides in the current working directory (.) $ docker build -t docker.pkg.github.com/octocat/octo-app/monalisa:1.0 . -$ docker build -t docker.pkg.github.com/octocat/octo-app/monalisa:1.0 . -# Faça push da imagem no {% data variables.product.prodname_registry %} +# Push the image to {% data variables.product.prodname_registry %} $ docker push docker.pkg.github.com/octocat/octo-app/monalisa:1.0 ``` @@ -179,10 +178,11 @@ $ docker push docker.HOSTNAME/octocat/octo-app/monalisa:1.0 ``` {% endif %} -### Instalar um pacote +### Installing a package -You can use the `docker pull` command to install a docker image from {% data variables.product.prodname_registry %}, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image, *TAG_NAME* with tag for the image you want to install. {% data reusables.package_registry.lowercase-name-field %} +{% data reusables.package_registry.docker_registry_deprecation_status %} +You can use the `docker pull` command to install a docker image from {% data variables.product.prodname_registry %}, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image,{% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance, {% endif %} and *TAG_NAME* with tag for the image you want to install. {% data reusables.package_registry.lowercase-name-field %} {% if currentVersion == "free-pro-team@latest" %} ```shell @@ -196,11 +196,10 @@ $ docker pull docker.HOSTNAME/OWNER/REPOSITORY/IMAGE_NAME:TAG_NAME {% note %} -**Nota:** Você deve fazer pull da imagem usando `IMAGE_NAME:VERSION` e não usar `IMAGE_NAME:SHA`. +**Note:** You must pull the image using `IMAGE_NAME:VERSION` and not using `IMAGE_NAME:SHA`. {% endnote %} +### Further reading -### Leia mais - -- "[Excluir um pacote](/packages/publishing-and-managing-packages/deleting-a-package/)" +- "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package/)" diff --git a/translations/pt-BR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-dotnet-cli-for-use-with-github-packages.md b/translations/pt-BR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-dotnet-cli-for-use-with-github-packages.md index 8589ea0ca0e6..e12505cae4a9 100644 --- a/translations/pt-BR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-dotnet-cli-for-use-with-github-packages.md +++ b/translations/pt-BR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-dotnet-cli-for-use-with-github-packages.md @@ -1,6 +1,6 @@ --- -title: Configuring `dotnet` CLI for use with GitHub Packages -intro: 'You can configure the `dotnet` command-line interface (CLI) to publish NuGet packages to {% data variables.product.prodname_registry %} and to use packages stored on {% data variables.product.prodname_registry %} as dependencies in a .NET project.' +title: Configurar a CLI `dotnet` para uso com o GitHub Packages +intro: 'Você pode configurar a interface de linha de comando `dotnet` (CLI) para publicar pacotes NuGet no {% data variables.product.prodname_registry %} e usar pacotes armazenados no {% data variables.product.prodname_registry %} como dependências em um projeto .NET.' product: '{% data reusables.gated-features.packages %}' redirect_from: - /articles/configuring-nuget-for-use-with-github-package-registry @@ -14,25 +14,25 @@ versions: {% data reusables.package_registry.packages-ghes-release-stage %} -{% data reusables.package_registry.admins-can-configure-package-types %} +**Note:** When installing or publishing a docker image, {% data variables.product.prodname_registry %} does not currently support foreign layers, such as Windows images. -### Authenticating to {% data variables.product.prodname_registry %} +### Autenticar-se no {% data variables.product.prodname_registry %} {% data reusables.package_registry.authenticate-packages %} -#### Authenticating with a personal access token +#### Efetuando a autenticação com um token de acesso pessoal {% data reusables.package_registry.required-scopes %} -To authenticate to {% data variables.product.prodname_registry %} with the `dotnet` command-line interface (CLI), create a *nuget.config* file in your project directory specifying {% data variables.product.prodname_registry %} as a source under `packageSources` for the `dotnet` CLI client. +Para efetuar a autenticação em {% data variables.product.prodname_registry %} com a interface da linha de comando (CLI) `dotnet`, crie um arquivo *nuget.config* no diretório do seu projeto, especificando {% data variables.product.prodname_registry %} como uma fonte em `packageSources` para o cliente da CLI `Dotnet`. -You must replace: -- `USERNAME` with the name of your user account on {% data variables.product.prodname_dotcom %}. -- `TOKEN` with your personal access token. -- `OWNER` with the name of the user or organization account that owns the repository containing your project.{% if currentVersion != "free-pro-team@latest" %} -- `HOSTNAME` with the host name for your {% data variables.product.prodname_ghe_server %} instance. +Você deve substituir: +- `USUÁRIO` pelo o nome da sua conta de usuário em {% data variables.product.prodname_dotcom %}. +- `TOKEN` pelo seu token de acesso pessoal. +- `PROPRIETÁRIO` com o nome do usuário ou conta da organização à qual pertence o repositório que contém o seu projeto.{% if currentVersion != "free-pro-team@latest" %} +- `HOSTNAME` com o nome de host para sua instância de {% data variables.product.prodname_ghe_server %}. -If your instance has subdomain isolation enabled: +Se sua instância tem o isolamento de subdomínio habilitado: {% endif %} ```xml @@ -52,7 +52,7 @@ If your instance has subdomain isolation enabled: ``` {% if currentVersion != "free-pro-team@latest" %} -If your instance has subdomain isolation disabled: +Se sua instância tem o isolamento de subdomínio desabilitado: ```xml @@ -71,26 +71,26 @@ If your instance has subdomain isolation disabled: ``` {% endif %} -#### Authenticating with the `GITHUB_TOKEN` +#### Efetuando a autenticação com o `GITHUB_TOKEN` {% data reusables.package_registry.package-registry-with-github-tokens %} -### Publishing a package +### Publicar um pacote -You can publish a package to {% data variables.product.prodname_registry %} by authenticating with a *nuget.config* file. When publishing, you need to use the same value for `OWNER` in your *csproj* file that you use in your *nuget.config* authentication file. Specify or increment the version number in your *.csproj* file, then use the `dotnet pack` command to create a *.nuspec* file for that version. For more information on creating your package, see "[Create and publish a package](https://docs.microsoft.com/en-us/nuget/quickstart/create-and-publish-a-package-using-the-dotnet-cli)" in the Microsoft documentation. +Você pode publicar um pacote no {% data variables.product.prodname_registry %}, efetuando a autenticação com um arquivo *nuget.config*. Ao fazer a publicação, você precisa usar o mesmo valor para `PROPRIETÁRIO` no seu arquivo *csproj* que você usa no seu arquivo de autenticação *nuget.config*. Especifique ou incremente o número da versão no seu *.csproj* e, em seguida, utilize o comando `dotnet pack` para criar um arquivo *.nuspec* para essa versão. Para obter mais informações sobre como criar seu pacote, consulte "[Criar e publicar um pacote](https://docs.microsoft.com/en-us/nuget/quickstart/create-and-publish-a-package-using-the-dotnet-cli)" na documentação da Microsoft. {% data reusables.package_registry.viewing-packages %} {% data reusables.package_registry.authenticate-step %} -2. Create a new project. +2. Criar um novo projeto ```shell dotnet new console --name OctocatApp ``` -3. Add your project's specific information to your project's file, which ends in *.csproj*. You must replace: - - `OWNER` with the name of the user or organization account that owns the repository containing your project. - - `REPOSITORY` with the name of the repository containing the package you want to publish. - - `1.0.0` with the version number of the package.{% if currentVersion != "free-pro-team@latest" %} - - `HOSTNAME` with the host name for your {% data variables.product.prodname_ghe_server %} instance.{% endif %} +3. Adicione informações específicas do seu projeto ao arquivo do seu projeto, que termina em *.csproj*. Você deve substituir: + - `PROPRIETÁRIO` com o nome do usuário ou conta da organização proprietária do repositório que contém o seu projeto. + - `REPOSITÓRIO` pelo nome do repositório que contém o pacote que você deseja publicar. + - `1.0.0` com o número de versão do pacote.{% if currentVersion != "free-pro-team@latest" %} + - `HOSTNAME` com o nome de host para sua instância de {% data variables.product.prodname_ghe_server %} .{% endif %} ``` xml @@ -107,21 +107,21 @@ You can publish a package to {% data variables.product.prodname_registry %} by a ``` -4. Package the project. +4. Empacotar o projeto. ```shell dotnet pack --configuration Release ``` -5. Publish the package using the `key` you specified in the *nuget.config* file. +5. Publique o pacote usando a `chave` que você especificou no arquivo *nuget.config*. ```shell dotnet nuget push "bin/Release/OctocatApp.1.0.0.nupkg" --source "github" ``` -### Publishing multiple packages to the same repository +### Publicar vários pacotes no mesmo repositório -To publish multiple packages to the same repository, you can include the same {% data variables.product.prodname_dotcom %} repository URL in the `RepositoryURL` fields in all *.csproj* project files. {% data variables.product.prodname_dotcom %} matches the repository based on that field. +Para publicar vários pacotes no mesmo repositório, você pode incluir a mesma URL do repositório do {% data variables.product.prodname_dotcom %} nos campos de `ReposityURL` em todos os arquivos de projeto *.csproj*. O {% data variables.product.prodname_dotcom %} corresponde ao repositório baseado nesse campo. -For example, the *OctodogApp* and *OctocatApp* projects will publish to the same repository: +Por exemplo, os projetos *OctodogApp* e *OctocatApp* irão publicar no mesmo repositório: ``` xml @@ -157,14 +157,13 @@ For example, the *OctodogApp* and *OctocatApp* projects will publish to the same ``` +### Instalar um pacote -### Installing a package - -Using packages from {% data variables.product.prodname_dotcom %} in your project is similar to using packages from *nuget.org*. Add your package dependencies to your *.csproj* file, specifying the package name and version. For more information on using a *.csproj* file in your project, see "[Working with NuGet packages](https://docs.microsoft.com/en-us/nuget/consume-packages/overview-and-workflow)" in the Microsoft documentation. +Usar pacotes do {% data variables.product.prodname_dotcom %} no seu projeto é semelhante a usar pacotes do *nuget.org*. Adicione suas dependências de pacote ao seu arquivo *.csproj* especificando o nome e a versão do pacote. Para obter mais informações sobre como usar um arquivo *.csproj* no seu projeto, consulte "[Trabalhar com pacotes NuGet](https://docs.microsoft.com/en-us/nuget/consume-packages/overview-and-workflow)" na documentação da Microsoft. {% data reusables.package_registry.authenticate-step %} -2. To use a package, add `ItemGroup` and configure the `PackageReference` field in the *.csproj* project file, replacing the `OctokittenApp` package with your package dependency and `1.0.0` with the version you want to use: +2. Para usar um pacote, adicione `ItemGroup` e configure o campo `PackageReference` no arquivo de projeto *.csproj*, substituindo o pacote `OctokittenApp` pelo seu pacote de dependência e `1.0.0` pela versão que você deseja usar: ``` xml @@ -186,11 +185,11 @@ Using packages from {% data variables.product.prodname_dotcom %} in your project ``` -3. Install the packages with the `restore` command. +3. Instale os pacotes com o comando `restaurar`. ```shell - dotnet restore + restaurar dotnet ``` -### Further reading +### Leia mais -- "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package/)" +- "[Excluir um pacote](/packages/publishing-and-managing-packages/deleting-a-package/)" diff --git a/translations/pt-BR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages.md b/translations/pt-BR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages.md index c977be6bdfa3..ae19d06c8ec0 100644 --- a/translations/pt-BR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages.md +++ b/translations/pt-BR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages.md @@ -26,7 +26,8 @@ versions: Você pode efetuar a autenticação no {% data variables.product.prodname_registry %} com Gradle usando Gradle Groovy ou Kotlin DSL e editando o seu arquivo *build.gradle* (Gradle Groovy) ou o arquivo *build.gradle.kts* (Kotlin DSL) para incluir seu token de acesso pessoal. Também é possível configurar o Gradle Groovy e o Kotlin DSL para reconhecer um único pacote ou vários pacotes em um repositório. {% if currentVersion != "free-pro-team@latest" %} -Substitua *REGISTRY-URL* pela URL do registro do Maven para a sua instância. Se sua instância tiver o isolamento de subdomínio habilitado, use `maven.HOSTNAME`. Se sua instância estiver com o isolamento de subdomínio desabilitado, use `HOSTNAME/registry/maven`. Em ambos os casos, substitua *HOSTNAME* pelo nome de host da sua instância do {% data variables.product.prodname_ghe_server %}. +Substitua *REGISTRY-URL* pela URL do registro do Maven para a sua instância. Se sua instância tiver o isolamento de subdomínio habilitado, use `maven.HOSTNAME`. Se sua instância estiver com o isolamento de subdomínio desabilitado, use `HOSTNAME/registry/maven`. Em ambos os casos, substitua *HOSTNAME* pelo nome do host da sua +instância de {% data variables.product.prodname_ghe_server %}. {% endif %} Substitua *NOME DE USUÁRIO* pelo seu nome de usuário do {% data variables.product.prodname_dotcom %} *TOKEN* pelo seu token de acesso pessoal, *REPOSITÓRIO* pelo nome do repositório que contém o pacote que você deseja publicar, e *PROPRIETÁRIO* pelo nome do usuário ou conta de organização no {% data variables.product.prodname_dotcom %} que é proprietário do repositório. {% data reusables.package_registry.lowercase-name-field %} @@ -48,7 +49,7 @@ publishing { repositories { maven { name = "GitHubPackages" - url = uri("https://maven.pkg.github.com/OWNER/REPOSITORY") + url = uri("https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}REGISTRY-URL{% endif %}/OWNER/REPOSITORY") credentials { username = project.findProperty("gpr.user") ?: System.getenv("USERNAME") password = project.findProperty("gpr.key") ?: System.getenv("TOKEN") @@ -76,7 +77,7 @@ subprojects { repositories { maven { name = "GitHubPackages" - url = uri("https://maven.pkg.github.com/OWNER/REPOSITORY") + url = uri("https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}REGISTRY-URL{% endif %}/OWNER/REPOSITORY") credentials { username = project.findProperty("gpr.user") ?: System.getenv("USERNAME") password = project.findProperty("gpr.key") ?: System.getenv("TOKEN") @@ -103,7 +104,7 @@ publishing { repositories { maven { name = "GitHubPackages" - url = uri("https://maven.pkg.github.com/OWNER/REPOSITORY") + url = uri("https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}REGISTRY-URL{% endif %}/OWNER/REPOSITORY") credentials { username = project.findProperty("gpr.user") as String? ?: System.getenv("USERNAME") password = project.findProperty("gpr.key") as String? ?: System.getenv("TOKEN") @@ -120,32 +121,32 @@ publishing { ##### Exemplo de uso do Kotlin DSL para vários pacotes no mesmo repositório - ```shell - plugins { - `maven-publish` apply false - } +```shell +plugins { + `maven-publish` apply false +} - subprojects { - apply(plugin = "maven-publish") - configure { - repositories { - maven { - name = "GitHubPackages" - url = uri("https://maven.pkg.github.com/OWNER/REPOSITORY") - credentials { - username = project.findProperty("gpr.user") as String? ?: System.getenv("USERNAME") - password = project.findProperty("gpr.key") as String? ?: System.getenv("TOKEN") - } - } - } - publications { - register("gpr") { - from(components["java"]) - } - } - } - } - ``` +subprojects { + apply(plugin = "maven-publish") + configure { + repositories { + maven { + name = "GitHubPackages" + url = uri("https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}REGISTRY-URL{% endif %}/OWNER/REPOSITORY") + credentials { + username = project.findProperty("gpr.user") as String? ?: System.getenv("USERNAME") + password = project.findProperty("gpr.key") as String? ?: System.getenv("TOKEN") + } + } + } + publications { + register("gpr") { + from(components["java"]) + } + } + } +} +``` #### Efetuar a autenticação com o `GITHUB_TOKEN` @@ -173,31 +174,31 @@ Você pode instalar um pacote adicionando-o como uma dependência ao seu projeto {% data reusables.package_registry.authenticate-step %} 2. Adicione as dependências do pacote ao seu arquivo *build.gradle* (Gradle Groovy) ou ao arquivo *build.gradle.kts* (arquivo de Kotlin DSL). - Exemplo de uso do Grady Groovy: + Exemplo do uso do Gradle Groovy: ```shell dependencies { - implementation 'com.example:package' + implementation 'com.example:package' } ``` Exemplo de uso do Kotlin DSL: ```shell dependencies { - implementation("com.example:package") + implementation("com.example:package") } ``` 3. Adicione o plugin do maven ao seu arquivo *build.gradle* (Gradle Groovy) ou ao arquivo *build.gradle.kts* (arquivo Kotlin DSL). - Exemplo de uso do Grady Groovy: + Exemplo do uso do Gradle Groovy: ```shell plugins { - id 'maven' + id 'maven' } ``` Exemplo de uso do Kotlin DSL: ```shell plugins { - `maven` + `maven` } ``` @@ -209,5 +210,5 @@ Você pode instalar um pacote adicionando-o como uma dependência ao seu projeto ### Leia mais -- "[Configurar o Apache Maven para uso com o {% data variables.product.prodname_registry %}](/packages/using-github-packages-with-your-projects-ecosystem/configuring-apache-maven-for-use-with-github-packages)" +- "[Configurar o Apache Maven para uso com {% data variables.product.prodname_registry %}](/packages/using-github-packages-with-your-projects-ecosystem/configuring-apache-maven-for-use-with-github-packages)" - "[Excluir um pacote](/packages/publishing-and-managing-packages/deleting-a-package/)" diff --git a/translations/pt-BR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md b/translations/pt-BR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md index fc2c35eaa0af..efc0e2d45072 100644 --- a/translations/pt-BR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md +++ b/translations/pt-BR/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md @@ -1,6 +1,6 @@ --- -title: Configurar o npm para usar com o GitHub Packages -intro: 'Você pode configurar o npm para publicar pacotes no {% data variables.product.prodname_registry %} e usar pacotes armazenados no {% data variables.product.prodname_registry %} como dependências em um projeto npm.' +title: Configuring npm for use with GitHub Packages +intro: 'You can configure npm to publish packages to {% data variables.product.prodname_registry %} and to use packages stored on {% data variables.product.prodname_registry %} as dependencies in an npm project.' product: '{% data reusables.gated-features.packages %}' redirect_from: - /articles/configuring-npm-for-use-with-github-package-registry @@ -13,119 +13,116 @@ versions: {% data reusables.package_registry.packages-ghes-release-stage %} -**Note:** When installing or publishing a docker image, {% data variables.product.prodname_registry %} does not currently support foreign layers, such as Windows images. +{% data reusables.package_registry.admins-can-configure-package-types %} -### Autenticar-se no {% data variables.product.prodname_registry %} +### Authenticating to {% data variables.product.prodname_registry %} {% data reusables.package_registry.authenticate-packages %} -#### Efetuando a autenticação com um token de acesso pessoal +#### Authenticating with a personal access token {% data reusables.package_registry.required-scopes %} -Você pode efetuar a autenticação no {% data variables.product.prodname_registry %} com o npm editando seu arquivo *~/.npmrc* por usuário para incluir o seu token de acesso pessoal ou fazer o login no npm na linha de comando usando seu nome de usuário e token de acesso pessoal. +You can authenticate to {% data variables.product.prodname_registry %} with npm by either editing your per-user *~/.npmrc* file to include your personal access token or by logging in to npm on the command line using your username and personal access token. -To authenticate by adding your personal access token to your *~/.npmrc* file, edit the *~/.npmrc* file for your project to include the following line, replacing *TOKEN* with your personal access token. Crie um novo arquivo *~/.npmrc* se um não existir. +To authenticate by adding your personal access token to your *~/.npmrc* file, edit the *~/.npmrc* file for your project to include the following line, replacing {% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance and {% endif %}*TOKEN* with your personal access token. Create a new *~/.npmrc* file if one doesn't exist. {% if currentVersion != "free-pro-team@latest" %} -Se sua instância tem o isolamento de subdomínio habilitado: +If your instance has subdomain isolation enabled: {% endif %} ```shell -//npm.pkg.github.com/:_authToken=TOKEN +//{% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %}/:_authToken=TOKEN ``` {% if currentVersion != "free-pro-team@latest" %} -Se sua instância tem o isolamento de subdomínio desabilitado: +If your instance has subdomain isolation disabled: ```shell -$ npm login --registry=https://npm.pkg.github.com -> Username: USERNAME -> Password: TOKEN -> Email: PUBLIC-EMAIL-ADDRESS +//HOSTNAME/_registry/npm/:_authToken=TOKEN ``` {% endif %} -Para efetuar a autenticação conectado no npm, use o comando `npm login` , substituindo o *NOME DE USUÁRIO* pelo seu nome de usuário do {% data variables.product.prodname_dotcom %}, o *TOKEN* pelo seu token de acesso pessoal e *PUBLIC-EMAIL-ADDRESS* pelo seu endereço de e-mail. +To authenticate by logging in to npm, use the `npm login` command, replacing *USERNAME* with your {% data variables.product.prodname_dotcom %} username, *TOKEN* with your personal access token, and *PUBLIC-EMAIL-ADDRESS* with your email address. {% if currentVersion != "free-pro-team@latest" %} -Se sua instância tem o isolamento de subdomínio habilitado: +If your instance has subdomain isolation enabled: {% endif %} ```shell -"repository" : { - "type" : "git", - "url": "ssh://git@github.com/OWNER/REPOSITORY.git", - "directory": "packages/name" - }, +$ npm login --registry=https://{% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %} +> Username: USERNAME +> Password: TOKEN +> Email: PUBLIC-EMAIL-ADDRESS ``` {% if currentVersion != "free-pro-team@latest" %} -Se sua instância tem o isolamento de subdomínio desabilitado: +If your instance has subdomain isolation disabled: ```shell -registry=https://npm.pkg.github.com/OWNER -@OWNER:registry=https://npm.pkg.github.com -@OWNER:registry=https://npm.pkg.github.com +$ npm login --registry=https://HOSTNAME/_registry/npm/ +> Username: USERNAME +> Password: TOKEN +> Email: PUBLIC-EMAIL-ADDRESS ``` {% endif %} -#### Efetuando a autenticação com o `GITHUB_TOKEN` +#### Authenticating with the `GITHUB_TOKEN` {% data reusables.package_registry.package-registry-with-github-tokens %} -### Publicar um pacote +### Publishing a package -Por padrão, o {% data variables.product.prodname_registry %} publica um pacote no repositório {% data variables.product.prodname_dotcom %} que você especificar no campo nome do arquivo *package.json*. Por exemplo, você publicaria um pacote denominado `@my-org/test` no repositório `my-org/test` do {% data variables.product.prodname_dotcom %}. Você pode adicionar um resumo da página de listagem do pacote incluindo um arquivo *README.md* no diretório do seu pacote. Para obter mais informações, consulte "[Trabalhando com package.json](https://docs.npmjs.com/getting-started/using-a-package.json)" e "[Como criar Módulos de Node.js](https://docs.npmjs.com/getting-started/creating-node-modules)" na documentação do npm. +By default, {% data variables.product.prodname_registry %} publishes a package in the {% data variables.product.prodname_dotcom %} repository you specify in the name field of the *package.json* file. For example, you would publish a package named `@my-org/test` to the `my-org/test` {% data variables.product.prodname_dotcom %} repository. You can add a summary for the package listing page by including a *README.md* file in your package directory. For more information, see "[Working with package.json](https://docs.npmjs.com/getting-started/using-a-package.json)" and "[How to create Node.js Modules](https://docs.npmjs.com/getting-started/creating-node-modules)" in the npm documentation. -Você pode publicar vários pacotes no mesmo repositório do {% data variables.product.prodname_dotcom %} incluindo um campo de `URL` no arquivo *package.json*. Para obter mais informações, consulte "[Publicar vários pacotes no mesmo repositório](#publishing-multiple-packages-to-the-same-repository)". +You can publish multiple packages to the same {% data variables.product.prodname_dotcom %} repository by including a `URL` field in the *package.json* file. For more information, see "[Publishing multiple packages to the same repository](#publishing-multiple-packages-to-the-same-repository)." -É possível definir o mapeamento do escopo para o seu projeto usando um arquivo local *.npmrc* no projeto ou usando a opção `publishConfig` em *package.json*. {% data variables.product.prodname_registry %} só é compatível com pacotes npm com escopo definido. Pacotes com escopo têm nomes no formato `@owner/name`. Os pacotes com escopo sempre começam pelo símbolo `@`. Talvez seja necessário atualizar o nome no *package.json* para usar o nome com escopo. Por exemplo, `"name": "@codertocat/hello-world-npm"`. +You can set up the scope mapping for your project using either a local *.npmrc* file in the project or using the `publishConfig` option in the *package.json*. {% data variables.product.prodname_registry %} only supports scoped npm packages. Scoped packages have names with the format of `@owner/name`. Scoped packages always begin with an `@` symbol. You may need to update the name in your *package.json* to use the scoped name. For example, `"name": "@codertocat/hello-world-npm"`. {% data reusables.package_registry.viewing-packages %} -#### Publicar um pacote usando o arquivo *.npmrc* local +#### Publishing a package using a local *.npmrc* file -Você pode usar um arquivo *.npmrc* para configurar o mapeamento do escopo para o seu projeto. No arquivo *.npmrc*, use a URL e o proprietário da conta de {% data variables.product.prodname_registry %} para que {% data variables.product.prodname_registry %} saiba onde rotear as solicitações de pacotes. O uso de um arquivo *.npmrc* impede que outros desenvolvedores publiquem acidentalmente o pacote no npmjs.org em vez de {% data variables.product.prodname_registry %}. {% data reusables.package_registry.lowercase-name-field %} +You can use an *.npmrc* file to configure the scope mapping for your project. In the *.npmrc* file, use the {% data variables.product.prodname_registry %} URL and account owner so {% data variables.product.prodname_registry %} knows where to route package requests. Using an *.npmrc* file prevents other developers from accidentally publishing the package to npmjs.org instead of {% data variables.product.prodname_registry %}. {% data reusables.package_registry.lowercase-name-field %} {% data reusables.package_registry.authenticate-step %} {% data reusables.package_registry.create-npmrc-owner-step %} {% data reusables.package_registry.add-npmrc-to-repo-step %} -4. Verifique o nome do pacote no *package.json* do seu projeto. O campo `name` (nome) deve conter o escopo e o nome do pacote. Por exemplo, se o pacote for chamado de "test" e você estiver publicando na organização "My-org" do {% data variables.product.prodname_dotcom %}, o campo `name` (nome) do seu *package.json* deverá ser `@my-org/test`. +4. Verify the name of your package in your project's *package.json*. The `name` field must contain the scope and the name of the package. For example, if your package is called "test", and you are publishing to the "My-org" {% data variables.product.prodname_dotcom %} organization, the `name` field in your *package.json* should be `@my-org/test`. {% data reusables.package_registry.verify_repository_field %} {% data reusables.package_registry.publish_package %} -#### Publicar um pacote usando o `publishConfig` no arquivo *package.json* +#### Publishing a package using `publishConfig` in the *package.json* file -Você pode usar o elemento `publishConfig` no arquivo *package.json* para especificar o registro onde você quer o pacote publicado. Para obter mais informações, consulte "[publishConfig](https://docs.npmjs.com/files/package.json#publishconfig)" na documentação npm. +You can use `publishConfig` element in the *package.json* file to specify the registry where you want the package published. For more information, see "[publishConfig](https://docs.npmjs.com/files/package.json#publishconfig)" in the npm documentation. -1. Edite o arquivo *package.json* do seu pacote e inclua uma entrada `publishConfig`. +1. Edit the *package.json* file for your package and include a `publishConfig` entry. {% if currentVersion != "free-pro-team@latest" %} - Se sua instância tem o isolamento de subdomínio habilitado: + If your instance has subdomain isolation enabled: {% endif %} ```shell - "publishConfig": { - "registry":"https://npm.pkg.github.com/" - }, + "publishConfig": { + "registry":"https://{% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %}" + }, ``` {% if currentVersion != "free-pro-team@latest" %} - Se sua instância tem o isolamento de subdomínio desabilitado: + If your instance has subdomain isolation disabled: ```shell - "publishConfig": { - "registry":"https://HOSTNAME/_registry/npm/" - }, + "publishConfig": { + "registry":"https://HOSTNAME/_registry/npm/" + }, ``` {% endif %} {% data reusables.package_registry.verify_repository_field %} {% data reusables.package_registry.publish_package %} -### Publicar vários pacotes no mesmo repositório +### Publishing multiple packages to the same repository -Para publicar vários pacotes no mesmo repositório, você pode incluir a URL do repositório do {% data variables.product.prodname_dotcom %} no campo `repositório` do arquivo *package.json* para cada pacote. +To publish multiple packages to the same repository, you can include the URL of the {% data variables.product.prodname_dotcom %} repository in the `repository` field of the *package.json* file for each package. -Para garantir que a URL do repositório esteja correta, substitua REPOSITÓRIO pelo nome do repositório que contém o pacote que você deseja publicar, e o PROPRIETÁRIO pelo nome de usuário ou conta de organização no {% data variables.product.prodname_dotcom %} que é proprietário do repositório. +To ensure the repository's URL is correct, replace REPOSITORY with the name of the repository containing the package you want to publish, and OWNER with the name of the user or organization account on {% data variables.product.prodname_dotcom %} that owns the repository. -O {% data variables.product.prodname_registry %} corresponderá ao repositório baseado na URL, em vez de ser baseado no nome do pacote. Se você armazenar o arquivo *package.json* fora do diretório raiz do seu repositório, você poderá usar o campo `diretório` para especificar o local onde {% data variables.product.prodname_registry %} pode encontrar os arquivos *package.json*. +{% data variables.product.prodname_registry %} will match the repository based on the URL, instead of based on the package name. If you store the *package.json* file outside the root directory of your repository, you can use the `directory` field to specify the location where {% data variables.product.prodname_registry %} can find the *package.json* files. ```shell "repository" : { @@ -135,18 +132,18 @@ O {% data variables.product.prodname_registry %} corresponderá ao repositório }, ``` -### Instalar um pacote +### Installing a package -Você pode instalar pacotes do {% data variables.product.prodname_registry %} adicionando os pacotes como dependências no arquivo *package.json* para o seu projeto. Para obter mais informações sobre como usar um pacote *package.json* no projeto, consulte "[Trabalhar com package.json](https://docs.npmjs.com/getting-started/using-a-package.json)" na documentação npm. +You can install packages from {% data variables.product.prodname_registry %} by adding the packages as dependencies in the *package.json* file for your project. For more information on using a *package.json* in your project, see "[Working with package.json](https://docs.npmjs.com/getting-started/using-a-package.json)" in the npm documentation. -Por padrão, você pode adicionar pacotes a partir de uma organização. Para obter mais informações, consulte [Instalar pacotes de outras organizações](#installing-packages-from-other-organizations) +By default, you can add packages from one organization. For more information, see "[Installing packages from other organizations](#installing-packages-from-other-organizations)." -Você também precisa adicionar o arquivo *.npmrc* ao seu projeto para que todas as solicitações de instalação passem pelo {% data variables.product.prodname_registry %}. Ao encaminhar todas as solicitações através de {% data variables.product.prodname_registry %}, você pode usar pacotes com escopo e sem escopo de *npmjs.com*. Para obter mais informações, consulte "[npm-scope](https://docs.npmjs.com/misc/scope)" na documentação npm. +You also need to add the *.npmrc* file to your project so all requests to install packages will go through {% data variables.product.prodname_registry %}. When you route all package requests through {% data variables.product.prodname_registry %}, you can use both scoped and unscoped packages from *npmjs.com*. For more information, see "[npm-scope](https://docs.npmjs.com/misc/scope)" in the npm documentation. {% data reusables.package_registry.authenticate-step %} {% data reusables.package_registry.create-npmrc-owner-step %} {% data reusables.package_registry.add-npmrc-to-repo-step %} -4. Configure *package.json* no seu projeto para usar o pacote que você está instalando. Para adicionar as suas dependências de pacote ao arquivo *package.json* para {% data variables.product.prodname_registry %}, especifique o nome do pacote com escopo completo, como, por exemplo, `@my-org/server`. Para pacotes do *npmjs.com*, especifique o nome completo, como `@babel/core` ou `@lodash`. Por exemplo, o arquivo *package.json* a seguir usa o pacote `@octo-org/octo-app` como uma dependência. +4. Configure *package.json* in your project to use the package you are installing. To add your package dependencies to the *package.json* file for {% data variables.product.prodname_registry %}, specify the full-scoped package name, such as `@my-org/server`. For packages from *npmjs.com*, specify the full name, such as `@babel/core` or `@lodash`. For example, this following *package.json* uses the `@octo-org/octo-app` package as a dependency. ``` { @@ -161,28 +158,28 @@ Você também precisa adicionar o arquivo *.npmrc* ao seu projeto para que todas } } ``` -5. Instale o pacote. +5. Install the package. ```shell $ npm install ``` -#### Instalar pacotes de outras organizações +#### Installing packages from other organizations -Por padrão, você só pode usar pacotes do {% data variables.product.prodname_registry %} de uma organização. Por padrão, você só pode usar pacotes do {% data variables.product.prodname_registry %} de uma organização. {% data reusables.package_registry.lowercase-name-field %} +By default, you can only use {% data variables.product.prodname_registry %} packages from one organization. If you'd like to route package requests to multiple organizations and users, you can add additional lines to your *.npmrc* file, replacing {% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance and {% endif %}*OWNER* with the name of the user or organization account that owns the repository containing your project. {% data reusables.package_registry.lowercase-name-field %} {% if currentVersion != "free-pro-team@latest" %} -Se sua instância tem o isolamento de subdomínio habilitado: +If your instance has subdomain isolation enabled: {% endif %} ```shell -registry=https://{% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %}OWNER +registry=https://{% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME{% endif %}/OWNER @OWNER:registry={% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %} @OWNER:registry={% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %} ``` {% if currentVersion != "free-pro-team@latest" %} -Se sua instância tem o isolamento de subdomínio desabilitado: +If your instance has subdomain isolation disabled: ```shell registry=https://HOSTNAME/_registry/npm/OWNER @@ -191,7 +188,6 @@ registry=https://HOSTNAME/_registry/npm/OWNER ``` {% endif %} +### Further reading -### Leia mais - -- "[Excluir um pacote](/packages/publishing-and-managing-packages/deleting-a-package/)" +- "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package/)" diff --git a/translations/pt-BR/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md b/translations/pt-BR/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md index d04f48c01c03..8875879a16f7 100644 --- a/translations/pt-BR/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md +++ b/translations/pt-BR/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md @@ -1,6 +1,6 @@ --- -title: Usar o GitHub Packages com o GitHub Actions -intro: 'É possível configurar um fluxo de trabalho no {% data variables.product.prodname_actions %} para publicar ou instalar automaticamente um pacote do {% data variables.product.prodname_registry %}.' +title: Using GitHub Packages with GitHub Actions +intro: 'You can configure a workflow in {% data variables.product.prodname_actions %} to automatically publish or install a package from {% data variables.product.prodname_registry %}.' product: '{% data reusables.gated-features.packages %}' redirect_from: - /github/managing-packages-with-github-packages/using-github-packages-with-github-actions @@ -11,41 +11,43 @@ versions: {% data reusables.package_registry.packages-ghes-release-stage %} -### Sobre {% data variables.product.prodname_registry %} com {% data variables.product.prodname_actions %} +### About {% data variables.product.prodname_registry %} with {% data variables.product.prodname_actions %} -{% data reusables.repositories.about-github-actions %} {% data reusables.repositories.actions-ci-cd %} Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/about-github-actions)". +{% data reusables.repositories.about-github-actions %} {% data reusables.repositories.actions-ci-cd %} For more information, see "[About {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/about-github-actions)." -Você pode estender os recursos de CI e CD do seu repositório publicando ou instalando pacotes como parte do seu fluxo de trabalho. +You can extend the CI and CD capabilities of your repository by publishing or installing packages as part of your workflow. {% if currentVersion == "free-pro-team@latest" %} -#### Autenticar-se no {% data variables.product.prodname_github_container_registry %} +#### Authenticating to {% data variables.product.prodname_github_container_registry %} {% data reusables.package_registry.container-registry-beta %} -Instead of using a personal access token to authenticate to {% data variables.product.prodname_registry %}, use the `GITHUB_TOKEN` that {% data variables.product.prodname_dotcom %} automatically creates for your repository when you enable {% data variables.product.prodname_actions %}. Para um exemplo de autenticação, consulte "[Efetuar a autenticação com o {% data variables.product.prodname_container_registry %}](/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images#authenticating-with-the-container-registry)". +{% data reusables.package_registry.authenticate_with_pat_for_container_registry %} + +For an authentication example, see "[Authenticating with the {% data variables.product.prodname_container_registry %}](/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images#authenticating-with-the-container-registry)." {% endif %} -#### Efetuar a autenticação nos registros do pacote em {% data variables.product.prodname_dotcom %} +#### Authenticating to package registries on {% data variables.product.prodname_dotcom %} -{% if currentVersion == "free-pro-team@latest" %}Se você deseja que seu fluxo de trabalho seja autenticado no {% data variables.product.prodname_registry %} para acessar um registro de pacotes diferente do {% data variables.product.prodname_container_registry %} no {% data variables.product.product_name %}, depois{% else %}Para efetuar a autenticação em um pacote de registros no {% data variables.product.product_name %},{% endif %}, recomendamos usar o `GITHUB_TOKEN` que {% data variables.product.product_name %} cria automaticamente para o seu repositório quando você habilitar o {% data variables.product.prodname_actions %} em vez de um token de acesso pessoal para autenticação. O `GITHUB_TOKEN` tem escopos `read:packages` e `write:packages` do repositório atual. Para bifurcações, o token também tem o escopo `read:packages` para o repositório principal. +{% if currentVersion == "free-pro-team@latest" %}If you want your workflow to authenticate to {% data variables.product.prodname_registry %} to access a package registry other than the {% data variables.product.prodname_container_registry %} on {% data variables.product.product_name %}, then{% else %}To authenticate to package registries on {% data variables.product.product_name %},{% endif %} we recommend using the `GITHUB_TOKEN` that {% data variables.product.product_name %} automatically creates for your repository when you enable {% data variables.product.prodname_actions %} instead of a personal access token for authentication. The `GITHUB_TOKEN` has `read:packages` and `write:packages` scopes to the current repository. For forks, the token also has the `read:packages` scope for the parent repository. -Você pode fazer referência ao `GITHUB_TOKEN` no seu arquivo de fluxo de trabalho usando o contexto {% raw %}`{{secrets.GITHUB_TOKEN}}`{% endraw %}. Para obter mais informações, consulte "[Permissões para o GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)". +You can reference the `GITHUB_TOKEN` in your workflow file using the {% raw %}`{{secrets.GITHUB_TOKEN}}`{% endraw %} context. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)." -### Publicar um pacote usando uma ação +### Publishing a package using an action -Você pode publicar pacotes como parte do fluxo da sua integração contínua (CI) usando o {% data variables.product.prodname_actions %}. Por exemplo, você pode configurar um fluxo de trabalho para que sempre que um desenvolvedor fizer push do código para o branch-padrão, o fluxo de trabalho executará testes de CI. Se esses testes passarem, o fluxo de trabalho publicará uma nova versão de pacote no {% data variables.product.prodname_registry %}. Este fluxo de trabalho automatiza a criação de novas versões de pacotes somente se o código atender aos seus padrões de qualidade. +You can publish packages as part of your continuous integration (CI) flow using {% data variables.product.prodname_actions %}. For example, you could configure a workflow so that anytime a developer pushes code to the default branch, the workflow runs CI tests. If those tests pass, the workflow publishes a new package version to {% data variables.product.prodname_registry %}. This workflow automates the creation of new package versions only if the code meets your quality standards. {% data reusables.package_registry.actions-configuration %} -### Instalar um pacote usando uma ação +### Installing a package using an action -Você pode instalar pacotes como parte de seu fluxo de CI usando o {% data variables.product.prodname_actions %}. Por exemplo, você poderia configurar um fluxo de trabalho para que sempre que um desenvolvedor fizesse push do código para um pull request, o fluxo de trabalho resolveria as dependências, fazendo o download e instalando pacotes hospedados pelo {% data variables.product.prodname_registry %}. Em seguida, o fluxo de trabalho pode executar testes de CI que exigem as dependências. +You can install packages as part of your CI flow using {% data variables.product.prodname_actions %}. For example, you could configure a workflow so that anytime a developer pushes code to a pull request, the workflow resolves dependencies by downloading and installing packages hosted by {% data variables.product.prodname_registry %}. Then, the workflow can run CI tests that require the dependencies. -Installing packages hosted by {% data variables.product.prodname_registry %} through {% data variables.product.prodname_actions %} requires minimal configuration or additional authentication, by using the `GITHUB_TOKEN`. Data transfer is also free when an action installs a package. Para obter mais informações, consulte "[Sobre a cobrança do {% data variables.product.prodname_registry %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)". +Installing packages hosted by {% data variables.product.prodname_registry %} through {% data variables.product.prodname_actions %} requires minimal configuration or additional authentication when you use `GITHUB_TOKEN`.{% if currentVersion == "free-pro-team@latest" %} Data transfer is also free when an action installs a package. For more information, see "[About billing for {% data variables.product.prodname_registry %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)."{% endif %} {% if currentVersion == "free-pro-team@latest" %} -`GITHUB_TOKEN` não pode instalar pacotes a partir de qualquer repositório privado além do repositório onde a ação é executada. Atualmente, você não pode usar `GITHUB_TOKEN` para efetuar a autenticação no {% data variables.product.prodname_github_container_registry %}. +`GITHUB_TOKEN` cannot install packages from any private repository besides the repository where the action runs. You cannot currently use `GITHUB_TOKEN` to authenticate to {% data variables.product.prodname_github_container_registry %}. {% endif %} {% data reusables.package_registry.actions-configuration %} diff --git a/translations/pt-BR/content/rest/guides/basics-of-authentication.md b/translations/pt-BR/content/rest/guides/basics-of-authentication.md index 7675ad0b5091..c98da6906cb5 100644 --- a/translations/pt-BR/content/rest/guides/basics-of-authentication.md +++ b/translations/pt-BR/content/rest/guides/basics-of-authentication.md @@ -11,7 +11,6 @@ versions: --- - Nesta seção, vamos nos concentrar nos fundamentos da autenticação. Mais especificamente, Vamos criar um servidor no Ruby (usando [Sinatra][Sinatra]) que implementa o [fluxo web][webflow] de um aplicativo de várias maneiras diferentes. {% tip %} @@ -47,7 +46,9 @@ get '/' do end ``` -O seu ID de cliente e as chaves secretas de cliente vêm da [página de configuração do seu aplicativo][app settings]. Você **nunca,___ deve armazenar esses valores em {% data variables.product.product_name %} -- ou em qualquer outro lugar público, para esse caso. Recomendamos armazená-los como variáveis de ambiente [][about env vars]--que é exatamente o que fizemos aqui.

    +O seu ID de cliente e as chaves secretas de cliente vêm da [página de configuração do seu aplicativo][app settings]. Você **nunca __** armazene esses valores em +{% data variables.product.product_name %} ou qualquer outro lugar público para essa questão. Recomendamos armazená-los como +[Variáveis de ambiente][about env vars]--que é exatamente o que fizemos aqui. Em seguida, em _views/index.erb_, cole este conteúdo: @@ -105,7 +106,7 @@ Após uma autenticação de aplicativo bem-sucedida, o {% data variables.product #### Verificar os escopos concedidos -No futuro, os usuários poderão [editar os escopos que você solicitou][edit scopes post], e o seu aplicativo poderá ter menos acesso do que você originalmente pediu. Portanto, antes de fazer qualquer pedido com o token, você deve verificar os escopos que foram concedidos para o token pelo usuário. +Os usuários podem editar os escopos que você solicitou alterando diretamente a URL. Isso pode conceder ao seu aplicativo menos acesso do que o que você solicitou originalmente. Antes de fazer qualquer solicitação com o token, verifique os escopos que foram concedidos para o token pelo usuário. Para obter mais informações sobre escopos solicitados e concedidos, consulte "[Escopos para aplicativos OAuth](/developers/apps/scopes-for-oauth-apps#requested-scopes-and-granted-scopes)". Os escopos que foram concedidos são retornados como parte da resposta da troca de um token. @@ -127,7 +128,7 @@ Além disso, uma vez que existe uma relação hierárquica entre os escopos, voc Verificar escopos apenas antes de fazer solicitações não é suficiente, já que é possível que os usuários mudem os escopos entre a sua verificação e a solicitação real. Caso isso aconteça, as chamadas par a API que você espera ter sucesso podem falhar com o status `404` ou `401` ou retornar um subconjunto diferente de informações. -Para ajudá-lo a gerenciar essas situações facilmente, todas as respostas da API para solicitações feitas com tokens válidos também contêm um [`cabeçalho de ` X-OAuth-Scopes][oauth scopes]. Este cabeçalho contém a lista de escopos do token que foi usado para fazer a solicitação. Além disso, a API dos aplicativos OAuth fornece um ponto de extremidade para {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} \[verificar a validade de um token\]\[/v3/apps/oauth_applications/#check-a-token\]{% else %}\[check a token for validity\]\[/v3/apps/oauth_applications/#check-an-authorization\]{% endif %}. Use esta informação para detectar alterações no escopo do token e informar os seus usuários sobre mudanças nas funcionalidades do aplicativo disponível. +Para ajudá-lo a gerenciar essas situações facilmente, todas as respostas da API para solicitações feitas com tokens válidos também contêm um [`cabeçalho de ` X-OAuth-Scopes][oauth scopes]. Este cabeçalho contém a lista de escopos do token que foi usado para fazer a solicitação. Além disso, a API de aplicativos OAuth fornece um ponto de extremidade para {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 9" %} \[verifique se há validez de token\]\[/v3/apps/oauth_applications/#check-a-token\]{% else %}\[verifique se há validade de token\]\[/v3/apps/oauth_applications/#check-an-authorization\]{% endif %}. Use esta informação para detectar alterações no escopo do token e informar os seus usuários sobre mudanças nas funcionalidades do aplicativo disponível. #### Fazer solicitações autenticadas @@ -171,8 +172,9 @@ Podemos fazer o que quisermos com os nossos resultados. Nesse caso, vamos simple Seria um modelo muito ruim se exigíssemos que os usuários se conectassem ao aplicativo todas as vezes que eles precisassem para acessar a página web. Por exemplo, tente acessar diretamente `http://localhost:4567/basic`. Você receberá uma mensagem de erro. -E se pudéssemos contornar todo o processo de "clique aqui", e apenas nos _lembrássemos_ disso, sempre que o usuário fizesse login em -{% data variables.product.product_name %}, podendo, assim, acessar o aplicativo? Segure-se, porque _isso é exatamente o que vamos fazer_. +E se pudéssemos contornar todo o processo de "clique aqui", e apenas _lembrar-se_ disso, enquanto o usuário estiver conectado +{% data variables.product.product_name %}, devem conseguir acessar este aplicativo? Espere um pouco, +porque _é exatamente o que vamos fazer_. Nosso pequeno servidor acima é bastante simples. Para inserir um tipo de autenticação inteligente, vamos alternar para o uso de sessões para armazenar tokens. Isto tornará a autenticação transparente para o usuário. @@ -296,12 +298,10 @@ Além disso, se nunca tivéssemos autorizado este aplicativo a acessar nossos da [webflow]: /apps/building-oauth-apps/authorizing-oauth-apps/ [Sinatra]: http://www.sinatrarb.com/ [about env vars]: http://en.wikipedia.org/wiki/Environment_variable#Getting_and_setting_environment_variables -[about env vars]: http://en.wikipedia.org/wiki/Environment_variable#Getting_and_setting_environment_variables [Sinatra guide]: https://github.com/sinatra/sinatra-book/blob/master/book/Introduction.markdown#hello-world-application [REST Client]: https://github.com/archiloque/rest-client [libraries]: /libraries/ [oauth scopes]: /apps/building-oauth-apps/understanding-scopes-for-oauth-apps/ [oauth scopes]: /apps/building-oauth-apps/understanding-scopes-for-oauth-apps/ -[edit scopes post]: https://developer.github.com/changes/2013-10-04-oauth-changes-coming/ [new oauth app]: https://github.com/settings/applications/new [app settings]: https://github.com/settings/developers diff --git a/translations/pt-BR/content/rest/guides/best-practices-for-integrators.md b/translations/pt-BR/content/rest/guides/best-practices-for-integrators.md index ac5f48b8bce2..68f1fc026b23 100644 --- a/translations/pt-BR/content/rest/guides/best-practices-for-integrators.md +++ b/translations/pt-BR/content/rest/guides/best-practices-for-integrators.md @@ -12,7 +12,6 @@ versions: Interessado em integrar-se à plataforma do GitHub? [Você está em boas mãos](https://github.com/integrations). Este guia ajudará você a construir um aplicativo que fornece a melhor experiência para seus usuários *e* garantir que interaja, de modo confiável, com a API. - ### Garante cargas seguras entregues a partir do GitHub É muito importante que você assegure [as cargas enviadas pelo GitHub][event-types]. Embora nenhuma informação pessoal (como senha) seja transmitida em uma carga, não é bom vazar *quaisquer informações*. Algumas informações que podem ser sensíveis incluem endereços de e-mail do committer ou os nomes de repositórios privados. @@ -25,11 +24,11 @@ Há várias etapas que você pode dar para garantir o recebimento de cargas entr ### Favoreça o trabalho assíncrono em detrimento do trabalho síncrono -O GitHub espera que as integrações respondam dentro de {% if currentVersion == "free-pro-team@latest" %}10{% else %}30{% endif %} segundos após receber a carga do webhook. Se o seu serviço demorar mais do que isso para ser concluído, o GitHub encerrará a conexão e a carga será perdida. +O GitHub espera que as integrações respondam dentro de {% if currentVersion == "free-pro-team@latest" %}10{% else %}30{% endif %} segundos para receber a carga do webhook. Se o seu serviço demorar mais do que isso para ser concluído, o GitHub encerrará a conexão e a carga será perdida. Como é impossível prever a rapidez com que o seu serviço será concluído, você deve fazer todo o "trabalho real" em um trabalho que atue em segundo plano. [Resque](https://github.com/resque/resque/) (para Ruby), [RQ](http://python-rq.org/) (para Python) ou [RabbitMQ](http://www.rabbitmq.com/) (para Java) são exemplos de bibliotecas que podem lidar com a fila e o processamento de trabalhos em segundo plano. -Observe que, mesmo com um trabalho em segundo plano, o GitHub ainda espera que seu servidor responda no prazo de {% if currentVersion == "free-pro-team@latest" %}dez{% else %}trinta{% endif %} segundos. Seu servidor precisa reconhecer que recebeu a carga enviando algum tipo de resposta. É fundamental que o seu serviço realize qualquer validação em uma carga o mais rápido possível para que você possa relatar com precisão se o seu servidor irá continuar com a solicitação ou não. +Observe que mesmo com um trabalho em segundo plano em andamento, o GitHub ainda espera que o seu servidor responda dentro de {% if currentVersion == "free-pro-team@latest" %}dez{% else %}trinta{% endif %} segundos. Seu servidor precisa reconhecer que recebeu a carga enviando algum tipo de resposta. É fundamental que o seu serviço realize qualquer validação em uma carga o mais rápido possível para que você possa relatar com precisão se o seu servidor irá continuar com a solicitação ou não. ### Use códigos de status de HTTP apropriados ao responder ao GitHub diff --git a/translations/pt-BR/content/rest/guides/delivering-deployments.md b/translations/pt-BR/content/rest/guides/delivering-deployments.md index fcd779007cc1..a201ffa74048 100644 --- a/translations/pt-BR/content/rest/guides/delivering-deployments.md +++ b/translations/pt-BR/content/rest/guides/delivering-deployments.md @@ -12,7 +12,7 @@ versions: -A [API de Implantações][deploy API] fornece seus projetos hospedados em {% data variables.product.product_name %} com a capacidade de lançá-los em um servidor do qual você é proprietário. Combinado com [a API de Status][status API], você poderá coordenar suas implantações no momento em que seu código chegar a `mestre`. +A [API de Implantações][deploy API] fornece seus projetos hospedados em {% data variables.product.product_name %} com a capacidade de lançá-los em um servidor do qual você é proprietário. Combinado com [a API de Status][status API], você será capaz de coordenar suas implantações no momento em que seu código chegar ao branch-padrão. Este guia usará a API para demonstrar uma configuração que você pode usar. No nosso cenário, iremos: diff --git a/translations/pt-BR/content/rest/guides/getting-started-with-the-checks-api.md b/translations/pt-BR/content/rest/guides/getting-started-with-the-checks-api.md index a512e9e447b6..f6a5339f05ed 100644 --- a/translations/pt-BR/content/rest/guides/getting-started-with-the-checks-api.md +++ b/translations/pt-BR/content/rest/guides/getting-started-with-the-checks-api.md @@ -37,8 +37,8 @@ Uma execução de verificação é um teste individual que faz parte de um conju ![Fluxo de trabalho das execuções de verificação](/assets/images/check_runs.png) {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -Se uma execução de verificação estiver em um estado incompleto por mais de 14 dias, a execução de verificação `conclusão` irá tornar-se `obsoleta` e será exibida em {% data variables.product.prodname_dotcom %} como obsoleto com -{% octicon "issue-reopened" aria-label="The issue-reopened icon" %}. Somente {% data variables.product.prodname_dotcom %} pode marcar a execuções de verificação como `obsoleto`. Para obter mais informações sobre possíveis conclusões de uma execução de verificação, consulte o parâmetro [`conclusão`](/rest/reference/checks#create-a-check-run--parameters). +Se uma execução de verificação estiver em um estado incompleto por mais de 14 dias, a execução de verificação `conclusão` torna-se `obsoleta` e aparece em +{% data variables.product.prodname_dotcom %} como obsoleto com {% octicon "issue-reopened" aria-label="The issue-reopened icon" %}. Somente {% data variables.product.prodname_dotcom %} pode marcar a execuções de verificação como `obsoleto`. Para obter mais informações sobre possíveis conclusões de uma execução de verificação, consulte o parâmetro [`conclusão`](/rest/reference/checks#create-a-check-run--parameters). {% endif %} Assim que você receber o webhook de [`check_suite`](/webhooks/event-payloads/#check_suite), você poderá criar a execução de verificação, mesmo que a verificação não esteja completa. Você pode atualizar o `status` da execução de verificação, pois ele é completado com os valores de `queued`, `in_progress` ou `completed`, e você poderá atualizar a saída de `` conforme mais informações forem disponibilizadas. Uma verificação de execução pode conter registros de hora, um link para obter mais informações sobre o seu site externo, anotações detalhadas para linhas específicas de código, e informações sobre a análise realizada. diff --git a/translations/pt-BR/content/rest/guides/getting-started-with-the-git-database-api.md b/translations/pt-BR/content/rest/guides/getting-started-with-the-git-database-api.md index d8ebf93ae140..f444f860a077 100644 --- a/translations/pt-BR/content/rest/guides/getting-started-with-the-git-database-api.md +++ b/translations/pt-BR/content/rest/guides/getting-started-with-the-git-database-api.md @@ -32,14 +32,14 @@ Pode parecer complexo, mas, na verdade, é bem simples. Ao entender o modelo e e {% warning %} -**Aviso!** Não dependa do uso do Git diretamente ou {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}[`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference){% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}[`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference){% endif %} para atualizações das referências de `merge` do Git, pois este conteúdo fica desatualizado sem aviso. +**Aviso!**Não dependa do uso do Git diretamente ou de [`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference) para atualizações para fazer `merge` de refs do Git, pois este conteúdo fica desatualizado sem aviso prévio. {% endwarning %} Uma API consumível precisa solicitar explicitamente que um pull request crie um commit de merge de _teste_. Um commit de merge de _teste_ é criado quando você visualiza o pull request na interface do usuário e o botão "Merge" é exibido, ou quando [obtém](/v3/pulls/#get-a-pull-request), [cria](/v3/pulls/#create-a-pull-request), ou [edita](/v3/pulls/#update-a-pull-request) um pull request usando a API REST. Sem esta solicitação, as referências de `merge` do Git ficarão desatualizadas até a próxima vez que alguém visualizar o pull request. -Se você estiver usando métodos de sondagem que produzem referências obsoletas de `merge` do Git, o GitHub recomenda seguir as etapas a seguir para obter as últimas alterações do branch-base (geralmente `mestre`): +Se você está usando métodos de sondagem que produzem refs do Git de `merge` obsoletos, o GitHub recomenda usar as etapas a seguir para obter as últimas alterações do branch-padrão: 1. Receber o webhook do pull request. 2. Chame [`GET /repos/{owner}/{repo}/pulls/{pull_number}`](/v3/pulls/#get-a-pull-request) para iniciar um trabalho em segundo plano para criar o candidato de do commit do merge. -3. Faça a sondam do seu repositório usando [`GET /repos/{owner}/{repo}/pulls/{pull_number}`](/v3/pulls/#get-a-pull-request) para ver se o atributo `mesclável` é `verdadeiro` ou `falso`. Você pode usar o Git diretamente ou {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}[`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference){% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}[`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference){% endif %} para atualizações para as referências de `merge` do Git depois de realizar as etapas anteriores. +3. Faça a sondam do seu repositório usando [`GET /repos/{owner}/{repo}/pulls/{pull_number}`](/v3/pulls/#get-a-pull-request) para ver se o atributo `mesclável` é `verdadeiro` ou `falso`. Você pode usar o Git diretamente ou [`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference) para atualizações para fazer `merge` das refs do Git apenas após executar as etapas anteriores. diff --git a/translations/pt-BR/content/rest/guides/getting-started-with-the-rest-api.md b/translations/pt-BR/content/rest/guides/getting-started-with-the-rest-api.md index f05c59abc1bb..730c36fc9386 100644 --- a/translations/pt-BR/content/rest/guides/getting-started-with-the-rest-api.md +++ b/translations/pt-BR/content/rest/guides/getting-started-with-the-rest-api.md @@ -10,14 +10,13 @@ versions: --- - Vamos andar pelos conceitos básicos da API, à medida que abordamos alguns casos de uso diário. ### Visão Geral A maioria dos aplicativos usará uma [biblioteca de segurança][wrappers] existente na linguagem da sua escolha, mas é importante familiarizar-se primeiro com os métodos HTTP e de API subjacentes. -Não há uma maneira mais fazê-lo do que através do [cURL][curl].{% if currentVersion == "free-pro-team@latest" %} Se você estiver usando um cliente alternativo, observe que você será obrigado a enviar um [cabeçalho do agente de usuário](/rest/overview/resources-in-the-rest-api#user-agent-required) válido na sua solicitação.{% endif %} +Não há uma maneira mais fácil dar os primeiros passos do que através do [cURL][curl]. {% if currentVersion == "free-pro-team@latest" %} Se você estiver usando um cliente alternativo, observe que você deve enviar um [cabeçalho do Agente de Usuário](/rest/overview/resources-in-the-rest-api#user-agent-required) válido na sua solicitação.{% endif %} #### Hello World @@ -194,7 +193,9 @@ Neste exemplo, pegamos apenas os repositórios que o octocat possui, não os nos #### Criar um repositório -Buscar informações para repositórios existentes é um caso de uso comum, mas a API de {% data variables.product.product_name %} também é compatível com a criação de novos repositórios. Para [criar um repositório][create repo], precisamos `POST` alguns JSON que contenham as informações e opções de configuração. +Buscar informações para repositórios existentes é um caso de uso comum, mas a +API de {% data variables.product.product_name %} também é compatível com a criação de novos repositórios. Para [criar um repositório][create repo], +precisamos `POST` alguns JSON que contém informações e opções de configuração. ```shell $ curl -i -H "Authorization: token 5199831f4dd3b79e7c5b7e0ebe75d67aa66e79d4" \ diff --git a/translations/pt-BR/content/rest/overview/api-previews.md b/translations/pt-BR/content/rest/overview/api-previews.md index 1949cc23ecb0..02037b51e71e 100644 --- a/translations/pt-BR/content/rest/overview/api-previews.md +++ b/translations/pt-BR/content/rest/overview/api-previews.md @@ -10,7 +10,6 @@ versions: --- - Pré-visualizações da API permitem que você experimente novas APIs e alterações nos métodos de API existentes antes de se tornarem parte da API oficial do GitHub. Durante o período de pré-visualização, poderemos alterar alguns recursos com base no feedback do desenvolvedor. Se fizermos alterações, iremos anunciá-las no [blogue do desenvolvedor](https://developer.github.com/changes/) sem aviso prévio. @@ -27,7 +26,7 @@ Permite que você faça o download de repositórios da conta do usuário ou da o ### Implementações aprimoradas -Exerça um maior controle sobre as [implantações](/v3/repos/deployments/) com mais informações e uma granularidade mais precisa. +Exerça um maior controle sobre as [implantações](/rest/reference/repos#deployments) com mais informações e uma granularidade mais precisa. **Tipo de mídia personalizada:** `ant-man-preview` **Anunciado em:** [2016-04-06](https://developer.github.com/changes/2016-04-06-deployment-and-deployment-status-enhancements/) @@ -46,17 +45,6 @@ Obter uma [lista de eventos](/v3/issues/timeline/) para um problema ou pull requ **Tipo de mídia personalizada:** `mockingbird-preview` **Anunciado em:** [2016-05-23](https://developer.github.com/changes/2016-05-23-timeline-preview-api/) -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} - - -### Pages - -Obtenha mais informações sobre o site do [GitHub Pages](/v3/repos/pages/). - -**Tipo de mídia personalizada:** `mister-fantastic-preview` **Anunciado em:** [2016-07-06](https://developer.github.com/changes/2016-07-06-github-pages-preview-api/) - -{% endif %} - {% if currentVersion != "free-pro-team@latest" %} @@ -150,9 +138,9 @@ Inclua o conteúdo aninhado das cargas da [equipe](/v3/teams/). ### Webhooks globais -Habilita [webhooks globais](/v3/enterprise-admin/global_webhooks/) para [organizações](/webhooks/event-payloads/#organization) e tipos de evento do [usuário](/webhooks/event-payloads/#user). Esta visualização da API só está disponível para {% data variables.product.prodname_ghe_server %}. +Habilita [webhooks globais](/rest/reference/enterprise-admin#global-webhooks/) para [organizações](/webhooks/event-payloads/#organization) e tipos de evento do [usuário](/webhooks/event-payloads/#user). Esta visualização da API só está disponível para {% data variables.product.prodname_ghe_server %}. -**Tipo de mídia personalizada:** `superpro-preview` **Anunciado em:** [2017-12-12](/v3/enterprise-admin/global_webhooks) +**Tipo de mídia personalizada:** `superpro-preview` **Anunciado em:** [2017-12-12](/rest/reference/enterprise-admin#global-webhooks) {% endif %} @@ -178,17 +166,6 @@ Agora você pode adicionar um motivo ao[bloquear um problema](/v3/issues/#lock-a {% endif %} -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} - - -### Discussões de equipe - -Agora você pode usar a API para gerenciar [as discussões de equipe](/v3/teams/discussions) e [comentários de discussão de equipe](/v3/teams/discussion_comments). - -**Tipo de mídia personalizada:** `echo-preview` **Anunciado em:** [2018-02-07](https://developer.github.com/changes/2018-02-07-team-discussions-api) - -{% endif %} - ### Exigir commits assinados @@ -216,13 +193,16 @@ Recuperar informações do [hovercard de alguém](/v3/users/#get-contextual-info {% endif %} +{% if currentVersion ver_lt "enterprise-server@2.23" %} ### Verificar execuções e a API de conjuntos de verificações Permite que um aplicativo GitHub execute verificações externas no código de um repositório. Veja as [execuções de verificação](/v3/checks/runs/) e [Conjuntos de verificação](/v3/checks/suites/) das APIs para obter mais informações. -**Tipo de mídia personalizada:** `antiope-preview` **Anunciado:** [2018-05-07](https://developer.github.com/changes/2018-05-07-new-checks-api-public-beta/) +**Tipo de mídia personalizada:** `antiope-preview` **Anunciado:** [2018-05-07](https://developer.github.com/changes/2018-05-07-new-checks-api-public-beta/) + +{% endif %} {% if currentVersion != "free-pro-team@latest" %} @@ -260,7 +240,7 @@ Os manifestos do aplicativo GitHub permitem que pessoas criem aplicativos GitHub ### Status da implantação -Agora você pode atualizar o ambiente `` de um [status de implantação](/v3/repos/deployments/#create-a-deployment-status) e usar os estados `in_progress` e `na fila`. Ao criar o status da implantação, agora você pode usar o parâmetro `auto_inactive` para marcar implantações de `produção` antigas como `inativa`. +Agora você pode atualizar o ambiente `` de um [status de implantação](/rest/reference/repos#create-a-deployment-status) e usar os estados `in_progress` e `na fila`. Ao criar o status da implantação, agora você pode usar o parâmetro `auto_inactive` para marcar implantações de `produção` antigas como `inativa`. **Tipo de mídia personalizada:** `flash-preview` **Anunciado:** [2018-10-16](https://developer.github.com/changes/2018-10-16-deployments-environments-states-and-auto-inactive-updates/) @@ -307,7 +287,7 @@ Você pode usar a API do Pull Requests de rascunho e seus pontos de extremidade ### Habilitar e desabilitar páginas -Você pode usar os novos pontos de extremidade no [API de páginas](/v3/repos/pages/) para habilitar ou desabilitar páginas. Para saber mais sobre páginas, consulte "[Princípios básicos do GitHub Pages](/categories/github-pages-basics)". +Você pode usar os novos pontos de extremidade no [API de páginas](/rest/reference/repos#pages) para habilitar ou desabilitar páginas. Para saber mais sobre páginas, consulte "[Princípios básicos do GitHub Pages](/categories/github-pages-basics)". **Tipos de mídia personalizada:** `switcheroo-preview` **Anunciado:** [2019-03-14](https://developer.github.com/changes/2019-03-14-enabling-disabling-pages/) diff --git a/translations/pt-BR/content/rest/overview/endpoints-available-for-github-apps.md b/translations/pt-BR/content/rest/overview/endpoints-available-for-github-apps.md index e8639b9bed03..b9abf9b11919 100644 --- a/translations/pt-BR/content/rest/overview/endpoints-available-for-github-apps.md +++ b/translations/pt-BR/content/rest/overview/endpoints-available-for-github-apps.md @@ -11,7 +11,7 @@ versions: Você deve usar um token de acesso da instalação para acessar os pontos de extremidade usando seu {% data variables.product.prodname_github_app %}. Para obter mais informações, consulte "[Efetuando a autenticação com o {% data variables.product.prodname_github_apps %}](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)". -{% for thing in rest.operationsEnabledForApps[currentVersion] %} +{% for thing in rest.operationsEnabledForGitHubApps[currentVersion] %} {% assign category = thing[0] %} {% assign operations = thing[1] %} {% if operations.size > 0 %} diff --git a/translations/pt-BR/content/rest/overview/other-authentication-methods.md b/translations/pt-BR/content/rest/overview/other-authentication-methods.md index 0914e272d889..ed9d587237bd 100644 --- a/translations/pt-BR/content/rest/overview/other-authentication-methods.md +++ b/translations/pt-BR/content/rest/overview/other-authentication-methods.md @@ -9,9 +9,9 @@ versions: --- - -Embora a API forneça vários métodos para autenticação, é altamente recomendável usar [OAuth](/apps/building-integrations/setting-up-and-registering-oauth-apps/) para aplicativos de produção. Os outros métodos fornecidos destinam-se a ser usados para scripts ou testes (ou seja, casos em que o OAuth completo seria exagerado). Os aplicativos de terceiros que dependem de -{% data variables.product.product_name %} para autenticação não devem pedir ou coletar credenciais de {% data variables.product.product_name %}. Em vez disso, eles devem usar o [Fluxo web do OAuth](/apps/building-oauth-apps/authorizing-oauth-apps/). +Embora a API forneça vários métodos para autenticação, é altamente recomendável usar [OAuth](/apps/building-integrations/setting-up-and-registering-oauth-apps/) para aplicativos de produção. Os outros métodos fornecidos destinam-se a ser usados para scripts ou testes (ou seja, casos em que o OAuth completo seria exagerado). Aplicativos de terceiros que dependem de +{% data variables.product.product_name %} para autenticação não devem pedir ou coletar credenciais de {% data variables.product.product_name %}. +Em vez disso, eles devem usar o [Fluxo web do OAuth](/apps/building-oauth-apps/authorizing-oauth-apps/). ### Autenticação básica @@ -78,7 +78,7 @@ O valor das `organizações` é uma lista de ID de organizações separada por v Quando você tem a autenticação de dois fatores habilitada, a [Autenticação básica](#basic-authentication) para _a maioria dos_ pontos de extremidade na API REST exige que você use um token de acesso pessoal ou token do OAuth em vez de seu nome de usuário e senha. -Você pode gerar um novo token de acesso pessoal {% if currentVersion == "free-pro-team@latest" %}com [{% data variables.product.product_name %} configurações de desenvolvedor](https://github.com/settings/tokens/new){% endif %} ou usar o ponto de extremidade "[Criar um uma nova autorização][create-access]" na API de Autorização do OAuth para gerar um novo token do OAuth. Para obter mais informações, consulte "[Criar um token de acesso pessoal para a linha de comando](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)". Em seguida, você usaria esses tokens para [efetuar a autenticação usando o token do OAuth][oauth-auth] com a API do GitHub. A única vez que você precisa efetuar a autenticação com seu nome de usuário e senha é quando você cria seu token do OAuth ou usa a API de Autorização do OAuth. +Você pode gerar um novo token de acesso pessoal {% if currentVersion == "free-pro-team@latest" %}com [configurações do desenvolvedor de {% data variables.product.product_name %}](https://github.com/settings/tokens/new){% endif %} ou usar o ponto de extremidade [Criar uma nova autorização][create-access]" na API de Autorização do OAuth para gerar um novo token do OAuth. Para obter mais informações, consulte "[Criar um token de acesso pessoal para a linha de comando](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)". Em seguida, você usaria esses tokens para [efetuar a autenticação usando o token do OAuth][oauth-auth] com a API do GitHub. A única vez que você precisa efetuar a autenticação com seu nome de usuário e senha é quando você cria seu token do OAuth ou usa a API de Autorização do OAuth. #### Usar a API de Autorização do OAuth com autenticação de dois fatores diff --git a/translations/pt-BR/content/rest/overview/resources-in-the-rest-api.md b/translations/pt-BR/content/rest/overview/resources-in-the-rest-api.md index d2cec773631c..fe23827fea9b 100644 --- a/translations/pt-BR/content/rest/overview/resources-in-the-rest-api.md +++ b/translations/pt-BR/content/rest/overview/resources-in-the-rest-api.md @@ -11,7 +11,6 @@ versions: Isso descreve os recursos que formam a API REST oficial de {% data variables.product.product_name %}. Em caso de problema ou solicitação, entre em contato com {% data variables.contact.contact_support %}. - ### Versão atual Por padrão, todas as solicitações para `{% data variables.product.api_url_code %}` recebem a versão **v3** [](/v3/versions) da API REST. Nós incentivamos que você a [solicite explicitamente esta versão por meio do cabeçalho `Aceitar`](/v3/media/#request-specific-version). @@ -26,7 +25,7 @@ Para obter informações sobre a API do GraphQL do GitHub, consulte a [documenta ### Esquema -{% if currentVersion == "free-pro-team@latest" %}Todo acesso à API é feito por meio de HTTPS, e{% else %}a API é{% endif %} acessada a partir de `{% data variables.product.api_url_code %}`. Todos os dados são +{% if currentVersion == "free-pro-team@latest" %}Todo o acesso à API é feito por meio de HTTPS, e{% else %}A API é{% endif %} acessada a partir de `{% data variables.product.api_url_code %}`. Todos os dados são enviados e recebidos como JSON. ```shell @@ -36,7 +35,6 @@ $ curl -i {% data variables.product.api_url_pre %}/users/octocat/orgs > Server: nginx > Date: Fri, 12 Oct 2012 23:33:14 GMT > Content-Type: application/json; charset=utf-8 -> Connection: keep-alive > Status: 200 OK > ETag: "a00049ba79152d03380c34652f2cb612" > X-GitHub-Media-Type: github.v3 @@ -107,20 +105,20 @@ Leia [mais sobre o OAuth2](/apps/building-oauth-apps/). Observe que os tokens d curl -u my_client_id:my_client_secret '{% data variables.product.api_url_pre %}/user/repos' ``` -Usar o seu `client_id` e `client_secret` _ não_ autenticam você como usuário. Isso apenas irá identificar o seu aplicativo OAuth para aumentar o seu limite de taxa. Permissions are only granted to users, not applications, and you will only get back data that an unauthenticated user would see. For this reason, you should only use the OAuth2 key/secret in server-to-server scenarios. Don't leak your OAuth application's client secret to your users. +Usar o seu `client_id` e `client_secret` _ não_ autenticam você como usuário. Isso apenas irá identificar o seu aplicativo OAuth para aumentar o seu limite de taxa. As permissões só são concedidas a usuários, não aplicativos, e você só obterá dados que um usuário não autenticado visualizaria. Por este motivo, você só deve usar a chave/segredo OAuth2 em cenários de servidor para servidor. Não compartilhe o segredo do cliente do aplicativo OAuth com os seus usuários. {% if currentVersion != "free-pro-team@latest" %} -You will be unable to authenticate using your OAuth2 key and secret while in private mode, and trying to authenticate will return `401 Unauthorized`. For more information, see "[Enabling private mode](/enterprise/admin/installation/enabling-private-mode)". +Você não conseguirá efetuar a autenticação usando sua chave e segredo do OAuth2 enquanto estiver no modo privado e essa tentativa de autenticação irá retornar `401 Unauthorized`. Para obter mais informações, consulte "[Habilitar o modo privado](/enterprise/admin/installation/enabling-private-mode)". {% endif %} {% if currentVersion == "free-pro-team@latest" %} -Read [more about unauthenticated rate limiting](#increasing-the-unauthenticated-rate-limit-for-oauth-applications). +Leia [Mais informações sobre limitação da taxa não autenticada](#increasing-the-unauthenticated-rate-limit-for-oauth-applications). {% endif %} -#### Failed login limit +#### Falha no limite de login -Authenticating with invalid credentials will return `401 Unauthorized`: +A autenticação com credenciais inválidas retornará `401 Unauthorized`: ```shell $ curl -i {% data variables.product.api_url_pre %} -u foo:bar @@ -132,7 +130,7 @@ $ curl -i {% data variables.product.api_url_pre %} -u foo:bar > } ``` -After detecting several requests with invalid credentials within a short period, the API will temporarily reject all authentication attempts for that user (including ones with valid credentials) with `403 Forbidden`: +Após detectar várias solicitações com credenciais inválidas em um curto período de tempo, a API rejeitará temporariamente todas as tentativas de autenticação para esse usuário (incluindo aquelas com credenciais válidas) com `403 Forbidden`: ```shell $ curl -i {% data variables.product.api_url_pre %} -u valid_username:valid_password @@ -146,15 +144,15 @@ $ curl -i {% data variables.product.api_url_pre %} -u valid_username:valid_passw ### Parâmetros -Many API methods take optional parameters. For `GET` requests, any parameters not specified as a segment in the path can be passed as an HTTP query string parameter: +Muitos métodos de API tomam parâmetros opcionais. Para solicitações tipo `GET`, todos os parâmetros não especificados como um segmento no caminho podem ser passados como um parâmetro de string de consulta de HTTP: ```shell $ curl -i "{% data variables.product.api_url_pre %}/repos/vmg/redcarpet/issues?state=closed" ``` -In this example, the 'vmg' and 'redcarpet' values are provided for the `:owner` and `:repo` parameters in the path while `:state` is passed in the query string. +Neste exemplo, os valores 'vmg' e 'redcarpet' são fornecidos para os parâmetros `:owner` e `:repo` no caminho enquanto `:state` é passado na string da consulta. -For `POST`, `PATCH`, `PUT`, and `DELETE` requests, parameters not included in the URL should be encoded as JSON with a Content-Type of 'application/json': +Para solicitações de `POST`, `PATCH`, `PUT`e `EXCLUIR`, os parâmetros não incluídos na URL devem ser codificados como JSON com um Content-Type de 'application/json': ```shell $ curl -i -u username -d '{"scopes":["public_repo"]}' {% data variables.product.api_url_pre %}/authorizations @@ -162,7 +160,7 @@ $ curl -i -u username -d '{"scopes":["public_repo"]}' {% data variables.product. ### Ponto de extremidade raiz -You can issue a `GET` request to the root endpoint to get all the endpoint categories that the REST API supports: +Você pode emitir uma solicitação `GET` para o ponto de extremidade de raiz para obter todas as categorias do ponto de extremidade com a qual a API REST é compatível: ```shell $ curl {% if currentVersion != "free-pro-team@latest" %}-u username:password {% endif %}{% data variables.product.api_url_pre %} @@ -172,66 +170,72 @@ $ curl {% if currentVersion != "free-pro-team@latest" %}-u username:400 Bad Request`.

    + +
     HTTP/1.1 400 Bad Request
+ Content-Length: 35
+
+ {"message":"Problems parsing JSON"}
+`
    + +2 + +Enviar o tipo incorreto de valores do JSON resultará em uma resposta `400 Bad +Request`. + + HTTP/1.1 400 Bad Request + Content-Length: 40 + + {"message":"Body should be a JSON object"} + +3 + +O envio de campos inválidos resultará em uma resposta `422 Unprocessable Entity`. + + HTTP/1.1 422 Unprocessable Entity + Content-Length: 149 + + { + "message": "Validation Failed", + "errors": [ + { + "resource": "Issue", + "field": "title", + "code": "missing_field" + } + ] + } + + +Todos objetos de erro têm propriedades de recurso e campo para que seu cliente possa dizer qual é o problema. Também há um código de erro para informar o que há de errado com o campo. Estes são os possíveis códigos de validação: + +| Nome do código de erro | Descrição | +| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | +| `missing` | Um recurso não existe. | +| `missing_field` | Não foi definido um campo obrigatório em um recurso. | +| `invalid` | Formatação de um campo é inválida. Revise a documentação para obter informações mais específicas. | +| `already_exists` | Outro recurso tem o mesmo valor que este campo. Isso pode acontecer em recursos que precisam ter alguma chave única (como nomes de etiqueta). | +| `unprocessable` | As entradas fornecidas eram inválidas. | + +Os recursos também podem enviar erros de validação personalizados (em que o `código` é `personalizado`). Os erros personalizados sempre terão um campo de `mensagem` que descreve o erro e a maioria dos erros também incluirá um campo de `documentation_url` que aponta para algum conteúdo que pode ajudá-lo a resolver o erro. + +### Redirecionamentos HTTP + +API v3 usa redirecionamento HTTP quando apropriado. Os clientes devem assumir que qualquer solicitação pode resultar em redirecionamento. Receber um redirecionamento de HTTP *não* é um erro e os clientes devem seguir esse redirecionamento. As respostas de redirecionamento terão um campo do cabeçalho do tipo `Localização` que contém o URI do recurso ao qual o cliente deve repetir as solicitações. | Código de status | Descrição | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -300,30 +304,30 @@ Este `Link` de resposta contém um ou mais links de relações de [hipermídia]( Os valores de `rel` possíveis são: -| Nome | Descrição | -| --------- | ------------------------------------------------------------- | -| `avançar` | A relação de link para a próxima página de resultados. | -| `last` | A relação de link para a última página de resultados. | -| `first` | The link relation for the first page of results. | -| `prev` | The link relation for the immediate previous page of results. | +| Nome | Descrição | +| --------- | ---------------------------------------------------------------- | +| `avançar` | A relação de link para a próxima página de resultados. | +| `last` | A relação de link para a última página de resultados. | +| `first` | A relação de link para a primeira página de resultados. | +| `prev` | A relação de link para a página de resultados anterior imediata. | -### Rate limiting +### Limite de taxa -For API requests using Basic Authentication or OAuth, you can make up to 5,000 requests per hour. Authenticated requests are associated with the authenticated user, regardless of whether [Basic Authentication](#basic-authentication) or [an OAuth token](#oauth2-token-sent-in-a-header) was used. This means that all OAuth applications authorized by a user share the same quota of 5,000 requests per hour when they authenticate with different tokens owned by the same user. +Para solicitações de API que usam a Autenticação Básica ou OAuth, você pode criar até 5.000 solicitações por hora. As solicitações de autenticação são associadas ao usuário autenticado, independentemente de [Autenticação Básica](#basic-authentication) ou [um token do OAuth](#oauth2-token-sent-in-a-header) ter sido usado. Isto significa que todos os aplicativos OAuth autorizados por um usuário compartilham a mesma cota de 5.000 solicitações por hora quando eles são autenticados com diferentes tokens pertencentes ao mesmo usuário. {% if currentVersion == "free-pro-team@latest" %} -For users that belong to a {% data variables.product.prodname_ghe_cloud %} account, requests made using an OAuth token to resources owned by the same {% data variables.product.prodname_ghe_cloud %} account have an increased limit of 15,000 requests per hour. +Para usuários que pertencem a uma conta {% data variables.product.prodname_ghe_cloud %}, solicitações feitas usando um token OAuth para recursos pertencentes à mesma conta de {% data variables.product.prodname_ghe_cloud %} têm um aumento de 15.000 solicitações por hora no limite. {% endif %} -For unauthenticated requests, the rate limit allows for up to 60 requests per hour. Unauthenticated requests are associated with the originating IP address, and not the user making requests. +Para solicitações não autenticadas, o limite de taxa permite até 60 solicitações por hora. Solicitações não autenticadas estão associadas ao endereço IP original, e não ao usuário que faz solicitações. {% data reusables.enterprise.rate_limit %} -Note that [the Search API has custom rate limit rules](/v3/search/#rate-limit). +Observe que [a API de pesquisa tem regras de limite de taxa personalizadas](/v3/search/#rate-limit). -The returned HTTP headers of any API request show your current rate limit status: +Os cabeçalhos HTTP retornados de qualquer solicitação de API mostram o seu status atual de limite de taxa: ```shell $ curl -i {% data variables.product.api_url_pre %}/users/octocat @@ -335,20 +339,20 @@ $ curl -i {% data variables.product.api_url_pre %}/users/octocat > X-RateLimit-Reset: 1372700873 ``` -| Header Name | Descrição | -| ----------------------- | ---------------------------------------------------------------------------------------------------------------------- | -| `X-RateLimit-Limit` | The maximum number of requests you're permitted to make per hour. | -| `X-RateLimit-Remaining` | The number of requests remaining in the current rate limit window. | -| `X-RateLimit-Reset` | The time at which the current rate limit window resets in [UTC epoch seconds](http://en.wikipedia.org/wiki/Unix_time). | +| Nome do Cabeçalho | Descrição | +| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | +| `X-RateLimit-Limit` | O número máximo de solicitações que você pode fazer por hora. | +| `X-RateLimit-Remaining` | O número de solicitações restantes na janela de limite de taxa atual. | +| `X-RateLimit-Reset` | O tempo em que a janela de limite de taxa atual é redefinida em [segundos no tempo de computação de UTC](http://en.wikipedia.org/wiki/Unix_time). | -If you need the time in a different format, any modern programming language can get the job done. For example, if you open up the console on your web browser, you can easily get the reset time as a JavaScript Date object. +Se você precisar de outro formato de tempo, qualquer linguagem de programação moderna pode fazer o trabalho. Por exemplo, se você abrir o console em seu navegador, você pode facilmente obter o tempo de redefinição como um objeto de tempo do JavaScript. ``` javascript new Date(1372700873 * 1000) // => Mon Jul 01 2013 13:47:53 GMT-0400 (EDT) ``` -If you exceed the rate limit, an error response returns: +Se você exceder o limite de taxa, uma resposta do erro retorna: ```shell > HTTP/1.1 403 Forbidden @@ -364,11 +368,11 @@ If you exceed the rate limit, an error response returns: > } ``` -You can [check your rate limit status](/v3/rate_limit) without incurring an API hit. +Você pode [verificar o status do seu limite de taxa](/v3/rate_limit) sem a incorrer em uma consulta da API. -#### Increasing the unauthenticated rate limit for OAuth applications +#### Aumentar o limite de taxa não autenticado para aplicativos OAuth -If your OAuth application needs to make unauthenticated calls with a higher rate limit, you can pass your app's client ID and secret before the endpoint route. +Se o seu aplicativo OAuth precisar fazer chamadas não autenticadas com um limite de taxa mais alto, você poderá passar o ID e o segredo do cliente do seu aplicativo antes do encaminhamento de pontos de extremidade. ```shell $ curl -u my_client_id:my_client_secret {% data variables.product.api_url_pre %}/user/repos @@ -382,21 +386,21 @@ $ curl -u my_client_id:my_client_secret {% data variables.product.api_url_pre %} {% note %} -**Note:** Never share your client secret with anyone or include it in client-side browser code. Use the method shown here only for server-to-server calls. +**Observação:** Nunca compartilhe seu segredo de cliente com alguém ou o inclua no código do navegador do lado do cliente. Use o método mostrado aqui apenas para chamadas de servidor para servidor. {% endnote %} -#### Staying within the rate limit +#### Manter-se dentro do limite de taxa -If you exceed your rate limit using Basic Authentication or OAuth, you can likely fix the issue by caching API responses and using [conditional requests](#conditional-requests). +Se você exceder seu limite de taxa usando a Autenticação Básica ou OAuth, você poderá corrigir o problema armazenando respostas da API e usando [solicitações condicionais](#conditional-requests). -#### Abuse rate limits +#### Abusar dos limites de taxa -In order to provide quality service on {% data variables.product.product_name %}, additional rate limits may apply to some actions when using the API. For example, using the API to rapidly create content, poll aggressively instead of using webhooks, make multiple concurrent requests, or repeatedly request data that is computationally expensive may result in abuse rate limiting. +A fim de fornecer serviço de qualidade no {% data variables.product.product_name %}, podem-se aplicar limites de taxa adicionais podem a algumas ações ao usar a API. Por exemplo, usar a API para criar rapidamente conteúdo, fazer sondagem de modo agressivo em vez de usar webhooks, fazer várias solicitações simultâneas ou solicitar repetidamente dados caros do ponto de vista computacional podem resultar na limitação da taxa de abuso. -Abuse rate limits are not intended to interfere with legitimate use of the API. Your normal rate limits should be the only limit you target. To ensure you're acting as a good API citizen, check out our [Best Practices guidelines](/guides/best-practices-for-integrators/). +O abuso dos limites de taxa não são destinados a interferir no uso legítimo da API. Seus limites de taxa normais devem ser o único limite em que você deve focar. Para garantir que você está agindo como um bom cidadão da API, confira nossas [Diretrizes sobre práticas recomendadas](/guides/best-practices-for-integrators/). -If your application triggers this rate limit, you'll receive an informative response: +Se seu aplicativo acionar este limite de taxa, você receberá uma resposta informativa: ```shell > HTTP/1.1 403 Forbidden @@ -411,9 +415,9 @@ If your application triggers this rate limit, you'll receive an informative resp {% if currentVersion == "free-pro-team@latest" %} -### User agent required +### Agente de usuário obrigatório -All API requests MUST include a valid `User-Agent` header. Requests with no `User-Agent` header will be rejected. We request that you use your {% data variables.product.product_name %} username, or the name of your application, for the `User-Agent` header value. Isso nos permite entrar em contato com você, em caso de problemas. +Todas as solicitações da API DEVEM incluir um cabeçalho válido de `User-Agent`. As requisições sem o cabeçalho do `User-Agent` serão rejeitadas. Pedimos que use seu nome de usuário de {% data variables.product.product_name %} ou o nome de seu aplicativo, para o valor do cabeçalho `User-Agent`. Isso nos permite entrar em contato com você, em caso de problemas. Aqui está um exemplo: @@ -438,13 +442,13 @@ $ curl -iH 'User-Agent: ' {% data variables.product.api_url_pre %}/meta ### Solicitações condicionais -A maioria das respostas retorna um cabeçalho de Etag`. Many responses also return a Last-Modified` header. You can use the values of these headers to make subsequent requests to those resources using the `If-None-Match` and `If-Modified-Since` headers, respectively. If the resource has not changed, the server will return a `304 Not Modified`. +A maioria das respostas retorna um cabeçalho de Etag`. Muitas respostas também retornam um cabeçalho Last-Modified`. Você pode usar os valores desses cabeçalhos para fazer solicitações subsequentes para esses recursos usando os cabeçalhos `If-None-Match` e `If-Modified-Desde`, respectivamente. Se o recurso não foi alterado, o servidor retornará `304 não modificado`. {% if currentVersion == "free-pro-team@latest" %} {% tip %} -**Note**: Making a conditional request and receiving a 304 response does not count against your [Rate Limit](#rate-limiting), so we encourage you to use it whenever possible. +**Observação**: Fazer uma solicitação condicional e receber uma resposta 304 não conta para o seu [Limite de Taxa](#rate-limiting). Portanto, recomendamos que você o utilize sempre que possível. {% endtip %} @@ -484,11 +488,11 @@ $ curl -i {% data variables.product.api_url_pre %}/user -H "If-Modified-Since: T > X-RateLimit-Reset: 1372700873 ``` -### Cross origin resource sharing +### Compartilhamento de recursos de origem cruzada A API é compatível com Compartilhamento de Recursos de Origens Cruzadas (CORS) para solicitações de AJAX de qualquer origem. You can read the [CORS W3C Recommendation](http://www.w3.org/TR/cors/), or [this intro](http://code.google.com/p/html5security/wiki/CrossOriginRequestSecurity) from the HTML 5 Security Guide. -Here's a sample request sent from a browser hitting `http://example.com`: +Aqui está uma solicitação de exemplo enviada a partir de uma consulta em `http://exemplo.com`: ```shell $ curl -i {% data variables.product.api_url_pre %} -H "Origin: http://example.com" @@ -497,7 +501,7 @@ Access-Control-Allow-Origin: * Access-Control-Expose-Headers: ETag, Link, X-GitHub-OTP, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, X-OAuth-Scopes, X-Accepted-OAuth-Scopes, X-Poll-Interval ``` -This is what the CORS preflight request looks like: +A solicitação pré-voo de CORS se parece com isso: ```shell $ curl -i {% data variables.product.api_url_pre %} -H "Origin: http://example.com" -X OPTIONS @@ -509,9 +513,9 @@ Access-Control-Expose-Headers: ETag, Link, X-GitHub-OTP, X-RateLimit-Limit, X-Ra Access-Control-Max-Age: 86400 ``` -### JSON-P callbacks +### Chamadas de retorno do JSON-P -You can send a `?callback` parameter to any GET call to have the results wrapped in a JSON function. This is typically used when browsers want to embed {% data variables.product.product_name %} content in web pages by getting around cross domain issues. The response includes the same data output as the regular API, plus the relevant HTTP Header information. +Você pode enviar um parâmetro `?callback` para qualquer chamada de GET para envolver os resultados em uma função JSON. Isso é normalmente usado quando os navegadores querem que incorporem {% data variables.product.product_name %} conteúdo em páginas da web, contornando problemas de de domínio cruzado. A resposta inclui a mesma saída de dados da API regular, mais as informações relevantes do cabeçalho de HTTP. ```shell $ curl {% data variables.product.api_url_pre %}?callback=foo @@ -532,7 +536,7 @@ $ curl {% data variables.product.api_url_pre %}?callback=foo > }) ``` -You can write a JavaScript handler to process the callback. Here's a minimal example you can try out: +Você pode escrever um manipulador do JavaScript para processar o retorno de chamada. Aqui está um exemplo pequeno que você pode experimentar: @@ -556,13 +560,13 @@ You can write a JavaScript handler to process the callback. Here's a minimal exa -All of the headers are the same String value as the HTTP Headers with one notable exception: Link. Link headers are pre-parsed for you and come through as an array of `[url, options]` tuples. +Todos os cabeçalhos têm o mesmo valor d a string que os cabeçalhos de HTTP com uma exceção notável: Link. Cabeçalhos de link são pré-analisados para você e chegam como um array de tuplas de `[url, options]`. -A link that looks like this: +Um link que se parece com isto: Link: ; rel="next", ; rel="foo"; bar="baz" -... will look like this in the Callback output: +... será mostrado assim na saída da chamada de retorno: ```json { @@ -584,38 +588,38 @@ A link that looks like this: } ``` -### Timezones +### Fusos horários -Some requests that create new data, such as creating a new commit, allow you to provide time zone information when specifying or generating timestamps. We apply the following rules, in order of priority, to determine timezone information for API calls. +Algumas solicitações que criam novos dados, como a criação de um novo commit, permitem que você forneça informações do fuso horário ao especificar ou marcas de tempo. Aplicamos as seguintes regras, por ordem de prioridade, para determinar as informações do fuso horário para chamadas de API. -* [Explicitly providing an ISO 8601 timestamp with timezone information](#explicitly-providing-an-iso-8601-timestamp-with-timezone-information) -* [Using the `Time-Zone` header](#using-the-time-zone-header) -* [Using the last known timezone for the user](#using-the-last-known-timezone-for-the-user) -* [Defaulting to UTC without other timezone information](#defaulting-to-utc-without-other-timezone-information) +* [Fornecer explicitamente uma marca de tempo ISO 8601 com informações de fuso horário](#explicitly-providing-an-iso-8601-timestamp-with-timezone-information) +* [Usar o cabeçalho `Time-Zone`](#using-the-time-zone-header) +* [Usar o último fuso horário conhecido para o usuário](#using-the-last-known-timezone-for-the-user) +* [Definir como padrão UTC sem outras informações de fuso horário](#defaulting-to-utc-without-other-timezone-information) -#### Explicitly providing an ISO 8601 timestamp with timezone information +#### Fornecer explicitamente uma marca de tempo ISO 8601 com informações de fuso horário -For API calls that allow for a timestamp to be specified, we use that exact timestamp. An example of this is the [Commits API](/v3/git/commits). +Para chamadas de API que permitem que uma marca de tempo seja especificada, usamos essa marca de tempo exata. Um exemplo disso é a [API de Commits](/v3/git/commits). -These timestamps look something like `2014-02-27T15:05:06+01:00`. Also see [this example](/v3/git/commits/#example-input) for how these timestamps can be specified. +Essas marcas de tempo se parecem com `2014-02-27T15:05:06+01:00`. Veja também [este exemplo](/v3/git/commits/#example-input) para saber como essas marcas de tempo podem ser especificadas. -#### Using the `Time-Zone` header +#### Usar o cabeçalho `Time-Zone` -It is possible to supply a `Time-Zone` header which defines a timezone according to the [list of names from the Olson database](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). +É possível fornecer um cabeçalho `Time-Zone` que define um fuso horário de acordo com a lista [ de nomes do banco de dados Olson](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). ```shell $ curl -H "Time-Zone: Europe/Amsterdam" -X POST {% data variables.product.api_url_pre %}/repos/github/linguist/contents/new_file.md ``` -This means that we generate a timestamp for the moment your API call is made in the timezone this header defines. For example, the [Contents API](/v3/repos/contents/) generates a git commit for each addition or change and uses the current time as the timestamp. This header will determine the timezone used for generating that current timestamp. +Isso significa que geramos uma marca de tempo no momento em que sua chamada de API é feita no fuso horário que este cabeçalho define. Por exemplo, o [API de Conteúdo](/v3/repos/contents/) gera um commit do git para cada adição ou alteração e usa a hora atual como marca de tempo. Este cabeçalho determinará o fuso horário usado para gerar essa marca de tempo atual. -#### Using the last known timezone for the user +#### Usar o último fuso horário conhecido para o usuário -If no `Time-Zone` header is specified and you make an authenticated call to the API, we use the last known timezone for the authenticated user. The last known timezone is updated whenever you browse the {% data variables.product.product_name %} website. +Se nenhum cabeçalho `Time-Zone` for especificado e você fizer uma chamada autenticada para a API, nós usaremos o último fuso horário conhecido para o usuário autenticado. O último fuso horário conhecido é atualizado sempre que você navegar no site de {% data variables.product.product_name %}. -#### Defaulting to UTC without other timezone information +#### Definir como padrão UTC sem outras informações de fuso horário -If the steps above don't result in any information, we use UTC as the timezone to create the git commit. +Se as etapas acima não resultarem em nenhuma informação, usaremos UTC como o fuso horário para criar o commit do git. [rfc]: http://tools.ietf.org/html/rfc6570 [uri]: https://github.com/hannesg/uri_template diff --git a/translations/pt-BR/content/rest/reference/actions.md b/translations/pt-BR/content/rest/reference/actions.md index 57d61039ead3..bb5b76333a9b 100644 --- a/translations/pt-BR/content/rest/reference/actions.md +++ b/translations/pt-BR/content/rest/reference/actions.md @@ -1,5 +1,5 @@ --- -title: Actions +title: Ações product: '{% data reusables.gated-features.actions %}' redirect_from: - /v3/actions @@ -8,7 +8,7 @@ versions: enterprise-server: '>=2.22' --- -The {% data variables.product.prodname_actions %} API enables you to manage {% data variables.product.prodname_actions %} using the REST API. {% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_app %}s require the permissions mentioned in each endpoint. For more information, see "[{% data variables.product.prodname_actions %} Documentation](/actions)." +A API de {% data variables.product.prodname_actions %} permite que você gerencie {% data variables.product.prodname_actions %} usando a API REST. {% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_app %} exigem as permissões mencionadas em cada ponto de extremidade. Para obter mais informações, consulte "[Documentação do {% data variables.product.prodname_actions %}](/actions)". {% for operation in currentRestOperations %} {% unless operation.subcategory %}{% include rest_operation %}{% endunless %} @@ -16,7 +16,7 @@ The {% data variables.product.prodname_actions %} API enables you to manage {% d ## Artefatos -The Artifacts API allows you to download, delete, and retrieve information about workflow artifacts. {% data reusables.actions.about-artifacts %} Para obter mais informações, consulte "[Dados recorrentes do fluxo de trabalho que usam artefatos](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)". +A API de Artefatos permite que você faça o download, exclua e recupere informações sobre artefatos de fluxo de trabalho. {% data reusables.actions.about-artifacts %} Para obter mais informações, consulte "[Dados recorrentes do fluxo de trabalho que usam artefatos](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)". {% data reusables.actions.actions-authentication %} {% data reusables.actions.actions-app-actions-permissions-api %} @@ -24,11 +24,21 @@ The Artifacts API allows you to download, delete, and retrieve information about {% if operation.subcategory == 'artifacts' %}{% include rest_operation %}{% endif %} {% endfor %} -## Secrets +## Permissões -The Secrets API lets you create, update, delete, and retrieve information about encrypted secrets. {% data reusables.actions.about-secrets %} Para obter mais informações, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". +A API de Permissões permite que você defina permissões para quais organizações e repositórios têm permissão para executar {% data variables.product.prodname_actions %}, e quais ações podem ser executadas. Para obter mais informações, consulte "[Limites de uso, cobrança e administração](/actions/reference/usage-limits-billing-and-administration#disabling-or-limiting-github-actions-for-your-repository-or-organization)". -{% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_app %}s must have the `secrets` permission to use this API. Authenticated users must have collaborator access to a repository to create, update, or read secrets. +Você também pode definir permissões para uma empresa. Para obter mais informações, consulte a "[{% data variables.product.prodname_dotcom %} administração do Enterprise](/rest/reference/enterprise-admin#github-actions)" API REST. + +{% for operation in currentRestOperations %} + {% if operation.subcategory == 'permissions' %}{% include rest_operation %}{% endif %} +{% endfor %} + +## Segredos + +A API Segredos permite criar, atualizar, excluir e recuperar informações sobre segredos criptografados. {% data reusables.actions.about-secrets %} Para obter mais informações, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". + +{% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_app %} devem ter a permissão de `segredos` para usar esta API. Os usuários autenticados devem ter acesso de colaborador em um repositório para criar, atualizar ou ler segredos. {% for operation in currentRestOperations %} {% if operation.subcategory == 'secrets' %}{% include rest_operation %}{% endif %} @@ -36,11 +46,11 @@ The Secrets API lets you create, update, delete, and retrieve information about ## Executores auto-hospedados -The Self-hosted Runners API allows you to register, view, and delete self-hosted runners. {% data reusables.actions.about-self-hosted-runners %} Para obter mais informações, consulte "[Hospedando seus próprios executores](/actions/hosting-your-own-runners)". +A API de executores auto-hospedados permite que você registre, visualize e exclua executores auto-hospedados. {% data reusables.actions.about-self-hosted-runners %} Para obter mais informações, consulte "[Hospedando seus próprios executores](/actions/hosting-your-own-runners)". {% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_app %} deve ter a permissão de `administração` para repositórios ou a permissão `organization_self_hosted_runners` para organizações. Usuários autenticados devem ter acesso de administrador ao repositório ou à organização para usar essa API. -Você pode gerenciar runners auto-hospedados para uma empresa. Para obter mais informações, consulte a "[{% data variables.product.prodname_dotcom %} administração do Enterprise](/rest/reference/enterprise-admin#actions)" API REST. +Você pode gerenciar runners auto-hospedados para uma empresa. Para obter mais informações, consulte a "[{% data variables.product.prodname_dotcom %} administração do Enterprise](/rest/reference/enterprise-admin#github-actions)" API REST. {% for operation in currentRestOperations %} {% if operation.subcategory == 'self-hosted-runners' %}{% include rest_operation %}{% endif %} @@ -52,7 +62,7 @@ A API dos Grupos de Runners auto-hospedados permite que você gerencie grupos de {% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_app %} deve ter a permissão de `administração` para repositórios ou a permissão `organization_self_hosted_runners` para organizações. Usuários autenticados devem ter acesso de administrador ao repositório ou à organização para usar essa API. -Você pode gerenciar grupos de runners auto-hospedados para uma empresa. Para obter mais informações, consulte a "[{% data variables.product.prodname_dotcom %} administração do Enterprise](/rest/reference/enterprise-admin#actions)" API REST. +Você pode gerenciar grupos de runners auto-hospedados para uma empresa. Para obter mais informações, consulte a "[{% data variables.product.prodname_dotcom %} administração do Enterprise](/rest/reference/enterprise-admin##github-actions)" API REST. {% for operation in currentRestOperations %} {% if operation.subcategory == 'self-hosted-runner-groups' %}{% include rest_operation %}{% endif %} diff --git a/translations/pt-BR/content/rest/reference/activity.md b/translations/pt-BR/content/rest/reference/activity.md index 592803421ae1..159b5060fcc3 100644 --- a/translations/pt-BR/content/rest/reference/activity.md +++ b/translations/pt-BR/content/rest/reference/activity.md @@ -13,11 +13,11 @@ versions: ## Eventos -The Events API is a read-only API to the {% data variables.product.prodname_dotcom %} events. These events power the various activity streams on the site. +A API de eventos é uma API somente leitura para os eventos de {% data variables.product.prodname_dotcom %}. Esses eventos alimentam os vários fluxos de atividades no site. -The Events API can return different types of events triggered by activity on {% data variables.product.product_name %}. The Events API can return different types of events triggered by activity on {% data variables.product.product_name %}. For more information about the specific events that you can receive from the Events API, see "[{% data variables.product.prodname_dotcom %} Event types](/developers/webhooks-and-events/github-event-types)." For more information, see the "[Issue Events API](/rest/reference/issues#events)." +A API de eventos pode retornar diferentes tipos de eventos acionados por atividade em {% data variables.product.product_name %}. The Events API can return different types of events triggered by activity on {% data variables.product.product_name %}. For more information about the specific events that you can receive from the Events API, see "[{{ site.data.variables.product.prodname_dotcom }} Event types](/developers/webhooks-and-events/github-event-types)." Para obter mais informações, consulte a "[API de Eventos de problema](/rest/reference/issues#events)". -Events are optimized for polling with the "ETag" header. If no new events have been triggered, you will see a "304 Not Modified" response, and your current rate limit will be untouched. There is also an "X-Poll-Interval" header that specifies how often (in seconds) you are allowed to poll. In times of high server load, the time may increase. Please obey the header. +Os eventos são otimizados para sondagem a com o cabeçalho "ETag". Se nenhum novo evento for iniciado, você verá uma resposta "304 Not Modified" e seu limite de taxa atual não será alterado. Há também um cabeçalho "X-Poll-Interval" que especifica quantas vezes (em segundos) você pode fazer uma sondagem. Em tempos de alta carga do servidor, o tempo pode aumentar. Obedeça o cabeçalho. ``` shell $ curl -I {% data variables.product.api_url_pre %}/users/tater/events @@ -32,9 +32,9 @@ $ -H 'If-None-Match: "a18c3bded88eb5dbb5c849a489412bf3"' > X-Poll-Interval: 60 ``` -Events support pagination, however the `per_page` option is unsupported. The fixed page size is 30 items. Fetching up to ten pages is supported, for a total of 300 events. For information, see "[Traversing with pagination](/rest/guides/traversing-with-pagination)." +Os eventos são compatíveis com a paginação. No entanto, a opção `per_page` não é compatível. O tamanho fixo da página é de 30 itens. É possível obter até dez páginas para um total de 300 eventos. Para obter informações, consulte "[Deslocar-se com a paginação](/rest/guides/traversing-with-pagination)". -Only events created within the past 90 days will be included in timelines. Events older than 90 days will not be included (even if the total number of events in the timeline is less than 300). +Apenas eventos criados nos últimos 90 dias serão incluídos nas linhas de tempo. Eventos mais antigos que 90 dias não serão incluídos (mesmo que o número total de eventos na linha do tempo seja inferior a 300). {% for operation in currentRestOperations %} {% if operation.subcategory == 'events' %}{% include rest_operation %}{% endif %} @@ -46,9 +46,9 @@ Only events created within the past 90 days will be included in timelines. Event {% if operation.subcategory == 'feeds' %}{% include rest_operation %}{% endif %} {% endfor %} -### Example of getting an Atom feed +### Exemplo de como obter um feed do Atom -To get a feed in Atom format, you must specify the `application/atom+xml` type in the `Accept` header. For example, to get the Atom feed for GitHub security advisories: +Para obter um feed no formato Atom você deve especificar o tipo `application/atom+xml` no cabeçalho `Aceitar`. Por exemplo, para obter o feed do Atom para consultorias de segurança do GitHub: curl -H "Accept: application/atom+xml" https://github.com/security-advisories @@ -99,24 +99,24 @@ Status: 200 OK ## Notificações -Users receive notifications for conversations in repositories they watch including: +Os usuários recebem notificações de conversas em repositórios que inspecionam, incluindo: -* Issues and their comments -* Pull Requests and their comments -* Comments on any commits +* Problemas e seus comentários +* Pull Requests e seus comentários +* Comentários em quaisquer commits -Notifications are also sent for conversations in unwatched repositories when the user is involved including: +As notificações também são enviadas para conversas em repositórios não inspecionados quando o usuário está envolvido, incluindo: * **@mentions** -* Issue assignments -* Commits the user authors or commits -* Any discussion in which the user actively participates +* Tarefas de problemas +* Commits que o usuário cria ou faz commit +* Qualquer discussão de que o usuário participa ativamente -All Notification API calls require the `notifications` or `repo` API scopes. Doing this will give read-only access to some issue and commit content. You will still need the `repo` scope to access issues and commits from their respective endpoints. +Todas as chamadas de notificação da API requerem escopos da API para `notificações` ou `repositórios`. Fazer isto dará acesso somente-leitura a algum problema e fará commit do conteúdo. Você ainda precisará do escopo de `repositório` para acessar problemas e commits de seus respectivos pontos de extremidade. -Notifications come back as "threads". A thread contains information about the current discussion of an issue, pull request, or commit. +Notificações retornam como "correntes". Uma corrente contém informações sobre a discussão atual de um problema, pull request ou commit. -Notifications are optimized for polling with the `Last-Modified` header. If there are no new notifications, you will see a `304 Not Modified` response, leaving your current rate limit untouched. There is an `X-Poll-Interval` header that specifies how often (in seconds) you are allowed to poll. In times of high server load, the time may increase. Please obey the header. +As notificações são otimizadas para sondagem com o cabeçalho `Last-Modified`. Se não houver novas notificações, você verá uma resposta `304 Not Modified`, deixando a sua taxa de limite atual inalterada. Há um cabeçalho `X-Poll-Interval` que especifica com que frequência (em segundos) que você pode fazer a sondagem. Em tempos de alta carga do servidor, o tempo pode aumentar. Obedeça o cabeçalho. ``` shell # Add authentication to your requests @@ -132,49 +132,49 @@ $ -H "If-Modified-Since: Thu, 25 Oct 2012 15:16:27 GMT" > X-Poll-Interval: 60 ``` -### Notification reasons +### Motivos de notificação -When retrieving responses from the Notifications API, each payload has a key titled `reason`. These correspond to events that trigger a notification. +Ao recuperar respostas da API de Notificações, cada carga tem uma carga denominada `drazão`. Estas correspondem a eventos que ativam uma notificação. -Here's a list of potential `reason`s for receiving a notification: +Aqui está uma lista da potencial `razão` para receber uma notificação: -| Reason Name | Descrição | -| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `assign` | You were assigned to the issue. | -| `autor` | You created the thread. | -| `comentário` | You commented on the thread. | -| `convite` | You accepted an invitation to contribute to the repository. | -| `manual` | You subscribed to the thread (via an issue or pull request). | -| `menção` | You were specifically **@mentioned** in the content. | -| `review_requested` | You, or a team you're a member of, were requested to review a pull request.{% if currentVersion == "free-pro-team@latest" %} -| `security_alert` | {% data variables.product.prodname_dotcom %} discovered a [security vulnerability](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in your repository.{% endif %} -| `state_change` | You changed the thread state (for example, closing an issue or merging a pull request). | -| `assinado` | You're watching the repository. | -| `team_mention` | You were on a team that was mentioned. | +| Nome da razão | Descrição | +| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `assign` | O problema foi atribuído a você. | +| `autor` | Você criou a corrente. | +| `comentário` | Você comentou na corrente. | +| `convite` | Você aceitou um convite para contribuir com o repositório. | +| `manual` | Você assinou a corrente (por meio de um problema ou pull request). | +| `menção` | Você foi especificamente **@mentioned** no conteúdo. | +| `review_requested` | Foi solicitado que você ou uma equipe da qual você é integrante revise um pull request.{% if currentVersion == "free-pro-team@latest" %} +| `security_alert` | O {% data variables.product.prodname_dotcom %} descobriu uma [vulnerabilidade de segurança](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) no seu repositório.{% endif %} +| `state_change` | Você alterou o estado da corrente (por exemplo, fechando um problema ou mesclando um pull request). | +| `assinado` | Você está inspecionando o repositório. | +| `team_mention` | Você estava em uma equipe que foi mencionada. | -Note that the `reason` is modified on a per-thread basis, and can change, if the `reason` on a later notification is different. +Observe que a `razão` é modificada em uma base de corrente e pode mudar se a `razão` em uma notificação posterior for diferente. -For example, if you are the author of an issue, subsequent notifications on that issue will have a `reason` of `author`. If you're then **@mentioned** on the same issue, the notifications you fetch thereafter will have a `reason` of `mention`. The `reason` remains as `mention`, regardless of whether you're ever mentioned again. +Por exemplo, se você é o autor de um problema, as notificações subsequentes sobre essa problema terão uma `razão` do `autor`. Portanto, se você for **@mentioned** no mesmo problema, as notificações que você buscar subsequentemente terão uma `razão` a `mencionar`. A `razão` permanece como `menção`, independentemente se você já foi mencionado novamente. {% for operation in currentRestOperations %} {% if operation.subcategory == 'notifications' %}{% include rest_operation %}{% endif %} {% endfor %} -## Starring +## Marcar com uma estrela -Repository starring is a feature that lets users bookmark repositories. Stars are shown next to repositories to show an approximate level of interest. Stars have no effect on notifications or the activity feed. +Marcar o repositório como uma estrela é uma funcionalidade que permite aos usuários favoritar os repositórios. As estrelas são exibidas ao lado dos repositórios para mostrar um nível de interesse aproximado. As estrelas não têm efeito nas notificações ou no feed da atividade. -### Starring vs. Watching +### Marcar como estrela vs. Inspecionar -In August 2012, we [changed the way watching works](https://github.com/blog/1204-notifications-stars) on {% data variables.product.prodname_dotcom %}. Many API client applications may be using the original "watcher" endpoints for accessing this data. You can now start using the "star" endpoints instead (described below). For more information, see the [Watcher API Change post](https://developer.github.com/changes/2012-09-05-watcher-api/) and the "[Repository Watching API](/rest/reference/activity#watching)." +Em agosto de 2012, [mudamos a forma como a inspeção funciona](https://github.com/blog/1204-notifications-stars) em {% data variables.product.prodname_dotcom %}. Muitas aplicações de cliente da API podem estar usando os pontos de extremidade originais de "inspetor" para acessar estes dados. Agora você pode começar a usar os pontos de extremidade "estrela" (descritos abaixo). Para obter mais informações, consulte a [Post de alteração da API de Inspeção](https://developer.github.com/changes/2012-09-05-watcher-api/) e a [API de Inspeção do repositório](/rest/reference/activity#watching)". -### Custom media types for starring +### Tipos de mídia personalizados para marcar como estrela -There is one supported custom media type for the Starring REST API. When you use this custom media type, you will receive a response with the `starred_at` timestamp property that indicates the time the star was created. The response also has a second property that includes the resource that is returned when the custom media type is not included. The property that contains the resource will be either `user` or `repo`. +Existe um tipo de mídia personalizado com suporte para a API REST estrelada. Ao usar este tipo de mídia personalizada, você receberá uma resposta com a propriedade do registro de tempo `starred_at`, que indica o tempo que a estrela foi criada. A resposta também tem uma segunda propriedade que inclui o recurso retornado quando o tipo de mídia personalizado não está incluído. A propriedade que contém o recurso será `usuário` ou `repositório`. application/vnd.github.v3.star+json -For more information about media types, see "[Custom media types](/rest/overview/media-types)." +Para obter mais informações sobre os tipos de mídia, consulte "[Tipos de mídia personalizados](/rest/overview/media-types)". {% for operation in currentRestOperations %} {% if operation.subcategory == 'starring' %}{% include rest_operation %}{% endif %} @@ -182,7 +182,7 @@ For more information about media types, see "[Custom media types](/rest/overview ## Inspecionando -Watching a repository registers the user to receive notifications on new discussions, as well as events in the user's activity feed. For simple repository bookmarks, see "[Repository starring](/rest/reference/activity#starring)." +Inspecionar um repositório registra o usuário para receber notificações de novas discussões, bem como eventos no feed de atividade do usuário. Para favoritar um repositório de forma simples, consulte "[Marcar repositórios com uma estrela](/rest/reference/activity#starring)". {% for operation in currentRestOperations %} {% if operation.subcategory == 'watching' %}{% include rest_operation %}{% endif %} diff --git a/translations/pt-BR/content/rest/reference/apps.md b/translations/pt-BR/content/rest/reference/apps.md index fc785449796b..2bb2743b7b17 100644 --- a/translations/pt-BR/content/rest/reference/apps.md +++ b/translations/pt-BR/content/rest/reference/apps.md @@ -7,25 +7,25 @@ versions: enterprise-server: '*' --- -The GitHub Apps API enables you to get high-level information about a GitHub App as well as specific information about installations of the app. To learn more about GitHub Apps, see "[Authenticating as a GitHub App](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app)." +A API dos aplicativos GitHub permite que você obtenha informações de alto nível sobre um aplicativo GitHub, bem como informações específicas sobre as instalações do aplicativo. Para saber mais sobre aplicativos GitHub, consulte "[Efetuar a autenticação como um aplicativo GitHub](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app)". {% data reusables.apps.general-apps-restrictions %} -This page lists endpoints that you can access while authenticated as a GitHub App. See "[Authenticating as a GitHub App](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app)" to learn more. +Esta página lista os pontos de extremidade que você pode acessar enquanto autenticado como um aplicativo GitHub. Consulte "[Efetuar a autenticação como um aplicativo GitHub](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app)" para saber mais. -When authenticated as a GitHub App, the GitHub Apps API enables you to get high-level information about a GitHub App as well as specific information about installations of an app. +Quando autenticado como um aplicativo GitHub, a API dos aplicativos GitHub permite que você obtenha informações de alto nível sobre um aplicativo GitHub, bem como informações específicas sobre instalações de um aplicativo. -You can access REST API v3 endpoints while authenticated as a GitHub App. These endpoints have a "Notes" section that contains a bullet point that says "Works with GitHub Apps." You can also access these endpoints while authenticated as a user. +Você pode acessar os pontos de extremidade da API v3 de REST enquanto autenticado como um aplicativo GitHub. Estes pontos de extremidade têm uma seção de "Observação" que contém um ponto que diz "Funciona com aplicativos GitHub". Você também pode acessar esses pontos de extremidade enquanto estiver autenticado como usuário. -A subset of REST API v3 endpoints requires authenticating as a GitHub App installation. See [Installations](/v3/apps/installations/) for a list of these endpoints. +Um subconjunto de pontos de extremidade da API v2 de REST exige autenticação como uma instalação do aplicativo GitHub. Consulte [Instalações](/v3/apps/installations/) para obter uma lista desses pontos de extremidade. {% for operation in currentRestOperations %} {% unless operation.subcategory %}{% include rest_operation %}{% endunless %} {% endfor %} -## OAuth Applications API +## API de aplicativos do OAuth -You can use this API to manage the OAuth tokens an OAuth application uses to access people's {% data variables.product.prodname_dotcom %} accounts. +Você pode usar essa API para gerenciar os tokens do OAuth que um aplicativo OAuth usa para acessar as contas {% data variables.product.prodname_dotcom %} das pessoas. {% for operation in currentRestOperations %} {% if operation.subcategory == 'oauth-applications' %}{% include rest_operation %}{% endif %} @@ -33,11 +33,9 @@ You can use this API to manage the OAuth tokens an OAuth application uses to acc ## Instalações -The Installations API enables you to get information about installations of your GitHub App and perform actions within those installations. Uma _instalação_ refere-se a qualquer usuário ou conta de organização que instalou o aplicativo. For information on how to authenticate as an installation and limit access to specific repositories, see "[Authenticating as an installation](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)." +A API de instalações permite que você obtenha informações sobre as instalações do seu aplicativo GitHub e execute ações nessas instalações. Uma _instalação_ refere-se a qualquer usuário ou conta de organização que instalou o aplicativo. Para obter informações sobre como efetuar a autenticação como uma instalação e limitar o acesso a repositórios específicos, consulte "[Efetuar a autenticação como uma instalação](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)". -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -To list all GitHub App installations for an organization, see "[List app installations for an organization](/v3/orgs/#list-app-installations-for-an-organization)." -{% endif %} +Para listar todas as instalações do aplicativo GitHub para uma organização, consulte "[Listar instalações de aplicativos para uma organização](/v3/orgs/#list-app-installations-for-an-organization)". {% for operation in currentRestOperations %} {% if operation.subcategory == 'installations' %}{% include rest_operation %}{% endif %} @@ -46,17 +44,17 @@ To list all GitHub App installations for an organization, see "[List app install {% if currentVersion == "free-pro-team@latest" %} ## Marketplace -For more information about {% data variables.product.prodname_marketplace %}, see "[GitHub Marketplace](/marketplace/)." +Para obter mais informações sobre {% data variables.product.prodname_marketplace %}, consulte "[GitHub Marketplace](/marketplace/)". -The {% data variables.product.prodname_marketplace %} API allows you to see which customers are using a pricing plan, see a customer's purchases, and see if an account has an active subscription. +A API de {% data variables.product.prodname_marketplace %} permite que você veja quais clientes estão usando um plano de preços, as compras de um cliente e se uma conta tem uma assinatura ativa. -### Testing with stubbed endpoints +### Fazer testes com pontos de extremidades de amostra -This API includes endpoints that allow you to [test your {% data variables.product.prodname_github_app %}](/marketplace/integrating-with-the-github-marketplace-api/testing-github-marketplace-apps/) with **stubbed data**. Stubbed data is hard-coded, fake data that will not change based on actual subscriptions. +Esta API inclui pontos de extremidade que permitem que você [teste o seu {% data variables.product.prodname_github_app %}](/marketplace/integrating-with-the-github-marketplace-api/testing-github-marketplace-apps/) com **dados de amostra**. Os dados do de amostra têm código rígido, dados falsos e não serão alterados com base em assinaturas reais. -To test with stubbed data, use a stubbed endpoint in place of its production counterpart. This allows you to test whether API logic succeeds before listing {% data variables.product.prodname_github_app %}s on {% data variables.product.prodname_marketplace %}. +Para fazer teste com dados de amostra, use um pontos de extremidade de amostra no lugar da sua contraparte de produção. Isso permite que você teste se a lógica da API é bem-sucedida antes de listar {% data variables.product.prodname_github_app %} no {% data variables.product.prodname_marketplace %}. -Be sure to replace stubbed endpoints with production endpoints before deploying your {% data variables.product.prodname_github_app %}. +Certifique-se de substituir pontos de extremidades de amostra pelos pontos de extremidades de produção antes de implantar seu {% data variables.product.prodname_github_app %}. {% for operation in currentRestOperations %} {% if operation.subcategory == 'marketplace' %}{% include rest_operation %}{% endif %} diff --git a/translations/pt-BR/content/rest/reference/billing.md b/translations/pt-BR/content/rest/reference/billing.md index e783b0b978d1..cc69a21d1b78 100644 --- a/translations/pt-BR/content/rest/reference/billing.md +++ b/translations/pt-BR/content/rest/reference/billing.md @@ -4,7 +4,7 @@ versions: free-pro-team: '*' --- -You can monitor your {% data variables.product.prodname_actions %} and {% data variables.product.prodname_registry %} charges and usage for a user and organization through the Billing API. +Você pode monitorar suas cobranças e uso de {% data variables.product.prodname_actions %} e de {% data variables.product.prodname_registry %} para um usuário e organização através da API de cobrança. Você pode obter informações de cobrança para uma empresa. Para obter mais informações, consulte a API REST "[{% data variables.product.prodname_dotcom %} administração de Enterprise](/rest/reference/enterprise-admin#billing)". diff --git a/translations/pt-BR/content/rest/reference/checks.md b/translations/pt-BR/content/rest/reference/checks.md index 9bffc361328a..b3280fe1300c 100644 --- a/translations/pt-BR/content/rest/reference/checks.md +++ b/translations/pt-BR/content/rest/reference/checks.md @@ -7,7 +7,7 @@ versions: enterprise-server: '*' --- -The Checks API enables you to build GitHub Apps that run powerful checks against code changes in a repository. Você pode criar os aplicativos que realizam integração contínua, linting ou serviços de varredura de código e fornecem feedback detalhado sobre commits. For more information, see "[Getting started with the checks API](/rest/guides/getting-started-with-the-checks-api)" and "[Creating CI tests with the Checks API](/apps/quickstart-guides/creating-ci-tests-with-the-checks-api/)." +A API de Verificação permite que você crie aplicativos do GitHub que executam verificações poderosas contra alterações de código em um repositório. Você pode criar os aplicativos que realizam integração contínua, linting ou serviços de varredura de código e fornecem feedback detalhado sobre commits. Para mais informações, consulte "[Começar com a API de verificações](/rest/guides/getting-started-with-the-checks-api)" e "[Criar testes de CI com a API de verificações](/apps/quickstart-guides/creating-ci-tests-with-the-checks-api/)". {% for operation in currentRestOperations %} {% unless operation.subcategory %}{% include rest_operation %}{% endunless %} @@ -23,7 +23,7 @@ The Checks API enables you to build GitHub Apps that run powerful checks against {% note %} - **Note:** A GitHub App only receives one [`check_suite`](/webhooks/event-payloads/#check_suite) event per commit SHA, even if you push the commit SHA to more than one branch. To find out when a commit SHA is pushed to a branch, you can subscribe to branch [`create`](/webhooks/event-payloads/#create) events. + **Observação:** Um aplicativo GitHub recebe apenas um evento [`check_suite`](/webhooks/event-payloads/#check_suite) por SHA de commit SHA, mesmo se você fizer push do SHA do commit para mais de um branch. Para descobrir quando um SHA do commit é enviado para um branch, você pode assinar os eventos do branch [`criar`](/webhooks/event-payloads/#create). {% endnote %} diff --git a/translations/pt-BR/content/rest/reference/code-scanning.md b/translations/pt-BR/content/rest/reference/code-scanning.md new file mode 100644 index 000000000000..4c8232da7ef4 --- /dev/null +++ b/translations/pt-BR/content/rest/reference/code-scanning.md @@ -0,0 +1,14 @@ +--- +title: Varredura de código +redirect_from: + - /v3/code-scanning +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta %} + +A API de {% data variables.product.prodname_code_scanning %} permite que você recupere e atualize alertas de código em um repositório. Você pode usar os pontos de extremidade para criar relatórios automatizados para os alertas de varredura de código em uma organização ou fazer upload dos resultados de análise gerados usando ferramentas de varredura de código off-line. Para obter mais informações, consulte "[Encontrar vulnerabilidades e erros de segurança no seu código](/github/finding-security-vulnerabilities-and-errors-in-your-code). + +{% include rest_operations_at_current_path %} diff --git a/translations/pt-BR/content/rest/reference/codes-of-conduct.md b/translations/pt-BR/content/rest/reference/codes-of-conduct.md index 9687cfcc8664..8179c3b4f1f8 100644 --- a/translations/pt-BR/content/rest/reference/codes-of-conduct.md +++ b/translations/pt-BR/content/rest/reference/codes-of-conduct.md @@ -8,6 +8,6 @@ versions: enterprise-server: '*' --- -You can use the Codes of Conduct API to retrieve information about a repository's code of conduct. To get a repository's code of conduct, use the "[Get a repository](/v3/repos/#get-a-repository)" endpoint. +Você pode usar a API de Códigos de Conduta para recuperar informações sobre o código de conduta de um repositório. Para obter o código de conduta de um repositório, use o ponto de extremidade "[Obter um repositório](/v3/repos/#get-a-repository). {% include rest_operations_at_current_path %} diff --git a/translations/pt-BR/content/rest/reference/enterprise-admin.md b/translations/pt-BR/content/rest/reference/enterprise-admin.md index b87b10cdd950..00531e06b7b0 100644 --- a/translations/pt-BR/content/rest/reference/enterprise-admin.md +++ b/translations/pt-BR/content/rest/reference/enterprise-admin.md @@ -1,5 +1,5 @@ --- -title: GitHub Enterprise administration +title: Administração do GitHub Enterprise allowTitleToDifferFromFilename: true redirect_from: - /v3/enterprise-admin @@ -9,13 +9,13 @@ versions: enterprise-server: '*' --- -You can use these {% data variables.product.prodname_ghe_cloud %} endpoints to administer your enterprise account. +You can use these {{ site.data.variables.product.prodname_ghe_cloud }} endpoints to administer your enterprise account. {% if currentVersion == "free-pro-team@latest" %} {% note %} -**Note:** This article applies to {% data variables.product.prodname_ghe_cloud %}. To see the {% data variables.product.prodname_ghe_server %} version, use the **{% data ui.pages.article_version %}** drop-down menu. +**Observação:** Este artigo aplica-se a {% data variables.product.prodname_ghe_cloud %}. Para ver a versão do {% data variables.product.prodname_ghe_server %}, use o menu suspenso **{% data ui.pages.article_version %}**. {% endnote %} @@ -23,7 +23,7 @@ You can use these {% data variables.product.prodname_ghe_cloud %} endpoints to a {% if currentVersion != "free-pro-team@latest" %} -### Endpoint URLs +### URLs do ponto de extremidade Os endpoints da API REST — exceto endpoints da API [Console de Gerenciamento](#management-console) — são prefixados com a seguinte URL: @@ -39,11 +39,11 @@ http(s)://hostname/ ### Autenticação -Os endpoints de API da sua instalação do {% data variables.product.product_name %} aceitam [os mesmos métodos de autenticação](/rest/overview/resources-in-the-rest-api#authentication) da API do GitHub.com. Você pode se autenticar com **[tokens OAuth](/apps/building-integrations/setting-up-and-registering-oauth-apps/)** (que podem ser criados usando a [API de Autorizações](/rest/reference/oauth-authorizations#create-a-new-authorization)) ou **[autenticação básica](/rest/overview/resources-in-the-rest-api#basic-authentication)**. {% if currentVersion != "free-pro-team@latest" %} Os tokens OAuth devem ter o `site_admin` [escopo OAuth](/developers/apps/scopes-for-oauth-apps#available-scopes) quando usados com endpoints específicos da Enterprise.{% endif %} +Os endpoints de API da sua instalação do {% data variables.product.product_name %} aceitam [os mesmos métodos de autenticação](/rest/overview/resources-in-the-rest-api#authentication) da API do GitHub.com. Você pode se autenticar com **[tokens OAuth](/apps/building-integrations/setting-up-and-registering-oauth-apps/)** (que podem ser criados usando a [API de Autorizações](/rest/reference/oauth-authorizations#create-a-new-authorization)) ou **[autenticação básica](/rest/overview/resources-in-the-rest-api#basic-authentication)**. {% if currentVersion != "free-pro-team@latest" %} Os tokens OAuth devem ter o escopo do OAuth `site_admin` [](/developers/apps/scopes-for-oauth-apps#available-scopes) quando usados com pontos de extremidades específicos da empresa.{% endif %} Os endpoints da API de administração da empresa somente são acessíveis para administradores do site autenticados pelo {% data variables.product.product_name %}, exceto a API [Console de gerenciamento](#management-console), que requer a [senha do Console de Gerenciamento](/enterprise/admin/articles/accessing-the-management-console/). -### Version information +### Informações da versão A versão atual de uma instância do {% data variables.product.product_name %} é retornada no cabeçalho de resposta de cada API: `X-GitHub-Enterprise-Versão: {{currentVersion}}.0` Você também pode ler a versão atual chamando o [meta endpoint](/rest/reference/meta/). @@ -75,7 +75,7 @@ A versão atual de uma instância do {% data variables.product.product_name %} {% if currentVersion == "free-pro-team@latest" %} ## SCIM -### SCIM Provisioning for Enterprises +### Provisionamento de SCIM para Empresas Os provedores de identidade (IdPs) habilitados pelo SCIM podem usar a API do SCIM para automatizar o provisionamento de filiação à empresa. A API {% data variables.product.product_name %} é baseada na versão 2.0 do [padrão SCIM](http://www.simplecloud.info/). @@ -87,11 +87,11 @@ O IdP deve usar `{% data variables.product.api_url_code %}/scim/v2/enterprises/{ {% endnote %} -### Authenticating calls to the SCIM API +### Autenticar chamadas para a API de SCIM Você deve se autenticar como proprietário de uma empresa do {% data variables.product.product_name %} para usar sua API do SCIM. A API espera que um token [OAuth 2.0](/developers/apps/authenticating-with-github-apps) seja incluído no cabeçalho da `Autorização`. Você também pode usar um token de acesso pessoal, mas primeiro deve [autorizá-lo para uso em sua SAML SSO corporativa](/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on). -### Mapping of SAML and SCIM data +### Mapear dados do SAML e SCIM O SAML IdP e o cliente SCIM devem usar valores correspondentes ao `NameID` e `userName` para cada usuário. Isso permite que um usuário que faz autenticação através do SAML seja vinculado à sua identidade SCIM provisionada. @@ -99,18 +99,18 @@ Os grupos SCIM são combinados com organizações {% data variables.product.prod O cliente SAML IdP e SCIM deve ser configurado de forma que haja correspondência exata do `displayName` do grupo SCIM com o nome da organização {% data variables.product.product_name %} correspondente. Isso permite que o {% data variables.product.product_name %} associe o grupo SCIM à associação da organização {% data variables.product.product_name %}. -### Supported SCIM User attributes +### Atributos de usuário de SCIM compatíveis -| Nome | Tipo | Descrição | -| ---------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `userName` | `string` | The username for the user. | -| `name.givenName` | `string` | The first name of the user. | -| `name.lastName` | `string` | The last name of the user. | -| `emails` | `array` | List of user emails. | -| `externalId` | `string` | This identifier is generated by the SAML provider, and is used as a unique ID by the SAML provider to match against a GitHub user. You can find the `externalID` for a user either at the SAML provider, or using the [List SCIM provisioned identities for an enterprise](#list-scim-provisioned-identities-for-an-enterprise) endpoint and filtering on other known attributes, such as a user's GitHub username or email address. | -| `id` | `string` | Identifier generated by the GitHub SCIM endpoint. | -| `ativo` | `boolean` | Used to indicate whether the identity is active (true) or should be deprovisioned (false). | -| `groups` | `array` | Optional list of SCIM group IDs the user is a member of. | +| Nome | Tipo | Descrição | +| ---------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `userName` | `string` | O nome de usuário para o usuário. | +| `name.givenName` | `string` | O primeiro nome do usuário. | +| `name.lastName` | `string` | O sobrenome do usuário. | +| `emails` | `array` | Lista de e-mails dos usuários. | +| `externalId` | `string` | Este identificador é gerado pelo provedor do SAML e é usado como um ID exclusivo pelo provedor do SAML para corresponder ao usuário do GitHub. Você pode encontrar o `externalID` para um usuário no provedor do SAML ou usar as identidades fornecidas pela [Lista de identidades de fornecedores de SCIM para o ponto de extremidade de uma empresa](#list-scim-provisioned-identities-for-an-enterprise) e filtrar os outros atributos conhecidos, como, por exemplo, o nome de usuário ou endereço de e-mail de um usuário. | +| `id` | `string` | Identificador gerado pelo ponto de extremidade do SCIM do GitHub. | +| `ativo` | `boolean` | Usado para indicar se a identidade está ativa (verdadeira) ou se deve ser desprovisionada (falso). | +| `grupos` | `array` | Lista opcional dos IDs de grupos de SCIM do qual o usuário é integrante. | {% note %} @@ -122,13 +122,12 @@ GET /scim/v2/enterprises/{enterprise}/Users/{scim_user_id} {% endnote %} -### Supported SCIM Group attributes - -| Nome | Tipo | Descrição | -| ------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `displayName` | `string` | The name of the SCIM group, which must exactly match the name of the corresponding {% data variables.product.product_name %} organization. For example, if the URL of the organization is `https://github.com/octo-org`, the group name must be `octo-org`. | -| `members` | `array` | List of SCIM user IDs that are members of the group. | +### Atributos de grupo de SCIM compatíveis +| Nome | Tipo | Descrição | +| ------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `displayName` | `string` | O nome do grupo de SCIM, que deve corresponder exatamente ao nome da organização de {% data variables.product.product_name %} correspondente. Por exemplo, se a URL da organização for `https://github.com/octo-org`, o nome do grupo deverá ser `octo-org`. | +| `members` | `array` | Lista de IDs de usuários de SCIM que são integrantes do grupo. | {% for operation in currentRestOperations %} {% if operation.subcategory == 'scim' %}{% include rest_operation %}{% endif %} @@ -220,14 +219,14 @@ A API de administração da organização permite criar organizações em um app A API de Hooks pre-receive da Organização permite que você veja e modifique a aplicação dos hooks pre-receive disponíveis para uma organização. -### Object attributes +### Atributos do objeto -| Nome | Tipo | Descrição | -| -------------------------------- | --------- | --------------------------------------------------------- | -| `name` | `string` | O nome do hook. | -| `enforcement` | `string` | The state of enforcement for the hook on this repository. | -| `allow_downstream_configuration` | `boolean` | Whether repositories can override enforcement. | -| `configuration_url` | `string` | URL for the endpoint where enforcement is set. | +| Nome | Tipo | Descrição | +| -------------------------------- | --------- | -------------------------------------------------------------- | +| `name` | `string` | O nome do hook. | +| `enforcement` | `string` | O estado de aplicação para o hook neste repositório. | +| `allow_downstream_configuration` | `boolean` | Se os repositórios podem substituir a imposição. | +| `configuration_url` | `string` | URL para o ponto de extremidade em que a aplicação é definida. | Os valores possíveis para *aplicação* são `habilitado`, `desabilitado` e`testando`. `desabilitado` indica que o hook pre-receive não será executado. `habilitado` indica que será executado e rejeitará quaisquer pushes que resultem em um status diferente de zero. `testando` significa que o script será executado, mas não fará com que quaisquer pushes sejam rejeitados. @@ -241,25 +240,25 @@ Os valores possíveis para *aplicação* são `habilitado`, `desabilitado` e`tes A API de Ambientes Pre-receive permite que você crie, liste, atualize e apague ambientes para hooks pre-receive. *Só está disponível para [administradores do site](/rest/overview/resources-in-the-rest-api#authentication) autenticados.* Usuários normais receberão uma mensagem `404` se tentarem acessá-la. -### Object attributes +### Atributos do objeto -#### Pre-receive Environment +#### Ambiente pre-receive -| Nome | Tipo | Descrição | -| --------------------- | --------- | ---------------------------------------------------------------------------------------------------------------- | -| `name` | `string` | The name of the environment as displayed in the UI. | -| `image_url` | `string` | URL to the tarball that will be downloaded and extracted. | -| `default_environment` | `boolean` | Whether this is the default environment that ships with {% data variables.product.prodname_ghe_server %}. | -| `download` | `objeto` | This environment's download status. | -| `hooks_count` | `inteiro` | The number of pre-receive hooks that use this environment. | +| Nome | Tipo | Descrição | +| --------------------- | --------- | ------------------------------------------------------------------------------------------- | +| `name` | `string` | O nome do ambiente conforme exibido na interface do usuário. | +| `image_url` | `string` | URL do tarball que será baixado e extraído. | +| `default_environment` | `boolean` | Se este é o ambiente-padrão que vem com {% data variables.product.prodname_ghe_server %}. | +| `download` | `objeto` | Status do download deste ambiente. | +| `hooks_count` | `inteiro` | O número de hooks de pre-receive que usam este ambiente. | -#### Pre-receive Environment Download +#### Download do ambiente pre-receive -| Nome | Tipo | Descrição | -| --------------- | -------- | ------------------------------------------------------- | -| `estado` | `string` | The state of the most recent download. | -| `downloaded_at` | `string` | The time when the most recent download started. | -| `mensagem` | `string` | On failure, this will have any error messages produced. | +| Nome | Tipo | Descrição | +| --------------- | -------- | ----------------------------------------------------- | +| `estado` | `string` | O estado do download mais recente. | +| `downloaded_at` | `string` | A hora em que o download mais recente começou. | +| `mensagem` | `string` | Em caso de falha, serão produzidas mensagens de erro. | Os valores possíveis para o `estado` são `not_started,` `in_progress,` `sucesso` `falho`. @@ -271,9 +270,9 @@ Os valores possíveis para o `estado` são `not_started,` `in_progress,` `sucess A API de hooks pre-receive permite que você crie, liste, atualize e apague hooks pre-receive. *Só está disponível para [administradores do site](/rest/overview/resources-in-the-rest-api#authentication) autenticados.* Usuários normais receberão uma mensagem `404` se tentarem acessá-la. -### Object attributes +### Atributos do objeto -#### Pre-receive Hook +#### Hook pre-receive | Nome | Tipo | Descrição | | -------------------------------- | --------- | ------------------------------------------------------------------------------ | @@ -294,25 +293,25 @@ Os valores possíveis para *aplicação* são `habilitado`, `desabilitado` e`tes A API de Hooks pre-receive do Repositório permite que você veja e modifique a aplicação dos hooks pre-receive disponíveis para um repositório. -### Object attributes +### Atributos do objeto -| Nome | Tipo | Descrição | -| ------------------- | -------- | --------------------------------------------------------- | -| `name` | `string` | O nome do hook. | -| `enforcement` | `string` | The state of enforcement for the hook on this repository. | -| `configuration_url` | `string` | URL for the endpoint where enforcement is set. | +| Nome | Tipo | Descrição | +| ------------------- | -------- | -------------------------------------------------------------- | +| `name` | `string` | O nome do hook. | +| `enforcement` | `string` | O estado de aplicação para o hook neste repositório. | +| `configuration_url` | `string` | URL para o ponto de extremidade em que a aplicação é definida. | -Os valores possíveis para *aplicação* são `habilitado`, `desabilitado` e`testando`. `desabilitado` indica que o hook pre-receive não será executado. `enabled` indicates it will run and reject any pushes that result in a non-zero status. `testando` significa que o script será executado, mas não fará com que quaisquer pushes sejam rejeitados. +Os valores possíveis para *aplicação* são `habilitado`, `desabilitado` e`testando`. `desabilitado` indica que o hook pre-receive não será executado. `habilitado` indica que será executado e rejeitará quaisquer pushes que resultem em um estado diferente de zero. `testando` significa que o script será executado, mas não fará com que quaisquer pushes sejam rejeitados. -`configuration_url` may be a link to this repository, it's organization owner or global configuration. Authorization to access the endpoint at `configuration_url` is determined at the owner or site admin level. +`configuration_url` pode ser um link para este repositório, seu proprietário da organização ou configuração global. A autorização para acessar o ponto de extremidade no `configuration_url` é determinada no nível de proprietário ou administrador do site. {% for operation in currentRestOperations %} {% if operation.subcategory == 'repo-pre-receive-hooks' %}{% include rest_operation %}{% endif %} {% endfor %} -## Search indexing +## Pesquisar nos índices -The Search Indexing API allows you to queue up a variety of search indexing tasks. *Só está disponível para [administradores do site](/rest/overview/resources-in-the-rest-api#authentication) autenticados.* Usuários normais receberão uma mensagem `404` se tentarem acessá-la. +A API de pesquisa nos índices permite que você faça fila com uma variedade de tarefas de indexação de pesquisa. *Só está disponível para [administradores do site](/rest/overview/resources-in-the-rest-api#authentication) autenticados.* Usuários normais receberão uma mensagem `404` se tentarem acessá-la. {% for operation in currentRestOperations %} {% if operation.subcategory == 'search-indexing' %}{% include rest_operation %}{% endif %} @@ -320,7 +319,7 @@ The Search Indexing API allows you to queue up a variety of search indexing task ## Usuários -The User Administration API allows you to promote, demote, suspend, and unsuspend users on a {% data variables.product.prodname_ghe_server %} appliance. *Só está disponível para [administradores do site](/rest/overview/resources-in-the-rest-api#authentication) autenticados.* Usuários normais receberão uma mensagem `403` se tentarem acessá-la. +A API de Administração do Usuário permite que você promova, rebaixe, suspenda, e cancele a suspensão dos usuários em um aplicativo de {% data variables.product.prodname_ghe_server %}. *Só está disponível para [administradores do site](/rest/overview/resources-in-the-rest-api#authentication) autenticados.* Usuários normais receberão uma mensagem `403` se tentarem acessá-la. {% for operation in currentRestOperations %} {% if operation.subcategory == 'users' %}{% include rest_operation %}{% endif %} diff --git a/translations/pt-BR/content/rest/reference/gists.md b/translations/pt-BR/content/rest/reference/gists.md index 1080df5598d7..878140435014 100644 --- a/translations/pt-BR/content/rest/reference/gists.md +++ b/translations/pt-BR/content/rest/reference/gists.md @@ -9,26 +9,26 @@ versions: ### Autenticação -You can read public gists {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "2.9" %}and create them for anonymous users without a token.{% else %} anonymously, but you must be signed into GitHub to create gists.{% endif %} To read or write gists on a user's behalf, you need the gist OAuth scope and a token. For more information, see "[Scopes for OAuth Apps](/developers/apps/scopes-for-oauth-apps)." +Você pode ler gists públicos {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "2.9" %}e criá-los para usuários anônimos sem um token.{% else %} anonimamente,. No entanto, você deve entrar no GitHub para criar gists.{% endif %} Para ler ou escrever gists em nome do usuário, você precisa do escopo do OAuth e um token. Para obter mais informações, consulte "[Escopos para aplicativos OAuth](/developers/apps/scopes-for-oauth-apps)." -### Truncation +### Truncamento -The Gist API provides up to one megabyte of content for each file in the gist. Each file returned for a gist through the API has a key called `truncated`. If `truncated` is `true`, the file is too large and only a portion of the contents were returned in `content`. +A API de Gist fornece até um megabyte de conteúdo para cada arquivo no gist. Cada arquivo retornado por um gist através da API tem uma chave denominada `truncada`. Se `truncado` for `verdadeiro`, significa que arquivo é muito grande e apenas uma parte do conteúdo foi retornado em `conteúdo`. -If you need the full contents of the file, you can make a `GET` request to the URL specified by `raw_url`. Be aware that for files larger than ten megabytes, you'll need to clone the gist via the URL provided by `git_pull_url`. +Se você precisar do conteúdo completo do arquivo, você pode fazer uma solicitação `GET` para a URL especificada por `raw_url`. Tenha em mente que, para arquivos maiores que dez megabytes, você deverá clonar o gist através da URL fornecida por `git_pull_url`. -In addition to a specific file's contents being truncated, the entire files list may be truncated if the total number exceeds 300 files. If the top level `truncated` key is `true`, only the first 300 files have been returned in the files list. If you need to fetch all of the gist's files, you'll need to clone the gist via the URL provided by `git_pull_url`. +Além do conteúdo de um arquivo específico ser truncado, toda a lista de arquivos pode ser truncada se o número total exceder 300 arquivos. Se a chave de nível superior `truncado` é `verdadeira`, apenas os primeiros 300 arquivos foram retornados na lista de arquivos. Se você precisar buscar todos os arquivos do gist, você deverá clonar o gist através da URL fornecida por `git_pull_url`. -### Custom media types for gists +### Tipos de mídia personalizados para gists -These are the supported media types for fetching gist contents. +Estes são os tipos de mídia compatíveis para buscar conteúdo geral. application/vnd.github.VERSION.raw application/vnd.github.VERSION.base64 -For more information, see "[Media types](/rest/overview/media-types)." +Para obter mais informações, consulte "[Tipos de mídia](/rest/overview/media-types)". {% for operation in currentRestOperations %} {% unless operation.subcategory %}{% include rest_operation %}{% endunless %} @@ -36,14 +36,14 @@ For more information, see "[Media types](/rest/overview/media-types)." ## Comentários -### Custom media types for Gist comments +### Tipos de mídia personalizados para comentários do Gist -These are the supported media types for gist comments. +Estes são os tipos de mídia compatíveis para comentários de gist. application/vnd.github.VERSION.raw application/vnd.github.VERSION.base64 -For more information about media types, see "[Custom media types](/rest/overview/media-types)." +Para obter mais informações sobre os tipos de mídia, consulte "[Tipos de mídia personalizados](/rest/overview/media-types)". {% for operation in currentRestOperations %} {% if operation.subcategory == 'comments' %}{% include rest_operation %}{% endif %} diff --git a/translations/pt-BR/content/rest/reference/git.md b/translations/pt-BR/content/rest/reference/git.md index 80f6ae90e22f..eaacda37c377 100644 --- a/translations/pt-BR/content/rest/reference/git.md +++ b/translations/pt-BR/content/rest/reference/git.md @@ -1,5 +1,5 @@ --- -title: Git database +title: Banco de dados do Git allowTitleToDifferFromFilename: true redirect_from: - /v3/git @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -A API do banco de dados do Git dá acesso para ler e gravar objetos do Git sem processamento no seu banco de dados do Git no {% data variables.product.product_name %} e para listar e atualizar suas referências (cabeçalhos de branch e etiquetas). For more information about using the Git Database API, see "[Getting started with the Git data API](/rest/guides/getting-started-with-the-git-database-api)." +A API do banco de dados do Git dá acesso para ler e gravar objetos do Git sem processamento no seu banco de dados do Git no {% data variables.product.product_name %} e para listar e atualizar suas referências (cabeçalhos de branch e etiquetas). Para obter mais informações sobre como usar a API do banco de dados do Git, consulte "[Começar com a API de dados do Git](/rest/guides/getting-started-with-the-git-database-api)". {% for operation in currentRestOperations %} {% unless operation.subcategory %}{% include rest_operation %}{% endunless %} @@ -16,16 +16,16 @@ A API do banco de dados do Git dá acesso para ler e gravar objetos do Git sem p ## Blobs -A Git blob (binary large object) is the object type used to store the contents of each file in a repository. The file's SHA-1 hash is computed and stored in the blob object. These endpoints allow you to read and write [blob objects](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects) to your Git database on {% data variables.product.product_name %}. Blobs leverage [these custom media types](#custom-media-types). Você pode ler mais sobre o uso de tipos de mídia na API [aqui](/rest/overview/media-types). +Um blob (objeto binário grande) do Git é o tipo de objeto usado para armazenar o conteúdo de cada arquivo em um repositório. O hash SHA-1 do arquivo é calculado e armazenado no objeto do blob. Estes pontos de extremidade permitem ler e escrever [objetos do blob](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects) em seu banco de dados d Git em {% data variables.product.product_name %}. Os blobs aproveitam [esses tipos de mídia personalizados](#custom-media-types). Você pode ler mais sobre o uso de tipos de mídia na API [aqui](/rest/overview/media-types). -### Custom media types for blobs +### Tipos de mídia personalizados para os blobs -These are the supported media types for blobs. +Estes são os tipos de mídia compatíveis com blobs. application/json application/vnd.github.VERSION.raw -For more information, see "[Media types](/rest/overview/media-types)." +Para obter mais informações, consulte "[Tipos de mídia](/rest/overview/media-types)". {% for operation in currentRestOperations %} {% if operation.subcategory == 'blobs' %}{% include rest_operation %}{% endif %} @@ -33,15 +33,15 @@ For more information, see "[Media types](/rest/overview/media-types)." ## Commits -A Git commit is a snapshot of the hierarchy ([Git tree](/v3/git/trees)) and the contents of the files ([Git blob](/v3/git/blobs)) in a Git repository. These endpoints allow you to read and write [commit objects](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects#Commit-Objects) to your Git database on {% data variables.product.product_name %}. +Um commit do Git é um instantâneo da hierarquia ([árvore do Git](/v3/git/trees)) e o conteúdo dos arquivos ([Blob do Git](/v3/git/blobs)) em um repositório do Git. Estes pontos de extremidade permitem ler e escrever [objetos de commit](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects#Commit-Objects) no seu banco de dados do Git em {% data variables.product.product_name %}. {% for operation in currentRestOperations %} {% if operation.subcategory == 'commits' %}{% include rest_operation %}{% endif %} {% endfor %} -## References +## Referências -A Git reference (`git ref`) is just a file that contains a Git commit SHA-1 hash. When referring to a Git commit, you can use the Git reference, which is an easy-to-remember name, rather than the hash. The Git reference can be rewritten to point to a new commit. A branch is just a Git reference that stores the new Git commit hash. These endpoints allow you to read and write [references](https://git-scm.com/book/en/v1/Git-Internals-Git-References) to your Git database on {% data variables.product.product_name %}. +Uma referência do Git (`git ref`) é apenas um arquivo que contém um hash SHA-1 do commit do Git. Ao referir-se a um commit do Git, você pode usar a referência do Git, que é um nome fácil de lembrar, em vez do hash. A referência do Git pode ser reescrita para apontar para um novo commit. Um branch é apenas uma referência do Git que armazena o novo hash de commit do Git. Estes pontos de extremidade permitem ler e escrever [referências](https://git-scm.com/book/en/v1/Git-Internals-Git-References) para o seu banco de dados do Git em {% data variables.product.product_name %}. {% for operation in currentRestOperations %} {% if operation.subcategory == 'refs' %}{% include rest_operation %}{% endif %} @@ -49,15 +49,15 @@ A Git reference (`git ref`) is just a file that contains a Git commit SHA-1 hash ## Tags -A Git tag is similar to a [Git reference](/v3/git/refs), but the Git commit that it points to never changes. Git tags are helpful when you want to point to specific releases. These endpoints allow you to read and write [tag objects](https://git-scm.com/book/en/v1/Git-Internals-Git-References#Tags) to your Git database on {% data variables.product.product_name %}. The Git tags API only supports [annotated tag objects](https://git-scm.com/book/en/v1/Git-Internals-Git-References#Tags), not lightweight tags. +Uma tag do Git é semelhante a uma [Referência do Git](/v3/git/refs), mas o commit do Git para o qual ela aponta nunca muda. As tags do Git são úteis quando você deseja apontar para versões específicas. Esses pontos de extremidade permitem ler e escrever [tags dos objetos](https://git-scm.com/book/en/v1/Git-Internals-Git-References#Tags) em seu banco de dados Git em {% data variables.product.product_name %}. A API de tags do Git é compatível apenas com [objetos de tags anotadas](https://git-scm.com/book/en/v1/Git-Internals-Git-References#Tags), não tags leves. {% for operation in currentRestOperations %} {% if operation.subcategory == 'tags' %}{% include rest_operation %}{% endif %} {% endfor %} -## Trees +## Árvores -A Git tree object creates the hierarchy between files in a Git repository. You can use the Git tree object to create the relationship between directories and the files they contain. These endpoints allow you to read and write [tree objects](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects#Tree-Objects) to your Git database on {% data variables.product.product_name %}. +Um objeto da árvore do Git cria a hierarquia entre arquivos em um repositório do Git. Você pode usar o objeto da árvore do Git para criar a relação entre diretórios e os arquivos que eles contêm. Estes pontos de extremidade permitem que você leia e escreva [objetos de árvore](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects#Tree-Objects) em seu banco de dados do Git em {% data variables.product.product_name %}. {% for operation in currentRestOperations %} {% if operation.subcategory == 'trees' %}{% include rest_operation %}{% endif %} diff --git a/translations/pt-BR/content/rest/reference/gitignore.md b/translations/pt-BR/content/rest/reference/gitignore.md index 137bdaf63852..51a01b94760e 100644 --- a/translations/pt-BR/content/rest/reference/gitignore.md +++ b/translations/pt-BR/content/rest/reference/gitignore.md @@ -7,14 +7,14 @@ versions: enterprise-server: '*' --- -When you create a new {% data variables.product.product_name %} repository via the API, you can specify a [.gitignore template](/github/using-git/ignoring-files) to apply to the repository upon creation. The .gitignore templates API lists and fetches templates from the {% data variables.product.product_name %} [.gitignore repository](https://github.com/github/gitignore). +Ao criar um novo repositório do {% data variables.product.product_name %} através da API, você pode especificar um [modelo do .gitignore](/github/using-git/ignoring-files) a ser aplicado ao repositório após a criação. A API de modlos do .gitignore lista e recupera modelos do repositório de [.gitignore](https://github.com/github/gitignore) de {% data variables.product.product_name %}. -### Custom media types for gitignore +### Tipos de mídia personalizados para gitignore -You can use this custom media type when getting a gitignore template. +Você pode usar este tipo de mídia personalizada ao obter um modelo de gitignore. application/vnd.github.VERSION.raw -For more information, see "[Media types](/rest/overview/media-types)." +Para obter mais informações, consulte "[Tipos de mídia](/rest/overview/media-types)". {% include rest_operations_at_current_path %} diff --git a/translations/pt-BR/content/rest/reference/index.md b/translations/pt-BR/content/rest/reference/index.md index 5cc2f77386c8..a7fd59f4d4d2 100644 --- a/translations/pt-BR/content/rest/reference/index.md +++ b/translations/pt-BR/content/rest/reference/index.md @@ -1,7 +1,7 @@ --- title: Referência shortTitle: Referência -intro: View reference documentation to learn about the resources available in the GitHub REST API. +intro: Veja documentação de referência para aprender os recursos disponíveis na API REST do GitHub. versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/pt-BR/content/rest/reference/interactions.md b/translations/pt-BR/content/rest/reference/interactions.md index 980576b8bf67..38a825112d21 100644 --- a/translations/pt-BR/content/rest/reference/interactions.md +++ b/translations/pt-BR/content/rest/reference/interactions.md @@ -1,12 +1,12 @@ --- -title: Interactions +title: Interações redirect_from: - /v3/interactions versions: free-pro-team: '*' --- -Users interact with repositories by commenting, opening issues, and creating pull requests. The Interactions APIs allow people with owner or admin access to temporarily restrict certain users from interacting with public repositories. +Os usuários interagem com repositórios comentando, abrindo problemas e criando pull requests. As APIs de interações permitem que pessoas com acesso de proprietário ou administrador restrinjam temporariamente certos usuários de interagir com repositórios públicos. {% for operation in currentRestOperations %} {% unless operation.subcategory %}{% include rest_operation %}{% endunless %} @@ -14,11 +14,11 @@ Users interact with repositories by commenting, opening issues, and creating pul ## organização -The Organization Interactions API allows organization owners to temporarily restrict which users can comment, open issues, or create pull requests in the organization's public repositories. {% data reusables.interactions.interactions-detail %} Here's more about the groups of {% data variables.product.product_name %} users: +A API de Interações da Organização permite que os proprietários da organização restrinjam temporariamente quais usuários podem comentar, abrir problemas ou criar pull requests nos repositórios públicos da organização. {% data reusables.interactions.interactions-detail %} Veja mais sobre os grupos de usuários do {% data variables.product.product_name %}: -* {% data reusables.interactions.existing-user-limit-definition %} in the organization. -* {% data reusables.interactions.contributor-user-limit-definition %} in the organization. -* {% data reusables.interactions.collaborator-user-limit-definition %} in the organization. +* {% data reusables.interactions.existing-user-limit-definition %} na organização. +* {% data reusables.interactions.contributor-user-limit-definition %} na organização. +* {% data reusables.interactions.collaborator-user-limit-definition %} na organização. {% for operation in currentRestOperations %} {% if operation.subcategory == 'orgs' %}{% include rest_operation %}{% endif %} @@ -26,7 +26,7 @@ The Organization Interactions API allows organization owners to temporarily rest ## Repositório -The Repository Interactions API allows people with owner or admin access to temporarily restrict which users can comment, open issues, or create pull requests in a public repository. {% data reusables.interactions.interactions-detail %} Here's more about the groups of {% data variables.product.product_name %} users: +A API de Interações do Repositório permite que pessoas com acesso de proprietário ou administrador restrinjam temporariamente quais usuários podem comentar, abrir problemas ou criar pull requests em um repositório público. {% data reusables.interactions.interactions-detail %} Veja mais sobre os grupos de usuários do {% data variables.product.product_name %}: * {% data reusables.interactions.existing-user-limit-definition %} in the respository. * {% data reusables.interactions.contributor-user-limit-definition %} in the respository. diff --git a/translations/pt-BR/content/rest/reference/issues.md b/translations/pt-BR/content/rest/reference/issues.md index 2988f9647819..ba5ae65effa3 100644 --- a/translations/pt-BR/content/rest/reference/issues.md +++ b/translations/pt-BR/content/rest/reference/issues.md @@ -7,16 +7,16 @@ versions: enterprise-server: '*' --- -### Custom media types for issues +### Tipos de mídia personalizados para problemas -These are the supported media types for issues. +Estes são os tipos de mídia compatíveis para problemas. application/vnd.github.VERSION.raw+json application/vnd.github.VERSION.text+json application/vnd.github.VERSION.html+json application/vnd.github.VERSION.full+json -For more information about media types, see "[Custom media types](/rest/overview/media-types)." +Para obter mais informações sobre os tipos de mídia, consulte "[Tipos de mídia personalizados](/rest/overview/media-types)". {% for operation in currentRestOperations %} {% unless operation.subcategory %}{% include rest_operation %}{% endunless %} @@ -30,9 +30,9 @@ For more information about media types, see "[Custom media types](/rest/overview ## Comentários -The Issue Comments API supports listing, viewing, editing, and creating comments on issues and pull requests. +A API de Comentários do Problema é compatível com listagem, visualização, edição e criação de comentários em problemas e pull requests. -Issue Comments use [these custom media types](#custom-media-types). You can read more about the use of media types in the API [here](/v3/media/). +Os comentários do problema usam [estes tipos de mídia personalizados](#custom-media-types). Você pode ler mais sobre o uso de tipos de mídia na API [aqui](/v3/media/). {% for operation in currentRestOperations %} {% if operation.subcategory == 'comments' %}{% include rest_operation %}{% endif %} @@ -40,7 +40,7 @@ Issue Comments use [these custom media types](#custom-media-types). You can read ## Eventos -The Issue Events API can return different types of events triggered by activity in issues and pull requests. The Issue Events API can return different types of events triggered by activity in issues and pull requests. For more information about the specific events that you can receive from the Issue Events API, see "[Issue event types](/developers/webhooks-and-events/issue-event-types)." For more information, see the "[Events API](/developers/webhooks-and-events/github-event-types)." +A API de Eventos de problema pode retornar diferentes tipos de eventos desencadeados por atividades em problemas e pull requests. The Issue Events API can return different types of events triggered by activity in issues and pull requests. For more information about the specific events that you can receive from the Issue Events API, see "[Issue event types](/developers/webhooks-and-events/issue-event-types)." Para obter mais informações, consulte a "[API de Eventos](/developers/webhooks-and-events/github-event-types)". {% for operation in currentRestOperations %} {% if operation.subcategory == 'events' %}{% include rest_operation %}{% endif %} @@ -60,9 +60,9 @@ The Issue Events API can return different types of events triggered by activity ## Linha do tempo -The Timeline Events API can return different types of events triggered by timeline activity in issues and pull requests. The Issue Events API can return different types of events triggered by activity in issues and pull requests. For more information about the specific events that you can receive from the Issue Events API, see "[Issue event types](/developers/webhooks-and-events/issue-event-types)." For more information, see the "[GitHub Events API](/developers/webhooks-and-events/github-event-types)." +A API de Eventos da Linha do Tempo pode retornar diferentes tipos de eventos acionados pela atividade da linha do tempo em problemas e pull requests. The Issue Events API can return different types of events triggered by activity in issues and pull requests. For more information about the specific events that you can receive from the Issue Events API, see "[Issue event types](/developers/webhooks-and-events/issue-event-types)." Para obter mais informações, consulte a "[API de Eventos do GitHub](/developers/webhooks-and-events/github-event-types)". -You can use this API to display information about issues and pull request or determine who should be notified of issue comments. +Você pode usar esta API para exibir informações sobre problemas e pull request ou determinar quem deve ser notificado sobre os comentários de problema. {% for operation in currentRestOperations %} {% if operation.subcategory == 'timeline' %}{% include rest_operation %}{% endif %} diff --git a/translations/pt-BR/content/rest/reference/licenses.md b/translations/pt-BR/content/rest/reference/licenses.md index 40fede506565..2a979f1af025 100644 --- a/translations/pt-BR/content/rest/reference/licenses.md +++ b/translations/pt-BR/content/rest/reference/licenses.md @@ -7,26 +7,26 @@ versions: enterprise-server: '*' --- -The Licenses API returns metadata about popular open source licenses and information about a particular project's license file. +A API de Licenças retorna metadados sobre as licenças de código aberto populares e informações sobre o arquivo de licença de um determinado projeto. -The Licenses API uses [the open source Ruby Gem Licensee](https://github.com/benbalter/licensee) to attempt to identify the project's license. Licensee matches the contents of a project's `LICENSE` file (if it exists) against a short list of known licenses. As a result, the API does not take into account the licenses of project dependencies or other means of documenting a project's license such as references to the license name in the documentation. +A API de Licenças usa [a Licença de código aberto do Gem do Ruby](https://github.com/benbalter/licensee) para tentar identificar a licença do projeto. A licença corresponde ao conteúdo do arquivo `LICENÇA` de um projeto (se existir) em comparação com uma pequena lista de licenças conhecidas. Como resultado, a API não leva em conta as licenças das dependências do projeto ou outros meios de documentar a licença de um projeto, como, por exemplo, referências ao nome da licença na documentação. -If a license is matched, the license key and name returned conforms to the [SPDX specification](https://spdx.org/). +Se uma licença for correspondida, a chave da licença e o nome retornados serão conformes à [especificação SPDX](https://spdx.org/). -**Note:** These endpoints will also return a repository's license information: +**Observação:** Estes pontos de extremidade também retornarão informações de licença de um repositório: - [Obter um repositório](/v3/repos/#get-a-repository) - [Listar repositórios para um usuário](/v3/repos/#list-repositories-for-a-user) - [Listar repositórios da organização](/v3/repos/#list-organization-repositories) -- [Listar bifurcações](/v3/repos/forks/#list-forks) -- [Listar repositórios inspecionados por um usuário](/v3/activity/watching/#list-repositories-watched-by-a-user) +- [Listar bifurcações](/rest/reference/repos#list-forks) +- [Listar repositórios inspecionados por um usuário](/rest/reference/activity#list-repositories-watched-by-a-user) - [Listar repositórios da equipe](/v3/teams/#list-team-repositories) {% warning %} -GitHub is a lot of things, but it’s not a law firm. As such, GitHub does not provide legal advice. Using the Licenses API or sending us an email about it does not constitute legal advice nor does it create an attorney-client relationship. If you have any questions about what you can and can't do with a particular license, you should consult with your own legal counsel before moving forward. In fact, you should always consult with your own lawyer before making any decisions that might have legal ramifications or that may impact your legal rights. +O GitHub pode ser muitas coisas, mas não é um escritório de advocacia. Como tal, o GitHub não oferece aconselhamento jurídico. Usar a API de licenças ou enviar-nos um e-mail sobre a mesma não constitui aconselhamento jurídico, nem cria uma relação advogado e cliente. Em caso de dúvida sobre o que se pode e não se pode fazer com uma licença específica, antes de avançar, você deverá buscar orientação jurídica antes de seguir em frente. Na verdade, você deve sempre consultar o seu próprio advogado antes de tomar decisões que possam ter desdobramentos jurídicos ou que possam afetar seus direitos. -GitHub created the License API to help users get information about open source licenses and the projects that use them. We hope it helps, but please keep in mind that we’re not lawyers (at least not most of us aren't) and that we make mistakes like everyone else. For that reason, GitHub provides the API on an “as-is” basis and makes no warranties regarding any information or licenses provided on or through it, and disclaims liability for damages resulting from using the API. +O GitHub criou a API da licença para ajudar os usuários a obter informações sobre licenças de código aberto e os projetos que as utilizam. Esperamos que ajude. No entanto, tenha em mente que não somos advogados (pelo menos não a maioria de nós) e que cometemos erros como qualquer um. Por esse motivo, o GitHub fornece a API numa base "como se apresenta" e não faz garantias sobre quaisquer informações ou licenças fornecidas em ou através dela, além de eximir-se da responsabilidade por danos resultantes do uso da API. {% endwarning %} diff --git a/translations/pt-BR/content/rest/reference/migrations.md b/translations/pt-BR/content/rest/reference/migrations.md index a2f100888b79..2b27e372d0e7 100644 --- a/translations/pt-BR/content/rest/reference/migrations.md +++ b/translations/pt-BR/content/rest/reference/migrations.md @@ -14,7 +14,7 @@ versions: ## organização -The Migrations API is only available to authenticated organization owners. For more information, see "[Permission levels for an organization](/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization#permission-levels-for-an-organization)" and "[Other authentication methods](/rest/overview/other-authentication-methods)." +A API de migrações só está disponível para os proprietários de organizações autenticadas. Para obter mais informações, consulte "[Níveis de permissão para uma organização](/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization#permission-levels-for-an-organization)" e "[Outros métodos de autenticação](/rest/overview/other-authentication-methods)". {% data variables.migrations.organization_migrations_intro %} @@ -22,13 +22,13 @@ The Migrations API is only available to authenticated organization owners. For m {% if operation.subcategory == 'orgs' %}{% include rest_operation %}{% endif %} {% endfor %} -## Source imports +## Importações de código-fonte {% data variables.migrations.source_imports_intro %} -A typical source import would start the import and then (optionally) update the authors and/or update the preference for using Git LFS if large files exist in the import. You can also create a webhook that listens for the [`RepositoryImportEvent`](/developers/webhooks-and-events/webhook-events-and-payloads#repository_import) to find out the status of the import. +Uma importação de código-fonte típica iniciaria a importação e, em seguida, (opcionalmente) atualizaria os autores e/ou atualizaria a preferência pelo uso do LFS do Git se existirem arquivos grandes na importação. Também é possível criar um webhook que ouve o [`ReposityImportEvent`](/developers/webhooks-and-events/webhook-events-and-payloads#repository_import) para descobrir o status da importação. -A more detailed example can be seen in this diagram: +Um exemplo mais detalhado pode ser visto neste diagrama: ``` +---------+ +--------+ +---------------------+ @@ -109,13 +109,13 @@ A more detailed example can be seen in this diagram: ## Usuário -The User migrations API is only available to authenticated account owners. For more information, see "[Other authentication methods](/rest/overview/other-authentication-methods)." +A API de migrações do usuário só está disponível para proprietários de contas autenticadas. Para obter mais informações, consulte "[Outros métodos de autenticação](/rest/overview/other-authentication-methods)". -{% data variables.migrations.user_migrations_intro %} For a list of migration data that you can download, see "[Download a user migration archive](#download-a-user-migration-archive)." +{% data variables.migrations.user_migrations_intro %} Para obter uma lista dos dados de migração que você pode baixar, consulte "[Fazer download de um arquivo de migração do usuário](#download-a-user-migration-archive)". -To download an archive, you'll need to start a user migration first. Once the status of the migration is `exported`, you can download the migration. +Para fazer o download de um arquivo, você deverá iniciar uma migração de usuário primeiro. Uma vez que o status da migração é `exportado`, você pode fazer o download da migração. -Once you've created a migration archive, it will be available to download for seven days. But, you can delete the user migration archive sooner if you'd like. You can unlock your repository when the migration is `exported` to begin using your repository again or delete the repository if you no longer need the source data. +Ao criar um arquivo de migração, ele ficará disponível para download por sete dias. No entanto, você pode excluir o arquivo de migração do usuário mais cedo, se desejar. Você pode desbloquear o repositório quando a migração for `exportada` para começar a usar seu repositório novamente ou excluir o repositório se não precisar mais dos dados do código-fonte. {% for operation in currentRestOperations %} {% if operation.subcategory == 'users' %}{% include rest_operation %}{% endif %} diff --git a/translations/pt-BR/content/rest/reference/oauth-authorizations.md b/translations/pt-BR/content/rest/reference/oauth-authorizations.md index 8bb3e8fa72cc..5c84f6084fe6 100644 --- a/translations/pt-BR/content/rest/reference/oauth-authorizations.md +++ b/translations/pt-BR/content/rest/reference/oauth-authorizations.md @@ -1,5 +1,5 @@ --- -title: OAuth Authorizations +title: Autorizações do OAuth redirect_from: - /v3/oauth_authorizations - /v3/oauth-authorizations @@ -11,8 +11,8 @@ versions: {% data reusables.apps.deprecating_token_oauth_authorizations %} {% data reusables.apps.deprecating_password_auth %} -You can use this API to manage the access OAuth applications have to your account. You can only access this API via [Basic Authentication](/rest/overview/other-authentication-methods#basic-authentication) using your username and password, not tokens. +Você pode usar esta API para gerenciar o acesso do aplicativo OAuth à sua conta. Você só pode acessar esta API através da [Autenticação básica](/rest/overview/other-authentication-methods#basic-authentication) usando seu nome de usuário e senha, não tokens. -If you or your users have two-factor authentication enabled, make sure you understand how to [work with two-factor authentication](/rest/overview/other-authentication-methods#working-with-two-factor-authentication). +Se você ou seus usuários tiverem a autenticação de dois fatores habilitada, certifique-se de entender como [trabalhar com autenticação de dois fatores](/rest/overview/other-authentication-methods#working-with-two-factor-authentication). {% include rest_operations_at_current_path %} diff --git a/translations/pt-BR/content/rest/reference/orgs.md b/translations/pt-BR/content/rest/reference/orgs.md index d33c54159f98..93df7c620986 100644 --- a/translations/pt-BR/content/rest/reference/orgs.md +++ b/translations/pt-BR/content/rest/reference/orgs.md @@ -12,9 +12,9 @@ versions: {% unless operation.subcategory %}{% include rest_operation %}{% endunless %} {% endfor %} -## Blocking users +## Bloquear usuários -The token used to authenticate the call must have the `admin:org` scope in order to make any blocking calls for an organization. Otherwise, the response returns `HTTP 404`. +O token usado para autenticar a chamada deve ter o escopo `admin:org` para fazer quaisquer chamadas de bloqueio para uma organização. Caso contrário, a resposta retornará `HTTP 404`. {% for operation in currentRestOperations %} {% if operation.subcategory == 'blocking' %}{% include rest_operation %}{% endif %} @@ -34,26 +34,26 @@ The token used to authenticate the call must have the `admin:org` scope in order ## Webhooks -Organization webhooks allow you to receive HTTP `POST` payloads whenever certain events happen within the organization. Subscribing to these events makes it possible to build integrations that react to actions on {% data variables.product.prodname_dotcom %}.com. For more information on actions you can subscribe to, see "[{% data variables.product.prodname_dotcom %} event types](/developers/webhooks-and-events/github-event-types)." +Os webhooks da organização permitem que você receba cargas de HTTP do tipo `POST` sempre que certos eventos ocorrerem dentro da organização. Assinar esses eventos possibilita a construção de integrações que reajam às ações em {% data variables.product.prodname_dotcom %}.com. Para obter mais informações sobre ações que você pode assinar, consulte "[ tipos de evento de {% data variables.product.prodname_dotcom %}](/developers/webhooks-and-events/github-event-types)". -### Scopes & Restrictions +### Escopos & Restrições -All actions against organization webhooks require the authenticated user to be an admin of the organization being managed. Additionally, OAuth tokens require the `admin:org_hook` scope. For more information, see "[Scopes for OAuth Apps](/developers/apps/scopes-for-oauth-apps)." +Todas as ações contra webhooks da organização exigem que o usuário autenticado seja um administrador da organização que está sendo gerenciada. Além disso, os tokens do OAuth requerem o escopo `admin:org_hook`. Para obter mais informações, consulte "[Escopos para aplicativos OAuth](/developers/apps/scopes-for-oauth-apps)." -In order to protect sensitive data which may be present in webhook configurations, we also enforce the following access control rules: +Para proteger dados sensíveis que podem estar presentes nas configurações do webhook, também aplicamos as seguintes regras de controle de acesso: -- OAuth applications cannot list, view, or edit webhooks which they did not create. -- Users cannot list, view, or edit webhooks which were created by OAuth applications. +- Os aplicativos OAuth não podem listar, visualizar ou editar webhooks que não criaram. +- Os usuários não podem listar, visualizar ou editar webhooks que foram criados por aplicativos OAuth. -### Receiving Webhooks +### Receber Webhooks -In order for {% data variables.product.product_name %} to send webhook payloads, your server needs to be accessible from the Internet. We also highly suggest using SSL so that we can send encrypted payloads over HTTPS. +Para que {% data variables.product.product_name %} envie cargas de webhook, seu servidor deve ser acessível pela internet. É altamente recomendável o uso de SSL para que possamos enviar cargas criptografadas por HTTPS. -For more best practices, [see our guide](/guides/best-practices-for-integrators/). +Para obter mais práticas recomendadas, [consulte nosso guia](/guides/best-practices-for-integrators/). -#### Webhook headers +#### Cabeçalhos de webhook -{% data variables.product.product_name %} will send along several HTTP headers to differentiate between event types and payload identifiers. See [webhook headers](/webhooks/event-payloads/#delivery-headers) for details. +{% data variables.product.product_name %} enviará ao longo de vários cabeçalhos de HTTP para diferenciar entre tipos de evento e identificadores de carga. Consulte [cabeçalhos de webhook](/webhooks/event-payloads/#delivery-headers) para obter informações. {% for operation in currentRestOperations %} {% if operation.subcategory == 'hooks' %}{% include rest_operation %}{% endif %} diff --git a/translations/pt-BR/content/rest/reference/permissions-required-for-github-apps.md b/translations/pt-BR/content/rest/reference/permissions-required-for-github-apps.md index 5c7e07d4766c..616103e4c8cf 100644 --- a/translations/pt-BR/content/rest/reference/permissions-required-for-github-apps.md +++ b/translations/pt-BR/content/rest/reference/permissions-required-for-github-apps.md @@ -1,29 +1,28 @@ --- -title: Permissions required for GitHub Apps -intro: 'You can find the required permissions for each {% data variables.product.prodname_github_app %}-compatible endpoint.' +title: Permissões necessárias para os aplicativos GitHub +intro: 'Você pode encontrar as permissões necessárias para cada ponto de extremidade compatível com {% data variables.product.prodname_github_app %}.' redirect_from: - - /v3/apps/permissions --- + - /v3/apps/permissions versions: free-pro-team: '*' enterprise-server: '*' --- -### About {% data variables.product.prodname_github_app %} permissions +### Sobre as permissões de {% data variables.product.prodname_github_app %} -{% data variables.product.prodname_github_app %}s are created with a set of permissions. Permissions define what resources the {% data variables.product.prodname_github_app %} can access via the API. For more information, see "[Setting permissions for GitHub Apps](/apps/building-github-apps/setting-permissions-for-github-apps/)." +{% data variables.product.prodname_github_app %}s são criados com um conjunto de permissões. As permissões definem quais recursos o {% data variables.product.prodname_github_app %} pode acessar através da API. Para obter mais informações, consulte "[Configurações de permissões para os aplicativos GitHub](/apps/building-github-apps/setting-permissions-for-github-apps/)". ### Permissões de metadados -GitHub Apps have the `Read-only` metadata permission by default. The metadata permission provides access to a collection of read-only endpoints with metadata for various resources. These endpoints do not leak sensitive private repository information. +Os aplicativos GitHub têm a permissão de metadados `Read-only` por padrão. A permissão de metadados fornece acesso a uma coleção de pontos de extremidade somente leitura com metadados para vários recursos. Esses pontos de extremidade não vazam informações privadas sobre repositórios. {% data reusables.apps.metadata-permissions %} - - [`GET /`](/v3/#root-endpoint) - [`GET /codes_of_conduct`](/v3/codes_of_conduct/#get-all-codes-of-conduct) - [`GET /codes_of_conduct/:key`](/v3/codes_of_conduct/#get-a-code-of-conduct) - [`GET /emojis`](/v3/emojis/#emojis) -- [`GET /feeds`](/v3/activity/feeds/#get-feeds) +- [`GET /feeds`](/rest/reference/activity#get-feeds) - [`GET /licenses`](/v3/licenses/#get-all-commonly-used-licenses) - [`GET /licenses/:key`](/v3/licenses/#get-a-license) - [`POST /markdown`](/v3/markdown/#render-a-markdown-document) @@ -39,22 +38,22 @@ GitHub Apps have the `Read-only` metadata permission by default. The metadata pe - [`GET /repos/:owner/:repo/community/profile`](/v3/repos/community/#get-community-profile-metrics) {% endif %} - [`GET /repos/:owner/:repo/contributors`](/v3/repos/#list-repository-contributors) -- [`GET /repos/:owner/:repo/forks`](/v3/repos/forks/#list-forks) +- [`GET /repos/:owner/:repo/forks`](/rest/reference/repos#list-forks) - [`GET /repos/:owner/:repo/languages`](/v3/repos/#list-repository-languages) - [`GET /repos/:owner/:repo/license`](/v3/licenses/#get-the-license-for-a-repository) -- [`GET /repos/:owner/:repo/stargazers`](/v3/activity/starring/#list-stargazers) +- [`GET /repos/:owner/:repo/stargazers`](/rest/reference/activity#list-stargazers) - [`GET /repos/:owner/:repo/stats/code_frequency`](/v3/repos/statistics/#get-the-weekly-commit-activity) - [`GET /repos/:owner/:repo/stats/commit_activity`](/v3/repos/statistics/#get-the-last-year-of-commit-activity) - [`GET /repos/:owner/:repo/stats/contributors`](/v3/repos/statistics/#get-all-contributor-commit-activity) - [`GET /repos/:owner/:repo/stats/participation`](/v3/repos/statistics/#get-the-weekly-commit-count) - [`GET /repos/:owner/:repo/stats/punch_card`](/v3/repos/statistics/#get-the-hourly-commit-count-for-each-day) -- [`GET /repos/:owner/:repo/subscribers`](/v3/activity/watching/#list-watchers) +- [`GET /repos/:owner/:repo/subscribers`](/rest/reference/activity#list-watchers) - [`GET /repos/:owner/:repo/tags`](/v3/repos/#list-repository-tags) - [`GET /repos/:owner/:repo/topics`](/v3/repos#get-all-repository-topics) - [`GET /repositories`](/v3/repos/#list-public-repositories) - [`GET /user/repos`](/v3/repos/#list-repositories-for-the-authenticated-user) -- [`GET /user/starred`](/v3/activity/starring/#list-repositories-starred-by-a-user) -- [`GET /user/subscriptions`](/v3/activity/watching/#list-repositories-watched-by-a-user) +- [`GET /user/starred`](/rest/reference/activity#list-repositories-starred-by-a-user) +- [`GET /user/subscriptions`](/rest/reference/activity#list-repositories-watched-by-a-user) - [`GET /users`](/v3/users/#list-users) - [`GET /users/:username`](/v3/users/#get-a-user) - [`GET /users/:username/followers`](/v3/users/followers/#list-followers-of-a-user) @@ -62,10 +61,10 @@ GitHub Apps have the `Read-only` metadata permission by default. The metadata pe - [`GET /users/:username/following/:target_user`](/v3/users/followers/#check-if-a-user-follows-another-user) - [`GET /users/:username/gpg_keys`](/v3/users/gpg_keys/#list-gpg-keys-for-a-user) - [`GET /users/:username/orgs`](/v3/orgs/#list-organizations-for-a-user) -- [`GET /users/:username/received_events`](/v3/activity/events/#list-events-received-by-the-authenticated-user) -- [`GET /users/:username/received_events/public`](/v3/activity/events/#list-public-events-received-by-a-user) +- [`GET /users/:username/received_events`](/rest/reference/activity#list-events-received-by-the-authenticated-user) +- [`GET /users/:username/received_events/public`](/rest/reference/activity#list-public-events-received-by-a-user) - [`GET /users/:username/repos`](/v3/repos/#list-repositories-for-a-user) -- [`GET /users/:username/subscriptions`](/v3/activity/watching/#list-repositories-watched-by-a-user) +- [`GET /users/:username/subscriptions`](/rest/reference/activity#list-repositories-watched-by-a-user) _Colaboradores_ - [`GET /repos/:owner/:repo/collaborators`](/v3/repos/collaborators/#list-repository-collaborators) @@ -78,21 +77,21 @@ _Comentários de commit_ - [`GET /repos/:owner/:repo/commits/:sha/comments`](/v3/repos/comments/#list-commit-comments) _Eventos_ -- [`GET /events`](/v3/activity/events/#list-public-events) -- [`GET /networks/:owner/:repo/events`](/v3/activity/events/#list-public-events-for-a-network-of-repositories) -- [`GET /orgs/:org/events`](/v3/activity/events/#list-public-organization-events) -- [`GET /repos/:owner/:repo/events`](/v3/activity/events/#list-repository-events) -- [`GET /users/:username/events`](/v3/activity/events/#list-events-for-the-authenticated-user) -- [`GET /users/:username/events/public`](/v3/activity/events/#list-public-events-for-a-user) +- [`GET /events`](/rest/reference/activity#list-public-events) +- [`GET /networks/:owner/:repo/events`](/rest/reference/activity#list-public-events-for-a-network-of-repositories) +- [`GET /orgs/:org/events`](/rest/reference/activity#list-public-organization-events) +- [`GET /repos/:owner/:repo/events`](/rest/reference/activity#list-repository-events) +- [`GET /users/:username/events`](/rest/reference/activity#list-events-for-the-authenticated-user) +- [`GET /users/:username/events/public`](/rest/reference/activity#list-public-events-for-a-user) _Git_ - [`GET /gitignore/templates`](/v3/gitignore/#get-all-gitignore-templates) - [`GET /gitignore/templates/:key`](/v3/gitignore/#get-a-gitignore-template) -_Keys_ +_Chaves_ - [`GET /users/:username/keys`](/v3/users/keys/#list-public-keys-for-a-user) -_Organization members_ +_Integrantes da organização_ - [`GET /orgs/:org/members`](/v3/orgs/members/#list-organization-members) - [`GET /orgs/:org/members/:username`](/v3/orgs/members/#check-organization-membership-for-a-user) - [`GET /orgs/:org/public_members`](/v3/orgs/members/#list-public-organization-members) @@ -108,7 +107,7 @@ _Pesquisar_ - [`GET /search/users`](/v3/search/#search-users) {% if currentVersion == "free-pro-team@latest" %} -### Permission on "actions" +### Permissão em "ações" - [`GET /repos/:owner/:repo/actions/artifacts`](/v3/actions/artifacts/#list-artifacts-for-a-repository) (:read) - [`GET /repos/:owner/:repo/actions/artifacts/:artifact_id`](/v3/actions/artifacts/#get-an-artifact) (:read) @@ -129,7 +128,7 @@ _Pesquisar_ - [`GET /repos/:owner/:repo/actions/workflows/:workflow_id/runs`](/v3/actions/workflow-runs/#list-workflow-runs) (:read) {% endif %} -### Permission on "administration" +### Permissão em "administração" - [`POST /orgs/:org/repos`](/v3/repos/#create-an-organization-repository) (:write) - [`PATCH /repos/:owner/:repo`](/v3/repos/#update-a-repository) (:write) @@ -169,7 +168,6 @@ _Pesquisar_ {% if currentVersion == "free-pro-team@latest" %} - [`DELETE /repos/:owner/:repo/vulnerability-alerts`](/v3/repos/#disable-vulnerability-alerts) (:write) {% endif %} -- [`POST /user/repos`](/v3/repos/#create-a-repository-for-the-authenticated-user) (:write) - [`PATCH /user/repository_invitations/:invitation_id`](/v3/repos/invitations/#accept-a-repository-invitation) (:write) - [`DELETE /user/repository_invitations/:invitation_id`](/v3/repos/invitations/#decline-a-repository-invitation) (:write) @@ -208,12 +206,12 @@ _Colaboradores_ - [`PUT /repos/:owner/:repo/collaborators/:username`](/v3/repos/collaborators/#add-a-repository-collaborator) (:write) - [`DELETE /repos/:owner/:repo/collaborators/:username`](/v3/repos/collaborators/#remove-a-repository-collaborator) (:write) -_Invitations_ +_Convites_ - [`GET /repos/:owner/:repo/invitations`](/v3/repos/invitations/#list-repository-invitations) (:read) - [`PATCH /repos/:owner/:repo/invitations/:invitation_id`](/v3/repos/invitations/#update-a-repository-invitation) (:write) - [`DELETE /repos/:owner/:repo/invitations/:invitation_id`](/v3/repos/invitations/#delete-a-repository-invitation) (:write) -_Keys_ +_Chaves_ - [`GET /repos/:owner/:repo/keys`](/v3/repos/keys/#list-deploy-keys) (:read) - [`POST /repos/:owner/:repo/keys`](/v3/repos/keys/#create-a-deploy-key) (:write) - [`GET /repos/:owner/:repo/keys/:key_id`](/v3/repos/keys/#get-a-deploy-key) (:read) @@ -233,7 +231,7 @@ _Tráfego_ {% endif %} {% if currentVersion == "free-pro-team@latest" %} -### Permission on "blocking" +### Permissão em "bloqueio" - [`GET /user/blocks`](/v3/users/blocking/#list-users-blocked-by-the-authenticated-user) (:read) - [`GET /user/blocks/:username`](/v3/users/blocking/#check-if-a-user-is-blocked-by-the-authenticated-user) (:read) @@ -241,7 +239,7 @@ _Tráfego_ - [`DELETE /user/blocks/:username`](/v3/users/blocking/#unblock-a-user) (:write) {% endif %} -### Permission on "checks" +### Permissão em "verificações" - [`POST /repos/:owner/:repo/check-runs`](/v3/checks/runs/#create-a-check-run) (:write) - [`GET /repos/:owner/:repo/check-runs/:check_run_id`](/v3/checks/runs/#get-a-check-run) (:read) @@ -255,7 +253,7 @@ _Tráfego_ - [`GET /repos/:owner/:repo/commits/:sha/check-runs`](/v3/checks/runs/#list-check-runs-for-a-git-reference) (:read) - [`GET /repos/:owner/:repo/commits/:sha/check-suites`](/v3/checks/suites/#list-check-suites-for-a-git-reference) (:read) -### Permission on "contents" +### Permissão em "conteúdo" - [`GET /repos/:owner/:repo/:archive_format/:ref`](/v3/repos/contents/#download-a-repository-archive) (:read) {% if currentVersion == "free-pro-team@latest" %} @@ -344,12 +342,10 @@ _Tráfego_ _Branches_ - [`GET /repos/:owner/:repo/branches`](/v3/repos/branches/#list-branches) (:read) - [`GET /repos/:owner/:repo/branches/:branch`](/v3/repos/branches/#get-a-branch) (:read) -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - [`GET /repos/:owner/:repo/branches/:branch/protection/restrictions/apps`](/v3/repos/branches/#list-apps-with-access-to-the-protected-branch) (:write) - [`POST /repos/:owner/:repo/branches/:branch/protection/restrictions/apps`](/v3/repos/branches/#add-app-access-restrictions) (:write) - [`PUT /repos/:owner/:repo/branches/:branch/protection/restrictions/apps`](/v3/repos/branches/#set-app-access-restrictions) (:write) - [`DELETE /repos/:owner/:repo/branches/:branch/protection/restrictions/apps`](/v3/repos/branches/#remove-user-access-restrictions) (:write) -{% endif %} _Comentários de commit_ - [`PATCH /repos/:owner/:repo/comments/:comment_id`](/v3/repos/comments/#update-a-commit-comment) (:write) @@ -363,13 +359,8 @@ _Git_ - [`POST /repos/:owner/:repo/git/commits`](/v3/git/commits/#create-a-commit) (:write) - [`GET /repos/:owner/:repo/git/commits/:commit_id`](/v3/git/commits/#get-a-commit) (:read) - [`POST /repos/:owner/:repo/git/refs`](/v3/git/refs/#create-a-reference) (:write) -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -- [`GET /repos/:owner/:repo/git/refs/:ref`](/v3/git/refs/#get-a-reference) (:read) -- [`GET /repos/:owner/:repo/git/refs`](/v3/git/refs/#list-references) (:read) -{% else %} - [`GET /repos/:owner/:repo/git/ref/:ref`](/v3/git/refs/#get-a-reference) (:read) - [`GET /repos/:owner/:repo/git/matching-refs/:ref`](/v3/git/refs/#list-matching-references) (:read) -{% endif %} - [`PATCH /repos/:owner/:repo/git/refs/:ref`](/v3/git/refs/#update-a-reference) (:write) - [`DELETE /repos/:owner/:repo/git/refs/:ref`](/v3/git/refs/#delete-a-reference) (:write) - [`POST /repos/:owner/:repo/git/tags`](/v3/git/tags/#create-a-tag-object) (:write) @@ -392,7 +383,7 @@ _importar_ _Reações_ {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -- [`DELETE /reactions/:reaction_id`](/v3/reactions/#delete-a-reaction-legacy) (:write){% else %}- [`DELETE /reactions/:reaction_id`](/v3/reactions/#delete-a-reaction) (:write){% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +- [`DELETE /reactions/:reaction_id`](/v3/reactions/#delete-a-reaction-legacy) (:write){% else %}- [`DELETE /reaction_id`](/v3/reactions/#delete-a-reaction) (:write){% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 0" %} - [`DELETE /repos/:owner/:repo/comments/:comment_id/reactions/:reaction_id`](/v3/reactions/#delete-a-commit-comment-reaction) (:write) - [`DELETE /repos/:owner/:repo/issues/:issue_number/reactions/:reaction_id`](/v3/reactions/#delete-an-issue-reaction) (:write) - [`DELETE /repos/:owner/:repo/issues/comments/:comment_id/reactions/:reaction_id`](/v3/reactions/#delete-an-issue-comment-reaction) (:write) @@ -401,29 +392,29 @@ _Reações_ - [`DELETE /orgs/:org/teams/:team_slug/discussions/:discussion_number/comments/:comment_number/reactions/:reaction_id`](/v3/reactions/#delete-team-discussion-comment-reaction) (:write){% endif %} _Versões_ -- [`GET /repos/:owner/:repo/releases`](/v3/repos/releases/#list-releases) (:read) -- [`POST /repos/:owner/:repo/releases`](/v3/repos/releases/#create-a-release) (:write) -- [`GET /repos/:owner/:repo/releases/:release_id`](/v3/repos/releases/#get-a-release) (:read) -- [`PATCH /repos/:owner/:repo/releases/:release_id`](/v3/repos/releases/#update-a-release) (:write) -- [`DELETE /repos/:owner/:repo/releases/:release_id`](/v3/repos/releases/#delete-a-release) (:write) -- [`GET /repos/:owner/:repo/releases/:release_id/assets`](/v3/repos/releases/#list-release-assets) (:read) -- [`GET /repos/:owner/:repo/releases/assets/:asset_id`](/v3/repos/releases/#get-a-release-asset) (:read) -- [`PATCH /repos/:owner/:repo/releases/assets/:asset_id`](/v3/repos/releases/#update-a-release-asset) (:write) -- [`DELETE /repos/:owner/:repo/releases/assets/:asset_id`](/v3/repos/releases/#delete-a-release-asset) (:write) -- [`GET /repos/:owner/:repo/releases/latest`](/v3/repos/releases/#get-the-latest-release) (:read) -- [`GET /repos/:owner/:repo/releases/tags/:tag`](/v3/repos/releases/#get-a-release-by-tag-name) (:read) - -### Permission on "deployments" - -- [`GET /repos/:owner/:repo/deployments`](/v3/repos/deployments/#list-deployments) (:read) -- [`POST /repos/:owner/:repo/deployments`](/v3/repos/deployments/#create-a-deployment) (:write) +- [`GET /repos/:owner/:repo/releases`](/rest/reference/repos/#list-releases) (:read) +- [`POST /repos/:owner/:repo/releases`](/rest/reference/repos/#create-a-release) (:write) +- [`GET /repos/:owner/:repo/releases/:release_id`](/rest/reference/repos/#get-a-release) (:read) +- [`PATCH /repos/:owner/:repo/releases/:release_id`](/rest/reference/repos/#update-a-release) (:write) +- [`DELETE /repos/:owner/:repo/releases/:release_id`](/rest/reference/repos/#delete-a-release) (:write) +- [`GET /repos/:owner/:repo/releases/:release_id/assets`](/rest/reference/repos/#list-release-assets) (:read) +- [`GET /repos/:owner/:repo/releases/assets/:asset_id`](/rest/reference/repos/#get-a-release-asset) (:read) +- [`PATCH /repos/:owner/:repo/releases/assets/:asset_id`](/rest/reference/repos/#update-a-release-asset) (:write) +- [`DELETE /repos/:owner/:repo/releases/assets/:asset_id`](/rest/reference/repos/#delete-a-release-asset) (:write) +- [`GET /repos/:owner/:repo/releases/latest`](/rest/reference/repos/#get-the-latest-release) (:read) +- [`GET /repos/:owner/:repo/releases/tags/:tag`](/rest/reference/repos/#get-a-release-by-tag-name) (:read) + +### Permissão em "implantações" + +- [`GET /repos/:owner/:repo/deployments`](/rest/reference/repos#list-deployments) (:read) +- [`POST /repos/:owner/:repo/deployments`](/rest/reference/repos#create-a-deployment) (:write) - [`GET /repos/:owner/:repo/deployments/:deployment_id`](/v3/repos/deployments/#get-a-deployment) (:read){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -- [`DELETE /repos/:owner/:repo/deployments/:deployment_id`](/v3/repos/deployments/#delete-a-deployment) (:write){% endif %} -- [`GET /repos/:owner/:repo/deployments/:deployment_id/statuses`](/v3/repos/deployments/#list-deployment-statuses) (:read) -- [`POST /repos/:owner/:repo/deployments/:deployment_id/statuses`](/v3/repos/deployments/#create-a-deployment-status) (:write) -- [`GET /repos/:owner/:repo/deployments/:deployment_id/statuses/:status_id`](/v3/repos/deployments/#get-a-deployment-status) (:read) +- [`DELETE /repos/:owner/:repo/deployments/:deployment_id`](/rest/reference/repos#delete-a-deployment) (:write){% endif %} +- [`GET /repos/:owner/:repo/deployments/:deployment_id/statuses`](/rest/reference/repos#list-deployment-statuses) (:read) +- [`POST /repos/:owner/:repo/deployments/:deployment_id/statuses`](/rest/reference/repos#create-a-deployment-status) (:write) +- [`GET /repos/:owner/:repo/deployments/:deployment_id/statuses/:status_id`](/rest/reference/repos#get-a-deployment-status) (:read) -### Permission on "emails" +### Permissão em "e-mails" {% if currentVersion == "free-pro-team@latest" %} - [`PATCH /user/email/visibility`](/v3/users/emails/#set-primary-email-visibility-for-the-authenticated-user) (:write) @@ -433,7 +424,7 @@ _Versões_ - [`DELETE /user/emails`](/v3/users/emails/#delete-an-email-address-for-the-authenticated-user) (:write) - [`GET /user/public_emails`](/v3/users/emails/#list-public-email-addresses-for-the-authenticated-user) (:read) -### Permission on "followers" +### Permissão em "seguidores" - [`GET /user/followers`](/v3/users/followers/#list-followers-of-a-user) (:read) - [`GET /user/following`](/v3/users/followers/#list-the-people-a-user-follows) (:read) @@ -441,16 +432,16 @@ _Versões_ - [`PUT /user/following/:username`](/v3/users/followers/#follow-a-user) (:write) - [`DELETE /user/following/:username`](/v3/users/followers/#unfollow-a-user) (:write) -### Permission on "gpg keys" +### Permissão em "chaves gpg" - [`GET /user/gpg_keys`](/v3/users/gpg_keys/#list-gpg-keys-for-the-authenticated-user) (:read) - [`POST /user/gpg_keys`](/v3/users/gpg_keys/#create-a-gpg-key-for-the-authenticated-user) (:write) - [`GET /user/gpg_keys/:gpg_key_id`](/v3/users/gpg_keys/#get-a-gpg-key-for-the-authenticated-user) (:read) - [`DELETE /user/gpg_keys/:gpg_key_id`](/v3/users/gpg_keys/#delete-a-gpg-key-for-the-authenticated-user) (:write) -### Permission on "issues" +### Permissão em "problemas" -Issues and pull requests are closely related. For more information, see "[List issues assigned to the authenticated user](/v3/issues/#list-issues-assigned-to-the-authenticated-user)." If your GitHub App has permissions on issues but not on pull requests, these endpoints will be limited to issues. Endpoints that return both issues and pull requests will be filtered. Endpoints that allow operations on both issues and pull requests will be restricted to issues. +Problemas e pull requests estão estreitamente relacionados. Para obter mais informações, consulte "[Lista de problemas atribuídos ao usuário autenticado](/v3/issues/#list-issues-assigned-to-the-authenticated-user)". Se seu aplicativo GitHub tiver permissões em problemas e não em pull requests, esses pontos de extremidade irão limitar-se a problemas. Pontos de extremidade que retornam problemas e pull requests serão filtrados. Os pontos de extremidade que permitem operações em ambos problemas e pull requests estarão restritos a problemas. - [`GET /repos/:owner/:repo/issues`](/v3/issues/#list-repository-issues) (:read) - [`POST /repos/:owner/:repo/issues`](/v3/issues/#create-an-issue) (:write) @@ -515,15 +506,15 @@ _Reações_ - [`DELETE /orgs/:org/teams/:team_slug/discussions/:discussion_number/comments/:comment_number/reactions/:reaction_id`](/v3/reactions/#delete-team-discussion-comment-reaction) (:write){% else %} - [`DELETE /reactions/:reaction_id`](/v3/reactions/#delete-a-reaction) (:write){% endif %} -### Permission on "keys" +### Permissão em "chaves" -_Keys_ +_Chaves_ - [`GET /user/keys`](/v3/users/keys/#list-public-ssh-keys-for-the-authenticated-user) (:read) - [`POST /user/keys`](/v3/users/keys/#create-a-public-ssh-key-for-the-authenticated-user) (:write) - [`GET /user/keys/:key_id`](/v3/users/keys/#get-a-public-ssh-key-for-the-authenticated-user) (:read) - [`DELETE /user/keys/:key_id`](/v3/users/keys/#delete-a-public-ssh-key-for-the-authenticated-user) (:write) -### Permission on "members" +### Permissão em "integrantes" {% if currentVersion == "free-pro-team@latest" %} - [`GET /organizations/:org_id/team/:team_id/team-sync/group-mappings`](/v3/teams/team_sync/#list-idp-groups-for-a-team) (:write) @@ -558,14 +549,14 @@ _Keys_ {% endif %} {% if currentVersion == "free-pro-team@latest" %} -_Invitations_ +_Convites_ - [`GET /orgs/:org/invitations`](/v3/orgs/members/#list-pending-organization-invitations) (:read) - [`POST /orgs/:org/invitations`](/v3/orgs/members/#create-an-organization-invitation) (:write) - [`GET /orgs/:org/invitations/:invitation_id/teams`](/v3/orgs/members/#list-organization-invitation-teams) (:read) - [`GET /teams/:team_id/invitations`](/v3/teams/members/#list-pending-team-invitations) (:read) {% endif %} -_Organization members_ +_Integrantes da organização_ - [`DELETE /orgs/:org/members/:username`](/v3/orgs/members/#remove-an-organization-member) (:write) - [`GET /orgs/:org/memberships/:username`](/v3/orgs/members/#get-organization-membership-for-a-user) (:read) - [`PUT /orgs/:org/memberships/:username`](/v3/orgs/members/#set-organization-membership-for-a-user) (:write) @@ -576,7 +567,7 @@ _Organization members_ - [`GET /user/memberships/orgs/:org`](/v3/orgs/members/#get-an-organization-membership-for-the-authenticated-user) (:read) - [`PATCH /user/memberships/orgs/:org`](/v3/orgs/members/#update-an-organization-membership-for-the-authenticated-user) (:write) -_Team members_ +_Integrantes da equipe_ - [`GET /teams/:team_id/members`](/v3/teams/members/#list-team-members) (:read) - [`GET /teams/:team_id/memberships/:username`](/v3/teams/members/#get-team-membership-for-a-user) (:read) - [`PUT /teams/:team_id/memberships/:username`](/v3/teams/members/#add-or-update-team-membership-for-a-user) (:write) @@ -603,7 +594,7 @@ _Equipes_ - [`DELETE /teams/:team_id/repos/:owner/:repo`](/v3/teams/#remove-a-repository-from-a-team) (:write) - [`GET /teams/:team_id/teams`](/v3/teams/#list-child-teams) (:read) -### Permission on "organization administration" +### Permissão em "administração da organização" - [`PATCH /orgs/:org`](/v3/orgs/#update-an-organization) (:write) {% if currentVersion == "free-pro-team@latest" %} @@ -616,20 +607,20 @@ _Equipes_ - [`DELETE /orgs/:org/interaction-limits`](/v3/interactions/orgs/#remove-interaction-restrictions-for-an-organization) (:write) {% endif %} -### Permission on "organization hooks" +### Permissão em "hooks da organização" -- [`GET /orgs/:org/hooks`](/v3/orgs/hooks/#list-organization-webhooks) (:read) -- [`POST /orgs/:org/hooks`](/v3/orgs/hooks/#create-an-organization-webhook) (:write) -- [`GET /orgs/:org/hooks/:hook_id`](/v3/orgs/hooks/#get-an-organization-webhook) (:read) -- [`PATCH /orgs/:org/hooks/:hook_id`](/v3/orgs/hooks/#update-an-organization-webhook) (:write) -- [`DELETE /orgs/:org/hooks/:hook_id`](/v3/orgs/hooks/#delete-an-organization-webhook) (:write) -- [`POST /orgs/:org/hooks/:hook_id/pings`](/v3/orgs/hooks/#ping-an-organization-webhook) (:write) +- [`GET /orgs/:org/hooks`](/rest/reference/orgs#webhooks/#list-organization-webhooks) (:read) +- [`POST /orgs/:org/hooks`](/rest/reference/orgs#webhooks/#create-an-organization-webhook) (:write) +- [`GET /orgs/:org/hooks/:hook_id`](/rest/reference/orgs#webhooks/#get-an-organization-webhook) (:read) +- [`PATCH /orgs/:org/hooks/:hook_id`](/rest/reference/orgs#webhooks/#update-an-organization-webhook) (:write) +- [`DELETE /orgs/:org/hooks/:hook_id`](/rest/reference/orgs#webhooks/#delete-an-organization-webhook) (:write) +- [`POST /orgs/:org/hooks/:hook_id/pings`](/rest/reference/orgs#webhooks/#ping-an-organization-webhook) (:write) _Equipes_ - [`DELETE /teams/:team_id/projects/:project_id`](/v3/teams/#remove-a-project-from-a-team) (:read) {% if currentVersion != "free-pro-team@latest" %} -### Permission on "organization pre receive hooks" +### Permissão em "hooks pre-receive da organização" - [`GET /orgs/:org/pre-receive-hooks`](/v3/enterprise-admin/org_pre_receive_hooks/#list-pre-receive-hooks-for-an-organization) (:read) - [`GET /orgs/:org/pre-receive-hooks/:pre_receive_hook_id`](/v3/enterprise-admin/org_pre_receive_hooks/#get-a-pre-receive-hook-for-an-organization) (:read) @@ -637,7 +628,7 @@ _Equipes_ - [`DELETE /orgs/:org/pre-receive-hooks/:pre_receive_hook_id`](/v3/enterprise-admin/org_pre_receive_hooks/#remove-pre-receive-hook-enforcement-for-an-organization) (:write) {% endif %} -### Permission on "organization projects" +### Permissão em "projetos da organização" - [`POST /orgs/:org/projects`](/v3/projects/#create-an-organization-project) (:write) - [`GET /projects/:project_id`](/v3/projects/#get-a-project) (:read) @@ -658,7 +649,7 @@ _Equipes_ - [`POST /projects/columns/cards/:card_id/moves`](/v3/projects/cards/#move-a-project-card) (:write) {% if currentVersion == "free-pro-team@latest" %} -### Permission on "organization user blocking" +### Permissão em "bloqueio de usuários da organização" - [`GET /orgs/:org/blocks`](/v3/orgs/blocking/#list-users-blocked-by-an-organization) (:read) - [`GET /orgs/:org/blocks/:username`](/v3/orgs/blocking/#check-if-a-user-is-blocked-by-an-organization) (:read) @@ -666,20 +657,20 @@ _Equipes_ - [`DELETE /orgs/:org/blocks/:username`](/v3/orgs/blocking/#unblock-a-user-from-an-organization) (:write) {% endif %} -### Permission on "pages" +### Permissão em "páginas" -- [`GET /repos/:owner/:repo/pages`](/v3/repos/pages/#get-a-github-pages-site) (:read) -- [`POST /repos/:owner/:repo/pages`](/v3/repos/pages/#create-a-github-pages-site) (:write) -- [`PUT /repos/:owner/:repo/pages`](/v3/repos/pages/#update-information-about-a-github-pages-site) (:write) -- [`DELETE /repos/:owner/:repo/pages`](/v3/repos/pages/#delete-a-github-pages-site) (:write) -- [`GET /repos/:owner/:repo/pages/builds`](/v3/repos/pages/#list-github-pages-builds) (:read) -- [`POST /repos/:owner/:repo/pages/builds`](/v3/repos/pages/#request-a-github-pages-build) (:write) -- [`GET /repos/:owner/:repo/pages/builds/:build_id`](/v3/repos/pages/#get-github-pages-build) (:read) -- [`GET /repos/:owner/:repo/pages/builds/latest`](/v3/repos/pages/#get-latest-pages-build) (:read) +- [`GET /repos/:owner/:repo/pages`](/rest/reference/repos#get-a-github-pages-site) (:read) +- [`POST /repos/:owner/:repo/pages`](/rest/reference/repos#create-a-github-pages-site) (:write) +- [`PUT /repos/:owner/:repo/pages`](/rest/reference/repos#update-information-about-a-github-pages-site) (:write) +- [`DELETE /repos/:owner/:repo/pages`](/rest/reference/repos#delete-a-github-pages-site) (:write) +- [`GET /repos/:owner/:repo/pages/builds`](/rest/reference/repos#list-github-pages-builds) (:read) +- [`POST /repos/:owner/:repo/pages/builds`](/rest/reference/repos#request-a-github-pages-build) (:write) +- [`GET /repos/:owner/:repo/pages/builds/:build_id`](/rest/reference/repos#get-github-pages-build) (:read) +- [`GET /repos/:owner/:repo/pages/builds/latest`](/rest/reference/repos#get-latest-pages-build) (:read) -### Permission on "pull requests" +### Permissão em "pull requests" -Pull requests and issues are closely related.. If your GitHub App has permissions on pull requests but not on issues, these endpoints will be limited to pull requests. Endpoints that return both pull requests and issues will be filtered. Endpoints that allow operations on both pull requests and issues will be restricted to pull requests. +Pull requests and issues are closely related.. If your GitHub App has permissions on pull requests but not on issues, these endpoints will be limited to pull requests. Os pontos de extremidade que retornam pull requests e problemas serão filtrados. Os pontos de extremidade que permitem operações em pull requests e problemas serão restritos a pull requests. - [`PATCH /repos/:owner/:repo/issues/:issue_number`](/v3/issues/#update-an-issue) (:write) - [`GET /repos/:owner/:repo/issues/:issue_number/comments`](/v3/issues/comments/#list-issue-comments) (:read) @@ -751,7 +742,7 @@ _Reações_ - [`DELETE /orgs/:org/teams/:team_slug/discussions/:discussion_number/reactions/:reaction_id`](/v3/reactions/#delete-team-discussion-reaction) (:write) - [`DELETE /orgs/:org/teams/:team_slug/discussions/:discussion_number/comments/:comment_number/reactions/:reaction_id`](/v3/reactions/#delete-team-discussion-comment-reaction) (:write){% else %}- [`DELETE /reactions/:reaction_id`](/v3/reactions/#delete-a-reaction) (:write){% endif %} -_Requested reviewers_ +_Revisores solicitados_ - [`GET /repos/:owner/:repo/pulls/:pull_number/requested_reviewers`](/v3/pulls/review_requests/#list-requested-reviewers-for-a-pull-request) (:read) - [`POST /repos/:owner/:repo/pulls/:pull_number/requested_reviewers`](/v3/pulls/review_requests/#request-reviewers-for-a-pull-request) (:write) - [`DELETE /repos/:owner/:repo/pulls/:pull_number/requested_reviewers`](/v3/pulls/review_requests/#remove-requested-reviewers-from-a-pull-request) (:write) @@ -765,7 +756,7 @@ _Revisões_ - [`GET /repos/:owner/:repo/pulls/:pull_number/reviews/:review_id/comments`](/v3/pulls/reviews/#list-comments-for-a-pull-request-review) (:read) - [`PUT /repos/:owner/:repo/pulls/:pull_number/reviews/:review_id/dismissals`](/v3/pulls/reviews/#dismiss-a-review-for-a-pull-request) (:write) -### Permission on "repository hooks" +### Permissão em "hooks de repositório" - [`GET /repos/:owner/:repo/hooks`](/v3/repos/hooks/#list-repository-webhooks) (:read) - [`POST /repos/:owner/:repo/hooks`](/v3/repos/hooks/#create-a-repository-webhook) (:write) @@ -784,7 +775,7 @@ _Revisões_ - [`DELETE /repos/:owner/:repo/pre-receive-hooks/:pre_receive_hook_id`](/v3/enterprise-admin/repo_pre_receive_hooks/#remove-pre-receive-hook-enforcement-for-a-repository) (:write) {% endif %} -### Permission on "repository projects" +### Permissão em "projetos de repositório" - [`GET /projects/:project_id`](/v3/projects/#get-a-project) (:read) - [`PATCH /projects/:project_id`](/v3/projects/#update-a-project) (:write) @@ -809,7 +800,7 @@ _Equipes_ - [`DELETE /teams/:team_id/projects/:project_id`](/v3/teams/#remove-a-project-from-a-team) (:read) {% if currentVersion == "free-pro-team@latest" %} -### Permission on "secrets" +### Permissão em "segredos" * [`GET /repos/:owner/:repo/actions/secrets/public-key`](/v3/actions/secrets/#get-a-repository-public-key) (:read) * [`GET /repos/:owner/:repo/actions/secrets`](/v3/actions/secrets/#list-repository-secrets) (:read) @@ -829,14 +820,14 @@ _Equipes_ {% endif %} {% if currentVersion == "free-pro-team@latest" %} -### Permission on "security events" +### Permissão em "eventos de segurança" - [`GET /repos/:owner/:repo/code-scanning/alerts`](/v3/code-scanning/#list-code-scanning-alerts-for-a-repository) (:read) - [`GET /repos/:owner/:repo/code-scanning/alerts/:alert_id`](/v3/code-scanning/#get-a-code-scanning-alert) (:read) {% endif %} {% if currentVersion == "free-pro-team@latest" %} -### Permission on "self-hosted runners" +### Permissão em "executores auto-hospedados" - [`GET /orgs/:org/actions/runners/downloads`](/v3/actions/self-hosted-runners/#list-runner-applications-for-an-organization) (:read) - [`POST /orgs/:org/actions/runners/registration-token`](/v3/actions/self-hosted-runners/#create-a-registration-token-for-an-organization) (:write) - [`GET /orgs/:org/actions/runners`](/v3/actions/self-hosted-runners/#list-self-hosted-runners-for-an-organization) (:read) @@ -845,25 +836,25 @@ _Equipes_ - [`DELETE /orgs/:org/actions/runners/:runner_id`](/v3/actions/self-hosted-runners/#delete-a-self-hosted-runner-from-an-organization) (:write) {% endif %} -### Permission on "single file" +### Permissão em "arquivo único" - [`GET /repos/:owner/:repo/contents/:path`](/v3/repos/contents/#get-repository-content) (:read) - [`PUT /repos/:owner/:repo/contents/:path`](/v3/repos/contents/#create-or-update-file-contents) (:write) - [`DELETE /repos/:owner/:repo/contents/:path`](/v3/repos/contents/#delete-a-file) (:write) -### Permission on "starring" +### Permissão em "marcar com uma estrela" -- [`GET /user/starred/:owner/:repo`](/v3/activity/starring/#check-if-a-repository-is-starred-by-the-authenticated-user) (:read) -- [`PUT /user/starred/:owner/:repo`](/v3/activity/starring/#star-a-repository-for-the-authenticated-user) (:write) -- [`DELETE /user/starred/:owner/:repo`](/v3/activity/starring/#unstar-a-repository-for-the-authenticated-user) (:write) +- [`GET /user/starred/:owner/:repo`](/rest/reference/activity#check-if-a-repository-is-starred-by-the-authenticated-user) (:read) +- [`PUT /user/starred/:owner/:repo`](/rest/reference/activity#star-a-repository-for-the-authenticated-user) (:write) +- [`DELETE /user/starred/:owner/:repo`](/rest/reference/activity#unstar-a-repository-for-the-authenticated-user) (:write) -### Permission on "statuses" +### Permissão em "status" - [`GET /repos/:owner/:repo/commits/:ref/status`](/v3/repos/statuses/#get-the-combined-status-for-a-specific-reference) (:read) - [`GET /repos/:owner/:repo/commits/:ref/statuses`](/v3/repos/statuses/#list-commit-statuses-for-a-reference) (:read) - [`POST /repos/:owner/:repo/statuses/:sha`](/v3/repos/statuses/#create-a-commit-status) (:write) -### Permission on "team discussions" +### Permissão em "discussões em equipe" - [`GET /teams/:team_id/discussions`](/v3/teams/discussions/#list-discussions) (:read) - [`POST /teams/:team_id/discussions`](/v3/teams/discussions/#create-a-discussion) (:write) diff --git a/translations/pt-BR/content/rest/reference/projects.md b/translations/pt-BR/content/rest/reference/projects.md index 31a730215556..7153e971abe4 100644 --- a/translations/pt-BR/content/rest/reference/projects.md +++ b/translations/pt-BR/content/rest/reference/projects.md @@ -11,7 +11,7 @@ versions: {% unless operation.subcategory %}{% include rest_operation %}{% endunless %} {% endfor %} -## Cards +## Cartões {% for operation in currentRestOperations %} {% if operation.subcategory == 'cards' %}{% include rest_operation %}{% endif %} @@ -19,13 +19,13 @@ versions: ## Colaboradores -This API allows you to interact with an organization's projects. +Esta API permite que você interaja com os projetos de uma organização. {% for operation in currentRestOperations %} {% if operation.subcategory == 'collaborators' %}{% include rest_operation %}{% endif %} {% endfor %} -## Columns +## Colunas {% for operation in currentRestOperations %} {% if operation.subcategory == 'columns' %}{% include rest_operation %}{% endif %} diff --git a/translations/pt-BR/content/rest/reference/pulls.md b/translations/pt-BR/content/rest/reference/pulls.md index f8edd686e5b3..60f80b824728 100644 --- a/translations/pt-BR/content/rest/reference/pulls.md +++ b/translations/pt-BR/content/rest/reference/pulls.md @@ -7,13 +7,13 @@ versions: enterprise-server: '*' --- -The Pull Request API allows you to list, view, edit, create, and even merge pull requests. Comments on pull requests can be managed via the [Issue Comments API](/rest/reference/issues#comments). +A API do Pull Request permite que você liste, visualize, edite, crie e até mesmo faça merge de pull requests. Comentários em pull requests podem ser gerenciados através da [API de Comentários do Problema](/rest/reference/issues#comments). -Every pull request is an issue, but not every issue is a pull request. For this reason, "shared" actions for both features, like manipulating assignees, labels and milestones, are provided within [the Issues API](/v3/issues). +Cada pull request é um problema, mas nem todos os problemas são um pull request. Por este motivo, as ações "compartilhadas" para ambos os recursos, como a manipulação de responsáveis, etiquetas e marcos são fornecidos dentro de [a API de problemas](/v3/issues). -### Custom media types for pull requests +### Tipos de mídia personalizados para pull requests -These are the supported media types for pull requests. +Estes são os tipos de mídia compatíveis com pull requests. application/vnd.github.VERSION.raw+json application/vnd.github.VERSION.text+json @@ -22,26 +22,26 @@ These are the supported media types for pull requests. application/vnd.github.VERSION.diff application/vnd.github.VERSION.patch -For more information, see "[Custom media types](/rest/overview/media-types)." +Para obter mais informações, consulte "[tipos de mídia personalizados](/rest/overview/media-types)". -If a diff is corrupt, contact {% data variables.contact.contact_support %}. Include the repository name and pull request ID in your message. +Se um diff estiver corrompido, entre em contato com {% data variables.contact.contact_support %}. Inclua o nome e o ID do pull request do repositório na sua mensagem. -### Link Relations +### Relações do Link -Pull Requests have these possible link relations: +Pull Requests têm estas relações de link possíveis: -| Nome | Descrição | -| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | -| `self` | The API location of this Pull Request. | -| `html` | The HTML location of this Pull Request. | -| `problema` | The API location of this Pull Request's [Issue](/v3/issues/). | -| `comentários` | The API location of this Pull Request's [Issue comments](/v3/issues/comments/). | -| `review_comments` | The API location of this Pull Request's [Review comments](/v3/pulls/comments/). | -| `review_comment` | The [URL template](/v3/#hypermedia) to construct the API location for a [Review comment](/v3/pulls/comments/) in this Pull Request's repository. | -| `commits` | The API location of this Pull Request's [commits](#list-commits-on-a-pull-request). | -| `Status` | The API location of this Pull Request's [commit statuses](/v3/repos/statuses/), which are the statuses of its `head` branch. | +| Nome | Descrição | +| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `self` | O local da API deste Pull Request. | +| `html` | O locl do HTML deste Pull Request. | +| `problema` | O local da API do [Problema](/v3/issues/) deste Pull Request. | +| `comentários` | O local da API dos [comentários do problema](/v3/issues/comments/) deste Pull Request. | +| `review_comments` | O local da API dos [comentários da revisão](/v3/pulls/comments/) deste Pull Request. | +| `review_comment` | O [modelo de URL](/v3/#hypermedia) para construir o local da API para um [comentário de revisão](/v3/pulls/comments/) no repositório deste Pull Request. | +| `commits` | O local da API dos [commits](#list-commits-on-a-pull-request) deste Pull Request. | +| `Status` | O local da API dos [status do commit](/v3/repos/statuses/) deste pull request, que são os status no seu branch `principal`. | {% for operation in currentRestOperations %} {% unless operation.subcategory %}{% include rest_operation %}{% endunless %} @@ -49,34 +49,34 @@ Pull Requests have these possible link relations: ## Revisões -Pull Request Reviews are groups of Pull Request Review Comments on the Pull Request, grouped together with a state and optional body comment. +As revisões de pull request são grupos de comentários de revisão de pull request no Pull Request, agrupados e com um status e comentário de texto opcional. {% for operation in currentRestOperations %} {% if operation.subcategory == 'reviews' %}{% include rest_operation %}{% endif %} {% endfor %} -## Review comments +## Comentários de revisão -Pull request review comments are comments on a portion of the unified diff made during a pull request review. Commit comments and issue comments are different from pull request review comments. You apply commit comments directly to a commit and you apply issue comments without referencing a portion of the unified diff. For more information, see "[Create a commit comment](/rest/reference/git#create-a-commit)" and "[Create an issue comment](/rest/reference/issues#create-an-issue-comment)." +Os comentários de revisão de pull request são comentários em uma parte do diff unificado feitos durante uma revisão de pull request. Comentários de commit e comentários de problemas são são diferentes dos comentários de revisão de pull request. Você aplica comentários de submissão diretamente para um commit e aplica comentários de problema sem fazer referência a uma parte do diff unificado. Para obter mais informações, consulte "[Criar um comentário de commit](/rest/reference/git#create-a-commit)" e "[Criar um comentário de problema](/rest/reference/issues#create-an-issue-comment)". -### Custom media types for pull request review comments +### Tipos de mídia personalizados para comentários de revisão de pull request -These are the supported media types for pull request review comments. +Estes são os tipos de mídia compatíveis com os comentários de revisão de pull request. application/vnd.github.VERSION.raw+json application/vnd.github.VERSION.text+json application/vnd.github.VERSION.html+json application/vnd.github.VERSION.full+json -For more information, see "[Custom media types](/rest/overview/media-types)." +Para obter mais informações, consulte "[tipos de mídia personalizados](/rest/overview/media-types)". {% for operation in currentRestOperations %} {% if operation.subcategory == 'comments' %}{% include rest_operation %}{% endif %} {% endfor %} -## Review requests +## Solicitações de revisão -Pull request authors and repository owners and collaborators can request a pull request review from anyone with write access to the repository. Each requested reviewer will receive a notification asking them to review the pull request. +Os autores dos pull request e os proprietários e colaboradores dos repositórios podem solicitar uma revisão de pull request para qualquer pessoa com acesso de gravação ao repositório. Cada revisor solicitado receberá uma notificação pedindo-lhes para revisar o pull request. {% for operation in currentRestOperations %} {% if operation.subcategory == 'review-requests' %}{% include rest_operation %}{% endif %} diff --git a/translations/pt-BR/content/rest/reference/rate-limit.md b/translations/pt-BR/content/rest/reference/rate-limit.md index 16fd64f88bb7..ff9c15cacf80 100644 --- a/translations/pt-BR/content/rest/reference/rate-limit.md +++ b/translations/pt-BR/content/rest/reference/rate-limit.md @@ -8,13 +8,13 @@ versions: enterprise-server: '*' --- -The REST API overview documentation describes the [rate limit rules](/rest/overview/resources-in-the-rest-api#rate-limiting). You can check your current rate limit status at any time using the Rate Limit API described below. +A documentação geral da API REST descreve as [regras de limite de taxa](/rest/overview/resources-in-the-rest-api#rate-limiting). Você pode verificar seu status de limite de taxa atual a qualquer momento usando a API de limite de taxa descrita abaixo. ### Entender o seu status de limite de taxa A API de pesquisa tem um [limite de taxa personalizado](/v3/search/#rate-limit), separado do limite de taxa que rege o restante da API REST. A API do GraphQL também tem um [limite de taxa personalizado](/v4/guides/resource-limitations/#rate-limit), que é separado e calculado de forma diferente dos limites de taxa na API REST. -Por esses motivos, a resposta da API do limite de taxa categoriza o seu limite de taxa. Under `resources`, you'll see four objects: +Por esses motivos, a resposta da API do limite de taxa categoriza o seu limite de taxa. Em `recursos`, você verá quatro objetos: * O objeto `principal` fornece o status do limite de taxa para todos os recursos não relacionados à pesquisa na API REST. diff --git a/translations/pt-BR/content/rest/reference/repos.md b/translations/pt-BR/content/rest/reference/repos.md index 2e6cef349ea8..194f7185046e 100644 --- a/translations/pt-BR/content/rest/reference/repos.md +++ b/translations/pt-BR/content/rest/reference/repos.md @@ -26,16 +26,16 @@ versions: ## Comentários -### Custom media types for commit comments +### Tipos de mídia personalizados para comentários de commit -These are the supported media types for commit comments. You can read more about the use of media types in the API [here](/v3/media/). +Estes são os tipos de mídia compatíveis com os comentários do commit. Você pode ler mais sobre o uso de tipos de mídia na API [aqui](/v3/media/). application/vnd.github-commitcomment.raw+json application/vnd.github-commitcomment.text+json application/vnd.github-commitcomment.html+json application/vnd.github-commitcomment.full+json -For more information, see "[Custom media types](/rest/overview/media-types)." +Para obter mais informações, consulte "[tipos de mídia personalizados](/rest/overview/media-types)". {% for operation in currentRestOperations %} {% if operation.subcategory == 'comments' %}{% include rest_operation %}{% endif %} @@ -43,7 +43,7 @@ For more information, see "[Custom media types](/rest/overview/media-types)." ## Commits -The Repo Commits API supports listing, viewing, and comparing commits in a repository. +A API de Commits do repositório é compatível com a listagem, visualização e comparação de commits em um repositório. {% for operation in currentRestOperations %} {% if operation.subcategory == 'commits' %}{% include rest_operation %}{% endif %} @@ -55,26 +55,26 @@ The Repo Commits API supports listing, viewing, and comparing commits in a repos {% if operation.subcategory == 'community' %}{% include rest_operation %}{% endif %} {% endfor %} -## Contents +## Conteúdo -These API endpoints let you create, modify, and delete Base64 encoded content in a repository. To request the raw format or rendered HTML (when supported), use custom media types for repository contents. +Estes pontos de extremidade da API permitem criar, modificar e excluir conteúdo codificado em Base64 em um repositório. Para solicitar o formato sem processar ou HTML interpretado (quando compatível), use os tipos de mídia personalizados para o conteúdo do repositório. -### Custom media types for repository contents +### Tipos de mídia personalizados para conteúdo do repositório -[READMEs](/v3/repos/contents/#get-a-repository-readme), [files](/v3/repos/contents/#get-repository-content), and [symlinks](/v3/repos/contents/#get-repository-content) support the following custom media types: +Os [LEIAMEs](/v3/repos/contents/#get-a-repository-readme), [arquivos](/v3/repos/contents/#get-repository-content) e [links simbólicos](/v3/repos/contents/#get-repository-content) são compatíveis com os seguintes tipos de mídia personalizados: application/vnd.github.VERSION.raw application/vnd.github.VERSION.html -Use the `.raw` media type to retrieve the contents of the file. +Use o tipo de mídia `.raw` para recuperar o conteúdo do arquivo. Para arquivos de markup, como Markdown ou AsciiDoc, você pode recuperar o HTML interpretado usando o tipo de mídia `.html`. As linguagens de markup são processadas em HTML usando nossa [biblioteca de markup](https://github.com/github/markup) de código aberto. -[All objects](/v3/repos/contents/#get-repository-content) support the following custom media type: +[Todos os objetos](/v3/repos/contents/#get-repository-content) são compatíveis com o seguinte tipo de mídia personalizado: application/vnd.github.VERSION.object -Use the `object` media type parameter to retrieve the contents in a consistent object format regardless of the content type. For example, instead of an array of objects for a directory, the response will be an object with an `entries` attribute containing the array of objects. +Use o parâmetro do tipo de mídia do `objeto` para recuperar o conteúdo em um formato de objeto consistente independentemente do tipo de conteúdo. Por exemplo, em vez de um array de objetos para um diretório, a resposta será um objeto com um atributo de `entrada` contendo o array de objetos. Você pode ler mais sobre o uso de tipos de mídia na API [aqui](/v3/media/). @@ -86,7 +86,7 @@ Você pode ler mais sobre o uso de tipos de mídia na API [aqui](/v3/media/). {% data reusables.repositories.deploy-keys %} -Deploy keys can either be setup using the following API endpoints, or by using GitHub. To learn how to set deploy keys up in GitHub, see "[Managing deploy keys](/developers/overview/managing-deploy-keys)." +Chaves de implantação podem ser configuradas usando os seguintes pontos de extremidades da API ou usando o GitHub. Para saber como configurar as chaves de implantação no GitHub, consulte "[Gerenciar chaves de implantação](/developers/overview/managing-deploy-keys)". {% for operation in currentRestOperations %} {% if operation.subcategory == 'keys' %}{% include rest_operation %}{% endif %} @@ -94,15 +94,15 @@ Deploy keys can either be setup using the following API endpoints, or by using G ## Implantações -Deployments are requests to deploy a specific ref (branch, SHA, tag). GitHub dispatches a [`deployment` event](/developers/webhooks-and-events/webhook-events-and-payloads#deployment) that external services can listen for and act on when new deployments are created. Deployments enable developers and organizations to build loosely coupled tooling around deployments, without having to worry about the implementation details of delivering different types of applications (e.g., web, native). +As implantações são solicitações para implantar um ref específico (branch, SHA, tag). O GitHub envia um [ evento de `implantação`](/developers/webhooks-and-events/webhook-events-and-payloads#deployment) pelo qual os serviços externos podem ouvir e atuar quando novas implantações são criadas. As implantações permitem que os desenvolvedores e as organizações construam ferramentas associadas em torno de implantações sem ter que se preocupar com os detalhes de implementação da entrega de diferentes tipos de aplicativos (p. ex., web, nativo). -Deployment statuses allow external services to mark deployments with an `error`, `failure`, `pending`, `in_progress`, `queued`, or `success` state that systems listening to [`deployment_status` events](/developers/webhooks-and-events/webhook-events-and-payloads#deployment_status) can consume. +Os status de implantação externos permitem marcar implantações com `error`, `failure`, `pending`, `in_progress`, `queued` ou `success` afirmar que os sistemas que estão escutando os eventos [`deployment_status`](/developers/webhooks-and-events/webhook-events-and-payloads#deployment_status) podem consumir. -Deployment statuses can also include an optional `description` and `log_url`, which are highly recommended because they make deployment statuses more useful. The `log_url` is the full URL to the deployment output, and the `description` is a high-level summary of what happened with the deployment. +Os status de implantação também podem incluir uma `descrição` opcional e `log_url`, que são altamente recomendados porque tornam o status de implantação mais útil. O `log_url` é a URL completa para a saída de implantação e a `descrição` é um resumo de alto nível do que aconteceu com a implantação. -GitHub dispatches `deployment` and `deployment_status` events when new deployments and deployment statuses are created. These events allows third-party integrations to receive respond to deployment requests and update the status of a deployment as progress is made. +O GitHub envia os eventos de `implantação` e `deployment_status` quando novas implantações de status de implantação são criadas. Esses eventos permitem que as integrações de terceiros recebam resposta para solicitações de implantação e atualizem o status de implantação conforme o progresso é feito. -Below is a simple sequence diagram for how these interactions would work. +Abaixo está um diagrama de sequência sobre para como essas interações funcionariam. ``` +---------+ +--------+ +-----------+ +-------------+ @@ -131,15 +131,15 @@ Below is a simple sequence diagram for how these interactions would work. | | | | ``` -Keep in mind that GitHub is never actually accessing your servers. It's up to your third-party integration to interact with deployment events. Multiple systems can listen for deployment events, and it's up to each of those systems to decide whether they're responsible for pushing the code out to your servers, building native code, etc. +Tenha em mente que o GitHub nunca terá acesso aos seus servidores. Cabe à sua integração de terceiros interagir com os eventos de implantação. Vários sistemas podem ouvir eventos de implantação, e cabe a cada um desses sistemas decidir se serão responsáveis por retirar o código dos seus servidores, criar código nativo, etc. -Note that the `repo_deployment` [OAuth scope](/developers/apps/scopes-for-oauth-apps) grants targeted access to deployments and deployment statuses **without** granting access to repository code, while the `public_repo` and `repo` scopes grant permission to code as well. +Observe que o `escopo do OAuth` [repo_deployment](/developers/apps/scopes-for-oauth-apps) concede acesso direcionado a implantações e status de implantações **sem** conceder acesso ao código do repositório, enquanto os escopos `public_repo` e `repo` também concedem permissão para o código. -### Inactive deployments +### Implantações inativas -When you set the state of a deployment to `success`, then all prior non-transient, non-production environment deployments in the same repository will become `inactive`. To avoid this, you can set `auto_inactive` to `false` when creating the deployment status. +Ao definir o estado de uma implantação como `sucesso`, todas as implantações de ambiente de não produção e não transitórias no mesmo repositório irão tornar-se `inativas`. Para evitar isso, você pode definir `auto_inactive` como `falso` ao criar o status de implantação. -You can communicate that a transient environment no longer exists by setting its `state` to `inactive`. Setting the `state` to `inactive` shows the deployment as `destroyed` in {% data variables.product.prodname_dotcom %} and removes access to it. +Você pode informar que um ambiente transitório não existe mais definindo seu `estado` como `inativo`. Definir o `estado` como `inativo` mostra a implantação como `destruída` em {% data variables.product.prodname_dotcom %} e remove o acesso a ela. {% for operation in currentRestOperations %} {% if operation.subcategory == 'deployments' %}{% include rest_operation %}{% endif %} @@ -151,25 +151,25 @@ You can communicate that a transient environment no longer exists by setting its {% if operation.subcategory == 'forks' %}{% include rest_operation %}{% endif %} {% endfor %} -## Invitations +## Convites -The Repository Invitations API allows users or external services to invite other users to collaborate on a repo. The invited users (or external services on behalf of invited users) can choose to accept or decline the invitations. +A API de Convites do Repositório permite que usuários ou serviços externos convidem outros usuários para colaborar em um repositório. Os usuários convidados (ou serviços externos em nome dos usuários convidados) podem optar por aceitar ou recusar os convites. -Note that the `repo:invite` [OAuth scope](/developers/apps/scopes-for-oauth-apps) grants targeted access to invitations **without** also granting access to repository code, while the `repo` scope grants permission to code as well as invitations. +Observe que o [Escopo OAuth](/developers/apps/scopes-for-oauth-apps) `repo:invite` concede acesso direcionado aos convites **sem** conceder também acesso ao código do repositório. enquanto o escopo `repo` concede permissão ao código e aos convites convites. -### Invite a user to a repository +### Convidar um usuário para um repositório -Use the API endpoint for adding a collaborator. For more information, see "[Add a repository collaborator](/rest/reference/repos#add-a-repository-collaborator)." +Use o ponto de extremidade da API para adicionar um colaborador. Para obter mais informações, consulte "[Adicionar um colaborador de repositório](/rest/reference/repos#add-a-repository-collaborator)". {% for operation in currentRestOperations %} {% if operation.subcategory == 'invitations' %}{% include rest_operation %}{% endif %} {% endfor %} -## Merging +## Mesclar -The Repo Merging API supports merging branches in a repository. This accomplishes essentially the same thing as merging one branch into another in a local repository and then pushing to {% data variables.product.product_name %}. The benefit is that the merge is done on the server side and a local repository is not needed. This makes it more appropriate for automation and other tools where maintaining local repositories would be cumbersome and inefficient. +A API de merge do repositório é compatível com o merge de branches em um repositório. Isso realiza, essencialmente, a mesma coisa que mesclar um branch em outro em um repositório local e, em seguida, fazer push para {% data variables.product.product_name %}. O benefício é que o merge é realizado no lado do servidor e não é necessário um repositório local. Isso o torna mais apropriado para automação e outras ferramentas em que a manutenção de repositórios locais seria pesada e ineficiente. -The authenticated user will be the author of any merges done through this endpoint. +O usuário autenticado será o autor de qualquer merge feito por meio deste ponto de extremidade. {% for operation in currentRestOperations %} {% if operation.subcategory == 'merging' %}{% include rest_operation %}{% endif %} @@ -177,20 +177,20 @@ The authenticated user will be the author of any merges done through this endpoi ## Pages -The {% data variables.product.prodname_pages %} API retrieves information about your {% data variables.product.prodname_pages %} configuration, and the statuses of your builds. Information about the site and the builds can only be accessed by authenticated owners, even though the websites are public. For more information, see "[About {% data variables.product.prodname_pages %}](/github/working-with-github-pages/about-github-pages)." +A API de {% data variables.product.prodname_pages %} recupera informações sobre a sua configuração do {% data variables.product.prodname_pages %} e os status das suas criações. As informações sobre o site e as criações só podem ser acessadas por proprietários autenticados, mesmo que os sites sejam públicos. Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_pages %}](/github/working-with-github-pages/about-github-pages)". -In {% data variables.product.prodname_pages %} API endpoints with a `status` key in their response, the value can be one of: -* `null`: The site has yet to be built. -* `queued`: The build has been requested but not yet begun. -* `building`:The build is in progress. -* `built`: The site has been built. -* `errored`: Indicates an error occurred during the build. +Nos pontos de extremidade da API de {% data variables.product.prodname_pages %} com uma chave de `status` na sua resposta, o valor pode ser: +* `null`: O site ainda não foi criado. +* `queued`: A criação foi solicitada, mas ainda não começou. +* `building`:A criaçãoestá em andamento. +* `built`: O site foi criado. +* `errored`: Indica que ocorreu um erro durante a criação. -In {% data variables.product.prodname_pages %} API endpoints that {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}support the `mister-fantastic-preview` and{% endif %} return GitHub Pages site information, the JSON responses include these fields: -* `html_url`: The absolute URL (including scheme) of the rendered Pages site. For example, `https://username.github.io`. -* `source`: An object that contains the source branch and directory for the rendered Pages site. Isto inclui: - - `branch`: The repository branch used to publish your [site's source files](/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site). For example, _master_ or _gh-pages_. - - `path`: The repository directory from which the site publishes. Will be either `/` or `/docs`. +Nos pontos de extremidade da API de {% data variables.product.prodname_pages %} que devolvem as informações do site do GitHub Pages, as respostas do JSON incluem esses campos: +* `html_url`: A URL absoluta (incluindo o esquema) do site de páginas interpretadas. Por exemplo, `https://username.github.io`. +* `source`: Um objeto que contém o branch de origem e o diretório do site de páginas interpretadas. Isto inclui: + - `branch`: O branch do repositório utilizado para publicar os [arquivos de origem do site](/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site). Por exemplo, _principal_ ou _gh-pages_. + - `path`: O diretório do repositório a partir do qual o site é publicado. Será `/` ou `/docs`. {% for operation in currentRestOperations %} {% if operation.subcategory == 'pages' %}{% include rest_operation %}{% endif %} @@ -200,7 +200,7 @@ In {% data variables.product.prodname_pages %} API endpoints that {% if currentV {% note %} -**Note:** The Releases API replaces the Downloads API. You can retrieve the download count and browser download URL from the endpoints in this API that return releases and release assets. +**Observação:** A API de versões substitui a API de Downloads. Você pode recuperar a contagem de download e a URL de download do navegador a partir dos pontos de extremidades nesta API que retornam versões e liberam ativos. {% endnote %} @@ -208,23 +208,23 @@ In {% data variables.product.prodname_pages %} API endpoints that {% if currentV {% if operation.subcategory == 'releases' %}{% include rest_operation %}{% endif %} {% endfor %} -## Statistics +## Estatísticas -The Repository Statistics API allows you to fetch the data that {% data variables.product.product_name %} uses for visualizing different types of repository activity. +A API de Estatísticas do Repositório permite que você recupere os dados que o {% data variables.product.product_name %} usa para visualizar diferentes tipos de atividade do repositório. -### A word about caching +### Umas palavras sobre o armazenamento em cache -Computing repository statistics is an expensive operation, so we try to return cached data whenever possible. If the data hasn't been cached when you query a repository's statistics, you'll receive a `202` response; a background job is also fired to start compiling these statistics. Give the job a few moments to complete, and then submit the request again. If the job has completed, that request will receive a `200` response with the statistics in the response body. +Computar as estatísticas do repositório é uma operação cara. Por esse motivo, tentamos retornar dados armazenados em cache sempre que possível. Se os dados não forem armazenados em cache nas estatísticas de um repositório, você receberá uma resposta de `202`; um trabalho em segundo plano também é acionado para começar a compilar estas estatísticas. Dê ao trabalho alguns instantes para que seja concluído e, em seguida, envie a solicitação novamente. Se o trabalho foi concluído, essa solicitação receberá uma resposta de `200` com as estatísticas no texto da resposta. -Repository statistics are cached by the SHA of the repository's default branch, which is usually master; pushing to the default branch resets the statistics cache. +As estatísticas do repositório são armazenadas em cache pelo SHA do branch-padrão do repositório; fazer push para o branch-padrão redefine o armazenamento em cache de estatísticas. -### Statistics exclude some types of commits +### As estatísticas excluem alguns tipos de commits -The statistics exposed by the API match the statistics shown by [different repository graphs](/github/visualizing-repository-data-with-graphs/about-repository-graphs). +As estatísticas expostas pela API correspondem às estatísticas mostradas pelos [diferentes gráficos de repositórios](/github/visualizing-repository-data-with-graphs/about-repository-graphs). -To summarize: -- All statistics exclude merge commits. -- Contributor statistics also exclude empty commits. +Resumo: +- Todas as estatísticas excluem commits de merge. +- As estatísticas do contribuidor também excluem commits vazios. {% for operation in currentRestOperations %} {% if operation.subcategory == 'statistics' %}{% include rest_operation %}{% endif %} @@ -232,17 +232,17 @@ To summarize: ## Status -The status API allows external services to mark commits with an `error`, `failure`, `pending`, or `success` state, which is then reflected in pull requests involving those commits. +A API de status permite que serviços externos marquem commits com status de `erro`, `falha`, `pendente` ou `sucesso`, o que é refletido em pull requests que envolvem esses commits. -Statuses can also include an optional `description` and `target_url`, and we highly recommend providing them as they make statuses much more useful in the GitHub UI. +Os status também podem incluir uma `descrição` opcional e `target_url`, e é altamente recomendável fornecê-los, pois tornam o status muito mais útil na interface de usuário do GitHub. -As an example, one common use is for continuous integration services to mark commits as passing or failing builds using status. The `target_url` would be the full URL to the build output, and the `description` would be the high level summary of what happened with the build. +Como exemplo, um uso comum é para serviços de integração contínua para marcar commits como criações que passam ou que falham usando o status. O `target_url` seria a URL completa para a saída da criação, e a `descrição` seria o resumo de alto nível do que aconteceu com a criação. -Statuses can include a `context` to indicate what service is providing that status. For example, you may have your continuous integration service push statuses with a context of `ci`, and a security audit tool push statuses with a context of `security`. You can then use the [Get the combined status for a specific reference](/rest/reference/repos#get-the-combined-status-for-a-specific-reference) to retrieve the whole status for a commit. +Os status podem incluir um `contexto` para indicar qual serviço está fornecendo esse status. Por exemplo, você pode fazer com que o seu serviço de integração contínua faça push status com um contexto de `ci`, e uma ferramenta de auditoria de segurança faça push dos status com um contexto de `segurança`. Você pode usar [Obter o status combinado para uma referência específica](/rest/reference/repos#get-the-combined-status-for-a-specific-reference) para recuperar todo o status de um commit. -Note that the `repo:status` [OAuth scope](/developers/apps/scopes-for-oauth-apps) grants targeted access to statuses **without** also granting access to repository code, while the `repo` scope grants permission to code as well as statuses. +Observe que o `escopo do OAuth` [repo:status](/developers/apps/scopes-for-oauth-apps) concede acesso direcionado a status **sem** conceder acesso ao código do repositório, enquanto o escopo `repo` concede permissão para o código e para status. -If you are developing a GitHub App and want to provide more detailed information about an external service, you may want to use the [Checks API](/rest/reference/checks). +Se você está desenvolvendo um aplicativo GitHub e deseja fornecer informações mais detalhadas sobre um serviço externo, você deverá usar a [API de verificação](/rest/reference/checks). {% for operation in currentRestOperations %} {% if operation.subcategory == 'statuses' %}{% include rest_operation %}{% endif %} @@ -250,7 +250,7 @@ If you are developing a GitHub App and want to provide more detailed information ## Tráfego -For repositories that you have push access to, the traffic API provides access to the information provided in your repository graph. For more information, see "Viewing traffic to a repository." +Para repositórios aos quais você tem acesso de push, a API de tráfego fornece acesso às informações fornecidas no seu gráfico de repositório. Para obter mais informações, consulte "Visualizar tráfego para um repositório. " {% for operation in currentRestOperations %} {% if operation.subcategory == 'traffic' %}{% include rest_operation %}{% endif %} @@ -258,41 +258,41 @@ For repositories that you have push access to, the traffic API provides access t ## Webhooks -The Repository Webhooks API allows repository admins to manage the post-receive hooks for a repository. Webhooks can be managed using the JSON HTTP API, or the [PubSubHubbub](#PubSubHubbub) API. +A API de Webhooks do Repositório permite que os administradores do repositório gerenciem os hooks post-receive de um repositório. Os webhooks podem ser gerenciados usando a API de HTTP do JSON ou a API de [SubHubbub](#PubSubHubbub). -If you would like to set up a single webhook to receive events from all of your organization's repositories, see our API documentation for [Organization Webhooks](/rest/reference/orgs#webhooks). +Se você deseja configurar um único webhook para receber eventos de todos os repositórios da organização, consulte nossa documentação de API para [Webhooks de organização](/rest/reference/orgs#webhooks). {% for operation in currentRestOperations %} {% if operation.subcategory == 'hooks' %}{% include rest_operation %}{% endif %} {% endfor %} -### Receiving Webhooks +### Receber Webhooks -In order for {% data variables.product.product_name %} to send webhook payloads, your server needs to be accessible from the Internet. We also highly suggest using SSL so that we can send encrypted payloads over HTTPS. +Para que {% data variables.product.product_name %} envie cargas de webhook, seu servidor deve ser acessível pela internet. É altamente recomendável o uso de SSL para que possamos enviar cargas criptografadas por HTTPS. -#### Webhook headers +#### Cabeçalhos de webhook -{% data variables.product.product_name %} will send along several HTTP headers to differentiate between event types and payload identifiers. See [webhook headers](/developers/webhooks-and-events/webhook-events-and-payloads#delivery-headers) for details. +{% data variables.product.product_name %} enviará ao longo de vários cabeçalhos de HTTP para diferenciar entre tipos de evento e identificadores de carga. Consulte [cabeçalhos de webhook](/developers/webhooks-and-events/webhook-events-and-payloads#delivery-headers) para obter informações. ### PubSubHubbub -GitHub can also serve as a [PubSubHubbub](https://github.com/pubsubhubbub/PubSubHubbub) hub for all repositories. PSHB is a simple publish/subscribe protocol that lets servers register to receive updates when a topic is updated. The updates are sent with an HTTP POST request to a callback URL. Topic URLs for a GitHub repository's pushes are in this format: +O GitHub também pode servir como um centro de [PubSubHubbub](https://github.com/pubsubhubbub/PubSubHubbub) para todos os repositórios. O PSHB é um simples protocolo de publicação/assinatura que permite o registro de servidores para receber atualizações quando um tópico é atualizado. As atualizações são enviadas com uma solicitação HTTP do tipo POST para uma URL de chamada de retorno. As URLs dos tópicos dos pushes de um repositório do GitHub estão neste formato: `https://github.com/{owner}/{repo}/events/{event}` -The event can be any available webhook event. For more information, see "[Webhook events and payloads](/developers/webhooks-and-events/webhook-events-and-payloads)." +O evento pode ser qualquer evento de webhook disponível. Para obter mais informações, consulte "[Eventos e cargas de Webhook](/developers/webhooks-and-events/webhook-events-and-payloads)". -#### Response format +#### Formato de resposta -O formato padrão é o que [os hooks post-receive existentes devem esperar](/post-receive-hooks/): Um texto JSON enviado como parâmetro `payload` em um POST. You can also specify to receive the raw JSON body with either an `Accept` header, or a `.json` extension. +O formato padrão é o que [os hooks post-receive existentes devem esperar](/post-receive-hooks/): Um texto JSON enviado como parâmetro `payload` em um POST. Você também pode especificar para receber o texto do JSON sem processar com um cabeçalho `Aceitar` ou uma extensão `.json`. Accept: application/json https://github.com/{owner}/{repo}/events/push.json -#### Callback URLs -Callback URLs can use the `http://` protocol. +#### URLs de chamada de retorno +As URLs de chamada de retorno podem usar o protocolo `http://`. -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.20" %}You can also `github://` callbacks to specify a GitHub service. +{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.20" %}Você também pode `github://` fazer chamada de retorno para especificar um serviço do GitHub. {% data reusables.apps.deprecating_github_services_ghe %} {% endif %} @@ -303,9 +303,9 @@ Callback URLs can use the `http://` protocol. # Send updates to Campfire github://campfire?subdomain=github&room=Commits&token=abc123 {% endif %} -#### Subscribing +#### Assinar -The GitHub PubSubHubbub endpoint is: `{% data variables.product.api_url_code %}/hub`. A successful request with curl looks like: +O ponto de extremidade do GitHub PubSubHubbub é: `{% data variables.product.api_url_code %}/hub`. Uma solicitação bem-sucedida com o curl parece como: ``` shell curl -u "user" -i \ @@ -315,13 +315,13 @@ curl -u "user" -i \ -F "hub.callback=http://postbin.org/123" ``` -PubSubHubbub requests can be sent multiple times. If the hook already exists, it will be modified according to the request. +Solicitações do PubSubHubbub podem ser enviadas várias vezes. Se o hook já existe, ele será modificado de acordo com a solicitação. ##### Parâmetros -| Nome | Tipo | Descrição | -| -------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `hub.mode` | `string` | **Obrigatório**. Either `subscribe` or `unsubscribe`. | -| `hub.topic` | `string` | **Obrigatório**. The URI of the GitHub repository to subscribe to. The path must be in the format of `/{owner}/{repo}/events/{event}`. | -| `hub.callback` | `string` | The URI to receive the updates to the topic. | -| `hub.secret` | `string` | A shared secret key that generates a SHA1 HMAC of the outgoing body content. You can verify a push came from GitHub by comparing the raw request body with the contents of the `X-Hub-Signature` header. You can see [the PubSubHubbub documentation](https://pubsubhubbub.github.io/PubSubHubbub/pubsubhubbub-core-0.4.html#authednotify) for more details. | +| Nome | Tipo | Descrição | +| -------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `hub.mode` | `string` | **Obrigatório**. `Assine` ou `cancele a assinatura`. | +| `hub.topic` | `string` | **Obrigatório**. A URI do repositório do GitHub a ser assinada. O caminho deve estar no formato `/{owner}/{repo}/events/{event}`. | +| `hub.callback` | `string` | A URI para receber as atualizações do tópico. | +| `hub.secret` | `string` | Uma chave secreta compartilhada que gera um HMAC de SHA1 do conteúdo do texto de saída. Você pode verificar se um push veio do GitHub, comparando o texto da solicitação sem processamento com o conteúdo do cabeçalho `X-Hub-Signature`. Você pode ver [a documentação do PubSubHubbub](https://pubsubhubbub.github.io/PubSubHubbub/pubsubhubbub-core-0.4.html#authednotify) para obter mais informações. | diff --git a/translations/pt-BR/content/rest/reference/scim.md b/translations/pt-BR/content/rest/reference/scim.md index 3245e41b02ba..19a5944fd227 100644 --- a/translations/pt-BR/content/rest/reference/scim.md +++ b/translations/pt-BR/content/rest/reference/scim.md @@ -6,35 +6,35 @@ versions: free-pro-team: '*' --- -### SCIM Provisioning for Organizations +### Provisionamento de SCIM para Organizações -The SCIM API is used by SCIM-enabled Identity Providers (IdPs) to automate provisioning of {% data variables.product.product_name %} organization membership. A API {% data variables.product.product_name %} é baseada na versão 2.0 do [padrão SCIM](http://www.simplecloud.info/). The {% data variables.product.product_name %} SCIM endpoint that an IdP should use is: `{% data variables.product.api_url_code %}/scim/v2/organizations/{org}/`. +A API do SCIM é usada pelos provedores de identidade (IdPs) habilitados pelo SCIM para automatizar o provisionamento de integrantes da organização de {% data variables.product.product_name %}. A API {% data variables.product.product_name %} é baseada na versão 2.0 do [padrão SCIM](http://www.simplecloud.info/). O ponto de extremidade do SCIM do {% data variables.product.product_name %} que um IdP deve usar é: `{% data variables.product.api_url_code %}/scim/v2/organizations/{org}/`. {% note %} -**Note:** The SCIM API is available only to organizations on [{% data variables.product.prodname_ghe_cloud %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-accounts) with [SAML SSO](/v3/auth/#authenticating-for-saml-sso) enabled. Para obter mais informações sobre o SCIM, consulte "[Sobre o SCIM](/github/setting-up-and-managing-organizations-and-teams/about-scim)." +**Observação:** A API do SCIM está disponível apenas para organizações em [{% data variables.product.prodname_ghe_cloud %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-accounts) com [SSO de SAML](/v3/auth/#authenticating-for-saml-sso) habilitado. Para obter mais informações sobre o SCIM, consulte "[Sobre o SCIM](/github/setting-up-and-managing-organizations-and-teams/about-scim)." {% endnote %} -### Authenticating calls to the SCIM API +### Autenticar chamadas para a API de SCIM -You must authenticate as an owner of a {% data variables.product.product_name %} organization to use its SCIM API. A API espera que um token [OAuth 2.0](/developers/apps/authenticating-with-github-apps) seja incluído no cabeçalho da `Autorização`. Você também pode usar um token de acesso pessoal, mas primeiro deve [autorizá-lo para uso com sua organização SAML SSO](/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on). +Você deve efetuar a autenticação como dono de uma organização do {% data variables.product.product_name %} para usar sua API do SCIM. A API espera que um token [OAuth 2.0](/developers/apps/authenticating-with-github-apps) seja incluído no cabeçalho da `Autorização`. Você também pode usar um token de acesso pessoal, mas primeiro deve [autorizá-lo para uso com sua organização SAML SSO](/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on). -### Mapping of SAML and SCIM data +### Mapear dados do SAML e SCIM O SAML IdP e o cliente SCIM devem usar valores correspondentes ao `NameID` e `userName` para cada usuário. Isso permite que um usuário que faz autenticação através do SAML seja vinculado à sua identidade SCIM provisionada. -### Supported SCIM User attributes - -| Nome | Tipo | Descrição | -| ---------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `userName` | `string` | The username for the user. | -| `name.givenName` | `string` | The first name of the user. | -| `name.lastName` | `string` | The last name of the user. | -| `emails` | `array` | List of user emails. | -| `externalId` | `string` | This identifier is generated by the SAML provider, and is used as a unique ID by the SAML provider to match against a GitHub user. You can find the `externalID` for a user either at the SAML provider, or using the [List SCIM provisioned identities](#list-scim-provisioned-identities) endpoint and filtering on other known attributes, such as a user's GitHub username or email address. | -| `id` | `string` | Identifier generated by the GitHub SCIM endpoint. | -| `ativo` | `boolean` | Used to indicate whether the identity is active (true) or should be deprovisioned (false). | +### Atributos de usuário de SCIM compatíveis + +| Nome | Tipo | Descrição | +| ---------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `userName` | `string` | O nome de usuário para o usuário. | +| `name.givenName` | `string` | O primeiro nome do usuário. | +| `name.lastName` | `string` | O sobrenome do usuário. | +| `emails` | `array` | Lista de e-mails dos usuários. | +| `externalId` | `string` | Este identificador é gerado pelo provedor do SAML e é usado como um ID exclusivo pelo provedor do SAML para corresponder ao usuário do GitHub. Você pode encontrar o `externalID` para um usuário no provedor do SAML ou usar a [listar identidades fornecidas pelo ponto de extremidade do SCIM](#list-scim-provisioned-identities) e filtrar outros atributos conhecidos, como, por exemplo, o nome de usuário no GitHub ou endereço de e-mail de usuário. | +| `id` | `string` | Identificador gerado pelo ponto de extremidade do SCIM do GitHub. | +| `ativo` | `boolean` | Usado para indicar se a identidade está ativa (verdadeira) ou se deve ser desprovisionada (falso). | {% note %} diff --git a/translations/pt-BR/content/rest/reference/search.md b/translations/pt-BR/content/rest/reference/search.md index 5f85f94b9403..7976991bce98 100644 --- a/translations/pt-BR/content/rest/reference/search.md +++ b/translations/pt-BR/content/rest/reference/search.md @@ -7,103 +7,103 @@ versions: enterprise-server: '*' --- -The Search API helps you search for the specific item you want to find. For example, you can find a user or a specific file in a repository. Think of it the way you think of performing a search on Google. It's designed to help you find the one result you're looking for (or maybe the few results you're looking for). Just like searching on Google, you sometimes want to see a few pages of search results so that you can find the item that best meets your needs. To satisfy that need, the {% data variables.product.product_name %} Search API provides **up to 1,000 results for each search**. +A API de pesquisa ajuda a pesquisar o item específico que você deseja encontrar. Por exemplo, você pode encontrar um usuário ou um arquivo específico em um repositório. Pense nisso da mesma forma que você pensa em realizar uma pesquisa no Google. Ele é projetado para ajudá-lo a encontrar o resultado que você está procurando (ou talvez os poucos resultados que você está procurando). Assim como pesquisar no Google, às vezes, você quer ver algumas páginas com resultados de pesquisa para que você possa encontrar o item que melhor atenda às suas necessidades. Para atender a essa necessidade, a API de pesquisa do {% data variables.product.product_name %} fornece **até 1.000 resultados para cada pesquisa**. -You can narrow your search using queries. To learn more about the search query syntax, see "[Constructing a search query](/v3/search/#constructing-a-search-query)." +Você pode restringir sua pesquisa usando as consultas. Para saber mais sobre a sintaxe de consultas de pesquisa, consulte "[Criar uma consulta de pesquisa](/v3/search/#constructing-a-search-query)". -### Ranking search results +### Resultados da pesquisa de classificação -Unless another sort option is provided as a query parameter, results are sorted by best match in descending order. Multiple factors are combined to boost the most relevant item to the top of the result list. +A menos que outra opção de ordenamento seja fornecida como um parâmetro de consulta, os resultados são ordenados pela melhor correspondência e em ordem decrescente. Vários fatores são combinados para impulsionar o item mais relevante para a parte superior da lista de resultados. ### Limite de taxa -The Search API has a custom rate limit. For requests using [Basic Authentication](/v3/#authentication), [OAuth](/v3/#authentication), or [client ID and secret](/v3/#increasing-the-unauthenticated-rate-limit-for-oauth-applications), you can make up to 30 requests per minute. For unauthenticated requests, the rate limit allows you to make up to 10 requests per minute. +A API de pesquisa tem um limite de taxa personalizado. Para solicitações que usam a [Autenticação Básica](/v3/#authentication)[OAuth ](/v3/#authentication) ou [ID e segredo do cliente e](/v3/#increasing-the-unauthenticated-rate-limit-for-oauth-applications), você pode fazer até 30 solicitações por minuto. Para solicitações não autenticadas, o limite de taxa permite que você faça até 10 solicitações por minuto. {% data reusables.enterprise.rate_limit %} -See the [rate limit documentation](/rest/reference/rate-limit) for details on determining your current rate limit status. +Veja a [documentação do limite de taxa](/rest/reference/rate-limit) para obter informações sobre a determinação do seu status atual de limite de taxa. -### Constructing a search query +### Criar uma consulta de pesquisa -Each endpoint in the Search API uses [query parameters](https://en.wikipedia.org/wiki/Query_string) to perform searches on {% data variables.product.product_name %}. See the individual endpoint in the Search API for an example that includes the endpoint and query parameters. +Cada ponto de extremidade na API de Pesquisa usa [parâmetros de consulta](https://en.wikipedia.org/wiki/Query_string) para realizar pesquisas no {% data variables.product.product_name %}. Veja o ponto de extremidade individual na API de pesquisa para obter um exemplo que inclui o ponto de extremidade de parâmetros de consulta. -A query can contain any combination of search qualifiers supported on GitHub.com. The format of the search query is: +Uma consulta pode conter qualquer combinação de qualificadores de pesquisa compatíveis no GitHub.com. O formato da consulta de pesquisa é: ``` q=SEARCH_KEYWORD_1+SEARCH_KEYWORD_N+QUALIFIER_1+QUALIFIER_N ``` -For example, if you wanted to search for all _repositories_ owned by `defunkt` that contained the word `GitHub` and `Octocat` in the README file, you would use the following query with the _search repositories_ endpoint: +Por exemplo, se você quisesse pesquisar todos os _repositórios_ de propriedade de `defunkt` que continham a palavra `GitHub` e `Octocat` no arquivo LEIAME, você usaria a consulta seguinte com o ponto de extremidade _pesquisar repositórios_: ``` q=GitHub+Octocat+in:readme+user:defunkt ``` -See "[Searching on GitHub](/articles/searching-on-github/)" for a complete list of available qualifiers, their format, and an example of how to use them. For information about how to use operators to match specific quantities, dates, or to exclude results, see "[Understanding the search syntax](/articles/understanding-the-search-syntax/)." +Veja "[Pesquisar no GitHub](/articles/searching-on-github/)" para obter uma lista completa de qualificadores disponíveis, seu formato e um exemplo de como usá-los. Para obter informações sobre como usar operadores para corresponder a quantidades e datas específicas ou para excluir resultados, consulte "[Entender a sintaxe de pesquisa](/articles/understanding-the-search-syntax/)". ### Limitações no tamanho da consulta -The Search API does not support queries that: -- are longer than 256 characters (not including operators or qualifiers). -- have more than five `AND`, `OR`, or `NOT` operators. +A API de pesquisa não é compatível com consultas que: +- têm tamanho superior a 256 caracteres (não incluindo operadores ou qualificadores). +- têm mais de cinco operadores de `E`, `OU` ou `NÃO` operadores. -These search queries will return a "Validation failed" error message. +Estas consultas de pesquisa irão retornar uma mensagem de erro "Ocorreu uma falha na validação". -### Timeouts and incomplete results +### Tempo esgotado e resultados incompletos -To keep the Search API fast for everyone, we limit how long any individual query can run. For queries that [exceed the time limit](https://developer.github.com/changes/2014-04-07-understanding-search-results-and-potential-timeouts/), the API returns the matches that were already found prior to the timeout, and the response has the `incomplete_results` property set to `true`. +Para manter a API de pesquisa rápida para todos, limitamos quanto tempo todas as consulta individual podem ser executadas. Para consultas que [excedem o tempo limite](https://developer.github.com/changes/2014-04-07-understanding-search-results-and-potential-timeouts/), a API retorna as correspondências que já foram encontradas antes do tempo limite, e a resposta tem a propriedade `incomplete_results` definida como `verdadeiro`. -Atingir um tempo limite não significa necessariamente que os resultados da pesquisa estão incompletos. More results might have been found, but also might not. +Atingir um tempo limite não significa necessariamente que os resultados da pesquisa estão incompletos. É possível que mais resultados tenham sido, mas também é possível que não. -### Access errors or missing search results +### Erros de acesso ou resultados de pesquisa ausentes -You need to successfully authenticate and have access to the repositories in your search queries, otherwise, you'll see a `422 Unprocessible Entry` error with a "Validation Failed" message. For example, your search will fail if your query includes `repo:`, `user:`, or `org:` qualifiers that request resources that you don't have access to when you sign in on {% data variables.product.prodname_dotcom %}. +Você precisa efetuar a autenticação com sucesso e ter acesso aos repositórios nas consultas de pesquisa. Caso contrário, você verá um erro 422 Unprocessible Entry` com uma mensagem "Falha na validação". Por exemplo, sua pesquisa irá falhar se sua consulta incluir qualificadores repo:`, `user:` ou `org:` que solicitam recursos aos quais você não tem acesso ao efetuar login em {% data variables.product.prodname_dotcom %}. -When your search query requests multiple resources, the response will only contain the resources that you have access to and will **not** provide an error message listing the resources that were not returned. +Quando sua consulta de pesquisa solicitar vários recursos, a resposta só conterá os recursos aos quais você tem acesso e **não** fornecerá uma mensagem de erro listando os recursos que não foram retornados. -For example, if your search query searches for the `octocat/test` and `codertocat/test` repositories, but you only have access to `octocat/test`, your response will show search results for `octocat/test` and nothing for `codertocat/test`. This behavior mimics how search works on {% data variables.product.prodname_dotcom %}. +Por exemplo, se sua consulta de pesquisa pesquisar os repositórios `octocat/test` e `codertocat/test`, mas você só tem acesso a `octocat/test`, a sua resposta mostrará resultados de pesquisa para `octocat/test` e nenhum resultado para `codertocat/teste`. Este comportamento imita como a pesquisa que funciona no {% data variables.product.prodname_dotcom %}. {% include rest_operations_at_current_path %} -### Text match metadata +### Metadados da correspondência de texto -On GitHub, you can use the context provided by code snippets and highlights in search results. The Search API offers additional metadata that allows you to highlight the matching search terms when displaying search results. +No GitHub, você pode usar o contexto fornecido por trechos de código e destaques nos resultados de pesquisa. A API de pesquisa oferece metadados adicionais que permitem que você destaque os termos de pesquisa correspondentes ao exibir resultados de busca. ![code-snippet-highlighting](/assets/images/text-match-search-api.png) -Requests can opt to receive those text fragments in the response, and every fragment is accompanied by numeric offsets identifying the exact location of each matching search term. +As solicitações podem optar por receber esses fragmentos de texto na resposta, e cada fragmento é acompanhado de ajustes numéricos que identificam a localização exata de cada termo de pesquisa correspondente. -To get this metadata in your search results, specify the `text-match` media type in your `Accept` header. +Para obter esses metadados nos resultados da sua pesquisa, especifique o tipo de mídia de `text-match` no seu cabeçalho `Aceitar`. ```shell application/vnd.github.v3.text-match+json ``` -When you provide the `text-match` media type, you will receive an extra key in the JSON payload called `text_matches` that provides information about the position of your search terms within the text and the `property` that includes the search term. Inside the `text_matches` array, each object includes the following attributes: +Ao fornecer o tipo de mídia `text-match`, você receberá uma chave extra na carga do JSON denominada `text_matches`, que fornece informações sobre a posição dos seus termos de pesquisa dentro do texto e da `propriedade` que inclui o termo de pesquisa. Dentro do array `text_match`, cada objeto inclui os atributos a seguir: -| Nome | Descrição | -| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `object_url` | The URL for the resource that contains a string property matching one of the search terms. | -| `object_type` | The name for the type of resource that exists at the given `object_url`. | -| `property` | The name of a property of the resource that exists at `object_url`. That property is a string that matches one of the search terms. (In the JSON returned from `object_url`, the full content for the `fragment` will be found in the property with this name.) | -| `fragmento` | A subset of the value of `property`. This is the text fragment that matches one or more of the search terms. | -| `matches` | An array of one or more search terms that are present in `fragment`. The indices (i.e., "offsets") are relative to the fragment. (They are not relative to the _full_ content of `property`.) | +| Nome | Descrição | +| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `object_url` | A URL para o recurso que contém uma propriedade de string que corresponde a um dos termos de pesquisa. | +| `object_type` | O nome para o tipo de recurso que existe em determinado `object_url`. | +| `propriedade` | O nome de uma propriedade do recurso que existe em `object_url`. Esta propriedade é uma string que corresponde a um dos termos de pesquisa. (No JSON retornado a partir de `object_url`, o conteúdo completo do `fragmento` será encontrado na propriedade com este nome.) | +| `fragmento` | Um subconjunto do valor de `propriedade`. Este é o fragmento de texto que corresponde a um ou mais dos termos de pesquisa. | +| `matches` | Um array de um ou mais termos de pesquisa que estão presentes no `fragmento`. Os índices (ou seja, "ajustes") são relativos ao fragmento. (Eles não são relativos ao conteúdo _completo_ de `propriedade`.) | #### Exemplo -Using cURL, and the [example issue search](#search-issues-and-pull-requests) above, our API request would look like this: +Se usarmos cURL e o [exemplo de pesquisa de problemas](#search-issues-and-pull-requests) acima, nossa solicitação de API seria da seguinte forma: ``` shell curl -H 'Accept: application/vnd.github.v3.text-match+json' \ '{% data variables.product.api_url_pre %}/search/issues?q=windows+label:bug+language:python+state:open&sort=created&order=asc' ``` -The response will include a `text_matches` array for each search result. In the JSON below, we have two objects in the `text_matches` array. +A resposta incluirá um array `text_matches` para cada resultado de pesquisa. No JSON abaixo, temos dois objetos no array `text_matches`. -The first text match occurred in the `body` property of the issue. We see a fragment of text from the issue body. The search term (`windows`) appears twice within that fragment, and we have the indices for each occurrence. +A primeira correspondência de texto ocorreu na propriedade do `texto` do problema. Vemos um fragmento de texto a partir do texto do problema. O termo da pesquisa (`windows`) aparece duas vezes dentro desse fragmento, e temos os índices para cada ocorrência. -The second text match occurred in the `body` property of one of the issue's comments. We have the URL for the issue comment. And of course, we see a fragment of text from the comment body. The search term (`windows`) appears once within that fragment. +A segunda correspondência de texto ocorreu na propriedade do `texto` de um dos comentários do problema. Nós temos a URL do comentário do problema. E, evidentemente, vemos um fragmento de texto do comentário. O termo de pesquisa (`windows`) aparece uma vez dentro desse fragmento. ```json { diff --git a/translations/pt-BR/content/rest/reference/teams.md b/translations/pt-BR/content/rest/reference/teams.md index eff5fdc8434a..33b7574e60e8 100644 --- a/translations/pt-BR/content/rest/reference/teams.md +++ b/translations/pt-BR/content/rest/reference/teams.md @@ -7,23 +7,23 @@ versions: enterprise-server: '*' --- -This API is only available to authenticated members of the team's [organization](/v3/orgs). OAuth access tokens require the `read:org` [scope](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/). {% data variables.product.prodname_dotcom %} generates the team's `slug` from the team `name`. +Esta API só está disponível para os integrantes autenticados da [organização](/v3/orgs) da equipe. Os tokens de acesso do OAuth exigem o escopo `read:org` [](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/). {% data variables.product.prodname_dotcom %} gera o `slug` da equipe a partir do `nome` da equipe. {% for operation in currentRestOperations %} {% unless operation.subcategory %}{% include rest_operation %}{% endunless %} {% endfor %} -## Discussions +## Discussões -The team discussions API allows you to get, create, edit, and delete discussion posts on a team's page. You can use team discussions to have conversations that are not specific to a repository or project. Any member of the team's [organization](/v3/orgs) can create and read public discussion posts. The team discussions API allows you to get, create, edit, and delete discussion posts on a team's page. You can use team discussions to have conversations that are not specific to a repository or project. This API is only available to authenticated members of the team's organization. +A API de discussões de equipe permite que você obtenha, crie, edite e exclua postagens de discussão na página de uma equipe. Você pode usar discussões da equipe para ter conversas que não são específicas para um repositório ou projeto. Qualquer integrante da [organização](/v3/orgs) da equipe pode criar e ler posts de discussão públicos. The team discussions API allows you to get, create, edit, and delete discussion posts on a team's page. You can use team discussions to have conversations that are not specific to a repository or project. Esta API só está disponível para os integrantes autenticados da organização da equipe. {% for operation in currentRestOperations %} {% if operation.subcategory == 'discussions' %}{% include rest_operation %}{% endif %} {% endfor %} -## Discussion comments +## Comentários da discussão -The team discussion comments API allows you to get, create, edit, and delete discussion comments on a [team discussion](/v3/teams/discussions) post. Any member of the team's [organization](/v3/orgs) can create and read comments on a public discussion. The team discussions API allows you to get, create, edit, and delete discussion posts on a team's page. This API is only available to authenticated members of the team's organization. +A API de comentários de discussão em equipe permite que você obtenha, crie, edite e exclua comentários de discussão em um post de [discussão de equipe](/v3/teams/discussions). Qualquer integrante da organização da [organização](/v3/orgs) da equipe pode criar e ler comentários em uma discussão pública. The team discussions API allows you to get, create, edit, and delete discussion posts on a team's page. Esta API só está disponível para os integrantes autenticados da organização da equipe. {% for operation in currentRestOperations %} {% if operation.subcategory == 'discussion-comments' %}{% include rest_operation %}{% endif %} @@ -31,7 +31,7 @@ The team discussion comments API allows you to get, create, edit, and delete dis ## Integrantes -This API is only available to authenticated members of the team's organization. OAuth access tokens require the `read:org` [scope](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/). +Esta API só está disponível para os integrantes autenticados da organização da equipe. Os tokens de acesso do OAuth exigem o escopo `read:org` [](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/). {% note %} @@ -43,11 +43,11 @@ This API is only available to authenticated members of the team's organization. {% if operation.subcategory == 'members' %}{% include rest_operation %}{% endif %} {% endfor %} -## Team synchronization +## Sincronização de equipes -The Team Synchronization API allows you to manage connections between {% data variables.product.product_name %} teams and external identity provider (IdP) groups. To use this API, the authenticated user must be a team maintainer or an owner of the organization associated with the team. The token you use to authenticate will also need to be authorized for use with your IdP (SSO) provider. Para obter mais informações, consulte "Autorizando um token de acesso pessoal para uso com uma organização de logon único SAML". +A API de Sincronização da Equipe permite que você gerencie as conexões entre equipes de {% data variables.product.product_name %} e grupos de provedor de identidade externo (IdP). Para usar esta API, o usuário autenticado deve ser um mantenedor de equipe ou um proprietário da organização associada à equipe. O token que você usa para efetuar a autenticação também deverá ser autorizado para uso com o provedor de IdP (SSO). Para obter mais informações, consulte "Autorizando um token de acesso pessoal para uso com uma organização de logon único SAML". -You can manage GitHub team members through your IdP with team synchronization. Team synchronization must be enabled to use the Team Synchronization API. Para obter mais informações, consulte "Sincronizar equipes entre seu provedor de identidade e o GitHub". +Você pode gerenciar os integrantes da equipe do GitHub através do seu IdP com a sincronização de equipe. A sincronização de equipe deve estar habilitada para usar a API de sincronização de equipe. Para obter mais informações, consulte "Sincronizar equipes entre seu provedor de identidade e o GitHub". {% for operation in currentRestOperations %} {% if operation.subcategory == 'team-sync' %}{% include rest_operation %}{% endif %} diff --git a/translations/pt-BR/content/rest/reference/users.md b/translations/pt-BR/content/rest/reference/users.md index 3be1f55056b0..aa1908263c15 100644 --- a/translations/pt-BR/content/rest/reference/users.md +++ b/translations/pt-BR/content/rest/reference/users.md @@ -7,13 +7,13 @@ versions: enterprise-server: '*' --- -Many of the resources on the users API provide a shortcut for getting information about the currently authenticated user. If a request URL does not include a `{username}` parameter then the response will be for the logged in user (and you must pass [authentication information](/rest/overview/resources-in-the-rest-api#authentication) with your request). Additional private information, such as whether a user has two-factor authentication enabled, is included when authenticated through basic auth or OAuth with the `user` scope. +Muitos dos recursos na API de usuários fornecem um atalho para obter informações sobre o usuário autenticado atualmente. Se uma URL de solicitação não incluir um parâmetro `{username}`, a resposta será para o usuário conectado (e você deve passar [as informações de autenticação](/rest/overview/resources-in-the-rest-api#authentication) com a sua solicitação). Informações privadas adicionais, como, por exemplo, se um usuário tem autenticação de dois fatores habilitada, são incluídas quando autenticadas através da autenticação básica ou do OAuth com o escopo `usuário`. {% for operation in currentRestOperations %} {% unless operation.subcategory %}{% include rest_operation %}{% endunless %} {% endfor %} -## Blocking users +## Bloquear usuários {% for operation in currentRestOperations %} {% if operation.subcategory == 'blocking' %}{% include rest_operation %}{% endif %} @@ -21,7 +21,7 @@ Many of the resources on the users API provide a shortcut for getting informatio ## E-mails -Management of email addresses via the API requires that you authenticate through basic auth, or through OAuth with a correct scope for the endpoint. +O gerenciamento de endereços de e-mail através da API requer que você efetue a autenticação por meio de autenticação básica, ou através do OAuth com um escopo correto para o ponto de extremidade. {% for operation in currentRestOperations %} {% if operation.subcategory == 'emails' %}{% include rest_operation %}{% endif %} @@ -33,7 +33,7 @@ Management of email addresses via the API requires that you authenticate through {% if operation.subcategory == 'followers' %}{% include rest_operation %}{% endif %} {% endfor %} -## Git SSH keys +## Chaves SSH do Git {% for operation in currentRestOperations %} {% if operation.subcategory == 'keys' %}{% include rest_operation %}{% endif %} @@ -41,7 +41,7 @@ Management of email addresses via the API requires that you authenticate through ## Chaves GPG -The data returned in the `public_key` response field is not a GPG formatted key. When a user uploads a GPG key, it is parsed and the cryptographic public key is extracted and stored. This cryptographic key is what is returned by the APIs on this page. This key is not suitable to be used directly by programs like GPG. +Os dados retornados no campo de resposta `public_key` não são uma chave com formato GPG. Quando um usuário faz o upload de uma chave GPG, ela é analisada e a chave pública criptográfica é extraída e armazenada. Essa chave criptográfica é o que é retornado pelas APIs nesta página. Esta chave não é adequada para ser usada diretamente por programas como o GPG. {% for operation in currentRestOperations %} {% if operation.subcategory == 'gpg-keys' %}{% include rest_operation %}{% endif %} diff --git a/translations/pt-BR/data/glossaries/external.yml b/translations/pt-BR/data/glossaries/external.yml index 2e467a3b7420..d4202c4620b0 100644 --- a/translations/pt-BR/data/glossaries/external.yml +++ b/translations/pt-BR/data/glossaries/external.yml @@ -24,14 +24,14 @@ - term: código de autenticação description: >- - A code you'll supply, in addition to your GitHub password, when signing in with 2FA via the browser. This code is either generated by an application or delivered to your phone via text message. Also called a "2FA authentication code." + Um código que você irá fornecer, além da sua senha do GitHub, ao entrar com 2FA pelo navegador. Este código é gerado por um aplicativo ou enviado ao seu telefone por meio de mensagem de texto. Também chamado de "Código de autenticação 2FA". - term: branch base description: O branch em que as alterações são combinadas quando você faz merge da pull request. Quando você cria uma pull request, é possível alterar o branch base do branch padrão do repositório para outro branch, se necessário. - term: autenticação básica description: >- - A method of authentication where the credentials are sent as unencrypted text. + Um método de autenticação em que as credenciais são enviadas como texto não criptografado. - term: bio description: >- @@ -80,7 +80,7 @@ - term: Verificação description: >- - A check is a type of status check on {% data variables.product.product_name %}. See "[Status checks](#status-checks)." + Uma verificação é um tipo de verificação de status em {% data variables.product.product_name %}. Consulte "[Verificações de status](#status-checks)". - term: fazer checkout description: >- @@ -176,11 +176,11 @@ - term: Painel description: >- - Your personal dashboard is the main hub of your activity on GitHub. From your personal dashboard, you can keep track of issues and pull requests you're following or working on, navigate to your top repositories and team pages, and learn about recent activity in repositories you're watching or participating in. You can also discover new repositories, which are recommended based on users you're following and repositories you have starred. To only view activity for a specific organization, visit your organization's dashboard. For more information, see "[About your personal dashboard](/articles/about-your-personal-dashboard)" or "[About your organization dashboard](/articles/about-your-organization-dashboard)." + Seu painel pessoal é o principal centro da sua atividade no GitHub. No seu painel pessoal, você pode monitorar problemas e pull requests que está acompanhando ou nos quais está trabalhando, acessar os seus melhores repositórios e páginas de equipe e aprender sobre as atividades recentes em repositórios dos quais você está assistindo ou participando. Também é possível descobrir novos repositórios, que são recomendados com base em usuários que você está seguindo e com base em repositórios que você favoritou. Para visualizar somente as atividades de uma organização específica, visite o painel da sua organização. Para obter mais informações, consulte "[Sobre o seu painel pessoal](/articles/about-your-personal-dashboard)" ou "[Sobre o painel da sua organização](/articles/about-your-organization-dashboard)." - term: branch padrão description: >- - Branch de base do repositório, no qual são feitas automaticamente todas as pull request e commits de código, a menos que outro branch seja especificado. Em geral, esse branch é chamado de "mestre". + O branch de base para novos pull requests e commits de código em um repositório. Cada repositório tem pelo menos um branch, que o Git cria quando você inicializa o repositório. O primeiro branch é geralmente denominado `main`, e é, muitas vezes, o branch-padrão. - term: gráfico de dependentes description: >- @@ -213,7 +213,7 @@ description: Notificações enviadas para o endereço de e-mail de um usuário. - term: conta corporativa - description: Enterprise accounts allow you to centrally manage policy and billing for multiple {% data variables.product.prodname_dotcom_the_website %} organizations. {% data reusables.gated-features.enterprise-accounts %} + description: As contas corporativas permitem que você gerencie a política e a cobrança centralmente para várias organizações de {% data variables.product.prodname_dotcom_the_website %}. {% data reusables.gated-features.enterprise-accounts %} - term: Explorador description: >- @@ -228,7 +228,7 @@ Branch usado para testar novos recursos ou corrigir problemas que não estejam em produção. Também é conhecido como branch de tópico. - term: bloco de código isolado - description: 'An indented block of code you can create with GitHub Flavored Markdown using triple backticks \`\`\` before and after the code block. See this [example](https://help.github.com/en/articles/creating-and-highlighting-code-blocks#fenced-code-blocks).' + description: 'Bloco de código com recuo que você pode criar com markdown em estilo GitHub usando barra inversa tripla \`\`\ antes e depois do bloco de código. Consulte este [example] (https://help.github.com/en/articles/creating-and-highlighting-code-blocks#fenced-code-blocks).' - term: fetch description: >- @@ -665,7 +665,7 @@ - term: Chave SSH description: >- - SSH keys are a way to identify yourself to an online server, using an encrypted message. It's as if your computer has its own unique password to another service. {% data variables.product.product_name %} uses SSH keys to securely transfer information to your computer. + Chaves SSH são uma forma de identificar-se com um servidor on-line, usando uma mensagem criptografada. É como se o seu computador tivesse sua própria senha exclusiva para outro serviço. {% data variables.product.product_name %} usa chaves SSH para transferir informações de forma segura para o seu computador. - term: instância de preparo description: >- @@ -677,7 +677,7 @@ - term: Verificações de status description: >- - Status checks are external processes, such as continuous integration builds, which run for each commit you make in a repository. For more information, see "[About status checks](/articles/about-status-checks)." + Verificações de status são processos externos, como criações de integração contínua, que são executadas para cada commit que você fizer em um repositório. Para obter mais informações, consulte "[Verificações de status](/articles/about-status-checks)". - term: estrela description: >- diff --git a/translations/pt-BR/data/glossaries/internal.yml b/translations/pt-BR/data/glossaries/internal.yml index 897500c99dba..aa9c2cccb269 100644 --- a/translations/pt-BR/data/glossaries/internal.yml +++ b/translations/pt-BR/data/glossaries/internal.yml @@ -737,7 +737,7 @@ description: >- Árvore dos arquivos com checkout. Em geral, a árvore de trabalho tem o conteúdo da árvore de commit HEAD e quaisquer outras alterações locais feitas, mas que ainda estão sem commit. - - term: WYSIWIG + term: WYSIWYG description: >- What You See Is What You Get, acrônimo indicativo de que o texto na tela é exatamente igual ao texto exibido após a renderização. - diff --git a/translations/pt-BR/data/graphql/2.22/graphql_upcoming_changes.public-enterprise.yml b/translations/pt-BR/data/graphql/2.22/graphql_upcoming_changes.public-enterprise.yml index 5f5a7bd3ce2c..91b11368a7aa 100644 --- a/translations/pt-BR/data/graphql/2.22/graphql_upcoming_changes.public-enterprise.yml +++ b/translations/pt-BR/data/graphql/2.22/graphql_upcoming_changes.public-enterprise.yml @@ -44,8 +44,8 @@ upcoming_changes: owner: antn - location: EnterprisePendingMemberInvitationEdge.isUnlicensed - description: "`isUnlicensed` will be removed." - reason: All pending members consume a license + description: "`isUnlicensed` será removido." + reason: Todos os integrantes pendentes consomem uma licença date: '2020-07-01T00:00:00+00:00' criticality: breaking owner: BrentWheeldon @@ -107,22 +107,22 @@ upcoming_changes: owner: oneill38 - location: EnterpriseMemberEdge.isUnlicensed - description: "`isUnlicensed` will be removed." - reason: All members consume a license + description: "`isUnlicensed` será removido." + reason: Todos os integrantes consomem uma licença date: '2021-01-01T00:00:00+00:00' criticality: breaking owner: BrentWheeldon - location: EnterpriseOutsideCollaboratorEdge.isUnlicensed - description: "`isUnlicensed` will be removed." - reason: All outside collaborators consume a license + description: "`isUnlicensed` será removido." + reason: Todos os colaboradores externos consomem uma licença date: '2021-01-01T00:00:00+00:00' criticality: breaking owner: BrentWheeldon - location: EnterprisePendingCollaboratorEdge.isUnlicensed - description: "`isUnlicensed` will be removed." - reason: All pending collaborators consume a license + description: "`isUnlicensed` será removido." + reason: Todos os colaboradores pendentes consomem uma licença date: '2021-01-01T00:00:00+00:00' criticality: breaking owner: BrentWheeldon diff --git a/translations/pt-BR/data/graphql/graphql_previews.yml b/translations/pt-BR/data/graphql/graphql_previews.yml index 89c0b2981e2c..dfa025edecfd 100644 --- a/translations/pt-BR/data/graphql/graphql_previews.yml +++ b/translations/pt-BR/data/graphql/graphql_previews.yml @@ -27,57 +27,6 @@ - CreateDeploymentPayload owning_teams: - '@github/ecosystem-api' -- - title: Verificações - description: Esta visualização adiciona suporte para verificações de leitura criadas pelo GitHub Apps. - toggled_by: ':antiope-preview' - announcement: null - updates: null - toggled_on: - - CheckAnnotationRange - - CheckAnnotationPosition - - CheckAnnotationSpan - - CheckAnnotation - - CheckAnnotationConnection.nodes - - CheckAnnotationData - - CheckAnnotationEdge.node - - CheckAnnotationLevel - - CheckConclusionState - - CheckStatusState - - CheckSuiteAutoTriggerPreference - - CheckRun - - CheckRunConnection.nodes - - CheckRunEdge.node - - CheckRunAction - - CheckRunFilter - - CheckRunOutput - - CheckRunOutputImage - - CheckRunType - - CheckSuite - - CheckSuiteConnection.nodes - - CheckSuiteEdge.node - - CheckSuiteFilter - - CreateCheckRunInput - - CreateCheckRunPayload - - CreateCheckSuiteInput - - CreateCheckSuitePayload - - Commit.checkSuites - - Mutation.createCheckRun - - Mutation.createCheckSuite - - Mutation.rerequestCheckSuite - - Mutation.updateCheckRun - - Mutation.updateCheckSuitePreferences - - Push - - RequestableCheckStatusState - - RerequestCheckSuiteInput - - RerequestCheckSuitePayload - - UpdateCheckRunInput - - UpdateCheckRunPayload - - UpdateCheckSuitePayload.checkSuite - - UpdateCheckSuitePreferencesInput - - UpdateCheckSuitePreferencesPayload - owning_teams: - - '@github/ce-extensibility' - title: >- MergeInfoPreview - Mais informações detalhadas sobre o estado de merge de uma pull request. diff --git a/translations/pt-BR/data/graphql/graphql_upcoming_changes.public.yml b/translations/pt-BR/data/graphql/graphql_upcoming_changes.public.yml index d28d5f836bf2..50841464c9ac 100644 --- a/translations/pt-BR/data/graphql/graphql_upcoming_changes.public.yml +++ b/translations/pt-BR/data/graphql/graphql_upcoming_changes.public.yml @@ -37,8 +37,8 @@ upcoming_changes: owner: tambling - location: Query.sponsorsListing - description: "`sponsorsListing` will be removed. Use `Sponsorable.sponsorsListing` instead." - reason: "`Query.sponsorsListing` will be removed." + description: "`sponsorsListing` será removido. `Sponsorable.sponsorsListing`." + reason: "`Query.sponsorsListing` será removido." date: 'RegistryPackageDependency.dependencyType' criticality: breaking owner: antn @@ -51,8 +51,8 @@ upcoming_changes: owner: antn - location: EnterprisePendingMemberInvitationEdge.isUnlicensed - description: "`isUnlicensed` will be removed." - reason: All pending members consume a license + description: "`isUnlicensed` será removido." + reason: Todos os integrantes pendentes consomem uma licença date: '2020-07-01T00:00:00+00:00' criticality: breaking owner: BrentWheeldon @@ -114,29 +114,29 @@ upcoming_changes: owner: oneill38 - location: EnterpriseMemberEdge.isUnlicensed - description: "`isUnlicensed` will be removed." - reason: All members consume a license + description: "`isUnlicensed` será removido." + reason: Todos os integrantes consomem uma licença date: '2021-01-01T00:00:00+00:00' criticality: breaking owner: BrentWheeldon - location: EnterpriseOutsideCollaboratorEdge.isUnlicensed - description: "`isUnlicensed` will be removed." - reason: All outside collaborators consume a license + description: "`isUnlicensed` será removido." + reason: Todos os colaboradores externos consomem uma licença date: '2021-01-01T00:00:00+00:00' criticality: breaking owner: BrentWheeldon - location: EnterprisePendingCollaboratorEdge.isUnlicensed - description: "`isUnlicensed` will be removed." - reason: All pending collaborators consume a license + description: "`isUnlicensed` será removido." + reason: Todos os colaboradores pendentes consomem uma licença date: '2021-01-01T00:00:00+00:00' criticality: breaking owner: BrentWheeldon - location: MergeStateStatus.DRAFT - description: "`DRAFT` will be removed. Use PullRequest.isDraft instead." - reason: DRAFT state will be removed from this enum and `isDraft` should be used instead + description: "O `DRAFT` será removido. Use PullRequest.isDraft." + reason: O status DRAFT será removido deste enum e o `isDraft` deverá ser usado date: '2021-01-01T00:00:00+00:00' criticality: breaking owner: nplasterer diff --git a/translations/pt-BR/data/products.yml b/translations/pt-BR/data/products.yml index f1bebfd2c2ba..3757cfc57b95 100644 --- a/translations/pt-BR/data/products.yml +++ b/translations/pt-BR/data/products.yml @@ -4,7 +4,7 @@ #note this file should not be translated productsInOrder: - github - - enterpriseServer + - administrador - ações - pacotes - developers @@ -12,12 +12,3 @@ productsInOrder: - graphql - insights - desktop -#TODO this can be removed when the new versioning handling is in place -hasEnterpriseUserVersions: - - github - - ações - - developers - - rest - - graphql - - insights - - pacotes diff --git a/translations/pt-BR/data/reusables/actions/about-artifact-log-retention.md b/translations/pt-BR/data/reusables/actions/about-artifact-log-retention.md new file mode 100644 index 000000000000..681b85bb865f --- /dev/null +++ b/translations/pt-BR/data/reusables/actions/about-artifact-log-retention.md @@ -0,0 +1,6 @@ +Por padrão, os artefatos e arquivos de registro gerados pelos fluxos de trabalho são mantidos por 90 dias antes de ser excluídos automaticamente. É possível ajustar o período de retenção dependendo do tipo de repositório: + +- Para repositórios públicos: você pode alterar este período de retenção para qualquer lugar entre 1 dia e 90 dias. +- Para repositórios privados, internos e {% data variables.product.prodname_enterprise %}: você pode alterar este período de retenção para qualquer período entre 1 e 400 dias. + +Ao personalizar o período de retenção, ele só se aplica a novos artefatos e arquivos de registro e não se aplica retroativamente aos objetos existentes. Para repositórios e organizações gerenciadas, o período máximo de retenção não pode exceder o limite definido pela organização gerenciadora ou pela empresa. diff --git a/translations/pt-BR/data/reusables/actions/about-artifacts.md b/translations/pt-BR/data/reusables/actions/about-artifacts.md index 79dcc334f0a4..cf6f8441e436 100644 --- a/translations/pt-BR/data/reusables/actions/about-artifacts.md +++ b/translations/pt-BR/data/reusables/actions/about-artifacts.md @@ -1 +1 @@ -Os artefatos permitem compartilhar dados entre tarefas em um fluxo de trabalho e armazenar dados assim que o fluxo de trabalho tiver sido concluído. \ No newline at end of file +Os artefatos permitem compartilhar dados entre tarefas em um fluxo de trabalho e armazenar dados assim que o fluxo de trabalho tiver sido concluído. diff --git a/translations/pt-BR/data/reusables/actions/about-secrets.md b/translations/pt-BR/data/reusables/actions/about-secrets.md index caa9cd595ae5..0479a8bc984e 100644 --- a/translations/pt-BR/data/reusables/actions/about-secrets.md +++ b/translations/pt-BR/data/reusables/actions/about-secrets.md @@ -1 +1 @@ -Os segredos encriptados permitem que você armazene informações confidenciais no seu repositório ou organização. \ No newline at end of file +Os segredos encriptados permitem que você armazene informações confidenciais no seu repositório ou organização. diff --git a/translations/pt-BR/data/reusables/actions/about-self-hosted-runners.md b/translations/pt-BR/data/reusables/actions/about-self-hosted-runners.md index e3ce0c6b8200..a46fe3999259 100644 --- a/translations/pt-BR/data/reusables/actions/about-self-hosted-runners.md +++ b/translations/pt-BR/data/reusables/actions/about-self-hosted-runners.md @@ -1 +1 @@ -Você pode hospedar seus próprios executores e personalizar o ambiente usado para executar trabalhos nos seus fluxos de trabalho do {% data variables.product.prodname_actions %}. \ No newline at end of file +Você pode hospedar seus próprios executores e personalizar o ambiente usado para executar trabalhos nos seus fluxos de trabalho do {% data variables.product.prodname_actions %}. diff --git a/translations/pt-BR/data/reusables/actions/about-workflow-jobs.md b/translations/pt-BR/data/reusables/actions/about-workflow-jobs.md index d710867b6115..e81dd8cd6f0a 100644 --- a/translations/pt-BR/data/reusables/actions/about-workflow-jobs.md +++ b/translations/pt-BR/data/reusables/actions/about-workflow-jobs.md @@ -1 +1 @@ -A tarefa de um fluxo de trabalho é um conjunto de etapas que são realizadas no mesmo executor. \ No newline at end of file +A tarefa de um fluxo de trabalho é um conjunto de etapas que são realizadas no mesmo executor. diff --git a/translations/pt-BR/data/reusables/actions/about-workflow-runs.md b/translations/pt-BR/data/reusables/actions/about-workflow-runs.md index 754f1915e622..02ba5f2d46b8 100644 --- a/translations/pt-BR/data/reusables/actions/about-workflow-runs.md +++ b/translations/pt-BR/data/reusables/actions/about-workflow-runs.md @@ -1 +1 @@ -A execução de um fluxo de trabalho é uma instância do seu fluxo de trabalho que é executado quando ocorre um evento pré-configurado. \ No newline at end of file +A execução de um fluxo de trabalho é uma instância do seu fluxo de trabalho que é executado quando ocorre um evento pré-configurado. diff --git a/translations/pt-BR/data/reusables/actions/about-workflows.md b/translations/pt-BR/data/reusables/actions/about-workflows.md index 6273879f8ce4..6ac6d03489cc 100644 --- a/translations/pt-BR/data/reusables/actions/about-workflows.md +++ b/translations/pt-BR/data/reusables/actions/about-workflows.md @@ -1 +1 @@ -Com os fluxos de trabalho, você pode automatizar o ciclo de vida de desenvolvimento de software usando várias ferramentas e serviços. \ No newline at end of file +Com os fluxos de trabalho, você pode automatizar o ciclo de vida de desenvolvimento de software usando várias ferramentas e serviços. diff --git a/translations/pt-BR/data/reusables/actions/actions-app-actions-permissions-api.md b/translations/pt-BR/data/reusables/actions/actions-app-actions-permissions-api.md index 19acbe98344c..48866b92f5d7 100644 --- a/translations/pt-BR/data/reusables/actions/actions-app-actions-permissions-api.md +++ b/translations/pt-BR/data/reusables/actions/actions-app-actions-permissions-api.md @@ -1 +1 @@ -{% data variables.product.prodname_github_app %}s devem ter permissão da `actions` para usar esta API. \ No newline at end of file +{% data variables.product.prodname_github_app %}s devem ter permissão da `actions` para usar esta API. diff --git a/translations/pt-BR/data/reusables/actions/actions-authentication.md b/translations/pt-BR/data/reusables/actions/actions-authentication.md index aa199eca47da..3ec2f24bf024 100644 --- a/translations/pt-BR/data/reusables/actions/actions-authentication.md +++ b/translations/pt-BR/data/reusables/actions/actions-authentication.md @@ -1 +1 @@ -Esta API está disponível para usuários autenticados, {% data variables.product.prodname_oauth_app %}s, and {% data variables.product.prodname_github_app %}s. Os tokens de acesso requerem [`repo` scope](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes) para repositórios privados e [`public_repo` scope](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes) para repositórios públicos. \ No newline at end of file +Esta API está disponível para usuários autenticados, {% data variables.product.prodname_oauth_app %}s, and {% data variables.product.prodname_github_app %}s. Os tokens de acesso requerem [`repo` scope](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes) para repositórios privados e [`public_repo` scope](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes) para repositórios públicos. diff --git a/translations/pt-BR/data/reusables/actions/actions-not-verified.md b/translations/pt-BR/data/reusables/actions/actions-not-verified.md index dbdfcc129844..7e12068cc33c 100644 --- a/translations/pt-BR/data/reusables/actions/actions-not-verified.md +++ b/translations/pt-BR/data/reusables/actions/actions-not-verified.md @@ -1 +1 @@ -Qualquer pessoa pode publicar uma ação em {% data variables.product.prodname_marketplace %} desde que cumpram os termos de serviço. Ao contrário dos aplicativos, {% data variables.product.prodname_actions %} listados em {% data variables.product.prodname_marketplace %} não são verificados por {% data variables.product.prodname_dotcom %}. \ No newline at end of file +Qualquer pessoa pode publicar uma ação em {% data variables.product.prodname_marketplace %} desde que cumpram os termos de serviço. Ao contrário dos aplicativos, {% data variables.product.prodname_actions %} listados em {% data variables.product.prodname_marketplace %} não são verificados por {% data variables.product.prodname_dotcom %}. diff --git a/translations/pt-BR/data/reusables/actions/actions-use-policy-settings.md b/translations/pt-BR/data/reusables/actions/actions-use-policy-settings.md new file mode 100644 index 000000000000..0ea1d4a853af --- /dev/null +++ b/translations/pt-BR/data/reusables/actions/actions-use-policy-settings.md @@ -0,0 +1,3 @@ +Se você escolher a opção **Permitir ações específicas**, há opções adicionais que você pode configurar. Para obter mais informações, consulte "[Permitir que ações específicas sejam executadas](#allowing-specific-actions-to-run)". + +Ao permitir apenas ações locais, a política bloqueia todos os acessos a ações criadas por {% data variables.product.prodname_dotcom %}. Por exemplo, as [`ações/check-out`](https://github.com/actions/checkout) não poderiam ser acessadas. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/actions/allow-specific-actions-intro.md b/translations/pt-BR/data/reusables/actions/allow-specific-actions-intro.md new file mode 100644 index 000000000000..6dcebcf91471 --- /dev/null +++ b/translations/pt-BR/data/reusables/actions/allow-specific-actions-intro.md @@ -0,0 +1,19 @@ +Ao selecionar a **Permitir selecionar ações**, há opções adicionais que você precisa escolher para configurar as ações permitidas: + +- **Permitir ações criadas por {% data variables.product.prodname_dotcom %}:** Você pode permitir que todas as ações criadas por {% data variables.product.prodname_dotcom %} sejam usadas por fluxos de trabalho. As ações criadas por {% data variables.product.prodname_dotcom %} estão localizadas nas `ações` e nas organizações do `github`. Para obter mais informações, consulte as [`ações`](https://github.com/actions) e as organizações do [`github`](https://github.com/github). +- **Permitir ações do Marketplace por criadores verificados:** Você pode permitir que todas as ações de {% data variables.product.prodname_marketplace %} criadas por criadores verificados sejam usadas por fluxos de trabalho. Quando o GitHub verificou o criador da ação como uma organização parceira, o selo de {% octicon "verified" aria-label="The verified badge" %} é exibido ao lado da ação em {% data variables.product.prodname_marketplace %}. +- **Permitir ações específicas:** Você pode restringir fluxos de trabalho para usar ações em organizações específicas e em repositórios. + + Para restringir o acesso a tags específicas ou commit SHAs de uma ação, use a mesma sintaxe `/@` usada no fluxo de trabalho para selecionar a ação. Por exemplo, `actions/javascript-action@v1.0.1` para selecionar uma tag ou `actions/javascript-action@172239021f7ba04fe7327647b213799853a9eb89` para selecionar um SHA. Para obter mais informações, consulte "[Localizar e personalizar ações](/actions/learn-github-actions/finding-and-customizing-actions#using-release-management-for-your-custom-actions)". + + Você pode usar o caractere `*` curinga para corresponder aos padrões. Por exemplo, para permitir todas as ações em organizações que começam com o `space-org`, você pode especificar `space-org*/*`. Para adicionar todas as ações aos repositórios que iniciam com octocat, você pode usar `*/octocat*@*`. Para obter mais informações sobre o uso do curinga `*`, consulte "[sintaxe de fluxo de trabalho para o GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#filter-pattern-cheat-sheet). + + {% if currentVersion == "free-pro-team@latest" %} + {% note %} + + **Observação:** A opção **Permitir ações específicas** só está disponível em repositórios públicos com o {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} para organizações ou plano de {% data variables.product.prodname_team %}. + + {% endnote %} + {% endif %} + +Este procedimento demonstra como adicionar ações específicas à lista de autorizações. diff --git a/translations/pt-BR/data/reusables/actions/enterprise-actions-permissions.md b/translations/pt-BR/data/reusables/actions/enterprise-actions-permissions.md index f2572368220f..fecdc8ac9ced 100644 --- a/translations/pt-BR/data/reusables/actions/enterprise-actions-permissions.md +++ b/translations/pt-BR/data/reusables/actions/enterprise-actions-permissions.md @@ -1 +1 @@ -1. Em "Políticas", selecione uma opção. ![Habilita, desabilita ou limita ações para esta conta corporativa](/assets/images/help/settings/actions-enable-enterprise-account.png) \ No newline at end of file +1. Em "Políticas", selecione uma opção. ![Habilita, desabilita ou limita ações para esta conta corporativa](/assets/images/help/organizations/enterprise-actions-policy.png) diff --git a/translations/pt-BR/data/reusables/actions/enterprise-beta.md b/translations/pt-BR/data/reusables/actions/enterprise-beta.md index 2fc5bfdbffca..34984da35078 100644 --- a/translations/pt-BR/data/reusables/actions/enterprise-beta.md +++ b/translations/pt-BR/data/reusables/actions/enterprise-beta.md @@ -1,7 +1,7 @@ {% if currentVersion != "free-pro-team@latest" and currentVersion == "enterprise-server@2.22" %} {% note %} -**Observação:** O suporte de {% data variables.product.prodname_actions %} em {% data variables.product.prodname_ghe_server %} 2.22 é beta pública limitada. To review the external storage requirements and request access to the beta, see "[Enabling {% data variables.product.prodname_actions %} and configuring storage](/enterprise/admin/github-actions/enabling-github-actions-and-configuring-storage)." +**Observação:** O suporte de {% data variables.product.prodname_actions %} em {% data variables.product.prodname_ghe_server %} 2.22 é beta pública limitada. Para revisar os requisitos de armazenamento externo e solicitar acesso ao beta, consulte "[Habilitar {% data variables.product.prodname_actions %} e configurar o armazenamento](/enterprise/admin/github-actions/enabling-github-actions-and-configuring-storage)". {% endnote %} -{% endif %} \ No newline at end of file +{% endif %} diff --git a/translations/pt-BR/data/reusables/actions/enterprise-github-hosted-runners.md b/translations/pt-BR/data/reusables/actions/enterprise-github-hosted-runners.md index 1ef3c4ce19a6..798a8e1d86f1 100644 --- a/translations/pt-BR/data/reusables/actions/enterprise-github-hosted-runners.md +++ b/translations/pt-BR/data/reusables/actions/enterprise-github-hosted-runners.md @@ -1,7 +1,7 @@ {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %} {% note %} -**Note:** {% data variables.product.prodname_dotcom %}-hosted runners are not currently supported on {% data variables.product.prodname_ghe_server %}. You can see more information about planned future support on the [{% data variables.product.prodname_roadmap %}](https://github.com/github/roadmap/issues/72). +**Observação:** Executores hospedados em {% data variables.product.prodname_dotcom %} não são atualmente compatíveis com {% data variables.product.prodname_ghe_server %}. Você pode ver mais informações sobre suporte futuro planejado no [{% data variables.product.prodname_roadmap %}](https://github.com/github/roadmap/issues/72). {% endnote %} -{% endif %} \ No newline at end of file +{% endif %} diff --git a/translations/pt-BR/data/reusables/actions/enterprise-marketplace-actions.md b/translations/pt-BR/data/reusables/actions/enterprise-marketplace-actions.md index d937e2aeb07a..5ef7d584b791 100644 --- a/translations/pt-BR/data/reusables/actions/enterprise-marketplace-actions.md +++ b/translations/pt-BR/data/reusables/actions/enterprise-marketplace-actions.md @@ -2,7 +2,7 @@ {% note %} -**Note:** {% data variables.product.prodname_actions %} on {% data variables.product.product_location %} may have limited access to actions on {% data variables.product.prodname_dotcom_the_website %} or {% data variables.product.prodname_marketplace %}. Para obter mais informações, consulte "[Comunicação entre os executores auto-hospedados e {% data variables.product.prodname_dotcom %}](#communication-between-self-hosted-runners-and-github)". +**Observação:** {% data variables.product.prodname_actions %} em {% data variables.product.product_location %} pode ter acesso limitado a ações em {% data variables.product.prodname_dotcom_the_website %} ou {% data variables.product.prodname_marketplace %}. Para obter mais informações, consulte "[Comunicação entre os executores auto-hospedados e {% data variables.product.prodname_dotcom %}](#communication-between-self-hosted-runners-and-github)". {% endnote %} diff --git a/translations/pt-BR/data/reusables/actions/enterprise-no-internet-actions.md b/translations/pt-BR/data/reusables/actions/enterprise-no-internet-actions.md index 9f2287cfee01..4fa97816b0b7 100644 --- a/translations/pt-BR/data/reusables/actions/enterprise-no-internet-actions.md +++ b/translations/pt-BR/data/reusables/actions/enterprise-no-internet-actions.md @@ -1 +1 @@ -{% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} is designed to work in environments without internet access. By default, workflows cannot use actions from {% data variables.product.prodname_dotcom_the_website %} and [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=actions). +O {% data variables.product.prodname_actions %} em {% data variables.product.prodname_ghe_server %} é projetado para funcionar em ambientes sem acesso à Internet. Por padrão, os fluxos de trabalho não podem usar ações de {% data variables.product.prodname_dotcom_the_website %} e [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=actions). diff --git a/translations/pt-BR/data/reusables/actions/enterprise-setup-prereq.md b/translations/pt-BR/data/reusables/actions/enterprise-setup-prereq.md index 39ccd7277eab..d17d43a29f46 100644 --- a/translations/pt-BR/data/reusables/actions/enterprise-setup-prereq.md +++ b/translations/pt-BR/data/reusables/actions/enterprise-setup-prereq.md @@ -1,7 +1,7 @@ {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %} -#### Using self-hosted runners on {% data variables.product.prodname_ghe_server %} +#### Usar executores auto-hospedados no {% data variables.product.prodname_ghe_server %} -When using setup actions (such as `actions/setup-LANGUAGE`) on {% data variables.product.prodname_ghe_server %} with self-hosted runners, you might need to set up the tools cache on runners that do not have internet access. Para obter mais informações, consulte "[Configurar o cache da ferramenta em executores auto-hospedados sem acesso à internet](/enterprise/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access)". +Ao usar ações de configuração (como `actions/setup-LANGUAGE`) em {% data variables.product.prodname_ghe_server %} com executores auto-hospedados, você pode precisar configurar o armazenamento de ferramentas em executores que não possuem acesso à internet. Para obter mais informações, consulte "[Configurar o cache da ferramenta em executores auto-hospedados sem acesso à internet](/enterprise/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access)". {% endif %} diff --git a/translations/pt-BR/data/reusables/actions/registry-credentials.md b/translations/pt-BR/data/reusables/actions/registry-credentials.md new file mode 100644 index 000000000000..1fdac0804d5e --- /dev/null +++ b/translations/pt-BR/data/reusables/actions/registry-credentials.md @@ -0,0 +1 @@ +Se o container registry da imagem exigir autenticação para fazer pull da imagem, você pode usar as `credenciais` para definir um `mapa` do `nome de usuário` e `senha`. As credenciais são os mesmos valores que você forneceria para o comando [`login do docker`](https://docs.docker.com/engine/reference/commandline/login/). diff --git a/translations/pt-BR/data/reusables/actions/scheduled-workflows-disabled.md b/translations/pt-BR/data/reusables/actions/scheduled-workflows-disabled.md new file mode 100644 index 000000000000..a8dfd5ae54ea --- /dev/null +++ b/translations/pt-BR/data/reusables/actions/scheduled-workflows-disabled.md @@ -0,0 +1 @@ +Para evitar execuções desnecessárias do fluxo de trabalho, os fluxos de trabalho programados podem ser desabilitados automaticamente. Quando um repositório público é bifurcado, os fluxos de trabalho programados são desabilitados por padrão. Em um repositório público, os fluxos de trabalho agendados são automaticamente desabilitados quando nenhuma atividade do repositório ocorreu em 60 dias. diff --git a/translations/pt-BR/data/reusables/apps/beta_feature_activation.md b/translations/pt-BR/data/reusables/apps/beta_feature_activation.md index 14e2456ccc70..419c22fefa8d 100644 --- a/translations/pt-BR/data/reusables/apps/beta_feature_activation.md +++ b/translations/pt-BR/data/reusables/apps/beta_feature_activation.md @@ -1,2 +1,2 @@ -4. Na barra lateral esquerda, clique em **Recursos do Beta**. ![GitHub Apps or OAuth Apps section](/assets/images/github-apps/beta-features-option.png) -5. Next to the beta feature you want to enable for your app, click **Opt-in**. ![Opt-in button to enable a beta feature](/assets/images/github-apps/enable-beta-features.png) +4. Na barra lateral esquerda, clique em **Recursos do Beta**. ![Seção de aplicativos GitHub ou seção de aplicativos OAuth](/assets/images/github-apps/beta-features-option.png) +5. Ao lado do recurso beta que você deseja habilitar para o seu aplicativo, clique em **Participar**. ![Botão de optar por participar para habilitar um recurso beta](/assets/images/github-apps/enable-beta-features.png) diff --git a/translations/pt-BR/data/reusables/apps/deprecating_auth_with_query_parameters.md b/translations/pt-BR/data/reusables/apps/deprecating_auth_with_query_parameters.md index 5e92b95a7474..06df84b48c4d 100644 --- a/translations/pt-BR/data/reusables/apps/deprecating_auth_with_query_parameters.md +++ b/translations/pt-BR/data/reusables/apps/deprecating_auth_with_query_parameters.md @@ -1,9 +1,9 @@ {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} {% warning %} -**Aviso de método obsoleto:** {% data variables.product.prodname_dotcom %} irá descontinuar a autenticação para a API usando parâmetros de consulta. A autenticação na API deve ser feita com [HTTP basic authentication](/v3/auth/#via-oauth-and-personal-access-tokens).{% if currentVersion == "free-pro-team@latest" %} Usar parâmetros de consulta para autenticar na API não funcionará mais em 5 de maio de 2021. {% endif %} Para mais informações, incluindo brownouts agendadas, veja [blog post](https://developer.github.com/changes/2020-02-10-deprecating-auth-through-query-param/). +**Aviso de método obsoleto:** {% data variables.product.prodname_dotcom %} irá descontinuar a autenticação para a API usando parâmetros de consulta. A autenticação para a API deve ser feita com a [autenticação básica HTTP](/v3/auth/#via-oauth-and-personal-access-tokens).{% if currentVersion == "free-pro-team@latest" %} Usar parâmetros de consulta para efetuar a autenticação na API não funcionará mais a partir de 5 de maio de 2021. {% endif %} Para mais informações, incluindo brownouts agendadas, veja [blog post](https://developer.github.com/changes/2020-02-10-deprecating-auth-through-query-param/). -{% if currentVersion != "free-pro-team@latest" %} Autenticação à API usando parâmetros de consulta, enquanto disponível não é mais suportada devido a questões de segurança. Em vez disso, recomendamos que integradores movam seu token de acesso, `client_id`, or `client_secret` no cabeçalho. {% data variables.product.prodname_dotcom %} anunciará a remoção da autenticação por parâmetros de consulta com aviso prévio. {% endif %} +{% if currentVersion != "free-pro-team@latest" %} Embora disponível, a autenticação da API usando parâmetros de consulta não é mais compatível devido a questões de segurança. Em vez disso, recomendamos que integradores movam seu token de acesso, `client_id`, or `client_secret` no cabeçalho. {% data variables.product.prodname_dotcom %} anunciará a remoção da autenticação por parâmetros de consulta com aviso prévio. {% endif %} {% endwarning %} {% endif %} diff --git a/translations/pt-BR/data/reusables/apps/deprecating_password_auth.md b/translations/pt-BR/data/reusables/apps/deprecating_password_auth.md index ce677c66494d..9c1c13c503c4 100644 --- a/translations/pt-BR/data/reusables/apps/deprecating_password_auth.md +++ b/translations/pt-BR/data/reusables/apps/deprecating_password_auth.md @@ -1,9 +1,9 @@ {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} {% warning %} -**Aviso de Depreciação:** {% data variables.product.prodname_dotcom %} irá descontinuar a autenticação de senha com a API. Você deve agora autenticar na API {% data variables.product.prodname_dotcom %} com um token de API, como um token de acesso OAuth, token de acesso de instalação do GitHub APP ou token de acesso pessoal, dependendo do que você precisar fazer com o token.{% if currentVersion == "free-pro-team@latest" %} A autenticação da senha para a API, será removida em 13 de Novembro, 2020.{% endif %} Para mais informações,{% if currentVersion == "free-pro-team@latest" %} incluindo brownouts agendados,{% endif %} veja a postagem [blog post](https://developer.github.com/changes/2020-02-14-deprecating-password-auth/). +**Aviso de Depreciação:** {% data variables.product.prodname_dotcom %} irá descontinuar a autenticação de senha com a API. Agora, você deve efetuar a autenticação na API de {% data variables.product.prodname_dotcom %} com um token da API, como, por exemplo, um token de acesso do OAuth, token de acesso de instalação do aplicativo GitHub ou token de acesso pessoal, dependendo do que você precisa fazer com o token.{% if currentVersion == "free-pro-team@latest" %} A autenticação de senha na API será removida em 13 de Novembro de 2020.{% endif %} Para mais informações{% if currentVersion == "free-pro-team@latest" %} incluindo períodos de inatividade agendados,{% endif %} veja o [post no blogue](https://developer.github.com/changes/2020-02-14-deprecating-password-auth/). -{% if currentVersion != "free-pro-team@latest" %} A API de Autorizações OAuth está disponível e ainda não está obsoleta no {% data variables.product.prodname_ghe_server %}. {% data variables.product.prodname_dotcom %} anunciará a depreciação e fornecerá um aviso antecipadamente antes de remover o suporte para este recurso.{% endif %} +{% if currentVersion != "free-pro-team@latest" %} A autenticação na API que usa uma senha está atualmente disponível e ainda não está obsoleta em {% data variables.product.prodname_ghe_server %}. {% data variables.product.prodname_dotcom %} anunciará a depreciação e fornecerá um aviso antecipadamente antes de remover o suporte para este recurso.{% endif %} {% endwarning %} {% endif %} diff --git a/translations/pt-BR/data/reusables/apps/general-apps-restrictions.md b/translations/pt-BR/data/reusables/apps/general-apps-restrictions.md index 32db7be0b423..f33012872d95 100644 --- a/translations/pt-BR/data/reusables/apps/general-apps-restrictions.md +++ b/translations/pt-BR/data/reusables/apps/general-apps-restrictions.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}Se você estiver usando seu aplicativo com o GitHub Actions e deseja modificar os arquivos de fluxo de trabalho, você deve autenticar em nome do usuário com um token OAuth que inclua o escopo `workflow`. O usuário deve ter permissão de administrador ou permissão de gravação no repositório que contém o arquivo do fluxo de trabalho. Para obter mais informações, consulte "[Understanding scopes for OAuth apps](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)."{% endif %} \ No newline at end of file +{% if currentVersion == "free-pro-team@latest" %}Se você estiver usando o seu aplicativo com o GitHub Actions e desejar modificar os arquivos de fluxo de trabalho, você deve efetuar a autenticação em nome do usuário com um token do OAuth que inclui o escopo do `fluxo de trabalho`. O usuário deve ter permissão de administrador ou permissão de gravação no repositório que contém o arquivo do fluxo de trabalho. Para obter mais informações, consulte "[Understanding scopes for OAuth apps](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)."{% endif %} diff --git a/translations/pt-BR/data/reusables/apps/maximum-github-apps-allowed.md b/translations/pt-BR/data/reusables/apps/maximum-github-apps-allowed.md index 6a77b73870ca..2a3d8507e035 100644 --- a/translations/pt-BR/data/reusables/apps/maximum-github-apps-allowed.md +++ b/translations/pt-BR/data/reusables/apps/maximum-github-apps-allowed.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}um usuário ou organização pode ter até 100 aplicativos no GitHub Apps.{% endif %} \ No newline at end of file +{% if currentVersion == "free-pro-team@latest" %}Um usuário ou organização pode ter até 100 aplicativos GitHub.{% endif %} diff --git a/translations/pt-BR/data/reusables/apps/maximum-oauth-apps-allowed.md b/translations/pt-BR/data/reusables/apps/maximum-oauth-apps-allowed.md index 6a77b73870ca..7dc1dfbcd1e5 100644 --- a/translations/pt-BR/data/reusables/apps/maximum-oauth-apps-allowed.md +++ b/translations/pt-BR/data/reusables/apps/maximum-oauth-apps-allowed.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}um usuário ou organização pode ter até 100 aplicativos no GitHub Apps.{% endif %} \ No newline at end of file +{% if currentVersion == "free-pro-team@latest" %}Um usuário ou organização pode ter até 100 aplicativos OAuth.{% endif %} diff --git a/translations/pt-BR/data/reusables/apps/metadata-permissions.md b/translations/pt-BR/data/reusables/apps/metadata-permissions.md index 2a4da95d5353..aec1f6c40cfd 100644 --- a/translations/pt-BR/data/reusables/apps/metadata-permissions.md +++ b/translations/pt-BR/data/reusables/apps/metadata-permissions.md @@ -1 +1 @@ -Se você definir a permissão de metadados para `No access` e selecionar uma permissão que exija acesso ao repositório, GitHub irá substituir sua seleção e definir a permissão de metadados de volta para `Read-only`. Para definir a permissão de metadados para `No access`, você deve definir todas as permissões que requerem acesso ao repositório `No access` primeiro. \ No newline at end of file +Se você definir a permissão de metadados para `No access` e selecionar uma permissão que exija acesso ao repositório, GitHub irá substituir sua seleção e definir a permissão de metadados de volta para `Read-only`. Para definir a permissão de metadados para `No access`, você deve definir todas as permissões que requerem acesso ao repositório `No access` primeiro. diff --git a/translations/pt-BR/data/reusables/apps/oauth-apps-restrictions.md b/translations/pt-BR/data/reusables/apps/oauth-apps-restrictions.md index 544e6b037c4b..1ad70f9b7411 100644 --- a/translations/pt-BR/data/reusables/apps/oauth-apps-restrictions.md +++ b/translations/pt-BR/data/reusables/apps/oauth-apps-restrictions.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}se você estiver usando seu aplicativo OAuth com o GitHub Actions e quiser modificar os arquivos de fluxo de trabalho, seu token OAuth deve ter o escopo `workflow` e o usuário deve ter permissão de proprietário ou de escrita no repositório que contém o arquivo de fluxo de trabalho. Para obter mais informações, consulte "[Understanding scopes for OAuth apps](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)."{% endif %} \ No newline at end of file +{% if currentVersion == "free-pro-team@latest" %}Se você estiver usando o aplicativo OAuth com o GitHub Actions e desejar modificar os arquivos de fluxo de trabalho, seu token do OAuth deverá ter o escopo do fluxo de trabalho e o usuário deverá ter permissão de gravação ou de proprietário no repositório que contém o arquivo do fluxo de trabalho. Para obter mais informações, consulte "Understanding scopes for OAuth apps."{% endif %}

    diff --git a/translations/pt-BR/data/reusables/apps/state_description.md b/translations/pt-BR/data/reusables/apps/state_description.md index 854a8141dac7..ef470cd6a55e 100644 --- a/translations/pt-BR/data/reusables/apps/state_description.md +++ b/translations/pt-BR/data/reusables/apps/state_description.md @@ -1 +1 @@ -Uma string aleatória indescritível. É usado para proteger contra ataques de falsificação de pedidos entre sites. \ No newline at end of file +Uma string aleatória indescritível. É usado para proteger contra ataques de falsificação de pedidos entre sites. diff --git a/translations/pt-BR/data/reusables/audit_log/audit-log-search.md b/translations/pt-BR/data/reusables/audit_log/audit-log-search.md index 8b83014d3513..deab99b88629 100644 --- a/translations/pt-BR/data/reusables/audit_log/audit-log-search.md +++ b/translations/pt-BR/data/reusables/audit_log/audit-log-search.md @@ -8,7 +8,6 @@ O log lista as seguintes informações sobre cada ação: Observe que não é possível pesquisar as entradas usando texto. No entanto, é possível criar consultas de pesquisa usando diversos filtros. Muitos operadores usados ao consultar o log de auditoria, como `-`, `>`, ou `<`, correspondem ao mesmo formato de pesquisa no {% data variables.product.product_name %}. Para obter mais informações, consulte "[Searching on {% data variables.product.prodname_dotcom %}](/github/searching-for-information-on-github/about-searching-on-github)." -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} #### Pesquisar com base em operação Use o qualificador `operation` para limitar ações a tipos específicos de operações. Por exemplo: @@ -20,7 +19,6 @@ Use o qualificador `operation` para limitar ações a tipos específicos de oper * `operation:remove` encontra todos os eventos nos quais um recurso foi removido. * `operation:restore` encontra todos os eventos nos quais um recurso foi restaurado. * `operation:transfer` encontra todos os eventos nos quais um recurso foi transferido. -{% endif %} #### Pesquisar com base no repositório diff --git a/translations/pt-BR/data/reusables/branches/change-default-branch.md b/translations/pt-BR/data/reusables/branches/change-default-branch.md new file mode 100644 index 000000000000..997b3ee4f5ab --- /dev/null +++ b/translations/pt-BR/data/reusables/branches/change-default-branch.md @@ -0,0 +1 @@ +É possível alterar o branch-padrão para um repositório existente. For more information, see "[Setting the default branch](/github/administering-a-repository/setting-the-default-branch)." diff --git a/translations/pt-BR/data/reusables/branches/default-branch-automatically-base-branch.md b/translations/pt-BR/data/reusables/branches/default-branch-automatically-base-branch.md index 9350f601c269..a6d203918762 100644 --- a/translations/pt-BR/data/reusables/branches/default-branch-automatically-base-branch.md +++ b/translations/pt-BR/data/reusables/branches/default-branch-automatically-base-branch.md @@ -1 +1,2 @@ -The default branch is the base branch in your repository, against which all pull requests and code commits are automatically made, unless you specify a different branch. \ No newline at end of file +A menos que você especifique um branch diferente, o branch-padrão em um repositório é o branch de base para novos pull requests e commits de código. + diff --git a/translations/pt-BR/data/reusables/branches/new-repo-default-branch.md b/translations/pt-BR/data/reusables/branches/new-repo-default-branch.md index 99628077f836..61bd505f3229 100644 --- a/translations/pt-BR/data/reusables/branches/new-repo-default-branch.md +++ b/translations/pt-BR/data/reusables/branches/new-repo-default-branch.md @@ -1 +1,2 @@ -When you create a repository on {% data variables.product.prodname_dotcom %} with content, the repository is initialized with a single branch, called the default branch. \ No newline at end of file +Ao criar um repositório com conteúdo em {% data variables.product.product_location %}, {% data variables.product.product_name %} cria o repositório com um único branch. Este primeiro branch no repositório é o branch-padrão. + diff --git a/translations/pt-BR/data/reusables/branches/set-default-branch.md b/translations/pt-BR/data/reusables/branches/set-default-branch.md index a36fcc41b762..f85f3b7dba69 100644 --- a/translations/pt-BR/data/reusables/branches/set-default-branch.md +++ b/translations/pt-BR/data/reusables/branches/set-default-branch.md @@ -1 +1 @@ -If you have admin permissions to a repository, you can change the default branch to another existing branch. For more information, see "[Setting the default branch](/github/administering-a-repository/setting-the-default-branch)." +Você pode definir o nome do branch-padrão para novos repositórios. Para obter mais informações, consulte "[Gerenciar o branch-padrão para seus repositórios](/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories), "[Gerenciar o nome do branch-padrão para repositórios na sua organização](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization), ou "[Aplicar uma política com o nome do branch-padrão](/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account#enforcing-a-policy-on-the-default-branch-name) diff --git a/translations/pt-BR/data/reusables/cli/filter-issues-and-pull-requests-tip.md b/translations/pt-BR/data/reusables/cli/filter-issues-and-pull-requests-tip.md index 949b7938dbd4..ecec29ab3e02 100644 --- a/translations/pt-BR/data/reusables/cli/filter-issues-and-pull-requests-tip.md +++ b/translations/pt-BR/data/reusables/cli/filter-issues-and-pull-requests-tip.md @@ -1,7 +1,7 @@ {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} {% tip %} -**Tip**: You can also filter issues or pull requests using the {% data variables.product.prodname_cli %}. For more information, see "[`gh issue list`](https://cli.github.com/manual/gh_issue_list)" or "[`gh pr list`](https://cli.github.com/manual/gh_pr_list)" in the {% data variables.product.prodname_cli %} documentation. +**Dica**: Também é possível filtrar problemas ou pull requests usando o {% data variables.product.prodname_cli %}. Para mais informações, consulte a "[`lista de problemas do gh`](https://cli.github.com/manual/gh_issue_list)" ou "[`lista pr do gh`](https://cli.github.com/manual/gh_pr_list)" na documentação de {% data variables.product.prodname_cli %}. {% endtip %} {% endif %} diff --git a/translations/pt-BR/data/reusables/code-scanning/analyze-go.md b/translations/pt-BR/data/reusables/code-scanning/analyze-go.md new file mode 100644 index 000000000000..aae513d5e433 --- /dev/null +++ b/translations/pt-BR/data/reusables/code-scanning/analyze-go.md @@ -0,0 +1 @@ +{% data variables.product.prodname_codeql %} também executa uma criação para projetos Go para configurar o projeto. Entretanto, diferente das outras linguagens compiladas, todos os Go no repositório são extraídos, não apenas aqueles construídos. Comandos de compilação personalizados não são compatíveis com o Go. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/code-scanning/autobuild-add-build-steps.md b/translations/pt-BR/data/reusables/code-scanning/autobuild-add-build-steps.md index 61f06aaba9d0..ef818c4b05fa 100644 --- a/translations/pt-BR/data/reusables/code-scanning/autobuild-add-build-steps.md +++ b/translations/pt-BR/data/reusables/code-scanning/autobuild-add-build-steps.md @@ -1 +1 @@ -If the C/C++, C#, or Java code in your repository has a non-standard build process or if it's written in more than one compiled language, `autobuild` may fail. You will need to remove the `autobuild` step from the workflow, and manually add build steps. +Se o código de C/C++, C#, ou Java no seu repositório tiver um processo de criação não padrão, poderá ocorrer uma falha no `autobuild`. Você deverá remover a etapa `autobuild` do fluxo de trabalho e adicionar manualmente etapas de criação. diff --git a/translations/pt-BR/data/reusables/code-scanning/autobuild-compiled-languages.md b/translations/pt-BR/data/reusables/code-scanning/autobuild-compiled-languages.md index 799aeca4b84a..a4269840ac82 100644 --- a/translations/pt-BR/data/reusables/code-scanning/autobuild-compiled-languages.md +++ b/translations/pt-BR/data/reusables/code-scanning/autobuild-compiled-languages.md @@ -1,5 +1 @@ -For compiled languages like C/C++, C#, and Java, the `autobuild` step in the default workflow attempts to build code before the action performs {% data variables.product.prodname_codeql %} analysis. Ao contrário das outras linguagens compiladas, {% data variables.product.prodname_codeql %} analisa Go sem criar o código. - -O processo `autobuild` sempre tenta criar _uma_ linguagem compilada para um repositório. The language automatically selected for analysis is the language with most files. - - +Para as linguagens compiladas compatíveis, você pode usar a ação `autobuild` no {% data variables.product.prodname_codeql_workflow %} para criar o seu código. Isso evita que você tenha que especificar comandos de criação explícitos para C/C++, C#, e Java. diff --git a/translations/pt-BR/data/reusables/code-scanning/beta-codeql-runner.md b/translations/pt-BR/data/reusables/code-scanning/beta-codeql-runner.md new file mode 100644 index 000000000000..f15db9492222 --- /dev/null +++ b/translations/pt-BR/data/reusables/code-scanning/beta-codeql-runner.md @@ -0,0 +1,9 @@ +{% if currentVersion == "free-pro-team@latest" %} + +{% note %} + +**Observação:** Os {% data variables.product.prodname_codeql_runner %} está atualmente em fase beta e sujeito a alterações. + +{% endnote %} + +{% endif %} diff --git a/translations/pt-BR/data/reusables/code-scanning/beta.md b/translations/pt-BR/data/reusables/code-scanning/beta.md index 1f6b33ed58f8..4ba1ffac10d3 100644 --- a/translations/pt-BR/data/reusables/code-scanning/beta.md +++ b/translations/pt-BR/data/reusables/code-scanning/beta.md @@ -1,5 +1,9 @@ +{% if currentVersion == "enterprise-server@2.22" %} + {% note %} -**Nota:** {% data variables.product.prodname_code_scanning_capc %} está atualmente em versão beta e sujeito a alterações. {% if currentVersion == "free-pro-team@latest" %}To request access to the beta, [join the waitlist](https://github.com/features/security/advanced-security/signup).{% else %}If your organization has an {% data variables.product.prodname_advanced_security %} license, you can [join the beta program](https://resources.github.com/beta-signup/).{% endif %} +**Nota:** {% data variables.product.prodname_code_scanning_capc %} está atualmente em versão beta e sujeito a alterações. Para obter mais informações sobre a participação no beta, [inscreva-se aqui](https://resources.github.com/beta-signup/). {% endnote %} + +{% endif %} diff --git a/translations/pt-BR/data/reusables/code-scanning/click-alert-in-list.md b/translations/pt-BR/data/reusables/code-scanning/click-alert-in-list.md index 77043712156f..9b7d49682ea2 100644 --- a/translations/pt-BR/data/reusables/code-scanning/click-alert-in-list.md +++ b/translations/pt-BR/data/reusables/code-scanning/click-alert-in-list.md @@ -1 +1 @@ -1. Em "Code scanning", clique no alerta que desejar visualizar. ![Lista de alertas de {% data variables.product.prodname_code_scanning %}](/assets/images/help/repository/code-scanning-click-alert.png) +1. Em "Varredura do código, clique no alerta que você deseja explorar. ![Lista de alertas de {% data variables.product.prodname_code_scanning %}](/assets/images/help/repository/code-scanning-click-alert.png) diff --git a/translations/pt-BR/data/reusables/code-scanning/close-alert-examples.md b/translations/pt-BR/data/reusables/code-scanning/close-alert-examples.md new file mode 100644 index 000000000000..be4134e3a0bc --- /dev/null +++ b/translations/pt-BR/data/reusables/code-scanning/close-alert-examples.md @@ -0,0 +1 @@ +Por exemplo, um erro no código que é usado apenas para testes ou quando o esforço de corrigir o erro é maior do que o benefício potencial de melhorar o código. diff --git a/translations/pt-BR/data/reusables/code-scanning/codeql-query-suites.md b/translations/pt-BR/data/reusables/code-scanning/codeql-query-suites.md index ae3d1bd38398..808bd21d739c 100644 --- a/translations/pt-BR/data/reusables/code-scanning/codeql-query-suites.md +++ b/translations/pt-BR/data/reusables/code-scanning/codeql-query-suites.md @@ -1,8 +1,8 @@ -The following query suites are built into {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} and are available for use. +Os conjuntos de consulta a seguir foram criados em {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} e estão disponíveis para uso. | Suite de consulta | Descrição | |:---------------------- |:------------------------------------------------------------------------------- | | `security-extended` | Consultas de menor gravidade e precisão que as consultas-padrão | | `security-and-quality` | Consultas de `security-extended`, mais consultas de manutenção e confiabilidade | -When you specify a query suite, the {% data variables.product.prodname_codeql %} analysis engine will run the queries contained within the suite for you, in addition to the default set of queries. +Ao especificar um conjunto de pesquisas, o mecanismo de análise de {% data variables.product.prodname_codeql %} executará as consultas contidas no conjunto para você além do conjunto-padrão de consultas. diff --git a/translations/pt-BR/data/reusables/code-scanning/codeql-runner-license.md b/translations/pt-BR/data/reusables/code-scanning/codeql-runner-license.md index 17283fb710b2..306a25f40dc2 100644 --- a/translations/pt-BR/data/reusables/code-scanning/codeql-runner-license.md +++ b/translations/pt-BR/data/reusables/code-scanning/codeql-runner-license.md @@ -1,10 +1,12 @@ {% note %} {% if currentVersion == "free-pro-team@latest" %} -**Note:** The {% data variables.product.prodname_codeql_runner %} uses the {% data variables.product.prodname_codeql %} CLI to analyze code and therefore has the same license conditions. It's free to use on public repositories that are maintained on {% data variables.product.prodname_dotcom_the_website %}, and available to use on private repositories that are owned by customers with an {% data variables.product.prodname_advanced_security %} license. For information, see "[{% data variables.product.product_name %} {% data variables.product.prodname_codeql %} Terms and Conditions](https://securitylab.github.com/tools/codeql/license)" and "[{% data variables.product.prodname_codeql %} CLI](https://help.semmle.com/codeql/codeql-cli.html)." +**Observação:** O +{% data variables.product.prodname_codeql_runner %} usa a CLI de {% data variables.product.prodname_codeql %} para analisar o código e, portanto, tem as mesmas condições da licença. É grátis usar em repositórios públicos que são mantidos no {% data variables.product.prodname_dotcom_the_website %}, e disponíveis para uso em repositórios privados que são propriedade de clientes com uma licença do {% data variables.product.prodname_advanced_security %}. Para obter informações, consulte "[{% data variables.product.product_name %} Termos e Condições](https://securitylab.github.com/tools/codeql/license) de do CLI de {% data variables.product.prodname_codeql %} " e "[{% data variables.product.prodname_codeql %}](https://help.semmle.com/codeql/codeql-cli.html)". {% else %} -**Note:** The {% data variables.product.prodname_codeql_runner %} is available to customers with an {% data variables.product.prodname_advanced_security %} license. +**Observação:** O +{% data variables.product.prodname_codeql_runner %} está disponível para os clientes com uma licença de {% data variables.product.prodname_advanced_security %}. {% endif %} -{% endnote %} \ No newline at end of file +{% endnote %} diff --git a/translations/pt-BR/data/reusables/code-scanning/edit-workflow.md b/translations/pt-BR/data/reusables/code-scanning/edit-workflow.md index 30bccff2efa3..b0d09ff3084e 100644 --- a/translations/pt-BR/data/reusables/code-scanning/edit-workflow.md +++ b/translations/pt-BR/data/reusables/code-scanning/edit-workflow.md @@ -1 +1 @@ -De modo geral, você não precisa editar o fluxo de trabalho padrão para {% data variables.product.prodname_code_scanning %}. However, if required, you can edit the workflow to customize some of the settings. For example, you can edit {% data variables.product.prodname_dotcom %}'s {% data variables.product.prodname_codeql_workflow %} to specify the frequency of scans, the languages or directories to scan, and what {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} looks for in your code. You might also need to edit the workflow if you use a specific set of commands to compile your code or if there is more than one compiled language in your repository. +De modo geral, você não precisa editar o fluxo de trabalho padrão para {% data variables.product.prodname_code_scanning %}. No entanto, se necessário, você editar o fluxo de trabalho para personalizar algumas das configurações. Por exemplo, você pode editar os {% data variables.product.prodname_codeql_workflow %} de {% data variables.product.prodname_dotcom %} para especificar a frequência das digitalizações, as linguagens ou diretórios a serem digitalizados e o que {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} procura no seu código. Talvez você precise editar o {% data variables.product.prodname_codeql_workflow %} se você usar um conjunto específico de comandos para compilar seu código. diff --git a/translations/pt-BR/data/reusables/code-scanning/enabling-options.md b/translations/pt-BR/data/reusables/code-scanning/enabling-options.md index 6b1c8b1a10b9..4f0ad441cc94 100644 --- a/translations/pt-BR/data/reusables/code-scanning/enabling-options.md +++ b/translations/pt-BR/data/reusables/code-scanning/enabling-options.md @@ -1,11 +1,11 @@ @@ -15,7 +15,7 @@ @@ -25,7 +25,7 @@ -
    - Type of analysis + Tipo de análise - Options for generating alerts + Opções para gerar alertas
    - Using {% data variables.product.prodname_actions %} (see "Enabling {% data variables.product.prodname_code_scanning %} using actions") or using the {% data variables.product.prodname_codeql_runner %} in a third-party continuous integration (CI) system (see "Running code scanning in your CI system"). + Usar {% data variables.product.prodname_actions %} (consulte "Habilitar {% data variables.product.prodname_code_scanning %} usando ações") ou usar o {% data variables.product.prodname_codeql_runner %} em um sistema contínuo de integração contínua (CI) de terceiros (consulte "Varrendo o código em execução no seu sistema de CI").
    - Using {% data variables.product.prodname_actions %} (see "Enabling {% data variables.product.prodname_code_scanning %} using actions") or generated externally and uploaded to {% data variables.product.product_name %} (see "Uploading a SARIF file to {% data variables.product.prodname_dotcom %}"). + Usar {% data variables.product.prodname_actions %} (consulte "Habilitar {% data variables.product.prodname_code_scanning %} usando ações") ou geradas externamente e subidas em {% data variables.product.product_name %} (consulte "Fazer upload de um arquivo SARIF em {% data variables.product.prodname_dotcom %}").
    \ No newline at end of file + diff --git a/translations/pt-BR/data/reusables/code-scanning/enterprise-enable-code-scanning-actions.md b/translations/pt-BR/data/reusables/code-scanning/enterprise-enable-code-scanning-actions.md index 5612481d72c8..8772b9be683b 100644 --- a/translations/pt-BR/data/reusables/code-scanning/enterprise-enable-code-scanning-actions.md +++ b/translations/pt-BR/data/reusables/code-scanning/enterprise-enable-code-scanning-actions.md @@ -2,7 +2,7 @@ {% note %} -**Note:** Your site administrator must enable {% data variables.product.prodname_code_scanning %} for {% data variables.product.product_location_enterprise %} before you can use this feature. If you want to use {% data variables.product.prodname_actions %} to scan your code, the site administrator must also enable {% data variables.product.prodname_actions %} and set up the infrastructure required. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %} for your appliance](/enterprise/admin/configuration/configuring-code-scanning-for-your-appliance)." +**Observação:** O administrador do site deve habilitar {% data variables.product.prodname_code_scanning %} para {% data variables.product.product_location_enterprise %} antes de usar este recurso. Se você desejar usar o {% data variables.product.prodname_actions %} para fazer a varredura do seu código, o administrador do site também deverá habilitar o {% data variables.product.prodname_actions %} e configurar a infraestrutura necessária. Para obter mais informações, consulte "[Configurar o {% data variables.product.prodname_code_scanning %} para seu aplicativo ](/enterprise/admin/configuration/configuring-code-scanning-for-your-appliance)". {% endnote %} diff --git a/translations/pt-BR/data/reusables/code-scanning/enterprise-enable-code-scanning.md b/translations/pt-BR/data/reusables/code-scanning/enterprise-enable-code-scanning.md index c23014293889..187b281b10ea 100644 --- a/translations/pt-BR/data/reusables/code-scanning/enterprise-enable-code-scanning.md +++ b/translations/pt-BR/data/reusables/code-scanning/enterprise-enable-code-scanning.md @@ -2,7 +2,7 @@ {% note %} -**Note:** Your site administrator must enable {% data variables.product.prodname_code_scanning %} for {% data variables.product.product_location_enterprise %} before you can use this feature. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %} for your appliance](/enterprise/admin/configuration/configuring-code-scanning-for-your-appliance)." +**Observação:** O administrador do site deve habilitar {% data variables.product.prodname_code_scanning %} para {% data variables.product.product_location_enterprise %} antes de usar este recurso. Para obter mais informações, consulte "[Configurar o {% data variables.product.prodname_code_scanning %} para seu aplicativo ](/enterprise/admin/configuration/configuring-code-scanning-for-your-appliance)". {% endnote %} diff --git a/translations/pt-BR/data/reusables/code-scanning/example-configuration-files.md b/translations/pt-BR/data/reusables/code-scanning/example-configuration-files.md index 9fe7a2233eb2..600994b354f5 100644 --- a/translations/pt-BR/data/reusables/code-scanning/example-configuration-files.md +++ b/translations/pt-BR/data/reusables/code-scanning/example-configuration-files.md @@ -7,7 +7,7 @@ queries: - uses: security-and-quality ``` -The following configuration file disables the default queries and specifies a set of custom queries to run instead. It also configures {% data variables.product.prodname_codeql %} to scan files in the _src_ directory (relative to the root), and to exclude the _node_modules_ directory (also relative to the root), as well as any file whose name ends in _.test.js_. +O seguinte arquivo de configuração desabilita as consultas-padrão e especifica um conjunto de consultas personalizadas para serem executadas. Ele também configura o {% data variables.product.prodname_codeql %} para fazer a varredura de arquivos no diretório _src_ (relativas à raiz) e para excluir o diretório _node_modules_ (também relativo à raiz), bem como qualquer arquivo cujo nome termina em _.test.js_. ``` yaml name: "My {% data variables.product.prodname_codeql %} config" diff --git a/translations/pt-BR/data/reusables/code-scanning/false-positive-fix-codeql.md b/translations/pt-BR/data/reusables/code-scanning/false-positive-fix-codeql.md new file mode 100644 index 000000000000..59bdff96b876 --- /dev/null +++ b/translations/pt-BR/data/reusables/code-scanning/false-positive-fix-codeql.md @@ -0,0 +1 @@ +Se você fechar um alerta de {% data variables.product.prodname_codeql %} como um falso resultado positivo, por exemplo, porque o código usa uma biblioteca de sanitização incompatível, considere contribuir ao repositório de {% data variables.product.prodname_codeql %} e melhorar a análise. Para obter mais informações sobre {% data variables.product.prodname_codeql %}, consulte "[Contribuir para {% data variables.product.prodname_codeql %}](https://github.com/github/codeql/blob/main/CONTRIBUTING.md)". diff --git a/translations/pt-BR/data/reusables/code-scanning/interoperable-with-tools-that-output-sarif.md b/translations/pt-BR/data/reusables/code-scanning/interoperable-with-tools-that-output-sarif.md index 0a1ef2b71493..1d17f8213783 100644 --- a/translations/pt-BR/data/reusables/code-scanning/interoperable-with-tools-that-output-sarif.md +++ b/translations/pt-BR/data/reusables/code-scanning/interoperable-with-tools-that-output-sarif.md @@ -1 +1 @@ -{% data variables.product.prodname_code_scanning_capc %} é interoperável com ferramentas de escaneamento de código de terceiros que saem dados de análise estática de resultados de mudança de formato (SARIF). SARIF é um padrão aberto. Para obter mais informações, consulte "[SARIF output for {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning)." \ No newline at end of file +{% data variables.product.prodname_code_scanning_capc %} é interoperável com ferramentas de escaneamento de código de terceiros que saem dados de análise estática de resultados de mudança de formato (SARIF). SARIF é um padrão aberto. Para obter mais informações, consulte "[SARIF output for {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning)." diff --git a/translations/pt-BR/data/reusables/code-scanning/run-additional-queries.md b/translations/pt-BR/data/reusables/code-scanning/run-additional-queries.md index b1ef8f0a9469..e3d509898143 100644 --- a/translations/pt-BR/data/reusables/code-scanning/run-additional-queries.md +++ b/translations/pt-BR/data/reusables/code-scanning/run-additional-queries.md @@ -1,9 +1,9 @@ -When you use {% data variables.product.prodname_codeql %} to scan code, the {% data variables.product.prodname_codeql %} analysis engine generates a database from the code and runs queries on it. Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning#about-codeql)". +Ao usar {% data variables.product.prodname_codeql %} para fazer a varredura do código, o mecanismo de análise de {% data variables.product.prodname_codeql %} gera um banco de dados do código e executa consultas no mesmo. Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning#about-codeql)". -{% data variables.product.prodname_codeql %} analysis uses a default set of queries, but you can specify more queries to run, in addition to the default queries. As consultas que você desejar executar devem pertencer a um pacote do {% data variables.product.prodname_ql %} e podem estar no seu próprio repositório ou em qualquer repositório público. Para obter mais informações, consulte "[Sobre os pacotes de {% data variables.product.prodname_ql %}](https://help.semmle.com/codeql/codeql-cli/reference/qlpack-overview.html). +A análise de {% data variables.product.prodname_codeql %} usa um conjunto-padrão de consultas, mas você pode especificar outras consultas a serem executadas, além das consultas-padrão. As consultas que você desejar executar devem pertencer a um pacote do {% data variables.product.prodname_ql %} e podem estar no seu próprio repositório ou em qualquer repositório público. Para obter mais informações, consulte "[Sobre os pacotes de {% data variables.product.prodname_ql %}](https://help.semmle.com/codeql/codeql-cli/reference/qlpack-overview.html). -As consultas só devem depender das bibliotecas-padrão (ou seja, as bibliotecas referenciadas por uma declaração de `LINGUAGEM de importação` na sua consulta), ou bibliotecas no mesmo pacote do {% data variables.product.prodname_ql %} da consulta. As bibliotecas-padrão estão localizadas no repositório [github/codeql](https://github.com/github/codeql). For more information, see "[About CodeQL queries](https://help.semmle.com/QL/learn-ql/writing-queries/introduction-to-queries.html)." +As consultas só devem depender das bibliotecas-padrão (ou seja, as bibliotecas referenciadas por uma declaração de `LINGUAGEM de importação` na sua consulta), ou bibliotecas no mesmo pacote do {% data variables.product.prodname_ql %} da consulta. As bibliotecas-padrão estão localizadas no repositório [github/codeql](https://github.com/github/codeql). Para obter mais informações, consulte "[Sobre consultas do CodeQL](https://help.semmle.com/QL/learn-ql/writing-queries/introduction-to-queries.html)". -Você pode especificar um único arquivo _.ql_, um diretório que contém múltiplos arquivos _.ql_, um arquivo de definição de suite de consultas _.qls_ ou qualquer outra combinação. For more information about query suite definitions, see "[Creating {% data variables.product.prodname_codeql %} query suites](https://help.semmle.com/codeql/codeql-cli/procedures/query-suites.html)." +Você pode especificar um único arquivo _.ql_, um diretório que contém múltiplos arquivos _.ql_, um arquivo de definição de suite de consultas _.qls_ ou qualquer outra combinação. Para obter mais informações sobre definições do conjunto de consultas, consulte "[Criar as conjuntos de consulta do {% data variables.product.prodname_codeql %}](https://help.semmle.com/codeql/codeql-cli/procedures/query-suites.html)". -{% if currentVersion == "free-pro-team@latest" %}We don't recommend referencing query suites directly from the `github/codeql` repository, like `github/codeql/cpp/ql/src@main`. Such queries may not be compiled with the same version of {% data variables.product.prodname_codeql %} as used for your other queries, which could lead to errors during analysis.{% endif %} +{% if currentVersion == "free-pro-team@latest" %}Não recomendamos fazer referências a conjuntos de consulta diretamente a partir do repositório `github/codeql`, como `github/codeql/cpp/ql/src@main`. Tais consultas não podem ser compiladas com a mesma versão do {% data variables.product.prodname_codeql %} que é usada para outras consultas, que poderia gerar erros durante a análise.{% endif %} diff --git a/translations/pt-BR/data/reusables/code-scanning/specify-language-to-analyze.md b/translations/pt-BR/data/reusables/code-scanning/specify-language-to-analyze.md index adc1b072dd15..509aec93567e 100644 --- a/translations/pt-BR/data/reusables/code-scanning/specify-language-to-analyze.md +++ b/translations/pt-BR/data/reusables/code-scanning/specify-language-to-analyze.md @@ -1 +1 @@ -Se o seu repositório contiver código em várias linguagens, você poderá especificar as linguagens que você deseja analisar. Há vários motivos para impedir que uma linguagem seja analisada. Por exemplo, o projeto pode ter dependências em uma linguagem diferente do texto principal do seu código, e você pode preferir não ver os alertas para essas dependências. +Se o seu repositório contiver código em mais de uma das linguagens compatíveis, você poderá escolher quais linguagens deseja analisar. Há vários motivos para impedir que uma linguagem seja analisada. Por exemplo, o projeto pode ter dependências em uma linguagem diferente do texto principal do seu código, e você pode preferir não ver os alertas para essas dependências. diff --git a/translations/pt-BR/data/reusables/codespaces/about-billing-for-codespaces.md b/translations/pt-BR/data/reusables/codespaces/about-billing-for-codespaces.md new file mode 100644 index 000000000000..20d799122ab5 --- /dev/null +++ b/translations/pt-BR/data/reusables/codespaces/about-billing-for-codespaces.md @@ -0,0 +1 @@ +{% data variables.product.prodname_codespaces %} é grátis para usar durante a beta. Quando {% data variables.product.prodname_codespaces %} se torna geralmente disponível, você será cobrado para armazenamento e uso de computação. diff --git a/translations/pt-BR/data/reusables/codespaces/about-configuration.md b/translations/pt-BR/data/reusables/codespaces/about-configuration.md index 2ed1bd49c78a..1435705ccf5a 100644 --- a/translations/pt-BR/data/reusables/codespaces/about-configuration.md +++ b/translations/pt-BR/data/reusables/codespaces/about-configuration.md @@ -1 +1 @@ -Você pode criar uma configuração padrão de codespace para o seu repositório que determina o ambiente de cada novo codespace que alguém criar para esse repositório. The configuration defines a development container that can include frameworks, tools, extensions, and port forwarding. +Você pode criar uma configuração padrão de codespace para o seu repositório que determina o ambiente de cada novo codespace que alguém criar para esse repositório. A configuração define um contêiner de desenvolvimento que pode incluir estruturas, ferramentas, extensões e encaminhamento de porta. diff --git a/translations/pt-BR/data/reusables/codespaces/click-remote-explorer-icon-vscode.md b/translations/pt-BR/data/reusables/codespaces/click-remote-explorer-icon-vscode.md index c45d078f12a5..44f5e4ef6f62 100644 --- a/translations/pt-BR/data/reusables/codespaces/click-remote-explorer-icon-vscode.md +++ b/translations/pt-BR/data/reusables/codespaces/click-remote-explorer-icon-vscode.md @@ -1 +1 @@ -1. Em {% data variables.product.prodname_vscode %}, na barra lateral esquerda, clique no ícone Remote Explorer. ![O ícone do Remote Explorer em {% data variables.product.prodname_vscode %}](/assets/images/help/codespaces/click-remote-explorer-icon-vscode.png) \ No newline at end of file +1. Em {% data variables.product.prodname_vscode %}, na barra lateral esquerda, clique no ícone Remote Explorer. ![O ícone do Remote Explorer em {% data variables.product.prodname_vscode %}](/assets/images/help/codespaces/click-remote-explorer-icon-vscode.png) diff --git a/translations/pt-BR/data/reusables/codespaces/codespaces-are-per-branch.md b/translations/pt-BR/data/reusables/codespaces/codespaces-are-per-branch.md index 734d01ff53cf..aaee1d9d1714 100644 --- a/translations/pt-BR/data/reusables/codespaces/codespaces-are-per-branch.md +++ b/translations/pt-BR/data/reusables/codespaces/codespaces-are-per-branch.md @@ -1 +1 @@ -Cada código é associado a um branch específico de um repositório. \ No newline at end of file +Cada código é associado a um branch específico de um repositório. diff --git a/translations/pt-BR/data/reusables/codespaces/codespaces-are-personal.md b/translations/pt-BR/data/reusables/codespaces/codespaces-are-personal.md index cc3baf8a4ef7..9d77e536f7e0 100644 --- a/translations/pt-BR/data/reusables/codespaces/codespaces-are-personal.md +++ b/translations/pt-BR/data/reusables/codespaces/codespaces-are-personal.md @@ -1 +1 @@ -Cada espaço de código que criar só está disponível para você. Ninguém mais pode trabalhar no seu espaço de código. \ No newline at end of file +Cada espaço de código que criar só está disponível para você. Ninguém mais pode trabalhar no seu espaço de código. diff --git a/translations/pt-BR/data/reusables/codespaces/concurrent-codespace-limit.md b/translations/pt-BR/data/reusables/codespaces/concurrent-codespace-limit.md index 03a122f0297f..477b0489b169 100644 --- a/translations/pt-BR/data/reusables/codespaces/concurrent-codespace-limit.md +++ b/translations/pt-BR/data/reusables/codespaces/concurrent-codespace-limit.md @@ -1 +1 @@ -Você pode criar mais de um código de espaço por repositório ou até mesmo por branch. However, each user account has a two-codespace limit during limited public beta. Se você atingiu o limite e deseja criar um novo espaço de código, você deve primeiro excluir um código. +Você pode criar mais de um código de espaço por repositório ou até mesmo por branch. No entanto, cada conta de usuário tem um limite de dois codespaces durante um beta público limitado. Se você atingiu o limite e deseja criar um novo espaço de código, você deve primeiro excluir um código. diff --git a/translations/pt-BR/data/reusables/codespaces/connect-to-codespace-from-vscode.md b/translations/pt-BR/data/reusables/codespaces/connect-to-codespace-from-vscode.md index 134613355785..be18129c857f 100644 --- a/translations/pt-BR/data/reusables/codespaces/connect-to-codespace-from-vscode.md +++ b/translations/pt-BR/data/reusables/codespaces/connect-to-codespace-from-vscode.md @@ -1 +1 @@ -Você pode se conectar ao seu código diretamente de {% data variables.product.prodname_vscode %}. Para obter mais informações, consulte "[Connecting to your codespace de {% data variables.product.prodname_vscode %}](/github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code)." \ No newline at end of file +Você pode se conectar ao seu código diretamente de {% data variables.product.prodname_vscode %}. Para obter mais informações, consulte "[Usar codespaces no {% data variables.product.prodname_vscode %}](/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code)". diff --git a/translations/pt-BR/data/reusables/codespaces/devcontainer-location.md b/translations/pt-BR/data/reusables/codespaces/devcontainer-location.md new file mode 100644 index 000000000000..5af86ddcf178 --- /dev/null +++ b/translations/pt-BR/data/reusables/codespaces/devcontainer-location.md @@ -0,0 +1 @@ +Este arquivo pode ser localizado na raiz do repositório ou em uma pasta denominada `.devcontainer`. Se o arquivo estiver localizado na raiz do repositório, o nome do arquivo deve começar com um ponto: `.devcontainer.json`. diff --git a/translations/pt-BR/data/reusables/codespaces/navigate-to-codespaces.md b/translations/pt-BR/data/reusables/codespaces/navigate-to-codespaces.md index 285122164e88..a85e3a30f607 100644 --- a/translations/pt-BR/data/reusables/codespaces/navigate-to-codespaces.md +++ b/translations/pt-BR/data/reusables/codespaces/navigate-to-codespaces.md @@ -1 +1 @@ -1. Na parte superior da página, clique em **Codespaces**. ![{% data variables.product.prodname_codespaces %} link no cabeçalho](/assets/images/help/codespaces/header-link.png) \ No newline at end of file +1. Na parte superior da página, clique em **Codespaces**. ![{% data variables.product.prodname_codespaces %} link no cabeçalho](/assets/images/help/codespaces/header-link.png) diff --git a/translations/pt-BR/data/reusables/codespaces/release-stage.md b/translations/pt-BR/data/reusables/codespaces/release-stage.md index 86bbec6ed51e..600f7802d157 100644 --- a/translations/pt-BR/data/reusables/codespaces/release-stage.md +++ b/translations/pt-BR/data/reusables/codespaces/release-stage.md @@ -2,4 +2,4 @@ **Observação:** {% data variables.product.prodname_codespaces %} está atualmente em versão beta pública limitada e sujeito a alterações. Durante o período beta, {% data variables.product.prodname_dotcom %} não faz nenhuma garantia sobre a disponibilidade de {% data variables.product.prodname_codespaces %}. Para obter mais informações sobre fontes de publicação, consulte "[About {% data variables.product.prodname_codespaces %}](/github/developing-online-with-codespaces/about-codespaces#joining-the-beta)." -{% endnote %} \ No newline at end of file +{% endnote %} diff --git a/translations/pt-BR/data/reusables/codespaces/unsupported-repos.md b/translations/pt-BR/data/reusables/codespaces/unsupported-repos.md index 3c081e146ef6..ee7d7ce6514f 100644 --- a/translations/pt-BR/data/reusables/codespaces/unsupported-repos.md +++ b/translations/pt-BR/data/reusables/codespaces/unsupported-repos.md @@ -1 +1 @@ -Durante o beta, repositórios privados pertencentes a organizações ou quaisquer repositórios pertencentes a uma organização que exijam um único login SAML, não são suportados. \ No newline at end of file +Durante o beta, repositórios privados pertencentes a organizações ou quaisquer repositórios pertencentes a uma organização que exijam um único login SAML, não são suportados. diff --git a/translations/pt-BR/data/reusables/codespaces/use-visual-studio-features.md b/translations/pt-BR/data/reusables/codespaces/use-visual-studio-features.md index ec1816b34b08..428e0b58794a 100644 --- a/translations/pt-BR/data/reusables/codespaces/use-visual-studio-features.md +++ b/translations/pt-BR/data/reusables/codespaces/use-visual-studio-features.md @@ -1 +1 @@ -Depois de abrir um código, você pode desenvolver usando recursos do {% data variables.product.prodname_vscode %}, como edição de texto, depuração e comandos Git. For more information, see the [{% data variables.product.prodname_vscode %} documentation](https://code.visualstudio.com/docs). +Você pode editar código, depurar e usar comandos do Git ao mesmo tempo que faz o desenvolvimento em um codespace com {% data variables.product.prodname_vscode %}. For more information, see the [{% data variables.product.prodname_vscode %} documentation](https://code.visualstudio.com/docs). diff --git a/translations/pt-BR/data/reusables/codespaces/you-can-see-all-your-codespaces.md b/translations/pt-BR/data/reusables/codespaces/you-can-see-all-your-codespaces.md index d8fc691c88b2..e973538df0a6 100644 --- a/translations/pt-BR/data/reusables/codespaces/you-can-see-all-your-codespaces.md +++ b/translations/pt-BR/data/reusables/codespaces/you-can-see-all-your-codespaces.md @@ -1 +1 @@ -Você pode ver todos os códigos pertencentes a sua conta de usuário em [github.com/codespaces](https://github.com/codespaces). \ No newline at end of file +Você pode ver todos os códigos pertencentes a sua conta de usuário em [github.com/codespaces](https://github.com/codespaces). diff --git a/translations/pt-BR/data/reusables/command_line/git-clone-url.md b/translations/pt-BR/data/reusables/command_line/git-clone-url.md index c9bee6495bf2..50f17a163337 100644 --- a/translations/pt-BR/data/reusables/command_line/git-clone-url.md +++ b/translations/pt-BR/data/reusables/command_line/git-clone-url.md @@ -1,4 +1,4 @@ 5. Digite `git clone` (clonar git) e cole a URL que você copiou anteriormente. ```shell $ git clone https://{% data variables.command_line.codeblock %}/YOUR-USERNAME/YOUR-REPOSITORY - ``` \ No newline at end of file + ``` diff --git a/translations/pt-BR/data/reusables/command_line/provide-an-access-token.md b/translations/pt-BR/data/reusables/command_line/provide-an-access-token.md index b65ab19f6294..ec262c9c4aa5 100644 --- a/translations/pt-BR/data/reusables/command_line/provide-an-access-token.md +++ b/translations/pt-BR/data/reusables/command_line/provide-an-access-token.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}If you are accessing an organization that uses SAML SSO, you must also authorize your personal access token to access the organization before you authenticate. Para mais informações consulte "[Sobre autenticação com logon único SAML](/github/authenticating-to-github/about-authentication-with-saml-single-sign-on)" e "[Autorizando um token de acesso pessoal para uso com logon único SAML](/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on).{% endif %} +{% if currentVersion == "free-pro-team@latest" %}Se você estiver acessando uma organização que usa o SAML SSO, você também deve autorizar seu token de acesso pessoal para acessar a organização antes de efetuar a autenticação. Para mais informações consulte "[Sobre autenticação com logon único SAML](/github/authenticating-to-github/about-authentication-with-saml-single-sign-on)" e "[Autorizando um token de acesso pessoal para uso com logon único SAML](/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on).{% endif %} diff --git a/translations/pt-BR/data/reusables/commits/about-commits.md b/translations/pt-BR/data/reusables/commits/about-commits.md index 9708aaa44de1..4b6687232b39 100644 --- a/translations/pt-BR/data/reusables/commits/about-commits.md +++ b/translations/pt-BR/data/reusables/commits/about-commits.md @@ -1,4 +1,4 @@ -Similar to saving a file that's been edited, a commit records changes to one or more files in your branch. Git assigns each commit a unique ID, called a SHA or hash, that identifies: +Assim como ao salvar um arquivo que foi editado, um commit registra alterações em um ou mais arquivos no seu branch. O Git atribui a cada commit um ID exclusivo, denominado SHA ou hash, que identifica: - Cada uma das alterações feitas; - O momento em que as alterações foram feitas; diff --git a/translations/pt-BR/data/reusables/dashboard/access-org-dashboard.md b/translations/pt-BR/data/reusables/dashboard/access-org-dashboard.md index 846d34427b2c..86d3c44ff54a 100644 --- a/translations/pt-BR/data/reusables/dashboard/access-org-dashboard.md +++ b/translations/pt-BR/data/reusables/dashboard/access-org-dashboard.md @@ -1,2 +1,2 @@ -1. Para acessar a página do painel, clique no canto superior esquerdo de qualquer página do {% data variables.product.product_name %}, clique no {% octicon "mark-github" aria-label="The github octocat logo" %}. +1. Para acessar a página do painel, clique no {% octicon "mark-github" aria-label="The github octocat logo" %} no canto superior esquerdo de qualquer página do {% data variables.product.product_name %}. 2. No canto superior esquerdo da página, clique em seu nome de usuário e escolha a organização desejada no menu suspenso. ![Menu suspenso de contexto de painel com diferentes opções de organizações](/assets/images/help/dashboard/dashboard-context-switcher.png) diff --git a/translations/pt-BR/data/reusables/dependabot/check-in-dependabot-yml.md b/translations/pt-BR/data/reusables/dependabot/check-in-dependabot-yml.md index 9326ceff46ba..9f854f1a2f69 100644 --- a/translations/pt-BR/data/reusables/dependabot/check-in-dependabot-yml.md +++ b/translations/pt-BR/data/reusables/dependabot/check-in-dependabot-yml.md @@ -1 +1 @@ -1. Confira o arquivo de configuração *dependabot.yml* no diretório e `.github` do repositório. \ No newline at end of file +1. Confira o arquivo de configuração *dependabot.yml* no diretório e `.github` do repositório. diff --git a/translations/pt-BR/data/reusables/dependabot/create-dependabot-yml.md b/translations/pt-BR/data/reusables/dependabot/create-dependabot-yml.md index 5480c7747a0d..69f69927d09b 100644 --- a/translations/pt-BR/data/reusables/dependabot/create-dependabot-yml.md +++ b/translations/pt-BR/data/reusables/dependabot/create-dependabot-yml.md @@ -1 +1 @@ -1. Crie um arquivo de configuração *dependabot.yml*. \ No newline at end of file +1. Crie um arquivo de configuração *dependabot.yml*. diff --git a/translations/pt-BR/data/reusables/dependabot/default-dependencies-allow-ignore.md b/translations/pt-BR/data/reusables/dependabot/default-dependencies-allow-ignore.md index 31dc001b5f40..f761f52ead01 100644 --- a/translations/pt-BR/data/reusables/dependabot/default-dependencies-allow-ignore.md +++ b/translations/pt-BR/data/reusables/dependabot/default-dependencies-allow-ignore.md @@ -1 +1 @@ -Por padrão, todas as dependências que estão explicitamente definidas em um manifesto ou arquivo de bloqueio são mantidas atualizadas. Você pode usar `allow` e `ignore` para personalizar quais dependências devem manter com as atualizações da versão. {% data variables.product.prodname_dependabot %} verifica todas as dependências permitidas e, em seguida, filtra quaisquer dependências ou versões ignoradas. Portanto, uma dependência que seja acompanhada por ambos `allow` e `ignore` será ignorada. \ No newline at end of file +Por padrão, todas as dependências que estão explicitamente definidas em um manifesto ou arquivo de bloqueio são mantidas atualizadas. Você pode usar `allow` e `ignore` para personalizar quais dependências devem manter com as atualizações da versão. {% data variables.product.prodname_dependabot %} verifica todas as dependências permitidas e, em seguida, filtra quaisquer dependências ou versões ignoradas. Portanto, uma dependência que seja acompanhada por ambos `allow` e `ignore` será ignorada. diff --git a/translations/pt-BR/data/reusables/dependabot/default-labels.md b/translations/pt-BR/data/reusables/dependabot/default-labels.md index 17430feef1ff..a95e2e9351a5 100644 --- a/translations/pt-BR/data/reusables/dependabot/default-labels.md +++ b/translations/pt-BR/data/reusables/dependabot/default-labels.md @@ -1 +1 @@ -Por padrão, {% data variables.product.prodname_dependabot %} eleva todas as pull requests com o rótulo de `dependencies`. If more than one package manager is defined, {% data variables.product.prodname_dependabot_short %} includes an additional label on each pull request. Isto indica qual idioma ou ecossistema a pull request irá atualizar, por exemplo: `java` para atualizações Gradle e `submodules` para atualizações de submódulos do git. {% data variables.product.prodname_dependabot %} cria essas etiquetas padrão automaticamente, conforme necessário no seu repositório. +Por padrão, {% data variables.product.prodname_dependabot %} eleva todas as pull requests com o rótulo de `dependencies`. Se mais de um gerenciador de pacotes for definido, {% data variables.product.prodname_dependabot_short %} incluirá uma etiqueta adicional em cada pull request. Isto indica qual idioma ou ecossistema a pull request irá atualizar, por exemplo: `java` para atualizações Gradle e `submodules` para atualizações de submódulos do git. {% data variables.product.prodname_dependabot %} cria essas etiquetas padrão automaticamente, conforme necessário no seu repositório. diff --git a/translations/pt-BR/data/reusables/dependabot/dependabot-tos.md b/translations/pt-BR/data/reusables/dependabot/dependabot-tos.md index d52b0b03405b..7859aff7997b 100644 --- a/translations/pt-BR/data/reusables/dependabot/dependabot-tos.md +++ b/translations/pt-BR/data/reusables/dependabot/dependabot-tos.md @@ -1 +1 @@ -{% data variables.product.prodname_dependabot %} and all related features are covered by [{% data variables.product.prodname_dotcom %}'s Terms of Service](/github/site-policy/github-terms-of-service). \ No newline at end of file +{% data variables.product.prodname_dependabot %} e todos os recursos relacionados estão cobertos pelos Termos de Serviço de [{% data variables.product.prodname_dotcom %}](/github/site-policy/github-terms-of-service). diff --git a/translations/pt-BR/data/reusables/dependabot/initial-updates.md b/translations/pt-BR/data/reusables/dependabot/initial-updates.md index e2c583b13189..f92e57898328 100644 --- a/translations/pt-BR/data/reusables/dependabot/initial-updates.md +++ b/translations/pt-BR/data/reusables/dependabot/initial-updates.md @@ -1,3 +1,3 @@ -Quando você habilitar atualizações de versão pela primeira vez, você pode ter muitas dependências que estão desatualizadas e algumas podem ser muitas versões por trás da versão mais recente. {% data variables.product.prodname_dependabot %} checks for outdated dependencies as soon as it's enabled. Você pode ver novas pull requests para atualizações de versão dentro de alguns minutos após adicionar o arquivo de configuração, dependendo do número de arquivos de manifesto para os quais você configura as atualizações. +Quando você habilitar atualizações de versão pela primeira vez, você pode ter muitas dependências que estão desatualizadas e algumas podem ser muitas versões por trás da versão mais recente. O {% data variables.product.prodname_dependabot %} verifica as dependências desatualizadas assim que estiver habilitado. Você pode ver novas pull requests para atualizações de versão dentro de alguns minutos após adicionar o arquivo de configuração, dependendo do número de arquivos de manifesto para os quais você configura as atualizações. -To keep pull requests manageable and easy to review, {% data variables.product.prodname_dependabot_short %} raises a maximum of five pull requests to start bringing dependencies up to the latest version. Se você fizer o merge de algumas destas primeiras pull requests antes da próxima atualização programada, então as próximas pull requests serão abertas até um máximo de cinco (você pode alterar esse limite). +Para manter os pull requests gerenciáveis e fáceis de revisar, o {% data variables.product.prodname_dependabot_short %} gera um máximo de cinco pull requests para começar a criar dependências até a versão mais recente. Se você fizer o merge de algumas destas primeiras pull requests antes da próxima atualização programada, então as próximas pull requests serão abertas até um máximo de cinco (você pode alterar esse limite). diff --git a/translations/pt-BR/data/reusables/dependabot/option-affects-security-updates.md b/translations/pt-BR/data/reusables/dependabot/option-affects-security-updates.md index 49939a6397d3..b038e2e9c431 100644 --- a/translations/pt-BR/data/reusables/dependabot/option-affects-security-updates.md +++ b/translations/pt-BR/data/reusables/dependabot/option-affects-security-updates.md @@ -1 +1 @@ -A configuração desta opção também afetará as pull requests para atualizações de segurança nos arquivos de manifesto deste gerenciador de pacotes, a menos que você use `target-branch` para verificar se há atualizações de versão em um branch não-padrão. \ No newline at end of file +A configuração desta opção também afetará as pull requests para atualizações de segurança nos arquivos de manifesto deste gerenciador de pacotes, a menos que você use `target-branch` para verificar se há atualizações de versão em um branch não-padrão. diff --git a/translations/pt-BR/data/reusables/dependabot/private-dependencies.md b/translations/pt-BR/data/reusables/dependabot/private-dependencies.md index 1ba08ff8f048..504dba2c24f9 100644 --- a/translations/pt-BR/data/reusables/dependabot/private-dependencies.md +++ b/translations/pt-BR/data/reusables/dependabot/private-dependencies.md @@ -1 +1 @@ -Currently, {% data variables.product.prodname_dependabot_version_updates %} doesn't support manifest or lock files that contain any private git dependencies or private git registries. This is because, when running version updates, {% data variables.product.prodname_dependabot_short %} must be able to resolve all dependencies from their source to verify that version updates have been successful. \ No newline at end of file +Atualmente, {% data variables.product.prodname_dependabot_version_updates %} não é compatível com manifesto ou arquivos de bloqueio que contêm dependências do git privadas ou registros do git privados. Isso é porque, quando estiver executando atualizações de versão, o {% data variables.product.prodname_dependabot_short %} deve ser capaz de resolver todas as dependências da sua fonte para verificar se as atualizações da versão foram bem-sucedidas. diff --git a/translations/pt-BR/data/reusables/dependabot/supported-package-managers.md b/translations/pt-BR/data/reusables/dependabot/supported-package-managers.md index f9cb69f91be6..d3641aac4608 100644 --- a/translations/pt-BR/data/reusables/dependabot/supported-package-managers.md +++ b/translations/pt-BR/data/reusables/dependabot/supported-package-managers.md @@ -1,15 +1,29 @@ -- Bundler: `bundler` -- Cargo: `cargo` -- Composer: `composer` -- Docker: `docker` -- Elm: `elm` -- git submodule: `gitsubmodule` -- GitHub Actions: `github-actions` -- Go modules: `gomod` -- Gradle: `gradle` -- Maven: `maven` -- Mix: `mix` -- npm: `npm` -- NuGet: `nuget` -- pip: `pip` -- Terraform: `terraform` +| Gerenciador de pacotes | Suporta vendoring | +| -------------------------------- |:-----------------:| +| Bundler: `bundler` | **X** | +| Cargo: `cargo` | | +| Composer: `composer` | | +| Docker: `docker` | | +| Elm: `elm` | | +| git submodule: `gitsubmodule` | | +| GitHub Actions: `github-actions` | | +| Go modules: `gomod` | | +| Gradle: `gradle` | | +| Maven: `maven` | | +| Mix: `mix` | | +| npm: `npm` | | +| NuGet: `nuget` | | +| pip: `pip` | | +| Terraform: `terraform` | | + +{% note %} + +**Observação**: {% data variables.product.prodname_dependabot_short %} também é compatível os seguintes gerentes de pacote: + +-`yarn` (apenas v1) (especifique `npm`) + +-`pipenv`, `pip-compile` e `poetry` (especifique `pip`) + +Por exemplo, se você usa o `poetry` para gerenciar suas dependências do Python e quer que {% data variables.product.prodname_dependabot_short %} monitore seu arquivo de manifesto de dependência para novas versões, use `pacote-ecosystem: "pip"` no seu arquivo *dependabot.yml*. + +{% endnote %} diff --git a/translations/pt-BR/data/reusables/dependabot/upgrade-dependency-to-minimum-secure-version.md b/translations/pt-BR/data/reusables/dependabot/upgrade-dependency-to-minimum-secure-version.md index e84196c1822a..970323dc5dab 100644 --- a/translations/pt-BR/data/reusables/dependabot/upgrade-dependency-to-minimum-secure-version.md +++ b/translations/pt-BR/data/reusables/dependabot/upgrade-dependency-to-minimum-secure-version.md @@ -1,7 +1,7 @@ -The pull request will upgrade the dependency to the minimum possible secure version needed to avoid the vulnerability. +O pull request irá atualizar a dependência para a versão minimamente segura possível, o que é necessário para evitar a vulnerabilidade. {% note %} -**Note:** It's good practice to have automated tests and acceptance processes in place so that checks are carried out before the pull request is merged. This is particularly important if the suggested version to upgrade to contains additional functionality, or a change that breaks your project's code. For more information about continuous integration, see "[About continuous integration](/actions/building-and-testing-code-with-continuous-integration/about-continuous-integration)." +**Observação:** É uma prática recomendada ter testes automatizados e processos de aceitação em vigor para que as verificações sejam realizadas antes do merge do pull request. Isso é especialmente importante se a versão sugerida a ser atualizada contiver funcionalidades adicionais ou se uma mudança que quebrar o código do seu projeto. Para obter mais informações sobre a integração contínua, consulte "[Sobre integração contínua](/actions/building-and-testing-code-with-continuous-integration/about-continuous-integration)". {% endnote %} diff --git a/translations/pt-BR/data/reusables/dependabot/version-updates-for-actions.md b/translations/pt-BR/data/reusables/dependabot/version-updates-for-actions.md index a784b8a8041f..0e95e3ca1135 100644 --- a/translations/pt-BR/data/reusables/dependabot/version-updates-for-actions.md +++ b/translations/pt-BR/data/reusables/dependabot/version-updates-for-actions.md @@ -1 +1 @@ -Você também pode habilitar o {% data variables.product.prodname_dependabot_version_updates %} para as ações que você adicionar ao seu fluxo de trabalho. For more information, see "[Keeping your actions up to date with {% data variables.product.prodname_dependabot %}](/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot)." +Você também pode habilitar o {% data variables.product.prodname_dependabot_version_updates %} para as ações que você adicionar ao seu fluxo de trabalho. Para obter mais informações, consulte "[Manter suas ações atualizadas com o {% data variables.product.prodname_dependabot %}](/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot)". diff --git a/translations/pt-BR/data/reusables/desktop/choose-a-theme.md b/translations/pt-BR/data/reusables/desktop/choose-a-theme.md index 32c5b0c05256..d7418e57f826 100644 --- a/translations/pt-BR/data/reusables/desktop/choose-a-theme.md +++ b/translations/pt-BR/data/reusables/desktop/choose-a-theme.md @@ -1,2 +1,2 @@ 3. Clique em **Appearance** (Aparência). -4. Clique no tema que deseja usar. Opcionalmente, você pode selecionar **Automatically switch theme to match system** (Trocar automaticamente o tema para coincidir com o sistema) se você quiser que o {% data variables.product.prodname_desktop %} sempre corresponda ao tema em seu computador. \ No newline at end of file +4. Clique no tema que deseja usar. Opcionalmente, você pode selecionar **Automatically switch theme to match system** (Trocar automaticamente o tema para coincidir com o sistema) se você quiser que o {% data variables.product.prodname_desktop %} sempre corresponda ao tema em seu computador. diff --git a/translations/pt-BR/data/reusables/desktop/click-base-branch-in-drop-down.md b/translations/pt-BR/data/reusables/desktop/click-base-branch-in-drop-down.md index a5baa888d6f9..508345cb955f 100644 --- a/translations/pt-BR/data/reusables/desktop/click-base-branch-in-drop-down.md +++ b/translations/pt-BR/data/reusables/desktop/click-base-branch-in-drop-down.md @@ -1 +1 @@ -1. At the top of the app, click {% octicon "git-branch" aria-label="The branch icon" %} **Current Branch** and then in the list of branches, click the branch that you want to base your new branch on. +1. Na parte superior do aplicativo, clique em {% octicon "git-branch" aria-label="The branch icon" %} **Branch atual** e, em seguida, clique na lista de branches, e depois clique no branch em que você deseja basear seu novo branch. diff --git a/translations/pt-BR/data/reusables/desktop/confirm-tag.md b/translations/pt-BR/data/reusables/desktop/confirm-tag.md index 91b6e44ed4ca..7745f70796ea 100644 --- a/translations/pt-BR/data/reusables/desktop/confirm-tag.md +++ b/translations/pt-BR/data/reusables/desktop/confirm-tag.md @@ -1 +1 @@ -1. Clique em **Create Tag** (Criar Tag). \ No newline at end of file +1. Clique em **Create Tag** (Criar Tag). diff --git a/translations/pt-BR/data/reusables/desktop/create-tag.md b/translations/pt-BR/data/reusables/desktop/create-tag.md index 71bb3a6ff16d..8f77f3be6eef 100644 --- a/translations/pt-BR/data/reusables/desktop/create-tag.md +++ b/translations/pt-BR/data/reusables/desktop/create-tag.md @@ -1 +1 @@ -1. Clique com o botão direito no commit e clique em **Create Tag...**. ![Selecione o item do menu criar tag](/assets/images/help/desktop/select-create-tag.png) \ No newline at end of file +1. Clique com o botão direito no commit e clique em **Create Tag...**. ![Selecione o item do menu criar tag](/assets/images/help/desktop/select-create-tag.png) diff --git a/translations/pt-BR/data/reusables/desktop/current-branch-menu.md b/translations/pt-BR/data/reusables/desktop/current-branch-menu.md index 3072018a9ba6..59c5cd34d37b 100644 --- a/translations/pt-BR/data/reusables/desktop/current-branch-menu.md +++ b/translations/pt-BR/data/reusables/desktop/current-branch-menu.md @@ -1 +1 @@ -1. In {% data variables.product.prodname_desktop %}, click {% octicon "git-branch" aria-label="The branch icon" %} **Current Branch**. ![Menu suspenso Current Branch (Branch atual)](/assets/images/help/desktop/current-branch-menu.png) +1. No {% data variables.product.prodname_desktop %}, clique em {% octicon "git-branch" aria-label="The branch icon" %} **Branch atual**. ![Menu suspenso Current Branch (Branch atual)](/assets/images/help/desktop/current-branch-menu.png) diff --git a/translations/pt-BR/data/reusables/desktop/delete-branch-mac.md b/translations/pt-BR/data/reusables/desktop/delete-branch-mac.md index 38a7891d3801..fd9f84dde85c 100644 --- a/translations/pt-BR/data/reusables/desktop/delete-branch-mac.md +++ b/translations/pt-BR/data/reusables/desktop/delete-branch-mac.md @@ -1 +1 @@ -1. In your menu bar, click **Branch**, then click **Delete...**. You can also press shift⌘ commandD. +1. Na sua barra de menu, clique em **Branch** e, em seguida, clique em **Excluir...**. Você também pode pressionar shift⌘ commandD. diff --git a/translations/pt-BR/data/reusables/desktop/delete-branch-win.md b/translations/pt-BR/data/reusables/desktop/delete-branch-win.md index 90b7d377193d..f08528bce119 100644 --- a/translations/pt-BR/data/reusables/desktop/delete-branch-win.md +++ b/translations/pt-BR/data/reusables/desktop/delete-branch-win.md @@ -1 +1 @@ -1. In your menu bar, click **Branch**, then click **Delete...**. You can also press CtrlShiftD. +1. Na sua barra de menu, clique em **Branch** e, em seguida, clique em **Excluir...**. Você também pode pressionar CtrlShiftD. diff --git a/translations/pt-BR/data/reusables/desktop/launch-desktop-from-command-line.md b/translations/pt-BR/data/reusables/desktop/launch-desktop-from-command-line.md index efa3242de494..8e36e02e4081 100644 --- a/translations/pt-BR/data/reusables/desktop/launch-desktop-from-command-line.md +++ b/translations/pt-BR/data/reusables/desktop/launch-desktop-from-command-line.md @@ -1 +1 @@ -Para iniciar o {% data variables.product.prodname_desktop %} no último repositório aberto, digite `github`. To launch {% data variables.product.prodname_desktop %} for a particular repository, type `github` followed by the path to the repository. +Para iniciar o {% data variables.product.prodname_desktop %} no último repositório aberto, digite `github`. Para abrir o {% data variables.product.prodname_desktop %} em um repositório específico, digite `github` seguido pelo caminho do repositório. diff --git a/translations/pt-BR/data/reusables/desktop/mac-select-desktop-menu.md b/translations/pt-BR/data/reusables/desktop/mac-select-desktop-menu.md index c110a4675d8d..9355f7bdcfa2 100644 --- a/translations/pt-BR/data/reusables/desktop/mac-select-desktop-menu.md +++ b/translations/pt-BR/data/reusables/desktop/mac-select-desktop-menu.md @@ -1 +1 @@ -1. In the menu bar, use the **{% data variables.product.prodname_desktop %}** drop-down menu, then click **Preferences**. ![Valor das Preferences (Preferências) no menu suspenso do{% data variables.product.prodname_desktop %}](/assets/images/help/desktop/mac-choose-preferences.png) +1. Na barra de menu, use o menu suspenso **{% data variables.product.prodname_desktop %}** e clique em **Preferências**. ![Valor das Preferences (Preferências) no menu suspenso do{% data variables.product.prodname_desktop %}](/assets/images/help/desktop/mac-choose-preferences.png) diff --git a/translations/pt-BR/data/reusables/desktop/preferences-options-tabs.md b/translations/pt-BR/data/reusables/desktop/preferences-options-tabs.md index 79a48d1cd238..2cf8ed8d1aa4 100644 --- a/translations/pt-BR/data/reusables/desktop/preferences-options-tabs.md +++ b/translations/pt-BR/data/reusables/desktop/preferences-options-tabs.md @@ -1,5 +1,5 @@ - Escolha **Accounts** (Contas) para adicionar ou remover uma conta do {% data variables.product.prodname_dotcom %} ou do {% data variables.product.prodname_enterprise %}; - - Choose **Integrations** to pick an external editor or shell. + - Escolha **Integrações** para selecionar um editor externo ou shell. - Escolha **Git** para editar a configuração do Git; - - Choose **Appearance** to switch between the light or dark theme. + - Escolha **Aparência** para alternar entre o tema claro ou escuro. - Escolha **Advanced** (Avançado) para ver mais opções de configuração. diff --git a/translations/pt-BR/data/reusables/desktop/protected-branches.md b/translations/pt-BR/data/reusables/desktop/protected-branches.md index 6d587c2cc1c7..09536942b8b5 100644 --- a/translations/pt-BR/data/reusables/desktop/protected-branches.md +++ b/translations/pt-BR/data/reusables/desktop/protected-branches.md @@ -1 +1 @@ -Os administradores de repositório podem habilitar proteções em um branch. Se estiver trabalhando em um branch que é protegido, não será possível excluir nem forçar o push no branch. Repository administrators can enable other protected branch settings to enforce specific workflows before a branch can be merged. Para obter mais informações, consulte "[Sobre branches protegidos](/articles/about-protected-branches)". +Os administradores de repositório podem habilitar proteções em um branch. Se estiver trabalhando em um branch que é protegido, não será possível excluir nem forçar o push no branch. Os administradores de repositório podem ativar outras configurações protegidas de branch para aplicar fluxos de trabalho específicos antes que um branch possa ser mesclado. Para obter mais informações, consulte "[Sobre branches protegidos](/articles/about-protected-branches)". diff --git a/translations/pt-BR/data/reusables/desktop/push-origin.md b/translations/pt-BR/data/reusables/desktop/push-origin.md index 3a2b9f72ca37..bef02e3f4a97 100644 --- a/translations/pt-BR/data/reusables/desktop/push-origin.md +++ b/translations/pt-BR/data/reusables/desktop/push-origin.md @@ -1 +1 @@ -1. Click **Push origin** to push your local changes to the remote repository. ![Botão Push](/assets/images/help/desktop/push-origin-button.png) +1. Clique em **Carregar origem** para fazer push das suas alterações locais no repositório remoto. ![Botão Push](/assets/images/help/desktop/push-origin-button.png) diff --git a/translations/pt-BR/data/reusables/desktop/revert-commit.md b/translations/pt-BR/data/reusables/desktop/revert-commit.md index 6530e380b6ed..c58e2bfc55d1 100644 --- a/translations/pt-BR/data/reusables/desktop/revert-commit.md +++ b/translations/pt-BR/data/reusables/desktop/revert-commit.md @@ -1 +1 @@ -1. Clique com o botão direito no commit que você deseja reverter e clique em **Revert This Commit** (Reverter este commit). \ No newline at end of file +1. Clique com o botão direito no commit que você deseja reverter e clique em **Revert This Commit** (Reverter este commit). diff --git a/translations/pt-BR/data/reusables/desktop/select-base-branch.md b/translations/pt-BR/data/reusables/desktop/select-base-branch.md index 8ddc667622e6..2863ee6ab9c2 100644 --- a/translations/pt-BR/data/reusables/desktop/select-base-branch.md +++ b/translations/pt-BR/data/reusables/desktop/select-base-branch.md @@ -1 +1 @@ -1. Selecione o branch atual ou o branch padrão (normalmente, o mestre) no qual basear o novo branch. +1. Use o menu suspenso para escolher um branch de base para seu novo branch. diff --git a/translations/pt-BR/data/reusables/desktop/select-branch-to-delete.md b/translations/pt-BR/data/reusables/desktop/select-branch-to-delete.md index c7e39e90d80b..ef5031822c6e 100644 --- a/translations/pt-BR/data/reusables/desktop/select-branch-to-delete.md +++ b/translations/pt-BR/data/reusables/desktop/select-branch-to-delete.md @@ -1 +1 @@ -1. At the top of the app, click {% octicon "git-branch" aria-label="The branch icon" %} **Current Branch**, then click the branch that you want to delete. +1. Na parte superior do aplicativo, clique em {% octicon "git-branch" aria-label="The branch icon" %} **Branch atual** e, em seguida, clique no branch que você deseja excluir. diff --git a/translations/pt-BR/data/reusables/desktop/update-email-address.md b/translations/pt-BR/data/reusables/desktop/update-email-address.md index 0c148fc4d92a..979edcf0ae3f 100644 --- a/translations/pt-BR/data/reusables/desktop/update-email-address.md +++ b/translations/pt-BR/data/reusables/desktop/update-email-address.md @@ -1 +1 @@ -If the commits you make in {% data variables.product.prodname_desktop %} are associated with the wrong account on {% data variables.product.product_name %}, update the email address in your Git configuration using {% data variables.product.prodname_desktop %}. +Se os commits que você cria em {% data variables.product.prodname_desktop %} estiverem associados à conta errada no {% data variables.product.product_name %}, atualize o endereço de e-mail na configuração do Git usando {% data variables.product.prodname_desktop %}. diff --git a/translations/pt-BR/data/reusables/dotcom_billing/add-seats.md b/translations/pt-BR/data/reusables/dotcom_billing/add-seats.md index b71ea150aee4..6ae39accaaf9 100644 --- a/translations/pt-BR/data/reusables/dotcom_billing/add-seats.md +++ b/translations/pt-BR/data/reusables/dotcom_billing/add-seats.md @@ -1 +1 @@ -1. Use o menu suspenso **Edit** (Editar) e clique em **Add seats** (Adicionar estações). ![Menu suspenso de editar](/assets/images/help/billing/add-seats-dropdown.png) \ No newline at end of file +1. Use o menu suspenso **Edit** (Editar) e clique em **Add seats** (Adicionar estações). ![Menu suspenso de editar](/assets/images/help/billing/add-seats-dropdown.png) diff --git a/translations/pt-BR/data/reusables/dotcom_billing/confirm-add-seats.md b/translations/pt-BR/data/reusables/dotcom_billing/confirm-add-seats.md index 33ec081d9648..1cc7d2f15b60 100644 --- a/translations/pt-BR/data/reusables/dotcom_billing/confirm-add-seats.md +++ b/translations/pt-BR/data/reusables/dotcom_billing/confirm-add-seats.md @@ -1 +1 @@ -1. Clique em **Add seats** (Adicionar estações). ![Add seats button](/assets/images/help/billing/add-seats-button.png) \ No newline at end of file +1. Clique em **Add seats** (Adicionar estações). ![Botão de adicionar assentos](/assets/images/help/billing/add-seats-button.png) diff --git a/translations/pt-BR/data/reusables/dotcom_billing/number-of-seats.md b/translations/pt-BR/data/reusables/dotcom_billing/number-of-seats.md index ea308f2509f1..d68ad2d316a9 100644 --- a/translations/pt-BR/data/reusables/dotcom_billing/number-of-seats.md +++ b/translations/pt-BR/data/reusables/dotcom_billing/number-of-seats.md @@ -1 +1 @@ -1. Em "Add seats" (Adicionar estações), digite o número de estações que você deseja adicionar. ![Add seats input](/assets/images/help/billing/add-seats-amount.png) \ No newline at end of file +1. Em "Add seats" (Adicionar estações), digite o número de estações que você deseja adicionar. ![Entrada para adicionar estações](/assets/images/help/billing/add-seats-amount.png) diff --git a/translations/pt-BR/data/reusables/dotcom_billing/upgrade_org.md b/translations/pt-BR/data/reusables/dotcom_billing/upgrade_org.md index 0b9e4a326bb5..361fd13fc065 100644 --- a/translations/pt-BR/data/reusables/dotcom_billing/upgrade_org.md +++ b/translations/pt-BR/data/reusables/dotcom_billing/upgrade_org.md @@ -1 +1 @@ -1. Se você está atualizando a partir de {% data variables.product.prodname_free_team %}, clique em **Upgrade options** (Opções de atualização). Se você está atualizando a partir de {% data variables.product.prodname_team %}, use o menu suspenso **Edit** e clique em **Upgrade**. ![Botão de opções de atualização](/assets/images/help/billing/choose-monthly-or-yearly-billing.png) \ No newline at end of file +1. Se você está atualizando a partir de {% data variables.product.prodname_free_team %}, clique em **Upgrade options** (Opções de atualização). Se você está atualizando a partir de {% data variables.product.prodname_team %}, use o menu suspenso **Edit** e clique em **Upgrade**. ![Botão de opções de atualização](/assets/images/help/billing/choose-monthly-or-yearly-billing.png) diff --git a/translations/pt-BR/data/reusables/education/about-github-education-link.md b/translations/pt-BR/data/reusables/education/about-github-education-link.md index f12396f2363b..57cbdb535044 100644 --- a/translations/pt-BR/data/reusables/education/about-github-education-link.md +++ b/translations/pt-BR/data/reusables/education/about-github-education-link.md @@ -1 +1 @@ -Antes de solicitar um desconto individual, verifique se sua comunidade de estudos já não é nossa parceira como uma escola {% data variables.product.prodname_education %}. Para obter mais informações, consulte "[Sobre o {% data variables.product.prodname_education %}](https://education.github.com/partners/schools)". +Antes de solicitar um desconto individual, verifique se sua comunidade de estudos já não é nossa parceira como uma escola {% data variables.product.prodname_education %}. Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_education %}](https://education.github.com/partners/schools)". diff --git a/translations/pt-BR/data/reusables/enterprise-accounts/access-enterprise.md b/translations/pt-BR/data/reusables/enterprise-accounts/access-enterprise.md index d92c55351471..4bd1144960fb 100644 --- a/translations/pt-BR/data/reusables/enterprise-accounts/access-enterprise.md +++ b/translations/pt-BR/data/reusables/enterprise-accounts/access-enterprise.md @@ -1 +1,3 @@ -1. Acesse sua conta corporativa em `https://github.com/enterprises/ENTERPRISE-NAME`, substituindo `ENTERPRISE-NAME` pelo nome da sua conta corporativa. +1. No canto superior direito de {% data variables.product.product_name %}, clique na sua foto de perfil e, em seguida, clique em **Suas empresas**. !["Suas empresas" no menu suspenso para a foto do perfil no GitHub](/assets/images/help/enterprises/your-enterprises.png) + +1. Na lista de empresas, clique na empresa que você deseja visualizar. ![Nome de uma empresa na lista das suas empresas](/assets/images/help/enterprises/your-enterprises-list.png) diff --git a/translations/pt-BR/data/reusables/enterprise-accounts/administrators-tab.md b/translations/pt-BR/data/reusables/enterprise-accounts/administrators-tab.md index 8baa98ab1a21..7c0887df5a88 100644 --- a/translations/pt-BR/data/reusables/enterprise-accounts/administrators-tab.md +++ b/translations/pt-BR/data/reusables/enterprise-accounts/administrators-tab.md @@ -1 +1 @@ -1. Under "{% octicon "person" aria-label="The People icon" %} People", click **Administrators**. ![Administrators tab](/assets/images/help/business-accounts/business-accounts-admin-tab.png) +1. Em "Pessoas {% octicon "person" aria-label="The People icon" %}", clique em **Administradores**. ![Aba Administradores](/assets/images/help/business-accounts/business-accounts-admin-tab.png) diff --git a/translations/pt-BR/data/reusables/enterprise-accounts/audit-log-tab.md b/translations/pt-BR/data/reusables/enterprise-accounts/audit-log-tab.md index 29c6b1141a88..900fef885e76 100644 --- a/translations/pt-BR/data/reusables/enterprise-accounts/audit-log-tab.md +++ b/translations/pt-BR/data/reusables/enterprise-accounts/audit-log-tab.md @@ -1 +1 @@ -1. Under "{% octicon "gear" aria-label="The Settings gear" %} Settings", click **Audit log**. ![Audit log tab in the enterprise account sidebar](/assets/images/help/business-accounts/enterprise-account-settings-audit-log-tab.png) +1. Em "Configurações de {% octicon "gear" aria-label="The Settings gear" %}", clique em **Log de Auditoria**. ![Aba Log de auditoria na barra lateral da conta corporativa](/assets/images/help/business-accounts/enterprise-account-settings-audit-log-tab.png) diff --git a/translations/pt-BR/data/reusables/enterprise-accounts/hooks-tab.md b/translations/pt-BR/data/reusables/enterprise-accounts/hooks-tab.md index d27460a4c8af..e804a8807aa6 100644 --- a/translations/pt-BR/data/reusables/enterprise-accounts/hooks-tab.md +++ b/translations/pt-BR/data/reusables/enterprise-accounts/hooks-tab.md @@ -1 +1 @@ -1. Under "{% octicon "gear" aria-label="The Settings gear" %} Settings", click **Hooks**. ![Hooks tab in the enterprise account settings sidebar](/assets/images/help/business-accounts/settings-hooks-tab.png) +1. Em "Configurações de {% octicon "gear" aria-label="The Settings gear" %}", clique em **Hooks**. ![Aba Hooks na barra lateral de configurações da conta corporativa](/assets/images/help/business-accounts/settings-hooks-tab.png) diff --git a/translations/pt-BR/data/reusables/enterprise-accounts/messages-tab.md b/translations/pt-BR/data/reusables/enterprise-accounts/messages-tab.md index d7e05ecca4a9..0006044fcba5 100644 --- a/translations/pt-BR/data/reusables/enterprise-accounts/messages-tab.md +++ b/translations/pt-BR/data/reusables/enterprise-accounts/messages-tab.md @@ -1 +1 @@ -1. Under "{% octicon "gear" aria-label="The Settings gear" %} Settings", click **Messages**. ![Messages tab in the enterprise settings sidebar](/assets/images/enterprise/business-accounts/settings-messages-tab.png) +1. Under "{% octicon "gear" aria-label="The Settings gear" %} Settings", click **Messages**. ![Aba Mensagens na barra lateral de configurações corporativas](/assets/images/enterprise/business-accounts/settings-messages-tab.png) diff --git a/translations/pt-BR/data/reusables/enterprise-accounts/options-tab.md b/translations/pt-BR/data/reusables/enterprise-accounts/options-tab.md index 339d4a9958c4..2cc48285517d 100644 --- a/translations/pt-BR/data/reusables/enterprise-accounts/options-tab.md +++ b/translations/pt-BR/data/reusables/enterprise-accounts/options-tab.md @@ -1 +1 @@ -1. Under {% if currentVersion ver_gt "enterprise-server@2.21" %} {% octicon "law" aria-label="The law icon" %} **Policies**{% else %}"{% octicon "gear" aria-label="The Settings gear" %} Settings"{% endif %}, click **Options**. ![Options tab in the enterprise account settings sidebar](/assets/images/enterprise/business-accounts/settings-options-tab.png) +1. Em {% if currentVersion ver_gt "enterprise-server@2.21" %} {% octicon "law" aria-label="The law icon" %} **Políticas**{% else %}"{% octicon "gear" aria-label="The Settings gear" %} Configurações"{% endif %}, clique em **Opções**. ![Aba Opções na barra lateral de configurações da conta corporativa](/assets/images/enterprise/business-accounts/settings-options-tab.png) diff --git a/translations/pt-BR/data/reusables/enterprise-accounts/people-tab.md b/translations/pt-BR/data/reusables/enterprise-accounts/people-tab.md index 5365991fb768..36c51949c955 100644 --- a/translations/pt-BR/data/reusables/enterprise-accounts/people-tab.md +++ b/translations/pt-BR/data/reusables/enterprise-accounts/people-tab.md @@ -1 +1 @@ -1. In the enterprise account sidebar, click {% octicon "person" aria-label="The People icon" %} **People**. ![People tab in the enterprise account sidebar](/assets/images/help/business-accounts/business-account-people-tab.png) +1. Na barra lateral da conta corporativa, clique em {% octicon "person" aria-label="The People icon" %} **Pessoas**. ![Aba Pessoas na barra lateral da conta corporativa](/assets/images/help/business-accounts/business-account-people-tab.png) diff --git a/translations/pt-BR/data/reusables/enterprise-accounts/projects-tab.md b/translations/pt-BR/data/reusables/enterprise-accounts/projects-tab.md index 097cb4417d4b..5819ec8d9768 100644 --- a/translations/pt-BR/data/reusables/enterprise-accounts/projects-tab.md +++ b/translations/pt-BR/data/reusables/enterprise-accounts/projects-tab.md @@ -1 +1 @@ -1. In the left sidebar, click **Projects**. ![Projects tab in the enterprise account settings sidebar](/assets/images/help/business-accounts/settings-projects-tab.png) +1. Na barra lateral esquerda, clique em **Projetos**. ![Aba Projetos na barra lateral de configurações da conta corporativa](/assets/images/help/business-accounts/settings-projects-tab.png) diff --git a/translations/pt-BR/data/reusables/enterprise-accounts/security-tab.md b/translations/pt-BR/data/reusables/enterprise-accounts/security-tab.md index 30c8e2013782..f64a9bf3f7ae 100644 --- a/translations/pt-BR/data/reusables/enterprise-accounts/security-tab.md +++ b/translations/pt-BR/data/reusables/enterprise-accounts/security-tab.md @@ -1 +1 @@ -1. Na barra lateral esquerda, clique em **Security** (Segurança). ![Security tab in the enterprise account settings sidebar](/assets/images/help/business-accounts/enterprise-account-settings-security-tab.png) +1. Na barra lateral esquerda, clique em **Security** (Segurança). ![Aba Segurança na barra lateral de configurações da conta corporativa](/assets/images/help/business-accounts/enterprise-account-settings-security-tab.png) diff --git a/translations/pt-BR/data/reusables/enterprise/rate_limit.md b/translations/pt-BR/data/reusables/enterprise/rate_limit.md index 758b0fb6a362..3e86f46d9c2d 100644 --- a/translations/pt-BR/data/reusables/enterprise/rate_limit.md +++ b/translations/pt-BR/data/reusables/enterprise/rate_limit.md @@ -1,3 +1,4 @@ {% if currentVersion != "free-pro-team@latest" %} -Observe que os limites mencionados acima são os limites de taxa padrão para uma instância do {% data variables.product.prodname_ghe_server %}. Entre em contato com o administrador do site para confirmar se os limites de taxa estão habilitados e como eles estão configurados. +Observe que os limites mencionados acima são os limites de taxa padrão para um +instância de {% data variables.product.prodname_ghe_server %}. Entre em contato com o administrador do site para confirmar se os limites de taxa estão habilitados e como eles estão configurados. {% endif %} diff --git a/translations/pt-BR/data/reusables/enterprise/use-a-multiplexer.md b/translations/pt-BR/data/reusables/enterprise/use-a-multiplexer.md index fd66b6bb25a5..e16435515c23 100644 --- a/translations/pt-BR/data/reusables/enterprise/use-a-multiplexer.md +++ b/translations/pt-BR/data/reusables/enterprise/use-a-multiplexer.md @@ -1 +1 @@ -This command can take some time to finish, so we recommend running the command in a terminal multiplexer like `screen` or `tmux`. +Este comando pode levar algum tempo para terminar. Portanto, recomendamos executar o comando em um terminal multiplexer como `screen` ou `tmux`. diff --git a/translations/pt-BR/data/reusables/enterprise_clustering/apply-configuration.md b/translations/pt-BR/data/reusables/enterprise_clustering/apply-configuration.md index 9bded333a478..d814d2928a78 100644 --- a/translations/pt-BR/data/reusables/enterprise_clustering/apply-configuration.md +++ b/translations/pt-BR/data/reusables/enterprise_clustering/apply-configuration.md @@ -1,3 +1,3 @@ -1. Apply the new configuration. {% data reusables.enterprise.use-a-multiplexer %} +1. Aplique a nova configuração. {% data reusables.enterprise.use-a-multiplexer %} ghe-cluster-config-apply diff --git a/translations/pt-BR/data/reusables/enterprise_clustering/configuration-file-heading.md b/translations/pt-BR/data/reusables/enterprise_clustering/configuration-file-heading.md index 06b1491d9115..6ae6952cf82a 100644 --- a/translations/pt-BR/data/reusables/enterprise_clustering/configuration-file-heading.md +++ b/translations/pt-BR/data/reusables/enterprise_clustering/configuration-file-heading.md @@ -1 +1 @@ -The cluster configuration file lists each node under a [cluster "HOSTNAME"] heading. \ No newline at end of file +O arquivo de configuração do cluster lista cada nó em um cabeçalho de [cluster "HOSTNAME"]. diff --git a/translations/pt-BR/data/reusables/enterprise_clustering/configuration-finished.md b/translations/pt-BR/data/reusables/enterprise_clustering/configuration-finished.md index d20c300d4f8e..0a0d1c6e4b6e 100644 --- a/translations/pt-BR/data/reusables/enterprise_clustering/configuration-finished.md +++ b/translations/pt-BR/data/reusables/enterprise_clustering/configuration-finished.md @@ -1,5 +1,5 @@ -1. After the configuration run finishes, {% data variables.product.prodname_ghe_server %} displays the following message. +1. Após a conclusão da configuração executada, {% data variables.product.prodname_ghe_server %} exibe a mensagem a seguir. ```shell - Finished cluster configuration + Configuração de cluster concluída ``` diff --git a/translations/pt-BR/data/reusables/enterprise_clustering/key-value-pair-order-irrelevant.md b/translations/pt-BR/data/reusables/enterprise_clustering/key-value-pair-order-irrelevant.md index fb58841728ed..77033c5261d1 100644 --- a/translations/pt-BR/data/reusables/enterprise_clustering/key-value-pair-order-irrelevant.md +++ b/translations/pt-BR/data/reusables/enterprise_clustering/key-value-pair-order-irrelevant.md @@ -1 +1 @@ -The order of the key-value pairs doesn't matter. +A ordem dos pares chave-valor não importa. diff --git a/translations/pt-BR/data/reusables/enterprise_clustering/open-configuration-file.md b/translations/pt-BR/data/reusables/enterprise_clustering/open-configuration-file.md index 5b9182e5f41d..91eef696899b 100644 --- a/translations/pt-BR/data/reusables/enterprise_clustering/open-configuration-file.md +++ b/translations/pt-BR/data/reusables/enterprise_clustering/open-configuration-file.md @@ -1,3 +1,3 @@ -1. Open the cluster configuration file at _/data/user/common/cluster.conf_ in a text editor. Por exemplo, você pode usar o Vim. +1. Abra o arquivo de configuração do cluster em _/data/user/common/cluster.conf_ em um editor de texto. Por exemplo, você pode usar o Vim. sudo vim /data/user/common/cluster.conf diff --git a/translations/pt-BR/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md b/translations/pt-BR/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md index 854bf8f59c34..132d61ff339c 100644 --- a/translations/pt-BR/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md +++ b/translations/pt-BR/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md @@ -1,6 +1,6 @@ -1. Se você estiver substituindo o nó mestre MySQL ou o nó mestre Redis, no `cluster.conf`, modifique o valor `mysql-master` ou `redis-master` pelo nome do nó substituto. +1. Se você estiver substituindo o nó primário do MySQL ou Redis, no `cluster.conf`, modifique o valor de `mysql-master` ou `redis-master` com o nome do nó de substituição. - Por exemplo, este arquivo modificado `cluster.conf` especifica um nó de cluster recém-provisionado, `ghe-replacement-data-node-1` como o nó mestre MySQL e Redis: 
    +  Por exemplo, o arquivo `cluster.conf` modificado especifica um novo nó de cluster provisionado, `ghe-replacement-data-node-1` como o nó principal do MySQL e do Redis: 
       mysql-master = ghe-replacement-data-node-1
   redis-master = ghe-replacement-data-node-1
   
    
diff --git a/translations/pt-BR/data/reusables/enterprise_clustering/ssh-to-a-node.md b/translations/pt-BR/data/reusables/enterprise_clustering/ssh-to-a-node.md
index c1f540c45905..cf56f939b85c 100644
--- a/translations/pt-BR/data/reusables/enterprise_clustering/ssh-to-a-node.md
+++ b/translations/pt-BR/data/reusables/enterprise_clustering/ssh-to-a-node.md
@@ -1 +1 @@
-1. SSH into any node in your cluster. Para obter mais informações, consulte "[Acessar o shell administrativo (SSH)](/enterprise/admin/configuration/accessing-the-administrative-shell-ssh)".
+1. SSH em qualquer nó no seu cluster. Para obter mais informações, consulte "[Acessar o shell administrativo (SSH)](/enterprise/admin/configuration/accessing-the-administrative-shell-ssh)".
diff --git a/translations/pt-BR/data/reusables/enterprise_enterprise_support/submit-support-ticket-first-section.md b/translations/pt-BR/data/reusables/enterprise_enterprise_support/submit-support-ticket-first-section.md
index 869a4ca367b7..4ef8e862bdb4 100644
--- a/translations/pt-BR/data/reusables/enterprise_enterprise_support/submit-support-ticket-first-section.md
+++ b/translations/pt-BR/data/reusables/enterprise_enterprise_support/submit-support-ticket-first-section.md
@@ -4,13 +4,15 @@
     - Etapas para reproduzir o problema
     - Quaisquer circunstâncias especiais relacionadas à descoberta do problema (como a primeira ocorrência ou ocorrência após um evento específico, frequência de ocorrência, impacto comercial do problema e urgência sugerida)
     - Redação exata das mensagens de erro
-1. No menu suspenso do Produto {% data variables.product.prodname_enterprise %} selecione {% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_ghe_cloud %}{% else %}{% data variables.product.prodname_ghe_server %}{% endif %}. ![Menu suspenso Priority (Prioridade)](/assets/images/enterprise/support/support-ticket-ghe-product.png)
-1. No menu suspenso "Priority" (Prioridade), selecione a urgência apropriada. Para obter mais informações, consulte "[Assigning a priority to a support ticket]{% if currentVersion == "free-pro-team@latest" %}(/articles/about-github-premium-support-for-github-enterprise-cloud#assigning-a-priority-to-a-support-ticket){% else %}(/enterprise/admin/guides/enterprise-support/about-github-enterprise-support#assigning-a-priority-to-a-support-ticket){% endif %}." ![Menu suspenso Priority (Prioridade)](/assets/images/enterprise/support/support-ticket-priority.png)
-    - Escolha **{% data variables.product.support_ticket_priority_urgent %}** para relatar {% if currentVersion == "free-pro-team@latest" %}falhas críticas do sistema{% else %}falhas fatais do sistema, interrupções impactando operações críticas do sistema, incidentes de segurança e licenças expiradas{% endif %}.
-    - Escolha **{% data variables.product.support_ticket_priority_high %}** para relatar problemas que afetam as operações de negócios, incluindo {% if currentVersion == "free-pro-team@latest" %}removendo dados confidenciais (commits, issues, pull requests, anexos carregados) de suas próprias contas e restaurações da organização{% else %}problemas de desempenho do sistema{% endif %}ou para relatar erros críticos.
+1. No menu suspenso de produtos de {% data variables.product.prodname_enterprise %}, selecione {% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_ghe_cloud %}{% else %}{% data variables.product.prodname_ghe_server %}{% endif %}. ![Menu suspenso Priority (Prioridade)](/assets/images/enterprise/support/support-ticket-ghe-product.png)
+1. No menu suspenso "Priority" (Prioridade), selecione a urgência apropriada. Para obter mais informações, consulte "[Atribuir uma prioridade a um tíquete de suporte]{% if currentVersion == "free-pro-team@latest" %}(/articles/about-github-premium-support-for-github-enterprise-cloud#assigning-a-priority-to-a-support-ticket){% else %}(/enterprise/admin/guides/enterprise-support/about-github-enterprise-support#assigning-a-priority-to-support-ticket){% endif %}." ![Menu suspenso Priority (Prioridade)](/assets/images/enterprise/support/support-ticket-priority.png)
+    - Escolha **{% data variables.product.support_ticket_priority_urgent %}** para relatar {% if currentVersion == "free-pro-team@latest" %}uma falha crítica do sistema{% else %}falhas fatais do sistema, interrupções que afetam as operações críticas do sistema, incidentes de segurança e licenças expiradas{% endif %}.
+    - Escolha **{% data variables.product.support_ticket_priority_high %}** para relatar problemas que afetam as operações de negócio, incluindo {% if currentVersion == "free-pro-team@latest" %}a remoção de dados confidenciais (commits, problemas, pull requests, anexos enviados) das suas próprias contas e restaurações de organização{% else %}problemas de desempenho do sistema{% endif %}ou para relatar erros críticos.
     - Escolha **{% data variables.product.support_ticket_priority_normal %}** para {% if currentVersion == "free-pro-team@latest" %}solicitar recuperação de conta ou remoção de sinalizador de spam, relatar problemas de login do usuário{% else %}fazer solicitações técnicas, como alterações de configuração e integrações de terceiros{% endif %}e para relatar erros não críticos.
-    - Escolha **{% data variables.product.support_ticket_priority_low %}** para fazer perguntas gerais e enviar solicitações para novos recursos, compras, treinamentos ou check-ups do ambiente de segurança de Ti.{% if currentVersion != "free-pro-team@latest" %}
-1. No menú suspenso "{% data variables.product.prodname_enterprise %} Series" selecione a versão do {% data variables.product.prodname_ghe_server %} que você está usando. ![{% data variables.product.prodname_enterprise %} Series drop-down menu](/assets/images/enterprise/support/support-ticket-ghes-series.png)
+    - Escolha **{% data variables.product.support_ticket_priority_low %}** para fazer perguntas gerais e enviar solicitações para novos recursos, compras, treinamentos ou verificações de integridade.{% if currentVersion != "free-pro-team@latest" %}
+1. No "
+menu suspenso séries de {% data variables.product.prodname_enterprise %}", selecione a versão de {% data variables.product.prodname_ghe_server %} que você está usando.
+  ![{% data variables.product.prodname_enterprise %} Series drop-down menu](/assets/images/enterprise/support/support-ticket-ghes-series.png)
 {% endif %}
 1. No menu suspenso "Global Region" (Região global), selecione APAC (Asia Pacific), EMEA (Europa, Médio Oriente e África), ou Américas como sua região. ![Menu suspenso Global Region (Região global)](/assets/images/enterprise/support/support-ticket-global-region.png)
 1. Clique em **Add file** (Adicionar arquivo), anexe o arquivo de diagnóstico que você fez o download para incluir os diagnósticos com seu ticket de suporte. ![Botão Add file (Adicionar arquivo)](/assets/images/enterprise/support/support-ticket-add-file.png)
diff --git a/translations/pt-BR/data/reusables/enterprise_enterprise_support/submit-support-ticket-second-section.md b/translations/pt-BR/data/reusables/enterprise_enterprise_support/submit-support-ticket-second-section.md
index 85eb9b9dd146..ba34269b0d7c 100644
--- a/translations/pt-BR/data/reusables/enterprise_enterprise_support/submit-support-ticket-second-section.md
+++ b/translations/pt-BR/data/reusables/enterprise_enterprise_support/submit-support-ticket-second-section.md
@@ -1,4 +1,5 @@
 1. Clique em **Enviar**.
 
 {% if currentVersion != "free-pro-team@latest" %}
-Se você escolheu não incluir os diagnósticos com seu ticket de suporte, você pode compartilhar informações de diagnóstico com o suporte do {% data variables.product.prodname_enterprise %} depois de enviar sua solicitação de suporte. Para obter mais informações, consulte "[Providing data to {% data variables.product.prodname_dotcom %} Support](/enterprise/admin/guides/enterprise-support/providing-data-to-github-support)."{% endif %}
+Se você escolheu não incluir diagnósticos no seu tíquete de suporte, você pode compartilhar informações de diagnóstico com
+suporte de {% data variables.product.prodname_enterprise %} após enviar a sua solicitação de suporte. Para obter mais informações, consulte "[Providing data to {% data variables.product.prodname_dotcom %} Support](/enterprise/admin/guides/enterprise-support/providing-data-to-github-support)."{% endif %}
diff --git a/translations/pt-BR/data/reusables/enterprise_installation/aws-supported-instance-types.md b/translations/pt-BR/data/reusables/enterprise_installation/aws-supported-instance-types.md
index 4b7a6fa650d5..5e30521f31d6 100644
--- a/translations/pt-BR/data/reusables/enterprise_installation/aws-supported-instance-types.md
+++ b/translations/pt-BR/data/reusables/enterprise_installation/aws-supported-instance-types.md
@@ -28,10 +28,9 @@
 | --------------------- | -------------------------------------------------------------------- |
 | R4                    | r4.large, r4.xlarge, r4.2xlarge, r4.4xlarge, r4.8xlarge, r4.16xlarge |
 
-| Tipo de instância EC2 | Modelo                                                                |
-| --------------------- | --------------------------------------------------------------------- |
-| R5                    | r5.large, r5.xlarge, r5.2xlarge, r5.4xlarge, r5.12xlarge, r5.24xlarge |
-
+| Tipo de instância EC2 | Modelo                                                                                                                                                                                                                                                                                                                                         |
+| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| R5                    | r5.large, r5.xlarge, r5.2xlarge, r5.4xlarge, r5.12xlarge, r5.24xlarge{% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.19" %}, r5n.large, r5n.xlarge, r5n.2xlarge, r5n.4xlarge, r5n.12xlarge, r5n.24xlarge, r5a.large, r5a.xlarge, r5a.2xlarge, r5a.4xlarge, r5a.12xlarge, r5a.24xlarge{% endif %}
 
 | Tipo de instância EC2 | Modelo                   |
 | --------------------- | ------------------------ |
diff --git a/translations/pt-BR/data/reusables/enterprise_installation/command-line-utilities-ghe-upgrade-rollback.md b/translations/pt-BR/data/reusables/enterprise_installation/command-line-utilities-ghe-upgrade-rollback.md
index 7d91db5de219..45d4c2921537 100644
--- a/translations/pt-BR/data/reusables/enterprise_installation/command-line-utilities-ghe-upgrade-rollback.md
+++ b/translations/pt-BR/data/reusables/enterprise_installation/command-line-utilities-ghe-upgrade-rollback.md
@@ -4,4 +4,4 @@ Ao reverter uma atualização, você deve usar um arquivo de atualização com a
 ghe-upgrade --allow-patch-rollback EARLIER-RELEASE-UPGRADE-PACKAGE.pkg
 ```
 
-A reboot is required after running the command. Reverter não afeta a partição de dados, pois as migrações não são executadas nas versões de patch.
+É necessário reinicializar após a execução do comando. Reverter não afeta a partição de dados, pois as migrações não são executadas nas versões de patch.
diff --git a/translations/pt-BR/data/reusables/enterprise_installation/hardware-considerations-all-platforms.md b/translations/pt-BR/data/reusables/enterprise_installation/hardware-considerations-all-platforms.md
index 980e0635d0d9..20aa4113a8ca 100644
--- a/translations/pt-BR/data/reusables/enterprise_installation/hardware-considerations-all-platforms.md
+++ b/translations/pt-BR/data/reusables/enterprise_installation/hardware-considerations-all-platforms.md
@@ -1,55 +1,55 @@
-- [Minimum requirements](#minimum-requirements)
+- [Requisitos mínimos](#minimum-requirements)
 - [Armazenamento](#storage)
-- [CPU and memory](#cpu-and-memory)
+- [CPU e memória](#cpu-and-memory)
 
-#### Minimum requirements
+#### Requisitos mínimos
 
-We recommend different hardware configurations depending on the number of user licenses for {% data variables.product.product_location_enterprise %}. If you provision more resources than the minimum requirements, your instance will perform and scale better.
+Recomendamos diferentes configurações de hardware, dependendo do número de licenças de usuário para {% data variables.product.product_location_enterprise %}. Se você fornecer mais recursos do que os requisitos mínimos, sua instância terá um desempenho e uma escala melhores.
 
-{% data reusables.enterprise_installation.hardware-rec-table %} For more information about adjusting resources for an existing instance, see "[Increasing storage capacity](/enterprise/admin/installation/increasing-storage-capacity)" and "[Increasing CPU or memory resources](/enterprise/admin/installation/increasing-cpu-or-memory-resources)."
+{% data reusables.enterprise_installation.hardware-rec-table %} Para obter mais informações sobre o ajuste de recursos para uma instância existente, consulte "[aumentar a capacidade de armazenamento](/enterprise/admin/installation/increasing-storage-capacity)" e "[aumentar recursos de CPU ou memória](/enterprise/admin/installation/increasing-cpu-or-memory-resources)".
 
 {% if currentVersion == "enterprise-server@2.22" %}
 
-If you enable the beta for {% data variables.product.prodname_actions %} on your instance, we recommend planning for additional capacity.
+Se você habilitar o beta para {% data variables.product.prodname_actions %} na sua instância, recomendamos que você planeje uma capacidade adicional.
 
-- You must configure at least one runner for {% data variables.product.prodname_actions %} workflows. Para obter mais informações, consulte "[Sobre os executores auto-hospedados](/actions/hosting-your-own-runners/about-self-hosted-runners)."
-- You must configure external blob storage. Para obter mais informações, consulte "[Habilitar {% data variables.product.prodname_actions %} e configurar o armazenamento](/enterprise/admin/github-actions/enabling-github-actions-and-configuring-storage)".
+- Você deve configurar pelo menos um executor para fluxos de trabalho de {% data variables.product.prodname_actions %}. Para obter mais informações, consulte "[Sobre os executores auto-hospedados](/actions/hosting-your-own-runners/about-self-hosted-runners)."
+- Você deve configurar o armazenamento externo do blob. Para obter mais informações, consulte "[Habilitar {% data variables.product.prodname_actions %} e configurar o armazenamento](/enterprise/admin/github-actions/enabling-github-actions-and-configuring-storage)".
 
-The additional CPU and memory resources you need to provision for your instance depend on the number of workflows your users run concurrently, and the overall levels of activity for users, automations, and integrations.
+Os recursos adicionais de CPU e memória que você precisa fornecer para a sua instância dependem do número de fluxos de trabalho que os seus usuários executam simultaneamente e dos níveis gerais de atividade para usuários, automações, e integrações.
 
-| Maximum jobs per minute | vCPUs | Memória |
-|:----------------------- | -----:| -------:|
-| Light testing           |     4 | 30.5 GB |
-| 25                      |     8 |   61 GB |
-| 35                      |    16 |  122 GB |
-| 100                     |    32 |  244 GB |
+| Máximo de trabalhos por minuto | vCPUs | Memória |
+|:------------------------------ | -----:| -------:|
+| Testes rápidos                 |     4 | 30.5 GB |
+| 25                             |     8 |   61 GB |
+| 35                             |    16 |  122 GB |
+| 100                            |    32 |  244 GB |
 
 {% endif %}
 
 #### Armazenamento
 
-We recommend a high-performance SSD with high input/output operations per second (IOPS) and low latency for {% data variables.product.prodname_ghe_server %}. Workloads are I/O intensive. If you use a bare metal hypervisor, we recommend directly attaching the disk or using a disk from a storage area network (SAN).
+Recomendamos um SSD de alto desempenho com operações de alta entrada/saída por segundo (IOPS) e baixa latência para {% data variables.product.prodname_ghe_server %}. Cargas de trabalho são intensivas em I/O. Se você usar um hipervisor de metal simples, recomendamos anexar diretamente o disco ou usar um disco a partir de uma rede de área de armazenamento (SAN).
 
-Your instance requires a persistent data disk separate from the root disk. Para obter mais informações, consulte "[System overview](/enterprise/admin/guides/installation/system-overview)."
+A sua instância exige um disco de dados persistente separado do disco raiz. Para obter mais informações, consulte "[System overview](/enterprise/admin/guides/installation/system-overview)."
 
 {% if currentVersion ver_gt "enterprise-server@2.21" %}
 
-If you enable the beta of {% data variables.product.prodname_actions %} in {% data variables.product.prodname_ghe_server %} 2.22, you'll need to configure external blob storage. Para obter mais informações, consulte "[Habilitar {% data variables.product.prodname_actions %} e configurar o armazenamento](/enterprise/admin/github-actions/enabling-github-actions-and-configuring-storage)".
+Se você habilitar o beta de {% data variables.product.prodname_actions %} em {% data variables.product.prodname_ghe_server %} 2.22, você precisará configurar o armazenamento externo do blob. Para obter mais informações, consulte "[Habilitar {% data variables.product.prodname_actions %} e configurar o armazenamento](/enterprise/admin/github-actions/enabling-github-actions-and-configuring-storage)".
 
 {% endif %}
 
-You can resize your instance's root disk by building a new instance or using an existing instance. Para obter mais informações, consulte "[Increasing storage capacity](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity)."
+Você pode redimensionar o disco raiz da sua instância criando uma nova instância ou usando uma instância existente. Para obter mais informações, consulte "[Increasing storage capacity](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity)."
 
-#### CPU and memory
+#### CPU e memória
 
-{% data variables.product.prodname_ghe_server %} requires more CPU and memory resources depending on levels of activity for users, automations, and integrations.
+O {% data variables.product.prodname_ghe_server %} exige mais recursos de CPU e memória, dependendo dos níveis de atividade para usuários, automações e integrações.
 
 {% data reusables.enterprise_installation.increasing-cpus-req %}
 
 {% warning %}
 
-**Warning:** We recommend that users configure webhook events to notify external systems of activity on {% data variables.product.prodname_ghe_server %}. Automated checks for changes, or _polling_, will negatively impact the performance and scalability of your instance. For more information, see "[About webhooks](/github/extending-github/about-webhooks)."
+**Aviso:** Recomendamos que os usuários configurem eventos de webhook para notificar sistemas de atividade externos em {% data variables.product.prodname_ghe_server %}. Verificações automatizadas por alterações, ou _sondagem_, afetarão negativamente o desempenho e escalabilidade da sua instância. Para obter mais informações, consulte "[Sobre webhooks](/github/extending-github/about-webhooks)".
 
 {% endwarning %}
 
-You can increase your instance's CPU or memory resources. Para obter mais informações, consulte "[Increasing CPU or memory resources](/enterprise/admin/installation/increasing-cpu-or-memory-resources).
+Você pode aumentar os recursos de memória ou da CPU na sua instância. Para obter mais informações, consulte "[Increasing CPU or memory resources](/enterprise/admin/installation/increasing-cpu-or-memory-resources).
diff --git a/translations/pt-BR/data/reusables/enterprise_installation/hardware-rec-table.md b/translations/pt-BR/data/reusables/enterprise_installation/hardware-rec-table.md
index e9bb39c00c29..99ef1b03475f 100644
--- a/translations/pt-BR/data/reusables/enterprise_installation/hardware-rec-table.md
+++ b/translations/pt-BR/data/reusables/enterprise_installation/hardware-rec-table.md
@@ -1,16 +1,16 @@
 {% if currentVersion == "enterprise-server@2.22" %}
 
-Minimum requirements for an instance with beta features enabled are **bold** in the following table. For more information, see "[Beta features in {% data variables.product.prodname_ghe_server %} 2.22](#beta-features-in-github-enterprise-server-222)." |{% endif %}
-| Licenças de usuário                      |                                                                                                              vCPUs |                                                                                                                    Memória |                                                                                                      Armazenamento anexado | Armazenamento raiz |
-|:---------------------------------------- | ------------------------------------------------------------------------------------------------------------------:| --------------------------------------------------------------------------------------------------------------------------:| --------------------------------------------------------------------------------------------------------------------------:| ------------------:|
-| Teste, demonstração ou 10 usuários leves |   2{% if currentVersion == "enterprise-server@2.22" %}
    or [**4**](#beta-features-in-github-enterprise-server-222){% endif %} |   16 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**32 GB**](#beta-features-in-github-enterprise-server-222){% endif %} | 100 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**150 GB**](#beta-features-in-github-enterprise-server-222){% endif %} |             200 GB |
-| 10-3000                                  |   4{% if currentVersion == "enterprise-server@2.22" %}
    or [**8**](#beta-features-in-github-enterprise-server-222){% endif %} |   32 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**48 GB**](#beta-features-in-github-enterprise-server-222){% endif %} | 250 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**300 GB**](#beta-features-in-github-enterprise-server-222){% endif %} |             200 GB |
-| 3000-5000                                |  8{% if currentVersion == "enterprise-server@2.22" %}
    or [**12**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                      64 GB |                                                                                                                     500 GB |             200 GB |
-| 5000-8000                                | 12{% if currentVersion == "enterprise-server@2.22" %}
    or [**16**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                      96 GB |                                                                                                                     750 GB |             200 GB |
-| 8000-10000+                              | 16{% if currentVersion == "enterprise-server@2.22" %}
    or [**20**](#beta-features-in-github-enterprise-server-222){% endif %} | 128 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**160 GB**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                    1000 GB |             200 GB |
+Os requisitos mínimos para uma instância com recursos beta habilitados estão em **negrito** na tabela a seguir. Para obter mais informações, consulte "[Recursos Beta em {% data variables.product.prodname_ghe_server %} 2.22](#beta-features-in-github-enterprise-server-222)". |{% endif %}
+| Licenças de usuário                      |                                                                                                                                  vCPUs |                                                                                                                                        Memória |                                                                                                                          Armazenamento anexado | Armazenamento raiz |
+|:---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------:| ------------------:|
+| Teste, demonstração ou 10 usuários leves |   2{% if currentVersion == "enterprise-server@2.22" %}
    ou [**4**](#beta-features-in-github-enterprise-server-222){% endif %} |   16 GB{% if currentVersion == "enterprise-server@2.22" %}
    ou [**32 GB**](#beta-features-in-github-enterprise-server-222){% endif %} | 100 GB{% if currentVersion == "enterprise-server@2.22" %}
    ou [**150 GB**](#beta-features-in-github-enterprise-server-222){% endif %} |             200 GB |
+| 10-3000                                  |   4{% if currentVersion == "enterprise-server@2.22" %}
    ou [**8**](#beta-features-in-github-enterprise-server-222){% endif %} |   32 GB{% if currentVersion == "enterprise-server@2.22" %}
    ou [**48 GB**](#beta-features-in-github-enterprise-server-222){% endif %} | 250 GB{% if currentVersion == "enterprise-server@2.22" %}
    ou [**300 GB**](#beta-features-in-github-enterprise-server-222){% endif %} |             200 GB |
+| 3000-5000                                |  8{% if currentVersion == "enterprise-server@2.22" %}
    ou [**12**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                                          64 GB |                                                                                                                                         500 GB |             200 GB |
+| 5000-8000                                | 12{% if currentVersion == "enterprise-server@2.22" %}
    ou [**16**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                                          96 GB |                                                                                                                                         750 GB |             200 GB |
+| 8000-10000+                              | 16{% if currentVersion == "enterprise-server@2.22" %}
    ou [**20**](#beta-features-in-github-enterprise-server-222){% endif %} | 128 GB{% if currentVersion == "enterprise-server@2.22" %}
    ou [**160 GB**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                                        1000 GB |             200 GB |
 
 {% if currentVersion == "enterprise-server@2.22" %}
 
-#### Beta features in {% data variables.product.prodname_ghe_server %} 2.22
+#### Recursos do beta em {% data variables.product.prodname_ghe_server %} 2.22
 
-If you enable beta features in {% data variables.product.prodname_ghe_server %} 2.22, your instance requires additional hardware resources. For more information about the beta features, see the [release notes for the 2.22 series](https://enterprise.github.com/releases/series/2.22) on the {% data variables.product.prodname_enterprise %} website.{% endif %}
+Se você habilitar os recursos beta em {% data variables.product.prodname_ghe_server %} 2.22, a sua instância exigirá recursos adicionais de hardware. Para obter mais informações sobre os recursos beta, consulte as [notas de versão para as séries 2.22](https://enterprise.github.com/releases/series/2.22) no site de {% data variables.product.prodname_enterprise %} .{% endif %}
diff --git a/translations/pt-BR/data/reusables/enterprise_installation/increasing-cpus-req.md b/translations/pt-BR/data/reusables/enterprise_installation/increasing-cpus-req.md
index 92562eddd24c..d72212faf336 100644
--- a/translations/pt-BR/data/reusables/enterprise_installation/increasing-cpus-req.md
+++ b/translations/pt-BR/data/reusables/enterprise_installation/increasing-cpus-req.md
@@ -1 +1 @@
-When you increase CPU resources, we recommend adding at least 6.5 GB of memory for each vCPU (up to 16 vCPUs) that you provision for the instance. When you use more than 16 vCPUs, you don't need to add 6.5 GB of memory for each vCPU, but you should monitor your instance to ensure it has enough memory.
+Quando você aumenta os recursos da CPU, recomendamos adicionar pelo menos 6.5 GB de memória para cada vCPU (até 16 vCPUs) que você fornecer para a instância. Ao usar mais de 16 vCPUs, você não precisa adicionar 6.5 GB de memória para cada vCPU, mas você deve monitorar sua instância para garantir que ela tenha memória suficiente.
diff --git a/translations/pt-BR/data/reusables/enterprise_installation/necessary_ports.md b/translations/pt-BR/data/reusables/enterprise_installation/necessary_ports.md
index 98c15b84d129..d3b18aa76dbe 100644
--- a/translations/pt-BR/data/reusables/enterprise_installation/necessary_ports.md
+++ b/translations/pt-BR/data/reusables/enterprise_installation/necessary_ports.md
@@ -1,12 +1,12 @@
-| Porta    | Serviço | Descrição                                                                                                                                                   |
-| -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| 22       | SSH     | Git sobre acesso via SSH. Clone, buscar e fazer push de operações para repositórios público/privado suportados.                                             |
-| 25       | SMTP    | Suporte a SMTP com criptografia (STARTTLS).                                                                                                                 |
-| 80       | HTTP    | Acesso ao aplicativo web. *Todas as solicitações são redirecionadas para a porta HTTPS quando o SSL estiver habilitado.*                                    |
-| 122      | SSH     | Exemplo de acesso a shell. *A porta SSH padrão (22) é dedicada ao tráfego de rede git+ssh.*                                                                 |
-| 161/UDP  | SNMP    | Obrigatória para operações de protocolo de monitoramento de rede.                                                                                           |
-| 443      | HTTPS   | Aplicativo web e Git sobre acesso HTTPS.                                                                                                                    |
-| 1194/UDP | VPN     | Túnel de rede de réplica segura na configuração de alta disponibilidade.                                                                                    |
-| 8080     | HTTP    | Baseado em web de texto simples {% data variables.enterprise.management_console %}. *Não é necessário, a menos que o SSL seja desativado manualmente.* |
-| 8443     | HTTPS   | Base segura na web {% data variables.enterprise.management_console %}. *Necessário para instalação básica e configuração.*                             |
-| 9418     | Git     | Porta de protocolo Simples Git. Clonar e buscar somente as operações para repositórios públicos. *Comunicação sem criptografia de rede.*                    |
+| Porta    | Serviço | Descrição                                                                                                                                                                                               |
+| -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 22       | SSH     | Git sobre acesso via SSH. Clone, buscar e fazer push de operações para repositórios público/privado suportados.                                                                                         |
+| 25       | SMTP    | Suporte a SMTP com criptografia (STARTTLS).                                                                                                                                                             |
+| 80       | HTTP    | Acesso ao aplicativo web. *Todas as solicitações são redirecionadas para a porta HTTPS quando o SSL estiver habilitado.*                                                                                |
+| 122      | SSH     | Exemplo de acesso a shell. *A porta SSH padrão (22) é dedicada ao tráfego de rede git+ssh.*                                                                                                             |
+| 161/UDP  | SNMP    | Obrigatória para operações de protocolo de monitoramento de rede.                                                                                                                                       |
+| 443      | HTTPS   | Aplicativo web e Git sobre acesso HTTPS.                                                                                                                                                                |
+| 1194/UDP | VPN     | Túnel de rede de réplica segura na configuração de alta disponibilidade.                                                                                                                                |
+| 8080     | HTTP    | Baseado em web de texto simples {% data variables.enterprise.management_console %}. *Não é necessário, a menos que o SSL seja desativado manualmente.*                                                  |
+| 8443     | HTTPS   | Base segura na web {% data variables.enterprise.management_console %}. *Necessário para instalação básica e configuração.*                                                                              |
+| 9418     | Git     | Porta de protocolo Simples Git. Clonar e buscar somente as operações para repositórios públicos. *Comunicação de rede não encriptada.* {% data reusables.enterprise_installation.when-9418-necessary %}
diff --git a/translations/pt-BR/data/reusables/enterprise_installation/when-9418-necessary.md b/translations/pt-BR/data/reusables/enterprise_installation/when-9418-necessary.md
new file mode 100644
index 000000000000..aba9b504b3f0
--- /dev/null
+++ b/translations/pt-BR/data/reusables/enterprise_installation/when-9418-necessary.md
@@ -0,0 +1 @@
+Se você habilitou o modo privado na sua instância, abrir esta porta só é necessário se você também habilitou o acesso de leitura anônimo do Git. Para obter mais informações, consulte "[Aplicar políticas de gerenciamento do repositório na sua empresa](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#configuring-anonymous-git-read-access)".
\ No newline at end of file
diff --git a/translations/pt-BR/data/reusables/enterprise_management_console/badge_indicator.md b/translations/pt-BR/data/reusables/enterprise_management_console/badge_indicator.md
index 0fe969700a8e..279c5c6f9be6 100644
--- a/translations/pt-BR/data/reusables/enterprise_management_console/badge_indicator.md
+++ b/translations/pt-BR/data/reusables/enterprise_management_console/badge_indicator.md
@@ -1 +1 @@
-Uma equipe que está [synced to an LDAP group](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#enabling-ldap-sync) é indicada com um emblema LDAP especial. A lista de membros de uma equipe sincronizada com LDAP só pode ser gerenciada a partir do grupo LDAP que está mapeado.
+Uma equipe que está [synced to an LDAP group](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#enabling-ldap-sync) é indicada com um emblema LDAP especial. A lista de membros de uma equipe sincronizada com LDAP só pode ser gerenciada a partir do grupo LDAP que está mapeado.
diff --git a/translations/pt-BR/data/reusables/enterprise_management_console/enable-disable-code-scanning.md b/translations/pt-BR/data/reusables/enterprise_management_console/enable-disable-code-scanning.md
index a6adf2088eba..5d4d5f1e6943 100644
--- a/translations/pt-BR/data/reusables/enterprise_management_console/enable-disable-code-scanning.md
+++ b/translations/pt-BR/data/reusables/enterprise_management_console/enable-disable-code-scanning.md
@@ -1,5 +1,5 @@
 {% warning %}
 
-**Warning**: Changing this setting will cause {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_ghe_server %}{% else %}{% data variables.product.prodname_dotcom %}{% endif %} to restart. You should time this change carefully, to minimize downtime.
+**Aviso**: Mudar esta configuração fará com que{% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_ghe_server %}{% else %}{% data variables.product.prodname_dotcom %}{% endif %} seja reiniciado. Você deve programar essa mudança com cuidado para minimizar o tempo de inatividade.
 
 {% endwarning %}
diff --git a/translations/pt-BR/data/reusables/enterprise_site_admin_settings/admin-top-tab.md b/translations/pt-BR/data/reusables/enterprise_site_admin_settings/admin-top-tab.md
index 4ed6f98977f7..70c99a12812b 100644
--- a/translations/pt-BR/data/reusables/enterprise_site_admin_settings/admin-top-tab.md
+++ b/translations/pt-BR/data/reusables/enterprise_site_admin_settings/admin-top-tab.md
@@ -1 +1 @@
-1. In the upper-right corner of the page, click {% octicon "gear" %} **Admin**. ![Ferramentas Administrativas](/assets/images/enterprise/site-admin-settings/user/user-admin-tab-top.png)
+1. No canto superior direito da página, clique em {% octicon "gear" %} **Admin**. ![Ferramentas Administrativas](/assets/images/enterprise/site-admin-settings/user/user-admin-tab-top.png)
diff --git a/translations/pt-BR/data/reusables/enterprise_site_admin_settings/business.md b/translations/pt-BR/data/reusables/enterprise_site_admin_settings/business.md
index cf73777bb966..c2449130becc 100644
--- a/translations/pt-BR/data/reusables/enterprise_site_admin_settings/business.md
+++ b/translations/pt-BR/data/reusables/enterprise_site_admin_settings/business.md
@@ -1 +1 @@
-1. In the left sidebar, click **Enterprise**. ![Enterprise tab in the Site admin settings](/assets/images/enterprise/site-admin-settings/enterprise-tab.png)
+1. Na barra lateral esquerda, clique em **Empresa{% if currentVersion ver_gt "enterprise-server@2.21" %} visão geral{% endif %}**. ![Empresa{% if currentVersion ver_gt "enterprise-server@2.21" %} aba visão geral{% endif %} nas configurações de administrador do Site](/assets/images/enterprise/site-admin-settings/enterprise-tab.png)
diff --git a/translations/pt-BR/data/reusables/enterprise_site_admin_settings/packages-tab.md b/translations/pt-BR/data/reusables/enterprise_site_admin_settings/packages-tab.md
index 7552439d3d6c..683179cc027b 100644
--- a/translations/pt-BR/data/reusables/enterprise_site_admin_settings/packages-tab.md
+++ b/translations/pt-BR/data/reusables/enterprise_site_admin_settings/packages-tab.md
@@ -1 +1 @@
-1. In the left sidebar, click **Packages**. ![Packages tab in management console sidebar](/assets/images/enterprise/site-admin-settings/management-console-packages-tab.png)
\ No newline at end of file
+1. Na barra lateral esquerda, clique em **Pacotes**. ![Aba Pacotes na barra lateral de console de gerenciamento](/assets/images/enterprise/site-admin-settings/management-console-packages-tab.png)
diff --git a/translations/pt-BR/data/reusables/enterprise_user_management/manage-global-webhooks-api.md b/translations/pt-BR/data/reusables/enterprise_user_management/manage-global-webhooks-api.md
index 85e457a40d3b..b679d7b0878c 100644
--- a/translations/pt-BR/data/reusables/enterprise_user_management/manage-global-webhooks-api.md
+++ b/translations/pt-BR/data/reusables/enterprise_user_management/manage-global-webhooks-api.md
@@ -1 +1 @@
-Você também pode usar {% data variables.product.prodname_enterprise_api %} para gerenciar webhooks globais. Para obter uma lista completa de ações, consulte "[Webhooks](/v3/enterprise-admin/global_webhooks)."
+Você também pode usar {% data variables.product.prodname_enterprise_api %} para gerenciar webhooks globais. Para obter uma lista completa de ações, consulte "[Webhooks](/rest/reference/enterprise-admin#global-webhooks)."
diff --git a/translations/pt-BR/data/reusables/files/choose_commit_branch.md b/translations/pt-BR/data/reusables/files/choose_commit_branch.md
index 7c2c35cc6cd9..c9d1be3e3e2d 100644
--- a/translations/pt-BR/data/reusables/files/choose_commit_branch.md
+++ b/translations/pt-BR/data/reusables/files/choose_commit_branch.md
@@ -1 +1 @@
-1. Abaixo dos campos de mensagem do commit, opte por adicionar o commit ao branch atual ou a um novo branch. If your current branch is the default branch, you should choose to create a new branch for your commit and then create a pull request. Para obter mais informações, consulte "[Criar uma nova pull request](/articles/creating-a-pull-request)." ![Opções para fazer commit no branch](/assets/images/help/repository/choose-commit-branch.png)
+1. Abaixo dos campos de mensagem do commit, opte por adicionar o commit ao branch atual ou a um novo branch. Se seu branch atual for o branch-padrão, você deverá optar por criar um novo branch para seu commit e, em seguida, criar um pull request. Para obter mais informações, consulte "[Criar uma nova pull request](/articles/creating-a-pull-request)." ![Opções para fazer commit no branch](/assets/images/help/repository/choose-commit-branch.png)
diff --git a/translations/pt-BR/data/reusables/files/commit-author-email-options.md b/translations/pt-BR/data/reusables/files/commit-author-email-options.md
index aacdd79933b0..096c883fdbb9 100644
--- a/translations/pt-BR/data/reusables/files/commit-author-email-options.md
+++ b/translations/pt-BR/data/reusables/files/commit-author-email-options.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-Se você não ativou a privacidade do endereço de e-mail, você pode escolher qual endereço de e-mail verificado para o autor muda quando você editar, excluir ou criar arquivos ou faça merge de uma pull request no {% data variables.product.product_name %}. Se você ativou a privacidade do endereço de e-mail, então o endereço de e-mail do autor de commit não pode ser alterado e é `@users.noreply.github.com` por padrão.
+Se você não habilitou a privacidade do endereço de e-mail, você pode escolher qual endereço de e-mail verificado para o autor muda quando você edita, exclui, cria arquivos ou faz merge de um pull request
+{% data variables.product.product_name %}. Se você ativou a privacidade do endereço de e-mail, então o endereço de e-mail do autor de commit não pode ser alterado e é `@users.noreply.github.com` por padrão.
 {% endif %}
diff --git a/translations/pt-BR/data/reusables/gated-features/actions.md b/translations/pt-BR/data/reusables/gated-features/actions.md
index 5ce37df17860..7b5d269daf8b 100644
--- a/translations/pt-BR/data/reusables/gated-features/actions.md
+++ b/translations/pt-BR/data/reusables/gated-features/actions.md
@@ -1 +1 @@
-{% data variables.product.prodname_actions %} está disponível com {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} para organizações, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %} e {% data variables.product.prodname_ghe_one %}. {% data variables.product.prodname_actions %} is not available for private repositories owned by accounts using legacy per-repository plans. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %}
+{{ site.data.variables.product.prodname_actions }} está disponível com {{ site.data.variables.product.prodname_free_user }}, {{ site.data.variables.product.prodname_pro }}, {{ site.data.variables.product.prodname_free_team }} para organizações, {{ site.data.variables.product.prodname_team }}, {{ site.data.variables.product.prodname_ghe_cloud }} e {{ site.data.variables.product.prodname_ghe_one }}. {% data variables.product.prodname_actions %} não está disponível para repositórios privados pertencentes a contas usando os planos de legado por repositório. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %}
diff --git a/translations/pt-BR/data/reusables/gated-features/code-review-assignment.md b/translations/pt-BR/data/reusables/gated-features/code-review-assignment.md
index b0ac99736dc2..3ea50ed14323 100644
--- a/translations/pt-BR/data/reusables/gated-features/code-review-assignment.md
+++ b/translations/pt-BR/data/reusables/gated-features/code-review-assignment.md
@@ -1 +1 @@
-A atribuição de revisão de código está disponível com {% data variables.product.prodname_team %}{% if currentVersion ver_gt "enterprise-server@2.19" %}, {% data variables.product.prodname_ghe_server %} 2.20+,{% endif %} E {% data variables.product.prodname_ghe_cloud %}. Para obter mais informações, consulte os "[Produtos do GitHub](/articles/githubs-products)".
+Atribuição de revisão do código está disponível com {% data variables.product.prodname_team %}{% if currentVersion ver_gt "enterprise-server@2.19" %}, {% data variables.product.prodname_ghe_server %} 2.20+,{% endif %} e {% data variables.product.prodname_ghe_cloud %}. Para obter mais informações, consulte os "[Produtos do GitHub](/articles/githubs-products)".
diff --git a/translations/pt-BR/data/reusables/gated-features/code-scanning.md b/translations/pt-BR/data/reusables/gated-features/code-scanning.md
new file mode 100644
index 000000000000..fc21cc622337
--- /dev/null
+++ b/translations/pt-BR/data/reusables/gated-features/code-scanning.md
@@ -0,0 +1 @@
+{% data variables.product.prodname_code_scanning_capc %} está disponível em repositórios públicos e em repositórios públicos e privados pertencentes a organizações com uma licença para {% data variables.product.prodname_advanced_security %}. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %}
diff --git a/translations/pt-BR/data/reusables/gated-features/enterprise-accounts.md b/translations/pt-BR/data/reusables/gated-features/enterprise-accounts.md
index b71f5463685f..37ab60c6c5b8 100644
--- a/translations/pt-BR/data/reusables/gated-features/enterprise-accounts.md
+++ b/translations/pt-BR/data/reusables/gated-features/enterprise-accounts.md
@@ -1 +1 @@
-As contas corporativas estão disponíveis com {% data variables.product.prodname_ghe_cloud %} e {% data variables.product.prodname_ghe_server %}. {% if currentVersion == "free-pro-team@latest" %}Para obter mais informações, consulte "[Sobre contas corporativas](/articles/about-enterprise-accounts)".{% endif %}
+As contas corporativas estão disponíveis com {% data variables.product.prodname_ghe_cloud %} e {% data variables.product.prodname_ghe_server %}. {% if currentVersion == "free-pro-team@latest" %}Para obter mais informações, consulte "[Sobre contas corporativas](/articles/about-enterprise-accounts)."{% endif %}
diff --git a/translations/pt-BR/data/reusables/gated-features/more-info-org-products.md b/translations/pt-BR/data/reusables/gated-features/more-info-org-products.md
index d90994eda30a..03d5f622d3a7 100644
--- a/translations/pt-BR/data/reusables/gated-features/more-info-org-products.md
+++ b/translations/pt-BR/data/reusables/gated-features/more-info-org-products.md
@@ -1 +1 @@
-{% if currentVersion == "free-pro-team@latest" %}Para obter mais informações, consulte os "[produtos do {% data variables.product.prodname_dotcom %}](/articles/github-s-products)".{% endif %}
+{% if currentVersion == "free-pro-team@latest" %}Para obter mais informações, consulte "[produtos de {% data variables.product.prodname_dotcom %}](/articles/github-s-products){% endif %}
diff --git a/translations/pt-BR/data/reusables/gated-features/more-info.md b/translations/pt-BR/data/reusables/gated-features/more-info.md
index d90994eda30a..03d5f622d3a7 100644
--- a/translations/pt-BR/data/reusables/gated-features/more-info.md
+++ b/translations/pt-BR/data/reusables/gated-features/more-info.md
@@ -1 +1 @@
-{% if currentVersion == "free-pro-team@latest" %}Para obter mais informações, consulte os "[produtos do {% data variables.product.prodname_dotcom %}](/articles/github-s-products)".{% endif %}
+{% if currentVersion == "free-pro-team@latest" %}Para obter mais informações, consulte "[produtos de {% data variables.product.prodname_dotcom %}](/articles/github-s-products){% endif %}
diff --git a/translations/pt-BR/data/reusables/gated-features/packages.md b/translations/pt-BR/data/reusables/gated-features/packages.md
index d8da09306064..d1effb3796a4 100644
--- a/translations/pt-BR/data/reusables/gated-features/packages.md
+++ b/translations/pt-BR/data/reusables/gated-features/packages.md
@@ -1,4 +1,5 @@
-{% data variables.product.prodname_registry %} is available with {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} for organizations, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, {% data variables.product.prodname_ghe_server %} 2.22, and {% data variables.product.prodname_ghe_one %}.
+{% data variables.product.prodname_registry %} está disponível com {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} para organizações, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, {% data variables.product.prodname_ghe_server %} 2.22, e {% data variables.product.prodname_ghe_one %}.
 {% if currentVersion == "free-pro-team@latest" %}
-
    O {% data variables.product.prodname_registry %} não está disponível para repositórios privados de contas que utilizam planos antigos por-repositório. {% data variables.product.prodname_registry %} está disponível com {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} para organizações, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %} e {% data variables.product.prodname_ghe_one %}. {% data reusables.gated-features.more-info %}
+
    
+O {% data variables.product.prodname_registry %} não está disponível para repositórios privados de contas que utilizam planos antigos por-repositório. {% data variables.product.prodname_registry %} está disponível com {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} para organizações, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %} e {% data variables.product.prodname_ghe_one %}. {% data reusables.gated-features.more-info %}
 {% endif %}
diff --git a/translations/pt-BR/data/reusables/gated-features/repository-insights.md b/translations/pt-BR/data/reusables/gated-features/repository-insights.md
index 400ec07d98ae..d208ee57ddd1 100644
--- a/translations/pt-BR/data/reusables/gated-features/repository-insights.md
+++ b/translations/pt-BR/data/reusables/gated-features/repository-insights.md
@@ -1 +1 @@
-Este gráfico de informações de repositório está disponível em repositórios públicos com {% data variables.product.prodname_free_user %} e {% data variables.product.prodname_free_team %} para organizações, e em repositórios públicos e privados com  {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %} e {% data variables.product.prodname_ghe_server %}.{% if currentVersion == "free-pro-team@latest" %} Para obter mais informações, consulte "[Sobre gráficos de repositórios](/articles/about-repository-graphs)" e  produtos de"[{% data variables.product.prodname_dotcom %}](/articles/github-s-products)."{% endif %}
+Este gráfico de informações de repositório está disponível em repositórios públicos com {% data variables.product.prodname_free_user %} e {% data variables.product.prodname_free_team %} para organizações, e em repositórios públicos e privados com {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %} e {% data variables.product.prodname_ghe_server %}.{% if currentVersion == "free-pro-team@latest" %} Para mais informações, veja "[Sobre gráficos de repositórios](/articles/about-repository-graphs)" e "[produtos de {% data variables.product.prodname_dotcom %}](/articles/github-s-products).{% endif %}
diff --git a/translations/pt-BR/data/reusables/github-actions/actions-billing.md b/translations/pt-BR/data/reusables/github-actions/actions-billing.md
index 9d29c3092b9b..f5ef5b45d9ce 100644
--- a/translations/pt-BR/data/reusables/github-actions/actions-billing.md
+++ b/translations/pt-BR/data/reusables/github-actions/actions-billing.md
@@ -1 +1 @@
-O uso do {% data variables.product.prodname_actions %} é gratuito para repositórios públicos. Para repositórios privados, cada conta {% data variables.product.prodname_dotcom %} recebe uma certa quantidade de minutos e armazenamento gratuitos, dependendo do produto usado com a conta.
+O uso de {% data variables.product.prodname_actions %} é grátis para repositórios públicos e executores auto-hospedados. Para repositórios privados, cada conta {% data variables.product.prodname_dotcom %} recebe uma certa quantidade de minutos e armazenamento gratuitos, dependendo do produto usado com a conta.
diff --git a/translations/pt-BR/data/reusables/github-actions/actions-on-examples.md b/translations/pt-BR/data/reusables/github-actions/actions-on-examples.md
index 940d74379f8e..71107ce1209a 100644
--- a/translations/pt-BR/data/reusables/github-actions/actions-on-examples.md
+++ b/translations/pt-BR/data/reusables/github-actions/actions-on-examples.md
@@ -1,14 +1,14 @@
 ##### **Exemplo com um único evento**
 
 ```yaml
-# Trigger on push
+# Triggered when code is pushed to any branch in a repository
 on: push
 ```
 
 ##### **Exemplo com uma lista de eventos**
 
 ```yaml
-# Trigger the workflow on push or pull request
+# Triggers the workflow on push or pull request events
 on: [push, pull_request]
 ```
 
@@ -19,13 +19,13 @@ Se você precisar especificar tipos de atividade ou configuração para um event
 ```yaml
 on:
   # Trigger the workflow on push or pull request,
-  # but only for the master branch
+  # but only for the main branch
   push:
     branches:
-      - master
+      - main
   pull_request:
     branches:
-      - master
+      - main
   # Also trigger on page_build, as well as release created events
   page_build:
   release:
diff --git a/translations/pt-BR/data/reusables/github-actions/actions-unused-labels.md b/translations/pt-BR/data/reusables/github-actions/actions-unused-labels.md
index 6e256c14a1ef..aed44176061b 100644
--- a/translations/pt-BR/data/reusables/github-actions/actions-unused-labels.md
+++ b/translations/pt-BR/data/reusables/github-actions/actions-unused-labels.md
@@ -1 +1 @@
- Quaisquer etiquetas não utilizadas que não forem atribuídas a um executor serão automaticamente excluídas dentro de 24 horas.
\ No newline at end of file
+ Quaisquer etiquetas não utilizadas que não forem atribuídas a um executor serão automaticamente excluídas dentro de 24 horas.
diff --git a/translations/pt-BR/data/reusables/github-actions/artifact-log-retention-statement.md b/translations/pt-BR/data/reusables/github-actions/artifact-log-retention-statement.md
new file mode 100644
index 000000000000..c3c4ef14e394
--- /dev/null
+++ b/translations/pt-BR/data/reusables/github-actions/artifact-log-retention-statement.md
@@ -0,0 +1,2 @@
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 2" %} Por padrão, {% data variables.product.product_name %} armazena registros e artefatos por 90 dias, e este período de retenção pode ser personalizado. Para obter mais informações, consulte "[Limites de uso, cobrança e administração](/actions/reference/usage-limits-billing-and-administration#artifact-and-log-retention-policy)".{% endif %}
+{% if currentVersion == "enterprise-server@2.22" %} {% data variables.product.product_name %} armazena registros de criação completos e artefatos por 90 dias.{% endif %}
diff --git a/translations/pt-BR/data/reusables/github-actions/branch-requirement.md b/translations/pt-BR/data/reusables/github-actions/branch-requirement.md
index b1ad9ad9d8c9..9ff52dc82ff0 100644
--- a/translations/pt-BR/data/reusables/github-actions/branch-requirement.md
+++ b/translations/pt-BR/data/reusables/github-actions/branch-requirement.md
@@ -1,5 +1,5 @@
 {% note %}
 
-**Nota:** Este evento acionará apenas a execução de um fluxo de trabalho se o arquivo de trabalho estiver no `master` ou branch padrão.
+**Observação:** Este evento acionará apenas um fluxo de trabalho executado se o arquivo do fluxo de trabalho estiver no branch-padrão.
 
 {% endnote %}
diff --git a/translations/pt-BR/data/reusables/github-actions/change-retention-period-for-artifacts-logs.md b/translations/pt-BR/data/reusables/github-actions/change-retention-period-for-artifacts-logs.md
new file mode 100644
index 000000000000..7fc31692cff6
--- /dev/null
+++ b/translations/pt-BR/data/reusables/github-actions/change-retention-period-for-artifacts-logs.md
@@ -0,0 +1,2 @@
+1. Em **Tempo de retenção do artefato e registro**, digite um novo valor.
+1. Clique em **Salvar** para aplicar a alteração.
\ No newline at end of file
diff --git a/translations/pt-BR/data/reusables/github-actions/disabled-actions-description.md b/translations/pt-BR/data/reusables/github-actions/disabled-actions-description.md
index f1630cdab798..71811fcbb144 100644
--- a/translations/pt-BR/data/reusables/github-actions/disabled-actions-description.md
+++ b/translations/pt-BR/data/reusables/github-actions/disabled-actions-description.md
@@ -1 +1 @@
-Quando desativar {% data variables.product.prodname_actions %}, nenhum fluxo de trabalho é executado em seu repositório.
\ No newline at end of file
+Quando desativar {% data variables.product.prodname_actions %}, nenhum fluxo de trabalho é executado em seu repositório.
diff --git a/translations/pt-BR/data/reusables/github-actions/disabling-github-actions.md b/translations/pt-BR/data/reusables/github-actions/disabling-github-actions.md
index e6824e20684d..2679e0b24f27 100644
--- a/translations/pt-BR/data/reusables/github-actions/disabling-github-actions.md
+++ b/translations/pt-BR/data/reusables/github-actions/disabling-github-actions.md
@@ -1 +1 @@
-By default, {% data variables.product.prodname_actions %} is enabled on all repositories and organizations. You can choose to disable {% data variables.product.prodname_actions %} or limit them to private actions only, which means that people can only use actions that exist in your repository.
+Por padrão, {% if currentVersion ver_gt "enterprise-server@2. 1" %} depois que {% data variables.product.prodname_actions %} está habilitado em {% data variables.product.product_location %}, ele{% else if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_actions %}{% endif %} está habilitado em todos os repositórios e organizações. Você pode optar por desabilitar {% data variables.product.prodname_actions %} ou limitá-los apenas a ações privadas, o que significa que as pessoas só poderão usar ações que existem no seu repositório.
diff --git a/translations/pt-BR/data/reusables/github-actions/docker-container-os-support.md b/translations/pt-BR/data/reusables/github-actions/docker-container-os-support.md
index 55cc3b32188b..6a6e7a60ed45 100644
--- a/translations/pt-BR/data/reusables/github-actions/docker-container-os-support.md
+++ b/translations/pt-BR/data/reusables/github-actions/docker-container-os-support.md
@@ -2,7 +2,7 @@
 
 **Nota:** se seus fluxos de trabalho usam ações do contêiner Docker ou recipientes de serviço, você deve usar um executor Linux:
 
-* Se você está usando executores hospedados do {% data variables.product.prodname_dotcom %}, você deve usar o executor `ubuntu-latest`.
+* Se você estiver usando executores hospedados em {% data variables.product.prodname_dotcom %}, você deverá usar um executor do Ubuntu.
 * Se você estiver usando executores auto-hospedados, você deve usar uma máquina Linux, pois seu executor e o Docker precisam ser instalados.
 
 {% endnote %}
diff --git a/translations/pt-BR/data/reusables/github-actions/dockerfile-guidelines.md b/translations/pt-BR/data/reusables/github-actions/dockerfile-guidelines.md
index c44d64fe1daa..87b1a2319e63 100644
--- a/translations/pt-BR/data/reusables/github-actions/dockerfile-guidelines.md
+++ b/translations/pt-BR/data/reusables/github-actions/dockerfile-guidelines.md
@@ -1,3 +1,3 @@
 1. Documente os argumentos necessários no LEIAME das ações e omita-os da instrução `CMD`.
 1. Use padrões que permitam o uso da ação sem especificação de `args`.
-1. Se a ação expõe uma bandeira `--help` ou algo parecido, use isso para fazer sua ação se auto-documentar.
\ No newline at end of file
+1. Se a ação expõe uma bandeira `--help` ou algo parecido, use isso para fazer sua ação se auto-documentar.
diff --git a/translations/pt-BR/data/reusables/github-actions/enabled-actions-description.md b/translations/pt-BR/data/reusables/github-actions/enabled-actions-description.md
index 04891fa1c3d5..efc8363fc284 100644
--- a/translations/pt-BR/data/reusables/github-actions/enabled-actions-description.md
+++ b/translations/pt-BR/data/reusables/github-actions/enabled-actions-description.md
@@ -1 +1 @@
-Quando você habilita o {% data variables.product.prodname_actions %}, os fluxos de trabalho são capazes de executar ações localizadas no repositório e em qualquer outro repositório público.
\ No newline at end of file
+Quando você habilita o {% data variables.product.prodname_actions %}, os fluxos de trabalho são capazes de executar ações localizadas no repositório e em qualquer outro repositório público.
diff --git a/translations/pt-BR/data/reusables/github-actions/enabled-local-github-actions.md b/translations/pt-BR/data/reusables/github-actions/enabled-local-github-actions.md
index b59da11d1ae6..5473fb82284e 100644
--- a/translations/pt-BR/data/reusables/github-actions/enabled-local-github-actions.md
+++ b/translations/pt-BR/data/reusables/github-actions/enabled-local-github-actions.md
@@ -1 +1 @@
-Quando você ativa apenas ações locais, fluxos de trabalho só podem executar ações localizadas no repositório ou organização.
\ No newline at end of file
+Quando você ativa apenas ações locais, fluxos de trabalho só podem executar ações localizadas no repositório ou organização.
diff --git a/translations/pt-BR/data/reusables/github-actions/expression-syntax-if.md b/translations/pt-BR/data/reusables/github-actions/expression-syntax-if.md
index 3adafc00ed1e..4b3628936e05 100644
--- a/translations/pt-BR/data/reusables/github-actions/expression-syntax-if.md
+++ b/translations/pt-BR/data/reusables/github-actions/expression-syntax-if.md
@@ -1 +1 @@
-Quando você usa expressões em uma condicional `if` você pode omitir a sintaxe da expressão ({% raw %}`${{ }}`{% endraw %}) porque {% data variables.product.prodname_dotcom %} calcula automaticamente a condição `if` como expressão.
\ No newline at end of file
+Quando você usa expressões em uma condicional `if` você pode omitir a sintaxe da expressão ({% raw %}`${{ }}`{% endraw %}) porque {% data variables.product.prodname_dotcom %} calcula automaticamente a condição `if` como expressão.
diff --git a/translations/pt-BR/data/reusables/github-actions/gradle-workflow-steps.md b/translations/pt-BR/data/reusables/github-actions/gradle-workflow-steps.md
index 843571794844..33b72ad15db5 100644
--- a/translations/pt-BR/data/reusables/github-actions/gradle-workflow-steps.md
+++ b/translations/pt-BR/data/reusables/github-actions/gradle-workflow-steps.md
@@ -1,4 +1,4 @@
 Este fluxo de trabalho executa os seguintes passos:
 
 1. Verifica uma cópia do repositório do projeto.
-1. Define o Java JDK.
\ No newline at end of file
+1. Define o Java JDK.
diff --git a/translations/pt-BR/data/reusables/github-actions/permissions-statement-secrets-api.md b/translations/pt-BR/data/reusables/github-actions/permissions-statement-secrets-api.md
index d09378490913..8189a80590f1 100644
--- a/translations/pt-BR/data/reusables/github-actions/permissions-statement-secrets-api.md
+++ b/translations/pt-BR/data/reusables/github-actions/permissions-statement-secrets-api.md
@@ -1 +1 @@
-Para criar segredos usando a API REST, você deve ter acesso à gravação ao repositório. Para obter mais informações, consulte "[{% data variables.product.prodname_actions %} secrets API](/v3/actions/secrets/)."
+Para criar segredos usando a API REST, você deve ter acesso de gravação ao repositório ou acesso de administrador à organização. Para obter mais informações, consulte "[{% data variables.product.prodname_actions %} secrets API](/v3/actions/secrets/)."
diff --git a/translations/pt-BR/data/reusables/github-actions/permissions-statement-secrets-organization.md b/translations/pt-BR/data/reusables/github-actions/permissions-statement-secrets-organization.md
index 8b44ceda5d2e..7fef557aec04 100644
--- a/translations/pt-BR/data/reusables/github-actions/permissions-statement-secrets-organization.md
+++ b/translations/pt-BR/data/reusables/github-actions/permissions-statement-secrets-organization.md
@@ -1 +1 @@
-Para criar segredos no nível da organização, você deve ter acesso `admin`. 
\ No newline at end of file
+Para criar segredos no nível da organização, você deve ter acesso `admin`. 
diff --git a/translations/pt-BR/data/reusables/github-actions/permissions-statement-secrets-repository.md b/translations/pt-BR/data/reusables/github-actions/permissions-statement-secrets-repository.md
index e9ead6626222..dba3472bc7ee 100644
--- a/translations/pt-BR/data/reusables/github-actions/permissions-statement-secrets-repository.md
+++ b/translations/pt-BR/data/reusables/github-actions/permissions-statement-secrets-repository.md
@@ -1 +1 @@
-Para criar segredos para um repositório de conta de usuário, você deve ser o proprietário do repositório. Para criar segredos para o repositório de uma organização, você deve ter acesso `admin`.
\ No newline at end of file
+Para criar segredos para um repositório de conta de usuário, você deve ser o proprietário do repositório. Para criar segredos para o repositório de uma organização, você deve ter acesso `admin`.
diff --git a/translations/pt-BR/data/reusables/github-actions/private-repository-forks-configure.md b/translations/pt-BR/data/reusables/github-actions/private-repository-forks-configure.md
index 340a3f7e03fd..4d34ad7925cc 100644
--- a/translations/pt-BR/data/reusables/github-actions/private-repository-forks-configure.md
+++ b/translations/pt-BR/data/reusables/github-actions/private-repository-forks-configure.md
@@ -1,2 +1,2 @@
-1. Under **Fork pull request workflows**, select your options. Por exemplo: ![Habilitar, desabilitar ou limitar ações para este repositório](/assets/images/help/settings/actions-fork-pull-request-workflows.png)
-1. Click **Save** to apply the settings.
+1. Em **Bifurcar fluxos de trabalho de pull request**, selecione as suas opções. Por exemplo: ![Habilitar, desabilitar ou limitar ações para este repositório](/assets/images/help/settings/actions-fork-pull-request-workflows.png)
+1. Clique em **Salvar** para aplicar as configurações.
diff --git a/translations/pt-BR/data/reusables/github-actions/private-repository-forks-overview.md b/translations/pt-BR/data/reusables/github-actions/private-repository-forks-overview.md
index 716a64703f20..d57b25aea7f2 100644
--- a/translations/pt-BR/data/reusables/github-actions/private-repository-forks-overview.md
+++ b/translations/pt-BR/data/reusables/github-actions/private-repository-forks-overview.md
@@ -1,5 +1,5 @@
-If you rely on using forks of your private repositories, you can configure policies that control how users can run workflows on `pull_request` events. Available to private repositories only, you can configure these policy settings for enterprise accounts, organizations, or repositories. For enterprise accounts, the policies are applied to all repositories in all organizations.
+Se você depende do uso das bifurcações dos seus repositórios privados, você pode configurar políticas que controlam como os usuários podem executar fluxos de trabalho em eventos `pull_request`. Available to private repositories only, you can configure these policy settings for enterprise accounts, organizations, or repositories. For enterprise accounts, the policies are applied to all repositories in all organizations.
 
-- **Run workflows from fork pull requests** - Allows users to run workflows from fork pull requests, using a `GITHUB_TOKEN` with read-only permission, and with no access to secrets.
-- **Send write tokens to workflows from pull requests** - Allows pull requests from forks to use a `GITHUB_TOKEN` with write permission.
-- **Send secrets to workflows from pull requests** - Makes all secrets available to the pull request.
\ No newline at end of file
+- **Executar fluxos de trabalho de pull requests** - Permite que os usuários executem fluxos de trabalho de pull requests, usando um `GITHUB_TOKEN` com permissão somente leitura e sem acesso a segredos.
+- **Enviar tokens para fluxos de trabalho a partir de pull requests** - Permite que os pull requests das bifurcações usem um `GITHUB_TOKEN` com permissão de gravação.
+- **Envia segredos para fluxos de trabalho de pull requests** - Disponibiliza todos os segredos para o pull request.
diff --git a/translations/pt-BR/data/reusables/github-actions/publish-to-maven-workflow-step.md b/translations/pt-BR/data/reusables/github-actions/publish-to-maven-workflow-step.md
index 7b1438e61cf6..366671e3e6e0 100644
--- a/translations/pt-BR/data/reusables/github-actions/publish-to-maven-workflow-step.md
+++ b/translations/pt-BR/data/reusables/github-actions/publish-to-maven-workflow-step.md
@@ -1 +1 @@
-Executa o comando `mvn -B deploy` para publicar no repositório `ossrh`. A variável de ambiente `MAVEN_USERNAME` será definida com o conteúdo do seu segredo `OSSRH_USERNAME`, e a variável de ambiente `MAVEN_PASSWORD` será definida com o conteúdo do seu segredo `OSSRH_TOKEN`.
\ No newline at end of file
+Executa o comando `mvn -B deploy` para publicar no repositório `ossrh`. A variável de ambiente `MAVEN_USERNAME` será definida com o conteúdo do seu segredo `OSSRH_USERNAME`, e a variável de ambiente `MAVEN_PASSWORD` será definida com o conteúdo do seu segredo `OSSRH_TOKEN`.
diff --git a/translations/pt-BR/data/reusables/github-actions/publish-to-packages-workflow-step.md b/translations/pt-BR/data/reusables/github-actions/publish-to-packages-workflow-step.md
index 341dbd9cad16..a70dc2421560 100644
--- a/translations/pt-BR/data/reusables/github-actions/publish-to-packages-workflow-step.md
+++ b/translations/pt-BR/data/reusables/github-actions/publish-to-packages-workflow-step.md
@@ -1 +1 @@
-Executa o comando `mvn -B deploy` para publicar no {% data variables.product.prodname_registry %}. A variável de ambiente `GITHUB_TOKEN` será definida com o conteúdo do segredo `GITHUB_TOKEN`.
\ No newline at end of file
+Executa o comando `mvn -B deploy` para publicar no {% data variables.product.prodname_registry %}. A variável de ambiente `GITHUB_TOKEN` será definida com o conteúdo do segredo `GITHUB_TOKEN`.
diff --git a/translations/pt-BR/data/reusables/github-actions/publishing-java-packages-intro.md b/translations/pt-BR/data/reusables/github-actions/publishing-java-packages-intro.md
index 4c7c92e399f5..91141a040fe5 100644
--- a/translations/pt-BR/data/reusables/github-actions/publishing-java-packages-intro.md
+++ b/translations/pt-BR/data/reusables/github-actions/publishing-java-packages-intro.md
@@ -1 +1 @@
-Este guia mostra como criar um fluxo de trabalho que publica pacotes Java no {% data variables.product.prodname_registry %} e no Maven Central Repository. Com um único fluxo de trabalho, você pode publicar pacotes em um único repositório ou em vários repositórios.
\ No newline at end of file
+Este guia mostra como criar um fluxo de trabalho que publica pacotes Java no {% data variables.product.prodname_registry %} e no Maven Central Repository. Com um único fluxo de trabalho, você pode publicar pacotes em um único repositório ou em vários repositórios.
diff --git a/translations/pt-BR/data/reusables/github-actions/run_id_description.md b/translations/pt-BR/data/reusables/github-actions/run_id_description.md
index 1cf0af4533f4..3f61e1d7c247 100644
--- a/translations/pt-BR/data/reusables/github-actions/run_id_description.md
+++ b/translations/pt-BR/data/reusables/github-actions/run_id_description.md
@@ -1 +1 @@
-Um número exclusivo para cada execução em um repositório. Este número não muda se você executar novamente o fluxo de trabalho.
\ No newline at end of file
+Um número exclusivo para cada execução em um repositório. Este número não muda se você executar novamente o fluxo de trabalho.
diff --git a/translations/pt-BR/data/reusables/github-actions/run_number_description.md b/translations/pt-BR/data/reusables/github-actions/run_number_description.md
index 8300202b42d3..4e733bae3781 100644
--- a/translations/pt-BR/data/reusables/github-actions/run_number_description.md
+++ b/translations/pt-BR/data/reusables/github-actions/run_number_description.md
@@ -1 +1 @@
-Um número exclusivo para cada execução de um fluxo de trabalho específico em um repositório. Este número começa em 1 para a primeira execução do fluxo de trabalho, e incrementa a cada nova execução. Este número não muda se você executar novamente o fluxo de trabalho.
\ No newline at end of file
+Um número exclusivo para cada execução de um fluxo de trabalho específico em um repositório. Este número começa em 1 para a primeira execução do fluxo de trabalho, e incrementa a cada nova execução. Este número não muda se você executar novamente o fluxo de trabalho.
diff --git a/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md b/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md
index eafd59f0baef..1ab4125c5e49 100644
--- a/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md
+++ b/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md
@@ -1,2 +1,2 @@
 1. Na seção **Runners auto-hospedados** da página de configurações, clique em {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} ao lado do grupo de runner que deseja configurar, em seguida, clique em **Editar nome e acessar [organização|repositório]**. ![Gerenciar permissões do repositório](/assets/images/help/settings/actions-runner-manage-permissions.png)
-1. Selecione uma nova política a partir da lista suspensa ou modifique o nome do grupo de runner.
\ No newline at end of file
+1. Selecione uma nova política a partir da lista suspensa ou modifique o nome do grupo de runner.
diff --git a/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-list-group.md b/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-list-group.md
index dcc789864387..2794ccb1edc2 100644
--- a/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-list-group.md
+++ b/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-list-group.md
@@ -1 +1 @@
-1. Se seu runner estiver em um grupo, localize o grupo de runner e clique em {% octicon "chevron-down" aria-label="The downward chevron" %} para visualizar a lista de runners. ![Lista de grupo de runner](/assets/images/help/settings/actions-org-enterprise-list-group-runners.png)
\ No newline at end of file
+1. Se seu runner estiver em um grupo, localize o grupo de runner e clique em {% octicon "chevron-down" aria-label="The downward chevron" %} para visualizar a lista de runners. ![Lista de grupo de runner](/assets/images/help/settings/actions-org-enterprise-list-group-runners.png)
diff --git a/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-list.md b/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-list.md
index 2cf79a5b5799..a0f834bb9345 100644
--- a/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-list.md
+++ b/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-list.md
@@ -1 +1 @@
- 1. Localize a lista de runners em "Runners auto-hospedados".
\ No newline at end of file
+ 1. Localize a lista de runners em "Runners auto-hospedados".
diff --git a/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-management-permissions-required.md b/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-management-permissions-required.md
index 70456e930fb2..ba64ff08795d 100644
--- a/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-management-permissions-required.md
+++ b/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-management-permissions-required.md
@@ -1,9 +1,9 @@
-Um executor auto-hospedado pode estar localizado em sua organização ou em configurações do repositório no {% data variables.product.prodname_dotcom %}. Para gerenciar um executor auto-hospedado, você deve ter as seguintes permissões, dependendo de onde o executor auto-hospedado foi adicionado:
+Um executor auto-hospedado pode estar localizado no seu repositório, organização ou {% if currentVersion == "free-pro-team@latest" %}configurações da conta corporativa em {% data variables.product.prodname_dotcom %}{% else se currentVersion ! "free-pro-team@latest" e currentVersion ver_gt "enterprise-server@2. 1" %} configurações empresariais em {% data variables.product.product_location %}{% endif %}. Para gerenciar um executor auto-hospedado, você deve ter as seguintes permissões, dependendo de onde o executor auto-hospedado foi adicionado:
 - **Repositório de Usuário**: Você deve ser o proprietário do repositório.
 - **Organização**: Você deve ser um proprietário da organização.
 - **Repositório da organização**: Você deve ser o proprietário da organização ou ter acesso de administrador ao repositório.
 {% if currentVersion == "free-pro-team@latest" %}
 - **Conta corporativa**: Você deve ser proprietário de uma empresa.
 {% else if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %}
-- **Enterprise**: You must be a {% data variables.product.prodname_enterprise %} site administrator.
+- **Empresa**: Você deve ser um administrador do site de {% data variables.product.prodname_enterprise %}
 {% endif %}
diff --git a/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-navigate-repo-and-org.md b/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-navigate-repo-and-org.md
index 2517b7eaddb5..861f69280f89 100644
--- a/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-navigate-repo-and-org.md
+++ b/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-navigate-repo-and-org.md
@@ -1 +1 @@
-1. Na sua organização ou repositório, navegue até a página principal e clique no {% octicon "gear" aria-label="The Settings gear" %} **Settings**.
\ No newline at end of file
+1. Na sua organização ou repositório, navegue até a página principal e clique no {% octicon "gear" aria-label="The Settings gear" %} **Settings**.
diff --git a/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-navigate-to-repo-org-enterprise.md b/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-navigate-to-repo-org-enterprise.md
index 803d72e08e13..6a14a881ff81 100644
--- a/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-navigate-to-repo-org-enterprise.md
+++ b/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-navigate-to-repo-org-enterprise.md
@@ -1,12 +1,12 @@
 1. Navegue por onde seu runner auto-hospedado está registrado:
    * **Em uma organização ou repositório**: navegue até a página principal e clique em {% octicon "gear" aria-label="The Settings gear" %} **Configurações**.
-   * {% if currentVersion == "free-pro-team@latest" %}**If using an enterprise account**: navigate to your enterprise account by visiting `https://github.com/enterprises/ENTERPRISE-NAME`, replacing `ENTERPRISE-NAME` with your enterprise account's name.{% else if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %}**If using an enterprise-level runner**:
+   * {% if currentVersion == "free-pro-team@latest" %}**Se você estiver usando uma conta corporativa**: navegue até a conta corporativa acessando`https://github. om/enterprises/ENTERPRISE-NAME`, substituindo `ENTERPRISE-NAME` pelo nome da conta corporativa.{% else if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %}**Se estiver usando um executor de nível empresarial**:
 
      1. No canto superior direito de qualquer página, clique em {% octicon "rocket" aria-label="The rocket ship" %}.
-     1. In the left sidebar, click **Enterprise overview**.
-     1. {% endif %} In the enterprise sidebar, {% octicon "law" aria-label="The law icon" %} **Policies**.
+     1. Na barra lateral esquerda, clique em **Visão geral da empresa**.
+     1. {% endif %} Na barra lateral da empresa, {% octicon "law" aria-label="The law icon" %} **Políticas**.
 1. Navegue até as configurações {% data variables.product.prodname_actions %}:
    * **Em uma organização ou um repositório**: clique em **Ações** na barra lateral esquerda.
 
      ![Configuração de ações](/assets/images/help/settings/settings-sidebar-actions.png)
-   * {% if currentVersion == "free-pro-team@latest" %}**If using an enterprise account**{% else if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %}**If using an enterprise-level runner**{% endif %}: click **Actions** under "{% octicon "law" aria-label="The law icon" %} Policies".
+   * {% if currentVersion == "free-pro-team@latest" %}**Se estiver usando uma conta corporativa**{% else if currentVersion != "free-pro-team@latest" e currentVersion ver_gt "enterprise-server@2. 1" %}**Se usar um executor de nível empresarial**{% endif %}: clique **Ações** em "Políticas de {% octicon "law" aria-label="The law icon" %}".
diff --git a/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-removal-impact.md b/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-removal-impact.md
index b07b19cdcf76..abcae600692c 100644
--- a/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-removal-impact.md
+++ b/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-removal-impact.md
@@ -1 +1 @@
-Este procedimento remove permanentemente o executor auto-hospedado. Se você só quiser impedir temporariamente que um executor seja designado a trabalhos, você pode desligar a máquina ou parar o aplicativo `run`. O executor permanecerá atribuído em um estado "Offline" e não executará nenhum trabalho até que você reinicie o executor usando o aplicativo `run`.
\ No newline at end of file
+Este procedimento remove permanentemente o executor auto-hospedado. Se você só quiser impedir temporariamente que um executor seja designado a trabalhos, você pode desligar a máquina ou parar o aplicativo `run`. O executor permanecerá atribuído em um estado "Offline" e não executará nenhum trabalho até que você reinicie o executor usando o aplicativo `run`.
diff --git a/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-reusing.md b/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-reusing.md
index f882ff8cd298..10461eeba35a 100644
--- a/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-reusing.md
+++ b/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-reusing.md
@@ -1 +1 @@
-Como alternativa, se você não tiver acesso ao repositório, à organização ou corporação em {% data variables.product.product_name %} para remover um runner, mas você gostaria de reutilizar a máquina executora, você poderá excluir o arquivo `.runner` dentro do diretório de aplicação do runner auto-hospedado. Isso permite que o runner seja registrado sem ter que baixar novamente o aplicativo do runner auto-hospedado.
\ No newline at end of file
+Como alternativa, se você não tiver acesso ao repositório, à organização ou corporação em {% data variables.product.product_name %} para remover um runner, mas você gostaria de reutilizar a máquina executora, você poderá excluir o arquivo `.runner` dentro do diretório de aplicação do runner auto-hospedado. Isso permite que o runner seja registrado sem ter que baixar novamente o aplicativo do runner auto-hospedado.
diff --git a/translations/pt-BR/data/reusables/github-actions/sidebar-secret.md b/translations/pt-BR/data/reusables/github-actions/sidebar-secret.md
index 111cf5bc7f31..93ce84975519 100644
--- a/translations/pt-BR/data/reusables/github-actions/sidebar-secret.md
+++ b/translations/pt-BR/data/reusables/github-actions/sidebar-secret.md
@@ -1 +1 @@
-1. Na barra lateral esquerda, clique em **Secrets** (Segredos).
\ No newline at end of file
+1. Na barra lateral esquerda, clique em **Secrets** (Segredos).
diff --git a/translations/pt-BR/data/reusables/github-actions/usage-api-requests.md b/translations/pt-BR/data/reusables/github-actions/usage-api-requests.md
new file mode 100644
index 000000000000..5704f0fd55b4
--- /dev/null
+++ b/translations/pt-BR/data/reusables/github-actions/usage-api-requests.md
@@ -0,0 +1 @@
+- **Solicitações de API** - Você pode executar até 1000 solicitações de API por hora em todas as ações dentro de um repositório. Se excedido, as chamadas de API adicionais falharão, o que pode causar falha nas tarefas.
diff --git a/translations/pt-BR/data/reusables/github-actions/usage-matrix-limits.md b/translations/pt-BR/data/reusables/github-actions/usage-matrix-limits.md
new file mode 100644
index 000000000000..b83297c5cc58
--- /dev/null
+++ b/translations/pt-BR/data/reusables/github-actions/usage-matrix-limits.md
@@ -0,0 +1 @@
+- **Matriz de trabalho** - A matriz de trabalho pode gerar no máximo 256 trabalhos por execução de fluxo de trabalho. Este limite também se aplica a executores auto-hospedados.
diff --git a/translations/pt-BR/data/reusables/github-actions/usage-workflow-run-time.md b/translations/pt-BR/data/reusables/github-actions/usage-workflow-run-time.md
new file mode 100644
index 000000000000..83c43023459e
--- /dev/null
+++ b/translations/pt-BR/data/reusables/github-actions/usage-workflow-run-time.md
@@ -0,0 +1 @@
+- **Tempo de execução do fluxo de trabalho** - Cada execução do fluxo de trabalho é limitada a 72 horas. Se a execução de um fluxo de trabalho atingir esse limite, a execução do fluxo de trabalho será cancelada.
diff --git a/translations/pt-BR/data/reusables/github-connect/access-profile-settings.md b/translations/pt-BR/data/reusables/github-connect/access-profile-settings.md
index ebf4e45a0209..31dea8796ff5 100644
--- a/translations/pt-BR/data/reusables/github-connect/access-profile-settings.md
+++ b/translations/pt-BR/data/reusables/github-connect/access-profile-settings.md
@@ -1 +1 @@
-1. No canto superior direito de qualquer página da {% data variables.product.product_location_enterprise %}, clique na sua foto do perfil e em **Settings** (Configurações). ![Ícone Settings (Configurações) na barra de usuário](/assets/images/help/settings/userbar-account-settings.png)
+1. No canto superior direito de qualquer página do {% data variables.product.product_location_enterprise %}, clique na sua foto do perfil e em **Settings** (Configurações). ![Ícone Settings (Configurações) na barra de usuário](/assets/images/help/settings/userbar-account-settings.png)
diff --git a/translations/pt-BR/data/reusables/github-insights/choose-key-metric.md b/translations/pt-BR/data/reusables/github-insights/choose-key-metric.md
index 5ee91c9cae74..cf236c194622 100644
--- a/translations/pt-BR/data/reusables/github-insights/choose-key-metric.md
+++ b/translations/pt-BR/data/reusables/github-insights/choose-key-metric.md
@@ -1 +1 @@
-2. Em **{% octicon "graph" aria-label="The graph icon" %} Key metrics**, clique no nome da métrica que deseja visualizar. ![Lista de métricas chave](/assets/images/help/insights/key-metrics-list.png)
\ No newline at end of file
+2. Em **{% octicon "graph" aria-label="The graph icon" %} Key metrics**, clique no nome da métrica que deseja visualizar. ![Lista de métricas chave](/assets/images/help/insights/key-metrics-list.png)
diff --git a/translations/pt-BR/data/reusables/github-insights/enterprise-api-url.md b/translations/pt-BR/data/reusables/github-insights/enterprise-api-url.md
index 05bb0b019d27..554538149c93 100644
--- a/translations/pt-BR/data/reusables/github-insights/enterprise-api-url.md
+++ b/translations/pt-BR/data/reusables/github-insights/enterprise-api-url.md
@@ -1 +1 @@
-1. Em "{% data variables.product.prodname_dotcom %} API URL", digite {% if currentVersion == "free-pro-team@latest" %}https://api.github.com {% else %}a URL que você usa para acessar {% data variables.product.prodname_enterprise %}{% endif %}. ![{% data variables.product.prodname_enterprise %} Campo de URL API](/assets/images/help/insights/enterprise-api-url.png)
+1. Em "URL da API de {% data variables.product.prodname_dotcom %}", digite {% if currentVersion == "free-pro-team@latest" %}https://api.github.com {% else %}a URL que você usa para acessar {% data variables.product.prodname_enterprise %}{% endif %}. ![{% data variables.product.prodname_enterprise %} Campo de URL API](/assets/images/help/insights/enterprise-api-url.png)
diff --git a/translations/pt-BR/data/reusables/github-insights/navigate-to-key-metrics.md b/translations/pt-BR/data/reusables/github-insights/navigate-to-key-metrics.md
index 1314ba1e8a3d..b34ff5d90bb2 100644
--- a/translations/pt-BR/data/reusables/github-insights/navigate-to-key-metrics.md
+++ b/translations/pt-BR/data/reusables/github-insights/navigate-to-key-metrics.md
@@ -1 +1 @@
-1. Em {% data variables.product.prodname_insights %}, clique em **{% octicon "graph" aria-label="The graph icon" %} Métricas-chave**. ![Aba de Métricas Chave](/assets/images/help/insights/key-metrics-tab.png)
\ No newline at end of file
+1. Em {% data variables.product.prodname_insights %}, clique em **{% octicon "graph" aria-label="The graph icon" %} Métricas-chave**. ![Aba de Métricas Chave](/assets/images/help/insights/key-metrics-tab.png)
diff --git a/translations/pt-BR/data/reusables/gpg/private-email.md b/translations/pt-BR/data/reusables/gpg/private-email.md
index ae40ba5706b2..1f5b18bbe728 100644
--- a/translations/pt-BR/data/reusables/gpg/private-email.md
+++ b/translations/pt-BR/data/reusables/gpg/private-email.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-Para manter seu endereço de e-mail privado, use seu {% data variables.product.product_name %}-e-mail fornecido `no-reply`.
+Para manter seu endereço de e-mail privado, use seu
+endereço de e-mail `no-reply` fornecido por {% data variables.product.product_name %}.
 {% endif %}
diff --git a/translations/pt-BR/data/reusables/identity-and-permissions/enable-team-sync-azure.md b/translations/pt-BR/data/reusables/identity-and-permissions/enable-team-sync-azure.md
index 2f872e782512..acf01a7ac2a5 100644
--- a/translations/pt-BR/data/reusables/identity-and-permissions/enable-team-sync-azure.md
+++ b/translations/pt-BR/data/reusables/identity-and-permissions/enable-team-sync-azure.md
@@ -1 +1 @@
-1. Em "Team synchronization", clique em **Enable for Azure AD**. ![Botão Enable team synchronization (Habilitar sincronização de equipes) na página de configurações de segurança](/assets/images/help/teams/enable-team-synchronization.png)
\ No newline at end of file
+1. Em "Team synchronization", clique em **Enable for Azure AD**. ![Botão Enable team synchronization (Habilitar sincronização de equipes) na página de configurações de segurança](/assets/images/help/teams/enable-team-synchronization.png)
diff --git a/translations/pt-BR/data/reusables/identity-and-permissions/enable-team-sync-okta.md b/translations/pt-BR/data/reusables/identity-and-permissions/enable-team-sync-okta.md
index b6c8a2396a1d..4c81b20962ea 100644
--- a/translations/pt-BR/data/reusables/identity-and-permissions/enable-team-sync-okta.md
+++ b/translations/pt-BR/data/reusables/identity-and-permissions/enable-team-sync-okta.md
@@ -1 +1 @@
-1. Em "Team synchronization", clique em **Enable for Okta**. ![Habilitar sincronização de equipes para o botão Okta na página de configurações de segurança](/assets/images/help/teams/enable-team-synchronization-okta.png)
\ No newline at end of file
+1. Em "Team synchronization", clique em **Enable for Okta**. ![Habilitar sincronização de equipes para o botão Okta na página de configurações de segurança](/assets/images/help/teams/enable-team-synchronization-okta.png)
diff --git a/translations/pt-BR/data/reusables/identity-and-permissions/supported-idps-team-sync.md b/translations/pt-BR/data/reusables/identity-and-permissions/supported-idps-team-sync.md
index f1949117cdc6..f4163591744b 100644
--- a/translations/pt-BR/data/reusables/identity-and-permissions/supported-idps-team-sync.md
+++ b/translations/pt-BR/data/reusables/identity-and-permissions/supported-idps-team-sync.md
@@ -1,3 +1,3 @@
 Você pode usar a sincronização de equipe com IdPs suportados.
   - Azure AD
-  - Okta
\ No newline at end of file
+  - Okta
diff --git a/translations/pt-BR/data/reusables/identity-and-permissions/sync-team-with-idp-group.md b/translations/pt-BR/data/reusables/identity-and-permissions/sync-team-with-idp-group.md
index 26e7ef92c15f..46650d58b805 100644
--- a/translations/pt-BR/data/reusables/identity-and-permissions/sync-team-with-idp-group.md
+++ b/translations/pt-BR/data/reusables/identity-and-permissions/sync-team-with-idp-group.md
@@ -1 +1 @@
-Depois que você ativar a sincronização de equipe, os mantenedores de equipe e os proprietários da organização poderão conectar uma equipe a um grupo de IdP no {% data variables.product.prodname_dotcom %} ou através da API. Para obter mais informações, consulte "[Synchronizing a team with an identity provider group](/github/setting-up-and-managing-organizations-and-teams/synchronizing-a-team-with-an-identity-provider-group)" e "[Team synchronization](/v3/teams/team_sync/)."
\ No newline at end of file
+Depois que você ativar a sincronização de equipe, os mantenedores de equipe e os proprietários da organização poderão conectar uma equipe a um grupo de IdP no {% data variables.product.prodname_dotcom %} ou através da API. Para obter mais informações, consulte "[Synchronizing a team with an identity provider group](/github/setting-up-and-managing-organizations-and-teams/synchronizing-a-team-with-an-identity-provider-group)" e "[Team synchronization](/v3/teams/team_sync/)."
diff --git a/translations/pt-BR/data/reusables/identity-and-permissions/team-sync-disable.md b/translations/pt-BR/data/reusables/identity-and-permissions/team-sync-disable.md
index 13f5b08c25f5..4428a48cecd6 100644
--- a/translations/pt-BR/data/reusables/identity-and-permissions/team-sync-disable.md
+++ b/translations/pt-BR/data/reusables/identity-and-permissions/team-sync-disable.md
@@ -2,4 +2,4 @@
 
 **Aviso:** Quando você desativar a sincronização de equipe, os membros da equipe que foram atribuídos a uma equipe do {% data variables.product.prodname_dotcom %} através do grupo IdP são removidos da equipe e podem perder acesso aos repositórios.
 
-{% endwarning %}
\ No newline at end of file
+{% endwarning %}
diff --git a/translations/pt-BR/data/reusables/identity-and-permissions/team-sync-okta-requirements.md b/translations/pt-BR/data/reusables/identity-and-permissions/team-sync-okta-requirements.md
index 5ca55f045a31..3c48c2cec426 100644
--- a/translations/pt-BR/data/reusables/identity-and-permissions/team-sync-okta-requirements.md
+++ b/translations/pt-BR/data/reusables/identity-and-permissions/team-sync-okta-requirements.md
@@ -2,4 +2,4 @@ Para ativar a sincronização da equipe para a Okta, você ou seu administrador
 
 - Ativar SAML SSO e SCIM para sua organização usando o Okta. Para obter mais informações, consulte "[Configuring SAML single sign-on and SCIM using Okta](/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta)" (Configurar SAML logon único e SCIM usando Okta)
 - Forneça o URL do inquilino para sua instância Okta.
-- Gere um token SSWS válido com permissões de administrador somente leitura para a sua instalação do Okta como usuário do serviço. Para obter mais informações, consulte [Criar o token](https://developer.okta.com/docs/guides/create-an-api-token/create-the-token/) e [Usuários de serviços](https://help.okta.com/en/prod/Content/Topics/Adv_Server_Access/docs/service-users.htm) na documentação de Okta.
\ No newline at end of file
+- Gere um token SSWS válido com permissões de administrador somente leitura para a sua instalação do Okta como usuário do serviço. Para obter mais informações, consulte [Criar o token](https://developer.okta.com/docs/guides/create-an-api-token/create-the-token/) e [Usuários de serviços](https://help.okta.com/en/prod/Content/Topics/Adv_Server_Access/docs/service-users.htm) na documentação de Okta.
diff --git a/translations/pt-BR/data/reusables/interactions/collaborator-user-limit-definition.md b/translations/pt-BR/data/reusables/interactions/collaborator-user-limit-definition.md
index 84308e27eae3..780e81b7fcb7 100644
--- a/translations/pt-BR/data/reusables/interactions/collaborator-user-limit-definition.md
+++ b/translations/pt-BR/data/reusables/interactions/collaborator-user-limit-definition.md
@@ -1 +1 @@
-**Colaboradores apenas:** quando você limitar as interações para `collaborators_only`, os usuários que não forem colaboradores ficarão temporariamente restritos
\ No newline at end of file
+**Colaboradores apenas:** quando você limitar as interações para `collaborators_only`, os usuários que não forem colaboradores ficarão temporariamente restritos
diff --git a/translations/pt-BR/data/reusables/interactions/contributor-user-limit-definition.md b/translations/pt-BR/data/reusables/interactions/contributor-user-limit-definition.md
index f69bc15aad69..ef67426262d4 100644
--- a/translations/pt-BR/data/reusables/interactions/contributor-user-limit-definition.md
+++ b/translations/pt-BR/data/reusables/interactions/contributor-user-limit-definition.md
@@ -1 +1 @@
-**Colaboradores apenas:** quando você limitar as interações para `contributors_only`, usuários que não contribuíram anteriormente e não são colaboradores serão temporariamente restritos
\ No newline at end of file
+**Colaboradores apenas:** quando você limitar as interações para `contributors_only`, usuários que não contribuíram anteriormente e não são colaboradores serão temporariamente restritos
diff --git a/translations/pt-BR/data/reusables/interactions/existing-user-limit-definition.md b/translations/pt-BR/data/reusables/interactions/existing-user-limit-definition.md
index 96689be6a399..858c4ea740b4 100644
--- a/translations/pt-BR/data/reusables/interactions/existing-user-limit-definition.md
+++ b/translations/pt-BR/data/reusables/interactions/existing-user-limit-definition.md
@@ -1 +1 @@
-**Usuários existentes:** Quando você limitar as interações para `existing_users`, novos usuários com contas com menos de 24 horas de idade, que não tenham contribuído anteriormente e que não sejam colaboradores, estarão temporariamente restritos
\ No newline at end of file
+**Usuários existentes:** Quando você limitar as interações para `existing_users`, novos usuários com contas com menos de 24 horas de idade, que não tenham contribuído anteriormente e que não sejam colaboradores, estarão temporariamente restritos
diff --git a/translations/pt-BR/data/reusables/interactions/interactions-detail.md b/translations/pt-BR/data/reusables/interactions/interactions-detail.md
index d0d527844165..06f68fdb071d 100644
--- a/translations/pt-BR/data/reusables/interactions/interactions-detail.md
+++ b/translations/pt-BR/data/reusables/interactions/interactions-detail.md
@@ -1 +1 @@
-Quando as restrições são ativadas, apenas o grupo especificado de {% data variables.product.product_name %} os usuários serão capazes de participar de interações. As restrições expiram 24 horas a partir do momento que são estabelecidas.
\ No newline at end of file
+Quando as restrições são ativadas, apenas o grupo especificado de {% data variables.product.product_name %} os usuários serão capazes de participar de interações. As restrições expiram 24 horas a partir do momento que são estabelecidas.
diff --git a/translations/pt-BR/data/reusables/issue-events/assignee-properties.md b/translations/pt-BR/data/reusables/issue-events/assignee-properties.md
index d3b2c3af22fd..9bdb534c7711 100644
--- a/translations/pt-BR/data/reusables/issue-events/assignee-properties.md
+++ b/translations/pt-BR/data/reusables/issue-events/assignee-properties.md
@@ -1 +1 @@
-`assignee` | `object` | A pessoa não foi atribuída para essa questão. `assigner` | `object` | A pessoa que realizou a desatribuição para esta issue.
\ No newline at end of file
+`assignee` | `object` | A pessoa não foi atribuída para essa questão. `assigner` | `object` | A pessoa que realizou a desatribuição para esta issue.
diff --git a/translations/pt-BR/data/reusables/issue-events/issue-event-common-properties.md b/translations/pt-BR/data/reusables/issue-events/issue-event-common-properties.md
index 6ad634a875e1..c92fc003810a 100644
--- a/translations/pt-BR/data/reusables/issue-events/issue-event-common-properties.md
+++ b/translations/pt-BR/data/reusables/issue-events/issue-event-common-properties.md
@@ -7,4 +7,4 @@
 | `event`      | `string`  | Identifica o tipo atual do evento que ocorreu.                         |
 | `commit_id`  | `string`  | O SHA do commit que fez referência a esta issue.                       |
 | `commit_url` | `string`  | O link da GitHub REST API para o commit que referenciou este problema. |
-| `created_at` | `string`  | O timestamp indicando quando ocorreu o evento.                         |
\ No newline at end of file
+| `created_at` | `string`  | O timestamp indicando quando ocorreu o evento.                         |
diff --git a/translations/pt-BR/data/reusables/issue-events/label-properties.md b/translations/pt-BR/data/reusables/issue-events/label-properties.md
index d62076e19618..9210cd0cd074 100644
--- a/translations/pt-BR/data/reusables/issue-events/label-properties.md
+++ b/translations/pt-BR/data/reusables/issue-events/label-properties.md
@@ -1 +1 @@
-`label` | `object` | A etiqueta foi removida do problema `label[name]` | `string` | O nome da etiqueta. `label[color]` | `string` | O código de cor hexadecimal. 
\ No newline at end of file
+`label` | `object` | A etiqueta foi removida do problema `label[name]` | `string` | O nome da etiqueta. `label[color]` | `string` | O código de cor hexadecimal. 
diff --git a/translations/pt-BR/data/reusables/issue-events/project-card-properties.md b/translations/pt-BR/data/reusables/issue-events/project-card-properties.md
index c05ac4ec5cc9..3992cf6405ab 100644
--- a/translations/pt-BR/data/reusables/issue-events/project-card-properties.md
+++ b/translations/pt-BR/data/reusables/issue-events/project-card-properties.md
@@ -1 +1 @@
-`project_card` | `object` | O objeto do cartão do projeto. `project_id` | `integer` | O identificador exclusivo do cartão do projeto. `project_url` | `string` | A REST API URL para recuperar o cartão do projeto. `column_name` | `string` | O nome da coluna na qual o problema está.
\ No newline at end of file
+`project_card` | `object` | O objeto do cartão do projeto. `project_id` | `integer` | O identificador exclusivo do cartão do projeto. `project_url` | `string` | A REST API URL para recuperar o cartão do projeto. `column_name` | `string` | O nome da coluna na qual o problema está.
diff --git a/translations/pt-BR/data/reusables/issue-events/review-dismissed-properties.md b/translations/pt-BR/data/reusables/issue-events/review-dismissed-properties.md
index df825a42ddd7..415e56dbce44 100644
--- a/translations/pt-BR/data/reusables/issue-events/review-dismissed-properties.md
+++ b/translations/pt-BR/data/reusables/issue-events/review-dismissed-properties.md
@@ -1 +1 @@
-`dismissed_review` | `object` | As informações para a revisão ignorada. `dismissed_review[state]` | `string` | O estado em que a pull request estava quando foi dispensada. Pode ser um dos: `commented`, `approved`, ou `changes_requested`. `dismissed_review[review_id]` | `string` | O identificador exclusivo da revisão da pull request. `dismissed_review[dismissal_message]` | `string` | A mensagem que o usuário incluiu quando descartou a revisão. `dismissed_review[dismissal_commit_id]` | `string` | O identificador exclusivo do commit que ignorou a revisão, se ela existir.
\ No newline at end of file
+`dismissed_review` | `object` | As informações para a revisão ignorada. `dismissed_review[state]` | `string` | O estado em que a pull request estava quando foi dispensada. Pode ser um dos: `commented`, `approved`, ou `changes_requested`. `dismissed_review[review_id]` | `string` | O identificador exclusivo da revisão da pull request. `dismissed_review[dismissal_message]` | `string` | A mensagem que o usuário incluiu quando descartou a revisão. `dismissed_review[dismissal_commit_id]` | `string` | O identificador exclusivo do commit que ignorou a revisão, se ela existir.
diff --git a/translations/pt-BR/data/reusables/issue-events/review-request-properties.md b/translations/pt-BR/data/reusables/issue-events/review-request-properties.md
index 88ec3e69d083..89233988a877 100644
--- a/translations/pt-BR/data/reusables/issue-events/review-request-properties.md
+++ b/translations/pt-BR/data/reusables/issue-events/review-request-properties.md
@@ -1 +1 @@
-`requested_reviewer` | `object` | A pessoa solicitou a revisão da pull request. `review_requester` | `object` | A pessoa que pediu uma revisão.
\ No newline at end of file
+`requested_reviewer` | `object` | A pessoa solicitou a revisão da pull request. `review_requester` | `object` | A pessoa que pediu uma revisão.
diff --git a/translations/pt-BR/data/reusables/issue-events/timeline_events_object_properties.md b/translations/pt-BR/data/reusables/issue-events/timeline_events_object_properties.md
index 1878c0742cc8..5c3f6b477299 100644
--- a/translations/pt-BR/data/reusables/issue-events/timeline_events_object_properties.md
+++ b/translations/pt-BR/data/reusables/issue-events/timeline_events_object_properties.md
@@ -1 +1 @@
-Estes eventos não usam a mesma estrutura que as propriedades comuns do evento de [issue event object common properties](#issue-event-object-common-properties). As seguintes propriedades são retornadas para este evento.
\ No newline at end of file
+Estes eventos não usam a mesma estrutura que as propriedades comuns do evento de [issue event object common properties](#issue-event-object-common-properties). As seguintes propriedades são retornadas para este evento.
diff --git a/translations/pt-BR/data/reusables/large_files/can-include-lfs-objects-archives.md b/translations/pt-BR/data/reusables/large_files/can-include-lfs-objects-archives.md
index 09863a5889eb..ce72b474cc2c 100644
--- a/translations/pt-BR/data/reusables/large_files/can-include-lfs-objects-archives.md
+++ b/translations/pt-BR/data/reusables/large_files/can-include-lfs-objects-archives.md
@@ -4,4 +4,4 @@ Você pode escolher se os objetos {% data variables.large_files.product_name_lon
 
 [Gerenciando {% data variables.large_files.product_name_short %} objetos nos arquivos de seu repositório](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)".
     
 
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/translations/pt-BR/data/reusables/marketplace/cancellation-clarification.md b/translations/pt-BR/data/reusables/marketplace/cancellation-clarification.md
index 66431a9c90d8..0c4aa92456f2 100644
--- a/translations/pt-BR/data/reusables/marketplace/cancellation-clarification.md
+++ b/translations/pt-BR/data/reusables/marketplace/cancellation-clarification.md
@@ -1 +1 @@
-Quando um cliente cancela uma assinatura do {% data variables.product.prodname_marketplace %}, o GitHub não desinstala automaticamente o aplicativo, então o cliente pode esperar que os recursos gratuitos continuem funcionando.
\ No newline at end of file
+Quando um cliente cancela uma assinatura do {% data variables.product.prodname_marketplace %}, o GitHub não desinstala automaticamente o aplicativo, então o cliente pode esperar que os recursos gratuitos continuem funcionando.
diff --git a/translations/pt-BR/data/reusables/marketplace/github_apps_preferred.md b/translations/pt-BR/data/reusables/marketplace/github_apps_preferred.md
index 654f69ef4b36..8c0eab1347a0 100644
--- a/translations/pt-BR/data/reusables/marketplace/github_apps_preferred.md
+++ b/translations/pt-BR/data/reusables/marketplace/github_apps_preferred.md
@@ -1 +1 @@
-Aplicativos do GitHub são a forma oficialmente recomendada de se integrar ao GitHub, porque eles oferecem muito mais permissões granulares para acessar dados
\ No newline at end of file
+Aplicativos do GitHub são a forma oficialmente recomendada de se integrar ao GitHub, porque eles oferecem muito mais permissões granulares para acessar dados
diff --git a/translations/pt-BR/data/reusables/marketplace/install-buy.md b/translations/pt-BR/data/reusables/marketplace/install-buy.md
index e9be99d698d5..72cc52094cf9 100644
--- a/translations/pt-BR/data/reusables/marketplace/install-buy.md
+++ b/translations/pt-BR/data/reusables/marketplace/install-buy.md
@@ -1 +1 @@
-1. Click **Install it for free**, **Buy with {% data variables.product.prodname_dotcom %}**, or **Try free for 14 days**. ![Compre com o botão {% data variables.product.prodname_dotcom %}](/assets/images/help/marketplace/marketplace-buy-with-github-button.png)
+1. Clique em **Instalar gratuitamente**, **Compre com {% data variables.product.prodname_dotcom %}** ou **Experimente gratuitamente por 14 dias**. ![Compre com o botão {% data variables.product.prodname_dotcom %}](/assets/images/help/marketplace/marketplace-buy-with-github-button.png)
diff --git a/translations/pt-BR/data/reusables/marketplace/launch-with-free.md b/translations/pt-BR/data/reusables/marketplace/launch-with-free.md
index 80d51a6537a0..152515a4c3d2 100644
--- a/translations/pt-BR/data/reusables/marketplace/launch-with-free.md
+++ b/translations/pt-BR/data/reusables/marketplace/launch-with-free.md
@@ -1 +1 @@
-Você pode enviar um aplicativo não verificado e verificado. Isso permitirá que você inicie com uma versão gratuita do seu aplicativo. Assim que o GitHub verificar o seu aplicativo, seu anúncio mudará de não verificado para verificado em {% data variables.product.prodname_marketplace %} e o GitHub publicará os seus novos planos de preços.
\ No newline at end of file
+Você pode enviar um aplicativo não verificado e verificado. Isso permitirá que você inicie com uma versão gratuita do seu aplicativo. Assim que o GitHub verificar o seu aplicativo, seu anúncio mudará de não verificado para verificado em {% data variables.product.prodname_marketplace %} e o GitHub publicará os seus novos planos de preços.
diff --git a/translations/pt-BR/data/reusables/marketplace/unverified-apps.md b/translations/pt-BR/data/reusables/marketplace/unverified-apps.md
index a2866a703a95..e851cc46567c 100644
--- a/translations/pt-BR/data/reusables/marketplace/unverified-apps.md
+++ b/translations/pt-BR/data/reusables/marketplace/unverified-apps.md
@@ -1 +1 @@
-Aplicativos não verificados são oferecidos apenas com planos gratuitos. Para listar planos pagos, você precisa enviar um aplicativo verificado.
\ No newline at end of file
+Aplicativos não verificados são oferecidos apenas com planos gratuitos. Para listar planos pagos, você precisa enviar um aplicativo verificado.
diff --git a/translations/pt-BR/data/reusables/notifications-v2/email-notification-caveats.md b/translations/pt-BR/data/reusables/notifications-v2/email-notification-caveats.md
index a8c14fea1992..cf71fdaf4130 100644
--- a/translations/pt-BR/data/reusables/notifications-v2/email-notification-caveats.md
+++ b/translations/pt-BR/data/reusables/notifications-v2/email-notification-caveats.md
@@ -2,4 +2,4 @@ Você receberá e-mails de notificação apenas se tiver optado por receber noti
 
 {% if currentVersion == "free-pro-team@latest" %}
 {% data reusables.user_settings.verify-org-approved-email-domain %}
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/translations/pt-BR/data/reusables/notifications-v2/manage-notifications.md b/translations/pt-BR/data/reusables/notifications-v2/manage-notifications.md
index d9f83e774f0b..0f0b0b016102 100644
--- a/translations/pt-BR/data/reusables/notifications-v2/manage-notifications.md
+++ b/translations/pt-BR/data/reusables/notifications-v2/manage-notifications.md
@@ -1 +1 @@
-1. Na barra lateral esquerda, na lista de repositórios, use a caixa de seleção "Gerenciar notificações" para clicar em **Configurações de notificação**. ![Gerenciar as opções do menu suspenso notificações](/assets/images/help/notifications-v2/manage-notifications-options.png)
\ No newline at end of file
+1. Na barra lateral esquerda, na lista de repositórios, use a caixa de seleção "Gerenciar notificações" para clicar em **Configurações de notificação**. ![Gerenciar as opções do menu suspenso notificações](/assets/images/help/notifications-v2/manage-notifications-options.png)
diff --git a/translations/pt-BR/data/reusables/notifications/shared_state.md b/translations/pt-BR/data/reusables/notifications/shared_state.md
index 1ba21ef43a46..8a3ac4ce0e28 100644
--- a/translations/pt-BR/data/reusables/notifications/shared_state.md
+++ b/translations/pt-BR/data/reusables/notifications/shared_state.md
@@ -1,5 +1,5 @@
 {% tip %}
 
-**Dica:** se você receber notificações da web e por e-mail, você pode sincronizar automaticamente o status lido ou não lido da notificação para que as notificações da web sejam automaticamente marcadas como lidas depois de ler a notificação de e-mail correspondente. Para ativar essa sincronização, seu cliente de e-mail deve ser capaz de ver imagens de {% if currentVersion == "free-pro-team@latest" %}'`notifications@github.com`'{% else %}'the no-reply email address configured by your site administrator'{% endif %}.
+**Dica:** se você receber notificações da web e por e-mail, você pode sincronizar automaticamente o status lido ou não lido da notificação para que as notificações da web sejam automaticamente marcadas como lidas depois de ler a notificação de e-mail correspondente. Para habilitar essa sincronização, o cliente de e-mail deve ser capaz de visualizar imagens de {% if currentVersion == "free-pro-team@latest" %}'`notifications@github. om`'{% else %}'o endereço de e-mail no-reply configurado pelo administrador do site'{% endif %}.
 
 {% endtip %}
diff --git a/translations/pt-BR/data/reusables/organizations/can-require-ssh-cert.md b/translations/pt-BR/data/reusables/organizations/can-require-ssh-cert.md
index 5759102c9490..c01231495329 100644
--- a/translations/pt-BR/data/reusables/organizations/can-require-ssh-cert.md
+++ b/translations/pt-BR/data/reusables/organizations/can-require-ssh-cert.md
@@ -1 +1 @@
-Você pode exigir que os membros usem certificados SSH para acessar os recursos da organização,{% if currentVersion ver_gt "enterprise-server@2.17" %}, a menos que o SSH esteja desativado no seu repositório{% endif %}.
+Você pode exigir que os integrantes usem certificados SSH para acessar os recursos da organização, a menos que o SSH esteja desabilitado no seu repositório.
diff --git a/translations/pt-BR/data/reusables/organizations/oauth_app_restrictions_default.md b/translations/pt-BR/data/reusables/organizations/oauth_app_restrictions_default.md
index b369d2662d58..43c07db1d784 100644
--- a/translations/pt-BR/data/reusables/organizations/oauth_app_restrictions_default.md
+++ b/translations/pt-BR/data/reusables/organizations/oauth_app_restrictions_default.md
@@ -1 +1 @@
-{% if currentVersion == "free-pro-team@latest" %}Quando você cria uma nova organização, {% data variables.product.prodname_oauth_app %} as restrições de acesso são habilitadas por padrão. Os proprietários da organização podem [disable {% data variables.product.prodname_oauth_app %} access restrictions](/articles/disabling-oauth-app-access-restrictions-for-your-organization) a qualquer momento.{% endif %}
+{% if currentVersion == "free-pro-team@latest" %}Ao criar uma nova organização, as restrições de acesso de {% data variables.product.prodname_oauth_app %} são habilitadas por padrão. Os proprietários da organização podem [disable {% data variables.product.prodname_oauth_app %} access restrictions](/articles/disabling-oauth-app-access-restrictions-for-your-organization) a qualquer momento.{% endif %}
diff --git a/translations/pt-BR/data/reusables/organizations/organization-name.md b/translations/pt-BR/data/reusables/organizations/organization-name.md
index a1b7d97e4d20..ac608244bc20 100644
--- a/translations/pt-BR/data/reusables/organizations/organization-name.md
+++ b/translations/pt-BR/data/reusables/organizations/organization-name.md
@@ -1 +1 @@
-1. Under "Organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} account{% endif %} name", digite um nome para a sua conta de organização.![Campo para digitar um nome de organização](/assets/images/help/organizations/new-org-name.png)
+1. Em "Nome da conta da organização", digite um nome para a conta da sua organização. ![Campo para digitar um nome de organização](/assets/images/help/organizations/new-org-name.png)
diff --git a/translations/pt-BR/data/reusables/organizations/organizations_include.md b/translations/pt-BR/data/reusables/organizations/organizations_include.md
index a2bd5f2d19e7..1f373d462e4c 100644
--- a/translations/pt-BR/data/reusables/organizations/organizations_include.md
+++ b/translations/pt-BR/data/reusables/organizations/organizations_include.md
@@ -1,5 +1,5 @@
 As organizações incluem:
-{% if currentVersion == "free-pro-team@latest" %}- Uma opção gratuita, {% data variables.product.prodname_free_team %}, com colaboradores ilimitados em repositórios públicos ilimitados, com recursos completos e repositórios privados ilimitados, com recursos limitados.
+{% if currentVersion == "free-pro-team@latest" %}- Uma opção grátis, {% data variables.product.prodname_free_team %}, com colaboradores ilimitados em repositórios públicos ilimitados, com recursos completos e repositórios privados ilimitados, com recursos limitados.
 - A opção de atualizar para {% data variables.product.prodname_team %} ou {% data variables.product.prodname_ghe_cloud %} para recursos adicionais, incluindo autenticação e gerenciamento sofisticados do usuário e opções de suporte escaladas. {% data reusables.gated-features.more-info %}{% endif %}
 - Associação ilimitada com uma variedade de funções que concedem [different levels of access to the organization and its data](/articles/permission-levels-for-an-organization) (diferentes níveis de acesso à organização e aos seus dados)
 - A capacidade de dar aos membros [a range of access permissions to your organization's repositories](/articles/repository-permission-levels-for-an-organization) (uma série de permissões de acesso aos repositórios da sua organização)
diff --git a/translations/pt-BR/data/reusables/organizations/outside-collaborators-use-seats.md b/translations/pt-BR/data/reusables/organizations/outside-collaborators-use-seats.md
index ad31bbbdf9eb..0de83d9e65e9 100644
--- a/translations/pt-BR/data/reusables/organizations/outside-collaborators-use-seats.md
+++ b/translations/pt-BR/data/reusables/organizations/outside-collaborators-use-seats.md
@@ -1 +1 @@
-{% if currentVersion == "free-pro-team@latest" %}Adicionar um colaborador externo a um repositório privado usará uma das licenças pagas da sua organização. Para obter mais informações, consulte "[Sobre preços por usuário](/articles/about-per-user-pricing/)".{% endif %}
+{% if currentVersion == "free-pro-team@latest" %}A adição um colaborador externo a um repositório privado usará uma das licenças pagas da sua organização. Para obter mais informações, consulte "[Sobre preços por usuário](/articles/about-per-user-pricing/)".{% endif %}
diff --git a/translations/pt-BR/data/reusables/organizations/repository-defaults.md b/translations/pt-BR/data/reusables/organizations/repository-defaults.md
index 96484109fd9a..1e6babd7b846 100644
--- a/translations/pt-BR/data/reusables/organizations/repository-defaults.md
+++ b/translations/pt-BR/data/reusables/organizations/repository-defaults.md
@@ -1 +1 @@
-1. In the left sidebar, click **Repository defaults**. ![Repository defaults tab](/assets/images/help/organizations/repo-defaults-tab.png)
+1. Na barra lateral esquerda, clique em **Padrões do repositório**. ![Aba Padrão do repositório](/assets/images/help/organizations/repo-defaults-tab.png)
diff --git a/translations/pt-BR/data/reusables/organizations/repository-labels.md b/translations/pt-BR/data/reusables/organizations/repository-labels.md
index 9c008a9baf5a..82e1cbdc4e5c 100644
--- a/translations/pt-BR/data/reusables/organizations/repository-labels.md
+++ b/translations/pt-BR/data/reusables/organizations/repository-labels.md
@@ -1 +1 @@
-1. Na barra lateral esquerda, clique em **Repository labels** (Etiquetas de repositório). ![Aba de rótulos do repositório](/assets/images/help/organizations/repo-labels-tab.png)
\ No newline at end of file
+1. Na barra lateral esquerda, clique em **Repository labels** (Etiquetas de repositório). ![Aba de rótulos do repositório](/assets/images/help/organizations/repo-labels-tab.png)
diff --git a/translations/pt-BR/data/reusables/organizations/send-invitation.md b/translations/pt-BR/data/reusables/organizations/send-invitation.md
index 8c3950ea5797..2dd8de57fc6c 100644
--- a/translations/pt-BR/data/reusables/organizations/send-invitation.md
+++ b/translations/pt-BR/data/reusables/organizations/send-invitation.md
@@ -1 +1 @@
-1. Clique em {% if currentVersion == "free-pro-team@latest" %}**Send invitation**(Enviar convite){% else %}**Add member**(Adicionar membro){% endif %}.
+1. Clique em {% if currentVersion == "free-pro-team@latest" %}**Enviar convite**{% else %}**Adicionar integrante**{% endif %}.
diff --git a/translations/pt-BR/data/reusables/organizations/team_maintainers_can.md b/translations/pt-BR/data/reusables/organizations/team_maintainers_can.md
index 0b1c580bc004..5e5415831dd8 100644
--- a/translations/pt-BR/data/reusables/organizations/team_maintainers_can.md
+++ b/translations/pt-BR/data/reusables/organizations/team_maintainers_can.md
@@ -10,6 +10,6 @@ Os membros com permissões de mantenedor da equipe podem:
 - [Adicionar integrantes da organização à equipe](/articles/adding-organization-members-to-a-team)
 - [Remover membros da organização da equipe](/articles/removing-organization-members-from-a-team)
 - [Promover um membro da equipe existente para um mantenedor de equipe](/articles/giving-team-maintainer-permissions-to-an-organization-member)
-- Remover acesso da equipe aos repositórios{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}
-- [Gerenciar atribuição de código para a equipe](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team){% endif %}{% if currentVersion == "free-pro-team@latest" %}
+- Remova o acesso da equipe aos repositórios{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}
+- [Gerencie a atribuição de código de revisão para a equipe](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team){% endif %}{% if currentVersion == "free-pro-team@latest" %}
 - [Gerenciar lembretes agendados para pull requests](/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests){% endif %}
diff --git a/translations/pt-BR/data/reusables/package_registry/admins-can-configure-package-types.md b/translations/pt-BR/data/reusables/package_registry/admins-can-configure-package-types.md
index 181a640dd87f..c73d529f01ee 100644
--- a/translations/pt-BR/data/reusables/package_registry/admins-can-configure-package-types.md
+++ b/translations/pt-BR/data/reusables/package_registry/admins-can-configure-package-types.md
@@ -1,7 +1,7 @@
 {% if currentVersion != "free-pro-team@latest" %}
 {% note %}
 
-**Note:** This package type may not be available for your instance, because site administrators can enable or disable each supported package type. Para obter mais informações, consulte "[Configurar pacotes de suporte para a sua empresa](/enterprise/admin/packages/configuring-packages-support-for-your-enterprise)".
+**Nota:** Este tipo de pacote pode não estar disponível para sua instância, porque os administradores do site podem habilitar ou desabilitar cada tipo de pacote compatível. Para obter mais informações, consulte "[Configurar pacotes de suporte para a sua empresa](/enterprise/admin/packages/configuring-packages-support-for-your-enterprise)".
 
 {% endnote %}
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/translations/pt-BR/data/reusables/package_registry/authenticate-packages.md b/translations/pt-BR/data/reusables/package_registry/authenticate-packages.md
index fb66fb77d025..c4f23eaebf87 100644
--- a/translations/pt-BR/data/reusables/package_registry/authenticate-packages.md
+++ b/translations/pt-BR/data/reusables/package_registry/authenticate-packages.md
@@ -1,9 +1,11 @@
-Você precisa de um token de acesso para publicar, instalar e excluir pacotes no {% data variables.product.prodname_registry %}. Você pode usar um token de acesso pessoal para autenticar com seu nome de usuário diretamente no {% data variables.product.prodname_registry %} ou na API {% data variables.product.prodname_dotcom %}. Ao criar um token de acesso pessoal, você pode atribuir diferentes escopos de token, dependendo da sua necessidade.
+Você precisa de um token de acesso para publicar, instalar e excluir pacotes no {{ site.data.variables.product.prodname_registry }}. Você pode usar um token de acesso pessoal para autenticar com seu nome de usuário diretamente no {% data variables.product.prodname_registry %} ou na API {% data variables.product.prodname_dotcom %}. Ao criar um token de acesso pessoal, você pode atribuir diferentes escopos de token, dependendo da sua necessidade.
 
 {% if currentVersion == "free-pro-team@latest" %}
-To authenticate using a {% data variables.product.prodname_actions %} workflow:
-- For package registries (`PACKAGE-REGISTRY.pkg.github.com/OWNER/REPOSITORY/IMAGE-NAME`), you can use a `GITHUB_TOKEN`.
-- For the container registry (`ghcr.io/OWNER/IMAGE-NAME`), you must use a personal access token.
+Para efetuar a autenticação usando um
+fluxo de trabalho do {% data variables.product.prodname_actions %}:
+- Para registros de pacotes (`PACKAGE-REGISTRY.pkg.github.com/OWNER/REPOSITORY/IMAGE-NAME`), você pode usar um `GITHUB_TOKEN`.
+- Para o registro do contêiner (`ghcr.io/OWNER/IMAGE-NAME`), você deve usar um token de acesso pessoal.
 {% else %}
-To authenticate to {% data variables.product.prodname_registry %} using a {% data variables.product.prodname_actions %} workflow, you must use `GITHUB_TOKEN`.
+Para efetuar a autenticação em
+{% data variables.product.prodname_registry %} usando um fluxo de trabalho de {% data variables.product.prodname_actions %}, você deve usar `GITHUB_TOKEN`.
 {% endif %}
diff --git a/translations/pt-BR/data/reusables/package_registry/authenticate-to-container-registry-steps.md b/translations/pt-BR/data/reusables/package_registry/authenticate-to-container-registry-steps.md
new file mode 100644
index 000000000000..e485cdec2cb4
--- /dev/null
+++ b/translations/pt-BR/data/reusables/package_registry/authenticate-to-container-registry-steps.md
@@ -0,0 +1,25 @@
+1. Crie um novo token de acesso pessoal (PAT) com os escopos apropriados para as tarefas que você deseja realizar. Se sua organização exigir SSO, você deverá habilitar o SSO para seu novo token.
+  {% warning %}
+
+  **Observação:** Se você selecionar o escopo `write:packages`, desmarque o escopo `repositório` ao criar o PAT. Adicionar um PAT com o escopo de `repositório` como um segredo no repositório permite que a credencial seja acessível a todos os colaboradores do repositório. Isso fornece um acesso adicional desnecessário quando um PAT com o escopo do `repositório` é usado em uma ação. Para obter mais informações sobre as práticas de segurança recomendadas para ações, consulte "[Fortalecimento de segurança para o GitHub Actions](/actions/getting-started-with-github-actions/security-hardening-for-github-actions#considering-cross-repository-access)".
+
+  {% endwarning %}
+
+    - Selecione o escopo `read:packages` para fazer o download de imagens de contêineres e ler seus metadados.
+    - Selecione o escopo `write:packages` para fazer o download e o upload de imagens de contêiner e ler e escrever seus metadados.
+    - Selecione o escopo `delete:packages` para excluir imagens de contêineres.
+
+  Para obter mais informações, consulte "[Criar um token de acesso pessoal para a linha de comando](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)".
+
+2. Salve seu PAT. Recomendamos salvar o seu PAT como uma variável de ambiente.
+  ```shell
+  $ export CR_PAT=YOUR_TOKEN
+  ```
+3. Ao usar a CLI para seu tipo de container, faça login em
+serviço de {% data variables.product.prodname_github_container_registry %} em `ghcr.io`.
+  {% raw %}
+  ```shell
+  $ echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin
+  > Login Succeeded
+  ```
+  {% endraw %}
diff --git a/translations/pt-BR/data/reusables/package_registry/authenticate_with_pat_for_container_registry.md b/translations/pt-BR/data/reusables/package_registry/authenticate_with_pat_for_container_registry.md
new file mode 100644
index 000000000000..5ab3a538022b
--- /dev/null
+++ b/translations/pt-BR/data/reusables/package_registry/authenticate_with_pat_for_container_registry.md
@@ -0,0 +1,9 @@
+{% if currentVersion == "free-pro-team@latest" %}
+Se você deseja efetuar a autenticação em
+{% data variables.product.prodname_github_container_registry %} em um fluxo de trabalho de {% data variables.product.prodname_actions %}, em seguida, você deverá usar um token de acesso pessoal (PAT). Atualmente, o `GITHUB_TOKEN` não tem as permissões necessárias. No beta de {% data variables.product.prodname_github_container_registry %}, a única forma compatível de de autenticação é o PAT.
+
+Os PATs podem conceder amplo acesso à sua conta. Recomendamos selecionar apenas o acesso de leitura ou gravação ou excluir o `pacote` ao criar um PAT para efetuar a autenticação no {% data variables.product.prodname_container_registry %}. Evite incluir o escopo do `repositório` em um PAT usado por um fluxo de trabalho do GitHub Actions pois ele concede acesso adicional desnecessário.
+
+Se você desejar usar o {% data variables.product.prodname_container_registry %} em ações durante a versão beta, siga nossas práticas de segurança recomendadas para o uso do PAT em[Fortalecimento da segurança para o GitHub Actions](/actions/getting-started-with-github-actions/security-hardening-for-github-actions#considering-cross-repository-access)".
+
+{% endif %}
diff --git a/translations/pt-BR/data/reusables/package_registry/billing-for-container-registry.md b/translations/pt-BR/data/reusables/package_registry/billing-for-container-registry.md
index 7cf8e2459f34..d24584e0b035 100644
--- a/translations/pt-BR/data/reusables/package_registry/billing-for-container-registry.md
+++ b/translations/pt-BR/data/reusables/package_registry/billing-for-container-registry.md
@@ -1,3 +1,3 @@
-During the {% data variables.product.prodname_github_container_registry %} beta, both the new {% data variables.product.prodname_container_registry %} and existing {% data variables.product.prodname_registry %} Docker registry will be free. For more information about the {% data variables.product.prodname_registry %} Docker registry, see "[Configuring Docker for use with {% data variables.product.prodname_registry %}](/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)."
+Durante o beta de {% data variables.product.prodname_github_container_registry %}, tanto o novo {% data variables.product.prodname_container_registry %} quanto o registro do Docker de {% data variables.product.prodname_registry %} existente será grátis. Para obter mais informações sobre o registro Docker do {% data variables.product.prodname_registry %}, consulte "[Configurar o Docker para uso com {% data variables.product.prodname_registry %}](/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)".
 
-After the beta, the same billing and storage rates that other {% data variables.product.prodname_registry %} registries use will apply to the container registry. For more information, see "[About  billing for {% data variables.product.prodname_registry %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)."
+Após o beta, as mesmas taxas de cobrança e armazenamento que os outros registros do {% data variables.product.prodname_registry %} usam serão aplicadas ao registro do contêiner. Para obter mais informações, consulte "[Sobre a cobrança para {% data variables.product.prodname_registry %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)".
diff --git a/translations/pt-BR/data/reusables/package_registry/container-registry-beta-billing-note.md b/translations/pt-BR/data/reusables/package_registry/container-registry-beta-billing-note.md
index e3f599ad2466..0bce7d1d39e6 100644
--- a/translations/pt-BR/data/reusables/package_registry/container-registry-beta-billing-note.md
+++ b/translations/pt-BR/data/reusables/package_registry/container-registry-beta-billing-note.md
@@ -1,5 +1,5 @@
 {% note %}
 
-**Billing update for container image storage:** During the beta phase of {% data variables.product.prodname_github_container_registry %}, Docker image storage and bandwidth are free for the old `docker.pkg.github.com` and new `ghcr.io` hosting services. Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry)."
+**Atualização de cobrança para armazenamento de imagem contêiner:** Durante a fase beta de {% data variables.product.prodname_github_container_registry %}, o armazenamento de imagem do Docker e a largura de banda são grátis para os serviços de hospedagem antigo `docker. kg.github.com` e novo `ghcr.io`. Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry)."
 
 {% endnote %}
diff --git a/translations/pt-BR/data/reusables/package_registry/container-registry-feature-highlights.md b/translations/pt-BR/data/reusables/package_registry/container-registry-feature-highlights.md
index 935ba7b2bf38..5479ef04af0c 100644
--- a/translations/pt-BR/data/reusables/package_registry/container-registry-feature-highlights.md
+++ b/translations/pt-BR/data/reusables/package_registry/container-registry-feature-highlights.md
@@ -1,4 +1,4 @@
-With the container registry you can:
-- Store container images within your organization and user account, rather than a repository.
-- Set fine-grained permissions and visibility independent of repository permissions and visibility.
-- Access public container images anonymously.
+Com o registro do container, você pode:
+- Armazenar imagens de contêiner na sua conta de organização e usuário, em vez de um repositório.
+- Definir permissões e visibilidade refinadas e independentes das permissões e visibilidade do repositório.
+- Acessar imagens de contêineres públicos anonimamente.
diff --git a/translations/pt-BR/data/reusables/package_registry/create-npmrc-owner-step.md b/translations/pt-BR/data/reusables/package_registry/create-npmrc-owner-step.md
index 01a9f787d56b..640ebcfc6514 100644
--- a/translations/pt-BR/data/reusables/package_registry/create-npmrc-owner-step.md
+++ b/translations/pt-BR/data/reusables/package_registry/create-npmrc-owner-step.md
@@ -5,11 +5,11 @@
 registry=https://npm.pkg.github.com/OWNER
   ```
 {% else %}
-  If subdomain isolation is enabled:
+  Se o isolamento de subdomínio estiver habilitado:
   ```shell
   registry=https://npm.HOSTNAME/OWNER
   ```
-  If subdomain isolation is disabled:
+  Se o isolamento de subdomínio estiver desabilitado:
   ```shell
   https://HOSTNAME/_registry/npm/OWNER
   ```
diff --git a/translations/pt-BR/data/reusables/package_registry/docker_registry_deprecation_status.md b/translations/pt-BR/data/reusables/package_registry/docker_registry_deprecation_status.md
new file mode 100644
index 000000000000..79e9650f348f
--- /dev/null
+++ b/translations/pt-BR/data/reusables/package_registry/docker_registry_deprecation_status.md
@@ -0,0 +1,5 @@
+{% warning %}
+
+**Note:** The {% data variables.product.prodname_registry %} Docker registry will be superseded by {% data variables.product.prodname_github_container_registry %}{% if currentVersion != "free-pro-team@latest" %} in a future {% data variables.product.product_name %} release{% endif %}.{% if currentVersion == "free-pro-team@latest" %} To learn how to migrate your existing Docker images and any workflows using them, see "[Migrating to {% data variables.product.prodname_github_container_registry %} for Docker images](/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images)" and "[Getting started with {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry)."{% endif %}
+
+{% endwarning %}
diff --git a/translations/pt-BR/data/reusables/package_registry/package-immutability.md b/translations/pt-BR/data/reusables/package_registry/package-immutability.md
index 32893b033870..e4e2698563f6 100644
--- a/translations/pt-BR/data/reusables/package_registry/package-immutability.md
+++ b/translations/pt-BR/data/reusables/package_registry/package-immutability.md
@@ -1,3 +1,5 @@
-Para evitar confusões e criar problemas, {% data variables.product.prodname_dotcom %} reserva-se permanentemente o nome e o número da versão de um pacote. Mesmo que um pacote inteiro seja excluído, você não poderá reutilizar o nome de pacote excluído em qualquer repositório pertencente à mesma conta.
+**Pacotes públicos:** Para evitar confusões e problemas de criação, {% data variables.product.prodname_dotcom %} reserva permanentemente o nome e o número da versão de um pacote. Mesmo que um pacote inteiro seja excluído, você não poderá reutilizar o nome de pacote excluído em qualquer repositório pertencente à mesma conta.
+
+**Pacotes privados:** Se todas as versões de um pacote privado forem excluídas, você poderá publicar um pacote com um nome e versão usados anteriormente.
 
 Para revisar ou substituir uma versão do pacote, recomendamos que você publique uma nova versão do seu pacote.
diff --git a/translations/pt-BR/data/reusables/package_registry/package-settings-from-org-level.md b/translations/pt-BR/data/reusables/package_registry/package-settings-from-org-level.md
index e3974994a578..fd83d333cb9e 100644
--- a/translations/pt-BR/data/reusables/package_registry/package-settings-from-org-level.md
+++ b/translations/pt-BR/data/reusables/package_registry/package-settings-from-org-level.md
@@ -1,4 +1,4 @@
-1. On {% data variables.product.prodname_dotcom %}, navigate to the main page of your organization.
-2. Under your organization name, click **Packages**. ![Botão de convite de acesso ao contêiner](/assets/images/help/package-registry/org-tab-for-packages.png)
-3. Search for and select your package.
-4. In the top right of your container image's landing page, click **Package settings**. ![Package settings button](/assets/images/help/package-registry/packages-settings-from-package-landing-page.png)
+1. Em {% data variables.product.prodname_dotcom %}, acesse a página principal da sua organização.
+2. No nome da sua organização, clique em **Pacotes**. ![Botão de convite de acesso ao contêiner](/assets/images/help/package-registry/org-tab-for-packages.png)
+3. Procurar e selecionar o seu pacote.
+4. No canto superior direito da imagem do seu contêiner, clique em **Configurações do pacote**. ![Botão de configurações do pacote](/assets/images/help/package-registry/packages-settings-from-package-landing-page.png)
diff --git a/translations/pt-BR/data/reusables/package_registry/package-settings-from-user-level.md b/translations/pt-BR/data/reusables/package_registry/package-settings-from-user-level.md
index 73001693a27c..f3f5d3c5826f 100644
--- a/translations/pt-BR/data/reusables/package_registry/package-settings-from-user-level.md
+++ b/translations/pt-BR/data/reusables/package_registry/package-settings-from-user-level.md
@@ -1,5 +1,5 @@
-1. On {% data variables.product.prodname_dotcom %}, navigate to the main page of your user account.
-2. In the top right corner of {% data variables.product.product_name %}, click your profile photo, then click **Your profile**. ![Profile photo](/assets/images/help/profile/top_right_avatar.png)
-3. On your profile page, in the top right, click **Packages**. ![Packages option on profile page](/assets/images/help/package-registry/packages-from-user-profile.png)
-3. Search for and select your package.
-4. In the top right of your container image's landing page, click **Package settings**. ![Package settings button](/assets/images/help/package-registry/packages-settings-from-package-landing-page.png)
+1. Em {% data variables.product.prodname_dotcom %}, acesse a página principal da sua conta de usuário.
+2. No canto superior direito de {% data variables.product.product_name %}, clique na sua foto de perfil e, em seguida, clique em **Seu perfil**. ![Foto de perfil](/assets/images/help/profile/top_right_avatar.png)
+3. Na sua página de perfil, no canto superior direito, clique em **Pacotes**. ![Opção de pacotes na página de perfil](/assets/images/help/package-registry/packages-from-user-profile.png)
+3. Procurar e selecionar o seu pacote.
+4. No canto superior direito da imagem do seu contêiner, clique em **Configurações do pacote**. ![Botão de configurações do pacote](/assets/images/help/package-registry/packages-settings-from-package-landing-page.png)
diff --git a/translations/pt-BR/data/reusables/package_registry/packages-ghes-release-stage.md b/translations/pt-BR/data/reusables/package_registry/packages-ghes-release-stage.md
index 66d73926c699..08d901be5fc7 100644
--- a/translations/pt-BR/data/reusables/package_registry/packages-ghes-release-stage.md
+++ b/translations/pt-BR/data/reusables/package_registry/packages-ghes-release-stage.md
@@ -1,7 +1,7 @@
 {% if currentVersion != "free-pro-team@latest" %}
 {% note %}
 
-**Note:** {% data variables.product.prodname_registry %} is currently in beta for {% data variables.product.prodname_ghe_server %} 2.22. To join the beta for your instance, use the [sign-up form](https://resources.github.com/beta-signup/).
+**Observação:** {% data variables.product.prodname_registry %} está atualmente em beta para {% data variables.product.prodname_ghe_server %} 2.22. Para participar da versão beta da sua instância, use o [formulário de inscrição](https://resources.github.com/beta-signup/).
 
 {% endnote %}
 {% endif %}
diff --git a/translations/pt-BR/data/reusables/package_registry/public-or-private-packages.md b/translations/pt-BR/data/reusables/package_registry/public-or-private-packages.md
index 0aa2684f471c..24cfa2563303 100644
--- a/translations/pt-BR/data/reusables/package_registry/public-or-private-packages.md
+++ b/translations/pt-BR/data/reusables/package_registry/public-or-private-packages.md
@@ -1 +1 @@
-Você pode publicar pacotes em um repositório público (pacotes públicos) para compartilhar com todos os {% data variables.product.prodname_dotcom %}, ou em um repositório privado (pacotes privados) para compartilhar com os colaboradores ou uma organização.
+Você pode publicar pacotes em um repositório público (pacotes públicos) para compartilhar com {% if currentVersion == "free-pro-team@latest" %}tudo de {% data variables.product.prodname_dotcom %}{% else %}todos na sua instância{% endif %}, ou em um repositório privado (pacotes privados) para compartilhar com os colaboradores ou uma organização.
diff --git a/translations/pt-BR/data/reusables/package_registry/repository_connection_steps.md b/translations/pt-BR/data/reusables/package_registry/repository_connection_steps.md
index 222259c82239..3bedce5849d4 100644
--- a/translations/pt-BR/data/reusables/package_registry/repository_connection_steps.md
+++ b/translations/pt-BR/data/reusables/package_registry/repository_connection_steps.md
@@ -1,3 +1,3 @@
-1. Under your package versions, click **Connect repository**. ![Connect a repository button on packages landing page](/assets/images/help/package-registry/connect-repository.png)
+1. Na versão do pacote, clique em **Conectar repositório**. ![Botão para conectar-se a um repositório na página inicial de pacotes](/assets/images/help/package-registry/connect-repository.png)
 
-1. Select a repository, then click **Connect repository**. ![Connect a repository button in repository selection pop-up window](/assets/images/help/package-registry/select_a_repo.png)
+1. Selecione um repositório e, em seguida, clique em **Conectar repositório**. ![Botão de conectar-se a um repositório na janela de pop-up de seleção de repositório](/assets/images/help/package-registry/select_a_repo.png)
diff --git a/translations/pt-BR/data/reusables/package_registry/required-scopes.md b/translations/pt-BR/data/reusables/package_registry/required-scopes.md
index b6cd2fa891b8..ee398bcc9a5e 100644
--- a/translations/pt-BR/data/reusables/package_registry/required-scopes.md
+++ b/translations/pt-BR/data/reusables/package_registry/required-scopes.md
@@ -1 +1 @@
-You must use a personal access token with the appropriate scopes to publish and install packages in {% data variables.product.prodname_registry %}. Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_registry %}](/packages/publishing-and-managing-packages/about-github-packages#authenticating-to-github-packages)."
+Você deve usar um token de acesso pessoal com os escopos apropriados para publicar e instalar pacotes no {% data variables.product.prodname_registry %}. Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_registry %}](/packages/publishing-and-managing-packages/about-github-packages#authenticating-to-github-packages)."
diff --git a/translations/pt-BR/data/reusables/package_registry/verify_repository_field.md b/translations/pt-BR/data/reusables/package_registry/verify_repository_field.md
index 0a47e1cb281e..ad2c93d8b442 100644
--- a/translations/pt-BR/data/reusables/package_registry/verify_repository_field.md
+++ b/translations/pt-BR/data/reusables/package_registry/verify_repository_field.md
@@ -1 +1 @@
-1. Verify the `repository` field in your project's *package.json*. The `repository` field must match the URL for your {% data variables.product.prodname_dotcom %} repository. For example, if your repository URL is `github.com/my-org/test` then the repository field should be `git://github.com/my-org/test.git`.
+1. Verifique o campo `repositório` no *package.json* do seu projeto. O campo `repositório` deve corresponder à URL do seu repositório de {% data variables.product.prodname_dotcom %}. Por exemplo, se a URL do repositório for `github.com/my-org/test`, o campo do repositório deverá ser `git://github.com/my-org/test.git`.
diff --git a/translations/pt-BR/data/reusables/pages/about-front-matter.md b/translations/pt-BR/data/reusables/pages/about-front-matter.md
index 86ced932d97e..bcf8773373d9 100644
--- a/translations/pt-BR/data/reusables/pages/about-front-matter.md
+++ b/translations/pt-BR/data/reusables/pages/about-front-matter.md
@@ -1 +1 @@
-To set variables and metadata, such as a title and layout, for a page or post on your site, you can add YAML front matter to the top of any Markdown or HTML file. For more information, see "[Front Matter](https://jekyllrb.com/docs/front-matter/)" in the Jekyll documentation.
+Para definir variáveis e metadados, como um título e layout, para uma página ou publicação no seu site, você pode adicionar a página inicial YAML na parte superior de qualquer arquivo Markdown ou HTML. Para obter mais informações, consulte "[Front Matter](https://jekyllrb.com/docs/front-matter/)" na documentação do Jekyll.
diff --git a/translations/pt-BR/data/reusables/pages/add-jekyll-theme.md b/translations/pt-BR/data/reusables/pages/add-jekyll-theme.md
index 9a15a7e09fc7..1faa151d21b9 100644
--- a/translations/pt-BR/data/reusables/pages/add-jekyll-theme.md
+++ b/translations/pt-BR/data/reusables/pages/add-jekyll-theme.md
@@ -1 +1 @@
-You can add a Jekyll theme to your {% data variables.product.prodname_pages %} site to customize the look and feel of your site.
+É possível adicionar um tema do Jekyll ao site do {% data variables.product.prodname_pages %} para personalizar a aparência do seu site.
diff --git a/translations/pt-BR/data/reusables/pages/admin-must-push.md b/translations/pt-BR/data/reusables/pages/admin-must-push.md
index c5380c73fa61..92575e89f4ca 100644
--- a/translations/pt-BR/data/reusables/pages/admin-must-push.md
+++ b/translations/pt-BR/data/reusables/pages/admin-must-push.md
@@ -1,5 +1,5 @@
 {% tip %}
 
-**Note**: If your site{% if currentVersion ver_lt "enterprise-server@2.22" %}'s source files are located in the default publishing source—`master` for user and organization sites or `gh-pages` for project sites—but your site{% endif %} has not published automatically, make sure someone with admin permissions and a verified email address has pushed to the publishing source.
+**Observação**: Se os arquivos de origem de{% if currentVersion ver_lt "enterprise-server@2.23" %} do site estão localizados na fonte de publicação padrão —`mestre` para sites de usuário e organização ou `gh-pages` para sites de projeto — mas seu site{% endif %} não fez a publicação automaticamente, certifique-se de que alguém com permissões de administrador e um endereço de e-mail verificado tenha feito push para a fonte de publicação.
 
 {% endtip %}
diff --git a/translations/pt-BR/data/reusables/pages/best-with-supported-themes.md b/translations/pt-BR/data/reusables/pages/best-with-supported-themes.md
index 50539af8e7eb..7974ba96fa46 100644
--- a/translations/pt-BR/data/reusables/pages/best-with-supported-themes.md
+++ b/translations/pt-BR/data/reusables/pages/best-with-supported-themes.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-These instructions work best with themes that are officially supported by {% data variables.product.prodname_pages %}. For a complete list of supported themes, see "[Supported themes](https://pages.github.com/themes/)" on the {% data variables.product.prodname_pages %} site.
+Essas instruções funcionam melhor com temas que são oficialmente suportados por
+{% data variables.product.prodname_pages %}. Para obter uma lista completa dos temas compatíveis, consulte "[Temas compatíveis](https://pages.github.com/themes/)" no site do {% data variables.product.prodname_pages %}.
 {% endif %}
diff --git a/translations/pt-BR/data/reusables/pages/build-failure-email-server.md b/translations/pt-BR/data/reusables/pages/build-failure-email-server.md
index 83a095a22759..036e9d077525 100644
--- a/translations/pt-BR/data/reusables/pages/build-failure-email-server.md
+++ b/translations/pt-BR/data/reusables/pages/build-failure-email-server.md
@@ -1,7 +1,7 @@
 {% if currentVersion != "free-pro-team@latest" %}
   {% tip %}
 
-  You will only receive an email if outbound email support is enabled on {% data variables.product.product_location_enterprise %}. Para mais informações, entre em contato com o administrador do site.
+  Você só receberá um e-mail se o suporte a e-mails de saída estiver habilitado no {% data variables.product.product_location_enterprise %}. Para mais informações, entre em contato com o administrador do site.
 
   {% endtip %}
 {% endif %}
diff --git a/translations/pt-BR/data/reusables/pages/build-locally-download-cname.md b/translations/pt-BR/data/reusables/pages/build-locally-download-cname.md
index 9d2346f1a456..16c9042e18b1 100644
--- a/translations/pt-BR/data/reusables/pages/build-locally-download-cname.md
+++ b/translations/pt-BR/data/reusables/pages/build-locally-download-cname.md
@@ -1 +1 @@
-1. If you use a static site generator to build your site locally and push the generated files to {% data variables.product.product_name %}, pull the commit that added the _CNAME_ file to your local repository. For more information, see "[Troubleshooting custom domains and {% data variables.product.prodname_pages %}](/articles/troubleshooting-custom-domains-and-github-pages#cname-errors)."
+1. Se usar um gerador de site estático para criar seu site localmente e fizer push dos arquivos gerados para {% data variables.product.product_name %}, faça pull do commit que adicionou o arquivo _CNAME_ ao seu repositório local. Para obter mais informações, consulte "[Solucionar problemas de domínios personalizados e {% data variables.product.prodname_pages %}](/articles/troubleshooting-custom-domains-and-github-pages#cname-errors)".
diff --git a/translations/pt-BR/data/reusables/pages/configure-publishing-source.md b/translations/pt-BR/data/reusables/pages/configure-publishing-source.md
index b0e6f87fbb32..4052ec691219 100644
--- a/translations/pt-BR/data/reusables/pages/configure-publishing-source.md
+++ b/translations/pt-BR/data/reusables/pages/configure-publishing-source.md
@@ -1 +1 @@
-1. Configure your publishing source. Para obter mais informações, consulte "[Configurar uma fonte de publicação para seu site do {% data variables.product.prodname_pages %}](/articles/configuring-a-publishing-source-for-your-github-pages-site#choosing-a-publishing-source)".
+1. Configure a sua fonte de publicação. Para obter mais informações, consulte "[Configurar uma fonte de publicação para seu site do {% data variables.product.prodname_pages %}](/articles/configuring-a-publishing-source-for-your-github-pages-site#choosing-a-publishing-source)".
diff --git a/translations/pt-BR/data/reusables/pages/contact-dns-provider.md b/translations/pt-BR/data/reusables/pages/contact-dns-provider.md
index c3d31b2f5d27..bc87d709d5e6 100644
--- a/translations/pt-BR/data/reusables/pages/contact-dns-provider.md
+++ b/translations/pt-BR/data/reusables/pages/contact-dns-provider.md
@@ -1 +1 @@
-For more information about how to create the correct record, see your DNS provider's documentation.
+Para obter mais informações sobre como criar o registro correto, consulte a documentação do provedor do DNS.
diff --git a/translations/pt-BR/data/reusables/pages/create-repo-name.md b/translations/pt-BR/data/reusables/pages/create-repo-name.md
index efdd7386d630..95dbc16dbb17 100644
--- a/translations/pt-BR/data/reusables/pages/create-repo-name.md
+++ b/translations/pt-BR/data/reusables/pages/create-repo-name.md
@@ -1 +1 @@
-1. Digite um nome para o repositório e uma descrição opcional. If you're creating a user or organization site, your repository must be named `.github.io` or `.github.io`. Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_pages %}](/articles/about-github-pages#types-of-github-pages-sites)". ![Campo Create repository (Criar repositório)](/assets/images/help/pages/create-repository-name-pages.png)
+1. Digite um nome para o repositório e uma descrição opcional. Se você estiver criando um site de usuário ou organização, o seu repositório deve ser denominado `.github.io` ou `.github.io`. Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_pages %}](/articles/about-github-pages#types-of-github-pages-sites)". ![Campo Create repository (Criar repositório)](/assets/images/help/pages/create-repository-name-pages.png)
diff --git a/translations/pt-BR/data/reusables/pages/decide-publishing-source.md b/translations/pt-BR/data/reusables/pages/decide-publishing-source.md
index 2736d7e2b48d..57f503ac1e64 100644
--- a/translations/pt-BR/data/reusables/pages/decide-publishing-source.md
+++ b/translations/pt-BR/data/reusables/pages/decide-publishing-source.md
@@ -1 +1 @@
-1. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}Decide{% else %}If you're creating a project site, decide{% endif %} which publishing source you want to use. {% if currentVersion ver_lt "enterprise-server@2.22" %}If you're creating a user or organization site, you must store your site's source code on the `master` branch.{% endif %} For more information, see "[About {% data variables.product.prodname_pages %}](/articles/about-github-pages#publishing-sources-for-github-pages-sites)."
+1. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 2" %}Decida{% else %}Se você estiver criando um site de projeto, decida{% endif %} qual fonte de publicação você deseja usar. {% if currentVersion ver_lt "enterprise-server@2. 3" %}Se você estiver criando um site de usuário ou organização, você deverá armazenar o código-fonte do seu site no branch `mestre`.{% endif %} Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_pages %}](/articles/about-github-pages#publishing-sources-for-github-pages-sites)".
diff --git a/translations/pt-BR/data/reusables/pages/default-domain-information.md b/translations/pt-BR/data/reusables/pages/default-domain-information.md
index c0e57142b4ed..1de8d8aba3a4 100644
--- a/translations/pt-BR/data/reusables/pages/default-domain-information.md
+++ b/translations/pt-BR/data/reusables/pages/default-domain-information.md
@@ -1 +1 @@
-For more information about the default domain for your site, see "[About {% data variables.product.prodname_pages %}](/articles/about-github-pages#types-of-github-pages-sites)."
+Para obter mais informações sobre o domínio-padrão de seu site, consulte "[Sobre o {% data variables.product.prodname_pages %}](/articles/about-github-pages#types-of-github-pages-sites)".
diff --git a/translations/pt-BR/data/reusables/pages/enforce-https-custom-domain.md b/translations/pt-BR/data/reusables/pages/enforce-https-custom-domain.md
index 8230412d8495..6e0989a7bcc9 100644
--- a/translations/pt-BR/data/reusables/pages/enforce-https-custom-domain.md
+++ b/translations/pt-BR/data/reusables/pages/enforce-https-custom-domain.md
@@ -1 +1 @@
-1. Optionally, to enforce HTTPS encryption for your site, select **Enforce HTTPS**. It can take up to 24 hours before this option is available. Para obter mais informações, consulte "[Proteger seu site do {% data variables.product.prodname_pages %} com HTTPS](/articles/securing-your-github-pages-site-with-https)". ![Enforce HTTPS for custom domains option](/assets/images/help/pages/enforce-https-custom-domains.png)
+1. Opcionalmente, para aplicar criptografia de HTTPS no seu site, selecione **Exigir HTTPS**. Pode levar até 24 horas para que esta opção fique disponível. Para obter mais informações, consulte "[Proteger seu site do {% data variables.product.prodname_pages %} com HTTPS](/articles/securing-your-github-pages-site-with-https)". ![Opção de aplicar HTTPS para domínios personalizados](/assets/images/help/pages/enforce-https-custom-domains.png)
diff --git a/translations/pt-BR/data/reusables/pages/jekyll-install-troubleshooting.md b/translations/pt-BR/data/reusables/pages/jekyll-install-troubleshooting.md
index 954c6ad70362..b9701dd5bcb2 100644
--- a/translations/pt-BR/data/reusables/pages/jekyll-install-troubleshooting.md
+++ b/translations/pt-BR/data/reusables/pages/jekyll-install-troubleshooting.md
@@ -2,7 +2,7 @@
 
 {% tip %}
 
-**Dica:** se vir um erro do Ruby ao tentar instalar o Jekyll usando o Bundler, talvez você precise usar um gerenciador de pacotes, como o [RVM](https://rvm.io/) ou [Homebrew](http://brew.sh/), para gerenciar a instalação do Ruby. For more information, see "[Troubleshooting](https://jekyllrb.com/docs/troubleshooting/#jekyll--macos)" in the Jekyll documentation.
+**Dica:** se vir um erro do Ruby ao tentar instalar o Jekyll usando o Bundler, talvez você precise usar um gerenciador de pacotes, como o [RVM](https://rvm.io/) ou [Homebrew](http://brew.sh/), para gerenciar a instalação do Ruby. Para obter mais informações, consulte "[Solução de problemas](https://jekyllrb.com/docs/troubleshooting/#jekyll--macos)" na documentação do Jekyll.
 
 {% endtip %}
 
diff --git a/translations/pt-BR/data/reusables/pages/must-have-repo-first.md b/translations/pt-BR/data/reusables/pages/must-have-repo-first.md
index 9ff4bc2b2d77..eb954d375230 100644
--- a/translations/pt-BR/data/reusables/pages/must-have-repo-first.md
+++ b/translations/pt-BR/data/reusables/pages/must-have-repo-first.md
@@ -1 +1 @@
-Before you can create your site, you must have a repository for your site on {% data variables.product.product_name %}. If you're not creating your site in an existing repository, see "[Creating a repository for your site](#creating-a-repository-for-your-site)."
+Antes de criar seu site, você deve ter um repositório para seu site no {% data variables.product.product_name %}. Se você não estiver criando o site em um repositório existente, consulte "[Criar um repositório para o site](#creating-a-repository-for-your-site)".
diff --git a/translations/pt-BR/data/reusables/pages/navigate-publishing-source.md b/translations/pt-BR/data/reusables/pages/navigate-publishing-source.md
index e7528537aaa6..ac08d0037c2b 100644
--- a/translations/pt-BR/data/reusables/pages/navigate-publishing-source.md
+++ b/translations/pt-BR/data/reusables/pages/navigate-publishing-source.md
@@ -1 +1 @@
-1. Navigate to the publishing source for your site. Para obter mais informações sobre fontes de publicação, consulte "[Sobre o {% data variables.product.prodname_pages %}](/articles/about-github-pages#publishing-sources-for-github-pages-sites)".
+1. Navegue até a fonte de publicação do seu site. Para obter mais informações sobre fontes de publicação, consulte "[Sobre o {% data variables.product.prodname_pages %}](/articles/about-github-pages#publishing-sources-for-github-pages-sites)".
diff --git a/translations/pt-BR/data/reusables/pages/navigate-site-repo.md b/translations/pt-BR/data/reusables/pages/navigate-site-repo.md
index 1ac6a42f40f2..f5bf51b78b96 100644
--- a/translations/pt-BR/data/reusables/pages/navigate-site-repo.md
+++ b/translations/pt-BR/data/reusables/pages/navigate-site-repo.md
@@ -1 +1 @@
-1. On {% data variables.product.product_name %}, navigate to your site's repository.
+1. Em {% data variables.product.product_name %}, acesse o repositório do seu site.
diff --git a/translations/pt-BR/data/reusables/pages/new-or-existing-repo.md b/translations/pt-BR/data/reusables/pages/new-or-existing-repo.md
index 15ab4d06ec6a..f8c635ee36bd 100644
--- a/translations/pt-BR/data/reusables/pages/new-or-existing-repo.md
+++ b/translations/pt-BR/data/reusables/pages/new-or-existing-repo.md
@@ -1,3 +1,3 @@
-If your site is an independent project, you can create a new repository to store your site's source code. If your site is an independent project, you can create a new repository to store your site's source code.
+Se o seu site for um projeto independente, você pode criar um novo repositório para armazenar o código-fonte do seu site. Se o seu site estiver associado a um projeto existente, você poderá adicionar o código-fonte {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 2" %} ao repositório do projeto em uma pasta `/docs` no branch-padrão ou em um branch diferente.{% else %}para o seu site para um branch de `gh-pages` ou uma pasta `docs` no branch `mestre` no repositório do projeto.{% endif %} Por exemplo, se você estiver criando um site para publicar a documentação de um projeto que já está em {% data variables.product.product_name %}, você pode querer armazenar o código-fonte para o site no mesmo repositório do projeto.
 
-If you want to create a site in an existing repository, skip to the "[Creating your site](#creating-your-site)" section.
+Se você deseja criar um site em um repositório existente, pule para a seção "[Criar o seu site](#creating-your-site).
diff --git a/translations/pt-BR/data/reusables/pages/recommend-bundler.md b/translations/pt-BR/data/reusables/pages/recommend-bundler.md
index 704cd9342040..ebc8885f8179 100644
--- a/translations/pt-BR/data/reusables/pages/recommend-bundler.md
+++ b/translations/pt-BR/data/reusables/pages/recommend-bundler.md
@@ -1,4 +1,4 @@
-Recomendamos o uso do [Bundler](http://bundler.io/) para instalar e executar o Jekyll. O Bundler gerencia as dependências do gem do Ruby, reduz os erros de compilação do Jekyll e evita erros relacionados ao ambiente. To install Bundler:
+Recomendamos o uso do [Bundler](http://bundler.io/) para instalar e executar o Jekyll. O Bundler gerencia as dependências do gem do Ruby, reduz os erros de compilação do Jekyll e evita erros relacionados ao ambiente. Para instalar o bundler:
 
- 1. Install Ruby. For more information, see "[Installing Ruby](https://www.ruby-lang.org/en/documentation/installation/)" in the Ruby documentation.
- 2. Instale o Bundler. For more information, see "[Bundler](https://bundler.io/)."
+ 1. Instale o Ruby. Para obter mais informações, consulte "[Instalar o Ruby](https://www.ruby-lang.org/en/documentation/installation/)" na documentação do Ruby.
+ 2. Instale o Bundler. Para obter mais informações, consulte "[Bundler](https://bundler.io/)".
diff --git a/translations/pt-BR/data/reusables/pages/remove-submodule.md b/translations/pt-BR/data/reusables/pages/remove-submodule.md
index 4e1201dcd4e6..81a2a81e1734 100644
--- a/translations/pt-BR/data/reusables/pages/remove-submodule.md
+++ b/translations/pt-BR/data/reusables/pages/remove-submodule.md
@@ -1,6 +1,6 @@
-To troubleshoot, first decide if you actually want to use a submodule, which is a Git project inside a Git project; submodules are sometimes created accidentally.
+Para solucionar problemas, primeiro decida se você realmente deseja usar um submódulo, que é um projeto do Git dentro de um projeto Git; às vezes, submódulos são criados acidentalmente.
 
-If you don't want to use a submodule, remove the submodule, replacing PATH-TO-SUBMODULE with the path to the submodule:
+Se você não desejar usar um submódulo, remova o submódulo, substituindo PATH-TO-SUBMODULE pelo caminho para o submódulo:
 ```shell
 $ git submodule deinit PATH-TO-SUBMODULE
 $ git rm PATH-TO-SUBMODULE
diff --git a/translations/pt-BR/data/reusables/pages/save-custom-domain.md b/translations/pt-BR/data/reusables/pages/save-custom-domain.md
index 2abdf6aca299..4d03d5b31857 100644
--- a/translations/pt-BR/data/reusables/pages/save-custom-domain.md
+++ b/translations/pt-BR/data/reusables/pages/save-custom-domain.md
@@ -1 +1 @@
-1. Under "Custom domain", type your custom domain, then click **Save**. This will create a commit that adds a _CNAME_ file in the root of your publishing source. ![Save custom domain button](/assets/images/help/pages/save-custom-domain.png)
+1. Em "Domínio personalizado,", digite o seu domínio personalizado e clique em **Salvar**. Isso criará um commit que adiciona um arquivo _CNAME_ à raiz da sua fonte de publicação. ![Botão Salvar domínio personalizado](/assets/images/help/pages/save-custom-domain.png)
diff --git a/translations/pt-BR/data/reusables/pages/search-for-includes.md b/translations/pt-BR/data/reusables/pages/search-for-includes.md
index 7f25b4b7b1a5..47c8eb55f4ac 100644
--- a/translations/pt-BR/data/reusables/pages/search-for-includes.md
+++ b/translations/pt-BR/data/reusables/pages/search-for-includes.md
@@ -1 +1 @@
-To troubleshoot, search the file in the error message for `include` to see where you've referenced other files, such as {% raw %}`{% include example_header.html %}`{% endraw %}.
+Para solucionar o problema, pesquise o arquivo `incluir` na mensagem de erro para ver onde você referenciou outros arquivos, como, por exemplo, {% raw %}`{% include example_header.html %}`{% endraw %}.
diff --git a/translations/pt-BR/data/reusables/pages/test-locally.md b/translations/pt-BR/data/reusables/pages/test-locally.md
index f30cc526a936..5953fb59902c 100644
--- a/translations/pt-BR/data/reusables/pages/test-locally.md
+++ b/translations/pt-BR/data/reusables/pages/test-locally.md
@@ -1 +1 @@
-Changes to your site are published automatically when the changes are merged into your site's publishing source. If you want to preview your changes first, you can make the changes locally instead of on {% data variables.product.product_name %}. Then, test your site locally. Para obter mais informações, consulte "[Testar seu site do {% data variables.product.prodname_pages %} localmente com o Jekyll](/articles/testing-your-github-pages-site-locally-with-jekyll)".
+As alterações no seu site serão publicadas automaticamente quando forem mescladas na fonte de publicação do site. Se você desejar pré-visualizar suas alterações primeiro, você poderá fazer as alterações localmente em vez de fazer em {% data variables.product.product_name %}. Em seguida, teste seu site localmente. Para obter mais informações, consulte "[Testar seu site do {% data variables.product.prodname_pages %} localmente com o Jekyll](/articles/testing-your-github-pages-site-locally-with-jekyll)".
diff --git a/translations/pt-BR/data/reusables/pages/theme-customization-help.md b/translations/pt-BR/data/reusables/pages/theme-customization-help.md
index 27f96bf63f23..8f5f2fba1aac 100644
--- a/translations/pt-BR/data/reusables/pages/theme-customization-help.md
+++ b/translations/pt-BR/data/reusables/pages/theme-customization-help.md
@@ -1 +1 @@
-Your theme's source repository may offer some help in customizing your theme. For example, see "[Minima's _README_](https://github.com/jekyll/minima#customizing-templates)."
+O repositório de origem do seu tema pode oferecer alguma ajuda na personalização do tema. Por exemplo, consulte o "[_LEIAME_ de Minima](https://github.com/jekyll/minima#customizing-templates)."
diff --git a/translations/pt-BR/data/reusables/pages/update_your_dns_settings.md b/translations/pt-BR/data/reusables/pages/update_your_dns_settings.md
index 67317a2a046e..c9856a7aff42 100644
--- a/translations/pt-BR/data/reusables/pages/update_your_dns_settings.md
+++ b/translations/pt-BR/data/reusables/pages/update_your_dns_settings.md
@@ -1 +1 @@
-{% if currentVersion == "free-pro-team@latest" %}1. If there's a custom domain enabled for your site, to avoid a domain takeover, update your DNS settings. For more information, see "[Configuring a custom domain for your {% data variables.product.prodname_pages %} site](/articles/configuring-a-custom-domain-for-your-github-pages-site)."{% endif %}
+{% if currentVersion == "free-pro-team@latest" %}1. Se houver um domínio personalizado habilitado para o seu site, para evitar que outra pessoa o tome, atualize suas configurações de DNS. Para obter mais informações, consulte "[Configurar um domínio personalizado para seu site do {% data variables.product.prodname_pages %}](/articles/configuring-a-custom-domain-for-your-github-pages-site)""{% endif %}
diff --git a/translations/pt-BR/data/reusables/pages/visit-site.md b/translations/pt-BR/data/reusables/pages/visit-site.md
index 6588a9ef89cf..07236da819de 100644
--- a/translations/pt-BR/data/reusables/pages/visit-site.md
+++ b/translations/pt-BR/data/reusables/pages/visit-site.md
@@ -1,7 +1,7 @@
-1. To see your published site, under "{% data variables.product.prodname_pages %}", click your site's URL. ![URL of your published site](/assets/images/help/pages/click-pages-url-to-preview.png)
+1. Para ver seu site publicado, em "{% data variables.product.prodname_pages %}", clique na URL do seu site. ![URL do seu site publicado](/assets/images/help/pages/click-pages-url-to-preview.png)
 
   {% note %}
 
-  **Observação:** podem ser necessários até 20 minutos para que as alterações no site sejam publicadas após o push delas no {% data variables.product.product_name %}. If your don't see your changes reflected in your browser after an hour, see "[About Jekyll build errors for {% data variables.product.prodname_pages %} sites](/articles/about-jekyll-build-errors-for-github-pages-sites)."
+  **Observação:** podem ser necessários até 20 minutos para que as alterações no site sejam publicadas após o push delas no {% data variables.product.product_name %}. Se você não vir suas alterações no navegador após uma hora, consulte "[Sobre erros de criação do Jekyll para sites de {% data variables.product.prodname_pages %}](/articles/about-jekyll-build-errors-for-github-pages-sites)".
 
   {% endnote %}
diff --git a/translations/pt-BR/data/reusables/pages/www-and-apex-domain-recommendation.md b/translations/pt-BR/data/reusables/pages/www-and-apex-domain-recommendation.md
index 38e49e006e00..35275b680eb6 100644
--- a/translations/pt-BR/data/reusables/pages/www-and-apex-domain-recommendation.md
+++ b/translations/pt-BR/data/reusables/pages/www-and-apex-domain-recommendation.md
@@ -1 +1 @@
-If you are using an apex domain as your custom domain, we recommend also setting up a `www` subdomain. If you configure the correct records for each domain type through your DNS provider, {% data variables.product.prodname_pages %} will automatically create redirects between the domains. For example, if you configure `www.example.com` as your custom domain for your site, and you have `ALIAS` and `CNAME` records set up for the apex and `www` domains, then `example.com` will redirect to `www.example.com`. Para obter mais informações, consulte "[Gerenciar um domínio personalizado para seu site do {% data variables.product.prodname_pages %}](/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site/#configuring-a-subdomain)".
+Se você estiver usando um domínio apex como seu domínio personalizado, recomendamos também configurar um subdomínio `www`. Se você configurar os registros corretos para cada tipo de domínio através do seu provedor DNS, {% data variables.product.prodname_pages %} irá automaticamente criar redirecionamentos entre os domínios. Por exemplo, se você configurar `www.example.com` como seu domínio personalizado para o seu site, e você tem os registros `ALIAS` e `CNAME` configurados para os domínios apex e `www`. Logo, `example.com` irá redirecionar para `www.exemplo.com`. Para obter mais informações, consulte "[Gerenciar um domínio personalizado para seu site do {% data variables.product.prodname_pages %}](/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site/#configuring-a-subdomain)".
diff --git a/translations/pt-BR/data/reusables/pages/yaml-linter.md b/translations/pt-BR/data/reusables/pages/yaml-linter.md
index 7bddf581184a..c10ecb69f943 100644
--- a/translations/pt-BR/data/reusables/pages/yaml-linter.md
+++ b/translations/pt-BR/data/reusables/pages/yaml-linter.md
@@ -1 +1 @@
-To identify any errors, you can copy and paste the contents of your YAML file into a YAML linter, such as [YAML Validator](http://codebeautify.org/yaml-validator).
+Para identificar quaisquer erros, você pode copiar e colar o conteúdo do seu arquivo YAML em um linter de YAML, como, por exemplo, [YAML Validator](http://codebeautify.org/yaml-validator).
diff --git a/translations/pt-BR/data/reusables/pages/yaml-rules.md b/translations/pt-BR/data/reusables/pages/yaml-rules.md
index 3cfbf0668102..5a7eebb09b3c 100644
--- a/translations/pt-BR/data/reusables/pages/yaml-rules.md
+++ b/translations/pt-BR/data/reusables/pages/yaml-rules.md
@@ -1,5 +1,5 @@
-- Use spaces instead of tabs.
-- Include a space after the `:` for each key value pair, like `timezone: Africa/Nairobi`.
-- Use only UTF-8 characters.
-- Quote any special characters, such as `:`, like `title: "my awesome site: an adventure in parse errors"`.
-- For multi-line values, use `|` to create newlines and `>` to ignore newlines.
+- Use espaços em vez de abas.
+- Inclua um espaço depois de `:` para cada par de valore-chave, como `timezone: Africa/Nairobi`.
+- Use apenas caracteres com codificação UTF-8.
+- Coloque entre aspas quaisquer caracteres especiais, como `:`, como, por exemplo, `title: "my awesome site: an adventure in parse errors"`.
+- Para valores de várias linhas, use `£` para criar linhas novas e `>` para ignorar as novas linhas.
diff --git a/translations/pt-BR/data/reusables/policies/abuse.md b/translations/pt-BR/data/reusables/policies/abuse.md
index d41d7b66887a..7fe6ac97b89a 100644
--- a/translations/pt-BR/data/reusables/policies/abuse.md
+++ b/translations/pt-BR/data/reusables/policies/abuse.md
@@ -1 +1 @@
-{% data variables.product.prodname_dotcom %} não tolera abusos.{% if currentVersion == "free-pro-team@latest" %} Para mais informações sobre as políticas do {% data variables.product.prodname_dotcom %}, veja nossos [Termos de Serviço](/articles/github-terms-of-service) e [Diretrizes da comunidade do GitHub](/articles/github-community-guidelines).{% endif %}
+{% data variables.product.prodname_dotcom %} não tolera abuso.{% if currentVersion == "free-pro-team@latest" %} Para obter mais informações sobre as políticas de {% data variables.product.prodname_dotcom %}veja nossos [Termos de Serviço](/articles/github-terms-of-service) e [Diretrizes da Comunidade](/articles/github-community-guidelines).{% endif %}
diff --git a/translations/pt-BR/data/reusables/pre-release-program/api-preview-warning.md b/translations/pt-BR/data/reusables/pre-release-program/api-preview-warning.md
index 480d2dc69c41..9917cede1799 100644
--- a/translations/pt-BR/data/reusables/pre-release-program/api-preview-warning.md
+++ b/translations/pt-BR/data/reusables/pre-release-program/api-preview-warning.md
@@ -1,5 +1,5 @@
 {% warning %}
 
-**Warning:** The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact {% data variables.contact.contact_support %}.
+**Aviso:** A API pode mudar sem aviso prévio durante o período de pré-visualização. Os recursos de visualização não são compatíveis com o uso em produção. Em caso de problemas, entre em contato com {% data variables.contact.contact_support %}.
 
 {% endwarning %}
diff --git a/translations/pt-BR/data/reusables/pre-release-program/content-attachments-public-beta.md b/translations/pt-BR/data/reusables/pre-release-program/content-attachments-public-beta.md
index 5ec22b70ca21..ae42912fd991 100644
--- a/translations/pt-BR/data/reusables/pre-release-program/content-attachments-public-beta.md
+++ b/translations/pt-BR/data/reusables/pre-release-program/content-attachments-public-beta.md
@@ -1,5 +1,5 @@
 {% note %}
 
-**Note:** The {% data variables.product.prodname_unfurls %} API is currently in public beta and only available for use with GitHub Apps. Features and requirements may change at any time during this period.
+**Observação:** A API do {% data variables.product.prodname_unfurls %} está atualmente em beta público e disponível apenas para uso com os aplicativos GitHub. Os recursos e requisitos podem mudar a qualquer momento durante este período.
 
 {% endnote %}
diff --git a/translations/pt-BR/data/reusables/pre-release-program/corsair-preview.md b/translations/pt-BR/data/reusables/pre-release-program/corsair-preview.md
index d5131c62d3f7..837f5b7a27ab 100644
--- a/translations/pt-BR/data/reusables/pre-release-program/corsair-preview.md
+++ b/translations/pt-BR/data/reusables/pre-release-program/corsair-preview.md
@@ -1,6 +1,6 @@
 {% note %}
 
-**Note:** To access the {% data variables.product.prodname_unfurls %} API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header:
+**Observação:** Para acessar a API do {% data variables.product.prodname_unfurls %} durante o período de pré-visualização, você deve fornecer um [tipo de mídia](/v3/media) personalizado no cabeçalho `Aceitar`:
 
 ```
 application/vnd.github.corsair-preview+json
diff --git a/translations/pt-BR/data/reusables/pre-release-program/expiring-user-access-tokens-beta.md b/translations/pt-BR/data/reusables/pre-release-program/expiring-user-access-tokens-beta.md
index 3489a36ad57d..0a8f80a9d6b9 100644
--- a/translations/pt-BR/data/reusables/pre-release-program/expiring-user-access-tokens-beta.md
+++ b/translations/pt-BR/data/reusables/pre-release-program/expiring-user-access-tokens-beta.md
@@ -1,7 +1,7 @@
 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}
 {% note %}
 
-**Note:** Expiring user tokens are currently part of the user-to-server token expiration beta and subject to change. Para optar por participar do recurso beta do token de usuário para servidor com expiração, consulte "[Ativar os recursos beta para aplicativos](/developers/apps/activating-beta-features-for-apps)". For more information, see "[Expiring user-to-server access tokens for GitHub Apps](https://developer.github.com/changes/2020-04-30-expiring-user-to-server-access-tokens-for-github-apps)."
+**Observação:** Os tokens de usuário com data de vencimento atualmente fazem parte do beta com data de vencimento do token de usuário para servidor e estão sujeitos a alterações. Para optar por participar do recurso beta do token de usuário para servidor com expiração, consulte "[Ativar os recursos beta para aplicativos](/developers/apps/activating-beta-features-for-apps)". Para obter mais informações, consulte "[Tokens com data de vencimento de acesso de usuário para servidor para aplicativos GitHub](https://developer.github.com/changes/2020-04-30-expiring-user-to-server-access-tokens-for-github-apps)".
 
 {% endnote %}
 {% endif %}
diff --git a/translations/pt-BR/data/reusables/pre-release-program/fury-pre-release.md b/translations/pt-BR/data/reusables/pre-release-program/fury-pre-release.md
index 5e63be71606a..ff784fff6dd2 100644
--- a/translations/pt-BR/data/reusables/pre-release-program/fury-pre-release.md
+++ b/translations/pt-BR/data/reusables/pre-release-program/fury-pre-release.md
@@ -1,7 +1,7 @@
 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.21" %}
 {% note %}
 
-**Note:** {% data variables.product.prodname_github_app %} Manifests are currently available for developers to preview. To access this API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header:
+**Observação:** Os manifestos de {% data variables.product.prodname_github_app %} estão atualmente disponíveis para pré-visualização dos desenvolvedores. Para acessar essa API durante o período de pré-visualização, você deve fornecer um [tipo de mídia](/v3/media) personalizado no cabeçalho `Aceitar`:
 
 ```
 application/vnd.github.fury-preview+json
diff --git a/translations/pt-BR/data/reusables/pre-release-program/machine-man-preview.md b/translations/pt-BR/data/reusables/pre-release-program/machine-man-preview.md
index 8fb50254cd1f..d4c31918ea72 100644
--- a/translations/pt-BR/data/reusables/pre-release-program/machine-man-preview.md
+++ b/translations/pt-BR/data/reusables/pre-release-program/machine-man-preview.md
@@ -1,9 +1,9 @@
 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %}
 {% note %}
 
-**Note:** To access the API with your GitHub App, you must provide a custom [media type](/v3/media) in the `Accept` Header for your requests.
+**Observação:** Para acessar a API com o seu aplicativo GitHub, você deve fornecer um [tipo de mídia](/v3/media) personalizado no cabeçalho `Aceitar` para as suas solicitações.
 
 `application/vnd.github.machine-man-preview+json`
 
 {% endnote %}
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/translations/pt-BR/data/reusables/pre-release-program/sailor-v-preview.md b/translations/pt-BR/data/reusables/pre-release-program/sailor-v-preview.md
index 271ed23002c8..80d4cf79b0b8 100644
--- a/translations/pt-BR/data/reusables/pre-release-program/sailor-v-preview.md
+++ b/translations/pt-BR/data/reusables/pre-release-program/sailor-v-preview.md
@@ -1,7 +1,7 @@
 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %}
 {% note %}
 
-**Note:** You can now use the REST API to add a reason when you lock an issue, and you will see lock reasons in responses that include issues or pull requests. You will also see lock reasons in `locked` events. This feature is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2018-01-10-lock-reason-api-preview) for full details. To access this feature, you must provide a custom [media type](/v3/media) in the `Accept` header:
+**Observação:** Agora você pode usar a API REST para adicionar um motivo ao bloquear um problema e você verá as razões de bloqueio nas respostas que incluem problemas ou pull requests. Você também verá razões de bloqueio em eventos `bloqueados`. Esse recurso está atualmente disponível para pré-visualização dos desenvolvedores. Consulte o [post do blogue](https://developer.github.com/changes/2018-01-10-lock-reason-api-preview) para obter informações completas. Para acessar este recurso, você deve fornecer um [tipo de mídia](/v3/media) personalizado no cabeçalho `Aceitar`:
 
 ```
 application/vnd.github.sailor-v-preview+json
diff --git a/translations/pt-BR/data/reusables/pre-release-program/starfox-preview.md b/translations/pt-BR/data/reusables/pre-release-program/starfox-preview.md
index 5de305adb6e7..70d5468e69d6 100644
--- a/translations/pt-BR/data/reusables/pre-release-program/starfox-preview.md
+++ b/translations/pt-BR/data/reusables/pre-release-program/starfox-preview.md
@@ -1,8 +1,8 @@
 {% note %}
 
-**Note:** Project card details are now shown in REST API responses for project-related issue and timeline events. This feature is now available for developers to preview. For details, see the [blog post](https://developer.github.com/changes/2018-09-05-project-card-events).
+**Observação:** Os detalhes do cartão do projeto agora são mostrados em respostas da API REST para eventos relacionados ao projeto e da linha do tempo. Esse recurso agora está disponível para pré-visualização dos desenvolvedores. Para obter informações, consulte o [post do blogue](https://developer.github.com/changes/2018-09-05-project-card-events).
 
-To receive the `project_card` attribute, project boards must be [enabled](/articles/disabling-project-boards-in-a-repository) for a repository, and you must provide a custom [media type](/v3/media) in the `Accept` header:
+Para receber o atributo `project_card`, os quadros de projeto devem estar [habilitados](/articles/disabling-project-boards-in-a-repository) para um repositório e você deve fornecer um [tipo de mídia](/v3/media) personalizado no cabeçalho `Aceitar`:
 
 ```
 application/vnd.github.starfox-preview+json
diff --git a/translations/pt-BR/data/reusables/pre-release-program/suspend-installation-beta.md b/translations/pt-BR/data/reusables/pre-release-program/suspend-installation-beta.md
index 3d81271d74ca..4d0443de4ac3 100644
--- a/translations/pt-BR/data/reusables/pre-release-program/suspend-installation-beta.md
+++ b/translations/pt-BR/data/reusables/pre-release-program/suspend-installation-beta.md
@@ -1,4 +1,5 @@
 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}
-Suspending a {% data variables.product.prodname_github_app %} installation is currently in beta and subject to change. Before you can suspend a {% data variables.product.prodname_github_app %}, the app owner must enable suspending installations for the app by opting-in to the beta. To opt-in to the suspending installations beta feature, see "[Activating beta features for apps](/developers/apps/activating-beta-features-for-apps)."
+Suspender uma
+instalação do {% data variables.product.prodname_github_app %} está atualmente em fase beta e sujeita a alterações. Antes que você possa suspender um {% data variables.product.prodname_github_app %}, o proprietário do aplicativo deve habilitar a suspensão de instalações para o aplicativo ao optar pela beta. Para participar do recurso do beta de suspensão de instalações, consulte "[Habilitar recursos beta do para aplicativos](/developers/apps/activating-beta-features-for-apps)".
 
 {% endif %}
diff --git a/translations/pt-BR/data/reusables/products/product-roadmap.md b/translations/pt-BR/data/reusables/products/product-roadmap.md
index f2159b23871a..941e537f1371 100644
--- a/translations/pt-BR/data/reusables/products/product-roadmap.md
+++ b/translations/pt-BR/data/reusables/products/product-roadmap.md
@@ -1 +1 @@
-For information on planned features and products, see the [{% data variables.product.prodname_roadmap %}]({% data variables.product.prodname_roadmap_link %}).
+Para obter informações sobre recursos e produtos planejados, consulte o [{% data variables.product.prodname_roadmap %}]({% data variables.product.prodname_roadmap_link %}).
diff --git a/translations/pt-BR/data/reusables/products/which-product-to-use.md b/translations/pt-BR/data/reusables/products/which-product-to-use.md
index 8167815341c6..3e054cb36297 100644
--- a/translations/pt-BR/data/reusables/products/which-product-to-use.md
+++ b/translations/pt-BR/data/reusables/products/which-product-to-use.md
@@ -1,3 +1,3 @@
-If you're not sure whether {% data variables.product.prodname_ghe_server %}, {% data variables.product.prodname_ghe_cloud %}, or both are best for your organization, contact {% data variables.contact.contact_enterprise_sales %}.
+Se não tiver certeza se {% data variables.product.prodname_ghe_server %}, {% data variables.product.prodname_ghe_cloud %} ou ambos são o melhor para a sua organização, entre em contato com {% data variables.contact.contact_enterprise_sales %}.
 
-Organizações com 12 ou mais desenvolvedores geralmente aproveitam melhor o {% data variables.product.prodname_enterprise %}. If your organization has 11 or fewer developers, consider {% data variables.product.prodname_team %}. Para obter mais informações, consulte "Produtos da {% data variables.product.prodname_dotcom %}".
+Organizações com 12 ou mais desenvolvedores geralmente aproveitam melhor o {% data variables.product.prodname_enterprise %}. Se sua organização tiver 11 ou menos desenvolvedores, considere {% data variables.product.prodname_team %}. Para obter mais informações, consulte "Produtos da {% data variables.product.prodname_dotcom %}".
diff --git a/translations/pt-BR/data/reusables/profile/access_org.md b/translations/pt-BR/data/reusables/profile/access_org.md
index 908518fb60b0..3874f1d1cb7f 100644
--- a/translations/pt-BR/data/reusables/profile/access_org.md
+++ b/translations/pt-BR/data/reusables/profile/access_org.md
@@ -1 +1 @@
-1. On the left side of your profile page, under "Organizations", click the icon for your organization. ![organization icons](/assets/images/help/profile/profile_orgs_box.png)
+1. No lado esquerdo da página do seu perfil, em "Organizações", clique no ícone da sua organização. ![ícones da organização](/assets/images/help/profile/profile_orgs_box.png)
diff --git a/translations/pt-BR/data/reusables/profile/access_profile.md b/translations/pt-BR/data/reusables/profile/access_profile.md
index 8d4539326a42..e7cb9fab6502 100644
--- a/translations/pt-BR/data/reusables/profile/access_profile.md
+++ b/translations/pt-BR/data/reusables/profile/access_profile.md
@@ -1,3 +1,3 @@
-{% if currentVersion == "free-pro-team@latest" %}1. In the top right corner of {% data variables.product.product_name %}, click your profile photo, then click **Your profile**.
-  ![Profile photo](/assets/images/help/profile/top_right_avatar.png){% else %}
-1. In the top right corner of {% data variables.product.product_name %}, click your profile photo, then click **Your profile**. ![Profile photo](/assets/images/enterprise/settings/top_right_avatar.png){% endif %}
+{% if currentVersion == "free-pro-team@latest" %}1. No canto superior direito de {% data variables.product.product_name %}, clique na sua foto de perfil e, em seguida, clique em **Seu perfil**.
+  ![Foto de perfil](/assets/images/help/profile/top_right_avatar.png){% else %}
+1. No canto superior direito de {% data variables.product.product_name %}, clique na sua foto de perfil e, em seguida, clique em **Seu perfil**. ![Profile photo](/assets/images/enterprise/settings/top_right_avatar.png){% endif %}
diff --git a/translations/pt-BR/data/reusables/profile/activity-overview-summary.md b/translations/pt-BR/data/reusables/profile/activity-overview-summary.md
index c8d9cb098bb7..369334099fcc 100644
--- a/translations/pt-BR/data/reusables/profile/activity-overview-summary.md
+++ b/translations/pt-BR/data/reusables/profile/activity-overview-summary.md
@@ -1 +1 @@
-When you enable the activity overview section on your profile, viewers can see more information about the types of contributions you make and repositories you're most active in. A viewer can only see information in the activity overview about repositories they have read access to. Once enabled, a viewer can also filter your contribution graph and activity timeline for a specific organization.
+Ao habilitar a seção de visão geral das atividades no seu perfil, os visualizadores podem ver mais informações sobre os tipos de contribuição que você faz e os repositórios nos quais você está mais ativo. Um visualizador só pode ver informações na visão geral da atividade sobre os repositórios aos quais tem acesso de leitura. Uma vez habilitado, um visualizador também pode filtrar seu gráfico de contribuição e linha do tempo de atividade para uma organização específica.
diff --git a/translations/pt-BR/data/reusables/profile/enterprise_access_profile.md b/translations/pt-BR/data/reusables/profile/enterprise_access_profile.md
index 79fbbe005d75..b412cac067ec 100644
--- a/translations/pt-BR/data/reusables/profile/enterprise_access_profile.md
+++ b/translations/pt-BR/data/reusables/profile/enterprise_access_profile.md
@@ -1 +1 @@
-1. In the top right corner of {% data variables.product.prodname_ghe_server %}, click your profile photo, then click **Your profile**. ![Profile photo](/assets/images/enterprise/settings/top_right_avatar.png)
+1. No canto superior direito de {% data variables.product.prodname_ghe_server %}, clique na sua foto de perfil e, em seguida, clique em **Seu perfil**. ![Foto de perfil](/assets/images/enterprise/settings/top_right_avatar.png)
diff --git a/translations/pt-BR/data/reusables/profile/profile-readme.md b/translations/pt-BR/data/reusables/profile/profile-readme.md
index 6c734861db2e..bf0faa98fc5d 100644
--- a/translations/pt-BR/data/reusables/profile/profile-readme.md
+++ b/translations/pt-BR/data/reusables/profile/profile-readme.md
@@ -1 +1 @@
-If you add a README file to the root of a public repository with the same name as your username, that README will automatically appear on your profile page. You can edit your profile README with GitHub Flavored Markdown to create a personalized section on your profile.
\ No newline at end of file
+Se você adicionar um arquivo LEIAME à raiz de um repositório público com o mesmo nome de usuário, esse LEIAME aparecerá automaticamente na sua página de perfil. Você pode editar seu perfil LEIAME com o markdown em estilo GitHub para criar uma seção personalizada no seu perfil.
diff --git a/translations/pt-BR/data/reusables/profile/user_profile_page_block_or_report.md b/translations/pt-BR/data/reusables/profile/user_profile_page_block_or_report.md
index 0af470cffdd4..d14480f75ad8 100644
--- a/translations/pt-BR/data/reusables/profile/user_profile_page_block_or_report.md
+++ b/translations/pt-BR/data/reusables/profile/user_profile_page_block_or_report.md
@@ -1 +1 @@
-1. In the left sidebar, under the user's profile picture, click **Block or report user**. ![Block or report user link](/assets/images/help/profile/profile-block-or-report-button.png)
+1. Na barra lateral esquerda, abaixo da imagem de perfil do usuário, clique em **Bloquear ou relatar usuário**. ![Link para bloquear ou relatar usuário](/assets/images/help/profile/profile-block-or-report-button.png)
diff --git a/translations/pt-BR/data/reusables/project-management/access-collaboration-settings.md b/translations/pt-BR/data/reusables/project-management/access-collaboration-settings.md
index e8d572a484d2..978458016c49 100644
--- a/translations/pt-BR/data/reusables/project-management/access-collaboration-settings.md
+++ b/translations/pt-BR/data/reusables/project-management/access-collaboration-settings.md
@@ -1 +1 @@
-1. Click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Settings**. ![Settings option in drop-down menu from project board sidebar](/assets/images/help/projects/project-board-settings.png)
+1. Clique em {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} e, em seguida, em **Configurações**. ![Opção de configurações no menu suspenso da barra lateral do projeto](/assets/images/help/projects/project-board-settings.png)
diff --git a/translations/pt-BR/data/reusables/project-management/add-collaborator.md b/translations/pt-BR/data/reusables/project-management/add-collaborator.md
index 84ccaccc85ca..9c110d8ed839 100644
--- a/translations/pt-BR/data/reusables/project-management/add-collaborator.md
+++ b/translations/pt-BR/data/reusables/project-management/add-collaborator.md
@@ -1 +1 @@
-10. In the search results, click the correct username and click **Add collaborator**.
+10. Nos resultados da pesquisa, clique no nome de usuário correto e clique em **Adicionar colaborador**.
diff --git a/translations/pt-BR/data/reusables/project-management/add-column-new-project.md b/translations/pt-BR/data/reusables/project-management/add-column-new-project.md
index 2c25f88be545..3af40108c7c9 100644
--- a/translations/pt-BR/data/reusables/project-management/add-column-new-project.md
+++ b/translations/pt-BR/data/reusables/project-management/add-column-new-project.md
@@ -1 +1 @@
-1. On your new project board, to add your first column, **Add a column**. ![Add a column button on an empty project board](/assets/images/help/projects/add-column.png)
+1. No seu novo quadro de projetos, para adicionar sua primeira coluna, **Adicionar uma coluna**. ![Botão para adicionar coluna em um quadro de projeto vazio](/assets/images/help/projects/add-column.png)
diff --git a/translations/pt-BR/data/reusables/project-management/automate-project-board-permissions.md b/translations/pt-BR/data/reusables/project-management/automate-project-board-permissions.md
index 525f140e73e5..a6b556b4a156 100644
--- a/translations/pt-BR/data/reusables/project-management/automate-project-board-permissions.md
+++ b/translations/pt-BR/data/reusables/project-management/automate-project-board-permissions.md
@@ -1 +1 @@
-To set up automatic workflows for a repository project board, you must have write access to the repository. Organization owners and members can configure automatic workflows on an organization-wide project board.
+Para configurar fluxos de trabalho automáticos para um quadro de projetos de repositório, você deve ter acesso de gravação ao repositório. Os proprietários e integrantes da organização podem configurar fluxos de trabalho automáticos em um quadro de projetos para toda a organização.
diff --git a/translations/pt-BR/data/reusables/project-management/choose-template.md b/translations/pt-BR/data/reusables/project-management/choose-template.md
index 6ac718b772e8..b2145656dd66 100644
--- a/translations/pt-BR/data/reusables/project-management/choose-template.md
+++ b/translations/pt-BR/data/reusables/project-management/choose-template.md
@@ -1 +1 @@
-5. Optionally, to add a template to your project board, use the **Template:** drop-down menu and click a template. ![Drop-down menu showing project board template options](/assets/images/help/projects/project_board_template_drop_down_menu.png)
+5. Opcionalmente, para adicionar um modelo ao seu quadro de projeto, use o menu suspenso **Template:** e clique em um modelo. ![Menu suspenso que exibe as opções de modelo do quadro de projeto](/assets/images/help/projects/project_board_template_drop_down_menu.png)
diff --git a/translations/pt-BR/data/reusables/project-management/click-create-column.md b/translations/pt-BR/data/reusables/project-management/click-create-column.md
index 873960d01a0a..2bc046a23340 100644
--- a/translations/pt-BR/data/reusables/project-management/click-create-column.md
+++ b/translations/pt-BR/data/reusables/project-management/click-create-column.md
@@ -1 +1 @@
-1. Click **Create column**.
+1. Clique em **Criar coluna**.
diff --git a/translations/pt-BR/data/reusables/project-management/click-edit-sidebar-menu-project-board.md b/translations/pt-BR/data/reusables/project-management/click-edit-sidebar-menu-project-board.md
index 77e6104b57c6..8d3778a52430 100644
--- a/translations/pt-BR/data/reusables/project-management/click-edit-sidebar-menu-project-board.md
+++ b/translations/pt-BR/data/reusables/project-management/click-edit-sidebar-menu-project-board.md
@@ -1 +1 @@
-1. Click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Edit**. ![Edit option in drop-down menu from project board sidebar](/assets/images/help/projects/project-board-edit-settings.png)
+1. Clique em {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} e, em seguida, em **Editar**. ![Opção de editar no menu suspenso da barra lateral do quadro de projeto](/assets/images/help/projects/project-board-edit-settings.png)
diff --git a/translations/pt-BR/data/reusables/project-management/click-menu.md b/translations/pt-BR/data/reusables/project-management/click-menu.md
index 0fd91f018d84..3390ad498eb8 100644
--- a/translations/pt-BR/data/reusables/project-management/click-menu.md
+++ b/translations/pt-BR/data/reusables/project-management/click-menu.md
@@ -1 +1 @@
-1. On the top-right side of the project board, click {% octicon "three-bars" aria-label="The three-bars octicon" %} **Menu**.
+1. No lado superior direito do quadro de projeto, clique em {% octicon "three-bars" aria-label="The three-bars octicon" %} **Menu**.
diff --git a/translations/pt-BR/data/reusables/project-management/click-new-project.md b/translations/pt-BR/data/reusables/project-management/click-new-project.md
index 0a3a19cab28c..8846f56dd92c 100644
--- a/translations/pt-BR/data/reusables/project-management/click-new-project.md
+++ b/translations/pt-BR/data/reusables/project-management/click-new-project.md
@@ -1 +1 @@
-1. Click **New Project**. ![New Project button](/assets/images/help/projects/new-project-button.png)
+1. Clique em **Novo Projeto**. ![Botão Novo projeto](/assets/images/help/projects/new-project-button.png)
diff --git a/translations/pt-BR/data/reusables/project-management/collaborator-option.md b/translations/pt-BR/data/reusables/project-management/collaborator-option.md
index 64d5e895d8ca..283468b836f3 100644
--- a/translations/pt-BR/data/reusables/project-management/collaborator-option.md
+++ b/translations/pt-BR/data/reusables/project-management/collaborator-option.md
@@ -1 +1 @@
-8. Na barra lateral esquerda, clique em **Collaborators** (Colaboradores). ![Collaborators menu option in left sidebar](/assets/images/help/projects/project-board-collaborator-setting.png)
+8. Na barra lateral esquerda, clique em **Collaborators** (Colaboradores). ![Opção do menu de colaboradores na barra lateral esquerda](/assets/images/help/projects/project-board-collaborator-setting.png)
diff --git a/translations/pt-BR/data/reusables/project-management/collaborator-permissions.md b/translations/pt-BR/data/reusables/project-management/collaborator-permissions.md
index 452815fbd941..fd6a122350d8 100644
--- a/translations/pt-BR/data/reusables/project-management/collaborator-permissions.md
+++ b/translations/pt-BR/data/reusables/project-management/collaborator-permissions.md
@@ -1 +1 @@
-11. Optionally, next to the new collaborator's name, use the drop-down menu and click the desired permission level: **Read**, **Write**, or **Admin**. ![Collaborator permissions drop-down menu with read, write, and admin options](/assets/images/help/projects/org-project-collaborators-choose-permissions.png)
+11. Opcionalmente, ao lado do nome do novo colaborador, use o menu suspenso e clique no nível de permissão desejado: **Leitura**, **Gravação** ou **Administrador**. ![Permissões de colaborador menu suspenso com opções de leitura, gravação e administração](/assets/images/help/projects/org-project-collaborators-choose-permissions.png)
diff --git a/translations/pt-BR/data/reusables/project-management/confirm-label-deletion.md b/translations/pt-BR/data/reusables/project-management/confirm-label-deletion.md
index 71d617b4ff7b..e85dd1d9688e 100644
--- a/translations/pt-BR/data/reusables/project-management/confirm-label-deletion.md
+++ b/translations/pt-BR/data/reusables/project-management/confirm-label-deletion.md
@@ -1 +1 @@
-  1. Read the warning, then click **OK**.
+  1. Leia o alerta e clique em **OK**.
diff --git a/translations/pt-BR/data/reusables/project-management/copy-project-boards.md b/translations/pt-BR/data/reusables/project-management/copy-project-boards.md
index 6e4816484452..d6adc2e6f61e 100644
--- a/translations/pt-BR/data/reusables/project-management/copy-project-boards.md
+++ b/translations/pt-BR/data/reusables/project-management/copy-project-boards.md
@@ -1,3 +1,3 @@
 {% if currentVersion == "free-pro-team@latest" %}
-You can also copy a project board to reuse its customizations for similar projects. For more information, see "[Copying a project board](/articles/copying-a-project-board)."
+Você também pode copiar um quadro de projeto para reutilizar suas personalizações para projetos similares. Para obter mais informações, consulte "[Copiar um quadro de projeto](/articles/copying-a-project-board)".
 {% endif %}
diff --git a/translations/pt-BR/data/reusables/project-management/create-project-button.md b/translations/pt-BR/data/reusables/project-management/create-project-button.md
index 75f6c1c4f956..6571aa054a13 100644
--- a/translations/pt-BR/data/reusables/project-management/create-project-button.md
+++ b/translations/pt-BR/data/reusables/project-management/create-project-button.md
@@ -1 +1 @@
-1. Click **Create project**.
+1. Clique em **Criar projeto**.
diff --git a/translations/pt-BR/data/reusables/project-management/create-project-name-description.md b/translations/pt-BR/data/reusables/project-management/create-project-name-description.md
index 80fe6d84245e..6afc44d806d1 100644
--- a/translations/pt-BR/data/reusables/project-management/create-project-name-description.md
+++ b/translations/pt-BR/data/reusables/project-management/create-project-name-description.md
@@ -1 +1 @@
-1. Type a name and description for your project board. ![Fields for project name and description and Create project button](/assets/images/help/projects/name-description-create-button.png)
+1. Digite um nome e uma descrição para seu quadro de projeto. ![Campos para o nome e descrição do projeto e botão Criar projeto](/assets/images/help/projects/name-description-create-button.png)
diff --git a/translations/pt-BR/data/reusables/project-management/delete-label.md b/translations/pt-BR/data/reusables/project-management/delete-label.md
index f3f93215ef9c..e1990ed93504 100644
--- a/translations/pt-BR/data/reusables/project-management/delete-label.md
+++ b/translations/pt-BR/data/reusables/project-management/delete-label.md
@@ -1 +1 @@
-  1. In the labels list, to the right of the label you want to delete, click  **Delete**.
+  1. Na lista de etiquetas, à direita da etiqueta que você deseja excluir, clique em **Excluir**.
diff --git a/translations/pt-BR/data/reusables/project-management/edit-label.md b/translations/pt-BR/data/reusables/project-management/edit-label.md
index f4c267635c16..fd160fe83ee9 100644
--- a/translations/pt-BR/data/reusables/project-management/edit-label.md
+++ b/translations/pt-BR/data/reusables/project-management/edit-label.md
@@ -1 +1 @@
-  1. In the labels list, to the right of the label you want to edit, click **Edit**.
+  1. Na lista de etiquetas, à direita da etiqueta que deseja editar, clique em **Editar**.
diff --git a/translations/pt-BR/data/reusables/project-management/edit-project-columns.md b/translations/pt-BR/data/reusables/project-management/edit-project-columns.md
index c532ecf40d63..155fd6939a4b 100644
--- a/translations/pt-BR/data/reusables/project-management/edit-project-columns.md
+++ b/translations/pt-BR/data/reusables/project-management/edit-project-columns.md
@@ -1,5 +1,5 @@
 {% tip %}
 
-**Tip:** To edit or remove a column from your project board, in the upper-right corner of the column, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}.
+**Dica:** Para editar ou remover uma coluna do seu quadro de projetos, no canto superior direito da coluna, clique em {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}.
 
 {% endtip %}
diff --git a/translations/pt-BR/data/reusables/project-management/for-more-info-project-keyboard-shortcuts.md b/translations/pt-BR/data/reusables/project-management/for-more-info-project-keyboard-shortcuts.md
index a393919fb2c7..258f49f15cdf 100644
--- a/translations/pt-BR/data/reusables/project-management/for-more-info-project-keyboard-shortcuts.md
+++ b/translations/pt-BR/data/reusables/project-management/for-more-info-project-keyboard-shortcuts.md
@@ -1 +1 @@
-For more information about keyboard shortcuts, see "Project boards" in "[Keyboard shortcuts](/articles/keyboard-shortcuts/#project-boards)."
+Para obter mais informações sobre atalhos de teclado, consulte "Quadro de projetos" em "[Atalhos do teclado](/articles/keyboard-shortcuts/#project-boards)".
diff --git a/translations/pt-BR/data/reusables/project-management/label-color-randomizer.md b/translations/pt-BR/data/reusables/project-management/label-color-randomizer.md
index 4635d428aeaa..7f6982b35626 100644
--- a/translations/pt-BR/data/reusables/project-management/label-color-randomizer.md
+++ b/translations/pt-BR/data/reusables/project-management/label-color-randomizer.md
@@ -1 +1 @@
-1. Optionally, to customize the color of your label, edit the hexadecimal number, or click the refresh button for another random selection. ![Issues new label color refresh](/assets/images/help/issues/issues-color-refresh.png)
+1. Opcionalmente, para personalizar a cor da sua etiqueta, edite o número hexadecimal ou clique no botão atualizar para outra seleção aleatória. ![Emite uma nova cor da etiqueta quando atualizada](/assets/images/help/issues/issues-color-refresh.png)
diff --git a/translations/pt-BR/data/reusables/project-management/label-description.md b/translations/pt-BR/data/reusables/project-management/label-description.md
index bb8e8718ab32..1b5e28e9f94b 100644
--- a/translations/pt-BR/data/reusables/project-management/label-description.md
+++ b/translations/pt-BR/data/reusables/project-management/label-description.md
@@ -1 +1 @@
-1. Under "Description", type a description to help others understand and use your label. ![Field to type a label description](/assets/images/help/issues/label-description-field.png)
+1. Em "Descrição", digite uma descrição para ajudar outras pessoas a entender e usar a sua etiqueta. ![Campo para digitar uma descrição da etiqueta](/assets/images/help/issues/label-description-field.png)
diff --git a/translations/pt-BR/data/reusables/project-management/labels.md b/translations/pt-BR/data/reusables/project-management/labels.md
index 9d67478707c8..78aaf63d9593 100644
--- a/translations/pt-BR/data/reusables/project-management/labels.md
+++ b/translations/pt-BR/data/reusables/project-management/labels.md
@@ -1 +1 @@
-1. Above the list of issues or pull requests, click **Labels**. ![Labels tab on a repository's issues or pull requests page](/assets/images/help/issues/issues_labels_button.png)
+1. Acima da lista de problemas ou pull requests, clique em **Etiquetas**. ![Guia de etiquetas na página de problemas de um repositório ou pull requests](/assets/images/help/issues/issues_labels_button.png)
diff --git a/translations/pt-BR/data/reusables/project-management/link-repos-to-project-board.md b/translations/pt-BR/data/reusables/project-management/link-repos-to-project-board.md
index d2688ed1fd4d..d638004aa472 100644
--- a/translations/pt-BR/data/reusables/project-management/link-repos-to-project-board.md
+++ b/translations/pt-BR/data/reusables/project-management/link-repos-to-project-board.md
@@ -1 +1 @@
-You can link up to twenty-five repositories to your organization or user-owned project board. Linking repositories makes it easier to add issues and pull requests from those repositories to your project board using **{% octicon "plus" aria-label="The Plus icon" %} Add cards**{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} or from the issue or pull requests sidebar{% endif %}.
+Você pode vincular até vinte e cinco repositórios à sua organização ou ao quadro de projetos pertencente ao usuário. Vincular repositórios facilita a adição de problemas e pull requests desses repositórios ao seu quadro de projeto usando **{% octicon "plus" aria-label="The Plus icon" %} Cartões de adição de ** ou na barra lateral de problemas ou pull requests.
diff --git a/translations/pt-BR/data/reusables/project-management/linked-repositories.md b/translations/pt-BR/data/reusables/project-management/linked-repositories.md
index 1ccf8a5c96e5..e01f1cacb6f0 100644
--- a/translations/pt-BR/data/reusables/project-management/linked-repositories.md
+++ b/translations/pt-BR/data/reusables/project-management/linked-repositories.md
@@ -1 +1 @@
-1. Optionally, under **Linked repositories**, search for a repository you'd like to link to your project board. ![Search field to link repositories](/assets/images/help/projects/search-to-link-repository-on-create.png)
+1. Opcionalmente, em **repositórios vinculados**, pesquise um repositório que você gostaria de vincular ao quadro de projetos. ![Campo de pesquisa para vincular os repositórios](/assets/images/help/projects/search-to-link-repository-on-create.png)
diff --git a/translations/pt-BR/data/reusables/project-management/milestones.md b/translations/pt-BR/data/reusables/project-management/milestones.md
index 7e4841a0fee9..744903f19c00 100644
--- a/translations/pt-BR/data/reusables/project-management/milestones.md
+++ b/translations/pt-BR/data/reusables/project-management/milestones.md
@@ -1 +1 @@
-1. Next to the search field, click **Milestones**. ![Botão Milestones (Marcos) de problemas](/assets/images/help/issues/issues_milestone_button.png)
+1. Ao lado do campo de pesquisa, clique em **Marcos**. ![Botão Milestones (Marcos) de problemas](/assets/images/help/issues/issues_milestone_button.png)
diff --git a/translations/pt-BR/data/reusables/project-management/name-label.md b/translations/pt-BR/data/reusables/project-management/name-label.md
index ee318b76a209..9a4b4f6303a5 100644
--- a/translations/pt-BR/data/reusables/project-management/name-label.md
+++ b/translations/pt-BR/data/reusables/project-management/name-label.md
@@ -1 +1 @@
-1. Under "Label name", type a name for your label. ![Field to type a label name](/assets/images/help/issues/Issues-Label-Create.png)
+1. Em "Nome da etiqueta", digite um nome para a sua etiqueta. ![Campo para digitar um nome de etiqueta](/assets/images/help/issues/Issues-Label-Create.png)
diff --git a/translations/pt-BR/data/reusables/project-management/name-project-board-column.md b/translations/pt-BR/data/reusables/project-management/name-project-board-column.md
index 6842d8749fd7..d8ca4f5f397d 100644
--- a/translations/pt-BR/data/reusables/project-management/name-project-board-column.md
+++ b/translations/pt-BR/data/reusables/project-management/name-project-board-column.md
@@ -1 +1 @@
-1. Under "Column name", type the name of the column you want to create. ![Type column name](/assets/images/help/projects/type-column-name.png)
+1. Em "Nome da coluna", digite o nome da coluna que deseja criar. ![Digite o nome da coluna](/assets/images/help/projects/type-column-name.png)
diff --git a/translations/pt-BR/data/reusables/project-management/project-board-import-with-api.md b/translations/pt-BR/data/reusables/project-management/project-board-import-with-api.md
index ac8b4cdcdfc6..0ac63ec94a0b 100644
--- a/translations/pt-BR/data/reusables/project-management/project-board-import-with-api.md
+++ b/translations/pt-BR/data/reusables/project-management/project-board-import-with-api.md
@@ -1 +1 @@
-You can use {% data variables.product.prodname_dotcom %}'s API to import a project board. For more information, see "[importProject](/v4/mutation/importproject/)."
+Você pode usar a API de {% data variables.product.prodname_dotcom %} para importar um quadro de projetos. Para obter mais informações, consulte "[importProject](/graphql/reference/mutations#importproject/)".
diff --git a/translations/pt-BR/data/reusables/project-management/project-board-permissions.md b/translations/pt-BR/data/reusables/project-management/project-board-permissions.md
index a8735f811b42..e1713ff88032 100644
--- a/translations/pt-BR/data/reusables/project-management/project-board-permissions.md
+++ b/translations/pt-BR/data/reusables/project-management/project-board-permissions.md
@@ -1,3 +1,3 @@
-- **Read**, which gives people permission to view a project board.
-- **Write**, which gives people permission to view a project board, link repositories to a project board, and interact with a project board. Para obter mais informações, consulte "[Vincular um repositório a um quadro de projeto](/articles/linking-a-repository-to-a-project-board)".
-- **Admin**, which gives people permission to view a project board, interact with a project board, manage project board settings, and manage other people's access to the project board.
+- **Leitura**, que dá permissão para pessoas visualizarem um quadro de projeto.
+- **Gravação**, que dá permissão às pessoas para visualizar um quadro de projeto, vincular repositórios a um quadro de projeto e interagir com um quadro de projeto. Para obter mais informações, consulte "[Vincular um repositório a um quadro de projeto](/articles/linking-a-repository-to-a-project-board)".
+- **Administrador**, que dá permissão às pessoas para visualizar um quadro de projeto, interagir com um quadro de projeto, gerenciar as configurações do quadro de projeto e gerenciar o acesso de outras pessoas ao quadro de projetos.
diff --git a/translations/pt-BR/data/reusables/project-management/project-note-more-options.md b/translations/pt-BR/data/reusables/project-management/project-note-more-options.md
index 8697d51709a5..973078a61d38 100644
--- a/translations/pt-BR/data/reusables/project-management/project-note-more-options.md
+++ b/translations/pt-BR/data/reusables/project-management/project-note-more-options.md
@@ -1 +1 @@
-1. In the upper-right corner of the notes, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}. ![Horizontal kebab icon in upper-right corner of note](/assets/images/help/projects/note-more-options.png)
+1. No canto superior direito das observações, clique em {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}. ![Ícone de kebab horizontal no canto superior direito da observação](/assets/images/help/projects/note-more-options.png)
diff --git a/translations/pt-BR/data/reusables/project-management/remove-collaborator.md b/translations/pt-BR/data/reusables/project-management/remove-collaborator.md
index 6bc040c9534d..be906ff49566 100644
--- a/translations/pt-BR/data/reusables/project-management/remove-collaborator.md
+++ b/translations/pt-BR/data/reusables/project-management/remove-collaborator.md
@@ -1 +1 @@
-4. Next to the collaborator you want to remove, click **X**. !["X" removal icon next to collaborator's username](/assets/images/help/projects/remove-project-board-collaborator.png)
+4. Ao lado do colaborador que deseja remover, clique em **X**. !["X" ícone de remoção ao lado do nome do usuário do colaborador](/assets/images/help/projects/remove-project-board-collaborator.png)
diff --git a/translations/pt-BR/data/reusables/project-management/resync-automation.md b/translations/pt-BR/data/reusables/project-management/resync-automation.md
index a5281a26ff0d..6c871d8256b7 100644
--- a/translations/pt-BR/data/reusables/project-management/resync-automation.md
+++ b/translations/pt-BR/data/reusables/project-management/resync-automation.md
@@ -1 +1 @@
-When you close a project board, any workflow automation configured for the project board will pause. If you reopen a project board, you have the option to sync automation, which updates the positon of the cards on the board according to the automation settings configured for the board. For more information, see "[Reopening a closed project board](/articles/reopening-a-closed-project-board)" or "[Closing a project board](/articles/closing-a-project-board)."
+Ao fechar um quadro de projetos, qualquer automação de fluxo de trabalho configurada no quadro do projeto será pausada. Se você reabrir um quadro de projeto, você terá a opção de sincronizar a automação, que atualiza a apresentação dos cartões no quadro de acordo com as configurações de automação definidas para o mesmo. Para obter mais informações, consulte "[Reabrir um quadro de projeto fechado](/articles/reopening-a-closed-project-board)" ou "[Fechar um quadro de projeto](/articles/closing-a-project-board)".
diff --git a/translations/pt-BR/data/reusables/project-management/select-column-preset.md b/translations/pt-BR/data/reusables/project-management/select-column-preset.md
index 44f914982d9b..c49e9c082ac7 100644
--- a/translations/pt-BR/data/reusables/project-management/select-column-preset.md
+++ b/translations/pt-BR/data/reusables/project-management/select-column-preset.md
@@ -1 +1 @@
-1. Optionally, under "Automation", select an automation preset using the drop-down menu. ![Selecionar automação predefinida no menu](/assets/images/help/projects/select-automation.png)
+1. Opcionalmente, em "Automação", selecione uma pré-configuração de automação usando o menu suspenso. ![Selecionar automação predefinida no menu](/assets/images/help/projects/select-automation.png)
diff --git a/translations/pt-BR/data/reusables/project-management/select-project.md b/translations/pt-BR/data/reusables/project-management/select-project.md
index 9f41efb74490..bbfe91a8302f 100644
--- a/translations/pt-BR/data/reusables/project-management/select-project.md
+++ b/translations/pt-BR/data/reusables/project-management/select-project.md
@@ -1 +1 @@
-1. In the projects list, click the name of the project board. ![Select project](/assets/images/help/projects/select-project.png)
+1. Na lista de projetos, clique no nome do quadro de projeto. ![Selecione o projeto](/assets/images/help/projects/select-project.png)
diff --git a/translations/pt-BR/data/reusables/project-management/use-automated-template.md b/translations/pt-BR/data/reusables/project-management/use-automated-template.md
index f4298df3432d..43b88d1aa094 100644
--- a/translations/pt-BR/data/reusables/project-management/use-automated-template.md
+++ b/translations/pt-BR/data/reusables/project-management/use-automated-template.md
@@ -1 +1 @@
-You can use a project board template to create a project board with automation already configured. Para obter mais informações, consulte "[Sobre quadros de projeto](/articles/about-project-boards#templates-for-project-boards)".
+Você pode usar um modelo de quadro de projeto para criar um quadro de projeto com automação já configurada. Para obter mais informações, consulte "[Sobre quadros de projeto](/articles/about-project-boards#templates-for-project-boards)".
diff --git a/translations/pt-BR/data/reusables/projects/disabled-projects.md b/translations/pt-BR/data/reusables/projects/disabled-projects.md
index 2b10747e7e27..e67b6fe4b202 100644
--- a/translations/pt-BR/data/reusables/projects/disabled-projects.md
+++ b/translations/pt-BR/data/reusables/projects/disabled-projects.md
@@ -1 +1 @@
-You only see this event in responses when project boards have been [enabled](/articles/disabling-project-boards-in-a-repository) in the repository.
\ No newline at end of file
+Você só vê esse evento nas respostas quando os quadros de projeto estão [habilitados](/articles/disabling-project-boards-in-a-repository) no repositório.
diff --git a/translations/pt-BR/data/reusables/pull_requests/automatically-delete-branches.md b/translations/pt-BR/data/reusables/pull_requests/automatically-delete-branches.md
index b8bc5a7c9bc8..0e9601373338 100644
--- a/translations/pt-BR/data/reusables/pull_requests/automatically-delete-branches.md
+++ b/translations/pt-BR/data/reusables/pull_requests/automatically-delete-branches.md
@@ -1,3 +1 @@
-{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}
 É possível excluir branches head automaticamente após o merge de pull requests no repositório. Para obter mais informações, consulte "[Gerenciar a exclusão automática de branches](/articles/managing-the-automatic-deletion-of-branches)".
-{% endif %}
diff --git a/translations/pt-BR/data/reusables/pull_requests/close-issues-using-keywords.md b/translations/pt-BR/data/reusables/pull_requests/close-issues-using-keywords.md
index 52cacf2a8e56..77027d9b4196 100644
--- a/translations/pt-BR/data/reusables/pull_requests/close-issues-using-keywords.md
+++ b/translations/pt-BR/data/reusables/pull_requests/close-issues-using-keywords.md
@@ -1 +1 @@
-You can link a pull request to an issue to{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} show that a fix is in progress and to{% endif %} automatically close the issue when someone merges the pull request. Para obter mais informações, consulte "[Vincular um pull request a um problema](/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue)."
+Você pode vincular um pull request a um problema {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 0" %} mostra que uma correção está em andamento e{% endif %} fecha o problema automaticamente quando alguém faz merge do pull request. Para obter mais informações, consulte "[Vincular um pull request a um problema](/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue)."
diff --git a/translations/pt-BR/data/reusables/pull_requests/collect-co-author-commit-git-config-info.md b/translations/pt-BR/data/reusables/pull_requests/collect-co-author-commit-git-config-info.md
index b832ddb27e54..c332be02a34b 100644
--- a/translations/pt-BR/data/reusables/pull_requests/collect-co-author-commit-git-config-info.md
+++ b/translations/pt-BR/data/reusables/pull_requests/collect-co-author-commit-git-config-info.md
@@ -1 +1 @@
-1. Collect the name and email address for each co-author.{% if currentVersion == "free-pro-team@latest" %} If a person chooses to keep their email address private, you should use their {% data variables.product.product_name %}-provided `no-reply` email to protect their privacy.{% endif %}
+1. Colete o nome e o endereço de e-mail de cada coautor.{% if currentVersion == "free-pro-team@latest" %} Se uma pessoa escolher manter seu endereço de e-mail privado, você deverá usar o seu e-mail `no-reply` fornecido por {% data variables.product.product_name %} para proteger a sua privacidade.{% endif %}
diff --git a/translations/pt-BR/data/reusables/pull_requests/commit-message-with-trailer-beginning.md b/translations/pt-BR/data/reusables/pull_requests/commit-message-with-trailer-beginning.md
index 08c05d621e1c..867c62e83be9 100644
--- a/translations/pt-BR/data/reusables/pull_requests/commit-message-with-trailer-beginning.md
+++ b/translations/pt-BR/data/reusables/pull_requests/commit-message-with-trailer-beginning.md
@@ -1,4 +1,4 @@
-1. Type your commit message and a short, meaningful description of your changes. After your commit description, instead of a closing quotation, add two empty lines.
+1. Digite sua mensagem de commit e uma descrição curta e significativa de suas alterações. Depois da descrição do commit, em vez de inserir aspas para encerrar, adicione duas linhas vazias.
   ```shell
   $ git commit -m "Refactor usability tests.
   >
@@ -6,6 +6,6 @@
   ```
   {% tip %}
 
-  **Tip:** If you're using a text editor on the command line to type your commit message, ensure there are two newlines between the end of your commit description and the `Co-authored-by:` commit trailer.
+  **Dica:** Se estiver usando um editor de texto na linha de comando para digitar sua mensagem de commit, certifique-se de que existam duas novas linhas entre o final da sua descrição de commit e o indicador `Co-authored-by:`.
 
   {% endtip %}
diff --git a/translations/pt-BR/data/reusables/pull_requests/configure_pull_request_merges_intro.md b/translations/pt-BR/data/reusables/pull_requests/configure_pull_request_merges_intro.md
index 90b0cbd66691..d195dac9608b 100644
--- a/translations/pt-BR/data/reusables/pull_requests/configure_pull_request_merges_intro.md
+++ b/translations/pt-BR/data/reusables/pull_requests/configure_pull_request_merges_intro.md
@@ -1 +1 @@
-You can configure pull request merge options on {% data variables.product.product_location %} to meet your workflow needs and preferences for managing Git history. Para obter mais informações, consulte "[Configurando merges da pull request](/articles/configuring-pull-request-merges)".
+Você pode configurar as opções de merge de pull request no {% data variables.product.product_location %} para atender às suas necessidades de fluxo de trabalho e preferências para gerenciar o histórico do Git. Para obter mais informações, consulte "[Configurando merges da pull request](/articles/configuring-pull-request-merges)".
diff --git a/translations/pt-BR/data/reusables/pull_requests/decide-how-to-resolve-competing-line-change-merge-conflict.md b/translations/pt-BR/data/reusables/pull_requests/decide-how-to-resolve-competing-line-change-merge-conflict.md
index c53add3df7c9..7f5d5b105ba0 100644
--- a/translations/pt-BR/data/reusables/pull_requests/decide-how-to-resolve-competing-line-change-merge-conflict.md
+++ b/translations/pt-BR/data/reusables/pull_requests/decide-how-to-resolve-competing-line-change-merge-conflict.md
@@ -1 +1 @@
-1. Decide if you want to keep only your branch's changes, keep only the other branch's changes, or make a brand new change, which may incorporate changes from both branches. Delete the conflict markers `<<<<<<<`, `=======`, `>>>>>>>` and make the changes you want in the final merge.
+1. Decida se você deseja manter apenas as alterações do seu branch, manter apenas as alterações do outro branch, ou fazer uma nova alteração, que pode incorporar alterações de ambos os branches. Exclua os marcadores de conflito `<<<<<<<`, `=============` `>>>>>>>` e faça as alterações desejadas no merge final.
diff --git a/translations/pt-BR/data/reusables/pull_requests/default-commit-message-squash-merge.md b/translations/pt-BR/data/reusables/pull_requests/default-commit-message-squash-merge.md
index 4d1056d48adb..7299ed79e834 100644
--- a/translations/pt-BR/data/reusables/pull_requests/default-commit-message-squash-merge.md
+++ b/translations/pt-BR/data/reusables/pull_requests/default-commit-message-squash-merge.md
@@ -1 +1 @@
-For information about the default commit messages for squash merges, see "[About pull request merges](/github/collaborating-with-issues-and-pull-requests/about-pull-request-merges#merge-message-for-a-squash-merge)."
\ No newline at end of file
+Para obter informações sobre as mensagens de commit padrão, para combinação por squash, consulte "[Sobre merges de pull request](/github/collaborating-with-issues-and-pull-requests/about-pull-request-merges#merge-message-for-a-squash-merge)".
diff --git a/translations/pt-BR/data/reusables/pull_requests/default_merge_option.md b/translations/pt-BR/data/reusables/pull_requests/default_merge_option.md
index 2b06d50177a8..6056e0e52d69 100644
--- a/translations/pt-BR/data/reusables/pull_requests/default_merge_option.md
+++ b/translations/pt-BR/data/reusables/pull_requests/default_merge_option.md
@@ -1,5 +1,5 @@
-When you click the default **Merge pull request** option on a pull request on {% data variables.product.product_location %}, all commits from the feature branch are added to the base branch in a merge commit. The pull request is merged using [the `--no-ff` option](https://git-scm.com/docs/git-merge#_fast_forward_merge).
+Ao clicar na opção-padrão **Fazer merge de pull request** em um pull request no {% data variables.product.product_location %}, todos os commits do branch de recurso serão adicionados ao branch de base em um commit de merge. O pull request é mesclado utilizando a opção [ `--no-ff`](https://git-scm.com/docs/git-merge#_fast_forward_merge).
 
-To merge pull requests, you must have [write permissions](/articles/repository-permission-levels-for-an-organization/) in the repository.
+Para fazer merge de pull requests, você precisa ter [permissões de gravação](/articles/repository-permission-levels-for-an-organization/) no repositório.
 
 ![standard-merge-commit-diagram](/assets/images/help/pull_requests/standard-merge-commit-diagram.png)
diff --git a/translations/pt-BR/data/reusables/pull_requests/mark-ready-review.md b/translations/pt-BR/data/reusables/pull_requests/mark-ready-review.md
index e06162167878..568b0b02c7c3 100644
--- a/translations/pt-BR/data/reusables/pull_requests/mark-ready-review.md
+++ b/translations/pt-BR/data/reusables/pull_requests/mark-ready-review.md
@@ -1 +1 @@
-When you're ready to get feedback on your pull request, you can mark your draft pull request as ready for review. Marking a pull request as ready for review will request reviews from any code owners.
\ No newline at end of file
+Quando você estiver pronto para receber feedback sobre seu pull request, você poderá marcar seu rascunho de pull request como pronto para revisão. Marcar um pull request como pronto para revisão irá solicitar revisões de qualquer proprietário de código.
diff --git a/translations/pt-BR/data/reusables/pull_requests/perms-to-open-pull-request.md b/translations/pt-BR/data/reusables/pull_requests/perms-to-open-pull-request.md
index fb02373ebbe9..5769ba413a60 100644
--- a/translations/pt-BR/data/reusables/pull_requests/perms-to-open-pull-request.md
+++ b/translations/pt-BR/data/reusables/pull_requests/perms-to-open-pull-request.md
@@ -2,7 +2,7 @@
 
 {% note %}
 
-**Note**: To open a pull request in a public repository, you must have write access to the head or the source branch or, for organization-owned repositories, you must be a member of the organization that owns the repository to open a pull request.
+**Observação**: Para abrir um pull request em um repositório público, você deve ter acesso de gravação no cabeçalho do branch de origem ou, para para repositórios pertencentes à organização, você deve ser integrante da organização proprietária do repositório para abrir um pull request.
 
 {% endnote %}
 
diff --git a/translations/pt-BR/data/reusables/pull_requests/pull_request_merges_and_contributions.md b/translations/pt-BR/data/reusables/pull_requests/pull_request_merges_and_contributions.md
index 1117b51b1e29..bf75017c4ff6 100644
--- a/translations/pt-BR/data/reusables/pull_requests/pull_request_merges_and_contributions.md
+++ b/translations/pt-BR/data/reusables/pull_requests/pull_request_merges_and_contributions.md
@@ -1,7 +1,7 @@
 {% note %}
 
-**Notes:**{% if currentVersion != "free-pro-team@latest" %}
-- To appear on your profile contributions graph, co-authored commits must meet the same criteria as commits with one author.{% endif %}
-- When rebasing commits, the original authors of the commit and the person who rebased the commits, whether on the command line or on {% data variables.product.product_location %}, receive contribution credit.
+**Observações:**{% if currentVersion != "free-pro-team@latest" %}
+- Para aparecer no gráfico de contribuições do seu perfil, os commits de criação conjunta devem atender aos mesmos critérios que os commits com um autor.{% endif %}
+- Ao fazer rebase dos commits, os autores originais do commit e a pessoa que fez o rebase dos commits, seja na linha de comando ou em {% data variables.product.product_location %}, receberá o crédito de contribuição.
 
 {% endnote %}
diff --git a/translations/pt-BR/data/reusables/pull_requests/rebase_and_merge_summary.md b/translations/pt-BR/data/reusables/pull_requests/rebase_and_merge_summary.md
index 284f536db25c..4aee111bdd75 100644
--- a/translations/pt-BR/data/reusables/pull_requests/rebase_and_merge_summary.md
+++ b/translations/pt-BR/data/reusables/pull_requests/rebase_and_merge_summary.md
@@ -1,7 +1,7 @@
-When you select the **Rebase and merge** option on a pull request on {% data variables.product.product_location %}, all commits from the topic branch (or head branch) are added onto the base branch individually without a merge commit. Pull requests with rebased commits are merged using the [fast-forward option](https://git-scm.com/docs/git-merge#_fast_forward_merge).
+Ao selecionar a opção **Rebase e merge** em um pull request no {% data variables.product.product_location %}, todos os commits do branch de tópico (ou branch de cabeçalho) serão adicionados ao branch base individualmente sem um commit do merge . Pull requests com commits de rebase em commits são mesclados usando a opção de [fast-forward](https://git-scm.com/docs/git-merge#_fast_forward_merge).
 
-To rebase and merge pull requests, you must have [write permissions](/articles/repository-permission-levels-for-an-organization/) in the repository, and the repository must [allow rebase merging](/articles/configuring-commit-rebasing-for-pull-requests/).
+Para fazer rebase e merge de pull requests, você deve ter [permissões de gravação](/articles/repository-permission-levels-for-an-organization/) no repositório, e o repositório deve [permitir o merge de rebase](/articles/configuring-commit-rebasing-for-pull-requests/).
 
-The rebase and merge behavior on {% data variables.product.product_name %} deviates slightly from `git rebase`. Rebase and merge on {% data variables.product.prodname_dotcom %} will always update the committer information and create new commit SHAs, whereas `git rebase` outside of {% data variables.product.prodname_dotcom %} does not change the committer information when the rebase happens on top of an ancestor commit. For more information about `git rebase`, see [the "Git rebase" chapter from the _Pro Git_ book](https://git-scm.com/docs/git-rebase).
+O comportamento de rebase e merge em {% data variables.product.product_name %} é ligeiramente diferente do `rebase do git`. O rebase e o merge em {% data variables.product.prodname_dotcom %} sempre atualizará as informações do autor do commit e criará novos SHAs, enquanto `rebase do git` fora do {% data variables.product.prodname_dotcom %} não altera a informação do committer quando a rebase acontece em cima de um commit de ancestral. Para obter mais informações sobre `rebase do git`, consulte [o capítulo "Rebase do Git" no _livro_ Pro Git](https://git-scm.com/docs/git-rebase).
 
-For a visual representation of `git rebase`, see [The "Git Branching - Rebasing" chapter from the _Pro Git_ book](https://git-scm.com/book/en/Git-Branching-Rebasing).
+Para obter uma representação visual do `rebase do git`, consulte [o capítulo "Branches do Git - Rebase" do livro _Pro Git_](https://git-scm.com/book/en/Git-Branching-Rebasing).
diff --git a/translations/pt-BR/data/reusables/pull_requests/required-checks-must-pass-to-merge.md b/translations/pt-BR/data/reusables/pull_requests/required-checks-must-pass-to-merge.md
index 78e20b077fa0..dd4d5866e608 100644
--- a/translations/pt-BR/data/reusables/pull_requests/required-checks-must-pass-to-merge.md
+++ b/translations/pt-BR/data/reusables/pull_requests/required-checks-must-pass-to-merge.md
@@ -1 +1 @@
-If status checks are required for a repository, the required status checks must pass before you can merge your branch into the protected branch. Para obter mais informações, consulte "[Sobre verificações de status obrigatórias](/articles/about-required-status-checks)".
+Se as verificações de status forem necessárias para um repositório, as verificações de status necessárias devem passar antes que você possa fazer merge do seu branch no branch protegido. Para obter mais informações, consulte "[Sobre verificações de status obrigatórias](/articles/about-required-status-checks)".
diff --git a/translations/pt-BR/data/reusables/pull_requests/required-reviews-for-prs-summary.md b/translations/pt-BR/data/reusables/pull_requests/required-reviews-for-prs-summary.md
index 884bc5bfae26..75c4abeb18cf 100644
--- a/translations/pt-BR/data/reusables/pull_requests/required-reviews-for-prs-summary.md
+++ b/translations/pt-BR/data/reusables/pull_requests/required-reviews-for-prs-summary.md
@@ -1,3 +1,3 @@
-Repository administrators can require that all pull requests receive a specific number of approving reviews from people with *write* or *admin* permissions in the repository or from a designated code owner before they're merged into a protected branch. Para obter mais informações, consulte "[Sobre branches protegidos](/articles/about-protected-branches)".
+Os administradores do repositório podem exigir que todos os pull requests recebam um número específico de revisões de aprovações de pessoas com permissões de *gravação* ou *administrador* no repositório ou de um proprietário do código designado, antes de serem mesclados em um branch protegido. Para obter mais informações, consulte "[Sobre branches protegidos](/articles/about-protected-branches)".
 
-When required reviews are enabled, anyone with access to the repository can approve changes in a pull request. However, you won't be able to merge your pull request until the required number of reviewers with *write* or *admin* permissions in the repository approve your pull request's changes in their review. For more information about repository permission levels, see "[Repository permission levels for an organization](/articles/repository-permission-levels-for-an-organization/)." If review is required from a designated code owner and the pull request affects code that has a designated owner, approval from that owner is required.
+Quando as revisões necessárias estão ativadas, qualquer pessoa com acesso ao repositório poderá aprovar alterações em um pull request. No entanto você não conseguirá fazer merge do seu pull request até que o número necessário de revisores com permissões de *gravação* ou *admin* no repositório aprove as alterações do seu pull request na sua revisão. Para obter mais informações sobre os níveis de permissão do repositório, consulte "[Níveis de permissão do repositório para uma organização](/articles/repository-permission-levels-for-an-organization/)". Se a revisão for necessária de um proprietário do código designado e o pull request afetar o código que tem um proprietário designado, a aprovação deste proprietário será obrigatória.
diff --git a/translations/pt-BR/data/reusables/pull_requests/resolving-conversations.md b/translations/pt-BR/data/reusables/pull_requests/resolving-conversations.md
index dc9a46856cc4..4e671786995b 100644
--- a/translations/pt-BR/data/reusables/pull_requests/resolving-conversations.md
+++ b/translations/pt-BR/data/reusables/pull_requests/resolving-conversations.md
@@ -1,13 +1,13 @@
 ### Resolver conversas
 
-You can resolve a conversation in a pull request if you opened the pull request or if you have write access to the repository where the pull request was opened.
+É possível resolver uma conversa em um pull request se você abriu o pull request ou se você tem acesso de gravação ao repositório em que o pull request foi aberto.
 
-To indicate that a conversation on the **Files changed** tab is complete, click **Resolve conversation**.
+Para indicar que uma conversa na aba **Arquivos alterados** está completa, clique em **Resolver conversa**.
 
-![Pull request conversation with Resolve conversation button](/assets/images/help/pull_requests/conversation-with-resolve-button.png)
+![Conversa de pull request com o botão de Resolver conversa](/assets/images/help/pull_requests/conversation-with-resolve-button.png)
 
-The entire conversation will be collapsed and marked as resolved, making it easier to find conversations that still need to be addressed.
+Toda a conversa será colapsada e marcada como resolvida, tornando mais fácil encontrar conversas que ainda precisam ser consideradas.
 
-![Resolved conversation](/assets/images/help/pull_requests/resolved-conversation.png)
+![Conversa resolvida](/assets/images/help/pull_requests/resolved-conversation.png)
 
-If the suggestion in a comment is out of your pull request's scope, you can open a new issue that tracks the feedback and links back to the original comment. Para obter mais informações, consulte "[Abrir um problema a partir de um comentário](/github/managing-your-work-on-github/opening-an-issue-from-a-comment)".
+Se a sugestão em um comentário estiver fora do escopo do seu pull request, você pode abrir um novo problema que rastreia os comentários e relaciona o comentário original. Para obter mais informações, consulte "[Abrir um problema a partir de um comentário](/github/managing-your-work-on-github/opening-an-issue-from-a-comment)".
diff --git a/translations/pt-BR/data/reusables/pull_requests/retargeted-on-branch-deletion.md b/translations/pt-BR/data/reusables/pull_requests/retargeted-on-branch-deletion.md
index f5d86310e293..9891aea3a7e0 100644
--- a/translations/pt-BR/data/reusables/pull_requests/retargeted-on-branch-deletion.md
+++ b/translations/pt-BR/data/reusables/pull_requests/retargeted-on-branch-deletion.md
@@ -1 +1 @@
-If you delete a head branch after its pull request has been merged, {% data variables.product.prodname_dotcom %} checks for any open pull requests in the same repository that specify the deleted branch as their base branch. {% data variables.product.prodname_dotcom %} automatically updates any such pull requests, changing their base branch to the merged pull request's base branch.
+Se você excluir um branch de cabeçalho após o merge do seu pull request, o {% data variables.product.prodname_dotcom %} irá verificar se há quaisquer solicitações de pull no mesmo repositório que especificam o branch excluído como o branch base. O {% data variables.product.prodname_dotcom %} atualiza automaticamente quaisquer pull requests, alterando o branch base para o branch base do pull request mesclado.
diff --git a/translations/pt-BR/data/reusables/pull_requests/squash_and_merge_summary.md b/translations/pt-BR/data/reusables/pull_requests/squash_and_merge_summary.md
index b764c443f2ec..cf0d2fcfc70d 100644
--- a/translations/pt-BR/data/reusables/pull_requests/squash_and_merge_summary.md
+++ b/translations/pt-BR/data/reusables/pull_requests/squash_and_merge_summary.md
@@ -1,7 +1,7 @@
-When you select the **Squash and merge** option on a pull request on {% data variables.product.product_location %}, the pull request's commits are squashed into a single commit. Instead of seeing all of a contributor's individual commits from a topic branch, the commits are combined into one commit and merged into the default branch. Pull requests with squashed commits are merged using the [fast-forward option](https://git-scm.com/docs/git-merge#_fast_forward_merge).
+Ao selecionar a opção **Combinação por squash e merge** em um pull request no {% data variables.product.product_location %}, os commits do pull request são combinados em um único commit. Em vez de ver todos os commits individuais de um contribuidor de um branch de tópico, os commits são combinados em um commit e mesclados no branch-padrão. Os pull requests com commits combinados são mesclados usando a [opção fast-forward](https://git-scm.com/docs/git-merge#_fast_forward_merge).
 
-To squash and merge pull requests, you must have [write permissions](/articles/repository-permission-levels-for-an-organization/) in the repository, and the repository must [allow squash merging](/articles/configuring-commit-squashing-for-pull-requests/).
+Para realizar a combinação por squash e mesclar pull requests, você deve ter [permissões de gravação](/articles/repository-permission-levels-for-an-organization/) no repositório e o repositório deve [permitir o merge por combinação por squash](/articles/configuring-commit-squashing-for-pull-requests/).
 
 ![commit-squashing-diagram](/assets/images/help/pull_requests/commit-squashing-diagram.png)
 
-You can use squash and merge to create a more streamlined Git history in your repository. Work-in-progress commits are helpful when working on a feature branch, but they aren’t necessarily important to retain in the Git history. If you squash these commits into one commit while merging to the default branch, you can retain the original changes with a clear Git history.
+Você pode usar combinação por squash e merge para criar um histórico de Git mais simplificado no seu repositório. Os commits de trabalho em andamento são úteis ao trabalhar em um branch de recurso, mas não são necessariamente importantes para manter no histórico do Git. Se você fizer a combinação por squash desses commits em um commit enquanto faz merge com o branch-padrão, você certamente poderá manter as alterações originais com um histórico Git.
diff --git a/translations/pt-BR/data/reusables/reminders/about-scheduled-reminders-teams-orgs.md b/translations/pt-BR/data/reusables/reminders/about-scheduled-reminders-teams-orgs.md
index 3a54d30980e2..ce949a11b111 100644
--- a/translations/pt-BR/data/reusables/reminders/about-scheduled-reminders-teams-orgs.md
+++ b/translations/pt-BR/data/reusables/reminders/about-scheduled-reminders-teams-orgs.md
@@ -1 +1 @@
-Scheduled reminders help teams focus on the most important review requests that require their attention. Scheduled reminders for pull requests will send a message to your team in Slack with all open pull requests that you or your team have been asked to review, at a specified time. For example, you can create a scheduled reminder to send a message to your team's main communication channel in Slack, including all open pull requests that the team is requested to review, every Wednesday at 9:00 a.m.
+Lembretes agendados ajudam as equipes a focar-se nas solicitações de revisão mais importantes que requerem sua atenção. Os lembretes agendados para pull requests enviarão uma mensagem para a sua equipe no Slack com todos os pull requests abertos que você ou sua equipe tiveram de revisar, em um horário especificado. Por exemplo, você pode criar um lembrete agendado para enviar uma mensagem para o canal de comunicação principal do seu time no Slack, incluindo todos os pull requests abertos que se solicita que a equipe revise todas as quartas-feiras às 9h.
diff --git a/translations/pt-BR/data/reusables/reminders/add-reminder.md b/translations/pt-BR/data/reusables/reminders/add-reminder.md
index b80a5ec5d0d9..c747c7cb63c8 100644
--- a/translations/pt-BR/data/reusables/reminders/add-reminder.md
+++ b/translations/pt-BR/data/reusables/reminders/add-reminder.md
@@ -1 +1 @@
-1. Under "Scheduled reminders", click **Add your first reminder**. ![Add reminder button](/assets/images/help/settings/scheduled-reminders-add-button.png)
+1. Em "Lembretes agendados" clique em **Adicionar seu primeiro lembrete**. ![Botão de Adicionar lembrete](/assets/images/help/settings/scheduled-reminders-add-button.png)
diff --git a/translations/pt-BR/data/reusables/reminders/approved-prs.md b/translations/pt-BR/data/reusables/reminders/approved-prs.md
index 6409371ffe24..482434c9149d 100644
--- a/translations/pt-BR/data/reusables/reminders/approved-prs.md
+++ b/translations/pt-BR/data/reusables/reminders/approved-prs.md
@@ -1 +1 @@
-1. Optionally, to turn off scheduled reminders for pull requests that have already been reviewed and approved, select **Ignore approved pull requests**. Then, click the **Ignore with 1 or more approvals** to choose how many approvals a pull request must have to be ignored. ![Ignore approved pull requests checkbox](/assets/images/help/settings/scheduled-reminders-ignore-approved-prs.png)
+1. Opcionalmente, para desativar lembretes agendados para pull requests que já foram revisados e aprovados, selecione **Ignorar pull requests aprovados**. Em seguida, clique em **Ignorar com 1 ou mais aprovações** para escolher cm quantas aprovações um pull request deve ser ignorado. ![Ignorar caixa de seleção de pull requests aprovados](/assets/images/help/settings/scheduled-reminders-ignore-approved-prs.png)
diff --git a/translations/pt-BR/data/reusables/reminders/author-reviews.md b/translations/pt-BR/data/reusables/reminders/author-reviews.md
index f800bd1be4b0..fa8fedd5b636 100644
--- a/translations/pt-BR/data/reusables/reminders/author-reviews.md
+++ b/translations/pt-BR/data/reusables/reminders/author-reviews.md
@@ -1 +1 @@
-1. Optionally, to send reminders to the pull request authors after the review requests have been fulfilled, select **Remind authors after reviews** and choose the number of reviews required before a reminder is sent. ![Remind authors after reviews checkbox](/assets/images/help/settings/scheduled-reminders-remind-authors.png)
\ No newline at end of file
+1. Opcionalmente, para enviar lembretes para os autores do pull request após o atendimento das solicitações de revisão, selecione **Lembrar os autores após as revisões** e escolha o número de revisões necessárias antes de um lembrete ser enviado. ![Caixa de seleção para lembrar os autores depois da revisão](/assets/images/help/settings/scheduled-reminders-remind-authors.png)
diff --git a/translations/pt-BR/data/reusables/reminders/authorize-slack.md b/translations/pt-BR/data/reusables/reminders/authorize-slack.md
index 51b20474e579..675de5d3d715 100644
--- a/translations/pt-BR/data/reusables/reminders/authorize-slack.md
+++ b/translations/pt-BR/data/reusables/reminders/authorize-slack.md
@@ -1 +1 @@
-1. Under "Slack workspace", click **Authorize Slack workspace** and follow the instructions. ![Authorize Slack workspace button](/assets/images/help/settings/scheduled-reminders-authorize-slack.png)
+1. Em "Área de trabalho do Slack", clique em **Autorizar área de trabalho do Slack** e siga as instruções. ![Botão de Autorizar área de trabalho do Slack](/assets/images/help/settings/scheduled-reminders-authorize-slack.png)
diff --git a/translations/pt-BR/data/reusables/reminders/create-reminder.md b/translations/pt-BR/data/reusables/reminders/create-reminder.md
index f70e927787ce..8135d7f172d6 100644
--- a/translations/pt-BR/data/reusables/reminders/create-reminder.md
+++ b/translations/pt-BR/data/reusables/reminders/create-reminder.md
@@ -1 +1 @@
-1. Click **Create reminder**.
+1. Clique em **Criar lembrete**.
diff --git a/translations/pt-BR/data/reusables/reminders/days-dropdown.md b/translations/pt-BR/data/reusables/reminders/days-dropdown.md
index 5c57e72fccf7..50839aa18c3c 100644
--- a/translations/pt-BR/data/reusables/reminders/days-dropdown.md
+++ b/translations/pt-BR/data/reusables/reminders/days-dropdown.md
@@ -1 +1 @@
-1. Under "Days", click **Weekdays** {% octicon "triangle-down" aria-label="The down triangle icon" %} to select one or more days you'd like to receive scheduled reminders. ![Days dropdown](/assets/images/help/settings/scheduled-reminders-days.png)
+1. Em "Dias", clique em **Dias da semana** {% octicon "triangle-down" aria-label="The down triangle icon" %} para selecionar um ou mais dias em que você gostaria de receber lembretes agendados. ![Menu suspenso de dias](/assets/images/help/settings/scheduled-reminders-days.png)
diff --git a/translations/pt-BR/data/reusables/reminders/delete.md b/translations/pt-BR/data/reusables/reminders/delete.md
index 6c1f4976f99b..d3d5ee1eeb9b 100644
--- a/translations/pt-BR/data/reusables/reminders/delete.md
+++ b/translations/pt-BR/data/reusables/reminders/delete.md
@@ -1,2 +1,2 @@
-1. At the bottom of the page, click **Delete this reminder**. ![Delete a scheduled reminder button](/assets/images/help/settings/scheduled-reminders-delete.png)
-1. To confirm that you want to delete the scheduled reminder, click **OK**.
+1. Na parte inferior da página, clique em **Excluir este lembrete**. ![Botão de excluir um lembrete agendado](/assets/images/help/settings/scheduled-reminders-delete.png)
+1. Para confirmar que deseja excluir o lembrete agendado, clique em **OK**.
diff --git a/translations/pt-BR/data/reusables/reminders/edit-existing.md b/translations/pt-BR/data/reusables/reminders/edit-existing.md
index 8236a92d191a..78616e57024d 100644
--- a/translations/pt-BR/data/reusables/reminders/edit-existing.md
+++ b/translations/pt-BR/data/reusables/reminders/edit-existing.md
@@ -1 +1 @@
-1. Next to the scheduled reminder you'd like to update, click **Edit**. ![Edit existing scheduled reminder](/assets/images/help/settings/scheduled-reminders-edit-existing.png)
+1. Ao lado do lembrete agendado que você deseja atualizar, clique em **Editar**. ![Editar lembrete programado existente](/assets/images/help/settings/scheduled-reminders-edit-existing.png)
diff --git a/translations/pt-BR/data/reusables/reminders/edit-page.md b/translations/pt-BR/data/reusables/reminders/edit-page.md
index b0a9ac08353e..3dc0bd05c6fe 100644
--- a/translations/pt-BR/data/reusables/reminders/edit-page.md
+++ b/translations/pt-BR/data/reusables/reminders/edit-page.md
@@ -1 +1 @@
-1. Make one or more changes to your scheduled reminder.
+1. Faça uma ou mais alterações no lembrete agendado.
diff --git a/translations/pt-BR/data/reusables/reminders/ignore-drafts.md b/translations/pt-BR/data/reusables/reminders/ignore-drafts.md
index 0ffebdf43a60..307b15d54141 100644
--- a/translations/pt-BR/data/reusables/reminders/ignore-drafts.md
+++ b/translations/pt-BR/data/reusables/reminders/ignore-drafts.md
@@ -1 +1 @@
-1. Optionally, to exclude draft pull requests from scheduled reminders, select **Ignore drafts**. For more information, see "[Draft pull requests](/github/collaborating-with-issues-and-pull-requests/about-pull-requests#draft-pull-requests)." ![Ignore draft pull requests checkbox](/assets/images/help/settings/scheduled-reminders-ignore-drafts.png)
+1. Opcionalmente, para excluir rascunho de pull requests dos lembretes agendados, selecione **Ignorar rascunhos**. Para obter mais informações, consulte "[Rascunhos de pull requests](/github/collaborating-with-issues-and-pull-requests/about-pull-requests#draft-pull-requests)". ![Caixa de seleção de ignorar rascunhos de pull requests](/assets/images/help/settings/scheduled-reminders-ignore-drafts.png)
diff --git a/translations/pt-BR/data/reusables/reminders/ignored-labels.md b/translations/pt-BR/data/reusables/reminders/ignored-labels.md
index a34db3d8436d..3a82fff2d220 100644
--- a/translations/pt-BR/data/reusables/reminders/ignored-labels.md
+++ b/translations/pt-BR/data/reusables/reminders/ignored-labels.md
@@ -1 +1 @@
-1. Under "Ignored labels", type a comma-separated list of labels. Scheduled reminders won't include any pull requests that have one or more of these labels. ![Ignored labels field](/assets/images/help/settings/scheduled-reminders-ignored-labels-field.png)
\ No newline at end of file
+1. Em "etiquetas ignoradas", digite uma lista de etiquetas separadas por vírgulas. Os lembretes agendados não incluirão quaisquer pull requests que possuam uma ou mais dessas etiquetas. ![Campos de etiquetas ignoradas](/assets/images/help/settings/scheduled-reminders-ignored-labels-field.png)
diff --git a/translations/pt-BR/data/reusables/reminders/ignored-terms.md b/translations/pt-BR/data/reusables/reminders/ignored-terms.md
index ce68dfe48045..bad277cf0f4a 100644
--- a/translations/pt-BR/data/reusables/reminders/ignored-terms.md
+++ b/translations/pt-BR/data/reusables/reminders/ignored-terms.md
@@ -1 +1 @@
-1. Under "Ignored terms", type a comma-separated list of terms that may appear in titles of pull requests. Scheduled reminders won't include any pull requests that contain one or more of these terms in their titles. ![Ignored terms field](/assets/images/help/settings/scheduled-reminders-ignored-terms-field.png)
\ No newline at end of file
+1. Em "Ignorados termos", digite uma lista de termos separados por vírgulas que podem aparecer em títulos de pull requests. Os lembretes agendados não incluirão quaisquer pull requests que contenham um ou mais destes termos nos seus títulos. ![Campo de termos ignorados](/assets/images/help/settings/scheduled-reminders-ignored-terms-field.png)
diff --git a/translations/pt-BR/data/reusables/reminders/min-age.md b/translations/pt-BR/data/reusables/reminders/min-age.md
index 5ad2ca5a0b03..efd1381973be 100644
--- a/translations/pt-BR/data/reusables/reminders/min-age.md
+++ b/translations/pt-BR/data/reusables/reminders/min-age.md
@@ -1 +1 @@
-1. Under "Minimum age", type the age of a pull request, in hours. Scheduled reminders won't include pull requests that are newer than this age limit. ![Ignored labels field](/assets/images/help/settings/scheduled-reminders-min-age-field.png)
\ No newline at end of file
+1. Em "Idade mínima", digite a idade de um pull request em horas. Lembretes agendados não incluirão pull requests que são mais recentes do que este limite de idade. ![Campos de etiquetas ignoradas](/assets/images/help/settings/scheduled-reminders-min-age-field.png)
diff --git a/translations/pt-BR/data/reusables/reminders/min-staleness.md b/translations/pt-BR/data/reusables/reminders/min-staleness.md
index 14a98d4461d2..0be6f90bc627 100644
--- a/translations/pt-BR/data/reusables/reminders/min-staleness.md
+++ b/translations/pt-BR/data/reusables/reminders/min-staleness.md
@@ -1 +1 @@
-1. Under "Minimum staleness", type the time since the last activity on a pull request, in hours. Scheduled reminders won't include pull requests whose last activity was more recent than this time. ![Minimum staleness field](/assets/images/help/settings/scheduled-reminders-min-staleness-field.png)
\ No newline at end of file
+1. Em "Tempo mínimo decorrido", digite o tempo desde a última atividade em um pull request, em horas. Os lembretes agendados não incluirão pull requests cuja última atividade foi mais recente do que este tempo. ![Campo de tempo mínimo decorrido](/assets/images/help/settings/scheduled-reminders-min-staleness-field.png)
diff --git a/translations/pt-BR/data/reusables/reminders/no-review-requests.md b/translations/pt-BR/data/reusables/reminders/no-review-requests.md
index 58e512da44b4..cc3b9b3d7ad7 100644
--- a/translations/pt-BR/data/reusables/reminders/no-review-requests.md
+++ b/translations/pt-BR/data/reusables/reminders/no-review-requests.md
@@ -1 +1 @@
-1. Optionally, to only include pull requests where a review is specifically requested from the team or a team member, select **Require review requests**. If you don't select this option, all pull requests are included in the scheduled reminder. ![Ignore pull requests with no review requests checkbox](/assets/images/help/settings/scheduled-reminders-prs-without-requests.png)
+1. Opcionalmente, para incluir apenas pull requests em que uma análise é solicitada especificamente pela equipe ou por um integrante da equipe, selecione **Exigir solicitações de revisão**. Se você não selecionar esta opção, todos os pull requests serão incluídos no lembrete agendado. ![Caixa de ignorar pull requests sem solicitações de revisão](/assets/images/help/settings/scheduled-reminders-prs-without-requests.png)
diff --git a/translations/pt-BR/data/reusables/reminders/real-time-alerts.md b/translations/pt-BR/data/reusables/reminders/real-time-alerts.md
index 6146a5751871..2cf98a5db96c 100644
--- a/translations/pt-BR/data/reusables/reminders/real-time-alerts.md
+++ b/translations/pt-BR/data/reusables/reminders/real-time-alerts.md
@@ -1 +1 @@
-1. Optionally, to receive Slack messages as soon as certain events happen, select **Enable real-time alerts** and select the events to receive real-time alerts for.
\ No newline at end of file
+1. Opcionalmente, para receber mensagens do Slack assim que certos eventos ocorrerem, selecione **Habilitar os alertas em tempo real** e selecione os eventos para os quais deseja receber alertas em tempo real.
diff --git a/translations/pt-BR/data/reusables/reminders/required-labels.md b/translations/pt-BR/data/reusables/reminders/required-labels.md
index fa8a91cdafe6..ebf1e7749314 100644
--- a/translations/pt-BR/data/reusables/reminders/required-labels.md
+++ b/translations/pt-BR/data/reusables/reminders/required-labels.md
@@ -1 +1 @@
-1. Under "Required labels", type a comma-separated list of labels. Scheduled reminders will only include pull requests that haven't already been ignored, if they have one or more of these labels. ![Required labels field](/assets/images/help/settings/scheduled-reminders-required-labels-field.png)
\ No newline at end of file
+1. Em "Etiquetas obrigatórias", digite uma lista de etiquetas, separada por vírgulas. Os lembretes agendados incluirão apenas pull requests que ainda não foram ignorados, se tiverem uma ou mais dessas etiquetas. ![Campo de etiquetas obrigatórias](/assets/images/help/settings/scheduled-reminders-required-labels-field.png)
diff --git a/translations/pt-BR/data/reusables/reminders/scheduled-reminders.md b/translations/pt-BR/data/reusables/reminders/scheduled-reminders.md
index b30754d943b5..d937d6ff209f 100644
--- a/translations/pt-BR/data/reusables/reminders/scheduled-reminders.md
+++ b/translations/pt-BR/data/reusables/reminders/scheduled-reminders.md
@@ -1 +1 @@
-1. In the left sidebar, click **Scheduled reminders**.
+1. Na barra lateral esquerda, clique em **Lembretes agendados**.
diff --git a/translations/pt-BR/data/reusables/reminders/slack-channel.md b/translations/pt-BR/data/reusables/reminders/slack-channel.md
index c8435db15880..defae314a43f 100644
--- a/translations/pt-BR/data/reusables/reminders/slack-channel.md
+++ b/translations/pt-BR/data/reusables/reminders/slack-channel.md
@@ -1 +1 @@
-1. Under "Slack channel", type the name of the Slack channel where you'd like to receive notifications. ![Slack channel field](/assets/images/help/settings/scheduled-reminders-slack-channel.png)
+1. Em "Canal do Slack", digite o nome do canal do Slack onde você gostaria de receber notificações. ![Campo do canal do Slack](/assets/images/help/settings/scheduled-reminders-slack-channel.png)
diff --git a/translations/pt-BR/data/reusables/reminders/times-dropdowns.md b/translations/pt-BR/data/reusables/reminders/times-dropdowns.md
index 5fd8b91b011b..e3aa501a7d19 100644
--- a/translations/pt-BR/data/reusables/reminders/times-dropdowns.md
+++ b/translations/pt-BR/data/reusables/reminders/times-dropdowns.md
@@ -1 +1 @@
-1. Under "Select Time(s)", click **9:00 AM** {% octicon "triangle-down" aria-label="The down triangle icon" %} to select one or more times you'd like to receive scheduled reminders. Optionally, to change your timezone, click {% octicon "triangle-down" aria-label="The down triangle icon" %} next to your current timezone and select a different time zone. ![Select time(s) dropdowns](/assets/images/help/settings/scheduled-reminders-times.png)
+1. Em "Selecionar horário(s)", clique em **9h** {% octicon "triangle-down" aria-label="The down triangle icon" %} para selecionar uma ou mais horários em que você gostaria de receber lembretes agendados. Opcionalmente, para mudar o seu fuso horário, clique em {% octicon "triangle-down" aria-label="The down triangle icon" %} ao lado do seu fuso horário atual e selecione um fuso horário diferente. ![Selecione o menu suspenso horário(s)](/assets/images/help/settings/scheduled-reminders-times.png)
diff --git a/translations/pt-BR/data/reusables/reminders/tracked-repos.md b/translations/pt-BR/data/reusables/reminders/tracked-repos.md
index bd40fc3647d1..1aaa3d8ebf0d 100644
--- a/translations/pt-BR/data/reusables/reminders/tracked-repos.md
+++ b/translations/pt-BR/data/reusables/reminders/tracked-repos.md
@@ -1,5 +1,5 @@
-1. Under "Tracked repositories," choose which repositories you'd like the team to receive pull request review reminders for.
-   - To receive reminders for all repositories that the chosen team has access to, click **All repositories**.
-   - To receive reminders for a subset of repositories, click **Only select repositories**, then select one or more repositories that the chosen team has access to.
+1. Em "Repositórios rastreados", escolha para quais repositórios você deseja que a equipe receba lembretes de revisão de pull request.
+   - Para receber lembretes para todos os repositórios aos quais a equipe escolhida tem acesso, clique em **Todos os repositórios**.
+   - Para receber lembretes de um subconjunto de repositórios, clique em **Apenas repositórios selecionados** e, em seguida, selecione um ou mais repositórios aos quais a equipe escolhida tem acesso.
 
-  ![Choose tracked repositories](/assets/images/help/settings/scheduled-reminders-tracked-repos.png)
+  ![Escolha repositórios rastreados](/assets/images/help/settings/scheduled-reminders-tracked-repos.png)
diff --git a/translations/pt-BR/data/reusables/reminders/update-buttons.md b/translations/pt-BR/data/reusables/reminders/update-buttons.md
index aa97a7388511..e9ecf9cbda69 100644
--- a/translations/pt-BR/data/reusables/reminders/update-buttons.md
+++ b/translations/pt-BR/data/reusables/reminders/update-buttons.md
@@ -1 +1 @@
-1. To save your changes, click **Update reminder**. Optionally, to test your changes while updating the changes, click **Update and test reminder**. ![Update buttons](/assets/images/help/settings/scheduled-reminders-update-buttons.png)
+1. Para salvar as alterações, clique em **Atualizar lembrete**. Opcionalmente, para testar suas alterações durante a atualização das alterações, clique em **Atualizar e testar o lembrete**. ![Botões de Atualização](/assets/images/help/settings/scheduled-reminders-update-buttons.png)
diff --git a/translations/pt-BR/data/reusables/repositories/a-vulnerability-is.md b/translations/pt-BR/data/reusables/repositories/a-vulnerability-is.md
index d5e92f35ee19..73fcf6e47abf 100644
--- a/translations/pt-BR/data/reusables/repositories/a-vulnerability-is.md
+++ b/translations/pt-BR/data/reusables/repositories/a-vulnerability-is.md
@@ -1 +1 @@
-Uma vulnerabilidade é um problema no código de um projeto que poderia ser explorada para corromper a confidencialidade, a integridade ou a disponibilidade do projeto ou de outros projetos que usam o código. Vulnerabilities vary in type, severity, and method of attack.
+Uma vulnerabilidade é um problema no código de um projeto que poderia ser explorada para corromper a confidencialidade, a integridade ou a disponibilidade do projeto ou de outros projetos que usam o código. As vulnerabilidades variam de tipo, gravidade e método de ataque.
diff --git a/translations/pt-BR/data/reusables/repositories/about-github-actions.md b/translations/pt-BR/data/reusables/repositories/about-github-actions.md
index d6cd5a6ebb02..7f86dd200ab2 100644
--- a/translations/pt-BR/data/reusables/repositories/about-github-actions.md
+++ b/translations/pt-BR/data/reusables/repositories/about-github-actions.md
@@ -1 +1 @@
-{% data variables.product.prodname_actions %} help you automate your software development workflows in the same place you store code and collaborate on pull requests and issues. You can write individual tasks, called actions, and combine them to create a custom workflow.
+O {% data variables.product.prodname_actions %} ajuda você a automatizar seus fluxos de trabalho de desenvolvimento de software no mesmo lugar que você armazena o código e colabora em pull requests e problemas. Você pode escrever tarefas individuais, chamadas de ações e combiná-las para criar um fluxo de trabalho personalizado.
diff --git a/translations/pt-BR/data/reusables/repositories/about-github-archive-program.md b/translations/pt-BR/data/reusables/repositories/about-github-archive-program.md
index fddb4eb43e15..ae74f4efe483 100644
--- a/translations/pt-BR/data/reusables/repositories/about-github-archive-program.md
+++ b/translations/pt-BR/data/reusables/repositories/about-github-archive-program.md
@@ -1 +1 @@
-By default, all public repositories are included in the {% data variables.product.prodname_archive %}, a partnership between {% data variables.product.prodname_dotcom %} and organizations such as Software Heritage Foundation and Internet Archive to ensure the long-term preservation of the world's open source software.
\ No newline at end of file
+Por padrão, todos os repositórios públicos são incluídos no {% data variables.product.prodname_archive %}, uma parceria entre {% data variables.product.prodname_dotcom %} e organizações como a Software Heritage Foundation e Internet Archive para garantir a preservação a longo prazo do software de código aberto mundial.
diff --git a/translations/pt-BR/data/reusables/repositories/accessing-repository-graphs.md b/translations/pt-BR/data/reusables/repositories/accessing-repository-graphs.md
index 1834d2e486fb..e6ce640d615c 100644
--- a/translations/pt-BR/data/reusables/repositories/accessing-repository-graphs.md
+++ b/translations/pt-BR/data/reusables/repositories/accessing-repository-graphs.md
@@ -1 +1 @@
-1. Under your repository name, click {% octicon "graph" aria-label="The bar graph icon" %} **Insights**. ![Insights tab in the main repository navigation bar](/assets/images/help/repository/repo-nav-insights-tab.png)
+1. No nome do repositório, clique em {% octicon "graph" aria-label="The bar graph icon" %} **Insights**. ![Aba de insights na barra de navegação do repositório principal](/assets/images/help/repository/repo-nav-insights-tab.png)
diff --git a/translations/pt-BR/data/reusables/repositories/accessing-repository-people.md b/translations/pt-BR/data/reusables/repositories/accessing-repository-people.md
index b2f0bda3b309..afb740158e3d 100644
--- a/translations/pt-BR/data/reusables/repositories/accessing-repository-people.md
+++ b/translations/pt-BR/data/reusables/repositories/accessing-repository-people.md
@@ -1 +1 @@
-1. In the left sidebar, click **People**. ![Guia People (Pessoas) na barra lateral do repositório](/assets/images/help/repository/accessing-repository-people.png)
+1. Na barra lateral esquerda, clique em **Pessoas**. ![Guia People (Pessoas) na barra lateral do repositório](/assets/images/help/repository/accessing-repository-people.png)
diff --git a/translations/pt-BR/data/reusables/repositories/action-root-user-required.md b/translations/pt-BR/data/reusables/repositories/action-root-user-required.md
index f38952e06d58..9c6226b711db 100644
--- a/translations/pt-BR/data/reusables/repositories/action-root-user-required.md
+++ b/translations/pt-BR/data/reusables/repositories/action-root-user-required.md
@@ -1 +1 @@
-**Note:** {% data variables.product.prodname_actions %} must be run by the default Docker user (root). Ensure your Dockerfile does not set the `USER` instruction, otherwise you will not be able to access `GITHUB_WORKSPACE`.
+**Observação:** {% data variables.product.prodname_actions %} deve ser executado pelo usuário do Docker padrão (raiz). Certifique-se de seu arquivo do Dockerfile não defina a instrução `USUÁRIO`. Caso contrário, você não conseguirá acessar `GITHUB_WORKSPACE`.
diff --git a/translations/pt-BR/data/reusables/repositories/actions-env-var-note.md b/translations/pt-BR/data/reusables/repositories/actions-env-var-note.md
index 26908e34ddcd..3d0712728deb 100644
--- a/translations/pt-BR/data/reusables/repositories/actions-env-var-note.md
+++ b/translations/pt-BR/data/reusables/repositories/actions-env-var-note.md
@@ -1 +1 @@
-When more than one environment variable is defined with the same name, {% data variables.product.prodname_dotcom %} uses the most specific environment variable. For example, an environment variable defined in a step will override job and workflow variables with the same name, while the step executes. A variable defined for a job will override a workflow variable with the same name, while the job executes.
+Quando mais de uma variável de ambiente é definida com o mesmo nome, {% data variables.product.prodname_dotcom %} usa a variável de ambiente mais específica. Por exemplo, uma variável de ambiente definida em uma etapa substituirá variáveis de trabalho e de fluxo de trabalho pelo mesmo nome enquanto a etapa é executada. Uma variável definida para um trabalho substituirá uma variável de fluxo de trabalho com o mesmo nome, enquanto o trabalho é executado.
diff --git a/translations/pt-BR/data/reusables/repositories/actions-matrix-builds-os.md b/translations/pt-BR/data/reusables/repositories/actions-matrix-builds-os.md
index 228b240dafb1..a6833056f573 100644
--- a/translations/pt-BR/data/reusables/repositories/actions-matrix-builds-os.md
+++ b/translations/pt-BR/data/reusables/repositories/actions-matrix-builds-os.md
@@ -1 +1 @@
-When you define a matrix of operating systems, you must set the value of `runs-on` to the `matrix.os` context property you defined.
+Ao definir uma matriz de sistemas operacionais, você deve definir o valor de `runs-on` para a propriedade de contexto de `matrix.os` que você definiu.
diff --git a/translations/pt-BR/data/reusables/repositories/actions-scheduled-workflow-example.md b/translations/pt-BR/data/reusables/repositories/actions-scheduled-workflow-example.md
index 55ddeea89331..701c88e76fc5 100644
--- a/translations/pt-BR/data/reusables/repositories/actions-scheduled-workflow-example.md
+++ b/translations/pt-BR/data/reusables/repositories/actions-scheduled-workflow-example.md
@@ -1,6 +1,6 @@
-You can schedule a workflow to run at specific UTC times using [POSIX cron syntax](https://pubs.opengroup.org/onlinepubs/9699919799/utilities/crontab.html#tag_20_25_07). Scheduled workflows run on the latest commit on the default or base branch. O intervalo mais curto que você pode executar fluxos de trabalho programados é uma vez a cada 5 minutos.
+É possível programar um fluxo de trabalho para ser executado em horários de UTC específicos usando a [sintaxe de cron POSIX](https://pubs.opengroup.org/onlinepubs/9699919799/utilities/crontab.html#tag_20_25_07). Fluxos de trabalho agendados executados no último commit no branch padrão ou branch de base. O intervalo mais curto que você pode executar fluxos de trabalho programados é uma vez a cada 5 minutos.
 
-This example triggers the workflow every 15 minutes:
+Este exemplo aciona o fluxo de trabalho a cada 15 minutos:
 
 ```yaml
 on:
diff --git a/translations/pt-BR/data/reusables/repositories/actions-tab.md b/translations/pt-BR/data/reusables/repositories/actions-tab.md
index a4d4fa3c6d56..d70ee6b5979b 100644
--- a/translations/pt-BR/data/reusables/repositories/actions-tab.md
+++ b/translations/pt-BR/data/reusables/repositories/actions-tab.md
@@ -1 +1 @@
-1. Under your repository name, click **Actions**. ![Actions tab in the main repository navigation](/assets/images/help/repository/actions-tab.png)
+1. No nome do seu repositório, clique em **Ações**. ![Aba Ações na navegação principal do repositório](/assets/images/help/repository/actions-tab.png)
diff --git a/translations/pt-BR/data/reusables/repositories/actions-workflow-status-badge-into.md b/translations/pt-BR/data/reusables/repositories/actions-workflow-status-badge-into.md
index cfaa51ac6d5c..4447a4adeb3a 100644
--- a/translations/pt-BR/data/reusables/repositories/actions-workflow-status-badge-into.md
+++ b/translations/pt-BR/data/reusables/repositories/actions-workflow-status-badge-into.md
@@ -1,3 +1,3 @@
-Status badges show whether a workflow is currently failing or passing. A common place to add a status badge is in the README.md file of your repository, but you can add it to any web page you'd like. By default, badges display the status of your default branch. You can also display the status of a workflow run for a specific branch or event using the `branch` and `event` query parameters in the URL.
+Um selo de status mostra se um fluxo de trabalho está falhando ou passando. Um lugar comum para adicionar um selo de status é o arquivo README.md do seu repositório, mas você pode adicioná-lo a qualquer página web que desejar. Por padrão, os selos exibem o status do seu branch-padrão. Também é possível exibir o status de uma execução de fluxo de trabalho para um branch ou evento específico usando os parâmetros de consulta do `branch` e `evento` na URL.
 
-![example status badge](/assets/images/help/repository/actions-workflow-status-badge.png)
+![exemplo de selo de status](/assets/images/help/repository/actions-workflow-status-badge.png)
diff --git a/translations/pt-BR/data/reusables/repositories/add-branch-protection-rules.md b/translations/pt-BR/data/reusables/repositories/add-branch-protection-rules.md
index 3ea09695ac21..15747c54b080 100644
--- a/translations/pt-BR/data/reusables/repositories/add-branch-protection-rules.md
+++ b/translations/pt-BR/data/reusables/repositories/add-branch-protection-rules.md
@@ -1,2 +1,2 @@
-4. Next to "Branch protection rules", click **Add rule.** ![Add branch protection rule button](/assets/images/help/branches/add-branch-protection-rule.png)
-5. Under "Branch name pattern", type the branch name or pattern you want to protect. ![Branch rule field ](/assets/images/help/branches/specify-branch-protection-rule.png)
+4. Ao lado de "Regras de proteção do branch", clique **Adicionar regra.** ![Botão de adicionar regra de proteção do branch](/assets/images/help/branches/add-branch-protection-rule.png)
+5. Em "Padrão do nome do branch", digite o nome de branch ou padrão que você deseja proteger. ![Campo regra do branch ](/assets/images/help/branches/specify-branch-protection-rule.png)
diff --git a/translations/pt-BR/data/reusables/repositories/allow-maintainers-user-forks.md b/translations/pt-BR/data/reusables/repositories/allow-maintainers-user-forks.md
index bd43a212c02f..af0db5a98012 100644
--- a/translations/pt-BR/data/reusables/repositories/allow-maintainers-user-forks.md
+++ b/translations/pt-BR/data/reusables/repositories/allow-maintainers-user-forks.md
@@ -1,7 +1,7 @@
-1. On user-owned forks, if you do not want to allow anyone with push access to the upstream repository to make changes to your pull request, unselect **Allow edits from maintainers**.
+1. Na bifurcação pertencente a usuários, se você não desejar permitir que qualquer pessoa com acesso push ao repositório upstream faça alterações no seu pull request, desmarque **Permitir edições de mantenedores**.
 
     {% warning %}
 
-    **Warning:** If your fork contains {% data variables.product.prodname_actions %} workflows, the option is  **Allow edits and access to secrets by maintainers**. Allowing edits on a fork's branch that contains {% data variables.product.prodname_actions %} workflows also allows a maintainer to edit the forked repository's workflows, which can potentially reveal values of secrets and grant access to other branches.
+    **Aviso:** Se a sua bifurcação contiver fluxos de trabalho {% data variables.product.prodname_actions %}, a opção será **Permitir edições e acesso a segredos por parte dos mantenedores**. Permitir edições no branch de uma bifurcação que contém fluxos de trabalho do {% data variables.product.prodname_actions %} também permite que um mantenedor edite os fluxos de trabalho do repositório bifurcado, o que pode potencialmente revelar valores de segredos e conceder acesso a outros branches.
 
     {% endwarning %}
diff --git a/translations/pt-BR/data/reusables/repositories/asking-for-review.md b/translations/pt-BR/data/reusables/repositories/asking-for-review.md
index dedaa2ecd09d..78a0dedf5b79 100644
--- a/translations/pt-BR/data/reusables/repositories/asking-for-review.md
+++ b/translations/pt-BR/data/reusables/repositories/asking-for-review.md
@@ -1,5 +1,5 @@
 {% tip %}
 
-**Tip:** After you create a pull request, you can ask a specific person to [review your proposed changes](/articles/reviewing-proposed-changes-in-a-pull-request). Para obter mais informações, consulte "[Solicitar uma revisão de pull request](/articles/requesting-a-pull-request-review)".
+**Dica:** Após criar uma solicitação de pull request, é possível pedir para uma pessoa específica [revisar as alterações propostas](/articles/reviewing-proposed-changes-in-a-pull-request). Para obter mais informações, consulte "[Solicitar uma revisão de pull request](/articles/requesting-a-pull-request-review)".
 
 {% endtip %}
diff --git a/translations/pt-BR/data/reusables/repositories/assign-an-issue-as-project-maintainer.md b/translations/pt-BR/data/reusables/repositories/assign-an-issue-as-project-maintainer.md
index 0a12bf4d7965..221d00e44a48 100644
--- a/translations/pt-BR/data/reusables/repositories/assign-an-issue-as-project-maintainer.md
+++ b/translations/pt-BR/data/reusables/repositories/assign-an-issue-as-project-maintainer.md
@@ -1 +1 @@
-1. If you're a project maintainer, you can [assign the issue to someone](/articles/assigning-issues-and-pull-requests-to-other-github-users), [add it to a project board](/articles/adding-issues-and-pull-requests-to-a-project-board/#adding-issues-and-pull-requests-to-a-project-board-from-the-sidebar), [associate it with a milestone](/articles/associating-milestones-with-issues-and-pull-requests), or [apply a label](/articles/applying-labels-to-issues-and-pull-requests).
+1. Se você é um mantenedor do projeto, você pode [atribuir o problema a alguém](/articles/assigning-issues-and-pull-requests-to-other-github-users), [adicioná-lo a um quadro de projeto](/articles/adding-issues-and-pull-requests-to-a-project-board/#adding-issues-and-pull-requests-to-a-project-board-from-the-sidebar), [associá-lo a um marco](/articles/associating-milestones-with-issues-and-pull-requests) ou [aplicar uma etiqueta](/articles/applying-labels-to-issues-and-pull-requests).
diff --git a/translations/pt-BR/data/reusables/repositories/autolink-references.md b/translations/pt-BR/data/reusables/repositories/autolink-references.md
index 70c67c9b2983..c3287e67d2a1 100644
--- a/translations/pt-BR/data/reusables/repositories/autolink-references.md
+++ b/translations/pt-BR/data/reusables/repositories/autolink-references.md
@@ -1 +1 @@
-If custom autolink references are configured for a repository, then references to external resources, like a JIRA issue or Zendesk ticket, convert into shortened links. To know which autolinks are available in your repository, contact someone with admin permissions to the repository. For more information, see "[Configuring autolinks to reference external resources](/articles/configuring-autolinks-to-reference-external-resources)."
+Se as referências de link automático personalizado estão configuradas para um repositório, referências a recursos externos, como um problema do JIRA ou um ticket do Zendesk, serão convertidas em links encurtados. Para saber quais links automáticos estão disponíveis no repositório, entre em contato com alguém com permissões de administrador no repositório. Para obter mais informações, consulte "[Configurar links automáticos para fazer referência a recursos externos](/articles/configuring-autolinks-to-reference-external-resources)".
diff --git a/translations/pt-BR/data/reusables/repositories/blocked-passwords.md b/translations/pt-BR/data/reusables/repositories/blocked-passwords.md
index ca8a2fe11312..258821aee884 100644
--- a/translations/pt-BR/data/reusables/repositories/blocked-passwords.md
+++ b/translations/pt-BR/data/reusables/repositories/blocked-passwords.md
@@ -1,5 +1,6 @@
 {% if currentVersion == "free-pro-team@latest" %}
-When you type a password to sign in, create an account, or change your password, {% data variables.product.product_name %} will check if the password you entered is considered weak according to datasets like HaveIBeenPwned. The password may be identified as weak even if you have never used that password before.
+Ao digitar uma senha para efetuar o login, criar uma conta ou mudar sua senha
+{% data variables.product.product_name %} irá verificar se a senha inserida é considerada fraca de acordo com os conjuntos de dados como o HaveIBeenPwted. A senha pode ser identificada como fraca, mesmo que você nunca tenha usado essa senha antes.
 
-{% data variables.product.product_name %} only inspects the password at the time you type it, and never stores the password you entered in plaintext. For more information, see [HaveIBeenPwned](https://haveibeenpwned.com/).
+O {% data variables.product.product_name %} inspeciona a senha apenas no momento em que você a digita e nunca armazena a senha que você digitou em um texto simples. Para obter mais informações, consulte [HaveIBeenPwned](https://haveibeenpwned.com/).
 {% endif %}
diff --git a/translations/pt-BR/data/reusables/repositories/branch-rules-example.md b/translations/pt-BR/data/reusables/repositories/branch-rules-example.md
index b9cd9572f023..9cadc0abab38 100644
--- a/translations/pt-BR/data/reusables/repositories/branch-rules-example.md
+++ b/translations/pt-BR/data/reusables/repositories/branch-rules-example.md
@@ -1 +1 @@
-You can create a branch rule in a repository for a specific branch, all branches, or any branch that matches a naming pattern specified with the fnmatch syntax. For example, to require any branch containing the word `release` to have at least two pull request reviews before merging, you can create a branch rule for `*release*`.
+Você pode criar uma regra de branch em um repositório para um branch específico, todos os branches, ou qualquer branch que corresponda a um padrão de nomenclatura especificado com a sintaxe fnmatch. Por exemplo, para exigir que qualquer branch que contenha a palavra `versão` tenha pelo menos duas revisões de pull request antes do merge, você pode criar uma regra de branch para `*versão*`.
diff --git a/translations/pt-BR/data/reusables/repositories/changed-files.md b/translations/pt-BR/data/reusables/repositories/changed-files.md
index e950561ea2a8..e6ff26ebe968 100644
--- a/translations/pt-BR/data/reusables/repositories/changed-files.md
+++ b/translations/pt-BR/data/reusables/repositories/changed-files.md
@@ -1 +1 @@
-1. On the pull request, click {% octicon "diff" aria-label="The file diff icon" %} **Files changed**. ![Files Changed tab](/assets/images/help/pull_requests/pull-request-tabs-changed-files.png)
+1. No pedido de pull request, clique em {% octicon "diff" aria-label="The file diff icon" %} **Arquivos alterados**. ![Aba de Arquivos Alterados](/assets/images/help/pull_requests/pull-request-tabs-changed-files.png)
diff --git a/translations/pt-BR/data/reusables/repositories/choose-line-or-range.md b/translations/pt-BR/data/reusables/repositories/choose-line-or-range.md
index d33ab6f6119d..7907e8143659 100644
--- a/translations/pt-BR/data/reusables/repositories/choose-line-or-range.md
+++ b/translations/pt-BR/data/reusables/repositories/choose-line-or-range.md
@@ -1,3 +1,3 @@
-1. Choose whether to select a single line or a range:
-    - To select a single line of code, click the line number to highlight the line. ![File with a single line of code selected](/assets/images/help/repository/highlight-line-of-code.png)
-      - To select a range of code, click the number of the first line in the range to highlight the line of code. Then, hover over the last line of the code range, press Shift, and click the line number to highlight the range. ![File with a range of code selected](/assets/images/help/repository/highlight-range-of-code.png)
+1. Escolha se deseja selecionar uma única linha ou um intervalo:
+    - Para selecionar uma única linha de código, clique no número de linha para destacá-la. ![Arquivo com uma única linha de código selecionado](/assets/images/help/repository/highlight-line-of-code.png)
+      - Para selecionar um intervalo de código, clique no número da primeira linha no intervalo para destacar a linha de código. Em seguida, passe o mouse sobre a última linha do intervalo de código, pressione Shift e clique no número de linha para destacar o intervalo. ![Arquivo com um intervalo de código selecionado](/assets/images/help/repository/highlight-range-of-code.png)
diff --git a/translations/pt-BR/data/reusables/repositories/choose-repo-visibility.md b/translations/pt-BR/data/reusables/repositories/choose-repo-visibility.md
index b9d81bdd9e43..3748e8c3fb11 100644
--- a/translations/pt-BR/data/reusables/repositories/choose-repo-visibility.md
+++ b/translations/pt-BR/data/reusables/repositories/choose-repo-visibility.md
@@ -1 +1 @@
-1. Choose a repository visibility. Para obter mais informações, consulte "[Sobre a visibilidade do repositório](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)." ![Radio buttons to select repository visibility](/assets/images/help/repository/create-repository-public-private.png)
+1. Escolha uma visibilidade do repositório. Para obter mais informações, consulte "[Sobre a visibilidade do repositório](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)." ![Botões de opção para selecionar a visibilidade do repositório](/assets/images/help/repository/create-repository-public-private.png)
diff --git a/translations/pt-BR/data/reusables/repositories/click-dependency-graph.md b/translations/pt-BR/data/reusables/repositories/click-dependency-graph.md
index 61411990f73c..1e94a746eeeb 100644
--- a/translations/pt-BR/data/reusables/repositories/click-dependency-graph.md
+++ b/translations/pt-BR/data/reusables/repositories/click-dependency-graph.md
@@ -1 +1 @@
-3. In the left sidebar, click **Dependency graph**. ![Dependency graph tab in the left sidebar](/assets/images/help/graphs/graphs-sidebar-dependency-graph.png)
+3. Na barra lateral esquerda, clique em **gráfico de dependências**. ![Aba do gráfico de dependências na barra lateral esquerda](/assets/images/help/graphs/graphs-sidebar-dependency-graph.png)
diff --git a/translations/pt-BR/data/reusables/repositories/copy-clone-url.md b/translations/pt-BR/data/reusables/repositories/copy-clone-url.md
index 9b86e33434bf..34848bc345fb 100644
--- a/translations/pt-BR/data/reusables/repositories/copy-clone-url.md
+++ b/translations/pt-BR/data/reusables/repositories/copy-clone-url.md
@@ -1,15 +1,15 @@
 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %}
-1. Under the repository name, click **Clone or download**. ![Botão Clone or download (Clonar ou baixar)](/assets/images/help/repository/clone-repo-clone-url-button.png)
-2. To clone the repository using HTTPS, under "Clone with HTTPS", click
+1. No nome do repositório, clique em **Clonar ou fazer download**. ![Botão Clone or download (Clonar ou baixar)](/assets/images/help/repository/clone-repo-clone-url-button.png)
+2. Para clonar o repositório usando HTTPS, em "Clonar com HTTPS", clique em
+{% octicon "clippy" aria-label="The clipboard icon" %}.
+Para clonar o repositório usando uma chave SSH que inclui um certificado emitido pela autoridade certificada de SSH da sua organização clique em **Usar SSH** e, em seguida, clique em
 {% octicon "clippy" aria-label="The clipboard icon" %}.
-To clone the repository using an SSH key
-{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, including a certificate issued by your organization's SSH certificate authority,{% endif %} click **Use SSH**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.
 ![Botão Clone URL (Clonar URL)](/assets/images/help/repository/https-url-clone.png)
 {% else %}
-1. Above the list of files, click {% octicon "download" aria-label="The download icon" %} **Code**. !["Code" button](/assets/images/help/repository/code-button.png)
-1. To clone the repository using HTTPS, under "Clone with HTTPS", click
-{% octicon "clippy" aria-label="The clipboard icon" %}. To clone the repository using an SSH key{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, including a certificate issued by your organization's SSH certificate authority,{% endif %} click **Use SSH**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} To clone a repository using {% data variables.product.prodname_cli %}, click **Use {% data variables.product.prodname_cli %}**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.{% endif %}
-  ![The clipboard icon for copying the URL to clone a repository](/assets/images/help/repository/https-url-clone.png)
+1. Acima da lista de arquivos, clique em {% octicon "download" aria-label="The download icon" %} **código**. ![Botão de "Código"](/assets/images/help/repository/code-button.png)
+1. Para clonar o repositório usando HTTPS, em "Clonar com HTTPS", clique em
+{% octicon "clippy" aria-label="The clipboard icon" %}. Para clonar o repositório usando uma chave SSH, incluindo um certificado emitido pela autoridade certificada de SSH da sua organização clique em **Usar SSH**, e, em seguida, clique em {% octicon "clippy" aria-label="The clipboard icon" %}.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} Para clonar um repositório usando {% data variables.product.prodname_cli %}, clique **Usar {% data variables.product.prodname_cli %}** e, em seguida, clique em {% octicon "clippy" aria-label="The clipboard icon" %}.{% endif %}
+  ![O ícone da área de transferência para copiar a URL para clonar um repositório](/assets/images/help/repository/https-url-clone.png)
   {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}
-  ![The clipboard icon for copying the URL to clone a repository with GitHub CLI](/assets/images/help/repository/https-url-clone-cli.png){% endif %}
+  ![O ícone da área de transferência para copiar a URL para clonar um repositório com o CLI do GitHub](/assets/images/help/repository/https-url-clone-cli.png){% endif %}
 {% endif %}
diff --git a/translations/pt-BR/data/reusables/repositories/create-issue-in-public-repository.md b/translations/pt-BR/data/reusables/repositories/create-issue-in-public-repository.md
index 51930d7d4e8d..ca02a7165a97 100644
--- a/translations/pt-BR/data/reusables/repositories/create-issue-in-public-repository.md
+++ b/translations/pt-BR/data/reusables/repositories/create-issue-in-public-repository.md
@@ -1 +1 @@
-Any {% data variables.product.product_name %} user can create an issue in a public repository where [issues have not been disabled](/articles/disabling-issues).
+Qualquer usuário do {% data variables.product.product_name %} pode criar um problema em um repositório público em que [problemas não foram desativados](/articles/disabling-issues).
diff --git a/translations/pt-BR/data/reusables/repositories/create-pull-request.md b/translations/pt-BR/data/reusables/repositories/create-pull-request.md
index 1709033dd46d..1904b1291595 100644
--- a/translations/pt-BR/data/reusables/repositories/create-pull-request.md
+++ b/translations/pt-BR/data/reusables/repositories/create-pull-request.md
@@ -1 +1 @@
-1. To create a pull request that is ready for review, click **Create Pull Request**. To create a draft pull request, use the drop-down and select **Create Draft Pull Request**, then click **Draft Pull Request**. Para obter mais informações sobre pull requests em rascunho, consulte "[Sobre pull requests](/articles/about-pull-requests#draft-pull-requests)".![Create pull request button](/assets/images/help/pull_requests/pullrequest-send.png)
+1. Para criar um pull request que está pronto para revisão, clique em **Criar Pull Request**. Para criar um rascunho de pull request, use o menu suspenso e selecione **Criar rascunho de pull request** e, em seguida, clique em **Rascunho de Pull Request**. Para obter mais informações sobre pull requests em rascunho, consulte "[Sobre pull requests](/articles/about-pull-requests#draft-pull-requests)".![Botão de Criar pull request](/assets/images/help/pull_requests/pullrequest-send.png)
diff --git a/translations/pt-BR/data/reusables/repositories/create-repo.md b/translations/pt-BR/data/reusables/repositories/create-repo.md
index 7dafb26fcf2d..c49959f70c8a 100644
--- a/translations/pt-BR/data/reusables/repositories/create-repo.md
+++ b/translations/pt-BR/data/reusables/repositories/create-repo.md
@@ -1 +1 @@
-1. Click **Create repository**.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} ![Button to create repository](/assets/images/help/repository/create-repository-button.png){% endif %}
+1. Clique **Criar repositório**.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} ![Button to create repository](/assets/images/help/repository/create-repository-button.png){% endif %}
diff --git a/translations/pt-BR/data/reusables/repositories/create_new.md b/translations/pt-BR/data/reusables/repositories/create_new.md
index da4f510d0fcf..f426718c7768 100644
--- a/translations/pt-BR/data/reusables/repositories/create_new.md
+++ b/translations/pt-BR/data/reusables/repositories/create_new.md
@@ -1 +1 @@
-1. In the upper-right corner of any page, use the {% octicon "plus" aria-label="Plus symbol" %} drop-down menu, and select **New repository**. ![Drop-down with option to create a new repository](/assets/images/help/repository/repo-create.png)
+1. No canto superior direito de qualquer página, use o menu suspenso {% octicon "plus" aria-label="Plus symbol" %} e selecione **Novo repositório**. ![Menu suspenso com a opção de criar um novo repositório](/assets/images/help/repository/repo-create.png)
diff --git a/translations/pt-BR/data/reusables/repositories/default-issue-templates.md b/translations/pt-BR/data/reusables/repositories/default-issue-templates.md
index d02e3aea2d47..f91173bcf7d2 100644
--- a/translations/pt-BR/data/reusables/repositories/default-issue-templates.md
+++ b/translations/pt-BR/data/reusables/repositories/default-issue-templates.md
@@ -1,2 +1,2 @@
-You can create default issue templates{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and a default configuration file for issue templates{% endif %} for your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %}. Para obter mais informações, consulte "[Criando um arquivo padrão de integridade da comunidade](/github/building-a-strong-community/creating-a-default-community-health-file)."
+Você pode criar modelos de problemas padrão{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 9" %} e um arquivo de configuração padrão para os modelos de problema{% endif %} da organização{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 9" %} ou conta de usuário{% endif %}. Para obter mais informações, consulte "[Criando um arquivo padrão de integridade da comunidade](/github/building-a-strong-community/creating-a-default-community-health-file)."
 
diff --git a/translations/pt-BR/data/reusables/repositories/deleted_forks_from_private_repositories_warning.md b/translations/pt-BR/data/reusables/repositories/deleted_forks_from_private_repositories_warning.md
index f6bc0c3cf794..2c2457772d05 100644
--- a/translations/pt-BR/data/reusables/repositories/deleted_forks_from_private_repositories_warning.md
+++ b/translations/pt-BR/data/reusables/repositories/deleted_forks_from_private_repositories_warning.md
@@ -2,10 +2,10 @@
 
 **Aviso:**
 
-- If you remove a person’s access to a private repository, any of their forks of that private repository are deleted. Local clones of the private repository are retained. If a team's access to a private repository is revoked or a team with access to a private repository is deleted, and team members do not have access to the repository through another team, private forks of the repository will be deleted.{% if currentVersion != "free-pro-team@latest" %}
-- When [LDAP Sync is enabled](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap/#enabling-ldap-sync), if you remove a person from a repository, they will lose access but their forks will not be deleted. If the person is added to a team with access to the original organization repository within three months, their access to the forks will be automatically restored on the next sync.{% endif %}
+- Se você remover o acesso de uma pessoa a um repositório privado, todas as suas bifurcações desse repositório privado serão excluídas. Os clones locais do repositório privado são mantidos. Se o acesso de uma equipe a um repositório privado for revogado ou uma equipe com acesso a um repositório privado for excluída, e os integrantes da equipe não tiverem acesso ao repositório por meio de outra equipe, as bifurcações privadas do repositório serão excluídos.{% if currentVersion != "free-pro-team@latest" %}
+- When [LDAP Sync is enabled](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap/#enabling-ldap-sync), if you remove a person from a repository, they will lose access but their forks will not be deleted. Se a pessoa for adicionada a uma equipe com acesso ao repositório original da organização dentro de três meses, seu acesso às bifurcações será automaticamente restaurado na próxima sincronização.{% endif %}
 - Você é responsável por garantir que as pessoas que perderam o acesso a um repositório excluam qualquer informação confidencial ou de propriedade intelectual.
 
-- People with admin permissions to a private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %} repository can disallow forking of that repository, and organization owners can disallow forking of any private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %} repository in an organization. For more information, see "[Managing the forking policy for your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization)" and "[Managing the forking policy for your repository](/github/administering-a-repository/managing-the-forking-policy-for-your-repository)."
+- As pessoas com permissões de administrador em um repositório privado{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 9" %} ou{% endif %} interno podem impedir a bifurcação desse repositório, e os proprietários da organização podem impedir a bifurcação de qualquer repositório privado{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 9" %} ou interno{% endif %} em uma organização. Para mais informações, consulte "[Gerenciar a política de bifurcação da sua organização](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization)" e "[Gerenciar a política de bifurcação do seu repositório](/github/administering-a-repository/managing-the-forking-policy-for-your-repository)".
 
 {% endwarning %}
diff --git a/translations/pt-BR/data/reusables/repositories/deploy-keys.md b/translations/pt-BR/data/reusables/repositories/deploy-keys.md
index ae039b459e33..df63efce6c2f 100644
--- a/translations/pt-BR/data/reusables/repositories/deploy-keys.md
+++ b/translations/pt-BR/data/reusables/repositories/deploy-keys.md
@@ -1 +1 @@
-You can launch projects from a {% data variables.product.product_name %} repository to your server by using a deploy key, which is an SSH key that grants access to a single repository. {% data variables.product.product_name %} attaches the public part of the key directly to your repository instead of a personal user account, and the private part of the key remains on your server. For more information, see "[Delivering deployments](/v3/guides/delivering-deployments/)."
+Você pode iniciar projetos a partir de um repositório de {% data variables.product.product_name %} para o seu servidor usando uma chave de implantação, que é uma chave SSH que concede acesso a um único repositório. {% data variables.product.product_name %} anexa a parte pública da chave diretamente ao repositório em vez de uma conta de usuário pessoal, e a parte privada da chave permanece no seu servidor. Para obter mais informações, consulte "[Entregar implantações](/v3/guides/delivering-deployments/)".
diff --git a/translations/pt-BR/data/reusables/repositories/desktop-fork.md b/translations/pt-BR/data/reusables/repositories/desktop-fork.md
index cf7bb2d54690..c67065114f17 100644
--- a/translations/pt-BR/data/reusables/repositories/desktop-fork.md
+++ b/translations/pt-BR/data/reusables/repositories/desktop-fork.md
@@ -1 +1 @@
-You can use {% data variables.product.prodname_desktop %} to fork a repository. For more information, see “[Cloning and forking repositories from {% data variables.product.prodname_desktop %}](/desktop/contributing-to-projects/cloning-and-forking-repositories-from-github-desktop)."
+Você pode usar {% data variables.product.prodname_desktop %} para bifurcar um repositório. Para obter mais informações, consulte “[Clonagem e bifurcação de repositórios de {% data variables.product.prodname_desktop %}](/desktop/contributing-to-projects/cloning-and-forking-repositories-from-github-desktop)".
diff --git a/translations/pt-BR/data/reusables/repositories/edited-comment-list.md b/translations/pt-BR/data/reusables/repositories/edited-comment-list.md
index d0401a7df2c0..72ca05f52a1a 100644
--- a/translations/pt-BR/data/reusables/repositories/edited-comment-list.md
+++ b/translations/pt-BR/data/reusables/repositories/edited-comment-list.md
@@ -1,9 +1,9 @@
-2. At the top of the comment, click **edited** to open the edit history.
+2. Na parte superior do comentário, clique em **editado** para abrir o histórico de edição.
 
       {% note %}
 
-      **Note:** If you don't see the **edited** option, then the comment doesn't have an edit history.
+      **Nota:** Se você não vir a opção **editado**, significa que o comentário não tem um histórico de edição.
 
       {% endnote %}
 
-3. To view the details of a specific change, select it from the list of edits. ![View edit details for comment](/assets/images/help/repository/choose-comment-edit-to-expand.png)
+3. Para visualizar as informações de uma alteração específica, selecione-as na lista de edições. ![Ver as informações e edição para comentário](/assets/images/help/repository/choose-comment-edit-to-expand.png)
diff --git a/translations/pt-BR/data/reusables/repositories/enable-security-alerts.md b/translations/pt-BR/data/reusables/repositories/enable-security-alerts.md
index 13474249e05c..987463ed215d 100644
--- a/translations/pt-BR/data/reusables/repositories/enable-security-alerts.md
+++ b/translations/pt-BR/data/reusables/repositories/enable-security-alerts.md
@@ -1,4 +1,4 @@
 {% if currentVersion != "free-pro-team@latest" %}
-Your site administrator must enable
-Your site administrator must enable security alerts for vulnerable dependencies for {% data variables.product.product_location_enterprise %} before you can use this feature. For more information, see "[Enabling security alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server)."
+O seu administrador do site deve habilitar
+{% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}alertas de segurança{% endif %} para dependências vulneráveis para {% data variables.product.product_location_enterprise %} antes de você poder usar este recurso. Para obter mais informações, consulte "[Habilitar alertas para dependências vulneráveis em {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server)".
 {% endif %}
diff --git a/translations/pt-BR/data/reusables/repositories/github-reviews-security-advisories.md b/translations/pt-BR/data/reusables/repositories/github-reviews-security-advisories.md
index cb7849c16e3f..7eeba522b582 100644
--- a/translations/pt-BR/data/reusables/repositories/github-reviews-security-advisories.md
+++ b/translations/pt-BR/data/reusables/repositories/github-reviews-security-advisories.md
@@ -1,3 +1,3 @@
-{% data variables.product.prodname_dotcom %} will review each published security advisory, add it to the {% data variables.product.prodname_advisory_database %}, and may use the security advisory to send {% data variables.product.prodname_dependabot_alerts %} to affected repositories. If the security advisory comes from a fork, we'll only send an alert if the fork owns a package, published under a unique name, on a public package registry. This process can take up to 72 hours and {% data variables.product.prodname_dotcom %} may contact you for more information.
+{% data variables.product.prodname_dotcom %} irá revisar cada consultoria de segurança publicada, adicioná-la ao {% data variables.product.prodname_advisory_database %}, e poderá utilizar a consultoria de segurança para enviar {% data variables.product.prodname_dependabot_alerts %} aos repositórios afetados. Se a consultoria de segurança vier de uma bifurcação, só enviaremos um alerta se a bifurcação possuir um pacote, publicado com um nome único, em um registro de pacote público. Este processo pode levar até 72 horas e {% data variables.product.prodname_dotcom %} pode entrar em contato com você para obter mais informações.
 
-For more information about {% data variables.product.prodname_dependabot_alerts %}, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." For more information about {% data variables.product.prodname_advisory_database %}, see "[Browsing security vulnerabilities in the {% data variables.product.prodname_advisory_database %}](/github/managing-security-vulnerabilities/browsing-security-vulnerabilities-in-the-github-advisory-database)."
+Para obter mais informações sobre {% data variables.product.prodname_dependabot_alerts %}, consulte "[Sobre alertas para dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)". Para obter mais informações sobre {% data variables.product.prodname_advisory_database %}, consulte "[Procurar vulnerabilidades de segurança no {% data variables.product.prodname_advisory_database %}](/github/managing-security-vulnerabilities/browsing-security-vulnerabilities-in-the-github-advisory-database).
diff --git a/translations/pt-BR/data/reusables/repositories/github-security-lab.md b/translations/pt-BR/data/reusables/repositories/github-security-lab.md
index d9706940b4e7..33120b19543d 100644
--- a/translations/pt-BR/data/reusables/repositories/github-security-lab.md
+++ b/translations/pt-BR/data/reusables/repositories/github-security-lab.md
@@ -1 +1 @@
-You can also join [{% data variables.product.prodname_security %}]({% data variables.product.prodname_security_link %}) to browse security-related topics and contribute to security tools and projects. 
+Você também pode participar de [{% data variables.product.prodname_security %}]({% data variables.product.prodname_security_link %}) para pesquisar tópicos relacionados a segurança e contribuir com ferramentas e projetos de segurança. 
diff --git a/translations/pt-BR/data/reusables/repositories/include-administrators.md b/translations/pt-BR/data/reusables/repositories/include-administrators.md
index e2c8b5d28cd7..81516681784c 100644
--- a/translations/pt-BR/data/reusables/repositories/include-administrators.md
+++ b/translations/pt-BR/data/reusables/repositories/include-administrators.md
@@ -1 +1 @@
-1. Outra opção é selecionar **Include administrators** (Incluir administradores). This enforces all configured restrictions for repository administrators. ![Caixa de seleção Include administrators (Incluir administradores)](/assets/images/help/repository/include-admins-protected-branches.png)
+1. Outra opção é selecionar **Include administrators** (Incluir administradores). Isto impõe todas as restrições de configuração para os administradores do repositório. ![Caixa de seleção Include administrators (Incluir administradores)](/assets/images/help/repository/include-admins-protected-branches.png)
diff --git a/translations/pt-BR/data/reusables/repositories/internal-repo-default.md b/translations/pt-BR/data/reusables/repositories/internal-repo-default.md
index 8dfd17d8f53e..e3a13bd7bb11 100644
--- a/translations/pt-BR/data/reusables/repositories/internal-repo-default.md
+++ b/translations/pt-BR/data/reusables/repositories/internal-repo-default.md
@@ -1,3 +1,3 @@
 {% if currentVersion == "free-pro-team@latest" %}
-Internal repositories are the default setting for all new repositories created in an organization owned by an enterprise account.
+Os repositórios internos são a configuração-padrão para todos os novos repositórios criados em uma organização pertencente a uma conta corporativa.
 {% endif %}
diff --git a/translations/pt-BR/data/reusables/repositories/issue-template-config.md b/translations/pt-BR/data/reusables/repositories/issue-template-config.md
index c88400f18d4c..d9d887bb5156 100644
--- a/translations/pt-BR/data/reusables/repositories/issue-template-config.md
+++ b/translations/pt-BR/data/reusables/repositories/issue-template-config.md
@@ -1 +1 @@
-You can customize the issue template chooser that people see when creating a new issue in your repository by adding a *config.yml* file to the `.github/ISSUE_TEMPLATE` folder.
+Você pode personalizar o seletor do modelo de problema que as pessoas veem ao criar um novo problema no repositório, adicionando um arquivo *config.yml* à pasta `.github/ISSUE_TEMPLATE`.
diff --git a/translations/pt-BR/data/reusables/repositories/legacy-issue-template-tip.md b/translations/pt-BR/data/reusables/repositories/legacy-issue-template-tip.md
index d914c477ce58..f624cd0d3c42 100644
--- a/translations/pt-BR/data/reusables/repositories/legacy-issue-template-tip.md
+++ b/translations/pt-BR/data/reusables/repositories/legacy-issue-template-tip.md
@@ -1,6 +1,6 @@
 
 {% warning %}
 
-This is the legacy workflow to create an issue template. We recommend using the upgraded multiple issue template builder to create multiple issue templates. Para obter mais informações, consulte "[Sobre modelos de problema e pull request](/articles/about-issue-and-pull-request-templates)".
+Este é o fluxo de trabalho de legado para criar um modelo de problemas. Recomendamos o uso do criador múltiplo de modelos de problemas atualizado para criar vários modelos de problema. Para obter mais informações, consulte "[Sobre modelos de problema e pull request](/articles/about-issue-and-pull-request-templates)".
 
 {% endwarning %}
diff --git a/translations/pt-BR/data/reusables/repositories/list-closed-pull-requests.md b/translations/pt-BR/data/reusables/repositories/list-closed-pull-requests.md
index 2bd8cb6a40f2..1ff468fed45c 100644
--- a/translations/pt-BR/data/reusables/repositories/list-closed-pull-requests.md
+++ b/translations/pt-BR/data/reusables/repositories/list-closed-pull-requests.md
@@ -1 +1 @@
-1. Click **Closed** to see a list of closed pull requests. ![Closed tab](/assets/images/help/branches/branches-closed.png)
+1. Clique em **Fechado** para ver uma lista de pull requests fechados. ![Aba de fechado](/assets/images/help/branches/branches-closed.png)
diff --git a/translations/pt-BR/data/reusables/repositories/merge-all-pulls-together.md b/translations/pt-BR/data/reusables/repositories/merge-all-pulls-together.md
index 65f07ef32680..686f669f44a7 100644
--- a/translations/pt-BR/data/reusables/repositories/merge-all-pulls-together.md
+++ b/translations/pt-BR/data/reusables/repositories/merge-all-pulls-together.md
@@ -1 +1 @@
-You cannot merge individual pull requests in a temporary private fork. Instead, you merge all open pull requests at once, in the corresponding security advisory.
+Você não pode realizar o merge de pull requests individuais em uma bifurcação privada temporária. Em vez disso, você pode fazer merge de todos os pull requests abertos de uma vez, na consultoria de segurança correspondente.
diff --git a/translations/pt-BR/data/reusables/repositories/migrating-from-codeplex.md b/translations/pt-BR/data/reusables/repositories/migrating-from-codeplex.md
index c60ed8e5fd50..634c202eae3e 100644
--- a/translations/pt-BR/data/reusables/repositories/migrating-from-codeplex.md
+++ b/translations/pt-BR/data/reusables/repositories/migrating-from-codeplex.md
@@ -1 +1 @@
-If you are migrating your project from CodePlex, read the [migration guide](https://aka.ms/codeplex-guide) for more information.
+Se você estiver migrando seu projeto do CodePlex, leia o [guia de migração](https://aka.ms/codeplex-guide) para obter mais informações.
diff --git a/translations/pt-BR/data/reusables/repositories/navigate-to-branches.md b/translations/pt-BR/data/reusables/repositories/navigate-to-branches.md
index 1f17017ca5bb..950c8c3e84cf 100644
--- a/translations/pt-BR/data/reusables/repositories/navigate-to-branches.md
+++ b/translations/pt-BR/data/reusables/repositories/navigate-to-branches.md
@@ -1 +1 @@
-1. Above the list of files, click {% octicon "git-branch" aria-label="The branch icon" %} **NUMBER branches**. ![Link de branches numa página de visão geral](/assets/images/help/branches/branches-link.png)
+1. Acima da lista de arquivos, clique em {% octicon "git-branch" aria-label="The branch icon" %} **NÚMERO branches**. ![Link de branches numa página de visão geral](/assets/images/help/branches/branches-link.png)
diff --git a/translations/pt-BR/data/reusables/repositories/navigate-to-job-superlinter.md b/translations/pt-BR/data/reusables/repositories/navigate-to-job-superlinter.md
new file mode 100644
index 000000000000..f550a6922733
--- /dev/null
+++ b/translations/pt-BR/data/reusables/repositories/navigate-to-job-superlinter.md
@@ -0,0 +1,5 @@
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+1. Na barra lateral esquerda, clique no trabalho que você deseja ver. ![Lint do trabalho do código-base](/assets/images/help/repository/superlinter-lint-code-base-job.png)
+{% else %}
+1. Na barra lateral esquerda, clique no trabalho que você deseja ver. ![Selecione um trabalho do fluxo de trabalho](/assets/images/help/repository/workflow-job.png)
+{% endif %}
\ No newline at end of file
diff --git a/translations/pt-BR/data/reusables/repositories/navigate-to-manage-access.md b/translations/pt-BR/data/reusables/repositories/navigate-to-manage-access.md
index b2e078cdc6b8..24d21d54aa5e 100644
--- a/translations/pt-BR/data/reusables/repositories/navigate-to-manage-access.md
+++ b/translations/pt-BR/data/reusables/repositories/navigate-to-manage-access.md
@@ -1 +1 @@
-1. In the left sidebar, click **Manage access**. !["Manage access" tab](/assets/images/help/repository/manage-access-tab.png)
+1. Na barra lateral esquerda, clique em **Gerenciar acesso**. ![aba de "Gerenciar acesso"](/assets/images/help/repository/manage-access-tab.png)
diff --git a/translations/pt-BR/data/reusables/repositories/navigate-to-security-and-analysis.md b/translations/pt-BR/data/reusables/repositories/navigate-to-security-and-analysis.md
index 016842a0e3c1..358bf9535a0e 100644
--- a/translations/pt-BR/data/reusables/repositories/navigate-to-security-and-analysis.md
+++ b/translations/pt-BR/data/reusables/repositories/navigate-to-security-and-analysis.md
@@ -1 +1 @@
-1. Na barra lateral esquerda, clique em **Security & analysis** (Segurança e análise). !["Security & analysis" tab in repository settings](/assets/images/help/repository/security-and-analysis-tab.png)
+1. Na barra lateral esquerda, clique em **Security & analysis** (Segurança e análise). ![aba de "Segurança & análise" nas configurações do repositório](/assets/images/help/repository/security-and-analysis-tab.png)
diff --git a/translations/pt-BR/data/reusables/repositories/navigate-to-workflow-superlinter.md b/translations/pt-BR/data/reusables/repositories/navigate-to-workflow-superlinter.md
new file mode 100644
index 000000000000..0a85ee15ca8e
--- /dev/null
+++ b/translations/pt-BR/data/reusables/repositories/navigate-to-workflow-superlinter.md
@@ -0,0 +1 @@
+1. Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver. ![Lista de fluxo de trabalho na barra lateral esquerda](/assets/images/help/repository/superlinter-workflow-sidebar.png)
\ No newline at end of file
diff --git a/translations/pt-BR/data/reusables/repositories/navigate-to-workflow.md b/translations/pt-BR/data/reusables/repositories/navigate-to-workflow.md
index c7d4d6f3501f..85defd12ea66 100644
--- a/translations/pt-BR/data/reusables/repositories/navigate-to-workflow.md
+++ b/translations/pt-BR/data/reusables/repositories/navigate-to-workflow.md
@@ -1 +1 @@
-1. In the left sidebar, click the workflow you want to see. ![Workflow list in left sidebar](/assets/images/help/repository/workflow-sidebar.png)
+1. Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver. ![Lista de fluxo de trabalho na barra lateral esquerda](/assets/images/help/repository/workflow-sidebar.png)
diff --git a/translations/pt-BR/data/reusables/repositories/new-pull-request.md b/translations/pt-BR/data/reusables/repositories/new-pull-request.md
index 59aa6d504b6c..217a407ff170 100644
--- a/translations/pt-BR/data/reusables/repositories/new-pull-request.md
+++ b/translations/pt-BR/data/reusables/repositories/new-pull-request.md
@@ -1,7 +1,7 @@
 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %}
-1. To the right of the Branch menu, click **New pull request**. !["Pull request" link above list of files](/assets/images/help/pull_requests/pull-request-start-review-button.png)
+1. À direita do menu do Branch, clique em **Novo pull request**. ![link de "pul request" acima da lista de arquivos](/assets/images/help/pull_requests/pull-request-start-review-button.png)
 {% else %}
-1. Above the list of files, click
+1. Acima da lista de arquivos, clique em
 {% octicon "git-pull-request" aria-label="The pull request icon" %} **Pull request**.
-  !["Pull request" link above list of files](/assets/images/help/pull_requests/pull-request-start-review-button.png)
+  ![link de "pul request" acima da lista de arquivos](/assets/images/help/pull_requests/pull-request-start-review-button.png)
 {% endif %}
diff --git a/translations/pt-BR/data/reusables/repositories/open-with-github-desktop.md b/translations/pt-BR/data/reusables/repositories/open-with-github-desktop.md
index 9f77dca0173d..46b6018ae39d 100644
--- a/translations/pt-BR/data/reusables/repositories/open-with-github-desktop.md
+++ b/translations/pt-BR/data/reusables/repositories/open-with-github-desktop.md
@@ -1,9 +1,11 @@
 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %}
 1. No nome do seu repositório, clique em **Clone or download** (Clonar ou baixar). ![Botão Clone or download (Clonar ou baixar)](/assets/images/help/repository/clone-repo-clone-url-button.png)
-1. Clique em **Open in Desktop** (Abrir no Desktop) para clonar o repositório e abra-o no {% data variables.product.prodname_desktop %}. ![Botão Open in Desktop (Abrir no Desktop)](/assets/images/help/desktop/open-in-desktop-button.png)
+1. Clique em **Abrir no Desktop** para clonar o repositório e abra-o no
+{% data variables.product.prodname_desktop %}.
+![Botão Open in Desktop (Abrir no Desktop)](/assets/images/help/desktop/open-in-desktop-button.png)
 {% else %}
-1. Above the list of files, click {% octicon "download" aria-label="The download icon" %} **Code**. !["Code" button](/assets/images/help/repository/code-button.png)
+1. Acima da lista de arquivos, clique em {% octicon "download" aria-label="The download icon" %} **código**. ![Botão de "Código"](/assets/images/help/repository/code-button.png)
 1. Clique em
-{% octicon "desktop-download" aria-label="The GitHub Desktop download icon" %} **Open with {% data variables.product.prodname_desktop %}** to clone and open the repository with {% data variables.product.prodname_desktop %}.
-  !["Open with {% data variables.product.prodname_desktop %}" button](/assets/images/help/repository/open-with-desktop.png)
+{% octicon "desktop-download" aria-label="The GitHub Desktop download icon" %} **Abra com {% data variables.product.prodname_desktop %}** para clonar e abrir o repositório com {% data variables.product.prodname_desktop %}.
+  !["Abrir com o botão {% data variables.product.prodname_desktop %}"](/assets/images/help/repository/open-with-desktop.png)
 {% endif %}
diff --git a/translations/pt-BR/data/reusables/repositories/owner-drop-down.md b/translations/pt-BR/data/reusables/repositories/owner-drop-down.md
index c7aa523a8fc7..568a5ab2139d 100644
--- a/translations/pt-BR/data/reusables/repositories/owner-drop-down.md
+++ b/translations/pt-BR/data/reusables/repositories/owner-drop-down.md
@@ -1 +1 @@
-1. Use the **Owner** drop-down menu, and select the account you want to own the repository. ![Menu suspenso Owner (Proprietário)](/assets/images/help/repository/create-repository-owner.png)
+1. Use o menu suspenso **Proprietário** e selecione a conta que você deseja que seja proprietária do repositório. ![Menu suspenso Owner (Proprietário)](/assets/images/help/repository/create-repository-owner.png)
diff --git a/translations/pt-BR/data/reusables/repositories/permissions-statement-read.md b/translations/pt-BR/data/reusables/repositories/permissions-statement-read.md
index 9e957151da58..e7e882138b69 100644
--- a/translations/pt-BR/data/reusables/repositories/permissions-statement-read.md
+++ b/translations/pt-BR/data/reusables/repositories/permissions-statement-read.md
@@ -1 +1 @@
-People with read access to the repository can perform these steps.
\ No newline at end of file
+É necessário o acesso de leitura ao repositório é para executar essas etapas.
diff --git a/translations/pt-BR/data/reusables/repositories/permissions-statement-write.md b/translations/pt-BR/data/reusables/repositories/permissions-statement-write.md
index 4c6e9310a6af..f08e716d5962 100644
--- a/translations/pt-BR/data/reusables/repositories/permissions-statement-write.md
+++ b/translations/pt-BR/data/reusables/repositories/permissions-statement-write.md
@@ -1 +1 @@
-People with write-level access to the repository can perform these steps.
\ No newline at end of file
+É necessário o acesso de gravação ao repositório é para executar essas etapas.
diff --git a/translations/pt-BR/data/reusables/repositories/pr-title-description.md b/translations/pt-BR/data/reusables/repositories/pr-title-description.md
index 7cd9e727f8ee..06447cf40538 100644
--- a/translations/pt-BR/data/reusables/repositories/pr-title-description.md
+++ b/translations/pt-BR/data/reusables/repositories/pr-title-description.md
@@ -1 +1 @@
-1. Digite um título e uma descrição para a pull request. ![Pull request title and description fields](/assets/images/help/pull_requests/pullrequest-description.png)
+1. Digite um título e uma descrição para a pull request. ![Título do pull request e campos de descrição](/assets/images/help/pull_requests/pullrequest-description.png)
diff --git a/translations/pt-BR/data/reusables/repositories/private_forks_inherit_permissions.md b/translations/pt-BR/data/reusables/repositories/private_forks_inherit_permissions.md
index 21e518fbf01d..5d0272fbbd96 100644
--- a/translations/pt-BR/data/reusables/repositories/private_forks_inherit_permissions.md
+++ b/translations/pt-BR/data/reusables/repositories/private_forks_inherit_permissions.md
@@ -1 +1 @@
-Private forks inherit the permissions structure of the upstream or parent repository. For example, if the upstream repository is private and gives read/write access to a team, then the same team will have read/write access to any forks of the private upstream repository. This helps owners of private repositories maintain control over their code.
+As bifurcações privadas herdam a estrutura de permissões do repositório ascendente ou principal. Por exemplo, se o repositório ascendente é privado e fornece acesso de leitura/gravação a uma equipe, essa equipe terá acesso de leitura/gravação para qualquer bifurcação do repositório privado ascendente. Isso ajuda os proprietários de repositórios privados a manter o controle sobre seus códigos.
diff --git a/translations/pt-BR/data/reusables/repositories/protected-branches-block-web-edits-uploads.md b/translations/pt-BR/data/reusables/repositories/protected-branches-block-web-edits-uploads.md
index f77a28143cad..57149ba1188b 100644
--- a/translations/pt-BR/data/reusables/repositories/protected-branches-block-web-edits-uploads.md
+++ b/translations/pt-BR/data/reusables/repositories/protected-branches-block-web-edits-uploads.md
@@ -1,3 +1,3 @@
-If a repository has any protected branches, you can't edit or upload files in the protected branch using {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte "[Sobre branches protegidos](/articles/about-protected-branches)".
+Se um repositório tiver algum branch protegido, você não poderá editar ou enviar arquivos no branch protegido usando o {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte "[Sobre branches protegidos](/articles/about-protected-branches)".
 
-You can use {% data variables.product.prodname_desktop %} to move your changes to a new branch and commit them. Para obter mais informações, consulte "[Fazer o commit e revisar as alterações no seu projeto](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project)".
+Você pode usar {% data variables.product.prodname_desktop %} para mover suas alterações para um novo branch e fazer commit das mesmas. Para obter mais informações, consulte "[Fazer o commit e revisar as alterações no seu projeto](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project)".
diff --git a/translations/pt-BR/data/reusables/repositories/protected-branches-options.md b/translations/pt-BR/data/reusables/repositories/protected-branches-options.md
index 589113ca9fc0..02a7922c3301 100644
--- a/translations/pt-BR/data/reusables/repositories/protected-branches-options.md
+++ b/translations/pt-BR/data/reusables/repositories/protected-branches-options.md
@@ -1 +1 @@
-You can automatically enforce protected branch settings for some or all branches in your repository. Para obter mais informações, consulte "[Configurar branches protegidos](/github/administering-a-repository/configuring-protected-branches)".
+É possível aplicar as configurações de branch protegido automaticamente para alguns ou todos os branches no repositório. Para obter mais informações, consulte "[Configurar branches protegidos](/github/administering-a-repository/configuring-protected-branches)".
diff --git a/translations/pt-BR/data/reusables/repositories/relative-links.md b/translations/pt-BR/data/reusables/repositories/relative-links.md
index 4d278786bd45..04d1b025e2e3 100644
--- a/translations/pt-BR/data/reusables/repositories/relative-links.md
+++ b/translations/pt-BR/data/reusables/repositories/relative-links.md
@@ -1,11 +1,11 @@
-You can define relative links and image paths in your rendered files to help readers navigate to other files in your repository.
+É possível definir links relativos e caminhos de imagens em seus arquivos representados para ajudar os leitores a acessar outros arquivos no repositório.
 
-A relative link is a link that is relative to the current file. For example, if you have a  README file in root of your repository, and you have another file in _docs/CONTRIBUTING.md_, the relative link to _CONTRIBUTING.md_ in your README might look like this:
+Um link relativo é um link que é relativo ao arquivo atual. Por exemplo, se você tiver um arquivo LEIAME na raiz do seu repositório e tiver outro arquivo em _docs/CONTRIBUTING.md_, o link relativo para _CONTRIBUTING.md_ no seu README pode se parecer com isso:
 
 ```
-[Contribution guidelines for this project](docs/CONTRIBUTING.md)
+[Diretrizes de contribuição para este projeto](docs/CONTRIBUTING.md)
 ```
 
-{% data variables.product.product_name %} will automatically transform your relative link or image path based on whatever branch you're currently on, so that the link or path always works. You can use all relative link operands, such as `./` and `../`.
+{% data variables.product.product_name %} transformará automaticamente o seu link relativo ou caminho da imagem baseado em qualquer branch em que você estiver no momento para que o link ou caminho sempre funcione. Você pode usar todas as operações de links relativos, como `./` e `../`.
 
-Relative links are easier for users who clone your repository. Absolute links may not work in clones of your repository - we recommend using relative links to refer to other files within your repository.
+Os links relativos são mais fáceis para usuários que clonam o seu repositório. Os links absolutos podem não funcionar em clones do seu repositório - recomendamos usar links relativos para referir-se a outros arquivos no seu repositório.
diff --git a/translations/pt-BR/data/reusables/repositories/releases.md b/translations/pt-BR/data/reusables/repositories/releases.md
index 8805fe71add0..51d50e411384 100644
--- a/translations/pt-BR/data/reusables/repositories/releases.md
+++ b/translations/pt-BR/data/reusables/repositories/releases.md
@@ -1,9 +1,9 @@
 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %}
 
-1. Under your repository name, click **Releases**. ![Releases tab](/assets/images/help/releases/release-link.png)
+1. No nome do repositório, clique em **Versões**. ![Aba de versões](/assets/images/help/releases/release-link.png)
 
 {% else %}
 
-1. To the right of the list of files, click **Releases** or **Latest release**. ![Releases section in right-hand sidebar](/assets/images/help/releases/release-link.png)
+1. À direita da lista de arquivos, clique em **Versões** ou **Última versão**. ![Seção de versões na barra lateral direita](/assets/images/help/releases/release-link.png)
 
 {% endif %}
diff --git a/translations/pt-BR/data/reusables/repositories/repo-name.md b/translations/pt-BR/data/reusables/repositories/repo-name.md
index ec058bb7846b..d7659fa29c6c 100644
--- a/translations/pt-BR/data/reusables/repositories/repo-name.md
+++ b/translations/pt-BR/data/reusables/repositories/repo-name.md
@@ -1 +1 @@
-1. Type a name for your repository, and an optional description. ![Campo Create repository (Criar repositório)](/assets/images/help/repository/create-repository-name.png)
+1. Digite um nome para o seu repositório e uma descrição opcional. ![Campo Create repository (Criar repositório)](/assets/images/help/repository/create-repository-name.png)
diff --git a/translations/pt-BR/data/reusables/repositories/repo-size-limit.md b/translations/pt-BR/data/reusables/repositories/repo-size-limit.md
index f0a5be87d60b..67da4ddc3b0a 100644
--- a/translations/pt-BR/data/reusables/repositories/repo-size-limit.md
+++ b/translations/pt-BR/data/reusables/repositories/repo-size-limit.md
@@ -1,3 +1,3 @@
 {% if currentVersion == "free-pro-team@latest" %}
-Repositories and individual files are subject to size limits. Para obter mais informações, consulte "[Qual é a minha quota de disco?](/articles/what-is-my-disk-quota)"
+Os repositórios e os arquivos individuais estão sujeitos a limites de tamanho. Para obter mais informações, consulte "[Qual é a minha quota de disco?](/articles/what-is-my-disk-quota)"
 {% endif %}
diff --git a/translations/pt-BR/data/reusables/repositories/reported-content-resolved-tab.md b/translations/pt-BR/data/reusables/repositories/reported-content-resolved-tab.md
index b323fd79bac4..c04510413266 100644
--- a/translations/pt-BR/data/reusables/repositories/reported-content-resolved-tab.md
+++ b/translations/pt-BR/data/reusables/repositories/reported-content-resolved-tab.md
@@ -1 +1 @@
-1. Under "Abuse reports", click **Resolved**. !["Resolved" tab under "Abuse reports"](/assets/images/help/repository/reported-content-resolved-tab.png)
+1. Em "Relatórios de abuso", clique em **Resolvido**. ![Aba "Resolvido" em "Relatórios de abuso"](/assets/images/help/repository/reported-content-resolved-tab.png)
diff --git a/translations/pt-BR/data/reusables/repositories/repository-branches.md b/translations/pt-BR/data/reusables/repositories/repository-branches.md
index 20297d87339e..2f51bbc3d15f 100644
--- a/translations/pt-BR/data/reusables/repositories/repository-branches.md
+++ b/translations/pt-BR/data/reusables/repositories/repository-branches.md
@@ -1 +1 @@
-1. In the left menu, click **Branches**. ![Repository options sub-menu](/assets/images/help/repository/repository-options-branch.png)
+1. No menu à esquerda, clique em **Branches**. ![Submenu de opções do repositório](/assets/images/help/repository/repository-options-branch.png)
diff --git a/translations/pt-BR/data/reusables/repositories/request-changes-tips.md b/translations/pt-BR/data/reusables/repositories/request-changes-tips.md
index 3246409939b9..9f797a846cc9 100644
--- a/translations/pt-BR/data/reusables/repositories/request-changes-tips.md
+++ b/translations/pt-BR/data/reusables/repositories/request-changes-tips.md
@@ -1,9 +1,9 @@
 {% tip %}
 
 **Dicas**:
-- If required reviews are enabled and a collaborator with _write_, _admin_, or _owner_ access to the repository submits a review requesting changes, the pull request cannot be merged until the same collaborator submits another review approving the changes in the pull request.
-- Repository owners and administrators can merge a pull request even if it hasn't received an approving review, or if a reviewer who requested changes has left the organization or is unavailable.
-- If both required reviews and stale review dismissal are enabled and a code-modifying commit is pushed to the branch of an approved pull request, the approval is dismissed. The pull request must be reviewed and approved again before it can be merged.
-- When several open pull requests each have a head branch pointing to the same commit, you won’t be able to merge them if one or both have a pending or rejected review.
+- Se as revisões necessárias estiverem habilitadas e um colaborador com acesso de _gravação_, _admin_ ou _proprietário_ ao repositório enviar uma revisão solicitando alterações, o pull request não poderá ser mesclado até que o mesmo colaborador envie outra revisão aprovando as alterações no pull request.
+- Proprietários e administradores do repositório podem fazer merge de um pull request mesmo que não tenham recebido uma revisão de aprovação; ou se um revisor que solicitou alterações saiu da organização ou estiver indisponível.
+- Se as revisões necessárias e o descarte de uma revisão obsoleta estiverem habilitados e um commit de modificação de código for enviado para o branch de um pull request aprovado, a aprovação será ignorada. O pull request deve ser revisado e aprovado novamente antes de poder ser mesclado.
+- Quando vários pull requests abertos têm um branch principal que aponta para o mesmo commit, você não conseguirá mesclá-los se um ou ambos tiverem uma revisão pendente ou rejeitada.
 
 {% endtip %}
diff --git a/translations/pt-BR/data/reusables/repositories/request-security-advisory-cve-id.md b/translations/pt-BR/data/reusables/repositories/request-security-advisory-cve-id.md
index 6d43bedd1cf0..b45481ee9d1f 100644
--- a/translations/pt-BR/data/reusables/repositories/request-security-advisory-cve-id.md
+++ b/translations/pt-BR/data/reusables/repositories/request-security-advisory-cve-id.md
@@ -1 +1 @@
-If you don't already have a CVE identification number for the security vulnerability in your project, you can request a CVE identification number from {% data variables.product.prodname_dotcom %}. {% data variables.product.prodname_dotcom %} usually reviews the request within 72 hours. Requesting a CVE identification number doesn't make your security advisory public. If your security advisory is eligible for a CVE,  {% data variables.product.prodname_dotcom %} will reserve a CVE identification number for your advisory. We'll then publish the CVE details after you publish the security advisory.
+Se você ainda não tem um número de identificação CVE para a vulnerabilidade de segurança no seu projeto, você pode solicitar um número de identificação CVE a partir de {% data variables.product.prodname_dotcom %}. {% data variables.product.prodname_dotcom %} geralmente revisa o pedido em 72 horas. Solicitar um número de identificação CVE não torna público a sua consultoria de segurança público. Se a sua consultoria de segurança for elegível para um CVE, {% data variables.product.prodname_dotcom %} reservará um número de identificação CVE para sua consultoria. Posteriormente, publicaremos os dados do CVE após publicar a consultoria de segurança.
diff --git a/translations/pt-BR/data/reusables/repositories/required-status-merge-tip.md b/translations/pt-BR/data/reusables/repositories/required-status-merge-tip.md
index b101fce97dfd..cecb4548e4e7 100644
--- a/translations/pt-BR/data/reusables/repositories/required-status-merge-tip.md
+++ b/translations/pt-BR/data/reusables/repositories/required-status-merge-tip.md
@@ -1,5 +1,5 @@
 {% tip %}
 
-**Tip:** To successfully merge a pull request into a base branch that has required status checks enabled, the pull request's head branch must be up-to-date with the base branch.
+**Dica:** Para fazer o merge com sucesso de um pull request em um branch-base que tem as verificações de status obrigatório habilitadas, o branch principal do pull request deve estar atualizado com o branch-base.
 
 {% endtip %}
diff --git a/translations/pt-BR/data/reusables/repositories/review-changes.md b/translations/pt-BR/data/reusables/repositories/review-changes.md
index d8990052174e..5bb0831b0c17 100644
--- a/translations/pt-BR/data/reusables/repositories/review-changes.md
+++ b/translations/pt-BR/data/reusables/repositories/review-changes.md
@@ -1 +1 @@
-1. Above the changed code, click **Review changes**. ![Review changes button](/assets/images/help/pull_requests/review-changes-button.png)
+1. Acima do código alterado, clique em **Revisar alterações**. ![Botão de revisar alterações](/assets/images/help/pull_requests/review-changes-button.png)
diff --git a/translations/pt-BR/data/reusables/repositories/review-policy-overlapping-commits.md b/translations/pt-BR/data/reusables/repositories/review-policy-overlapping-commits.md
index d5fba7504a1a..b7c5860f68ab 100644
--- a/translations/pt-BR/data/reusables/repositories/review-policy-overlapping-commits.md
+++ b/translations/pt-BR/data/reusables/repositories/review-policy-overlapping-commits.md
@@ -1 +1 @@
-After all required reviewers have approved a pull request, you won't be able to merge it if there are other open pull requests with pending or rejected reviews and those pull requests have a head branch pointing to the same commit. Someone with *write* or *admin* permissions will need to approve or dismiss the blocking review on the other pull requests before you can merge.
+Depois que todos os revisores necessários tiverem aprovado um pull request, você não conseguirá fazer o merge se houver outros pull requests abertos com revisões pendentes ou rejeitadas e esses pull requests tiverem um branch principal apontando para o mesmo commit. Alguém com as permissões de *gravação* ou *admin* deverá aprovar ou ignorar a revisão de bloqueio nos outros pull requests antes que você possa fazer o merge.
diff --git a/translations/pt-BR/data/reusables/repositories/review-pr-commits.md b/translations/pt-BR/data/reusables/repositories/review-pr-commits.md
index 0064684b75b0..49fa789ea7e0 100644
--- a/translations/pt-BR/data/reusables/repositories/review-pr-commits.md
+++ b/translations/pt-BR/data/reusables/repositories/review-pr-commits.md
@@ -1 +1 @@
-1. On the pull request, click {% octicon "git-commit" aria-label="The commit icon" %} **Commits**. ![Commits tab on a pull request](/assets/images/help/pull_requests/pull-request-tabs-commits.png)
+1. No pull request, clique em {% octicon "git-commit" aria-label="The commit icon" %} **Commits**. ![Aba de Commits em um pull request](/assets/images/help/pull_requests/pull-request-tabs-commits.png)
diff --git a/translations/pt-BR/data/reusables/repositories/review-summary-comment.md b/translations/pt-BR/data/reusables/repositories/review-summary-comment.md
index 1061cb7cf2c0..5d348a04015a 100644
--- a/translations/pt-BR/data/reusables/repositories/review-summary-comment.md
+++ b/translations/pt-BR/data/reusables/repositories/review-summary-comment.md
@@ -1 +1 @@
-1. Type a comment summarizing your feedback on the proposed changes. ![Review summary comment window](/assets/images/help/pull_requests/review-summary-comment-window.png)
+1. Digite um comentário que resume o seu feedback sobre as alterações propostas. ![Janela de comentários para o resumo da revisão](/assets/images/help/pull_requests/review-summary-comment-window.png)
diff --git a/translations/pt-BR/data/reusables/repositories/section-links.md b/translations/pt-BR/data/reusables/repositories/section-links.md
index cd098a00d589..2ed662658f40 100644
--- a/translations/pt-BR/data/reusables/repositories/section-links.md
+++ b/translations/pt-BR/data/reusables/repositories/section-links.md
@@ -1,3 +1,3 @@
-You can link directly to a section in a rendered file by hovering over the section heading to expose the link:
+Você pode vincular diretamente a uma seção de um arquivo interpretado, passando o mouse sobre o título da seção para expor o link:
 
-![Section link within the README file for the github/scientist repository](/assets/images/help/repository/readme-links.png)
+![Link da seção no arquivo LEIAME para o repositório github/scientist](/assets/images/help/repository/readme-links.png)
diff --git a/translations/pt-BR/data/reusables/repositories/security-advisories-republishing.md b/translations/pt-BR/data/reusables/repositories/security-advisories-republishing.md
index a461140c2533..ebf159b8c15e 100644
--- a/translations/pt-BR/data/reusables/repositories/security-advisories-republishing.md
+++ b/translations/pt-BR/data/reusables/repositories/security-advisories-republishing.md
@@ -1 +1 @@
-You can also use {% data variables.product.prodname_security_advisories %} to republish the details of a security vulnerability that you have already disclosed elsewhere by copying and pasting the details of the vulnerability into a new security advisory.
+Você também pode usar {% data variables.product.prodname_security_advisories %} para republicar as informações de uma vulnerabilidade de segurança que você já revelou em outro lugar, copiando e colando as informações de vulnerabilidade em uma nova consultoria de segurança.
diff --git a/translations/pt-BR/data/reusables/repositories/security-advisory-admin-permissions.md b/translations/pt-BR/data/reusables/repositories/security-advisory-admin-permissions.md
index c15cee2d9cc8..a0dcccc28cfd 100644
--- a/translations/pt-BR/data/reusables/repositories/security-advisory-admin-permissions.md
+++ b/translations/pt-BR/data/reusables/repositories/security-advisory-admin-permissions.md
@@ -1,3 +1,3 @@
 Qualquer pessoa com permissões de administrador em um repositório pode criar uma consultoria de segurança.
 
-Anyone with admin permissions to a repository also has admin permissions to all security advisories in that repository. People with admin permissions to a security advisory can add collaborators, and collaborators have write permissions to the security advisory.
+Qualquer pessoa com permissões de administrador para um repositório também tem permissões de administrador para todas as consultorias de segurança nesse repositório. Pessoas com permissões de administrador para uma consultoria de segurança podem adicionar colaboradores, e os colaboradores têm permissões de gravação para a consultoria de segurança.
diff --git a/translations/pt-BR/data/reusables/repositories/security-advisory-collaborators-public-repositories.md b/translations/pt-BR/data/reusables/repositories/security-advisory-collaborators-public-repositories.md
index fd909540bf2f..e28dd5396ea9 100644
--- a/translations/pt-BR/data/reusables/repositories/security-advisory-collaborators-public-repositories.md
+++ b/translations/pt-BR/data/reusables/repositories/security-advisory-collaborators-public-repositories.md
@@ -1 +1 @@
-If you remove a user from a repository or organization and the user is also a collaborator on a security advisory, the user will still have access to the security advisory.
+Se você remover um usuário de um repositório ou organização e o usuário também for colaborador em uma consultoria de segurança, o usuário ainda terá acesso à consultoria de segurança.
diff --git a/translations/pt-BR/data/reusables/repositories/security-advisory-edit-description.md b/translations/pt-BR/data/reusables/repositories/security-advisory-edit-description.md
index b7a26e9c602d..cb81a1e1078f 100644
--- a/translations/pt-BR/data/reusables/repositories/security-advisory-edit-description.md
+++ b/translations/pt-BR/data/reusables/repositories/security-advisory-edit-description.md
@@ -1 +1 @@
-1. Digite a descrição da vulnerabilidade de segurança. ![Security advisory vulnerability description](/assets/images/help/security/security-advisory-description.png)
+1. Digite a descrição da vulnerabilidade de segurança. ![Descrição da vulnerabilidade na consultoria de segurança](/assets/images/help/security/security-advisory-description.png)
diff --git a/translations/pt-BR/data/reusables/repositories/security-advisory-edit-details.md b/translations/pt-BR/data/reusables/repositories/security-advisory-edit-details.md
index 6685ee22ca60..0ce087d54d4f 100644
--- a/translations/pt-BR/data/reusables/repositories/security-advisory-edit-details.md
+++ b/translations/pt-BR/data/reusables/repositories/security-advisory-edit-details.md
@@ -1 +1 @@
-1. Type the details about the security vulnerability that the security advisory addresses. ![Security advisory metadata](/assets/images/help/security/security-advisory-metadata.png)
+1. Digite as informações sobre a vulnerabilidade de segurança tratados pela consultoria de segurança. ![Metadados da consultoria de segurança](/assets/images/help/security/security-advisory-metadata.png)
diff --git a/translations/pt-BR/data/reusables/repositories/security-alert-delivery-options.md b/translations/pt-BR/data/reusables/repositories/security-alert-delivery-options.md
index f3af94f12985..a570ff677b58 100644
--- a/translations/pt-BR/data/reusables/repositories/security-alert-delivery-options.md
+++ b/translations/pt-BR/data/reusables/repositories/security-alert-delivery-options.md
@@ -1 +1 @@
-If your repository has a supported dependency manifest{% if currentVersion == "free-pro-team@latest" %} (and if you've set up the dependency graph if it's a private repository){% endif %}, whenever {% data variables.product.product_name %} detects a vulnerable dependency in your repository, you will receive a weekly digest email. You can also configure your security alerts as web notifications, individual email notifications, daily email digests, or alerts in the {% data variables.product.product_name %} interface. Para obter mais informações, consulte "[Sobre alertas para dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)"
+Se o seu repositório tiver um manifesto de dependência suportado{% if currentVersion == "free-pro-team@latest" %} (e se você tiver configurado o gráfico de dependências se for um repositório privado){% endif %}, sempre que {% data variables.product.product_name %} detectar uma dependência vulnerável no repositório, você receberá um e-mail com o resumo da semana. Você também pode configurar os seus alertas de segurança como notificações web, notificações individuais de e-mail, resumo de e-mail diários ou alertas na interface de {% data variables.product.product_name %}. Para obter mais informações, consulte "[Sobre alertas para dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)"
diff --git a/translations/pt-BR/data/reusables/repositories/security-alerts-x-github-severity.md b/translations/pt-BR/data/reusables/repositories/security-alerts-x-github-severity.md
index 8b4e13244cb5..4069452d9731 100644
--- a/translations/pt-BR/data/reusables/repositories/security-alerts-x-github-severity.md
+++ b/translations/pt-BR/data/reusables/repositories/security-alerts-x-github-severity.md
@@ -1 +1 @@
-Email notifications for {% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} that affect one or more repositories include the `X-GitHub-Severity`  header field. You can use the value of the `X-GitHub-Severity` header field to filter email notifications for {% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %}.
\ No newline at end of file
+Notificações de e-mail para {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 1" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}alertas de segurança{% endif %} que afetam um ou mais repositórios incluem o campo do cabeçalho `X-GitHub-Severity`. Você pode usar o valor do campo de cabeçalho `X-GitHub-Severity` para filtrar notificações de e-mail para {% if currentVersion == "free-pro-team@latest" ou currentVersion ver_gt "enterprise-server@2. 1" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}alertas de segurança{% endif %}.
diff --git a/translations/pt-BR/data/reusables/repositories/security-guidelines.md b/translations/pt-BR/data/reusables/repositories/security-guidelines.md
index 05466b240a2b..d25b9c7d39a9 100644
--- a/translations/pt-BR/data/reusables/repositories/security-guidelines.md
+++ b/translations/pt-BR/data/reusables/repositories/security-guidelines.md
@@ -1,3 +1,3 @@
 {% if currentVersion == "free-pro-team@latest" %}
-You can create a security policy to give people instructions for responsibly reporting security vulnerabilities in your project. Para obter mais informações, consulte "[Adicionar uma política de segurança ao seu repositório](/articles/adding-a-security-policy-to-your-repository)".
+Você pode criar uma política de segurança para dar às pessoas instruções para relatar vulnerabilidades de segurança de forma responsável em seu projeto. Para obter mais informações, consulte "[Adicionar uma política de segurança ao seu repositório](/articles/adding-a-security-policy-to-your-repository)".
 {% endif %}
diff --git a/translations/pt-BR/data/reusables/repositories/select-items-in-issue-or-pr-list.md b/translations/pt-BR/data/reusables/repositories/select-items-in-issue-or-pr-list.md
index 263da8cf5084..9ad0d72ad1e1 100644
--- a/translations/pt-BR/data/reusables/repositories/select-items-in-issue-or-pr-list.md
+++ b/translations/pt-BR/data/reusables/repositories/select-items-in-issue-or-pr-list.md
@@ -1 +1 @@
-3. Select the checkbox next to the items you want to apply a label to. ![Caixa de seleção de metadados de problemas](/assets/images/help/issues/issues_assign_checkbox.png)
+3. Marque a caixa de seleção ao lado dos itens aos quais você deseja aplicar uma etiqueta. ![Caixa de seleção de metadados de problemas](/assets/images/help/issues/issues_assign_checkbox.png)
diff --git a/translations/pt-BR/data/reusables/repositories/select-marketplace-apps.md b/translations/pt-BR/data/reusables/repositories/select-marketplace-apps.md
index fe4277cc7816..9969f2cb989e 100644
--- a/translations/pt-BR/data/reusables/repositories/select-marketplace-apps.md
+++ b/translations/pt-BR/data/reusables/repositories/select-marketplace-apps.md
@@ -1,3 +1,5 @@
 {% if currentVersion == "free-pro-team@latest" %}
-1. Optionally, if the personal account or organization in which you're creating uses any {% data variables.product.prodname_github_app %}s from {% data variables.product.prodname_marketplace %}, select any apps you'd like to use in the repository. ![Lista dos {% data variables.product.prodname_github_app %} da sua conta no {% data variables.product.prodname_marketplace %} e opção para conceder acesso](/assets/images/help/repository/create-repository-choose-marketplace-apps.png)
+1. Opcionalmente, se a conta pessoal ou organização em que você está criando usar algum
+{% data variables.product.prodname_github_app %}s de {% data variables.product.prodname_marketplace %}, selecione quaisquer aplicativos que você deseje usar no repositório.
+  ![Lista dos {% data variables.product.prodname_github_app %} da sua conta no {% data variables.product.prodname_marketplace %} e opção para conceder acesso](/assets/images/help/repository/create-repository-choose-marketplace-apps.png)
 {% endif %}
diff --git a/translations/pt-BR/data/reusables/repositories/sensitive-info-warning.md b/translations/pt-BR/data/reusables/repositories/sensitive-info-warning.md
index 9ef4af223f18..35b3223c2f65 100644
--- a/translations/pt-BR/data/reusables/repositories/sensitive-info-warning.md
+++ b/translations/pt-BR/data/reusables/repositories/sensitive-info-warning.md
@@ -1,13 +1,13 @@
 {% warning %}
 
-**Warning:** Never `git add`, `commit`, or `push` sensitive information to a remote repository. Sensitive information can include, but is not limited to:
+**Aviso:** Se estiver manuseando informações confidenciais, nunca faça `git add`, `commit` ou `push` para um repositório remoto. As informações confidenciais pode incluir, entre outros:
 
-- Passwords
+- Senhas
 - Chaves SSH
-- [AWS access keys](http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSGettingStartedGuide/AWSCredentials.html)
-- API keys
-- Credit card numbers
-- PIN numbers
+- [Chaves de acesso AWS](http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSGettingStartedGuide/AWSCredentials.html)
+- Chaves API
+- Números de cartão de crédito
+- Código PIN
 
 Para obter mais informações, consulte "[Remover dados confidenciais do repositório](/articles/removing-sensitive-data-from-a-repository)".
 
diff --git a/translations/pt-BR/data/reusables/repositories/sidebar-advisories.md b/translations/pt-BR/data/reusables/repositories/sidebar-advisories.md
index c652f597e0a4..e08771c48ffc 100644
--- a/translations/pt-BR/data/reusables/repositories/sidebar-advisories.md
+++ b/translations/pt-BR/data/reusables/repositories/sidebar-advisories.md
@@ -1 +1 @@
-1. In the left sidebar, click **Security advisories**. ![Security advisories tab](/assets/images/help/security/advisories-tab.png)
+1. Na barra lateral esquerda, clique em **Consultoria de segurança**. ![Aba de consultoria de segurança](/assets/images/help/security/advisories-tab.png)
diff --git a/translations/pt-BR/data/reusables/repositories/sidebar-code-scanning-alerts.md b/translations/pt-BR/data/reusables/repositories/sidebar-code-scanning-alerts.md
index 90992a248f8f..c59dc7d16927 100644
--- a/translations/pt-BR/data/reusables/repositories/sidebar-code-scanning-alerts.md
+++ b/translations/pt-BR/data/reusables/repositories/sidebar-code-scanning-alerts.md
@@ -1 +1 @@
-1. In the left sidebar, click **Code scanning alerts**. Optionally, select the code scanning tool you used. !["Code scanning alerts" tab](/assets/images/help/repository/sidebar-code-scanning-alerts.png)
+1. Na barra lateral esquerda, clique em **alertas de varredura de código**. Opcionalmente, selecione a ferramenta de varredura de código que você usou. ![Aba de "Alertas de varredura de código"](/assets/images/help/repository/sidebar-code-scanning-alerts.png)
diff --git a/translations/pt-BR/data/reusables/repositories/sidebar-dependabot-alerts.md b/translations/pt-BR/data/reusables/repositories/sidebar-dependabot-alerts.md
index 74585315b209..337545fdaba1 100644
--- a/translations/pt-BR/data/reusables/repositories/sidebar-dependabot-alerts.md
+++ b/translations/pt-BR/data/reusables/repositories/sidebar-dependabot-alerts.md
@@ -1 +1 @@
-1. In the security sidebar, click **{% data variables.product.prodname_dependabot_short %} alerts**. ![{% data variables.product.prodname_dependabot_short %} alerts tab](/assets/images/help/repository/dependabot-alerts-tab.png)
\ No newline at end of file
+1. Na barra lateral de segurança, clique em **alertas de{% data variables.product.prodname_dependabot_short %}**. ![Aba de alertas de {% data variables.product.prodname_dependabot_short %}](/assets/images/help/repository/dependabot-alerts-tab.png)
diff --git a/translations/pt-BR/data/reusables/repositories/sidebar-issue-pr.md b/translations/pt-BR/data/reusables/repositories/sidebar-issue-pr.md
index 54f1cbe0bc03..62965fb47b5c 100644
--- a/translations/pt-BR/data/reusables/repositories/sidebar-issue-pr.md
+++ b/translations/pt-BR/data/reusables/repositories/sidebar-issue-pr.md
@@ -1 +1 @@
-1. Under your repository name, click {% octicon "issue-opened" aria-label="The issues icon" %} **Issues** or {% octicon "git-pull-request" aria-label="The pull request icon" %} **Pull requests**. ![Problemas e seleção da guia pull requests](/assets/images/help/repository/repo-settings-issues-pull-requests.png)
+1. No nome do repositório, clique em {% octicon "issue-opened" aria-label="The issues icon" %} **Problemas** ou {% octicon "git-pull-request" aria-label="The pull request icon" %} **Pull requests**. ![Problemas e seleção da guia pull requests](/assets/images/help/repository/repo-settings-issues-pull-requests.png)
diff --git a/translations/pt-BR/data/reusables/repositories/sidebar-issues.md b/translations/pt-BR/data/reusables/repositories/sidebar-issues.md
index be871f338a6b..2bc85a6b7e89 100644
--- a/translations/pt-BR/data/reusables/repositories/sidebar-issues.md
+++ b/translations/pt-BR/data/reusables/repositories/sidebar-issues.md
@@ -1 +1 @@
-2. Under your repository name, click {% octicon "issue-opened" aria-label="The issues icon" %} **Issues**. ![Issues tab](/assets/images/help/repository/repo-tabs-issues.png)
+2. No nome do repositório, clique em {% octicon "issue-opened" aria-label="The issues icon" %} **problemas**. ![Aba de problemas](/assets/images/help/repository/repo-tabs-issues.png)
diff --git a/translations/pt-BR/data/reusables/repositories/sidebar-moderation-reported-content.md b/translations/pt-BR/data/reusables/repositories/sidebar-moderation-reported-content.md
index 71f446d90c12..831a1b6eaf35 100644
--- a/translations/pt-BR/data/reusables/repositories/sidebar-moderation-reported-content.md
+++ b/translations/pt-BR/data/reusables/repositories/sidebar-moderation-reported-content.md
@@ -1 +1 @@
-1. In the left sidebar, click **Reported content**. !["Reported content" in repository Settings sidebar](/assets/images/help/repository/repo-settings-reported-content.png)
+1. Na barra lateral esquerda, clique em **Conteúdo relatado**. !["Conteúdo relatado" na barra lateral de Configurações do repositório](/assets/images/help/repository/repo-settings-reported-content.png)
diff --git a/translations/pt-BR/data/reusables/repositories/sidebar-notifications.md b/translations/pt-BR/data/reusables/repositories/sidebar-notifications.md
index 7313fbdeaf77..761c86ed991f 100644
--- a/translations/pt-BR/data/reusables/repositories/sidebar-notifications.md
+++ b/translations/pt-BR/data/reusables/repositories/sidebar-notifications.md
@@ -1 +1 @@
-1. Click **Notifications**. ![Notifications button in sidebar](/assets/images/help/settings/notifications_menu.png)
+1. Clique em **Notificações**. ![Botão de notificações na barra lateral](/assets/images/help/settings/notifications_menu.png)
diff --git a/translations/pt-BR/data/reusables/repositories/sidebar-pr.md b/translations/pt-BR/data/reusables/repositories/sidebar-pr.md
index ab0f1907b277..df5f2a4da25b 100644
--- a/translations/pt-BR/data/reusables/repositories/sidebar-pr.md
+++ b/translations/pt-BR/data/reusables/repositories/sidebar-pr.md
@@ -1 +1 @@
-1. Under your repository name, click {% octicon "git-pull-request" aria-label="The pull request icon" %} **Pull requests**. ![Problemas e seleção da guia pull requests](/assets/images/help/repository/repo-tabs-pull-requests.png)
+1. No nome do repositório, clique em {% octicon "git-pull-request" aria-label="The pull request icon" %} **Pull requests**. ![Problemas e seleção da guia pull requests](/assets/images/help/repository/repo-tabs-pull-requests.png)
diff --git a/translations/pt-BR/data/reusables/repositories/sidebar-security.md b/translations/pt-BR/data/reusables/repositories/sidebar-security.md
index 65437c82f326..23cfce9c66c8 100644
--- a/translations/pt-BR/data/reusables/repositories/sidebar-security.md
+++ b/translations/pt-BR/data/reusables/repositories/sidebar-security.md
@@ -1 +1 @@
-1. Under your repository name, click **{% octicon "shield" aria-label="The shield symbol" %} Security**. ![Guia de segurança](/assets/images/help/repository/security-tab.png)
+1. No seu nome de repositório, clique em **{% octicon "shield" aria-label="The shield symbol" %} Segurança**. ![Guia de segurança](/assets/images/help/repository/security-tab.png)
diff --git a/translations/pt-BR/data/reusables/repositories/sidebar-settings.md b/translations/pt-BR/data/reusables/repositories/sidebar-settings.md
index b2640a2ed5b4..85c954da3952 100644
--- a/translations/pt-BR/data/reusables/repositories/sidebar-settings.md
+++ b/translations/pt-BR/data/reusables/repositories/sidebar-settings.md
@@ -1 +1 @@
-1. Under your repository name, click {% octicon "gear" aria-label="The gear icon" %} **Settings**. ![Repository settings button](/assets/images/help/repository/repo-actions-settings.png)
+1. No nome do seu repositório, clique em {% octicon "gear" aria-label="The gear icon" %} **Configurações**. ![Botão de configurações do repositório](/assets/images/help/repository/repo-actions-settings.png)
diff --git a/translations/pt-BR/data/reusables/repositories/sidebar-wiki.md b/translations/pt-BR/data/reusables/repositories/sidebar-wiki.md
index 1d929457655c..d4c02e0e854e 100644
--- a/translations/pt-BR/data/reusables/repositories/sidebar-wiki.md
+++ b/translations/pt-BR/data/reusables/repositories/sidebar-wiki.md
@@ -1 +1 @@
-1. Under your repository name, click {% octicon "book" aria-label="Book symbol" %} **Wiki**. ![Wiki menu link](/assets/images/help/wiki/wiki_menu_link.png)
+1. No nome do repositório, clique em {% octicon "book" aria-label="Book symbol" %} **Wiki**. ![Link do menu Wiki](/assets/images/help/wiki/wiki_menu_link.png)
diff --git a/translations/pt-BR/data/reusables/repositories/squash-and-rebase-linear-commit-hisitory.md b/translations/pt-BR/data/reusables/repositories/squash-and-rebase-linear-commit-hisitory.md
index a3eec30b801b..ad0466895e28 100644
--- a/translations/pt-BR/data/reusables/repositories/squash-and-rebase-linear-commit-hisitory.md
+++ b/translations/pt-BR/data/reusables/repositories/squash-and-rebase-linear-commit-hisitory.md
@@ -1 +1 @@
-{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}If there is a protected branch rule in your repository that requires a linear commit history, you must allow squash merging, rebase merging, or both. Para obter mais informações, consulte "[Exigindo um histórico de commit linear](/github/administering-a-repository/requiring-a-linear-commit-history)".{% endif %}
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 9" %}Se houver uma regra de branch protegido no seu repositório que exija um histórico de commit linear você deverá permitir merge de combinação por squash, merge de rebase ou ambos. Para obter mais informações, consulte "[Exigindo um histórico de commit linear](/github/administering-a-repository/requiring-a-linear-commit-history)".{% endif %}
diff --git a/translations/pt-BR/data/reusables/repositories/start-line-comment.md b/translations/pt-BR/data/reusables/repositories/start-line-comment.md
index 5f3857d8b49b..6f9c585ca89f 100644
--- a/translations/pt-BR/data/reusables/repositories/start-line-comment.md
+++ b/translations/pt-BR/data/reusables/repositories/start-line-comment.md
@@ -1 +1 @@
-1. Hover over the line of code where you'd like to add a comment, and click the blue comment icon.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} To add a comment on multiple lines, click and drag to select the range of lines, then click the blue comment icon.{% endif %} ![Blue comment icon](/assets/images/help/commits/hover-comment-icon.gif)
+1. Passe o mouse sobre a linha de código onde você gostaria de adicionar um comentário e clique no ícone de comentário azul.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} Para adicionar um comentário em várias linhas, clique e arraste para selecionar o intervalo de linhas e, em seguida, clique no ícone azul de comentário.{% endif %} ![Ícone de comentário azul](/assets/images/help/commits/hover-comment-icon.gif)
diff --git a/translations/pt-BR/data/reusables/repositories/submit-new-issue.md b/translations/pt-BR/data/reusables/repositories/submit-new-issue.md
index 695ac4a9e0fd..38665d6b78fc 100644
--- a/translations/pt-BR/data/reusables/repositories/submit-new-issue.md
+++ b/translations/pt-BR/data/reusables/repositories/submit-new-issue.md
@@ -1 +1 @@
-1. When you're finished, click **Submit new issue**.
+1. Ao terminar, clique em **Enviar novo problema**.
diff --git a/translations/pt-BR/data/reusables/repositories/submit-review.md b/translations/pt-BR/data/reusables/repositories/submit-review.md
index 046be291b4f8..b6a1341fc21d 100644
--- a/translations/pt-BR/data/reusables/repositories/submit-review.md
+++ b/translations/pt-BR/data/reusables/repositories/submit-review.md
@@ -1 +1 @@
-1. Click **Submit review**.
+1. Clique em **Enviar revisão**.
diff --git a/translations/pt-BR/data/reusables/repositories/suggest-changes.md b/translations/pt-BR/data/reusables/repositories/suggest-changes.md
index f99da48b359d..3a3ecff9aaeb 100644
--- a/translations/pt-BR/data/reusables/repositories/suggest-changes.md
+++ b/translations/pt-BR/data/reusables/repositories/suggest-changes.md
@@ -1 +1 @@
-1. Optionally, to suggest a specific change to the line{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} or lines{% endif %}, click {% octicon "diff" aria-label="The diff symbol" %}, then edit the text within the suggestion block. ![Suggestion block](/assets/images/help/pull_requests/suggestion-block.png)
+1. Opcionalmente, para sugerir uma alteração específica à linha{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 0" %} ou linhas{% endif %}, clique em {% octicon "diff" aria-label="The diff symbol" %} e, em seguida, edite o texto dentro do bloco de sugestões. ![Bloco de sugestão](/assets/images/help/pull_requests/suggestion-block.png)
diff --git a/translations/pt-BR/data/reusables/repositories/task-list-markdown.md b/translations/pt-BR/data/reusables/repositories/task-list-markdown.md
index 60a3de4d67bb..8119d2f8bec5 100644
--- a/translations/pt-BR/data/reusables/repositories/task-list-markdown.md
+++ b/translations/pt-BR/data/reusables/repositories/task-list-markdown.md
@@ -1,4 +1,4 @@
-To create a task list, preface list items with a regular space character followed by `[ ]`. To mark a task as complete, use `[x]`.
+Para criar uma lista de tarefas, introduza os itens da lista com um caractere de espaço normal seguido de `[ ]`. Para marcar uma tarefa como concluída, use `[x]`.
 
 ```
 - [x] Finish my changes
@@ -6,4 +6,4 @@ To create a task list, preface list items with a regular space character followe
 - [ ] Open a pull request
 ```
 
-![Rendered task list](/assets/images/help/writing/task-list-rendered.png)
+![Lista de tarefas gerada](/assets/images/help/writing/task-list-rendered.png)
diff --git a/translations/pt-BR/data/reusables/repositories/tracks-vulnerabilities.md b/translations/pt-BR/data/reusables/repositories/tracks-vulnerabilities.md
index d2ad199b797f..2e668126c802 100644
--- a/translations/pt-BR/data/reusables/repositories/tracks-vulnerabilities.md
+++ b/translations/pt-BR/data/reusables/repositories/tracks-vulnerabilities.md
@@ -1,6 +1,8 @@
-We add vulnerabilities to the {% data variables.product.prodname_advisory_database %} from the following sources:
-- The [National Vulnerability Database](https://nvd.nist.gov/)
-- A combination of machine learning and human review to detect vulnerabilities in public commits on {% data variables.product.prodname_dotcom %}
-- Security advisories reported on {% data variables.product.prodname_dotcom %}
-- The [npm Security advisories](https://www.npmjs.com/advisories) database
-- [FriendsOfPHP](https://github.com/FriendsOfPHP/security-advisories)
+Adicionamos vulnerabilidades a {% data variables.product.prodname_advisory_database %} a partir das seguintes fontes:
+- A [Base de Dados de Vulnerabilidade Nacional](https://nvd.nist.gov/)
+- Uma combinação de aprendizado de máquina e revisão humana para detectar vulnerabilidades em commits públicos em {% data variables.product.prodname_dotcom %}
+- Consultorias de segurança relatadas em {% data variables.product.prodname_dotcom %}
+- O banco de dados de  Consultorias de segurança de npm
+ 
+  
+  - [FriendsOfPHP](https://github.com/FriendsOfPHP/security-advisories)
diff --git a/translations/pt-BR/data/reusables/repositories/transfer-repository-steps.md b/translations/pt-BR/data/reusables/repositories/transfer-repository-steps.md
index f09d5c681068..ffacec2b5835 100644
--- a/translations/pt-BR/data/reusables/repositories/transfer-repository-steps.md
+++ b/translations/pt-BR/data/reusables/repositories/transfer-repository-steps.md
@@ -1,10 +1,10 @@
 {% if currentVersion == "free-pro-team@latest" %}
-1. Under "Danger Zone", click **Transfer**. ![Transfer button](/assets/images/help/repository/repo-transfer.png)
-1. Read the information about transferring a repository, then type the name of the user or organization you'd like to transfer ownership of the repository to. ![Information about repository transfer and field to type the new owner's username](/assets/images/help/repository/transfer-repo-new-owner-name.png)
-1. Read the warnings about potential loss of features depending on the new owner's subscription. ![Warnings about transferring a repository to a person using a free product](/assets/images/help/repository/repo-transfer-free-plan-warnings.png)
-1. Type the name of the repository you'd like to transfer, then click **I understand, transfer this repository**. ![Transfer button](/assets/images/help/repository/repo-transfer-complete.png)
+1. Em "Zona e perigo", clique em **Transferir**. ![Botão de Transferir](/assets/images/help/repository/repo-transfer.png)
+1. Leia as informações sobre a transferência de um repositório e digite o nome do usuário ou organização para o qual deseja transferir a propriedade do repositório. ![Informações sobre transferência de repositório e campo para digitar o nome de usuário do novo proprietário](/assets/images/help/repository/transfer-repo-new-owner-name.png)
+1. Leia as advertências sobre a potencial perda de recursos, dependendo da assinatura do novo proprietário. ![Avisos sobre a transferência de um repositório para uma pessoa que usa um produto grátis](/assets/images/help/repository/repo-transfer-free-plan-warnings.png)
+1. Digite o nome do repositório que você deseja transferir e, em seguida, clique em **Eu entendo. Transferir este repositório**. ![Botão de Transferir](/assets/images/help/repository/repo-transfer-complete.png)
 {% else %}
-1. Click **Transfer**. ![Transfer button](/assets/images/help/repository/repo-transfer.png)
-1. Read the warnings and enter the repository name to confirm that you've done so.
-1. Type the name of the new owner and click **I understand, transfer this repo**. ![Transfer button](/assets/images/help/repository/repo-transfer-complete.png)
+1. Clique em **Transferir**. ![Botão de Transferir](/assets/images/help/repository/repo-transfer.png)
+1. Leia as advertências e digite o nome do repositório para confirmar que você fez isso.
+1. Digite o nome do novo proprietário e clique em **Eu entendo. Transfira este repositório**. ![Botão de Transferir](/assets/images/help/repository/repo-transfer-complete.png)
 {% endif %}
diff --git a/translations/pt-BR/data/reusables/repositories/two-dot-diff-comparison-example-urls.md b/translations/pt-BR/data/reusables/repositories/two-dot-diff-comparison-example-urls.md
index 5dbca8831bdc..4f8cd11efa68 100644
--- a/translations/pt-BR/data/reusables/repositories/two-dot-diff-comparison-example-urls.md
+++ b/translations/pt-BR/data/reusables/repositories/two-dot-diff-comparison-example-urls.md
@@ -1 +1 @@
-For example, this URL uses the shortened seven-character SHA codes to compare commits `c3a414e` and `faf7c6f`: `https://github.com/github/linguist/compare/c3a414e..faf7c6f.`
+Por exemplo, esta URL usa os códigos SHA de sete caracteres encurtados para comparar commits `c3a414e` e `faf7c6f`: `https://github.com/github/linguist/compare/c3a414e..faf7c6f.`
diff --git a/translations/pt-BR/data/reusables/repositories/type-issue-title-and-description.md b/translations/pt-BR/data/reusables/repositories/type-issue-title-and-description.md
index 739f09735daf..13970c5ffe2a 100644
--- a/translations/pt-BR/data/reusables/repositories/type-issue-title-and-description.md
+++ b/translations/pt-BR/data/reusables/repositories/type-issue-title-and-description.md
@@ -1 +1 @@
-1. Type a title and description for your issue. ![A sample issue](/assets/images/help/issues/sample_issue.png)
+1. Digite um título e uma descrição para o seu problema. ![Um exemplo de problema](/assets/images/help/issues/sample_issue.png)
diff --git a/translations/pt-BR/data/reusables/repositories/type-line-comment.md b/translations/pt-BR/data/reusables/repositories/type-line-comment.md
index 77ec5c59c7c9..66fe528a7c8f 100644
--- a/translations/pt-BR/data/reusables/repositories/type-line-comment.md
+++ b/translations/pt-BR/data/reusables/repositories/type-line-comment.md
@@ -1 +1 @@
-1. In the comment field, type your comment. ![Comment field](/assets/images/help/pull_requests/comment-field.png)
+1. No campo comentário, digite o seu comentário. ![Campo de comentário](/assets/images/help/pull_requests/comment-field.png)
diff --git a/translations/pt-BR/data/reusables/repositories/valid-community-issues.md b/translations/pt-BR/data/reusables/repositories/valid-community-issues.md
index d52f3c2ac76e..c1f5b6bfd4ab 100644
--- a/translations/pt-BR/data/reusables/repositories/valid-community-issues.md
+++ b/translations/pt-BR/data/reusables/repositories/valid-community-issues.md
@@ -1 +1 @@
-To be included in the community profile checklist, issue templates must be located in the `.github/ISSUE_TEMPLATE` folder and contain valid `name:` and `about:` YAML front matter.
+Para ser incluído na lista de perfil da comunidade, os modelos de problemas devem estar localizados na pasta `.github/ISSUE_TEMPLATE` e conter campos de `name:` válido e `sobre:` de YAML front matter válidos.
diff --git a/translations/pt-BR/data/reusables/repositories/view-failed-job-results-superlinter.md b/translations/pt-BR/data/reusables/repositories/view-failed-job-results-superlinter.md
new file mode 100644
index 000000000000..954583cc18ac
--- /dev/null
+++ b/translations/pt-BR/data/reusables/repositories/view-failed-job-results-superlinter.md
@@ -0,0 +1,5 @@
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+1. Any failed steps are automatically expanded to display the results. ![Resultados do fluxo de trabalho do Super linter](/assets/images/help/repository/super-linter-workflow-results-updated.png)
+{% else %}
+1. Expanda a etapa **Executar Super-Linter** para visualizar os resultados. ![Resultados do fluxo de trabalho do Super linter](/assets/images/help/repository/super-linter-workflow-results.png)
+{% endif %}
\ No newline at end of file
diff --git a/translations/pt-BR/data/reusables/repositories/view-run-superlinter.md b/translations/pt-BR/data/reusables/repositories/view-run-superlinter.md
new file mode 100644
index 000000000000..efb612470a5c
--- /dev/null
+++ b/translations/pt-BR/data/reusables/repositories/view-run-superlinter.md
@@ -0,0 +1 @@
+1. Na lista de execuções do fluxo de trabalho, clique no nome da execução que você deseja visualizar. ![Nome da execução do fluxo de trabalho](/assets/images/help/repository/superlinter-run-name.png)
\ No newline at end of file
diff --git a/translations/pt-BR/data/reusables/repositories/view-run.md b/translations/pt-BR/data/reusables/repositories/view-run.md
index 4ba2c799ef4f..6f2e8fb5885e 100644
--- a/translations/pt-BR/data/reusables/repositories/view-run.md
+++ b/translations/pt-BR/data/reusables/repositories/view-run.md
@@ -1 +1 @@
-1. Under "Workflow runs", click the name of the run you want to see. ![Name of workflow run](/assets/images/help/repository/run-name.png)
+1. Na lista de execuções do fluxo de trabalho, clique no nome da execução que você deseja visualizar. ![Nome da execução do fluxo de trabalho](/assets/images/help/repository/run-name.png)
diff --git a/translations/pt-BR/data/reusables/repositories/view-specific-line-superlinter.md b/translations/pt-BR/data/reusables/repositories/view-specific-line-superlinter.md
new file mode 100644
index 000000000000..19b7d831bec4
--- /dev/null
+++ b/translations/pt-BR/data/reusables/repositories/view-specific-line-superlinter.md
@@ -0,0 +1,5 @@
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+1. Para obter um link para uma linha específica nos logs, clique no número da linha da etapa. You can then copy the link from the address bar of your web browser. ![Botão para copiar link](/assets/images/help/repository/copy-link-button-updated.png)
+{% else %}
+1. Para obter um link para uma linha específica nos logs, clique no número da linha da etapa. You can then copy the link from the address bar of your web browser. ![Botão para copiar link](/assets/images/help/repository/copy-link-button.png)
+{% endif %}
\ No newline at end of file
diff --git a/translations/pt-BR/data/reusables/repositories/workflow-notifications.md b/translations/pt-BR/data/reusables/repositories/workflow-notifications.md
index 3355ed5329ea..9884c951fb1a 100644
--- a/translations/pt-BR/data/reusables/repositories/workflow-notifications.md
+++ b/translations/pt-BR/data/reusables/repositories/workflow-notifications.md
@@ -1,3 +1,3 @@
-If you enable email or web notifications for {% data variables.product.prodname_actions %}, you'll receive a notification when any workflow runs that you've triggered have completed. The notification will include the workflow run's status (including successful, failed, neutral, and canceled runs). You can also choose to receive a notification only when a workflow run has failed.
+Se você habilitar o e-mail ou as notificações da web para {% data variables.product.prodname_actions %}, você receberá uma notificação quando qualquer fluxo de trabalho que tenha sido acionado for concluído. A notificação incluirá o status da execução do fluxo de trabalho (incluindo execuções bem-sucedidas, com falhas, neutras e canceladas). Também pode optar por receber uma notificação apenas quando a execução de um fluxo de trabalho falhar.
 
-You can also see the status of workflow runs on a repository's Actions tab. Para obter mais informações, consulte "[Gerenciar a execução de fluxos de trabalho](/actions/automating-your-workflow-with-github-actions/managing-a-workflow-run)".
+Você também pode visualizar o status do fluxo de trabalho executado na aba Ações de um repositório. Para obter mais informações, consulte "[Gerenciar a execução de fluxos de trabalho](/actions/automating-your-workflow-with-github-actions/managing-a-workflow-run)".
diff --git a/translations/pt-BR/data/reusables/repositories/you-can-fork.md b/translations/pt-BR/data/reusables/repositories/you-can-fork.md
index 2d0107fbb9fb..2d290ce6cde4 100644
--- a/translations/pt-BR/data/reusables/repositories/you-can-fork.md
+++ b/translations/pt-BR/data/reusables/repositories/you-can-fork.md
@@ -1,3 +1,3 @@
-You can fork any public repository to your user account or any organization where you have repository creation permissions. Para obter mais informações, consulte "[Níveis de permissão para uma organização](/articles/permission-levels-for-an-organization)".
+You can fork any public repository to your user account or any organization where you have repository creation permissions. For more information, see "[Permission levels for an organization](/articles/permission-levels-for-an-organization)."
 
 You can fork any private repository you can access to your user account and any organization on {% data variables.product.prodname_team %} or {% data variables.product.prodname_enterprise %} where you have repository creation permissions. You cannot fork a private repository to an organization using {% data variables.product.prodname_free_team %}.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[GitHub's products](/articles/githubs-products)."{% endif %}
diff --git a/translations/pt-BR/data/reusables/saml/about-authorized-credentials.md b/translations/pt-BR/data/reusables/saml/about-authorized-credentials.md
index a86e6510b10d..a9751c8dcdc3 100644
--- a/translations/pt-BR/data/reusables/saml/about-authorized-credentials.md
+++ b/translations/pt-BR/data/reusables/saml/about-authorized-credentials.md
@@ -1 +1 @@
-You can see each personal access token and SSH key that a member has authorized for API and Git access. Only the last several characters of each token or key are visible. If necessary, work with the member to determine which credentials you should revoke.
+Você pode ver cada token de acesso pessoal e a chave SSH que um integrante autorizou para obter acesso à API e ao Git. Somente os últimos caracteres de cada token ou chave são visíveis. Se necessário, trabalhe com o integrante para determinar quais credenciais você deve revogar.
diff --git a/translations/pt-BR/data/reusables/saml/about-linked-identities.md b/translations/pt-BR/data/reusables/saml/about-linked-identities.md
index 1d00f129eae9..a9be0672ab80 100644
--- a/translations/pt-BR/data/reusables/saml/about-linked-identities.md
+++ b/translations/pt-BR/data/reusables/saml/about-linked-identities.md
@@ -1,3 +1,3 @@
-You can view the single sign-on identity that a member has linked to their {% data variables.product.product_name %} account. When available, the entry will include SCIM data. Para obter mais informações, consulte "[Sobre o SCIM](/github/setting-up-and-managing-organizations-and-teams/about-scim)".
+Você pode visualizar a identidade de logon único que um integrante vinculou à sua conta de {% data variables.product.product_name %} Quando disponível, a entrada incluirá dados de SCIM. Para obter mais informações, consulte "[Sobre o SCIM](/github/setting-up-and-managing-organizations-and-teams/about-scim)".
 
-If a member links the wrong identity to their {% data variables.product.product_name %} account, you can revoke the linked identity to allow the member to try again.
+Se um integrante vincular a identidade incorreta à sua conta de {% data variables.product.product_name %}, você poderá revogar a identidade vinculada para permitir que o integrante tente novamente.
diff --git a/translations/pt-BR/data/reusables/saml/about-saml-access-enterprise-account.md b/translations/pt-BR/data/reusables/saml/about-saml-access-enterprise-account.md
index 946b0edc6822..fe0987460305 100644
--- a/translations/pt-BR/data/reusables/saml/about-saml-access-enterprise-account.md
+++ b/translations/pt-BR/data/reusables/saml/about-saml-access-enterprise-account.md
@@ -1 +1 @@
-To access each organization's resources on {% data variables.product.product_name %}, the member must have an active SAML session in their browser. To access each organization's protected resources using the API and Git, the member must use a personal access token or SSH key that the member has authorized for use with the organization. Enterprise owners can view and revoke a member's linked identity, active sessions, or authorized credentials at any time.
+Para acessar os recursos de cada organização em {% data variables.product.product_name %}, o integrante deve ter uma sessão SAML ativa no navegador. Para acessar os recursos protegidos de cada organização usando a API e o Git, o integrante deve usar um token de acesso pessoal ou chave SSH que o integrante autorizou a usar com a organização. Os proprietários da empresa podem ver e revogar a identidade vinculada de um integrante, sessões ativas ou credenciais autorizadas a qualquer momento.
diff --git a/translations/pt-BR/data/reusables/saml/about-user-provisioning-enterprise-account.md b/translations/pt-BR/data/reusables/saml/about-user-provisioning-enterprise-account.md
index 918dab289fd9..fa41235d0ccc 100644
--- a/translations/pt-BR/data/reusables/saml/about-user-provisioning-enterprise-account.md
+++ b/translations/pt-BR/data/reusables/saml/about-user-provisioning-enterprise-account.md
@@ -1 +1 @@
-If you use Okta as your IdP, you can use SCIM to manage organization membership in your enterprise account. SCIM automatically invites people to or removes people from organizations in your enterprise account based on whether they are members of the group that corresponds to each organization in your IdP.
+Se você usar o Okta como seu IdP, você poderá usar o SCIM para gerenciar a associação à organização na conta corporativa. O SCIM convida automaticamente as pessoas ou remove pessoas de organizações na sua conta corporativa com base no fato de serem integrantes do grupo que correspondem a cada organização em seu IdP.
diff --git a/translations/pt-BR/data/reusables/saml/add-okta-application.md b/translations/pt-BR/data/reusables/saml/add-okta-application.md
index c0603c1510ee..bc6f5d011365 100644
--- a/translations/pt-BR/data/reusables/saml/add-okta-application.md
+++ b/translations/pt-BR/data/reusables/saml/add-okta-application.md
@@ -1 +1 @@
-2. Click **Add application**. !["Add application" button in the Okta Dashboard's Applications tab](/assets/images/help/saml/okta-add-application.png)
\ No newline at end of file
+2. Clique em **Adicionar aplicativo**. ![Botão "Adicionar aplicativo" na aba Aplicativos do painel do Okta](/assets/images/help/saml/okta-add-application.png)
diff --git a/translations/pt-BR/data/reusables/saml/assign-yourself-to-okta.md b/translations/pt-BR/data/reusables/saml/assign-yourself-to-okta.md
index 7b2fd7293434..c4c23f01f30b 100644
--- a/translations/pt-BR/data/reusables/saml/assign-yourself-to-okta.md
+++ b/translations/pt-BR/data/reusables/saml/assign-yourself-to-okta.md
@@ -1 +1 @@
-1. Assign the application to your user in Okta. For more information, see [Assign applications to users](https://help.okta.com/en/prod/Content/Topics/users-groups-profiles/usgp-assign-apps.htm) in the Okta documentation.
\ No newline at end of file
+1. Atribua o aplicativo ao seu usuário no Okta. Para obter mais informações, consulte [Atribuir aplicativos aos usuários](https://help.okta.com/en/prod/Content/Topics/users-groups-profiles/usgp-assign-apps.htm) na documentação do Okta.
diff --git a/translations/pt-BR/data/reusables/saml/click-enterprise-account-application.md b/translations/pt-BR/data/reusables/saml/click-enterprise-account-application.md
index e5d172dcb9e5..16bdfb80dd48 100644
--- a/translations/pt-BR/data/reusables/saml/click-enterprise-account-application.md
+++ b/translations/pt-BR/data/reusables/saml/click-enterprise-account-application.md
@@ -1 +1 @@
-1. Click the label for the application you created for your enterprise account.
\ No newline at end of file
+1. Clique na etiqueta para o aplicativo que você criou para a sua conta corporativa.
diff --git a/translations/pt-BR/data/reusables/saml/click-person-revoke-credentials.md b/translations/pt-BR/data/reusables/saml/click-person-revoke-credentials.md
index 9ccaffc09cb4..bae247e4711c 100644
--- a/translations/pt-BR/data/reusables/saml/click-person-revoke-credentials.md
+++ b/translations/pt-BR/data/reusables/saml/click-person-revoke-credentials.md
@@ -1 +1 @@
-1. Click on the name of the member whose authorized credentials you'd like to view or revoke.
+1. Clique no nome do integrante cujas credenciais autorizadas você gostaria de visualizar ou revogar.
diff --git a/translations/pt-BR/data/reusables/saml/click-person-revoke-identity.md b/translations/pt-BR/data/reusables/saml/click-person-revoke-identity.md
index 3934767c92bd..21f3fc83df9f 100644
--- a/translations/pt-BR/data/reusables/saml/click-person-revoke-identity.md
+++ b/translations/pt-BR/data/reusables/saml/click-person-revoke-identity.md
@@ -1 +1 @@
-1. Click on the name of the member whose linked identity you'd like to view or revoke.
+1. Clique no nome do integrante cuja identidade vinculada você deseja visualizar ou revogar.
diff --git a/translations/pt-BR/data/reusables/saml/click-person-revoke-session.md b/translations/pt-BR/data/reusables/saml/click-person-revoke-session.md
index 5e0a6ac15124..049123354bab 100644
--- a/translations/pt-BR/data/reusables/saml/click-person-revoke-session.md
+++ b/translations/pt-BR/data/reusables/saml/click-person-revoke-session.md
@@ -1 +1 @@
-1. Click on the name of the member whose SAML session you'd like to view or revoke.
+1. Clique no nome do integrante cuja sessão SAML você gostaria de visualizar ou revogar.
diff --git a/translations/pt-BR/data/reusables/saml/confirm-revoke-credentials.md b/translations/pt-BR/data/reusables/saml/confirm-revoke-credentials.md
index 1b9c5f7b8415..ff1e619298bd 100644
--- a/translations/pt-BR/data/reusables/saml/confirm-revoke-credentials.md
+++ b/translations/pt-BR/data/reusables/saml/confirm-revoke-credentials.md
@@ -1 +1 @@
-1. Read the information, then click **I understand, revoke access for this token.**
+1. Leia as informações e, em seguida, clique em **Eu entendo. Revogar o acesso para esse token.**
diff --git a/translations/pt-BR/data/reusables/saml/confirm-revoke-identity.md b/translations/pt-BR/data/reusables/saml/confirm-revoke-identity.md
index 64b50692f0c0..b48cd4eaa1ba 100644
--- a/translations/pt-BR/data/reusables/saml/confirm-revoke-identity.md
+++ b/translations/pt-BR/data/reusables/saml/confirm-revoke-identity.md
@@ -1 +1 @@
-1. Read the information, then click **Revoke external identity**.
+1. Leia as informações e clique em **Revogar identidade externa**.
diff --git a/translations/pt-BR/data/reusables/saml/dotcom-saml-explanation.md b/translations/pt-BR/data/reusables/saml/dotcom-saml-explanation.md
index ddf9ab0bd50d..f99d2436af8e 100644
--- a/translations/pt-BR/data/reusables/saml/dotcom-saml-explanation.md
+++ b/translations/pt-BR/data/reusables/saml/dotcom-saml-explanation.md
@@ -1 +1 @@
-SAML SSO gives organization owners and enterprise owners on {% data variables.product.prodname_dotcom %} a way to control and secure access to organization resources like repositories, issues, and pull requests.
+O SAML SSO concede aos proprietários corporativos da organização em {% data variables.product.prodname_dotcom %} uma forma de controlar e proteger o acesso aos recursos da organização, como repositórios, problemas e pull requests.
diff --git a/translations/pt-BR/data/reusables/saml/okta-admin-button.md b/translations/pt-BR/data/reusables/saml/okta-admin-button.md
index b1f3d74979cc..9a2a845576c3 100644
--- a/translations/pt-BR/data/reusables/saml/okta-admin-button.md
+++ b/translations/pt-BR/data/reusables/saml/okta-admin-button.md
@@ -1 +1 @@
-1. In Okta, in the upper-right corner, click **Admin**. ![Admin button in Okta](/assets/images/help/saml/okta-admin-button.png)
\ No newline at end of file
+1. No Okta, no canto superior direito, clique em **Admin**. ![Botão de administração no Okta](/assets/images/help/saml/okta-admin-button.png)
diff --git a/translations/pt-BR/data/reusables/saml/okta-applications-click-ghec-application-label.md b/translations/pt-BR/data/reusables/saml/okta-applications-click-ghec-application-label.md
index ea32e809efaa..07fb8f636bb5 100644
--- a/translations/pt-BR/data/reusables/saml/okta-applications-click-ghec-application-label.md
+++ b/translations/pt-BR/data/reusables/saml/okta-applications-click-ghec-application-label.md
@@ -1 +1 @@
-1. In the list of applications, click the label for the application you created for the organization that uses {% data variables.product.prodname_ghe_cloud %}. ![{% data variables.product.prodname_ghe_cloud %} application in Okta](/assets/images/help/saml/okta-ghec-application.png)
+1. Na lista de aplicativos, clique na etiqueta do aplicativo que você criou para a organização que usa o {% data variables.product.prodname_ghe_cloud %}. ![Alicativo de {% data variables.product.prodname_ghe_cloud %} no Okta](/assets/images/help/saml/okta-ghec-application.png)
diff --git a/translations/pt-BR/data/reusables/saml/okta-configure-api-integration.md b/translations/pt-BR/data/reusables/saml/okta-configure-api-integration.md
index 99b1aad0afae..7858a45e0c3c 100644
--- a/translations/pt-BR/data/reusables/saml/okta-configure-api-integration.md
+++ b/translations/pt-BR/data/reusables/saml/okta-configure-api-integration.md
@@ -1 +1 @@
-1. Click **Configure API Integration**. !["Configure API Integration" button for Okta application](/assets/images/help/saml/okta-configure-api-integration.png)
\ No newline at end of file
+1. Clique em **Configurar a Integração da API**. ![Botão "Configurar integração da API" para o aplicativo do Okta](/assets/images/help/saml/okta-configure-api-integration.png)
diff --git a/translations/pt-BR/data/reusables/saml/okta-dashboard-click-applications.md b/translations/pt-BR/data/reusables/saml/okta-dashboard-click-applications.md
index 3e5538efb2de..775dd47227f6 100644
--- a/translations/pt-BR/data/reusables/saml/okta-dashboard-click-applications.md
+++ b/translations/pt-BR/data/reusables/saml/okta-dashboard-click-applications.md
@@ -1 +1 @@
-1. In the Okta Dashboard, click **Applications**. !["Applications" item in the Okta Dashboard navigation bar](/assets/images/help/saml/okta-applications.png)
+1. No painel do Okta, clique em **Aplicativos**. ![Item "Aplicativos" na barra de navegação do Painel do Okta](/assets/images/help/saml/okta-applications.png)
diff --git a/translations/pt-BR/data/reusables/saml/okta-edit-provisioning.md b/translations/pt-BR/data/reusables/saml/okta-edit-provisioning.md
index 5d49374c8e2c..c7114b781c6d 100644
--- a/translations/pt-BR/data/reusables/saml/okta-edit-provisioning.md
+++ b/translations/pt-BR/data/reusables/saml/okta-edit-provisioning.md
@@ -1,5 +1,5 @@
-10. To the right of "Provisioning to App", click **Edit**. !["Edit" button for Okta application's provisioning options](/assets/images/help/saml/okta-provisioning-to-app-edit-button.png)
-11. To the right of "Create Users", select **Enable**. !["Enable" checkbox for Okta application's "Create Users" option](/assets/images/help/saml/okta-provisioning-enable-create-users.png)
-12. To the right of "Update User Attributes", select **Enable**. !["Enable" checkbox for Okta application's "Update User Attributes" option](/assets/images/help/saml/okta-provisioning-enable-update-user-attributes.png)
-13. To the right of "Deactivate Users", select **Enable**. !["Enable" checkbox for Okta application's "Deactivate Users" option](/assets/images/help/saml/okta-provisioning-enable-deactivate-users.png)
-14. Clique em **Salvar**. !["Save" button for Okta application's provisioning configuration](/assets/images/help/saml/okta-provisioning-save.png)
\ No newline at end of file
+10. À direita do "Provisionamento para o App", clique em **Editar**. ![Botão "Editar" para opções de provisionamento do aplicativo do Okta](/assets/images/help/saml/okta-provisioning-to-app-edit-button.png)
+11. À direita de "Criar usuários", selecione **Habilitar**. ![Caixa de seleção "Habilitar" para a opção de "Criar usuários" do aplicativo do Okta](/assets/images/help/saml/okta-provisioning-enable-create-users.png)
+12. À direita de "Atualizar Atributos do Usuário", selecione **Habilitar**. ![Caixa de seleção "Habilitar" para a opção de "Atualizar atributos do usuário " do aplicativo do Okta](/assets/images/help/saml/okta-provisioning-enable-update-user-attributes.png)
+13. À direita de "Desativar Usuários", selecione **Habilitar**. ![Caixa de seleção "Habilitar" para a opção de "Desativar usuários" do aplicativo do Okta](/assets/images/help/saml/okta-provisioning-enable-deactivate-users.png)
+14. Clique em **Salvar**. ![Botão "Salvar" para opções de provisionamento de configuração do aplicativo do Okta](/assets/images/help/saml/okta-provisioning-save.png)
diff --git a/translations/pt-BR/data/reusables/saml/okta-enable-api-integration.md b/translations/pt-BR/data/reusables/saml/okta-enable-api-integration.md
index b07c86537920..3326bd11e573 100644
--- a/translations/pt-BR/data/reusables/saml/okta-enable-api-integration.md
+++ b/translations/pt-BR/data/reusables/saml/okta-enable-api-integration.md
@@ -1 +1 @@
-1. Select **Enable API integration**. !["Enable API integration" checkbox for Okta application](/assets/images/help/saml/okta-enable-api-integration.png)
\ No newline at end of file
+1. Selecione **Habilitar a integração da API**. ![Caixa de seleção "Habilitar a integração da API" para o aplicativo do Okta](/assets/images/help/saml/okta-enable-api-integration.png)
diff --git a/translations/pt-BR/data/reusables/saml/okta-provisioning-tab.md b/translations/pt-BR/data/reusables/saml/okta-provisioning-tab.md
index f4a8f6cca707..94d6035e9aaf 100644
--- a/translations/pt-BR/data/reusables/saml/okta-provisioning-tab.md
+++ b/translations/pt-BR/data/reusables/saml/okta-provisioning-tab.md
@@ -1 +1 @@
-1. Under the name of the application, click **Provisioning**. !["Provisioning" tab for Okta application](/assets/images/help/saml/okta-provisioning-tab.png)
\ No newline at end of file
+1. No nome do aplicativo, clique em **Provisionamento**. ![Aba "Provisionamento" guia para o aplicativo do Okta](/assets/images/help/saml/okta-provisioning-tab.png)
diff --git a/translations/pt-BR/data/reusables/saml/okta-save-provisioning.md b/translations/pt-BR/data/reusables/saml/okta-save-provisioning.md
index 55d248d266f9..e4d33979dd59 100644
--- a/translations/pt-BR/data/reusables/saml/okta-save-provisioning.md
+++ b/translations/pt-BR/data/reusables/saml/okta-save-provisioning.md
@@ -1 +1 @@
-1. Clique em **Salvar**. !["Save" button for Okta application's provisioning configuration](/assets/images/help/saml/okta-provisioning-tab-save.png)
\ No newline at end of file
+1. Clique em **Salvar**. ![Botão "Salvar" para opções de provisionamento de configuração do aplicativo do Okta](/assets/images/help/saml/okta-provisioning-tab-save.png)
diff --git a/translations/pt-BR/data/reusables/saml/okta-sign-on-tab.md b/translations/pt-BR/data/reusables/saml/okta-sign-on-tab.md
index 99468b5e5a09..2ab1b6eb57c6 100644
--- a/translations/pt-BR/data/reusables/saml/okta-sign-on-tab.md
+++ b/translations/pt-BR/data/reusables/saml/okta-sign-on-tab.md
@@ -1 +1 @@
-1. Under the name of the application, click **Sign on**. !["Sign on" tab for Okta application](/assets/images/help/saml/okta-sign-on-tab.png)
\ No newline at end of file
+1. No nome do aplicativo, clique em **Iniciar sessão**. ![Aba "Fazer login" para o aplicativo do Okta](/assets/images/help/saml/okta-sign-on-tab.png)
diff --git a/translations/pt-BR/data/reusables/saml/okta-view-setup-instructions.md b/translations/pt-BR/data/reusables/saml/okta-view-setup-instructions.md
index 085e62499c25..90514e7788af 100644
--- a/translations/pt-BR/data/reusables/saml/okta-view-setup-instructions.md
+++ b/translations/pt-BR/data/reusables/saml/okta-view-setup-instructions.md
@@ -1 +1 @@
-1. Under "SIGN ON METHODS", click **View Setup Instructions**. !["View Setup Instructions" button in Okta application's "Sign On" tab](/assets/images/help/saml/okta-view-setup-instructions.png)
\ No newline at end of file
+1. Em "MÉTODOS DO INÍCIO DE SESSÃO", clique em **Ver instruções de instalação**. ![Botão "Visualizar instruções de configuração" na aba "Iniciar sessão" do aplicativo do Okta](/assets/images/help/saml/okta-view-setup-instructions.png)
diff --git a/translations/pt-BR/data/reusables/saml/outside-collaborators-exemption.md b/translations/pt-BR/data/reusables/saml/outside-collaborators-exemption.md
index 4b9dc120d2f6..7d2af0b17df1 100644
--- a/translations/pt-BR/data/reusables/saml/outside-collaborators-exemption.md
+++ b/translations/pt-BR/data/reusables/saml/outside-collaborators-exemption.md
@@ -1,5 +1,5 @@
 {% note %}
 
-**Note:** Outside collaborators aren't required to authenticate with an IdP to access the resources in an organization with SAML SSO. Para obter mais informações sobre colaboradores externos, consulte "[Níveis de permissão para uma organização](/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization#outside-collaborators)".
+**Observação:** Os colaboradores externos não são obrigados a efetuar a autenticação com um IdP para acessar os recursos de uma organização com SSO do SAML. Para obter mais informações sobre colaboradores externos, consulte "[Níveis de permissão para uma organização](/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization#outside-collaborators)".
 
 {% endnote %}
diff --git a/translations/pt-BR/data/reusables/saml/revoke-authorized-credentials.md b/translations/pt-BR/data/reusables/saml/revoke-authorized-credentials.md
index 212a9bf05169..1c9947d0aa00 100644
--- a/translations/pt-BR/data/reusables/saml/revoke-authorized-credentials.md
+++ b/translations/pt-BR/data/reusables/saml/revoke-authorized-credentials.md
@@ -1 +1 @@
-1. To revoke credentials, to the right of the credentials you'd like to revoke, click **Revoke**. ![Revoke button](/assets/images/help/saml/revoke-credentials.png)
+1. Para revogar as credenciais, à direita das credenciais que você deseja revogar, clique em **Revogar**. ![Botão de revogar](/assets/images/help/saml/revoke-credentials.png)
diff --git a/translations/pt-BR/data/reusables/saml/revoke-saml-session.md b/translations/pt-BR/data/reusables/saml/revoke-saml-session.md
index 7c96db38bf77..821945a8f802 100644
--- a/translations/pt-BR/data/reusables/saml/revoke-saml-session.md
+++ b/translations/pt-BR/data/reusables/saml/revoke-saml-session.md
@@ -1 +1 @@
-1. To revoke a session, to the right of the session you'd like to revoke, click **Revoke**. ![Revoke button](/assets/images/help/saml/revoke-session.png)
+1. Para revogar uma sessão, à direita da sessão que você deseja revogar, clique em **Revogar**. ![Botão de revogar](/assets/images/help/saml/revoke-session.png)
diff --git a/translations/pt-BR/data/reusables/saml/revoke-sso-identity.md b/translations/pt-BR/data/reusables/saml/revoke-sso-identity.md
index 35c8cfe2651e..913004d6a2a1 100644
--- a/translations/pt-BR/data/reusables/saml/revoke-sso-identity.md
+++ b/translations/pt-BR/data/reusables/saml/revoke-sso-identity.md
@@ -1 +1 @@
-1. To revoke the linked identity, to the right of the identity, click **Revoke**. ![Revoke button](/assets/images/help/saml/revoke-identity.png)
+1. Para revogar a identidade vinculada, à direita da identidade, clique em **Revogar**. ![Botão de revogar](/assets/images/help/saml/revoke-identity.png)
diff --git a/translations/pt-BR/data/reusables/saml/saml-identity-linked.md b/translations/pt-BR/data/reusables/saml/saml-identity-linked.md
index 850892549df7..5de9708e37e3 100644
--- a/translations/pt-BR/data/reusables/saml/saml-identity-linked.md
+++ b/translations/pt-BR/data/reusables/saml/saml-identity-linked.md
@@ -1 +1 @@
-1. In the left sidebar, click **SAML identity linked**. ![SAML identity linked](/assets/images/help/saml/saml-identity-linked.png)
+1. Na barra lateral esquerda, clique em **Identidade do SAML vinculada**. ![Identidade do SAML vinculada](/assets/images/help/saml/saml-identity-linked.png)
diff --git a/translations/pt-BR/data/reusables/saml/saml-session-oauth.md b/translations/pt-BR/data/reusables/saml/saml-session-oauth.md
index 6e5d67ac2623..4f00428cfa9a 100644
--- a/translations/pt-BR/data/reusables/saml/saml-session-oauth.md
+++ b/translations/pt-BR/data/reusables/saml/saml-session-oauth.md
@@ -1 +1 @@
-If you belong to any organizations that enforce SAML single sign-on, you may be prompted to authenticate through your identity provider before you can authorize an {% data variables.product.prodname_oauth_app %}. For more information about SAML, see "[About authentication with SAML single sign-on](/github/authenticating-to-github/about-authentication-with-saml-single-sign-on)."
+Se você pertence a alguma organização que force o logon único SAML, pode ser que seja solicitado que você efetue a autenticação por meio do seu provedor de identidade antes de você poder autorizar um {% data variables.product.prodname_oauth_app %}. Para obter mais informações sobre o SAML, consulte "[Sobre autenticação com o logon único SAML](/github/authenticating-to-github/about-authentication-with-saml-single-sign-on)".
diff --git a/translations/pt-BR/data/reusables/saml/saml-single-logout-not-supported.md b/translations/pt-BR/data/reusables/saml/saml-single-logout-not-supported.md
index a9a628ca4556..b359ca0169ac 100644
--- a/translations/pt-BR/data/reusables/saml/saml-single-logout-not-supported.md
+++ b/translations/pt-BR/data/reusables/saml/saml-single-logout-not-supported.md
@@ -1 +1 @@
-{% data variables.product.product_name %} does not support SAML Single Logout. To terminate an active SAML session, users should log out directly on your SAML IdP.
+{% data variables.product.product_name %} não é compatível com o logout único SAML. Para finalizar uma sessão do SAML ativa, os usuários devem efetuar o logout diretamente no seu IdP do SAML.
diff --git a/translations/pt-BR/data/reusables/saml/saml-supported-idps.md b/translations/pt-BR/data/reusables/saml/saml-supported-idps.md
index e790ac95dbd5..0ada7cb55c7c 100644
--- a/translations/pt-BR/data/reusables/saml/saml-supported-idps.md
+++ b/translations/pt-BR/data/reusables/saml/saml-supported-idps.md
@@ -1,4 +1,4 @@
-We offer limited support for all identity providers that implement the SAML 2.0 standard. We officially support these identity providers that have been internally tested:
+Oferecemos suporte limitado para todos os provedores de identidade que implementam o padrão SAML 2.0. Apoiamos oficialmente esses provedores de identidade que foram testados internamente:
 - Active Directory Federation Services (AD FS)
 - Azure Active Directory (Azure AD)
 - Okta
diff --git a/translations/pt-BR/data/reusables/saml/search-ghec-okta.md b/translations/pt-BR/data/reusables/saml/search-ghec-okta.md
index c0881a1727f6..5f9eeac6b602 100644
--- a/translations/pt-BR/data/reusables/saml/search-ghec-okta.md
+++ b/translations/pt-BR/data/reusables/saml/search-ghec-okta.md
@@ -1 +1 @@
-3. In the search field, type "GitHub Enterprise Cloud". ![Okta's "Search for an application" field](/assets/images/help/saml/okta-search-for-an-application.png)
\ No newline at end of file
+3. No campo de busca, digite "GitHub Enterprise Cloud". ![Campo "Procurar um campo de aplicativo" do Okta](/assets/images/help/saml/okta-search-for-an-application.png)
diff --git a/translations/pt-BR/data/reusables/saml/testing-saml-sso.md b/translations/pt-BR/data/reusables/saml/testing-saml-sso.md
index 3129fa8d30ca..b41e50008b46 100644
--- a/translations/pt-BR/data/reusables/saml/testing-saml-sso.md
+++ b/translations/pt-BR/data/reusables/saml/testing-saml-sso.md
@@ -1 +1 @@
-When setting up SAML SSO in your organization, you can test your implementation without affecting your organization members by leaving  **Require SAML SSO authentication for all members of the _organization name_ organization** unchecked.
+Ao configurar o SSO do SAML na sua organização, você pode testar sua implementação sem afetar os integrantes da sua organização, deixando **Exigir autenticação do SSO do SAML para todos os integrantes da organização _nome da organização_** desmarcada.
diff --git a/translations/pt-BR/data/reusables/saml/use-classic-ui.md b/translations/pt-BR/data/reusables/saml/use-classic-ui.md
index abf6ff92c43b..49be154ea4a8 100644
--- a/translations/pt-BR/data/reusables/saml/use-classic-ui.md
+++ b/translations/pt-BR/data/reusables/saml/use-classic-ui.md
@@ -1,3 +1,3 @@
-You must use the "Classic UI" in Okta. For more information, see [Organized Navigation](https://developer.okta.com/blog/2017/09/25/all-new-developer-console#new-look--feel) on the Okta blog.
+Você deve usar a "Interface Clássica" no Okta. Para obter mais informações, consulte [Navegação Organizada](https://developer.okta.com/blog/2017/09/25/all-new-developer-console#new-look--feel) no blog do Okta.
 
-![Selecting "Classic UI" from Okta UI style picker above dashboard](/assets/images/help/saml/okta-classic-ui.png)
\ No newline at end of file
+![Selecionar "Interface de usuário clássica" do seletor de estilo da interface de usuário do Okta acima do painel](/assets/images/help/saml/okta-classic-ui.png)
diff --git a/translations/pt-BR/data/reusables/saml/view-authorized-credentials.md b/translations/pt-BR/data/reusables/saml/view-authorized-credentials.md
index 4645965bf167..c017329d4a82 100644
--- a/translations/pt-BR/data/reusables/saml/view-authorized-credentials.md
+++ b/translations/pt-BR/data/reusables/saml/view-authorized-credentials.md
@@ -1 +1 @@
-1. Under "Authorized credentials", view the authorized credentials for the member.
+1. Em "Credenciais autorizadas", veja as credenciais autorizadas para o integrante.
diff --git a/translations/pt-BR/data/reusables/saml/view-saml-sessions.md b/translations/pt-BR/data/reusables/saml/view-saml-sessions.md
index 5ab58c5ce871..230605f97b8c 100644
--- a/translations/pt-BR/data/reusables/saml/view-saml-sessions.md
+++ b/translations/pt-BR/data/reusables/saml/view-saml-sessions.md
@@ -1 +1 @@
-1. Under "Active SAML sessions", view the active SAML sessions for the member.
+1. Em "Sessões ativas do SAML", veja as sessões ativas do SAML para o integrante.
diff --git a/translations/pt-BR/data/reusables/saml/view-sso-identity.md b/translations/pt-BR/data/reusables/saml/view-sso-identity.md
index ecfd085312d4..36f84126f31e 100644
--- a/translations/pt-BR/data/reusables/saml/view-sso-identity.md
+++ b/translations/pt-BR/data/reusables/saml/view-sso-identity.md
@@ -1 +1 @@
-1. Under "Linked SSO identity", view the linked SSO identity for the member.
+1. Na "Identidade SSO vinculada", veja a identidade SSO vinculada para o integrante.
diff --git a/translations/pt-BR/data/reusables/scim/enterprise-account-scim.md b/translations/pt-BR/data/reusables/scim/enterprise-account-scim.md
index 41d1a43470e4..dc31d9dfd5fe 100644
--- a/translations/pt-BR/data/reusables/scim/enterprise-account-scim.md
+++ b/translations/pt-BR/data/reusables/scim/enterprise-account-scim.md
@@ -1 +1 @@
-If you're participating in the private beta for user provisioning for enterprise accounts, when you enable SAML for your enterprise account, SCIM provisioning and deprovisioning is enabled by default in {% data variables.product.product_name %}. You can use provisioning to manage organization membership by configuring SCIM in your IdP.
\ No newline at end of file
+Se você estiver participando do beta privado para o provisionamento de contas corporativas, ao habilitar o SAML para a sua conta corporativa, o provisionamento e desprovisionamento do SCIM é habilitado por padrão em {% data variables.product.product_name %}. Você pode usar o provisionamento para gerenciar a associação à organização, configurando o SCIM no seu IdP.
diff --git a/translations/pt-BR/data/reusables/search/date_gt_lt.md b/translations/pt-BR/data/reusables/search/date_gt_lt.md
index 960f02127d00..43292355c914 100644
--- a/translations/pt-BR/data/reusables/search/date_gt_lt.md
+++ b/translations/pt-BR/data/reusables/search/date_gt_lt.md
@@ -1 +1 @@
-Dates support [greater than, less than, and range qualifiers](/articles/understanding-the-search-syntax).
+Datas são compatíveis com os [qualificadores maior que, menor que e de intervalo](/articles/understanding-the-search-syntax).
diff --git a/translations/pt-BR/data/reusables/search/requested_reviews_search.md b/translations/pt-BR/data/reusables/search/requested_reviews_search.md
index f617c70112d4..98b78fa11c51 100644
--- a/translations/pt-BR/data/reusables/search/requested_reviews_search.md
+++ b/translations/pt-BR/data/reusables/search/requested_reviews_search.md
@@ -1 +1 @@
-You can find a pull request where you or a team you're a member of is requested for review with the search qualifier `review-requested:[USERNAME]` or `team-review-requested:[TEAMNAME]`. Para obter mais informações, consulte "[Pesquisa de problemas e pull requests](/articles/searching-issues-and-pull-requests)".
+Você pode encontrar um pull request em que você ou uma equipe de que você é integrante é solicitado para revisão com o qualificador de pesquisa `review-requested:[USERNAME]` ou `team-review-requested:[TEAMNAME]`. Para obter mais informações, consulte "[Pesquisa de problemas e pull requests](/articles/searching-issues-and-pull-requests)".
diff --git a/translations/pt-BR/data/reusables/search/requested_reviews_search_tip.md b/translations/pt-BR/data/reusables/search/requested_reviews_search_tip.md
index 251a16122401..fd237bc75d93 100644
--- a/translations/pt-BR/data/reusables/search/requested_reviews_search_tip.md
+++ b/translations/pt-BR/data/reusables/search/requested_reviews_search_tip.md
@@ -1,5 +1,5 @@
 {% tip %}
 
-**Tip:** You can find a pull request where you or a team you're a member of is requested for review with the search qualifier `review-requested:[USERNAME]` or `team-review-requested:[TEAMNAME]`. Para obter mais informações, consulte "[Pesquisa de problemas e pull requests](/articles/searching-issues-and-pull-requests)".
+**Dica:** É possível encontrar um pull request em que você ou uma equipe da qual você é membro é solicitado para revisão com o qualificador de pesquisa `review-requested:[USERNAME]` ou `team-review-requested:[TEAMNAME]`. Para obter mais informações, consulte "[Pesquisa de problemas e pull requests](/articles/searching-issues-and-pull-requests)".
 
 {% endtip %}
diff --git a/translations/pt-BR/data/reusables/search/search_issues_and_pull_requests_shortcut.md b/translations/pt-BR/data/reusables/search/search_issues_and_pull_requests_shortcut.md
index d1c1bcaf40e6..71deea2aa854 100644
--- a/translations/pt-BR/data/reusables/search/search_issues_and_pull_requests_shortcut.md
+++ b/translations/pt-BR/data/reusables/search/search_issues_and_pull_requests_shortcut.md
@@ -1 +1 @@
-You can focus your cursor on the search bar above the issue or pull request list with a keyboard shortcut. Para obter mais informações, consulte "[Atalhos de teclado](/articles/keyboard-shortcuts/#issue-and-pull-request-lists)".
+Você pode focar o cursor na barra de pesquisa acima da lista de problemas ou pull request com um atalho de teclado. Para obter mais informações, consulte "[Atalhos de teclado](/articles/keyboard-shortcuts/#issue-and-pull-request-lists)".
diff --git a/translations/pt-BR/data/reusables/secret-scanning/beta.md b/translations/pt-BR/data/reusables/secret-scanning/beta.md
index 463eb4babac2..2c7ead33b1a5 100644
--- a/translations/pt-BR/data/reusables/secret-scanning/beta.md
+++ b/translations/pt-BR/data/reusables/secret-scanning/beta.md
@@ -1,5 +1,5 @@
 {% note %}
 
-**Note:** {% data variables.product.prodname_secret_scanning_caps %} for private repositories is currently in beta and subject to change. Para solicitar acesso ao beta, [join the waitlist](https://github.com/features/security/advanced-security/signup).
+**Observação:** {% data variables.product.prodname_secret_scanning_caps %} para repositórios privados está atualmente em beta e sujeitos a alterações. Para solicitar acesso ao beta, [join the waitlist](https://github.com/features/security/advanced-security/signup).
 
-{% endnote %}
\ No newline at end of file
+{% endnote %}
diff --git a/translations/pt-BR/data/reusables/security-advisory/security-researcher-cannot-create-advisory.md b/translations/pt-BR/data/reusables/security-advisory/security-researcher-cannot-create-advisory.md
index cb1b6b59bfbc..64bd41bb21fd 100644
--- a/translations/pt-BR/data/reusables/security-advisory/security-researcher-cannot-create-advisory.md
+++ b/translations/pt-BR/data/reusables/security-advisory/security-researcher-cannot-create-advisory.md
@@ -1,5 +1,5 @@
 {% note %}
 
-**Note:** If you are a security researcher, you should directly contact maintainers to ask them to create security advisories or issue CVEs on your behalf in repositories that you don't administer.
+**Observação:** Se você é um pesquisador de segurança, você deve entrar em contato diretamente com os mantenedores para pedir que criem consultorias de segurança ou emitirem CVEs em seu nome em repositórios que você não administra.
 
 {% endnote %}
diff --git a/translations/pt-BR/data/reusables/security/security-and-analysis-features-enable-read-only.md b/translations/pt-BR/data/reusables/security/security-and-analysis-features-enable-read-only.md
index 34ccd94fd4d5..b6d5e569d88f 100644
--- a/translations/pt-BR/data/reusables/security/security-and-analysis-features-enable-read-only.md
+++ b/translations/pt-BR/data/reusables/security/security-and-analysis-features-enable-read-only.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-If you enable security and analysis features, {% data variables.product.company_short %} performs read-only analysis on your repository. For more information, see "[About {% data variables.product.company_short %}'s use of your data](/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data)."
-{% endif %}
\ No newline at end of file
+Se você habilitar os recursos de segurança e análise,
+{% data variables.product.company_short %} realiza uma análise somente leitura no seu repositório. Para obter mais informações, consulte "[Sobre a utilização de seus dados de {% data variables.product.company_short %}".](/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data)
+{% endif %}
diff --git a/translations/pt-BR/data/reusables/security/some-security-and-analysis-features-are-enabled-by-default.md b/translations/pt-BR/data/reusables/security/some-security-and-analysis-features-are-enabled-by-default.md
index 9da98434c375..fff14d2294e9 100644
--- a/translations/pt-BR/data/reusables/security/some-security-and-analysis-features-are-enabled-by-default.md
+++ b/translations/pt-BR/data/reusables/security/some-security-and-analysis-features-are-enabled-by-default.md
@@ -1,5 +1,5 @@
 {% note %}
 
-**Note**: You can't disable some security and analysis features that are enabled by default for public repositories.
+**Nota**: Você não pode desabilitar alguns recursos de segurança e análise que estão habilitados por padrão para repositórios públicos.
 
 {% endnote %}
diff --git a/translations/pt-BR/data/reusables/shortdesc/authenticating_github_app.md b/translations/pt-BR/data/reusables/shortdesc/authenticating_github_app.md
index 2bd7cd6418ac..e519ce02eaaf 100644
--- a/translations/pt-BR/data/reusables/shortdesc/authenticating_github_app.md
+++ b/translations/pt-BR/data/reusables/shortdesc/authenticating_github_app.md
@@ -1 +1 @@
-For information on how to authenticate as a GitHub App, see "[Authentication Options for GitHub Apps](/apps/building-github-apps/authentication-options-for-github-apps#authenticating-as-a-github-app)."
+Para obter informações sobre como efetuar a autenticação como um aplicativo GitHub, consulte "[Opções de autenticação para aplicativos GitHub](/apps/building-github-apps/authentication-options-for-github-apps#authenticating-as-a-github-app)".
diff --git a/translations/pt-BR/data/reusables/shortdesc/authenticating_with_github_apps.md b/translations/pt-BR/data/reusables/shortdesc/authenticating_with_github_apps.md
index 8e70dfde227e..142326879f61 100644
--- a/translations/pt-BR/data/reusables/shortdesc/authenticating_with_github_apps.md
+++ b/translations/pt-BR/data/reusables/shortdesc/authenticating_with_github_apps.md
@@ -1 +1 @@
-You can authenticate as a {% data variables.product.prodname_github_app %} or as an installation.
+Você pode efetuar a autenticação como uma {% data variables.product.prodname_github_app %} ou como uma instalação.
diff --git a/translations/pt-BR/data/reusables/shortdesc/authorizing_oauth_apps.md b/translations/pt-BR/data/reusables/shortdesc/authorizing_oauth_apps.md
index 09e76d7eae1b..8dd5a2d2c8ee 100644
--- a/translations/pt-BR/data/reusables/shortdesc/authorizing_oauth_apps.md
+++ b/translations/pt-BR/data/reusables/shortdesc/authorizing_oauth_apps.md
@@ -1 +1 @@
-You can enable other users to authorize your OAuth App.
+Você pode habilitar outros usuários para autorizar o seu aplicativo OAuth.
diff --git a/translations/pt-BR/data/reusables/shortdesc/creating_custom_badges_github_apps.md b/translations/pt-BR/data/reusables/shortdesc/creating_custom_badges_github_apps.md
index b988f3ab5c76..67fd709eb7eb 100644
--- a/translations/pt-BR/data/reusables/shortdesc/creating_custom_badges_github_apps.md
+++ b/translations/pt-BR/data/reusables/shortdesc/creating_custom_badges_github_apps.md
@@ -1 +1 @@
-You can replace the default badge on your GitHub App by uploading your own logo image and customizing the background.
+Você pode substituir o selo-padrão no seu aplicativo GitHub fazendo o upload da sua própria imagem de logotipo e personalizando o plano de fundo.
diff --git a/translations/pt-BR/data/reusables/shortdesc/creating_custom_badges_oauth_apps.md b/translations/pt-BR/data/reusables/shortdesc/creating_custom_badges_oauth_apps.md
index f2c602b885b4..f84dfc2fbf09 100644
--- a/translations/pt-BR/data/reusables/shortdesc/creating_custom_badges_oauth_apps.md
+++ b/translations/pt-BR/data/reusables/shortdesc/creating_custom_badges_oauth_apps.md
@@ -1 +1 @@
-You can replace the default badge on your OAuth App by uploading your own logo image and customizing the background.
+Você pode substituir o selo-padrão no seu aplicativo OAuth fazendo o upload da sua própria imagem de logotipo e personalizando o plano de fundo.
diff --git a/translations/pt-BR/data/reusables/shortdesc/creating_github_apps.md b/translations/pt-BR/data/reusables/shortdesc/creating_github_apps.md
index a9b51d1a039c..d4af6f95a023 100644
--- a/translations/pt-BR/data/reusables/shortdesc/creating_github_apps.md
+++ b/translations/pt-BR/data/reusables/shortdesc/creating_github_apps.md
@@ -1 +1 @@
-You can create and register a GitHub App under your personal account or under any organization you have administrative access to.
+Você pode criar e registrar um aplicativo GitHub na sua conta pessoal em sob qualquer organização à qual você tem acesso administrativo.
diff --git a/translations/pt-BR/data/reusables/shortdesc/creating_oauth_apps.md b/translations/pt-BR/data/reusables/shortdesc/creating_oauth_apps.md
index 16fc0410092d..519dc6e063ac 100644
--- a/translations/pt-BR/data/reusables/shortdesc/creating_oauth_apps.md
+++ b/translations/pt-BR/data/reusables/shortdesc/creating_oauth_apps.md
@@ -1 +1 @@
-You can create and register an OAuth App under your personal account or under any organization you have administrative access to. While creating your OAuth app, remember to protect your privacy by only using information you consider public.
+Você pode criar e registrar um aplicativo OAuth na sua conta pessoal ou em qualquer organização à qual você tem acesso administrativo. Ao criar o seu aplicativo OAuth, lembre-se de proteger sua privacidade usando apenas as informações que você considera públicas.
diff --git a/translations/pt-BR/data/reusables/shortdesc/deleting_github_apps.md b/translations/pt-BR/data/reusables/shortdesc/deleting_github_apps.md
index fcc568a45b3c..50190db89715 100644
--- a/translations/pt-BR/data/reusables/shortdesc/deleting_github_apps.md
+++ b/translations/pt-BR/data/reusables/shortdesc/deleting_github_apps.md
@@ -1 +1 @@
-You can delete GitHub Apps when you no longer use them.
+Você pode excluir aplicativos GitHub quando não os usar mais.
diff --git a/translations/pt-BR/data/reusables/shortdesc/deleting_oauth_apps.md b/translations/pt-BR/data/reusables/shortdesc/deleting_oauth_apps.md
index 61efb0b05597..5c7f9053f66b 100644
--- a/translations/pt-BR/data/reusables/shortdesc/deleting_oauth_apps.md
+++ b/translations/pt-BR/data/reusables/shortdesc/deleting_oauth_apps.md
@@ -1 +1 @@
-You can delete OAuth Apps when you no longer use them.
+Você pode excluir aplicativos OAuth quando não os usar mais.
diff --git a/translations/pt-BR/data/reusables/shortdesc/editing_permissions_for_github_apps.md b/translations/pt-BR/data/reusables/shortdesc/editing_permissions_for_github_apps.md
index e8c900f1e485..53ce2eea2a22 100644
--- a/translations/pt-BR/data/reusables/shortdesc/editing_permissions_for_github_apps.md
+++ b/translations/pt-BR/data/reusables/shortdesc/editing_permissions_for_github_apps.md
@@ -1 +1 @@
-After registering a GitHub App, you can modify your app's permissions.
+Após registrar um aplicativo GitHub, você pode modificar as permissões do seu aplicativo.
diff --git a/translations/pt-BR/data/reusables/shortdesc/identifying_and_authorizing_github_apps.md b/translations/pt-BR/data/reusables/shortdesc/identifying_and_authorizing_github_apps.md
index 8753f972a4aa..1092da16e6fd 100644
--- a/translations/pt-BR/data/reusables/shortdesc/identifying_and_authorizing_github_apps.md
+++ b/translations/pt-BR/data/reusables/shortdesc/identifying_and_authorizing_github_apps.md
@@ -1 +1 @@
-Your GitHub App can perform actions on behalf of a user, like creating an issue, creating a deployment, and using other supported endpoints.
+O seu aplicativo GitHub pode executar ações em nome de um usuário, como criar um problema, criar uma implementação e usar outros pontos de extremidade compatíveis.
diff --git a/translations/pt-BR/data/reusables/shortdesc/iso_8601.md b/translations/pt-BR/data/reusables/shortdesc/iso_8601.md
index 2d4ea9acb4eb..463da5ebeb89 100644
--- a/translations/pt-BR/data/reusables/shortdesc/iso_8601.md
+++ b/translations/pt-BR/data/reusables/shortdesc/iso_8601.md
@@ -1 +1 @@
-Este é um registro de hora no formato [ISO 8601:](https://en.wikipedia.org/wiki/ISO_8601) `YYYY-MM-DDTHH:MM:SSZ`.
\ No newline at end of file
+Este é um registro de hora no formato [ISO 8601:](https://en.wikipedia.org/wiki/ISO_8601) `YYYY-MM-DDTHH:MM:SSZ`.
diff --git a/translations/pt-BR/data/reusables/shortdesc/making-a-github-app-public-or-private.md b/translations/pt-BR/data/reusables/shortdesc/making-a-github-app-public-or-private.md
index b715bb3db7ee..79823d2f5ae4 100644
--- a/translations/pt-BR/data/reusables/shortdesc/making-a-github-app-public-or-private.md
+++ b/translations/pt-BR/data/reusables/shortdesc/making-a-github-app-public-or-private.md
@@ -1 +1 @@
-When setting up a GitHub App, you can make its installation public so any GitHub user or organization can install the app, or private so you can only install it on the account that created it.
+Ao configurar um aplicativo GitHub, você pode tornar a instalação pública para que qualquer usuário ou organização do GitHub possa instalar o aplicativo, ou tornar a instalação privada para que você só possa instalá-lo na conta que o criou.
diff --git a/translations/pt-BR/data/reusables/shortdesc/modifying_github_apps.md b/translations/pt-BR/data/reusables/shortdesc/modifying_github_apps.md
index 9986f7af6194..2dd1d29e4082 100644
--- a/translations/pt-BR/data/reusables/shortdesc/modifying_github_apps.md
+++ b/translations/pt-BR/data/reusables/shortdesc/modifying_github_apps.md
@@ -1 +1 @@
-After creating a GitHub App, you can make changes to it.
+Depois de criar um aplicativo GitHub, você pode fazer alterações nele.
diff --git a/translations/pt-BR/data/reusables/shortdesc/modifying_oauth_apps.md b/translations/pt-BR/data/reusables/shortdesc/modifying_oauth_apps.md
index 85907ba04ee4..b9188cae655e 100644
--- a/translations/pt-BR/data/reusables/shortdesc/modifying_oauth_apps.md
+++ b/translations/pt-BR/data/reusables/shortdesc/modifying_oauth_apps.md
@@ -1 +1 @@
-After creating and registering an OAuth App, you can make changes to it.
+Depois de criar e registrar um aplicativo OAuth, você pode fazer alterações nele.
diff --git a/translations/pt-BR/data/reusables/shortdesc/permissions_github_apps.md b/translations/pt-BR/data/reusables/shortdesc/permissions_github_apps.md
index fe03198b1a95..ec3efa523788 100644
--- a/translations/pt-BR/data/reusables/shortdesc/permissions_github_apps.md
+++ b/translations/pt-BR/data/reusables/shortdesc/permissions_github_apps.md
@@ -1 +1 @@
-When you create a GitHub App, you set the permissions that define the resources the app can access via the REST API.
+Ao criar um aplicativo GitHub, você define as permissões que definem os recursos que o aplicativo pode acessar através da API REST.
diff --git a/translations/pt-BR/data/reusables/shortdesc/rate_limits_github_apps.md b/translations/pt-BR/data/reusables/shortdesc/rate_limits_github_apps.md
index bcba4f706af6..85f102a33cab 100644
--- a/translations/pt-BR/data/reusables/shortdesc/rate_limits_github_apps.md
+++ b/translations/pt-BR/data/reusables/shortdesc/rate_limits_github_apps.md
@@ -1 +1 @@
-Rate limits for GitHub Apps help control the rate of traffic.
+Os limites de taxa para os aplicativos GitHub ajudam a controlar a taxa de tráfego.
diff --git a/translations/pt-BR/data/reusables/shortdesc/suspending_a_github_app.md b/translations/pt-BR/data/reusables/shortdesc/suspending_a_github_app.md
index 4f8e97721730..6c5f8fd984b7 100644
--- a/translations/pt-BR/data/reusables/shortdesc/suspending_a_github_app.md
+++ b/translations/pt-BR/data/reusables/shortdesc/suspending_a_github_app.md
@@ -1 +1 @@
-You can temporarily block a {% data variables.product.prodname_github_app %}'s access to your account's resources by suspending the app.
+Você pode bloquear temporariamente o acesso de {% data variables.product.prodname_github_app %} aos recursos da sua conta ao suspender o aplicativo.
diff --git a/translations/pt-BR/data/reusables/shortdesc/transferring_ownership_of_github_apps.md b/translations/pt-BR/data/reusables/shortdesc/transferring_ownership_of_github_apps.md
index b8693c927858..de6064015400 100644
--- a/translations/pt-BR/data/reusables/shortdesc/transferring_ownership_of_github_apps.md
+++ b/translations/pt-BR/data/reusables/shortdesc/transferring_ownership_of_github_apps.md
@@ -1 +1 @@
-You can transfer ownership of a GitHub App to another user or organization.
+Você pode transferir a propriedade de um aplicativo GitHub para outro usuário ou organização.
diff --git a/translations/pt-BR/data/reusables/shortdesc/transferring_ownership_of_oauth_apps.md b/translations/pt-BR/data/reusables/shortdesc/transferring_ownership_of_oauth_apps.md
index 464804504756..a51306040f1e 100644
--- a/translations/pt-BR/data/reusables/shortdesc/transferring_ownership_of_oauth_apps.md
+++ b/translations/pt-BR/data/reusables/shortdesc/transferring_ownership_of_oauth_apps.md
@@ -1 +1 @@
-You can transfer ownership of an OAuth App to another user or organization.
+Você pode transferir a propriedade de um aplicativo OAuth para outro usuário ou organização.
diff --git a/translations/pt-BR/data/reusables/shortdesc/troubleshooting_access_token_reques_errors_oauth_apps.md b/translations/pt-BR/data/reusables/shortdesc/troubleshooting_access_token_reques_errors_oauth_apps.md
index ab1aaac67eef..09f790ef4e2c 100644
--- a/translations/pt-BR/data/reusables/shortdesc/troubleshooting_access_token_reques_errors_oauth_apps.md
+++ b/translations/pt-BR/data/reusables/shortdesc/troubleshooting_access_token_reques_errors_oauth_apps.md
@@ -1 +1 @@
-When exchanging a code for an access token, there are an additional set of errors that can occur. The format of these responses is determined by the accept header you pass.
+Ao trocar um código para um token de acesso, há um conjunto adicional de erros que podem ocorrer. O formato dessas respostas é determinado pelo cabeçalho aceito que você passa.
diff --git a/translations/pt-BR/data/reusables/shortdesc/troubleshooting_authorization_request_errors_oauth_apps.md b/translations/pt-BR/data/reusables/shortdesc/troubleshooting_authorization_request_errors_oauth_apps.md
index fb7ef66aad29..ef1d834a0c21 100644
--- a/translations/pt-BR/data/reusables/shortdesc/troubleshooting_authorization_request_errors_oauth_apps.md
+++ b/translations/pt-BR/data/reusables/shortdesc/troubleshooting_authorization_request_errors_oauth_apps.md
@@ -1 +1 @@
-When obtaining an OAuth token for a user, some errors may occur during the initial authorization request phase.
+Ao obter um token do OAuth para um usuário, alguns erros podem ocorrer durante a fase inicial da solicitação de autorização.
diff --git a/translations/pt-BR/data/reusables/shortdesc/understanding_scopes_for_oauth_apps.md b/translations/pt-BR/data/reusables/shortdesc/understanding_scopes_for_oauth_apps.md
index 477fc8cb9ef3..feaedbd0f075 100644
--- a/translations/pt-BR/data/reusables/shortdesc/understanding_scopes_for_oauth_apps.md
+++ b/translations/pt-BR/data/reusables/shortdesc/understanding_scopes_for_oauth_apps.md
@@ -1 +1 @@
-Scopes let you specify exactly what type of access you need. Scopes _limit_ access for OAuth tokens. They do not grant any additional permission beyond that which the user already has.
+Os escopos permitem especificar exatamente que tipo de acesso você precisa. Os escopos _limitam_ o acesso para tokens do OAuth. Não concedem qualquer autorização adicional para além da que o usuário já possui.
diff --git a/translations/pt-BR/data/reusables/sponsors/accept-legal-terms.md b/translations/pt-BR/data/reusables/sponsors/accept-legal-terms.md
index d1538aa73322..a0f36d1cb055 100644
--- a/translations/pt-BR/data/reusables/sponsors/accept-legal-terms.md
+++ b/translations/pt-BR/data/reusables/sponsors/accept-legal-terms.md
@@ -1 +1 @@
-1. Review the [{% data variables.product.prodname_sponsors %} Additional Terms](/github/site-policy/github-sponsors-additional-terms) and [{% data variables.product.prodname_dotcom %} Privacy Statement](/articles/github-privacy-statement), then click **Join the waitlist**.
+1. Revise os [ Termos adicionais de {% data variables.product.prodname_sponsors %}](/github/site-policy/github-sponsors-additional-terms) e a [Declaração de privacidade de {% data variables.product.prodname_dotcom %}](/articles/github-privacy-statement) e, em seguida, clique em **Juntar-se à lista de espera**.
diff --git a/translations/pt-BR/data/reusables/sponsors/add-active-triggers.md b/translations/pt-BR/data/reusables/sponsors/add-active-triggers.md
index 490b3a82ca90..6acf60a2d596 100644
--- a/translations/pt-BR/data/reusables/sponsors/add-active-triggers.md
+++ b/translations/pt-BR/data/reusables/sponsors/add-active-triggers.md
@@ -1 +1 @@
-1. To receive updates for the SponsorshipEvent, select **Active**. ![Selecting active events](/assets/images/help/sponsors/webhook-active.png)
+1. Para receber atualizações do Evento de Patrocínio, selecione **ativo**. ![Selecionar eventos ativos](/assets/images/help/sponsors/webhook-active.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/add-introduction.md b/translations/pt-BR/data/reusables/sponsors/add-introduction.md
index 7855f0e4f5cf..e7356d043ebd 100644
--- a/translations/pt-BR/data/reusables/sponsors/add-introduction.md
+++ b/translations/pt-BR/data/reusables/sponsors/add-introduction.md
@@ -1 +1 @@
-1. Under "Introduction", type a description of the work you'll do with your sponsorships. ![Profile details text field](/assets/images/help/sponsors/introduction-box.png)
+1. Em "Introdução", digite uma descrição do trabalho que você fará com seus patrocínios. ![Campo de texto para informações de perfil](/assets/images/help/sponsors/introduction-box.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/add-more-tiers.md b/translations/pt-BR/data/reusables/sponsors/add-more-tiers.md
index 85eea2fbe215..102c81c85ff2 100644
--- a/translations/pt-BR/data/reusables/sponsors/add-more-tiers.md
+++ b/translations/pt-BR/data/reusables/sponsors/add-more-tiers.md
@@ -1 +1 @@
-  1. Repeat the steps above until you've published all the tiers you want to offer.
+  1. Repita os passos acima até que você tenha publicado todas as camadas que deseja oferecer.
diff --git a/translations/pt-BR/data/reusables/sponsors/change-tier.md b/translations/pt-BR/data/reusables/sponsors/change-tier.md
index 9770dfebd107..5902c35ca3d9 100644
--- a/translations/pt-BR/data/reusables/sponsors/change-tier.md
+++ b/translations/pt-BR/data/reusables/sponsors/change-tier.md
@@ -1 +1 @@
-1. Under "{% data variables.product.prodname_sponsors %}", to the right of the sponsored open source contributor, click {% octicon "triangle-down" aria-label="The down triangle octicon" %} next to your sponsored amount, then click **Change tier**. ![Change tier button](/assets/images/help/billing/edit-sponsor-billing.png)
+1. Em "{% data variables.product.prodname_sponsors %}", à direita do colaborador de código aberto patrocinado, clique em {% octicon "triangle-down" aria-label="The down triangle octicon" %} ao lado do valor patrocinado e, em seguida, clique em **Alterar a camada**. ![Botão de alterar camada](/assets/images/help/billing/edit-sponsor-billing.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/click-add-tier.md b/translations/pt-BR/data/reusables/sponsors/click-add-tier.md
index 3b8ad38edfcd..5be8d9c9279c 100644
--- a/translations/pt-BR/data/reusables/sponsors/click-add-tier.md
+++ b/translations/pt-BR/data/reusables/sponsors/click-add-tier.md
@@ -1 +1 @@
-1. On the bottom of the page, click **Add a tier**. ![Add a tier button](/assets/images/help/sponsors/add-a-tier-button.png)
+1. Na parte inferior da página, clique em **Adicionar uma camada**. ![Botão adicionar camada](/assets/images/help/sponsors/add-a-tier-button.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/confirm-add-webhook.md b/translations/pt-BR/data/reusables/sponsors/confirm-add-webhook.md
index f2157ed8be4e..8677b07c26e6 100644
--- a/translations/pt-BR/data/reusables/sponsors/confirm-add-webhook.md
+++ b/translations/pt-BR/data/reusables/sponsors/confirm-add-webhook.md
@@ -1 +1 @@
-1. Click **Create webhook**. ![Create webhook button in the Webhooks sidebar](/assets/images/help/sponsors/create-webhook-sponsors-button.png)
+1. Clique em **Criar webhook**. ![Botão Criar webhook na barra lateral de Webhooks](/assets/images/help/sponsors/create-webhook-sponsors-button.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/country-of-residence.md b/translations/pt-BR/data/reusables/sponsors/country-of-residence.md
index 4b237730e8cc..f1386c6cac91 100644
--- a/translations/pt-BR/data/reusables/sponsors/country-of-residence.md
+++ b/translations/pt-BR/data/reusables/sponsors/country-of-residence.md
@@ -1,2 +1,2 @@
-1. Under "Country or region of residence", use the drop-down menu, and select your residential location. ![Country or region of residence drop-down](/assets/images/help/sponsors/country-of-residence-drop-down.png)
+1. Em "País ou região de residência", use o menu suspenso e selecione o seu domicílio. ![Menu suspenso de país ou região de residência](/assets/images/help/sponsors/country-of-residence-drop-down.png)
 2. Clique em **Salvar**.
diff --git a/translations/pt-BR/data/reusables/sponsors/create-stripe-account.md b/translations/pt-BR/data/reusables/sponsors/create-stripe-account.md
index 48fed9dba322..dd8b5bc62b7b 100644
--- a/translations/pt-BR/data/reusables/sponsors/create-stripe-account.md
+++ b/translations/pt-BR/data/reusables/sponsors/create-stripe-account.md
@@ -1,2 +1,2 @@
-1. Click **Stripe Connect account**. ![Link to create Stripe Connect account](/assets/images/help/sponsors/create-stripe-connect-account.png)
-2. Follow the prompts to create your account.
+1. Clique em **Conta de Stripe Connect**. ![Link para criar uma conta de Stripe Connect](/assets/images/help/sponsors/create-stripe-connect-account.png)
+2. Siga as instruções para criar a sua conta.
diff --git a/translations/pt-BR/data/reusables/sponsors/developer-sponsored-choose-updates.md b/translations/pt-BR/data/reusables/sponsors/developer-sponsored-choose-updates.md
index 91531dda0e76..85c28dc164f9 100644
--- a/translations/pt-BR/data/reusables/sponsors/developer-sponsored-choose-updates.md
+++ b/translations/pt-BR/data/reusables/sponsors/developer-sponsored-choose-updates.md
@@ -1 +1 @@
-4. Decide whether you want to receive email updates from the sponsored developer, then select or unselect "Receive updates from _DEVELOPER_." ![Caixa de seleção para receber atualizações do desenvolvedor patrocinado](/assets/images/help/sponsors/updates-checkbox-manage.png)
+4. Decida se deseja receber atualizações por e-mail do desenvolvedor patrocinado e, em seguida, selecione ou desmarque a opção "Receber atualizações do _DESENVOLVEDOR_". ![Caixa de seleção para receber atualizações do desenvolvedor patrocinado](/assets/images/help/sponsors/updates-checkbox-manage.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/edit-featured-work.md b/translations/pt-BR/data/reusables/sponsors/edit-featured-work.md
index 6272fd015c8b..b99485be6468 100644
--- a/translations/pt-BR/data/reusables/sponsors/edit-featured-work.md
+++ b/translations/pt-BR/data/reusables/sponsors/edit-featured-work.md
@@ -1,3 +1,3 @@
-1. Optionally, choose the repositories that are showcased on your {% data variables.product.prodname_sponsors %} profile.
-    - To the right of "Featured work", click **Edit**. ![Edit button for featured work](/assets/images/help/sponsors/featured-work-edit-button.png)
-    - Select up to 6 repositories, then click **Save**. ![Checkboxes to select repositories](/assets/images/help/sponsors/featured-work-select.png)
\ No newline at end of file
+1. Opcionalmente, escolha os repositórios que são exibidos no seu perfil de {% data variables.product.prodname_sponsors %}.
+    - À direita do "Trabalho em Destaque", clique em **Editar**. ![Botão de editar para trabalho em destaque](/assets/images/help/sponsors/featured-work-edit-button.png)
+    - Selecione até 6 repositórios e, em seguida, clique em **Salvar**. ![Caixas de seleção para selecionar os repositórios](/assets/images/help/sponsors/featured-work-select.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/edit-goal.md b/translations/pt-BR/data/reusables/sponsors/edit-goal.md
index ef52b7ce8e7e..38fc8253630e 100644
--- a/translations/pt-BR/data/reusables/sponsors/edit-goal.md
+++ b/translations/pt-BR/data/reusables/sponsors/edit-goal.md
@@ -1 +1 @@
-1. To the right of your goal, click **Edit**. ![Botão editar](/assets/images/help/sponsors/edit-goal-button.png)
+1. À direita do seu objetivo, clique em **Editar**. ![Botão editar](/assets/images/help/sponsors/edit-goal-button.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/edit-tier.md b/translations/pt-BR/data/reusables/sponsors/edit-tier.md
index cf55ea765374..f0a4c37189b0 100644
--- a/translations/pt-BR/data/reusables/sponsors/edit-tier.md
+++ b/translations/pt-BR/data/reusables/sponsors/edit-tier.md
@@ -1 +1 @@
-1. To the right of the tier you want to edit, click **Edit**. ![Botão Edit tier (Editar nível)](/assets/images/help/sponsors/edit-tier-button.png)
+1. À direita da camada que você deseja editar, clique em **Editar**. ![Botão Edit tier (Editar nível)](/assets/images/help/sponsors/edit-tier-button.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/github-contact-applicants.md b/translations/pt-BR/data/reusables/sponsors/github-contact-applicants.md
index 78cd9405db3f..169a2e317eb0 100644
--- a/translations/pt-BR/data/reusables/sponsors/github-contact-applicants.md
+++ b/translations/pt-BR/data/reusables/sponsors/github-contact-applicants.md
@@ -1 +1 @@
-{% data variables.product.prodname_dotcom %} may contact {% data variables.product.prodname_sponsors %} applicants or participants for additional information regarding their sponsorship profile or activity to determine eligibility for sponsorship or matching, or as part of investigating potential terms violations.
+{% data variables.product.prodname_dotcom %} pode entrar em contato com candidatos ou participantes de {% data variables.product.prodname_sponsors %} para obter informações adicionais sobre o seu perfil de patrocínio ou atividade para determinar a elegibilidade para patrocínio ou correspondência, ou como parte da investigação de possíveis violações dos termos.
diff --git a/translations/pt-BR/data/reusables/sponsors/legal-additional-terms.md b/translations/pt-BR/data/reusables/sponsors/legal-additional-terms.md
index 434fee48afe6..2d52036f2512 100644
--- a/translations/pt-BR/data/reusables/sponsors/legal-additional-terms.md
+++ b/translations/pt-BR/data/reusables/sponsors/legal-additional-terms.md
@@ -1 +1 @@
-The {% data variables.product.prodname_matching_fund %} is a gift designed to encourage community funding of work on open source and is subject to additional terms and conditions. For detailed information about the {% data variables.product.prodname_matching_fund %}, see the "[{% data variables.product.prodname_sponsors %} Additional Terms](/github/site-policy/github-sponsors-additional-terms)."
+O {% data variables.product.prodname_matching_fund %} é um presente projetado para incentivar o financiamento da comunidade para trabalhos de código aberto e está sujeito a termos e condições adicionais. Para obter informações detalhadas sobre {% data variables.product.prodname_matching_fund %}, consulte os "[Termos adicionais de {% data variables.product.prodname_sponsors %}](/github/site-policy/github-sponsors-additional-terms)".
diff --git a/translations/pt-BR/data/reusables/sponsors/manage-developer-sponsorship.md b/translations/pt-BR/data/reusables/sponsors/manage-developer-sponsorship.md
index ca2e8c2013a7..02c9eeee4bd7 100644
--- a/translations/pt-BR/data/reusables/sponsors/manage-developer-sponsorship.md
+++ b/translations/pt-BR/data/reusables/sponsors/manage-developer-sponsorship.md
@@ -1,2 +1,2 @@
-1. Under the developer's name, click **Sponsoring**. ![Sponsoring button](/assets/images/help/profile/sponsoring-button.png)
-2. On the right side of the page, click **Manage your sponsorship**. ![Manage your sponsorship button](/assets/images/help/sponsors/manage-your-sponsorship-button.png)
+1. No nome do desenvolvedor, clique em **Patrocinar**. ![Botão de Patrocínio](/assets/images/help/profile/sponsoring-button.png)
+2. No lado direito da página, clique em **Gerenciar seu patrocínio**. ![Botão de gerenciar o seu patrocínio](/assets/images/help/sponsors/manage-your-sponsorship-button.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/manage-existing-webhooks.md b/translations/pt-BR/data/reusables/sponsors/manage-existing-webhooks.md
index 5099afa28731..92dd552090a6 100644
--- a/translations/pt-BR/data/reusables/sponsors/manage-existing-webhooks.md
+++ b/translations/pt-BR/data/reusables/sponsors/manage-existing-webhooks.md
@@ -1 +1 @@
-1. To edit an existing webhook, click **Edit**. To remove an existing webhook, click **Delete**. ![Buttons for managing webhook](/assets/images/help/sponsors/webhook-edit-delete-button.png)
+1. Para editar um webhook existente, clique em **Editar**. Para remover um webhook existente, clique em **Excluir**. ![Botões para gerenciar webhook](/assets/images/help/sponsors/webhook-edit-delete-button.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/manage-org-sponsorship.md b/translations/pt-BR/data/reusables/sponsors/manage-org-sponsorship.md
index ed426f42be45..98c01e49e7ed 100644
--- a/translations/pt-BR/data/reusables/sponsors/manage-org-sponsorship.md
+++ b/translations/pt-BR/data/reusables/sponsors/manage-org-sponsorship.md
@@ -1,2 +1,2 @@
-1. Next to the organization's name, click **Sponsoring**. ![Sponsoring button](/assets/images/help/sponsors/org-sponsoring-button.png)
-2. On the right side of the page, click **Manage your sponsorship**. ![Manage your sponsorship button](/assets/images/help/sponsors/manage-your-sponsorship-button.png)
+1. Ao lado do nome da organização, clique em **Patrocínio**. ![Botão de Patrocínio](/assets/images/help/sponsors/org-sponsoring-button.png)
+2. No lado direito da página, clique em **Gerenciar seu patrocínio**. ![Botão de gerenciar o seu patrocínio](/assets/images/help/sponsors/manage-your-sponsorship-button.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/matching-fund-eligible.md b/translations/pt-BR/data/reusables/sponsors/matching-fund-eligible.md
index 0f4d492bcf40..7c516c9ccf42 100644
--- a/translations/pt-BR/data/reusables/sponsors/matching-fund-eligible.md
+++ b/translations/pt-BR/data/reusables/sponsors/matching-fund-eligible.md
@@ -1 +1 @@
-Eligibility for the {% data variables.product.prodname_matching_fund %} has passed. Applications received after the January 1, 2020 deadline are not eligible for {% data variables.product.prodname_matching_fund %}.
+A elegibilidade para o {% data variables.product.prodname_matching_fund %} foi finalizada. Os aplicativos recebidos após o prazo de 1 de janeiro 2020 não são elegíveis para {% data variables.product.prodname_matching_fund %}.
diff --git a/translations/pt-BR/data/reusables/sponsors/maximum-tier.md b/translations/pt-BR/data/reusables/sponsors/maximum-tier.md
index a787f1dd0a5f..4b151d90ea17 100644
--- a/translations/pt-BR/data/reusables/sponsors/maximum-tier.md
+++ b/translations/pt-BR/data/reusables/sponsors/maximum-tier.md
@@ -1 +1 @@
-The maximum price is US$6000 per month.
+O preço máximo é US$ 6.000 por mês.
diff --git a/translations/pt-BR/data/reusables/sponsors/meet-the-team.md b/translations/pt-BR/data/reusables/sponsors/meet-the-team.md
index 3edbfe23bdc8..a98b0c17bce4 100644
--- a/translations/pt-BR/data/reusables/sponsors/meet-the-team.md
+++ b/translations/pt-BR/data/reusables/sponsors/meet-the-team.md
@@ -1,5 +1,5 @@
-1. Optionally, choose the organization members that are highlighted on your {% data variables.product.prodname_sponsors %} profile.
-    - To the right of "Meet the team", click **Edit**.  
-      ![Edit organization members to profile button](/assets/images/help/sponsors/edit-org-members-profile-button.png)
-    - Select up to six organization members, then click **Save**. ![Select highlighted organization members](/assets/images/help/sponsors/select-highlighted-org-members.png)
-    - Optionally, under each highlighted member's name, type a description of the member. ![Description for highlighted organization members](/assets/images/help/sponsors/description-highlighted-org-members.png)
\ No newline at end of file
+1. Opcionalmente, escolha os integrantes da organização destacados no seu perfil de {% data variables.product.prodname_sponsors %}.
+    - À direita de "Conheça a equipe", clique em **Editar**.  
+      ![Botão de editar integrantes da organização no perfil](/assets/images/help/sponsors/edit-org-members-profile-button.png)
+    - Selecione até seis integrantes da organização e, em seguida, clique em **Salvar**. ![Selecione os integrantes da organização destacados](/assets/images/help/sponsors/select-highlighted-org-members.png)
+    - Opcionalmente, no o nome de cada integrante destacado, digite uma descrição do integrante. ![Descrição para os integrantes da organização destacados](/assets/images/help/sponsors/description-highlighted-org-members.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/navigate-to-dev-sponsors-dashboard.md b/translations/pt-BR/data/reusables/sponsors/navigate-to-dev-sponsors-dashboard.md
index 415ba1fd53c6..f7819bcd8699 100644
--- a/translations/pt-BR/data/reusables/sponsors/navigate-to-dev-sponsors-dashboard.md
+++ b/translations/pt-BR/data/reusables/sponsors/navigate-to-dev-sponsors-dashboard.md
@@ -1,2 +1,2 @@
 1. No canto superior direito de qualquer página, clique na sua foto do perfil e depois em **{% data variables.product.prodname_sponsors %}**. ![Botão {% data variables.product.prodname_sponsors %}](/assets/images/help/sponsors/access-github-sponsors-dashboard.png)
-2. If a list of your sponsored and eligible accounts is shown, to the right of your account name, click **Dashboard**. ![Botão do painel de patrocinadores de desenvolvedor](/assets/images/help/sponsors/dev-sponsors-dashboard-button.png)
+2. Se uma lista de suas contas patrocinadas e elegíveis for exibida, à direita do nome de sua conta, clique em **Painel**. ![Botão do painel de patrocinadores de desenvolvedor](/assets/images/help/sponsors/dev-sponsors-dashboard-button.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/navigate-to-github-sponsors.md b/translations/pt-BR/data/reusables/sponsors/navigate-to-github-sponsors.md
index 4a0805daed4f..cd293a8f325d 100644
--- a/translations/pt-BR/data/reusables/sponsors/navigate-to-github-sponsors.md
+++ b/translations/pt-BR/data/reusables/sponsors/navigate-to-github-sponsors.md
@@ -1 +1 @@
-1. Navigate to [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors).
+1. Acesse [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors).
diff --git a/translations/pt-BR/data/reusables/sponsors/navigate-to-org-sponsors-dashboard.md b/translations/pt-BR/data/reusables/sponsors/navigate-to-org-sponsors-dashboard.md
index 0d0940a57885..7a02bff313bf 100644
--- a/translations/pt-BR/data/reusables/sponsors/navigate-to-org-sponsors-dashboard.md
+++ b/translations/pt-BR/data/reusables/sponsors/navigate-to-org-sponsors-dashboard.md
@@ -1,2 +1,2 @@
 1. No canto superior direito de qualquer página, clique na sua foto do perfil e depois em **{% data variables.product.prodname_sponsors %}**. ![Botão {% data variables.product.prodname_sponsors %}](/assets/images/help/sponsors/access-github-sponsors-dashboard.png)
-2. In the list of your sponsored and eligible accounts, to the right of the organization, click **Dashboard**. ![Organization sponsors dashboard button](/assets/images/help/sponsors/org-sponsors-dashboard-button.png)
+2. Na lista de contas patrocinadas e elegíveis, à direita da organização, clique em **Painel**. ![Botão do painel de patrocinadores da organização](/assets/images/help/sponsors/org-sponsors-dashboard-button.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/navigate-to-payouts-tab.md b/translations/pt-BR/data/reusables/sponsors/navigate-to-payouts-tab.md
index ae42bab26e26..b7bf4048c569 100644
--- a/translations/pt-BR/data/reusables/sponsors/navigate-to-payouts-tab.md
+++ b/translations/pt-BR/data/reusables/sponsors/navigate-to-payouts-tab.md
@@ -1 +1 @@
-1. On the left sidebar, click **Payouts**. ![Sponsor tiers tab](/assets/images/help/sponsors/payouts-tab.png)
+1. Na barra lateral esquerda, clique em **Pagamentos**. ![Aba de camadas do patrocínio](/assets/images/help/sponsors/payouts-tab.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/navigate-to-profile-tab.md b/translations/pt-BR/data/reusables/sponsors/navigate-to-profile-tab.md
index b018f85c05d2..e32fc8e2620c 100644
--- a/translations/pt-BR/data/reusables/sponsors/navigate-to-profile-tab.md
+++ b/translations/pt-BR/data/reusables/sponsors/navigate-to-profile-tab.md
@@ -1 +1 @@
-1. On the left sidebar, click **Profile details**. ![Profile details tab](/assets/images/help/sponsors/profile-tab.png)
+1. Na barra lateral esquerda, clique em **Detalhes do perfil**. ![Aba Detalhes do Perfil](/assets/images/help/sponsors/profile-tab.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/navigate-to-sponsor-tiers-tab.md b/translations/pt-BR/data/reusables/sponsors/navigate-to-sponsor-tiers-tab.md
index 327f21fd23f0..d5768698284f 100644
--- a/translations/pt-BR/data/reusables/sponsors/navigate-to-sponsor-tiers-tab.md
+++ b/translations/pt-BR/data/reusables/sponsors/navigate-to-sponsor-tiers-tab.md
@@ -1 +1 @@
-1. On the left sidebar, click **Sponsor tiers**. ![Sponsor tiers tab](/assets/images/help/sponsors/sponsor-tiers-tab.png)
+1. Na barra lateral esquerda, clique em **Camadas de patrocínio**. ![Aba de camadas do patrocínio](/assets/images/help/sponsors/sponsor-tiers-tab.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/navigate-to-sponsored-org.md b/translations/pt-BR/data/reusables/sponsors/navigate-to-sponsored-org.md
index 6acd162cfd4a..0f81fd2c9d6d 100644
--- a/translations/pt-BR/data/reusables/sponsors/navigate-to-sponsored-org.md
+++ b/translations/pt-BR/data/reusables/sponsors/navigate-to-sponsored-org.md
@@ -1 +1 @@
-1. On {% data variables.product.product_name %}, navigate to the sponsored organization's profile.
+1. Em {% data variables.product.product_name %}, acesse o perfil da organização patrocinada.
diff --git a/translations/pt-BR/data/reusables/sponsors/navigate-to-sponsors-tab.md b/translations/pt-BR/data/reusables/sponsors/navigate-to-sponsors-tab.md
index 2d92deff6b1b..e19180204b27 100644
--- a/translations/pt-BR/data/reusables/sponsors/navigate-to-sponsors-tab.md
+++ b/translations/pt-BR/data/reusables/sponsors/navigate-to-sponsors-tab.md
@@ -1 +1 @@
-3. In the left sidebar, click **Your sponsors**. ![Guia Sponsors (Patrocinadores)](/assets/images/help/sponsors/sponsors-tab.png)
+3. Na barra lateral esquerda, clique em **Seus patrocinadores**. ![Guia Sponsors (Patrocinadores)](/assets/images/help/sponsors/sponsors-tab.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/navigate-to-webhooks-tab.md b/translations/pt-BR/data/reusables/sponsors/navigate-to-webhooks-tab.md
index 77d129a730bc..837dd4c65aae 100644
--- a/translations/pt-BR/data/reusables/sponsors/navigate-to-webhooks-tab.md
+++ b/translations/pt-BR/data/reusables/sponsors/navigate-to-webhooks-tab.md
@@ -1 +1 @@
-3. In the left sidebar, click **Webhooks**. ![Webhooks tab](/assets/images/help/sponsors/webhooks-tab.png)
+3. Na barra lateral esquerda, clique em **Webhooks**. ![Aba Webhooks](/assets/images/help/sponsors/webhooks-tab.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/navigate-to-your-goals-tab.md b/translations/pt-BR/data/reusables/sponsors/navigate-to-your-goals-tab.md
index fec98000f9b6..050b3747d58a 100644
--- a/translations/pt-BR/data/reusables/sponsors/navigate-to-your-goals-tab.md
+++ b/translations/pt-BR/data/reusables/sponsors/navigate-to-your-goals-tab.md
@@ -1 +1 @@
-1. In the left sidebar, click **Your goals**. ![Your goals tab](/assets/images/help/sponsors/your-goals-tab.png)
\ No newline at end of file
+1. Na barra lateral esquerda, clique em **Suas metas**. ![Aba Suas metas](/assets/images/help/sponsors/your-goals-tab.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/no-fees.md b/translations/pt-BR/data/reusables/sponsors/no-fees.md
index a122d94bbbb1..1bbcc16c970a 100644
--- a/translations/pt-BR/data/reusables/sponsors/no-fees.md
+++ b/translations/pt-BR/data/reusables/sponsors/no-fees.md
@@ -1 +1 @@
-{% data variables.product.prodname_sponsors %} does not charge any fees for sponsorships from user accounts, so 100% of these sponsorships go to the sponsored developer or organization.
+{% data variables.product.prodname_sponsors %} não cobra taxas por patrocínios de contas de usuários. Portanto, 100% desse patrocínio vai para o desenvolvedor ou organização patrocinada.
diff --git a/translations/pt-BR/data/reusables/sponsors/opt-in-to-being-featured.md b/translations/pt-BR/data/reusables/sponsors/opt-in-to-being-featured.md
index bbd09ae633ec..e1d9c97aa317 100644
--- a/translations/pt-BR/data/reusables/sponsors/opt-in-to-being-featured.md
+++ b/translations/pt-BR/data/reusables/sponsors/opt-in-to-being-featured.md
@@ -1 +1 @@
-1. Optionally, select **Opt-in to potentially being featured on github.com/sponsors**. ![Checkbox to opt-in to being featured](/assets/images/help/sponsors/opt-in-to-being-featured.png)
\ No newline at end of file
+1. Opcionalmente, selecione **Optar por participar para ser potencialmente destacado em github.com/sponsors**. ![Caixa de seleção para optar por ser destacado](/assets/images/help/sponsors/opt-in-to-being-featured.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/org-sponsored-choose-updates.md b/translations/pt-BR/data/reusables/sponsors/org-sponsored-choose-updates.md
index 80603ffa45de..5002d7f0bba8 100644
--- a/translations/pt-BR/data/reusables/sponsors/org-sponsored-choose-updates.md
+++ b/translations/pt-BR/data/reusables/sponsors/org-sponsored-choose-updates.md
@@ -1 +1 @@
-4. Decide whether you want to receive email updates from the sponsored organization, then select or unselect "Receive updates from _ORGANIZATION_." ![Checkbox to receive updates from sponsored organization](/assets/images/help/sponsors/org-updates-checkbox-manage.png)
+4. Decida se deseja receber atualizações por e-mail da organização patrocinada e, em seguida, selecione ou desmarque "Receber atualizações da _ORGANIZAÇÃO_". ![Caixa de seleção para receber atualizações da organização patrocinada](/assets/images/help/sponsors/org-updates-checkbox-manage.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/overview-tab.md b/translations/pt-BR/data/reusables/sponsors/overview-tab.md
index 111a33e6dfbf..3f10b7081f50 100644
--- a/translations/pt-BR/data/reusables/sponsors/overview-tab.md
+++ b/translations/pt-BR/data/reusables/sponsors/overview-tab.md
@@ -1 +1 @@
-1. In the left sidebar, click **Overview**. ![Overview tab](/assets/images/help/sponsors/overview-tab.png)
+1. Na barra lateral esquerda, clique em **Visão geral**. ![Aba Visão geral](/assets/images/help/sponsors/overview-tab.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/payout-info.md b/translations/pt-BR/data/reusables/sponsors/payout-info.md
index f2e4ba89de2c..8b0368950176 100644
--- a/translations/pt-BR/data/reusables/sponsors/payout-info.md
+++ b/translations/pt-BR/data/reusables/sponsors/payout-info.md
@@ -1 +1 @@
-For information about timing for payments from {% data variables.product.prodname_sponsors %}, see "[GitHub Sponsors Additional Terms](/github/site-policy/github-sponsors-additional-terms#43-payment-timing)."
+Para obter informações sobre o tempo dos pagamentos de {% data variables.product.prodname_sponsors %}, consulte "[Termos adicionais do GitHub Sponsors](/github/site-policy/github-sponsors-additional-terms#43-payment-timing)".
diff --git a/translations/pt-BR/data/reusables/sponsors/publish-goal.md b/translations/pt-BR/data/reusables/sponsors/publish-goal.md
index 1bc7e6329e29..247c1a887d37 100644
--- a/translations/pt-BR/data/reusables/sponsors/publish-goal.md
+++ b/translations/pt-BR/data/reusables/sponsors/publish-goal.md
@@ -1 +1 @@
-1. Click **Publish**. ![Botão Publish (Publicar)](/assets/images/help/sponsors/publish-goal-button.png)
\ No newline at end of file
+1. Clique em **Publicar**. ![Botão Publish (Publicar)](/assets/images/help/sponsors/publish-goal-button.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/publish-sponsor-update.md b/translations/pt-BR/data/reusables/sponsors/publish-sponsor-update.md
index 3a0f6c101c30..3fe055fe6724 100644
--- a/translations/pt-BR/data/reusables/sponsors/publish-sponsor-update.md
+++ b/translations/pt-BR/data/reusables/sponsors/publish-sponsor-update.md
@@ -1 +1 @@
-7. Click **Publish**.
+7. Clique em **Publicar**.
diff --git a/translations/pt-BR/data/reusables/sponsors/retire-goal.md b/translations/pt-BR/data/reusables/sponsors/retire-goal.md
index bf0e01c5a3ce..7814aeacd339 100644
--- a/translations/pt-BR/data/reusables/sponsors/retire-goal.md
+++ b/translations/pt-BR/data/reusables/sponsors/retire-goal.md
@@ -1,2 +1,2 @@
-1. At the bottom of the page, click **Retire**. ![The Retire button](/assets/images/help/sponsors/retire-goal-button.png)
-2. Read the warning, then click **OK**. ![Warning about retiring a goal](/assets/images/help/sponsors/confirm-retire-goal.png)
\ No newline at end of file
+1. Na parte inferior da página, clique em **Retirar**. ![O botão de Retirar](/assets/images/help/sponsors/retire-goal-button.png)
+2. Leia o alerta e clique em **OK**. ![Aviso sobre a remoção de uma meta](/assets/images/help/sponsors/confirm-retire-goal.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/retire-tier.md b/translations/pt-BR/data/reusables/sponsors/retire-tier.md
index 1889c70b9047..650b08cb42d1 100644
--- a/translations/pt-BR/data/reusables/sponsors/retire-tier.md
+++ b/translations/pt-BR/data/reusables/sponsors/retire-tier.md
@@ -1 +1 @@
-7. To retire a tier, click **Retire tier**, then click **OK**. ![Botão Retire tier (Retirar camada)](/assets/images/help/sponsors/retire-tier-button.png)
+7. Para retirar uma camada, clique em **Retirar camada** e, em seguida, clique em **OK**. ![Botão Retire tier (Retirar camada)](/assets/images/help/sponsors/retire-tier-button.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/review-and-publish-tier.md b/translations/pt-BR/data/reusables/sponsors/review-and-publish-tier.md
index 6d239c691902..cc7f62fd6945 100644
--- a/translations/pt-BR/data/reusables/sponsors/review-and-publish-tier.md
+++ b/translations/pt-BR/data/reusables/sponsors/review-and-publish-tier.md
@@ -1 +1 @@
-1. Proofread your tier, then click **Publish tier**. ![Publish tier button](/assets/images/help/sponsors/publish-tier-button.png)
+1. Revise a sua camada e, em seguida, clique em **Publicar camada**. ![Botão Publicar camada](/assets/images/help/sponsors/publish-tier-button.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/save-profile.md b/translations/pt-BR/data/reusables/sponsors/save-profile.md
index 3e876e2e33bd..7d676b018628 100644
--- a/translations/pt-BR/data/reusables/sponsors/save-profile.md
+++ b/translations/pt-BR/data/reusables/sponsors/save-profile.md
@@ -1 +1 @@
-1. Clique em **Update profile** (Atualizar perfil).
\ No newline at end of file
+1. Clique em **Update profile** (Atualizar perfil).
diff --git a/translations/pt-BR/data/reusables/sponsors/save-tier-draft.md b/translations/pt-BR/data/reusables/sponsors/save-tier-draft.md
index 82a35cee3b8c..e03d471a28e7 100644
--- a/translations/pt-BR/data/reusables/sponsors/save-tier-draft.md
+++ b/translations/pt-BR/data/reusables/sponsors/save-tier-draft.md
@@ -1 +1 @@
-1. Click **Save draft**. ![Save draft button](/assets/images/help/sponsors/save-tier-draft.png)
+1. Clique em **Salvar rascunho**. ![Botão Salvar rascunho](/assets/images/help/sponsors/save-tier-draft.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/select-a-tier.md b/translations/pt-BR/data/reusables/sponsors/select-a-tier.md
index 6ba1b8d427f2..4755b2ee8000 100644
--- a/translations/pt-BR/data/reusables/sponsors/select-a-tier.md
+++ b/translations/pt-BR/data/reusables/sponsors/select-a-tier.md
@@ -1 +1 @@
-1. On the right side of the page, under "Select a tier", review the sponsorship tiers available. Then, to the right of the tier you want, click **Select**. ![Select a tier box](/assets/images/help/sponsors/select-a-tier-box.png)
+1. No lado direito da página, em "Selecione uma camada", reveja as camadas de patrocínio disponíveis. Em seguida, à direita da camada que você quer, clique em **Selecionar**. ![Selecione uma caixa de camada](/assets/images/help/sponsors/select-a-tier-box.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/select-goal-type.md b/translations/pt-BR/data/reusables/sponsors/select-goal-type.md
index e0c1bc315341..ba87f0f10ca1 100644
--- a/translations/pt-BR/data/reusables/sponsors/select-goal-type.md
+++ b/translations/pt-BR/data/reusables/sponsors/select-goal-type.md
@@ -1,4 +1,4 @@
-1. Under "What is your goal based on?", select **Number of sponsors** or **Sponsorships a month**. ![Available goal types ](/assets/images/help/sponsors/select-goal-type.png)
-2. Type the number of sponsors you'd like to have, or the monthly amount you're aiming for.
-3. Under "Describe your goal", type a description for your goal. ![Goal settings](/assets/images/help/sponsors/goal-settings.png)
-5. If you chose a goal based on sponsorships per month, select "I understand that this will publicly display how much sponsorship funds I receive each month". ![Checkbox that you understand your sponsorships fund will be published](/assets/images/help/sponsors/sponsorships-published-checkbox.png)
+1. Em "Em que se baseia a sua meta?", selecione **Número de patrocinadores** ou **Patrocínios por mês**. ![Tipos de metas disponíveis ](/assets/images/help/sponsors/select-goal-type.png)
+2. Digite o número de patrocinadores que você gostaria de ter, ou o valor mensal que você procura.
+3. Em "Descreva a sua meta", digite uma descrição para sua meta. ![Configurações de meta](/assets/images/help/sponsors/goal-settings.png)
+5. Se você escolheu uma meta baseada em patrocínios por mês, selecione "Eu entendo que isto mostrará publicamente quantos fundos de patrocínio eu recebo todos os meses". ![Caixa de seleção em que aceita que o seu fundo de patrocínio será publicado](/assets/images/help/sponsors/sponsorships-published-checkbox.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/set-a-goal.md b/translations/pt-BR/data/reusables/sponsors/set-a-goal.md
index 4d4098c6af11..b41e56ab3257 100644
--- a/translations/pt-BR/data/reusables/sponsors/set-a-goal.md
+++ b/translations/pt-BR/data/reusables/sponsors/set-a-goal.md
@@ -1 +1 @@
-1. Under "Your goals", click **Set a goal**. ![Set a goal button ](/assets/images/help/sponsors/set-a-goal-button.png)
\ No newline at end of file
+1. Em "Suas metas", clique em **Definir uma meta**. ![Definir um botão de metas ](/assets/images/help/sponsors/set-a-goal-button.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/settings-tab.md b/translations/pt-BR/data/reusables/sponsors/settings-tab.md
index 6da65ec8d0ae..1f406ce15b43 100644
--- a/translations/pt-BR/data/reusables/sponsors/settings-tab.md
+++ b/translations/pt-BR/data/reusables/sponsors/settings-tab.md
@@ -1 +1 @@
-1. In the left sidebar, click **Settings**. ![Guia Settings (Configurações)](/assets/images/help/sponsors/settings-tab.png)
+1. Na barra lateral esquerda, clique em **Configurações**. ![Guia Settings (Configurações)](/assets/images/help/sponsors/settings-tab.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/short-bio.md b/translations/pt-BR/data/reusables/sponsors/short-bio.md
index db494ee33f90..7467da337981 100644
--- a/translations/pt-BR/data/reusables/sponsors/short-bio.md
+++ b/translations/pt-BR/data/reusables/sponsors/short-bio.md
@@ -1 +1 @@
-1. Under "Short bio", type a brief description of yourself and your work. ![Short bio field](/assets/images/help/sponsors/short-bio.png)
\ No newline at end of file
+1. Em "Biografia curta", escreva uma breve descrição sobre você e de seu trabalho. ![Campo de biografia curta](/assets/images/help/sponsors/short-bio.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/sponsorship-details.md b/translations/pt-BR/data/reusables/sponsors/sponsorship-details.md
index 55425b5c0af6..5d7c1362dca3 100644
--- a/translations/pt-BR/data/reusables/sponsors/sponsorship-details.md
+++ b/translations/pt-BR/data/reusables/sponsors/sponsorship-details.md
@@ -1 +1 @@
-Anyone with a {% data variables.product.product_name %} account can sponsor anyone with a sponsored developer profile or sponsored organization profile through a recurring monthly payment. You can choose from multiple sponsorship tiers, with monthly payment amounts and benefits that are set by the sponsored developer or organization. Your sponsorship will share your account's existing billing date, payment method, and receipt.
+Qualquer pessoa com uma conta de {% data variables.product.product_name %} pode patrocinar qualquer pessoa com um perfil de desenvolvedor patrocinado ou perfil de organização patrocinado através de um pagamento mensal recorrente. Você pode escolher entre várias camadas de patrocínio, com quantias e benefícios de pagamento mensais definidos pelo desenvolvedor ou organização patrocinado. O seu patrocínio compartilhará a data de cobrança existente da sua conta, o método de pagamento e o recibo.
diff --git a/translations/pt-BR/data/reusables/sponsors/sponsorships-not-tax-deductible.md b/translations/pt-BR/data/reusables/sponsors/sponsorships-not-tax-deductible.md
index 79ef4e3abb53..aefcc1c95056 100644
--- a/translations/pt-BR/data/reusables/sponsors/sponsorships-not-tax-deductible.md
+++ b/translations/pt-BR/data/reusables/sponsors/sponsorships-not-tax-deductible.md
@@ -1 +1 @@
-Sponsorships are generally not tax deductible but can be in some cases. It's the responsibility of the sponsored open source contributor—not {% data variables.product.prodname_dotcom %}—to inform sponsors whether the contributions are being made to a tax-exempt entity like a 501(c)(3), and if the sponsorships may be tax-deductible.
+Os patrocínios geralmente não são tributáveis, mas podem ser em alguns casos. É responsabilidade do colaborador de código aberto patrocinado — não de {% data variables.product.prodname_dotcom %}—informar aos patrocinadores se as contribuições estão sendo feitas para uma entidade isenta de imposto, como uma entidade 501(c)(3) e se os patrocínios podem ser tributáveis.
diff --git a/translations/pt-BR/data/reusables/sponsors/stripe-supported-regions.md b/translations/pt-BR/data/reusables/sponsors/stripe-supported-regions.md
index b7b781475a25..1e056f34f386 100644
--- a/translations/pt-BR/data/reusables/sponsors/stripe-supported-regions.md
+++ b/translations/pt-BR/data/reusables/sponsors/stripe-supported-regions.md
@@ -1 +1 @@
-For a list of supported regions, see [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors).
+Para obter uma lista de regiões compatíveis, consulte [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors#countries).
diff --git a/translations/pt-BR/data/reusables/sponsors/tax-form-information-dev.md b/translations/pt-BR/data/reusables/sponsors/tax-form-information-dev.md
index 1c62431d2855..8e55a1d8d053 100644
--- a/translations/pt-BR/data/reusables/sponsors/tax-form-information-dev.md
+++ b/translations/pt-BR/data/reusables/sponsors/tax-form-information-dev.md
@@ -1,4 +1,4 @@
-For more information about the tax forms you need to complete, see the following instructions on the United States Internal Revenue Service website.
+Para mais informações sobre os formulários de impostos que você precisa preencher, consulte as seguintes instruções no site do Serviço de Receita Interna dos Estados Unidos.
 
-- [Instructions for Form W-9](https://www.irs.gov/pub/irs-pdf/iw9.pdf), for US residents
-- [Instructions for Form W-8BEN](https://www.irs.gov/pub/irs-pdf/iw8ben.pdf), for non-US residents
+- [Instruções para o formulário W-9](https://www.irs.gov/pub/irs-pdf/iw9.pdf), para residentes dos EUA
+- [Instruções para o Formulário W-8BEN](https://www.irs.gov/pub/irs-pdf/iw8ben.pdf) para residentes fora dos EUA
diff --git a/translations/pt-BR/data/reusables/sponsors/tax-form-information-org.md b/translations/pt-BR/data/reusables/sponsors/tax-form-information-org.md
index 19852e1e0829..e0222cd137bc 100644
--- a/translations/pt-BR/data/reusables/sponsors/tax-form-information-org.md
+++ b/translations/pt-BR/data/reusables/sponsors/tax-form-information-org.md
@@ -1 +1 @@
-For more information about the tax form organizations need to complete, see [Instructions for Form W-8BEN-E](https://www.irs.gov/pub/irs-pdf/iw8bene.pdf) on the United States Internal Revenue Service website.
+Para obter mais informações sobre as organizações de formulários de impostos precisam preencher, consulte [Instruções para o formulário W-8BEN-E](https://www.irs.gov/pub/irs-pdf/iw8bene.pdf) no site do Serviço de Receita Interna dos Estados Unidos.
diff --git a/translations/pt-BR/data/reusables/sponsors/tax-form-link.md b/translations/pt-BR/data/reusables/sponsors/tax-form-link.md
index 56c84da1fe91..80a109334edc 100644
--- a/translations/pt-BR/data/reusables/sponsors/tax-form-link.md
+++ b/translations/pt-BR/data/reusables/sponsors/tax-form-link.md
@@ -1,2 +1,2 @@
-1. Click **tax form**. ![Link to fill out a tax form](/assets/images/help/sponsors/tax-form-link.png)
-2. Complete, sign, and submit the tax form.
+1. Clique no **formulário de imposto**. ![Link para preencher um formulário de imposto](/assets/images/help/sponsors/tax-form-link.png)
+2. Preencher, assinar e enviar o formulário de imposto.
diff --git a/translations/pt-BR/data/reusables/sponsors/tier-details.md b/translations/pt-BR/data/reusables/sponsors/tier-details.md
index 80a772362375..d0958d0f91f4 100644
--- a/translations/pt-BR/data/reusables/sponsors/tier-details.md
+++ b/translations/pt-BR/data/reusables/sponsors/tier-details.md
@@ -1,3 +1,3 @@
-You can create up to ten sponsorship tiers for sponsors to choose from. Each tier has its own monthly payment amount in US dollars and benefits, such as receiving early access to new versions or being featured in the project's README.
+Você pode criar até dez camadas de patrocínio para escolher. Cada camada tem seu próprio montante de pagamento mensal em dólares e benefícios nos EUA, como receber acesso antecipado a novas versões ou ser destacado no README do projeto.
 
-Once you have a sponsor on a tier, you can't edit the price of that tier. Instead, you must retire the tier and create a new tier. Existing sponsors will remain on the retired tier until they change their sponsorship tier or cancel their sponsorship.
+Depois de ter um patrocinador em uma camada, você não pode editar o preço dessa camada. Em vez disso, você deve se retirar a camada e criar uma nova. Os patrocinadores existentes permanecerão na camada aposentada até mudar a sua camada de patrocínio ou cancelarem seu patrocínio.
diff --git a/translations/pt-BR/data/reusables/sponsors/tier-price-description.md b/translations/pt-BR/data/reusables/sponsors/tier-price-description.md
index 976fc0b55c01..cca70b0d5c62 100644
--- a/translations/pt-BR/data/reusables/sponsors/tier-price-description.md
+++ b/translations/pt-BR/data/reusables/sponsors/tier-price-description.md
@@ -1 +1 @@
-1. Type a price per month and description for the tier. ![Tier price and description text fields](/assets/images/help/sponsors/tier-price-description.png)
+1. Digite um preço por mês e descrição para a camada. ![Campos de texto para preço e descrição da camada](/assets/images/help/sponsors/tier-price-description.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/update-sponsorship.md b/translations/pt-BR/data/reusables/sponsors/update-sponsorship.md
index 674583fef3f6..e6837835b6ec 100644
--- a/translations/pt-BR/data/reusables/sponsors/update-sponsorship.md
+++ b/translations/pt-BR/data/reusables/sponsors/update-sponsorship.md
@@ -1 +1 @@
-1. Click **Update sponsorship**. ![Update sponsorship button](/assets/images/help/sponsors/update-sponsorship-button.png)
+1. Clique em **Atualizar patrocínio**. ![Botão de atualizar patrocínio](/assets/images/help/sponsors/update-sponsorship-button.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/view-eligible-accounts.md b/translations/pt-BR/data/reusables/sponsors/view-eligible-accounts.md
index cc1dddb0552c..24538c339fe9 100644
--- a/translations/pt-BR/data/reusables/sponsors/view-eligible-accounts.md
+++ b/translations/pt-BR/data/reusables/sponsors/view-eligible-accounts.md
@@ -1 +1 @@
-1. Click **View your eligible accounts**. ![View your eligible accounts button](/assets/images/help/sponsors/view-eligible-accounts.png)
+1. Clique **Visualizar as suas contas elegíveis**. ![Botão para visualizar as suas contas elegíveis](/assets/images/help/sponsors/view-eligible-accounts.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/webhook-content-formatting.md b/translations/pt-BR/data/reusables/sponsors/webhook-content-formatting.md
index c1a5ee7dff1f..fd1426331b06 100644
--- a/translations/pt-BR/data/reusables/sponsors/webhook-content-formatting.md
+++ b/translations/pt-BR/data/reusables/sponsors/webhook-content-formatting.md
@@ -1 +1 @@
-4. Under "Content type", select which data format you’d like to receive. Para obter mais informações, consulte "[Criar webhooks](/webhooks/creating/#content-type)" ![Menu for webhook formatting](/assets/images/help/sponsors/webhook-content-menu.png)
+4. Em "Tipo de Conteúdo" selecione qual formato de dados você gostaria de receber. Para obter mais informações, consulte "[Criar webhooks](/webhooks/creating/#content-type)" ![Menu para formatação do webhook](/assets/images/help/sponsors/webhook-content-menu.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/webhook-secret-token.md b/translations/pt-BR/data/reusables/sponsors/webhook-secret-token.md
index 255215517ed4..f9da72ee4a0f 100644
--- a/translations/pt-BR/data/reusables/sponsors/webhook-secret-token.md
+++ b/translations/pt-BR/data/reusables/sponsors/webhook-secret-token.md
@@ -1 +1 @@
-5. Type a secret token. Para obter mais informações, consulte "[Protegendo seus webhooks](/webhooks/securing/#securing-your-secret-token)". ![Fields for secret token and other customization options](/assets/images/help/sponsors/webhook-secret-token.png)
+5. Digite um token secreto. Para obter mais informações, consulte "[Protegendo seus webhooks](/webhooks/securing/#securing-your-secret-token)". ![Campos para token secreto e outras opções de personalização](/assets/images/help/sponsors/webhook-secret-token.png)
diff --git a/translations/pt-BR/data/reusables/sponsors/who-can-see-your-sponsorship.md b/translations/pt-BR/data/reusables/sponsors/who-can-see-your-sponsorship.md
index 9910dcacf9b8..1dc521f8fedf 100644
--- a/translations/pt-BR/data/reusables/sponsors/who-can-see-your-sponsorship.md
+++ b/translations/pt-BR/data/reusables/sponsors/who-can-see-your-sponsorship.md
@@ -1 +1 @@
-1. Choose who can see your sponsorship.
+1. Escolha quem pode ver o seu patrocínio.
diff --git a/translations/pt-BR/data/reusables/sponsors/you-can-be-a-sponsored-developer.md b/translations/pt-BR/data/reusables/sponsors/you-can-be-a-sponsored-developer.md
index cab20e5d2af2..621d2d3e0511 100644
--- a/translations/pt-BR/data/reusables/sponsors/you-can-be-a-sponsored-developer.md
+++ b/translations/pt-BR/data/reusables/sponsors/you-can-be-a-sponsored-developer.md
@@ -1 +1 @@
-Anyone who contributes to an open source project and has a bank account in a supported region is eligible to become a sponsored developer. Contributions include but are not limited to bug reports, issue triage, code, documentation, leadership, business development, project management, mentorship, and design. If you live in a region that isn't already supported by {% data variables.product.prodname_sponsors %}, you can sign up for the waitlist to participate in the beta of {% data variables.product.prodname_sponsors %}. To see if {% data variables.product.prodname_sponsors %} is available in your area, see [the list of supported regions](https://github.com/sponsors#regions).
+Qualquer pessoa que contribua para um projeto de código aberto e more em uma região suportada é elegível para tornar-se um desenvolvedor patrocinado. As contribuições incluem, entre outros, relatórios de erros, triagem de problemas, código, documentação, liderança, desenvolvimento de negócios, gerenciamento de projetos, mentoria e design. Se você mora em uma região que já não é suportada por {% data variables.product.prodname_sponsors %}, você pode inscrever-se na lista de espera para participar da versão beta de {% data variables.product.prodname_sponsors %}.
diff --git a/translations/pt-BR/data/reusables/sponsors/you-can-be-a-sponsored-organization.md b/translations/pt-BR/data/reusables/sponsors/you-can-be-a-sponsored-organization.md
index 7b6f8a085e58..1c3f9a12664f 100644
--- a/translations/pt-BR/data/reusables/sponsors/you-can-be-a-sponsored-organization.md
+++ b/translations/pt-BR/data/reusables/sponsors/you-can-be-a-sponsored-organization.md
@@ -1 +1 @@
-Any organization that contributes to an open source project and has a dedicated bank account in a supported region is eligible to become a sponsored organization. If you live in a region that isn't already supported by {% data variables.product.prodname_sponsors %}, join the waitlist at [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors).
+Qualquer organização que contribua para um projeto de código aberto e opera legalmente em uma região suportada é elegível para tornar-se uma organização patrocinada. Se a sua organização opera em uma região que já não é suportada por {% data variables.product.prodname_sponsors %}, junte-se à lista de espera em [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors).
diff --git a/translations/pt-BR/data/reusables/ssh/add-ssh-key-to-ssh-agent.md b/translations/pt-BR/data/reusables/ssh/add-ssh-key-to-ssh-agent.md
index 6a2f98182365..94a06dad03f7 100644
--- a/translations/pt-BR/data/reusables/ssh/add-ssh-key-to-ssh-agent.md
+++ b/translations/pt-BR/data/reusables/ssh/add-ssh-key-to-ssh-agent.md
@@ -1 +1 @@
-If you created your key with a different name, or if you are adding an existing key that has a different name, replace *id_rsa* in the command with the name of your private key file.
+Se você criou sua chave com um nome diferente ou se você estiver adicionando uma chave existente com um nome diferente, substitua *id_rsa* no comando pelo nome do seu arquivo de chave privada.
diff --git a/translations/pt-BR/data/reusables/ssh/dsa-support.md b/translations/pt-BR/data/reusables/ssh/dsa-support.md
index 4cbfdb1a5495..627bb0b59a03 100644
--- a/translations/pt-BR/data/reusables/ssh/dsa-support.md
+++ b/translations/pt-BR/data/reusables/ssh/dsa-support.md
@@ -1,5 +1,5 @@
 {% note %}
 
-**Note:** {% if currentVersion != "free-pro-team@latest" or currentVersion ver_lt "enterprise-server@2.19" %}DSA keys were deprecated in OpenSSH 7.0. If your operating system uses OpenSSH, you'll need to use an alternate type of key when setting up SSH, such as an RSA key. For instance, if your operating system is macOS Sierra, you can set up SSH using an RSA key.{% else %}DSA keys (SSH-DSS) are no longer supported. Existing keys will continue to function, but you cannot add new DSA keys to your {% data variables.product.product_name %} account.{% endif %}
+**Observe:** As chaves DSA (SSH-DSS) não são mais compatíveis. Chaves existentes continuarão a funcionar, mas você não pode adicionar novas chaves DSA para sua conta do {% data variables.product.product_name %}.
 
 {% endnote %}
diff --git a/translations/pt-BR/data/reusables/support/about-premium-plans.md b/translations/pt-BR/data/reusables/support/about-premium-plans.md
index 8e611999ed70..efdd34b3a1f9 100644
--- a/translations/pt-BR/data/reusables/support/about-premium-plans.md
+++ b/translations/pt-BR/data/reusables/support/about-premium-plans.md
@@ -1,23 +1,23 @@
 
 ### Planos do {% data variables.contact.premium_support %}
 
-There are two {% data variables.contact.premium_support %} plans: Premium and Premium Plus / {% data variables.product.microsoft_premium_plus_support_plan %}.
+Há dois {% data variables.contact.premium_support %} planos: Premium e Premium Plus / {% data variables.product.microsoft_premium_plus_support_plan %}.
 
-|                       | {% data variables.product.premium_support_plan %} | {% data variables.product.premium_plus_support_plan %} |
-| --------------------- | -------------------------------------------------------- | ------------------------------------------------------------- |
-| Horas de operação     | 24 x 7                                                   | 24 x 7                                                        |
-| Initial response time | 
    • 30 minutes for {% data variables.product.support_ticket_priority_urgent %}
    • 4 hours for {% data variables.product.support_ticket_priority_high %}
                                    | 
    • 30 minutes for {% data variables.product.support_ticket_priority_urgent %}
    • 4 hours for {% data variables.product.support_ticket_priority_high %}
                                         |
-| Support channels      | 
    • Online ticket submission
    • Phone support
                                    | 
    • Online ticket submission
    • Phone support
    • Screen share for critical issues
                                         |
-| Treinamentos          | Acesso a conteúdo premium                                | 
    • Acesso a conteúdo premium
    • 1 virtual training class per year
                                         |
-| Authorized contacts   | 10                                                       | 25                                                            |
-| Recursos              | Priority ticket handling                                 | 
    • Priority ticket handling
    • Named Technical Support Account Manager
                                         |
-| Scheduled checks      | Bi-annual health check and reporting                     | 
    • Quarterly health check and reporting
    • Quarterly account reviews
                                         |
-| Administration        |                                                          | 4 hours of Managed Services per month                         |
+|                           | {% data variables.product.premium_support_plan %} | {% data variables.product.premium_plus_support_plan %}
+| ------------------------- | --------------------------------------------------- | -------------------------------------------------------- |
+| Horas de operação         | 24 x 7                                              | 24 x 7                                                   |
+| Tempo inicial de resposta | 
    • 30 minutos para {% data variables.product.support_ticket_priority_urgent %}
    • 4 hours para {% data variables.product.support_ticket_priority_high %}
                               | 
    • 30 minutos para {% data variables.product.support_ticket_priority_urgent %}
    • 4 hours para {% data variables.product.support_ticket_priority_high %}
                                    |
+| Canais de suporte         | 
    • Envio do tíquete on-line
    • Suporte por telefone
                               | 
    • Envio do tíquete on-line
    • Suporte por telefone
    • Compartilhamento de tela para problemas críticos
                                    |
+| Treinamentos              | Acesso a conteúdo premium                           | 
    • Acesso a conteúdo premium
    • 1 aula de treinamento virtual por ano
                                    |
+| Contatos autorizados      | 10                                                  | 25                                                       |
+| Recursos                  | Processamento de tíquete com prioridade             | 
    • Processamento de tíquete com prioridade
    • Gerente de conta de suporte técnico designado
                                    |
+| Verificações agendadas    | Verificação de integridade e relatórios semestrais  | 
    • Verificação de integridade e relatórios trimestrais
    • Revisões trimestrais de conta
                                    |
+| Administração             |                                                     | 4 horas de serviços gerenciados por mês                  |
 
   {% note %}
 
   **Notas:**
-  - Scheduled checks are limited to one organization per term. You can add scheduled checks for additional organizations at any time for an additional fee by [contacting our account management team](https://enterprise.github.com/contact) or calling [+1 (877) 448-4820](tel:+1-877-448-4820).
-  - For the {% data variables.product.premium_plus_support_plan %}, 50% of unused Managed Services hours roll over to the next month and expire at the end of the quarter.
+  - As verificações agendadas são limitadas a uma organização por trimestre. Você pode adicionar verificações programadas para organizações adicionais a qualquer momento por uma taxa adicional [entrando em contato com nossa equipe de gerenciamento de conta](https://enterprise.github.com/contact) ou ligando para [+1 (877) 448-4820](tel:+1-877-448-4820).
+  - Para o {% data variables.product.premium_plus_support_plan %}, 50% dos serviços gerenciados não utilizados vão para o próximo mês e expiram no final do trimestre.
 
   {% endnote %}
diff --git a/translations/pt-BR/data/reusables/support/accessing-premium-content.md b/translations/pt-BR/data/reusables/support/accessing-premium-content.md
index 2f529dd42494..c19782ddbbdc 100644
--- a/translations/pt-BR/data/reusables/support/accessing-premium-content.md
+++ b/translations/pt-BR/data/reusables/support/accessing-premium-content.md
@@ -1,4 +1,4 @@
 
 ### Acessar conteúdo premium
 
-You can access premium content by signing in to the {% data variables.contact.contact_enterprise_portal %}.
+Você pode acessar o conteúdo premium fazendo o login em {% data variables.contact.contact_enterprise_portal %}.
diff --git a/translations/pt-BR/data/reusables/support/ask-and-answer-forum.md b/translations/pt-BR/data/reusables/support/ask-and-answer-forum.md
index e5ba6155e72f..729055c4958b 100644
--- a/translations/pt-BR/data/reusables/support/ask-and-answer-forum.md
+++ b/translations/pt-BR/data/reusables/support/ask-and-answer-forum.md
@@ -1 +1 @@
-You can connect with developers around the world in the [{% data variables.product.prodname_gcf %}](https://github.community) to ask and answer questions, learn, and interact directly with {% data variables.product.product_name %} staff.
+Você pode conectar-se com os desenvolvedores em todo o mundo em [{% data variables.product.prodname_gcf %}](https://github.community) para fazer e responder perguntas, aprender e interagir diretamente com a equipe de {% data variables.product.product_name %}.
diff --git a/translations/pt-BR/data/reusables/support/connect-in-the-forum-bootcamp.md b/translations/pt-BR/data/reusables/support/connect-in-the-forum-bootcamp.md
index f67d841003dc..9b3edf6cb314 100644
--- a/translations/pt-BR/data/reusables/support/connect-in-the-forum-bootcamp.md
+++ b/translations/pt-BR/data/reusables/support/connect-in-the-forum-bootcamp.md
@@ -1 +1 @@
-Connect with people around the world in the [{% data variables.product.prodname_gcf %}](https://github.community)
+Conecte-se com pessoas no mundo todo em [{% data variables.product.prodname_gcf %}](https://github.community)
diff --git a/translations/pt-BR/data/reusables/support/contacting-premium-support.md b/translations/pt-BR/data/reusables/support/contacting-premium-support.md
index f896e7a76678..f17558ba9097 100644
--- a/translations/pt-BR/data/reusables/support/contacting-premium-support.md
+++ b/translations/pt-BR/data/reusables/support/contacting-premium-support.md
@@ -1,4 +1,4 @@
 
 ### Entrar em contato com o {% data variables.contact.premium_support %}
 
-{% data variables.contact.premium_support %} customers can use the {% data variables.contact.contact_enterprise_portal %} to report issues in writing, in English. You can also receive English-language support over the phone. For the {% data variables.contact.premium_support %} phone number, see "[24x7 Phone Support](https://enterprise.githubsupport.com/hc/en-us/articles/360029707371-24x7-Phone-Support)" in the {% data variables.contact.enterprise_portal %}.
+Os clientes de {% data variables.contact.premium_support %} podem utilizar o {% data variables.contact.contact_enterprise_portal %} para relatar problemas por escrito, em inglês. Você também pode receber suporte em inglês por telefone. Para obter o número de telefone de {% data variables.contact.premium_support %}, consulte "[Suporte por telefone 24 horas por dia](https://enterprise.githubsupport.com/hc/en-us/articles/360029707371-24x7-Phone-Support)" em {% data variables.contact.enterprise_portal %}.
diff --git a/translations/pt-BR/data/reusables/support/data-protection-and-privacy.md b/translations/pt-BR/data/reusables/support/data-protection-and-privacy.md
index 0545f09636c7..6aeb0b404fe3 100644
--- a/translations/pt-BR/data/reusables/support/data-protection-and-privacy.md
+++ b/translations/pt-BR/data/reusables/support/data-protection-and-privacy.md
@@ -1 +1 @@
-When you use {% data variables.product.prodname_dotcom %}'s support offerings, the {% data variables.product.prodname_dotcom %} Privacy Statement and {% data variables.product.prodname_dotcom %} Data Protection Addendum apply.
+Quando você usa ofertas de suporte de {% data variables.product.prodname_dotcom %}, serão aplicados a declaração de privacidade de {% data variables.product.prodname_dotcom %} e o adendo de proteção de dados {% data variables.product.prodname_dotcom %}.
diff --git a/translations/pt-BR/data/reusables/support/enterprise-resolving-and-closing-tickets.md b/translations/pt-BR/data/reusables/support/enterprise-resolving-and-closing-tickets.md
index 2ea204a98694..4a4445602a66 100644
--- a/translations/pt-BR/data/reusables/support/enterprise-resolving-and-closing-tickets.md
+++ b/translations/pt-BR/data/reusables/support/enterprise-resolving-and-closing-tickets.md
@@ -1,4 +1,4 @@
-{% data variables.contact.enterprise_support %} may consider a ticket solved after providing an explanation, recommendation, usage instructions, workaround instructions, or by advising you of an available release that addresses the issue.
+{% data variables.contact.enterprise_support %} pode considerar um tíquete resolvido após fornecer uma explicação, recomendação, instruções de uso, instruções de resolução ou orientando você sobre uma versão disponível que aborda o problema.
 
 Se você usar um plugin, módulo ou código personalizado incompatível, o {% data variables.contact.enterprise_support %} solicitará a remoção desse item incompatível durante a tentativa de solução do problema. Se o problema for corrigido quando o plugin, módulo ou código personalizado incompatível for removido, o {% data variables.contact.enterprise_support %} poderá considerar o tíquete resolvido.
 
diff --git a/translations/pt-BR/data/reusables/support/ghec-premium-priorities.md b/translations/pt-BR/data/reusables/support/ghec-premium-priorities.md
index a6066274fde0..6c48f1760131 100644
--- a/translations/pt-BR/data/reusables/support/ghec-premium-priorities.md
+++ b/translations/pt-BR/data/reusables/support/ghec-premium-priorities.md
@@ -1,6 +1,6 @@
-|                             Prioridade                             | Descrição                                                                                                                                                                                                                                                                                               | Exemplos                  |
-|:------------------------------------------------------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
-| {% data variables.product.support_ticket_priority_urgent %} | Production workflows for your organization or enterprise on {% data variables.product.prodname_ghe_cloud %} are failing due to critical service errors or outages, and the failure directly impacts the operation of your business.                                                              | 
    • Errors or outages on {% data variables.product.prodname_dotcom_the_website %} affect core Git or web application functionality for all members of your organization or enterprise
     |
-|  {% data variables.product.support_ticket_priority_high %}  | Account or security issues with your organization or enterprise on {% data variables.product.prodname_ghe_cloud %} are causing limited impact to your business.                                                                                                                                  | 
    • An organization or enterprise owner has unintentionally deleted an organization
    • An organization or enterprise member has uploaded sensitive data in a commit, issue, pull request, or issue attachment
     |
-| {% data variables.product.support_ticket_priority_normal %} | Members of your organization or enterprise on {% data variables.product.prodname_ghe_cloud %} are experiencing limited or moderate issues with {% data variables.product.prodname_dotcom_the_website %}, or you have general concerns or questions about your organization or enterprise. | 
    • Questions about using APIs and features for your organization or enterprise
    • Issues with tools for organization data migration that {% data variables.product.company_short %} provides
    • Features related to your organization or enterprise not working as expected
    • General security questions about your organization or enterprise
     |
-|  {% data variables.product.support_ticket_priority_low %}   | You have a question or suggestion about your organization or enterprise on {% data variables.product.prodname_ghe_cloud %} that is not time-sensitive, or does not otherwise block the productivity of your team.                                                                                | 
    • Excessive resource usage for your organization or enterprise
    • Requests for health checks
    • Help with using Gists, notifications, wikis, {% data variables.product.prodname_pages %}, {% data variables.product.prodname_desktop %}, Atom, or other peripheral services or features with your organization or enterprise
    • Feature requests
    • Product feedback
     |
+|                          Prioridade                           | Descrição                                                                                                                                                                                                                                                                                          | Exemplos                  |
+|:-------------------------------------------------------------:| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
+| {% data variables.product.support_ticket_priority_urgent %} | Os fluxos de trabalho de produção para sua organização ou empresa em {% data variables.product.prodname_ghe_cloud %} estão falhando em razão de erros de serviço ou falhas críticas e a falha afeta diretamente a operação do seu negócio.                                                       | 
    • Erros ou interrupções em {% data variables.product.prodname_dotcom_the_website %} afetam a funcionalidade essencial do Git ou do aplicativo web para todos os integrantes da sua organização ou empresa
     |
+|  {% data variables.product.support_ticket_priority_high %}  | Os problemas de conta ou segurança com sua organização ou empresa em {% data variables.product.prodname_ghe_cloud %} causam impacto limitado à sua empresa.                                                                                                                                      | 
    • Uma organização ou proprietário da empresa excluiu involuntariamente uma organização
    • Uma organização ou integrante da empresa fez o upload de dados confidenciais em um commit, problema, pull request ou anexo do problema
     |
+| {% data variables.product.support_ticket_priority_normal %} | Os integrantes da sua organização ou empresa em {% data variables.product.prodname_ghe_cloud %} estão passando por problemas limitados ou moderados com {% data variables.product.prodname_dotcom_the_website %}, ou você tem dúvidas ou preocupações gerais sobre sua organização ou empresa. | 
    • Perguntas sobre o uso de APIs e recursos para sua organização ou empresa
    • Problemas com ferramentas para migração de dados da organização que {% data variables.product.company_short %} fornece
    • Recursos relacionados à sua organização ou empresa não funcionando como esperado
    • Dúvidas gerais de segurança sobre sua organização ou empresa
     |
+|  {% data variables.product.support_ticket_priority_low %}   | Você tem uma pergunta ou sugestão sobre sua organização ou empresa em {% data variables.product.prodname_ghe_cloud %} que não seja sensível ao tempo, ou não bloqueie a produtividade da sua equipe.                                                                                             | 
    • Uso excessivo de recursos para a sua organização ou empresa
    • Pedidos de verificações de integridade
    • Ajuda com o uso de Gists, notificações, wikis, {% data variables.product.prodname_pages %}, {% data variables.product.prodname_desktop %}, Atom ou outros serviços ou recursos periféricos com sua organização ou empresa
    • Solicitações de recursos
    • Feedback do produto
     |
diff --git a/translations/pt-BR/data/reusables/support/ghes-priorities.md b/translations/pt-BR/data/reusables/support/ghes-priorities.md
index 75f9fc6838ed..500d67beb6b0 100644
--- a/translations/pt-BR/data/reusables/support/ghes-priorities.md
+++ b/translations/pt-BR/data/reusables/support/ghes-priorities.md
@@ -1,6 +1,6 @@
-|                             Prioridade                             | Descrição                                                                                                                                                                                                                                                | Exemplos                  |
-|:------------------------------------------------------------------:| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
-| {% data variables.product.support_ticket_priority_urgent %} | {% data variables.product.prodname_ghe_server %} is failing in a production environment, and the failure directly impacts the operation of your business.

    _{% data reusables.support.priority-urgent-english-only %}_ | 
    • Errors or outages that affect core Git or web application functionality for all users
    • Severe performance degradation for majority of users
    • Full or rapidly filling storage
    • Inability to install a renewed license file
    • Incidentes relacionados a segurança
    • Loss of administrative access to the instance with no known workaround
    • Failure to restore a backup to a production environment
     |
-|  {% data variables.product.support_ticket_priority_high %}  | {% data variables.product.prodname_ghe_server %} is failing in a production environment, but impact on your business is limited.                                                                                                                  | 
    • Performance degradation that reduces productivity for many users
    • Reduced redundancy from failure of High Availability (HA) or cluster nodes
    • Failure to back up instance
    • Failure to restore a backup to a test or staging environment that could compromise successful restoration to a production environment
     |
-| {% data variables.product.support_ticket_priority_normal %} | You're experiencing limited or moderate issues with {% data variables.product.prodname_ghe_server %}, or you have general concerns or questions about the operation of your instance.                                                             | 
    • Problems in a test or staging environment
    • Advice on using {% data variables.product.prodname_dotcom %} APIs and features, or questions about configuring third-party integrations from your instance
    • Issues with tools for user data migration that {% data variables.product.company_short %} provides
    • Atualizações
    • Bug reports
    • Features not working as expected
    • General security questions
     |
-|  {% data variables.product.support_ticket_priority_low %}   | You have a question or suggestion about {% data variables.product.prodname_ghe_server %} that is not time-sensitive, or does not otherwise block the productivity of your team.                                                                   | 
    • Feature requests
    • Product feedback
    • Requests for health checks (available for customers with a {% data variables.product.premium_support_plan %} only at this time)
    • Notifying {% data variables.product.company_short %} of planned maintenance on your instance
     |
+|                          Prioridade                           | Descrição                                                                                                                                                                                                                              | Exemplos                  |
+|:-------------------------------------------------------------:| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
+| {% data variables.product.support_ticket_priority_urgent %} | {% data variables.product.prodname_ghe_server %} está falhando em um ambiente de produção, e a falha afeta diretamente a operação do seu negócio.

    _{% data reusables.support.priority-urgent-english-only %}_ | 
    • Erros ou falhas que afetam a funcionalidade central do Git ou do aplicativo web para todos os usuários
    • Redução de desempenho grave para a maioria dos usuários
    • Armazenamento esgotado ou que se preenche rapidamente
    • Incapacidade de instalar um arquivo de licença renovado
    • Incidentes relacionados a segurança
    • Perda de acesso administrativo à instância sem solução alternativa conhecida
    • Falha ao restaurar um backup para um ambiente de produção
     |
+|  {% data variables.product.support_ticket_priority_high %}  | {% data variables.product.prodname_ghe_server %} está falhando em um ambiente de produção, mas o impacto em seu negócio é limitado.                                                                                                  | 
    • Redução de desempenho que reduz a produtividade para muitos usuários
    • Redução de redundância de falha de Alta Disponibilidade (HA) ou nós de cluster
    • Falha no backup da instância
    • Falha ao restaurar um backup para um ambiente de teste ou de preparo que poderia comprometer a restauração bem-sucedida de um ambiente de produção
     |
+| {% data variables.product.support_ticket_priority_normal %} | Você está enfrentando problemas limitados ou moderados com {% data variables.product.prodname_ghe_server %}, ou tem dúvidas gerais sobre a operação de sua instância.                                                                | 
    • Problemas em um ambiente de teste ou de preparo
    • Orientação sobre como usar APIs e recursos de {% data variables.product.prodname_dotcom %} ou perguntas sobre como configurar integrações de terceiros a partir da sua instância
    • Problemas com ferramentas para migração de dados do usuário que {% data variables.product.company_short %} fornece
    • Atualizações
    • Relatório de problemas
    • Recursos que não estão funcionando como esperado
    • Dúvidas gerais de segurança
     |
+|  {% data variables.product.support_ticket_priority_low %}   | Você tem uma dúvida ou sugestão sobre {% data variables.product.prodname_ghe_server %} que não seja sensível ao tempo ou que não bloqueia a produtividade da sua equipe.                                                             | 
    • Solicitações de recursos
    • Feedback do produto
    • Pedidos de verificação de integridade (disponível para clientes com {% data variables.product.premium_support_plan %} somente no momento)
    • Notificar {% data variables.product.company_short %} de manutenção planejada na sua instância
     |
diff --git a/translations/pt-BR/data/reusables/support/github-can-modify-ticket-priority.md b/translations/pt-BR/data/reusables/support/github-can-modify-ticket-priority.md
index c6d7780e5606..15074b7513d4 100644
--- a/translations/pt-BR/data/reusables/support/github-can-modify-ticket-priority.md
+++ b/translations/pt-BR/data/reusables/support/github-can-modify-ticket-priority.md
@@ -1 +1 @@
-{% data variables.product.company_short %} has the sole discretion to modify the priority of a ticket at any time, and may lower the priority of a ticket after determining and mitigating the primary cause of an issue.
+{% data variables.product.company_short %} tem o exclusivo critério para modificar a prioridade de um tíquete a qualquer momento e pode reduzir a prioridade de um tíquete após determinar e mitigar a causa primária de um problema.
diff --git a/translations/pt-BR/data/reusables/support/help_resources.md b/translations/pt-BR/data/reusables/support/help_resources.md
index 6e226b167b40..0d51cd66c51d 100644
--- a/translations/pt-BR/data/reusables/support/help_resources.md
+++ b/translations/pt-BR/data/reusables/support/help_resources.md
@@ -1,7 +1,7 @@
-For questions, bug reports, and discussions about {% data variables.product.prodname_github_app %}s,  {% data variables.product.prodname_oauth_app %}s, and API development, explore the  {% data variables.product.prodname_support_forum_with_url %}. The forum is moderated and maintained by {% data variables.product.product_name %} staff, but questions posted to the forum are not guaranteed to receive a reply from {% data variables.product.product_name %} staff.
+Para dúvidas, relatórios de erros e discussões sobre {% data variables.product.prodname_github_app %}s,  {% data variables.product.prodname_oauth_app %}e desenvolvimento da API, explore {% data variables.product.prodname_support_forum_with_url %}. O fórum é moderado e mantido por funcionários de {% data variables.product.product_name %}, mas as dúvidas postadas no fórum não têm garantia de recebimento de resposta por parte dos funcionários de {% data variables.product.product_name %}.
 
-Consider reaching out to [GitHub Support](https://github.com/contact) directly using the contact form for:
-  - guaranteed response from {% data variables.product.product_name %} staff
-  - support requests involving sensitive data or private concerns
-  - feature requests
-  - feedback about {% data variables.product.product_name %} products
+Considere entrar em contato com o [Suporte do GitHub](https://github.com/contact) diretamente usando o formulário de contato para:
+  - resposta garantida dos funcionários de {% data variables.product.product_name %}
+  - solicitações de suporte que envolvem dados confidenciais ou questões privadas
+  - solicitações de recursos
+  - feedback sobre produtos de {% data variables.product.product_name %}
diff --git a/translations/pt-BR/data/reusables/support/premium-resolving-and-closing-tickets.md b/translations/pt-BR/data/reusables/support/premium-resolving-and-closing-tickets.md
index 6df026cc9fbe..33f9d50272ec 100644
--- a/translations/pt-BR/data/reusables/support/premium-resolving-and-closing-tickets.md
+++ b/translations/pt-BR/data/reusables/support/premium-resolving-and-closing-tickets.md
@@ -1,4 +1,4 @@
-{% data variables.contact.premium_support %} may consider a ticket solved after providing an explanation, recommendation, usage instructions, workaround instructions, or by advising you of an available release that addresses the issue.
+{% data variables.contact.premium_support %} pode considerar um tíquete resolvido após fornecer uma explicação, recomendação, instruções de uso, instruções de resolução ou orientando você sobre uma versão disponível que aborda o problema.
 
 Se você usar um plugin, módulo ou código personalizado incompatível, o {% data variables.contact.premium_support %} solicitará a remoção desse item incompatível durante a tentativa de resolução do problema. Se o problema for corrigido quando o plugin, módulo ou código personalizado incompatível for removido, o {% data variables.contact.premium_support %} poderá considerar o tíquete resolvido.
 
diff --git a/translations/pt-BR/data/reusables/support/priority-urgent-english-only.md b/translations/pt-BR/data/reusables/support/priority-urgent-english-only.md
index a33de1c4dfdb..b3db16aba147 100644
--- a/translations/pt-BR/data/reusables/support/priority-urgent-english-only.md
+++ b/translations/pt-BR/data/reusables/support/priority-urgent-english-only.md
@@ -1 +1 @@
-Support for tickets with {% data variables.product.support_ticket_priority_urgent %} priority is only available in the English language.
\ No newline at end of file
+Suporte para tíquetes com prioridade {% data variables.product.support_ticket_priority_urgent %} está disponível apenas em inglês.
diff --git a/translations/pt-BR/data/reusables/support/scope-of-support.md b/translations/pt-BR/data/reusables/support/scope-of-support.md
index ea5a9ed638a0..47af34c04345 100644
--- a/translations/pt-BR/data/reusables/support/scope-of-support.md
+++ b/translations/pt-BR/data/reusables/support/scope-of-support.md
@@ -4,9 +4,9 @@
 Se sua solicitação de suporte estiver fora do escopo do que nossa equipe pode ajudá-lo, podemos recomendar os próximos passos para resolver seu problema fora do {% data variables.contact.github_support %}. Sua solicitação de suporte está, possivelmente, fora do escopo do {% data variables.contact.github_support %} caso se refira, principalmente, a:
 - Integrações com terceiros
 - Configurações de hardware
-- CI/CD, such as Jenkins
-- Writing scripts
-- Configuration of external authentication systems, such as SAML identity providers
-- Open Source projects
+- CI/CD, como Jenkins
+- Escrever scripts
+- Configuração de sistemas de autenticação externos, como provedores de identidade SAML
+- Projetos de código aberto
 
 Se não tem certeza se o problema está fora do escopo, abra um tíquete e ficaremos felizes em ajudá-lo a determinar a melhor maneira de prosseguir.
diff --git a/translations/pt-BR/data/reusables/support/service-level-agreement-response-times.md b/translations/pt-BR/data/reusables/support/service-level-agreement-response-times.md
index 2acff3975c70..f99358c0cf91 100644
--- a/translations/pt-BR/data/reusables/support/service-level-agreement-response-times.md
+++ b/translations/pt-BR/data/reusables/support/service-level-agreement-response-times.md
@@ -1,8 +1,8 @@
 ### Tempos de resposta do Contrato de nível de serviço
 
-For tickets you submit, support is available 24 hours a day, 7 days per week. The initial response time guaranteed by the SLA is dependent on the priority level of the ticket. Response time begins when {% data variables.contact.premium_support %} sets the priority level of the ticket. A response does not mean the issue has been resolved.
+Para tíquetes que você enviar, o suporte está disponível 24 horas por dia, 7 dias por semana. O tempo inicial de resposta garantido pelo SLA depende do nível de prioridade do tíquete. Tempo de resposta começa quando {% data variables.contact.premium_support %} define o nível de prioridade do tíquete. Uma resposta não significa que o problema tenha sido resolvido.
 
-| Ticket priority level                                              | Initial response time |
-| ------------------------------------------------------------------ | --------------------- |
-| {% data variables.product.support_ticket_priority_urgent %} | 30 minutes            |
-| {% data variables.product.support_ticket_priority_high %}   | 4 hours               |
+| Nível de prioridade do tíquete                                | Tempo inicial de resposta |
+| ------------------------------------------------------------- | ------------------------- |
+| {% data variables.product.support_ticket_priority_urgent %} | 30 minutos                |
+| {% data variables.product.support_ticket_priority_high %}   | 4 horas                   |
diff --git a/translations/pt-BR/data/reusables/support/signing-up-for-premium-support.md b/translations/pt-BR/data/reusables/support/signing-up-for-premium-support.md
index d15f0d8efc22..66965665931e 100644
--- a/translations/pt-BR/data/reusables/support/signing-up-for-premium-support.md
+++ b/translations/pt-BR/data/reusables/support/signing-up-for-premium-support.md
@@ -1,4 +1,4 @@
 
 ### Inscrever-se para o {% data variables.contact.premium_support %}
 
-To sign up for {% data variables.contact.premium_support %} or upgrade your plan, you can [contact our account management team](https://enterprise.github.com/contact) or call [+1 (877) 448-4820](tel:+1-877-448-4820).
+Para se inscrever em {% data variables.contact.premium_support %} ou atualizar seu plano, você pode [entrar em contato com nossa equipe de gerenciamento de conta](https://enterprise.github.com/contact) ou ligar para [+1 (877) 448-4820](tel:+1-877-448-4820).
diff --git a/translations/pt-BR/data/reusables/time_date/date_format.md b/translations/pt-BR/data/reusables/time_date/date_format.md
index e1bf0c641fd0..92e1e8537de9 100644
--- a/translations/pt-BR/data/reusables/time_date/date_format.md
+++ b/translations/pt-BR/data/reusables/time_date/date_format.md
@@ -1 +1 @@
-Date formatting must follow the [ISO8601](http://en.wikipedia.org/wiki/ISO_8601) standard, which is `YYYY-MM-DD` (year-month-day).
+O formato de data deve seguir o padrão [ISO8601](http://en.wikipedia.org/wiki/ISO_8601), que é `YYYY-MM-DD` (ano-mês-dia).
diff --git a/translations/pt-BR/data/reusables/time_date/time_format.md b/translations/pt-BR/data/reusables/time_date/time_format.md
index fb71921b4d6b..58b6cb700be1 100644
--- a/translations/pt-BR/data/reusables/time_date/time_format.md
+++ b/translations/pt-BR/data/reusables/time_date/time_format.md
@@ -1 +1 @@
-You can also add optional time information `THH:MM:SS+00:00` after the date, to search by the hour, minute, and second. That's `T`, followed by `HH:MM:SS` (hour-minutes-seconds), and a UTC offset (`+00:00`). 
+Você também pode adicionar informações de tempo opcionais `THH:MM:SS+00:00` após a data, para pesquisar por hora, minuto e segundo. Isso se faz adicionando `T`, seguido de `HH:MM:SS` (hora-minutos-segundos) e um intervalo de UTC (`+00:00`). 
diff --git a/translations/pt-BR/data/reusables/two_fa/2fa_not_supported_with_saml_and_cas.md b/translations/pt-BR/data/reusables/two_fa/2fa_not_supported_with_saml_and_cas.md
index a19ac6f0733a..efa715151e7b 100644
--- a/translations/pt-BR/data/reusables/two_fa/2fa_not_supported_with_saml_and_cas.md
+++ b/translations/pt-BR/data/reusables/two_fa/2fa_not_supported_with_saml_and_cas.md
@@ -1 +1 @@
-Not supported or managed on the {% data variables.product.prodname_ghe_server %} appliance, but may be supported by the external authentication provider. A aplicação da autenticação de dois fatores em organizações não está disponível.
+Não compatível ou gerenciado no dispositivo de {% data variables.product.prodname_ghe_server %}, mas pode ser compatível pelo provedor de autenticação externo. A aplicação da autenticação de dois fatores em organizações não está disponível.
diff --git a/translations/pt-BR/data/reusables/two_fa/about-2fa.md b/translations/pt-BR/data/reusables/two_fa/about-2fa.md
new file mode 100644
index 000000000000..6dc8034f46cc
--- /dev/null
+++ b/translations/pt-BR/data/reusables/two_fa/about-2fa.md
@@ -0,0 +1 @@
+A autenticação de dois fatores (2FA) é uma camada extra de segurança usada ao fazer login em sites ou aplicativos.
diff --git a/translations/pt-BR/data/reusables/two_fa/about-recovery-codes.md b/translations/pt-BR/data/reusables/two_fa/about-recovery-codes.md
index 558307ae3d33..12206a150633 100644
--- a/translations/pt-BR/data/reusables/two_fa/about-recovery-codes.md
+++ b/translations/pt-BR/data/reusables/two_fa/about-recovery-codes.md
@@ -1 +1 @@
-When you configure two-factor authentication, you'll download and save your 2FA recovery codes. If you lose access to your phone, you can authenticate to {% data variables.product.product_name %} using your recovery codes.
+Ao configurar a autenticação de dois fatores, você fará o download salvará os seus códigos de recuperação de 2FA. Se você perder o acesso ao seu telefone, você poderá efetuar a autenticação em {% data variables.product.product_name %} usando seus códigos de recuperação.
diff --git a/translations/pt-BR/data/reusables/two_fa/after-2fa-add-security-key.md b/translations/pt-BR/data/reusables/two_fa/after-2fa-add-security-key.md
index 12b44b4dba0e..e70d7e9b3641 100644
--- a/translations/pt-BR/data/reusables/two_fa/after-2fa-add-security-key.md
+++ b/translations/pt-BR/data/reusables/two_fa/after-2fa-add-security-key.md
@@ -1 +1 @@
-After you configure 2FA using a mobile app{% if currentVersion == "free-pro-team@latest" %} or via text message{% endif %}, you can add a security key, like a fingerprint reader or Windows Hello. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}The technology that enables authentication with a security key is called WebAuthn. WebAuthn is the successor to U2F and works in all modern browsers. For more information, see "[WebAuthn](https://webauthn.guide/)" and "[Can I Use](https://caniuse.com/#search=webauthn)."{% else %}FIDO U2F authentication is currently available for the Chrome, Firefox, and Opera browsers.{% endif %}
+Depois de configurar a 2FA usando um aplicativo móvel{% if currentVersion == "free-pro-team@latest" %} ou por meio de mensagem de texto{% endif %}, você pode adicionar uma chave de segurança, como um leitor de impressão digital ou o Windows Hello. A tecnologia que habilita a autenticação com uma chave de segurança é denominada WebAuthn. WebAuthn é o sucessor da U2F e funciona em todos os navegadores modernos. Para obter mais informações, consulte "[WebAuthn](https://webauthn.guide/)" e "[Posso usar](https://caniuse.com/#search=webauthn)".
diff --git a/translations/pt-BR/data/reusables/two_fa/auth_methods_2fa.md b/translations/pt-BR/data/reusables/two_fa/auth_methods_2fa.md
index 8931f7c98a3d..a7bb7fb624df 100644
--- a/translations/pt-BR/data/reusables/two_fa/auth_methods_2fa.md
+++ b/translations/pt-BR/data/reusables/two_fa/auth_methods_2fa.md
@@ -1,10 +1,10 @@
 {% if currentVersion != "free-pro-team@latest" %}
-### Authentication methods that support 2FA
+### Métodos de autenticação compatíveis com a 2FA
 
-| Authentication Method                             | Descrição                                                                                                                                   | Two-factor authentication support                                                                                                                                                                                             |
-| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Built-in                                          | Authentication is performed against user accounts that are stored on the {% data variables.product.prodname_ghe_server %} appliance. | Supported and managed on the {% data variables.product.prodname_ghe_server %} appliance. Organization administrators can require 2FA to be enabled for members of the organization. |{% if currentVersion != "free-pro-team@latest" %}
-| Built-in authentication with an identity provider | Authentication is performed against user accounts that are stored on the identity provider.                                                 | Dependant on the identity provider.{% endif %}
-| LDAP                                              | Allows integration with your company directory service for authentication.                                                                  | Supported and managed on the {% data variables.product.prodname_ghe_server %} appliance. Organization administrators can require 2FA to be enabled for members of the organization.                                    |
-| SAML                                              | Authentication is performed on an external identity provider.                                                                               | {% data reusables.two_fa.2fa_not_supported_with_saml_and_cas %}                                                                                                                                                    |
-| CAS                                               | Single sign-on service is provided by an external server.                                                                                   | {% data reusables.two_fa.2fa_not_supported_with_saml_and_cas %}{% endif %}
+| Método de autenticação                               | Descrição                                                                                                                          | Suporte para autenticação de dois fatores                                                                                                                                                                                                                         |
+| ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Integrado                                            | A autenticação é feita para as contas de usuário armazenadas no dispositivo de {% data variables.product.prodname_ghe_server %}. | Recebe suporte e gerenciamento no dispositivo de {% data variables.product.prodname_ghe_server %}. Os administradores da organização podem exigir que a 2FA seja habilitada para integrantes da organização. |{% if currentVersion != "free-pro-team@latest" %}
+| Autenticação integrada com um provedor de identidade | A autenticação é realizada para as contas de usuário armazenadas no provedor de identidade.                                        | Depende do provedor de identidade.{% endif %}
+| LDAP                                                 | Permite integração com seus diretórios da empresa para autenticação.                                                               | Recebe suporte e gerenciamento no dispositivo de {% data variables.product.prodname_ghe_server %}. Os administradores da organização podem exigir que a 2FA seja habilitada para integrantes da organização.                                                    |
+| SAML                                                 | A autenticação é realizada em um provedor de identidade externo.                                                                   | {% data reusables.two_fa.2fa_not_supported_with_saml_and_cas %}
+| CAS                                                  | Serviço de logon único é fornecido por um servidor externo.                                                                        | {% data reusables.two_fa.2fa_not_supported_with_saml_and_cas %}{% endif %}
diff --git a/translations/pt-BR/data/reusables/two_fa/enable-two-factor-authentication.md b/translations/pt-BR/data/reusables/two_fa/enable-two-factor-authentication.md
index 84b8b35d6801..7b4d55c054d3 100644
--- a/translations/pt-BR/data/reusables/two_fa/enable-two-factor-authentication.md
+++ b/translations/pt-BR/data/reusables/two_fa/enable-two-factor-authentication.md
@@ -1 +1 @@
-1. Under "Two-factor authentication", click **Enable two-factor authentication**. ![Enable two-factor authentication option](/assets/images/help/2fa/enable-two-factor-authentication-dialoge.png)
+1. Em "Autenticação de dois fatores", clique **Habilitar autenticação de dois fatores**. ![Habilitar a opção de autenticação de dois fatores](/assets/images/help/2fa/enable-two-factor-authentication-dialoge.png)
diff --git a/translations/pt-BR/data/reusables/two_fa/save_your_recovery_codes_during_2fa_setup.md b/translations/pt-BR/data/reusables/two_fa/save_your_recovery_codes_during_2fa_setup.md
index 1fec3a288227..443aa1006974 100644
--- a/translations/pt-BR/data/reusables/two_fa/save_your_recovery_codes_during_2fa_setup.md
+++ b/translations/pt-BR/data/reusables/two_fa/save_your_recovery_codes_during_2fa_setup.md
@@ -2,4 +2,4 @@
     - Para salvar os códigos de recuperação no dispositivo, clique em **Download** (Baixar).
     - Para salvar uma cópia impressa dos códigos de recuperação, clique em **Print** (Imprimir).
     - Para copiar os códigos de recuperação para armazenamento em um gerenciador de senhas, clique em **Copy** (Copiar). ![Lista de códigos de recuperação com opção para baixar, imprimir ou copiar os códigos](/assets/images/help/2fa/download-print-or-copy-recovery-codes-before-continuing.png)
-7. After saving your two-factor recovery codes, click **Next**.
+7. Depois de salvar os seus códigos de recuperação de dois fatores, clique em **Próximo**.
diff --git a/translations/pt-BR/data/reusables/two_fa/send-invite-to-reinstate-user-before-2fa-is-enabled.md b/translations/pt-BR/data/reusables/two_fa/send-invite-to-reinstate-user-before-2fa-is-enabled.md
index ea88f603bc1d..fe4caadf5433 100644
--- a/translations/pt-BR/data/reusables/two_fa/send-invite-to-reinstate-user-before-2fa-is-enabled.md
+++ b/translations/pt-BR/data/reusables/two_fa/send-invite-to-reinstate-user-before-2fa-is-enabled.md
@@ -1,3 +1,3 @@
 {% if currentVersion == "free-pro-team@latest" %}
-You can send an invitation to reinstate a user's privileges and access to the organization before they have enabled two-factor authentication and they must enable 2FA before they can accept your invitation to rejoin the organization.
+Você pode enviar um convite para restabelecer os privilégios e acesso de um usuário à organização antes de habilitarem a autenticação de dois fatores e eles devem habilitar a 2FA antes que possam aceitar o seu convite para reingressar na organização.
 {% endif %}
diff --git a/translations/pt-BR/data/reusables/two_fa/show-recovery-codes.md b/translations/pt-BR/data/reusables/two_fa/show-recovery-codes.md
index 49f673113d8e..70663f95af16 100644
--- a/translations/pt-BR/data/reusables/two_fa/show-recovery-codes.md
+++ b/translations/pt-BR/data/reusables/two_fa/show-recovery-codes.md
@@ -1 +1 @@
-1. Next to "Recovery codes," click **Show**. ![Show recovery codes button](/assets/images/help/2fa/show-recovery-codes-button.png)
+1. Ao lado de "Códigos de recuperação", clique em **Mostrar**. ![Botão para m os códigos de recuperação](/assets/images/help/2fa/show-recovery-codes-button.png)
diff --git a/translations/pt-BR/data/reusables/two_fa/test_2fa_immediately.md b/translations/pt-BR/data/reusables/two_fa/test_2fa_immediately.md
index 8055c56999f0..c42f8eab4cf1 100644
--- a/translations/pt-BR/data/reusables/two_fa/test_2fa_immediately.md
+++ b/translations/pt-BR/data/reusables/two_fa/test_2fa_immediately.md
@@ -1 +1 @@
-1. After you've saved your recovery codes and enabled 2FA, we recommend you sign out and back in to your account. In case of problems, such as a forgotten password or typo in your email address, you can use recovery codes to access your account and correct the problem.
+1. Depois que você salvou seus códigos de recuperação e ativou o 2FA, recomendamos que você saia e entre de volta na sua conta. Em caso de problemas, como uma senha esquecida ou erro de digitação no seu endereço de e-mail, você pode usar os códigos de recuperação para acessar sua conta e corrigir o problema.
diff --git a/translations/pt-BR/data/reusables/two_fa/username-password.md b/translations/pt-BR/data/reusables/two_fa/username-password.md
index a6244a775208..2aa02cf42b95 100644
--- a/translations/pt-BR/data/reusables/two_fa/username-password.md
+++ b/translations/pt-BR/data/reusables/two_fa/username-password.md
@@ -1 +1 @@
-1. Type your username and password to prompt authentication.
+1. Digite seu nome de usuário e senha para solicitar autenticação.
diff --git a/translations/pt-BR/data/reusables/user-settings/access_settings.md b/translations/pt-BR/data/reusables/user-settings/access_settings.md
index 0a3ed614fc4b..37acb52ba9ba 100644
--- a/translations/pt-BR/data/reusables/user-settings/access_settings.md
+++ b/translations/pt-BR/data/reusables/user-settings/access_settings.md
@@ -1 +1 @@
-1. In the upper-right corner of any page, click your profile photo, then click **Settings**. ![Ícone Settings (Configurações) na barra de usuário](/assets/images/settings/userbar-account-settings_post2dot12.png)
+1. No canto superior direito de qualquer página, clique na sua foto de perfil e, em seguida, clique em **Configurações**. ![Ícone Settings (Configurações) na barra de usuário](/assets/images/settings/userbar-account-settings_post2dot12.png)
diff --git a/translations/pt-BR/data/reusables/user-settings/edit_marketplace_listing.md b/translations/pt-BR/data/reusables/user-settings/edit_marketplace_listing.md
index 7b7bf4115a29..45342c570934 100644
--- a/translations/pt-BR/data/reusables/user-settings/edit_marketplace_listing.md
+++ b/translations/pt-BR/data/reusables/user-settings/edit_marketplace_listing.md
@@ -1 +1 @@
-5. Scroll down to the Marketplace section and click **Edit Marketplace listing**. The Marketplace section is only visible if you allowed your app to be installed by any user or organization when registering the app.  For more information, see the list of [Marketplace requirements](/apps/marketplace/creating-and-submitting-your-app-for-approval/requirements-for-listing-an-app-on-github-marketplace/). ![link to edit your GitHub Marketplace listing](/assets/images/marketplace/marketplace_edit_listing_text.png)
+5. Role para baixo até a seção do Marketplace e clique em **Editar listagem do Mercado**. A seção do Marketplace só é visível se você permitiu que seu aplicativo fosse instalado por qualquer usuário ou organização ao registrar o aplicativo.  Para obter mais informações, consulte a lista dos [requisitos do Marketplace](/apps/marketplace/creating-and-submitting-your-app-for-approval/requirements-for-listing-an-app-on-github-marketplace/). ![link para editar sua listagem do GitHub Marketplace](/assets/images/marketplace/marketplace_edit_listing_text.png)
diff --git a/translations/pt-BR/data/reusables/user-settings/github_apps.md b/translations/pt-BR/data/reusables/user-settings/github_apps.md
index 8c109944ae84..65c8ae02bd61 100644
--- a/translations/pt-BR/data/reusables/user-settings/github_apps.md
+++ b/translations/pt-BR/data/reusables/user-settings/github_apps.md
@@ -1 +1 @@
-1. In the left sidebar, click **GitHub Apps**. ![Seção de aplicativos do GitHub](/assets/images/settings/github_apps.png)
+1. Na barra lateral esquerda, clique em **Aplicativos GitHub**. ![Seção de aplicativos do GitHub](/assets/images/settings/github_apps.png)
diff --git a/translations/pt-BR/data/reusables/user-settings/github_apps_advanced.md b/translations/pt-BR/data/reusables/user-settings/github_apps_advanced.md
index 5378aa17dc14..9b2143f37d59 100644
--- a/translations/pt-BR/data/reusables/user-settings/github_apps_advanced.md
+++ b/translations/pt-BR/data/reusables/user-settings/github_apps_advanced.md
@@ -1 +1 @@
-1. In the left sidebar, click **Advanced**. ![Advanced tab](/assets/images/github-apps/github_apps_advanced.png)
+1. Na barra lateral esquerda, clique em **Avançado**. ![Aba avançado](/assets/images/github-apps/github_apps_advanced.png)
diff --git a/translations/pt-BR/data/reusables/user-settings/marketplace_apps.md b/translations/pt-BR/data/reusables/user-settings/marketplace_apps.md
index 8598fd999cfc..71347f6d9dcc 100644
--- a/translations/pt-BR/data/reusables/user-settings/marketplace_apps.md
+++ b/translations/pt-BR/data/reusables/user-settings/marketplace_apps.md
@@ -1,4 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-1. In the left sidebar, click either **OAuth Apps** or **GitHub Apps** depending on the {% data variables.product.prodname_marketplace %} listing you'd like to manage. **Note:** You can also manage your listing by navigating to https://github.com/marketplace/manage. ![Seleção do tipo de aplicativo](/assets/images/settings/apps_choose_app.png)
+1. Na barra lateral esquerda, clique em **Aplicativos OAuth** ou **Aplicativos GitHub** dependendo da listagem de {% data variables.product.prodname_marketplace %} que você gostaria de gerenciar. **Observação:** Você também pode gerenciar sua listagem acessando https://github.com/marketplace/manage. ![Seleção do tipo de aplicativo](/assets/images/settings/apps_choose_app.png)
 
 {% endif %}
diff --git a/translations/pt-BR/data/reusables/user-settings/modify_github_app.md b/translations/pt-BR/data/reusables/user-settings/modify_github_app.md
index 3f121f6e8a77..0cb3b8ee29c7 100644
--- a/translations/pt-BR/data/reusables/user-settings/modify_github_app.md
+++ b/translations/pt-BR/data/reusables/user-settings/modify_github_app.md
@@ -1 +1 @@
-1. Select the GitHub App you want to modify. ![Seleção de aplicativo](/assets/images/github-apps/github_apps_select-app.png)
+1. Selecione o aplicativo do GitHub que você deseja modificar. ![Seleção de aplicativo](/assets/images/github-apps/github_apps_select-app.png)
diff --git a/translations/pt-BR/data/reusables/user-settings/oauth_apps.md b/translations/pt-BR/data/reusables/user-settings/oauth_apps.md
index 044bdb452a9f..1e6b374ce2ce 100644
--- a/translations/pt-BR/data/reusables/user-settings/oauth_apps.md
+++ b/translations/pt-BR/data/reusables/user-settings/oauth_apps.md
@@ -1 +1 @@
-1. In the left sidebar, click **OAuth Apps**. ![OAuth Apps section](/assets/images/settings/oauth_apps_post2dot12.png)
+1. Na barra lateral esquerda, clique em **Aplicativos OAuth**. ![Seção de aplicativos OAuth](/assets/images/settings/oauth_apps_post2dot12.png)
diff --git a/translations/pt-BR/data/reusables/user-settings/update_oauth_app.md b/translations/pt-BR/data/reusables/user-settings/update_oauth_app.md
index 5d0f1ffa7fc2..7c2fb1d896ba 100644
--- a/translations/pt-BR/data/reusables/user-settings/update_oauth_app.md
+++ b/translations/pt-BR/data/reusables/user-settings/update_oauth_app.md
@@ -1 +1 @@
-1. Click **Update application**. ![Button to update the application](/assets/images/oauth-apps/oauth_apps_update_application.png)
+1. Clique em **atualizar aplicativo**. ![Botão para atualizar o aplicativo](/assets/images/oauth-apps/oauth_apps_update_application.png)
diff --git a/translations/pt-BR/data/reusables/user_settings/access_applications.md b/translations/pt-BR/data/reusables/user_settings/access_applications.md
index 3ab4ec5be539..bb76f4e95eff 100644
--- a/translations/pt-BR/data/reusables/user_settings/access_applications.md
+++ b/translations/pt-BR/data/reusables/user_settings/access_applications.md
@@ -1 +1 @@
-1. Na barra lateral esquerda, clique em **Applications** (Aplicativos). ![Applications tab](/assets/images/help/settings/settings-applications.png)
+1. Na barra lateral esquerda, clique em **Applications** (Aplicativos). ![Aba aplicativos](/assets/images/help/settings/settings-applications.png)
diff --git a/translations/pt-BR/data/reusables/user_settings/access_authorized_oauth_apps.md b/translations/pt-BR/data/reusables/user_settings/access_authorized_oauth_apps.md
index e46ffeabe5d2..5df57620dc72 100644
--- a/translations/pt-BR/data/reusables/user_settings/access_authorized_oauth_apps.md
+++ b/translations/pt-BR/data/reusables/user_settings/access_authorized_oauth_apps.md
@@ -1 +1 @@
-1. Click the **Authorized OAuth Apps** tab. ![Authorized OAuth Apps tab](/assets/images/help/settings/settings-authorized-oauth-apps-tab.png)
+1. Clique na aba Aplicativos OAuth autorizados**. ![Aba de aplicativos OAuth autorizados](/assets/images/help/settings/settings-authorized-oauth-apps-tab.png) 
diff --git a/translations/pt-BR/data/reusables/user_settings/access_settings.md b/translations/pt-BR/data/reusables/user_settings/access_settings.md
index 0d3ab7755ebf..496d4c15b844 100644
--- a/translations/pt-BR/data/reusables/user_settings/access_settings.md
+++ b/translations/pt-BR/data/reusables/user_settings/access_settings.md
@@ -1 +1 @@
-1. In the upper-right corner of any page, click your profile photo, then click **Settings**. ![Ícone Settings (Configurações) na barra de usuário](/assets/images/help/settings/userbar-account-settings.png)
+1. No canto superior direito de qualquer página, clique na sua foto de perfil e, em seguida, clique em **Configurações**. ![Ícone Settings (Configurações) na barra de usuário](/assets/images/help/settings/userbar-account-settings.png)
diff --git a/translations/pt-BR/data/reusables/user_settings/account_settings.md b/translations/pt-BR/data/reusables/user_settings/account_settings.md
index 3573c7912354..d38751140a6e 100644
--- a/translations/pt-BR/data/reusables/user_settings/account_settings.md
+++ b/translations/pt-BR/data/reusables/user_settings/account_settings.md
@@ -1 +1 @@
-1. In the left sidebar, click **Account**. ![Account settings menu option](/assets/images/help/settings/settings-sidebar-account-settings.png)
+1. Na barra lateral esquerda, clique em **Conta**. ![Opção do menu configurações da conta](/assets/images/help/settings/settings-sidebar-account-settings.png)
diff --git a/translations/pt-BR/data/reusables/user_settings/add_and_verify_email.md b/translations/pt-BR/data/reusables/user_settings/add_and_verify_email.md
index 275ca27a34a1..0ed3fb54c75f 100644
--- a/translations/pt-BR/data/reusables/user_settings/add_and_verify_email.md
+++ b/translations/pt-BR/data/reusables/user_settings/add_and_verify_email.md
@@ -1,2 +1,2 @@
-1. In "Add email address", type your email address and click **Add**. ![Email addition button](/assets/images/help/settings/add-email-address.png){% if currentVersion == "free-pro-team@latest" %}
-2. [Verify your email address](/articles/verifying-your-email-address).{% endif %}
+1. Em "Adicionar endereço de e-mail", digite seu endereço de e-mail e clique em **Adicionar**. ![Email addition button](/assets/images/help/settings/add-email-address.png){% if currentVersion == "free-pro-team@latest" %}
+2. [Verifique seu endereço de e-mail](/articles/verifying-your-email-address).{% endif %}
diff --git a/translations/pt-BR/data/reusables/user_settings/automatic_watching_box.md b/translations/pt-BR/data/reusables/user_settings/automatic_watching_box.md
index def1209fbe9d..2f22c2504c54 100644
--- a/translations/pt-BR/data/reusables/user_settings/automatic_watching_box.md
+++ b/translations/pt-BR/data/reusables/user_settings/automatic_watching_box.md
@@ -1 +1 @@
-1. Under "Automatic watching,"
+1. Em "Inspeção automática"
diff --git a/translations/pt-BR/data/reusables/user_settings/billing.md b/translations/pt-BR/data/reusables/user_settings/billing.md
index 72ca33009a7f..0a80aabdd9d3 100644
--- a/translations/pt-BR/data/reusables/user_settings/billing.md
+++ b/translations/pt-BR/data/reusables/user_settings/billing.md
@@ -1 +1 @@
-1. In your user settings sidebar, click **Billing**. ![Configurações de faturamento](/assets/images/help/settings/settings-sidebar-billing.png)
+1. Na barra lateral de configurações do usuário, clique em **Cobrança**. ![Configurações de faturamento](/assets/images/help/settings/settings-sidebar-billing.png)
diff --git a/translations/pt-BR/data/reusables/user_settings/blocked_users.md b/translations/pt-BR/data/reusables/user_settings/blocked_users.md
index 14c9120c073f..c1afb12a072f 100644
--- a/translations/pt-BR/data/reusables/user_settings/blocked_users.md
+++ b/translations/pt-BR/data/reusables/user_settings/blocked_users.md
@@ -1 +1 @@
-1. In your user settings sidebar, click **Blocked users**. ![Blocked users tab](/assets/images/help/settings/settings-sidebar-blocked-users.png)
+1. Na barra lateral de configurações do usuário, clique em **Usuários bloqueados**. ![Aba de usuários bloqueados](/assets/images/help/settings/settings-sidebar-blocked-users.png)
diff --git a/translations/pt-BR/data/reusables/user_settings/deleted-repos.md b/translations/pt-BR/data/reusables/user_settings/deleted-repos.md
index fe628c349cfa..6f02b957628d 100644
--- a/translations/pt-BR/data/reusables/user_settings/deleted-repos.md
+++ b/translations/pt-BR/data/reusables/user_settings/deleted-repos.md
@@ -1 +1 @@
-1. Under "Repositories", click **Deleted repositories**. ![Aba de repositórios excluídos](/assets/images/help/settings/deleted-repos.png)
+1. Em "Repositórios", clique em **Repositórios excluídos**. ![Aba de repositórios excluídos](/assets/images/help/settings/deleted-repos.png)
diff --git a/translations/pt-BR/data/reusables/user_settings/emails.md b/translations/pt-BR/data/reusables/user_settings/emails.md
index c23bccd83ad1..4f34bf9d4d60 100644
--- a/translations/pt-BR/data/reusables/user_settings/emails.md
+++ b/translations/pt-BR/data/reusables/user_settings/emails.md
@@ -1 +1 @@
-1. In the left sidebar, click **Emails**. ![Emails tab](/assets/images/help/settings/settings-sidebar-emails.png)
+1. Na barra lateral esquerda, clique em **E-mails**. ![Aba de e-mails](/assets/images/help/settings/settings-sidebar-emails.png)
diff --git a/translations/pt-BR/data/reusables/user_settings/export-data.md b/translations/pt-BR/data/reusables/user_settings/export-data.md
index ad9ef42e6826..99c79378529b 100644
--- a/translations/pt-BR/data/reusables/user_settings/export-data.md
+++ b/translations/pt-BR/data/reusables/user_settings/export-data.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-Você pode exportar e revisar os metadados que {% data variables.product.product_name %} armazena sobre sua conta pessoal.
+Você pode exportar e rever os metadados que
+{% data variables.product.product_name %} armazena sobre a sua conta pessoal.
 {% endif %}
diff --git a/translations/pt-BR/data/reusables/user_settings/jira_help_docs.md b/translations/pt-BR/data/reusables/user_settings/jira_help_docs.md
index f6ff7de261d3..7fd16b9a2aa7 100644
--- a/translations/pt-BR/data/reusables/user_settings/jira_help_docs.md
+++ b/translations/pt-BR/data/reusables/user_settings/jira_help_docs.md
@@ -1 +1 @@
-1. Link your GitHub account with Jira. For more information, see [Atlassian's help documentation.](https://confluence.atlassian.com/adminjiracloud/connect-jira-cloud-to-github-814188429.html)
+1. Vincule a sua conta do GitHub ao Jira. Para obter mais informações, consulte a [documentação de ajuda do Atlassian.](https://confluence.atlassian.com/adminjiracloud/connect-jira-cloud-to-github-814188429.html)
diff --git a/translations/pt-BR/data/reusables/user_settings/keeping_your_email_address_private.md b/translations/pt-BR/data/reusables/user_settings/keeping_your_email_address_private.md
index cabc7cc611f5..236230306ede 100644
--- a/translations/pt-BR/data/reusables/user_settings/keeping_your_email_address_private.md
+++ b/translations/pt-BR/data/reusables/user_settings/keeping_your_email_address_private.md
@@ -1 +1 @@
-5. To keep your email address private when performing web-based Git operations, click **Keep my email address private**. ![Image of checkbox to keep your email address private](/assets/images/help/settings/email_privacy.png)
+5. Para manter seu endereço de e-mail privado ao realizar operações do Git baseadas na web, clique em **Manter meu endereço de e-mail privado**. ![Imagem da caixa de seleção para manter seu endereço de e-mail privado](/assets/images/help/settings/email_privacy.png)
diff --git a/translations/pt-BR/data/reusables/user_settings/link_email_with_your_account.md b/translations/pt-BR/data/reusables/user_settings/link_email_with_your_account.md
index 76c606dd7c20..7aec62d239aa 100644
--- a/translations/pt-BR/data/reusables/user_settings/link_email_with_your_account.md
+++ b/translations/pt-BR/data/reusables/user_settings/link_email_with_your_account.md
@@ -1 +1 @@
-Add the email address to your {% data variables.product.product_name %} account by [setting your commit email address](/articles/setting-your-commit-email-address), so that your commits are attributed to you and appear in your contributions graph.
+Adicione o endereço de e-mail à sua conta de {% data variables.product.product_name %} [definindo seu endereço de e-mail do commit](/articles/setting-your-commit-email-address), para que seus commits sejam atribuídos a você e apareçam no seu gráfico de contribuições.
diff --git a/translations/pt-BR/data/reusables/user_settings/no-verification-disposable-emails.md b/translations/pt-BR/data/reusables/user_settings/no-verification-disposable-emails.md
index 66bd3b9df799..5fb9adbfedd9 100644
--- a/translations/pt-BR/data/reusables/user_settings/no-verification-disposable-emails.md
+++ b/translations/pt-BR/data/reusables/user_settings/no-verification-disposable-emails.md
@@ -1 +1 @@
-You cannot verify email addresses from disposable domains. If you'd like to keep your email address private, you can use a {% data variables.product.product_name %}-provided `noreply` email address. For more information, see "[Setting your commit email address on {% data variables.product.prodname_dotcom %}](/articles/setting-your-commit-email-address#setting-your-commit-email-address-on-github)."
+Você não pode verificar endereços de e-mail de domínios descartáveis. Se você quiser manter seu endereço de e-mail privado, você pode usar um endereço de e-mail com o endereço de e-mail `noreply` fornecido por {% data variables.product.product_name %}. Para obter mais informações, consulte "[Definir o seu endereço de e-mail de commit em {% data variables.product.prodname_dotcom %}](/articles/setting-your-commit-email-address#setting-your-commit-email-address-on-github)".
diff --git a/translations/pt-BR/data/reusables/user_settings/notifications.md b/translations/pt-BR/data/reusables/user_settings/notifications.md
index e4b3e7fb27eb..58db0e065981 100644
--- a/translations/pt-BR/data/reusables/user_settings/notifications.md
+++ b/translations/pt-BR/data/reusables/user_settings/notifications.md
@@ -1 +1 @@
-1. In the user settings sidebar, click **Notifications**. ![Notification center](/assets/images/help/settings/settings-sidebar-notifications.png)
+1. Na barra de configurações do usuário, clique em **Notificações**. ![Central de notificações](/assets/images/help/settings/settings-sidebar-notifications.png)
diff --git a/translations/pt-BR/data/reusables/user_settings/organizations.md b/translations/pt-BR/data/reusables/user_settings/organizations.md
index f729c3bf1ab4..02c25b721783 100644
--- a/translations/pt-BR/data/reusables/user_settings/organizations.md
+++ b/translations/pt-BR/data/reusables/user_settings/organizations.md
@@ -1 +1 @@
-1. In your user settings sidebar, click **Organizations**. ![User settings for organizations](/assets/images/help/settings/settings-user-orgs.png)
+1. Na barra lateral de configurações do usuário, clique em **Organizações**. ![Configurações do usuário para organizações](/assets/images/help/settings/settings-user-orgs.png)
diff --git a/translations/pt-BR/data/reusables/user_settings/password-authentication-deprecation-desktop.md b/translations/pt-BR/data/reusables/user_settings/password-authentication-deprecation-desktop.md
index cb23969e5b96..107f8d47539e 100644
--- a/translations/pt-BR/data/reusables/user_settings/password-authentication-deprecation-desktop.md
+++ b/translations/pt-BR/data/reusables/user_settings/password-authentication-deprecation-desktop.md
@@ -1,5 +1,5 @@
   {% warning %}
 
-  **Warning**: Authenticating to {% data variables.product.prodname_dotcom %} using your username and password is deprecated. We recommend authenticating using the browser instead.
+  **Aviso**: Efetuar a autenticação em {% data variables.product.prodname_dotcom %} usando seu nome de usuário e senha está em desuso. Em vez disso, recomendamos efetuar a autenticação usando o navegador.
 
   {% endwarning %}
diff --git a/translations/pt-BR/data/reusables/user_settings/password-authentication-deprecation.md b/translations/pt-BR/data/reusables/user_settings/password-authentication-deprecation.md
index e7b333cbf71f..7b30fa1b4814 100644
--- a/translations/pt-BR/data/reusables/user_settings/password-authentication-deprecation.md
+++ b/translations/pt-BR/data/reusables/user_settings/password-authentication-deprecation.md
@@ -1 +1 @@
-Password-based authentication for Git is deprecated, and we recommend using a personal access token (PAT) when prompted for a password instead, which is more secure. Treat your token just like a password. Para mais informação, consulte "[Criando um token de acesso pessoal](/github/authenticating-to-github/creating-a-personal-access-token)."
\ No newline at end of file
+A autenticação baseada em senha para o Git está obsoleta. Além disso, recomendamos usar um token de acesso pessoal (PAT) quando se solicita uma senha, que é mais seguro. Trate o seu token como uma senha. Para mais informação, consulte "[Criando um token de acesso pessoal](/github/authenticating-to-github/creating-a-personal-access-token)."
diff --git a/translations/pt-BR/data/reusables/user_settings/payment-info-tab.md b/translations/pt-BR/data/reusables/user_settings/payment-info-tab.md
index 8b91c8b20466..d85a61c190f5 100644
--- a/translations/pt-BR/data/reusables/user_settings/payment-info-tab.md
+++ b/translations/pt-BR/data/reusables/user_settings/payment-info-tab.md
@@ -1 +1 @@
-1. Click **Payment information**. ![Payment information tab](/assets/images/help/settings/payment-info-tab.png)
+1. Clique em **Informações de pagamento**. ![Aba de informações de pagamento](/assets/images/help/settings/payment-info-tab.png)
diff --git a/translations/pt-BR/data/reusables/user_settings/personal_access_tokens.md b/translations/pt-BR/data/reusables/user_settings/personal_access_tokens.md
index a027ed28fbcf..80b1ecedf507 100644
--- a/translations/pt-BR/data/reusables/user_settings/personal_access_tokens.md
+++ b/translations/pt-BR/data/reusables/user_settings/personal_access_tokens.md
@@ -1 +1 @@
-1. In the left sidebar, click **Personal access tokens**. ![Tokens de acesso pessoal](/assets/images/help/settings/personal_access_tokens_tab.png)
+1. Na barra lateral esquerda, clique em **tokens de acesso pessoal**. ![Tokens de acesso pessoal](/assets/images/help/settings/personal_access_tokens_tab.png)
diff --git a/translations/pt-BR/data/reusables/user_settings/personal_dashboard.md b/translations/pt-BR/data/reusables/user_settings/personal_dashboard.md
index 07083b821d07..36a832a48e5c 100644
--- a/translations/pt-BR/data/reusables/user_settings/personal_dashboard.md
+++ b/translations/pt-BR/data/reusables/user_settings/personal_dashboard.md
@@ -1 +1 @@
-{% if currentVersion == "free-pro-team@latest" %}[personal dashboard](https://github.com/dashboard){% else %}personal dashboard (`https://[hostname]/dashboard`){% endif %}
+{% if currentVersion == "free-pro-team@latest" %}[painel pessoal](https://github.com/dashboard){% else %}painel pessoal (`https://[hostname]/dashboard`){% endif %}
diff --git a/translations/pt-BR/data/reusables/user_settings/restore-confirmation.md b/translations/pt-BR/data/reusables/user_settings/restore-confirmation.md
index daa9deed5ff5..91ffaf9579bf 100644
--- a/translations/pt-BR/data/reusables/user_settings/restore-confirmation.md
+++ b/translations/pt-BR/data/reusables/user_settings/restore-confirmation.md
@@ -1 +1 @@
-1. Read the warning, then click **I understand, restore this repository**. ![Button to confirm restoration](/assets/images/help/settings/confirm-restoration-button.png)
+1. Leia o aviso e clique **Eu compreendo. Restaure este repositório**. ![Botão para confirmar restauração](/assets/images/help/settings/confirm-restoration-button.png)
diff --git a/translations/pt-BR/data/reusables/user_settings/restore-repo.md b/translations/pt-BR/data/reusables/user_settings/restore-repo.md
index f6faecf5c651..07672e807532 100644
--- a/translations/pt-BR/data/reusables/user_settings/restore-repo.md
+++ b/translations/pt-BR/data/reusables/user_settings/restore-repo.md
@@ -1 +1 @@
-1. Next to the repository you want to restore, click **Restore**. ![Restore button](/assets/images/help/settings/restore-button.png)
+1. Ao lado do repositório que você deseja restaurar, clique em **Restaurar**. ![Botão de restaurar](/assets/images/help/settings/restore-button.png)
diff --git a/translations/pt-BR/data/reusables/user_settings/review-oauth-apps.md b/translations/pt-BR/data/reusables/user_settings/review-oauth-apps.md
index 2c0af4bf0a07..d7afa6912530 100644
--- a/translations/pt-BR/data/reusables/user_settings/review-oauth-apps.md
+++ b/translations/pt-BR/data/reusables/user_settings/review-oauth-apps.md
@@ -1 +1 @@
-1. Review the tokens that have access to your account. For those that you don't recognize or that are out-of-date, click **{% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}**, then click **Revoke**. To revoke all tokens, click **Revoke all**. ![List of authorized {% data variables.product.prodname_oauth_app %}s](/assets/images/help/settings/revoke-oauth-app.png)
+1. Revise os tokens que têm acesso à sua conta. Para aqueles que você não reconhece ou que estão desatualizados, clique em **{% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}**e, em seguida, clique em **Revogar**. Para revogar todos os tokens, clique **Revogar todos**. ![Lista de {% data variables.product.prodname_oauth_app %}s autorizados](/assets/images/help/settings/revoke-oauth-app.png)
diff --git a/translations/pt-BR/data/reusables/user_settings/review_oauth_tokens_tip.md b/translations/pt-BR/data/reusables/user_settings/review_oauth_tokens_tip.md
index 17fb05ffd0d0..e97f8919e8cc 100644
--- a/translations/pt-BR/data/reusables/user_settings/review_oauth_tokens_tip.md
+++ b/translations/pt-BR/data/reusables/user_settings/review_oauth_tokens_tip.md
@@ -1 +1 @@
-We recommend that you regularly review your authorized integrations. Remove any applications and tokens that haven't been used in a while. For more information, see "[Reviewing your authorized integrations](/articles/reviewing-your-authorized-integrations)."
+Recomendamos que você revise regularmente as integrações autorizadas. Remova todos os aplicativos e tokens que não tenham sido usados por um tempo. Para obter mais informações, consulte "[Revisar integrações autorizadas](/articles/reviewing-your-authorized-integrations)".
diff --git a/translations/pt-BR/data/reusables/user_settings/saved_replies.md b/translations/pt-BR/data/reusables/user_settings/saved_replies.md
index 31b4fb899fef..72b799bc4674 100644
--- a/translations/pt-BR/data/reusables/user_settings/saved_replies.md
+++ b/translations/pt-BR/data/reusables/user_settings/saved_replies.md
@@ -1 +1 @@
-1. In the left sidebar, click **Saved replies**. ![Saved replies tab](/assets/images/help/settings/saved-replies-tab.png)
+1. Na barra lateral esquerda, clique em **Respostas salvas**. ![Aba de respostas salvas](/assets/images/help/settings/saved-replies-tab.png)
diff --git a/translations/pt-BR/data/reusables/user_settings/security-analysis.md b/translations/pt-BR/data/reusables/user_settings/security-analysis.md
index fa93653f76a0..80161d67b5dd 100644
--- a/translations/pt-BR/data/reusables/user_settings/security-analysis.md
+++ b/translations/pt-BR/data/reusables/user_settings/security-analysis.md
@@ -1 +1 @@
-1. Na barra lateral esquerda, clique em **Security & analysis** (Segurança e análise). ![Security and analysis settings](/assets/images/help/settings/settings-sidebar-security-analysis.png)
+1. Na barra lateral esquerda, clique em **Security & analysis** (Segurança e análise). ![Configurações de segurança e análise](/assets/images/help/settings/settings-sidebar-security-analysis.png)
diff --git a/translations/pt-BR/data/reusables/user_settings/security.md b/translations/pt-BR/data/reusables/user_settings/security.md
index c33e98ea3a96..72e4cc411fa3 100644
--- a/translations/pt-BR/data/reusables/user_settings/security.md
+++ b/translations/pt-BR/data/reusables/user_settings/security.md
@@ -1,4 +1,4 @@
-{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}1. In the left sidebar, click **Account security**.
-![User account security settings](/assets/images/help/settings/settings-sidebar-account-security.png)
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}1. Na barra lateral esquerda, clique em **segurança da conta**.
+![Configurações de segurança da conta do usuário](/assets/images/help/settings/settings-sidebar-account-security.png)
 {% else %}1. Na barra lateral esquerda, clique em **Security** (Segurança).
-![User account security settings](/assets/images/help/settings/settings-sidebar-security.png){% endif %}
+![Configurações de segurança da conta do usuário](/assets/images/help/settings/settings-sidebar-security.png){% endif %}
diff --git a/translations/pt-BR/data/reusables/user_settings/select_primary_email.md b/translations/pt-BR/data/reusables/user_settings/select_primary_email.md
index 7911ab147b96..15eb776af595 100644
--- a/translations/pt-BR/data/reusables/user_settings/select_primary_email.md
+++ b/translations/pt-BR/data/reusables/user_settings/select_primary_email.md
@@ -1 +1 @@
-1. In the "Primary email address" list, select the email address you'd like to associate with your web-based Git operations. ![Selection for primary email address](/assets/images/help/settings/email_primary.png)
+1. Na lista "endereço de e-mail principal", selecione o endereço de e-mail que você gostaria de associar às operações do Git baseadas na web. ![Seleção para endereço de e-mail principal](/assets/images/help/settings/email_primary.png)
diff --git a/translations/pt-BR/data/reusables/user_settings/set_your_email_address_in_git.md b/translations/pt-BR/data/reusables/user_settings/set_your_email_address_in_git.md
index a684e6be948b..85624e647268 100644
--- a/translations/pt-BR/data/reusables/user_settings/set_your_email_address_in_git.md
+++ b/translations/pt-BR/data/reusables/user_settings/set_your_email_address_in_git.md
@@ -1 +1 @@
-Set an email address in Git. You can use {% if currentVersion == "free-pro-team@latest"%}your [{% data variables.product.product_name %}-provided `no-reply` email address](/articles/setting-your-commit-email-address) or {% endif %}any email address.
+Definir um endereço de e-mail no Git. Você pode usar {% if currentVersion == "free-pro-team@latest"%}seu endereço de e-mail `no-reply` fornecido por [{% data variables.product.product_name %} ](/articles/setting-your-commit-email-address) ou {% endif %}qualquer endereço de e-mail.
diff --git a/translations/pt-BR/data/reusables/user_settings/ssh.md b/translations/pt-BR/data/reusables/user_settings/ssh.md
index 0759b59bab27..52468bf7305b 100644
--- a/translations/pt-BR/data/reusables/user_settings/ssh.md
+++ b/translations/pt-BR/data/reusables/user_settings/ssh.md
@@ -1 +1 @@
-1. In the user settings sidebar, click **SSH and GPG keys**. ![Authentication keys](/assets/images/help/settings/settings-sidebar-ssh-keys.png)
+1. Na barra lateral de configurações do usuário, clique em **chaves SSH e GPG**. ![Chaves de autenticação](/assets/images/help/settings/settings-sidebar-ssh-keys.png)
diff --git a/translations/pt-BR/data/reusables/user_settings/subscriptions-tab.md b/translations/pt-BR/data/reusables/user_settings/subscriptions-tab.md
index fd38583262bb..3f467144510c 100644
--- a/translations/pt-BR/data/reusables/user_settings/subscriptions-tab.md
+++ b/translations/pt-BR/data/reusables/user_settings/subscriptions-tab.md
@@ -1 +1 @@
-1. Click **Subscriptions**. ![Aba Subscriptions (Assinaturas)](/assets/images/help/settings/subscriptions-tab.png)
+1. Clique em **Assinaturas**. ![Aba Subscriptions (Assinaturas)](/assets/images/help/settings/subscriptions-tab.png)
diff --git a/translations/pt-BR/data/reusables/user_settings/sudo-mode-popup.md b/translations/pt-BR/data/reusables/user_settings/sudo-mode-popup.md
index ece3765ec633..ef1dc522f471 100644
--- a/translations/pt-BR/data/reusables/user_settings/sudo-mode-popup.md
+++ b/translations/pt-BR/data/reusables/user_settings/sudo-mode-popup.md
@@ -1 +1 @@
-1. Se solicitado, confirme sua senha do {% data variables.product.product_name %}.![Caixa de diálogo Sudo mode (Modo sudo)](/assets/images/help/settings/sudo_mode_popup.png)
\ No newline at end of file
+1. Se solicitado, confirme sua senha do {% data variables.product.product_name %}.![Caixa de diálogo Sudo mode (Modo sudo)](/assets/images/help/settings/sudo_mode_popup.png)
diff --git a/translations/pt-BR/data/reusables/user_settings/verify-org-approved-email-domain.md b/translations/pt-BR/data/reusables/user_settings/verify-org-approved-email-domain.md
index 7d7c0558606c..096f74a22042 100644
--- a/translations/pt-BR/data/reusables/user_settings/verify-org-approved-email-domain.md
+++ b/translations/pt-BR/data/reusables/user_settings/verify-org-approved-email-domain.md
@@ -1 +1 @@
-If an organization you're a member of restricts email notifications to an approved email domain, you'll need to verify an email address in that domain to receive email notifications about activity in the organization. Para obter mais informações, consulte "[Restringir notificações de e-mail a um domínio aprovado](/articles/restricting-email-notifications-to-an-approved-domain)."
+Se uma organização da qual você é integrante restringe as notificações de e-mail para um domínio de e-mail aprovado, você precisará verificar um endereço de e-mail nesse domínio para receber notificações sobre a atividade na organização. Para obter mais informações, consulte "[Restringir notificações de e-mail a um domínio aprovado](/articles/restricting-email-notifications-to-an-approved-domain)."
diff --git a/translations/pt-BR/data/reusables/webhooks/action_type_desc.md b/translations/pt-BR/data/reusables/webhooks/action_type_desc.md
index 3342e6e1c6ec..744a84a6be97 100644
--- a/translations/pt-BR/data/reusables/webhooks/action_type_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/action_type_desc.md
@@ -1 +1 @@
-The type of activity is specified in the `action` property of the payload object.
\ No newline at end of file
+O tipo de atividade é especificado na propriedade `ação` do objeto da carga.
diff --git a/translations/pt-BR/data/reusables/webhooks/app_desc.md b/translations/pt-BR/data/reusables/webhooks/app_desc.md
index 9dbfd79e4d6f..7376c01820a4 100644
--- a/translations/pt-BR/data/reusables/webhooks/app_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/app_desc.md
@@ -1 +1 @@
-`installation` | `object` | The {% data variables.product.prodname_github_app %} installation. Webhook payloads contain the `installation` property when the event is configured for and sent to a {% data variables.product.prodname_github_app %}.
\ No newline at end of file
+`instalação` | `objeto` | A instalação de {% data variables.product.prodname_github_app %}. As cargas de webhook contêm a propriedade `instalação` quando o evento é configurado para um {% data variables.product.prodname_github_app %}.
diff --git a/translations/pt-BR/data/reusables/webhooks/authorization_event.md b/translations/pt-BR/data/reusables/webhooks/authorization_event.md
index 4afc18c3f41b..8dc90d89484d 100644
--- a/translations/pt-BR/data/reusables/webhooks/authorization_event.md
+++ b/translations/pt-BR/data/reusables/webhooks/authorization_event.md
@@ -1 +1 @@
-Anyone can revoke their authorization of a GitHub App from their [GitHub account settings page](https://github.com/settings/apps/authorizations). Revoking the authorization of a GitHub App does not uninstall the GitHub App. You should program your GitHub App so that when it receives this webhook, it stops calling the API on behalf of the person who revoked the token. If your GitHub App continues to use a revoked access token, it will receive the `401 Bad Credentials` error.
+Qualquer pessoa pode revogar a autorização de um aplicativo GitHub a partir da sua [página de configurações de conta do GitHub](https://github.com/settings/apps/authorizations). Revogar a autorização de um aplicativo GitHub não desinstala o aplicativo GitHub. Você deve programar seu aplicativo do GitHub para que, ao receber esse webhook, ele para de chamar a API em nome da pessoa que revogou o token. Se o seu aplicativo GitHub continuar usando um token de acesso revogado, ele receberá a mensagem de erro `401 Bad Credentials`.
diff --git a/translations/pt-BR/data/reusables/webhooks/check_run_properties.md b/translations/pt-BR/data/reusables/webhooks/check_run_properties.md
index 6b242411c972..327331acb0e8 100644
--- a/translations/pt-BR/data/reusables/webhooks/check_run_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/check_run_properties.md
@@ -1,10 +1,10 @@
-| Tecla                          | Tipo      | Descrição                                                                                                                                                                                                                                                                                                             |
-| ------------------------------ | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `Ação`                         | `string`  | A ação realizada. Pode ser uma das ações a seguir: 
    •  `created` - A new check run was created.
    •  `completed` - The `status` of the check run is `completed`.
    •  `rerequested` - Someone requested to re-run your check run from the pull request UI. See "[About status checks](/articles/about-status-checks#checks)" for more details about the GitHub UI. When you receive a `rerequested` action, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run). Only the {% data variables.product.prodname_github_app %} that someone requests to re-run the check will receive the `rerequested` payload.
    •  `requested_action` - Someone requested an action your app provides to be taken. Only the {% data variables.product.prodname_github_app %} someone requests to perform an action will receive the `requested_action` payload. To learn more about check runs and requested actions, see "[Check runs and requested actions](/v3/checks/runs/#check-runs-and-requested-actions)."
                                                                                                                                                                                                                                               |
-| `check_run`                    | `objeto`  | The [check_run](/v3/checks/runs/#get-a-check-run).                                                                                                                                                                                                                                                                    |
-| `check_run[status]`            | `string`  | The current status of the check run. Can be `queued`, `in_progress`, or `completed`.                                                                                                                                                                                                                                  |
+| Tecla                          | Tipo      | Descrição                                                                                                                                                                                                                                                                                                                                                 |
+| ------------------------------ | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `Ação`                         | `string`  | A ação realizada. Pode ser uma das ações a seguir: 
    •  `created` - A new check run was created.
    •  `completed` - The `status` of the check run is `completed`.
    •  `rerequested` - Someone requested to re-run your check run from the pull request UI. See "[About status checks](/articles/about-status-checks#checks)" for more details about the GitHub UI. When you receive a `rerequested` action, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run). Only the {% data variables.product.prodname_github_app %} that someone requests to re-run the check will receive the `rerequested` payload.
    •  `requested_action` - Someone requested an action your app provides to be taken. Only the {% data variables.product.prodname_github_app %} someone requests to perform an action will receive the `requested_action` payload. To learn more about check runs and requested actions, see "[Check runs and requested actions](/v3/checks/runs/#check-runs-and-requested-actions)."
                                                                                                                                                                                                                                                                                   |
+| `check_run`                    | `objeto`  | The [check_run](/v3/checks/runs/#get-a-check-run).                                                                                                                                                                                                                                                                                                        |
+| `check_run[status]`            | `string`  | The current status of the check run. Can be `queued`, `in_progress`, or `completed`.                                                                                                                                                                                                                                                                      |
 | `check_run[conclusion]`        | `string`  | The result of the completed check run. Can be one of `success`, `failure`, `neutral`, `cancelled`, `timed_out`,  {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}`action_required` or `stale`{% else %}or `action_required`{% endif %}. This value will be `null` until the check run has `completed`. |
-| `check_run[name]`              | `string`  | The name of the check run.                                                                                                                                                                                                                                                                                            |
-| `check_run[check_suite][id]`   | `inteiro` | The id of the check suite that this check run is part of.                                                                                                                                                                                                                                                             |
-| `requested_action`             | `objeto`  | The action requested by the user.                                                                                                                                                                                                                                                                                     |
-| `requested_action[identifier]` | `string`  | The integrator reference of the action requested by the user.                                                                                                                                                                                                                                                         |
\ No newline at end of file
+| `check_run[name]`              | `string`  | The name of the check run.                                                                                                                                                                                                                                                                                                                                |
+| `check_run[check_suite][id]`   | `inteiro` | The id of the check suite that this check run is part of.                                                                                                                                                                                                                                                                                                 |
+| `requested_action`             | `objeto`  | The action requested by the user.                                                                                                                                                                                                                                                                                                                         |
+| `requested_action[identifier]` | `string`  | The integrator reference of the action requested by the user.                                                                                                                                                                                                                                                                                             |
diff --git a/translations/pt-BR/data/reusables/webhooks/check_run_short_desc.md b/translations/pt-BR/data/reusables/webhooks/check_run_short_desc.md
index 305bd1626e33..a0c48c63dca5 100644
--- a/translations/pt-BR/data/reusables/webhooks/check_run_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/check_run_short_desc.md
@@ -1 +1 @@
-Check run activity has occurred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[check runs](/v3/checks/runs/)" REST API.
\ No newline at end of file
+Verifique se a atividade de execução ocorreu. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte a API REST de "[execuções de verificação](/v3/checks/runs/)".
diff --git a/translations/pt-BR/data/reusables/webhooks/check_suite_properties.md b/translations/pt-BR/data/reusables/webhooks/check_suite_properties.md
index 3d8ce7488f49..e365b9d239da 100644
--- a/translations/pt-BR/data/reusables/webhooks/check_suite_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/check_suite_properties.md
@@ -1,10 +1,10 @@
-| Tecla                        | Tipo     | Descrição                                                                                                                                                                                                                                                                                                                                                  |
-| ---------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `Ação`                       | `string` | A ação realizada. Can be:
    • `completed` - All check runs in a check suite have completed.
    • `requested` - Occurs when new code is pushed to the app's repository. When you receive the `requested` action events, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run).
    • `rerequested` - Occurs when someone requests to re-run the entire check suite from the pull request UI. When you receive the `rerequested` action events, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run). See "[About status checks](/articles/about-status-checks#checks)" for more details about the GitHub UI.
                                                                                                                                                                                                                                                                                                             |
-| `check_suite`                | `objeto` | The [check_suite](/v3/checks/suites/).                                                                                                                                                                                                                                                                                                                     |
-| `check_suite[head_branch]`   | `string` | The head branch name the changes are on.                                                                                                                                                                                                                                                                                                                   |
-| `check_suite[head_sha]`      | `string` | The SHA of the most recent commit for this check suite.                                                                                                                                                                                                                                                                                                    |
-| `check_suite[status]`        | `string` | The summary status for all check runs that are part of the check suite. Can be `requested`, `in_progress`, or `completed`.                                                                                                                                                                                                                                 |
+| Tecla                        | Tipo     | Descrição                                                                                                                                                                                                                                                                                                                                                                                      |
+| ---------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `Ação`                       | `string` | A ação realizada. Can be:
    • `completed` - All check runs in a check suite have completed.
    • `requested` - Occurs when new code is pushed to the app's repository. When you receive the `requested` action events, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run).
    • `rerequested` - Occurs when someone requests to re-run the entire check suite from the pull request UI. When you receive the `rerequested` action events, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run). See "[About status checks](/articles/about-status-checks#checks)" for more details about the GitHub UI.
                                                                                                                                                                                                                                                                                                                                                 |
+| `check_suite`                | `objeto` | The [check_suite](/v3/checks/suites/).                                                                                                                                                                                                                                                                                                                                                         |
+| `check_suite[head_branch]`   | `string` | The head branch name the changes are on.                                                                                                                                                                                                                                                                                                                                                       |
+| `check_suite[head_sha]`      | `string` | The SHA of the most recent commit for this check suite.                                                                                                                                                                                                                                                                                                                                        |
+| `check_suite[status]`        | `string` | The summary status for all check runs that are part of the check suite. Can be `requested`, `in_progress`, or `completed`.                                                                                                                                                                                                                                                                     |
 | `check_suite[conclusion]`    | `string` | The summary conclusion for all check runs that are part of the check suite. Can be one of `success`, `failure`, `neutral`, `cancelled`, `timed_out`,  {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}`action_required` or `stale`{% else %}or `action_required`{% endif %}. This value will be `null` until the check run has `completed`. |
-| `check_suite[url]`           | `string` | URL that points to the check suite API resource.                                                                                                                                                                                                                                                                                                           |
-| `check_suite[pull_requests]` | `array`  | An array of pull requests that match this check suite. A pull request matches a check suite if they have the same `head_sha` and `head_branch`. When the check suite's `head_branch` is in a forked repository it will be `null` and the `pull_requests` array will be empty.                                                                              |
\ No newline at end of file
+| `check_suite[url]`           | `string` | URL that points to the check suite API resource.                                                                                                                                                                                                                                                                                                                                               |
+| `check_suite[pull_requests]` | `array`  | An array of pull requests that match this check suite. A pull request matches a check suite if they have the same `head_sha` and `head_branch`. When the check suite's `head_branch` is in a forked repository it will be `null` and the `pull_requests` array will be empty.                                                                                                                  |
diff --git a/translations/pt-BR/data/reusables/webhooks/check_suite_short_desc.md b/translations/pt-BR/data/reusables/webhooks/check_suite_short_desc.md
index f7197fc59e48..262c3c6cbad9 100644
--- a/translations/pt-BR/data/reusables/webhooks/check_suite_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/check_suite_short_desc.md
@@ -1 +1 @@
-Check suite activity has occurred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[check suites](/v3/checks/suites/)" REST API.
\ No newline at end of file
+Ocorreu uma atividade de conjuntos de verificações. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte a API REST de"[conjunto de verificações](/v3/checks/suites/)".
diff --git a/translations/pt-BR/data/reusables/webhooks/code_scanning_alert_event_properties.md b/translations/pt-BR/data/reusables/webhooks/code_scanning_alert_event_properties.md
index bd810d071c8d..a8b62caff827 100644
--- a/translations/pt-BR/data/reusables/webhooks/code_scanning_alert_event_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/code_scanning_alert_event_properties.md
@@ -1,6 +1,6 @@
-| Tecla        | Tipo     | Descrição                                                                                                                                                                       |
-| ------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `Ação`       | `string` | A ação que foi executada. This can be one of `created`, `reopened_by_user`, `closed_by_user`, `fixed`, `appeared_in_branch`, or `reopened`.                                     |
-| `alerta`     | `objeto` | The code scanning alert involved in the event.                                                                                                                                  |
-| `ref`        | `string` | The Git reference of the code scanning alert. When the action is `reopened_by_user` or `closed_by_user`,  the event was triggered by the `sender` and this value will be empty. |
-| `commit_oid` | `string` | The commit SHA of the code scanning alert. When the action is `reopened_by_user` or `closed_by_user`,  the event was triggered by the `sender` and this value will be empty.    |
+| Tecla        | Tipo     | Descrição                                                                                                                                                                  |
+| ------------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `Ação`       | `string` | A ação que foi executada. Isto pode ser: `created`, `reopened_by_user`, `closed_by_user`, `fixed`, `appeared_in_branch` ou `reopened`.                                     |
+| `alerta`     | `objeto` | O alerta de varredura de código envolvido no evento.                                                                                                                       |
+| `ref`        | `string` | A referência do Git do alerta de varredura de código. Quando a ação é `reopened_by_user` ou `closed_by_user`, o evento foi acionado pelo `sender` e este valor será vazio. |
+| `commit_oid` | `string` | O SHA de commit do alerta de varredura de código. Quando a ação é `reopened_by_user` ou `closed_by_user`, o evento foi acionado pelo `sender` e este valor será vazio.     |
diff --git a/translations/pt-BR/data/reusables/webhooks/code_scanning_alert_event_short_desc.md b/translations/pt-BR/data/reusables/webhooks/code_scanning_alert_event_short_desc.md
index e246022ed42e..280a1df45896 100644
--- a/translations/pt-BR/data/reusables/webhooks/code_scanning_alert_event_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/code_scanning_alert_event_short_desc.md
@@ -1 +1 @@
-Activity related to code scanning alerts in a repository. The type of activity is specified in the action property of the payload object. For more information, see “[About code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning).”
\ No newline at end of file
+Atividade relacionada a alertas de varredura de código em um repositório. O tipo de atividade é especificado na propriedade ação do objeto da carga. Para obter mais informações, consulte “[Sobre a varredura de código](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning).”
diff --git a/translations/pt-BR/data/reusables/webhooks/commit_comment_properties.md b/translations/pt-BR/data/reusables/webhooks/commit_comment_properties.md
index d6ffdf932dba..324768c82add 100644
--- a/translations/pt-BR/data/reusables/webhooks/commit_comment_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/commit_comment_properties.md
@@ -1,4 +1,4 @@
-| Tecla        | Tipo     | Descrição                                                                |
-| ------------ | -------- | ------------------------------------------------------------------------ |
-| `Ação`       | `string` | A ação realizada. Pode ser `criado`.                                     |
-| `comentário` | `objeto` | The [commit comment](/v3/repos/comments/#get-a-commit-comment) resource. |
\ No newline at end of file
+| Tecla        | Tipo     | Descrição                                                                      |
+| ------------ | -------- | ------------------------------------------------------------------------------ |
+| `Ação`       | `string` | A ação realizada. Pode ser `criado`.                                           |
+| `comentário` | `objeto` | O recurso de [comentário de commit](/v3/repos/comments/#get-a-commit-comment). |
diff --git a/translations/pt-BR/data/reusables/webhooks/commit_comment_short_desc.md b/translations/pt-BR/data/reusables/webhooks/commit_comment_short_desc.md
index 918e0279b925..76d4d4405fcb 100644
--- a/translations/pt-BR/data/reusables/webhooks/commit_comment_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/commit_comment_short_desc.md
@@ -1 +1 @@
-A commit comment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[commit comment](/v3/repos/comments/)" REST API.
\ No newline at end of file
+Um comentário de commit foi criado. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte a API REST de "[comentário de commit](/v3/repos/comments/)".
diff --git a/translations/pt-BR/data/reusables/webhooks/content_reference_short_desc.md b/translations/pt-BR/data/reusables/webhooks/content_reference_short_desc.md
index b7880d039d3a..29fa4e9ccc1d 100644
--- a/translations/pt-BR/data/reusables/webhooks/content_reference_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/content_reference_short_desc.md
@@ -1 +1 @@
-A new content reference is `created`. A new content reference is created when the body or comment of an issue or pull request includes a URL that matches a configured content reference domain. For more information, see "[Using content attachments](/apps/using-content-attachments/)" to learn more about content references and attachments.
\ No newline at end of file
+Uma nova referência de conteúdo foi `criada`. Uma nova referência de conteúdo é criada quando o texto ou comentário de um problema ou pull request inclui uma URL que corresponde a um domínio de referência de conteúdo configurado. Para obter mais informações, consulte "[Usar anexos de conteúdo](/apps/using-content-attachments/)" para saber mais sobre referências de conteúdo e anexos.
diff --git a/translations/pt-BR/data/reusables/webhooks/content_type.md b/translations/pt-BR/data/reusables/webhooks/content_type.md
index 23245b2dfc3f..f3c7118f9f92 100644
--- a/translations/pt-BR/data/reusables/webhooks/content_type.md
+++ b/translations/pt-BR/data/reusables/webhooks/content_type.md
@@ -1,6 +1,6 @@
-Webhooks can be delivered using different content types:
+Os webhooks podem ser entregues usando diferentes tipos de conteúdo:
 
-- The `application/json` content type will deliver the JSON payload directly as the body of the `POST` request.
-- The `application/x-www-form-urlencoded` content type will send the JSON payload as a form parameter called `payload`.
+- O tipo de conteúdo de `application/json` fornecerá a carga do JSON diretamente como o texto da solicitação `POST`.
+- O tipo de conteúdo `application/x-www-form-urlencoded` enviará a carga do JSON como um parâmetro de formulário denominado `carga`.
 
-Choose the one that best fits your needs.
+Escolha o que melhor se adeque às suas necessidades.
diff --git a/translations/pt-BR/data/reusables/webhooks/create_properties.md b/translations/pt-BR/data/reusables/webhooks/create_properties.md
index 2a94af03707a..d7a8c23a6244 100644
--- a/translations/pt-BR/data/reusables/webhooks/create_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/create_properties.md
@@ -1,6 +1,6 @@
-| Tecla           | Tipo     | Descrição                                                                                                                                                                                            |
-| --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `ref`           | `string` | {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}The [`git ref`](/v3/git/refs/#get-a-reference) resource.{% else %}The [`git ref`](/v3/git/refs/#get-a-reference) resource.{% endif %}
-| `ref_type`      | `string` | The type of Git ref object created in the repository. Can be either `branch` or `tag`.                                                                                                               |
-| `master_branch` | `string` | The name of the repository's default branch (usually `master`).                                                                                                                                      |
-| `descrição`     | `string` | The repository's current description.                                                                                                                                                                |
\ No newline at end of file
+| Tecla           | Tipo     | Descrição                                                                                                                                                                                         |
+| --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `ref`           | `string` | O recurso [`ref do git`](/v3/git/refs/#get-a-reference).                                                                                                                                          |
+| `ref_type`      | `string` | O tipo de objeto de ref do Git criado no repositório. Pode ser `branch` ou `tag`.                                                                                                                 |
+| `master_branch` | `string` | O nome do branch-padrão do repositório (normalmente {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 3" %}`principal`{% else %}`mestre`{% endif %}). |
+| `descrição`     | `string` | Descrição atual do repositório.                                                                                                                                                                   |
diff --git a/translations/pt-BR/data/reusables/webhooks/create_short_desc.md b/translations/pt-BR/data/reusables/webhooks/create_short_desc.md
index 0140bfadf5c2..1d5ff03b89a8 100644
--- a/translations/pt-BR/data/reusables/webhooks/create_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/create_short_desc.md
@@ -1 +1 @@
-A Git branch or tag is created. For more information, see the "[Git data](/v3/git/)" REST API.
\ No newline at end of file
+Um branch ou tag do Git é criado. Para obter mais informações, consulte a API REST de "[dados do Git](/v3/git/).
diff --git a/translations/pt-BR/data/reusables/webhooks/delete_properties.md b/translations/pt-BR/data/reusables/webhooks/delete_properties.md
index f87d55c7a989..8cbb629e7e0b 100644
--- a/translations/pt-BR/data/reusables/webhooks/delete_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/delete_properties.md
@@ -1,4 +1,4 @@
-| Tecla      | Tipo     | Descrição                                                                                                                                                                                            |
-| ---------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `ref`      | `string` | {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}The [`git ref`](/v3/git/refs/#get-a-reference) resource.{% else %}The [`git ref`](/v3/git/refs/#get-a-reference) resource.{% endif %}
-| `ref_type` | `string` | The type of Git ref oject deleted in the repository. Can be `branch` or `tag`.                                                                                                                       |
\ No newline at end of file
+| Tecla      | Tipo     | Descrição                                                                        |
+| ---------- | -------- | -------------------------------------------------------------------------------- |
+| `ref`      | `string` | O recurso [`ref do git`](/v3/git/refs/#get-a-reference).                         |
+| `ref_type` | `string` | O tipo de objeto do Git ref excluído no repositório. Pode ser `branch` ou `tag`. |
diff --git a/translations/pt-BR/data/reusables/webhooks/delete_short_desc.md b/translations/pt-BR/data/reusables/webhooks/delete_short_desc.md
index 60568e8b0958..28fd36dd0a72 100644
--- a/translations/pt-BR/data/reusables/webhooks/delete_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/delete_short_desc.md
@@ -1 +1 @@
-A Git branch or tag is deleted. For more information, see the "[Git data](/v3/git/)" REST API.
\ No newline at end of file
+Um branch ou tag do Git é excluído. Para obter mais informações, consulte a API REST de "[dados do Git](/v3/git/).
diff --git a/translations/pt-BR/data/reusables/webhooks/deploy_key_properties.md b/translations/pt-BR/data/reusables/webhooks/deploy_key_properties.md
index 0006edaff40f..16a75e163483 100644
--- a/translations/pt-BR/data/reusables/webhooks/deploy_key_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/deploy_key_properties.md
@@ -1,4 +1,4 @@
-| Tecla   | Tipo     | Descrição                                                      |
-| ------- | -------- | -------------------------------------------------------------- |
-| `Ação`  | `string` | A ação realizada. Can be either `created` or `deleted`.        |
-| `Chave` | `objeto` | The [`deploy key`](/v3/repos/keys/#get-a-deploy-key) resource. |
\ No newline at end of file
+| Tecla   | Tipo     | Descrição                                                           |
+| ------- | -------- | ------------------------------------------------------------------- |
+| `Ação`  | `string` | A ação realizada. Pode ser `criado` ou `excluído`.                  |
+| `Chave` | `objeto` | O recurso de [`implantar chave`](/v3/repos/keys/#get-a-deploy-key). |
diff --git a/translations/pt-BR/data/reusables/webhooks/deploy_key_short_desc.md b/translations/pt-BR/data/reusables/webhooks/deploy_key_short_desc.md
index 551eef44c5cc..75e47eef221e 100644
--- a/translations/pt-BR/data/reusables/webhooks/deploy_key_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/deploy_key_short_desc.md
@@ -1 +1 @@
-A deploy key is added or removed from a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[Deploy keys](/v3/repos/keys/)" REST API.
\ No newline at end of file
+Uma chave de implementação foi adicionada ou removida de um repositório. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte a API REST de "[Chaves de implementação](/v3/repos/keys/)".
diff --git a/translations/pt-BR/data/reusables/webhooks/deployment_short_desc.md b/translations/pt-BR/data/reusables/webhooks/deployment_short_desc.md
index 75683350b9df..377ea517f5bc 100644
--- a/translations/pt-BR/data/reusables/webhooks/deployment_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/deployment_short_desc.md
@@ -1 +1 @@
-A deployment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[deployment](/v3/repos/deployments/#list-deployments)" REST API.
\ No newline at end of file
+Uma implantação foi criada. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte a API REST "[implantação](/rest/reference/repos#list-deployments)".
diff --git a/translations/pt-BR/data/reusables/webhooks/deployment_status_short_desc.md b/translations/pt-BR/data/reusables/webhooks/deployment_status_short_desc.md
index 11953ea072e4..39a68b4642f1 100644
--- a/translations/pt-BR/data/reusables/webhooks/deployment_status_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/deployment_status_short_desc.md
@@ -1 +1 @@
-A deployment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[deployment statuses](/v3/repos/deployments/#list-deployment-statuses)" REST API.
\ No newline at end of file
+Uma implantação foi criada. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte a API REST do "[status de implantação](/rest/reference/repos#list-deployment-statuses)".
diff --git a/translations/pt-BR/data/reusables/webhooks/enterprise_short_desc.md b/translations/pt-BR/data/reusables/webhooks/enterprise_short_desc.md
index 999949bcbb50..1e8a59d721f2 100644
--- a/translations/pt-BR/data/reusables/webhooks/enterprise_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/enterprise_short_desc.md
@@ -1 +1 @@
-A site or repository administrator enables or disables anonymous Git read access. See "[Allowing admins to enable anonymous Git read access to public repositories](/enterprise/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories)" for more details. This event is not available in the Events API.
\ No newline at end of file
+Um site ou administrador de repositório habilita ou desabilita o acesso de leitura anônimo do Git. Consulte "[Permitir que administradores habilitem acesso de leitura anônimo do Git aos repositórios públicos](/enterprise/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories)" para obter mais informações. Este evento não está disponível na API de eventos.
diff --git a/translations/pt-BR/data/reusables/webhooks/events_api_payload.md b/translations/pt-BR/data/reusables/webhooks/events_api_payload.md
index b40c9904faf8..ac9e22806021 100644
--- a/translations/pt-BR/data/reusables/webhooks/events_api_payload.md
+++ b/translations/pt-BR/data/reusables/webhooks/events_api_payload.md
@@ -1 +1 @@
-The [event object](#event-object-common-properties) includes properties that are common for all events. Each event object includes a `payload` property and the value is unique to each event type. The `payload` object for this event is described below.
\ No newline at end of file
+O [objeto de evento](#event-object-common-properties) inclui propriedades comuns para todos os eventos. Cada objeto de evento inclui uma propriedade de `carga` e o valor é único para cada tipo de evento. O objeto de `carga` para este evento está descrito abaixo.
diff --git a/translations/pt-BR/data/reusables/webhooks/fork_properties.md b/translations/pt-BR/data/reusables/webhooks/fork_properties.md
index ecaaedfc6919..d0e7d4555914 100644
--- a/translations/pt-BR/data/reusables/webhooks/fork_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/fork_properties.md
@@ -1,3 +1,3 @@
 | Tecla    | Tipo     | Descrição                                                         |
 | -------- | -------- | ----------------------------------------------------------------- |
-| `forkee` | `objeto` | The created [`repository`](/v3/repos/#get-a-repository) resource. |
\ No newline at end of file
+| `forkee` | `objeto` | O recurso do [`repositório`](/v3/repos/#get-a-repository) criado. |
diff --git a/translations/pt-BR/data/reusables/webhooks/fork_short_desc.md b/translations/pt-BR/data/reusables/webhooks/fork_short_desc.md
index a294851f9c96..070bd3cf1212 100644
--- a/translations/pt-BR/data/reusables/webhooks/fork_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/fork_short_desc.md
@@ -1 +1 @@
-A user forks a repository. For more information, see the "[forks](/v3/repos/forks/)" REST API.
\ No newline at end of file
+Um usuário bifurca um repositório. Para obter mais informações, consulte a API REST de [bifurcações](/v3/repos/forks/)".
diff --git a/translations/pt-BR/data/reusables/webhooks/gollum_properties.md b/translations/pt-BR/data/reusables/webhooks/gollum_properties.md
index baf1d39a6380..a09cda7a3e6b 100644
--- a/translations/pt-BR/data/reusables/webhooks/gollum_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/gollum_properties.md
@@ -1,8 +1,8 @@
-| Tecla                | Tipo     | Descrição                                                                |
-| -------------------- | -------- | ------------------------------------------------------------------------ |
-| `Páginas`            | `array`  | The pages that were updated.                                             |
-| `pages[][page_name]` | `string` | The name of the page.                                                    |
-| `pages[][title]`     | `string` | The current page title.                                                  |
-| `pages[][action]`    | `string` | The action that was performed on the page. Can be `created` or `edited`. |
-| `pages[][sha]`       | `string` | The latest commit SHA of the page.                                       |
-| `pages[][html_url]`  | `string` | Points to the HTML wiki page.                                            |
\ No newline at end of file
+| Tecla                | Tipo     | Descrição                                                           |
+| -------------------- | -------- | ------------------------------------------------------------------- |
+| `Páginas`            | `array`  | As páginas que foram atualizadas.                                   |
+| `pages[][page_name]` | `string` | O nome da página.                                                   |
+| `pages[][title]`     | `string` | O título da página atual.                                           |
+| `pages[][action]`    | `string` | A ação que foi realizada na página. Pode ser `criado` ou `editado`. |
+| `pages[][sha]`       | `string` | O SHA de commit mais recente da página.                             |
+| `pages[][html_url]`  | `string` | Aponta para a página wiki de HTML.                                  |
diff --git a/translations/pt-BR/data/reusables/webhooks/gollum_short_desc.md b/translations/pt-BR/data/reusables/webhooks/gollum_short_desc.md
index 88d8dacb57e5..07ce82e89241 100644
--- a/translations/pt-BR/data/reusables/webhooks/gollum_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/gollum_short_desc.md
@@ -1 +1 @@
-A wiki page is created or updated. For more information, see the "[About wikis](/github/building-a-strong-community/about-wikis)".
\ No newline at end of file
+Uma página wiki foi criada ou atualizada. Para obter mais informações, consulte "[Sobre wikis](/github/building-a-strong-community/about-wikis)".
diff --git a/translations/pt-BR/data/reusables/webhooks/installation_properties.md b/translations/pt-BR/data/reusables/webhooks/installation_properties.md
index f3f349097ef9..8f889481953e 100644
--- a/translations/pt-BR/data/reusables/webhooks/installation_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/installation_properties.md
@@ -1,4 +1,4 @@
 | Tecla          | Tipo     | Descrição                                                                           |
 | -------------- | -------- | ----------------------------------------------------------------------------------- |
-| `Ação`         | `string` | A ação que foi executada. Pode ser uma das ações a seguir:
    • `created` - Someone installs a {% data variables.product.prodname_github_app %}.
    • `deleted` - Someone uninstalls a {% data variables.product.prodname_github_app %}
      • {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}
    • `suspend` - Someone suspends a {% data variables.product.prodname_github_app %} installation.
    • `unsuspend` - Someone unsuspends a {% data variables.product.prodname_github_app %} installation.
      • {% endif %}
    • `new_permissions_accepted` - Someone accepts new permissions for a {% data variables.product.prodname_github_app %} installation. When a {% data variables.product.prodname_github_app %} owner requests new permissions, the person who installed the {% data variables.product.prodname_github_app %} must accept the new permissions request. 
     |
-| `repositories` | `array`  | An array of repository objects that the insatllation can access.                    |
\ No newline at end of file
+| `Ação`         | `string` | A ação que foi executada. Pode ser uma das ações a seguir:
    • `created` - Alguém instala um {% data variables.product.prodname_github_app %}.
    • `deleted` - Alguém desinstala {% data variables.product.prodname_github_app %}
      • {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}
    • `suspend` - Alguém suspende uma instalação de {% data variables.product.prodname_github_app %}.
    • `unsuspend` - Alguém não suspende uma instalação de {% data variables.product.prodname_github_app %}.
      • {% endif %}
    • `new_permissions_accepted` - Alguém aceita novas permissões para uma instalação de {% data variables.product.prodname_github_app %}. Quando um proprietário de {% data variables.product.prodname_github_app %} solicita novas permissões, a pessoa que instalou o {% data variables.product.prodname_github_app %} deve aceitar a nova solicitação de permissões. 
     |
+| `repositories` | `array`  | Uma matriz de objetos do repositório que a instalação pode acessar.                 |
diff --git a/translations/pt-BR/data/reusables/webhooks/installation_repositories_properties.md b/translations/pt-BR/data/reusables/webhooks/installation_repositories_properties.md
index 219fe40442d2..3a573c9aeb57 100644
--- a/translations/pt-BR/data/reusables/webhooks/installation_repositories_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/installation_repositories_properties.md
@@ -1,6 +1,6 @@
-| Tecla                  | Tipo     | Descrição                                                                             |
-| ---------------------- | -------- | ------------------------------------------------------------------------------------- |
-| `Ação`                 | `string` | A ação que foi executada. Can be either `added` or `removed`.                         |
-| `repository_selection` | `string` | The choice of repositories the installation is on. Can be either `selected` or `all`. |
-| `repositories_added`   | `array`  | An array of repository objects, which were added to the installation.                 |
-| `repositories_removed` | `array`  | An array of repository objects, which were removed from the installation.             |
\ No newline at end of file
+| Tecla                  | Tipo     | Descrição                                                                                      |
+| ---------------------- | -------- | ---------------------------------------------------------------------------------------------- |
+| `Ação`                 | `string` | A ação que foi executada. Pode ser `adicionado` ou `removido`.                                 |
+| `repository_selection` | `string` | A escolha dos repositórios em que a instalação se encontra. Pode ser `selecionado` ou `todos`. |
+| `repositories_added`   | `array`  | Uma matriz de objetos do repositório adicionados à instalação.                                 |
+| `repositories_removed` | `array`  | Um array de objetos do repositório removidos da instalação.                                    |
diff --git a/translations/pt-BR/data/reusables/webhooks/installation_repositories_short_desc.md b/translations/pt-BR/data/reusables/webhooks/installation_repositories_short_desc.md
index b01eeca22efe..fb3123c7feae 100644
--- a/translations/pt-BR/data/reusables/webhooks/installation_repositories_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/installation_repositories_short_desc.md
@@ -1 +1 @@
-Activity related to repositories being added to a GitHub App installation. {% data reusables.webhooks.action_type_desc %} For more information, see the "[GitHub App installation](/v3/apps/)" REST API.
\ No newline at end of file
+Atividade relacionada aos repositórios adicionados a uma instalação do aplicativo GitHub. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte a API REST da "[Instalação do aplicativo GitHub](/v3/apps/)".
diff --git a/translations/pt-BR/data/reusables/webhooks/installation_short_desc.md b/translations/pt-BR/data/reusables/webhooks/installation_short_desc.md
index 0a19aef9b5d0..011de21adf30 100644
--- a/translations/pt-BR/data/reusables/webhooks/installation_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/installation_short_desc.md
@@ -1 +1 @@
-Activity related to a GitHub App installation. {% data reusables.webhooks.action_type_desc %} For more information, see the "[GitHub App installation](/v3/apps/)" REST API.
\ No newline at end of file
+Atividade relacionada a uma instalação do aplicativo GitHub. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte a API REST da "[Instalação do aplicativo GitHub](/v3/apps/)".
diff --git a/translations/pt-BR/data/reusables/webhooks/issue_comment_properties.md b/translations/pt-BR/data/reusables/webhooks/issue_comment_properties.md
index 1cc3962f11bf..67de30f6b73d 100644
--- a/translations/pt-BR/data/reusables/webhooks/issue_comment_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/issue_comment_properties.md
@@ -1 +1 @@
-`changes`|`object` | The changes to the comment if the action was `edited`. `changes[body][from]` |`string` | The previous version of the body if the action was `edited`. `issue`|`object` | The [issue](/v3/issues/) the comment belongs to. `comment`|`object` | The [comment](/v3/issues/comments/) itself.
\ No newline at end of file
+`alterações`「`objeto` As alterações no comentário se a ação foi `editada`. `alterações[body][from]` |`string` | A versão anterior do texto se a ação foi `editada`. `problema`├`objeto` ├O [problema](/v3/issues/) ao qual o comentário pertence. `comentário`|`objeto` | O próprio [comentário](/v3/issues/comments/).
diff --git a/translations/pt-BR/data/reusables/webhooks/issue_comment_short_desc.md b/translations/pt-BR/data/reusables/webhooks/issue_comment_short_desc.md
index 0c12ec707b62..f7da7a2069ad 100644
--- a/translations/pt-BR/data/reusables/webhooks/issue_comment_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/issue_comment_short_desc.md
@@ -1 +1 @@
-Activity related to an issue comment. {% data reusables.webhooks.action_type_desc %} For more information, see the "[issue comments](/v3/issues/comments/)" REST API.
\ No newline at end of file
+Atividade relacionada a um comentário de um problema. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte a API REST de "[comentários de problema](/v3/issues/comments/)".
diff --git a/translations/pt-BR/data/reusables/webhooks/issue_comment_webhook_properties.md b/translations/pt-BR/data/reusables/webhooks/issue_comment_webhook_properties.md
index e2807defdbe1..f6206f2dc75b 100644
--- a/translations/pt-BR/data/reusables/webhooks/issue_comment_webhook_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/issue_comment_webhook_properties.md
@@ -1,3 +1,3 @@
-| Tecla  | Tipo     | Descrição                                                                                      |
-| ------ | -------- | ---------------------------------------------------------------------------------------------- |
-| `Ação` | `string` | The action that was performed on the comment. Can be one of `created`, `edited`, or `deleted`. |
\ No newline at end of file
+| Tecla  | Tipo     | Descrição                                                                  |
+| ------ | -------- | -------------------------------------------------------------------------- |
+| `Ação` | `string` | A ação realizada no comentário. Pode ser `created`, `edited` ou `deleted`. |
diff --git a/translations/pt-BR/data/reusables/webhooks/issue_event_api_properties.md b/translations/pt-BR/data/reusables/webhooks/issue_event_api_properties.md
index bbf0019fdc8f..8ba92018f74b 100644
--- a/translations/pt-BR/data/reusables/webhooks/issue_event_api_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/issue_event_api_properties.md
@@ -1,3 +1,3 @@
-| Tecla  | Tipo     | Descrição                                                                                                                    |
-| ------ | -------- | ---------------------------------------------------------------------------------------------------------------------------- |
-| `Ação` | `string` | A ação que foi executada. Can be one of `opened`, `closed`, `reopened`, `assigned`, `unassigned`, `labeled`, or `unlabeled`. |
\ No newline at end of file
+| Tecla  | Tipo     | Descrição                                                                                                              |
+| ------ | -------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `Ação` | `string` | A ação que foi executada. Pode ser `opened`, `closed`, `reopened`, `assigned`, `unassigned`, `labeled` ou `unlabeled`. |
diff --git a/translations/pt-BR/data/reusables/webhooks/issue_properties.md b/translations/pt-BR/data/reusables/webhooks/issue_properties.md
index 84db05eb2bfe..c146faa96802 100644
--- a/translations/pt-BR/data/reusables/webhooks/issue_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/issue_properties.md
@@ -1 +1 @@
-`issue`|`object` | The [issue](/v3/issues) itself. `changes`|`object`| The changes to the issue if the action was `edited`. `changes[title][from]`|`string` | The previous version of the title if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `assignee`|`object` | The optional user who was assigned or unassigned from the issue. `label`|`object` | The optional label that was added or removed from the issue.
\ No newline at end of file
+`issue`|`object` | The [issue](/v3/issues) itself. `changes`|`object`| The changes to the issue if the action was `edited`. `changes[title][from]`|`string` | The previous version of the title if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `assignee`|`object` | The optional user who was assigned or unassigned from the issue. `label`|`object` | The optional label that was added or removed from the issue.
diff --git a/translations/pt-BR/data/reusables/webhooks/issue_webhook_properties.md b/translations/pt-BR/data/reusables/webhooks/issue_webhook_properties.md
index 26a9d0c2c2cb..24327c3b3716 100644
--- a/translations/pt-BR/data/reusables/webhooks/issue_webhook_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/issue_webhook_properties.md
@@ -1,3 +1,3 @@
-| Tecla  | Tipo     | Descrição                                                                                                                                                                                                                                   |
-| ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `Ação` | `string` | A ação que foi executada. Can be one of `opened`, `edited`, `deleted`, `pinned`, `unpinned`, `closed`, `reopened`, `assigned`, `unassigned`, `labeled`, `unlabeled`, `locked`, `unlocked`,  `transferred`, `milestoned`, or `demilestoned`. |
\ No newline at end of file
+| Tecla  | Tipo     | Descrição                                                                                                                                                                                                                             |
+| ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `Ação` | `string` | A ação que foi executada. Pode ser `opened`, `edited`, `deleted`, `pinned`, `unpinned`, `closed`, `reopened`, `assigned`, `unassigned`, `labeled`, `unlabeled`, `locked`, `unlocked`,  `transferred`, `milestoned` ou `demilestoned`. |
diff --git a/translations/pt-BR/data/reusables/webhooks/issues_short_desc.md b/translations/pt-BR/data/reusables/webhooks/issues_short_desc.md
index fea9fc0cfcd8..c15f9905cf08 100644
--- a/translations/pt-BR/data/reusables/webhooks/issues_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/issues_short_desc.md
@@ -1 +1 @@
-Activity related to an issue. {% data reusables.webhooks.action_type_desc %} For more information, see the "[issues](/v3/issues/comments/)" REST API.
\ No newline at end of file
+Atividade relacionada a um problema. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte a APTI REST de [problemas](/v3/issues/comments/)".
diff --git a/translations/pt-BR/data/reusables/webhooks/label_short_desc.md b/translations/pt-BR/data/reusables/webhooks/label_short_desc.md
index ca095139a6d2..b9d9b11fb426 100644
--- a/translations/pt-BR/data/reusables/webhooks/label_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/label_short_desc.md
@@ -1 +1 @@
-Activity related to an issue. {% data reusables.webhooks.action_type_desc %} For more information, see the "[labels](/v3/issues/labels/)" REST API.
\ No newline at end of file
+Atividade relacionada a um problema. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte API REST de [etiquetas](/v3/issues/labels/)".
diff --git a/translations/pt-BR/data/reusables/webhooks/member_event_api_properties.md b/translations/pt-BR/data/reusables/webhooks/member_event_api_properties.md
index f20aff4656dc..942093717c6d 100644
--- a/translations/pt-BR/data/reusables/webhooks/member_event_api_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/member_event_api_properties.md
@@ -1,3 +1,3 @@
-| Tecla  | Tipo     | Descrição                                                                                           |
-| ------ | -------- | --------------------------------------------------------------------------------------------------- |
-| `Ação` | `string` | A ação que foi executada. Can be `added` to indicate a user accepted an invitation to a repository. |
\ No newline at end of file
+| Tecla  | Tipo     | Descrição                                                                                                           |
+| ------ | -------- | ------------------------------------------------------------------------------------------------------------------- |
+| `Ação` | `string` | A ação que foi executada. Pode ser `adicionado` para indicar que um usuário aceitou um convite para um repositório. |
diff --git a/translations/pt-BR/data/reusables/webhooks/member_properties.md b/translations/pt-BR/data/reusables/webhooks/member_properties.md
index 7fde9d65f4b7..470b0d13779a 100644
--- a/translations/pt-BR/data/reusables/webhooks/member_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/member_properties.md
@@ -1 +1 @@
-`member`|`object` | The [user](/v3/users/) that was added. `changes`|`object`| The changes to the collaborator permissions if the action was `edited`. `changes[old_permission][from]`|`string` | The previous permissions of the collaborator if the action was `edited`.
\ No newline at end of file
+`integrante`|`objeto` | O [usuário](/v3/users/) que foi adicionado. `alterações`|`objeto`| As alterações nas permissões do colaborador se a ação foi `editada`. `changes[old_permission][from]`|`string` | As permissões anteriores do colaborador se a ação foi `editada`.
diff --git a/translations/pt-BR/data/reusables/webhooks/member_short_desc.md b/translations/pt-BR/data/reusables/webhooks/member_short_desc.md
index 9447f245ed0a..eef75cac3d9f 100644
--- a/translations/pt-BR/data/reusables/webhooks/member_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/member_short_desc.md
@@ -1 +1 @@
-Activity related to repository collaborators. {% data reusables.webhooks.action_type_desc %} For more information, see the "[collaborators](/v3/repos/collaborators/)" REST API.
\ No newline at end of file
+Atividade relacionada aos colaboradores do repositório. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte a APTI REST dos [colaboradores](/v3/repos/collaborators/)".
diff --git a/translations/pt-BR/data/reusables/webhooks/member_webhook_properties.md b/translations/pt-BR/data/reusables/webhooks/member_webhook_properties.md
index 701453f17712..5fc21f827fb2 100644
--- a/translations/pt-BR/data/reusables/webhooks/member_webhook_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/member_webhook_properties.md
@@ -1,3 +1,3 @@
 | Tecla  | Tipo     | Descrição                                                                           |
 | ------ | -------- | ----------------------------------------------------------------------------------- |
-| `Ação` | `string` | A ação que foi executada. Pode ser uma das ações a seguir:
    •  `added` - A user accepts an invitation to a repository.
    • `removed` - A user is removed as a collaborator in a repository.
    • `edited` - A user's collaborator permissios have changed. 
     |
\ No newline at end of file
+| `Ação` | `string` | A ação que foi executada. Pode ser uma das ações a seguir:
    •  `added` - Um usuário aceita um convite para um repositório.
    • `removed` - Um usuário é removido como colaborador de um repositório.
    • `edited` - As permissões de um colaborador do usuário foram alteradas. 
     |
diff --git a/translations/pt-BR/data/reusables/webhooks/membership_properties.md b/translations/pt-BR/data/reusables/webhooks/membership_properties.md
index f3707ad13b16..79618ae9f9da 100644
--- a/translations/pt-BR/data/reusables/webhooks/membership_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/membership_properties.md
@@ -1,6 +1,6 @@
-| Tecla        | Tipo     | Descrição                                                   |
-| ------------ | -------- | ----------------------------------------------------------- |
-| `Ação`       | `string` | A ação que foi executada. Can be `added` or `removed`.      |
-| `escopo`     | `string` | The scope of the membership. Currently, can only be `team`. |
-| `integrante` | `objeto` | The [user](/v3/users/) that was added or removed.           |
-| `equipe`     | `objeto` | The [team](/v3/teams/) for the membership.                  |
\ No newline at end of file
+| Tecla        | Tipo     | Descrição                                                      |
+| ------------ | -------- | -------------------------------------------------------------- |
+| `Ação`       | `string` | A ação que foi executada. Pode ser `adicionado` ou `removido`. |
+| `escopo`     | `string` | O escopo da associação. Atualmente, só pode ser `equipe`.      |
+| `integrante` | `objeto` | O [usuário](/v3/users/) que foi adicionado ou removido.        |
+| `equipe`     | `objeto` | A [equipe](/v3/teams/) para a associação.                      |
diff --git a/translations/pt-BR/data/reusables/webhooks/membership_short_desc.md b/translations/pt-BR/data/reusables/webhooks/membership_short_desc.md
index 4ffa7e0d72c0..85c27a7a272b 100644
--- a/translations/pt-BR/data/reusables/webhooks/membership_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/membership_short_desc.md
@@ -1 +1 @@
-Activity related to team membership. {% data reusables.webhooks.action_type_desc %} For more information, see the "[team members](/v3/teams/members/)" REST API.
\ No newline at end of file
+Atividade relacionada à associação na equipe. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte a API REST dos [integrantes da equipe](/v3/teams/members/)".
diff --git a/translations/pt-BR/data/reusables/webhooks/milestone_properties.md b/translations/pt-BR/data/reusables/webhooks/milestone_properties.md
index a148813b2969..5cd93140b0ef 100644
--- a/translations/pt-BR/data/reusables/webhooks/milestone_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/milestone_properties.md
@@ -1,8 +1,8 @@
-| Tecla                        | Tipo     | Descrição                                                                                      |
-| ---------------------------- | -------- | ---------------------------------------------------------------------------------------------- |
-| `Ação`                       | `string` | A ação que foi executada. Can be one of `created`, `closed`, `opened`, `edited`, or `deleted`. |
-| `marco`                      | `objeto` | The milestone itself.                                                                          |
-| `alterações`                 | `objeto` | The changes to the milestone if the action was `edited`.                                       |
-| `changes[description][from]` | `string` | A versão anterior da descrição se a ação foi `editada`.                                        |
-| `changes[due_on][from]`      | `string` | The previous version of the due date if the action was `edited`.                               |
-| `changes[title][from]`       | `string` | The previous version of the title if the action was `edited`.                                  |
\ No newline at end of file
+| Tecla                        | Tipo     | Descrição                                                                                |
+| ---------------------------- | -------- | ---------------------------------------------------------------------------------------- |
+| `Ação`                       | `string` | A ação que foi executada. Pode ser `created`, `closed`, `opened`, `edited` ou `deleted`. |
+| `marco`                      | `objeto` | O próprio marco.                                                                         |
+| `alterações`                 | `objeto` | As alterações para o marco se a ação foi `editada`.                                      |
+| `changes[description][from]` | `string` | A versão anterior da descrição se a ação foi `editada`.                                  |
+| `changes[due_on][from]`      | `string` | A versão anterior da data de vencimento se a ação foi `editada`.                         |
+| `changes[title][from]`       | `string` | A versão anterior do título se a ação foi `editada`.                                     |
diff --git a/translations/pt-BR/data/reusables/webhooks/milestone_short_desc.md b/translations/pt-BR/data/reusables/webhooks/milestone_short_desc.md
index 0e6f857a512a..733f2ecda141 100644
--- a/translations/pt-BR/data/reusables/webhooks/milestone_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/milestone_short_desc.md
@@ -1 +1 @@
-Activity related to milestones. {% data reusables.webhooks.action_type_desc %} For more information, see the "[milestones](/v3/issues/milestones/)" REST API.
\ No newline at end of file
+Atividade relacionada aos marcos. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte a API REST dos [marcos](/v3/issues/milestones/)".
diff --git a/translations/pt-BR/data/reusables/webhooks/org_block_short_desc.md b/translations/pt-BR/data/reusables/webhooks/org_block_short_desc.md
index 1be5c049c250..7c83decc1062 100644
--- a/translations/pt-BR/data/reusables/webhooks/org_block_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/org_block_short_desc.md
@@ -1 +1 @@
-Activity related to people being blocked in an organization. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte o[Bloqueando usuários da organização](/v3/orgs/blocking/)" da API REST.
\ No newline at end of file
+Atividade relacionada a pessoas que estão sendo bloqueadas em uma organização. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte o[Bloqueando usuários da organização](/v3/orgs/blocking/)" da API REST.
diff --git a/translations/pt-BR/data/reusables/webhooks/org_desc.md b/translations/pt-BR/data/reusables/webhooks/org_desc.md
index e763e6d6b614..497ae85c8dbf 100644
--- a/translations/pt-BR/data/reusables/webhooks/org_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/org_desc.md
@@ -1 +1 @@
-`organization` | `object` | Webhook payloads contain the [`organization`](/v3/orgs/#get-an-organization) object when the webhook is configured for an organization or the event occurs from activity in a repository owned by an organization.
\ No newline at end of file
+`organização` | `objeto` Cargas do webhook contêm o objeto da [`organização`](/v3/orgs/#get-an-organization) quando o webhook é configurado para uma organização ou o evento ocorre a partir da atividade em um repositório pertencente a uma organização.
diff --git a/translations/pt-BR/data/reusables/webhooks/organization_short_desc.md b/translations/pt-BR/data/reusables/webhooks/organization_short_desc.md
index 131d20fc3de8..57545c34fb6e 100644
--- a/translations/pt-BR/data/reusables/webhooks/organization_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/organization_short_desc.md
@@ -1 +1 @@
-Activity related to an organization and its members. {% data reusables.webhooks.action_type_desc %} For more information, see the "[organizations](/v3/orgs/)" REST API.
\ No newline at end of file
+Atividade relacionada a uma organização e seus integrantes. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte a APRI REST de "[organizações](/v3/orgs/)".
diff --git a/translations/pt-BR/data/reusables/webhooks/package_properties.md b/translations/pt-BR/data/reusables/webhooks/package_properties.md
index 12a2cacb303b..4df807b6ba36 100644
--- a/translations/pt-BR/data/reusables/webhooks/package_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/package_properties.md
@@ -1,4 +1,4 @@
-| Tecla    | Tipo     | Descrição                                                  |
-| -------- | -------- | ---------------------------------------------------------- |
-| `Ação`   | `string` | A ação que foi executada. Can be `published` or `updated`. |
-| `pacote` | `objeto` | Information about the package.                             |
\ No newline at end of file
+| Tecla    | Tipo     | Descrição                                                       |
+| -------- | -------- | --------------------------------------------------------------- |
+| `Ação`   | `string` | A ação que foi executada. Pode ser `publicado` ou `atualizado`. |
+| `pacote` | `objeto` | Informações sobre o pacote.                                     |
diff --git a/translations/pt-BR/data/reusables/webhooks/page_build_short_desc.md b/translations/pt-BR/data/reusables/webhooks/page_build_short_desc.md
index 7c5be712c388..0c317a9be819 100644
--- a/translations/pt-BR/data/reusables/webhooks/page_build_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/page_build_short_desc.md
@@ -1 +1 @@
-Represents an attempted build of a GitHub Pages site, whether successful or not. A push to a GitHub Pages enabled branch (`gh-pages` for project pages, `master` for user and organization pages) triggers this event.
\ No newline at end of file
+Representa uma tentativa de criação de um site do {% data variables.product.prodname_pages %}, independentemente de êxito. Um push para um branch habilitado de {% data variables.product.prodname_pages %} (`gh-pages` para páginas de projeto, o branch-padrão para páginas de usuário e organização) aciona este evento.
diff --git a/translations/pt-BR/data/reusables/webhooks/payload_url.md b/translations/pt-BR/data/reusables/webhooks/payload_url.md
index 3a3fde655ce3..72fcd353855e 100644
--- a/translations/pt-BR/data/reusables/webhooks/payload_url.md
+++ b/translations/pt-BR/data/reusables/webhooks/payload_url.md
@@ -1 +1 @@
-The payload URL is the URL of the server that will receive the webhook `POST` requests.
\ No newline at end of file
+A URL doa carga é a URL do servidor que receberá as solicitações de `POST` do webhook.
diff --git a/translations/pt-BR/data/reusables/webhooks/ping_short_desc.md b/translations/pt-BR/data/reusables/webhooks/ping_short_desc.md
index 8cdd735b78c5..2c5bd52bb124 100644
--- a/translations/pt-BR/data/reusables/webhooks/ping_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/ping_short_desc.md
@@ -1 +1 @@
-When you create a new webhook, we'll send you a simple `ping` event to let you know you've set up the webhook correctly. This event isnt stored so it isn't retrievable via the [Events API](/v3/activity/events/). You can trigger a `ping` again by calling the [Ping a repository webhook](/v3/repos/hooks/#ping-a-repository-webhook) endpoint.
+Ao criar um novo webhook, enviaremos um simples evento de `ping` para informar que você configurou o webhook corretamente. Este evento não é armazenado. Portanto, não é recuperável através do ponto de extremidade da [API de Eventos](/rest/reference/activity#ping-a-repository-webhook).
diff --git a/translations/pt-BR/data/reusables/webhooks/project_card_properties.md b/translations/pt-BR/data/reusables/webhooks/project_card_properties.md
index 58f18e4c706b..433046861cf6 100644
--- a/translations/pt-BR/data/reusables/webhooks/project_card_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/project_card_properties.md
@@ -1,7 +1,7 @@
-| Tecla                 | Tipo      | Descrição                                                                                                                    |
-| --------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------- |
-| `Ação`                | `string`  | The action performed on the project card. Can be `created`, `edited`, `moved`, `converted`, or `deleted`.                    |
-| `alterações`          | `objeto`  | The changes to the project card if the action was `edited` or `converted`.                                                   |
-| `changes[note][from]` | `string`  | The previous version of the note if the action was `edited` or `converted`.                                                  |
-| `after_id`            | `inteiro` | The id of the card that this card now follows if the action was "moved". Will be `null` if it is the first card in a column. |
-| `project_card`        | `objeto`  | The [project card](/v3/projects/cards) itself.                                                                               |
\ No newline at end of file
+| Tecla                 | Tipo      | Descrição                                                                                                              |
+| --------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `Ação`                | `string`  | A ação realizada no cartão do projeto. Pode ser `created`, `edited`, `moved`, `converted` ou `deleted`.                |
+| `alterações`          | `objeto`  | As alterações no cartão do projeto se a ação foi `editada` ou `convertida`.                                            |
+| `changes[note][from]` | `string`  | A versão anterior da nota se a ação foi `editada` ou `convertida`.                                                     |
+| `after_id`            | `inteiro` | O ID do cartão que este cartão agora segue se a ação foi "movida". Será `nulo` se for o primeiro cartão em uma coluna. |
+| `project_card`        | `objeto`  | O próprio [cartão do projeto](/v3/projects/cards).                                                                     |
diff --git a/translations/pt-BR/data/reusables/webhooks/project_card_short_desc.md b/translations/pt-BR/data/reusables/webhooks/project_card_short_desc.md
index 3a474c89ecee..39f48549ed52 100644
--- a/translations/pt-BR/data/reusables/webhooks/project_card_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/project_card_short_desc.md
@@ -1 +1 @@
-Activity related to project cards. {% data reusables.webhooks.action_type_desc %} For more information, see the "[project cards](/v3/projects/cards)" REST API.
\ No newline at end of file
+Atividade relacionada aos cartões do projeto. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte a API REST dos [cartões de projeto](/v3/projects/cards)".
diff --git a/translations/pt-BR/data/reusables/webhooks/project_column_properties.md b/translations/pt-BR/data/reusables/webhooks/project_column_properties.md
index 414b655cb705..40b481e5478b 100644
--- a/translations/pt-BR/data/reusables/webhooks/project_column_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/project_column_properties.md
@@ -1,7 +1,7 @@
-| Tecla                 | Tipo      | Descrição                                                                                                                           |
-| --------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------- |
-| `Ação`                | `string`  | The action that was performed on the project column. Can be one of `created`, `edited`, `moved` or `deleted`.                       |
-| `alterações`          | `objeto`  | The changes to the project column if the action was `edited`.                                                                       |
-| `changes[name][from]` | `string`  | A versão anterior do nome se a ação foi `editada`.                                                                                  |
-| `after_id`            | `inteiro` | The id of the column that this column now follows if the action was "moved". Will be `null` if it is the first column in a project. |
-| `project_column`      | `objeto`  | The [project column](/v3/projects/columns) itself.                                                                                  |
\ No newline at end of file
+| Tecla                 | Tipo      | Descrição                                                                                                              |
+| --------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `Ação`                | `string`  | A ação que foi executada na coluna do projeto. Pode ser `created`, `edited`, `moved` ou `deleted`.                     |
+| `alterações`          | `objeto`  | As alterações na coluna do projeto, se a ação foi `editada`.                                                           |
+| `changes[name][from]` | `string`  | A versão anterior do nome se a ação foi `editada`.                                                                     |
+| `after_id`            | `inteiro` | O id da coluna que esta coluna agora segue se a ação foi "movida". Será `nulo` se for a primeira coluna em um projeto. |
+| `project_column`      | `objeto`  | A própria [coluna do projeto](/v3/projects/columns).                                                                   |
diff --git a/translations/pt-BR/data/reusables/webhooks/project_column_short_desc.md b/translations/pt-BR/data/reusables/webhooks/project_column_short_desc.md
index 31cc257267b0..fd604ed44fdb 100644
--- a/translations/pt-BR/data/reusables/webhooks/project_column_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/project_column_short_desc.md
@@ -1 +1 @@
-Activity related to columns in a project board. {% data reusables.webhooks.action_type_desc %} For more information, see the "[project columns](/v3/projects/columns)" REST API.
\ No newline at end of file
+Atividade relacionada a colunas em um quadro de projeto. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte a API REST das "[colunas do projeto](/v3/projects/columns)".
diff --git a/translations/pt-BR/data/reusables/webhooks/project_properties.md b/translations/pt-BR/data/reusables/webhooks/project_properties.md
index 5d00e22d9de7..4ae7477e0905 100644
--- a/translations/pt-BR/data/reusables/webhooks/project_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/project_properties.md
@@ -1,7 +1,7 @@
-| Tecla                 | Tipo     | Descrição                                                                                                            |
-| --------------------- | -------- | -------------------------------------------------------------------------------------------------------------------- |
-| `Ação`                | `string` | The action that was performed on the project. Can be one of `created`, `edited`, `closed`, `reopened`, or `deleted`. |
-| `alterações`          | `objeto` | The changes to the project if the action was `edited`.                                                               |
-| `changes[name][from]` | `string` | A versão anterior do nome se a ação foi `editada`.                                                                   |
-| `changes[body][from]` | `string` | The previous version of the body if the action was `edited`.                                                         |
-| `project`             | `objeto` | The [project](/v3/projects/) itself.                                                                                 |
\ No newline at end of file
+| Tecla                 | Tipo     | Descrição                                                                                              |
+| --------------------- | -------- | ------------------------------------------------------------------------------------------------------ |
+| `Ação`                | `string` | A acção que foi realizada no projeto. Pode ser `created`, `edited`, `closed`, `reopened` ou `deleted`. |
+| `alterações`          | `objeto` | As alterações no projeto, se a ação foi `editada`.                                                     |
+| `changes[name][from]` | `string` | A versão anterior do nome se a ação foi `editada`.                                                     |
+| `changes[body][from]` | `string` | A versão anterior do texto se a ação foi `editada`.                                                    |
+| `project`             | `objeto` | O próprio [projeto](/v3/projects/).                                                                    |
diff --git a/translations/pt-BR/data/reusables/webhooks/project_short_desc.md b/translations/pt-BR/data/reusables/webhooks/project_short_desc.md
index c5f8a804a47c..1ee0ba8b55fc 100644
--- a/translations/pt-BR/data/reusables/webhooks/project_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/project_short_desc.md
@@ -1 +1 @@
-Activity related to project boards. {% data reusables.webhooks.action_type_desc %} For more information, see the "[projects](/v3/projects)" REST API.
\ No newline at end of file
+Atividade relacionada aos quadros de projeto. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte A API REST dos "[projetos](/v3/projects)".
diff --git a/translations/pt-BR/data/reusables/webhooks/public_short_desc.md b/translations/pt-BR/data/reusables/webhooks/public_short_desc.md
index 925a4bfeddc5..e381033962ae 100644
--- a/translations/pt-BR/data/reusables/webhooks/public_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/public_short_desc.md
@@ -1 +1 @@
-When a private repository is made public.  Without a doubt: the best {% data variables.product.product_name %} event. 
\ No newline at end of file
+Quando um repositório privado torna-se público.  Sem dúvida: o melhor evento de {% data variables.product.product_name %}. 
diff --git a/translations/pt-BR/data/reusables/webhooks/pull_request_event_api_properties.md b/translations/pt-BR/data/reusables/webhooks/pull_request_event_api_properties.md
index 70c4671a9380..f864fac8fdb2 100644
--- a/translations/pt-BR/data/reusables/webhooks/pull_request_event_api_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/pull_request_event_api_properties.md
@@ -1,3 +1,3 @@
-| Tecla  | Tipo     | Descrição                                                                                                                                                                                  |
-| ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `Ação` | `string` | A ação que foi executada. Can be one of `opened`, `closed`, `reopened`, `assigned`, `unassigned`, `review_requested`, `review_request_removed`, `labeled`, `unlabeled`, and `synchronize`. |
\ No newline at end of file
+| Tecla  | Tipo     | Descrição                                                                                                                                                                          |
+| ------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `Ação` | `string` | A ação que foi executada. Pode ser `opened`, `closed`, `reopened`, `assigned`, `unassigned`, `review_requested`, `review_request_removed`, `labeled`, `unlabeled` e `synchronize`. |
diff --git a/translations/pt-BR/data/reusables/webhooks/pull_request_properties.md b/translations/pt-BR/data/reusables/webhooks/pull_request_properties.md
index b2619258bb68..fdc0563b1e92 100644
--- a/translations/pt-BR/data/reusables/webhooks/pull_request_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/pull_request_properties.md
@@ -1 +1 @@
-`number`|`integer` | The pull request number. `changes`|`object`| The changes to the comment if the action was `edited`. `changes[title][from]`|`string` | The previous version of the title if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `pull_request`|`object` | The [pull request](/v3/pulls) itself.
\ No newline at end of file
+`número`|`inteiro` | O número do pull request. `alterações`|`objeto`| As alterações no comentário se a ação foi `editada`. `changes[title][from]`|`string` | The previous version of the title if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `pull_request`|`objeto` | O próprio [pull request](/v3/pulls).
diff --git a/translations/pt-BR/data/reusables/webhooks/pull_request_review_comment_event_api_properties.md b/translations/pt-BR/data/reusables/webhooks/pull_request_review_comment_event_api_properties.md
index d62bb11f3d7b..18d4009b6e4e 100644
--- a/translations/pt-BR/data/reusables/webhooks/pull_request_review_comment_event_api_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/pull_request_review_comment_event_api_properties.md
@@ -1,3 +1,3 @@
-| Tecla  | Tipo     | Descrição                                                        |
-| ------ | -------- | ---------------------------------------------------------------- |
-| `Ação` | `string` | The action that was performed on the comment. Pode ser `criado`. |
\ No newline at end of file
+| Tecla  | Tipo     | Descrição                                          |
+| ------ | -------- | -------------------------------------------------- |
+| `Ação` | `string` | A ação realizada no comentário. Pode ser `criado`. |
diff --git a/translations/pt-BR/data/reusables/webhooks/pull_request_review_comment_properties.md b/translations/pt-BR/data/reusables/webhooks/pull_request_review_comment_properties.md
index 85341dd38525..631fd5ae3e93 100644
--- a/translations/pt-BR/data/reusables/webhooks/pull_request_review_comment_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/pull_request_review_comment_properties.md
@@ -1 +1 @@
-`changes`|`object`| The changes to the comment if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `pull_request`|`object` | The [pull request](/v3/pulls/) the comment belongs to. `comment`|`object` | The [comment](/v3/pulls/comments) itself.
\ No newline at end of file
+`alterações`|`objeto`| As alterações no comentário se a ação foi `editada`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `pull_request`|`objeto` | O [pull request](/v3/pulls/) ao qual o comentário pertence. `comentário`|`objeto` | O próprio [comentário](/v3/pulls/comments).
diff --git a/translations/pt-BR/data/reusables/webhooks/pull_request_review_comment_short_desc.md b/translations/pt-BR/data/reusables/webhooks/pull_request_review_comment_short_desc.md
index 0dbf1f6974da..57e1ad143372 100644
--- a/translations/pt-BR/data/reusables/webhooks/pull_request_review_comment_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/pull_request_review_comment_short_desc.md
@@ -1 +1 @@
-Activity related to pull request review comments in the pull request's unified diff. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull request review comments](/v3/pulls/comments/)" REST API.
\ No newline at end of file
+Atividade relacionada aos comentários de revisão do pull request no diff unificado do pull request. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte a API REST dos "[comentários de revisão de pull request](/v3/pulls/comments/)".
diff --git a/translations/pt-BR/data/reusables/webhooks/pull_request_review_comment_webhook_properties.md b/translations/pt-BR/data/reusables/webhooks/pull_request_review_comment_webhook_properties.md
index e2807defdbe1..f6206f2dc75b 100644
--- a/translations/pt-BR/data/reusables/webhooks/pull_request_review_comment_webhook_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/pull_request_review_comment_webhook_properties.md
@@ -1,3 +1,3 @@
-| Tecla  | Tipo     | Descrição                                                                                      |
-| ------ | -------- | ---------------------------------------------------------------------------------------------- |
-| `Ação` | `string` | The action that was performed on the comment. Can be one of `created`, `edited`, or `deleted`. |
\ No newline at end of file
+| Tecla  | Tipo     | Descrição                                                                  |
+| ------ | -------- | -------------------------------------------------------------------------- |
+| `Ação` | `string` | A ação realizada no comentário. Pode ser `created`, `edited` ou `deleted`. |
diff --git a/translations/pt-BR/data/reusables/webhooks/pull_request_review_properties.md b/translations/pt-BR/data/reusables/webhooks/pull_request_review_properties.md
index 225eddbfac05..a0b13a018891 100644
--- a/translations/pt-BR/data/reusables/webhooks/pull_request_review_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/pull_request_review_properties.md
@@ -1,6 +1,6 @@
 | Tecla                 | Tipo     | Descrição                                                                           |
 | --------------------- | -------- | ----------------------------------------------------------------------------------- |
-| `Ação`                | `string` | A ação que foi executada. Pode ser uma das ações a seguir:
    • `submitted` - A pull request review is submitted into a non-pending state.
    • `edited` - The body of a review has been edited.
    • `dismissed` - A review has been dismissed.
     |
-| `pull_request`        | `objeto` | The [pull request](/v3/pulls/) the review pertains to.                              |
-| `revisar`             | `objeto` | The review that was affected.                                                       |
-| `changes[body][from]` | `string` | The previous version of the body if the action was `edited`.                        |
\ No newline at end of file
+| `Ação`                | `string` | A ação que foi executada. Pode ser uma das ações a seguir:
    • `submitted` - Uma revisão de pull request é enviada em um estado não pendente.
    • `edited` - O texto de uma revisão foi editado.
    • `dimissed` - Uma revisão foi descartada.
     |
+| `pull_request`        | `objeto` | O [pull request](/v3/pulls/) ao qual a revisão pertence.                            |
+| `revisar`             | `objeto` | A revisão que foi afetada.                                                          |
+| `changes[body][from]` | `string` | A versão anterior do texto se a ação foi `editada`.                                 |
diff --git a/translations/pt-BR/data/reusables/webhooks/pull_request_review_short_desc.md b/translations/pt-BR/data/reusables/webhooks/pull_request_review_short_desc.md
index a92f0dd3bb24..d90a1bc65508 100644
--- a/translations/pt-BR/data/reusables/webhooks/pull_request_review_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/pull_request_review_short_desc.md
@@ -1 +1 @@
-Activity related to pull request reviews. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull request reviews](/v3/pulls/reviews/)" REST API.
\ No newline at end of file
+Atividade relacionada a revisões de pull request. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte a APTI REST "[Revisões de pull request](/v3/pulls/reviews/)".
diff --git a/translations/pt-BR/data/reusables/webhooks/pull_request_short_desc.md b/translations/pt-BR/data/reusables/webhooks/pull_request_short_desc.md
index c88a5120c8f4..ffbe719b21b9 100644
--- a/translations/pt-BR/data/reusables/webhooks/pull_request_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/pull_request_short_desc.md
@@ -1 +1 @@
-Activity related to pull requests. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull requests](/v3/pulls/)" REST API.
\ No newline at end of file
+Atividade relacionada a pull requests. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte a API REST de "[pull requests](/v3/pulls/)".
diff --git a/translations/pt-BR/data/reusables/webhooks/pull_request_webhook_properties.md b/translations/pt-BR/data/reusables/webhooks/pull_request_webhook_properties.md
index 0766844ac111..175cb8150bb2 100644
--- a/translations/pt-BR/data/reusables/webhooks/pull_request_webhook_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/pull_request_webhook_properties.md
@@ -1,3 +1,3 @@
-| Tecla  | Tipo     | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `Ação` | `string` | A ação que foi executada. Can be one of  `opened`, `edited`, `closed`, `assigned`, `unassigned`, `review_requested`, `review_request_removed`, `ready_for_review`, `labeled`, `unlabeled`, `synchronize`, `locked`, `unlocked`, or `reopened`. If the action is `closed` and the `merged` key is `false`, the pull request was closed with unmerged commits. If the action is `closed` and the `merged` key is `true`, the pull request was merged. |
\ No newline at end of file
+| Tecla  | Tipo     | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `Ação` | `string` | A ação que foi executada. Pode ser  `opened`, `edited`, `closed`, `assigned`, `unassigned`, `review_requested`, `review_request_removed`, `ready_for_review`, `labeled`, `unlabeled`, `synchronize`, `locked`, `unlocked` ou `reopened`. Se a ação é `closed` e a chave `merged` é `false`, o pull request foi fechado com commits não mesclados. Se a ação for `closed` e a chave `merged` for `verdadeira`, o pull request foi mesclado. |
diff --git a/translations/pt-BR/data/reusables/webhooks/push_short_desc.md b/translations/pt-BR/data/reusables/webhooks/push_short_desc.md
index 53583a273873..6c227bb0e289 100644
--- a/translations/pt-BR/data/reusables/webhooks/push_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/push_short_desc.md
@@ -1 +1 @@
-One or more commits are pushed to a repository branch or tag.
\ No newline at end of file
+Um ou mais commits são enviados para uma branch ou tag de um repositório.
diff --git a/translations/pt-BR/data/reusables/webhooks/release_event_api_properties.md b/translations/pt-BR/data/reusables/webhooks/release_event_api_properties.md
index e43765bb318e..a44e1c2e1383 100644
--- a/translations/pt-BR/data/reusables/webhooks/release_event_api_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/release_event_api_properties.md
@@ -1,3 +1,3 @@
-| Tecla  | Tipo     | Descrição                                     |
-| ------ | -------- | --------------------------------------------- |
-| `Ação` | `string` | A ação que foi executada. Can be `published`. |
\ No newline at end of file
+| Tecla  | Tipo     | Descrição                                       |
+| ------ | -------- | ----------------------------------------------- |
+| `Ação` | `string` | A ação que foi executada. Pode ser `publicado`. |
diff --git a/translations/pt-BR/data/reusables/webhooks/release_properties.md b/translations/pt-BR/data/reusables/webhooks/release_properties.md
index f9fa6700c8ba..c1db795f3a8a 100644
--- a/translations/pt-BR/data/reusables/webhooks/release_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/release_properties.md
@@ -1 +1 @@
-`changes[body][from]` |`string` | The previous version of the body if the action was `edited`. `changes[name][from]` |`string` | The previous version of the name if the action was `edited`. `release`|`object` | The [release](/v3/repos/releases/#get-a-release) object.
\ No newline at end of file
+`alterações[body][from]` |`string` | A versão anterior do texto se a ação foi `editada`. `changes[name][from]` |`string` | A versão anterior do nome se a ação foi `editada`. `versão`|`objeto` | O objeto da [versão](/rest/reference/repos/#get-a-release).
diff --git a/translations/pt-BR/data/reusables/webhooks/release_short_desc.md b/translations/pt-BR/data/reusables/webhooks/release_short_desc.md
index b3250fbf11ec..ae9bb47b6e81 100644
--- a/translations/pt-BR/data/reusables/webhooks/release_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/release_short_desc.md
@@ -1 +1 @@
-Activity related to a release. {% data reusables.webhooks.action_type_desc %} For more information, see the "[releases](/v3/repos/releases/)" REST API.
\ No newline at end of file
+Atividade relacionada a uma versão. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte a APTI REST das [versões](/v3/repos/releases/)".
diff --git a/translations/pt-BR/data/reusables/webhooks/release_webhook_properties.md b/translations/pt-BR/data/reusables/webhooks/release_webhook_properties.md
index 7cc72a53842b..7557f535a7f3 100644
--- a/translations/pt-BR/data/reusables/webhooks/release_webhook_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/release_webhook_properties.md
@@ -1,3 +1,3 @@
-| Tecla  | Tipo     | Descrição                                                                                                                                                                                                                                                                                                                                    |
-| ------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `Ação` | `string` | A ação que foi executada. Pode ser uma das ações a seguir:
    • `published`: a release, pre-release, or draft of a release is published
      • {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}
    • `unpublished`: a release or pre-release is deleted
    • `created`: a draft is saved, or a release or pre-release is published without previously being saved as a draft
    • `edited`: a release, pre-release, or draft release is edited
    • `deleted`: a release, pre-release, or draft release is deleted
    • `prereleased`: a pre-release is created
    • `released`: a release or draft of a release is published, or a pre-release is changed to a release
      • {% endif %} |
\ No newline at end of file
+| Tecla  | Tipo     | Descrição                                                                                                                                                                                                                                                          |
+| ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `Ação` | `string` | A ação que foi executada. Pode ser uma das ações a seguir:
      • `published`: uma versão, pré-versão ou rascunho de uma versão foi publicada
      • `unpublished`: uma versão ou pré-versão foi excluída
      • `created`: um rascunho foi salvo, ou uma versão ou pré-versão foi publicada sem ser previamente salva como rascunho
      • `edited`: uma versão, pré-versão ou rascunho de versão de foi editada
      • `deleted`: uma versão, pré-versão ou rascunho de versão foi excluído
      • `prereleased`: uma pré-versão foi criada
      • `released`: uma versão ou rascunho de uma versão foi publicado ou uma pré-versão foi alterada para uma versão
        •  |
diff --git a/translations/pt-BR/data/reusables/webhooks/repo_desc.md b/translations/pt-BR/data/reusables/webhooks/repo_desc.md
index a61104a4ba83..9bb0e756eac7 100644
--- a/translations/pt-BR/data/reusables/webhooks/repo_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/repo_desc.md
@@ -1 +1 @@
-`repository` | `object` | The [`repository`](/v3/repos/#get-a-repository) where the event occured.
\ No newline at end of file
+`repositório` | `objeto` | O [`repositório`](/v3/repos/#get-a-repository) em que o evento ocorreu.
diff --git a/translations/pt-BR/data/reusables/webhooks/repository_import_properties.md b/translations/pt-BR/data/reusables/webhooks/repository_import_properties.md
index 0dd9a268373a..06cf08812430 100644
--- a/translations/pt-BR/data/reusables/webhooks/repository_import_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/repository_import_properties.md
@@ -1,3 +1,3 @@
-| Tecla    | Tipo     | Descrição                                                                               |
-| -------- | -------- | --------------------------------------------------------------------------------------- |
-| `status` | `string` | The final state of the import. This can be one of `success`, `cancelled`, or `failure`. |
\ No newline at end of file
+| Tecla    | Tipo     | Descrição                                                                   |
+| -------- | -------- | --------------------------------------------------------------------------- |
+| `status` | `string` | O estado final da importação. Pode ser `success`, `cancelled` ou `failure`. |
diff --git a/translations/pt-BR/data/reusables/webhooks/repository_import_short_desc.md b/translations/pt-BR/data/reusables/webhooks/repository_import_short_desc.md
index 2d30661c839a..51fec24a124d 100644
--- a/translations/pt-BR/data/reusables/webhooks/repository_import_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/repository_import_short_desc.md
@@ -1 +1 @@
-Activity related to a repository being imported to GitHub. {% data reusables.webhooks.action_type_desc %} For more information, see the "[source imports](/v3/migrations/source_imports/)" REST API.
\ No newline at end of file
+Atividade relacionada a um repositório que está sendo importado para o GitHub. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte a API REST de "[importações de código-fonte"](/v3/migrations/source_imports/)".
diff --git a/translations/pt-BR/data/reusables/webhooks/repository_short_desc.md b/translations/pt-BR/data/reusables/webhooks/repository_short_desc.md
index b7c3f660a8a0..541274b8991a 100644
--- a/translations/pt-BR/data/reusables/webhooks/repository_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/repository_short_desc.md
@@ -1 +1 @@
-Activity related to a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[repositories](/v3/repos/)" REST API.
\ No newline at end of file
+Atividade relacionada a um repositório. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte a API REST dos[repositórios](/v3/repos/)".
diff --git a/translations/pt-BR/data/reusables/webhooks/repository_vulnerability_alert_properties.md b/translations/pt-BR/data/reusables/webhooks/repository_vulnerability_alert_properties.md
index 2a92fc693852..6081b1d21c8e 100644
--- a/translations/pt-BR/data/reusables/webhooks/repository_vulnerability_alert_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/repository_vulnerability_alert_properties.md
@@ -1,4 +1,4 @@
-| Tecla    | Tipo     | Descrição                                                                       |
-| -------- | -------- | ------------------------------------------------------------------------------- |
-| `Ação`   | `string` | A ação que foi executada. This can be one of `create`, `dismiss`, or `resolve`. |
-| `alerta` | `objeto` | The security alert of the vulnerable dependency.                                |
\ No newline at end of file
+| Tecla    | Tipo     | Descrição                                                            |
+| -------- | -------- | -------------------------------------------------------------------- |
+| `Ação`   | `string` | A ação que foi executada. Pode ser `create`, `dismiss` ou `resolve`. |
+| `alerta` | `objeto` | O alerta de segurança da dependência vulnerável.                     |
diff --git a/translations/pt-BR/data/reusables/webhooks/repository_vulnerability_alert_short_desc.md b/translations/pt-BR/data/reusables/webhooks/repository_vulnerability_alert_short_desc.md
index 9eab73f38a49..06bd2b488a3c 100644
--- a/translations/pt-BR/data/reusables/webhooks/repository_vulnerability_alert_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/repository_vulnerability_alert_short_desc.md
@@ -1 +1 @@
-Activity related to security vulnerability alerts in a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[About security alerts for vulerable dependencies](/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies)".
\ No newline at end of file
+Atividade relacionada a alertas de vulnerabilidade de segurança em um repositório. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte "[Sobre alertas de segurança para dependências vulneráveis](/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies)".
diff --git a/translations/pt-BR/data/reusables/webhooks/secret.md b/translations/pt-BR/data/reusables/webhooks/secret.md
index 119e13a93770..6d87b82bd418 100644
--- a/translations/pt-BR/data/reusables/webhooks/secret.md
+++ b/translations/pt-BR/data/reusables/webhooks/secret.md
@@ -1 +1 @@
-Setting a webhook secret allows you to ensure that `POST` requests sent to the payload URL are from GitHub. When you set a secret, you'll receive the `X-Hub-Signature` header in the webhook `POST` request. For more details on how to use the secret and the `X-Hub-Signature` header to secure your webhook payloads, see "[Securing your webhooks](/webhooks/securing/)."
\ No newline at end of file
+Definir um segredo de webhook permite que você certifique-se de que as solicitações `POST` enviadas para a URL da carga são de {% data variables.product.product_name %}. Ao definir um segredo, você receberá os cabeçalhos {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 2" %}`X-Hub-Signature` e `X-Hub-Signature-256` {% else if currentVersion ver_lt "enterprise-server@2. 3" %} cabeçalho `X-Hub-Signature` {% else if currentVersion == "private-instances@latest" %} cabeçalho `X-Hub-Signature-256`{% endif %} na solicitação `POST` do webhook. Para obter mais informações sobre como usar um segredo com um cabeçalho de assinatura para proteger as suas cargas do webhook, veja "[Proteger seus webhooks](/webhooks/securing/)."
diff --git a/translations/pt-BR/data/reusables/webhooks/sender_desc.md b/translations/pt-BR/data/reusables/webhooks/sender_desc.md
index d3c9f888bc19..53d1c57a39a4 100644
--- a/translations/pt-BR/data/reusables/webhooks/sender_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/sender_desc.md
@@ -1 +1 @@
-`sender` | `object` | The user that triggered the event.
\ No newline at end of file
+`remetente` | `objeto` | O usuário que ativou o evento.
diff --git a/translations/pt-BR/data/reusables/webhooks/sponsorship_event_api_properties.md b/translations/pt-BR/data/reusables/webhooks/sponsorship_event_api_properties.md
index 5992009a0a34..1b37510281e9 100644
--- a/translations/pt-BR/data/reusables/webhooks/sponsorship_event_api_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/sponsorship_event_api_properties.md
@@ -1,3 +1,3 @@
-| Tecla  | Tipo     | Descrição                                        |
-| ------ | -------- | ------------------------------------------------ |
-| `Ação` | `string` | A ação que foi executada. This can be `created`. |
\ No newline at end of file
+| Tecla  | Tipo     | Descrição                                    |
+| ------ | -------- | -------------------------------------------- |
+| `Ação` | `string` | A ação que foi executada. Pode ser `criado`. |
diff --git a/translations/pt-BR/data/reusables/webhooks/sponsorship_properties.md b/translations/pt-BR/data/reusables/webhooks/sponsorship_properties.md
index 6506db181710..939d7fd0ea13 100644
--- a/translations/pt-BR/data/reusables/webhooks/sponsorship_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/sponsorship_properties.md
@@ -1 +1 @@
-`effective_date` | `string` | The `pending_cancellation` and `pending_tier_change` event types will include the date the cancellation or tier change will take effect. `changes[tier][from]` | `object` | The `tier_changed` and `pending_tier_change` will include the original tier before the change or pending change. For more information, see the [pending tier change payload](/webhooks/event-payloads#webhook-payload-example-when-someone-downgrades-a-sponsorship). `changes[privacy_level][from]` | `string` | The `edited` event types include the details about the change when someone edits a sponsorship to change the privacy.
\ No newline at end of file
+`effective_date` | `string` | The `pending_cancellation` and `pending_tier_change` event types will include the date the cancellation or tier change will take effect. `changes[tier][from]` | `object` | The `tier_changed` and `pending_tier_change` will include the original tier before the change or pending change. For more information, see the [pending tier change payload](/webhooks/event-payloads#webhook-payload-example-when-someone-downgrades-a-sponsorship). `changes[privacy_level][from]` | `string` | The `edited` event types include the details about the change when someone edits a sponsorship to change the privacy.
diff --git a/translations/pt-BR/data/reusables/webhooks/sponsorship_short_desc.md b/translations/pt-BR/data/reusables/webhooks/sponsorship_short_desc.md
index cb6cdccf21dc..025ff2b4cd01 100644
--- a/translations/pt-BR/data/reusables/webhooks/sponsorship_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/sponsorship_short_desc.md
@@ -1 +1 @@
-Activity related to a sponsorship listing. {% data reusables.webhooks.action_type_desc %} For more information, see "[About GitHub Sponsors](/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors)".
\ No newline at end of file
+Atividade relacionada a uma listagem de patrocínios. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte "[Sobre os Patrocinadores do GitHub](/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors)".
diff --git a/translations/pt-BR/data/reusables/webhooks/sponsorship_webhook_properties.md b/translations/pt-BR/data/reusables/webhooks/sponsorship_webhook_properties.md
index 3cc7942eb45d..be964c5cbbd2 100644
--- a/translations/pt-BR/data/reusables/webhooks/sponsorship_webhook_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/sponsorship_webhook_properties.md
@@ -1,3 +1,3 @@
-| Tecla  | Tipo     | Descrição                                                                                                                                        |
-| ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `Ação` | `string` | A ação que foi executada. This can be one of `created`, `cancelled`, `edited`, `tier_changed`, `pending_cancellation`, or `pending_tier_change`. |
\ No newline at end of file
+| Tecla  | Tipo     | Descrição                                                                                                                             |
+| ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------- |
+| `Ação` | `string` | A ação que foi executada. Pode ser `created`, `cancelled`, `edited`, `tier_changed`, `pending_cancellation` ou `pending_tier_change`. |
diff --git a/translations/pt-BR/data/reusables/webhooks/star_properties.md b/translations/pt-BR/data/reusables/webhooks/star_properties.md
index 2e4c56648406..979c308400de 100644
--- a/translations/pt-BR/data/reusables/webhooks/star_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/star_properties.md
@@ -1,4 +1,4 @@
-| Tecla        | Tipo     | Descrição                                                                                                            |
-| ------------ | -------- | -------------------------------------------------------------------------------------------------------------------- |
-| `Ação`       | `string` | A ação realizada. Can be `created` or `deleted`.                                                                     |
-| `starred_at` | `string` | The time the star was created. {% data reusables.shortdesc.iso_8601 %} Will be `null` for the `deleted` action. |
\ No newline at end of file
+| Tecla        | Tipo     | Descrição                                                                                                          |
+| ------------ | -------- | ------------------------------------------------------------------------------------------------------------------ |
+| `Ação`       | `string` | A ação realizada. Pode ser `criado` ou `excluído`.                                                                 |
+| `starred_at` | `string` | O momento em que a estrela foi criada. {% data reusables.shortdesc.iso_8601 %} Será `nulo` para a ação `excluída`. |
diff --git a/translations/pt-BR/data/reusables/webhooks/star_short_desc.md b/translations/pt-BR/data/reusables/webhooks/star_short_desc.md
index eac484160fed..c6d38acba57a 100644
--- a/translations/pt-BR/data/reusables/webhooks/star_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/star_short_desc.md
@@ -1 +1 @@
-Activity related to a repository being starred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[starring](/v3/activity/starring/)" REST API.
\ No newline at end of file
+Atividade relacionada a um repositório marcado com uma estrela. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte a API REST de "[marcar com uma estrela](/v3/activity/starring/)".
diff --git a/translations/pt-BR/data/reusables/webhooks/status_short_desc.md b/translations/pt-BR/data/reusables/webhooks/status_short_desc.md
index 8d28713099d2..e15c21d67088 100644
--- a/translations/pt-BR/data/reusables/webhooks/status_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/status_short_desc.md
@@ -1 +1 @@
-When the status of a Git commit changes. {% data reusables.webhooks.action_type_desc %} For more information, see the "[statuses](/v3/repos/statuses/)" REST API.
\ No newline at end of file
+Quando o status de um commit do Git é alterado. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte a API REST de "[status](/v3/repos/statuses/)".
diff --git a/translations/pt-BR/data/reusables/webhooks/team_add_short_desc.md b/translations/pt-BR/data/reusables/webhooks/team_add_short_desc.md
index 5ef912458fe4..1bbcfaba4a63 100644
--- a/translations/pt-BR/data/reusables/webhooks/team_add_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/team_add_short_desc.md
@@ -1 +1 @@
-When a [repository is added to a team](/v3/teams/#add-or-update-team-repository-permissions).
\ No newline at end of file
+Quando um repositório [é adicionado a uma equipe](/v3/teams/#add-or-update-team-repository-permissions).
diff --git a/translations/pt-BR/data/reusables/webhooks/team_short_desc.md b/translations/pt-BR/data/reusables/webhooks/team_short_desc.md
index 8faf762fe915..72ee238f5c51 100644
--- a/translations/pt-BR/data/reusables/webhooks/team_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/team_short_desc.md
@@ -1 +1 @@
-Activity related to an organization's team. {% data reusables.webhooks.action_type_desc %} For more information, see the "[teams](/v3/teams/)" REST API.
\ No newline at end of file
+Atividade relacionada à equipe de uma organização. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte a API REST de "[equipes](/v3/teams/)".
diff --git a/translations/pt-BR/data/reusables/webhooks/watch_properties.md b/translations/pt-BR/data/reusables/webhooks/watch_properties.md
index c87f239afc9a..3f448fd9bf02 100644
--- a/translations/pt-BR/data/reusables/webhooks/watch_properties.md
+++ b/translations/pt-BR/data/reusables/webhooks/watch_properties.md
@@ -1,3 +1,3 @@
-| Tecla  | Tipo     | Descrição                                                   |
-| ------ | -------- | ----------------------------------------------------------- |
-| `Ação` | `string` | A ação que foi executada. Currently, can only be `started`. |
\ No newline at end of file
+| Tecla  | Tipo     | Descrição                                                       |
+| ------ | -------- | --------------------------------------------------------------- |
+| `Ação` | `string` | A ação que foi executada. Atualmente, só pode ser `favoritada`. |
diff --git a/translations/pt-BR/data/reusables/webhooks/watch_short_desc.md b/translations/pt-BR/data/reusables/webhooks/watch_short_desc.md
index a40fc1893db2..785a55bca60f 100644
--- a/translations/pt-BR/data/reusables/webhooks/watch_short_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/watch_short_desc.md
@@ -1 +1 @@
-When someone stars a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[starring](/v3/activity/starring/)" REST API.
\ No newline at end of file
+Quando alguém marca um repositório com uma estrela. {% data reusables.webhooks.action_type_desc %} Para obter mais informações, consulte a API REST de "[marcar com uma estrela](/v3/activity/starring/)".
diff --git a/translations/pt-BR/data/reusables/webhooks/webhooks_ssl.md b/translations/pt-BR/data/reusables/webhooks/webhooks_ssl.md
index 987a85576227..66d348aa5e79 100644
--- a/translations/pt-BR/data/reusables/webhooks/webhooks_ssl.md
+++ b/translations/pt-BR/data/reusables/webhooks/webhooks_ssl.md
@@ -1 +1 @@
-If your "Payload URL" is a secure site (HTTPS), you will have the option to configure the SSL verification settings. If your "Payload URL" is not secure (HTTP), GitHub will not display this option. By default, GitHub verifies the SSL certificate of your website when delivering webhook payloads. SSL verification helps ensure that hook payloads are delivered to your URL endpoint securely. You have the option to disable SSL, but we recommend keeping **Enable SSL verification** selected.
\ No newline at end of file
+Se sua "URL da carga" for uma site seguro (HTTPS), você terá a opção de definir as configurações de verificação SSL. Se a sua "URL de carga " não for segura (HTTP), o GitHub não exibirá esta opção. Por padrão, o GitHub verifica o certificado SSL do seu site ao entregar as cargas de webhook. SSL verification helps ensure that hook payloads are delivered to your URL endpoint securely. You have the option to disable SSL, but we recommend keeping **Enable SSL verification** selected.
diff --git a/translations/pt-BR/data/reusables/webhooks/workflow_run_desc.md b/translations/pt-BR/data/reusables/webhooks/workflow_run_desc.md
index 25d67bab0223..8866577116c7 100644
--- a/translations/pt-BR/data/reusables/webhooks/workflow_run_desc.md
+++ b/translations/pt-BR/data/reusables/webhooks/workflow_run_desc.md
@@ -1,4 +1,4 @@
 
 This event occurs when a workflow run is requested or completed, and allows you to execute a workflow based on the finished result of another workflow. For example, if your `pull_request` workflow generates build artifacts, you can create a new workflow that uses `workflow_run` to analyze the results and add a comment to the original pull request.
 
-The workflow started by the `workflow_run` event is able to access the secrets and write tokens used by the original workflow.
\ No newline at end of file
+The workflow started by the `workflow_run` event is able to access the secrets and write tokens used by the original workflow.
diff --git a/translations/pt-BR/data/variables/command_line.yml b/translations/pt-BR/data/variables/command_line.yml
index 4816981ce2e9..805c67903e68 100644
--- a/translations/pt-BR/data/variables/command_line.yml
+++ b/translations/pt-BR/data/variables/command_line.yml
@@ -1,5 +1,5 @@
 ---
-#Use this variable wherever backticks are necessary: http://git.io/AArkqA
+#Use this variable wherever backticks are necessary: https://github.com/github/docs-internal/pull/1176#discussion-diff-19853931
 backticks: >-
   {% if currentVersion == "free-pro-team@latest" %}github.com{% else %}[hostname]{% endif %}
 #Use this variable within codeblocks (because it includes HTML! Which only renders in shell codeblocks!)
diff --git a/translations/pt-BR/data/variables/contact.yml b/translations/pt-BR/data/variables/contact.yml
index 7f8694d18f12..52f4c514eed2 100644
--- a/translations/pt-BR/data/variables/contact.yml
+++ b/translations/pt-BR/data/variables/contact.yml
@@ -1,18 +1,17 @@
 ---
 contact_ent_support: '[Suporte do GitHub Enterprise](https://enterprise.githubsupport.com/hc/en-us) ou [Suporte do GitHub Premium](https://premium.githubsupport.com)'
 contact_support: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Suporte do GitHub](https://support.github.com/contact) or [Suporte do GitHub Premium](https://premium.githubsupport.com){% else %}seu administrador do site do GitHub Enterprise{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[GitHub Support](https://support.github.com/contact) or [GitHub Premium Support](https://premium.githubsupport.com){% else %}your GitHub Enterprise site administrator{% endif %}
 report_abuse: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Denunciar abuso](https://github.com/contact/report-abuse){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Report abuse](https://github.com/contact/report-abuse){% endif %}
 report_content: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Denunciar conteúdo](https://github.com/contact/report-content){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Report content](https://github.com/contact/report-content){% endif %}
 contact_dmca: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Formulário de reivindicação de direitos autorais](https://github.com/contact/dmca){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Copyright claims form](https://github.com/contact/dmca){% endif %}
 contact_privacy: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Formulário de contato sobre privacidade](https://github.com/contact/privacy){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Privacy contact form](https://github.com/contact/privacy){% endif %}
 contact_enterprise_sales: '[Equipe de Vendas do GitHub](https://enterprise.github.com/contact)'
 contact_feedback_actions: '[Formulário de feedback do GitHub Actions](https://support.github.com/contact/feedback?contact[category]=actions)'
-contact_partner_engineering: '[partnerengineering@github.com](mailto:partnerengineering@github.com)'
 #The team that provides Standard Support
 enterprise_support: 'Suporte do GitHub Enterprise'
 #The larger team that includes Enterprise Support and Premium Support
diff --git a/translations/pt-BR/data/variables/explore.yml b/translations/pt-BR/data/variables/explore.yml
index 1f712c7e1d7e..e9d43c423085 100644
--- a/translations/pt-BR/data/variables/explore.yml
+++ b/translations/pt-BR/data/variables/explore.yml
@@ -1,7 +1,7 @@
 ---
 explore_github: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Explore GitHub](https://github.com/explore){% else %}Explorar o GitHub (`https://[hostname]/explore`){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Explore GitHub](https://github.com/explore){% else %}Explore GitHub (`https://[hostname]/explore`){% endif %}
 your_stars_page: >-
-  {% if currentVersion == "free-pro-team@latest" %}[stars page](https://github.com/stars){% else %}página Favoritos (`https://[hostname]/stars`){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[stars page](https://github.com/stars){% else %}stars page (`https://[hostname]/stars`){% endif %}
 trending_page: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Trending page](https://github.com/trending){% else %}página Tendências (`https://[hostname]/trending`){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Trending page](https://github.com/trending){% else %}Trending page (`https://[hostname]/trending`){% endif %}
diff --git a/translations/pt-BR/data/variables/gists.yml b/translations/pt-BR/data/variables/gists.yml
index a981a98f6747..9d1fea10acf4 100644
--- a/translations/pt-BR/data/variables/gists.yml
+++ b/translations/pt-BR/data/variables/gists.yml
@@ -1,7 +1,7 @@
 ---
 gist_homepage: >-
-  {% if currentVersion == "free-pro-team@latest" %}[gist home page](https://gist.github.com/){% else %}página inicial gist, `http(s)://[hostname]/gist` ou `http(s)://gist.[hostname]` se os subdomínios estiverem habilitados {% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[gist home page](https://gist.github.com/){% else %}gist home page, `http(s)://[hostname]/gist` or `http(s)://gist.[hostname]` if subdomains are enabled {% endif %}
 gist_search_url: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Gist Search](https://gist.github.com/search){% else %}Pesquisa Gist, `http(s)://[hostname]/gist/search` ou `http(s)://gist.[hostname]/search` se os subdomínios estiverem habilitados{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Gist Search](https://gist.github.com/search){% else %}Gist Search, `http(s)://[hostname]/gist/search` or `http(s)://gist.[hostname]/search` if subdomains are enabled{% endif %}
 discover_url: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Discover](https://gist.github.com/discover){% else %}Discover, `http(s)://[hostname]/gist/discover` ou `http(s)://gist.[hostname]/discover` se os subdomínios estiverem habilitados{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Discover](https://gist.github.com/discover){% else %}Discover, `http(s)://[hostname]/gist/discover` or `http(s)://gist.[hostname]/discover` if subdomains are enabled{% endif %}
diff --git a/translations/pt-BR/data/variables/notifications.yml b/translations/pt-BR/data/variables/notifications.yml
index 16df78e72e39..441bdba328c2 100644
--- a/translations/pt-BR/data/variables/notifications.yml
+++ b/translations/pt-BR/data/variables/notifications.yml
@@ -1,5 +1,5 @@
 ---
 no_reply_address: >-
-  {% if currentVersion == "free-pro-team@latest" %}`noreply@github.com`{% else %}endereço de e-mail no-reply configurado pelo administrador do seu site{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}`noreply@github.com`{% else %}the no-reply email address configured by your site administrator{% endif %}
 cc_address: >-
-  {% if currentVersion == "free-pro-team@latest" %}`@noreply.github.com`{% else %}com base no endereço de e-mail no-reply configurado pelo administrador do seu site{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}`@noreply.github.com`{% else %}based on the no-reply email address configured by your site administrator{% endif %}
diff --git a/translations/pt-BR/data/variables/product.yml b/translations/pt-BR/data/variables/product.yml
index 3fdd5e7b80e5..bafdbef8f9cf 100644
--- a/translations/pt-BR/data/variables/product.yml
+++ b/translations/pt-BR/data/variables/product.yml
@@ -19,7 +19,7 @@ prodname_ghe_cloud: 'GitHub Enterprise Cloud'
 prodname_ghe_one: 'GitHub One'
 ## Use these variables when referring specifically to a location within a product
 product_location: >-
-  {% if currentVersion == "free-pro-team@latest" %}GitHub{% else %}sua instância do GitHub Enterprise Server{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}GitHub{% else %}your GitHub Enterprise Server instance{% endif %}
 product_location_enterprise: 'sua instância do GitHub Enterprise Server'
 prodname_free_user: 'GitHub Free'
 prodname_pro: 'GitHub Pro'
@@ -56,12 +56,9 @@ prodname_github_app: 'aplicativo GitHub'
 prodname_github_apps: 'Aplicativos do GitHub'
 prodname_oauth_app: 'aplicativo OAuth'
 #API and developer docs
-prodname_dev_docs: 'documentação do GitHub Developer'
 prodname_enterprise_api: 'API do GitHub Enterprise Server'
-prodname_support_forum: 'Fórum de Suporte e Desenvolvimento de API GitHub'
 prodname_support_forum_with_url: '[Fórum de Suporte e Desenvolvimento de API GitHub](https://github.community/c/github-api-development-and-support/37)'
 prodname_unfurls: 'Anexos do conteúdo'
-prodname_component_kit: 'Kit de componente GitHub'
 #GitHub Actions
 ## Use this variable only when referring to GitHub Actions the product. When referring to the thing that someone creates using the product, call it an action (small a). See the terminology page of the Brand Guide for more.
 prodname_actions: 'GitHub Actions'
@@ -80,9 +77,8 @@ prodname_matching_fund: 'Fundo Correspondentes para Patrocinadores do GitHub'
 prodname_advanced_security: 'Segurança Avançada'
 #Codespaces
 prodname_codespaces: 'Codespaces'
-prodname_vscode: 'Visual Studio Code'
 prodname_vs_codespaces: 'Espaços de códigos Visual Studio'
-prodname_vs: 'Visual Studio'
+prodname_github_codespaces: 'GitHub Codespaces'
 #GitHub resources: blog, jobs, Learning Lab
 prodname_gcf: 'Suporte à Comunidade GitHub'
 prodname_blog: 'GitHub Blog'
@@ -110,15 +106,18 @@ prodname_code_scanning: 'Varredura de código'
 prodname_code_scanning_capc: 'Varredura de código'
 prodname_codeql_runner: 'CodeQL runner'
 prodname_advisory_database: 'Banco de Dados Consultivo GitHub'
-prodname_codeql_workflow: 'CodeQL Analysis workflow'
+prodname_codeql_workflow: 'CodeQL analysis workflow'
+#Visual Studio
+prodname_vs: 'Visual Studio'
+prodname_vscode: 'Visual Studio Code'
+prodname_vss_ghe: 'Visual Studio subscription with GitHub Enterprise'
+prodname_vss_admin_portal_with_url: 'the [administrator portal for Visual Studio subscriptions](https://visualstudio.microsoft.com/subscriptions-administration/)'
 #GitHub Dependabot
 prodname_dependabot: 'GitHub Dependabot'
 prodname_dependabot_short: 'Dependabot'
 prodname_dependabot_alerts: 'Alertas GitHub Dependabot'
 prodname_dependabot_security_updates: 'Atualizações de segurança do GitHub Dependabot'
 prodname_dependabot_version_updates: 'Atualizações de versão do GitHub Dependabot'
-#GitHub Policies
-prodname_policies: 'GitHub Policies'
 #GitHub Archive Program
 prodname_archive: 'Programa Arquivo do GitHub'
 prodname_arctic_vault: 'Arctic Code Vault'
@@ -127,9 +126,9 @@ product_url: >-
   {% if currentVersion == "free-pro-team@latest" %}github.com{% else %}[hostname]{% endif %}
 pricing_url: 'https://github.com/pricing'
 signin_link: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Sign in](https://github.com/login){% else %}Entrar (`https://[hostname]/login`){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Sign in](https://github.com/login){% else %}Sign in (`https://[hostname]/login`){% endif %}
 signout_link: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Sign out](https://github.com/logout){% else %}Sair (`https://[hostname]/logout`){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Sign out](https://github.com/logout){% else %}Sign out (`https://[hostname]/logout`){% endif %}
 raw_github_com: >-
   {% if currentVersion == "free-pro-team@latest" %}raw.githubusercontent.com{% else %}[hostname]/user/repo/raw{% endif %}
 #GitHub Enterprise Server past versions
diff --git a/translations/pt-BR/data/variables/search.yml b/translations/pt-BR/data/variables/search.yml
index a50282c9e69a..f22c85c91625 100644
--- a/translations/pt-BR/data/variables/search.yml
+++ b/translations/pt-BR/data/variables/search.yml
@@ -1,11 +1,5 @@
 ---
 advanced_url: >-
-  {% if currentVersion == "free-pro-team@latest" %}[advanced search](https://github.com/search/advanced) página{% else %}página de pesquisa avançada (`https://[hostname]/search/advanced`){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[advanced search](https://github.com/search/advanced) page{% else %}advanced search page (`https://[hostname]/search/advanced`){% endif %}
 search_page_url: >-
-  {% if currentVersion == "free-pro-team@latest" %}[search](https://github.com/search) página{% else %}página de pesquisa (`https://[hostname]/search`){% endif %}
-search_highlighting_link: >-
-  Para obter mais detalhes sobre como receber resultados de pesquisa destacados, consulte [Metadados de correspondência de texto](#text-match-metadados).
-search_query_description: >-
-  A consulta contém uma ou mais palavras-chave de pesquisa e qualificadores. Os qualificadores permitem limitar sua pesquisa a áreas específicas do GitHub. A API REST suporta os mesmos qualificadores que GitHub.com. Para saber mais sobre o formato da consulta, veja [Construindo uma consulta de pesquisa](#constructing-a-search-query).
-order_description: >-
-  Determines whether the first search result returned is the highest number of matches (`desc`) or lowest number of matches (`asc`). This parameter is ignored unless you provide `sort`. Default: `desc`
+  {% if currentVersion == "free-pro-team@latest" %}[search](https://github.com/search) page{% else %}search page (`https://[hostname]/search`){% endif %}
diff --git a/translations/ru-RU/content/actions/creating-actions/about-actions.md b/translations/ru-RU/content/actions/creating-actions/about-actions.md
index 8d50587aa187..ab237deca61a 100644
--- a/translations/ru-RU/content/actions/creating-actions/about-actions.md
+++ b/translations/ru-RU/content/actions/creating-actions/about-actions.md
@@ -20,7 +20,8 @@ versions:
 You can create actions by writing custom code that interacts with your repository in any way you'd like, including integrating with {% data variables.product.prodname_dotcom %}'s APIs and any publicly available third-party API. For example, an action can publish npm modules, send SMS alerts when urgent issues are created, or deploy production-ready code.
 
 {% if currentVersion == "free-pro-team@latest" %}
-You can write your own actions to use in your workflow or share the actions you build with the {% data variables.product.prodname_dotcom %} community. To share actions you've built, your repository must be public.
+You can write your own actions to use in your workflow or share the actions you build with the
+{% data variables.product.prodname_dotcom %} community. To share actions you've built, your repository must be public.
 {% endif %}
 
 Actions can run directly on a machine or in a Docker container. You can define an action's inputs, outputs, and environment variables.
@@ -60,7 +61,8 @@ A _composite run steps_ action allows you to combine multiple workflow run steps
 If you're developing an action for other people to use, we recommend keeping the action in its own repository instead of bundling it with other application code. This allows you to version, track, and release the action just like any other software.
 
 {% if currentVersion == "free-pro-team@latest" %}
-Storing an action in its own repository makes it easier for the {% data variables.product.prodname_dotcom %} community to discover the action, narrows the scope of the code base for developers fixing issues and extending the action, and decouples the action's versioning from the versioning of other application code.
+Storing an action in its own repository makes it easier for the
+{% data variables.product.prodname_dotcom %} community to discover the action, narrows the scope of the code base for developers fixing issues and extending the action, and decouples the action's versioning from the versioning of other application code.
 {% endif %}
 
 {% if currentVersion == "free-pro-team@latest" %}If you're building an action that you don't plan to make available to the public, you {% else %} You{% endif %} can store the action's files in any location in your repository. If you plan to combine action, workflow, and application code in a single repository, we recommend storing actions in the `.github` directory. For example, `.github/actions/action-a` and `.github/actions/action-b`.
@@ -141,7 +143,7 @@ We recommend creating a README file to help people learn how to use your action.
 
 ### Comparing {% data variables.product.prodname_actions %} to {% data variables.product.prodname_github_apps %}
 
-{% data variables.product.prodname_marketplace %} offers tools to improve your workflow. Understanding the differences and the benefits of each tool will allow you to select the best tool for your job. For more information about building actions and apps, see "[About GitHub Actions](/actions/getting-started-with-github-actions/about-github-actions)" and "[About apps](/apps/about-apps/)."
+{% data variables.product.prodname_marketplace %} offers tools to improve your workflow. Understanding the differences and the benefits of each tool will allow you to select the best tool for your job. For more information about building apps, see "[About apps](/apps/about-apps/)."
 
 #### Strengths of GitHub Actions and GitHub Apps
 
diff --git a/translations/ru-RU/content/actions/creating-actions/creating-a-composite-run-steps-action.md b/translations/ru-RU/content/actions/creating-actions/creating-a-composite-run-steps-action.md
index d3daf90c0620..91bf1072283a 100644
--- a/translations/ru-RU/content/actions/creating-actions/creating-a-composite-run-steps-action.md
+++ b/translations/ru-RU/content/actions/creating-actions/creating-a-composite-run-steps-action.md
@@ -36,7 +36,7 @@ Before you begin, you'll create a {% data variables.product.product_name %} repo
   echo "Goodbye"
   ```
 
-1. From your terminal, make `goodbye.sh` executable and check it into your repository.
+3. From your terminal, make `goodbye.sh` executable.
 
   ```shell
   chmod +x goodbye.sh
@@ -85,13 +85,26 @@ Before you begin, you'll create a {% data variables.product.product_name %} repo
 
   For more information about how to use `github.action_path`, see "[`github context`](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)".
 
-1. Create a new label. This example uses a label called `v1` for the main branch. For more information, see "[Creating a label ](/github/managing-your-work-on-github/creating-a-label)."
+1. From your terminal, check in your `action.yml` file.
+
+  ```shell
+  git add action.yml
+  git commit -m "Add action"
+  git push
+  ```
+
+1. From your terminal, add a tag. This example uses a tag called `v1`. For more information, see "[About actions](/actions/creating-actions/about-actions#using-release-management-for-actions)."
+
+  ```shell
+  git tag -a -m "Description of this release" v1
+  git push --follow-tags
+  ```
 
 ### Testing out your action in a workflow
 
 The following workflow code uses the completed hello world action that you made in "[Creating an action metadata file](/actions/creating-actions/creating-a-composite-run-steps-action#creating-an-action-metadata-file)".
 
-Copy the workflow code into a `.github/workflows/main.yml` file in another repository, but replace `actions/hello-world-composite-run-steps-action@v1` with the repository and label you created. You can also replace the `who-to-greet` input with your name.
+Copy the workflow code into a `.github/workflows/main.yml` file in another repository, but replace `actions/hello-world-composite-run-steps-action@v1` with the repository and tag you created. You can also replace the `who-to-greet` input with your name.
 
 {% raw %}
 **.github/workflows/main.yml**
diff --git a/translations/ru-RU/content/actions/creating-actions/creating-a-docker-container-action.md b/translations/ru-RU/content/actions/creating-actions/creating-a-docker-container-action.md
index 0e5ebabe2ccd..a049477ac5dc 100644
--- a/translations/ru-RU/content/actions/creating-actions/creating-a-docker-container-action.md
+++ b/translations/ru-RU/content/actions/creating-actions/creating-a-docker-container-action.md
@@ -1,6 +1,6 @@
 ---
 title: Creating a Docker container action
-intro: This guide shows you the minimal steps required to build a Docker container action.
+intro: 'This guide shows you the minimal steps required to build a Docker container action.'
 product: '{% data reusables.gated-features.actions %}'
 redirect_from:
   - /articles/creating-a-docker-container-action
diff --git a/translations/ru-RU/content/actions/creating-actions/creating-a-javascript-action.md b/translations/ru-RU/content/actions/creating-actions/creating-a-javascript-action.md
index 55eec11d5628..7c0b43a5e7d8 100644
--- a/translations/ru-RU/content/actions/creating-actions/creating-a-javascript-action.md
+++ b/translations/ru-RU/content/actions/creating-actions/creating-a-javascript-action.md
@@ -77,9 +77,9 @@ This file defines the `who-to-greet` input and `time` output. It also tells the
 
 The actions toolkit is a collection of Node.js packages that allow you to quickly build JavaScript actions with more consistency.
 
-The toolkit [`@actions/core`](https://github.com/actions/toolkit/tree/master/packages/core) package provides an interface to the workflow commands, input and output variables, exit statuses, and debug messages.
+The toolkit [`@actions/core`](https://github.com/actions/toolkit/tree/main/packages/core) package provides an interface to the workflow commands, input and output variables, exit statuses, and debug messages.
 
-The toolkit also offers a [`@actions/github`](https://github.com/actions/toolkit/tree/master/packages/github) package that returns an authenticated Octokit REST client and access to GitHub Actions contexts.
+The toolkit also offers a [`@actions/github`](https://github.com/actions/toolkit/tree/main/packages/github) package that returns an authenticated Octokit REST client and access to GitHub Actions contexts.
 
 The toolkit offers more than the `core` and `github` packages. For more information, see the [actions/toolkit](https://github.com/actions/toolkit) repository.
 
@@ -119,7 +119,7 @@ try {
 }
 ```
 
-If an error is thrown in the above `index.js` example, `core.setFailed(error.message);` uses the actions toolkit [`@actions/core`](https://github.com/actions/toolkit/tree/master/packages/core) package to log a message and set a failing exit code. For more information, see "[Setting exit codes for actions](/actions/creating-actions/setting-exit-codes-for-actions)."
+If an error is thrown in the above `index.js` example, `core.setFailed(error.message);` uses the actions toolkit [`@actions/core`](https://github.com/actions/toolkit/tree/main/packages/core) package to log a message and set a failing exit code. For more information, see "[Setting exit codes for actions](/actions/creating-actions/setting-exit-codes-for-actions)."
 
 
 ### Creating a README
@@ -258,4 +258,8 @@ jobs:
 
 From your repository, click the **Actions** tab, and select the latest workflow run. You should see "Hello Mona the Octocat" or the name you used for the `who-to-greet` input and the timestamp printed in the log.
 
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+![A screenshot of using your action in a workflow](/assets/images/help/repository/javascript-action-workflow-run-updated.png)
+{% else %}
 ![A screenshot of using your action in a workflow](/assets/images/help/repository/javascript-action-workflow-run.png)
+{% endif %}
\ No newline at end of file
diff --git a/translations/ru-RU/content/actions/creating-actions/index.md b/translations/ru-RU/content/actions/creating-actions/index.md
index bc085b64c319..966e98032bd1 100644
--- a/translations/ru-RU/content/actions/creating-actions/index.md
+++ b/translations/ru-RU/content/actions/creating-actions/index.md
@@ -6,6 +6,7 @@ redirect_from:
   - /github/automating-your-workflow-with-github-actions/building-actions
   - /actions/automating-your-workflow-with-github-actions/building-actions
   - /actions/building-actions
+  - /articles/creating-a-github-action/
 versions:
   free-pro-team: '*'
   enterprise-server: '>=2.22'
diff --git a/translations/ru-RU/content/actions/creating-actions/metadata-syntax-for-github-actions.md b/translations/ru-RU/content/actions/creating-actions/metadata-syntax-for-github-actions.md
index 1d241f174625..885efa3b2b14 100644
--- a/translations/ru-RU/content/actions/creating-actions/metadata-syntax-for-github-actions.md
+++ b/translations/ru-RU/content/actions/creating-actions/metadata-syntax-for-github-actions.md
@@ -42,7 +42,6 @@ Action metadata files use YAML syntax. If you're new to YAML, you can read "[Lea
 
 This example configures two inputs: numOctocats and octocatEyeColor. The numOctocats input is not required and will default to a value of '1'. The octocatEyeColor input is required and has no default value. Workflow files that use this action must use the `with` keyword to set an input value for octocatEyeColor. For more information about the `with` syntax, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepswith)."
 
-
 ```yaml
 inputs:
   numOctocats:
@@ -54,7 +53,6 @@ inputs:
     required: true
 ```
 
-
 When you specify an input to an action in a workflow file or use a default input value, {% data variables.product.prodname_dotcom %} creates an environment variable for the input with the name `INPUT_`. The environment variable created converts input names to uppercase letters and replaces spaces with `_` characters.
 
 For example, if a workflow defined the numOctocats and octocatEyeColor inputs, the action code could read the values of the inputs using the `INPUT_NUMOCTOCATS` and `INPUT_OCTOCATEYECOLOR` environment variables.
@@ -243,7 +241,7 @@ For more information, see "[`github context`](/actions/reference/context-and-exp
 
 ##### **`runs.steps.env`**
 
-**Optional**  Sets a `map` of environment variables for only that step. If you want to modify the environment variable stored in the workflow, use `echo "::set-env name={name}::{value}"` in a composite run step.
+**Optional**  Sets a `map` of environment variables for only that step. If you want to modify the environment variable stored in the workflow, use {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}`echo "{name}={value}" >> $GITHUB_ENV`{% else %}`echo "::set-env name={name}::{value}"`{% endif %} in a composite run step.
 
 ##### **`runs.steps.working-directory`**
 
@@ -506,7 +504,7 @@ The name of the [Feather](https://feathericons.com/) icon to use.
 
 
 facebook
-простое перемещение вперед
+быстрое перемещение вперед
 feather
 file-minus
 
diff --git a/translations/ru-RU/content/actions/guides/about-continuous-integration.md b/translations/ru-RU/content/actions/guides/about-continuous-integration.md
new file mode 100644
index 000000000000..55a950c59553
--- /dev/null
+++ b/translations/ru-RU/content/actions/guides/about-continuous-integration.md
@@ -0,0 +1,63 @@
+---
+title: About continuous integration
+intro: 'You can create custom continuous integration (CI) and continuous deployment (CD) workflows directly in your {% data variables.product.prodname_dotcom %} repository with {% data variables.product.prodname_actions %}.'
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /articles/about-continuous-integration
+  - /github/automating-your-workflow-with-github-actions/about-continuous-integration
+  - /actions/automating-your-workflow-with-github-actions/about-continuous-integration
+  - /actions/building-and-testing-code-with-continuous-integration/about-continuous-integration
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### About continuous integration
+
+Continuous integration (CI) is a software practice that requires frequently committing code to a shared repository. Committing code more often detects errors sooner and reduces the amount of code a developer needs to debug when finding the source of an error. Frequent code updates also make it easier to merge changes from different members of a software development team. This is great for developers, who can spend more time writing code and less time debugging errors or resolving merge conflicts.
+
+When you commit code to your repository, you can continuously build and test the code to make sure that the commit doesn't introduce errors. Your tests can include code linters (which check style formatting), security checks, code coverage, functional tests, and other custom checks.
+
+Building and testing your code requires a server. You can build and test updates locally before pushing code to a repository, or you can use a CI server that checks for new code commits in a repository.
+
+### About continuous integration using {% data variables.product.prodname_actions %}
+
+CI using {% data variables.product.prodname_actions %} offers workflows that can build the code in your repository and run your tests. Workflows can run on {% data variables.product.prodname_dotcom %}-hosted virtual machines, or on machines that you host yourself. For more information, see "[Virtual environments for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)," and "[About self-hosted runners](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)."
+
+You can configure your CI workflow to run when a {% data variables.product.product_name %} event occurs (for example, when new code is pushed to your repository), on a set schedule, or when an external event occurs using the repository dispatch webhook.
+
+{% data variables.product.product_name %} runs your CI tests and provides the results of each test in the pull request, so you can see whether the change in your branch introduces an error. When all CI tests in a workflow pass, the changes you pushed are ready to be reviewed by a team member or merged. When a test fails, one of your changes may have caused the failure.
+
+When you set up CI in your repository, {% data variables.product.product_name %} analyzes the code in your repository and recommends CI workflows based on the language and framework in your repository. For example, if you use [Node.js](https://nodejs.org/en/), {% data variables.product.product_name %} will suggest a template file that installs your Node.js packages and runs your tests. You can use the CI workflow template suggested by {% data variables.product.product_name %}, customize the suggested template, or create your own custom workflow file to run your CI tests.
+
+![Screenshot of suggested continuous integration templates](/assets/images/help/repository/ci-with-actions-template-picker.png)
+
+In addition to helping you set up CI workflows for your project, you can use {% data variables.product.prodname_actions %} to create workflows across the full software development life cycle. For example, you can use actions to deploy, package, or release your project. For more information, see "[About {% data variables.product.prodname_actions %}](/articles/about-github-actions)."
+
+For a definition of common terms, see "[Core concepts for {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)."
+
+### Supported languages
+
+{% data variables.product.product_name %} offers CI workflow templates for a variety of languages and frameworks.
+
+Browse the complete list of CI workflow templates offered by {% data variables.product.product_name %} in the {% if currentVersion == "free-pro-team@latest" %}[actions/starter-workflows](https://github.com/actions/starter-workflows/tree/main/ci) repository{% else %} `actions/starter-workflows` repository on {% data variables.product.product_location %}{% endif %}.
+
+### Notifications for workflow runs
+
+{% data reusables.repositories.workflow-notifications %}
+
+### Status badges for workflow runs
+
+{% data reusables.repositories.actions-workflow-status-badge-into %}
+
+For more information, see "[Configuring a workflow](/articles/configuring-a-workflow)."
+
+### Дополнительная литература
+
+- "[Setting up continuous integration using {% data variables.product.prodname_actions %}](/articles/setting-up-continuous-integration-using-github-actions)"
+{% if currentVersion == "free-pro-team@latest" %}
+- "[Managing billing for {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)"
+{% endif %}
diff --git a/translations/ru-RU/content/actions/guides/about-packaging-with-github-actions.md b/translations/ru-RU/content/actions/guides/about-packaging-with-github-actions.md
new file mode 100644
index 000000000000..eb7356bed341
--- /dev/null
+++ b/translations/ru-RU/content/actions/guides/about-packaging-with-github-actions.md
@@ -0,0 +1,48 @@
+---
+title: About packaging with GitHub Actions
+intro: 'You can set up workflows in {% data variables.product.prodname_actions %} to produce packages and upload them to {% data variables.product.prodname_registry %} or another package hosting provider.'
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/about-packaging-with-github-actions
+  - /actions/publishing-packages-with-github-actions/about-packaging-with-github-actions
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### About packaging steps
+
+A packaging step is a common part of a continuous integration or continuous delivery workflow. After building and testing your application, a runnable or deployable artifact is produced in the form of a package. For example, a continuous integration workflow for a Java project may run `mvn package` to produce a JAR file. Or, a CI workflow for a Node.js application may create a Docker container.
+
+Depending on the kind of application you're building, this package can be downloaded locally for manual testing, made available for users to download, or deployed to a staging or production environment.
+
+### Packaging in continuous integration workflows
+
+Creating a package at the end of a continuous integration workflow can help during code reviews on a pull request. After building and testing your code, a packaging step can produce a runnable or deployable artifact. Your workflow can then take that artifact and upload it as part of the workflow.
+
+Now, when reviewing a pull request, you'll be able to look at the workflow run and download the artifact that was produced.
+
+![Download artifact drop-down menu](/assets/images/help/repository/artifact-drop-down.png)
+
+This will let you run the code in the pull request on your machine, which can help with debugging or testing the pull request.
+
+### Workflows for publishing packages
+
+In addition to uploading packaging artifacts for testing in a continuous integration workflow, you can create workflows that build your project and publish packages to a package registry.
+
+* **Publish packages to {% data variables.product.prodname_registry %}**
+  {% data variables.product.prodname_registry %} can act as a package hosting service for many types of packages. You can choose to share your packages with all of {% data variables.product.prodname_dotcom %}, or private packages to share with collaborators or an organization. For more information, see "[About {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/about-github-packages)."
+
+  You may want to publish packages to {% data variables.product.prodname_registry %} on every push into the default branch. This will allow developers on your project to always be able to run and test the latest build out of master easily, by installing it from {% data variables.product.prodname_registry %}.
+
+* **Publish packages to a package registry**  
+  For many projects, publishing to a package registry is performed whenever a new version of a project is released. For example, a project that produces a JAR file may upload new releases to the Maven Central repository. Or, a .NET project may produce a nuget package and upload it to the NuGet Gallery.
+
+  You can automate this by creating a workflow that publishes packages to a package registry on every release creation. For more information, see "[Creating releases](/github/administering-a-repository/creating-releases)."
+
+### Дополнительная литература
+
+- "[Publishing Node.js packages](/actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages)"
diff --git a/translations/ru-RU/content/actions/guides/about-service-containers.md b/translations/ru-RU/content/actions/guides/about-service-containers.md
new file mode 100644
index 000000000000..39724306f07e
--- /dev/null
+++ b/translations/ru-RU/content/actions/guides/about-service-containers.md
@@ -0,0 +1,117 @@
+---
+title: About service containers
+intro: 'You can use service containers to connect databases, web services, memory caches, and other tools to your workflow.'
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/about-service-containers
+  - /actions/configuring-and-managing-workflows/about-service-containers
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### About service containers
+
+Service containers are Docker containers that provide a simple and portable way for you to host services that you might need to test or operate your application in a workflow. For example, your workflow might need to run integration tests that require access to a database and memory cache.
+
+You can configure service containers for each job in a workflow. {% data variables.product.prodname_dotcom %} creates a fresh Docker container for each service configured in the workflow, and destroys the service container when the job completes. Steps in a job can communicate with all service containers that are part of the same job.
+
+{% data reusables.github-actions.docker-container-os-support %}
+
+### Communicating with service containers
+
+You can configure jobs in a workflow to run directly on a runner machine or in a Docker container. Communication between a job and its service containers is different depending on whether a job runs directly on the runner machine or in a container.
+
+#### Running jobs in a container
+
+When you run jobs in a container, {% data variables.product.prodname_dotcom %} connects service containers to the job using Docker's user-defined bridge networks. For more information, see "[Use bridge networks](https://docs.docker.com/network/bridge/)" in the Docker documentation.
+
+Running the job and services in a container simplifies network access. You can access a service container using the label you configure in the workflow. The hostname of the service container is automatically mapped to the label name. For example, if you create a service container with the label `redis`, the hostname of the service container is `redis`.
+
+You don't need to configure any ports for service containers. By default, all containers that are part of the same Docker network expose all ports to each other, and no ports are exposed outside of the Docker network.
+
+#### Running jobs on the runner machine
+
+When running jobs directly on the runner machine, you can access service containers using `localhost:` or `127.0.0.1:`. {% data variables.product.prodname_dotcom %} configures the container network to enable communication from the service container to the Docker host.
+
+When a job runs directly on a runner machine, the service running in the Docker container does not expose its ports to the job on the runner by default. You need to map ports on the service container to the Docker host. For more information, see "[Mapping Docker host and service container ports](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)."
+
+### Creating service containers
+
+You can use the `services` keyword to create service containers that are part of a job in your workflow. For more information, see [`jobs..services`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idservices).
+
+This example creates a service called `redis` in a job called `container-job`. The Docker host in this example is the `node:10.18-jessie` container.
+
+{% raw %}
+```yaml
+name: Redis container example
+on: push
+
+jobs:
+  # Label of the container job
+  container-job:
+    # Containers must run in Linux based operating systems
+    runs-on: ubuntu-latest
+    # Docker Hub image that `container-job` executes in
+    container: node:10.18-jessie
+
+    # Service containers to run with `container-job`
+    services:
+      # Label used to access the service container
+      redis:
+        # Docker Hub image
+        image: redis
+```
+{% endraw %}
+
+### Mapping Docker host and service container ports
+
+If your job runs in a Docker container, you do not need to map ports on the host or the service container. If your job runs directly on the runner machine, you'll need to map any required service container ports to ports on the host runner machine.
+
+You can map service containers ports to the Docker host using the `ports` keyword. For more information, see [`jobs..services`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idservices).
+
+| Value of `ports` | Description                                                                          |
+| ---------------- | ------------------------------------------------------------------------------------ |
+| `8080:80`        | Maps TCP port 80 in the container to port 8080 on the Docker host.                   |
+| `8080:80/udp`    | Maps UDP port 80 in the container to port 8080 on the Docker host.                   |
+| `8080/udp`       | Map a randomly chosen UDP port in the container to UDP port 8080 on the Docker host. |
+
+When you map ports using the `ports` keyword, {% data variables.product.prodname_dotcom %} uses the `--publish` command to publish the container’s ports to the Docker host. For more information, see "[Docker container networking](https://docs.docker.com/config/containers/container-networking/)" in the Docker documentation.
+
+When you specify the Docker host port but not the container port, the container port is randomly assigned to a free port. {% data variables.product.prodname_dotcom %} sets the assigned container port in the service container context. For example, for a `redis` service container, if you configured the Docker host port 5432, you can access the corresponding container port using the `job.services.redis.ports[5432]` context. For more information, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions#job-context)."
+
+#### Example mapping Redis ports
+
+This example maps the service container `redis` port 6379 to the Docker host port 6379.
+
+{% raw %}
+```yaml
+name: Redis Service Example
+on: push
+
+jobs:
+  # Label of the container job
+  runner-job:
+    # You must use a Linux environment when using service containers or container jobs
+    runs-on: ubuntu-latest
+
+    # Service containers to run with `runner-job`
+    services:
+      # Label used to access the service container
+      redis:
+        # Docker Hub image
+        image: redis
+        #
+        ports:
+          # Opens tcp port 6379 on the host and service container
+          - 6379:6379
+```
+{% endraw %}
+
+### Дополнительная литература
+
+- "[Creating Redis service containers](/actions/automating-your-workflow-with-github-actions/creating-redis-service-containers)"
+- "[Creating PostgreSQL service containers](/actions/automating-your-workflow-with-github-actions/creating-postgresql-service-containers)"
diff --git a/translations/ru-RU/content/actions/guides/building-and-testing-java-with-ant.md b/translations/ru-RU/content/actions/guides/building-and-testing-java-with-ant.md
new file mode 100644
index 000000000000..b083489f2369
--- /dev/null
+++ b/translations/ru-RU/content/actions/guides/building-and-testing-java-with-ant.md
@@ -0,0 +1,109 @@
+---
+title: Building and testing Java with Ant
+intro: You can create a continuous integration (CI) workflow in GitHub Actions to build and test your Java project with Ant.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/building-and-testing-java-with-ant
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introduction
+
+This guide shows you how to create a workflow that performs continuous integration (CI) for your Java project using the Ant build system. The workflow you create will allow you to see when commits to a pull request cause build or test failures against your default branch; this approach can help ensure that your code is always healthy. You can extend your CI workflow to upload artifacts from a workflow run.
+
+{% data variables.product.prodname_dotcom %}-hosted runners have a tools cache with pre-installed software, which includes Java Development Kits (JDKs) and Ant. For a list of software and the pre-installed versions for JDK and Ant, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)".
+
+### Требования
+
+You should be familiar with YAML and the syntax for {% data variables.product.prodname_actions %}. Дополнительные сведения см. в:
+- "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)"
+- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)"
+
+We recommend that you have a basic understanding of Java and the Ant framework. For more information, see the [Apache Ant Manual](https://ant.apache.org/manual/).
+
+{% data reusables.actions.enterprise-setup-prereq %}
+
+### Starting with an Ant workflow template
+
+{% data variables.product.prodname_dotcom %} provides an Ant workflow template that will work for most Ant-based Java projects. For more information, see the [Ant workflow template](https://github.com/actions/starter-workflows/blob/main/ci/ant.yml).
+
+To get started quickly, you can choose the preconfigured Ant template when you create a new workflow. For more information, see the "[{% data variables.product.prodname_actions %} quickstart](/actions/quickstart)."
+
+You can also add this workflow manually by creating a new file in the `.github/workflows` directory of your repository.
+
+{% raw %}
+```yaml
+name: Java CI
+
+on: [push]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up JDK 1.8
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Build with Ant
+        run: ant -noinput -buildfile build.xml
+```
+{% endraw %}
+
+This workflow performs the following steps:
+
+1. The `checkout` step downloads a copy of your repository on the runner.
+2. The `setup-java` step configures the Java 1.8 JDK.
+3. The "Build with Ant" step runs the default target in your `build.xml` in non-interactive mode.
+
+The default workflow templates are excellent starting points when creating your build and test workflow, and you can customize the template to suit your project’s needs.
+
+{% data reusables.github-actions.example-github-runner %}
+
+{% data reusables.github-actions.java-jvm-architecture %}
+
+### Building and testing your code
+
+You can use the same commands that you use locally to build and test your code.
+
+The starter workflow will run the default target specified in your _build.xml_ file.  Your default target will commonly be set to build classes, run tests and package classes into their distributable format, for example, a JAR file.
+
+If you use different commands to build your project, or you want to run a different target, you can specify those. For example, you may want to run the `jar` target that's configured in your _build-ci.xml_ file.
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+    with:
+      java-version: 1.8
+  - name: Run the Ant jar target
+    run: ant -noinput -buildfile build-ci.xml jar
+```
+{% endraw %}
+
+### Packaging workflow data as artifacts
+
+After your build has succeeded and your tests have passed, you may want to upload the resulting Java packages as a build artifact. This will store the built packages as part of the workflow run, and allow you to download them. Artifacts can help you test and debug pull requests in your local environment before they're merged. For more information, see "[Persisting workflow data using artifacts](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)."
+
+Ant will usually create output files like JARs, EARs, or WARs in the `build/jar` directory. You can upload the contents of that directory using the `upload-artifact` action.
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+  - run: ant -noinput -buildfile build.xml
+  - uses: actions/upload-artifact@v2
+    with:
+      name: Package
+      path: build/jar
+```
+{% endraw %}
diff --git a/translations/ru-RU/content/actions/guides/building-and-testing-java-with-gradle.md b/translations/ru-RU/content/actions/guides/building-and-testing-java-with-gradle.md
new file mode 100644
index 000000000000..9b8a1a5e5491
--- /dev/null
+++ b/translations/ru-RU/content/actions/guides/building-and-testing-java-with-gradle.md
@@ -0,0 +1,134 @@
+---
+title: Building and testing Java with Gradle
+intro: You can create a continuous integration (CI) workflow in GitHub Actions to build and test your Java project with Gradle.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/building-and-testing-java-with-gradle
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introduction
+
+This guide shows you how to create a workflow that performs continuous integration (CI) for your Java project using the Gradle build system. The workflow you create will allow you to see when commits to a pull request cause build or test failures against your default branch; this approach can help ensure that your code is always healthy. You can extend your CI workflow to cache files and upload artifacts from a workflow run.
+
+{% data variables.product.prodname_dotcom %}-hosted runners have a tools cache with pre-installed software, which includes Java Development Kits (JDKs) and Gradle. For a list of software and the pre-installed versions for JDK and Gradle, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)".
+
+### Требования
+
+You should be familiar with YAML and the syntax for {% data variables.product.prodname_actions %}. Дополнительные сведения см. в:
+- "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)"
+- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)"
+
+We recommend that you have a basic understanding of Java and the Gradle framework. For more information, see [Getting Started](https://docs.gradle.org/current/userguide/getting_started.html) in the Gradle documentation.
+
+{% data reusables.actions.enterprise-setup-prereq %}
+
+### Starting with a Gradle workflow template
+
+{% data variables.product.prodname_dotcom %} provides a Gradle workflow template that will work for most Gradle-based Java projects. For more information, see the [Gradle workflow template](https://github.com/actions/starter-workflows/blob/main/ci/gradle.yml).
+
+To get started quickly, you can choose the preconfigured Gradle template when you create a new workflow. For more information, see the "[{% data variables.product.prodname_actions %} quickstart](/actions/quickstart)."
+
+You can also add this workflow manually by creating a new file in the `.github/workflows` directory of your repository.
+
+{% raw %}
+```yaml
+name: Java CI
+
+on: [push]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up JDK 1.8
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Build with Gradle
+        run: ./gradlew build
+```
+{% endraw %}
+
+This workflow performs the following steps:
+
+1. The `checkout` step downloads a copy of your repository on the runner.
+2. The `setup-java` step configures the Java 1.8 JDK.
+3. The "Build with Gradle" step runs the `gradlew` wrapper script to ensure that your code builds, tests pass, and a package can be created.
+
+The default workflow templates are excellent starting points when creating your build and test workflow, and you can customize the template to suit your project’s needs.
+
+{% data reusables.github-actions.example-github-runner %}
+
+{% data reusables.github-actions.java-jvm-architecture %}
+
+### Building and testing your code
+
+You can use the same commands that you use locally to build and test your code.
+
+The starter workflow will run the `build` task by default. In the default Gradle configuration, this command will download dependencies, build classes, run tests, and package classes into their distributable format, for example, a JAR file.
+
+If you use different commands to build your project, or you want to use a different task, you can specify those. For example, you may want to run the `package` task that's configured in your _ci.gradle_ file.
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+    with:
+      java-version: 1.8
+  - name: Run the Gradle package task
+    run: ./gradlew -b ci.gradle package
+```
+{% endraw %}
+
+### Caching dependencies
+
+You can cache your dependencies to speed up your workflow runs. After a successful run, your local Gradle package cache will be stored on GitHub Actions infrastructure. In future workflow runs, the cache will be restored so that dependencies don't need to be downloaded from remote package repositories. For more information, see "[Caching dependencies to speed up workflows](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)" and the [`cache` action](https://github.com/marketplace/actions/cache).
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - name: Set up JDK 1.8
+    uses: actions/setup-java@v1
+    with:
+      java-version: 1.8
+  - name: Cache Gradle packages
+    uses: actions/cache@v2
+    with:
+      path: ~/.gradle/caches
+      key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle') }}
+      restore-keys: ${{ runner.os }}-gradle
+  - name: Build with Gradle
+    run: ./gradlew build
+```
+{% endraw %}
+
+This workflow will save the contents of your local Gradle package cache, located in the `.gradle/caches` directory of the runner's home directory. The cache key will be the hashed contents of the gradle build files, so changes to them will invalidate the cache.
+
+### Packaging workflow data as artifacts
+
+After your build has succeeded and your tests have passed, you may want to upload the resulting Java packages as a build artifact. This will store the built packages as part of the workflow run, and allow you to download them. Artifacts can help you test and debug pull requests in your local environment before they're merged. For more information, see "[Persisting workflow data using artifacts](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)."
+
+Gradle will usually create output files like JARs, EARs, or WARs in the `build/libs` directory. You can upload the contents of that directory using the `upload-artifact` action.
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+  - run: ./gradlew build
+  - uses: actions/upload-artifact@v2
+    with:
+      name: Package
+      path: build/libs
+```
+{% endraw %}
diff --git a/translations/ru-RU/content/actions/guides/building-and-testing-java-with-maven.md b/translations/ru-RU/content/actions/guides/building-and-testing-java-with-maven.md
new file mode 100644
index 000000000000..5827501db7f1
--- /dev/null
+++ b/translations/ru-RU/content/actions/guides/building-and-testing-java-with-maven.md
@@ -0,0 +1,135 @@
+---
+title: Building and testing Java with Maven
+intro: You can create a continuous integration (CI) workflow in GitHub Actions to build and test your Java project with Maven.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/building-and-testing-java-with-maven
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introduction
+
+This guide shows you how to create a workflow that performs continuous integration (CI) for your Java project using the Maven software project management tool. The workflow you create will allow you to see when commits to a pull request cause build or test failures against your default branch; this approach can help ensure that your code is always healthy. You can extend your CI workflow to cache files and upload artifacts from a workflow run.
+
+{% data variables.product.prodname_dotcom %}-hosted runners have a tools cache with pre-installed software, which includes Java Development Kits (JDKs) and Maven. For a list of software and the pre-installed versions for JDK and Maven, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)".
+
+### Требования
+
+You should be familiar with YAML and the syntax for {% data variables.product.prodname_actions %}. Дополнительные сведения см. в:
+- "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)"
+- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)"
+
+We recommend that you have a basic understanding of Java and the Maven framework. For more information, see the [Maven Getting Started Guide](http://maven.apache.org/guides/getting-started/index.html) in the Maven documentation.
+
+{% data reusables.actions.enterprise-setup-prereq %}
+
+### Starting with a Maven workflow template
+
+{% data variables.product.prodname_dotcom %} provides a Maven workflow template that will work for most Maven-based Java projects. For more information, see the [Maven workflow template](https://github.com/actions/starter-workflows/blob/main/ci/maven.yml).
+
+To get started quickly, you can choose the preconfigured Maven template when you create a new workflow. For more information, see the "[{% data variables.product.prodname_actions %} quickstart](/actions/quickstart)."
+
+You can also add this workflow manually by creating a new file in the `.github/workflows` directory of your repository.
+
+{% raw %}
+```yaml
+name: Java CI
+
+on: [push]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up JDK 1.8
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Build with Maven
+        run: mvn -B package --file pom.xml
+```
+{% endraw %}
+
+This workflow performs the following steps:
+
+1. The `checkout` step downloads a copy of your repository on the runner.
+2. The `setup-java` step configures the Java 1.8 JDK.
+3. The "Build with Maven" step runs the Maven `package` target in non-interactive mode to ensure that your code builds, tests pass, and a package can be created.
+
+The default workflow templates are excellent starting points when creating your build and test workflow, and you can customize the template to suit your project’s needs.
+
+{% data reusables.github-actions.example-github-runner %}
+
+{% data reusables.github-actions.java-jvm-architecture %}
+
+### Building and testing your code
+
+You can use the same commands that you use locally to build and test your code.
+
+The starter workflow will run the `package` target by default. In the default Maven configuration, this command will download dependencies, build classes, run tests, and package classes into their distributable format, for example, a JAR file.
+
+If you use different commands to build your project, or you want to use a different target, you can specify those. For example, you may want to run the `verify` target that's configured in a _pom-ci.xml_ file.
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+    with:
+      java-version: 1.8
+  - name: Run the Maven verify phase
+    run: mvn -B verify --file pom-ci.xml
+```
+{% endraw %}
+
+### Caching dependencies
+
+You can cache your dependencies to speed up your workflow runs. After a successful run, your local Maven repository will be stored on GitHub Actions infrastructure. In future workflow runs, the cache will be restored so that dependencies don't need to be downloaded from remote Maven repositories. For more information, see "[Caching dependencies to speed up workflows](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)" and the [`cache` action](https://github.com/marketplace/actions/cache).
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - name: Set up JDK 1.8
+    uses: actions/setup-java@v1
+    with:
+      java-version: 1.8
+  - name: Cache Maven packages
+    uses: actions/cache@v2
+    with:
+      path: ~/.m2
+      key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }}
+      restore-keys: ${{ runner.os }}-m2
+  - name: Build with Maven
+    run: mvn -B package --file pom.xml
+```
+{% endraw %}
+
+This workflow will save the contents of your local Maven repository, located in the `.m2` directory of the runner's home directory. The cache key will be the hashed contents of _pom.xml_, so changes to _pom.xml_ will invalidate the cache.
+
+### Packaging workflow data as artifacts
+
+After your build has succeeded and your tests have passed, you may want to upload the resulting Java packages as a build artifact. This will store the built packages as part of the workflow run, and allow you to download them. Artifacts can help you test and debug pull requests in your local environment before they're merged. For more information, see "[Persisting workflow data using artifacts](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)."
+
+Maven will usually create output files like JARs, EARs, or WARs in the `target` directory. To upload those as artifacts, you can copy them into a new directory that contains artifacts to upload. For example, you can create a directory called `staging`. Then you can upload the contents of that directory using the `upload-artifact` action.
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+  - run: mvn -B package --file pom.xml
+  - run: mkdir staging && cp target/*.jar staging
+  - uses: actions/upload-artifact@v2
+    with:
+      name: Package
+      path: staging
+```
+{% endraw %}
diff --git a/translations/ru-RU/content/actions/guides/building-and-testing-nodejs.md b/translations/ru-RU/content/actions/guides/building-and-testing-nodejs.md
new file mode 100644
index 000000000000..d57c344490a8
--- /dev/null
+++ b/translations/ru-RU/content/actions/guides/building-and-testing-nodejs.md
@@ -0,0 +1,276 @@
+---
+title: Building and testing Node.js
+intro: You can create a continuous integration (CI) workflow to build and test your Node.js project.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions
+  - /actions/language-and-framework-guides/using-nodejs-with-github-actions
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introduction
+
+This guide shows you how to create a continuous integration (CI) workflow that builds and tests Node.js code. If your CI tests pass, you may want to deploy your code or publish a package.
+
+### Требования
+
+We recommend that you have a basic understanding of Node.js, YAML, workflow configuration options, and how to create a workflow file. Дополнительные сведения см. в:
+
+- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)"
+- "[Getting started with Node.js](https://nodejs.org/en/docs/guides/getting-started-guide/)"
+
+{% data reusables.actions.enterprise-setup-prereq %}
+
+### Starting with the Node.js workflow template
+
+{% data variables.product.prodname_dotcom %} provides a Node.js workflow template that will work for most Node.js projects. This guide includes npm and Yarn examples that you can use to customize the template. For more information, see the [Node.js workflow template](https://github.com/actions/starter-workflows/blob/main/ci/node.js.yml).
+
+To get started quickly, add the template to the `.github/workflows` directory of your repository.
+
+{% raw %}
+```yaml
+name: Node.js CI
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [8.x, 10.x, 12.x]
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v1
+      with:
+        node-version: ${{ matrix.node-version }}
+    - run: npm install
+    - run: npm run build --if-present
+    - run: npm test
+      env:
+        CI: true
+```
+{% endraw %}
+
+{% data reusables.github-actions.example-github-runner %}
+
+### Specifying the Node.js version
+
+The easiest way to specify a Node.js version is by using the `setup-node` action provided by {% data variables.product.prodname_dotcom %}. For more information see, [`setup-node`](https://github.com/actions/setup-node/).
+
+The `setup-node` action takes a Node.js version as an input and configures that version on the runner. The `setup-node` action finds a specific version of Node.js from the tools cache on each runner and adds the necessary binaries to `PATH`, which persists for the rest of the job. Using the `setup-node` action is the recommended way of using Node.js with {% data variables.product.prodname_actions %} because it ensures consistent behavior across different runners and different versions of Node.js. If you are using a self-hosted runner, you must install Node.js and add it to `PATH`.
+
+The template includes a matrix strategy that builds and tests your code with three Node.js versions: 8.x, 10.x, and 12.x. The 'x' is a wildcard character that matches the latest minor and patch release available for a version. Each version of Node.js specified in the `node-version` array creates a job that runs the same steps.
+
+Each job can access the value defined in the matrix `node-version` array using the `matrix` context. The `setup-node` action uses the context as the `node-version` input. The `setup-node` action configures each job with a different Node.js version before building and testing code. For more information about matrix strategies and contexts, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix)" and "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)."
+
+{% raw %}
+```yaml
+strategy:
+  matrix:
+    node-version: [8.x, 10.x, 12.x]
+
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js ${{ matrix.node-version }}
+  uses: actions/setup-node@v1
+  with:
+    node-version: ${{ matrix.node-version }}
+```
+{% endraw %}
+
+Alternatively, you can build and test with exact Node.js versions.
+
+```yaml
+strategy:
+  matrix:
+    node-version: [8.16.2, 10.17.0]
+```
+
+Or, you can build and test using a single version of Node.js too.
+
+{% raw %}
+```yaml
+name: Node.js CI
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Use Node.js
+      uses: actions/setup-node@v1
+      with:
+        node-version: '12.x'
+    - run: npm install
+    - run: npm run build --if-present
+    - run: npm test
+      env:
+        CI: true
+```
+{% endraw %}
+
+If you don't specify a Node.js version, {% data variables.product.prodname_dotcom %} uses the environment's default Node.js version. For more information, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)".
+
+### Installing dependencies
+
+{% data variables.product.prodname_dotcom %}-hosted runners have npm and Yarn dependency managers installed. You can use npm and Yarn to install dependencies in your workflow before building and testing your code. The Windows and Linux {% data variables.product.prodname_dotcom %}-hosted runners also have Grunt, Gulp, and Bower installed.
+
+You can also cache dependencies to speed up your workflow. For more information, see "[Caching dependencies to speed up your workflow](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)."
+
+#### Example using npm
+
+This example installs the dependencies defined in the *package.json* file. For more information, see [`npm install`](https://docs.npmjs.com/cli/install).
+
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    node-version: '12.x'
+- name: Install dependencies
+  run: npm install
+```
+
+Using `npm ci` installs the versions in the *package-lock.json* or *npm-shrinkwrap.json* file and prevents updates to the lock file. Using `npm ci` is generally faster than running `npm install`. For more information, see [`npm ci`](https://docs.npmjs.com/cli/ci.html) and "[Introducing `npm ci` for faster, more reliable builds](https://blog.npmjs.org/post/171556855892/introducing-npm-ci-for-faster-more-reliable)."
+
+{% raw %}
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    node-version: '12.x'
+- name: Install dependencies
+  run: npm ci
+```
+{% endraw %}
+
+#### Example using Yarn
+
+This example installs the dependencies defined in the *package.json* file. For more information, see [`yarn install`](https://yarnpkg.com/en/docs/cli/install).
+
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    node-version: '12.x'
+- name: Install dependencies
+  run: yarn
+```
+
+Alternatively, you can pass `--frozen-lockfile` to install the versions in the *yarn.lock* file and prevent updates to the *yarn.lock* file.
+
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    node-version: '12.x'
+- name: Install dependencies
+  run: yarn --frozen-lockfile
+```
+
+#### Example using a private registry and creating the .npmrc file
+
+{% data reusables.github-actions.setup-node-intro %}
+
+To authenticate to your private registry, you'll need to store your npm authentication token as a secret in your repository settings. For example, create a secret called `NPM_TOKEN`. For more information, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
+
+In the example below, the secret `NPM_TOKEN` stores the npm authentication token. The `setup-node` action configures the *.npmrc* file to read the npm authentication token from the `NODE_AUTH_TOKEN` environment variable. When using the `setup-node` action to create an *.npmrc* file, you must set the `NPM_AUTH_TOKEN` environment variable with the secret that contains your npm authentication token.
+
+Before installing dependencies, use the `setup-node` action to create the *.npmrc* file. The action has two input parameters. The `node-version` parameter sets the Node.js version, and the `registry-url` parameter sets the default registry. If your package registry uses scopes, you must use the `scope` parameter. For more information, see [`npm-scope`](https://docs.npmjs.com/misc/scope).
+
+{% raw %}
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    always-auth: true
+    node-version: '12.x'
+    registry-url: https://registry.npmjs.org
+    scope: '@octocat'
+- name: Install dependencies
+  run: npm ci
+  env:
+    NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}}
+```
+{% endraw %}
+
+The example above creates an *.npmrc* file with the following contents:
+
+```
+//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN}
+@octocat:registry=https://registry.npmjs.org/
+always-auth=true
+```
+
+#### Example caching dependencies
+
+You can cache dependencies using a unique key, and restore the dependencies when you run future workflows using the `cache` action. For more information, see "[Caching dependencies to speed up workflows](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)" and the [`cache` action](https://github.com/marketplace/actions/cache).
+
+{% raw %}
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    node-version: '12.x'
+- name: Cache Node.js modules
+  uses: actions/cache@v2
+  with:
+    # npm cache files are stored in `~/.npm` on Linux/macOS
+    path: ~/.npm 
+    key: ${{ runner.OS }}-node-${{ hashFiles('**/package-lock.json') }}
+    restore-keys: |
+      ${{ runner.OS }}-node-
+      ${{ runner.OS }}-
+- name: Install dependencies
+  run: npm ci
+```
+{% endraw %}
+
+### Building and testing your code
+
+You can use the same commands that you use locally to build and test your code. For example, if you run `npm run build` to run build steps defined in your *package.json* file and `npm test` to run your test suite, you would add those commands in your workflow file.
+
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    node-version: '12.x'
+- run: npm install
+- run: npm run build --if-present
+- run: npm test
+```
+
+### Packaging workflow data as artifacts
+
+You can save artifacts from your build and test steps to view after a job completes. For example, you may need to save log files, core dumps, test results, or screenshots. For more information, see "[Persisting workflow data using artifacts](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)."
+
+### Publishing to package registries
+
+You can configure your workflow to publish your Node.js package to a package registry after your CI tests pass. For more information about publishing to npm and {% data variables.product.prodname_registry %}, see "[Publishing Node.js packages](/actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages)."
diff --git a/translations/ru-RU/content/actions/guides/building-and-testing-python.md b/translations/ru-RU/content/actions/guides/building-and-testing-python.md
new file mode 100644
index 000000000000..0eaff789266f
--- /dev/null
+++ b/translations/ru-RU/content/actions/guides/building-and-testing-python.md
@@ -0,0 +1,427 @@
+---
+title: Building and testing Python
+intro: You can create a continuous integration (CI) workflow to build and test your Python project.
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/using-python-with-github-actions
+  - /actions/language-and-framework-guides/using-python-with-github-actions
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introduction
+
+This guide shows you how to build, test, and publish a Python package.
+
+{% data variables.product.prodname_dotcom %}-hosted runners have a tools cache with pre-installed software, which includes Python and PyPy. You don't have to install anything! For a full list of up-to-date software and the pre-installed versions of Python and PyPy, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)".
+
+### Требования
+
+You should be familiar with YAML and the syntax for {% data variables.product.prodname_actions %}. For more information, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)."
+
+We recommend that you have a basic understanding of Python, PyPy, and pip. Дополнительные сведения см. в:
+- [Getting started with Python](https://www.python.org/about/gettingstarted/)
+- [PyPy](https://pypy.org/)
+- [Pip package manager](https://pypi.org/project/pip/)
+
+{% data reusables.actions.enterprise-setup-prereq %}
+
+### Starting with the Python workflow template
+
+{% data variables.product.prodname_dotcom %} provides a Python workflow template that should work for most Python projects. This guide includes examples that you can use to customize the template. For more information, see the [Python workflow template](https://github.com/actions/starter-workflows/blob/main/ci/python-package.yml).
+
+To get started quickly, add the template to the `.github/workflows` directory of your repository.
+
+{% raw %}
+```yaml
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: [2.7, 3.5, 3.6, 3.7, 3.8]
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v2
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install flake8 pytest
+        if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
+    - name: Lint with flake8
+      run: |
+        # stop the build if there are Python syntax errors or undefined names
+        flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+        # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide
+        flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+    - name: Test with pytest
+      run: |
+        pytest
+```
+{% endraw %}
+
+### Specifying a Python version
+
+To use a pre-installed version of Python or PyPy on a {% data variables.product.prodname_dotcom %}-hosted runner, use the `setup-python` action. This action finds a specific version of Python or PyPy from the tools cache on each runner and adds the necessary binaries to `PATH`, which persists for the rest of the job. If a specific version of Python is not pre-installed in the tools cache, the `setup-python` action will download and set up the appropriate version from the [`python-versions`](https://github.com/actions/python-versions) repository.
+
+Using the `setup-python` action is the recommended way of using Python with {% data variables.product.prodname_actions %} because it ensures consistent behavior across different runners and different versions of Python. If you are using a self-hosted runner, you must install Python and add it to `PATH`. For more information, see the [`setup-python` action](https://github.com/marketplace/actions/setup-python).
+
+The table below describes the locations for the tools cache in each {% data variables.product.prodname_dotcom %}-hosted runner.
+
+|                          | Ubuntu                          | Mac                                      | Windows                                    |
+| ------------------------ | ------------------------------- | ---------------------------------------- | ------------------------------------------ |
+| **Tool Cache Directory** | `/opt/hostedtoolcache/*`        | `/Users/runner/hostedtoolcache/*`        | `C:\hostedtoolcache\windows\*`         |
+| **Python Tool Cache**    | `/opt/hostedtoolcache/Python/*` | `/Users/runner/hostedtoolcache/Python/*` | `C:\hostedtoolcache\windows\Python\*` |
+| **PyPy Tool Cache**      | `/opt/hostedtoolcache/PyPy/*`   | `/Users/runner/hostedtoolcache/PyPy/*`   | `C:\hostedtoolcache\windows\PyPy\*`   |
+
+If you are using a self-hosted runner, you can configure the runner to use the `setup-python` action to manage your dependencies. For more information, see [using setup-python with a self-hosted runner](https://github.com/actions/setup-python#using-setup-python-with-a-self-hosted-runner) in the `setup-python` README.
+
+{% data variables.product.prodname_dotcom %} supports semantic versioning syntax. For more information, see "[Using semantic versioning](https://docs.npmjs.com/about-semantic-versioning#using-semantic-versioning-to-specify-update-types-your-package-can-accept)" and the "[Semantic versioning specification](https://semver.org/)."
+
+#### Using multiple Python versions
+
+{% raw %}
+```yaml
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      # You can use PyPy versions in python-version.
+      # For example, pypy2 and pypy3
+      matrix:
+        python-version: [2.7, 3.5, 3.6, 3.7, 3.8]
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v2
+      with:
+        python-version: ${{ matrix.python-version }}
+    # You can test your matrix by printing the current Python version
+    - name: Display Python version
+      run: python -c "import sys; print(sys.version)"
+```
+{% endraw %}
+
+#### Using a specific Python version
+
+You can configure a specific version of python. For example, 3.8. Alternatively, you can semantic version syntax to get the latest minor release. This example uses the latest minor release of Python 3.
+
+{% raw %}
+```yaml
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python 3.x
+      uses: actions/setup-python@v2
+      with:
+        # Semantic version range syntax or exact version of a Python version
+        python-version: '3.x' 
+        # Optional - x64 or x86 architecture, defaults to x64
+        architecture: 'x64' 
+    # You can test your matrix by printing the current Python version
+    - name: Display Python version
+      run: python -c "import sys; print(sys.version)"
+```
+{% endraw %}
+
+#### Excluding a version
+
+If you specify a version of Python that is not available, `setup-python` fails with an error such as: `##[error]Version 3.4 with arch x64 not found`. The error message includes the available versions.
+
+You can also use the `exclude` keyword in your workflow if there is a configuration of Python that you do not wish to run. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategy)."
+
+{% raw %}
+```yaml
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: [2.7, 3.6, 3.7, 3.8, pypy2, pypy3]
+        exclude:
+          - os: macos-latest
+            python-version: 3.6
+          - os: windows-latest
+            python-version: 3.6
+```
+{% endraw %}
+
+#### Using the default Python version
+
+We recommend using `setup-python` to configure the version of Python used in your workflows because it helps make your dependencies explicit. If you don't use `setup-python`, the default version of Python set in `PATH` is used in any shell when you call `python`. The default version of Python varies between {% data variables.product.prodname_dotcom %}-hosted runners, which may cause unexpected changes or use an older version than expected.
+
+| {% data variables.product.prodname_dotcom %}-hosted runner | Description                                                                                                                                                                                                                                                                                                                                                           |
+| ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Ubuntu                                                     | Ubuntu runners have multiple versions of system Python installed under `/usr/bin/python` and `/usr/bin/python3`. The Python versions that come packaged with Ubuntu are in addition to the versions that {% data variables.product.prodname_dotcom %} installs in the tools cache.                                                                                    |
+| Windows                                                    | Excluding the versions of Python that are in the tools cache, Windows does not ship with an equivalent version of system Python. To maintain consistent behavior with other runners and to allow Python to be used out-of-the-box without the `setup-python` action, {% data variables.product.prodname_dotcom %} adds a few versions from the tools cache to `PATH`. |
+| macOS                                                      | The macOS runners have more than one version of system Python installed, in addition to the versions that are part of the tools cache. The system Python versions are located in the `/usr/local/Cellar/python/*` directory.                                                                                                                                          |
+
+### Installing dependencies
+
+{% data variables.product.prodname_dotcom %}-hosted runners have the pip package manager installed. You can use pip to install dependencies from the PyPI package registry before building and testing your code. For example, the YAML below installs or upgrades the `pip` package installer and the `setuptools` and `wheel` packages.
+
+You can also cache dependencies to speed up your workflow. For more information, see "[Caching dependencies to speed up your workflow](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)."
+
+{% raw %}
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Set up Python
+  uses: actions/setup-python@v2
+  with:
+    python-version: '3.x'
+- name: Install dependencies
+  run: python -m pip install --upgrade pip setuptools wheel
+```
+{% endraw %}
+
+#### Requirements file
+
+After you update `pip`, a typical next step is to install dependencies from *requirements.txt*.
+
+{% raw %}
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Set up Python
+  uses: actions/setup-python@v2
+  with:
+    python-version: '3.x'
+- name: Install dependencies
+  run: |
+    python -m pip install --upgrade pip
+    pip install -r requirements.txt
+```
+{% endraw %}
+
+#### Caching Dependencies
+
+You can cache pip dependencies using a unique key, and restore the dependencies when you run future workflows using the [`cache`](https://github.com/marketplace/actions/cache) action. For more information, see "[Caching dependencies to speed up workflows](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)."
+
+Pip caches dependencies in different locations, depending on the operating system of the runner. The path you'll need to cache may differ from the Ubuntu example below depending on the operating system you use. For more information, see [Python caching examples](https://github.com/actions/cache/blob/main/examples.md#python---pip).
+
+{% raw %}
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Setup Python
+  uses: actions/setup-python@v2
+  with:
+    python-version: '3.x'
+- name: Cache pip
+  uses: actions/cache@v2
+  with:
+    # This path is specific to Ubuntu
+    path: ~/.cache/pip
+    # Look to see if there is a cache hit for the corresponding requirements file
+    key: ${{ runner.os }}-pip-${{ hashFiles('requirements.txt') }}
+    restore-keys: |
+      ${{ runner.os }}-pip-
+      ${{ runner.os }}-
+- name: Install dependencies
+  run: pip install -r requirements.txt
+```
+{% endraw %}
+
+{% note %}
+
+**Note:** Depending on the number of dependencies, it may be faster to use the dependency cache. Projects with many large dependencies should see a performance increase as it cuts down the time required for downloading. Projects with fewer dependencies may not see a significant performance increase and may even see a slight decrease due to how pip installs cached dependencies. The performance varies from project to project.
+
+{% endnote %}
+
+### Testing your code
+
+You can use the same commands that you use locally to build and test your code.
+
+#### Testing with pytest and pytest-cov
+
+This example installs or upgrades `pytest` and `pytest-cov`. Tests are then run and output in JUnit format while code coverage results are output in Cobertura. For more information, see [JUnit](https://junit.org/junit5/) and [Cobertura](https://cobertura.github.io/cobertura/).
+
+{% raw %}
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Set up Python
+  uses: actions/setup-python@v2
+  with:
+    python-version: '3.x'
+- name: Install dependencies
+  run: |
+    python -m pip install --upgrade pip
+    pip install -r requirements.txt
+- name: Test with pytest
+  run: |
+    pip install pytest
+    pip install pytest-cov
+    pytest tests.py --doctest-modules --junitxml=junit/test-results.xml --cov=com --cov-report=xml --cov-report=html
+```
+{% endraw %}
+
+#### Using Flake8 to lint code
+
+The following example installs or upgrades `flake8` and uses it to lint all files. For more information, see [Flake8](http://flake8.pycqa.org/en/latest/).
+
+{% raw %}
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Set up Python
+  uses: actions/setup-python@v2
+  with:
+    python-version: '3.x'
+- name: Install dependencies
+  run: |
+    python -m pip install --upgrade pip
+    pip install -r requirements.txt
+- name: Lint with flake8
+  run: |
+    pip install flake8
+    flake8 .
+```
+{% endraw %}
+
+#### Running tests with tox
+
+With {% data variables.product.prodname_actions %}, you can run tests with tox and spread the work across multiple jobs. You'll need to invoke tox using the `-e py` option to choose the version of Python in your `PATH`, rather than specifying a specific version. For more information, see [tox](https://tox.readthedocs.io/en/latest/).
+
+{% raw %}
+```yaml
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python: [2.7, 3.7, 3.8]
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Setup Python
+        uses: actions/setup-python@v2
+        with:
+          python-version: ${{ matrix.python }}
+      - name: Install Tox and any other packages
+        run: pip install tox
+      - name: Run Tox
+        # Run tox using the version of Python in `PATH`
+        run: tox -e py
+```
+{% endraw %}
+
+### Packaging workflow data as artifacts
+
+You can upload artifacts to view after a workflow completes. For example, you may need to save log files, core dumps, test results, or screenshots. For more information, see "[Persisting workflow data using artifacts](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)."
+
+The following example demonstrates how you can use the `upload-artifact` action to archive test results from running `pytest`. For more information, see the [`upload-artifact` action](https://github.com/actions/upload-artifact).
+
+{% raw %}
+```yaml
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: [2.7, 3.5, 3.6, 3.7, 3.8]
+
+      steps:
+      - uses: actions/checkout@v2
+      - name: Setup Python # Set Python version
+        uses: actions/setup-python@v2
+        with:
+          python-version: ${{ matrix.python-version }}
+      # Install pip and pytest
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install pytest
+      - name: Test with pytest
+        run: pytest tests.py --doctest-modules --junitxml=junit/test-results-${{ matrix.python-version }}.xml
+      - name: Upload pytest test results
+        uses: actions/upload-artifact@v2
+        with:
+          name: pytest-results-${{ matrix.python-version }}
+          path: junit/test-results-${{ matrix.python-version }}.xml
+        # Use always() to always run this step to publish test results when there are test failures
+        if: ${{ always() }}
+```
+{% endraw %}
+
+### Publishing to package registries
+
+You can configure your workflow to publish your Python package to any package registry you'd like when your CI tests pass.
+
+You can store any access tokens or credentials needed to publish your package using repository secrets. The following example creates and publishes a package to PyPI using `twine` and `dist`. For more information, see "[Creating and using encrypted secrets](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
+
+{% raw %}
+```yaml
+name: Upload Python Package
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python
+      uses: actions/setup-python@v2
+      with:
+        python-version: '3.x'
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install setuptools wheel twine
+    - name: Build and publish
+      env:
+        TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }}
+        TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
+      run: |
+        python setup.py sdist bdist_wheel
+        twine upload dist/*
+```
+{% endraw %}
+
+For more information about the template workflow, see [`python-publish`](https://github.com/actions/starter-workflows/blob/main/ci/python-publish.yml).
diff --git a/translations/ru-RU/content/actions/guides/caching-dependencies-to-speed-up-workflows.md b/translations/ru-RU/content/actions/guides/caching-dependencies-to-speed-up-workflows.md
new file mode 100644
index 000000000000..497bcad57e58
--- /dev/null
+++ b/translations/ru-RU/content/actions/guides/caching-dependencies-to-speed-up-workflows.md
@@ -0,0 +1,192 @@
+---
+title: Caching dependencies to speed up workflows
+shortTitle: Caching dependencies
+intro: 'To make your workflows faster and more efficient, you can create and use caches for dependencies and other commonly reused files.'
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /github/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows
+  - /actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows
+  - /actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows
+versions:
+  free-pro-team: '*'
+---
+
+### About caching workflow dependencies
+
+Workflow runs often reuse the same outputs or downloaded dependencies from one run to another. For example, package and dependency management tools such as Maven, Gradle, npm, and Yarn keep a local cache of downloaded dependencies.
+
+Jobs on {% data variables.product.prodname_dotcom %}-hosted runners start in a clean virtual environment and must download dependencies each time, causing increased network utilization, longer runtime, and increased cost. To help speed up the time it takes to recreate these files, {% data variables.product.prodname_dotcom %} can cache dependencies you frequently use in workflows.
+
+To cache dependencies for a job, you'll need to use {% data variables.product.prodname_dotcom %}'s `cache` action. The action retrieves a cache identified by a unique key. For more information, see [`actions/cache`](https://github.com/actions/cache).
+
+{% warning %}
+
+**Warning**: We recommend that you don't store any sensitive information in the cache of public repositories. For example, sensitive information can include access tokens or login credentials stored in a file in the cache path. Also, command line interface (CLI) programs like `docker login` can save access credentials in a configuration file. Anyone with read access can create a pull request on a repository and access the contents of the cache. Forks of a repository can also create pull requests on the base branch and access caches on the base branch.
+
+{% endwarning %}
+
+### Comparing artifacts and dependency caching
+
+Artifacts and caching are similar because they provide the ability to store files on {% data variables.product.prodname_dotcom %}, but each feature offers different use cases and cannot be used interchangeably.
+
+- Use caching when you want to reuse files that don't change often between jobs or workflow runs.
+- Use artifacts when you want to save files produced by a job to view after a workflow has ended. For more information, see "[Persisting workflow data using artifacts](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)."
+
+### Restrictions for accessing a cache
+
+With `v2` of the `cache` action, you can access the cache in workflows triggered by any event that has a `GITHUB_REF`. If you are using `v1` of the `cache` action, you can only access the cache in workflows triggered by `push` and `pull_request` events, except for the `pull_request` `closed` event. For more information, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows)."
+
+A workflow can access and restore a cache created in the current branch, the base branch (including base branches of forked repositories), or the default branch (usually `main`). For example, a cache created on the default branch would be accessible from any pull request. Also, if the branch `feature-b` has the base branch `feature-a`, a workflow triggered on `feature-b` would have access to caches created in the default branch (`main`), `feature-a`, and `feature-b`.
+
+Access restrictions provide cache isolation and security by creating a logical boundary between different workflows and branches. For example, a cache created for the branch `feature-a` (with the base `main`) would not be accessible to a pull request for the branch `feature-b` (with the base `main`).
+
+### Using the `cache` action
+
+The `cache` action will attempt to restore a cache based on the `key` you provide. When the action finds a cache, the action restores the cached files to the `path` you configure.
+
+If there is no exact match, the action creates a new cache entry if the job completes successfully. The new cache will use the `key` you provided and contains the files in the `path` directory.
+
+You can optionally provide a list of `restore-keys` to use when the `key` doesn't match an existing cache. A list of `restore-keys` is useful when you are restoring a cache from another branch because `restore-keys` can partially match cache keys. For more information about matching `restore-keys`, see "[Matching a cache key](#matching-a-cache-key)."
+
+For more information, see [`actions/cache`](https://github.com/actions/cache).
+
+#### Input parameters for the `cache` action
+
+- `key`: **Required** The key created when saving a cache and the key used to search for a cache. Can be any combination of variables, context values, static strings, and functions. Keys have a maximum length of 512 characters, and keys longer than the maximum length will cause the action to fail.
+- `path`: **Required** The file path on the runner to cache or restore. The path can be an absolute path or relative to the working directory.
+  - With `v2` of the `cache` action, you can specify a single path, or multiple paths as a list. Paths can be either directories or single files, and glob patterns are supported.
+  - With `v1` of the `cache` action, only a single path is supported and it must be a directory. You cannot cache a single file.
+- `restore-keys`: **Optional** An ordered list of alternative keys to use for finding the cache if no cache hit occurred for `key`.
+
+#### Output parameters for the `cache` action
+
+- `cache-hit`: A boolean value to indicate an exact match was found for the key.
+
+#### Example using the `cache` action
+
+This example creates a new cache when the packages in `package-lock.json` file change, or when the runner's operating system changes. The cache key uses contexts and expressions to generate a key that includes the runner's operating system and a SHA-256 hash of the `package-lock.json` file.
+
+{% raw %}
+```yaml
+name: Caching with npm
+
+on: push
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+
+    - name: Cache node modules
+      uses: actions/cache@v2
+      env:
+        cache-name: cache-node-modules
+      with:
+        # npm cache files are stored in `~/.npm` on Linux/macOS
+        path: ~/.npm
+        key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }}
+        restore-keys: |
+          ${{ runner.os }}-build-${{ env.cache-name }}-
+          ${{ runner.os }}-build-
+          ${{ runner.os }}-
+
+    - name: Install Dependencies
+      run: npm install
+
+    - name: Build
+      run: npm build
+
+    - name: Test
+      run: npm test
+
+```
+{% endraw %}
+
+When `key` matches an existing cache, it's called a cache hit, and the action restores the cached files to the `path` directory.
+
+When `key` doesn't match an existing cache, it's called a cache miss, and a new cache is created if the job completes successfully. When a cache miss occurs, the action searches for alternate keys called `restore-keys`.
+
+1. If you provide `restore-keys`, the `cache` action sequentially searches for any caches that match the list of `restore-keys`.
+   - When there is an exact match, the action restores the files in the cache to the `path` directory.
+   - If there are no exact matches, the action searches for partial matches of the restore keys. When the action finds a partial match, the most recent cache is restored to the `path` directory.
+1. The `cache` action completes and the next workflow step in the job runs.
+1. If the job completes successfully, the action creates a new cache with the contents of the `path` directory.
+
+To cache files in more than one directory, you will need a step that uses the [`cache`](https://github.com/actions/cache) action for each directory. Once you create a cache, you cannot change the contents of an existing cache but you can create a new cache with a new key.
+
+#### Using contexts to create cache keys
+
+A cache key can include any of the contexts, functions, literals, and operators supported by {% data variables.product.prodname_actions %}. For more information, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)."
+
+Using expressions to create a `key` allows you to automatically create a new cache when dependencies have changed. For example, you can create a `key` using an expression that calculates the hash of an npm `package-lock.json` file.
+
+{% raw %}
+```
+npm-${{ hashFiles('package-lock.json') }}
+```
+{% endraw %}
+
+{% data variables.product.prodname_dotcom %} evaluates the expression `hash "package-lock.json"` to derive the final `key`.
+
+```
+npm-d5ea0750
+```
+
+### Matching a cache key
+
+The `cache` action first searches for cache hits for `key` and `restore-keys` in the branch containing the workflow run. If there are no hits in the current branch, the `cache` action searches for `key` and `restore-keys` in the parent branch and upstream branches.
+
+You can provide a list of restore keys to use when there is a cache miss on `key`. You can create multiple restore keys ordered from the most specific to least specific. The `cache` action searches for `restore-keys` in sequential order. When a key doesn't match directly, the action searches for keys prefixed with the restore key. If there are multiple partial matches for a restore key, the action returns the most recently created cache.
+
+#### Example using multiple restore keys
+
+{% raw %}
+```
+restore-keys: |
+  npm-foobar-${{ hashFiles('package-lock.json') }}
+  npm-foobar-
+  npm-
+```
+{% endraw %}
+
+The runner evaluates the expressions, which resolve to these `restore-keys`:
+
+{% raw %}
+```
+restore-keys: |
+  npm-foobar-d5ea0750
+  npm-foobar-
+  npm-
+```
+{% endraw %}
+
+The restore key `npm-foobar-` matches any key that starts with the string `npm-foobar-`. For example, both of the keys `npm-foobar-fd3052de` and `npm-foobar-a9b253ff` match the restore key. The cache with the most recent creation date would be used. The keys in this example are searched in the following order:
+
+1. **`npm-foobar-d5ea0750`** matches a specific hash.
+1. **`npm-foobar-`** matches cache keys prefixed with `npm-foobar-`.
+1. **`npm-`** matches any keys prefixed with `npm-`.
+
+##### Example of search priority
+
+```yaml
+key:
+  npm-feature-d5ea0750
+restore-keys: |
+  npm-feature-
+  npm-
+```
+
+For example, if a pull request contains a `feature` branch (the current scope) and targets the default branch (`main`), the action searches for `key` and `restore-keys` in the following order:
+
+1. Key `npm-feature-d5ea0750` in the `feature` branch scope
+1. Key `npm-feature-` in the `feature` branch scope
+2. Key `npm-` in the `feature` branch scope
+1. Key `npm-feature-d5ea0750` in the `main` branch scope
+3. Key `npm-feature-` in the `main` branch scope
+4. Key `npm-` in the `main` branch scope
+
+### Usage limits and eviction policy
+
+{% data variables.product.prodname_dotcom %} will remove any cache entries that have not been accessed in over 7 days. There is no limit on the number of caches you can store, but the total size of all caches in a repository is limited to 5 GB. If you exceed this limit, {% data variables.product.prodname_dotcom %} will save your cache but will begin evicting caches until the total size is less than 5 GB.
diff --git a/translations/ru-RU/content/actions/guides/creating-postgresql-service-containers.md b/translations/ru-RU/content/actions/guides/creating-postgresql-service-containers.md
new file mode 100644
index 000000000000..f1f40f88647c
--- /dev/null
+++ b/translations/ru-RU/content/actions/guides/creating-postgresql-service-containers.md
@@ -0,0 +1,335 @@
+---
+title: Creating PostgreSQL service containers
+shortTitle: PostgreSQL service containers
+intro: You can create a PostgreSQL service container to use in your workflow. This guide shows examples of creating a PostgreSQL service for jobs that run in containers or directly on the runner machine.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/creating-postgresql-service-containers
+  - /actions/configuring-and-managing-workflows/creating-postgresql-service-containers
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introduction
+
+This guide shows you workflow examples that configure a service container using the Docker Hub `postgres` image. The workflow runs a script to create a PostgreSQL client and populate the client with data. To test that the workflow creates and populates the PostgreSQL client, the script prints the client's data to the console.
+
+{% data reusables.github-actions.docker-container-os-support %}
+
+### Требования
+
+{% data reusables.github-actions.service-container-prereqs %}
+
+You may also find it helpful to have a basic understanding of YAML, the syntax for {% data variables.product.prodname_actions %}, and PostgreSQL. Дополнительные сведения см. в:
+
+- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)"
+- "[PostgreSQL tutorial](https://www.postgresqltutorial.com/)" in the PostgreSQL documentation
+
+### Running jobs in containers
+
+{% data reusables.github-actions.container-jobs-intro %}
+
+{% data reusables.github-actions.copy-workflow-file %}
+
+{% raw %}
+```yaml
+name: PostgreSQL service example
+on: push
+
+jobs:
+  # Label of the container job
+  container-job:
+    # Containers must run in Linux based operating systems
+    runs-on: ubuntu-latest
+    # Docker Hub image that `container-job` executes in
+    container: node:10.18-jessie
+
+    # Service containers to run with `container-job`
+    services:
+      # Label used to access the service container
+      postgres:
+        # Docker Hub image
+        image: postgres
+        # Provide the password for postgres
+        env:
+          POSTGRES_PASSWORD: postgres
+        # Set health checks to wait until postgres has started
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
+    steps:
+      # Downloads a copy of the code in your repository before running CI tests
+      - name: Check out repository code
+        uses: actions/checkout@v2
+
+      # Performs a clean installation of all dependencies in the `package.json` file
+      # For more information, see https://docs.npmjs.com/cli/ci.html
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Connect to PostgreSQL
+        # Runs a script that creates a PostgreSQL client, populates
+        # the client with data, and retrieves data
+        run: node client.js
+        # Environment variable used by the `client.js` script to create a new PostgreSQL client.
+        env:
+          # The hostname used to communicate with the PostgreSQL service container
+          POSTGRES_HOST: postgres
+          # The default PostgreSQL port
+          POSTGRES_PORT: 5432
+```
+{% endraw %}
+
+#### Configuring the runner job
+
+{% data reusables.github-actions.service-container-host %}
+
+{% data reusables.github-actions.postgres-label-description %}
+
+```yaml
+jobs:
+  # Label of the container job
+  container-job:
+    # Containers must run in Linux based operating systems
+    runs-on: ubuntu-latest
+    # Docker Hub image that `container-job` executes in
+    container: node:10.18-jessie
+
+    # Service containers to run with `container-job`
+    services:
+      # Label used to access the service container
+      postgres:
+        # Docker Hub image
+        image: postgres
+        # Provide the password for postgres
+        env:
+          POSTGRES_PASSWORD: postgres
+        # Set health checks to wait until postgres has started
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+```
+
+#### Configuring the steps
+
+{% data reusables.github-actions.service-template-steps %}
+
+```yaml
+steps:
+  # Downloads a copy of the code in your repository before running CI tests
+  - name: Check out repository code
+    uses: actions/checkout@v2
+
+  # Performs a clean installation of all dependencies in the `package.json` file
+  # For more information, see https://docs.npmjs.com/cli/ci.html
+  - name: Install dependencies
+    run: npm ci
+
+  - name: Connect to PostgreSQL
+    # Runs a script that creates a PostgreSQL client, populates
+    # the client with data, and retrieves data
+    run: node client.js
+    # Environment variable used by the `client.js` script to create
+    # a new PostgreSQL client.
+    env:
+      # The hostname used to communicate with the PostgreSQL service container
+      POSTGRES_HOST: postgres
+      # The default PostgreSQL port
+      POSTGRES_PORT: 5432
+```
+
+{% data reusables.github-actions.postgres-environment-variables %}
+
+The hostname of the PostgreSQL service is the label you configured in your workflow, in this case, `postgres`. Because Docker containers on the same user-defined bridge network open all ports by default, you'll be able to access the service container on the default PostgreSQL port 5432.
+
+### Running jobs directly on the runner machine
+
+When you run a job directly on the runner machine, you'll need to map the ports on the service container to ports on the Docker host. You can access service containers from the Docker host using `localhost` and the Docker host port number.
+
+{% data reusables.github-actions.copy-workflow-file %}
+
+{% raw %}
+```yaml
+name: PostgreSQL Service Example
+on: push
+
+jobs:
+  # Label of the runner job
+  runner-job:
+    # You must use a Linux environment when using service containers or container jobs
+    runs-on: ubuntu-latest
+
+    # Service containers to run with `runner-job`
+    services:
+      # Label used to access the service container
+      postgres:
+        # Docker Hub image
+        image: postgres
+        # Provide the password for postgres
+        env:
+          POSTGRES_PASSWORD: postgres
+        # Set health checks to wait until postgres has started
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          # Maps tcp port 5432 on service container to the host
+          - 5432:5432
+
+    steps:
+      # Downloads a copy of the code in your repository before running CI tests
+      - name: Check out repository code
+        uses: actions/checkout@v2
+
+      # Performs a clean installation of all dependencies in the `package.json` file
+      # For more information, see https://docs.npmjs.com/cli/ci.html
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Connect to PostgreSQL
+        # Runs a script that creates a PostgreSQL client, populates
+        # the client with data, and retrieves data
+        run: node client.js
+        # Environment variable used by the `client.js` script to create
+        # a new PostgreSQL client.
+        env:
+          # The hostname used to communicate with the PostgreSQL service container
+          POSTGRES_HOST: localhost
+          # The default PostgreSQL port
+          POSTGRES_PORT: 5432
+```
+{% endraw %}
+
+#### Configuring the runner job
+
+{% data reusables.github-actions.service-container-host-runner %}
+
+{% data reusables.github-actions.postgres-label-description %}
+
+The workflow maps port 5432 on the PostgreSQL service container to the Docker host. For more information about the `ports` keyword, see "[About service containers](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)."
+
+```yaml
+jobs:
+  # Label of the runner job
+  runner-job:
+    # You must use a Linux environment when using service containers or container jobs
+    runs-on: ubuntu-latest
+
+    # Service containers to run with `runner-job`
+    services:
+      # Label used to access the service container
+      postgres:
+        # Docker Hub image
+        image: postgres
+        # Provide the password for postgres
+        env:
+          POSTGRES_PASSWORD: postgres
+        # Set health checks to wait until postgres has started
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          # Maps tcp port 5432 on service container to the host
+          - 5432:5432
+```
+
+#### Configuring the steps
+
+{% data reusables.github-actions.service-template-steps %}
+
+```yaml
+steps:
+  # Downloads a copy of the code in your repository before running CI tests
+  - name: Check out repository code
+    uses: actions/checkout@v2
+
+  # Performs a clean installation of all dependencies in the `package.json` file
+  # For more information, see https://docs.npmjs.com/cli/ci.html
+  - name: Install dependencies
+    run: npm ci
+
+  - name: Connect to PostgreSQL
+    # Runs a script that creates a PostgreSQL client, populates
+    # the client with data, and retrieves data
+    run: node client.js
+    # Environment variable used by the `client.js` script to create
+    # a new PostgreSQL client.
+    env:
+      # The hostname used to communicate with the PostgreSQL service container
+      POSTGRES_HOST: localhost
+      # The default PostgreSQL port
+      POSTGRES_PORT: 5432
+```
+
+{% data reusables.github-actions.postgres-environment-variables %}
+
+{% data reusables.github-actions.service-container-localhost %}
+
+### Testing the PostgreSQL service container
+
+You can test your workflow using the following script, which creates a PostgreSQL client and adds a new table with some placeholder data. The script then prints the values stored in the PostgreSQL client to the terminal. Your script can use any language you'd like, but this example uses Node.js and the `pg` npm module. For more information, see the [npm pg module](https://www.npmjs.com/package/pg).
+
+You can modify *client.js* to include any PostgreSQL operations needed by your workflow. In this example, the script creates the PostgreSQL client instance, creates a table, adds placeholder data, then retrieves the data.
+
+{% data reusables.github-actions.service-container-add-script %}
+
+```javascript
+const { Client } = require('pg');
+
+const pgclient = new Client({
+    host: process.env.POSTGRES_HOST,
+    port: process.env.POSTGRES_PORT,
+    user: 'postgres',
+    password: 'postgres',
+    database: 'postgres'
+});
+
+pgclient.connect();
+
+const table = 'CREATE TABLE student(id SERIAL PRIMARY KEY, firstName VARCHAR(40) NOT NULL, lastName VARCHAR(40) NOT NULL, age INT, address VARCHAR(80), email VARCHAR(40))'
+const text = 'INSERT INTO student(firstname, lastname, age, address, email) VALUES($1, $2, $3, $4, $5) RETURNING *'
+const values = ['Mona the', 'Octocat', 9, '88 Colin P Kelly Jr St, San Francisco, CA 94107, United States', 'octocat@github.com']
+
+pgclient.query(table, (err, res) => {
+    if (err) throw err
+});
+
+pgclient.query(text, values, (err, res) => {
+    if (err) throw err
+});
+
+pgclient.query('SELECT * FROM student', (err, res) => {
+    if (err) throw err
+    console.log(err, res.rows) // Print the data in student table
+    pgclient.end()
+});
+```
+
+The script creates a new PostgreSQL `Client`, which accepts a `host` and `port` parameter. The script uses the `POSTGRES_HOST` and `POSTGRES_PORT` environment variables to set the client's IP address and port. If `host` and `port` are not defined, the default host is `localhost` and the default port is 5432.
+
+The script creates a table and populates it with placeholder data. To test that the PostgreSQL database contains the data, the script prints the contents of the table to the console log.
+
+When you run this workflow, you should see the following output in the "Connect to PostgreSQL" step confirming you created the PostgreSQL client and added data:
+
+```
+null [ { id: 1,
+    firstname: 'Mona the',
+    lastname: 'Octocat',
+    age: 9,
+    address:
+     '88 Colin P Kelly Jr St, San Francisco, CA 94107, United States',
+    email: 'octocat@github.com' } ]
+```
diff --git a/translations/ru-RU/content/actions/guides/creating-redis-service-containers.md b/translations/ru-RU/content/actions/guides/creating-redis-service-containers.md
new file mode 100644
index 000000000000..98b3650c5751
--- /dev/null
+++ b/translations/ru-RU/content/actions/guides/creating-redis-service-containers.md
@@ -0,0 +1,325 @@
+---
+title: Creating Redis service containers
+shortTitle: Redis service containers
+intro: You can use service containers to create a Redis client in your workflow. This guide shows examples of creating a Redis service for jobs that run in containers or directly on the runner machine.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/creating-redis-service-containers
+  - /actions/configuring-and-managing-workflows/creating-redis-service-containers
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introduction
+
+This guide shows you workflow examples that configure a service container using the Docker Hub `redis` image. The workflow runs a script to create a Redis client and populate the client with data. To test that the workflow creates and populates the Redis client, the script prints the client's data to the console.
+
+{% data reusables.github-actions.docker-container-os-support %}
+
+### Требования
+
+{% data reusables.github-actions.service-container-prereqs %}
+
+You may also find it helpful to have a basic understanding of YAML, the syntax for {% data variables.product.prodname_actions %}, and Redis. Дополнительные сведения см. в:
+
+- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)"
+- "[Getting Started with Redis](https://redislabs.com/get-started-with-redis/)" in the Redis documentation
+
+### Running jobs in containers
+
+{% data reusables.github-actions.container-jobs-intro %}
+
+{% data reusables.github-actions.copy-workflow-file %}
+
+{% raw %}
+```yaml
+name: Redis container example
+on: push
+
+jobs:
+  # Label of the container job
+  container-job:
+    # Containers must run in Linux based operating systems
+    runs-on: ubuntu-latest
+    # Docker Hub image that `container-job` executes in
+    container: node:10.18-jessie
+
+    # Service containers to run with `container-job`
+    services:
+      # Label used to access the service container
+      redis:
+        # Docker Hub image
+        image: redis
+        # Set health checks to wait until redis has started
+        options: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
+    steps:
+      # Downloads a copy of the code in your repository before running CI tests
+      - name: Check out repository code
+        uses: actions/checkout@v2
+
+      # Performs a clean installation of all dependencies in the `package.json` file
+      # For more information, see https://docs.npmjs.com/cli/ci.html
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Connect to Redis
+        # Runs a script that creates a Redis client, populates
+        # the client with data, and retrieves data
+        run: node client.js
+        # Environment variable used by the `client.js` script to create a new Redis client.
+        env:
+          # The hostname used to communicate with the Redis service container
+          REDIS_HOST: redis
+          # The default Redis port
+          REDIS_PORT: 6379
+```
+{% endraw %}
+
+#### Configuring the container job
+
+{% data reusables.github-actions.service-container-host %}
+
+{% data reusables.github-actions.redis-label-description %}
+
+```yaml
+jobs:
+  # Label of the container job
+  container-job:
+    # Containers must run in Linux based operating systems
+    runs-on: ubuntu-latest
+    # Docker Hub image that `container-job` executes in
+    container: node:10.18-jessie
+
+    # Service containers to run with `container-job`
+    services:
+      # Label used to access the service container
+      redis:
+        # Docker Hub image
+        image: redis
+        # Set health checks to wait until redis has started
+        options: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+```
+
+#### Configuring the steps
+
+{% data reusables.github-actions.service-template-steps %}
+
+```yaml
+steps:
+  # Downloads a copy of the code in your repository before running CI tests
+  - name: Check out repository code
+    uses: actions/checkout@v2
+
+  # Performs a clean installation of all dependencies in the `package.json` file
+  # For more information, see https://docs.npmjs.com/cli/ci.html
+  - name: Install dependencies
+    run: npm ci
+
+  - name: Connect to Redis
+    # Runs a script that creates a Redis client, populates
+    # the client with data, and retrieves data
+    run: node client.js
+    # Environment variable used by the `client.js` script to create a new Redis client.
+    env:
+      # The hostname used to communicate with the Redis service container
+      REDIS_HOST: redis
+      # The default Redis port
+      REDIS_PORT: 6379
+```
+
+{% data reusables.github-actions.redis-environment-variables %}
+
+The hostname of the Redis service is the label you configured in your workflow, in this case, `redis`. Because Docker containers on the same user-defined bridge network open all ports by default, you'll be able to access the service container on the default Redis port 6379.
+
+### Running jobs directly on the runner machine
+
+When you run a job directly on the runner machine, you'll need to map the ports on the service container to ports on the Docker host. You can access service containers from the Docker host using `localhost` and the Docker host port number.
+
+{% data reusables.github-actions.copy-workflow-file %}
+
+{% raw %}
+```yaml
+name: Redis runner example
+on: push
+
+jobs:
+  # Label of the runner job
+  runner-job:
+    # You must use a Linux environment when using service containers or container jobs
+    runs-on: ubuntu-latest
+
+    # Service containers to run with `runner-job`
+    services:
+      # Label used to access the service container
+      redis:
+        # Docker Hub image
+        image: redis
+        # Set health checks to wait until redis has started
+        options: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          # Maps port 6379 on service container to the host
+          - 6379:6379
+
+    steps:
+      # Downloads a copy of the code in your repository before running CI tests
+      - name: Check out repository code
+        uses: actions/checkout@v2
+
+      # Performs a clean installation of all dependencies in the `package.json` file
+      # For more information, see https://docs.npmjs.com/cli/ci.html
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Connect to Redis
+        # Runs a script that creates a Redis client, populates
+        # the client with data, and retrieves data
+        run: node client.js
+        # Environment variable used by the `client.js` script to create
+        # a new Redis client.
+        env:
+          # The hostname used to communicate with the Redis service container
+          REDIS_HOST: localhost
+          # The default Redis port
+          REDIS_PORT: 6379
+```
+{% endraw %}
+
+#### Configuring the runner job
+
+{% data reusables.github-actions.service-container-host-runner %}
+
+{% data reusables.github-actions.redis-label-description %}
+
+The workflow maps port 6379 on the Redis service container to the Docker host. For more information about the `ports` keyword, see "[About service containers](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)."
+
+```yaml
+jobs:
+  # Label of the runner job
+  runner-job:
+    # You must use a Linux environment when using service containers or container jobs
+    runs-on: ubuntu-latest
+
+    # Service containers to run with `runner-job`
+    services:
+      # Label used to access the service container
+      redis:
+        # Docker Hub image
+        image: redis
+        # Set health checks to wait until redis has started
+        options: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          # Maps port 6379 on service container to the host
+          - 6379:6379
+```
+
+#### Configuring the steps
+
+{% data reusables.github-actions.service-template-steps %}
+
+```yaml
+steps:
+  # Downloads a copy of the code in your repository before running CI tests
+  - name: Check out repository code
+    uses: actions/checkout@v2
+
+  # Performs a clean installation of all dependencies in the `package.json` file
+  # For more information, see https://docs.npmjs.com/cli/ci.html
+  - name: Install dependencies
+    run: npm ci
+
+  - name: Connect to Redis
+    # Runs a script that creates a Redis client, populates
+    # the client with data, and retrieves data
+    run: node client.js
+    # Environment variable used by the `client.js` script to create
+    # a new Redis client.
+    env:
+      # The hostname used to communicate with the Redis service container
+      REDIS_HOST: localhost
+      # The default Redis port
+      REDIS_PORT: 6379
+```
+
+{% data reusables.github-actions.redis-environment-variables %}
+
+{% data reusables.github-actions.service-container-localhost %}
+
+### Testing the Redis service container
+
+You can test your workflow using the following script, which creates a Redis client and populates the client with some placeholder data. The script then prints the values stored in the Redis client to the terminal. Your script can use any language you'd like, but this example uses Node.js and the `redis` npm module. For more information, see the [npm redis module](https://www.npmjs.com/package/redis).
+
+You can modify *client.js* to include any Redis operations needed by your workflow. In this example, the script creates the Redis client instance, adds placeholder data, then retrieves the data.
+
+{% data reusables.github-actions.service-container-add-script %}
+
+```javascript
+const redis = require("redis");
+
+// Creates a new Redis client
+// If REDIS_HOST is not set, the default host is localhost
+// If REDIS_PORT is not set, the default port is 6379
+const redisClient = redis.createClient({
+  host: process.env.REDIS_HOST,
+  port: process.env.REDIS_PORT  
+});
+
+redisClient.on("error", function(err) {
+    console.log("Error " + err);
+});
+
+// Sets the key "octocat" to a value of "Mona the octocat"
+redisClient.set("octocat", "Mona the Octocat", redis.print);
+// Sets a key to "octocat", field to "species", and "value" to "Cat and Octopus"
+redisClient.hset("species", "octocat", "Cat and Octopus", redis.print);
+// Sets a key to "octocat", field to "species", and "value" to "Dinosaur and Octopus"
+redisClient.hset("species", "dinotocat", "Dinosaur and Octopus", redis.print);
+// Sets a key to "octocat", field to "species", and "value" to "Cat and Robot"
+redisClient.hset(["species", "robotocat", "Cat and Robot"], redis.print);
+// Gets all fields in "species" key
+
+redisClient.hkeys("species", function (err, replies) {
+    console.log(replies.length + " replies:");
+    replies.forEach(function (reply, i) {
+        console.log("    " + i + ": " + reply);
+    });
+    redisClient.quit();
+});
+```
+
+The script creates a new Redis client using the `createClient` method, which accepts a `host` and `port` parameter. The script uses the `REDIS_HOST` and `REDIS_PORT` environment variables to set the client's IP address and port. If `host` and `port` are not defined, the default host is `localhost` and the default port is 6379.
+
+The script uses the `set` and `hset` methods to populate the database with some keys, fields, and values. To confirm that the Redis client contains the data, the script prints the contents of the database to the console log.
+
+When you run this workflow, you should see the following output in the "Connect to Redis" step confirming you created the Redis client and added data:
+
+```
+Reply: OK
+Reply: 1
+Reply: 1
+Reply: 1  
+3 replies:
+    0: octocat
+    1: dinotocat
+    2: robotocat
+```
diff --git a/translations/ru-RU/content/actions/guides/index.md b/translations/ru-RU/content/actions/guides/index.md
new file mode 100644
index 000000000000..1450c170fa04
--- /dev/null
+++ b/translations/ru-RU/content/actions/guides/index.md
@@ -0,0 +1,60 @@
+---
+title: Руководства
+shortTitle: Руководства
+intro: 'These guides for {% data variables.product.prodname_actions %} include specific use cases and examples to help you configure workflows.'
+redirect_from:
+  - /actions/guides/caching-and-storing-workflow-data
+  - /actions/automating-your-workflow-with-github-actions/using-databases-and-services
+  - /actions/configuring-and-managing-workflows/using-databases-and-service-containers
+  - /actions/guides/using-databases-and-service-containers
+  - /actions/language-and-framework-guides
+  - /actions/language-and-framework-guides/github-actions-for-docker
+  - /actions/language-and-framework-guides/github-actions-for-java
+  - /actions/language-and-framework-guides/github-actions-for-javascript-and-typescript
+  - /actions/language-and-framework-guides/github-actions-for-python
+  - /actions/publishing-packages-with-github-actions
+  - /actions/building-and-testing-code-with-continuous-integration
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Creating custom continuous integration workflows
+
+You can use {% data variables.product.prodname_actions %} to create custom continuous integration (CI) workflows that build and test projects written in different programming languages.
+
+{% link_in_list /about-continuous-integration %}
+{% link_in_list /setting-up-continuous-integration-using-workflow-templates %}
+{% link_in_list /building-and-testing-nodejs %}
+{% link_in_list /building-and-testing-python %}
+{% link_in_list /building-and-testing-java-with-maven %}
+{% link_in_list /building-and-testing-java-with-gradle %}
+{% link_in_list /building-and-testing-java-with-ant %}
+
+### Publishing software packages
+
+You can automate publishing software packages as part your continuous delivery (CD) workflow. Packages can be published to any package host and to {% data reusables.gated-features.packages %}.
+
+{% link_in_list /about-packaging-with-github-actions %}
+{% link_in_list /publishing-nodejs-packages %}
+{% link_in_list /publishing-java-packages-with-maven %}
+{% link_in_list /publishing-java-packages-with-gradle %}
+{% link_in_list /publishing-docker-images %}
+
+### Caching and storing workflow data
+
+Cache dependencies and store artifacts to make your workflow runs more efficient.
+
+{% link_in_list /storing-workflow-data-as-artifacts %}
+{% link_in_list /caching-dependencies-to-speed-up-workflows %}
+
+### Using service containers in a workflow
+
+Connect services to your workflow using service containers.
+
+{% link_in_list /about-service-containers %}
+{% link_in_list /creating-redis-service-containers %}
+{% link_in_list /creating-postgresql-service-containers %}
diff --git a/translations/ru-RU/content/actions/guides/publishing-docker-images.md b/translations/ru-RU/content/actions/guides/publishing-docker-images.md
new file mode 100644
index 000000000000..7447263c5c75
--- /dev/null
+++ b/translations/ru-RU/content/actions/guides/publishing-docker-images.md
@@ -0,0 +1,158 @@
+---
+title: Publishing Docker images
+intro: 'You can publish Docker images to a registry, such as Docker Hub or {% data variables.product.prodname_registry %}, as part of your continuous integration (CI) workflow.'
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/publishing-docker-images
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introduction
+
+This guide shows you how to create a workflow that performs a Docker build, and then publishes Docker images to Docker Hub or {% data variables.product.prodname_registry %}. With a single workflow, you can publish images to a single registry or to multiple registries.
+
+{% note %}
+
+**Note:** If you want to push to another third-party Docker registry, the example in the "[Publishing images to {% data variables.product.prodname_registry %}](#publishing-images-to-github-packages)" section can serve as a good template.
+
+{% endnote %}
+
+### Требования
+
+We recommend that you have a basic understanding of workflow configuration options and how to create a workflow file. For more information, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)."
+
+You might also find it helpful to have a basic understanding of the following:
+
+- "[Encrypted secrets](/actions/reference/encrypted-secrets)"
+- "[Authentication in a workflow](/actions/reference/authentication-in-a-workflow)"
+- "[Configuring Docker for use with {% data variables.product.prodname_registry %}](/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)"
+
+### About image configuration
+
+This guide assumes that you have a complete definition for a Docker image stored in a {% data variables.product.prodname_dotcom %} repository. For example, your repository must contain a _Dockerfile_, and any other files needed to perform a Docker build to create an image.
+
+In this guide, we will use the Docker `build-push-action` action to build the Docker image and push it to one or more Docker registries. For more information, see [`build-push-action`](https://github.com/marketplace/actions/build-and-push-docker-images).
+
+{% data reusables.actions.enterprise-marketplace-actions %}
+
+### Publishing images to Docker Hub
+
+{% data reusables.github-actions.release-trigger-workflow %}
+
+In the example workflow below, we use the Docker `build-push-action` action to build the Docker image and, if the build succeeds, push the built image to Docker Hub.
+
+To push to Docker Hub, you will need to have a Docker Hub account, and have a Docker Hub repository created. For more information, see "[Share images on Docker Hub](https://docs.docker.com/get-started/part3/)" in the Docker documentation.
+
+The `build-push-action` options required for Docker Hub are:
+
+* `username` and `password`: This is your Docker Hub username and password. We recommend storing your Docker Hub username and password as encrypted secrets in the your {% data variables.product.prodname_dotcom %} repository so they aren't exposed in your workflow file. For more information, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
+* `repository`: Your Docker Hub repository in the format `DOCKER-HUB-NAMESPACE/DOCKER-HUB-REPOSITORY`.
+
+{% raw %}
+```yaml
+name: Publish Docker image
+on:
+  release:
+    types: [published]
+jobs:
+  push_to_registry:
+    name: Push Docker image to Docker Hub
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out the repo
+        uses: actions/checkout@v2
+      - name: Push to Docker Hub
+        uses: docker/build-push-action@v1
+        with:
+          username: ${{ secrets.DOCKER_USERNAME }}
+          password: ${{ secrets.DOCKER_PASSWORD }}
+          repository: my-docker-hub-namespace/my-docker-hub-repository
+          tag_with_ref: true
+```
+{% endraw %}
+
+{% data reusables.github-actions.docker-tag-with-ref %}
+
+### Publishing images to {% data variables.product.prodname_registry %}
+
+{% data reusables.github-actions.release-trigger-workflow %}
+
+In the example workflow below, we use the Docker `build-push-action` action to build the Docker image, and if the build succeeds, push the built image to {% data variables.product.prodname_registry %}.
+
+The `build-push-action` options required for {% data variables.product.prodname_registry %} are:
+
+* `username`: You can use the {% raw %}`${{ github.actor }}`{% endraw %} context to automatically use the username of the user that triggered the workflow run. For more information, see "[Context and expression syntax for GitHub Actions](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)."
+* `password`: You can use the automatically-generated `GITHUB_TOKEN` secret for the password. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)."
+* `registry`: Must be set to `docker.pkg.github.com`.
+* `repository`: Must be set in the format `OWNER/REPOSITORY/IMAGE_NAME`. For example, for an image named `octo-image` stored on {% data variables.product.prodname_dotcom %} at `http://github.com/octo-org/octo-repo`, the `repository` option should be set to `octo-org/octo-repo/octo-image`.
+
+{% raw %}
+```yaml
+name: Publish Docker image
+on:
+  release:
+    types: [published]
+jobs:
+  push_to_registry:
+    name: Push Docker image to GitHub Packages
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out the repo
+        uses: actions/checkout@v2
+      - name: Push to GitHub Packages
+        uses: docker/build-push-action@v1
+        with:
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+          registry: docker.pkg.github.com
+          repository: my-org/my-repo/my-image
+          tag_with_ref: true
+
+```
+{% endraw %}
+
+{% data reusables.github-actions.docker-tag-with-ref %}
+
+### Publishing images to Docker Hub and {% data variables.product.prodname_registry %}
+
+In a single workflow, you can publish your Docker image to multiple registries by using the `build-push-action` action for each registry.
+
+The following example workflow uses the `build-push-action` steps from the previous sections ("[Publishing images to Docker Hub](#publishing-images-to-docker-hub)" and "[Publishing images to {% data variables.product.prodname_registry %}](#publishing-images-to-github-packages)") to create a single workflow that pushes to both registries.
+
+{% raw %}
+```yaml
+name: Publish Docker image
+on:
+  release:
+    types: [published]
+jobs:
+  push_to_registries:
+    name: Push Docker image to multiple registries
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out the repo
+        uses: actions/checkout@v2
+      - name: Push to Docker Hub
+        uses: docker/build-push-action@v1
+        with:
+          username: ${{ secrets.DOCKER_USERNAME }}
+          password: ${{ secrets.DOCKER_PASSWORD }}
+          repository: my-docker-hub-namespace/my-docker-hub-repository
+          tag_with_ref: true
+      - name: Push to GitHub Packages
+        uses: docker/build-push-action@v1
+        with:
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+          registry: docker.pkg.github.com
+          repository: my-org/my-repo/my-image
+          tag_with_ref: true
+```
+{% endraw %}
+
+The above workflow checks out the {% data variables.product.prodname_dotcom %} repository, and uses the `build-push-action` action twice to build and push the Docker image to Docker Hub and {% data variables.product.prodname_registry %}. For both steps, it sets the `build-push-action` option [`tag_with_ref`](https://github.com/marketplace/actions/build-and-push-docker-images#tag_with_ref) to automatically tag the built Docker image with the Git reference of the workflow event. This workflow is triggered on publishing a {% data variables.product.prodname_dotcom %} release, so the reference for both registries will be the Git tag for the release.
diff --git a/translations/ru-RU/content/actions/guides/publishing-java-packages-with-gradle.md b/translations/ru-RU/content/actions/guides/publishing-java-packages-with-gradle.md
new file mode 100644
index 000000000000..9ce0de758136
--- /dev/null
+++ b/translations/ru-RU/content/actions/guides/publishing-java-packages-with-gradle.md
@@ -0,0 +1,219 @@
+---
+title: Publishing Java packages with Gradle
+intro: You can use Gradle to publish Java packages to a registry as part of your continuous integration (CI) workflow.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/publishing-java-packages-with-gradle
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introduction
+
+{% data reusables.github-actions.publishing-java-packages-intro %}
+
+### Требования
+
+We recommend that you have a basic understanding of workflow files and configuration options. For more information, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)."
+
+For more information about creating a CI workflow for your Java project with Gradle, see "[Building and testing Java with Gradle](/actions/language-and-framework-guides/building-and-testing-java-with-gradle)."
+
+You may also find it helpful to have a basic understanding of the following:
+
+- "[Configuring npm for use with {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)"
+- "[Environment variables](/actions/reference/environment-variables)"
+- "[Encrypted secrets](/actions/reference/encrypted-secrets)"
+- "[Authentication in a workflow](/actions/reference/authentication-in-a-workflow)"
+
+### About package configuration
+
+The `groupId` and `artifactId` fields in the `MavenPublication` section of the _build.gradle_ file create a unique identifier for your package that registries use to link your package to a registry.  This is similar to the `groupId` and `artifactId` fields of the Maven _pom.xml_ file.  For more information, see the "[Maven Publish Plugin](https://docs.gradle.org/current/userguide/publishing_maven.html)" in the Gradle documentation.
+
+The _build.gradle_ file also contains configuration for the distribution management repositories that Gradle will publish packages to. Each repository must have a name, a deployment URL, and credentials for authentication.
+
+### Publishing packages to the Maven Central Repository
+
+Each time you create a new release, you can trigger a workflow to publish your package. The workflow in the example below runs when the `release` event triggers with type `created`. The workflow publishes the package to the Maven Central Repository if CI tests pass. For more information on the `release` event, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows#release)."
+
+You can define a new Maven repository in the publishing block of your _build.gradle_ file that points to your package repository.  For example, if you were deploying to the Maven Central Repository through the OSSRH hosting project, your _build.gradle_ could specify a repository with the name `"OSSRH"`.
+
+{% raw %}
+```groovy
+publishing {
+  ...
+
+  repositories {
+    maven {
+      name = "OSSRH"
+      url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/"
+      credentials {
+        username = System.getenv("MAVEN_USERNAME")
+        password = System.getenv("MAVEN_PASSWORD")
+      }
+    }
+  }
+}
+```
+{% endraw %}
+
+With this configuration, you can create a workflow that publishes your package to the Maven Central Repository by running the `gradle publish` command. You’ll also need to provide environment variables that contain the username and password to authenticate to the repository.
+
+In the deploy step, you’ll need to set environment variables for the username and password or token that you use to authenticate to the Maven repository. For more information, see "[Creating and using encrypted secrets](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
+
+
+{% raw %}
+```yaml
+name: Publish package to the Maven Central Repository
+on:
+  release:
+    types: [created]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Java
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Publish package
+        run: gradle publish
+        env:
+          MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
+          MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}
+```
+{% endraw %}
+
+{% data reusables.github-actions.gradle-workflow-steps %}
+1. Runs the `gradle publish` command to publish to the `OSSRH` Maven repository. The `MAVEN_USERNAME` environment variable will be set with the contents of your `OSSRH_USERNAME` secret, and the `MAVEN_PASSWORD` environment variable will be set with the contents of your `OSSRH_TOKEN` secret.
+
+   For more information about using secrets in your workflow, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
+
+### Publishing packages to {% data variables.product.prodname_registry %}
+
+Each time you create a new release, you can trigger a workflow to publish your package. The workflow in the example below runs when the `release` event triggers with type `created`. The workflow publishes the package to {% data variables.product.prodname_registry %} if CI tests pass. For more information on the `release` event, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows#release)."
+
+You can define a new Maven repository in the publishing block of your _build.gradle_ that points to {% data variables.product.prodname_registry %}.  In that repository configuration, you can also take advantage of environment variables set in your CI workflow run.  You can use the `GITHUB_ACTOR` environment variable as a username, and you can set the `GITHUB_TOKEN` environment variable with your `GITHUB_TOKEN` secret.
+
+The `GITHUB_TOKEN` exists in your repository by default and has read and write permissions for packages in the repository where the workflow runs. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)."
+
+For example, if your organization is named "octocat" and your repository is named "hello-world", then the {% data variables.product.prodname_registry %} configuration in _build.gradle_ would look similar to the below example.
+
+{% raw %}
+```groovy
+publishing {
+  ...
+
+  repositories {
+    maven {
+      name = "GitHubPackages"
+      url = "https://maven.pkg.github.com/octocat/hello-world"
+      credentials {
+        username = System.getenv("GITHUB_ACTOR")
+        password = System.getenv("GITHUB_TOKEN")
+      }
+    }
+  }
+}
+```
+{% endraw %}
+
+With this configuration, you can create a workflow that publishes your package to the Maven Central Repository by running the `gradle publish` command.
+
+{% raw %}
+```yaml
+name: Publish package to GitHub Packages
+on:
+  release:
+    types: [created]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Publish package
+        run: gradle publish
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
+
+{% data reusables.github-actions.gradle-workflow-steps %}
+1. Runs the `gradle publish` command to publish to {% data variables.product.prodname_registry %}. The `GITHUB_TOKEN` environment variable will be set with the content of the `GITHUB_TOKEN` secret.
+
+   For more information about using secrets in your workflow, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
+
+### Publishing packages to the Maven Central Repository and {% data variables.product.prodname_registry %}
+
+You can publish your packages to both the Maven Central Repository and {% data variables.product.prodname_registry %} by configuring each in your _build.gradle_ file.
+
+Ensure your _build.gradle_ file includes a repository for both your {% data variables.product.prodname_dotcom %} repository and your Maven Central Repository provider.
+
+For example, if you deploy to the Central Repository through the OSSRH hosting project, you might want to specify it in a distribution management repository with the `name` set to `OSSRH`. If you deploy to {% data variables.product.prodname_registry %}, you might want to specify it in a distribution management repository with the `name` set to `GitHubPackages`.
+
+If your organization is named "octocat" and your repository is named "hello-world", then the {% data variables.product.prodname_registry %} configuration in _build.gradle_ would look similar to the below example.
+
+{% raw %}
+```groovy
+publishing {
+  ...
+
+  repositories {
+    maven {
+      name = "OSSRH"
+      url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/"
+      credentials {
+        username = System.getenv("MAVEN_USERNAME")
+        password = System.getenv("MAVEN_PASSWORD")
+      }
+    }
+    maven {
+      name = "GitHubPackages"
+      url = "https://maven.pkg.github.com/octocat/hello-world"
+      credentials {
+        username = System.getenv("GITHUB_ACTOR")
+        password = System.getenv("GITHUB_TOKEN")
+      }
+    }
+  }
+}
+```
+{% endraw %}
+
+With this configuration, you can create a workflow that publishes your package to both the Maven Central Repository and {% data variables.product.prodname_registry %} by running the `gradle publish` command.
+
+{% raw %}
+```yaml
+name: Publish package to the Maven Central Repository and GitHub Packages
+on:
+  release:
+    types: [created]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Java
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Publish to the Maven Central Repository
+        run: gradle publish
+        env:
+          MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
+          MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
+
+{% data reusables.github-actions.gradle-workflow-steps %}
+1. Runs the `gradle publish` command to publish to the `OSSRH` Maven repository and {% data variables.product.prodname_registry %}. The `MAVEN_USERNAME` environment variable will be set with the contents of your `OSSRH_USERNAME` secret, and the `MAVEN_PASSWORD` environment variable will be set with the contents of your `OSSRH_TOKEN` secret. The `GITHUB_TOKEN` environment variable will be set with the content of the `GITHUB_TOKEN` secret.
+
+   For more information about using secrets in your workflow, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
diff --git a/translations/ru-RU/content/actions/guides/publishing-java-packages-with-maven.md b/translations/ru-RU/content/actions/guides/publishing-java-packages-with-maven.md
new file mode 100644
index 000000000000..c70bc9a7828a
--- /dev/null
+++ b/translations/ru-RU/content/actions/guides/publishing-java-packages-with-maven.md
@@ -0,0 +1,210 @@
+---
+title: Publishing Java packages with Maven
+intro: You can use Maven to publish Java packages to a registry as part of your continuous integration (CI) workflow.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/publishing-java-packages-with-maven
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introduction
+
+{% data reusables.github-actions.publishing-java-packages-intro %}
+
+### Требования
+
+We recommend that you have a basic understanding of workflow files and configuration options. For more information, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)."
+
+For more information about creating a CI workflow for your Java project with Maven, see "[Building and testing Java with Maven](/actions/language-and-framework-guides/building-and-testing-java-with-maven)."
+
+You may also find it helpful to have a basic understanding of the following:
+
+- "[Configuring npm for use with {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)"
+- "[Environment variables](/actions/reference/environment-variables)"
+- "[Encrypted secrets](/actions/reference/encrypted-secrets)"
+- "[Authentication in a workflow](/actions/reference/authentication-in-a-workflow)"
+
+### About package configuration
+
+The `groupId` and `artifactId` fields in the _pom.xml_ file create a unique identifier for your package that registries use to link your package to a registry.  For more information see [Guide to uploading artifacts to the Central Repository](http://maven.apache.org/repository/guide-central-repository-upload.html) in the Apache Maven documentation.
+
+The _pom.xml_ file also contains configuration for the distribution management repositories that Maven will deploy packages to. Each repository must have a name and a deployment URL. Authentication for these repositories can be configured in the _.m2/settings.xml_ file in the home directory of the user running Maven.
+
+You can use the `setup-java` action to configure the deployment repository as well as authentication for that repository. For more information, see [`setup-java`](https://github.com/actions/setup-java).
+
+### Publishing packages to the Maven Central Repository
+
+Each time you create a new release, you can trigger a workflow to publish your package. The workflow in the example below runs when the `release` event triggers with type `created`. The workflow publishes the package to the Maven Central Repository if CI tests pass. For more information on the `release` event, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows#release)."
+
+In this workflow, you can use the `setup-java` action. This action installs the given version of the JDK into the `PATH`, but it also configures a Maven _settings.xml_ for publishing packages. By default, the settings file will be configured for {% data variables.product.prodname_registry %}, but it can be configured to deploy to another package registry, such as the Maven Central Repository. If you already have a distribution management repository configured in _pom.xml_, then you can specify that `id` during the `setup-java` action invocation.
+
+For example, if you were deploying to the Maven Central Repository through the OSSRH hosting project, your _pom.xml_ could specify a distribution management repository with the `id` of `ossrh`.
+
+{% raw %}
+```xml
+
+  ...
+  
+    
+      ossrh
+      Central Repository OSSRH
+      https://oss.sonatype.org/service/local/staging/deploy/maven2/
+    
+  
+
+```
+{% endraw %}
+
+With this configuration, you can create a workflow that publishes your package to the Maven Central Repository by specifying the repository management `id` to the `setup-java` action. You’ll also need to provide environment variables that contain the username and password to authenticate to the repository.
+
+In the deploy step, you’ll need to set the environment variables to the username that you authenticate with to the repository, and to a secret that you’ve configured with the password or token to authenticate with.  For more information, see "[Creating and using encrypted secrets](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
+
+
+{% raw %}
+```yaml
+name: Publish package to the Maven Central Repository
+on:
+  release:
+    types: [created]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Maven Central Repository
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+          server-id: ossrh
+          server-username: MAVEN_USERNAME
+          server-password: MAVEN_PASSWORD
+      - name: Publish package
+        run: mvn -B deploy
+        env:
+          MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
+          MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}
+```
+{% endraw %}
+
+This workflow performs the following steps:
+
+1. Checks out a copy of project's repository.
+1. Sets up the Java JDK, and also configures the Maven _settings.xml_ file to add authentication for the `ossrh` repository using the `MAVEN_USERNAME` and `MAVEN_PASSWORD` environment variables.
+1. {% data reusables.github-actions.publish-to-maven-workflow-step %}
+
+   For more information about using secrets in your workflow, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
+
+### Publishing packages to {% data variables.product.prodname_registry %}
+
+Each time you create a new release, you can trigger a workflow to publish your package. The workflow in the example below runs when the `release` event triggers with type `created`. The workflow publishes the package to {% data variables.product.prodname_registry %} if CI tests pass. For more information on the `release` event, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows#release)."
+
+In this workflow, you can use the `setup-java` action. This action installs the given version of the JDK into the `PATH`, and also sets up a Maven _settings.xml_ for publishing the package to {% data variables.product.prodname_registry %}. The generated _settings.xml_ defines authentication for a server with an `id` of `github`, using the `GITHUB_ACTOR` environment variable as the username and the `GITHUB_TOKEN` environment variable as the password.
+
+The `GITHUB_TOKEN` exists in your repository by default and has read and write permissions for packages in the repository where the workflow runs. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)."
+
+For a Maven-based project, you can make use of these settings by creating a distribution repository in your _pom.xml_ file with an `id` of `github` that points to your {% data variables.product.prodname_registry %} endpoint.
+
+For example, if your organization is named "octocat" and your repository is named "hello-world", then the {% data variables.product.prodname_registry %} configuration in _pom.xml_ would look similar to the below example.
+
+{% raw %}
+```xml
+
+  ...
+  
+    
+      github
+      GitHub Packages
+      https://maven.pkg.github.com/octocat/hello-world
+    
+  
+
+```
+{% endraw %}
+
+With this configuration, you can create a workflow that publishes your package to {% data variables.product.prodname_registry %} by making use of the automatically generated _settings.xml_.
+
+{% raw %}
+```yaml
+name: Publish package to GitHub Packages
+on:
+  release:
+    types: [created]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Publish package
+        run: mvn -B deploy
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
+
+This workflow performs the following steps:
+
+1. Checks out a copy of project's repository.
+1. Sets up the Java JDK, and also automatically configures the Maven _settings.xml_ file to add authentication for the `github` Maven repository to use the `GITHUB_TOKEN` environment variable.
+1. {% data reusables.github-actions.publish-to-packages-workflow-step %}
+
+   For more information about using secrets in your workflow, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
+
+### Publishing packages to the Maven Central Repository and {% data variables.product.prodname_registry %}
+
+You can publish your packages to both the Maven Central Repository and {% data variables.product.prodname_registry %} by using the `setup-java` action for each registry.
+
+Ensure your _pom.xml_ file includes a distribution management repository for both your {% data variables.product.prodname_dotcom %} repository and your Maven Central Repository provider. For example, if you deploy to the Central Repository through the OSSRH hosting project, you might want to specify it in a distribution management repository with the `id` set to `ossrh`, and you might want to specify {% data variables.product.prodname_registry %} in a distribution management repository with the `id` set to `github`.
+
+{% raw %}
+```yaml
+name: Publish package to the Maven Central Repository and GitHub Packages
+on:
+  release:
+    types: [created]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Java for publishing to Maven Central Repository
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+          server-id: ossrh
+          server-username: MAVEN_USERNAME
+          server-password: MAVEN_PASSWORD
+      - name: Publish to the Maven Central Repository
+        run: mvn -B deploy
+        env:
+          MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
+          MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}
+      - name: Set up Java for publishing to GitHub Packages
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Publish to GitHub Packages
+        run: mvn -B deploy
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
+
+This workflow calls the `setup-java` action twice.  Each time the `setup-java` action runs, it overwrites the Maven _settings.xml_ file for publishing packages.  For authentication to the repository, the _settings.xml_ file references the distribution management repository `id`, and the username and password.
+
+This workflow performs the following steps:
+
+1. Checks out a copy of project's repository.
+1. Calls `setup-java` the first time. This configures the Maven _settings.xml_ file for the `ossrh` repository, and sets the authentication options to environment variables that are defined in the next step.
+1. {% data reusables.github-actions.publish-to-maven-workflow-step %}
+1. Calls `setup-java` the second time. This automatically configures the Maven _settings.xml_ file for {% data variables.product.prodname_registry %}.
+1. {% data reusables.github-actions.publish-to-packages-workflow-step %}
+
+   For more information about using secrets in your workflow, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
diff --git a/translations/ru-RU/content/actions/guides/publishing-nodejs-packages.md b/translations/ru-RU/content/actions/guides/publishing-nodejs-packages.md
new file mode 100644
index 000000000000..8069dc936c7d
--- /dev/null
+++ b/translations/ru-RU/content/actions/guides/publishing-nodejs-packages.md
@@ -0,0 +1,210 @@
+---
+title: Publishing Node.js packages
+intro: You can publish Node.js packages to a registry as part of your continuous integration (CI) workflow.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages
+  - /actions/language-and-framework-guides/publishing-nodejs-packages
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### Introduction
+
+This guide shows you how to create a workflow that publishes Node.js packages to the {% data variables.product.prodname_registry %} and npm registries after continuous integration (CI) tests pass. With a single workflow, you can publish packages to a single registry or multiple registries.
+
+### Требования
+
+We recommend that you have a basic understanding of workflow configuration options and how to create a workflow file. For more information, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)."
+
+For more information about creating a CI workflow for your Node.js project, see "[Using Node.js with {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions)."
+
+You may also find it helpful to have a basic understanding of the following:
+
+- "[Configuring npm for use with {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)"
+- "[Environment variables](/actions/reference/environment-variables)"
+- "[Encrypted secrets](/actions/reference/encrypted-secrets)"
+- "[Authentication in a workflow](/actions/reference/authentication-in-a-workflow)"
+
+### About package configuration
+
+ The `name` and `version` fields in the *package.json* file create a unique identifier that registries use to link your package to a registry. You can add a summary for the package listing page by including a `description` field in the *package.json* file. For more information, see "[Creating a package.json file](https://docs.npmjs.com/creating-a-package-json-file)" and "[Creating Node.js modules](https://docs.npmjs.com/creating-node-js-modules)" in the npm documentation.
+
+When a local *.npmrc* file exists and has a `registry` value specified, the `npm publish` command uses the registry configured in the *.npmrc* file. {% data reusables.github-actions.setup-node-intro %}
+
+You can specify the Node.js version installed on the runner using the `setup-node` action.
+
+If you add steps in your workflow to configure the `publishConfig` fields in your *package.json* file, you don't need to specify the registry-url using the `setup-node` action, but you will be limited to publishing the package to one registry. For more information, see "[publishConfig](https://docs.npmjs.com/files/package.json#publishconfig)" in the npm documentation.
+
+### Publishing packages to the npm registry
+
+Each time you create a new release, you can trigger a workflow to publish your package. The workflow in the example below runs when the `release` event triggers with type `created`. The workflow publishes the package to the npm registry if CI tests pass.
+
+To perform authenticated operations against the npm registry in your workflow, you'll need to store your npm authentication token as a secret in your repository settings. For example, create a secret called `NPM_TOKEN`. For more information, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
+
+By default, npm uses the `name` field of the *package.json* file to determine the npm registry. When publishing to a global namespace, you only need to include the package name. For example, you would publish a package named `npm-hello-world-test` to the `https://www.npmjs.com/package/npm-hello-world-test`.
+
+If you're publishing a package that includes a scope prefix, include the scope in the name of your *package.json* file. For example, if your npm scope prefix is octocat and the package name is hello-world, the `name` in your *package.json* file should be `@octocat/hello-world`. If your npm package uses a scope prefix and the package is public, you need to use the option `npm publish --access public`. This is an option that npm requires to prevent someone from publishing a private package unintentionally.
+
+This example stores the `NPM_TOKEN` secret in the `NODE_AUTH_TOKEN` environment variable. When the `setup-node` action creates an *.npmrc* file, it references the token from the `NODE_AUTH_TOKEN` environment variable.
+
+{% raw %}
+```yaml
+name: Node.js Package
+on:
+  release:
+    types: [created]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    # Setup .npmrc file to publish to npm
+    - uses: actions/setup-node@v1
+      with:
+        node-version: '12.x'
+        registry-url: 'https://registry.npmjs.org'
+    - run: npm install
+    - run: npm publish
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+```
+{% endraw %}
+
+In the example above, the `setup-node` action creates an *.npmrc* file on the runner with the following contents:
+
+```
+//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN}
+registry=https://registry.npmjs.org/
+always-auth=true
+```
+
+### Publishing packages to {% data variables.product.prodname_registry %}
+
+Each time you create a new release, you can trigger a workflow to publish your package. The workflow in the example below runs anytime the `release` event with type `created` occurs. The workflow publishes the package to {% data variables.product.prodname_registry %} if CI tests pass.
+
+By default, {% data variables.product.prodname_registry %} publishes a package in the {% data variables.product.prodname_dotcom %} repository you specify in the `name` field of the *package.json* file. For example, you would publish a package named `@my-org/test` to the `my-org/test` {% data variables.product.prodname_dotcom %} repository. For more information, see [`npm-scope`](https://docs.npmjs.com/misc/scope) in the npm documentation.
+
+To perform authenticated operations against the {% data variables.product.prodname_registry %} registry in your workflow, you can use the `GITHUB_TOKEN`. The `GITHUB_TOKEN` exists in your repository by default and has read and write permissions for packages in the repository where the workflow runs. For more information, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
+
+This example stores the `GITHUB_TOKEN` secret in the `NODE_AUTH_TOKEN` environment variable. When the `setup-node` action creates an *.npmrc* file, it references the token from the `NODE_AUTH_TOKEN` environment variable.
+
+{% raw %}
+```yaml
+name: Node.js Package
+on:
+  release:
+    types: [created]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    # Setup .npmrc file to publish to GitHub Packages
+    - uses: actions/setup-node@v1
+      with:
+        node-version: '12.x'
+        registry-url: 'https://npm.pkg.github.com'
+        # Defaults to the user or organization that owns the workflow file
+        scope: '@octocat'
+    - run: npm install
+    - run: npm publish
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
+
+The `setup-node` action creates an *.npmrc* file on the runner. When you use the `scope` input to the `setup-node` action, the *.npmrc* file includes the scope prefix. By default, the `setup-node` action sets the scope in the *.npmrc* file to the account that contains that workflow file.
+
+```
+//npm.pkg.github.com/:_authToken=${NODE_AUTH_TOKEN}
+@octocat:registry=https://npm.pkg.github.com
+always-auth=true
+```
+
+### Publishing packages using yarn
+
+If you use the Yarn package manager, you can install and publish packages using Yarn.
+
+{% raw %}
+```yaml
+name: Node.js Package
+on:
+  release:
+    types: [created]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    # Setup .npmrc file to publish to npm
+    - uses: actions/setup-node@v1
+      with:
+        node-version: '12.x'
+        registry-url: 'https://registry.npmjs.org'
+        # Defaults to the user or organization that owns the workflow file
+        scope: '@octocat' 
+    - run: yarn
+    - run: yarn publish
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+```
+{% endraw %}
+
+### Publishing packages to npm and {% data variables.product.prodname_registry %}
+
+{% note %}
+
+**Note:** If you need to publish to registries that have different scope prefixes, you'll need to modify the *package.json* file on the runner to change the scope prefix. For example, if you publish a package to the `@mona` scope for npm and `@octocat` scope for {% data variables.product.prodname_registry %}, you can replace the `@mona` scope with `@octocat` in the *package.json* file on the runner after publishing to npm and before publishing to {% data variables.product.prodname_registry %}.
+
+{% endnote %}
+
+You can publish your packages to both the npm registry and {% data variables.product.prodname_registry %} by using the `setup-node` action for each registry.
+
+If you publish a package to both registries, you'll need to ensure that your scope prefix on npm matches your {% data variables.product.prodname_dotcom %} user or organization name. To publish packages to a public registry with a scope prefix, you can use the command `npm publish --access public`. For more information, see [`npm-scope`](https://docs.npmjs.com/misc/scope) and "[Creating and publishing scoped public packages](https://docs.npmjs.com/creating-and-publishing-scoped-public-packages)" in the npm documentation.
+
+Ensure your *package.json* file includes the scope of your {% data variables.product.prodname_dotcom %} repository and npm registry. For example, if you plan to publish a package in the `octocat/npm-hello-world-test` repository to {% data variables.product.prodname_dotcom %} and https://www.npmjs.com/package/@octocat/npm-hello-world-test, the name in your *package.json* file would be `"name": "@octocat/npm-hello-world-test"`.
+
+To perform authenticated operations against the {% data variables.product.prodname_registry %} registry in your workflow, you can use the `GITHUB_TOKEN`. The `GITHUB_TOKEN` exists in your repository by default and has read and write permissions for packages in the repository where the workflow runs. For more information, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."
+
+When you use the `scope` input to the `setup-node` action, the action creates an *.npmrc* file that includes the scope prefix. By default, the `setup-node` action sets the scope in the *.npmrc* file to the user or organization that owns the workflow file.
+
+This workflow calls the `setup-node` action two times. Each time the `setup-node` action runs, it overwrites the *.npmrc* file. The *.npmrc* file references the token that allows you to perform authenticated operations against the package registry from the `NODE_AUTH_TOKEN` environment variable. The workflow sets the `NODE_AUTH_TOKEN` environment variable each time the `npm publish` command is run, first with a token to publish to npm (`NPM_TOKEN`) and then with a token to publish to {% data variables.product.prodname_registry %} (`GITHUB_TOKEN`).
+
+{% raw %}
+```yaml
+name: Node.js Package
+on:
+  release:
+    types: [created]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    # Setup .npmrc file to publish to npm
+    - uses: actions/setup-node@v1
+      with:
+        node-version: '10.x'
+        registry-url: 'https://registry.npmjs.org'
+    - run: npm install
+    # Publish to npm
+    - run: npm publish --access public
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+    # Setup .npmrc file to publish to GitHub Packages
+    - uses: actions/setup-node@v1
+      with:
+        registry-url: 'https://npm.pkg.github.com'
+        # Defaults to the user or organization that owns the workflow file
+        scope: '@octocat'
+    # Publish to GitHub Packages
+    - run: npm publish
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
diff --git a/translations/ru-RU/content/actions/guides/setting-up-continuous-integration-using-workflow-templates.md b/translations/ru-RU/content/actions/guides/setting-up-continuous-integration-using-workflow-templates.md
new file mode 100644
index 000000000000..b04280b5701c
--- /dev/null
+++ b/translations/ru-RU/content/actions/guides/setting-up-continuous-integration-using-workflow-templates.md
@@ -0,0 +1,43 @@
+---
+title: Setting up continuous integration using workflow templates
+shortTitle: Setting up CI using templates
+intro: You can set up continuous integration for your project using a workflow template that matches the language and tooling you want to use.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /articles/setting-up-continuous-integration-using-github-actions
+  - /github/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions
+  - /actions/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions
+  - /actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+Anyone with write permission to a repository can set up continuous integration (CI) using {% data variables.product.prodname_actions %}.
+
+After you set up CI, you can customize the workflow to meet your needs.
+
+{% data reusables.repositories.navigate-to-repo %}
+{% data reusables.repositories.actions-tab %}
+1. Find the template that matches the language and tooling you want to use, then click **Set up this workflow**. ![Setup workflow button](/assets/images/help/repository/setup-workflow-button.png)
+5. Click **Start commit**. ![Start commit button](/assets/images/help/repository/start-commit.png)
+{% data reusables.files.write_commit_message %}
+{% data reusables.files.choose_commit_branch %}
+{% data reusables.files.propose_new_file %}
+
+Once a push is made to your repository, you can follow the status and detailed logs of your continuous integration workflow run on {% data variables.product.prodname_dotcom %} and receive customized notifications. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)" and "[Managing a workflow run](/articles/managing-a-workflow-run)."
+
+{% data reusables.repositories.actions-workflow-status-badge-into %}
+
+For more information, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)."
+
+### Дополнительная литература
+
+- "[About continuous integration](/articles/about-continuous-integration)"
+- "[Managing a workflow run](/articles/managing-a-workflow-run)"
+{% if currentVersion == "free-pro-team@latest" %}
+- "[Managing billing for {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)"
+{% endif %}
diff --git a/translations/ru-RU/content/actions/guides/storing-workflow-data-as-artifacts.md b/translations/ru-RU/content/actions/guides/storing-workflow-data-as-artifacts.md
new file mode 100644
index 000000000000..e90cba6cb88f
--- /dev/null
+++ b/translations/ru-RU/content/actions/guides/storing-workflow-data-as-artifacts.md
@@ -0,0 +1,249 @@
+---
+title: Storing workflow data as artifacts
+shortTitle: Storing workflow artifacts
+intro: Artifacts allow you to share data between jobs in a workflow and store data once that workflow has completed.
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /articles/persisting-workflow-data-using-artifacts
+  - /github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts
+  - /actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts
+  - /actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### About workflow artifacts
+
+Artifacts allow you to persist data after a job has completed, and share that data with another job in the same workflow. An artifact is a file or collection of files produced during a workflow run. For example, you can use artifacts to save your build and test output after a workflow run has ended.
+
+{% data reusables.github-actions.artifact-log-retention-statement %} The retention period for a pull request restarts each time someone pushes a new commit to the pull request.
+
+These are some of the common artifacts that you can upload:
+
+- Log files and core dumps
+- Test results, failures, and screenshots
+- Binary or compressed files
+- Stress test performance output and code coverage results
+
+{% if currentVersion == "free-pro-team@latest" %}
+
+Storing artifacts uses storage space on {% data variables.product.product_name %}. {% data reusables.github-actions.actions-billing %} For more information, see "[Managing billing for {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)."
+
+{% else %}
+
+Artifacts consume storage space on the external blob storage that is configured for {% data variables.product.prodname_actions %} on {% data variables.product.product_location %}.
+
+{% endif %}
+
+Artifacts are uploaded during a workflow run, and you can view an artifact's name and size in the UI. When an artifact is downloaded using the {% data variables.product.product_name %} UI, all files that were individually uploaded as part of the artifact get zipped together into a single file. This means that billing is calculated based on the size of the uploaded artifact and not the size of the zip file.
+
+{% data variables.product.product_name %} provides two actions that you can use to upload and download build artifacts. For more information, see the {% if currentVersion == "free-pro-team@latest" %}[actions/upload-artifact](https://github.com/actions/upload-artifact) and [download-artifact](https://github.com/actions/download-artifact) actions{% else %} `actions/upload-artifact` and `download-artifact` actions on {% data variables.product.product_location %}{% endif %}.
+
+To share data between jobs:
+
+* **Uploading files**: Give the uploaded file a name and upload the data before the job ends.
+* **Downloading files**: You can only download artifacts that were uploaded during the same workflow run. When you download a file, you can reference it by name.
+
+The steps of a job share the same environment on the runner machine, but run in their own individual processes. To pass data between steps in a job, you can use inputs and outputs. For more information about inputs and outputs, see "[Metadata syntax for {% data variables.product.prodname_actions %}](/articles/metadata-syntax-for-github-actions)."
+
+### Uploading build and test artifacts
+
+You can create a continuous integration (CI) workflow to build and test your code. For more information about using {% data variables.product.prodname_actions %} to perform CI, see "[About continuous integration](/articles/about-continuous-integration)."
+
+The output of building and testing your code often produces files you can use to debug test failures and production code that you can deploy. You can configure a workflow to build and test the code pushed to your repository and report a success or failure status. You can upload the build and test output to use for deployments, debugging failed tests or crashes, and viewing test suite coverage.
+
+You can use the `upload-artifact` action to upload artifacts. When uploading an artifact, you can specify a single file or directory, or multiple files or directories. You can also exclude certain files or directories, and use wildcard patterns. We recommend that you provide a name for an artifact, but if no name is provided then `artifact` will be used as the default name. For more information on syntax, see the {% if currentVersion == "free-pro-team@latest" %}[actions/upload-artifact](https://github.com/actions/upload-artifact) action{% else %} `actions/upload-artifact` action on {% data variables.product.product_location %}{% endif %}.
+
+#### Пример
+
+For example, your repository or a web application might contain SASS and TypeScript files that you must convert to CSS and JavaScript. Assuming your build configuration outputs the compiled files in the `dist` directory, you would deploy the files in the `dist` directory to your web application server if all tests completed successfully.
+
+```
+|-- hello-world (repository)
+|   └── dist
+|   └── tests
+|   └── src
+|       └── sass/app.scss
+|       └── app.ts
+|   └── output
+|       └── test
+|   
+```
+
+This example shows you how to create a workflow for a Node.js project that `builds` the code in the `src` directory and runs the tests in the `tests` directory. You can assume that running `npm test` produces a code coverage report named `code-coverage.html` stored in the `output/test/` directory.
+
+The workflow uploads the production artifacts in the `dist` directory, but excludes any markdown files. It also and uploads the `code-coverage.html` report as another artifact.
+
+```yaml
+name: Node CI
+
+on: [push]
+
+jobs:
+  build_and_test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v2
+      - name: npm install, build, and test
+        run: |
+          npm install
+          npm run build --if-present
+          npm test
+      - name: Archive production artifacts
+        uses: actions/upload-artifact@v2
+        with:
+          name: dist-without-markdown
+          path: |
+            dist
+            !dist/**/*.md
+      - name: Archive code coverage results
+        uses: actions/upload-artifact@v2
+        with:
+          name: code-coverage-report
+          path: output/test/code-coverage.html
+```
+
+![Image of workflow upload artifact workflow run](/assets/images/help/repository/upload-build-test-artifact.png)
+
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+### Configuring a custom artifact retention period
+
+You can define a custom retention period for individual artifacts created by a workflow. When using a workflow to create a new artifact, you can use `retention-days` with the `upload-artifact` action. This example demonstrates how to set a custom retention period of 5 days for the artifact named `my-artifact`:
+
+```
+  - name: 'Upload Artifact'
+    uses: actions/upload-artifact@v2
+    with:
+      name: my-artifact
+      path: my_file.txt
+      retention-days: 5
+```
+
+The `retention-days` value cannot exceed the retention limit set by the repository, organization, or enterprise.
+{% endif %}
+
+### Downloading or deleting artifacts
+
+During a workflow run, you can use the [`download-artifact`](https://github.com/actions/download-artifact)action to download artifacts that were previously uploaded in the same workflow run.
+
+After a workflow run has been completed, you can download or delete artifacts on {% data variables.product.prodname_dotcom %} or using the REST API. For more information, see "[Downloading workflow artifacts](/actions/managing-workflow-runs/downloading-workflow-artifacts)," "[Removing workflow artifacts](/actions/managing-workflow-runs/removing-workflow-artifacts)," and the "[Artifacts REST API](/v3/actions/artifacts/)."
+
+#### Downloading artifacts during a workflow run
+
+The [`actions/download-artifact`](https://github.com/actions/download-artifact) action can be used to download previously uploaded artifacts during a workflow run.
+
+{% note %}
+
+**Note:** You can only download artifacts in a workflow that were uploaded during the same workflow run.
+
+{% endnote %}
+
+Specify an artifact's name to download an individual artifact. If you uploaded an artifact without specifying a name, the default name is `artifact`.
+
+```yaml
+- name: Download a single artifact
+  uses: actions/download-artifact@v2
+  with:
+    name: my-artifact
+```
+
+You can also download all artifacts in a workflow run by not specifying a name. This can be useful if you are working with lots of artifacts.
+
+```yaml
+- name: Download all workflow run artifacts
+  uses: actions/download-artifact@v2
+```
+
+If you download all a workflow run's artifacts, a directory for each artifact is created using its name.
+
+For more information on syntax, see the {% if currentVersion == "free-pro-team@latest" %}[actions/download-artifact](https://github.com/actions/download-artifact) action{% else %} `actions/download-artifact` action on {% data variables.product.product_location %}{% endif %}.
+
+### Passing data between jobs in a workflow
+
+You can use the `upload-artifact` and `download-artifact` actions to share data between jobs in a workflow. This example workflow illustrates how to pass data between jobs in the same workflow. For more information, see the {% if currentVersion == "free-pro-team@latest" %}[actions/upload-artifact](https://github.com/actions/upload-artifact) and [download-artifact](https://github.com/actions/download-artifact) actions{% else %} `actions/upload-artifact` and `download-artifact` actions on {% data variables.product.product_location %}{% endif %}.
+
+Jobs that are dependent on a previous job's artifacts must wait for the dependent job to complete successfully. This workflow uses the `needs` keyword to ensure that `job_1`, `job_2`, and `job_3` run sequentially. For example, `job_2` requires `job_1` using the `needs: job_1` syntax.
+
+Job 1 performs these steps:
+- Performs a math calculation and saves the result to a text file called `math-homework.txt`.
+- Uses the `upload-artifact` action to upload the `math-homework.txt` file with the name `homework`. The action places the file in a directory named `homework`.
+
+Job 2 uses the result in the previous job:
+- Downloads the `homework` artifact uploaded in the previous job. By default, the `download-artifact` action downloads artifacts to the workspace directory that the step is executing in. You can use the `path` input parameter to specify a different download directory.
+- Reads the value in the `homework/math-homework.txt` file, performs a math calculation, and saves the result to `math-homework.txt`.
+- Uploads the `math-homework.txt` file. This upload overwrites the previous upload because both of the uploads share the same name.
+
+Job 3 displays the result uploaded in the previous job:
+- Downloads the `homework` artifact.
+- Prints the result of the math equation to the log.
+
+The full math operation performed in this workflow example is `(3 + 7) x 9 = 90`.
+
+```yaml
+name: Share data between jobs
+
+on: [push]
+
+jobs:
+  job_1:
+    name: Add 3 and 7
+    runs-on: ubuntu-latest
+    steps:
+      - shell: bash
+        run: |
+          expr 3 + 7 > math-homework.txt
+      - name: Upload math result for job 1
+        uses: actions/upload-artifact@v2
+        with:
+          name: homework
+          path: math-homework.txt
+
+  job_2:
+    name: Multiply by 9
+    needs: job_1
+    runs-on: windows-latest
+    steps:
+      - name: Download math result for job 1
+        uses: actions/download-artifact@v2
+        with:
+          name: homework
+      - shell: bash
+        run: |
+          value=`cat math-homework.txt`
+          expr $value \* 9 > math-homework.txt
+      - name: Upload math result for job 2
+        uses: actions/upload-artifact@v2
+        with:
+          name: homework
+          path: math-homework.txt
+
+  job_3:
+    name: Display results
+    needs: job_2
+    runs-on: macOS-latest
+    steps:
+      - name: Download math result for job 2
+        uses: actions/download-artifact@v2
+        with:
+          name: homework
+      - name: Print the final result
+        shell: bash
+        run: |
+          value=`cat math-homework.txt`
+          echo The result is $value
+```
+
+![Workflow that passes data between jobs to perform math](/assets/images/help/repository/passing-data-between-jobs-in-a-workflow.png)
+
+{% if currentVersion == "free-pro-team@latest" %}
+
+### Дополнительная литература
+
+- "[Managing billing for {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)".
+
+{% endif %}
diff --git a/translations/ru-RU/content/actions/hosting-your-own-runners/about-self-hosted-runners.md b/translations/ru-RU/content/actions/hosting-your-own-runners/about-self-hosted-runners.md
index b39d493c1b77..48ba5968ca2a 100644
--- a/translations/ru-RU/content/actions/hosting-your-own-runners/about-self-hosted-runners.md
+++ b/translations/ru-RU/content/actions/hosting-your-own-runners/about-self-hosted-runners.md
@@ -53,6 +53,15 @@ You can use any machine as a self-hosted runner as long at it meets these requir
 * The machine has enough hardware resources for the type of workflows you plan to run. The self-hosted runner application itself only requires minimal resources.
 * If you want to run workflows that use Docker container actions or service containers, you must use a Linux machine and Docker must be installed.
 
+### Usage limits
+
+There are some limits on {% data variables.product.prodname_actions %} usage when using self-hosted runners. These limits are subject to change.
+
+{% data reusables.github-actions.usage-workflow-run-time %}
+- **Job queue time** - Each job for self-hosted runners can be queued for a maximum of 24 hours. If a self-hosted runner does not start executing the job within this limit, the job is terminated and fails to complete.
+{% data reusables.github-actions.usage-api-requests %}
+- **Job matrix** - {% data reusables.github-actions.usage-matrix-limits %}
+
 ### Supported operating systems for self-hosted runners
 
 The following operating systems are supported for the self-hosted runner application.
diff --git a/translations/ru-RU/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md b/translations/ru-RU/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md
index 3a13f56de726..6f0d8a18b8c3 100644
--- a/translations/ru-RU/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md
+++ b/translations/ru-RU/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md
@@ -51,7 +51,8 @@ You can add self-hosted runners to an enterprise, where they can be assigned to
 {% if currentVersion == "free-pro-team@latest" %}
 To add a self-hosted runner to an enterprise account, you must be an enterprise owner.
 {% else if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21"%}
-To add a self-hosted runner at the enterprise level of {% data variables.product.product_location %}, you must be a site administrator.
+To add a self-hosted runner at the enterprise level of
+{% data variables.product.product_location %}, you must be a site administrator.
 {% endif %}
 
 {% if currentVersion == "free-pro-team@latest" %}
diff --git a/translations/ru-RU/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md b/translations/ru-RU/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md
index 71635dcb18cd..58f8548dc79c 100644
--- a/translations/ru-RU/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md
+++ b/translations/ru-RU/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md
@@ -63,7 +63,8 @@ To remove a self-hosted runner from an organization, you must be an organization
 {% if currentVersion == "free-pro-team@latest" %}
 To remove a self-hosted runner from an enterprise account, you must be an enterprise owner. We recommend that you also have access to the self-hosted runner machine.
 {% else if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21"%}
-To remove a self-hosted runner at the enterprise level of {% data variables.product.product_location %}, you must be a site administrator. We recommend that you also have access to the self-hosted runner machine.
+To remove a self-hosted runner at the enterprise level of
+{% data variables.product.product_location %}, you must be a site administrator. We recommend that you also have access to the self-hosted runner machine.
 {% endif %}
 
 {% data reusables.github-actions.self-hosted-runner-reusing %}
diff --git a/translations/ru-RU/content/actions/index.md b/translations/ru-RU/content/actions/index.md
index 6c53c5366e44..888048e716a2 100644
--- a/translations/ru-RU/content/actions/index.md
+++ b/translations/ru-RU/content/actions/index.md
@@ -33,8 +33,8 @@ versions:
 
 
 
-
        
-  
        
+
        
+  
        
     
        
       
        {% data ui.toc.getting_started %}
        
     
        
@@ -45,7 +45,7 @@ versions:
    -
    +

    {% data ui.toc.popular_articles %}

    @@ -56,7 +56,7 @@ versions:
    -
    +

    Manage workflows

    @@ -68,22 +68,28 @@ versions:
    -
    - -
    {% octicon "bookmark" width="24" %}
    -

    Create actions

    -

    A complete guide to creating and sharing actions with the community.

    -     - -
    {% octicon "rocket" width="24" %}
    -

    Starter workflows

    -

    A collection of workflow files to help you get started with GitHub Actions.

    -     - -
    {% octicon "light-bulb" width="24" %}
    -

    GitHub Actions Marketplace

    -

    Explore community actions and supercharge your workflow.

    -     +
    +
    + +
    {% octicon "bookmark" width="24" %}
    +

    Create actions

    +

    A complete guide to creating and sharing actions with the community.

    +     +
    +
    + +
    {% octicon "rocket" width="24" %}
    +

    Starter workflows

    +

    A collection of workflow files to help you get started with GitHub Actions.

    +     +
    +
    + +
    {% octicon "light-bulb" width="24" %}
    +

    GitHub Actions Marketplace

    +

    Explore community actions and supercharge your workflow.

    +     +
    @@ -91,7 +97,7 @@ versions:

    Руководства

    -
    +

    Building and testing Node.js

    @@ -107,7 +113,7 @@ versions:
    -
    +

    Building and testing Python

    @@ -123,7 +129,7 @@ versions:
    -
    +

    Building and testing Java with Maven

    @@ -139,7 +145,7 @@ versions:
    -
    +

    Building and testing Java with Gradle

    @@ -155,7 +161,7 @@ versions:
    -
    +

    Building and testing Java with Ant

    @@ -171,7 +177,7 @@ versions:
    -
    +

    Publishing Node.js packages

    diff --git a/translations/ru-RU/content/actions/learn-github-actions/essential-features-of-github-actions.md b/translations/ru-RU/content/actions/learn-github-actions/essential-features-of-github-actions.md new file mode 100644 index 000000000000..3ae109ef0fe1 --- /dev/null +++ b/translations/ru-RU/content/actions/learn-github-actions/essential-features-of-github-actions.md @@ -0,0 +1,95 @@ +--- +title: Essential features of GitHub Actions +shortTitle: Essential features +intro: '{% data variables.product.prodname_actions %} are designed to help you build robust and dynamic automations. This guide will show you how to craft {% data variables.product.prodname_actions %} workflows that include environment variables, customized scripts, and more.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Обзор + +{% data variables.product.prodname_actions %} allow you to customize your workflows to meet the unique needs of your application and team. In this guide, we'll discuss some of the essential customization techniques such as using variables, running scripts, and sharing data and artifacts between jobs. + +### Using variables in your workflows + +{% data variables.product.prodname_actions %} include default environment variables for each workflow run. If you need to use custom environment variables, you can set these in your YAML workflow file. This example demonstrates how to create custom variables named `POSTGRES_HOST` and `POSTGRES_PORT`. These variables are then available to the `node client.js` script. + +```yaml +jobs: + example-job: + steps: + - name: Connect to PostgreSQL + run: node client.js + env: + POSTGRES_HOST: postgres + POSTGRES_PORT: 5432 +``` + +For more information, see "[Using environment variables](/actions/configuring-and-managing-workflows/using-environment-variables)." + +### Adding scripts to your workflow + +You can use actions to run scripts and shell commands, which are then executed on the assigned runner. This example demonstrates how an action can use the `run` keyword to execute `npm install -g bats` on the runner. + +```yaml +jobs: + example-job: + steps: + - run: npm install -g bats +``` + +For example, to run a script as an action, you can store the script in your repository and supply the path and shell type. + +```yaml +jobs: + example-job: + steps: + - name: Run build script + run: ./.github/scripts/build.sh + shell: bash +``` + +For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)." + +### Sharing data between jobs + +If your job generates files that you want to share with another job in the same workflow, or if you want to save the files for later reference, you can store them in {% data variables.product.prodname_dotcom %} as _artifacts_. Artifacts are the files created when you build and test your code. For example, artifacts might include binary or package files, test results, screenshots, or log files. Artifacts are associated with the workflow run where they were created and can be used by another job. + +For example, you can create a file and then upload it as an artifact. + +```yaml +jobs: + example-job: + name: Save output + steps: + - shell: bash + run: | + expr 1 + 1 > output.log + - name: Upload output file + uses: actions/upload-artifact@v1 + with: + name: output-log-file + path: output.log +``` + +To download an artifact from a separate workflow run, you can use the `actions/download-artifact` action. For example, you can download the artifact named `output-log-file`. + +```yaml +jobs: + example-job: + steps: + - name: Download a single artifact + uses: actions/download-artifact@v2 + with: + name: output-log-file +``` + +For more information about artifacts, see "[Persisting workflow data using artifacts](/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts)." + +### Дальнейшие шаги + +To continue learning about {% data variables.product.prodname_actions %}, see "[Managing complex workflows](/actions/learn-github-actions/managing-complex-workflows)." diff --git a/translations/ru-RU/content/actions/learn-github-actions/finding-and-customizing-actions.md b/translations/ru-RU/content/actions/learn-github-actions/finding-and-customizing-actions.md new file mode 100644 index 000000000000..1a0f46db9f63 --- /dev/null +++ b/translations/ru-RU/content/actions/learn-github-actions/finding-and-customizing-actions.md @@ -0,0 +1,156 @@ +--- +title: Finding and customizing actions +shortTitle: Finding and customizing actions +intro: 'Actions are the building blocks that power your workflow. A workflow can contain actions created by the community, or you can create your own actions directly within your application''s repository. This guide will show you how to discover, use, and customize actions.' +redirect_from: + - /actions/automating-your-workflow-with-github-actions/using-github-marketplace-actions + - /actions/automating-your-workflow-with-github-actions/using-actions-from-github-marketplace-in-your-workflow + - /actions/getting-started-with-github-actions/using-actions-from-github-marketplace + - /actions/getting-started-with-github-actions/using-community-workflows-and-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Обзор + +The actions you use in your workflow can be defined in: + +- A public repository +- The same repository where your workflow file references the action +- A published Docker container image on Docker Hub + +{% data variables.product.prodname_marketplace %} is a central location for you to find actions created by the {% data variables.product.prodname_dotcom %} community. [{% data variables.product.prodname_marketplace %} page](https://github.com/marketplace/actions/) enables you to filter for actions by category. + +{% data reusables.actions.enterprise-marketplace-actions %} + +### Browsing Marketplace actions in the workflow editor + +You can search and browse actions directly in your repository's workflow editor. From the sidebar, you can search for a specific action, view featured actions, and browse featured categories. You can also view the number of stars an action has received from the {% data variables.product.prodname_dotcom %} community. + +1. In your repository, browse to the workflow file you want to edit. +1. In the upper right corner of the file view, to open the workflow editor, click {% octicon "pencil" aria-label="The edit icon" %}. ![Edit workflow file button](/assets/images/help/repository/actions-edit-workflow-file.png) +1. To the right of the editor, use the {% data variables.product.prodname_marketplace %} sidebar to browse actions. Actions with the {% octicon "verified" aria-label="The verified badge" %} badge indicate {% data variables.product.prodname_dotcom %} has verified the creator of the action as a partner organization. ![Marketplace workflow sidebar](/assets/images/help/repository/actions-marketplace-sidebar.png) + +### Adding an action to your workflow + +An action's listing page includes the action's version and the workflow syntax required to use the action. To keep your workflow stable even when updates are made to an action, you can reference the version of the action to use by specifying the Git or Docker tag number in your workflow file. + +1. Navigate to the action you want to use in your workflow. +1. Under "Installation", click {% octicon "clippy" aria-label="The edit icon" %} to copy the workflow syntax. ![View action listing](/assets/images/help/repository/actions-sidebar-detailed-view.png) +1. Paste the syntax as a new step in your workflow. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idsteps)." +1. If the action requires you to provide inputs, set them in your workflow. For information on inputs an action might require, see "[Using inputs and outputs with an action](/actions/learn-github-actions/finding-and-customizing-actions#using-inputs-and-outputs-with-an-action)." + +{% if currentVersion == "free-pro-team@latest" %} + +{% data reusables.dependabot.version-updates-for-actions %} + +{% endif %} + +### Using release management for your custom actions + +The creators of a community action have the option to use tags, branches, or SHA values to manage releases of the action. Similar to any dependency, you should indicate the version of the action you'd like to use based on your comfort with automatically accepting updates to the action. + +You will designate the version of the action in your workflow file. Check the action's documentation for information on their approach to release management, and to see which tag, branch, or SHA value to use. + +#### Using tags + +Tags are useful for letting you decide when to switch between major and minor versions, but these are more ephemeral and can be moved or deleted by the maintainer. This example demonstrates how to target an action that's been tagged as `v1.0.1`: + +```yaml +steps: + - uses: actions/javascript-action@v1.0.1 +``` + +#### Using SHAs + +If you need more reliable versioning, you should use the SHA value associated with the version of the action. SHAs are immutable and therefore more reliable than tags or branches. However this approach means you will not automatically receive updates for an action, including important bug fixes and security updates. This example targets an action's SHA: + +```yaml +steps: + - uses: actions/javascript-action@172239021f7ba04fe7327647b213799853a9eb89 +``` + +#### Using branches + +Referring to a specific branch means that the action will always use include the latest updates on the target branch, but can create problems if those updates include breaking changes. This example targets a branch named `@main`: + +```yaml +steps: + - uses: actions/javascript-action@main +``` + +For more information, see "[Using release management for actions](/actions/creating-actions/about-actions#using-release-management-for-actions)." + +### Using inputs and outputs with an action + +An action often accepts or requires inputs and generates outputs that you can use. For example, an action might require you to specify a path to a file, the name of a label, or other data it will uses as part of the action processing. + +To see the inputs and outputs of an action, check the `action.yml` or `action.yaml` in the root directory of the repository. + +In this example `action.yml`, the `inputs` keyword defines a required input called `file-path`, and includes a default value that will be used if none is specified. The `outputs` keyword defines an output called `results-file`, which tells you where to locate the results. + +```yaml +name: 'Example' +description: 'Receives file and generates output' +inputs: + file-path: # id of input + description: "Path to test script" + required: true + default: 'test-file.js' +outputs: + results-file: # id of output + description: "Path to results file" +``` + +### Referencing an action in the same repository where a workflow file uses the action + +If an action is defined in the same repository where your workflow file uses the action, you can reference the action with either the ‌`{owner}/{repo}@{ref}` or `./path/to/dir` syntax in your workflow file. + +Example repository file structure: + +``` +|-- hello-world (repository) +| |__ .github +| └── workflows +| └── my-first-workflow.yml +| └── actions +| |__ hello-world-action +| └── action.yml +``` + +Example workflow file: + +```yaml +jobs: + build: + runs-on: ubuntu-latest + steps: + # This step checks out a copy of your repository. + - uses: actions/checkout@v2 + # This step references the directory that contains the action. + - uses: ./.github/actions/hello-world-action +``` + +The `action.yml` file is used to provide metadata for the action. Learn about the content of this file in "[Metadata syntax for GitHub Actions](/actions/creating-actions/metadata-syntax-for-github-actions)" + +### Referencing a container on Docker Hub + +If an action is defined in a published Docker container image on Docker Hub, you must reference the action with the `docker://{image}:{tag}` syntax in your workflow file. To protect your code and data, we strongly recommend you verify the integrity of the Docker container image from Docker Hub before using it in your workflow. + +```yaml +jobs: + my_first_job: + steps: + - name: My first step + uses: docker://alpine:3.8 +``` + +For some examples of Docker actions, see the [Docker-image.yml workflow](https://github.com/actions/starter-workflows/blob/main/ci/docker-image.yml) and "[Creating a Docker container action](/articles/creating-a-docker-container-action)." + +### Дальнейшие шаги + +To continue learning about {% data variables.product.prodname_actions %}, see "[Essential features of {% data variables.product.prodname_actions %}](/actions/learn-github-actions/essential-features-of-github-actions)." diff --git a/translations/ru-RU/content/actions/learn-github-actions/index.md b/translations/ru-RU/content/actions/learn-github-actions/index.md new file mode 100644 index 000000000000..8bc97d038f8e --- /dev/null +++ b/translations/ru-RU/content/actions/learn-github-actions/index.md @@ -0,0 +1,42 @@ +--- +title: Learn GitHub Actions +shortTitle: Learn GitHub Actions +intro: 'Whether you are new to {% data variables.product.prodname_actions %} or interested in learning all they have to offer, this guide will help you use {% data variables.product.prodname_actions %} to accelerate your application development workflows.' +redirect_from: + - /articles/about-github-actions + - /github/automating-your-workflow-with-github-actions/about-github-actions + - /actions/automating-your-workflow-with-github-actions/about-github-actions + - /actions/getting-started-with-github-actions + - /actions/getting-started-with-github-actions/about-github-actions + - /actions/getting-started-with-github-actions/overview + - /actions/getting-started-with-github-actions/getting-started-with-github-actions + - /articles/migrating-github-actions-from-hcl-syntax-to-yaml-syntax/ + - /actions/configuring-and-managing-workflows/configuring-a-workflow + - /articles/creating-a-workflow-with-github-actions/ + - /articles/configuring-a-workflow + - /github/automating-your-workflow-with-github-actions/configuring-a-workflow + - /actions/automating-your-workflow-with-github-actions/configuring-a-workflow + - /actions/creating-workflows/workflow-configuration-options + - /articles/configuring-workflows + - /github/automating-your-workflow-with-github-actions/configuring-workflows + - /actions/automating-your-workflow-with-github-actions/configuring-workflows + - /github/automating-your-workflow-with-github-actions/getting-started-with-github-actions + - /actions/automating-your-workflow-with-github-actions/getting-started-with-github-actions + - /actions/configuring-and-managing-workflows + - /articles/getting-started-with-github-actions + - /actions/migrating-to-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% link_with_intro /introduction-to-github-actions %} +{% link_with_intro /finding-and-customizing-actions %} +{% link_with_intro /essential-features-of-github-actions %} +{% link_with_intro /managing-complex-workflows %} +{% link_with_intro /sharing-workflows-with-your-organization %} +{% link_with_intro /security-hardening-for-github-actions %} +{% link_with_intro /migrating-from-circleci-to-github-actions %} +{% link_with_intro /migrating-from-gitlab-cicd-to-github-actions %} +{% link_with_intro /migrating-from-azure-pipelines-to-github-actions %} +{% link_with_intro /migrating-from-jenkins-to-github-actions %} diff --git a/translations/ru-RU/content/actions/learn-github-actions/introduction-to-github-actions.md b/translations/ru-RU/content/actions/learn-github-actions/introduction-to-github-actions.md new file mode 100644 index 000000000000..3aa06bf3e1a7 --- /dev/null +++ b/translations/ru-RU/content/actions/learn-github-actions/introduction-to-github-actions.md @@ -0,0 +1,225 @@ +--- +title: Introduction to GitHub Actions +shortTitle: Introduction to GitHub Actions +intro: 'Learn about the core concepts and various components of {% data variables.product.prodname_actions %}, and see an example that shows you how to add automation to your repository.' +redirect_from: + - /github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions + - /actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions + - /actions/getting-started-with-github-actions/core-concepts-for-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Обзор + +{% data variables.product.prodname_actions %} help you automate tasks within your software development life cycle. {% data variables.product.prodname_actions %} are event-driven, meaning that you can run a series of commands after a specified event has occurred. For example, every time someone creates a pull request for a repository, you can automatically run a command that executes a software testing script. + +This diagram demonstrates how you can use {% data variables.product.prodname_actions %} to automatically run your software testing scripts. An event automatically triggers the _workflow_, which contains a _job_. The job then uses _steps_ to control the order in which _actions_ are run. These actions are the commands that automate your software testing. + +![Workflow overview](/assets/images/help/images/overview-actions-simple.png) + +### The components of {% data variables.product.prodname_actions %} + +Below is a list of the multiple {% data variables.product.prodname_actions %} components that work together to run jobs. You can see how these components interact with each other. + +![Component and service overview](/assets/images/help/images/overview-actions-design.png) + +#### Workflows + +The workflow is an automated procedure that you add to your repository. Workflows are made up of one or more jobs and can be scheduled or triggered by an event. The workflow can be used to build, test, package, release, or deploy a project on {% data variables.product.prodname_dotcom %}. + +#### События + +An event is a specific activity that triggers a workflow. For example, activity can originate from {% data variables.product.prodname_dotcom %} when someone pushes a commit to a repository or when an issue or pull request is created. You can also use the repository dispatch webhook to trigger a workflow when an external event occurs. For a complete list of events that can be used to trigger workflows, see [Events that trigger workflows](/actions/reference/events-that-trigger-workflows). + +#### Jobs + +A job is a set of steps that execute on the same runner. By default, a workflow with multiple jobs will run those jobs in parallel. You can also configure a workflow to run jobs sequentially. For example, a workflow can have two sequential jobs that build and test code, where the test job is dependent on the status of the build job. If the build job fails, the test job will not run. + +#### Steps + +A step is an individual task that can run commands (known as _actions_). Each step in a job executes on the same runner, allowing the actions in that job to share data with each other. + +#### Actions + +_Actions_ are standalone commands that are combined into _steps_ to create a _job_. Actions are the smallest portable building block of a workflow. You can create your own actions, or use actions created by the {% data variables.product.prodname_dotcom %} community. To use an action in a workflow, you must include it as a step. + +#### Runners + +A runner is a server that has the {% data variables.product.prodname_actions %} runner application installed. You can use a runner hosted by {% data variables.product.prodname_dotcom %}, or you can host your own. A runner listens for available jobs, runs one job at a time, and reports the progress, logs, and results back to {% data variables.product.prodname_dotcom %}. For {% data variables.product.prodname_dotcom %}-hosted runners, each job in a workflow runs in a fresh virtual environment. + +{% data variables.product.prodname_dotcom %}-hosted runners are based on Ubuntu Linux, Microsoft Windows, and macOS. For information on {% data variables.product.prodname_dotcom %}-hosted runners, see "[Virtual environments for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/virtual-environments-for-github-hosted-runners)." If you need a different operating system or require a specific hardware configuration, you can host your own runners. For information on self-hosted runners, see "[Hosting your own runners](/actions/hosting-your-own-runners)." + +### Create an example workflow + +{% data variables.product.prodname_actions %} uses YAML syntax to define the events, jobs, and steps. These YAML files are stored in your code repository, in a directory called `.github/workflows`. + +You can create an example workflow in your repository that automatically triggers a series of commands whenever code is pushed. In this workflow, {% data variables.product.prodname_actions %} checks out the pushed code, installs the software dependencies, and runs `bats -v`. + +1. In your repository, create the `.github/workflows/` directory to store your workflow files. +1. In the `.github/workflows/` directory, create a new file called `learn-github-actions.yml` and add the following code. + ```yaml + name: learn-github-actions + on: [push] + jobs: + check-bats-version: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - uses: actions/setup-node@v1 + - run: npm install -g bats + - run: bats -v + ``` +1. Commit these changes and push them to your {% data variables.product.prodname_dotcom %} repository. + +Your new {% data variables.product.prodname_actions %} workflow file is now installed in your repository and will run automatically each time someone pushes a change to the repository. For details about a job's execution history, see "[Viewing the workflow's activity](/actions/learn-github-actions/introduction-to-github-actions#viewing-the-jobs-activity)." + +### Understanding the workflow file + +To help you understand how YAML syntax is used to create a workflow file, this section explains each line of the introduction's example: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + + ```yaml + name: learn-github-actions + ``` + + Optional - The name of the workflow as it will appear in the Actions tab of the {% data variables.product.prodname_dotcom %} repository. +
    + + ```yaml + on: [push] + ``` + + Specify the event that automatically triggers the workflow file. This example uses the push event, so that the jobs run every time someone pushes a change to the repository. You can set up the workflow to only run on certain branches, paths, or tags. For syntax examples including or excluding branches, paths, or tags, see "Workflow syntax for {% data variables.product.prodname_actions %}." +
    + + ```yaml + jobs: + ``` + + Groups together all the jobs that run in the learn-github-actions workflow file. +
    + + ```yaml + check-bats-version: + ``` + + Defines the name of the check-bats-version job stored within the jobs section. +
    + + ```yaml + runs-on: ubuntu-latest + ``` + + Configures the job to run on an Ubuntu Linux runner. This means that the job will execute on a fresh virtual machine hosted by GitHub. For syntax examples using other runners, see "Workflow syntax for {% data variables.product.prodname_actions %}." +
    + + ```yaml + steps: + ``` + + Groups together all the steps that run in the check-bats-version job. Each line nested under this section is a separate action. +
    + + ```yaml + - uses: actions/checkout@v2 + ``` + + The uses keyword tells the job to retrieve v2 of the community action named actions/checkout@v2. This is an action that checks out your repository and downloads it to the runner, allowing you to run actions against your code (such as testing tools). You must use the checkout action any time your workflow will run against the repository's code or you are using an action defined in the repository. +
    + + ```yaml + - uses: actions/setup-node@v1 + ``` + + This action installs the node software package on the runner, giving you access to the npm command. +
    + + ```yaml + - run: npm install -g bats + ``` + + The run keyword tells the job to execute a command on the runner. In this case, you are using npm to install the bats software testing package. +
    + + ```yaml + - run: bats -v + ``` + + Finally, you'll run the bats command with a parameter that outputs the software version. +
    + +#### Visualizing the workflow file + +In this diagram, you can see the workflow file you just created and how the {% data variables.product.prodname_actions %} components are organized in a hierarchy. Each step executes a single action. Steps 1 and 2 use prebuilt community actions. To find more prebuilt actions for your workflows, see "[Finding and customizing actions](/actions/learn-github-actions/finding-and-customizing-actions)." + +![Workflow overview](/assets/images/help/images/overview-actions-event.png) + + +### Viewing the job's activity + +Once your job has started running, you can view each step's activity on {% data variables.product.prodname_dotcom %}. + +{% data reusables.repositories.navigate-to-repo %} +1. Under your repository name, click **Actions**. ![Navigate to repository](/assets/images/help/images/learn-github-actions-repository.png) +1. In the left sidebar, click the workflow you want to see. ![Screenshot of workflow results](/assets/images/help/images/learn-github-actions-workflow.png) +1. Under "Workflow runs", click the name of the run you want to see. ![Screenshot of workflow runs](/assets/images/help/images/learn-github-actions-run.png) +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +1. Click on the job name to see the results of each step. ![Screenshot of workflow run details](/assets/images/help/images/overview-actions-result-updated.png) +{% else %} +1. Click on the job name to see the results of each step. ![Screenshot of workflow run details](/assets/images/help/images/overview-actions-result.png) +{% endif %} + +### Дальнейшие шаги + +To continue learning about {% data variables.product.prodname_actions %}, see "[Finding and customizing actions](/actions/learn-github-actions/finding-and-customizing-actions)." + +### Contacting support + +{% data reusables.github-actions.contacting-support %} diff --git a/translations/ru-RU/content/actions/learn-github-actions/managing-complex-workflows.md b/translations/ru-RU/content/actions/learn-github-actions/managing-complex-workflows.md new file mode 100644 index 000000000000..e17bf8fb746e --- /dev/null +++ b/translations/ru-RU/content/actions/learn-github-actions/managing-complex-workflows.md @@ -0,0 +1,151 @@ +--- +title: Managing complex workflows +shortTitle: Managing complex workflows +intro: 'This guide shows you how to use the advanced features of {% data variables.product.prodname_actions %}, with secret management, dependent jobs, caching, build matrices, and labels.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Обзор + +This article describes some of the advanced features of {% data variables.product.prodname_actions %} that help you work create more complex workflows. + +### Storing secrets + +If your workflows use sensitive data, such as passwords or certificates, you can save these in {% data variables.product.prodname_dotcom %} as _secrets_ and then use them in your workflows as environment variables. This means that you will be able to create and share workflows without having to embed sensitive values directly in the YAML workflow. + +This example action demonstrates how to reference an existing secret as an environment variable, and send it as a parameter to an example command. + +{% raw %} +```yaml +jobs: + example-job: + steps: + - name: Retrieve secret + env: + super_secret: ${{ secrets.SUPERSECRET }} + run: | + example-command "$SUPER_SECRET" +``` +{% endraw %} + +For more information, see "[Creating and storing encrypted secrets](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)." + +### Creating dependent jobs + +By default, the jobs in your workflow all run in parallel at the same time. So if you have a job that must only run after another job has completed, you can use the `needs` keyword to create this dependency. If one of the jobs fails, all dependent jobs are skipped; however, if you need the jobs to continue, you can define this using the [`if`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idif) conditional statement. + +In this example, the `setup`, `build`, and `test` jobs run in series, with `build` and `test` being dependent on the successful completion of the job that precedes them: + +```yaml +jobs: + setup: + runs-on: ubuntu-latest + steps: + - run: ./setup_server.sh + build: + needs: setup + steps: + - run: ./build_server.sh + test: + needs: build + runs-on: ubuntu-latest + steps: + - run: ./test_server.sh +``` + +For more information, see [`jobs..needs`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds). + +### Using a build matrix + +You can use a build matrix if you want your workflow to run tests across multiple combinations of operating systems, platforms, and languages. The build matrix is created using the `strategy` keyword, which receives the build options as an array. For example, this build matrix will run the job multiple times, using different versions of Node.js: + +{% raw %} +```yaml +jobs: + build: + runs-on: ubuntu-latest + strategy: + matrix: + node: [6, 8, 10] + steps: + - uses: actions/setup-node@v1 + with: + node-version: ${{ matrix.node }} +``` +{% endraw %} + +For more information, see [`jobs..strategy.matrix`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix). + +### Caching dependencies + +{% data variables.product.prodname_dotcom %}-hosted runners are started as fresh environments for each job, so if your jobs regularly reuse dependencies, you can consider caching these files to help improve performance. Once the cache is created, it is available to all workflows in the same repository. + +This example demonstrates how to cache the `~/.npm` directory: + +{% raw %} +```yaml +jobs: + example-job: + steps: + - name: Cache node modules + uses: actions/cache@v2 + env: + cache-name: cache-node-modules + with: + path: ~/.npm + key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }} + restore-keys: | + ${{ runner.os }}-build-${{ env.cache-name }}- +``` +{% endraw %} + +For more information, see "[Caching dependencies to speed up workflows](/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows)." + +### Using databases and service containers + +If your job requires a database or cache service, you can use the [`services`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idservices) keyword to create an ephemeral container to host the service; the resulting container is then available to all steps in that job and is removed when the job has completed. This example demonstrates how a job can use `services` to create a `postgres` container, and then use `node` to connect to the service. + +```yaml +jobs: + container-job: + runs-on: ubuntu-latest + container: node:10.18-jessie + services: + postgres: + image: postgres + steps: + - name: Check out repository code + uses: actions/checkout@v2 + - name: Install dependencies + run: npm ci + - name: Connect to PostgreSQL + run: node client.js + env: + POSTGRES_HOST: postgres + POSTGRES_PORT: 5432 +``` + +For more information, see "[Using databases and service containers](/actions/configuring-and-managing-workflows/using-databases-and-service-containers)." + +### Using labels to route workflows + +This feature helps you assign jobs to a specific self-hosted runner. If you want to be sure that a particular type of runner will process your job, you can use labels to control where jobs are executed. You can assign labels to a self-hosted runner, and then refer to these labels in your YAML workflow, ensuring that the job is routed in a predictable way. + +This example shows how a workflow can use labels to specify the required runner: + +```yaml +jobs: + example-job: + runs-on: [self-hosted, linux, x64, gpu] +``` + +For more information, see ["Using labels with self-hosted runners](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners)." + +### Дальнейшие шаги + +To continue learning about {% data variables.product.prodname_actions %}, see "[Sharing workflows with your organization](/actions/learn-github-actions/sharing-workflows-with-your-organization)." diff --git a/translations/ru-RU/content/actions/learn-github-actions/migrating-from-azure-pipelines-to-github-actions.md b/translations/ru-RU/content/actions/learn-github-actions/migrating-from-azure-pipelines-to-github-actions.md new file mode 100644 index 000000000000..198202140253 --- /dev/null +++ b/translations/ru-RU/content/actions/learn-github-actions/migrating-from-azure-pipelines-to-github-actions.md @@ -0,0 +1,327 @@ +--- +title: Migrating from Azure Pipelines to GitHub Actions +intro: '{% data variables.product.prodname_actions %} and Azure Pipelines share several configuration similarities, which makes migrating to {% data variables.product.prodname_actions %} relatively straightforward.' +redirect_from: + - /actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Introduction + +Azure Pipelines and {% data variables.product.prodname_actions %} both allow you to create workflows that automatically build, test, publish, release, and deploy code. Azure Pipelines and {% data variables.product.prodname_actions %} share some similarities in workflow configuration: + +- Workflow configuration files are written in YAML and are stored in the code's repository. +- Workflows include one or more jobs. +- Jobs include one or more steps or individual commands. +- Steps or tasks can be reused and shared with the community. + +For more information, see "[Core concepts for {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)." + +### Key differences + +When migrating from Azure Pipelines, consider the following differences: + +- Azure Pipelines supports a legacy _classic editor_, which lets you define your CI configuration in a GUI editor instead of creating the pipeline definition in a YAML file. {% data variables.product.prodname_actions %} uses YAML files to define workflows and does not support a graphical editor. +- Azure Pipelines allows you to omit some structure in job definitions. For example, if you only have a single job, you don't need to define the job and only need to define its steps. {% data variables.product.prodname_actions %} requires explicit configuration, and YAML structure cannot be omitted. +- Azure Pipelines supports _stages_ defined in the YAML file, which can be used to create deployment workflows. {% data variables.product.prodname_actions %} requires you to separate stages into separate YAML workflow files. +- On-premises Azure Pipelines build agents can be selected with capabilities. {% data variables.product.prodname_actions %} self-hosted runners can be selected with labels. + +### Migrating jobs and steps + +Jobs and steps in Azure Pipelines are very similar to jobs and steps in {% data variables.product.prodname_actions %}. In both systems, jobs have the following characteristics: + +* Jobs contain a series of steps that run sequentially. +* Jobs run on separate virtual machines or in separate containers. +* Jobs run in parallel by default, but can be configured to run sequentially. + +### Migrating script steps + +You can run a script or a shell command as a step in a workflow. In Azure Pipelines, script steps can be specified using the `script` key, or with the `bash`, `powershell`, or `pwsh` keys. Scripts can also be specified as an input to the [Bash task](https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/utility/bash?view=azure-devops) or the [PowerShell task](https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/utility/powershell?view=azure-devops). + +In {% data variables.product.prodname_actions %}, all scripts are specified using the `run` key. To select a particular shell, you can specify the `shell` key when providing the script. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)." + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +Azure Pipelines + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +jobs: +- job: scripts + pool: + vmImage: 'windows-latest' + steps: + - script: echo "This step runs in the default shell" + - bash: echo "This step runs in bash" + - pwsh: Write-Host "This step runs in PowerShell Core" + - task: PowerShell@2 + inputs: + script: Write-Host "This step runs in PowerShell" +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + scripts: + runs-on: windows-latest + steps: + - run: echo "This step runs in the default shell" + - run: echo "This step runs in bash" + shell: bash + - run: Write-Host "This step runs in PowerShell Core" + shell: pwsh + - run: Write-Host "This step runs in PowerShell" + shell: powershell +``` +{% endraw %} +
    + +### Differences in script error handling + +In Azure Pipelines, scripts can be configured to error if any output is sent to `stderr`. {% data variables.product.prodname_actions %} does not support this configuration. + +{% data variables.product.prodname_actions %} configures shells to "fail fast" whenever possible, which stops the script immediately if one of the commands in a script exits with an error code. In contrast, Azure Pipelines requires explicit configuration to exit immediately on an error. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#exit-codes-and-error-action-preference)." + +### Differences in the default shell on Windows + +In Azure Pipelines, the default shell for scripts on Windows platforms is the Command shell (_cmd.exe_). In {% data variables.product.prodname_actions %}, the default shell for scripts on Windows platforms is PowerShell. PowerShell has several differences in built-in commands, variable expansion, and flow control. + +If you're running a simple command, you might be able to run a Command shell script in PowerShell without any changes. But in most cases, you will either need to update your script with PowerShell syntax or instruct {% data variables.product.prodname_actions %} to run the script with the Command shell instead of PowerShell. You can do this by specifying `shell` as `cmd`. + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +Azure Pipelines + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +jobs: +- job: run_command + pool: + vmImage: 'windows-latest' + steps: + - script: echo "This step runs in CMD on Windows by default" +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + run_command: + runs-on: windows-latest + steps: + - run: echo "This step runs in PowerShell on Windows by default" + - run: echo "This step runs in CMD on Windows explicitly" + shell: cmd +``` +{% endraw %} +
    + +For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#using-a-specific-shell)." + +### Migrating conditionals and expression syntax + +Azure Pipelines and {% data variables.product.prodname_actions %} can both run steps conditionally. In Azure Pipelines, conditional expressions are specified using the `condition` key. In {% data variables.product.prodname_actions %}, conditional expressions are specified using the `if` key. + +Azure Pipelines uses functions within expressions to execute steps conditionally. In contrast, {% data variables.product.prodname_actions %} uses an infix notation. For example, you must replace the `eq` function in Azure Pipelines with the `==` operator in {% data variables.product.prodname_actions %}. + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +Azure Pipelines + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +jobs: +- job: conditional + pool: + vmImage: 'ubuntu-latest' + steps: + - script: echo "This step runs with str equals 'ABC' and num equals 123" + condition: and(eq(variables.str, 'ABC'), eq(variables.num, 123)) +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + conditional: + runs-on: ubuntu-latest + steps: + - run: echo "This step runs with str equals 'ABC' and num equals 123" + if: ${{ env.str == 'ABC' && env.num == 123 }} +``` +{% endraw %} +
    + +For more information, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)." + +### Dependencies between jobs + +Both Azure Pipelines and {% data variables.product.prodname_actions %} allow you to set dependencies for a job. In both systems, jobs run in parallel by default, but job dependencies can be specified explicitly. In Azure Pipelines, this is done with the `dependsOn` key. In {% data variables.product.prodname_actions %}, this is done with the `needs` key. + +Below is an example of the syntax for each system. The workflows start a first job named `initial`, and when that job completes, two jobs named `fanout1` and `fanout2` will run. Finally, when those jobs complete, the job `fanin` will run. + + + + + + + + + + +
    +Azure Pipelines + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +jobs: +- job: initial + pool: + vmImage: 'ubuntu-latest' + steps: + - script: echo "This job will be run first." +- job: fanout1 + pool: + vmImage: 'ubuntu-latest' + dependsOn: initial + steps: + - script: echo "This job will run after the initial job, in parallel with fanout2." +- job: fanout2 + pool: + vmImage: 'ubuntu-latest' + dependsOn: initial + steps: + - script: echo "This job will run after the initial job, in parallel with fanout1." +- job: fanin: + pool: + vmImage: 'ubuntu-latest' + dependsOn: [fanout1, fanout2] + steps: + - script: echo "This job will run after fanout1 and fanout2 have finished." +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + initial: + runs-on: ubuntu-latest + steps: + - run: echo "This job will be run first." + fanout1: + runs-on: ubuntu-latest + needs: initial + steps: + - run: echo "This job will run after the initial job, in parallel with fanout2." + fanout2: + runs-on: ubuntu-latest + needs: initial + steps: + - run: echo "This job will run after the initial job, in parallel with fanout1." + fanin: + runs-on: ubuntu-latest + needs: [fanout1, fanout2] + steps: + - run: echo "This job will run after fanout1 and fanout2 have finished." +``` +{% endraw %} +
    + +For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)." + +### Migrating tasks to actions + +Azure Pipelines uses _tasks_, which are application components that can be re-used in multiple workflows. {% data variables.product.prodname_actions %} uses _actions_, which can be used to perform tasks and customize your workflow. In both systems, you can specify the name of the task or action to run, along with any required inputs as key/value pairs. + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +Azure Pipelines + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +jobs: +- job: run_python + pool: + vmImage: 'ubuntu-latest' + steps: + - task: UsePythonVersion@0 + inputs: + versionSpec: '3.7' + architecture: 'x64' + - script: python script.py +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + run_python: + runs-on: ubuntu-latest + steps: + - uses: actions/setup-python@v2 + with: + python-version: '3.7' + architecture: 'x64' + - run: python script.py +``` +{% endraw %} +
    + +You can find actions that you can use in your workflow in [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=actions), or you can create your own actions. For more information, see "[Creating actions](/actions/creating-actions)." + diff --git a/translations/ru-RU/content/actions/learn-github-actions/migrating-from-circleci-to-github-actions.md b/translations/ru-RU/content/actions/learn-github-actions/migrating-from-circleci-to-github-actions.md new file mode 100644 index 000000000000..17d1431c827d --- /dev/null +++ b/translations/ru-RU/content/actions/learn-github-actions/migrating-from-circleci-to-github-actions.md @@ -0,0 +1,447 @@ +--- +title: Migrating from CircleCI to GitHub Actions +intro: 'GitHub Actions and CircleCI share several similarities in configuration, which makes migration to GitHub Actions relatively straightforward.' +redirect_from: + - /actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Introduction + +CircleCI and {% data variables.product.prodname_actions %} both allow you to create workflows that automatically build, test, publish, release, and deploy code. CircleCI and {% data variables.product.prodname_actions %} share some similarities in workflow configuration: + +- Workflow configuration files are written in YAML and stored in the repository. +- Workflows include one or more jobs. +- Jobs include one or more steps or individual commands. +- Steps or tasks can be reused and shared with the community. + +For more information, see "[Core concepts for {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)." + +### Key differences + +When migrating from CircleCI, consider the following differences: + +- CircleCI’s automatic test parallelism automatically groups tests according to user-specified rules or historical timing information. This functionality is not built into {% data variables.product.prodname_actions %}. +- Actions that execute in Docker containers are sensitive to permissions problems since containers have a different mapping of users. You can avoid many of these problems by not using the `USER` instruction in your *Dockerfile*. For more information about the Docker filesystem on {% data variables.product.product_name %}-hosted runners, see "[Virtual environments for {% data variables.product.product_name %}-hosted runners](/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem)." + +### Migrating workflows and jobs + +CircleCI defines `workflows` in the *config.yml* file, which allows you to configure more than one workflow. {% data variables.product.product_name %} requires one workflow file per workflow, and as a consequence, does not require you to declare `workflows`. You'll need to create a new workflow file for each workflow configured in *config.yml*. + +Both CircleCI and {% data variables.product.prodname_actions %} configure `jobs` in the configuration file using similar syntax. If you configure any dependencies between jobs using `requires` in your CircleCI workflow, you can use the equivalent {% data variables.product.prodname_actions %} `needs` syntax. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)." + +### Migrating orbs to actions + +Both CircleCI and {% data variables.product.prodname_actions %} provide a mechanism to reuse and share tasks in a workflow. CircleCI uses a concept called orbs, written in YAML, to provide tasks that people can reuse in a workflow. {% data variables.product.prodname_actions %} has powerful and flexible reusable components called actions, which you build with either JavaScript files or Docker images. You can create actions by writing custom code that interacts with your repository in any way you'd like, including integrating with {% data variables.product.product_name %}'s APIs and any publicly available third-party API. For example, an action can publish npm modules, send SMS alerts when urgent issues are created, or deploy production-ready code. For more information, see "[Creating actions](/actions/creating-actions)." + +CircleCI can reuse pieces of workflows with YAML anchors and aliases. {% data variables.product.prodname_actions %} supports the most common need for reusability using build matrixes. For more information about build matrixes, see "[Managing complex workflows](/actions/learn-github-actions/managing-complex-workflows/#using-a-build-matrix)." + +### Using Docker images + + +Both CircleCI and {% data variables.product.prodname_actions %} support running steps inside of a Docker image. + +CircleCI provides a set of pre-built images with common dependencies. These images have the `USER` set to `circleci`, which causes permissions to conflict with {% data variables.product.prodname_actions %}. + +We recommend that you move away from CircleCI's pre-built images when you migrate to {% data variables.product.prodname_actions %}. In many cases, you can use actions to install the additional dependencies you need. + +For more information about the Docker filesystem, see "[Virtual environments for {% data variables.product.product_name %}-hosted runners](/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem)." + +For more information about the tools and packages available on {% data variables.product.prodname_dotcom %}-hosted virtual environments, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". + +### Using variables and secrets + +CircleCI and {% data variables.product.prodname_actions %} support setting environment variables in the configuration file and creating secrets using the CircleCI or {% data variables.product.product_name %} UI. + +For more information, see "[Using environment variables](/actions/configuring-and-managing-workflows/using-environment-variables)" and "[Creating and using encrypted secrets](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)." + +### Caching + +CircleCI and {% data variables.product.prodname_actions %} provide a method to manually cache files in the configuration file. + +Below is an example of the syntax for each system. + + + + + + + + + + +
    +CircleCI + +GitHub Actions +
    +{% raw %} +```yaml +- restore_cache: + keys: + - v1-npm-deps-{{ checksum "package-lock.json" }} + - v1-npm-deps- +``` +{% endraw %} + +{% raw %} +```yaml +- name: Cache node modules + uses: actions/cache@v2 + with: + path: ~/.npm + key: v1-npm-deps-${{ hashFiles('**/package-lock.json') }} + restore-keys: v1-npm-deps- +``` +{% endraw %} +
    + +For more information, see "[Caching dependencies to speed up workflows](/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows)." + +{% data variables.product.prodname_actions %} does not have an equivalent of CircleCI’s Docker Layer Caching (or DLC). + +### Persisting data between jobs + +Both CircleCI and {% data variables.product.prodname_actions %} provide mechanisms to persist data between jobs. + +Below is an example in CircleCI and {% data variables.product.prodname_actions %} configuration syntax. + + + + + + + + + + +
    +CircleCI + +GitHub Actions +
    +{% raw %} +```yaml +- persist_to_workspace: + root: workspace + paths: + - math-homework.txt + +... + +- attach_workspace: + at: /tmp/workspace +``` +{% endraw %} + +{% raw %} +```yaml +- name: Upload math result for job 1 + uses: actions/upload-artifact@v2 + with: + name: homework + path: math-homework.txt + +... + +- name: Download math result for job 1 + uses: actions/download-artifact@v2 + with: + name: homework +``` +{% endraw %} +
    + +For more information, see "[Persisting workflow data using artifacts](/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts)." + +### Using databases and service containers + +Both systems enable you to include additional containers for databases, caching, or other dependencies. + +In CircleCI, the first image listed in the *config.yaml* is the primary image used to run commands. {% data variables.product.prodname_actions %} uses explicit sections: use `container` for the primary container, and list additional containers in `services`. + +Below is an example in CircleCI and {% data variables.product.prodname_actions %} configuration syntax. + + + + + + + + + + +
    +CircleCI + +GitHub Actions +
    +{% raw %} +```yaml +--- +version: 2.1 + +jobs: + + ruby-26: + docker: + - image: circleci/ruby:2.6.3-node-browsers-legacy + environment: + PGHOST: localhost + PGUSER: administrate + RAILS_ENV: test + - image: postgres:10.1-alpine + environment: + POSTGRES_USER: administrate + POSTGRES_DB: ruby26 + POSTGRES_PASSWORD: "" + + working_directory: ~/administrate + + steps: + - checkout + + # Bundle install dependencies + - run: bundle install --path vendor/bundle + + # Wait for DB + - run: dockerize -wait tcp://localhost:5432 -timeout 1m + + # Setup the environment + - run: cp .sample.env .env + + # Setup the database + - run: bundle exec rake db:setup + + # Run the tests + - run: bundle exec rake + + +workflows: + version: 2 + build: + jobs: + - ruby-26 +... + +- attach_workspace: + at: /tmp/workspace +``` +{% endraw %} + +{% raw %} +```yaml +name: Containers + +on: [push] + +jobs: + build: + + runs-on: ubuntu-latest + container: circleci/ruby:2.6.3-node-browsers-legacy + + env: + PGHOST: postgres + PGUSER: administrate + RAILS_ENV: test + + services: + postgres: + image: postgres:10.1-alpine + env: + POSTGRES_USER: administrate + POSTGRES_DB: ruby25 + POSTGRES_PASSWORD: "" + ports: + - 5432:5432 + # Add a health check + options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5 + + steps: + # This Docker file changes sets USER to circleci instead of using the default user, so we need to update file permissions for this image to work on GH Actions. + # See https://docs.github.com/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem + - name: Setup file system permissions + run: sudo chmod -R 777 $GITHUB_WORKSPACE /github /__w/_temp + - uses: actions/checkout@v2 + - name: Install dependencies + run: bundle install --path vendor/bundle + - name: Setup environment configuration + run: cp .sample.env .env + - name: Setup database + run: bundle exec rake db:setup + - name: Run tests + run: bundle exec rake +``` +{% endraw %} +
    + +For more information, see "[About service containers](/actions/configuring-and-managing-workflows/about-service-containers)." + +### Complete Example + +Below is a real-world example. The left shows the actual CircleCI *config.yml* for the [thoughtbot/administrator](https://github.com/thoughtbot/administrate) repository. The right shows the {% data variables.product.prodname_actions %} equivalent. + + + + + + + + + + +
    +CircleCI + +GitHub Actions +
    +{% raw %} +```yaml +--- +version: 2.1 + +commands: + shared_steps: + steps: + - checkout + + # Restore Cached Dependencies + - restore_cache: + name: Restore bundle cache + key: administrate-{{ checksum "Gemfile.lock" }} + + # Bundle install dependencies + - run: bundle install --path vendor/bundle + + # Cache Dependencies + - save_cache: + name: Store bundle cache + key: administrate-{{ checksum "Gemfile.lock" }} + paths: + - vendor/bundle + + # Wait for DB + - run: dockerize -wait tcp://localhost:5432 -timeout 1m + + # Setup the environment + - run: cp .sample.env .env + + # Setup the database + - run: bundle exec rake db:setup + + # Run the tests + - run: bundle exec rake + +default_job: &default_job + working_directory: ~/administrate + steps: + - shared_steps + # Run the tests against multiple versions of Rails + - run: bundle exec appraisal install + - run: bundle exec appraisal rake + +jobs: + ruby-25: + <<: *default_job + docker: + - image: circleci/ruby:2.5.0-node-browsers + environment: + PGHOST: localhost + PGUSER: administrate + RAILS_ENV: test + - image: postgres:10.1-alpine + environment: + POSTGRES_USER: administrate + POSTGRES_DB: ruby25 + POSTGRES_PASSWORD: "" + + ruby-26: + <<: *default_job + docker: + - image: circleci/ruby:2.6.3-node-browsers-legacy + environment: + PGHOST: localhost + PGUSER: administrate + RAILS_ENV: test + - image: postgres:10.1-alpine + environment: + POSTGRES_USER: administrate + POSTGRES_DB: ruby26 + POSTGRES_PASSWORD: "" + + +workflows: + version: 2 + multiple-rubies: + jobs: + - ruby-26 + - ruby-25 +``` +{% endraw %} + +{% raw %} +```yaml +name: Containers + +on: [push] + +jobs: + build: + + strategy: + matrix: + ruby: [2.5, 2.6.3] + + runs-on: ubuntu-latest + + env: + PGHOST: localhost + PGUSER: administrate + RAILS_ENV: test + + services: + postgres: + image: postgres:10.1-alpine + env: + POSTGRES_USER: administrate + POSTGRES_DB: ruby25 + POSTGRES_PASSWORD: "" + ports: + - 5432:5432 + # Add a health check + options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5 + + steps: + - uses: actions/checkout@v2 + - name: Setup Ruby + uses: eregon/use-ruby-action@master + with: + ruby-version: ${{ matrix.ruby }} + - name: Cache dependencies + uses: actions/cache@v2 + with: + path: vendor/bundle + key: administrate-${{ matrix.image }}-${{ hashFiles('Gemfile.lock') }} + - name: Install postgres headers + run: sudo apt-get install libpq-dev + - name: Install dependencies + run: bundle install --path vendor/bundle + - name: Setup environment configuration + run: cp .sample.env .env + - name: Setup database + run: bundle exec rake db:setup + - name: Run tests + run: bundle exec rake + - name: Install appraisal + run: bundle exec appraisal install + - name: Run appraisal + run: bundle exec appraisal rake +``` +{% endraw %} +
    diff --git a/translations/ru-RU/content/actions/learn-github-actions/migrating-from-gitlab-cicd-to-github-actions.md b/translations/ru-RU/content/actions/learn-github-actions/migrating-from-gitlab-cicd-to-github-actions.md new file mode 100644 index 000000000000..873144e8fe04 --- /dev/null +++ b/translations/ru-RU/content/actions/learn-github-actions/migrating-from-gitlab-cicd-to-github-actions.md @@ -0,0 +1,476 @@ +--- +title: Migrating from GitLab CI/CD to GitHub Actions +intro: '{% data variables.product.prodname_actions %} and GitLab CI/CD share several configuration similarities, which makes migrating to {% data variables.product.prodname_actions %} relatively straightforward.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Introduction + +GitLab CI/CD and {% data variables.product.prodname_actions %} both allow you to create workflows that automatically build, test, publish, release, and deploy code. GitLab CI/CD and {% data variables.product.prodname_actions %} share some similarities in workflow configuration: + +- Workflow configuration files are written in YAML and are stored in the code's repository. +- Workflows include one or more jobs. +- Jobs include one or more steps or individual commands. +- Jobs can run on either managed or self-hosted machines. + +There are a few differences, and this guide will show you the important differences so that you can migrate your workflow to {% data variables.product.prodname_actions %}. + +### Jobs + +Jobs in GitLab CI/CD are very similar to jobs in {% data variables.product.prodname_actions %}. In both systems, jobs have the following characteristics: + +* Jobs contain a series of steps or scripts that run sequentially. +* Jobs can run on separate machines or in separate containers. +* Jobs run in parallel by default, but can be configured to run sequentially. + +You can run a script or a shell command in a job. In GitLab CI/CD, script steps are specified using the `script` key. In {% data variables.product.prodname_actions %}, all scripts are specified using the `run` key. + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +job1: + variables: + GIT_CHECKOUT: "true" + script: + - echo "Run your script here" +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + job1: + steps: + - uses: actions/checkout@v2 + - run: echo "Run your script here" +``` +{% endraw %} +
    + +### Runners + +Runners are machines on which the jobs run. Both GitLab CI/CD and {% data variables.product.prodname_actions %} offer managed and self-hosted variants of runners. In GitLab CI/CD, `tags` are used to run jobs on different platforms, while in {% data variables.product.prodname_actions %} it is done with the `runs-on` key. + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +windows_job: + tags: + - windows + script: + - echo Hello, %USERNAME%! + +linux_job: + tags: + - linux + script: + - echo "Hello, $USER!" +``` +{% endraw %} + +{% raw %} +```yaml +windows_job: + runs-on : windows-latest + steps: + - run: echo Hello, %USERNAME%! + +linux_job: + runs-on: ubuntu-latest + steps: + - run: echo "Hello, $USER!" +``` +{% endraw %} +
    + +For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on)." + +### Docker images + +Both GitLab CI/CD and {% data variables.product.prodname_actions %} support running jobs in a Docker image. In GitLab CI/CD, Docker images are defined with a `image` key, while in {% data variables.product.prodname_actions %} it is done with the `container` key. + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +my_job: + image: node:10.16-jessie +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + my_job: + container: node:10.16-jessie +``` +{% endraw %} +
    + +For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idcontainer)." + +### Condition and expression syntax + +GitLab CI/CD uses `rules` to determine if a job will run for a specific condition. {% data variables.product.prodname_actions %} uses the `if` keyword to prevent a job from running unless a condition is met. + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +deploy_prod: + stage: deploy + script: + - echo "Deply to production server" + rules: + - if: '$CI_COMMIT_BRANCH == "master"' +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + deploy_prod: + if: contains( github.ref, 'master') + runs-on: ubuntu-latest + steps: + - run: echo "Deply to production server" +``` +{% endraw %} +
    + +For more information, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)." + +### Dependencies between Jobs + +Both GitLab CI/CD and {% data variables.product.prodname_actions %} allow you to set dependencies for a job. In both systems, jobs run in parallel by default, but job dependencies in {% data variables.product.prodname_actions %} can be specified explicitly with the `needs` key. GitLab CI/CD also has a concept of `stages`, where jobs in a stage run concurrently, but the next stage will start when all the jobs in the previous stage have completed. You can recreate this scenario in {% data variables.product.prodname_actions %} with the `needs` key. + +Below is an example of the syntax for each system. The workflows start with two jobs named `build_a` and `build_b` running in parallel, and when those jobs complete, another job called `test_ab` will run. Finally, when `test_ab` completes, the `deploy_ab` job will run. + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +stages: + - build + - test + - deploy + +build_a: + stage: build + script: + - echo "This job will run first." + +build_b: + stage: build + script: + - echo "This job will run first, in parallel with build_a." + +test_ab: + stage: test + script: + - echo "This job will run after build_a and build_b have finished." + +deploy_ab: + stage: deploy + script: + - echo "This job will run after test_ab is complete" +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + build_a: + runs-on: ubuntu-latest + steps: + - run: echo "This job will be run first." + + build_b: + runs-on: ubuntu-latest + steps: + - run: echo "This job will be run first, in parallel with build_a" + + test_ab: + runs-on: ubuntu-latest + needs: [build_a,build_b] + steps: + - run: echo "This job will run after build_a and build_b have finished" + + deploy_ab: + runs-on: ubuntu-latest + needs: [test_ab] + steps: + - run: echo "This job will run after test_ab is complete" +``` +{% endraw %} +
    + +For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)." + +### Scheduling workflows + +Both GitLab CI/CD and {% data variables.product.prodname_actions %} allow you to run workflows at a specific interval. In GitLab CI/CD, pipeline schedules are configured with the UI, while in {% data variables.product.prodname_actions %} you can trigger a workflow on a scheduled interval with the "on" key. + +For more information, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows#scheduled-events)." + +### Variables and secrets + +GitLab CI/CD and {% data variables.product.prodname_actions %} support setting environment variables in the pipeline or workflow configuration file, and creating secrets using the GitLab or {% data variables.product.product_name %} UI. + +For more information, see "[Environment variables](/actions/reference/environment-variables)" and "[Encrypted secrets](/actions/reference/encrypted-secrets)." + +### Caching + +GitLab CI/CD and {% data variables.product.prodname_actions %} provide a method in the configuration file to manually cache workflow files. + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +image: node:latest + +cache: + key: $CI_COMMIT_REF_SLUG + paths: + - .npm/ + +before_script: + - npm ci --cache .npm --prefer-offline + +test_async: + script: + - node ./specs/start.js ./specs/async.spec.js +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + test_async: + - name: Cache node modules + uses: actions/cache@v2 + with: + path: ~/.npm + key: v1-npm-deps-${{ hashFiles('**/package-lock.json') }} + restore-keys: v1-npm-deps- +``` +{% endraw %} +
    + +For more information, see "[Caching dependencies to speed up workflows](/actions/guides/caching-dependencies-to-speed-up-workflows)." + +### Artifacts + +Both GitLab CI/CD and {% data variables.product.prodname_actions %} can upload files and directories created by a job as artifacts. In {% data variables.product.prodname_actions %}, artifacts can be used to persist data across multiple jobs. + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +script: +artifacts: + paths: + - math-homework.txt +``` +{% endraw %} + +{% raw %} +```yaml +- name: Upload math result for job 1 + uses: actions/upload-artifact@v2 + with: + name: homework + path: math-homework.txt +``` +{% endraw %} +
    + +For more information, see "[Storing workflow data as artifacts](/actions/guides/storing-workflow-data-as-artifacts)." + +### Databases and service containers + +Both systems enable you to include additional containers for databases, caching, or other dependencies. + +In GitLab CI/CD, a container for the job is specified with the `image` key, while {% data variables.product.prodname_actions %} uses the `container` key. In both systems, additional service containers are specified with the `services` key. + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +container-job: + variables: + POSTGRES_PASSWORD: postgres + # The hostname used to communicate with the + # PostgreSQL service container + POSTGRES_HOST: postgres + # The default PostgreSQL port + POSTGRES_PORT: 5432 + image: node:10.18-jessie + services: + - postgres + script: + # Performs a clean installation of all dependencies + # in the `package.json` file + - npm ci + # Runs a script that creates a PostgreSQL client, + # populates the client with data, and retrieves data + - node client.js + tags: + - docker +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + container-job: + runs-on: ubuntu-latest + container: node:10.18-jessie + + services: + postgres: + image: postgres + env: + POSTGRES_PASSWORD: postgres + + steps: + - name: Check out repository code + uses: actions/checkout@v2 + + # Performs a clean installation of all dependencies + # in the `package.json` file + - name: Install dependencies + run: npm ci + + - name: Connect to PostgreSQL + # Runs a script that creates a PostgreSQL client, + # populates the client with data, and retrieves data + run: node client.js + env: + # The hostname used to communicate with the + # PostgreSQL service container + POSTGRES_HOST: postgres + # The default PostgreSQL port + POSTGRES_PORT: 5432 +``` +{% endraw %} +
    + +For more information, see "[About service containers](/actions/guides/about-service-containers)." diff --git a/translations/ru-RU/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md b/translations/ru-RU/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md new file mode 100644 index 000000000000..fd03fc3ac728 --- /dev/null +++ b/translations/ru-RU/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md @@ -0,0 +1,293 @@ +--- +title: Migrating from Jenkins to GitHub Actions +intro: '{% data variables.product.prodname_actions %} and Jenkins share multiple similarities, which makes migration to {% data variables.product.prodname_actions %} relatively straightforward.' +redirect_from: + - /actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Introduction + +Jenkins and {% data variables.product.prodname_actions %} both allow you to create workflows that automatically build, test, publish, release, and deploy code. Jenkins and {% data variables.product.prodname_actions %} share some similarities in workflow configuration: + +- Jenkins creates workflows using _Declarative Pipelines_, which are similar to {% data variables.product.prodname_actions %} workflow files. +- Jenkins uses _stages_ to run a collection of steps, while {% data variables.product.prodname_actions %} uses jobs to group one or more steps or individual commands. +- Jenkins and {% data variables.product.prodname_actions %} support container-based builds. For more information, see "[Creating a Docker container action](/articles/creating-a-docker-container-action)." +- Steps or tasks can be reused and shared with the community. + +For more information, see "[Core concepts for {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)." + +### Key differences + +- Jenkins has two types of syntax for creating pipelines: Declarative Pipeline and Scripted Pipeline. {% data variables.product.prodname_actions %} uses YAML to create workflows and configuration files. For more information, see "[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions)." +- Jenkins deployments are typically self-hosted, with users maintaining the servers in their own data centers. {% data variables.product.prodname_actions %} offers a hybrid cloud approach by hosting its own runners that you can use to run jobs, while also supporting self-hosted runners. For more information, see [About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners). + +### Comparing capabilities + +#### Distributing your builds + +Jenkins lets you send builds to a single build agent, or you can distribute them across multiple agents. You can also classify these agents according to various attributes, such as operating system types. + +Similarly, {% data variables.product.prodname_actions %} can send jobs to {% data variables.product.prodname_dotcom %}-hosted or self-hosted runners, and you can use labels to classify runners according to various attributes. The following table compares how the distributed build concept is implemented for both Jenkins and {% data variables.product.prodname_actions %}. + +| Jenkins | {% data variables.product.prodname_actions %} +| ---------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`agents`](https://wiki.jenkins.io/display/JENKINS/Distributed+builds) | [`runners`](/actions/learn-github-actions/introduction-to-github-actions#runners)
    [`self-hosted runners`](/actions/hosting-your-own-runners/about-self-hosted-runners) | + +#### Using sections to organize pipelines + +Jenkins splits its Declarative Pipelines into multiple sections. Similarly, {% data variables.product.prodname_actions %} organizes its workflows into separate sections. The table below compares Jenkins sections with the {% data variables.product.prodname_actions %} workflow. + +| Jenkins Directives | {% data variables.product.prodname_actions %} +| ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| [`agent`](https://jenkins.io/doc/book/pipeline/syntax/#agent) | [`jobs..runs-on`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idruns-on)
    [`jobs..container`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idcontainer) | +| [`сообщение`](https://jenkins.io/doc/book/pipeline/syntax/#post) | | +| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#stages) | [`jobs`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobs) | +| [`steps`](https://jenkins.io/doc/book/pipeline/syntax/#steps) | [`jobs..steps`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idsteps) | + + +### Using directives + +Jenkins uses directives to manage _Declarative Pipelines_. These directives define the characteristics of your workflow and how it will execute. The table below demonstrates how these directives map to concepts within {% data variables.product.prodname_actions %}. + +| Jenkins Directives | {% data variables.product.prodname_actions %} +| ------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`environment`](https://jenkins.io/doc/book/pipeline/syntax/#environment) | [`jobs..env`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env)
    [`jobs..steps.env`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv) | +| [`options`](https://jenkins.io/doc/book/pipeline/syntax/#parameters) | [`jobs..strategy`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategy)
    [`jobs..strategy.fail-fast`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategyfail-fast)
    [`jobs..timeout-minutes`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idtimeout-minutes) | +| [`parameters`](https://jenkins.io/doc/book/pipeline/syntax/#parameters) | [`inputs`](/actions/creating-actions/metadata-syntax-for-github-actions#inputs)
    [`outputs`](/actions/creating-actions/metadata-syntax-for-github-actions#outputs) | +| [`triggers`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`on`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#on)
    [`on..types`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onevent_nametypes)
    [on..](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)
    [on..paths](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpushpull_requestpaths) | +| [`triggers { upstreamprojects() }`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`jobs..needs`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idneeds) | +| [Jenkins cron syntax](https://jenkins.io/doc/book/pipeline/syntax/#cron-syntax) | [`on.schedule`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onschedule) | +| [`этап`](https://jenkins.io/doc/book/pipeline/syntax/#stage) | [`jobs.`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_id)
    [`jobs..name`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idname) | +| [`tools`](https://jenkins.io/doc/book/pipeline/syntax/#tools) | [Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software) | +| [`input`](https://jenkins.io/doc/book/pipeline/syntax/#input) | [`inputs`](/actions/automating-your-workflow-with-github-actions/metadata-syntax-for-github-actions#inputs) | +| [`when`](https://jenkins.io/doc/book/pipeline/syntax/#when) | [`jobs..if`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idif) | + + +### Using sequential stages + +#### Parallel job processing + +Jenkins can run the `stages` and `steps` in parallel, while {% data variables.product.prodname_actions %} currently only runs jobs in parallel. + +| Jenkins Parallel | {% data variables.product.prodname_actions %} +| ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`parallel`](https://jenkins.io/doc/book/pipeline/syntax/#parallel) | [`jobs..strategy.max-parallel`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymax-parallel) | + +#### Build matrix + +Both {% data variables.product.prodname_actions %} and Jenkins let you use a build matrix to define various system combinations. + +| Jenkins | {% data variables.product.prodname_actions %} +| ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`axis`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-axes) | [`strategy/matrix`](/actions/learn-github-actions/managing-complex-workflows/#using-a-build-matrix)
    [`context`](/actions/reference/context-and-expression-syntax-for-github-actions) | +| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages) | [`steps-context`](/actions/reference/context-and-expression-syntax-for-github-actions#steps-context) | +| [`excludes`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages) | | + +#### Using steps to execute tasks + +Jenkins groups `steps` together in `stages`. Each of these steps can be a script, function, or command, among others. Similarly, {% data variables.product.prodname_actions %} uses `jobs` to execute specific groups of `steps`. + +| Jenkins steps | {% data variables.product.prodname_actions %} +| --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | +| [`script`](https://jenkins.io/doc/book/pipeline/syntax/#script) | [`jobs..steps`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idsteps) | + +### Examples of common tasks + +#### Scheduling a pipeline to run with `cron` + + + + + + + + + + +
    +Jenkins Pipeline + +{% data variables.product.prodname_actions %} Workflow +
    + + ```yaml + pipeline { + agent any + triggers { + cron('H/15 * * * 1-5') + } + } + ``` + + + + ```yaml + on: + schedule: + - cron: '*/15 * * * 1-5' + ``` + +
    + +#### Configuring environment variables in a pipeline + + + + + + + + + + +
    +Jenkins Pipeline + +{% data variables.product.prodname_actions %} Workflow +
    + + ```yaml + pipeline { + agent any + environment { + MAVEN_PATH = '/usr/local/maven' + } + } + ``` + + + + ```yaml + jobs: + maven-build: + env: + MAVEN_PATH: '/usr/local/maven' + + ``` + +
    + +#### Building from upstream projects + + + + + + + + + + +
    +Jenkins Pipeline + +{% data variables.product.prodname_actions %} Workflow +
    + + ```yaml + pipeline { + triggers { + upstream( + upstreamProjects: 'job1,job2', + threshold: hudson.model.Result.SUCCESS) + } + } + } + + ``` + + + + ```yaml + jobs: + job1: + job2: + needs: job1 + job3: + needs: [job1, job2] + + ``` + +
    + +#### Building with multiple operating systems + + + + + + + + + + +
    +Jenkins Pipeline + +{% data variables.product.prodname_actions %} Workflow +
    + + ```yaml +pipeline { + agent none + stages { + stage('Run Tests') { + parallel { + stage('Test On MacOS') { + agent { label "macos" } + tools { nodejs "node-12" } + steps { + dir("scripts/myapp") { + sh(script: "npm install -g bats") + sh(script: "bats tests") + } + } + } + stage('Test On Linux') { + agent { label "linux" } + tools { nodejs "node-12" } + steps { + dir("script/myapp") { + sh(script: "npm install -g bats") + sh(script: "bats tests") + } + } + } + } + } + } +} + ``` + + + +{% raw %} + ```yaml + name: demo-workflow + on: + push: + jobs: + test: + runs-on: ${{ matrix.os }} + strategy: + fail-fast: false + matrix: + os: [macos-latest, ubuntu-latest] + steps: + - uses: actions/checkout@v1 + - uses: actions/setup-node@v1 + with: + node-version: 12 + - run: npm install -g bats + - run: bats tests + working-directory: scripts/myapp + ``` +{% endraw %} + +
    diff --git a/translations/ru-RU/content/actions/learn-github-actions/security-hardening-for-github-actions.md b/translations/ru-RU/content/actions/learn-github-actions/security-hardening-for-github-actions.md new file mode 100644 index 000000000000..6c3ad525b895 --- /dev/null +++ b/translations/ru-RU/content/actions/learn-github-actions/security-hardening-for-github-actions.md @@ -0,0 +1,97 @@ +--- +title: Security hardening for GitHub Actions +shortTitle: Security hardening +intro: 'Good security practices for using {% data variables.product.prodname_actions %} features.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /actions/getting-started-with-github-actions/security-hardening-for-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Обзор + +This guide explains how to configure security hardening for certain {% data variables.product.prodname_actions %} features. If the {% data variables.product.prodname_actions %} concepts are unfamiliar, see "[Core concepts for GitHub Actions](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)." + +### Using secrets + +Sensitive values should never be stored as plaintext in workflow files, but rather as secrets. [Secrets](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets) can be configured at the organization or repository level, and allow you to store sensitive information in {% data variables.product.product_name %}. + +Secrets use [Libsodium sealed boxes](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes), so that they are encrypted before reaching {% data variables.product.product_name %}. This occurs when the secret is submitted [using the UI](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets#creating-encrypted-secrets-for-a-repository) or through the [REST API](/rest/reference/actions#secrets). This client-side encryption helps the minimize risks related to accidental logging (for example, exception logs and request logs, among others) within {% data variables.product.product_name %}'s infrastructure. Once the secret is uploaded, {% data variables.product.product_name %} is then able to decrypt it so that it can be injected into the workflow runtime. + +To help prevent accidental disclosure, {% data variables.product.product_name %} uses a mechanism that attempts to redact any secrets that appear in run logs. This redaction looks for exact matches of any configured secrets, as well as common encodings of the values, such as Base64. However, because there are multiple ways a secret value can be transformed, this redaction is not guaranteed. As a result, there are certain proactive steps and good practices you should follow to help ensure secrets are redacted, and to limit other risks associated with secrets: + +- **Never use structured data as a secret** + - Unstructured data can cause secret redaction within logs to fail, because redaction largely relies on finding an exact match for the specific secret value. For example, do not use a blob of JSON, XML, or YAML (or similar) to encapsulate a secret value, as this significantly reduces the probability the secrets will be properly redacted. Instead, create individual secrets for each sensitive value. +- **Register all secrets used within workflows** + - If a secret is used to generate another sensitive value within a workflow, that generated value should be formally [registered as a secret](https://github.com/actions/toolkit/tree/main/packages/core#setting-a-secret), so that it will be redacted if it ever appears in the logs. For example, if using a private key to generate a signed JWT to access a web API, be sure to register that JWT as a secret or else it won’t be redacted if it ever enters the log output. + - Registering secrets applies to any sort of transformation/encoding as well. If your secret is transformed in some way (such as Base64 or URL-encoded), be sure to register the new value as a secret too. +- **Audit how secrets are handled** + - Audit how secrets are used, to help ensure they’re being handled as expected. You can do this by reviewing the source code of the repository executing the workflow, and checking any actions used in the workflow. For example, check that they’re not sent to unintended hosts, or explicitly being printed to log output. + - View the run logs for your workflow after testing valid/invalid inputs, and check that secrets are properly redacted, or not shown. It's not always obvious how a command or tool you’re invoking will send errors to `STDOUT` and `STDERR`, and secrets might subsequently end up in error logs. As a result, it is good practice to manually review the workflow logs after testing valid and invalid inputs. +- **Use credentials that are minimally scoped** + - Make sure the credentials being used within workflows have the least privileges required, and be mindful that any user with write access to your repository has read access to all secrets configured in your repository. +- **Audit and rotate registered secrets** + - Periodically review the registered secrets to confirm they are still required. Remove those that are no longer needed. + - Rotate secrets periodically to reduce the window of time during which a compromised secret is valid. + +### Using third-party actions + +The individual jobs in a workflow can interact with (and compromise) other jobs. For example, a job querying the environment variables used by a later job, writing files to a shared directory that a later job processes, or even more directly by interacting with the Docker socket and inspecting other running containers and executing commands in them. + +This means that a compromise of a single action within a workflow can be very significant, as that compromised action would have access to all secrets configured on your repository, and can use the `GITHUB_TOKEN` to write to the repository. Consequently, there is significant risk in sourcing actions from third-party repositories on {% data variables.product.prodname_dotcom %}. You can help mitigate this risk by following these good practices: + +* **Pin actions to a full length commit SHA** + + Pinning an action to a full length commit SHA is currently the only way to use an action as an immutable release. Pinning to a particular SHA helps mitigate the risk of a bad actor adding a backdoor to the action's repository, as they would need to generate a SHA-1 collision for a valid Git object payload. + + {% warning %} + + **Warning:** The short version of the commit SHA is insecure and should never be used for specifying an action's Git reference. Because of how repository networks work, any user can fork the repository and push a crafted commit to it that collides with the short SHA. This causes subsequent clones at that SHA to fail because it becomes an ambiguous commit. As a result, any workflows that use the shortened SHA will immediately fail. + + {% endwarning %} +* **Audit the source code of the action** + + Ensure that the action is handling the content of your repository and secrets as expected. For example, check that secrets are not sent to unintended hosts, or are not inadvertently logged. + +* **Pin actions to a tag only if you trust the creator** + + Although pinning to a commit SHA is the most secure option, specifying a tag is more convenient and is widely used. If you’d like to specify a tag, then be sure that you trust the action's creators. The ‘Verified creator’ badge on {% data variables.product.prodname_marketplace %} is a useful signal, as it indicates that the action was written by a team whose identity has been verified by {% data variables.product.prodname_dotcom %}. Note that there is risk to this approach even if you trust the author, because a tag can be moved or deleted if a bad actor gains access to the repository storing the action. + +### Considering cross-repository access + +{% data variables.product.product_name %} is intentionally scoped for a single repository at a time. The `GITHUB_TOKEN` used in the workflow environment grants the same level of access as a write-access user, because any write-access user can access this token by creating or modifying workflow files. Users have specific permissions for each repository, so having the `GITHUB_TOKEN` for one repository grant access to another would impact the {% data variables.product.prodname_dotcom %} permission model if not implemented carefully. Similarly, caution must be taken when adding {% data variables.product.prodname_dotcom %} authentication tokens to the workflow environment, because this can also affect the {% data variables.product.prodname_dotcom %} permission model by inadvertently granting broad access to collaborators. + +We have [a plan on the {% data variables.product.prodname_dotcom %} roadmap](https://github.com/github/roadmap/issues/74) to support a flow that allows cross-repository access within {% data variables.product.product_name %}, but this is not yet a supported feature. Currently, the only way to perform privileged cross-repository interactions is to place a {% data variables.product.prodname_dotcom %} authentication token or SSH key as a secret within the workflow environment. Because many authentication token types do not allow for granular access to specific resources, there is significant risk in using the wrong token type, as it can grant much broader access than intended. + +This list describes the recommended approaches for accessing repository data within a workflow, in descending order of preference: + +1. **The `GITHUB_TOKEN` in the workflow environment** + - This token is intentionally scoped to the single repository that invoked the workflow, and has the same level of access as a write-access user on the repository. The token is created before each job begins and expires when the job is finished. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." + - The `GITHUB_TOKEN` should be used whenever possible. +2. **Repository deploy key** + - Deploy keys are one of the only credential types that grant read or write access to a single repository, and can be used to interact with another repository within a workflow. For more information, see "[Managing deploy keys](/developers/overview/managing-deploy-keys#deploy-keys)." + - Note that deploy keys can only clone and push to the repository using Git, and cannot be used to interact with the REST or GraphQL API, so they may not be appropriate for your requirements. +3. **{% data variables.product.prodname_github_app %} tokens** + - {% data variables.product.prodname_github_apps %} can be installed on select repositories, and even have granular permissions on the resources within them. You could create a {% data variables.product.prodname_github_app %} internal to your organization, install it on the repositories you need access to within your workflow, and authenticate as the installation within your workflow to access those repositories. +4. **Personal access tokens** + - You should never use personal access tokens from your own account. These tokens grant access to all repositories within the organizations that you have access to, as well as all personal repositories in your user account. This indirectly grants broad access to all write-access users of the repository the workflow is in. In addition, if you later leave an organization, workflows using this token will immediately break, and debugging this issue can be challenging. + - If a personal access token is used, it should be one that was generated for a new account that is only granted access to the specific repositories that are needed for the workflow. Note that this approach is not scalable and should be avoided in favor of alternatives, such as deploy keys. +5. **SSH keys on a user account** + - Workflows should never use the SSH keys on a user account. Similar to personal access tokens, they grant read/write permissions to all of your personal repositories as well as all the repositories you have access to through organization membership. This indirectly grants broad access to all write-access users of the repository the workflow is in. If you're intending to use an SSH key because you only need to perform repository clones or pushes, and do not need to interact with public APIs, then you should use individual deploy keys instead. + +### Hardening for self-hosted runners + +**{% data variables.product.prodname_dotcom %}-hosted** runners execute code within ephemeral and clean isolated virtual machines, meaning there is no way to persistently compromise this environment, or otherwise gain access to more information than was placed in this environment during the bootstrap process. + +**Self-hosted** runners on {% data variables.product.product_name %} do not have guarantees around running in ephemeral clean virtual machines, and can be persistently compromised by untrusted code in a workflow. + +As a result, self-hosted runners should almost [never be used for public repositories](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories) on {% data variables.product.product_name %}, because any user can open pull requests against the repository and compromise the environment. Similarly, be cautious when using self-hosted runners on private repositories, as anyone who can fork the repository and open a PR (generally those with read-access to the repository) are able to compromise the self-hosted runner environment, including gaining access to secrets and the more privileged `GITHUB_TOKEN` which grants write-access permissions on the repository. + +You should also consider the environment of the self-hosted runner machines: +- What sensitive information resides on the machine configured as a self-hosted runner? For example, private SSH keys, API access tokens, among others. +- Does the machine have network access to sensitive services? For example, Azure or AWS metadata services. The amount of sensitive information in this environment should be kept to a minimum, and you should always be mindful that any user capable of invoking workflows has access to this environment. diff --git a/translations/ru-RU/content/actions/learn-github-actions/sharing-workflows-with-your-organization.md b/translations/ru-RU/content/actions/learn-github-actions/sharing-workflows-with-your-organization.md new file mode 100644 index 000000000000..51bfc6e56bd3 --- /dev/null +++ b/translations/ru-RU/content/actions/learn-github-actions/sharing-workflows-with-your-organization.md @@ -0,0 +1,114 @@ +--- +title: Sharing workflows with your organization +shortTitle: Sharing workflows with your organization +intro: 'Learn how you can use organization features to collaborate with your team, by sharing workflow templates, secrets, and self-hosted runners.' +redirect_from: + - /actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Обзор + +If you need to share workflows and other {% data variables.product.prodname_actions %} features with your team, then consider collaborating within a {% data variables.product.prodname_dotcom %} organization. An organization allows you to centrally store and and manage secrets, artifacts, and self-hosted runners. You can also create workflow templates in the `.github` repository and share them with other users in your organization. + +### Creating a workflow template + +Workflow templates can be created by users with write access to the organization's `.github` repository. The templates can then be used by organization members who have permission to create workflows. Workflow templates can be used to create new workflows in an organizations' public repositories; to use templates to create workflows in private repositories, the organization must be part of an enterprise or GitHub One plan. + +This procedure demonstrates how to create a workflow template and metadata file. The metadata file describes how the template is presented to users when they are creating a new workflow. + +1. If it doesn't already exist, create a new public repository named `.github` in your organization. +1. Create a directory named `workflow-templates`. +1. Create your new workflow file inside the `workflow-templates` directory. + + If you need to refer to a repository's default branch, you can use the `$default-branch` placeholder. When a workflow is created using your template, the placeholder will be automatically replaced with the name of the repository's default branch. + + For example, this file named `octo-organization-ci.yml` demonstrates a basic workflow. + + ```yaml + name: Octo Organization CI + + on: + push: + branches: [ $default-branch ] + pull_request: + branches: [ $default-branch ] + + jobs: + build: + runs-on: ubuntu-latest + + steps: + - uses: actions/checkout@v2 + + - name: Run a one-line script + run: echo Hello from Octo Organization + ``` +1. Create a metadata file inside the `workflow-templates` directory. The metadata file must have the same name as the workflow file, but instead of the `.yml` extension, it must be appended with `.properties.json`. For example, this file named `octo-organization-ci.properties.json` contains the metadata for a workflow file named `octo-organization-ci.yml`: + ```yaml + { + "name": "Octo Organization Workflow", + "description": "Octo Organization CI workflow template.", + "iconName": "example-icon", + "categories": [ + "Go" + ], + "filePatterns": [ + "package.json$", + "^Dockerfile", + ".*\\.md$" + ] + } + ``` + * `name` - **Required.** The name of the workflow template. This is displayed in the list of available templates. + * `description` - **Required.** The description of the workflow template. This is displayed in the list of available templates. + * `iconName` - **Required.** Defines an icon for the workflow's entry in the template list. The `iconName` must be an SVG icon of the same name, and must be stored in the `workflow-templates` directory. For example, a SVG file named `example-icon.svg` is referenced as `example-icon`. + * `categories` - **Optional.** Defines the language category of the workflow. When a user views the available templates, those templates that match the same language will feature more prominently. For information on the available language categories, see https://github.com/github/linguist/blob/master/lib/linguist/languages.yml. + * `filePatterns` - **Optional.** Allows the template to be used if the user's repository has a file in its root directory that matches a defined regular expression. + +To add another workflow template, add your files to the same `workflow-templates` directory. Например: + +![Workflow template files](/assets/images/help/images/workflow-template-files.png) + +### Using a workflow template + +This procedure demonstrates how a member of your organization can find and use a workflow template to create a new workflow. An organization's workflow templates can be used by anyone who is a member of the organization. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. If your repository already has existing workflows: In the upper-left corner, click **New workflow**. ![Create a new workflow](/assets/images/help/repository/actions-new-workflow.png) +1. Your organization's workflow templates are located in their own section titled "Workflows created by _organization name_". Under the name of the template you'd like to use, click **Set up this workflow**. ![Set up this workflow](/assets/images/help/settings/actions-create-starter-workflow.png) + + +### Sharing secrets within an organization + +You can centrally manage your secrets within an organization, and then make them available to selected repositories. This also means that you can update a secret in one location, and have the change apply to all repository workflows that use the secret. + +When creating a secret in an organization, you can use a policy to limit which repositories can access that secret. For example, you can grant access to all repositories, or limit access to only private repositories or a specified list of repositories. + +{% data reusables.github-actions.permissions-statement-secrets-organization %} + +{% data reusables.organizations.navigate-to-org %} +{% data reusables.organizations.org_settings %} +{% data reusables.github-actions.sidebar-secret %} +1. Click **New secret**. +1. Type a name for your secret in the **Name** input box. +1. Enter the **Value** for your secret. +1. From the **Repository access** dropdown list, choose an access policy. +1. Click **Add secret**. + +### Share self-hosted runners within an organization + +Organization admins can add their self-hosted runners to groups, and then create policies that control which repositories can access the group. + +For more information, see "[Managing access to self-hosted runners using groups](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups)." + + +### Дальнейшие шаги + +To continue learning about {% data variables.product.prodname_actions %}, see "[Security hardening for {% data variables.product.prodname_actions %}](/actions/learn-github-actions/security-hardening-for-github-actions)." diff --git a/translations/ru-RU/content/actions/managing-workflow-runs/adding-a-workflow-status-badge.md b/translations/ru-RU/content/actions/managing-workflow-runs/adding-a-workflow-status-badge.md new file mode 100644 index 000000000000..162499b98ad3 --- /dev/null +++ b/translations/ru-RU/content/actions/managing-workflow-runs/adding-a-workflow-status-badge.md @@ -0,0 +1,63 @@ +--- +title: Adding a workflow status badge +intro: You can display a status badge in your repository to indicate the status of your workflows. +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% data reusables.repositories.actions-workflow-status-badge-into %} + +If your workflow uses the `name` keyword, you must reference the workflow by name. If the name of your workflow contains white space, you'll need to replace the space with the URL encoded string `%20`. For more information about the `name` keyword, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#name)." + +``` +https://github.com///workflows//badge.svg +``` + +Alternatively, if your workflow doesn't have a `name`, you must reference the workflow file using the file path relative to the repository's root directory. + +{% note %} + +**Note:** Referencing the workflow file using the file path does not work if the workflow has a `name`. + +{% endnote %} + +``` +https://github.com///workflows//badge.svg +``` + +### Using a workflow name + +This Markdown example adds a status badge for a workflow with the name "Greet Everyone." The `OWNER` of the repository is the `actions` organization and the `REPOSITORY` name is `hello-world`. + +``` +![example workflow name](https://github.com/actions/hello-world/workflows/Greet%20Everyone/badge.svg) +``` + +### Using a workflow file path + +This Markdown example adds a status badge for a workflow with the file path `.github/workflows/main.yml`. The `OWNER` of the repository is the `actions` organization and the `REPOSITORY` name is `hello-world`. + +``` +![example workflow file path](https://github.com/actions/hello-world/workflows/.github/workflows/main.yml/badge.svg) +``` + +### Using the `branch` parameter + +This Markdown example adds a status badge for a branch with the name `feature-1`. + +``` +![example branch parameter](https://github.com/actions/hello-world/workflows/Greet%20Everyone/badge.svg?branch=feature-1) +``` + +### Using the `event` parameter + +This Markdown example adds a badge that displays the status of workflow runs triggered by the `pull_request` event. + +``` +![example event parameter](https://github.com/actions/hello-world/workflows/Greet%20Everyone/badge.svg?event=pull_request) +``` diff --git a/translations/ru-RU/content/actions/managing-workflow-runs/canceling-a-workflow.md b/translations/ru-RU/content/actions/managing-workflow-runs/canceling-a-workflow.md new file mode 100644 index 000000000000..031f4cb53f4c --- /dev/null +++ b/translations/ru-RU/content/actions/managing-workflow-runs/canceling-a-workflow.md @@ -0,0 +1,31 @@ +--- +title: Canceling a workflow +intro: 'You can cancel a workflow run that is in progress. When you cancel a workflow run, {% data variables.product.prodname_dotcom %} cancels all jobs and steps that are a part of that workflow.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% data reusables.repositories.permissions-statement-write %} + +### Canceling a workflow run + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. In the upper-right corner of the workflow, click **Cancel workflow**. ![Cancel check suite button](/assets/images/help/repository/cancel-check-suite.png) + +### Steps {% data variables.product.prodname_dotcom %} takes to cancel a workflow run + +When canceling workflow run, you may be running other software that uses resources that are related to the workflow run. To help you free up resources related to the workflow run, it may help to understand the steps {% data variables.product.prodname_dotcom %} performs to cancel a workflow run. + +1. To cancel the workflow run, the server re-evaluates `if` conditions for all currently running jobs. If the condition evaluates to `true`, the job will not get canceled. For example, the condition `if: always()` would evaluate to true and the job continues to run. When there is no condition, that is the equivalent of the condition `if: success()`, which only runs if the previous step finished successfully. +2. For jobs that need to be canceled, the server sends a cancellation message to all the runner machines with jobs that need to be canceled. +3. For jobs that continue to run, the server re-evaluates `if` conditions for the unfinished steps. If the condition evaluates to `true`, the step continues to run. +4. For steps that need to be canceled, the runner machine sends `SIGINT/Ctrl-C` to the step's entry process (`node` for javascript action, `docker` for container action, and `bash/cmd/pwd` when using `run` in a step). If the process doesn't exit within 7500 ms, the runner will send `SIGTERM/Ctrl-Break` to the process, then wait for 2500 ms for the process to exit. If the process is still running, the runner kills the process tree. +5. After the 5 minutes cancellation timeout period, the server will force terminate all jobs and steps that don't finish running or fail to complete the cancellation process. diff --git a/translations/ru-RU/content/actions/managing-workflow-runs/deleting-a-workflow-run.md b/translations/ru-RU/content/actions/managing-workflow-runs/deleting-a-workflow-run.md new file mode 100644 index 000000000000..18ebe8c5ccb3 --- /dev/null +++ b/translations/ru-RU/content/actions/managing-workflow-runs/deleting-a-workflow-run.md @@ -0,0 +1,23 @@ +--- +title: Deleting a workflow run +intro: 'You can delete a workflow run that has been completed, or is more than two weeks old.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% data reusables.repositories.permissions-statement-write %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +1. To delete a workflow run, use the {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} drop-down menu, and select **Delete workflow run**. + + ![Deleting a workflow run](/assets/images/help/settings/workflow-delete-run.png) +2. Review the confirmation prompt and click **Yes, permanently delete this workflow run**. + + ![Deleting a workflow run confirmation](/assets/images/help/settings/workflow-delete-run-confirmation.png) diff --git a/translations/ru-RU/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md b/translations/ru-RU/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md new file mode 100644 index 000000000000..a95381aadd6b --- /dev/null +++ b/translations/ru-RU/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md @@ -0,0 +1,45 @@ +--- +title: Disabling and enabling a workflow +intro: You can disable and re-enable a workflow using {% data variables.product.prodname_dotcom %} or the REST API. +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.23' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +Disabling a workflow allows you to stop a workflow from being triggered without having to delete the file from the repo. You can easily re-enable the workflow again on {% data variables.product.prodname_dotcom %}. You can also disable and enable a workflow using the REST API. For more information, see the "[Actions REST API](/rest/reference/actions#workflows)." + +Temporarily disabling a workflow can be useful in many scenarios. These are a few examples where disabling a workflow might be helpful: + +- A workflow error that produces too many or wrong requests, impacting external services negatively. +- A workflow that is not critical and is consuming too many minutes on your account. +- A workflow that sends requests to a service that is down. +- Workflows on a forked repository that aren't needed (for example, scheduled workflows). + +{% warning %} + +**Warning:** {% data reusables.actions.scheduled-workflows-disabled %} + +{% endwarning %} + +### Disabling a workflow + +You can manually disable a workflow so that it won't execute any workflow runs. A disabled workflow is not deleted, and can be re-enabled. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. In the left sidebar, click the workflow you want to disable. ![actions select workflow](/assets/images/actions-select-workflow.png) +1. Click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}. ![actions kebab menu](/assets/images/help/repository/actions-workflow-menu-kebab.png) +1. Click **Disable workflow**. ![actions disable workflow](/assets/images/help/repository/actions-disable-workflow.png) The disabled workflow is marked {% octicon "stop" aria-label="The stop icon" %} to indicate its status. ![actions list disabled workflow](/assets/images/help/repository/actions-find-disabled-workflow.png) + +### Enabling a workflow + +You can re-enable a workflow that was previously disabled. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. In the left sidebar, click the workflow you want to enable. ![actions select disabled workflow](/assets/images/help/repository/actions-select-disabled-workflow.png) +1. Click **Enable workflow**. ![actions enable workflow](/assets/images/help/repository/actions-enable-workflow.png) diff --git a/translations/ru-RU/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md b/translations/ru-RU/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md new file mode 100644 index 000000000000..591f96966661 --- /dev/null +++ b/translations/ru-RU/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md @@ -0,0 +1,22 @@ +--- +title: Downloading workflow artifacts +intro: You can download archived artifacts before they automatically expire. +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} By default, {% data variables.product.product_name %} stores build logs and artifacts for 90 days, and you can customize this retention period, depending on the type of repository. For more information, see "[Configuring the retention period for GitHub Actions artifacts and logs in your repository](/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository)."{% endif %} +{% if currentVersion == "enterprise-server@2.22" %} {% data variables.product.product_name %} stores full build logs and artifacts for 90 days.{% endif %} + +{% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. Under **Artifacts**, click the artifact you want to download. ![Download artifact drop-down menu](/assets/images/help/repository/artifact-drop-down.png) diff --git a/translations/ru-RU/content/actions/managing-workflow-runs/enabling-debug-logging.md b/translations/ru-RU/content/actions/managing-workflow-runs/enabling-debug-logging.md new file mode 100644 index 000000000000..f28a20c8b64e --- /dev/null +++ b/translations/ru-RU/content/actions/managing-workflow-runs/enabling-debug-logging.md @@ -0,0 +1,38 @@ +--- +title: Enabling debug logging +intro: 'If the workflow logs do not provide enough detail to diagnose why a workflow, job, or step is not working as expected, you can enable additional debug logging.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +These extra logs are enabled by setting secrets in the repository containing the workflow, so the same permissions requirements will apply: + +- {% data reusables.github-actions.permissions-statement-secrets-repository %} +- {% data reusables.github-actions.permissions-statement-secrets-organization %} +- {% data reusables.github-actions.permissions-statement-secrets-api %} + +For more information on setting secrets, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)." + +### Enabling runner diagnostic logging + +Runner diagnostic logging provides additional log files that contain information about how a runner is executing a job. Two extra log files are added to the log archive: + +* The runner process log, which includes information about coordinating and setting up runners to execute jobs. +* The worker process log, which logs the execution of a job. + +1. To enable runner diagnostic logging, set the following secret in the repository that contains the workflow: `ACTIONS_RUNNER_DEBUG` to `true`. + +1. To download runner diagnostic logs, download the log archive of the workflow run. The runner diagnostic logs are contained in the `runner-diagnostic-logs` folder. For more information on downloading logs, see "[Downloading logs](/actions/managing-workflow-runs/using-workflow-run-logs/#downloading-logs)." + +### Enabling step debug logging + +Step debug logging increases the verbosity of a job's logs during and after a job's execution. + +1. To enable step debug logging, you must set the following secret in the repository that contains the workflow: `ACTIONS_STEP_DEBUG` to `true`. + +1. After setting the secret, more debug events are shown in the step logs. For more information, see ["Viewing logs to diagnose failures"](/actions/managing-workflow-runs/using-workflow-run-logs/#viewing-logs-to-diagnose-failures). diff --git a/translations/ru-RU/content/actions/managing-workflow-runs/index.md b/translations/ru-RU/content/actions/managing-workflow-runs/index.md new file mode 100644 index 000000000000..5096b761c732 --- /dev/null +++ b/translations/ru-RU/content/actions/managing-workflow-runs/index.md @@ -0,0 +1,32 @@ +--- +title: Managing workflow runs +shortTitle: Managing workflow runs +intro: 'You can view the status and results of each step in your workflow, cancel a pending workflow, view billable job execution minutes, debug and re-run a failed workflow, search and download logs, and download artifacts.' +redirect_from: + - /actions/configuring-and-managing-workflows/managing-a-workflow-run + - /articles/viewing-your-repository-s-workflows + - /articles/viewing-your-repositorys-workflows + - /articles/managing-a-workflow-run + - /github/automating-your-workflow-with-github-actions/managing-a-workflow-run + - /actions/automating-your-workflow-with-github-actions/managing-a-workflow-run + - /actions/configuring-and-managing-workflows/configuring-and-managing-workflow-files-and-runs +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% link_in_list /viewing-workflow-run-history %} +{% link_in_list /using-workflow-run-logs %} +{% link_in_list /manually-running-a-workflow %} +{% link_in_list /re-running-a-workflow %} +{% link_in_list /canceling-a-workflow %} +{% link_in_list /disabling-and-enabling-a-workflow %} +{% link_in_list /deleting-a-workflow-run %} +{% link_in_list /viewing-job-execution-time %} +{% link_in_list /downloading-workflow-artifacts %} +{% link_in_list /removing-workflow-artifacts %} +{% link_in_list /enabling-debug-logging %} +{% link_in_list /adding-a-workflow-status-badge %} diff --git a/translations/ru-RU/content/actions/managing-workflow-runs/manually-running-a-workflow.md b/translations/ru-RU/content/actions/managing-workflow-runs/manually-running-a-workflow.md new file mode 100644 index 000000000000..2288a35e5a8b --- /dev/null +++ b/translations/ru-RU/content/actions/managing-workflow-runs/manually-running-a-workflow.md @@ -0,0 +1,31 @@ +--- +title: Manually running a workflow +intro: 'When a workflow is configured to run on the `workflow_dispatch` event, you can run the workflow using the REST API or from the Actions tab on {% data variables.product.prodname_dotcom %}.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +To run a workflow manually, the workflow must be configured to run on the `workflow_dispatch` event. For more information, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows)." + +### Running a workflow on {% data variables.product.prodname_dotcom %} + +To trigger the `workflow_dispatch` event on {% data variables.product.prodname_dotcom %}, your workflow must be in the default branch. Follow these steps to manually trigger a workflow run. + +{% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. In the left sidebar, click the workflow you want to run. ![actions select workflow](/assets/images/actions-select-workflow.png) +1. Above the list of workflow runs, select **Run workflow**. ![actions workflow dispatch](/assets/images/actions-workflow-dispatch.png) +1. Select the branch where the workflow will run and type the input parameters used by the workflow. Click **Run workflow**. ![actions manually run workflow](/assets/images/actions-manually-run-workflow.png) + +### Running a workflow using the REST API + +When using the REST API, you configure the `inputs` and `ref` as request body parameters. If the inputs are omitted, the default values defined in the workflow file are used. + +For more information about using the REST API, see the "[Create a workflow dispatch event](/rest/reference/actions/#create-a-workflow-dispatch-event)." diff --git a/translations/ru-RU/content/actions/managing-workflow-runs/re-running-a-workflow.md b/translations/ru-RU/content/actions/managing-workflow-runs/re-running-a-workflow.md new file mode 100644 index 000000000000..14b5d9226820 --- /dev/null +++ b/translations/ru-RU/content/actions/managing-workflow-runs/re-running-a-workflow.md @@ -0,0 +1,19 @@ +--- +title: Re-running a workflow +intro: You can re-run an instance of a workflow. Re-running a workflow uses the same `GITHUB_SHA` (commit SHA) and `GITHUB_REF` (Git ref) of the original event that triggered the workflow run. +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. In the upper-right corner of the workflow, use the **Re-run jobs** drop-down menu, and select **Re-run all jobs**. ![Re-run checks drop-down menu](/assets/images/help/repository/rerun-checks-drop-down.png) diff --git a/translations/ru-RU/content/actions/managing-workflow-runs/removing-workflow-artifacts.md b/translations/ru-RU/content/actions/managing-workflow-runs/removing-workflow-artifacts.md new file mode 100644 index 000000000000..df297ba2b660 --- /dev/null +++ b/translations/ru-RU/content/actions/managing-workflow-runs/removing-workflow-artifacts.md @@ -0,0 +1,41 @@ +--- +title: Removing workflow artifacts +intro: 'You can reclaim used {% data variables.product.prodname_actions %} storage by deleting artifacts before they expire on {% data variables.product.product_name %}.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Deleting an artifact + +{% warning %} + +**Warning:** Once you delete an artifact, it can not be restored. + +{% endwarning %} + +{% data reusables.repositories.permissions-statement-write %} + +{% data reusables.github-actions.artifact-log-retention-statement %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. Under **Artifacts**, click {% octicon "trashcan" aria-label="The trashcan icon" %} next to the artifact you want to remove. ![Delete artifact drop-down menu](/assets/images/help/repository/actions-delete-artifact.png) + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +### Setting the retention period for an artifact + +Retention periods for artifacts and logs can be configured at the repository, organization, and enterprise level. For more information, see "[Usage limits, billing, and administration](/actions/reference/usage-limits-billing-and-administration#artifact-and-log-retention-policy)." + +You can also define a custom retention period for individual artifacts using the `actions/upload-artifact` action in a workflow. For more information, see "[Storing workflow data as artifacts](/actions/guides/storing-workflow-data-as-artifacts#configuring-a-custom-artifact-retention-period)." + +### Finding the expiration date of an artifact + +You can use the API to confirm the date that an artifact is scheduled to be deleted. For more information, see the `expires_at` value returned by "[List artifacts for a repository](/rest/reference/actions#artifacts)." +{% endif %} \ No newline at end of file diff --git a/translations/ru-RU/content/actions/managing-workflow-runs/using-workflow-run-logs.md b/translations/ru-RU/content/actions/managing-workflow-runs/using-workflow-run-logs.md new file mode 100644 index 000000000000..7ba456e0038e --- /dev/null +++ b/translations/ru-RU/content/actions/managing-workflow-runs/using-workflow-run-logs.md @@ -0,0 +1,86 @@ +--- +title: Using workflow run logs +intro: 'You can view, search, and download the logs for each job in a workflow run.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +You can see whether a workflow run is in progress or complete from the workflow run page. You must be logged in to a {% data variables.product.prodname_dotcom %} account to view workflow run information, including for public repositories. For more information, see "[Access permissions on GitHub](/articles/access-permissions-on-github)." + +If the run is complete, you can see whether the result was a success, failure, canceled, or neutral. If the run failed, you can view and search the build logs to diagnose the failure and re-run the workflow. You can also view billable job execution minutes, or download logs and build artifacts. + +{% data variables.product.prodname_actions %} use the Checks API to output statuses, results, and logs for a workflow. {% data variables.product.prodname_dotcom %} creates a new check suite for each workflow run. The check suite contains a check run for each job in the workflow, and each job includes steps. {% data variables.product.prodname_actions %} are run as a step in a workflow. For more information about the Checks API, see "[Checks](/v3/checks/)." + +{% data reusables.github-actions.invalid-workflow-files %} + +### Viewing logs to diagnose failures + +If your workflow run fails, you can see which step caused the failure and review the failed step's build logs to troubleshoot. You can see the time it took for each step to run. You can also copy a permalink to a specific line in the log file to share with your team. {% data reusables.repositories.permissions-statement-read %} + +In addition to the steps configured in the workflow file, {% data variables.product.prodname_dotcom %} adds two additional steps to each job to set up and complete the job's execution. These steps are logged in the workflow run with the names "Set up job" and "Complete job". + +For jobs run on {% data variables.product.prodname_dotcom %}-hosted runners, "Set up job" records details of the runner's virtual environment, and includes a link to the list of preinstalled tools that were present on the runner machine. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +{% data reusables.repositories.navigate-to-job-superlinter %} +{% data reusables.repositories.view-failed-job-results-superlinter %} +{% data reusables.repositories.view-specific-line-superlinter %} + +### Searching logs + +You can search the build logs for a particular step. When you search logs, only expanded steps are included in the results. {% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +{% data reusables.repositories.navigate-to-job-superlinter %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +1. In the upper-right corner of the log output, in the **Search logs** search box, type a search query. ![Search box to search logs](/assets/images/help/repository/search-log-box-updated.png) +{% else %} +1. To expand each step you want to include in your search, click the step. ![Step name](/assets/images/help/repository/failed-check-step.png) +1. In the upper-right corner of the log output, in the **Search logs** search box, type a search query. ![Search box to search logs](/assets/images/help/repository/search-log-box.png) +{% endif %} + +### Downloading logs + +You can download the log files from your workflow run. You can also download a workflow's artifacts. For more information, see "[Persisting workflow data using artifacts](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)." {% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +{% data reusables.repositories.navigate-to-job-superlinter %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +1. In the upper right corner, click +{% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} and select **Download log archive**. + ![Download logs drop-down menu](/assets/images/help/repository/download-logs-drop-down-updated.png) +{% else %} +1. In the upper right corner, click +{% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} and select **Download log archive**. + ![Download logs drop-down menu](/assets/images/help/repository/download-logs-drop-down.png) +{% endif %} + +### Deleting logs + +You can delete the log files from your workflow run. {% data reusables.repositories.permissions-statement-write %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +1. In the upper right corner, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}. ![Kebab-horizontal icon](/assets/images/help/repository/workflow-run-kebab-horizontal-icon-updated.png) +2. To delete the log files, click the **Delete all logs** button and review the confirmation prompt. ![Delete all logs](/assets/images/help/repository/delete-all-logs-updated.png) After deleting logs, the **Delete all logs** button is removed to indicate that no log files remain in the workflow run. +{% else %} +1. In the upper right corner, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}. ![Kebab-horizontal icon](/assets/images/help/repository/workflow-run-kebab-horizontal-icon.png) +2. To delete the log files, click the **Delete all logs** button and review the confirmation prompt. ![Delete all logs](/assets/images/help/repository/delete-all-logs.png) After the logs have been deleted, the **Delete all logs** button is removed to indicate that no log files remain in the workflow run. +{% endif %} diff --git a/translations/ru-RU/content/actions/managing-workflow-runs/viewing-job-execution-time.md b/translations/ru-RU/content/actions/managing-workflow-runs/viewing-job-execution-time.md new file mode 100644 index 000000000000..709a7343a97a --- /dev/null +++ b/translations/ru-RU/content/actions/managing-workflow-runs/viewing-job-execution-time.md @@ -0,0 +1,24 @@ +--- +title: Viewing job execution time +intro: 'You can view the execution time of a job, including the billable minutes that a job accrued.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +Billable job execution minutes are only shown for jobs run on private repositories that use {% data variables.product.prodname_dotcom %}-hosted runners. There are no billable minutes when using {% data variables.product.prodname_actions %} in public repositories or for jobs run on self-hosted runners. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. Under the job summary, you can view the job's execution time. To view the billable job execution time, click **Run and billable time details**. ![Run and billable time details link](/assets/images/help/repository/view-run-billable-time.png) + + {% note %} + + **Note:** The billable time shown does not include any rounding or minute multipliers. To view your total {% data variables.product.prodname_actions %} usage, including rounding and minute multipliers, see "[Viewing your {% data variables.product.prodname_actions %} usage](/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage)." + + {% endnote %} diff --git a/translations/ru-RU/content/actions/managing-workflow-runs/viewing-workflow-run-history.md b/translations/ru-RU/content/actions/managing-workflow-runs/viewing-workflow-run-history.md new file mode 100644 index 000000000000..47ca04068ef3 --- /dev/null +++ b/translations/ru-RU/content/actions/managing-workflow-runs/viewing-workflow-run-history.md @@ -0,0 +1,18 @@ +--- +title: Viewing workflow run history +intro: You can view logs for each run of a workflow. Logs include the status for each job and step in a workflow. +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} diff --git a/translations/ru-RU/content/actions/quickstart.md b/translations/ru-RU/content/actions/quickstart.md new file mode 100644 index 000000000000..385de755775c --- /dev/null +++ b/translations/ru-RU/content/actions/quickstart.md @@ -0,0 +1,75 @@ +--- +title: Quickstart for GitHub Actions +intro: 'Add a {% data variables.product.prodname_actions %} workflow to an existing repository in 5 minutes or less.' +allowTitleToDifferFromFilename: true +redirect_from: + - /actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Introduction + +You only need an existing {% data variables.product.prodname_dotcom %} repository to create and run a {% data variables.product.prodname_actions %} workflow. In this guide, you'll add a workflow that lints multiple coding languages using the [{% data variables.product.prodname_dotcom %} Super-Linter action](https://github.com/github/super-linter). The workflow uses Super-Linter to validate your source code every time a new commit is pushed to your repository. + +### Creating your first workflow + +1. From your repository on {% data variables.product.prodname_dotcom %}, create a new file in the `.github/workflows` directory named `superlinter.yml`. For more information, see "[Creating new files](/github/managing-files-in-a-repository/creating-new-files)." +2. Copy the following YAML contents into the `superlinter.yml` file. **Note:** If your default branch is not `main`, update the value of `DEFAULT_BRANCH` to match your repository's default branch name. + {% raw %} + ```yaml + name: Super-Linter + + # Run this workflow every time a new commit pushed to your repository + on: push + + jobs: + # Set the job key. The key is displayed as the job name + # when a job name is not provided + super-lint: + # Name the Job + name: Lint code base + # Set the type of machine to run on + runs-on: ubuntu-latest + + steps: + # Checks out a copy of your repository on the ubuntu-latest machine + - name: Checkout code + uses: actions/checkout@v2 + + # Runs the Super-Linter action + - name: Run Super-Linter + uses: github/super-linter@v3 + env: + DEFAULT_BRANCH: main + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + ``` + {% endraw %} +3. To run your workflow, scroll to the bottom of the page and select **Create a new branch for this commit and start a pull request**. Then, to create a pull request, click **Propose new file**. ![Commit workflow file](/assets/images/commit-workflow-file.png) + +Committing the workflow file in your repository triggers the `push` event and runs your workflow. + +### Viewing your workflow results + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +1. In the left sidebar, click the **Lint code base** job. ![Lint code base job](/assets/images/help/repository/superlinter-lint-code-base-job.png) +{% data reusables.repositories.view-failed-job-results-superlinter %} + +### More starter workflows + +{% data variables.product.prodname_dotcom %} provides preconfigured workflow templates that you can start from to automate or create a continuous integration workflows. You can browse the full list of workflow templates in the {% if currentVersion == "free-pro-team@latest" %}[actions/starter-workflows](https://github.com/actions/starter-workflows) repository{% else %} `actions/starter-workflows` repository on {% data variables.product.product_location %}{% endif %}. + +### Дальнейшие шаги + +The super-linter workflow you just added runs any time code is pushed to your repository to help you spot errors and inconsistencies in your code. But, this is only the beginning of what you can do with {% data variables.product.prodname_actions %}. Your repository can contain multiple workflows that trigger different jobs based on different events. {% data variables.product.prodname_actions %} can help you automate nearly every aspect of your application development processes. Ready to get started? Here are some helpful resources for taking your next steps with {% data variables.product.prodname_actions %}: + +- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)" for an in-depth tutorial +- "[Guides](/actions/guides)" for specific uses cases and examples +- [github/super-linter](https://github.com/github/super-linter) for more details about configuring the Super-Linter action diff --git a/translations/ru-RU/content/actions/reference/authentication-in-a-workflow.md b/translations/ru-RU/content/actions/reference/authentication-in-a-workflow.md new file mode 100644 index 000000000000..69d98496d0fe --- /dev/null +++ b/translations/ru-RU/content/actions/reference/authentication-in-a-workflow.md @@ -0,0 +1,100 @@ +--- +title: Authentication in a workflow +intro: '{% data variables.product.prodname_dotcom %} provides a token that you can use to authenticate on behalf of {% data variables.product.prodname_actions %}.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /github/automating-your-workflow-with-github-actions/authenticating-with-the-github_token + - /actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token + - /actions/configuring-and-managing-workflows/authenticating-with-the-github_token +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +Anyone with `write` access to a repository can create, read, and use secrets. + +### About the `GITHUB_TOKEN` secret + +{% data variables.product.prodname_dotcom %} automatically creates a `GITHUB_TOKEN` secret to use in your workflow. You can use the `GITHUB_TOKEN` to authenticate in a workflow run. + +When you enable {% data variables.product.prodname_actions %}, {% data variables.product.prodname_dotcom %} installs a {% data variables.product.prodname_github_app %} on your repository. The `GITHUB_TOKEN` secret is a {% data variables.product.prodname_github_app %} installation access token. You can use the installation access token to authenticate on behalf of the {% data variables.product.prodname_github_app %} installed on your repository. The token's permissions are limited to the repository that contains your workflow. For more information, see "[Permissions for the `GITHUB_TOKEN`](#permissions-for-the-github_token)." + +Before each job begins, {% data variables.product.prodname_dotcom %} fetches an installation access token for the job. The token expires when the job is finished. + +The token is also available in the `github.token` context. For more information, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)." + +### Using the `GITHUB_TOKEN` in a workflow + +To use the `GITHUB_TOKEN` secret, you must reference it in your workflow file. Using a token might include passing the token as an input to an action that requires it, or making authenticated {% data variables.product.prodname_dotcom %} API calls. + +{% data reusables.github-actions.actions-do-not-trigger-workflows %} + +#### Example passing `GITHUB_TOKEN` as an input + +This example workflow uses the [labeler action](https://github.com/actions/labeler), which requires the `GITHUB_TOKEN` as the value for the `repo-token` input parameter: + + {% raw %} + ```yaml + name: Pull request labeler + on: + - pull_request + jobs: + triage: + runs-on: ubuntu-latest + steps: + - uses: actions/labeler@v2 + with: + repo-token: ${{ secrets.GITHUB_TOKEN }} + ``` + {% endraw %} + +#### Example calling the REST API + +You can use the `GITHUB_TOKEN` to make authenticated API calls. This example workflow creates an issue using the {% data variables.product.prodname_dotcom %} REST API: + + {% raw %} + ```yaml + name: Create issue on commit + on: + - push + jobs: + create_commit: + runs-on: ubuntu-latest + steps: + - name: Create issue using REST API + run: | + curl --request POST \ + --url https://api.github.com/repos/${{ github.repository }}/issues \ + --header 'authorization: Bearer ${{ secrets.GITHUB_TOKEN }}' \ + --header 'content-type: application/json' \ + --data '{ + "title": "Automated issue for commit: ${{ github.sha }}", + "body": "This issue was automatically created by the GitHub Action workflow **${{ github.workflow }}**. \n\n The commit hash was: _${{ github.sha }}_." + }' + ``` + {% endraw %} + +### Permissions for the `GITHUB_TOKEN` + +For information about the API endpoints {% data variables.product.prodname_github_apps %} can access with each permission, see "[{% data variables.product.prodname_github_app %} Permissions](/v3/apps/permissions/)." + +| Permission | Access type | Access by forked repos | +| ------------------- | ----------- | ---------------------- | +| actions | read/write | read | +| checks | read/write | read | +| contents | read/write | read | +| deployments | read/write | read | +| issues | read/write | read | +| метаданные | read | read | +| пакеты | read/write | read | +| pull requests | read/write | read | +| repository projects | read/write | read | +| statuses | read/write | read | + +If you need a token that requires permissions that aren't available in the `GITHUB_TOKEN`, you can create a personal access token and set it as a secret in your repository: + +1. Use or create a token with the appropriate permissions for that repository. For more information, see "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token)." +1. Add the token as a secret in your workflow's repository, and refer to it using the {%raw%}`${{ secrets.SECRET_NAME }}`{% endraw %} syntax. For more information, see "[Creating and using encrypted secrets](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)." diff --git a/translations/ru-RU/content/actions/reference/context-and-expression-syntax-for-github-actions.md b/translations/ru-RU/content/actions/reference/context-and-expression-syntax-for-github-actions.md index e7a6a90c097d..3b2cb5475867 100644 --- a/translations/ru-RU/content/actions/reference/context-and-expression-syntax-for-github-actions.md +++ b/translations/ru-RU/content/actions/reference/context-and-expression-syntax-for-github-actions.md @@ -81,27 +81,27 @@ The `github` context contains information about the workflow run and the event t {% data reusables.github-actions.github-context-warning %} -| Property name | Тип | Description | -| ------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `github` | `объект` | The top-level context available during any job or step in a workflow. | -| `github.event` | `объект` | The full event webhook payload. For more information, see "[Events that trigger workflows](/articles/events-that-trigger-workflows/)." You can access individual properties of the event using this context. | -| `github.event_path` | `строка` | The path to the full event webhook payload on the runner. | -| `github.workflow` | `строка` | The name of the workflow. If the workflow file doesn't specify a `name`, the value of this property is the full path of the workflow file in the repository. | -| `github.job` | `строка` | The [`job_id`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_id) of the current job. | -| `github.run_id` | `строка` | {% data reusables.github-actions.run_id_description %} | -| `github.run_number` | `строка` | {% data reusables.github-actions.run_number_description %} | -| `github.actor` | `строка` | The login of the user that initiated the workflow run. | -| `github.repository` | `строка` | The owner and repository name. For example, `Codertocat/Hello-World`. | -| `github.repository_owner` | `строка` | The repository owner's name. For example, `Codertocat`. | -| `github.event_name` | `строка` | The name of the event that triggered the workflow run. | -| `github.sha` | `строка` | The commit SHA that triggered the workflow run. | -| `github.ref` | `строка` | The branch or tag ref that triggered the workflow run. | -| `github.head_ref` | `строка` | The `head_ref` or source branch of the pull request in a workflow run. This property is only available when the event that triggers a workflow run is a `pull_request`. | -| `github.base_ref` | `строка` | The `base_ref` or target branch of the pull request in a workflow run. This property is only available when the event that triggers a workflow run is a `pull_request`. | -| `github.token` | `строка` | A token to authenticate on behalf of the GitHub App installed on your repository. This is functionally equivalent to the `GITHUB_TOKEN` secret. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)." | -| `github.workspace` | `строка` | The default working directory for steps and the default location of your repository when using the [`checkout`](https://github.com/actions/checkout) action. | +| Property name | Тип | Description | +| ------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `github` | `объект` | The top-level context available during any job or step in a workflow. | | `github.action` | `строка` | The name of the action currently running. {% data variables.product.prodname_dotcom %} removes special characters or uses the name `run` when the current step runs a script. If you use the same action more than once in the same job, the name will include a suffix with the sequence number. For example, the first script you run will have the name `run1`, and the second script will be named `run2`. Similarly, the second invocation of `actions/checkout` will be `actionscheckout2`. | -| `github.action_path` | `строка` | The path where your action is located. You can use this path to easily access files located in the same repository as your action. This attribute is only supported in composite run steps actions. | +| `github.action_path` | `строка` | The path where your action is located. You can use this path to easily access files located in the same repository as your action. This attribute is only supported in composite run steps actions. | +| `github.actor` | `строка` | The login of the user that initiated the workflow run. | +| `github.base_ref` | `строка` | The `base_ref` or target branch of the pull request in a workflow run. This property is only available when the event that triggers a workflow run is a `pull_request`. | +| `github.event` | `объект` | The full event webhook payload. For more information, see "[Events that trigger workflows](/articles/events-that-trigger-workflows/)." You can access individual properties of the event using this context. | +| `github.event_name` | `строка` | The name of the event that triggered the workflow run. | +| `github.event_path` | `строка` | The path to the full event webhook payload on the runner. | +| `github.head_ref` | `строка` | The `head_ref` or source branch of the pull request in a workflow run. This property is only available when the event that triggers a workflow run is a `pull_request`. | +| `github.job` | `строка` | The [`job_id`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_id) of the current job. | +| `github.ref` | `строка` | The branch or tag ref that triggered the workflow run. | +| `github.repository` | `строка` | The owner and repository name. For example, `Codertocat/Hello-World`. | +| `github.repository_owner` | `строка` | The repository owner's name. For example, `Codertocat`. | +| `github.run_id` | `строка` | {% data reusables.github-actions.run_id_description %} +| `github.run_number` | `строка` | {% data reusables.github-actions.run_number_description %} +| `github.sha` | `строка` | The commit SHA that triggered the workflow run. | +| `github.token` | `строка` | A token to authenticate on behalf of the GitHub App installed on your repository. This is functionally equivalent to the `GITHUB_TOKEN` secret. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)." | +| `github.workflow` | `строка` | The name of the workflow. If the workflow file doesn't specify a `name`, the value of this property is the full path of the workflow file in the repository. | +| `github.workspace` | `строка` | The default working directory for steps and the default location of your repository when using the [`checkout`](https://github.com/actions/checkout) action. | #### **`env` context** @@ -121,17 +121,17 @@ You can only use the `env` context in the value of the `with` and `name` keys, o The `job` context contains information about the currently running job. -| Property name | Тип | Description | -| ----------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `задание` | `объект` | This context changes for each job in a workflow run. You can access this context from any step in a job. | -| `job.status` | `строка` | The current status of the job. Possible values are `success`, `failure`, or `cancelled`. | +| Property name | Тип | Description | +| ----------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `задание` | `объект` | This context changes for each job in a workflow run. You can access this context from any step in a job. | | `job.container` | `объект` | Information about the job's container. For more information about containers, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idcontainer)." | -| `job.container.network` | `строка` | The id of the container network. The runner creates the network used by all containers in a job. | -| `job.container.id` | `строка` | The id of the container. | +| `job.container.id` | `строка` | The id of the container. | +| `job.container.network` | `строка` | The id of the container network. The runner creates the network used by all containers in a job. | | `job.services` | `объект` | The service containers created for a job. For more information about service containers, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idservices)." | -| `job.services..id` | `строка` | The id of the service container. | -| `job.services..ports` | `объект` | The exposed ports of the service container. | -| `job.services..network` | `строка` | The id of the service container network. The runner creates the network used by all containers in a job. | +| `job.services..id` | `строка` | The id of the service container. | +| `job.services..network` | `строка` | The id of the service container network. The runner creates the network used by all containers in a job. | +| `job.services..ports` | `объект` | The exposed ports of the service container. | +| `job.status` | `строка` | The current status of the job. Possible values are `success`, `failure`, or `cancelled`. | #### **`steps` context** @@ -140,31 +140,31 @@ The `steps` context contains information about the steps in the current job that | Property name | Тип | Description | | --------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `steps` | `объект` | This context changes for each step in a job. You can access this context from any step in a job. | -| `steps..outputs` | `объект` | The set of outputs defined for the step. For more information, see "[Metadata syntax for {% data variables.product.prodname_actions %}](/articles/metadata-syntax-for-github-actions#outputs)." | -| `steps..outputs.` | `строка` | The value of a specific output. | -| `steps..outcome` | `строка` | The result of a completed step before [`continue-on-error`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepscontinue-on-error) is applied. Possible values are `success`, `failure`, `cancelled`, or `skipped`. When a `continue-on-error` step fails, the `outcome` is `failure`, but the final `conclusion` is `success`. | +| `steps..outputs` | `объект` | The set of outputs defined for the step. For more information, see "[Metadata syntax for {% data variables.product.prodname_actions %}](/articles/metadata-syntax-for-github-actions#outputs)." | | `steps..conclusion` | `строка` | The result of a completed step after [`continue-on-error`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepscontinue-on-error) is applied. Possible values are `success`, `failure`, `cancelled`, or `skipped`. When a `continue-on-error` step fails, the `outcome` is `failure`, but the final `conclusion` is `success`. | +| `steps..outcome` | `строка` | The result of a completed step before [`continue-on-error`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepscontinue-on-error) is applied. Possible values are `success`, `failure`, `cancelled`, or `skipped`. When a `continue-on-error` step fails, the `outcome` is `failure`, but the final `conclusion` is `success`. | +| `steps..outputs.` | `строка` | The value of a specific output. | #### **`runner` context** The `runner` context contains information about the runner that is executing the current job. -| Property name | Тип | Description | -| ------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `runner.os` | `строка` | The operating system of the runner executing the job. Possible values are `Linux`, `Windows`, or `macOS`. | -| `runner.temp` | `строка` | The path of the temporary directory for the runner. This directory is guaranteed to be empty at the start of each job, even on self-hosted runners. | -| `runner.tool_cache` | `строка` | The path of the directory containing some of the preinstalled tools for {% data variables.product.prodname_dotcom %}-hosted runners. For more information, see "[Software installed on GitHub-hosted runners](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)." | +| Property name | Тип | Description | +| ------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `runner.os` | `строка` | The operating system of the runner executing the job. Possible values are `Linux`, `Windows`, or `macOS`. | +| `runner.temp` | `строка` | The path of the temporary directory for the runner. This directory is guaranteed to be empty at the start of each job, even on self-hosted runners. | +| `runner.tool_cache` | `строка` | The path of the directory containing some of the preinstalled tools for {% data variables.product.prodname_dotcom %}-hosted runners. For more information, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". | #### **`needs` context** The `needs` context contains outputs from all jobs that are defined as a dependency of the current job. For more information on defining job dependencies, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)." -| Property name | Тип | Description | -| -------------------------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------- | -| `needs.` | `объект` | A single job that the current job depends on. | -| `needs..result` | `строка` | The result of a job that the current job depends on. Possible values are `success`, `failure`, or `cancelled`. | -| `needs..outputs` | `объект` | The set of outputs of a job that the current job depends on. | -| `needs..outputs.` | `строка` | The value of a specific output for a job that the current job depends on. | +| Property name | Тип | Description | +| -------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------- | +| `needs.` | `объект` | A single job that the current job depends on. | +| `needs..outputs` | `объект` | The set of outputs of a job that the current job depends on. | +| `needs..outputs.` | `строка` | The value of a specific output for a job that the current job depends on. | +| `needs..result` | `строка` | The result of a job that the current job depends on. Possible values are `success`, `failure`, `cancelled`, or `skipped`. | #### Example printing context information to the log file @@ -179,7 +179,7 @@ on: push jobs: one: - runs-on: ubuntu-16.04 + runs-on: ubuntu-latest steps: - name: Dump GitHub context env: diff --git a/translations/ru-RU/content/actions/reference/encrypted-secrets.md b/translations/ru-RU/content/actions/reference/encrypted-secrets.md new file mode 100644 index 000000000000..b4236ad069e6 --- /dev/null +++ b/translations/ru-RU/content/actions/reference/encrypted-secrets.md @@ -0,0 +1,221 @@ +--- +title: Encrypted secrets +intro: Encrypted secrets allow you to store sensitive information in your repository or organization. +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets + - /actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets + - /actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### About encrypted secrets + +Secrets are encrypted environment variables that you create in a repository or organization. The secrets you create are available to use in {% data variables.product.prodname_actions %} workflows. {% data variables.product.prodname_dotcom %} uses a [libsodium sealed box](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes) to help ensure that secrets are encrypted before they reach {% data variables.product.prodname_dotcom %}, and remain encrypted until you use them in a workflow. + +{% data reusables.github-actions.secrets-org-level-overview %} + +#### Naming your secrets + +The following rules apply to secret names: + +* Secret names can only contain alphanumeric characters (`[a-z]`, `[A-Z]`, `[0-9]`) or underscores (`_`). Spaces are not allowed. +* Secret names must not start with the `GITHUB_` prefix. +* Secret names must not start with a number. +* Secret names must be unique at the level they are created at. For example, a secret created at the organization-level must have a unique name at that level, and a secret created at the repository-level must have a unique name in that repository. If an organization-level secret has the same name as a repository-level secret, then the repository-level secret takes precedence. + +To help ensure that {% data variables.product.prodname_dotcom %} redacts your secret in logs, avoid using structured data as the values of secrets. For example, avoid creating secrets that contain JSON or encoded Git blobs. + +#### Accessing your secrets + +To make a secret available to an action, you must set the secret as an input or environment variable in the workflow file. Review the action's README file to learn about which inputs and environment variables the action expects. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)." + +You can use and read encrypted secrets in a workflow file if you have access to edit the file. For more information, see "[Access permissions on {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/access-permissions-on-github)." + +{% warning %} + +**Warning:** {% data variables.product.prodname_dotcom %} automatically redacts secrets printed to the log, but you should avoid printing secrets to the log intentionally. + +{% endwarning %} + +You can also manage secrets using the REST API. For more information, see "[Secrets](/v3/actions/secrets/)." + +#### Limiting credential permissions + +When generating credentials, we recommend that you grant the minimum permissions possible. For example, instead of using personal credentials, use [deploy keys](/v3/guides/managing-deploy-keys/#deploy-keys) or a service account. Consider granting read-only permissions if that's all that is needed, and limit access as much as possible. When generating a personal access token (PAT), select the fewest scopes necessary. + +### Creating encrypted secrets for a repository + +{% data reusables.github-actions.permissions-statement-secrets-repository %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.github-actions.sidebar-secret %} +1. Click **Add a new secret**. +1. Type a name for your secret in the **Name** input box. +1. Enter the value for your secret. +1. Click **Add secret**. + +If your repository can access secrets from the parent organization, then those secrets are also listed on this page. + +### Creating encrypted secrets for an organization + +When creating a secret in an organization, you can use a policy to limit which repositories can access that secret. For example, you can grant access to all repositories, or limit access to only private repositories or a specified list of repositories. + +{% data reusables.github-actions.permissions-statement-secrets-organization %} + +{% data reusables.organizations.navigate-to-org %} +{% data reusables.organizations.org_settings %} +{% data reusables.github-actions.sidebar-secret %} +1. Click **New secret**. +1. Type a name for your secret in the **Name** input box. +1. Enter the **Value** for your secret. +1. From the **Repository access** dropdown list, choose an access policy. +1. Click **Add secret**. + +### Reviewing access to organization-level secrets + +You can check which access policies are being applied to a secret in your organization. + +{% data reusables.organizations.navigate-to-org %} +{% data reusables.organizations.org_settings %} +{% data reusables.github-actions.sidebar-secret %} +1. The list of secrets includes any configured permissions and policies. Например: ![Secrets list](/assets/images/help/settings/actions-org-secrets-list.png) +1. For more details on the configured permissions for each secret, click **Update**. + +### Using encrypted secrets in a workflow + +With the exception of `GITHUB_TOKEN`, secrets are not passed to the runner when a workflow is triggered from a forked repository. + +To provide an action with a secret as an input or environment variable, you can use the `secrets` context to access secrets you've created in your repository. For more information, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)" and "[Workflow syntax for {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)." + +{% raw %} +```yaml +steps: + - name: Hello world action + with: # Set the secret as an input + super_secret: ${{ secrets.SuperSecret }} + env: # Or as an environment variable + super_secret: ${{ secrets.SuperSecret }} +``` +{% endraw %} + +Avoid passing secrets between processes from the command line, whenever possible. Command-line processes may be visible to other users (using the `ps` command) or captured by [security audit events](https://docs.microsoft.com/en-us/windows-server/identity/ad-ds/manage/component-updates/command-line-process-auditing). To help protect secrets, consider using environment variables, `STDIN`, or other mechanisms supported by the target process. + +If you must pass secrets within a command line, then enclose them within the proper quoting rules. Secrets often contain special characters that may unintentionally affect your shell. To escape these special characters, use quoting with your environment variables. Например: + +#### Example using Bash + +{% raw %} +```yaml +steps: + - shell: bash + env: + SUPER_SECRET: ${{ secrets.SuperSecret }} + run: | + example-command "$SUPER_SECRET" +``` +{% endraw %} + +#### Example using PowerShell + +{% raw %} +```yaml +steps: + - shell: pwsh + env: + SUPER_SECRET: ${{ secrets.SuperSecret }} + run: | + example-command "$env:SUPER_SECRET" +``` +{% endraw %} + +#### Example using Cmd.exe + +{% raw %} +```yaml +steps: + - shell: cmd + env: + SUPER_SECRET: ${{ secrets.SuperSecret }} + run: | + example-command "%SUPER_SECRET%" +``` +{% endraw %} + +### Limits for secrets + +Your workflow can have up to 100 secrets. The names of secret environment variables must be unique in a repository. + +Secrets are limited to 64 KB in size. To use secrets that are larger than 64 KB, you can store encrypted secrets in your repository and save the decryption passphrase as a secret on {% data variables.product.prodname_dotcom %}. For example, you can use `gpg` to encrypt your credentials locally before checking the file in to your repository on {% data variables.product.prodname_dotcom %}. For more information, see the "[gpg manpage](https://www.gnupg.org/gph/de/manual/r1023.html)." + +{% warning %} + +**Warning**: Be careful that your secrets do not get printed when your action runs. When using this workaround, {% data variables.product.prodname_dotcom %} does not redact secrets that are printed in logs. + +{% endwarning %} + +1. Run the following command from your terminal to encrypt the `my_secret.json` file using `gpg` and the AES256 cipher algorithm. + + ``` shell + $ gpg --symmetric --cipher-algo AES256 my_secret.json + ``` + +1. You will be prompted to enter a passphrase. Remember the passphrase, because you'll need to create a new secret on {% data variables.product.prodname_dotcom %} that uses the passphrase as the value. + +1. Create a new secret that contains the passphrase. For example, create a new secret with the name `LARGE_SECRET_PASSPHRASE` and set the value of the secret to the passphrase you selected in the step above. + +1. Copy your encrypted file into your repository and commit it. In this example, the encrypted file is `my_secret.json.gpg`. + +1. Create a shell script to decrypt the password. Save this file as `decrypt_secret.sh`. + + ``` shell + #!/bin/sh + + # Decrypt the file + mkdir $HOME/secrets + # --batch to prevent interactive command + # --yes to assume "yes" for questions + gpg --quiet --batch --yes --decrypt --passphrase="$LARGE_SECRET_PASSPHRASE" \ + --output $HOME/secrets/my_secret.json my_secret.json.gpg + ``` + +1. Ensure your shell script is executable before checking it in to your repository. + + ``` shell + $ chmod +x decrypt_secret.sh + $ git add decrypt_secret.sh + $ git commit -m "Add new decryption script" + $ git push + ``` + +1. From your workflow, use a `step` to call the shell script and decrypt the secret. To have a copy of your repository in the environment that your workflow runs in, you'll need to use the [`actions/checkout`](https://github.com/actions/checkout) action. Reference your shell script using the `run` command relative to the root of your repository. + +{% raw %} + ```yaml + name: Workflows with large secrets + + on: push + + jobs: + my-job: + name: My Job + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Decrypt large secret + run: ./.github/scripts/decrypt_secret.sh + env: + LARGE_SECRET_PASSPHRASE: ${{ secrets.LARGE_SECRET_PASSPHRASE }} + # This command is just an example to show your secret being printed + # Ensure you remove any print statements of your secrets. GitHub does + # not hide secrets that use this workaround. + - name: Test printing your secret (Remove this step in production) + run: cat $HOME/secrets/my_secret.json + ``` +{% endraw %} diff --git a/translations/ru-RU/content/actions/reference/environment-variables.md b/translations/ru-RU/content/actions/reference/environment-variables.md new file mode 100644 index 000000000000..4c8c790b0053 --- /dev/null +++ b/translations/ru-RU/content/actions/reference/environment-variables.md @@ -0,0 +1,69 @@ +--- +title: Переменные окружения +intro: '{% data variables.product.prodname_dotcom %} sets default environment variables for each {% data variables.product.prodname_actions %} workflow run. You can also set custom environment variables in your workflow file.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /github/automating-your-workflow-with-github-actions/using-environment-variables + - /actions/automating-your-workflow-with-github-actions/using-environment-variables + - /actions/configuring-and-managing-workflows/using-environment-variables +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### About environment variables + +{% data variables.product.prodname_dotcom %} sets default environment variables that are available to every step in a workflow run. Environment variables are case-sensitive. Commands run in actions or steps can create, read, and modify environment variables. + +To set custom environment variables, you need to specify the variables in the workflow file. You can define environment variables for a step, job, or entire workflow using the [`jobs..steps.env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv), [`jobs..env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idenv), and [`env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env) keywords. For more information, see "[Workflow syntax for {% data variables.product.prodname_dotcom %}](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)." + +```yaml +steps: + - name: Hello world + run: echo Hello world $FIRST_NAME $middle_name $Last_Name! + env: + FIRST_NAME: Mona + middle_name: The + Last_Name: Octocat +``` + +You can also use the {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}`GITHUB_ENV` environment file{% else %} `set-env` workflow command{% endif %} to set an environment variable that the following steps in a workflow can use. The {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}environment file{% else %} `set-env` command{% endif %} can be used directly by an action or as a shell command in a workflow file using the `run` keyword. For more information, see "[Workflow commands for {% data variables.product.prodname_actions %}](/actions/reference/workflow-commands-for-github-actions/#setting-an-environment-variable)." + +### Default environment variables + +We strongly recommend that actions use environment variables to access the filesystem rather than using hardcoded file paths. {% data variables.product.prodname_dotcom %} sets environment variables for actions to use in all runner environments. + +| Environment variable | Description | +| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `CI` | Always set to `true`. | +| `HOME` | The path to the {% data variables.product.prodname_dotcom %} home directory used to store user data. For example, `/github/home`. | +| `GITHUB_WORKFLOW` | The name of the workflow. | +| `GITHUB_RUN_ID` | {% data reusables.github-actions.run_id_description %} +| `GITHUB_RUN_NUMBER` | {% data reusables.github-actions.run_number_description %} +| `GITHUB_ACTION` | The unique identifier (`id`) of the action. | +| `GITHUB_ACTIONS` | Always set to `true` when {% data variables.product.prodname_actions %} is running the workflow. You can use this variable to differentiate when tests are being run locally or by {% data variables.product.prodname_actions %}. | +| `GITHUB_ACTOR` | The name of the person or app that initiated the workflow. For example, `octocat`. | +| `GITHUB_REPOSITORY` | The owner and repository name. For example, `octocat/Hello-World`. | +| `GITHUB_EVENT_NAME` | The name of the webhook event that triggered the workflow. | +| `GITHUB_EVENT_PATH` | The path of the file with the complete webhook event payload. For example, `/github/workflow/event.json`. | +| `GITHUB_WORKSPACE` | The {% data variables.product.prodname_dotcom %} workspace directory path. The workspace directory is a copy of your repository if your workflow uses the [actions/checkout](https://github.com/actions/checkout) action. If you don't use the `actions/checkout` action, the directory will be empty. For example, `/home/runner/work/my-repo-name/my-repo-name`. | +| `GITHUB_SHA` | The commit SHA that triggered the workflow. For example, `ffac537e6cbbf934b08745a378932722df287a53`. | +| `GITHUB_REF` | The branch or tag ref that triggered the workflow. For example, `refs/heads/feature-branch-1`. If neither a branch or tag is available for the event type, the variable will not exist. | +| `GITHUB_HEAD_REF` | Only set for forked repositories. The branch of the head repository. | +| `GITHUB_BASE_REF` | Only set for forked repositories. The branch of the base repository. | +| `GITHUB_SERVER_URL` | Returns the URL of the {% data variables.product.product_name %} server. For example: `https://{% data variables.product.product_url %}`. | +| `GITHUB_API_URL` | Returns the API URL. For example: `{% data variables.product.api_url_code %}`. | +| `GITHUB_GRAPHQL_URL` | Returns the GraphQL API URL. For example: `{% data variables.product.graphql_url_code %}`. | + +### Naming conventions for environment variables + +{% note %} + +**Note:** {% data variables.product.prodname_dotcom %} reserves the `GITHUB_` environment variable prefix for internal use by {% data variables.product.prodname_dotcom %}. Setting an environment variable or secret with the `GITHUB_` prefix will result in an error. + +{% endnote %} + +Any new environment variables you set that point to a location on the filesystem should have a `_PATH` suffix. The `HOME` and `GITHUB_WORKSPACE` default variables are exceptions to this convention because the words "home" and "workspace" already imply a location. diff --git a/translations/ru-RU/content/actions/reference/events-that-trigger-workflows.md b/translations/ru-RU/content/actions/reference/events-that-trigger-workflows.md index dd5fd1c5f23e..ad1a1727b9d2 100644 --- a/translations/ru-RU/content/actions/reference/events-that-trigger-workflows.md +++ b/translations/ru-RU/content/actions/reference/events-that-trigger-workflows.md @@ -15,31 +15,142 @@ versions: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -### About workflow events +### Configuring workflow events -You can configure your workflow to run when webhook events are created from activity on {% data variables.product.product_name %}. Workflows can use more than one webhook event to trigger a workflow run. For more information, see "[Webhooks](/webhooks)." For more information about the `on` syntax, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#on)." +You can configure workflows to run for one or more events using the `on` workflow syntax. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#on)." + +{% data reusables.github-actions.actions-on-examples %} + +{% note %} + +**Note:** You cannot trigger new workflow runs using the `GITHUB_TOKEN`. For more information, see "[Triggering new workflows using a personal access token](#triggering-new-workflows-using-a-personal-access-token)." + +{% endnote %} The following steps occur to trigger a workflow run: -1. An event occurs on your repository, and the resulting event webhook has an associated commit SHA and Git ref. -1. The `.github/workflows` directory in your repository is searched for workflow files at the associated commit SHA or Git ref. The workflow files must be present in that commit SHA or Git ref to be considered. +1. An event occurs on your repository, and the resulting event has an associated commit SHA and Git ref. +2. The `.github/workflows` directory in your repository is searched for workflow files at the associated commit SHA or Git ref. The workflow files must be present in that commit SHA or Git ref to be considered. For example, if the event occurred on a particular repository branch, then the workflow files must be present in the repository on that branch. 1. The workflow files for that commit SHA and Git ref are inspected, and a new workflow run is triggered for any workflows that have `on:` values that match the triggering event. The workflow runs on your repository's code at the same commit SHA and Git ref that triggered the event. When a workflow runs, {% data variables.product.product_name %} sets the `GITHUB_SHA` (commit SHA) and `GITHUB_REF` (Git ref) environment variables in the runner environment. For more information, see "[Using environment variables](/actions/automating-your-workflow-with-github-actions/using-environment-variables)." +### Scheduled events + +The `schedule` event allows you to trigger a workflow at a scheduled time. + +#### `расписание` + +| Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` | +| --------------------- | -------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| n/a | n/a | Last commit on default branch | Default branch | When the scheduled workflow is set to run. A scheduled workflow uses [POSIX cron syntax](https://pubs.opengroup.org/onlinepubs/9699919799/utilities/crontab.html#tag_20_25_07). For more information, see "[Triggering a workflow with events](/articles/configuring-a-workflow/#triggering-a-workflow-with-events)." | + +{% data reusables.repositories.actions-scheduled-workflow-example %} + +Cron syntax has five fields separated by a space, and each field represents a unit of time. + +``` +┌───────────── minute (0 - 59) +│ ┌───────────── hour (0 - 23) +│ │ ┌───────────── day of the month (1 - 31) +│ │ │ ┌───────────── month (1 - 12 or JAN-DEC) +│ │ │ │ ┌───────────── day of the week (0 - 6 or SUN-SAT) +│ │ │ │ │ +│ │ │ │ │ +│ │ │ │ │ +* * * * * +``` + +You can use these operators in any of the five fields: + +| Operator | Description | Пример | +| -------- | -------------------- | -------------------------------------------------------------------------------------------------- | +| * | Any value | `* * * * *` runs every minute of every day. | +| , | Value list separator | `2,10 4,5 * * *` runs at minute 2 and 10 of the 4th and 5th hour of every day. | +| - | Range of values | `0 4-6 * * *` runs at minute 0 of the 4th, 5th, and 6th hour. | +| / | Step values | `20/15 * * * *` runs every 15 minutes starting from minute 20 through 59 (minutes 20, 35, and 50). | + {% note %} -**Note:** You cannot trigger new workflow runs using the `GITHUB_TOKEN`. For more information, see "[Triggering new workflows using a personal access token](#triggering-new-workflows-using-a-personal-access-token)." +**Note:** {% data variables.product.prodname_actions %} does not support the non-standard syntax `@yearly`, `@monthly`, `@weekly`, `@daily`, `@hourly`, and `@reboot`. {% endnote %} -{% data reusables.github-actions.actions-on-examples %} +You can use [crontab guru](https://crontab.guru/) to help generate your cron syntax and confirm what time it will run. To help you get started, there is also a list of [crontab guru examples](https://crontab.guru/examples.html). + +### Manual events + +You can manually trigger workflow runs. To trigger specific workflows in a repository, use the `workflow_dispatch` event. To trigger more than one workflow in a repository and create custom events and event types, use the `repository_dispatch` event. + +#### `workflow_dispatch` + +| Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` | +| ---------------------------------------------------------------- | -------------- | -------------------------------------- | ----------------------------- | +| [workflow_dispatch](/webhooks/event-payloads/#workflow_dispatch) | n/a | Last commit on the `GITHUB_REF` branch | Branch that received dispatch | + +You can configure custom-defined input properties, default input values, and required inputs for the event directly in your workflow. When the workflow runs, you can access the input values in the `github.event.inputs` context. For more information, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)." + +You can manually trigger a workflow run using the {% data variables.product.product_name %} API and from {% data variables.product.product_name %}. For more information, see "[Manually running a workflow](/actions/managing-workflow-runs/manually-running-a-workflow)." + + When you trigger the event on {% data variables.product.prodname_dotcom %}, you can provide the `ref` and any `inputs` directly on {% data variables.product.prodname_dotcom %}. For more information, see "[Using inputs and outputs with an action](/actions/learn-github-actions/finding-and-customizing-actions#using-inputs-and-outputs-with-an-action)." + + To trigger the custom `workflow_dispatch` webhook event using the REST API, you must send a `POST` request to a {% data variables.product.prodname_dotcom %} API endpoint and provide the `ref` and any required `inputs`. For more information, see the "[Create a workflow dispatch event](/rest/reference/actions/#create-a-workflow-dispatch-event)" REST API endpoint. + +##### Example workflow configuration + +This example defines the `name` and `home` inputs and prints them using the `github.event.inputs.name` and `github.event.inputs.home` contexts. If a `name` isn't provided, the default value 'Mona the Octocat' is printed. + +{% raw %} +```yaml +name: Manually triggered workflow +on: + workflow_dispatch: + inputs: + name: + description: 'Person to greet' + required: true + default: 'Mona the Octocat' + home: + description: 'location' + required: false + +jobs: + say_hello: + runs-on: ubuntu-latest + steps: + - run: | + echo "Hello ${{ github.event.inputs.name }}!" + echo "- in ${{ github.event.inputs.home }}!" +``` +{% endraw %} + +#### `repository_dispatch` + +| Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` | +| -------------------------------------------------------------------- | -------------- | -------------------------------------- | ----------------------------- | +| [repository_dispatch](/webhooks/event-payloads/#repository_dispatch) | n/a | Last commit on the `GITHUB_REF` branch | Branch that received dispatch | + +{% data reusables.github-actions.branch-requirement %} + +You can use the {% data variables.product.product_name %} API to trigger a webhook event called [`repository_dispatch`](/webhooks/event-payloads/#repository_dispatch) when you want to trigger a workflow for activity that happens outside of {% data variables.product.prodname_dotcom %}. For more information, see "[Create a repository dispatch event](/v3/repos/#create-a-repository-dispatch-event)." + +To trigger the custom `repository_dispatch` webhook event, you must send a `POST` request to a {% data variables.product.product_name %} API endpoint and provide an `event_type` name to describe the activity type. To trigger a workflow run, you must also configure your workflow to use the `repository_dispatch` event. + +##### Пример + +By default, all `event_types` trigger a workflow to run. You can limit your workflow to run when a specific `event_type` value is sent in the `repository_dispatch` webhook payload. You define the event types sent in the `repository_dispatch` payload when you create the repository dispatch event. + +```yaml +on: + repository_dispatch: + types: [opened, deleted] +``` ### Webhook events -You can configure your workflow to run when webhook events are created on {% data variables.product.product_name %}. Some events have more than one activity type that triggers the event. If more than one activity type triggers the event, you can specify which activity types will trigger the workflow to run. +You can configure your workflow to run when webhook events are created on {% data variables.product.product_name %}. Some events have more than one activity type that triggers the event. If more than one activity type triggers the event, you can specify which activity types will trigger the workflow to run. For more information, see "[Webhooks](/webhooks)." #### `check_run` @@ -189,9 +300,9 @@ Runs your workflow anytime the `issue_comment` event occurs. {% data reusables.d {% data reusables.github-actions.branch-requirement %} -| Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` | -| ---------------------------------------------------------- | ----------------------------------------------------------------- | ----------------------------- | -------------- | -| [`issue_comment`](/v3/activity/event_types/#issue_comment) | - `created`
    - `edited`
    - `deleted`
    | Last commit on default branch | Default branch | +| Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` | +| --------------------------------------------------------- | ----------------------------------------------------------------- | ----------------------------- | -------------- | +| [`issue_comment`](/rest/reference/activity#issue_comment) | - `created`
    - `edited`
    - `deleted`
    | Last commit on default branch | Default branch | {% data reusables.developer-site.limit_workflow_to_activity_types %} @@ -265,7 +376,7 @@ on: #### `page_build` -Runs your workflow anytime someone pushes to a {% data variables.product.product_name %} Pages-enabled branch, which triggers the `page_build` event. For information about the REST API, see "[Pages](/v3/repos/pages/)." +Runs your workflow anytime someone pushes to a {% data variables.product.product_name %} Pages-enabled branch, which triggers the `page_build` event. For information about the REST API, see "[Edit repositories](/v3/repos/#edit)." {% data reusables.github-actions.branch-requirement %} @@ -440,7 +551,7 @@ on: pull_request_target types: [assigned, opened, synchronize, reopened] ``` -#### `запись` +#### `отправка` {% note %} @@ -450,9 +561,9 @@ on: pull_request_target Runs your workflow when someone pushes to a repository branch, which triggers the `push` event. -| Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` | -| ------------------------------------------ | -------------- | ---------------------------------------------------------------------- | ------------ | -| [`запись`](/webhooks/event-payloads/#push) | n/a | Commit pushed, unless deleting a branch (when it's the default branch) | Updated ref | +| Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` | +| -------------------------------------------- | -------------- | ---------------------------------------------------------------------- | ------------ | +| [`отправка`](/webhooks/event-payloads/#push) | n/a | Commit pushed, unless deleting a branch (when it's the default branch) | Updated ref | For example, you can run a workflow when the `push` event occurs. @@ -479,7 +590,7 @@ on: types: [published] ``` -#### `релиз` +#### `версия` {% note %} @@ -489,9 +600,9 @@ on: Runs your workflow anytime the `release` event occurs. {% data reusables.developer-site.multiple_activity_types %} For information about the REST API, see "[Releases](/v3/repos/releases/)." -| Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` | -| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- | -------------- | -| [`релиз`](/webhooks/event-payloads/#release) | - `published`{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}
    - `unpublished`
    - `created`
    - `edited`
    - `deleted`
    - `prereleased`
    - `released`{% endif %} | Last commit in the tagged release | Tag of release | +| Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` | +| --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- | -------------- | +| [`версия`](/webhooks/event-payloads/#release) | - `published`
    - `unpublished`
    - `created`
    - `edited`
    - `deleted`
    - `prereleased`
    - `released` | Last commit in the tagged release | Tag of release | {% data reusables.developer-site.limit_workflow_to_activity_types %} @@ -558,85 +669,6 @@ on: - requested ``` -### Scheduled events - -The `schedule` event allows you to trigger a workflow at a scheduled time. - -#### `расписание` - -| Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` | -| --------------------- | -------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| n/a | n/a | Last commit on default branch | Default branch | When the scheduled workflow is set to run. A scheduled workflow uses [POSIX cron syntax](https://pubs.opengroup.org/onlinepubs/9699919799/utilities/crontab.html#tag_20_25_07). For more information, see "[Triggering a workflow with events](/articles/configuring-a-workflow/#triggering-a-workflow-with-events)." | - -{% data reusables.repositories.actions-scheduled-workflow-example %} - -Cron syntax has five fields separated by a space, and each field represents a unit of time. - -``` -┌───────────── minute (0 - 59) -│ ┌───────────── hour (0 - 23) -│ │ ┌───────────── day of the month (1 - 31) -│ │ │ ┌───────────── month (1 - 12 or JAN-DEC) -│ │ │ │ ┌───────────── day of the week (0 - 6 or SUN-SAT) -│ │ │ │ │ -│ │ │ │ │ -│ │ │ │ │ -* * * * * -``` - -You can use these operators in any of the five fields: - -| Operator | Description | Пример | -| -------- | -------------------- | -------------------------------------------------------------------------------------------------- | -| * | Any value | `* * * * *` runs every minute of every day. | -| , | Value list separator | `2,10 4,5 * * *` runs at minute 2 and 10 of the 4th and 5th hour of every day. | -| - | Range of values | `0 4-6 * * *` runs at minute 0 of the 4th, 5th, and 6th hour. | -| / | Step values | `20/15 * * * *` runs every 15 minutes starting from minute 20 through 59 (minutes 20, 35, and 50). | - -{% note %} - -**Note:** {% data variables.product.prodname_actions %} does not support the non-standard syntax `@yearly`, `@monthly`, `@weekly`, `@daily`, `@hourly`, and `@reboot`. - -{% endnote %} - -You can use [crontab guru](https://crontab.guru/) to help generate your cron syntax and confirm what time it will run. To help you get started, there is also a list of [crontab guru examples](https://crontab.guru/examples.html). - -### Manual events - -You can manually trigger workflow runs. To trigger specific workflows in a repository, use the `workflow_dispatch` event. To trigger more than one workflow in a repository and create custom events and event types, use the `repository_dispatch` event. - -#### `workflow_dispatch` - -| Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` | -| ---------------------------------------------------------------- | -------------- | -------------------------------------- | ----------------------------- | -| [workflow_dispatch](/webhooks/event-payloads/#workflow_dispatch) | n/a | Last commit on the `GITHUB_REF` branch | Branch that received dispatch | - -You can manually trigger a workflow run using the {% data variables.product.product_name %} API and from {% data variables.product.product_name %}. To trigger the custom `workflow_dispatch` webhook event using the REST API, you must send a `POST` request to a {% data variables.product.prodname_dotcom %} API endpoint and provide the `ref` and any required `inputs`. For more information, see the "[Create a workflow dispatch event](/rest/reference/actions/#create-a-workflow-dispatch-event)" REST API endpoint. - - When you trigger the event on {% data variables.product.prodname_dotcom %}, you can provide the `ref` and any `inputs` directly on {% data variables.product.prodname_dotcom %}. For more information, see "[Configuring a workflow](/actions/configuring-and-managing-workflows/configuring-a-workflow#manually-running-a-workflow)." - -#### `repository_dispatch` - -| Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` | -| -------------------------------------------------------------------- | -------------- | -------------------------------------- | ----------------------------- | -| [repository_dispatch](/webhooks/event-payloads/#repository_dispatch) | n/a | Last commit on the `GITHUB_REF` branch | Branch that received dispatch | - -{% data reusables.github-actions.branch-requirement %} - -You can use the {% data variables.product.product_name %} API to trigger a webhook event called [`repository_dispatch`](/webhooks/event-payloads/#repository_dispatch) when you want to trigger a workflow for activity that happens outside of {% data variables.product.prodname_dotcom %}. For more information, see "[Create a repository dispatch event](/v3/repos/#create-a-repository-dispatch-event)." - -To trigger the custom `repository_dispatch` webhook event, you must send a `POST` request to a {% data variables.product.product_name %} API endpoint and provide an `event_type` name to describe the activity type. To trigger a workflow run, you must also configure your workflow to use the `repository_dispatch` event. - -##### Пример - -By default, all `event_types` trigger a workflow to run. You can limit your workflow to run when a specific `event_type` value is sent in the `repository_dispatch` webhook payload. You define the event types sent in the `repository_dispatch` payload when you create the repository dispatch event. - -```yaml -on: - repository_dispatch: - types: [opened, deleted] -``` - ### Triggering new workflows using a personal access token {% data reusables.github-actions.actions-do-not-trigger-workflows %} For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." diff --git a/translations/ru-RU/content/actions/reference/index.md b/translations/ru-RU/content/actions/reference/index.md index dd3a66636bac..8ba0434eae90 100644 --- a/translations/ru-RU/content/actions/reference/index.md +++ b/translations/ru-RU/content/actions/reference/index.md @@ -1,6 +1,8 @@ --- title: Reference -intro: 'Reference documentation for building actions, creating workflows, and other tools and information on {% data variables.product.prodname_actions %}.' +intro: 'Reference documentation for creating workflows, using GitHub-hosted runners, and authentication.' +redirect_from: + - /actions/configuring-and-managing-workflows/using-variables-and-secrets-in-a-workflow versions: free-pro-team: '*' enterprise-server: '>=2.22' @@ -9,9 +11,39 @@ versions: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} +### Workflow syntax + +The workflow file is written in YAML. In the YAML workflow file, you can use expression syntax to evaluate contextual information, literals, operators, and functions. Contextual information includes workflow, environment variables, secrets, and the events that triggered the workflow. When you use [`run`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun) in a workflow step to run shell commands, you can use specific workflow command syntax to set environment variables, set output parameters for subsequent steps, and set error or debug messages. + {% link_in_list /workflow-syntax-for-github-actions %} -{% link_in_list /events-that-trigger-workflows %} {% link_in_list /context-and-expression-syntax-for-github-actions %} {% link_in_list /workflow-commands-for-github-actions %} -{% link_in_list /virtual-environments-for-github-hosted-runners %} -{% link_in_list /software-installed-on-github-hosted-runners %} + +### События + +You can configure workflows to run when specific GitHub events occur, at a scheduled time, manually, or when events outside of GitHub occur. + +{% link_in_list /events-that-trigger-workflows %} + +### Authentication and secrets + +{% data variables.product.prodname_dotcom %} provides a token that you can use to authenticate on behalf of {% data variables.product.prodname_actions %}. You can also store sensitive information as a secret in your organization or repository. {% data variables.product.prodname_dotcom %} encrypts all secrets. + +{% link_in_list /authentication-in-a-workflow %} +{% link_in_list /encrypted-secrets %} + +### {% data variables.product.prodname_dotcom %}-hosted runners + +GitHub offers hosted virtual machines to run workflows. The virtual machine contains an environment with tools, packages, and environment variables for GitHub Actions to use. + +{% link_in_list /environment-variables %} +{% link_in_list /specifications-for-github-hosted-runners %} + +{% if currentVersion == "free-pro-team@latest" %} +### Administration + +When you run workflows on {% data variables.product.prodname_dotcom %}-hosted runners, there are usage limits and potential usage charges. You can also disable or restrict the usage of {% data variables.product.prodname_actions %} in a repository and organization. + +{% link_in_list /usage-limits-billing-and-administration %} + +{% endif %} diff --git a/translations/ru-RU/content/actions/reference/specifications-for-github-hosted-runners.md b/translations/ru-RU/content/actions/reference/specifications-for-github-hosted-runners.md new file mode 100644 index 000000000000..8f71a14af29b --- /dev/null +++ b/translations/ru-RU/content/actions/reference/specifications-for-github-hosted-runners.md @@ -0,0 +1,149 @@ +--- +title: Specifications for GitHub-hosted runners +intro: '{% data variables.product.prodname_dotcom %} offers hosted virtual machines to run workflows. The virtual machine contains an environment of tools, packages, and settings available for {% data variables.product.prodname_actions %} to use.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /articles/virtual-environments-for-github-actions + - /github/automating-your-workflow-with-github-actions/virtual-environments-for-github-actions + - /github/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners + - /actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners + - /actions/reference/virtual-environments-for-github-hosted-runners + - /actions/reference/software-installed-on-github-hosted-runners +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### About {% data variables.product.prodname_dotcom %}-hosted runners + +A {% data variables.product.prodname_dotcom %}-hosted runner is a virtual machine hosted by {% data variables.product.prodname_dotcom %} with the {% data variables.product.prodname_actions %} runner application installed. {% data variables.product.prodname_dotcom %} offers runners with Linux, Windows, and macOS operating systems. + +When you use a {% data variables.product.prodname_dotcom %}-hosted runner, machine maintenance and upgrades are taken care of for you. You can run workflows directly on the virtual machine or in a Docker container. + +You can specify the runner type for each job in a workflow. Each job in a workflow executes in a fresh instance of the virtual machine. All steps in the job execute in the same instance of the virtual machine, allowing the actions in that job to share information using the filesystem. + +{% data reusables.github-actions.runner-app-open-source %} + +#### Cloud hosts for {% data variables.product.prodname_dotcom %}-hosted runners + +{% data variables.product.prodname_dotcom %} hosts Linux and Windows runners on Standard_DS2_v2 virtual machines in Microsoft Azure with the {% data variables.product.prodname_actions %} runner application installed. The {% data variables.product.prodname_dotcom %}-hosted runner application is a fork of the Azure Pipelines Agent. Inbound ICMP packets are blocked for all Azure virtual machines, so ping or traceroute commands might not work. For more information about the Standard_DS2_v2 machine resources, see "[Dv2 and DSv2-series](https://docs.microsoft.com/en-us/azure/virtual-machines/dv2-dsv2-series#dsv2-series)" in the Microsoft Azure documentation. + +{% data variables.product.prodname_dotcom %} uses [MacStadium](https://www.macstadium.com/) to host the macOS runners. + +#### Administrative privileges of {% data variables.product.prodname_dotcom %}-hosted runners + +The Linux and macOS virtual machines both run using passwordless `sudo`. When you need to execute commands or install tools that require more privileges than the current user, you can use `sudo` without needing to provide a password. For more information, see the "[Sudo Manual](https://www.sudo.ws/man/1.8.27/sudo.man.html)." + +Windows virtual machines are configured to run as administrators with User Account Control (UAC) disabled. For more information, see "[How User Account Control works](https://docs.microsoft.com/en-us/windows/security/identity-protection/user-account-control/how-user-account-control-works)" in the Windows documentation. + +### Supported runners and hardware resources + +Each virtual machine has the same hardware resources available. + +- 2-core CPU +- 7 GB of RAM memory +- 14 GB of SSD disk space + +{% data reusables.github-actions.supported-github-runners %} + +{% data reusables.github-actions.ubuntu-runner-preview %} + +Workflow logs list the runner used to run a job. For more information, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)." + +### Supported software + +The software tools included in {% data variables.product.prodname_dotcom %}-hosted runners are updated weekly. For the latest list of included tools for each runner operating system, see the links below: + +* [Ubuntu 20.04 LTS](https://github.com/actions/virtual-environments/blob/main/images/linux/Ubuntu2004-README.md) +* [Ubuntu 18.04 LTS](https://github.com/actions/virtual-environments/blob/main/images/linux/Ubuntu1804-README.md) +* [Ubuntu 16.04 LTS](https://github.com/actions/virtual-environments/blob/main/images/linux/Ubuntu1604-README.md) +* [Windows Server 2019](https://github.com/actions/virtual-environments/blob/main/images/win/Windows2019-Readme.md) +* [Windows Server 2016](https://github.com/actions/virtual-environments/blob/main/images/win/Windows2016-Readme.md) +* [MacOS 10.15](https://github.com/actions/virtual-environments/blob/main/images/macos/macos-10.15-Readme.md) + +{% data reusables.github-actions.ubuntu-runner-preview %} + +{% data variables.product.prodname_dotcom %}-hosted runners include the operating system's default built-in tools, in addition to the packages listed in the above references. For example, Ubuntu and macOS runners include `grep`, `find`, and `which`, among other default tools. + +Workflow logs include a link to the preinstalled tools on the runner. For more information, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)." + +If there is a tool that you'd like to request, please open an issue at [actions/virtual-environments](https://github.com/actions/virtual-environments). + +### IP addresses + +{% note %} + +**Note:** If you use an IP address allow list for your {% data variables.product.prodname_dotcom %} organization or enterprise account, you cannot use {% data variables.product.prodname_dotcom %}-hosted runners and must instead use self-hosted runners. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners)." + +{% endnote %} + +Windows and Ubuntu runners are hosted in Azure and have the same IP address ranges as Azure Data centers. Currently, all Windows and Ubuntu {% data variables.product.prodname_dotcom %}-hosted runners are in the following Azure regions: + +- East US (`eastus`) +- East US 2 (`eastus2`) +- West US 2 (`westus2`) +- Central US (`centralus`) +- South Central US (`southcentralus`) + +Microsoft updates the Azure IP address ranges weekly in a JSON file that you can download from the [Azure IP Ranges and Service Tags - Public Cloud](https://www.microsoft.com/en-us/download/details.aspx?id=56519) website. You can use this range of IP addresses if you require an allow-list to prevent unauthorized access to your internal resources. + +The JSON file contains an array called `values`. Inside that array, you can find the supported IP addresses in an object with a `name` and `id` of the Azure region, for example `"AzureCloud.eastus2"`. + +You can find the supported IP address ranges in the `"addressPrefixes"` object. This is a condensed example of the JSON file. + +```json +{ + "changeNumber": 84, + "cloud": "Public", + "values": [ + { + "name": "AzureCloud.eastus2", + "id": "AzureCloud.eastus2", + "properties": { + "changeNumber": 33, + "region": "eastus2", + "platform": "Azure", + "systemService": "", + "addressPrefixes": [ + "13.68.0.0/17", + "13.77.64.0/18", + "13.104.147.0/25", + ... + ] + } + } + ] +} +``` + +### File systems + +{% data variables.product.prodname_dotcom %} executes actions and shell commands in specific directories on the virtual machine. The file paths on virtual machines are not static. Use the environment variables {% data variables.product.prodname_dotcom %} provides to construct file paths for the `home`, `workspace`, and `workflow` directories. + +| Directory | Environment variable | Description | +| --------------------- | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `home` | `HOME` | Contains user-related data. For example, this directory could contain credentials from a login attempt. | +| `workspace` | `GITHUB_WORKSPACE` | Actions and shell commands execute in this directory. An action can modify the contents of this directory, which subsequent actions can access. | +| `workflow/event.json` | `GITHUB_EVENT_PATH` | The `POST` payload of the webhook event that triggered the workflow. {% data variables.product.prodname_dotcom %} rewrites this each time an action executes to isolate file content between actions. | + +For a list of the environment variables {% data variables.product.prodname_dotcom %} creates for each workflow, see "[Using environment variables](/github/automating-your-workflow-with-github-actions/using-environment-variables)." + +#### Docker container filesystem + +Actions that run in Docker containers have static directories under the `/github` path. However, we strongly recommend using the default environment variables to construct file paths in Docker containers. + +{% data variables.product.prodname_dotcom %} reserves the `/github` path prefix and creates three directories for actions. + +- `/github/home` +- `/github/workspace` - {% data reusables.repositories.action-root-user-required %} +- `/github/workflow` + +{% if currentVersion == "free-pro-team@latest" %} + +### Дополнительная литература +- "[Managing billing for {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)" + +{% endif %} diff --git a/translations/ru-RU/content/actions/reference/usage-limits-billing-and-administration.md b/translations/ru-RU/content/actions/reference/usage-limits-billing-and-administration.md new file mode 100644 index 000000000000..d15f5f85abe7 --- /dev/null +++ b/translations/ru-RU/content/actions/reference/usage-limits-billing-and-administration.md @@ -0,0 +1,88 @@ +--- +title: 'Usage limits, billing, and administration' +intro: 'There are usage limits for {% data variables.product.prodname_actions %} workflows. Usage charges apply to repositories that go beyond the amount of free minutes and storage for a repository.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /actions/getting-started-with-github-actions/usage-and-billing-information-for-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### About billing for {% data variables.product.prodname_actions %} + +{% if currentVersion == "free-pro-team@latest" %} +{% data reusables.github-actions.actions-billing %} For more information, see "[About billing for {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions)." +{% else %} +GitHub Actions usage is free for +{% data variables.product.prodname_ghe_server %} that use self-hosted runners. +{% endif %} + +### Usage limits + +{% if currentVersion == "free-pro-team@latest" %} +There are some limits on +{% data variables.product.prodname_actions %} usage when using {% data variables.product.prodname_dotcom %}-hosted runners. These limits are subject to change. + +{% note %} + +**Note:** For self-hosted runners, different usage limits apply. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)." + +{% endnote %} + +- **Job execution time** - Each job in a workflow can run for up to 6 hours of execution time. If a job reaches this limit, the job is terminated and fails to complete. +{% data reusables.github-actions.usage-workflow-run-time %} +{% data reusables.github-actions.usage-api-requests %} +- **Concurrent jobs** - The number of concurrent jobs you can run in your account depends on your GitHub plan, as indicated in the following table. If exceeded, any additional jobs are queued. + + | GitHub plan | Total concurrent jobs | Maximum concurrent macOS jobs | + | ----------- | --------------------- | ----------------------------- | + | Бесплатные | 20 | 5 | + | Pro | 40 | 5 | + | Team | 60 | 5 | + | Enterprise | 180 | 50 | +- **Job matrix** - {% data reusables.github-actions.usage-matrix-limits %} +{% else %} +Usage limits apply to self-hosted runners. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)." +{% endif %} + +{% if currentVersion == "free-pro-team@latest" %} +### Usage policy +In addition to the usage limits, you must ensure that you use + +{% data variables.product.prodname_actions %} within the [GitHub Terms of Service](/articles/github-terms-of-service/). For more information on {% data variables.product.prodname_actions %}-specific terms, see the [GitHub Additional Product Terms](/github/site-policy/github-additional-product-terms#a-actions-usage). +{% endif %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +### Artifact and log retention policy + +You can configure the artifact and log retention period for your repository, organization, or enterprise account. + +{% data reusables.actions.about-artifact-log-retention %} + +Дополнительные сведения см. в: + +- [Configuring the retention period for {% data variables.product.prodname_actions %} for artifacts and logs in your repository](/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository) +- [Configuring the retention period for {% data variables.product.prodname_actions %} for artifacts and logs in your organization](/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization) +- [Configuring the retention period for {% data variables.product.prodname_actions %} for artifacts and logs in your enterprise](/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account) +{% endif %} + +### Disabling or limiting {% data variables.product.prodname_actions %} for your repository or organization + +{% data reusables.github-actions.disabling-github-actions %} + +Дополнительные сведения см. в: +- "[Disabling or limiting {% data variables.product.prodname_actions %} for a repository](/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository)" +- "[Disabling or limiting {% data variables.product.prodname_actions %} for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization)"{% if currentVersion == "free-pro-team@latest" %} +- "[Enforcing {% data variables.product.prodname_actions %} policies in your enterprise account](/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account)" for {% data variables.product.prodname_ghe_cloud %}{% endif %} + +### Disabling and enabling workflows + +You can enable and disable individual workflows in your repository on {% data variables.product.prodname_dotcom %}. + +{% data reusables.actions.scheduled-workflows-disabled %} + +For more information, see "[Disabling and enabling a workflow](/actions/managing-workflow-runs/disabling-and-enabling-a-workflow)." diff --git a/translations/ru-RU/content/actions/reference/workflow-commands-for-github-actions.md b/translations/ru-RU/content/actions/reference/workflow-commands-for-github-actions.md index 8daf4b1c67c8..cf219da975c2 100644 --- a/translations/ru-RU/content/actions/reference/workflow-commands-for-github-actions.md +++ b/translations/ru-RU/content/actions/reference/workflow-commands-for-github-actions.md @@ -21,7 +21,11 @@ versions: Actions can communicate with the runner machine to set environment variables, output values used by other actions, add debug messages to the output logs, and other tasks. +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +Most workflow commands use the `echo` command in a specific format, while others are invoked by writing to a file. For more information, see ["Environment files".](#environment-files) +{% else %} Workflow commands use the `echo` command in a specific format. +{% endif %} ``` bash echo "::workflow-command parameter1={data},parameter2={data}::{command value}" @@ -41,40 +45,46 @@ echo "::workflow-command parameter1={data},parameter2={data}::{command value}" ### Using workflow commands to access toolkit functions -The [actions/toolkit](https://github.com/actions/toolkit) includes a number of functions that can be executed as workflow commands. Use the `::` syntax to run the workflow commands within your YAML file; these commands are then sent to the runner over `stdout`. For example, instead of using code to set an environment variable, as below: +The [actions/toolkit](https://github.com/actions/toolkit) includes a number of functions that can be executed as workflow commands. Use the `::` syntax to run the workflow commands within your YAML file; these commands are then sent to the runner over `stdout`. For example, instead of using code to set an output, as below: ```javascript -core.exportVariable('SELECTED_COLOR', 'green'); +core.setOutput('SELECTED_COLOR', 'green'); ``` -You can use the `set-env` command in your workflow to set the same value: +You can use the `set-output` command in your workflow to set the same value: ``` yaml - name: Set selected color - run: echo '::set-env name=SELECTED_COLOR::green' + run: echo '::set-output name=SELECTED_COLOR::green' + id: random-color-generator - name: Get color - run: echo 'The selected color is' $SELECTED_COLOR + run: echo 'The selected color is' ${steps.random-color-generator.outputs.SELECTED_COLOR} ``` The following table shows which toolkit functions are available within a workflow: -| Toolkit function | Equivalent workflow command | -| --------------------- | ---------------------------------------------------- | -| `core.addPath` | `add-path` | -| `core.debug` | `debug` | -| `core.error` | `error` | -| `core.endGroup` | `endgroup` | -| `core.exportVariable` | `set-env` | -| `core.getInput` | Accessible using environment variable `INPUT_{NAME}` | -| `core.getState` | Accessible using environment variable `STATE_{NAME}` | -| `core.isDebug` | Accessible using environment variable `RUNNER_DEBUG` | -| `core.saveState` | `save-state` | -| `core.setFailed` | Used as a shortcut for `::error` and `exit 1` | -| `core.setOutput` | `set-output` | -| `core.setSecret` | `add-mask` | -| `core.startGroup` | `группа` | -| `core.warning` | `warning file` | - +| Toolkit function | Equivalent workflow command | +| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- | +| `core.addPath` | | +| {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}Accessible using environment file `GITHUB_PATH`{% else %} `add-path` {% endif %} | | +| | | +| `core.debug` | `debug` | +| `core.error` | `error` | +| `core.endGroup` | `endgroup` | +| `core.exportVariable` | | +| {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}Accessible using environment file `GITHUB_ENV`{% else %} `set-env` {% endif %} | | +| | | +| `core.getInput` | Accessible using environment variable `INPUT_{NAME}` | +| `core.getState` | Accessible using environment variable `STATE_{NAME}` | +| `core.isDebug` | Accessible using environment variable `RUNNER_DEBUG` | +| `core.saveState` | `save-state` | +| `core.setFailed` | Used as a shortcut for `::error` and `exit 1` | +| `core.setOutput` | `set-output` | +| `core.setSecret` | `add-mask` | +| `core.startGroup` | `группа` | +| `core.warning` | `warning file` | + +{% if currentVersion ver_lt "enterprise-server@2.23" %} ### Setting an environment variable `::set-env name={name}::{value}` @@ -86,6 +96,7 @@ Creates or updates an environment variable for any actions running next in a job ``` bash echo "::set-env name=action_state::yellow" ``` +{% endif %} ### Setting an output parameter @@ -101,6 +112,7 @@ Optionally, you can also declare output parameters in an action's metadata file. echo "::set-output name=action_fruit::strawberry" ``` +{% if currentVersion ver_lt "enterprise-server@2.23" %} ### Adding a system path `::add-path::{path}` @@ -112,12 +124,13 @@ Prepends a directory to the system `PATH` variable for all subsequent actions in ``` bash echo "::add-path::/path/to/dir" ``` +{% endif %} ### Setting a debug message `::debug::{message}` -Prints a debug message to the log. You must create a secret named `ACTIONS_STEP_DEBUG` with the value `true` to see the debug messages set by this command in the log. For more information, see "[Managing a workflow run](/actions/configuring-and-managing-workflows/managing-a-workflow-run#enabling-debug-logging)." +Prints a debug message to the log. You must create a secret named `ACTIONS_STEP_DEBUG` with the value `true` to see the debug messages set by this command in the log. For more information, see "[Enabling debug logging](/actions/managing-workflow-runs/enabling-debug-logging)." #### Пример @@ -141,7 +154,7 @@ echo "::warning file=app.js,line=1,col=5::Missing semicolon" `::error file={name},line={line},col={col}::{message}` -Creates an error message and prints the message to the log. You can optionally provide a filename (`file`), line number (`line`), and column (`col`) number where the warning occurred. +Creates an error message and prints the message to the log. You can optionally provide a filename (`file`), line number (`line`), and column (`col`) number where the error occurred. #### Пример @@ -213,3 +226,67 @@ The `STATE_processID` variable is then exclusively available to the cleanup scri ``` javascript console.log("The running PID from the main action is: " + process.env.STATE_processID); ``` + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +## Environment Files + +During the execution of a workflow, the runner generates temporary files that can be used to perform certain actions. The path to these files are exposed via environment variables. You will need to use UTF-8 encoding when writing to these files to ensure proper processing of the commands. Multiple commands can be written to the same file, separated by newlines. + +{% warning %} + +**Warning:** Powershell does not use UTF-8 by default. Make sure you write files using the correct encoding. For example, you need to set UTF-8 encoding when you set the path: + +``` +steps: + - run: echo "mypath" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append +``` + +{% endwarning %} + +### Setting an environment variable + +`echo "{name}={value}" >> $GITHUB_ENV` + +Creates or updates an environment variable for any actions running next in a job. The action that creates or updates the environment variable does not have access to the new value, but all subsequent actions in a job will have access. Environment variables are case-sensitive and you can include punctuation. + +#### Пример + +```bash +echo "action_state=yellow" >> $GITHUB_ENV +``` + +Running `$action_state` in a future step will now return `yellow` + +#### Multline strings +For multiline strings, you may use a delimiter with the following syntax. + +``` +{name}<<{delimiter} +{value} +{delimiter} +``` + +#### Пример +In this example, we use `EOF` as a delimiter and set the `JSON_RESPONSE` environment variable to the value of the curl response. +``` +steps: + - name: Set the value + id: step_one + run: | + echo 'JSON_RESPONSE<> $GITHUB_ENV + curl https://httpbin.org/json >> $GITHUB_ENV + echo 'EOF' >> $GITHUB_ENV +``` + +### Adding a system path + +`echo "{path}" >> $GITHUB_PATH` + +Prepends a directory to the system `PATH` variable for all subsequent actions in the current job. The currently running action cannot access the new path variable. + +#### Пример + +``` bash +echo "/path/to/dir" >> $GITHUB_PATH +``` +{% endif %} diff --git a/translations/ru-RU/content/actions/reference/workflow-syntax-for-github-actions.md b/translations/ru-RU/content/actions/reference/workflow-syntax-for-github-actions.md index bd84ad42270f..12c4e78c4ace 100644 --- a/translations/ru-RU/content/actions/reference/workflow-syntax-for-github-actions.md +++ b/translations/ru-RU/content/actions/reference/workflow-syntax-for-github-actions.md @@ -21,10 +21,6 @@ Workflow files use YAML syntax, and must have either a `.yml` or `.yaml` file ex You must store workflow files in the `.github/workflows` directory of your repository. -### Usage limits - -{% data reusables.github-actions.github-actions-usage-limits %} - ### **`name`** The name of your workflow. {% data variables.product.prodname_dotcom %} displays the names of your workflows on your repository's actions page. If you omit `name`, {% data variables.product.prodname_dotcom %} sets it to the workflow file path relative to the root of the repository. @@ -64,8 +60,8 @@ on: push: # Sequence of patterns matched against refs/heads branches: - # Push events on master branch - - master + # Push events on main branch + - main # Push events to branches matching refs/heads/mona/octocat - 'mona/octocat' # Push events to branches matching refs/heads/releases/10 @@ -229,7 +225,7 @@ A workflow run is made up of one or more jobs. Jobs run in parallel by default. Each job runs in an environment specified by `runs-on`. -You can run an unlimited number of jobs as long as you are within the workflow usage limits. For more information, see "[Usage limits](#usage-limits)." +You can run an unlimited number of jobs as long as you are within the workflow usage limits. For more information, see "[Usage limits and billing](/actions/reference/usage-limits-billing-and-administration)" for {% data variables.product.prodname_dotcom %}-hosted runners and "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)" for self-hosted runner usage limits. If you need to find the unique identifier of a job running in a workflow run, you can use the {% data variables.product.prodname_dotcom %} API. For more information, see "[Workflow Jobs](/v3/actions/workflow-jobs)." @@ -310,7 +306,7 @@ runs-on: [self-hosted, linux] For more information, see "[About self-hosted runners](/github/automating-your-workflow-with-github-actions/about-self-hosted-runners)" and "[Using self-hosted runners in a workflow](/github/automating-your-workflow-with-github-actions/using-self-hosted-runners-in-a-workflow)." -### **`jobs..outputs`** +### **`jobs..outputs`** A `map` of outputs for a job. Job outputs are available to all downstream jobs that depend on this job. For more information on defining job dependencies, see [`jobs..needs`](#jobsjob_idneeds). @@ -393,7 +389,7 @@ You can use the `if` conditional to prevent a job from running unless a conditio A job contains a sequence of tasks called `steps`. Steps can run commands, run setup tasks, or run an action in your repository, a public repository, or an action published in a Docker registry. Not all steps run actions, but all actions run as a step. Each step runs in its own process in the runner environment and has access to the workspace and filesystem. Because steps run in their own process, changes to environment variables are not preserved between steps. {% data variables.product.prodname_dotcom %} provides built-in steps to set up and complete a job. -You can run an unlimited number of steps as long as you are within the workflow usage limits. For more information, see "[Usage limits](#usage-limits)." +You can run an unlimited number of steps as long as you are within the workflow usage limits. For more information, see "[Usage limits and billing](/actions/reference/usage-limits-billing-and-administration)" for {% data variables.product.prodname_dotcom %}-hosted runners and "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)" for self-hosted runner usage limits. #### Пример @@ -447,7 +443,7 @@ The `my backup step` only runs when the previous step of a job fails. For more i ```yaml steps: - name: My first step - uses: monacorp/action-name@master + uses: monacorp/action-name@main - name: My backup step if: {% raw %}${{ failure() }}{% endraw %} uses: actions/heroku@master @@ -464,7 +460,7 @@ Selects an action to run as part of a step in your job. An action is a reusable We strongly recommend that you include the version of the action you are using by specifying a Git ref, SHA, or Docker tag number. If you don't specify a version, it could break your workflows or cause unexpected behavior when the action owner publishes an update. - Using the commit SHA of a released action version is the safest for stability and security. - Using the specific major action version allows you to receive critical fixes and security patches while still maintaining compatibility. It also assures that your workflow should still work. -- Using the `master` branch of an action may be convenient, but if someone releases a new major version with a breaking change, your workflow could break. +- Using the default branch of an action may be convenient, but if someone releases a new major version with a breaking change, your workflow could break. Some actions require inputs that you must set using the [`with`](#jobsjob_idstepswith) keyword. Review the action's README file to determine the inputs required. @@ -481,7 +477,7 @@ steps: # Reference a minor version of a release - uses: actions/setup-node@v1.2 # Reference a branch - - uses: actions/setup-node@master + - uses: actions/setup-node@main ``` ##### Example using a public action @@ -495,7 +491,7 @@ jobs: my_first_job: steps: - name: My first step - # Uses the master branch of a public repository + # Uses the default branch of a public repository uses: actions/heroku@master - name: My second step # Uses a specific version tag of a public repository @@ -513,7 +509,7 @@ jobs: my_first_job: steps: - name: My first step - uses: actions/aws/ec2@master + uses: actions/aws/ec2@main ``` ##### Example using action in the same repository as the workflow @@ -596,14 +592,14 @@ Using the `working-directory` keyword, you can specify the working directory of You can override the default shell settings in the runner's operating system using the `shell` keyword. You can use built-in `shell` keywords, or you can define a custom set of shell options. -| Supported platform | `shell` parameter | Description | Command run internally | -| ------------------ | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- | -| All | `bash` | The default shell on non-Windows platforms with a fallback to `sh`. When specifying a bash shell on Windows, the bash shell included with Git for Windows is used. | `bash --noprofile --norc -eo pipefail {0}` | -| All | `pwsh` | The PowerShell Core. {% data variables.product.prodname_dotcom %} appends the extension `.ps1` to your script name. | `pwsh -command "& '{0}'"` | -| All | `python` | Executes the python command. | `python {0}` | -| Linux / macOS | `sh` | The fallback behavior for non-Windows platforms if no shell is provided and `bash` is not found in the path. | `sh -e {0}` | -| Windows | `cmd` | {% data variables.product.prodname_dotcom %} appends the extension `.cmd` to your script name and substitutes for `{0}`. | `%ComSpec% /D /E:ON /V:OFF /S /C "CALL "{0}""`. | -| Windows | `powershell` | This is the default shell used on Windows. The Desktop PowerShell. {% data variables.product.prodname_dotcom %} appends the extension `.ps1` to your script name. | `powershell -command "& '{0}'"`. | +| Supported platform | `shell` parameter | Description | Command run internally | +| ------------------ | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------- | +| All | `bash` | The default shell on non-Windows platforms with a fallback to `sh`. When specifying a bash shell on Windows, the bash shell included with Git for Windows is used. | `bash --noprofile --norc -eo pipefail {0}` | +| All | `pwsh` | The PowerShell Core. {% data variables.product.prodname_dotcom %} appends the extension `.ps1` to your script name. | `pwsh -command ". '{0}'"` | +| All | `python` | Executes the python command. | `python {0}` | +| Linux / macOS | `sh` | The fallback behavior for non-Windows platforms if no shell is provided and `bash` is not found in the path. | `sh -e {0}` | +| Windows | `cmd` | {% data variables.product.prodname_dotcom %} appends the extension `.cmd` to your script name and substitutes for `{0}`. | `%ComSpec% /D /E:ON /V:OFF /S /C "CALL "{0}""`. | +| Windows | `powershell` | This is the default shell used on Windows. The Desktop PowerShell. {% data variables.product.prodname_dotcom %} appends the extension `.ps1` to your script name. | `powershell -command ". '{0}'"`. | ##### Example running a script using bash @@ -678,7 +674,7 @@ jobs: my_first_job: steps: - name: My first step - uses: actions/hello_world@master + uses: actions/hello_world@main with: first_name: Mona middle_name: The @@ -695,7 +691,7 @@ A `string` that defines the inputs for a Docker container. {% data variables.pro ```yaml steps: - name: Explain why this job ran - uses: monacorp/action-name@master + uses: monacorp/action-name@main with: entrypoint: /bin/echo args: The ${{ github.event_name }} event triggered this step. @@ -708,7 +704,6 @@ The `args` are used in place of the `CMD` instruction in a `Dockerfile`. If you 1. Use defaults that allow using the action without specifying any `args`. 1. If the action exposes a `--help` flag, or something similar, use that as the default to make your action self-documenting. - #### **`jobs..steps.with.entrypoint`** Overrides the Docker `ENTRYPOINT` in the `Dockerfile`, or sets it if one wasn't already specified. Unlike the Docker `ENTRYPOINT` instruction which has a shell and exec form, `entrypoint` keyword accepts only a single string defining the executable to be run. @@ -718,7 +713,7 @@ Overrides the Docker `ENTRYPOINT` in the `Dockerfile`, or sets it if one wasn't ```yaml steps: - name: Run a custom command - uses: monacorp/action-name@master + uses: monacorp/action-name@main with: entrypoint: /a/different/executable ``` @@ -766,7 +761,7 @@ A strategy creates a build matrix for your jobs. You can define different variat You can define a matrix of different job configurations. A matrix allows you to create multiple jobs by performing variable substitution in a single job definition. For example, you can use a matrix to create jobs for more than one supported version of a programming language, operating system, or tool. A matrix reuses the job's configuration and creates a job for each matrix you configure. -{% data reusables.github-actions.matrix-limits %} +{% data reusables.github-actions.usage-matrix-limits %} Each option you define in the `matrix` has a key and value. The keys you define become properties in the `matrix` context and you can reference the property in other areas of your workflow file. For example, if you define the key `os` that contains an array of operating systems, you can use the `matrix.os` property as the value of the `runs-on` keyword to create a job for each operating system. For more information, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)." @@ -843,7 +838,6 @@ strategy: You can use `include` to add new jobs to a build matrix. Any unmatched include configurations are added to the matrix. For example, if you want to use `node` version 12 to build on multiple operating systems, but wanted one extra experimental job using node version 13 on Ubuntu, you can use `include` to specify that additional job. - {% raw %} ```yaml runs-on: ${{ matrix.os }} @@ -952,7 +946,25 @@ jobs: #### **`jobs..container.image`** -The Docker image to use as the container to run the action. The value can be the Docker Hub image name or a public docker registry name. +The Docker image to use as the container to run the action. The value can be the Docker Hub image name or a {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.23" %}public{% endif %} registry name. + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +#### **`jobs..container.credentials`** + +{% data reusables.actions.registry-credentials %} + +##### Пример + +{% raw %} +```yaml +container: + image: ghcr.io/owner/image + credentials: + username: ${{ github.actor }} + password: ${{ secrets.ghcr_token }} +``` +{% endraw %} +{% endif %} #### **`jobs..container.env`** @@ -1015,19 +1027,43 @@ services: - 6379/tcp ``` -#### **`jobs..services.image`** +#### **`jobs..services..image`** + +The Docker image to use as the service container to run the action. The value can be the Docker Hub image name or a {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.23" %}public{% endif %} registry name. + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +#### **`jobs..services..credentials`** + +{% data reusables.actions.registry-credentials %} + +##### Пример -The Docker image to use as the service container to run the action. The value can be the Docker base image name or a public docker Hub or registry. +{% raw %} +```yaml +services: + myservice1: + image: ghcr.io/owner/myservice1 + credentials: + username: ${{ github.actor }} + password: ${{ secrets.ghcr_token }} + myservice2: + image: dockerhub_org/myservice2 + credentials: + username: ${{ secrets.DOCKER_USER }} + password: ${{ secrets.DOCKER_PASSWORD }} +``` +{% endraw %} +{% endif %} -#### **`jobs..services.env`** +#### **`jobs..services..env`** Sets a `map` of environment variables in the service container. -#### **`jobs..services.ports`** +#### **`jobs..services..ports`** Sets an `array` of ports to expose on the service container. -#### **`jobs..services.volumes`** +#### **`jobs..services..volumes`** Sets an `array` of volumes for the service container to use. You can use volumes to share data between services or other steps in a job. You can specify named Docker volumes, anonymous Docker volumes, or bind mounts on the host. @@ -1046,7 +1082,7 @@ volumes: - /source/directory:/destination/directory ``` -#### **`jobs..services.options`** +#### **`jobs..services..options`** Additional Docker container resource options. For a list of options, see "[`docker create` options](https://docs.docker.com/engine/reference/commandline/create/#options)." @@ -1076,16 +1112,16 @@ For more information about branch, tag, and path filter syntax, see "[`on.-`feature/your-branch` | -| `feature/**` | The `**` wildcard matches any character including slash (`/`) in branch and tag names. | -`feature/beta-a/my-branch`
    -`feature/your-branch`
    -`feature/mona/the/octocat` | -| -`master`
    -`releases/mona-the-octcat` | Matches the exact name of a branch or tag name. | -`master`
    -`releases/mona-the-octocat` | -| `'*'` | Matches all branch and tag names that don't contain a slash (`/`). The `*` character is a special character in YAML. When you start a pattern with `*`, you must use quotes. | -`master`
    -`releases` | -| `'**'` | Matches all branch and tag names. This is the default behavior when you don't use a `branches` or `tags` filter. | -`all/the/branches`
    -`every/tag` | -| `'*feature'` | The `*` character is a special character in YAML. When you start a pattern with `*`, you must use quotes. | -`mona-feature`
    -`feature`
    -`ver-10-feature` | -| `v2*` | Matches branch and tag names that start with `v2`. | -`v2`
    -`v2.0`
    -`v2.9` | -| `v[12].[0-9]+.[0-9]+` | Matches all semantic versioning tags with major version 1 or 2 | -`v1.10.1`
    -`v2.0.0` | +| Pattern | Description | Example matches | +| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | +| `feature/*` | The `*` wildcard matches any character, but does not match slash (`/`). | -`feature/my-branch`
    -`feature/your-branch` | +| `feature/**` | The `**` wildcard matches any character including slash (`/`) in branch and tag names. | -`feature/beta-a/my-branch`
    -`feature/your-branch`
    -`feature/mona/the/octocat` | +| -`main`
    -`releases/mona-the-octcat` | Matches the exact name of a branch or tag name. | -`main`
    -`releases/mona-the-octocat` | +| `'*'` | Matches all branch and tag names that don't contain a slash (`/`). The `*` character is a special character in YAML. When you start a pattern with `*`, you must use quotes. | -`main`
    -`releases` | +| `'**'` | Matches all branch and tag names. This is the default behavior when you don't use a `branches` or `tags` filter. | -`all/the/branches`
    -`every/tag` | +| `'*feature'` | The `*` character is a special character in YAML. When you start a pattern with `*`, you must use quotes. | -`mona-feature`
    -`feature`
    -`ver-10-feature` | +| `v2*` | Matches branch and tag names that start with `v2`. | -`v2`
    -`v2.0`
    -`v2.9` | +| `v[12].[0-9]+.[0-9]+` | Matches all semantic versioning tags with major version 1 or 2 | -`v1.10.1`
    -`v2.0.0` | #### Patterns to match file paths diff --git a/translations/ru-RU/content/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance.md b/translations/ru-RU/content/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance.md index 424b60c9c487..f61c23d45b48 100644 --- a/translations/ru-RU/content/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance.md +++ b/translations/ru-RU/content/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance.md @@ -8,8 +8,6 @@ redirect_from: - /enterprise/admin/guides/migrations/authenticating-users-for-your-github-enterprise-instance/ - /enterprise/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance - /enterprise/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance - - /enterprise/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance - - /enterprise/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance mapTopic: true versions: enterprise-server: '*' diff --git a/translations/ru-RU/content/admin/authentication/changing-authentication-methods.md b/translations/ru-RU/content/admin/authentication/changing-authentication-methods.md index b51071f372a7..052b6d7ea8d3 100644 --- a/translations/ru-RU/content/admin/authentication/changing-authentication-methods.md +++ b/translations/ru-RU/content/admin/authentication/changing-authentication-methods.md @@ -4,7 +4,6 @@ intro: 'You can change the way {% data variables.product.prodname_ghe_server %} redirect_from: - /enterprise/admin/user-management/changing-authentication-methods - /enterprise/admin/authentication/changing-authentication-methods - - /enterprise/admin/authentication/changing-authentication-methods versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/authentication/disabling-unauthenticated-sign-ups.md b/translations/ru-RU/content/admin/authentication/disabling-unauthenticated-sign-ups.md index 00772dfc9ae8..d2b4f84c6d3f 100644 --- a/translations/ru-RU/content/admin/authentication/disabling-unauthenticated-sign-ups.md +++ b/translations/ru-RU/content/admin/authentication/disabling-unauthenticated-sign-ups.md @@ -4,7 +4,6 @@ redirect_from: - /enterprise/admin/articles/disabling-sign-ups/ - /enterprise/admin/user-management/disabling-unauthenticated-sign-ups - /enterprise/admin/authentication/disabling-unauthenticated-sign-ups - - /enterprise/admin/authentication/disabling-unauthenticated-sign-ups intro: 'If you''re using built-in authentication, you can block unauthenticated people from being able to create an account.' versions: enterprise-server: '*' diff --git a/translations/ru-RU/content/admin/authentication/index.md b/translations/ru-RU/content/admin/authentication/index.md index 927688f90250..fa91d86c3535 100644 --- a/translations/ru-RU/content/admin/authentication/index.md +++ b/translations/ru-RU/content/admin/authentication/index.md @@ -3,8 +3,6 @@ title: Authentication intro: 'You can use {% data variables.product.prodname_ghe_server %}''s built-in authentication, or choose between CAS, LDAP, or SAML to integrate your existing accounts and centrally manage user access to {% data variables.product.product_location_enterprise %}.' redirect_from: - /enterprise/admin/authentication - - /enterprise/admin/authentication - - /enterprise/admin/authentication versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/authentication/using-built-in-authentication.md b/translations/ru-RU/content/admin/authentication/using-built-in-authentication.md index 8710bf21b16b..220285d48350 100644 --- a/translations/ru-RU/content/admin/authentication/using-built-in-authentication.md +++ b/translations/ru-RU/content/admin/authentication/using-built-in-authentication.md @@ -4,7 +4,6 @@ intro: 'When you use the default authentication method, all authentication detai redirect_from: - /enterprise/admin/user-management/using-built-in-authentication - /enterprise/admin/authentication/using-built-in-authentication - - /enterprise/admin/authentication/using-built-in-authentication versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/authentication/using-cas.md b/translations/ru-RU/content/admin/authentication/using-cas.md index d6dc20690fbe..e56897310e22 100644 --- a/translations/ru-RU/content/admin/authentication/using-cas.md +++ b/translations/ru-RU/content/admin/authentication/using-cas.md @@ -25,8 +25,8 @@ versions: The following attributes are available. -| Attribute name | Тип | Description | -| ------------------ | -------- | --------------------------------------------------------------------- | +| Attribute name | Тип | Description | +| ------------------ | -------- | ---------------------------------------------------------------- | | `имя пользователя` | Required | The {% data variables.product.prodname_ghe_server %} username. | ### Configuring CAS diff --git a/translations/ru-RU/content/admin/authentication/using-ldap.md b/translations/ru-RU/content/admin/authentication/using-ldap.md index 6a3bea519e97..34ee59a08351 100644 --- a/translations/ru-RU/content/admin/authentication/using-ldap.md +++ b/translations/ru-RU/content/admin/authentication/using-ldap.md @@ -59,19 +59,19 @@ Use these attributes to finish configuring LDAP for {% data variables.product.pr | Attribute name | Тип | Description | | ------------------------------------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `Host` | Required | The LDAP host, e.g. `ldap.example.com` or `10.0.0.30`. If the hostname is only available from your internal network, you may need to configure {% data variables.product.product_location_enterprise %}'s DNS first so it can resolve the hostname using your internal nameservers. | +| `Host` | Required | The LDAP host, e.g. `ldap.example.com` or `10.0.0.30`. If the hostname is only available from your internal network, you may need to configure {% data variables.product.product_location_enterprise %}'s DNS first so it can resolve the hostname using your internal nameservers. | | `Port` | Required | The port the host's LDAP services are listening on. Examples include: 389 and 636 (for LDAPS). | | `Encryption` | Required | The encryption method used to secure communications to the LDAP server. Examples include plain (no encryption), SSL/LDAPS (encrypted from the start), and StartTLS (upgrade to encrypted communication once connected). | | `Domain search user` | Optional | The LDAP user that performs user lookups to authenticate other users when they sign in. This is typically a service account created specifically for third-party integrations. Use a fully qualified name, such as `cn=Administrator,cn=Users,dc=Example,dc=com`. With Active Directory, you can also use the `[DOMAIN]\[USERNAME]` syntax (e.g. `WINDOWS\Administrator`) for the domain search user with Active Directory. | | `Domain search password` | Optional | The password for the domain search user. | | `Administrators group` | Optional | Users in this group are promoted to site administrators when signing into your appliance. If you don't configure an LDAP Administrators group, the first LDAP user account that signs into your appliance will be automatically promoted to a site administrator. | | `Domain base` | Required | The fully qualified `Distinguished Name` (DN) of an LDAP subtree you want to search for users and groups. You can add as many as you like; however, each group must be defined in the same domain base as the users that belong to it. If you specify restricted user groups, only users that belong to those groups will be in scope. We recommend that you specify the top level of your LDAP directory tree as your domain base and use restricted user groups to control access. | -| `Restricted user groups` | Optional | If specified, only users in these groups will be allowed to log in. You only need to specify the common names (CNs) of the groups, and you can add as many groups as you like. If no groups are specified, *all* users within the scope of the specified domain base will be able to sign in to your {% data variables.product.prodname_ghe_server %} instance. | -| `User ID` | Required | The LDAP attribute that identifies the LDAP user who attempts authentication. Once a mapping is established, users may change their {% data variables.product.prodname_ghe_server %} usernames. This field should be `sAMAccountName` for most Active Directory installations, but it may be `uid` for other LDAP solutions, such as OpenLDAP. The default value is `uid`. | -| `Profile name` | Optional | The name that will appear on the user's {% data variables.product.prodname_ghe_server %} profile page. Unless LDAP Sync is enabled, users may change their profile names. | -| `Emails` | Optional | The email addresses for a user's {% data variables.product.prodname_ghe_server %} account. | -| `SSH keys` | Optional | The public SSH keys attached to a user's {% data variables.product.prodname_ghe_server %} account. The keys must be in OpenSSH format. | -| `GPG keys` | Optional | The GPG keys attached to a user's {% data variables.product.prodname_ghe_server %} account. | +| `Restricted user groups` | Optional | If specified, only users in these groups will be allowed to log in. You only need to specify the common names (CNs) of the groups, and you can add as many groups as you like. If no groups are specified, *all* users within the scope of the specified domain base will be able to sign in to your {% data variables.product.prodname_ghe_server %} instance. | +| `User ID` | Required | The LDAP attribute that identifies the LDAP user who attempts authentication. Once a mapping is established, users may change their {% data variables.product.prodname_ghe_server %} usernames. This field should be `sAMAccountName` for most Active Directory installations, but it may be `uid` for other LDAP solutions, such as OpenLDAP. The default value is `uid`. | +| `Profile name` | Optional | The name that will appear on the user's {% data variables.product.prodname_ghe_server %} profile page. Unless LDAP Sync is enabled, users may change their profile names. | +| `Emails` | Optional | The email addresses for a user's {% data variables.product.prodname_ghe_server %} account. | +| `SSH keys` | Optional | The public SSH keys attached to a user's {% data variables.product.prodname_ghe_server %} account. The keys must be in OpenSSH format. | +| `GPG keys` | Optional | The GPG keys attached to a user's {% data variables.product.prodname_ghe_server %} account. | | `Disable LDAP authentication for Git operations` | Optional | If selected, [turns off](#disabling-password-authentication-for-git-operations) users' ability to use LDAP passwords to authenticate Git operations. | | `Enable LDAP certificate verification` | Optional | If selected, [turns on](#enabling-ldap-certificate-verification) LDAP certificate verification. | | `Synchronization` | Optional | If selected, [turns on](#enabling-ldap-sync) LDAP Sync. | @@ -97,6 +97,12 @@ When this option is selected, the certificate is validated to make sure: #### Enabling LDAP Sync +{% note %} + +**Note:** Teams using LDAP Sync are limited to a maximum 1499 members. + +{% endnote %} + LDAP Sync lets you synchronize {% data variables.product.prodname_ghe_server %} users and team membership against your established LDAP groups. This lets you establish role-based access control for users from your LDAP server instead of manually within {% data variables.product.prodname_ghe_server %}. For more information, see "[Creating teams](/enterprise/{{ currentVersion }}/admin/guides/user-management/creating-teams#creating-teams-with-ldap-sync-enabled)." To enable LDAP Sync, in your LDAP settings, select **Synchronize Emails**, **Synchronize SSH Keys**, or **Synchronize GPG Keys** . diff --git a/translations/ru-RU/content/admin/authentication/using-saml.md b/translations/ru-RU/content/admin/authentication/using-saml.md index 0a3176289720..94fcf73e5155 100644 --- a/translations/ru-RU/content/admin/authentication/using-saml.md +++ b/translations/ru-RU/content/admin/authentication/using-saml.md @@ -54,15 +54,15 @@ To configure your identity provider manually, the Assertion Consumer Service (AC These attributes are available. You can change the attribute names in the [management console](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-management-console/), with the exception of the `administrator` attribute. -| Default attribute name | Тип | Description | -| ---------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Default attribute name | Тип | Description | +| ---------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `NameID` | Required | A persistent user identifier. Any persistent name identifier format may be used. The `NameID` element will be used for a {% data variables.product.prodname_ghe_server %} username unless one of the alternative assertions is provided. | -| `администратор` | Optional | When the value is 'true', the user will automatically be promoted as an administrator. Any other value or a non-existent value will demote the user to a normal user account. | +| `администратор` | Optional | When the value is 'true', the user will automatically be promoted as an administrator. Any other value or a non-existent value will demote the user to a normal user account. | | `имя пользователя` | Optional | The {% data variables.product.prodname_ghe_server %} username. | -| `full_name` | Optional | The name of the user displayed on their profile page. Users may change their names after provisioning. | -| `emails` | Optional | The email addresses for the user. More than one can be specified. | -| `public_keys` | Optional | The public SSH keys for the user. More than one can be specified. | -| `gpg_keys` | Optional | The GPG keys for the user. More than one can be specified. | +| `full_name` | Optional | The name of the user displayed on their profile page. Users may change their names after provisioning. | +| `emails` | Optional | The email addresses for the user. More than one can be specified. | +| `public_keys` | Optional | The public SSH keys for the user. More than one can be specified. | +| `gpg_keys` | Optional | The GPG keys for the user. More than one can be specified. | ### Configuring SAML settings diff --git a/translations/ru-RU/content/admin/configuration/accessing-the-administrative-shell-ssh.md b/translations/ru-RU/content/admin/configuration/accessing-the-administrative-shell-ssh.md index 9a1c28285a5d..d8dd87250d8c 100644 --- a/translations/ru-RU/content/admin/configuration/accessing-the-administrative-shell-ssh.md +++ b/translations/ru-RU/content/admin/configuration/accessing-the-administrative-shell-ssh.md @@ -10,7 +10,6 @@ redirect_from: - /enterprise/admin/2.15/articles/troubleshooting-ssh-permission-denied-publickey/ - /enterprise/admin/installation/accessing-the-administrative-shell-ssh - /enterprise/admin/configuration/accessing-the-administrative-shell-ssh - - /enterprise/admin/configuration/accessing-the-administrative-shell-ssh intro: 'SSH access allows you to run the {% data variables.product.prodname_ghe_server %} command line utilities and is useful for troubleshooting, running backups, and configuring replication.' versions: enterprise-server: '*' diff --git a/translations/ru-RU/content/admin/configuration/accessing-the-management-console.md b/translations/ru-RU/content/admin/configuration/accessing-the-management-console.md index 15444df1134c..d37b78b44a65 100644 --- a/translations/ru-RU/content/admin/configuration/accessing-the-management-console.md +++ b/translations/ru-RU/content/admin/configuration/accessing-the-management-console.md @@ -10,8 +10,6 @@ redirect_from: - /enterprise/admin/guides/installation/web-based-management-console/ - /enterprise/admin/installation/accessing-the-management-console - /enterprise/admin/configuration/accessing-the-management-console - - /enterprise/admin/configuration/accessing-the-management-console - - /enterprise/admin/configuration/accessing-the-management-console versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/configuration/command-line-utilities.md b/translations/ru-RU/content/admin/configuration/command-line-utilities.md index 19c58f744d84..5cfe9f9ffbf4 100644 --- a/translations/ru-RU/content/admin/configuration/command-line-utilities.md +++ b/translations/ru-RU/content/admin/configuration/command-line-utilities.md @@ -20,7 +20,8 @@ You can execute these commands from anywhere on the VM after signing in as an SS This utility sets a banner at the top of every {% data variables.product.prodname_enterprise %} page. You can use it to broadcast a message to your users. {% if currentVersion ver_gt "enterprise-server@2.21" %} -You can also set an announcement banner using the enterprise settings on {% data variables.product.product_name %}. For more information, see "[Customizing user messages on your instance](/enterprise/admin/user-management/customizing-user-messages-on-your-instance#creating-a-global-announcement-banner)." +You can also set an announcement banner using the enterprise settings on +{% data variables.product.product_name %}. For more information, see "[Customizing user messages on your instance](/enterprise/admin/user-management/customizing-user-messages-on-your-instance#creating-a-global-announcement-banner)." {% endif %} ```shell @@ -181,7 +182,6 @@ This utility allows you to control the state of the installation's maintenance m ghe-maintenance -h ``` -{% if currentVersion ver_gt "enterprise-server@2.17" %} #### ghe-motd This utility re-displays the message of the day (MOTD) that administrators see when accessing the instance via the administrative shell. The output contains an overview of the instance's state. @@ -189,7 +189,6 @@ This utility re-displays the message of the day (MOTD) that administrators see w ```shell ghe-motd ``` -{% endif %} #### ghe-nwo diff --git a/translations/ru-RU/content/admin/configuration/configuring-a-hostname.md b/translations/ru-RU/content/admin/configuration/configuring-a-hostname.md index c1dc9fc9981e..a254a58e0db4 100644 --- a/translations/ru-RU/content/admin/configuration/configuring-a-hostname.md +++ b/translations/ru-RU/content/admin/configuration/configuring-a-hostname.md @@ -5,7 +5,6 @@ redirect_from: - /enterprise/admin/guides/installation/configuring-hostnames/ - /enterprise/admin/installation/configuring-a-hostname - /enterprise/admin/configuration/configuring-a-hostname - - /enterprise/admin/configuration/configuring-a-hostname versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/configuration/configuring-advanced-security-features.md b/translations/ru-RU/content/admin/configuration/configuring-advanced-security-features.md index d2f5ed8f93d4..e9a8a1113feb 100644 --- a/translations/ru-RU/content/admin/configuration/configuring-advanced-security-features.md +++ b/translations/ru-RU/content/admin/configuration/configuring-advanced-security-features.md @@ -5,9 +5,6 @@ intro: 'You can enable or disable {% data variables.product.prodname_advanced_se mapTopic: true redirect_from: - /enterprise/admin/configuration/configuring-advanced-security-features - - /enterprise/admin/configuration/configuring-advanced-security-features - - /enterprise/admin/configuration/configuring-advanced-security-features - - /enterprise/admin/configuration/configuring-advanced-security-features versions: enterprise-server: '>=2.22' --- diff --git a/translations/ru-RU/content/admin/configuration/configuring-an-outbound-web-proxy-server.md b/translations/ru-RU/content/admin/configuration/configuring-an-outbound-web-proxy-server.md index abebbd8900de..f9c08d0b6523 100644 --- a/translations/ru-RU/content/admin/configuration/configuring-an-outbound-web-proxy-server.md +++ b/translations/ru-RU/content/admin/configuration/configuring-an-outbound-web-proxy-server.md @@ -5,7 +5,6 @@ redirect_from: - /enterprise/admin/guides/installation/configuring-a-proxy-server/ - /enterprise/admin/installation/configuring-an-outbound-web-proxy-server - /enterprise/admin/configuration/configuring-an-outbound-web-proxy-server - - /enterprise/admin/configuration/configuring-an-outbound-web-proxy-server versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/configuration/configuring-applications.md b/translations/ru-RU/content/admin/configuration/configuring-applications.md index 698cca2171c5..509c9228078f 100644 --- a/translations/ru-RU/content/admin/configuration/configuring-applications.md +++ b/translations/ru-RU/content/admin/configuration/configuring-applications.md @@ -4,7 +4,6 @@ intro: 'You can configure internal application settings for {% data variables.pr redirect_from: - /enterprise/admin/installation/configuring-applications - /enterprise/admin/configuration/configuring-applications - - /enterprise/admin/configuration/configuring-applications versions: enterprise-server: '*' --- @@ -16,5 +15,7 @@ You can choose the amount of time that {% data variables.product.product_locatio {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} 3. In the left sidebar, click **Applications**. ![Applications tab in the settings sidebar](/assets/images/enterprise/management-console/sidebar-applications.png) -4. Under "Avatar image cache time (seconds)", type the number of seconds that you would like {% data variables.product.product_location_enterprise %} to cache avatar images. ![Avatar image caching form field](/assets/images/enterprise/management-console/add-image-caching-value-field.png) +4. Under "Avatar image cache time (seconds)", type the number of seconds that you would like +{% data variables.product.product_location_enterprise %} to cache avatar images. +![Avatar image caching form field](/assets/images/enterprise/management-console/add-image-caching-value-field.png) {% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/ru-RU/content/admin/configuration/configuring-built-in-firewall-rules.md b/translations/ru-RU/content/admin/configuration/configuring-built-in-firewall-rules.md index 7aec4cd26d76..0b98a22cfe6d 100644 --- a/translations/ru-RU/content/admin/configuration/configuring-built-in-firewall-rules.md +++ b/translations/ru-RU/content/admin/configuration/configuring-built-in-firewall-rules.md @@ -5,8 +5,6 @@ redirect_from: - /enterprise/admin/guides/installation/configuring-firewall-settings/ - /enterprise/admin/installation/configuring-built-in-firewall-rules - /enterprise/admin/configuration/configuring-built-in-firewall-rules - - /enterprise/admin/configuration/configuring-built-in-firewall-rules - - /enterprise/admin/configuration/configuring-built-in-firewall-rules versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/configuration/configuring-code-scanning-for-your-appliance.md b/translations/ru-RU/content/admin/configuration/configuring-code-scanning-for-your-appliance.md index b435be14e079..700e2a95021e 100644 --- a/translations/ru-RU/content/admin/configuration/configuring-code-scanning-for-your-appliance.md +++ b/translations/ru-RU/content/admin/configuration/configuring-code-scanning-for-your-appliance.md @@ -6,7 +6,6 @@ product: '{% data reusables.gated-features.code-scanning %}' miniTocMaxHeadingLevel: 4 redirect_from: - /enterprise/admin/configuration/configuring-code-scanning-for-your-appliance - - /enterprise/admin/configuration/configuring-code-scanning-for-your-appliance versions: enterprise-server: '>=2.22' --- @@ -38,7 +37,9 @@ If you can't see **{% data variables.product.prodname_advanced_security %}** in {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_management_console.advanced-security-tab %} -1. Under "{% data variables.product.prodname_advanced_security %}," click **{% data variables.product.prodname_code_scanning_capc %}**. ![Checkbox to enable or disable {% data variables.product.prodname_code_scanning %}](/assets/images/enterprise/management-console/enable-code-scanning-checkbox.png) +1. Under " +{% data variables.product.prodname_advanced_security %}," click **{% data variables.product.prodname_code_scanning_capc %}**. +![Checkbox to enable or disable {% data variables.product.prodname_code_scanning %}](/assets/images/enterprise/management-console/enable-code-scanning-checkbox.png) {% data reusables.enterprise_management_console.save-settings %} @@ -48,6 +49,8 @@ If you can't see **{% data variables.product.prodname_advanced_security %}** in If you are enrolled in the {% data variables.product.prodname_actions %} beta, then {% data variables.product.prodname_ghe_server %} can run {% data variables.product.prodname_code_scanning %} using a {% data variables.product.prodname_actions %} workflow. First, you need to provision one or more self-hosted {% data variables.product.prodname_actions %} runners in your environment. You can provision self-hosted runners at the repository, organization, or enterprise account level. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners)" and "[Adding self-hosted runners](/actions/hosting-your-own-runners/adding-self-hosted-runners)." +You must ensure that Git is in the PATH variable on any self-hosted runners you use to run {% data variables.product.prodname_codeql %} actions. + #### Provisioning the action To run {% data variables.product.prodname_code_scanning %} on {% data variables.product.prodname_ghe_server %} with {% data variables.product.prodname_actions %}, the appropriate action must be available locally. You can make the action available in three ways. @@ -68,7 +71,7 @@ After you configure a self-hosted runner, users can enable {% data variables.pro ### Running {% data variables.product.prodname_code_scanning %} using the {% data variables.product.prodname_codeql_runner %} If your organization isn't taking part in the beta for {% data variables.product.prodname_actions %}, or if you don't want to use {% data variables.product.prodname_actions %}, you can run {% data variables.product.prodname_code_scanning %} using the {% data variables.product.prodname_codeql_runner %}. -The {% data variables.product.prodname_codeql_runner %} is a command-line tool that you can add to your third-party CI/CD system. The tool runs {% data variables.product.prodname_codeql %} analysis on a checkout of a {% data variables.product.prodname_dotcom %} repository. For more information, see "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)." +The {% data variables.product.prodname_codeql_runner %} is a command-line tool that you can add to your third-party CI/CD system. The tool runs {% data variables.product.prodname_codeql %} analysis on a checkout of a {% data variables.product.prodname_dotcom %} repository. For more information, see "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)." ### Disabling {% data variables.product.prodname_code_scanning %} @@ -77,5 +80,7 @@ The {% data variables.product.prodname_codeql_runner %} is a command-line tool t {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_management_console.advanced-security-tab %} -1. Under "{% data variables.product.prodname_advanced_security %}", unselect **{% data variables.product.prodname_code_scanning_capc %}**. ![Checkbox to enable or disable {% data variables.product.prodname_code_scanning %}](/assets/images/enterprise/management-console/code-scanning-disable.png) +1. Under " +{% data variables.product.prodname_advanced_security %}", unselect **{% data variables.product.prodname_code_scanning_capc %}**. +![Checkbox to enable or disable {% data variables.product.prodname_code_scanning %}](/assets/images/enterprise/management-console/code-scanning-disable.png) {% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/ru-RU/content/admin/configuration/configuring-dns-nameservers.md b/translations/ru-RU/content/admin/configuration/configuring-dns-nameservers.md index 0eb336ef7634..6856350548b7 100644 --- a/translations/ru-RU/content/admin/configuration/configuring-dns-nameservers.md +++ b/translations/ru-RU/content/admin/configuration/configuring-dns-nameservers.md @@ -5,8 +5,6 @@ redirect_from: - /enterprise/admin/guides/installation/about-dns-nameservers/ - /enterprise/admin/installation/configuring-dns-nameservers - /enterprise/admin/configuration/configuring-dns-nameservers - - /enterprise/admin/configuration/configuring-dns-nameservers - - /enterprise/admin/configuration/configuring-dns-nameservers versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/configuration/configuring-network-settings.md b/translations/ru-RU/content/admin/configuration/configuring-network-settings.md index 45fcfc72c342..b5d7abf7e09d 100644 --- a/translations/ru-RU/content/admin/configuration/configuring-network-settings.md +++ b/translations/ru-RU/content/admin/configuration/configuring-network-settings.md @@ -7,8 +7,6 @@ redirect_from: - /enterprise/admin/guides/installation/configuring-your-github-enterprise-network-settings/ - /enterprise/admin/installation/configuring-your-github-enterprise-server-network-settings - /enterprise/admin/configuration/configuring-network-settings - - /enterprise/admin/configuration/configuring-network-settings - - /enterprise/admin/configuration/configuring-network-settings intro: 'Configure {% data variables.product.prodname_ghe_server %} with the DNS nameservers and hostname required in your network. You can also configure a proxy server or firewall rules. You must allow access to certain ports for administrative and user purposes.' mapTopic: true versions: diff --git a/translations/ru-RU/content/admin/configuration/configuring-rate-limits.md b/translations/ru-RU/content/admin/configuration/configuring-rate-limits.md index a413e611ac1f..007adec8d3e0 100644 --- a/translations/ru-RU/content/admin/configuration/configuring-rate-limits.md +++ b/translations/ru-RU/content/admin/configuration/configuring-rate-limits.md @@ -4,7 +4,6 @@ intro: 'You can set rate limits for {% data variables.product.prodname_ghe_serve redirect_from: - /enterprise/admin/installation/configuring-rate-limits - /enterprise/admin/configuration/configuring-rate-limits - - /enterprise/admin/configuration/configuring-rate-limits versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md b/translations/ru-RU/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md index edef94b695fb..d6bdc45deec3 100644 --- a/translations/ru-RU/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md +++ b/translations/ru-RU/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md @@ -4,12 +4,19 @@ intro: 'By default, {% data variables.product.prodname_ghe_server %} retrieves n redirect_from: - /enterprise/admin/installation/configuring-the-ip-address-using-the-virtual-machine-console - /enterprise/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console - - /enterprise/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console versions: enterprise-server: '*' --- +{% note %} + +**Note:** We do not support adding additional network adapters to {% data variables.product.prodname_ghe_server %}. + +{% endnote %} + {% data reusables.enterprise_installation.open-vm-console-start %} 3. Choose to configure the `IPv4` or `IPv6` protocol. ![Options to choose the IPv4 or the IPv6 protocol](/assets/images/enterprise/network-configuration/IPv4-or-IPv6-protocol.png) 4. Configure options for the protocol you chose. ![Menu with IP protocol options](/assets/images/enterprise/network-configuration/network-settings-selection.png) {% data reusables.enterprise_installation.vm-console-done %} + + diff --git a/translations/ru-RU/content/admin/configuration/configuring-your-enterprise.md b/translations/ru-RU/content/admin/configuration/configuring-your-enterprise.md index a655e59da1db..74b50d6c1bc9 100644 --- a/translations/ru-RU/content/admin/configuration/configuring-your-enterprise.md +++ b/translations/ru-RU/content/admin/configuration/configuring-your-enterprise.md @@ -8,8 +8,6 @@ redirect_from: - /enterprise/admin/guides/installation/configuring-the-github-enterprise-appliance/ - /enterprise/admin/installation/configuring-the-github-enterprise-server-appliance - /enterprise/admin/configuration/configuring-your-enterprise - - /enterprise/admin/configuration/configuring-your-enterprise - - /enterprise/admin/configuration/configuring-your-enterprise mapTopic: true versions: enterprise-server: '*' diff --git a/translations/ru-RU/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md b/translations/ru-RU/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md index 3b144317be74..8991c993c050 100644 --- a/translations/ru-RU/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md +++ b/translations/ru-RU/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md @@ -7,7 +7,6 @@ redirect_from: - /enterprise/admin/developer-workflow/connecting-github-enterprise-server-to-githubcom/ - /enterprise/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud - /enterprise/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud - - /enterprise/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud permissions: 'Site administrators for {% data variables.product.prodname_ghe_server %} who are also owners of a {% data variables.product.prodname_ghe_cloud %} organization or enterprise account can enable {% data variables.product.prodname_github_connect %}.' versions: enterprise-server: '*' @@ -38,12 +37,12 @@ Enabling {% data variables.product.prodname_github_connect %} also creates a {% Enabling {% data variables.product.prodname_github_connect %} will not allow {% data variables.product.prodname_dotcom_the_website %} users to make changes to {% data variables.product.prodname_ghe_server %}. -{% if currentVersion ver_gt "enterprise-server@2.18" %} For more information about managing enterprise accounts using the GraphQL API, see "[Enterprise accounts](/v4/guides/managing-enterprise-accounts)." -{% endif %} ### Enabling {% data variables.product.prodname_github_connect %} -1. Sign in to {% data variables.product.product_location_enterprise %} and {% data variables.product.prodname_dotcom_the_website %}. +1. Sign in to + +{% data variables.product.product_location_enterprise %} and {% data variables.product.prodname_dotcom_the_website %}. {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.settings-tab %} diff --git a/translations/ru-RU/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md b/translations/ru-RU/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md index 6e20ed253532..f6a08240e304 100644 --- a/translations/ru-RU/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md +++ b/translations/ru-RU/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md @@ -5,7 +5,6 @@ redirect_from: - /enterprise/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server - /enterprise/admin/configuration/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server - /enterprise/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server - - /enterprise/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server permissions: 'Site administrators for {% data variables.product.prodname_ghe_server %} who are also owners of the connected {% data variables.product.prodname_ghe_cloud %} organization or enterprise account can enable {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %}.' versions: enterprise-server: '*' @@ -46,7 +45,8 @@ Before enabling {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data v ``` shell $ ghe-dep-graph-enable ``` -3. Return to {% data variables.product.prodname_ghe_server %}. +3. Return to +{% data variables.product.prodname_ghe_server %}. {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.settings-tab %} diff --git a/translations/ru-RU/content/admin/configuration/enabling-and-scheduling-maintenance-mode.md b/translations/ru-RU/content/admin/configuration/enabling-and-scheduling-maintenance-mode.md index 631662abe99e..cfe6b80bc79b 100644 --- a/translations/ru-RU/content/admin/configuration/enabling-and-scheduling-maintenance-mode.md +++ b/translations/ru-RU/content/admin/configuration/enabling-and-scheduling-maintenance-mode.md @@ -10,7 +10,6 @@ redirect_from: - /enterprise/admin/guides/installation/maintenance-mode/ - /enterprise/admin/installation/enabling-and-scheduling-maintenance-mode - /enterprise/admin/configuration/enabling-and-scheduling-maintenance-mode - - /enterprise/admin/configuration/enabling-and-scheduling-maintenance-mode versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/configuration/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud.md b/translations/ru-RU/content/admin/configuration/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud.md index b8dee77aa4e7..00cc2644b996 100644 --- a/translations/ru-RU/content/admin/configuration/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud.md +++ b/translations/ru-RU/content/admin/configuration/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud.md @@ -4,7 +4,6 @@ intro: 'You can connect {% data variables.product.product_location_enterprise %} redirect_from: - /enterprise/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud - /enterprise/admin/configuration/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud - - /enterprise/admin/configuration/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud permissions: 'Site administrators for {% data variables.product.prodname_ghe_server %} who are also owners of the connected {% data variables.product.prodname_ghe_cloud %} organization or enterprise account can enable automatic user license synchronization.' versions: enterprise-server: '*' diff --git a/translations/ru-RU/content/admin/configuration/enabling-private-mode.md b/translations/ru-RU/content/admin/configuration/enabling-private-mode.md index f89093a3e5fa..c8ca9c3d1a99 100644 --- a/translations/ru-RU/content/admin/configuration/enabling-private-mode.md +++ b/translations/ru-RU/content/admin/configuration/enabling-private-mode.md @@ -7,7 +7,6 @@ redirect_from: - /enterprise/admin/guides/installation/securing-your-instance/ - /enterprise/admin/installation/enabling-private-mode - /enterprise/admin/configuration/enabling-private-mode - - /enterprise/admin/configuration/enabling-private-mode versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/configuration/enabling-subdomain-isolation.md b/translations/ru-RU/content/admin/configuration/enabling-subdomain-isolation.md index 1442ab184cc3..7891ff63a807 100644 --- a/translations/ru-RU/content/admin/configuration/enabling-subdomain-isolation.md +++ b/translations/ru-RU/content/admin/configuration/enabling-subdomain-isolation.md @@ -16,28 +16,29 @@ Subdomain isolation mitigates cross-site scripting and other related vulnerabili When subdomain isolation is enabled, {% data variables.product.prodname_ghe_server %} replaces several paths with subdomains. {% if currentVersion ver_gt "enterprise-server@2.21" %} -To use Docker with {% data variables.product.prodname_registry %}, you must also enable subdomain isolation. For more information, see "[Configuring Docker for use with {% data variables.product.prodname_registry %}](/enterprise/{{ currentVersion }}/user/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)." +To use Docker with +{% data variables.product.prodname_registry %}, you must also enable subdomain isolation. For more information, see "[Configuring Docker for use with {% data variables.product.prodname_registry %}](/enterprise/{{ currentVersion }}/user/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)." {% data reusables.package_registry.packages-ghes-release-stage %} | {% endif %} -| Path without subdomain isolation | Path with subdomain isolation | -| --------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- | -| `http(s)://HOSTNAME/assets/` | `http(s)://assets.HOSTNAME/` | -| `http(s)://HOSTNAME/avatars/` | `http(s)://avatars.HOSTNAME/` | -| `http(s)://HOSTNAME/codeload/` | `http(s)://codeload.HOSTNAME/` | -| `http(s)://HOSTNAME/gist/` | `http(s)://gist.HOSTNAME/` | -| `http(s)://HOSTNAME/media/` | `http(s)://media.HOSTNAME/` | -| `http(s)://HOSTNAME/pages/` | `http(s)://pages.HOSTNAME/` | -| `http(s)://HOSTNAME/raw/` | `http(s)://raw.HOSTNAME/` | -| `http(s)://HOSTNAME/render/` | `http(s)://render.HOSTNAME/` | -| `http(s)://HOSTNAME/reply/` | `http(s)://reply.HOSTNAME/` | -| `http(s)://HOSTNAME/uploads/` | `http(s)://uploads.HOSTNAME/` |{% if currentVersion ver_gt "enterprise-server@2.21" %} -| N/A, Docker with {% data variables.product.prodname_registry %} will not work with subdomain isolation disabled. | `http(s)://docker.HOSTNAME/` | -| `https://HOSTNAME/_registry/npm/` | `https://npm.HOSTNAME/` | -| `https://HOSTNAME/_registry/rubygems/` | `https://rubygems.HOSTNAME/` | -| `https://HOSTNAME/_registry/maven/` | `https://maven.HOSTNAME/` | -| `https://HOSTNAME/_registry/nuget/` | `https://nuget.HOSTNAME/`{% endif %} +| Path without subdomain isolation | Path with subdomain isolation | +| ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | +| `http(s)://HOSTNAME/assets/` | `http(s)://assets.HOSTNAME/` | +| `http(s)://HOSTNAME/avatars/` | `http(s)://avatars.HOSTNAME/` | +| `http(s)://HOSTNAME/codeload/` | `http(s)://codeload.HOSTNAME/` | +| `http(s)://HOSTNAME/gist/` | `http(s)://gist.HOSTNAME/` | +| `http(s)://HOSTNAME/media/` | `http(s)://media.HOSTNAME/` | +| `http(s)://HOSTNAME/pages/` | `http(s)://pages.HOSTNAME/` | +| `http(s)://HOSTNAME/raw/` | `http(s)://raw.HOSTNAME/` | +| `http(s)://HOSTNAME/render/` | `http(s)://render.HOSTNAME/` | +| `http(s)://HOSTNAME/reply/` | `http(s)://reply.HOSTNAME/` | +| `http(s)://HOSTNAME/uploads/` | `http(s)://uploads.HOSTNAME/` |{% if currentVersion ver_gt "enterprise-server@2.21" %} +| N/A, Docker with {% data variables.product.prodname_registry %} will not work with subdomain isolation disabled. | `http(s)://docker.HOSTNAME/` | +| `https://HOSTNAME/_registry/npm/` | `https://npm.HOSTNAME/` | +| `https://HOSTNAME/_registry/rubygems/` | `https://rubygems.HOSTNAME/` | +| `https://HOSTNAME/_registry/maven/` | `https://maven.HOSTNAME/` | +| `https://HOSTNAME/_registry/nuget/` | `https://nuget.HOSTNAME/`{% endif %} ### Требования diff --git a/translations/ru-RU/content/admin/configuration/enabling-unified-contributions-between-github-enterprise-server-and-githubcom.md b/translations/ru-RU/content/admin/configuration/enabling-unified-contributions-between-github-enterprise-server-and-githubcom.md index 65ca3d9f953d..cce3b0d12a75 100644 --- a/translations/ru-RU/content/admin/configuration/enabling-unified-contributions-between-github-enterprise-server-and-githubcom.md +++ b/translations/ru-RU/content/admin/configuration/enabling-unified-contributions-between-github-enterprise-server-and-githubcom.md @@ -7,7 +7,6 @@ redirect_from: - /enterprise/admin/developer-workflow/enabling-unified-contributions-between-github-enterprise-server-and-githubcom/ - /enterprise/admin/installation/enabling-unified-contributions-between-github-enterprise-server-and-githubcom - /enterprise/admin/configuration/enabling-unified-contributions-between-github-enterprise-server-and-githubcom - - /enterprise/admin/configuration/enabling-unified-contributions-between-github-enterprise-server-and-githubcom permissions: 'Site administrators for {% data variables.product.prodname_ghe_server %} who are also owners of the connected {% data variables.product.prodname_ghe_cloud %} organization or enterprise account can enable unified contributions between {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_dotcom_the_website %}.' versions: enterprise-server: '*' diff --git a/translations/ru-RU/content/admin/configuration/index.md b/translations/ru-RU/content/admin/configuration/index.md index b823121f0503..2e8a92d9f8a8 100644 --- a/translations/ru-RU/content/admin/configuration/index.md +++ b/translations/ru-RU/content/admin/configuration/index.md @@ -4,8 +4,6 @@ shortTitle: Configuring GitHub Enterprise intro: 'Once {% data variables.product.prodname_ghe_server %} is installed and set up, you can configure the appliance to suit your organization''s needs.' redirect_from: - /enterprise/admin/configuration - - /enterprise/admin/configuration - - /enterprise/admin/configuration versions: enterprise-server: '*' --- @@ -42,7 +40,7 @@ versions: {% topic_link_in_list /managing-connections-between-github-enterprise-server-and-github-enterprise-cloud %} {% link_in_list /connecting-github-enterprise-server-to-github-enterprise-cloud %} {% link_in_list /enabling-unified-search-between-github-enterprise-server-and-githubcom %} - {% link_in_list /enabling-unified-contributions-between-github-enterprise-server-and-githubcom %} + {% link_in_list /enabling-unified-contributions-between-github-enterprise-server-and-githubcom %} {% link_in_list /enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server %} {% link_in_list /enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud %} @@ -51,3 +49,11 @@ versions: {% topic_link_in_list /configuring-advanced-security-features %} {% link_in_list /configuring-code-scanning-for-your-appliance %} + +{% if currentVersion ver_gt "enterprise-server@2.21" %} +{% note %} + +**Note:** To configure {% data variables.product.prodname_actions %} or {% data variables.product.prodname_registry %} for your enterprise, see "[Managing GitHub Actions for your enterprise](/admin/github-actions)" or "[Managing GitHub Packages for your enterprise](/admin/packages)." + +{% endnote %} +{% endif %} diff --git a/translations/ru-RU/content/admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md b/translations/ru-RU/content/admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md index ac87ebd704e8..63e4e25bee0e 100644 --- a/translations/ru-RU/content/admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md +++ b/translations/ru-RU/content/admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md @@ -9,8 +9,6 @@ redirect_from: - /enterprise/admin/developer-workflow/connecting-github-enterprise-server-and-githubcom/ - /enterprise/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud - /enterprise/admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud - - /enterprise/admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud - - /enterprise/admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/configuration/network-ports.md b/translations/ru-RU/content/admin/configuration/network-ports.md index c317c333e499..27bf326ce9b0 100644 --- a/translations/ru-RU/content/admin/configuration/network-ports.md +++ b/translations/ru-RU/content/admin/configuration/network-ports.md @@ -16,25 +16,25 @@ versions: Some administrative ports are required to configure {% data variables.product.product_location_enterprise %} and run certain features. Administrative ports are not required for basic application use by end users. -| Port | Service | Description | -| -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Port | Service | Description | +| -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 8443 | HTTPS | Secure web-based {% data variables.enterprise.management_console %}. Required for basic installation and configuration. | | 8080 | HTTP | Plain-text web-based {% data variables.enterprise.management_console %}. Not required unless SSL is disabled manually. | | 122 | SSH | Shell access for {% data variables.product.product_location_enterprise %}. Required to be open to incoming connections from all other nodes in a High Availability configuration. The default SSH port (22) is dedicated to Git and SSH application network traffic. | -| 1194/UDP | VPN | Secure replication network tunnel in High Availability configuration. Required to be open to all other nodes in the configuration. | -| 123/UDP | NTP | Required for time protocol operation. | -| 161/UDP | SNMP | Required for network monitoring protocol operation. | +| 1194/UDP | VPN | Secure replication network tunnel in High Availability configuration. Required to be open to all other nodes in the configuration. | +| 123/UDP | NTP | Required for time protocol operation. | +| 161/UDP | SNMP | Required for network monitoring protocol operation. | ### Application ports for end users Application ports provide web application and Git access for end users. -| Port | Service | Description | -| ---- | ------- | -------------------------------------------------------------------------------------------------------------------- | -| 443 | HTTPS | Access to the web application and Git over HTTPS. | -| 80 | HTTP | Access to the web application. All requests are redirected to the HTTPS port when SSL is enabled. | -| 22 | SSH | Access to Git over SSH. Supports clone, fetch, and push operations to public and private repositories. | -| 9418 | Git | Git protocol port supports clone and fetch operations to public repositories with unencrypted network communication. | +| Port | Service | Description | +| ---- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 443 | HTTPS | Access to the web application and Git over HTTPS. | +| 80 | HTTP | Access to the web application. All requests are redirected to the HTTPS port when SSL is enabled. | +| 22 | SSH | Access to Git over SSH. Supports clone, fetch, and push operations to public and private repositories. | +| 9418 | Git | Git protocol port supports clone and fetch operations to public repositories with unencrypted network communication. {% data reusables.enterprise_installation.when-9418-necessary %} {% data reusables.enterprise_installation.terminating-tls %} diff --git a/translations/ru-RU/content/admin/configuration/troubleshooting-ssl-errors.md b/translations/ru-RU/content/admin/configuration/troubleshooting-ssl-errors.md index ad81001303f2..98c2bf418f44 100644 --- a/translations/ru-RU/content/admin/configuration/troubleshooting-ssl-errors.md +++ b/translations/ru-RU/content/admin/configuration/troubleshooting-ssl-errors.md @@ -6,8 +6,6 @@ redirect_from: - /enterprise/admin/categories/dns-ssl-and-subdomain-configuration/ - /enterprise/admin/installation/troubleshooting-ssl-errors - /enterprise/admin/configuration/troubleshooting-ssl-errors - - /enterprise/admin/configuration/troubleshooting-ssl-errors - - /enterprise/admin/configuration/troubleshooting-ssl-errors versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/configuration/using-github-enterprise-server-with-a-load-balancer.md b/translations/ru-RU/content/admin/configuration/using-github-enterprise-server-with-a-load-balancer.md index c259994c7040..dea540b959e4 100644 --- a/translations/ru-RU/content/admin/configuration/using-github-enterprise-server-with-a-load-balancer.md +++ b/translations/ru-RU/content/admin/configuration/using-github-enterprise-server-with-a-load-balancer.md @@ -5,7 +5,6 @@ redirect_from: - /enterprise/admin/guides/installation/using-github-enterprise-with-a-load-balancer/ - /enterprise/admin/installation/using-github-enterprise-server-with-a-load-balancer - /enterprise/admin/configuration/using-github-enterprise-server-with-a-load-balancer - - /enterprise/admin/configuration/using-github-enterprise-server-with-a-load-balancer versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/configuration/validating-your-domain-settings.md b/translations/ru-RU/content/admin/configuration/validating-your-domain-settings.md index e778ef3a53c1..39e92c5492f1 100644 --- a/translations/ru-RU/content/admin/configuration/validating-your-domain-settings.md +++ b/translations/ru-RU/content/admin/configuration/validating-your-domain-settings.md @@ -4,7 +4,6 @@ intro: 'Ensure that your domain settings are properly configured before booting redirect_from: - /enterprise/admin/installation/validating-your-domain-settings - /enterprise/admin/configuration/validating-your-domain-settings - - /enterprise/admin/configuration/validating-your-domain-settings versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/enterprise-management/about-cluster-nodes.md b/translations/ru-RU/content/admin/enterprise-management/about-cluster-nodes.md index aa3314219c9a..a2cde5b81346 100644 --- a/translations/ru-RU/content/admin/enterprise-management/about-cluster-nodes.md +++ b/translations/ru-RU/content/admin/enterprise-management/about-cluster-nodes.md @@ -4,7 +4,6 @@ intro: '*Nodes* are {% data variables.product.prodname_ghe_server %} instances t redirect_from: - /enterprise/admin/clustering/about-cluster-nodes - /enterprise/admin/enterprise-management/about-cluster-nodes - - /enterprise/admin/enterprise-management/about-cluster-nodes versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/enterprise-management/about-clustering.md b/translations/ru-RU/content/admin/enterprise-management/about-clustering.md index 3c0cb882f87d..ee94eff1e93c 100644 --- a/translations/ru-RU/content/admin/enterprise-management/about-clustering.md +++ b/translations/ru-RU/content/admin/enterprise-management/about-clustering.md @@ -6,8 +6,6 @@ redirect_from: - /enterprise/admin/clustering/about-clustering - /enterprise/admin/clustering/clustering-overview/ - /enterprise/admin/enterprise-management/about-clustering - - /enterprise/admin/enterprise-management/about-clustering - - /enterprise/admin/enterprise-management/about-clustering versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/enterprise-management/about-geo-replication.md b/translations/ru-RU/content/admin/enterprise-management/about-geo-replication.md index 5866a1e14cb6..f1db59595e72 100644 --- a/translations/ru-RU/content/admin/enterprise-management/about-geo-replication.md +++ b/translations/ru-RU/content/admin/enterprise-management/about-geo-replication.md @@ -18,7 +18,7 @@ Geo DNS, such as [Amazon's Route 53 service](http://docs.aws.amazon.com/Route53/ ### Ограничения -Writing requests to the replica requires sending the data to the primary and all replicas. This means that the performance of all writes are limited by the slowest replica{% if currentVersion ver_gt "enterprise-server@2.17" %}, although new geo-replicas can seed the majority of their data from existing co-located geo-replicas, rather than from the primary{% endif %}. Geo-replication will not add capacity to a {% data variables.product.prodname_ghe_server %} instance or solve performance issues related to insufficient CPU or memory resources. If the primary appliance is offline, active replicas will be unable to serve any read or write requests. +Writing requests to the replica requires sending the data to the primary and all replicas. This means that the performance of all writes are limited by the slowest replica, although new geo-replicas can seed the majority of their data from existing co-located geo-replicas, rather than from the primary. Geo-replication will not add capacity to a {% data variables.product.prodname_ghe_server %} instance or solve performance issues related to insufficient CPU or memory resources. If the primary appliance is offline, active replicas will be unable to serve any read or write requests. ### Monitoring a geo-replication configuration diff --git a/translations/ru-RU/content/admin/enterprise-management/about-high-availability-configuration.md b/translations/ru-RU/content/admin/enterprise-management/about-high-availability-configuration.md index bfab34f4a074..03bc5d205411 100644 --- a/translations/ru-RU/content/admin/enterprise-management/about-high-availability-configuration.md +++ b/translations/ru-RU/content/admin/enterprise-management/about-high-availability-configuration.md @@ -52,7 +52,7 @@ To manage replication on {% data variables.product.prodname_ghe_server %}, use t The `ghe-repl-setup` command puts a {% data variables.product.prodname_ghe_server %} appliance in replica standby mode. - - An encrypted {% if currentVersion ver_gt "enterprise-server@2.17" %}WireGuard VPN{% else %}OpenVPN{% endif %} tunnel is configured for communication between the two appliances. + - An encrypted WireGuard VPN tunnel is configured for communication between the two appliances. - Database services are configured for replication and started. - Application services are disabled. Attempts to access the replica appliance over HTTP, Git, or other supported protocols will result in an "appliance in replica mode" maintenance page or error message. @@ -71,8 +71,7 @@ Run `ghe-repl-start' to start replicating against the newly configured primary. The `ghe-repl-start` command turns on active replication of all datastores. ```shell -admin@169-254-1-2:~$ ghe-repl-start{% if currentVersion ver_lt "enterprise-server@2.18" %} -Starting OpenVPN tunnel ... {% endif %} +admin@169-254-1-2:~$ ghe-repl-start Starting MySQL replication ... Starting Redis replication ... Starting Elasticsearch replication ... @@ -144,8 +143,7 @@ Stopping Pages replication ... Stopping Git replication ... Stopping MySQL replication ... Stopping Redis replication ... -Stopping Elasticsearch replication ...{% if currentVersion ver_lt "enterprise-server@2.18" %} -Stopping OpenVPN tunnel ...{% endif %} +Stopping Elasticsearch replication ... Success: replication was stopped for all services. ``` @@ -163,8 +161,7 @@ Stopping replication ... | Stopping Git replication ... | Stopping MySQL replication ... | Stopping Redis replication ... - | Stopping Elasticsearch replication ...{% if currentVersion ver_lt "enterprise-server@2.18" %} - | Stopping OpenVPN tunnel ...{% endif %} + | Stopping Elasticsearch replication ... | Success: replication was stopped for all services. Switching out of replica mode ... | Success: Replication configuration has been removed. diff --git a/translations/ru-RU/content/admin/enterprise-management/accessing-the-monitor-dashboard.md b/translations/ru-RU/content/admin/enterprise-management/accessing-the-monitor-dashboard.md index 7496c03f9556..3b2cd2829c94 100644 --- a/translations/ru-RU/content/admin/enterprise-management/accessing-the-monitor-dashboard.md +++ b/translations/ru-RU/content/admin/enterprise-management/accessing-the-monitor-dashboard.md @@ -4,7 +4,6 @@ intro: '{% data variables.product.prodname_ghe_server %} includes a web-based mo redirect_from: - /enterprise/admin/installation/accessing-the-monitor-dashboard - /enterprise/admin/enterprise-management/accessing-the-monitor-dashboard - - /enterprise/admin/enterprise-management/accessing-the-monitor-dashboard versions: enterprise-server: '*' --- @@ -25,10 +24,10 @@ versions: Use the monitor dashboard to stay informed on your appliance's resource health and make decisions on how to fix high usage issues. -| Problem | Possible cause(s) | Recommendations | -| -------------------------------- | ---------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| High CPU usage | VM contention from other services or programs running on the same host | If possible, reconfigure other services or programs to use fewer CPU resources. To increase total CPU resources for the VM, see "[Increasing CPU or memory resources](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)." | -| High memory usage | VM contention from other services or programs running on the same host | If possible, reconfigure other services or programs to use less memory. To increase the total memory available on the VM, see "[Increasing CPU or memory resources](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)." | -| Low disk space availability | Large binaries or log files consuming disk space | If possible, host large binaries on a separate server, and compress or archive log files. If necessary, increase disk space on the VM by following the steps for your platform in "[Increasing storage capacity](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity/)." | -| Higher than usual response times | Often caused by one of the above issues | Identify and fix the underlying issues. If response times remain high, contact {% data variables.contact.contact_ent_support %}. | +| Problem | Possible cause(s) | Recommendations | +| -------------------------------- | ---------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| High CPU usage | VM contention from other services or programs running on the same host | If possible, reconfigure other services or programs to use fewer CPU resources. To increase total CPU resources for the VM, see "[Increasing CPU or memory resources](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)." | +| High memory usage | VM contention from other services or programs running on the same host | If possible, reconfigure other services or programs to use less memory. To increase the total memory available on the VM, see "[Increasing CPU or memory resources](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)." | +| Low disk space availability | Large binaries or log files consuming disk space | If possible, host large binaries on a separate server, and compress or archive log files. If necessary, increase disk space on the VM by following the steps for your platform in "[Increasing storage capacity](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity/)." | +| Higher than usual response times | Often caused by one of the above issues | Identify and fix the underlying issues. If response times remain high, contact {% data variables.contact.contact_ent_support %}. | | Elevated error rates | Software issues | Contact {% data variables.contact.contact_ent_support %} and include your support bundle. For more information, see "[Providing data to {% data variables.product.prodname_enterprise %} Support](/enterprise/{{ currentVersion}}/admin/guides/enterprise-support/providing-data-to-github-support#creating-and-sharing-support-bundles)." | diff --git a/translations/ru-RU/content/admin/enterprise-management/cluster-network-configuration.md b/translations/ru-RU/content/admin/enterprise-management/cluster-network-configuration.md index fb2b07ad7573..a5e236ea4781 100644 --- a/translations/ru-RU/content/admin/enterprise-management/cluster-network-configuration.md +++ b/translations/ru-RU/content/admin/enterprise-management/cluster-network-configuration.md @@ -71,7 +71,6 @@ If a network level firewall is in place between nodes, these ports will need to | 8302/UDP | Consul | | 25827/UDP | Collectd | - ### Configuring a load balancer We recommend an external TCP-based load balancer that supports the PROXY protocol to distribute traffic across nodes. Consider these load balancer configurations: diff --git a/translations/ru-RU/content/admin/enterprise-management/configuring-clustering.md b/translations/ru-RU/content/admin/enterprise-management/configuring-clustering.md index 01191c647aba..6fc9f34af1ac 100644 --- a/translations/ru-RU/content/admin/enterprise-management/configuring-clustering.md +++ b/translations/ru-RU/content/admin/enterprise-management/configuring-clustering.md @@ -6,8 +6,6 @@ redirect_from: - /enterprise/admin/clustering/managing-a-github-enterprise-server-cluster - /enterprise/admin/guides/clustering/managing-a-github-enterprise-cluster/ - /enterprise/admin/enterprise-management/configuring-clustering - - /enterprise/admin/enterprise-management/configuring-clustering - - /enterprise/admin/enterprise-management/configuring-clustering mapTopic: true versions: enterprise-server: '*' diff --git a/translations/ru-RU/content/admin/enterprise-management/configuring-high-availability.md b/translations/ru-RU/content/admin/enterprise-management/configuring-high-availability.md index 7f34ed1a537e..84b7b0ae9f98 100644 --- a/translations/ru-RU/content/admin/enterprise-management/configuring-high-availability.md +++ b/translations/ru-RU/content/admin/enterprise-management/configuring-high-availability.md @@ -6,8 +6,6 @@ redirect_from: - /enterprise/admin/guides/installation/high-availability-configuration/ - /enterprise/admin/guides/installation/configuring-github-enterprise-for-high-availability/ - /enterprise/admin/enterprise-management/configuring-high-availability - - /enterprise/admin/enterprise-management/configuring-high-availability - - /enterprise/admin/enterprise-management/configuring-high-availability intro: '{% data variables.product.prodname_ghe_server %} supports a high availability mode of operation designed to minimize service disruption in the event of hardware failure or major network outage affecting the primary appliance.' mapTopic: true versions: diff --git a/translations/ru-RU/content/admin/enterprise-management/creating-a-high-availability-replica.md b/translations/ru-RU/content/admin/enterprise-management/creating-a-high-availability-replica.md index fb40bd220334..b7729fd70cab 100644 --- a/translations/ru-RU/content/admin/enterprise-management/creating-a-high-availability-replica.md +++ b/translations/ru-RU/content/admin/enterprise-management/creating-a-high-availability-replica.md @@ -49,7 +49,7 @@ This example configuration uses a primary and two replicas, which are located in (replica2)$ ghe-repl-setup --add PRIMARY IP (replica2)$ ghe-repl-start ``` -3. By default, replicas are configured to the same datacenter{% if currentVersion ver_gt "enterprise-server@2.17" %}, and will now attempt to seed from an existing node in the same datacenter{% endif %}. Configure the replicas for different datacenters by setting a different value for the datacenter option. The specific values can be anything you would like as long as they are different from each other. Run the `ghe-repl-node` command on each node and specify the datacenter. +3. By default, replicas are configured to the same datacenter, and will now attempt to seed from an existing node in the same datacenter. Configure the replicas for different datacenters by setting a different value for the datacenter option. The specific values can be anything you would like as long as they are different from each other. Run the `ghe-repl-node` command on each node and specify the datacenter. On the primary: ```shell diff --git a/translations/ru-RU/content/admin/enterprise-management/enabling-automatic-update-checks.md b/translations/ru-RU/content/admin/enterprise-management/enabling-automatic-update-checks.md index 376a2ec4c7d4..2d409b26a0df 100644 --- a/translations/ru-RU/content/admin/enterprise-management/enabling-automatic-update-checks.md +++ b/translations/ru-RU/content/admin/enterprise-management/enabling-automatic-update-checks.md @@ -4,7 +4,6 @@ intro: 'You can enable automatic update checks so that {% data variables.product redirect_from: - /enterprise/admin/installation/enabling-automatic-update-checks - /enterprise/admin/enterprise-management/enabling-automatic-update-checks - - /enterprise/admin/enterprise-management/enabling-automatic-update-checks versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/enterprise-management/evacuating-a-cluster-node.md b/translations/ru-RU/content/admin/enterprise-management/evacuating-a-cluster-node.md index 9567cc9cff75..7868b4b8b1db 100644 --- a/translations/ru-RU/content/admin/enterprise-management/evacuating-a-cluster-node.md +++ b/translations/ru-RU/content/admin/enterprise-management/evacuating-a-cluster-node.md @@ -4,7 +4,6 @@ intro: You can evacuate data services on a cluster node. redirect_from: - /enterprise/admin/clustering/evacuating-a-cluster-node - /enterprise/admin/enterprise-management/evacuating-a-cluster-node - - /enterprise/admin/enterprise-management/evacuating-a-cluster-node versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/enterprise-management/increasing-cpu-or-memory-resources.md b/translations/ru-RU/content/admin/enterprise-management/increasing-cpu-or-memory-resources.md index 5957575419b3..81fa7c5ab2bc 100644 --- a/translations/ru-RU/content/admin/enterprise-management/increasing-cpu-or-memory-resources.md +++ b/translations/ru-RU/content/admin/enterprise-management/increasing-cpu-or-memory-resources.md @@ -4,7 +4,6 @@ intro: 'You can increase the CPU or memory resources for a {% data variables.pro redirect_from: - /enterprise/admin/installation/increasing-cpu-or-memory-resources - /enterprise/admin/enterprise-management/increasing-cpu-or-memory-resources - - /enterprise/admin/enterprise-management/increasing-cpu-or-memory-resources versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/enterprise-management/increasing-storage-capacity.md b/translations/ru-RU/content/admin/enterprise-management/increasing-storage-capacity.md index 1b4bf3aaf0f4..ece10c6a71a9 100644 --- a/translations/ru-RU/content/admin/enterprise-management/increasing-storage-capacity.md +++ b/translations/ru-RU/content/admin/enterprise-management/increasing-storage-capacity.md @@ -4,8 +4,6 @@ intro: 'You can increase or change the amount of storage available for Git repos redirect_from: - /enterprise/admin/installation/increasing-storage-capacity - /enterprise/admin/enterprise-management/increasing-storage-capacity - - /enterprise/admin/enterprise-management/increasing-storage-capacity - - /enterprise/admin/enterprise-management/increasing-storage-capacity versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/enterprise-management/index.md b/translations/ru-RU/content/admin/enterprise-management/index.md index 17a98ea0b3da..d53041ef94fe 100644 --- a/translations/ru-RU/content/admin/enterprise-management/index.md +++ b/translations/ru-RU/content/admin/enterprise-management/index.md @@ -3,11 +3,6 @@ title: 'Monitoring, managing, and updating your enterprise' intro: 'You can monitor your appliance, upgrade to a newer version, and configure clustering or high availability' redirect_from: - /enterprise/admin/enterprise-management - - /enterprise/admin/enterprise-management - - /enterprise/admin/enterprise-management - - /enterprise/admin/enterprise-management - - /enterprise/admin/enterprise-management - - /enterprise/admin/enterprise-management versions: enterprise-server: '*' --- @@ -21,8 +16,7 @@ versions: {% link_in_list /setting-up-external-monitoring %} {% link_in_list /configuring-collectd %} {% link_in_list /log-forwarding %} - {% link_in_list /monitoring-using-snmp %}{% if currentVersion ver_gt "enterprise-server@2.21" %} - {% link_in_list /monitoring-using-analytics %}{% endif %} + {% link_in_list /monitoring-using-snmp %} {% topic_link_in_list /updating-the-virtual-machine-and-physical-resources %} {% link_in_list /upgrade-requirements %} {% link_in_list /upgrading-github-enterprise-server %} diff --git a/translations/ru-RU/content/admin/enterprise-management/initializing-the-cluster.md b/translations/ru-RU/content/admin/enterprise-management/initializing-the-cluster.md index 888783ec32de..0fdc22d211ed 100644 --- a/translations/ru-RU/content/admin/enterprise-management/initializing-the-cluster.md +++ b/translations/ru-RU/content/admin/enterprise-management/initializing-the-cluster.md @@ -4,7 +4,6 @@ intro: 'A {% data variables.product.prodname_ghe_server %} cluster must be set u redirect_from: - /enterprise/admin/clustering/initializing-the-cluster - /enterprise/admin/enterprise-management/initializing-the-cluster - - /enterprise/admin/enterprise-management/initializing-the-cluster versions: enterprise-server: '*' --- @@ -18,7 +17,7 @@ versions: ### Configuring the first node -1. Connect to the node that will be designated as the `mysql-master` in `cluster.conf`. For more information, see “[About the cluster configuration file](/enterprise/{{ currentVersion }}/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)." +1. Connect to the node that will be designated as MySQL primary in `cluster.conf`. For more information, see "[About the cluster configuration file](/enterprise/{{ currentVersion }}/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)." 2. In your web browser, visit `https://:8443/setup/`. {% data reusables.enterprise_installation.upload-a-license-file %} {% data reusables.enterprise_installation.save-settings-in-web-based-mgmt-console %} @@ -44,7 +43,7 @@ This example `cluster.conf` defines a cluster with five nodes. The names of the nodes can be any valid hostname you choose. The names are set as the hostname of each node, and will also be added to `/etc/hosts` on each node, so that the nodes are locally resolvable to each other. -Specify the first cluster node you configured as the MySQL master via `mysql-server` and `mysql-master`. +Specify the first cluster node you configured as the MySQL primary via `mysql-server` and `mysql-master`. ``` [cluster] diff --git a/translations/ru-RU/content/admin/enterprise-management/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md b/translations/ru-RU/content/admin/enterprise-management/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md index e9c897a14dff..caaf1d320091 100644 --- a/translations/ru-RU/content/admin/enterprise-management/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md +++ b/translations/ru-RU/content/admin/enterprise-management/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md @@ -6,8 +6,6 @@ redirect_from: - /enterprise/admin/guides/installation/migrating-elasticsearch-indices-to-github-enterprise-2-14-or-later/ - /enterprise/admin/guides/installation/migrating-elasticsearch-indices-to-github-enterprise-server-2-14-or-later - /enterprise/admin/enterprise-management/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later - - /enterprise/admin/enterprise-management/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later - - /enterprise/admin/enterprise-management/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/enterprise-management/migrating-from-github-enterprise-1110x-to-2123.md b/translations/ru-RU/content/admin/enterprise-management/migrating-from-github-enterprise-1110x-to-2123.md index 11e538cb8a2a..eeefc968b813 100644 --- a/translations/ru-RU/content/admin/enterprise-management/migrating-from-github-enterprise-1110x-to-2123.md +++ b/translations/ru-RU/content/admin/enterprise-management/migrating-from-github-enterprise-1110x-to-2123.md @@ -9,7 +9,6 @@ redirect_from: - /enterprise/admin/guides/installation/migrating-to-a-different-platform-or-from-github-enterprise-11-10-34x/ - /enterprise/admin/guides/installation/migrating-from-github-enterprise-11-10-x-to-2-1-23 - /enterprise/admin/enterprise-management/migrating-from-github-enterprise-1110x-to-2123 - - /enterprise/admin/enterprise-management/migrating-from-github-enterprise-1110x-to-2123 intro: 'To migrate from {% data variables.product.prodname_enterprise %} 11.10.x to 2.1.23, you''ll need to set up a new appliance instance and migrate data from the previous instance.' versions: enterprise-server: '*' diff --git a/translations/ru-RU/content/admin/enterprise-management/monitoring-your-appliance.md b/translations/ru-RU/content/admin/enterprise-management/monitoring-your-appliance.md index 0cf3d500c053..4e995c9f6266 100644 --- a/translations/ru-RU/content/admin/enterprise-management/monitoring-your-appliance.md +++ b/translations/ru-RU/content/admin/enterprise-management/monitoring-your-appliance.md @@ -6,8 +6,6 @@ redirect_from: - /enterprise/admin/guides/installation/monitoring-your-github-enterprise-appliance/ - /enterprise/admin/installation/monitoring-your-github-enterprise-server-appliance - /enterprise/admin/enterprise-management/monitoring-your-appliance - - /enterprise/admin/enterprise-management/monitoring-your-appliance - - /enterprise/admin/enterprise-management/monitoring-your-appliance mapTopic: true versions: enterprise-server: '*' diff --git a/translations/ru-RU/content/admin/enterprise-management/recovering-a-high-availability-configuration.md b/translations/ru-RU/content/admin/enterprise-management/recovering-a-high-availability-configuration.md index 8364fed0d4d0..eadfb7f728e1 100644 --- a/translations/ru-RU/content/admin/enterprise-management/recovering-a-high-availability-configuration.md +++ b/translations/ru-RU/content/admin/enterprise-management/recovering-a-high-availability-configuration.md @@ -4,7 +4,6 @@ intro: 'After failing over to a {% data variables.product.prodname_ghe_server %} redirect_from: - /enterprise/admin/installation/recovering-a-high-availability-configuration - /enterprise/admin/enterprise-management/recovering-a-high-availability-configuration - - /enterprise/admin/enterprise-management/recovering-a-high-availability-configuration versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/enterprise-management/removing-a-high-availability-replica.md b/translations/ru-RU/content/admin/enterprise-management/removing-a-high-availability-replica.md index 1f1e76736dae..a5c633d5c3ef 100644 --- a/translations/ru-RU/content/admin/enterprise-management/removing-a-high-availability-replica.md +++ b/translations/ru-RU/content/admin/enterprise-management/removing-a-high-availability-replica.md @@ -4,8 +4,6 @@ intro: 'You can stop replication to a {% data variables.product.prodname_ghe_ser redirect_from: - /enterprise/admin/installation/removing-a-high-availability-replica - /enterprise/admin/enterprise-management/removing-a-high-availability-replica - - /enterprise/admin/enterprise-management/removing-a-high-availability-replica - - /enterprise/admin/enterprise-management/removing-a-high-availability-replica versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/enterprise-management/replacing-a-cluster-node.md b/translations/ru-RU/content/admin/enterprise-management/replacing-a-cluster-node.md index ea4ac7d693eb..4dde19d03866 100644 --- a/translations/ru-RU/content/admin/enterprise-management/replacing-a-cluster-node.md +++ b/translations/ru-RU/content/admin/enterprise-management/replacing-a-cluster-node.md @@ -4,8 +4,6 @@ intro: 'To replace a {% data variables.product.prodname_ghe_server %} node, you redirect_from: - /enterprise/admin/clustering/replacing-a-cluster-node - /enterprise/admin/enterprise-management/replacing-a-cluster-node - - /enterprise/admin/enterprise-management/replacing-a-cluster-node - - /enterprise/admin/enterprise-management/replacing-a-cluster-node versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/enterprise-management/setting-up-external-monitoring.md b/translations/ru-RU/content/admin/enterprise-management/setting-up-external-monitoring.md index 244f8fa247c6..f0163ff946e8 100644 --- a/translations/ru-RU/content/admin/enterprise-management/setting-up-external-monitoring.md +++ b/translations/ru-RU/content/admin/enterprise-management/setting-up-external-monitoring.md @@ -4,8 +4,6 @@ intro: 'You can monitor basic system resources on your {% data variables.product redirect_from: - /enterprise/admin/installation/setting-up-external-monitoring - /enterprise/admin/enterprise-management/setting-up-external-monitoring - - /enterprise/admin/enterprise-management/setting-up-external-monitoring - - /enterprise/admin/enterprise-management/setting-up-external-monitoring versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources.md b/translations/ru-RU/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources.md index 5167f275de74..3c590160d033 100644 --- a/translations/ru-RU/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources.md +++ b/translations/ru-RU/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources.md @@ -6,8 +6,6 @@ redirect_from: - '/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-physical-resources/' - /enterprise/admin/installation/updating-the-virtual-machine-and-physical-resources - /enterprise/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources - - /enterprise/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources - - /enterprise/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources mapTopic: true versions: enterprise-server: '*' diff --git a/translations/ru-RU/content/admin/enterprise-management/upgrading-a-cluster.md b/translations/ru-RU/content/admin/enterprise-management/upgrading-a-cluster.md index f76fe2552525..da1ab61fe9ef 100644 --- a/translations/ru-RU/content/admin/enterprise-management/upgrading-a-cluster.md +++ b/translations/ru-RU/content/admin/enterprise-management/upgrading-a-cluster.md @@ -4,7 +4,6 @@ intro: 'Use the administrative shell (SSH) to upgrade a {% data variables.produc redirect_from: - /enterprise/admin/clustering/upgrading-a-cluster - /enterprise/admin/enterprise-management/upgrading-a-cluster - - /enterprise/admin/enterprise-management/upgrading-a-cluster versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/enterprise-support/about-support-for-advanced-security.md b/translations/ru-RU/content/admin/enterprise-support/about-support-for-advanced-security.md index d49833150439..a8d197c64847 100644 --- a/translations/ru-RU/content/admin/enterprise-support/about-support-for-advanced-security.md +++ b/translations/ru-RU/content/admin/enterprise-support/about-support-for-advanced-security.md @@ -70,8 +70,8 @@ When you contact {% data variables.contact.enterprise_support %} for help with { {% data reusables.support.github-can-modify-ticket-priority %} -| Priority | Description | -|:------------------------------------------------------------------:| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Priority | Description | +|:-------------------------------------------------------------:| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | {% data variables.product.support_ticket_priority_high %} | {% data variables.product.prodname_advanced_security %} is not functioning or is stopped or severely impacted such that the end user cannot reasonably continue use of the software and no workaround is available. | | {% data variables.product.support_ticket_priority_normal %} | {% data variables.product.prodname_advanced_security %} is functioning inconsistently, causing impaired end user usage and productivity. | | {% data variables.product.support_ticket_priority_low %} | {% data variables.product.prodname_advanced_security %} is functioning consistently, but the end user requests minor changes in the software, such as documentation updates, cosmetic defects, or enhancements. | diff --git a/translations/ru-RU/content/admin/enterprise-support/index.md b/translations/ru-RU/content/admin/enterprise-support/index.md index bc3ae27966bd..a66aab840af2 100644 --- a/translations/ru-RU/content/admin/enterprise-support/index.md +++ b/translations/ru-RU/content/admin/enterprise-support/index.md @@ -3,8 +3,6 @@ title: 'Working with {% data variables.contact.github_support %}' intro: 'Learn how to open a ticket and provide the {% data variables.contact.enterprise_support %} team with the information they need to resolve your issues.' redirect_from: - /enterprise/admin/enterprise-support - - /enterprise/admin/enterprise-support - - /enterprise/admin/enterprise-support versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/enterprise-support/preparing-to-submit-a-ticket.md b/translations/ru-RU/content/admin/enterprise-support/preparing-to-submit-a-ticket.md index 56934806b1ca..6edfaf7b3325 100644 --- a/translations/ru-RU/content/admin/enterprise-support/preparing-to-submit-a-ticket.md +++ b/translations/ru-RU/content/admin/enterprise-support/preparing-to-submit-a-ticket.md @@ -3,8 +3,6 @@ title: Preparing to submit a ticket intro: 'Help {% data variables.contact.github_support %} help you faster by following these suggestions before you open a support ticket.' redirect_from: - /enterprise/admin/enterprise-support/preparing-to-submit-a-ticket - - /enterprise/admin/enterprise-support/preparing-to-submit-a-ticket - - /enterprise/admin/enterprise-support/preparing-to-submit-a-ticket versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/enterprise-support/reaching-github-support.md b/translations/ru-RU/content/admin/enterprise-support/reaching-github-support.md index e8817f00c89d..94554eb982a1 100644 --- a/translations/ru-RU/content/admin/enterprise-support/reaching-github-support.md +++ b/translations/ru-RU/content/admin/enterprise-support/reaching-github-support.md @@ -31,7 +31,7 @@ You can use the {% data variables.contact.enterprise_portal %} to view past supp For pricing, licensing, renewals, quotes, payments, and other related questions, contact {% data variables.contact.contact_enterprise_sales %} or call [+1 (877) 448-4820](tel:+1-877-448-4820). -### Обращение к тренингу +### Связаться с отделом обучения To learn more about training options, including customized trainings, see [{% data variables.product.company_short %}'s training site](https://services.github.com/). diff --git a/translations/ru-RU/content/admin/enterprise-support/receiving-help-from-github-support.md b/translations/ru-RU/content/admin/enterprise-support/receiving-help-from-github-support.md index e24c1e7d6c90..37b9633376ad 100644 --- a/translations/ru-RU/content/admin/enterprise-support/receiving-help-from-github-support.md +++ b/translations/ru-RU/content/admin/enterprise-support/receiving-help-from-github-support.md @@ -4,8 +4,6 @@ intro: 'If you run into trouble with {% data variables.product.product_location_ redirect_from: - /enterprise/admin/guides/enterprise-support/receiving-help-from-github-enterprise-support/ - /enterprise/admin/enterprise-support/receiving-help-from-github-support - - /enterprise/admin/enterprise-support/receiving-help-from-github-support - - /enterprise/admin/enterprise-support/receiving-help-from-github-support mapTopic: true versions: enterprise-server: '*' diff --git a/translations/ru-RU/content/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server.md b/translations/ru-RU/content/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server.md index 1fc476f751c5..5c89f88a10d3 100644 --- a/translations/ru-RU/content/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server.md +++ b/translations/ru-RU/content/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server.md @@ -3,10 +3,6 @@ title: About using GitHub.com actions on GitHub Enterprise Server intro: '{% data variables.product.prodname_ghe_server %} includes most {% data variables.product.prodname_dotcom %}-authored actions, and has options for enabling access to other actions from {% data variables.product.prodname_dotcom_the_website %} and {% data variables.product.prodname_marketplace %}.' redirect_from: - /enterprise/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server - - /enterprise/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server - - /enterprise/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server - - /enterprise/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server - - /enterprise/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server versions: enterprise-server: '>=2.22' --- diff --git a/translations/ru-RU/content/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect.md b/translations/ru-RU/content/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect.md index 13b992011b5a..49aaf93e9bf5 100644 --- a/translations/ru-RU/content/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect.md +++ b/translations/ru-RU/content/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect.md @@ -4,7 +4,6 @@ intro: 'To allow {% data variables.product.prodname_actions %} on your enterpris permissions: 'Site administrators for {% data variables.product.prodname_ghe_server %} who are also owners of the connected {% data variables.product.prodname_ghe_cloud %} organization or enterprise account can enable access to all {% data variables.product.prodname_dotcom_the_website %} actions.' redirect_from: - /enterprise/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect - - /enterprise/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect versions: enterprise-server: '>=2.22' --- diff --git a/translations/ru-RU/content/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise.md b/translations/ru-RU/content/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise.md index 8e4886b8b6be..0ad89a74ace7 100644 --- a/translations/ru-RU/content/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise.md +++ b/translations/ru-RU/content/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise.md @@ -3,9 +3,6 @@ title: Enforcing GitHub Actions policies for your enterprise intro: 'Enterprise administrators can manage access to {% data variables.product.prodname_actions %} in an enterprise.' redirect_from: - /enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise - - /enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise - - /enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise - - /enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise versions: enterprise-server: '>=2.22' --- diff --git a/translations/ru-RU/content/admin/github-actions/index.md b/translations/ru-RU/content/admin/github-actions/index.md index e7582b2066f5..2202fdb4d4ce 100644 --- a/translations/ru-RU/content/admin/github-actions/index.md +++ b/translations/ru-RU/content/admin/github-actions/index.md @@ -3,8 +3,6 @@ title: Managing GitHub Actions for your enterprise intro: 'Enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %}, and manage {% data variables.product.prodname_actions %} policies and settings.' redirect_from: - /enterprise/admin/github-actions - - /enterprise/admin/github-actions - - /enterprise/admin/github-actions versions: enterprise-server: '>=2.22' --- diff --git a/translations/ru-RU/content/admin/github-actions/managing-access-to-actions-from-githubcom.md b/translations/ru-RU/content/admin/github-actions/managing-access-to-actions-from-githubcom.md index 0656913a6ddc..51d601c89f2e 100644 --- a/translations/ru-RU/content/admin/github-actions/managing-access-to-actions-from-githubcom.md +++ b/translations/ru-RU/content/admin/github-actions/managing-access-to-actions-from-githubcom.md @@ -4,10 +4,6 @@ intro: 'Controlling which actions on {% data variables.product.prodname_dotcom_t mapTopic: true redirect_from: - /enterprise/admin/github-actions/managing-access-to-actions-from-githubcom - - /enterprise/admin/github-actions/managing-access-to-actions-from-githubcom - - /enterprise/admin/github-actions/managing-access-to-actions-from-githubcom - - /enterprise/admin/github-actions/managing-access-to-actions-from-githubcom - - /enterprise/admin/github-actions/managing-access-to-actions-from-githubcom versions: enterprise-server: '>=2.22' --- diff --git a/translations/ru-RU/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md b/translations/ru-RU/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md index 24eebbf116f0..6c34701515a2 100644 --- a/translations/ru-RU/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md +++ b/translations/ru-RU/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md @@ -69,7 +69,7 @@ You can populate the runner tool cache by running a {% data variables.product.pr path: ${{runner.tool_cache}}/tool_cache.tar.gz ``` {% endraw %} -1. Download the tool cache artifact from the workflow run. For instructions on downloading artifacts, see "[Persisting workflow data using artifacts](/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts#downloading-and-deleting-artifacts-after-a-workflow-run-is-complete)." +1. Download the tool cache artifact from the workflow run. For instructions on downloading artifacts, see "[Downloading workflow artifacts](/actions/managing-workflow-runs/downloading-workflow-artifacts)." 1. Transfer the tool cache artifact to your self hosted runner and extract it to the local tool cache directory. The default tool cache directory is `RUNNER_DIR/_work/_tool`. If the runner hasn't processed any jobs yet, you might need to create the `_work/_tool` directories. After extracting the tool cache artifact uploaded in the above example, you should have a directory structure on your self-hosted runner that is similar to the following example: diff --git a/translations/ru-RU/content/admin/index.md b/translations/ru-RU/content/admin/index.md index 8ae445a16a42..dfbcb7a9914d 100644 --- a/translations/ru-RU/content/admin/index.md +++ b/translations/ru-RU/content/admin/index.md @@ -3,8 +3,6 @@ title: Enterprise Administrators redirect_from: - /enterprise/admin/hidden/migrating-from-github-fi/ - /enterprise/admin - - /enterprise/admin - - /enterprise/admin intro: 'Step-by-step guides for organizational administrators, system administrators, and security specialists who are deploying, configuring, and managing a GitHub Enterprise instance.' versions: enterprise-server: '*' diff --git a/translations/ru-RU/content/admin/installation/index.md b/translations/ru-RU/content/admin/installation/index.md index f4defd49421b..ca489927cc7f 100644 --- a/translations/ru-RU/content/admin/installation/index.md +++ b/translations/ru-RU/content/admin/installation/index.md @@ -9,8 +9,6 @@ redirect_from: - /enterprise/admin/categories/general/ - /enterprise/admin/categories/logging-and-monitoring/ - /enterprise/admin/installation - - /enterprise/admin/installation - - /enterprise/admin/installation versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md b/translations/ru-RU/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md index a28f3cb51361..2a23da1a6996 100644 --- a/translations/ru-RU/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md +++ b/translations/ru-RU/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md @@ -24,7 +24,8 @@ Before launching {% data variables.product.product_location_enterprise %} on Goo #### Supported machine types -{% data variables.product.prodname_ghe_server %} is supported on the following Google Compute Engine (GCE) machine types. For more information, see [the Google Cloud Platform machine types article](https://cloud.google.com/compute/docs/machine-types). | +{% data variables.product.prodname_ghe_server %} is supported on the following Google Compute Engine (GCE) machine types. For more information, see [the Google Cloud Platform machine types article](https://cloud.google.com/compute/docs/machine-types). +| {% if currentVersion != "free-pro-team@latest" %} | | High-memory | | | ------------- | diff --git a/translations/ru-RU/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md b/translations/ru-RU/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md index 5b68e489c236..f96ede6d20e5 100644 --- a/translations/ru-RU/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md +++ b/translations/ru-RU/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md @@ -29,7 +29,9 @@ versions: {% data reusables.enterprise_installation.create-ghe-instance %} -1. In OpenStack Horizon, upload the {% data variables.product.prodname_ghe_server %} image you downloaded. For instructions, see the "Upload an image" section of the OpenStack guide "[Upload and manage images](https://docs.openstack.org/horizon/latest/user/manage-images.html)." +1. In OpenStack Horizon, upload the + +{% data variables.product.prodname_ghe_server %} image you downloaded. For instructions, see the "Upload an image" section of the OpenStack guide "[Upload and manage images](https://docs.openstack.org/horizon/latest/user/manage-images.html)." {% data reusables.enterprise_installation.create-attached-storage-volume %} For instructions, see the OpenStack guide "[Create and manage volumes](https://docs.openstack.org/horizon/latest/user/manage-volumes.html)." 3. Create a security group, and add a new security group rule for each port in the table below. For instructions, see the OpenStack guide "[Configure access and security for instances](https://docs.openstack.org/horizon/latest/user/configure-access-and-security-for-instances.html)." diff --git a/translations/ru-RU/content/admin/installation/setting-up-a-github-enterprise-server-instance.md b/translations/ru-RU/content/admin/installation/setting-up-a-github-enterprise-server-instance.md index b40eb96bd510..92a5f510c953 100644 --- a/translations/ru-RU/content/admin/installation/setting-up-a-github-enterprise-server-instance.md +++ b/translations/ru-RU/content/admin/installation/setting-up-a-github-enterprise-server-instance.md @@ -7,8 +7,6 @@ redirect_from: - /enterprise/admin/guides/installation/provisioning-and-installation/ - /enterprise/admin/guides/installation/setting-up-a-github-enterprise-instance/ - /enterprise/admin/installation/setting-up-a-github-enterprise-server-instance - - /enterprise/admin/installation/setting-up-a-github-enterprise-server-instance - - /enterprise/admin/installation/setting-up-a-github-enterprise-server-instance mapTopic: true versions: enterprise-server: '*' diff --git a/translations/ru-RU/content/admin/installation/setting-up-a-staging-instance.md b/translations/ru-RU/content/admin/installation/setting-up-a-staging-instance.md index faea92831858..5c175f584c84 100644 --- a/translations/ru-RU/content/admin/installation/setting-up-a-staging-instance.md +++ b/translations/ru-RU/content/admin/installation/setting-up-a-staging-instance.md @@ -3,7 +3,6 @@ title: Setting up a staging instance intro: 'You can use a *staging instance* to test modifications before they are applied to {% data variables.product.product_location_enterprise %}. For example, you could use a staging instance to test new {% data variables.product.prodname_ghe_server %} updates or to practice importing migration data.' redirect_from: - /enterprise/admin/installation/setting-up-a-staging-instance - - /enterprise/admin/installation/setting-up-a-staging-instance versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/overview/about-enterprise-accounts.md b/translations/ru-RU/content/admin/overview/about-enterprise-accounts.md index 75bfd240ff41..3d1804f81f01 100644 --- a/translations/ru-RU/content/admin/overview/about-enterprise-accounts.md +++ b/translations/ru-RU/content/admin/overview/about-enterprise-accounts.md @@ -4,8 +4,6 @@ intro: 'With {% data variables.product.prodname_ghe_server %}, you can create an redirect_from: - /enterprise/admin/installation/about-enterprise-accounts - /enterprise/admin/overview/about-enterprise-accounts - - /enterprise/admin/overview/about-enterprise-accounts - - /enterprise/admin/overview/about-enterprise-accounts versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/overview/about-the-github-enterprise-server-api.md b/translations/ru-RU/content/admin/overview/about-the-github-enterprise-server-api.md index 80035bc5cc24..fc6293a2b034 100644 --- a/translations/ru-RU/content/admin/overview/about-the-github-enterprise-server-api.md +++ b/translations/ru-RU/content/admin/overview/about-the-github-enterprise-server-api.md @@ -7,8 +7,6 @@ redirect_from: - /enterprise/admin/articles/using-the-api/ - /enterprise/admin/categories/api/ - /enterprise/admin/overview/about-the-github-enterprise-server-api - - /enterprise/admin/overview/about-the-github-enterprise-server-api - - /enterprise/admin/overview/about-the-github-enterprise-server-api versions: enterprise-server: '*' --- @@ -17,5 +15,5 @@ For the complete documentation for {% data variables.product.prodname_enterprise - Perform changes to the {% data variables.enterprise.management_console %}. For more information, see "[{% data variables.enterprise.management_console %}](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#management-console)." - Collect statistics about your instance. For more information, see "[Admin stats](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#admin-stats)." -- Configure LDAP sync. For more information, see "[LDAP](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#ldap)."{% if currentVersion ver_gt "enterprise-server@2.18" %} -- Manage your enterprise account. For more information, see "[Enterprise accounts](/v4/guides/managing-enterprise-accounts)."{% endif %} +- Configure LDAP sync. For more information, see "[LDAP](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#ldap)." +- Manage your enterprise account. For more information, see "[Enterprise accounts](/v4/guides/managing-enterprise-accounts)." diff --git a/translations/ru-RU/content/admin/overview/managing-billing-for-github-enterprise.md b/translations/ru-RU/content/admin/overview/managing-billing-for-github-enterprise.md index a6c233349812..501dc2ac3f2f 100644 --- a/translations/ru-RU/content/admin/overview/managing-billing-for-github-enterprise.md +++ b/translations/ru-RU/content/admin/overview/managing-billing-for-github-enterprise.md @@ -5,7 +5,6 @@ product: '{% data reusables.gated-features.enterprise-accounts %}' redirect_from: - /enterprise/admin/installation/managing-billing-for-github-enterprise - /enterprise/admin/overview/managing-billing-for-github-enterprise - - /enterprise/admin/overview/managing-billing-for-github-enterprise versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/overview/managing-your-github-enterprise-license.md b/translations/ru-RU/content/admin/overview/managing-your-github-enterprise-license.md index 2a8313cb37f5..a35377b399b2 100644 --- a/translations/ru-RU/content/admin/overview/managing-your-github-enterprise-license.md +++ b/translations/ru-RU/content/admin/overview/managing-your-github-enterprise-license.md @@ -12,7 +12,6 @@ redirect_from: - /enterprise/admin/installation/updating-your-license/ - /enterprise/admin/installation/managing-your-github-enterprise-server-license - /enterprise/admin/overview/managing-your-github-enterprise-license - - /enterprise/admin/overview/managing-your-github-enterprise-license versions: enterprise-server: '*' --- @@ -35,7 +34,8 @@ If you'd like to renew or add user licenses to {% data variables.product.prodnam {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.enterprise-licensing-tab %} 4. Under "Enterprise Server Instances", click {% octicon "download" aria-label="The download icon" %} to download your license file. ![Download GitHub Enterprise Server license](/assets/images/help/business-accounts/download-ghes-license.png) -5. Log into your {% data variables.product.prodname_ghe_server %} instance as a site administrator. +5. Log into your +{% data variables.product.prodname_ghe_server %} instance as a site administrator. {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.settings-tab %} @@ -64,7 +64,8 @@ You can download a JSON file from {% data variables.product.prodname_ghe_server {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.license-tab %} 5. Under "Quick links", to download a file containing your current license usage on {% data variables.product.prodname_ghe_server %}, click **Export license usage**. ![Export license usage link](/assets/images/enterprise/business-accounts/export-license-usage-link.png) -6. Navigate to {% data variables.product.prodname_ghe_cloud %}. +6. Navigate to +{% data variables.product.prodname_ghe_cloud %}. {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.enterprise-licensing-tab %} diff --git a/translations/ru-RU/content/admin/packages/configuring-packages-support-for-your-enterprise.md b/translations/ru-RU/content/admin/packages/configuring-packages-support-for-your-enterprise.md index 5f29f59bc948..027addf08824 100644 --- a/translations/ru-RU/content/admin/packages/configuring-packages-support-for-your-enterprise.md +++ b/translations/ru-RU/content/admin/packages/configuring-packages-support-for-your-enterprise.md @@ -3,9 +3,6 @@ title: Configuring packages support for your enterprise intro: 'You can configure {% data variables.product.prodname_registry %} for your enterprise by enabling or disabling each package ecosystem.' redirect_from: - /enterprise/admin/packages/configuring-packages-support-for-your-enterprise - - /enterprise/admin/packages/configuring-packages-support-for-your-enterprise - - /enterprise/admin/packages/configuring-packages-support-for-your-enterprise - - /enterprise/admin/packages/configuring-packages-support-for-your-enterprise versions: enterprise-server: '>=2.22' --- diff --git a/translations/ru-RU/content/admin/packages/configuring-third-party-storage-for-packages.md b/translations/ru-RU/content/admin/packages/configuring-third-party-storage-for-packages.md index d7a606c8f418..f3dfd6acb5b1 100644 --- a/translations/ru-RU/content/admin/packages/configuring-third-party-storage-for-packages.md +++ b/translations/ru-RU/content/admin/packages/configuring-third-party-storage-for-packages.md @@ -3,9 +3,6 @@ title: Configuring third-party storage for packages intro: 'You can configure the third-party service that {% data variables.product.prodname_registry %} uses to store your enterprise''s packages.' redirect_from: - /enterprise/admin/packages/configuring-third-party-storage-for-packages - - /enterprise/admin/packages/configuring-third-party-storage-for-packages - - /enterprise/admin/packages/configuring-third-party-storage-for-packages - - /enterprise/admin/packages/configuring-third-party-storage-for-packages versions: enterprise-server: '>=2.22' --- diff --git a/translations/ru-RU/content/admin/packages/enabling-github-packages-for-your-enterprise.md b/translations/ru-RU/content/admin/packages/enabling-github-packages-for-your-enterprise.md index 90b95942bd2f..55856d7cb0a0 100644 --- a/translations/ru-RU/content/admin/packages/enabling-github-packages-for-your-enterprise.md +++ b/translations/ru-RU/content/admin/packages/enabling-github-packages-for-your-enterprise.md @@ -3,11 +3,6 @@ title: Enabling GitHub Packages for your enterprise intro: 'You can start using {% data variables.product.prodname_registry %} on your instance by enabling the feature, configuring third-party storage, configuring the ecosystems you want to support, and updating your TLS certificate.' redirect_from: - /enterprise/admin/packages/enabling-github-packages-for-your-enterprise - - /enterprise/admin/packages/enabling-github-packages-for-your-enterprise - - /enterprise/admin/packages/enabling-github-packages-for-your-enterprise - - /enterprise/admin/packages/enabling-github-packages-for-your-enterprise - - /enterprise/admin/packages/enabling-github-packages-for-your-enterprise - - /enterprise/admin/packages/enabling-github-packages-for-your-enterprise versions: enterprise-server: '>=2.22' --- diff --git a/translations/ru-RU/content/admin/packages/index.md b/translations/ru-RU/content/admin/packages/index.md index 1098b8151f81..d677721898a2 100644 --- a/translations/ru-RU/content/admin/packages/index.md +++ b/translations/ru-RU/content/admin/packages/index.md @@ -4,9 +4,6 @@ shortTitle: GitHub Packages intro: 'You can enable {% data variables.product.prodname_registry %} for your enterprise and manage {% data variables.product.prodname_registry %} settings and allowed packaged types.' redirect_from: - /enterprise/admin/packages - - /enterprise/admin/packages - - /enterprise/admin/packages - - /enterprise/admin/packages versions: enterprise-server: '>=2.22' --- diff --git a/translations/ru-RU/content/admin/policies/about-pre-receive-hooks.md b/translations/ru-RU/content/admin/policies/about-pre-receive-hooks.md index 63ad7eded16c..d8087d8b9f14 100644 --- a/translations/ru-RU/content/admin/policies/about-pre-receive-hooks.md +++ b/translations/ru-RU/content/admin/policies/about-pre-receive-hooks.md @@ -4,8 +4,6 @@ intro: '*Pre-receive hooks* are scripts that run on the {% data variables.produc redirect_from: - /enterprise/admin/developer-workflow/about-pre-receive-hooks - /enterprise/admin/policies/about-pre-receive-hooks - - /enterprise/admin/policies/about-pre-receive-hooks - - /enterprise/admin/policies/about-pre-receive-hooks versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/policies/creating-a-pre-receive-hook-script.md b/translations/ru-RU/content/admin/policies/creating-a-pre-receive-hook-script.md index dec8cbec3079..fd8d06365127 100644 --- a/translations/ru-RU/content/admin/policies/creating-a-pre-receive-hook-script.md +++ b/translations/ru-RU/content/admin/policies/creating-a-pre-receive-hook-script.md @@ -182,7 +182,7 @@ You can test a pre-receive hook script locally before you create or update it on $ git clone git@github.com:octocat/Hello-World.git $ cd Hello-World $ git remote add test git@127.0.0.1:test.git - $ GIT_SSH_COMMAND="ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no -p 52311 -i ../id_rsa" git push -u test master + $ GIT_SSH_COMMAND="ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no -p 52311 -i ../id_rsa" git push -u test main > Warning: Permanently added '[192.168.99.100]:52311' (ECDSA) to the list of known hosts. > Counting objects: 7, done. > Delta compression using up to 4 threads. @@ -191,7 +191,7 @@ You can test a pre-receive hook script locally before you create or update it on > Total 7 (delta 0), reused 7 (delta 0) > remote: error: rejecting all pushes > To git@192.168.99.100:test.git - > ! [remote rejected] master -> master (pre-receive hook declined) + > ! [remote rejected] main -> main (pre-receive hook declined) > error: failed to push some refs to 'git@192.168.99.100:test.git' ``` diff --git a/translations/ru-RU/content/admin/policies/enforcing-policies-for-your-enterprise.md b/translations/ru-RU/content/admin/policies/enforcing-policies-for-your-enterprise.md index 1cd05e5f0de8..6d8a1b6daf81 100644 --- a/translations/ru-RU/content/admin/policies/enforcing-policies-for-your-enterprise.md +++ b/translations/ru-RU/content/admin/policies/enforcing-policies-for-your-enterprise.md @@ -3,10 +3,6 @@ title: Enforcing policies for your enterprise mapTopic: true redirect_from: - /enterprise/admin/policies/enforcing-policies-for-your-enterprise - - /enterprise/admin/policies/enforcing-policies-for-your-enterprise - - /enterprise/admin/policies/enforcing-policies-for-your-enterprise - - /enterprise/admin/policies/enforcing-policies-for-your-enterprise - - /enterprise/admin/policies/enforcing-policies-for-your-enterprise versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/policies/enforcing-policy-with-pre-receive-hooks.md b/translations/ru-RU/content/admin/policies/enforcing-policy-with-pre-receive-hooks.md index 518aa0490326..49c8daec918b 100644 --- a/translations/ru-RU/content/admin/policies/enforcing-policy-with-pre-receive-hooks.md +++ b/translations/ru-RU/content/admin/policies/enforcing-policy-with-pre-receive-hooks.md @@ -5,8 +5,6 @@ mapTopic: true redirect_from: - /enterprise/admin/developer-workflow/using-pre-receive-hooks-to-enforce-policy - /enterprise/admin/policies/enforcing-policy-with-pre-receive-hooks - - /enterprise/admin/policies/enforcing-policy-with-pre-receive-hooks - - /enterprise/admin/policies/enforcing-policy-with-pre-receive-hooks versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md b/translations/ru-RU/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md index b093c631a5f7..221f3cbb62d3 100644 --- a/translations/ru-RU/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md +++ b/translations/ru-RU/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md @@ -25,7 +25,6 @@ redirect_from: - /enterprise/admin/articles/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization/ - /enterprise/admin/developer-workflow/blocking-force-pushes - /enterprise/admin/policies/enforcing-repository-management-policies-in-your-enterprise - - /enterprise/admin/policies/enforcing-repository-management-policies-in-your-enterprise versions: enterprise-server: '*' --- @@ -40,7 +39,7 @@ If a site administrator disallows members from creating certain types of reposit **Tip:** You can restrict the ability to change repository visibility to site administrators only. For more information, see "[Preventing users from changing a repository's visibility](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-a-repository-s-visibility)." -{% endnote %} +{% endtip %} {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} @@ -217,4 +216,3 @@ If necessary, you can prevent repository administrators from changing anonymous 7. Review the changes. To confirm, click **Yes, enable anonymous Git read access.** ![Confirm anonymous Git read access setting in pop-up window](/assets/images/enterprise/site-admin-settings/confirm-anonymous-git-read-access-for-specific-repo-as-site-admin.png) 8. Optionally, to prevent repository admins from changing this setting for this repository, select **Prevent repository admins from changing anonymous Git read access**. ![Select checkbox to prevent repository admins from changing anonymous Git read access for this repository](/assets/images/enterprise/site-admin-settings/lock_anonymous_git_access_for_specific_repo.png) - diff --git a/translations/ru-RU/content/admin/policies/index.md b/translations/ru-RU/content/admin/policies/index.md index 09b7a142bb35..6dc11872c9b3 100644 --- a/translations/ru-RU/content/admin/policies/index.md +++ b/translations/ru-RU/content/admin/policies/index.md @@ -4,8 +4,6 @@ intro: 'You can set policies in {% data variables.product.prodname_enterprise %} redirect_from: - /enterprise/admin/developer-workflow - /enterprise/admin/policies - - /enterprise/admin/policies - - /enterprise/admin/policies versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/policies/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance.md b/translations/ru-RU/content/admin/policies/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance.md index 31490477bf98..987994c6ba29 100644 --- a/translations/ru-RU/content/admin/policies/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance.md +++ b/translations/ru-RU/content/admin/policies/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance.md @@ -5,7 +5,6 @@ redirect_from: - /enterprise/admin/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance - /enterprise/admin/guides/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-appliance/ - /enterprise/admin/policies/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance - - /enterprise/admin/policies/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/user-management/activity-dashboard.md b/translations/ru-RU/content/admin/user-management/activity-dashboard.md index 9e0be8f24f0b..21a190661f29 100644 --- a/translations/ru-RU/content/admin/user-management/activity-dashboard.md +++ b/translations/ru-RU/content/admin/user-management/activity-dashboard.md @@ -5,7 +5,6 @@ redirect_from: - /enterprise/admin/articles/activity-dashboard/ - /enterprise/admin/installation/activity-dashboard - /enterprise/admin/user-management/activity-dashboard - - /enterprise/admin/user-management/activity-dashboard versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/user-management/adding-people-to-teams.md b/translations/ru-RU/content/admin/user-management/adding-people-to-teams.md index 2280059d8eb7..0f174951a8b2 100644 --- a/translations/ru-RU/content/admin/user-management/adding-people-to-teams.md +++ b/translations/ru-RU/content/admin/user-management/adding-people-to-teams.md @@ -5,8 +5,6 @@ redirect_from: - /enterprise/admin/articles/adding-or-inviting-people-to-teams/ - /enterprise/admin/guides/user-management/adding-or-inviting-people-to-teams/ - /enterprise/admin/user-management/adding-people-to-teams - - /enterprise/admin/user-management/adding-people-to-teams - - /enterprise/admin/user-management/adding-people-to-teams intro: 'Once a team has been created, organization admins can add users from {% data variables.product.product_location_enterprise %} to the team and determine which repositories they have access to.' versions: enterprise-server: '*' diff --git a/translations/ru-RU/content/admin/user-management/audit-logging.md b/translations/ru-RU/content/admin/user-management/audit-logging.md index 75d9b6a0afd3..c0fe5edd05f8 100644 --- a/translations/ru-RU/content/admin/user-management/audit-logging.md +++ b/translations/ru-RU/content/admin/user-management/audit-logging.md @@ -5,8 +5,6 @@ redirect_from: - /enterprise/admin/articles/audit-logging/ - /enterprise/admin/installation/audit-logging - /enterprise/admin/user-management/audit-logging - - /enterprise/admin/user-management/audit-logging - - /enterprise/admin/user-management/audit-logging versions: enterprise-server: '*' --- @@ -36,5 +34,5 @@ Oct 26 01:42:08 github-ent github_audit: {:created_at=>1351215728326, :actor_ip= This example shows that commits were pushed to a repository. ``` -Oct 26 02:19:31 github-ent github_audit: { "pid":22860, "ppid":22859, "program":"receive-pack", "git_dir":"/data/repositories/some-user/some-repository.git", "hostname":"github-ent", "pusher":"some-user", "real_ip":"10.0.0.51", "user_agent":"git/1.7.10.4", "repo_id":1, "repo_name":"some-user/some-repository", "transaction_id":"b031b7dc7043c87323a75f7a92092ef1456e5fbaef995c68", "frontend_ppid":1, "repo_public":true, "user_name":"some-user", "user_login":"some-user", "frontend_pid":18238, "frontend":"github-ent", "user_email":"some-user@github.example.com", "user_id":2, "pgroup":"github-ent_22860", "status":"post_receive_hook", "features":" report-status side-band-64k", "received_objects":3, "receive_pack_size":243, "non_fast_forward":false, "current_ref":"refs/heads/master" } +Oct 26 02:19:31 github-ent github_audit: { "pid":22860, "ppid":22859, "program":"receive-pack", "git_dir":"/data/repositories/some-user/some-repository.git", "hostname":"github-ent", "pusher":"some-user", "real_ip":"10.0.0.51", "user_agent":"git/1.7.10.4", "repo_id":1, "repo_name":"some-user/some-repository", "transaction_id":"b031b7dc7043c87323a75f7a92092ef1456e5fbaef995c68", "frontend_ppid":1, "repo_public":true, "user_name":"some-user", "user_login":"some-user", "frontend_pid":18238, "frontend":"github-ent", "user_email":"some-user@github.example.com", "user_id":2, "pgroup":"github-ent_22860", "status":"post_receive_hook", "features":" report-status side-band-64k", "received_objects":3, "receive_pack_size":243, "non_fast_forward":false, "current_ref":"refs/heads/main" } ``` diff --git a/translations/ru-RU/content/admin/user-management/audited-actions.md b/translations/ru-RU/content/admin/user-management/audited-actions.md index d4a8a4f3a08b..b260c73b0222 100644 --- a/translations/ru-RU/content/admin/user-management/audited-actions.md +++ b/translations/ru-RU/content/admin/user-management/audited-actions.md @@ -35,8 +35,8 @@ versions: #### Instance configuration settings -| Name | Description | -| -------------------------------------------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Name | Description | +| -------------------------------------------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `business.update_member_repository_creation_permission` | A site admin restricts repository creation in organizations on the instance. For more information, see "[Restricting repository creation in your instance](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)." | | `business.clear_members_can_create_repos` | A site admin clears a restriction on repository creation in organizations on the instance. For more information, see "[Restricting repository creation in your instance](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)." | | `enterprise.config.lock_anonymous_git_access` | A site admin locks anonymous Git read access to prevent repository admins from changing existing anonymous Git read access settings for repositories on the instance. For more information, see "[Preventing users from changing anonymous Git read access](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)." | @@ -44,19 +44,19 @@ versions: #### Issues and pull requests -| Name | Description | -| ------------------------------------:| ---------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `issue.update` | An issue's body text (initial comment) changed. | -| `issue_comment.update` | A comment on an issue (other than the initial one) changed. | -| `pull_request_review_comment.delete` | A comment on a pull request was deleted. | +| Name | Description | +| ------------------------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `issue.update` | An issue's body text (initial comment) changed. | +| `issue_comment.update` | A comment on an issue (other than the initial one) changed. | +| `pull_request_review_comment.delete` | A comment on a pull request was deleted. | | `issue.destroy` | An issue was deleted from the repository. For more information, see "[Deleting an issue](/enterprise/{{ currentVersion }}/user/articles/deleting-an-issue)." | #### Organizations -| Name | Description | -| ------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `org.async_delete` | A user initiated a background job to delete an organization. | -| `org.delete` | An organization was deleted by a user-initiated background job. | +| Name | Description | +| ------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `org.async_delete` | A user initiated a background job to delete an organization. | +| `org.delete` | An organization was deleted by a user-initiated background job. | | `org.transform` | A user account was converted into an organization. For more information, see [Converting a user into an organization](/enterprise/{{ currentVersion}}/user/articles/converting-a-user-into-an-organization/). | #### Protected branches @@ -76,18 +76,18 @@ versions: #### Repositories -| Name | Description | -| ------------------------------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `repo.access` | A private repository was made public, or a public repository was made private. | +| Name | Description | +| ------------------------------------------:| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `repo.access` | A private repository was made public, or a public repository was made private. | | `repo.archive` | A repository was archived. For more information, see [Archiving and unarchiving repositories](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/). | -| `repo.add_member` | A collaborator was added to a repository. | +| `repo.add_member` | A collaborator was added to a repository. | | `repo.config` | A site admin blocked force pushes. For more information, see [Blocking force pushes to a repository](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository/) to a repository. | -| `repo.create` | A repository was created. | -| `repo.destroy` | A repository was deleted. | -| `repo.remove_member` | A collaborator was removed from a repository. | -| `repo.rename` | A repository was renamed. | -| `repo.transfer` | A user accepted a request to receive a transferred repository. | -| `repo.transfer_start` | A user sent a request to transfer a repository to another user or organization. | +| `repo.create` | A repository was created. | +| `repo.destroy` | A repository was deleted. | +| `repo.remove_member` | A collaborator was removed from a repository. | +| `repo.rename` | A repository was renamed. | +| `repo.transfer` | A user accepted a request to receive a transferred repository. | +| `repo.transfer_start` | A user sent a request to transfer a repository to another user or organization. | | `repo.unarchive` | A repository was unarchived. For more information, see [Archiving and unarchiving repositories](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/). | | `repo.config.disable_anonymous_git_access` | Anonymous Git read access is disabled for a public repository. For more information, see "[Enabling anonymous Git read access for a repository](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)." | | `repo.config.enable_anonymous_git_access` | Anonymous Git read access is enabled for a public repository. For more information, see "[Enabling anonymous Git read access for a repository](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)." | @@ -100,7 +100,7 @@ versions: | --------------------:| ----------------------------------------------------------------------------------------------- | | `staff.disable_repo` | A site admin disabled access to a repository and all of its forks. | | `staff.enable_repo` | A site admin re-enabled access to a repository and all of its forks. | -| `staff.fake_login` | A site admin signed into {% data variables.product.prodname_enterprise %} as another user. | +| `staff.fake_login` | A site admin signed into {% data variables.product.prodname_enterprise %} as another user. | | `staff.repo_unlock` | A site admin unlocked (temporarily gained full access to) one of a user's private repositories. | | `staff.unlock` | A site admin unlocked (temporarily gained full access to) all of a user's private repositories. | diff --git a/translations/ru-RU/content/admin/user-management/auditing-ssh-keys.md b/translations/ru-RU/content/admin/user-management/auditing-ssh-keys.md index 9de1e4179e9e..4e11a2795aab 100644 --- a/translations/ru-RU/content/admin/user-management/auditing-ssh-keys.md +++ b/translations/ru-RU/content/admin/user-management/auditing-ssh-keys.md @@ -4,7 +4,6 @@ intro: Site administrators can initiate an instance-wide audit of SSH keys. redirect_from: - /enterprise/admin/articles/auditing-ssh-keys/ - /enterprise/admin/user-management/auditing-ssh-keys - - /enterprise/admin/user-management/auditing-ssh-keys versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/user-management/auditing-users-across-your-instance.md b/translations/ru-RU/content/admin/user-management/auditing-users-across-your-instance.md index 35287c98cb1b..ad603fc6deef 100644 --- a/translations/ru-RU/content/admin/user-management/auditing-users-across-your-instance.md +++ b/translations/ru-RU/content/admin/user-management/auditing-users-across-your-instance.md @@ -75,7 +75,7 @@ The `action` qualifier searches for specific events, grouped within categories. | Category name | Description | | ------------- | ------------------------------------------------------------------------------- | -| `хук` | Contains all activities related to webhooks. | +| `перехватчик` | Contains all activities related to webhooks. | | `org` | Contains all activities related organization membership | | `repo` | Contains all activities related to the repositories owned by your organization. | | `команда` | Contains all activities related to teams in your organization. | diff --git a/translations/ru-RU/content/admin/user-management/best-practices-for-user-security.md b/translations/ru-RU/content/admin/user-management/best-practices-for-user-security.md index 22c0d7cd1f11..f8f302a33586 100644 --- a/translations/ru-RU/content/admin/user-management/best-practices-for-user-security.md +++ b/translations/ru-RU/content/admin/user-management/best-practices-for-user-security.md @@ -3,8 +3,6 @@ title: Best practices for user security intro: 'Outside of instance-level security measures (SSL, subdomain isolation, configuring a firewall) that a site administrator can implement, there are steps your users can take to help protect {% data variables.product.product_location_enterprise %}.' redirect_from: - /enterprise/admin/user-management/best-practices-for-user-security - - /enterprise/admin/user-management/best-practices-for-user-security - - /enterprise/admin/user-management/best-practices-for-user-security versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/user-management/configuring-email-for-notifications.md b/translations/ru-RU/content/admin/user-management/configuring-email-for-notifications.md index b38d616667f7..aa26c2c825d6 100644 --- a/translations/ru-RU/content/admin/user-management/configuring-email-for-notifications.md +++ b/translations/ru-RU/content/admin/user-management/configuring-email-for-notifications.md @@ -6,7 +6,6 @@ redirect_from: - /enterprise/admin/articles/troubleshooting-email/ - /enterprise/admin/articles/email-configuration-and-troubleshooting/ - /enterprise/admin/user-management/configuring-email-for-notifications - - /enterprise/admin/user-management/configuring-email-for-notifications intro: 'To make it easy for users to respond quickly to activity on {% data variables.product.prodname_ghe_server %}, you can configure your instance to send email notifications on issue, pull request, and commit comments, as well as additional settings to allow inbound email replies. Notification emails are sent if there is activity on a repository a user is watching, if there is activity in a pull request or issue they are participating in, or if the user or team they''re a member of are @mentioned in a comment.' versions: enterprise-server: '*' diff --git a/translations/ru-RU/content/admin/user-management/configuring-visibility-for-organization-membership.md b/translations/ru-RU/content/admin/user-management/configuring-visibility-for-organization-membership.md index 681950175cb1..f07425887776 100644 --- a/translations/ru-RU/content/admin/user-management/configuring-visibility-for-organization-membership.md +++ b/translations/ru-RU/content/admin/user-management/configuring-visibility-for-organization-membership.md @@ -3,7 +3,6 @@ title: Configuring visibility for organization membership intro: You can set visibility for new organization members across your instance to public or private. You can also prevent members from changing their visibility from the default. redirect_from: - /enterprise/admin/user-management/configuring-visibility-for-organization-membership - - /enterprise/admin/user-management/configuring-visibility-for-organization-membership versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/user-management/creating-organizations.md b/translations/ru-RU/content/admin/user-management/creating-organizations.md index fdcc2f1528a3..15b330e8f7a7 100644 --- a/translations/ru-RU/content/admin/user-management/creating-organizations.md +++ b/translations/ru-RU/content/admin/user-management/creating-organizations.md @@ -3,7 +3,6 @@ title: Creating organizations redirect_from: - /enterprise/admin/articles/creating-organizations/ - /enterprise/admin/user-management/creating-organizations - - /enterprise/admin/user-management/creating-organizations intro: You can choose to set up a new organization or convert an existing personal account into an organization. versions: enterprise-server: '*' diff --git a/translations/ru-RU/content/admin/user-management/creating-teams.md b/translations/ru-RU/content/admin/user-management/creating-teams.md index ffa0646d73d2..1cd4ae266fe9 100644 --- a/translations/ru-RU/content/admin/user-management/creating-teams.md +++ b/translations/ru-RU/content/admin/user-management/creating-teams.md @@ -46,7 +46,9 @@ Instances using LDAP for user authentication can use LDAP Sync to manage a team' {% data reusables.profile.access_org %} {% data reusables.organizations.new_team %} {% data reusables.organizations.team_name %} -6. Search for an LDAP group's DN to map the team to. If you don't know the DN, type the LDAP group's name. {% data variables.product.prodname_ghe_server %} will search for and autocomplete any matches. ![Mapping to the LDAP group DN](/assets/images/enterprise/orgs-and-teams/ldap-group-mapping.png) +6. Search for an LDAP group's DN to map the team to. If you don't know the DN, type the LDAP group's name. +{% data variables.product.prodname_ghe_server %} will search for and autocomplete any matches. +![Mapping to the LDAP group DN](/assets/images/enterprise/orgs-and-teams/ldap-group-mapping.png) {% data reusables.organizations.team_description %} {% data reusables.organizations.team_visibility %} {% data reusables.organizations.create-team-choose-parent %} diff --git a/translations/ru-RU/content/admin/user-management/customizing-user-messages-on-your-instance.md b/translations/ru-RU/content/admin/user-management/customizing-user-messages-on-your-instance.md index 7a2c1d89da8c..60e39eebcb99 100644 --- a/translations/ru-RU/content/admin/user-management/customizing-user-messages-on-your-instance.md +++ b/translations/ru-RU/content/admin/user-management/customizing-user-messages-on-your-instance.md @@ -3,7 +3,6 @@ title: Customizing user messages on your instance redirect_from: - /enterprise/admin/user-management/creating-a-custom-sign-in-message/ - /enterprise/admin/user-management/customizing-user-messages-on-your-instance - - /enterprise/admin/user-management/customizing-user-messages-on-your-instance intro: 'You can create custom messages that users will see on the sign in and sign out pages{% if currentVersion ver_gt "enterprise-server@2.21" %} or in an announcement banner at the top of every page{% endif %}.' versions: enterprise-server: '*' diff --git a/translations/ru-RU/content/admin/user-management/disabling-git-ssh-access-on-github-enterprise-server.md b/translations/ru-RU/content/admin/user-management/disabling-git-ssh-access-on-github-enterprise-server.md index 67b8aac9734c..f791e82e1235 100644 --- a/translations/ru-RU/content/admin/user-management/disabling-git-ssh-access-on-github-enterprise-server.md +++ b/translations/ru-RU/content/admin/user-management/disabling-git-ssh-access-on-github-enterprise-server.md @@ -12,7 +12,6 @@ redirect_from: - /enterprise/admin/guides/installation/disabling-git-ssh-access-on-github-enterprise/ - /enterprise/admin/installation/disabling-git-ssh-access-on-github-enterprise-server - /enterprise/admin/user-management/disabling-git-ssh-access-on-github-enterprise-server - - /enterprise/admin/user-management/disabling-git-ssh-access-on-github-enterprise-server intro: 'You can prevent people from using Git over SSH for certain or all repositories on {% data variables.product.product_location_enterprise %}.' versions: enterprise-server: '*' diff --git a/translations/ru-RU/content/admin/user-management/exporting-migration-data-from-githubcom.md b/translations/ru-RU/content/admin/user-management/exporting-migration-data-from-githubcom.md index 1fbb90c22034..5b4046fe37f2 100644 --- a/translations/ru-RU/content/admin/user-management/exporting-migration-data-from-githubcom.md +++ b/translations/ru-RU/content/admin/user-management/exporting-migration-data-from-githubcom.md @@ -9,8 +9,6 @@ redirect_from: - /enterprise/admin/guides/migrations/preparing-the-github-com-source-organization - /enterprise/admin/guides/migrations/exporting-the-github-com-organization-s-repositories - /enterprise/admin/user-management/exporting-migration-data-from-githubcom - - /enterprise/admin/user-management/exporting-migration-data-from-githubcom - - /enterprise/admin/user-management/exporting-migration-data-from-githubcom versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/user-management/exporting-migration-data-from-your-enterprise.md b/translations/ru-RU/content/admin/user-management/exporting-migration-data-from-your-enterprise.md index f21ae8dddf2c..aec6a820ffc8 100644 --- a/translations/ru-RU/content/admin/user-management/exporting-migration-data-from-your-enterprise.md +++ b/translations/ru-RU/content/admin/user-management/exporting-migration-data-from-your-enterprise.md @@ -9,8 +9,6 @@ redirect_from: - /enterprise/admin/guides/migrations/preparing-the-github-enterprise-source-instance/ - /enterprise/admin/guides/migrations/exporting-the-github-enterprise-source-repositories/ - /enterprise/admin/user-management/exporting-migration-data-from-your-enterprise - - /enterprise/admin/user-management/exporting-migration-data-from-your-enterprise - - /enterprise/admin/user-management/exporting-migration-data-from-your-enterprise versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/user-management/index.md b/translations/ru-RU/content/admin/user-management/index.md index 81b83e51fec7..8a7ef8f23fd3 100644 --- a/translations/ru-RU/content/admin/user-management/index.md +++ b/translations/ru-RU/content/admin/user-management/index.md @@ -7,8 +7,6 @@ redirect_from: - /enterprise/admin/migrations - /enterprise/admin/clustering - /enterprise/admin/user-management - - /enterprise/admin/user-management - - /enterprise/admin/user-management intro: 'This guide describes authentication methods for users signing in to your {% data variables.product.prodname_enterprise %} instance, how to create organizations and teams for repository access and collaboration, and suggested best practices for user security.' versions: enterprise-server: '*' diff --git a/translations/ru-RU/content/admin/user-management/managing-dormant-users.md b/translations/ru-RU/content/admin/user-management/managing-dormant-users.md index aecfa960f8c2..f21822f2b2fa 100644 --- a/translations/ru-RU/content/admin/user-management/managing-dormant-users.md +++ b/translations/ru-RU/content/admin/user-management/managing-dormant-users.md @@ -5,7 +5,6 @@ redirect_from: - /enterprise/admin/articles/viewing-dormant-users/ - /enterprise/admin/articles/determining-whether-a-user-account-is-dormant/ - /enterprise/admin/user-management/managing-dormant-users - - /enterprise/admin/user-management/managing-dormant-users intro: A user account is considered to be dormant if it has not been active for at least a month. You may choose to suspend dormant users to free up user licenses. versions: enterprise-server: '*' diff --git a/translations/ru-RU/content/admin/user-management/managing-global-webhooks.md b/translations/ru-RU/content/admin/user-management/managing-global-webhooks.md index 6fb0d3108088..28475cebe953 100644 --- a/translations/ru-RU/content/admin/user-management/managing-global-webhooks.md +++ b/translations/ru-RU/content/admin/user-management/managing-global-webhooks.md @@ -4,7 +4,6 @@ intro: 'Site administrators can view, add, edit, and delete global webhooks to t redirect_from: - /enterprise/admin/user-management/about-global-webhooks - /enterprise/admin/user-management/managing-global-webhooks - - /enterprise/admin/user-management/managing-global-webhooks versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/user-management/managing-organizations-in-your-enterprise.md b/translations/ru-RU/content/admin/user-management/managing-organizations-in-your-enterprise.md index c1c0ff2ef511..ab347216400a 100644 --- a/translations/ru-RU/content/admin/user-management/managing-organizations-in-your-enterprise.md +++ b/translations/ru-RU/content/admin/user-management/managing-organizations-in-your-enterprise.md @@ -5,8 +5,6 @@ redirect_from: - /enterprise/admin/categories/admin-bootcamp/ - /enterprise/admin/user-management/organizations-and-teams - /enterprise/admin/user-management/managing-organizations-in-your-enterprise - - /enterprise/admin/user-management/managing-organizations-in-your-enterprise - - /enterprise/admin/user-management/managing-organizations-in-your-enterprise intro: 'Organizations are great for creating distinct groups of users within your company, such as divisions or groups working on similar projects. Public repositories that belong to an organization are accessible to users in other organizations, while private repositories are inaccessible to anyone but members of the organization.' mapTopic: true versions: diff --git a/translations/ru-RU/content/admin/user-management/managing-projects-using-jira.md b/translations/ru-RU/content/admin/user-management/managing-projects-using-jira.md index f7c72aeed7c2..fb919a17696a 100644 --- a/translations/ru-RU/content/admin/user-management/managing-projects-using-jira.md +++ b/translations/ru-RU/content/admin/user-management/managing-projects-using-jira.md @@ -7,8 +7,6 @@ redirect_from: - /enterprise/admin/developer-workflow/managing-projects-using-jira - /enterprise/admin/developer-workflow/customizing-your-instance-with-integrations - /enterprise/admin/user-management/managing-projects-using-jira - - /enterprise/admin/user-management/managing-projects-using-jira - - /enterprise/admin/user-management/managing-projects-using-jira versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/user-management/managing-repositories-in-your-enterprise.md b/translations/ru-RU/content/admin/user-management/managing-repositories-in-your-enterprise.md index 5819e3411c52..52831d237f78 100644 --- a/translations/ru-RU/content/admin/user-management/managing-repositories-in-your-enterprise.md +++ b/translations/ru-RU/content/admin/user-management/managing-repositories-in-your-enterprise.md @@ -4,8 +4,6 @@ intro: 'You can manage the settings available to repository administrators on yo redirect_from: - /enterprise/admin/user-management/repositories - /enterprise/admin/user-management/managing-repositories-in-your-enterprise - - /enterprise/admin/user-management/managing-repositories-in-your-enterprise - - /enterprise/admin/user-management/managing-repositories-in-your-enterprise mapTopic: true versions: enterprise-server: '*' diff --git a/translations/ru-RU/content/admin/user-management/managing-users-in-your-enterprise.md b/translations/ru-RU/content/admin/user-management/managing-users-in-your-enterprise.md index cb81b7da9dd1..e89560fa5326 100644 --- a/translations/ru-RU/content/admin/user-management/managing-users-in-your-enterprise.md +++ b/translations/ru-RU/content/admin/user-management/managing-users-in-your-enterprise.md @@ -6,8 +6,6 @@ redirect_from: - /enterprise/admin/user-management/basic-account-settings - /enterprise/admin/user-management/user-security - /enterprise/admin/user-management/managing-users-in-your-enterprise - - /enterprise/admin/user-management/managing-users-in-your-enterprise - - /enterprise/admin/user-management/managing-users-in-your-enterprise mapTopic: true versions: enterprise-server: '*' diff --git a/translations/ru-RU/content/admin/user-management/migrating-data-to-and-from-your-enterprise.md b/translations/ru-RU/content/admin/user-management/migrating-data-to-and-from-your-enterprise.md index 83774126be9e..51bb83534992 100644 --- a/translations/ru-RU/content/admin/user-management/migrating-data-to-and-from-your-enterprise.md +++ b/translations/ru-RU/content/admin/user-management/migrating-data-to-and-from-your-enterprise.md @@ -7,8 +7,6 @@ redirect_from: - /enterprise/admin/categories/migrations-and-upgrades/ - /enterprise/admin/migrations/overview - /enterprise/admin/user-management/migrating-data-to-and-from-your-enterprise - - /enterprise/admin/user-management/migrating-data-to-and-from-your-enterprise - - /enterprise/admin/user-management/migrating-data-to-and-from-your-enterprise versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/user-management/migrating-data-to-your-enterprise.md b/translations/ru-RU/content/admin/user-management/migrating-data-to-your-enterprise.md index 80897a29f1ec..14f09e2e6d94 100644 --- a/translations/ru-RU/content/admin/user-management/migrating-data-to-your-enterprise.md +++ b/translations/ru-RU/content/admin/user-management/migrating-data-to-your-enterprise.md @@ -51,13 +51,13 @@ The record types match those found in the [migrated data](/enterprise/admin/guid | Teams | `команда` | | Milestones | `контрольная точка` | | Project boards | `проект` | -| Вопросы | `задача` | +| Вопросы | `проблема` | | Issue comments | `issue_comment` | | Pull requests | `pull_request` | | Pull request reviews | `pull_request_review` | | Commit comments | `commit_comment` | | Pull request review comments | `pull_request_review_comment` | -| Релизы | `релиз` | +| Релизы | `версия` | | Actions taken on pull requests or issues | `issue_event` | | Protected branches | `protected_branch` | diff --git a/translations/ru-RU/content/admin/user-management/monitoring-activity-in-your-enterprise.md b/translations/ru-RU/content/admin/user-management/monitoring-activity-in-your-enterprise.md index d057a5e65531..991fef7abca5 100644 --- a/translations/ru-RU/content/admin/user-management/monitoring-activity-in-your-enterprise.md +++ b/translations/ru-RU/content/admin/user-management/monitoring-activity-in-your-enterprise.md @@ -4,10 +4,6 @@ mapTopic: true redirect_from: - /enterprise/admin/installation/monitoring-activity-on-your-github-enterprise-server-instance - /enterprise/admin/user-management/monitoring-activity-in-your-enterprise - - /enterprise/admin/user-management/monitoring-activity-in-your-enterprise - - /enterprise/admin/user-management/monitoring-activity-in-your-enterprise - - /enterprise/admin/user-management/monitoring-activity-in-your-enterprise - - /enterprise/admin/user-management/monitoring-activity-in-your-enterprise versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/user-management/placing-a-legal-hold-on-a-user-or-organization.md b/translations/ru-RU/content/admin/user-management/placing-a-legal-hold-on-a-user-or-organization.md index 2bebececa958..9f948cfb0184 100644 --- a/translations/ru-RU/content/admin/user-management/placing-a-legal-hold-on-a-user-or-organization.md +++ b/translations/ru-RU/content/admin/user-management/placing-a-legal-hold-on-a-user-or-organization.md @@ -3,7 +3,6 @@ title: Placing a legal hold on a user or organization intro: 'You can place a legal hold on a user or organization to ensure that repositories they own cannot be permanently removed from {% data variables.product.product_location_enterprise %}.' redirect_from: - /enterprise/admin/user-management/placing-a-legal-hold-on-a-user-or-organization - - /enterprise/admin/user-management/placing-a-legal-hold-on-a-user-or-organization versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/user-management/preventing-users-from-creating-organizations.md b/translations/ru-RU/content/admin/user-management/preventing-users-from-creating-organizations.md index 8ff523826dd9..84cc92bf7750 100644 --- a/translations/ru-RU/content/admin/user-management/preventing-users-from-creating-organizations.md +++ b/translations/ru-RU/content/admin/user-management/preventing-users-from-creating-organizations.md @@ -4,7 +4,6 @@ redirect_from: - /enterprise/admin/articles/preventing-users-from-creating-organizations/ - /enterprise/admin/hidden/preventing-users-from-creating-organizations/ - /enterprise/admin/user-management/preventing-users-from-creating-organizations - - /enterprise/admin/user-management/preventing-users-from-creating-organizations intro: 'You can prevent users from creating organizations on your {% data variables.product.prodname_ghe_server %} appliance.' versions: enterprise-server: '*' diff --git a/translations/ru-RU/content/admin/user-management/promoting-or-demoting-a-site-administrator.md b/translations/ru-RU/content/admin/user-management/promoting-or-demoting-a-site-administrator.md index 27430723e3c8..6d137cf2424a 100644 --- a/translations/ru-RU/content/admin/user-management/promoting-or-demoting-a-site-administrator.md +++ b/translations/ru-RU/content/admin/user-management/promoting-or-demoting-a-site-administrator.md @@ -4,7 +4,6 @@ redirect_from: - /enterprise/admin/articles/promoting-a-site-administrator/ - /enterprise/admin/articles/demoting-a-site-administrator/ - /enterprise/admin/user-management/promoting-or-demoting-a-site-administrator - - /enterprise/admin/user-management/promoting-or-demoting-a-site-administrator intro: 'Site administrators can promote any normal user account to a site administrator, as well as demote other site administrators to regular users.' versions: enterprise-server: '*' diff --git a/translations/ru-RU/content/admin/user-management/rebuilding-contributions-data.md b/translations/ru-RU/content/admin/user-management/rebuilding-contributions-data.md index eb034d5a5f58..71b24f03ec50 100644 --- a/translations/ru-RU/content/admin/user-management/rebuilding-contributions-data.md +++ b/translations/ru-RU/content/admin/user-management/rebuilding-contributions-data.md @@ -4,7 +4,6 @@ intro: You may need to rebuild contributions data to link existing commits to a redirect_from: - /enterprise/admin/articles/rebuilding-contributions-data/ - /enterprise/admin/user-management/rebuilding-contributions-data - - /enterprise/admin/user-management/rebuilding-contributions-data versions: enterprise-server: '*' --- @@ -16,4 +15,5 @@ Whenever a commit is pushed to {% data variables.product.prodname_enterprise %}, 3. On the left side of the page, click **Admin**. ![Admin tab](/assets/images/enterprise/site-admin-settings/admin-tab.png) 4. Under **Contributions data**, click **Rebuild**. ![Rebuild button](/assets/images/enterprise/site-admin-settings/rebuild-button.png) -{% data variables.product.prodname_enterprise %} will now start background jobs to re-link commits with that user's account. ![Queued rebuild jobs](/assets/images/enterprise/site-admin-settings/rebuild-jobs.png) +{% data variables.product.prodname_enterprise %} will now start background jobs to re-link commits with that user's account. + ![Queued rebuild jobs](/assets/images/enterprise/site-admin-settings/rebuild-jobs.png) diff --git a/translations/ru-RU/content/admin/user-management/removing-users-from-teams-and-organizations.md b/translations/ru-RU/content/admin/user-management/removing-users-from-teams-and-organizations.md index 982033d57d25..76a901328d74 100644 --- a/translations/ru-RU/content/admin/user-management/removing-users-from-teams-and-organizations.md +++ b/translations/ru-RU/content/admin/user-management/removing-users-from-teams-and-organizations.md @@ -3,7 +3,6 @@ title: Removing users from teams and organizations intro: 'If a member of your organization no longer requires access to certain repositories, you can remove them from the team that allows that access. If a member of your organization no longer requires access to any repositories owned by the organization, you can remove them from the organization.' redirect_from: - /enterprise/admin/user-management/removing-users-from-teams-and-organizations - - /enterprise/admin/user-management/removing-users-from-teams-and-organizations versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/user-management/searching-the-audit-log.md b/translations/ru-RU/content/admin/user-management/searching-the-audit-log.md index 9f14a8ad18d9..831d73ab5616 100644 --- a/translations/ru-RU/content/admin/user-management/searching-the-audit-log.md +++ b/translations/ru-RU/content/admin/user-management/searching-the-audit-log.md @@ -13,22 +13,22 @@ versions: Compose a search query from one or more key:value pairs separated by AND/OR logical operators. -| Клавиша | Value | -| --------------:| ------------------------------------------------------------------------------------------------------ | -| `actor_id` | ID of the user account that initiated the action | -| `actor` | Name of the user account that initiated the action | -| `oauth_app_id` | ID of the OAuth application associated with the action | +| Клавиша | Value | +| --------------:| -------------------------------------------------------------------------------------------------------- | +| `actor_id` | ID of the user account that initiated the action | +| `actor` | Name of the user account that initiated the action | +| `oauth_app_id` | ID of the OAuth application associated with the action | | `действие` | Name of the [audited action](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions) | -| `user_id` | ID of the user affected by the action | -| `пользователь` | Name of the user affected by the action | -| `repo_id` | ID of the repository affected by the action (if applicable) | -| `repo` | Name of the repository affected by the action (if applicable) | -| `actor_ip` | IP address from which the action was initiated | -| `created_at` | Time at which the action occurred | -| `from` | View from which the action was initiated | -| `примечание` | Miscellaneous event-specific information (in either plain text or JSON format) | -| `org` | Name of the organization affected by the action (if applicable) | -| `org_id` | ID of the organization affected by the action (if applicable) | +| `user_id` | ID of the user affected by the action | +| `пользователь` | Name of the user affected by the action | +| `repo_id` | ID of the repository affected by the action (if applicable) | +| `repo` | Name of the repository affected by the action (if applicable) | +| `actor_ip` | IP address from which the action was initiated | +| `created_at` | Time at which the action occurred | +| `from` | View from which the action was initiated | +| `примечание` | Miscellaneous event-specific information (in either plain text or JSON format) | +| `org` | Name of the organization affected by the action (if applicable) | +| `org_id` | ID of the organization affected by the action (if applicable) | For example, to see all actions that have affected the repository `octocat/Spoon-Knife` since the beginning of 2017: diff --git a/translations/ru-RU/content/admin/user-management/troubleshooting-service-hooks.md b/translations/ru-RU/content/admin/user-management/troubleshooting-service-hooks.md index d4eb4c535d5a..d6b7148aa6ab 100644 --- a/translations/ru-RU/content/admin/user-management/troubleshooting-service-hooks.md +++ b/translations/ru-RU/content/admin/user-management/troubleshooting-service-hooks.md @@ -5,7 +5,6 @@ redirect_from: - /enterprise/admin/articles/troubleshooting-service-hooks/ - /enterprise/admin/developer-workflow/troubleshooting-service-hooks - /enterprise/admin/user-management/troubleshooting-service-hooks - - /enterprise/admin/user-management/troubleshooting-service-hooks versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/admin/user-management/viewing-push-logs.md b/translations/ru-RU/content/admin/user-management/viewing-push-logs.md index 5eea64bbf9b7..ff2415afe0d6 100644 --- a/translations/ru-RU/content/admin/user-management/viewing-push-logs.md +++ b/translations/ru-RU/content/admin/user-management/viewing-push-logs.md @@ -5,7 +5,6 @@ redirect_from: - /enterprise/admin/articles/viewing-push-logs/ - /enterprise/admin/installation/viewing-push-logs - /enterprise/admin/user-management/viewing-push-logs - - /enterprise/admin/user-management/viewing-push-logs versions: enterprise-server: '*' --- diff --git a/translations/ru-RU/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-a-repository-from-github-to-github-desktop.md b/translations/ru-RU/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-a-repository-from-github-to-github-desktop.md index 9fdfae53495c..2c7858449227 100644 --- a/translations/ru-RU/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-a-repository-from-github-to-github-desktop.md +++ b/translations/ru-RU/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-a-repository-from-github-to-github-desktop.md @@ -15,7 +15,9 @@ versions: {% mac %} -1. Sign in to {% data variables.product.product_location %} and {% data variables.product.prodname_desktop %} before you start to clone. +1. Sign in to + +{% data variables.product.product_location %} and {% data variables.product.prodname_desktop %} before you start to clone. {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.open-with-github-desktop %} 5. Click **Choose...** and, using the Finder window, navigate to a local path where you want to clone the repository. ![The choose button on the URL tab](/assets/images/help/desktop/clone-choose-button-url-mac.png) @@ -32,7 +34,9 @@ versions: {% windows %} -1. Sign in to {% data variables.product.product_location %} and {% data variables.product.prodname_desktop %} before you start to clone. +1. Sign in to + +{% data variables.product.product_location %} and {% data variables.product.prodname_desktop %} before you start to clone. {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.open-with-github-desktop %} 5. Click **Choose...** and, using Windows Explorer, navigate to a local path where you want to clone the repository. ![The choose button](/assets/images/help/desktop/clone-choose-button-url-win.png) diff --git a/translations/ru-RU/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop.md b/translations/ru-RU/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop.md index bb895cba213b..60a7dc7a2e44 100644 --- a/translations/ru-RU/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop.md +++ b/translations/ru-RU/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop.md @@ -19,8 +19,8 @@ You can also clone a repository directly from {% data variables.product.prodname ![Clone menu option in the Mac app](/assets/images/help/desktop/clone-file-menu-mac.png) {% data reusables.desktop.cloning-location-tab %} ![Location tabs in the Clone a repository menu](/assets/images/help/desktop/choose-repository-location-mac.png) -{% data reusables.desktop.cloning-repository-list %} -![Clone a repository list](/assets/images/help/desktop/clone-a-repository-list-mac.png) +{% data reusables.desktop.cloning-repository-list %} + ![Clone a repository list](/assets/images/help/desktop/clone-a-repository-list-mac.png) 4. Click **Choose...** and, using the Finder window, navigate to a local path where you want to clone the repository. ![The choose button](/assets/images/help/desktop/clone-choose-button-mac.png) 5. Click **Clone**. ![The clone button](/assets/images/help/desktop/clone-button-mac.png) @@ -32,8 +32,8 @@ You can also clone a repository directly from {% data variables.product.prodname ![Clone menu option in the Windows app](/assets/images/help/desktop/clone-file-menu-windows.png) {% data reusables.desktop.cloning-location-tab %} ![Location tabs in the Clone a repository menu](/assets/images/help/desktop/choose-repository-location-win.png) -{% data reusables.desktop.cloning-repository-list %} -![Clone a repository list](/assets/images/help/desktop/clone-a-repository-list-win.png) +{% data reusables.desktop.cloning-repository-list %} + ![Clone a repository list](/assets/images/help/desktop/clone-a-repository-list-win.png) 4. Click **Choose...** and, using Windows Explorer, navigate to a local path where you want to clone the repository. ![The choose button](/assets/images/help/desktop/clone-choose-button-win.png) 5. Click **Clone**. ![The clone button](/assets/images/help/desktop/clone-button-win.png) diff --git a/translations/ru-RU/content/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request.md b/translations/ru-RU/content/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request.md index 2fb96c648ba5..9b165a6e1435 100644 --- a/translations/ru-RU/content/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request.md +++ b/translations/ru-RU/content/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request.md @@ -50,7 +50,9 @@ Before you create a pull request, you'll need to push changes to a branch on {% 1. Switch to the branch that you want to create a pull request for. For more information, see "[Switching between branches](/desktop/contributing-and-collaborating-using-github-desktop/managing-branches#switching-between-branches)." 2. Click **Create Pull Request**. {% data variables.product.prodname_desktop %} will open your default browser to take you to {% data variables.product.prodname_dotcom %}. ![The Create Pull Request button](/assets/images/help/desktop/mac-create-pull-request.png) -4. On {% data variables.product.prodname_dotcom %}, confirm that the branch in the **base:** drop-down menu is the branch where you want to merge your changes. Confirm that the branch in the **compare:** drop-down menu is the topic branch where you made your changes. ![Drop-down menus for choosing the base and compare branches](/assets/images/help/desktop/base-and-compare-branches.png) +4. On +{% data variables.product.prodname_dotcom %}, confirm that the branch in the **base:** drop-down menu is the branch where you want to merge your changes. Confirm that the branch in the **compare:** drop-down menu is the topic branch where you made your changes. + ![Drop-down menus for choosing the base and compare branches](/assets/images/help/desktop/base-and-compare-branches.png) {% data reusables.repositories.pr-title-description %} {% data reusables.repositories.create-pull-request %} @@ -60,7 +62,9 @@ Before you create a pull request, you'll need to push changes to a branch on {% 1. Switch to the branch that you want to create a pull request for. For more information, see "[Switching between branches](/desktop/contributing-and-collaborating-using-github-desktop/managing-branches#switching-between-branches)." 2. Click **Create Pull Request**. {% data variables.product.prodname_desktop %} will open your default browser to take you to {% data variables.product.prodname_dotcom %}. ![The Create Pull Request button](/assets/images/help/desktop/windows-create-pull-request.png) -3. On {% data variables.product.prodname_dotcom %}, confirm that the branch in the **base:** drop-down menu is the branch where you want to merge your changes. Confirm that the branch in the **compare:** drop-down menu is the topic branch where you made your changes. ![Drop-down menus for choosing the base and compare branches](/assets/images/help/desktop/base-and-compare-branches.png) +3. On +{% data variables.product.prodname_dotcom %}, confirm that the branch in the **base:** drop-down menu is the branch where you want to merge your changes. Confirm that the branch in the **compare:** drop-down menu is the topic branch where you made your changes. + ![Drop-down menus for choosing the base and compare branches](/assets/images/help/desktop/base-and-compare-branches.png) {% data reusables.repositories.pr-title-description %} {% data reusables.repositories.create-pull-request %} diff --git a/translations/ru-RU/content/desktop/installing-and-configuring-github-desktop/authenticating-to-github.md b/translations/ru-RU/content/desktop/installing-and-configuring-github-desktop/authenticating-to-github.md index 39b8bce90c33..de505abec627 100644 --- a/translations/ru-RU/content/desktop/installing-and-configuring-github-desktop/authenticating-to-github.md +++ b/translations/ru-RU/content/desktop/installing-and-configuring-github-desktop/authenticating-to-github.md @@ -37,7 +37,9 @@ Before you authenticate, {% data reusables.desktop.get-an-account %} {% data reusables.desktop.mac-select-desktop-menu %} {% data reusables.desktop.mac-select-accounts %} {% data reusables.desktop.choose-product-authenticate %} -4. To add a {% data variables.product.prodname_enterprise %} account, type your credentials under "Enterprise server address," then click **Continue**. ![The Sign In button for GitHub Enterprise](/assets/images/help/desktop/mac-sign-in-button-enterprise.png) +4. To add a +{% data variables.product.prodname_enterprise %} account, type your credentials under "Enterprise server address," then click **Continue**. + ![The Sign In button for GitHub Enterprise](/assets/images/help/desktop/mac-sign-in-button-enterprise.png) {% data reusables.desktop.retrieve-2fa %} {% endmac %} @@ -65,7 +67,9 @@ Before you authenticate, {% data reusables.desktop.get-an-account %} {% data reusables.desktop.windows-choose-options %} {% data reusables.desktop.windows-select-accounts %} {% data reusables.desktop.choose-product-authenticate %} -4. To add a {% data variables.product.prodname_enterprise %} account, type your credentials under "Enterprise server address," then click **Continue**. ![The Sign In button for GitHub Enterprise](/assets/images/help/desktop/windows-sign-in-button-enterprise.png) +4. To add a +{% data variables.product.prodname_enterprise %} account, type your credentials under "Enterprise server address," then click **Continue**. + ![The Sign In button for GitHub Enterprise](/assets/images/help/desktop/windows-sign-in-button-enterprise.png) {% data reusables.desktop.retrieve-2fa %} {% endwindows %} diff --git a/translations/ru-RU/content/desktop/installing-and-configuring-github-desktop/keyboard-shortcuts.md b/translations/ru-RU/content/desktop/installing-and-configuring-github-desktop/keyboard-shortcuts.md index aca30f4f4a74..9e71ad1abb18 100644 --- a/translations/ru-RU/content/desktop/installing-and-configuring-github-desktop/keyboard-shortcuts.md +++ b/translations/ru-RU/content/desktop/installing-and-configuring-github-desktop/keyboard-shortcuts.md @@ -14,53 +14,53 @@ GitHub Desktop keyboard shortcuts on macOS ### Site wide shortcuts -| Keyboard shortcut | Description | -| ------------------------------------ | ----------------------------------------------------------------------- | -| ⌘, | Go to Preferences | +| Keyboard shortcut | Description | +| ------------------------------------ | ------------------------------------------------------------------ | +| ⌘, | Go to Preferences | | ⌘H | Hide the {% data variables.product.prodname_desktop %} application | -| ⌥⌘H | Hide all other applications | -| ⌘Q | Quit {% data variables.product.prodname_desktop %} | -| ⌃⌘F | Toggle full screen view | -| ⌘0 | Reset zoom to default text size | -| ⌘= | Zoom in for larger text and graphics | -| ⌘- | Zoom out for smaller text and graphics | -| ⌥⌘I | Toggle Developer Tools | +| ⌥⌘H | Hide all other applications | +| ⌘Q | Quit {% data variables.product.prodname_desktop %} +| ⌃⌘F | Toggle full screen view | +| ⌘0 | Reset zoom to default text size | +| ⌘= | Zoom in for larger text and graphics | +| ⌘- | Zoom out for smaller text and graphics | +| ⌥⌘I | Toggle Developer Tools | ### Repositories -| Keyboard shortcut | Description | -| ------------------------------------ | ----------------------------------------------------------------------------------- | -| ⌘N | Add a new repository | -| ⌘O | Add a local repository | -| ⇧⌘O | Clone a repository from {% data variables.product.prodname_dotcom %} | -| ⌘T | Show a list of your repositories | -| ⌘P | Push the latest commits to {% data variables.product.prodname_dotcom %} | -| ⇧⌘P | Pull down the latest changes from {% data variables.product.prodname_dotcom %} | -| ⌘⌫ | Remove an existing repository | -| ⇧⌘G | View the repository on {% data variables.product.prodname_dotcom %} | -| ⌃` | Open repository in your preferred terminal tool | -| ⇧⌘F | Show the repository in Finder | -| ⇧⌘A | Open the repository in your preferred editor tool | -| ⌘I | Create an issue on {% data variables.product.prodname_dotcom %} | +| Keyboard shortcut | Description | +| ------------------------------------ | ------------------------------------------------------------------------------ | +| ⌘N | Add a new repository | +| ⌘O | Add a local repository | +| ⇧⌘O | Clone a repository from {% data variables.product.prodname_dotcom %} +| ⌘T | Show a list of your repositories | +| ⌘P | Push the latest commits to {% data variables.product.prodname_dotcom %} +| ⇧⌘P | Pull down the latest changes from {% data variables.product.prodname_dotcom %} +| ⌘⌫ | Remove an existing repository | +| ⇧⌘G | View the repository on {% data variables.product.prodname_dotcom %} +| ⌃` | Open repository in your preferred terminal tool | +| ⇧⌘F | Show the repository in Finder | +| ⇧⌘A | Open the repository in your preferred editor tool | +| ⌘I | Create an issue on {% data variables.product.prodname_dotcom %} ### Branches -| Keyboard shortcut | Description | -| ------------------------------------ | ---------------------------------------------------------------------------------- | -| ⌘1 | Show all your changes before committing | -| ⌘2 | Show your commit history | -| ⌘B | Show all your branches | -| ⌘G | Go to the commit summary field | -| space | Select or deselect all highlighted files | -| ⇧⌘N | Create a new branch | -| ⇧⌘R | Rename the current branch | -| ⇧⌘D | Delete the current branch | -| ⇧⌘U | Update from default branch | -| ⇧⌘B | Compare to an existing branch | -| ⇧⌘M | Merge into current branch | -| ⌃H | Show or hide stashed changes | -| ⇧⌘C | Compare branches on {% data variables.product.prodname_dotcom %} | -| ⌘R | Show the current pull request on {% data variables.product.prodname_dotcom %} | +| Keyboard shortcut | Description | +| ------------------------------------ | ----------------------------------------------------------------------------- | +| ⌘1 | Show all your changes before committing | +| ⌘2 | Show your commit history | +| ⌘B | Show all your branches | +| ⌘G | Go to the commit summary field | +| space | Select or deselect all highlighted files | +| ⇧⌘N | Create a new branch | +| ⇧⌘R | Rename the current branch | +| ⇧⌘D | Delete the current branch | +| ⇧⌘U | Update from default branch | +| ⇧⌘B | Compare to an existing branch | +| ⇧⌘M | Merge into current branch | +| ⌃H | Show or hide stashed changes | +| ⇧⌘C | Compare branches on {% data variables.product.prodname_dotcom %} +| ⌘R | Show the current pull request on {% data variables.product.prodname_dotcom %} {% endmac %} @@ -81,38 +81,38 @@ GitHub Desktop keyboard shortcuts on Windows ### Repositories -| Keyboard Shortcut | Description | -| ------------------------------------------- | ----------------------------------------------------------------------------------- | -| CtrlN | Add a new repository | -| CtrlO | Add a local repository | -| CtrlShiftO | Clone a repository from {% data variables.product.prodname_dotcom %} | -| CtrlT | Show a list of your repositories | -| CtrlP | Push the latest commits to {% data variables.product.prodname_dotcom %} | -| CtrlShiftP | Pull down the latest changes from {% data variables.product.prodname_dotcom %} | -| CtrlDelete | Remove an existing repository | -| CtrlShiftG | View the repository on {% data variables.product.prodname_dotcom %} | -| Ctrl` | Open repository in your preferred command line tool | -| CtrlShiftF | Show the repository in Explorer | -| CtrlShiftA | Open the repository in your preferred editor tool | -| CtrlI | Create an issue on {% data variables.product.prodname_dotcom %} | +| Keyboard Shortcut | Description | +| ------------------------------------------- | ------------------------------------------------------------------------------ | +| CtrlN | Add a new repository | +| CtrlO | Add a local repository | +| CtrlShiftO | Clone a repository from {% data variables.product.prodname_dotcom %} +| CtrlT | Show a list of your repositories | +| CtrlP | Push the latest commits to {% data variables.product.prodname_dotcom %} +| CtrlShiftP | Pull down the latest changes from {% data variables.product.prodname_dotcom %} +| CtrlDelete | Remove an existing repository | +| CtrlShiftG | View the repository on {% data variables.product.prodname_dotcom %} +| Ctrl` | Open repository in your preferred command line tool | +| CtrlShiftF | Show the repository in Explorer | +| CtrlShiftA | Open the repository in your preferred editor tool | +| CtrlI | Create an issue on {% data variables.product.prodname_dotcom %} ### Branches -| Keyboard shortcut | Description | -| ------------------------------------------- | ---------------------------------------------------------------------------------- | -| Ctrl1 | Show all your changes before committing | -| Ctrl2 | Show your commit history | -| CtrlB | Show all your branches | -| CtrlG | Go to the commit summary field | -| space | Select or deselect all highlighted files | -| CtrlShiftN | Create a new branch | -| CtrlShiftR | Rename the current branch | -| CtrlShiftD | Delete the current branch | -| CtrlShiftU | Update from default branch | -| CtrlShiftB | Compare to an existing branch | -| CtrlShiftM | Merge into current branch | -| CtrlH | Show or hide stashed changes | -| CtrlShiftC | Compare branches on {% data variables.product.prodname_dotcom %} | -| CtrlR | Show the current pull request on {% data variables.product.prodname_dotcom %} | +| Keyboard shortcut | Description | +| ------------------------------------------- | ----------------------------------------------------------------------------- | +| Ctrl1 | Show all your changes before committing | +| Ctrl2 | Show your commit history | +| CtrlB | Show all your branches | +| CtrlG | Go to the commit summary field | +| space | Select or deselect all highlighted files | +| CtrlShiftN | Create a new branch | +| CtrlShiftR | Rename the current branch | +| CtrlShiftD | Delete the current branch | +| CtrlShiftU | Update from default branch | +| CtrlShiftB | Compare to an existing branch | +| CtrlShiftM | Merge into current branch | +| CtrlH | Show or hide stashed changes | +| CtrlShiftC | Compare branches on {% data variables.product.prodname_dotcom %} +| CtrlR | Show the current pull request on {% data variables.product.prodname_dotcom %} {% endwindows %} diff --git a/translations/ru-RU/content/developers/apps/activating-beta-features-for-apps.md b/translations/ru-RU/content/developers/apps/activating-beta-features-for-apps.md index 389ecf6690b1..f349501d5f0c 100644 --- a/translations/ru-RU/content/developers/apps/activating-beta-features-for-apps.md +++ b/translations/ru-RU/content/developers/apps/activating-beta-features-for-apps.md @@ -15,7 +15,8 @@ versions: {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} -3. Select the {% data variables.product.prodname_github_app %} you want to enable a beta feature for. +3. Select the +{% data variables.product.prodname_github_app %} you want to enable a beta feature for. {% data reusables.apps.beta_feature_activation %} ### Activating beta features for {% data variables.product.prodname_oauth_app %}s diff --git a/translations/ru-RU/content/developers/apps/authorizing-oauth-apps.md b/translations/ru-RU/content/developers/apps/authorizing-oauth-apps.md index a963e206ad7e..318c0f76ec28 100644 --- a/translations/ru-RU/content/developers/apps/authorizing-oauth-apps.md +++ b/translations/ru-RU/content/developers/apps/authorizing-oauth-apps.md @@ -54,11 +54,11 @@ When your GitHub App specifies a `login` parameter, it prompts users with a spec | Name | Тип | Description | | -------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `client_id` | `строка` | **Required**. The client ID you received from GitHub when you {% if currentVersion == "free-pro-team@latest" %}[registered](https://github.com/settings/applications/new){% else %}registered{% endif %}. | +| `client_id` | `строка` | **Required**. The client ID you received from GitHub when you {% if currentVersion == "free-pro-team@latest" %}[registered](https://github.com/settings/applications/new){% else %}registered{% endif %}. | | `redirect_uri` | `строка` | The URL in your application where users will be sent after authorization. See details below about [redirect urls](#redirect-urls). | | `login` | `строка` | Suggests a specific account to use for signing in and authorizing the app. | | `область` | `строка` | A space-delimited list of [scopes](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/). If not provided, `scope` defaults to an empty list for users that have not authorized any scopes for the application. For users who have authorized scopes for the application, the user won't be shown the OAuth authorization page with the list of scopes. Instead, this step of the flow will automatically complete with the set of scopes the user has authorized for the application. For example, if a user has already performed the web flow twice and has authorized one token with `user` scope and another token with `repo` scope, a third web flow that does not provide a `scope` will receive a token with `user` and `repo` scope. | -| `state` | `строка` | {% data reusables.apps.state_description %} | +| `state` | `строка` | {% data reusables.apps.state_description %} | `allow_signup` | `строка` | Whether or not unauthenticated users will be offered an option to sign up for GitHub during the OAuth flow. The default is `true`. Use `false` when a policy prohibits signups. | #### 2. Users are redirected back to your site by GitHub @@ -71,13 +71,13 @@ Exchange this `code` for an access token: ##### Parameters -| Name | Тип | Description | -| --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| Name | Тип | Description | +| --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | `client_id` | `строка` | **Required.** The client ID you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_github_app %}. | | `client_secret` | `строка` | **Required.** The client secret you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_github_app %}. | -| `код` | `строка` | **Required.** The code you received as a response to Step 1. | -| `redirect_uri` | `строка` | The URL in your application where users are sent after authorization. | -| `state` | `строка` | The unguessable random string you provided in Step 1. | +| `код` | `строка` | **Required.** The code you received as a response to Step 1. | +| `redirect_uri` | `строка` | The URL in your application where users are sent after authorization. | +| `state` | `строка` | The unguessable random string you provided in Step 1. | ##### Response @@ -135,14 +135,13 @@ Your app must request a user verification code and verification URL that the app ##### Input Parameters -| Name | Тип | Description | -| ----------- | -------- | ---------------------------------------------------------------------------------------------------------- | +| Name | Тип | Description | +| ----------- | -------- | ----------------------------------------------------------------------------------------------------- | | `client_id` | `строка` | **Required.** The client ID you received from {% data variables.product.product_name %} for your app. | -| `область` | `строка` | The scope that your app is requesting access to. | +| `область` | `строка` | The scope that your app is requesting access to. | ##### Response - {% if currentVersion == "free-pro-team@latest" %} ```JSON { @@ -167,12 +166,12 @@ Your app must request a user verification code and verification URL that the app ##### Response parameters -| Name | Тип | Description | -| ------------------ | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `device_code` | `строка` | The device verification code is 40 characters and used to verify the device. | -| `user_code` | `строка` | The user verification code is displayed on the device so the user can enter the code in a browser. This code is 8 characters with a hyphen in the middle. | +| Name | Тип | Description | +| ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `device_code` | `строка` | The device verification code is 40 characters and used to verify the device. | +| `user_code` | `строка` | The user verification code is displayed on the device so the user can enter the code in a browser. This code is 8 characters with a hyphen in the middle. | | `verification_uri` | `строка` | The verification URL where users need to enter the `user_code`: {% data variables.product.device_authorization_url %}. | -| `expires_in` | `integer` | The number of seconds before the `device_code` and `user_code` expire. The default is 900 seconds or 15 minutes. | +| `expires_in` | `integer` | The number of seconds before the `device_code` and `user_code` expire. The default is 900 seconds or 15 minutes. | | `interval` | `integer` | The minimum number of seconds that must pass before you can make a new access token request (`POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`) to complete the device authorization. For example, if the interval is 5, then you cannot make a new request until 5 seconds pass. If you make more than one request over 5 seconds, then you will hit the rate limit and receive a `slow_down` error. | #### Step 2: Prompt the user to enter the user code in a browser @@ -193,11 +192,11 @@ Once the user has authorized, the app will receive an access token that can be u ##### Input parameters -| Name | Тип | Description | -| ------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Name | Тип | Description | +| ------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | `client_id` | `строка` | **Required.** The client ID you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_oauth_app %}. | -| `device_code` | `строка` | **Required.** The device verification code you received from the `POST {% data variables.product.oauth_host_code %}/login/device/code` request. | -| `grant_type` | `строка` | **Required.** The grant type must be `urn:ietf:params:oauth:grant-type:device_code`. | +| `device_code` | `строка` | **Required.** The device verification code you received from the `POST {% data variables.product.oauth_host_code %}/login/device/code` request. | +| `grant_type` | `строка` | **Required.** The grant type must be `urn:ietf:params:oauth:grant-type:device_code`. | ##### Response @@ -217,15 +216,15 @@ If you make more than one access token request (`POST {% data variables.product. #### Error codes for the device flow -| Error code | Description | -| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Error code | Description | +| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `authorization_pending` | This error occurs when the authorization request is pending and the user hasn't entered the user code yet. The app is expected to keep polling the `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token` request without exceeding the [`interval`](#response-parameters), which requires a minimum number of seconds between each request. | | `slow_down` | When you receive the `slow_down` error, 5 extra seconds are added to the minimum `interval` or timeframe required between your requests using `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`. For example, if the starting interval required at least 5 seconds between requests and you get a `slow_down` error response, you must now wait a minimum of 10 seconds before making a new request for an OAuth access token. The error response includes the new `interval` that you must use. | -| `expired_token` | If the device code expired, then you will see the `token_expired` error. You must make a new request for a device code. | +| `expired_token` | If the device code expired, then you will see the `token_expired` error. You must make a new request for a device code. | | `unsupported_grant_type` | The grant type must be `urn:ietf:params:oauth:grant-type:device_code` and included as an input parameter when you poll the OAuth token request `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`. | -| `incorrect_client_credentials` | For the device flow, you must pass your app's client ID, which you can find on your app settings page. The `client_secret` is not needed for the device flow. | -| `incorrect_device_code` | The device_code provided is not valid. | -| `access_denied` | When a user clicks cancel during the authorization process, you'll receive a `access_denied` error and the user won't be able to use the verification code again. | +| `incorrect_client_credentials` | For the device flow, you must pass your app's client ID, which you can find on your app settings page. The `client_secret` is not needed for the device flow. | +| `incorrect_device_code` | The device_code provided is not valid. | +| `access_denied` | When a user clicks cancel during the authorization process, you'll receive a `access_denied` error and the user won't be able to use the verification code again. | For more information, see the "[OAuth 2.0 Device Authorization Grant](https://tools.ietf.org/html/rfc8628#section-3.5)." diff --git a/translations/ru-RU/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md b/translations/ru-RU/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md index 3bc56b801a03..6fb0c99b9890 100644 --- a/translations/ru-RU/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md +++ b/translations/ru-RU/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md @@ -8,9 +8,6 @@ versions: enterprise-server: '*' --- - - - By default, a new OAuth App will have an automatically generated [identicon](https://github.com/blog/1586-identicons). An identicon badge looks something like this: ![Identicon](/assets/images/identicon.png) @@ -31,7 +28,7 @@ To create a custom badge: {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.oauth_apps %} {% data reusables.user-settings.modify_oauth_app %} -5. In "Application logo", drag-and-drop an image from a local folder or click **Upload new logo** to select an image from your computer. ![Upload a logo](/assets/images/oauth-apps/oauth_apps_upload_logo.png) +1. In "Application logo", drag-and-drop an image from a local folder or click **Upload new logo** to select an image from your computer. ![Upload a logo](/assets/images/oauth-apps/oauth_apps_upload_logo.png) 6. Crop your picture. When you're done, click **Set new application logo**. ![Crop and set logo](/assets/images/oauth-apps/oauth_apps_crop_and_set_logo.png) 7. In "Badge background color", type the [hexadecimal color code](http://www.color-hex.com/) of the background color for your badge. {% if currentVersion == "free-pro-team@latest" %}**Note:** The "Badge background color" input field will be visible after an application logo has been uploaded.{% endif %} diff --git a/translations/ru-RU/content/developers/apps/creating-a-github-app-from-a-manifest.md b/translations/ru-RU/content/developers/apps/creating-a-github-app-from-a-manifest.md index ef8dceead3fe..ccd377212060 100644 --- a/translations/ru-RU/content/developers/apps/creating-a-github-app-from-a-manifest.md +++ b/translations/ru-RU/content/developers/apps/creating-a-github-app-from-a-manifest.md @@ -71,9 +71,9 @@ The `hook_attributes` object has the following key: ##### Parameters - | Name | Тип | Description | - | ------- | -------- | ------------------------------------------------ | - | `state` | `строка` | {% data reusables.apps.state_description %} | + | Name | Тип | Description | + | ------- | -------- | ------------------------------------------- | + | `state` | `строка` | {% data reusables.apps.state_description %} ##### Примеры diff --git a/translations/ru-RU/content/developers/apps/creating-a-github-app-using-url-parameters.md b/translations/ru-RU/content/developers/apps/creating-a-github-app-using-url-parameters.md index debde52f912d..09ff2f828f0a 100644 --- a/translations/ru-RU/content/developers/apps/creating-a-github-app-using-url-parameters.md +++ b/translations/ru-RU/content/developers/apps/creating-a-github-app-using-url-parameters.md @@ -27,93 +27,93 @@ The complete list of available query parameters, permissions, and events is list ### {% data variables.product.prodname_github_app %} configuration parameters - | Name | Тип | Description | - | -------------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - | `name` | `строка` | The name of the {% data variables.product.prodname_github_app %}. Give your app a clear and succinct name. Your app cannot have the same name as an existing GitHub user, unless it is your own user or organization name. A slugged version of your app's name will be shown in the user interface when your integration takes an action. | - | `описание` | `строка` | A description of the {% data variables.product.prodname_github_app %}. | - | `url` | `строка` | The full URL of your {% data variables.product.prodname_github_app %}'s website homepage. | - | `callback_url` | `строка` | The full URL to redirect to after someone authorizes an installation. This URL is used if your app needs to identify and authorize user-to-server requests. | - | `request_oauth_on_install` | `boolean` | If your app authorizes users using the OAuth flow, you can set this option to `true` to allow people to authorize the app when they install it, saving a step. If you select this option, the `setup_url` becomes unavailable and users will be redirected to your `callback_url` after installing the app. | - | `setup_url` | `строка` | The full URL to redirect to after someone installs the {% data variables.product.prodname_github_app %} if the app requires additional setup after installation. | - | `setup_on_update` | `boolean` | Set to `true` to redirect people to the setup URL when installations have been updated, for example, after repositories are added or removed. | - | `public` | `boolean` | Set to `true` when your {% data variables.product.prodname_github_app %} is available to the public or `false` when it is only accessible to the owner of the app. | - | `webhook_url` | `строка` | The full URL that you would like to send webhook event payloads to. | - | `webhook_secret` | `строка` | You can specify a secret to secure your webhooks. See "[Securing your webhooks](/webhooks/securing/)" for more details. | + | Name | Тип | Description | + | -------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | + | `name` | `строка` | The name of the {% data variables.product.prodname_github_app %}. Give your app a clear and succinct name. Your app cannot have the same name as an existing GitHub user, unless it is your own user or organization name. A slugged version of your app's name will be shown in the user interface when your integration takes an action. | + | `описание` | `строка` | A description of the {% data variables.product.prodname_github_app %}. | + | `url` | `строка` | The full URL of your {% data variables.product.prodname_github_app %}'s website homepage. | + | `callback_url` | `строка` | The full URL to redirect to after someone authorizes an installation. This URL is used if your app needs to identify and authorize user-to-server requests. | + | `request_oauth_on_install` | `boolean` | If your app authorizes users using the OAuth flow, you can set this option to `true` to allow people to authorize the app when they install it, saving a step. If you select this option, the `setup_url` becomes unavailable and users will be redirected to your `callback_url` after installing the app. | + | `setup_url` | `строка` | The full URL to redirect to after someone installs the {% data variables.product.prodname_github_app %} if the app requires additional setup after installation. | + | `setup_on_update` | `boolean` | Set to `true` to redirect people to the setup URL when installations have been updated, for example, after repositories are added or removed. | + | `public` | `boolean` | Set to `true` when your {% data variables.product.prodname_github_app %} is available to the public or `false` when it is only accessible to the owner of the app. | + | `webhook_url` | `строка` | The full URL that you would like to send webhook event payloads to. | + | `webhook_secret` | `строка` | You can specify a secret to secure your webhooks. See "[Securing your webhooks](/webhooks/securing/)" for more details. | | `events` | `array of strings` | Webhook events. Some webhook events require `read` or `write` permissions for a resource before you can select the event when registering a new {% data variables.product.prodname_github_app %}. See the "[{% data variables.product.prodname_github_app %} webhook events](#github-app-webhook-events)" section for available events and their required permissions. You can select multiple events in a query string. For example, `events[]=public&events[]=label`. | - | `домен` | `строка` | The URL of a content reference. | - | `single_file_name` | `строка` | When you grant `read` or `write` access to the `single_file` permission, this field provides the path to the single file your {% data variables.product.prodname_github_app %} will manage. | + | `домен` | `строка` | The URL of a content reference. | + | `single_file_name` | `строка` | When you grant `read` or `write` access to the `single_file` permission, this field provides the path to the single file your {% data variables.product.prodname_github_app %} will manage. | ### {% data variables.product.prodname_github_app %} permissions You can select permissions in a query string using the permission name in the following table as the query parameter name and the permission type as the query value. For example, to select `Read & write` permissions in the user interface for `contents`, your query string would include `&contents=write`. To select `Read-only` permissions in the user interface for `blocking`, your query string would include `&blocking=read`. To select `no-access` in the user interface for `checks`, your query string would not include the `checks` permission. -| Permission | Description | -| -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Permission | Description | +| -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [`administration`](/rest/reference/permissions-required-for-github-apps/#permission-on-administration) | Grants access to various endpoints for organization and repository administration. Can be one of: `none`, `read`, or `write`.{% if currentVersion == "free-pro-team@latest" %} | [`blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-blocking) | Grants access to the [Blocking Users API](/v3/users/blocking/). Can be one of: `none`, `read`, or `write`.{% endif %} -| [`checks`](/rest/reference/permissions-required-for-github-apps/#permission-on-checks) | Grants access to the [Checks API](/v3/checks/). Can be one of: `none`, `read`, or `write`. | -| `content_references` | Grants access to the "[Create a content attachment](/v3/apps/installations/#create-a-content-attachment)" endpoint. Can be one of: `none`, `read`, or `write`. | -| [`contents`](/rest/reference/permissions-required-for-github-apps/#permission-on-contents) | Grants access to various endpoints that allow you to modify repository contents. Can be one of: `none`, `read`, or `write`. | -| [`deployments`](/rest/reference/permissions-required-for-github-apps/#permission-on-deployments) | Grants access to the [Deployments API](/v3/repos/deployments/). Can be one of: `none`, `read`, or `write`. | -| [`emails`](/rest/reference/permissions-required-for-github-apps/#permission-on-emails) | Grants access to the [Emails API](/v3/users/emails/). Can be one of: `none`, `read`, or `write`. | -| [`followers`](/rest/reference/permissions-required-for-github-apps/#permission-on-followers) | Grants access to the [Followers API](/v3/users/followers/). Can be one of: `none`, `read`, or `write`. | -| [`gpg_keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-gpg-keys) | Grants access to the [GPG Keys API](/v3/users/gpg_keys/). Can be one of: `none`, `read`, or `write`. | -| [`issues`](/rest/reference/permissions-required-for-github-apps/#permission-on-issues) | Grants access to the [Issues API](/v3/issues/). Can be one of: `none`, `read`, or `write`. | -| [`keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-keys) | Grants access to the [Public Keys API](/v3/users/keys/). Can be one of: `none`, `read`, or `write`. | +| [`checks`](/rest/reference/permissions-required-for-github-apps/#permission-on-checks) | Grants access to the [Checks API](/v3/checks/). Can be one of: `none`, `read`, or `write`. | +| `content_references` | Grants access to the "[Create a content attachment](/v3/apps/installations/#create-a-content-attachment)" endpoint. Can be one of: `none`, `read`, or `write`. | +| [`contents`](/rest/reference/permissions-required-for-github-apps/#permission-on-contents) | Grants access to various endpoints that allow you to modify repository contents. Can be one of: `none`, `read`, or `write`. | +| [`deployments`](/rest/reference/permissions-required-for-github-apps/#permission-on-deployments) | Grants access to the [Deployments API](/rest/reference/repos#deployments). Can be one of: `none`, `read`, or `write`. | +| [`emails`](/rest/reference/permissions-required-for-github-apps/#permission-on-emails) | Grants access to the [Emails API](/v3/users/emails/). Can be one of: `none`, `read`, or `write`. | +| [`followers`](/rest/reference/permissions-required-for-github-apps/#permission-on-followers) | Grants access to the [Followers API](/v3/users/followers/). Can be one of: `none`, `read`, or `write`. | +| [`gpg_keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-gpg-keys) | Grants access to the [GPG Keys API](/v3/users/gpg_keys/). Can be one of: `none`, `read`, or `write`. | +| [`issues`](/rest/reference/permissions-required-for-github-apps/#permission-on-issues) | Grants access to the [Issues API](/v3/issues/). Can be one of: `none`, `read`, or `write`. | +| [`keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-keys) | Grants access to the [Public Keys API](/v3/users/keys/). Can be one of: `none`, `read`, or `write`. | | [`members`](/rest/reference/permissions-required-for-github-apps/#permission-on-members) | Grants access to manage an organization's members. Can be one of: `none`, `read`, or `write`.{% if currentVersion == "free-pro-team@latest" %} -| [`метаданные`](/rest/reference/permissions-required-for-github-apps/#metadata-permissions) | Grants access to read-only endpoints that do not leak sensitive data. Can be `read` or `none`. Defaults to `read` when you set any permission, or defaults to `none` when you don't specify any permissions for the {% data variables.product.prodname_github_app %}. | +| [`метаданные`](/rest/reference/permissions-required-for-github-apps/#metadata-permissions) | Grants access to read-only endpoints that do not leak sensitive data. Can be `read` or `none`. Defaults to `read` when you set any permission, or defaults to `none` when you don't specify any permissions for the {% data variables.product.prodname_github_app %}. | | [`organization_administration`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-administration) | Grants access to "[Update an organization](/v3/orgs/#update-an-organization)" endpoint and the [Organization Interaction Restrictions API](/v3/interactions/orgs/#set-interaction-restrictions-for-an-organization). Can be one of: `none`, `read`, or `write`.{% endif %} -| [`organization_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-hooks) | Grants access to the [Organization Webhooks API](/v3/orgs/hooks/). Can be one of: `none`, `read`, or `write`. | -| `organization_plan` | Grants access to get information about an organization's plan using the "[Get an organization](/v3/orgs/#get-an-organization)" endpoint. Can be one of: `none` or `read`. | +| [`organization_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-hooks) | Grants access to the [Organization Webhooks API](/rest/reference/orgs#webhooks/). Can be one of: `none`, `read`, or `write`. | +| `organization_plan` | Grants access to get information about an organization's plan using the "[Get an organization](/v3/orgs/#get-an-organization)" endpoint. Can be one of: `none` or `read`. | | [`organization_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects) | Grants access to the [Projects API](/v3/projects/). Can be one of: `none`, `read`, `write`, or `admin`.{% if currentVersion == "free-pro-team@latest" %} | [`organization_user_blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects) | Grants access to the [Blocking Organization Users API](/v3/orgs/blocking/). Can be one of: `none`, `read`, or `write`.{% endif %} -| [`pages`](/rest/reference/permissions-required-for-github-apps/#permission-on-pages) | Grants access to the [Pages API](/v3/repos/pages/). Can be one of: `none`, `read`, or `write`. | -| `plan` | Grants access to get information about a user's GitHub plan using the "[Get a user](/v3/users/#get-a-user)" endpoint. Can be one of: `none` or `read`. | -| [`pull_requests`](/rest/reference/permissions-required-for-github-apps/#permission-on-pull-requests) | Grants access to various pull request endpoints. Can be one of: `none`, `read`, or `write`. | -| [`repository_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-hooks) | Grants access to the [Repository Webhooks API](/v3/repos/hooks/). Can be one of: `none`, `read`, or `write`. | -| [`repository_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-projects) | Grants access to the [Projects API](/v3/projects/). Can be one of: `none`, `read`, `write`, or `admin`. | -| [`single_file`](/rest/reference/permissions-required-for-github-apps/#permission-on-single-file) | Grants access to the [Contents API](/v3/repos/contents/). Can be one of: `none`, `read`, or `write`. | -| [`starring`](/rest/reference/permissions-required-for-github-apps/#permission-on-starring) | Grants access to the [Starring API](/v3/activity/starring/). Can be one of: `none`, `read`, or `write`. | -| [`statuses`](/rest/reference/permissions-required-for-github-apps/#permission-on-statuses) | Grants access to the [Statuses API](/v3/repos/statuses/). Can be one of: `none`, `read`, or `write`. | -| [`team_discussions`](/rest/reference/permissions-required-for-github-apps/#permission-on-team-discussions) | Grants access to the [Team Discussions API](/v3/teams/discussions/) and the [Team Discussion Comments API](/v3/teams/discussion_comments/). Can be one of: `none`, `read`, or `write`. | -| `vulnerability_alerts` | Grants access to receive security alerts for vulnerable dependencies in a repository. See "[About security alerts for vulnerable dependencies](/articles/about-security-alerts-for-vulnerable-dependencies)" to learn more. Can be one of: `none` or `read`. | -| `наблюдение` | Grants access to list and change repositories a user is subscribed to. Can be one of: `none`, `read`, or `write`. | +| [`pages`](/rest/reference/permissions-required-for-github-apps/#permission-on-pages) | Grants access to the [Pages API](/rest/reference/repos#pages). Can be one of: `none`, `read`, or `write`. | +| `plan` | Grants access to get information about a user's GitHub plan using the "[Get a user](/v3/users/#get-a-user)" endpoint. Can be one of: `none` or `read`. | +| [`pull_requests`](/rest/reference/permissions-required-for-github-apps/#permission-on-pull-requests) | Grants access to various pull request endpoints. Can be one of: `none`, `read`, or `write`. | +| [`repository_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-hooks) | Grants access to the [Repository Webhooks API](/v3/repos/hooks/). Can be one of: `none`, `read`, or `write`. | +| [`repository_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-projects) | Grants access to the [Projects API](/v3/projects/). Can be one of: `none`, `read`, `write`, or `admin`. | +| [`single_file`](/rest/reference/permissions-required-for-github-apps/#permission-on-single-file) | Grants access to the [Contents API](/v3/repos/contents/). Can be one of: `none`, `read`, or `write`. | +| [`starring`](/rest/reference/permissions-required-for-github-apps/#permission-on-starring) | Grants access to the [Starring API](/v3/activity/starring/). Can be one of: `none`, `read`, or `write`. | +| [`statuses`](/rest/reference/permissions-required-for-github-apps/#permission-on-statuses) | Grants access to the [Statuses API](/v3/repos/statuses/). Can be one of: `none`, `read`, or `write`. | +| [`team_discussions`](/rest/reference/permissions-required-for-github-apps/#permission-on-team-discussions) | Grants access to the [Team Discussions API](/v3/teams/discussions/) and the [Team Discussion Comments API](/v3/teams/discussion_comments/). Can be one of: `none`, `read`, or `write`. | +| `vulnerability_alerts` | Grants access to receive security alerts for vulnerable dependencies in a repository. See "[About security alerts for vulnerable dependencies](/articles/about-security-alerts-for-vulnerable-dependencies)" to learn more. Can be one of: `none` or `read`. | +| `наблюдение` | Grants access to list and change repositories a user is subscribed to. Can be one of: `none`, `read`, or `write`. | ### {% data variables.product.prodname_github_app %} webhook events -| Webhook event name | Required permission | Description | -| -------------------------------------------------------------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------ | -| [`check_run`](/webhooks/event-payloads/#check_run) | `checks` | {% data reusables.webhooks.check_run_short_desc %} | -| [`check_suite`](/webhooks/event-payloads/#check_suite) | `checks` | {% data reusables.webhooks.check_suite_short_desc %} | -| [`commit_comment`](/webhooks/event-payloads/#commit_comment) | `contents` | {% data reusables.webhooks.commit_comment_short_desc %} | -| [`content_reference`](/webhooks/event-payloads/#content_reference) | `content_references` | {% data reusables.webhooks.content_reference_short_desc %} | -| [`create`](/webhooks/event-payloads/#create) | `contents` | {% data reusables.webhooks.create_short_desc %} | -| [`delete - Удалить`](/webhooks/event-payloads/#delete) | `contents` | {% data reusables.webhooks.delete_short_desc %} | -| [`deployment`](/webhooks/event-payloads/#deployment) | `deployments` | {% data reusables.webhooks.deployment_short_desc %} | -| [`deployment_status`](/webhooks/event-payloads/#deployment_status) | `deployments` | {% data reusables.webhooks.deployment_status_short_desc %} | -| [`ветвление`](/webhooks/event-payloads/#fork) | `contents` | {% data reusables.webhooks.fork_short_desc %} | -| [`gollum`](/webhooks/event-payloads/#gollum) | `contents` | {% data reusables.webhooks.gollum_short_desc %} | -| [`issues`](/webhooks/event-payloads/#issues) | `issues` | {% data reusables.webhooks.issues_short_desc %} | -| [`issue_comment`](/webhooks/event-payloads/#issue_comment) | `issues` | {% data reusables.webhooks.issue_comment_short_desc %} | -| [`метка`](/webhooks/event-payloads/#label) | `метаданные` | {% data reusables.webhooks.label_short_desc %} | -| [`участник`](/webhooks/event-payloads/#member) | `members` | {% data reusables.webhooks.member_short_desc %} | -| [`membership`](/webhooks/event-payloads/#membership) | `members` | {% data reusables.webhooks.membership_short_desc %} | +| Webhook event name | Required permission | Description | +| -------------------------------------------------------------------------------------- | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------- | +| [`check_run`](/webhooks/event-payloads/#check_run) | `checks` | {% data reusables.webhooks.check_run_short_desc %} +| [`check_suite`](/webhooks/event-payloads/#check_suite) | `checks` | {% data reusables.webhooks.check_suite_short_desc %} +| [`commit_comment`](/webhooks/event-payloads/#commit_comment) | `contents` | {% data reusables.webhooks.commit_comment_short_desc %} +| [`content_reference`](/webhooks/event-payloads/#content_reference) | `content_references` | {% data reusables.webhooks.content_reference_short_desc %} +| [`create`](/webhooks/event-payloads/#create) | `contents` | {% data reusables.webhooks.create_short_desc %} +| [`delete - Удалить`](/webhooks/event-payloads/#delete) | `contents` | {% data reusables.webhooks.delete_short_desc %} +| [`deployment`](/webhooks/event-payloads/#deployment) | `deployments` | {% data reusables.webhooks.deployment_short_desc %} +| [`deployment_status`](/webhooks/event-payloads/#deployment_status) | `deployments` | {% data reusables.webhooks.deployment_status_short_desc %} +| [`ветвление`](/webhooks/event-payloads/#fork) | `contents` | {% data reusables.webhooks.fork_short_desc %} +| [`gollum`](/webhooks/event-payloads/#gollum) | `contents` | {% data reusables.webhooks.gollum_short_desc %} +| [`issues`](/webhooks/event-payloads/#issues) | `issues` | {% data reusables.webhooks.issues_short_desc %} +| [`issue_comment`](/webhooks/event-payloads/#issue_comment) | `issues` | {% data reusables.webhooks.issue_comment_short_desc %} +| [`метка`](/webhooks/event-payloads/#label) | `метаданные` | {% data reusables.webhooks.label_short_desc %} +| [`участник`](/webhooks/event-payloads/#member) | `members` | {% data reusables.webhooks.member_short_desc %} +| [`membership`](/webhooks/event-payloads/#membership) | `members` | {% data reusables.webhooks.membership_short_desc %} | [`контрольная точка`](/webhooks/event-payloads/#milestone) | `pull_request` | {% data reusables.webhooks.milestone_short_desc %}{% if currentVersion == "free-pro-team@latest" %} | [`org_block`](/webhooks/event-payloads/#org_block) | `organization_administration` | {% data reusables.webhooks.org_block_short_desc %}{% endif %} -| [`организация`](/webhooks/event-payloads/#organization) | `members` | {% data reusables.webhooks.organization_short_desc %} | -| [`page_build`](/webhooks/event-payloads/#page_build) | `pages` | {% data reusables.webhooks.page_build_short_desc %} | -| [`проект`](/webhooks/event-payloads/#project) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_short_desc %} | -| [`project_card`](/webhooks/event-payloads/#project_card) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_card_short_desc %} | -| [`project_column`](/webhooks/event-payloads/#project_column) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_column_short_desc %} | -| [`public`](/webhooks/event-payloads/#public) | `метаданные` | {% data reusables.webhooks.public_short_desc %} | -| [`pull_request`](/webhooks/event-payloads/#pull_request) | `pull_requests` | {% data reusables.webhooks.pull_request_short_desc %} | -| [`pull_request_review`](/webhooks/event-payloads/#pull_request_review) | `pull_request` | {% data reusables.webhooks.pull_request_review_short_desc %} | -| [`pull_request_review_comment`](/webhooks/event-payloads/#pull_request_review_comment) | `pull_request` | {% data reusables.webhooks.pull_request_review_comment_short_desc %} | -| [`запись`](/webhooks/event-payloads/#push) | `contents` | {% data reusables.webhooks.push_short_desc %} | -| [`релиз`](/webhooks/event-payloads/#release) | `contents` | {% data reusables.webhooks.release_short_desc %} | +| [`организация`](/webhooks/event-payloads/#organization) | `members` | {% data reusables.webhooks.organization_short_desc %} +| [`page_build`](/webhooks/event-payloads/#page_build) | `pages` | {% data reusables.webhooks.page_build_short_desc %} +| [`проект`](/webhooks/event-payloads/#project) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_short_desc %} +| [`project_card`](/webhooks/event-payloads/#project_card) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_card_short_desc %} +| [`project_column`](/webhooks/event-payloads/#project_column) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_column_short_desc %} +| [`public`](/webhooks/event-payloads/#public) | `метаданные` | {% data reusables.webhooks.public_short_desc %} +| [`pull_request`](/webhooks/event-payloads/#pull_request) | `pull_requests` | {% data reusables.webhooks.pull_request_short_desc %} +| [`pull_request_review`](/webhooks/event-payloads/#pull_request_review) | `pull_request` | {% data reusables.webhooks.pull_request_review_short_desc %} +| [`pull_request_review_comment`](/webhooks/event-payloads/#pull_request_review_comment) | `pull_request` | {% data reusables.webhooks.pull_request_review_comment_short_desc %} +| [`отправка`](/webhooks/event-payloads/#push) | `contents` | {% data reusables.webhooks.push_short_desc %} +| [`версия`](/webhooks/event-payloads/#release) | `contents` | {% data reusables.webhooks.release_short_desc %} | [`репозиторий`](/webhooks/event-payloads/#repository) | `метаданные` | {% data reusables.webhooks.repository_short_desc %}{% if currentVersion == "free-pro-team@latest"%} | [`repository_dispatch`](/webhooks/event-payloads/#repository_dispatch) | `contents` | Allows integrators using GitHub Actions to trigger custom events.{% endif %} -| [`состояние`](/webhooks/event-payloads/#status) | `statuses` | {% data reusables.webhooks.status_short_desc %} | -| [`команда`](/webhooks/event-payloads/#team) | `members` | {% data reusables.webhooks.team_short_desc %} | -| [`team_add`](/webhooks/event-payloads/#team_add) | `members` | {% data reusables.webhooks.team_add_short_desc %} | -| [`слежение`](/webhooks/event-payloads/#watch) | `метаданные` | {% data reusables.webhooks.watch_short_desc %} | +| [`состояние`](/webhooks/event-payloads/#status) | `statuses` | {% data reusables.webhooks.status_short_desc %} +| [`команда`](/webhooks/event-payloads/#team) | `members` | {% data reusables.webhooks.team_short_desc %} +| [`team_add`](/webhooks/event-payloads/#team_add) | `members` | {% data reusables.webhooks.team_add_short_desc %} +| [`слежение`](/webhooks/event-payloads/#watch) | `метаданные` | {% data reusables.webhooks.watch_short_desc %} diff --git a/translations/ru-RU/content/developers/apps/creating-ci-tests-with-the-checks-api.md b/translations/ru-RU/content/developers/apps/creating-ci-tests-with-the-checks-api.md index edc741b31c43..252f841f72bc 100644 --- a/translations/ru-RU/content/developers/apps/creating-ci-tests-with-the-checks-api.md +++ b/translations/ru-RU/content/developers/apps/creating-ci-tests-with-the-checks-api.md @@ -9,7 +9,6 @@ versions: --- - ### Introduction This guide will introduce you to [Github Apps](/apps/) and the [Checks API](/v3/checks/), which you'll use to build a continuous integration (CI) server that runs tests. @@ -134,6 +133,27 @@ The `requested` action requests a check run each time code is pushed to the repo You'll add this new method as a [Sinatra helper](https://github.com/sinatra/sinatra#helpers) in case you want other routes to use it too. Under `helpers do`, add this `create_check_run` method: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +``` ruby +# Create a new check run with the status queued +def create_check_run + # # At the time of writing, Octokit does not support the Checks API yet, but + # it does provide generic HTTP methods you can use: + # /v3/checks/runs/#create-a-check-run + check_run = @installation_client.post( + "repos/#{@payload['repository']['full_name']}/check-runs", + { + # This header allows for beta access to Checks API + accept: 'application/vnd.github.antiope-preview+json', + # The name of your check run. + name: 'Octo RuboCop', + # The payload structure differs depending on whether a check run or a check suite event occurred. + head_sha: @payload['check_run'].nil? ? @payload['check_suite']['head_sha'] : @payload['check_run']['head_sha'] + } + ) +end +``` +{% else %} ``` ruby # Create a new check run with the status queued def create_check_run @@ -153,6 +173,7 @@ def create_check_run ) end ``` +{% endif %} This code calls the "[Create a check run](/v3/checks/runs/#create-a-check-run)" endpoint using the generic [HTTP `POST` method](http://octokit.github.io/octokit.rb/Octokit/Connection.html#post-instance_method). This method takes two parameters: the URL of the endpoint and the input parameters to the method. @@ -209,6 +230,43 @@ In this section, you're not going to kick off the CI test yet, but you'll walk t Let's create the `initiate_check_run` method and update the status of the check run. Add the following code to the helpers section: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +``` ruby +# Start the CI process +def initiate_check_run + # Once the check run is created, you'll update the status of the check run + # to 'in_progress' and run the CI process. When the CI finishes, you'll + # update the check run status to 'completed' and add the CI results. + + # Octokit doesn't yet support the Checks API, but it does provide generic + # HTTP methods you can use: + # /v3/checks/runs/#update-a-check-run + updated_check_run = @installation_client.patch( + "repos/#{@payload['repository']['full_name']}/check-runs/#{@payload['check_run']['id']}", + { + accept: 'application/vnd.github.v3+json', + name: 'Octo RuboCop', + status: 'in_progress', + started_at: Time.now.utc.iso8601 + } + ) + + # ***** RUN A CI TEST ***** + + # Mark the check run as complete! + updated_check_run = @installation_client.patch( + "repos/#{@payload['repository']['full_name']}/check-runs/#{@payload['check_run']['id']}", + { + accept: 'application/vnd.github.v3+json', + name: 'Octo RuboCop', + status: 'completed', + conclusion: 'success', + completed_at: Time.now.utc.iso8601 + } + ) +end +``` +{% else %} ``` ruby # Start the CI process def initiate_check_run @@ -245,6 +303,7 @@ def initiate_check_run ) end ``` +{% endif %} The code above calls the "[Update a check run](/v3/checks/runs/#update-a-check-run)" API endpoint using the generic [`patch` HTTP method](http://octokit.github.io/octokit.rb/Octokit/Connection.html#patch-instance_method) to update the check run that you already created. @@ -549,6 +608,21 @@ text = "Octo RuboCop version: #{@output['metadata']['rubocop_version']}" Now you've got all the information you need to update your check run. In the [first half of this quickstart](#step-14-updating-a-check-run), you added this code to set the status of the check run to `success`: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +``` ruby +# Mark the check run as complete! +updated_check_run = @installation_client.patch( + "repos/#{@payload['repository']['full_name']}/check-runs/#{@payload['check_run']['id']}", + { + accept: 'application/vnd.github.v3+json', + name: 'Octo RuboCop', + status: 'completed', + conclusion: 'success', + completed_at: Time.now.utc.iso8601 + } +) +``` +{% else %} ``` ruby # Mark the check run as complete! updated_check_run = @installation_client.patch( @@ -562,9 +636,36 @@ updated_check_run = @installation_client.patch( } ) ``` +{% endif %} You'll need to update that code to use the `conclusion` variable you set based on the RuboCop results (to `success` or `neutral`). You can update the code with the following: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +``` ruby +# Mark the check run as complete! And if there are warnings, share them. +updated_check_run = @installation_client.patch( + "repos/#{@payload['repository']['full_name']}/check-runs/#{@payload['check_run']['id']}", + { + accept: 'application/vnd.github.v3+json', + name: 'Octo RuboCop', + status: 'completed', + conclusion: conclusion, + completed_at: Time.now.utc.iso8601, + output: { + title: 'Octo RuboCop', + summary: summary, + text: text, + annotations: annotations + }, + actions: [{ + label: 'Fix this', + description: 'Automatically fix all linter notices.', + identifier: 'fix_rubocop_notices' + }] + } +) +``` +{% else %} ``` ruby # Mark the check run as complete! And if there are warnings, share them. updated_check_run = @installation_client.patch( @@ -589,6 +690,7 @@ updated_check_run = @installation_client.patch( } ) ``` +{% endif %} Now that you're setting a conclusion based on the status of the CI test and you've added the output from the RuboCop results, you've created a CI test! Congratulations. 🙌 diff --git a/translations/ru-RU/content/developers/apps/differences-between-github-apps-and-oauth-apps.md b/translations/ru-RU/content/developers/apps/differences-between-github-apps-and-oauth-apps.md index e15c3c47dcb0..6e644c244c3e 100644 --- a/translations/ru-RU/content/developers/apps/differences-between-github-apps-and-oauth-apps.md +++ b/translations/ru-RU/content/developers/apps/differences-between-github-apps-and-oauth-apps.md @@ -50,13 +50,13 @@ An _authorized_ OAuth App has access to all of the user's or organization owner' {% endnote %} -| GitHub Apps | OAuth Apps | -| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| A GitHub App can request an installation access token by using a private key with a JSON web token format out-of-band. | An OAuth app can exchange a request token for an access token after a redirect via a web request. | -| An installation token identifies the app as the GitHub Apps bot, such as @jenkins-bot. | An access token identifies the app as the user who granted the token to the app, such as @octocat. | -| Installation tokens expire after a predefined amount of time (currently 1 hour). | OAuth tokens remain active until they're revoked by the customer. | -| {% data reusables.apps.api-rate-limits-non-ghec %}{% if currentVersion == "free-pro-team@latest" %} Higher rate limits apply for {% data variables.product.prodname_ghe_cloud %}. For more information, see "[Rate limits for GitHub Apps](/developers/apps/rate-limits-for-github-apps)."{% endif %} | OAuth tokens use the user's rate limit of 5,000 requests per hour. | -| Rate limit increases can be granted both at the GitHub Apps level (affecting all installations) and at the individual installation level. | Rate limit increases are granted per OAuth App. Every token granted to that OAuth App gets the increased limit. |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} +| GitHub Apps | OAuth Apps | +| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| A GitHub App can request an installation access token by using a private key with a JSON web token format out-of-band. | An OAuth app can exchange a request token for an access token after a redirect via a web request. | +| An installation token identifies the app as the GitHub Apps bot, such as @jenkins-bot. | An access token identifies the app as the user who granted the token to the app, such as @octocat. | +| Installation tokens expire after a predefined amount of time (currently 1 hour). | OAuth tokens remain active until they're revoked by the customer. | +| {% data reusables.apps.api-rate-limits-non-ghec %}{% if currentVersion == "free-pro-team@latest" %} Higher rate limits apply for {% data variables.product.prodname_ghe_cloud %}. For more information, see "[Rate limits for GitHub Apps](/developers/apps/rate-limits-for-github-apps)."{% endif %} | OAuth tokens use the user's rate limit of 5,000 requests per hour. | +| Rate limit increases can be granted both at the GitHub Apps level (affecting all installations) and at the individual installation level. | Rate limit increases are granted per OAuth App. Every token granted to that OAuth App gets the increased limit. |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} | {% data variables.product.prodname_github_app %}s can authenticate on behalf of the user, which is called user-to-server requests. The flow to authorize is the same as the OAuth App authorization flow. User-to-server tokens can expire and be renewed with a refresh token. For more information, see "[Refreshing user-to-server access tokens](/apps/building-github-apps/refreshing-user-to-server-access-tokens/)" and "[Identifying and authorizing users for GitHub Apps](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/)." | The OAuth flow used by {% data variables.product.prodname_oauth_app %}s authorizes an {% data variables.product.prodname_oauth_app %} on behalf of the user. This is the same flow used in {% data variables.product.prodname_github_app %} user-to-server authorization. |{% endif %} ### Requesting permission levels for resources @@ -102,5 +102,5 @@ Bot accounts are specific to GitHub Apps and are built into every GitHub App. | GitHub Apps | OAuth Apps | | --------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | -| GitHub App bots do not consume a {% data variables.product.prodname_enterprise %} seat. | A machine user account consumes a {% data variables.product.prodname_enterprise %} seat. | +| GitHub App bots do not consume a {% data variables.product.prodname_enterprise %} seat. | A machine user account consumes a {% data variables.product.prodname_enterprise %} seat. | | Because a GitHub App bot is never granted a password, a customer can't sign into it directly. | A machine user account is granted a username and password to be managed and secured by the customer. | diff --git a/translations/ru-RU/content/developers/apps/editing-a-github-apps-permissions.md b/translations/ru-RU/content/developers/apps/editing-a-github-apps-permissions.md index 5526135a4641..acbef5efe59f 100644 --- a/translations/ru-RU/content/developers/apps/editing-a-github-apps-permissions.md +++ b/translations/ru-RU/content/developers/apps/editing-a-github-apps-permissions.md @@ -9,6 +9,8 @@ versions: enterprise-server: '*' --- +{% note %} + **Note:** Updated permissions won't take effect on an installation until the owner of the account or organization approves the changes. You can use the [InstallationEvent webhook](/webhooks/event-payloads/#installation) to find out when people accept new permissions for your app. One exception is [user-level permissions](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/#user-level-permissions), which don't require the account owner to approve permission changes. {% endnote %} diff --git a/translations/ru-RU/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md b/translations/ru-RU/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md index 6c812b48a061..c7e2917bddd8 100644 --- a/translations/ru-RU/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md +++ b/translations/ru-RU/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md @@ -226,7 +226,7 @@ While most of your API interaction should occur using your server-to-server inst * [List check runs in a check suite](/v3/checks/runs/#list-check-runs-in-a-check-suite) * [List check runs for a Git reference](/v3/checks/runs/#list-check-runs-for-a-git-reference) -##### Проверить модули +##### Проверить пакеты * [Create a check suite](/v3/checks/suites/#create-a-check-suite) * [Get a check suite](/v3/checks/suites/#get-a-check-suite) @@ -241,25 +241,25 @@ While most of your API interaction should occur using your server-to-server inst ##### Deployment Statuses -* [List deployment statuses](/v3/repos/deployments/#list-deployment-statuses) -* [Create a deployment status](/v3/repos/deployments/#create-a-deployment-status) -* [Get a deployment status](/v3/repos/deployments/#get-a-deployment-status) +* [List deployment statuses](/rest/reference/repos#list-deployment-statuses) +* [Create a deployment status](/rest/reference/repos#create-a-deployment-status) +* [Get a deployment status](/rest/reference/repos#get-a-deployment-status) ##### Deployments -* [List deployments](/v3/repos/deployments/#list-deployments) -* [Create a deployment](/v3/repos/deployments/#create-a-deployment) -* [Get a deployment](/v3/repos/deployments/#get-a-deployment){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -* [Delete a deployment](/v3/repos/deployments/#delete-a-deployment){% endif %} +* [List deployments](/rest/reference/repos#list-deployments) +* [Create a deployment](/rest/reference/repos#create-a-deployment) +* [Get a deployment](/rest/reference/repos#get-a-deployment){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +* [Delete a deployment](/rest/reference/repos#delete-a-deployment){% endif %} ##### События -* [List public events for a network of repositories](/v3/activity/events/#list-public-events-for-a-network-of-repositories) -* [List public organization events](/v3/activity/events/#list-public-organization-events) +* [List public events for a network of repositories](/rest/reference/activity#list-public-events-for-a-network-of-repositories) +* [List public organization events](/rest/reference/activity#list-public-organization-events) ##### Feeds -* [Get feeds](/v3/activity/feeds/#get-feeds) +* [Get feeds](/rest/reference/activity#get-feeds) ##### Git Blobs @@ -273,11 +273,8 @@ While most of your API interaction should occur using your server-to-server inst ##### Git Refs -* [Create a reference](/v3/git/refs/#create-a-reference){% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -* [List references](/v3/git/refs/#list-references) -* [Get a reference](/v3/git/refs/#get-a-reference){% else %} -* [Get a reference](/v3/git/refs/#get-a-reference) -* [List matching references](/v3/git/refs/#list-matching-references){% endif %} +* [Create a reference](/v3/git/refs/#create-a-reference)* [Get a reference](/v3/git/refs/#get-a-reference) +* [List matching references](/v3/git/refs/#list-matching-references) * [Update a reference](/v3/git/refs/#update-a-reference) * [Delete a reference](/v3/git/refs/#delete-a-reference) @@ -391,12 +388,12 @@ While most of your API interaction should occur using your server-to-server inst ##### Organization Hooks -* [List organization webhooks](/v3/orgs/hooks/#list-organization-webhooks) -* [Create an organization webhook](/v3/orgs/hooks/#create-an-organization-webhook) -* [Get an organization webhook](/v3/orgs/hooks/#get-an-organization-webhook) -* [Update an organization webhook](/v3/orgs/hooks/#update-an-organization-webhook) -* [Delete an organization webhook](/v3/orgs/hooks/#delete-an-organization-webhook) -* [Ping an organization webhook](/v3/orgs/hooks/#ping-an-organization-webhook) +* [List organization webhooks](/rest/reference/orgs#webhooks/#list-organization-webhooks) +* [Create an organization webhook](/rest/reference/orgs#webhooks/#create-an-organization-webhook) +* [Get an organization webhook](/rest/reference/orgs#webhooks/#get-an-organization-webhook) +* [Update an organization webhook](/rest/reference/orgs#webhooks/#update-an-organization-webhook) +* [Delete an organization webhook](/rest/reference/orgs#webhooks/#delete-an-organization-webhook) +* [Ping an organization webhook](/rest/reference/orgs#webhooks/#ping-an-organization-webhook) {% if currentVersion == "free-pro-team@latest" %} ##### Organization Invitations @@ -619,7 +616,7 @@ While most of your API interaction should occur using your server-to-server inst * [Delete a repository](/v3/repos/#delete-a-repository) * [Compare two commits](/v3/repos/commits/#compare-two-commits) * [List repository contributors](/v3/repos/#list-repository-contributors) -* [List forks](/v3/repos/forks/#list-forks) +* [List forks](/rest/reference/repos#list-forks) * [Create a fork](/v3/repos/forks/#create-a-fork) * [List repository languages](/v3/repos/#list-repository-languages) * [List repository tags](/v3/repos/#list-repository-tags) @@ -632,13 +629,13 @@ While most of your API interaction should occur using your server-to-server inst ##### Repository Activity -* [List stargazers](/v3/activity/starring/#list-stargazers) -* [List watchers](/v3/activity/watching/#list-watchers) -* [List repositories starred by a user](/v3/activity/starring/#list-repositories-starred-by-a-user) -* [Check if a repository is starred by the authenticated user](/v3/activity/starring/#check-if-a-repository-is-starred-by-the-authenticated-user) -* [Star a repository for the authenticated user](/v3/activity/starring/#star-a-repository-for-the-authenticated-user) -* [Unstar a repository for the authenticated user](/v3/activity/starring/#unstar-a-repository-for-the-authenticated-user) -* [List repositories watched by a user](/v3/activity/watching/#list-repositories-watched-by-a-user) +* [List stargazers](/rest/reference/activity#list-stargazers) +* [List watchers](/rest/reference/activity#list-watchers) +* [List repositories starred by a user](/rest/reference/activity#list-repositories-starred-by-a-user) +* [Check if a repository is starred by the authenticated user](/rest/reference/activity#check-if-a-repository-is-starred-by-the-authenticated-user) +* [Star a repository for the authenticated user](/rest/reference/activity#star-a-repository-for-the-authenticated-user) +* [Unstar a repository for the authenticated user](/rest/reference/activity#unstar-a-repository-for-the-authenticated-user) +* [List repositories watched by a user](/rest/reference/activity#list-repositories-watched-by-a-user) {% if currentVersion == "free-pro-team@latest" %} ##### Repository Automated Security Fixes @@ -756,14 +753,14 @@ While most of your API interaction should occur using your server-to-server inst ##### Repository Pages -* [Get a GitHub Pages site](/v3/repos/pages/#get-a-github-pages-site) -* [Create a GitHub Pages site](/v3/repos/pages/#create-a-github-pages-site) -* [Update information about a GitHub Pages site](/v3/repos/pages/#update-information-about-a-github-pages-site) -* [Delete a GitHub Pages site](/v3/repos/pages/#delete-a-github-pages-site) -* [List GitHub Pages builds](/v3/repos/pages/#list-github-pages-builds) -* [Request a GitHub Pages build](/v3/repos/pages/#request-a-github-pages-build) -* [Get GitHub Pages build](/v3/repos/pages/#get-github-pages-build) -* [Get latest pages build](/v3/repos/pages/#get-latest-pages-build) +* [Get a GitHub Pages site](/rest/reference/repos#get-a-github-pages-site) +* [Create a GitHub Pages site](/rest/reference/repos#create-a-github-pages-site) +* [Update information about a GitHub Pages site](/rest/reference/repos#update-information-about-a-github-pages-site) +* [Delete a GitHub Pages site](/rest/reference/repos#delete-a-github-pages-site) +* [List GitHub Pages builds](/rest/reference/repos#list-github-pages-builds) +* [Request a GitHub Pages build](/rest/reference/repos#request-a-github-pages-build) +* [Get GitHub Pages build](/rest/reference/repos#get-github-pages-build) +* [Get latest pages build](/rest/reference/repos#get-latest-pages-build) {% if currentVersion != "free-pro-team@latest" %} ##### Repository Pre Receive Hooks @@ -776,17 +773,17 @@ While most of your API interaction should occur using your server-to-server inst ##### Repository Releases -* [List releases](/v3/repos/releases/#list-releases) -* [Create a release](/v3/repos/releases/#create-a-release) -* [Get a release](/v3/repos/releases/#get-a-release) -* [Update a release](/v3/repos/releases/#update-a-release) -* [Delete a release](/v3/repos/releases/#delete-a-release) -* [List release assets](/v3/repos/releases/#list-release-assets) -* [Get a release asset](/v3/repos/releases/#get-a-release-asset) -* [Update a release asset](/v3/repos/releases/#update-a-release-asset) -* [Delete a release asset](/v3/repos/releases/#delete-a-release-asset) -* [Get the latest release](/v3/repos/releases/#get-the-latest-release) -* [Get a release by tag name](/v3/repos/releases/#get-a-release-by-tag-name) +* [List releases](/rest/reference/repos/#list-releases) +* [Create a release](/rest/reference/repos/#create-a-release) +* [Get a release](/rest/reference/repos/#get-a-release) +* [Update a release](/rest/reference/repos/#update-a-release) +* [Delete a release](/rest/reference/repos/#delete-a-release) +* [List release assets](/rest/reference/repos/#list-release-assets) +* [Get a release asset](/rest/reference/repos/#get-a-release-asset) +* [Update a release asset](/rest/reference/repos/#update-a-release-asset) +* [Delete a release asset](/rest/reference/repos/#delete-a-release-asset) +* [Get the latest release](/rest/reference/repos/#get-the-latest-release) +* [Get a release by tag name](/rest/reference/repos/#get-a-release-by-tag-name) ##### Repository Stats diff --git a/translations/ru-RU/content/developers/apps/migrating-oauth-apps-to-github-apps.md b/translations/ru-RU/content/developers/apps/migrating-oauth-apps-to-github-apps.md index 25665c6ae9a1..bdedaa66f9a4 100644 --- a/translations/ru-RU/content/developers/apps/migrating-oauth-apps-to-github-apps.md +++ b/translations/ru-RU/content/developers/apps/migrating-oauth-apps-to-github-apps.md @@ -11,7 +11,6 @@ versions: This article provides guidelines for existing integrators who are considering migrating from an OAuth App to a GitHub App. - ### Reasons for switching to GitHub Apps [GitHub Apps](/apps/) are the officially recommended way to integrate with GitHub because they offer many advantages over a pure OAuth-based integration: diff --git a/translations/ru-RU/content/developers/apps/modifying-an-oauth-app.md b/translations/ru-RU/content/developers/apps/modifying-an-oauth-app.md index 869475ce85bd..3e45db618208 100644 --- a/translations/ru-RU/content/developers/apps/modifying-an-oauth-app.md +++ b/translations/ru-RU/content/developers/apps/modifying-an-oauth-app.md @@ -9,12 +9,10 @@ versions: enterprise-server: '*' --- - - - {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.oauth_apps %} {% data reusables.user-settings.modify_oauth_app %} -5. Modify the {% data variables.product.prodname_oauth_app %} information that you'd like to change. +1. Modify the +{% data variables.product.prodname_oauth_app %} information that you'd like to change. {% data reusables.user-settings.update_oauth_app %} diff --git a/translations/ru-RU/content/developers/apps/refreshing-user-to-server-access-tokens.md b/translations/ru-RU/content/developers/apps/refreshing-user-to-server-access-tokens.md index 6d82cb10607d..658332f02352 100644 --- a/translations/ru-RU/content/developers/apps/refreshing-user-to-server-access-tokens.md +++ b/translations/ru-RU/content/developers/apps/refreshing-user-to-server-access-tokens.md @@ -28,10 +28,10 @@ This callback request will send you a new access token and a new refresh token. #### Parameters -| Name | Тип | Description | -| --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Name | Тип | Description | +| --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `refresh_token` | `строка` | **Required.** The token generated when the {% data variables.product.prodname_github_app %} owner enables expiring tokens and issues a new user access token. | -| `grant_type` | `строка` | **Required.** Value must be `refresh_token` (required by the OAuth specification). | +| `grant_type` | `строка` | **Required.** Value must be `refresh_token` (required by the OAuth specification). | | `client_id` | `строка` | **Required.** The client ID for your {% data variables.product.prodname_github_app %}. | | `client_secret` | `строка` | **Required.** The client secret for your {% data variables.product.prodname_github_app %}. | diff --git a/translations/ru-RU/content/developers/apps/scopes-for-oauth-apps.md b/translations/ru-RU/content/developers/apps/scopes-for-oauth-apps.md index eea901f9c29a..447de3165ecc 100644 --- a/translations/ru-RU/content/developers/apps/scopes-for-oauth-apps.md +++ b/translations/ru-RU/content/developers/apps/scopes-for-oauth-apps.md @@ -19,7 +19,8 @@ When setting up an OAuth App on GitHub, requested scopes are displayed to the us {% endnote %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -If your {% data variables.product.prodname_oauth_app %} doesn't have access to a browser, such as a CLI tool, then you don't need to specify a scope for users to authenticate to your app. For more information, see "[Authorizing OAuth apps](/developers/apps/authorizing-oauth-apps#device-flow)." +If your +{% data variables.product.prodname_oauth_app %} doesn't have access to a browser, such as a CLI tool, then you don't need to specify a scope for users to authenticate to your app. For more information, see "[Authorizing OAuth apps](/developers/apps/authorizing-oauth-apps#device-flow)." {% endif %} Check headers to see what OAuth scopes you have, and what the API action accepts: @@ -65,8 +66,8 @@ X-Accepted-OAuth-Scopes: user | **`delete_repo`** | Grants access to delete adminable repositories. | | **`write:discussion`** | Allows read and write access for team discussions. | |  `read:discussion` | Allows read access for team discussions.{% if currentVersion == "free-pro-team@latest" %} -| **`write:packages`** | Grants access to upload or publish a package in {% data variables.product.prodname_registry %}. For more information, see "[Publishing a package](/github/managing-packages-with-github-packages/publishing-a-package)". | -| **`read:packages`** | Grants access to download or install packages from {% data variables.product.prodname_registry %}. For more information, see "[Installing a package](/github/managing-packages-with-github-packages/installing-a-package)". | +| **`write:packages`** | Grants access to upload or publish a package in {% data variables.product.prodname_registry %}. For more information, see "[Publishing a package](/github/managing-packages-with-github-packages/publishing-a-package)". | +| **`read:packages`** | Grants access to download or install packages from {% data variables.product.prodname_registry %}. For more information, see "[Installing a package](/github/managing-packages-with-github-packages/installing-a-package)". | | **`delete:packages`** | Grants access to delete packages from {% data variables.product.prodname_registry %}. For more information, see "[Deleting packages](/github/managing-packages-with-github-packages/deleting-a-package)".{% endif %} | **`admin:gpg_key`** | Fully manage GPG keys. | |  `write:gpg_key` | Create, list, and view details for GPG keys. | diff --git a/translations/ru-RU/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md b/translations/ru-RU/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md index 087823dfa787..615a2e81bc3b 100644 --- a/translations/ru-RU/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md +++ b/translations/ru-RU/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md @@ -9,7 +9,6 @@ versions: --- - ### Introduction This guide will walk through the steps needed to configure a GitHub App and run it on a server. GitHub Apps require some setup steps to manage webhook events and connect the app registration on GitHub to your code. The app in this guide serves as a foundation that you can use to extend and build new GitHub Apps. diff --git a/translations/ru-RU/content/developers/apps/suspending-a-github-app-installation.md b/translations/ru-RU/content/developers/apps/suspending-a-github-app-installation.md index e964d827d9ae..caf739366085 100644 --- a/translations/ru-RU/content/developers/apps/suspending-a-github-app-installation.md +++ b/translations/ru-RU/content/developers/apps/suspending-a-github-app-installation.md @@ -17,13 +17,15 @@ versions: ### Suspending a GitHub App -To suspend a {% data variables.product.prodname_github_app %}, you must be an account owner or have admin permissions in the repository or organization where the app you want to suspend is installed. +The integrator who owns and maintains a GitHub app, also called a GitHub App owner, can suspend or unsuspend a GitHub App installation using REST API endpoints with a JWT. For more information, see the [GitHub Apps REST API](/rest/reference/apps). -You can also suspend and unsuspend {% data variables.product.prodname_github_app %} installations using the REST API. For more information, see the [GitHub Apps REST API](/v3/apps/). +People who have installed a GitHub App, also called installation owners, can only suspend or unsuspend a GitHub App through their app's installation settings. Installation owners cannot use the API to suspend or unsuspend their app installation. Before people can suspend a GitHub app installation, the GitHub App owner must opt-in to the beta release. For more information, see "[Suspending a GitHub App installation](/apps/managing-github-apps/suspending-a-github-app-installation/)." {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.github_apps %} -4. Select the {% data variables.product.prodname_github_app %} you want to suspend. ![App selection](/assets/images/github-apps/github_apps_select-app.png) +4. Select the +{% data variables.product.prodname_github_app %} you want to suspend. +![App selection](/assets/images/github-apps/github_apps_select-app.png) {% data reusables.user-settings.github_apps_advanced %} 6. Next to the suspension settings for the installation, click **Suspend** or **Unsuspend**. ![Suspend a GitHub App](/assets/images/github-apps/suspend-a-github-app.png) diff --git a/translations/ru-RU/content/developers/apps/using-the-github-api-in-your-app.md b/translations/ru-RU/content/developers/apps/using-the-github-api-in-your-app.md index fbd41da9b52f..69a55fb7cf72 100644 --- a/translations/ru-RU/content/developers/apps/using-the-github-api-in-your-app.md +++ b/translations/ru-RU/content/developers/apps/using-the-github-api-in-your-app.md @@ -10,7 +10,6 @@ versions: --- - ### Introduction This guide will help you build a GitHub App and run it on a server. The app you build will add a label to all new issues opened in the repository where the app is installed. diff --git a/translations/ru-RU/content/developers/github-marketplace/drafting-a-listing-for-your-app.md b/translations/ru-RU/content/developers/github-marketplace/drafting-a-listing-for-your-app.md index 0da8b2f8d741..7bc6b6e54221 100644 --- a/translations/ru-RU/content/developers/github-marketplace/drafting-a-listing-for-your-app.md +++ b/translations/ru-RU/content/developers/github-marketplace/drafting-a-listing-for-your-app.md @@ -40,7 +40,10 @@ To create a {% data variables.product.prodname_marketplace %} listing: ![App type selection](/assets/images/settings/apps_choose_app.png) -4. Select the app you'd like to add to {% data variables.product.prodname_marketplace %}. ![App selection for {% data variables.product.prodname_marketplace %} listing](/assets/images/github-apps/github_apps_select-app.png) +4. Select the app you'd like to add to + +{% data variables.product.prodname_marketplace %}. +![App selection for {% data variables.product.prodname_marketplace %} listing](/assets/images/github-apps/github_apps_select-app.png) {% data reusables.user-settings.edit_marketplace_listing %} 5. Once you've created a new draft listing, you'll see an overview of the sections that you'll need to visit before your {% data variables.product.prodname_marketplace %} listing will be complete. ![GitHub Marketplace listing](/assets/images/marketplace/marketplace_listing_overview.png) diff --git a/translations/ru-RU/content/developers/github-marketplace/viewing-metrics-for-your-listing.md b/translations/ru-RU/content/developers/github-marketplace/viewing-metrics-for-your-listing.md index fe55776d9baa..045237bda979 100644 --- a/translations/ru-RU/content/developers/github-marketplace/viewing-metrics-for-your-listing.md +++ b/translations/ru-RU/content/developers/github-marketplace/viewing-metrics-for-your-listing.md @@ -47,7 +47,8 @@ To access {% data variables.product.prodname_marketplace %} Insights: {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.marketplace_apps %} -4. Select the {% data variables.product.prodname_github_app %} that you'd like to view Insights for. +4. Select the +{% data variables.product.prodname_github_app %} that you'd like to view Insights for. {% data reusables.user-settings.edit_marketplace_listing %} 6. Click the **Insights** tab. 7. Optionally, select a different time period by clicking the Period dropdown in the upper-right corner of the Insights page. ![Marketplace time period](/assets/images/marketplace/marketplace_insights_time_period.png) diff --git a/translations/ru-RU/content/developers/github-marketplace/viewing-transactions-for-your-listing.md b/translations/ru-RU/content/developers/github-marketplace/viewing-transactions-for-your-listing.md index 5f87adff43f0..15ede21ee304 100644 --- a/translations/ru-RU/content/developers/github-marketplace/viewing-transactions-for-your-listing.md +++ b/translations/ru-RU/content/developers/github-marketplace/viewing-transactions-for-your-listing.md @@ -39,7 +39,8 @@ To access {% data variables.product.prodname_marketplace %} transactions: {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.marketplace_apps %} -4. Select the {% data variables.product.prodname_github_app %} that you'd like to view transactions for. +4. Select the +{% data variables.product.prodname_github_app %} that you'd like to view transactions for. {% data reusables.user-settings.edit_marketplace_listing %} 6. Click the **Transactions** tab. 7. Optionally, select a different time period by clicking the Period dropdown in the upper-right corner of the Transactions page. ![Marketplace time period](/assets/images/marketplace/marketplace_insights_time_period.png) diff --git a/translations/ru-RU/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md b/translations/ru-RU/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md index 864e4a73803d..7044feab2b43 100644 --- a/translations/ru-RU/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md +++ b/translations/ru-RU/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md @@ -27,18 +27,18 @@ Each `marketplace_purchase` webhook payload will have the following information: | `действие` | `строка` | The action performed to generate the webhook. Can be `purchased`, `cancelled`, `pending_change`, `pending_change_cancelled`, or `changed`. For more information, see the example webhook payloads below. **Note:** The `pending_change` and `pending_change_cancelled` payloads contain the same keys as shown in the [`changed` payload example](#example-webhook-payload-for-a-changed-event). | | `effective_date` | `строка` | The date the `action` becomes effective. | | `sender` | `объект` | The person who took the `action` that triggered the webhook. | -| `marketplace_purchase` | `объект` | The {% data variables.product.prodname_marketplace %} purchase information. | +| `marketplace_purchase` | `объект` | The {% data variables.product.prodname_marketplace %} purchase information. | The `marketplace_purchase` object has the following keys: | Клавиша | Тип | Description | | -------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `учетная запись` | `объект` | The `organization` or `user` account associated with the subscription. Organization accounts will include `organization_billing_email`, which is the organization's administrative email address. To find email addresses for personal accounts, you can use the [Get the authenticated user](/v3/users/#get-the-authenticated-user) endpoint. | -| `billing_cycle` | `строка` | Can be `yearly` or `monthly`. When the `account` owner has a free GitHub plan and has purchased a free {% data variables.product.prodname_marketplace %} plan, `billing_cycle` will be `nil`. | +| `billing_cycle` | `строка` | Can be `yearly` or `monthly`. When the `account` owner has a free GitHub plan and has purchased a free {% data variables.product.prodname_marketplace %} plan, `billing_cycle` will be `nil`. | | `unit_count` | `integer` | Number of units purchased. | | `on_free_trial` | `boolean` | `true` when the `account` is on a free trial. | | `free_trial_ends_on` | `строка` | The date the free trial will expire. | -| `next_billing_date` | `строка` | The date that the next billing cycle will start. When the `account` owner has a free GitHub.com plan and has purchased a free {% data variables.product.prodname_marketplace %} plan, `next_billing_date` will be `nil`. | +| `next_billing_date` | `строка` | The date that the next billing cycle will start. When the `account` owner has a free GitHub.com plan and has purchased a free {% data variables.product.prodname_marketplace %} plan, `next_billing_date` will be `nil`. | | `plan` | `объект` | The plan purchased by the `user` or `organization`. | The `plan` object has the following keys: diff --git a/translations/ru-RU/content/developers/overview/managing-deploy-keys.md b/translations/ru-RU/content/developers/overview/managing-deploy-keys.md index 82e3325cf07e..fcc5d295232a 100644 --- a/translations/ru-RU/content/developers/overview/managing-deploy-keys.md +++ b/translations/ru-RU/content/developers/overview/managing-deploy-keys.md @@ -10,7 +10,6 @@ versions: --- - You can manage SSH keys on your servers when automating deployment scripts using SSH agent forwarding, HTTPS with OAuth tokens, deploy keys, or machine users. ### SSH agent forwarding diff --git a/translations/ru-RU/content/developers/overview/replacing-github-services.md b/translations/ru-RU/content/developers/overview/replacing-github-services.md index 13ea935a867a..eb1925fc9e60 100644 --- a/translations/ru-RU/content/developers/overview/replacing-github-services.md +++ b/translations/ru-RU/content/developers/overview/replacing-github-services.md @@ -19,7 +19,6 @@ As an alternative to the email service, you can now start using email notificati {% endnote %} - ### Deprecation timeline - **October 1, 2018**: GitHub discontinued allowing users to install services. We removed GitHub Services from the GitHub.com user interface. diff --git a/translations/ru-RU/content/developers/overview/using-ssh-agent-forwarding.md b/translations/ru-RU/content/developers/overview/using-ssh-agent-forwarding.md index bf7f696feeff..aa7d8c9e59e7 100644 --- a/translations/ru-RU/content/developers/overview/using-ssh-agent-forwarding.md +++ b/translations/ru-RU/content/developers/overview/using-ssh-agent-forwarding.md @@ -93,7 +93,7 @@ Sometimes, system configurations disallow SSH agent forwarding. You can check if ```shell $ ssh -v example.com # Connect to example.com with verbose debug output -> OpenSSH_5.6p1, OpenSSL 0.9.8r 8 Feb 2011 +> OpenSSH_8.1p1, LibreSSL 2.7.3 > debug1: Reading configuration data /Users/you/.ssh/config > debug1: Applying options for example.com > debug1: Reading configuration data /etc/ssh_config diff --git a/translations/ru-RU/content/developers/webhooks-and-events/about-webhooks.md b/translations/ru-RU/content/developers/webhooks-and-events/about-webhooks.md index 780eb4f494da..10abb1ffae54 100644 --- a/translations/ru-RU/content/developers/webhooks-and-events/about-webhooks.md +++ b/translations/ru-RU/content/developers/webhooks-and-events/about-webhooks.md @@ -9,10 +9,9 @@ versions: --- - Webhooks allow you to build or set up integrations, such as [{% data variables.product.prodname_github_app %}s](/apps/building-github-apps/) or [{% data variables.product.prodname_oauth_app %}s](/apps/building-oauth-apps/), which subscribe to certain events on GitHub.com. When one of those events is triggered, we'll send a HTTP POST payload to the webhook's configured URL. Webhooks can be used to update an external issue tracker, trigger CI builds, update a backup mirror, or even deploy to your production server. You're only limited by your imagination. -Webhooks can be installed on{% if currentVersion != "free-pro-team@latest" %} a [{% data variables.product.prodname_ghe_server %} instance](/v3/enterprise-admin/global_webhooks/),{% endif %} an [organization][org-hooks], a specific [repository][repo-hooks], or a {% data variables.product.prodname_github_app %}. Once installed, the webhook will be sent each time one or more subscribed events occurs. +Webhooks can be installed on{% if currentVersion != "free-pro-team@latest" %} a [{% data variables.product.prodname_ghe_server %} instance](/rest/reference/enterprise-admin#global-webhooks/),{% endif %} an [organization][org-hooks], a specific [repository][repo-hooks], or a {% data variables.product.prodname_github_app %}. Once installed, the webhook will be sent each time one or more subscribed events occurs. You can create up to {% if currentVersion != "free-pro-team@latest" %}250{% else %}20{% endif %} webhooks for each event on each installation target {% if currentVersion != "free-pro-team@latest" %}({% data variables.product.prodname_ghe_server %} instance, specific organization, or specific repository).{% else %}(specific organization or specific repository).{% endif %} @@ -30,5 +29,5 @@ See "[Webhook event payloads](/webhooks/event-payloads)" for the list of availab For more information about the `ping` event webhook payload, see the [`ping`](/webhooks/event-payloads/#ping) event. -[org-hooks]: /v3/orgs/hooks/ +[org-hooks]: /rest/reference/orgs#webhooks/ [repo-hooks]: /v3/repos/hooks/ diff --git a/translations/ru-RU/content/developers/webhooks-and-events/github-event-types.md b/translations/ru-RU/content/developers/webhooks-and-events/github-event-types.md index e8f1af25a2d3..9793b91b7296 100644 --- a/translations/ru-RU/content/developers/webhooks-and-events/github-event-types.md +++ b/translations/ru-RU/content/developers/webhooks-and-events/github-event-types.md @@ -16,7 +16,6 @@ The Events API can return different types of events triggered by activity on Git {% endif %} - ### Event object common properties The event objects returned from the Events API endpoints have the same structure. diff --git a/translations/ru-RU/content/developers/webhooks-and-events/issue-event-types.md b/translations/ru-RU/content/developers/webhooks-and-events/issue-event-types.md index 81b155f836ce..1881dc8a9312 100644 --- a/translations/ru-RU/content/developers/webhooks-and-events/issue-event-types.md +++ b/translations/ru-RU/content/developers/webhooks-and-events/issue-event-types.md @@ -11,7 +11,6 @@ versions: Issue events are triggered by activity in issues and pull requests and are available in the [Issue Events API](/v3/issues/events) and the [Timeline Events API](/v3/issues/timeline). Each event type specifies whether the event is available in the Issue Events or Timeline Events APIs. - GitHub's REST API considers every pull request to be an issue, but not every issue is a pull request. For this reason, the Issue Events and Timeline Events endpoints may return both issues and pull requests in the response. Pull requests have a `pull_request` property in the `issue` object. Because pull requests are issues, issue and pull request numbers do not overlap in a repository. For example, if you open your first issue in a repository, the number will be 1. If you then open a pull request, the number will be 2. Each event type specifies if the event occurs in pull request, issues, or both. ### Issue event object common properties diff --git a/translations/ru-RU/content/developers/webhooks-and-events/securing-your-webhooks.md b/translations/ru-RU/content/developers/webhooks-and-events/securing-your-webhooks.md index 7f135f37bdae..0a5ed843591b 100644 --- a/translations/ru-RU/content/developers/webhooks-and-events/securing-your-webhooks.md +++ b/translations/ru-RU/content/developers/webhooks-and-events/securing-your-webhooks.md @@ -33,9 +33,17 @@ $ export SECRET_TOKEN=your_token ### Validating payloads from GitHub -When your secret token is set, GitHub uses it to create a hash signature with each payload. +When your secret token is set, {% data variables.product.product_name %} uses it to create a hash signature with each payload. This hash signature is included with the headers of each request as {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %}`X-Hub-Signature-256`{% else if currentVersion ver_lt "enterprise-server@2.23" %}`X-Hub-Signature`{% endif %}. -This hash signature is passed along with each request in the headers as `X-Hub-Signature`. Suppose you have a basic server listening to webhooks that looks like this: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %} +{% note %} + +**Note:** For backward-compatibility, we also include the `X-Hub-Signature` header that is generated using the SHA-1 hash function. If possible, we recommend that you use the `X-Hub-Signature-256` header for improved security. The example below demonstrate using the `X-Hub-Signature-256` header. + +{% endnote %} +{% endif %} + +For example, if you have a basic server that listens for webhooks, it might be configured similar to this: ``` ruby require 'sinatra' @@ -47,7 +55,7 @@ post '/payload' do end ``` -The goal is to compute a hash using your `SECRET_TOKEN`, and ensure that the hash from GitHub matches. GitHub uses an HMAC hexdigest to compute the hash, so you could change your server to look a little like this: +The intention is to calculate a hash using your `SECRET_TOKEN`, and ensure that the result matches the hash from {% data variables.product.product_name %}. {% data variables.product.product_name %} uses an HMAC hex digest to compute the hash, so you could reconfigure your server to look a little like this: ``` ruby post '/payload' do @@ -58,16 +66,21 @@ post '/payload' do "I got some JSON: #{push.inspect}" end +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %} +def verify_signature(payload_body) + signature = 'sha256=' + OpenSSL::HMAC.hexdigest(OpenSSL::Digest.new('sha256'), ENV['SECRET_TOKEN'], payload_body) + return halt 500, "Signatures didn't match!" unless Rack::Utils.secure_compare(signature, request.env['HTTP_X_HUB_SIGNATURE_2']) +end{% else if currentVersion ver_lt "enterprise-server@2.23" %} def verify_signature(payload_body) signature = 'sha1=' + OpenSSL::HMAC.hexdigest(OpenSSL::Digest.new('sha1'), ENV['SECRET_TOKEN'], payload_body) return halt 500, "Signatures didn't match!" unless Rack::Utils.secure_compare(signature, request.env['HTTP_X_HUB_SIGNATURE']) -end +end{% endif %} ``` -Obviously, your language and server implementations may differ than this code. There are a couple of very important things to point out, however: +Your language and server implementations may differ from this example code. However, there are a number of very important things to point out: -* No matter which implementation you use, the hash signature starts with `sha1=`, using the key of your secret token and your payload body. +* No matter which implementation you use, the hash signature starts with {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or "private-instances@latest" %}`sha256=`{% else if currentVersion ver_lt "enterprise-server@2.23" %}`sha1=`{% endif %}, using the key of your secret token and your payload body. -* Using a plain `==` operator is **not advised**. A method like [`secure_compare`][secure_compare] performs a "constant time" string comparison, which renders it safe from certain timing attacks against regular equality operators. +* Using a plain `==` operator is **not advised**. A method like [`secure_compare`][secure_compare] performs a "constant time" string comparison, which helps mitigate certain timing attacks against regular equality operators. [secure_compare]: http://rubydoc.info/github/rack/rack/master/Rack/Utils.secure_compare diff --git a/translations/ru-RU/content/developers/webhooks-and-events/testing-webhooks.md b/translations/ru-RU/content/developers/webhooks-and-events/testing-webhooks.md index d58d672aa61a..459c8bc69b0b 100644 --- a/translations/ru-RU/content/developers/webhooks-and-events/testing-webhooks.md +++ b/translations/ru-RU/content/developers/webhooks-and-events/testing-webhooks.md @@ -9,7 +9,6 @@ versions: --- - Now that you've [configured your local server](/webhooks/configuring/), you might be interested in pushing your code to the limits. To that end, GitHub's webhooks view provides some tooling for testing your deployed payloads. ### Listing recent deliveries diff --git a/translations/ru-RU/content/developers/webhooks-and-events/webhook-events-and-payloads.md b/translations/ru-RU/content/developers/webhooks-and-events/webhook-events-and-payloads.md index 5d49909321b4..c565738cd419 100644 --- a/translations/ru-RU/content/developers/webhooks-and-events/webhook-events-and-payloads.md +++ b/translations/ru-RU/content/developers/webhooks-and-events/webhook-events-and-payloads.md @@ -20,7 +20,6 @@ versions: You can create webhooks that subscribe to the events listed on this page. Each webhook event includes a description of the webhook properties and an example payload. For more information, see "[Creating webhooks](/webhooks/creating/)." - ### Webhook payload object common properties Each webhook event payload also contains properties unique to the event. You can find the unique properties in the individual event type sections. @@ -28,11 +27,8 @@ Each webhook event payload also contains properties unique to the event. You can | Клавиша | Тип | Description | | ---------- | -------- | ---------------------------------------------------------------------------------------------------------------- | | `действие` | `строка` | Most webhook payloads contain an `action` property that contains the specific activity that triggered the event. | - {% data reusables.webhooks.sender_desc %} This property is included in every webhook payload. -{% data reusables.webhooks.repo_desc %} Webhook payloads contain the - -`repository` property when the event occurs from activity in a repository. +{% data reusables.webhooks.repo_desc %} Webhook payloads contain the `repository` property when the event occurs from activity in a repository. {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} For more information, see "[Building {% data variables.product.prodname_github_app %}](/apps/building-github-apps/)." @@ -48,13 +44,14 @@ The unique properties for a webhook event are the same properties you'll find in HTTP POST payloads that are delivered to your webhook's configured URL endpoint will contain several special headers: -| Header | Description | -| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `X-GitHub-Event` | Name of the event that triggered the delivery. | +| Header | Description | +| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `X-GitHub-Event` | Name of the event that triggered the delivery. | | `X-GitHub-Delivery` | A [GUID](http://en.wikipedia.org/wiki/Globally_unique_identifier) to identify the delivery.{% if currentVersion != "free-pro-team@latest" %} -| `X-GitHub-Enterprise-Version` | The version of the {% data variables.product.prodname_ghe_server %} instance that sent the HTTP POST payload. | -| `X-GitHub-Enterprise-Host` | The hostname of the {% data variables.product.prodname_ghe_server %} instance that sent the HTTP POST payload.{% endif %} -| `X-Hub-Signature` | The HMAC hex digest of the response body. This header will be sent if the webhook is configured with a [`secret`](/v3/repos/hooks/#create-hook-config-params). The HMAC hex digest is generated using the `sha1` hash function and the `secret` as the HMAC `key`. | +| `X-GitHub-Enterprise-Version` | The version of the {% data variables.product.prodname_ghe_server %} instance that sent the HTTP POST payload. | +| `X-GitHub-Enterprise-Host` | The hostname of the {% data variables.product.prodname_ghe_server %} instance that sent the HTTP POST payload.{% endif %}{% if currentVersion != "private-instances@latest" %} +| `X-Hub-Signature` | This header is sent if the webhook is configured with a [`secret`](/v3/repos/hooks/#create-hook-config-params). This is the HMAC hex digest of the request body, and is generated using the SHA-1 hash function and the `secret` as the HMAC `key`.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} `X-Hub-Signature` is provided for compatibility with existing integrations, and we recommend that you use the more secure `X-Hub-Signature-256` instead.{% endif %}{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %} +| `X-Hub-Signature-256` | This header is sent if the webhook is configured with a [`secret`](/v3/repos/hooks/#create-hook-config-params). This is the HMAC hex digest of the request body, and is generated using the SHA-256 hash function and the `secret` as the HMAC `key`.{% endif %} Also, the `User-Agent` for the requests will have the prefix `GitHub-Hookshot/`. @@ -66,8 +63,9 @@ Also, the `User-Agent` for the requests will have the prefix `GitHub-Hookshot/`. > Host: localhost:4567 > X-GitHub-Delivery: 72d3162e-cc78-11e3-81ab-4c9367dc0958{% if currentVersion != "free-pro-team@latest" %} > X-GitHub-Enterprise-Version: 2.15.0 -> X-GitHub-Enterprise-Host: example.com{% endif %} -> X-Hub-Signature: sha1=7d38cdd689735b008b3c702edd92eea23791c5f6 +> X-GitHub-Enterprise-Host: example.com{% endif %}{% if currentVersion != "private-instances@latest" %} +> X-Hub-Signature: sha1=7d38cdd689735b008b3c702edd92eea23791c5f6{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %} +> X-Hub-Signature-256: sha256=d57c68ca6f92289e6987922ff26938930f6e66a2d161ef06abdf1859230aa23c{% endif %} > User-Agent: GitHub-Hookshot/044aadd > Content-Type: application/json > Content-Length: 6615 @@ -292,10 +290,10 @@ Only {% data variables.product.prodname_github_app %}s can receive this event. { #### Webhook payload object -| Клавиша | Тип | Description | -| ------------ | --------------------------------------------------------------- | ---------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -| `действие` | `строка` | The action performed. Can be `created`.{% endif %} -| `deployment` | `объект` | The [deployment](/v3/repos/deployments/#list-deployments). | +| Клавиша | Тип | Description | +| ------------ | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +| `действие` | `строка` | The action performed. Can be `created`.{% endif %} +| `deployment` | `объект` | The [deployment](/rest/reference/repos#list-deployments). | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} @@ -317,14 +315,14 @@ Only {% data variables.product.prodname_github_app %}s can receive this event. { #### Webhook payload object -| Клавиша | Тип | Description | -| ---------------------------------- | --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -| `действие` | `строка` | The action performed. Can be `created`.{% endif %} -| `deployment_status` | `объект` | The [deployment status](/v3/repos/deployments/#list-deployment-statuses). | -| `deployment_status["state"]` | `строка` | The new state. Can be `pending`, `success`, `failure`, or `error`. | -| `deployment_status["target_url"]` | `строка` | The optional link added to the status. | -| `deployment_status["description"]` | `строка` | The optional human-readable description added to the status. | -| `deployment` | `объект` | The [deployment](/v3/repos/deployments/#list-deployments) that this status is associated with. | +| Клавиша | Тип | Description | +| ---------------------------------- | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +| `действие` | `строка` | The action performed. Can be `created`.{% endif %} +| `deployment_status` | `объект` | The [deployment status](/rest/reference/repos#list-deployment-statuses). | +| `deployment_status["state"]` | `строка` | The new state. Can be `pending`, `success`, `failure`, or `error`. | +| `deployment_status["target_url"]` | `строка` | The optional link added to the status. | +| `deployment_status["description"]` | `строка` | The optional human-readable description added to the status. | +| `deployment` | `объект` | The [deployment](/rest/reference/repos#list-deployments) that this status is associated with. | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} @@ -336,7 +334,7 @@ Only {% data variables.product.prodname_github_app %}s can receive this event. { {% if currentVersion != "free-pro-team@latest" %} -### предприятие +### корпоративный {% data reusables.webhooks.enterprise_short_desc %} @@ -628,11 +626,11 @@ The webhook this event is configured on was deleted. This event will only listen #### Webhook payload object -| Клавиша | Тип | Description | -| ---------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `действие` | `строка` | The action performed. Can be `deleted`. | -| `hook_id` | `integer` | The id of the modified webhook. | -| `хук` | `объект` | The modified webhook. This will contain different keys based on the type of webhook it is: repository, organization, business, app, or GitHub Marketplace. | +| Клавиша | Тип | Description | +| ------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `действие` | `строка` | The action performed. Can be `deleted`. | +| `hook_id` | `integer` | The id of the modified webhook. | +| `перехватчик` | `объект` | The modified webhook. This will contain different keys based on the type of webhook it is: repository, organization, business, app, or GitHub Marketplace. | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.sender_desc %} @@ -676,11 +674,11 @@ The webhook this event is configured on was deleted. This event will only listen #### Webhook payload object -| Клавиша | Тип | Description | -| ------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Клавиша | Тип | Description | +| ------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `действие` | `строка` | The action that was performed. Can be one of:{% if currentVersion != "free-pro-team@latest" %} `created`,{% endif %} `deleted`, `renamed`, `member_added`, `member_removed`, or `member_invited`. | -| `приглашение` | `объект` | The invitation for the user or email if the action is `member_invited`. | -| `membership` | `объект` | The membership between the user and the organization. Not present when the action is `member_invited`. | +| `приглашение` | `объект` | The invitation for the user or email if the action is `member_invited`. | +| `membership` | `объект` | The membership between the user and the organization. Not present when the action is `member_invited`. | {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} @@ -772,11 +770,11 @@ Activity related to {% data variables.product.prodname_registry %}. {% data reus #### Webhook payload object -| Клавиша | Тип | Description | -| -------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `zen` | `строка` | Random string of GitHub zen. | -| `hook_id` | `integer` | The ID of the webhook that triggered the ping. | -| `хук` | `объект` | The [webhook configuration](/v3/repos/hooks/#get-a-repository-webhook). | +| Клавиша | Тип | Description | +| -------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `zen` | `строка` | Random string of GitHub zen. | +| `hook_id` | `integer` | The ID of the webhook that triggered the ping. | +| `перехватчик` | `объект` | The [webhook configuration](/v3/repos/hooks/#get-a-repository-webhook). | | `hook[app_id]` | `integer` | When you register a new {% data variables.product.prodname_github_app %}, {% data variables.product.product_name %} sends a ping event to the **webhook URL** you specified during registration. The event contains the `app_id`, which is required for [authenticating](/apps/building-integrations/setting-up-and-registering-github-apps/about-authentication-options-for-github-apps/) an app. | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} @@ -946,7 +944,7 @@ Deliveries for `review_requested` and `review_request_removed` events will have {{ webhookPayloadsForCurrentVersion.pull_request_review_comment.created }} -### запись +### отправка {% data reusables.webhooks.push_short_desc %} @@ -993,7 +991,7 @@ Deliveries for `review_requested` and `review_request_removed` events will have {{ webhookPayloadsForCurrentVersion.push }} -### релиз +### версия {% data reusables.webhooks.release_short_desc %} @@ -1299,7 +1297,6 @@ This event occurs when someone triggers a workflow run on GitHub or sends a `POS {{ webhookPayloadsForCurrentVersion.workflow_dispatch }} {% endif %} - ### workflow_run When a {% data variables.product.prodname_actions %} workflow run is requested or completed. For more information, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows#workflow_run)." diff --git a/translations/ru-RU/content/github/administering-a-repository/about-branch-restrictions.md b/translations/ru-RU/content/github/administering-a-repository/about-branch-restrictions.md index 337eadb5b928..63273df0fa16 100644 --- a/translations/ru-RU/content/github/administering-a-repository/about-branch-restrictions.md +++ b/translations/ru-RU/content/github/administering-a-repository/about-branch-restrictions.md @@ -9,15 +9,15 @@ versions: enterprise-server: '*' --- -When you enable branch restrictions, only users{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %} or{% endif %} teams{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, or apps{% endif %} that have been given permission can push to the protected branch. For more information, see "[Enabling branch restrictions](/articles/enabling-branch-restrictions)" and "[About protected branches](/articles/about-protected-branches)." You can view and edit the users{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %} or{% endif %} teams{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, or apps{% endif %} with push access to a protected branch in the protected branch's settings. +When you enable branch restrictions, only users, teams, or apps that have been given permission can push to the protected branch. For more information, see "[Enabling branch restrictions](/articles/enabling-branch-restrictions)" and "[About protected branches](/articles/about-protected-branches)." You can view and edit the users, teams, or apps with push access to a protected branch in the protected branch's settings. -You can only give push access to a protected branch to users{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %} or{% endif %} teams{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, or installed {% data variables.product.prodname_github_apps %}{% endif %} with `write` access to a repository. +You can only give push access to a protected branch to users, teams, or installed {% data variables.product.prodname_github_apps %} with `write` access to a repository. -People{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} and apps{% endif %} with admin permissions to a repository are always able to push to a protected branch. +People and apps with admin permissions to a repository are always able to push to a protected branch. {% tip %} -**Note:** If "Include administrators" is selected, you've enabled required status checks on the branch, and if any status checks fail, any attempt to push changes to the protected branch will also fail, even for people{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} and apps{% endif %} with admin permissions. For more information, see "[Enabling required status checks](/articles/enabling-required-status-checks)." +**Note:** If "Include administrators" is selected, you've enabled required status checks on the branch, and if any status checks fail, any attempt to push changes to the protected branch will also fail, even for people and apps with admin permissions. For more information, see "[Enabling required status checks](/articles/enabling-required-status-checks)." {% endtip %} diff --git a/translations/ru-RU/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md b/translations/ru-RU/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md index 400c95e47e05..0ec56a12dd0b 100644 --- a/translations/ru-RU/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md +++ b/translations/ru-RU/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md @@ -33,8 +33,7 @@ You can filter email notifications you receive for pushes to a repository. For m {% data reusables.repositories.sidebar-notifications %} 5. Type up to two email addresses, separated by whitespace, where you'd like notifications to be sent. If you'd like to send emails to more than two accounts, set one of the email addresses to a group email address. ![Email address textbox](/assets/images/help/settings/email_services_addresses.png) 6. If you operate your own server, you can verify the integrity of emails via the **Secret** token. This token is sent with the email as the `Approved` header. If the `Approved` header matches the token you sent, you can trust that the email is from {% data variables.product.product_name %}. ![Email secret textbox](/assets/images/help/settings/email_services_token.png) -7. Optionally, select **Send from author** to have emails delivered using the committer's email address. Otherwise, emails are sent from {% data variables.notifications.no_reply_address %}. ![Email author checkbox](/assets/images/help/settings/email_services_author.png) -8. Click **Save settings**. ![Save settings button](/assets/images/help/settings/save_notification_settings.png) +7. Click **Save settings**. ![Save settings button](/assets/images/help/settings/save_notification_settings.png) ### Дополнительная литература {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} diff --git a/translations/ru-RU/content/github/administering-a-repository/about-github-dependabot-version-updates.md b/translations/ru-RU/content/github/administering-a-repository/about-github-dependabot-version-updates.md index 65e929fc82d2..617d1c7778a6 100644 --- a/translations/ru-RU/content/github/administering-a-repository/about-github-dependabot-version-updates.md +++ b/translations/ru-RU/content/github/administering-a-repository/about-github-dependabot-version-updates.md @@ -13,7 +13,9 @@ versions: {% data variables.product.prodname_dependabot %} takes the effort out of maintaining your dependencies. You can use it to ensure that your repository automatically keeps up with the latest releases of the packages and applications it depends on. -You enable {% data variables.product.prodname_dependabot_version_updates %} by checking a configuration file in to your repository. The configuration file specifies the location of the manifest, or other package definition files, stored in your repository. {% data variables.product.prodname_dependabot_short %} uses this information to check for outdated packages and applications. {% data variables.product.prodname_dependabot_short %} determines if there is a new version of a dependency by looking at the semantic versioning ([semver](https://semver.org/)) of the dependency to decide whether it should update to that version. When {% data variables.product.prodname_dependabot_short %} identifies an outdated dependency, it raises a pull request to update the manifest to the latest version of the dependency. You check that your tests pass, review the changelog and release notes included in the pull request summary, and then merge it. For more information, see "[Enabling and disabling version updates](/github/administering-a-repository/enabling-and-disabling-version-updates)." +You enable {% data variables.product.prodname_dependabot_version_updates %} by checking a configuration file in to your repository. The configuration file specifies the location of the manifest, or other package definition files, stored in your repository. {% data variables.product.prodname_dependabot_short %} uses this information to check for outdated packages and applications. {% data variables.product.prodname_dependabot_short %} determines if there is a new version of a dependency by looking at the semantic versioning ([semver](https://semver.org/)) of the dependency to decide whether it should update to that version. For certain package managers, {% data variables.product.prodname_dependabot_version_updates %} also supports vendoring. Vendored (or cached) dependencies are dependencies that are checked in to a specific directory in a repository, rather than referenced in a manifest. Vendored dependencies are available at build time even if package servers are unavailable. {% data variables.product.prodname_dependabot_version_updates %} can be configured to check vendored dependencies for new versions and update them if necessary. + +When {% data variables.product.prodname_dependabot_short %} identifies an outdated dependency, it raises a pull request to update the manifest to the latest version of the dependency. For vendored dependencies, {% data variables.product.prodname_dependabot_short %} raises a pull request to directly replace the outdated dependency with the new version. You check that your tests pass, review the changelog and release notes included in the pull request summary, and then merge it. For more information, see "[Enabling and disabling version updates](/github/administering-a-repository/enabling-and-disabling-version-updates)." If you enable security updates, {% data variables.product.prodname_dependabot %} also raises pull requests to update vulnerable dependencies. For more information, see "[Configuring {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)." @@ -35,7 +37,7 @@ If you've enabled security updates, you'll sometimes see extra pull requests for {% endnote %} -You can configure version updates for repositories that contain a dependency manifest or lock file for one of the supported package managers. +You can configure version updates for repositories that contain a dependency manifest or lock file for one of the supported package managers. For some package managers, you can also configure vendoring for dependencies. For more information, see "[Configuration options for dependency updates](/github/administering-a-repository/configuration-options-for-dependency-updates#vendor)." {% data reusables.dependabot.supported-package-managers %} diff --git a/translations/ru-RU/content/github/administering-a-repository/about-releases.md b/translations/ru-RU/content/github/administering-a-repository/about-releases.md index ef5a803f11a4..68fc47ebc097 100644 --- a/translations/ru-RU/content/github/administering-a-repository/about-releases.md +++ b/translations/ru-RU/content/github/administering-a-repository/about-releases.md @@ -25,11 +25,13 @@ You can receive notifications when new releases are published in a repository wi Anyone with read access to a repository can view and compare releases, but only people with write permissions to a repository can manage releases. For more information, see "[Managing releases in a repository](/github/administering-a-repository/managing-releases-in-a-repository)." {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -People with admin permissions to a repository can choose whether {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in the ZIP files and tarballs that {% data variables.product.product_name %} creates for each release. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)." +People with admin permissions to a repository can choose whether +{% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in the ZIP files and tarballs that {% data variables.product.product_name %} creates for each release. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)." {% endif %} {% if currentVersion == "free-pro-team@latest" %} -If a release fixes a security vulnerability, you should publish a security advisory in your repository. {% data variables.product.prodname_dotcom %} reviews each published security advisory and may use it to send {% data variables.product.prodname_dependabot_short %} alerts to affected repositories. For more information, see "[About GitHub Security Advisories](/github/managing-security-vulnerabilities/about-github-security-advisories)." +If a release fixes a security vulnerability, you should publish a security advisory in your repository. +{% data variables.product.prodname_dotcom %} reviews each published security advisory and may use it to send {% data variables.product.prodname_dependabot_short %} alerts to affected repositories. For more information, see "[About GitHub Security Advisories](/github/managing-security-vulnerabilities/about-github-security-advisories)." You can view the **Dependents** tab of the dependency graph to see which repositories and packages depend on code in your repository, and may therefore be affected by a new release. For more information, see "[About the dependency graph](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)." {% endif %} diff --git a/translations/ru-RU/content/github/administering-a-repository/changing-the-default-branch.md b/translations/ru-RU/content/github/administering-a-repository/changing-the-default-branch.md new file mode 100644 index 000000000000..41a52d0cd369 --- /dev/null +++ b/translations/ru-RU/content/github/administering-a-repository/changing-the-default-branch.md @@ -0,0 +1,53 @@ +--- +title: Changing the default branch +intro: 'If you have more than one branch in your repository, you can configure any branch as the default branch.' +permissions: People with admin permissions to a repository can change the default branch for the repository. +versions: + free-pro-team: '*' + enterprise-server: '*' +redirect_from: + - /github/administering-a-repository/setting-the-default-branch + - /articles/setting-the-default-branch +--- + +### About changing the default branch + +You can choose the default branch for a repository. The default branch is the base branch for pull requests and code commits. For more information about the default branch, see "[About branches](/github/collaborating-with-issues-and-pull-requests/about-branches#about-the-default-branch)." + +{% note %} + +**Note**: If you use the Git-Subversion bridge, changing the default branch will affect your `trunk` branch contents and the `HEAD` you see when you list references for the remote repository. For more information, see "[Support for Subversion clients](/github/importing-your-projects-to-github/support-for-subversion-clients)" and [git-ls-remote](https://git-scm.com/docs/git-ls-remote.html) in the Git documentation. + +{% endnote %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} + +{% data reusables.branches.set-default-branch %} + +{% endif %} + +### Требования + +To change the default branch, your repository must have more than one branch. For more information, see "[Creating and deleting branches within your repository](/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository#creating-a-branch)." + +### Changing the default branch + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.repository-branches %} +1. Under "Default branch", to the right of the default branch name, click {% octicon "arrow-switch" aria-label="The switch icon with two arrows" %}. ![Switch icon with two arrows to the right of current default branch name](/assets/images/help/repository/repository-options-defaultbranch-change.png) +1. Use the drop-down, then click a branch name. ![Drop-down to choose new default branch](/assets/images/help/repository/repository-options-defaultbranch-drop-down.png) +1. Click **Update**. !["Update" button after choosing a new default branch](/assets/images/help/repository/repository-options-defaultbranch-update.png) +1. Read the warning, then click **I understand, update the default branch.** !["Update" button after choosing a new default branch](/assets/images/help/repository/repository-options-defaultbranch-i-understand.png) + +{% else %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.repository-branches %} +1. In the default branch drop-down, choose the new default branch. ![Default branch dropdown selector](/assets/images/help/repository/repository-options-defaultbranch.png) +1. Click **Update**. + +{% endif %} diff --git a/translations/ru-RU/content/github/administering-a-repository/configuration-options-for-dependency-updates.md b/translations/ru-RU/content/github/administering-a-repository/configuration-options-for-dependency-updates.md index 784c04b1ce91..74297597078d 100644 --- a/translations/ru-RU/content/github/administering-a-repository/configuration-options-for-dependency-updates.md +++ b/translations/ru-RU/content/github/administering-a-repository/configuration-options-for-dependency-updates.md @@ -37,13 +37,14 @@ The *dependabot.yml* file must start with `version: 2` followed by an array of ` | [`schedule.time`](#scheduletime) | | Time of day to check for updates (hh:mm) | | [`schedule.timezone`](#scheduletimezone) | | Timezone for time of day (zone identifier) | | [`target-branch`](#target-branch) | | Branch to create pull requests against | +| [`vendor`](#vendor) | | Update vendored or cached dependencies | | [`versioning-strategy`](#versioning-strategy) | | How to update manifest version requirements | These options fit broadly into the following categories. - Essential set up options that you must include in all configurations: [`package-ecosystem`](#package-ecosystem), [`directory`](#directory),[`schedule.interval`](#scheduleinterval). - Options to customize the update schedule: [`schedule.time`](#scheduletime), [`schedule.timezone`](#scheduletimezone), [`schedule.day`](#scheduleday). -- Options to control which dependencies are updated: [`allow`](#allow), [`ignore`](#ignore). +- Options to control which dependencies are updated: [`allow`](#allow), [`ignore`](#ignore), [`vendor`](#vendor). - Options to add metadata to pull requests: [`reviewers`](#reviewers), [`assignees`](#assignees), [`labels`](#labels), [`milestone`](#milestone). - Options to change the behavior of the pull requests: [`target-branch`](#target-branch), [`versioning-strategy`](#versioning-strategy), [`commit-message`](#commit-message), [`rebase-strategy`](#rebase-strategy), [`pull-request-branch-name.separator`](#pull-request-branch-nameseparator). @@ -61,7 +62,7 @@ In general, security updates use any configuration options that affect pull requ ### `package-ecosystem` -**Required** You add one `package-ecosystem` element for each one package manager that you want {% data variables.product.prodname_dependabot %} to monitor for new versions. The repository must also contain a dependency manifest or lock file each of these package managers. +**Required** You add one `package-ecosystem` element for each one package manager that you want {% data variables.product.prodname_dependabot %} to monitor for new versions. The repository must also contain a dependency manifest or lock file each of these package managers. If you want to enable vendoring for a package manager that supports it, the vendored dependencies must be located in the required directory. For more information, see [`vendor`](#vendor) below. {% data reusables.dependabot.supported-package-managers %} @@ -540,6 +541,31 @@ updates: - "npm dependencies" ``` +### `vendor` + +Use the `vendor` option to tell {% data variables.product.prodname_dependabot_short %} to vendor dependencies when updating them. + +{% note %} + +Currently, {% data variables.product.prodname_dependabot_short %} only supports vendoring dependencies for Bundler. + +{% endnote %} + +```yaml +# Configure version updates for both dependencies defined in manifests and vendored dependencies + +version: 2 +updates: + - package-ecosystem: "bundler" + # Raise pull requests to update vendored dependencies that are checked in to the repository + vendor: true + directory: "/" + schedule: + interval: "weekly" +``` + +{% data variables.product.prodname_dependabot_short %} only updates the vendored dependencies located in specific directories in a repository. For Bundler, the dependencies must be in the _vendor/cache_ directory. Other file paths are not supported. For more information, see the [`bundle cache` documentation](https://bundler.io/man/bundle-cache.1.html). + ### `versioning-strategy` When {% data variables.product.prodname_dependabot %} edits a manifest file to update a version, it uses the following overall strategies: diff --git a/translations/ru-RU/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md b/translations/ru-RU/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md index 2827db00dac5..4b2121c3c5cb 100644 --- a/translations/ru-RU/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md +++ b/translations/ru-RU/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md @@ -6,7 +6,7 @@ redirect_from: - /articles/configuring-autolinks-to-reference-external-resources versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- Anyone with admin permissions to a repository can configure autolink references to link issues, pull requests,{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} commit messages, and release descriptions{% else %} and commit messages{% endif %} to external third-party services. diff --git a/translations/ru-RU/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md b/translations/ru-RU/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md new file mode 100644 index 000000000000..c759845dad4e --- /dev/null +++ b/translations/ru-RU/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md @@ -0,0 +1,18 @@ +--- +title: Configuring the retention period for GitHub Actions artifacts and logs in your repository +intro: 'You can configure the retention period for {% data variables.product.prodname_actions %} artifacts and logs in your repository.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.23' +--- + +{% data reusables.actions.about-artifact-log-retention %} + +You can also define a custom retention period for a specific artifact created by a workflow. For more information, see "[Setting the retention period for an artifact](/actions/managing-workflow-runs/removing-workflow-artifacts#setting-the-retention-period-for-an-artifact)." + +## Setting the retention period for a repository + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.settings-sidebar-actions %} +{% data reusables.github-actions.change-retention-period-for-artifacts-logs %} diff --git a/translations/ru-RU/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md b/translations/ru-RU/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md index f2e25b8d80d4..a804bc15c0d5 100644 --- a/translations/ru-RU/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md +++ b/translations/ru-RU/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md @@ -5,7 +5,7 @@ redirect_from: - /articles/customizing-your-repositorys-social-media-preview versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- Until you add an image, repository links expand to show basic information about the repository and the owner's avatar. Adding an image to your repository can help identify your project across various social platforms. diff --git a/translations/ru-RU/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md b/translations/ru-RU/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md index 5223a3af559f..b959688a295e 100644 --- a/translations/ru-RU/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md +++ b/translations/ru-RU/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md @@ -35,6 +35,5 @@ You can restore the head branch of a closed pull request. ### Дополнительная литература -- "[Creating and deleting branches within your repository](/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository)"{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} +- "[Creating and deleting branches within your repository](/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository)" - "[Managing the automatic deletion of branches](/github/administering-a-repository/managing-the-automatic-deletion-of-branches)" -{% endif %} diff --git a/translations/ru-RU/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md b/translations/ru-RU/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md index b8e7f9be37a8..dc98637951aa 100644 --- a/translations/ru-RU/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md +++ b/translations/ru-RU/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md @@ -17,6 +17,8 @@ You can enable {% data variables.product.prodname_actions %} for your repository Alternatively, you can enable {% data variables.product.prodname_actions %} in your repository but limit the actions a workflow can run. {% data reusables.github-actions.enabled-local-github-actions %} +{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.23" %} + ### Managing {% data variables.product.prodname_actions %} permissions for your repository {% note %} @@ -30,6 +32,41 @@ Alternatively, you can enable {% data variables.product.prodname_actions %} in y {% data reusables.repositories.settings-sidebar-actions %} 4. Under "Actions permissions", select an option. ![Enable, disable, or limits actions for this repository](/assets/images/help/repository/enable-repo-actions.png) +{% endif %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} + +### Managing {% data variables.product.prodname_actions %} permissions for your repository + +You can disable all workflows for a repository or set a policy that configures which actions can be used in a repository. + +{% data reusables.actions.actions-use-policy-settings %} + +{% note %} + +**Note:** You might not be able to manage these settings if your organization has an overriding policy or is managed by an enterprise that has overriding policy. For more information, see "[Disabling or limiting {% data variables.product.prodname_actions %} for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization)" or {% if currentVersion == "free-pro-team@latest" %}"[Enforcing {% data variables.product.prodname_actions %} policies in your enterprise account](/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account)."{% else if currentVersion ver_gt "enterprise-server@2.21" %}"[Enforcing {% data variables.product.prodname_actions %} policies for your enterprise](/enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise)." + +{% endif %} + +{% endnote %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.settings-sidebar-actions %} +1. Under **Actions permissions**, select an option. ![Set actions policy for this organization](/assets/images/help/repository/actions-policy.png) +1. Click **Save**. + +### Allowing specific actions to run + +{% data reusables.actions.allow-specific-actions-intro %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.settings-sidebar-actions %} +1. Under **Actions permissions**, select **Allow specific actions** and add your required actions to the list. ![Add actions to allow list](/assets/images/help/repository/actions-policy-allow-list.png) +2. Click **Save**. +{% endif %} + {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} ### Enabling workflows for private repository forks diff --git a/translations/ru-RU/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md b/translations/ru-RU/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md index aaaa8b0c308b..7c191cba97a7 100644 --- a/translations/ru-RU/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md +++ b/translations/ru-RU/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md @@ -14,18 +14,18 @@ You can configure your sponsor button by editing a _FUNDING.yml_ file in your re You can add one username, package name, or project name per external funding platform and up to four custom URLs. You can add up to four sponsored developers or organizations in {% data variables.product.prodname_sponsors %}. Add each platform on a new line, using the following syntax: -| Platform | Syntax | -| ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | -| [CommunityBridge](https://communitybridge.org) | `community_bridge: PROJECT-NAME` | +| Platform | Syntax | +| ----------------------------------------------------------------------------- | ------------------------------------------------------------------------ | +| [CommunityBridge](https://communitybridge.org) | `community_bridge: PROJECT-NAME` | | [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors) | `github: USERNAME` or `github: [USERNAME, USERNAME, USERNAME, USERNAME]` | -| [IssueHunt](https://issuehunt.io/) | `issuehunt: USERNAME` | -| [Ko-fi](https://ko-fi.com/) | `ko_fi: USERNAME` | -| [Liberapay](https://en.liberapay.com/) | `liberapay: USERNAME` | -| [Open Collective](https://opencollective.com/) | `open_collective: USERNAME` | -| [Otechie](https://otechie.com/) | `otechie: USERNAME` | -| [Patreon](https://www.patreon.com/) | `patreon: USERNAME` | -| [Tidelift](https://tidelift.com/) | `tidelift: PLATFORM-NAME/PACKAGE-NAME` | -| Custom URL | `custom: LINK1` or `custom: [LINK1, LINK2, LINK3, LINK4]` | +| [IssueHunt](https://issuehunt.io/) | `issuehunt: USERNAME` | +| [Ko-fi](https://ko-fi.com/) | `ko_fi: USERNAME` | +| [Liberapay](https://en.liberapay.com/) | `liberapay: USERNAME` | +| [Open Collective](https://opencollective.com/) | `open_collective: USERNAME` | +| [Otechie](https://otechie.com/) | `otechie: USERNAME` | +| [Patreon](https://www.patreon.com/) | `patreon: USERNAME` | +| [Tidelift](https://tidelift.com/) | `tidelift: PLATFORM-NAME/PACKAGE-NAME` | +| Custom URL | `custom: LINK1` or `custom: [LINK1, LINK2, LINK3, LINK4]` | For Tidelift, use the `platform-name/package-name` syntax with the following platform names: diff --git a/translations/ru-RU/content/github/administering-a-repository/enabling-branch-restrictions.md b/translations/ru-RU/content/github/administering-a-repository/enabling-branch-restrictions.md index 7cb6ac487afb..2e12518cdde8 100644 --- a/translations/ru-RU/content/github/administering-a-repository/enabling-branch-restrictions.md +++ b/translations/ru-RU/content/github/administering-a-repository/enabling-branch-restrictions.md @@ -19,7 +19,7 @@ Anyone with admin permissions to an organization-owned repository can enable bra {% data reusables.repositories.add-branch-protection-rules %} {% data reusables.repositories.include-administrators %} 6. Under "Protect matching branches", select **Restrict who can push to matching branches**. ![Branch restriction checkbox](/assets/images/help/repository/restrict-branch.png) -8. Search for and select the people{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %} or{% endif %} teams{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, or apps{% endif %} who will have permission to push to the protected branch. ![Branch restriction search](/assets/images/help/repository/restrict-branch-search.png) +8. Search for and select the people, teams, or apps who will have permission to push to the protected branch. ![Branch restriction search](/assets/images/help/repository/restrict-branch-search.png) 9. Click **Create**. ### Дополнительная литература diff --git a/translations/ru-RU/content/github/administering-a-repository/index.md b/translations/ru-RU/content/github/administering-a-repository/index.md index 790f6bd920cd..b84dfb362a33 100644 --- a/translations/ru-RU/content/github/administering-a-repository/index.md +++ b/translations/ru-RU/content/github/administering-a-repository/index.md @@ -27,6 +27,7 @@ versions: {% link_in_list /managing-the-forking-policy-for-your-repository %} + {% link_in_list /configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository %} {% link_in_list /disabling-or-limiting-github-actions-for-a-repository %} {% link_in_list /managing-git-lfs-objects-in-archives-of-your-repository %} {% link_in_list /enabling-anonymous-git-read-access-for-a-repository %} @@ -41,8 +42,8 @@ versions: {% link_in_list /restoring-a-deleted-repository %} {% topic_link_in_list /managing-branches-in-your-repository %} - {% link_in_list /setting-the-default-branch %} {% link_in_list /viewing-branches-in-your-repository %} + {% link_in_list /changing-the-default-branch %} {% link_in_list /deleting-and-restoring-branches-in-a-pull-request %} {% topic_link_in_list /configuring-pull-request-merges %} {% link_in_list /about-merge-methods-on-github %} diff --git a/translations/ru-RU/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot.md b/translations/ru-RU/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot.md index 990adb4324c1..f5edbb1b3881 100644 --- a/translations/ru-RU/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot.md +++ b/translations/ru-RU/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot.md @@ -9,7 +9,7 @@ versions: ### About {% data variables.product.prodname_dependabot_version_updates %} for actions -Actions are often updated with bug fixes and new features to make automated processes more reliable, faster, and safer. When you enable {% data variables.product.prodname_dependabot_version_updates %} for {% data variables.product.prodname_actions %}, {% data variables.product.prodname_dependabot %} will help ensure that references to actions in a repository's *workflow.yml* file are kept up to date. For each action in the file, {% data variables.product.prodname_dependabot_short %} checks the action's reference (typically a version number or commit identifier associated with the action) against the latest version. If a more recent version of the action is available, {% data variables.product.prodname_dependabot_short %} will send you a pull request that updates the reference in the workflow file to the latest version. For more information about {% data variables.product.prodname_dependabot_version_updates %}, see "[About {% data variables.product.prodname_dependabot_version_updates %}](/github/administering-a-repository/about-github-dependabot-version-updates)." For more information about configuring workflows for {% data variables.product.prodname_actions %}, see "[Configuring a workflow](/actions/configuring-and-managing-workflows/configuring-a-workflow)." +Actions are often updated with bug fixes and new features to make automated processes more reliable, faster, and safer. When you enable {% data variables.product.prodname_dependabot_version_updates %} for {% data variables.product.prodname_actions %}, {% data variables.product.prodname_dependabot %} will help ensure that references to actions in a repository's *workflow.yml* file are kept up to date. For each action in the file, {% data variables.product.prodname_dependabot_short %} checks the action's reference (typically a version number or commit identifier associated with the action) against the latest version. If a more recent version of the action is available, {% data variables.product.prodname_dependabot_short %} will send you a pull request that updates the reference in the workflow file to the latest version. For more information about {% data variables.product.prodname_dependabot_version_updates %}, see "[About {% data variables.product.prodname_dependabot_version_updates %}](/github/administering-a-repository/about-github-dependabot-version-updates)." For more information about configuring workflows for {% data variables.product.prodname_actions %}, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." ### Enabling {% data variables.product.prodname_dependabot_version_updates %} for actions diff --git a/translations/ru-RU/content/github/administering-a-repository/managing-releases-in-a-repository.md b/translations/ru-RU/content/github/administering-a-repository/managing-releases-in-a-repository.md index 4357fbdbe145..d043932d0374 100644 --- a/translations/ru-RU/content/github/administering-a-repository/managing-releases-in-a-repository.md +++ b/translations/ru-RU/content/github/administering-a-repository/managing-releases-in-a-repository.md @@ -16,10 +16,11 @@ versions: ### About release management -You can also publish an action from a specific release in {% data variables.product.prodname_marketplace %}. For more information, see "[Publishing an action in the {% data variables.product.prodname_marketplace %}](/actions/creating-actions/publishing-actions-in-github-marketplace)." +You can also publish an action from a specific release in {% data variables.product.prodname_marketplace %}. For more information, see "    Publishing an action in the {% data variables.product.prodname_marketplace %}." {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -You can choose whether {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in the ZIP files and tarballs that {% data variables.product.product_name %} creates for each release. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)." +You can choose whether +{% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in the ZIP files and tarballs that {% data variables.product.product_name %} creates for each release. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)." {% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} @@ -42,7 +43,7 @@ You can choose whether {% data variables.large_files.product_name_long %} ({% da 8. To notify users that the release is not ready for production and may be unstable, select **This is a pre-release**. ![Checkbox to mark a release as prerelease](/assets/images/help/releases/prerelease_checkbox.png) 9. If you're ready to publicize your release, click **Publish release**. To work on the release later, click **Save draft**. ![Publish release and Draft release buttons](/assets/images/help/releases/release_buttons.png) -You can also automatically create a release from the command line or in a script. For more information, see "[Releases](/v3/repos/releases/#create-a-release)." +You can also automatically create a release from the command line or in a script. For more information, see "[Releases](/rest/reference/repos/#create-a-release)." ### Editing a release diff --git a/translations/ru-RU/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md b/translations/ru-RU/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md index 99ea6a22b91e..fa95110a03b2 100644 --- a/translations/ru-RU/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md +++ b/translations/ru-RU/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md @@ -5,7 +5,7 @@ redirect_from: - /articles/managing-the-automatic-deletion-of-branches versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- Anyone with admin permissions to a repository can enable or disable the automatic deletion of branches. diff --git a/translations/ru-RU/content/github/authenticating-to-github/about-authentication-to-github.md b/translations/ru-RU/content/github/authenticating-to-github/about-authentication-to-github.md index f6af8a0db9eb..0e22c678c832 100644 --- a/translations/ru-RU/content/github/authenticating-to-github/about-authentication-to-github.md +++ b/translations/ru-RU/content/github/authenticating-to-github/about-authentication-to-github.md @@ -16,7 +16,6 @@ You can access your resources in {% data variables.product.product_name %} in a - Personal access token - Ключ SSH - ### Authenticating in your browser You can authenticate to {% data variables.product.product_name %} in your browser in different ways. diff --git a/translations/ru-RU/content/github/authenticating-to-github/about-commit-signature-verification.md b/translations/ru-RU/content/github/authenticating-to-github/about-commit-signature-verification.md index 76a633134657..f9567723b3b2 100644 --- a/translations/ru-RU/content/github/authenticating-to-github/about-commit-signature-verification.md +++ b/translations/ru-RU/content/github/authenticating-to-github/about-commit-signature-verification.md @@ -59,8 +59,9 @@ You don't need to upload your public key to {% data variables.product.product_na ### Signature verification for bots Organizations and {% data variables.product.prodname_github_app %}s that require commit signing can use bots to sign commits. If a commit or tag has a bot signature that is cryptographically verifiable, {% data variables.product.product_name %} marks the commit or tag as verified. +Signature verification for bots will only work if the request is verified and authenticated as the -Signature verification for bots will only work if the request is verified and authenticated as the {% data variables.product.prodname_github_app %} or bot and contains no custom author information, custom committer information, and no custom signature information, such as Commits API. +{% data variables.product.prodname_github_app %} or bot and contains no custom author information, custom committer information, and no custom signature information, such as Commits API. {% endif %} ### Дополнительная литература diff --git a/translations/ru-RU/content/github/authenticating-to-github/about-ssh.md b/translations/ru-RU/content/github/authenticating-to-github/about-ssh.md index dda31454feed..9d193a2fca95 100644 --- a/translations/ru-RU/content/github/authenticating-to-github/about-ssh.md +++ b/translations/ru-RU/content/github/authenticating-to-github/about-ssh.md @@ -15,12 +15,11 @@ When you set up SSH, you'll [generate an SSH key and add it to the ssh-agent](/a We recommend that you regularly [review your SSH keys list](/articles/reviewing-your-ssh-keys) and revoke any that are invalid or have been compromised. {% if currentVersion == "free-pro-team@latest" %} -If you haven't used your SSH key for a year, then {% data variables.product.prodname_dotcom %} will automatically delete your inactive SSH key as a security precaution. For more information, see "[Deleted or missing SSH keys](/articles/deleted-or-missing-ssh-keys)." +If you haven't used your SSH key for a year, then +{% data variables.product.prodname_dotcom %} will automatically delete your inactive SSH key as a security precaution. For more information, see "[Deleted or missing SSH keys](/articles/deleted-or-missing-ssh-keys)." {% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} If you're a member of an organization that provides SSH certificates, you can use your certificate to access that organization's repositories without adding the certificate to your {% data variables.product.product_name %} account. For more information, see "[About SSH certificate authorities](/articles/about-ssh-certificate-authorities)." -{% endif %} ### Дополнительная литература diff --git a/translations/ru-RU/content/github/authenticating-to-github/about-two-factor-authentication.md b/translations/ru-RU/content/github/authenticating-to-github/about-two-factor-authentication.md index 9772ce40e3e5..478630fc958a 100644 --- a/translations/ru-RU/content/github/authenticating-to-github/about-two-factor-authentication.md +++ b/translations/ru-RU/content/github/authenticating-to-github/about-two-factor-authentication.md @@ -1,6 +1,6 @@ --- title: About two-factor authentication -intro: 'Two-factor authentication, or 2FA, is an extra layer of security used when logging into websites or apps. With 2FA, you have to log in with your username and password and provide another form of authentication that only you know or have access to.' +intro: '{% data reusables.two_fa.about-2fa %} With 2FA, you have to log in with your username and password and provide another form of authentication that only you know or have access to.' redirect_from: - /articles/about-two-factor-authentication versions: diff --git a/translations/ru-RU/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md b/translations/ru-RU/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md index 1ed7cc8b5ff0..3cd70d670b87 100644 --- a/translations/ru-RU/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md +++ b/translations/ru-RU/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md @@ -80,7 +80,7 @@ After adding a new SSH key to your {% data variables.product.product_name %} acc $ sudo apt-get install xclip # Downloads and installs xclip. If you don't have `apt-get`, you might need to use another installer (like `yum`) - $ xclip -sel clip < ~/.ssh/id_rsa.pub + $ xclip -selection clipboard < ~/.ssh/id_rsa.pub # Copies the contents of the id_rsa.pub file to your clipboard ``` {% tip %} diff --git a/translations/ru-RU/content/github/authenticating-to-github/authorizing-oauth-apps.md b/translations/ru-RU/content/github/authenticating-to-github/authorizing-oauth-apps.md index 8dda2abaa97c..a1c6b5927290 100644 --- a/translations/ru-RU/content/github/authenticating-to-github/authorizing-oauth-apps.md +++ b/translations/ru-RU/content/github/authenticating-to-github/authorizing-oauth-apps.md @@ -55,7 +55,7 @@ When you want to use an {% data variables.product.prodname_oauth_app %} that int | Deployments | Deployment status access allows apps to determine if a deployment is successful against a specific commit for public and private repositories. Apps won't have access to your code. | | Gists | [Gist](https://gist.github.com) access allows apps to read or write to both your public and secret Gists. | | Hooks | [Webhooks](/webhooks) access allows apps to read or write hook configurations on repositories you manage. | -| Notification (Оповещения) | Notification access allows apps to read your {% data variables.product.product_name %} notifications, such as comments on issues and pull requests. However, apps remain unable to access anything in your repositories. | +| Notification (Оповещения) | Notification access allows apps to read your {% data variables.product.product_name %} notifications, such as comments on issues and pull requests. However, apps remain unable to access anything in your repositories. | | Organizations and teams | Organization and teams access allows apps to access and manage organization and team membership. | | Personal user data | User data includes information found in your user profile, like your name, e-mail address, and location. | | Repositories | Repository information includes the names of contributors, the branches you've created, and the actual files within your repository. Apps can request access for either public or private repositories on a user-wide level. | diff --git a/translations/ru-RU/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md b/translations/ru-RU/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md index 14ff82b99d08..5fce820e48c9 100644 --- a/translations/ru-RU/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md +++ b/translations/ru-RU/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md @@ -20,8 +20,7 @@ versions: 3. Check the directory listing to see if you already have a public SSH key. By default, the filenames of the public keys are one of the following: - *id_rsa.pub* - *id_ecdsa.pub* - - *id_ed25519.pub*{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} - - *id_dsa.pub*{% endif %} + - *id_ed25519.pub* If you don't have an existing public and private key pair, or don't wish to use any that are available to connect to {% data variables.product.product_name %}, then [generate a new SSH key](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent). diff --git a/translations/ru-RU/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md b/translations/ru-RU/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md index 6ec580d3f6b0..968c99a0b032 100644 --- a/translations/ru-RU/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md +++ b/translations/ru-RU/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md @@ -11,7 +11,9 @@ versions: ### Checking your commit signature verification status -1. On {% data variables.product.product_name %}, navigate to your pull request. +1. On + +{% data variables.product.product_name %}, navigate to your pull request. {% data reusables.repositories.review-pr-commits %} 3. Next to your commit's abbreviated commit hash, there is a box that shows whether your commit signature is verified or unverified. ![Signed commit](/assets/images/help/commits/gpg-signed-commit-verified-without-details.png) 4. To view more detailed information about the commit signature, click **Verified** or **Unverified**. ![Verified signed commit](/assets/images/help/commits/gpg-signed-commit_verified_details.png) diff --git a/translations/ru-RU/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md b/translations/ru-RU/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md index c6ad4ced833f..3485eb209373 100644 --- a/translations/ru-RU/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md +++ b/translations/ru-RU/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md @@ -91,7 +91,9 @@ When you generate or retrieve an account recovery token, an event is added to yo You can generate an account recovery token and store it with a partner recovery provider. -1. Sign in to your Facebook account, then return to {% data variables.product.product_name %}. +1. Sign in to your Facebook account, then return to + +{% data variables.product.product_name %}. {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.security %} 4. To generate a new token, under "Recovery tokens," click **Store new token**. ![Button for storing a new recovery token](/assets/images/help/settings/store-new-recovery-token.png) diff --git a/translations/ru-RU/content/github/authenticating-to-github/configuring-two-factor-authentication.md b/translations/ru-RU/content/github/authenticating-to-github/configuring-two-factor-authentication.md index 99adf3b98c51..6228e7dd5e42 100644 --- a/translations/ru-RU/content/github/authenticating-to-github/configuring-two-factor-authentication.md +++ b/translations/ru-RU/content/github/authenticating-to-github/configuring-two-factor-authentication.md @@ -45,7 +45,9 @@ A time-based one-time password (TOTP) application automatically generates an aut 8. On the Two-factor authentication page, do one of the following: - Scan the QR code with your mobile device's app. After scanning, the app displays a six-digit code that you can enter on {% data variables.product.product_name %}. - If you can't scan the QR code, click **enter this text code** to see a code you can copy and manually enter on {% data variables.product.product_name %} instead. ![Click enter this code](/assets/images/help/2fa/totp-click-enter-code.png) -9. The TOTP mobile application saves your {% data variables.product.product_name %} account and generates a new authentication code every few seconds. On {% data variables.product.product_name %}, on the 2FA page, type the code and click **Enable**. ![TOTP Enable field](/assets/images/help/2fa/totp-enter-code.png) +9. The TOTP mobile application saves your +{% data variables.product.product_name %} account and generates a new authentication code every few seconds. On {% data variables.product.product_name %}, on the 2FA page, type the code and click **Enable**. + ![TOTP Enable field](/assets/images/help/2fa/totp-enter-code.png) {% data reusables.two_fa.test_2fa_immediately %} {% if currentVersion == "free-pro-team@latest" %} @@ -82,29 +84,13 @@ On most devices and browsers, you can use a physical security key over USB or NF Authentication with a security key is *secondary* to authentication with a TOTP application{% if currentVersion == "free-pro-team@latest" %} or a text message{% endif %}. If you lose your security key, you'll still be able to use your phone's code to sign in. 1. You must have already configured 2FA via a TOTP mobile app{% if currentVersion == "free-pro-team@latest" %} or via SMS{% endif %}. -2. Ensure that you have a -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}WebAuthn{% else %}FIDO U2F{% endif %} compatible security key inserted into your computer. +2. Ensure that you have a WebAuthn compatible security key inserted into your computer. {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.security %} 5. Next to "Security keys", click **Add**. ![Add security keys option](/assets/images/help/2fa/add-security-keys-option.png) -6. Under "Security keys", click **Register new security key**. - {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - ![Registering a new security key](/assets/images/help/2fa/security-key-register.png) - {% else %} - ![Registering a new FIDO U2F device](/assets/images/help/2fa/register_new_fido_u2f_device.png) - {% endif %} -7. Type a nickname for the security key, then click **Add**. - {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - ![Providing a nickname for a security key](/assets/images/help/2fa/security-key-nickname.png) - {% else %} - ![Providing a nickname for a FIDO U2F device](/assets/images/help/2fa/fido_u2f_nickname.png) - {% endif %} -8. Activate your security key, following your security key's documentation. - {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - ![Prompt for a security key](/assets/images/help/2fa/security-key-prompt.png) - {% else %} - ![Prompt for a FIDO U2F device](/assets/images/help/2fa/fido_u2f_prompt_key.png) - {% endif %} +6. Under "Security keys", click **Register new security key**. ![Registering a new security key](/assets/images/help/2fa/security-key-register.png) +7. Type a nickname for the security key, then click **Add**. ![Providing a nickname for a security key](/assets/images/help/2fa/security-key-nickname.png) +8. Activate your security key, following your security key's documentation. ![Prompt for a security key](/assets/images/help/2fa/security-key-prompt.png) 9. Confirm that you've downloaded and can access your recovery codes. If you haven't already, or if you'd like to generate another set of codes, download your codes and save them in a safe place. If you lose access to your account, you can use your recovery codes to get back into your account. For more information, see "[Recovering your account if you lose your 2FA credentials](/articles/recovering-your-account-if-you-lose-your-2fa-credentials)." ![Download recovery codes button](/assets/images/help/2fa/2fa-recover-during-setup.png) {% data reusables.two_fa.test_2fa_immediately %} diff --git a/translations/ru-RU/content/github/authenticating-to-github/connecting-with-third-party-applications.md b/translations/ru-RU/content/github/authenticating-to-github/connecting-with-third-party-applications.md index 69bff5c7f793..c3fa4c844013 100644 --- a/translations/ru-RU/content/github/authenticating-to-github/connecting-with-third-party-applications.md +++ b/translations/ru-RU/content/github/authenticating-to-github/connecting-with-third-party-applications.md @@ -57,7 +57,7 @@ There are several types of data that applications can request. | Deployments | Deployment status access allows applicationss to determine if a deployment is successful against a specific commit for public and private repositories. Applicationss won't have access to your code. | | Gists | [Gist](https://gist.github.com) access allows applications to read or write to both your public and secret Gists. | | Hooks | [Webhooks](/webhooks) access allows applications to read or write hook configurations on repositories you manage. | -| Notification (Оповещения) | Notification access allows applicationss to read your {% data variables.product.product_name %} notifications, such as comments on issues and pull requests. However, applications remain unable to access anything in your repositories. | +| Notification (Оповещения) | Notification access allows applicationss to read your {% data variables.product.product_name %} notifications, such as comments on issues and pull requests. However, applications remain unable to access anything in your repositories. | | Organizations and teams | Organization and teams access allows apps to access and manage organization and team membership. | | Personal user data | User data includes information found in your user profile, like your name, e-mail address, and location. | | Repositories | Repository information includes the names of contributors, the branches you've created, and the actual files within your repository. Applications can request access for either public or private repositories on a user-wide level. | diff --git a/translations/ru-RU/content/github/authenticating-to-github/error-permission-denied-publickey.md b/translations/ru-RU/content/github/authenticating-to-github/error-permission-denied-publickey.md index 696881e413b8..0e45538b92f7 100644 --- a/translations/ru-RU/content/github/authenticating-to-github/error-permission-denied-publickey.md +++ b/translations/ru-RU/content/github/authenticating-to-github/error-permission-denied-publickey.md @@ -51,7 +51,7 @@ $ ssh -T git@{% data variables.command_line.codeblock %} {% mac %} {% data reusables.command_line.open_the_multi_os_terminal %} -2. Verify that you have a private key generated and loaded into SSH. If you're using OpenSSH 6.7 or older: +2. Verify that you have a private key generated and loaded into SSH. **Tip**: On most systems the default private keys (`~/.ssh/id_rsa`{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}, `~/.ssh/id_dsa`{% endif %} and `~/.ssh/identity`) are automatically added to the SSH authentication agent. ```shell # start the ssh-agent in the background $ eval "$(ssh-agent -s)" @@ -68,6 +68,14 @@ $ ssh -T git@{% data variables.command_line.codeblock %} $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + # start the ssh-agent in the background + $ eval "$(ssh-agent -s)" + > Agent pid 59566 + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} {% endmac %} @@ -75,10 +83,7 @@ $ ssh -T git@{% data variables.command_line.codeblock %} {% data reusables.desktop.windows_git_bash %} -1. {% data reusables.desktop.windows_git_bash_turn_on_ssh_agent %} - - {% data reusables.desktop.windows_git_for_windows_turn_on_ssh_agent %} -2. Verify that you have a private key generated and loaded into SSH. If you're using OpenSSH 6.7 or older: +1. {% data reusables.desktop.windows_git_bash_turn_on_ssh_agent %} Verify that you have a private key generated and loaded into SSH. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) @@ -89,13 +94,18 @@ $ ssh -T git@{% data variables.command_line.codeblock %} $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} {% endwindows %} {% linux %} {% data reusables.command_line.open_the_multi_os_terminal %} -2. Verify that you have a private key generated and loaded into SSH. If you're using OpenSSH 6.7 or older: +2. Verify that you have a private key generated and loaded into SSH. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell # start the ssh-agent in the background $ eval "$(ssh-agent -s)" @@ -112,24 +122,16 @@ $ ssh -T git@{% data variables.command_line.codeblock %} $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` - -{% endlinux %} - -The `ssh-add` command *should* print out a long string of numbers and letters. If it does not print anything, you will need to [generate a new SSH key](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) and associate it with {% data variables.product.product_name %}. + {% else %} + ```shell + $ ssh-add -l + > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) If it does not print anything, you will need to generate a new SSH key and associate it with {% data variables.product.product_name %}. {% tip %} -**Tip**: On most systems the default private keys (`~/.ssh/id_rsa`{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}, `~/.ssh/id_dsa`{% endif %} and `~/.ssh/identity`) are automatically added to the SSH authentication agent. You shouldn't need to run `ssh-add path/to/key` unless you override the file name when you generate a key. - -{% endtip %} - -#### Getting more details - -You can also check that the key is being used by trying to connect to `git@{% data variables.command_line.backticks %}`: +**Tip**: On most systems the default private keys (`~/.ssh/id_rsa` and `~/.ssh/identity`) are automatically added to the SSH authentication agent. You shouldn't need to run `ssh-add path/to/key` unless you override the file name when you generate a key. -```shell -$ ssh -vT git@{% data variables.command_line.codeblock %} -> ... +You can also check that the key is being used by trying to connect to git@{% data variables.command_line.backticks %}: > debug1: identity file /Users/you/.ssh/id_rsa type -1 > debug1: identity file /Users/you/.ssh/id_rsa-cert type -1 > debug1: identity file /Users/you/.ssh/id_dsa type -1 @@ -142,6 +144,19 @@ $ ssh -vT git@{% data variables.command_line.codeblock %} > debug1: No more authentication methods to try. > Permission denied (publickey). ``` +: +> debug1: identity file /Users/you/.ssh/id_rsa type -1 +> debug1: identity file /Users/you/.ssh/id_rsa-cert type -1 +> debug1: identity file /Users/you/.ssh/id_dsa type -1 +> debug1: identity file /Users/you/.ssh/id_dsa-cert type -1 +> ... +> debug1: Authentications that can continue: publickey +> debug1: Next authentication method: publickey +> debug1: Trying private key: /Users/you/.ssh/id_rsa +> debug1: Trying private key: /Users/you/.ssh/id_dsa +> debug1: No more authentication methods to try. +> Permission denied (publickey). + In that example, we did not have any keys for SSH to use. The "-1" at the end of the "identity file" lines means SSH couldn't find a file to use. Later on, the "Trying private key" lines also indicate that no file was found. If a file existed, those lines would be "1" and "Offering public key", respectively: @@ -167,7 +182,7 @@ You must provide your public key to {% data variables.product.product_name %} to $ eval "$(ssh-agent -s)" > Agent pid 59566 ``` -3. Find and take a note of your public key fingerprint. If you're using OpenSSH 6.7 or older: +3. Find and take a note of your public key fingerprint. **Tip**: On most systems the default private keys (`~/.ssh/id_rsa`{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}, `~/.ssh/id_dsa`{% endif %} and `~/.ssh/identity`) are automatically added to the SSH authentication agent. ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) @@ -178,10 +193,16 @@ You must provide your public key to {% data variables.product.product_name %} to $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -6. Compare the list of SSH keys with the output from the `ssh-add` command. ![SSH key listing in {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png) +6. Compare the list of SSH keys with the output from the `ssh-add` command. +![SSH key listing in {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png) {% endmac %} @@ -189,11 +210,10 @@ You must provide your public key to {% data variables.product.product_name %} to 1. Open the command line. 2. Start SSH agent in the background. - ```shell $ ssh-agent -s > Agent pid 59566 ``` -3. Find and take a note of your public key fingerprint. If you're using OpenSSH 6.7 or older: +3. Find and take a note of your public key fingerprint. **Tip**: On most systems the default private keys (`~/.ssh/id_rsa`{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}, `~/.ssh/id_dsa`{% endif %} and `~/.ssh/identity`) are automatically added to the SSH authentication agent. ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) @@ -204,10 +224,16 @@ You must provide your public key to {% data variables.product.product_name %} to $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -6. Compare the list of SSH keys with the output from the `ssh-add` command. ![SSH key listing in {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png) +6. Compare the list of SSH keys with the output from the `ssh-add` command. +![SSH key listing in {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png) {% endwindows %} diff --git a/translations/ru-RU/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md b/translations/ru-RU/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md index 9b265fad38a7..375e58f58e78 100644 --- a/translations/ru-RU/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md +++ b/translations/ru-RU/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md @@ -10,8 +10,8 @@ versions: The error you receive may look like the following: ```shell -$ git push -u github.master -> fatal: 'github.master' does not appear to be a git repository +$ git push -u github.main +> fatal: 'github.main' does not appear to be a git repository > fatal: The remote end hung up unexpectedly $ git pull -u github diff --git a/translations/ru-RU/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md b/translations/ru-RU/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md index 2f909e2cac5a..526ab993e58f 100644 --- a/translations/ru-RU/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md +++ b/translations/ru-RU/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md @@ -81,7 +81,8 @@ If you're unable to regain access to your account, generate a one-time password 1. On Facebook, navigate to your [Security Settings](https://www.facebook.com/settings?tab=security), then click **Recover Accounts Elsewhere**. ![Facebook security settings page with Recover Accounts Elsewhere link](/assets/images/help/settings/security-facebook-security-settings-page.png) 2. Click the recovery token associated with your {% data variables.product.product_name %} account. ![List of recovery tokens stored on Facebook](/assets/images/help/settings/security-github-rae-token-on-facebook.png) 3. To redeem your account recovery token, click **Recover This Account**. A new window will open, returning you to {% data variables.product.product_name %}. ![Modal box with information about your recovery token and Recover This Account button](/assets/images/help/settings/security-recover-account-facebook.png) -4. Contact {% data variables.contact.contact_support %} to let them know that your account recovery token is ready for review. +4. Контакт +{% data variables.contact.contact_support %} to let them know that your account recovery token is ready for review. {% endif %} ### Дополнительная литература diff --git a/translations/ru-RU/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md b/translations/ru-RU/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md index 3698dde42976..dce42bcc6baf 100644 --- a/translations/ru-RU/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md +++ b/translations/ru-RU/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md @@ -74,7 +74,7 @@ To illustrate how `git filter-branch` works, we'll show you how to remove your f "git rm --cached --ignore-unmatch PATH-TO-YOUR-FILE-WITH-SENSITIVE-DATA" \ --prune-empty --tag-name-filter cat -- --all > Rewrite 48dc599c80e20527ed902928085e7861e6b3cbe6 (266/266) - > Ref 'refs/heads/master' was rewritten + > Ref 'refs/heads/main' was rewritten ``` {% note %} @@ -89,7 +89,7 @@ To illustrate how `git filter-branch` works, we'll show you how to remove your f $ echo "YOUR-FILE-WITH-SENSITIVE-DATA" >> .gitignore $ git add .gitignore $ git commit -m "Add YOUR-FILE-WITH-SENSITIVE-DATA to .gitignore" - > [master 051452f] Add YOUR-FILE-WITH-SENSITIVE-DATA to .gitignore + > [main 051452f] Add YOUR-FILE-WITH-SENSITIVE-DATA to .gitignore > 1 files changed, 1 insertions(+), 0 deletions(-) ``` 5. Double-check that you've removed everything you wanted to from your repository's history, and that all of your branches are checked out. @@ -102,7 +102,7 @@ To illustrate how `git filter-branch` works, we'll show you how to remove your f > Writing objects: 100% (1058/1058), 148.85 KiB, done. > Total 1058 (delta 590), reused 602 (delta 378) > To https://{% data variables.command_line.codeblock %}/YOUR-USERNAME/YOUR-REPOSITORY.git - > + 48dc599...051452f master -> master (forced update) + > + 48dc599...051452f main -> main (forced update) ``` 7. In order to remove the sensitive file from [your tagged releases](/articles/about-releases), you'll also need to force-push against your Git tags: ```shell @@ -113,7 +113,7 @@ To illustrate how `git filter-branch` works, we'll show you how to remove your f > Writing objects: 100% (321/321), 331.74 KiB | 0 bytes/s, done. > Total 321 (delta 124), reused 269 (delta 108) > To https://{% data variables.command_line.codeblock %}/YOUR-USERNAME/YOUR-REPOSITORY.git - > + 48dc599...051452f master -> master (forced update) + > + 48dc599...051452f main -> main (forced update) ``` 8. Contact {% data variables.contact.contact_support %}, asking them to remove cached views and references to the sensitive data in pull requests on {% data variables.product.product_name %}. 9. Tell your collaborators to [rebase](https://git-scm.com/book/en/Git-Branching-Rebasing), *not* merge, any branches they created off of your old (tainted) repository history. One merge commit could reintroduce some or all of the tainted history that you just went to the trouble of purging. diff --git a/translations/ru-RU/content/github/authenticating-to-github/reviewing-your-security-log.md b/translations/ru-RU/content/github/authenticating-to-github/reviewing-your-security-log.md index 4a6fa34f2703..c75274f6d41d 100644 --- a/translations/ru-RU/content/github/authenticating-to-github/reviewing-your-security-log.md +++ b/translations/ru-RU/content/github/authenticating-to-github/reviewing-your-security-log.md @@ -31,22 +31,22 @@ The security log lists all actions performed within the last 90 days{% if curren ### Understanding events in your security log Actions listed in your security log are grouped within the following categories: |{% endif %} -| Category Name | Description | -| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |{% if currentVersion == "free-pro-team@latest" %} -| `account_recovery_token` | Contains all activities related to [adding a recovery token](/articles/configuring-two-factor-authentication-recovery-methods). | -| `биллинг` | Contains all activities related to your billing information. | -| `marketplace_agreement_signature` | Contains all activities related to signing the {% data variables.product.prodname_marketplace %} Developer Agreement. | -| `marketplace_listing` | Contains all activities related to listing apps in {% data variables.product.prodname_marketplace %}.{% endif %} -| `oauth_access` | Contains all activities related to [{% data variables.product.prodname_oauth_app %}s](/articles/authorizing-oauth-apps) you've connected with.{% if currentVersion == "free-pro-team@latest" %} -| `payment_method` | Contains all activities related to paying for your {% data variables.product.prodname_dotcom %} subscription.{% endif %} -| `profile_picture` | Contains all activities related to your profile picture. | -| `проект` | Contains all activities related to project boards. | -| `public_key` | Contains all activities related to [your public SSH keys](/articles/adding-a-new-ssh-key-to-your-github-account). | -| `repo` | Contains all activities related to the repositories you own.{% if currentVersion == "free-pro-team@latest" %} -| `sponsors` | Contains all events related to {% data variables.product.prodname_sponsors %} and sponsor buttons (see "[About {% data variables.product.prodname_sponsors %}](/articles/about-github-sponsors)" and "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)"){% endif %}{% if currentVersion != "free-pro-team@latest" %} -| `команда` | Contains all activities related to teams you are a part of.{% endif %} -| `two_factor_authentication` | Contains all activities related to [two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa). | -| `пользователь` | Contains all activities related to your account. | +| Category Name | Description | +| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |{% if currentVersion == "free-pro-team@latest" %} +| `account_recovery_token` | Contains all activities related to [adding a recovery token](/articles/configuring-two-factor-authentication-recovery-methods). | +| `выставление счетов` | Contains all activities related to your billing information. | +| `marketplace_agreement_signature` | Contains all activities related to signing the {% data variables.product.prodname_marketplace %} Developer Agreement. | +| `marketplace_listing` | Contains all activities related to listing apps in {% data variables.product.prodname_marketplace %}.{% endif %} +| `oauth_access` | Contains all activities related to [{% data variables.product.prodname_oauth_app %}s](/articles/authorizing-oauth-apps) you've connected with.{% if currentVersion == "free-pro-team@latest" %} +| `payment_method` | Contains all activities related to paying for your {% data variables.product.prodname_dotcom %} subscription.{% endif %} +| `profile_picture` | Contains all activities related to your profile picture. | +| `проект` | Contains all activities related to project boards. | +| `public_key` | Contains all activities related to [your public SSH keys](/articles/adding-a-new-ssh-key-to-your-github-account). | +| `repo` | Contains all activities related to the repositories you own.{% if currentVersion == "free-pro-team@latest" %} +| `sponsors` | Contains all events related to {% data variables.product.prodname_sponsors %} and sponsor buttons (see "[About {% data variables.product.prodname_sponsors %}](/articles/about-github-sponsors)" and "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)"){% endif %}{% if currentVersion != "free-pro-team@latest" %} +| `команда` | Contains all activities related to teams you are a part of.{% endif %} +| `two_factor_authentication` | Contains all activities related to [two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa). | +| `пользователь` | Contains all activities related to your account. | A description of the events within these categories is listed below. @@ -58,37 +58,37 @@ A description of the events within these categories is listed below. | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | confirm | Triggered when you successfully [store a new token with a recovery provider](/articles/configuring-two-factor-authentication-recovery-methods). | | recover | Triggered when you successfully [redeem an account recovery token](/articles/recovering-your-account-if-you-lose-your-2fa-credentials). | -| recover_error | Triggered when a token is used but {% data variables.product.prodname_dotcom %} is not able to validate it. | +| recover_error | Triggered when a token is used but {% data variables.product.prodname_dotcom %} is not able to validate it. | #### The `billing` category -| Действие | Description | -| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | +| Действие | Description | +| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | | change_billing_type | Triggered when you [change how you pay](/articles/adding-or-editing-a-payment-method) for {% data variables.product.prodname_dotcom %}. | -| change_email | Triggered when you [change your email address](/articles/changing-your-primary-email-address). | +| change_email | Triggered when you [change your email address](/articles/changing-your-primary-email-address). | #### The `marketplace_agreement_signature` category -| Действие | Description | -| -------- | ------------------------------------------------------------------------------------------------------- | +| Действие | Description | +| -------- | -------------------------------------------------------------------------------------------------- | | create | Triggered when you sign the {% data variables.product.prodname_marketplace %} Developer Agreement. | #### The `marketplace_listing` category -| Действие | Description | -| --------- | -------------------------------------------------------------------------------------------------------------------- | +| Действие | Description | +| --------- | --------------------------------------------------------------------------------------------------------------- | | утвердить | Triggered when your listing is approved for inclusion in {% data variables.product.prodname_marketplace %}. | | create | Triggered when you create a listing for your app in {% data variables.product.prodname_marketplace %}. | | delist | Triggered when your listing is removed from {% data variables.product.prodname_marketplace %}. | -| redraft | Triggered when your listing is sent back to draft state. | +| redraft | Triggered when your listing is sent back to draft state. | | reject | Triggered when your listing is not accepted for inclusion in {% data variables.product.prodname_marketplace %}. | {% endif %} #### The `oauth_access` category -| Действие | Description | -| -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Действие | Description | +| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | create | Triggered when you [grant access to an {% data variables.product.prodname_oauth_app %}](/articles/authorizing-oauth-apps). | | destroy | Triggered when you [revoke an {% data variables.product.prodname_oauth_app %}'s access to your account](/articles/reviewing-your-authorized-integrations). | @@ -125,53 +125,53 @@ A description of the events within these categories is listed below. #### The `public_key` category -| Действие | Description | -| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Действие | Description | +| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | create | Triggered when you [add a new public SSH key to your {% data variables.product.product_name %} account](/articles/adding-a-new-ssh-key-to-your-github-account). | | delete - Удалить | Triggered when you [remove a public SSH key to your {% data variables.product.product_name %} account](/articles/reviewing-your-ssh-keys). | #### The `repo` category -| Действие | Description | -| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| access | Triggered when you a repository you own is [switched from "private" to "public"](/articles/making-a-private-repository-public) (or vice versa). | +| Действие | Description | +| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| access | Triggered when you a repository you own is [switched from "private" to "public"](/articles/making-a-private-repository-public) (or vice versa). | | add_member | Triggered when a {% data variables.product.product_name %} user is {% if currentVersion == "free-pro-team@latest" %}[invited to have collaboration access](/articles/inviting-collaborators-to-a-personal-repository){% else %}[given collaboration access](/articles/inviting-collaborators-to-a-personal-repository){% endif %} to a repository. | -| add_topic | Triggered when a repository owner [adds a topic](/articles/classifying-your-repository-with-topics) to a repository. | +| add_topic | Triggered when a repository owner [adds a topic](/articles/classifying-your-repository-with-topics) to a repository. | | archived | Triggered when a repository owner [archives a repository](/articles/about-archiving-repositories).{% if currentVersion != "free-pro-team@latest" %} -| config.disable_anonymous_git_access | Triggered when [anonymous Git read access is disabled](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) in a public repository. | -| config.enable_anonymous_git_access | Triggered when [anonymous Git read access is enabled](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) in a public repository. | -| config.lock_anonymous_git_access | Triggered when a repository's [anonymous Git read access setting is locked](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access). | +| config.disable_anonymous_git_access | Triggered when [anonymous Git read access is disabled](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) in a public repository. | +| config.enable_anonymous_git_access | Triggered when [anonymous Git read access is enabled](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) in a public repository. | +| config.lock_anonymous_git_access | Triggered when a repository's [anonymous Git read access setting is locked](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access). | | config.unlock_anonymous_git_access | Triggered when a repository's [anonymous Git read access setting is unlocked](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access).{% endif %} -| create | Triggered when [a new repository is created](/articles/creating-a-new-repository). | +| create | Triggered when [a new repository is created](/articles/creating-a-new-repository). | | destroy | Triggered when [a repository is deleted](/articles/deleting-a-repository).{% if currentVersion == "free-pro-team@latest" %} -| деактивировать | Triggered when a repository is disabled (e.g., for [insufficient funds](/articles/unlocking-a-locked-account)).{% endif %}{% if currentVersion == "free-pro-team@latest" %} -| активировать | Triggered when a repository is re-enabled.{% endif %} -| remove_member | Triggered when a {% data variables.product.product_name %} user is [removed from a repository as a collaborator](/articles/removing-a-collaborator-from-a-personal-repository). | -| remove_topic | Triggered when a repository owner removes a topic from a repository. | -| rename | Triggered when [a repository is renamed](/articles/renaming-a-repository). | -| передача | Triggered when [a repository is transferred](/articles/how-to-transfer-a-repository). | -| transfer_start | Triggered when a repository transfer is about to occur. | -| unarchived | Triggered when a repository owner unarchives a repository. | +| отключить | Triggered when a repository is disabled (e.g., for [insufficient funds](/articles/unlocking-a-locked-account)).{% endif %}{% if currentVersion == "free-pro-team@latest" %} +| включить | Triggered when a repository is re-enabled.{% endif %} +| remove_member | Triggered when a {% data variables.product.product_name %} user is [removed from a repository as a collaborator](/articles/removing-a-collaborator-from-a-personal-repository). | +| remove_topic | Triggered when a repository owner removes a topic from a repository. | +| rename | Triggered when [a repository is renamed](/articles/renaming-a-repository). | +| передача | Triggered when [a repository is transferred](/articles/how-to-transfer-a-repository). | +| transfer_start | Triggered when a repository transfer is about to occur. | +| unarchived | Triggered when a repository owner unarchives a repository. | {% if currentVersion == "free-pro-team@latest" %} #### The `sponsors` category -| Действие | Description | -| ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| repo_funding_link_button_toggle | Triggered when you enable or disable a sponsor button in your repository (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)") | -| repo_funding_links_file_action | Triggered when you change the FUNDING file in your repository (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)") | -| sponsor_sponsorship_cancel | Triggered when you cancel a sponsorship (see "[Downgrading a sponsorship](/articles/downgrading-a-sponsorship)") | -| sponsor_sponsorship_create | Triggered when you sponsor a developer (see "[Sponsoring an open source contributor](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor#sponsoring-a-developer)") | -| sponsor_sponsorship_preference_change | Triggered when you change whether you receive email updates from a sponsored developer (see "[Managing your sponsorship](/articles/managing-your-sponsorship)") | -| sponsor_sponsorship_tier_change | Triggered when you upgrade or downgrade your sponsorship (see "[Upgrading a sponsorship](/articles/upgrading-a-sponsorship)" and "[Downgrading a sponsorship](/articles/downgrading-a-sponsorship)") | +| Действие | Description | +| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| repo_funding_link_button_toggle | Triggered when you enable or disable a sponsor button in your repository (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)") | +| repo_funding_links_file_action | Triggered when you change the FUNDING file in your repository (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)") | +| sponsor_sponsorship_cancel | Triggered when you cancel a sponsorship (see "[Downgrading a sponsorship](/articles/downgrading-a-sponsorship)") | +| sponsor_sponsorship_create | Triggered when you sponsor a developer (see "[Sponsoring an open source contributor](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor#sponsoring-a-developer)") | +| sponsor_sponsorship_preference_change | Triggered when you change whether you receive email updates from a sponsored developer (see "[Managing your sponsorship](/articles/managing-your-sponsorship)") | +| sponsor_sponsorship_tier_change | Triggered when you upgrade or downgrade your sponsorship (see "[Upgrading a sponsorship](/articles/upgrading-a-sponsorship)" and "[Downgrading a sponsorship](/articles/downgrading-a-sponsorship)") | | sponsored_developer_approve | Triggered when your {% data variables.product.prodname_sponsors %} account is approved (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") | | sponsored_developer_create | Triggered when your {% data variables.product.prodname_sponsors %} account is created (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") | -| sponsored_developer_profile_update | Triggered when you edit your sponsored developer profile (see "[Editing your profile details for {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors)") | +| sponsored_developer_profile_update | Triggered when you edit your sponsored developer profile (see "[Editing your profile details for {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors)") | | sponsored_developer_request_approval | Triggered when you submit your application for {% data variables.product.prodname_sponsors %} for approval (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") | -| sponsored_developer_tier_description_update | Triggered when you change the description for a sponsorship tier (see "[Changing your sponsorship tiers](/articles/changing-your-sponsorship-tiers)") | -| sponsored_developer_update_newsletter_send | Triggered when you send an email update to your sponsors (see "[Contacting your sponsors](/articles/contacting-your-sponsors)") | +| sponsored_developer_tier_description_update | Triggered when you change the description for a sponsorship tier (see "[Changing your sponsorship tiers](/articles/changing-your-sponsorship-tiers)") | +| sponsored_developer_update_newsletter_send | Triggered when you send an email update to your sponsors (see "[Contacting your sponsors](/articles/contacting-your-sponsors)") | | waitlist_invite_sponsored_developer | Triggered when you are invited to join {% data variables.product.prodname_sponsors %} from the waitlist (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") | -| waitlist_join | Triggered when you join the waitlist to become a sponsored developer (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") | +| waitlist_join | Triggered when you join the waitlist to become a sponsored developer (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") | {% endif %} {% if currentVersion == "free-pro-team@latest" %} @@ -210,18 +210,18 @@ A description of the events within these categories is listed below. #### The `user` category -| Действие | Description | -| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| add_email | Triggered when you [add a new email address](/articles/changing-your-primary-email-address). | -| create | Triggered when you create a new user account. | -| remove_email | Triggered when you remove an email address. | -| rename | Triggered when you rename your account. | -| change_password | Triggered when you change your password. | -| forgot_password | Triggered when you ask for [a password reset](/articles/how-can-i-reset-my-password). | -| login | Triggered when you log in to {% data variables.product.product_location %}. | -| failed_login | Triggered when you failed to log in successfully. | -| two_factor_requested | Triggered when {% data variables.product.product_name %} asks you for [your two-factor authentication code](/articles/accessing-github-using-two-factor-authentication). | -| show_private_contributions_count | Triggered when you [publicize private contributions on your profile](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile). | +| Действие | Description | +| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| add_email | Triggered when you [add a new email address](/articles/changing-your-primary-email-address). | +| create | Triggered when you create a new user account. | +| remove_email | Triggered when you remove an email address. | +| rename | Triggered when you rename your account. | +| change_password | Triggered when you change your password. | +| forgot_password | Triggered when you ask for [a password reset](/articles/how-can-i-reset-my-password). | +| login | Triggered when you log in to {% data variables.product.product_location %}. | +| failed_login | Triggered when you failed to log in successfully. | +| two_factor_requested | Triggered when {% data variables.product.product_name %} asks you for [your two-factor authentication code](/articles/accessing-github-using-two-factor-authentication). | +| show_private_contributions_count | Triggered when you [publicize private contributions on your profile](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile). | | hide_private_contributions_count | Triggered when you [hide private contributions on your profile](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile).{% if currentVersion == "free-pro-team@latest" %} | report_content | Triggered when you [report an issue or pull request, or a comment on an issue, pull request, or commit](/articles/reporting-abuse-or-spam).{% endif %} diff --git a/translations/ru-RU/content/github/authenticating-to-github/reviewing-your-ssh-keys.md b/translations/ru-RU/content/github/authenticating-to-github/reviewing-your-ssh-keys.md index 5a1e3dfd958f..d3d129be9b14 100644 --- a/translations/ru-RU/content/github/authenticating-to-github/reviewing-your-ssh-keys.md +++ b/translations/ru-RU/content/github/authenticating-to-github/reviewing-your-ssh-keys.md @@ -20,7 +20,7 @@ You can delete unauthorized (or possibly compromised) SSH keys to ensure that an {% tip %} - **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys. ![Unverified SSH key](/assets/images/help/settings/settings-ssh-key-review-highlight.png) + **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys. {% endtip %} @@ -28,7 +28,7 @@ You can delete unauthorized (or possibly compromised) SSH keys to ensure that an 5. {% data reusables.command_line.start_ssh_agent %} -6. Find and take a note of your public key fingerprint. If you're using OpenSSH 6.7 or older: +6. Find and take a note of your public key fingerprint. **Tip**: On most systems the default private keys (`~/.ssh/id_rsa`{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}, `~/.ssh/id_dsa`{% endif %} and `~/.ssh/identity`) are automatically added to the SSH authentication agent. ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) @@ -39,6 +39,11 @@ You can delete unauthorized (or possibly compromised) SSH keys to ensure that an $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} 7. The SSH keys on {% data variables.product.product_name %} *should* match the same keys on your computer. @@ -48,11 +53,12 @@ You can delete unauthorized (or possibly compromised) SSH keys to ensure that an {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -3. On the SSH Settings page, take note of the SSH keys associated with your account. For those that you don't recognize, or that are out-of-date, click **Delete**. If there are valid SSH keys you'd like to keep, click **Approve**. ![SSH key list](/assets/images/help/settings/settings-ssh-key-review.png) +3. On the SSH Settings page, take note of the SSH keys associated with your account. For those that you don't recognize, or that are out-of-date, click **Delete**. If there are valid SSH keys you'd like to keep, click **Approve**. + ![SSH key list](/assets/images/help/settings/settings-ssh-key-review.png) {% tip %} - **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys.![Unverified SSH key](/assets/images/help/settings/settings-ssh-key-review-highlight.png) + **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys. {% endtip %} @@ -62,7 +68,7 @@ You can delete unauthorized (or possibly compromised) SSH keys to ensure that an {% data reusables.desktop.windows_git_for_windows_turn_on_ssh_agent %} -6. Find and take a note of your public key fingerprint. If you're using OpenSSH 6.7 or older: +6. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) @@ -73,6 +79,11 @@ You can delete unauthorized (or possibly compromised) SSH keys to ensure that an $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} 7. The SSH keys on {% data variables.product.product_name %} *should* match the same keys on your computer. @@ -82,11 +93,12 @@ You can delete unauthorized (or possibly compromised) SSH keys to ensure that an {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -3. On the SSH Settings page, take note of the SSH keys associated with your account. For those that you don't recognize, or that are out-of-date, click **Delete**. If there are valid SSH keys you'd like to keep, click **Approve**. ![SSH key list](/assets/images/help/settings/settings-ssh-key-review.png) +3. On the SSH Settings page, take note of the SSH keys associated with your account. For those that you don't recognize, or that are out-of-date, click **Delete**. If there are valid SSH keys you'd like to keep, click **Approve**. + ![SSH key list](/assets/images/help/settings/settings-ssh-key-review.png) {% tip %} - **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys. ![Unverified SSH key](/assets/images/help/settings/settings-ssh-key-review-highlight.png) + **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys. {% endtip %} @@ -94,7 +106,7 @@ You can delete unauthorized (or possibly compromised) SSH keys to ensure that an 5. {% data reusables.command_line.start_ssh_agent %} -6. Find and take a note of your public key fingerprint. If you're using OpenSSH 6.7 or older: +6. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) @@ -105,6 +117,9 @@ You can delete unauthorized (or possibly compromised) SSH keys to ensure that an $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} +```shell $ ssh-add -l -E sha256 +> 2048 *SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ* /Users/*USERNAME*/.ssh/id_rsa (RSA) ```{% endif %} 7. The SSH keys on {% data variables.product.product_name %} *should* match the same keys on your computer. diff --git a/translations/ru-RU/content/github/authenticating-to-github/signing-commits.md b/translations/ru-RU/content/github/authenticating-to-github/signing-commits.md index 602f445e9c96..3a4abe1fc676 100644 --- a/translations/ru-RU/content/github/authenticating-to-github/signing-commits.md +++ b/translations/ru-RU/content/github/authenticating-to-github/signing-commits.md @@ -39,7 +39,8 @@ If you have multiple keys or are attempting to sign commits or tags with a key t $ git push # Pushes your local commits to the remote repository ``` -4. On {% data variables.product.product_name %}, navigate to your pull request. +4. On +{% data variables.product.product_name %}, navigate to your pull request. {% data reusables.repositories.review-pr-commits %} 5. To view more detailed information about the verified signature, click Verified. ![Signed commit](/assets/images/help/commits/gpg-signed-commit-verified-without-details.png) diff --git a/translations/ru-RU/content/github/authenticating-to-github/updating-your-github-access-credentials.md b/translations/ru-RU/content/github/authenticating-to-github/updating-your-github-access-credentials.md index 34f12799ceb7..b43565ee5a8a 100644 --- a/translations/ru-RU/content/github/authenticating-to-github/updating-your-github-access-credentials.md +++ b/translations/ru-RU/content/github/authenticating-to-github/updating-your-github-access-credentials.md @@ -29,11 +29,7 @@ To avoid losing your password in the future, we suggest using a secure password 1. {% data variables.product.signin_link %} to {% data variables.product.product_name %}. {% data reusables.user_settings.access_settings %} -{%- if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} {% data reusables.user_settings.security %} -{%- else %} -{% data reusables.user_settings.account_settings %} -{%- endif %} 4. Under "Change password", type your old password, a strong new password, and confirm your new password. For help creating a strong password, see "[Creating a strong password](/articles/creating-a-strong-password)" 5. Click **Update password**. diff --git a/translations/ru-RU/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md b/translations/ru-RU/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md index f25556457135..6cdcca7fcab6 100644 --- a/translations/ru-RU/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md +++ b/translations/ru-RU/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md @@ -58,7 +58,7 @@ fi unset env ``` -If your private key is not stored in one of the default locations (like `~/.ssh/id_rsa`{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} or `~/.ssh/id_dsa`{% endif %}), you'll need to tell your SSH authentication agent where to find it. To add your key to ssh-agent, type `ssh-add ~/path/to/my_key`. For more information, see "[Generating a new SSH key and adding it to the ssh-agent](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/)" +If your private key is not stored in one of the default locations (like `~/.ssh/id_rsa`), you'll need to tell your SSH authentication agent where to find it. To add your key to ssh-agent, type `ssh-add ~/path/to/my_key`. For more information, see "[Generating a new SSH key and adding it to the ssh-agent](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/)" {% tip %} @@ -89,8 +89,7 @@ The `ssh-agent` process will continue to run until you log out, shut down your c On OS X Leopard through OS X El Capitan, these default private key files are handled automatically: -- *.ssh/id_rsa*{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -- *.ssh/id_dsa*{% endif %} +- *.ssh/id_rsa* - *.ssh/identity* The first time you use your key, you will be prompted to enter your passphrase. If you choose to save the passphrase with your keychain, you won't have to enter it again. diff --git a/translations/ru-RU/content/github/building-a-strong-community/configuring-issue-templates-for-your-repository.md b/translations/ru-RU/content/github/building-a-strong-community/configuring-issue-templates-for-your-repository.md index a2858c55b620..29624fbbf4a8 100644 --- a/translations/ru-RU/content/github/building-a-strong-community/configuring-issue-templates-for-your-repository.md +++ b/translations/ru-RU/content/github/building-a-strong-community/configuring-issue-templates-for-your-repository.md @@ -24,7 +24,7 @@ versions: 7. To automatically set a default issue title, assign the issue to people with read access to the repository, or apply labels to your issue template, enter these details under "Optional additional information." You can also add these details in the issue template with `title`, `labels`, or `assignees` in a YAML frontmatter format. ![Additional info for issue template](/assets/images/help/repository/additional-issue-template-info.png) 8. When you're finished editing and previewing your template, click **Propose changes** in the upper right corner of the page. ![Propose changes button](/assets/images/help/repository/propose-changes-button.png) 9. Enter a commit message describing your changes. ![Issue template commit message field](/assets/images/help/repository/issue-template-commit-message-field.png) -10. Below the commit message fields, decide whether to commit your template directly to the default branch, or to create a new branch and open a pull request. For more information about pull requests, see "[About pull requests](/articles/about-pull-requests)." ![Issue template commit to master or open pull request choice](/assets/images/help/repository/issue-template-commit-to-master-or-open-pull-request.png) +10. Below the commit message fields, decide whether to commit your template directly to the default branch, or to create a new branch and open a pull request. For more information about pull requests, see "[About pull requests](/articles/about-pull-requests)." ![Issue template commit to main or open pull request choice](/assets/images/help/repository/issue-template-commit-to-master-or-open-pull-request.png) 11. Click **Commit changes**. Once these changes are merged into the default branch, the template will be available for contributors to use when they open new issues in the repository. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} diff --git a/translations/ru-RU/content/github/building-a-strong-community/creating-a-default-community-health-file.md b/translations/ru-RU/content/github/building-a-strong-community/creating-a-default-community-health-file.md index 6cd4a1a958af..b4595e15781e 100644 --- a/translations/ru-RU/content/github/building-a-strong-community/creating-a-default-community-health-file.md +++ b/translations/ru-RU/content/github/building-a-strong-community/creating-a-default-community-health-file.md @@ -26,14 +26,14 @@ Default files are not included in clones, packages, or downloads of individual r You can create defaults in your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %} for the following community health files: -| Community health file | Description | -| --------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" %} -| *CODE_OF_CONDUCT.md* | A CODE_OF_CONDUCT file defines standards for how to engage in a community. For more information, see "[Adding a code of conduct to your project](/articles/adding-a-code-of-conduct-to-your-project/)."{% endif %} -| *CONTRIBUTING.md* | A CONTRIBUTING file communicates how people should contribute to your project. For more information, see "[Setting guidelines for repository contributors](/articles/setting-guidelines-for-repository-contributors/)."{% if currentVersion == "free-pro-team@latest" %} -| *FUNDING.yml* | A FUNDING file displays a sponsor button in your repository to increase the visibility of funding options for your open source project. For more information, see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)."{% endif %} +| Community health file | Description | +| --------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" %} +| *CODE_OF_CONDUCT.md* | A CODE_OF_CONDUCT file defines standards for how to engage in a community. For more information, see "[Adding a code of conduct to your project](/articles/adding-a-code-of-conduct-to-your-project/)."{% endif %} +| *CONTRIBUTING.md* | A CONTRIBUTING file communicates how people should contribute to your project. For more information, see "[Setting guidelines for repository contributors](/articles/setting-guidelines-for-repository-contributors/)."{% if currentVersion == "free-pro-team@latest" %} +| *FUNDING.yml* | A FUNDING file displays a sponsor button in your repository to increase the visibility of funding options for your open source project. For more information, see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)."{% endif %} | Issue and pull request templates{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and *config.yml*{% endif %} | Issue and pull request templates customize and standardize the information you'd like contributors to include when they open issues and pull requests in your repository. For more information, see "[About issue and pull request templates](/articles/about-issue-and-pull-request-templates/)."{% if currentVersion == "free-pro-team@latest" %} -| *SECURITY.md* | A SECURITY file gives instructions for how to responsibly report a security vulnerability in your project. For more information, see "[Adding a security policy to your repository](/articles/adding-a-security-policy-to-your-repository)."{% endif %} -| *SUPPORT.md* | A SUPPORT file lets people know about ways to get help with your project. For more information, see "[Adding support resources to your project](/articles/adding-support-resources-to-your-project/)." | +| *SECURITY.md* | A SECURITY file gives instructions for how to responsibly report a security vulnerability in your project. For more information, see "[Adding a security policy to your repository](/articles/adding-a-security-policy-to-your-repository)."{% endif %} +| *SUPPORT.md* | A SUPPORT file lets people know about ways to get help with your project. For more information, see "[Adding support resources to your project](/articles/adding-support-resources-to-your-project/)." | You cannot create a default license file. License files must be added to individual repositories so the file will be included when a project is cloned, packaged, or downloaded. @@ -42,7 +42,7 @@ You cannot create a default license file. License files must be added to individ {% data reusables.repositories.create_new %} 2. Use the **Owner** drop-down menu, and select the organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %} you want to create default files for. ![Owner drop-down menu](/assets/images/help/repository/create-repository-owner.png) 3. Type **.github** as the name for your repository, and an optional description. ![Create repository field](/assets/images/help/repository/default-file-repository-name.png) -4. Choose to make the repository public. ![Radio buttons to select private or public status](/assets/images/help/repository/create-repository-public-private.png) +4. Make sure the repository status is set to **Public** (a repository for default files cannot be private). ![Radio buttons to select private or public status](/assets/images/help/repository/create-repository-public-private.png) {% data reusables.repositories.initialize-with-readme %} {% data reusables.repositories.create-repo %} 7. In the repository, create one of the supported community health files. Issue templates{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and their configuration file{% endif %} must be in a folder called `.github/ISSUE_TEMPLATE`. All other supported files must be in the root of the repository. For more information, see "[Creating new files](/articles/creating-new-files/)." diff --git a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/about-branches.md b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/about-branches.md index 434242db6f06..bbc8955fd109 100644 --- a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/about-branches.md +++ b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/about-branches.md @@ -10,28 +10,30 @@ versions: --- -### Introducing branches +### About branches Branches allow you to develop features, fix bugs, or safely experiment with new ideas in a contained area of your repository. You always create a branch from an existing branch. Typically, you might create a new branch from the default branch of your repository. You can then work on this new branch in isolation from changes that other people are making to the repository. A branch you create to build a feature is commonly referred to as a feature branch or topic branch. For more information, see "[Creating and deleting branches within your repository](/articles/creating-and-deleting-branches-within-your-repository/)." -You can also use a branch to publish a {% data variables.product.prodname_pages %} site. For more information, see "[What is {% data variables.product.prodname_dotcom %} Pages?](/articles/what-is-github-pages)" +You can also use a branch to publish a {% data variables.product.prodname_pages %} site. For more information, see "[About {% data variables.product.prodname_pages %}](/articles/what-is-github-pages)." -You must have write access to a repository to create a branch, open a pull request, or delete and restore branches in a pull request. For more information, see "[Access permissions on {% data variables.product.product_name %}](/articles/access-permissions-on-github)." +You must have write access to a repository to create a branch, open a pull request, or delete and restore branches in a pull request. For more information, see "[Access permissions on {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/access-permissions-on-github)." ### About the default branch {% data reusables.branches.new-repo-default-branch %} The default branch is the branch that {% data variables.product.prodname_dotcom %} displays when anyone visits your repository. The default branch is also the initial branch that Git checks out locally out when someone clones the repository. {% data reusables.branches.default-branch-automatically-base-branch %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +By default, {% data variables.product.product_name %} names the default branch {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.23" %}`main`{% else %}`master`{% endif %} in any new repository. -By default, the default branch name is `master`, but you can set the name to anything that makes sense for your workflow. For more information on the default branch name, see "[Managing the default branch name for your repositories](/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories)." +{% data reusables.branches.change-default-branch %} -{% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} {% data reusables.branches.set-default-branch %} +{% endif %} + ### Working with branches Once you're satisfied with your work, you can open a pull request to merge the changes in the current branch (the *head* branch) into another branch (the *base* branch). For more information, see "[About pull requests](/articles/about-pull-requests)." diff --git a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md index 96916cf5fd2a..666c361ba3e2 100644 --- a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md +++ b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md @@ -38,7 +38,7 @@ You can also choose to ignore whitespace changes to get a more accurate view of ![Diff viewing options menu](/assets/images/help/pull_requests/diff-settings-menu.png) -To simplify reviewing changes in a large pull request, you can filter the diff to only show selected file types{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}, show files you are a CODEOWNER of, hide files you have already viewed,{% endif %} or hide deleted files. For more information, see "[Filtering files in a pull request by file type](/articles/filtering-files-in-a-pull-request)." +To simplify reviewing changes in a large pull request, you can filter the diff to only show selected file types, show files you are a CODEOWNER of, hide files you have already viewed, or hide deleted files. For more information, see "[Filtering files in a pull request by file type](/articles/filtering-files-in-a-pull-request)." ![File filter drop-down menu](/assets/images/help/pull_requests/file-filter-menu.png) @@ -54,7 +54,7 @@ A two-dot diff compares two Git committish references, such as SHAs or OIDs (Obj If you want to simulate a two-dot diff in a pull request and see a comparison between the most recent versions of each branch, you can merge the base branch into your topic branch, which updates the last common ancestor between your branches. -For more information about Git commands to compare changes, see "[Git diff options ](https://git-scm.com/docs/git-diff#git-diff-emgitdiffemltoptionsgtltcommitgtltcommitgt--ltpathgt82308203)" from the _Pro Git_ book site. +For more information about Git commands to compare changes, see "[Git diff options](https://git-scm.com/docs/git-diff#git-diff-emgitdiffemltoptionsgtltcommitgtltcommitgt--ltpathgt82308203)" from the _Pro Git_ book site. ### Reasons diffs will not display - You've exceeded the total limit of files or certain file types. For more information, see "[Limits for viewing content and diffs in a repository](/articles/limits-for-viewing-content-and-diffs-in-a-repository/#diff-limits)." diff --git a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/about-forks.md b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/about-forks.md index 3be8803485bd..1adada4be2f5 100644 --- a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/about-forks.md +++ b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/about-forks.md @@ -23,7 +23,7 @@ In open source projects, forks are often used to iterate on ideas or changes bef {% data reusables.repositories.private_forks_inherit_permissions %} -If you want to create a new repository from the contents of an existing repository but don't want to merge your changes upstream in the future, you can duplicate the repository {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}or, if the repository is a template, use the repository as a template{% endif %}. For more information, see "[Duplicating a repository](/articles/duplicating-a-repository)"{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} and [Creating a repository from a template](/articles/creating-a-repository-from-a-template)"{% endif %}. +If you want to create a new repository from the contents of an existing repository but don't want to merge your changes upstream in the future, you can duplicate the repository or, if the repository is a template, use the repository as a template. For more information, see "[Duplicating a repository](/articles/duplicating-a-repository)" and [Creating a repository from a template](/articles/creating-a-repository-from-a-template)". ### Дополнительная литература diff --git a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md index 9f271f36dc22..dacac35e51df 100644 --- a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md +++ b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md @@ -46,7 +46,7 @@ You can navigate between the checks summaries for various commits in a pull requ #### Skipping and requesting checks for individual commits -When a repository is set to automatically request checks for pushes, you can choose to skip checks for an individual commit you push. When a repository is _not_ set to automatically request checks for pushes, you can request checks for an individual commit you push. For more information on these settings, see "[Check Suites](/v3/checks/suites/#set-preferences-for-check-suites-on-a-repository)." +When a repository is set to automatically request checks for pushes, you can choose to skip checks for an individual commit you push. When a repository is _not_ set to automatically request checks for pushes, you can request checks for an individual commit you push. For more information on these settings, see "[Check Suites](/rest/reference/checks#update-repository-preferences-for-check-suites)." To skip or request checks for your commit, add one of the following trailer lines to the end of your commit message: diff --git a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md index 02fad626e039..0eb33a1f4f30 100644 --- a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md +++ b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md @@ -22,7 +22,9 @@ Only the user who created the pull request can give you permission to push commi {% endnote %} -1. On {% data variables.product.product_name %}, navigate to the main page of the fork (or copy of your repository) where the pull request branch was created. +1. On + +{% data variables.product.product_name %}, navigate to the main page of the fork (or copy of your repository) where the pull request branch was created. {% data reusables.repositories.copy-clone-url %} {% data reusables.command_line.open_the_multi_os_terminal %} {% tip %} diff --git a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md index b6c1a96231a0..8247fd24a0ad 100644 --- a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md +++ b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md @@ -18,7 +18,7 @@ You can specify which branch you'd like to merge your changes into when you crea ### Changing the branch range and destination repository -By default, pull requests are based on the parent repository's [default branch](/articles/setting-the-default-branch). +By default, pull requests are based on the parent repository's [default branch](/articles/setting-the-default-branch). For more information, see "[About branches](/github/collaborating-with-issues-and-pull-requests/about-branches#about-the-default-branch)." If the default parent repository isn't correct, you can change both the parent repository and the branch with the drop-down lists. You can also swap your head and base branches with the drop-down lists to establish diffs between reference points. References here must be branch names in your GitHub repository. diff --git a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md index eb900ad39f07..df6e734dee68 100644 --- a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md +++ b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md @@ -21,7 +21,7 @@ versions: {% data reusables.pull_requests.automatically-delete-branches %} -If the branch you want to delete is the repository's default branch, you must choose a new default branch before deleting the branch. For more information, see "[Setting the default branch](/github/administering-a-repository/setting-the-default-branch)." +If the branch you want to delete is the repository's default branch, you must choose a new default branch before deleting the branch. For more information, see "[Changing the default branch](/github/administering-a-repository/changing-the-default-branch)." If the branch you want to delete is associated with an open pull request, you must merge or close the pull request before deleting the branch. For more information, see "[Merging a pull request](/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request)" or "[Closing a pull request](/github/collaborating-with-issues-and-pull-requests/closing-a-pull-request)." diff --git a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md index cf41118ee3b6..b4c86e3a5afe 100644 --- a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md +++ b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md @@ -14,14 +14,10 @@ This changes the status of the review to a review comment. When you dismiss a re {% data reusables.search.requested_reviews_search %} {% data reusables.repositories.sidebar-pr %} -{% data reusables.repositories.choose-pr-review %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} +{% data reusables.repositories.choose-pr-review %} 3. On the "Conversation" tab, scroll to the review you'd like to dismiss, then click {% octicon "chevron-down" aria-label="The down button" %}. ![Chevron icon in the merge box](/assets/images/help/pull_requests/merge_box/pull-request-open-menu.png) 4. Click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Dismiss review**. ![Kebab icon in merge box](/assets/images/help/pull_requests/merge_box/pull-request-dismiss-review.png) 5. Type your reason for dismissing the review, then click **Dismiss review**. ![Dismiss review button](/assets/images/help/pull_requests/merge_box/pull-request-dismiss-review-button.png) -{% else %} -3. On the "Conversation" tab, scroll to the review you'd like to see, then click **Dismiss review**. ![Option to dismiss a review](/assets/images/help/pull_requests/merge_box/pull-request-dismiss-review.png) -4. Type your reason for dismissing the review, then click **Dismiss review**. ![Dismiss review button](/assets/images/help/pull_requests/merge_box/pull-request-dismiss-review-button.png) -{% endif %} ### Дополнительная литература diff --git a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md index 0ec01665fd96..0f7aadece8a8 100644 --- a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md +++ b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md @@ -9,11 +9,11 @@ versions: enterprise-server: '*' --- -You can filter files in a pull request by file extension type, such as `.html` or `.js`, no extension, {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} code ownership, {% endif %} or dotfiles. +You can filter files in a pull request by file extension type, such as `.html` or `.js`, lack of an extension, code ownership, or dotfiles. {% tip %} -**Tip:** To simplify your pull request diff view, you can also temporarily hide deleted files{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} or files you have already viewed {% endif %}in the pull request diff from the file filter drop-down menu. +**Tip:** To simplify your pull request diff view, you can also temporarily hide deleted files or files you have already viewed in the pull request diff from the file filter drop-down menu. {% endtip %} diff --git a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md index e90b5b0b9681..f19dc4b3f6d0 100644 --- a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md +++ b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md @@ -45,13 +45,13 @@ If you decide you don't want the changes in a topic branch to be merged to the u 6. Click **Confirm merge**, **Confirm squash and merge**, or **Confirm rebase and merge**. 6. Optionally, [delete the branch](/articles/deleting-unused-branches). This keeps the list of branches in your repository tidy. - {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}The repository may be configured so that the head branch for a pull request is automatically deleted when you merge a pull request. For more information, see "[Managing the automatic deletion of branches](/github/administering-a-repository/managing-the-automatic-deletion-of-branches)."{% endif %} +The repository may be configured so that the head branch for a pull request is automatically deleted when you merge a pull request. For more information, see "[Managing the automatic deletion of branches](/github/administering-a-repository/managing-the-automatic-deletion-of-branches)." {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} {% note %} **Note:** {% data reusables.pull_requests.retargeted-on-branch-deletion %} -For more information, see "[About branches](/github/collaborating-with-issues-and-pull-requests/about-branches#working-with-branches)." + For more information, see "[About branches](/github/collaborating-with-issues-and-pull-requests/about-branches#working-with-branches)." {% endnote %} {% endif %} diff --git a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md index 2a569593ecba..620d3e06bf1b 100644 --- a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md +++ b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md @@ -12,7 +12,7 @@ versions: 2. Change the current working directory to your local project. 3. Check out the branch you wish to merge to. Usually, you will merge into the default branch. ```shell - $ git checkout master + $ git checkout DEFAULT_BRANCH_NAME ``` 4. Pull the desired branch from the upstream repository. This method will retain the commit history without modification. ```shell @@ -23,5 +23,5 @@ versions: 7. Review the changes and ensure they are satisfactory. 8. Push the merge to your GitHub repository. ```shell - $ git push origin master + $ git push origin DEFAULT_BRANCH_NAME ``` diff --git a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md index 3c9bdff4f1e3..d1c78924c373 100644 --- a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md +++ b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md @@ -11,15 +11,18 @@ versions: You can only resolve merge conflicts on {% data variables.product.product_name %} that are caused by competing line changes, such as when people make different changes to the same line of the same file on different branches in your Git repository. For all other types of merge conflicts, you must resolve the conflict locally on the command line. For more information, see "[Resolving a merge conflict using the command line](/articles/resolving-a-merge-conflict-using-the-command-line/)." {% if currentVersion != "free-pro-team@latest" %} -If a site administrator disables the merge conflict editor for pull requests between repositories, you cannot use the conflict editor on {% data variables.product.product_name %} and must resolve merge conflicts on the command line. For example, if the merge conflict editor is disabled, you cannot use it on a pull request between a fork and upstream repository. +If a site administrator disables the merge conflict editor for pull requests between repositories, you cannot use the conflict editor on +{% data variables.product.product_name %} and must resolve merge conflicts on the command line. For example, if the merge conflict editor is disabled, you cannot use it on a pull request between a fork and upstream repository. {% endif %} {% warning %} {% if currentVersion ver_lt "enterprise-server@2.22" %} -**Warning:** When you resolve a merge conflict on {% data variables.product.product_name %}, the entire [base branch](/github/getting-started-with-github/github-glossary#base-branch) of your pull request is merged into the [head branch](/github/getting-started-with-github/github-glossary#head-branch), even if the head branch is the default branch of your repository or a protected branch. Make sure you really want to commit to this branch. +**Warning:** When you resolve a merge conflict on +{% data variables.product.product_name %}, the entire [base branch](/github/getting-started-with-github/github-glossary#base-branch) of your pull request is merged into the [head branch](/github/getting-started-with-github/github-glossary#head-branch), even if the head branch is the default branch of your repository or a protected branch. Make sure you really want to commit to this branch. {% else %} -**Warning:** When you resolve a merge conflict on {% data variables.product.product_name %}, the entire [base branch](/github/getting-started-with-github/github-glossary#base-branch) of your pull request is merged into the [head branch](/github/getting-started-with-github/github-glossary#head-branch). Make sure you really want to commit to this branch. If the head branch is the default branch of your repository, you'll be given the option of creating a new branch to serve as the head branch for your pull request. If the head branch is protected you won't be able to merge your conflict resolution into it, so you'll be prompted to create a new head branch. For more information, see "[About protected branches](/github/administering-a-repository/about-protected-branches)." +**Warning:** When you resolve a merge conflict on +{% data variables.product.product_name %}, the entire [base branch](/github/getting-started-with-github/github-glossary#base-branch) of your pull request is merged into the [head branch](/github/getting-started-with-github/github-glossary#head-branch). Make sure you really want to commit to this branch. If the head branch is the default branch of your repository, you'll be given the option of creating a new branch to serve as the head branch for your pull request. If the head branch is protected you won't be able to merge your conflict resolution into it, so you'll be prompted to create a new head branch. For more information, see "[About protected branches](/github/administering-a-repository/about-protected-branches)." {% endif %} {% endwarning %} diff --git a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-using-the-command-line.md b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-using-the-command-line.md index 4f167fe0720f..c39ab8662722 100644 --- a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-using-the-command-line.md +++ b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-using-the-command-line.md @@ -83,8 +83,8 @@ For example, if you edited a file, such as *README.md*, and another person remov 2. Generate a list of the files affected by the merge conflict. In this example, the file *README.md* has a merge conflict. ```shell $ git status - > # On branch master - > # Your branch and 'origin/master' have diverged, + > # On branch main + > # Your branch and 'origin/main' have diverged, > # and have 1 and 2 different commits each, respectively. > # (use "git pull" to merge the remote branch into yours) > # You have unmerged paths. diff --git a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md index a5348e91ba05..fe54cb03f836 100644 --- a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md +++ b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md @@ -10,7 +10,7 @@ versions: ### About reviewing pull requests -You can review changes in a pull request one file at a time. While reviewing the files in a pull request, you can leave individual comments on specific changes.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} After you finish reviewing each file, you can mark the file as viewed. This collapses the file, helping you identify the files you still need to review. A progress bar in the pull request header shows the number of files you've viewed.{% endif %} After reviewing as many files as you want, you can approve the pull request or request additional changes by submitting your review with a summary comment. +You can review changes in a pull request one file at a time. While reviewing the files in a pull request, you can leave individual comments on specific changes. After you finish reviewing each file, you can mark the file as viewed. This collapses the file, helping you identify the files you still need to review. A progress bar in the pull request header shows the number of files you've viewed. After reviewing as many files as you want, you can approve the pull request or request additional changes by submitting your review with a summary comment. {% data reusables.search.requested_reviews_search_tip %} @@ -28,14 +28,12 @@ Before you submit your review, your line comments are _pending_ and only visible ![Cancel review button](/assets/images/help/pull_requests/cancel-review-button.png) -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} ### Marking a file as viewed After you finish reviewing a file, you can mark the file as viewed, and the file will collapse. If the file changes after you view the file, it will be unmarked as viewed. {% data reusables.repositories.changed-files %} 2. On the right of the header of the file you've finished reviewing, select **Viewed**. ![Viewed checkbox](/assets/images/help/pull_requests/viewed-checkbox.png) -{% endif %} ### Submitting your review diff --git a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/working-with-pre-receive-hooks.md b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/working-with-pre-receive-hooks.md index 78ce41fd0a7b..85001ffa3167 100644 --- a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/working-with-pre-receive-hooks.md +++ b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/working-with-pre-receive-hooks.md @@ -21,7 +21,7 @@ Total 3 (delta 0), reused 0 (delta 0) remote: always_reject.sh: failed with exit status 1 remote: error: rejecting all pushes To https://54.204.174.51/hodor/nope.git - ! [remote rejected] master -> master (pre-receive hook declined) + ! [remote rejected] main -> main (pre-receive hook declined) error: failed to push some refs to 'https://54.204.174.51/hodor/nope.git' ``` diff --git a/translations/ru-RU/content/github/committing-changes-to-your-project/changing-a-commit-message.md b/translations/ru-RU/content/github/committing-changes-to-your-project/changing-a-commit-message.md index bd0efbc2f62a..879e53f90ca3 100644 --- a/translations/ru-RU/content/github/committing-changes-to-your-project/changing-a-commit-message.md +++ b/translations/ru-RU/content/github/committing-changes-to-your-project/changing-a-commit-message.md @@ -13,13 +13,9 @@ versions: You can change the most recent commit message using the `git commit --amend` command. -{% warning %} - In Git, the text of the commit message is part of the commit. Changing the commit message will change the commit ID--i.e., the SHA1 checksum that names the commit. Effectively, you are creating a new commit that replaces the old one. -{% endwarning %} - -#### Commit has not been pushed online +### Commit has not been pushed online If the commit only exists in your local repository and has not been pushed to {% data variables.product.product_location %}, you can amend the commit message with the `git commit --amend` command. @@ -39,7 +35,7 @@ You can change the default text editor for Git by changing the `core.editor` set {% endtip %} -#### Amending older or multiple commit messages +### Amending older or multiple commit messages If you have already pushed the commit to {% data variables.product.product_location %}, you will have to force push a commit with an amended message. @@ -49,7 +45,7 @@ We strongly discourage force pushing, since this changes the history of your rep {% endwarning %} -**Amending the message of the most recently pushed commit** +**Changing the message of the most recently pushed commit** 1. Follow the [steps above](/articles/changing-a-commit-message#commit-has-not-been-pushed-online) to amend the commit message. 2. Use the `push --force` command to force push over the old commit. @@ -57,7 +53,7 @@ We strongly discourage force pushing, since this changes the history of your rep $ git push --force example-branch ``` -**Amending the message of older or multiple commit messages** +**Changing the message of older or multiple commit messages** If you need to amend the message for multiple commits or an older commit, you can use interactive rebase, then force push to change the commit history. @@ -93,7 +89,6 @@ If you need to amend the message for multiple commits or an older commit, you ca # # Note that empty commits are commented out ``` - 3. Replace `pick` with `reword` before each commit message you want to change. ```shell pick e499d89 Delete CNAME @@ -102,10 +97,10 @@ If you need to amend the message for multiple commits or an older commit, you ca ``` 4. Save and close the commit list file. 5. In each resulting commit file, type the new commit message, save the file, and close it. -6. Force-push the amended commits. - ```shell - $ git push --force - ``` +6. When you're ready to push your changes to GitHub, use the push --force command to force push over the old commit. +```shell +$ git push --force example-branch +``` For more information on interactive rebase, see "[Interactive mode](https://git-scm.com/docs/git-rebase#_interactive_mode)" in the Git manual. diff --git a/translations/ru-RU/content/github/committing-changes-to-your-project/commit-branch-and-tag-labels.md b/translations/ru-RU/content/github/committing-changes-to-your-project/commit-branch-and-tag-labels.md index f1701d277f19..fa921f32b7dd 100644 --- a/translations/ru-RU/content/github/committing-changes-to-your-project/commit-branch-and-tag-labels.md +++ b/translations/ru-RU/content/github/committing-changes-to-your-project/commit-branch-and-tag-labels.md @@ -14,7 +14,7 @@ If your commit is not on the default branch, an indicator will show the branches Once the commit is on the default branch, any tags that contain the commit will be shown and the default branch will be the only branch listed. -![Commit-master-label](/assets/images/help/commits/Commit-master-label.png) +![Commit-main-label](/assets/images/help/commits/Commit-master-label.png) ### Дополнительная литература diff --git a/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md b/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md index 23e03e2362a3..4e13d7f25527 100644 --- a/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md +++ b/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md @@ -79,7 +79,8 @@ docs/* docs@example.com apps/ @octocat # In this example, @doctocat owns any file in the `/docs` -# directory in the root of your repository. +# directory in the root of your repository and any of its +# subdirectories. /docs/ @doctocat ``` diff --git a/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/about-repositories.md b/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/about-repositories.md index 0614d196e0bd..0bb853a09503 100644 --- a/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/about-repositories.md +++ b/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/about-repositories.md @@ -15,7 +15,8 @@ You can restrict who has access to a repository by choosing the repository's vis For user-owned repositories, you can give other people collaborator access so that they can collaborate on your project. If a repository is owned by an organization, you can give organization members access permissions to collaborate on your repository. For more information, see "[Permission levels for a user account repository](/articles/permission-levels-for-a-user-account-repository/)" and "[Repository permission levels for an organization](/articles/repository-permission-levels-for-an-organization/)." {% if currentVersion == "free-pro-team@latest" %} -With {% data variables.product.prodname_free_team %} for user accounts and 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. To get advanced tooling for private repositories, you can upgrade to {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, or {% data variables.product.prodname_ghe_cloud %}. {% data reusables.gated-features.more-info %} +With +{% data variables.product.prodname_free_team %} for user accounts and 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. To get advanced tooling for private repositories, you can upgrade to {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, or {% data variables.product.prodname_ghe_cloud %}. {% data reusables.gated-features.more-info %} {% else %} Each person and organization can own unlimited repositories and invite an unlimited number of collaborators to all repositories. {% endif %} diff --git a/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md b/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md index 6da0b3d8e9df..ee1806c7663e 100644 --- a/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md +++ b/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md @@ -13,7 +13,8 @@ versions: enterprise-server: '*' --- -{% data variables.product.product_name %} uses the open source [Linguist library](https://github.com/github/linguist) to determine file languages for syntax highlighting and repository statistics. Language statistics will update after you push changes to your default branch. +{% data variables.product.product_name %} uses the open source [Linguist library](https://github.com/github/linguist) to +determine file languages for syntax highlighting and repository statistics. Language statistics will update after you push changes to your default branch. Some files are hard to identify, and sometimes projects contain more library and vendor files than their primary code. If you're receiving incorrect results, please consult the Linguist [troubleshooting guide](https://github.com/github/linguist#troubleshooting) for help. diff --git a/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md b/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md index 9ab1f23c6ccc..f32ddf420753 100644 --- a/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md +++ b/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md @@ -22,12 +22,12 @@ When you clone a repository or wiki, only Git data, such as project files and co - [Вопросы](/v3/issues/#list-issues-for-a-repository) - [Pull requests](/v3/pulls/#list-pull-requests) -- [Forks](/v3/repos/forks/#list-forks) -- [Комментарии](/v3/issues/comments/#list-comments-in-a-repository) -- [Milestones](/v3/issues/milestones/#list-milestones-for-a-repository) -- [Labels](/v3/issues/labels/#list-all-labels-for-this-repository) -- [Watchers](/v3/activity/watching/#list-watchers) -- [Старгейзеры](/v3/activity/starring/#list-stargazers) +- [Forks](/rest/reference/repos#list-forks) +- [Комментарии](/rest/reference/issues#list-issue-comments-for-a-repository) +- [Milestones](/rest/reference/issues#list-milestones) +- [Labels](/rest/reference/issues#list-labels-for-a-repository) +- [Watchers](/rest/reference/activity#list-watchers) +- [Старгейзеры](/rest/reference/activity#list-stargazers) - [Projects](/v3/projects/#list-repository-projects) {% endif %} @@ -37,6 +37,7 @@ Once you have {% if currentVersion != "free-pro-team@latest" %}a local version o ### Third-party backup tools A number of self-service tools exist that automate backups of repositories. Unlike archival projects, which archive _all_ public repositories on {% data variables.product.product_name %} that have not opted out and make the data accessible to anyone, backup tools will download data from _specific_ repositories and organize it within a new branch or directory. For more information about archival projects, see "[About archiving content and data on {% data variables.product.prodname_dotcom %}](/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github#about-the-github-archive-program)." +You can back up all of a repository's Git data (such as project files and commit history), as well as much data from -You can back up all of a repository's Git data (such as project files and commit history), as well as much data from {% data variables.product.product_name %} (such as issues and pull requests), with [BackHub](https://github.com/marketplace/backhub), which creates daily recurring backups of your repositories with snapshots up to 30 days back in time. BackHub is available in {% data variables.product.prodname_marketplace %}. +{% data variables.product.product_name %} (such as issues and pull requests), with [BackHub](https://github.com/marketplace/backhub), which creates daily recurring backups of your repositories with snapshots up to 30 days back in time. BackHub is available in {% data variables.product.prodname_marketplace %}. {% endif %} diff --git a/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md b/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md index 7c63929923b0..ac54dd0cec46 100644 --- a/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md +++ b/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md @@ -46,7 +46,7 @@ For more information, see "[Cloning a repository from {% data variables.product. An empty repository contains no files. It's often made if you don't initialize the repository with a README when creating it. {% data reusables.repositories.navigate-to-repo %} -2. To clone your repository using the command line using HTTPS, under "Quick setup", click {% octicon "clippy" aria-label="The clipboard icon" %}. To clone the repository using an SSH key{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, including a certificate issued by your organization's SSH certificate authority,{% endif %} click **SSH**, then click {% octicon "clippy" aria-label="The clipboard icon" %}. ![Empty repository clone URL button](/assets/images/help/repository/empty-https-url-clone-button.png) +2. To clone your repository using the command line using HTTPS, under "Quick setup", click {% octicon "clippy" aria-label="The clipboard icon" %}. To clone the repository using an SSH key, including a certificate issued by your organization's SSH certificate authority, click **SSH**, then click {% octicon "clippy" aria-label="The clipboard icon" %}. ![Empty repository clone URL button](/assets/images/help/repository/empty-https-url-clone-button.png) Alternatively, to clone your repository in Desktop, click {% octicon "desktop-download" aria-label="The desktop download button" %} **Set up in Desktop** and follow the prompts to complete the clone. ![Empty repository clone desktop button](/assets/images/help/repository/empty-desktop-clone-button.png) @@ -55,7 +55,6 @@ An empty repository contains no files. It's often made if you don't initialize t {% data reusables.command_line.git-clone-url %} {% data reusables.command_line.local-clone-created %} - ### Troubleshooting cloning errors When cloning a repository it's possible that you might encounter some errors. @@ -66,7 +65,6 @@ If you're unable to clone a repository, check that: - You have permission to access the repository you want to clone. For more information, see "[Error: Repository not found](/github/creating-cloning-and-archiving-repositories/error-repository-not-found)." - The default branch you want to clone still exists. For more information, see have permission to access the repository you want to clone. For more information, see "[Error: Remote HEAD refers to nonexistent ref, unable to checkout](/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout)." - {% if currentVersion == "free-pro-team@latest" %} ### Дополнительная литература diff --git a/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md b/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md index 3addb3597b35..858a8fbda365 100644 --- a/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md +++ b/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md @@ -28,13 +28,13 @@ versions: {% endtip %} {% endif %} -{% data reusables.repositories.create_new %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} +{% data reusables.repositories.create_new %} 2. Optionally, to create a repository with the directory structure and files of an existing repository, use the **Choose a template** drop-down and select a template repository. You'll see template repositories that are owned by you and organizations you're a member of or that you've used before. For more information, see "[Creating a repository from a template](/articles/creating-a-repository-from-a-template)." ![Template drop-down menu](/assets/images/help/repository/template-drop-down.png){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -3. Optionally, if you chose to use a template, to include the directory structure and files from all branches in the template, and not just the default branch, select **Include all branches**. ![Include all branches checkbox](/assets/images/help/repository/include-all-branches.png){% endif %}{% endif %} +3. Optionally, if you chose to use a template, to include the directory structure and files from all branches in the template, and not just the default branch, select **Include all branches**. ![Include all branches checkbox](/assets/images/help/repository/include-all-branches.png){% endif %} 3. In the Owner drop-down, select the account you wish to create the repository on. ![Owner drop-down menu](/assets/images/help/repository/create-repository-owner.png) {% data reusables.repositories.repo-name %} {% data reusables.repositories.choose-repo-visibility %} -6. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}If you're not using a template, t{% else %}T{% endif %}here are a number of optional items you can pre-populate your repository with. If you're importing an existing repository to {% data variables.product.product_name %}, don't choose any of these options, as you may introduce a merge conflict. You can {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.15" %}add or create new files using the user interface or {% endif %}choose to add new files using the command line later. For more information, see "[Importing a Git repository using the command line](/articles/importing-a-git-repository-using-the-command-line/)," "[Adding a file to a repository using the command line](/articles/adding-a-file-to-a-repository-using-the-command-line)," and "[Addressing merge conflicts](/articles/addressing-merge-conflicts/)." +6. If you're not using a template, there are a number of optional items you can pre-populate your repository with. If you're importing an existing repository to {% data variables.product.product_name %}, don't choose any of these options, as you may introduce a merge conflict. You can add or create new files using the user interface or choose to add new files using the command line later. For more information, see "[Importing a Git repository using the command line](/articles/importing-a-git-repository-using-the-command-line/)," "[Adding a file to a repository using the command line](/articles/adding-a-file-to-a-repository-using-the-command-line)," and "[Addressing merge conflicts](/articles/addressing-merge-conflicts/)." - You can create a README, which is a document describing your project. For more information, see "[About READMEs](/articles/about-readmes/)." - You can create a *.gitignore* file, which is a set of ignore rules. For more information, see "[Ignoring files](/articles/ignoring-files)."{% if currentVersion == "free-pro-team@latest" %} - You can choose to add a software license for your project. For more information, see "[Licensing a repository](/articles/licensing-a-repository)."{% endif %} @@ -48,5 +48,4 @@ versions: - "[Managing access to your organization's repositories](/articles/managing-access-to-your-organization-s-repositories)" - [Open Source Guides](https://opensource.guide/){% if currentVersion == "free-pro-team@latest" %} -- [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}){% endif %}{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.16" %} -- "[Initializing an empty repository with a README](/articles/initializing-an-empty-repository-with-a-readme)"{% endif %} +- [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}){% endif %} diff --git a/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md b/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md index 15e38f1c7c11..181785132e91 100644 --- a/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md +++ b/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md @@ -5,7 +5,7 @@ redirect_from: - /articles/creating-a-repository-from-a-template versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- ### About repository templates diff --git a/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md b/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md index 7ed533a94205..fdf937803523 100644 --- a/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md +++ b/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md @@ -5,7 +5,7 @@ redirect_from: - /articles/creating-a-template-repository versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- Anyone with admin permissions to a repository can make the repository a template. diff --git a/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md b/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md index 880f6c7ef2bf..78fec046ab96 100644 --- a/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md +++ b/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md @@ -22,7 +22,7 @@ $ git clone https://{% data variables.command_line.codeblock %}/user/ warning: remote HEAD refers to nonexistent ref, unable to checkout. ``` -To fix the error, you'll need to be an administrator of the repository on {% data variables.product.product_location %}. You'll want to [change the default branch](/articles/setting-the-default-branch) of the repository. +To fix the error, you'll need to be an administrator of the repository on {% data variables.product.product_location %}. You'll want to [change the default branch](/github/administering-a-repository/changing-the-default-branch) of the repository. After that, you can get a list of all the available branches from the command line: @@ -31,14 +31,14 @@ $ git branch -a # Lists ALL the branches > remotes/origin/awesome > remotes/origin/more-work -> remotes/origin/new-master +> remotes/origin/new-main ``` Then, you can just switch to your new branch: ```shell -$ git checkout new-master +$ git checkout new-main # Create and checkout a tracking branch -> Branch new-master set up to track remote branch new-master from origin. -> Switched to a new branch 'new-master' +> Branch new-main set up to track remote branch new-main from origin. +> Switched to a new branch 'new-main' ``` diff --git a/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md b/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md index 651e43ad554e..7e4fcfb55800 100644 --- a/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md +++ b/translations/ru-RU/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md @@ -49,6 +49,7 @@ You can filter repositories based on their license or license family using the ` | | Do What The F*ck You Want To Public License | `wtfpl` | | | Educational Community License v2.0 | `ecl-2.0` | | | Eclipse Public License 1.0 | `epl-1.0` | +| | Eclipse Public License 2.0 | `epl-2.0` | | | European Union Public License 1.1 | `eupl-1.1` | | | GNU Affero General Public License v3.0 | `agpl-3.0` | | | GNU General Public License family | `gpl` | diff --git a/translations/ru-RU/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md b/translations/ru-RU/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md new file mode 100644 index 000000000000..0871503bf376 --- /dev/null +++ b/translations/ru-RU/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md @@ -0,0 +1,27 @@ +--- +title: About billing for Codespaces +intro: 'When {% data variables.product.prodname_codespaces %} becomes generally available, you will be billed for storage and compute usage.' +product: '{% data reusables.gated-features.codespaces %}' +versions: + free-pro-team: '*' +--- + +{% data reusables.codespaces.release-stage %} + +{% data reusables.codespaces.about-billing-for-codespaces %} + +Compute costs are incurred only when a codespace is active. When you're using a codespace, the codespace is active. After 30 minutes of inactivity, a codespace becomes suspended automatically. + +Compute usage is billed per hour, at a rate that depends on your codespace's instance type. During the beta, {% data variables.product.prodname_codespaces %} offers a single, Linux instance type. At general availability, we'll support three Linux instance types. + +| Instance Type (Linux) | Per-hour rate | +| --------------------------------------- | ------------- | +| Basic (2 cores, 4GB RAM, 32 GB SSD) | $0.085 | +| Standard (4 cores, 8 GB RAM, 32 GB SSD) | $0.169 | +| Premium (8 cores, 16 GB RAM, 32 GB SSD) | $0.339 | + +Compute pricing may vary for additional instance types and operating systems supported in the future. + +Each codespace also incurs monthly storage costs until you delete the codespace. Storage costs for all instance types are $0.10/GB-month. + +We'll share more information about any compute and storage usage included in each plan at general availability. diff --git a/translations/ru-RU/content/github/developing-online-with-codespaces/about-codespaces.md b/translations/ru-RU/content/github/developing-online-with-codespaces/about-codespaces.md index a07a449044ca..6c0e0d29f123 100644 --- a/translations/ru-RU/content/github/developing-online-with-codespaces/about-codespaces.md +++ b/translations/ru-RU/content/github/developing-online-with-codespaces/about-codespaces.md @@ -44,7 +44,7 @@ Each developer can create one or more codespace for any public repository, or fo ### About billing for {% data variables.product.prodname_codespaces %} -During the limited public beta, {% data variables.product.prodname_codespaces %} is free to use and users are limited to 2 codespaces. Plans and pricing will be announced prior to general availability. +{% data reusables.codespaces.about-billing-for-codespaces %} For more information, see "[About billing for {% data variables.product.prodname_codespaces %}](/github/developing-online-with-codespaces/about-billing-for-codespaces)." ### Joining the beta diff --git a/translations/ru-RU/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md b/translations/ru-RU/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md index 11cea58326ba..9b692c800fb6 100644 --- a/translations/ru-RU/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md +++ b/translations/ru-RU/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md @@ -21,7 +21,9 @@ If you don't define a configuration in your repository, {% data variables.produc You can create a default codespace configuration using a pre-built container configuration for your project type, or you can create a custom configuration specific to your project's needs. -{% data variables.product.prodname_codespaces %} uses settings contained in a file named `devcontainer.json` in the root of the repository or in a `.devcontainer` folder. You can use `devcontainer.json` to set default settings for the entire codespace environment, including the {% data variables.product.prodname_vscode %} editor, but you can also set editor-specific settings in a file named `.vscode/settings.json`. +{% data variables.product.prodname_codespaces %} uses settings contained in a configuration file named `devcontainer.json`. {% data reusables.codespaces.devcontainer-location %} + +You can use your `devcontainer.json` to set default settings for the entire codespace environment, including the {% data variables.product.prodname_vscode %} editor, but you can also set editor-specific settings in a file named `.vscode/settings.json`. Changes to a repository's codespace configuration apply only to every new codespace and do not affect any existing codespace. @@ -38,7 +40,9 @@ Each new codespace created from a branch which contains the `.devcontainer` fold ### Creating a custom codespace configuration -If none of the pre-built configurations meet your needs, you can create a custom configuration by adding a `devcontainer.json` file to the root of your repository or a `.devcontainer` folder. In the file, you can use supported configuration keys to specify aspects of the codespace's environment, like which {% data variables.product.prodname_vscode %} extensions will be installed. +If none of the pre-built configurations meet your needs, you can create a custom configuration by adding a `devcontainer.json` file. {% data reusables.codespaces.devcontainer-location %} + +In the file, you can use supported configuration keys to specify aspects of the codespace's environment, like which {% data variables.product.prodname_vscode %} extensions will be installed. {% data reusables.codespaces.vscode-settings-order %} diff --git a/translations/ru-RU/content/github/developing-online-with-codespaces/index.md b/translations/ru-RU/content/github/developing-online-with-codespaces/index.md index 7e73016b558a..d53f3e92fbc8 100644 --- a/translations/ru-RU/content/github/developing-online-with-codespaces/index.md +++ b/translations/ru-RU/content/github/developing-online-with-codespaces/index.md @@ -14,10 +14,12 @@ versions: ### Table of Contents {% link_in_list /about-codespaces %} +{% link_in_list /about-billing-for-codespaces %} {% link_in_list /configuring-codespaces-for-your-project %} {% link_in_list /creating-a-codespace %} {% link_in_list /developing-in-a-codespace %} {% link_in_list /personalizing-codespaces-for-your-account %} {% link_in_list /deleting-a-codespace %} {% link_in_list /troubleshooting-your-codespace %} -{% link_in_list /connecting-to-your-codespace-from-visual-studio-code %} +{% link_in_list /using-codespaces-in-visual-studio-code %} +{% link_in_list /using-codespaces-in-visual-studio %} diff --git a/translations/ru-RU/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md b/translations/ru-RU/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md new file mode 100644 index 000000000000..6aefe2c38758 --- /dev/null +++ b/translations/ru-RU/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md @@ -0,0 +1,45 @@ +--- +title: Using Codespaces in Visual Studio Code +intro: 'You can develop in your codespace directly in {% data variables.product.prodname_vscode %} by connecting the {% data variables.product.prodname_vs_codespaces %} extension with your account on {% data variables.product.product_name %}.' +product: '{% data reusables.gated-features.codespaces %}' +redirect_from: + - /github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code +versions: + free-pro-team: '*' +--- + +{% data reusables.codespaces.release-stage %} + +### Требования + +Before you can develop in a codespace directly in {% data variables.product.prodname_vscode %}, you must configure the {% data variables.product.prodname_vs_codespaces %} extension to connect to your {% data variables.product.product_name %} account. + +1. Use the {% data variables.product.prodname_vs %} Marketplace to install the [{% data variables.product.prodname_vs_codespaces %}](https://marketplace.visualstudio.com/items?itemName=ms-vsonline.vsonline) extension. For more information, see [Extension Marketplace](https://code.visualstudio.com/docs/editor/extension-gallery) in the {% data variables.product.prodname_vscode %} documentation. +2. In {% data variables.product.prodname_vscode %}, in the left sidebar, click the Extensions icon. ![The Extensions icon in {% data variables.product.prodname_vscode %}](/assets/images/help/codespaces/click-extensions-icon-vscode.png) +3. Below {% data variables.product.prodname_vs_codespaces %}, click the Manage icon, then click **Extension Settings**. ![The Extension Settings option](/assets/images/help/codespaces/select-extension-settings.png) +4. Use the Codespaces: Account Provider drop-down menu, and click **{% data variables.product.prodname_dotcom %}**. ![Setting the Account Provider to {% data variables.product.prodname_dotcom %}](/assets/images/help/codespaces/select-account-provider-vscode.png) +{% data reusables.codespaces.click-remote-explorer-icon-vscode %} +6. If {% data variables.product.prodname_codespaces %} is not already selected in the header, click **{% data variables.product.prodname_codespaces %}**. ![The {% data variables.product.prodname_codespaces %} header](/assets/images/help/codespaces/codespaces-header-vscode.png) +7. Click **Sign in to view {% data variables.product.prodname_codespaces %}...**. ![Signing in to view {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/sign-in-to-view-codespaces-vscode.png) +8. To authorize {% data variables.product.prodname_vscode %} to access your account on {% data variables.product.product_name %}, click **Allow**. +9. Sign in to {% data variables.product.product_name %} to approve the extension. + +### Creating a codespace in {% data variables.product.prodname_vscode %} + +After you connect your {% data variables.product.product_name %} account to the {% data variables.product.prodname_vs_codespaces %} extension, you can develop in a codespace that you created on {% data variables.product.product_name %} or in {% data variables.product.prodname_vscode %}. + +{% data reusables.codespaces.click-remote-explorer-icon-vscode %} +2. Click the Add icon, then click **Create New Codespace**. ![The Create new Codespace option in {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/create-codespace-vscode.png) +3. Type, then click the repository's name you want to develop in. ![Searching for repository to create a new {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/choose-repository-vscode.png) +4. Click the branch you want to develop in. ![Searching for a branch to create a new {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/choose-branch-vscode.png) + +### Opening a codespace in {% data variables.product.prodname_vscode %} + +{% data reusables.codespaces.click-remote-explorer-icon-vscode %} +2. Under Codespaces, click the codespace you want to develop in. +3. Click the Connect to Codespace icon. ![The Connect to Codespace icon in {% data variables.product.prodname_vscode %}](/assets/images/help/codespaces/click-connect-to-codespace-icon-vscode.png) + +### Deleting a codespace in {% data variables.product.prodname_vscode %} + +1. Under Codespaces, right-click the codespace you want to delete. +2. In the drop-down menu, click **Delete Codespace**. ![Deleting a codespace in {% data variables.product.prodname_dotcom %}](/assets/images/help/codespaces/delete-codespace-vscode.png) diff --git a/translations/ru-RU/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md b/translations/ru-RU/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md new file mode 100644 index 000000000000..fded97bd0166 --- /dev/null +++ b/translations/ru-RU/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md @@ -0,0 +1,53 @@ +--- +title: Using Codespaces in Visual Studio +intro: 'You can develop in your codespace directly in {% data variables.product.prodname_vs %} by connecting with your account on {% data variables.product.product_name %}.' +product: '{% data reusables.gated-features.codespaces %}' +versions: + free-pro-team: '*' +--- + +{% note %} + +**Note:** {% data variables.product.prodname_codespaces %} is currently in limited public beta and subject to change. During the beta period, {% data variables.product.prodname_dotcom %} does not make any guarantees about the availability of {% data variables.product.prodname_codespaces %}. [Sign up for the limited public beta](https://github.com/features/codespaces/signup-vs). For more information about joining the beta, see "[About {% data variables.product.prodname_codespaces %}](/github/developing-online-with-codespaces/about-codespaces#joining-the-beta)." + +{% endnote %} + +### About Codespaces in {% data variables.product.prodname_vs %} + +You can create a codespace in {% data variables.product.prodname_vs %} to develop applications in a Windows environment. When you use a codespace in {% data variables.product.prodname_vs %}, you can browse source code, build solutions, and commit changes to your repository. + +You must create a codespace in {% data variables.product.prodname_vs %} to use it with the application. Codespaces created outside of {% data variables.product.prodname_vs %} can not currently be used with {% data variables.product.prodname_vs %}. + +### Требования + +Before you configure a codespace in {% data variables.product.prodname_vs %}, you must download the latest version of [{% data variables.product.prodname_vs %} Preview](https://aka.ms/vspreview). + +#### Enabling the connection between {% data variables.product.prodname_vs %} and {% data variables.product.prodname_github_codespaces %} + +Connecting to {% data variables.product.prodname_github_codespaces %} with the {% data variables.product.prodname_vs %} Preview is not enabled by default, so you will first need to enable the Preview Features option. + +1. In {% data variables.product.prodname_vs %} Preview, use the Tools drop-down menu, then click **Options**. +2. Under **Environment**, select **Preview Features** and check the **Connect to {% data variables.product.prodname_github_codespaces %}** preview feature. ![Check the Connect to {% data variables.product.prodname_github_codespaces %} preview feature](/assets/images/help/codespaces/connect-to-github-codespaces-preview-feature.png) +3. You will need to restart {% data variables.product.prodname_vs %} for the feature to be available. + +### Creating a codespace in {% data variables.product.prodname_vs %} + +1. When you launch {% data variables.product.prodname_vs %}, the Start Window will show a **Connect to a codespace** button under "Get started". ![Visual Studio Start window with Connect to a codespace](/assets/images/help/codespaces/visual-studio-start-window.png) +2. Click **Connect to a codespace**. +3. Click **Sign in to {% data variables.product.prodname_dotcom %}** and follow the prompts, or click **Create one!** to create a new {% data variables.product.prodname_dotcom %} account and sign into the account. ![Visual Studio sign in to {% data variables.product.prodname_dotcom %}](/assets/images/help/codespaces/visual-studio-sign-in-to-github.png) +4. Under "Codespace details", type the repository's URL you want {% data variables.product.prodname_github_codespaces %} to clone into your codespace. +5. Optionally, use the Instance type and Suspend after drop-down menus to configure more codespace details. ![Visual Studio codespace details](/assets/images/help/codespaces/visual-studio-codespace-details.png) +6. Click **Create and Connect**. {% data variables.product.prodname_github_codespaces %} will begin preparing the codespace and open {% data variables.product.prodname_vs %} after the codespace is ready. The codespace name will appear in the remote indicator in the menu. ![Visual Studio connected to eShopOnWeb repository codespace](/assets/images/help/codespaces/visual-studio-eshoponweb-codespace.png) + +### Opening a codespace in {% data variables.product.prodname_vs %} + +1. Use the File drop-down menu, and click **Connect to a Codespace**. ![Visual Studio File Connect to a codespace menu item](/assets/images/help/codespaces/visual-studio-file-connect-to-codespace.png) +2. Under "{% data variables.product.prodname_github_codespaces %}", click the codespace you want to connect to, then click **Connect**. ![Visual Studio displaying available codespaces and details](/assets/images/help/codespaces/visual-studio-connect-codespace.png) + +### Configuring a codespace for {% data variables.product.prodname_vs %} + +The default codespace environment created by {% data variables.product.prodname_vs %} includes popular frameworks and tools such as .NET Core, Microsoft SQL Server, Python, and the Windows SDK. {% data variables.product.prodname_github_codespaces %} created with {% data variables.product.prodname_vs %} can be customized through a subset of `devcontainers.json` properties and a new tool called devinit, included with {% data variables.product.prodname_vs %}. + +#### devinit + +The [devinit](https://docs.microsoft.com/visualstudio/devinit/getting-started-with-devinit) command-line tool lets you install additional frameworks and tools into your Windows development codespaces, as well as run PowerShell scripts or modify environment variables. devinit supports a configuration file called [devinit.json](https://docs.microsoft.com/visualstudio/devinit/devinit-json), which can be added to your project for creating customized and repeatable development environments. For more information about Windows codespace configuration and devinit, see [Customize a codespace](https://docs.microsoft.com/visualstudio/ide/codespaces/customize-codespaces) in the {% data variables.product.prodname_vs %} documentation. diff --git a/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md index 2ef2611b8ce3..562b914e122e 100644 --- a/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md +++ b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md @@ -18,7 +18,7 @@ versions: You can use {% data variables.product.prodname_code_scanning %} to find, triage, and prioritize fixes for existing problems in your code. {% data variables.product.prodname_code_scanning_capc %} also prevents developers from introducing new problems. You can schedule scans for specific days and times, or trigger scans when a specific event occurs in the repository, such as a push. -If {% data variables.product.prodname_code_scanning %} finds a potential vulnerability or error in your code, {% data variables.product.prodname_dotcom %} displays an alert in the repository. After you fix the code that triggered the alert, {% data variables.product.prodname_dotcom %} closes the alert. For more information, see "[Managing alerts from {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." +If {% data variables.product.prodname_code_scanning %} finds a potential vulnerability or error in your code, {% data variables.product.prodname_dotcom %} displays an alert in the repository. After you fix the code that triggered the alert, {% data variables.product.prodname_dotcom %} closes the alert. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." To monitor results from {% data variables.product.prodname_code_scanning %} across your repositories or your organization, you can use the {% data variables.product.prodname_code_scanning %} API. For more information about API endpoints, see "[{% data variables.product.prodname_code_scanning_capc %}](/v3/code-scanning)." diff --git a/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md index 66d4b502b8ca..d182e1408d87 100644 --- a/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md +++ b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md @@ -1,7 +1,7 @@ --- title: About integration with code scanning shortTitle: About integration -intro: 'You can perform {% data variables.product.prodname_code_scanning %} externally and then display the results in {% data variables.product.prodname_dotcom %}.' +intro: 'You can perform {% data variables.product.prodname_code_scanning %} externally and then display the results in {% data variables.product.prodname_dotcom %}, or set up webhooks that listen to {% data variables.product.prodname_code_scanning %} activity in your repository.' product: '{% data reusables.gated-features.code-scanning %}' versions: free-pro-team: '*' @@ -11,12 +11,14 @@ versions: {% data reusables.code-scanning.beta %} {% data reusables.code-scanning.enterprise-enable-code-scanning %} -As an alternative to running {% data variables.product.prodname_code_scanning %} within {% data variables.product.prodname_dotcom %}, you can perform analysis elsewhere and then upload the results. Alerts for {% data variables.product.prodname_code_scanning %} that you run externally are displayed in the same way as those for {% data variables.product.prodname_code_scanning %} that you run within {% data variables.product.prodname_dotcom %}. For more information, see "[Managing alerts from code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." - -You can use your continuous integration or continuous delivery/deployment (CI/CD) system to run {% data variables.product.prodname_dotcom %}'s {% data variables.product.prodname_codeql %} analysis and upload the results to {% data variables.product.prodname_dotcom %}. This is an alternative to using {% data variables.product.prodname_actions %} to run {% data variables.product.prodname_codeql %} analysis. For more information, see "[Running code scanning in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)." +As an alternative to running {% data variables.product.prodname_code_scanning %} within {% data variables.product.prodname_dotcom %}, you can perform analysis elsewhere and then upload the results. Alerts for {% data variables.product.prodname_code_scanning %} that you run externally are displayed in the same way as those for {% data variables.product.prodname_code_scanning %} that you run within {% data variables.product.prodname_dotcom %}. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." If you use a third-party static analysis tool that can produce results as Static Analysis Results Interchange Format (SARIF) 2.1.0 data, you can upload this to {% data variables.product.prodname_dotcom %}. For more information, see "[Uploading a SARIF file to GitHub](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)." +### Integrations with webhooks + +You can use {% data variables.product.prodname_code_scanning %} webhooks to build or set up integrations, such as [{% data variables.product.prodname_github_app %}s](/apps/building-github-apps/) or [{% data variables.product.prodname_oauth_app %}s](/apps/building-oauth-apps/), that subscribe to {% data variables.product.prodname_code_scanning %} events in your repository. For example, you could build an integration that creates an issue on {% data variables.product.product_location %} or sends you a Slack notification when a new {% data variables.product.prodname_code_scanning %} alert is added in your repository. For more information, see "[Creating webhooks](/developers/webhooks-and-events/creating-webhooks)" and "[Webhook events and payloads](/developers/webhooks-and-events/webhook-events-and-payloads#code_scanning_alert)." + ### Дополнительная литература * "[About code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)" diff --git a/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md index 7793de95ddd7..2f126e4f1c23 100644 --- a/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md +++ b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md @@ -3,6 +3,7 @@ title: Automatically scanning your code for vulnerabilities and errors shortTitle: Scanning automatically intro: 'You can find vulnerabilities and errors in your project''s code on {% data variables.product.prodname_dotcom %}, as well as view, triage, understand, and resolve the related {% data variables.product.prodname_code_scanning %} alerts.' mapTopic: true +product: '{% data reusables.gated-features.code-scanning %}' versions: free-pro-team: '*' enterprise-server: '>=2.22' diff --git a/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md index 611433f0a302..bdc1ef11ebb1 100644 --- a/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md +++ b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md @@ -12,7 +12,6 @@ versions: {% data reusables.code-scanning.beta %} {% data reusables.code-scanning.enterprise-enable-code-scanning-actions %} - ### About {% data variables.product.prodname_code_scanning %} configuration You can run {% data variables.product.prodname_code_scanning %} within {% data variables.product.product_location %}, using {% data variables.product.prodname_actions %}, or from your continuous integration (CI) system, using the {% data variables.product.prodname_codeql_runner %}. For more information about {% data variables.product.prodname_actions %}, see "[About {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)." For more information about the {% data variables.product.prodname_codeql_runner %}, see "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)." @@ -33,7 +32,7 @@ Before you can configure {% data variables.product.prodname_code_scanning %} for 1. In the upper right corner of the file view, to open the workflow editor, click {% octicon "pencil" aria-label="The edit icon" %}. ![Edit workflow file button](/assets/images/help/repository/code-scanning-edit-workflow-button.png) 1. After you have edited the file, click **Start commit** and complete the "Commit changes" form. You can choose to commit directly to the current branch, or create a new branch and start a pull request. ![Commit update to codeql.yml workflow](/assets/images/help/repository/code-scanning-workflow-update.png) -For more information about editing workflow files, see "[Configuring a workflow](/actions/configuring-and-managing-workflows/configuring-a-workflow)." +For more information about editing workflow files, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." ### Configuring frequency @@ -82,7 +81,9 @@ This workflow scans: ### Specifying an operating system -If your code requires a specific operating system to compile, you can configure the operating system in your {% data variables.product.prodname_codeql_workflow %}. Edit the value of `jobs..runs-on` to specify the operating system for the machine that runs your {% data variables.product.prodname_code_scanning %} actions. {% if currentVersion ver_gt "enterprise-server@2.21" %}You specify the operating system by using an appropriate label as the second element in a two-element array, after `self-hosted`. +If your code requires a specific operating system to compile, you can configure the operating system in your {% data variables.product.prodname_codeql_workflow %}. Edit the value of `jobs.analyze.runs-on` to specify the operating system for the machine that runs your {% data variables.product.prodname_code_scanning %} actions. {% if currentVersion ver_gt "enterprise-server@2.21" %}You specify the operating system by using an appropriate label as the second element in a two-element array, after `self-hosted`.{% else %} + +If you choose to use a self-hosted runner for code scanning, you can specify an operating system by using an appropriate label as the second element in a two-element array, after `self-hosted`.{% endif %} ``` yaml jobs: @@ -90,27 +91,61 @@ jobs: name: Analyze runs-on: [self-hosted, ubuntu-latest] ``` -{% endif %} + +{% if currentVersion == "free-pro-team@latest" %}For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners)" and "[Adding self-hosted runners](/actions/hosting-your-own-runners/adding-self-hosted-runners)."{% endif %} {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} supports the latest versions of Ubuntu, Windows, and macOS. Typical values for this setting are therefore: `ubuntu-latest`, `windows-latest`, and `macos-latest`. For more information, see {% if currentVersion ver_gt "enterprise-server@2.21" %}"[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#self-hosted-runners)" and "[Using labels with self-hosted runners](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners){% else %}"[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on){% endif %}." -### Overriding automatic language detection +{% if currentVersion ver_gt "enterprise-server@2.21" %}You must ensure that Git is in the PATH variable on your self-hosted runners.{% else %}If you use a self-hosted runner, you must ensure that Git is in the PATH variable.{% endif %} -{% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} automatically detects and scans code written in the supported languages. +### Changing the languages that are analyzed + +{% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} automatically detects code written in the supported languages. {% data reusables.code-scanning.supported-languages %} +The default {% data variables.product.prodname_codeql_workflow %} file contains a build matrix called `language` which lists the languages in your repository that are analyzed. {% data variables.product.prodname_codeql %} automatically populates this matrix when you add {% data variables.product.prodname_code_scanning %} to a repository. Using the `language` matrix optimizes {% data variables.product.prodname_codeql %} to run each analysis in parallel. We recommend that all workflows adopt this configuration due to the performance benefits of parallelizing builds. For more information about build matrices, see "[Managing complex workflows](/actions/learn-github-actions/managing-complex-workflows#using-a-build-matrix)." + {% data reusables.code-scanning.specify-language-to-analyze %} -To override automatic language detection, add `with: languages:` to the `init` action in your {% data variables.product.prodname_codeql_workflow %}. The keywords for the supported languages are `cpp`, `csharp`, `go`, `java`, `javascript`, and `python`. +If your workflow uses the `language` matrix then {% data variables.product.prodname_codeql %} is hardcoded to analyze only the languages in the matrix. To change the languages you want to analyze, edit the value of the matrix variable. You can remove a language to prevent it being analyzed or you can add a language that was not present in the repository when {% data variables.product.prodname_code_scanning %} was enabled. For example, if the repository initially only contained JavaScript when {% data variables.product.prodname_code_scanning %} was enabled, and you later added Python code, you will need to add `python` to the matrix. + +```yaml +jobs: + analyze: + name: Analyze + ... + strategy: + fail-fast: false + matrix: + language: ['javascript', 'python'] +``` -For example, the following configuration limits {% data variables.product.prodname_code_scanning %} to C/C++, C#, and Python. +If your workflow does not contain a matrix called `language`, then {% data variables.product.prodname_codeql %} is configured to run analysis sequentially. If you don't specify languages in the workflow, {% data variables.product.prodname_codeql %} automatically detects, and attempts to analyze, any supported languages in the repository. If you want to choose which languages to analyze, without using a matrix, you can use the `languages` parameter under the `init` action. -``` yaml +```yaml - uses: github/codeql-action/init@v1 with: languages: cpp, csharp, python ``` +{% if currentVersion == "free-pro-team@latest" %} +### Analyzing Python dependencies + +For GitHub-hosted runners that use Linux only, the {% data variables.product.prodname_codeql_workflow %} will try to auto-install Python dependencies to give more results for the CodeQL analysis. You can control this behavior by specifying the `setup-python-dependencies` parameter for the action called by the "Initialize CodeQL" step. By default, this parameter is set to `true`: + +- If the repository contains code written in Python, the "Initialize CodeQL" step installs the necessary dependencies on the GitHub-hosted runner. If the auto-install succeeds, the action also sets the environment variable `CODEQL_PYTHON` to the Python executable file that includes the dependencies. + +- If the repository doesn't have any Python dependencies, or the dependencies are specified in an unexpected way, you'll get a warning and the action will continue with the remaining jobs. The action can run successfully even when there are problems interpreting dependencies, but the results may be incomplete. + +Alternatively, you can install Python dependencies manually on any operating system. You will need to add `setup-python-dependencies` and set it to `false`, as well as set `CODEQL_PYTHON` to the Python executable that includes the dependencies, as shown in this workflow extract: + +```yaml +- uses: github/codeql-action/init@v1 + with: + - config-file: ./.github/codeql/codeql-config.yml + - queries: +security-and-quality,octo-org/python-qlpack/show_ifs.ql@main +``` +{% endif %} ### Running additional queries @@ -121,7 +156,8 @@ To add one or more queries, add a `with: queries:` entry within the `uses: githu ``` yaml - uses: github/codeql-action/init@v1 with: - - queries: COMMA-SEPARATED LIST OF PATHS + - config-file: ./.github/codeql/codeql-config.yml + - queries: +security-and-quality,octo-org/python-qlpack/show_ifs.ql@main ``` You can also specify query suites in the value of `queries`. Query suites are collections of queries, usually grouped by purpose or language. @@ -135,8 +171,7 @@ In the following example, the `+` symbol ensures that the specified additional q ``` yaml - uses: github/codeql-action/init@v1 with: - - config-file: ./.github/codeql/codeql-config.yml - - queries: +security-and-quality,octo-org/python-qlpack/show_ifs.ql@main + - queries: COMMA-SEPARATED LIST OF PATHS ``` ### Using a custom configuration file @@ -193,7 +228,7 @@ paths-ignore: {% endnote %} -For C/C++, C#, and Java, if you want to limit {% data variables.product.prodname_code_scanning %} to specific directories in your project, you must specify appropriate build steps in the workflow. The commands you need to use to exclude a directory from the build will depend on your build system. For more information, see "[Configuring the {% data variables.product.prodname_codeql %} action for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages#adding-build-steps-for-a-compiled-language)." +For C/C++, C#, and Java, if you want to limit {% data variables.product.prodname_code_scanning %} to specific directories in your project, you must specify appropriate build steps in the workflow. The commands you need to use to exclude a directory from the build will depend on your build system. For more information, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." You can quickly analyze small portions of a monorepo when you modify code in specific directories. You'll need to both exclude directories in your build steps and use the `paths-ignore` and `paths` keywords for [`on.`](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths) in your workflow. @@ -205,7 +240,7 @@ You can quickly analyze small portions of a monorepo when you modify code in spe {% data reusables.code-scanning.autobuild-compiled-languages %} -{% data reusables.code-scanning.autobuild-add-build-steps %} For more information about how to configure {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} for compiled languages, see "[Configuring the {% data variables.product.prodname_codeql %} action for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages)." +{% data reusables.code-scanning.autobuild-add-build-steps %} For more information about how to configure {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} for compiled languages, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages)." ### Accessing private repositories diff --git a/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md new file mode 100644 index 000000000000..9c5102f3fc38 --- /dev/null +++ b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md @@ -0,0 +1,165 @@ +--- +title: Configuring CodeQL code scanning in your CI system +shortTitle: Configuring in your CI +intro: 'You can configure how the {% data variables.product.prodname_codeql_runner %} scans the code in your project and uploads the results to {% data variables.product.prodname_dotcom %}.' +product: '{% data reusables.gated-features.code-scanning %}' +miniTocMaxHeadingLevel: 4 +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-in-your-ci-system +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta-codeql-runner %} +{% data reusables.code-scanning.beta %} +{% data reusables.code-scanning.enterprise-enable-code-scanning %} + +### About configuring {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in your CI system + +To integrate {% data variables.product.prodname_code_scanning %} into your CI system, you can use the {% data variables.product.prodname_codeql_runner %}. For more information, see "[Running {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)." + +In general, you invoke the {% data variables.product.prodname_codeql_runner %} as follows. + +``` +$ /path/to-runner/codeql-runner-OS +``` + +`/path/to-runner/` depends on where you've downloaded the {% data variables.product.prodname_codeql_runner %} on your CI system. `codeql-runner-OS` depends on the operating system you use. There are three versions of the {% data variables.product.prodname_codeql_runner %}, `codeql-runner-linux`, `codeql-runner-macos`, and `codeql-runner-win`, for Linux, macOS, and Windows systems respectively. + +To customize the way the {% data variables.product.prodname_codeql_runner %} scans your code, you can use flags, such as `--languages` and `--queries`, or you can specify custom settings in a separate configuration file. + +### Overriding automatic language detection + +The {% data variables.product.prodname_codeql_runner %} automatically detects and scans code written in the supported languages. + +{% data reusables.code-scanning.supported-languages %} + +{% data reusables.code-scanning.specify-language-to-analyze %} + +To override automatic language detection, run the `init` command with the `--languages` flag, followed by a comma-separated list of language keywords. The keywords for the supported languages are `cpp`, `csharp`, `go`, `java`, `javascript`, and `python`. + +``` +$ /path/to-runner/codeql-runner-linux init --languages cpp,java +``` + +### Running additional queries + +{% data reusables.code-scanning.run-additional-queries %} + +{% data reusables.code-scanning.codeql-query-suites %} + +To add one or more queries, pass a comma-separated list of paths to the `--queries` flag of the `init` command. You can also specify additional queries in a configuration file. + +If you also are using a configuration file for custom settings, and you are also specifying additional queries with the `--queries` flag, the {% data variables.product.prodname_codeql_runner %} uses the additional queries specified with the `--queries` flag instead of any in the configuration file. If you want to run the combined set of additional queries specified with the flag and in the configuration file, prefix the value passed to `--queries` with the `+` symbol. For more information, see "[Using a custom configuration file](#using-a-custom-configuration-file)." + +In the following example, the `+` symbol ensures that the {% data variables.product.prodname_codeql_runner %} uses the additional queries together with any queries specified in the referenced configuration file. + +``` +$ /path/to-runner/codeql-runner-linux init --config-file .github/codeql/codeql-config.yml + --queries +security-and-quality,octo-org/python-qlpack/show_ifs.ql@main +``` + +### Using a custom configuration file + +Instead of passing additional information to the {% data variables.product.prodname_codeql_runner %} commands, you can specify custom settings in a separate configuration file. + +The configuration file is a YAML file. It uses syntax similar to the workflow syntax for {% data variables.product.prodname_actions %}, as illustrated in the examples below. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions)." + +Use the `--config-file` flag of the `init` command to specify the configuration file. The value of `--config-file` is the path to the configuration file that you want to use. This example loads the configuration file _.github/codeql/codeql-config.yml_. + +``` +$ /path/to-runner/codeql-runner-linux init --config-file .github/codeql/codeql-config.yml +``` + +#### Example configuration files + +{% data reusables.code-scanning.example-configuration-files %} + +### Configuring {% data variables.product.prodname_code_scanning %} for compiled languages + +For the compiled languages C/C++, C#, and Java, {% data variables.product.prodname_codeql %} builds the code before analyzing it. {% data reusables.code-scanning.analyze-go %} + +For many common build systems, the {% data variables.product.prodname_codeql_runner %} can build the code automatically. To attempt to build the code automatically, run `autobuild` between the `init` and `analyze` steps. Note that if your repository requires a specific version of a build tool, you may need to install the build tool manually first. + +The `autobuild` process only ever attempts to build _one_ compiled language for a repository. The language automatically selected for analysis is the language with the most files. If you want to choose a language explicitly, use the `--language` flag of the `autobuild` command. + +``` +$ /path/to-runner/codeql-runner-linux autobuild --language csharp +``` + +If the `autobuild` command can't build your code, you can run the build steps yourself, between the `init` and `analyze` steps. For more information, see "[Running {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system#compiled-language-example)." + +### Uploading {% data variables.product.prodname_code_scanning %} data to {% data variables.product.prodname_dotcom %} + +By default, the {% data variables.product.prodname_codeql_runner %} uploads results from {% data variables.product.prodname_code_scanning %} when you run the `analyze` command. You can also upload SARIF files separately, by using the `upload` command. + +Once you've uploaded the data, {% data variables.product.prodname_dotcom %} displays the alerts in your repository. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository#viewing-an-alert)." + +### {% data variables.product.prodname_codeql_runner %} command reference + +The {% data variables.product.prodname_codeql_runner %} supports the following commands and flags. + +#### `init` + +Initializes the {% data variables.product.prodname_codeql_runner %} and creates a {% data variables.product.prodname_codeql %} database for each language to be analyzed. + +| Flag | Required | Input value | +| -------------------------------- |:--------:| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `--repository` | ✓ | Name of the repository to initialize. | +| `--github-url` | ✓ | URL of the {% data variables.product.prodname_dotcom %} instance where your repository is hosted. | +| `--github-auth` | ✓ | A {% data variables.product.prodname_github_apps %} token or personal access token. | +| `--languages` | | Comma-separated list of languages to analyze. By default, the {% data variables.product.prodname_codeql_runner %} detects and analyzes all supported languages in the repository. | +| `--queries` | | Comma-separated list of additional queries to run, in addition to the default suite of security queries. | +| `--config-file` | | Path to custom configuration file. | +| `--codeql-path` | | Path to a copy of the {% data variables.product.prodname_codeql %} CLI executable to use. By default, the {% data variables.product.prodname_codeql_runner %} downloads a copy. | +| `--temp-dir` | | Directory where temporary files are stored. The default is _./codeql-runner_. | +| `--tools-dir` | | Directory where {% data variables.product.prodname_codeql %} tools and other files are stored between runs. The default is a subdirectory of the home directory. | +| `--checkout-path` | | The path to the checkout of your repository. The default is the current working directory. | +| `--debug` | | None. Prints more verbose output. | +| `-h`, `--help` | | None. Displays help for the command. | + +#### `autobuild` + +Attempts to build the code for the compiled languages C/C++, C#, and Java. For those languages, {% data variables.product.prodname_codeql %} builds the code before analyzing it. Run `autobuild` between the `init` and `analyze` steps. + +| Flag | Required | Input value | +| --------------------------- |:--------:| ---------------------------------------------------------------------------------------------------------------------------------------------- | +| `--language` | | The language to build. By default, the {% data variables.product.prodname_codeql_runner %} builds the compiled language with the most files. | +| `--temp-dir` | | Directory where temporary files are stored. The default is _./codeql-runner_. | +| `--debug` | | None. Prints more verbose output. | +| `-h`, `--help` | | None. Displays help for the command. | + +#### `analyze` + +Analyzes the code in the {% data variables.product.prodname_codeql %} databases and uploads results to {% data variables.product.product_location %}. + +| Flag | Required | Input value | +| -------------------------------- |:--------:| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `--repository` | ✓ | Name of the repository to analyze. | +| `--commit` | ✓ | SHA of the commit to analyze. In Git and in Azure DevOps, this corresponds to the value of `git rev-parse HEAD`. In Jenkins, this corresponds to `$GIT_COMMIT`. | +| `--ref` | ✓ | Name of the reference to analyze, for example `refs/heads/main`. In Git and in Jenkins, this corresponds to the value of `git symbolic-ref HEAD`. In Azure DevOps, this corresponds to `$(Build.SourceBranch)`. | +| `--github-url` | ✓ | URL of the {% data variables.product.prodname_dotcom %} instance where your repository is hosted. | +| `--github-auth` | ✓ | A {% data variables.product.prodname_github_apps %} token or personal access token. | +| `--checkout-path` | | The path to the checkout of your repository. The default is the current working directory. | +| `--no-upload` | | None. Stops the {% data variables.product.prodname_codeql_runner %} from uploading the results to {% data variables.product.product_location %}. | +| `--output-dir` | | Directory where the output SARIF files are stored. The default is in the directory of temporary files. | +| `--temp-dir` | | Directory where temporary files are stored. The default is _./codeql-runner_. | +| `--debug` | | None. Prints more verbose output. | +| `-h`, `--help` | | None. Displays help for the command. | + +#### `загрузить` + +Uploads SARIF files to {% data variables.product.product_location %}. + +| Flag | Required | Input value | +| -------------------------------- |:--------:| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `--sarif-file` | ✓ | SARIF file to upload, or a directory containing multiple SARIF files. | +| `--repository` | ✓ | Name of the repository that was analyzed. | +| `--commit` | ✓ | SHA of the commit that was analyzed. In Git and in Azure DevOps, this corresponds to the value of `git rev-parse HEAD`. In Jenkins, this corresponds to `$GIT_COMMIT`. | +| `--ref` | ✓ | Name of the reference that was analyzed, for example `refs/heads/main`. In Git and in Jenkins, this corresponds to the value of `git symbolic-ref HEAD`. In Azure DevOps, this corresponds to `$(Build.SourceBranch)`. | +| `--github-url` | ✓ | URL of the {% data variables.product.prodname_dotcom %} instance where your repository is hosted. | +| `--github-auth` | ✓ | A {% data variables.product.prodname_github_apps %} token or personal access token. | +| `--checkout-path` | | The path to the checkout of your repository. The default is the current working directory. | +| `--debug` | | None. Prints more verbose output. | +| `-h`, `--help` | | None. Displays help for the command. | diff --git a/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md new file mode 100644 index 000000000000..14555c4fd26f --- /dev/null +++ b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md @@ -0,0 +1,116 @@ +--- +title: Configuring the CodeQL workflow for compiled languages +shortTitle: Configuring for compiled languages +intro: 'You can configure how {% data variables.product.prodname_dotcom %} uses the {% data variables.product.prodname_codeql_workflow %} to scan code written in compiled languages for vulnerabilities and errors.' +product: '{% data reusables.gated-features.code-scanning %}' +permissions: 'People with write permissions to a repository can configure {% data variables.product.prodname_code_scanning %} for the repository.' +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages + - /github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta %} +{% data reusables.code-scanning.enterprise-enable-code-scanning-actions %} + +### About the {% data variables.product.prodname_codeql_workflow %} and compiled languages + +You enable {% data variables.product.prodname_dotcom %} to run {% data variables.product.prodname_code_scanning %} for your repository by adding a {% data variables.product.prodname_actions %} workflow to the repository. For {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %}, you add the {% data variables.product.prodname_codeql_workflow %}. For more information, see "[Enabling {% data variables.product.prodname_code_scanning %} for a repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository)." + +{% data reusables.code-scanning.edit-workflow %} +For general information about configuring +{% data variables.product.prodname_code_scanning %} and editing workflow files, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" and "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." + +### About autobuild for {% data variables.product.prodname_codeql %} + +Code scanning works by running queries against one or more databases. Each database contains a representation of all of the code in a single language in your repository. For the compiled languages C/C++, C#, and Java, the process of populating this database involves building the code and extracting data. {% data reusables.code-scanning.analyze-go %} + +{% data reusables.code-scanning.autobuild-compiled-languages %} + +If your workflow uses a `language` matrix, `autobuild` attempts to build each of the compiled languages listed in the matrix. Without a matrix `autobuild` attempts to build the supported compiled language that has the most source files in the repository. With the exception of Go, analysis of other compiled languages in your repository will fail unless you supply explicit build commands. + +{% note %} + +**Note**: If you use self-hosted runners for {% data variables.product.prodname_actions %}, you may need to install additional software to use the `autobuild` process. Additionally, if your repository requires a specific version of a build tool, you may need to install it manually. For more information, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". + +{% endnote %} + +#### C/C++ + +| Supported system type | System name | +| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | +| Operating system | Windows, macOS, and Linux | +| Build system | Windows: MSbuild and build scripts
    Linux and macOS: Autoconf, Make, CMake, qmake, Meson, Waf, SCons, Linux Kbuild, and build scripts | + +The behavior of the `autobuild` step varies according to the operating system that the extraction runs on. On Windows, the `autobuild` step attempts to autodetect a suitable build method for C/C++ using the following approach: + +1. Invoke `MSBuild.exe` on the solution (`.sln`) or project (`.vcxproj`) file closest to the root. If `autobuild` detects multiple solution or project files at the same (shortest) depth from the top level directory, it will attempt to build all of them. +2. Invoke a script that looks like a build script—_build.bat_, _build.cmd_, _and build.exe_ (in that order). + +On Linux and macOS, the `autobuild` step reviews the files present in the repository to determine the build system used: + +1. Look for a build system in the root directory. +2. If none are found, search subdirectories for a unique directory with a build system for C/C++. +3. Run an appropriate command to configure the system. + +#### C + +| Supported system type | System name | +| --------------------- | ------------------------------------------ | +| Operating system | Windows and Linux | +| Build system | .NET and MSbuild, as well as build scripts | + +The `autobuild` process attempts to autodetect a suitable build method for C# using the following approach: + +1. Invoke `dotnet build` on the solution (`.sln`) or project (`.csproj`) file closest to the root. +2. Invoke `MSbuild` (Linux) or `MSBuild.exe` (Windows) on the solution or project file closest to the root. If `autobuild` detects multiple solution or project files at the same (shortest) depth from the top level directory, it will attempt to build all of them. +3. Invoke a script that looks like a build script—_build_ and _build.sh_ (in that order, for Linux) or _build.bat_, _build.cmd_, _and build.exe_ (in that order, for Windows). + +#### Java + +| Supported system type | System name | +| --------------------- | ------------------------------------------ | +| Operating system | Windows, macOS, and Linux (no restriction) | +| Build system | Gradle, Maven and Ant | + +The `autobuild` process tries to determine the build system for Java codebases by applying this strategy: + +1. Search for a build file in the root directory. Check for Gradle then Maven then Ant build files. +2. Run the first build file found. If both Gradle and Maven files are present, the Gradle file is used. +3. Otherwise, search for build files in direct subdirectories of the root directory. If only one subdirectory contains build files, run the first file identified in that subdirectory (using the same preference as for 1). If more than one subdirectory contains build files, report an error. + +### Adding build steps for a compiled language + +{% data reusables.code-scanning.autobuild-add-build-steps %} For information on how to edit the workflow file, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)." + +After removing the `autobuild` step, uncomment the `run` step and add build commands that are suitable for your repository. The workflow `run` step runs command-line programs using the operating system's shell. You can modify these commands and add more commands to customize the build process. + +``` yaml +- run: | + make bootstrap + make release +``` + +For more information about the `run` keyword, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)." + +If your repository contains multiple compiled languages, you can specify language-specific build commands. For example, if your repository contains C/C++, C# and Java, and `autobuild` correctly builds C/C++ and C# but fails to build Java, you could use the following configuration in your workflow, after the `init` step. This specifies build steps for Java while still using `autobuild` for C/C++ and C#: + +```yaml +- if: matrix.language == 'cpp' || matrix.language == 'csharp' + name: Autobuild + uses: github/codeql-action/autobuild@v1 + +- if: matrix.language == 'java' + name: Build Java + run: | + make bootstrap + make release +``` + +For more information about the `if` conditional, see "[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsif)." + +For more tips and tricks about why `autobuild` won't build your code, see "[Troubleshooting the {% data variables.product.prodname_codeql %} workflow](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow)." + +If you added manual build steps for compiled languages and {% data variables.product.prodname_code_scanning %} is still not working on your repository, contact {% data variables.contact.contact_support %}. diff --git a/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md index 641d5bec4417..1f822c185780 100644 --- a/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md +++ b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md @@ -27,19 +27,87 @@ You decide how you generate {% data variables.product.prodname_code_scanning %} {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-security %} -3. To the right of "Code scanning", click **Set up code scanning**. !["Set up code scanning" button to the right of "Code scanning" in the Security Overview](/assets/images/help/security/overview-set-up-code-scanning.png) -4. Under "Get started with code scanning", click **Set up this workflow** on the {% data variables.product.prodname_codeql_workflow %} or on a third-party workflow. !["Set up this workflow" button under "Get started with code scanning" heading](/assets/images/help/repository/code-scanning-set-up-this-workflow.png) -5. Optionally, to customize how {% data variables.product.prodname_code_scanning %} scans your code, edit the workflow. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." +3. Under "Get started with code scanning", click **Set up this workflow** on the {% data variables.product.prodname_codeql_workflow %} or on a third-party workflow. !["Set up code scanning" button to the right of "Code scanning" in the Security Overview](/assets/images/help/security/overview-set-up-code-scanning.png) +4. Under "Get started with {% data variables.product.prodname_code_scanning %}", click **Set up this workflow** on the {% data variables.product.prodname_codeql_workflow %} or on a third-party workflow. !["Set up this workflow" button under "Get started with code scanning" heading](/assets/images/help/repository/code-scanning-set-up-this-workflow.png) +5. To customize how {% data variables.product.prodname_code_scanning %} scans your code, edit the workflow. + + Generally you can commit the {% data variables.product.prodname_codeql_workflow %} without making any changes to it. However, many of the third-party workflows require additional configuration, so read the comments in the workflow before committing. + + For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." 6. Use the **Start commit** drop-down, and type a commit message. ![Start commit](/assets/images/help/repository/start-commit-commit-new-file.png) 7. Choose whether you'd like to commit directly to the default branch, or create a new branch and start a pull request. ![Choose where to commit](/assets/images/help/repository/start-commit-choose-where-to-commit.png) 8. Click **Commit new file** or **Propose new file**. -After you commit the workflow file or create a pull request, {% data variables.product.prodname_code_scanning %} will analyze your code according to the frequency you specified in your workflow file. If you created a pull request, {% data variables.product.prodname_code_scanning %} will only analyze the code on the pull request's topic branch until you merge the pull request into the default branch of the repository. +Optionally, to customize how {% data variables.product.prodname_code_scanning %} scans your code, edit the workflow. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." ### Дальнейшие шаги After you enable {% data variables.product.prodname_code_scanning %}, you can monitor analysis, view results, and further customize how you scan your code. +{% data reusables.repositories.actions-tab %} + + You'll see a list that includes an entry for running the {% data variables.product.prodname_code_scanning %} workflow. + + ![Actions list showing {% data variables.product.prodname_code_scanning %} workflow](/assets/images/help/repository/code-scanning-actions-list.png) + +1. Click the entry for the {% data variables.product.prodname_code_scanning %} workflow. + +1. Click the job name on the left. For example, **Analyze (LANGUAGE)**. + + ![Log output from the {% data variables.product.prodname_code_scanning %} workflow](/assets/images/help/repository/code-scanning-logging-analyze-action.png) + +1. Review the logging output from the actions in this workflow as they run. + +1. After a scan completes, you can view alerts from a completed scan. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository#viewing-an-alert)." + +{% note %} + +After you commit the workflow file or create a pull request, {% data variables.product.prodname_code_scanning %} will analyze your code according to the frequency you specified in your workflow file. If you created a pull request, {% data variables.product.prodname_code_scanning %} will only analyze the code on the pull request's topic branch until you merge the pull request into the default branch of the repository. + + ![Click the "n alerts found" link](/assets/images/help/repository/code-scanning-alerts-found-link.png) + +{% endnote %} + +### Understanding the pull request checks + +Each {% data variables.product.prodname_code_scanning %} workflow you enable to run on pull requests always has at least two entries listed in the checks section of a pull request. There is one entry for each of the analysis jobs in the workflow, and a final one for the results of the analysis. + +The names of the {% data variables.product.prodname_code_scanning %} analysis checks take the form: "TOOL NAME / JOB NAME (TRIGGER)." For example, for {% data variables.product.prodname_codeql %}, analysis of C++ code has the entry "{% data variables.product.prodname_codeql %} / Analyze (cpp) (pull_request)." You can click **Details** on a {% data variables.product.prodname_code_scanning %} analysis entry to see logging data. This allows you to debug a problem if the analysis job failed. For example, for {% data variables.product.prodname_code_scanning %} analysis of compiled languages, this can happen if the action can't build the code. + + ![{% data variables.product.prodname_code_scanning %} pull request checks](/assets/images/help/repository/code-scanning-pr-checks.png) + +When the {% data variables.product.prodname_code_scanning %} jobs complete, {% data variables.product.prodname_dotcom %} works out whether any alerts were added by the pull request and adds the "{% data variables.product.prodname_code_scanning_capc %} results / TOOL NAME" entry to the list of checks. After {% data variables.product.prodname_code_scanning %} has been performed at least once, you can click **Details** to view the results of the analysis. If you used a pull request to add {% data variables.product.prodname_code_scanning %} to the repository, you will initially see a "Missing analysis" message when you click **Details** on the "{% data variables.product.prodname_code_scanning_capc %} results / TOOL NAME" check. + + ![Missing analysis for commit message](/assets/images/help/repository/code-scanning-missing-analysis.png) + +#### Reasons for the "missing analysis" message + +After {% data variables.product.prodname_code_scanning %} has analyzed the code in a pull request, it needs to compare the analysis of the topic branch (the branch you used to create the pull request) with the analysis of the base branch (the branch into which you want to merge the pull request). This allows {% data variables.product.prodname_code_scanning %} to compute which alerts are newly introduced by the pull request, which alerts were already present in the base branch, and whether any existing alerts are fixed by the changes in the pull request. Initially, if you use a pull request to add {% data variables.product.prodname_code_scanning %} to a repository, the base branch has not yet been analyzed, so it's not possible to compute these details. In this case, when you click through from the results check on the pull request you will see the "Missing analysis for base commit SHA-HASH" message. + +There are other situations where there may be no analysis for the latest commit to the base branch for a pull request. These include: + +* The pull request has been raised against a branch other than the default branch or a protected branch, and this branch hasn't been analyzed. + + To the right of "Code scanning", click **Set up code scanning**. + + ![Choose a branch from the Branch drop-down menu](/assets/images/help/repository/code-scanning-branch-dropdown.png) + + The solution in this situation is to add the name of the base branch to the `on:push` and `on:pull_request` specification in the {% data variables.product.prodname_code_scanning %} workflow on that branch and then make a change that updates the open pull request that you want to scan. + +* The latest commit on the base branch for the pull request is currently being analyzed and analysis is not yet available. + + Wait a few minutes and then push a change to the pull request to retrigger {% data variables.product.prodname_code_scanning %}. + +* An error occurred while analyzing the latest commit on the base branch and analysis for that commit isn't available. + + Merge a trivial change into the base branch to trigger {% data variables.product.prodname_code_scanning %} on this latest commit, then push a change to the pull request to retrigger {% data variables.product.prodname_code_scanning %}. + +### Дальнейшие шаги + +After enabling {% data variables.product.prodname_code_scanning %}, and allowing its actions to complete, you can: + +- You can customize how {% data variables.product.prodname_code_scanning %} scans the code in your repository. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." - You can view the run status of {% data variables.product.prodname_code_scanning %} and get notifications for completed runs. For more information, see "[Managing a workflow run](/actions/configuring-and-managing-workflows/managing-a-workflow-run)" and "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)." -- After a scan completes, you can view alerts from a completed scan. For more information, see "[Managing alerts from {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." -- You can customize how {% data variables.product.prodname_code_scanning %} scans the code in your repository. For more information, see "[Configuring code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." +- Set up notifications for completed runs. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)." +- Investigate any problems that occur with the initial setup of {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %}. For more information, see "[Troubleshooting the {% data variables.product.prodname_codeql %} workflow](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow)." +- Customize how {% data variables.product.prodname_code_scanning %} scans the code in your repository. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." diff --git a/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md index f782e1bee6b5..1107de21b205 100644 --- a/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md +++ b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md @@ -1,5 +1,6 @@ --- title: Finding security vulnerabilities and errors in your code +product: '{% data reusables.gated-features.code-scanning %}' redirect_from: - /github/managing-security-vulnerabilities/finding-security-vulnerabilities-in-your-projects-code versions: @@ -11,14 +12,17 @@ versions: {% topic_link_in_list /automatically-scanning-your-code-for-vulnerabilities-and-errors %} {% link_in_list /about-code-scanning %} + {% link_in_list /triaging-code-scanning-alerts-in-pull-requests %} {% link_in_list /enabling-code-scanning-for-a-repository %} - {% link_in_list /managing-alerts-from-code-scanning %} + {% link_in_list /managing-code-scanning-alerts-for-your-repository %} {% link_in_list /configuring-code-scanning %} - {% link_in_list /configuring-the-codeql-action-for-compiled-languages %} - {% link_in_list /troubleshooting-code-scanning %} + {% link_in_list /configuring-the-codeql-workflow-for-compiled-languages %} + {% link_in_list /troubleshooting-the-codeql-workflow %} {% topic_link_in_list /integrating-with-code-scanning %} {% link_in_list /about-integration-with-code-scanning %} - {% link_in_list /running-code-scanning-in-your-ci-system %} - {% link_in_list /configuring-code-scanning-in-your-ci-system %} {% link_in_list /uploading-a-sarif-file-to-github %} {% link_in_list /sarif-support-for-code-scanning %} +{% topic_link_in_list /using-codeql-code-scanning-with-your-existing-ci-system %} + {% link_in_list /running-codeql-code-scanning-in-your-ci-system %} + {% link_in_list /configuring-codeql-code-scanning-in-your-ci-system %} + {% link_in_list /troubleshooting-codeql-code-scanning-in-your-ci-system %} diff --git a/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md index 9caa80f45c73..01a082e5015f 100644 --- a/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md +++ b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md @@ -1,8 +1,9 @@ --- title: Integrating with code scanning shortTitle: Integration -intro: 'You can integrate {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} with your existing CI systems or upload results from other tools.' +intro: 'You can integrate third-party code analysis tools with {% data variables.product.prodname_dotcom %} {% data variables.product.prodname_code_scanning %} by uploading data as SARIF files.' mapTopic: true +product: '{% data reusables.gated-features.code-scanning %}' redirect_from: - /github/finding-security-vulnerabilities-and-errors-in-your-code/managing-results-from-code-scanning versions: diff --git a/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository.md b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository.md new file mode 100644 index 000000000000..46678ed9fa21 --- /dev/null +++ b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository.md @@ -0,0 +1,63 @@ +--- +title: Managing code scanning alerts for your repository +shortTitle: Managing alerts +intro: 'You can view, fix, and close alerts for potential vulnerabilities or errors in your project''s code.' +product: '{% data reusables.gated-features.code-scanning %}' +permissions: 'People with write permission to a repository can manage {% data variables.product.prodname_code_scanning %} alerts for the repository.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +redirect_from: + - /github/managing-security-vulnerabilities/managing-alerts-from-automated-code-scanning + - /github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning +--- + +{% data reusables.code-scanning.beta %} + +### About alerts from {% data variables.product.prodname_code_scanning %} + +You can set up {% data variables.product.prodname_code_scanning %} to check the code in a repository using the default {% data variables.product.prodname_codeql %} analysis, a third-party analysis, or multiple types of analysis. When the analysis is complete, the resulting alerts are displayed alongside each other in the security view of the repository. Results from third-party tools or from custom queries may not include all of the properties that you see for alerts detected by {% data variables.product.company_short %}'s default {% data variables.product.prodname_codeql %} analysis. For more information, see "[Enabling {% data variables.product.prodname_code_scanning %} for a repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository)." + +By default, {% data variables.product.prodname_code_scanning %} analyzes your code periodically on the default branch and during pull requests. For information about managing alerts on a pull request, see "[Triaging {% data variables.product.prodname_code_scanning %} alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests)." + +### About alerts details + +Each alert highlights a problem with the code and the name of the tool that identified it. You can see the line of code that triggered the alert, as well as properties of the alert, such as the severity and the nature of the problem. Alerts also tell you when the issue was first introduced. For alerts identified by {% data variables.product.prodname_codeql %} analysis, you will also see information on how to fix the problem. + +![Example alert from {% data variables.product.prodname_code_scanning %}](/assets/images/help/repository/code-scanning-alert.png) + +If you enable {% data variables.product.prodname_code_scanning %} using {% data variables.product.prodname_codeql %}, this can also detect data-flow problems in your code. Data-flow analysis finds potential security issues in code, such as: using data insecurely, passing dangerous arguments to functions, and leaking sensitive information. + +When {% data variables.product.prodname_code_scanning %} reports data-flow alerts, {% data variables.product.prodname_dotcom %} shows you how data moves through the code. {% data variables.product.prodname_code_scanning_capc %} allows you to identify the areas of your code that leak sensitive information, and that could be the entry point for attacks by malicious users. + +### Viewing an alert + +Anyone with read permission for a repository can see {% data variables.product.prodname_code_scanning %} alerts on pull requests. However, you need write permission to view a summary of alerts for repository on the **Security** tab. By default, alerts are shown for the default branch. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-security %} +{% data reusables.repositories.sidebar-code-scanning-alerts %} +{% data reusables.code-scanning.click-alert-in-list %} +5. Optionally, if the alert highlights a problem with data flow, click **Show paths** to display the path from the data source to the sink where it's used. ![Example data-flow alert](/assets/images/help/repository/code-scanning-show-paths.png) + +### Fixing an alert + +Anyone with write permission for a repository can fix an alert by committing a correction to the code. If the repository has {% data variables.product.prodname_code_scanning %} scheduled to run on pull requests, it's best to raise a pull request with your correction. This will trigger {% data variables.product.prodname_code_scanning %} analysis of the changes and test that your fix doesn't introduce any new problems. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" and "[Triaging {% data variables.product.prodname_code_scanning %} alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests)." + +### Closing an alert + +Closing an alert is a way to resolve an alert that you don't think needs to be fixed. {% data reusables.code-scanning.close-alert-examples %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-security %} +{% data reusables.repositories.sidebar-code-scanning-alerts %} +{% data reusables.code-scanning.click-alert-in-list %} +5. Select the Close drop-down menu and click a reason for closing the alert. ![Choosing reason for closing the alert via the Close drop-down](/assets/images/help/repository/code-scanning-alert-close-drop-down.png) + +{% data reusables.code-scanning.false-positive-fix-codeql %} + +### Дополнительная литература + +- "[Triaging {% data variables.product.prodname_code_scanning %} alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests)" +- "[Enabling {% data variables.product.prodname_code_scanning %} for a repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository)" +- "[About integration with {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning)" diff --git a/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md new file mode 100644 index 000000000000..62109f2c50c6 --- /dev/null +++ b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md @@ -0,0 +1,162 @@ +--- +title: Running CodeQL code scanning in your CI system +shortTitle: Running in your CI +intro: 'You can use the {% data variables.product.prodname_codeql_runner %} to perform {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in a third-party continuous integration system.' +product: '{% data reusables.gated-features.code-scanning %}' +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta-codeql-runner %} +{% data reusables.code-scanning.beta %} +{% data reusables.code-scanning.enterprise-enable-code-scanning %} + +### Using {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} with your existing CI system + +If you use a continuous integration or continuous delivery/deployment (CI/CD) system other than {% data variables.product.prodname_actions %}, you can use your existing system to run {% data variables.product.prodname_dotcom %}'s {% data variables.product.prodname_codeql %} analysis and upload the results to {% data variables.product.prodname_dotcom %}. To do this, use the {% data variables.product.prodname_codeql_runner %}. + +### About the {% data variables.product.prodname_codeql_runner %} + +{% data reusables.code-scanning.about-code-scanning %} For information, see "[About {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)." + +You can use the {% data variables.product.prodname_codeql_runner %} to run {% data variables.product.prodname_code_scanning %} on code that you're processing in a third-party continuous integration (CI) system. Alternatively, you can use {% data variables.product.prodname_actions %} to run {% data variables.product.prodname_code_scanning %} on {% data variables.product.product_location %}. For information, see "[Enabling {% data variables.product.prodname_code_scanning %} for a repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository)." + +The {% data variables.product.prodname_codeql_runner %} is a command-line tool that runs {% data variables.product.prodname_codeql %} analysis on a checkout of a {% data variables.product.prodname_dotcom %} repository. You add the runner to your third-party system, then call the runner to analyze code and upload the results to {% data variables.product.product_location %}. These results are displayed as {% data variables.product.prodname_code_scanning %} alerts in the repository. + +{% data reusables.code-scanning.codeql-runner-license %} + +### Downloading the {% data variables.product.prodname_codeql_runner %} + +You can download the {% data variables.product.prodname_codeql_runner %} from https://github.com/github/codeql-action/releases. On some operating systems, you may need to change permissions for the downloaded file before you can run it. + +On Linux: + +```shell +chmod +x codeql-runner-linux +``` + +On MacOS: + +```shell +chmod +x codeql-runner-macos +sudo xattr -d com.apple.quarantine codeql-runner-macos +``` + +On Windows, the `codeql-runner-win.exe` file usually requires no change to permissions. + +### Adding the {% data variables.product.prodname_codeql_runner %} to your CI system + +Once you have downloaded the {% data variables.product.prodname_codeql_runner %} and verified that it can be executed, you should make the runner available to each CI server that you intend to use for {% data variables.product.prodname_code_scanning %}. It is important to notice that each CI server that you intend to use for {% data variables.product.prodname_code_scanning %} needs to have the {% data variables.product.prodname_codeql_runner %}. You might configure each server to copy the runner from a central, internal location, or you could use the REST API to get the runner direct from GitHub, for example: + +```shell +wget https://github.com/github/codeql-action/releases/download/codeql-bundle-20200826/codeql-runner-linux +chmod +x codeql-runner-linux +``` + +In addition to this, each CI server also needs: + +- A {% data variables.product.prodname_github_apps %} or personal access token for the {% data variables.product.prodname_codeql_runner %} to use. For private repositories the token must have the `repo` scope. For public the token needs only the `public_repo` and `repo:security_events` scopes. For information, see "[Building {% data variables.product.prodname_github_apps %}](/developers/apps/building-github-apps)" and "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token)." +- Access to the {% data variables.product.prodname_codeql %} bundle associated with this release of the {% data variables.product.prodname_codeql_runner %}. This package contains the {% data variables.product.prodname_codeql %} CLI, queries, and libraries needed for {% data variables.product.prodname_codeql %} analysis. For information, see "[{% data variables.product.prodname_codeql %} CLI](https://help.semmle.com/codeql/codeql-cli.html)." + +The options for providing access to the {% data variables.product.prodname_codeql %} bundle are: + +1. Allow the CI servers access to {% data variables.product.prodname_dotcom_the_website %} so that the {% data variables.product.prodname_codeql_runner %} can download the bundle automatically. +1. Manually download/extract the bundle, store it with other central resources, and use the `--codeql-path` flag to specify the location of the bundle in calls to initialize the +{% data variables.product.prodname_codeql_runner %}. +{% if currentVersion != "free-pro-team@latest" %} +1. You can mirror the `github/codeql-action` repository on {% data variables.product.product_location %}. Unless you specify the `--codeql-path` flag, the runner automatically checks for the bundle in this location and on {% data variables.product.prodname_dotcom_the_website %}.{% endif %} + +### Calling the {% data variables.product.prodname_codeql_runner %} + +You should call the {% data variables.product.prodname_codeql_runner %} from the checkout location of the repository you want to analyze. The two main commands are: + +1. `init` required to initialize the runner and create a {% data variables.product.prodname_codeql %} database for each language to be analyzed. These databases are populated and analyzed by subsequent commands. +1. `analyze` required to populate the {% data variables.product.prodname_codeql %} databases, analyze them, and upload results to {% data variables.product.product_location %}. + +For both commands, you must specify the URL of {% data variables.product.product_location %}, the repository *OWNER/NAME*, and the GitHub Apps or personal access token to use for authentication. You also need to specify the location of the CodeQL bundle unless the CI server has access to download it directly from the `github/codeql-action` repository on {% data variables.product.prodname_dotcom_the_website %}{% if currentVersion != "free-pro-team@latest" %} or mirrored on {% data variables.product.product_location %}{% endif %}. + +You can configure where the {% data variables.product.prodname_codeql_runner %} stores the CodeQL bundle for future analysis on a server using the `--tools-dir` flag and where it stores temporary files during analysis using `--temp-dir`. + +To view the command-line reference for the runner, use the `-h` flag. For example, to list all commands run: `codeql-runner-OS -h`, or to list all the flags available for the `init` command run: `codeql-runner-OS init -h` (where `OS` varies according to the executable that you are using). For more information, see "[Configuring {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system#codeql-runner-command-reference)." + +#### Basic example + +This example runs {% data variables.product.prodname_codeql %} analysis on a Linux CI server for the `octo-org/example-repo` repository hosted on `{% data variables.command_line.git_url_example %}`. The process is very simple because the repository contains only languages that can be analyzed by {% data variables.product.prodname_codeql %} directly, without being built (that is, Go, JavaScript, Python, and TypeScript). + +1. Check out the repository to analyze. +1. Move into the directory where the repository is checked out. +1. Initialize the {% data variables.product.prodname_codeql_runner %} and create {% data variables.product.prodname_codeql %} databases for the languages detected. + + ```shell + $ /path/to-runner/codeql-runner-linux init --repository octo-org/example-repo + --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN + > Cleaning temp directory /srv/checkout/example-repo/codeql-runner + > ... + > Created CodeQL database at /srv/checkout/example-repo/codeql-runner/codeql_databases/javascript. + ``` + +1. Populate the {% data variables.product.prodname_codeql_runner %} databases, analyze them, and upload the results to {% data variables.product.product_name %}. + + ```shell + $ /path/to-runner/codeql-runner-linux analyze --repository octo-org/example-repo + --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN + --commit 5b6a3078b31dc346e5ce7b86837d6abbe7a18bbd --ref refs/heads/main + > Finalizing database creation + > ... + > POST /repos/octo-org/example-repo/code-scanning/sarifs - 202 in 786ms + > Successfully uploaded results + ``` + +The server has access to download the {% data variables.product.prodname_codeql %} bundle directly from the `github/codeql-action` repository on {% data variables.product.prodname_dotcom_the_website %}{% if currentVersion != "free-pro-team@latest" %} or mirrored on {% data variables.product.product_location %}{% endif %}, so there is no need to use the `--codeql-path` flag. When the analysis is complete, the {% data variables.product.prodname_codeql_runner %} uploads the results to the {% data variables.product.prodname_code_scanning %} view. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." + +#### Compiled language example + +This example is similar to the previous example, however this time the repository has code in C/C++, C#, or Java. To create a {% data variables.product.prodname_codeql %} database for these languages, the CLI needs to monitor the build. At the end of the initialization process, the runner reports the command you need to set up the environment before building the code. You need to run this command, before calling the normal CI build process, and then running the `analyze` command. + +1. Check out the repository to analyze. +1. Move into the directory where the repository is checked out. +1. Initialize the {% data variables.product.prodname_codeql_runner %} and create {% data variables.product.prodname_codeql %} databases for the languages detected. + + ```shell + $ /path/to-runner/codeql-runner-linux init --repository octo-org/example-repo-2 + --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN + > Cleaning temp directory /srv/checkout/example-repo-2/codeql-runner + > ... + > CodeQL environment output to "/srv/checkout/example-repo-2/codeql-runner/codeql-env.json" + and "/srv/checkout/example-repo-2/codeql-runner/codeql-env.sh". + Please export these variables to future processes so the build can be traced, for example by running " + . /srv/checkout/example-repo-2/codeql-runner/codeql-env.sh". + ``` + +1. Run the script generated by the `init` action to set up the environment to monitor the build. + + ```shell + $ . /srv/checkout/example-repo-2/codeql-runner/codeql-env.sh + ``` + +1. Build the code. +1. Populate the {% data variables.product.prodname_codeql %} databases, analyze them, and upload the results to GitHub. + + ```shell + $ /path/to-runner/codeql-runner-linux analyze --repository octo-org/example-repo-2 + --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN + --commit ae7b655ef30b50fb726ae7b3daa79571a39d194d --ref refs/heads/main + > Finalizing database creation + > ... + > POST /repos/octo-org/example-repo-2/code-scanning/sarifs - 202 in 573ms + > Successfully uploaded results + ``` + +{% note %} + +**Note:** If you use a containerized build, you need to run the {% data variables.product.prodname_codeql_runner %} in the container where your build task takes place. + +{% endnote %} + +### Дополнительная литература + +- "[Configuring {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system)" +- "[Troubleshooting {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system)" diff --git a/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md index 7ebd91f0f31a..633c5cc926d2 100644 --- a/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md +++ b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md @@ -11,27 +11,32 @@ versions: --- {% data reusables.code-scanning.beta %} -{% data reusables.code-scanning.enterprise-enable-code-scanning %} ### About SARIF support SARIF (Static Analysis Results Interchange Format) is an [OASIS Standard](https://docs.oasis-open.org/sarif/sarif/v2.1.0/sarif-v2.1.0.html) that defines an output file format. The SARIF standard is used to streamline how static analysis tools share their results. {% data variables.product.prodname_code_scanning_capc %} supports a subset of the SARIF 2.1.0 JSON schema. -To upload a SARIF file from a third-party static code analysis engine, you'll need to ensure that uploaded files use the SARIF 2.1.0 version. {% data variables.product.prodname_dotcom %} will parse the SARIF file and show alerts using the results in your repository as a part of the code scanning experience. For more information, see "[Uploading a SARIF file to {% data variables.product.prodname_dotcom %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)." For more information about the SARIF 2.1.0 JSON schema, see [`sarif-schema-2.1.0.json`](https://github.com/oasis-tcs/sarif-spec/blob/master/Schemata/sarif-schema-2.1.0.json). +To upload a SARIF file from a third-party static code analysis engine, you'll need to ensure that uploaded files use the SARIF 2.1.0 version. To upload a SARIF file from a third-party static code analysis engine, you'll need to ensure that uploaded files use the SARIF 2.1.0 version. For more information, see "[Uploading a SARIF file to {% data variables.product.prodname_dotcom %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)." For more information about the SARIF 2.1.0 JSON schema, see [`sarif-schema-2.1.0.json`](https://github.com/oasis-tcs/sarif-spec/blob/master/Schemata/sarif-schema-2.1.0.json). -If you're using {% data variables.product.prodname_actions %} with the {% data variables.product.prodname_codeql_workflow %} or using the {% data variables.product.prodname_codeql_runner %}, then the {% data variables.product.prodname_code_scanning %} results will automatically use the supported subset of SARIF 2.1.0. For more information, see "[Enabling {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning)" or "[Running code scanning in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)." +If you're using {% data variables.product.prodname_actions %} with the {% data variables.product.prodname_codeql_workflow %} or using the {% data variables.product.prodname_codeql_runner %}, then the {% data variables.product.prodname_code_scanning %} results will automatically use the supported subset of SARIF 2.1.0. For more information, see "[Enabling {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning)" or "[Running {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)." -{% data variables.product.prodname_dotcom %} uses properties in the SARIF file to display alerts. For example, the `shortDescription` and `fullDescription` appear at the top of a {% data variables.product.prodname_code_scanning %} alert. The `location` allows {% data variables.product.prodname_dotcom %} to show annotations in your code file. For more information, see "[Managing alerts from {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." +{% data variables.product.prodname_dotcom %} uses properties in the SARIF file to display alerts. For example, the `shortDescription` and `fullDescription` appear at the top of a {% data variables.product.prodname_code_scanning %} alert. The `location` allows {% data variables.product.prodname_dotcom %} to show annotations in your code file. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." If you're new to SARIF and want to learn more, see Microsoft's [`SARIF tutorials`](https://github.com/microsoft/sarif-tutorials) repository. ### Preventing duplicate alerts using fingerprints -Each time the results of a new code scan are uploaded, the results are processed and alerts are added to the repository. To prevent duplicate alerts for the same problem, {% data variables.product.prodname_code_scanning %} uses fingerprints to match results across various runs so they only appear once in the latest run for the selected branch. +Each time the results of a new code scan are uploaded, the results are processed and alerts are added to the repository. To prevent duplicate alerts for the same problem, {% data variables.product.prodname_code_scanning %} uses fingerprints to match results across various runs so they only appear once in the latest run for the selected branch. This makes it possible to match alerts to the right line of code when files are edited. {% data variables.product.prodname_dotcom %} uses the `partialFingerprints` property in the OASIS standard to detect when two results are logically identical. For more information, see the "[partialFingerprints property](https://docs.oasis-open.org/sarif/sarif/v2.1.0/cs01/sarif-v2.1.0-cs01.html#_Toc16012611)" entry in the OASIS documentation. -SARIF files created by the {% data variables.product.prodname_codeql_workflow %} or using the {% data variables.product.prodname_codeql_runner %} include fingerprint data. If your SARIF file doesn't include `partialFingerprints`, the `partialFingerprints` field will be calculated if you upload the SARIF file using {% data variables.product.prodname_actions %}. For more information, see "[Uploading a SARIF file to {% data variables.product.prodname_dotcom %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github#uploading-a-code-scanning-analysis-with-github-actions)." +SARIF files created by the {% data variables.product.prodname_codeql_workflow %} or using the {% data variables.product.prodname_codeql_runner %} include fingerprint data. If you upload a SARIF file using the `upload-sarif` action and this data is missing, {% data variables.product.prodname_dotcom %} attempts to populate the `partialFingerprints` field from the source files. For more information about uploading results, see "[Uploading a SARIF file to {% data variables.product.prodname_dotcom %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github#uploading-a-code-scanning-analysis-with-github-actions)." + +If you upload a SARIF file without fingerprint data using the `/code-scanning/sarifs` API endpoint, the {% data variables.product.prodname_code_scanning %} alerts will be processed and displayed, but users may see duplicate alerts. To avoid seeing duplicate alerts, you should calculate fingerprint data and populate the `partialFingerprints` property before you upload the SARIF file. You may find the script that the `upload-sarif` action uses a helpful starting point: https://github.com/github/codeql-action/blob/main/src/fingerprints.ts. For more information about the API, see "[Upload a SARIF file](/rest/reference/code-scanning#upload-a-sarif-file)." + +### Validating your SARIF file + +If you're using {% data variables.product.prodname_actions %} with the {% data variables.product.prodname_codeql_workflow %} or using the {% data variables.product.prodname_codeql_runner %}, then the {% data variables.product.prodname_code_scanning %} results will automatically use the supported subset of SARIF 2.1.0. For more information, visit the [Microsoft SARIF validator](https://sarifweb.azurewebsites.net/). ### Supported SARIF output file properties @@ -44,49 +49,49 @@ Any valid SARIF 2.1.0 output file can be uploaded, however, {% data variables.pr | Name | Description | | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `$schema` | **Required.** The URI of the SARIF JSON schema for version 2.1.0. For example, `https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json`. | -| `версия` | **Required.** {% data variables.product.prodname_code_scanning_capc %} only supports SARIF version `2.1.0`. | +| `версия` | **Required.** {% data variables.product.prodname_code_scanning_capc %} only supports SARIF version `2.1.0`. | | `runs[]` | **Required.** A SARIF file contains an array of one or more runs. Each run represents a single run of an analysis tool. For more information about a `run`, see the [`run` object](#run-object). | #### `run` object {% data variables.product.prodname_code_scanning_capc %} uses the `run` object to filter results by tool and provide information about the source of a result. The `run` object contains the `tool.driver` tool component object, which contains information about the tool that generated the results. Each `run` can only have results for one analysis tool. -| Name | Description | -| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Name | Description | +| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `tool.driver.name` | **Required.** The name of the analysis tool. {% data variables.product.prodname_code_scanning_capc %} displays the name on {% data variables.product.prodname_dotcom %} to allow you to filter results by tool. | | `tool.driver.version` | **Optional.** The version of the analysis tool. {% data variables.product.prodname_code_scanning_capc %} uses the version number to track when results may have changed due to a tool version change rather than a change in the code being analyzed. If the SARIF file includes the `semanticVersion` field, `version` is not used by {% data variables.product.prodname_code_scanning %}. | | `tool.driver.semanticVersion` | **Optional.** The version of the analysis tool, specified by the Semantic Versioning 2.0 format. {% data variables.product.prodname_code_scanning_capc %} uses the version number to track when results may have changed due to a tool version change rather than a change in the code being analyzed. If the SARIF file includes the `semanticVersion` field, `version` is not used by {% data variables.product.prodname_code_scanning %}. For more information, see "[Semantic Versioning 2.0.0](https://semver.org/)" in the Semantic Versioning documentation. | -| `tool.driver.rules[]` | **Required.** An array of `reportingDescriptor` objects that represent rules. The analysis tool uses rules to find problems in the code being analyzed. For more information, see the [`reportingDescriptor` object](#reportingdescriptor-object). | +| `tool.driver.rules[]` | **Required.** An array of `reportingDescriptor` objects that represent rules. The analysis tool uses rules to find problems in the code being analyzed. For more information, see the [`reportingDescriptor` object](#reportingdescriptor-object). | | `results[]` | **Required.** The results of the analysis tool. {% data variables.product.prodname_code_scanning_capc %} displays the results on {% data variables.product.prodname_dotcom %}. For more information, see the [`result` object](#result-object). | #### `reportingDescriptor` object -| Name | Description | -| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Name | Description | +| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | **Required.** A unique identifier for the rule. The `id` is referenced from other parts of the SARIF file and may be used by {% data variables.product.prodname_code_scanning %} to display URLs on {% data variables.product.prodname_dotcom %}. | | `name` | **Optional.** The name of the rule. {% data variables.product.prodname_code_scanning_capc %} displays the name to allow results to be filtered by rule on {% data variables.product.prodname_dotcom %}. | | `shortDescription.text` | **Required.** A concise description of the rule. {% data variables.product.prodname_code_scanning_capc %} displays the short description on {% data variables.product.prodname_dotcom %} next to the associated results. | | `fullDescription.text` | **Required.** A description of the rule. {% data variables.product.prodname_code_scanning_capc %} displays the full description on {% data variables.product.prodname_dotcom %} next to the associated results. The max number of characters is limited to 1000. | -| `defaultConfiguration.level` | **Optional.** Default severity level of the rule. {% data variables.product.prodname_code_scanning_capc %} uses severity levels to help you understand how critical the result is for a given rule. This value can be overridden by the `level` attribute in the `result` object. For more information, see the [`result` object](#result-object). Default: `warning`. | -| `help.text` | **Required.** Documentation for the rule using text format. {% data variables.product.prodname_code_scanning_capc %} displays this help documentation next to the associated results. | -| `help.markdown` | **Recommended.** Documentation for the rule using Markdown format. {% data variables.product.prodname_code_scanning_capc %} displays this help documentation next to the associated results. When `help.markdown` is available, it is displayed instead of `help.text`. | +| `defaultConfiguration.level` | **Optional.** Default severity level of the rule. {% data variables.product.prodname_code_scanning_capc %} uses severity levels to help you understand how critical the result is for a given rule. This value can be overridden by the `level` attribute in the `result` object. For more information, see the [`result` object](#result-object). Default: `warning`. | +| `help.text` | **Required.** Documentation for the rule using text format. {% data variables.product.prodname_code_scanning_capc %} displays this help documentation next to the associated results. | +| `help.markdown` | **Recommended.** Documentation for the rule using Markdown format. {% data variables.product.prodname_code_scanning_capc %} displays this help documentation next to the associated results. When `help.markdown` is available, it is displayed instead of `help.text`. | | `properties.tags[]` | **Optional.** An array of strings. {% data variables.product.prodname_code_scanning_capc %} uses `tags` to allow you to filter results on {% data variables.product.prodname_dotcom %}. For example, it is possible to filter to all results that have the tag `security`. | | `properties.precision` | **Recommended.** A string that indicates how often the results indicated by this rule are true. For example, if a rule has a known high false-positive rate, the precision should be `low`. {% data variables.product.prodname_code_scanning_capc %} orders results by precision on {% data variables.product.prodname_dotcom %} so that the results with the highest `level`, and highest `precision` are shown first. Can be one of: `very-high`, `high`, `medium`, or `low`. | #### `result` object -| Name | Description | -| --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `ruleId` | **Optional.** The unique identifier of the rule (`reportingDescriptor.id`). For more information, see the [`reportingDescriptor` object](#reportingdescriptor-object). {% data variables.product.prodname_code_scanning_capc %} uses the rule identifier to filter results by rule on {% data variables.product.prodname_dotcom %}. | -| `ruleIndex` | **Optional.** The index of the associated rule (`reportingDescriptor` object) in the tool component `rules` array. For more information, see the [`run` object](#run-object). | -| `rule` | **Optional.** A reference used to locate the rule (reporting descriptor) for this result. For more information, see the [`reportingDescriptor` object](#reportingdescriptor-object). | -| `level` | **Optional.** The severity of the result. This level overrides the default severity defined by the rule. {% data variables.product.prodname_code_scanning_capc %} uses the level to filter results by severity on {% data variables.product.prodname_dotcom %}. | -| `message.text` | **Required.** A message that describes the result. {% data variables.product.prodname_code_scanning_capc %} displays the message text as the title of the result. Only the first sentence of the message will be displayed when visible space is limited. | -| `locations[]` | **Required.** The set of locations where the result was detected. Only one location should be included unless the problem can only be corrected by making a change at every specified location. **Note:** At least one location is required for {% data variables.product.prodname_code_scanning %} to display a result. {% data variables.product.prodname_code_scanning_capc %} will use this property to decide which file to annotate with the result. Only the first value of this array is used. All other values are ignored. | +| Name | Description | +| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `ruleId` | **Optional.** The unique identifier of the rule (`reportingDescriptor.id`). For more information, see the [`reportingDescriptor` object](#reportingdescriptor-object). {% data variables.product.prodname_code_scanning_capc %} uses the rule identifier to filter results by rule on {% data variables.product.prodname_dotcom %}. | +| `ruleIndex` | **Optional.** The index of the associated rule (`reportingDescriptor` object) in the tool component `rules` array. For more information, see the [`run` object](#run-object). | +| `rule` | **Optional.** A reference used to locate the rule (reporting descriptor) for this result. For more information, see the [`reportingDescriptor` object](#reportingdescriptor-object). | +| `level` | **Optional.** The severity of the result. This level overrides the default severity defined by the rule. {% data variables.product.prodname_code_scanning_capc %} uses the level to filter results by severity on {% data variables.product.prodname_dotcom %}. | +| `message.text` | **Required.** A message that describes the result. {% data variables.product.prodname_code_scanning_capc %} displays the message text as the title of the result. Only the first sentence of the message will be displayed when visible space is limited. | +| `locations[]` | **Required.** The set of locations where the result was detected. Only one location should be included unless the problem can only be corrected by making a change at every specified location. **Note:** At least one location is required for {% data variables.product.prodname_code_scanning %} to display a result. {% data variables.product.prodname_code_scanning_capc %} will use this property to decide which file to annotate with the result. Only the first value of this array is used. All other values are ignored. | | `partialFingerprints` | **Required.** A set of strings used to track the unique identity of the result. {% data variables.product.prodname_code_scanning_capc %} uses `partialFingerprints` to accurately identify which results are the same across commits and branches. {% data variables.product.prodname_code_scanning_capc %} will attempt to use `partialFingerprints` if they exist. If you are uploading third-party SARIF files with the `upload-action`, the action will create `partialFingerprints` for you when they are not included in the SARIF file. For more information, see "[Preventing duplicate alerts using fingerprints](#preventing-duplicate-alerts-using-fingerprints)." **Note:** {% data variables.product.prodname_code_scanning_capc %} only uses the `primaryLocationLineHash`. | -| `codeFlows[].threadFlows[].locations[]` | **Optional.** An array of `location` objects for a `threadFlow` object, which describes the progress of a program through a thread of execution. A `codeFlow` object describes a pattern of code execution used to detect a result. If code flows are provided, {% data variables.product.prodname_code_scanning %} will expand code flows on {% data variables.product.prodname_dotcom %} for the relevant result. For more information, see the [`location` object](#location-object). | -| `relatedLocations[]` | A set of locations relevant to this result. {% data variables.product.prodname_code_scanning_capc %} will link to related locations when they are embedded in the result message. For more information, see the [`location` object](#location-object). | -| `suppressions[].state` | **Optional.** When the `state` is set to `accepted`, {% data variables.product.prodname_code_scanning %} will update the state of the result to `Closed` on {% data variables.product.prodname_dotcom %}. | +| `codeFlows[].threadFlows[].locations[]` | **Optional.** An array of `location` objects for a `threadFlow` object, which describes the progress of a program through a thread of execution. A `codeFlow` object describes a pattern of code execution used to detect a result. If code flows are provided, {% data variables.product.prodname_code_scanning %} will expand code flows on {% data variables.product.prodname_dotcom %} for the relevant result. For more information, see the [`location` object](#location-object). | +| `relatedLocations[]` | A set of locations relevant to this result. {% data variables.product.prodname_code_scanning_capc %} will link to related locations when they are embedded in the result message. For more information, see the [`location` object](#location-object). | +| `suppressions[].state` | **Optional.** When the `state` is set to `accepted`, {% data variables.product.prodname_code_scanning %} will update the state of the result to `Closed` on {% data variables.product.prodname_dotcom %}. | #### `location` object @@ -100,13 +105,13 @@ A location within a programming artifact, such as a file in the repository or a #### `physicalLocation` object -| Name | Description | -| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Name | Description | +| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `artifactLocation.uri` | **Required.** A URI indicating the location of an artifact, usually a file either in the repository or generated during a build. If the URI is relative, it should be relative to the root of the {% data variables.product.prodname_dotcom %} repository being analyzed. For example, main.js or src/script.js are relative to the root of the repository. If the URI is absolute, {% data variables.product.prodname_code_scanning %} can use the URI to checkout the artifact and match up files in the repository. For example, `https://github.com/github/example/blob/00/src/promiseUtils.js`. | -| `region.startLine` | **Required.** The line number of the first character in the region. | -| `region.startColumn` | **Required.** The column number of the first character in the region. | -| `region.endLine` | **Required.** The line number of the last character in the region. | -| `region.endColumn` | **Required.** The column number of the character following the end of the region. | +| `region.startLine` | **Required.** The line number of the first character in the region. | +| `region.startColumn` | **Required.** The column number of the first character in the region. | +| `region.endLine` | **Required.** The line number of the last character in the region. | +| `region.endColumn` | **Required.** The column number of the character following the end of the region. | ### SARIF output file examples @@ -119,38 +124,47 @@ This SARIF output file has example values to show the minimum required propertie ```json { - "$schema" : "https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json", - "version" : "2.1.0", - "runs" : - [ + "$schema": "https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json", + "version": "2.1.0", + "runs": [ { - "tool" : { - "driver" : { - "name" : "Tool Name" - } - }, - "results" : [ { - "message" : { - "text" : "Result text. This result does not have a rule associated." - }, - "locations" : [ { - "physicalLocation" : { - "artifactLocation" : { - "uri" : "src/build.cmd" - }, - "region" : { - "startLine" : 2, - "startColumn" : 7, - "endColumn" : 10 + "tool": { + "driver": { + "name": "Tool Name", + "rules": [ + { + "id": "R01" } + ] + } + }, + "results": [ + { + "ruleId": "R01", + "message": { + "text": "Result text. This result does not have a rule associated." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "fileURI" + }, + "region": { + "startLine": 2, + "startColumn": 7, + "endColumn": 10 + } + } } - } ], - "partialFingerprints" : { - "primaryLocationLineHash" : "39fa2ee980eb94b0:1" + ], + "partialFingerprints": { + "primaryLocationLineHash": "39fa2ee980eb94b0:1" + } } - }] - } - ] + ] + } + ] } ``` @@ -170,7 +184,7 @@ This SARIF output file has example values to show all supported SARIF properties "semanticVersion": "2.0.0", "rules": [ { - "id": "js/unused-local-variable", + "id": "3f292041e51d22005ce48f39df3585d44ce1b0ad", "name": "js/unused-local-variable", "shortDescription": { "text": "Unused variable, import, function or class" @@ -189,7 +203,7 @@ This SARIF output file has example values to show all supported SARIF properties } }, { - "id": "js/inconsistent-use-of-new", + "id": "d5b664aefd5ca4b21b52fdc1d744d7d6ab6886d0", "name": "js/inconsistent-use-of-new", "shortDescription": { "text": "Inconsistent use of 'new'" @@ -197,7 +211,6 @@ This SARIF output file has example values to show all supported SARIF properties "fullDescription": { "text": "If a function is intended to be a constructor, it should always be invoked with 'new'. Otherwise, it should always be invoked as a normal function, that is, without 'new'." }, - "defaultConfiguration": null, "properties": { "tags": [ "reliability", @@ -206,13 +219,16 @@ This SARIF output file has example values to show all supported SARIF properties ], "precision": "very-high" } + }, + { + "id": "R01" } ] } }, "results": [ { - "ruleId": "js/unused-local-variable", + "ruleId": "3f292041e51d22005ce48f39df3585d44ce1b0ad", "ruleIndex": 0, "message": { "text": "Unused variable foo." @@ -222,8 +238,7 @@ This SARIF output file has example values to show all supported SARIF properties "physicalLocation": { "artifactLocation": { "uri": "main.js", - "uriBaseId": "%SRCROOT%", - "index": 0 + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 2, @@ -239,7 +254,7 @@ This SARIF output file has example values to show all supported SARIF properties } }, { - "ruleId": "js/inconsistent-use-of-new", + "ruleId": "d5b664aefd5ca4b21b52fdc1d744d7d6ab6886d0", "ruleIndex": 1, "message": { "text": "Function resolvingPromise is sometimes invoked as a constructor (for example [here](1)), and sometimes as a normal function (for example [here](2))." @@ -248,8 +263,8 @@ This SARIF output file has example values to show all supported SARIF properties { "physicalLocation": { "artifactLocation": { - "uri": "https://github.com/github/example/blob/0000000000000000000000000000000000000000/src/promiseUtils.js", - "index": 1 + "uri": "src/promises.js", + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 2 @@ -267,8 +282,7 @@ This SARIF output file has example values to show all supported SARIF properties "physicalLocation": { "artifactLocation": { "uri": "src/ParseObject.js", - "uriBaseId": "%SRCROOT%", - "index": 3 + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 2281, @@ -285,8 +299,7 @@ This SARIF output file has example values to show all supported SARIF properties "physicalLocation": { "artifactLocation": { "uri": "src/LiveQueryClient.js", - "uriBaseId": "%SRCROOT%", - "index": 2 + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 166 @@ -299,6 +312,7 @@ This SARIF output file has example values to show all supported SARIF properties ] }, { + "ruleId": "R01", "message": { "text": "Specifying both [ruleIndex](1) and [ruleID](2) might lead to inconsistencies." }, @@ -308,8 +322,7 @@ This SARIF output file has example values to show all supported SARIF properties "physicalLocation": { "artifactLocation": { "uri": "full.sarif", - "uriBaseId": "%SRCROOT%", - "index": 0 + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 54, @@ -403,12 +416,6 @@ This SARIF output file has example values to show all supported SARIF properties } } ], - "newlineSequences": [ - "\r\n", - "\n", - "", - "" - ], "columnKind": "utf16CodeUnits" } ] diff --git a/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md new file mode 100644 index 000000000000..931419d50117 --- /dev/null +++ b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md @@ -0,0 +1,48 @@ +--- +title: Triaging code scanning alerts in pull requests +shortTitle: Triaging alerts in pull requests +intro: 'When {% data variables.product.prodname_code_scanning %} identifies a problem in a pull request, you can review the highlighted code and resolve the alert.' +product: '{% data reusables.gated-features.code-scanning %}' +permissions: 'People with write permission to a repository can resolve {% data variables.product.prodname_code_scanning %} alerts.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta %} + +### About {% data variables.product.prodname_code_scanning %} results on pull requests + +In repositories where {% data variables.product.prodname_code_scanning %} is configured as a pull request check, {% data variables.product.prodname_code_scanning %} checks the code in the pull request. By default, this is limited to pull requests that target the default branch or protected branches, but you can change this configuration within {% data variables.product.prodname_actions %} or in a third-party CI/CD system. If merging the changes would introduce new {% data variables.product.prodname_code_scanning %} alerts to the target branch, these are reported as check results in the pull request. The alerts are also shown as annotations in the **Files changed** tab of the pull request. If you have write permission for the repository, you can see any existing {% data variables.product.prodname_code_scanning %} alerts on the **Security** tab. For information about repository alerts, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." + +If {% data variables.product.prodname_code_scanning %} has any results with a severity of `error`, the check fails and the error is reported in the check results. If all the results found by {% data variables.product.prodname_code_scanning %} have lower severities, the alerts are treated as warnings or notices and the check succeeds. If your pull request targets a protected branch, and the repository owner has configured required status checks, then you must either fix or close any error alerts before the pull request can be merged. For more information, see "[About required status checks](/github/administering-a-repository/about-required-status-checks)." + +![Example pull request check status with {% data variables.product.prodname_code_scanning %} alert](/assets/images/help/repository/code-scanning-check-failure.png) + +### About {% data variables.product.prodname_code_scanning %} as a pull request check + +There are many options for configuring {% data variables.product.prodname_code_scanning %} as a pull request check, so the exact setup of each repository will vary and some will have more than one check. The check that contains the results of {% data variables.product.prodname_code_scanning %} is: **Code scanning results**. + +If the repository uses the {% data variables.product.prodname_codeql_workflow %} a **{% data variables.product.prodname_codeql %} / Analyze (LANGUAGE)** check is run for each language before the results check runs. The analysis check may fail if there are configuration problems, or if the pull request breaks the build for a language that the analysis needs to compile (for example, C/C++, C#, or Java). As with other pull request checks, you can see full details of the check failure on the **Checks** tab. For more information about configuring and troubleshooting, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" or "[Troubleshooting {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning)." + +### Triaging an alert on your pull request + +When you look at the **Files changed** tab for a pull request, you see annotations for any lines of code that triggered the alert. + +![Example {% data variables.product.prodname_code_scanning %} alert shown as an annotation in the "Files changed" view of a pull request](/assets/images/help/repository/code-scanning-pr-annotation.png) + +Some annotations contain links with extra context for the alert. In the example above, from {% data variables.product.prodname_codeql %} analysis, you can click **user-provided value** to see where the untrusted data enters the data flow (this is referred to as the source). In this case you can view the full path from the source to the code that uses the data (the sink) by clicking **Show paths**. This makes it easy to check whether the data is untrusted or if the analysis failed to recognize a data sanitization step between the source and the sink. For information about analyzing data flow using {% data variables.product.prodname_codeql %}, see "[About data flow analysis](https://help.semmle.com/QL/learn-ql/intro-to-data-flow.html)." + +For more information about an alert, click **Show more details** on the annotation. This allows you to see all of the context and metadata provided by the tool in an alert view. In the example below, you can see tags showing the severity, type, and relevant common weakness enumerations (CWEs) for the problem. The view also shows which commit introduced the problem. + +Alerts from some tools, like {% data variables.product.prodname_codeql %}, also include a description and a **Show more** link for guidance on how to fix the problem in the code. + +![Example of "Show more details" for a {% data variables.product.prodname_code_scanning %} alert in a pull request](/assets/images/help/repository/code-scanning-pr-alert.png) + +### Resolving an alert on your pull request + +Anyone with write permission for a repository can resolve alerts on a pull request. If you commit changes to the pull request this triggers a new run of the pull request checks. If your changes fix the problem, the alert is resolved and the annotation removed. + +If you don't think that an alert needs to be fixed, you can close the alert manually. {% data reusables.code-scanning.close-alert-examples %} The **Close** button is available in annotations and in the alerts view if you have write permission for the repository. + +{% data reusables.code-scanning.false-positive-fix-codeql %} diff --git a/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md new file mode 100644 index 000000000000..317698c3e0b0 --- /dev/null +++ b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md @@ -0,0 +1,52 @@ +--- +title: Troubleshooting CodeQL code scanning in your CI system +shortTitle: Troubleshooting in your CI +intro: 'If you''re having problems with the {% data variables.product.prodname_codeql_runner %}, you can troubleshoot by using these tips.' +product: '{% data reusables.gated-features.code-scanning %}' +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning-in-your-ci-system +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta-codeql-runner %} +{% data reusables.code-scanning.beta %} + +### The `init` command takes too long + +Before the {% data variables.product.prodname_codeql_runner %} can build and analyze code, it needs access to the {% data variables.product.prodname_codeql %} bundle, which contains the {% data variables.product.prodname_codeql %} CLI and the {% data variables.product.prodname_codeql %} libraries. + +When you use the {% data variables.product.prodname_codeql_runner %} for the first time on your machine, the `init` command downloads the {% data variables.product.prodname_codeql %} bundle to your machine. This download can take a few minutes. The {% data variables.product.prodname_codeql %} bundle is cached between runs, so if you use the {% data variables.product.prodname_codeql_runner %} again on the same machine, it won't download the {% data variables.product.prodname_codeql %} bundle again. + +To avoid this automatic download, you can manually download the {% data variables.product.prodname_codeql %} bundle to your machine and specify the path using the `--codeql-path` flag of the `init` command. + +### No code found during the build + +If the `analyze` command for the {% data variables.product.prodname_codeql_runner %} fails with an error `No source code was seen during the build`, this indicates that {% data variables.product.prodname_codeql %} was unable to monitor your code. Several reasons can explain such a failure. + +1. Automatic language detection identified a supported language, but there is no analyzable code of that language in the repository. A typical example is when our language detection service finds a file associated with a particular programming language like a `.h`, or `.gyp` file, but no corresponding executable code is present in the repository. To solve the problem, you can manually define the languages you want to analyze by using the `--languages` flag of the `init` command. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system)." + +1. You're analyzing a compiled language without using the `autobuild` command and you run the build steps yourself after the `init` step. For the build to work, you must set up the environment such that the {% data variables.product.prodname_codeql_runner %} can monitor the code. The `init` command generates instructions for how to export the required environment variables, so you can copy and run the script after you've run the `init` command. + - On macOS and Linux: + ```shell + $ . codeql-runner/codeql-env.sh + ``` + - On Windows, using the Command shell (`cmd`) or a batch file (`.bat`): + ```shell + > call codeql-runner\codeql-env.bat + ``` + - On Windows, using PowerShell: + ```shell + > cat codeql-runner\codeql-env.sh | Invoke-Expression + ``` + + The environment variables are also stored in the file `codeql-runner/codeql-env.json`. This file contains a single JSON object which maps environment variable keys to values. If you can't run the script generated by the `init` command, then you can use the data in JSON format instead. + + {% note %} + + **Note:** If you used the `--temp-dir` flag of the `init` command to specify a custom directory for temporary files, the path to the `codeql-env` files might be different. + + {% endnote %} + +1. The code is built in a container or on a separate machine. If you use a containerized build or if you outsource the build to another machine, make sure to run the {% data variables.product.prodname_codeql_runner %} in the container or on the machine where your build task takes place. diff --git a/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md new file mode 100644 index 000000000000..a34e7f6ac2a9 --- /dev/null +++ b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md @@ -0,0 +1,126 @@ +--- +title: Troubleshooting the CodeQL workflow +shortTitle: Troubleshooting CodeQL +intro: 'If you''re having problems with {% data variables.product.prodname_code_scanning %}, you can troubleshoot by using these tips for resolving issues.' +product: '{% data reusables.gated-features.code-scanning %}' +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta %} + +### Automatic build for a compiled language fails + +If an automatic build of code for a compiled language within your project fails, try the following troubleshooting steps. + +- Remove the `autobuild` step from your {% data variables.product.prodname_code_scanning %} workflow and add specific build steps. For information about editing the workflow, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)." For more information about replacing the `autobuild` step, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." + +- If your workflow doesn't explicitly specify the languages to analyze, {% data variables.product.prodname_codeql %} implicitly detects the supported languages in your code base. In this configuration, out of the compiled languages C/C++, C#, and Java, {% data variables.product.prodname_codeql %} only analyzes the language with the most source files. Edit the workflow and add a build matrix specifying the languages you want to analyze. The default CodeQL analysis workflow uses such a matrix. + + The following extracts from a workflow show how you can use a matrix within the job strategy to specify languages, and then reference each language within the "Initialize {% data variables.product.prodname_codeql %}" step: + + ```yaml + jobs: + analyze: + ... + strategy: + fail-fast: false + matrix: + language: ['csharp', 'cpp', 'javascript'] + + ... + + - name: Initialize {% data variables.product.prodname_codeql %} + uses: github/codeql-action/init@v1 + with: + languages: {% raw %}${{ matrix.language }}{% endraw %} + ``` + + For more information about editing the workflow, see "[Configuring code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." + +### No code found during the build + +If your workflow fails with an error `No source code was seen during the build` or `The process '/opt/hostedtoolcache/CodeQL/0.0.0-20200630/x64/codeql/codeql' failed with exit code 32`, this indicates that {% data variables.product.prodname_codeql %} was unable to monitor your code. Several reasons can explain such a failure: + +1. Automatic language detection identified a supported language, but there is no analyzable code of that language in the repository. A typical example is when our language detection service finds a file associated with a particular programming language like a `.h`, or `.gyp` file, but no corresponding executable code is present in the repository. To solve the problem, you can manually define the languages you want to analyze by updating the list of languages in the `language` matrix. For example, the following configuration will analyze only Go, and JavaScript. + + ```yaml + strategy: + fail-fast: false + matrix: + # Override automatic language detection by changing the list below + # Supported options are: + # ['csharp', 'cpp', 'go', 'java', 'javascript', 'python'] + language: ['go', 'javascript'] + ``` +For more information, see the workflow extract in "[Automatic build for a compiled language fails](#automatic-build-for-a-compiled-language-fails)" above. +1. Your {% data variables.product.prodname_code_scanning %} workflow is analyzing a compiled language (C, C++, C#, or Java), but the code was not compiled. By default, the {% data variables.product.prodname_codeql %} analysis workflow contains an `autobuild` step, however, this step represents a best effort process, and may not succeed in building your code, depending on your specific build environment. Compilation may also fail if you have removed the `autobuild` step and did not include build steps manually. For more information about specifying build steps, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." +1. Your workflow is analyzing a compiled language (C, C++, C#, or Java), but portions of your build are cached to improve performance (most likely to occur with build systems like Gradle or Bazel). Since {% data variables.product.prodname_codeql %} observes the activity of the compiler to understand the data flows in a repository, {% data variables.product.prodname_codeql %} requires a complete build to take place in order to perform analysis. +1. Your workflow is analyzing a compiled language (C, C++, C#, or Java), but compilation does not occur between the `init` and `analyze` steps in the workflow. {% data variables.product.prodname_codeql %} requires that your build happens in between these two steps in order to observe the activity of the compiler and perform analysis. +1. Your compiled code (in C, C++, C#, or Java) was compiled successfully, but {% data variables.product.prodname_codeql %} was unable to detect the compiler invocations. The most common causes are certain configuration options like running your build process in a container, if you're building using a distributed build system external to {% data variables.product.prodname_actions %} using a daemon process, or if {% data variables.product.prodname_codeql %} isn't aware of the specific compiler you are using. + + For C# projects using either `dotnet build` or `msbuild` which target .NET Core 2, you should specify `/p:UseSharedCompilation=false` in your workflow's `run` step, when you build your code. The `UseSharedCompilation` flag isn't necessary for .NET Core 3.0 and later. + + For example, the following configuration for C# will pass the flag during the first build step. + + ``` yaml + - run: | + dotnet build /p:UseSharedCompilation=false + ``` + + If you encounter another problem with your specific compiler or configuration, contact {% data variables.contact.contact_support %}. + +For more information about specifying build steps, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." + +### Portions of my repository were not analyzed using `autobuild` + +The {% data variables.product.prodname_codeql %} `autobuild` feature uses heuristics to build the code in a repository, however, sometimes this approach results in incomplete analysis of a repository. For example, when multiple `build.sh` commands exist in a single repository, the analysis may not complete since the `autobuild` step will only execute one of the commands. The solution is to replace the `autobuild` step with build steps which build all of the source code which you wish to analyze. For more information, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." + +### Error: "Server error" + +If the run of a workflow for {% data variables.product.prodname_code_scanning %} fails due to a server error, try running the workflow again. If the problem persists, contact {% data variables.contact.contact_support %}. + +### Error: "Out of disk" or "Out of memory" +On very large projects, + +{% data variables.product.prodname_codeql %} may run out of disk or memory on the runner. +{% if currentVersion == "free-pro-team@latest" %}If you encounter this issue on a hosted {% data variables.product.prodname_actions %} runner, contact {% data variables.contact.contact_support %} so that we can investigate the problem. +{% else %}If you encounter this issue, try increasing the memory on the runner.{% endif %} + +### The build takes too long + +If your build with {% data variables.product.prodname_codeql %} analysis takes too long to run, there are several approaches you can try to reduce the build time. + +#### Increase the memory or cores + +If you use self-hosted runners to run {% data variables.product.prodname_codeql %} analysis, you can increase the memory or the number of cores on those runners. + +#### Use matrix builds to parallelize the analysis + +The default {% data variables.product.prodname_codeql_workflow %} uses a build matrix of languages, which causes the analysis of each language to run in parallel. If you have specified the languages you want to analyze directly in the "Initialize CodeQL" step, analysis of each language will happen sequentially. To speed up analysis of multiple languages, modify your workflow to use a matrix. For more information, see the workflow extract in "[Automatic build for a compiled language fails](#automatic-build-for-a-compiled-language-fails)" above. + +#### Reduce the amount of code being analyzed in a single workflow + +Analysis time is typically proportional to the amount of code being analyzed. You can reduce the analysis time by reducing the amount of code being analyzed at once, for example, by excluding test code, or breaking analysis into multiple workflows that analyze only a subset of your code at a time. + +For compiled languages like Java, C, C++, and C#, {% data variables.product.prodname_codeql %} analyzes all of the code which was built during the workflow run. To limit the amount of code being analyzed, build only the code which you wish to analyze by specifying your own build steps in a `run` block. You can combine specifying your own build steps with using the `paths` or `paths-ignore` filters on the `pull_request` and `push` events to ensure that your workflow only runs when specific code is changed. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)." + +For interpreted languages like Go, JavaScript, Python, and TypeScript, that {% data variables.product.prodname_codeql %} analyzes without a specific build, you can specify additional configuration options to limit the amount of code to analyze. For more information, see "[Specifying directories to scan](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#specifying-directories-to-scan)." + +If you split your analysis into multiple workflows as described above, we still recommend that you have at least one workflow which runs on a `schedule` which analyzes all of the code in your repository. Because {% data variables.product.prodname_codeql %} analyzes data flows between components, some complex security behaviors may only be detected on a complete build. + +#### Run only during a `schedule` event + +If your analysis is still too slow to be run during `push` or `pull_request` events, then you may want to only trigger analysis on the `schedule` event. For more information, see "[Events](/actions/learn-github-actions/introduction-to-github-actions#events)." + +{% if currentVersion == "free-pro-team@latest" %} +### Results differ between analysis platforms + +If you are analyzing code written in Python, you may see different results depending on whether you run the {% data variables.product.prodname_codeql_workflow %} on Linux, macOS, or Windows. + +On GitHub-hosted runners that use Linux, the {% data variables.product.prodname_codeql_workflow %} tries to install and analyze Python dependencies, which could lead to more results. To disable the auto-install, add `setup-python-dependencies: false` to the "Initialize CodeQL" step of the workflow. For more information about configuring the analysis of Python dependencies, see "[Analyzing Python dependencies](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#analyzing-python-dependencies)." + +{% endif %} \ No newline at end of file diff --git a/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md index e5c5e43c4663..0703c0a8239c 100644 --- a/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md +++ b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md @@ -16,7 +16,7 @@ versions: ### About SARIF file uploads for {% data variables.product.prodname_code_scanning %} -{% data variables.product.prodname_dotcom %} creates {% data variables.product.prodname_code_scanning %} alerts in a repository using information from Static Analysis Results Interchange Format (SARIF) files. SARIF files can be uploaded to a repository using the API or {% data variables.product.prodname_actions %}. For more information, see "[Managing alerts from {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." +{% data variables.product.prodname_dotcom %} creates {% data variables.product.prodname_code_scanning %} alerts in a repository using information from Static Analysis Results Interchange Format (SARIF) files. SARIF files can be uploaded to a repository using the API or {% data variables.product.prodname_actions %}. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." You can generate SARIF files using many static analysis security testing tools, including {% data variables.product.prodname_codeql %}. The results must use SARIF version 2.1.0. For more information, see "[About SARIF support for {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-sarif-support-for-code-scanning)." @@ -24,12 +24,12 @@ You can upload the results using {% data variables.product.prodname_actions %}{% - {% data variables.product.prodname_actions %} to run the {% data variables.product.prodname_codeql %} action, there is no further action required. The {% data variables.product.prodname_codeql %} action uploads the SARIF file automatically when it completes analysis. - {% data variables.product.prodname_actions %} to run a SARIF-compatible analysis tool, you could update the workflow to include a final step that uploads the results (see below). -- The {% data variables.product.prodname_codeql_runner %}, to run {% data variables.product.prodname_code_scanning %} in your CI system, by default the runner automatically uploads results to {% data variables.product.prodname_dotcom %} on completion. If you block the automatic upload, when you are ready to upload results you can use the `upload` command (for more information, see "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)"). +- The {% data variables.product.prodname_codeql_runner %}, to run {% data variables.product.prodname_code_scanning %} in your CI system, by default the runner automatically uploads results to {% data variables.product.prodname_dotcom %} on completion. If you block the automatic upload, when you are ready to upload results you can use the `upload` command (for more information, see "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)"). - A tool that generates results as an artifact outside of your repository, you can use the {% data variables.product.prodname_code_scanning %} API to upload the file (for more information, see "[Upload a SARIF file](/rest/reference/code-scanning#upload-a-sarif-file)"). ### Uploading a {% data variables.product.prodname_code_scanning %} analysis with {% data variables.product.prodname_actions %} -To use {% data variables.product.prodname_actions %} to upload a third-party SARIF file to a repository, you'll need a workflow. For more information, see "[About {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)" and "[Configuring a workflow](/actions/configuring-and-managing-workflows/configuring-a-workflow)". +To use {% data variables.product.prodname_actions %} to upload a third-party SARIF file to a repository, you'll need a workflow. For more information, see "[Learn {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)" and "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." Your workflow will need to use the `upload-sarif` action, which is part of the `github/codeql-action` repository. It has input parameters that you can use to configure the upload. The main input parameter you'll use is `sarif-file`, which configures the file or directory of SARIF files to be uploaded. The directory or file path is relative to the root of the repository. For more information see the [`upload-sarif` action](https://github.com/github/codeql-action/tree/HEAD/upload-sarif). @@ -43,7 +43,7 @@ You can create a new workflow that uploads SARIF files after you commit them to This example workflow runs anytime commits are pushed to the repository. The action uses the `partialFingerprints` property to determine if changes have occurred. In addition to running when commits are pushed, the workflow is scheduled to run once per week. For more information, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows)." -This workflow uploads the `results.sarif` file located in the root of the repository. For more information about creating a workflow file, see "[Configuring a workflow](/actions/configuring-and-managing-workflows/configuring-a-workflow)." +This workflow uploads the `results.sarif` file located in the root of the repository. For more information about creating a workflow file, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." Alternatively, you could modify this workflow to upload a directory of SARIF files. For example, you could place all SARIF files in a directory in the root of your repository called `sarif-output` and set the action's input parameter `sarif_file` to `sarif-output`. @@ -73,11 +73,11 @@ jobs: #### Example workflow that runs the ESLint analysis tool -If you generate your third-party SARIF file as part of a continuous integration (CI) workflow, you can add the `upload-sarif` action as a step after running your CI tests. If you don't already have a CI workflow, you can create one using a {% data variables.product.prodname_actions %} template. For more information, see "[Starting with preconfigured workflow templates](/actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates)." +If you generate your third-party SARIF file as part of a continuous integration (CI) workflow, you can add the `upload-sarif` action as a step after running your CI tests. If you don't already have a CI workflow, you can create one using a {% data variables.product.prodname_actions %} template. For more information, see the "[{% data variables.product.prodname_actions %} quickstart](/actions/quickstart)." This example workflow runs anytime commits are pushed to the repository. The action uses the `partialFingerprints` property to determine if changes have occurred. In addition to running when commits are pushed, the workflow is scheduled to run once per week. For more information, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows)." -The workflow shows an example of running the ESLint static analysis tool as a step in a workflow. The `Run ESLint` step runs the ESLint tool and outputs the `results.sarif` file. The workflow then uploads the `results.sarif` file to {% data variables.product.prodname_dotcom %} using the `upload-sarif` action. For more information about creating a workflow file, see "[Configuring a workflow](/actions/configuring-and-managing-workflows/configuring-a-workflow)." +The workflow shows an example of running the ESLint static analysis tool as a step in a workflow. The `Run ESLint` step runs the ESLint tool and outputs the `results.sarif` file. The workflow then uploads the `results.sarif` file to {% data variables.product.prodname_dotcom %} using the `upload-sarif` action. For more information about creating a workflow file, see "[Introduction to GitHub Actions](/actions/learn-github-actions/introduction-to-github-actions)." ```yml name: "ESLint analysis" @@ -109,6 +109,6 @@ jobs: ### Дополнительная литература - "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions)" -- "[Managing a workflow run](/actions/configuring-and-managing-workflows/managing-a-workflow-run#viewing-your-workflow-history)" -- "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)" +- "[Viewing your workflow history](/actions/managing-workflow-runs/viewing-workflow-run-history)" +- "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)" - "[Upload a SARIF file](/rest/reference/code-scanning#upload-a-sarif-file)" diff --git a/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md new file mode 100644 index 000000000000..af71f4047d5b --- /dev/null +++ b/translations/ru-RU/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md @@ -0,0 +1,11 @@ +--- +title: Using CodeQL code scanning with your existing CI system +shortTitle: CodeQL CI system support +intro: 'The {% data variables.product.prodname_codeql_runner %} allows you to use your existing CI system to run {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %}.' +mapTopic: true +product: '{% data reusables.gated-features.code-scanning %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + diff --git a/translations/ru-RU/content/github/getting-started-with-github/create-a-repo.md b/translations/ru-RU/content/github/getting-started-with-github/create-a-repo.md index bb48559fd9a4..9fdce4d448e7 100644 --- a/translations/ru-RU/content/github/getting-started-with-github/create-a-repo.md +++ b/translations/ru-RU/content/github/getting-started-with-github/create-a-repo.md @@ -19,7 +19,9 @@ You can store a variety of projects in {% data variables.product.product_name %} {% 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 {% data variables.product.product_name %}." ![Field for entering a repository description](/assets/images/help/repository/create-repository-desc.png) +3. Optionally, add a description of your repository. For example, "My first repository on +{% data variables.product.product_name %}." + ![Field for entering a repository description](/assets/images/help/repository/create-repository-desc.png) {% data reusables.repositories.choose-repo-visibility %} {% data reusables.repositories.initialize-with-readme %} {% data reusables.repositories.create-repo %} diff --git a/translations/ru-RU/content/github/getting-started-with-github/fork-a-repo.md b/translations/ru-RU/content/github/getting-started-with-github/fork-a-repo.md index bcc740259ce3..acc8c8456e8e 100644 --- a/translations/ru-RU/content/github/getting-started-with-github/fork-a-repo.md +++ b/translations/ru-RU/content/github/getting-started-with-github/fork-a-repo.md @@ -61,7 +61,9 @@ If you haven't yet, you should first [set up Git](/articles/set-up-git). Don't f 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 {% data variables.product.product_name %}, navigate to **your fork** of the Spoon-Knife repository. +1. On + +{% data variables.product.product_name %}, navigate to **your fork** of the Spoon-Knife repository. {% data reusables.repositories.copy-clone-url %} {% data reusables.command_line.open_the_multi_os_terminal %} {% data reusables.command_line.change-current-directory-clone %} @@ -86,7 +88,9 @@ Now, you have a local copy of your fork of the 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 {% data variables.product.product_name %}, navigate to the [octocat/Spoon-Knife](https://github.com/octocat/Spoon-Knife) repository. +1. On + +{% data variables.product.product_name %}, navigate to the [octocat/Spoon-Knife](https://github.com/octocat/Spoon-Knife) repository. {% data reusables.repositories.copy-clone-url %} {% 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). diff --git a/translations/ru-RU/content/github/getting-started-with-github/github-for-mobile.md b/translations/ru-RU/content/github/getting-started-with-github/github-for-mobile.md index 7512a24f29f7..489cbd98383c 100644 --- a/translations/ru-RU/content/github/getting-started-with-github/github-for-mobile.md +++ b/translations/ru-RU/content/github/getting-started-with-github/github-for-mobile.md @@ -23,6 +23,16 @@ For more information about notifications for {% data variables.product.prodname_ To install {% data variables.product.prodname_mobile %} for Android or iOS, see [{% data variables.product.prodname_mobile %}](https://github.com/mobile). +### Supported languages for {% data variables.product.prodname_mobile %} + +{% data variables.product.prodname_mobile %} is available in the following languages. + +- Японский +- Brazilian Portuguese +- Испанский + +If you configure the language on your device to a supported language, {% data variables.product.prodname_mobile %} will default to the language. You can change the language for {% data variables.product.prodname_mobile %} in {% data variables.product.prodname_mobile %}'s **Settings** menu. + ### Managing Universal Links for {% data variables.product.prodname_mobile %} on iOS {% data variables.product.prodname_mobile %} automatically enables Universal Links for iOS. When you tap any {% data variables.product.product_name %} link, the destination URL will open in {% 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. diff --git a/translations/ru-RU/content/github/getting-started-with-github/githubs-products.md b/translations/ru-RU/content/github/getting-started-with-github/githubs-products.md index f379c92899bf..441315fb55b2 100644 --- a/translations/ru-RU/content/github/getting-started-with-github/githubs-products.md +++ b/translations/ru-RU/content/github/getting-started-with-github/githubs-products.md @@ -96,7 +96,7 @@ For more information about hosting your own instance of [{% data variables.produ - {% data variables.contact.github_support %} {% data variables.product.premium_plus_support_plan %} - {% data variables.product.prodname_insights %} -- {% data variables.product.prodname_advanced_security %} +- {% data variables.product.prodname_advanced_security %}{% if currentVersion == "free-pro-team@latest" %}. For more information, see "[About {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)" and "[About {% data variables.product.prodname_secret_scanning %}](/github/administering-a-repository/about-secret-scanning) (beta)."{% endif %}{% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %}. For more information, see "[About {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning) (beta)."{% endif %} - [{% data variables.product.prodname_learning %} for organizations](https://lab.github.com/organizations) For more information about signing up for {% data variables.product.prodname_ghe_one %}, contact [{% data variables.product.product_name %}'s Sales team](https://enterprise.github.com/contact). diff --git a/translations/ru-RU/content/github/getting-started-with-github/keyboard-shortcuts.md b/translations/ru-RU/content/github/getting-started-with-github/keyboard-shortcuts.md index adb8e5aacb83..72834a55d366 100644 --- a/translations/ru-RU/content/github/getting-started-with-github/keyboard-shortcuts.md +++ b/translations/ru-RU/content/github/getting-started-with-github/keyboard-shortcuts.md @@ -20,22 +20,22 @@ Below is a list of some of the available keyboard shortcuts. ### Site wide shortcuts -| Keyboard shortcut | Description | -| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| s or / | Сфокусировать панель поиска. For more information, see "[About searching on {% data variables.product.company_short %}](/articles/about-searching-on-github)." | +| Keyboard shortcut | Description | +| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| s or / | Сфокусировать панель поиска. For more information, see "[About searching on {% data variables.product.company_short %}](/articles/about-searching-on-github)." | | g n | 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 %}." | -| esc | When focused on a user, issue, or pull request hovercard, closes the hovercard and refocuses on the element the hovercard is in | +| esc | 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 | -| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | -| g c | Go to the **Code** tab | -| g i | Go to the **Issues** tab. For more information, see "[About issues](/articles/about-issues)." | -| g p | Go to the **Pull requests** tab. For more information, see "[About pull requests](/articles/about-pull-requests)." | -| g a | Go to the **Actions** tab. For more information, see "[About Actions](/actions/getting-started-with-github-actions/about-github-actions)." | -| g b | Go to the **Projects** tab. For more information, see "[About project boards](/articles/about-project-boards)." | -| g w | Go to the **Wiki** tab. For more information, see "[About wikis](/articles/about-wikis)." | +| Keyboard shortcut | Description | +| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| g c | Go to the **Code** tab | +| g i | Go to the **Issues** tab. For more information, see "[About issues](/articles/about-issues)." | +| g p | Go to the **Pull requests** tab. For more information, see "[About pull requests](/articles/about-pull-requests)."{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} +| g a | Go to the **Actions** tab. For more information, see "[About Actions](/actions/getting-started-with-github-actions/about-github-actions)."{% endif %} +| g b | Go to the **Projects** tab. For more information, see "[About project boards](/articles/about-project-boards)." | +| g w | Go to the **Wiki** tab. For more information, see "[About wikis](/articles/about-wikis)." | ### Source code editing @@ -67,16 +67,16 @@ For more keyboard shortcuts, see the [CodeMirror documentation](https://codemirr ### Комментарии -| Keyboard shortcut | Description | -| --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| control b or command b | Inserts Markdown formatting for bolding text | -| control i or command i | Inserts Markdown formatting for italicizing text | -| control k or command k | Inserts Markdown formatting for creating a link | -| control shift p or command shift p | Toggles between the **Write** and **Preview** comment tabs | -| control enter | Submits a comment | +| Keyboard shortcut | Description | +| --------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| control b or command b | Inserts Markdown formatting for bolding text | +| control i or command i | Inserts Markdown formatting for italicizing text | +| control k or command k | Inserts Markdown formatting for creating a link | +| control shift p or command shift p | Toggles between the **Write** and **Preview** comment tabs | +| control enter | Submits a comment | | control . and then control [saved reply number] | 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" %} | control g or command g | Insert a suggestion. For more information, see "[Reviewing proposed changes in a pull request](/articles/reviewing-proposed-changes-in-a-pull-request)." |{% endif %} -| r | Quote the selected text in your reply. For more information, see "[Basic writing and formatting syntax](/articles/basic-writing-and-formatting-syntax#quoting-text)." | +| r | 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 @@ -92,13 +92,13 @@ For more keyboard shortcuts, see the [CodeMirror documentation](https://codemirr | o or enter | Open issue | ### Issues and pull requests -| Keyboard shortcut | Description | -| ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| q | Request a reviewer. For more information, see "[Requesting a pull request review](/articles/requesting-a-pull-request-review/)." | -| m | Set a milestone. For more information, see "[Associating milestones with issues and pull requests](/articles/associating-milestones-with-issues-and-pull-requests/)." | -| l | Apply a label. For more information, see "[Applying labels to issues and pull requests](/articles/applying-labels-to-issues-and-pull-requests/)." | +| Keyboard shortcut | Description | +| ------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| q | Request a reviewer. For more information, see "[Requesting a pull request review](/articles/requesting-a-pull-request-review/)." | +| m | Set a milestone. For more information, see "[Associating milestones with issues and pull requests](/articles/associating-milestones-with-issues-and-pull-requests/)." | +| l | Apply a label. For more information, see "[Applying labels to issues and pull requests](/articles/applying-labels-to-issues-and-pull-requests/)." | | a | Set an assignee. For more information, see "[Assigning issues and pull requests to other {% data variables.product.company_short %} users](/articles/assigning-issues-and-pull-requests-to-other-github-users/)." | -| cmd + shift + p or control + shift + p | Toggles between the **Write** and **Preview** tabs | +| cmd + shift + p or control + shift + p | Toggles between the **Write** and **Preview** tabs | ### Changes in pull requests @@ -178,7 +178,7 @@ For more keyboard shortcuts, see the [CodeMirror documentation](https://codemirr | shift m | Mute thread | {% endif %} -### Сетевой график +### Сетевая диаграмма | Keyboard shortcut | Description | | ---------------------------------------- | ------------------------ | diff --git a/translations/ru-RU/content/github/getting-started-with-github/saving-repositories-with-stars.md b/translations/ru-RU/content/github/getting-started-with-github/saving-repositories-with-stars.md index f0400a7c4c62..b1dc6a93e5e3 100644 --- a/translations/ru-RU/content/github/getting-started-with-github/saving-repositories-with-stars.md +++ b/translations/ru-RU/content/github/getting-started-with-github/saving-repositories-with-stars.md @@ -19,7 +19,8 @@ You can search, sort, and filter your starred repositories and topics on your {% 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 {% data variables.explore.your_stars_page %}. {% if currentVersion == "free-pro-team@latest" %} -You can star repositories and topics to discover similar projects on {% data variables.product.product_name %}. When you star repositories or topics, {% 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 {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)." +You can star repositories and topics to discover similar projects on +{% data variables.product.product_name %}. When you star repositories or topics, {% 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 {% 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 {% 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. diff --git a/translations/ru-RU/content/github/getting-started-with-github/types-of-github-accounts.md b/translations/ru-RU/content/github/getting-started-with-github/types-of-github-accounts.md index 51629050193d..80d1c9badf74 100644 --- a/translations/ru-RU/content/github/getting-started-with-github/types-of-github-accounts.md +++ b/translations/ru-RU/content/github/getting-started-with-github/types-of-github-accounts.md @@ -13,7 +13,8 @@ versions: --- {% if currentVersion == "free-pro-team@latest" %} -For a full list of features for each {% data variables.product.product_name %} product, see "[{% data variables.product.prodname_dotcom %}'s products](/github/getting-started-with-github/githubs-products)." +For a full list of features for each +{% data variables.product.product_name %} product, see "[{% data variables.product.prodname_dotcom %}'s products](/github/getting-started-with-github/githubs-products)." {% endif %} ### Personal user accounts diff --git a/translations/ru-RU/content/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line.md b/translations/ru-RU/content/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line.md index 62fdcb8e7c6a..cb6f6ab13211 100644 --- a/translations/ru-RU/content/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line.md +++ b/translations/ru-RU/content/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line.md @@ -21,7 +21,10 @@ versions: {% mac %} -1. [Create a new repository](/articles/creating-a-new-repository) on {% data variables.product.product_location %}. To avoid errors, do not initialize the new repository with *README*, license, or `gitignore` files. You can add these files after your project has been pushed to {% data variables.product.product_name %}. ![Create New Repository drop-down](/assets/images/help/repository/repo-create.png) +1. [Create a new repository](/articles/creating-a-new-repository) on + +{% data variables.product.product_location %}. To avoid errors, do not initialize the new repository with *README*, license, or `gitignore` files. You can add these files after your project has been pushed to {% data variables.product.product_name %}. + ![Create New Repository drop-down](/assets/images/help/repository/repo-create.png) {% data reusables.command_line.open_the_multi_os_terminal %} 3. Change the current working directory to your local project. 4. Initialize the local directory as a Git repository. @@ -48,7 +51,7 @@ versions: ``` 9. [Push the changes](/articles/pushing-commits-to-a-remote-repository/) in your local repository to {% data variables.product.product_location %}. ```shell - $ git push -u origin master + $ git push -u origin main # Pushes the changes in your local repository up to the remote repository you specified as the origin ``` @@ -56,7 +59,10 @@ versions: {% windows %} -1. [Create a new repository](/articles/creating-a-new-repository) on {% data variables.product.product_location %}. To avoid errors, do not initialize the new repository with *README*, license, or `gitignore` files. You can add these files after your project has been pushed to {% data variables.product.product_name %}. ![Create New Repository drop-down](/assets/images/help/repository/repo-create.png) +1. [Create a new repository](/articles/creating-a-new-repository) on + +{% data variables.product.product_location %}. To avoid errors, do not initialize the new repository with *README*, license, or `gitignore` files. You can add these files after your project has been pushed to {% data variables.product.product_name %}. + ![Create New Repository drop-down](/assets/images/help/repository/repo-create.png) {% data reusables.command_line.open_the_multi_os_terminal %} 3. Change the current working directory to your local project. 4. Initialize the local directory as a Git repository. @@ -83,7 +89,7 @@ versions: ``` 9. [Push the changes](/articles/pushing-commits-to-a-remote-repository/) in your local repository to {% data variables.product.product_location %}. ```shell - $ git push origin master + $ git push origin main # Pushes the changes in your local repository up to the remote repository you specified as the origin ``` @@ -91,7 +97,10 @@ versions: {% linux %} -1. [Create a new repository](/articles/creating-a-new-repository) on {% data variables.product.product_location %}. To avoid errors, do not initialize the new repository with *README*, license, or `gitignore` files. You can add these files after your project has been pushed to {% data variables.product.product_name %}. ![Create New Repository drop-down](/assets/images/help/repository/repo-create.png) +1. [Create a new repository](/articles/creating-a-new-repository) on + +{% data variables.product.product_location %}. To avoid errors, do not initialize the new repository with *README*, license, or `gitignore` files. You can add these files after your project has been pushed to {% data variables.product.product_name %}. + ![Create New Repository drop-down](/assets/images/help/repository/repo-create.png) {% data reusables.command_line.open_the_multi_os_terminal %} 3. Change the current working directory to your local project. 4. Initialize the local directory as a Git repository. @@ -118,7 +127,7 @@ versions: ``` 9. [Push the changes](/articles/pushing-commits-to-a-remote-repository/) in your local repository to {% data variables.product.product_location %}. ```shell - $ git push origin master + $ git push origin main # Pushes the changes in your local repository up to the remote repository you specified as the origin ``` diff --git a/translations/ru-RU/content/github/importing-your-projects-to-github/what-are-the-differences-between-subversion-and-git.md b/translations/ru-RU/content/github/importing-your-projects-to-github/what-are-the-differences-between-subversion-and-git.md index 54f0e7b8a1bb..d5e338dececf 100644 --- a/translations/ru-RU/content/github/importing-your-projects-to-github/what-are-the-differences-between-subversion-and-git.md +++ b/translations/ru-RU/content/github/importing-your-projects-to-github/what-are-the-differences-between-subversion-and-git.md @@ -35,9 +35,9 @@ Git projects are also stored within a single directory. However, Git obscures th A Git workflow looks like this: * A Git repository stores the full history of all of its branches and tags within the *.git* directory. -* The latest stable release is contained within the `master` branch. +* The latest stable release is contained within the default branch. * Active feature work is developed in separate branches. -* When a feature is finished, the feature branch is merged into `master` and deleted. +* When a feature is finished, the feature branch is merged into the default branch and deleted. Unlike SVN, with Git the directory structure remains the same, but the contents of the files change based on your branch. diff --git a/translations/ru-RU/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md b/translations/ru-RU/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md index bbd1e6857467..422b65027111 100644 --- a/translations/ru-RU/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md +++ b/translations/ru-RU/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md @@ -19,7 +19,9 @@ versions: {% data reusables.repositories.sensitive-info-warning %} -1. On your computer, move the file you'd like to upload to {% data variables.product.product_name %} into the local directory that was created when you cloned the repository. +1. On your computer, move the file you'd like to upload to + +{% data variables.product.product_name %} into the local directory that was created when you cloned the repository. {% data reusables.command_line.open_the_multi_os_terminal %} {% data reusables.command_line.switching_directories_procedural %} {% data reusables.git.stage_for_commit %} diff --git a/translations/ru-RU/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md b/translations/ru-RU/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md index f98baa9f5a9e..5b9f7ed7c341 100644 --- a/translations/ru-RU/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md +++ b/translations/ru-RU/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md @@ -20,7 +20,7 @@ versions: When viewing a file on {% data variables.product.product_location %}, you usually see the version at the current head of a branch. Например: -* [https://github.com/github/hubot/blob/**master**/README.md](https://github.com/github/hubot/blob/master/README.md) +* [https://github.com/github/hubot/blob/**master**/README.md](https://github.com/github/codeql/blob/main/README.md) refers to GitHub's `hubot` repository, and shows the `master` branch's current version of the `README.md` file. @@ -30,7 +30,7 @@ The version of a file at the head of branch can change as new commits are made, For a permanent link to the specific version of a file that you see, instead of using a branch name in the URL (i.e. the `master` part in the example above), put a commit id. This will permanently link to the exact version of the file in that commit. Например: -* [https://github.com/github/hubot/blob/**ed25584f5ac2520a6c28547ffd0961c7abd7ea49**/README.md](https://github.com/github/hubot/blob/ed25584f5ac2520a6c28547ffd0961c7abd7ea49/README.md) +* [https://github.com/github/hubot/blob/**ed25584f5ac2520a6c28547ffd0961c7abd7ea49**/README.md](https://github.com/github/codeql/blob/b212af08a6cffbb434f3c8a2795a579e092792fd/README.md) replaces `master` with a specific commit id and the file content will not change. diff --git a/translations/ru-RU/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md b/translations/ru-RU/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md index 8e875216d194..79f98ccc5745 100644 --- a/translations/ru-RU/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md +++ b/translations/ru-RU/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md @@ -9,9 +9,9 @@ versions: --- -The interactive features of the notebook, such as custom JavaScript plots, will not work in your repository on {% data variables.product.product_location %}. For an example, see [*Linking and Interactions.ipynb*](https://github.com/bokeh/bokeh-notebooks/blob/master/tutorial/06%20-%20Linking%20and%20Interactions.ipynb). +The interactive features of the notebook, such as custom JavaScript plots, will not work in your repository on {% data variables.product.product_location %}. For an example, see [*Linking and Interactions.ipynb*](https://github.com/bokeh/bokeh-notebooks/blob/main/tutorial/06%20-%20Linking%20and%20Interactions.ipynb). -To view your Jupyter notebook with JavaScript content rendered or to share your notebook files with others you can use [nbviewer](https://nbviewer.jupyter.org/). For an example, see [*Linking and Interactions.ipynb*](https://nbviewer.jupyter.org/github/bokeh/bokeh-notebooks/blob/master/tutorial/06%20-%20Linking%20and%20Interactions.ipynb) rendered on nbviewer. +To view your Jupyter notebook with JavaScript content rendered or to share your notebook files with others you can use [nbviewer](https://nbviewer.jupyter.org/). For an example, see [*Linking and Interactions.ipynb*](https://nbviewer.jupyter.org/github/bokeh/bokeh-notebooks/blob/main/tutorial/06%20-%20Linking%20and%20Interactions.ipynb) rendered on nbviewer. To view a fully interactive version of your Jupyter Notebook, you can set up a notebook server locally. For more information, see [Jupyter's official documentation](http://jupyter.readthedocs.io/en/latest/index.html). diff --git a/translations/ru-RU/content/github/managing-large-files/about-git-large-file-storage.md b/translations/ru-RU/content/github/managing-large-files/about-git-large-file-storage.md index 1b95ce148a70..5c6faf340933 100644 --- a/translations/ru-RU/content/github/managing-large-files/about-git-large-file-storage.md +++ b/translations/ru-RU/content/github/managing-large-files/about-git-large-file-storage.md @@ -12,16 +12,17 @@ versions: {% data variables.large_files.product_name_short %} handles large files by storing references to the file in the repository, but not the actual file itself. To work around Git's architecture, {% data variables.large_files.product_name_short %} creates a pointer file which acts as a reference to the actual file (which is stored somewhere else). {% data variables.product.product_name %} manages this pointer file in your repository. When you clone the repository down, {% data variables.product.product_name %} uses the pointer file as a map to go and find the large file for you. {% if currentVersion == "free-pro-team@latest" %} -Using {% data variables.large_files.product_name_short %}, you can store files up to: +Using +{% data variables.large_files.product_name_short %}, you can store files up to: -| Product | Maximum file size | -| ------------------------------------------------------ | ----------------- | +| Product | Maximum file size | +| ------------------------------------------------- | ----------------- | | {% data variables.product.prodname_free_user %} | 2 GB | | {% data variables.product.prodname_pro %} | 2 GB | | {% data variables.product.prodname_team %} | 4 GB | | {% data variables.product.prodname_ghe_cloud %} | 5 GB |{% else %} - Using {% data variables.large_files.product_name_short %}, you can store files up to -{% if currentVersion ver_lt "enterprise-server@2.21" %}{% data variables.large_files.max_lfs_size %}{% else %}5 GB{% endif %} in your repository. + Using +{% data variables.large_files.product_name_short %}, you can store files up to {% if currentVersion ver_lt "enterprise-server@2.21" %}{% data variables.large_files.max_lfs_size %}{% else %}5 GB{% endif %} in your repository. {% endif %} You can also use {% data variables.large_files.product_name_short %} with {% data variables.product.prodname_desktop %}. For more information about cloning Git LFS repositories in {% data variables.product.prodname_desktop %}, see "[Cloning a repository from GitHub to GitHub Desktop](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop)." diff --git a/translations/ru-RU/content/github/managing-large-files/about-storage-and-bandwidth-usage.md b/translations/ru-RU/content/github/managing-large-files/about-storage-and-bandwidth-usage.md index 4a3dd5034841..3535b453221a 100644 --- a/translations/ru-RU/content/github/managing-large-files/about-storage-and-bandwidth-usage.md +++ b/translations/ru-RU/content/github/managing-large-files/about-storage-and-bandwidth-usage.md @@ -20,7 +20,8 @@ When you commit and push a change to a file tracked with {% data variables.large - If you download a 500 MB file that's tracked with LFS, you'll use 500 MB of the repository owner's allotted bandwidth. If a collaborator pushes a change to the file and you pull the new version to your local repository, you'll use another 500 MB of bandwidth, bringing the total usage for these two downloads to 1 GB of bandwidth. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -If {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in source code archives for your repository, downloads of those archives will count towards bandwidth usage for the repository. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)." +If +{% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in source code archives for your repository, downloads of those archives will count towards bandwidth usage for the repository. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)." {% endif %} {% tip %} diff --git a/translations/ru-RU/content/github/managing-large-files/configuring-git-large-file-storage.md b/translations/ru-RU/content/github/managing-large-files/configuring-git-large-file-storage.md index 4330ba88866e..98a2e5aa9474 100644 --- a/translations/ru-RU/content/github/managing-large-files/configuring-git-large-file-storage.md +++ b/translations/ru-RU/content/github/managing-large-files/configuring-git-large-file-storage.md @@ -47,7 +47,7 @@ If there are existing files in your repository that you'd like to use {% data va 5. Commit the file and push it to {% data variables.product.product_name %}: ```shell $ git commit -m "add file.psd" - $ git push origin master + $ git push ``` You should see some diagnostic information about your file upload: ```shell diff --git a/translations/ru-RU/content/github/managing-large-files/installing-git-large-file-storage.md b/translations/ru-RU/content/github/managing-large-files/installing-git-large-file-storage.md index 360a49a24fca..16de55d43252 100644 --- a/translations/ru-RU/content/github/managing-large-files/installing-git-large-file-storage.md +++ b/translations/ru-RU/content/github/managing-large-files/installing-git-large-file-storage.md @@ -57,7 +57,8 @@ versions: {% endtip %} 2. On your computer, locate the downloaded file. -3. Double click on the file called *git-lfs-windows-1.X.X.exe*, where 1.X.X is replaced with the Git LFS version you downloaded. When you open this file Windows will run a setup wizard to install {% data variables.large_files.product_name_short %}. +3. Double click on the file called *git-lfs-windows-1.X.X.exe*, where 1.X.X is replaced with the Git LFS version you downloaded. When you open this file Windows will run a setup wizard to install +{% data variables.large_files.product_name_short %}. {% data reusables.command_line.open_the_multi_os_terminal %} 5. Verify that the installation was successful: ```shell diff --git a/translations/ru-RU/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md b/translations/ru-RU/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md index 636c1653a5ba..ef000d815b36 100644 --- a/translations/ru-RU/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md +++ b/translations/ru-RU/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md @@ -49,12 +49,13 @@ You can also enable or disable {% data variables.product.prodname_dependabot %} {% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -When {% data variables.product.product_name %} identifies a vulnerable dependency, we send a {% data variables.product.prodname_dependabot_short %} alert to the maintainers of affected repositories with details of the vulnerability, a link to the affected file in the project, and information about a fixed version. -{% if currentVersion == "free-pro-team@latest" %}For repositories that have enabled {% data variables.product.prodname_dependabot_security_updates %}, the alert also contains a link to a pull request to update the manifest or lock file to the minimum version that resolves the vulnerability. For more information, see "[Configuring {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)."{% endif %} +When +{% data variables.product.product_name %} identifies a vulnerable dependency, we send a {% data variables.product.prodname_dependabot_short %} alert to the maintainers of affected repositories with details of the vulnerability, a link to the affected file in the project, and information about a fixed version. {% if currentVersion == "free-pro-team@latest" %}For repositories that have enabled {% data variables.product.prodname_dependabot_security_updates %}, the alert also contains a link to a pull request to update the manifest or lock file to the minimum version that resolves the vulnerability. For more information, see "[Configuring {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)."{% endif %} {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %} -When {% data variables.product.product_name %} identifies a vulnerable dependency, we send a security alert to the maintainers of affected repositories with details of the vulnerability, a link to the affected file in the project, and information about a fixed version. +When +{% data variables.product.product_name %} identifies a vulnerable dependency, we send a security alert to the maintainers of affected repositories with details of the vulnerability, a link to the affected file in the project, and information about a fixed version. {% endif %} {% warning %} @@ -68,30 +69,35 @@ When {% data variables.product.product_name %} identifies a vulnerable dependenc You can see all of the alerts that affect a particular project{% if currentVersion == "free-pro-team@latest" %} on the repository's Security tab or{% endif %} in the repository's dependency graph.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[Viewing and updating vulnerable dependencies in your repository](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository)."{% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -We send {% data variables.product.prodname_dependabot_short %} alerts to people with admin permissions in the affected repositories by default. {% data variables.product.product_name %} never publicly discloses identified vulnerabilities for any repository. -{% if currentVersion == "free-pro-team@latest" %} You can also enable {% data variables.product.prodname_dependabot_short %} alerts for additional people or teams working repositories that you own or have admin permissions for. For more information, see "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-github-dependabot-alerts)."{% endif %} +We send +{% data variables.product.prodname_dependabot_short %} alerts to people with admin permissions in the affected repositories by default. {% data variables.product.product_name %} never publicly discloses identified vulnerabilities for any repository.{% if currentVersion == "free-pro-team@latest" %} You can also enable {% data variables.product.prodname_dependabot_short %} alerts for additional people or teams working repositories that you own or have admin permissions for. For more information, see "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-github-dependabot-alerts)."{% endif %} {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %} -We send security alerts to people with admin permissions in the affected repositories by default. {% data variables.product.product_name %} never publicly discloses identified vulnerabilities for any repository. +We send security alerts to people with admin permissions in the affected repositories by default. +{% data variables.product.product_name %} never publicly discloses identified vulnerabilities for any repository. {% endif %} ### Configuring notifications for {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} {% if currentVersion == "free-pro-team@latest" %} -By default, you will receive {% data variables.product.prodname_dependabot_alerts %} by email, grouped by the specific vulnerability. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-options)." +By default, you will receive +{% data variables.product.prodname_dependabot_alerts %} by email, grouped by the specific vulnerability. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-notification-options)." {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %} -By default, if your site administrator has configured email for notifications on your instance, you will receive {% data variables.product.prodname_dependabot_alerts %} by email. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-options)." +By default, if your site administrator has configured email for notifications on your instance, you will receive +{% data variables.product.prodname_dependabot_alerts %} by email. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-notification-options)." {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion == "enterprise-server@2.21" %} -By default, if your site administrator has configured email for notifications on your instance, you will receive security alerts by email. You can also choose to receive security alerts in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#security-alert-options)." +By default, if your site administrator has configured email for notifications on your instance, you will receive security alerts by email. You can also choose to receive security alerts in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the +{% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#security-alert-notification-options)." {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.21" %} -By default, if your site administrator has configured email for notifications on your instance, you will receive security alerts by email. You can also choose to receive security alerts in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Choosing the delivery method for your notifications ](/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications)." +By default, if your site administrator has configured email for notifications on your instance, you will receive security alerts by email. You can also choose to receive security alerts in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the +{% data variables.product.product_name %} user interface. For more information, see "[Choosing the delivery method for your notifications ](/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications)." {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.20" % %} diff --git a/translations/ru-RU/content/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates.md b/translations/ru-RU/content/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates.md index f0369cb6c862..38e4b01eae4c 100644 --- a/translations/ru-RU/content/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates.md +++ b/translations/ru-RU/content/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates.md @@ -23,7 +23,7 @@ When you merge a pull request that contains a security update, the corresponding {% note %} -**Note** +**Примечание** {% data variables.product.prodname_dependabot_security_updates %} only resolve security vulnerabilities in the dependencies tracked by your dependency graph. Security updates are not created to resolve vulnerabilities in private registries or packages hosted in private repositories. However, indirect or transitive dependencies are included if they are explicitly defined in a lock file, or similar. For more information, see "[About the dependency graph](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)." Additionally, it's important to highlight that {% data variables.product.prodname_dependabot_security_updates %} automatically create pulls requests with proposed fixes to the lock files, for the dependencies detected as vulnerable. {% endnote %} @@ -42,14 +42,14 @@ You can enable {% data variables.product.prodname_dependabot_security_updates %} {% endnote %} -| Automatic enablement prerequisite | More information | -| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Repository is not a fork | "[About forks](/github/collaborating-with-issues-and-pull-requests/about-forks)" | -| Repository is not archived | "[Archiving repositories](/github/creating-cloning-and-archiving-repositories/archiving-repositories)" | +| Automatic enablement prerequisite | More information | +| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Repository is not a fork | "[About forks](/github/collaborating-with-issues-and-pull-requests/about-forks)" | +| Repository is not archived | "[Archiving repositories](/github/creating-cloning-and-archiving-repositories/archiving-repositories)" | | Repository is public, or repository is private and you have enabled read-only analysis by {% data variables.product.prodname_dotcom %}, dependency graph, and vulnerability alerts in the repository's settings | "[Managing data use settings for your private repository](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository)." | | Repository contains dependency manifest file from a package ecosystem that {% data variables.product.prodname_dotcom %} supports | "[Supported package ecosystems](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph#supported-package-ecosystems)" | -| {% data variables.product.prodname_dependabot_security_updates %} are not disabled for the repository | "[Managing {% data variables.product.prodname_dependabot_security_updates %} for your repository](#managing-github-dependabot-security-updates-for-your-repositories)" | -| Repository is not already using an integration for dependency management | "[About integrations](/github/customizing-your-github-workflow/about-integrations)" | +| {% data variables.product.prodname_dependabot_security_updates %} are not disabled for the repository | "[Managing {% data variables.product.prodname_dependabot_security_updates %} for your repository](#managing-github-dependabot-security-updates-for-your-repositories)" | +| Repository is not already using an integration for dependency management | "[About integrations](/github/customizing-your-github-workflow/about-integrations)" | If security updates are not enabled for your repository and you don't know why, first try enabling them using the instructions given in the procedural sections below. If security updates are still not working, you can [contact support](https://support.github.com/contact). diff --git a/translations/ru-RU/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md b/translations/ru-RU/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md index 217afbb26ed9..f8d2be9fcb00 100644 --- a/translations/ru-RU/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md +++ b/translations/ru-RU/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md @@ -53,7 +53,8 @@ To keep your subscriptions manageable, review your subscriptions and watched rep To customize how you'd like to receive updates for specific pull requests or issues, you can configure your preferences within the issue or pull request. For more information, see “[Triaging a single notification](/github/managing-subscriptions-and-notifications-on-github/triaging-a-single-notification#customizing-when-to-receive-future-updates-for-an-issue-or-pull-request).” {% if currentVersion == "free-pro-team@latest" %} -You can enable push notifications in the {% data variables.product.prodname_mobile %} app. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#enabling-push-notifications-with-github-for-mobile)." +You can enable push notifications in the +{% data variables.product.prodname_mobile %} app. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#enabling-push-notifications-with-github-for-mobile)." {% endif %} ### Reasons for receiving notifications diff --git a/translations/ru-RU/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md b/translations/ru-RU/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md index aed79d10d0c5..1e1e1ce0b257 100644 --- a/translations/ru-RU/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md +++ b/translations/ru-RU/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md @@ -44,7 +44,8 @@ The notifications inbox on {% data variables.product.product_name %}{% if curren - Group notifications in your inbox by repository or date to get a quick overview with less context switching {% if currentVersion == "free-pro-team@latest" %} -In addition, the notifications inbox on {% data variables.product.prodname_mobile %} allows you to triage notifications in dark mode and receive push notifications for direct mentions. For more information, see "[Enabling push notifications with GitHub for mobile](#enabling-push-notifications-with-github-for-mobile)" or "[GitHub for mobile](/github/getting-started-with-github/github-for-mobile)." +In addition, the notifications inbox on +{% data variables.product.prodname_mobile %} allows you to triage notifications in dark mode and receive push notifications for direct mentions. For more information, see "[Enabling push notifications with GitHub for mobile](#enabling-push-notifications-with-github-for-mobile)" or "[GitHub for mobile](/github/getting-started-with-github/github-for-mobile)." {% endif %} #### Benefits of using an email client for notifications @@ -105,10 +106,10 @@ If you believe you're receiving notifications that don't belong to you, examine Email notifications from {% data variables.product.product_name %} contain the following header information: -| Header | Information | -| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `From` address | This address will always be {% if currentVersion == "free-pro-team@latest" %}'`notifications@github.com`'{% else %}'the no-reply email address configured by your site administrator'{% endif %}. | -| `To` field | This field connects directly to the thread. If you reply to the email, you'll add a new comment to the conversation. | +| Header | Information | +| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `From` address | This address will always be {% if currentVersion == "free-pro-team@latest" %}'`notifications@github.com`'{% else %}'the no-reply email address configured by your site administrator'{% endif %}. | +| `To` field | This field connects directly to the thread. If you reply to the email, you'll add a new comment to the conversation. | | `Cc` address | {% data variables.product.product_name %} will `Cc` you if you're subscribed to a conversation. The second `Cc` email address matches the notification reason. The suffix for these notification reasons is {% data variables.notifications.cc_address %}. The possible notification reasons are:
    • `assign`: You were assigned to an issue or pull request.
    • `author`: You created an issue or pull request.
    • `comment`: You commented on an issue or pull request.
    • `manual`: There was an update to an issue or pull request you manually subscribed to.
    • `mention`: You were mentioned on an issue or pull request.
    • `push`: Someone committed to a pull request you're subscribed to.
    • `review_requested`: You or a team you're a member of was requested to review a pull request.
    • `security_alert`: {% data variables.product.prodname_dotcom %} detected a vulnerability in a repository you receive alerts for.
    • `state_change`: An issue or pull request you're subscribed to was either closed or opened.
    • `subscribed`: There was an update in a repository you're watching.
    • `team_mention`: A team you belong to was mentioned on an issue or pull request.
    • `your_activity`: You opened, commented on, or closed an issue or pull request.
    | | `mailing list` field | This field identifies the name of the repository and its owner. The format of this address is always `..{% data variables.command_line.backticks %}`. |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" % %} | `X-GitHub-Severity` field | {% data reusables.repositories.security-alerts-x-github-severity %} The possible severity levels are:
    • `low`
    • `moderate`
    • `high`
    • `critical`
    For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." |{% endif %} @@ -120,8 +121,8 @@ Email notifications from {% data variables.product.product_name %} contain the f 3. On the notifications settings page, choose how you receive notifications when: - There are updates in repositories or team discussions you're watching or in a conversation you're participating in. For more information, see "[About participating and watching notifications](#about-participating-and-watching-notifications)." - You gain access to a new repository or you've joined a new team. For more information, see "[Automatic watching](#automatic-watching)."{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} - - There are new {% data variables.product.prodname_dependabot_alerts %} in your repository. For more information, see "[{% data variables.product.prodname_dependabot_alerts %} options](#github-dependabot-alerts-options)." {% endif %}{% if currentVersion == "enterprise-server@2.21" %} - - There are new security alerts in your repository. For more information, see "[Security alert options](#security-alert-options)." {% endif %} {% if currentVersion == "free-pro-team@latest" %} + - There are new {% data variables.product.prodname_dependabot_alerts %} in your repository. For more information, see "[{% data variables.product.prodname_dependabot_alerts %} notification options](#github-dependabot-alerts-notification-options)." {% endif %}{% if currentVersion == "enterprise-server@2.21" %} + - There are new security alerts in your repository. For more information, see "[Security alert notification options](#security-alert-notification-options)." {% endif %} {% if currentVersion == "free-pro-team@latest" %} - There are workflow runs updates on repositories set up with {% data variables.product.prodname_actions %}. For more information, see "[{% data variables.product.prodname_actions %} notification options](#github-actions-notification-options)."{% endif %} ### Automatic watching @@ -157,9 +158,9 @@ If you are a member of more than one organization, you can configure each one to ![Switching your per-org email address](/assets/images/help/notifications/notifications_switching_org_email.gif) {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -### {% data variables.product.prodname_dependabot_alerts %} options +### {% data variables.product.prodname_dependabot_alerts %} notification options {% else %} -### Security alert options +### Security alert notification options {% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}Choose how you want to receive {% data variables.product.prodname_dependabot_alerts %} for repositories that you are watching. You can receive {% data variables.product.prodname_dependabot_alerts %} in your inbox, as a banner on {% data variables.product.product_name %}, on the command line, through email, or some combination of these options. @@ -176,6 +177,12 @@ If you want to receive security alerts by email, choose whether you want a weekl ![Security alerts options](/assets/images/help/notifications-v2/security-alerts-options.png) {% endif %} +{% note %} + +**Note:** You can filter your {% data variables.product.company_short %} inbox notifications by {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %} security{% endif %} alerts. For more information, see "[Managing notifications from your inbox](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox#supported-queries-for-custom-filters)." + +{% endnote %} + {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} ### {% data variables.product.prodname_actions %} notification options diff --git a/translations/ru-RU/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md b/translations/ru-RU/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md index 6dbae09c71af..ae12036c073a 100644 --- a/translations/ru-RU/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md +++ b/translations/ru-RU/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md @@ -19,7 +19,6 @@ To access your notifications inbox, in the upper-right corner of any page, click ![Notification indicating any unread message](/assets/images/help/notifications/notifications_general_existence_indicator.png) - Your inbox shows all of the notifications that you haven't unsubscribed to or marked as **Done.** You can customize your inbox to best suit your workflow using filters, viewing all or just unread notifications, and grouping your notifications to get a quick overview. ![inbox view](/assets/images/help/notifications-v2/inbox-view.png) diff --git a/translations/ru-RU/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md b/translations/ru-RU/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md index 839062f1dc7a..d9cdb01a0c87 100644 --- a/translations/ru-RU/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md +++ b/translations/ru-RU/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md @@ -22,15 +22,15 @@ If you create an invalid URL using query parameters, or if you don’t have the ### Supported query parameters -| Query parameter | Пример | -| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `тело` | `https://github.com/octo-org/octo-repo/compare/master...pull-request-test?quick_pull=1&body=Fixes+the+problem.` creates a pull request, comparing the branches `master` and `pull-request-test`, with the comment "Fixes the problem" in the pull request body. | -| `title` | `https://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report` creates an issue with the label "bug" and title "New bug report." | -| `labels` | `https://github.com/octo-org/octo-repo/compare/master...pull-request-test?quick_pull=1&labels=bug` creates a pull request, comparing the branches `master` and `pull-request-test`, with the label "bug." | -| `шаблон` | `https://github.com/octo-org/octo-repo/issues/new?template=issue_template.md` creates an issue with a template in the issue body. | -| `контрольная точка` | `https://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones` creates an issue with the milestone "testing milestones." | -| `assignees` | `https://github.com/octo-org/octo-repo/issues/new?assignees=octocat` creates an issue and assigns it to @octocat. | -| `projects` | `https://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1` creates an issue with the title "Bug fix" and adds it to the organization's project board 1. | +| Query parameter | Пример | +| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `тело` | `https://github.com/octo-org/octo-repo/compare/main...pull-request-test?quick_pull=1&body=Fixes+the+problem.` creates a pull request, comparing the branches `main` and `pull-request-test`, with the comment "Fixes the problem" in the pull request body. | +| `title` | `https://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report` creates an issue with the label "bug" and title "New bug report." | +| `labels` | `https://github.com/octo-org/octo-repo/compare/main...pull-request-test?quick_pull=1&labels=bug` creates a pull request, comparing the branches `main` and `pull-request-test`, with the label "bug." | +| `шаблон` | `https://github.com/octo-org/octo-repo/issues/new?template=issue_template.md` creates an issue with a template in the issue body. | +| `контрольная точка` | `https://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones` creates an issue with the milestone "testing milestones." | +| `assignees` | `https://github.com/octo-org/octo-repo/issues/new?assignees=octocat` creates an issue and assigns it to @octocat. | +| `projects` | `https://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1` creates an issue with the title "Bug fix" and adds it to the organization's project board 1. | ### Filling issues and pull requests with custom templates diff --git a/translations/ru-RU/content/github/managing-your-work-on-github/about-issues.md b/translations/ru-RU/content/github/managing-your-work-on-github/about-issues.md index 3671d8676ab0..4aeea8b7f527 100644 --- a/translations/ru-RU/content/github/managing-your-work-on-github/about-issues.md +++ b/translations/ru-RU/content/github/managing-your-work-on-github/about-issues.md @@ -22,8 +22,8 @@ To quickly find links to recently updated issues you're subscribed to, visit you With issues, you can: - Track and prioritize your work using project boards. For more information, see "[Using project boards](/articles/about-project-boards)." - Create new issues to track out-of-scope feedback from a comment in an issue or a pull request review. For more information, see "[Opening an issue from a comment](/github/managing-your-work-on-github/opening-an-issue-from-a-comment)." -- Create issue templates to help contributors open meaningful issues. For more information, see "[About issue and pull request templates](/articles/about-issue-and-pull-request-templates)."{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -- Transfer open issues to other repositories. For more information, see "[Transferring an issue to another repository](/articles/transferring-an-issue-to-another-repository)."{% endif %} +- Create issue templates to help contributors open meaningful issues. For more information, see "[About issue and pull request templates](/articles/about-issue-and-pull-request-templates)." +- Transfer open issues to other repositories. For more information, see "[Transferring an issue to another repository](/articles/transferring-an-issue-to-another-repository)." - Pin important issues to make them easier to find, preventing duplicate issues and reducing noise. For more information, see "[Pinning an issue to your repository](/articles/pinning-an-issue-to-your-repository)." - Track duplicate issues using saved replies. For more information, see "[About saved replies](/articles/about-saved-replies)."{% if currentVersion == "free-pro-team@latest" %} - Report comments that violate {% data variables.product.prodname_dotcom %}'s [Community Guidelines](/articles/github-community-guidelines). For more information, see "[Reporting abuse or spam](/articles/reporting-abuse-or-spam)."{% endif %} diff --git a/translations/ru-RU/content/github/managing-your-work-on-github/about-labels.md b/translations/ru-RU/content/github/managing-your-work-on-github/about-labels.md index 505650ef5a72..3c78b31cd3a8 100644 --- a/translations/ru-RU/content/github/managing-your-work-on-github/about-labels.md +++ b/translations/ru-RU/content/github/managing-your-work-on-github/about-labels.md @@ -16,17 +16,17 @@ Anyone with read access to a repository can view and search the repository’s l {% data variables.product.product_name %} provides default labels in every new repository. You can use these default labels to help create a standard workflow in a repository: -| Label | Description | -| ------------------ | --------------------------------------------------------------------------------------------------------------------- | -| `bug` | Indicates an unexpected problem or unintended behavior{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| `документация` | Indicates a need for improvements or additions to documentation{% endif %} -| `duplicate` | Indicates similar issues or pull requests | -| `enhancement` | Indicates new feature requests | -| `good first issue` | Indicates a good issue for first-time contributors | -| `help wanted` | Indicates that a maintainer wants help on an issue or pull request | -| `invalid` | Indicates that an issue or pull request is no longer relevant | -| `question` | Indicates that an issue or pull request needs more information | -| `wontfix` | Indicates that work won't continue on an issue or pull request | +| Label | Description | +| ------------------ | ------------------------------------------------------------------ | +| `bug` | Indicates an unexpected problem or unintended behavior | +| `документация` | Indicates a need for improvements or additions to documentation | +| `duplicate` | Indicates similar issues or pull requests | +| `enhancement` | Indicates new feature requests | +| `good first issue` | Indicates a good issue for first-time contributors | +| `help wanted` | Indicates that a maintainer wants help on an issue or pull request | +| `invalid` | Indicates that an issue or pull request is no longer relevant | +| `question` | Indicates that an issue or pull request needs more information | +| `wontfix` | Indicates that work won't continue on an issue or pull request | Default labels are included in every new repository when the repository is created, but you can edit or delete the labels later. For more information, see "[Deleting a label](/articles/deleting-a-label/)." diff --git a/translations/ru-RU/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md b/translations/ru-RU/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md index fb742ab0b956..4547aed6d9df 100644 --- a/translations/ru-RU/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md +++ b/translations/ru-RU/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md @@ -54,15 +54,8 @@ You can put a maximum of 2,500 cards into each project column. If a column has r 1. On the right side of an issue or pull request, click **Projects {% octicon "gear" aria-label="The Gear icon" %}**. ![Project board button in sidebar](/assets/images/help/projects/sidebar-project.png) 2. Click the **Recent**, **Repository**,**User**, or **Organization** tab for the project board you would like to add to. ![Recent, Repository and Organization tabs](/assets/images/help/projects/sidebar-project-tabs.png) 3. Type the name of the project in **Filter projects** field. ![Project board search box](/assets/images/help/projects/sidebar-search-project.png) -4. Select one or more project boards where you want to add the issue or pull request. ![Selected project board](/assets/images/help/projects/sidebar-select-project.png){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -5. Click -{% octicon "triangle-down" aria-label="The down triangle icon" %}, then click the column where you want your issue or pull request. The card will move to the bottom of the project board column you select. - ![Move card to column menu](/assets/images/help/projects/sidebar-select-project-board-column-menu.png) -{% else %} -5. On the right side of an issue or pull request, click **PROJECT-BOARD-NAME (awaiting triage)**. ![Link to project board](/assets/images/help/projects/sidebar-project-board-link.png) -6. In your project board, click **{% octicon "plus" aria-label="The Plus icon" %} Add cards (1 new)**. ![Add cards button](/assets/images/help/projects/add-cards-pending-button.png) -7. Drag the card for your issue or pull request from the **Triage** section, to the desired column on the project board. Alternatively, you can move cards using keyboard shortcuts. {% data reusables.project-management.for-more-info-project-keyboard-shortcuts %} -{% endif %} +4. Select one or more project boards where you want to add the issue or pull request. ![Selected project board](/assets/images/help/projects/sidebar-select-project.png) +5. Click {% octicon "triangle-down" aria-label="The down triangle icon" %}, then click the column where you want your issue or pull request. The card will move to the bottom of the project board column you select. ![Move card to column menu](/assets/images/help/projects/sidebar-select-project-board-column-menu.png) ### Дополнительная литература diff --git a/translations/ru-RU/content/github/managing-your-work-on-github/applying-labels-to-issues-and-pull-requests.md b/translations/ru-RU/content/github/managing-your-work-on-github/applying-labels-to-issues-and-pull-requests.md index 12e42de64ba1..6c1028bb0fea 100644 --- a/translations/ru-RU/content/github/managing-your-work-on-github/applying-labels-to-issues-and-pull-requests.md +++ b/translations/ru-RU/content/github/managing-your-work-on-github/applying-labels-to-issues-and-pull-requests.md @@ -18,7 +18,8 @@ versions: {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issue-pr %} {% data reusables.repositories.select-items-in-issue-or-pr-list %} -4. In the upper-right corner, click **Label**, then start typing the name of an existing label. Click the label's name to associate it with the selected items. ![Issues Milestone assignment drop-down](/assets/images/help/issues/issues_applying_labels_dropdown.png) +4. In the upper-right corner, click **Label**, then start typing the name of an existing label. Click the label's name to associate it with the selected items. You can also apply a label in the Labels drop-down menu within an issue or pull request. ![Issues Milestone assignment drop-down](/assets/images/help/issues/issues_applying_labels_dropdown.png) + ### Дополнительная литература diff --git a/translations/ru-RU/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md b/translations/ru-RU/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md index fd977f2f25db..9f5c8c1e7c6a 100644 --- a/translations/ru-RU/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md +++ b/translations/ru-RU/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md @@ -10,7 +10,7 @@ versions: Anyone with write permissions to a repository can assign issues and pull requests. -You can assign up to 10 people to each issue or pull request, including yourself,{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} anyone who has commented on the issue or pull request,{% endif %} anyone with write permissions to the repository, and organization members with read permissions to the repository. For more information, see "[Access permissions on {% data variables.product.prodname_dotcom %}](/articles/access-permissions-on-github)." +You can assign up to 10 people to each issue or pull request, including yourself, anyone who has commented on the issue or pull request, anyone with write permissions to the repository, and organization members with read permissions to the repository. For more information, see "[Access permissions on {% data variables.product.prodname_dotcom %}](/articles/access-permissions-on-github)." {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issue-pr %} diff --git a/translations/ru-RU/content/github/managing-your-work-on-github/creating-a-project-board.md b/translations/ru-RU/content/github/managing-your-work-on-github/creating-a-project-board.md index 6ff369602df5..102b7fdd7706 100644 --- a/translations/ru-RU/content/github/managing-your-work-on-github/creating-a-project-board.md +++ b/translations/ru-RU/content/github/managing-your-work-on-github/creating-a-project-board.md @@ -63,7 +63,7 @@ You can also configure workflow automations to keep your project board in sync w ### Creating a repository project board {% data reusables.repositories.navigate-to-repo %} -2. Под именем вашего репозитория нажмите +2. Под именем вашего репозитория щелкните {% octicon "project" aria-label="The project board icon" %} **Projects**. ![Project tab](/assets/images/help/projects/repo-tabs-projects.png) {% data reusables.project-management.click-new-project %} diff --git a/translations/ru-RU/content/github/managing-your-work-on-github/disabling-issues.md b/translations/ru-RU/content/github/managing-your-work-on-github/disabling-issues.md index 7caaf9d773b1..ce7933580dcd 100644 --- a/translations/ru-RU/content/github/managing-your-work-on-github/disabling-issues.md +++ b/translations/ru-RU/content/github/managing-your-work-on-github/disabling-issues.md @@ -17,8 +17,9 @@ If you decide to enable issues again in the future, any issues that were previou {% if currentVersion == "free-pro-team@latest" %} {% tip %} +Please contact -Please contact {% data variables.contact.contact_support %} if you want to turn off issues because of abuse from strangers. +{% data variables.contact.contact_support %} if you want to turn off issues because of abuse from strangers. {% data reusables.policies.abuse %} {% endtip %} diff --git a/translations/ru-RU/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md b/translations/ru-RU/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md index a30470f0e5e0..6513d9de6118 100644 --- a/translations/ru-RU/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md +++ b/translations/ru-RU/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md @@ -8,14 +8,14 @@ versions: enterprise-server: '*' --- -On a card, you can click any assignee{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}, milestone,{% endif %} or label to filter the project board by that qualifier. To clear the search, you can click the same assignee{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}, milestone,{% endif %} or label again. +On a card, you can click any assignee, milestone, or label to filter the project board by that qualifier. To clear the search, you can click the same assignee, milestone, or label again. You can also use the "Filter cards" search bar at the top of each project board to search for cards. You can filter cards using the following search qualifiers in any combination, or by simply typing some text you'd like to search for. - Filter cards by author using `author:USERNAME` - Filter cards by assignee using `assignee:USERNAME` or `no:assignee` -- Filter cards by label using `label:LABEL`, `label:"MULTI-WORD LABEL NAME"`, or `no:label`{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -- Filter by milestone by using `milestone:MY-MILESTONE`{% endif %} +- Filter cards by label using `label:LABEL`, `label:"MULTI-WORD LABEL NAME"`, or `no:label` +- Filter by milestone by using `milestone:MY-MILESTONE` - Filter cards by state using `state:open`, `state:closed`, or `state:merged` - Filter by review status using `review:none`, `review:required`, `review:approved`, or `review:changes_requested` - Filter by check status using `status:pending`, `status:success`, or `status:failure` diff --git a/translations/ru-RU/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md b/translations/ru-RU/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md index 5c162f9cedde..e9b3747bfc66 100644 --- a/translations/ru-RU/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md +++ b/translations/ru-RU/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md @@ -11,13 +11,17 @@ versions: enterprise-server: '*' --- +{% note %} + +**Note:** The special keywords in a pull request description are interpreted when the pull request targets the repository's *default* branch. However, if the PR's base is *any other branch*, then these keywords are ignored, no links are created and merging the PR has no effect on the issues. **If you want to link a pull request to an issue using a keyword, the PR must be on the default branch.** + +{% endnote %} + ### About linked issues and pull requests You can link an issue to a pull request {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}manually or {% endif %}using a supported keyword in the pull request description. -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -When you link a pull request to the issue the pull request addresses, collaborators can see that someone is working on the issue. -{% if currentVersion ver_lt "enterprise-server@2.21" %}If the pull request and the issue are in different repositories, {% data variables.product.product_name %} will display the link after the pull request is merged, if the person who merges the pull request also has permission to close the issue.{% endif %}{% endif %} +When you link a pull request to the issue the pull request addresses, collaborators can see that someone is working on the issue. {% if currentVersion ver_lt "enterprise-server@2.21" %}If the pull request and the issue are in different repositories, {% data variables.product.product_name %} will display the link after the pull request is merged, if the person who merges the pull request also has permission to close the issue.{% endif %} When you merge a linked pull request into the default branch of a repository, its linked issue is automatically closed. For more information about the default branch, see "[Setting the default branch](/github/administering-a-repository/setting-the-default-branch)." @@ -37,7 +41,7 @@ You can manually link up to ten issues to each pull request. The issue and pull ### Linking a pull request to an issue using a keyword -You can link a pull request to an issue by using a supported keyword in the pull request's description. +You can link a pull request to an issue by using a supported keyword in the pull request's description or in a commit message (please note that the pull request must be on the default branch). * close * closes @@ -45,7 +49,7 @@ You can link a pull request to an issue by using a supported keyword in the pull * fix * fixes * fixed -* resolve +* разрешение проблем * resolves * resolved @@ -59,7 +63,7 @@ The syntax for closing keywords depends on whether the issue is in the same repo {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}Only manually linked pull requests can be manually unlinked. To unlink an issue that you linked using a keyword, you must edit the pull request description to remove the keyword.{% endif %} -You can also use closing keywords in a commit message. The issue will be closed when you merge the commit into the default branch{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, but the pull request that contains the commit will not be listed as a linked pull request{% endif %}. +You can also use closing keywords in a commit message. The issue will be closed when you merge the commit into the default branch, but the pull request that contains the commit will not be listed as a linked pull request. ### Дополнительная литература diff --git a/translations/ru-RU/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md b/translations/ru-RU/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md index b4108b1756eb..603d2b7399c5 100644 --- a/translations/ru-RU/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md +++ b/translations/ru-RU/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md @@ -5,14 +5,14 @@ redirect_from: - /articles/transferring-an-issue-to-another-repository versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- To transfer an open issue to another repository, you must have write permissions on the repository the issue is in and the repository you're transferring the issue to. For more information, see "[Repository permission levels for an organization](/articles/repository-permission-levels-for-an-organization)." You can only transfer issues between repositories owned by the same user or organization account. You can't transfer an issue from a private repository to a public repository. -When you transfer an issue, comments and assignees are retained. The issue's labels{% if currentVersion ver_lt "enterprise-server@2.19" %}, projects,{% endif %} and milestones are not retained.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} This issue will stay on any user-owned or organization-wide project boards and be removed from any repository project boards. For more information, see "[About project boards](/articles/about-project-boards)."{% endif %} +When you transfer an issue, comments and assignees are retained. The issue's labels and milestones are not retained. This issue will stay on any user-owned or organization-wide project boards and be removed from any repository project boards. For more information, see "[About project boards](/articles/about-project-boards)." People or teams who are mentioned in the issue will receive a notification letting them know that the issue has been transferred to a new repository. The original URL redirects to the new issue's URL. People who don't have read permissions in the new repository will see a banner letting them know that the issue has been transferred to a new repository that they can't access. diff --git a/translations/ru-RU/content/github/receiving-notifications-about-activity-on-github/about-email-notifications.md b/translations/ru-RU/content/github/receiving-notifications-about-activity-on-github/about-email-notifications.md index 5ee55178a59e..88539a2e5f9c 100644 --- a/translations/ru-RU/content/github/receiving-notifications-about-activity-on-github/about-email-notifications.md +++ b/translations/ru-RU/content/github/receiving-notifications-about-activity-on-github/about-email-notifications.md @@ -19,17 +19,17 @@ Each email notification that {% data variables.product.product_name %} sends con Email notifications from {% data variables.product.product_name %} contain the following header information: -| Header | Information | -| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `From` address | This address will always be 'the no-reply email address configured by your site administrator'. | -| `To` field | This field connects directly to the thread. If you reply to the email, you'll add a new comment to the conversation. | -| `Cc` address | {% data variables.product.product_name %} will `Cc` you if you're subscribed to a conversation. The second `Cc` email address matches the notification reason. The suffix for these notification reasons is {% data variables.notifications.cc_address %}. The possible notification reasons are:
    • `assign`: You were assigned to an issue or pull request.
    • `author`: You created an issue or pull request.
    • `comment`: You commented on an issue or pull request.
    • `manual`: There was an update to an issue or pull request you manually subscribed to.
    • `mention`: You were mentioned on an issue or pull request.
    • `push`: Someone committed to a pull request you're subscribed to.
    • `review_requested`: You or a team you're a member of was requested to review a pull request.
    • `security_alert`: {% data variables.product.prodname_dotcom %} detected a vulnerability in a repository you receive security alerts for.
    • `state_change`: An issue or pull request you're subscribed to was either closed or opened.
    • `subscribed`: There was an update in a repository you're watching.
    • `team_mention`: A team you belong to was mentioned on an issue or pull request.
    • `your_activity`: You opened, commented on, or closed an issue or pull request.
    | -| `mailing list` field | This field identifies the name of the repository and its owner. The format of this address is always `..{% data variables.command_line.backticks %}`. |{% if currentVersion ver_gt "enterprise-server@2.19" % %} -| `X-GitHub-Severity` field | {% data reusables.repositories.security-alerts-x-github-severity %} The possible severity levels are:
    • `low`
    • `moderate`
    • `high`
    • `critical`
    For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." |{% endif %} +| Header | Information | +| --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `From` address | This address will always be 'the no-reply email address configured by your site administrator'. | +| `To` field | This field connects directly to the thread. If you reply to the email, you'll add a new comment to the conversation. | +| `Cc` address | {% data variables.product.product_name %} will `Cc` you if you're subscribed to a conversation. The second `Cc` email address matches the notification reason. The suffix for these notification reasons is {% data variables.notifications.cc_address %}. The possible notification reasons are:
    • `assign`: You were assigned to an issue or pull request.
    • `author`: You created an issue or pull request.
    • `comment`: You commented on an issue or pull request.
    • `manual`: There was an update to an issue or pull request you manually subscribed to.
    • `mention`: You were mentioned on an issue or pull request.
    • `push`: Someone committed to a pull request you're subscribed to.
    • `review_requested`: You or a team you're a member of was requested to review a pull request.
    • `security_alert`: {% data variables.product.prodname_dotcom %} detected a vulnerability in a repository you receive security alerts for.
    • `state_change`: An issue or pull request you're subscribed to was either closed or opened.
    • `subscribed`: There was an update in a repository you're watching.
    • `team_mention`: A team you belong to was mentioned on an issue or pull request.
    • `your_activity`: You opened, commented on, or closed an issue or pull request.
    | +| `mailing list` field | This field identifies the name of the repository and its owner. The format of this address is always `..{% data variables.command_line.backticks %}`. |{% if currentVersion ver_gt "enterprise-server@2.19" % %} +| `X-GitHub-Severity` field | {% data reusables.repositories.security-alerts-x-github-severity %} The possible severity levels are:
    • `low`
    • `moderate`
    • `high`
    • `critical`
    For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." |{% endif %} ### Дополнительная литература - "[Listing the repositories you're watching](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching)" - "[Watching and unwatching repositories](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories)" -- "[Subscribing to and unsubscribing from notifications](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)"{% if currentVersion ver_gt "enterprise-server@2.17" %} -- "[Creating gists](/articles/creating-gists)"{% endif %} +- "[Subscribing to and unsubscribing from notifications](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)" +- "[Creating gists](/articles/creating-gists)" diff --git a/translations/ru-RU/content/github/receiving-notifications-about-activity-on-github/about-notifications.md b/translations/ru-RU/content/github/receiving-notifications-about-activity-on-github/about-notifications.md index 565cddf42a67..84c3e06fadc1 100644 --- a/translations/ru-RU/content/github/receiving-notifications-about-activity-on-github/about-notifications.md +++ b/translations/ru-RU/content/github/receiving-notifications-about-activity-on-github/about-notifications.md @@ -33,9 +33,8 @@ The notifications you receive will either be *participating* notifications or *w #### Watching notifications -{% data variables.product.product_name %} sends *watching* notifications for updates in repositories or team discussions that you're watching. {% if currentVersion ver_gt "enterprise-server@2.17" %} {% data reusables.notifications.auto-watch %}For more information, see "[Watching and unwatching repositories](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories)." - -{% endif %}You'll receive a notification when: +{% data variables.product.product_name %} sends *watching* notifications for updates in repositories or team discussions that you're watching. {% data reusables.notifications.auto-watch %}For more information, see "[Watching and unwatching repositories](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories)." +You'll receive a notification when: - An issue is opened. - A comment is added to an open issue. - A pull request is opened. diff --git a/translations/ru-RU/content/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications.md b/translations/ru-RU/content/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications.md index 316b5ad20328..c6c724f4225a 100644 --- a/translations/ru-RU/content/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications.md +++ b/translations/ru-RU/content/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications.md @@ -7,21 +7,12 @@ versions: ### Managing your notification settings for an issue or pull request -{% if currentVersion ver_lt "enterprise-server@2.18" %}When you subscribe to a conversation in an issue or pull request, you'll receive notifications for each update to the conversation even if you're not participating in the conversation. - -When you unsubscribe from a conversation in an issue or pull request, you'll no longer receive notifications about the conversation. If you or a team you're a member of are @mentioned in the conversation, you'll begin receiving notifications again. For more information about @mentions, see "[Basic writing and formatting syntax](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams)."{% endif %} - {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issue-pr %} 3. Choose an issue or pull request to subscribe to. -{% if currentVersion ver_gt "enterprise-server@2.17" %} 4. In the right sidebar, click **Subscribe** or **Unsubscribe**. ![Conversation Subscribe button](/assets/images/help/notifications/subscribe_button_with_gear.png) 5. To customize your notifications, click {% octicon "gear" aria-label="The gear icon" %}. ![Gear button next to Conversation Subscribe](/assets/images/help/notifications/subscribe_button_with_gear_chosen.png) -6. Select the type of notifications you want to receive for this conversation, then click **Save**. ![Conversation Subscribe options list](/assets/images/help/notifications/subscribe_options.png) -{% else %} -4. To subscribe or unsubscribe from a conversation, in the right sidebar, click **Subscribe** or **Unsubscribe**. ![Conversation Subscribe button](/assets/images/help/notifications/subscribe_button.png) -{% endif %} -You can see a list of all the issues and pull requests you're subscribed to. For more information, see "[Listing the issues and pull requests you're subscribed to](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-issues-and-pull-requests-youre-subscribed-to)." +6. Select the type of notifications you want to receive for this conversation, then click **Save**. ![Conversation Subscribe options list](/assets/images/help/notifications/subscribe_options.png) You can see a list of all the issues and pull requests you're subscribed to. For more information, see "[Listing the issues and pull requests you're subscribed to](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-issues-and-pull-requests-youre-subscribed-to)." ### Subscribing to team discussions diff --git a/translations/ru-RU/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories.md b/translations/ru-RU/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories.md index ae46bfad98e1..7d40c84e9d50 100644 --- a/translations/ru-RU/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories.md +++ b/translations/ru-RU/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories.md @@ -5,9 +5,7 @@ versions: enterprise-server: <2.21 --- -{% if currentVersion ver_gt "enterprise-server@2.17" %} {% data reusables.notifications.auto-watch %} For more information, see "[About notifications](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/about-notifications)." -{% endif %} You can also watch and unwatch releases in a repository. For more information, see "[Watching and unwatching releases for a repository](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-releases-for-a-repository)." diff --git a/translations/ru-RU/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md b/translations/ru-RU/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md index 974f4444519c..edbe8141e6b4 100644 --- a/translations/ru-RU/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md +++ b/translations/ru-RU/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md @@ -21,14 +21,16 @@ To automatically watch all team discussions for new teams you join, set your aut {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.notifications %} -{% data reusables.user_settings.automatic_watching_box %} select **Automatically watch teams**. ![Checkbox for automatically watching teams](/assets/images/help/notifications/automatic-team-discussions-watching.png) +{% data reusables.user_settings.automatic_watching_box %} select **Automatically watch teams**. +![Checkbox for automatically watching teams](/assets/images/help/notifications/automatic-team-discussions-watching.png) ### Watching a single team's discussions {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.specific_team %} -{% data reusables.organizations.watch-team-options %} click **Watch** to open your notifications options. Then click **Watching**. ![Watch options in a drop-down menu for a specific team](/assets/images/help/notifications/specific-team-watch-options.png) +{% data reusables.organizations.watch-team-options %} click **Watch** to open your notifications options. Then click **Watching**. +![Watch options in a drop-down menu for a specific team](/assets/images/help/notifications/specific-team-watch-options.png) ### Unwatching team discussions for all new teams you join @@ -36,14 +38,16 @@ If you don't want to automatically receive team discussion notifications when yo {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.notifications %} -{% data reusables.user_settings.automatic_watching_box %} unselect **Automatically watch teams**. ![Automatically watching teams setting selected by default](/assets/images/help/notifications/automatic-team-discussions-watching.png) +{% data reusables.user_settings.automatic_watching_box %} unselect **Automatically watch teams**. +![Automatically watching teams setting selected by default](/assets/images/help/notifications/automatic-team-discussions-watching.png) ### Unwatching a single team's discussions {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.specific_team %} -{% data reusables.organizations.watch-team-options %} click **Unwatch** to open your notifications options. Then click **Not watching**. ![Watch options in a drop-down menu for a specific team](/assets/images/help/notifications/specific-team-unwatch.png) +{% data reusables.organizations.watch-team-options %} click **Unwatch** to open your notifications options. Then click **Not watching**. +![Watch options in a drop-down menu for a specific team](/assets/images/help/notifications/specific-team-unwatch.png) {% note %} diff --git a/translations/ru-RU/content/github/searching-for-information-on-github/about-searching-on-github.md b/translations/ru-RU/content/github/searching-for-information-on-github/about-searching-on-github.md index f7e38bcf719a..75d83dc31eb2 100644 --- a/translations/ru-RU/content/github/searching-for-information-on-github/about-searching-on-github.md +++ b/translations/ru-RU/content/github/searching-for-information-on-github/about-searching-on-github.md @@ -1,6 +1,6 @@ --- title: About searching on GitHub -intro: 'Use our powerful search tools to find what you''re looking for among the many repositories, users, and lines of code on {% data variables.product.product_name %}.' +intro: 'Our integrated search covers the many repositories, users, and lines of code on {% data variables.product.product_name %}.' redirect_from: - /articles/using-the-command-bar/ - /articles/github-search-basics/ @@ -24,6 +24,8 @@ You can search globally across all of {% data variables.product.product_name %}, - {% data reusables.search.required_login %} - {% data variables.product.prodname_pages %} sites are not searchable on {% data variables.product.product_name %}. However you can search the source content if it exists in the default branch of a repository, using code search. For more information, see "[Searching code](/articles/searching-code)." For more information about {% data variables.product.prodname_pages %}, see "[What is GitHub Pages?](/articles/what-is-github-pages/)" +- Currently our search doesn't support exact matching. +- Whenever you are searching in code files, only the first two results in each file will be returned. {% endnote %} diff --git a/translations/ru-RU/content/github/searching-for-information-on-github/searching-for-packages.md b/translations/ru-RU/content/github/searching-for-information-on-github/searching-for-packages.md index cacfe2a4d14a..22fcaed03b25 100644 --- a/translations/ru-RU/content/github/searching-for-information-on-github/searching-for-packages.md +++ b/translations/ru-RU/content/github/searching-for-information-on-github/searching-for-packages.md @@ -15,7 +15,8 @@ versions: You can search for packages globally across all of {% data variables.product.product_name %}, or search for packages within a particular organization. For more information, see "[About searching on {% data variables.product.prodname_dotcom %}](/articles/about-searching-on-github)." {% if currentVersion != "free-pro-team@latest" %} -You can only search for packages on {% data variables.product.product_location_enterprise %}, not {% data variables.product.prodname_dotcom_the_website %}, even if {% data variables.product.prodname_github_connect %} is enabled. +You can only search for packages on +{% data variables.product.product_location_enterprise %}, not {% data variables.product.prodname_dotcom_the_website %}, even if {% data variables.product.prodname_github_connect %} is enabled. {% endif %} {% data reusables.search.syntax_tips %} @@ -24,9 +25,9 @@ You can only search for packages on {% data variables.product.product_location_e To find packages owned by a certain user or organization, use the `user` or `org` qualifier. -| Qualifier | Пример | -| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| user:USERNAME | [**user:codertocat**](https://github.com/search?q=user%3Acodertocat&type=RegistryPackages) matches packages owned by @codertocat | +| Qualifier | Пример | +| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| user:USERNAME | [**user:codertocat**](https://github.com/search?q=user%3Acodertocat&type=RegistryPackages) matches packages owned by @codertocat | | org:ORGNAME | [**org:github**](https://github.com/search?q=org%3Agithub&type=RegistryPackages) matches packages owned by the {% data variables.product.prodname_dotcom %} organization | ### Filtering by package visibility diff --git a/translations/ru-RU/content/github/searching-for-information-on-github/sorting-search-results.md b/translations/ru-RU/content/github/searching-for-information-on-github/sorting-search-results.md index f31f009d6ec8..7e3eccb57197 100644 --- a/translations/ru-RU/content/github/searching-for-information-on-github/sorting-search-results.md +++ b/translations/ru-RU/content/github/searching-for-information-on-github/sorting-search-results.md @@ -18,8 +18,8 @@ To sort by interactions, reactions, author date, committer date, or how recently The `sort:interactions` qualifier sorts by the highest combined number of reactions and comments. -| Qualifier | Пример | -| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Qualifier | Пример | +| ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sort:interactions` or `sort:interactions-desc` | [**org:github sort:interactions**](https://github.com/search?q=org%3Agithub+sort%3Ainteractions&type=Issues) matches issues in repositories owned by {% data variables.product.product_name %}, sorted by the highest combined number of reactions and comments. | | `sort:interactions-asc` | [**org:github sort:interactions-asc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Ainteractions-asc&type=Issues) matches issues in repositories owned by {% data variables.product.product_name %}, sorted by the lowest combined number of reactions and comments. | @@ -27,8 +27,8 @@ The `sort:interactions` qualifier sorts by the highest combined number of reacti The `sort:reactions` qualifier sorts by the number or type of reactions. -| Qualifier | Пример | -| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| Qualifier | Пример | +| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sort:reactions` or `sort:reactions-desc` | [**org:github sort:reactions**](https://github.com/search?q=org%3Agithub+sort%3Areactions&type=Issues) matches issues in repositories owned by {% data variables.product.product_name %}, sorted by the highest number of reactions. | | `sort:reactions-asc` | [**org:github sort:reactions-asc**](https://github.com/search?q=org%3Agithub+sort%3Areactions-asc&type=Issues) matches issues in repositories owned by {% data variables.product.product_name %}, sorted by ascending number of reactions (the fewest to the most). | | sort:reactions-reaction | [**org:github sort:reactions-+1**](https://github.com/search?q=org%3Agithub+sort%3Areactions-%2B1&type=Issues) matches issues in repositories owned by {% data variables.product.product_name %}, sorted by most thumbs up (:+1:) reactions. | @@ -41,8 +41,8 @@ The `sort:reactions` qualifier sorts by the number or type of reactions. The `sort:author-date` qualifier sorts by descending or ascending author date. -| Qualifier | Пример | -| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Qualifier | Пример | +| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sort:author-date` or `sort:author-date-desc` | [**feature org:github sort:author-date**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Aauthor-date&type=Commits) matches commits containing the word "feature" in repositories owned by {% data variables.product.product_name %}, sorted by descending author date. | | `sort:author-date-asc` | [**feature org:github sort:author-date-asc**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Aauthor-date-asc&type=Commits) matches commits containing the word "feature" in repositories owned by {% data variables.product.product_name %}, sorted by ascending author date. | @@ -50,8 +50,8 @@ The `sort:author-date` qualifier sorts by descending or ascending author date. The `sort:committer-date` qualifier sorts by descending or ascending committer date. -| Qualifier | Пример | -| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Qualifier | Пример | +| --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sort:committer-date` or `sort:committer-date-desc` | [**feature org:github sort:committer-date**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Acommitter-date&type=Commits) matches commits containing the word "feature" in repositories owned by {% data variables.product.product_name %}, sorted by descending committer date. | | `sort:committer-date-asc` | [**feature org:github sort:committer-date-asc**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Acommitter-date-asc&type=Commits) matches commits containing the word "feature" in repositories owned by {% data variables.product.product_name %}, sorted by ascending committer date. | diff --git a/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md b/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md index 5f2a269ddedb..b8d65743c0be 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md @@ -12,8 +12,8 @@ versions: Minutes reset every month, while storage usage does not. -| Product | Storage | Minutes (per month) | -| ------------------------------------------------------------------------ | ------- | ------------------- | +| Product | Storage | Minutes (per month) | +| ------------------------------------------------------------------- | ------- | ------------------- | | {% data variables.product.prodname_free_user %} | 500 MB | 2,000 | | {% data variables.product.prodname_pro %} | 1 GB | 3,000 | | {% data variables.product.prodname_free_team %} for organizations | 500 MB | 2,000 | @@ -44,7 +44,7 @@ The storage used by a repository is the total storage used by {% data variables. | macOS | $0.08 | | Windows | $0.016 | -The number of jobs you can run concurrently across all repositories in your user or organization account depends on your GitHub plan. For more information, see "[About {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/about-github-actions/#usage-limits)." +The number of jobs you can run concurrently across all repositories in your user or organization account depends on your GitHub plan. For more information, see "[Usage limits and billing](/actions/reference/usage-limits-billing-and-administration)" for {% data variables.product.prodname_dotcom %}-hosted runners and "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)" for self-hosted runner usage limits. ### Calculating minute and storage spending diff --git a/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md b/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md index ced51dbc7b64..5b1e0b28596e 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md @@ -14,8 +14,8 @@ versions: Data transfer resets every month, while storage usage does not. -| Product | Storage | Data transfer (per month) | -| ------------------------------------------------------------------------ | ------- | ------------------------- | +| Product | Storage | Data transfer (per month) | +| ------------------------------------------------------------------- | ------- | ------------------------- | | {% data variables.product.prodname_free_user %} | 500MB | 1GB | | {% data variables.product.prodname_pro %} | 2GB | 10GB | | {% data variables.product.prodname_free_team %} for organizations | 500MB | 1GB | diff --git a/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md b/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md index 01b8e92f0584..bc99201f6ab1 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md @@ -49,6 +49,8 @@ Enterprise owners and billing managers can manage the spending limit for {% data {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %} -1. Under "{% data variables.product.prodname_actions %} and Packages monthly usage", click **Cost management**. ![Cost management tab](/assets/images/help/settings/cost-management-tab-enterprise.png) +1. Under " +{% data variables.product.prodname_actions %} and Packages monthly usage", click **Cost management**. + ![Cost management tab](/assets/images/help/settings/cost-management-tab-enterprise.png) {% data reusables.dotcom_billing.monthly-spending-limit %} {% data reusables.dotcom_billing.update-spending-limit %} diff --git a/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md b/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md index 30279630ecea..4fd980b82126 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md @@ -49,6 +49,8 @@ Enterprise owners and billing managers can manage the spending limit for {% data {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %} -1. Under "{% data variables.product.prodname_actions %} and Packages monthly usage", click **Cost management**. ![Cost management tab](/assets/images/help/settings/cost-management-tab-enterprise.png) +1. Under " +{% data variables.product.prodname_actions %} and Packages monthly usage", click **Cost management**. + ![Cost management tab](/assets/images/help/settings/cost-management-tab-enterprise.png) {% data reusables.dotcom_billing.monthly-spending-limit %} {% data reusables.dotcom_billing.update-spending-limit %} diff --git a/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md b/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md index f23dc37576fb..bb09061c3fdb 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md @@ -28,7 +28,9 @@ You can upgrade your personal account from {% data variables.product.prodname_fr {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.billing %} {% data reusables.user_settings.subscriptions-tab %} -4. Next to "{% data variables.product.prodname_free_user %}", click **Upgrade**. ![Upgrade button](/assets/images/help/billing/settings_billing_user_upgrade.png) +4. Next to " +{% data variables.product.prodname_free_user %}", click **Upgrade**. + ![Upgrade button](/assets/images/help/billing/settings_billing_user_upgrade.png) {% data reusables.dotcom_billing.choose-monthly-or-yearly-billing %} {% data reusables.dotcom_billing.show-plan-details %} {% data reusables.dotcom_billing.enter-payment-info %} diff --git a/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md b/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md index 0fd91b7cc6d3..5aaa282b1206 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md @@ -6,7 +6,7 @@ versions: free-pro-team: '*' --- -You can also view the billable job execution minutes for an individual workflow run. For more information, see "[Managing a workflow run](/actions/configuring-and-managing-workflows/managing-a-workflow-run#viewing-billable-job-execution-minutes)." +You can also view the billable job execution minutes for an individual workflow run. For more information, see "[Viewing job execution time](/actions/managing-workflow-runs/viewing-job-execution-time)." ### Viewing {% data variables.product.prodname_actions %} usage for your user account @@ -43,6 +43,8 @@ Enterprise owners and billing managers can view {% data variables.product.prodna {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %} -1. Under "{% data variables.product.prodname_actions %}", view details of usage of data transfer by each organization in your enterprise account. ![Details of usage of minutes](/assets/images/help/billing/actions-minutes-enterprise.png) +1. Under " +{% data variables.product.prodname_actions %}", view details of usage of data transfer by each organization in your enterprise account. + ![Details of usage of minutes](/assets/images/help/billing/actions-minutes-enterprise.png) {% data reusables.dotcom_billing.actions-packages-storage-enterprise-account %} {% data reusables.enterprise-accounts.actions-packages-report-download-enterprise-accounts %} diff --git a/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md b/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md index b5a386cd1b40..378ee9931f53 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md @@ -41,6 +41,8 @@ Enterprise owners and billing managers can view {% data variables.product.prodna {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %} -1. Under "{% data variables.product.prodname_registry %}", view details of usage of data transfer by each organization in your enterprise account. ![Details of usage of data transfer](/assets/images/help/billing/packages-data-enterprise.png) +1. Under " +{% data variables.product.prodname_registry %}", view details of usage of data transfer by each organization in your enterprise account. + ![Details of usage of data transfer](/assets/images/help/billing/packages-data-enterprise.png) {% data reusables.dotcom_billing.actions-packages-storage-enterprise-account %} {% data reusables.enterprise-accounts.actions-packages-report-download-enterprise-accounts %} diff --git a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md index c7820688feda..bd8cc042fa35 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md @@ -25,5 +25,4 @@ For organizations that belong to an enterprise account, billing is managed at th An entity, such as a company, non-profit, or group, can agree to the Standard Terms of Service or the Corporate Terms of Service for their organization. For more information, see "[Upgrading to the Corporate Terms of Service](/articles/upgrading-to-the-corporate-terms-of-service)." -{% data reusables.organizations.enter-data-protection-agreement %} For more information, see "[Entering a data protection agreement with {% data variables.product.prodname_dotcom %} for GDPR compliance](/articles/entering-a-data-protection-agreement-with-github-for-gdpr-compliance)." {% endif %} diff --git a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md index e5cb73b9bbd7..46796cdfe1dc 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md @@ -6,7 +6,7 @@ redirect_from: - /articles/about-ssh-certificate-authorities versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- An SSH certificate is a mechanism for one SSH key to sign another SSH key. If you use an SSH certificate authority (CA) to provide your organization members with signed SSH certificates, you can add the CA to your enterprise account or organization to allow organization members to use their certificates to access organization resources. For more information, see "[Managing your organization's SSH certificate authorities](/articles/managing-your-organizations-ssh-certificate-authorities)." diff --git a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md index 590168bf58b9..677cd19f45bc 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md @@ -17,6 +17,8 @@ An outside collaborator is a person who isn't explicitly a member of your organi {% data reusables.project-management.click-menu %} {% data reusables.project-management.access-collaboration-settings %} {% data reusables.project-management.collaborator-option %} -9. Under "Search by username, full name or email address", type the outside collaborator's name, username, or {% data variables.product.prodname_dotcom %} email. ![The Collaborators section with the Octocat's username entered in the search field](/assets/images/help/projects/org-project-collaborators-find-name.png) +9. Under "Search by username, full name or email address", type the outside collaborator's name, username, or +{% data variables.product.prodname_dotcom %} email. + ![The Collaborators section with the Octocat's username entered in the search field](/assets/images/help/projects/org-project-collaborators-find-name.png) {% data reusables.project-management.add-collaborator %} {% data reusables.project-management.collaborator-permissions %} diff --git a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md index b10ab05d9b4b..57099b666370 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md @@ -24,7 +24,9 @@ For more information about {% data variables.product.prodname_github_app %} mana {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.github-apps-settings-sidebar %} -1. Under "{% data variables.product.prodname_github_app %}s", click on the avatar of the app you'd like to add a {% data variables.product.prodname_github_app %} manager for. ![Select {% data variables.product.prodname_github_app %}](/assets/images/help/organizations/select-github-app.png) +1. Under " +{% data variables.product.prodname_github_app %}s", click on the avatar of the app you'd like to add a {% data variables.product.prodname_github_app %} manager for. +![Select {% data variables.product.prodname_github_app %}](/assets/images/help/organizations/select-github-app.png) {% data reusables.organizations.app-managers-settings-sidebar %} 1. Under "App managers", type the username of the person you want to designate as a GitHub App manager for the app, and click **Grant**. ![Add a {% data variables.product.prodname_github_app %} manager for a specific app](/assets/images/help/organizations/add-github-app-manager-for-app.png) diff --git a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md index 3defd96cac56..9e0257831e4e 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md @@ -15,8 +15,8 @@ SAML SSO controls and secures access to organization resources like repositories After you enable SCIM, the following provisioning features are available for any users that you assign your {% data variables.product.prodname_ghe_cloud %} application to in Okta. -| Feature | Description | -| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Feature | Description | +| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Push New Users | When you create a new user in Okta, the user will receive an email to join your {% data variables.product.prodname_dotcom %} organization. | | Push User Deactivation | When you deactivate a user in Okta, Okta will remove the user from your {% data variables.product.prodname_dotcom %} organization. | | Push Profile Updates | When you update a user's profile in Okta, Okta will update the metadata for the user's membership in your {% data variables.product.prodname_dotcom %} organization. | diff --git a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md new file mode 100644 index 000000000000..5934c0738154 --- /dev/null +++ b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md @@ -0,0 +1,16 @@ +--- +title: Configuring the retention period for GitHub Actions artifacts and logs in your organization +intro: 'You can configure the retention period for {% data variables.product.prodname_actions %} artifacts and logs in your organization.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.23' +--- + +{% data reusables.actions.about-artifact-log-retention %} + +## Setting the retention period for an organization + +{% data reusables.organizations.navigate-to-org %} +{% data reusables.organizations.org_settings %} +{% data reusables.organizations.settings-sidebar-actions %} +{% data reusables.github-actions.change-retention-period-for-artifacts-logs %} diff --git a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md index 2f03e117507e..2a6807c27ca2 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md @@ -17,6 +17,8 @@ You can enable {% data variables.product.prodname_actions %} for all repositorie Alternatively, you can enable {% data variables.product.prodname_actions %} for all repositories in your organization but limit the actions a workflow can run. {% data reusables.github-actions.enabled-local-github-actions %} +{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.23" %} + ### Managing {% data variables.product.prodname_actions %} permissions for your organization {% data reusables.profile.access_profile %} @@ -26,6 +28,42 @@ Alternatively, you can enable {% data variables.product.prodname_actions %} for 1. Under **Local and third-party Actions**, select an option. ![Enable, disable, or limit actions for this organization](/assets/images/help/repository/enable-org-actions.png) 1. Click **Save**. +{% endif %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} + +### Managing {% data variables.product.prodname_actions %} permissions for your organization + +You can disable all workflows for an organization or set a policy that configures which actions can be used in an organization. + +{% data reusables.actions.actions-use-policy-settings %} + +{% note %} + +**Note:** You might not be able to manage these settings if your organization is managed by an enterprise that has overriding policy. For more information, {% if currentVersion == "free-pro-team@latest" %}"[Enforcing {% data variables.product.prodname_actions %} policies in your enterprise account](/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account)."{% else %}"[Enforcing {% data variables.product.prodname_actions %} policies for your enterprise](/enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise)."{% endif %} + +{% endnote %} + +{% data reusables.profile.access_profile %} +{% data reusables.profile.access_org %} +{% data reusables.organizations.org_settings %} +{% data reusables.organizations.settings-sidebar-actions %} +1. Under **Policies**, select an option. ![Set actions policy for this organization](/assets/images/help/organizations/actions-policy.png) +1. Click **Save**. + +### Allowing specific actions to run + +{% data reusables.actions.allow-specific-actions-intro %} + +{% data reusables.profile.access_profile %} +{% data reusables.profile.access_org %} +{% data reusables.organizations.org_settings %} +{% data reusables.organizations.settings-sidebar-actions %} +1. Under **Policies**, select **Allow specific actions** and add your required actions to the list. ![Add actions to allow list](/assets/images/help/organizations/actions-policy-allow-list.png) +1. Click **Save**. + +{% endif %} + {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} ### Enabling workflows for private repository forks diff --git a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/index.md b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/index.md index 68d0475a0af7..771bfe8a8d43 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/index.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/index.md @@ -100,6 +100,7 @@ versions: {% link_in_list /managing-the-forking-policy-for-your-organization %} {% link_in_list /disabling-or-limiting-github-actions-for-your-organization %} + {% link_in_list /configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization %} {% link_in_list /setting-permissions-for-adding-outside-collaborators %} @@ -131,7 +132,6 @@ versions: {% link_in_list /upgrading-to-the-corporate-terms-of-service %} - {% link_in_list /entering-a-data-protection-agreement-with-github-for-gdpr-compliance %} {% topic_link_in_list /migrating-to-improved-organization-permissions %} {% link_in_list /converting-an-owners-team-to-improved-organization-permissions %} diff --git a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md index 8d4a153f3c17..6389c49b4d14 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md @@ -1,6 +1,7 @@ --- title: Inviting users to join your organization intro: 'You can invite anyone to become a member of your organization using their {% data variables.product.product_name %} username or email address.' +permissions: Organization owners can invite users to join an organization. redirect_from: - /articles/adding-or-inviting-members-to-a-team-in-an-organization/ - /articles/inviting-users-to-join-your-organization @@ -11,9 +12,8 @@ versions: {% tip %} **Tips**: -- Only organization owners can invite users to join an organization. For more information, see "[Permission levels for an organization](/articles/permission-levels-for-an-organization)." - If your organization has a paid per-user subscription, an unused license must be available before you can invite a new member to join the organization or reinstate a former organization member. For more information, see "[About per-user pricing](/articles/about-per-user-pricing)." {% data reusables.organizations.org-invite-expiration %} -- If your organization [requires members to use two-factor authentication](/articles/requiring-two-factor-authentication-in-your-organization), users you invite must [enable two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa) before they can accept the invitation. +- If your organization requires members to use two-factor authentication, users that you invite must enable two-factor authentication before accepting the invitation. For more information, see "[Requiring two-factor authentication in your organization](/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization)" and "[Securing your account with two-factor authentication (2FA)](/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa)." {% endtip %} diff --git a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md index 6714d6d9123e..9e7e34a7fcd8 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md @@ -24,7 +24,9 @@ versions: {% data reusables.project-management.click-menu %} {% data reusables.project-management.access-collaboration-settings %} {% data reusables.project-management.collaborator-option %} -9. Under "Search by username, full name or email address", type the collaborator's name, username, or {% data variables.product.prodname_dotcom %} email. ![The Collaborators section with the Octocat's username entered in the search field](/assets/images/help/projects/org-project-collaborators-find-name.png) +9. Under "Search by username, full name or email address", type the collaborator's name, username, or +{% data variables.product.prodname_dotcom %} email. + ![The Collaborators section with the Octocat's username entered in the search field](/assets/images/help/projects/org-project-collaborators-find-name.png) {% data reusables.project-management.add-collaborator %} {% data reusables.project-management.collaborator-permissions %} diff --git a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md index 4906cf152222..30b828ded294 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md @@ -8,6 +8,6 @@ redirect_from: - /articles/managing-git-access-to-your-organizations-repositories versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- diff --git a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md index 9656ce5a0ed2..6ecc2ff41c0e 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md @@ -1,18 +1,17 @@ --- title: Managing the default branch name for repositories in your organization -intro: You can set the default branch name for repositories that members create in your organization. +intro: 'You can set the default branch name for repositories that members create in your organization on {% data variables.product.product_location %}.' +permissions: Organization owners can manage the default branch name for new repositories in the organization. versions: free-pro-team: '*' enterprise-server: '>=2.23' --- -### About the default branch name +### About management of the default branch name -When a member of your organization creates a new repository, {% data variables.product.prodname_dotcom %} will create a single branch and set it as the repository's default branch. {% data variables.product.prodname_dotcom %} currently names the default branch `master`, but you can set the default branch to be named anything that makes sense for your development environment. +When a member of your organization creates a new repository in your organization, the repository contains one branch, which is the default branch. You can change the name that {% data variables.product.product_name %} uses for the default branch in new repositories that members of your organization create. For more information about the default branch, see "[About branches](/github/collaborating-with-issues-and-pull-requests/about-branches#about-the-default-branch)." -{% data reusables.branches.set-default-branch %} - -{% data reusables.branches.rename-existing-branch %} +{% data reusables.branches.change-default-branch %} ### Setting the default branch name @@ -23,7 +22,7 @@ When a member of your organization creates a new repository, {% data variables.p 3. Under "Repository default branch", click **Change default branch name now**. ![Override button](/assets/images/help/organizations/repo-default-name-button.png) {% note %} - **Note:** If your enterprise owner has enforced a policy for the default name, you won't be able to change it here. You will be able to set the default branch on individual repositories. For more information, see "[Enforcing a policy on the default branch name](/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account#enforcing-a-policy-on-the-default-branch-name)" and "[Setting the default branch](/github/administering-a-repository/setting-the-default-branch)." + **Note:** If your enterprise owner has enforced a policy for the default name, you won't be able to change it here. You will be able to set the default branch on individual repositories. For more information, see "[Enforcing a policy on the default branch name](/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account#enforcing-a-policy-on-the-default-branch-name)" and "[Changing the default branch](/github/administering-a-repository/changing-the-default-branch)." {% endnote %} 4. Type the default name that you would like to use for new branches. ![Text box for entering default name](/assets/images/help/organizations/repo-default-name-text.png) @@ -31,4 +30,4 @@ When a member of your organization creates a new repository, {% data variables.p ### Дополнительная литература -- [Managing the default branch name for your repositories](/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories) +- "[Managing the default branch name for your repositories](/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories)" diff --git a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md index 6375823ba5f0..1a5626699d5f 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md @@ -6,7 +6,7 @@ redirect_from: - /articles/managing-the-display-of-member-names-in-your-organization versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- Organization owners can manage the display of member names in an organization. diff --git a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md index cc0c2c8a6d50..b62b548e7bf7 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md @@ -6,7 +6,7 @@ redirect_from: - /articles/managing-your-organizations-ssh-certificate-authorities versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- Organization owners can manage an organization's SSH certificate authorities (CA). diff --git a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md index 5c19e7a3269a..3a47970e69be 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md @@ -22,94 +22,95 @@ Organization members can have *owner*{% if currentVersion == "free-pro-team@late {% if currentVersion == "free-pro-team@latest" %} -| Organization action | Owners | Members | Billing managers | -|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:------:|:-------:|:----------------------------------:| -| Create repositories (see "[Restricting repository creation in your organization](/articles/restricting-repository-creation-in-your-organization)" for details) | **X** | **X** | | -| View and edit billing information | **X** | | **X** | -| Invite people to join the organization | **X** | | | -| Edit and cancel invitations to join the organization | **X** | | | -| Remove members from the organization | **X** | | | -| Reinstate former members to the organization | **X** | | | -| Add and remove people from **all teams** | **X** | | | -| Promote organization members to *team maintainer* | **X** | | | -| Configure code review assignments (see "[Managing code review assignment for your team](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)") | **X** | | | -| Set scheduled reminders (see "[Managing scheduled reminders for pull requests](/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests)") | **X** | | | -| Add collaborators to **all repositories** | **X** | | | -| Access the organization audit log | **X** | | | -| Edit the organization's profile page (see "[About your organization's profile](/articles/about-your-organization-s-profile)" for details) | **X** | | | -| Verify the organization's domains (see "[Verifying your organization's domain](/articles/verifying-your-organization-s-domain)" for details) | **X** | | | -| Delete **all teams** | **X** | | | -| Delete the organization account, including all repositories | **X** | | | -| Create teams (see "[Setting team creation permissions in your organization](/articles/setting-team-creation-permissions-in-your-organization)" for details) | **X** | **X** | | -| [Move teams in an organization's hierarchy](/articles/moving-a-team-in-your-organization-s-hierarchy) | **X** | | | -| Create project boards (see "[Project board permissions for an organization](/articles/project-board-permissions-for-an-organization)" for details) | **X** | **X** | | -| See all organization members and teams | **X** | **X** | | -| @mention any visible team | **X** | **X** | | -| Can be made a *team maintainer* | **X** | **X** | | -| View organization insights (see "[Viewing insights for your organization](/articles/viewing-insights-for-your-organization)" for details) | **X** | **X** | | -| View and post public team discussions to **all teams** (see "[About team discussions](/articles/about-team-discussions)" for details) | **X** | **X** | | -| View and post private team discussions to **all teams** (see "[About team discussions](/articles/about-team-discussions)" for details) | **X** | | | -| Edit and delete team discussions in **all teams** (see "[Managing disruptive comments](/articles/managing-disruptive-comments)" for details) | **X** | | | -| Hide comments on commits, pull requests, and issues (see "[Managing disruptive comments](/articles/managing-disruptive-comments/#hiding-a-comment)" for details) | **X** | **X** | | -| Disable team discussions for an organization (see "[Disabling team discussions for your organization](/articles/disabling-team-discussions-for-your-organization)" for details) | **X** | | |{% if currentVersion == "free-pro-team@latest" %} -| Manage viewing of organization dependency insights (see "[Changing the visibility of your organization's dependency insights](/articles/changing-the-visibility-of-your-organizations-dependency-insights)" for details) | **X** | | |{% endif %} -| Set a team profile picture in **all teams** (see "[Setting your team's profile picture](/articles/setting-your-team-s-profile-picture)" for details) | **X** | | | -| Disable publication of {% data variables.product.prodname_pages %} sites from repositories in the organization (see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)" for details) | **X** | | | -| Manage security and analysis settings (see "[Managing security and analysis settings for your organization](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization)" for details) | **X** | | | -| Enable and enforce [SAML single sign-on](/articles/about-identity-and-access-management-with-saml-single-sign-on) | **X** | | | -| [Manage a user's SAML access to your organization](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization) | **X** | | | -| Manage an organization's SSH certificate authorities (see "[Managing your organization's SSH certificate authorities](/articles/managing-your-organizations-ssh-certificate-authorities)" for details) | **X** | | | -| Transfer repositories | **X** | | | -| Purchase, install, manage billing for, and cancel {% data variables.product.prodname_marketplace %} apps | **X** | | | -| List apps in {% data variables.product.prodname_marketplace %} | **X** | | | -| Receive [{% data variables.product.prodname_dependabot_alerts %} about vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) for all of an organization's repositories | **X** | | | -| Manage {% data variables.product.prodname_dependabot_security_updates %} (see "[Configuring {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)") | **X** | | | -| [Manage the forking policy](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization) | **X** | | | -| [Limit activity in public repositories in an organization](/articles/limiting-interactions-in-your-organization) | **X** | | | -| Pull (read), push (write), and clone (copy) *all repositories* in the organization | **X** | | | -| Convert organization members to [outside collaborators](#outside-collaborators) | **X** | | | -| [View people with access to an organization repository](/articles/viewing-people-with-access-to-your-repository) | **X** | | | -| [Export a list of people with access to an organization repository](/articles/viewing-people-with-access-to-your-repository/#exporting-a-list-of-people-with-access-to-your-repository) | **X** | | | -| Manage default labels (see "[Managing default labels for repositories in your organization](/articles/managing-default-labels-for-repositories-in-your-organization)") | **X** | | | -| Enable team synchronization (see "[Managing team synchronization for your organization](/github/setting-up-and-managing-organizations-and-teams/managing-team-synchronization-for-your-organization)" for details) | **X** | | | +| Organization action | Owners | Members | Billing managers | +|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:------:|:-------:|:--------------------------------------------------:| +| Create repositories (see "[Restricting repository creation in your organization](/articles/restricting-repository-creation-in-your-organization)" for details) | **X** | **X** | | +| View and edit billing information | **X** | | **X** | +| Invite people to join the organization | **X** | | | +| Edit and cancel invitations to join the organization | **X** | | | +| Remove members from the organization | **X** | | | +| Reinstate former members to the organization | **X** | | | +| Add and remove people from **all teams** | **X** | | | +| Promote organization members to *team maintainer* | **X** | | | +| Configure code review assignments (see "[Managing code review assignment for your team](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)") | **X** | | | +| Set scheduled reminders (see "[Managing scheduled reminders for pull requests](/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests)") | **X** | | | +| Add collaborators to **all repositories** | **X** | | | +| Access the organization audit log | **X** | | | +| Edit the organization's profile page (see "[About your organization's profile](/articles/about-your-organization-s-profile)" for details) | **X** | | | +| Verify the organization's domains (see "[Verifying your organization's domain](/articles/verifying-your-organization-s-domain)" for details) | **X** | | | +| Delete **all teams** | **X** | | | +| Delete the organization account, including all repositories | **X** | | | +| Create teams (see "[Setting team creation permissions in your organization](/articles/setting-team-creation-permissions-in-your-organization)" for details) | **X** | **X** | | +| [Move teams in an organization's hierarchy](/articles/moving-a-team-in-your-organization-s-hierarchy) | **X** | | | +| Create project boards (see "[Project board permissions for an organization](/articles/project-board-permissions-for-an-organization)" for details) | **X** | **X** | | +| See all organization members and teams | **X** | **X** | | +| @mention any visible team | **X** | **X** | | +| Can be made a *team maintainer* | **X** | **X** | | +| View organization insights (see "[Viewing insights for your organization](/articles/viewing-insights-for-your-organization)" for details) | **X** | **X** | | +| View and post public team discussions to **all teams** (see "[About team discussions](/articles/about-team-discussions)" for details) | **X** | **X** | | +| View and post private team discussions to **all teams** (see "[About team discussions](/articles/about-team-discussions)" for details) | **X** | | | +| Edit and delete team discussions in **all teams** (see "[Managing disruptive comments](/articles/managing-disruptive-comments)" for details) | **X** | | | +| Hide comments on commits, pull requests, and issues (see "[Managing disruptive comments](/articles/managing-disruptive-comments/#hiding-a-comment)" for details) | **X** | **X** | | +| Disable team discussions for an organization (see "[Disabling team discussions for your organization](/articles/disabling-team-discussions-for-your-organization)" for details) | **X** | | |{% if currentVersion == "free-pro-team@latest" %} +| Manage viewing of organization dependency insights (see "[Changing the visibility of your organization's dependency insights](/articles/changing-the-visibility-of-your-organizations-dependency-insights)" for details) | **X** | | |{% endif %} +| Set a team profile picture in **all teams** (see "[Setting your team's profile picture](/articles/setting-your-team-s-profile-picture)" for details) | **X** | | | +| Disable publication of {% data variables.product.prodname_pages %} sites from repositories in the organization (see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)" for details) | **X** | | | +| Manage security and analysis settings (see "[Managing security and analysis settings for your organization](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization)" for details) | **X** | | | +| Enable and enforce [SAML single sign-on](/articles/about-identity-and-access-management-with-saml-single-sign-on) | **X** | | | +| [Manage a user's SAML access to your organization](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization) | **X** | | | +| Manage an organization's SSH certificate authorities (see "[Managing your organization's SSH certificate authorities](/articles/managing-your-organizations-ssh-certificate-authorities)" for details) | **X** | | | +| Transfer repositories | **X** | | | +| Purchase, install, manage billing for, and cancel {% data variables.product.prodname_marketplace %} apps | **X** | | | +| List apps in {% data variables.product.prodname_marketplace %} | **X** | | | +| Receive [{% data variables.product.prodname_dependabot_alerts %} about vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) for all of an organization's repositories | **X** | | | +| Manage {% data variables.product.prodname_dependabot_security_updates %} (see "[Configuring {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)") | **X** | | | +| [Manage the forking policy](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization) | **X** | | | +| [Limit activity in public repositories in an organization](/articles/limiting-interactions-in-your-organization) | **X** | | | +| Pull (read), push (write), and clone (copy) *all repositories* in the organization | **X** | | | +| Convert organization members to [outside collaborators](#outside-collaborators) | **X** | | | +| [View people with access to an organization repository](/articles/viewing-people-with-access-to-your-repository) | **X** | | | +| [Export a list of people with access to an organization repository](/articles/viewing-people-with-access-to-your-repository/#exporting-a-list-of-people-with-access-to-your-repository) | **X** | | | +| Manage the default branch name (see "[Managing the default branch name for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization)") | **X** | | | +| Manage default labels (see "[Managing default labels for repositories in your organization](/articles/managing-default-labels-for-repositories-in-your-organization)") | **X** | | | +| Enable team synchronization (see "[Managing team synchronization for your organization](/github/setting-up-and-managing-organizations-and-teams/managing-team-synchronization-for-your-organization)" for details) | **X** | | | {% else %} -| Organization action | Owners | Members | -|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:------:|:---------------------------------------:| -| Invite people to join the organization | **X** | | -| Edit and cancel invitations to join the organization | **X** | | -| Remove members from the organization | **X** | | | -| Reinstate former members to the organization | **X** | | | -| Add and remove people from **all teams** | **X** | | -| Promote organization members to *team maintainer* | **X** | |{% if currentVersion ver_gt "enterprise-server@2.19" %} -| Configure code review assignments (see "[Managing code review assignment for your team](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)") | **X** | |{% endif %} -| Add collaborators to **all repositories** | **X** | | -| Access the organization audit log | **X** | | -| Edit the organization's profile page (see "[About your organization's profile](/articles/about-your-organization-s-profile)" for details) | **X** | | | -| Delete **all teams** | **X** | | -| Delete the organization account, including all repositories | **X** | | -| Create teams (see "[Setting team creation permissions in your organization](/articles/setting-team-creation-permissions-in-your-organization)" for details) | **X** | **X** | -| See all organization members and teams | **X** | **X** | -| @mention any visible team | **X** | **X** | -| Can be made a *team maintainer* | **X** | **X** | -| Transfer repositories | **X** | |{% if currentVersion ver_gt "enterprise-server@2.18" %} -| Manage an organization's SSH certificate authorities (see "[Managing your organization's SSH certificate authorities](/articles/managing-your-organizations-ssh-certificate-authorities)" for details) | **X** | |{% endif %} -| Create project boards (see "[Project board permissions for an organization](/articles/project-board-permissions-for-an-organization)" for details) | **X** | **X** | | -| View and post public team discussions to **all teams** (see "[About team discussions](/articles/about-team-discussions)" for details) | **X** | **X** | | -| View and post private team discussions to **all teams** (see "[About team discussions](/articles/about-team-discussions)" for details) | **X** | | | -| Edit and delete team discussions in **all teams** (for more information, see "[Managing disruptive comments](/articles/managing-disruptive-comments) | **X** | | | -| Hide comments on commits, pull requests, and issues (see "[Managing disruptive comments](/articles/managing-disruptive-comments/#hiding-a-comment)" for details) | **X** | **X** | **X** | -| Disable team discussions for an organization (see "[Disabling team discussions for your organization](/articles/disabling-team-discussions-for-your-organization)" for details) | **X** | | | -| Set a team profile picture in **all teams** (see "[Setting your team's profile picture](/articles/setting-your-team-s-profile-picture)" for details) | **X** | | |{% if currentVersion ver_gt "enterprise-server@2.22" %} -| Disable publication of {% data variables.product.prodname_pages %} sites from repositories in the organization (see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)" for details) | **X** | | |{% endif %} -| [Move teams in an organization's hierarchy](/articles/moving-a-team-in-your-organization-s-hierarchy) | **X** | | | -| Pull (read), push (write), and clone (copy) *all repositories* in the organization | **X** | | -| Convert organization members to [outside collaborators](#outside-collaborators) | **X** | | -| [View people with access to an organization repository](/articles/viewing-people-with-access-to-your-repository) | **X** | | -| [Export a list of people with access to an organization repository](/articles/viewing-people-with-access-to-your-repository/#exporting-a-list-of-people-with-access-to-your-repository) | **X** | |{% if currentVersion ver_gt "enterprise-server@2.19" %} -| Manage default labels (see "[Managing default labels for repositories in your organization](/articles/managing-default-labels-for-repositories-in-your-organization)") | **X** | |{% endif %} +| Organization action | Owners | Members | +|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:------:|:-----------------------------------------------------------:| +| Invite people to join the organization | **X** | | +| Edit and cancel invitations to join the organization | **X** | | +| Remove members from the organization | **X** | | | +| Reinstate former members to the organization | **X** | | | +| Add and remove people from **all teams** | **X** | | +| Promote organization members to *team maintainer* | **X** | |{% if currentVersion ver_gt "enterprise-server@2.19" %} +| Configure code review assignments (see "[Managing code review assignment for your team](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)") | **X** | |{% endif %} +| Add collaborators to **all repositories** | **X** | | +| Access the organization audit log | **X** | | +| Edit the organization's profile page (see "[About your organization's profile](/articles/about-your-organization-s-profile)" for details) | **X** | | | +| Delete **all teams** | **X** | | +| Delete the organization account, including all repositories | **X** | | +| Create teams (see "[Setting team creation permissions in your organization](/articles/setting-team-creation-permissions-in-your-organization)" for details) | **X** | **X** | +| See all organization members and teams | **X** | **X** | +| @mention any visible team | **X** | **X** | +| Can be made a *team maintainer* | **X** | **X** | +| Transfer repositories | **X** | | +| Manage an organization's SSH certificate authorities (see "[Managing your organization's SSH certificate authorities](/articles/managing-your-organizations-ssh-certificate-authorities)" for details) | **X** | | +| Create project boards (see "[Project board permissions for an organization](/articles/project-board-permissions-for-an-organization)" for details) | **X** | **X** | | +| View and post public team discussions to **all teams** (see "[About team discussions](/articles/about-team-discussions)" for details) | **X** | **X** | | +| View and post private team discussions to **all teams** (see "[About team discussions](/articles/about-team-discussions)" for details) | **X** | | | +| Edit and delete team discussions in **all teams** (for more information, see "[Managing disruptive comments](/articles/managing-disruptive-comments) | **X** | | | +| Hide comments on commits, pull requests, and issues (see "[Managing disruptive comments](/articles/managing-disruptive-comments/#hiding-a-comment)" for details) | **X** | **X** | **X** | +| Disable team discussions for an organization (see "[Disabling team discussions for your organization](/articles/disabling-team-discussions-for-your-organization)" for details) | **X** | | | +| Set a team profile picture in **all teams** (see "[Setting your team's profile picture](/articles/setting-your-team-s-profile-picture)" for details) | **X** | | |{% if currentVersion ver_gt "enterprise-server@2.22" %} +| Disable publication of {% data variables.product.prodname_pages %} sites from repositories in the organization (see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)" for details) | **X** | | |{% endif %} +| [Move teams in an organization's hierarchy](/articles/moving-a-team-in-your-organization-s-hierarchy) | **X** | | | +| Pull (read), push (write), and clone (copy) *all repositories* in the organization | **X** | | +| Convert organization members to [outside collaborators](#outside-collaborators) | **X** | | +| [View people with access to an organization repository](/articles/viewing-people-with-access-to-your-repository) | **X** | | +| [Export a list of people with access to an organization repository](/articles/viewing-people-with-access-to-your-repository/#exporting-a-list-of-people-with-access-to-your-repository) | **X** | |{% if currentVersion ver_gt "enterprise-server@2.19" %} +| Manage default labels (see "[Managing default labels for repositories in your organization](/articles/managing-default-labels-for-repositories-in-your-organization)") | **X** | |{% endif %} {% endif %} diff --git a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md index 7981fc8dc0c0..76bfbbba3b34 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md @@ -24,7 +24,9 @@ For more information about {% data variables.product.prodname_github_app %} mana {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.github-apps-settings-sidebar %} -1. Under "{% data variables.product.prodname_github_app %}s", click on the avatar of the app you'd like to remove a {% data variables.product.prodname_github_app %} manager from. ![Select {% data variables.product.prodname_github_app %}](/assets/images/help/organizations/select-github-app.png) +1. Under " +{% data variables.product.prodname_github_app %}s", click on the avatar of the app you'd like to remove a {% data variables.product.prodname_github_app %} manager from. +![Select {% data variables.product.prodname_github_app %}](/assets/images/help/organizations/select-github-app.png) {% data reusables.organizations.app-managers-settings-sidebar %} 1. Under "App managers", find the username of the person you want to remove {% data variables.product.prodname_github_app %} manager permissions from, and click **Revoke**. ![Revoke {% data variables.product.prodname_github_app %} manager permissions](/assets/images/help/organizations/github-app-manager-revoke-permissions-individual-app.png) diff --git a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md index 852292c32571..528dda2e61ea 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md @@ -16,10 +16,10 @@ People with admin permissions can manage individual and team access to an organi You can give organization members, outside collaborators, and teams of people different levels of access to repositories owned by an organization. Each permission level progressively increases access to a repository's content and settings. Choose the level that best fits each person or team's role in your project without giving people more access to the project than they need. From least access to most access, the permission levels for an organization repository are: -- **Read**: Recommended for non-code contributors who want to view or discuss your project{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -- **Triage**: Recommended for contributors who need to proactively manage issues and pull requests without write access{% endif %} -- **Write**: Recommended for contributors who actively push to your project{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -- **Maintain**: Recommended for project managers who need to manage the repository without access to sensitive or destructive actions{% endif %} +- **Read**: Recommended for non-code contributors who want to view or discuss your project +- **Triage**: Recommended for contributors who need to proactively manage issues and pull requests without write access +- **Write**: Recommended for contributors who actively push to your project +- **Maintain**: Recommended for project managers who need to manage the repository without access to sensitive or destructive actions - **Admin**: Recommended for people who need full access to the project, including sensitive and destructive actions like managing security or deleting a repository {% if currentVersion == "free-pro-team@latest" %} @@ -41,135 +41,75 @@ In addition to managing organization-level settings, organization owners have ad {% endwarning %} ### Repository access for each permission level -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -| Repository action | Read | Приоритизация | Write | Maintain | Admin | -|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-----:|:-------------:|:-----:|:--------:|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------:| -| Pull from the person or team's assigned repositories | **X** | **X** | **X** | **X** | **X** | -| Fork the person or team's assigned repositories | **X** | **X** | **X** | **X** | **X** | -| Edit and delete their own comments | **X** | **X** | **X** | **X** | **X** | -| Open issues | **X** | **X** | **X** | **X** | **X** | -| Close issues they opened themselves | **X** | **X** | **X** | **X** | **X** | -| Reopen issues they closed themselves | **X** | **X** | **X** | **X** | **X** | -| Have an issue assigned to them | **X** | **X** | **X** | **X** | **X** | -| Send pull requests from forks of the team's assigned repositories | **X** | **X** | **X** | **X** | **X** | -| Submit reviews on pull requests | **X** | **X** | **X** | **X** | **X** | + +| Repository action | Read | Приоритизация | Write | Maintain | Admin | +|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-----:|:-------------:|:-----:|:--------:|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:| +| Pull from the person or team's assigned repositories | **X** | **X** | **X** | **X** | **X** | +| Fork the person or team's assigned repositories | **X** | **X** | **X** | **X** | **X** | +| Edit and delete their own comments | **X** | **X** | **X** | **X** | **X** | +| Open issues | **X** | **X** | **X** | **X** | **X** | +| Close issues they opened themselves | **X** | **X** | **X** | **X** | **X** | +| Reopen issues they closed themselves | **X** | **X** | **X** | **X** | **X** | +| Have an issue assigned to them | **X** | **X** | **X** | **X** | **X** | +| Send pull requests from forks of the team's assigned repositories | **X** | **X** | **X** | **X** | **X** | +| Submit reviews on pull requests | **X** | **X** | **X** | **X** | **X** | | View published releases | **X** | **X** | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| View [GitHub Actions workflow runs](/actions/automating-your-workflow-with-github-actions/managing-a-workflow-run) | **X** | **X** | **X** | **X** | **X** |{% endif %} +| View [GitHub Actions workflow runs](/actions/automating-your-workflow-with-github-actions/managing-a-workflow-run) | **X** | **X** | **X** | **X** | **X** |{% endif %} | Edit wikis | **X** | **X** | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [Report abusive or spammy content](/articles/reporting-abuse-or-spam) | **X** | **X** | **X** | **X** | **X** |{% endif %} -| Apply labels | | **X** | **X** | **X** | **X** | -| Close, reopen, and assign all issues and pull requests | | **X** | **X** | **X** | **X** | -| Apply milestones | | **X** | **X** | **X** | **X** | -| Mark [duplicate issues and pull requests](/articles/about-duplicate-issues-and-pull-requests) | | **X** | **X** | **X** | **X** | -| Request [pull request reviews](/articles/requesting-a-pull-request-review) | | **X** | **X** | **X** | **X** | -| Push to (write) the person or team's assigned repositories | | | **X** | **X** | **X** | -| Edit and delete anyone's comments on commits, pull requests, and issues | | | **X** | **X** | **X** | -| [Hide anyone's comments](/articles/managing-disruptive-comments) | | | **X** | **X** | **X** | -| [Lock conversations](/articles/locking-conversations) | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| Transfer issues (see "[Transferring an issue to another repository](/articles/transferring-an-issue-to-another-repository)" for details) | | | **X** | **X** | **X** |{% endif %} -| [Act as a designated code owner for a repository](/articles/about-code-owners) | | | **X** | **X** | **X** | -| [Mark a draft pull request as ready for review](/articles/changing-the-stage-of-a-pull-request) | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -| [Convert a pull request to a draft](/articles/changing-the-stage-of-a-pull-request) | | | **X** | **X** | **X** |{% endif %} -| Submit reviews that affect a pull request's mergeability | | | **X** | **X** | **X** | -| [Apply suggested changes](/articles/incorporating-feedback-in-your-pull-request) to pull requests | | | **X** | **X** | **X** | +| [Report abusive or spammy content](/articles/reporting-abuse-or-spam) | **X** | **X** | **X** | **X** | **X** |{% endif %} +| Apply labels | | **X** | **X** | **X** | **X** | +| Close, reopen, and assign all issues and pull requests | | **X** | **X** | **X** | **X** | +| Apply milestones | | **X** | **X** | **X** | **X** | +| Mark [duplicate issues and pull requests](/articles/about-duplicate-issues-and-pull-requests) | | **X** | **X** | **X** | **X** | +| Request [pull request reviews](/articles/requesting-a-pull-request-review) | | **X** | **X** | **X** | **X** | +| Push to (write) the person or team's assigned repositories | | | **X** | **X** | **X** | +| Edit and delete anyone's comments on commits, pull requests, and issues | | | **X** | **X** | **X** | +| [Hide anyone's comments](/articles/managing-disruptive-comments) | | | **X** | **X** | **X** | +| [Lock conversations](/articles/locking-conversations) | | | **X** | **X** | **X** | +| Transfer issues (see "[Transferring an issue to another repository](/articles/transferring-an-issue-to-another-repository)" for details) | | | **X** | **X** | **X** | +| [Act as a designated code owner for a repository](/articles/about-code-owners) | | | **X** | **X** | **X** | +| [Mark a draft pull request as ready for review](/articles/changing-the-stage-of-a-pull-request) | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +| [Convert a pull request to a draft](/articles/changing-the-stage-of-a-pull-request) | | | **X** | **X** | **X** |{% endif %} +| Submit reviews that affect a pull request's mergeability | | | **X** | **X** | **X** | +| [Apply suggested changes](/articles/incorporating-feedback-in-your-pull-request) to pull requests | | | **X** | **X** | **X** | | Create [status checks](/articles/about-status-checks) | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| Create, edit, run, re-run, and cancel [GitHub Actions workflows](/actions/automating-your-workflow-with-github-actions/) | | | **X** | **X** | **X** |{% endif %} -| Create and edit releases | | | **X** | **X** | **X** | -| View draft releases | | | **X** | **X** | **X** | +| Create, edit, run, re-run, and cancel [GitHub Actions workflows](/actions/automating-your-workflow-with-github-actions/) | | | **X** | **X** | **X** |{% endif %} +| Create and edit releases | | | **X** | **X** | **X** | +| View draft releases | | | **X** | **X** | **X** | | Edit a repository's description | | | | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [View and install packages](/packages/publishing-and-managing-packages) | **X** | **X** | **X** | **X** | **X** | -| [Publish packages](/packages/publishing-and-managing-packages/publishing-a-package) | | | **X** | **X** | **X** | -| [Delete packages](/packages/publishing-and-managing-packages/deleting-a-package) | | | | | **X** |{% endif %} -| Manage [topics](/articles/classifying-your-repository-with-topics) | | | | **X** | **X** | -| Enable wikis and restrict wiki editors | | | | **X** | **X** | -| Enable project boards | | | | **X** | **X** | -| Configure [pull request merges](/articles/configuring-pull-request-merges) | | | | **X** | **X** | -| Configure [a publishing source for {% data variables.product.prodname_pages %}](/articles/configuring-a-publishing-source-for-github-pages) | | | | **X** | **X** | -| [Push to protected branches](/articles/about-protected-branches) | | | | **X** | **X** | +| [View and install packages](/packages/publishing-and-managing-packages) | **X** | **X** | **X** | **X** | **X** | +| [Publish packages](/packages/publishing-and-managing-packages/publishing-a-package) | | | **X** | **X** | **X** | +| [Delete packages](/packages/publishing-and-managing-packages/deleting-a-package) | | | | | **X** |{% endif %} +| Manage [topics](/articles/classifying-your-repository-with-topics) | | | | **X** | **X** | +| Enable wikis and restrict wiki editors | | | | **X** | **X** | +| Enable project boards | | | | **X** | **X** | +| Configure [pull request merges](/articles/configuring-pull-request-merges) | | | | **X** | **X** | +| Configure [a publishing source for {% data variables.product.prodname_pages %}](/articles/configuring-a-publishing-source-for-github-pages) | | | | **X** | **X** | +| [Push to protected branches](/articles/about-protected-branches) | | | | **X** | **X** | | [Create and edit repository social cards](/articles/customizing-your-repositorys-social-media-preview) | | | | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| Limit [interactions in a repository](/github/building-a-strong-community/limiting-interactions-in-your-repository) | | | | **X** | **X** |{% endif %} -| Delete an issue (see "[Deleting an issue](/articles/deleting-an-issue)") | | | | | **X** | -| Merge pull requests on protected branches, even if there are no approving reviews | | | | | **X** | -| [Define code owners for a repository](/articles/about-code-owners) | | | | | **X** | -| Add a repository to a team (see "[Managing team access to an organization repository](/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository#giving-a-team-access-to-a-repository)" for details) | | | | | **X** | -| [Manage outside collaborator access to a repository](/articles/adding-outside-collaborators-to-repositories-in-your-organization) | | | | | **X** | -| [Change a repository's visibility](/articles/restricting-repository-visibility-changes-in-your-organization) | | | | | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| Make a repository a template (see "[Creating a template repository](/articles/creating-a-template-repository)") | | | | | **X** |{% endif %} -| Change a repository's settings | | | | | **X** | -| Manage team and collaborator access to the repository | | | | | **X** | -| Edit the repository's default branch | | | | | **X** | +| Limit [interactions in a repository](/github/building-a-strong-community/limiting-interactions-in-your-repository) | | | | **X** | **X** |{% endif %} +| Delete an issue (see "[Deleting an issue](/articles/deleting-an-issue)") | | | | | **X** | +| Merge pull requests on protected branches, even if there are no approving reviews | | | | | **X** | +| [Define code owners for a repository](/articles/about-code-owners) | | | | | **X** | +| Add a repository to a team (see "[Managing team access to an organization repository](/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository#giving-a-team-access-to-a-repository)" for details) | | | | | **X** | +| [Manage outside collaborator access to a repository](/articles/adding-outside-collaborators-to-repositories-in-your-organization) | | | | | **X** | +| [Change a repository's visibility](/articles/restricting-repository-visibility-changes-in-your-organization) | | | | | **X** | +| Make a repository a template (see "[Creating a template repository](/articles/creating-a-template-repository)") | | | | | **X** | +| Change a repository's settings | | | | | **X** | +| Manage team and collaborator access to the repository | | | | | **X** | +| Edit the repository's default branch | | | | | **X** | | Manage webhooks and deploy keys | | | | | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [Enable the dependency graph](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) for a private repository | | | | | **X** | -| Receive [{% data variables.product.prodname_dependabot_alerts %} for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in a repository | | | | | **X** | -| [Dismiss {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository) | | | | | **X** | -| [Designate additional people or teams to receive {% data variables.product.prodname_dependabot_alerts %}](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository) for vulnerable dependencies | | | | | **X** | +| [Enable the dependency graph](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) for a private repository | | | | | **X** | +| Receive [{% data variables.product.prodname_dependabot_alerts %} for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in a repository | | | | | **X** | +| [Dismiss {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository) | | | | | **X** | +| [Designate additional people or teams to receive {% data variables.product.prodname_dependabot_alerts %}](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository) for vulnerable dependencies | | | | | **X** | | [Manage data use settings for your private repository](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository) | | | | | **X** |{% endif %}{% if currentVersion == "free-pro-team@latest" %}| Create [security advisories](/github/managing-security-vulnerabilities/about-github-security-advisories) | | | | | **X** |{% endif %} -| [Manage the forking policy for a repository](/github/administering-a-repository/managing-the-forking-policy-for-your-repository) | | | | | **X** | -| [Transfer repositories into the organization](/articles/restricting-repository-creation-in-your-organization) | | | | | **X** | -| [Delete or transfer repositories out of the organization](/articles/setting-permissions-for-deleting-or-transferring-repositories) | | | | | **X** | +| [Manage the forking policy for a repository](/github/administering-a-repository/managing-the-forking-policy-for-your-repository) | | | | | **X** | +| [Transfer repositories into the organization](/articles/restricting-repository-creation-in-your-organization) | | | | | **X** | +| [Delete or transfer repositories out of the organization](/articles/setting-permissions-for-deleting-or-transferring-repositories) | | | | | **X** | | [Archive repositories](/articles/about-archiving-repositories) | | | | | **X** |{% if currentVersion == "free-pro-team@latest" %} -| Display a sponsor button (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)") | | | | | **X** |{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -| Create autolink references to external resources, like JIRA or Zendesk (see "[Configuring autolinks to reference external resources](/articles/configuring-autolinks-to-reference-external-resources)") | | | | | **X** |{% endif %} - -{% else %} - -| Repository action | Read permissions | Write permissions | Admin permissions | -|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:----------------:|:-----------------:|:----------------------------------------------------------------------:| -| Pull from (read) the person or team's assigned repositories | **X** | **X** | **X** | -| Fork (copy) the person or team's assigned repositories | **X** | **X** | **X** | -| Edit and delete their own comments on commits, pull requests, and issues | **X** | **X** | **X** | -| Open issues | **X** | **X** | **X** | -| Close issues they opened themselves | **X** | **X** | **X** | -| Reopen issues they closed themselves | **X** | **X** | **X** | -| Have an issue assigned to them | **X** | **X** | **X** | -| Send pull requests from forks of the team's assigned repositories | **X** | **X** | **X** | -| Submit reviews on pull requests | **X** | **X** | **X** | -| View published releases | **X** | **X** | **X** | -| Edit wikis | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [Report abusive or spammy content](/articles/reporting-abuse-or-spam) | **X** | **X** | **X** |{% endif %} -| Push to (write) the person or team's assigned repositories | | **X** | **X** | -| Edit and delete anyone's comments on commits, pull requests, and issues | | **X** | **X** | -| [Hide anyone's comments](/articles/managing-disruptive-comments) | | **X** | **X** | -| [Lock conversations](/articles/locking-conversations) | | **X** | **X** | -| Apply labels and milestones | | **X** | **X** | -| Close, reopen, and assign all issues | | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| Mark [duplicate issues and pull requests](/articles/about-duplicate-issues-and-pull-requests) | | **X** | **X** |{% endif %} -| [Act as a designated code owner for a repository](/articles/about-code-owners) | | **X** | **X** | -| [Mark a draft pull request as ready for review](/articles/changing-the-stage-of-a-pull-request) | | **X** | **X** | -| Request [pull request reviews](/articles/requesting-a-pull-request-review) | | **X** | **X** | -| Submit reviews that affect a pull request's mergeability | | **X** | **X** | -| Apply suggested changes to pull requests (see "[Incorporating feedback in your pull request](/articles/incorporating-feedback-in-your-pull-request)" for details) | | **X** | **X** | -| Create [status checks](/articles/about-status-checks) | | **X** | **X** | -| Create and edit releases | | **X** | **X** | -| View draft releases | | **X** | **X** | -| Delete an issue (see "[Deleting an issue](/articles/deleting-an-issue)") | | | **X** | -| Merge pull requests on protected branches, even if there are no approving reviews | | | **X** | -| [Define code owners for a repository](/articles/about-code-owners) | | | **X** | -| Edit a repository's description | | | **X** | -| Manage [topics](/articles/classifying-your-repository-with-topics) | | | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| Create and edit repository social cards (see "[Customizing your repository's social media preview](/articles/customizing-your-repositorys-social-media-preview)" for details) | | | **X** |{% endif %} -| Add a repository to a team (see "[Managing team access to an organization repository](/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository#giving-a-team-access-to-a-repository)" for details) | | | **X** | -| Manage outside collaborator access to a repository (see "[Adding outside collaborators to repositories in your organization](/articles/adding-outside-collaborators-to-repositories-in-your-organization)" for details) | | | **X** |{% if currentVersion == "free-pro-team@latest" %} -| Limit [interactions in a repository](/github/building-a-strong-community/limiting-interactions-in-your-repository) | | | **X** |{% endif %} -| Change a repository's visibility (see "[Restricting repository visibility changes in your organization](/articles/restricting-repository-visibility-changes-in-your-organization)" for details) | | | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| Make a repository a template (see "[Creating a template repository](/articles/creating-a-template-repository)") | | | | | **X** |{% endif %} -| Change a repository's settings | | | **X** | -| Manage team and collaborator access to the repository | | | **X** | -| Edit the repository's default branch | | | **X** | -| Manage webhooks and deploy keys | | | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [Enable the dependency graph](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) for a private repository | | | **X** | -| Receive [{% data variables.product.prodname_dependabot_alerts %} for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in a repository | | | **X** | -| [Dismiss {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository) | | | **X** | -| [Designate additional people or teams to receive {% data variables.product.prodname_dependabot_alerts %}](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-github-dependabot-alerts) for vulnerable dependencies | | | **X** | -| [Manage data use settings for your private repository](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository) | | | **X** |{% endif %}{% if currentVersion == "free-pro-team@latest" %} -| Create [security advisories](/github/managing-security-vulnerabilities/about-github-security-advisories)") | | | **X** |{% endif %} -| [Manage the forking policy for a repository](/github/administering-a-repository/managing-the-forking-policy-for-your-repository) | | | **X** | -| Transfer repositories into the organization account (see "[Restricting repository creation in your organization](/articles/restricting-repository-creation-in-your-organization)" for details) | | | **X** | -| Delete or transfer repositories (see "[Setting permissions for deleting or transferring repositories in your organization](/articles/setting-permissions-for-deleting-or-transferring-repositories)" for details) | | | **X** | -| [Archive repositories](/articles/about-archiving-repositories) | | | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -| Create autolink references to external resources, like JIRA or Zendesk (see "[Configuring autolinks to reference external resources](/articles/configuring-autolinks-to-reference-external-resources)" | | | | | **X** |{% endif %} - -{% endif %} +| Display a sponsor button (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)") | | | | | **X** |{% endif %} +| Create autolink references to external resources, like JIRA or Zendesk (see "[Configuring autolinks to reference external resources](/articles/configuring-autolinks-to-reference-external-resources)") | | | | | **X** | ### Дополнительная литература diff --git a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md index 5a968e326320..48ab6148925b 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md @@ -8,11 +8,15 @@ versions: enterprise-server: '*' --- -{% data reusables.two_fa.auth_methods_2fa %} +### About two-factor authentication for organizations + +{% data reusables.two_fa.about-2fa %} You can require all {% if currentVersion == "free-pro-team@latest" %}members, outside collaborators, and billing managers{% else %}members and outside collaborators{% endif %} in your organization to enable two-factor authentication on {% data variables.product.product_name %}. For more information about two-factor authentication, see "[Securing your account with two-factor authentication (2FA)](/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa)." -### Requirements for enforcing two-factor authentication +{% if currentVersion == "free-pro-team@latest" %} -Before you can require {% if currentVersion == "free-pro-team@latest" %}organization members, outside collaborators, and billing managers{% else %}organization members and outside collaborators{% endif %} to use 2FA, you must [enable two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa/) for your own personal account. +You can also require two-factor authentication for organizations in an enterprise. For more information, see "[Enforcing security settings in your enterprise account](/github/setting-up-and-managing-your-enterprise-account/enforcing-security-settings-in-your-enterprise-account#requiring-two-factor-authentication-for-organizations-in-your-enterprise-account)." + +{% endif %} {% warning %} @@ -24,7 +28,15 @@ Before you can require {% if currentVersion == "free-pro-team@latest" %}organiza {% endwarning %} -Before you require use of two-factor authentication, we recommend notifying {% if currentVersion == "free-pro-team@latest" %}organization members, outside collaborators, and billing managers{% else %}organization members and outside collaborators{% endif %} and asking them to set up 2FA for their accounts. You can [see if members and outside collaborators already use 2FA](/articles/viewing-whether-users-in-your-organization-have-2fa-enabled) on your organization's People page. +{% data reusables.two_fa.auth_methods_2fa %} + +### Требования + +Before you can require {% if currentVersion == "free-pro-team@latest" %}organization members, outside collaborators, and billing managers{% else %}organization members and outside collaborators{% endif %} to use two-factor authentication, you must enable two-factor authentication for your account on {% data variables.product.product_name %}. For more information, see "[Securing your account with two-factor authentication (2FA)](/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa)." + +Before you require use of two-factor authentication, we recommend notifying {% if currentVersion == "free-pro-team@latest" %}organization members, outside collaborators, and billing managers{% else %}organization members and outside collaborators{% endif %} and asking them to set up 2FA for their accounts. You can see if members and outside collaborators already use 2FA. For more information, see "[Viewing whether users in your organization have 2FA enabled](/github/setting-up-and-managing-organizations-and-teams/viewing-whether-users-in-your-organization-have-2fa-enabled)." + +### Requiring two-factor authentication in your organization {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} diff --git a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md index 8132cfc396aa..1dddaa9bb08a 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md @@ -26,5 +26,5 @@ Organization owners can always create any type of repository. {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.member-privileges %} -5. Under "Repository creation", select {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}one or more options{% else %}a setting{% endif %}. ![Repository creation options](/assets/images/help/organizations/repo-creation-perms-radio-buttons.png) +5. Under "Repository creation", select one or more options. ![Repository creation options](/assets/images/help/organizations/repo-creation-perms-radio-buttons.png) 6. Click **Save**. diff --git a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md index 68648f32860c..dddddc5062c7 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md @@ -25,31 +25,31 @@ The audit log lists actions performed within the last 90 days. Only owners can a To search for specific events, use the `action` qualifier in your query. Actions listed in the audit log are grouped within the following categories: -| Category Name | Description | -| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |{% if currentVersion == "free-pro-team@latest" %} -| `учетная запись` | Contains all activities related to your organization account.{% endif %}{% if currentVersion == "free-pro-team@latest" %} -| `биллинг` | Contains all activities related to your organization's billing.{% endif %} -| `discussion_post` | Contains all activities related to discussions posted to a team page. | -| `discussion_post_reply` | Contains all activities related to replies to discussions posted to a team page. | -| `хук` | Contains all activities related to webhooks. | -| `integration_installation_request` | Contains all activities related to organization member requests for owners to approve integrations for use in the organization. |{% if currentVersion == "free-pro-team@latest" %} -| `marketplace_agreement_signature` | Contains all activities related to signing the {% data variables.product.prodname_marketplace %} Developer Agreement. | -| `marketplace_listing` | Contains all activities related to listing apps in {% data variables.product.prodname_marketplace %}.{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -| `members_can_create_pages` | Contains all activities related to disabling the publication of {% data variables.product.prodname_pages %} sites for repositories in the organization. For more information, see "[Restricting publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)." |{% endif %} -| `org` | Contains all activities related to organization membership{% if currentVersion == "free-pro-team@latest" %} -| `org_credential_authorization` | Contains all activities related to authorizing credentials for use with SAML single sign-on.{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -| `organization_label` | Contains all activities related to default labels for repositories in your organization.{% endif %}{% if currentVersion == "free-pro-team@latest" %} -| `payment_method` | Contains all activities related to how your organization pays for GitHub.{% endif %} -| `profile_picture` | Contains all activities related to your organization's profile picture. | -| `проект` | Contains all activities related to project boards. | -| `protected_branch` | Contains all activities related to protected branches. | -| `repo` | Contains all activities related to the repositories owned by your organization.{% if currentVersion == "free-pro-team@latest" %} -| `repository_content_analysis` | Contains all activities related to [enabling or disabling data use for a private repository](/articles/about-github-s-use-of-your-data). | -| `repository_dependency_graph` | Contains all activities related to [enabling or disabling the dependency graph for a private repository](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository).{% endif %} -| `repository_vulnerability_alert` | Contains all activities related to [{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies).{% if currentVersion == "free-pro-team@latest" %} -| `sponsors` | Contains all events related to sponsor buttons (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)"){% endif %}{% if currentVersion != "free-pro-team@latest" %} -| `команда` | Contains all activities related to teams in your organization.{% endif %} -| `team_discussions` | Contains activities related to managing team discussions for an organization. | +| Category Name | Description | +| ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" %} +| `учетная запись` | Contains all activities related to your organization account.{% endif %}{% if currentVersion == "free-pro-team@latest" %} +| `выставление счетов` | Contains all activities related to your organization's billing.{% endif %} +| `discussion_post` | Contains all activities related to discussions posted to a team page. | +| `discussion_post_reply` | Contains all activities related to replies to discussions posted to a team page. | +| `перехватчик` | Contains all activities related to webhooks. | +| `integration_installation_request` | Contains all activities related to organization member requests for owners to approve integrations for use in the organization. |{% if currentVersion == "free-pro-team@latest" %} +| `marketplace_agreement_signature` | Contains all activities related to signing the {% data variables.product.prodname_marketplace %} Developer Agreement. | +| `marketplace_listing` | Contains all activities related to listing apps in {% data variables.product.prodname_marketplace %}.{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +| `members_can_create_pages` | Contains all activities related to disabling the publication of {% data variables.product.prodname_pages %} sites for repositories in the organization. For more information, see "[Restricting publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)." |{% endif %} +| `org` | Contains all activities related to organization membership{% if currentVersion == "free-pro-team@latest" %} +| `org_credential_authorization` | Contains all activities related to authorizing credentials for use with SAML single sign-on.{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} +| `organization_label` | Contains all activities related to default labels for repositories in your organization.{% endif %}{% if currentVersion == "free-pro-team@latest" %} +| `payment_method` | Contains all activities related to how your organization pays for GitHub.{% endif %} +| `profile_picture` | Contains all activities related to your organization's profile picture. | +| `проект` | Contains all activities related to project boards. | +| `protected_branch` | Contains all activities related to protected branches. | +| `repo` | Contains all activities related to the repositories owned by your organization.{% if currentVersion == "free-pro-team@latest" %} +| `repository_content_analysis` | Contains all activities related to [enabling or disabling data use for a private repository](/articles/about-github-s-use-of-your-data). | +| `repository_dependency_graph` | Contains all activities related to [enabling or disabling the dependency graph for a private repository](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository).{% endif %} +| `repository_vulnerability_alert` | Contains all activities related to [{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies).{% if currentVersion == "free-pro-team@latest" %} +| `sponsors` | Contains all events related to sponsor buttons (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)"){% endif %}{% if currentVersion != "free-pro-team@latest" %} +| `команда` | Contains all activities related to teams in your organization.{% endif %} +| `team_discussions` | Contains activities related to managing team discussions for an organization. | You can search for specific sets of actions using these terms. Например: @@ -98,14 +98,14 @@ This list describes the available categories and associated events: | `billing_plan_change` | Triggered when an organization's [billing cycle](/articles/changing-the-duration-of-your-billing-cycle) changes. | | `plan_change` | Triggered when an organization's [subscription](/articles/about-billing-for-github-accounts) changes. | | `pending_plan_change` | Triggered when an organization owner or billing manager [cancels or downgrades a paid subscription](/articles/how-does-upgrading-or-downgrading-affect-the-billing-process/). | -| `pending_subscription_change` | Triggered when a [{% data variables.product.prodname_marketplace %} free trial starts or expires](/articles/about-billing-for-github-marketplace/). | +| `pending_subscription_change` | Triggered when a [{% data variables.product.prodname_marketplace %} free trial starts or expires](/articles/about-billing-for-github-marketplace/). | ##### The `billing` category -| Действие | Description | -| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Действие | Description | +| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | `change_billing_type` | Triggered when your organization [changes how it pays for {% data variables.product.prodname_dotcom %}](/articles/adding-or-editing-a-payment-method). | -| `change_email` | Triggered when your organization's [billing email address](/articles/setting-your-billing-email) changes. | +| `change_email` | Triggered when your organization's [billing email address](/articles/setting-your-billing-email) changes. | {% endif %} @@ -149,18 +149,18 @@ This list describes the available categories and associated events: ##### The `marketplace_agreement_signature` category -| Действие | Description | -| -------- | ------------------------------------------------------------------------------------------------------- | +| Действие | Description | +| -------- | -------------------------------------------------------------------------------------------------- | | `create` | Triggered when you sign the {% data variables.product.prodname_marketplace %} Developer Agreement. | ##### The `marketplace_listing` category -| Действие | Description | -| ----------- | -------------------------------------------------------------------------------------------------------------------- | +| Действие | Description | +| ----------- | --------------------------------------------------------------------------------------------------------------- | | `утвердить` | Triggered when your listing is approved for inclusion in {% data variables.product.prodname_marketplace %}. | | `create` | Triggered when you create a listing for your app in {% data variables.product.prodname_marketplace %}. | | `delist` | Triggered when your listing is removed from {% data variables.product.prodname_marketplace %}. | -| `redraft` | Triggered when your listing is sent back to draft state. | +| `redraft` | Triggered when your listing is sent back to draft state. | | `reject` | Triggered when your listing is not accepted for inclusion in {% data variables.product.prodname_marketplace %}. | {% endif %} @@ -171,43 +171,44 @@ This list describes the available categories and associated events: For more information, see "[Restricting publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)." -| Действие | Description | -|:---------------- |:--------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `активировать` | Triggered when an organization owner enables publication of {% data variables.product.prodname_pages %} sites for repositories in the organization. | -| `деактивировать` | Triggered when an organization owner disables publication of {% data variables.product.prodname_pages %} sites for repositories in the organization. | +| Действие | Description | +|:----------- |:---------------------------------------------------------------------------------------------------------------------------------------------------- | +| `включить` | Triggered when an organization owner enables publication of {% data variables.product.prodname_pages %} sites for repositories in the organization. | +| `отключить` | Triggered when an organization owner disables publication of {% data variables.product.prodname_pages %} sites for repositories in the organization. | {% endif %} ##### The `org` category -| Действие | Description | -| ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest"%} -| `audit_log_export` | Triggered when an organization admin [creates an export of the organization audit log](#exporting-the-audit-log). If the export included a query, the log will list the query used and the number of audit log entries matching that query. | -| `block_user` | Triggered when an organization owner [blocks a user from accessing the organization's repositories](/articles/blocking-a-user-from-your-organization). | -| `cancel_invitation` | Triggered when an organization invitation has been revoked. | -| `disable_oauth_app_restrictions` | Triggered when an owner [disables {% data variables.product.prodname_oauth_app %} access restrictions](/articles/disabling-oauth-app-access-restrictions-for-your-organization) for your organization. | -| `disable_saml` | Triggered when an organization admin disables SAML single sign-on for an organization.{% endif %} -| `disable_member_team_creation_permission` | Triggered when an organization owner limits team creation to owners. For more information, see "[Setting team creation permissions in your organization](/articles/setting-team-creation-permissions-in-your-organization)." | -| `disable_two_factor_requirement` | Triggered when an owner disables a two-factor authentication requirement for all members{% if currentVersion == "free-pro-team@latest" %}, billing managers,{% endif %} and outside collaborators in an organization.{% if currentVersion == "free-pro-team@latest" %} -| `enable_oauth_app_restrictions` | Triggered when an owner [enables {% data variables.product.prodname_oauth_app %} access restrictions](/articles/enabling-oauth-app-access-restrictions-for-your-organization) for your organization. | -| `enable_saml` | Triggered when an organization admin [enables SAML single sign-on](/articles/enabling-and-testing-saml-single-sign-on-for-your-organization) for an organization.{% endif %} -| `enable_member_team_creation_permission` | Triggered when an organization owner allows members to create teams. For more information, see "[Setting team creation permissions in your organization](/articles/setting-team-creation-permissions-in-your-organization)." | -| `enable_two_factor_requirement` | Triggered when an owner requires two-factor authentication for all members{% if currentVersion == "free-pro-team@latest" %}, billing managers,{% endif %} and outside collaborators in an organization. | -| `invite_member` | Triggered when [a new user was invited to join your organization](/articles/adding-organization-members-to-a-team).{% if currentVersion == "free-pro-team@latest" %} -| `oauth_app_access_approved` | Triggered when an owner [grants organization access to an {% data variables.product.prodname_oauth_app %}](/articles/approving-oauth-apps-for-your-organization/). | -| `oauth_app_access_denied` | Triggered when an owner [disables a previously approved {% data variables.product.prodname_oauth_app %}'s access](/articles/denying-access-to-a-previously-approved-oauth-app-for-your-organization) to your organization. | -| `oauth_app_access_requested` | Triggered when an organization member requests that an owner grant an {% data variables.product.prodname_oauth_app %} access to your organization.{% endif %}{% if currentVersion == "free-pro-team@latest" %} -| `remove_billing_manager` | Triggered when an [owner removes a billing manager from an organization](/articles/removing-a-billing-manager-from-your-organization/) or when [two-factor authentication is required in an organization](/articles/requiring-two-factor-authentication-in-your-organization) and a billing manager doesn't use 2FA or disables 2FA. |{% endif %} -| `remove_member` | Triggered when an [owner removes a member from an organization](/articles/removing-a-member-from-your-organization/) or when [two-factor authentication is required in an organization](/articles/requiring-two-factor-authentication-in-your-organization) and an organization member doesn't use 2FA or disables 2FA. Also triggered when an [organization member removes themselves](/articles/removing-yourself-from-an-organization/) from an organization. | -| `remove_outside_collaborator` | Triggered when an owner removes an outside collaborator from an organization or when [two-factor authentication is required in an organization](/articles/requiring-two-factor-authentication-in-your-organization) and an outside collaborator does not use 2FA or disables 2FA. |{% if currentVersion == "free-pro-team@latest" %} -| `revoke_external_identity` | Triggered when an organization owner revokes a member's linked identity. For more information, see "[Viewing and managing a member's SAML access to your organization](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization#viewing-and-revoking-a-linked-identity)." | -| `revoke_sso_session` | Triggered when an organization owner revokes a member's SAML session. For more information, see "[Viewing and managing a member's SAML access to your organization](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization#viewing-and-revoking-a-linked-identity)." | -| `unblock_user` | Triggered when an organization owner [unblocks a user from an organization](/articles/unblocking-a-user-from-your-organization).{% endif %} -| `update_default_repository_permission` | Triggered when an owner changes the default repository permission level for organization members. | -| `update_member` | Triggered when an owner changes a person's role from owner to member or member to owner. | -| `update_member_repository_creation_permission` | Triggered when an owner changes the create repository permission for organization members.{% if currentVersion == "free-pro-team@latest" %} -| `update_saml_provider_settings` | Triggered when an organization's SAML provider settings are updated. | -| `update_terms_of_service` | Triggered when an organization changes between the Standard Terms of Service and the Corporate Terms of Service. For more information, see "[Upgrading to the Corporate Terms of Service](/articles/upgrading-to-the-corporate-terms-of-service)."{% endif %} +| Действие | Description | +| ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest"%} +| `audit_log_export` | Triggered when an organization admin [creates an export of the organization audit log](#exporting-the-audit-log). If the export included a query, the log will list the query used and the number of audit log entries matching that query. | +| `block_user` | Triggered when an organization owner [blocks a user from accessing the organization's repositories](/articles/blocking-a-user-from-your-organization). | +| `cancel_invitation` | Triggered when an organization invitation has been revoked. | +| `disable_oauth_app_restrictions` | Triggered when an owner [disables {% data variables.product.prodname_oauth_app %} access restrictions](/articles/disabling-oauth-app-access-restrictions-for-your-organization) for your organization. | +| `disable_saml` | Triggered when an organization admin disables SAML single sign-on for an organization.{% endif %} +| `disable_member_team_creation_permission` | Triggered when an organization owner limits team creation to owners. For more information, see "[Setting team creation permissions in your organization](/articles/setting-team-creation-permissions-in-your-organization)." | +| `disable_two_factor_requirement` | Triggered when an owner disables a two-factor authentication requirement for all members{% if currentVersion == "free-pro-team@latest" %}, billing managers,{% endif %} and outside collaborators in an organization.{% if currentVersion == "free-pro-team@latest" %} +| `enable_oauth_app_restrictions` | Triggered when an owner [enables {% data variables.product.prodname_oauth_app %} access restrictions](/articles/enabling-oauth-app-access-restrictions-for-your-organization) for your organization. | +| `enable_saml` | Triggered when an organization admin [enables SAML single sign-on](/articles/enabling-and-testing-saml-single-sign-on-for-your-organization) for an organization.{% endif %} +| `enable_member_team_creation_permission` | Triggered when an organization owner allows members to create teams. For more information, see "[Setting team creation permissions in your organization](/articles/setting-team-creation-permissions-in-your-organization)." | +| `enable_two_factor_requirement` | Triggered when an owner requires two-factor authentication for all members{% if currentVersion == "free-pro-team@latest" %}, billing managers,{% endif %} and outside collaborators in an organization. | +| `invite_member` | Triggered when [a new user was invited to join your organization](/articles/adding-organization-members-to-a-team).{% if currentVersion == "free-pro-team@latest" %} +| `oauth_app_access_approved` | Triggered when an owner [grants organization access to an {% data variables.product.prodname_oauth_app %}](/articles/approving-oauth-apps-for-your-organization/). | +| `oauth_app_access_denied` | Triggered when an owner [disables a previously approved {% data variables.product.prodname_oauth_app %}'s access](/articles/denying-access-to-a-previously-approved-oauth-app-for-your-organization) to your organization. | +| `oauth_app_access_requested` | Triggered when an organization member requests that an owner grant an {% data variables.product.prodname_oauth_app %} access to your organization.{% endif %}{% if currentVersion == "free-pro-team@latest" %} +| `remove_billing_manager` | Triggered when an [owner removes a billing manager from an organization](/articles/removing-a-billing-manager-from-your-organization/) or when [two-factor authentication is required in an organization](/articles/requiring-two-factor-authentication-in-your-organization) and a billing manager doesn't use 2FA or disables 2FA. |{% endif %} +| `remove_member` | Triggered when an [owner removes a member from an organization](/articles/removing-a-member-from-your-organization/) or when [two-factor authentication is required in an organization](/articles/requiring-two-factor-authentication-in-your-organization) and an organization member doesn't use 2FA or disables 2FA. Also triggered when an [organization member removes themselves](/articles/removing-yourself-from-an-organization/) from an organization. | +| `remove_outside_collaborator` | Triggered when an owner removes an outside collaborator from an organization or when [two-factor authentication is required in an organization](/articles/requiring-two-factor-authentication-in-your-organization) and an outside collaborator does not use 2FA or disables 2FA. |{% if currentVersion == "free-pro-team@latest" %} +| `revoke_external_identity` | Triggered when an organization owner revokes a member's linked identity. For more information, see "[Viewing and managing a member's SAML access to your organization](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization#viewing-and-revoking-a-linked-identity)." | +| `revoke_sso_session` | Triggered when an organization owner revokes a member's SAML session. For more information, see "[Viewing and managing a member's SAML access to your organization](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization#viewing-and-revoking-a-linked-identity)." | +| `unblock_user` | {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} +| `update_new_repository_default_branch_setting` | Triggered when an owner changes the name of the default branch for new repositories in the organization. For more information, see "[Managing the default branch name for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization)."{% endif %} +| `update_default_repository_permission` | Triggered when an owner changes the default repository permission level for organization members. | +| `update_member` | Triggered when an owner changes a person's role from owner to member or member to owner. | +| `update_member_repository_creation_permission` | Triggered when an owner changes the create repository permission for organization members.{% if currentVersion == "free-pro-team@latest" %} +| `update_saml_provider_settings` | Triggered when an organization's SAML provider settings are updated. | +| `update_terms_of_service` | Triggered when an organization changes between the Standard Terms of Service and the Corporate Terms of Service. For more information, see "[Upgrading to the Corporate Terms of Service](/articles/upgrading-to-the-corporate-terms-of-service)."{% endif %} {% if currentVersion == "free-pro-team@latest" %} ##### The `org_credential_authorization` category @@ -233,8 +234,8 @@ For more information, see "[Restricting publication of {% data variables.product ##### The `oauth_application` category -| Действие | Description | -| --------------- | ----------------------------------------------------------------------------------------------------------------------- | +| Действие | Description | +| --------------- | ------------------------------------------------------------------------------------------------------------------ | | `create` | Triggered when a new {% data variables.product.prodname_oauth_app %} is created. | | `destroy` | Triggered when an existing {% data variables.product.prodname_oauth_app %} is deleted. | | `reset_secret` | Triggered when an {% data variables.product.prodname_oauth_app %}'s client secret is reset. | @@ -274,73 +275,73 @@ For more information, see "[Restricting publication of {% data variables.product ##### The `protected_branch` category -| Действие | Description | -| ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `create` | Triggered when branch protection is enabled on a branch. | -| `destroy` | Triggered when branch protection is disabled on a branch. | -| `update_admin_enforced` | Triggered when branch protection is enforced for repository administrators. | -| `update_require_code_owner_review` | Triggered when enforcement of required Code Owner review is updated on a branch. | -| `dismiss_stale_reviews` | Triggered when enforcement of dismissing stale pull requests is updated on a branch. | -| `update_signature_requirement_enforcement_level` | Triggered when enforcement of required commit signing is updated on a branch. | -| `update_pull_request_reviews_enforcement_level` | Triggered when enforcement of required pull request reviews is updated on a branch. | -| `update_required_status_checks_enforcement_level` | Triggered when enforcement of required status checks is updated on a branch. | -| `update_strict_required_status_checks_policy` | Triggered when the requirement for a branch to be up to date before merging is changed. | -| `rejected_ref_update` | Triggered when a branch update attempt is rejected. | +| Действие | Description | +| ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `create` | Triggered when branch protection is enabled on a branch. | +| `destroy` | Triggered when branch protection is disabled on a branch. | +| `update_admin_enforced` | Triggered when branch protection is enforced for repository administrators. | +| `update_require_code_owner_review` | Triggered when enforcement of required Code Owner review is updated on a branch. | +| `dismiss_stale_reviews` | Triggered when enforcement of dismissing stale pull requests is updated on a branch. | +| `update_signature_requirement_enforcement_level` | Triggered when enforcement of required commit signing is updated on a branch. | +| `update_pull_request_reviews_enforcement_level` | Triggered when enforcement of required pull request reviews is updated on a branch. | +| `update_required_status_checks_enforcement_level` | Triggered when enforcement of required status checks is updated on a branch. | +| `update_strict_required_status_checks_policy` | Triggered when the requirement for a branch to be up to date before merging is changed. | +| `rejected_ref_update` | Triggered when a branch update attempt is rejected. | | `policy_override` | Triggered when a branch protection requirement is overridden by a repository administrator.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -| `update_allow_force_pushes_enforcement_level` | Triggered when force pushes are enabled or disabled for a protected branch. | -| `update_allow_deletions_enforcement_level` | Triggered when branch deletion is enabled or disabled for a protected branch. | -| `update_linear_history_requirement_enforcement_level` | Triggered when required linear commit history is enabled or disabled for a protected branch. | +| `update_allow_force_pushes_enforcement_level` | Triggered when force pushes are enabled or disabled for a protected branch. | +| `update_allow_deletions_enforcement_level` | Triggered when branch deletion is enabled or disabled for a protected branch. | +| `update_linear_history_requirement_enforcement_level` | Triggered when required linear commit history is enabled or disabled for a protected branch. | {% endif %} ##### The `repo` category -| Действие | Description | -| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `access` | Triggered when a repository owned by an organization is [switched from "private" to "public"](/articles/making-a-private-repository-public) (or vice versa). | -| `add_member` | Triggered when a user accepts an [invitation to have collaboration access to a repository](/articles/inviting-collaborators-to-a-personal-repository). | -| `add_topic` | Triggered when a repository admin [adds a topic](/articles/classifying-your-repository-with-topics) to a repository. | +| Действие | Description | +| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `access` | Triggered when a repository owned by an organization is [switched from "private" to "public"](/articles/making-a-private-repository-public) (or vice versa). | +| `add_member` | Triggered when a user accepts an [invitation to have collaboration access to a repository](/articles/inviting-collaborators-to-a-personal-repository). | +| `add_topic` | Triggered when a repository admin [adds a topic](/articles/classifying-your-repository-with-topics) to a repository. | | `archived` | Triggered when a repository admin [archives a repository](/articles/about-archiving-repositories).{% if currentVersion != "free-pro-team@latest" %} | `config.disable_anonymous_git_access` | Triggered when [anonymous Git read access is disabled](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) in a public repository. | | `config.enable_anonymous_git_access` | Triggered when [anonymous Git read access is enabled](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) in a public repository. | | `config.lock_anonymous_git_access` | Triggered when a repository's [anonymous Git read access setting is locked](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access). | | `config.unlock_anonymous_git_access` | Triggered when a repository's [anonymous Git read access setting is unlocked](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access).{% endif %} -| `create` | Triggered when [a new repository is created](/articles/creating-a-new-repository). | +| `create` | Triggered when [a new repository is created](/articles/creating-a-new-repository). | | `destroy` | Triggered when [a repository is deleted](/articles/deleting-a-repository).{% if currentVersion == "free-pro-team@latest" %} -| `деактивировать` | Triggered when a repository is disabled (e.g., for [insufficient funds](/articles/unlocking-a-locked-account)).{% endif %} -| `активировать` | Triggered when a repository is reenabled. | -| `remove_member` | Triggered when a user is [removed from a repository as a collaborator](/articles/removing-a-collaborator-from-a-personal-repository). | -| `remove_topic` | Triggered when a repository admin removes a topic from a repository. | -| `rename` | Triggered when [a repository is renamed](/articles/renaming-a-repository). | -| `передача` | Triggered when [a repository is transferred](/articles/how-to-transfer-a-repository). | -| `transfer_start` | Triggered when a repository transfer is about to occur. | -| `unarchived` | Triggered when a repository admin unarchives a repository. | +| `отключить` | Triggered when a repository is disabled (e.g., for [insufficient funds](/articles/unlocking-a-locked-account)).{% endif %} +| `включить` | Triggered when a repository is reenabled. | +| `remove_member` | Triggered when a user is [removed from a repository as a collaborator](/articles/removing-a-collaborator-from-a-personal-repository). | +| `remove_topic` | Triggered when a repository admin removes a topic from a repository. | +| `rename` | Triggered when [a repository is renamed](/articles/renaming-a-repository). | +| `передача` | Triggered when [a repository is transferred](/articles/how-to-transfer-a-repository). | +| `transfer_start` | Triggered when a repository transfer is about to occur. | +| `unarchived` | Triggered when a repository admin unarchives a repository. | {% if currentVersion == "free-pro-team@latest" %} ##### The `repository_content_analysis` category -| Действие | Description | -| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `активировать` | Triggered when an organization owner or person with admin access to the repository [enables data use settings for a private repository](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository). | -| `деактивировать` | Triggered when an organization owner or person with admin access to the repository [disables data use settings for a private repository](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository). | +| Действие | Description | +| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `включить` | Triggered when an organization owner or person with admin access to the repository [enables data use settings for a private repository](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository). | +| `отключить` | Triggered when an organization owner or person with admin access to the repository [disables data use settings for a private repository](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository). | ##### The `repository_dependency_graph` category -| Действие | Description | -| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `активировать` | Triggered when a repository owner or person with admin access to the repository [enables the dependency graph for a private repository](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository). | -| `деактивировать` | Triggered when a repository owner or person with admin access to the repository [disables the dependency graph for a private repository](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository). | +| Действие | Description | +| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `включить` | Triggered when a repository owner or person with admin access to the repository [enables the dependency graph for a private repository](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository). | +| `отключить` | Triggered when a repository owner or person with admin access to the repository [disables the dependency graph for a private repository](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository). | {% endif %} ##### The `repository_vulnerability_alert` category -| Действие | Description | -| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `create` | Triggered when {% data variables.product.product_name %} creates a [{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alert for a vulnerable dependency](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in a particular repository. | -| `resolve` | Triggered when someone with write access to a repository [pushes changes to update and resolve a vulnerability](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in a project dependency. | -| `отклонить` | Triggered when an organization owner or person with admin access to the repository dismisses a | -| {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alert about a vulnerable dependency.{% if currentVersion == "free-pro-team@latest" %} | | -| `authorized_users_teams` | Triggered when an organization owner or a member with admin permissions to the repository [updates the list of people or teams authorized to receive {% data variables.product.prodname_dependabot_short %} alerts](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-github-dependabot-alerts) for vulnerable dependencies in the repository.{% endif %} +| Действие | Description | +| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `create` | Triggered when {% data variables.product.product_name %} creates a [{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alert for a vulnerable dependency](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in a particular repository. | +| `разрешение проблем` | Triggered when someone with write access to a repository [pushes changes to update and resolve a vulnerability](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in a project dependency. | +| `отклонить` | Triggered when an organization owner or person with admin access to the repository dismisses a | +| {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alert about a vulnerable dependency.{% if currentVersion == "free-pro-team@latest" %} | | +| `authorized_users_teams` | Triggered when an organization owner or a member with admin permissions to the repository [updates the list of people or teams authorized to receive {% data variables.product.prodname_dependabot_short %} alerts](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-github-dependabot-alerts) for vulnerable dependencies in the repository.{% endif %} {% if currentVersion == "free-pro-team@latest" %} ##### The `sponsors` category @@ -368,10 +369,10 @@ For more information, see "[Restricting publication of {% data variables.product ##### The `team_discussions` category -| Действие | Description | -| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `деактивировать` | Triggered when an organization owner disables team discussions for an organization. For more information, see "[Disabling team discussions for your organization](/articles/disabling-team-discussions-for-your-organization)." | -| `активировать` | Triggered when an organization owner enables team discussions for an organization. | +| Действие | Description | +| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `отключить` | Triggered when an organization owner disables team discussions for an organization. For more information, see "[Disabling team discussions for your organization](/articles/disabling-team-discussions-for-your-organization)." | +| `включить` | Triggered when an organization owner enables team discussions for an organization. | #### Search based on time of action @@ -401,7 +402,6 @@ Using the qualifier `country`, you can filter actions in the audit log based on {% data reusables.audit_log.exported-log-keys-and-values %} {% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} ### Using the Audit log API {% note %} @@ -421,8 +421,6 @@ The GraphQL response can include data for up to 90 to 120 days. For example, you can make a GraphQL request to see all the new organization members added to your organization. For more information, see the "[GraphQL API Audit Log](/v4/interface/auditentry/)." -{% endif %} - ### Дополнительная литература - "[Keeping your organization secure](/articles/keeping-your-organization-secure)" diff --git a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md index 90ae82174436..fce4f0907e3e 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md @@ -9,7 +9,9 @@ versions: The Standard Terms of Service is an agreement between {% data variables.product.prodname_dotcom %} and you as an individual. To enter into an agreement with {% data variables.product.prodname_dotcom %} on behalf of an entity, such as a company, non-profit, or group, organization owners can upgrade to the Corporate Terms of Service. -1. Contact {% data variables.contact.contact_support %} to request an upgrade to the Corporate Terms of Service. They will enable a banner on your organization's dashboard that will allow you to accept the Corporate Terms of Service. +1. Контакт + +{% data variables.contact.contact_support %} to request an upgrade to the Corporate Terms of Service. They will enable a banner on your organization's dashboard that will allow you to accept the Corporate Terms of Service. {% data reusables.dashboard.access-org-dashboard %} 3. At the top of the page, to the right of the Terms of Service banner, click **Sign now**. ![Sign now button](/assets/images/help/organizations/sign-now-button.png) 4. Read the information about the Corporate Terms of Service, then select **Yes, I want to sign these terms on behalf of my business.** ![Check box to sign on behalf of your business](/assets/images/help/organizations/sign-on-behalf-business.png) diff --git a/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise-account/about-enterprise-accounts.md b/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise-account/about-enterprise-accounts.md index 27f37f6bb8a5..794f20cd77f9 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise-account/about-enterprise-accounts.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise-account/about-enterprise-accounts.md @@ -25,9 +25,7 @@ For more information about the differences between {% data variables.product.pro For more information about member access and management, see "[Managing users in your enterprise account](/articles/managing-users-in-your-enterprise-account)." -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} For more information about managing enterprise accounts using the GraphQL API, see "[Enterprise accounts](/v4/guides/managing-enterprise-accounts)." -{% endif %} ### Managing organizations linked to your enterprise account diff --git a/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md b/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md new file mode 100644 index 000000000000..7a75d8c7a30d --- /dev/null +++ b/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md @@ -0,0 +1,19 @@ +--- +title: Configuring the retention period for GitHub Actions artifacts and logs in your enterprise account +intro: 'Enterprise owners can configure the retention period for {% data variables.product.prodname_actions %} artifacts and logs in an enterprise account.' +product: '{% data reusables.gated-features.enterprise-accounts %}' +miniTocMaxHeadingLevel: 4 +versions: + free-pro-team: '*' + enterprise-server: '>=2.23' +--- + +{% data reusables.actions.about-artifact-log-retention %} + +## Setting the retention period for an enterprise + +{% data reusables.enterprise_site_admin_settings.access-settings %} +{% data reusables.enterprise_site_admin_settings.business %} +{% data reusables.enterprise-accounts.policies-tab %} +{% data reusables.enterprise-accounts.actions-tab %} +{% data reusables.github-actions.change-retention-period-for-artifacts-logs %} diff --git a/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account.md b/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account.md index 0394bd847ee7..de71be296c8f 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account.md @@ -13,13 +13,26 @@ By default, {% data variables.product.prodname_actions %} is enabled in all orga For more information about {% data variables.product.prodname_actions %}, see "[About {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)." - ### Managing {% data variables.product.prodname_actions %} permissions for your enterprise account +You can disable all workflows for an enterprise or set a policy that configures which actions can be used in an organization. + +{% data reusables.actions.actions-use-policy-settings %} + {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.actions-tab %} {% data reusables.actions.enterprise-actions-permissions %} +1. Click **Save**. + +### Allowing specific actions to run + +{% data reusables.actions.allow-specific-actions-intro %} + +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.policies-tab %} +{% data reusables.enterprise-accounts.actions-tab %} +1. Under **Policies**, select **Allow specific actions** and add your required actions to the list. ![Add actions to allow list](/assets/images/help/organizations/enterprise-actions-policy-allow-list.png) ### Enabling workflows for private repository forks diff --git a/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise-account/index.md b/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise-account/index.md index e14ce1d2467f..2eac95839d7b 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise-account/index.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise-account/index.md @@ -14,6 +14,7 @@ versions: {% topic_link_in_list /managing-your-enterprise-account %} {% link_in_list /about-enterprise-accounts %} {% link_in_list /viewing-the-subscription-and-usage-for-your-enterprise-account %} + {% link_in_list /managing-licenses-for-visual-studio-subscription-with-github-enterprise %} {% topic_link_in_list /managing-users-in-your-enterprise-account %} {% link_in_list /roles-for-an-enterprise-account %} {% link_in_list /inviting-people-to-manage-your-enterprise-account %} @@ -32,3 +33,4 @@ versions: {% link_in_list /configuring-saml-single-sign-on-and-scim-for-your-enterprise-account-using-okta %} {% link_in_list /enforcing-a-policy-on-dependency-insights-in-your-enterprise-account %} {% link_in_list /enforcing-github-actions-policies-in-your-enterprise-account %} + {% link_in_list /configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account %} diff --git a/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md b/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md new file mode 100644 index 000000000000..bc3b5c87fedb --- /dev/null +++ b/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md @@ -0,0 +1,42 @@ +--- +title: Managing licenses for Visual Studio subscription with GitHub Enterprise +intro: 'You can manage {% data variables.product.prodname_enterprise %} licensing for {% data variables.product.prodname_vss_ghe %}.' +redirect_from: + - /github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-the-github-enterprise-and-visual-studio-bundle + - /github/articles/about-the-github-and-visual-studio-bundle + - /articles/about-the-github-and-visual-studio-bundle +versions: + free-pro-team: '*' +--- + +### About {% data variables.product.prodname_vss_ghe %} + +{% data variables.product.prodname_vss_ghe %} is a combined offering from Microsoft that allows a subscriber to use both {% data variables.product.prodname_enterprise %} and {% data variables.product.prodname_vs %}. {% data variables.product.prodname_vss_ghe %} is available from Microsoft under the terms of the Microsoft Enterprise Agreement. For more information, see [{% data variables.product.prodname_vss_ghe %}](https://visualstudio.microsoft.com/subscriptions/visual-studio-github/) on the {% data variables.product.prodname_vs %} website. + +After you assign a license for {% data variables.product.prodname_vss_ghe %} to a subscriber, the subscriber will use the {% data variables.product.prodname_enterprise %} portion of the license by joining an organization in your enterprise account with a user account on {% data variables.product.prodname_dotcom_the_website %}. + +For more information about {% data variables.product.prodname_enterprise %}, see "[{% data variables.product.company_short %}'s products](/github/getting-started-with-github/githubs-products#github-enterprise)." For more information about accounts on {% data variables.product.prodname_dotcom_the_website %}, see "[Types of {% data variables.product.prodname_dotcom %} accounts](/github/getting-started-with-github/types-of-github-accounts)." + +### Требования + +1. After you buy {% data variables.product.prodname_vss_ghe %}, contact {% data variables.contact.contact_enterprise_sales %} and mention "{% data variables.product.prodname_vss_ghe %}." You'll work with the Sales team to create an enterprise account on {% data variables.product.prodname_dotcom_the_website %}. If you already have an enterprise account on {% data variables.product.prodname_dotcom_the_website %}, or if you're not sure, please tell our Sales team. + +2. Assign licenses for {% data variables.product.prodname_vss_ghe %} to subscribers in {% data variables.product.prodname_vss_admin_portal_with_url %}. For more information about assigning licenses, see [Manage {% data variables.product.prodname_vs %} subscriptions with {% data variables.product.prodname_enterprise %}](https://docs.microsoft.com/en-us/visualstudio/subscriptions/assign-github) in the Microsoft Docs. + +3. On {% data variables.product.prodname_dotcom_the_website %}, create at least one organization owned by your enterprise account. For more information, see "[Adding organizations to your enterprise account](/github/setting-up-and-managing-your-enterprise-account/adding-organizations-to-your-enterprise-account)." + +4. The subscriber must create a user account on {% data variables.product.prodname_dotcom_the_website %}, and the email address for the account must be the same email address as the email address in the {% data variables.product.prodname_vs %} portal. For more information, see "[Signing up for {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/signing-up-for-github)" and "[Managing email preferences](/github/setting-up-and-managing-your-github-user-account/managing-email-preferences)." + +### Inviting a subscriber to use {% data variables.product.prodname_enterprise %} + +To use the {% data variables.product.prodname_enterprise %} portion of the license, the subscriber must join an organization owned by your enterprise account on {% data variables.product.prodname_dotcom_the_website %}. Organization owners can invite new members to an organization. For more information, see "[Inviting users to join your organization](/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization)." + +### Viewing {% data variables.product.prodname_enterprise %} licensing + +After assigning a license for {% data variables.product.prodname_vss_ghe %} in {% data variables.product.prodname_vss_admin_portal_with_url %}, you can view the number of {% data variables.product.prodname_enterprise %} licenses available to your enterprise account. For more information, see "[Viewing the subscription and usage for your enterprise account](/github/setting-up-and-managing-your-enterprise-account/viewing-the-subscription-and-usage-for-your-enterprise-account)." + +You can also see pending {% data variables.product.prodname_enterprise %} invitations to subscribers in {% data variables.product.prodname_vss_admin_portal_with_url %}. The list of pending invitations includes subscribers who are not yet members of at least one organization in your enterprise account. For more information, see "[Viewing people in your enterprise account](/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account#viewing-members-and-outside-collaborators)." + +### Дополнительная литература + +- [Introducing Visual Studio subscriptions with GitHub Enterprise](https://docs.microsoft.com/en-us/visualstudio/subscriptions/access-github) in the Microsoft Docs diff --git a/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account.md b/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account.md index 503197af1632..647fdb0a7bd6 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account.md @@ -16,6 +16,7 @@ You can view enterprise owners and billing managers, as well as a list of pendin {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.people-tab %} {% data reusables.enterprise-accounts.administrators-tab %} +1. Optionally, to view a list of pending invitations, click **_NUMBER_ pending**. !["NUMBER pending" button to the right of search and filter options](/assets/images/help/enterprises/administrators-pending.png) ### Viewing members and outside collaborators @@ -25,7 +26,8 @@ You can view all the {% data variables.product.prodname_ghe_cloud %} organizatio {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.people-tab %} -3. Optionally, to view a list of outside collaborators rather than the list of members, click **Outside collaborators**. ![Outside collaborators tab on the Organization members page](/assets/images/help/business-accounts/outside-collaborators-tab.png) +1. Optionally, to view a list of outside collaborators rather than the list of members, click **Outside collaborators**. ![Outside collaborators tab on the Organization members page](/assets/images/help/business-accounts/outside-collaborators-tab.png) +1. Optionally, to view a list of pending invitations, click **_NUMBER_ pending**. !["NUMBER pending" button to the right of search and filter options](/assets/images/help/enterprises/members-pending.png) ### Дополнительная литература diff --git a/translations/ru-RU/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md b/translations/ru-RU/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md index eb5dfb883b15..4b3dbb8adc1b 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md @@ -40,7 +40,7 @@ When you sign up for an account, {% data variables.product.product_name %} provi ### Changing your profile name -You can change the name that is displayed on your profile. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}This name may also be displayed next to comments you make on private repositories owned by an organization. For more information, see "[Managing the display of member names in your organization](/articles/managing-the-display-of-member-names-in-your-organization)."{% endif %} +You can change the name that is displayed on your profile. This name may also be displayed next to comments you make on private repositories owned by an organization. For more information, see "[Managing the display of member names in your organization](/articles/managing-the-display-of-member-names-in-your-organization)." {% data reusables.user_settings.access_settings %} 2. Under "Name", type the name you want to be displayed on your profile. ![Name field in profile settings](/assets/images/help/profile/name-field.png) @@ -101,12 +101,12 @@ If you select the "Busy" option, when people @mention your username, assign you When you participate in certain programs, {% data variables.product.prodname_dotcom %} automatically displays a badge on your profile. -| Badge | Program | Description | -| --------------------------------------------------------------- | ------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Badge | Program | Description | +| --------------------------------------------------------------- | -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | {% octicon "north-star" aria-label="The North Star icon" %} | **{% data variables.product.prodname_arctic_vault %} Contributor** | If you authored any commit(s) on the default branch of a repository that was archived in the 2020 Arctic Vault program, you'll get an {% data variables.product.prodname_arctic_vault %} Contributor badge on your profile. For more information on the program, see [{% data variables.product.prodname_archive %}](https://archiveprogram.github.com). | -| {% octicon "cpu" aria-label="The Developer Program icon" %} | **Developer Program Member** | If you're a registered member of the GitHub Developer Program, building an app with the GitHub API, you'll get a Developer Program Member badge on your profile. For more information on the GitHub Developer Program, see [GitHub Developer](/program/). | -| {% octicon "heart-fill" aria-label="The GitHub Sponsor icon" %} | **GitHub Sponsor** | If you sponsored an open source contributor through {% data variables.product.prodname_sponsors %} you'll get a GitHub Sponsor badge on your profile. For more information, see "[Sponsoring open source contributors](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-open-source-contributors)." | -| {% octicon "star-fill" aria-label="The star icon" %} | **Pro** | If you use {% data variables.product.prodname_pro %} you'll get a PRO badge on your profile. For more information about {% data variables.product.prodname_pro %}, see "[{% data variables.product.prodname_dotcom %}'s products](/github/getting-started-with-github/githubs-products#github-pro)." | +| {% octicon "cpu" aria-label="The Developer Program icon" %} | **Developer Program Member** | If you're a registered member of the GitHub Developer Program, building an app with the GitHub API, you'll get a Developer Program Member badge on your profile. For more information on the GitHub Developer Program, see [GitHub Developer](/program/). | +| {% octicon "heart-fill" aria-label="The GitHub Sponsor icon" %} | **GitHub Sponsor** | If you sponsored an open source contributor through {% data variables.product.prodname_sponsors %} you'll get a GitHub Sponsor badge on your profile. For more information, see "[Sponsoring open source contributors](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-open-source-contributors)." | +| {% octicon "star-fill" aria-label="The star icon" %} | **Pro** | If you use {% data variables.product.prodname_pro %} you'll get a PRO badge on your profile. For more information about {% data variables.product.prodname_pro %}, see "[{% data variables.product.prodname_dotcom %}'s products](/github/getting-started-with-github/githubs-products#github-pro)." | ### Disabling badges on your profile diff --git a/translations/ru-RU/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md b/translations/ru-RU/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md index 0e1a24a44f90..0aa8f34291ac 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md @@ -8,6 +8,12 @@ versions: enterprise-server: '*' --- +{% note %} + +**Note:** You cannot change your primary email address to an email that is already set to be your backup email address. + +{% endnote %} + {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.emails %} 3. If you'd like to add a new email address to set as your primary email address, under "Add email address", type a new email address and click **Add**. ![Add another email address button](/assets/images/help/settings/add_another_email_address.png) @@ -15,7 +21,8 @@ versions: 5. To remove the old email address from your account, next to the old email, click {% octicon "trashcan" aria-label="The trashcan symbol" %}. {% if currentVersion == "free-pro-team@latest" %} -6. Verify your new primary email address. Without a verified email address, you won't be able to use all of {% data variables.product.product_name %}'s features. For more information, see "[Verifying your email address](/articles/verifying-your-email-address)." +6. Verify your new primary email address. Without a verified email address, you won't be able to use all of +{% data variables.product.product_name %}'s features. For more information, see "[Verifying your email address](/articles/verifying-your-email-address)." {% endif %} ### Дополнительная литература diff --git a/translations/ru-RU/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md b/translations/ru-RU/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md index 1fe3aceecec4..cb69d8b5ad51 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md @@ -17,7 +17,7 @@ versions: - You will **no longer** be able to sign into the converted user account. - You will **no longer** be able to create or modify gists owned by the converted user account. - An organization **cannot** be converted back to a user. - - The SSH keys, OAuth tokens, job profile, {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} reactions, {% endif %}and associated user information, **will not** be transferred to the organization. This is only true for the user account that's being converted, not any of the user account's collaborators. + - The SSH keys, OAuth tokens, job profile, reactions, and associated user information, **will not** be transferred to the organization. This is only true for the user account that's being converted, not any of the user account's collaborators. - Any commits made with the converted user account **will no longer be linked** to that account. The commits themselves **will** remain intact. {% endwarning %} diff --git a/translations/ru-RU/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md b/translations/ru-RU/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md index a778b1de4578..c396e07c17be 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md @@ -18,7 +18,9 @@ A collaborator is a person who has permissions to a project board you own. A col {% data reusables.project-management.click-menu %} {% data reusables.project-management.access-collaboration-settings %} {% data reusables.project-management.collaborator-option %} -5. Under "Search by username, full name or email address", type the collaborator's name, username, or {% data variables.product.prodname_dotcom %} email. ![The Collaborators section with the Octocat's username entered in the search field](/assets/images/help/projects/org-project-collaborators-find-name.png) +5. Under "Search by username, full name or email address", type the collaborator's name, username, or +{% data variables.product.prodname_dotcom %} email. + ![The Collaborators section with the Octocat's username entered in the search field](/assets/images/help/projects/org-project-collaborators-find-name.png) {% data reusables.project-management.add-collaborator %} 7. The new collaborator has read permissions by default. Optionally, next to the new collaborator's name, use the drop-down menu and choose a different permission level. ![The Collaborators section with the Permissions drop-down menu selected](/assets/images/help/projects/user-project-collaborators-edit-permissions.png) diff --git a/translations/ru-RU/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md b/translations/ru-RU/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md index 1b27c3221d72..1bcc65a0cd51 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md @@ -1,18 +1,16 @@ --- title: Managing the default branch name for your repositories -intro: You can set a default branch name for all new repositories that you create. +intro: 'You can set the default branch name new repositories that you create on {% data variables.product.product_location %}.' versions: free-pro-team: '*' enterprise-server: '>=2.23' --- -### About the default branch name +### About management of the default branch name -{% data reusables.branches.new-repo-default-branch %} This branch is currently named `master`, but you can set the default branch name to anything that makes sense for your development environment. +When you create a new repository on {% data variables.product.product_location %}, the repository contains one branch, which is the default branch. You can change the name that {% data variables.product.product_name %} uses for the default branch in new repositories you create. For more information about the default branch, see "[About branches](/github/collaborating-with-issues-and-pull-requests/about-branches#about-the-default-branch)." -{% data reusables.branches.set-default-branch %} - -{% data reusables.branches.rename-existing-branch %} +{% data reusables.branches.change-default-branch %} ### Setting the default branch name @@ -24,4 +22,4 @@ versions: ### Дополнительная литература -- [Managing the default branch name for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization) +- "[Managing the default branch name for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization)" diff --git a/translations/ru-RU/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md b/translations/ru-RU/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md index 4c73c7872758..c29fd067399d 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md @@ -26,9 +26,9 @@ The repository owner has full control of the repository. In addition to all the - [Manage a repository's topics](/articles/classifying-your-repository-with-topics){% if currentVersion == "free-pro-team@latest" %} - Manage security and analysis settings. For more information, see "[Managing security and analysis settings for your user account](/github/setting-up-and-managing-your-github-user-account/managing-security-and-analysis-settings-for-your-user-account)."{% endif %}{% if currentVersion == "free-pro-team@latest" %} - [Enable the dependency graph](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) for a private repository{% endif %}{% if currentVersion == "free-pro-team@latest" %} -- Delete packages. For more information, see "[Deleting a package](/github/managing-packages-with-github-packages/deleting-a-package)."{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} +- Delete packages. For more information, see "[Deleting a package](/github/managing-packages-with-github-packages/deleting-a-package)."{% endif %} - Create and edit repository social cards. For more information, see "[Customizing your repository's social media preview](/articles/customizing-your-repositorys-social-media-preview)." -- Make the repository a template. For more information, see "[Creating a template repository](/articles/creating-a-template-repository)."{% endif %} +- Make the repository a template. For more information, see "[Creating a template repository](/articles/creating-a-template-repository)." - Receive [{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in a repository.{% if currentVersion == "free-pro-team@latest" %} - Dismiss {% data variables.product.prodname_dependabot_alerts %} in your repository. For more information, see "[Viewing and updating vulnerable dependencies in your repository](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)." - [Manage data usage for your private repository](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository){% endif %} @@ -65,8 +65,7 @@ Collaborators on a personal repository can: - Act as a designated code owner for the repository. For more information, see "[About code owners](/articles/about-code-owners)." - Lock a conversation. For more information, see "[Locking conversations](/articles/locking-conversations)."{% if currentVersion == "free-pro-team@latest" %} - Report abusive content to {% data variables.contact.contact_support %}. For more information, see "[Reporting abuse or spam](/articles/reporting-abuse-or-spam)."{% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -- Transfer an issue to a different repository. For more information, see "[Transferring an issue to another repository](/articles/transferring-an-issue-to-another-repository)."{% endif %} +- Transfer an issue to a different repository. For more information, see "[Transferring an issue to another repository](/articles/transferring-an-issue-to-another-repository)." ### Дополнительная литература diff --git a/translations/ru-RU/content/github/site-policy/github-acceptable-use-policies.md b/translations/ru-RU/content/github/site-policy/github-acceptable-use-policies.md index 88832bbce823..c9c20262dfe8 100644 --- a/translations/ru-RU/content/github/site-policy/github-acceptable-use-policies.md +++ b/translations/ru-RU/content/github/site-policy/github-acceptable-use-policies.md @@ -58,7 +58,7 @@ You may not scrape the Service for spamming purposes, including for the purposes All use of data gathered through scraping must comply with the [GitHub Privacy Statement](/articles/github-privacy-statement). -### 6. Приватность +### 6. Конфиденциальность Misuse of User Personal Information is prohibited. Any person, entity, or service collecting data from the Service must comply with the [GitHub Privacy Statement](/articles/github-privacy-statement), particularly in regards to the collection of User Personal Information. If you collect any User Personal Information from the Service, you agree that you will only use that User Personal Information for the purpose for which that User has authorized it. You agree that you will reasonably secure any User Personal Information you have gathered from the Service, and you will respond promptly to complaints, removal requests, and "do not contact" requests from us or other users. diff --git a/translations/ru-RU/content/github/site-policy/github-additional-product-terms.md b/translations/ru-RU/content/github/site-policy/github-additional-product-terms.md index 48826a69ef9e..9fbc16deb2db 100644 --- a/translations/ru-RU/content/github/site-policy/github-additional-product-terms.md +++ b/translations/ru-RU/content/github/site-policy/github-additional-product-terms.md @@ -42,11 +42,11 @@ GitHub Pages are subject to some specific bandwidth and usage limits, and may no ### 5. Actions and Packages #### a. Actions Usage -GitHub Actions enables you to create custom software development lifecycle workflows directly in your GitHub repository. Each Account comes with included compute and storage quantities for use with Actions, depending on your Account plan, which can be found in the [Actions documentation](/github/automating-your-workflow-with-github-actions/about-github-actions#about-github-actions). Your Actions compute usage is displayed within [your Account settings](https://github.com/settings/billing), and you will be notified by email in advance of reaching the limit of your included quantities. If you want to use Actions beyond your included quantities, then you may [enable overages](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions). +GitHub Actions enables you to create custom software development lifecycle workflows directly in your GitHub repository. Each Account comes with included compute and storage quantities for use with Actions, depending on your Account plan, which can be found in the [Actions documentation](/actions). Your Actions compute usage is displayed within [your Account settings](https://github.com/settings/billing), and you will be notified by email in advance of reaching the limit of your included quantities. If you want to use Actions beyond your included quantities, then you may [enable overages](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions). -Compute usage for included and paid quantities is calculated in minutes based on the type of Actions you execute (e.g. Linux, Windows, macOS). The minutes used for each Action's job or task will be rounded up to the nearest minute. For included quantities and depending on the type of Action, a multiplier may be applied to the amount of time used to execute each job or task, prior to being rounded up to the nearest minute. Overage minutes are charged at the [stated per minute price](https://github.com/features/actions) based on the type of Actions you execute. Actions and Packages share storage, and your storage usage is displayed within your [account settings](https://github.com/settings/billing). For additional details about included quantity usage calculations, see the [Actions documentation](/github/automating-your-workflow-with-github-actions/about-github-actions#about-github-actions). +Compute usage for included and paid quantities is calculated in minutes based on the type of Actions you execute (e.g. Linux, Windows, macOS). The minutes used for each Action's job or task will be rounded up to the nearest minute. For included quantities and depending on the type of Action, a multiplier may be applied to the amount of time used to execute each job or task, prior to being rounded up to the nearest minute. Overage minutes are charged at the [stated per minute price](https://github.com/features/actions) based on the type of Actions you execute. Actions and Packages share storage, and your storage usage is displayed within your [account settings](https://github.com/settings/billing). For additional details about included quantity usage calculations, see the [Actions documentation](/actions). -Actions and any elements of the Action service may not be used in violation of the Agreement, the [Acceptable Use Policy](/github/site-policy/github-acceptable-use-policies), or the GitHub Actions [service limitations](/github/automating-your-workflow-with-github-actions/about-github-actions#usage-limits). Additionally, Actions should not be used for: +Actions and any elements of the Action service may not be used in violation of the Agreement, the [Acceptable Use Policy](/github/site-policy/github-acceptable-use-policies), or the GitHub Actions [service limitations](/actions/reference/usage-limits-billing-and-administration/#usage-limits). Additionally, Actions should not be used for: - cryptomining; - using our servers to disrupt, or to gain or to attempt to gain unauthorized access to, any service, device, data, account or network (other than those authorized by the [GitHub Bug Bounty program](https://bounty.github.com)) - the provision of a stand-alone or integrated application or service offering Actions or any elements of Actions for commercial purposes; diff --git a/translations/ru-RU/content/github/site-policy/github-connect-addendum-to-the-github-enterprise-license-agreement.md b/translations/ru-RU/content/github/site-policy/github-connect-addendum-to-the-github-enterprise-license-agreement.md index 5bec9a35cc82..a05df30416e5 100644 --- a/translations/ru-RU/content/github/site-policy/github-connect-addendum-to-the-github-enterprise-license-agreement.md +++ b/translations/ru-RU/content/github/site-policy/github-connect-addendum-to-the-github-enterprise-license-agreement.md @@ -53,7 +53,7 @@ Customer agrees that GitHub and its licensors own all right, title and interest Nothing in this Addendum will impair GitHub’s right to develop, acquire, license, market, promote or distribute products, software or technologies that might compete with Customer’s. -#### 9. Приватность +#### 9. Конфиденциальность GitHub may collect information about how Customer uses GitHub Connect and how GitHub can improve it. Customer may enable GitHub Connect to authorize GitHub to collect protected data, which includes private repository data and Customer Personal Information (as defined in the GitHub Privacy Statement), from Customer's Enterprise account. If Customer connects its Enterprise instance with its GitHub.com account, Customer sends identifying instance information to GitHub.com, which information is governed by [GitHub’s Privacy Statement](/articles/github-privacy-statement/). By enabling this configuration, Customer agrees that it is responsible for the actions that are performed on or through its account, subject to the terms of its Generally Applicable Terms. diff --git a/translations/ru-RU/content/github/site-policy/github-corporate-terms-of-service.md b/translations/ru-RU/content/github/site-policy/github-corporate-terms-of-service.md index dec6ec64ccc4..168691b986bd 100644 --- a/translations/ru-RU/content/github/site-policy/github-corporate-terms-of-service.md +++ b/translations/ru-RU/content/github/site-policy/github-corporate-terms-of-service.md @@ -121,7 +121,7 @@ Customer’s use of the Products must not violate any applicable laws, including #### 2. Acceptable Use Customer’s use of the Service must comply with [GitHub's Acceptable Use Policies](/articles/github-acceptable-use-policies) and [GitHub’s Community Guidelines](/articles/github-community-guidelines). Customer must not use the Service in any jurisdiction for unlawful, obscene, offensive or fraudulent Content or activity, such as advocating or causing harm, interfering with or violating the integrity or security of a network or system, evading filters, sending unsolicited, abusive, or deceptive messages, viruses or harmful code, or violating third party rights. -#### 3. Приватность +#### 3. Конфиденциальность The [GitHub Privacy Statement](/articles/github-privacy-statement) and the [GitHub Data Protection Addendum](/github/site-policy/github-data-protection-addendum) provide detailed notice of GitHub's privacy and data use practices as well as GitHub's processing and security obligations with respect to Customer Personal Data. Any person, entity, or service collecting data from the Service must comply with the GitHub Privacy Statement, particularly in regards to the collection of Users' Personal Information (as defined in the GitHub Privacy Statement). If Customer collects any User Personal Information from GitHub, Customer will only use it for the purpose for which the External User has authorized it. Customer will reasonably secure any such Personal Information, and Customer will respond promptly to complaints, removal requests, and "do not contact" requests from GitHub or External Users. ### D. Content Responsibility; Ownership; License Rights diff --git a/translations/ru-RU/content/github/site-policy/github-enterprise-cloud-evaluation-agreement.md b/translations/ru-RU/content/github/site-policy/github-enterprise-cloud-evaluation-agreement.md index 7709783fe54f..3565c57aac93 100644 --- a/translations/ru-RU/content/github/site-policy/github-enterprise-cloud-evaluation-agreement.md +++ b/translations/ru-RU/content/github/site-policy/github-enterprise-cloud-evaluation-agreement.md @@ -28,7 +28,7 @@ CUSTOMER UNDERSTANDS AND AGREES THAT ANY MATERIALS OR INFORMATION THAT GITHUB PR IN NO EVENT WILL GITHUB BE LIABLE TO CUSTOMER OR TO ANY THIRD PARTY FOR ANY INDIRECT, SPECIAL, INCIDENTAL, CONSEQUENTIAL, EXEMPLARY OR PUNITIVE DAMAGES, INCLUDING BUT NOT LIMITED TO DAMAGES FOR LOST DATA, LOST PROFITS OR COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, HOWEVER CAUSED AND UNDER ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, TORT (INCLUDING WITHOUT LIMITATION PRODUCTS LIABILITY, STRICT LIABILITY AND NEGLIGENCE), OR ANY OTHER THEORY, AND WHETHER OR NOT THE PARTY KNEW OR SHOULD HAVE KNOWN ABOUT THE POSSIBILITY OF SUCH DAMAGE. IN NO EVENT WILL  GITHUB'S AGGREGATE LIABILITY ARISING OUT OF OR RELATED TO THIS EVALUATION AGREEMENT FOR ANY CAUSE WHATSOEVER, AND REGARDLESS OF THE FORM OF ACTION, WHETHER IN CONTRACT OR IN TORT, EXCEED FIVE HUNDRED DOLLARS ($500.00) USD. THE FOREGOING LIMITATIONS WILL APPLY NOTWITHSTANDING THE FAILURE OF ESSENTIAL PURPOSE OF ANY LIMITED REMEDY STATED IN THIS EVALUATION AGREEMENT. -### 5. Приватность +### 5. Конфиденциальность 5.1 As part of the development and evaluation of our evaluation programs, GitHub needs to collect information about how Customer uses services and programs and how GitHub can improve them. GitHub may collect certain additional personal information from Customer. For example, GitHub may invite Customer to provide Feedback (as explained in Section 6 below). GitHub might ask questions about Customer's  experiences, familiarity with the product, or demographic information. GitHub uses this information to improve its products and services and does not sell Feedback to third parties or advertisers. Customer may decline to provide Feedback, decline to answer specific questions, or contact GitHub to delete or alter the information it has collected about Customer. diff --git a/translations/ru-RU/content/github/site-policy/github-enterprise-service-level-agreement.md b/translations/ru-RU/content/github/site-policy/github-enterprise-service-level-agreement.md index 4b5f1a209cb2..25edfff43e19 100644 --- a/translations/ru-RU/content/github/site-policy/github-enterprise-service-level-agreement.md +++ b/translations/ru-RU/content/github/site-policy/github-enterprise-service-level-agreement.md @@ -8,8 +8,6 @@ versions: free-pro-team: '*' --- -# GitHub Enterprise Service Level Agreement - **Short version:** GitHub guarantees a 99.9% quarterly uptime commitment for the GitHub Enterprise Cloud service (the “**Service Level**” or “**SLA**”). If GitHub does not meet the SLA, then Customer will be entitled to a service credit to Customer’s account (“**Service Credits**”). For definitions of each Service feature (“**Service Feature**”) and to review historical and current Uptime, visit the [GitHub Status Page](https://www.githubstatus.com/). Capitalized terms used but not defined in this SLA have the meaning assigned in Customer’s applicable agreement. @@ -20,7 +18,7 @@ For definitions of each Service feature (“**Service Feature**”) and to revi | **Service Feature** | **Uptime Calculation** | **Определения** | **Service Credits Calculation** | | --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | -| The **Service** includes the following Service Features:
    • Вопросы
    • Запросы на слияние
    • Git Operations
    • API Requests
    • Webhooks
    • Pages
    • Actions
    • Packages
    | (total minutes in a calendar quarter - Downtime) / total minutes in a calendar quarter | “**Downtime**” is a period of time where either (a) the error rate exceeds five percent (5%) in a given minute for any Service Feature or (b) the Service was unavailable as determined by a combination of GitHub's internal and external monitoring systems. | A Service Credits claim may be based on either (not both) of the following calculations:
    • 10% of the amount Customer paid for a Service Feature in a calendar quarter where the Uptime for that Service Feature was less than 99.9%, but greater than 99.0%.

      OR

    • 25% of the amount Customer paid for a Service Feature in a calendar quarter where the Uptime of that Service Feature was less than 99.0%.
    | | +| The **Service** includes the following Service Features:
    • Вопросы
    • Запросы на слияние
    • Git Operations
    • API Requests
    • Webhooks
    • Pages
    • Actions
    • Packages
    | (total minutes in a calendar quarter - Downtime) / total minutes in a calendar quarter | “**Downtime**” is a period of time where either (a) the error rate exceeds five percent (5%) in a given minute for any Service Feature or (b) the Service was unavailable as determined by a combination of GitHub's internal and external monitoring systems. | A Service Credits claim may be based on either (not both) of the following calculations:
    • 10% of the amount Customer paid for a Service Feature in a calendar quarter where the Uptime for that Service Feature was less than or equal to 99.9%, but greater than 99.0%.

      OR

    • 25% of the amount Customer paid for a Service Feature in a calendar quarter where the Uptime of that Service Feature was less than 99.0%.
    | | | **Actions** | (Total Triggered Executions – Unavailable Executions) / (Total Triggered Executions) x 100 | “**Total Triggered Executions**” is the total number of all Actions executions triggered by Customer in a calendar quarter.

    “**Unavailable Executions**” is the total number of executions within Total Triggered Executions which failed to run in a calendar quarter. An execution failed to run when the Actions history log did not capture any output five (5) minutes after the trigger was successfully fired. | Same as above | | **Packages** | Transfers Uptime = same as Actions

    Storage Uptime = 100% - Average Error Rate*

    *The Uptime Calculation excludes public usage and storage transactions that do not count toward either Total Storage Transactions or Failed Storage Transactions (including pre-authentication failures; authentication failures; attempted transactions for storage accounts over their prescribed quotas). | “**Error Rate**” is the total number of Failed Storage Transactions divided by the Total Storage Transactions during a set time interval (currently set at one hour). If the Total Storage Transactions in a given one-hour interval is zero, the error rate for that interval is 0%.

    “**Average Error Rate**” is the sum of Error Rates for each hour in a calendar quarter divided by the total number of hours in a calendar quarter. | Same as above | diff --git a/translations/ru-RU/content/github/site-policy/github-open-source-applications-terms-and-conditions.md b/translations/ru-RU/content/github/site-policy/github-open-source-applications-terms-and-conditions.md index d2bf1503881f..55101a57b639 100644 --- a/translations/ru-RU/content/github/site-policy/github-open-source-applications-terms-and-conditions.md +++ b/translations/ru-RU/content/github/site-policy/github-open-source-applications-terms-and-conditions.md @@ -28,7 +28,7 @@ The license grant included with the Software is not for GitHub's trademarks, whi The names GitHub, GitHub Desktop, GitHub for Mac, GitHub for Windows, Atom, the Octocat, and related GitHub logos and/or stylized names are trademarks of GitHub. You agree not to display or use these trademarks in any manner without GitHub's prior, written permission, except as allowed by GitHub's Logos and Usage Policy: https://github.com/logos. -### Приватность +### Конфиденциальность The Software may collect personal information. You may control what information the Software collects in the settings panel. If the Software does collect personal information on GitHub's behalf, GitHub will process that information in accordance with the [GitHub Privacy Statement](/articles/github-privacy-statement/). diff --git a/translations/ru-RU/content/github/site-policy/github-pre-release-program.md b/translations/ru-RU/content/github/site-policy/github-pre-release-program.md index d0dd427c0aa4..f076491b918e 100644 --- a/translations/ru-RU/content/github/site-policy/github-pre-release-program.md +++ b/translations/ru-RU/content/github/site-policy/github-pre-release-program.md @@ -62,7 +62,7 @@ This Agreement is a legal agreement between you (“you”, "your") and GitHub, Nothing in this Agreement will impair our right to develop, acquire, license, market, promote or distribute products, software or technologies that might compete with yours. -### 11. Приватность +### 11. Конфиденциальность As part of the development and evaluation of our pre-release programs, we need to collect information about how you use the services and how we can improve them. By agreeing to participate in GitHub's pre-release programs, you agree that you have read and consented to our [Full Privacy Policy](/articles/github-privacy-statement/). diff --git a/translations/ru-RU/content/github/site-policy/github-privacy-statement.md b/translations/ru-RU/content/github/site-policy/github-privacy-statement.md index 9abdb101ef33..46e2813ce0b1 100644 --- a/translations/ru-RU/content/github/site-policy/github-privacy-statement.md +++ b/translations/ru-RU/content/github/site-policy/github-privacy-statement.md @@ -1,5 +1,5 @@ --- -title: Заявление о конфиденциальности GitHub +title: Политика конфиденциальности GitHub redirect_from: - /privacy/ - /privacy-policy/ @@ -45,7 +45,7 @@ Of course, the short version and the Summary below don't tell you everything, so | [Contacting GitHub](#contacting-github) | Please feel free to contact us if you have questions about our Privacy Statement. | | [Translations](#translations) | We provide links to some translations of the Privacy Statement. | -## Заявление о конфиденциальности GitHub +## Политика конфиденциальности GitHub ### What information GitHub collects @@ -227,7 +227,7 @@ We provide a web page on [cookies and tracking](/github/site-policy/github-subpr We use a number of third-party analytics and service providers to help us evaluate our Users' use of GitHub, compile statistical reports on activity, and improve our content and Website performance. We only use these third-party analytics providers on certain areas of our Website, and all of them have signed data protection agreements with us that limit the type of User Personal Information they can collect and the purpose for which they can process the information. In addition, we use our own internal analytics software to provide features and improve our content and performance. -Some browsers have incorporated "Do Not Track" (DNT) features that can send a signal to the websites you visit indicating you do not wish to be tracked. GitHub responds to browser DNT signals and follows the [W3C standard for responding to DNT signals](https://www.w3.org/TR/tracking-dnt/). If you have not enabled DNT on a browser that supports it, cookies on some parts of our Website will track your online browsing activity on other online services over time, though we do not permit third parties other than our analytics and service providers to track GitHub Users' activity over time on GitHub. +Some browsers have incorporated "Do Not Track" (DNT) features that can send a signal to the websites you visit indicating you do not wish to be tracked. GitHub responds to browser DNT signals and follows the [W3C standard for responding to DNT signals](https://www.w3.org/TR/tracking-dnt/). If you have not enabled DNT on a browser that supports it, cookies on some parts of our Website will track your online browsing activity on other online services over time, though we do not permit third parties other than our analytics and service providers to track GitHub Users' activity over time on GitHub. You can read more about DNT in our [Tracking on GitHub](/github/site-policy/github-subprocessors-and-cookies#tracking-on-github) section of our [GitHub Subprocessors and Cookies](/github/site-policy/github-subprocessors-and-cookies) page. ### How GitHub secures your information diff --git a/translations/ru-RU/content/github/site-policy/github-research-program-terms.md b/translations/ru-RU/content/github/site-policy/github-research-program-terms.md index 25081c9b1cd0..243bc08024c8 100644 --- a/translations/ru-RU/content/github/site-policy/github-research-program-terms.md +++ b/translations/ru-RU/content/github/site-policy/github-research-program-terms.md @@ -28,7 +28,7 @@ The obligations in this Section 2 won’t apply to information that you can prov All Confidential Information remains the sole and exclusive property of GitHub. Neither party acquires any intellectual property rights under this Agreement, unless expressly specified herein. -### D. Приватность +### D. Конфиденциальность By participating in this Program, you consent to our use of your personal information for research purposes, and not for any other purposes. As part of the Program, we may use your personal information to contact you, or retain your information, to contact you at a later date. Personal information does not include aggregated, non-personally identifying information. We may use aggregated or other non-personally identifying information collected through the program to operate, analyze, and improve our products and services. diff --git a/translations/ru-RU/content/github/site-policy/github-subprocessors-and-cookies.md b/translations/ru-RU/content/github/site-policy/github-subprocessors-and-cookies.md index 09004e7ab500..47eab52828d7 100644 --- a/translations/ru-RU/content/github/site-policy/github-subprocessors-and-cookies.md +++ b/translations/ru-RU/content/github/site-policy/github-subprocessors-and-cookies.md @@ -10,7 +10,7 @@ versions: free-pro-team: '*' --- -Effective date: **August 12, 2020** +Effective date: **October 2, 2020** GitHub provides a great deal of transparency regarding how we use your data, how we collect your data, and with whom we share your data. To that end, we provide this page, which details [our subprocessors](#github-subprocessors), how we use [cookies](#cookies-on-github), and where and how we perform any [tracking on GitHub](#tracking-on-github). @@ -19,7 +19,7 @@ GitHub provides a great deal of transparency regarding how we use your data, how When we share your information with third party subprocessors, such as our vendors and service providers, we remain responsible for it. We work very hard to maintain your trust when we bring on new vendors, and we require all vendors to enter into data protection agreements with us that restrict their processing of Users' Personal Information (as defined in the [Privacy Statement](/articles/github-privacy-statement/)). | Name of Subprocessor | Description of Processing | Location of Processing | Corporate Location | -| -------------------- | -------------------------------------------------- | ---------------------- | ------------------ | +|:-------------------- |:-------------------------------------------------- |:---------------------- |:------------------ | | Automattic | Blogging service | United States | United States | | AWS Amazon | Data hosting | United States | United States | | Braintree (PayPal) | Subscription credit card payment processor | United States | United States | @@ -28,7 +28,7 @@ When we share your information with third party subprocessors, such as our vendo | DiscoverOrg | Marketing data enrichment service | United States | United States | | Eloqua | Marketing campaign automation | United States | United States | | Google Apps | Internal company infrastructure | United States | United States | -| Google Analytics | Website analytics and performance | United States | United States | +| Google Analytics | Analytics and performance | United States | United States | | LinkedIn Navigator | Marketing data enrichment service | United States | United States | | Magic Robot | Campaign reporting (Salesforce Add-on) | United States | United States | | MailChimp | Customer ticketing mail services provider | United States | United States | @@ -49,63 +49,49 @@ When we bring on a new subprocessor who handles our Users' Personal Information, ### Cookies on GitHub -GitHub uses cookies to make interactions with our service easy and meaningful. We use cookies (and similar technologies, like HTML5 localStorage) to keep you logged in, remember your preferences, provide information for future development of GitHub, and to advertise GitHub's products and services to you on third party sites. - -A cookie is a small piece of text that our web server stores on your computer or mobile device, which your browser sends to us when you return to our site. Cookies do not necessarily identify you if you are merely visiting GitHub; however, a cookie may store a unique identifier for each logged in user. We use cookies to keep you logged in, remember your preferences, and provide information for future development of GitHub. For security reasons, we use cookies to identify a device. By using our website, you agree that we can place these types of cookies on your computer or device. If you disable your browser or device’s ability to accept these cookies, you will not be able to log in or use GitHub’s services. On certain areas of the website, we may also use cookies to identify you and/or your device to advertise GitHub products and services to you on third party sites. - -GitHub sets the following cookies on our users for the following reasons: - -| Name of Cookie | Reason | -| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- | -| `user_session` | This cookie is used to log you in. | -| `logged_in` | This cookie is used to signal to us that the user is already logged in. | -| `dotcom_user` | This cookie is used to signal to us that the user is already logged in. | -| `_gh_sess` | This cookie is used for temporary application and framework state between pages like what step the user is on in a multiple step form. | -| `tz` | This cookie allows your browser to tell us what time zone you're in. | -| `gist_user_session` | This cookie is used by Gist when running on a separate host. | -| `saml_csrf_token` | This cookie is set by SAML auth path method to associate a token with the client. | -| `saml_return_to` | This cookie is set by the SAML auth path method to maintain state during the SAML authentication loop. | -| `gist_oauth_csrf` | This cookie is set by Gist to ensure the user that started the oauth flow is the same user that completes it. | -| `__Host-user_session_same_site` | This cookie is set to ensure that browsers that support SameSite cookies can check to see if a request originates from GitHub. | -| `__Host-gist_user_session_same_site` | This cookie is set to ensure that browsers that support SameSite cookies can check to see if a request originates from GitHub. | -| `_ga` | This cookie is used by Google Analytics. | -| `_gat` | This cookie is used by Google Analytics. | -| `_gid` | This cookie is used by Google Analytics. | -| `_octo` | This cookie is used by Octolytics, our internal analytics service, to distinguish unique users and clients. | -| `tracker` | This cookie tracks the referring source for signup analytics. | - -Certain pages on our site may set other third party cookies. For example, we may embed content, such as videos, from another site that sets a cookie. While we try to minimize these third party cookies, we can’t always control what cookies this third party content sets. +GitHub uses cookies and similar technologies (collectively, “cookies”) to provide and secure our websites, as well as to analyze the usage of our websites, in order to offer you a great user experience. Please take a look at our [Privacy Statement](/github/site-policy/github-privacy-statement#our-use-of-cookies-and-tracking) if you’d like more information about cookies, and on how and why we use them. + +Since the number and names of cookies may change,the table below may be updated from time to time. + +| Service Provider | Cookie Name | Description | Expiration* | +|:------------------ |:------------------------------------ |:------------------------------------------------------------------------------------------------------------------------------------------ |:------------------------------------------------------------- | +| GitHub | `app_manifest_token` | This cookie is used during the App Manifest flow to maintain the state of the flow during the redirect to fetch a user session. | five minutes | +| GitHub | `cookie-preferences` | This cookie is used to track user cookie preferences. | one year | +| GitHub | `_device_id` | This cookie is used to track recognized devices. | one year | +| GitHub | `dotcom_user` | This cookie is used to signal to us that the user is already logged in. | one year | +| GitHub | `_gh_ent` | This cookie is used for temporary application and framework state between pages like what step the customer is on in a multiple step form. | two weeks | +| GitHub | `_gh_sess` | This cookie is used for temporary application and framework state between pages like what step the user is on in a multiple step form. | сессия | +| GitHub | `gist_oauth_csrf` | This cookie is set by Gist to ensure the user that started the oauth flow is the same user that completes it. | deleted when oauth state is validated | +| GitHub | `gist_user_session` | This cookie is used by Gist when running on a separate host. | two weeks | +| GitHub | `has_recent_activity` | This cookie is used to prevent showing the security interstitial to users that have visited the app recently. | one hour | +| GitHub | `__Host-gist_user_session_same_site` | This cookie is set to ensure that browsers that support SameSite cookies can check to see if a request originates from GitHub. | two weeks | +| GitHub | `__Host-user_session_same_site` | This cookie is set to ensure that browsers that support SameSite cookies can check to see if a request originates from GitHub. | two weeks | +| GitHub | `logged_in` | This cookie is used to signal to us that the user is already logged in. | one year | +| GitHub | `marketplace_repository_ids` | This cookie is used for the marketplace installation flow. | one hour | +| GitHub | `marketplace_suggested_target_id` | This cookie is used for the marketplace installation flow. | one hour | +| GitHub | `_octo` | This cookie is used by our internal analytics service to distinguish unique users and clients. | one year | +| GitHub | `org_transform_notice` | This cookie is used to provide notice during organization transforms. | one hour | +| GitHub | `private_mode_user_session` | This cookie is used for Enterprise authentication requests. | two weeks | +| GitHub | `saml_csrf_token` | This cookie is set by SAML auth path method to associate a token with the client. | until user closes browser or completes authentication request | +| GitHub | `saml_csrf_token_legacy` | This cookie is set by SAML auth path method to associate a token with the client. | until user closes browser or completes authentication request | +| GitHub | `saml_return_to` | This cookie is set by the SAML auth path method to maintain state during the SAML authentication loop. | until user closes browser or completes authentication request | +| GitHub | `saml_return_to_legacy` | This cookie is set by the SAML auth path method to maintain state during the SAML authentication loop. | until user closes browser or completes authentication request | +| GitHub | `tz` | This cookie allows your browser to tell us what time zone you're in. | сессия | +| GitHub | `user_session` | This cookie is used to log you in. | two weeks | +| Google Analytics** | `_ga` | This cookie is used by Google Analytics. | two years | +| Google Analytics** | `_gat` | This cookie is used by Google Analytics. | one minute | +| Google Analytics** | `_gid` | This cookie is used by Google Analytics. | one day | + +_*_ The **expiration** dates for the cookies listed below generally apply on a rolling basis. + +_**_ We use **Google Analytics** as a third party analytics service to collect information about how our website performs and how our users, in general, navigate through and use GitHub. This helps us evaluate our users' use of GitHub, compile statistical reports on activity, and improve our content and website performance. + +You can control your Google Analytics cookie preferences through our cookie preference link located at the footer of our website. In addition, Google provides further information about its own privacy practices and [offers a browser add-on to opt out of Google Analytics tracking](https://tools.google.com/dlpage/gaoptout). + +(!) Please note certain pages on our website may set other third party cookies. For example, we may embed content, such as videos, from another site that sets a cookie. While we try to minimize these third party cookies, we can’t always control what cookies this third party content sets. ### Tracking on GitHub -"[Do Not Track](https://www.eff.org/issues/do-not-track)" (DNT) is a privacy preference you can set in your browser if you do not want online services — specifically ad networks — to collect and share certain kinds of information about your online activity from third party tracking services. GitHub responds to browser DNT signals and follows the [W3C standard for responding to DNT signals](https://www.w3.org/TR/tracking-dnt/). If you would like to set your browser to signal that you would not like to be tracked, please check your browser's documentation for how to enable that signal. There are also good applications that block online tracking, such as [Privacy Badger](https://www.eff.org/privacybadger). - -If you have not enabled DNT on a browser that supports it, cookies on some parts of our website will track your online browsing activity on other online services over time, though we do not permit third parties other than our analytics and service providers to track GitHub users' activity over time on GitHub. We use these cookies to allow us to advertise GitHub products and services to you on third party websites and services. We also have agreements with certain vendors, such as analytics providers, who help us track visitors' movements on certain pages on our site. Only our vendors, who are collecting personal information on our behalf, may collect data on our pages, and we have signed data protection agreements with every vendor who collects this data on our behalf. We use the data we receive from these vendors to better understand our visitors' interests, to understand our website's performance, and to improve our content. Any analytics vendor will be listed in our Subprocessor List above, and you may see a list of every page where we collect this kind of data below. - -#### Google Analytics - -We use Google Analytics as a third party analytics service, and to track our advertising campaigns on third party websites and services. We use Google Analytics to collect information about how our website performs and how our users, in general, navigate through and use GitHub. This helps us evaluate our users' use of GitHub; compile statistical reports on activity; and improve our content and website performance. Google provides further information about its own privacy practices and [offers a browser add-on to opt out of Google Analytics tracking](https://tools.google.com/dlpage/gaoptout). - -#### Pages on GitHub where analytics may be enabled - -Pages at URLs that contain any of the following domains and paths (including any subdomains or subpaths) on our sites may have analytics or other tracking code enabled. If you would like to prevent us from collecting information about your browsing activity on GitHub, you may use a tracking blocker such as [Privacy Badger](https://www.eff.org/privacybadger) or opt out of Google Analytics tracking. - -- github.com/home (if you are logged out or do not have an account, this is the page you will see when you go to github.com) -- github.com/about -- github.blog -- github.com/enterprise -- github.com/collections -- github.com/developer-stories -- github.com/events -- github.com/explore -- github.com/features -- github.com/logos -- github.com/nonprofit -- github.com/open-source -- github.com/personal -- github.com/pricing -- github.com/ten -- github.com/trending -- resources.github.com -- de.github.com -- fr.github.com +"[Do Not Track](https://www.eff.org/issues/do-not-track)" (DNT) is a privacy preference you can set in your browser if you do not want online services to collect and share certain kinds of information about your online activity from third party tracking services. GitHub responds to browser DNT signals and follows the [W3C standard for responding to DNT signals](https://www.w3.org/TR/tracking-dnt/). If you would like to set your browser to signal that you would not like to be tracked, please check your browser's documentation for how to enable that signal. There are also good applications that block online tracking, such as [Privacy Badger](https://www.eff.org/privacybadger). + +If you have not enabled DNT on a browser that supports it, cookies on some parts of our website will track your online browsing activity on other online services over time, though we do not permit third parties other than our analytics and service providers to track GitHub users' activity over time on GitHub. We have agreements with certain vendors, such as analytics providers, who help us track visitors' movements on certain pages on our website. Only our vendors, who are collecting personal information on our behalf, may collect data on our pages, and we have signed data protection agreements with every vendor who collects this data on our behalf. We use the data we receive from these vendors to better understand our visitors' interests, to understand our website's performance, and to improve our content. Any analytics vendor will be listed in our [subprocessor list](#github-subprocessors), and you may see a list of every page where we collect this kind of data below. diff --git a/translations/ru-RU/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md b/translations/ru-RU/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md index ea41eaa2c2d9..6d38f23277fe 100644 --- a/translations/ru-RU/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md +++ b/translations/ru-RU/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md @@ -50,7 +50,7 @@ To join {% data variables.product.prodname_sponsors %} as an individual contribu ### Submitting your bank information -As a sponsored organization, you must receive payouts to a dedicated bank account for your organization in a supported region. You can get a business bank account through services like [Open Collective](https://opencollective.com/) and [Stripe Atlas](https://stripe.com/atlas). {% data reusables.sponsors.stripe-supported-regions %} +As a sponsored organization, you must receive payouts to a dedicated bank account for your organization in a supported region. You can get a business bank account through services like [Open Collective](https://opencollective.com/) and [Stripe Atlas](https://stripe.com/atlas). The region your organization legally operates in and the region of your bank account must match. The person setting up {% data variables.product.prodname_sponsors %} for the organization must live in the same supported region, too. {% data reusables.sponsors.stripe-supported-regions %} {% data reusables.sponsors.double-check-stripe-info %} diff --git a/translations/ru-RU/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md b/translations/ru-RU/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md index d86dccc1fb63..83f2ce29f2aa 100644 --- a/translations/ru-RU/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md +++ b/translations/ru-RU/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md @@ -50,7 +50,7 @@ After {% data variables.product.prodname_dotcom %} reviews your application, you ### Submitting your bank information -If you live in a supported region, you can follow these instructions to submit your bank information by creating a Stripe Connect account. {% data reusables.sponsors.stripe-supported-regions %} +If you live in a supported region, you can follow these instructions to submit your bank information by creating a Stripe Connect account. Your region of residence and the region of your bank account must match. {% data reusables.sponsors.stripe-supported-regions %} {% data reusables.sponsors.double-check-stripe-info %} diff --git a/translations/ru-RU/content/github/using-git/dealing-with-non-fast-forward-errors.md b/translations/ru-RU/content/github/using-git/dealing-with-non-fast-forward-errors.md index 5db28fcbd4e9..84fcb3d3c645 100644 --- a/translations/ru-RU/content/github/using-git/dealing-with-non-fast-forward-errors.md +++ b/translations/ru-RU/content/github/using-git/dealing-with-non-fast-forward-errors.md @@ -11,9 +11,9 @@ versions: If another person has pushed to the same branch as you, Git won't be able to push your changes: ```shell -$ git push origin master +$ git push origin main > To https://{% data variables.command_line.codeblock %}/USERNAME/REPOSITORY.git -> ! [rejected] master -> master (non-fast-forward) +> ! [rejected] main -> main (non-fast-forward) > error: failed to push some refs to 'https://{% data variables.command_line.codeblock %}/USERNAME/REPOSITORY.git' > To prevent you from losing history, non-fast-forward updates were rejected > Merge the remote changes (e.g. 'git pull') before pushing again. See the diff --git a/translations/ru-RU/content/github/using-git/splitting-a-subfolder-out-into-a-new-repository.md b/translations/ru-RU/content/github/using-git/splitting-a-subfolder-out-into-a-new-repository.md index efb51dfd04e1..91ced35d3642 100644 --- a/translations/ru-RU/content/github/using-git/splitting-a-subfolder-out-into-a-new-repository.md +++ b/translations/ru-RU/content/github/using-git/splitting-a-subfolder-out-into-a-new-repository.md @@ -33,7 +33,7 @@ If you create a new clone of the repository, you won't lose any of your Git hist {% endtip %} {% endwindows %} - - `BRANCH-NAME`: The default branch for your current project, for example, `master` or `gh-pages`. + - `BRANCH-NAME`: The default branch for your current project, for example, `main` or `gh-pages`. ```shell $ git filter-branch --prune-empty --subdirectory-filter FOLDER-NAME BRANCH-NAME # Filter the specified branch in your directory and remove empty commits diff --git a/translations/ru-RU/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md b/translations/ru-RU/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md index 74d3e06678bc..2861876f6d20 100644 --- a/translations/ru-RU/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md +++ b/translations/ru-RU/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md @@ -47,7 +47,6 @@ You can use the dependency graph to: {% if currentVersion == "free-pro-team@latest" %}To generate a dependency graph, {% data variables.product.product_name %} needs read-only access to the dependency manifest and lock files for a repository. The dependency graph is automatically generated for all public repositories and you can choose to enable it for private repositories. For information about enabling or disabling it for private repositories, see "[Exploring the dependencies of a repository](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository)."{% endif %} - {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %}If the dependency graph is not available in your system, your site administrator can enable the dependency graph and {% data variables.product.prodname_dependabot_short %} alerts. For more information, see "[Enabling alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server)."{% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %} If the dependency graph is not available in your system, your site administrator can enable the dependency graph and security alerts. For more information, see "[Enabling alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server)." @@ -60,15 +59,15 @@ When the dependency graph is first enabled, any manifest and lock files for supp The recommended formats explicitly define which versions are used for all direct and all indirect dependencies. If you use these formats, your dependency graph is more accurate. It also reflects the current build set up and enables the dependency graph to report vulnerabilities in both direct and indirect dependencies.{% if currentVersion == "free-pro-team@latest" %} Indirect dependencies that are inferred from a manifest file (or equivalent) are excluded from the checks for vulnerable dependencies.{% endif %} -| Package manager | Языки | Recommended formats | All supported formats | -| --------------------------------------------------------------- | -------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------- | -| {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} | Composer | PHP | `composer.lock` | `composer.json`, `composer.lock` |{% endif %} -| `dotnet` CLI | .NET languages (C#, C++, F#, VB) | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj` | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj`, `packages.config` | -| Maven | Java, Scala | `pom.xml` | `pom.xml` | -| npm | JavaScript | `package-lock.json` | `package-lock.json`, `package.json` | -| Python PIP | Python | `requirements.txt`, `pipfile.lock` | `requirements.txt`, `pipfile.lock`, `setup.py`* | -| RubyGems | Ruby | `Gemfile.lock` | `Gemfile.lock`, `Gemfile`, `*.gemspec` | -| Yarn | JavaScript | `yarn.lock` | `package.json`, `yarn.lock` | +| Package manager | Языки | Recommended formats | All supported formats | +| --------------- | -------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------- | +| Composer | PHP | `composer.lock` | `composer.json`, `composer.lock` | +| `dotnet` CLI | .NET languages (C#, C++, F#, VB) | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj` | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj`, `packages.config` | +| Maven | Java, Scala | `pom.xml` | `pom.xml` | +| npm | JavaScript | `package-lock.json` | `package-lock.json`, `package.json` | +| Python PIP | Python | `requirements.txt`, `pipfile.lock` | `requirements.txt`, `pipfile.lock`, `setup.py`* | +| RubyGems | Ruby | `Gemfile.lock` | `Gemfile.lock`, `Gemfile`, `*.gemspec` | +| Yarn | JavaScript | `yarn.lock` | `package.json`, `yarn.lock` | {% note %} diff --git a/translations/ru-RU/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md b/translations/ru-RU/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md index f939d683ff29..0ab57b85eb9b 100644 --- a/translations/ru-RU/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md +++ b/translations/ru-RU/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md @@ -26,7 +26,8 @@ The dependency graph shows the dependencies{% if currentVersion == "free-pro-tea #### Dependencies view {% if currentVersion == "free-pro-team@latest" %} -Dependencies are grouped by ecosystem. You can expand a dependency to view its dependencies. For dependencies on public repositories hosted on {% data variables.product.product_name %}, you can also click a dependency to view the repository. Dependencies on private repositories, private packages, or unrecognized files are shown in plain text. +Dependencies are grouped by ecosystem. You can expand a dependency to view its dependencies. For dependencies on public repositories hosted on +{% data variables.product.product_name %}, you can also click a dependency to view the repository. Dependencies on private repositories, private packages, or unrecognized files are shown in plain text. If vulnerabilities have been detected in the repository, these are shown at the top of the view for users with access to {% data variables.product.prodname_dependabot_alerts %}. @@ -35,7 +36,8 @@ If vulnerabilities have been detected in the repository, these are shown at the {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %} -Any direct and indirect dependencies that are specified in the repository's manifest or lock files are listed, grouped by ecosystem. If vulnerabilities have been detected in the repository, these are shown at the top of the view for users with access to {% data variables.product.prodname_dependabot_short %} alerts. +Any direct and indirect dependencies that are specified in the repository's manifest or lock files are listed, grouped by ecosystem. If vulnerabilities have been detected in the repository, these are shown at the top of the view for users with access to +{% data variables.product.prodname_dependabot_short %} alerts. {% note %} @@ -77,7 +79,7 @@ Any direct and indirect dependencies that are specified in the repository's mani For public repositories, the dependents view shows how the repository is used by other repositories. To show only the repositories that contain a library in a package manager, click **NUMBER Packages** immediately above the list of dependent repositories. The dependent counts are approximate and may not always match the dependents listed. -![График зависимостей](/assets/images/help/graphs/dependents_graph.png) +![Диаграмма зависимостей](/assets/images/help/graphs/dependents_graph.png) ### Enabling and disabling the dependency graph for a private repository @@ -98,7 +100,8 @@ You can disable the dependency graph at any time by clicking **Disable** next to If your dependency graph is empty, there may be a problem with the file containing your dependencies. Check the file to ensure that it's correctly formatted for the file type. {% if currentVersion == "free-pro-team@latest" %} -If the file is correctly formatted, then check its size. The dependency graph ignores individual manifest and lock files that are over 0.5 Mb, unless you are a {% data variables.product.prodname_enterprise %} user. It processes up to 20 manifest or lock files per repository by default, so you can split dependencies into smaller files in subdirectories of the repository.{% endif %} +If the file is correctly formatted, then check its size. The dependency graph ignores individual manifest and lock files that are over 0.5 Mb, unless you are a +{% data variables.product.prodname_enterprise %} user. It processes up to 20 manifest or lock files per repository by default, so you can split dependencies into smaller files in subdirectories of the repository.{% endif %} If a manifest or lock file is not processed, its dependencies are omitted from the dependency graph and they can't be checked for vulnerable dependencies. diff --git a/translations/ru-RU/content/github/visualizing-repository-data-with-graphs/visualizing-additions-and-deletions-to-content-in-a-repository.md b/translations/ru-RU/content/github/visualizing-repository-data-with-graphs/visualizing-additions-and-deletions-to-content-in-a-repository.md index 654bad4313e8..90eee8a5a058 100644 --- a/translations/ru-RU/content/github/visualizing-repository-data-with-graphs/visualizing-additions-and-deletions-to-content-in-a-repository.md +++ b/translations/ru-RU/content/github/visualizing-repository-data-with-graphs/visualizing-additions-and-deletions-to-content-in-a-repository.md @@ -11,7 +11,7 @@ versions: {% if currentVersion == "free-pro-team@latest" %} -![График частоты обновления кода](/assets/images/help/graphs/repo_code_frequency_graph_dotcom.png) +![Диаграмма частоты обновления кода](/assets/images/help/graphs/repo_code_frequency_graph_dotcom.png) {% endif %} diff --git a/translations/ru-RU/content/github/working-with-github-pages/about-github-pages-and-jekyll.md b/translations/ru-RU/content/github/working-with-github-pages/about-github-pages-and-jekyll.md index c411dae25336..80bc0ea4cc70 100644 --- a/translations/ru-RU/content/github/working-with-github-pages/about-github-pages-and-jekyll.md +++ b/translations/ru-RU/content/github/working-with-github-pages/about-github-pages-and-jekyll.md @@ -69,7 +69,8 @@ You can add `site.github` to a post or page to add any repository references met {% data reusables.pages.add-jekyll-theme %} For more information, see "[Themes](https://jekyllrb.com/docs/themes/)" in the Jekyll documentation. {% if currentVersion == "free-pro-team@latest" %} -You can add a supported theme to your site on {% data variables.product.prodname_dotcom %}. For more information, see "[Supported themes](https://pages.github.com/themes/)" on the {% data variables.product.prodname_pages %} site and "[Adding a theme to your {% data variables.product.prodname_pages %} site with the theme chooser](/articles/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser)." +You can add a supported theme to your site on +{% data variables.product.prodname_dotcom %}. For more information, see "[Supported themes](https://pages.github.com/themes/)" on the {% data variables.product.prodname_pages %} site and "[Adding a theme to your {% data variables.product.prodname_pages %} site with the theme chooser](/articles/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser)." To use any other open source Jekyll theme hosted on {% data variables.product.prodname_dotcom %}, you can add the theme manually.{% else %} You can add a theme to your site manually.{% endif %} For more information, see{% if currentVersion == "free-pro-team@latest" %} [themes hosted on {% data variables.product.prodname_dotcom %}](https://github.com/topics/jekyll-theme) and{% else %} "[Supported themes](https://pages.github.com/themes/)" on the {% data variables.product.prodname_pages %} site and{% endif %} "[Adding a theme to your {% data variables.product.prodname_pages %} site using Jekyll](/articles/adding-a-theme-to-your-github-pages-site-using-jekyll)." diff --git a/translations/ru-RU/content/github/working-with-github-pages/about-github-pages.md b/translations/ru-RU/content/github/working-with-github-pages/about-github-pages.md index d9e3e7790f3c..e904b6ba11fd 100644 --- a/translations/ru-RU/content/github/working-with-github-pages/about-github-pages.md +++ b/translations/ru-RU/content/github/working-with-github-pages/about-github-pages.md @@ -20,13 +20,15 @@ versions: {% data variables.product.prodname_pages %} is a static site hosting service that takes HTML, CSS, and JavaScript files straight from a repository on {% data variables.product.product_name %}, optionally runs the files through a build process, and publishes a website. You can see examples of {% data variables.product.prodname_pages %} sites in the [{% data variables.product.prodname_pages %} examples collection](https://github.com/collections/github-pages-examples). {% if currentVersion == "free-pro-team@latest" %} -You can host your site on {% data variables.product.prodname_dotcom %}'s `github.io` domain or your own custom domain. For more information, see "[Using a custom domain with {% data variables.product.prodname_pages %}](/articles/using-a-custom-domain-with-github-pages)." +You can host your site on +{% data variables.product.prodname_dotcom %}'s `github.io` domain or your own custom domain. For more information, see "[Using a custom domain with {% data variables.product.prodname_pages %}](/articles/using-a-custom-domain-with-github-pages)." {% endif %} To get started, see "[Creating a {% data variables.product.prodname_pages %} site](/articles/creating-a-github-pages-site)." {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -Organization owners can disable the publication of {% data variables.product.prodname_pages %} sites from the organization's repositories. For more information, see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)." +Organization owners can disable the publication of +{% data variables.product.prodname_pages %} sites from the organization's repositories. For more information, see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)." {% endif %} ### Types of {% data variables.product.prodname_pages %} sites @@ -44,7 +46,8 @@ For more information about how custom domains affect the URL for your site, see You can only create one user or organization site for each {% data variables.product.product_name %} account. Project sites, whether owned by an organization or a user account, are unlimited. {% if currentVersion != "free-pro-team@latest" %} -The URL where your site is available depends on whether subdomain isolation is enabled for {% data variables.product.product_location %}. +The URL where your site is available depends on whether subdomain isolation is enabled for +{% data variables.product.product_location %}. | Type of site | Subdomain isolation enabled | Subdomain isolation disabled | | ------------ | --------------------------- | ---------------------------- | @@ -132,8 +135,9 @@ Additionally, {% data variables.product.prodname_pages %} sites must refrain fro - Get-rich-quick schemes - Sexually obscene content - Content that misrepresents your identity or site purpose +If you have questions about whether your use or intended use falls into these categories, please contact -If you have questions about whether your use or intended use falls into these categories, please contact {% data variables.contact.contact_support %}. +{% data variables.contact.contact_support %}. {% endif %} ### MIME types on {% data variables.product.prodname_pages %} diff --git a/translations/ru-RU/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md b/translations/ru-RU/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md index b7dd7e8d42a3..046a4b845774 100644 --- a/translations/ru-RU/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md +++ b/translations/ru-RU/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md @@ -34,9 +34,7 @@ For more information about troubleshooting build errors, see "[Troubleshooting J We recommend testing your site locally, which allows you to see build error messages on the command line, and addressing any build failures before pushing changes to {% data variables.product.product_name %}. For more information, see "[Testing your {% data variables.product.prodname_pages %} site locally with Jekyll](/articles/testing-your-github-pages-site-locally-with-jekyll)." -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} When you create a pull request to update your publishing source on {% data variables.product.product_name %}, you can see build error messages on the **Checks** tab of the pull request. For more information, see "[About status checks](/articles/about-status-checks)." -{% endif %} When you push changes to your publishing source on {% data variables.product.product_name %}, {% data variables.product.prodname_pages %} will attempt to build your site. If the build fails, you'll receive an email at your primary email address. You'll also receive emails for build warnings. {% data reusables.pages.build-failure-email-server %} diff --git a/translations/ru-RU/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md b/translations/ru-RU/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md index a4366201d855..70ffc42bf080 100644 --- a/translations/ru-RU/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md +++ b/translations/ru-RU/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md @@ -21,9 +21,9 @@ People with write permissions for a repository can add a theme to a {% data vari {% data reusables.pages.navigate-publishing-source %} 2. Navigate to *_config.yml*. {% data reusables.repositories.edit-file %} -4. Add a new line to the file for the theme name. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - - To use a supported theme, t{% else %}T{% endif %}ype `theme: THEME-NAME`, replacing _THEME-NAME_ with the name of the theme as shown in the README of the theme's repository. For a list of supported themes, see "[Supported themes](https://pages.github.com/themes/)" on the {% data variables.product.prodname_pages %} site. ![Supported theme in config file](/assets/images/help/pages/add-theme-to-config-file.png){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - - To use any other Jekyll theme hosted on {% data variables.product.prodname_dotcom %}, type `remote_theme: THEME-NAME`, replacing THEME-NAME with the name of the theme as shown in the README of the theme's repository. ![Unsupported theme in config file](/assets/images/help/pages/add-remote-theme-to-config-file.png){% endif %} +4. Add a new line to the file for the theme name. + - To use a supported theme, type `theme: THEME-NAME`, replacing _THEME-NAME_ with the name of the theme as shown in the README of the theme's repository. For a list of supported themes, see "[Supported themes](https://pages.github.com/themes/)" on the {% data variables.product.prodname_pages %} site. ![Supported theme in config file](/assets/images/help/pages/add-theme-to-config-file.png) + - To use any other Jekyll theme hosted on {% data variables.product.prodname_dotcom %}, type `remote_theme: THEME-NAME`, replacing THEME-NAME with the name of the theme as shown in the README of the theme's repository. ![Unsupported theme in config file](/assets/images/help/pages/add-remote-theme-to-config-file.png) {% data reusables.files.write_commit_message %} {% data reusables.files.choose-commit-email %} {% data reusables.files.choose_commit_branch %} diff --git a/translations/ru-RU/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md b/translations/ru-RU/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md index 74bedb474038..89122faaf86c 100644 --- a/translations/ru-RU/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md +++ b/translations/ru-RU/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md @@ -24,7 +24,9 @@ Before you configure a publishing source, make sure the branch{% if currentVersi 4. Optionally, use the drop-down menu to select a folder for your publishing source. ![Drop-down menu to select a folder for publishing source](/assets/images/help/pages/publishing-source-folder-drop-down.png) 5. Click **Save**. ![Button to save changes to publishing source settings](/assets/images/help/pages/publishing-source-save.png) {% else %} -3. Under "{% data variables.product.prodname_pages %}", use the **Source** drop-down menu and select a publishing source. ![Drop down menu to select a publishing source](/assets/images/help/pages/publishing-source-drop-down.png) +3. Under " +{% data variables.product.prodname_pages %}", use the **Source** drop-down menu and select a publishing source. + ![Drop down menu to select a publishing source](/assets/images/help/pages/publishing-source-drop-down.png) {% endif %} ### Troubleshooting publishing problems with your {% data variables.product.prodname_pages %} site diff --git a/translations/ru-RU/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md b/translations/ru-RU/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md index 91901c6efbf7..4b13fcbafb08 100644 --- a/translations/ru-RU/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md +++ b/translations/ru-RU/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md @@ -40,7 +40,8 @@ To set up a `www` or custom subdomain, such as `www.example.com` or `blog.exampl {% data reusables.pages.navigate-site-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.pages.save-custom-domain %} -5. Navigate to your DNS provider and create a `CNAME` record that points your subdomain to the default domain for your site. For example, if you want to use the subdomain `www.example.com` for your user site, create a `CNAME` record that points `www.example.com` to `.github.io`. If you want to use the subdomain `www.anotherexample.com` for your organization site, create a `CNAME` record that points `www.anotherexample.com` to `.github.io`. The `CNAME` file should always point to `.github.io` or `.github.io`, excluding the repository name. {% data reusables.pages.contact-dns-provider %}{% data reusables.pages.default-domain-information %} +5. Navigate to your DNS provider and create a `CNAME` record that points your subdomain to the default domain for your site. For example, if you want to use the subdomain `www.example.com` for your user site, create a `CNAME` record that points `www.example.com` to `.github.io`. If you want to use the subdomain `www.anotherexample.com` for your organization site, create a `CNAME` record that points `www.anotherexample.com` to `.github.io`. The `CNAME` file should always point to `.github.io` or `.github.io`, excluding the repository name. +{% data reusables.pages.contact-dns-provider %}{% data reusables.pages.default-domain-information %} {% data reusables.command_line.open_the_multi_os_terminal %} 6. To confirm that your DNS record configured correctly, use the `dig` command, replacing _WWW.EXAMPLE.COM_ with your subdomain. ```shell diff --git a/translations/ru-RU/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md b/translations/ru-RU/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md index b80619b0b0f5..fb8fa64e991b 100644 --- a/translations/ru-RU/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md +++ b/translations/ru-RU/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md @@ -21,7 +21,9 @@ versions: 3. If the `gh-pages` branch was your publishing source, {% if currentVersion == "free-pro-team@latest" %}skip to step 6{% else %}your site is now unpublished and you can skip the remaining steps{% endif %}. {% data reusables.repositories.sidebar-settings %} -5. Under "{% data variables.product.prodname_pages %}", use the **Source** drop-down menu and select **None.** ![Drop down menu to select a publishing source](/assets/images/help/pages/publishing-source-drop-down.png) +5. Under " +{% data variables.product.prodname_pages %}", use the **Source** drop-down menu and select **None.** + ![Drop down menu to select a publishing source](/assets/images/help/pages/publishing-source-drop-down.png) {% data reusables.pages.update_your_dns_settings %} ### Unpublishing a user or organization site diff --git a/translations/ru-RU/content/github/working-with-github-support/about-github-support.md b/translations/ru-RU/content/github/working-with-github-support/about-github-support.md index 225ca3796330..c91e7c31732d 100644 --- a/translations/ru-RU/content/github/working-with-github-support/about-github-support.md +++ b/translations/ru-RU/content/github/working-with-github-support/about-github-support.md @@ -11,13 +11,13 @@ versions: Support options vary depending on your {% data variables.product.prodname_dotcom_the_website %} product. If you have any paid product, you can contact {% data variables.contact.github_support %}, in English. Your account may also include {% data variables.contact.premium_support %}. -| | {% data variables.product.prodname_gcf %} | Standard support | Premium support | -| ------------------------------------------------------ | ---------------------------------------------- | ---------------- | --------------- | -| {% data variables.product.prodname_free_user %} | X | | | -| {% data variables.product.prodname_pro %} | X | X | | -| {% data variables.product.prodname_team %} | X | X | | -| {% data variables.product.prodname_ghe_cloud %} | X | X | X | -| {% data variables.product.prodname_ghe_server %} | X | X | X | +| | {% data variables.product.prodname_gcf %} | Standard support | Premium support | +| -------------------------------------------------- | ----------------------------------------- | ---------------- | --------------- | +| {% data variables.product.prodname_free_user %} | X | | | +| {% data variables.product.prodname_pro %} | X | X | | +| {% data variables.product.prodname_team %} | X | X | | +| {% data variables.product.prodname_ghe_cloud %} | X | X | X | +| {% data variables.product.prodname_ghe_server %} | X | X | X | To see if there are currently any incidents affecting services on {% data variables.product.prodname_dotcom %}, or to subscribe and receive notifications of future status updates, visit {% data variables.product.prodname_dotcom %}'s [Status Page](https://www.githubstatus.com/). diff --git a/translations/ru-RU/content/github/writing-on-github/autolinked-references-and-urls.md b/translations/ru-RU/content/github/writing-on-github/autolinked-references-and-urls.md index 63231349724d..ebe24491b31d 100644 --- a/translations/ru-RU/content/github/writing-on-github/autolinked-references-and-urls.md +++ b/translations/ru-RU/content/github/writing-on-github/autolinked-references-and-urls.md @@ -45,15 +45,12 @@ References to a commit's SHA hash are automatically converted into shortened lin | Commit URL | https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | | SHA | a5c3785ed8d6a35868bc169f07e40e889087fd2e | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | | User@SHA | jlord@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -| Username/Repository@SHA | User/Repository@SHA: jlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord/sheetsee.js@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | +| Username/Repository@SHA | jlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord/sheetsee.js@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} ### Custom autolinks to external resources {% data reusables.repositories.autolink-references %} -{% endif %} - ### Дополнительная литература - "[Basic writing and formatting syntax](/articles/basic-writing-and-formatting-syntax)" diff --git a/translations/ru-RU/content/github/writing-on-github/basic-writing-and-formatting-syntax.md b/translations/ru-RU/content/github/writing-on-github/basic-writing-and-formatting-syntax.md index 662990062f26..558a31900db2 100644 --- a/translations/ru-RU/content/github/writing-on-github/basic-writing-and-formatting-syntax.md +++ b/translations/ru-RU/content/github/writing-on-github/basic-writing-and-formatting-syntax.md @@ -188,13 +188,10 @@ You can bring up a list of suggested issues and pull requests within the reposit For more information, see "[Autolinked references and URLs](/articles/autolinked-references-and-urls)." -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} ### Referencing external resources {% data reusables.repositories.autolink-references %} -{% endif %} - ### Content attachments Some {% data variables.product.prodname_github_app %}s provide information in {% data variables.product.product_name %} for URLs that link to their registered domains. {% data variables.product.product_name %} renders the information provided by the app under the URL in the body or comment of an issue or pull request. diff --git a/translations/ru-RU/content/github/writing-on-github/creating-gists.md b/translations/ru-RU/content/github/writing-on-github/creating-gists.md index f0068d5caed6..495822dd4931 100644 --- a/translations/ru-RU/content/github/writing-on-github/creating-gists.md +++ b/translations/ru-RU/content/github/writing-on-github/creating-gists.md @@ -27,13 +27,10 @@ If your site administrator has disabled private mode, you can also use anonymous {% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} - You'll receive a notification when: - You are the author of a gist. - Someone mentions you in a gist. - You subscribe to a gist, by clicking **Subscribe** at the top any gist. -{% endif %} You can pin gists to your profile so other people can see them easily. For more information, see "[Pinning items to your profile](/articles/pinning-items-to-your-profile)." diff --git a/translations/ru-RU/content/graphql/guides/managing-enterprise-accounts.md b/translations/ru-RU/content/graphql/guides/managing-enterprise-accounts.md index 78071166465d..fb66f4afcdde 100644 --- a/translations/ru-RU/content/graphql/guides/managing-enterprise-accounts.md +++ b/translations/ru-RU/content/graphql/guides/managing-enterprise-accounts.md @@ -5,7 +5,7 @@ redirect_from: - /v4/guides/managing-enterprise-accounts versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- ### About managing enterprise accounts with GraphQL diff --git a/translations/ru-RU/content/index.md b/translations/ru-RU/content/index.md index 2719012e5207..1800e3661d03 100644 --- a/translations/ru-RU/content/index.md +++ b/translations/ru-RU/content/index.md @@ -11,8 +11,6 @@ popularLinks: - /github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line - /github/using-git/managing-remote-repositories - /github/working-with-github-pages -versions: - free-pro-team: '*' - enterprise-server: '*' +versions: '*' --- diff --git a/translations/ru-RU/content/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights.md b/translations/ru-RU/content/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights.md index ae8a68971f9d..1d4e6eb41354 100644 --- a/translations/ru-RU/content/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights.md +++ b/translations/ru-RU/content/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights.md @@ -4,7 +4,7 @@ intro: '' product: '{% data reusables.gated-features.github-insights %}' permissions: 'Anyone with access to {% data variables.product.prodname_insights %} can navigate between {% data variables.product.prodname_enterprise %} and {% data variables.product.prodname_insights %}.' versions: - enterprise-server: '>=2.19' + enterprise-server: '*' --- Before you can navigate between {% data variables.product.prodname_enterprise %} and {% data variables.product.prodname_insights %}, a site administrator must enable a link between {% data variables.product.prodname_insights %} and {% data variables.product.prodname_enterprise %}. For more information, see "[Enabling a link between {% data variables.product.prodname_insights %} and {% data variables.product.prodname_enterprise %}](/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise)." diff --git a/translations/ru-RU/content/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise.md b/translations/ru-RU/content/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise.md index a07fd01a62e0..a423199ba2fd 100644 --- a/translations/ru-RU/content/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise.md +++ b/translations/ru-RU/content/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise.md @@ -7,7 +7,7 @@ redirect_from: - /github/installing-and-configuring-github-insights/navigating-between-github-insights-and-github-enterprise - /github/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise versions: - enterprise-server: '>=2.19' + enterprise-server: '*' --- After you enable the link, each user can navigate directly from {% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_insights %}. For more information, see "[Navigating between {% data variables.product.prodname_enterprise %} and {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights)." @@ -17,7 +17,8 @@ After you enable the link, each user can navigate directly from {% data variable ``` ghe-config 'app.github.insights-available' 'true' && ghe-config-apply ``` -3. Return to {% data variables.product.prodname_ghe_server %}. +3. Return to +{% data variables.product.prodname_ghe_server %}. {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.settings-tab %} diff --git a/translations/ru-RU/content/insights/installing-and-configuring-github-insights/installing-github-insights.md b/translations/ru-RU/content/insights/installing-and-configuring-github-insights/installing-github-insights.md index 8e002e395365..fe6fb8830d9c 100644 --- a/translations/ru-RU/content/insights/installing-and-configuring-github-insights/installing-github-insights.md +++ b/translations/ru-RU/content/insights/installing-and-configuring-github-insights/installing-github-insights.md @@ -28,7 +28,8 @@ versions: To connect {% data variables.product.prodname_insights %} to {% data variables.product.prodname_enterprise %}, you must create a {% data variables.product.prodname_github_app %} in an organization on {% data variables.product.prodname_enterprise %}. A slugged version of your app's name will be shown on {% data variables.product.prodname_enterprise %} when your integration takes an action. {% data reusables.enterprise_site_admin_settings.sign-in %} -2. Navigate to the organization you'd like to connect to {% data variables.product.prodname_insights %}. +2. Navigate to the organization you'd like to connect to +{% data variables.product.prodname_insights %}. {% data reusables.organizations.org_settings %} {% data reusables.organizations.github-apps-settings-sidebar %} 5. Click **New {% data variables.product.prodname_github_app %}**. ![New GitHub App button](/assets/images/help/apps/github_apps_new.png) diff --git a/translations/ru-RU/content/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images.md b/translations/ru-RU/content/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images.md index 44e44968fb7c..702b2af741e8 100644 --- a/translations/ru-RU/content/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images.md +++ b/translations/ru-RU/content/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images.md @@ -24,8 +24,8 @@ For more information, see "[About {% data variables.product.prodname_github_cont The domain for the {% data variables.product.prodname_container_registry %} is `ghcr.io`. -| Registry | Example URL | -| ---------------------------------------------------------------------- | --------------------------------------------------- | +| Registry | Example URL | +| ----------------------------------------------------------------- | --------------------------------------------------- | | {% data variables.product.prodname_registry %} Docker registry | `docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME` | | {% data variables.product.prodname_github_container_registry %} | `ghcr.io/OWNER/IMAGE_NAME` | @@ -33,7 +33,9 @@ The domain for the {% data variables.product.prodname_container_registry %} is ` You will need to authenticate to the {% data variables.product.prodname_container_registry %} with the base URL `ghcr.io`. We recommend creating a new access token for using the {% data variables.product.prodname_container_registry %}. -{% data reusables.package_registry.authenticate-to-container-registry %} +{% data reusables.package_registry.authenticate_with_pat_for_container_registry %} + +{% data reusables.package_registry.authenticate-to-container-registry-steps %} ### Migrating a Docker image using the Docker CLI @@ -55,7 +57,9 @@ To move Docker images that you host on {% data variables.product.prodname_regist $ docker tag docker.pkg.github.com/SOURCE_OWNER/SOURCE_REPOSITORY/SOURCE_IMAGE_NAME:VERSION ghcr.io/TARGET_OWNER/TARGET_IMAGE_NAME:VERSION ``` -4. Sign in to the new {% data variables.product.prodname_container_registry %}. We recommend creating a new PAT limited to the `read:packages` and `write:packages` scopes since you no longer need the `repo` scope and your previous PAT may not have the `write:packages` scope. +4. Sign in to the new + +{% data variables.product.prodname_container_registry %}. We recommend creating a new PAT limited to the `read:packages` and `write:packages` scopes since you no longer need the `repo` scope and your previous PAT may not have the `write:packages` scope. {% raw %} ```shell $ echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin diff --git a/translations/ru-RU/content/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image.md b/translations/ru-RU/content/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image.md index f3b86775a08b..5e4659729829 100644 --- a/translations/ru-RU/content/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image.md +++ b/translations/ru-RU/content/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image.md @@ -62,7 +62,9 @@ https://github.com/monalisa/hello_docker $ docker tag 38f737a91f39 ghcr.io/monalisa/hello_docker:latest ``` -5. If you haven't already, authenticate to {% data variables.product.prodname_github_container_registry %}. For more information, see "[Authenticating to GitHub Container Registry](/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images#authenticating-to-github-container-registry)." +5. If you haven't already, authenticate to + +{% data variables.product.prodname_github_container_registry %}. For more information, see "[Authenticating to GitHub Container Registry](/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images#authenticating-to-github-container-registry)." {% raw %} ```shell $ echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin diff --git a/translations/ru-RU/content/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images.md b/translations/ru-RU/content/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images.md index b88041a9a062..e4e1db91970c 100644 --- a/translations/ru-RU/content/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images.md +++ b/translations/ru-RU/content/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images.md @@ -12,13 +12,15 @@ To push and pull container images owned by an organization, an organization admi ### Authenticating to {% data variables.product.prodname_github_container_registry %} -{% data reusables.package_registry.authenticate-to-container-registry %} +{% data reusables.package_registry.authenticate_with_pat_for_container_registry %} + +{% data reusables.package_registry.authenticate-to-container-registry-steps %} ### Pushing container images This example pushes the latest version of `IMAGE-NAME`. ```shell - $ docker push ghcr.io/OWNER/IMAGE_NAME.latest + $ docker push ghcr.io/OWNER/IMAGE_NAME:latest ``` This example pushes the `2.5` version of the image. @@ -40,7 +42,7 @@ To ensure you're always using the same image, you can specify the exact containe ``` 2. Remove image locally as needed. ```shell - $ docker rmi ghcr.io/OWNER/IMAGE_NAME.latest + $ docker rmi ghcr.io/OWNER/IMAGE_NAME:latest ``` 3. Pull the container image with `@YOUR_SHA_VALUE` after the image name. diff --git a/translations/ru-RU/content/packages/publishing-and-managing-packages/about-github-packages.md b/translations/ru-RU/content/packages/publishing-and-managing-packages/about-github-packages.md index f907f0e3051b..e6ff8074dba3 100644 --- a/translations/ru-RU/content/packages/publishing-and-managing-packages/about-github-packages.md +++ b/translations/ru-RU/content/packages/publishing-and-managing-packages/about-github-packages.md @@ -34,7 +34,7 @@ You can review the package's README, some metadata like licensing, download stat #### About package permissions and visibility {% if currentVersion == "free-pro-team@latest" %} -| | Package registries | {% data variables.product.prodname_github_container_registry %} | +| | Package registries | {% data variables.product.prodname_github_container_registry %} | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Hosting locations | You can host multiple packages in one repository. | You can host multiple container images in one organization or user account. | | Permissions | Each package inherits the permissions of the repository where the package is hosted.

    For example, anyone with read permissions for a repository can install a package as a dependency in a project, and anyone with write permissions can publish a new package version. | For each container image, you can choose the access level that others have. The permissions for container image access are separate from your organization and repository permissions. | @@ -45,7 +45,7 @@ You can review the package's README, some metadata like licensing, download stat | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Hosting locations | You can host multiple packages in one repository. | | Permissions | Each package inherits the permissions of the repository where the package is hosted.

    For example, anyone with read permissions for a repository can install a package as a dependency in a project, and anyone with write permissions can publish a new package version. | -| Visibility | {% data reusables.package_registry.public-or-private-packages %} | +| Visibility | {% data reusables.package_registry.public-or-private-packages %} {% endif %} @@ -60,8 +60,7 @@ For more information about permissions and visibility for {% data variables.prod {% data reusables.package_registry.packages-billing %} For more information, see "[About billing for {% data variables.product.prodname_registry %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)." - -{{ site.data.reusables/package_registry/container-registry-beta-billing-note }} +{% data reusables.package_registry.container-registry-beta-billing-note %} {% endif %} ### Supported clients and formats @@ -76,8 +75,9 @@ The {% data variables.product.prodname_github_container_registry %} hosts contai | Package client | Language | Package format | Description | | -------------- | -------- | ----------------- | ------------------------- | | Docker CLI | Нет | `Файл Dockerfile` | Docker container support. | +For more information about the container support offered by -For more information about the container support offered by {% data variables.product.prodname_github_container_registry %}, see "[About {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry)." +{% data variables.product.prodname_github_container_registry %}, see "[About {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry)." {% endif %} #### Support for package registries @@ -144,10 +144,10 @@ For more information about configuring your package client for use with {% data {% if currentVersion == "free-pro-team@latest" %} ### About scopes and permissions for {% data variables.product.prodname_github_container_registry %} -| Scope | Description | -| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `read:packages` | Download and install container images from {% data variables.product.prodname_github_container_registry %} | -| `write:packages` | Upload and publish container images to {% data variables.product.prodname_github_container_registry %} | +| Scope | Description | +| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `read:packages` | Download and install container images from {% data variables.product.prodname_github_container_registry %} +| `write:packages` | Upload and publish container images to {% data variables.product.prodname_github_container_registry %} | `delete:packages` | Delete specified versions of private or public container images from {% data variables.product.prodname_github_container_registry %}. For more information, see "[Deleting a container image](/packages/managing-container-images-with-github-container-registry/deleting-a-container-image)." | To learn about available scopes and permissions for container images, see "[About {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry)" or "[Configuring access control and visibility for container images](/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images)." @@ -166,9 +166,9 @@ To use or manage a package hosted by a package registry, you must use a token wi | Scope | Description | Repository permissions | | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- | -| `read:packages` | Download and install packages from {% data variables.product.prodname_registry %} | read | -| `write:packages` | Upload and publish packages to {% data variables.product.prodname_registry %} | write | -| `delete:packages` | Delete specified versions of private packages from {% data variables.product.prodname_registry %} | admin | +| `read:packages` | Download and install packages from {% data variables.product.prodname_registry %} | read | +| `write:packages` | Upload and publish packages to {% data variables.product.prodname_registry %} | write | +| `delete:packages` | Delete specified versions of private packages from {% data variables.product.prodname_registry %} | admin | | `repo` | Install, upload, and delete certain packages in private repositories (along with `read:packages`, `write:packages`, or `delete:packages`) | read, write, or admin | When you create a {% data variables.product.prodname_actions %} workflow, you can use the `GITHUB_TOKEN` to publish and install packages in {% data variables.product.prodname_registry %} without needing to store and manage a personal access token. @@ -180,14 +180,15 @@ When you create a {% data variables.product.prodname_actions %} workflow, you ca ### Managing packages -You can a delete a version of a private package on {% data variables.product.product_name %} or using the GraphQL API. When you use the GraphQL API to query and delete private packages, you must use the same token you use to authenticate to {% data variables.product.prodname_registry %}. For more information, see "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package)" and "[Forming calls with GraphQL](/v4/guides/forming-calls/)." +You can delete a version of a private package on {% data variables.product.product_name %} or using the GraphQL API. When you use the GraphQL API to query and delete private packages, you must use the same token you use to authenticate to {% data variables.product.prodname_registry %}. For more information, see "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package)" and "[Forming calls with GraphQL](/v4/guides/forming-calls/)." You can configure webhooks to subscribe to package-related events, such as when a package is published or updated. For more information, see the "[`package` webhook event](/webhooks/event-payloads/#package)." ### Contacting support {% if currentVersion == "free-pro-team@latest" %} -If you have feedback or feature requests for {% data variables.product.prodname_registry %}, use the [feedback form for {% data variables.product.prodname_registry %}](https://support.github.com/contact/feedback?contact%5Bcategory%5D=github-packages). +If you have feedback or feature requests for +{% data variables.product.prodname_registry %}, use the [feedback form for {% data variables.product.prodname_registry %}](https://support.github.com/contact/feedback?contact%5Bcategory%5D=github-packages). Contact {% data variables.contact.github_support %} about {% data variables.product.prodname_registry %} using [our contact form](https://support.github.com/contact?form%5Bsubject%5D=Re:%20GitHub%20Packages) if: @@ -196,6 +197,7 @@ Contact {% data variables.contact.github_support %} about {% data variables.prod * Your published package contains sensitive data, such as GDPR violations, API Keys, or personally identifying information {% else %} -If you need support for {% data variables.product.prodname_registry %}, please contact your site administrators. +If you need support for +{% data variables.product.prodname_registry %}, please contact your site administrators. {% endif %} diff --git a/translations/ru-RU/content/packages/publishing-and-managing-packages/deleting-a-package.md b/translations/ru-RU/content/packages/publishing-and-managing-packages/deleting-a-package.md index 3804e2a0b30f..b21fce066af5 100644 --- a/translations/ru-RU/content/packages/publishing-and-managing-packages/deleting-a-package.md +++ b/translations/ru-RU/content/packages/publishing-and-managing-packages/deleting-a-package.md @@ -11,7 +11,6 @@ versions: {% data reusables.package_registry.packages-ghes-release-stage %} - {% if currentVersion == "free-pro-team@latest" %} ### About container image deletion diff --git a/translations/ru-RU/content/packages/publishing-and-managing-packages/publishing-a-package.md b/translations/ru-RU/content/packages/publishing-and-managing-packages/publishing-a-package.md index 93fbdbffb4b7..fbc13a6a796d 100644 --- a/translations/ru-RU/content/packages/publishing-and-managing-packages/publishing-a-package.md +++ b/translations/ru-RU/content/packages/publishing-and-managing-packages/publishing-a-package.md @@ -21,7 +21,8 @@ You can help people understand and use your package by providing a description a {% data reusables.package_registry.package-immutability %} {% if currentVersion == "free-pro-team@latest" %} -If a new version of a package fixes a security vulnerability, you should publish a security advisory in your repository. {% data variables.product.prodname_dotcom %} reviews each published security advisory and may use it to send {% data variables.product.prodname_dependabot_short %} alerts to affected repositories. For more information, see "[About GitHub Security Advisories](/github/managing-security-vulnerabilities/about-github-security-advisories)." +If a new version of a package fixes a security vulnerability, you should publish a security advisory in your repository. +{% data variables.product.prodname_dotcom %} reviews each published security advisory and may use it to send {% data variables.product.prodname_dependabot_short %} alerts to affected repositories. For more information, see "[About GitHub Security Advisories](/github/managing-security-vulnerabilities/about-github-security-advisories)." {% endif %} ### Publishing a package diff --git a/translations/ru-RU/content/packages/publishing-and-managing-packages/viewing-packages.md b/translations/ru-RU/content/packages/publishing-and-managing-packages/viewing-packages.md index 9154b44ce193..0e4939a12ccc 100644 --- a/translations/ru-RU/content/packages/publishing-and-managing-packages/viewing-packages.md +++ b/translations/ru-RU/content/packages/publishing-and-managing-packages/viewing-packages.md @@ -32,7 +32,7 @@ You can see all the packages installed in an organization and search for a speci {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} -3. Под названием вашей организации нажмите +3. Под названием вашей организации щелкните {% octicon "package" aria-label="The package icon" %} **Packages**. {% data reusables.package_registry.navigate-to-packages %} diff --git a/translations/ru-RU/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md b/translations/ru-RU/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md index 77c66aab1fcf..95b829e2267f 100644 --- a/translations/ru-RU/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md +++ b/translations/ru-RU/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md @@ -17,11 +17,7 @@ versions: ### About Docker and {% data variables.product.prodname_registry %} -{% warning %} - -**Note:** The {% data variables.product.prodname_registry %} Docker registry will be superseded by {% data variables.product.prodname_github_container_registry %}{% if currentVersion != "free-pro-team@latest" %} in a future {% data variables.product.product_name %} release{% endif %}.{% if currentVersion == "free-pro-team@latest" %} To learn how to migrate your existing Docker images and any workflows using them, see "[Migrating to {% data variables.product.prodname_github_container_registry %} for Docker images](/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images)" and "[Getting started with {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry)."{% endif %} - -{% endwarning %} +{% data reusables.package_registry.docker_registry_deprecation_status %} When installing or publishing a docker image, {% data variables.product.prodname_registry %} does not currently support foreign layers, such as Windows images. @@ -33,6 +29,8 @@ Before you can use the Docker registry on {% data variables.product.prodname_reg ### Authenticating to {% data variables.product.prodname_registry %} +{% data reusables.package_registry.docker_registry_deprecation_status %} + {% data reusables.package_registry.authenticate-packages %} #### Authenticating with a personal access token @@ -69,6 +67,8 @@ For more information, see "[Docker login](https://docs.docker.com/engine/referen ### Publishing a package +{% data reusables.package_registry.docker_registry_deprecation_status %} + {% data variables.product.prodname_registry %} supports multiple top-level Docker images per repository. A repository can have any number of image tags. You may experience degraded service publishing or installing Docker images larger than 10GB, layers are capped at 5GB each. For more information, see "[Docker tag](https://docs.docker.com/engine/reference/commandline/tag/)" in the Docker documentation. {% data reusables.package_registry.lowercase-name-field %} @@ -104,7 +104,8 @@ For more information, see "[Docker login](https://docs.docker.com/engine/referen $ docker build -t docker.HOSTNAME/OWNER/REPOSITORY/IMAGE_NAME:VERSION PATH ``` {% endif %} -4. Publish the image to {% data variables.product.prodname_registry %}. +4. Publish the image to +{% data variables.product.prodname_registry %}. {% if currentVersion == "free-pro-team@latest" %} ```shell $ docker push docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME:VERSION @@ -122,6 +123,8 @@ For more information, see "[Docker login](https://docs.docker.com/engine/referen #### Example publishing a Docker image +{% data reusables.package_registry.docker_registry_deprecation_status %} + You can publish version 1.0 of the `monalisa` image to the `octocat/octo-app` repository using an image ID. {% if currentVersion == "free-pro-team@latest" %} @@ -180,8 +183,9 @@ $ docker push docker.HOSTNAME/octocat/octo-app/monalisa:1.0 ### Installing a package -You can use the `docker pull` command to install a docker image from {% data variables.product.prodname_registry %}, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image,{% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance, {% endif %} and *TAG_NAME* with tag for the image you want to install. {% data reusables.package_registry.lowercase-name-field %} +{% data reusables.package_registry.docker_registry_deprecation_status %} +You can use the `docker pull` command to install a docker image from {% data variables.product.prodname_registry %}, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image,{% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance, {% endif %} and *TAG_NAME* with tag for the image you want to install. {% data reusables.package_registry.lowercase-name-field %} {% if currentVersion == "free-pro-team@latest" %} ```shell @@ -199,7 +203,6 @@ $ docker pull docker.HOSTNAME/OWNER/REPOSITORY/IMAGE_NAME:TAG_NAME {% endnote %} - ### Дополнительная литература - "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package/)" diff --git a/translations/ru-RU/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-dotnet-cli-for-use-with-github-packages.md b/translations/ru-RU/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-dotnet-cli-for-use-with-github-packages.md index bc06dc3d5040..dbf7bdd09b78 100644 --- a/translations/ru-RU/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-dotnet-cli-for-use-with-github-packages.md +++ b/translations/ru-RU/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-dotnet-cli-for-use-with-github-packages.md @@ -157,7 +157,6 @@ For example, the *OctodogApp* and *OctocatApp* projects will publish to the same ``` - ### Installing a package Using packages from {% data variables.product.prodname_dotcom %} in your project is similar to using packages from *nuget.org*. Add your package dependencies to your *.csproj* file, specifying the package name and version. For more information on using a *.csproj* file in your project, see "[Working with NuGet packages](https://docs.microsoft.com/en-us/nuget/consume-packages/overview-and-workflow)" in the Microsoft documentation. diff --git a/translations/ru-RU/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages.md b/translations/ru-RU/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages.md index 8f64e69a9160..5e9c8e4f9a9a 100644 --- a/translations/ru-RU/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages.md +++ b/translations/ru-RU/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages.md @@ -26,7 +26,8 @@ versions: You can authenticate to {% data variables.product.prodname_registry %} with Gradle using either Gradle Groovy or Kotlin DSL by editing your *build.gradle* file (Gradle Groovy) or *build.gradle.kts* file (Kotlin DSL) file to include your personal access token. You can also configure Gradle Groovy and Kotlin DSL to recognize a single package or multiple packages in a repository. {% if currentVersion != "free-pro-team@latest" %} -Replace *REGISTRY-URL* with the URL for your instance's Maven registry. If your instance has subdomain isolation enabled, use `maven.HOSTNAME`. If your instance has subdomain isolation disabled, use `HOSTNAME/_registry/maven`. In either case, replace *HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance. +Replace *REGISTRY-URL* with the URL for your instance's Maven registry. If your instance has subdomain isolation enabled, use `maven.HOSTNAME`. If your instance has subdomain isolation disabled, use `HOSTNAME/_registry/maven`. In either case, replace *HOSTNAME* with the host name of your +{% data variables.product.prodname_ghe_server %} instance. {% endif %} Replace *USERNAME* with your {% data variables.product.prodname_dotcom %} username, *TOKEN* with your personal access token, *REPOSITORY* with the name of the repository containing the package you want to publish, and *OWNER* with the name of the user or organization account on {% data variables.product.prodname_dotcom %} that owns the repository. {% data reusables.package_registry.lowercase-name-field %} @@ -120,32 +121,32 @@ publishing { ##### Example using Kotlin DSL for multiple packages in the same repository - ```shell - plugins { - `maven-publish` apply false - } +```shell +plugins { + `maven-publish` apply false +} - subprojects { - apply(plugin = "maven-publish") - configure { - repositories { - maven { - name = "GitHubPackages" - url = uri("https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}REGISTRY-URL{% endif %}/OWNER/REPOSITORY") - credentials { - username = project.findProperty("gpr.user") as String? ?: System.getenv("USERNAME") - password = project.findProperty("gpr.key") as String? ?: System.getenv("TOKEN") - } - } - } - publications { - register("gpr") { - from(components["java"]) - } - } - } - } - ``` +subprojects { + apply(plugin = "maven-publish") + configure { + repositories { + maven { + name = "GitHubPackages" + url = uri("https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}REGISTRY-URL{% endif %}/OWNER/REPOSITORY") + credentials { + username = project.findProperty("gpr.user") as String? ?: System.getenv("USERNAME") + password = project.findProperty("gpr.key") as String? ?: System.getenv("TOKEN") + } + } + } + publications { + register("gpr") { + from(components["java"]) + } + } + } +} +``` #### Authenticating with the `GITHUB_TOKEN` @@ -173,31 +174,31 @@ You can install a package by adding the package as a dependency to your project. {% data reusables.package_registry.authenticate-step %} 2. Add the package dependencies to your *build.gradle* file (Gradle Groovy) or *build.gradle.kts* file (Kotlin DSL) file. - Example using Grady Groovy: + Example using Gradle Groovy: ```shell dependencies { - implementation 'com.example:package' + implementation 'com.example:package' } ``` Example using Kotlin DSL: ```shell dependencies { - implementation("com.example:package") + implementation("com.example:package") } ``` 3. Add the maven plugin to your *build.gradle* file (Gradle Groovy) or *build.gradle.kts* file (Kotlin DSL) file. - Example using Grady Groovy: + Example using Gradle Groovy: ```shell plugins { - id 'maven' + id 'maven' } ``` Example using Kotlin DSL: ```shell plugins { - `maven` + `maven` } ``` diff --git a/translations/ru-RU/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md b/translations/ru-RU/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md index 839eb86d8500..4b390f513be5 100644 --- a/translations/ru-RU/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md +++ b/translations/ru-RU/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md @@ -88,7 +88,8 @@ You can use an *.npmrc* file to configure the scope mapping for your project. In {% data reusables.package_registry.authenticate-step %} {% data reusables.package_registry.create-npmrc-owner-step %} {% data reusables.package_registry.add-npmrc-to-repo-step %} -4. Verify the name of your package in your project's *package.json*. The `name` field must contain the scope and the name of the package. For example, if your package is called "test", and you are publishing to the "My-org" {% data variables.product.prodname_dotcom %} organization, the `name` field in your *package.json* should be `@my-org/test`. +4. Verify the name of your package in your project's *package.json*. The `name` field must contain the scope and the name of the package. For example, if your package is called "test", and you are publishing to the "My-org" +{% data variables.product.prodname_dotcom %} organization, the `name` field in your *package.json* should be `@my-org/test`. {% data reusables.package_registry.verify_repository_field %} {% data reusables.package_registry.publish_package %} @@ -188,7 +189,6 @@ registry=https://HOSTNAME/_registry/npm/OWNER ``` {% endif %} - ### Дополнительная литература - "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package/)" diff --git a/translations/ru-RU/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md b/translations/ru-RU/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md index 0137dc78a12b..794f932b5c14 100644 --- a/translations/ru-RU/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md +++ b/translations/ru-RU/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md @@ -22,7 +22,9 @@ You can extend the CI and CD capabilities of your repository by publishing or in {% data reusables.package_registry.container-registry-beta %} -If you want your workflow to authenticate to {% data variables.product.prodname_registry %} to access the {% data variables.product.prodname_container_registry %}, then we recommend using a personal access token since the `GITHUB_TOKEN` is not currently supported. For an authentication example, see "[Authenticating with the {% data variables.product.prodname_container_registry %}](/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images#authenticating-with-the-container-registry)." +{% data reusables.package_registry.authenticate_with_pat_for_container_registry %} + +For an authentication example, see "[Authenticating with the {% data variables.product.prodname_container_registry %}](/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images#authenticating-with-the-container-registry)." {% endif %} @@ -45,7 +47,8 @@ You can install packages as part of your CI flow using {% data variables.product Installing packages hosted by {% data variables.product.prodname_registry %} through {% data variables.product.prodname_actions %} requires minimal configuration or additional authentication when you use `GITHUB_TOKEN`.{% if currentVersion == "free-pro-team@latest" %} Data transfer is also free when an action installs a package. For more information, see "[About billing for {% data variables.product.prodname_registry %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)."{% endif %} {% if currentVersion == "free-pro-team@latest" %} -`GITHUB_TOKEN` cannot install packages from any private repository besides the repository where the action runs. You cannot currently use `GITHUB_TOKEN` to authenticate to {% data variables.product.prodname_github_container_registry %}. +`GITHUB_TOKEN` cannot install packages from any private repository besides the repository where the action runs. You cannot currently use `GITHUB_TOKEN` to authenticate to +{% data variables.product.prodname_github_container_registry %}. {% endif %} {% data reusables.package_registry.actions-configuration %} diff --git a/translations/ru-RU/content/rest/guides/basics-of-authentication.md b/translations/ru-RU/content/rest/guides/basics-of-authentication.md index ff31d8a0c765..fc7d1d0e9f82 100644 --- a/translations/ru-RU/content/rest/guides/basics-of-authentication.md +++ b/translations/ru-RU/content/rest/guides/basics-of-authentication.md @@ -11,7 +11,6 @@ versions: --- - In this section, we're going to focus on the basics of authentication. Specifically, we're going to create a Ruby server (using [Sinatra][Sinatra]) that implements the [web flow][webflow] of an application in several different ways. {% tip %} @@ -48,7 +47,8 @@ end ``` Your client ID and client secret keys come from [your application's configuration page][app settings]. You should **never, _ever_** store these values in -{% data variables.product.product_name %}--or any other public place, for that matter. We recommend storing them as [environment variables][about env vars]--which is exactly what we've done here. +{% data variables.product.product_name %}--or any other public place, for that matter. We recommend storing them as +[environment variables][about env vars]--which is exactly what we've done here. Next, in _views/index.erb_, paste this content: @@ -106,7 +106,7 @@ After a successful app authentication, {% data variables.product.product_name %} #### Checking granted scopes -In the future, users will be able to [edit the scopes you requested][edit scopes post], and your application might be granted less access than you originally asked for. So, before making any requests with the token, you should check the scopes that were granted for the token by the user. +Users can edit the scopes you requested by directly changing the URL. This can grant your application less access than you originally asked for. So, before making any requests with the token, you should check the scopes that were granted for the token by the user. For more information about requested and granted scopes, see "[Scopes for OAuth Apps](/developers/apps/scopes-for-oauth-apps#requested-scopes-and-granted-scopes)." The scopes that were granted are returned as a part of the response from exchanging a token. @@ -173,7 +173,8 @@ We can do whatever we want with our results. In this case, we'll just dump them It'd be a pretty bad model if we required users to log into the app every single time they needed to access the web page. For example, try navigating directly to `http://localhost:4567/basic`. You'll get an error. What if we could circumvent the entire "click here" process, and just _remember_ that, as long as the user's logged into -{% data variables.product.product_name %}, they should be able to access this application? Hold on to your hat, because _that's exactly what we're going to do_. +{% data variables.product.product_name %}, they should be able to access this application? Hold on to your hat, +because _that's exactly what we're going to do_. Our little server above is rather simple. In order to wedge in some intelligent authentication, we're going to switch over to using sessions for storing tokens. This will make authentication transparent to the user. @@ -302,6 +303,5 @@ Also, if we had never authorized this application to access our {% data variable [libraries]: /libraries/ [oauth scopes]: /apps/building-oauth-apps/understanding-scopes-for-oauth-apps/ [oauth scopes]: /apps/building-oauth-apps/understanding-scopes-for-oauth-apps/ -[edit scopes post]: https://developer.github.com/changes/2013-10-04-oauth-changes-coming/ [new oauth app]: https://github.com/settings/applications/new [app settings]: https://github.com/settings/developers diff --git a/translations/ru-RU/content/rest/guides/best-practices-for-integrators.md b/translations/ru-RU/content/rest/guides/best-practices-for-integrators.md index 23643156fa7d..b99e43b3d9b9 100644 --- a/translations/ru-RU/content/rest/guides/best-practices-for-integrators.md +++ b/translations/ru-RU/content/rest/guides/best-practices-for-integrators.md @@ -12,7 +12,6 @@ versions: Interested in integrating with the GitHub platform? [You're in good company](https://github.com/integrations). This guide will help you build an app that provides the best experience for your users *and* ensure that it's reliably interacting with the API. - ### Secure payloads delivered from GitHub It's very important that you secure [the payloads sent from GitHub][event-types]. Although no personal information (like passwords) is ever transmitted in a payload, leaking *any* information is not good. Some information that might be sensitive include committer email address or the names of private repositories. diff --git a/translations/ru-RU/content/rest/guides/getting-started-with-the-checks-api.md b/translations/ru-RU/content/rest/guides/getting-started-with-the-checks-api.md index 67a64576c111..d0a7693f8ccf 100644 --- a/translations/ru-RU/content/rest/guides/getting-started-with-the-checks-api.md +++ b/translations/ru-RU/content/rest/guides/getting-started-with-the-checks-api.md @@ -37,8 +37,8 @@ A check run is an individual test that is part of a check suite. Each run includ ![Check runs workflow](/assets/images/check_runs.png) {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -If a check run is in a incomplete state for more than 14 days, then the check run's `conclusion` becomes `stale` and appears on {% data variables.product.prodname_dotcom %} as stale with -{% octicon "issue-reopened" aria-label="The issue-reopened icon" %}. Only {% data variables.product.prodname_dotcom %} can mark check runs as `stale`. For more information about possible conclusions of a check run, see the [`conclusion` parameter](/rest/reference/checks#create-a-check-run--parameters). +If a check run is in a incomplete state for more than 14 days, then the check run's `conclusion` becomes `stale` and appears on +{% data variables.product.prodname_dotcom %} as stale with {% octicon "issue-reopened" aria-label="The issue-reopened icon" %}. Only {% data variables.product.prodname_dotcom %} can mark check runs as `stale`. For more information about possible conclusions of a check run, see the [`conclusion` parameter](/rest/reference/checks#create-a-check-run--parameters). {% endif %} As soon as you receive the [`check_suite`](/webhooks/event-payloads/#check_suite) webhook, you can create the check run, even if the check is not complete. You can update the `status` of the check run as it completes with the values `queued`, `in_progress`, or `completed`, and you can update the `output` as more details become available. A check run can contain timestamps, a link to more details on your external site, detailed annotations for specific lines of code, and information about the analysis performed. diff --git a/translations/ru-RU/content/rest/guides/getting-started-with-the-git-database-api.md b/translations/ru-RU/content/rest/guides/getting-started-with-the-git-database-api.md index 5479de9c49d5..9c84a1fc36cb 100644 --- a/translations/ru-RU/content/rest/guides/getting-started-with-the-git-database-api.md +++ b/translations/ru-RU/content/rest/guides/getting-started-with-the-git-database-api.md @@ -32,14 +32,14 @@ It might seem complex, but it's actually pretty simple when you understand the m {% warning %} -**Warning!** Please do not depend on using Git directly or {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}[`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference){% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}[`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference){% endif %} for updates to `merge` Git refs, because this content becomes outdated without warning. +**Warning!** Please do not depend on using Git directly or [`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference) for updates to `merge` Git refs, because this content becomes outdated without warning. {% endwarning %} A consuming API needs to explicitly request a pull request to create a _test_ merge commit. A _test_ merge commit is created when you view the pull request in the UI and the "Merge" button is displayed, or when you [get](/v3/pulls/#get-a-pull-request), [create](/v3/pulls/#create-a-pull-request), or [edit](/v3/pulls/#update-a-pull-request) a pull request using the REST API. Without this request, the `merge` Git refs will fall out of date until the next time someone views the pull request. -If you are currently using polling methods that produce outdated `merge` Git refs, then GitHub recommends using the following steps to get the latest changes from the base branch (usually `master`): +If you are currently using polling methods that produce outdated `merge` Git refs, then GitHub recommends using the following steps to get the latest changes from the default branch: 1. Receive the pull request webhook. 2. Call [`GET /repos/{owner}/{repo}/pulls/{pull_number}`](/v3/pulls/#get-a-pull-request) to start a background job for creating the merge commit candidate. -3. Poll your repository using [`GET /repos/{owner}/{repo}/pulls/{pull_number}`](/v3/pulls/#get-a-pull-request) to see if the `mergeable` attribute is `true` or `false`. You can use Git directly or {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}[`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference){% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}[`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference){% endif %} for updates to `merge` Git refs only after performing the previous steps. +3. Poll your repository using [`GET /repos/{owner}/{repo}/pulls/{pull_number}`](/v3/pulls/#get-a-pull-request) to see if the `mergeable` attribute is `true` or `false`. You can use Git directly or [`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference) for updates to `merge` Git refs only after performing the previous steps. diff --git a/translations/ru-RU/content/rest/guides/getting-started-with-the-rest-api.md b/translations/ru-RU/content/rest/guides/getting-started-with-the-rest-api.md index 2af13cdd0c80..ca4659f8c717 100644 --- a/translations/ru-RU/content/rest/guides/getting-started-with-the-rest-api.md +++ b/translations/ru-RU/content/rest/guides/getting-started-with-the-rest-api.md @@ -10,7 +10,6 @@ versions: --- - Let's walk through core API concepts as we tackle some everyday use cases. ### Обзор @@ -55,7 +54,6 @@ $ curl -i {% data variables.product.api_url_pre %}/users/defunkt > Server: GitHub.com > Date: Sun, 11 Nov 2012 18:43:28 GMT > Content-Type: application/json; charset=utf-8 -> Connection: keep-alive > Status: 200 OK > ETag: "bfd85cbf23ac0b0c8a29bee02e7117c6" > X-RateLimit-Limit: 60 @@ -195,7 +193,8 @@ In this example, we grab only those repositories that octocat owns, not the ones #### Create a repository Fetching information for existing repositories is a common use case, but the -{% data variables.product.product_name %} API supports creating new repositories as well. To [create a repository][create repo], we need to `POST` some JSON containing the details and configuration options. +{% data variables.product.product_name %} API supports creating new repositories as well. To [create a repository][create repo], +we need to `POST` some JSON containing the details and configuration options. ```shell $ curl -i -H "Authorization: token 5199831f4dd3b79e7c5b7e0ebe75d67aa66e79d4" \ diff --git a/translations/ru-RU/content/rest/guides/rendering-data-as-graphs.md b/translations/ru-RU/content/rest/guides/rendering-data-as-graphs.md index 2d752872856b..fb7579c8cf0a 100644 --- a/translations/ru-RU/content/rest/guides/rendering-data-as-graphs.md +++ b/translations/ru-RU/content/rest/guides/rendering-data-as-graphs.md @@ -240,7 +240,7 @@ repos.each do |repo| end ``` -From there, we'll cumulatively add each language found to a "master list": +From there, we'll cumulatively add each language found to a list of languages: ``` ruby repo_langs.each do |lang, count| diff --git a/translations/ru-RU/content/rest/overview/api-previews.md b/translations/ru-RU/content/rest/overview/api-previews.md index 763d452a539a..997d6e49e75b 100644 --- a/translations/ru-RU/content/rest/overview/api-previews.md +++ b/translations/ru-RU/content/rest/overview/api-previews.md @@ -10,7 +10,6 @@ versions: --- - API previews let you try out new APIs and changes to existing API methods before they become part of the official GitHub API. During the preview period, we may change some features based on developer feedback. If we do make changes, we'll announce them on the [developer blog](https://developer.github.com/changes/) without advance notice. @@ -43,14 +42,6 @@ Get a [list of events](/v3/issues/timeline/) for an issue or pull request. **Custom media type:** `mockingbird-preview` **Announced:** [2016-05-23](https://developer.github.com/changes/2016-05-23-timeline-preview-api/) -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -### Pages - -Get more information about your [GitHub Pages](/v3/repos/pages/) site. - -**Custom media type:** `mister-fantastic-preview` **Announced:** [2016-07-06](https://developer.github.com/changes/2016-07-06-github-pages-preview-api/) -{% endif %} - {% if currentVersion != "free-pro-team@latest" %} ### Pre-receive environments @@ -122,7 +113,7 @@ Include nested team content in [team](/v3/teams/) payloads. Enables [global webhooks](/v3/enterprise-admin/global_webhooks/) for [organization](/webhooks/event-payloads/#organization) and [user](/webhooks/event-payloads/#user) event types. This API preview is only available for {% data variables.product.prodname_ghe_server %}. -**Custom media type:** `superpro-preview` **Announced:** [2017-12-12](/v3/enterprise-admin/global_webhooks) +**Custom media type:** `hellcat-preview` **Announced:** [2017-09-01](https://developer.github.com/changes/2017-08-30-preview-nested-teams) {% endif %} @@ -142,15 +133,6 @@ You can now add a reason when you [lock an issue](/v3/issues/#lock-an-issue). **Custom media type:** `sailor-v-preview` **Announced:** [2018-01-10](https://developer.github.com/changes/2018-01-10-lock-reason-api-preview) {% endif %} -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -### Team discussions - -You can now use the API to manage [team discussions](/v3/teams/discussions) and [team discussion comments](/v3/teams/discussion_comments). - -**Custom media type:** `echo-preview` **Announced:** [2018-02-07](https://developer.github.com/changes/2018-02-07-team-discussions-api) - -{% endif %} - ### Require signed commits You can now use the API to manage the setting for [requiring signed commits on protected branches](/v3/repos/branches). @@ -168,15 +150,17 @@ You can now [require multiple approving reviews](/v3/repos/branches) for a pull Retrieve information from [someone's hovercard](/v3/users/#get-contextual-information-for-a-user). -**Custom media type:** `hagar-preview` **Announced:** [2018-03-21](https://developer.github.com/changes/2018-03-21-hovercard-api-preview) +**Custom media type:** `echo-preview` **Announced:** [2018-02-07](https://developer.github.com/changes/2018-02-07-team-discussions-api) {% endif %} +{% if currentVersion ver_lt "enterprise-server@2.23" %} ### Check runs and check suites API Allows a GitHub App to run external checks on a repository's code. See the [Check runs](/v3/checks/runs/) and [Check suites](/v3/checks/suites/) APIs for more details. **Custom media type:** `antiope-preview` **Announced:** [2018-05-07](https://developer.github.com/changes/2018-05-07-new-checks-api-public-beta/) +{% endif %} {% if currentVersion != "free-pro-team@latest" %} diff --git a/translations/ru-RU/content/rest/overview/other-authentication-methods.md b/translations/ru-RU/content/rest/overview/other-authentication-methods.md index 75913347d3cb..9577b58cd035 100644 --- a/translations/ru-RU/content/rest/overview/other-authentication-methods.md +++ b/translations/ru-RU/content/rest/overview/other-authentication-methods.md @@ -9,9 +9,9 @@ versions: --- - While the API provides multiple methods for authentication, we strongly recommend using [OAuth](/apps/building-integrations/setting-up-and-registering-oauth-apps/) for production applications. The other methods provided are intended to be used for scripts or testing (i.e., cases where full OAuth would be overkill). Third party applications that rely on -{% data variables.product.product_name %} for authentication should not ask for or collect {% data variables.product.product_name %} credentials. Instead, they should use the [OAuth web flow](/apps/building-oauth-apps/authorizing-oauth-apps/). +{% data variables.product.product_name %} for authentication should not ask for or collect {% data variables.product.product_name %} credentials. +Instead, they should use the [OAuth web flow](/apps/building-oauth-apps/authorizing-oauth-apps/). ### Basic Authentication diff --git a/translations/ru-RU/content/rest/overview/resources-in-the-rest-api.md b/translations/ru-RU/content/rest/overview/resources-in-the-rest-api.md index e7b51f3706f4..0c73a72f62aa 100644 --- a/translations/ru-RU/content/rest/overview/resources-in-the-rest-api.md +++ b/translations/ru-RU/content/rest/overview/resources-in-the-rest-api.md @@ -11,7 +11,6 @@ versions: This describes the resources that make up the official {% data variables.product.product_name %} REST API. If you have any problems or requests, please contact {% data variables.contact.contact_support %}. - ### Current version By default, all requests to `{% data variables.product.api_url_code %}` receive the **v3** [version](/v3/versions) of the REST API. We encourage you to [explicitly request this version via the `Accept` header](/v3/media/#request-specific-version). diff --git a/translations/ru-RU/content/rest/reference/actions.md b/translations/ru-RU/content/rest/reference/actions.md index 2671aaa7af4d..a162cda6f3ad 100644 --- a/translations/ru-RU/content/rest/reference/actions.md +++ b/translations/ru-RU/content/rest/reference/actions.md @@ -24,6 +24,16 @@ The Artifacts API allows you to download, delete, and retrieve information about {% if operation.subcategory == 'artifacts' %}{% include rest_operation %}{% endif %} {% endfor %} +## Permissions + +The Permissions API allows you to set permissions for what organizations and repositories are allowed to run {% data variables.product.prodname_actions %}, and what actions are allowed to run. For more information, see "[Usage limits, billing, and administration](/actions/reference/usage-limits-billing-and-administration#disabling-or-limiting-github-actions-for-your-repository-or-organization)." + +You can also set permissions for an enterprise. For more information, see the "[{% data variables.product.prodname_dotcom %} Enterprise administration](/rest/reference/enterprise-admin#github-actions)" REST API. + +{% for operation in currentRestOperations %} + {% if operation.subcategory == 'permissions' %}{% include rest_operation %}{% endif %} +{% endfor %} + ## Secrets The Secrets API lets you create, update, delete, and retrieve information about encrypted secrets. {% data reusables.actions.about-secrets %} For more information, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)." @@ -40,7 +50,7 @@ The Self-hosted Runners API allows you to register, view, and delete self-hosted {% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_app %}s must have the `administration` permission for repositories or the `organization_self_hosted_runners` permission for organizations. Authenticated users must have admin access to the repository or organization to use this API. -You can manage self-hosted runners for an enterprise. For more information, see the "[{% data variables.product.prodname_dotcom %} Enterprise administration](/rest/reference/enterprise-admin#actions)" REST API. +You can manage self-hosted runners for an enterprise. For more information, see the "[{% data variables.product.prodname_dotcom %} Enterprise administration](/rest/reference/enterprise-admin#github-actions)" REST API. {% for operation in currentRestOperations %} {% if operation.subcategory == 'self-hosted-runners' %}{% include rest_operation %}{% endif %} @@ -52,7 +62,7 @@ The Self-hosted Runners Groups API allows you manage groups of self-hosted runne {% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_app %}s must have the `administration` permission for repositories or the `organization_self_hosted_runners` permission for organizations. Authenticated users must have admin access to the repository or organization to use this API. -You can manage self-hosted runner groups for an enterprise. For more information, see the "[{% data variables.product.prodname_dotcom %} Enterprise administration](/rest/reference/enterprise-admin#actions)" REST API. +You can manage self-hosted runner groups for an enterprise. For more information, see the "[{% data variables.product.prodname_dotcom %} Enterprise administration](/rest/reference/enterprise-admin##github-actions)" REST API. {% for operation in currentRestOperations %} {% if operation.subcategory == 'self-hosted-runner-groups' %}{% include rest_operation %}{% endif %} diff --git a/translations/ru-RU/content/rest/reference/activity.md b/translations/ru-RU/content/rest/reference/activity.md index 7b76bba6de43..6da4a84e26fc 100644 --- a/translations/ru-RU/content/rest/reference/activity.md +++ b/translations/ru-RU/content/rest/reference/activity.md @@ -138,19 +138,19 @@ When retrieving responses from the Notifications API, each payload has a key tit Here's a list of potential `reason`s for receiving a notification: -| Reason Name | Description | -| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `assign` | You were assigned to the issue. | -| `автор` | You created the thread. | -| `комментарий` | You commented on the thread. | -| `приглашение` | You accepted an invitation to contribute to the repository. | -| `manual` | You subscribed to the thread (via an issue or pull request). | -| `упоминание` | You were specifically **@mentioned** in the content. | +| Reason Name | Description | +| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `assign` | You were assigned to the issue. | +| `автор` | You created the thread. | +| `комментарий` | You commented on the thread. | +| `приглашение` | You accepted an invitation to contribute to the repository. | +| `manual` | You subscribed to the thread (via an issue or pull request). | +| `упоминание` | You were specifically **@mentioned** in the content. | | `review_requested` | You, or a team you're a member of, were requested to review a pull request.{% if currentVersion == "free-pro-team@latest" %} | `security_alert` | {% data variables.product.prodname_dotcom %} discovered a [security vulnerability](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in your repository.{% endif %} -| `state_change` | You changed the thread state (for example, closing an issue or merging a pull request). | -| `subscribed` | You're watching the repository. | -| `team_mention` | You were on a team that was mentioned. | +| `state_change` | You changed the thread state (for example, closing an issue or merging a pull request). | +| `subscribed` | You're watching the repository. | +| `team_mention` | You were on a team that was mentioned. | Note that the `reason` is modified on a per-thread basis, and can change, if the `reason` on a later notification is different. diff --git a/translations/ru-RU/content/rest/reference/apps.md b/translations/ru-RU/content/rest/reference/apps.md index e7560bc0663a..7ff187a1f253 100644 --- a/translations/ru-RU/content/rest/reference/apps.md +++ b/translations/ru-RU/content/rest/reference/apps.md @@ -35,9 +35,7 @@ You can use this API to manage the OAuth tokens an OAuth application uses to acc The Installations API enables you to get information about installations of your GitHub App and perform actions within those installations. An _installation_ refers to any user or organization account that has installed the app. For information on how to authenticate as an installation and limit access to specific repositories, see "[Authenticating as an installation](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)." -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} To list all GitHub App installations for an organization, see "[List app installations for an organization](/v3/orgs/#list-app-installations-for-an-organization)." -{% endif %} {% for operation in currentRestOperations %} {% if operation.subcategory == 'installations' %}{% include rest_operation %}{% endif %} diff --git a/translations/ru-RU/content/rest/reference/checks.md b/translations/ru-RU/content/rest/reference/checks.md index e19f1a8a6724..9a392f5d9417 100644 --- a/translations/ru-RU/content/rest/reference/checks.md +++ b/translations/ru-RU/content/rest/reference/checks.md @@ -19,7 +19,7 @@ The Checks API enables you to build GitHub Apps that run powerful checks against {% if operation.subcategory == 'runs' %}{% include rest_operation %}{% endif %} {% endfor %} -## Проверить модули +## Проверить пакеты {% note %} diff --git a/translations/ru-RU/content/rest/reference/code-scanning.md b/translations/ru-RU/content/rest/reference/code-scanning.md new file mode 100644 index 000000000000..42f1f093fec7 --- /dev/null +++ b/translations/ru-RU/content/rest/reference/code-scanning.md @@ -0,0 +1,14 @@ +--- +title: Code scanning +redirect_from: + - /v3/code-scanning +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta %} + +The {% data variables.product.prodname_code_scanning %} API lets you retrieve and update code scanning alerts from a repository. You can use the endpoints to create automated reports for the code scanning alerts in an organization or upload analysis results generated using offline code scanning tools. For more information, see "[Finding security vulnerabilities and errors in your code](/github/finding-security-vulnerabilities-and-errors-in-your-code)." + +{% include rest_operations_at_current_path %} diff --git a/translations/ru-RU/content/rest/reference/enterprise-admin.md b/translations/ru-RU/content/rest/reference/enterprise-admin.md index 705c9fd5fefa..64157641c9ff 100644 --- a/translations/ru-RU/content/rest/reference/enterprise-admin.md +++ b/translations/ru-RU/content/rest/reference/enterprise-admin.md @@ -124,11 +124,10 @@ GET /scim/v2/enterprises/{enterprise}/Users/{scim_user_id} ### Supported SCIM Group attributes -| Name | Тип | Description | -| ------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Name | Тип | Description | +| ------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `displayName` | `строка` | The name of the SCIM group, which must exactly match the name of the corresponding {% data variables.product.product_name %} organization. For example, if the URL of the organization is `https://github.com/octo-org`, the group name must be `octo-org`. | -| `members` | `array` | List of SCIM user IDs that are members of the group. | - +| `members` | `array` | List of SCIM user IDs that are members of the group. | {% for operation in currentRestOperations %} {% if operation.subcategory == 'scim' %}{% include rest_operation %}{% endif %} @@ -245,13 +244,13 @@ The Pre-receive Environments API allows you to create, list, update and delete e #### Pre-receive Environment -| Name | Тип | Description | -| --------------------- | --------- | ---------------------------------------------------------------------------------------------------------------- | -| `name` | `строка` | The name of the environment as displayed in the UI. | -| `image_url` | `строка` | URL to the tarball that will be downloaded and extracted. | +| Name | Тип | Description | +| --------------------- | --------- | ----------------------------------------------------------------------------------------------------------- | +| `name` | `строка` | The name of the environment as displayed in the UI. | +| `image_url` | `строка` | URL to the tarball that will be downloaded and extracted. | | `default_environment` | `boolean` | Whether this is the default environment that ships with {% data variables.product.prodname_ghe_server %}. | -| `download` | `объект` | This environment's download status. | -| `hooks_count` | `integer` | The number of pre-receive hooks that use this environment. | +| `download` | `объект` | This environment's download status. | +| `hooks_count` | `integer` | The number of pre-receive hooks that use this environment. | #### Pre-receive Environment Download diff --git a/translations/ru-RU/content/rest/reference/licenses.md b/translations/ru-RU/content/rest/reference/licenses.md index e468053b1dd6..fb755e75f8eb 100644 --- a/translations/ru-RU/content/rest/reference/licenses.md +++ b/translations/ru-RU/content/rest/reference/licenses.md @@ -18,8 +18,8 @@ If a license is matched, the license key and name returned conforms to the [SPDX - [Get a repository](/v3/repos/#get-a-repository) - [List repositories for a user](/v3/repos/#list-repositories-for-a-user) - [List organization repositories](/v3/repos/#list-organization-repositories) -- [List forks](/v3/repos/forks/#list-forks) -- [List repositories watched by a user](/v3/activity/watching/#list-repositories-watched-by-a-user) +- [List forks](/rest/reference/repos#list-forks) +- [List repositories watched by a user](/rest/reference/activity#list-repositories-watched-by-a-user) - [List team repositories](/v3/teams/#list-team-repositories) {% warning %} diff --git a/translations/ru-RU/content/rest/reference/permissions-required-for-github-apps.md b/translations/ru-RU/content/rest/reference/permissions-required-for-github-apps.md index 05030023ad6c..6b634b0325ca 100644 --- a/translations/ru-RU/content/rest/reference/permissions-required-for-github-apps.md +++ b/translations/ru-RU/content/rest/reference/permissions-required-for-github-apps.md @@ -2,7 +2,7 @@ title: Permissions required for GitHub Apps intro: 'You can find the required permissions for each {% data variables.product.prodname_github_app %}-compatible endpoint.' redirect_from: - - /v3/apps/permissions --- + - /v3/apps/permissions versions: free-pro-team: '*' enterprise-server: '*' @@ -18,12 +18,11 @@ GitHub Apps have the `Read-only` metadata permission by default. The metadata pe {% data reusables.apps.metadata-permissions %} - - [`GET /`](/v3/#root-endpoint) - [`GET /codes_of_conduct`](/v3/codes_of_conduct/#get-all-codes-of-conduct) - [`GET /codes_of_conduct/:key`](/v3/codes_of_conduct/#get-a-code-of-conduct) - [`GET /emojis`](/v3/emojis/#emojis) -- [`GET /feeds`](/v3/activity/feeds/#get-feeds) +- [`GET /feeds`](/rest/reference/activity#get-feeds) - [`GET /licenses`](/v3/licenses/#get-all-commonly-used-licenses) - [`GET /licenses/:key`](/v3/licenses/#get-a-license) - [`POST /markdown`](/v3/markdown/#render-a-markdown-document) @@ -39,22 +38,22 @@ GitHub Apps have the `Read-only` metadata permission by default. The metadata pe - [`GET /repos/:owner/:repo/community/profile`](/v3/repos/community/#get-community-profile-metrics) {% endif %} - [`GET /repos/:owner/:repo/contributors`](/v3/repos/#list-repository-contributors) -- [`GET /repos/:owner/:repo/forks`](/v3/repos/forks/#list-forks) +- [`GET /repos/:owner/:repo/forks`](/rest/reference/repos#list-forks) - [`GET /repos/:owner/:repo/languages`](/v3/repos/#list-repository-languages) - [`GET /repos/:owner/:repo/license`](/v3/licenses/#get-the-license-for-a-repository) -- [`GET /repos/:owner/:repo/stargazers`](/v3/activity/starring/#list-stargazers) +- [`GET /repos/:owner/:repo/stargazers`](/rest/reference/activity#list-stargazers) - [`GET /repos/:owner/:repo/stats/code_frequency`](/v3/repos/statistics/#get-the-weekly-commit-activity) - [`GET /repos/:owner/:repo/stats/commit_activity`](/v3/repos/statistics/#get-the-last-year-of-commit-activity) - [`GET /repos/:owner/:repo/stats/contributors`](/v3/repos/statistics/#get-all-contributor-commit-activity) - [`GET /repos/:owner/:repo/stats/participation`](/v3/repos/statistics/#get-the-weekly-commit-count) - [`GET /repos/:owner/:repo/stats/punch_card`](/v3/repos/statistics/#get-the-hourly-commit-count-for-each-day) -- [`GET /repos/:owner/:repo/subscribers`](/v3/activity/watching/#list-watchers) +- [`GET /repos/:owner/:repo/subscribers`](/rest/reference/activity#list-watchers) - [`GET /repos/:owner/:repo/tags`](/v3/repos/#list-repository-tags) - [`GET /repos/:owner/:repo/topics`](/v3/repos#get-all-repository-topics) - [`GET /repositories`](/v3/repos/#list-public-repositories) - [`GET /user/repos`](/v3/repos/#list-repositories-for-the-authenticated-user) -- [`GET /user/starred`](/v3/activity/starring/#list-repositories-starred-by-a-user) -- [`GET /user/subscriptions`](/v3/activity/watching/#list-repositories-watched-by-a-user) +- [`GET /user/starred`](/rest/reference/activity#list-repositories-starred-by-a-user) +- [`GET /user/subscriptions`](/rest/reference/activity#list-repositories-watched-by-a-user) - [`GET /users`](/v3/users/#list-users) - [`GET /users/:username`](/v3/users/#get-a-user) - [`GET /users/:username/followers`](/v3/users/followers/#list-followers-of-a-user) @@ -62,10 +61,10 @@ GitHub Apps have the `Read-only` metadata permission by default. The metadata pe - [`GET /users/:username/following/:target_user`](/v3/users/followers/#check-if-a-user-follows-another-user) - [`GET /users/:username/gpg_keys`](/v3/users/gpg_keys/#list-gpg-keys-for-a-user) - [`GET /users/:username/orgs`](/v3/orgs/#list-organizations-for-a-user) -- [`GET /users/:username/received_events`](/v3/activity/events/#list-events-received-by-the-authenticated-user) -- [`GET /users/:username/received_events/public`](/v3/activity/events/#list-public-events-received-by-a-user) +- [`GET /users/:username/received_events`](/rest/reference/activity#list-events-received-by-the-authenticated-user) +- [`GET /users/:username/received_events/public`](/rest/reference/activity#list-public-events-received-by-a-user) - [`GET /users/:username/repos`](/v3/repos/#list-repositories-for-a-user) -- [`GET /users/:username/subscriptions`](/v3/activity/watching/#list-repositories-watched-by-a-user) +- [`GET /users/:username/subscriptions`](/rest/reference/activity#list-repositories-watched-by-a-user) _Collaborators_ - [`GET /repos/:owner/:repo/collaborators`](/v3/repos/collaborators/#list-repository-collaborators) @@ -78,12 +77,12 @@ _Commit comments_ - [`GET /repos/:owner/:repo/commits/:sha/comments`](/v3/repos/comments/#list-commit-comments) _События_ -- [`GET /events`](/v3/activity/events/#list-public-events) -- [`GET /networks/:owner/:repo/events`](/v3/activity/events/#list-public-events-for-a-network-of-repositories) -- [`GET /orgs/:org/events`](/v3/activity/events/#list-public-organization-events) -- [`GET /repos/:owner/:repo/events`](/v3/activity/events/#list-repository-events) -- [`GET /users/:username/events`](/v3/activity/events/#list-events-for-the-authenticated-user) -- [`GET /users/:username/events/public`](/v3/activity/events/#list-public-events-for-a-user) +- [`GET /events`](/rest/reference/activity#list-public-events) +- [`GET /networks/:owner/:repo/events`](/rest/reference/activity#list-public-events-for-a-network-of-repositories) +- [`GET /orgs/:org/events`](/rest/reference/activity#list-public-organization-events) +- [`GET /repos/:owner/:repo/events`](/rest/reference/activity#list-repository-events) +- [`GET /users/:username/events`](/rest/reference/activity#list-events-for-the-authenticated-user) +- [`GET /users/:username/events/public`](/rest/reference/activity#list-public-events-for-a-user) _Git_ - [`GET /gitignore/templates`](/v3/gitignore/#get-all-gitignore-templates) @@ -169,7 +168,6 @@ _Поиск_ {% if currentVersion == "free-pro-team@latest" %} - [`DELETE /repos/:owner/:repo/vulnerability-alerts`](/v3/repos/#disable-vulnerability-alerts) (:write) {% endif %} -- [`POST /user/repos`](/v3/repos/#create-a-repository-for-the-authenticated-user) (:write) - [`PATCH /user/repository_invitations/:invitation_id`](/v3/repos/invitations/#accept-a-repository-invitation) (:write) - [`DELETE /user/repository_invitations/:invitation_id`](/v3/repos/invitations/#decline-a-repository-invitation) (:write) @@ -344,12 +342,10 @@ _Traffic_ _Branches_ - [`GET /repos/:owner/:repo/branches`](/v3/repos/branches/#list-branches) (:read) - [`GET /repos/:owner/:repo/branches/:branch`](/v3/repos/branches/#get-a-branch) (:read) -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - [`GET /repos/:owner/:repo/branches/:branch/protection/restrictions/apps`](/v3/repos/branches/#list-apps-with-access-to-the-protected-branch) (:write) - [`POST /repos/:owner/:repo/branches/:branch/protection/restrictions/apps`](/v3/repos/branches/#add-app-access-restrictions) (:write) - [`PUT /repos/:owner/:repo/branches/:branch/protection/restrictions/apps`](/v3/repos/branches/#set-app-access-restrictions) (:write) - [`DELETE /repos/:owner/:repo/branches/:branch/protection/restrictions/apps`](/v3/repos/branches/#remove-user-access-restrictions) (:write) -{% endif %} _Commit comments_ - [`PATCH /repos/:owner/:repo/comments/:comment_id`](/v3/repos/comments/#update-a-commit-comment) (:write) @@ -363,13 +359,8 @@ _Git_ - [`POST /repos/:owner/:repo/git/commits`](/v3/git/commits/#create-a-commit) (:write) - [`GET /repos/:owner/:repo/git/commits/:commit_id`](/v3/git/commits/#get-a-commit) (:read) - [`POST /repos/:owner/:repo/git/refs`](/v3/git/refs/#create-a-reference) (:write) -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -- [`GET /repos/:owner/:repo/git/refs/:ref`](/v3/git/refs/#get-a-reference) (:read) -- [`GET /repos/:owner/:repo/git/refs`](/v3/git/refs/#list-references) (:read) -{% else %} - [`GET /repos/:owner/:repo/git/ref/:ref`](/v3/git/refs/#get-a-reference) (:read) - [`GET /repos/:owner/:repo/git/matching-refs/:ref`](/v3/git/refs/#list-matching-references) (:read) -{% endif %} - [`PATCH /repos/:owner/:repo/git/refs/:ref`](/v3/git/refs/#update-a-reference) (:write) - [`DELETE /repos/:owner/:repo/git/refs/:ref`](/v3/git/refs/#delete-a-reference) (:write) - [`POST /repos/:owner/:repo/git/tags`](/v3/git/tags/#create-a-tag-object) (:write) @@ -401,27 +392,27 @@ _Reactions_ - [`DELETE /orgs/:org/teams/:team_slug/discussions/:discussion_number/comments/:comment_number/reactions/:reaction_id`](/v3/reactions/#delete-team-discussion-comment-reaction) (:write){% endif %} _Релизы_ -- [`GET /repos/:owner/:repo/releases`](/v3/repos/releases/#list-releases) (:read) -- [`POST /repos/:owner/:repo/releases`](/v3/repos/releases/#create-a-release) (:write) -- [`GET /repos/:owner/:repo/releases/:release_id`](/v3/repos/releases/#get-a-release) (:read) -- [`PATCH /repos/:owner/:repo/releases/:release_id`](/v3/repos/releases/#update-a-release) (:write) -- [`DELETE /repos/:owner/:repo/releases/:release_id`](/v3/repos/releases/#delete-a-release) (:write) -- [`GET /repos/:owner/:repo/releases/:release_id/assets`](/v3/repos/releases/#list-release-assets) (:read) -- [`GET /repos/:owner/:repo/releases/assets/:asset_id`](/v3/repos/releases/#get-a-release-asset) (:read) -- [`PATCH /repos/:owner/:repo/releases/assets/:asset_id`](/v3/repos/releases/#update-a-release-asset) (:write) -- [`DELETE /repos/:owner/:repo/releases/assets/:asset_id`](/v3/repos/releases/#delete-a-release-asset) (:write) -- [`GET /repos/:owner/:repo/releases/latest`](/v3/repos/releases/#get-the-latest-release) (:read) -- [`GET /repos/:owner/:repo/releases/tags/:tag`](/v3/repos/releases/#get-a-release-by-tag-name) (:read) +- [`GET /repos/:owner/:repo/releases`](/rest/reference/repos/#list-releases) (:read) +- [`POST /repos/:owner/:repo/releases`](/rest/reference/repos/#create-a-release) (:write) +- [`GET /repos/:owner/:repo/releases/:release_id`](/rest/reference/repos/#get-a-release) (:read) +- [`PATCH /repos/:owner/:repo/releases/:release_id`](/rest/reference/repos/#update-a-release) (:write) +- [`DELETE /repos/:owner/:repo/releases/:release_id`](/rest/reference/repos/#delete-a-release) (:write) +- [`GET /repos/:owner/:repo/releases/:release_id/assets`](/rest/reference/repos/#list-release-assets) (:read) +- [`GET /repos/:owner/:repo/releases/assets/:asset_id`](/rest/reference/repos/#get-a-release-asset) (:read) +- [`PATCH /repos/:owner/:repo/releases/assets/:asset_id`](/rest/reference/repos/#update-a-release-asset) (:write) +- [`DELETE /repos/:owner/:repo/releases/assets/:asset_id`](/rest/reference/repos/#delete-a-release-asset) (:write) +- [`GET /repos/:owner/:repo/releases/latest`](/rest/reference/repos/#get-the-latest-release) (:read) +- [`GET /repos/:owner/:repo/releases/tags/:tag`](/rest/reference/repos/#get-a-release-by-tag-name) (:read) ### Permission on "deployments" -- [`GET /repos/:owner/:repo/deployments`](/v3/repos/deployments/#list-deployments) (:read) -- [`POST /repos/:owner/:repo/deployments`](/v3/repos/deployments/#create-a-deployment) (:write) -- [`GET /repos/:owner/:repo/deployments/:deployment_id`](/v3/repos/deployments/#get-a-deployment) (:read){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -- [`DELETE /repos/:owner/:repo/deployments/:deployment_id`](/v3/repos/deployments/#delete-a-deployment) (:write){% endif %} -- [`GET /repos/:owner/:repo/deployments/:deployment_id/statuses`](/v3/repos/deployments/#list-deployment-statuses) (:read) -- [`POST /repos/:owner/:repo/deployments/:deployment_id/statuses`](/v3/repos/deployments/#create-a-deployment-status) (:write) -- [`GET /repos/:owner/:repo/deployments/:deployment_id/statuses/:status_id`](/v3/repos/deployments/#get-a-deployment-status) (:read) +- [`GET /repos/:owner/:repo/deployments`](/rest/reference/repos#list-deployments) (:read) +- [`POST /repos/:owner/:repo/deployments`](/rest/reference/repos#create-a-deployment) (:write) +- [`GET /repos/:owner/:repo/deployments/:deployment_id`](/rest/reference/repos#get-a-deployment) (:read){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +- [`DELETE /repos/:owner/:repo/deployments/:deployment_id`](/rest/reference/repos#delete-a-deployment) (:write){% endif %} +- [`GET /repos/:owner/:repo/deployments/:deployment_id/statuses`](/rest/reference/repos#list-deployment-statuses) (:read) +- [`POST /repos/:owner/:repo/deployments/:deployment_id/statuses`](/rest/reference/repos#create-a-deployment-status) (:write) +- [`GET /repos/:owner/:repo/deployments/:deployment_id/statuses/:status_id`](/rest/reference/repos#get-a-deployment-status) (:read) ### Permission on "emails" @@ -618,12 +609,12 @@ _Teams_ ### Permission on "organization hooks" -- [`GET /orgs/:org/hooks`](/v3/orgs/hooks/#list-organization-webhooks) (:read) -- [`POST /orgs/:org/hooks`](/v3/orgs/hooks/#create-an-organization-webhook) (:write) -- [`GET /orgs/:org/hooks/:hook_id`](/v3/orgs/hooks/#get-an-organization-webhook) (:read) -- [`PATCH /orgs/:org/hooks/:hook_id`](/v3/orgs/hooks/#update-an-organization-webhook) (:write) -- [`DELETE /orgs/:org/hooks/:hook_id`](/v3/orgs/hooks/#delete-an-organization-webhook) (:write) -- [`POST /orgs/:org/hooks/:hook_id/pings`](/v3/orgs/hooks/#ping-an-organization-webhook) (:write) +- [`GET /orgs/:org/hooks`](/rest/reference/orgs#webhooks/#list-organization-webhooks) (:read) +- [`POST /orgs/:org/hooks`](/rest/reference/orgs#webhooks/#create-an-organization-webhook) (:write) +- [`GET /orgs/:org/hooks/:hook_id`](/rest/reference/orgs#webhooks/#get-an-organization-webhook) (:read) +- [`PATCH /orgs/:org/hooks/:hook_id`](/rest/reference/orgs#webhooks/#update-an-organization-webhook) (:write) +- [`DELETE /orgs/:org/hooks/:hook_id`](/rest/reference/orgs#webhooks/#delete-an-organization-webhook) (:write) +- [`POST /orgs/:org/hooks/:hook_id/pings`](/rest/reference/orgs#webhooks/#ping-an-organization-webhook) (:write) _Teams_ - [`DELETE /teams/:team_id/projects/:project_id`](/v3/teams/#remove-a-project-from-a-team) (:read) @@ -668,14 +659,14 @@ _Teams_ ### Permission on "pages" -- [`GET /repos/:owner/:repo/pages`](/v3/repos/pages/#get-a-github-pages-site) (:read) -- [`POST /repos/:owner/:repo/pages`](/v3/repos/pages/#create-a-github-pages-site) (:write) -- [`PUT /repos/:owner/:repo/pages`](/v3/repos/pages/#update-information-about-a-github-pages-site) (:write) -- [`DELETE /repos/:owner/:repo/pages`](/v3/repos/pages/#delete-a-github-pages-site) (:write) -- [`GET /repos/:owner/:repo/pages/builds`](/v3/repos/pages/#list-github-pages-builds) (:read) -- [`POST /repos/:owner/:repo/pages/builds`](/v3/repos/pages/#request-a-github-pages-build) (:write) -- [`GET /repos/:owner/:repo/pages/builds/:build_id`](/v3/repos/pages/#get-github-pages-build) (:read) -- [`GET /repos/:owner/:repo/pages/builds/latest`](/v3/repos/pages/#get-latest-pages-build) (:read) +- [`GET /repos/:owner/:repo/pages`](/rest/reference/repos#get-a-github-pages-site) (:read) +- [`POST /repos/:owner/:repo/pages`](/rest/reference/repos#create-a-github-pages-site) (:write) +- [`PUT /repos/:owner/:repo/pages`](/rest/reference/repos#update-information-about-a-github-pages-site) (:write) +- [`DELETE /repos/:owner/:repo/pages`](/rest/reference/repos#delete-a-github-pages-site) (:write) +- [`GET /repos/:owner/:repo/pages/builds`](/rest/reference/repos#list-github-pages-builds) (:read) +- [`POST /repos/:owner/:repo/pages/builds`](/rest/reference/repos#request-a-github-pages-build) (:write) +- [`GET /repos/:owner/:repo/pages/builds/:build_id`](/rest/reference/repos#get-github-pages-build) (:read) +- [`GET /repos/:owner/:repo/pages/builds/latest`](/rest/reference/repos#get-latest-pages-build) (:read) ### Permission on "pull requests" @@ -853,9 +844,9 @@ _Teams_ ### Permission on "starring" -- [`GET /user/starred/:owner/:repo`](/v3/activity/starring/#check-if-a-repository-is-starred-by-the-authenticated-user) (:read) -- [`PUT /user/starred/:owner/:repo`](/v3/activity/starring/#star-a-repository-for-the-authenticated-user) (:write) -- [`DELETE /user/starred/:owner/:repo`](/v3/activity/starring/#unstar-a-repository-for-the-authenticated-user) (:write) +- [`GET /user/starred/:owner/:repo`](/rest/reference/activity#check-if-a-repository-is-starred-by-the-authenticated-user) (:read) +- [`PUT /user/starred/:owner/:repo`](/rest/reference/activity#star-a-repository-for-the-authenticated-user) (:write) +- [`DELETE /user/starred/:owner/:repo`](/rest/reference/activity#unstar-a-repository-for-the-authenticated-user) (:write) ### Permission on "statuses" diff --git a/translations/ru-RU/content/rest/reference/pulls.md b/translations/ru-RU/content/rest/reference/pulls.md index 5a0dfe420432..6a83277745ba 100644 --- a/translations/ru-RU/content/rest/reference/pulls.md +++ b/translations/ru-RU/content/rest/reference/pulls.md @@ -36,7 +36,7 @@ Pull Requests have these possible link relations: | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | `self` | The API location of this Pull Request. | | `html` | The HTML location of this Pull Request. | -| `задача` | The API location of this Pull Request's [Issue](/v3/issues/). | +| `проблема` | The API location of this Pull Request's [Issue](/v3/issues/). | | `комментарии` | The API location of this Pull Request's [Issue comments](/v3/issues/comments/). | | `review_comments` | The API location of this Pull Request's [Review comments](/v3/pulls/comments/). | | `review_comment` | The [URL template](/v3/#hypermedia) to construct the API location for a [Review comment](/v3/pulls/comments/) in this Pull Request's repository. | diff --git a/translations/ru-RU/content/rest/reference/repos.md b/translations/ru-RU/content/rest/reference/repos.md index b2fd4881e966..156a2a3cb665 100644 --- a/translations/ru-RU/content/rest/reference/repos.md +++ b/translations/ru-RU/content/rest/reference/repos.md @@ -186,10 +186,10 @@ In {% data variables.product.prodname_pages %} API endpoints with a `status` key * `built`: The site has been built. * `errored`: Indicates an error occurred during the build. -In {% data variables.product.prodname_pages %} API endpoints that {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}support the `mister-fantastic-preview` and{% endif %} return GitHub Pages site information, the JSON responses include these fields: +In {% data variables.product.prodname_pages %} API endpoints that return GitHub Pages site information, the JSON responses include these fields: * `html_url`: The absolute URL (including scheme) of the rendered Pages site. For example, `https://username.github.io`. * `source`: An object that contains the source branch and directory for the rendered Pages site. This includes: - - `branch`: The repository branch used to publish your [site's source files](/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site). For example, _master_ or _gh-pages_. + - `branch`: The repository branch used to publish your [site's source files](/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site). For example, _main_ or _gh-pages_. - `path`: The repository directory from which the site publishes. Will be either `/` or `/docs`. {% for operation in currentRestOperations %} @@ -216,7 +216,7 @@ The Repository Statistics API allows you to fetch the data that {% data variable Computing repository statistics is an expensive operation, so we try to return cached data whenever possible. If the data hasn't been cached when you query a repository's statistics, you'll receive a `202` response; a background job is also fired to start compiling these statistics. Give the job a few moments to complete, and then submit the request again. If the job has completed, that request will receive a `200` response with the statistics in the response body. -Repository statistics are cached by the SHA of the repository's default branch, which is usually master; pushing to the default branch resets the statistics cache. +Repository statistics are cached by the SHA of the repository's default branch; pushing to the default branch resets the statistics cache. ### Statistics exclude some types of commits diff --git a/translations/ru-RU/data/glossaries/candidates.yml b/translations/ru-RU/data/glossaries/candidates.yml index 3fb35f089095..97d4c872a461 100644 --- a/translations/ru-RU/data/glossaries/candidates.yml +++ b/translations/ru-RU/data/glossaries/candidates.yml @@ -16,9 +16,9 @@ - term: кредит - - term: команда управления учетной записью + term: команда управления учетными записями - - term: тикет + term: заявка - term: Поддержка корпоративной версии - @@ -32,7 +32,7 @@ - term: Низкий - - term: расширенный набор поддержки + term: пакет расширенной поддержки - term: название компании - @@ -50,7 +50,7 @@ - term: Георепликация - - term: система продукции + term: производственная система - term: обезличивание конфиденциальных данных - @@ -60,7 +60,7 @@ - term: Связаться с отделом продаж - - term: Обращение к тренингу + term: Связаться с отделом обучения - term: Исходящий - @@ -70,7 +70,7 @@ - term: тарифный план - - term: план объекта + term: поэлементный тарифный план - term: роль - @@ -92,7 +92,7 @@ - term: коммит предшествующего элемента - - term: график вклада + term: диаграмма вклада - term: утвердить - @@ -106,15 +106,15 @@ - term: обсуждение - - term: политика обслуживания и соблюдения конфиденциальности + term: условия предоставления услуг и политика конфиденциальности - - term: установить в новое состояние + term: восстановить - term: центр администратора - term: академическая роль - - term: скидка на образование + term: образовательная скидка - term: одноразовый домен - @@ -142,19 +142,19 @@ - term: кратковременный - - term: предполетная проверка + term: предварительная проверка - term: представитель учетной записи - - term: единообразный поиск + term: унифицированный поиск - - term: бездействующий пользователь + term: неактивный пользователь - term: доставка - term: обеспечение сохранности юридически значимой информации - - term: незапрошенный ответ SSO + term: незапрашиваемый ответ SSO - term: IdP инициировал SSO - @@ -170,11 +170,11 @@ - term: единообразное представление - - term: трехточечный дифф + term: трехточечное различие - - term: полнофункциональный дифф + term: расширенное различие - - term: общение + term: разговор - term: публичный gist / секретный gist - @@ -184,13 +184,13 @@ - term: заказы на продление - - term: цены для пользователя + term: ценообразование в расчете на одного пользователя - term: наблюдатель - - term: Требуемое подписание коммита + term: Обязательное подписывание коммита - - term: Проверить модули + term: Проверить пакеты - term: скидка на класс - diff --git a/translations/ru-RU/data/glossaries/external.yml b/translations/ru-RU/data/glossaries/external.yml index 385e00368ab2..1cc4acd5666f 100644 --- a/translations/ru-RU/data/glossaries/external.yml +++ b/translations/ru-RU/data/glossaries/external.yml @@ -80,7 +80,7 @@ - term: Проверка description: >- - Проверка — это тип проверки состояния на {% data variables.product.product_name %}. См. «[Проверки состояния](#status-checks)» + Проверка — это типа проверки состояния на {% data variables.product.product_name %}. См. «[Проверки состояния](#status-checks)». - term: выгрузка description: >- @@ -106,7 +106,7 @@ description: >- Возможность запуска служб GitHub Enterprise в нескольких узлах и выполнения запросов на выравнивание нагрузки между ними. - - term: График частоты обновления кода + term: Диаграмма частоты обновления кода description: >- График репозитория, на котором показывается добавление и удаление содержимого за неделю в журнале работы с репозиторием. - @@ -128,7 +128,7 @@ term: автор коммита description: Пользователь, выполняющий коммит. - - term: График коммита + term: Диаграмм коммита description: >- График репозитория, на котором показаны все коммиты, внесенные в репозиторий за последний год. - @@ -146,7 +146,7 @@ description: >- Также называется НИ. Процесс, который запускает автоматические сборки и тесты после внесения изменения сотрудником в сконфигурированном репозитории в GitHub. НИ — это распространенная передовая методика в разработке программного обеспечения, которая помогает обнаруживать ошибки. - - term: график вклада + term: диаграмма вклада description: >- Часть профиля пользователя, в которой ​​отображается его вклад за период до одного года на ежедневной основе. - @@ -161,7 +161,7 @@ description: >- Участник — сотрудник, не имеющий доступа с правами соавтора к репозиторию, но который внес свой вклад в проект и открытый запрос которого на включение внесенных изменений был слит в репозиторий. - - term: График участников + term: Диаграмма участников description: График репозитория, на котором отображаются 100 основных участников репозитория. - term: купон @@ -180,9 +180,9 @@ - term: ветвь по умолчанию description: >- - Базовая ветвь в вашем репозитории, для которой автоматически выполняются все запросы на чтение и коммиты кода, если вы не указали другую ветвь. Эта ветвь обычно называется главной. + The base branch for new pull requests and code commits in a repository. Each repository has at least one branch, which Git creates when you initialize the repository. The first branch is usually called `main`, and is often the default branch. - - term: График зависимостей + term: Диаграмма зависимостей description: >- График репозитория, на котором показаны пакеты, проекты и репозитории, зависимые от публичного репозитория. - @@ -213,7 +213,7 @@ description: Уведомления отправленные на адрес электронной почты пользователя. - term: Учетная запись предприятия - description: Учетные записи предприятий позволяют централизованно управлять политикой и выставлением счетов для нескольких {% data variables.product.prodname_dotcom_the_website %} организаций. {% data reusables.gated-features.enterprise-accounts %} + description: Учетные записи предприятия позволяют централизованно управлять политикой и выставление счетов для нескольких {% data variables.product.prodname_dotcom_the_website %} организаций. {% data reusables.gated-features.enterprise-accounts %} - term: Проводник description: >- @@ -234,7 +234,7 @@ description: >- При использовании команды «git fetch» изменения добавляются из удаленного репозитория в вашу локальную рабочую ветвь без необходимости их исполнения. В отличие от команды «git pull», выборка позволяет просмотреть изменения перед их внесением в вашу локальную ветвь. - - term: пользователи, на которых Вы подписаны + term: пользователи, на которых вы подписаны description: Позволяет получать уведомления о вкладе и активности других пользователей. - term: принудительная отправка @@ -257,7 +257,7 @@ description: >- Git — это программа с открытым исходным кодом для отслеживания изменений в текстовых файлах. Она была разработана автором операционной системы Linux и является основной технологией, лежащей в основе социального и пользовательского интерфейса GitHub. - - term: приложение GitHub + term: Приложение GitHub description: >- Приложения GitHub предоставляют услуги для всей организации и используют собственные алгоритмы при выполнении своих функций. Их можно настроить непосредственно для учетных записей организаций и пользователей и предоставить им доступ к определенным репозиториям. У них имеются детальные разрешения и встроенные веб-перехватчики. - @@ -268,7 +268,7 @@ description: >- Инструмент для быстрого импорта репозиториев исходного кода, включая коммиты и журнал изменений, в GitHub для пользователей. - - term: вакансии GitHub + term: Вакансии GitHub description: >- Сайт GitHub, где работодатели могут публиковать вакансии, которые могут заинтересовать пользователей GitHub. - @@ -317,7 +317,7 @@ description: >- Автоматически создаваемое изображение, используемое в качестве стандартной фотографии профиля при регистрации пользователя в GitHub. Пользователи могут заменить свой идентикон на желаемую фотографию профиля. - - term: поставщик удостоверений + term: провайдер идентификации description: >- Также называется IdP. Доверенный поставщик, позволяющий использовать единый вход SAML для доступа к другим сайтам. - @@ -391,16 +391,16 @@ description: >- Ветвь разработки по умолчанию. Каждый раз при создании репозитория Git создается ветвь с именем «master», которая становится активной ветвью. В большинстве случаев она содержит локальную разработку, хотя это чисто условно и необязательно. - - term: График участников + term: Диаграмма участников description: График репозитория, на котором показаны все ответвления репозитория. - term: упоминание description: >- - Уведомление, направляемое пользователю с указанием перед именем пользователя символа @. Пользователи организации в GitHub также могут быть членами команды, которых можно упомянуть. + Уведомление, направляемое пользователю путем указания перед именем пользователя символа @. Пользователи организации в GitHub также могут быть членами команды, которых можно упомянуть. - term: слияние description: >- - При слиянии изменения из одной ветви (из того же репозитория или из ответвления) применяются в другой ветви. Это часто выполняется как «запрос на чтение» (который можно рассматривать как запрос на слияние), или с помощью командной строки. Слияние может выполняться с помощью запроса на чтение в веб-интерфейсе GitHub.com при отсутствии конфликтов изменений, или всегда может выполняться с помощью командной строки. + При слиянии изменения из одной ветви (из того же репозитория или из ответвления) применяются в другой ветви. Это часто выполняется как «запрос на включение внесенных изменений» (который можно рассматривать как запрос на слияние), или с помощью командной строки. Слияние можно выполнять с помощью запроса на включение внесенных изменений в веб-интерфейсе GitHub.com при отсутствии конфликтов изменений, или в любых ситуациях с помощью командной строки. - term: конфликт слияния description: >- @@ -408,7 +408,7 @@ - term: контрольная точка description: >- - Способ отслеживания хода выполнения задачи по группам проблем или запросам на чтение в репозитории. + Способ отслеживания хода выполнения задачи по группам проблем или запросам на включение внесенных изменений в репозитории. - term: зеркало description: Новая копия репозитория. @@ -417,15 +417,15 @@ description: >- Дочерняя команда родительской команды. Может существовать несколько дочерних (или вложенных) команд. - - term: Сетевой график + term: Сетевая диаграмма description: >- - График репозитория, на котором показана история ветви всей сети репозитория, включая ветви корневого репозитория и ветви ответвлений, которые содержат уникальные для сети коммиты. + Диаграмма репозитория, на которой показана история ветвей всей сети репозитория, включая ветви корневого репозитория и ветви ответвлений, которые содержат уникальные для сети коммиты. - term: Лента новостей description: >- Просмотр активности в репозиториях или активности сотрудников, работу которых вы контролируете. В ленте новостей организации отображается активность в репозиториях, принадлежащих организации. - - term: не простое перемещение вперед + term: не быстрое перемещение вперед description: >- Если ваша локальная копия репозитория не синхронизирована с предшествующим репозиторием и вам нужно выбрать изменения в предыдущих элементах до отправки своих локальных изменений. - @@ -433,9 +433,9 @@ description: >- Обновления, доставляемые через Интернет или по электронной почте, в зависимости от ваших настроек, в которых содержится информация об интересующих вас действиях. - - term: OAuth App + term: Приложение OAuth description: >- - Стороннее приложение, использующее токены доступа, а не пароли для доступа пользователей к информации. + Стороннее приложение, использующее для доступа пользователей к информации токены доступа, а не пароли. - term: Токен OAuth description: Токен доступа, используемый в приложениях OAuth для доступа пользователей к информации. @@ -455,7 +455,7 @@ term: владелец организации description: Пользователи, которые имеют доступ со всеми правами администратора к своей организации. - - term: origin + term: исходный description: >- Стандартный исходный репозиторий. В большинстве проектов есть по крайней мере один исходный проект, который в нем отслеживается. По умолчанию для этой цели используется именно исходный. - @@ -486,7 +486,7 @@ description: >- Репозиторий, который пользователь решил разместить на видном месте в своем профиле. - - term: предварительно полученные хуки + term: предварительно полученные перехватчики description: >- Скрипты, выполняемые на сервере GitHub Enterprise, с помощью которых можно выполнить проверку качества. - @@ -508,13 +508,13 @@ description: >- Пользовательское изображение, загружаемое пользователями в GitHub, для идентификации их активности, обычно с именем пользователя. Также называется аватаром. - - term: группа управления проектом + term: панель проекта description: >- Панели в GitHub, на которых отображаются проблемы, запросы на чтение и заметки, упорядоченные по категориям в виде карточек в столбцах. - term: защищенная ветвь description: >- - В защищенных ветвях блокируются некоторые функции Git в ветви, которую администратор репозитория хочет заблокировать. Их нельзя принудительно отправить, удалить, выполнить для них слияние изменений без выполнения обязательных проверок или утверждения требуемых версий, а также невозможно загрузить в них файлы из веб-интерфейса GitHub. Защищенная ветвь — это обычно ветвью по умолчанию. + В защищенных ветвях блокируются некоторые функции Git в ветви, которую администратор репозитория хочет заблокировать. Их нельзя принудительно отправить, удалить, выполнить для них слияние изменений без выполнения обязательных проверок или утверждения требуемых версий, а также невозможно загрузить в них файлы из веб-интерфейса GitHub. Защищенная ветвь — это обычно ветвь по умолчанию. - term: публичный вклад description: Участие в работе над публичным (не частным) репозиторием. @@ -523,29 +523,29 @@ description: >- Публичный репозиторий могут просматривать все, в том числе лица, не являющиеся пользователями GitHub. - - term: чтение и слияние + term: включение внесенных изменений description: >- - Pull — процедура выборки изменений и их слияния. Например, если кто-то редактирует удаленный файл, над которым вы оба работаете, и вы захотите внести эти изменения в свою локальную копию, чтобы обновить ее. См. также «выборка». + Pull — процедура выборки изменений и их слияние. Например, если кто-то редактирует удаленный файл, над которым вы оба работаете, и вы захотите внести эти изменения в свою локальную копию, чтобы обновить ее. См. также «выборка». - - term: доступ на чтение + term: доступ на включение внесенных изменений description: Синоним доступа на чтение. - - term: запрос на чтение + term: запрос на включение внесенных изменений description: >- - Запросы на чтение — это предлагаемые изменения в репозиторий, отправленные пользователем и принятые или отклоненные соавторами репозитория. Как и проблемы, запросы на чтение обсуждаются в отдельном форуме. + Запросы на включение внесенных изменений — это предлагаемые изменения в репозиторий, отправленные пользователем и принятые или отклоненные соавторами репозитория. Как и проблемы, запросы на включение внесенных изменений обсуждаются в отдельном форуме. - - term: проверить запрос на чтение + term: анализ запроса на включение внесенных изменений description: >- - Комментарии от соавторов к запросу на чтение, которые утверждают изменения или просят внести дальнейшие изменения перед слиянием запроса на чтение. + Комментарии от соавторов к запросу на включение внесенных изменений, которые утверждают изменения или просят внести дальнейшие изменения перед слиянием запроса на включение внесенных изменений. - term: Импульсный граф - description: График репозитория, на котором показана активность в репозитории. + description: Диаграмма репозитория, на которой показана активность в репозитории. - term: График частоты обновления description: >- - График репозитория, на котором показана частота обновлений репозитория по дням недели и времени суток. + Диаграмма репозитория, на которой показана частота обновлений репозитория по дням недели и времени суток. - - term: запись + term: отправка description: >- «Push» означает отправку коммитированных изменений в удаленный репозиторий в GitHub.com. Например, при внесении локальных изменений можно отправить эти изменения, чтобы другие участники получили к ним доступ. - @@ -553,28 +553,28 @@ description: >- После успешной отправки ветви в удаленный репозиторий удаленная ветвь обновляется с учетом изменений, внесенных в вашу локальную ветвь. При отправке ветви Git определяет ссылку HEAD ветви в удаленном репозитории и проверяет, является ли она прямым предшественником локальной ссылки HEAD ветви. После проверки Git скачивает все объекты (доступные из локальной ссылки HEAD и отсутствующие в удаленном репозитории) в удаленную базу данных объектов, после чего обновляет удаленную ссылку HEAD. Если удаленный HEAD не является предшественником локального HEAD, команда «push» не выполняется. - - term: доступ на запись - description: Синоним доступа на чтение. + term: доступ на отправку + description: Синоним доступа на запись. - term: доступ на чтение description: >- - Уровень разрешений в репозитории, который позволяет пользователю извлекать или читать данные из репозитория. Все публичные репозитории предоставляют доступ на чтение всем пользователям GitHub. Синоним доступа pull. + Уровень разрешений в репозитории, который позволяет пользователю извлекать или читать данные из репозитория. Все публичные репозитории предоставляют доступ на чтение всем пользователям GitHub. Синоним доступа на включение внесенных изменений. - term: README description: Текстовый файл, содержащий информацию о файлах в репозитории, который обычно является первым файлом, который видит посетитель вашего репозитория. Файл README, а также лицензия репозитория, правила участия в разработке и кодекс поведения помогают вам совместно определять ожидаемые результаты и управлять участием других в разработке вашего проекта. - term: переместить description: >- - Повторное применение ряда изменений из ветви в другую базу и сброса HEAD этой ветви к результату. + Повторное применение ряда изменений из ветви в другую базу и сброс HEAD этой ветви к результату. - - term: Восстановление учетных записей в другом месте + term: Восстановление учетных записей в любом месте description: >- Позволяет пользователям настроить дополнительный уровень безопасности своей учетной записи GitHub на случай утери данных для двухфакторной аутентификации или кодов восстановления доступа. Пользователи могут связать свою учетную запись GitHub со своей учетной записью Facebook, сохранив данные для аутентификации в виде токена восстановления учетной записи для своей учетной записи GitHub, связанной с Facebook. - term: код восстановления description: Код для восстановления доступа к учетной записи GitHub пользователя. - - term: релиз + term: версия description: Способ компоновки и распространения программного обеспечения среди ваших пользователей в GitHub. - term: удаленный @@ -595,33 +595,33 @@ - term: репозиторий description: >- - Репозиторий — это самый основной элемент GitHub. Его проще всего представить в виде папки проекта. Репозиторий содержит все файлы проекта (включая документацию) и в нем хранится история изменений каждого файла. С репозиториями могут работать несколько соавторов, и они могут быть публичными или частными. + Репозиторий — это самый основной элемент GitHub. Его проще всего представить в виде папки проекта. Репозиторий содержит все файлы проекта (включая документацию), и в нем хранится история изменений каждого файла. С репозиториями могут работать несколько соавторов, и они могут быть публичными или частными. - - term: график репозитория + term: диаграмма репозитория description: Визуальное представление данных вашего репозитория. - term: обслуживающий репозитория description: >- - Лицо, осуществляющее управление репозиторием. Этот специалист оказывает помощь в приоритизации проблем и использует метки и другие функции для управления работой репозитория. Этот специалист также может отвечать за сопровождение файла README и инициировать обновление дополнительных файлов. + Лицо, осуществляющее управление репозиторием. Этот специалист оказывает помощь в приоритезации проблем и использует метки и другие функции для управления работой репозитория. Этот специалист также может отвечать за сопровождение файла README и инициировать обновление дополнительных файлов. - - term: обязательная проверка pull request + term: обязательная проверка запроса на включение внесенных изменений description: >- - Выполнение обязательных проверок гарантирует, что запросы на чтение прошли хотя бы одну утвержденную проверку перед тем, как соавторы смогут вносить изменения в защищенную ветвь. + Выполнение обязательных проверок гарантирует, что запросы на включение внесенных изменений прошли хотя бы одну утвержденную проверку перед тем, как соавторы смогут вносить изменения в защищенную ветвь. - term: обязательная проверка состояния description: >- - Проверка запросов на чтение, что обеспечивают выполнение всех необходимых тестов непрерывной интеграции перед тем, как соавторы смогут вносить изменения в защищенную ветвь. + Проверка запросов на включение внесенных изменений, что обеспечивает выполнение всех необходимых тестов непрерывной интеграции перед тем, как соавторы смогут вносить изменения в защищенную ветвь. - - term: resolve + term: разрешение проблем description: Действие по исправлению вручную проблем, которые остались после неудачного автоматического слияния. - term: откатить description: >- - В случае отмены запроса на чтение в GitHub автоматически создается новый запрос на чтение , одним коммитом, который возвращает в исходное состояние коммит слияния из исходного объединенного запроса на чтение. В Git отмена коммитов выполняется с помощью команды «git revert». + В случае отмены запроса на включение внесенных изменений в GitHub автоматически создается новый запрос на включение внесенных изменений с одним коммитом, который возвращает в исходное состояние коммит слияния из исходного объединенного запроса на включение внесенных изменений. В Git отмена коммитов выполняется с помощью команды «git revert». - term: проверка description: >- - Обзоры позволяют другим пользователям, которые имеют доступ к вашему репозиторию, комментировать изменения, предложенные в запросах на чтение, утверждать изменения или создавать запросы на дальнейшие изменения до объединения запросов на чтение. + Проверки позволяют другим пользователям, которые имеют доступ к вашему репозиторию, комментировать изменения, предложенные в запросах на включение внесенных изменений, утверждать изменения или создавать запросы на дальнейшие изменения до объединения запросов на включение внесенных изменений. - term: корневой каталог description: Первый каталог в иерархии. @@ -631,25 +631,25 @@ - term: сохраненный ответ description: >- - Комментарий, который можно сохранить и добавить в свою учетную запись пользователя GitHub, для его использования при решении проблем и создании запросов на чтение в GitHub. + Комментарий, который можно сохранить и добавить в свою учетную запись пользователя GitHub, для его использования при решении проблем и создании запросов на включение внесенных изменений в GitHub. - term: область description: >- Именованные группы разрешений, которые приложение OAuth может запрашивать для доступа как к открытым, так и к конфиденциальным данным. - - term: пользователь + term: место description: >- Пользователь в организации GitHub Enterprise. Также можно назвать «количеством мест». - term: секретная команда description: >- - Команда, которая видна только другим участникам команды и специалистам с разрешениями владельца. + Команда, которая видна только другим участникам команды и пользователям с правами владельца. - term: журнал безопасности description: >- Журнал, в котором содержатся последние 50 действий или действия, выполненные за последние 90 дней. - - term: служебный хук + term: служебный перехватчик description: >- Также называется «веб-хук». Веб-хуки предоставляют способ доставки уведомлений на внешний веб-сервер всякий раз, когда в репозитории или организации выполняются определенные действия. - @@ -673,7 +673,7 @@ - term: состояние description: >- - Визуальное представление в запросе на чтение подвтерждения соответствия ваших коммитов требованиям, установленным для репозитория, с которым вы работаете. + Визуальное представление в запросе на включение внесенных изменений подтверждения соответствия ваших коммитов требованиям, установленным для репозитория, с которым вы работаете. - term: Проверки состояния description: >- @@ -684,7 +684,7 @@ Закладка или добавление репозитория в избранное. С помощью звезд можно вручную ранжировать популярность проектов. - term: подписка - description: План пользователя или организации в GitHub. + description: Тарифный план пользователя или организации в GitHub. - term: команда description: >- @@ -694,12 +694,12 @@ description: >- Члены организации, у которых есть подмножество разрешений, доступных владельцам организации для управления командами. - - term: План команды + term: Тарифный план команды description: >- Тарифный план организации, который предоставляет неограниченное количество публичных и частных репозиториев. - term: история действий - description: Ряд событий в запросе на чтение или в профиле пользователя. + description: Ряд событий в запросе на включение внесенных изменений или в профиле пользователя. - term: тематическая ветвь description: >- @@ -707,17 +707,17 @@ - term: темы description: >- - Способ исследования репозиториев в определенной предметной области, находить проекты, в работе над которыми можно участвовать, и находить новые решения конкретной проблемы в GitHub. + Способ исследования репозиториев в определенной предметной области, поиска проектов, в работе над которыми можно участвовать, и нахождения новых решений конкретной проблемы в GitHub. - - term: График трафика + term: Диаграмма трафика description: >- - График репозитория, на котором показан трафик репозитория, включая полные клоны (не выборки), посетители за последние 14 дней, ссылающиеся сайты и популярный контент. + Диаграмма репозитория, на которой показан трафик репозитория, включая полные клоны (не выборки), посетители за последние 14 дней, ссылающиеся сайты и популярный контент. - term: передача description: >- Передача репозитория — смена владельца репозитория. Новый владелец сможет сразу же осуществлять управлять содержимым репозитория, проблемами, запросами на чтение, релизами и настройками. - - term: предыдущий этап + term: предыдущий description: >- В контексте ветви или ответвления, ветвь первого порядка в исходном репозитории часто называется «исходной ветвью», так как чаще всего из нее берут начало другие изменения. Ветвь/ответвление, с которыми вы работаете, в таком случае называется «последующей». Также называется исходной. - @@ -737,18 +737,18 @@ - term: слежение description: >- - Пользователь может отслеживать действия в репозитории или проблему, получая уведомления об обновлениях проблемы или запроса на чтение. + Пользователь может отслеживать действия в репозитории или проблему, получая уведомления об обновлениях проблемы или запроса на включение внесенных изменений. - - term: извещения о слежении + term: уведомления слежения description: Уведомление об активности в репозитории, на которое подписан пользователь. - term: веб-уведомления description: >- Уведомления, отображаемые в веб-интерфейсе GitHub: https://github.com/notifications - - term: вебхуки + term: веб-перехватчики description: >- - Веб-хуки позволяют выполнять сборки или настраивать приложения GitHub путем подписки на уведомления об определенных событиях в GitHub.com. Веб-хуки обеспечивают доставку уведомлений на внешний веб-сервер всякий раз, когда в репозитории или организации выполняются определенные действия. Также называется хуком службы. + Веб-перехватчики позволяют выполнять сборки или настраивать приложения GitHub путем подписки на уведомления об определенных событиях в GitHub.com. Веб-перехватчики обеспечивают доставку уведомлений на внешний веб-сервер всякий раз, когда в репозитории или организации выполняются определенные действия. Также называется перехватчиком службы. - term: Работает с GitHub description: Список интеграций с GitHub. diff --git a/translations/ru-RU/data/glossaries/internal.yml b/translations/ru-RU/data/glossaries/internal.yml index c0085e767a11..77dcb0447596 100644 --- a/translations/ru-RU/data/glossaries/internal.yml +++ b/translations/ru-RU/data/glossaries/internal.yml @@ -44,7 +44,7 @@ term: активы description: 'Отдельные файлы, например изображения, фотографии, видео и текстовые файлы.' - - term: веб-канал Atom + term: канал Atom description: Легкий XML-формат, упрощающий синдикацию веб-контента. - term: журнал аудита @@ -65,7 +65,7 @@ description: >- Чистый репозиторий обычно представляет собой каталог с соответствующим названием и с расширением .git, который не имеет локально выгруженных копий файлов, изменения которых контролируются. То есть все управляющие и контрольные файлы Git, которые обычно должны находиться в скрытом подкаталоге .git, вместо этого расположены в каталоге repository.git, а все остальные файлы отсутствуют и не выгружаются. Обычно издатели публичных репозиториев обеспечивают свободный доступ к чистым репозиториям. - - term: Инструмент очистки репозитория BFG + term: Средство очистки репозитория BFG description: BFG. Инструмент стороннего разработчика, предназначенный для удаления данных из журнала репозитория Git. - term: объект типа «большой двоичный объект» @@ -276,17 +276,17 @@ description: >- Также носит название «интроспектива». Способ запроса схемы GraphQL для получения данных о типах поддерживаемых запросов. - - term: iPython notebook + term: блокнот iPython description: >- Веб-приложение, которое фиксирует весь процесс вычисления: разработка, документирование и выполнение кода, а также информирование о результатах. - term: JIRA description: Продукт Atlassian для отслеживания проблем. - - term: Jupyter notebook + term: блокнот Jupyter description: Блокнот, который содержит как код, так и элементы форматированного текста. - - term: kernel + term: ядро description: Компьютерная программа, которая является ядром операционной системы компьютера. - term: kramdown @@ -737,7 +737,7 @@ description: >- Дерево фактически выгруженных файлов. Рабочее дерево обычно содержит содержимое дерева коммитов HEAD, а также любые сделанные, но не внесенные локальные изменения. - - term: WYSIWIG + term: WYSIWYG description: >- Отображение редактируемого текста максимально похожим на конечный результат образом. Аббревиатура означает, что текст на экране выглядит таким же, каким его будет видеть пользователь. - diff --git a/translations/ru-RU/data/graphql/graphql_previews.yml b/translations/ru-RU/data/graphql/graphql_previews.yml index b24e9283041e..4d59328a4aa2 100644 --- a/translations/ru-RU/data/graphql/graphql_previews.yml +++ b/translations/ru-RU/data/graphql/graphql_previews.yml @@ -27,57 +27,6 @@ - CreateDeploymentPayload owning_teams: - '@github/ecosystem-api' -- - title: Checks - description: This preview adds support for reading checks created by GitHub Apps. - toggled_by: ':antiope-preview' - announcement: null - updates: null - toggled_on: - - CheckAnnotationRange - - CheckAnnotationPosition - - CheckAnnotationSpan - - CheckAnnotation - - CheckAnnotationConnection.nodes - - CheckAnnotationData - - CheckAnnotationEdge.node - - CheckAnnotationLevel - - CheckConclusionState - - CheckStatusState - - CheckSuiteAutoTriggerPreference - - CheckRun - - CheckRunConnection.nodes - - CheckRunEdge.node - - CheckRunAction - - CheckRunFilter - - CheckRunOutput - - CheckRunOutputImage - - CheckRunType - - CheckSuite - - CheckSuiteConnection.nodes - - CheckSuiteEdge.node - - CheckSuiteFilter - - CreateCheckRunInput - - CreateCheckRunPayload - - CreateCheckSuiteInput - - CreateCheckSuitePayload - - Commit.checkSuites - - Mutation.createCheckRun - - Mutation.createCheckSuite - - Mutation.rerequestCheckSuite - - Mutation.updateCheckRun - - Mutation.updateCheckSuitePreferences - - Push - - RequestableCheckStatusState - - RerequestCheckSuiteInput - - RerequestCheckSuitePayload - - UpdateCheckRunInput - - UpdateCheckRunPayload - - UpdateCheckSuitePayload.checkSuite - - UpdateCheckSuitePreferencesInput - - UpdateCheckSuitePreferencesPayload - owning_teams: - - '@github/ce-extensibility' - title: >- MergeInfoPreview - More detailed information about a pull request's merge state. diff --git a/translations/ru-RU/data/products.yml b/translations/ru-RU/data/products.yml index 6ef336484225..d8ced2f7d762 100644 --- a/translations/ru-RU/data/products.yml +++ b/translations/ru-RU/data/products.yml @@ -4,7 +4,7 @@ #note this file should not be translated productsInOrder: - github - - enterpriseServer + - admin - actions - пакеты - developers @@ -12,12 +12,3 @@ productsInOrder: - graphql - insights - desktop -#TODO this can be removed when the new versioning handling is in place -hasEnterpriseUserVersions: - - github - - actions - - developers - - rest - - graphql - - insights - - пакеты diff --git a/translations/ru-RU/data/reusables/actions/about-artifact-log-retention.md b/translations/ru-RU/data/reusables/actions/about-artifact-log-retention.md new file mode 100644 index 000000000000..aa8a5300359d --- /dev/null +++ b/translations/ru-RU/data/reusables/actions/about-artifact-log-retention.md @@ -0,0 +1,6 @@ +By default, the artifacts and log files generated by workflows are retained for 90 days before they are automatically deleted. You can adjust the retention period, depending on the type of repository: + +- For public repositories: you can change this retention period to anywhere between 1 day or 90 days. +- For private, internal, and {% data variables.product.prodname_enterprise %} repositories: you can change this retention period to anywhere between 1 day or 400 days. + +When you customize the retention period, it only applies to new artifacts and log files, and does not retroactively apply to existing objects. For managed repositories and organizations, the maximum retention period cannot exceed the limit set by the managing organization or enterprise. diff --git a/translations/ru-RU/data/reusables/actions/about-artifacts.md b/translations/ru-RU/data/reusables/actions/about-artifacts.md index 99b604753e4b..232a96ad0971 100644 --- a/translations/ru-RU/data/reusables/actions/about-artifacts.md +++ b/translations/ru-RU/data/reusables/actions/about-artifacts.md @@ -1 +1 @@ -Artifacts enable you to share data between jobs in a workflow and store data once that workflow has completed. \ No newline at end of file +Artifacts enable you to share data between jobs in a workflow and store data once that workflow has completed. diff --git a/translations/ru-RU/data/reusables/actions/about-secrets.md b/translations/ru-RU/data/reusables/actions/about-secrets.md index 94b36e1c5846..9035067f833a 100644 --- a/translations/ru-RU/data/reusables/actions/about-secrets.md +++ b/translations/ru-RU/data/reusables/actions/about-secrets.md @@ -1 +1 @@ -Encrypted secrets allow you to store sensitive information, such as access tokens, in your repository or organization. \ No newline at end of file +Encrypted secrets allow you to store sensitive information, such as access tokens, in your repository or organization. diff --git a/translations/ru-RU/data/reusables/actions/about-self-hosted-runners.md b/translations/ru-RU/data/reusables/actions/about-self-hosted-runners.md index 0e2edd274acf..5ac03cc46b28 100644 --- a/translations/ru-RU/data/reusables/actions/about-self-hosted-runners.md +++ b/translations/ru-RU/data/reusables/actions/about-self-hosted-runners.md @@ -1 +1 @@ -Self-hosted runners allow you to host your own runners and customize the environment used to run jobs in your {% data variables.product.prodname_actions %} workflows. \ No newline at end of file +Self-hosted runners allow you to host your own runners and customize the environment used to run jobs in your {% data variables.product.prodname_actions %} workflows. diff --git a/translations/ru-RU/data/reusables/actions/about-workflow-jobs.md b/translations/ru-RU/data/reusables/actions/about-workflow-jobs.md index ba8ef85e4da8..33439420967f 100644 --- a/translations/ru-RU/data/reusables/actions/about-workflow-jobs.md +++ b/translations/ru-RU/data/reusables/actions/about-workflow-jobs.md @@ -1 +1 @@ -A workflow job is a set of steps that execute on the same runner. \ No newline at end of file +A workflow job is a set of steps that execute on the same runner. diff --git a/translations/ru-RU/data/reusables/actions/about-workflow-runs.md b/translations/ru-RU/data/reusables/actions/about-workflow-runs.md index fc10b8a30547..103cdc577724 100644 --- a/translations/ru-RU/data/reusables/actions/about-workflow-runs.md +++ b/translations/ru-RU/data/reusables/actions/about-workflow-runs.md @@ -1 +1 @@ -A workflow run is an instance of your workflow that runs when the pre-configured event occurs. \ No newline at end of file +A workflow run is an instance of your workflow that runs when the pre-configured event occurs. diff --git a/translations/ru-RU/data/reusables/actions/about-workflows.md b/translations/ru-RU/data/reusables/actions/about-workflows.md index 6ff1dd709ae1..3c044274d0f5 100644 --- a/translations/ru-RU/data/reusables/actions/about-workflows.md +++ b/translations/ru-RU/data/reusables/actions/about-workflows.md @@ -1 +1 @@ -Workflows automate your software development life cycle with a wide range of tools and services. \ No newline at end of file +Workflows automate your software development life cycle with a wide range of tools and services. diff --git a/translations/ru-RU/data/reusables/actions/actions-app-actions-permissions-api.md b/translations/ru-RU/data/reusables/actions/actions-app-actions-permissions-api.md index 251474c83b40..90dc3d003980 100644 --- a/translations/ru-RU/data/reusables/actions/actions-app-actions-permissions-api.md +++ b/translations/ru-RU/data/reusables/actions/actions-app-actions-permissions-api.md @@ -1 +1 @@ -{% data variables.product.prodname_github_app %}s must have the `actions` permission to use this API. \ No newline at end of file +{% data variables.product.prodname_github_app %}s must have the `actions` permission to use this API. diff --git a/translations/ru-RU/data/reusables/actions/actions-authentication.md b/translations/ru-RU/data/reusables/actions/actions-authentication.md index 266246660c6e..a047e0b5c463 100644 --- a/translations/ru-RU/data/reusables/actions/actions-authentication.md +++ b/translations/ru-RU/data/reusables/actions/actions-authentication.md @@ -1 +1 @@ -This API is available for authenticated users, {% data variables.product.prodname_oauth_app %}s, and {% data variables.product.prodname_github_app %}s. Access tokens require [`repo` scope](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes) for private repos and [`public_repo` scope](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes) for public repos. \ No newline at end of file +This API is available for authenticated users, {% data variables.product.prodname_oauth_app %}s, and {% data variables.product.prodname_github_app %}s. Access tokens require [`repo` scope](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes) for private repos and [`public_repo` scope](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes) for public repos. diff --git a/translations/ru-RU/data/reusables/actions/actions-not-verified.md b/translations/ru-RU/data/reusables/actions/actions-not-verified.md index b2a9577daa60..cb26fa9d61f6 100644 --- a/translations/ru-RU/data/reusables/actions/actions-not-verified.md +++ b/translations/ru-RU/data/reusables/actions/actions-not-verified.md @@ -1 +1 @@ -Anyone can publish an action in {% data variables.product.prodname_marketplace %} as long as they meet the terms of service. Unlike apps, {% data variables.product.prodname_actions %} listed in {% data variables.product.prodname_marketplace %} are not verified by {% data variables.product.prodname_dotcom %}. \ No newline at end of file +Anyone can publish an action in {% data variables.product.prodname_marketplace %} as long as they meet the terms of service. Unlike apps, {% data variables.product.prodname_actions %} listed in {% data variables.product.prodname_marketplace %} are not verified by {% data variables.product.prodname_dotcom %}. diff --git a/translations/ru-RU/data/reusables/actions/actions-use-policy-settings.md b/translations/ru-RU/data/reusables/actions/actions-use-policy-settings.md new file mode 100644 index 000000000000..b25cd5eb26be --- /dev/null +++ b/translations/ru-RU/data/reusables/actions/actions-use-policy-settings.md @@ -0,0 +1,3 @@ +If you choose the option to **Allow specific actions**, there are additional options that you can configure. For more information, see "[Allowing specific actions to run](#allowing-specific-actions-to-run)." + +When you allow local actions only, the policy blocks all access to actions authored by {% data variables.product.prodname_dotcom %}. For example, the [`actions/checkout`](https://github.com/actions/checkout) would not be accessible. \ No newline at end of file diff --git a/translations/ru-RU/data/reusables/actions/allow-specific-actions-intro.md b/translations/ru-RU/data/reusables/actions/allow-specific-actions-intro.md new file mode 100644 index 000000000000..248668d773ef --- /dev/null +++ b/translations/ru-RU/data/reusables/actions/allow-specific-actions-intro.md @@ -0,0 +1,19 @@ +When you select the **Allow select actions**, there are additional options that you need to choose to configure the allowed actions: + +- **Allow actions created by {% data variables.product.prodname_dotcom %}:** You can allow all actions created by {% data variables.product.prodname_dotcom %} to be used by workflows. Actions created by {% data variables.product.prodname_dotcom %} are located in the `actions` and `github` organization. For more information, see the [`actions`](https://github.com/actions) and [`github`](https://github.com/github) organizations. +- **Allow Marketplace actions by verified creators:** You can allow all {% data variables.product.prodname_marketplace %} actions created by verified creators to be used by workflows. When GitHub has verified the creator of the action as a partner organization, the {% octicon "verified" aria-label="The verified badge" %} badge is displayed next to the action in {% data variables.product.prodname_marketplace %}. +- **Allow specified actions:** You can restrict workflows to use actions in specific organizations and repositories. + + To restrict access to specific tags or commit SHAs of an action, use the same `/@` syntax used in the workflow to select the action. For example, `actions/javascript-action@v1.0.1` to select a tag or `actions/javascript-action@172239021f7ba04fe7327647b213799853a9eb89` to select a SHA. For more information, see "[Finding and customizing actions](/actions/learn-github-actions/finding-and-customizing-actions#using-release-management-for-your-custom-actions)." + + You can use the `*` wildcard character to match patterns. For example, to allow all actions in organizations that start with `space-org`, you can specify `space-org*/*`. To add all actions in repositories that start with octocat, you can use `*/octocat*@*`. For more information about using the `*` wildcard, see "[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#filter-pattern-cheat-sheet)." + + {% if currentVersion == "free-pro-team@latest" %} + {% note %} + + **Note:** The **Allow specified actions** option is only available in public repositories with the {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} for organizations, or {% data variables.product.prodname_team %} plan. + + {% endnote %} + {% endif %} + +This procedure demonstrates how to add specific actions to the allow list. diff --git a/translations/ru-RU/data/reusables/actions/enterprise-actions-permissions.md b/translations/ru-RU/data/reusables/actions/enterprise-actions-permissions.md index fb9bd1119ddf..72c38f66bcae 100644 --- a/translations/ru-RU/data/reusables/actions/enterprise-actions-permissions.md +++ b/translations/ru-RU/data/reusables/actions/enterprise-actions-permissions.md @@ -1 +1 @@ -1. Under "Policies", select an option. ![Enable, disable, or limits actions for this enterprise account](/assets/images/help/settings/actions-enable-enterprise-account.png) \ No newline at end of file +1. Under "Policies", select an option. ![Enable, disable, or limits actions for this enterprise account](/assets/images/help/organizations/enterprise-actions-policy.png) diff --git a/translations/ru-RU/data/reusables/actions/enterprise-beta.md b/translations/ru-RU/data/reusables/actions/enterprise-beta.md index 876f328cd5c0..30eac75a9196 100644 --- a/translations/ru-RU/data/reusables/actions/enterprise-beta.md +++ b/translations/ru-RU/data/reusables/actions/enterprise-beta.md @@ -4,4 +4,4 @@ **Note:** {% data variables.product.prodname_actions %} support on {% data variables.product.prodname_ghe_server %} 2.22 is a limited public beta. To review the external storage requirements and request access to the beta, see "[Enabling {% data variables.product.prodname_actions %} and configuring storage](/enterprise/admin/github-actions/enabling-github-actions-and-configuring-storage)." {% endnote %} -{% endif %} \ No newline at end of file +{% endif %} diff --git a/translations/ru-RU/data/reusables/actions/enterprise-github-hosted-runners.md b/translations/ru-RU/data/reusables/actions/enterprise-github-hosted-runners.md index 1ef3c4ce19a6..178bf09abe72 100644 --- a/translations/ru-RU/data/reusables/actions/enterprise-github-hosted-runners.md +++ b/translations/ru-RU/data/reusables/actions/enterprise-github-hosted-runners.md @@ -4,4 +4,4 @@ **Note:** {% data variables.product.prodname_dotcom %}-hosted runners are not currently supported on {% data variables.product.prodname_ghe_server %}. You can see more information about planned future support on the [{% data variables.product.prodname_roadmap %}](https://github.com/github/roadmap/issues/72). {% endnote %} -{% endif %} \ No newline at end of file +{% endif %} diff --git a/translations/ru-RU/data/reusables/actions/registry-credentials.md b/translations/ru-RU/data/reusables/actions/registry-credentials.md new file mode 100644 index 000000000000..829539de7800 --- /dev/null +++ b/translations/ru-RU/data/reusables/actions/registry-credentials.md @@ -0,0 +1 @@ +If the image's container registry requires authentication to pull the image, you can use `credentials` to set a `map` of the `username` and `password`. The credentials are the same values that you would provide to the [`docker login`](https://docs.docker.com/engine/reference/commandline/login/) command. diff --git a/translations/ru-RU/data/reusables/actions/scheduled-workflows-disabled.md b/translations/ru-RU/data/reusables/actions/scheduled-workflows-disabled.md new file mode 100644 index 000000000000..bdec7e515b23 --- /dev/null +++ b/translations/ru-RU/data/reusables/actions/scheduled-workflows-disabled.md @@ -0,0 +1 @@ +To prevent unnecessary workflow runs, scheduled workflows may be disabled automatically. When a public repository is forked, scheduled workflows are disabled by default. In a public repository, scheduled workflows are automatically disabled when no repository activity has occurred in 60 days. diff --git a/translations/ru-RU/data/reusables/apps/general-apps-restrictions.md b/translations/ru-RU/data/reusables/apps/general-apps-restrictions.md index 20e20ff5ecf4..3d59f0f6edb2 100644 --- a/translations/ru-RU/data/reusables/apps/general-apps-restrictions.md +++ b/translations/ru-RU/data/reusables/apps/general-apps-restrictions.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}If you are using your app with GitHub Actions and want to modify workflow files, you must authenticate on behalf of the user with an OAuth token that includes the `workflow` scope. The user must have admin or write permission to the repository that contains the workflow file. For more information, see "[Understanding scopes for OAuth apps](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)."{% endif %} \ No newline at end of file +{% if currentVersion == "free-pro-team@latest" %}If you are using your app with GitHub Actions and want to modify workflow files, you must authenticate on behalf of the user with an OAuth token that includes the `workflow` scope. The user must have admin or write permission to the repository that contains the workflow file. For more information, see "[Understanding scopes for OAuth apps](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)."{% endif %} diff --git a/translations/ru-RU/data/reusables/apps/maximum-github-apps-allowed.md b/translations/ru-RU/data/reusables/apps/maximum-github-apps-allowed.md index 93e063db4cb6..e1b7a44e3c28 100644 --- a/translations/ru-RU/data/reusables/apps/maximum-github-apps-allowed.md +++ b/translations/ru-RU/data/reusables/apps/maximum-github-apps-allowed.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}A user or organization can own up to 100 GitHub Apps.{% endif %} \ No newline at end of file +{% if currentVersion == "free-pro-team@latest" %}A user or organization can own up to 100 GitHub Apps.{% endif %} diff --git a/translations/ru-RU/data/reusables/apps/maximum-oauth-apps-allowed.md b/translations/ru-RU/data/reusables/apps/maximum-oauth-apps-allowed.md index b46e9b82c9dc..9e65b80fe2a6 100644 --- a/translations/ru-RU/data/reusables/apps/maximum-oauth-apps-allowed.md +++ b/translations/ru-RU/data/reusables/apps/maximum-oauth-apps-allowed.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}A user or organization can own up to 100 OAuth apps.{% endif %} \ No newline at end of file +{% if currentVersion == "free-pro-team@latest" %}A user or organization can own up to 100 OAuth apps.{% endif %} diff --git a/translations/ru-RU/data/reusables/apps/metadata-permissions.md b/translations/ru-RU/data/reusables/apps/metadata-permissions.md index 61bc044a800f..37608ebcb59c 100644 --- a/translations/ru-RU/data/reusables/apps/metadata-permissions.md +++ b/translations/ru-RU/data/reusables/apps/metadata-permissions.md @@ -1 +1 @@ -If you set the metadata permission to `No access` and select a permission that requires repository access, GitHub will override your selection and set the metadata permission back to `Read-only`. To set the metadata permission to `No access`, you must set all permissions that require repository access to `No access` first. \ No newline at end of file +If you set the metadata permission to `No access` and select a permission that requires repository access, GitHub will override your selection and set the metadata permission back to `Read-only`. To set the metadata permission to `No access`, you must set all permissions that require repository access to `No access` first. diff --git a/translations/ru-RU/data/reusables/apps/oauth-apps-restrictions.md b/translations/ru-RU/data/reusables/apps/oauth-apps-restrictions.md index 2ae56010bacc..fa81dbf36df1 100644 --- a/translations/ru-RU/data/reusables/apps/oauth-apps-restrictions.md +++ b/translations/ru-RU/data/reusables/apps/oauth-apps-restrictions.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}If you are using your OAuth App with GitHub Actions and want to modify workflow files, your OAuth token must have the `workflow` scope and the user must have owner or write permission to the repository that contains the workflow file. For more information, see "[Understanding scopes for OAuth apps](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)."{% endif %} \ No newline at end of file +{% if currentVersion == "free-pro-team@latest" %}If you are using your OAuth App with GitHub Actions and want to modify workflow files, your OAuth token must have the `workflow` scope and the user must have owner or write permission to the repository that contains the workflow file. For more information, see "[Understanding scopes for OAuth apps](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)."{% endif %} diff --git a/translations/ru-RU/data/reusables/apps/state_description.md b/translations/ru-RU/data/reusables/apps/state_description.md index fd754d2939f2..927d8b8a0071 100644 --- a/translations/ru-RU/data/reusables/apps/state_description.md +++ b/translations/ru-RU/data/reusables/apps/state_description.md @@ -1 +1 @@ -An unguessable random string. It is used to protect against cross-site request forgery attacks. \ No newline at end of file +An unguessable random string. It is used to protect against cross-site request forgery attacks. diff --git a/translations/ru-RU/data/reusables/audit_log/audit-log-search.md b/translations/ru-RU/data/reusables/audit_log/audit-log-search.md index 20d23dda9903..5f49319bcfab 100644 --- a/translations/ru-RU/data/reusables/audit_log/audit-log-search.md +++ b/translations/ru-RU/data/reusables/audit_log/audit-log-search.md @@ -8,7 +8,6 @@ The log lists the following information about each action: Note that you cannot search for entries using text. You can, however, construct search queries using a variety of filters. Many operators used when querying the log, such as `-`, `>`, or `<`, match the same format as searching across {% data variables.product.product_name %}. For more information, see "[Searching on {% data variables.product.prodname_dotcom %}](/github/searching-for-information-on-github/about-searching-on-github)." -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} #### Search based on operation Use the `operation` qualifier to limit actions to specific types of operations. Например: @@ -20,7 +19,6 @@ Use the `operation` qualifier to limit actions to specific types of operations. * `operation:remove` finds all events where an existing resource was removed. * `operation:restore` finds all events where an existing resource was restored. * `operation:transfer` finds all events where an existing resource was transferred. -{% endif %} #### Search based on repository diff --git a/translations/ru-RU/data/reusables/branches/change-default-branch.md b/translations/ru-RU/data/reusables/branches/change-default-branch.md new file mode 100644 index 000000000000..2a44e1845aa7 --- /dev/null +++ b/translations/ru-RU/data/reusables/branches/change-default-branch.md @@ -0,0 +1 @@ +You can change the default branch for an existing repository. For more information, see "[Changing the default branch](/github/administering-a-repository/changing-the-default-branch)." diff --git a/translations/ru-RU/data/reusables/branches/default-branch-automatically-base-branch.md b/translations/ru-RU/data/reusables/branches/default-branch-automatically-base-branch.md index 9350f601c269..b7e77330c423 100644 --- a/translations/ru-RU/data/reusables/branches/default-branch-automatically-base-branch.md +++ b/translations/ru-RU/data/reusables/branches/default-branch-automatically-base-branch.md @@ -1 +1,2 @@ -The default branch is the base branch in your repository, against which all pull requests and code commits are automatically made, unless you specify a different branch. \ No newline at end of file +Unless you specify a different branch, the default branch in a repository is the base branch for new pull requests and code commits. + diff --git a/translations/ru-RU/data/reusables/branches/new-repo-default-branch.md b/translations/ru-RU/data/reusables/branches/new-repo-default-branch.md index 99628077f836..d85e1174ba7f 100644 --- a/translations/ru-RU/data/reusables/branches/new-repo-default-branch.md +++ b/translations/ru-RU/data/reusables/branches/new-repo-default-branch.md @@ -1 +1,2 @@ -When you create a repository on {% data variables.product.prodname_dotcom %} with content, the repository is initialized with a single branch, called the default branch. \ No newline at end of file +When you create a repository with content on {% data variables.product.product_location %}, {% data variables.product.product_name %} creates the repository with a single branch. This first branch in the repository is the default branch. + diff --git a/translations/ru-RU/data/reusables/branches/set-default-branch.md b/translations/ru-RU/data/reusables/branches/set-default-branch.md index a36fcc41b762..f5ff905d85ca 100644 --- a/translations/ru-RU/data/reusables/branches/set-default-branch.md +++ b/translations/ru-RU/data/reusables/branches/set-default-branch.md @@ -1 +1 @@ -If you have admin permissions to a repository, you can change the default branch to another existing branch. For more information, see "[Setting the default branch](/github/administering-a-repository/setting-the-default-branch)." +You can set the name of the default branch for new repositories. For more information, see "[Managing the default branch for your repositories](/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories)," "[Managing the default branch name for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization)," or "[Enforcing a policy on the default branch name](/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account#enforcing-a-policy-on-the-default-branch-name)." diff --git a/translations/ru-RU/data/reusables/code-scanning/analyze-go.md b/translations/ru-RU/data/reusables/code-scanning/analyze-go.md new file mode 100644 index 000000000000..56f04cb3de4a --- /dev/null +++ b/translations/ru-RU/data/reusables/code-scanning/analyze-go.md @@ -0,0 +1 @@ +{% data variables.product.prodname_codeql %} also runs a build for Go projects to set up the project. However, in contrast to the other compiled languages, all Go files in the repository are extracted, not just those that are built. Custom build commands are not supported for Go. \ No newline at end of file diff --git a/translations/ru-RU/data/reusables/code-scanning/autobuild-add-build-steps.md b/translations/ru-RU/data/reusables/code-scanning/autobuild-add-build-steps.md index 61f06aaba9d0..40b9ba69836b 100644 --- a/translations/ru-RU/data/reusables/code-scanning/autobuild-add-build-steps.md +++ b/translations/ru-RU/data/reusables/code-scanning/autobuild-add-build-steps.md @@ -1 +1 @@ -If the C/C++, C#, or Java code in your repository has a non-standard build process or if it's written in more than one compiled language, `autobuild` may fail. You will need to remove the `autobuild` step from the workflow, and manually add build steps. +If the C/C++, C#, or Java code in your repository has a non-standard build process, `autobuild` may fail. You will need to remove the `autobuild` step from the workflow, and manually add build steps. diff --git a/translations/ru-RU/data/reusables/code-scanning/autobuild-compiled-languages.md b/translations/ru-RU/data/reusables/code-scanning/autobuild-compiled-languages.md index 16f72221d6c5..1e599d813b1b 100644 --- a/translations/ru-RU/data/reusables/code-scanning/autobuild-compiled-languages.md +++ b/translations/ru-RU/data/reusables/code-scanning/autobuild-compiled-languages.md @@ -1,5 +1 @@ -For the compiled languages C/C++, C#, and Java, the `autobuild` step in the default {% data variables.product.prodname_codeql %} Analysis workflow attempts to build your code. In contrast to the other compiled languages, {% data variables.product.prodname_codeql %} analyzes Go without building the code. - -The `autobuild` process only ever attempts to build _one_ compiled language for a repository. The language automatically selected for analysis is the language with most files. - - +For the supported compiled languages, you can use the `autobuild` action in the {% data variables.product.prodname_codeql_workflow %} to build your code. This avoids you having to specify explicit build commands for C/C++, C#, and Java. diff --git a/translations/ru-RU/data/reusables/code-scanning/beta-codeql-runner.md b/translations/ru-RU/data/reusables/code-scanning/beta-codeql-runner.md new file mode 100644 index 000000000000..f83682fcfaca --- /dev/null +++ b/translations/ru-RU/data/reusables/code-scanning/beta-codeql-runner.md @@ -0,0 +1,9 @@ +{% if currentVersion == "free-pro-team@latest" %} + +{% note %} + +**Note:** The {% data variables.product.prodname_codeql_runner %} is currently in beta and subject to change. + +{% endnote %} + +{% endif %} diff --git a/translations/ru-RU/data/reusables/code-scanning/beta.md b/translations/ru-RU/data/reusables/code-scanning/beta.md index 2c4184ce1d2e..3525bc8f4aa8 100644 --- a/translations/ru-RU/data/reusables/code-scanning/beta.md +++ b/translations/ru-RU/data/reusables/code-scanning/beta.md @@ -1,5 +1,9 @@ +{% if currentVersion == "enterprise-server@2.22" %} + {% note %} -**Note:** {% data variables.product.prodname_code_scanning_capc %} is currently in beta and subject to change. {% if currentVersion == "free-pro-team@latest" %}To request access to the beta, [join the waitlist](https://github.com/features/security/advanced-security/signup).{% else %}If your organization has an {% data variables.product.prodname_advanced_security %} license, you can [join the beta program](https://resources.github.com/beta-signup/).{% endif %} +**Note:** {% data variables.product.prodname_code_scanning_capc %} is currently in beta and subject to change. For more information about taking part in the beta, [sign up here](https://resources.github.com/beta-signup/). {% endnote %} + +{% endif %} diff --git a/translations/ru-RU/data/reusables/code-scanning/click-alert-in-list.md b/translations/ru-RU/data/reusables/code-scanning/click-alert-in-list.md index a000d0f07d4c..af80aac75dac 100644 --- a/translations/ru-RU/data/reusables/code-scanning/click-alert-in-list.md +++ b/translations/ru-RU/data/reusables/code-scanning/click-alert-in-list.md @@ -1 +1 @@ -1. Under "Code scanning", click the alert you'd like to view. ![List of alerts from {% data variables.product.prodname_code_scanning %}](/assets/images/help/repository/code-scanning-click-alert.png) +1. Under "Code scanning," click the alert you'd like to explore. ![List of alerts from {% data variables.product.prodname_code_scanning %}](/assets/images/help/repository/code-scanning-click-alert.png) diff --git a/translations/ru-RU/data/reusables/code-scanning/close-alert-examples.md b/translations/ru-RU/data/reusables/code-scanning/close-alert-examples.md new file mode 100644 index 000000000000..394120901f5f --- /dev/null +++ b/translations/ru-RU/data/reusables/code-scanning/close-alert-examples.md @@ -0,0 +1 @@ +For example, an error in code that's used only for testing, or when the effort of fixing the error is greater than the potential benefit of improving the code. diff --git a/translations/ru-RU/data/reusables/code-scanning/codeql-runner-license.md b/translations/ru-RU/data/reusables/code-scanning/codeql-runner-license.md index 17283fb710b2..96d197d8dc19 100644 --- a/translations/ru-RU/data/reusables/code-scanning/codeql-runner-license.md +++ b/translations/ru-RU/data/reusables/code-scanning/codeql-runner-license.md @@ -1,10 +1,12 @@ {% note %} {% if currentVersion == "free-pro-team@latest" %} -**Note:** The {% data variables.product.prodname_codeql_runner %} uses the {% data variables.product.prodname_codeql %} CLI to analyze code and therefore has the same license conditions. It's free to use on public repositories that are maintained on {% data variables.product.prodname_dotcom_the_website %}, and available to use on private repositories that are owned by customers with an {% data variables.product.prodname_advanced_security %} license. For information, see "[{% data variables.product.product_name %} {% data variables.product.prodname_codeql %} Terms and Conditions](https://securitylab.github.com/tools/codeql/license)" and "[{% data variables.product.prodname_codeql %} CLI](https://help.semmle.com/codeql/codeql-cli.html)." +**Note:** The +{% data variables.product.prodname_codeql_runner %} uses the {% data variables.product.prodname_codeql %} CLI to analyze code and therefore has the same license conditions. It's free to use on public repositories that are maintained on {% data variables.product.prodname_dotcom_the_website %}, and available to use on private repositories that are owned by customers with an {% data variables.product.prodname_advanced_security %} license. For information, see "[{% data variables.product.product_name %} {% data variables.product.prodname_codeql %} Terms and Conditions](https://securitylab.github.com/tools/codeql/license)" and "[{% data variables.product.prodname_codeql %} CLI](https://help.semmle.com/codeql/codeql-cli.html)." {% else %} -**Note:** The {% data variables.product.prodname_codeql_runner %} is available to customers with an {% data variables.product.prodname_advanced_security %} license. +**Note:** The +{% data variables.product.prodname_codeql_runner %} is available to customers with an {% data variables.product.prodname_advanced_security %} license. {% endif %} -{% endnote %} \ No newline at end of file +{% endnote %} diff --git a/translations/ru-RU/data/reusables/code-scanning/edit-workflow.md b/translations/ru-RU/data/reusables/code-scanning/edit-workflow.md index a98b4098ad9e..98bd06f5cb10 100644 --- a/translations/ru-RU/data/reusables/code-scanning/edit-workflow.md +++ b/translations/ru-RU/data/reusables/code-scanning/edit-workflow.md @@ -1 +1 @@ -Typically, you don't need to edit the default workflow for {% data variables.product.prodname_code_scanning %}. However, if required, you can edit the workflow to customize some of the settings. For example, you can edit {% data variables.product.prodname_dotcom %}'s {% data variables.product.prodname_codeql_workflow %} to specify the frequency of scans, the languages or directories to scan, and what {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} looks for in your code. You might also need to edit the {% data variables.product.prodname_codeql_workflow %} if you use a specific set of commands to compile your code or if there is more than one compiled language in your repository. +Typically, you don't need to edit the default workflow for {% data variables.product.prodname_code_scanning %}. However, if required, you can edit the workflow to customize some of the settings. For example, you can edit {% data variables.product.prodname_dotcom %}'s {% data variables.product.prodname_codeql_workflow %} to specify the frequency of scans, the languages or directories to scan, and what {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} looks for in your code. You might also need to edit the {% data variables.product.prodname_codeql_workflow %} if you use a specific set of commands to compile your code. diff --git a/translations/ru-RU/data/reusables/code-scanning/enabling-options.md b/translations/ru-RU/data/reusables/code-scanning/enabling-options.md index 6b1c8b1a10b9..3ef6731b266a 100644 --- a/translations/ru-RU/data/reusables/code-scanning/enabling-options.md +++ b/translations/ru-RU/data/reusables/code-scanning/enabling-options.md @@ -28,4 +28,4 @@ Using {% data variables.product.prodname_actions %} (see "Enabling {% data variables.product.prodname_code_scanning %} using actions") or generated externally and uploaded to {% data variables.product.product_name %} (see "Uploading a SARIF file to {% data variables.product.prodname_dotcom %}"). - \ No newline at end of file + diff --git a/translations/ru-RU/data/reusables/code-scanning/false-positive-fix-codeql.md b/translations/ru-RU/data/reusables/code-scanning/false-positive-fix-codeql.md new file mode 100644 index 000000000000..db3da9c9d538 --- /dev/null +++ b/translations/ru-RU/data/reusables/code-scanning/false-positive-fix-codeql.md @@ -0,0 +1 @@ +If you close a {% data variables.product.prodname_codeql %} alert as a false positive result, for example because the code uses a sanitization library that isn't supported, consider contributing to the {% data variables.product.prodname_codeql %} repository and improving the analysis. For more information about {% data variables.product.prodname_codeql %}, see "[Contributing to {% data variables.product.prodname_codeql %}](https://github.com/github/codeql/blob/main/CONTRIBUTING.md)." diff --git a/translations/ru-RU/data/reusables/code-scanning/interoperable-with-tools-that-output-sarif.md b/translations/ru-RU/data/reusables/code-scanning/interoperable-with-tools-that-output-sarif.md index 9be5fd94d166..36bed09e7273 100644 --- a/translations/ru-RU/data/reusables/code-scanning/interoperable-with-tools-that-output-sarif.md +++ b/translations/ru-RU/data/reusables/code-scanning/interoperable-with-tools-that-output-sarif.md @@ -1 +1 @@ -{% data variables.product.prodname_code_scanning_capc %} is interoperable with third-party code scanning tools that output Static Analysis Results Interchange Format (SARIF) data. SARIF is an open standard. For more information, see "[SARIF output for {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning)." \ No newline at end of file +{% data variables.product.prodname_code_scanning_capc %} is interoperable with third-party code scanning tools that output Static Analysis Results Interchange Format (SARIF) data. SARIF is an open standard. For more information, see "[SARIF output for {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning)." diff --git a/translations/ru-RU/data/reusables/code-scanning/specify-language-to-analyze.md b/translations/ru-RU/data/reusables/code-scanning/specify-language-to-analyze.md index 937acdf0ab1f..00904806ec99 100644 --- a/translations/ru-RU/data/reusables/code-scanning/specify-language-to-analyze.md +++ b/translations/ru-RU/data/reusables/code-scanning/specify-language-to-analyze.md @@ -1 +1 @@ -If your repository contains code in multiple languages, you can specify the languages you want to analyze. There are several reasons you might want to prevent a language being analyzed. For example, the project might have dependencies in a different language to the main body of your code, and you might prefer not to see alerts for those dependencies. +If your repository contains code in more than one of the supported languages, you can choose which languages you want to analyze. There are several reasons you might want to prevent a language being analyzed. For example, the project might have dependencies in a different language to the main body of your code, and you might prefer not to see alerts for those dependencies. diff --git a/translations/ru-RU/data/reusables/codespaces/about-billing-for-codespaces.md b/translations/ru-RU/data/reusables/codespaces/about-billing-for-codespaces.md new file mode 100644 index 000000000000..8a1128db5e3c --- /dev/null +++ b/translations/ru-RU/data/reusables/codespaces/about-billing-for-codespaces.md @@ -0,0 +1 @@ +{% data variables.product.prodname_codespaces %} is free to use during the beta. When {% data variables.product.prodname_codespaces %} becomes generally available, you will be billed for storage and compute usage. diff --git a/translations/ru-RU/data/reusables/codespaces/click-remote-explorer-icon-vscode.md b/translations/ru-RU/data/reusables/codespaces/click-remote-explorer-icon-vscode.md index 5e0618af02bf..c49f29679dea 100644 --- a/translations/ru-RU/data/reusables/codespaces/click-remote-explorer-icon-vscode.md +++ b/translations/ru-RU/data/reusables/codespaces/click-remote-explorer-icon-vscode.md @@ -1 +1 @@ -1. In {% data variables.product.prodname_vscode %}, in the left sidebar, click the Remote Explorer icon. ![The Remote Explorer icon in {% data variables.product.prodname_vscode %}](/assets/images/help/codespaces/click-remote-explorer-icon-vscode.png) \ No newline at end of file +1. In {% data variables.product.prodname_vscode %}, in the left sidebar, click the Remote Explorer icon. ![The Remote Explorer icon in {% data variables.product.prodname_vscode %}](/assets/images/help/codespaces/click-remote-explorer-icon-vscode.png) diff --git a/translations/ru-RU/data/reusables/codespaces/codespaces-are-per-branch.md b/translations/ru-RU/data/reusables/codespaces/codespaces-are-per-branch.md index 42d612bb9f3c..146beb47e828 100644 --- a/translations/ru-RU/data/reusables/codespaces/codespaces-are-per-branch.md +++ b/translations/ru-RU/data/reusables/codespaces/codespaces-are-per-branch.md @@ -1 +1 @@ -Each codespace is associated with a specific branch of a repository. \ No newline at end of file +Each codespace is associated with a specific branch of a repository. diff --git a/translations/ru-RU/data/reusables/codespaces/codespaces-are-personal.md b/translations/ru-RU/data/reusables/codespaces/codespaces-are-personal.md index db5fc57640aa..771fe3f97cc4 100644 --- a/translations/ru-RU/data/reusables/codespaces/codespaces-are-personal.md +++ b/translations/ru-RU/data/reusables/codespaces/codespaces-are-personal.md @@ -1 +1 @@ -Each codespace you create is only available to you. No one else can work in your codespace. \ No newline at end of file +Each codespace you create is only available to you. No one else can work in your codespace. diff --git a/translations/ru-RU/data/reusables/codespaces/connect-to-codespace-from-vscode.md b/translations/ru-RU/data/reusables/codespaces/connect-to-codespace-from-vscode.md index fc259120f3f9..045387a57b31 100644 --- a/translations/ru-RU/data/reusables/codespaces/connect-to-codespace-from-vscode.md +++ b/translations/ru-RU/data/reusables/codespaces/connect-to-codespace-from-vscode.md @@ -1 +1 @@ -You can connect to your codespace directly from {% data variables.product.prodname_vscode %}. For more information, see "[Connecting to your codespace from {% data variables.product.prodname_vscode %}](/github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code)." \ No newline at end of file +You can connect to your codespace directly from {% data variables.product.prodname_vscode %}. For more information, see "[Using Codespaces in {% data variables.product.prodname_vscode %}](/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code)." diff --git a/translations/ru-RU/data/reusables/codespaces/devcontainer-location.md b/translations/ru-RU/data/reusables/codespaces/devcontainer-location.md new file mode 100644 index 000000000000..196fc006be1a --- /dev/null +++ b/translations/ru-RU/data/reusables/codespaces/devcontainer-location.md @@ -0,0 +1 @@ +This file can be located in the root of the repository or in a folder called `.devcontainer`. If the file is located in the root of the repository, the filename must begin with a period: `.devcontainer.json`. diff --git a/translations/ru-RU/data/reusables/codespaces/navigate-to-codespaces.md b/translations/ru-RU/data/reusables/codespaces/navigate-to-codespaces.md index dd31eca7e4f8..4ba7c260e0e5 100644 --- a/translations/ru-RU/data/reusables/codespaces/navigate-to-codespaces.md +++ b/translations/ru-RU/data/reusables/codespaces/navigate-to-codespaces.md @@ -1 +1 @@ -1. At the top of any page, click **Codespaces**. ![{% data variables.product.prodname_codespaces %} link in header](/assets/images/help/codespaces/header-link.png) \ No newline at end of file +1. At the top of any page, click **Codespaces**. ![{% data variables.product.prodname_codespaces %} link in header](/assets/images/help/codespaces/header-link.png) diff --git a/translations/ru-RU/data/reusables/codespaces/release-stage.md b/translations/ru-RU/data/reusables/codespaces/release-stage.md index 15d789d79106..2fd3475ccdb2 100644 --- a/translations/ru-RU/data/reusables/codespaces/release-stage.md +++ b/translations/ru-RU/data/reusables/codespaces/release-stage.md @@ -2,4 +2,4 @@ **Note:** {% data variables.product.prodname_codespaces %} is currently in limited public beta and subject to change. During the beta period, {% data variables.product.prodname_dotcom %} does not make any guarantees about the availability of {% data variables.product.prodname_codespaces %}. For more information about joining the beta, see "[About {% data variables.product.prodname_codespaces %}](/github/developing-online-with-codespaces/about-codespaces#joining-the-beta)." -{% endnote %} \ No newline at end of file +{% endnote %} diff --git a/translations/ru-RU/data/reusables/codespaces/unsupported-repos.md b/translations/ru-RU/data/reusables/codespaces/unsupported-repos.md index bd7311a43e46..03fd9189d945 100644 --- a/translations/ru-RU/data/reusables/codespaces/unsupported-repos.md +++ b/translations/ru-RU/data/reusables/codespaces/unsupported-repos.md @@ -1 +1 @@ -During the beta, private repositories owned by organizations or any repositories owned by an organization that requires SAML single sign-on are not supported. \ No newline at end of file +During the beta, private repositories owned by organizations or any repositories owned by an organization that requires SAML single sign-on are not supported. diff --git a/translations/ru-RU/data/reusables/codespaces/use-visual-studio-features.md b/translations/ru-RU/data/reusables/codespaces/use-visual-studio-features.md index 131cd4021aa4..a5b1cf915191 100644 --- a/translations/ru-RU/data/reusables/codespaces/use-visual-studio-features.md +++ b/translations/ru-RU/data/reusables/codespaces/use-visual-studio-features.md @@ -1 +1 @@ -After you open a codespace, you can develop using {% data variables.product.prodname_vscode %}'s features, such as text editing, debugging, and Git commands. For more information, see the [{% data variables.product.prodname_vscode %} documentation](https://code.visualstudio.com/docs). +You can edit code, debug, and use Git commands while developing in a codespace with {% data variables.product.prodname_vscode %}. For more information, see the [{% data variables.product.prodname_vscode %} documentation](https://code.visualstudio.com/docs). diff --git a/translations/ru-RU/data/reusables/codespaces/you-can-see-all-your-codespaces.md b/translations/ru-RU/data/reusables/codespaces/you-can-see-all-your-codespaces.md index daeb0e9ab417..59c85e47d77d 100644 --- a/translations/ru-RU/data/reusables/codespaces/you-can-see-all-your-codespaces.md +++ b/translations/ru-RU/data/reusables/codespaces/you-can-see-all-your-codespaces.md @@ -1 +1 @@ -You can see every codespace owned by your user account at [github.com/codespaces](https://github.com/codespaces). \ No newline at end of file +You can see every codespace owned by your user account at [github.com/codespaces](https://github.com/codespaces). diff --git a/translations/ru-RU/data/reusables/command_line/git-clone-url.md b/translations/ru-RU/data/reusables/command_line/git-clone-url.md index 7acf7db839d0..0ed7dd68150d 100644 --- a/translations/ru-RU/data/reusables/command_line/git-clone-url.md +++ b/translations/ru-RU/data/reusables/command_line/git-clone-url.md @@ -1,4 +1,4 @@ 5. Type `git clone`, and then paste the URL you copied earlier. ```shell $ git clone https://{% data variables.command_line.codeblock %}/YOUR-USERNAME/YOUR-REPOSITORY - ``` \ No newline at end of file + ``` diff --git a/translations/ru-RU/data/reusables/dependabot/check-in-dependabot-yml.md b/translations/ru-RU/data/reusables/dependabot/check-in-dependabot-yml.md index 2502f32e583b..629a74058605 100644 --- a/translations/ru-RU/data/reusables/dependabot/check-in-dependabot-yml.md +++ b/translations/ru-RU/data/reusables/dependabot/check-in-dependabot-yml.md @@ -1 +1 @@ -1. Check the *dependabot.yml* configuration file in to the `.github` directory of the repository. \ No newline at end of file +1. Check the *dependabot.yml* configuration file in to the `.github` directory of the repository. diff --git a/translations/ru-RU/data/reusables/dependabot/create-dependabot-yml.md b/translations/ru-RU/data/reusables/dependabot/create-dependabot-yml.md index 910f3a210739..d8151637a32d 100644 --- a/translations/ru-RU/data/reusables/dependabot/create-dependabot-yml.md +++ b/translations/ru-RU/data/reusables/dependabot/create-dependabot-yml.md @@ -1 +1 @@ -1. Create a *dependabot.yml* configuration file. \ No newline at end of file +1. Create a *dependabot.yml* configuration file. diff --git a/translations/ru-RU/data/reusables/dependabot/default-dependencies-allow-ignore.md b/translations/ru-RU/data/reusables/dependabot/default-dependencies-allow-ignore.md index 0a1a6fde04f0..a229a6340d14 100644 --- a/translations/ru-RU/data/reusables/dependabot/default-dependencies-allow-ignore.md +++ b/translations/ru-RU/data/reusables/dependabot/default-dependencies-allow-ignore.md @@ -1 +1 @@ -By default all dependencies that are explicitly defined in a manifest or lock file are kept up to date. You can use `allow` and `ignore` to customize which dependencies to maintain with version updates. {% data variables.product.prodname_dependabot %} checks for all allowed dependencies and then filters out any ignored dependencies or versions. So a dependency that is matched by both an `allow` and an `ignore` will be ignored. \ No newline at end of file +By default all dependencies that are explicitly defined in a manifest or lock file are kept up to date. You can use `allow` and `ignore` to customize which dependencies to maintain with version updates. {% data variables.product.prodname_dependabot %} checks for all allowed dependencies and then filters out any ignored dependencies or versions. So a dependency that is matched by both an `allow` and an `ignore` will be ignored. diff --git a/translations/ru-RU/data/reusables/dependabot/dependabot-tos.md b/translations/ru-RU/data/reusables/dependabot/dependabot-tos.md index d52b0b03405b..a72c36c5a119 100644 --- a/translations/ru-RU/data/reusables/dependabot/dependabot-tos.md +++ b/translations/ru-RU/data/reusables/dependabot/dependabot-tos.md @@ -1 +1 @@ -{% data variables.product.prodname_dependabot %} and all related features are covered by [{% data variables.product.prodname_dotcom %}'s Terms of Service](/github/site-policy/github-terms-of-service). \ No newline at end of file +{% data variables.product.prodname_dependabot %} and all related features are covered by [{% data variables.product.prodname_dotcom %}'s Terms of Service](/github/site-policy/github-terms-of-service). diff --git a/translations/ru-RU/data/reusables/dependabot/option-affects-security-updates.md b/translations/ru-RU/data/reusables/dependabot/option-affects-security-updates.md index bb25d1b1fc5a..acf2a7655842 100644 --- a/translations/ru-RU/data/reusables/dependabot/option-affects-security-updates.md +++ b/translations/ru-RU/data/reusables/dependabot/option-affects-security-updates.md @@ -1 +1 @@ -Setting this option will also affect pull requests for security updates to the manifest files of this package manager, unless you use `target-branch` to check for version updates on a non-default branch. \ No newline at end of file +Setting this option will also affect pull requests for security updates to the manifest files of this package manager, unless you use `target-branch` to check for version updates on a non-default branch. diff --git a/translations/ru-RU/data/reusables/dependabot/private-dependencies.md b/translations/ru-RU/data/reusables/dependabot/private-dependencies.md index 1ba08ff8f048..dfcbae9c7300 100644 --- a/translations/ru-RU/data/reusables/dependabot/private-dependencies.md +++ b/translations/ru-RU/data/reusables/dependabot/private-dependencies.md @@ -1 +1 @@ -Currently, {% data variables.product.prodname_dependabot_version_updates %} doesn't support manifest or lock files that contain any private git dependencies or private git registries. This is because, when running version updates, {% data variables.product.prodname_dependabot_short %} must be able to resolve all dependencies from their source to verify that version updates have been successful. \ No newline at end of file +Currently, {% data variables.product.prodname_dependabot_version_updates %} doesn't support manifest or lock files that contain any private git dependencies or private git registries. This is because, when running version updates, {% data variables.product.prodname_dependabot_short %} must be able to resolve all dependencies from their source to verify that version updates have been successful. diff --git a/translations/ru-RU/data/reusables/dependabot/supported-package-managers.md b/translations/ru-RU/data/reusables/dependabot/supported-package-managers.md index f9cb69f91be6..22b7b8679281 100644 --- a/translations/ru-RU/data/reusables/dependabot/supported-package-managers.md +++ b/translations/ru-RU/data/reusables/dependabot/supported-package-managers.md @@ -1,15 +1,29 @@ -- Bundler: `bundler` -- Cargo: `cargo` -- Composer: `composer` -- Docker: `docker` -- Elm: `elm` -- git submodule: `gitsubmodule` -- GitHub Actions: `github-actions` -- Go modules: `gomod` -- Gradle: `gradle` -- Maven: `maven` -- Mix: `mix` -- npm: `npm` -- NuGet: `nuget` -- pip: `pip` -- Terraform: `terraform` +| Package manager | Supports vendoring | +| -------------------------------- |:------------------:| +| Bundler: `bundler` | **X** | +| Cargo: `cargo` | | +| Composer: `composer` | | +| Docker: `docker` | | +| Elm: `elm` | | +| git submodule: `gitsubmodule` | | +| GitHub Actions: `github-actions` | | +| Go modules: `gomod` | | +| Gradle: `gradle` | | +| Maven: `maven` | | +| Mix: `mix` | | +| npm: `npm` | | +| NuGet: `nuget` | | +| pip: `pip` | | +| Terraform: `terraform` | | + +{% note %} + +**Note**: {% data variables.product.prodname_dependabot_short %} also supports the following package managers: + +-`yarn` (v1 only) (specify `npm`) + +-`pipenv`, `pip-compile`, and `poetry` (specify `pip`) + +For example, if you use `poetry` to manage your Python dependencies and want {% data variables.product.prodname_dependabot_short %} to monitor your dependency manifest file for new versions, use `package-ecosystem: "pip"` in your *dependabot.yml* file. + +{% endnote %} diff --git a/translations/ru-RU/data/reusables/desktop/choose-a-theme.md b/translations/ru-RU/data/reusables/desktop/choose-a-theme.md index ce406d8548cb..70922847dc74 100644 --- a/translations/ru-RU/data/reusables/desktop/choose-a-theme.md +++ b/translations/ru-RU/data/reusables/desktop/choose-a-theme.md @@ -1,2 +1,2 @@ 3. Click **Appearance**. -4. Click the theme you'd like to use. Optionally, you can select **Automatically switch theme to match system** if you'd like {% data variables.product.prodname_desktop %} to always match the theme on your computer. \ No newline at end of file +4. Click the theme you'd like to use. Optionally, you can select **Automatically switch theme to match system** if you'd like {% data variables.product.prodname_desktop %} to always match the theme on your computer. diff --git a/translations/ru-RU/data/reusables/desktop/confirm-tag.md b/translations/ru-RU/data/reusables/desktop/confirm-tag.md index 50a81fdef16a..168a8b9263f3 100644 --- a/translations/ru-RU/data/reusables/desktop/confirm-tag.md +++ b/translations/ru-RU/data/reusables/desktop/confirm-tag.md @@ -1 +1 @@ -1. Click **Create Tag**. \ No newline at end of file +1. Click **Create Tag**. diff --git a/translations/ru-RU/data/reusables/desktop/create-tag.md b/translations/ru-RU/data/reusables/desktop/create-tag.md index 7fd366b8cb87..27f2b48fcb6a 100644 --- a/translations/ru-RU/data/reusables/desktop/create-tag.md +++ b/translations/ru-RU/data/reusables/desktop/create-tag.md @@ -1 +1 @@ -1. Right-click the commit and click **Create Tag...**. ![Select the create tag menu item](/assets/images/help/desktop/select-create-tag.png) \ No newline at end of file +1. Right-click the commit and click **Create Tag...**. ![Select the create tag menu item](/assets/images/help/desktop/select-create-tag.png) diff --git a/translations/ru-RU/data/reusables/desktop/revert-commit.md b/translations/ru-RU/data/reusables/desktop/revert-commit.md index 96cde101f365..ffd427559f42 100644 --- a/translations/ru-RU/data/reusables/desktop/revert-commit.md +++ b/translations/ru-RU/data/reusables/desktop/revert-commit.md @@ -1 +1 @@ -1. Right-click the commit you want to revert and click **Revert This Commit**. \ No newline at end of file +1. Right-click the commit you want to revert and click **Revert This Commit**. diff --git a/translations/ru-RU/data/reusables/desktop/select-base-branch.md b/translations/ru-RU/data/reusables/desktop/select-base-branch.md index 81cd8449bc96..de87a5d1d567 100644 --- a/translations/ru-RU/data/reusables/desktop/select-base-branch.md +++ b/translations/ru-RU/data/reusables/desktop/select-base-branch.md @@ -1 +1 @@ -1. Select either the current branch, or the default branch (usually master) to base the new branch on. +1. Use the drop-down to choose a base branch for your new branch. diff --git a/translations/ru-RU/data/reusables/dotcom_billing/add-seats.md b/translations/ru-RU/data/reusables/dotcom_billing/add-seats.md index b02298302e66..12c208025b28 100644 --- a/translations/ru-RU/data/reusables/dotcom_billing/add-seats.md +++ b/translations/ru-RU/data/reusables/dotcom_billing/add-seats.md @@ -1 +1 @@ -1. Use the **Edit** drop-down and click **Add seats**. ![Edit drop-down menu](/assets/images/help/billing/add-seats-dropdown.png) \ No newline at end of file +1. Use the **Edit** drop-down and click **Add seats**. ![Edit drop-down menu](/assets/images/help/billing/add-seats-dropdown.png) diff --git a/translations/ru-RU/data/reusables/dotcom_billing/confirm-add-seats.md b/translations/ru-RU/data/reusables/dotcom_billing/confirm-add-seats.md index bdf00645dd83..1fa76e93c439 100644 --- a/translations/ru-RU/data/reusables/dotcom_billing/confirm-add-seats.md +++ b/translations/ru-RU/data/reusables/dotcom_billing/confirm-add-seats.md @@ -1 +1 @@ -1. Click **Add seats**. ![Add seats button](/assets/images/help/billing/add-seats-button.png) \ No newline at end of file +1. Click **Add seats**. ![Add seats button](/assets/images/help/billing/add-seats-button.png) diff --git a/translations/ru-RU/data/reusables/dotcom_billing/number-of-seats.md b/translations/ru-RU/data/reusables/dotcom_billing/number-of-seats.md index e3351710e01f..9324e4073026 100644 --- a/translations/ru-RU/data/reusables/dotcom_billing/number-of-seats.md +++ b/translations/ru-RU/data/reusables/dotcom_billing/number-of-seats.md @@ -1 +1 @@ -1. Under "Add seats", type the number of seats you'd like to add. ![Add seats input](/assets/images/help/billing/add-seats-amount.png) \ No newline at end of file +1. Under "Add seats", type the number of seats you'd like to add. ![Add seats input](/assets/images/help/billing/add-seats-amount.png) diff --git a/translations/ru-RU/data/reusables/dotcom_billing/upgrade_org.md b/translations/ru-RU/data/reusables/dotcom_billing/upgrade_org.md index 8872c11814ab..60ea8fef5cbe 100644 --- a/translations/ru-RU/data/reusables/dotcom_billing/upgrade_org.md +++ b/translations/ru-RU/data/reusables/dotcom_billing/upgrade_org.md @@ -1 +1 @@ -1. If you're upgrading from {% data variables.product.prodname_free_team %}, click **Upgrade options**. If you're upgrading from {% data variables.product.prodname_team %}, use the **Edit** drop-down and click **Upgrade**. ![Upgrade options button](/assets/images/help/billing/choose-monthly-or-yearly-billing.png) \ No newline at end of file +1. If you're upgrading from {% data variables.product.prodname_free_team %}, click **Upgrade options**. If you're upgrading from {% data variables.product.prodname_team %}, use the **Edit** drop-down and click **Upgrade**. ![Upgrade options button](/assets/images/help/billing/choose-monthly-or-yearly-billing.png) diff --git a/translations/ru-RU/data/reusables/enterprise-accounts/access-enterprise.md b/translations/ru-RU/data/reusables/enterprise-accounts/access-enterprise.md index 561c0bd9e8f1..2a7bee222c99 100644 --- a/translations/ru-RU/data/reusables/enterprise-accounts/access-enterprise.md +++ b/translations/ru-RU/data/reusables/enterprise-accounts/access-enterprise.md @@ -1 +1,3 @@ -1. Navigate to your enterprise account by visiting `https://github.com/enterprises/ENTERPRISE-NAME`, replacing `ENTERPRISE-NAME` with your enterprise account's name. +1. In the top-right corner of {% data variables.product.product_name %}, click your profile photo, then click **Your enterprises**. !["Your enterprises" in drop-down menu for profile photo on GitHub](/assets/images/help/enterprises/your-enterprises.png) + +1. In the list of enterprises, click the enterprise you want to view. ![Name of an enterprise in list of your enterprises](/assets/images/help/enterprises/your-enterprises-list.png) diff --git a/translations/ru-RU/data/reusables/enterprise/rate_limit.md b/translations/ru-RU/data/reusables/enterprise/rate_limit.md index dd52413e463c..ddf01e8d889f 100644 --- a/translations/ru-RU/data/reusables/enterprise/rate_limit.md +++ b/translations/ru-RU/data/reusables/enterprise/rate_limit.md @@ -1,3 +1,4 @@ {% if currentVersion != "free-pro-team@latest" %} -Note that the limits mentioned above are the default rate limits for a {% data variables.product.prodname_ghe_server %} instance. Contact your site administrator to confirm if rate limits are enabled and how they are configured. +Note that the limits mentioned above are the default rate limits for a +{% data variables.product.prodname_ghe_server %} instance. Contact your site administrator to confirm if rate limits are enabled and how they are configured. {% endif %} diff --git a/translations/ru-RU/data/reusables/enterprise_clustering/configuration-file-heading.md b/translations/ru-RU/data/reusables/enterprise_clustering/configuration-file-heading.md index 06b1491d9115..9617fb94121d 100644 --- a/translations/ru-RU/data/reusables/enterprise_clustering/configuration-file-heading.md +++ b/translations/ru-RU/data/reusables/enterprise_clustering/configuration-file-heading.md @@ -1 +1 @@ -The cluster configuration file lists each node under a [cluster "HOSTNAME"] heading. \ No newline at end of file +The cluster configuration file lists each node under a [cluster "HOSTNAME"] heading. diff --git a/translations/ru-RU/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md b/translations/ru-RU/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md index 552d96a3b4ab..906c2b24edfe 100644 --- a/translations/ru-RU/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md +++ b/translations/ru-RU/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md @@ -1,6 +1,6 @@ -1. If you're replacing the MySQL master node or Redis master node, in `cluster.conf`, modify the `mysql-master` or `redis-master` value with the replacement node name. +1. If you're replacing the primary MySQL or Redis node, in `cluster.conf`, modify the `mysql-master` or `redis-master` value with the replacement node name. - For example, this modified `cluster.conf` file specifies a newly provisioned cluster node, `ghe-replacement-data-node-1` as the MySQL and Redis master node: 
    +  For example, this modified `cluster.conf` file specifies a newly provisioned cluster node, `ghe-replacement-data-node-1` as the primary MySQL and Redis node: 
       mysql-master = ghe-replacement-data-node-1
   redis-master = ghe-replacement-data-node-1
   
    
diff --git a/translations/ru-RU/data/reusables/enterprise_enterprise_support/submit-support-ticket-first-section.md b/translations/ru-RU/data/reusables/enterprise_enterprise_support/submit-support-ticket-first-section.md
index c28d78103404..42247032b40f 100644
--- a/translations/ru-RU/data/reusables/enterprise_enterprise_support/submit-support-ticket-first-section.md
+++ b/translations/ru-RU/data/reusables/enterprise_enterprise_support/submit-support-ticket-first-section.md
@@ -10,7 +10,9 @@
     - Choose **{% data variables.product.support_ticket_priority_high %}** to report issues impacting business operations, including {% if currentVersion == "free-pro-team@latest" %}removing sensitive data (commits, issues, pull requests, uploaded attachments) from your own accounts and organization restorations{% else %}system performance issues{% endif %}, or to report critical bugs.
     - Choose **{% data variables.product.support_ticket_priority_normal %}** to {% if currentVersion == "free-pro-team@latest" %}request account recovery or spam unflagging, report user login issues{% else %}make technical requests like configuration changes and third-party integrations{% endif %}, and to report non-critical bugs.
     - Choose **{% data variables.product.support_ticket_priority_low %}** to ask general questions and submit requests for new features, purchases, training, or health checks.{% if currentVersion != "free-pro-team@latest" %}
-1. From the "{% data variables.product.prodname_enterprise %} Series" drop-down menu, select the version of {% data variables.product.prodname_ghe_server %} you're using. ![{% data variables.product.prodname_enterprise %} Series drop-down menu](/assets/images/enterprise/support/support-ticket-ghes-series.png)
+1. From the "
+{% data variables.product.prodname_enterprise %} Series" drop-down menu, select the version of {% data variables.product.prodname_ghe_server %} you're using.
+  ![{% data variables.product.prodname_enterprise %} Series drop-down menu](/assets/images/enterprise/support/support-ticket-ghes-series.png)
 {% endif %}
 1. From the "Global Region" drop-down menu, select APAC (Asia Pacific), EMEA (Europe, the Middle East, and Africa), or Americas as your region. ![Global Region drop-down menu](/assets/images/enterprise/support/support-ticket-global-region.png)
 1. Click **Add file**, then attach the diagnostics file you downloaded to include diagnostics with your support ticket. ![Add file button](/assets/images/enterprise/support/support-ticket-add-file.png)
diff --git a/translations/ru-RU/data/reusables/enterprise_enterprise_support/submit-support-ticket-second-section.md b/translations/ru-RU/data/reusables/enterprise_enterprise_support/submit-support-ticket-second-section.md
index cd04bf7ee758..67f68c6f7e05 100644
--- a/translations/ru-RU/data/reusables/enterprise_enterprise_support/submit-support-ticket-second-section.md
+++ b/translations/ru-RU/data/reusables/enterprise_enterprise_support/submit-support-ticket-second-section.md
@@ -1,4 +1,5 @@
 1. Click **Submit**.
 
 {% if currentVersion != "free-pro-team@latest" %}
-If you chose not to include diagnostics with your support ticket, you can share diagnostic information with {% data variables.product.prodname_enterprise %} Support after submitting your support request. For more information, see "[Providing data to {% data variables.product.prodname_dotcom %} Support](/enterprise/admin/guides/enterprise-support/providing-data-to-github-support)."{% endif %}
+If you chose not to include diagnostics with your support ticket, you can share diagnostic information with
+{% data variables.product.prodname_enterprise %} Support after submitting your support request. For more information, see "[Providing data to {% data variables.product.prodname_dotcom %} Support](/enterprise/admin/guides/enterprise-support/providing-data-to-github-support)."{% endif %}
diff --git a/translations/ru-RU/data/reusables/enterprise_installation/aws-supported-instance-types.md b/translations/ru-RU/data/reusables/enterprise_installation/aws-supported-instance-types.md
index dde815abf396..7b4af4b392a5 100644
--- a/translations/ru-RU/data/reusables/enterprise_installation/aws-supported-instance-types.md
+++ b/translations/ru-RU/data/reusables/enterprise_installation/aws-supported-instance-types.md
@@ -28,11 +28,10 @@
 | ----------------- | -------------------------------------------------------------------- |
 | R4                | r4.large, r4.xlarge, r4.2xlarge, r4.4xlarge, r4.8xlarge, r4.16xlarge |
 
-| EC2 instance type | Model                                                                                                                                                                                                                                                                                                      |
-| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| EC2 instance type | Model                                                                                                                                                                                                                                                                                                                                          |
+| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | R5                | r5.large, r5.xlarge, r5.2xlarge, r5.4xlarge, r5.12xlarge, r5.24xlarge{% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.19" %}, r5n.large, r5n.xlarge, r5n.2xlarge, r5n.4xlarge, r5n.12xlarge, r5n.24xlarge, r5a.large, r5a.xlarge, r5a.2xlarge, r5a.4xlarge, r5a.12xlarge, r5a.24xlarge{% endif %}
 
-
 | EC2 instance type | Model                    |
 | ----------------- | ------------------------ |
 | X1                | x1.16xlarge, x1.32xlarge |
diff --git a/translations/ru-RU/data/reusables/enterprise_installation/hardware-rec-table.md b/translations/ru-RU/data/reusables/enterprise_installation/hardware-rec-table.md
index 5d8369bc7b59..4de4ad712004 100644
--- a/translations/ru-RU/data/reusables/enterprise_installation/hardware-rec-table.md
+++ b/translations/ru-RU/data/reusables/enterprise_installation/hardware-rec-table.md
@@ -1,13 +1,13 @@
 {% if currentVersion == "enterprise-server@2.22" %}
 
 Minimum requirements for an instance with beta features enabled are **bold** in the following table. For more information, see "[Beta features in {% data variables.product.prodname_ghe_server %} 2.22](#beta-features-in-github-enterprise-server-222)." |{% endif %}
-| User licenses                  |                                                                                                              vCPUs |                                                                                                                     Memory |                                                                                                           Attached storage | Root storage |
-|:------------------------------ | ------------------------------------------------------------------------------------------------------------------:| --------------------------------------------------------------------------------------------------------------------------:| --------------------------------------------------------------------------------------------------------------------------:| ------------:|
+| User licenses                  |                                                                                                                                  vCPUs |                                                                                                                                         Memory |                                                                                                                               Attached storage | Root storage |
+|:------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------:| ------------:|
 | Trial, demo, or 10 light users |   2{% if currentVersion == "enterprise-server@2.22" %}
    or [**4**](#beta-features-in-github-enterprise-server-222){% endif %} |   16 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**32 GB**](#beta-features-in-github-enterprise-server-222){% endif %} | 100 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**150 GB**](#beta-features-in-github-enterprise-server-222){% endif %} |       200 GB |
 | 10 to 3,000                    |   4{% if currentVersion == "enterprise-server@2.22" %}
    or [**8**](#beta-features-in-github-enterprise-server-222){% endif %} |   32 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**48 GB**](#beta-features-in-github-enterprise-server-222){% endif %} | 250 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**300 GB**](#beta-features-in-github-enterprise-server-222){% endif %} |       200 GB |
-| 3,000 to 5000                  |  8{% if currentVersion == "enterprise-server@2.22" %}
    or [**12**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                      64 GB |                                                                                                                     500 GB |       200 GB |
-| 5,000 to 8000                  | 12{% if currentVersion == "enterprise-server@2.22" %}
    or [**16**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                      96 GB |                                                                                                                     750 GB |       200 GB |
-| 8,000 to 10,000+               | 16{% if currentVersion == "enterprise-server@2.22" %}
    or [**20**](#beta-features-in-github-enterprise-server-222){% endif %} | 128 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**160 GB**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                    1000 GB |       200 GB |
+| 3,000 to 5000                  |  8{% if currentVersion == "enterprise-server@2.22" %}
    or [**12**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                                          64 GB |                                                                                                                                         500 GB |       200 GB |
+| 5,000 to 8000                  | 12{% if currentVersion == "enterprise-server@2.22" %}
    or [**16**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                                          96 GB |                                                                                                                                         750 GB |       200 GB |
+| 8,000 to 10,000+               | 16{% if currentVersion == "enterprise-server@2.22" %}
    or [**20**](#beta-features-in-github-enterprise-server-222){% endif %} | 128 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**160 GB**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                                        1000 GB |       200 GB |
 
 {% if currentVersion == "enterprise-server@2.22" %}
 
diff --git a/translations/ru-RU/data/reusables/enterprise_installation/necessary_ports.md b/translations/ru-RU/data/reusables/enterprise_installation/necessary_ports.md
index d40ecc73499e..ce25e5e7a70b 100644
--- a/translations/ru-RU/data/reusables/enterprise_installation/necessary_ports.md
+++ b/translations/ru-RU/data/reusables/enterprise_installation/necessary_ports.md
@@ -1,12 +1,12 @@
-| Port     | Service | Description                                                                                                                    |
-| -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------ |
-| 22       | SSH     | Git over SSH access. Clone, fetch, and push operations to public/private repositories supported.                               |
-| 25       | SMTP    | SMTP with encryption (STARTTLS) support.                                                                                       |
-| 80       | HTTP    | Web application access. *All requests are redirected to the HTTPS port when SSL is enabled.*                                   |
-| 122      | SSH     | Instance shell access. *The default SSH port (22) is dedicated to application git+ssh network traffic.*                        |
-| 161/UDP  | SNMP    | Required for network monitoring protocol operation.                                                                            |
-| 443      | HTTPS   | Web application and Git over HTTPS access.                                                                                     |
-| 1194/UDP | VPN     | Secure replication network tunnel in high availability configuration.                                                          |
-| 8080     | HTTP    | Plain-text web based {% data variables.enterprise.management_console %}. *Not required unless SSL is disabled manually.*  |
-| 8443     | HTTPS   | Secure web based {% data variables.enterprise.management_console %}. *Required for basic installation and configuration.* |
-| 9418     | Git     | Simple Git protocol port. Clone and fetch operations to public repositories only. *Unencrypted network communication.*         |
+| Port     | Service | Description                                                                                                                                                                             |
+| -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 22       | SSH     | Git over SSH access. Clone, fetch, and push operations to public/private repositories supported.                                                                                        |
+| 25       | SMTP    | SMTP with encryption (STARTTLS) support.                                                                                                                                                |
+| 80       | HTTP    | Web application access. *All requests are redirected to the HTTPS port when SSL is enabled.*                                                                                            |
+| 122      | SSH     | Instance shell access. *The default SSH port (22) is dedicated to application git+ssh network traffic.*                                                                                 |
+| 161/UDP  | SNMP    | Required for network monitoring protocol operation.                                                                                                                                     |
+| 443      | HTTPS   | Web application and Git over HTTPS access.                                                                                                                                              |
+| 1194/UDP | VPN     | Secure replication network tunnel in high availability configuration.                                                                                                                   |
+| 8080     | HTTP    | Plain-text web based {% data variables.enterprise.management_console %}. *Not required unless SSL is disabled manually.*                                                                |
+| 8443     | HTTPS   | Secure web based {% data variables.enterprise.management_console %}. *Required for basic installation and configuration.*                                                               |
+| 9418     | Git     | Simple Git protocol port. Clone and fetch operations to public repositories only. *Unencrypted network communication.* {% data reusables.enterprise_installation.when-9418-necessary %}
diff --git a/translations/ru-RU/data/reusables/enterprise_installation/when-9418-necessary.md b/translations/ru-RU/data/reusables/enterprise_installation/when-9418-necessary.md
new file mode 100644
index 000000000000..7eed264bd24e
--- /dev/null
+++ b/translations/ru-RU/data/reusables/enterprise_installation/when-9418-necessary.md
@@ -0,0 +1 @@
+If you have enabled private mode on your instance, then opening this port is only required if you also enabled anonymous Git read access. For more information, see "[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#configuring-anonymous-git-read-access)."
\ No newline at end of file
diff --git a/translations/ru-RU/data/reusables/enterprise_site_admin_settings/packages-tab.md b/translations/ru-RU/data/reusables/enterprise_site_admin_settings/packages-tab.md
index 7552439d3d6c..add144d1e6c8 100644
--- a/translations/ru-RU/data/reusables/enterprise_site_admin_settings/packages-tab.md
+++ b/translations/ru-RU/data/reusables/enterprise_site_admin_settings/packages-tab.md
@@ -1 +1 @@
-1. In the left sidebar, click **Packages**. ![Packages tab in management console sidebar](/assets/images/enterprise/site-admin-settings/management-console-packages-tab.png)
\ No newline at end of file
+1. In the left sidebar, click **Packages**. ![Packages tab in management console sidebar](/assets/images/enterprise/site-admin-settings/management-console-packages-tab.png)
diff --git a/translations/ru-RU/data/reusables/enterprise_user_management/manage-global-webhooks-api.md b/translations/ru-RU/data/reusables/enterprise_user_management/manage-global-webhooks-api.md
index 035e41f395c1..3e7f9ebcfa9a 100644
--- a/translations/ru-RU/data/reusables/enterprise_user_management/manage-global-webhooks-api.md
+++ b/translations/ru-RU/data/reusables/enterprise_user_management/manage-global-webhooks-api.md
@@ -1 +1 @@
-You can also use {% data variables.product.prodname_enterprise_api %} to manage global webhooks. For a complete list of actions, see "[Global webhooks](/v3/enterprise-admin/global_webhooks)."
+You can also use {% data variables.product.prodname_enterprise_api %} to manage global webhooks. For a complete list of actions, see "[Global webhooks](/rest/reference/enterprise-admin#global-webhooks)."
diff --git a/translations/ru-RU/data/reusables/files/commit-author-email-options.md b/translations/ru-RU/data/reusables/files/commit-author-email-options.md
index 08de0767aca3..d55940ff033d 100644
--- a/translations/ru-RU/data/reusables/files/commit-author-email-options.md
+++ b/translations/ru-RU/data/reusables/files/commit-author-email-options.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-If you haven't enabled email address privacy, you can choose which verified email address to author changes with when you edit, delete, or create files or merge a pull request on {% data variables.product.product_name %}. If you enabled email address privacy, then the commit author email address cannot be changed and is `@users.noreply.github.com` by default.
+If you haven't enabled email address privacy, you can choose which verified email address to author changes with when you edit, delete, or create files or merge a pull request on
+{% data variables.product.product_name %}. If you enabled email address privacy, then the commit author email address cannot be changed and is `@users.noreply.github.com` by default.
 {% endif %}
diff --git a/translations/ru-RU/data/reusables/gated-features/code-scanning.md b/translations/ru-RU/data/reusables/gated-features/code-scanning.md
new file mode 100644
index 000000000000..a1aca3e675eb
--- /dev/null
+++ b/translations/ru-RU/data/reusables/gated-features/code-scanning.md
@@ -0,0 +1 @@
+{% data variables.product.prodname_code_scanning_capc %} is available in public repositories, and in public and private repositories owned by organizations with a license for {% data variables.product.prodname_advanced_security %}. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %}
diff --git a/translations/ru-RU/data/reusables/gated-features/packages.md b/translations/ru-RU/data/reusables/gated-features/packages.md
index 19bafa5320a1..edbce971f3db 100644
--- a/translations/ru-RU/data/reusables/gated-features/packages.md
+++ b/translations/ru-RU/data/reusables/gated-features/packages.md
@@ -1,4 +1,5 @@
 {% data variables.product.prodname_registry %} is available with {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} for organizations, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, {% data variables.product.prodname_ghe_server %} 2.22, and {% data variables.product.prodname_ghe_one %}.
 {% if currentVersion == "free-pro-team@latest" %}
-
    {% data variables.product.prodname_registry %} is not available for private repositories owned by accounts using legacy per-repository plans. Also, accounts using legacy per-repository plans cannot access {% data variables.product.prodname_github_container_registry %} since these accounts are billed by repository. {% data reusables.gated-features.more-info %}
+
    
+{% data variables.product.prodname_registry %} is not available for private repositories owned by accounts using legacy per-repository plans. Also, accounts using legacy per-repository plans cannot access {% data variables.product.prodname_github_container_registry %} since these accounts are billed by repository. {% data reusables.gated-features.more-info %}
 {% endif %}
diff --git a/translations/ru-RU/data/reusables/github-actions/actions-billing.md b/translations/ru-RU/data/reusables/github-actions/actions-billing.md
index 54528ddafd95..947b31a56dda 100644
--- a/translations/ru-RU/data/reusables/github-actions/actions-billing.md
+++ b/translations/ru-RU/data/reusables/github-actions/actions-billing.md
@@ -1 +1 @@
-{% data variables.product.prodname_actions %} usage is free for public repositories. For private repositories, each {% data variables.product.prodname_dotcom %} account receives a certain amount of free minutes and storage, depending on the product used with the account.
+{% data variables.product.prodname_actions %} usage is free for public repositories and self-hosted runners. For private repositories, each {% data variables.product.prodname_dotcom %} account receives a certain amount of free minutes and storage, depending on the product used with the account.
diff --git a/translations/ru-RU/data/reusables/github-actions/actions-on-examples.md b/translations/ru-RU/data/reusables/github-actions/actions-on-examples.md
index c347798bb25c..beea3062f56b 100644
--- a/translations/ru-RU/data/reusables/github-actions/actions-on-examples.md
+++ b/translations/ru-RU/data/reusables/github-actions/actions-on-examples.md
@@ -1,14 +1,14 @@
 ##### **Example using a single event**
 
 ```yaml
-# Trigger on push
+# Triggered when code is pushed to any branch in a repository
 on: push
 ```
 
 ##### **Example using a list of events**
 
 ```yaml
-# Trigger the workflow on push or pull request
+# Triggers the workflow on push or pull request events
 on: [push, pull_request]
 ```
 
@@ -19,13 +19,13 @@ If you need to specify activity types or configuration for an event, you must co
 ```yaml
 on:
   # Trigger the workflow on push or pull request,
-  # but only for the master branch
+  # but only for the main branch
   push:
     branches:
-      - master
+      - main
   pull_request:
     branches:
-      - master
+      - main
   # Also trigger on page_build, as well as release created events
   page_build:
   release:
diff --git a/translations/ru-RU/data/reusables/github-actions/actions-unused-labels.md b/translations/ru-RU/data/reusables/github-actions/actions-unused-labels.md
index 1ffeed9d6120..3b8f8366e107 100644
--- a/translations/ru-RU/data/reusables/github-actions/actions-unused-labels.md
+++ b/translations/ru-RU/data/reusables/github-actions/actions-unused-labels.md
@@ -1 +1 @@
- Any unused labels that are not assigned to a runner will be automatically deleted within 24 hours.
\ No newline at end of file
+ Any unused labels that are not assigned to a runner will be automatically deleted within 24 hours.
diff --git a/translations/ru-RU/data/reusables/github-actions/artifact-log-retention-statement.md b/translations/ru-RU/data/reusables/github-actions/artifact-log-retention-statement.md
new file mode 100644
index 000000000000..1109967df33c
--- /dev/null
+++ b/translations/ru-RU/data/reusables/github-actions/artifact-log-retention-statement.md
@@ -0,0 +1,2 @@
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} By default, {% data variables.product.product_name %} stores build logs and artifacts for 90 days, and this retention period can be customized. For more information, see "[Usage limits, billing, and administration](/actions/reference/usage-limits-billing-and-administration#artifact-and-log-retention-policy)".{% endif %}
+{% if currentVersion == "enterprise-server@2.22" %} {% data variables.product.product_name %} stores full build logs and artifacts for 90 days.{% endif %}
diff --git a/translations/ru-RU/data/reusables/github-actions/branch-requirement.md b/translations/ru-RU/data/reusables/github-actions/branch-requirement.md
index ab6508a4520f..b8be9a7d5365 100644
--- a/translations/ru-RU/data/reusables/github-actions/branch-requirement.md
+++ b/translations/ru-RU/data/reusables/github-actions/branch-requirement.md
@@ -1,5 +1,5 @@
 {% note %}
 
-**Note:** This event will only trigger a workflow run if the workflow file is on the `master` or default branch.
+**Note:** This event will only trigger a workflow run if the workflow file is on the default branch.
 
 {% endnote %}
diff --git a/translations/ru-RU/data/reusables/github-actions/change-retention-period-for-artifacts-logs.md b/translations/ru-RU/data/reusables/github-actions/change-retention-period-for-artifacts-logs.md
new file mode 100644
index 000000000000..19398bca6ab8
--- /dev/null
+++ b/translations/ru-RU/data/reusables/github-actions/change-retention-period-for-artifacts-logs.md
@@ -0,0 +1,2 @@
+1. Under **Artifact and log retention duration**, enter a new value.
+1. Click **Save** to apply the change.
\ No newline at end of file
diff --git a/translations/ru-RU/data/reusables/github-actions/disabled-actions-description.md b/translations/ru-RU/data/reusables/github-actions/disabled-actions-description.md
index f197bca51c61..38f9cd246a8b 100644
--- a/translations/ru-RU/data/reusables/github-actions/disabled-actions-description.md
+++ b/translations/ru-RU/data/reusables/github-actions/disabled-actions-description.md
@@ -1 +1 @@
-When you disable {% data variables.product.prodname_actions %}, no workflows run in your repository.
\ No newline at end of file
+When you disable {% data variables.product.prodname_actions %}, no workflows run in your repository.
diff --git a/translations/ru-RU/data/reusables/github-actions/docker-container-os-support.md b/translations/ru-RU/data/reusables/github-actions/docker-container-os-support.md
index df010643d9d0..8dc5f40b5c72 100644
--- a/translations/ru-RU/data/reusables/github-actions/docker-container-os-support.md
+++ b/translations/ru-RU/data/reusables/github-actions/docker-container-os-support.md
@@ -2,7 +2,7 @@
 
 **Note:** If your workflows use Docker container actions or service containers, then you must use a Linux runner:
 
-* If you are using {% data variables.product.prodname_dotcom %}-hosted runners, you must use the `ubuntu-latest` runner.
+* If you are using {% data variables.product.prodname_dotcom %}-hosted runners, you must use an Ubuntu runner.
 * If you are using self-hosted runners, you must use a Linux machine as your runner and Docker must be installed.
 
 {% endnote %}
diff --git a/translations/ru-RU/data/reusables/github-actions/dockerfile-guidelines.md b/translations/ru-RU/data/reusables/github-actions/dockerfile-guidelines.md
index 2ea8f4735b5a..725fe988d98d 100644
--- a/translations/ru-RU/data/reusables/github-actions/dockerfile-guidelines.md
+++ b/translations/ru-RU/data/reusables/github-actions/dockerfile-guidelines.md
@@ -1,3 +1,3 @@
 1. Document required arguments in the action's README and omit them from the `CMD` instruction.
 1. Use defaults that allow using the action without specifying any `args`.
-1. If the action exposes a `--help` flag, or something similar, use that to make your action self-documenting.
\ No newline at end of file
+1. If the action exposes a `--help` flag, or something similar, use that to make your action self-documenting.
diff --git a/translations/ru-RU/data/reusables/github-actions/enabled-actions-description.md b/translations/ru-RU/data/reusables/github-actions/enabled-actions-description.md
index dbf2d1586ffe..3e8b54c0122a 100644
--- a/translations/ru-RU/data/reusables/github-actions/enabled-actions-description.md
+++ b/translations/ru-RU/data/reusables/github-actions/enabled-actions-description.md
@@ -1 +1 @@
-When you enable {% data variables.product.prodname_actions %}, workflows are able to run actions located within your repository and any other public repository.
\ No newline at end of file
+When you enable {% data variables.product.prodname_actions %}, workflows are able to run actions located within your repository and any other public repository.
diff --git a/translations/ru-RU/data/reusables/github-actions/enabled-local-github-actions.md b/translations/ru-RU/data/reusables/github-actions/enabled-local-github-actions.md
index 6b42f587f7ad..2eedbc2de9a0 100644
--- a/translations/ru-RU/data/reusables/github-actions/enabled-local-github-actions.md
+++ b/translations/ru-RU/data/reusables/github-actions/enabled-local-github-actions.md
@@ -1 +1 @@
-When you enable local actions only, workflows can only run actions located in your repository or organization.
\ No newline at end of file
+When you enable local actions only, workflows can only run actions located in your repository or organization.
diff --git a/translations/ru-RU/data/reusables/github-actions/expression-syntax-if.md b/translations/ru-RU/data/reusables/github-actions/expression-syntax-if.md
index d45ed4314e3a..69549fd112ee 100644
--- a/translations/ru-RU/data/reusables/github-actions/expression-syntax-if.md
+++ b/translations/ru-RU/data/reusables/github-actions/expression-syntax-if.md
@@ -1 +1 @@
-When you use expressions in an `if` conditional, you may omit the expression syntax ({% raw %}`${{ }}`{% endraw %}) because {% data variables.product.prodname_dotcom %} automatically evaluates the `if` conditional as an expression.
\ No newline at end of file
+When you use expressions in an `if` conditional, you may omit the expression syntax ({% raw %}`${{ }}`{% endraw %}) because {% data variables.product.prodname_dotcom %} automatically evaluates the `if` conditional as an expression.
diff --git a/translations/ru-RU/data/reusables/github-actions/gradle-workflow-steps.md b/translations/ru-RU/data/reusables/github-actions/gradle-workflow-steps.md
index 0d6e75db3df9..4522b7281395 100644
--- a/translations/ru-RU/data/reusables/github-actions/gradle-workflow-steps.md
+++ b/translations/ru-RU/data/reusables/github-actions/gradle-workflow-steps.md
@@ -1,4 +1,4 @@
 This workflow performs the following steps:
 
 1. Checks out a copy of project's repository.
-1. Sets up the Java JDK.
\ No newline at end of file
+1. Sets up the Java JDK.
diff --git a/translations/ru-RU/data/reusables/github-actions/permissions-statement-secrets-api.md b/translations/ru-RU/data/reusables/github-actions/permissions-statement-secrets-api.md
index 0a3741949b26..0e62bb6498c9 100644
--- a/translations/ru-RU/data/reusables/github-actions/permissions-statement-secrets-api.md
+++ b/translations/ru-RU/data/reusables/github-actions/permissions-statement-secrets-api.md
@@ -1 +1 @@
-To create secrets using the REST API, you must have write access to the repository. For more information, see "[{% data variables.product.prodname_actions %} secrets API](/v3/actions/secrets/)."
+To create secrets using the REST API, you must have write access to the repository or admin access to the organization. For more information, see "[{% data variables.product.prodname_actions %} secrets API](/v3/actions/secrets/)."
diff --git a/translations/ru-RU/data/reusables/github-actions/permissions-statement-secrets-organization.md b/translations/ru-RU/data/reusables/github-actions/permissions-statement-secrets-organization.md
index 7f9339913a67..235a52b2896c 100644
--- a/translations/ru-RU/data/reusables/github-actions/permissions-statement-secrets-organization.md
+++ b/translations/ru-RU/data/reusables/github-actions/permissions-statement-secrets-organization.md
@@ -1 +1 @@
-To create secrets at the organization level, you must have `admin` access. 
\ No newline at end of file
+To create secrets at the organization level, you must have `admin` access. 
diff --git a/translations/ru-RU/data/reusables/github-actions/permissions-statement-secrets-repository.md b/translations/ru-RU/data/reusables/github-actions/permissions-statement-secrets-repository.md
index 2c2c4430059e..0333c71723ba 100644
--- a/translations/ru-RU/data/reusables/github-actions/permissions-statement-secrets-repository.md
+++ b/translations/ru-RU/data/reusables/github-actions/permissions-statement-secrets-repository.md
@@ -1 +1 @@
-To create secrets for a user account repository, you must be the repository owner. To create secrets for an organization repository, you must have `admin` access.
\ No newline at end of file
+To create secrets for a user account repository, you must be the repository owner. To create secrets for an organization repository, you must have `admin` access.
diff --git a/translations/ru-RU/data/reusables/github-actions/private-repository-forks-overview.md b/translations/ru-RU/data/reusables/github-actions/private-repository-forks-overview.md
index d976a281d09a..7be48f36df22 100644
--- a/translations/ru-RU/data/reusables/github-actions/private-repository-forks-overview.md
+++ b/translations/ru-RU/data/reusables/github-actions/private-repository-forks-overview.md
@@ -2,4 +2,4 @@ If you rely on using forks of your private repositories, you can configure polic
 
 - **Run workflows from fork pull requests** - Allows users to run workflows from fork pull requests, using a `GITHUB_TOKEN` with read-only permission, and with no access to secrets.
 - **Send write tokens to workflows from pull requests** - Allows pull requests from forks to use a `GITHUB_TOKEN` with write permission.
-- **Send secrets to workflows from pull requests** - Makes all secrets available to the pull request.
\ No newline at end of file
+- **Send secrets to workflows from pull requests** - Makes all secrets available to the pull request.
diff --git a/translations/ru-RU/data/reusables/github-actions/publish-to-maven-workflow-step.md b/translations/ru-RU/data/reusables/github-actions/publish-to-maven-workflow-step.md
index e8e5bf28c541..24292b0b1246 100644
--- a/translations/ru-RU/data/reusables/github-actions/publish-to-maven-workflow-step.md
+++ b/translations/ru-RU/data/reusables/github-actions/publish-to-maven-workflow-step.md
@@ -1 +1 @@
-Runs the `mvn -B deploy` command to publish to the `ossrh` repository. The `MAVEN_USERNAME` environment variable will be set with the contents of your `OSSRH_USERNAME` secret, and the `MAVEN_PASSWORD` environment variable will be set with the contents of your `OSSRH_TOKEN` secret.
\ No newline at end of file
+Runs the `mvn -B deploy` command to publish to the `ossrh` repository. The `MAVEN_USERNAME` environment variable will be set with the contents of your `OSSRH_USERNAME` secret, and the `MAVEN_PASSWORD` environment variable will be set with the contents of your `OSSRH_TOKEN` secret.
diff --git a/translations/ru-RU/data/reusables/github-actions/publish-to-packages-workflow-step.md b/translations/ru-RU/data/reusables/github-actions/publish-to-packages-workflow-step.md
index 120311e8558b..aa0c63eeeac0 100644
--- a/translations/ru-RU/data/reusables/github-actions/publish-to-packages-workflow-step.md
+++ b/translations/ru-RU/data/reusables/github-actions/publish-to-packages-workflow-step.md
@@ -1 +1 @@
-Runs the `mvn -B deploy` command to publish to {% data variables.product.prodname_registry %}. The `GITHUB_TOKEN` environment variable will be set with the contents of the `GITHUB_TOKEN` secret.
\ No newline at end of file
+Runs the `mvn -B deploy` command to publish to {% data variables.product.prodname_registry %}. The `GITHUB_TOKEN` environment variable will be set with the contents of the `GITHUB_TOKEN` secret.
diff --git a/translations/ru-RU/data/reusables/github-actions/publishing-java-packages-intro.md b/translations/ru-RU/data/reusables/github-actions/publishing-java-packages-intro.md
index 57a4e97a9d58..0b66dce5a795 100644
--- a/translations/ru-RU/data/reusables/github-actions/publishing-java-packages-intro.md
+++ b/translations/ru-RU/data/reusables/github-actions/publishing-java-packages-intro.md
@@ -1 +1 @@
-This guide shows you how to create a workflow that publishes Java packages to {% data variables.product.prodname_registry %} and the Maven Central Repository. With a single workflow, you can publish packages to a single repository or to multiple repositories.
\ No newline at end of file
+This guide shows you how to create a workflow that publishes Java packages to {% data variables.product.prodname_registry %} and the Maven Central Repository. With a single workflow, you can publish packages to a single repository or to multiple repositories.
diff --git a/translations/ru-RU/data/reusables/github-actions/run_id_description.md b/translations/ru-RU/data/reusables/github-actions/run_id_description.md
index c82a4ce8b83c..e47047c28c24 100644
--- a/translations/ru-RU/data/reusables/github-actions/run_id_description.md
+++ b/translations/ru-RU/data/reusables/github-actions/run_id_description.md
@@ -1 +1 @@
-A unique number for each run within a repository. This number does not change if you re-run the workflow run.
\ No newline at end of file
+A unique number for each run within a repository. This number does not change if you re-run the workflow run.
diff --git a/translations/ru-RU/data/reusables/github-actions/run_number_description.md b/translations/ru-RU/data/reusables/github-actions/run_number_description.md
index 4c7db006d6c6..7f4c94a6224e 100644
--- a/translations/ru-RU/data/reusables/github-actions/run_number_description.md
+++ b/translations/ru-RU/data/reusables/github-actions/run_number_description.md
@@ -1 +1 @@
-A unique number for each run of a particular workflow in a repository. This number begins at 1 for the workflow's first run, and increments with each new run. This number does not change if you re-run the workflow run.
\ No newline at end of file
+A unique number for each run of a particular workflow in a repository. This number begins at 1 for the workflow's first run, and increments with each new run. This number does not change if you re-run the workflow run.
diff --git a/translations/ru-RU/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md b/translations/ru-RU/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md
index 68ee5ec4ef01..59d3343c244e 100644
--- a/translations/ru-RU/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md
+++ b/translations/ru-RU/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md
@@ -1,2 +1,2 @@
 1. In the **Self-hosted runners** section of the settings page, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} next to the runner group you'd like to configure, then click **Edit name and [organization|repository] access**. ![Manage repository permissions](/assets/images/help/settings/actions-runner-manage-permissions.png)
-1. Select a new policy from the dropdown list, or modify the runner group name.
\ No newline at end of file
+1. Select a new policy from the dropdown list, or modify the runner group name.
diff --git a/translations/ru-RU/data/reusables/github-actions/self-hosted-runner-list-group.md b/translations/ru-RU/data/reusables/github-actions/self-hosted-runner-list-group.md
index b86a8be047bc..b1512186b608 100644
--- a/translations/ru-RU/data/reusables/github-actions/self-hosted-runner-list-group.md
+++ b/translations/ru-RU/data/reusables/github-actions/self-hosted-runner-list-group.md
@@ -1 +1 @@
-1. If your runner is in a group, locate the runner group and click {% octicon "chevron-down" aria-label="The downward chevron" %} to view the list of runners. ![List runner group](/assets/images/help/settings/actions-org-enterprise-list-group-runners.png)
\ No newline at end of file
+1. If your runner is in a group, locate the runner group and click {% octicon "chevron-down" aria-label="The downward chevron" %} to view the list of runners. ![List runner group](/assets/images/help/settings/actions-org-enterprise-list-group-runners.png)
diff --git a/translations/ru-RU/data/reusables/github-actions/self-hosted-runner-list.md b/translations/ru-RU/data/reusables/github-actions/self-hosted-runner-list.md
index 315f976b7614..3e0ee5b85253 100644
--- a/translations/ru-RU/data/reusables/github-actions/self-hosted-runner-list.md
+++ b/translations/ru-RU/data/reusables/github-actions/self-hosted-runner-list.md
@@ -1 +1 @@
- 1. Locate the list of runners under "Self-hosted runners".
\ No newline at end of file
+ 1. Locate the list of runners under "Self-hosted runners".
diff --git a/translations/ru-RU/data/reusables/github-actions/self-hosted-runner-navigate-repo-and-org.md b/translations/ru-RU/data/reusables/github-actions/self-hosted-runner-navigate-repo-and-org.md
index 1072cf23d061..995eb0964f7a 100644
--- a/translations/ru-RU/data/reusables/github-actions/self-hosted-runner-navigate-repo-and-org.md
+++ b/translations/ru-RU/data/reusables/github-actions/self-hosted-runner-navigate-repo-and-org.md
@@ -1 +1 @@
-1. In your organization or repository, navigate to the main page and click {% octicon "gear" aria-label="The Settings gear" %} **Settings**.
\ No newline at end of file
+1. In your organization or repository, navigate to the main page and click {% octicon "gear" aria-label="The Settings gear" %} **Settings**.
diff --git a/translations/ru-RU/data/reusables/github-actions/self-hosted-runner-removal-impact.md b/translations/ru-RU/data/reusables/github-actions/self-hosted-runner-removal-impact.md
index da0486e69f1b..0b402934fab2 100644
--- a/translations/ru-RU/data/reusables/github-actions/self-hosted-runner-removal-impact.md
+++ b/translations/ru-RU/data/reusables/github-actions/self-hosted-runner-removal-impact.md
@@ -1 +1 @@
-This procedure permanently removes the self-hosted runner. If you only want to temporarily stop a runner from being assigned jobs, you can either shut down the machine or stop the `run` application. The runner will remain assigned in an "Offline" state, and won't execute any jobs until you restart the runner using the `run` application.
\ No newline at end of file
+This procedure permanently removes the self-hosted runner. If you only want to temporarily stop a runner from being assigned jobs, you can either shut down the machine or stop the `run` application. The runner will remain assigned in an "Offline" state, and won't execute any jobs until you restart the runner using the `run` application.
diff --git a/translations/ru-RU/data/reusables/github-actions/self-hosted-runner-reusing.md b/translations/ru-RU/data/reusables/github-actions/self-hosted-runner-reusing.md
index 0435ac7bb9ec..c15c029bdca3 100644
--- a/translations/ru-RU/data/reusables/github-actions/self-hosted-runner-reusing.md
+++ b/translations/ru-RU/data/reusables/github-actions/self-hosted-runner-reusing.md
@@ -1 +1 @@
-Alternatively, if you don't have access to the repository, organization, or enterprise on {% data variables.product.product_name %} to remove a runner, but you would like to re-use the runner machine, then you can delete the `.runner` file inside the self-hosted runner application directory. This allows the runner to be registered without having to re-download the self-hosted runner application.
\ No newline at end of file
+Alternatively, if you don't have access to the repository, organization, or enterprise on {% data variables.product.product_name %} to remove a runner, but you would like to re-use the runner machine, then you can delete the `.runner` file inside the self-hosted runner application directory. This allows the runner to be registered without having to re-download the self-hosted runner application.
diff --git a/translations/ru-RU/data/reusables/github-actions/sidebar-secret.md b/translations/ru-RU/data/reusables/github-actions/sidebar-secret.md
index 64a2802bf99f..9181cb0eaa1d 100644
--- a/translations/ru-RU/data/reusables/github-actions/sidebar-secret.md
+++ b/translations/ru-RU/data/reusables/github-actions/sidebar-secret.md
@@ -1 +1 @@
-1. In the left sidebar, click **Secrets**.
\ No newline at end of file
+1. In the left sidebar, click **Secrets**.
diff --git a/translations/ru-RU/data/reusables/github-actions/usage-api-requests.md b/translations/ru-RU/data/reusables/github-actions/usage-api-requests.md
new file mode 100644
index 000000000000..53bf8ef7e901
--- /dev/null
+++ b/translations/ru-RU/data/reusables/github-actions/usage-api-requests.md
@@ -0,0 +1 @@
+- **API requests** - You can execute up to 1000 API requests in an hour across all actions within a repository. If exceeded, additional API calls will fail, which might cause jobs to fail.
diff --git a/translations/ru-RU/data/reusables/github-actions/usage-matrix-limits.md b/translations/ru-RU/data/reusables/github-actions/usage-matrix-limits.md
new file mode 100644
index 000000000000..8ffadd1225bc
--- /dev/null
+++ b/translations/ru-RU/data/reusables/github-actions/usage-matrix-limits.md
@@ -0,0 +1 @@
+- **Job matrix** - A job matrix can generate a maximum of 256 jobs per workflow run. This limit also applies to self-hosted runners.
diff --git a/translations/ru-RU/data/reusables/github-actions/usage-workflow-run-time.md b/translations/ru-RU/data/reusables/github-actions/usage-workflow-run-time.md
new file mode 100644
index 000000000000..e3f8bee3e1e5
--- /dev/null
+++ b/translations/ru-RU/data/reusables/github-actions/usage-workflow-run-time.md
@@ -0,0 +1 @@
+- **Workflow run time** - Each workflow run is limited to 72 hours. If a workflow run reaches this limit, the workflow run is cancelled.
diff --git a/translations/ru-RU/data/reusables/github-insights/choose-key-metric.md b/translations/ru-RU/data/reusables/github-insights/choose-key-metric.md
index d7495147a32a..5e5c6e8415e2 100644
--- a/translations/ru-RU/data/reusables/github-insights/choose-key-metric.md
+++ b/translations/ru-RU/data/reusables/github-insights/choose-key-metric.md
@@ -1 +1 @@
-2. Under **{% octicon "graph" aria-label="The graph icon" %} Key metrics**, click the name of the metric you want to view. ![List of key metrics](/assets/images/help/insights/key-metrics-list.png)
\ No newline at end of file
+2. Under **{% octicon "graph" aria-label="The graph icon" %} Key metrics**, click the name of the metric you want to view. ![List of key metrics](/assets/images/help/insights/key-metrics-list.png)
diff --git a/translations/ru-RU/data/reusables/github-insights/navigate-to-key-metrics.md b/translations/ru-RU/data/reusables/github-insights/navigate-to-key-metrics.md
index c5317819af4e..90dd55186253 100644
--- a/translations/ru-RU/data/reusables/github-insights/navigate-to-key-metrics.md
+++ b/translations/ru-RU/data/reusables/github-insights/navigate-to-key-metrics.md
@@ -1 +1 @@
-1. In {% data variables.product.prodname_insights %}, click **{% octicon "graph" aria-label="The graph icon" %} Key metrics**. ![Key metrics tab](/assets/images/help/insights/key-metrics-tab.png)
\ No newline at end of file
+1. In {% data variables.product.prodname_insights %}, click **{% octicon "graph" aria-label="The graph icon" %} Key metrics**. ![Key metrics tab](/assets/images/help/insights/key-metrics-tab.png)
diff --git a/translations/ru-RU/data/reusables/gpg/private-email.md b/translations/ru-RU/data/reusables/gpg/private-email.md
index 14d4c6496922..15ea1833856c 100644
--- a/translations/ru-RU/data/reusables/gpg/private-email.md
+++ b/translations/ru-RU/data/reusables/gpg/private-email.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-To keep your email address private, use your {% data variables.product.product_name %}-provided `no-reply` email address.
+To keep your email address private, use your
+{% data variables.product.product_name %}-provided `no-reply` email address.
 {% endif %}
diff --git a/translations/ru-RU/data/reusables/identity-and-permissions/enable-team-sync-azure.md b/translations/ru-RU/data/reusables/identity-and-permissions/enable-team-sync-azure.md
index c61561e35962..85a0204931b7 100644
--- a/translations/ru-RU/data/reusables/identity-and-permissions/enable-team-sync-azure.md
+++ b/translations/ru-RU/data/reusables/identity-and-permissions/enable-team-sync-azure.md
@@ -1 +1 @@
-1. Under "Team synchronization", click **Enable for Azure AD**. ![Enable team synchronization button on security settings page](/assets/images/help/teams/enable-team-synchronization.png)
\ No newline at end of file
+1. Under "Team synchronization", click **Enable for Azure AD**. ![Enable team synchronization button on security settings page](/assets/images/help/teams/enable-team-synchronization.png)
diff --git a/translations/ru-RU/data/reusables/identity-and-permissions/enable-team-sync-okta.md b/translations/ru-RU/data/reusables/identity-and-permissions/enable-team-sync-okta.md
index c12a73bf8bea..3e8ec8b63cd8 100644
--- a/translations/ru-RU/data/reusables/identity-and-permissions/enable-team-sync-okta.md
+++ b/translations/ru-RU/data/reusables/identity-and-permissions/enable-team-sync-okta.md
@@ -1 +1 @@
-1. Under "Team synchronization", click **Enable for Okta**. ![Enable team synchronization for Okta button on security settings page](/assets/images/help/teams/enable-team-synchronization-okta.png)
\ No newline at end of file
+1. Under "Team synchronization", click **Enable for Okta**. ![Enable team synchronization for Okta button on security settings page](/assets/images/help/teams/enable-team-synchronization-okta.png)
diff --git a/translations/ru-RU/data/reusables/identity-and-permissions/supported-idps-team-sync.md b/translations/ru-RU/data/reusables/identity-and-permissions/supported-idps-team-sync.md
index 11f6e8f6ea0d..1395abe61e66 100644
--- a/translations/ru-RU/data/reusables/identity-and-permissions/supported-idps-team-sync.md
+++ b/translations/ru-RU/data/reusables/identity-and-permissions/supported-idps-team-sync.md
@@ -1,3 +1,3 @@
 You can use team synchronization with supported IdPs.
   - Azure AD
-  - Okta
\ No newline at end of file
+  - Okta
diff --git a/translations/ru-RU/data/reusables/identity-and-permissions/sync-team-with-idp-group.md b/translations/ru-RU/data/reusables/identity-and-permissions/sync-team-with-idp-group.md
index ee8c761dc0c4..8cb48608dd77 100644
--- a/translations/ru-RU/data/reusables/identity-and-permissions/sync-team-with-idp-group.md
+++ b/translations/ru-RU/data/reusables/identity-and-permissions/sync-team-with-idp-group.md
@@ -1 +1 @@
-After you enable team synchronization, team maintainers and organization owners can connect a team to an IdP group on {% data variables.product.prodname_dotcom %} or through the API. For more information, see "[Synchronizing a team with an identity provider group](/github/setting-up-and-managing-organizations-and-teams/synchronizing-a-team-with-an-identity-provider-group)" and "[Team synchronization](/v3/teams/team_sync/)."
\ No newline at end of file
+After you enable team synchronization, team maintainers and organization owners can connect a team to an IdP group on {% data variables.product.prodname_dotcom %} or through the API. For more information, see "[Synchronizing a team with an identity provider group](/github/setting-up-and-managing-organizations-and-teams/synchronizing-a-team-with-an-identity-provider-group)" and "[Team synchronization](/v3/teams/team_sync/)."
diff --git a/translations/ru-RU/data/reusables/identity-and-permissions/team-sync-disable.md b/translations/ru-RU/data/reusables/identity-and-permissions/team-sync-disable.md
index e39944fc858d..bae468826d88 100644
--- a/translations/ru-RU/data/reusables/identity-and-permissions/team-sync-disable.md
+++ b/translations/ru-RU/data/reusables/identity-and-permissions/team-sync-disable.md
@@ -2,4 +2,4 @@
 
 **Warning:** When you disable team synchronization, any team members that were assigned to a {% data variables.product.prodname_dotcom %} team through the IdP group are removed from the team and may lose access to repositories.
 
-{% endwarning %}
\ No newline at end of file
+{% endwarning %}
diff --git a/translations/ru-RU/data/reusables/identity-and-permissions/team-sync-okta-requirements.md b/translations/ru-RU/data/reusables/identity-and-permissions/team-sync-okta-requirements.md
index 568b5c7cd195..f8ebbf424675 100644
--- a/translations/ru-RU/data/reusables/identity-and-permissions/team-sync-okta-requirements.md
+++ b/translations/ru-RU/data/reusables/identity-and-permissions/team-sync-okta-requirements.md
@@ -2,4 +2,4 @@ To enable team synchronization for Okta, you or your IdP administrator must:
 
 - Enable SAML SSO and SCIM for your organization using Okta. For more information, see "[Configuring SAML single sign-on and SCIM using Okta](/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta)."
 - Provide the tenant URL for your Okta instance.
-- Generate a valid SSWS token with read-only admin permissions for your Okta installation as a service user. For more information, see [Create the token](https://developer.okta.com/docs/guides/create-an-api-token/create-the-token/) and [Service users](https://help.okta.com/en/prod/Content/Topics/Adv_Server_Access/docs/service-users.htm) in Okta's documentation.
\ No newline at end of file
+- Generate a valid SSWS token with read-only admin permissions for your Okta installation as a service user. For more information, see [Create the token](https://developer.okta.com/docs/guides/create-an-api-token/create-the-token/) and [Service users](https://help.okta.com/en/prod/Content/Topics/Adv_Server_Access/docs/service-users.htm) in Okta's documentation.
diff --git a/translations/ru-RU/data/reusables/interactions/collaborator-user-limit-definition.md b/translations/ru-RU/data/reusables/interactions/collaborator-user-limit-definition.md
index 62f4c861d7f2..718a221e6f7c 100644
--- a/translations/ru-RU/data/reusables/interactions/collaborator-user-limit-definition.md
+++ b/translations/ru-RU/data/reusables/interactions/collaborator-user-limit-definition.md
@@ -1 +1 @@
-**Collaborators only:** When you limit interactions to `collaborators_only`, users who are not collaborators will be temporarily restricted
\ No newline at end of file
+**Collaborators only:** When you limit interactions to `collaborators_only`, users who are not collaborators will be temporarily restricted
diff --git a/translations/ru-RU/data/reusables/interactions/contributor-user-limit-definition.md b/translations/ru-RU/data/reusables/interactions/contributor-user-limit-definition.md
index 134e152c9ee9..e750eb466295 100644
--- a/translations/ru-RU/data/reusables/interactions/contributor-user-limit-definition.md
+++ b/translations/ru-RU/data/reusables/interactions/contributor-user-limit-definition.md
@@ -1 +1 @@
-**Contributors only:** When you limit interactions to `contributors_only`,  users who have not previously contributed and are not collaborators will be temporarily restricted
\ No newline at end of file
+**Contributors only:** When you limit interactions to `contributors_only`,  users who have not previously contributed and are not collaborators will be temporarily restricted
diff --git a/translations/ru-RU/data/reusables/interactions/existing-user-limit-definition.md b/translations/ru-RU/data/reusables/interactions/existing-user-limit-definition.md
index 54c7d8b0b5f6..b921d4455547 100644
--- a/translations/ru-RU/data/reusables/interactions/existing-user-limit-definition.md
+++ b/translations/ru-RU/data/reusables/interactions/existing-user-limit-definition.md
@@ -1 +1 @@
-**Existing users:** When you limit interactions to `existing_users`, new users with accounts less than 24 hours old who have not previously contributed and are not collaborators will be temporarily restricted
\ No newline at end of file
+**Existing users:** When you limit interactions to `existing_users`, new users with accounts less than 24 hours old who have not previously contributed and are not collaborators will be temporarily restricted
diff --git a/translations/ru-RU/data/reusables/interactions/interactions-detail.md b/translations/ru-RU/data/reusables/interactions/interactions-detail.md
index 95ef4c017e4f..9193cd04e704 100644
--- a/translations/ru-RU/data/reusables/interactions/interactions-detail.md
+++ b/translations/ru-RU/data/reusables/interactions/interactions-detail.md
@@ -1 +1 @@
-When restrictions are enabled, only the specified group of {% data variables.product.product_name %} users will be able to participate in interactions. Restrictions expire 24 hours from the time they are set.
\ No newline at end of file
+When restrictions are enabled, only the specified group of {% data variables.product.product_name %} users will be able to participate in interactions. Restrictions expire 24 hours from the time they are set.
diff --git a/translations/ru-RU/data/reusables/issue-events/assignee-properties.md b/translations/ru-RU/data/reusables/issue-events/assignee-properties.md
index e408d915e266..60f612d89caf 100644
--- a/translations/ru-RU/data/reusables/issue-events/assignee-properties.md
+++ b/translations/ru-RU/data/reusables/issue-events/assignee-properties.md
@@ -1 +1 @@
-`assignee` | `object` | The person unassigned from this issue. `assigner` | `object` | The person who performed the unassignment for this issue.
\ No newline at end of file
+`assignee` | `object` | The person unassigned from this issue. `assigner` | `object` | The person who performed the unassignment for this issue.
diff --git a/translations/ru-RU/data/reusables/issue-events/issue-event-common-properties.md b/translations/ru-RU/data/reusables/issue-events/issue-event-common-properties.md
index 7da1a9551cf4..845712722f51 100644
--- a/translations/ru-RU/data/reusables/issue-events/issue-event-common-properties.md
+++ b/translations/ru-RU/data/reusables/issue-events/issue-event-common-properties.md
@@ -7,4 +7,4 @@
 | `событие`    | `строка`  | Identifies the actual type of event that occurred.                   |
 | `commit_id`  | `строка`  | The SHA of the commit that referenced this issue.                    |
 | `commit_url` | `строка`  | The GitHub REST API link to the commit that referenced this issue.   |
-| `created_at` | `строка`  | The timestamp indicating when the event occurred.                    |
\ No newline at end of file
+| `created_at` | `строка`  | The timestamp indicating when the event occurred.                    |
diff --git a/translations/ru-RU/data/reusables/issue-events/label-properties.md b/translations/ru-RU/data/reusables/issue-events/label-properties.md
index 1d616889b1a1..e97ef30a880b 100644
--- a/translations/ru-RU/data/reusables/issue-events/label-properties.md
+++ b/translations/ru-RU/data/reusables/issue-events/label-properties.md
@@ -1 +1 @@
-`label` | `object` | The label removed from the issue `label[name]` | `string` | The name of the label. `label[color]` | `string` | The hex color code. 
\ No newline at end of file
+`label` | `object` | The label removed from the issue `label[name]` | `string` | The name of the label. `label[color]` | `string` | The hex color code. 
diff --git a/translations/ru-RU/data/reusables/issue-events/project-card-properties.md b/translations/ru-RU/data/reusables/issue-events/project-card-properties.md
index 646b6a85b558..457adf5eda1c 100644
--- a/translations/ru-RU/data/reusables/issue-events/project-card-properties.md
+++ b/translations/ru-RU/data/reusables/issue-events/project-card-properties.md
@@ -1 +1 @@
-`project_card` | `object` | The project card object. `project_id` | `integer` | The unique identifier of the project card. `project_url` | `string` | The REST API URL to retrieve the project card. `column_name` | `string` | The name of the column the issue is in.
\ No newline at end of file
+`project_card` | `object` | The project card object. `project_id` | `integer` | The unique identifier of the project card. `project_url` | `string` | The REST API URL to retrieve the project card. `column_name` | `string` | The name of the column the issue is in.
diff --git a/translations/ru-RU/data/reusables/issue-events/review-dismissed-properties.md b/translations/ru-RU/data/reusables/issue-events/review-dismissed-properties.md
index 9c6f67ec8671..7232cb9ea5d3 100644
--- a/translations/ru-RU/data/reusables/issue-events/review-dismissed-properties.md
+++ b/translations/ru-RU/data/reusables/issue-events/review-dismissed-properties.md
@@ -1 +1 @@
-`dismissed_review` | `object` | The information for the dismissed review. `dismissed_review[state]` | `string` | The state the pull request was in when it was dismissed. Can be one of: `commented`, `approved`, or `changes_requested`. `dismissed_review[review_id]` | `string` | The unique identifier of the pull request's review. `dismissed_review[dismissal_message]` | `string` | The message the user included when dismissing the review. `dismissed_review[dismissal_commit_id]` | `string` | The unique identifier of the commit that dismissed the review if one exists.
\ No newline at end of file
+`dismissed_review` | `object` | The information for the dismissed review. `dismissed_review[state]` | `string` | The state the pull request was in when it was dismissed. Can be one of: `commented`, `approved`, or `changes_requested`. `dismissed_review[review_id]` | `string` | The unique identifier of the pull request's review. `dismissed_review[dismissal_message]` | `string` | The message the user included when dismissing the review. `dismissed_review[dismissal_commit_id]` | `string` | The unique identifier of the commit that dismissed the review if one exists.
diff --git a/translations/ru-RU/data/reusables/issue-events/review-request-properties.md b/translations/ru-RU/data/reusables/issue-events/review-request-properties.md
index 350f0d3ff9dd..8821c8b69e8e 100644
--- a/translations/ru-RU/data/reusables/issue-events/review-request-properties.md
+++ b/translations/ru-RU/data/reusables/issue-events/review-request-properties.md
@@ -1 +1 @@
-`requested_reviewer` | `object` | The person requested to review the pull request. `review_requester` | `object` | The person who requested a review.
\ No newline at end of file
+`requested_reviewer` | `object` | The person requested to review the pull request. `review_requester` | `object` | The person who requested a review.
diff --git a/translations/ru-RU/data/reusables/issue-events/timeline_events_object_properties.md b/translations/ru-RU/data/reusables/issue-events/timeline_events_object_properties.md
index 43c03587e7df..c7877fcb46cb 100644
--- a/translations/ru-RU/data/reusables/issue-events/timeline_events_object_properties.md
+++ b/translations/ru-RU/data/reusables/issue-events/timeline_events_object_properties.md
@@ -1 +1 @@
-This events properties do not use the same structure as the [issue event object common properties](#issue-event-object-common-properties). The following properties are returned for this event.
\ No newline at end of file
+This events properties do not use the same structure as the [issue event object common properties](#issue-event-object-common-properties). The following properties are returned for this event.
diff --git a/translations/ru-RU/data/reusables/large_files/can-include-lfs-objects-archives.md b/translations/ru-RU/data/reusables/large_files/can-include-lfs-objects-archives.md
index f0f75e6ec5de..83a7278c3796 100644
--- a/translations/ru-RU/data/reusables/large_files/can-include-lfs-objects-archives.md
+++ b/translations/ru-RU/data/reusables/large_files/can-include-lfs-objects-archives.md
@@ -2,4 +2,4 @@
 
 You can choose whether {% data variables.large_files.product_name_long %}({% data variables.large_files.product_name_short %}) objects are included in source code archives, such as ZIP files and tarballs, that {% data variables.product.product_name %} creates for your repository. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)."
 
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/translations/ru-RU/data/reusables/marketplace/cancellation-clarification.md b/translations/ru-RU/data/reusables/marketplace/cancellation-clarification.md
index f4463ad23d57..80e164b90d61 100644
--- a/translations/ru-RU/data/reusables/marketplace/cancellation-clarification.md
+++ b/translations/ru-RU/data/reusables/marketplace/cancellation-clarification.md
@@ -1 +1 @@
-When a customer cancels a {% data variables.product.prodname_marketplace %} subscription, GitHub does not automatically uninstall the app, so the customer can expect that free features will continue to function.
\ No newline at end of file
+When a customer cancels a {% data variables.product.prodname_marketplace %} subscription, GitHub does not automatically uninstall the app, so the customer can expect that free features will continue to function.
diff --git a/translations/ru-RU/data/reusables/marketplace/github_apps_preferred.md b/translations/ru-RU/data/reusables/marketplace/github_apps_preferred.md
index 04c37a99c9c5..c9ccbece0da2 100644
--- a/translations/ru-RU/data/reusables/marketplace/github_apps_preferred.md
+++ b/translations/ru-RU/data/reusables/marketplace/github_apps_preferred.md
@@ -1 +1 @@
-GitHub Apps are the officially recommended way to integrate with GitHub because they offer much more granular permissions to access data
\ No newline at end of file
+GitHub Apps are the officially recommended way to integrate with GitHub because they offer much more granular permissions to access data
diff --git a/translations/ru-RU/data/reusables/marketplace/launch-with-free.md b/translations/ru-RU/data/reusables/marketplace/launch-with-free.md
index b809c37a0e6a..15230e218b5e 100644
--- a/translations/ru-RU/data/reusables/marketplace/launch-with-free.md
+++ b/translations/ru-RU/data/reusables/marketplace/launch-with-free.md
@@ -1 +1 @@
-You can submit both an unverified and verified app. This will allow you to launch with a free version of your app. Once GitHub verifies your app, your listing will change from unverified to verified in {% data variables.product.prodname_marketplace %} and GitHub will publish your new pricing plans.
\ No newline at end of file
+You can submit both an unverified and verified app. This will allow you to launch with a free version of your app. Once GitHub verifies your app, your listing will change from unverified to verified in {% data variables.product.prodname_marketplace %} and GitHub will publish your new pricing plans.
diff --git a/translations/ru-RU/data/reusables/marketplace/unverified-apps.md b/translations/ru-RU/data/reusables/marketplace/unverified-apps.md
index d390a5e5eaf0..b7ce68277e1c 100644
--- a/translations/ru-RU/data/reusables/marketplace/unverified-apps.md
+++ b/translations/ru-RU/data/reusables/marketplace/unverified-apps.md
@@ -1 +1 @@
-Unverified apps are only offered with free plans. To list paid plans, you must submit a verified app.
\ No newline at end of file
+Unverified apps are only offered with free plans. To list paid plans, you must submit a verified app.
diff --git a/translations/ru-RU/data/reusables/notifications-v2/email-notification-caveats.md b/translations/ru-RU/data/reusables/notifications-v2/email-notification-caveats.md
index cc76d1bbe203..d300a357a9bb 100644
--- a/translations/ru-RU/data/reusables/notifications-v2/email-notification-caveats.md
+++ b/translations/ru-RU/data/reusables/notifications-v2/email-notification-caveats.md
@@ -2,4 +2,4 @@ You'll only receive notification emails if you've chosen to receive email notifi
 
 {% if currentVersion == "free-pro-team@latest" %}
 {% data reusables.user_settings.verify-org-approved-email-domain %}
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/translations/ru-RU/data/reusables/notifications-v2/manage-notifications.md b/translations/ru-RU/data/reusables/notifications-v2/manage-notifications.md
index 6bb2edb8ac82..e799c77a8a40 100644
--- a/translations/ru-RU/data/reusables/notifications-v2/manage-notifications.md
+++ b/translations/ru-RU/data/reusables/notifications-v2/manage-notifications.md
@@ -1 +1 @@
-1. In the left sidebar, under the list of repositories, use the "Manage notifications" drop-down to click **Notification settings**. ![Manage notifications drop down menu options](/assets/images/help/notifications-v2/manage-notifications-options.png)
\ No newline at end of file
+1. In the left sidebar, under the list of repositories, use the "Manage notifications" drop-down to click **Notification settings**. ![Manage notifications drop down menu options](/assets/images/help/notifications-v2/manage-notifications-options.png)
diff --git a/translations/ru-RU/data/reusables/organizations/can-require-ssh-cert.md b/translations/ru-RU/data/reusables/organizations/can-require-ssh-cert.md
index 21761d2048af..6da37763232e 100644
--- a/translations/ru-RU/data/reusables/organizations/can-require-ssh-cert.md
+++ b/translations/ru-RU/data/reusables/organizations/can-require-ssh-cert.md
@@ -1 +1 @@
-You can require that members use SSH certificates to access organization resources,{% if currentVersion ver_gt "enterprise-server@2.17" %}, unless SSH is disabled in your repository{% endif %}.
+You can require that members use SSH certificates to access organization resources,, unless SSH is disabled in your repository.
diff --git a/translations/ru-RU/data/reusables/organizations/organization-name.md b/translations/ru-RU/data/reusables/organizations/organization-name.md
index ccb829ffdb7b..bfab26cffa04 100644
--- a/translations/ru-RU/data/reusables/organizations/organization-name.md
+++ b/translations/ru-RU/data/reusables/organizations/organization-name.md
@@ -1 +1 @@
-1. Under "Organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} account{% endif %} name", type a name for your organization account. ![Field to type an organization name](/assets/images/help/organizations/new-org-name.png)
+1. Under "Organization account name", type a name for your organization account. ![Field to type an organization name](/assets/images/help/organizations/new-org-name.png)
diff --git a/translations/ru-RU/data/reusables/organizations/repository-labels.md b/translations/ru-RU/data/reusables/organizations/repository-labels.md
index 6b5d2097ead1..00425e2fb920 100644
--- a/translations/ru-RU/data/reusables/organizations/repository-labels.md
+++ b/translations/ru-RU/data/reusables/organizations/repository-labels.md
@@ -1 +1 @@
-1. In the left sidebar, click **Repository labels**. ![Repository labels tab](/assets/images/help/organizations/repo-labels-tab.png)
\ No newline at end of file
+1. In the left sidebar, click **Repository labels**. ![Repository labels tab](/assets/images/help/organizations/repo-labels-tab.png)
diff --git a/translations/ru-RU/data/reusables/package_registry/admins-can-configure-package-types.md b/translations/ru-RU/data/reusables/package_registry/admins-can-configure-package-types.md
index 82369c5e4a37..efe344932d49 100644
--- a/translations/ru-RU/data/reusables/package_registry/admins-can-configure-package-types.md
+++ b/translations/ru-RU/data/reusables/package_registry/admins-can-configure-package-types.md
@@ -4,4 +4,4 @@
 **Note:** This package type may not be available for your instance, because site administrators can enable or disable each supported package type. For more information, see "[Configuring packages support for your enterprise](/enterprise/admin/packages/configuring-packages-support-for-your-enterprise)."
 
 {% endnote %}
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/translations/ru-RU/data/reusables/package_registry/authenticate-packages.md b/translations/ru-RU/data/reusables/package_registry/authenticate-packages.md
index 11de4d874fa7..89915a62e856 100644
--- a/translations/ru-RU/data/reusables/package_registry/authenticate-packages.md
+++ b/translations/ru-RU/data/reusables/package_registry/authenticate-packages.md
@@ -1,9 +1,11 @@
 You need an access token to publish, install, and delete packages. You can use a personal access token to authenticate with your username directly to {% data variables.product.prodname_registry %} or the {% data variables.product.prodname_dotcom %} API. When you create a personal access token, you can assign the token different scopes depending on your needs.
 
 {% if currentVersion == "free-pro-team@latest" %}
-To authenticate using a {% data variables.product.prodname_actions %} workflow:
+To authenticate using a
+{% data variables.product.prodname_actions %} workflow:
 - For package registries (`PACKAGE-REGISTRY.pkg.github.com/OWNER/REPOSITORY/IMAGE-NAME`), you can use a `GITHUB_TOKEN`.
 - For the container registry (`ghcr.io/OWNER/IMAGE-NAME`), you must use a personal access token.
 {% else %}
-To authenticate to {% data variables.product.prodname_registry %} using a {% data variables.product.prodname_actions %} workflow, you must use `GITHUB_TOKEN`.
+To authenticate to
+{% data variables.product.prodname_registry %} using a {% data variables.product.prodname_actions %} workflow, you must use `GITHUB_TOKEN`.
 {% endif %}
diff --git a/translations/ru-RU/data/reusables/package_registry/authenticate-to-container-registry-steps.md b/translations/ru-RU/data/reusables/package_registry/authenticate-to-container-registry-steps.md
new file mode 100644
index 000000000000..d502dc5ee999
--- /dev/null
+++ b/translations/ru-RU/data/reusables/package_registry/authenticate-to-container-registry-steps.md
@@ -0,0 +1,25 @@
+1. Create a new personal access token (PAT) with the appropriate scopes for the tasks you want to accomplish. If your organization requires SSO, you must enable SSO for your new token.
+  {% warning %}
+
+  **Note:** If you select the `write:packages` scope, deselect the `repo` scope when creating the PAT. Adding a PAT with the `repo` scope as a secret in your repository allows the credential to be accessible to all collaborators in the repository. This gives unnecessary additional access when a PAT with the `repo` scope is used within an action. For more information on security best practices for actions, see "[Security hardening for GitHub Actions](/actions/getting-started-with-github-actions/security-hardening-for-github-actions#considering-cross-repository-access)."
+
+  {% endwarning %}
+
+    - Select the `read:packages` scope to download container images and read their metadata.
+    - Select the `write:packages` scope to download and upload container images and read and write their metadata.
+    - Select the `delete:packages` scope to delete container images.
+
+  For more information, see "[Creating a personal access token for the command line](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)."
+
+2. Save your PAT. We recommend saving your PAT as an environment variable.
+  ```shell
+  $ export CR_PAT=YOUR_TOKEN
+  ```
+3. Using the CLI for your container type, sign in to the
+{% data variables.product.prodname_github_container_registry %} service at `ghcr.io`.
+  {% raw %}
+  ```shell
+  $ echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin
+  > Login Succeeded
+  ```
+  {% endraw %}
diff --git a/translations/ru-RU/data/reusables/package_registry/authenticate_with_pat_for_container_registry.md b/translations/ru-RU/data/reusables/package_registry/authenticate_with_pat_for_container_registry.md
new file mode 100644
index 000000000000..7a08298672be
--- /dev/null
+++ b/translations/ru-RU/data/reusables/package_registry/authenticate_with_pat_for_container_registry.md
@@ -0,0 +1,9 @@
+{% if currentVersion == "free-pro-team@latest" %}
+If you want to authenticate to
+{% data variables.product.prodname_github_container_registry %} in a {% data variables.product.prodname_actions %} workflow, then you must use a personal access token (PAT). The `GITHUB_TOKEN` does not currently have the required permissions. During the {% data variables.product.prodname_github_container_registry %} beta, the only supported form of authentication is the PAT.
+
+PATs can grant broad access to your account. We recommend selecting only the necessary read, write, or delete `package` scope when creating a PAT to authenticate to the {% data variables.product.prodname_container_registry %}. Avoid including the `repo` scope in a PAT used by a GitHub Actions workflow because it gives unnecessary additional access.
+
+If you'd like to use the {% data variables.product.prodname_container_registry %} in actions during the beta, follow our security best practices for PAT use at "[Security hardening for GitHub Actions](/actions/getting-started-with-github-actions/security-hardening-for-github-actions#considering-cross-repository-access)."
+
+{% endif %}
diff --git a/translations/ru-RU/data/reusables/package_registry/docker_registry_deprecation_status.md b/translations/ru-RU/data/reusables/package_registry/docker_registry_deprecation_status.md
new file mode 100644
index 000000000000..79e9650f348f
--- /dev/null
+++ b/translations/ru-RU/data/reusables/package_registry/docker_registry_deprecation_status.md
@@ -0,0 +1,5 @@
+{% warning %}
+
+**Note:** The {% data variables.product.prodname_registry %} Docker registry will be superseded by {% data variables.product.prodname_github_container_registry %}{% if currentVersion != "free-pro-team@latest" %} in a future {% data variables.product.product_name %} release{% endif %}.{% if currentVersion == "free-pro-team@latest" %} To learn how to migrate your existing Docker images and any workflows using them, see "[Migrating to {% data variables.product.prodname_github_container_registry %} for Docker images](/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images)" and "[Getting started with {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry)."{% endif %}
+
+{% endwarning %}
diff --git a/translations/ru-RU/data/reusables/package_registry/package-immutability.md b/translations/ru-RU/data/reusables/package_registry/package-immutability.md
index e01c7c9f365c..b681b521909d 100644
--- a/translations/ru-RU/data/reusables/package_registry/package-immutability.md
+++ b/translations/ru-RU/data/reusables/package_registry/package-immutability.md
@@ -1,3 +1,5 @@
-To prevent confusion and build problems, {% data variables.product.prodname_dotcom %} permanently reserves a package's name and version number. Even if an entire package is deleted, you cannot reuse the deleted package name in any repository owned by the same account.
+**Public packages:** To prevent confusion and build problems, {% data variables.product.prodname_dotcom %} permanently reserves a package's name and version number. Even if an entire package is deleted, you cannot reuse the deleted package name in any repository owned by the same account.
+
+**Private packages:** If all versions of a private package are deleted, you can publish a package with a previously used name and version.
 
 To revise or replace a package version, we recommend you publish a new version of your package.
diff --git a/translations/ru-RU/data/reusables/pages/best-with-supported-themes.md b/translations/ru-RU/data/reusables/pages/best-with-supported-themes.md
index 50539af8e7eb..5472ce28f5ae 100644
--- a/translations/ru-RU/data/reusables/pages/best-with-supported-themes.md
+++ b/translations/ru-RU/data/reusables/pages/best-with-supported-themes.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-These instructions work best with themes that are officially supported by {% data variables.product.prodname_pages %}. For a complete list of supported themes, see "[Supported themes](https://pages.github.com/themes/)" on the {% data variables.product.prodname_pages %} site.
+These instructions work best with themes that are officially supported by
+{% data variables.product.prodname_pages %}. For a complete list of supported themes, see "[Supported themes](https://pages.github.com/themes/)" on the {% data variables.product.prodname_pages %} site.
 {% endif %}
diff --git a/translations/ru-RU/data/reusables/pre-release-program/machine-man-preview.md b/translations/ru-RU/data/reusables/pre-release-program/machine-man-preview.md
index 8fb50254cd1f..bdcee03dec6f 100644
--- a/translations/ru-RU/data/reusables/pre-release-program/machine-man-preview.md
+++ b/translations/ru-RU/data/reusables/pre-release-program/machine-man-preview.md
@@ -6,4 +6,4 @@
 `application/vnd.github.machine-man-preview+json`
 
 {% endnote %}
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/translations/ru-RU/data/reusables/pre-release-program/suspend-installation-beta.md b/translations/ru-RU/data/reusables/pre-release-program/suspend-installation-beta.md
index 3d81271d74ca..ae027690926d 100644
--- a/translations/ru-RU/data/reusables/pre-release-program/suspend-installation-beta.md
+++ b/translations/ru-RU/data/reusables/pre-release-program/suspend-installation-beta.md
@@ -1,4 +1,5 @@
 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}
-Suspending a {% data variables.product.prodname_github_app %} installation is currently in beta and subject to change. Before you can suspend a {% data variables.product.prodname_github_app %}, the app owner must enable suspending installations for the app by opting-in to the beta. To opt-in to the suspending installations beta feature, see "[Activating beta features for apps](/developers/apps/activating-beta-features-for-apps)."
+Suspending a
+{% data variables.product.prodname_github_app %} installation is currently in beta and subject to change. Before you can suspend a {% data variables.product.prodname_github_app %}, the app owner must enable suspending installations for the app by opting-in to the beta. To opt-in to the suspending installations beta feature, see "[Activating beta features for apps](/developers/apps/activating-beta-features-for-apps)."
 
 {% endif %}
diff --git a/translations/ru-RU/data/reusables/profile/profile-readme.md b/translations/ru-RU/data/reusables/profile/profile-readme.md
index 6c734861db2e..a19a3d4a30d3 100644
--- a/translations/ru-RU/data/reusables/profile/profile-readme.md
+++ b/translations/ru-RU/data/reusables/profile/profile-readme.md
@@ -1 +1 @@
-If you add a README file to the root of a public repository with the same name as your username, that README will automatically appear on your profile page. You can edit your profile README with GitHub Flavored Markdown to create a personalized section on your profile.
\ No newline at end of file
+If you add a README file to the root of a public repository with the same name as your username, that README will automatically appear on your profile page. You can edit your profile README with GitHub Flavored Markdown to create a personalized section on your profile.
diff --git a/translations/ru-RU/data/reusables/project-management/link-repos-to-project-board.md b/translations/ru-RU/data/reusables/project-management/link-repos-to-project-board.md
index d2688ed1fd4d..0a72db53b6c4 100644
--- a/translations/ru-RU/data/reusables/project-management/link-repos-to-project-board.md
+++ b/translations/ru-RU/data/reusables/project-management/link-repos-to-project-board.md
@@ -1 +1 @@
-You can link up to twenty-five repositories to your organization or user-owned project board. Linking repositories makes it easier to add issues and pull requests from those repositories to your project board using **{% octicon "plus" aria-label="The Plus icon" %} Add cards**{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} or from the issue or pull requests sidebar{% endif %}.
+You can link up to twenty-five repositories to your organization or user-owned project board. Linking repositories makes it easier to add issues and pull requests from those repositories to your project board using **{% octicon "plus" aria-label="The Plus icon" %} Add cards** or from the issue or pull requests sidebar.
diff --git a/translations/ru-RU/data/reusables/project-management/project-board-import-with-api.md b/translations/ru-RU/data/reusables/project-management/project-board-import-with-api.md
index ac8b4cdcdfc6..ba15893fea96 100644
--- a/translations/ru-RU/data/reusables/project-management/project-board-import-with-api.md
+++ b/translations/ru-RU/data/reusables/project-management/project-board-import-with-api.md
@@ -1 +1 @@
-You can use {% data variables.product.prodname_dotcom %}'s API to import a project board. For more information, see "[importProject](/v4/mutation/importproject/)."
+You can use {% data variables.product.prodname_dotcom %}'s API to import a project board. For more information, see "[importProject](/graphql/reference/mutations#importproject/)."
diff --git a/translations/ru-RU/data/reusables/projects/disabled-projects.md b/translations/ru-RU/data/reusables/projects/disabled-projects.md
index 2b10747e7e27..9f6e391db7fe 100644
--- a/translations/ru-RU/data/reusables/projects/disabled-projects.md
+++ b/translations/ru-RU/data/reusables/projects/disabled-projects.md
@@ -1 +1 @@
-You only see this event in responses when project boards have been [enabled](/articles/disabling-project-boards-in-a-repository) in the repository.
\ No newline at end of file
+You only see this event in responses when project boards have been [enabled](/articles/disabling-project-boards-in-a-repository) in the repository.
diff --git a/translations/ru-RU/data/reusables/pull_requests/automatically-delete-branches.md b/translations/ru-RU/data/reusables/pull_requests/automatically-delete-branches.md
index 8bfa120f341f..6f603ccb3b40 100644
--- a/translations/ru-RU/data/reusables/pull_requests/automatically-delete-branches.md
+++ b/translations/ru-RU/data/reusables/pull_requests/automatically-delete-branches.md
@@ -1,3 +1 @@
-{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}
 You can have head branches automatically deleted after pull requests are merged in your repository. For more information, see "[Managing the automatic deletion of branches](/articles/managing-the-automatic-deletion-of-branches)."
-{% endif %}
diff --git a/translations/ru-RU/data/reusables/pull_requests/default-commit-message-squash-merge.md b/translations/ru-RU/data/reusables/pull_requests/default-commit-message-squash-merge.md
index 4d1056d48adb..a5aa547d0c05 100644
--- a/translations/ru-RU/data/reusables/pull_requests/default-commit-message-squash-merge.md
+++ b/translations/ru-RU/data/reusables/pull_requests/default-commit-message-squash-merge.md
@@ -1 +1 @@
-For information about the default commit messages for squash merges, see "[About pull request merges](/github/collaborating-with-issues-and-pull-requests/about-pull-request-merges#merge-message-for-a-squash-merge)."
\ No newline at end of file
+For information about the default commit messages for squash merges, see "[About pull request merges](/github/collaborating-with-issues-and-pull-requests/about-pull-request-merges#merge-message-for-a-squash-merge)."
diff --git a/translations/ru-RU/data/reusables/pull_requests/mark-ready-review.md b/translations/ru-RU/data/reusables/pull_requests/mark-ready-review.md
index e06162167878..eb6b7139589d 100644
--- a/translations/ru-RU/data/reusables/pull_requests/mark-ready-review.md
+++ b/translations/ru-RU/data/reusables/pull_requests/mark-ready-review.md
@@ -1 +1 @@
-When you're ready to get feedback on your pull request, you can mark your draft pull request as ready for review. Marking a pull request as ready for review will request reviews from any code owners.
\ No newline at end of file
+When you're ready to get feedback on your pull request, you can mark your draft pull request as ready for review. Marking a pull request as ready for review will request reviews from any code owners.
diff --git a/translations/ru-RU/data/reusables/reminders/author-reviews.md b/translations/ru-RU/data/reusables/reminders/author-reviews.md
index f800bd1be4b0..51124a351886 100644
--- a/translations/ru-RU/data/reusables/reminders/author-reviews.md
+++ b/translations/ru-RU/data/reusables/reminders/author-reviews.md
@@ -1 +1 @@
-1. Optionally, to send reminders to the pull request authors after the review requests have been fulfilled, select **Remind authors after reviews** and choose the number of reviews required before a reminder is sent. ![Remind authors after reviews checkbox](/assets/images/help/settings/scheduled-reminders-remind-authors.png)
\ No newline at end of file
+1. Optionally, to send reminders to the pull request authors after the review requests have been fulfilled, select **Remind authors after reviews** and choose the number of reviews required before a reminder is sent. ![Remind authors after reviews checkbox](/assets/images/help/settings/scheduled-reminders-remind-authors.png)
diff --git a/translations/ru-RU/data/reusables/reminders/ignored-labels.md b/translations/ru-RU/data/reusables/reminders/ignored-labels.md
index a34db3d8436d..55f45c54110d 100644
--- a/translations/ru-RU/data/reusables/reminders/ignored-labels.md
+++ b/translations/ru-RU/data/reusables/reminders/ignored-labels.md
@@ -1 +1 @@
-1. Under "Ignored labels", type a comma-separated list of labels. Scheduled reminders won't include any pull requests that have one or more of these labels. ![Ignored labels field](/assets/images/help/settings/scheduled-reminders-ignored-labels-field.png)
\ No newline at end of file
+1. Under "Ignored labels", type a comma-separated list of labels. Scheduled reminders won't include any pull requests that have one or more of these labels. ![Ignored labels field](/assets/images/help/settings/scheduled-reminders-ignored-labels-field.png)
diff --git a/translations/ru-RU/data/reusables/reminders/ignored-terms.md b/translations/ru-RU/data/reusables/reminders/ignored-terms.md
index ce68dfe48045..d137ef587b1f 100644
--- a/translations/ru-RU/data/reusables/reminders/ignored-terms.md
+++ b/translations/ru-RU/data/reusables/reminders/ignored-terms.md
@@ -1 +1 @@
-1. Under "Ignored terms", type a comma-separated list of terms that may appear in titles of pull requests. Scheduled reminders won't include any pull requests that contain one or more of these terms in their titles. ![Ignored terms field](/assets/images/help/settings/scheduled-reminders-ignored-terms-field.png)
\ No newline at end of file
+1. Under "Ignored terms", type a comma-separated list of terms that may appear in titles of pull requests. Scheduled reminders won't include any pull requests that contain one or more of these terms in their titles. ![Ignored terms field](/assets/images/help/settings/scheduled-reminders-ignored-terms-field.png)
diff --git a/translations/ru-RU/data/reusables/reminders/min-age.md b/translations/ru-RU/data/reusables/reminders/min-age.md
index 5ad2ca5a0b03..4238297768f8 100644
--- a/translations/ru-RU/data/reusables/reminders/min-age.md
+++ b/translations/ru-RU/data/reusables/reminders/min-age.md
@@ -1 +1 @@
-1. Under "Minimum age", type the age of a pull request, in hours. Scheduled reminders won't include pull requests that are newer than this age limit. ![Ignored labels field](/assets/images/help/settings/scheduled-reminders-min-age-field.png)
\ No newline at end of file
+1. Under "Minimum age", type the age of a pull request, in hours. Scheduled reminders won't include pull requests that are newer than this age limit. ![Ignored labels field](/assets/images/help/settings/scheduled-reminders-min-age-field.png)
diff --git a/translations/ru-RU/data/reusables/reminders/min-staleness.md b/translations/ru-RU/data/reusables/reminders/min-staleness.md
index 14a98d4461d2..766d15b7715f 100644
--- a/translations/ru-RU/data/reusables/reminders/min-staleness.md
+++ b/translations/ru-RU/data/reusables/reminders/min-staleness.md
@@ -1 +1 @@
-1. Under "Minimum staleness", type the time since the last activity on a pull request, in hours. Scheduled reminders won't include pull requests whose last activity was more recent than this time. ![Minimum staleness field](/assets/images/help/settings/scheduled-reminders-min-staleness-field.png)
\ No newline at end of file
+1. Under "Minimum staleness", type the time since the last activity on a pull request, in hours. Scheduled reminders won't include pull requests whose last activity was more recent than this time. ![Minimum staleness field](/assets/images/help/settings/scheduled-reminders-min-staleness-field.png)
diff --git a/translations/ru-RU/data/reusables/reminders/real-time-alerts.md b/translations/ru-RU/data/reusables/reminders/real-time-alerts.md
index 6146a5751871..6c32bd6f0817 100644
--- a/translations/ru-RU/data/reusables/reminders/real-time-alerts.md
+++ b/translations/ru-RU/data/reusables/reminders/real-time-alerts.md
@@ -1 +1 @@
-1. Optionally, to receive Slack messages as soon as certain events happen, select **Enable real-time alerts** and select the events to receive real-time alerts for.
\ No newline at end of file
+1. Optionally, to receive Slack messages as soon as certain events happen, select **Enable real-time alerts** and select the events to receive real-time alerts for.
diff --git a/translations/ru-RU/data/reusables/reminders/required-labels.md b/translations/ru-RU/data/reusables/reminders/required-labels.md
index fa8a91cdafe6..b8729c3f84b8 100644
--- a/translations/ru-RU/data/reusables/reminders/required-labels.md
+++ b/translations/ru-RU/data/reusables/reminders/required-labels.md
@@ -1 +1 @@
-1. Under "Required labels", type a comma-separated list of labels. Scheduled reminders will only include pull requests that haven't already been ignored, if they have one or more of these labels. ![Required labels field](/assets/images/help/settings/scheduled-reminders-required-labels-field.png)
\ No newline at end of file
+1. Under "Required labels", type a comma-separated list of labels. Scheduled reminders will only include pull requests that haven't already been ignored, if they have one or more of these labels. ![Required labels field](/assets/images/help/settings/scheduled-reminders-required-labels-field.png)
diff --git a/translations/ru-RU/data/reusables/repositories/about-github-archive-program.md b/translations/ru-RU/data/reusables/repositories/about-github-archive-program.md
index fddb4eb43e15..36deb76d9e3b 100644
--- a/translations/ru-RU/data/reusables/repositories/about-github-archive-program.md
+++ b/translations/ru-RU/data/reusables/repositories/about-github-archive-program.md
@@ -1 +1 @@
-By default, all public repositories are included in the {% data variables.product.prodname_archive %}, a partnership between {% data variables.product.prodname_dotcom %} and organizations such as Software Heritage Foundation and Internet Archive to ensure the long-term preservation of the world's open source software.
\ No newline at end of file
+By default, all public repositories are included in the {% data variables.product.prodname_archive %}, a partnership between {% data variables.product.prodname_dotcom %} and organizations such as Software Heritage Foundation and Internet Archive to ensure the long-term preservation of the world's open source software.
diff --git a/translations/ru-RU/data/reusables/repositories/actions-workflow-status-badge-into.md b/translations/ru-RU/data/reusables/repositories/actions-workflow-status-badge-into.md
index cfaa51ac6d5c..cdbec71bed65 100644
--- a/translations/ru-RU/data/reusables/repositories/actions-workflow-status-badge-into.md
+++ b/translations/ru-RU/data/reusables/repositories/actions-workflow-status-badge-into.md
@@ -1,3 +1,3 @@
-Status badges show whether a workflow is currently failing or passing. A common place to add a status badge is in the README.md file of your repository, but you can add it to any web page you'd like. By default, badges display the status of your default branch. You can also display the status of a workflow run for a specific branch or event using the `branch` and `event` query parameters in the URL.
+A status badge shows whether a workflow is currently failing or passing. A common place to add a status badge is in the README.md file of your repository, but you can add it to any web page you'd like. By default, badges display the status of your default branch. You can also display the status of a workflow run for a specific branch or event using the `branch` and `event` query parameters in the URL.
 
 ![example status badge](/assets/images/help/repository/actions-workflow-status-badge.png)
diff --git a/translations/ru-RU/data/reusables/repositories/blocked-passwords.md b/translations/ru-RU/data/reusables/repositories/blocked-passwords.md
index ca8a2fe11312..6ab492cfc3e8 100644
--- a/translations/ru-RU/data/reusables/repositories/blocked-passwords.md
+++ b/translations/ru-RU/data/reusables/repositories/blocked-passwords.md
@@ -1,5 +1,6 @@
 {% if currentVersion == "free-pro-team@latest" %}
-When you type a password to sign in, create an account, or change your password, {% data variables.product.product_name %} will check if the password you entered is considered weak according to datasets like HaveIBeenPwned. The password may be identified as weak even if you have never used that password before.
+When you type a password to sign in, create an account, or change your password,
+{% data variables.product.product_name %} will check if the password you entered is considered weak according to datasets like HaveIBeenPwned. The password may be identified as weak even if you have never used that password before.
 
 {% data variables.product.product_name %} only inspects the password at the time you type it, and never stores the password you entered in plaintext. For more information, see [HaveIBeenPwned](https://haveibeenpwned.com/).
 {% endif %}
diff --git a/translations/ru-RU/data/reusables/repositories/copy-clone-url.md b/translations/ru-RU/data/reusables/repositories/copy-clone-url.md
index 4bff6a43e23f..2f24104d3ca8 100644
--- a/translations/ru-RU/data/reusables/repositories/copy-clone-url.md
+++ b/translations/ru-RU/data/reusables/repositories/copy-clone-url.md
@@ -2,13 +2,13 @@
 1. Under the repository name, click **Clone or download**. ![Clone or download button](/assets/images/help/repository/clone-repo-clone-url-button.png)
 2. To clone the repository using HTTPS, under "Clone with HTTPS", click
 {% octicon "clippy" aria-label="The clipboard icon" %}.
-To clone the repository using an SSH key
-{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, including a certificate issued by your organization's SSH certificate authority,{% endif %} click **Use SSH**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.
+To clone the repository using an SSH key, including a certificate issued by your organization's SSH certificate authority, click **Use SSH**, then click
+{% octicon "clippy" aria-label="The clipboard icon" %}.
 ![Clone URL button](/assets/images/help/repository/https-url-clone.png)
 {% else %}
 1. Above the list of files, click {% octicon "download" aria-label="The download icon" %} **Code**. !["Code" button](/assets/images/help/repository/code-button.png)
 1. To clone the repository using HTTPS, under "Clone with HTTPS", click
-{% octicon "clippy" aria-label="The clipboard icon" %}. To clone the repository using an SSH key{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, including a certificate issued by your organization's SSH certificate authority,{% endif %} click **Use SSH**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} To clone a repository using {% data variables.product.prodname_cli %}, click **Use {% data variables.product.prodname_cli %}**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.{% endif %}
+{% octicon "clippy" aria-label="The clipboard icon" %}. To clone the repository using an SSH key, including a certificate issued by your organization's SSH certificate authority, click **Use SSH**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} To clone a repository using {% data variables.product.prodname_cli %}, click **Use {% data variables.product.prodname_cli %}**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.{% endif %}
   ![The clipboard icon for copying the URL to clone a repository](/assets/images/help/repository/https-url-clone.png)
   {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}
   ![The clipboard icon for copying the URL to clone a repository with GitHub CLI](/assets/images/help/repository/https-url-clone-cli.png){% endif %}
diff --git a/translations/ru-RU/data/reusables/repositories/navigate-to-job-superlinter.md b/translations/ru-RU/data/reusables/repositories/navigate-to-job-superlinter.md
new file mode 100644
index 000000000000..3c79e1a1a6ab
--- /dev/null
+++ b/translations/ru-RU/data/reusables/repositories/navigate-to-job-superlinter.md
@@ -0,0 +1,5 @@
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+1. In the left sidebar, click the job you want to see. ![Lint code base job](/assets/images/help/repository/superlinter-lint-code-base-job.png)
+{% else %}
+1. In the left sidebar, click the job you want to see. ![Select a workflow job](/assets/images/help/repository/workflow-job.png)
+{% endif %}
\ No newline at end of file
diff --git a/translations/ru-RU/data/reusables/repositories/navigate-to-workflow-superlinter.md b/translations/ru-RU/data/reusables/repositories/navigate-to-workflow-superlinter.md
new file mode 100644
index 000000000000..f09a3b0ae1cb
--- /dev/null
+++ b/translations/ru-RU/data/reusables/repositories/navigate-to-workflow-superlinter.md
@@ -0,0 +1 @@
+1. In the left sidebar, click the workflow you want to see. ![Workflow list in left sidebar](/assets/images/help/repository/superlinter-workflow-sidebar.png)
\ No newline at end of file
diff --git a/translations/ru-RU/data/reusables/repositories/open-with-github-desktop.md b/translations/ru-RU/data/reusables/repositories/open-with-github-desktop.md
index 9d01c2c2d0e8..175929214321 100644
--- a/translations/ru-RU/data/reusables/repositories/open-with-github-desktop.md
+++ b/translations/ru-RU/data/reusables/repositories/open-with-github-desktop.md
@@ -1,6 +1,8 @@
 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %}
 1. Under your repository name, click **Clone or download**. ![Clone or download button](/assets/images/help/repository/clone-repo-clone-url-button.png)
-1. Click **Open in Desktop** to clone the repository and open it in {% data variables.product.prodname_desktop %}. ![Open in Desktop button](/assets/images/help/desktop/open-in-desktop-button.png)
+1. Click **Open in Desktop** to clone the repository and open it in
+{% data variables.product.prodname_desktop %}.
+![Open in Desktop button](/assets/images/help/desktop/open-in-desktop-button.png)
 {% else %}
 1. Above the list of files, click {% octicon "download" aria-label="The download icon" %} **Code**. !["Code" button](/assets/images/help/repository/code-button.png)
 1. Click
diff --git a/translations/ru-RU/data/reusables/repositories/permissions-statement-read.md b/translations/ru-RU/data/reusables/repositories/permissions-statement-read.md
index 9e957151da58..241fdd2ba86a 100644
--- a/translations/ru-RU/data/reusables/repositories/permissions-statement-read.md
+++ b/translations/ru-RU/data/reusables/repositories/permissions-statement-read.md
@@ -1 +1 @@
-People with read access to the repository can perform these steps.
\ No newline at end of file
+Read access to the repository is required to perform these steps.
diff --git a/translations/ru-RU/data/reusables/repositories/permissions-statement-write.md b/translations/ru-RU/data/reusables/repositories/permissions-statement-write.md
index 4c6e9310a6af..457fe0472478 100644
--- a/translations/ru-RU/data/reusables/repositories/permissions-statement-write.md
+++ b/translations/ru-RU/data/reusables/repositories/permissions-statement-write.md
@@ -1 +1 @@
-People with write-level access to the repository can perform these steps.
\ No newline at end of file
+Write access to the repository is required to perform these steps.
diff --git a/translations/ru-RU/data/reusables/repositories/security-alerts-x-github-severity.md b/translations/ru-RU/data/reusables/repositories/security-alerts-x-github-severity.md
index 560d9254c767..7230ee99948a 100644
--- a/translations/ru-RU/data/reusables/repositories/security-alerts-x-github-severity.md
+++ b/translations/ru-RU/data/reusables/repositories/security-alerts-x-github-severity.md
@@ -1 +1 @@
-Email notifications for {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} that affect one or more repositories include the `X-GitHub-Severity`  header field. You can use the value of the `X-GitHub-Severity` header field to filter email notifications for {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %}.
\ No newline at end of file
+Email notifications for {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} that affect one or more repositories include the `X-GitHub-Severity`  header field. You can use the value of the `X-GitHub-Severity` header field to filter email notifications for {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %}.
diff --git a/translations/ru-RU/data/reusables/repositories/select-marketplace-apps.md b/translations/ru-RU/data/reusables/repositories/select-marketplace-apps.md
index d4eece0dacab..4d959cebc7e7 100644
--- a/translations/ru-RU/data/reusables/repositories/select-marketplace-apps.md
+++ b/translations/ru-RU/data/reusables/repositories/select-marketplace-apps.md
@@ -1,3 +1,5 @@
 {% if currentVersion == "free-pro-team@latest" %}
-1. Optionally, if the personal account or organization in which you're creating uses any {% data variables.product.prodname_github_app %}s from {% data variables.product.prodname_marketplace %}, select any apps you'd like to use in the repository. ![List of your account's {% data variables.product.prodname_github_app %}s from {% data variables.product.prodname_marketplace %} and option to grant access](/assets/images/help/repository/create-repository-choose-marketplace-apps.png)
+1. Optionally, if the personal account or organization in which you're creating uses any
+{% data variables.product.prodname_github_app %}s from {% data variables.product.prodname_marketplace %}, select any apps you'd like to use in the repository.
+  ![List of your account's {% data variables.product.prodname_github_app %}s from {% data variables.product.prodname_marketplace %} and option to grant access](/assets/images/help/repository/create-repository-choose-marketplace-apps.png)
 {% endif %}
diff --git a/translations/ru-RU/data/reusables/repositories/sidebar-dependabot-alerts.md b/translations/ru-RU/data/reusables/repositories/sidebar-dependabot-alerts.md
index 74585315b209..b7eadd335c26 100644
--- a/translations/ru-RU/data/reusables/repositories/sidebar-dependabot-alerts.md
+++ b/translations/ru-RU/data/reusables/repositories/sidebar-dependabot-alerts.md
@@ -1 +1 @@
-1. In the security sidebar, click **{% data variables.product.prodname_dependabot_short %} alerts**. ![{% data variables.product.prodname_dependabot_short %} alerts tab](/assets/images/help/repository/dependabot-alerts-tab.png)
\ No newline at end of file
+1. In the security sidebar, click **{% data variables.product.prodname_dependabot_short %} alerts**. ![{% data variables.product.prodname_dependabot_short %} alerts tab](/assets/images/help/repository/dependabot-alerts-tab.png)
diff --git a/translations/ru-RU/data/reusables/repositories/view-failed-job-results-superlinter.md b/translations/ru-RU/data/reusables/repositories/view-failed-job-results-superlinter.md
new file mode 100644
index 000000000000..434994a1691a
--- /dev/null
+++ b/translations/ru-RU/data/reusables/repositories/view-failed-job-results-superlinter.md
@@ -0,0 +1,5 @@
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+1. Any failed steps are automatically expanded to display the results. ![Super linter workflow results](/assets/images/help/repository/super-linter-workflow-results-updated.png)
+{% else %}
+1. Expand the **Run Super-Linter** step to view the results. ![Super linter workflow results](/assets/images/help/repository/super-linter-workflow-results.png)
+{% endif %}
\ No newline at end of file
diff --git a/translations/ru-RU/data/reusables/repositories/view-run-superlinter.md b/translations/ru-RU/data/reusables/repositories/view-run-superlinter.md
new file mode 100644
index 000000000000..2f5d4e8b1b56
--- /dev/null
+++ b/translations/ru-RU/data/reusables/repositories/view-run-superlinter.md
@@ -0,0 +1 @@
+1. From the list of workflow runs, click the name of the run you want to see. ![Name of workflow run](/assets/images/help/repository/superlinter-run-name.png)
\ No newline at end of file
diff --git a/translations/ru-RU/data/reusables/repositories/view-run.md b/translations/ru-RU/data/reusables/repositories/view-run.md
index 4ba2c799ef4f..d2c1f73f0912 100644
--- a/translations/ru-RU/data/reusables/repositories/view-run.md
+++ b/translations/ru-RU/data/reusables/repositories/view-run.md
@@ -1 +1 @@
-1. Under "Workflow runs", click the name of the run you want to see. ![Name of workflow run](/assets/images/help/repository/run-name.png)
+1. From the list of workflow runs, click the name of the run you want to see. ![Name of workflow run](/assets/images/help/repository/run-name.png)
diff --git a/translations/ru-RU/data/reusables/repositories/view-specific-line-superlinter.md b/translations/ru-RU/data/reusables/repositories/view-specific-line-superlinter.md
new file mode 100644
index 000000000000..ae70f1762f54
--- /dev/null
+++ b/translations/ru-RU/data/reusables/repositories/view-specific-line-superlinter.md
@@ -0,0 +1,5 @@
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+1. Optionally, to get a link to a specific line in the logs, click on the step's line number. You can then copy the link from the address bar of your web browser. ![Button to copy link](/assets/images/help/repository/copy-link-button-updated.png)
+{% else %}
+1. Optionally, to get a link to a specific line in the logs, click on the step's line number. You can then copy the link from the address bar of your web browser. ![Button to copy link](/assets/images/help/repository/copy-link-button.png)
+{% endif %}
\ No newline at end of file
diff --git a/translations/ru-RU/data/reusables/saml/add-okta-application.md b/translations/ru-RU/data/reusables/saml/add-okta-application.md
index c0603c1510ee..9f1e9e2155a0 100644
--- a/translations/ru-RU/data/reusables/saml/add-okta-application.md
+++ b/translations/ru-RU/data/reusables/saml/add-okta-application.md
@@ -1 +1 @@
-2. Click **Add application**. !["Add application" button in the Okta Dashboard's Applications tab](/assets/images/help/saml/okta-add-application.png)
\ No newline at end of file
+2. Click **Add application**. !["Add application" button in the Okta Dashboard's Applications tab](/assets/images/help/saml/okta-add-application.png)
diff --git a/translations/ru-RU/data/reusables/saml/assign-yourself-to-okta.md b/translations/ru-RU/data/reusables/saml/assign-yourself-to-okta.md
index 7b2fd7293434..42cb7d475a97 100644
--- a/translations/ru-RU/data/reusables/saml/assign-yourself-to-okta.md
+++ b/translations/ru-RU/data/reusables/saml/assign-yourself-to-okta.md
@@ -1 +1 @@
-1. Assign the application to your user in Okta. For more information, see [Assign applications to users](https://help.okta.com/en/prod/Content/Topics/users-groups-profiles/usgp-assign-apps.htm) in the Okta documentation.
\ No newline at end of file
+1. Assign the application to your user in Okta. For more information, see [Assign applications to users](https://help.okta.com/en/prod/Content/Topics/users-groups-profiles/usgp-assign-apps.htm) in the Okta documentation.
diff --git a/translations/ru-RU/data/reusables/saml/click-enterprise-account-application.md b/translations/ru-RU/data/reusables/saml/click-enterprise-account-application.md
index e5d172dcb9e5..3f8b0dcf579a 100644
--- a/translations/ru-RU/data/reusables/saml/click-enterprise-account-application.md
+++ b/translations/ru-RU/data/reusables/saml/click-enterprise-account-application.md
@@ -1 +1 @@
-1. Click the label for the application you created for your enterprise account.
\ No newline at end of file
+1. Click the label for the application you created for your enterprise account.
diff --git a/translations/ru-RU/data/reusables/saml/okta-admin-button.md b/translations/ru-RU/data/reusables/saml/okta-admin-button.md
index b1f3d74979cc..ffc7938d2dde 100644
--- a/translations/ru-RU/data/reusables/saml/okta-admin-button.md
+++ b/translations/ru-RU/data/reusables/saml/okta-admin-button.md
@@ -1 +1 @@
-1. In Okta, in the upper-right corner, click **Admin**. ![Admin button in Okta](/assets/images/help/saml/okta-admin-button.png)
\ No newline at end of file
+1. In Okta, in the upper-right corner, click **Admin**. ![Admin button in Okta](/assets/images/help/saml/okta-admin-button.png)
diff --git a/translations/ru-RU/data/reusables/saml/okta-configure-api-integration.md b/translations/ru-RU/data/reusables/saml/okta-configure-api-integration.md
index 99b1aad0afae..080baa79cdb4 100644
--- a/translations/ru-RU/data/reusables/saml/okta-configure-api-integration.md
+++ b/translations/ru-RU/data/reusables/saml/okta-configure-api-integration.md
@@ -1 +1 @@
-1. Click **Configure API Integration**. !["Configure API Integration" button for Okta application](/assets/images/help/saml/okta-configure-api-integration.png)
\ No newline at end of file
+1. Click **Configure API Integration**. !["Configure API Integration" button for Okta application](/assets/images/help/saml/okta-configure-api-integration.png)
diff --git a/translations/ru-RU/data/reusables/saml/okta-edit-provisioning.md b/translations/ru-RU/data/reusables/saml/okta-edit-provisioning.md
index 00cc36e07d00..42ce899aab33 100644
--- a/translations/ru-RU/data/reusables/saml/okta-edit-provisioning.md
+++ b/translations/ru-RU/data/reusables/saml/okta-edit-provisioning.md
@@ -2,4 +2,4 @@
 11. To the right of "Create Users", select **Enable**. !["Enable" checkbox for Okta application's "Create Users" option](/assets/images/help/saml/okta-provisioning-enable-create-users.png)
 12. To the right of "Update User Attributes", select **Enable**. !["Enable" checkbox for Okta application's "Update User Attributes" option](/assets/images/help/saml/okta-provisioning-enable-update-user-attributes.png)
 13. To the right of "Deactivate Users", select **Enable**. !["Enable" checkbox for Okta application's "Deactivate Users" option](/assets/images/help/saml/okta-provisioning-enable-deactivate-users.png)
-14. Click **Save**. !["Save" button for Okta application's provisioning configuration](/assets/images/help/saml/okta-provisioning-save.png)
\ No newline at end of file
+14. Click **Save**. !["Save" button for Okta application's provisioning configuration](/assets/images/help/saml/okta-provisioning-save.png)
diff --git a/translations/ru-RU/data/reusables/saml/okta-enable-api-integration.md b/translations/ru-RU/data/reusables/saml/okta-enable-api-integration.md
index b07c86537920..29cb364628f4 100644
--- a/translations/ru-RU/data/reusables/saml/okta-enable-api-integration.md
+++ b/translations/ru-RU/data/reusables/saml/okta-enable-api-integration.md
@@ -1 +1 @@
-1. Select **Enable API integration**. !["Enable API integration" checkbox for Okta application](/assets/images/help/saml/okta-enable-api-integration.png)
\ No newline at end of file
+1. Select **Enable API integration**. !["Enable API integration" checkbox for Okta application](/assets/images/help/saml/okta-enable-api-integration.png)
diff --git a/translations/ru-RU/data/reusables/saml/okta-provisioning-tab.md b/translations/ru-RU/data/reusables/saml/okta-provisioning-tab.md
index f4a8f6cca707..b8c134b4e2ba 100644
--- a/translations/ru-RU/data/reusables/saml/okta-provisioning-tab.md
+++ b/translations/ru-RU/data/reusables/saml/okta-provisioning-tab.md
@@ -1 +1 @@
-1. Under the name of the application, click **Provisioning**. !["Provisioning" tab for Okta application](/assets/images/help/saml/okta-provisioning-tab.png)
\ No newline at end of file
+1. Under the name of the application, click **Provisioning**. !["Provisioning" tab for Okta application](/assets/images/help/saml/okta-provisioning-tab.png)
diff --git a/translations/ru-RU/data/reusables/saml/okta-save-provisioning.md b/translations/ru-RU/data/reusables/saml/okta-save-provisioning.md
index 8c863ae1dda2..15e30d210790 100644
--- a/translations/ru-RU/data/reusables/saml/okta-save-provisioning.md
+++ b/translations/ru-RU/data/reusables/saml/okta-save-provisioning.md
@@ -1 +1 @@
-1. Click **Save**. !["Save" button for Okta application's provisioning configuration](/assets/images/help/saml/okta-provisioning-tab-save.png)
\ No newline at end of file
+1. Click **Save**. !["Save" button for Okta application's provisioning configuration](/assets/images/help/saml/okta-provisioning-tab-save.png)
diff --git a/translations/ru-RU/data/reusables/saml/okta-sign-on-tab.md b/translations/ru-RU/data/reusables/saml/okta-sign-on-tab.md
index 99468b5e5a09..405f402da97f 100644
--- a/translations/ru-RU/data/reusables/saml/okta-sign-on-tab.md
+++ b/translations/ru-RU/data/reusables/saml/okta-sign-on-tab.md
@@ -1 +1 @@
-1. Under the name of the application, click **Sign on**. !["Sign on" tab for Okta application](/assets/images/help/saml/okta-sign-on-tab.png)
\ No newline at end of file
+1. Under the name of the application, click **Sign on**. !["Sign on" tab for Okta application](/assets/images/help/saml/okta-sign-on-tab.png)
diff --git a/translations/ru-RU/data/reusables/saml/okta-view-setup-instructions.md b/translations/ru-RU/data/reusables/saml/okta-view-setup-instructions.md
index 085e62499c25..fec76f61133b 100644
--- a/translations/ru-RU/data/reusables/saml/okta-view-setup-instructions.md
+++ b/translations/ru-RU/data/reusables/saml/okta-view-setup-instructions.md
@@ -1 +1 @@
-1. Under "SIGN ON METHODS", click **View Setup Instructions**. !["View Setup Instructions" button in Okta application's "Sign On" tab](/assets/images/help/saml/okta-view-setup-instructions.png)
\ No newline at end of file
+1. Under "SIGN ON METHODS", click **View Setup Instructions**. !["View Setup Instructions" button in Okta application's "Sign On" tab](/assets/images/help/saml/okta-view-setup-instructions.png)
diff --git a/translations/ru-RU/data/reusables/saml/search-ghec-okta.md b/translations/ru-RU/data/reusables/saml/search-ghec-okta.md
index c0881a1727f6..e4acdaf2ba11 100644
--- a/translations/ru-RU/data/reusables/saml/search-ghec-okta.md
+++ b/translations/ru-RU/data/reusables/saml/search-ghec-okta.md
@@ -1 +1 @@
-3. In the search field, type "GitHub Enterprise Cloud". ![Okta's "Search for an application" field](/assets/images/help/saml/okta-search-for-an-application.png)
\ No newline at end of file
+3. In the search field, type "GitHub Enterprise Cloud". ![Okta's "Search for an application" field](/assets/images/help/saml/okta-search-for-an-application.png)
diff --git a/translations/ru-RU/data/reusables/saml/use-classic-ui.md b/translations/ru-RU/data/reusables/saml/use-classic-ui.md
index abf6ff92c43b..20870f6b8c3e 100644
--- a/translations/ru-RU/data/reusables/saml/use-classic-ui.md
+++ b/translations/ru-RU/data/reusables/saml/use-classic-ui.md
@@ -1,3 +1,3 @@
 You must use the "Classic UI" in Okta. For more information, see [Organized Navigation](https://developer.okta.com/blog/2017/09/25/all-new-developer-console#new-look--feel) on the Okta blog.
 
-![Selecting "Classic UI" from Okta UI style picker above dashboard](/assets/images/help/saml/okta-classic-ui.png)
\ No newline at end of file
+![Selecting "Classic UI" from Okta UI style picker above dashboard](/assets/images/help/saml/okta-classic-ui.png)
diff --git a/translations/ru-RU/data/reusables/scim/enterprise-account-scim.md b/translations/ru-RU/data/reusables/scim/enterprise-account-scim.md
index 41d1a43470e4..1797863354c2 100644
--- a/translations/ru-RU/data/reusables/scim/enterprise-account-scim.md
+++ b/translations/ru-RU/data/reusables/scim/enterprise-account-scim.md
@@ -1 +1 @@
-If you're participating in the private beta for user provisioning for enterprise accounts, when you enable SAML for your enterprise account, SCIM provisioning and deprovisioning is enabled by default in {% data variables.product.product_name %}. You can use provisioning to manage organization membership by configuring SCIM in your IdP.
\ No newline at end of file
+If you're participating in the private beta for user provisioning for enterprise accounts, when you enable SAML for your enterprise account, SCIM provisioning and deprovisioning is enabled by default in {% data variables.product.product_name %}. You can use provisioning to manage organization membership by configuring SCIM in your IdP.
diff --git a/translations/ru-RU/data/reusables/secret-scanning/beta.md b/translations/ru-RU/data/reusables/secret-scanning/beta.md
index 13b1cc30155a..68ed06f9c93a 100644
--- a/translations/ru-RU/data/reusables/secret-scanning/beta.md
+++ b/translations/ru-RU/data/reusables/secret-scanning/beta.md
@@ -2,4 +2,4 @@
 
 **Note:** {% data variables.product.prodname_secret_scanning_caps %} for private repositories is currently in beta and subject to change. To request access to the beta, [join the waitlist](https://github.com/features/security/advanced-security/signup).
 
-{% endnote %}
\ No newline at end of file
+{% endnote %}
diff --git a/translations/ru-RU/data/reusables/security/security-and-analysis-features-enable-read-only.md b/translations/ru-RU/data/reusables/security/security-and-analysis-features-enable-read-only.md
index 34ccd94fd4d5..9941a34ca334 100644
--- a/translations/ru-RU/data/reusables/security/security-and-analysis-features-enable-read-only.md
+++ b/translations/ru-RU/data/reusables/security/security-and-analysis-features-enable-read-only.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-If you enable security and analysis features, {% data variables.product.company_short %} performs read-only analysis on your repository. For more information, see "[About {% data variables.product.company_short %}'s use of your data](/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data)."
-{% endif %}
\ No newline at end of file
+If you enable security and analysis features,
+{% data variables.product.company_short %} performs read-only analysis on your repository. For more information, see "[About {% data variables.product.company_short %}'s use of your data](/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data)."
+{% endif %}
diff --git a/translations/ru-RU/data/reusables/shortdesc/iso_8601.md b/translations/ru-RU/data/reusables/shortdesc/iso_8601.md
index ff04e176b2e3..6f3fbed64c03 100644
--- a/translations/ru-RU/data/reusables/shortdesc/iso_8601.md
+++ b/translations/ru-RU/data/reusables/shortdesc/iso_8601.md
@@ -1 +1 @@
-This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`.
\ No newline at end of file
+This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`.
diff --git a/translations/ru-RU/data/reusables/sponsors/edit-featured-work.md b/translations/ru-RU/data/reusables/sponsors/edit-featured-work.md
index 6272fd015c8b..cbdc873914f3 100644
--- a/translations/ru-RU/data/reusables/sponsors/edit-featured-work.md
+++ b/translations/ru-RU/data/reusables/sponsors/edit-featured-work.md
@@ -1,3 +1,3 @@
 1. Optionally, choose the repositories that are showcased on your {% data variables.product.prodname_sponsors %} profile.
     - To the right of "Featured work", click **Edit**. ![Edit button for featured work](/assets/images/help/sponsors/featured-work-edit-button.png)
-    - Select up to 6 repositories, then click **Save**. ![Checkboxes to select repositories](/assets/images/help/sponsors/featured-work-select.png)
\ No newline at end of file
+    - Select up to 6 repositories, then click **Save**. ![Checkboxes to select repositories](/assets/images/help/sponsors/featured-work-select.png)
diff --git a/translations/ru-RU/data/reusables/sponsors/meet-the-team.md b/translations/ru-RU/data/reusables/sponsors/meet-the-team.md
index 3edbfe23bdc8..5b92cf58dffd 100644
--- a/translations/ru-RU/data/reusables/sponsors/meet-the-team.md
+++ b/translations/ru-RU/data/reusables/sponsors/meet-the-team.md
@@ -2,4 +2,4 @@
     - To the right of "Meet the team", click **Edit**.  
       ![Edit organization members to profile button](/assets/images/help/sponsors/edit-org-members-profile-button.png)
     - Select up to six organization members, then click **Save**. ![Select highlighted organization members](/assets/images/help/sponsors/select-highlighted-org-members.png)
-    - Optionally, under each highlighted member's name, type a description of the member. ![Description for highlighted organization members](/assets/images/help/sponsors/description-highlighted-org-members.png)
\ No newline at end of file
+    - Optionally, under each highlighted member's name, type a description of the member. ![Description for highlighted organization members](/assets/images/help/sponsors/description-highlighted-org-members.png)
diff --git a/translations/ru-RU/data/reusables/sponsors/navigate-to-your-goals-tab.md b/translations/ru-RU/data/reusables/sponsors/navigate-to-your-goals-tab.md
index fec98000f9b6..cea6796834db 100644
--- a/translations/ru-RU/data/reusables/sponsors/navigate-to-your-goals-tab.md
+++ b/translations/ru-RU/data/reusables/sponsors/navigate-to-your-goals-tab.md
@@ -1 +1 @@
-1. In the left sidebar, click **Your goals**. ![Your goals tab](/assets/images/help/sponsors/your-goals-tab.png)
\ No newline at end of file
+1. In the left sidebar, click **Your goals**. ![Your goals tab](/assets/images/help/sponsors/your-goals-tab.png)
diff --git a/translations/ru-RU/data/reusables/sponsors/opt-in-to-being-featured.md b/translations/ru-RU/data/reusables/sponsors/opt-in-to-being-featured.md
index bbd09ae633ec..eaa87f3cf2d5 100644
--- a/translations/ru-RU/data/reusables/sponsors/opt-in-to-being-featured.md
+++ b/translations/ru-RU/data/reusables/sponsors/opt-in-to-being-featured.md
@@ -1 +1 @@
-1. Optionally, select **Opt-in to potentially being featured on github.com/sponsors**. ![Checkbox to opt-in to being featured](/assets/images/help/sponsors/opt-in-to-being-featured.png)
\ No newline at end of file
+1. Optionally, select **Opt-in to potentially being featured on github.com/sponsors**. ![Checkbox to opt-in to being featured](/assets/images/help/sponsors/opt-in-to-being-featured.png)
diff --git a/translations/ru-RU/data/reusables/sponsors/publish-goal.md b/translations/ru-RU/data/reusables/sponsors/publish-goal.md
index 68190018e7b8..7febeb4a951a 100644
--- a/translations/ru-RU/data/reusables/sponsors/publish-goal.md
+++ b/translations/ru-RU/data/reusables/sponsors/publish-goal.md
@@ -1 +1 @@
-1. Click **Publish**. ![Publish button](/assets/images/help/sponsors/publish-goal-button.png)
\ No newline at end of file
+1. Click **Publish**. ![Publish button](/assets/images/help/sponsors/publish-goal-button.png)
diff --git a/translations/ru-RU/data/reusables/sponsors/retire-goal.md b/translations/ru-RU/data/reusables/sponsors/retire-goal.md
index bf0e01c5a3ce..c686c8ef1b74 100644
--- a/translations/ru-RU/data/reusables/sponsors/retire-goal.md
+++ b/translations/ru-RU/data/reusables/sponsors/retire-goal.md
@@ -1,2 +1,2 @@
 1. At the bottom of the page, click **Retire**. ![The Retire button](/assets/images/help/sponsors/retire-goal-button.png)
-2. Read the warning, then click **OK**. ![Warning about retiring a goal](/assets/images/help/sponsors/confirm-retire-goal.png)
\ No newline at end of file
+2. Read the warning, then click **OK**. ![Warning about retiring a goal](/assets/images/help/sponsors/confirm-retire-goal.png)
diff --git a/translations/ru-RU/data/reusables/sponsors/save-profile.md b/translations/ru-RU/data/reusables/sponsors/save-profile.md
index 57b2d4b31f67..01f7b8a711dc 100644
--- a/translations/ru-RU/data/reusables/sponsors/save-profile.md
+++ b/translations/ru-RU/data/reusables/sponsors/save-profile.md
@@ -1 +1 @@
-1. Click **Update profile**.
\ No newline at end of file
+1. Click **Update profile**.
diff --git a/translations/ru-RU/data/reusables/sponsors/set-a-goal.md b/translations/ru-RU/data/reusables/sponsors/set-a-goal.md
index 4d4098c6af11..943723255016 100644
--- a/translations/ru-RU/data/reusables/sponsors/set-a-goal.md
+++ b/translations/ru-RU/data/reusables/sponsors/set-a-goal.md
@@ -1 +1 @@
-1. Under "Your goals", click **Set a goal**. ![Set a goal button ](/assets/images/help/sponsors/set-a-goal-button.png)
\ No newline at end of file
+1. Under "Your goals", click **Set a goal**. ![Set a goal button ](/assets/images/help/sponsors/set-a-goal-button.png)
diff --git a/translations/ru-RU/data/reusables/sponsors/short-bio.md b/translations/ru-RU/data/reusables/sponsors/short-bio.md
index db494ee33f90..387246f51616 100644
--- a/translations/ru-RU/data/reusables/sponsors/short-bio.md
+++ b/translations/ru-RU/data/reusables/sponsors/short-bio.md
@@ -1 +1 @@
-1. Under "Short bio", type a brief description of yourself and your work. ![Short bio field](/assets/images/help/sponsors/short-bio.png)
\ No newline at end of file
+1. Under "Short bio", type a brief description of yourself and your work. ![Short bio field](/assets/images/help/sponsors/short-bio.png)
diff --git a/translations/ru-RU/data/reusables/sponsors/stripe-supported-regions.md b/translations/ru-RU/data/reusables/sponsors/stripe-supported-regions.md
index b7b781475a25..e89949ce86e7 100644
--- a/translations/ru-RU/data/reusables/sponsors/stripe-supported-regions.md
+++ b/translations/ru-RU/data/reusables/sponsors/stripe-supported-regions.md
@@ -1 +1 @@
-For a list of supported regions, see [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors).
+For a list of supported regions, see [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors#countries).
diff --git a/translations/ru-RU/data/reusables/sponsors/you-can-be-a-sponsored-developer.md b/translations/ru-RU/data/reusables/sponsors/you-can-be-a-sponsored-developer.md
index cab20e5d2af2..28b8e06b5e66 100644
--- a/translations/ru-RU/data/reusables/sponsors/you-can-be-a-sponsored-developer.md
+++ b/translations/ru-RU/data/reusables/sponsors/you-can-be-a-sponsored-developer.md
@@ -1 +1 @@
-Anyone who contributes to an open source project and has a bank account in a supported region is eligible to become a sponsored developer. Contributions include but are not limited to bug reports, issue triage, code, documentation, leadership, business development, project management, mentorship, and design. If you live in a region that isn't already supported by {% data variables.product.prodname_sponsors %}, you can sign up for the waitlist to participate in the beta of {% data variables.product.prodname_sponsors %}. To see if {% data variables.product.prodname_sponsors %} is available in your area, see [the list of supported regions](https://github.com/sponsors#regions).
+Anyone who contributes to an open source project and lives in a supported region is eligible to become a sponsored developer. Contributions include but are not limited to bug reports, issue triage, code, documentation, leadership, business development, project management, mentorship, and design. If you live in a region that isn't already supported by {% data variables.product.prodname_sponsors %}, you can sign up for the waitlist to participate in the beta of {% data variables.product.prodname_sponsors %}.
diff --git a/translations/ru-RU/data/reusables/sponsors/you-can-be-a-sponsored-organization.md b/translations/ru-RU/data/reusables/sponsors/you-can-be-a-sponsored-organization.md
index 7b6f8a085e58..8b1a3ed050da 100644
--- a/translations/ru-RU/data/reusables/sponsors/you-can-be-a-sponsored-organization.md
+++ b/translations/ru-RU/data/reusables/sponsors/you-can-be-a-sponsored-organization.md
@@ -1 +1 @@
-Any organization that contributes to an open source project and has a dedicated bank account in a supported region is eligible to become a sponsored organization. If you live in a region that isn't already supported by {% data variables.product.prodname_sponsors %}, join the waitlist at [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors).
+Any organization that contributes to an open source project and legally operates in a supported region is eligible to become a sponsored organization. If your organization operates in a region that isn't already supported by {% data variables.product.prodname_sponsors %}, join the waitlist at [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors).
diff --git a/translations/ru-RU/data/reusables/ssh/dsa-support.md b/translations/ru-RU/data/reusables/ssh/dsa-support.md
index 4cbfdb1a5495..7f6f3c22f4d2 100644
--- a/translations/ru-RU/data/reusables/ssh/dsa-support.md
+++ b/translations/ru-RU/data/reusables/ssh/dsa-support.md
@@ -1,5 +1,5 @@
 {% note %}
 
-**Note:** {% if currentVersion != "free-pro-team@latest" or currentVersion ver_lt "enterprise-server@2.19" %}DSA keys were deprecated in OpenSSH 7.0. If your operating system uses OpenSSH, you'll need to use an alternate type of key when setting up SSH, such as an RSA key. For instance, if your operating system is macOS Sierra, you can set up SSH using an RSA key.{% else %}DSA keys (SSH-DSS) are no longer supported. Existing keys will continue to function, but you cannot add new DSA keys to your {% data variables.product.product_name %} account.{% endif %}
+**Note:** DSA keys (SSH-DSS) are no longer supported. Existing keys will continue to function, but you cannot add new DSA keys to your {% data variables.product.product_name %} account.
 
 {% endnote %}
diff --git a/translations/ru-RU/data/reusables/support/about-premium-plans.md b/translations/ru-RU/data/reusables/support/about-premium-plans.md
index 43d503dc483c..849dac12e059 100644
--- a/translations/ru-RU/data/reusables/support/about-premium-plans.md
+++ b/translations/ru-RU/data/reusables/support/about-premium-plans.md
@@ -3,16 +3,16 @@
 
 There are two {% data variables.contact.premium_support %} plans: Premium and Premium Plus / {% data variables.product.microsoft_premium_plus_support_plan %}.
 
-|                       | {% data variables.product.premium_support_plan %} | {% data variables.product.premium_plus_support_plan %} |
-| --------------------- | -------------------------------------------------------- | ------------------------------------------------------------- |
-| Hours of operation    | 24 x 7                                                   | 24 x 7                                                        |
-| Initial response time | 
    • 30 minutes for {% data variables.product.support_ticket_priority_urgent %}
    • 4 hours for {% data variables.product.support_ticket_priority_high %}
                                    | 
    • 30 minutes for {% data variables.product.support_ticket_priority_urgent %}
    • 4 hours for {% data variables.product.support_ticket_priority_high %}
                                         |
-| Support channels      | 
    • Online ticket submission
    • Phone support
                                    | 
    • Online ticket submission
    • Phone support
    • Screen share for critical issues
                                         |
-| Training              | Access to premium content                                | 
    • Access to premium content
    • 1 virtual training class per year
                                         |
-| Authorized contacts   | 10                                                       | 25                                                            |
-| Resources             | Priority ticket handling                                 | 
    • Priority ticket handling
    • Named Technical Support Account Manager
                                         |
-| Scheduled checks      | Bi-annual health check and reporting                     | 
    • Quarterly health check and reporting
    • Quarterly account reviews
                                         |
-| Administration        |                                                          | 4 hours of Managed Services per month                         |
+|                       | {% data variables.product.premium_support_plan %} | {% data variables.product.premium_plus_support_plan %}
+| --------------------- | --------------------------------------------------- | -------------------------------------------------------- |
+| Hours of operation    | 24 x 7                                              | 24 x 7                                                   |
+| Initial response time | 
    • 30 minutes for {% data variables.product.support_ticket_priority_urgent %}
    • 4 hours for {% data variables.product.support_ticket_priority_high %}
                               | 
    • 30 minutes for {% data variables.product.support_ticket_priority_urgent %}
    • 4 hours for {% data variables.product.support_ticket_priority_high %}
                                    |
+| Support channels      | 
    • Online ticket submission
    • Phone support
                               | 
    • Online ticket submission
    • Phone support
    • Screen share for critical issues
                                    |
+| Training              | Access to premium content                           | 
    • Access to premium content
    • 1 virtual training class per year
                                    |
+| Authorized contacts   | 10                                                  | 25                                                       |
+| Resources             | Priority ticket handling                            | 
    • Priority ticket handling
    • Named Technical Support Account Manager
                                    |
+| Scheduled checks      | Bi-annual health check and reporting                | 
    • Quarterly health check and reporting
    • Quarterly account reviews
                                    |
+| Administration        |                                                     | 4 hours of Managed Services per month                    |
 
   {% note %}
 
diff --git a/translations/ru-RU/data/reusables/support/ghec-premium-priorities.md b/translations/ru-RU/data/reusables/support/ghec-premium-priorities.md
index 981199d48332..8c1bd390cd67 100644
--- a/translations/ru-RU/data/reusables/support/ghec-premium-priorities.md
+++ b/translations/ru-RU/data/reusables/support/ghec-premium-priorities.md
@@ -1,6 +1,6 @@
-|                              Priority                              | Description                                                                                                                                                                                                                                                                                             | Примеры                   |
-|:------------------------------------------------------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
-| {% data variables.product.support_ticket_priority_urgent %} | Production workflows for your organization or enterprise on {% data variables.product.prodname_ghe_cloud %} are failing due to critical service errors or outages, and the failure directly impacts the operation of your business.                                                              | 
    • Errors or outages on {% data variables.product.prodname_dotcom_the_website %} affect core Git or web application functionality for all members of your organization or enterprise
     |
-|  {% data variables.product.support_ticket_priority_high %}  | Account or security issues with your organization or enterprise on {% data variables.product.prodname_ghe_cloud %} are causing limited impact to your business.                                                                                                                                  | 
    • An organization or enterprise owner has unintentionally deleted an organization
    • An organization or enterprise member has uploaded sensitive data in a commit, issue, pull request, or issue attachment
     |
+|                           Priority                            | Description                                                                                                                                                                                                                                                                                   | Примеры                   |
+|:-------------------------------------------------------------:| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
+| {% data variables.product.support_ticket_priority_urgent %} | Production workflows for your organization or enterprise on {% data variables.product.prodname_ghe_cloud %} are failing due to critical service errors or outages, and the failure directly impacts the operation of your business.                                                         | 
    • Errors or outages on {% data variables.product.prodname_dotcom_the_website %} affect core Git or web application functionality for all members of your organization or enterprise
     |
+|  {% data variables.product.support_ticket_priority_high %}  | Account or security issues with your organization or enterprise on {% data variables.product.prodname_ghe_cloud %} are causing limited impact to your business.                                                                                                                             | 
    • An organization or enterprise owner has unintentionally deleted an organization
    • An organization or enterprise member has uploaded sensitive data in a commit, issue, pull request, or issue attachment
     |
 | {% data variables.product.support_ticket_priority_normal %} | Members of your organization or enterprise on {% data variables.product.prodname_ghe_cloud %} are experiencing limited or moderate issues with {% data variables.product.prodname_dotcom_the_website %}, or you have general concerns or questions about your organization or enterprise. | 
    • Questions about using APIs and features for your organization or enterprise
    • Issues with tools for organization data migration that {% data variables.product.company_short %} provides
    • Features related to your organization or enterprise not working as expected
    • General security questions about your organization or enterprise
     |
-|  {% data variables.product.support_ticket_priority_low %}   | You have a question or suggestion about your organization or enterprise on {% data variables.product.prodname_ghe_cloud %} that is not time-sensitive, or does not otherwise block the productivity of your team.                                                                                | 
    • Excessive resource usage for your organization or enterprise
    • Requests for health checks
    • Help with using Gists, notifications, wikis, {% data variables.product.prodname_pages %}, {% data variables.product.prodname_desktop %}, Atom, or other peripheral services or features with your organization or enterprise
    • Feature requests
    • Product feedback
     |
+|  {% data variables.product.support_ticket_priority_low %}   | You have a question or suggestion about your organization or enterprise on {% data variables.product.prodname_ghe_cloud %} that is not time-sensitive, or does not otherwise block the productivity of your team.                                                                           | 
    • Excessive resource usage for your organization or enterprise
    • Requests for health checks
    • Help with using Gists, notifications, wikis, {% data variables.product.prodname_pages %}, {% data variables.product.prodname_desktop %}, Atom, or other peripheral services or features with your organization or enterprise
    • Feature requests
    • Product feedback
     |
diff --git a/translations/ru-RU/data/reusables/support/ghes-priorities.md b/translations/ru-RU/data/reusables/support/ghes-priorities.md
index 9e2d4c72d554..b67fe6b912f9 100644
--- a/translations/ru-RU/data/reusables/support/ghes-priorities.md
+++ b/translations/ru-RU/data/reusables/support/ghes-priorities.md
@@ -1,6 +1,6 @@
-|                              Priority                              | Description                                                                                                                                                                                                                                              | Примеры                   |
-|:------------------------------------------------------------------:| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
+|                           Priority                            | Description                                                                                                                                                                                                                                    | Примеры                   |
+|:-------------------------------------------------------------:| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
 | {% data variables.product.support_ticket_priority_urgent %} | {% data variables.product.prodname_ghe_server %} is failing in a production environment, and the failure directly impacts the operation of your business.

    _{% data reusables.support.priority-urgent-english-only %}_ | 
    • Errors or outages that affect core Git or web application functionality for all users
    • Severe performance degradation for majority of users
    • Full or rapidly filling storage
    • Inability to install a renewed license file
    • Security incident
    • Loss of administrative access to the instance with no known workaround
    • Failure to restore a backup to a production environment
     |
-|  {% data variables.product.support_ticket_priority_high %}  | {% data variables.product.prodname_ghe_server %} is failing in a production environment, but impact on your business is limited.                                                                                                                  | 
    • Performance degradation that reduces productivity for many users
    • Reduced redundancy from failure of High Availability (HA) or cluster nodes
    • Failure to back up instance
    • Failure to restore a backup to a test or staging environment that could compromise successful restoration to a production environment
     |
-| {% data variables.product.support_ticket_priority_normal %} | You're experiencing limited or moderate issues with {% data variables.product.prodname_ghe_server %}, or you have general concerns or questions about the operation of your instance.                                                             | 
    • Problems in a test or staging environment
    • Advice on using {% data variables.product.prodname_dotcom %} APIs and features, or questions about configuring third-party integrations from your instance
    • Issues with tools for user data migration that {% data variables.product.company_short %} provides
    • Улучшения
    • Bug reports
    • Features not working as expected
    • General security questions
     |
-|  {% data variables.product.support_ticket_priority_low %}   | You have a question or suggestion about {% data variables.product.prodname_ghe_server %} that is not time-sensitive, or does not otherwise block the productivity of your team.                                                                   | 
    • Feature requests
    • Product feedback
    • Requests for health checks (available for customers with a {% data variables.product.premium_support_plan %} only at this time)
    • Notifying {% data variables.product.company_short %} of planned maintenance on your instance
     |
+|  {% data variables.product.support_ticket_priority_high %}  | {% data variables.product.prodname_ghe_server %} is failing in a production environment, but impact on your business is limited.                                                                                                             | 
    • Performance degradation that reduces productivity for many users
    • Reduced redundancy from failure of High Availability (HA) or cluster nodes
    • Failure to back up instance
    • Failure to restore a backup to a test or staging environment that could compromise successful restoration to a production environment
     |
+| {% data variables.product.support_ticket_priority_normal %} | You're experiencing limited or moderate issues with {% data variables.product.prodname_ghe_server %}, or you have general concerns or questions about the operation of your instance.                                                        | 
    • Problems in a test or staging environment
    • Advice on using {% data variables.product.prodname_dotcom %} APIs and features, or questions about configuring third-party integrations from your instance
    • Issues with tools for user data migration that {% data variables.product.company_short %} provides
    • Улучшения
    • Bug reports
    • Features not working as expected
    • General security questions
     |
+|  {% data variables.product.support_ticket_priority_low %}   | You have a question or suggestion about {% data variables.product.prodname_ghe_server %} that is not time-sensitive, or does not otherwise block the productivity of your team.                                                              | 
    • Feature requests
    • Product feedback
    • Requests for health checks (available for customers with a {% data variables.product.premium_support_plan %} only at this time)
    • Notifying {% data variables.product.company_short %} of planned maintenance on your instance
     |
diff --git a/translations/ru-RU/data/reusables/support/priority-urgent-english-only.md b/translations/ru-RU/data/reusables/support/priority-urgent-english-only.md
index a33de1c4dfdb..17c2e6a1565d 100644
--- a/translations/ru-RU/data/reusables/support/priority-urgent-english-only.md
+++ b/translations/ru-RU/data/reusables/support/priority-urgent-english-only.md
@@ -1 +1 @@
-Support for tickets with {% data variables.product.support_ticket_priority_urgent %} priority is only available in the English language.
\ No newline at end of file
+Support for tickets with {% data variables.product.support_ticket_priority_urgent %} priority is only available in the English language.
diff --git a/translations/ru-RU/data/reusables/support/service-level-agreement-response-times.md b/translations/ru-RU/data/reusables/support/service-level-agreement-response-times.md
index 89188a659fe7..145cd883c449 100644
--- a/translations/ru-RU/data/reusables/support/service-level-agreement-response-times.md
+++ b/translations/ru-RU/data/reusables/support/service-level-agreement-response-times.md
@@ -2,7 +2,7 @@
 
 For tickets you submit, support is available 24 hours a day, 7 days per week. The initial response time guaranteed by the SLA is dependent on the priority level of the ticket. Response time begins when {% data variables.contact.premium_support %} sets the priority level of the ticket. A response does not mean the issue has been resolved.
 
-| Ticket priority level                                              | Initial response time |
-| ------------------------------------------------------------------ | --------------------- |
+| Ticket priority level                                         | Initial response time |
+| ------------------------------------------------------------- | --------------------- |
 | {% data variables.product.support_ticket_priority_urgent %} | 30 minutes            |
 | {% data variables.product.support_ticket_priority_high %}   | 4 hours               |
diff --git a/translations/ru-RU/data/reusables/two_fa/about-2fa.md b/translations/ru-RU/data/reusables/two_fa/about-2fa.md
new file mode 100644
index 000000000000..704cb699cc2e
--- /dev/null
+++ b/translations/ru-RU/data/reusables/two_fa/about-2fa.md
@@ -0,0 +1 @@
+Two-factor authentication (2FA) is an extra layer of security used when logging into websites or apps.
diff --git a/translations/ru-RU/data/reusables/two_fa/after-2fa-add-security-key.md b/translations/ru-RU/data/reusables/two_fa/after-2fa-add-security-key.md
index 12b44b4dba0e..271169e10a7a 100644
--- a/translations/ru-RU/data/reusables/two_fa/after-2fa-add-security-key.md
+++ b/translations/ru-RU/data/reusables/two_fa/after-2fa-add-security-key.md
@@ -1 +1 @@
-After you configure 2FA using a mobile app{% if currentVersion == "free-pro-team@latest" %} or via text message{% endif %}, you can add a security key, like a fingerprint reader or Windows Hello. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}The technology that enables authentication with a security key is called WebAuthn. WebAuthn is the successor to U2F and works in all modern browsers. For more information, see "[WebAuthn](https://webauthn.guide/)" and "[Can I Use](https://caniuse.com/#search=webauthn)."{% else %}FIDO U2F authentication is currently available for the Chrome, Firefox, and Opera browsers.{% endif %}
+After you configure 2FA using a mobile app{% if currentVersion == "free-pro-team@latest" %} or via text message{% endif %}, you can add a security key, like a fingerprint reader or Windows Hello. The technology that enables authentication with a security key is called WebAuthn. WebAuthn is the successor to U2F and works in all modern browsers. For more information, see "[WebAuthn](https://webauthn.guide/)" and "[Can I Use](https://caniuse.com/#search=webauthn)."
diff --git a/translations/ru-RU/data/reusables/two_fa/auth_methods_2fa.md b/translations/ru-RU/data/reusables/two_fa/auth_methods_2fa.md
index 2addec071862..35524bd9bad5 100644
--- a/translations/ru-RU/data/reusables/two_fa/auth_methods_2fa.md
+++ b/translations/ru-RU/data/reusables/two_fa/auth_methods_2fa.md
@@ -1,10 +1,10 @@
 {% if currentVersion != "free-pro-team@latest" %}
 ### Authentication methods that support 2FA
 
-| Authentication Method                             | Description                                                                                                                                 | Two-factor authentication support                                                                                                                                                                                             |
-| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Authentication Method                             | Description                                                                                                                            | Two-factor authentication support                                                                                                                                                                                                        |
+| ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Built-in                                          | Authentication is performed against user accounts that are stored on the {% data variables.product.prodname_ghe_server %} appliance. | Supported and managed on the {% data variables.product.prodname_ghe_server %} appliance. Organization administrators can require 2FA to be enabled for members of the organization. |{% if currentVersion != "free-pro-team@latest" %}
-| Built-in authentication with an identity provider | Authentication is performed against user accounts that are stored on the identity provider.                                                 | Dependant on the identity provider.{% endif %}
-| LDAP                                              | Allows integration with your company directory service for authentication.                                                                  | Supported and managed on the {% data variables.product.prodname_ghe_server %} appliance. Organization administrators can require 2FA to be enabled for members of the organization.                                    |
-| SAML                                              | Authentication is performed on an external identity provider.                                                                               | {% data reusables.two_fa.2fa_not_supported_with_saml_and_cas %}                                                                                                                                                    |
-| CAS                                               | Single sign-on service is provided by an external server.                                                                                   | {% data reusables.two_fa.2fa_not_supported_with_saml_and_cas %}{% endif %}
+| Built-in authentication with an identity provider | Authentication is performed against user accounts that are stored on the identity provider.                                            | Dependant on the identity provider.{% endif %}
+| LDAP                                              | Allows integration with your company directory service for authentication.                                                             | Supported and managed on the {% data variables.product.prodname_ghe_server %} appliance. Organization administrators can require 2FA to be enabled for members of the organization.                                                    |
+| SAML                                              | Authentication is performed on an external identity provider.                                                                          | {% data reusables.two_fa.2fa_not_supported_with_saml_and_cas %}
+| CAS                                               | Single sign-on service is provided by an external server.                                                                              | {% data reusables.two_fa.2fa_not_supported_with_saml_and_cas %}{% endif %}
diff --git a/translations/ru-RU/data/reusables/user_settings/export-data.md b/translations/ru-RU/data/reusables/user_settings/export-data.md
index 829998c0239c..857cba63b9c9 100644
--- a/translations/ru-RU/data/reusables/user_settings/export-data.md
+++ b/translations/ru-RU/data/reusables/user_settings/export-data.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-You can export and review the metadata that {% data variables.product.product_name %} stores about your personal account.
+You can export and review the metadata that
+{% data variables.product.product_name %} stores about your personal account.
 {% endif %}
diff --git a/translations/ru-RU/data/reusables/user_settings/password-authentication-deprecation.md b/translations/ru-RU/data/reusables/user_settings/password-authentication-deprecation.md
index 247a5f7442f4..ade0a4e28d59 100644
--- a/translations/ru-RU/data/reusables/user_settings/password-authentication-deprecation.md
+++ b/translations/ru-RU/data/reusables/user_settings/password-authentication-deprecation.md
@@ -1 +1 @@
-Password-based authentication for Git is deprecated, and we recommend using a personal access token (PAT) when prompted for a password instead, which is more secure. Treat your token just like a password. For more information, see "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token)."
\ No newline at end of file
+Password-based authentication for Git is deprecated, and we recommend using a personal access token (PAT) when prompted for a password instead, which is more secure. Treat your token just like a password. For more information, see "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token)."
diff --git a/translations/ru-RU/data/reusables/user_settings/sudo-mode-popup.md b/translations/ru-RU/data/reusables/user_settings/sudo-mode-popup.md
index 5e8aad086348..32f716ffacac 100644
--- a/translations/ru-RU/data/reusables/user_settings/sudo-mode-popup.md
+++ b/translations/ru-RU/data/reusables/user_settings/sudo-mode-popup.md
@@ -1 +1 @@
-1. If prompted, confirm your {% data variables.product.product_name %} password. ![Sudo mode dialog](/assets/images/help/settings/sudo_mode_popup.png)
\ No newline at end of file
+1. If prompted, confirm your {% data variables.product.product_name %} password. ![Sudo mode dialog](/assets/images/help/settings/sudo_mode_popup.png)
diff --git a/translations/ru-RU/data/reusables/webhooks/action_type_desc.md b/translations/ru-RU/data/reusables/webhooks/action_type_desc.md
index 3342e6e1c6ec..43e5cb80e4f5 100644
--- a/translations/ru-RU/data/reusables/webhooks/action_type_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/action_type_desc.md
@@ -1 +1 @@
-The type of activity is specified in the `action` property of the payload object.
\ No newline at end of file
+The type of activity is specified in the `action` property of the payload object.
diff --git a/translations/ru-RU/data/reusables/webhooks/app_desc.md b/translations/ru-RU/data/reusables/webhooks/app_desc.md
index 9dbfd79e4d6f..e81bab2cf4dc 100644
--- a/translations/ru-RU/data/reusables/webhooks/app_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/app_desc.md
@@ -1 +1 @@
-`installation` | `object` | The {% data variables.product.prodname_github_app %} installation. Webhook payloads contain the `installation` property when the event is configured for and sent to a {% data variables.product.prodname_github_app %}.
\ No newline at end of file
+`installation` | `object` | The {% data variables.product.prodname_github_app %} installation. Webhook payloads contain the `installation` property when the event is configured for and sent to a {% data variables.product.prodname_github_app %}.
diff --git a/translations/ru-RU/data/reusables/webhooks/check_run_properties.md b/translations/ru-RU/data/reusables/webhooks/check_run_properties.md
index 8c9768f72d93..f4db03dd4549 100644
--- a/translations/ru-RU/data/reusables/webhooks/check_run_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/check_run_properties.md
@@ -1,10 +1,10 @@
-| Клавиша                        | Тип       | Description                                                                                                                                                                                                                                                                                                           |
-| ------------------------------ | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `действие`                     | `строка`  | The action performed. Can be one of: 
    •  `created` - A new check run was created.
    •  `completed` - The `status` of the check run is `completed`.
    •  `rerequested` - Someone requested to re-run your check run from the pull request UI. See "[About status checks](/articles/about-status-checks#checks)" for more details about the GitHub UI. When you receive a `rerequested` action, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run). Only the {% data variables.product.prodname_github_app %} that someone requests to re-run the check will receive the `rerequested` payload.
    •  `requested_action` - Someone requested an action your app provides to be taken. Only the {% data variables.product.prodname_github_app %} someone requests to perform an action will receive the `requested_action` payload. To learn more about check runs and requested actions, see "[Check runs and requested actions](/v3/checks/runs/#check-runs-and-requested-actions)."
                                                                                                                                                                                                                                                             |
-| `check_run`                    | `объект`  | The [check_run](/v3/checks/runs/#get-a-check-run).                                                                                                                                                                                                                                                                    |
-| `check_run[status]`            | `строка`  | The current status of the check run. Can be `queued`, `in_progress`, or `completed`.                                                                                                                                                                                                                                  |
+| Клавиша                        | Тип       | Description                                                                                                                                                                                                                                                                                                                                               |
+| ------------------------------ | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `действие`                     | `строка`  | The action performed. Can be one of: 
    •  `created` - A new check run was created.
    •  `completed` - The `status` of the check run is `completed`.
    •  `rerequested` - Someone requested to re-run your check run from the pull request UI. See "[About status checks](/articles/about-status-checks#checks)" for more details about the GitHub UI. When you receive a `rerequested` action, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run). Only the {% data variables.product.prodname_github_app %} that someone requests to re-run the check will receive the `rerequested` payload.
    •  `requested_action` - Someone requested an action your app provides to be taken. Only the {% data variables.product.prodname_github_app %} someone requests to perform an action will receive the `requested_action` payload. To learn more about check runs and requested actions, see "[Check runs and requested actions](/v3/checks/runs/#check-runs-and-requested-actions)."
                                                                                                                                                                                                                                                                                                 |
+| `check_run`                    | `объект`  | The [check_run](/v3/checks/runs/#get-a-check-run).                                                                                                                                                                                                                                                                                                        |
+| `check_run[status]`            | `строка`  | The current status of the check run. Can be `queued`, `in_progress`, or `completed`.                                                                                                                                                                                                                                                                      |
 | `check_run[conclusion]`        | `строка`  | The result of the completed check run. Can be one of `success`, `failure`, `neutral`, `cancelled`, `timed_out`,  {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}`action_required` or `stale`{% else %}or `action_required`{% endif %}. This value will be `null` until the check run has `completed`. |
-| `check_run[name]`              | `строка`  | The name of the check run.                                                                                                                                                                                                                                                                                            |
-| `check_run[check_suite][id]`   | `integer` | The id of the check suite that this check run is part of.                                                                                                                                                                                                                                                             |
-| `requested_action`             | `объект`  | The action requested by the user.                                                                                                                                                                                                                                                                                     |
-| `requested_action[identifier]` | `строка`  | The integrator reference of the action requested by the user.                                                                                                                                                                                                                                                         |
\ No newline at end of file
+| `check_run[name]`              | `строка`  | The name of the check run.                                                                                                                                                                                                                                                                                                                                |
+| `check_run[check_suite][id]`   | `integer` | The id of the check suite that this check run is part of.                                                                                                                                                                                                                                                                                                 |
+| `requested_action`             | `объект`  | The action requested by the user.                                                                                                                                                                                                                                                                                                                         |
+| `requested_action[identifier]` | `строка`  | The integrator reference of the action requested by the user.                                                                                                                                                                                                                                                                                             |
diff --git a/translations/ru-RU/data/reusables/webhooks/check_run_short_desc.md b/translations/ru-RU/data/reusables/webhooks/check_run_short_desc.md
index 305bd1626e33..19fd0846b885 100644
--- a/translations/ru-RU/data/reusables/webhooks/check_run_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/check_run_short_desc.md
@@ -1 +1 @@
-Check run activity has occurred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[check runs](/v3/checks/runs/)" REST API.
\ No newline at end of file
+Check run activity has occurred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[check runs](/v3/checks/runs/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/check_suite_properties.md b/translations/ru-RU/data/reusables/webhooks/check_suite_properties.md
index f9b7f26d283b..0017e1df0b7d 100644
--- a/translations/ru-RU/data/reusables/webhooks/check_suite_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/check_suite_properties.md
@@ -1,10 +1,10 @@
-| Клавиша                      | Тип      | Description                                                                                                                                                                                                                                                                                                                                                |
-| ---------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `действие`                   | `строка` | The action performed. Can be:
    • `completed` - All check runs in a check suite have completed.
    • `requested` - Occurs when new code is pushed to the app's repository. When you receive the `requested` action events, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run).
    • `rerequested` - Occurs when someone requests to re-run the entire check suite from the pull request UI. When you receive the `rerequested` action events, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run). See "[About status checks](/articles/about-status-checks#checks)" for more details about the GitHub UI.
                                                                                                                                                                                                                                                                                                         |
-| `check_suite`                | `объект` | The [check_suite](/v3/checks/suites/).                                                                                                                                                                                                                                                                                                                     |
-| `check_suite[head_branch]`   | `строка` | The head branch name the changes are on.                                                                                                                                                                                                                                                                                                                   |
-| `check_suite[head_sha]`      | `строка` | The SHA of the most recent commit for this check suite.                                                                                                                                                                                                                                                                                                    |
-| `check_suite[status]`        | `строка` | The summary status for all check runs that are part of the check suite. Can be `requested`, `in_progress`, or `completed`.                                                                                                                                                                                                                                 |
+| Клавиша                      | Тип      | Description                                                                                                                                                                                                                                                                                                                                                                                    |
+| ---------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `действие`                   | `строка` | The action performed. Can be:
    • `completed` - All check runs in a check suite have completed.
    • `requested` - Occurs when new code is pushed to the app's repository. When you receive the `requested` action events, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run).
    • `rerequested` - Occurs when someone requests to re-run the entire check suite from the pull request UI. When you receive the `rerequested` action events, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run). See "[About status checks](/articles/about-status-checks#checks)" for more details about the GitHub UI.
                                                                                                                                                                                                                                                                                                                                             |
+| `check_suite`                | `объект` | The [check_suite](/v3/checks/suites/).                                                                                                                                                                                                                                                                                                                                                         |
+| `check_suite[head_branch]`   | `строка` | The head branch name the changes are on.                                                                                                                                                                                                                                                                                                                                                       |
+| `check_suite[head_sha]`      | `строка` | The SHA of the most recent commit for this check suite.                                                                                                                                                                                                                                                                                                                                        |
+| `check_suite[status]`        | `строка` | The summary status for all check runs that are part of the check suite. Can be `requested`, `in_progress`, or `completed`.                                                                                                                                                                                                                                                                     |
 | `check_suite[conclusion]`    | `строка` | The summary conclusion for all check runs that are part of the check suite. Can be one of `success`, `failure`, `neutral`, `cancelled`, `timed_out`,  {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}`action_required` or `stale`{% else %}or `action_required`{% endif %}. This value will be `null` until the check run has `completed`. |
-| `check_suite[url]`           | `строка` | URL that points to the check suite API resource.                                                                                                                                                                                                                                                                                                           |
-| `check_suite[pull_requests]` | `array`  | An array of pull requests that match this check suite. A pull request matches a check suite if they have the same `head_sha` and `head_branch`. When the check suite's `head_branch` is in a forked repository it will be `null` and the `pull_requests` array will be empty.                                                                              |
\ No newline at end of file
+| `check_suite[url]`           | `строка` | URL that points to the check suite API resource.                                                                                                                                                                                                                                                                                                                                               |
+| `check_suite[pull_requests]` | `array`  | An array of pull requests that match this check suite. A pull request matches a check suite if they have the same `head_sha` and `head_branch`. When the check suite's `head_branch` is in a forked repository it will be `null` and the `pull_requests` array will be empty.                                                                                                                  |
diff --git a/translations/ru-RU/data/reusables/webhooks/check_suite_short_desc.md b/translations/ru-RU/data/reusables/webhooks/check_suite_short_desc.md
index f7197fc59e48..00c4c00937f9 100644
--- a/translations/ru-RU/data/reusables/webhooks/check_suite_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/check_suite_short_desc.md
@@ -1 +1 @@
-Check suite activity has occurred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[check suites](/v3/checks/suites/)" REST API.
\ No newline at end of file
+Check suite activity has occurred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[check suites](/v3/checks/suites/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/code_scanning_alert_event_short_desc.md b/translations/ru-RU/data/reusables/webhooks/code_scanning_alert_event_short_desc.md
index e246022ed42e..e5163ce2d013 100644
--- a/translations/ru-RU/data/reusables/webhooks/code_scanning_alert_event_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/code_scanning_alert_event_short_desc.md
@@ -1 +1 @@
-Activity related to code scanning alerts in a repository. The type of activity is specified in the action property of the payload object. For more information, see “[About code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning).”
\ No newline at end of file
+Activity related to code scanning alerts in a repository. The type of activity is specified in the action property of the payload object. For more information, see “[About code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning).”
diff --git a/translations/ru-RU/data/reusables/webhooks/commit_comment_properties.md b/translations/ru-RU/data/reusables/webhooks/commit_comment_properties.md
index 1d317d13ce84..80abdd278967 100644
--- a/translations/ru-RU/data/reusables/webhooks/commit_comment_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/commit_comment_properties.md
@@ -1,4 +1,4 @@
 | Клавиша       | Тип      | Description                                                              |
 | ------------- | -------- | ------------------------------------------------------------------------ |
 | `действие`    | `строка` | The action performed. Can be `created`.                                  |
-| `комментарий` | `объект` | The [commit comment](/v3/repos/comments/#get-a-commit-comment) resource. |
\ No newline at end of file
+| `комментарий` | `объект` | The [commit comment](/v3/repos/comments/#get-a-commit-comment) resource. |
diff --git a/translations/ru-RU/data/reusables/webhooks/commit_comment_short_desc.md b/translations/ru-RU/data/reusables/webhooks/commit_comment_short_desc.md
index 918e0279b925..20e258a1ea1f 100644
--- a/translations/ru-RU/data/reusables/webhooks/commit_comment_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/commit_comment_short_desc.md
@@ -1 +1 @@
-A commit comment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[commit comment](/v3/repos/comments/)" REST API.
\ No newline at end of file
+A commit comment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[commit comment](/v3/repos/comments/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/content_reference_short_desc.md b/translations/ru-RU/data/reusables/webhooks/content_reference_short_desc.md
index b7880d039d3a..5187dbb40bc8 100644
--- a/translations/ru-RU/data/reusables/webhooks/content_reference_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/content_reference_short_desc.md
@@ -1 +1 @@
-A new content reference is `created`. A new content reference is created when the body or comment of an issue or pull request includes a URL that matches a configured content reference domain. For more information, see "[Using content attachments](/apps/using-content-attachments/)" to learn more about content references and attachments.
\ No newline at end of file
+A new content reference is `created`. A new content reference is created when the body or comment of an issue or pull request includes a URL that matches a configured content reference domain. For more information, see "[Using content attachments](/apps/using-content-attachments/)" to learn more about content references and attachments.
diff --git a/translations/ru-RU/data/reusables/webhooks/create_properties.md b/translations/ru-RU/data/reusables/webhooks/create_properties.md
index 5ddff2bb284f..1e5141b957d8 100644
--- a/translations/ru-RU/data/reusables/webhooks/create_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/create_properties.md
@@ -1,6 +1,6 @@
-| Клавиша         | Тип      | Description                                                                                                                                                                                          |
-| --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `ref`           | `строка` | {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}The [`git ref`](/v3/git/refs/#get-a-reference) resource.{% else %}The [`git ref`](/v3/git/refs/#get-a-reference) resource.{% endif %}
-| `ref_type`      | `строка` | The type of Git ref object created in the repository. Can be either `branch` or `tag`.                                                                                                               |
-| `master_branch` | `строка` | The name of the repository's default branch (usually `master`).                                                                                                                                      |
-| `описание`      | `строка` | The repository's current description.                                                                                                                                                                |
\ No newline at end of file
+| Клавиша         | Тип      | Description                                                                                                                                                                                   |
+| --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `ref`           | `строка` | The [`git ref`](/v3/git/refs/#get-a-reference) resource.                                                                                                                                      |
+| `ref_type`      | `строка` | The type of Git ref object created in the repository. Can be either `branch` or `tag`.                                                                                                        |
+| `master_branch` | `строка` | The name of the repository's default branch (usually {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.23" %}`main`{% else %}`master`{% endif %}). |
+| `описание`      | `строка` | The repository's current description.                                                                                                                                                         |
diff --git a/translations/ru-RU/data/reusables/webhooks/create_short_desc.md b/translations/ru-RU/data/reusables/webhooks/create_short_desc.md
index 0140bfadf5c2..a43ab3994391 100644
--- a/translations/ru-RU/data/reusables/webhooks/create_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/create_short_desc.md
@@ -1 +1 @@
-A Git branch or tag is created. For more information, see the "[Git data](/v3/git/)" REST API.
\ No newline at end of file
+A Git branch or tag is created. For more information, see the "[Git data](/v3/git/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/delete_properties.md b/translations/ru-RU/data/reusables/webhooks/delete_properties.md
index 3912a3c5722f..0b1055fa4a92 100644
--- a/translations/ru-RU/data/reusables/webhooks/delete_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/delete_properties.md
@@ -1,4 +1,4 @@
-| Клавиша    | Тип      | Description                                                                                                                                                                                          |
-| ---------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `ref`      | `строка` | {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}The [`git ref`](/v3/git/refs/#get-a-reference) resource.{% else %}The [`git ref`](/v3/git/refs/#get-a-reference) resource.{% endif %}
-| `ref_type` | `строка` | The type of Git ref oject deleted in the repository. Can be `branch` or `tag`.                                                                                                                       |
\ No newline at end of file
+| Клавиша    | Тип      | Description                                                                    |
+| ---------- | -------- | ------------------------------------------------------------------------------ |
+| `ref`      | `строка` | The [`git ref`](/v3/git/refs/#get-a-reference) resource.                       |
+| `ref_type` | `строка` | The type of Git ref oject deleted in the repository. Can be `branch` or `tag`. |
diff --git a/translations/ru-RU/data/reusables/webhooks/delete_short_desc.md b/translations/ru-RU/data/reusables/webhooks/delete_short_desc.md
index 60568e8b0958..7557d8e4edb3 100644
--- a/translations/ru-RU/data/reusables/webhooks/delete_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/delete_short_desc.md
@@ -1 +1 @@
-A Git branch or tag is deleted. For more information, see the "[Git data](/v3/git/)" REST API.
\ No newline at end of file
+A Git branch or tag is deleted. For more information, see the "[Git data](/v3/git/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/deploy_key_properties.md b/translations/ru-RU/data/reusables/webhooks/deploy_key_properties.md
index c04ce523c70f..6e445bc62465 100644
--- a/translations/ru-RU/data/reusables/webhooks/deploy_key_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/deploy_key_properties.md
@@ -1,4 +1,4 @@
 | Клавиша    | Тип      | Description                                                    |
 | ---------- | -------- | -------------------------------------------------------------- |
 | `действие` | `строка` | The action performed. Can be either `created` or `deleted`.    |
-| `клавиша`  | `объект` | The [`deploy key`](/v3/repos/keys/#get-a-deploy-key) resource. |
\ No newline at end of file
+| `клавиша`  | `объект` | The [`deploy key`](/v3/repos/keys/#get-a-deploy-key) resource. |
diff --git a/translations/ru-RU/data/reusables/webhooks/deploy_key_short_desc.md b/translations/ru-RU/data/reusables/webhooks/deploy_key_short_desc.md
index 551eef44c5cc..c83fe68579c6 100644
--- a/translations/ru-RU/data/reusables/webhooks/deploy_key_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/deploy_key_short_desc.md
@@ -1 +1 @@
-A deploy key is added or removed from a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[Deploy keys](/v3/repos/keys/)" REST API.
\ No newline at end of file
+A deploy key is added or removed from a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[Deploy keys](/v3/repos/keys/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/deployment_short_desc.md b/translations/ru-RU/data/reusables/webhooks/deployment_short_desc.md
index 75683350b9df..249535a29dc8 100644
--- a/translations/ru-RU/data/reusables/webhooks/deployment_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/deployment_short_desc.md
@@ -1 +1 @@
-A deployment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[deployment](/v3/repos/deployments/#list-deployments)" REST API.
\ No newline at end of file
+A deployment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[deployment](/rest/reference/repos#list-deployments)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/deployment_status_short_desc.md b/translations/ru-RU/data/reusables/webhooks/deployment_status_short_desc.md
index 11953ea072e4..d58bd3e0efed 100644
--- a/translations/ru-RU/data/reusables/webhooks/deployment_status_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/deployment_status_short_desc.md
@@ -1 +1 @@
-A deployment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[deployment statuses](/v3/repos/deployments/#list-deployment-statuses)" REST API.
\ No newline at end of file
+A deployment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[deployment statuses](/rest/reference/repos#list-deployment-statuses)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/enterprise_short_desc.md b/translations/ru-RU/data/reusables/webhooks/enterprise_short_desc.md
index 999949bcbb50..07659be69c50 100644
--- a/translations/ru-RU/data/reusables/webhooks/enterprise_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/enterprise_short_desc.md
@@ -1 +1 @@
-A site or repository administrator enables or disables anonymous Git read access. See "[Allowing admins to enable anonymous Git read access to public repositories](/enterprise/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories)" for more details. This event is not available in the Events API.
\ No newline at end of file
+A site or repository administrator enables or disables anonymous Git read access. See "[Allowing admins to enable anonymous Git read access to public repositories](/enterprise/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories)" for more details. This event is not available in the Events API.
diff --git a/translations/ru-RU/data/reusables/webhooks/events_api_payload.md b/translations/ru-RU/data/reusables/webhooks/events_api_payload.md
index b40c9904faf8..d63dfb496eb9 100644
--- a/translations/ru-RU/data/reusables/webhooks/events_api_payload.md
+++ b/translations/ru-RU/data/reusables/webhooks/events_api_payload.md
@@ -1 +1 @@
-The [event object](#event-object-common-properties) includes properties that are common for all events. Each event object includes a `payload` property and the value is unique to each event type. The `payload` object for this event is described below.
\ No newline at end of file
+The [event object](#event-object-common-properties) includes properties that are common for all events. Each event object includes a `payload` property and the value is unique to each event type. The `payload` object for this event is described below.
diff --git a/translations/ru-RU/data/reusables/webhooks/fork_properties.md b/translations/ru-RU/data/reusables/webhooks/fork_properties.md
index 02cc5d0f98d6..c4301b8dfe95 100644
--- a/translations/ru-RU/data/reusables/webhooks/fork_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/fork_properties.md
@@ -1,3 +1,3 @@
 | Клавиша  | Тип      | Description                                                       |
 | -------- | -------- | ----------------------------------------------------------------- |
-| `forkee` | `объект` | The created [`repository`](/v3/repos/#get-a-repository) resource. |
\ No newline at end of file
+| `forkee` | `объект` | The created [`repository`](/v3/repos/#get-a-repository) resource. |
diff --git a/translations/ru-RU/data/reusables/webhooks/fork_short_desc.md b/translations/ru-RU/data/reusables/webhooks/fork_short_desc.md
index a294851f9c96..60f88625b01f 100644
--- a/translations/ru-RU/data/reusables/webhooks/fork_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/fork_short_desc.md
@@ -1 +1 @@
-A user forks a repository. For more information, see the "[forks](/v3/repos/forks/)" REST API.
\ No newline at end of file
+A user forks a repository. For more information, see the "[forks](/v3/repos/forks/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/gollum_properties.md b/translations/ru-RU/data/reusables/webhooks/gollum_properties.md
index 5e4188bca0e4..f000fda63437 100644
--- a/translations/ru-RU/data/reusables/webhooks/gollum_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/gollum_properties.md
@@ -5,4 +5,4 @@
 | `pages[][title]`     | `строка` | The current page title.                                                  |
 | `pages[][action]`    | `строка` | The action that was performed on the page. Can be `created` or `edited`. |
 | `pages[][sha]`       | `строка` | The latest commit SHA of the page.                                       |
-| `pages[][html_url]`  | `строка` | Points to the HTML wiki page.                                            |
\ No newline at end of file
+| `pages[][html_url]`  | `строка` | Points to the HTML wiki page.                                            |
diff --git a/translations/ru-RU/data/reusables/webhooks/gollum_short_desc.md b/translations/ru-RU/data/reusables/webhooks/gollum_short_desc.md
index 88d8dacb57e5..03bef9d2699c 100644
--- a/translations/ru-RU/data/reusables/webhooks/gollum_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/gollum_short_desc.md
@@ -1 +1 @@
-A wiki page is created or updated. For more information, see the "[About wikis](/github/building-a-strong-community/about-wikis)".
\ No newline at end of file
+A wiki page is created or updated. For more information, see the "[About wikis](/github/building-a-strong-community/about-wikis)".
diff --git a/translations/ru-RU/data/reusables/webhooks/installation_properties.md b/translations/ru-RU/data/reusables/webhooks/installation_properties.md
index ff1c5a68fd70..8a33407ba39a 100644
--- a/translations/ru-RU/data/reusables/webhooks/installation_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/installation_properties.md
@@ -1,4 +1,4 @@
 | Клавиша        | Тип      | Description                                                            |
 | -------------- | -------- | ---------------------------------------------------------------------- |
 | `действие`     | `строка` | The action that was performed. Can be one of:
    • `created` - Someone installs a {% data variables.product.prodname_github_app %}.
    • `deleted` - Someone uninstalls a {% data variables.product.prodname_github_app %}
      • {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}
    • `suspend` - Someone suspends a {% data variables.product.prodname_github_app %} installation.
    • `unsuspend` - Someone unsuspends a {% data variables.product.prodname_github_app %} installation.
      • {% endif %}
    • `new_permissions_accepted` - Someone accepts new permissions for a {% data variables.product.prodname_github_app %} installation. When a {% data variables.product.prodname_github_app %} owner requests new permissions, the person who installed the {% data variables.product.prodname_github_app %} must accept the new permissions request. 
     |
-| `repositories` | `array`  | An array of repository objects that the insatllation can access.       |
\ No newline at end of file
+| `repositories` | `array`  | An array of repository objects that the insatllation can access.       |
diff --git a/translations/ru-RU/data/reusables/webhooks/installation_repositories_properties.md b/translations/ru-RU/data/reusables/webhooks/installation_repositories_properties.md
index c565c890bbc9..d63826d2d714 100644
--- a/translations/ru-RU/data/reusables/webhooks/installation_repositories_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/installation_repositories_properties.md
@@ -3,4 +3,4 @@
 | `действие`             | `строка` | The action that was performed. Can be either `added` or `removed`.                    |
 | `repository_selection` | `строка` | The choice of repositories the installation is on. Can be either `selected` or `all`. |
 | `repositories_added`   | `array`  | An array of repository objects, which were added to the installation.                 |
-| `repositories_removed` | `array`  | An array of repository objects, which were removed from the installation.             |
\ No newline at end of file
+| `repositories_removed` | `array`  | An array of repository objects, which were removed from the installation.             |
diff --git a/translations/ru-RU/data/reusables/webhooks/installation_repositories_short_desc.md b/translations/ru-RU/data/reusables/webhooks/installation_repositories_short_desc.md
index b01eeca22efe..63166ba6e220 100644
--- a/translations/ru-RU/data/reusables/webhooks/installation_repositories_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/installation_repositories_short_desc.md
@@ -1 +1 @@
-Activity related to repositories being added to a GitHub App installation. {% data reusables.webhooks.action_type_desc %} For more information, see the "[GitHub App installation](/v3/apps/)" REST API.
\ No newline at end of file
+Activity related to repositories being added to a GitHub App installation. {% data reusables.webhooks.action_type_desc %} For more information, see the "[GitHub App installation](/v3/apps/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/installation_short_desc.md b/translations/ru-RU/data/reusables/webhooks/installation_short_desc.md
index 0a19aef9b5d0..4abc1de643b4 100644
--- a/translations/ru-RU/data/reusables/webhooks/installation_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/installation_short_desc.md
@@ -1 +1 @@
-Activity related to a GitHub App installation. {% data reusables.webhooks.action_type_desc %} For more information, see the "[GitHub App installation](/v3/apps/)" REST API.
\ No newline at end of file
+Activity related to a GitHub App installation. {% data reusables.webhooks.action_type_desc %} For more information, see the "[GitHub App installation](/v3/apps/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/issue_comment_properties.md b/translations/ru-RU/data/reusables/webhooks/issue_comment_properties.md
index 1cc3962f11bf..b983deb16f16 100644
--- a/translations/ru-RU/data/reusables/webhooks/issue_comment_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/issue_comment_properties.md
@@ -1 +1 @@
-`changes`|`object` | The changes to the comment if the action was `edited`. `changes[body][from]` |`string` | The previous version of the body if the action was `edited`. `issue`|`object` | The [issue](/v3/issues/) the comment belongs to. `comment`|`object` | The [comment](/v3/issues/comments/) itself.
\ No newline at end of file
+`changes`|`object` | The changes to the comment if the action was `edited`. `changes[body][from]` |`string` | The previous version of the body if the action was `edited`. `issue`|`object` | The [issue](/v3/issues/) the comment belongs to. `comment`|`object` | The [comment](/v3/issues/comments/) itself.
diff --git a/translations/ru-RU/data/reusables/webhooks/issue_comment_short_desc.md b/translations/ru-RU/data/reusables/webhooks/issue_comment_short_desc.md
index 0c12ec707b62..cc07764d1919 100644
--- a/translations/ru-RU/data/reusables/webhooks/issue_comment_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/issue_comment_short_desc.md
@@ -1 +1 @@
-Activity related to an issue comment. {% data reusables.webhooks.action_type_desc %} For more information, see the "[issue comments](/v3/issues/comments/)" REST API.
\ No newline at end of file
+Activity related to an issue comment. {% data reusables.webhooks.action_type_desc %} For more information, see the "[issue comments](/v3/issues/comments/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/issue_comment_webhook_properties.md b/translations/ru-RU/data/reusables/webhooks/issue_comment_webhook_properties.md
index d172cfe89bea..ec06fad05731 100644
--- a/translations/ru-RU/data/reusables/webhooks/issue_comment_webhook_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/issue_comment_webhook_properties.md
@@ -1,3 +1,3 @@
 | Клавиша    | Тип      | Description                                                                                    |
 | ---------- | -------- | ---------------------------------------------------------------------------------------------- |
-| `действие` | `строка` | The action that was performed on the comment. Can be one of `created`, `edited`, or `deleted`. |
\ No newline at end of file
+| `действие` | `строка` | The action that was performed on the comment. Can be one of `created`, `edited`, or `deleted`. |
diff --git a/translations/ru-RU/data/reusables/webhooks/issue_event_api_properties.md b/translations/ru-RU/data/reusables/webhooks/issue_event_api_properties.md
index 2f7357c5787e..c4076890c0df 100644
--- a/translations/ru-RU/data/reusables/webhooks/issue_event_api_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/issue_event_api_properties.md
@@ -1,3 +1,3 @@
 | Клавиша    | Тип      | Description                                                                                                                       |
 | ---------- | -------- | --------------------------------------------------------------------------------------------------------------------------------- |
-| `действие` | `строка` | The action that was performed. Can be one of `opened`, `closed`, `reopened`, `assigned`, `unassigned`, `labeled`, or `unlabeled`. |
\ No newline at end of file
+| `действие` | `строка` | The action that was performed. Can be one of `opened`, `closed`, `reopened`, `assigned`, `unassigned`, `labeled`, or `unlabeled`. |
diff --git a/translations/ru-RU/data/reusables/webhooks/issue_properties.md b/translations/ru-RU/data/reusables/webhooks/issue_properties.md
index 84db05eb2bfe..c146faa96802 100644
--- a/translations/ru-RU/data/reusables/webhooks/issue_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/issue_properties.md
@@ -1 +1 @@
-`issue`|`object` | The [issue](/v3/issues) itself. `changes`|`object`| The changes to the issue if the action was `edited`. `changes[title][from]`|`string` | The previous version of the title if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `assignee`|`object` | The optional user who was assigned or unassigned from the issue. `label`|`object` | The optional label that was added or removed from the issue.
\ No newline at end of file
+`issue`|`object` | The [issue](/v3/issues) itself. `changes`|`object`| The changes to the issue if the action was `edited`. `changes[title][from]`|`string` | The previous version of the title if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `assignee`|`object` | The optional user who was assigned or unassigned from the issue. `label`|`object` | The optional label that was added or removed from the issue.
diff --git a/translations/ru-RU/data/reusables/webhooks/issue_webhook_properties.md b/translations/ru-RU/data/reusables/webhooks/issue_webhook_properties.md
index 9197cee2f7bb..4694d8e2374a 100644
--- a/translations/ru-RU/data/reusables/webhooks/issue_webhook_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/issue_webhook_properties.md
@@ -1,3 +1,3 @@
 | Клавиша    | Тип      | Description                                                                                                                                                                                                                                      |
 | ---------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `действие` | `строка` | The action that was performed. Can be one of `opened`, `edited`, `deleted`, `pinned`, `unpinned`, `closed`, `reopened`, `assigned`, `unassigned`, `labeled`, `unlabeled`, `locked`, `unlocked`,  `transferred`, `milestoned`, or `demilestoned`. |
\ No newline at end of file
+| `действие` | `строка` | The action that was performed. Can be one of `opened`, `edited`, `deleted`, `pinned`, `unpinned`, `closed`, `reopened`, `assigned`, `unassigned`, `labeled`, `unlabeled`, `locked`, `unlocked`,  `transferred`, `milestoned`, or `demilestoned`. |
diff --git a/translations/ru-RU/data/reusables/webhooks/issues_short_desc.md b/translations/ru-RU/data/reusables/webhooks/issues_short_desc.md
index fea9fc0cfcd8..7dadec073bb6 100644
--- a/translations/ru-RU/data/reusables/webhooks/issues_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/issues_short_desc.md
@@ -1 +1 @@
-Activity related to an issue. {% data reusables.webhooks.action_type_desc %} For more information, see the "[issues](/v3/issues/comments/)" REST API.
\ No newline at end of file
+Activity related to an issue. {% data reusables.webhooks.action_type_desc %} For more information, see the "[issues](/v3/issues/comments/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/label_short_desc.md b/translations/ru-RU/data/reusables/webhooks/label_short_desc.md
index ca095139a6d2..c5f7178d8a4c 100644
--- a/translations/ru-RU/data/reusables/webhooks/label_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/label_short_desc.md
@@ -1 +1 @@
-Activity related to an issue. {% data reusables.webhooks.action_type_desc %} For more information, see the "[labels](/v3/issues/labels/)" REST API.
\ No newline at end of file
+Activity related to an issue. {% data reusables.webhooks.action_type_desc %} For more information, see the "[labels](/v3/issues/labels/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/member_event_api_properties.md b/translations/ru-RU/data/reusables/webhooks/member_event_api_properties.md
index 8aa35774752f..2eec2ed756ed 100644
--- a/translations/ru-RU/data/reusables/webhooks/member_event_api_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/member_event_api_properties.md
@@ -1,3 +1,3 @@
 | Клавиша    | Тип      | Description                                                                                              |
 | ---------- | -------- | -------------------------------------------------------------------------------------------------------- |
-| `действие` | `строка` | The action that was performed. Can be `added` to indicate a user accepted an invitation to a repository. |
\ No newline at end of file
+| `действие` | `строка` | The action that was performed. Can be `added` to indicate a user accepted an invitation to a repository. |
diff --git a/translations/ru-RU/data/reusables/webhooks/member_properties.md b/translations/ru-RU/data/reusables/webhooks/member_properties.md
index 7fde9d65f4b7..d9e1757f404e 100644
--- a/translations/ru-RU/data/reusables/webhooks/member_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/member_properties.md
@@ -1 +1 @@
-`member`|`object` | The [user](/v3/users/) that was added. `changes`|`object`| The changes to the collaborator permissions if the action was `edited`. `changes[old_permission][from]`|`string` | The previous permissions of the collaborator if the action was `edited`.
\ No newline at end of file
+`member`|`object` | The [user](/v3/users/) that was added. `changes`|`object`| The changes to the collaborator permissions if the action was `edited`. `changes[old_permission][from]`|`string` | The previous permissions of the collaborator if the action was `edited`.
diff --git a/translations/ru-RU/data/reusables/webhooks/member_short_desc.md b/translations/ru-RU/data/reusables/webhooks/member_short_desc.md
index 9447f245ed0a..2e8289677381 100644
--- a/translations/ru-RU/data/reusables/webhooks/member_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/member_short_desc.md
@@ -1 +1 @@
-Activity related to repository collaborators. {% data reusables.webhooks.action_type_desc %} For more information, see the "[collaborators](/v3/repos/collaborators/)" REST API.
\ No newline at end of file
+Activity related to repository collaborators. {% data reusables.webhooks.action_type_desc %} For more information, see the "[collaborators](/v3/repos/collaborators/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/member_webhook_properties.md b/translations/ru-RU/data/reusables/webhooks/member_webhook_properties.md
index b08a77dd8131..63d97483706f 100644
--- a/translations/ru-RU/data/reusables/webhooks/member_webhook_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/member_webhook_properties.md
@@ -1,3 +1,3 @@
 | Клавиша    | Тип      | Description                                                            |
 | ---------- | -------- | ---------------------------------------------------------------------- |
-| `действие` | `строка` | The action that was performed. Can be one of:
    •  `added` - A user accepts an invitation to a repository.
    • `removed` - A user is removed as a collaborator in a repository.
    • `edited` - A user's collaborator permissios have changed. 
     |
\ No newline at end of file
+| `действие` | `строка` | The action that was performed. Can be one of:
    •  `added` - A user accepts an invitation to a repository.
    • `removed` - A user is removed as a collaborator in a repository.
    • `edited` - A user's collaborator permissios have changed. 
     |
diff --git a/translations/ru-RU/data/reusables/webhooks/membership_properties.md b/translations/ru-RU/data/reusables/webhooks/membership_properties.md
index bac9357ac93c..71701a5425ff 100644
--- a/translations/ru-RU/data/reusables/webhooks/membership_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/membership_properties.md
@@ -3,4 +3,4 @@
 | `действие` | `строка` | The action that was performed. Can be `added` or `removed`. |
 | `область`  | `строка` | The scope of the membership. Currently, can only be `team`. |
 | `участник` | `объект` | The [user](/v3/users/) that was added or removed.           |
-| `команда`  | `объект` | The [team](/v3/teams/) for the membership.                  |
\ No newline at end of file
+| `команда`  | `объект` | The [team](/v3/teams/) for the membership.                  |
diff --git a/translations/ru-RU/data/reusables/webhooks/membership_short_desc.md b/translations/ru-RU/data/reusables/webhooks/membership_short_desc.md
index 4ffa7e0d72c0..e557eea9026a 100644
--- a/translations/ru-RU/data/reusables/webhooks/membership_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/membership_short_desc.md
@@ -1 +1 @@
-Activity related to team membership. {% data reusables.webhooks.action_type_desc %} For more information, see the "[team members](/v3/teams/members/)" REST API.
\ No newline at end of file
+Activity related to team membership. {% data reusables.webhooks.action_type_desc %} For more information, see the "[team members](/v3/teams/members/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/milestone_properties.md b/translations/ru-RU/data/reusables/webhooks/milestone_properties.md
index 6492a1496c31..abdd13193ad5 100644
--- a/translations/ru-RU/data/reusables/webhooks/milestone_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/milestone_properties.md
@@ -5,4 +5,4 @@
 | `changes`                    | `объект` | The changes to the milestone if the action was `edited`.                                            |
 | `changes[description][from]` | `строка` | The previous version of the description if the action was `edited`.                                 |
 | `changes[due_on][from]`      | `строка` | The previous version of the due date if the action was `edited`.                                    |
-| `changes[title][from]`       | `строка` | The previous version of the title if the action was `edited`.                                       |
\ No newline at end of file
+| `changes[title][from]`       | `строка` | The previous version of the title if the action was `edited`.                                       |
diff --git a/translations/ru-RU/data/reusables/webhooks/milestone_short_desc.md b/translations/ru-RU/data/reusables/webhooks/milestone_short_desc.md
index 0e6f857a512a..6b6bd073ceab 100644
--- a/translations/ru-RU/data/reusables/webhooks/milestone_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/milestone_short_desc.md
@@ -1 +1 @@
-Activity related to milestones. {% data reusables.webhooks.action_type_desc %} For more information, see the "[milestones](/v3/issues/milestones/)" REST API.
\ No newline at end of file
+Activity related to milestones. {% data reusables.webhooks.action_type_desc %} For more information, see the "[milestones](/v3/issues/milestones/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/org_block_short_desc.md b/translations/ru-RU/data/reusables/webhooks/org_block_short_desc.md
index 379de19da9fc..7c3896f63c8d 100644
--- a/translations/ru-RU/data/reusables/webhooks/org_block_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/org_block_short_desc.md
@@ -1 +1 @@
-Activity related to people being blocked in an organization. {% data reusables.webhooks.action_type_desc %} For more information, see the "[blocking organization users](/v3/orgs/blocking/)" REST API.
\ No newline at end of file
+Activity related to people being blocked in an organization. {% data reusables.webhooks.action_type_desc %} For more information, see the "[blocking organization users](/v3/orgs/blocking/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/org_desc.md b/translations/ru-RU/data/reusables/webhooks/org_desc.md
index e763e6d6b614..8b344e764cde 100644
--- a/translations/ru-RU/data/reusables/webhooks/org_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/org_desc.md
@@ -1 +1 @@
-`organization` | `object` | Webhook payloads contain the [`organization`](/v3/orgs/#get-an-organization) object when the webhook is configured for an organization or the event occurs from activity in a repository owned by an organization.
\ No newline at end of file
+`organization` | `object` | Webhook payloads contain the [`organization`](/v3/orgs/#get-an-organization) object when the webhook is configured for an organization or the event occurs from activity in a repository owned by an organization.
diff --git a/translations/ru-RU/data/reusables/webhooks/organization_short_desc.md b/translations/ru-RU/data/reusables/webhooks/organization_short_desc.md
index 131d20fc3de8..895b584aaf26 100644
--- a/translations/ru-RU/data/reusables/webhooks/organization_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/organization_short_desc.md
@@ -1 +1 @@
-Activity related to an organization and its members. {% data reusables.webhooks.action_type_desc %} For more information, see the "[organizations](/v3/orgs/)" REST API.
\ No newline at end of file
+Activity related to an organization and its members. {% data reusables.webhooks.action_type_desc %} For more information, see the "[organizations](/v3/orgs/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/package_properties.md b/translations/ru-RU/data/reusables/webhooks/package_properties.md
index b88e93bb56b9..c04c81883b22 100644
--- a/translations/ru-RU/data/reusables/webhooks/package_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/package_properties.md
@@ -1,4 +1,4 @@
 | Клавиша    | Тип      | Description                                                     |
 | ---------- | -------- | --------------------------------------------------------------- |
 | `действие` | `строка` | The action that was performed. Can be `published` or `updated`. |
-| `пакет`    | `объект` | Information about the package.                                  |
\ No newline at end of file
+| `пакет`    | `объект` | Information about the package.                                  |
diff --git a/translations/ru-RU/data/reusables/webhooks/page_build_short_desc.md b/translations/ru-RU/data/reusables/webhooks/page_build_short_desc.md
index 7c5be712c388..dda5755d8870 100644
--- a/translations/ru-RU/data/reusables/webhooks/page_build_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/page_build_short_desc.md
@@ -1 +1 @@
-Represents an attempted build of a GitHub Pages site, whether successful or not. A push to a GitHub Pages enabled branch (`gh-pages` for project pages, `master` for user and organization pages) triggers this event.
\ No newline at end of file
+Represents an attempted build of a {% data variables.product.prodname_pages %} site, whether successful or not. A push to a {% data variables.product.prodname_pages %} enabled branch (`gh-pages` for project pages, the default branch for user and organization pages) triggers this event.
diff --git a/translations/ru-RU/data/reusables/webhooks/payload_url.md b/translations/ru-RU/data/reusables/webhooks/payload_url.md
index 3a3fde655ce3..f48cdfee0e5c 100644
--- a/translations/ru-RU/data/reusables/webhooks/payload_url.md
+++ b/translations/ru-RU/data/reusables/webhooks/payload_url.md
@@ -1 +1 @@
-The payload URL is the URL of the server that will receive the webhook `POST` requests.
\ No newline at end of file
+The payload URL is the URL of the server that will receive the webhook `POST` requests.
diff --git a/translations/ru-RU/data/reusables/webhooks/ping_short_desc.md b/translations/ru-RU/data/reusables/webhooks/ping_short_desc.md
index 8cdd735b78c5..139c6735e2fd 100644
--- a/translations/ru-RU/data/reusables/webhooks/ping_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/ping_short_desc.md
@@ -1 +1 @@
-When you create a new webhook, we'll send you a simple `ping` event to let you know you've set up the webhook correctly. This event isnt stored so it isn't retrievable via the [Events API](/v3/activity/events/). You can trigger a `ping` again by calling the [Ping a repository webhook](/v3/repos/hooks/#ping-a-repository-webhook) endpoint.
+When you create a new webhook, we'll send you a simple `ping` event to let you know you've set up the webhook correctly. This event isnt stored so it isn't retrievable via the [Events API](/rest/reference/activity#ping-a-repository-webhook) endpoint.
diff --git a/translations/ru-RU/data/reusables/webhooks/project_card_properties.md b/translations/ru-RU/data/reusables/webhooks/project_card_properties.md
index 2de8704fd37f..d205b443dbb4 100644
--- a/translations/ru-RU/data/reusables/webhooks/project_card_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/project_card_properties.md
@@ -4,4 +4,4 @@
 | `changes`             | `объект`  | The changes to the project card if the action was `edited` or `converted`.                                                   |
 | `changes[note][from]` | `строка`  | The previous version of the note if the action was `edited` or `converted`.                                                  |
 | `after_id`            | `integer` | The id of the card that this card now follows if the action was "moved". Will be `null` if it is the first card in a column. |
-| `project_card`        | `объект`  | The [project card](/v3/projects/cards) itself.                                                                               |
\ No newline at end of file
+| `project_card`        | `объект`  | The [project card](/v3/projects/cards) itself.                                                                               |
diff --git a/translations/ru-RU/data/reusables/webhooks/project_card_short_desc.md b/translations/ru-RU/data/reusables/webhooks/project_card_short_desc.md
index 3a474c89ecee..bbea9ea6c407 100644
--- a/translations/ru-RU/data/reusables/webhooks/project_card_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/project_card_short_desc.md
@@ -1 +1 @@
-Activity related to project cards. {% data reusables.webhooks.action_type_desc %} For more information, see the "[project cards](/v3/projects/cards)" REST API.
\ No newline at end of file
+Activity related to project cards. {% data reusables.webhooks.action_type_desc %} For more information, see the "[project cards](/v3/projects/cards)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/project_column_properties.md b/translations/ru-RU/data/reusables/webhooks/project_column_properties.md
index 3c9b6d2cd3c4..2d5af9fa1985 100644
--- a/translations/ru-RU/data/reusables/webhooks/project_column_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/project_column_properties.md
@@ -4,4 +4,4 @@
 | `changes`             | `объект`  | The changes to the project column if the action was `edited`.                                                                       |
 | `changes[name][from]` | `строка`  | The previous version of the name if the action was `edited`.                                                                        |
 | `after_id`            | `integer` | The id of the column that this column now follows if the action was "moved". Will be `null` if it is the first column in a project. |
-| `project_column`      | `объект`  | The [project column](/v3/projects/columns) itself.                                                                                  |
\ No newline at end of file
+| `project_column`      | `объект`  | The [project column](/v3/projects/columns) itself.                                                                                  |
diff --git a/translations/ru-RU/data/reusables/webhooks/project_column_short_desc.md b/translations/ru-RU/data/reusables/webhooks/project_column_short_desc.md
index 31cc257267b0..19ac3f6412c8 100644
--- a/translations/ru-RU/data/reusables/webhooks/project_column_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/project_column_short_desc.md
@@ -1 +1 @@
-Activity related to columns in a project board. {% data reusables.webhooks.action_type_desc %} For more information, see the "[project columns](/v3/projects/columns)" REST API.
\ No newline at end of file
+Activity related to columns in a project board. {% data reusables.webhooks.action_type_desc %} For more information, see the "[project columns](/v3/projects/columns)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/project_properties.md b/translations/ru-RU/data/reusables/webhooks/project_properties.md
index 88c5fcd9f0ba..20495d4508c3 100644
--- a/translations/ru-RU/data/reusables/webhooks/project_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/project_properties.md
@@ -4,4 +4,4 @@
 | `changes`             | `объект` | The changes to the project if the action was `edited`.                                                               |
 | `changes[name][from]` | `строка` | The previous version of the name if the action was `edited`.                                                         |
 | `changes[body][from]` | `строка` | The previous version of the body if the action was `edited`.                                                         |
-| `проект`              | `объект` | The [project](/v3/projects/) itself.                                                                                 |
\ No newline at end of file
+| `проект`              | `объект` | The [project](/v3/projects/) itself.                                                                                 |
diff --git a/translations/ru-RU/data/reusables/webhooks/project_short_desc.md b/translations/ru-RU/data/reusables/webhooks/project_short_desc.md
index c5f8a804a47c..6f18da5d6957 100644
--- a/translations/ru-RU/data/reusables/webhooks/project_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/project_short_desc.md
@@ -1 +1 @@
-Activity related to project boards. {% data reusables.webhooks.action_type_desc %} For more information, see the "[projects](/v3/projects)" REST API.
\ No newline at end of file
+Activity related to project boards. {% data reusables.webhooks.action_type_desc %} For more information, see the "[projects](/v3/projects)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/public_short_desc.md b/translations/ru-RU/data/reusables/webhooks/public_short_desc.md
index 925a4bfeddc5..9333dc3841cc 100644
--- a/translations/ru-RU/data/reusables/webhooks/public_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/public_short_desc.md
@@ -1 +1 @@
-When a private repository is made public.  Without a doubt: the best {% data variables.product.product_name %} event. 
\ No newline at end of file
+When a private repository is made public.  Without a doubt: the best {% data variables.product.product_name %} event. 
diff --git a/translations/ru-RU/data/reusables/webhooks/pull_request_event_api_properties.md b/translations/ru-RU/data/reusables/webhooks/pull_request_event_api_properties.md
index 5503d5a4c415..e4d0a68c0927 100644
--- a/translations/ru-RU/data/reusables/webhooks/pull_request_event_api_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/pull_request_event_api_properties.md
@@ -1,3 +1,3 @@
 | Клавиша    | Тип      | Description                                                                                                                                                                                     |
 | ---------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `действие` | `строка` | The action that was performed. Can be one of `opened`, `closed`, `reopened`, `assigned`, `unassigned`, `review_requested`, `review_request_removed`, `labeled`, `unlabeled`, and `synchronize`. |
\ No newline at end of file
+| `действие` | `строка` | The action that was performed. Can be one of `opened`, `closed`, `reopened`, `assigned`, `unassigned`, `review_requested`, `review_request_removed`, `labeled`, `unlabeled`, and `synchronize`. |
diff --git a/translations/ru-RU/data/reusables/webhooks/pull_request_properties.md b/translations/ru-RU/data/reusables/webhooks/pull_request_properties.md
index b2619258bb68..21544ccd9e8d 100644
--- a/translations/ru-RU/data/reusables/webhooks/pull_request_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/pull_request_properties.md
@@ -1 +1 @@
-`number`|`integer` | The pull request number. `changes`|`object`| The changes to the comment if the action was `edited`. `changes[title][from]`|`string` | The previous version of the title if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `pull_request`|`object` | The [pull request](/v3/pulls) itself.
\ No newline at end of file
+`number`|`integer` | The pull request number. `changes`|`object`| The changes to the comment if the action was `edited`. `changes[title][from]`|`string` | The previous version of the title if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `pull_request`|`object` | The [pull request](/v3/pulls) itself.
diff --git a/translations/ru-RU/data/reusables/webhooks/pull_request_review_comment_event_api_properties.md b/translations/ru-RU/data/reusables/webhooks/pull_request_review_comment_event_api_properties.md
index 91745090c43d..a8bcbaee9d9c 100644
--- a/translations/ru-RU/data/reusables/webhooks/pull_request_review_comment_event_api_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/pull_request_review_comment_event_api_properties.md
@@ -1,3 +1,3 @@
 | Клавиша    | Тип      | Description                                                     |
 | ---------- | -------- | --------------------------------------------------------------- |
-| `действие` | `строка` | The action that was performed on the comment. Can be `created`. |
\ No newline at end of file
+| `действие` | `строка` | The action that was performed on the comment. Can be `created`. |
diff --git a/translations/ru-RU/data/reusables/webhooks/pull_request_review_comment_properties.md b/translations/ru-RU/data/reusables/webhooks/pull_request_review_comment_properties.md
index 85341dd38525..a38df37d8c7d 100644
--- a/translations/ru-RU/data/reusables/webhooks/pull_request_review_comment_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/pull_request_review_comment_properties.md
@@ -1 +1 @@
-`changes`|`object`| The changes to the comment if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `pull_request`|`object` | The [pull request](/v3/pulls/) the comment belongs to. `comment`|`object` | The [comment](/v3/pulls/comments) itself.
\ No newline at end of file
+`changes`|`object`| The changes to the comment if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `pull_request`|`object` | The [pull request](/v3/pulls/) the comment belongs to. `comment`|`object` | The [comment](/v3/pulls/comments) itself.
diff --git a/translations/ru-RU/data/reusables/webhooks/pull_request_review_comment_short_desc.md b/translations/ru-RU/data/reusables/webhooks/pull_request_review_comment_short_desc.md
index 0dbf1f6974da..7b05ee9a9a19 100644
--- a/translations/ru-RU/data/reusables/webhooks/pull_request_review_comment_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/pull_request_review_comment_short_desc.md
@@ -1 +1 @@
-Activity related to pull request review comments in the pull request's unified diff. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull request review comments](/v3/pulls/comments/)" REST API.
\ No newline at end of file
+Activity related to pull request review comments in the pull request's unified diff. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull request review comments](/v3/pulls/comments/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/pull_request_review_comment_webhook_properties.md b/translations/ru-RU/data/reusables/webhooks/pull_request_review_comment_webhook_properties.md
index d172cfe89bea..ec06fad05731 100644
--- a/translations/ru-RU/data/reusables/webhooks/pull_request_review_comment_webhook_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/pull_request_review_comment_webhook_properties.md
@@ -1,3 +1,3 @@
 | Клавиша    | Тип      | Description                                                                                    |
 | ---------- | -------- | ---------------------------------------------------------------------------------------------- |
-| `действие` | `строка` | The action that was performed on the comment. Can be one of `created`, `edited`, or `deleted`. |
\ No newline at end of file
+| `действие` | `строка` | The action that was performed on the comment. Can be one of `created`, `edited`, or `deleted`. |
diff --git a/translations/ru-RU/data/reusables/webhooks/pull_request_review_properties.md b/translations/ru-RU/data/reusables/webhooks/pull_request_review_properties.md
index af03f0d10b0b..739e86ca4bab 100644
--- a/translations/ru-RU/data/reusables/webhooks/pull_request_review_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/pull_request_review_properties.md
@@ -3,4 +3,4 @@
 | `действие`            | `строка` | The action that was performed. Can be one of:
    • `submitted` - A pull request review is submitted into a non-pending state.
    • `edited` - The body of a review has been edited.
    • `dismissed` - A review has been dismissed.
     |
 | `pull_request`        | `объект` | The [pull request](/v3/pulls/) the review pertains to.                 |
 | `проверка`            | `объект` | The review that was affected.                                          |
-| `changes[body][from]` | `строка` | The previous version of the body if the action was `edited`.           |
\ No newline at end of file
+| `changes[body][from]` | `строка` | The previous version of the body if the action was `edited`.           |
diff --git a/translations/ru-RU/data/reusables/webhooks/pull_request_review_short_desc.md b/translations/ru-RU/data/reusables/webhooks/pull_request_review_short_desc.md
index a92f0dd3bb24..07b263364d7f 100644
--- a/translations/ru-RU/data/reusables/webhooks/pull_request_review_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/pull_request_review_short_desc.md
@@ -1 +1 @@
-Activity related to pull request reviews. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull request reviews](/v3/pulls/reviews/)" REST API.
\ No newline at end of file
+Activity related to pull request reviews. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull request reviews](/v3/pulls/reviews/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/pull_request_short_desc.md b/translations/ru-RU/data/reusables/webhooks/pull_request_short_desc.md
index c88a5120c8f4..ea9e435d0328 100644
--- a/translations/ru-RU/data/reusables/webhooks/pull_request_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/pull_request_short_desc.md
@@ -1 +1 @@
-Activity related to pull requests. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull requests](/v3/pulls/)" REST API.
\ No newline at end of file
+Activity related to pull requests. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull requests](/v3/pulls/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/pull_request_webhook_properties.md b/translations/ru-RU/data/reusables/webhooks/pull_request_webhook_properties.md
index 9884cfe11907..db0159f7a999 100644
--- a/translations/ru-RU/data/reusables/webhooks/pull_request_webhook_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/pull_request_webhook_properties.md
@@ -1,3 +1,3 @@
 | Клавиша    | Тип      | Description                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | ---------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `действие` | `строка` | The action that was performed. Can be one of  `opened`, `edited`, `closed`, `assigned`, `unassigned`, `review_requested`, `review_request_removed`, `ready_for_review`, `labeled`, `unlabeled`, `synchronize`, `locked`, `unlocked`, or `reopened`. If the action is `closed` and the `merged` key is `false`, the pull request was closed with unmerged commits. If the action is `closed` and the `merged` key is `true`, the pull request was merged. |
\ No newline at end of file
+| `действие` | `строка` | The action that was performed. Can be one of  `opened`, `edited`, `closed`, `assigned`, `unassigned`, `review_requested`, `review_request_removed`, `ready_for_review`, `labeled`, `unlabeled`, `synchronize`, `locked`, `unlocked`, or `reopened`. If the action is `closed` and the `merged` key is `false`, the pull request was closed with unmerged commits. If the action is `closed` and the `merged` key is `true`, the pull request was merged. |
diff --git a/translations/ru-RU/data/reusables/webhooks/push_short_desc.md b/translations/ru-RU/data/reusables/webhooks/push_short_desc.md
index 53583a273873..9d434a42fb49 100644
--- a/translations/ru-RU/data/reusables/webhooks/push_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/push_short_desc.md
@@ -1 +1 @@
-One or more commits are pushed to a repository branch or tag.
\ No newline at end of file
+One or more commits are pushed to a repository branch or tag.
diff --git a/translations/ru-RU/data/reusables/webhooks/release_event_api_properties.md b/translations/ru-RU/data/reusables/webhooks/release_event_api_properties.md
index d1f589ca3605..7ef875fb6821 100644
--- a/translations/ru-RU/data/reusables/webhooks/release_event_api_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/release_event_api_properties.md
@@ -1,3 +1,3 @@
 | Клавиша    | Тип      | Description                                        |
 | ---------- | -------- | -------------------------------------------------- |
-| `действие` | `строка` | The action that was performed. Can be `published`. |
\ No newline at end of file
+| `действие` | `строка` | The action that was performed. Can be `published`. |
diff --git a/translations/ru-RU/data/reusables/webhooks/release_properties.md b/translations/ru-RU/data/reusables/webhooks/release_properties.md
index f9fa6700c8ba..969aefd9d705 100644
--- a/translations/ru-RU/data/reusables/webhooks/release_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/release_properties.md
@@ -1 +1 @@
-`changes[body][from]` |`string` | The previous version of the body if the action was `edited`. `changes[name][from]` |`string` | The previous version of the name if the action was `edited`. `release`|`object` | The [release](/v3/repos/releases/#get-a-release) object.
\ No newline at end of file
+`changes[body][from]` |`string` | The previous version of the body if the action was `edited`. `changes[name][from]` |`string` | The previous version of the name if the action was `edited`. `release`|`object` | The [release](/rest/reference/repos/#get-a-release) object.
diff --git a/translations/ru-RU/data/reusables/webhooks/release_short_desc.md b/translations/ru-RU/data/reusables/webhooks/release_short_desc.md
index b3250fbf11ec..e3a9a3bb3a3c 100644
--- a/translations/ru-RU/data/reusables/webhooks/release_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/release_short_desc.md
@@ -1 +1 @@
-Activity related to a release. {% data reusables.webhooks.action_type_desc %} For more information, see the "[releases](/v3/repos/releases/)" REST API.
\ No newline at end of file
+Activity related to a release. {% data reusables.webhooks.action_type_desc %} For more information, see the "[releases](/v3/repos/releases/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/release_webhook_properties.md b/translations/ru-RU/data/reusables/webhooks/release_webhook_properties.md
index 1b7fc22c48fe..42fcffa99c06 100644
--- a/translations/ru-RU/data/reusables/webhooks/release_webhook_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/release_webhook_properties.md
@@ -1,3 +1,3 @@
-| Клавиша    | Тип      | Description                                                                                                                                                                                                                                                                                                                     |
-| ---------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `действие` | `строка` | The action that was performed. Can be one of:
    • `published`: a release, pre-release, or draft of a release is published
      • {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}
    • `unpublished`: a release or pre-release is deleted
    • `created`: a draft is saved, or a release or pre-release is published without previously being saved as a draft
    • `edited`: a release, pre-release, or draft release is edited
    • `deleted`: a release, pre-release, or draft release is deleted
    • `prereleased`: a pre-release is created
    • `released`: a release or draft of a release is published, or a pre-release is changed to a release
      • {% endif %} |
\ No newline at end of file
+| Клавиша    | Тип      | Description                                                                                                                                                                                                                                           |
+| ---------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `действие` | `строка` | The action that was performed. Can be one of:
      • `published`: a release, pre-release, or draft of a release is published
      • `unpublished`: a release or pre-release is deleted
      • `created`: a draft is saved, or a release or pre-release is published without previously being saved as a draft
      • `edited`: a release, pre-release, or draft release is edited
      • `deleted`: a release, pre-release, or draft release is deleted
      • `prereleased`: a pre-release is created
      • `released`: a release or draft of a release is published, or a pre-release is changed to a release
        •  |
diff --git a/translations/ru-RU/data/reusables/webhooks/repo_desc.md b/translations/ru-RU/data/reusables/webhooks/repo_desc.md
index a61104a4ba83..27cc4f74c02c 100644
--- a/translations/ru-RU/data/reusables/webhooks/repo_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/repo_desc.md
@@ -1 +1 @@
-`repository` | `object` | The [`repository`](/v3/repos/#get-a-repository) where the event occured.
\ No newline at end of file
+`repository` | `object` | The [`repository`](/v3/repos/#get-a-repository) where the event occured.
diff --git a/translations/ru-RU/data/reusables/webhooks/repository_import_properties.md b/translations/ru-RU/data/reusables/webhooks/repository_import_properties.md
index 8b70984ef337..663b4e5a754f 100644
--- a/translations/ru-RU/data/reusables/webhooks/repository_import_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/repository_import_properties.md
@@ -1,3 +1,3 @@
 | Клавиша     | Тип      | Description                                                                             |
 | ----------- | -------- | --------------------------------------------------------------------------------------- |
-| `состояние` | `строка` | The final state of the import. This can be one of `success`, `cancelled`, or `failure`. |
\ No newline at end of file
+| `состояние` | `строка` | The final state of the import. This can be one of `success`, `cancelled`, or `failure`. |
diff --git a/translations/ru-RU/data/reusables/webhooks/repository_import_short_desc.md b/translations/ru-RU/data/reusables/webhooks/repository_import_short_desc.md
index 2d30661c839a..056531b0195c 100644
--- a/translations/ru-RU/data/reusables/webhooks/repository_import_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/repository_import_short_desc.md
@@ -1 +1 @@
-Activity related to a repository being imported to GitHub. {% data reusables.webhooks.action_type_desc %} For more information, see the "[source imports](/v3/migrations/source_imports/)" REST API.
\ No newline at end of file
+Activity related to a repository being imported to GitHub. {% data reusables.webhooks.action_type_desc %} For more information, see the "[source imports](/v3/migrations/source_imports/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/repository_short_desc.md b/translations/ru-RU/data/reusables/webhooks/repository_short_desc.md
index b7c3f660a8a0..df290ac0ea83 100644
--- a/translations/ru-RU/data/reusables/webhooks/repository_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/repository_short_desc.md
@@ -1 +1 @@
-Activity related to a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[repositories](/v3/repos/)" REST API.
\ No newline at end of file
+Activity related to a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[repositories](/v3/repos/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/repository_vulnerability_alert_properties.md b/translations/ru-RU/data/reusables/webhooks/repository_vulnerability_alert_properties.md
index b394be458aa9..b7d577565d65 100644
--- a/translations/ru-RU/data/reusables/webhooks/repository_vulnerability_alert_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/repository_vulnerability_alert_properties.md
@@ -1,4 +1,4 @@
 | Клавиша      | Тип      | Description                                                                          |
 | ------------ | -------- | ------------------------------------------------------------------------------------ |
 | `действие`   | `строка` | The action that was performed. This can be one of `create`, `dismiss`, or `resolve`. |
-| `оповещение` | `объект` | The security alert of the vulnerable dependency.                                     |
\ No newline at end of file
+| `оповещение` | `объект` | The security alert of the vulnerable dependency.                                     |
diff --git a/translations/ru-RU/data/reusables/webhooks/repository_vulnerability_alert_short_desc.md b/translations/ru-RU/data/reusables/webhooks/repository_vulnerability_alert_short_desc.md
index 9eab73f38a49..635c979d782d 100644
--- a/translations/ru-RU/data/reusables/webhooks/repository_vulnerability_alert_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/repository_vulnerability_alert_short_desc.md
@@ -1 +1 @@
-Activity related to security vulnerability alerts in a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[About security alerts for vulerable dependencies](/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies)".
\ No newline at end of file
+Activity related to security vulnerability alerts in a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[About security alerts for vulerable dependencies](/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies)".
diff --git a/translations/ru-RU/data/reusables/webhooks/secret.md b/translations/ru-RU/data/reusables/webhooks/secret.md
index 119e13a93770..d4d128984aec 100644
--- a/translations/ru-RU/data/reusables/webhooks/secret.md
+++ b/translations/ru-RU/data/reusables/webhooks/secret.md
@@ -1 +1 @@
-Setting a webhook secret allows you to ensure that `POST` requests sent to the payload URL are from GitHub. When you set a secret, you'll receive the `X-Hub-Signature` header in the webhook `POST` request. For more details on how to use the secret and the `X-Hub-Signature` header to secure your webhook payloads, see "[Securing your webhooks](/webhooks/securing/)."
\ No newline at end of file
+Setting a webhook secret allows you to ensure that `POST` requests sent to the payload URL are from {% data variables.product.product_name %}. When you set a secret, you'll receive the {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}`X-Hub-Signature` and `X-Hub-Signature-256` headers{% else if currentVersion ver_lt "enterprise-server@2.23" %}`X-Hub-Signature` header{% else if currentVersion == "private-instances@latest" %}`X-Hub-Signature-256` header{% endif %} in the webhook `POST` request. For more information on how to use a secret with a signature header to secure your webhook payloads, see "[Securing your webhooks](/webhooks/securing/)."
diff --git a/translations/ru-RU/data/reusables/webhooks/sender_desc.md b/translations/ru-RU/data/reusables/webhooks/sender_desc.md
index d3c9f888bc19..218063f9e078 100644
--- a/translations/ru-RU/data/reusables/webhooks/sender_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/sender_desc.md
@@ -1 +1 @@
-`sender` | `object` | The user that triggered the event.
\ No newline at end of file
+`sender` | `object` | The user that triggered the event.
diff --git a/translations/ru-RU/data/reusables/webhooks/sponsorship_event_api_properties.md b/translations/ru-RU/data/reusables/webhooks/sponsorship_event_api_properties.md
index 8e791d233c54..047765a315ae 100644
--- a/translations/ru-RU/data/reusables/webhooks/sponsorship_event_api_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/sponsorship_event_api_properties.md
@@ -1,3 +1,3 @@
 | Клавиша    | Тип      | Description                                           |
 | ---------- | -------- | ----------------------------------------------------- |
-| `действие` | `строка` | The action that was performed. This can be `created`. |
\ No newline at end of file
+| `действие` | `строка` | The action that was performed. This can be `created`. |
diff --git a/translations/ru-RU/data/reusables/webhooks/sponsorship_properties.md b/translations/ru-RU/data/reusables/webhooks/sponsorship_properties.md
index 6506db181710..939d7fd0ea13 100644
--- a/translations/ru-RU/data/reusables/webhooks/sponsorship_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/sponsorship_properties.md
@@ -1 +1 @@
-`effective_date` | `string` | The `pending_cancellation` and `pending_tier_change` event types will include the date the cancellation or tier change will take effect. `changes[tier][from]` | `object` | The `tier_changed` and `pending_tier_change` will include the original tier before the change or pending change. For more information, see the [pending tier change payload](/webhooks/event-payloads#webhook-payload-example-when-someone-downgrades-a-sponsorship). `changes[privacy_level][from]` | `string` | The `edited` event types include the details about the change when someone edits a sponsorship to change the privacy.
\ No newline at end of file
+`effective_date` | `string` | The `pending_cancellation` and `pending_tier_change` event types will include the date the cancellation or tier change will take effect. `changes[tier][from]` | `object` | The `tier_changed` and `pending_tier_change` will include the original tier before the change or pending change. For more information, see the [pending tier change payload](/webhooks/event-payloads#webhook-payload-example-when-someone-downgrades-a-sponsorship). `changes[privacy_level][from]` | `string` | The `edited` event types include the details about the change when someone edits a sponsorship to change the privacy.
diff --git a/translations/ru-RU/data/reusables/webhooks/sponsorship_short_desc.md b/translations/ru-RU/data/reusables/webhooks/sponsorship_short_desc.md
index cb6cdccf21dc..2f62ffe8d86a 100644
--- a/translations/ru-RU/data/reusables/webhooks/sponsorship_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/sponsorship_short_desc.md
@@ -1 +1 @@
-Activity related to a sponsorship listing. {% data reusables.webhooks.action_type_desc %} For more information, see "[About GitHub Sponsors](/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors)".
\ No newline at end of file
+Activity related to a sponsorship listing. {% data reusables.webhooks.action_type_desc %} For more information, see "[About GitHub Sponsors](/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors)".
diff --git a/translations/ru-RU/data/reusables/webhooks/sponsorship_webhook_properties.md b/translations/ru-RU/data/reusables/webhooks/sponsorship_webhook_properties.md
index b43b577518ce..ed7f47ba80dc 100644
--- a/translations/ru-RU/data/reusables/webhooks/sponsorship_webhook_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/sponsorship_webhook_properties.md
@@ -1,3 +1,3 @@
 | Клавиша    | Тип      | Description                                                                                                                                           |
 | ---------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `действие` | `строка` | The action that was performed. This can be one of `created`, `cancelled`, `edited`, `tier_changed`, `pending_cancellation`, or `pending_tier_change`. |
\ No newline at end of file
+| `действие` | `строка` | The action that was performed. This can be one of `created`, `cancelled`, `edited`, `tier_changed`, `pending_cancellation`, or `pending_tier_change`. |
diff --git a/translations/ru-RU/data/reusables/webhooks/star_properties.md b/translations/ru-RU/data/reusables/webhooks/star_properties.md
index 1fe63ae9e024..5ed35f4a39b5 100644
--- a/translations/ru-RU/data/reusables/webhooks/star_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/star_properties.md
@@ -1,4 +1,4 @@
-| Клавиша      | Тип      | Description                                                                                                          |
-| ------------ | -------- | -------------------------------------------------------------------------------------------------------------------- |
-| `действие`   | `строка` | The action performed. Can be `created` or `deleted`.                                                                 |
-| `starred_at` | `строка` | The time the star was created. {% data reusables.shortdesc.iso_8601 %} Will be `null` for the `deleted` action. |
\ No newline at end of file
+| Клавиша      | Тип      | Description                                                                                                     |
+| ------------ | -------- | --------------------------------------------------------------------------------------------------------------- |
+| `действие`   | `строка` | The action performed. Can be `created` or `deleted`.                                                            |
+| `starred_at` | `строка` | The time the star was created. {% data reusables.shortdesc.iso_8601 %} Will be `null` for the `deleted` action. |
diff --git a/translations/ru-RU/data/reusables/webhooks/star_short_desc.md b/translations/ru-RU/data/reusables/webhooks/star_short_desc.md
index eac484160fed..f4fb6634197e 100644
--- a/translations/ru-RU/data/reusables/webhooks/star_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/star_short_desc.md
@@ -1 +1 @@
-Activity related to a repository being starred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[starring](/v3/activity/starring/)" REST API.
\ No newline at end of file
+Activity related to a repository being starred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[starring](/v3/activity/starring/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/status_short_desc.md b/translations/ru-RU/data/reusables/webhooks/status_short_desc.md
index 8d28713099d2..754f871add59 100644
--- a/translations/ru-RU/data/reusables/webhooks/status_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/status_short_desc.md
@@ -1 +1 @@
-When the status of a Git commit changes. {% data reusables.webhooks.action_type_desc %} For more information, see the "[statuses](/v3/repos/statuses/)" REST API.
\ No newline at end of file
+When the status of a Git commit changes. {% data reusables.webhooks.action_type_desc %} For more information, see the "[statuses](/v3/repos/statuses/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/team_add_short_desc.md b/translations/ru-RU/data/reusables/webhooks/team_add_short_desc.md
index 5ef912458fe4..914535a21208 100644
--- a/translations/ru-RU/data/reusables/webhooks/team_add_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/team_add_short_desc.md
@@ -1 +1 @@
-When a [repository is added to a team](/v3/teams/#add-or-update-team-repository-permissions).
\ No newline at end of file
+When a [repository is added to a team](/v3/teams/#add-or-update-team-repository-permissions).
diff --git a/translations/ru-RU/data/reusables/webhooks/team_short_desc.md b/translations/ru-RU/data/reusables/webhooks/team_short_desc.md
index 8faf762fe915..fdcf742789ee 100644
--- a/translations/ru-RU/data/reusables/webhooks/team_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/team_short_desc.md
@@ -1 +1 @@
-Activity related to an organization's team. {% data reusables.webhooks.action_type_desc %} For more information, see the "[teams](/v3/teams/)" REST API.
\ No newline at end of file
+Activity related to an organization's team. {% data reusables.webhooks.action_type_desc %} For more information, see the "[teams](/v3/teams/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/watch_properties.md b/translations/ru-RU/data/reusables/webhooks/watch_properties.md
index 840618655a24..b23f97b589c5 100644
--- a/translations/ru-RU/data/reusables/webhooks/watch_properties.md
+++ b/translations/ru-RU/data/reusables/webhooks/watch_properties.md
@@ -1,3 +1,3 @@
 | Клавиша    | Тип      | Description                                                      |
 | ---------- | -------- | ---------------------------------------------------------------- |
-| `действие` | `строка` | The action that was performed. Currently, can only be `started`. |
\ No newline at end of file
+| `действие` | `строка` | The action that was performed. Currently, can only be `started`. |
diff --git a/translations/ru-RU/data/reusables/webhooks/watch_short_desc.md b/translations/ru-RU/data/reusables/webhooks/watch_short_desc.md
index a40fc1893db2..a853027b12ef 100644
--- a/translations/ru-RU/data/reusables/webhooks/watch_short_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/watch_short_desc.md
@@ -1 +1 @@
-When someone stars a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[starring](/v3/activity/starring/)" REST API.
\ No newline at end of file
+When someone stars a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[starring](/v3/activity/starring/)" REST API.
diff --git a/translations/ru-RU/data/reusables/webhooks/webhooks_ssl.md b/translations/ru-RU/data/reusables/webhooks/webhooks_ssl.md
index 987a85576227..c0d40e639296 100644
--- a/translations/ru-RU/data/reusables/webhooks/webhooks_ssl.md
+++ b/translations/ru-RU/data/reusables/webhooks/webhooks_ssl.md
@@ -1 +1 @@
-If your "Payload URL" is a secure site (HTTPS), you will have the option to configure the SSL verification settings. If your "Payload URL" is not secure (HTTP), GitHub will not display this option. By default, GitHub verifies the SSL certificate of your website when delivering webhook payloads. SSL verification helps ensure that hook payloads are delivered to your URL endpoint securely. You have the option to disable SSL, but we recommend keeping **Enable SSL verification** selected.
\ No newline at end of file
+If your "Payload URL" is a secure site (HTTPS), you will have the option to configure the SSL verification settings. If your "Payload URL" is not secure (HTTP), GitHub will not display this option. By default, GitHub verifies the SSL certificate of your website when delivering webhook payloads. SSL verification helps ensure that hook payloads are delivered to your URL endpoint securely. You have the option to disable SSL, but we recommend keeping **Enable SSL verification** selected.
diff --git a/translations/ru-RU/data/reusables/webhooks/workflow_run_desc.md b/translations/ru-RU/data/reusables/webhooks/workflow_run_desc.md
index 25d67bab0223..8866577116c7 100644
--- a/translations/ru-RU/data/reusables/webhooks/workflow_run_desc.md
+++ b/translations/ru-RU/data/reusables/webhooks/workflow_run_desc.md
@@ -1,4 +1,4 @@
 
 This event occurs when a workflow run is requested or completed, and allows you to execute a workflow based on the finished result of another workflow. For example, if your `pull_request` workflow generates build artifacts, you can create a new workflow that uses `workflow_run` to analyze the results and add a comment to the original pull request.
 
-The workflow started by the `workflow_run` event is able to access the secrets and write tokens used by the original workflow.
\ No newline at end of file
+The workflow started by the `workflow_run` event is able to access the secrets and write tokens used by the original workflow.
diff --git a/translations/ru-RU/data/ui.yml b/translations/ru-RU/data/ui.yml
index 5f9482041de6..9e90d36d1162 100644
--- a/translations/ru-RU/data/ui.yml
+++ b/translations/ru-RU/data/ui.yml
@@ -83,7 +83,7 @@ products:
 footer:
   all_rights_reserved: Все права защищены
   terms: Terms
-  privacy: Приватность
+  privacy: Конфиденциальность
   security: Безопасность
   product:
     heading: Product
diff --git a/translations/ru-RU/data/variables/command_line.yml b/translations/ru-RU/data/variables/command_line.yml
index 4816981ce2e9..805c67903e68 100644
--- a/translations/ru-RU/data/variables/command_line.yml
+++ b/translations/ru-RU/data/variables/command_line.yml
@@ -1,5 +1,5 @@
 ---
-#Use this variable wherever backticks are necessary: http://git.io/AArkqA
+#Use this variable wherever backticks are necessary: https://github.com/github/docs-internal/pull/1176#discussion-diff-19853931
 backticks: >-
   {% if currentVersion == "free-pro-team@latest" %}github.com{% else %}[hostname]{% endif %}
 #Use this variable within codeblocks (because it includes HTML! Which only renders in shell codeblocks!)
diff --git a/translations/ru-RU/data/variables/contact.yml b/translations/ru-RU/data/variables/contact.yml
index 4bdc082175a9..dda3137566e9 100644
--- a/translations/ru-RU/data/variables/contact.yml
+++ b/translations/ru-RU/data/variables/contact.yml
@@ -12,7 +12,6 @@ contact_privacy: >-
   {% if currentVersion == "free-pro-team@latest" %}[Privacy contact form](https://github.com/contact/privacy){% endif %}
 contact_enterprise_sales: '[GitHub''s Sales team](https://enterprise.github.com/contact)'
 contact_feedback_actions: '[Feedback form for GitHub Actions](https://support.github.com/contact/feedback?contact[category]=actions)'
-contact_partner_engineering: '[partnerengineering@github.com](mailto:partnerengineering@github.com)'
 #The team that provides Standard Support
 enterprise_support: 'GitHub Enterprise Support'
 #The larger team that includes Enterprise Support and Premium Support
diff --git a/translations/ru-RU/data/variables/product.yml b/translations/ru-RU/data/variables/product.yml
index ba91b469c172..679823b087aa 100644
--- a/translations/ru-RU/data/variables/product.yml
+++ b/translations/ru-RU/data/variables/product.yml
@@ -30,7 +30,7 @@ prodname_enterprise_backup_utilities: 'GitHub Enterprise Server Backup Utilities
 ## Phrase content so that the uncapitalized unified contributions or unified search variables are not used at the start of a sentence.
 prodname_github_connect: 'Подключение GitHub'
 prodname_unified_contributions: 'общий вклад'
-prodname_unified_search: 'единообразный поиск'
+prodname_unified_search: 'унифицированный поиск'
 #GitHub Education
 prodname_education: 'GitHub Education'
 prodname_education_community: 'Education Community'
@@ -52,16 +52,13 @@ prodname_codeql: 'CodeQL'
 prodname_ql: 'QL'
 #Apps, GitHub Marketplace, and integrations
 prodname_marketplace: 'Магазин GitHub'
-prodname_github_app: 'GitHub App'
+prodname_github_app: 'Приложение GitHub'
 prodname_github_apps: 'GitHub Apps'
-prodname_oauth_app: 'OAuth App'
+prodname_oauth_app: 'Приложение OAuth'
 #API and developer docs
-prodname_dev_docs: 'the GitHub Developer documentation'
 prodname_enterprise_api: 'the GitHub Enterprise Server API'
-prodname_support_forum: 'GitHub API Development and Support Forum'
 prodname_support_forum_with_url: '[GitHub API Development and Support Forum](https://github.community/c/github-api-development-and-support/37)'
 prodname_unfurls: 'Content Attachments'
-prodname_component_kit: 'GitHub Component Kit'
 #GitHub Actions
 ## Use this variable only when referring to GitHub Actions the product. When referring to the thing that someone creates using the product, call it an action (small a). See the terminology page of the Brand Guide for more.
 prodname_actions: 'GitHub Actions'
@@ -80,13 +77,12 @@ prodname_matching_fund: 'Фонд подбора спонсоров GitHub'
 prodname_advanced_security: 'Advanced Security'
 #Codespaces
 prodname_codespaces: 'Codespaces'
-prodname_vscode: 'Visual Studio Code'
 prodname_vs_codespaces: 'Visual Studio Codespaces'
-prodname_vs: 'Visual Studio'
+prodname_github_codespaces: 'GitHub Codespaces'
 #GitHub resources: blog, jobs, Learning Lab
 prodname_gcf: 'GitHub Community Support'
 prodname_blog: 'the GitHub Blog'
-prodname_jobs: 'GitHub Jobs'
+prodname_jobs: 'Вакансии GitHub'
 prodname_learning: 'GitHub Learning Lab'
 prodname_learning_link: 'https://lab.github.com/'
 prodname_roadmap: 'GitHub public roadmap'
@@ -110,15 +106,18 @@ prodname_code_scanning: 'code scanning'
 prodname_code_scanning_capc: 'Code scanning'
 prodname_codeql_runner: 'CodeQL runner'
 prodname_advisory_database: 'GitHub Advisory Database'
-prodname_codeql_workflow: 'CodeQL Analysis workflow'
+prodname_codeql_workflow: 'CodeQL analysis workflow'
+#Visual Studio
+prodname_vs: 'Visual Studio'
+prodname_vscode: 'Visual Studio Code'
+prodname_vss_ghe: 'Visual Studio subscription with GitHub Enterprise'
+prodname_vss_admin_portal_with_url: 'the [administrator portal for Visual Studio subscriptions](https://visualstudio.microsoft.com/subscriptions-administration/)'
 #GitHub Dependabot
 prodname_dependabot: 'GitHub Dependabot'
 prodname_dependabot_short: 'Dependabot'
 prodname_dependabot_alerts: 'GitHub Dependabot alerts'
 prodname_dependabot_security_updates: 'GitHub Dependabot security updates'
 prodname_dependabot_version_updates: 'GitHub Dependabot version updates'
-#GitHub Policies
-prodname_policies: 'GitHub Policies'
 #GitHub Archive Program
 prodname_archive: 'GitHub Archive Program'
 prodname_arctic_vault: 'Arctic Code Vault'
diff --git a/translations/ru-RU/data/variables/search.yml b/translations/ru-RU/data/variables/search.yml
index cba17097ca1d..f22c85c91625 100644
--- a/translations/ru-RU/data/variables/search.yml
+++ b/translations/ru-RU/data/variables/search.yml
@@ -3,9 +3,3 @@ advanced_url: >-
   {% if currentVersion == "free-pro-team@latest" %}[advanced search](https://github.com/search/advanced) page{% else %}advanced search page (`https://[hostname]/search/advanced`){% endif %}
 search_page_url: >-
   {% if currentVersion == "free-pro-team@latest" %}[search](https://github.com/search) page{% else %}search page (`https://[hostname]/search`){% endif %}
-search_highlighting_link: >-
-  For more details about how to receive highlighted search results, see [Text match metadata](#text-match-metadata).
-search_query_description: >-
-  The query contains one or more search keywords and qualifiers. Qualifiers allow you to limit your search to specific areas of GitHub. The REST API supports the same qualifiers as GitHub.com. To learn more about the format of the query, see [Constructing a search query](#constructing-a-search-query).
-order_description: >-
-  Determines whether the first search result returned is the highest number of matches (`desc`) or lowest number of matches (`asc`). This parameter is ignored unless you provide `sort`. Default: `desc`
diff --git a/translations/zh-CN/content/actions/creating-actions/about-actions.md b/translations/zh-CN/content/actions/creating-actions/about-actions.md
index e7e0b686183a..b8d68ab60160 100644
--- a/translations/zh-CN/content/actions/creating-actions/about-actions.md
+++ b/translations/zh-CN/content/actions/creating-actions/about-actions.md
@@ -20,7 +20,8 @@ versions:
 您可以编写自定义代码来创建操作，以您喜欢的方式与仓库交互，包括使用 {% data variables.product.prodname_dotcom %} 的 API 以及任何公开的第三方 API 进行交互。 例如，操作可以发布 npm 模块、在创建紧急议题时发送短信提醒，或者部署可用于生产的代码。
 
 {% if currentVersion == "free-pro-team@latest" %}
-您可以编写自己的操作以用于工作流程，或者与 {% data variables.product.prodname_dotcom %} 社区共享您创建的操作。 要共享您创建的操作，您的仓库必须是公共的。
+您可以编写自己的操作以在工作流程中使用，或与
+{% data variables.product.prodname_dotcom %} 社区分享您构建的操作。 要共享您创建的操作，您的仓库必须是公共的。
 {% endif %}
 
 操作可以直接在计算机或 Docker 容器中运行。 您可以定义操作的输入、输出和环境变量。
@@ -35,7 +36,7 @@ versions:
 | JavaScript | Linux、MacOS、Windows |
 | 组合运行步骤     | Linux、MacOS、Windows |
 
-#### 码头容器操作
+#### Docker 容器操作
 
 Docker 容器使用 {% data variables.product.prodname_actions %} 代码封装环境。 这会创建更加一致、可靠的工作单位，因为操作的使用者不需要担心工具或依赖项。
 
@@ -51,7 +52,7 @@ JavaScript 操作可以直接在运行器计算机上运行，并将操作代码
 
 如果您正在开发 Node.js 项目，{% data variables.product.prodname_actions %} 工具包提供可用于项目中加速开发的软件包。 更多信息请参阅 [actions/toolkit](https://github.com/actions/toolkit) 仓库。
 
-#### 复合运行步骤操作
+#### 组合运行步骤操作
 
 _组合运行步骤_操作允许您在一个操作中组合多个工作流程运行步骤。 例如，您可以使用此功能将多个运行命令捆绑到一个操作中，然后获得使用该操作在单一步骤中执行捆绑命令的工作流程。 要看到示例，请参阅“[创建组合运行步骤操作](/actions/creating-actions/creating-a-composite-run-steps-action)”。
 
@@ -60,19 +61,20 @@ _组合运行步骤_操作允许您在一个操作中组合多个工作流程运
 如果是开发供其他人使用的操作，我们建议将该操作保持在其自己的仓库中，而不是与其他应用程序代码一起捆绑。 这可让您管理操作版本以及跟踪和发行操作，就像任何其他软件一样。
 
 {% if currentVersion == "free-pro-team@latest" %}
-将操作存储在其自己的仓库中更便于 {% data variables.product.prodname_dotcom %} 社区发现操作，缩小代码库范围以便开发者修复问题和扩展操作，以及从其他应用程序代码的版本解耦操作的版本。
+将操作存储在其自己的仓库中更便于
+{% data variables.product.prodname_dotcom %} 社区发现操作，缩小代码库范围以便开发者修复问题和扩展操作，以及从其他应用程序代码的版本解耦操作的版本。
 {% endif %}
 
-如果创建不打算公开的操作，可以将操作的文件存储在您的仓库中的任何位置。 如果计划将操作、工作流程和应用程序代码合并到一个仓库中，建议将操作存储在 `.github` 目录中。 例如，`.github/actions/action-a` 和 `.github/actions/action-b`。
+{% if currentVersion == "free-pro-team@latest" %}如果创建不打算公开的操作，您{% else %}您{% endif %}可以将操作的文件存储在您的仓库中的任何位置。 如果计划将操作、工作流程和应用程序代码合并到一个仓库中，建议将操作存储在 `.github` 目录中。 例如，`.github/actions/action-a` 和 `.github/actions/action-b`。
 
 ### 对操作使用发行版管理
 
 为了确保操作与 {% data variables.product.prodname_ghe_server %}兼容，应确保不使用任何硬编码引用来引用 {% data variables.product.prodname_dotcom %} URL。 相反，您应该使用环境变量来引用 {% data variables.product.prodname_dotcom %} API：
 
 - 创建发行版标记（例如，`v1.0.2`）之前，在发行版分支（如 `release/v1`）上创建发行版并进行验证。
-- 对于 GraphQL，使用 `GITHUB_GRAPHQL_URL` 变量。
+- 对于 GraphQL，使用 `GITHUB_GRAPHQL_URL` 环境变量。
 
-有关详细信息，请参阅"[默认环境变量](/actions/configuring-and-managing-workflows/using-environment-variables#default-environment-variables)。
+更多信息请参阅“[默认环境变量](/actions/configuring-and-managing-workflows/using-environment-variables#default-environment-variables)”。
 
 ### 对操作使用发行版管理
 
@@ -82,7 +84,7 @@ _组合运行步骤_操作允许您在一个操作中组合多个工作流程运
 
 如果您正在开发供其他人使用的操作，建议使用发行版管理来控制分发更新的方式。 用户期望操作的主要版本包括必要的关键修补程序和安全补丁，同时仍与其现有工作流程保持兼容。 每当更改影响兼容性时，应考虑发布新的主要版本。
 
-在此发行版管理方法下，用户不应引用操作的 `master` 分支，因为它可能包含最新的代码，因此可能不稳定。 相反地，您可以建议用户在使用您的操作时指定主要版本，并且仅在遇到问题时将其定向到更具体的版本。
+在此发行版管理方法下，用户不应引用操作的默认分支，因为它可能包含最新的代码，因此可能不稳定。 相反地，您可以建议用户在使用您的操作时指定主要版本，并且仅在遇到问题时将其定向到更具体的版本。
 
 要使用特定的操作版本，用户可以配置其 {% data variables.product.prodname_actions %} 工作流程定向标记、 提交的 SHA 或为发行版指定的分支。
 
@@ -141,7 +143,7 @@ steps:
 
 ### 比较 {% data variables.product.prodname_actions %}与 {% data variables.product.prodname_github_apps %}
 
-{% data variables.product.prodname_marketplace %} 提供用于改进工作流程的工具。 了解每种工具的差异和优势将使您能够选择最适合自己作业的工具。 有关构建操作和应用的更多信息，请参阅“[关于 GitHub 操作](/actions/getting-started-with-github-actions/about-github-actions)”和“[关于应用程序](/apps/about-apps/)”。
+{% data variables.product.prodname_marketplace %} 提供用于改进工作流程的工具。 了解每种工具的差异和优势将使您能够选择最适合自己作业的工具。 有关构建应用程序的更多信息，请参阅"[关于应用程序](/apps/about-apps/)。
 
 #### GitHub 操作和 GitHub 应用程序的设置
 
diff --git a/translations/zh-CN/content/actions/creating-actions/creating-a-composite-run-steps-action.md b/translations/zh-CN/content/actions/creating-actions/creating-a-composite-run-steps-action.md
index 5d4211cf4243..9c046cca6484 100644
--- a/translations/zh-CN/content/actions/creating-actions/creating-a-composite-run-steps-action.md
+++ b/translations/zh-CN/content/actions/creating-actions/creating-a-composite-run-steps-action.md
@@ -1,6 +1,6 @@
 ---
 title: 创建组合运行步骤操作
-intro: 在本指南中，您将学习如何构建组合运行步骤操作。
+intro: '在本指南中，您将学习如何构建组合运行步骤操作。'
 product: '{% data reusables.gated-features.actions %}'
 versions:
   free-pro-team: '*'
@@ -36,7 +36,7 @@ versions:
   echo "Goodbye"
   ```
 
-1. 从终端创建 `goodbye.sh` 可执行文件，并将其检入仓库。
+3. From your terminal, make `goodbye.sh` executable.
 
   ```shell
   chmod +x goodbye.sh
@@ -85,13 +85,26 @@ versions:
 
   有关如何使用 `github.action_path` 的更多信息，请参阅“[`github context`](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)”。
 
-1. 创建新标签。 此示例对主分支使用 `v1` 标签。 更多信息请参阅“[创建标签](/github/managing-your-work-on-github/creating-a-label)”。
+1. 从终端检入 `action.yml` 文件。
+
+  ```shell
+  git add action.yml
+  git commit -m "Add action"
+  git push
+  ```
+
+1. From your terminal, add a tag. This example uses a tag called `v1`. 更多信息请参阅“[关于操作](/actions/creating-actions/about-actions#using-release-management-for-actions)”。
+
+  ```shell
+  git tag -a -m "Description of this release" v1
+  git push --follow-tags
+  ```
 
 ### 在工作流程中测试您的操作
 
 以下工作流程代码使用您在“[创建操作元数据文件](/actions/creating-actions/creating-a-composite-run-steps-action#creating-an-action-metadata-file)”中设置的已完成 hello world 操作。
 
-将工作流程代码复制到另一个仓库中的 `.github/workflows/main.yml` 文件，但用您创建的仓库和标签替换 `actions/hello-world-compposite-run-steps-action@v1`。 您还可以将 `who-to-greet` 输入替换为您的名称。
+Copy the workflow code into a `.github/workflows/main.yml` file in another repository, but replace `actions/hello-world-composite-run-steps-action@v1` with the repository and tag you created. 您还可以将 `who-to-greet` 输入替换为您的名称。
 
 {% raw %}
 **.github/workflows/main.yml**
diff --git a/translations/zh-CN/content/actions/creating-actions/creating-a-docker-container-action.md b/translations/zh-CN/content/actions/creating-actions/creating-a-docker-container-action.md
index 7b1f7da30557..a29a7240128e 100644
--- a/translations/zh-CN/content/actions/creating-actions/creating-a-docker-container-action.md
+++ b/translations/zh-CN/content/actions/creating-actions/creating-a-docker-container-action.md
@@ -1,6 +1,6 @@
 ---
 title: 创建 Docker 容器操作
-intro: 本指南向您展示构建 Docker 容器操作所需的最少步骤。
+intro: '本指南向您展示构建 Docker 容器操作所需的最少步骤。'
 product: '{% data reusables.gated-features.actions %}'
 redirect_from:
   - /articles/creating-a-docker-container-action
diff --git a/translations/zh-CN/content/actions/creating-actions/creating-a-javascript-action.md b/translations/zh-CN/content/actions/creating-actions/creating-a-javascript-action.md
index 148674704656..be4c196a2e03 100644
--- a/translations/zh-CN/content/actions/creating-actions/creating-a-javascript-action.md
+++ b/translations/zh-CN/content/actions/creating-actions/creating-a-javascript-action.md
@@ -1,6 +1,6 @@
 ---
 title: 创建 JavaScript 操作
-intro: 在本指南中，您将了解如何使用操作工具包构建 JavaScript 操作。
+intro: '在本指南中，您将了解如何使用操作工具包构建 JavaScript 操作。'
 product: '{% data reusables.gated-features.actions %}'
 redirect_from:
   - /articles/creating-a-javascript-action
@@ -77,9 +77,9 @@ runs:
 
 操作工具包是 Node.js 包的集合，可让您以更高的一致性快速构建 JavaScript 操作。
 
-工具包 [`@actions/core`](https://github.com/actions/toolkit/tree/master/packages/core) 包提供一个接口，用于工作流程命令、输入和输出变量、退出状态以及调试消息。
+工具包 [`@actions/core`](https://github.com/actions/toolkit/tree/main/packages/core) 包提供一个接口，用于工作流程命令、输入和输出变量、退出状态以及调试消息。
 
-工具包还提供 [`@actions/github`](https://github.com/actions/toolkit/tree/master/packages/github) 包，用于返回经验证的 Octokit REST 客户端和访问 GitHub 操作上下文。
+工具包还提供 [`@actions/github`](https://github.com/actions/toolkit/tree/main/packages/github) 包，用于返回经验证的 Octokit REST 客户端和访问 GitHub 操作上下文。
 
 工具包不止提供 `core` 和 `github` 包。 更多信息请参阅 [actions/toolkit](https://github.com/actions/toolkit) 仓库。
 
@@ -119,7 +119,7 @@ try {
 }
 ```
 
-如果在上述 `index.js` 示例中出现错误 `core.setFailed(error.message);`，请使用操作工具包 [`@actions/core`](https://github.com/actions/toolkit/tree/master/packages/core) 包记录消息并设置失败退出代码。 更多信息请参阅“[设置操作的退出代码](/actions/creating-actions/setting-exit-codes-for-actions)”。
+如果在上述 `index.js` 示例中出现错误 `core.setFailed(error.message);`，请使用操作工具包 [`@actions/core`](https://github.com/actions/toolkit/tree/main/packages/core) 包记录消息并设置失败退出代码。 更多信息请参阅“[设置操作的退出代码](/actions/creating-actions/setting-exit-codes-for-actions)”。
 
 
 ### 创建自述文件
@@ -153,11 +153,11 @@ This action prints "Hello World" or "Hello" + the name of a person to greet to t
 
 我们问候您的时间。
 
-## 示例
+## Example usage
 
-使用： 操作 / hello - world - javascript - action@v1
-：
-  谁问候： '莫娜的八角形'
+uses: actions/hello-world-javascript-action@v1.1
+with:
+  who-to-greet: 'Mona the Octocat'
 ```
 
 ### 提交、标记和推送操作到 GitHub
@@ -209,21 +209,21 @@ git push --follow-tags
 {% raw %}
 **.github/workflows/main.yml**
 ```yaml
-上： [push]
-
-：
-  hello_world_job：
-    运行： ubuntu 最新
-    名称： 一个工作打招呼
-    步：
-    - 名称： 你好世界行动步骤
-      id： 你好
-      使用： 行动 / 你好世界 - javascript - action@v1.1
-      ：
-        谁问候： 'Mona 的 Octocat'
-    [ 使用输出从 '你好' 步骤
-    - 名称： 获取输出时间
-      运行： 回声 "时间是 ${{ steps.hello.outputs.time }}"
+on: [push]
+
+jobs:
+  hello_world_job:
+    runs-on: ubuntu-latest
+    name: A job to say hello
+    steps:
+    - name: Hello world action step
+      id: hello
+      uses: actions/hello-world-javascript-action@v1.1
+      with:
+        who-to-greet: 'Mona the Octocat'
+    # Use the output from the `hello` step
+    - name: Get the output time
+      run: echo "The time was ${{ steps.hello.outputs.time }}"
 ```
 {% endraw %}
 
@@ -258,4 +258,8 @@ jobs:
 
 从您的仓库中，单击 **Actions（操作）**选项卡，然后选择最新的工作流程来运行。 您应看到 "Hello Mona the Octocat" 或您用于 `who-to-greet` 输入的姓名和时间戳在日志中打印。
 
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+![在工作流中使用操作的屏幕截图](/assets/images/help/repository/javascript-action-workflow-run-updated.png)
+{% else %}
 ![在工作流中使用操作的屏幕截图](/assets/images/help/repository/javascript-action-workflow-run.png)
+{% endif %}
\ No newline at end of file
diff --git a/translations/zh-CN/content/actions/creating-actions/dockerfile-support-for-github-actions.md b/translations/zh-CN/content/actions/creating-actions/dockerfile-support-for-github-actions.md
index fbce2b1f7b9b..b378538d96fb 100644
--- a/translations/zh-CN/content/actions/creating-actions/dockerfile-support-for-github-actions.md
+++ b/translations/zh-CN/content/actions/creating-actions/dockerfile-support-for-github-actions.md
@@ -1,7 +1,7 @@
 ---
 title: Dockerfile 对 GitHub 操作的支持
 shortTitle: Docker
-intro: 为 Docker 容器创建 `Dockerfile` 时， 您应该知道一些 Docker 指令如何与 GitHub 操作及操作的元数据文件交互。
+intro: '为 Docker 容器创建 `Dockerfile` 时， 您应该知道一些 Docker 指令如何与 GitHub 操作及操作的元数据文件交互。'
 product: '{% data reusables.gated-features.actions %}'
 redirect_from:
   - /actions/building-actions/dockerfile-support-for-github-actions
diff --git a/translations/zh-CN/content/actions/creating-actions/index.md b/translations/zh-CN/content/actions/creating-actions/index.md
index 8c5e9f06afd2..f601090f065e 100644
--- a/translations/zh-CN/content/actions/creating-actions/index.md
+++ b/translations/zh-CN/content/actions/creating-actions/index.md
@@ -6,6 +6,7 @@ redirect_from:
   - /github/automating-your-workflow-with-github-actions/building-actions
   - /actions/automating-your-workflow-with-github-actions/building-actions
   - /actions/building-actions
+  - /articles/creating-a-github-action/
 versions:
   free-pro-team: '*'
   enterprise-server: '>=2.22'
diff --git a/translations/zh-CN/content/actions/creating-actions/metadata-syntax-for-github-actions.md b/translations/zh-CN/content/actions/creating-actions/metadata-syntax-for-github-actions.md
index 7751e68b8592..f2c2d123e2f7 100644
--- a/translations/zh-CN/content/actions/creating-actions/metadata-syntax-for-github-actions.md
+++ b/translations/zh-CN/content/actions/creating-actions/metadata-syntax-for-github-actions.md
@@ -42,7 +42,6 @@ Docker 和 JavaScript 操作需要元数据文件。 元数据文件名必须是
 
 此示例配置两个输入：numOctocats 和 octocatEyeColor。 numOctocats 输入不是必要的，默认值为 '1'。 octocatEyeColor 输入是必要的，没有默认值。 使用此操作的工作流程文件必须使用 `with` 关键词来设置 octocatEyeColor 的输入值。 有关 `with` 语法的更多信息，请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepswith)”。
 
-
 ```yaml
 inputs:
   numOctocats:
@@ -54,7 +53,6 @@ inputs:
     required: true
 ```
 
-
 在指定工作流程文件中某个操作的输入或者使用默认输入值时，{% data variables.product.prodname_dotcom %} 将为名称为 `INPUT_` 的输入创建环境变量。 创建的环境变量将输入名称转换为大写，并将空格替换为 `_` 字符。
 
 例如，如果工作流程定义了 numOctocats and octocatEyeColor 输入，操作代码可使用 `INPUT_NUMOCTOCATS` 和 `INPUT_OCTOCATEYECOLOR` 环境变量读取输入的值。
@@ -307,7 +305,7 @@ runs:
 
 ##### **`runs.steps.env`**
 
-**可选** 设置环境变量的 `map` 仅用于该步骤。 如果要修改存储在工作流程中的环境变量，请在组合运行步骤中使用 `echo "::set-env name={name}::{value}"`。
+**可选** 设置环境变量的 `map` 仅用于该步骤。 如果要修改工作流程中存储的环境变量，请在复合运行步骤中使用 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}`echo "{name}={value}" >> $GITHUB_ENV`{% else %}`echo "::set-env name={name}::{value}"`{% endif %}。
 
 
 
diff --git a/translations/zh-CN/content/actions/creating-actions/setting-exit-codes-for-actions.md b/translations/zh-CN/content/actions/creating-actions/setting-exit-codes-for-actions.md
index 2aec8130c7f7..f98b9ad8d682 100644
--- a/translations/zh-CN/content/actions/creating-actions/setting-exit-codes-for-actions.md
+++ b/translations/zh-CN/content/actions/creating-actions/setting-exit-codes-for-actions.md
@@ -24,7 +24,7 @@ versions:
 
 ### 在 JavaScript 操作中设置失败退出代码
 
-如果要创建 JavaScript 操作，您可以使用操作工具包 [`@actions/core`](https://github.com/actions/toolkit/tree/master/packages/core) 包来记录消息并设置失败退出代码。 例如：
+如果要创建 JavaScript 操作，您可以使用操作工具包 [`@actions/core`](https://github.com/actions/toolkit/tree/main/packages/core) 包来记录消息并设置失败退出代码。 例如：
 
 ```javascript
 try {
diff --git a/translations/zh-CN/content/actions/guides/about-continuous-integration.md b/translations/zh-CN/content/actions/guides/about-continuous-integration.md
new file mode 100644
index 000000000000..0dfe6383df07
--- /dev/null
+++ b/translations/zh-CN/content/actions/guides/about-continuous-integration.md
@@ -0,0 +1,63 @@
+---
+title: 关于持续集成
+intro: '您可以直接在 {% data variables.product.prodname_dotcom %} 仓库中通过 {% data variables.product.prodname_actions %} 创建自定义持续集成 (CI) 和持续部署 (CD) 工作流程。'
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /articles/about-continuous-integration
+  - /github/automating-your-workflow-with-github-actions/about-continuous-integration
+  - /actions/automating-your-workflow-with-github-actions/about-continuous-integration
+  - /actions/building-and-testing-code-with-continuous-integration/about-continuous-integration
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### 关于持续集成
+
+持续集成 (CI) 是一种需要频繁提交代码到共享仓库的软件实践。 频繁提交代码能较早检测到错误，减少在查找错误来源时开发者需要调试的代码量。 频繁的代码更新也更便于从软件开发团队的不同成员合并更改。 这对开发者非常有益，他们可以将更多时间用于编写代码，而减少在调试错误或解决合并冲突上所花的时间。
+
+提交代码到仓库时，可以持续创建并测试代码，以确保提交未引入错误。 您的测试可以包括代码语法检查（检查样式格式）、安全性检查、代码覆盖率、功能测试及其他自定义检查。
+
+创建和测试代码需要服务器。 您可以在推送代码到仓库之前在本地创建并测试更新，也可以使用 CI 服务器检查仓库中的新代码提交。
+
+### 关于使用 {% data variables.product.prodname_actions %} 的持续集成
+
+使用 {% data variables.product.prodname_actions %} 的 CI 提供可以在仓库中构建代码并运行测试的工作流程。 工作流程可在 {% data variables.product.prodname_dotcom %} 托管的虚拟机或您自行托管的机器上运行。 更多信息请参阅“[{% data variables.product.prodname_dotcom %} 托管的运行器的虚拟环境](/actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)”和“[关于自托管运行器](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)”。
+
+您可以配置 CI 工作流程在 {% data variables.product.product_name %} 事件发生时运行（例如，当新代码推送到您的仓库时）、按设定的时间表运行，或者在使用仓库分发 web 挂钩的外部事件发生时运行。
+
+{% data variables.product.product_name %} 运行 CI 测试并在拉取请求中提供每次测试的结果，因此您可以查看分支中的更改是否引入错误。 如果工作流程中的所有 CI 测试通过，您推送的更改可供团队成员审查或合并 如果测试失败，则是其中某项更改导致了失败。
+
+如果在仓库中设置了 CI，{% data variables.product.product_name %} 会分析仓库中的代码，并根据仓库中的语言和框架推荐 CI 工作流程。 例如，如果您使用 [Node.js](https://nodejs.org/en/)，{% data variables.product.product_name %} 将提议使用模板文件来安装 Node.js 包和运行测试。 您可以使用 {% data variables.product.product_name %} 提议的 CI 工作流程模板，自定义提议的模板，或者创建自定义工作流程文件来运行 CI 测试。
+
+![提议的持续集成模板截屏](/assets/images/help/repository/ci-with-actions-template-picker.png)
+
+除了帮助设置项目的 CI 工作流程之外，您还可以使用 {% data variables.product.prodname_actions %} 创建跨整个软件开发生命周期的工作流程。 例如，您可以使用操作来部署、封装或发行项目。 更多信息请参阅“[关于 {% data variables.product.prodname_actions %}](/articles/about-github-actions)”。
+
+有关常用术语的定义，请参阅“[{% data variables.product.prodname_actions %} 的核心概念](/github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)”。
+
+### 支持的语言
+
+{% data variables.product.product_name %} 提供各种不同语言和框架的 CI 工作流程模板。
+
+在 {% if currentVersion == "free-pro-team@latest" %}[actions/starter-workflows](https://github.com/actions/starter-workflows/tree/main/ci) 仓库{% else %}{% data variables.product.product_location %} 上的 `actions/starter-workflows` 仓库{% endif %}中浏览 {% data variables.product.product_name %} 提供的 CI 工作流程模板的完整列表。
+
+### 工作流程运行通知
+
+{% data reusables.repositories.workflow-notifications %}
+
+### 工作流程运行的状态徽章
+
+{% data reusables.repositories.actions-workflow-status-badge-into %}
+
+更多信息请参阅“[配置工作流程](/articles/configuring-a-workflow)。
+
+### 延伸阅读
+
+- "[使用 {% data variables.product.prodname_actions %} 设置持续集成](/articles/setting-up-continuous-integration-using-github-actions)"
+{% if currentVersion == "free-pro-team@latest" %}
+- "[管理 {% data variables.product.prodname_actions %} 的计费](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)"
+{% endif %}
diff --git a/translations/zh-CN/content/actions/guides/about-packaging-with-github-actions.md b/translations/zh-CN/content/actions/guides/about-packaging-with-github-actions.md
new file mode 100644
index 000000000000..8dd8590b6ee1
--- /dev/null
+++ b/translations/zh-CN/content/actions/guides/about-packaging-with-github-actions.md
@@ -0,0 +1,47 @@
+---
+title: 关于使用 GitHub 操作进行打包
+intro: '您可以在 {% data variables.product.prodname_actions %} 中设置工作流程生成包并将其上传到 {% data variables.product.prodname_registry %} 或其他包托管提供程序。'
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/about-packaging-with-github-actions
+  - /actions/publishing-packages-with-github-actions/about-packaging-with-github-actions
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### 关于打包步骤
+
+打包步骤是持续集成或持续交付工作流程的常见部分。 构建并测试应用程序后，将以包的形式生成可运行或可部署的构件。 例如，Java 项目的连续集成工作流程可能运行 `mvn package` 来生成 JAR 文件。 或者，Node.js 应用程序的 CI 工作流程可能会创建 Docker 容器。
+
+根据您构建的应用程序类型，此包可本地下载以进行手动测试、可供用户下载或部署到暂存或生产环境。
+
+### 持续集成工作流程中的打包
+
+在持续集成工作流程结束时创建包有助于拉取请求的代码审查。 构建并测试代码后，打包步骤可以生成可运行或可部署的构件。 然后，您的工作流程可提取该构件并将其上传为工作流程的一部分。
+
+现在，在审查拉取请求时，您将能够查看工作流程运行并下载生成的构件。
+
+![下载构件下拉菜单](/assets/images/help/repository/artifact-drop-down.png)
+
+这将允许您在计算机上运行拉取请求中的代码，有助于调试或测试拉取请求。
+
+### 发布包的工作流程
+
+除了上传打包构件以测试持续集成工作流程之外， 您还可以创建工作流程来构建项目并发布包到软件包注册表。
+
+* **发布软件包到 {% data variables.product.prodname_registry %}**
+  {% data variables.product.prodname_registry %} 可以作为多种类型包的包托管服务。 您可以选择与所有 {% data variables.product.prodname_dotcom %} 共享您的软件包，或者与合作者或组织共享私有软件包。 更多信息请参阅“[关于 {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/about-github-packages)”。
+
+  每次推送到默认分支，您可能想将软件包发布到 {% data variables.product.prodname_registry %}。 这可让项目开发者始终能够通过从 {% data variables.product.prodname_registry %} 安装，很容易地运行和测试主版本中的最新构建版本。
+
+* **将软件包发布到软件包注册表** 对于许多项目，每当发布项目的新版本时，都会执行发布到软件包注册表。 例如，生成 JAR 文件的项目可能会将新版本上传到 Maven Central 仓库。 或者，.NET 项目可能会生成一个微件包并上传到 Nuget Gallery。
+
+  您可以创建一个工作流程来自动执行此操作，在每次创建版本时将软件包发布到软件包注册表。 更多信息请参阅“[创建发行版](/github/administering-a-repository/creating-releases)”。
+
+### 延伸阅读
+
+- "[发布 Node.js 包](/actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages)"
diff --git a/translations/zh-CN/content/actions/guides/about-service-containers.md b/translations/zh-CN/content/actions/guides/about-service-containers.md
new file mode 100644
index 000000000000..d2ff9bd4b5d7
--- /dev/null
+++ b/translations/zh-CN/content/actions/guides/about-service-containers.md
@@ -0,0 +1,117 @@
+---
+title: 关于服务容器
+intro: '您可以使用服务容器将数据库、网络服务、内存缓存及其他工具连接到您的工作流程。'
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/about-service-containers
+  - /actions/configuring-and-managing-workflows/about-service-containers
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### 关于服务容器
+
+服务容器是 Docker 容器，以简便、可携带的方式托管您可能需要在工作流程中测试或操作应用程序的服务。 例如，您的工作流程可能必须运行需要访问数据库和内存缓存的集成测试。
+
+您可以为工作流程中的每个作业配置服务容器。 {% data variables.product.prodname_dotcom %} 为工作流中配置的每个服务创建一个新的 Docker 容器，并在作业完成后销毁该服务容器。 作业中的步骤可与属于同一作业的所有服务容器通信。
+
+{% data reusables.github-actions.docker-container-os-support %}
+
+### 与服务容器通信
+
+您可以在工作流程中配置作业直接在运行器机器或 Docker 容器上运行。 作业与其服务容器之间的通信根据作业是直接在运行器上运行还是在容器中运行而有所不同。
+
+#### 在容器中运行作业
+
+在容器中运行作业时，{% data variables.product.prodname_dotcom %} 使用 Docker 的用户定义桥接网络将服务容器连接到作业。 更多信息请参阅 Docker 文档中的“[使用桥接网络](https://docs.docker.com/network/bridge/)”。
+
+在容器中运行作业和服务可简化网络访问。 您可以使用工作流程中配置的标签访问服务容器。 服务容器的主机名自动映射到标签名称。 例如，如果您创建带有标签 `redis` 的服务容器 ，则该服务容器的主机名是 `redis`。
+
+您无需为服务容器配置任何端口。 默认情况下，属于同一 Docker 网络的所有容器会相互显示所有端口，但在 Docker 网络外部不会显示任何端口。
+
+#### 在运行器机器上运行作业
+
+直接在运行器机器上运行作业时，您可以使用 `localhost:` 或 `127.0.0.1:` 访问服务容器。 {% data variables.product.prodname_dotcom %} 配置容器网络以启用从服务容器到 Docker 主机的通信。
+
+当作业直接在运行器机器上运行时， Docker 容器中运行的服务默认情况下不会向运行器上的作业显示其端口。 您需要将服务容器上的端口映射到 Docker 主机。 更多信息请参阅“[映射 Docker 主机和服务容器端口](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)”。
+
+### 创建服务容器
+
+您可以使用 `services` 关键字创建服务容器作为工作流程中作业的一部分。 更多信息请参阅 [`jobs..services`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idservices)。
+
+本例在作业 `container-job` 中创建一个名为 `redis` 的服务。 本例中的 Docker 主机是 `node:10.18-jessie` 容器。
+
+{% raw %}
+```yaml
+name: Redis container example
+on: push
+
+jobs:
+  # Label of the container job
+  container-job:
+    # Containers must run in Linux based operating systems
+    runs-on: ubuntu-latest
+    # Docker Hub image that `container-job` executes in
+    container: node:10.18-jessie
+
+    # Service containers to run with `container-job`
+    services:
+      # Label used to access the service container
+      redis:
+        # Docker Hub image
+        image: redis
+```
+{% endraw %}
+
+### 映射 Docker 主机和服务容器端口
+
+如果作业在 Docker 容器中运行，则不需要映射主机或服务容器上的端口。 如果作业直接在运行器机器上运行，则需要将任何必需的服务容器端口映射到主机运行器机器上的端口。
+
+您可以使用 `ports` 关键字将服务容器端口映射到 Docker 主机。 更多信息请参阅 [`jobs..services`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idservices)。
+
+| `ports` 的值    | 描述                                           |
+| ------------- | -------------------------------------------- |
+| `8080:80`     | 将容器中的 TCP 端口 80 映射到 Docker 主机上的端口 8080。      |
+| `8080:80/udp` | 将容器中的 UDP 端口 80 映射到 Docker 主机上的端口 8080。      |
+| `8080/udp`    | 将容器中随机选择的 UDP 端口映射到 Docker 主机上的 UDP 端口 8080。 |
+
+使用 `ports` 关键字映射端口时，{% data variables.product.prodname_dotcom %} 使用 `--publish` 命令将容器的端口发布到 Docker 主机。 更多信息请参阅 Docker 文档中的“[Docker 容器网络](https://docs.docker.com/config/containers/container-networking/)”。
+
+指定 Docker 主机端口但不指定容器端口时，容器端口将随机分配给空闲端口。 {% data variables.product.prodname_dotcom %} 在服务容器上下文中设置分配的容器端口。 例如，对于 `redis` 服务容器，如果您配置了 Docker 主机端口 5432，则您可以使用 `job.services.redis.ports[5432]` 上下文访问对应的容器端口。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的上下文和表达式语法](/actions/reference/context-and-expression-syntax-for-github-actions#job-context)”。
+
+#### 映射 Redis 端口的示例
+
+此示例映射服务容器 `redis` 端口 6379 到 Docker 主机端口 6379。
+
+{% raw %}
+```yaml
+name: Redis Service Example
+on: push
+
+jobs:
+  # Label of the container job
+  runner-job:
+    # You must use a Linux environment when using service containers or container jobs
+    runs-on: ubuntu-latest
+
+    # Service containers to run with `runner-job`
+    services:
+      # Label used to access the service container
+      redis:
+        # Docker Hub image
+        image: redis
+        #
+        ports:
+          # Opens tcp port 6379 on the host and service container
+          - 6379:6379
+```
+{% endraw %}
+
+### 延伸阅读
+
+- "[创建 Redis 服务容器](/actions/automating-your-workflow-with-github-actions/creating-redis-service-containers)"
+- "[创建 PostgreSQL 服务容器](/actions/automating-your-workflow-with-github-actions/creating-postgresql-service-containers)"
diff --git a/translations/zh-CN/content/actions/guides/building-and-testing-java-with-ant.md b/translations/zh-CN/content/actions/guides/building-and-testing-java-with-ant.md
new file mode 100644
index 000000000000..9aac79c2505a
--- /dev/null
+++ b/translations/zh-CN/content/actions/guides/building-and-testing-java-with-ant.md
@@ -0,0 +1,109 @@
+---
+title: 使用 Ant 构建和测试 Java
+intro: 您可以在 GitHub 操作中创建持续集成 (CI) 工作流程，以使用 Ant 构建和测试 Java 项目。
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/building-and-testing-java-with-ant
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### 简介
+
+本指南介绍如何使用 Ant 构建系统为 Java 项目创建执行持续集成 (CI) 的工作流程。 您创建的工作流程将允许您查看拉取请求提交何时会在默认分支上导致构建或测试失败； 这个方法可帮助确保您的代码始终是健康的。 您可以扩展 CI 工作流程以从工作流程运行上传构件。
+
+{% data variables.product.prodname_dotcom %} 托管的运行器有工具缓存预安装的软件，包括 Java Development Kits (JDKs) 和 Ant。 有关软件以及 JDK 和 Ant 预安装版本的列表，请参阅 [{% data variables.product.prodname_dotcom %} 托管的运行器的规格](/actions/reference/specifications-for-github-hosted-runners/#supported-software)。
+
+### 基本要求
+
+您应该熟悉 YAML 和 {% data variables.product.prodname_actions %} 的语法。 更多信息请参阅：
+- "[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)"
+- "[了解 {% data variables.product.prodname_actions %}](/actions/learn-github-actions)"
+
+建议您对 Java 和 Ant 框架有个基本的了解。 更多信息请参阅“[Apache Ant 手册](https://ant.apache.org/manual/)”。
+
+{% data reusables.actions.enterprise-setup-prereq %}
+
+### 从 Ant 工作流程模板开始
+
+{% data variables.product.prodname_dotcom %} 提供有 Ant 工作流程模板，应该适用于大多数基于 Ant 的 Java 项目。 更多信息请参阅 [Ant 工作流程模板](https://github.com/actions/starter-workflows/blob/main/ci/ant.yml)。
+
+要快速开始，您可以在创建新工作流程时选择预配置的 Ant 模板。 更多信息请参阅“[{% data variables.product.prodname_actions %} 快速入门](/actions/quickstart)”。
+
+您也可以通过在仓库的 `.github/workflow` 目录中创建新文件来手动添加此工作流程。
+
+{% raw %}
+```yaml
+name: Java CI
+
+on: [push]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up JDK 1.8
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Build with Ant
+        run: ant -noinput -buildfile build.xml
+```
+{% endraw %}
+
+此工作流程执行以下步骤：
+
+1. `checkout` 步骤在运行器上下载仓库的副本。
+2. `setup-java` 步骤配置 Java 1.8 JDK。
+3. “使用 Ant 构建”步骤以非交互模式运行 `build.xml` 中的默认目标。
+
+在创建构建和测试工作流程时，默认工作流模板是很好的起点，然后您可以自定义模板以满足项目的需求。
+
+{% data reusables.github-actions.example-github-runner %}
+
+{% data reusables.github-actions.java-jvm-architecture %}
+
+### 构建和测试代码
+
+您可以使用与本地相同的命令来构建和测试代码。
+
+初学者工作流程将运行 _build.xml_ 文件中指定的默认目标。  默认目标通常设置为将类、运行测试和包类设置为其可分发格式，例如 JAR 文件。
+
+如果使用不同的命令来构建项目，或者想要运行不同的目标，则可以指定这些命令。 例如，您可能想要运行在 _build-ci.xml_ 文件中配置的 `jar` 目标。
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+    with:
+      java-version: 1.8
+  - name: Run the Ant jar target
+    run: ant -noinput -buildfile build-ci.xml jar
+```
+{% endraw %}
+
+### 将工作流数据打包为构件
+
+构建成功且测试通过后，您可能想要上传生成的 Java 包作为构件。 这会将构建的包存储为工作流程运行的一部分，并允许您下载它们。 构件可帮助您在拉取请求合并之前在本地环境中测试并调试它们。 更多信息请参阅“[使用构件持久化工作流程](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)”。
+
+Ant 通常会在 `build/jar` 目录中创建 JAR、EAR 或 WAR 等输出文件。 您可以使用 `upload-artifact` 操作上传该目录的内容。
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+  - run: ant -noinput -buildfile build.xml
+  - uses: actions/upload-artifact@v2
+    with:
+      name: Package
+      path: build/jar
+```
+{% endraw %}
diff --git a/translations/zh-CN/content/actions/guides/building-and-testing-java-with-gradle.md b/translations/zh-CN/content/actions/guides/building-and-testing-java-with-gradle.md
new file mode 100644
index 000000000000..3e0b0d75d28e
--- /dev/null
+++ b/translations/zh-CN/content/actions/guides/building-and-testing-java-with-gradle.md
@@ -0,0 +1,134 @@
+---
+title: 使用 Gradle 构建和测试 Java
+intro: 您可以在 GitHub 操作中创建持续集成 (CI) 工作流程，以使用 Gradle 构建和测试 Java 项目。
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/building-and-testing-java-with-gradle
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### 简介
+
+本指南介绍如何使用 Gradle 构建系统为 Java 项目创建执行持续集成 (CI) 的工作流程。 您创建的工作流程将允许您查看拉取请求提交何时会在默认分支上导致构建或测试失败； 这个方法可帮助确保您的代码始终是健康的。 您可以扩展 CI 工作流程以缓存文件并且从工作流程运行上传构件。
+
+{% data variables.product.prodname_dotcom %} 托管的运行器有工具缓存预安装的软件，包括 Java Development Kits (JDKs) 和 Gradle。 有关软件以及 JDK 和 Gradle 预安装版本的列表，请参阅 [{% data variables.product.prodname_dotcom %} 托管的运行器的规格](/actions/reference/specifications-for-github-hosted-runners/#supported-software)。
+
+### 基本要求
+
+您应该熟悉 YAML 和 {% data variables.product.prodname_actions %} 的语法。 更多信息请参阅：
+- "[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)"
+- "[了解 {% data variables.product.prodname_actions %}](/actions/learn-github-actions)"
+
+建议您对 Java 和 Gradle 框架有个基本的了解。 更多信息请参阅 Gradle 文档中的[入门指南](https://docs.gradle.org/current/userguide/getting_started.html)。
+
+{% data reusables.actions.enterprise-setup-prereq %}
+
+### 从 Gradle 工作流程模板开始
+
+{% data variables.product.prodname_dotcom %} 提供有 Gradle 工作流程模板，应该适用于大多数基于 Gradle 的 Java 项目。 更多信息请参阅 [Gradle 工作流程模板](https://github.com/actions/starter-workflows/blob/main/ci/gradle.yml)。
+
+要快速开始，您可以在创建新工作流程时选择预配置的 Gradle 模板。 更多信息请参阅“[{% data variables.product.prodname_actions %} 快速入门](/actions/quickstart)”。
+
+您也可以通过在仓库的 `.github/workflow` 目录中创建新文件来手动添加此工作流程。
+
+{% raw %}
+```yaml
+name: Java CI
+
+on: [push]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up JDK 1.8
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Build with Gradle
+        run: ./gradlew build
+```
+{% endraw %}
+
+此工作流程执行以下步骤：
+
+1. `checkout` 步骤在运行器上下载仓库的副本。
+2. `setup-java` 步骤配置 Java 1.8 JDK。
+3. “使用 Gradle 构建”步骤运行 `gradlew` wrapper 脚本以确保可以创建您的代码构建、测试通过和包。
+
+在创建构建和测试工作流程时，默认工作流模板是很好的起点，然后您可以自定义模板以满足项目的需求。
+
+{% data reusables.github-actions.example-github-runner %}
+
+{% data reusables.github-actions.java-jvm-architecture %}
+
+### 构建和测试代码
+
+您可以使用与本地相同的命令来构建和测试代码。
+
+初学者工作流程默认将运行 `build` 任务。 在默认的 Gradle 配置中，此命令将下载依赖项、构建类别、运行测试并将类别打包为可分发格式，如 JAR 文件。
+
+如果使用不同的命令来构建项目，或者想要使用不同的任务，则可以指定这些命令。 例如，您可能想要运行在 _ci.gradle_ 文件中配置的 `package` 任务。
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+    with:
+      java-version: 1.8
+  - name: Run the Gradle package task
+    run: ./gradlew -b ci.gradle package
+```
+{% endraw %}
+
+### 缓存依赖项
+
+您可以缓存依赖项来加快工作流程运行。 运行成功后，您的本地 Gradle 缓存将存储在 GitHub 操作基础架构中。 在未来的工作流程运行中，缓存将会恢复，因此不需要从远程包仓库下载依赖项。 更多信息请参阅“[缓存依赖项以加快工作流程](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)”和 [`cache` 操作](https://github.com/marketplace/actions/cache)。
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - name: Set up JDK 1.8
+    uses: actions/setup-java@v1
+    with:
+      java-version: 1.8
+  - name: Cache Gradle packages
+    uses: actions/cache@v2
+    with:
+      path: ~/.gradle/caches
+      key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle') }}
+      restore-keys: ${{ runner.os }}-gradle
+  - name: Build with Gradle
+    run: ./gradlew build
+```
+{% endraw %}
+
+此工作流程将保存本地 Gradle 缓存的内容，位于运行器主目录的 `.gradle/caches` 目录中。 缓存密钥将是 gradle 构建文件的哈希内容，因此更改它们将使缓存失效。
+
+### 将工作流数据打包为构件
+
+构建成功且测试通过后，您可能想要上传生成的 Java 包作为构件。 这会将构建的包存储为工作流程运行的一部分，并允许您下载它们。 构件可帮助您在拉取请求合并之前在本地环境中测试并调试它们。 更多信息请参阅“[使用构件持久化工作流程](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)”。
+
+Gradle 通常会在 `build/libs` 目录中创建 JAR、EAR 或 WAR 等输出文件。 您可以使用 `upload-artifact` 操作上传该目录的内容。
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+  - run: ./gradlew build
+  - uses: actions/upload-artifact@v2
+    with:
+      name: Package
+      path: build/libs
+```
+{% endraw %}
diff --git a/translations/zh-CN/content/actions/guides/building-and-testing-java-with-maven.md b/translations/zh-CN/content/actions/guides/building-and-testing-java-with-maven.md
new file mode 100644
index 000000000000..fa9a25bf0eea
--- /dev/null
+++ b/translations/zh-CN/content/actions/guides/building-and-testing-java-with-maven.md
@@ -0,0 +1,135 @@
+---
+title: 使用 Maven 构建和测试 Java
+intro: 您可以在 GitHub 操作中创建持续集成 (CI) 工作流程，以使用 Maven 构建和测试 Java 项目。
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/building-and-testing-java-with-maven
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### 简介
+
+本指南介绍如何使用 Maven 软件项目管理工具为 Java 项目创建执行持续集成 (CI) 的工作流程。 您创建的工作流程将允许您查看拉取请求提交何时会在默认分支上导致构建或测试失败； 这个方法可帮助确保您的代码始终是健康的。 您可以扩展 CI 工作流程以缓存文件并且从工作流程运行上传构件。
+
+{% data variables.product.prodname_dotcom %} 托管的运行器有工具缓存预安装的软件，包括 Java Development Kits (JDKs) 和 Maven。 有关软件以及 JDK 和 Maven 预安装版本的列表，请参阅 [{% data variables.product.prodname_dotcom %} 托管的运行器的规格](/actions/reference/specifications-for-github-hosted-runners/#supported-software)。
+
+### 基本要求
+
+您应该熟悉 YAML 和 {% data variables.product.prodname_actions %} 的语法。 更多信息请参阅：
+- "[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)"
+- "[了解 {% data variables.product.prodname_actions %}](/actions/learn-github-actions)"
+
+建议您对 Java 和 Maven 框架有个基本的了解。 更多信息请参阅 Maven 文档中的 [Maven 入门指南](http://maven.apache.org/guides/getting-started/index.html)。
+
+{% data reusables.actions.enterprise-setup-prereq %}
+
+### 从 Maven 工作流程模板开始
+
+{% data variables.product.prodname_dotcom %} 提供有 Maven 工作流程模板，应该适用于大多数基于 Maven 的 Java 项目。 更多信息请参阅 [Maven 工作流程模板](https://github.com/actions/starter-workflows/blob/main/ci/maven.yml)。
+
+要快速开始，您可以在创建新工作流程时选择预配置的 Maven 模板。 更多信息请参阅“[{% data variables.product.prodname_actions %} 快速入门](/actions/quickstart)”。
+
+您也可以通过在仓库的 `.github/workflow` 目录中创建新文件来手动添加此工作流程。
+
+{% raw %}
+```yaml
+name: Java CI
+
+on: [push]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up JDK 1.8
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Build with Maven
+        run: mvn -B package --file pom.xml
+```
+{% endraw %}
+
+此工作流程执行以下步骤：
+
+1. `checkout` 步骤在运行器上下载仓库的副本。
+2. `setup-java` 步骤配置 Java 1.8 JDK。
+3. “使用 Maven 构建”步骤以非交互模式运行 Maven `package` 目标，以确保创建代码版本、测试通行证和软件包。
+
+在创建构建和测试工作流程时，默认工作流模板是很好的起点，然后您可以自定义模板以满足项目的需求。
+
+{% data reusables.github-actions.example-github-runner %}
+
+{% data reusables.github-actions.java-jvm-architecture %}
+
+### 构建和测试代码
+
+您可以使用与本地相同的命令来构建和测试代码。
+
+初学者工作流程默认将运行 `package` 目标。 在默认的 Maven 配置中，此命令将下载依赖项、构建类别、运行测试并将类别打包为可分发格式，如 JAR 文件。
+
+如果使用不同的命令来构建项目，或者想要使用不同的目标，则可以指定这些命令。 例如，您可能想要运行在 _pom-ci.xml_ 文件中配置的 `verify` 目标。
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+    with:
+      java-version: 1.8
+  - name: Run the Maven verify phase
+    run: mvn -B verify --file pom-ci.xml
+```
+{% endraw %}
+
+### 缓存依赖项
+
+您可以缓存依赖项来加快工作流程运行。 运行成功后，您的本地 Maven 仓库将存储在 GitHub 操作基础架构中。 在未来的工作流程运行中，缓存将会恢复，因此不需要从远程 Maven 仓库下载依赖项。 更多信息请参阅“[缓存依赖项以加快工作流程](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)”和 [`cache` 操作](https://github.com/marketplace/actions/cache)。
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - name: Set up JDK 1.8
+    uses: actions/setup-java@v1
+    with:
+      java-version: 1.8
+  - name: Cache Maven packages
+    uses: actions/cache@v2
+    with:
+      path: ~/.m2
+      key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }}
+      restore-keys: ${{ runner.os }}-m2
+  - name: Build with Maven
+    run: mvn -B package --file pom.xml
+```
+{% endraw %}
+
+此工作流程将保存本地 Maven 存储库的内容，位于运行器主目录的 `.m2` 目录。 缓存密钥是 _pom.xml_ 的哈希内容，因此更改 _pom.xml_ 将使缓存失效。
+
+### 将工作流数据打包为构件
+
+构建成功且测试通过后，您可能想要上传生成的 Java 包作为构件。 这会将构建的包存储为工作流程运行的一部分，并允许您下载它们。 构件可帮助您在拉取请求合并之前在本地环境中测试并调试它们。 更多信息请参阅“[使用构件持久化工作流程](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)”。
+
+Maven 通常会在 `target` 目录中创建 JAR、EAR 或 WAR 等输出文件。 要将这些项目上传为构件，可以将它们复制到包含要上传的构件的新目录中。 例如，您可以创建一个名为 `staging` 的目录。 然后您可以使用 `upload-artifact` 操作上传该目录的内容。
+
+{% raw %}
+```yaml
+steps:
+  - uses: actions/checkout@v2
+  - uses: actions/setup-java@v1
+  - run: mvn -B package --file pom.xml
+  - run: mkdir staging && cp target/*.jar staging
+  - uses: actions/upload-artifact@v2
+    with:
+      name: Package
+      path: staging
+```
+{% endraw %}
diff --git a/translations/zh-CN/content/actions/guides/building-and-testing-nodejs.md b/translations/zh-CN/content/actions/guides/building-and-testing-nodejs.md
new file mode 100644
index 000000000000..6576aec10c07
--- /dev/null
+++ b/translations/zh-CN/content/actions/guides/building-and-testing-nodejs.md
@@ -0,0 +1,276 @@
+---
+title: 构建和测试 Node.js
+intro: 您可以创建持续集成 (CI) 工作流程来构建和测试您的 Node.js 项目。
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions
+  - /actions/language-and-framework-guides/using-nodejs-with-github-actions
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### 简介
+
+本指南介绍如何创建用来生成和测试 Node.js 代码的持续集成 (CI) 工作流程。 如果 CI 测试通过，您可能想要部署代码或发布包。
+
+### 基本要求
+
+建议基本了解 Node.js、YAML、工作流程配置选项以及如何创建工作流程文件。 更多信息请参阅：
+
+- "[了解 {% data variables.product.prodname_actions %}](/actions/learn-github-actions)"
+- "[开始使用 Node.js](https://nodejs.org/en/docs/guides/getting-started-guide/)"
+
+{% data reusables.actions.enterprise-setup-prereq %}
+
+### 从 Node.js 工作流程模板开始
+
+{% data variables.product.prodname_dotcom %} 提供 Node.js 适用于大多数 Node.js 项目的工作流程模板。 本指南包含可用于自定义模板的 npm 和 Yarn 示例。 更多信息请参阅 [Node.js 工作流程模板](https://github.com/actions/starter-workflows/blob/main/ci/node.js.yml)。
+
+要快速开始，请将模板添加到仓库的 `.github/workflows` 目录中。
+
+{% raw %}
+```yaml
+name: Node.js CI
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [8.x, 10.x, 12.x]
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v1
+      with:
+        node-version: ${{ matrix.node-version }}
+    - run: npm install
+    - run: npm run build --if-present
+    - run: npm test
+      env:
+        CI: true
+```
+{% endraw %}
+
+{% data reusables.github-actions.example-github-runner %}
+
+### 指定 Node.js 版本
+
+指定 Node.js 版本的最简单方法是使用由 {% data variables.product.prodname_dotcom %} 提供的 `setup-node` 操作。 更多信息请参阅 [`setup-node`](https://github.com/actions/setup-node/)。
+
+`setup-node` 操作采用 Node.js 版本作为输入，并在运行器上配置该版本。 `setup-node` 操作从每个运行器上的工具缓存中查找特定版本的 Node.js，并将必要的二进制文件添加到 `PATH`，这可继续用于作业的其余部分。 使用 `setup-node` 操作是 Node.js 与 {% data variables.product.prodname_actions %} 结合使用时的推荐方式，因为它能确保不同运行器和不同版本的 Node.js 行为一致。 如果使用自托管运行器，则必须安装 Node.js 并将其添加到 `PATH`。
+
+模板包含一个矩阵策略：用三个 Node.js 版本 8.x、10.x 和 12.x 构建和测试代码，其中“x”是通配符，匹配可用于版本的最新次要版和补丁版。 "x" 是一个通配符，与版本的最新次要版本和修补程序版本匹配。 `node-version` 阵列中指定的每个 Node.js 版本都会创建一个运行相同步骤的作业。
+
+每个作业都可以使用 `matrix` 上下文访问矩阵 `node-version` 阵列中定义的值。 `setup-node` 操作使用上下文作为 `node-version` 输入。 `setup-node` 操作在构建和测试代码之前使用不同的 Node.js 版本配置每个作业。 有关矩阵策略和上下文的更多信息，请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix)”和“[{% data variables.product.prodname_actions %} 的上下文和表达式语法](/actions/reference/context-and-expression-syntax-for-github-actions)”。
+
+{% raw %}
+```yaml
+strategy:
+  matrix:
+    node-version: [8.x, 10.x, 12.x]
+
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js ${{ matrix.node-version }}
+  uses: actions/setup-node@v1
+  with:
+    node-version: ${{ matrix.node-version }}
+```
+{% endraw %}
+
+您也可以构建和测试精确的 Node.js 版本。
+
+```yaml
+strategy:
+  matrix:
+    node-version: [8.16.2, 10.17.0]
+```
+
+或者，您也可以使用单个版本的 Node.js 构建和测试。
+
+{% raw %}
+```yaml
+name: Node.js CI
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Use Node.js
+      uses: actions/setup-node@v1
+      with:
+        node-version: '12.x'
+    - run: npm install
+    - run: npm run build --if-present
+    - run: npm test
+      env:
+        CI: true
+```
+{% endraw %}
+
+如果不指定 Node.js 版本，{% data variables.product.prodname_dotcom %} 将使用环境的默认 Node.js 版本。 更多信息请参阅“[{% data variables.product.prodname_dotcom %} 托管运行器的规范](/actions/reference/specifications-for-github-hosted-runners/#supported-software)”。
+
+### 安装依赖项
+
+{% data variables.product.prodname_dotcom %} 托管的运行器安装了 npm 和 Yarn 依赖项管理器。 在构建和测试代码之前，可以使用 npm 和 Yarn 在工作流程中安装依赖项。 Windows 和 Linux {% data variables.product.prodname_dotcom %} 托管的运行器也安装了 Grunt、Gulp 和 Bower。
+
+您也可以缓存依赖项来加快工作流程。 更多信息请参阅“[缓存依赖项以加快工作流程](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)”。
+
+#### 使用 npm 的示例
+
+此示例安装 *package.json* 文件中定义的依赖项。 更多信息请参阅 [`npm install`](https://docs.npmjs.com/cli/install)。
+
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    node-version: '12.x'
+- name: Install dependencies
+  run: npm install
+```
+
+使用 `npm ci` 将版本安装到 *package-lock.json* 或 *npm-shrinkwraw.json* 文件并阻止更新锁定文件。 使用 `npm ci` 通常比运行 `npm install` 更快。 更多信息请参阅 [`npm ci`](https://docs.npmjs.com/cli/ci.html) 和“[引入 `npm ci` 以进行更快、更可靠的构建](https://blog.npmjs.org/post/171556855892/introducing-npm-ci-for-faster-more-reliable)”。
+
+{% raw %}
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    node-version: '12.x'
+- name: Install dependencies
+  run: npm ci
+```
+{% endraw %}
+
+#### 使用 Yarn 的示例
+
+此示例安装 *package.json* 文件中定义的依赖项。 更多信息请参阅 [`yarn install`](https://yarnpkg.com/en/docs/cli/install)。
+
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    node-version: '12.x'
+- name: Install dependencies
+  run: yarn
+```
+
+或者，您可以传递 `--frozen-lockfile` 来安装 *yarn.lock* 文件中的版本，并阻止更新 *yarn.lock* 文件。
+
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    node-version: '12.x'
+- name: Install dependencies
+  run: yarn --frozen-lockfile
+```
+
+#### 使用私有注册表并创建 .npmrc 文件的示例
+
+{% data reusables.github-actions.setup-node-intro %}
+
+要验证您的私有注册表，需要将 npm 身份验证令牌在仓库设置中存储为密码。 例如，创建名为 `NPM_TOKEN` 的密码。 更多信息请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。
+
+在下面的示例中，密码 `NPM_TOKEN` 用于存储 npm 身份验证令牌。 `setup-node` 操作配置 *.npmrc* 文件从 `NODE_AUTH_TOKEN` 环境变量读取 npm 身份验证令牌。 使用 `setup-node` 操作创建 *.npmrc* 文件时，必须使用包含 npm 身份验证令牌的密码设置 `NPM_AUTH_TOKEN` 环境变量。
+
+在安装依赖项之前，使用 `setup-node` 操作创建 *.npmrc* 文件。 该操作有两个输入参数。 `node-version` 参数设置 Node.js 版本，`registry-url` 参数设置默认注册表。 如果包注册表使用作用域，您必须使用 `scope` 参数。 更多信息请参阅 [`npm-scope`](https://docs.npmjs.com/misc/scope)。
+
+{% raw %}
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    always-auth: true
+    node-version: '12.x'
+    registry-url: https://registry.npmjs.org
+    scope: '@octocat'
+- name: Install dependencies
+  run: npm ci
+  env:
+    NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}}
+```
+{% endraw %}
+
+上面的示例创建了一个包含以下内容的 *.npmrc* 文件：
+
+```
+//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN}
+@octocat:registry=https://registry.npmjs.org/
+always-auth=true
+```
+
+#### 缓存依赖项示例
+
+您可以使用唯一的密钥缓存依赖项，并在使用 `cache` 操作运行未来的工作流程时恢复依赖项。 更多信息请参阅“[缓存依赖项以加快工作流程](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)”和 [`cache` 操作](https://github.com/marketplace/actions/cache)。
+
+{% raw %}
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    node-version: '12.x'
+- name: Cache Node.js modules
+  uses: actions/cache@v2
+  with:
+    # npm cache files are stored in `~/.npm` on Linux/macOS
+    path: ~/.npm 
+    key: ${{ runner.OS }}-node-${{ hashFiles('**/package-lock.json') }}
+    restore-keys: |
+      ${{ runner.OS }}-node-
+      ${{ runner.OS }}-
+- name: Install dependencies
+  run: npm ci
+```
+{% endraw %}
+
+### 构建和测试代码
+
+您可以使用与本地相同的命令来构建和测试代码。 例如，如果您运行 `npm run build` 来运行 *package.json* 文件中定义的构建步骤，运行 `npm test` 来运行测试套件，则要在工作流程文件中添加以下命令。
+
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Use Node.js
+  uses: actions/setup-node@v1
+  with:
+    node-version: '12.x'
+- run: npm install
+- run: npm run build --if-present
+- run: npm test
+```
+
+### 将工作流数据打包为构件
+
+您可以保存构建和测试步骤中的构件以在作业完成后查看。 例如，您可能需要保存日志文件、核心转储、测试结果或屏幕截图。 更多信息请参阅“[使用构件持久化工作流程](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)”。
+
+### 发布到包注册表
+
+您可以配置工作流程在 CI 测试通过后将 Node.js 包发布到包注册表。 有关发布到 npm 和 {% data variables.product.prodname_registry %} 的更多信息，请参阅“[发布 Node.js 包](/actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages)”。
diff --git a/translations/zh-CN/content/actions/guides/building-and-testing-python.md b/translations/zh-CN/content/actions/guides/building-and-testing-python.md
new file mode 100644
index 000000000000..fbe5803da5c7
--- /dev/null
+++ b/translations/zh-CN/content/actions/guides/building-and-testing-python.md
@@ -0,0 +1,500 @@
+---
+title: 构建和测试 Python
+intro: 您可以创建持续集成 (CI) 工作流程来构建和测试您的 Python 项目。
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/using-python-with-github-actions
+  - /actions/language-and-framework-guides/using-python-with-github-actions
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### 简介
+
+本指南介绍如何构建、测试和发布 Python 包。
+
+{% data variables.product.prodname_dotcom %} 托管的运行器有工具缓存预安装的软件，包括 Python 和 PyPy。 您无需安装任何项目！ 有关最新版软件以及 Python 和 PyPy 预安装版本的完整列表，请参阅 [{% data variables.product.prodname_dotcom %} 托管的运行器的规格](/actions/reference/specifications-for-github-hosted-runners/#supported-software)。
+
+### 基本要求
+
+您应该熟悉 YAML 和 {% data variables.product.prodname_actions %} 的语法。 更多信息请参阅“[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)”。
+
+建议您对 Python、PyPy 和 pip 有个基本的了解。 更多信息请参阅：
+- [开始使用 Python](https://www.python.org/about/gettingstarted/)
+- [PyPy](https://pypy.org/)
+- [Pip 包管理器](https://pypi.org/project/pip/)
+
+{% data reusables.actions.enterprise-setup-prereq %}
+
+### 从 Python 工作流程模板开始
+
+{% data variables.product.prodname_dotcom %} 提供有 Python 工作流程模板，应该适用于大多数 Python 项目。 本指南包含可用于自定义模板的示例。 更多信息请参阅 [Python 工作流程模板](https://github.com/actions/starter-workflows/blob/main/ci/python-package.yml)。
+
+要快速开始，请将模板添加到仓库的 `.github/workflows` 目录中。
+
+{% raw %}
+```yaml
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: [2.7, 3.5, 3.6, 3.7, 3.8]
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v2
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install flake8 pytest
+        if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
+    - name: Lint with flake8
+      run: |
+        # 如果有任何 Python 语法错误或未定义的名称，停止构建
+        flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+        # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide
+        flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+    - name: Test with pytest
+      run: |
+        pytest
+```
+{% endraw %}
+
+### 指定 Python 版本
+
+要在 {% data variables.product.prodname_dotcom %} 托管的运行器上使用预安装的 Python 或 PyPy 版本，请使用 `setup-python` 操作。 此操作从每个运行器上的工具缓存中查找特定版本的 Python 或 PyPy，并将必要的二进制文件添加到 `PATH`，这可继续用于作业的其余部分。 如果工具缓存中未安装特定版本的 Python，`setup-python` 操作将从 [`python-versions`](https://github.com/actions/python-versions) 仓库下载并设置适当的版本。
+
+使用 `setup-action` 是 Python 与 {% data variables.product.prodname_actions %} 结合使用时的推荐方式，因为它能确保不同运行器和不同版本的 Python 行为一致。 如果使用自托管运行器，则必须安装 Python 并将其添加到 `PATH`。 更多信息请参阅 [`setup-python` 操作](https://github.com/marketplace/actions/setup-python)。
+
+下表描述了每个 {% data variables.product.prodname_dotcom %} 托管的运行器中工具缓存的位置。
+
+|                 | Ubuntu                          | Mac                                      | Windows                                    |
+| --------------- | ------------------------------- | ---------------------------------------- | ------------------------------------------ |
+| **工具缓存目录**      | `/opt/hostedtoolcache/*`        | `/Users/runner/hostedtoolcache/*`        | `C:\hostedtoolcache\windows\*`         |
+| **Python 工具缓存** | `/opt/hostedtoolcache/Python/*` | `/Users/runner/hostedtoolcache/Python/*` | `C:\hostedtoolcache\windows\Python\*` |
+| **PyPy 工具缓存**   | `/opt/hostedtoolcache/PyPy/*`   | `/Users/runner/hostedtoolcache/PyPy/*`   | `C:\hostedtoolcache\windows\PyPy\*`   |
+
+如果您正在使用自托管的运行器，则可以配置运行器使用 `setup-python` 操作来管理您的依赖项。 更多信息请参阅 `setup-python` 自述文件中的
+
+将 setup-python 与自托管运行器一起使用。
         
+
+{% data variables.product.prodname_dotcom %} 支持语义版本控制语法。 更多信息请参阅“[使用语义版本控制](https://docs.npmjs.com/about-semantic-versioning#using-semantic-versioning-to-specify-update-types-your-package-can-accept)”和“[语义版本控制规范](https://semver.org/)”。
+
+
+
+#### 使用多个 Python 版本
+
+{% raw %}
+
+
+```yaml
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      # You can use PyPy versions in python-version.
+      # 例如，pypy2 和 pypy3
+      matrix:
+        python-version: [2.7, 3.5, 3.6, 3.7, 3.8]
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v2
+      with:
+        python-version: ${{ matrix.python-version }}
+    # 您可以打印当前 Python 版本以测试矩阵
+    - name: Display Python version
+      run: python -c "import sys; print(sys.version)"
+```
+
+
+{% endraw %}
+
+
+
+#### 使用特定的 Python 版本
+
+您可以配置 python 的特定版本。 例如，3.8。 或者，您也可以通过语义版本语法来获得最新的次要版本。 此示例使用 Python 3 最新的次要版本。
+
+{% raw %}
+
+
+```yaml
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python 3.x
+      uses: actions/setup-python@v2
+      with:
+        # Python 版本的语义版本范围矩阵或准确的版本
+        python-version: '3.x' 
+        # 可选 - x64 或 x86 架构，默认为 x64
+        architecture: 'x64' 
+    # 您可以打印当前 Python 版本以测试矩阵
+    - name: Display Python version
+      run: python -c "import sys; print(sys.version)"
+```
+
+
+{% endraw %}
+
+
+
+#### 排除版本
+
+如果指定不可用的 Python 版本，`setup-python` 将会失败，且显示如下错误：`##[error]Version 3.4 with arch x64 not found`。 错误消息包含可用的版本。
+
+如果存在您不想运行的 Python 配置，您也可以在工作流程中使用 `exclude` 关键字。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategy)”。
+
+{% raw %}
+
+
+```yaml
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: [2.7, 3.6, 3.7, 3.8, pypy2, pypy3]
+        exclude:
+          - os: macos-latest
+            python-version: 3.6
+          - os: windows-latest
+            python-version: 3.6
+```
+
+
+{% endraw %}
+
+
+
+#### 使用默认 Python 版本
+
+建议使用 `setup-python` 配置工作流程中使用的 Python 版本，因为它有助于使您的依赖关系变得明朗。 如果不使用 `setup-python`，调用 `python` 时将在任何 shell 中使用 `PATH` 中设置的 Python 默认版本。 {% data variables.product.prodname_dotcom %} 托管的运行器之间有不同的 Python 默认版本，这可能导致非预期的更改或使用的版本比预期更旧。
+
+| {% data variables.product.prodname_dotcom %} 托管的运行器 | 描述                                                                                                                                                                         |
+| --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Ubuntu                                              | Ubuntu 运行器有多个版本的系统 Python 安装在 `/usr/bin/python` 和 `/usr/bin/python3` 下。 {% data variables.product.prodname_dotcom %} 除了安装在工具缓存中的版本，还有与 Ubuntu 一起打包的 Python 版本。             |
+| Windows                                             | 不包括工具缓存中的 Python 版本，Windows 未随附同等版本的系统 Python。 为保持与其他运行器一致的行为，并允许 Python 在没有 `setup-python` 操作的情况下开箱即用，{% data variables.product.prodname_dotcom %} 将从工具缓存中添加几个版本到 `PATH`。 |
+| macOS                                               | 除了作为工具缓存一部分的版本外，macOS 运行器还安装了多个版本的系统 Python。 系统 Python 版本位于 `/usr/local/Cellar/python/*` 目录中。                                                                              |
+
+
+
+
+### 安装依赖项
+
+{% data variables.product.prodname_dotcom %} 托管的运行器安装了 pip 软件包管理器。 在构建和测试代码之前，您可以使用 pip 从 PyPI 软件包注册表安装依赖项。 例如，下面的 YAML 安装或升级 `pip` 软件包安装程序以及 `setuptools` 和 `wheel` 软件包。
+
+您也可以缓存依赖项来加快工作流程。 更多信息请参阅“[缓存依赖项以加快工作流程](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)”。
+
+{% raw %}
+
+
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Set up Python
+  uses: actions/setup-python@v2
+  with:
+    python-version: '3.x'
+- name: Install dependencies
+  run: python -m pip install --upgrade pip setuptools wheel
+```
+
+
+{% endraw %}
+
+
+
+#### 要求文件
+
+在更新 `pip` 后，下一步通常是从 *requires.txt* 安装依赖项。
+
+{% raw %}
+
+
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Set up Python
+  uses: actions/setup-python@v2
+  with:
+    python-version: '3.x'
+- name: Install dependencies
+  run: |
+    python -m pip install --upgrade pip
+    pip install -r requirements.txt
+```
+
+
+{% endraw %}
+
+
+
+#### 缓存依赖项
+
+您可以使用唯一密钥缓存 pip 依赖项，并在使用 [`cache`](https://github.com/marketplace/actions/cache) 操作运行未来的工作流程时恢复依赖项。 更多信息请参阅“[缓存依赖项以加快工作流程](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)”。
+
+Pip 根据运行器的操作系统将依赖项缓存在不同的位置。 您需要缓存的路径可能不同于下面的 Ubuntu 示例，具体取决于您使用的操作系统。 更多信息请参阅 [Python 缓存示例](https://github.com/actions/cache/blob/main/examples.md#python---pip)。
+
+{% raw %}
+
+
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Setup Python
+  uses: actions/setup-python@v2
+  with:
+    python-version: '3.x'
+- name: Cache pip
+  uses: actions/cache@v2
+  with:
+    # This path is specific to Ubuntu
+    path: ~/.cache/pip
+    # Look to see if there is a cache hit for the corresponding requirements file
+    key: ${{ runner.os }}-pip-${{ hashFiles('requirements.txt') }}
+    restore-keys: |
+      ${{ runner.os }}-pip-
+      ${{ runner.os }}-
+- name: Install dependencies
+  run: pip install -r requirements.txt
+```
+
+
+{% endraw %}
+
+{% note %}
+
+**注意：**取决于依赖项的数量，使用依赖项缓存可能会更快。 有很多大型依赖项的项目应该能看到性能明显提升，因为下载所需的时间会缩短。 依赖项较少的项目可能看不到明显的性提升，甚至可能由于pip 安装缓存依赖项的方式而看到性能略有下降。 性能因项目而异。
+
+{% endnote %}
+
+
+
+### 测试代码
+
+您可以使用与本地相同的命令来构建和测试代码。
+
+
+
+#### 使用 pytest 和 pytest-cov 测试
+
+此示例安装或升级 `pytest` 和 `pest-cov`。 然后进行测试并以 JUnit 格式输出，而代码覆盖结果则以 Cobertura 输出。 更多信息请参阅 [JUnit](https://junit.org/junit5/) 和 [Cobertura](https://cobertura.github.io/cobertura/)。
+
+{% raw %}
+
+
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Set up Python
+  uses: actions/setup-python@v2
+  with:
+    python-version: '3.x'
+- name: Install dependencies
+  run: |
+    python -m pip install --upgrade pip
+    pip install -r requirements.txt
+- name: Test with pytest
+  run: |
+    pip install pytest
+    pip install pytest-cov
+    pytest tests.py --doctest-modules --junitxml=junit/test-results.xml --cov=com --cov-report=xml --cov-report=html
+```
+
+
+{% endraw %}
+
+
+
+#### 使用 Flake8 嵌入代码
+
+下面的示例安装或升级 `flake8` 并用它来嵌入所有文件。 更多信息请参阅 [Flake8](http://flake8.pycqa.org/en/latest/)。
+
+{% raw %}
+
+
+```yaml
+steps:
+- uses: actions/checkout@v2
+- name: Set up Python
+  uses: actions/setup-python@v2
+  with:
+    python-version: '3.x'
+- name: Install dependencies
+  run: |
+    python -m pip install --upgrade pip
+    pip install -r requirements.txt
+- name: Lint with flake8
+  run: |
+    pip install flake8
+    flake8 .
+```
+
+
+{% endraw %}
+
+
+
+#### 使用 tox 运行测试
+
+通过 {% data variables.product.prodname_actions %}，您可以使用 tox 运行测试并将工作分散到多个作业。 您需要使用 `-e py` 选项调用 tox，以在 `PATH` 中选择 Python 版本，而不是指定特定版本。 更多信息请参阅 [tox](https://tox.readthedocs.io/en/latest/)。
+
+{% raw %}
+
+
+```yaml
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python: [2.7, 3.7, 3.8]
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Setup Python
+        uses: actions/setup-python@v2
+        with:
+          python-version: ${{ matrix.python }}
+      - name: Install Tox and any other packages
+        run: pip install tox
+      - name: Run Tox
+        # 使用 `PATH` 中的 Python 版本运行 tox
+        run: tox -e py
+```
+
+
+{% endraw %}
+
+
+
+### 将工作流数据打包为构件
+
+您可以在工作流程完成后上传构件以查看。 例如，您可能需要保存日志文件、核心转储、测试结果或屏幕截图。 更多信息请参阅“[使用构件持久化工作流程](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)”。
+
+下面的示例演示如何使用 `upload-artifact` 操作来存档运行 `pytest` 的测试结果。 更多信息请参阅 [`upload-artifact` 操作](https://github.com/actions/upload-artifact)。
+
+{% raw %}
+
+
+```yaml
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: [2.7, 3.5, 3.6, 3.7, 3.8]
+
+      steps:
+      - uses: actions/checkout@v2
+      - name: Setup Python # Set Python version
+        uses: actions/setup-python@v2
+        with:
+          python-version: ${{ matrix.python-version }}
+      # Install pip and pytest
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install pytest
+      - name: Test with pytest
+        run: pytest tests.py --doctest-modules --junitxml=junit/test-results-${{ matrix.python-version }}.xml
+      - name: Upload pytest test results
+        uses: actions/upload-artifact@v2
+        with:
+          name: pytest-results-${{ matrix.python-version }}
+          path: junit/test-results-${{ matrix.python-version }}.xml
+        # Use always() to always run this step to publish test results when there are test failures
+        if: ${{ always() }}
+```
+
+
+{% endraw %}
+
+
+
+### 发布到包注册表
+
+您可以配置工作流程在 CI 测试通过时将 Python 包发布到您想要的任何包注册表。
+
+您可以使用仓库密码存储发布软件包所需的访问令牌或凭据。 下面的示例使用 `twine` 和 `dist` 创建包并发布到 PyPI。 更多信息请参阅“[创建和使用加密密码](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。
+
+{% raw %}
+
+
+```yaml
+name: Upload Python Package
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python
+      uses: actions/setup-python@v2
+      with:
+        python-version: '3.x'
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install setuptools wheel twine
+    - name: Build and publish
+      env:
+        TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }}
+        TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
+      run: |
+        python setup.py sdist bdist_wheel
+        twine upload dist/*
+```
+
+
+{% endraw %}
+
+有关模板工作流程的更多信息，请参阅 [`python-published`](https://github.com/actions/starter-workflows/blob/main/ci/python-publish.yml)。
diff --git a/translations/zh-CN/content/actions/guides/caching-dependencies-to-speed-up-workflows.md b/translations/zh-CN/content/actions/guides/caching-dependencies-to-speed-up-workflows.md
new file mode 100644
index 000000000000..9b682ec0f4ac
--- /dev/null
+++ b/translations/zh-CN/content/actions/guides/caching-dependencies-to-speed-up-workflows.md
@@ -0,0 +1,192 @@
+---
+title: 缓存依赖项以加快工作流程
+shortTitle: 缓存依赖项
+intro: '为了使工作流程更快、更高效，可以为依赖项及其他经常重复使用的文件创建和使用缓存。'
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /github/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows
+  - /actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows
+  - /actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows
+versions:
+  free-pro-team: '*'
+---
+
+### 关于缓存工作流程依赖项
+
+工作流程运行通常在不同运行之间重新使用相同的输出或下载的依赖项。 例如，Maven、Gradle、npm 和 Yarn 等软件包和依赖项管理工具都会对下载的依赖项保留本地缓存。
+
+{% data variables.product.prodname_dotcom %} 托管的运行器在一个干净的虚拟环境中启动，每次都必须下载依赖项，造成网络利用率提高、运行时间延长和成本增加。 为帮助加快重新创建这些文件，{% data variables.product.prodname_dotcom %} 可以缓存您在工作流程中经常使用的依赖项。
+
+要缓存作业的依赖项，您需要使用 {% data variables.product.prodname_dotcom %} 的 `cache` 操作。 该操作检索由唯一键标识的缓存。 更多信息请参阅 [`actions/cache`](https://github.com/actions/cache)。
+
+{% warning %}
+
+**警告**：建议不要在公共仓库缓存中存储任何敏感信息。 例如，敏感信息可以包括存储在缓存路径的文件中的访问令牌或登录凭据。 此外，命令行接口 (CLI) 程序，例如 `docker login`，可以在配置文件中保存访问凭据。 具有读取访问权限的任何人都可以在仓库上创建拉取请求并访问缓存的内容。 仓库的复刻也可在基本分支上创建拉取请求，并在基本分支上访问缓存。
+
+{% endwarning %}
+
+### 比较构件和依赖项缓存
+
+构件与缓存类似，因为它们能够在 {% data variables.product.prodname_dotcom %} 上存储文件，但每项功能都提供不同的用例，不能互换使用。
+
+- 如果要在作业或工作流程运行之间重复使用不经常更改的文件，请使用缓存。
+- 如果要保存作业生成的文件，以便在工作流程结束后查看，则使用构件。 更多信息请参阅“[使用构件持久化工作流程](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)”。
+
+### 访问缓存的限制
+
+使用 `cache` 操作的 `v2`，可以访问具有 `GITHUB_REF` 的任何事件所触发的工作流程中的缓存。 如果使用 `cache` 操作的 `v1`，您只能访问由 `push` 和 `pull_request` 事件触发的工作流程中的缓存，`pull_request` `closed` 事件除外。 更多信息请参阅“[触发工作流程的事件](/actions/reference/events-that-trigger-workflows)”。
+
+A workflow can access and restore a cache created in the current branch, the base branch (including base branches of forked repositories), or the default branch (usually `main`). For example, a cache created on the default branch would be accessible from any pull request. Also, if the branch `feature-b` has the base branch `feature-a`, a workflow triggered on `feature-b` would have access to caches created in the default branch (`main`), `feature-a`, and `feature-b`.
+
+访问限制通过在不同工作流程和分支之间创建逻辑边界来提供缓存隔离和安全。 For example, a cache created for the branch `feature-a` (with the base `main`) would not be accessible to a pull request for the branch `feature-b` (with the base `main`).
+
+### 使用 `cache` 操作
+
+`cache` 操作将尝试恢复基于您提供的 `key` 的缓存。 当操作找到缓存时，该操作会将缓存的文件还原到您配置的 `path`。
+
+如果没有精确匹配，操作在作业成功完成时将创建一个新的缓存条目。 新缓存将使用您提供的 `key` 并包含 `path` 目录中的文件。
+
+当 `key` 与现有缓存不匹配时，您可以选择性提供要使用的 `restore-keys` 列表。 `restore-keys` 列表很有用，因为 `restore-keys` 可以部分匹配缓存密钥。 有关匹配 `restore-keys` 的更多信息，请参阅“[匹配缓存密钥](#matching-a-cache-key)”。
+
+更多信息请参阅 [`actions/cache`](https://github.com/actions/cache)。
+
+#### `cache` 操作的输入参数
+
+- `key`：**必要** 保存缓存时创建的键，以及用于搜索缓存的键。 可以是变量、上下文值、静态字符串和函数的任何组合。 密钥最大长度为 512 个字符，密钥长度超过最大长度将导致操作失败。
+- `path`：**必要** 运行器上缓存或还原的文件路径。 路径可以是绝对路径或相对于工作目录的路径。
+  - 使用 `cache` 操作的 `v2`，可以指定单个路径，或将多个路径指定为列表。 路径可以是目录或单个文件，并且支持 glob 模式。
+  - 对于 `cache` 操作的 `v1`，仅支持单个路径，它必须是一个目录。 您不能缓存单个文件。
+- `restore-keys`：**可选** `key` 没有发生缓存命中时用于查找缓存的其他密钥顺序列表。
+
+#### `cache` 操作的输出参数
+
+- `cache-hit`：表示找到了密钥的精确匹配项的布尔值。
+
+#### `cache` 操作使用示例
+
+此示例在 `package-lock.json` 文件中的包更改时，或运行器的操作系统更改时，创建一个新的缓存。 缓存键使用上下文和表达式生成一个键值，其中包括运行器的操作系统和 `package-lock.json` 文件的 SHA-256 哈希。
+
+{% raw %}
+```yaml
+name: Caching with npm
+
+on: push
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+
+    - name: Cache node modules
+      uses: actions/cache@v2
+      env:
+        cache-name: cache-node-modules
+      with:
+        # npm cache files are stored in `~/.npm` on Linux/macOS
+        path: ~/.npm
+        key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }}
+        restore-keys: |
+          ${{ runner.os }}-build-${{ env.cache-name }}-
+          ${{ runner.os }}-build-
+          ${{ runner.os }}-
+
+    - name: Install Dependencies
+      run: npm install
+
+    - name: Build
+      run: npm build
+
+    - name: Test
+      run: npm test
+
+```
+{% endraw %}
+
+当 `key` 匹配现有缓存时，被称为缓存命中，并且操作会将缓存的文件还原到 `path` 目录。
+
+当 `key` 不匹配现有缓存时，则被称为缓存错过，在作业成功完成时将创建一个新缓存。 发生缓存错过时，操作将搜索称为 `restore-keys` 的替代键值。
+
+1. 如果您提供 `restore-keys`，`cache` 操作将按顺序搜索与 `restore-keys` 列表匹配的任何缓存。
+   - 当精确匹配时，操作会将缓存中的文件恢复至 `path` 目录。
+   - 如果没有精确匹配，操作将会搜索恢复键值的部分匹配。 当操作找到部分匹配时，最近的缓存将恢复到 `path` 目录。
+1. `cache` 操作完成，作业中的下一个工作流程步骤运行。
+1. 如果作业成功完成，则操作将创建一个包含 `path` 目录内容的新缓存。
+
+要在多个目录中缓存文件，您需要一个对每个目录使用 [`cache`](https://github.com/actions/cache) 操作的步骤。 创建缓存后，无法更改现有缓存的内容，但可以使用新键创建新缓存。
+
+#### 使用上下文创建缓存键
+
+缓存键可以包括 {% data variables.product.prodname_actions %} 支持的任何上下文、函数、文本和运算符。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的上下文和表达式语法](/actions/reference/context-and-expression-syntax-for-github-actions)”。
+
+使用表达式创建 `key` 允许您在依赖项更改时自动创建新缓存。 例如，您可以使用计算 npm `package-lock.json` 文件哈希的表达式创建 `key`。
+
+{% raw %}
+```
+npm-${{ hashFiles('package-lock.json') }}
+```
+{% endraw %}
+
+{% data variables.product.prodname_dotcom %} 评估表达式 `hash "package-lock.json"` 以派生最终 `key`。
+
+```
+npm-d5ea0750
+```
+
+### 匹配缓存键
+
+`cache` 操作会先在包含工作流程运行的分支中搜索 `key` 和 `restore-key` 的缓存命中。 如果当前分支中没有命中，`cache` 操作将在父分支和上游分支中搜索 `key` 和 `restore-keys`。
+
+您可以提供一个出现 `key` 缓存错过时使用的恢复键列表。 您可以创建从最具体到最不具体的多个恢复键。 `cache` 操作按顺序搜索 `restore-keys`。 当键不直接匹配时，操作将搜索以恢复键为前缀的键。 如果恢复键值有多个部分匹配项，操作将返回最近创建的缓存。
+
+#### 使用多个恢复键值的示例
+
+{% raw %}
+```
+restore-keys: |
+  npm-foobar-${{ hashFiles('package-lock.json') }}
+  npm-foobar-
+  npm-
+```
+{% endraw %}
+
+运行器将评估表达式，解析为以下 `restore-keys`：
+
+{% raw %}
+```
+restore-keys: |
+  npm-foobar-d5ea0750
+  npm-foobar-
+  npm-
+```
+{% endraw %}
+
+恢复键值 `npm-foobar-` 与任何以字符串 `npm-foobar-` 开头的键值匹配。 例如，键值 `npm-foobar-fd3052de` 和 `npm-foobar-a9b253ff` 都与恢复键值匹配。 将使用创建日期最新的缓存。 此示例中的键值按以下顺序搜索：
+
+1. **`npm-foobar-d5ea0750`** 匹配特定的哈希。
+1. **`npm-foobar-`** 匹配前缀为 `npm-foobar-` 的缓存键值。
+1. **`npm-`** 匹配前缀为 `npm-` 的任何键值。
+
+##### 搜索优先级示例
+
+```yaml
+key:
+  npm-feature-d5ea0750
+restore-keys: |
+  npm-feature-
+  npm-
+```
+
+For example, if a pull request contains a `feature` branch (the current scope) and targets the default branch (`main`), the action searches for `key` and `restore-keys` in the following order:
+
+1. `feature` 分支范围中的键值 `npm-feature-d5ea0750`
+1. `feature` 分支范围中的键值 `npm-feature-`
+2. `feature` 分支范围中的键值 `npm-`
+1. Key `npm-feature-d5ea0750` in the `main` branch scope
+3. Key `npm-feature-` in the `main` branch scope
+4. Key `npm-` in the `main` branch scope
+
+### 使用限制和收回政策
+
+{% data variables.product.prodname_dotcom %} 将删除 7 天内未被访问的任何缓存条目。 可以存储的缓存数没有限制，但存储库中所有缓存的总大小限制为 5 GB。 如果超过此限制，{% data variables.product.prodname_dotcom %} 将保存缓存，但会开始收回缓存，直到总大小小于 5 GB。
diff --git a/translations/zh-CN/content/actions/guides/creating-postgresql-service-containers.md b/translations/zh-CN/content/actions/guides/creating-postgresql-service-containers.md
new file mode 100644
index 000000000000..107f29ffad61
--- /dev/null
+++ b/translations/zh-CN/content/actions/guides/creating-postgresql-service-containers.md
@@ -0,0 +1,335 @@
+---
+title: 创建 PostgreSQL 服务容器
+shortTitle: PostgreSQL 服务容器
+intro: 您可以创建 PostgreSQL 服务容器用于您的工作流程。 本指南举例说明如何为容器中运行或直接在运行器机器上运行的作业创建 PostgreSQL 服务。
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/creating-postgresql-service-containers
+  - /actions/configuring-and-managing-workflows/creating-postgresql-service-containers
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### 简介
+
+本指南演示了使用 Docker Hub `postgres` 映像配置服务容器的工作流程示例。 工作流程运行脚本来创建 PostgreSQL 客户端并使用数据填充客户端。 要测试工作流程是否创建并填充 PostgreSQL 客户端，脚本会将客户端数据打印到控制台。
+
+{% data reusables.github-actions.docker-container-os-support %}
+
+### 基本要求
+
+{% data reusables.github-actions.service-container-prereqs %}
+
+你可能还会发现它也有助于基本了解 YAML、{% data variables.product.prodname_actions %} 的语法和 PostgreSQL。 更多信息请参阅：
+
+- "[了解 {% data variables.product.prodname_actions %}](/actions/learn-github-actions)"
+- PostgreSQL 文档中的“[PostgreSQL 教程](https://www.postgresqltutorial.com/)”
+
+### 在容器中运行作业
+
+{% data reusables.github-actions.container-jobs-intro %}
+
+{% data reusables.github-actions.copy-workflow-file %}
+
+{% raw %}
+```yaml
+name: PostgreSQL service example
+on: push
+
+jobs:
+  # Label of the container job
+  container-job:
+    # Containers must run in Linux based operating systems
+    runs-on: ubuntu-latest
+    # Docker Hub image that `container-job` executes in
+    container: node:10.18-jessie
+
+    # Service containers to run with `container-job`
+    services:
+      # Label used to access the service container
+      postgres:
+        # Docker Hub image
+        image: postgres
+        # Provide the password for postgres
+        env:
+          POSTGRES_PASSWORD: postgres
+        # Set health checks to wait until postgres has started
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
+    steps:
+      # Downloads a copy of the code in your repository before running CI tests
+      - name: Check out repository code
+        uses: actions/checkout@v2
+
+      # Performs a clean installation of all dependencies in the `package.json` file
+      # For more information, see https://docs.npmjs.com/cli/ci.html
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Connect to PostgreSQL
+        # Runs a script that creates a PostgreSQL client, populates
+        # the client with data, and retrieves data
+        run: node client.js
+        # Environment variable used by the `client.js` script to create a new PostgreSQL client.
+        env:
+          # The hostname used to communicate with the PostgreSQL service container
+          POSTGRES_HOST: postgres
+          # The default PostgreSQL port
+          POSTGRES_PORT: 5432
+```
+{% endraw %}
+
+#### 配置运行器作业
+
+{% data reusables.github-actions.service-container-host %}
+
+{% data reusables.github-actions.postgres-label-description %}
+
+```yaml
+jobs:
+  # Label of the container job
+  container-job:
+    # Containers must run in Linux based operating systems
+    runs-on: ubuntu-latest
+    # Docker Hub image that `container-job` executes in
+    container: node:10.18-jessie
+
+    # Service containers to run with `container-job`
+    services:
+      # Label used to access the service container
+      postgres:
+        # Docker Hub image
+        image: postgres
+        # Provide the password for postgres
+        env:
+          POSTGRES_PASSWORD: postgres
+        # Set health checks to wait until postgres has started
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+```
+
+#### 配置步骤
+
+{% data reusables.github-actions.service-template-steps %}
+
+```yaml
+steps:
+  # Downloads a copy of the code in your repository before running CI tests
+  - name: Check out repository code
+    uses: actions/checkout@v2
+
+  # Performs a clean installation of all dependencies in the `package.json` file
+  # For more information, see https://docs.npmjs.com/cli/ci.html
+  - name: Install dependencies
+    run: npm ci
+
+  - name: Connect to PostgreSQL
+    # Runs a script that creates a PostgreSQL client, populates
+    # the client with data, and retrieves data
+    run: node client.js
+    # Environment variable used by the `client.js` script to create
+    # a new PostgreSQL client.
+    env:
+      # The hostname used to communicate with the PostgreSQL service container
+      POSTGRES_HOST: postgres
+      # The default PostgreSQL port
+      POSTGRES_PORT: 5432
+```
+
+{% data reusables.github-actions.postgres-environment-variables %}
+
+PostgreSQL 文档中的服务的主机名是您在工作流程中配置的标签，本例中为 `postgres`。 由于同一用户定义的网桥网络上的 Docker 容器默认打开所有端口，因此您将能够访问默认 PostgreSQL 端口 5432 上的服务容器。
+
+### 直接在运行器机器上运行作业
+
+直接在运行器机器上运行作业时，需要将服务容器上的端口映射到 Docker 主机上的端口。 您可以使用 `localhost` 和 Docker 主机端口号从 Docker 主机访问服务容器。
+
+{% data reusables.github-actions.copy-workflow-file %}
+
+{% raw %}
+```yaml
+name: PostgreSQL Service Example
+on: push
+
+jobs:
+  # Label of the runner job
+  runner-job:
+    # You must use a Linux environment when using service containers or container jobs
+    runs-on: ubuntu-latest
+
+    # Service containers to run with `runner-job`
+    services:
+      # Label used to access the service container
+      postgres:
+        # Docker Hub image
+        image: postgres
+        # Provide the password for postgres
+        env:
+          POSTGRES_PASSWORD: postgres
+        # Set health checks to wait until postgres has started
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          # Maps tcp port 5432 on service container to the host
+          - 5432:5432
+
+    steps:
+      # Downloads a copy of the code in your repository before running CI tests
+      - name: Check out repository code
+        uses: actions/checkout@v2
+
+      # Performs a clean installation of all dependencies in the `package.json` file
+      # For more information, see https://docs.npmjs.com/cli/ci.html
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Connect to PostgreSQL
+        # Runs a script that creates a PostgreSQL client, populates
+        # the client with data, and retrieves data
+        run: node client.js
+        # Environment variable used by the `client.js` script to create
+        # a new PostgreSQL client.
+        env:
+          # The hostname used to communicate with the PostgreSQL service container
+          POSTGRES_HOST: localhost
+          # The default PostgreSQL port
+          POSTGRES_PORT: 5432
+```
+{% endraw %}
+
+#### 配置运行器作业
+
+{% data reusables.github-actions.service-container-host-runner %}
+
+{% data reusables.github-actions.postgres-label-description %}
+
+工作流程将 PostgreSQL 服务容器上的端口 5432 映射到 Docker 主机。 有关 `ports` 关键字的更多信息，请参阅“[关于服务容器](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)”。
+
+```yaml
+jobs:
+  # Label of the runner job
+  runner-job:
+    # You must use a Linux environment when using service containers or container jobs
+    runs-on: ubuntu-latest
+
+    # Service containers to run with `runner-job`
+    services:
+      # Label used to access the service container
+      postgres:
+        # Docker Hub image
+        image: postgres
+        # Provide the password for postgres
+        env:
+          POSTGRES_PASSWORD: postgres
+        # Set health checks to wait until postgres has started
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          # Maps tcp port 5432 on service container to the host
+          - 5432:5432
+```
+
+#### 配置步骤
+
+{% data reusables.github-actions.service-template-steps %}
+
+```yaml
+steps:
+  # Downloads a copy of the code in your repository before running CI tests
+  - name: Check out repository code
+    uses: actions/checkout@v2
+
+  # Performs a clean installation of all dependencies in the `package.json` file
+  # For more information, see https://docs.npmjs.com/cli/ci.html
+  - name: Install dependencies
+    run: npm ci
+
+  - name: Connect to PostgreSQL
+    # Runs a script that creates a PostgreSQL client, populates
+    # the client with data, and retrieves data
+    run: node client.js
+    # Environment variable used by the `client.js` script to create
+    # a new PostgreSQL client.
+    env:
+      # The hostname used to communicate with the PostgreSQL service container
+      POSTGRES_HOST: localhost
+      # The default PostgreSQL port
+      POSTGRES_PORT: 5432
+```
+
+{% data reusables.github-actions.postgres-environment-variables %}
+
+{% data reusables.github-actions.service-container-localhost %}
+
+### 测试 PostgreSQL 服务容器
+
+您可以使用以下脚本测试工作流程，该脚本将创建 PostgreSQL 客户端，并添加包含某些占位符数据的新表。 然后，脚本将存储在 PostgreSQL 客户端中的值打印到终端。 您的脚本可以使用任何您喜欢的语言，但此示例使用 Node.js 和 `Pg` npm 模块。 更多信息请参阅 [npm pg 模块](https://www.npmjs.com/package/pg)。
+
+您可以修改 *client.js* 以包含工作流程需要的任何 PostgreSQL 操作。 在此示例中，脚本创建 PostgreSQL 客户端实例、创建表、添加占位符数据，然后检索数据。
+
+{% data reusables.github-actions.service-container-add-script %}
+
+```javascript
+const { Client } = require('pg');
+
+const pgclient = new Client({
+    host: process.env.POSTGRES_HOST,
+    port: process.env.POSTGRES_PORT,
+    user: 'postgres',
+    password: 'postgres',
+    database: 'postgres'
+});
+
+pgclient.connect();
+
+const table = 'CREATE TABLE student(id SERIAL PRIMARY KEY, firstName VARCHAR(40) NOT NULL, lastName VARCHAR(40) NOT NULL, age INT, address VARCHAR(80), email VARCHAR(40))'
+const text = 'INSERT INTO student(firstname, lastname, age, address, email) VALUES($1, $2, $3, $4, $5) RETURNING *'
+const values = ['Mona the', 'Octocat', 9, '88 Colin P Kelly Jr St, San Francisco, CA 94107, United States', 'octocat@github.com']
+
+pgclient.query(table, (err, res) => {
+    if (err) throw err
+});
+
+pgclient.query(text, values, (err, res) => {
+    if (err) throw err
+});
+
+pgclient.query('SELECT * FROM student', (err, res) => {
+    if (err) throw err
+    console.log(err, res.rows) // Print the data in student table
+    pgclient.end()
+});
+```
+
+该脚本创建新的 PostgreSQLL `Client`，接受 `host` 和 `port` 参数。 该脚本使用 `POSTGRES_HOST` 和 `POSTGRES_PORT` 环境变量来设置客户端的 IP 地址和端口。 如果未定义 `host` 和 `port`，则默认主机为 `localhost`，默认端口为 5432。
+
+脚本创建一个表并将用占位符数据添加。 要测试 PostgreSQL 数据库是否包含数据，脚本将会表的内容打印到控制台日志。
+
+运行此工作流程时，应会在“连接到 PostgreSQL”步骤中看到以下输出，确认您创建了 PostgreSQL 客户端并添加了数据：
+
+```
+null [ { id: 1,
+    firstname: 'Mona the',
+    lastname: 'Octocat',
+    age: 9,
+    address:
+     '88 Colin P Kelly Jr St, San Francisco, CA 94107, United States',
+    email: 'octocat@github.com' } ]
+```
diff --git a/translations/zh-CN/content/actions/guides/creating-redis-service-containers.md b/translations/zh-CN/content/actions/guides/creating-redis-service-containers.md
new file mode 100644
index 000000000000..07041c4386f8
--- /dev/null
+++ b/translations/zh-CN/content/actions/guides/creating-redis-service-containers.md
@@ -0,0 +1,325 @@
+---
+title: 创建 Redis 服务容器
+shortTitle: Redis 服务容器
+intro: 您可以使用服务容器在工作流程中创建 Redis 客户端。 本指南举例说明如何为容器中运行或直接在运行器机器上运行的作业创建 Redis 服务。
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/creating-redis-service-containers
+  - /actions/configuring-and-managing-workflows/creating-redis-service-containers
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### 简介
+
+本指南演示了使用 Docker Hub `redis` 映像配置服务容器的工作流程示例。 工作流程运行脚本来创建 Redis 客户端并使用数据填充客户端。 要测试工作流程是否创建并填充 Redis 客户端，脚本会将客户端数据打印到控制台。
+
+{% data reusables.github-actions.docker-container-os-support %}
+
+### 基本要求
+
+{% data reusables.github-actions.service-container-prereqs %}
+
+你可能还会发现它也有助于基本了解 YAML、{% data variables.product.prodname_actions %} 的语法和 Redis。 更多信息请参阅：
+
+- "[了解 {% data variables.product.prodname_actions %}](/actions/learn-github-actions)"
+- Redis 文档中的“[Redis 使用入门](https://redislabs.com/get-started-with-redis/)”
+
+### 在容器中运行作业
+
+{% data reusables.github-actions.container-jobs-intro %}
+
+{% data reusables.github-actions.copy-workflow-file %}
+
+{% raw %}
+```yaml
+name: Redis container example
+on: push
+
+jobs:
+  # Label of the container job
+  container-job:
+    # Containers must run in Linux based operating systems
+    runs-on: ubuntu-latest
+    # Docker Hub image that `container-job` executes in
+    container: node:10.18-jessie
+
+    # Service containers to run with `container-job`
+    services:
+      # Label used to access the service container
+      redis:
+        # Docker Hub image
+        image: redis
+        # Set health checks to wait until redis has started
+        options: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
+    steps:
+      # Downloads a copy of the code in your repository before running CI tests
+      - name: Check out repository code
+        uses: actions/checkout@v2
+
+      # Performs a clean installation of all dependencies in the `package.json` file
+      # For more information, see https://docs.npmjs.com/cli/ci.html
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Connect to Redis
+        # Runs a script that creates a Redis client, populates
+        # the client with data, and retrieves data
+        run: node client.js
+        # Environment variable used by the `client.js` script to create a new Redis client.
+        env:
+          # The hostname used to communicate with the Redis service container
+          REDIS_HOST: redis
+          # The default Redis port
+          REDIS_PORT: 6379
+```
+{% endraw %}
+
+#### 配置容器作业
+
+{% data reusables.github-actions.service-container-host %}
+
+{% data reusables.github-actions.redis-label-description %}
+
+```yaml
+jobs:
+  # Label of the container job
+  container-job:
+    # Containers must run in Linux based operating systems
+    runs-on: ubuntu-latest
+    # Docker Hub image that `container-job` executes in
+    container: node:10.18-jessie
+
+    # Service containers to run with `container-job`
+    services:
+      # Label used to access the service container
+      redis:
+        # Docker Hub image
+        image: redis
+        # Set health checks to wait until redis has started
+        options: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+```
+
+#### 配置步骤
+
+{% data reusables.github-actions.service-template-steps %}
+
+```yaml
+steps:
+  # Downloads a copy of the code in your repository before running CI tests
+  - name: Check out repository code
+    uses: actions/checkout@v2
+
+  # Performs a clean installation of all dependencies in the `package.json` file
+  # For more information, see https://docs.npmjs.com/cli/ci.html
+  - name: Install dependencies
+    run: npm ci
+
+  - name: Connect to Redis
+    # Runs a script that creates a Redis client, populates
+    # the client with data, and retrieves data
+    run: node client.js
+    # Environment variable used by the `client.js` script to create a new Redis client.
+    env:
+      # The hostname used to communicate with the Redis service container
+      REDIS_HOST: redis
+      # The default Redis port
+      REDIS_PORT: 6379
+```
+
+{% data reusables.github-actions.redis-environment-variables %}
+
+Redis 服务的主机名是您在工作流程中配置的标签，本例中为 `redis`。 由于同一用户定义的网桥网络上的 Docker 容器默认打开所有端口，因此您将能够访问默认 Redis 端口 6379 上的服务容器。
+
+### 直接在运行器机器上运行作业
+
+直接在运行器机器上运行作业时，需要将服务容器上的端口映射到 Docker 主机上的端口。 您可以使用 `localhost` 和 Docker 主机端口号从 Docker 主机访问服务容器。
+
+{% data reusables.github-actions.copy-workflow-file %}
+
+{% raw %}
+```yaml
+name: Redis runner example
+on: push
+
+jobs:
+  # Label of the runner job
+  runner-job:
+    # You must use a Linux environment when using service containers or container jobs
+    runs-on: ubuntu-latest
+
+    # Service containers to run with `runner-job`
+    services:
+      # Label used to access the service container
+      redis:
+        # Docker Hub image
+        image: redis
+        # Set health checks to wait until redis has started
+        options: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          # Maps port 6379 on service container to the host
+          - 6379:6379
+
+    steps:
+      # Downloads a copy of the code in your repository before running CI tests
+      - name: Check out repository code
+        uses: actions/checkout@v2
+
+      # Performs a clean installation of all dependencies in the `package.json` file
+      # For more information, see https://docs.npmjs.com/cli/ci.html
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Connect to Redis
+        # Runs a script that creates a Redis client, populates
+        # the client with data, and retrieves data
+        run: node client.js
+        # Environment variable used by the `client.js` script to create
+        # a new Redis client.
+        env:
+          # The hostname used to communicate with the Redis service container
+          REDIS_HOST: localhost
+          # The default Redis port
+          REDIS_PORT: 6379
+```
+{% endraw %}
+
+#### 配置运行器作业
+
+{% data reusables.github-actions.service-container-host-runner %}
+
+{% data reusables.github-actions.redis-label-description %}
+
+工作流程将 Redis 服务容器上的端口 6379 映射到 Docker 主机。 有关 `ports` 关键字的更多信息，请参阅“[关于服务容器](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)”。
+
+```yaml
+jobs:
+  # Label of the runner job
+  runner-job:
+    # You must use a Linux environment when using service containers or container jobs
+    runs-on: ubuntu-latest
+
+    # Service containers to run with `runner-job`
+    services:
+      # Label used to access the service container
+      redis:
+        # Docker Hub image
+        image: redis
+        # Set health checks to wait until redis has started
+        options: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          # Maps port 6379 on service container to the host
+          - 6379:6379
+```
+
+#### 配置步骤
+
+{% data reusables.github-actions.service-template-steps %}
+
+```yaml
+steps:
+  # Downloads a copy of the code in your repository before running CI tests
+  - name: Check out repository code
+    uses: actions/checkout@v2
+
+  # Performs a clean installation of all dependencies in the `package.json` file
+  # For more information, see https://docs.npmjs.com/cli/ci.html
+  - name: Install dependencies
+    run: npm ci
+
+  - name: Connect to Redis
+    # Runs a script that creates a Redis client, populates
+    # the client with data, and retrieves data
+    run: node client.js
+    # Environment variable used by the `client.js` script to create
+    # a new Redis client.
+    env:
+      # The hostname used to communicate with the Redis service container
+      REDIS_HOST: localhost
+      # The default Redis port
+      REDIS_PORT: 6379
+```
+
+{% data reusables.github-actions.redis-environment-variables %}
+
+{% data reusables.github-actions.service-container-localhost %}
+
+### 测试 Redis 服务容器
+
+您可以使用以下脚本测试工作流程，该脚本将创建 Redis 客户端，并使用某些占位符数据填充客户端。 然后，脚本将存储在 Redis 客户端中的值打印到终端。 您的脚本可以使用任何您喜欢的语言，但此示例使用 Node.js 和 `redis` npm 模块。 更多信息请参阅 [npm redis 模块](https://www.npmjs.com/package/redis)。
+
+您可以修改 *client.js* 以包含工作流程需要的任何 Redis 操作。 在此示例中，脚本创建 Redis 客户端实例、添加占位符数据，然后检索数据。
+
+{% data reusables.github-actions.service-container-add-script %}
+
+```javascript
+const redis = require("redis");
+
+// Creates a new Redis client
+// If REDIS_HOST is not set, the default host is localhost
+// If REDIS_PORT is not set, the default port is 6379
+const redisClient = redis.createClient({
+  host: process.env.REDIS_HOST,
+  port: process.env.REDIS_PORT  
+});
+
+redisClient.on("error", function(err) {
+    console.log("Error " + err);
+});
+
+// Sets the key "octocat" to a value of "Mona the octocat"
+redisClient.set("octocat", "Mona the Octocat", redis.print);
+// Sets a key to "octocat", field to "species", and "value" to "Cat and Octopus"
+redisClient.hset("species", "octocat", "Cat and Octopus", redis.print);
+// Sets a key to "octocat", field to "species", and "value" to "Dinosaur and Octopus"
+redisClient.hset("species", "dinotocat", "Dinosaur and Octopus", redis.print);
+// Sets a key to "octocat", field to "species", and "value" to "Cat and Robot"
+redisClient.hset(["species", "robotocat", "Cat and Robot"], redis.print);
+// Gets all fields in "species" key
+
+redisClient.hkeys("species", function (err, replies) {
+    console.log(replies.length + " replies:");
+    replies.forEach(function (reply, i) {
+        console.log("    " + i + ": " + reply);
+    });
+    redisClient.quit();
+});
+```
+
+该脚本使用 `createClient` 方法创建新的 Redis 客户端，接受 `host` 和 `port` 参数。 该脚本使用 `REDIS_HOST` 和 `REDIS_PORT` 环境变量来设置客户端的 IP 地址和端口。 如果未定义 `host` 和 `port`，则默认主机为 `localhost`，默认端口为 6379。
+
+该脚本使用 `set` 和 `hset` 方法，以一些键值、字段和值来填充数据库。 要确认 Redis 客户端是否包含数据，脚本会将数据库的内容打印到控制台日志。
+
+运行此工作流程时，应会在“连接到 Redis”步骤中看到以下输出，确认您创建了 Redis 客户端并添加了数据：
+
+```
+Reply: OK
+Reply: 1
+Reply: 1
+Reply: 1  
+3 replies:
+    0: octocat
+    1: dinotocat
+    2: robotocat
+```
diff --git a/translations/zh-CN/content/actions/guides/index.md b/translations/zh-CN/content/actions/guides/index.md
new file mode 100644
index 000000000000..fbae4e327918
--- /dev/null
+++ b/translations/zh-CN/content/actions/guides/index.md
@@ -0,0 +1,60 @@
+---
+title: 指南
+shortTitle: 指南
+intro: '{% data variables.product.prodname_actions %} 的这些指南包含具体的使用案例和示例来帮助您配置工作流程。'
+redirect_from:
+  - /actions/guides/caching-and-storing-workflow-data
+  - /actions/automating-your-workflow-with-github-actions/using-databases-and-services
+  - /actions/configuring-and-managing-workflows/using-databases-and-service-containers
+  - /actions/guides/using-databases-and-service-containers
+  - /actions/language-and-framework-guides
+  - /actions/language-and-framework-guides/github-actions-for-docker
+  - /actions/language-and-framework-guides/github-actions-for-java
+  - /actions/language-and-framework-guides/github-actions-for-javascript-and-typescript
+  - /actions/language-and-framework-guides/github-actions-for-python
+  - /actions/publishing-packages-with-github-actions
+  - /actions/building-and-testing-code-with-continuous-integration
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### 创建自定义持续集成工作流程
+
+您可以使用 {% data variables.product.prodname_actions %} 来创建自定义的持续集成 (CI) 工作流程，以构建并测试以不同编程语言编写的项目。
+
+{% link_in_list /about-continuous-integration %}
+{% link_in_list /setting-up-continuous-integration-using-workflow-templates %}
+{% link_in_list /building-and-testing-nodejs %}
+{% link_in_list /building-and-testing-python %}
+{% link_in_list /building-and-testing-java-with-maven %}
+{% link_in_list /building-and-testing-java-with-gradle %}
+{% link_in_list /building-and-testing-java-with-ant %}
+
+### 发布软件包
+
+您可以自动发布软件包，作为持续交付 (CD) 工作流程的一部分。 软件包可以发布到任何软件包主机以及 {% data reusables.gated-features.packages %}。
+
+{% link_in_list /about-packaging-with-github-actions %}
+{% link_in_list /publishing-nodejs-packages %}
+{% link_in_list /publishing-java-packages-with-maven %}
+{% link_in_list /publishing-java-packages-with-gradle %}
+{% link_in_list /publishing-docker-images %}
+
+### 缓存和存储工作流程数据
+
+缓存依赖项和存储构件以提高工作流程运行效率。
+
+{% link_in_list /storing-workflow-data-as-artifacts %}
+{% link_in_list /caching-dependencies-to-speed-up-workflows %}
+
+### 在工作流程中使用服务容器
+
+使用服务容器将服务连接到您的工作流程。
+
+{% link_in_list /about-service-containers %}
+{% link_in_list /creating-redis-service-containers %}
+{% link_in_list /creating-postgresql-service-containers %}
diff --git a/translations/zh-CN/content/actions/guides/publishing-docker-images.md b/translations/zh-CN/content/actions/guides/publishing-docker-images.md
new file mode 100644
index 000000000000..0348244432e3
--- /dev/null
+++ b/translations/zh-CN/content/actions/guides/publishing-docker-images.md
@@ -0,0 +1,158 @@
+---
+title: 发布 Docker 映像
+intro: '您可以将 Docker 映像发布到注册表，例如 Docker Hub 或 {% data variables.product.prodname_registry %}，作为持续集成 (CI) 工作流程的一部分。'
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/publishing-docker-images
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### 简介
+
+本指南介绍如何创建执行 Docker 构建的工作流程，然后将 Docker 映像发布到 Docker Hub 或 {% data variables.product.prodname_registry %}。 通过单个工作流程，您可以将映像发布到单一注册表或多个注册表。
+
+{% note %}
+
+**注意：**如果要推送到另一个第三方 Docker 注册表，则“[发布映像到 {% data variables.product.prodname_registry %}](#publishing-images-to-github-packages)”部分可作为一个很好的模板。
+
+{% endnote %}
+
+### 基本要求
+
+建议基本了解工作流程配置选项和如何创建工作流程文件。 更多信息请参阅“[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)”。
+
+您可能还发现基本了解以下内容是有帮助的：
+
+- [加密的密码](/actions/reference/encrypted-secrets)"
+- "[工作流程中的身份验证](/actions/reference/authentication-in-a-workflow)"
+- "[配置 Docker 用于 {% data variables.product.prodname_registry %}](/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)"
+
+### 关于映像配置
+
+本指南假定您对存储在 {% data variables.product.prodname_dotcom %} 仓库的 Docker 映像有完整的定义。 例如，仓库必须包含 _Dockerfile_ 以及执行 Docker 构建所需的任何其他文件才可创建映像。
+
+在本指南中，我们将使用 Docker `build-push-action` 操作来构建 Docker 映像并将其推送到一个或多个 Docker 注册表。 更多信息请参阅 [`build-push-action`](https://github.com/marketplace/actions/build-and-push-docker-images)。
+
+{% data reusables.actions.enterprise-marketplace-actions %}
+
+### 将映像发布到 Docker Hub
+
+{% data reusables.github-actions.release-trigger-workflow %}
+
+在下面的示例工作流程中，我们使用 Docker `build-push-action` 操作构建 Docker 映像，如果构建成功，则将构建映像推送到 Docker Hub。
+
+要推送到 Docker Hub，您需要有一个 Docker Hub 帐户，并创建一个 Docker Hub 仓库。 更多信息请参阅 Docker 文档中的“[在 Docker Hub 上共享映像](https://docs.docker.com/get-started/part3/)”。
+
+Docker Hub 需要的 `build-push-action` 选项包括：
+
+* `username` 和 `password`：这是您的 Docker Hub 用户名和密码。 建议将 Docker Hub 用户名和密码在 {% data variables.product.prodname_dotcom %} 仓库中存储为加密密码，以免它们暴露在工作流程文件中。 更多信息请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。
+* `repository`：`DOCKER-HUB-NAMESPACE/DOCKER-HUB-REPOSITORY` 格式的 Docker Hub 仓库。
+
+{% raw %}
+```yaml
+name: Publish Docker image
+on:
+  release:
+    types: [published]
+jobs:
+  push_to_registry:
+    name: Push Docker image to Docker Hub
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out the repo
+        uses: actions/checkout@v2
+      - name: Push to Docker Hub
+        uses: docker/build-push-action@v1
+        with:
+          username: ${{ secrets.DOCKER_USERNAME }}
+          password: ${{ secrets.DOCKER_PASSWORD }}
+          repository: my-docker-hub-namespace/my-docker-hub-repository
+          tag_with_ref: true
+```
+{% endraw %}
+
+{% data reusables.github-actions.docker-tag-with-ref %}
+
+### 发布映像到 {% data variables.product.prodname_registry %}
+
+{% data reusables.github-actions.release-trigger-workflow %}
+
+在下面的示例工作流程中，我们使用 Docker `build-push-action` 操作构建 Docker 映像，如果构建成功，则将构建映像推送到 {% data variables.product.prodname_registry %}。
+
+{% data variables.product.prodname_registry %} 需要的 `build-push-action` 选项包括：
+
+* `username`：您可以使用 {% raw %}`${{ github.actor }}`{% endraw %} 上下文自动使用触发工作流程运行的用户的用户名。 更多信息请参阅“[GitHub 操作的上下文和表达式语法](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)”。
+* `password`：您可以使用自动生成的 `GITHUB_TOKEN` 密码作为密码。 更多信息请参阅“[使用 GITHUB_TOKEN 验证身份](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)”。
+* `registry`：必须设置为 `docker.pkg.github.com`。
+* `repository`：必须以 `OWNER/REPOSITORY/IMAGE_NAME` 格式设置。 例如，对于 `http://github.com/octo-org/octo-repo` 上名为 `octo-image` stored on {% data variables.product.prodname_dotcom %} 的映像，`repository` 选项应设置为 `octo-org/octo-repo/octo-image`。
+
+{% raw %}
+```yaml
+name: Publish Docker image
+on:
+  release:
+    types: [published]
+jobs:
+  push_to_registry:
+    name: Push Docker image to GitHub Packages
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out the repo
+        uses: actions/checkout@v2
+      - name: Push to GitHub Packages
+        uses: docker/build-push-action@v1
+        with:
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+          registry: docker.pkg.github.com
+          repository: my-org/my-repo/my-image
+          tag_with_ref: true
+
+```
+{% endraw %}
+
+{% data reusables.github-actions.docker-tag-with-ref %}
+
+### 发布映像到 Docker Hub 和 {% data variables.product.prodname_registry %}
+
+在单一工作流程中，您可以对每个注册表使用 `build-push-action` 操作，以将 Docker 映像发布到多个注册表。
+
+下面的示例工作流程使用前面章节中的 `build-push-action` 步骤（“[发布映像到 Docker Hub](#publishing-images-to-docker-hub)”和“[发布映像到 {% data variables.product.prodname_registry %}](#publishing-images-to-github-packages)”）来创建同时推送到两个注册表的单一工作流程。
+
+{% raw %}
+```yaml
+name: Publish Docker image
+on:
+  release:
+    types: [published]
+jobs:
+  push_to_registries:
+    name: Push Docker image to multiple registries
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out the repo
+        uses: actions/checkout@v2
+      - name: Push to Docker Hub
+        uses: docker/build-push-action@v1
+        with:
+          username: ${{ secrets.DOCKER_USERNAME }}
+          password: ${{ secrets.DOCKER_PASSWORD }}
+          repository: my-docker-hub-namespace/my-docker-hub-repository
+          tag_with_ref: true
+      - name: Push to GitHub Packages
+        uses: docker/build-push-action@v1
+        with:
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+          registry: docker.pkg.github.com
+          repository: my-org/my-repo/my-image
+          tag_with_ref: true
+```
+{% endraw %}
+
+上面的工作流程检出 {% data variables.product.prodname_dotcom %} 仓库，并且使用两次 `build-push-action` 操作构建并推送 Docker 映像到 Docker Hub 和 {% data variables.product.prodname_registry %}。 对于这两个步骤， 它设置 `build-pow-action` 选项 [`tag_with_ref`](https://github.com/marketplace/actions/build-and-push-docker-images#tag_with_ref) 自动使用工作流程事件的 Git 引用标记构建的 Docker 映像。 此工作流程在发布 {% data variables.product.prodname_dotcom %} 版本时触发，因此对两个注册表的引用将是该版本的 Git 标记。
diff --git a/translations/zh-CN/content/actions/guides/publishing-java-packages-with-gradle.md b/translations/zh-CN/content/actions/guides/publishing-java-packages-with-gradle.md
new file mode 100644
index 000000000000..911b1574a255
--- /dev/null
+++ b/translations/zh-CN/content/actions/guides/publishing-java-packages-with-gradle.md
@@ -0,0 +1,219 @@
+---
+title: 使用 Gradle 发布 Java 包
+intro: 您可以使用 Gradle 将 Java 包发布到注册表，作为持续集成 (CI) 工作流程的一部分。
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/publishing-java-packages-with-gradle
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### 简介
+
+{% data reusables.github-actions.publishing-java-packages-intro %}
+
+### 基本要求
+
+建议对工作流程文件和配置选项有一个基本了解。 更多信息请参阅“[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)”。
+
+有关使用 Gradle 为 Java 项目创建 CI 工作流程的详细信息，请参阅“[使用 Gradle 构建和测试用 Java](/actions/language-and-framework-guides/building-and-testing-java-with-gradle)”。
+
+您可能还发现基本了解以下内容是有帮助的：
+
+- "[配置 npm 用于 {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)"
+- "[环境变量](/actions/reference/environment-variables)"
+- [加密的密码](/actions/reference/encrypted-secrets)"
+- "[工作流程中的身份验证](/actions/reference/authentication-in-a-workflow)"
+
+### 关于包配置
+
+_build.gradle_ 文件 `MavenPublication` 部分的 `groupId` 和 `artifactId` 字段为包创建唯一标识符，供注册表用来将包链接到注册表。  这类似于 Maven _pom.xml_ 文件的 `groupId` 和 `artifactId` 字段。  更多信息请参阅 Gradle 文档中的“[Maven 发布插件](https://docs.gradle.org/current/userguide/publishing_maven.html)”。
+
+_build.gradle_ 文件还包含 Gradle 将在其中部署包的分发管理仓库的配置。 每个仓库必须有名称、部署 URL 和验证凭据。
+
+### 将包发布到 Maven 中心仓库
+
+每次创建新版本时，都可以触发工作流程来发布包。 以下示例中的工作流程在类型为 `created` 的 `release` 事件触发时运行。 如果 CI 测试通过，工作流程将包发布到 Maven 中心仓库。 有关 `release` 事件的更多信息，请参阅“[触发工作流程的事件](/actions/reference/events-that-trigger-workflows#release)”。
+
+您可以在 _build.gradle_ 文件的发布块中定义指向包仓库的新 Maven 仓库。  例如，如果您通过 OSSRH 托管项目部署到 Maven 中心仓库，则 _build.gradle_ 可以指定名称为 `"OSSRH"` 的仓库。
+
+{% raw %}
+```groovy
+publishing {
+  ...
+
+  repositories {
+    maven {
+      name = "OSSRH"
+      url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/"
+      credentials {
+        username = System.getenv("MAVEN_USERNAME")
+        password = System.getenv("MAVEN_PASSWORD")
+      }
+    }
+  }
+}
+```
+{% endraw %}
+
+使用此配置可创建一个工作流程，以通过运行 `gradle publish` 命令将包发布到 Maven 中心仓库。 您还需要提供包含用户名和密码的环境变量向仓库验证。
+
+在部署步骤中，您需要为用于向 Maven 仓库验证身份的用户名和密码或令牌设置环境变量。 更多信息请参阅“[创建和使用加密密码](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。
+
+
+{% raw %}
+```yaml
+name: Publish package to the Maven Central Repository
+on:
+  release:
+    types: [created]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Java
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Publish package
+        run: gradle publish
+        env:
+          MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
+          MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}
+```
+{% endraw %}
+
+{% data reusables.github-actions.gradle-workflow-steps %}
+1. 运行 `gradle published` 命令以发布到 `OSSRH` Maven 仓库。 `MAVEN_USERNAME` 环境变量将使用 `OSSRH_USERNAME` 密码的内容设置，而 `MAVEN_PASSWORD` 环境变量将使用 `OSSRH_TOKEN` 密码的内容设置。
+
+   有关在工作流程中使用密码的更多信息，请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。
+
+### 发布包到 {% data variables.product.prodname_registry %}
+
+每次创建新版本时，都可以触发工作流程来发布包。 以下示例中的工作流程在类型为 `created` 的 `release` 事件触发时运行。 如果 CI 测试通过，工作流程会将包发布到 {% data variables.product.prodname_registry %}。 有关 `release` 事件的更多信息，请参阅“[触发工作流程的事件](/actions/reference/events-that-trigger-workflows#release)”。
+
+您可以在 _build.gradle_ 文件的发布块中定义指向 {% data variables.product.prodname_registry %} 的新 Maven 仓库。  在仓库配置中，您也可以利用在 CI 工作流程运行中设置的环境变量。  您可以使用 `GITHUB_ACTOR` 环境变量作为用户名，并且可以使用 `GITHUB_TOKENN` 密码设置 `GITHUB_TOKEN` 环境变量。
+
+`GITHUB_TOKEN` 默认存在于您的仓库中，并且对工作流程运行的仓库中的包具有读取和写入权限。 更多信息请参阅“[使用 GITHUB_TOKEN 验证身份](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)”。
+
+例如，如果组织名为“octocat”且仓库名为“hello-world”，则 _build.gradle_ 中的 {% data variables.product.prodname_registry %} 配置看起来类似于以下示例。
+
+{% raw %}
+```groovy
+publishing {
+  ...
+
+  repositories {
+    maven {
+      name = "GitHubPackages"
+      url = "https://maven.pkg.github.com/octocat/hello-world"
+      credentials {
+        username = System.getenv("GITHUB_ACTOR")
+        password = System.getenv("GITHUB_TOKEN")
+      }
+    }
+  }
+}
+```
+{% endraw %}
+
+使用此配置可创建一个工作流程，以通过运行 `gradle publish` 命令将包发布到 Maven 中心仓库。
+
+{% raw %}
+```yaml
+name: Publish package to GitHub Packages
+on:
+  release:
+    types: [created]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Publish package
+        run: gradle publish
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
+
+{% data reusables.github-actions.gradle-workflow-steps %}
+1. 运行 `gradle published` 命令以发布到 {% data variables.product.prodname_registry %}。 `GITHUB_TOKEN` 环境变量将使用 `GITHUB_TOKEN` 密码的内容设置。
+
+   有关在工作流程中使用密码的更多信息，请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。
+
+### 发布包到 Maven 中心仓库和 {% data variables.product.prodname_registry %}
+
+您可以通过在 _build.gradle_ 文件中配置每项设置，将包发布到 Maven 中心仓库和 {% data variables.product.prodname_registry %}。
+
+确保 _build.gradle_ 文件包含用于 {% data variables.product.prodname_dotcom %} 仓库和 Maven 中心仓库提供商的仓库。
+
+例如，如果您通过 OSSRH 托管项目部署到 Maven 中心仓库，您可能想要在分发管理仓库中指定它，并将 `name` 设置为 `OSSRH`。 如果您部署到 {% data variables.product.prodname_registry %}，您可能想要在分发管理仓库中指定它，并将 `name` 设置为 `GitHubPackages`。
+
+如果组织名为“octocat”且仓库名为“hello-world”，则 _build.gradle_ 中的 {% data variables.product.prodname_registry %} 配置看起来类似于以下示例。
+
+{% raw %}
+```groovy
+publishing {
+  ...
+
+  repositories {
+    maven {
+      name = "OSSRH"
+      url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/"
+      credentials {
+        username = System.getenv("MAVEN_USERNAME")
+        password = System.getenv("MAVEN_PASSWORD")
+      }
+    }
+    maven {
+      name = "GitHubPackages"
+      url = "https://maven.pkg.github.com/octocat/hello-world"
+      credentials {
+        username = System.getenv("GITHUB_ACTOR")
+        password = System.getenv("GITHUB_TOKEN")
+      }
+    }
+  }
+}
+```
+{% endraw %}
+
+使用此配置可创建一个工作流程，以通过运行 `gradle publish` 命令将包发布到 Maven 中心仓库和 {% data variables.product.prodname_registry %}。
+
+{% raw %}
+```yaml
+name: Publish package to the Maven Central Repository and GitHub Packages
+on:
+  release:
+    types: [created]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Java
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Publish to the Maven Central Repository
+        run: gradle publish
+        env:
+          MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
+          MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
+
+{% data reusables.github-actions.gradle-workflow-steps %}
+1. 运行 `gradle published` 命令以发布到 `OSSRH` Maven 仓库和 {% data variables.product.prodname_registry %}。 `MAVEN_USERNAME` 环境变量将使用 `OSSRH_USERNAME` 密码的内容设置，而 `MAVEN_PASSWORD` 环境变量将使用 `OSSRH_TOKEN` 密码的内容设置。 `GITHUB_TOKEN` 环境变量将使用 `GITHUB_TOKEN` 密码的内容设置。
+
+   有关在工作流程中使用密码的更多信息，请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。
diff --git a/translations/zh-CN/content/actions/guides/publishing-java-packages-with-maven.md b/translations/zh-CN/content/actions/guides/publishing-java-packages-with-maven.md
new file mode 100644
index 000000000000..c6203777681a
--- /dev/null
+++ b/translations/zh-CN/content/actions/guides/publishing-java-packages-with-maven.md
@@ -0,0 +1,210 @@
+---
+title: 使用 Maven 发布 Java 包
+intro: 您可以使用 Maven 将 Java 包发布到注册表，作为持续集成 (CI) 工作流程的一部分。
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/language-and-framework-guides/publishing-java-packages-with-maven
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### 简介
+
+{% data reusables.github-actions.publishing-java-packages-intro %}
+
+### 基本要求
+
+建议对工作流程文件和配置选项有一个基本了解。 更多信息请参阅“[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)”。
+
+有关为使用 Maven 为 Java 项目创建 CI 工作流程的详细信息，请参阅“[使用 Maven 构建和测试用 Java](/actions/language-and-framework-guides/building-and-testing-java-with-maven)”。
+
+您可能还发现基本了解以下内容是有帮助的：
+
+- "[配置 npm 用于 {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)"
+- "[环境变量](/actions/reference/environment-variables)"
+- [加密的密码](/actions/reference/encrypted-secrets)"
+- "[工作流程中的身份验证](/actions/reference/authentication-in-a-workflow)"
+
+### 关于包配置
+
+_pom.xml_ 文件中的 `groupId` 和 `artifactId` 字段为包创建唯一标识符，供注册表用来将包链接到注册表。  更多信息请参阅 Apache Maven 文档中的[将构件上传到中心仓库的指南](http://maven.apache.org/repository/guide-central-repository-upload.html)。
+
+_pom.xml_ 文件还包含 Maven 将在其中部署包的分配管理仓库的配置。 每个仓库都必须有名称和部署 URL。 这些仓库的身份验证可在运行 Maven 的用户主目录下的 _.m2/settings.xml_ 文件中配置。
+
+您可以使用 `setup-java` 操作配置部署仓库以及该仓库的身份验证。 更多信息请参阅 [`setup-java`](https://github.com/actions/setup-java)。
+
+### 将包发布到 Maven 中心仓库
+
+每次创建新版本时，都可以触发工作流程来发布包。 以下示例中的工作流程在类型为 `created` 的 `release` 事件触发时运行。 如果 CI 测试通过，工作流程将包发布到 Maven 中心仓库。 有关 `release` 事件的更多信息，请参阅“[触发工作流程的事件](/actions/reference/events-that-trigger-workflows#release)”。
+
+在此工作流程中，您可以使用 `setup-java` 操作。 此操作将 JDK 的给定版本安装到 `PATH`，但同时会配置 Maven _settings.xml_ 以发布包。 默认情况下，设置文件将配置用于 {% data variables.product.prodname_registry %}，但可以将其配置为部署到另一个包注册表，如 Maven 中心仓库。 如果您已经在 _pom.xml_ 配置分配管理仓库，则可在 `setup-java` 操作调用期间指定该 `id`。
+
+例如，如果您通过 OSSRH 托管项目部署到 Maven 中心仓库，则 _pom.xml_ 可以指定 `id` 为 `ossrh` 的分发管理仓库。
+
+{% raw %}
+```xml
+
+  ...
+  
+    
+      ossrh
+      Central Repository OSSRH
+      https://oss.sonatype.org/service/local/staging/deploy/maven2/
+    
+  
+
+```
+{% endraw %}
+
+使用此配置，可通过将仓库管理 `id` 指定到 `setup-java` 操作，创建一个将包发布到 Maven 中心仓库的工作流程。 您还需要提供包含用户名和密码的环境变量向仓库验证。
+
+在部署步骤中，您需要将环境变量设置为向仓库验证的用户名，以及用密码或令牌配置为进行身份验证的密钥。  更多信息请参阅“[创建和使用加密密码](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。
+
+
+{% raw %}
+```yaml
+name: Publish package to the Maven Central Repository
+on:
+  release:
+    types: [created]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Maven Central Repository
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+          server-id: ossrh
+          server-username: MAVEN_USERNAME
+          server-password: MAVEN_PASSWORD
+      - name: Publish package
+        run: mvn -B deploy
+        env:
+          MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
+          MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}
+```
+{% endraw %}
+
+此工作流程执行以下步骤：
+
+1. 检出项目仓库的副本。
+1. 设置 Java JDK，同时使用 `MAVEN_USERNAME` 和 `MAVEN_PASSWORD` 环境变量配置 Maven _settings.xml_ 文件为 `ossrh` 仓库添加身份验证。
+1. {% data reusables.github-actions.publish-to-maven-workflow-step %}
+
+   有关在工作流程中使用密码的更多信息，请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。
+
+### 发布包到 {% data variables.product.prodname_registry %}
+
+每次创建新版本时，都可以触发工作流程来发布包。 以下示例中的工作流程在类型为 `created` 的 `release` 事件触发时运行。 如果 CI 测试通过，工作流程会将包发布到 {% data variables.product.prodname_registry %}。 有关 `release` 事件的更多信息，请参阅“[触发工作流程的事件](/actions/reference/events-that-trigger-workflows#release)”。
+
+在此工作流程中，您可以使用 `setup-java` 操作。 此操作将给定版本的 JDK 安装到 `PATH`，并且设置 Maven _settings.xml_ 以将包发布到 {% data variables.product.prodname_registry %}。 生成的 _settings.xml_ 定义使用 `github` 的 `id` 向服务器验证，使用 `GITHUB_ACTOR` 环境变量作为用户名，`GITHUB_TOKEN` 环境变量作为密码。
+
+`GITHUB_TOKEN` 默认存在于您的仓库中，并且对工作流程运行的仓库中的包具有读取和写入权限。 更多信息请参阅“[使用 GITHUB_TOKEN 验证身份](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)”。
+
+对于基于 Maven的项目，您可以通过在 _pom.xml_ 文件中创建分发仓库来使用这些设置，该文件以 `github` 的 `id` 指向 {% data variables.product.prodname_registry %} 端点。
+
+例如，如果组织名为“octocat”且仓库名为“hello-world”，则 _pom.xml_ 中的 {% data variables.product.prodname_registry %} 配置看起来类似于以下示例。
+
+{% raw %}
+```xml
+
+  ...
+  
+    
+      github
+      GitHub Packages
+      https://maven.pkg.github.com/octocat/hello-world
+    
+  
+
+```
+{% endraw %}
+
+通过此配置，您可以创建一个工作流程，以使用自动生成的 _settings.xml_ 将包发布到 {% data variables.product.prodname_registry %}。
+
+{% raw %}
+```yaml
+name: Publish package to GitHub Packages
+on:
+  release:
+    types: [created]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Publish package
+        run: mvn -B deploy
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
+
+此工作流程执行以下步骤：
+
+1. 检出项目仓库的副本。
+1. 设置 Java JDK，同时自动配置 Maven _settings.xml_ 文件为 `github` Maven 仓库添加身份验证，以使用 `GITHUB_TOKEN` 环境变量。
+1. {% data reusables.github-actions.publish-to-packages-workflow-step %}
+
+   有关在工作流程中使用密码的更多信息，请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。
+
+### 发布包到 Maven 中心仓库和 {% data variables.product.prodname_registry %}
+
+您可以使用每个注册表的 `setup-node` 操作将包发布到 Maven 中心仓库和 {% data variables.product.prodname_registry %}。
+
+确保 _pom.xml_ 文件包含用于 {% data variables.product.prodname_dotcom %} 仓库和 Maven 中心仓库提供商的分发管理仓库。 例如，如果您通过 OSSRH 托管项目部署到中心仓库，您可能想通过将 `id` 设置为 `ossrh` 在分发管理仓库中指定它，并且想通过将 `id` 设置为 `github` 在分发管理仓库中指定 {% data variables.product.prodname_registry %}。
+
+{% raw %}
+```yaml
+name: Publish package to the Maven Central Repository and GitHub Packages
+on:
+  release:
+    types: [created]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Java for publishing to Maven Central Repository
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+          server-id: ossrh
+          server-username: MAVEN_USERNAME
+          server-password: MAVEN_PASSWORD
+      - name: Publish to the Maven Central Repository
+        run: mvn -B deploy
+        env:
+          MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
+          MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}
+      - name: Set up Java for publishing to GitHub Packages
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+      - name: Publish to GitHub Packages
+        run: mvn -B deploy
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
+
+此工作流程将调用 `setup-java` 操作两次。  每次运行 `setup-java` 操作时，都会覆盖 Maven _settings.xml_ 文件以发布包。  为向仓库验证，_settings.xml_ 文件引用分发管理仓库 `id` 以及用户名和密码。
+
+此工作流程执行以下步骤：
+
+1. 检出项目仓库的副本。
+1. 第一次调用 `setup-java`。 这将为 `ossrh` 仓库配置 Maven _settings.xml_ 文件，并将身份验证选项设置为下一步定义的环境变量。
+1. {% data reusables.github-actions.publish-to-maven-workflow-step %}
+1. 第二次调用 `setup-java`。 这将自动为 {% data variables.product.prodname_registry %} 配置 Maven _settings.xml_ 文件。
+1. {% data reusables.github-actions.publish-to-packages-workflow-step %}
+
+   有关在工作流程中使用密码的更多信息，请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。
diff --git a/translations/zh-CN/content/actions/guides/publishing-nodejs-packages.md b/translations/zh-CN/content/actions/guides/publishing-nodejs-packages.md
new file mode 100644
index 000000000000..2909e18a9ec2
--- /dev/null
+++ b/translations/zh-CN/content/actions/guides/publishing-nodejs-packages.md
@@ -0,0 +1,210 @@
+---
+title: 发布 Node.js 包
+intro: 您可以将 Node.js 包发布到注册表，作为持续集成 (CI) 工作流程的一部分。
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages
+  - /actions/language-and-framework-guides/publishing-nodejs-packages
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### 简介
+
+本指南介绍如何创建一个工作流程，以在持续集成 (CI) 测试通过后将 Node.js 包发布到 {% data variables.product.prodname_registry %} 和 npm 注册表。 通过单个工作流程，您可以将包发布到单个注册表或多个注册表。
+
+### 基本要求
+
+建议基本了解工作流程配置选项和如何创建工作流程文件。 更多信息请参阅“[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)”。
+
+有关为 Node.js 项目创建 CI 工作流程的更多信息，请参阅“[将 Node.js 与 {% data variables.product.prodname_actions %} 一起使用](/actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions)。”
+
+您可能还发现基本了解以下内容是有帮助的：
+
+- "[配置 npm 用于 {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)"
+- "[环境变量](/actions/reference/environment-variables)"
+- [加密的密码](/actions/reference/encrypted-secrets)"
+- "[工作流程中的身份验证](/actions/reference/authentication-in-a-workflow)"
+
+### 关于包配置
+
+ *package.json* 文件中的 `name` 和 `version` 字段创建唯一标识符，供注册表用来将包链接到注册表。 您可以在 *package.json* 文件中添加 `description` 字段，从而为包列表页面添加一个摘要。 更多信息请参阅 npm 文档中的“[创建 package.json 文件](https://docs.npmjs.com/creating-a-package-json-file)”和“[创建 Node.js 模块](https://docs.npmjs.com/creating-node-js-modules)”。
+
+当本地 *.npmrc* 文件存在且指定了 `registry` 值时，`npm publish` 命令将使用 *.npmrc* 文件中配置的注册表。 {% data reusables.github-actions.setup-node-intro %}
+
+您可以使用 `setup-node` 操作指定运行器上安装的 Node.js 版本。
+
+如果在工作流程中添加步骤来配置 *package.json* 文件中的 `publishConfig` 字段，则无需使用 `setup-node` 操作指定注册表 url，但软件包仅限于发布到一个注册表。 更多信息请参阅 npm 文档中的“[publishConfig](https://docs.npmjs.com/files/package.json#publishconfig)”。
+
+### 发布包到 npm 注册表
+
+每次创建新版本时，都可以触发工作流程来发布包。 以下示例中的工作流程在类型为 `created` 的 `release` 事件触发时运行。 如果 CI 测试通过，工作流程将包发布到 npm 注册表。
+
+要根据工作流程中的 npm 注册表执行经过身份验证的操作，您需要在仓库设置中将 npm 身份验证令牌作存储为密码。 例如，创建名为 `NPM_TOKEN` 的密码。 更多信息请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。
+
+默认情况下，npm 使用 *package.json* 文件的 `name` 字段来确定 npm 注册表。 当发布到全局命名空间时，您只需要包含包名称。 例如，您要发布一个名为 `npm-hello-world-test` 的包到 `https://www.npmjs.com/package/npm-hello-world-test`。
+
+如果发布一个包含范围前缀的包，请将范围包含在 *package.json* 文件的名称中。 例如，如果 npm 范围前缀是 octocat 并且包名是 hello-world，则 *package.json* 文件中的 `name` 应为 `@octocat/hello-world`。 如果 npm 包使用范围前缀且包是公开的，则需使用选项 `npm publish --access public`。 这是 npm 需要用来防止有人无意中发布私有包的选项。
+
+此示例将 `NPM_TOKEN` 密码存储在 `NODE_AUTH_TOKEN` 环境变量中。 当 `setup-node` 操作创建 *.npmrc* 文件时，会引用 `NODE_AUTH_TOKEN` 环境变量中的令牌。
+
+{% raw %}
+```yaml
+name: Node.js Package
+on:
+  release:
+    types: [created]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    # Setup .npmrc file to publish to npm
+    - uses: actions/setup-node@v1
+      with:
+        node-version: '12.x'
+        registry-url: 'https://registry.npmjs.org'
+    - run: npm install
+    - run: npm publish
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+```
+{% endraw %}
+
+在上面的示例中，`setup-node` 操作在运行器上创建一个包含以下内容的 *.npmrc* 文件：
+
+```
+//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN}
+registry=https://registry.npmjs.org/
+always-auth=true
+```
+
+### 发布包到 {% data variables.product.prodname_registry %}
+
+每次创建新版本时，都可以触发工作流程来发布包。 以下示例中的工作流程在类型为 `created` 的 `release` 事件发生时运行。 如果 CI 测试通过，工作流程会将包发布到 {% data variables.product.prodname_registry %}。
+
+默认情况下，{% data variables.product.prodname_registry %} 将包发布到您在 *package.json* 文件的 `name` 字段中指定的 {% data variables.product.prodname_dotcom %} 仓库。 例如，您要发布一个名为 `@my-org/test` 的包到 `my-org/test` {% data variables.product.prodname_dotcom %} 仓库。 更多信息请参阅 npm 文档中的 [`npm-scope`](https://docs.npmjs.com/misc/scope)。
+
+要根据 {% data variables.product.prodname_registry %} 注册表在工作流程中执行经验证的操作，可以使用 `GITHUB_TOKEN`。 `GITHUB_TOKEN` 默认存在于您的仓库中，并且对工作流程运行的仓库中的包具有读取和写入权限。 更多信息请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。
+
+此示例将 `GITHUB_TOKEN` 密码存储在 `NODE_AUTH_TOKEN` 环境变量中。 当 `setup-node` 操作创建 *.npmrc* 文件时，会引用 `NODE_AUTH_TOKEN` 环境变量中的令牌。
+
+{% raw %}
+```yaml
+name: Node.js Package
+on:
+  release:
+    types: [created]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    # 设置 .npmrc 文件以发布到 GitHub 包
+    - uses: actions/setup-node@v1
+      with:
+        node-version: '12.x'
+        registry-url: 'https://npm.pkg.github.com'
+        # 默认为拥有工作流程文件的用户或组织
+        scope: '@octocat'
+    - run: npm install
+    - run: npm publish
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
+
+`setup-node` 操作在运行器上创建 *.npmrc* 文件。 使用 `scope` 输入到 `setup-node` 操作时，*.npmrc* 文件包含作用域前缀。 默认情况下，`setup-node` 操作在 *.npmrc* 文件中将作用域设置为包含该工作流程文件的帐户。
+
+```
+//npm.pkg.github.com/:_authToken=${NODE_AUTH_TOKEN}
+@octocat:registry=https://npm.pkg.github.com
+always-auth=true
+```
+
+### 使用 yarn 发布包
+
+如果您使用 Yarn 包管理器，可以使用 Yarn 安装和发布包。
+
+{% raw %}
+```yaml
+name: Node.js Package
+on:
+  release:
+    types: [created]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    # 设置 .npmrc 文件以发布到 npm
+    - uses: actions/setup-node@v1
+      with:
+        node-version: '12.x'
+        registry-url: 'https://registry.npmjs.org'
+        # 默认为拥有工作流程文件的用户或组织
+        scope: '@octocat' 
+    - run: yarn
+    - run: yarn publish
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+```
+{% endraw %}
+
+### 发布包到 npm 和 {% data variables.product.prodname_registry %}
+
+{% note %}
+
+**注意：**如果需要发布到具有不同作用域前缀的注册表，则需修改运行器上的 *package.json* 文件以更改作用域前缀。 例如，如果将包发布到 npm 的 `@mona` 作用域和 {% data variables.product.prodname_registry %} 的 `@octocat` 作用域，则可在发布到 npm 之后和发布到 {% data variables.product.prodname_registry %} 之前，在运行器的 *package.json* 文件中将 `@mona` 作用域替换成 `@octocat`。
+
+{% endnote %}
+
+您可以使用每个注册表的 `setup-node` 操作将包发布到 npm 注册表和 {% data variables.product.prodname_registry %}。
+
+如果将包发布到两个注册表，则需要确保 npm 上的作用域前缀与 {% data variables.product.prodname_dotcom %} 用户或组织名称匹配。 要将包发布到具有作用域前缀的公共注册表，可以使用 `npm publish --access public`。 更多信息请参阅 [`npm-scope`](https://docs.npmjs.com/misc/scope) 和 npm 文档中的“[创建和发布作用域的公共包](https://docs.npmjs.com/creating-and-publishing-scoped-public-packages)”。
+
+确认 *package.json* 文件包含 {% data variables.product.prodname_dotcom %} 仓库和 npm 注册表的作用域。 例如，如果您计划将 `octocat/npm-hello-world-test` 仓库中的包发布到 {% data variables.product.prodname_dotcom %} 和 https://www.npmjs.com/package/@octocat/npm-hello-world-test，则 *package.json* 文件中的名称将是 `"name": "@octocat/npm-hello-world-test"`。
+
+要根据 {% data variables.product.prodname_registry %} 注册表在工作流程中执行经验证的操作，可以使用 `GITHUB_TOKEN`。 `GITHUB_TOKEN` 默认存在于您的仓库中，并且对工作流程运行的仓库中的包具有读取和写入权限。 更多信息请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。
+
+使用 `scope` 输入到 `setup-node` 操作时，操作将创建包含作用域前缀的 *.npmrc* 文件。 默认情况下，`setup-node` 操作在 *.npmrc* 文件中将作用域设置为拥有该工作流程文件的用户或组织。
+
+此工作流程将调用 `setup-node` 操作两次。 每当 `setup-node` 操作运行时，都会覆盖 *.npmrc* 文件。 *.npmrc* 文件引用的令牌允许您对 `NODE_AUTH_TOKEN` 环境变量中的包注册表执行验证的操作。 工作流程在 `npm publish` 命令每次运行时设置 `NODE_AUTH_TOKEN` 环境变量，先通过令牌发布到 npm (`NPM_TOKEN`)，然后通过令牌发布到 {% data variables.product.prodname_registry %} (`GITHUB_TOKEN`)。
+
+{% raw %}
+```yaml
+name: Node.js Package
+on:
+  release:
+    types: [created]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    # 设置 .npmrc 文件以发布到 npm
+    - uses: actions/setup-node@v1
+      with:
+        node-version: '10.x'
+        registry-url: 'https://registry.npmjs.org'
+    - run: npm install
+    # 发布到 npm
+    - run: npm publish --access public
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+    # 设置 .npmrc 文件以发布到 GitHub 包
+    - uses: actions/setup-node@v1
+      with:
+        registry-url: 'https://npm.pkg.github.com'
+        # 默认为拥有工作流程文件的用户或组织
+        scope: '@octocat'
+    # 发布到 GitHub 包
+    - run: npm publish
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+{% endraw %}
diff --git a/translations/zh-CN/content/actions/guides/setting-up-continuous-integration-using-workflow-templates.md b/translations/zh-CN/content/actions/guides/setting-up-continuous-integration-using-workflow-templates.md
new file mode 100644
index 000000000000..e6e6040685fc
--- /dev/null
+++ b/translations/zh-CN/content/actions/guides/setting-up-continuous-integration-using-workflow-templates.md
@@ -0,0 +1,43 @@
+---
+title: 使用工作流程模板设置持续集成
+shortTitle: 使用模板设置 CI
+intro: 您可以使用与您要用的语言和工具匹配的工作流程模板为项目设置持续集成。
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /articles/setting-up-continuous-integration-using-github-actions
+  - /github/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions
+  - /actions/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions
+  - /actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+对仓库具有写入权限的任何人都可以使用 {% data variables.product.prodname_actions %} 设置持续集成 (CI)。
+
+在设置 CI 后，可以根据您的需求自定义工作流程。
+
+{% data reusables.repositories.navigate-to-repo %}
+{% data reusables.repositories.actions-tab %}
+1. 找到与您要用的语言和工具匹配的模板，然后单击 **Set up this workflow（设置此工作流程）**。 ![设置工作流程按钮](/assets/images/help/repository/setup-workflow-button.png)
+5. 单击 **Start commit（开始提交）**。 ![开始提交按钮](/assets/images/help/repository/start-commit.png)
+{% data reusables.files.write_commit_message %}
+{% data reusables.files.choose_commit_branch %}
+{% data reusables.files.propose_new_file %}
+
+在推送到仓库后，您可以在 {% data variables.product.prodname_dotcom %} 上跟踪持续集成工作流程运行的状态和详细日志，并接收自定义的通知。 更多信息请参阅“[配置通知](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)”和“[管理工作流程运行](/articles/managing-a-workflow-run)”。
+
+{% data reusables.repositories.actions-workflow-status-badge-into %}
+
+更多信息请参阅“[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)”。
+
+### 延伸阅读
+
+- "[关于持续集成](/articles/about-continuous-integration)"
+- "[管理工作流程运行](/articles/managing-a-workflow-run)"
+{% if currentVersion == "free-pro-team@latest" %}
+- "[管理 {% data variables.product.prodname_actions %} 的计费](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)"
+{% endif %}
diff --git a/translations/zh-CN/content/actions/guides/storing-workflow-data-as-artifacts.md b/translations/zh-CN/content/actions/guides/storing-workflow-data-as-artifacts.md
new file mode 100644
index 000000000000..0d48fdd81d17
--- /dev/null
+++ b/translations/zh-CN/content/actions/guides/storing-workflow-data-as-artifacts.md
@@ -0,0 +1,249 @@
+---
+title: 将工作流程数据存储为构件
+shortTitle: 存储工作流程构件
+intro: 构件允许您在工作流程完成后，分享工作流程中作业之间的数据并存储数据。
+product: '{% data reusables.gated-features.actions %}'
+redirect_from:
+  - /articles/persisting-workflow-data-using-artifacts
+  - /github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts
+  - /actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts
+  - /actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts
+versions:
+  free-pro-team: '*'
+  enterprise-server: '>=2.22'
+---
+
+{% data reusables.actions.enterprise-beta %}
+{% data reusables.actions.enterprise-github-hosted-runners %}
+
+### 关于工作流程构件
+
+构件允许您在作业完成后保留数据，并与同一工作流程中的另一个作业共享该数据。 构件是指在工作流程运行过程中产生的文件或文件集。 例如，在工作流程运行结束后，您可以使用构件保存您的构建和测试输出。
+
+{% data reusables.github-actions.artifact-log-retention-statement %} The retention period for a pull request restarts each time someone pushes a new commit to the pull request.
+
+以下是您可以上传的一些常见构件：
+
+- 日志文件和核心转储文件
+- 测试结果、失败和屏幕截图
+- 二进制或压缩文件
+- 压力测试性能输出和代码覆盖结果
+
+{% if currentVersion == "free-pro-team@latest" %}
+
+存储构件时使用存储空间 {% data variables.product.product_name %}。 {% data reusables.github-actions.actions-billing %} 更多信息请参阅“[管理 {% data variables.product.prodname_actions %} 的计费](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)”。
+
+{% else %}
+
+项目会占用外部 Blob 存储上的存储空间，该存储为 {% data variables.product.product_location %} 上的 {% data variables.product.prodname_actions %} 配置。
+
+{% endif %}
+
+构件会在工作流程运行过程中上传，您可以在 UI 中查看构件的名称和大小。 当构件使用 {% data variables.product.product_name %} UI 下载时， 作为构件一部分单独上传的所有文件都会压缩到一个 zip 文件中。 这意味着计费是根据上传的构件大小而不是 zip 文件的大小计算的。
+
+{% data variables.product.product_name %} 提供两项可用于上传和下载构建构件的操作。 更多信息请参阅 {% if currentVersion == "free-pro-team@latest" %}[actions/upload-artifact](https://github.com/actions/upload-artifact) and [download-artifact](https://github.com/actions/download-artifact) 操作{% else %} {% data variables.product.product_location %} 上的 `actions/upload-artifact` 和 `download-artifact` 操作{% endif %}。
+
+要在作业之间共享数据：
+
+* **上传文件**：为上传的文件提供名称并在作业结束前上传数据。
+* **下载文件**：您只能下载在同一工作流程运行过程中上传的构件。 下载文件时，您可以通过名称引用该文件。
+
+作业步骤共享运行器机器的相同环境，但在其各自的进程中运行。 要在作业的步骤之间传递数据，您可以使用输入和输出。 有关输入和输出的更多信息，请参阅“[{% data variables.product.prodname_actions %} 的元数据语法](/articles/metadata-syntax-for-github-actions)”。
+
+### 上传构建和测试构件
+
+您可以创建持续集成 (CI) 工作流程来构建和测试您的代码。 关于使用 {% data variables.product.prodname_actions %} 执行 CI 的更多信息，请参阅“[关于持续集成](/articles/about-continuous-integration)”。
+
+构建和测试代码的输出通常会生成可用于调试测试失败的文件和可部署的生产代码。 您可以配置一个工作流程来构建和测试推送到仓库中的代码，并报告成功或失败状态。 您可以上传构建和测试输出，以用于部署、调试失败的测试或崩溃以及查看测试套件范围。
+
+您可以使用 `upload-artifact` 操作上传构件。 上传构件时，您可以指定单个文件或目录，或多个文件或目录。 您还可以排除某些文件或目录，以及使用通配符模式。 我们建议您为构件提供名称，但如果未提供名称，则会使用 `artifact` 作为默认名称。 有关语法的更多信息，请参阅 {% if currentVersion == "free-pro-team@latest" %}[actions/upload-artifact](https://github.com/actions/upload-artifact) 操作{% else %} {% data variables.product.product_location %} 上的 `actions/upload-artifact` 操作{% endif %}。
+
+#### 示例
+
+例如，您的仓库或 Web 应用程序可能包含必须转换为 CSS 和 JavaScript 的 SASS 和 TypeScript 文件。 假设您的构建配置输出 `dist` 目录中已编译的文件，如果所有测试均已成功完成，则可将 `dist` 目录中的文件部署到您的 Web 应用程序服务器。
+
+```
+|-- hello-world (repository)
+|   └── dist
+|   └── tests
+|   └── src
+|       └── sass/app.scss
+|       └── app.ts
+|   └── output
+|       └── test
+|   
+```
+
+本例向您展示如何创建 Node.js 项目的工作流程，该项目在 `src` 目录中 `builds` 代码，并在 `tests` 目录中运行测试。 您可以假设运行 `npm test` 会产生名为 `code-coverage.html`、存储在 `output/test/` 目录中的代码覆盖报告。
+
+工作流程上传 `dist` 目录中的生产构件，但不包括任何 markdown 文件。 它还会上传 `code-coverage.html` 报告作为另一个构件。
+
+```yaml
+name: Node CI
+
+on: [push]
+
+jobs:
+  build_and_test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v2
+      - name: npm install, build, and test
+        run: |
+          npm install
+          npm run build --if-present
+          npm test
+      - name: Archive production artifacts
+        uses: actions/upload-artifact@v2
+        with:
+          name: dist-without-markdown
+          path: |
+            dist
+            !dist/**/*.md
+      - name: Archive code coverage results
+        uses: actions/upload-artifact@v2
+        with:
+          name: code-coverage-report
+          path: output/test/code-coverage.html
+```
+
+![工作流程上传构件工作流程运行的图像](/assets/images/help/repository/upload-build-test-artifact.png)
+
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+### Configuring a custom artifact retention period
+
+You can define a custom retention period for individual artifacts created by a workflow. When using a workflow to create a new artifact, you can use `retention-days` with the `upload-artifact` action. This example demonstrates how to set a custom retention period of 5 days for the artifact named `my-artifact`:
+
+```
+  - name: 'Upload Artifact'
+    uses: actions/upload-artifact@v2
+    with:
+      name: my-artifact
+      path: my_file.txt
+      retention-days: 5
+```
+
+The `retention-days` value cannot exceed the retention limit set by the repository, organization, or enterprise.
+{% endif %}
+
+### 下载或删除构件
+
+During a workflow run, you can use the [`download-artifact`](https://github.com/actions/download-artifact)action to download artifacts that were previously uploaded in the same workflow run.
+
+After a workflow run has been completed, you can download or delete artifacts on {% data variables.product.prodname_dotcom %} or using the REST API. For more information, see "[Downloading workflow artifacts](/actions/managing-workflow-runs/downloading-workflow-artifacts)," "[Removing workflow artifacts](/actions/managing-workflow-runs/removing-workflow-artifacts)," and the "[Artifacts REST API](/v3/actions/artifacts/)."
+
+#### 在工作流程运行期间下载构件
+
+The [`actions/download-artifact`](https://github.com/actions/download-artifact) action can be used to download previously uploaded artifacts during a workflow run.
+
+{% note %}
+
+**注**：您只能下载在同一工作流程运行过程中上传的构件。
+
+{% endnote %}
+
+指定构件的名称以下载单个构件。 如果在未指定名称的情况下上传构件目，则使用默认名称 `artifact`。
+
+```yaml
+- name: Download a single artifact
+  uses: actions/download-artifact@v2
+  with:
+    name: my-artifact
+```
+
+您还可以不指定名称而下载工作流程运行中的所有构件。 如果您在处理大量构件，此功能非常有用。
+
+```yaml
+- name: Download all workflow run artifacts
+  uses: actions/download-artifact@v2
+```
+
+如果下载所有工作流程运行的构件，则每个构件使用其名称目创建目录。
+
+有关语法的更多信息，请参阅 {% if currentVersion == "free-pro-team@latest" %}[actions/download-artifact](https://github.com/actions/download-artifact) 操作{% else %} {% data variables.product.product_location %} 上的 `actions/download-artifact` 操作{% endif %}。
+
+### 在工作流程中作业之间传递数据
+
+您可以使用 `upload-artifact` 和 `download-artifact` 操作在工作流程中的作业之间共享数据。 此示例工作流程说明如何在相同工作流程中的任务之间传递数据。 更多信息请参阅 {% if currentVersion == "free-pro-team@latest" %}[actions/upload-artifact](https://github.com/actions/upload-artifact) and [download-artifact](https://github.com/actions/download-artifact) 操作{% else %} {% data variables.product.product_location %} 上的 `actions/upload-artifact` 和 `download-artifact` 操作{% endif %}。
+
+依赖于以前作业构件的作业必须等待依赖项成功完成。 此工作流程使用 `needs` 关键词确保 `job_1`、 `job_2` 和 `job_3` 按顺序运行。 例如， `job_2` 需要 `job_1` 使用 `needs: job_1` 语法。
+
+作业1执行以下步骤：
+- 执行数学计算并将结果保存到名为 `math-home-work.txt` 的文本文件。
+- 使用 `upload-artifact` 操作上传名为 `homework` 的 `math-homework.txt` 文件。 该操作将文件置于一个名为 `homework` 的目录中。
+
+作业 2 使用上一个作业的结果：
+- 下载上一个作业中上传的 `homework` 构件。 默认情况下， `download-artifact` 操作会将构件下载到该步骤执行的工作区目录中。 您可以使用 `path` 输入参数指定不同的下载目录。
+- 读取 `homework/math-homework.txt` 文件中的值，进行数学计算，并将结果保存到 `math-homework.txt`。
+- 更新 `math-homework.txt` 文件。 此上传会覆盖之前的上传，因为两次上传共用同一名称。
+
+作业 3 显示上一个作业中上传的结果：
+- 下载 `homework` 构件。
+- 将数学方程式的结果打印到日志中。
+
+此工作流程示例中执行的完整数学运算为 `(3 + 7) x 9 = 90`。
+
+```yaml
+name: Share data between jobs
+
+on: [push]
+
+jobs:
+  job_1:
+    name: Add 3 and 7
+    runs-on: ubuntu-latest
+    steps:
+      - shell: bash
+        run: |
+          expr 3 + 7 > math-homework.txt
+      - name: Upload math result for job 1
+        uses: actions/upload-artifact@v2
+        with:
+          name: homework
+          path: math-homework.txt
+
+  job_2:
+    name: Multiply by 9
+    needs: job_1
+    runs-on: windows-latest
+    steps:
+      - name: Download math result for job 1
+        uses: actions/download-artifact@v2
+        with:
+          name: homework
+      - shell: bash
+        run: |
+          value=`cat math-homework.txt`
+          expr $value \* 9 > math-homework.txt
+      - name: Upload math result for job 2
+        uses: actions/upload-artifact@v2
+        with:
+          name: homework
+          path: math-homework.txt
+
+  job_3:
+    name: Display results
+    needs: job_2
+    runs-on: macOS-latest
+    steps:
+      - name: Download math result for job 2
+        uses: actions/download-artifact@v2
+        with:
+          name: homework
+      - name: Print the final result
+        shell: bash
+        run: |
+          value=`cat math-homework.txt`
+          echo The result is $value
+```
+
+![要在作业之间传递数据以执行数学工作流程](/assets/images/help/repository/passing-data-between-jobs-in-a-workflow.png)
+
+{% if currentVersion == "free-pro-team@latest" %}
+
+### 延伸阅读
+
+- "[管理 {% data variables.product.prodname_actions %} 的计费](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)".
+
+{% endif %}
diff --git a/translations/zh-CN/content/actions/hosting-your-own-runners/about-self-hosted-runners.md b/translations/zh-CN/content/actions/hosting-your-own-runners/about-self-hosted-runners.md
index b099871518b4..8d7c6be7009e 100644
--- a/translations/zh-CN/content/actions/hosting-your-own-runners/about-self-hosted-runners.md
+++ b/translations/zh-CN/content/actions/hosting-your-own-runners/about-self-hosted-runners.md
@@ -53,6 +53,15 @@ versions:
 * 机器有足够的硬件资源来执行您计划运行的工作流程类型。 自托管运行器应用程序本身只需要很少的资源。
 * 如果您想运行使用 Docker 容器操作或服务容器的工作流程，您必须使用 Linux 机器并安装 Docker。
 
+### 使用限制
+
+在使用自托管的运行器时，对 {% data variables.product.prodname_actions %} 的使用有一些限制。 这些限制可能会有变动。
+
+{% data reusables.github-actions.usage-workflow-run-time %}
+- **作业排队时间** - 自托管运行器的每个作业最多可排队 24 小时。 如果自托管运行器在此限制内没有开始执行作业，则作业将被终止，并且无法完成。
+{% data reusables.github-actions.usage-api-requests %}
+- **作业矩阵** - {% data reusables.github-actions.usage-matrix-limits %}
+
 ### 自托管运行器支持的操作系统
 
 自托管运行器应用程序支持以下操作系统。
diff --git a/translations/zh-CN/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md b/translations/zh-CN/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md
index 0c4ae5113a65..5ca1eff5e5f1 100644
--- a/translations/zh-CN/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md
+++ b/translations/zh-CN/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md
@@ -1,6 +1,6 @@
 ---
 title: 添加自托管的运行器
-intro: '您可以将自托管的运行器添加到 {% data variables.product.prodname_actions %}。'
+intro: '您可以将自托管的运行器添加到 {{ site.data.variables.product.prodname_actions }}。'
 redirect_from:
   - /github/automating-your-workflow-with-github-actions/adding-self-hosted-runners
   - /actions/automating-your-workflow-with-github-actions/adding-self-hosted-runners
@@ -51,7 +51,8 @@ versions:
 {% if currentVersion == "free-pro-team@latest" %}
 要将自托管的运行器添加到企业帐户，您必须是组织所有者。
 {% else if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21"%}
-要在 {% data variables.product.product_location %} 的企业级别添加自托管的运行器，您必须是站点管理员。
+要在
+{% data variables.product.product_location %} 的企业级添加自托管运行器，您必须是网站管理员。
 {% endif %}
 
 {% if currentVersion == "free-pro-team@latest" %}
diff --git a/translations/zh-CN/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md b/translations/zh-CN/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md
index d90c219db0e5..0b2501b51626 100644
--- a/translations/zh-CN/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md
+++ b/translations/zh-CN/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md
@@ -13,7 +13,7 @@ versions:
 {% data reusables.actions.enterprise-beta %}
 {% data reusables.actions.enterprise-github-hosted-runners %}
 
-### 使用 {% data variables.product.prodname_dotcom %} 检查自托管运行器的状态
+### 使用 {{ site.data.variables.product.prodname_dotcom }} 检查自托管运行器的状态
 
 {% data reusables.github-actions.self-hosted-runner-management-permissions-required %}
 
diff --git a/translations/zh-CN/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md b/translations/zh-CN/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md
index 5a1e1284693f..5b8afaea2646 100644
--- a/translations/zh-CN/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md
+++ b/translations/zh-CN/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md
@@ -1,6 +1,6 @@
 ---
 title: 删除自托管的运行器
-intro: '您可以从 {% data variables.product.prodname_actions %} 永久删除自托管的运行器。'
+intro: '您可以从 {{ site.data.variables.product.prodname_actions }} 永久删除自托管的运行器。'
 redirect_from:
   - /github/automating-your-workflow-with-github-actions/removing-self-hosted-runners
   - /actions/automating-your-workflow-with-github-actions/removing-self-hosted-runners
@@ -63,7 +63,8 @@ versions:
 {% if currentVersion == "free-pro-team@latest" %}
 要从企业帐户删除自托管运行器，您必须是组织所有者。 建议您也访问自托管的运行器机器。
 {% else if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21"%}
-要从组织删除自托管的运行器，您必须是组织所有者。 建议您也访问自托管的运行器机器。
+要在
+{% data variables.product.product_location %} 的企业级添加自托管运行器，您必须是网站管理员。 建议您也访问自托管的运行器机器。
 {% endif %}
 
 {% data reusables.github-actions.self-hosted-runner-reusing %}
diff --git a/translations/zh-CN/content/actions/hosting-your-own-runners/using-self-hosted-runners-in-a-workflow.md b/translations/zh-CN/content/actions/hosting-your-own-runners/using-self-hosted-runners-in-a-workflow.md
index e90a590ef6db..3e81714645fd 100644
--- a/translations/zh-CN/content/actions/hosting-your-own-runners/using-self-hosted-runners-in-a-workflow.md
+++ b/translations/zh-CN/content/actions/hosting-your-own-runners/using-self-hosted-runners-in-a-workflow.md
@@ -1,6 +1,6 @@
 ---
 title: 在工作流程中使用自托管的运行器
-intro: 要在工作流程中使用自托管的运行器，您可以使用标签为作业指定运行器类型。
+intro: '要在工作流程中使用自托管的运行器，您可以使用标签为作业指定运行器类型。'
 redirect_from:
   - /github/automating-your-workflow-with-github-actions/using-self-hosted-runners-in-a-workflow
   - /actions/automating-your-workflow-with-github-actions/using-self-hosted-runners-in-a-workflow
diff --git a/translations/zh-CN/content/actions/index.md b/translations/zh-CN/content/actions/index.md
index 809eb35725d5..c19ea3e41f34 100644
--- a/translations/zh-CN/content/actions/index.md
+++ b/translations/zh-CN/content/actions/index.md
@@ -33,8 +33,8 @@ versions:
 
 
 
-
        
-  
        
+
        
+  
        
     
        
       
        {% data ui.toc.getting_started %}
        
     
        
@@ -45,7 +45,7 @@ versions:
    -
    +

    {% data ui.toc.popular_articles %}

    @@ -56,7 +56,7 @@ versions:
    -
    +

    管理工作流程

    @@ -68,22 +68,28 @@ versions:
    -
    - -
    {% octicon "bookmark" width="24" %}
    -

    创建操作

    -

    创建并与社区分享操作的完整指南。

    -     - -
    {% octicon "rocket" width="24" %}
    -

    入门工作流程

    -

    帮助您开始使用 GitHub Actions 的工作流程文件集合。

    -     - -
    {% octicon "light-bulb" width="24" %}
    -

    GitHub Actions Marketplace

    -

    探索社区操作并支持您的工作流程。

    -     +
    +
    + +
    {% octicon "bookmark" width="24" %}
    +

    创建操作

    +

    创建操作并与社区分享的完整指南

    +     +
    +
    + +
    {% octicon "rocket" width="24" %}
    +

    初学者工作流程

    +

    工作流程文件的集合，以帮助您开始使用 GitHub Actions。

    +     +
    +
    + +
    {% octicon "light-bulb" width="24" %}
    +

    GitHub Actions Marketplace

    +

    探索社区操作并增强您的工作流程。

    +     +
    @@ -91,7 +97,7 @@ versions:

    指南

    -
    +

    构建和测试 Node.js

    @@ -107,7 +113,7 @@ versions:
    -
    +

    构建和测试 Python

    @@ -123,7 +129,7 @@ versions:
    -
    +

    使用 Maven 构建和测试 Java

    @@ -139,7 +145,7 @@ versions:
    -
    +

    使用 Gradle 构建和测试 Java

    @@ -155,7 +161,7 @@ versions:
    -
    +

    使用 Ant 构建和测试 Java

    @@ -171,7 +177,7 @@ versions:
    -
    +

    发布 Node.js 包

    diff --git a/translations/zh-CN/content/actions/learn-github-actions/essential-features-of-github-actions.md b/translations/zh-CN/content/actions/learn-github-actions/essential-features-of-github-actions.md new file mode 100644 index 000000000000..2c52a74f78f6 --- /dev/null +++ b/translations/zh-CN/content/actions/learn-github-actions/essential-features-of-github-actions.md @@ -0,0 +1,95 @@ +--- +title: GitHub Actions 的基本功能 +shortTitle: 基本功能 +intro: '{% data variables.product.prodname_actions %} 旨在帮助您建立强大而动态的自动化。 本指南说明如何创建包括环境变量、定制化脚本等的 {% data variables.product.prodname_actions %} 工作流程。' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### 概览 + +{% data variables.product.prodname_actions %} 允许您自定义工作流程，以满足应用程序和团队的独特需求。 在本指南中，我们将讨论一些基本的自定义技术，例如使用变量、运行脚本以及在作业之间共享数据和构件。 + +### 在工作流程中使用变量 + +{% data variables.product.prodname_actions %} 包含每个工作流程运行的默认环境变量。 如果您需要使用自定义环境变量，可以在 YAML 工作流程文件中设置这些变量。 此示例演示如何创建名为 `POSTGRES_HOST` 和 `POSTGRES_PORT` 的自定义变量。 然后，这些变量可供 `node client.js` 脚本使用。 + +```yaml +jobs: + example-job: + steps: + - name: Connect to PostgreSQL + run: node client.js + env: + POSTGRES_HOST: postgres + POSTGRES_PORT: 5432 +``` + +更多信息请参阅“[使用环境变量](/actions/configuring-and-managing-workflows/using-environment-variables)”。 + +### 添加脚本到工作流程 + +您可以使用操作来运行脚本和 shell 命令，然后在指定的运行器上执行。 此示例演示操作如何使用 `run` 关键字在运行器上执行 `npm install -g bats`。 + +```yaml +jobs: + example-job: + steps: + - run: npm install -g bats +``` + +例如，要将脚本作为操作运行，您可以将脚本存储在您的仓库中并提供路径和 shell 类型。 + +```yaml +jobs: + example-job: + steps: + - name: Run build script + run: ./.github/scripts/build.sh + shell: bash +``` + +更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)”。 + +### 在作业之间共享数据 + +If your job generates files that you want to share with another job in the same workflow, or if you want to save the files for later reference, you can store them in {% data variables.product.prodname_dotcom %} as _artifacts_. 构件是创建并测试代码时所创建的文件。 例如，构件可能包含二进制或包文件、测试结果、屏幕截图或日志文件。 Artifacts are associated with the workflow run where they were created and can be used by another job. + +For example, you can create a file and then upload it as an artifact. + +```yaml +jobs: + example-job: + name: Save output + steps: + - shell: bash + run: | + expr 1 + 1 > output.log + - name: Upload output file + uses: actions/upload-artifact@v1 + with: + name: output-log-file + path: output.log +``` + +To download an artifact from a separate workflow run, you can use the `actions/download-artifact` action. For example, you can download the artifact named `output-log-file`. + +```yaml +jobs: + example-job: + steps: + - name: Download a single artifact + uses: actions/download-artifact@v2 + with: + name: output-log-file +``` + +For more information about artifacts, see "[Persisting workflow data using artifacts](/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts)." + +### 后续步骤 + +To continue learning about {% data variables.product.prodname_actions %}, see "[Managing complex workflows](/actions/learn-github-actions/managing-complex-workflows)." diff --git a/translations/zh-CN/content/actions/learn-github-actions/finding-and-customizing-actions.md b/translations/zh-CN/content/actions/learn-github-actions/finding-and-customizing-actions.md new file mode 100644 index 000000000000..c0eeb93d8ede --- /dev/null +++ b/translations/zh-CN/content/actions/learn-github-actions/finding-and-customizing-actions.md @@ -0,0 +1,156 @@ +--- +title: Finding and customizing actions +shortTitle: Finding and customizing actions +intro: 'Actions are the building blocks that power your workflow. A workflow can contain actions created by the community, or you can create your own actions directly within your application''s repository. This guide will show you how to discover, use, and customize actions.' +redirect_from: + - /actions/automating-your-workflow-with-github-actions/using-github-marketplace-actions + - /actions/automating-your-workflow-with-github-actions/using-actions-from-github-marketplace-in-your-workflow + - /actions/getting-started-with-github-actions/using-actions-from-github-marketplace + - /actions/getting-started-with-github-actions/using-community-workflows-and-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### 概览 + +The actions you use in your workflow can be defined in: + +- 公共仓库 +- The same repository where your workflow file references the action +- Docker Hub 上发布的 Docker 容器图像 + +{% data variables.product.prodname_marketplace %} 是一个中心位置，可供查找由 {% data variables.product.prodname_dotcom %} 社区构建的操作。 [{% data variables.product.prodname_marketplace %} page](https://github.com/marketplace/actions/) enables you to filter for actions by category. + +{% data reusables.actions.enterprise-marketplace-actions %} + +### Browsing Marketplace actions in the workflow editor + +您可以直接在仓库的工作流程编辑器中搜索和浏览操作。 从边栏可以搜索特定的操作、查看特色操作和浏览特色类别。 您也可以查看操作从 {% data variables.product.prodname_dotcom %} 社区获得的星标数。 + +1. 在仓库中，浏览至要编辑的工作流程文件。 +1. 要打开工作流程编辑器，在文件视图右上角单击 {% octicon "pencil" aria-label="The edit icon" %}。 ![编辑工作流程文件按钮](/assets/images/help/repository/actions-edit-workflow-file.png) +1. 在编辑器右侧，使用 {% data variables.product.prodname_marketplace %} 边栏浏览操作。 Actions with the {% octicon "verified" aria-label="The verified badge" %} badge indicate {% data variables.product.prodname_dotcom %} has verified the creator of the action as a partner organization. ![Marketplace 工作流程边栏](/assets/images/help/repository/actions-marketplace-sidebar.png) + +### Adding an action to your workflow + +操作的列表页包括操作的版本以及使用操作所需的工作流程语法。 To keep your workflow stable even when updates are made to an action, you can reference the version of the action to use by specifying the Git or Docker tag number in your workflow file. + +1. 导航到要在工作流程中使用的操作。 +1. 在“Installation（安装）”下，单击 {% octicon "clippy" aria-label="The edit icon" %} 复制工作流程语法。 ![查看操作列表](/assets/images/help/repository/actions-sidebar-detailed-view.png) +1. 将语法粘贴为工作流程中的新步骤。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idsteps)”。 +1. If the action requires you to provide inputs, set them in your workflow. For information on inputs an action might require, see "[Using inputs and outputs with an action](/actions/learn-github-actions/finding-and-customizing-actions#using-inputs-and-outputs-with-an-action)." + +{% if currentVersion == "free-pro-team@latest" %} + +{% data reusables.dependabot.version-updates-for-actions %} + +{% endif %} + +### Using release management for your custom actions + +The creators of a community action have the option to use tags, branches, or SHA values to manage releases of the action. Similar to any dependency, you should indicate the version of the action you'd like to use based on your comfort with automatically accepting updates to the action. + +You will designate the version of the action in your workflow file. Check the action's documentation for information on their approach to release management, and to see which tag, branch, or SHA value to use. + +#### Using tags + +Tags are useful for letting you decide when to switch between major and minor versions, but these are more ephemeral and can be moved or deleted by the maintainer. This example demonstrates how to target an action that's been tagged as `v1.0.1`: + +```yaml +steps: + - uses: actions/javascript-action@v1.0.1 +``` + +#### Using SHAs + +If you need more reliable versioning, you should use the SHA value associated with the version of the action. SHAs are immutable and therefore more reliable than tags or branches. However this approach means you will not automatically receive updates for an action, including important bug fixes and security updates. This example targets an action's SHA: + +```yaml +steps: + - uses: actions/javascript-action@172239021f7ba04fe7327647b213799853a9eb89 +``` + +#### Using branches + +Referring to a specific branch means that the action will always use include the latest updates on the target branch, but can create problems if those updates include breaking changes. This example targets a branch named `@main`: + +```yaml +steps: + - uses: actions/javascript-action@main +``` + +For more information, see "[Using release management for actions](/actions/creating-actions/about-actions#using-release-management-for-actions)." + +### Using inputs and outputs with an action + +An action often accepts or requires inputs and generates outputs that you can use. For example, an action might require you to specify a path to a file, the name of a label, or other data it will uses as part of the action processing. + +To see the inputs and outputs of an action, check the `action.yml` or `action.yaml` in the root directory of the repository. + +In this example `action.yml`, the `inputs` keyword defines a required input called `file-path`, and includes a default value that will be used if none is specified. The `outputs` keyword defines an output called `results-file`, which tells you where to locate the results. + +```yaml +name: 'Example' +description: 'Receives file and generates output' +inputs: + file-path: # id of input + description: "Path to test script" + required: true + default: 'test-file.js' +outputs: + results-file: # id of output + description: "Path to results file" +``` + +### 在工作流程文件使用操作的同一仓库中引用操作 + +如果操作在工作流程文件使用该操作的同一仓库中定义，您可以在工作流程文件中通过 ‌`{owner}/{repo}@{ref}` 或 `./path/to/dir` 语法引用操作。 + +示例仓库文件结构： + +``` +|-- hello-world (repository) +| |__ .github +| └── workflows +| └── my-first-workflow.yml +| └── actions +| |__ hello-world-action +| └── action.yml +``` + +示例工作流程文件： + +```yaml +jobs: + build: + runs-on: ubuntu-latest + steps: + # This step checks out a copy of your repository. + - uses: actions/checkout@v2 + # This step references the directory that contains the action. + - uses: ./.github/actions/hello-world-action +``` + +The `action.yml` file is used to provide metadata for the action. Learn about the content of this file in "[Metadata syntax for GitHub Actions](/actions/creating-actions/metadata-syntax-for-github-actions)" + +### 引用 Docker Hub 上的容器 + +如果操作在 Docker Hub 上发布的 Docker 容器图像中定义，您必须在工作流程文件中通过 `docker://{image}:{tag}` 语法引用操作。 为保护代码和数据，强烈建议先验证 Docker Hub 中 Docker 容器图像的完整性后再将其用于工作流程。 + +```yaml +jobs: + my_first_job: + steps: + - name: My first step + uses: docker://alpine:3.8 +``` + +有关 Docker 操作的部分示例，请参阅 [Docker-image.yml 工作流程](https://github.com/actions/starter-workflows/blob/main/ci/docker-image.yml)和“[创建 Docker 容器操作](/articles/creating-a-docker-container-action)”。 + +### 后续步骤 + +To continue learning about {% data variables.product.prodname_actions %}, see "[Essential features of {% data variables.product.prodname_actions %}](/actions/learn-github-actions/essential-features-of-github-actions)." diff --git a/translations/zh-CN/content/actions/learn-github-actions/index.md b/translations/zh-CN/content/actions/learn-github-actions/index.md new file mode 100644 index 000000000000..8bc97d038f8e --- /dev/null +++ b/translations/zh-CN/content/actions/learn-github-actions/index.md @@ -0,0 +1,42 @@ +--- +title: Learn GitHub Actions +shortTitle: Learn GitHub Actions +intro: 'Whether you are new to {% data variables.product.prodname_actions %} or interested in learning all they have to offer, this guide will help you use {% data variables.product.prodname_actions %} to accelerate your application development workflows.' +redirect_from: + - /articles/about-github-actions + - /github/automating-your-workflow-with-github-actions/about-github-actions + - /actions/automating-your-workflow-with-github-actions/about-github-actions + - /actions/getting-started-with-github-actions + - /actions/getting-started-with-github-actions/about-github-actions + - /actions/getting-started-with-github-actions/overview + - /actions/getting-started-with-github-actions/getting-started-with-github-actions + - /articles/migrating-github-actions-from-hcl-syntax-to-yaml-syntax/ + - /actions/configuring-and-managing-workflows/configuring-a-workflow + - /articles/creating-a-workflow-with-github-actions/ + - /articles/configuring-a-workflow + - /github/automating-your-workflow-with-github-actions/configuring-a-workflow + - /actions/automating-your-workflow-with-github-actions/configuring-a-workflow + - /actions/creating-workflows/workflow-configuration-options + - /articles/configuring-workflows + - /github/automating-your-workflow-with-github-actions/configuring-workflows + - /actions/automating-your-workflow-with-github-actions/configuring-workflows + - /github/automating-your-workflow-with-github-actions/getting-started-with-github-actions + - /actions/automating-your-workflow-with-github-actions/getting-started-with-github-actions + - /actions/configuring-and-managing-workflows + - /articles/getting-started-with-github-actions + - /actions/migrating-to-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% link_with_intro /introduction-to-github-actions %} +{% link_with_intro /finding-and-customizing-actions %} +{% link_with_intro /essential-features-of-github-actions %} +{% link_with_intro /managing-complex-workflows %} +{% link_with_intro /sharing-workflows-with-your-organization %} +{% link_with_intro /security-hardening-for-github-actions %} +{% link_with_intro /migrating-from-circleci-to-github-actions %} +{% link_with_intro /migrating-from-gitlab-cicd-to-github-actions %} +{% link_with_intro /migrating-from-azure-pipelines-to-github-actions %} +{% link_with_intro /migrating-from-jenkins-to-github-actions %} diff --git a/translations/zh-CN/content/actions/learn-github-actions/introduction-to-github-actions.md b/translations/zh-CN/content/actions/learn-github-actions/introduction-to-github-actions.md new file mode 100644 index 000000000000..8d1a4f66de97 --- /dev/null +++ b/translations/zh-CN/content/actions/learn-github-actions/introduction-to-github-actions.md @@ -0,0 +1,225 @@ +--- +title: Introduction to GitHub Actions +shortTitle: Introduction to GitHub Actions +intro: 'Learn about the core concepts and various components of {% data variables.product.prodname_actions %}, and see an example that shows you how to add automation to your repository.' +redirect_from: + - /github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions + - /actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions + - /actions/getting-started-with-github-actions/core-concepts-for-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### 概览 + +{% data variables.product.prodname_actions %} help you automate tasks within your software development life cycle. {% data variables.product.prodname_actions %} are event-driven, meaning that you can run a series of commands after a specified event has occurred. For example, every time someone creates a pull request for a repository, you can automatically run a command that executes a software testing script. + +This diagram demonstrates how you can use {% data variables.product.prodname_actions %} to automatically run your software testing scripts. An event automatically triggers the _workflow_, which contains a _job_. The job then uses _steps_ to control the order in which _actions_ are run. These actions are the commands that automate your software testing. + +![Workflow overview](/assets/images/help/images/overview-actions-simple.png) + +### The components of {% data variables.product.prodname_actions %} + +Below is a list of the multiple {% data variables.product.prodname_actions %} components that work together to run jobs. You can see how these components interact with each other. + +![Component and service overview](/assets/images/help/images/overview-actions-design.png) + +#### 工作流程 + +The workflow is an automated procedure that you add to your repository. Workflows are made up of one or more jobs and can be scheduled or triggered by an event. The workflow can be used to build, test, package, release, or deploy a project on {% data variables.product.prodname_dotcom %}. + +#### 事件 + +An event is a specific activity that triggers a workflow. 例如，当有推送提交到仓库或者创建议题或拉取请求时，{% data variables.product.prodname_dotcom %} 就可能产生活动。 You can also use the repository dispatch webhook to trigger a workflow when an external event occurs. For a complete list of events that can be used to trigger workflows, see [Events that trigger workflows](/actions/reference/events-that-trigger-workflows). + +#### Jobs + +A job is a set of steps that execute on the same runner. By default, a workflow with multiple jobs will run those jobs in parallel. You can also configure a workflow to run jobs sequentially. 例如，工作流程可以有两个连续的任务来构建和测试代码，其中测试作业取决于构建作业的状态。 如果构建作业失败，测试作业将不会运行。 + +#### Steps + +A step is an individual task that can run commands (known as _actions_). Each step in a job executes on the same runner, allowing the actions in that job to share data with each other. + +#### 操作 + +_Actions_ are standalone commands that are combined into _steps_ to create a _job_. 操作是工作流程最小的便携式构建块。 You can create your own actions, or use actions created by the {% data variables.product.prodname_dotcom %} community. 要在工作流程中使用操作，必须将其作为一个步骤。 + +#### Runners + +A runner is a server that has the {% data variables.product.prodname_actions %} runner application installed. You can use a runner hosted by {% data variables.product.prodname_dotcom %}, or you can host your own. A runner listens for available jobs, runs one job at a time, and reports the progress, logs, and results back to {% data variables.product.prodname_dotcom %}. For {% data variables.product.prodname_dotcom %}-hosted runners, each job in a workflow runs in a fresh virtual environment. + +{% data variables.product.prodname_dotcom %}-hosted runners are based on Ubuntu Linux, Microsoft Windows, and macOS. For information on {% data variables.product.prodname_dotcom %}-hosted runners, see "[Virtual environments for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/virtual-environments-for-github-hosted-runners)." If you need a different operating system or require a specific hardware configuration, you can host your own runners. For information on self-hosted runners, see "[Hosting your own runners](/actions/hosting-your-own-runners)." + +### Create an example workflow + +{% data variables.product.prodname_actions %} uses YAML syntax to define the events, jobs, and steps. These YAML files are stored in your code repository, in a directory called `.github/workflows`. + +You can create an example workflow in your repository that automatically triggers a series of commands whenever code is pushed. In this workflow, {% data variables.product.prodname_actions %} checks out the pushed code, installs the software dependencies, and runs `bats -v`. + +1. In your repository, create the `.github/workflows/` directory to store your workflow files. +1. In the `.github/workflows/` directory, create a new file called `learn-github-actions.yml` and add the following code. + ```yaml + name: learn-github-actions + on: [push] + jobs: + check-bats-version: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - uses: actions/setup-node@v1 + - run: npm install -g bats + - run: bats -v + ``` +1. Commit these changes and push them to your {% data variables.product.prodname_dotcom %} repository. + +Your new {% data variables.product.prodname_actions %} workflow file is now installed in your repository and will run automatically each time someone pushes a change to the repository. For details about a job's execution history, see "[Viewing the workflow's activity](/actions/learn-github-actions/introduction-to-github-actions#viewing-the-jobs-activity)." + +### Understanding the workflow file + +To help you understand how YAML syntax is used to create a workflow file, this section explains each line of the introduction's example: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + + ```yaml + name: learn-github-actions + ``` + + Optional - The name of the workflow as it will appear in the Actions tab of the {% data variables.product.prodname_dotcom %} repository. +
    + + ```yaml + on: [push] + ``` + + Specify the event that automatically triggers the workflow file. This example uses the push event, so that the jobs run every time someone pushes a change to the repository. You can set up the workflow to only run on certain branches, paths, or tags. For syntax examples including or excluding branches, paths, or tags, see "Workflow syntax for {% data variables.product.prodname_actions %}." +
    + + ```yaml + jobs: + ``` + + Groups together all the jobs that run in the learn-github-actions workflow file. +
    + + ```yaml + check-bats-version: + ``` + + Defines the name of the check-bats-version job stored within the jobs section. +
    + + ```yaml + runs-on: ubuntu-latest + ``` + + Configures the job to run on an Ubuntu Linux runner. This means that the job will execute on a fresh virtual machine hosted by GitHub. For syntax examples using other runners, see "Workflow syntax for {% data variables.product.prodname_actions %}." +
    + + ```yaml + steps: + ``` + + Groups together all the steps that run in the check-bats-version job. Each line nested under this section is a separate action. +
    + + ```yaml + - uses: actions/checkout@v2 + ``` + + The uses keyword tells the job to retrieve v2 of the community action named actions/checkout@v2. This is an action that checks out your repository and downloads it to the runner, allowing you to run actions against your code (such as testing tools). You must use the checkout action any time your workflow will run against the repository's code or you are using an action defined in the repository. +
    + + ```yaml + - uses: actions/setup-node@v1 + ``` + + This action installs the node software package on the runner, giving you access to the npm command. +
    + + ```yaml + - run: npm install -g bats + ``` + + The run keyword tells the job to execute a command on the runner. In this case, you are using npm to install the bats software testing package. +
    + + ```yaml + - run: bats -v + ``` + + Finally, you'll run the bats command with a parameter that outputs the software version. +
    + +#### Visualizing the workflow file + +In this diagram, you can see the workflow file you just created and how the {% data variables.product.prodname_actions %} components are organized in a hierarchy. Each step executes a single action. Steps 1 and 2 use prebuilt community actions. To find more prebuilt actions for your workflows, see "[Finding and customizing actions](/actions/learn-github-actions/finding-and-customizing-actions)." + +![Workflow overview](/assets/images/help/images/overview-actions-event.png) + + +### Viewing the job's activity + +Once your job has started running, you can view each step's activity on {% data variables.product.prodname_dotcom %}. + +{% data reusables.repositories.navigate-to-repo %} +1. 在仓库名称下，单击 **Actions（操作）**。 ![Navigate to repository](/assets/images/help/images/learn-github-actions-repository.png) +1. In the left sidebar, click the workflow you want to see. ![Screenshot of workflow results](/assets/images/help/images/learn-github-actions-workflow.png) +1. Under "Workflow runs", click the name of the run you want to see. ![Screenshot of workflow runs](/assets/images/help/images/learn-github-actions-run.png) +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +1. Click on the job name to see the results of each step. ![Screenshot of workflow run details](/assets/images/help/images/overview-actions-result-updated.png) +{% else %} +1. Click on the job name to see the results of each step. ![Screenshot of workflow run details](/assets/images/help/images/overview-actions-result.png) +{% endif %} + +### 后续步骤 + +To continue learning about {% data variables.product.prodname_actions %}, see "[Finding and customizing actions](/actions/learn-github-actions/finding-and-customizing-actions)." + +### 联系支持 + +{% data reusables.github-actions.contacting-support %} diff --git a/translations/zh-CN/content/actions/learn-github-actions/managing-complex-workflows.md b/translations/zh-CN/content/actions/learn-github-actions/managing-complex-workflows.md new file mode 100644 index 000000000000..bc38637475a8 --- /dev/null +++ b/translations/zh-CN/content/actions/learn-github-actions/managing-complex-workflows.md @@ -0,0 +1,151 @@ +--- +title: Managing complex workflows +shortTitle: Managing complex workflows +intro: 'This guide shows you how to use the advanced features of {% data variables.product.prodname_actions %}, with secret management, dependent jobs, caching, build matrices, and labels.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### 概览 + +This article describes some of the advanced features of {% data variables.product.prodname_actions %} that help you work create more complex workflows. + +### Storing secrets + +If your workflows use sensitive data, such as passwords or certificates, you can save these in {% data variables.product.prodname_dotcom %} as _secrets_ and then use them in your workflows as environment variables. This means that you will be able to create and share workflows without having to embed sensitive values directly in the YAML workflow. + +This example action demonstrates how to reference an existing secret as an environment variable, and send it as a parameter to an example command. + +{% raw %} +```yaml +jobs: + example-job: + steps: + - name: Retrieve secret + env: + super_secret: ${{ secrets.SUPERSECRET }} + run: | + example-command "$SUPER_SECRET" +``` +{% endraw %} + +更多信息请参阅“[创建和存储加密密码](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)”。 + +### Creating dependent jobs + +By default, the jobs in your workflow all run in parallel at the same time. So if you have a job that must only run after another job has completed, you can use the `needs` keyword to create this dependency. If one of the jobs fails, all dependent jobs are skipped; however, if you need the jobs to continue, you can define this using the [`if`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idif) conditional statement. + +In this example, the `setup`, `build`, and `test` jobs run in series, with `build` and `test` being dependent on the successful completion of the job that precedes them: + +```yaml +jobs: + setup: + runs-on: ubuntu-latest + steps: + - run: ./setup_server.sh + build: + needs: setup + steps: + - run: ./build_server.sh + test: + needs: build + runs-on: ubuntu-latest + steps: + - run: ./test_server.sh +``` + +For more information, see [`jobs..needs`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds). + +### Using a build matrix + +You can use a build matrix if you want your workflow to run tests across multiple combinations of operating systems, platforms, and languages. The build matrix is created using the `strategy` keyword, which receives the build options as an array. For example, this build matrix will run the job multiple times, using different versions of Node.js: + +{% raw %} +```yaml +jobs: + build: + runs-on: ubuntu-latest + strategy: + matrix: + node: [6, 8, 10] + steps: + - uses: actions/setup-node@v1 + with: + node-version: ${{ matrix.node }} +``` +{% endraw %} + +For more information, see [`jobs..strategy.matrix`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix). + +### 缓存依赖项 + +{% data variables.product.prodname_dotcom %}-hosted runners are started as fresh environments for each job, so if your jobs regularly reuse dependencies, you can consider caching these files to help improve performance. Once the cache is created, it is available to all workflows in the same repository. + +This example demonstrates how to cache the `~/.npm` directory: + +{% raw %} +```yaml +jobs: + example-job: + steps: + - name: Cache node modules + uses: actions/cache@v2 + env: + cache-name: cache-node-modules + with: + path: ~/.npm + key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }} + restore-keys: | + ${{ runner.os }}-build-${{ env.cache-name }}- +``` +{% endraw %} + +更多信息请参阅“[缓存依赖项以加快工作流程](/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows)”。 + +### 使用数据库和服务容器 + +If your job requires a database or cache service, you can use the [`services`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idservices) keyword to create an ephemeral container to host the service; the resulting container is then available to all steps in that job and is removed when the job has completed. This example demonstrates how a job can use `services` to create a `postgres` container, and then use `node` to connect to the service. + +```yaml +jobs: + container-job: + runs-on: ubuntu-latest + container: node:10.18-jessie + services: + postgres: + image: postgres + steps: + - name: Check out repository code + uses: actions/checkout@v2 + - name: Install dependencies + run: npm ci + - name: Connect to PostgreSQL + run: node client.js + env: + POSTGRES_HOST: postgres + POSTGRES_PORT: 5432 +``` + +For more information, see "[Using databases and service containers](/actions/configuring-and-managing-workflows/using-databases-and-service-containers)." + +### Using labels to route workflows + +This feature helps you assign jobs to a specific self-hosted runner. If you want to be sure that a particular type of runner will process your job, you can use labels to control where jobs are executed. You can assign labels to a self-hosted runner, and then refer to these labels in your YAML workflow, ensuring that the job is routed in a predictable way. + +This example shows how a workflow can use labels to specify the required runner: + +```yaml +jobs: + example-job: + runs-on: [self-hosted, linux, x64, gpu] +``` + +For more information, see ["Using labels with self-hosted runners](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners)." + +### 后续步骤 + +To continue learning about {% data variables.product.prodname_actions %}, see "[Sharing workflows with your organization](/actions/learn-github-actions/sharing-workflows-with-your-organization)." diff --git a/translations/zh-CN/content/actions/learn-github-actions/migrating-from-azure-pipelines-to-github-actions.md b/translations/zh-CN/content/actions/learn-github-actions/migrating-from-azure-pipelines-to-github-actions.md new file mode 100644 index 000000000000..c27988992679 --- /dev/null +++ b/translations/zh-CN/content/actions/learn-github-actions/migrating-from-azure-pipelines-to-github-actions.md @@ -0,0 +1,327 @@ +--- +title: Migrating from Azure Pipelines to GitHub Actions +intro: '{% data variables.product.prodname_actions %} and Azure Pipelines share several configuration similarities, which makes migrating to {% data variables.product.prodname_actions %} relatively straightforward.' +redirect_from: + - /actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### Introduction + +Azure Pipelines and {% data variables.product.prodname_actions %} both allow you to create workflows that automatically build, test, publish, release, and deploy code. Azure Pipelines and {% data variables.product.prodname_actions %} share some similarities in workflow configuration: + +- Workflow configuration files are written in YAML and are stored in the code's repository. +- Workflows include one or more jobs. +- Jobs include one or more steps or individual commands. +- Steps or tasks can be reused and shared with the community. + +For more information, see "[Core concepts for {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)." + +### Key differences + +When migrating from Azure Pipelines, consider the following differences: + +- Azure Pipelines supports a legacy _classic editor_, which lets you define your CI configuration in a GUI editor instead of creating the pipeline definition in a YAML file. {% data variables.product.prodname_actions %} uses YAML files to define workflows and does not support a graphical editor. +- Azure Pipelines allows you to omit some structure in job definitions. For example, if you only have a single job, you don't need to define the job and only need to define its steps. {% data variables.product.prodname_actions %} requires explicit configuration, and YAML structure cannot be omitted. +- Azure Pipelines supports _stages_ defined in the YAML file, which can be used to create deployment workflows. {% data variables.product.prodname_actions %} requires you to separate stages into separate YAML workflow files. +- On-premises Azure Pipelines build agents can be selected with capabilities. {% data variables.product.prodname_actions %} self-hosted runners can be selected with labels. + +### Migrating jobs and steps + +Jobs and steps in Azure Pipelines are very similar to jobs and steps in {% data variables.product.prodname_actions %}. In both systems, jobs have the following characteristics: + +* Jobs contain a series of steps that run sequentially. +* Jobs run on separate virtual machines or in separate containers. +* Jobs run in parallel by default, but can be configured to run sequentially. + +### Migrating script steps + +You can run a script or a shell command as a step in a workflow. In Azure Pipelines, script steps can be specified using the `script` key, or with the `bash`, `powershell`, or `pwsh` keys. Scripts can also be specified as an input to the [Bash task](https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/utility/bash?view=azure-devops) or the [PowerShell task](https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/utility/powershell?view=azure-devops). + +In {% data variables.product.prodname_actions %}, all scripts are specified using the `run` key. To select a particular shell, you can specify the `shell` key when providing the script. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)." + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +Azure Pipelines + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +jobs: +- job: scripts + pool: + vmImage: 'windows-latest' + steps: + - script: echo "This step runs in the default shell" + - bash: echo "This step runs in bash" + - pwsh: Write-Host "This step runs in PowerShell Core" + - task: PowerShell@2 + inputs: + script: Write-Host "This step runs in PowerShell" +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + scripts: + runs-on: windows-latest + steps: + - run: echo "This step runs in the default shell" + - run: echo "This step runs in bash" + shell: bash + - run: Write-Host "This step runs in PowerShell Core" + shell: pwsh + - run: Write-Host "This step runs in PowerShell" + shell: powershell +``` +{% endraw %} +
    + +### Differences in script error handling + +In Azure Pipelines, scripts can be configured to error if any output is sent to `stderr`. {% data variables.product.prodname_actions %} does not support this configuration. + +{% data variables.product.prodname_actions %} configures shells to "fail fast" whenever possible, which stops the script immediately if one of the commands in a script exits with an error code. In contrast, Azure Pipelines requires explicit configuration to exit immediately on an error. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#exit-codes-and-error-action-preference)." + +### Differences in the default shell on Windows + +In Azure Pipelines, the default shell for scripts on Windows platforms is the Command shell (_cmd.exe_). In {% data variables.product.prodname_actions %}, the default shell for scripts on Windows platforms is PowerShell. PowerShell has several differences in built-in commands, variable expansion, and flow control. + +If you're running a simple command, you might be able to run a Command shell script in PowerShell without any changes. But in most cases, you will either need to update your script with PowerShell syntax or instruct {% data variables.product.prodname_actions %} to run the script with the Command shell instead of PowerShell. You can do this by specifying `shell` as `cmd`. + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +Azure Pipelines + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +jobs: +- job: run_command + pool: + vmImage: 'windows-latest' + steps: + - script: echo "This step runs in CMD on Windows by default" +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + run_command: + runs-on: windows-latest + steps: + - run: echo "This step runs in PowerShell on Windows by default" + - run: echo "This step runs in CMD on Windows explicitly" + shell: cmd +``` +{% endraw %} +
    + +For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#using-a-specific-shell)." + +### Migrating conditionals and expression syntax + +Azure Pipelines and {% data variables.product.prodname_actions %} can both run steps conditionally. In Azure Pipelines, conditional expressions are specified using the `condition` key. In {% data variables.product.prodname_actions %}, conditional expressions are specified using the `if` key. + +Azure Pipelines uses functions within expressions to execute steps conditionally. In contrast, {% data variables.product.prodname_actions %} uses an infix notation. For example, you must replace the `eq` function in Azure Pipelines with the `==` operator in {% data variables.product.prodname_actions %}. + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +Azure Pipelines + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +jobs: +- job: conditional + pool: + vmImage: 'ubuntu-latest' + steps: + - script: echo "This step runs with str equals 'ABC' and num equals 123" + condition: and(eq(variables.str, 'ABC'), eq(variables.num, 123)) +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + conditional: + runs-on: ubuntu-latest + steps: + - run: echo "This step runs with str equals 'ABC' and num equals 123" + if: ${{ env.str == 'ABC' && env.num == 123 }} +``` +{% endraw %} +
    + +For more information, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)." + +### Dependencies between jobs + +Both Azure Pipelines and {% data variables.product.prodname_actions %} allow you to set dependencies for a job. In both systems, jobs run in parallel by default, but job dependencies can be specified explicitly. In Azure Pipelines, this is done with the `dependsOn` key. In {% data variables.product.prodname_actions %}, this is done with the `needs` key. + +Below is an example of the syntax for each system. The workflows start a first job named `initial`, and when that job completes, two jobs named `fanout1` and `fanout2` will run. Finally, when those jobs complete, the job `fanin` will run. + + + + + + + + + + +
    +Azure Pipelines + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +jobs: +- job: initial + pool: + vmImage: 'ubuntu-latest' + steps: + - script: echo "This job will be run first." +- job: fanout1 + pool: + vmImage: 'ubuntu-latest' + dependsOn: initial + steps: + - script: echo "This job will run after the initial job, in parallel with fanout2." +- job: fanout2 + pool: + vmImage: 'ubuntu-latest' + dependsOn: initial + steps: + - script: echo "This job will run after the initial job, in parallel with fanout1." +- job: fanin: + pool: + vmImage: 'ubuntu-latest' + dependsOn: [fanout1, fanout2] + steps: + - script: echo "This job will run after fanout1 and fanout2 have finished." +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + initial: + runs-on: ubuntu-latest + steps: + - run: echo "This job will be run first." + fanout1: + runs-on: ubuntu-latest + needs: initial + steps: + - run: echo "This job will run after the initial job, in parallel with fanout2." + fanout2: + runs-on: ubuntu-latest + needs: initial + steps: + - run: echo "This job will run after the initial job, in parallel with fanout1." + fanin: + runs-on: ubuntu-latest + needs: [fanout1, fanout2] + steps: + - run: echo "This job will run after fanout1 and fanout2 have finished." +``` +{% endraw %} +
    + +For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)." + +### Migrating tasks to actions + +Azure Pipelines uses _tasks_, which are application components that can be re-used in multiple workflows. {% data variables.product.prodname_actions %} uses _actions_, which can be used to perform tasks and customize your workflow. In both systems, you can specify the name of the task or action to run, along with any required inputs as key/value pairs. + +Below is an example of the syntax for each system: + + + + + + + + + + +
    +Azure Pipelines + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +jobs: +- job: run_python + pool: + vmImage: 'ubuntu-latest' + steps: + - task: UsePythonVersion@0 + inputs: + versionSpec: '3.7' + architecture: 'x64' + - script: python script.py +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + run_python: + runs-on: ubuntu-latest + steps: + - uses: actions/setup-python@v2 + with: + python-version: '3.7' + architecture: 'x64' + - run: python script.py +``` +{% endraw %} +
    + +You can find actions that you can use in your workflow in [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=actions), or you can create your own actions. For more information, see "[Creating actions](/actions/creating-actions)." + diff --git a/translations/zh-CN/content/actions/learn-github-actions/migrating-from-circleci-to-github-actions.md b/translations/zh-CN/content/actions/learn-github-actions/migrating-from-circleci-to-github-actions.md new file mode 100644 index 000000000000..b817d365e788 --- /dev/null +++ b/translations/zh-CN/content/actions/learn-github-actions/migrating-from-circleci-to-github-actions.md @@ -0,0 +1,447 @@ +--- +title: 从 CircleCI 迁移到 GitHub 操作 +intro: 'GitHub 操作和 CircleCI 在配置上具有若干相似之处，这使得迁移到 GitHub 操作相对简单。' +redirect_from: + - /actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### 简介 + +CircleCI 和 {% data variables.product.prodname_actions %} 都允许您创建能自动构建、测试、发布、发行和部署代码的工作流程。 CircleCI 和 {% data variables.product.prodname_actions %} 的工作流程配置有一些相似之处： + +- 工作流程配置文件以 YAML 编写并存储在仓库中。 +- 工作流程包括一项或多项作业。 +- 作业包括一个或多个步骤或单个命令。 +- 步骤或任务可以重复使用并与社区共享。 + +更多信息请参阅“[{% data variables.product.prodname_actions %} 的核心概念](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)”。 + +### 主要差异 + +从 CircleCI 迁移时，考虑以下差异： + +- CircleCI 的自动测试并行性根据用户指定的规则或历史计时信息自动对测试进行分组。 此功能未内置于 {% data variables.product.prodname_actions %}。 +- 在 Docker 容器中执行的操作对权限问题很敏感，因为容器具有不同的用户映射。 您可以通过在 *Dockerfile* 中不使用 `USER` 指令来避免这些问题。 有关 Docker 文件系统的更多信息，请参阅“[ {% data variables.product.product_name %} 托管运行器的虚拟环境](/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem)”。 + +### 迁移工作流程和作业 + +CircleCI 在 *config.yml* 文件中定义 `workflows`，允许您配置多个工作流程。 {% data variables.product.product_name %} 对每个工作流程需要一个工作流程文件，因此不要求您声明 `workflows`。 您需要为 *config.yml* 中配置的每个工作流程创建一个新的工作流程文件。 + +CircleCI 和 {% data variables.product.prodname_actions %} 在配置文件中使用相似的语法配置 `jobs`。 如果在 CircleCI 工作流程中使用 `requires` 配置作业之间的任何依赖项，您可以使用等效的 {% data variables.product.prodname_actions %} `needs` 语法。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)”。 + +### 将 orbs 迁移到操作 + +CircleCI 和 {% data variables.product.prodname_actions %} 都提供在工作流程中重复使用和共享任务的机制。 CircleCI 使用以 YAML 编写的概念 orbs 来提供人们可以在工作流程中重复使用的任务。 {% data variables.product.prodname_actions %} 具有强大而灵活的可重复使用的组件，称为“操作”，您可以使用 JavaScript 文件或 Docker 映像来构建操作。 您可以编写自定义代码来创建操作，以您喜欢的方式与仓库交互，包括使用 {% data variables.product.product_name %} 的 API 以及任何公开的第三方 API 进行交互。 例如，操作可以发布 npm 模块、在创建紧急议题时发送短信提醒，或者部署可用于生产的代码。 更多信息请参阅“[创建操作](/actions/creating-actions)”。 + +CircleCI 可以使用 YAML 锚点和别名来重复使用工作流程的组件。 {% data variables.product.prodname_actions %} 支持对于重复使用构建矩阵的最常见需求。 For more information about build matrixes, see "[Managing complex workflows](/actions/learn-github-actions/managing-complex-workflows/#using-a-build-matrix)." + +### 使用 Docker 映像 + + +CircleCI 和 {% data variables.product.prodname_actions %} 都支持在 Docker 映像中运行步骤。 + +CircleCI 提供一套具有共同依赖项的预建映像。 这些映像的 `USER` 设置为 `circleci`，会导致权限与 {% data variables.product.prodname_actions %} 冲突。 + +建议在迁移到 {% data variables.product.prodname_actions %} 时不使用 CircleCI 的预建映像。 在许多情况下，您可以使用操作来安装需要的附加依赖项。 + +有关 Docker 文件系统的更多信息，请参阅“[ {% data variables.product.product_name %} 托管运行器的虚拟环境](/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem)”。 + +For more information about the tools and packages available on {% data variables.product.prodname_dotcom %}-hosted virtual environments, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". + +### 使用变量和密码 + +CircleCI 和 {% data variables.product.prodname_actions %} 支持在配置文件中设置环境变量，并使用 CircleCI 或 {% data variables.product.product_name %} UI 创建密码。 + +更多信息请参阅“[使用环境变量](/actions/configuring-and-managing-workflows/using-environment-variables)”和“[创建和使用加密密码](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)”。 + +### 缓存 + +CircleCI 和 {% data variables.product.prodname_actions %} 提供在配置文件中手动缓存文件的方法。 + +下面是每个系统的语法示例： + + + + + + + + + + +
    +CircleCI + +GitHub Actions +
    +{% raw %} +```yaml +- restore_cache: + keys: + - v1-npm-deps-{{ checksum "package-lock.json" }} + - v1-npm-deps- +``` +{% endraw %} + +{% raw %} +```yaml +- name: Cache node modules + uses: actions/cache@v2 + with: + path: ~/.npm + key: v1-npm-deps-${{ hashFiles('**/package-lock.json') }} + restore-keys: v1-npm-deps- +``` +{% endraw %} +
    + +更多信息请参阅“[缓存依赖项以加快工作流程](/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows)”。 + +{% data variables.product.prodname_actions %} 没有 CircleCI 的 Docker 层缓存（或 DLC）的等效项。 + +### 在作业之间保持数据 + +CircleCI 和 {% data variables.product.prodname_actions %} 提供在作业之间保持数据的机制。 + +下面是 CircleCI 和 {% data variables.product.prodname_actions %} 配置语法中的示例。 + + + + + + + + + + +
    +CircleCI + +GitHub Actions +
    +{% raw %} +```yaml +- persist_to_workspace: + root: workspace + paths: + - math-homework.txt + +... + +- attach_workspace: + at: /tmp/workspace +``` +{% endraw %} + +{% raw %} +```yaml +- name: Upload math result for job 1 + uses: actions/upload-artifact@v2 + with: + name: homework + path: math-homework.txt + +... + +- name: Download math result for job 1 + uses: actions/download-artifact@v2 + with: + name: homework +``` +{% endraw %} +
    + +更多信息请参阅“[使用构件持久化工作流程](/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts)”。 + +### 使用数据库和服务容器 + +这两个系统都允许您包括用于数据库、缓存或其他依赖项的其他容器。 + +在 CircleCI 中，*config.yaml* 中列出的第一个映像是用于运行命令的主要映像。 {% data variables.product.prodname_actions %} 使用明确的区域： `container` 用于主容器，并在 `services` 中列出附加容器。 + +下面是 CircleCI 和 {% data variables.product.prodname_actions %} 配置语法中的示例。 + + + + + + + + + + +
    +CircleCI + +GitHub Actions +
    +{% raw %} +```yaml +--- +version: 2.1 + +jobs: + + ruby-26: + docker: + - image: circleci/ruby:2.6.3-node-browsers-legacy + environment: + PGHOST: localhost + PGUSER: administrate + RAILS_ENV: test + - image: postgres:10.1-alpine + environment: + POSTGRES_USER: administrate + POSTGRES_DB: ruby26 + POSTGRES_PASSWORD: "" + + working_directory: ~/administrate + + steps: + - checkout + + # Bundle install dependencies + - run: bundle install --path vendor/bundle + + # Wait for DB + - run: dockerize -wait tcp://localhost:5432 -timeout 1m + + # Setup the environment + - run: cp .sample.env .env + + # Setup the database + - run: bundle exec rake db:setup + + # Run the tests + - run: bundle exec rake + + +workflows: + version: 2 + build: + jobs: + - ruby-26 +... + +- attach_workspace: + at: /tmp/workspace +``` +{% endraw %} + +{% raw %} +```yaml +name: Containers + +on: [push] + +jobs: + build: + + runs-on: ubuntu-latest + container: circleci/ruby:2.6.3-node-browsers-legacy + + env: + PGHOST: postgres + PGUSER: administrate + RAILS_ENV: test + + services: + postgres: + image: postgres:10.1-alpine + env: + POSTGRES_USER: administrate + POSTGRES_DB: ruby25 + POSTGRES_PASSWORD: "" + ports: + - 5432:5432 + # Add a health check + options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5 + + steps: + # This Docker file changes sets USER to circleci instead of using the default user, so we need to update file permissions for this image to work on GH Actions. + # See https://docs.github.com/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem + - name: Setup file system permissions + run: sudo chmod -R 777 $GITHUB_WORKSPACE /github /__w/_temp + - uses: actions/checkout@v2 + - name: Install dependencies + run: bundle install --path vendor/bundle + - name: Setup environment configuration + run: cp .sample.env .env + - name: Setup database + run: bundle exec rake db:setup + - name: Run tests + run: bundle exec rake +``` +{% endraw %} +
    + +更多信息请参阅“[关于服务容器](/actions/configuring-and-managing-workflows/about-service-containers)”。 + +### 完整示例 + +下面是一个真实的示例。 左边显示用于 [thoughtbot/administrator](https://github.com/thoughtbot/administrate) 仓库的实际 CircleCI *config.yml*。 右边显示 {% data variables.product.prodname_actions %} 等效项。 + + + + + + + + + + +
    +CircleCI + +GitHub Actions +
    +{% raw %} +```yaml +--- +version: 2.1 + +commands: + shared_steps: + steps: + - checkout + + # Restore Cached Dependencies + - restore_cache: + name: Restore bundle cache + key: administrate-{{ checksum "Gemfile.lock" }} + + # Bundle install dependencies + - run: bundle install --path vendor/bundle + + # Cache Dependencies + - save_cache: + name: Store bundle cache + key: administrate-{{ checksum "Gemfile.lock" }} + paths: + - vendor/bundle + + # Wait for DB + - run: dockerize -wait tcp://localhost:5432 -timeout 1m + + # Setup the environment + - run: cp .sample.env .env + + # Setup the database + - run: bundle exec rake db:setup + + # Run the tests + - run: bundle exec rake + +default_job: &default_job + working_directory: ~/administrate + steps: + - shared_steps + # Run the tests against multiple versions of Rails + - run: bundle exec appraisal install + - run: bundle exec appraisal rake + +jobs: + ruby-25: + <<: *default_job + docker: + - image: circleci/ruby:2.5.0-node-browsers + environment: + PGHOST: localhost + PGUSER: administrate + RAILS_ENV: test + - image: postgres:10.1-alpine + environment: + POSTGRES_USER: administrate + POSTGRES_DB: ruby25 + POSTGRES_PASSWORD: "" + + ruby-26: + <<: *default_job + docker: + - image: circleci/ruby:2.6.3-node-browsers-legacy + environment: + PGHOST: localhost + PGUSER: administrate + RAILS_ENV: test + - image: postgres:10.1-alpine + environment: + POSTGRES_USER: administrate + POSTGRES_DB: ruby26 + POSTGRES_PASSWORD: "" + + +workflows: + version: 2 + multiple-rubies: + jobs: + - ruby-26 + - ruby-25 +``` +{% endraw %} + +{% raw %} +```yaml +name: Containers + +on: [push] + +jobs: + build: + + strategy: + matrix: + ruby: [2.5, 2.6.3] + + runs-on: ubuntu-latest + + env: + PGHOST: localhost + PGUSER: administrate + RAILS_ENV: test + + services: + postgres: + image: postgres:10.1-alpine + env: + POSTGRES_USER: administrate + POSTGRES_DB: ruby25 + POSTGRES_PASSWORD: "" + ports: + - 5432:5432 + # Add a health check + options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5 + + steps: + - uses: actions/checkout@v2 + - name: Setup Ruby + uses: eregon/use-ruby-action@master + with: + ruby-version: ${{ matrix.ruby }} + - name: Cache dependencies + uses: actions/cache@v2 + with: + path: vendor/bundle + key: administrate-${{ matrix.image }}-${{ hashFiles('Gemfile.lock') }} + - name: Install postgres headers + run: sudo apt-get install libpq-dev + - name: Install dependencies + run: bundle install --path vendor/bundle + - name: Setup environment configuration + run: cp .sample.env .env + - name: Setup database + run: bundle exec rake db:setup + - name: Run tests + run: bundle exec rake + - name: Install appraisal + run: bundle exec appraisal install + - name: Run appraisal + run: bundle exec appraisal rake +``` +{% endraw %} +
    diff --git a/translations/zh-CN/content/actions/learn-github-actions/migrating-from-gitlab-cicd-to-github-actions.md b/translations/zh-CN/content/actions/learn-github-actions/migrating-from-gitlab-cicd-to-github-actions.md new file mode 100644 index 000000000000..625f2365b2a2 --- /dev/null +++ b/translations/zh-CN/content/actions/learn-github-actions/migrating-from-gitlab-cicd-to-github-actions.md @@ -0,0 +1,476 @@ +--- +title: Migrating from GitLab CI/CD to GitHub Actions +intro: '{% data variables.product.prodname_actions %} and GitLab CI/CD share several configuration similarities, which makes migrating to {% data variables.product.prodname_actions %} relatively straightforward.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### 简介 + +GitLab CI/CD and {% data variables.product.prodname_actions %} both allow you to create workflows that automatically build, test, publish, release, and deploy code. GitLab CI/CD and {% data variables.product.prodname_actions %} share some similarities in workflow configuration: + +- 工作流程配置文件以 YAML 编写并存储在代码仓库中。 +- 工作流程包括一项或多项作业。 +- 作业包括一个或多个步骤或单个命令。 +- Jobs can run on either managed or self-hosted machines. + +There are a few differences, and this guide will show you the important differences so that you can migrate your workflow to {% data variables.product.prodname_actions %}. + +### Jobs + +Jobs in GitLab CI/CD are very similar to jobs in {% data variables.product.prodname_actions %}. 在这两个系统中，作业具有以下特征： + +* Jobs contain a series of steps or scripts that run sequentially. +* Jobs can run on separate machines or in separate containers. +* 默认情况下作业并行运行，但可以配置为按顺序运行。 + +You can run a script or a shell command in a job. In GitLab CI/CD, script steps are specified using the `script` key. 在 {% data variables.product.prodname_actions %} 中，所有脚本都使用 `run` 键来指定。 + +下面是每个系统的语法示例： + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +job1: + variables: + GIT_CHECKOUT: "true" + script: + - echo "Run your script here" +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + job1: + steps: + - uses: actions/checkout@v2 + - run: echo "Run your script here" +``` +{% endraw %} +
    + +### Runners + +Runners are machines on which the jobs run. Both GitLab CI/CD and {% data variables.product.prodname_actions %} offer managed and self-hosted variants of runners. In GitLab CI/CD, `tags` are used to run jobs on different platforms, while in {% data variables.product.prodname_actions %} it is done with the `runs-on` key. + +下面是每个系统的语法示例： + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +windows_job: + tags: + - windows + script: + - echo Hello, %USERNAME%! + +linux_job: + tags: + - linux + script: + - echo "Hello, $USER!" +``` +{% endraw %} + +{% raw %} +```yaml +windows_job: + runs-on : windows-latest + steps: + - run: echo Hello, %USERNAME%! + +linux_job: + runs-on: ubuntu-latest + steps: + - run: echo "Hello, $USER!" +``` +{% endraw %} +
    + +For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on)." + +### Docker images + +Both GitLab CI/CD and {% data variables.product.prodname_actions %} support running jobs in a Docker image. In GitLab CI/CD, Docker images are defined with a `image` key, while in {% data variables.product.prodname_actions %} it is done with the `container` key. + +下面是每个系统的语法示例： + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +my_job: + image: node:10.16-jessie +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + my_job: + container: node:10.16-jessie +``` +{% endraw %} +
    + +For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idcontainer)." + +### Condition and expression syntax + +GitLab CI/CD uses `rules` to determine if a job will run for a specific condition. {% data variables.product.prodname_actions %} uses the `if` keyword to prevent a job from running unless a condition is met. + +下面是每个系统的语法示例： + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +deploy_prod: + stage: deploy + script: + - echo "Deply to production server" + rules: + - if: '$CI_COMMIT_BRANCH == "master"' +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + deploy_prod: + if: contains( github.ref, 'master') + runs-on: ubuntu-latest + steps: + - run: echo "Deply to production server" +``` +{% endraw %} +
    + +更多信息请参阅“[{% data variables.product.prodname_actions %} 的上下文和表达式语法](/actions/reference/context-and-expression-syntax-for-github-actions)”。 + +### Dependencies between Jobs + +Both GitLab CI/CD and {% data variables.product.prodname_actions %} allow you to set dependencies for a job. In both systems, jobs run in parallel by default, but job dependencies in {% data variables.product.prodname_actions %} can be specified explicitly with the `needs` key. GitLab CI/CD also has a concept of `stages`, where jobs in a stage run concurrently, but the next stage will start when all the jobs in the previous stage have completed. You can recreate this scenario in {% data variables.product.prodname_actions %} with the `needs` key. + +下面是每个系统的语法示例： The workflows start with two jobs named `build_a` and `build_b` running in parallel, and when those jobs complete, another job called `test_ab` will run. Finally, when `test_ab` completes, the `deploy_ab` job will run. + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +stages: + - build + - test + - deploy + +build_a: + stage: build + script: + - echo "This job will run first." + +build_b: + stage: build + script: + - echo "This job will run first, in parallel with build_a." + +test_ab: + stage: test + script: + - echo "This job will run after build_a and build_b have finished." + +deploy_ab: + stage: deploy + script: + - echo "This job will run after test_ab is complete" +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + build_a: + runs-on: ubuntu-latest + steps: + - run: echo "This job will be run first." + + build_b: + runs-on: ubuntu-latest + steps: + - run: echo "This job will be run first, in parallel with build_a" + + test_ab: + runs-on: ubuntu-latest + needs: [build_a,build_b] + steps: + - run: echo "This job will run after build_a and build_b have finished" + + deploy_ab: + runs-on: ubuntu-latest + needs: [test_ab] + steps: + - run: echo "This job will run after test_ab is complete" +``` +{% endraw %} +
    + +更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)”。 + +### Scheduling workflows + +Both GitLab CI/CD and {% data variables.product.prodname_actions %} allow you to run workflows at a specific interval. In GitLab CI/CD, pipeline schedules are configured with the UI, while in {% data variables.product.prodname_actions %} you can trigger a workflow on a scheduled interval with the "on" key. + +For more information, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows#scheduled-events)." + +### Variables and secrets + +GitLab CI/CD and {% data variables.product.prodname_actions %} support setting environment variables in the pipeline or workflow configuration file, and creating secrets using the GitLab or {% data variables.product.product_name %} UI. + +For more information, see "[Environment variables](/actions/reference/environment-variables)" and "[Encrypted secrets](/actions/reference/encrypted-secrets)." + +### 缓存 + +GitLab CI/CD and {% data variables.product.prodname_actions %} provide a method in the configuration file to manually cache workflow files. + +下面是每个系统的语法示例： + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +image: node:latest + +cache: + key: $CI_COMMIT_REF_SLUG + paths: + - .npm/ + +before_script: + - npm ci --cache .npm --prefer-offline + +test_async: + script: + - node ./specs/start.js ./specs/async.spec.js +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + test_async: + - name: Cache node modules + uses: actions/cache@v2 + with: + path: ~/.npm + key: v1-npm-deps-${{ hashFiles('**/package-lock.json') }} + restore-keys: v1-npm-deps- +``` +{% endraw %} +
    + +For more information, see "[Caching dependencies to speed up workflows](/actions/guides/caching-dependencies-to-speed-up-workflows)." + +### 构件 + +Both GitLab CI/CD and {% data variables.product.prodname_actions %} can upload files and directories created by a job as artifacts. In {% data variables.product.prodname_actions %}, artifacts can be used to persist data across multiple jobs. + +下面是每个系统的语法示例： + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +script: +artifacts: + paths: + - math-homework.txt +``` +{% endraw %} + +{% raw %} +```yaml +- name: Upload math result for job 1 + uses: actions/upload-artifact@v2 + with: + name: homework + path: math-homework.txt +``` +{% endraw %} +
    + +For more information, see "[Storing workflow data as artifacts](/actions/guides/storing-workflow-data-as-artifacts)." + +### Databases and service containers + +这两个系统都允许您包括用于数据库、缓存或其他依赖项的其他容器。 + +In GitLab CI/CD, a container for the job is specified with the `image` key, while {% data variables.product.prodname_actions %} uses the `container` key. In both systems, additional service containers are specified with the `services` key. + +下面是每个系统的语法示例： + + + + + + + + + + +
    +GitLab CI/CD + +{% data variables.product.prodname_actions %} +
    +{% raw %} +```yaml +container-job: + variables: + POSTGRES_PASSWORD: postgres + # The hostname used to communicate with the + # PostgreSQL service container + POSTGRES_HOST: postgres + # The default PostgreSQL port + POSTGRES_PORT: 5432 + image: node:10.18-jessie + services: + - postgres + script: + # Performs a clean installation of all dependencies + # in the `package.json` file + - npm ci + # Runs a script that creates a PostgreSQL client, + # populates the client with data, and retrieves data + - node client.js + tags: + - docker +``` +{% endraw %} + +{% raw %} +```yaml +jobs: + container-job: + runs-on: ubuntu-latest + container: node:10.18-jessie + + services: + postgres: + image: postgres + env: + POSTGRES_PASSWORD: postgres + + steps: + - name: Check out repository code + uses: actions/checkout@v2 + + # Performs a clean installation of all dependencies + # in the `package.json` file + - name: Install dependencies + run: npm ci + + - name: Connect to PostgreSQL + # Runs a script that creates a PostgreSQL client, + # populates the client with data, and retrieves data + run: node client.js + env: + # The hostname used to communicate with the + # PostgreSQL service container + POSTGRES_HOST: postgres + # The default PostgreSQL port + POSTGRES_PORT: 5432 +``` +{% endraw %} +
    + +For more information, see "[About service containers](/actions/guides/about-service-containers)." diff --git a/translations/zh-CN/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md b/translations/zh-CN/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md new file mode 100644 index 000000000000..57588c449c25 --- /dev/null +++ b/translations/zh-CN/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md @@ -0,0 +1,293 @@ +--- +title: 从 Jenkins 迁移到 GitHub 操作 +intro: '{% data variables.product.prodname_actions %} 和 Jenkins 有多种相似之处，这使得迁移到 {% data variables.product.prodname_actions %} 相对简单。' +redirect_from: + - /actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### 简介 + +Jenkins 和 {% data variables.product.prodname_actions %} 都允许您创建能自动构建、测试、发布、发行和部署代码的工作流程。 Jenkins 和 {% data variables.product.prodname_actions %} 的工作流程配置有一些相似之处： + +- Jenkins 使用 _Declarative Pelines_ 创建工作流程，这些工作流程类似于 {% data variables.product.prodname_actions %} 工作流程文件。 +- Jenkins 使用_阶段_运行步骤集合，而 {% data variables.product.prodname_actions %} 则使用作业来分组一个或多个步骤或单个命令。 +- Jenkins 和 {% data variables.product.prodname_actions %} 支持基于容器的构建。 更多信息请参阅“[创建 Docker 容器操作](/articles/creating-a-docker-container-action)”。 +- 步骤或任务可以重复使用并与社区共享。 + +更多信息请参阅“[{% data variables.product.prodname_actions %} 的核心概念](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)”。 + +### 主要差异 + +- Jenkins 有两种类型的语法用来创建管道：Declarative Pipeline 和 Scripted Pipeline。 {% data variables.product.prodname_actions %} 使用 YAML 创建工作流程和配置文件。 更多信息请参阅“[GitHub 操作的工作流程语法](/actions/reference/workflow-syntax-for-github-actions)”。 +- Jenkins 部署通常是自托管的，用户在自己的数据中心维护服务器。 {% data variables.product.prodname_actions %} 通过托管自己可用于运行作业的运行器提供混合云方法，同时也支持自托管运行器。 更多信息请参阅“[关于自托管运行器](/actions/hosting-your-own-runners/about-self-hosted-runners)”。 + +### 比较功能 + +#### 分发版本 + +Jenkins 可让您发送版本到单个构建代理，或者您可以在多个代理之间进行分发。 您也可以根据不同的属性（例如操作系统类型）对这些代理进行分类。 + +同样， {% data variables.product.prodname_actions %} 可以向 {% data variables.product.prodname_dotcom %} 托管或自托管的运行器发送作业，您可以根据不同的属性使用标签对运行器分类。 下表比较了如何对 Jenkins 和 {% data variables.product.prodname_actions %} 实施分布式构建概念。 + +| Jenkins | {% data variables.product.prodname_actions %} +| ---------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`agents`](https://wiki.jenkins.io/display/JENKINS/Distributed+builds) | [`runners`](/actions/learn-github-actions/introduction-to-github-actions#runners)
    [`self-hosted runners`](/actions/hosting-your-own-runners/about-self-hosted-runners) | + +#### 使用区段组织管道 + +Jenkins 将其 Declarative Pipelines 分为多个区段。 同样，{% data variables.product.prodname_actions %} 也将其工作流程分成单独的部分。 下表比较了Jenkins 区段与 {% data variables.product.prodname_actions %} 工作流程。 + +| Jenkins 指令 | {% data variables.product.prodname_actions %} +| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| [`agent`](https://jenkins.io/doc/book/pipeline/syntax/#agent) | [`jobs..runs-on`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idruns-on)
    [`jobs..container`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idcontainer) | +| [`post`](https://jenkins.io/doc/book/pipeline/syntax/#post) | | +| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#stages) | [`jobs`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobs) | +| [`steps`](https://jenkins.io/doc/book/pipeline/syntax/#steps) | [`jobs..steps`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idsteps) | + + +### 使用指令 + +Jenkins 使用指令来管理 _Declarative Pipelines_。 这些指令定义工作流程的特性及其执行方式。 下表演示这些指令如何映射到 {% data variables.product.prodname_actions %} 中的概念。 + +| Jenkins 指令 | {% data variables.product.prodname_actions %} +| ------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`environment`](https://jenkins.io/doc/book/pipeline/syntax/#environment) | [`jobs..env`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env)
    [`jobs..steps.env`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv) | +| [`options`](https://jenkins.io/doc/book/pipeline/syntax/#parameters) | [`jobs..strategy`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategy)
    [`jobs..strategy.fail-fast`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategyfail-fast)
    [`jobs..timeout-minutes`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idtimeout-minutes) | +| [`parameters`](https://jenkins.io/doc/book/pipeline/syntax/#parameters) | [`inputs`](/actions/creating-actions/metadata-syntax-for-github-actions#inputs)
    [`outputs`](/actions/creating-actions/metadata-syntax-for-github-actions#outputs) | +| [`triggers`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`on`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#on)
    [`on..types`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onevent_nametypes)
    [on..](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)
    [on..paths](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpushpull_requestpaths) | +| [`triggers { upstreamprojects() }`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`jobs..needs`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idneeds) | +| [Jenkins cron syntax](https://jenkins.io/doc/book/pipeline/syntax/#cron-syntax) | [`on.schedule`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onschedule) | +| [`阶段，暂存`](https://jenkins.io/doc/book/pipeline/syntax/#stage) | [`jobs.`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_id)
    [`jobs..name`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idname) | +| [`tools`](https://jenkins.io/doc/book/pipeline/syntax/#tools) | [Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software) | +| [`input`](https://jenkins.io/doc/book/pipeline/syntax/#input) | [`inputs`](/actions/automating-your-workflow-with-github-actions/metadata-syntax-for-github-actions#inputs) | +| [`when`](https://jenkins.io/doc/book/pipeline/syntax/#when) | [`jobs..if`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idif) | + + +### 使用连续阶段 + +#### 并行作业处理 + +Jenkins 可以并行运行 `stages` 和 `steps`，而 {% data variables.product.prodname_actions %} 目前只能并行运行作业。 + +| Jenkins Parallel | {% data variables.product.prodname_actions %} +| ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`parallel`](https://jenkins.io/doc/book/pipeline/syntax/#parallel) | [`jobs..strategy.max-parallel`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymax-parallel) | + +#### 构建矩阵 + +{% data variables.product.prodname_actions %} 和 Jenkins 都允许您使用构建矩阵来定义各种系统组合。 + +| Jenkins | {% data variables.product.prodname_actions %} +| ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`axis`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-axes) | [`strategy/matrix`](/actions/learn-github-actions/managing-complex-workflows/#using-a-build-matrix)
    [`context`](/actions/reference/context-and-expression-syntax-for-github-actions) | +| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages) | [`steps-context`](/actions/reference/context-and-expression-syntax-for-github-actions#steps-context) | +| [`excludes`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages) | | + +#### 使用步骤执行任务 + +Jenkins 将 `steps` 组织在 `stages`。 每个步骤都可以是脚本、函数或命令等。 同样， {% data variables.product.prodname_actions %} 使用 `job` 来执行特定的 `steps` 组。 + +| Jenkins 步骤 | {% data variables.product.prodname_actions %} +| --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | +| [`script`](https://jenkins.io/doc/book/pipeline/syntax/#script) | [`jobs..steps`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idsteps) | + +### 常见任务示例 + +#### 计划与 `cron` 一起运行的管道 + + + + + + + + + + +
    +Jenkins Pipeline + +{% data variables.product.prodname_actions %} 工作流程 +
    + + ```yaml + pipeline { + agent any + triggers { + cron('H/15 * * * 1-5') + } + } + ``` + + + + ```yaml + on: + schedule: + - cron: '*/15 * * * 1-5' + ``` + +
    + +#### 配置管道中的环境变量 + + + + + + + + + + +
    +Jenkins Pipeline + +{% data variables.product.prodname_actions %} 工作流程 +
    + + ```yaml + pipeline { + agent any + environment { + MAVEN_PATH = '/usr/local/maven' + } + } + ``` + + + + ```yaml + jobs: + maven-build: + env: + MAVEN_PATH: '/usr/local/maven' + + ``` + +
    + +#### 从上游项目构建 + + + + + + + + + + +
    +Jenkins Pipeline + +{% data variables.product.prodname_actions %} 工作流程 +
    + + ```yaml + pipeline { + triggers { + upstream( + upstreamProjects: 'job1,job2', + threshold: hudson.model.Result.SUCCESS) + } + } + } + + ``` + + + + ```yaml + jobs: + job1: + job2: + needs: job1 + job3: + needs: [job1, job2] + + ``` + +
    + +#### 使用多个操作系统构建 + + + + + + + + + + +
    +Jenkins Pipeline + +{% data variables.product.prodname_actions %} 工作流程 +
    + + ```yaml +pipeline { + agent none + stages { + stage('Run Tests') { + parallel { + stage('Test On MacOS') { + agent { label "macos" } + tools { nodejs "node-12" } + steps { + dir("scripts/myapp") { + sh(script: "npm install -g bats") + sh(script: "bats tests") + } + } + } + stage('Test On Linux') { + agent { label "linux" } + tools { nodejs "node-12" } + steps { + dir("script/myapp") { + sh(script: "npm install -g bats") + sh(script: "bats tests") + } + } + } + } + } + } +} + ``` + + + +{% raw %} + ```yaml + name: demo-workflow + on: + push: + jobs: + test: + runs-on: ${{ matrix.os }} + strategy: + fail-fast: false + matrix: + os: [macos-latest, ubuntu-latest] + steps: + - uses: actions/checkout@v1 + - uses: actions/setup-node@v1 + with: + node-version: 12 + - run: npm install -g bats + - run: bats tests + working-directory: scripts/myapp + ``` +{% endraw %} + +
    diff --git a/translations/zh-CN/content/actions/learn-github-actions/security-hardening-for-github-actions.md b/translations/zh-CN/content/actions/learn-github-actions/security-hardening-for-github-actions.md new file mode 100644 index 000000000000..69f032674755 --- /dev/null +++ b/translations/zh-CN/content/actions/learn-github-actions/security-hardening-for-github-actions.md @@ -0,0 +1,97 @@ +--- +title: GitHub 操作的安全强化 +shortTitle: 安全强化 +intro: '使用 {% data variables.product.prodname_actions %} 功能的良好安全实践。' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /actions/getting-started-with-github-actions/security-hardening-for-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### 概览 + +本指南介绍如何为某些 {% data variables.product.prodname_actions %} 功能配置安全强化。 如果不熟悉 {% data variables.product.prodname_actions %} 概念，请参阅“[GitHub 操作的核心概念](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)”。 + +### 使用密码 + +敏感值绝不能以明文存储在工作流程文件中，而应存储为密码。 [密码](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)可在组织或仓库级配置，可用于在 {% data variables.product.product_name %} 中存储敏感信息。 + +密码使用 [Libsodium 密封箱](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes)，以使它们在到达 {% data variables.product.product_name %} 前被加密处理。 [使用 UI](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets#creating-encrypted-secrets-for-a-repository) 或通过 [REST API](/rest/reference/actions#secrets) 提交密码时就会发生这种情况。 此客户端加密有助于最大程度地减少与 {% data variables.product.product_name %}基础架构中的意外日志记录相关的风险（例如，异常日志和请求日志等）。 密钥在上传后，{% data variables.product.product_name %} 可对其进行解密，以便它能够被注入工作流程运行时。 + +为了帮助防止意外泄露，{% data variables.product.product_name %} 使用一种机制尝试对运行日志中显示的任何密码进行编校。 此编校会寻找任何已配置密码的精确匹配项，以及值的常见编码，如 Base64。 但是，由于密码值可以通过多种方式转换，因此不能保证此编校。 因此，你应该采取某些积极主动的步骤和良好的做法，以帮助确保密码得到编校， 并限制与密码相关的其他风险： + +- **切勿将结构化数据用作密码** + - 非结构化数据可能导致日志中的密码编校失败，因为编校很大程度上取决于查找特定密码值的完全匹配项。 例如，不要使用 JSON、XML 或 YAML（或类似）的 Blob 来封装密码值，否则会显著降低密码被正确编校的可能性。 而应为每个敏感值创建单独的密码。 +- **注册工作流程中使用的所有密码** + - 如果密码用于生成工作流程中的另一个敏感值，则该生成的值应正式[注册为密码](https://github.com/actions/toolkit/tree/main/packages/core#setting-a-secret)，使其出现在日志中时将会得到编校。 例如，如果使用私钥生成签名的 JWT 来访问 Web API，请确保将该 JWT 注册为密码，否则，如果它进入日志输出，则不会得到编校。 + - 注册密码也适用于任何类型的转换/编码。 如果以某种方式（如 Base64 或 URL 编码）转换您的密码，请确保将新值也注册为密码。 +- **审核如何处理密码** + - 审核密码的使用方式，以帮助确保按预期方式处理密码。 您可以通过检查执行工作流程的仓库的源代码并检查工作流程中使用的任何操作来进行审核。 例如，确认它们未发送到非预期主机，或明确打印到日志输出。 + - 在测试有效/无效输入后查看工作流程的运行日志，并确认密码已正确编校或未显示。 您调用的命令或工具如何向 `STDOUT` 和 `STDERR` 发送错误并不总是很明显，密码随后可能会在错误日志中生成错误。 因此，在测试有效和无效的输入后，最好是手动查看工作流程日志。 +- **使用最小范围的凭据** + - 确保工作流程中使用的凭据具有所需的最小权限，并请注意，任何对仓库具有写入权限的用户都可访问仓库中配置的所有密码。 +- **审核并轮换注册密码** + - 定期查查已注册的密码，以确认它们仍是必需的。 删除不再需要的密码。 + - 定期轮换密码，以减小泄露的密码有效的时间窗。 + +### 使用第三方操作 + +工作流程中的个别作业可以与其他作业相互作用（和妥协）。 例如，查询以后作业使用的环境变量，将文件写入以后作业处理的共享目录，或者更直接地与 Docker 套接字接交互，以及检查其他正在运行的容器并执行其中的命令。 + +这意味着工作流程中单一操作的泄露可能很严重，因为这个泄露的操作可以访问您仓库中配置的所有密码， 并且可以使用 `GITHUB_TOKENN` 写入仓库。 因此，从 {% data variables.product.prodname_dotcom %} 上的第三方仓库获取操作的风险很大。 您可以遵循以下良好做法来帮助降低此风险： + +* **将操作固定到全长提交 SHA** + + 将操作固定到全长提交 SHA 是当前将操作用作不可变版本的唯一方法。 固定到特定 SHA 有助于降低恶意执行者向操作仓库添加后门的风险，因为他们需要为有效的 Git 对象负载生成 SHA-1 冲突。 + + {% warning %} + + **警告** 提交 SHA 的简短版本不安全，绝不可用于指定操作的 Git 引用。 由于仓库网络的工作方式，任何用户都可以复刻仓库，将精心编写的提交推送到与短 SHA 冲突的仓库。 这会导致该 SHA 上的后续克隆失败，因为它成为不明确的提交。 因此，使用缩短的 SHA 的任何工作流程将立即失败。 + + {% endwarning %} +* **审核操作的源代码** + + 确保操作按照预期处理仓库和密码的内容。 例如，确认密码未发送到非预期主机，或者没有被无意中记录。 + +* **仅当您信任创建者时，才将操作固定到标记** + + 尽管固定到提交 SHA 是最安全的选项，但指定标记更方便，而且被广泛使用。 如果要指定标记，请确保信任该操作的创建者。 {% data variables.product.prodname_marketplace %} 上的“已验证创建者”徽章是一个有用的信号，因为它表示该操作是由其身份已被 {% data variables.product.prodname_dotcom %} 验证的团队编写的。 请注意，即使您信任作者，这种方法也存在风险，因为如果恶意执行者获得对存储操作的仓库的访问权限，便可移动或删除标记。 + +### 考虑跨仓库访问 + +{% data variables.product.product_name %} 的范围有意设为每次一个仓库。 工作流程环境中使用的 `GITHUB_TOKEN` 授予与具有写入权限的用户相同的访问级别，因为任何具有写入权限的用户都可通过创建或修改工作流程文件来访问此令牌。 用户对每个仓库都有特定权限，因此，如果不谨慎实施，一个仓库的 `GITHUB_TOKEN` 库授予对另一个仓库的访问权限将会影响 {% data variables.product.prodname_dotcom %} 权限模型。 同样，在向工作流程环境添加 {% data variables.product.prodname_dotcom %} 授权令牌时也必须谨慎，因为这也会因无意中向协作者授予一般权限而影响 {% data variables.product.prodname_dotcom %} 权限模型。 + +我们已经[制定 {% data variables.product.prodname_dotcom %} 路线图](https://github.com/github/roadmap/issues/74)，以支持允许在 {% data variables.product.product_name %} 内跨仓库访问的流程，但这还不是一项受支持的功能。 目前，执行特权跨仓库交互的唯一方法就是将 {% data variables.product.prodname_dotcom %} 身份验证令牌或 SSH 密钥作为工作流程环境中的密码。 由于许多身份验证令牌类型不允许对特定资源进行细致的访问，因此使用错误的令牌类型存在很大风险，因为它可以授予比预期范围更广泛的访问。 + +此列表描述建议用于在工作流程中访问仓库数据的方法，按优先顺序降序排列： + +1. **工作流程环境中的 `GITHUB_TOKEN`** + - 此令牌的范围有意设为调用工作流程的单个仓库，并且具有与仓库具有写入权限的用户的访问级别相同。 令牌在每个作业开始之前创建，在作业完成时过期。 更多信息请参阅“[使用 GITHUB_TOKEN 验证身份](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)”。 + - 应尽可能使用 `GITHUB_TOKEN`。 +2. **仓库部署密钥** + - 部署密钥是唯一授予对单个存储库的读取或写入访问权限的凭据类型之一，可用于与工作流程中的另一个仓库进行交互。 更多信息请参阅“[管理部署密钥](/developers/overview/managing-deploy-keys#deploy-keys)”。 + - 请注意，部署密钥只能使用 Git 克隆和推送到仓库，不能用于与 REST 或 GraphQL API 进行交互，因此它们可能不适合您的要求。 +3. **{% data variables.product.prodname_github_app %} 令牌** + - {% data variables.product.prodname_github_apps %} 可以安装在选择的仓库上，甚至可以对其中的资源设置细致的访问权限。 您可以创建组织内部的 {% data variables.product.prodname_github_app %}，将其安装在工作流程中您需要访问的仓库上，并在工作流程中验证为安装以访问这些仓库。 +4. **个人访问令牌** + - 切勿使用您自己帐户的个人访问令牌。 这些令牌授予您访问组织中您有权访问的所有仓库，以及您的用户帐户中的所有个人仓库。 这间接地向所有能写入工作流程所在仓库的用户授予广泛访问权限。 此外，如果您以后离开组织，使用此令牌的工作流程将立即中断，而且调试此问题可能具有挑战性。 + - 如果使用个人访问令牌，应是为新帐户生成的令牌，该帐户仅被授予对工作流程所需的特定仓库的访问权限。 请注意，此方法不可扩展，应避免采用其他方法，例如部署密钥。 +5. **用户帐户上的 SSH 密钥** + - 工作流程不应使用用户帐户上的 SSH 密钥。 与个人访问令牌类似，它们授予对所有个人仓库以及通过组织成员资格访问的所有仓库的读/写权限。 这间接地向所有能写入工作流程所在仓库的用户授予广泛访问权限。 如果您打算使用 SSH 密钥，因为您只需要执行仓库克隆或推送，并且不需要与公共 API 交互，则应该使用单独的部署密钥。 + +### 自托管运行器的强化 + +**{% data variables.product.prodname_dotcom %} 托管的**运行程序在临时和干净的隔离虚拟机中执行代码，这意味着无法持续破坏此环境，可以访问的信息不会超过引导过程中此环境中存在的信息。 + +{% data variables.product.product_name %} 上**自托管**的运行器不能保证在临时干净的虚拟机中运行，并且可能会持续受到工作流程中不受信任的代码的损害。 + +因此，自托管的运行器几乎[永远不能用于 {% data variables.product.product_name %} 上的公共仓库](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories)，因为任何用户都可以打开针对仓库的拉取请求并破坏环境。 同样，在私有仓库上使用自托管运行器时也要小心，因为任何可以复刻仓库并打开 PR 的人（通常是对仓库具有读取权限的人）都能够破坏自托管运行器环境，包括访问密码以及可授予仓库写入权限的特权 `GITHUB_TOKEN` 。 + +您还应考虑自托管运行器机器的环境： +- 配置为自托管运行器的计算机上存储哪些敏感信息？ 例如，私有 SSH 密钥、API 访问令牌等。 +- 计算机是否可通过网络访问敏感服务？ 例如，Azure 或 AWS 元数据服务。 此环境中的敏感信息量应保持在最低水平，您应该始终注意，任何能够调用工作流程的用户都有权访问此环境。 diff --git a/translations/zh-CN/content/actions/learn-github-actions/sharing-workflows-with-your-organization.md b/translations/zh-CN/content/actions/learn-github-actions/sharing-workflows-with-your-organization.md new file mode 100644 index 000000000000..02b64a7db15e --- /dev/null +++ b/translations/zh-CN/content/actions/learn-github-actions/sharing-workflows-with-your-organization.md @@ -0,0 +1,114 @@ +--- +title: Sharing workflows with your organization +shortTitle: Sharing workflows with your organization +intro: 'Learn how you can use organization features to collaborate with your team, by sharing workflow templates, secrets, and self-hosted runners.' +redirect_from: + - /actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### 概览 + +If you need to share workflows and other {% data variables.product.prodname_actions %} features with your team, then consider collaborating within a {% data variables.product.prodname_dotcom %} organization. An organization allows you to centrally store and and manage secrets, artifacts, and self-hosted runners. You can also create workflow templates in the `.github` repository and share them with other users in your organization. + +### 创建工作流程模板 + +对组织的 `.github` 仓库具有写入权限的用户可以创建工作流程模板。 然后，有权限创建工作流程的组织成员便可使用这些模板。 工作流程模板可用于在组织的公共仓库中创建新的工作流程；要使用模板在私有仓库中创建工作流程，该组织必须是企业或 GitHub One 计划的一部分。 + +此过程展示如何创建工作流程模板和元数据文件。 元数据文件描述在用户新建工作流程时如何向其显示模板。 + +1. 如果组织中没有名为 `.github` 的公共仓库，请新建一个。 +1. 创建一个名为 `workflow-templates` 的目录。 +1. 在 `workflow-templates` 目录中创建新的工作流程文件。 + + 如果需要引用仓库的默认分支，可以使用 `$default-branch` 占位符。 使用模板创建工作流程时，占位符将自动替换为仓库默认分支的名称。 + + 例如，下面这个名为 `octo-organization-ci.yml` 的文件展示了一个基本的工作流程。 + + ```yaml + name: Octo Organization CI + + on: + push: + branches: [ $default-branch ] + pull_request: + branches: [ $default-branch ] + + jobs: + build: + runs-on: ubuntu-latest + + steps: + - uses: actions/checkout@v2 + + - name: Run a one-line script + run: echo Hello from Octo Organization + ``` +1. 在 `workflow-templates` 目录中创建元数据文件。 元数据文件必须与工作流程文件同名，但扩展名不是 `.yml`，而必须附加 `.properties.json`。 例如，下面这个名为 `octo-organization-ci.properties.json` 的文件包含名为 `octo-organization-ci.yml` 的工作流程文件的元数据： + ```yaml + { + "name": "Octo Organization Workflow", + "description": "Octo Organization CI workflow template.", + "iconName": "example-icon", + "categories": [ + "Go" + ], + "filePatterns": [ + "package.json$", + "^Dockerfile", + ".*\\.md$" + ] + } + ``` + * `name` - **必要。**工作流程模板的名称。 这会显示在可用模板列表中。 + * `description` - **必要。**工作流程模板的描述。 这会显示在可用模板列表中。 + * `iconName` - **必要。**定义模板列表中工作流程项目的图标。 `iconName` 必须是同名的 SVG 图标，且必须存储在 `workflow-templates` 目录中。 例如，名为 `example-icon.svg` 的 SVG 文件被引用为 `example-icon`。 + * `categories` - **可选。**定义工作流程的语言类别。 当用户查看可用模板时，匹配相同语言的模板将更加突出。 有关可用语言类别的信息，请参阅https://github.com/github/linguist/blob/master/lib/linguist/languages.yml。 + * `filePatterns` - **可选。**如果用户仓库在其根目录中有符合定义的正则表达式的文件，则允许使用模板。 + +要添加另一个工作流模板，请将您的文件添加到同一 `workflow-templates` 目录中。 例如： + +![工作流程模板文件](/assets/images/help/images/workflow-template-files.png) + +### 使用工作流程模板 + +此程序展示组织成员如何查找并使用工作流程模板来创建新的工作流程。 只要是组织成员，都可以使用组织的工作流程模板。 + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. 如果您的仓库已经有工作流程：在左上角单击 **New workflow（新工作流程）**。 ![创建新工作流程](/assets/images/help/repository/actions-new-workflow.png) +1. 组织的工作流程模板位于其自己名为“_组织名称_创建的工作流程”的区域中。 在您想要使用的模板名称下，单击 **Set up this workflow（设置此工作流程）**。 ![设置此工作流程](/assets/images/help/settings/actions-create-starter-workflow.png) + + +### Sharing secrets within an organization + +You can centrally manage your secrets within an organization, and then make them available to selected repositories. This also means that you can update a secret in one location, and have the change apply to all repository workflows that use the secret. + +在组织中创建密码时，可以使用策略来限制可以访问该密码的仓库。 例如，您可以将访问权限授予所有仓库，也可以限制仅私有仓库或指定的仓库列表拥有访问权限。 + +{% data reusables.github-actions.permissions-statement-secrets-organization %} + +{% data reusables.organizations.navigate-to-org %} +{% data reusables.organizations.org_settings %} +{% data reusables.github-actions.sidebar-secret %} +1. 单击 **New secret（新建密码）**。 +1. 在 **Name（名称）**输入框中键入密码的名称。 +1. 输入密码的 **Value（值）**。 +1. 从 **Repository access（仓库访问权限）**下拉列表，选择访问策略。 +1. 单击 **Add secret（添加密码）**。 + +### Share self-hosted runners within an organization + +Organization admins can add their self-hosted runners to groups, and then create policies that control which repositories can access the group. + +更多信息请参阅“[使用组管理对自托管运行器的访问](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups)”。 + + +### 后续步骤 + +To continue learning about {% data variables.product.prodname_actions %}, see "[Security hardening for {% data variables.product.prodname_actions %}](/actions/learn-github-actions/security-hardening-for-github-actions)." diff --git a/translations/zh-CN/content/actions/managing-workflow-runs/adding-a-workflow-status-badge.md b/translations/zh-CN/content/actions/managing-workflow-runs/adding-a-workflow-status-badge.md new file mode 100644 index 000000000000..bfeac78809ce --- /dev/null +++ b/translations/zh-CN/content/actions/managing-workflow-runs/adding-a-workflow-status-badge.md @@ -0,0 +1,63 @@ +--- +title: Adding a workflow status badge +intro: You can display a status badge in your repository to indicate the status of your workflows. +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% data reusables.repositories.actions-workflow-status-badge-into %} + +如果您的工作流程使用 `name` 关键词，则必须按名称引用工作流程。 如果工作流程名称包含空格，您需要将空格替换为 URL 编码字符串 `%20`。 有关 `name` 关键词的更多信息，请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/articles/workflow-syntax-for-github-actions#name)”。 + +``` +https://github.com///workflows//badge.svg +``` + +或者，如果工作流程没有 `name`，则必须使用相对于仓库根目录的文件路径引用工作流程文件。 + +{% note %} + +**注意：**如果工作流程具有 `名字`，则无法使用文件路径引用工作流程文件。 + +{% endnote %} + +``` +https://github.com///workflows//badge.svg +``` + +### Using a workflow name + +此 Markdown 示例为名为 "Greet Everyone" 的工作流程添加状态徽章。 仓库的 `OWNER` 为 `actions` 组织，`REPOSITORY` 名称为 `hello-world`。 + +``` +![example workflow name](https://github.com/actions/hello-world/workflows/Greet%20Everyone/badge.svg) +``` + +### Using a workflow file path + +此 Markdown 示例为文件路径为 `.github/workflows/main.yml` 的工作流程添加状态徽章。 仓库的 `OWNER` 为 `actions` 组织，`REPOSITORY` 名称为 `hello-world`。 + +``` +![example workflow file path](https://github.com/actions/hello-world/workflows/.github/workflows/main.yml/badge.svg) +``` + +### Using the `branch` parameter + +此 Markdown 示例为名为 `feature-1` 的分支添加状态徽章。 + +``` +![example branch parameter](https://github.com/actions/hello-world/workflows/Greet%20Everyone/badge.svg?branch=feature-1) +``` + +### Using the `event` parameter + +此 Markdown 示例添加显示通过 `pull_request` 事件触发运行的工作流程状态的徽章。 + +``` +![example event parameter](https://github.com/actions/hello-world/workflows/Greet%20Everyone/badge.svg?event=pull_request) +``` diff --git a/translations/zh-CN/content/actions/managing-workflow-runs/canceling-a-workflow.md b/translations/zh-CN/content/actions/managing-workflow-runs/canceling-a-workflow.md new file mode 100644 index 000000000000..e7349c39d963 --- /dev/null +++ b/translations/zh-CN/content/actions/managing-workflow-runs/canceling-a-workflow.md @@ -0,0 +1,31 @@ +--- +title: Canceling a workflow +intro: 'You can cancel a workflow run that is in progress. 当您取消工作流程运行时，{% data variables.product.prodname_dotcom %} 会取消属于该工作流程的所有作业和步骤。' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% data reusables.repositories.permissions-statement-write %} + +### 取消工作流程运行 + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. In the upper-right corner of the workflow, click **Cancel workflow**. ![取消检查套件按钮](/assets/images/help/repository/cancel-check-suite.png) + +### {% data variables.product.prodname_dotcom %} 取消工作流程运行所执行的步骤 + +取消工作流程运行时，您可能正在运行使用与工作流程运行相关的资源的其他软件。 为了帮助您释放与工作流程运行相关的资源，它可能有助于了解 {% data variables.product.prodname_dotcom %} 为取消工作流程运行而执行的步骤。 + +1. 要取消工作流程运行，服务器将重新评估所有正在运行的作业的 `if` 条件。 如果条件评估为 `true`，作业将不会取消。 例如，条件 `if: always()` 将评估为 true，并且作业继续运行。 没有条件时，则等同于条件 `if: success()`，仅在上一步已成功完成时才会运行。 +2. 对于需要取消的作业，服务器向包含需取消作业的所有运行器机器发送取消消息。 +3. 对于继续运行的作业，服务器将对未完成的步骤重新评估 `if` 条件。 如果条件评估为 `true`，则步骤继续运行。 +4. 对于需要取消的步骤，运行器机器发送 `SIGINT/Ctrl-C` 到该步骤的输入进程（`node` 用于 javascript 操作，`docker` 用于容器操作，`bash/cmd/pwd` 则在步骤中使用 `run` 时发送）。 如果进程未在 7500 毫秒内退出，运行器将发送 `SIGTERM/Ctrl-Break` 到此进程，然后等待 2500 毫秒让进程退出。 如果该进程仍在运行，运行器会停止进程树。 +5. 在 5 分钟取消超时期后，服务器将强制终止未完成运行或无法完成取消进程的所有作业和步骤。 diff --git a/translations/zh-CN/content/actions/managing-workflow-runs/deleting-a-workflow-run.md b/translations/zh-CN/content/actions/managing-workflow-runs/deleting-a-workflow-run.md new file mode 100644 index 000000000000..0f48ff83240c --- /dev/null +++ b/translations/zh-CN/content/actions/managing-workflow-runs/deleting-a-workflow-run.md @@ -0,0 +1,23 @@ +--- +title: 删除工作流程运行 +intro: 'You can delete a workflow run that has been completed, or is more than two weeks old.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% data reusables.repositories.permissions-statement-write %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +1. 要删除工作流程运行，请使用 {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} 下拉菜单并选择 **Delete workflow run（删除工作流程运行）**。 + + ![删除工作流程运行](/assets/images/help/settings/workflow-delete-run.png) +2. 查看确认提示并单击 **Yes, permanently delete this workflow run（是，永久删除此工作流程运行）**。 + + ![删除工作流程运行确认](/assets/images/help/settings/workflow-delete-run-confirmation.png) diff --git a/translations/zh-CN/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md b/translations/zh-CN/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md new file mode 100644 index 000000000000..9b513b448c3d --- /dev/null +++ b/translations/zh-CN/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md @@ -0,0 +1,45 @@ +--- +title: Disabling and enabling a workflow +intro: 您可以使用 {% data variables.product.prodname_dotcom %} 或 REST API 禁用和重新启用工作流程。 +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.23' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +Disabling a workflow allows you to stop a workflow from being triggered without having to delete the file from the repo. You can easily re-enable the workflow again on {% data variables.product.prodname_dotcom %}. 您也可以使用 REST API 禁用和启用工作流程。 更多信息请参阅“[操作 REST API](/rest/reference/actions#workflows)”。 + +Temporarily disabling a workflow can be useful in many scenarios. These are a few examples where disabling a workflow might be helpful: + +- A workflow error that produces too many or wrong requests, impacting external services negatively. +- A workflow that is not critical and is consuming too many minutes on your account. +- A workflow that sends requests to a service that is down. +- Workflows on a forked repository that aren't needed (for example, scheduled workflows). + +{% warning %} + +**警告：** {% data reusables.actions.scheduled-workflows-disabled %} + +{% endwarning %} + +### Disabling a workflow + +You can manually disable a workflow so that it won't execute any workflow runs. A disabled workflow is not deleted, and can be re-enabled. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. In the left sidebar, click the workflow you want to disable. ![操作选择工作流程](/assets/images/actions-select-workflow.png) +1. Click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}. ![actions kebab menu](/assets/images/help/repository/actions-workflow-menu-kebab.png) +1. Click **Disable workflow**. ![actions disable workflow](/assets/images/help/repository/actions-disable-workflow.png) The disabled workflow is marked {% octicon "stop" aria-label="The stop icon" %} to indicate its status. ![actions list disabled workflow](/assets/images/help/repository/actions-find-disabled-workflow.png) + +### Enabling a workflow + +You can re-enable a workflow that was previously disabled. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. In the left sidebar, click the workflow you want to enable. ![actions select disabled workflow](/assets/images/help/repository/actions-select-disabled-workflow.png) +1. Click **Enable workflow**. ![actions enable workflow](/assets/images/help/repository/actions-enable-workflow.png) diff --git a/translations/zh-CN/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md b/translations/zh-CN/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md new file mode 100644 index 000000000000..768791f735b2 --- /dev/null +++ b/translations/zh-CN/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md @@ -0,0 +1,22 @@ +--- +title: Downloading workflow artifacts +intro: 您可以在存档的构件自动过期之前下载它们。 +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} By default, {% data variables.product.product_name %} stores build logs and artifacts for 90 days, and you can customize this retention period, depending on the type of repository. For more information, see "[Configuring the retention period for GitHub Actions artifacts and logs in your repository](/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository)."{% endif %} +{% if currentVersion == "enterprise-server@2.22" %} {% data variables.product.product_name %} stores full build logs and artifacts for 90 days.{% endif %} + +{% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. Under **Artifacts**, click the artifact you want to download. ![下载构件下拉菜单](/assets/images/help/repository/artifact-drop-down.png) diff --git a/translations/zh-CN/content/actions/managing-workflow-runs/enabling-debug-logging.md b/translations/zh-CN/content/actions/managing-workflow-runs/enabling-debug-logging.md new file mode 100644 index 000000000000..2016e0491824 --- /dev/null +++ b/translations/zh-CN/content/actions/managing-workflow-runs/enabling-debug-logging.md @@ -0,0 +1,38 @@ +--- +title: 启用调试日志 +intro: '如果工作流程日志没有提供足够的详细信息来诊断工作流程、作业或步骤未按预期工作的原因，您可以启用额外的调试日志。' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +这些额外的日志将通过在包含工作流程的仓库中设置密码来启用，因此将应用相同的权限要求： + +- {% data reusables.github-actions.permissions-statement-secrets-repository %} +- {% data reusables.github-actions.permissions-statement-secrets-organization %} +- {% data reusables.github-actions.permissions-statement-secrets-api %} + +有关设置密码的更多信息，请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 + +### 启用运行程序诊断日志 + +Runner diagnostic logging provides additional log files that contain information about how a runner is executing a job. 两个额外的日志文件被添加到日志存档中： + +* 运行程序进程日志，其中包含关于如何协调和设置运行程序执行作业的信息。 +* 工作程序进程日志，用于记录作业执行情况。 + +1. 要启用运行程序诊断日志，请在包含工作流程的仓库中设置以下密码：将 `ACTIONS_RUNNER_DEBUG` 设置为 `true`。 + +1. 要下载运行程序诊断日志，请下载工作流程运行情况的日志存档。 运行程序诊断日志包含在 `runner-diagnostic-logs` 文件夹中。 关于下载日志的更多信息，请参阅“[下载日志](/actions/managing-workflow-runs/using-workflow-run-logs/#downloading-logs)”。 + +### 启用步骤调试日志 + +步骤调试日志增加了作业执行期间和执行之后的作业日志的详细程度。 + +1. 要启用步骤调试日志，必须在包含工作流程的仓库中设置以下密码：将 `ACTIONS_STEP_DEBUG` 设置为 `true`。 + +1. 设置密码后，步骤日志中会显示更多调试事件。 更多信息请参阅[“查看日志以诊断故障”](/actions/managing-workflow-runs/using-workflow-run-logs/#viewing-logs-to-diagnose-failures)。 diff --git a/translations/zh-CN/content/actions/managing-workflow-runs/index.md b/translations/zh-CN/content/actions/managing-workflow-runs/index.md new file mode 100644 index 000000000000..dfe34a757a0a --- /dev/null +++ b/translations/zh-CN/content/actions/managing-workflow-runs/index.md @@ -0,0 +1,32 @@ +--- +title: Managing workflow runs +shortTitle: Managing workflow runs +intro: '您可以查看工作流程中每个步骤的状态和结果，取消待定的工作流程，查看可计费作业执行分钟数，调试并重新运行失败的工作流程，搜索并下载日志，以及下载构件。' +redirect_from: + - /actions/configuring-and-managing-workflows/managing-a-workflow-run + - /articles/viewing-your-repository-s-workflows + - /articles/viewing-your-repositorys-workflows + - /articles/managing-a-workflow-run + - /github/automating-your-workflow-with-github-actions/managing-a-workflow-run + - /actions/automating-your-workflow-with-github-actions/managing-a-workflow-run + - /actions/configuring-and-managing-workflows/configuring-and-managing-workflow-files-and-runs +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% link_in_list /viewing-workflow-run-history %} +{% link_in_list /using-workflow-run-logs %} +{% link_in_list /manually-running-a-workflow %} +{% link_in_list /re-running-a-workflow %} +{% link_in_list /canceling-a-workflow %} +{% link_in_list /disabling-and-enabling-a-workflow %} +{% link_in_list /deleting-a-workflow-run %} +{% link_in_list /viewing-job-execution-time %} +{% link_in_list /downloading-workflow-artifacts %} +{% link_in_list /removing-workflow-artifacts %} +{% link_in_list /enabling-debug-logging %} +{% link_in_list /adding-a-workflow-status-badge %} diff --git a/translations/zh-CN/content/actions/managing-workflow-runs/manually-running-a-workflow.md b/translations/zh-CN/content/actions/managing-workflow-runs/manually-running-a-workflow.md new file mode 100644 index 000000000000..e82ee5587280 --- /dev/null +++ b/translations/zh-CN/content/actions/managing-workflow-runs/manually-running-a-workflow.md @@ -0,0 +1,31 @@ +--- +title: 手动运行工作流程 +intro: 'When a workflow is configured to run on the `workflow_dispatch` event, you can run the workflow using the REST API or from the Actions tab on {% data variables.product.prodname_dotcom %}.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +To run a workflow manually, the workflow must be configured to run on the `workflow_dispatch` event. 更多信息请参阅“[触发工作流程的事件](/actions/reference/events-that-trigger-workflows)”。 + +### Running a workflow on {% data variables.product.prodname_dotcom %} + +要在 {% data variables.product.prodname_dotcom %} 上触发 `Workflow_spoch` 事件，您的工作流程必须在默认分支中。 按照以下步骤手动触发工作流程运行。 + +{% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. 在左侧边栏中，单击您想要运行的工作流程。 ![操作选择工作流程](/assets/images/actions-select-workflow.png) +1. 在工作流程运行列表上方选择 **Run workflow（运行工作流程）**。 ![操作工作流程调度](/assets/images/actions-workflow-dispatch.png) +1. 选择工作流程将要运行的分支，并键入工作流程使用的输入参数。 单击 **Run workflow（运行工作流程）**。 ![操作手动运行工作流程](/assets/images/actions-manually-run-workflow.png) + +### Running a workflow using the REST API + +使用 REST API 时，应将 `inputs` 和 `ref` 配置为请求正文参数。 如果忽略输入，则使用工作流程文件中定义的默认值。 + +有关使用 REST API 的更多信息，请参阅“[创建工作流程调度事件](/rest/reference/actions/#create-a-workflow-dispatch-event)”。 diff --git a/translations/zh-CN/content/actions/managing-workflow-runs/re-running-a-workflow.md b/translations/zh-CN/content/actions/managing-workflow-runs/re-running-a-workflow.md new file mode 100644 index 000000000000..c82ddc239139 --- /dev/null +++ b/translations/zh-CN/content/actions/managing-workflow-runs/re-running-a-workflow.md @@ -0,0 +1,19 @@ +--- +title: Re-running a workflow +intro: You can re-run an instance of a workflow. Re-running a workflow uses the same `GITHUB_SHA` (commit SHA) and `GITHUB_REF` (Git ref) of the original event that triggered the workflow run. +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. In the upper-right corner of the workflow, use the **Re-run jobs** drop-down menu, and select **Re-run all jobs**. ![重新运行检查下拉菜单](/assets/images/help/repository/rerun-checks-drop-down.png) diff --git a/translations/zh-CN/content/actions/managing-workflow-runs/removing-workflow-artifacts.md b/translations/zh-CN/content/actions/managing-workflow-runs/removing-workflow-artifacts.md new file mode 100644 index 000000000000..7273e1d1326b --- /dev/null +++ b/translations/zh-CN/content/actions/managing-workflow-runs/removing-workflow-artifacts.md @@ -0,0 +1,41 @@ +--- +title: Removing workflow artifacts +intro: '您可以在构件于 {% data variables.product.product_name %} 上过期之前删除它们，回收已经使用的 {% data variables.product.prodname_actions %} 存储。' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### 删除构件 + +{% warning %} + +**警告：** 构件一旦删除，便无法恢复。 + +{% endwarning %} + +{% data reusables.repositories.permissions-statement-write %} + +{% data reusables.github-actions.artifact-log-retention-statement %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. Under **Artifacts**, click {% octicon "trashcan" aria-label="The trashcan icon" %} next to the artifact you want to remove. ![删除构件下拉菜单](/assets/images/help/repository/actions-delete-artifact.png) + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +### 设置构件的保留期 + +可在仓库、组织和企业级配置构件和日志的保留期。 更多信息请参阅“[使用限制、计费和管理](/actions/reference/usage-limits-billing-and-administration#artifact-and-log-retention-policy)”。 + +您也可以在工作流程中使用 `actions/upload-artifact` 操作自定义个别构件的保留期。 更多信息请参阅“[将工作流程存储为构件](/actions/guides/storing-workflow-data-as-artifacts#configuring-a-custom-artifact-retention-period)”。 + +### 查找构件的到期日期 + +您可以使用 API 确认构件计划删除的日期。 更多信息请参阅“[列出仓库的构件](/rest/reference/actions#artifacts)”返回的 `expires_at` 值。 +{% endif %} \ No newline at end of file diff --git a/translations/zh-CN/content/actions/managing-workflow-runs/using-workflow-run-logs.md b/translations/zh-CN/content/actions/managing-workflow-runs/using-workflow-run-logs.md new file mode 100644 index 000000000000..a364abef9174 --- /dev/null +++ b/translations/zh-CN/content/actions/managing-workflow-runs/using-workflow-run-logs.md @@ -0,0 +1,86 @@ +--- +title: Using workflow run logs +intro: 'You can view, search, and download the logs for each job in a workflow run.' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +您可以从工作流程运行页面查看工作流程运行是在进行中，还是已完成。 您必须登录到 {% data variables.product.prodname_dotcom %} 帐户才能查看工作流程运行信息，包括公共仓库。 更多信息请参阅“[GitHub 上的访问权限](/articles/access-permissions-on-github)”。 + +如果运行已完成，则可查看运行结果是成功、失败、已取消还是中性。 如果运行失败，您可以查看并搜索构建日志，来诊断失败原因并重新运行工作流程。 您也可以查看可计费作业执行分钟数，或下载日志和创建构件。 + +{% data variables.product.prodname_actions %} 使用 Checks API 来输出工作流程的状态、结果和日志。 {% data variables.product.prodname_dotcom %} 对每个工作流程创建新检查套件。 检查套件包含检查工作流程中每项作业的运行，而每项作业包含步骤。 {% data variables.product.prodname_actions %} 作为工作流程中的一个步骤运行。 有关检查 API 的详细信息，请参阅“[检查](/v3/checks/)”。 + +{% data reusables.github-actions.invalid-workflow-files %} + +### 查看日志以诊断故障 + +如果工作流程运行失败，您可以查看是哪个步骤导致了失败，然后审查失败步骤的创建日志进行故障排除。 您可以查看每个步骤运行的时长。 也可以将永久链接复制到日志文件中的特定行，与您的团队分享。 {% data reusables.repositories.permissions-statement-read %} + +In addition to the steps configured in the workflow file, {% data variables.product.prodname_dotcom %} adds two additional steps to each job to set up and complete the job's execution. These steps are logged in the workflow run with the names "Set up job" and "Complete job". + +对于在 {% data variables.product.prodname_dotcom %} 托管的运行器上运行的作业，“设置作业”记录运行器虚拟环境的详细信息。 并包含一个链接，可链接到运行器机器上的预安装工具列表。 + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +{% data reusables.repositories.navigate-to-job-superlinter %} +{% data reusables.repositories.view-failed-job-results-superlinter %} +{% data reusables.repositories.view-specific-line-superlinter %} + +### 搜索日志 + +您可以搜索特定步骤的创建日志。 在搜索日志时，只有展开的步骤会包含在结果中。 {% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +{% data reusables.repositories.navigate-to-job-superlinter %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +1. 在日志输出的右上角，在 **Search logs（搜索日志）**搜索框中输入搜索查询。 ![搜索日志的搜索框](/assets/images/help/repository/search-log-box-updated.png) +{% else %} +1. 要展开想包含在搜索中的每个步骤，请单击该步骤。 ![步骤名称](/assets/images/help/repository/failed-check-step.png) +1. 在日志输出的右上角，在 **Search logs（搜索日志）**搜索框中输入搜索查询。 ![搜索日志的搜索框](/assets/images/help/repository/search-log-box.png) +{% endif %} + +### 下载日志 + +您可以从工作流程运行中下载日志文件。 您也可以下载工作流程的构件。 更多信息请参阅“[使用构件持久化工作流程](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)”。 {% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +{% data reusables.repositories.navigate-to-job-superlinter %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +1. In the upper right corner, click +{% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} and select **Download log archive**. + ![下载日志下拉菜单](/assets/images/help/repository/download-logs-drop-down-updated.png) +{% else %} +1. In the upper right corner, click +{% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} and select **Download log archive**. + ![下载日志下拉菜单](/assets/images/help/repository/download-logs-drop-down.png) +{% endif %} + +### 删除日志 + +您可以从工作流程运行中删除日志文件。 {% data reusables.repositories.permissions-statement-write %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +1. In the upper right corner, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}. ![Kebab-horizontal icon](/assets/images/help/repository/workflow-run-kebab-horizontal-icon-updated.png) +2. 要删除日志文件，单击 **Delete all logs（删除所有日志）**按钮并审查确认提示。 ![删除所有日志](/assets/images/help/repository/delete-all-logs-updated.png) 删除日志后，**Delete all logs（删除所有日志）**按钮将被删除，以表明工作流程运行中未剩下任何日志文件。 +{% else %} +1. In the upper right corner, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}. ![Kebab-horizontal icon](/assets/images/help/repository/workflow-run-kebab-horizontal-icon.png) +2. 要删除日志文件，单击 **Delete all logs（删除所有日志）**按钮并审查确认提示。 ![Delete all logs](/assets/images/help/repository/delete-all-logs.png) After the logs have been deleted, the **Delete all logs** button is removed to indicate that no log files remain in the workflow run. +{% endif %} diff --git a/translations/zh-CN/content/actions/managing-workflow-runs/viewing-job-execution-time.md b/translations/zh-CN/content/actions/managing-workflow-runs/viewing-job-execution-time.md new file mode 100644 index 000000000000..70cf0fdce651 --- /dev/null +++ b/translations/zh-CN/content/actions/managing-workflow-runs/viewing-job-execution-time.md @@ -0,0 +1,24 @@ +--- +title: Viewing job execution time +intro: '您可以查看作业的执行时间，包括某个作业累积的可计费分钟数。' +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +仅为在私有仓库上运行，使用 {% data variables.product.prodname_dotcom %}- 托管的运行器的作业显示可计费作业执行分钟数。 如果在公共仓库中使用 {% data variables.product.prodname_actions %}，或在自托管的运行器中运行作业时，将没有可计费分钟数。 + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} +1. Under the job summary, you can view the job's execution time. To view the billable job execution time, click **Run and billable time details**. ![运行和可计费时间详细信息链接](/assets/images/help/repository/view-run-billable-time.png) + + {% note %} + + **注意：**显示的可计费时间不包括任何四舍五入或分钟乘数。 要查看您的 {% data variables.product.prodname_actions %} 总使用情况，包括四舍五入和分钟乘法，请参阅"[查看您的 {% data variables.product.prodname_actions %} 使用情况](/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage)。" + + {% endnote %} diff --git a/translations/zh-CN/content/actions/managing-workflow-runs/viewing-workflow-run-history.md b/translations/zh-CN/content/actions/managing-workflow-runs/viewing-workflow-run-history.md new file mode 100644 index 000000000000..47ca04068ef3 --- /dev/null +++ b/translations/zh-CN/content/actions/managing-workflow-runs/viewing-workflow-run-history.md @@ -0,0 +1,18 @@ +--- +title: Viewing workflow run history +intro: You can view logs for each run of a workflow. Logs include the status for each job and step in a workflow. +product: '{% data reusables.gated-features.actions %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +{% data reusables.repositories.permissions-statement-read %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow %} +{% data reusables.repositories.view-run %} diff --git a/translations/zh-CN/content/actions/quickstart.md b/translations/zh-CN/content/actions/quickstart.md new file mode 100644 index 000000000000..dbcb827533af --- /dev/null +++ b/translations/zh-CN/content/actions/quickstart.md @@ -0,0 +1,75 @@ +--- +title: GitHub Actions 快速入门 +intro: '在 5 分钟或更短时间内将 {% data variables.product.prodname_actions %} 工作流程添加到现有仓库。' +allowTitleToDifferFromFilename: true +redirect_from: + - /actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### 简介 + +您只需要一个现有的 {% data variables.product.prodname_dotcom %} 仓库来创建和运行 {% data variables.product.prodname_actions %} 工作流程。 在本指南中，您将添加一个工作流程，使用 [{% data variables.product.prodname_dotcom %} Super-Linter 操作](https://github.com/github/super-linter)链接多种编码语言。 每次有新的提交被推送到您的仓库时，工作流程都会使用 Super-Linter 验证源代码。 + +### 创建第一个工作流程 + +1. 从 {% data variables.product.prodname_dotcom %} 上的仓库，在 `.github/workflow` 目录中创建一个名为 `superlinter.yml` 的新文件。 更多信息请参阅“[创建新文件](/github/managing-files-in-a-repository/creating-new-files)”。 +2. 将以下 YAML 内容复制到 `superlinter.yml` 文件中。 **注：** 如果您的默认分支不是 `main`，请更新 `DEFAULT_BRANCH` 的值以匹配您仓库的默认分支名称。 + {% raw %} + ```yaml + name: Super-Linter + + # Run this workflow every time a new commit pushed to your repository + on: push + + jobs: + # Set the job key. The key is displayed as the job name + # when a job name is not provided + super-lint: + # Name the Job + name: Lint code base + # Set the type of machine to run on + runs-on: ubuntu-latest + + steps: + # Checks out a copy of your repository on the ubuntu-latest machine + - name: Checkout code + uses: actions/checkout@v2 + + # Runs the Super-Linter action + - name: Run Super-Linter + uses: github/super-linter@v3 + env: + DEFAULT_BRANCH: main + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + ``` + {% endraw %} +3. 要运行您的工作流程， 滚动到页面底部，然后选择 **为此提交创建一个新分支并开始拉取请求**。 然后，若要创建拉取请求，请单击 **Propose new file（提议新文件）**。 ![提交工作流程文件](/assets/images/commit-workflow-file.png) + +在仓库中提交工作流程文件会触发 `push` 事件并运行工作流程。 + +### 查看工作流程结果 + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +{% data reusables.repositories.navigate-to-workflow-superlinter %} +{% data reusables.repositories.view-run-superlinter %} +1. 在左侧边栏中，单击 **Lint code base（Lint 代码库）**作业。 ![Lint 代码库作业](/assets/images/help/repository/superlinter-lint-code-base-job.png) +{% data reusables.repositories.view-failed-job-results-superlinter %} + +### 更多入门工作流程 + +{% data variables.product.prodname_dotcom %} 提供预配置的工作流程模板，您可以从这些模板开始自动执行或创建持续集成工作流程。 您可以在 {% if currentVersion == "free-pro-team@latest" %}[actions/starter-workflows](https://github.com/actions/starter-workflows) 仓库{% else %} {% data variables.product.product_location %} 上的 `actions/starter-workflows` 仓库{% endif %}中浏览工作流程模板的完整列表。 + +### 后续步骤 + +只要代码推送到仓库，您刚才添加的 super-linter 工作流程就会运行，以帮助您发现代码中的错误和不一致。 但是，这只是您可以对 {% data variables.product.prodname_actions %} 执行操作的开始。 您的仓库可以包含多个基于不同事件触发不同任务的工作流程。 {% data variables.product.prodname_actions %} 可以帮助您自动执行应用程序开发过程的几乎每个方面。 准备好开始了吗？ 以下是一些帮助您对 {% data variables.product.prodname_actions %} 执行后续操作的有用资源： + +- “[了解 {% data variables.product.prodname_actions %}](/actions/learn-github-actions)”，以获取深入教程 +- “[指南](/actions/guides)”，以获取特定用例和示例 +- [github/super-linter](https://github.com/github/super-linter)，以获取有关配置 Super-Linter 操作的详细信息 diff --git a/translations/zh-CN/content/actions/reference/authentication-in-a-workflow.md b/translations/zh-CN/content/actions/reference/authentication-in-a-workflow.md new file mode 100644 index 000000000000..4193e29c9a4e --- /dev/null +++ b/translations/zh-CN/content/actions/reference/authentication-in-a-workflow.md @@ -0,0 +1,100 @@ +--- +title: Authentication in a workflow +intro: '{% data variables.product.prodname_dotcom %} 提供一个令牌，可用于代表 {% data variables.product.prodname_actions %} 进行身份验证。' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /github/automating-your-workflow-with-github-actions/authenticating-with-the-github_token + - /actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token + - /actions/configuring-and-managing-workflows/authenticating-with-the-github_token +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +对仓库具有 `write` 权限的任何人都可以创建、读取和使用密码。 + +### 关于 `GITHUB_TOKEN` 密码 + +{% data variables.product.prodname_dotcom %} 会自动创建 `GITHUB_TOKEN` 密码以在工作流程中使用。 您可以使用 `GITHUB_TOKEN` 在工作流程运行中进行身份验证。 + +当您启用 {% data variables.product.prodname_actions %} 时，{% data variables.product.prodname_dotcom %} 在您的仓库中安装 {% data variables.product.prodname_github_app %}。 `GITHUB_TOKEN` 密码是一种 {% data variables.product.prodname_github_app %} 安装访问令牌。 您可以使用安装访问令牌代表仓库中安装的 {% data variables.product.prodname_github_app %} 进行身份验证。 令牌的权限仅限于包含您的工作流程的仓库。 更多信息请参阅“[`GITHUB_TOKEN`](#permissions-for-the-github_token) 的权限”。 + +在每个作业开始之前， {% data variables.product.prodname_dotcom %} 将为作业提取安装访问令牌。 令牌在作业完成后过期。 + +令牌在 `github.token` 上下文中也可用。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的上下文和表达式语法](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)”。 + +### 在工作流程中使用 `GITHUB_TOKEN` + +要使用 `GITHUB_TOKEN` 密码，必须在工作流程文件中引用它。 使用令牌可能包括将令牌作为输入传递给需要该令牌的操作，或进行经过身份验证的 {% data variables.product.prodname_dotcom %} API 调用。 + +{% data reusables.github-actions.actions-do-not-trigger-workflows %} + +#### 将 `GITHUB_TOKEN` 作为输入传递的示例 + +此示例工作流程使用[贴标器操作](https://github.com/actions/labeler)，需要 `GITHUB_TOKEN` 作为 `repo-token` 输入参数的值： + + {% raw %} + ```yaml + name: Pull request labeler + on: + - pull_request + jobs: + triage: + runs-on: ubuntu-latest + steps: + - uses: actions/labeler@v2 + with: + repo-token: ${{ secrets.GITHUB_TOKEN }} + ``` + {% endraw %} + +#### 调用 REST API 的示例 + +您可以使用 `GITHUB_TOKEN` 进行经过验证的 API 调用。 此示例工作流程使用 {% data variables.product.prodname_dotcom %} REST API 创建议题： + + {% raw %} + ```yaml + name: Create issue on commit + on: + - push + jobs: + create_commit: + runs-on: ubuntu-latest + steps: + - name: Create issue using REST API + run: | + curl --request POST \ + --url https://api.github.com/repos/${{ github.repository }}/issues \ + --header 'authorization: Bearer ${{ secrets.GITHUB_TOKEN }}' \ + --header 'content-type: application/json' \ + --data '{ + "title": "Automated issue for commit: ${{ github.sha }}", + "body": "This issue was automatically created by the GitHub Action workflow **${{ github.workflow }}**. \n\n 提交哈希是： _${{ github.sha }}_" + }' + ``` + {% endraw %} + +### `GITHUB_TOKEN` 的权限 + +有关 {% data variables.product.prodname_github_apps %} 可通过各种权限访问的 API 端点的信息，请参阅“[{% data variables.product.prodname_github_app %} 权限](/v3/apps/permissions/)”。 + +| 权限 | 访问类型 | 通过复刻的仓库访问 | +| -------- | ---- | --------- | +| 操作 | 读/写 | 读取 | +| 检查 | 读/写 | 读取 | +| 内容 | 读/写 | 读取 | +| 部署 | 读/写 | 读取 | +| issues | 读/写 | 读取 | +| 元数据 | 读取 | 读取 | +| 包 | 读/写 | 读取 | +| 拉取请求 | 读/写 | 读取 | +| 仓库项目 | 读/写 | 读取 | +| statuses | 读/写 | 读取 | + +如果您需要的令牌需要 `GITHUB_TOKEN` 中未提供的权限，您可以创建个人访问令牌并将其设置为仓库中的密码： + +1. 使用或创建具有该仓库适当权限的令牌。 更多信息请参阅“[创建个人访问令牌](/github/authenticating-to-github/creating-a-personal-access-token)”。 +1. 添加令牌作为工作流程仓库中的密码，然后使用 {%raw%}`${{ secrets.SECRET_NAME }}`{% endraw %} 语法进行引用。 更多信息请参阅“[创建和使用加密密码](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 diff --git a/translations/zh-CN/content/actions/reference/context-and-expression-syntax-for-github-actions.md b/translations/zh-CN/content/actions/reference/context-and-expression-syntax-for-github-actions.md index 6ab9b391d44f..b7ad502c9eab 100644 --- a/translations/zh-CN/content/actions/reference/context-and-expression-syntax-for-github-actions.md +++ b/translations/zh-CN/content/actions/reference/context-and-expression-syntax-for-github-actions.md @@ -81,27 +81,27 @@ env: {% data reusables.github-actions.github-context-warning %} -| 属性名称 | 类型 | 描述 | -| ------------------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `github` | `对象` | 工作流程中任何作业或步骤期间可用的顶层上下文。 | -| `github.event` | `对象` | 完整事件 web 挂钩有效负载。 更多信息请参阅“[触发工作流程的事件](/articles/events-that-trigger-workflows/)”。 您可以使用上下文访问事件的个别属性。 | -| `github.event_path` | `字符串` | 运行器上完整事件 web 挂钩有效负载的路径。 | -| `github.workflow` | `字符串` | 工作流程的名称。 如果工作流程文件未指定 `name`，此属性的值将是仓库中工作流程文件的完整路径。 | -| `github.job` | `字符串` | 当前作业的 [`job_id`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_id)。 | -| `github.run_id` | `字符串` | {% data reusables.github-actions.run_id_description %} | -| `github.run_number` | `字符串` | {% data reusables.github-actions.run_number_description %} | -| `github.actor` | `字符串` | 发起工作流程运行的用户的登录名。 | -| `github.repository` | `字符串` | 所有者和仓库名称。 例如 `Codertocat/Hello-World`。 | -| `github.repository_owner` | `字符串` | 仓库所有者的名称。 例如 `Codertocat`。 | -| `github.event_name` | `字符串` | 触发工作流程运行的事件的名称。 | -| `github.sha` | `字符串` | 触发工作流程的提交 SHA。 | -| `github.ref` | `字符串` | 触发工作流程的分支或标记参考。 | -| `github.head_ref` | `字符串` | 工作流程运行中拉取请求的 `head_ref` 或来源分支。 此属性仅在触发工作流程运行的事件为 `pull_request` 时才可用。 | -| `github.base_ref` | `字符串` | 工作流程运行中拉取请求的 `base_ref` 或目标分支。 此属性仅在触发工作流程运行的事件为 `pull_request` 时才可用。 | -| `github.token` | `字符串` | 代表仓库上安装的 GitHub 应用程序进行身份验证的令牌。 这在功能上等同于 `GITHUB_TOKEN` 密码。 更多信息请参阅“[使用 GITHUB_TOKEN 验证身份](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)”。 | -| `github.workspace` | `字符串` | 使用 [`checkout`](https://github.com/actions/checkout) 操作时步骤的默认工作目录和仓库的默认位置。 | +| 属性名称 | 类型 | 描述 | +| ------------------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `github` | `对象` | 工作流程中任何作业或步骤期间可用的顶层上下文。 | | `github.action` | `字符串` | 正在运行的操作的名称。 在当前步骤运行脚本时，{% data variables.product.prodname_dotcom %} 删除特殊字符或使用名称 `run`。 如果在同一作业中多次使用相同的操作，则名称将包括带有序列号的后缀。 例如，运行的第一个脚本名称为 `run1`，则第二个脚本将命名为 `run2`。 同样，`actions/checkout` 第二次调用时将变成 `actionscheckout2`。 | -| `github.action_path` | `字符串` | 您的操作所在的路径。 您可以使用此路径轻松访问与操作位于同一仓库中的文件。 此属性仅在复合运行步骤操作中才受支持。 | +| `github.action_path` | `字符串` | 您的操作所在的路径。 您可以使用此路径轻松访问与操作位于同一仓库中的文件。 此属性仅在复合运行步骤操作中才受支持。 | +| `github.actor` | `字符串` | 发起工作流程运行的用户的登录名。 | +| `github.base_ref` | `字符串` | 工作流程运行中拉取请求的 `base_ref` 或目标分支。 此属性仅在触发工作流程运行的事件为 `pull_request` 时才可用。 | +| `github.event` | `对象` | 完整事件 web 挂钩有效负载。 更多信息请参阅“[触发工作流程的事件](/articles/events-that-trigger-workflows/)”。 您可以使用上下文访问事件的个别属性。 | +| `github.event_name` | `字符串` | 触发工作流程运行的事件的名称。 | +| `github.event_path` | `字符串` | 运行器上完整事件 web 挂钩有效负载的路径。 | +| `github.head_ref` | `字符串` | 工作流程运行中拉取请求的 `head_ref` 或来源分支。 此属性仅在触发工作流程运行的事件为 `pull_request` 时才可用。 | +| `github.job` | `字符串` | 当前作业的 [`job_id`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_id)。 | +| `github.ref` | `字符串` | 触发工作流程的分支或标记参考。 | +| `github.repository` | `字符串` | 所有者和仓库名称。 例如 `Codertocat/Hello-World`。 | +| `github.repository_owner` | `字符串` | 仓库所有者的名称。 例如 `Codertocat`。 | +| `github.run_id` | `字符串` | {% data reusables.github-actions.run_id_description %} +| `github.run_number` | `字符串` | {% data reusables.github-actions.run_number_description %} +| `github.sha` | `字符串` | 触发工作流程的提交 SHA。 | +| `github.token` | `字符串` | 代表仓库上安装的 GitHub 应用程序进行身份验证的令牌。 这在功能上等同于 `GITHUB_TOKEN` 密码。 更多信息请参阅“[使用 GITHUB_TOKEN 验证身份](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)”。 | +| `github.workflow` | `字符串` | 工作流程的名称。 如果工作流程文件未指定 `name`，此属性的值将是仓库中工作流程文件的完整路径。 | +| `github.workspace` | `字符串` | 使用 [`checkout`](https://github.com/actions/checkout) 操作时步骤的默认工作目录和仓库的默认位置。 | #### **`env` 上下文** @@ -121,17 +121,17 @@ env: `job` 上下文包含当前正在运行的作业相关信息。 -| 属性名称 | 类型 | 描述 | -| ----------------------------------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `job` | `对象` | 此上下文针对工作流程运行中的每项作业而改变。 您可以从作业中的任何步骤访问此上下文。 | -| `job.status` | `字符串` | 作业的当前状态。 可能的值包括 `success`、`failure` 或 `cancelled`。 | +| 属性名称 | 类型 | 描述 | +| ----------------------------------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `job` | `对象` | 此上下文针对工作流程运行中的每项作业而改变。 您可以从作业中的任何步骤访问此上下文。 | | `job.container` | `对象` | 作业的容器相关信息。 有关容器的更多信息，请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/articles/workflow-syntax-for-github-actions#jobsjob_idcontainer)”。 | -| `job.container.network` | `字符串` | 容器网络的 id。 运行程序创建作业中所有容器使用的网络。 | -| `job.container.id` | `字符串` | 容器的 id。 | +| `job.container.id` | `字符串` | 容器的 id。 | +| `job.container.network` | `字符串` | 容器网络的 id。 运行程序创建作业中所有容器使用的网络。 | | `job.services` | `对象` | 为作业创建的服务容器。 有关服务容器的更多信息，请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/articles/workflow-syntax-for-github-actions#jobsjob_idservices)”。 | -| `job.services..id` | `字符串` | 服务容器的 id。 | -| `job.services..ports` | `对象` | 服务容器显露的端口。 | -| `job.services..network` | `字符串` | 服务容器网络的 id。 运行程序创建作业中所有容器使用的网络。 | +| `job.services..id` | `字符串` | 服务容器的 id。 | +| `job.services..network` | `字符串` | 服务容器网络的 id。 运行程序创建作业中所有容器使用的网络。 | +| `job.services..ports` | `对象` | 服务容器显露的端口。 | +| `job.status` | `字符串` | 作业的当前状态。 可能的值包括 `success`、`failure` 或 `cancelled`。 | #### **`steps` 上下文** @@ -140,31 +140,31 @@ env: | 属性名称 | 类型 | 描述 | | --------------------------------------------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `steps` | `对象` | 此上下文针对作业中的每个步骤而改变。 您可以从作业中的任何步骤访问此上下文。 | -| `steps..outputs` | `对象` | 为步骤定义的输出集。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的元数据语法](/articles/metadata-syntax-for-github-actions#outputs)”。 | -| `steps..outputs.` | `字符串` | 特定输出的值。 | -| `steps..outcome` | `字符串` | 在 [`continue-on-error`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepscontinue-on-error) 应用之前完成的步骤的结果。 可能的值包括 `success`、`failure`、`cancelled` 或 `skipped`。 当 `continue-on-error` 步骤失败时，`outcome` 为 `failure`，但最终的 `conclusion` 为 `success`。 | +| `steps..outputs` | `对象` | 为步骤定义的输出集。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的元数据语法](/articles/metadata-syntax-for-github-actions#outputs)”。 | | `steps..conclusion` | `字符串` | 在 [`continue-on-error`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepscontinue-on-error) 应用之后完成的步骤的结果。 可能的值包括 `success`、`failure`、`cancelled` 或 `skipped`。 当 `continue-on-error` 步骤失败时，`outcome` 为 `failure`，但最终的 `conclusion` 为 `success`。 | +| `steps..outcome` | `字符串` | 在 [`continue-on-error`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepscontinue-on-error) 应用之前完成的步骤的结果。 可能的值包括 `success`、`failure`、`cancelled` 或 `skipped`。 当 `continue-on-error` 步骤失败时，`outcome` 为 `failure`，但最终的 `conclusion` 为 `success`。 | +| `steps..outputs.` | `字符串` | 特定输出的值。 | #### **`runner` 上下文** `runner` 上下文包含正在执行当前作业的运行器相关信息。 -| 属性名称 | 类型 | 描述 | -| ------------------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `runner.os` | `字符串` | 执行作业的运行器的操作系统。 可能的值为 `Linux`、`Windows` 或 `macOS`。 | -| `runner.temp` | `字符串` | 运行器临时目录的路径。 此目录保证在每个作业开始时为空，即使在自托管的运行器上也是如此。 | -| `runner.tool_cache` | `字符串` | 包含 {% data variables.product.prodname_dotcom %} 托管运行器一些预安装工具的目录路径。 更多信息请参阅“[GitHub-hosted 运行器上安装的软件](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)”。 | +| 属性名称 | 类型 | 描述 | +| ------------------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `runner.os` | `字符串` | 执行作业的运行器的操作系统。 可能的值为 `Linux`、`Windows` 或 `macOS`。 | +| `runner.temp` | `字符串` | 运行器临时目录的路径。 此目录保证在每个作业开始时为空，即使在自托管的运行器上也是如此。 | +| `runner.tool_cache` | `字符串` | 包含 {% data variables.product.prodname_dotcom %} 托管运行器一些预安装工具的目录路径。 更多信息请参阅“[{% data variables.product.prodname_dotcom %} 托管运行器的规范](/actions/reference/specifications-for-github-hosted-runners/#supported-software)”。 | #### **`needs` 上下文** `needs` 上下文包含定义为当前作业依赖项的所有作业的输出。 有关定义作业依赖项的更多信息，请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)”。 -| 属性名称 | 类型 | 描述 | -| -------------------------------------------------- | ----- | ------------------------------------------------------- | -| `needs.` | `对象` | 当前作业依赖的单个作业。 | -| `needs..result` | `字符串` | 当前作业依赖的作业的结果。 可能的值包括 `success`、`failure` 或 `cancelled`。 | -| `needs..outputs` | `对象` | 当前作业依赖的作业的输出集。 | -| `needs..outputs.` | `字符串` | 当前作业依赖的作业的特定输出值。 | +| 属性名称 | 类型 | 描述 | +| -------------------------------------------------- | ----- | ----------------------------------------------------------------- | +| `needs.` | `对象` | 当前作业依赖的单个作业。 | +| `needs..outputs` | `对象` | 当前作业依赖的作业的输出集。 | +| `needs..outputs.` | `字符串` | 当前作业依赖的作业的特定输出值。 | +| `needs..result` | `字符串` | 当前作业依赖的作业的结果。 可能的值包括 `success`、`failure`、`cancelled` 或 `skipped`。 | #### 打印上下文信息到日志文件的示例 @@ -179,7 +179,7 @@ on: push jobs: one: - runs-on: ubuntu-16.04 + runs-on: ubuntu-latest steps: - name: Dump GitHub context env: diff --git a/translations/zh-CN/content/actions/reference/encrypted-secrets.md b/translations/zh-CN/content/actions/reference/encrypted-secrets.md new file mode 100644 index 000000000000..68401b051f5a --- /dev/null +++ b/translations/zh-CN/content/actions/reference/encrypted-secrets.md @@ -0,0 +1,221 @@ +--- +title: Encrypted secrets +intro: 加密密码允许您在仓库或组织中存储敏感信息。 +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets + - /actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets + - /actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### 关于加密密码 + +密码是在仓库或组织中创建的加密环境变量。 您创建的密码可用于 {% data variables.product.prodname_actions %} 工作流程。 在密码到达 {% data variables.product.prodname_dotcom %} 之前，{% data variables.product.prodname_dotcom %} 使用 [libsodium 密封盒](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes)对密码加密，并且在您于工作流程中使用它们之前一直保持加密状态。 + +{% data reusables.github-actions.secrets-org-level-overview %} + +#### 命名您的密码 + +以下规则适用于密码名称： + +* 密码名称只能包含字母数字字符（`[a-z]`、`[A-Z]`、`[0-9]`）或下划线 (`_`)。 不允许空格。 +* 密码名称不能以 `GITHUB_` 前缀开头。 +* 密码名称不能以数字开头。 +* 密码名称在所创建的级别上必须是唯一的。 例如，在组织级别创建的密码必须在该级别具有唯一名称，而在仓库级别创建的密码必须在该仓库具有唯一名称。 如果组织级别密码的名称与仓库级别的密码相同，则仓库级别的密码优先。 + +为帮助确保 {% data variables.product.prodname_dotcom %} 在日志中编写密码，请勿将结构化数据用作密码的值。 例如，避免创建包含 JSON 或编码 Git blob 的密码。 + +#### 访问您的密码 + +为使密码用于操作，必须将密码设置为工作流程文件中的输入或环境变量。 查看操作的自述文件以了解操作预期的输入和环境变量。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)”。 + +如果您拥有编辑文件的权限，便可在工作流程文件中使用和读取加密密码。 更多信息请参阅“[{% data variables.product.prodname_dotcom %} 上的访问权限](/github/getting-started-with-github/access-permissions-on-github)”。 + +{% warning %} + +**警告：**{% data variables.product.prodname_dotcom %} 自动将密码编写到日志，但您应避免有意将密码打印到日志。 + +{% endwarning %} + +您还可以使用 REST API 管理密码。 更多信息请参阅“[密码](/v3/actions/secrets/)”。 + +#### 限制凭据权限 + +生成凭据时，建议尽可能授予最低的权限。 例如，不使用个人凭据，而使用[部署密钥](/v3/guides/managing-deploy-keys/#deploy-keys)或服务帐户。 请考虑授予只读权限（如果这是所需的全部权限）并尽可能限制访问。 生成个人访问令牌 (PAT) 时，选择所需的最小范围。 + +### 为仓库创建加密密码 + +{% data reusables.github-actions.permissions-statement-secrets-repository %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.github-actions.sidebar-secret %} +1. 单击 **Add a new secret（添加新机密）**。 +1. 在 **Name（名称）**输入框中键入密码的名称。 +1. 输入密码的值。 +1. 单击 **Add secret（添加密码）**。 + +如果您的仓库可以从父级组织访问密码，则此页上也会列出这些密码。 + +### 为组织创建加密密码 + +在组织中创建密码时，可以使用策略来限制可以访问该密码的仓库。 例如，您可以将访问权限授予所有仓库，也可以限制仅私有仓库或指定的仓库列表拥有访问权限。 + +{% data reusables.github-actions.permissions-statement-secrets-organization %} + +{% data reusables.organizations.navigate-to-org %} +{% data reusables.organizations.org_settings %} +{% data reusables.github-actions.sidebar-secret %} +1. 单击 **New secret（新建密码）**。 +1. 在 **Name（名称）**输入框中键入密码的名称。 +1. 输入密码的 **Value（值）**。 +1. 从 **Repository access（仓库访问权限）**下拉列表，选择访问策略。 +1. 单击 **Add secret（添加密码）**。 + +### 审查对组织级别密码的访问权限 + +您可以检查哪些访问策略正被应用于组织中的密码。 + +{% data reusables.organizations.navigate-to-org %} +{% data reusables.organizations.org_settings %} +{% data reusables.github-actions.sidebar-secret %} +1. 密码列表包括任何已配置的权限和策略。 例如： ![密码列表](/assets/images/help/settings/actions-org-secrets-list.png) +1. 有关已为每个密码配置的权限的更多信息，请单击 **Update（更新）**。 + +### 在工作流程中使用加密密码 + +除了 `GITHUB_TOKEN` 以外，从复刻的仓库触发工作流程时密码不会传递给运行程序。 + +要提供以密码作为输入或环境变量的操作，可以使用 `secrets` 上下文访问您在仓库中创建的密码。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的上下文和表达式语法](/actions/reference/context-and-expression-syntax-for-github-actions)”和“[{% data variables.product.prodname_actions %} 的工作流程语法](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)”。 + +{% raw %} +```yaml +steps: + - name: Hello world action + with: # Set the secret as an input + super_secret: ${{ secrets.SuperSecret }} + env: # Or as an environment variable + super_secret: ${{ secrets.SuperSecret }} +``` +{% endraw %} + +尽可能避免使用命令行在进程之间传递密码。 命令行进程可能对其他用户可见（使用 `ps` 命令）或通过[安全审计事件](https://docs.microsoft.com/en-us/windows-server/identity/ad-ds/manage/component-updates/command-line-process-auditing)获取。 为帮助保护密码，请考虑使用环境变量 `STDIN` 或目标进程支持的其他机制。 + +如果必须在命令行中传递密码，则将它们包含在适当的引用规则中。 密码通常包含可能意外影响 shell 的特殊字符。 要转义这些特殊字符，请引用环境变量。 例如： + +#### 使用 Bash 的示例 + +{% raw %} +```yaml +steps: + - shell: bash + env: + SUPER_SECRET: ${{ secrets.SuperSecret }} + run: | + example-command "$SUPER_SECRET" +``` +{% endraw %} + +#### 使用 PowerShell 的示例 + +{% raw %} +```yaml +steps: + - shell: pwsh + env: + SUPER_SECRET: ${{ secrets.SuperSecret }} + run: | + example-command "$env:SUPER_SECRET" +``` +{% endraw %} + +#### 使用 Cmd.exe 的示例 + +{% raw %} +```yaml +steps: + - shell: cmd + env: + SUPER_SECRET: ${{ secrets.SuperSecret }} + run: | + example-command "%SUPER_SECRET%" +``` +{% endraw %} + +### 密码的限制 + +您的工作流程最多可以有 100 个密码。 密码环境变量的名称在仓库中必须是唯一的。 + +密码大小限于 64 KB。 要使用大于 64 KB 的密码，可以将加密的密码存储在仓库中，并将解密短语在 {% data variables.product.prodname_dotcom %} 上存储为密码。 例如，在将文件检入您在 {% data variables.product.prodname_dotcom %} 上的仓库之前，可以使用 `gpg` 在本地对您的凭据加密。 更多信息请参阅“[gpg manpage](https://www.gnupg.org/gph/de/manual/r1023.html)”。 + +{% warning %} + +**警告**：请注意，您的密码在操作运行时不会印出。 使用此解决方法时，{% data variables.product.prodname_dotcom %} 不会编写日志中印出的密码。 + +{% endwarning %} + +1. 从终端运行以下命令，以使用 `gpg` 和 AES256 密码算法对 `my_secret.json` 文件加密。 + + ``` shell + $ gpg --symmetric --cipher-algo AES256 my_secret.json + ``` + +1. 将会提示您输入密码短语。 请记住该密码短语，因为需要在使用该密码短语作为值的 {% data variables.product.prodname_dotcom %} 上创建新密码。 + +1. 创建包含密码短语的新密码。 例如，使用名称 `LARGE_SECRET_PASSPHRASE` 创建新密码，并将密码的值设为上一步所选的密码短语。 + +1. 将加密的文件复制到仓库并提交。 在本例中，加密的文件是 `my_secret.json.gpg`。 + +1. 创建 shell 脚本对密码解密。 将此文件另存为 `decrypt_secret.sh`。 + + ``` shell + #!/bin/sh + + # 解密文件 + mkdir $HOME/secrets + # --批处理以防止交互式命令 + # --是以假定问题的回答是“是” + gpg --quiet --batch --yes --decrypt --passphrase="$LARGE_SECRET_PASSPHRASE" \ + --output $HOME/secrets/my_secret.json my_secret.json.gpg + ``` + +1. 确保 shell 脚本在检入仓库之前可执行。 + + ``` shell + $ chmod +x decrypt_secret.sh + $ git add decrypt_secret.sh + $ git commit -m "Add new decryption script" + $ git push + ``` + +1. 从工作流程使用 `step` 调用 shell 脚本并对密码解密。 要在工作流程运行的环境中创建仓库的副本，需要使用 [`actions/checkout`](https://github.com/actions/checkout) 操作。 使用与仓库根目录相关的 `run` 命令引用 shell 脚本。 + +{% raw %} + ```yaml + name: Workflows with large secrets + + on: push + + jobs: + my-job: + name: My Job + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Decrypt large secret + run: ./.github/scripts/decrypt_secret.sh + env: + LARGE_SECRET_PASSPHRASE: ${{ secrets.LARGE_SECRET_PASSPHRASE }} + # This command is just an example to show your secret being printed + # Ensure you remove any print statements of your secrets. GitHub does + # not hide secrets that use this workaround. + - name: Test printing your secret (Remove this step in production) + run: cat $HOME/secrets/my_secret.json + ``` +{% endraw %} diff --git a/translations/zh-CN/content/actions/reference/environment-variables.md b/translations/zh-CN/content/actions/reference/environment-variables.md new file mode 100644 index 000000000000..f941afac1f03 --- /dev/null +++ b/translations/zh-CN/content/actions/reference/environment-variables.md @@ -0,0 +1,69 @@ +--- +title: 环境变量 +intro: '{% data variables.product.prodname_dotcom %} 为每个 {% data variables.product.prodname_actions %} 工作流程运行设置默认环境变量。 您也可以在工作流程文件中设置自定义环境变量。' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /github/automating-your-workflow-with-github-actions/using-environment-variables + - /actions/automating-your-workflow-with-github-actions/using-environment-variables + - /actions/configuring-and-managing-workflows/using-environment-variables +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### 关于环境变量 + +{% data variables.product.prodname_dotcom %} 设置适用于工作流程运行中每个步骤的默认环境变量。 环境变量区分大小写。 在操作或步骤中运行的命令可以创建、读取和修改环境变量。 + +要设置自定义环境变量，您需要在工作流程文件中指定变量。 您可以使用 [`jobs..steps.env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv)、[`jobs..env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idenv) 和 [`env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env) 关键字定义步骤、作业或整个工作流程的环境变量。 更多信息请参阅“[{% data variables.product.prodname_dotcom %} 的工作流程语法](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)”。 + +```yaml +steps: + - name: Hello world + run: echo Hello world $FIRST_NAME $middle_name $Last_Name! + env: + FIRST_NAME: Mona + middle_name: The + Last_Name: Octocat +``` + +You can also use the {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}`GITHUB_ENV` environment file{% else %} `set-env` workflow command{% endif %} to set an environment variable that the following steps in a workflow can use. The {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}environment file{% else %} `set-env` command{% endif %} can be used directly by an action or as a shell command in a workflow file using the `run` keyword. 更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程命令](/actions/reference/workflow-commands-for-github-actions/#setting-an-environment-variable)”。 + +### 默认环境变量 + +强烈建议操作使用环境变量访问文件系统，而非使用硬编码的文件路径。 {% data variables.product.prodname_dotcom %} 设置供操作用于所有运行器环境中的环境变量。 + +| 环境变量 | 描述 | +| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `CI` | 始终设置为 `true`。 | +| `HOME` | 用于存储用户数据的 {% data variables.product.prodname_dotcom %} 主目录路径。 例如 `/github/home`。 | +| `GITHUB_WORKFLOW` | 工作流程的名称。 | +| `GITHUB_RUN_ID` | {% data reusables.github-actions.run_id_description %} +| `GITHUB_RUN_NUMBER` | {% data reusables.github-actions.run_number_description %} +| `GITHUB_ACTION` | 操作唯一的标识符 (`id`)。 | +| `GITHUB_ACTIONS` | 当 {% data variables.product.prodname_actions %} 运行工作流程时，始终设置为 `true`。 您可以使用此变量来区分测试是在本地运行还是通过 {% data variables.product.prodname_actions %} 运行。 | +| `GITHUB_ACTOR` | 发起工作流程的个人或应用程序的名称。 例如 `octocat`。 | +| `GITHUB_REPOSITORY` | 所有者和仓库名称。 例如 `octocat/Hello-World`。 | +| `GITHUB_EVENT_NAME` | 触发工作流程的 web 挂钩事件的名称。 | +| `GITHUB_EVENT_PATH` | 具有完整 web 挂钩事件有效负载的文件路径。 例如 `/github/workflow/event.json`。 | +| `GITHUB_WORKSPACE` | {% data variables.product.prodname_dotcom %} 工作空间目录路径。 The workspace directory is a copy of your repository if your workflow uses the [actions/checkout](https://github.com/actions/checkout) action. 如果不使用 `actions/checkout` 操作，该目录将为空。 例如 `/home/runner/work/my-repo-name/my-repo-name`。 | +| `GITHUB_SHA` | 触发工作流程的提交 SHA。 例如 `ffac537e6cbbf934b08745a378932722df287a53`。 | +| `GITHUB_REF` | 触发工作流程的分支或标记参考。 例如 `refs/heads/feature-branch-1`。 如果分支或标记都不适用于事件类型，则变量不会存在。 | +| `GITHUB_HEAD_REF` | 仅为复刻的仓库设置。 头部仓库的分支。 | +| `GITHUB_BASE_REF` | 仅为复刻的仓库设置。 基础仓库的分支。 | +| `GITHUB_SERVER_URL` | 返回 {% data variables.product.product_name %} 服务器的 URL。 当 {% data variables.product.prodname_actions %} 运行工作流程时，始终设置为 `true`。 | +| `GITHUB_API_URL` | 返回 API URL。 返回 {% data variables.product.product_name %} 服务器的 URL。 例如：`https://github.com`。 | +| `GITHUB_GRAPHQL_URL` | 返回 GraphQL API URL。 例如：`https://api.github.com/graphql`。 | + +### 环境变量命名约定 + +{% note %} + +**注：** {% data variables.product.prodname_dotcom %} 会保留 `GITHUB_` 环境变量前缀供 {% data variables.product.prodname_dotcom %} 内部使用。 设置有 `GITHUB_` 前缀的环境变量或密码将导致错误。 + +{% endnote %} + +您设置的指向文件系统上某个位置的任何新环境变量都应该有 `_PATH` 后缀。 `HOME` 和 `GITHUB_WORKSPACE` 默认变量例外于此约定，因为 "home" 和 "workspace" 一词已经暗示位置。 diff --git a/translations/zh-CN/content/actions/reference/events-that-trigger-workflows.md b/translations/zh-CN/content/actions/reference/events-that-trigger-workflows.md index ca560e5f6a18..11694798124d 100644 --- a/translations/zh-CN/content/actions/reference/events-that-trigger-workflows.md +++ b/translations/zh-CN/content/actions/reference/events-that-trigger-workflows.md @@ -15,31 +15,142 @@ versions: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -### 关于工作流程事件 +### 配置工作流程事件 -您可以配置工作流程在 web 挂钩事件从 {% data variables.product.product_name %} 上的活动创建时运行。 工作流程可以使用多个 web 挂钩事件来触发工作流程运行。 更多信息请参阅“[web 挂钩](/webhooks)”。 有关 `on` 语法的更多信息，请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/articles/workflow-syntax-for-github-actions#on)”。 +您可以使用 `on` 工作流程语法配置工作流程为一个或多个事件运行。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/articles/workflow-syntax-for-github-actions#on)”。 + +{% data reusables.github-actions.actions-on-examples %} + +{% note %} + +**注意：**无法使用 `GITHUB_TOKEN` 触发新的工作流程。 更多信息请参阅“[使用个人访问令牌触发新的工作流程](#triggering-new-workflows-using-a-personal-access-token)”。 + +{% endnote %} 以下步骤将触发工作流程运行： -1. 仓库中发生事件，生成的事件 web 挂钩具有关联的提交 SHA 和 Git ref。 -1. 在仓库的 `.github/workflow` 目录中关联的提交 SHA 或 Git ref 处搜索工作流程文件。 工作流程文件必须存在于该提交 SHA 或 Git ref 中才会被考虑。 +1. 仓库中发生事件，生成的事件具有关联的提交 SHA 和 Git ref。 +2. 在仓库的 `.github/workflow` 目录中关联的提交 SHA 或 Git ref 处搜索工作流程文件。 工作流程文件必须存在于该提交 SHA 或 Git ref 中才会被考虑。 例如，如果事件发生在特定仓库分支上，则工作流程文件必须存在于该分支的仓库中。 1. 检查该提交 SHA 和 Git ref 的工作流程文件， 并且对其 `on:` 值与触发事件匹配的任何工作流程触发新的工作流程。 工作流程在触发事件的相同提交 SHA 和 Git ref 上的仓库代码中运行。 当工作流程运行时，{% data variables.product.product_name %} 会在运行器环境中设置 `GITHUB_SHA`（提交 SHA）和 `GITHUB_REF`（Git 引用）环境变量。 更多信息请参阅“[使用环境变量](/actions/automating-your-workflow-with-github-actions/using-environment-variables)”。 +### 安排的事件 + +`schedule` 事件允许您在计划的时间触发工作流程。 + +#### `计划` + +| Web 挂钩事件有效负载 | 活动类型 | `GITHUB_SHA` | `GITHUB_REF` | +| ------------ | ---- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| n/a | n/a | 默认分支上的最新提交 | 默认分支 | 安排的工作流程设置为运行。 预定的工作流程使用 [POSIX 计划任务语法](https://pubs.opengroup.org/onlinepubs/9699919799/utilities/crontab.html#tag_20_25_07)。 更多信息请参阅“[通过事件触发工作流程](/articles/configuring-a-workflow/#triggering-a-workflow-with-events)”。 | + +{% data reusables.repositories.actions-scheduled-workflow-example %} + +计划任务语法有五个字段，中间用空格分隔，每个字段代表一个时间单位。 + +``` +┌───────────── minute (0 - 59) +│ ┌───────────── hour (0 - 23) +│ │ ┌───────────── day of the month (1 - 31) +│ │ │ ┌───────────── month (1 - 12 or JAN-DEC) +│ │ │ │ ┌───────────── day of the week (0 - 6 or SUN-SAT) +│ │ │ │ │ +│ │ │ │ │ +│ │ │ │ │ +* * * * * +``` + +您可在这五个字段中使用以下运算符： + +| 运算符 | 描述 | 示例 | +| --- | ------ | ------------------------------------------------------------ | +| * | 任意值 | `* * * * *` 在每天的每分钟运行。 | +| , | 值列表分隔符 | `2,10 4,5 * * *` 在每天第 4 和第 5 小时的第 2 和第 10 分钟运行。 | +| - | 值的范围 | `0 4-6 * * *` 在第 4、5、6 小时的第 0 分钟运行。 | +| / | 步骤值 | `20/15 * * * *` 从第 20 分钟到第 59 分钟每隔 15 分钟运行（第 20、35 和 50 分钟）。 | + {% note %} -**注意：**无法使用 `GITHUB_TOKEN` 触发新的工作流程。 更多信息请参阅“[使用个人访问令牌触发新的工作流程](#triggering-new-workflows-using-a-personal-access-token)”。 +**注：** {% data variables.product.prodname_actions %} 不支持非标准语法 `@yearly`、`@monthly`、`@weekly`、`@daily`、`@hourly` 和 `@reboot`。 {% endnote %} -{% data reusables.github-actions.actions-on-examples %} +您可以使用 [crontab guru](https://crontab.guru/) 帮助生成计划任务语法并确认它在何时运行。 为帮助您开始，我们还提供了一系列 [crontab guru 示例](https://crontab.guru/examples.html)。 + +### 手动事件 + +您可以手动触发工作流程运行。 要触发仓库中的特定工作流程，请使用 `workflow_dispatch` 事件。 要触发仓库中的多个工作流程并创建自定义事件和事件类型，请使用 `repository_dispatch` 事件。 + +#### `workflow_dispatch` + +| Web 挂钩事件有效负载 | 活动类型 | `GITHUB_SHA` | `GITHUB_REF` | +| ---------------------------------------------------------------- | ---- | --------------------- | ------------ | +| [workflow_dispatch](/webhooks/event-payloads/#workflow_dispatch) | n/a | `GITHUB_REF` 分支上的最新提交 | 收到了分发的分支 | + +您可以直接在工作流程中配置事件的自定义输入属性、默认输入值和必要输入。 当工作流程运行时，您可以访问 `github.event.inputs` 上下文中的输入值。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的上下文和表达式语法](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)”。 + +您可以使用 {% data variables.product.product_name %} API 以及从 {% data variables.product.product_name %} 手动触发工作流程运行。 更多信息请参阅“[手动配置工作流程](/actions/managing-workflow-runs/manually-running-a-workflow)。 + + 当您在 {% data variables.product.prodname_dotcom %} 上触发事件时，可以在 {% data variables.product.prodname_dotcom %} 上直接提供 `ref` 和任何 `inputs`。 更多信息请参阅“[对操作使用输入和输出](/actions/learn-github-actions/finding-and-customizing-actions#using-inputs-and-outputs-with-an-action)”。 + + 要使用 REST API 触发自定义 `workflow_dispatch` web 挂钩事件，您必须发送 `POST` 请求到 {% data variables.product.prodname_dotcom %} API 端点，并提供 `ref` 和任何必要的 `inputs`。 更多信息请参阅“[创建工作流程调度事件](/rest/reference/actions/#create-a-workflow-dispatch-event)”REST API 端点。 + +##### 示例工作流程配置 + +此示例定义了 `name` 和 `home` 输入，并使用 `github.event.inputs.name` 和 `github.event.inputs.home` 上下文打印。 如果未提供 `name` ，则打印默认值“Mona the Octocat”。 + +{% raw %} +```yaml +name: Manually triggered workflow +on: + workflow_dispatch: + inputs: + name: + description: 'Person to greet' + required: true + default: 'Mona the Octocat' + home: + description: 'location' + required: false + +jobs: + say_hello: + runs-on: ubuntu-latest + steps: + - run: | + echo "Hello ${{ github.event.inputs.name }}!" + echo "- in ${{ github.event.inputs.home }}!" +``` +{% endraw %} + +#### `repository_dispatch` + +| Web 挂钩事件有效负载 | 活动类型 | `GITHUB_SHA` | `GITHUB_REF` | +| -------------------------------------------------------------------- | ---- | --------------------- | ------------ | +| [repository_dispatch](/webhooks/event-payloads/#repository_dispatch) | n/a | `GITHUB_REF` 分支上的最新提交 | 收到了分发的分支 | + +{% data reusables.github-actions.branch-requirement %} + +当您想要触发在 {% data variables.product.product_name %} 外发生的活动的工作流程时，可以使用 {% data variables.product.prodname_dotcom %} API 触发名为 [`repository_dispatch`](/webhooks/event-payloads/#repository_dispatch) 的 web 挂钩事件。 更多信息请参阅“[创建仓库调度事件](/v3/repos/#create-a-repository-dispatch-event)”。 + +要触发自定义 `repository_dispatch` web 挂钩事件，必须将 `POST` 请求发送到 {% data variables.product.product_name %} API 端点，并提供 `event_type` 名称来描述活动类型。 要触发工作流程运行，还必须配置工作流程使用 `repository_dispatch` 事件。 + +##### 示例 + +默认情况下，所有 `event_types` 都会触发工作流程运行。 您可以限制工作流程在 `repository_dispatch` web 挂钩有效负载中发送特定 `event_type` 值时运行。 创建仓库调度事件时定义在 `repository_dispatch` 有效负载中发送的事件类型。 + +```yaml +on: + repository_dispatch: + types: [opened, deleted] +``` ### Web 挂钩事件 -您可以将工作流程配置为在 GitHub 上创建 web 挂钩事件时运行。 某些事件有多种触发事件的活动类型。 如果有多种活动类型触发事件，则可以指定哪些活动类型将触发工作流程运行。 +您可以将工作流程配置为在 GitHub 上创建 web 挂钩事件时运行。 某些事件有多种触发事件的活动类型。 如果有多种活动类型触发事件，则可以指定哪些活动类型将触发工作流程运行。 更多信息请参阅“[web 挂钩](/webhooks)”。 #### `check_run` @@ -121,7 +232,7 @@ on: #### `deployment` -每当有人创建部署（触发 `deployment` 事件）时运行您的工作流程。 使用提交 SHA 创建的部署可能没有 Git 引用。 有关 REST API 的信息，请参阅“[部署](/v3/repos/deployments/)”。 +每当有人创建部署（触发 `deployment` 事件）时运行您的工作流程。 使用提交 SHA 创建的部署可能没有 Git 引用。 有关 REST API 的信息，请参阅“[部署](/rest/reference/repos#deployments)”。 | Web 挂钩事件有效负载 | 活动类型 | `GITHUB_SHA` | `GITHUB_REF` | | ---------------------------------------------------- | ---- | ------------ | ---------------- | @@ -136,7 +247,7 @@ on: #### `deployment_status` -每当第三方提供部署状态（触发 `deployment_status` 事件）时运行您的工作流程。 使用提交 SHA 创建的部署可能没有 Git 引用。 有关 REST API 的信息，请参阅“[创建部署状态](/v3/repos/deployments/#create-a-deployment-status)”。 +每当第三方提供部署状态（触发 `deployment_status` 事件）时运行您的工作流程。 使用提交 SHA 创建的部署可能没有 Git 引用。 有关 REST API 的信息，请参阅“[创建部署状态](/rest/reference/repos#create-a-deployment-status)”。 | Web 挂钩事件有效负载 | 活动类型 | `GITHUB_SHA` | `GITHUB_REF` | | ------------------------------------------------------------------ | ---- | ------------ | ---------------- | @@ -185,13 +296,13 @@ on: #### `issue_comment` -在发生 `issue_comment` 事件的任何时间运行您的工作流程。 {% data reusables.developer-site.multiple_activity_types %}有关 REST API 的信息，请参阅“[议题评论](/v3/issues/comments/)”。 +在发生 `issue_comment` 事件的任何时间运行您的工作流程。 {% data reusables.developer-site.multiple_activity_types %}有关 REST API 的信息，请参阅“[议题评论](/developers/webhooks-and-events/webhook-events-and-payloads#issue_comment)”。 {% data reusables.github-actions.branch-requirement %} -| Web 挂钩事件有效负载 | 活动类型 | `GITHUB_SHA` | `GITHUB_REF` | -| ---------------------------------------------------------- | ----------------------------------------------------------------- | ------------ | ------------ | -| [`issue_comment`](/v3/activity/event_types/#issue_comment) | - `created`
    - `edited`
    - `deleted`
    | 默认分支上的最新提交 | 默认分支 | +| Web 挂钩事件有效负载 | 活动类型 | `GITHUB_SHA` | `GITHUB_REF` | +| --------------------------------------------------------- | ----------------------------------------------------------------- | ------------ | ------------ | +| [`issue_comment`](/rest/reference/activity#issue_comment) | - `created`
    - `edited`
    - `deleted`
    | 默认分支上的最新提交 | 默认分支 | {% data reusables.developer-site.limit_workflow_to_activity_types %} @@ -265,7 +376,7 @@ on: #### `page_build` -在有人推送到启用 {% data variables.product.product_name %} Pages 的分支（触发 `page_build` 事件）的任何时间运行您的工作流程。 有关 REST API 的信息，请参阅“[页面](/v3/repos/pages/)”。 +在有人推送到启用 {% data variables.product.product_name %} Pages 的分支（触发 `page_build` 事件）的任何时间运行您的工作流程。 有关 REST API 的信息，请参阅“[页面](/rest/reference/repos#pages)”。 {% data reusables.github-actions.branch-requirement %} @@ -489,9 +600,9 @@ on: 在发生 `release` 事件的任何时间运行您的工作流程。 {% data reusables.developer-site.multiple_activity_types %}有关 REST API 的信息，请参阅“[发行版](/v3/repos/releases/)”。 -| Web 挂钩事件有效负载 | 活动类型 | `GITHUB_SHA` | `GITHUB_REF` | -| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | ------------ | -| [`发行版`](/webhooks/event-payloads/#release) | - `published`{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}
    - `unpublished`
    - `created`
    - `edited`
    - `deleted`
    - `prereleased`
    - `released`{% endif %} | 标记的发行版中的最新提交 | 发行版标记 | +| Web 挂钩事件有效负载 | 活动类型 | `GITHUB_SHA` | `GITHUB_REF` | +| ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | ------------ | +| [`发行版`](/webhooks/event-payloads/#release) | - `published`
    - `unpublished`
    - `created`
    - `edited`
    - `deleted`
    - `prereleased`
    - `released` | 标记的发行版中的最新提交 | 发行版标记 | {% data reusables.developer-site.limit_workflow_to_activity_types %} @@ -558,85 +669,6 @@ on: - requested ``` -### 安排的事件 - -`schedule` 事件允许您在计划的时间触发工作流程。 - -#### `schedule` - -| Web 挂钩事件有效负载 | 活动类型 | `GITHUB_SHA` | `GITHUB_REF` | -| ------------ | ---- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| n/a | n/a | 默认分支上的最新提交 | 默认分支 | 安排的工作流程设置为运行。 预定的工作流程使用 [POSIX 计划任务语法](https://pubs.opengroup.org/onlinepubs/9699919799/utilities/crontab.html#tag_20_25_07)。 更多信息请参阅“[通过事件触发工作流程](/articles/configuring-a-workflow/#triggering-a-workflow-with-events)”。 | - -{% data reusables.repositories.actions-scheduled-workflow-example %} - -计划任务语法有五个字段，中间用空格分隔，每个字段代表一个时间单位。 - -``` -┌───────────── minute (0 - 59) -│ ┌───────────── hour (0 - 23) -│ │ ┌───────────── day of the month (1 - 31) -│ │ │ ┌───────────── month (1 - 12 or JAN-DEC) -│ │ │ │ ┌───────────── day of the week (0 - 6 or SUN-SAT) -│ │ │ │ │ -│ │ │ │ │ -│ │ │ │ │ -* * * * * -``` - -您可在这五个字段中使用以下运算符： - -| 运算符 | 描述 | 示例 | -| --- | ------ | ------------------------------------------------------------ | -| * | 任意值 | `* * * * *` 在每天的每分钟运行。 | -| , | 值列表分隔符 | `2,10 4,5 * * *` 在每天第 4 和第 5 小时的第 2 和第 10 分钟运行。 | -| - | 值的范围 | `0 4-6 * * *` 在第 4、5、6 小时的第 0 分钟运行。 | -| / | 步骤值 | `20/15 * * * *` 从第 20 分钟到第 59 分钟每隔 15 分钟运行（第 20、35 和 50 分钟）。 | - -{% note %} - -**注：** {% data variables.product.prodname_actions %} 不支持非标准语法 `@yearly`、`@monthly`、`@weekly`、`@daily`、`@hourly` 和 `@reboot`。 - -{% endnote %} - -您可以使用 [crontab guru](https://crontab.guru/) 帮助生成计划任务语法并确认它在何时运行。 为帮助您开始，我们还提供了一系列 [crontab guru 示例](https://crontab.guru/examples.html)。 - -### 手动事件 - -您可以手动触发工作流程运行。 要触发仓库中的特定工作流程，请使用 `workflow_dispatch` 事件。 要触发仓库中的多个工作流程并创建自定义事件和事件类型，请使用 `repository_dispatch` 事件。 - -#### `workflow_dispatch` - -| Web 挂钩事件有效负载 | 活动类型 | `GITHUB_SHA` | `GITHUB_REF` | -| ---------------------------------------------------------------- | ---- | --------------------- | ------------ | -| [workflow_dispatch](/webhooks/event-payloads/#workflow_dispatch) | n/a | `GITHUB_REF` 分支上的最新提交 | 收到了分发的分支 | - -您可以使用 {% data variables.product.product_name %} API 以及从 {% data variables.product.product_name %} 手动触发工作流程运行。 要使用 REST API 触发自定义 `workflow_dispatch` web 挂钩事件，您必须发送 `POST` 请求到 {% data variables.product.prodname_dotcom %} API 端点，并提供 `ref` 和任何必要的 `inputs`。 更多信息请参阅“[创建工作流程调度事件](/rest/reference/actions/#create-a-workflow-dispatch-event)”REST API 端点。 - - 当您在 {% data variables.product.prodname_dotcom %} 上触发事件时，可以在 {% data variables.product.prodname_dotcom %} 上直接提供 `ref` 和任何 `inputs`。 更多信息请参阅“[配置工作流程](/actions/configuring-and-managing-workflows/configuring-a-workflow#manually-running-a-workflow)。 - -#### `repository_dispatch` - -| Web 挂钩事件有效负载 | 活动类型 | `GITHUB_SHA` | `GITHUB_REF` | -| -------------------------------------------------------------------- | ---- | --------------------- | ------------ | -| [repository_dispatch](/webhooks/event-payloads/#repository_dispatch) | n/a | `GITHUB_REF` 分支上的最新提交 | 收到了分发的分支 | - -{% data reusables.github-actions.branch-requirement %} - -当您想要触发在 {% data variables.product.product_name %} 外发生的活动的工作流程时，可以使用 {% data variables.product.prodname_dotcom %} API 触发名为 [`repository_dispatch`](/webhooks/event-payloads/#repository_dispatch) 的 web 挂钩事件。 有关详细信息，请参阅"[创建存储库调度事件](/v3/repos/#create-a-repository-dispatch-event)。 - -要触发自定义 `repository_dispatch` web 挂钩事件，必须将 `POST` 请求发送到 {% data variables.product.product_name %} API 端点，并提供 `event_type` 名称来描述活动类型。 要触发工作流程运行，还必须配置工作流程使用 `repository_dispatch` 事件。 - -##### 示例 - -默认情况下，所有 `event_types` 都会触发工作流程运行。 您可以限制工作流程在 `repository_dispatch` web 挂钩有效负载中发送特定 `event_type` 值时运行。 创建仓库调度事件时定义在 `repository_dispatch` 有效负载中发送的事件类型。 - -```yaml -on: - repository_dispatch: - types: [opened, deleted] -``` - ### 使用个人访问令牌触发新工作流程 {% data reusables.github-actions.actions-do-not-trigger-workflows %} 更多信息请参阅“[使用 GITHUB_TOKEN 验证身份](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)”。 diff --git a/translations/zh-CN/content/actions/reference/index.md b/translations/zh-CN/content/actions/reference/index.md index 8a1b503e9357..e4ff8519bfcf 100644 --- a/translations/zh-CN/content/actions/reference/index.md +++ b/translations/zh-CN/content/actions/reference/index.md @@ -1,6 +1,8 @@ --- title: 参考 -intro: '用于构建操作、创建工作流程和其他工具以及 {% data variables.product.prodname_actions %} 相关信息的参考文档。' +intro: '使用 GitHub 托管的运行器和身份验证创建工作流程的参考文档。' +redirect_from: + - /actions/configuring-and-managing-workflows/using-variables-and-secrets-in-a-workflow versions: free-pro-team: '*' enterprise-server: '>=2.22' @@ -9,9 +11,39 @@ versions: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} +### 工作流程语法 + +工作流程文件以 YAML 编写。 在 YAML 工作流程文件中，您可以使用表达式语法来评估上下文信息、文字、运算符和函数。 上下文信息包括工作流程、环境变量、密码和触发工作流程的事件。 当您在工作流程步骤中使用 [`run`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun) 运行 shell 命令时，您可以使用特定的工作流程命令语法来设置环境变量、设置后续步骤的输出参数，以及设置错误或调试信息。 + {% link_in_list /workflow-syntax-for-github-actions %} -{% link_in_list /events-that-trigger-workflows %} {% link_in_list /context-and-expression-syntax-for-github-actions %} {% link_in_list /workflow-commands-for-github-actions %} -{% link_in_list /virtual-environments-for-github-hosted-runners %} -{% link_in_list /software-installed-on-github-hosted-runners %} + +### 事件 + +您可以配置工作流和在发生特定 GitHub 事件时运行、在计划的时间运行、手动运行、手动或者当 GitHub 外部事件发生时运行。 + +{% link_in_list /events-that-trigger-workflows %} + +### 身份验证和密码 + +{% data variables.product.prodname_dotcom %} 提供一个令牌，可用于代表 {% data variables.product.prodname_actions %} 进行身份验证。 您还可以将敏感信息作为密码存储在组织或仓库中。 {% data variables.product.prodname_dotcom %} 对所有密码加密。 + +{% link_in_list /authentication-in-a-workflow %} +{% link_in_list /encrypted-secrets %} + +### {% data variables.product.prodname_dotcom %} 托管的运行器 + +GitHub 提供托管的虚拟机器来运行工作流程。 虚拟机包含一个环境，其中包含供 GitHub Actions 使用的工具、软件包和环境变量。 + +{% link_in_list /environment-variables %} +{% link_in_list /specifications-for-github-hosted-runners %} + +{% if currentVersion == "free-pro-team@latest" %} +### 管理 + +在 {% data variables.product.prodname_dotcom %} 托管的运行器上运行工作流程时，存在使用限制和潜在的使用费用。 您也可以禁用或限制 {% data variables.product.prodname_actions %} 在仓库和组织中的使用。 + +{% link_in_list /usage-limits-billing-and-administration %} + +{% endif %} diff --git a/translations/zh-CN/content/actions/reference/specifications-for-github-hosted-runners.md b/translations/zh-CN/content/actions/reference/specifications-for-github-hosted-runners.md new file mode 100644 index 000000000000..debaf3b891c5 --- /dev/null +++ b/translations/zh-CN/content/actions/reference/specifications-for-github-hosted-runners.md @@ -0,0 +1,149 @@ +--- +title: Specifications for GitHub-hosted runners +intro: '{% data variables.product.prodname_dotcom %} 提供托管的虚拟机来运行工作流程。 虚拟机包含可供 {% data variables.product.prodname_actions %} 使用的工具、包和设置。' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /articles/virtual-environments-for-github-actions + - /github/automating-your-workflow-with-github-actions/virtual-environments-for-github-actions + - /github/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners + - /actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners + - /actions/reference/virtual-environments-for-github-hosted-runners + - /actions/reference/software-installed-on-github-hosted-runners +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### 关于 {% data variables.product.prodname_dotcom %} 托管的运行器 + +{% data variables.product.prodname_dotcom %} 托管的运行器是由安装了 {% data variables.product.prodname_actions %} 运行器应用程序的 {% data variables.product.prodname_dotcom %} 托管的虚拟机。 {% data variables.product.prodname_dotcom %} 提供使用 Linux、Windows 和 macOS 操作系统的运行器。 + +使用 {% data variables.product.prodname_dotcom %} 托管的运行器时，设备维护和升级由您负责。 您可以直接在虚拟机上或 Docker 容器中运行工作流程。 + +可以为工作流程中的每项作业指定运行器类型。 工作流程中的每项作业都在全新的虚拟机实例中执行。 作业中的所有步骤在同一虚拟机实例中执行，让该作业中的操作使用文件系统共享信息。 + +{% data reusables.github-actions.runner-app-open-source %} + +#### {% data variables.product.prodname_dotcom %} 托管的运行器的云主机 + +{% data variables.product.prodname_dotcom %} 在 Microsoft Azure 中安装了 {% data variables.product.prodname_actions %} 运行器应用程序的 Standard_DS2_v2 虚拟机上托管 Linux 和 Windows 运行器。 {% data variables.product.prodname_dotcom %} 托管的运行器应用程序是 Azure Pipelines Agent 的复刻。 入站 ICMP 数据包被阻止用于所有 Azure 虚拟机，因此 ping 或 traceroute 命令可能无效。 有关 Standard_DS2_v2 机器资源的更多信息，请参阅 Microsoft Azure 文档中的“[Dv2 和 DSv2 系列](https://docs.microsoft.com/en-us/azure/virtual-machines/dv2-dsv2-series#dsv2-series)”。 + +{% data variables.product.prodname_dotcom %} 使用 [MacStadium](https://www.macstadium.com/) 托管 macOS 运行器。 + +#### {% data variables.product.prodname_dotcom %} 托管的运行器的管理权限 + +Linux 和 macOS 虚拟机都使用无密码的 `sudo` 运行。 在需要比当前用户更多的权限才能执行命令或安装工具时，您可以使用无需提供密码的 `sudo`。 更多信息请参阅“[Sudo 手册](https://www.sudo.ws/man/1.8.27/sudo.man.html)”。 + +Windows 虚拟机配置为以禁用了用户帐户控制 (UAC) 的管理员身份运行。 更多信息请参阅 Windows 文档中的“[用户帐户控制工作原理](https://docs.microsoft.com/en-us/windows/security/identity-protection/user-account-control/how-user-account-control-works)”。 + +### 支持的运行器和硬件资源 + +每台虚拟机都有相同的硬件资源。 + +- 2 核 CPU +- 7 GB RAM 内存 +- 14 GB SSD 硬盘空间 + +{% data reusables.github-actions.supported-github-runners %} + +{% data reusables.github-actions.ubuntu-runner-preview %} + +Workflow logs list the runner used to run a job. For more information, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)." + +### Supported software + +The software tools included in {% data variables.product.prodname_dotcom %}-hosted runners are updated weekly. 有关每个运行器操作系统包含的工具最新列表，请参阅以下链接： + +* [Ubuntu 20.04 LTS](https://github.com/actions/virtual-environments/blob/main/images/linux/Ubuntu2004-README.md) +* [Ubuntu 18.04 LTS](https://github.com/actions/virtual-environments/blob/main/images/linux/Ubuntu1804-README.md) +* [Ubuntu 16.04 LTS](https://github.com/actions/virtual-environments/blob/main/images/linux/Ubuntu1604-README.md) +* [Windows Server 2019](https://github.com/actions/virtual-environments/blob/main/images/win/Windows2019-Readme.md) +* [Windows Server 2016](https://github.com/actions/virtual-environments/blob/main/images/win/Windows2016-Readme.md) +* [MacOS 10.15](https://github.com/actions/virtual-environments/blob/main/images/macos/macos-10.15-Readme.md) + +{% data reusables.github-actions.ubuntu-runner-preview %} + +{% data variables.product.prodname_dotcom %} 托管的运行器除了上述参考中列出的包之外，还包括操作系统的默认内置工具。 例如，Ubuntu 和 macOS 运行器除了其他默认工具之外，还包括 `grep`、`find` 和 `which`。 + +Workflow logs include a link to the preinstalled tools on the runner. For more information, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)." + +如果有您想要请求的工具，请在 [actions/virtual-environments](https://github.com/actions/virtual-environments) 打开一个议题。 + +### IP addresses + +{% note %} + +**注意：**如果使用 {% data variables.product.prodname_dotcom %} 组织或企业帐户的 IP 地址允许列表，则无法使用 {% data variables.product.prodname_dotcom %} 托管的运行器，而必须使用自托管的运行器。 更多信息请参阅“[关于自托管运行器](/actions/hosting-your-own-runners/about-self-hosted-runners)”。 + +{% endnote %} + +Windows 和 Ubuntu 运行程序托管在 Azure 中，具有与 Azure 数据中心相同的 IP 地址范围。 目前，所有 Windows 和 Ubuntu {% data variables.product.prodname_dotcom %} 托管的运行器都在以下 Azure 地区： + +- 美国东部 (`eastus`) +- 美国东部 2 (`eastus2`) +- 美国西部 2 (`westus2`) +- 美国中部 (`centralus`) +- 美国中南部 (`southcentralus`) + +Microsoft 每周通过 JSON 文件更新 Azure IP 地址范围，您可以从 [Azure IP 范围和服务标签 - 公共云](https://www.microsoft.com/en-us/download/details.aspx?id=56519)网站下载该文件。 如果需要一个允许列表来阻止未经授权访问您的内部资源，您可以使用此 IP 地址范围。 + +JSON 文件包含一个名为 `values` 的数组。 例如，在该数组内，您可以通过包含 `"AzureCloud.eastus2"` 的 `name` 和 `id` 的对象找到支持的 IP 地址。 + +您可以在 `"addressPrefixes"` 对象中找到支持的 IP 地址范围。 这是 JSON 文件的精简示例。 + +```json +{ + "changeNumber": 84, + "cloud": "Public", + "values": [ + { + "name": "AzureCloud.eastus2", + "id": "AzureCloud.eastus2", + "properties": { + "changeNumber": 33, + "region": "eastus2", + "platform": "Azure", + "systemService": "", + "addressPrefixes": [ + "13.68.0.0/17", + "13.77.64.0/18", + "13.104.147.0/25", + ... + ] + } + } + ] +} +``` + +### File systems + +{% data variables.product.prodname_dotcom %} 在虚拟机上的特定目录中执行操作和 shell 命令。 虚拟机上的文件路径不是静态的。 使用环境变量 {% data variables.product.prodname_dotcom %} 提供 `home`、`workspace` 和 `workflow` 目录的构建文件路径。 + +| 目录 | 环境变量 | 描述 | +| --------------------- | ------------------- | --------------------------------------------------------------------------------------------------------- | +| `home` | `HOME` | 包含用户相关的数据。 例如，此目录可能包含登录凭据。 | +| `workspace` | `GITHUB_WORKSPACE` | 在此目录中执行操作和 shell 命令。 操作可以修改此目录的内容，后续操作可以访问这些修改。 | +| `workflow/event.json` | `GITHUB_EVENT_PATH` | 触发工作流程的 web 挂钩事件的 `POST` 有效负载。 每当操作执行时，{% data variables.product.prodname_dotcom %} 都会重写此变量，以隔离操作之间的文件内容。 | + +有关 {% data variables.product.prodname_dotcom %} 为每个操作创建的环境变量列表，请参阅“[使用环境变量](/github/automating-your-workflow-with-github-actions/using-environment-variables)”。 + +#### Docker 容器文件系统 + +在 Docker 容器中运行的操作在 `/github` 路径下有静态目录。 但强烈建议使用默认环境变量在 Docker 容器中构建文件路径。 + +{% data variables.product.prodname_dotcom %} 保留 `/github` 路径前缀，并为操作创建三个目录。 + +- `/github/home` +- `/github/workspace` - {% data reusables.repositories.action-root-user-required %} +- `/github/workflow` + +{% if currentVersion == "free-pro-team@latest" %} + +### 延伸阅读 +- "[管理 {% data variables.product.prodname_actions %} 的计费](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)" + +{% endif %} diff --git a/translations/zh-CN/content/actions/reference/usage-limits-billing-and-administration.md b/translations/zh-CN/content/actions/reference/usage-limits-billing-and-administration.md new file mode 100644 index 000000000000..e319382a3bd9 --- /dev/null +++ b/translations/zh-CN/content/actions/reference/usage-limits-billing-and-administration.md @@ -0,0 +1,88 @@ +--- +title: 'Usage limits, billing, and administration' +intro: 'There are usage limits for {% data variables.product.prodname_actions %} workflows. Usage charges apply to repositories that go beyond the amount of free minutes and storage for a repository.' +product: '{% data reusables.gated-features.actions %}' +redirect_from: + - /actions/getting-started-with-github-actions/usage-and-billing-information-for-github-actions +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +### 关于 {% data variables.product.prodname_actions %} 的计费 + +{% if currentVersion == "free-pro-team@latest" %} +{% data reusables.github-actions.actions-billing %} 更多信息请参阅“[关于 {% data variables.product.prodname_actions %} 的计费](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions)”。 +{% else %} +GitHub Actions usage is free for +{% data variables.product.prodname_ghe_server %} that use self-hosted runners. +{% endif %} + +### 使用限制 + +{% if currentVersion == "free-pro-team@latest" %} +There are some limits on +{% data variables.product.prodname_actions %} usage when using {% data variables.product.prodname_dotcom %}-hosted runners. 这些限制可能会有变动。 + +{% note %} + +**Note:** For self-hosted runners, different usage limits apply. 更多信息请参阅“[关于自托管运行器](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)”。 + +{% endnote %} + +- **作业执行时间** - 工作流程中的每个作业最多可以运行 6 个小时。 如果作业达到此限制，该作业将会终止而无法完成。 +{% data reusables.github-actions.usage-workflow-run-time %} +{% data reusables.github-actions.usage-api-requests %} +- **并发作业** - 您的帐户中可并发运行的作业数量，具体取决于您的 GitHub 计划，如下表所示。 如果超出，任何额外的作业都会排队。 + + | GitHub 计划 | 同时运行的作业总数 | MacOS 作业同时运行的最大数量 | + | --------- | --------- | ----------------- | + | 免费 | 20 | 5 | + | Pro | 40 | 5 | + | 团队 | 60 | 5 | + | 企业 | 180 | 50 | +- **作业矩阵** - {% data reusables.github-actions.usage-matrix-limits %} +{% else %} +Usage limits apply to self-hosted runners. 更多信息请参阅“[关于自托管运行器](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)”。 +{% endif %} + +{% if currentVersion == "free-pro-team@latest" %} +### 使用策略 +In addition to the usage limits, you must ensure that you use + +{% data variables.product.prodname_actions %} within the [GitHub Terms of Service](/articles/github-terms-of-service/). 有关 {% data variables.product.prodname_actions %} 特定条款的更多信息，请参阅 [GitHub 附加产品条款](/github/site-policy/github-additional-product-terms#a-actions-usage)。 +{% endif %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +### 构件和日志保留策略 + +您可以为仓库、组织或企业帐户配置构件和日志保留期。 + +{% data reusables.actions.about-artifact-log-retention %} + +更多信息请参阅： + +- [为仓库中构件和日志的 {% data variables.product.prodname_actions %} 配置保留期](/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository) +- [为组织中构件和日志的 {% data variables.product.prodname_actions %} 配置保留期](/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization) +- [为企业中构件和日志的 {% data variables.product.prodname_actions %} 配置保留期](/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account) +{% endif %} + +### 禁用或限制仓库或组织的 {% data variables.product.prodname_actions %} + +{% data reusables.github-actions.disabling-github-actions %} + +更多信息请参阅： +- "[Disabling or limiting {% data variables.product.prodname_actions %} for a repository](/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository)" +- "[Disabling or limiting {% data variables.product.prodname_actions %} for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization)"{% if currentVersion == "free-pro-team@latest" %} +- "[Enforcing {% data variables.product.prodname_actions %} policies in your enterprise account](/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account)" for {% data variables.product.prodname_ghe_cloud %}{% endif %} + +### Disabling and enabling workflows + +You can enable and disable individual workflows in your repository on {% data variables.product.prodname_dotcom %}. + +{% data reusables.actions.scheduled-workflows-disabled %} + +For more information, see "[Disabling and enabling a workflow](/actions/managing-workflow-runs/disabling-and-enabling-a-workflow)." diff --git a/translations/zh-CN/content/actions/reference/workflow-commands-for-github-actions.md b/translations/zh-CN/content/actions/reference/workflow-commands-for-github-actions.md index dd09730e288e..009dd3e200d1 100644 --- a/translations/zh-CN/content/actions/reference/workflow-commands-for-github-actions.md +++ b/translations/zh-CN/content/actions/reference/workflow-commands-for-github-actions.md @@ -21,7 +21,11 @@ versions: 操作可以与运行器机器进行通信，以设置环境变量，其他操作使用的输出值，将调试消息添加到输出日志和其他任务。 +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +大多数工作流程命令使用特定格式的 `echo` 命令，而其他工作流程则通过写入文件被调用。 更多信息请参阅“[环境文件](#environment-files)”。 +{% else %} 工作流程命令使用特定格式的 `echo` 命令。 +{% endif %} ``` bash echo "::workflow-command parameter1={data},parameter2={data}::{command value}" @@ -41,40 +45,46 @@ echo "::workflow-command parameter1={data},parameter2={data}::{command value}" ### 使用工作流程命令访问工具包函数 -[actions/toolkit](https://github.com/actions/toolkit) 包括一些可以作为工作流程命令执行的功能。 使用 `::` 语法来运行您的 YAML 文件中的工作流程命令；然后，通过 `stdout` 将这些命令发送给运行器。 例如，不使用如下所示的代码来设置环境变量： +[actions/toolkit](https://github.com/actions/toolkit) 包括一些可以作为工作流程命令执行的功能。 使用 `::` 语法来运行您的 YAML 文件中的工作流程命令；然后，通过 `stdout` 将这些命令发送给运行器。 例如，不使用代码来设置环境变量，如下所示： ```javascript -core.exportVariable('SELECTED_COLOR', 'green'); +core.setOutput('SELECTED_COLOR', 'green'); ``` -您可以在工作流程中使用 `set-env` 命令来设置相同的值： +您可以在工作流程中使用 `set-output` 命令来设置相同的值： ``` yaml - name: Set selected color - run: echo '::set-env name=SELECTED_COLOR::green' + run: echo '::set-output name=SELECTED_COLOR::green' + id: random-color-generator - name: Get color - run: echo 'The selected color is' $SELECTED_COLOR + run: echo 'The selected color is' ${steps.random-color-generator.outputs.SELECTED_COLOR} ``` 下表显示了在工作流程中可用的工具包功能： -| 工具包函数 | 等效工作流程命令 | -| --------------------- | ----------------------------- | -| `core.addPath` | `add-path` | -| `core.debug` | `debug` | -| `core.error` | `error` | -| `core.endGroup` | `endgroup` | -| `core.exportVariable` | `set-env` | -| `core.getInput` | 可使用环境变量 `INPUT_{NAME}` 访问 | -| `core.getState` | 可使用环境变量 `STATE_{NAME}` 访问 | -| `core.isDebug` | 可使用环境变量 `RUNNER_DEBUG` 访问 | -| `core.saveState` | `save-state` | -| `core.setFailed` | 用作 `::error` 和 `exit 1` 的快捷方式 | -| `core.setOutput` | `set-output` | -| `core.setSecret` | `add-mask` | -| `core.startGroup` | `组` | -| `core.warning` | `warning file` | - +| 工具包函数 | 等效工作流程命令 | +| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- | +| `core.addPath` | | +| {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}可使用环境文件 `GITHUB_PATH`{% else %} `add-path` {% endif %}访问 | | +| | | +| `core.debug` | `debug` | +| `core.error` | `error` | +| `core.endGroup` | `endgroup` | +| `core.exportVariable` | | +| {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}可使用环境文件 `GITHUB_ENV`{% else %} `set-env` {% endif %} 访问 | | +| | | +| `core.getInput` | 可使用环境变量 `INPUT_{NAME}` 访问 | +| `core.getState` | 可使用环境变量 `STATE_{NAME}` 访问 | +| `core.isDebug` | 可使用环境变量 `RUNNER_DEBUG` 访问 | +| `core.saveState` | `save-state` | +| `core.setFailed` | 用作 `::error` 和 `exit 1` 的快捷方式 | +| `core.setOutput` | `set-output` | +| `core.setSecret` | `add-mask` | +| `core.startGroup` | `组` | +| `core.warning` | `warning file` | + +{% if currentVersion ver_lt "enterprise-server@2.23" %} ### 设置环境变量 `::set-env name={name}::{value}` @@ -86,6 +96,7 @@ core.exportVariable('SELECTED_COLOR', 'green'); ``` bash echo "::set-env name=action_state::yellow" ``` +{% endif %} ### 设置输出参数 @@ -101,6 +112,7 @@ echo "::set-env name=action_state::yellow" echo "::set-output name=action_fruit::strawberry" ``` +{% if currentVersion ver_lt "enterprise-server@2.23" %} ### 添加系统路径 `::add-path::{path}` @@ -112,12 +124,13 @@ echo "::set-output name=action_fruit::strawberry" ``` bash echo "::add-path::/path/to/dir" ``` +{% endif %} ### 设置调试消息 `::debug::{message}` -将调试消息打印到日志。 您可以创建名为 `ACTIONS_STEP_DEBUG`、值为 `true` 的密码，才能在日志中查看通过此命令设置的调试消息。 更多信息请参阅“[管理工作流程运行](/actions/configuring-and-managing-workflows/managing-a-workflow-run#enabling-debug-logging)”。 +将调试消息打印到日志。 您可以创建名为 `ACTIONS_STEP_DEBUG`、值为 `true` 的密码，才能在日志中查看通过此命令设置的调试消息。 更多信息请参阅“[启用调试日志记录](/actions/managing-workflow-runs/enabling-debug-logging)”。 #### 示例 @@ -141,7 +154,7 @@ echo "::warning file=app.js,line=1,col=5::Missing semicolon" `::error file={name},line={line},col={col}::{message}` -创建错误消息并将该消息打印到日志。 您可以选择提供警告出现位置的文件名 (`file`)、行号 (`line`) 和列号 (`col`)。 +创建错误消息并将该消息打印到日志。 您可以选择提供错误出现位置的文件名 (`file`)、行号 (`line`) 和列号 (`col`)。 #### 示例 @@ -213,3 +226,67 @@ console.log('::save-state name=processID::12345') ``` javascript console.log("The running PID from the main action is: " + process.env.STATE_processID); ``` + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +## 环境文件 + +在工作流程执行期间，运行器生成可用于执行某些操作的临时文件。 这些文件的路径通过环境变量显示。 写入这些文件时，您需要使用 UTF-8 编码，以确保正确处理命令。 多个命令可以写入同一个文件，用换行符分隔。 + +{% warning %} + +**警告：**Powershell 默认不使用 UTF-8。 请确保使用正确的编码写入文件。 例如，在设置路径时需要设置 UTF-8 编码： + +``` +steps: + - run: echo "mypath" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append +``` + +{% endwarning %} + +### 设置环境变量 + +`echo "{name}={value}" >> $GITHUB_ENV` + +为作业中接下来运行的任何操作创建或更新环境变量。 创建或更新环境变量的操作无法访问新值。 但在作业中的所有后续操作均可访问。 环境变量区分大小写，并且可以包含标点符号。 + +#### 示例 + +```bash +echo "action_state=yellow" >> $GITHUB_ENV +``` + +在未来步骤中运行 `$action_state` 现在会返回 `yellow` + +#### 多行字符串 +对于多行字符串，您可以使用具有以下语法的分隔符。 + +``` +{name}<<{delimiter} +{value} +{delimiter} +``` + +#### 示例 +在此示例中， 我们使用 `EOF` 作为分隔符，并将 `JSON_RESPONSE` 环境变量设置为 cURL 响应的值。 +``` +steps: + - name: Set the value + id: step_one + run: | + echo 'JSON_RESPONSE<> $GITHUB_ENV + curl https://httpbin.org/json >> $GITHUB_ENV + echo 'EOF' >> $GITHUB_ENV +``` + +### 添加系统路径 + +`echo "{path}" >> $GITHUB_PATH` + +为当前作业中的所有后续操作将目录添加到系统 `PATH` 变量之前。 当前运行的操作无法访问新路径变量。 + +#### 示例 + +``` bash +echo "/path/to/dir" >> $GITHUB_PATH +``` +{% endif %} diff --git a/translations/zh-CN/content/actions/reference/workflow-syntax-for-github-actions.md b/translations/zh-CN/content/actions/reference/workflow-syntax-for-github-actions.md index 3cafcf896c6b..4b7f9872a221 100644 --- a/translations/zh-CN/content/actions/reference/workflow-syntax-for-github-actions.md +++ b/translations/zh-CN/content/actions/reference/workflow-syntax-for-github-actions.md @@ -21,10 +21,6 @@ versions: 必须将工作流程文件存储在仓库的 `.github/workflows` 目录中。 -### 使用限制 - -{% data reusables.github-actions.github-actions-usage-limits %} - ### **`name`** 工作流程的名称。 {% data variables.product.prodname_dotcom %} 在仓库的操作页面上显示工作流程的名称。 如果省略 `name`，{% data variables.product.prodname_dotcom %} 将其设置为相对于仓库根目录的工作流程文件路径。 @@ -64,8 +60,8 @@ on: push: # Sequence of patterns matched against refs/heads branches: - # Push events on master branch - - master + # Push events on main branch + - main # Push events to branches matching refs/heads/mona/octocat - 'mona/octocat' # Push events to branches matching refs/heads/releases/10 @@ -229,7 +225,7 @@ defaults: 每个作业在 `runs-on` 指定的环境中运行。 -在工作流程的使用限制之内可运行无限数量的作业。 更多信息请参阅“[使用限制](#usage-limits)”。 +在工作流程的使用限制之内可运行无限数量的作业。 更多信息请参阅“[使用限制和计费](/actions/reference/usage-limits-billing-and-administration)”（对于 {% data variables.product.prodname_dotcom %} 托管的运行器）和“[关于自托管运行器](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)”（对于自托管运行器使用限制）。 如果需要查找在工作流程运行中运行的作业的唯一标识符，可以使用 {% data variables.product.prodname_dotcom %} ApI。 更多信息请参阅“[工作流程作业](/v3/actions/workflow-jobs)”。 @@ -293,7 +289,7 @@ jobs: ##### **示例** ```yaml -运行： ubuntu 最新 +runs-on: ubuntu-latest ``` 更多信息请参阅“[{% data variables.product.prodname_dotcom %} 托管的运行器的虚拟环境](/github/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)”。 @@ -310,7 +306,7 @@ runs-on: [self-hosted, linux] 更多信息请参阅“[关于自托管的运行器](/github/automating-your-workflow-with-github-actions/about-self-hosted-runners)”和“[在工作流程中使用自托管的运行器](/github/automating-your-workflow-with-github-actions/using-self-hosted-runners-in-a-workflow)”。 -### **`jobs..outputs`** +### **`jobs..outputs`** 作业的输出 `map`。 作业输出可用于所有依赖此作业的下游作业。 有关定义作业依赖项的更多信息，请参阅 [`jobs..needs`](#jobsjob_idneeds)。 @@ -393,7 +389,7 @@ jobs: 作业包含一系列任务，称为 `steps`。 步骤可以运行命令、运行设置任务，或者运行您的仓库、公共仓库中的操作或 Docker 注册表中发布的操作。 并非所有步骤都会运行操作，但所有操作都会作为步骤运行。 每个步骤在运行器环境中以其自己的进程运行，且可以访问工作区和文件系统。 因为步骤以自己的进程运行，所以步骤之间不会保留环境变量的更改。 {% data variables.product.prodname_dotcom %} 提供内置的步骤来设置和完成作业。 -在工作流程的使用限制之内可运行无限数量的步骤。 更多信息请参阅“[使用限制](#usage-limits)”。 +在工作流程的使用限制之内可运行无限数量的步骤。 更多信息请参阅“[使用限制和计费](/actions/reference/usage-limits-billing-and-administration)”（对于 {% data variables.product.prodname_dotcom %} 托管的运行器）和“[关于自托管运行器](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)”（对于自托管运行器使用限制）。 #### 示例 @@ -447,7 +443,7 @@ steps: ```yaml steps: - name: My first step - uses: monacorp/action-name@master + uses: monacorp/action-name@main - name: My backup step if: {% raw %}${{ failure() }}{% endraw %} uses: actions/heroku@master @@ -464,7 +460,7 @@ steps: 强烈建议指定 Git ref、SHA 或 Docker 标记编号来包含所用操作的版本。 如果不指定版本，在操作所有者发布更新时可能会中断您的工作流程或造成非预期的行为。 - 使用已发行操作版本的 SHA 对于稳定性和安全性是最安全的。 - 使用特定主要操作版本可在保持兼容性的同时接收关键修复和安全补丁。 还可确保您的工作流程继续工作。 -- 使用操作的 `master` 分支可能很方便，但如果有人新发布具有突破性更改的主要版本，您的工作流程可能会中断。 +- 使用操作的默认分支可能很方便，但如果有人新发布具有突破性更改的主要版本，您的工作流程可能会中断。 有些操作要求必须通过 [`with`](#jobsjob_idstepswith) 关键词设置输入。 请查阅操作的自述文件，确定所需的输入。 @@ -481,7 +477,7 @@ steps: # Reference a minor version of a release - uses: actions/setup-node@v1.2 # Reference a branch - - uses: actions/setup-node@master + - uses: actions/setup-node@main ``` ##### 使用公共操作的示例 @@ -495,7 +491,7 @@ jobs: my_first_job: steps: - name: My first step - # Uses the master branch of a public repository + # Uses the default branch of a public repository uses: actions/heroku@master - name: My second step # Uses a specific version tag of a public repository @@ -513,7 +509,7 @@ jobs: my_first_job: steps: - name: My first step - uses: actions/aws/ec2@master + uses: actions/aws/ec2@main ``` ##### 使用工作流程所在仓库中操作的示例 @@ -539,11 +535,11 @@ jobs: [Docker 中枢](https://hub.docker.com/)上发布的 Docker 映像。 ```yaml -工作： - my_first_job： - 步： - - 名称： 我的第一步 - 使用： docker：： 3.8 +jobs: + my_first_job: + steps: + - name: My first step + uses: docker://alpine:3.8 ``` ##### 使用 Docker 公共注册表操作的示例 @@ -596,14 +592,14 @@ jobs: 您可以使用 `shell` 关键词覆盖运行器操作系统中默认的 shell 设置。 您可以使用内置的 `shell` 关键词，也可以自定义 shell 选项集。 -| 支持的平台 | `shell` 参数 | 描述 | 内部运行命令 | -| ------------- | ------------ | --------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- | -| 所有 | `bash` | 非 Windows 平台上回退到 `sh` 的默认 shell。 指定 Windows 上的 bash shell 时，将使用 Git for Windows 随附的 bash shel。 | `bash --noprofile --norc -eo pipefail {0}` | -| 所有 | `pwsh` | PowerShell Core。 {% data variables.product.prodname_dotcom %} 将扩展名 `.ps1` 附加到您的脚本名称。 | `pwsh -command "& '{0}'"` | -| 所有 | `python` | 执行 python 命令。 | `python {0}` | -| Linux / macOS | `sh` | 未提供 shell 且 在路径中找不到 `bash` 时的非 Windows 平台的后退行为。 | `sh -e {0}` | +| 支持的平台 | `shell` 参数 | 描述 | 内部运行命令 | +| ------------- | ------------ | ---------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- | +| 所有 | `bash` | 非 Windows 平台上回退到 `sh` 的默认 shell。 指定 Windows 上的 bash shell 时，将使用 Git for Windows 随附的 bash shel。 | `bash --noprofile --norc -eo pipefail {0}` | +| 所有 | `pwsh` | PowerShell Core。 {% data variables.product.prodname_dotcom %} 将扩展名 `.ps1` 附加到您的脚本名称。 | `pwsh -command ". '{0}'"` | +| 所有 | `python` | 执行 python 命令。 | `python {0}` | +| Linux / macOS | `sh` | 未提供 shell 且 在路径中找不到 `bash` 时的非 Windows 平台的后退行为。 | `sh -e {0}` | | Windows | `cmd` | {% data variables.product.prodname_dotcom %} 将扩展名 `.cmd` 附加到您的脚本名称并替换 `{0}`。 | `%ComSpec% /D /E:ON /V:OFF /S /C "CALL "{0}""`. | -| Windows | `powershell` | 这是 Windows 上使用的默认 shell。 Desktop PowerShell。 {% data variables.product.prodname_dotcom %} 将扩展名 `.ps1` 附加到您的脚本名称。 | `powershell -command "& '{0}'"`. | +| Windows | `powershell` | 这是 Windows 上使用的默认 shell。 Desktop PowerShell。 {% data variables.product.prodname_dotcom %} 将扩展名 `.ps1` 附加到您的脚本名称。 | `powershell -command ". '{0}'"`. | ##### 使用 bash 运行脚本的示例 @@ -678,7 +674,7 @@ jobs: my_first_job: steps: - name: My first step - uses: actions/hello_world@master + uses: actions/hello_world@main with: first_name: Mona middle_name: The @@ -695,7 +691,7 @@ jobs: ```yaml steps: - name: Explain why this job ran - uses: monacorp/action-name@master + uses: monacorp/action-name@main with: entrypoint: /bin/echo args: The ${{ github.event_name }} event triggered this step. @@ -708,7 +704,6 @@ steps: 1. 使用默认值，允许不指定任何 `args` 即可使用操作。 1. 如果操作显示 `--help` 标记或类似项，请将其用作默认值，以便操作自行记录。 - #### **`jobs..steps.with.entrypoint`** 覆盖 `Dockerfile` 中的 Docker `ENTRYPOINT`，或在未指定时设置它。 与包含 shell 和 exec 表单的 Docker `ENTRYPOINT` 指令不同，`entrypoint` 关键词只接受定义要运行的可执行文件的单个字符串。 @@ -718,7 +713,7 @@ steps: ```yaml steps: - name: Run a custom command - uses: monacorp/action-name@master + uses: monacorp/action-name@main with: entrypoint: /a/different/executable ``` @@ -766,7 +761,7 @@ steps: 您可以定义不同作业配置的矩阵。 矩阵允许您通过在单个作业定义中执行变量替换来创建多个作业。 例如，可以使用矩阵为多个受支持的编程语言、操作系统或工具版本创建作业。 矩阵重新使用作业的配置，并为您配置的每个矩阵创建作业。 -{% data reusables.github-actions.matrix-limits %} +{% data reusables.github-actions.usage-matrix-limits %} 您在 `matrix` 中定义的每个选项都有键和值。 定义的键将成为 `matrix` 上下文中的属性，您可以在工作流程文件的其他区域中引用该属性。 例如，如果定义包含操作系统数组的键 `os`，您可以使用 `matrix.os` 属性作为 `runs-on` 关键字的值，为每个操作系统创建一个作业。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的上下文和表达式语法](/actions/reference/context-and-expression-syntax-for-github-actions)”。 @@ -843,7 +838,6 @@ strategy: 您可以使用 `include` 将新作业添加到构建矩阵中。 任何不匹配包含配置都会添加到矩阵中。 例如，如果您想要使用 `node` 版本 12 在多个操作系统上构建，但在 Ubuntu 上需要一个使用节点版本 13 的额外实验性作业，则可使用 `include` 指定该额外作业。 - {% raw %} ```yaml runs-on: ${{ matrix.os }} @@ -952,7 +946,25 @@ jobs: #### **`jobs..container.image`** -要用作运行操作的容器的 Docker 图像。 值可以是 Docker 中枢映像名称或公共 Docker 注册表名称。 +要用作运行操作的容器的 Docker 图像。 值可以是 Docker Hub 映像名称或 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.23" %}public{% endif %} 注册表名称。 + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +#### **`jobs..container.credentials`** + +{% data reusables.actions.registry-credentials %} + +##### 示例 + +{% raw %} +```yaml +container: + image: ghcr.io/owner/image + credentials: + username: ${{ github.actor }} + password: ${{ secrets.ghcr_token }} +``` +{% endraw %} +{% endif %} #### **`jobs..container.env`** @@ -1015,19 +1027,43 @@ services: - 6379/tcp ``` -#### **`jobs..services.image`** +#### **`jobs..services..image`** + +要用作运行操作的服务容器的 Docker 图像。 值可以是 Docker Hub 映像名称或 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.23" %}public{% endif %} 注册表名称。 -要用作运行操作的服务容器的 Docker 图像。 值可以是 Docker 基本映像名称或公共 Docker 中枢或注册表。 +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +#### **`jobs..services..credentials`** + +{% data reusables.actions.registry-credentials %} + +##### 示例 + +{% raw %} +```yaml +services: + myservice1: + image: ghcr.io/owner/myservice1 + credentials: + username: ${{ github.actor }} + password: ${{ secrets.ghcr_token }} + myservice2: + image: dockerhub_org/myservice2 + credentials: + username: ${{ secrets.DOCKER_USER }} + password: ${{ secrets.DOCKER_PASSWORD }} +``` +{% endraw %} +{% endif %} -#### **`jobs..services.env`** +#### **`jobs..services..env`** 在服务容器中设置环境变量的 `map`。 -#### **`jobs..services.ports`** +#### **`jobs..services..ports`** 设置要在服务容器上显示的端口 `array`。 -#### **`jobs..services.volumes`** +#### **`jobs..services..volumes`** 设置要使用的服务容器卷的 `array`。 您可以使用卷分享作业中服务或其他步骤之间的数据。 可以指定命名的 Docker 卷、匿名的 Docker 卷或主机上的绑定挂载。 @@ -1046,7 +1082,7 @@ volumes: - /source/directory:/destination/directory ``` -#### **`jobs..services.options`** +#### **`jobs..services..options`** 附加 Docker 容器资源选项。 有关选项列表，请参阅“[`docker create` options](https://docs.docker.com/engine/reference/commandline/create/#options)”。 @@ -1076,16 +1112,16 @@ volumes: #### 匹配分支和标记的模式 -| 模式 | 描述 | 示例匹配 | -| ----------------------------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -| `功能/*` | `*` 通配符匹配任何字符，但不匹配斜杠 (`/`)。 | -`feature/my-branch`
    -`feature/your-branch` | -| `功能/**` | `**` 通配符匹配任何字符，包括分支和标记名称中的斜杠 (`/`)。 | -`feature/beta-a/my-branch`
    -`feature/your-branch`
    -`feature/mona/the/octocat` | -| -`master`
    -`releases/mona-the-octcat` | 匹配分支或标记名称的确切名称。 | -`master`
    -`releases/mona-the-octocat` | -| `'*'` | 匹配所有不包含斜杠 (`/`) 的分支和标记名称。 `*` 字符是 YAML 中的特殊字符。 当模式以 `*` 开头时，您必须使用引号。 | -`master`
    -`releases` | -| `'**'` | 匹配所有分支和标记名称。 这是不使用 `branches` or `tags` 过滤器时的默认行为。 | -`all/the/branches`
    -`every/tag` | -| `'*功能'` | `*` 字符是 YAML 中的特殊字符。 当模式以 `*` 开头时，您必须使用引号。 | -`mona-feature`
    -`feature`
    -`ver-10-feature` | -| `v2*` | 匹配以 `v2` 开头的分支和标记名称。 | -`v2`
    -`v2.0`
    -`v2.9` | -| `v[12].[0-9]+.[0-9]+` | 将所有语义版本控制标记与主要版本 1 或 2 匹配 | -`v1.10.1`
    -`v2.0.0` | +| 模式 | 描述 | 示例匹配 | +| --------------------------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | +| `功能/*` | `*` 通配符匹配任何字符，但不匹配斜杠 (`/`)。 | -`feature/my-branch`
    -`feature/your-branch` | +| `功能/**` | `**` 通配符匹配任何字符，包括分支和标记名称中的斜杠 (`/`)。 | -`feature/beta-a/my-branch`
    -`feature/your-branch`
    -`feature/mona/the/octocat` | +| -`main`
    -`releases/mona-the-octcat` | 匹配分支或标记名称的确切名称。 | -`main`
    -`releases/mona-the-octocat` | +| `'*'` | 匹配所有不包含斜杠 (`/`) 的分支和标记名称。 `*` 字符是 YAML 中的特殊字符。 当模式以 `*` 开头时，您必须使用引号。 | -`main`
    -`releases` | +| `'**'` | 匹配所有分支和标记名称。 这是不使用 `branches` or `tags` 过滤器时的默认行为。 | -`all/the/branches`
    -`every/tag` | +| `'*功能'` | `*` 字符是 YAML 中的特殊字符。 当模式以 `*` 开头时，您必须使用引号。 | -`mona-feature`
    -`feature`
    -`ver-10-feature` | +| `v2*` | 匹配以 `v2` 开头的分支和标记名称。 | -`v2`
    -`v2.0`
    -`v2.9` | +| `v[12].[0-9]+.[0-9]+` | 将所有语义版本控制标记与主要版本 1 或 2 匹配 | -`v1.10.1`
    -`v2.0.0` | #### 匹配文件路径的模式 diff --git a/translations/zh-CN/content/admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider.md b/translations/zh-CN/content/admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider.md index 6f5235004931..63b7f355f1fc 100644 --- a/translations/zh-CN/content/admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider.md +++ b/translations/zh-CN/content/admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider.md @@ -1,6 +1,6 @@ --- title: 允许对身份提供程序覆盖范围以外的用户进行内置身份验证 -intro: 您可以配置内置身份验证，为无法访问使用 LDAP、SAML 或 CAS 的身份提供程序的用户验证身份。 +intro: '您可以配置内置身份验证，为无法访问使用 LDAP、SAML 或 CAS 的身份提供程序的用户验证身份。' redirect_from: - /enterprise/admin/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider - /enterprise/admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider @@ -45,6 +45,6 @@ versions: ### 延伸阅读 -- "[使用 LDAP](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap)" +- "[使用 LDAP](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap)" - "[使用 SAML](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-saml)" - "[使用 CAS](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-cas)" diff --git a/translations/zh-CN/content/admin/authentication/disabling-unauthenticated-sign-ups.md b/translations/zh-CN/content/admin/authentication/disabling-unauthenticated-sign-ups.md index bfcbd6995dcc..365d38724039 100644 --- a/translations/zh-CN/content/admin/authentication/disabling-unauthenticated-sign-ups.md +++ b/translations/zh-CN/content/admin/authentication/disabling-unauthenticated-sign-ups.md @@ -4,7 +4,7 @@ redirect_from: - /enterprise/admin/articles/disabling-sign-ups/ - /enterprise/admin/user-management/disabling-unauthenticated-sign-ups - /enterprise/admin/authentication/disabling-unauthenticated-sign-ups -intro: 如果您使用的是内置身份验证，可以阻止未经身份验证的人创建帐户。 +intro: '如果您使用的是内置身份验证，可以阻止未经身份验证的人创建帐户。' versions: enterprise-server: '*' --- diff --git a/translations/zh-CN/content/admin/authentication/using-cas.md b/translations/zh-CN/content/admin/authentication/using-cas.md index 6fde76e7a198..6dfec20c033e 100644 --- a/translations/zh-CN/content/admin/authentication/using-cas.md +++ b/translations/zh-CN/content/admin/authentication/using-cas.md @@ -25,8 +25,8 @@ versions: 以下属性可用。 -| 属性名称 | 类型 | 描述 | -| ----- | -- | ------------------------------------------------------------ | +| 属性名称 | 类型 | 描述 | +| ----- | -- | ------------------------------------------------------- | | `用户名` | 必选 | {% data variables.product.prodname_ghe_server %} 用户名。 | ### 配置 CAS diff --git a/translations/zh-CN/content/admin/authentication/using-ldap.md b/translations/zh-CN/content/admin/authentication/using-ldap.md index a19c5e92a7a0..e34e3ee93baf 100644 --- a/translations/zh-CN/content/admin/authentication/using-ldap.md +++ b/translations/zh-CN/content/admin/authentication/using-ldap.md @@ -57,24 +57,24 @@ versions: ### LDAP 属性 使用以下属性完成 {% data variables.product.product_location_enterprise %} 的 LDAP 配置。 -| 属性名称 | 类型 | 描述 | -| ------------------------------------------------ | -- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 属性名称 | 类型 | 描述 | +| ------------------------------------------------ | -- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Host` | 必选 | LDAP 主机，例如 `ldap.example.com` 或 `10.0.0.30`。 如果主机名只能在您的内部网络中使用，您需要先配置 {% data variables.product.product_location_enterprise %} 的 DNS，以便它可以使用您的内部域名服务器解析主机名。 | -| `端口` | 必选 | 主机的 LDAP 服务侦听的端口。 示例包括：389 和 636（适用于 LDAPS）。 | -| `Encryption` | 必选 | 用于确保与 LDAP 服务器之间的通信安全的加密方法。 示例包括明文（无加密）、SSL/LDAPS（从一开始就加密）和 StartTLS（在连接后升级为加密通信）。 | -| `Domain search user` | 可选 | 执行用户查询，在其他用户登录时对其进行身份验证的 LDAP 用户。 这一般是一个专为第三方集成创建的服务帐户。 使用完全限定名称，例如 `cn=Administrator,cn=Users,dc=Example,dc=com`。 对于 Active Directory，您还可为域搜索用户使用 `[DOMAIN]\[USERNAME]` 语法（例如 `WINDOWS\Administrator`）。 | -| `Domain search password` | 可选 | 域搜索用户的密码。 | -| `Administrators group` | 可选 | 登录您的设备后，此组中的用户将被升级为站点管理员。 如果您不配置 LDAP 管理员组，则登录您的设备的第一个 LDAP 用户帐户将被自动升级为站点管理员。 | -| `Domain base` | 必选 | 您想要搜索用户和组的 LDAP 子树的完全限定 `Distinguished Name` (DN)。 您可以添加任意数量的组；不过，每个组和它所包含的用户都必须在相同的基础域中定义。 如果您指定受限的用户组，那么只有属于这些组的用户将在作用域内。 我们建议您将 LDAP 目录树的顶级指定为您的基础域，并使用受限的用户组来控制权限。 | +| `端口` | 必选 | 主机的 LDAP 服务侦听的端口。 示例包括：389 和 636（适用于 LDAPS）。 | +| `Encryption` | 必选 | 用于确保与 LDAP 服务器之间的通信安全的加密方法。 示例包括明文（无加密）、SSL/LDAPS（从一开始就加密）和 StartTLS（在连接后升级为加密通信）。 | +| `Domain search user` | 可选 | 执行用户查询，在其他用户登录时对其进行身份验证的 LDAP 用户。 这一般是一个专为第三方集成创建的服务帐户。 使用完全限定名称，例如 `cn=Administrator,cn=Users,dc=Example,dc=com`。 对于 Active Directory，您还可为域搜索用户使用 `[DOMAIN]\[USERNAME]` 语法（例如 `WINDOWS\Administrator`）。 | +| `Domain search password` | 可选 | 域搜索用户的密码。 | +| `Administrators group` | 可选 | 登录您的设备后，此组中的用户将被升级为站点管理员。 如果您不配置 LDAP 管理员组，则登录您的设备的第一个 LDAP 用户帐户将被自动升级为站点管理员。 | +| `Domain base` | 必选 | 您想要搜索用户和组的 LDAP 子树的完全限定 `Distinguished Name` (DN)。 您可以添加任意数量的组；不过，每个组和它所包含的用户都必须在相同的基础域中定义。 如果您指定受限的用户组，那么只有属于这些组的用户将在作用域内。 我们建议您将 LDAP 目录树的顶级指定为您的基础域，并使用受限的用户组来控制权限。 | | `Restricted user groups` | 可选 | 如果指定，将仅允许这些组中的用户登录。 您只需要指定组的常用名 (CN)，您可以添加任意数量的组。 如果未指定组，则指定基础域作用域中的*所有*用户都将可以登录您的 {% data variables.product.prodname_ghe_server %} 实例。 | | `User ID` | 必选 | 标识尝试身份验证的 LDAP 用户的 LDAP 属性。 建立映射后，用户可以更改他们的 {% data variables.product.prodname_ghe_server %} 用户名。 对于大多数 Active Directory 安装来说，此字段应为 `sAMAccountName`，但对其他 LDAP 解决方案（例如 OpenLDAP）来说，可能是 `uid`。 默认值为 `uid`。 | | `Profile name` | 可选 | 将在用户的 {% data variables.product.prodname_ghe_server %} 个人资料页面上显示的姓名。 除非启用 LDAP 同步，否则用户可以更改他们的个人资料姓名。 | | `Emails` | 可选 | 用户的 {% data variables.product.prodname_ghe_server %} 帐户的电子邮件地址。 | | `SSH keys` | 可选 | 连接到用户的 {% data variables.product.prodname_ghe_server %} 帐户的 SSH 公钥。 密钥必须采用 OpenSSH 格式。 | | `GPG keys` | 可选 | 连接到用户的 {% data variables.product.prodname_ghe_server %} 帐户的 GPG 密钥。 | -| `Disable LDAP authentication for Git operations` | 可选 | 如果选择，将[禁止](#disabling-password-authentication-for-git-operations)用户使用 LDAP 密码对 Git 操作进行身份验证。 | -| `Enable LDAP certificate verification` | 可选 | 如果选择，将[启用](#enabling-ldap-certificate-verification) LDAP 证书验证。 | -| `Synchronization` | 可选 | 如果选择，将[启用](#enabling-ldap-sync) LDAP 同步。 | +| `Disable LDAP authentication for Git operations` | 可选 | 如果选择，将[禁止](#disabling-password-authentication-for-git-operations)用户使用 LDAP 密码对 Git 操作进行身份验证。 | +| `Enable LDAP certificate verification` | 可选 | 如果选择，将[启用](#enabling-ldap-certificate-verification) LDAP 证书验证。 | +| `Synchronization` | 可选 | 如果选择，将[启用](#enabling-ldap-sync) LDAP 同步。 | #### 为 Git 操作禁用密码身份验证 @@ -97,6 +97,12 @@ versions: #### 启用 LDAP 同步 +{% note %} + +要启用 LDAP 同步，请在您的 LDAP 设置中选择 **Synchronize Emails（同步电子邮件）**、**Synchronize SSH Keys（同步 SSH 密钥）**或 **Synchronize GPG Keys（同步 GPG 密钥）**。 + +{% endnote %} + 借助 LDAP 同步，您可以将 {% data variables.product.prodname_ghe_server %} 用户和团队成员关系与建立的 LDAP 组同步。 这样，您可以在 LDAP 服务器中为用户建立基于角色的权限控制，而不用在 {% data variables.product.prodname_ghe_server %} 中手动建立。 更多信息请参阅“[创建团队](/enterprise/{{ currentVersion }}/admin/guides/user-management/creating-teams#creating-teams-with-ldap-sync-enabled)”。 要启用 LDAP 同步，请在您的 LDAP 设置中选择 **Synchronize Emails（同步电子邮件）**、**Synchronize SSH Keys（同步 SSH 密钥）**或 **Synchronize GPG Keys（同步 GPG 密钥）**。 diff --git a/translations/zh-CN/content/admin/authentication/using-saml.md b/translations/zh-CN/content/admin/authentication/using-saml.md index 1928eb5f9e08..f2452a539160 100644 --- a/translations/zh-CN/content/admin/authentication/using-saml.md +++ b/translations/zh-CN/content/admin/authentication/using-saml.md @@ -33,7 +33,7 @@ versions: {% note %} -**Note**: If the `NameID` for a user does change on the IdP, the user will see an error message when they try to sign in to your {% data variables.product.prodname_ghe_server %} instance. {% if currentVersion ver_gt "enterprise-server@2.21" %}To restore the user's access, you'll need to update the user account's `NameID` mapping. For more information, see "[Updating a user's SAML `NameID`](#updating-a-users-saml-nameid)."{% else %} For more information, see "[Error: 'Another user already owns the account'](#error-another-user-already-owns-the-account)."{% endif %} +**注**：如果在 IdP 上更改某用户的 `NameID`，该用户在尝试登录到您的 {% data variables.product.prodname_ghe_server %} 实例时会看到错误消息。 {% if currentVersion ver_gt "enterprise-server@2.21" %}要恢复用户的访问权限，您需要更新用户帐户的 `NameID` 映射。 更多信息请参阅“[更新用户的 SAML `NameID`](#updating-a-users-saml-nameid)”。{% else %} 更多信息请参阅“[错误：另一个用户已拥有该帐户](#error-another-user-already-owns-the-account)”。{% endif %} {% endnote %} @@ -54,15 +54,15 @@ versions: 以下属性可用。 您可以在 [Management Console](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-management-console/) 中更改属性名称，但 `administrator` 属性除外。 -| 默认属性名称 | 类型 | 描述 | -| ------------- | -- | -------------------------------------------------------------------------------------------------------------------- | +| 默认属性名称 | 类型 | 描述 | +| ------------- | -- | --------------------------------------------------------------------------------------------------------------- | | `NameID` | 必选 | 持久用户标识符。 可以使用任意持久名称标识符格式。 除非提供备用断言之一，否则将为 {% data variables.product.prodname_ghe_server %} 用户名使用 `NameID` 元素。 | -| `管理员` | 可选 | 如果值为“true”，用户将被自动升级为管理员。 任何其他值或不存在的值会将用户降级为普通用户帐户。 | +| `管理员` | 可选 | 如果值为“true”，用户将被自动升级为管理员。 任何其他值或不存在的值会将用户降级为普通用户帐户。 | | `用户名` | 可选 | {% data variables.product.prodname_ghe_server %} 用户名。 | -| `full_name` | 可选 | 用户的个人资料页面上显示的姓名。 用户可以在配置后更改他们的姓名。 | -| `emails` | 可选 | 用户的电子邮件地址。 可以指定多个。 | -| `public_keys` | 可选 | 用户的 SSH 公钥。 可以指定多个。 | -| `gpg_keys` | 可选 | 用户的 GPG 密钥。 可以指定多个。 | +| `full_name` | 可选 | 用户的个人资料页面上显示的姓名。 用户可以在配置后更改他们的姓名。 | +| `emails` | 可选 | 用户的电子邮件地址。 可以指定多个。 | +| `public_keys` | 可选 | 用户的 SSH 公钥。 可以指定多个。 | +| `gpg_keys` | 可选 | 用户的 GPG 密钥。 可以指定多个。 | ### 配置 SAML 设置 @@ -88,15 +88,15 @@ versions: {% if currentVersion ver_gt "enterprise-server@2.21" %} -### 撤销 {% data variables.product.product_location_enterprise %} 的权限 +### 撤销 {{ site.data.variables.product.product_location_enterprise }} 的权限 {% data reusables.enterprise_site_admin_settings.access-settings %} -2. 选择 **SAML**。 !["All users" sidebar item in site administrator settings](/assets/images/enterprise/site-admin-settings/all-users.png) -3. In the list of users, click the username you'd like to update the `NameID` mapping for. ![Username in list of instance user accounts](/assets/images/enterprise/site-admin-settings/all-users-click-username.png) +2. 选择 **SAML**。 ![网站管理员设置中的"All users（所有用户）"侧边栏项目](/assets/images/enterprise/site-admin-settings/all-users.png) +3. 在用户列表中，点击您想要更新其 `NameID` 映射的用户名。 ![实例用户帐户列表中的用户名](/assets/images/enterprise/site-admin-settings/all-users-click-username.png) {% data reusables.enterprise_site_admin_settings.security-tab %} -5. To the right of "Update SAML NameID", click **Edit** . ![SAML 身份验证](/assets/images/enterprise/site-admin-settings/update-saml-nameid-edit.png) -6. In the "NameID" field, type the new `NameID` for the user. !["NameID" field in modal dialog with NameID typed](/assets/images/enterprise/site-admin-settings/update-saml-nameid-field-in-modal.png) -7. Click **Update NameID**. !["Update NameID" button under updated NameID value within modal](/assets/images/enterprise/site-admin-settings/update-saml-nameid-update.png) +5. 在“Update SAML NameID（更新 SAML 名称 ID）”右侧，单击 **Edit（编辑）**。 ![SAML 身份验证](/assets/images/enterprise/site-admin-settings/update-saml-nameid-edit.png) +6. 在“NameID（名称 ID）”字段中，为用户键入新的 `NameID`。 ![键入了名称 ID 的模态对话框中的"名称 ID"字段](/assets/images/enterprise/site-admin-settings/update-saml-nameid-field-in-modal.png) +7. 单击 **Update NameID（更新名称 ID）**。 ![模态中更新的名称 ID 下的"Update NameID（更新名称 ID）"按钮](/assets/images/enterprise/site-admin-settings/update-saml-nameid-update.png) {% endif %} @@ -108,7 +108,7 @@ versions: 响应消息必须满足以下要求： -- `` 元素必须在根响应文档上提供，而且只有在根响应文档签署后才匹配 ACS URL。 If the assertion is signed, it will be ignored. +- `` 元素必须在根响应文档上提供，而且只有在根响应文档签署后才匹配 ACS URL。 如果断言已签名，它将被忽略。 - `` 元素必须始终作为 `` 元素的一部分提供。 `` 元素必须始终作为 `` 元素的一部分提供。 这是 {% data variables.product.prodname_ghe_server %} 实例的 URL，如 `https://ghe.corp.example.com`。 - 响应中的每一个断言都**必须**由数字签名加以保护。 签署各个 `` 元素或签署 `` 元素可以实现此操作。 - `` 元素必须作为 `` 元素的一部分提供。 可以使用任意持久名称标识符格式。 @@ -134,21 +134,21 @@ versions: ### SAML 身份验证 -{% data variables.product.prodname_ghe_server %} logs error messages for failed SAML authentication in the authentication log at _/var/log/github/auth.log_. For more information about SAML response requirements, see "[Response message requirements](#response-message-requirements)." +{% data variables.product.prodname_ghe_server %} 在 _/var/log/github/auth.log_ 的身份验证日志中为失败的 SAML 身份验证记录错误消息。 关于 SAML 响应要求的更多信息，请参阅“[响应消息要求](#response-message-requirements)”。 -#### Error: "Another user already owns the account" +#### Error: "Another user already owns the account"（错误：“其他用户已拥有该帐户”） 您的 {% data variables.product.prodname_ghe_server %} 实例的服务提供程序元数据位于 `http(s)://[hostname]/saml/metadata` 下。 -When the user signs in again, {% data variables.product.prodname_ghe_server %} compares the account's `NameID` mapping to the IdP's response. If the `NameID` in the IdP's response no longer matches the `NameID` that {% data variables.product.prodname_ghe_server %} expects for the user, the sign-in will fail. The user will see the following message. +当用户再次登录时，{% data variables.product.prodname_ghe_server %} 会比较帐户的 `NameID` 映射与 IdP 的响应。 如果 IdP 响应中的 `NameID` 不再与 {% data variables.product.prodname_ghe_server %} 对用户预期的 `NameID` 匹配， 登录将失败。 用户将看到以下消息。 -> Another user already owns the account. Please have your administrator check the authentication log. +> 另一个用户已经拥有该帐户。 请让您的管理员检查身份验证日志。 -The message typically indicates that the person's username or email address has changed on the IdP. {% if currentVersion ver_gt "enterprise-server@2.21" %}Ensure that the `NameID` mapping for the user account on {% data variables.product.prodname_ghe_server %} matches the user's `NameID` on your IdP. For more information, see "[Updating a user's SAML `NameID`](#updating-a-users-saml-nameid)."{% else %}For help updating the `NameID` mapping, contact {% data variables.contact.contact_ent_support %}.{% endif %} +该消息通常表示此人的用户名或电子邮件地址已在 IdP 上更改。 {% if currentVersion ver_gt "enterprise-server@2.21" %}确保在 {% data variables.product.prodname_ghe_server %} 上的用户帐户的 `NameID` 映射与 IdP 上的 `NameID` 匹配。 更多信息请参阅“[更新用户的 SAML `NameID`](#updating-a-users-saml-nameid)”。{% else %}如需更新 `NameID` 映射的帮助，请联系 {% data variables.contact.contact_ent_support %}。{% endif %} -#### 如果 SAML 响应未签名，或者签名与内容不匹配，身份验证日志中将显示以下错误消息： +#### Error: Recipient in SAML response was blank or not valid（错误：SAML 响应中的收件人为空或无效） -如果 `Recipient` 与 ACS URL 不匹配，身份验证日志中将显示以下错误消息： +如果 `Recipient` 与 {% data variables.product.prodname_ghe_server %} 实例的 ACS URL 不匹配，则当用户尝试验证时，身份验证日志中将显示以下两条错误消息之一： ``` Recipient in the SAML response must not be blank. @@ -160,22 +160,22 @@ Recipient in the SAML response was not valid. `Recipient` 属性必须存在并设为 ACS URL。 例如，`https://ghe.corp.example.com/saml/consume`。 -#### Error: "SAML Response is not signed or has been modified" +#### Error: "SAML Response is not signed or has been modified"（错误：“SAML 响应未签名或已修改”） -If your IdP does not sign the SAML response, or the signature does not match the contents, the following error message will appear in the authentication log. +如果您的 IdP 未对 SAML 响应进行签名，或者签名与内容不匹配，则身份验证日志中将显示以下错误消息。 ``` SAML Response is not signed or has been modified. ``` -Ensure that you configure signed assertions for the {% data variables.product.prodname_ghe_server %} application on your IdP. +确保为 IdP 上的 {% data variables.product.prodname_ghe_server %} 应用程序配置签名的断言。 -#### Error: "Audience is invalid" or "No assertion found" +#### Error: "Audience is invalid" or "No assertion found"（错误：“受众无效”或“未找到断言”） -If the IdP's response has a missing or incorrect value for `Audience`, the following error message will appear in the authentication log. +如果 IdP 的响应缺少 `Audience` 的值或者该值不正确，则身份验证日志中将显示以下错误消息。 ```shell Audience is invalid. Audience is invalid. Audience attribute does not match your_instance_url ``` -Ensure that you set the value for `Audience` on your IdP to the `EntityId` for your {% data variables.product.prodname_ghe_server %} instance, which is the full URL to your {% data variables.product.prodname_ghe_server %} instance. 例如，`https://ghe.corp.example.com`。 +确保对您的 {% data variables.product.prodname_ghe_server %} 实例将 IdP 上的 `Audience` 值设为 `EntityId`，这是 {% data variables.product.prodname_ghe_server %} 实例的完整 URL。 例如，`https://ghe.corp.example.com`。 diff --git a/translations/zh-CN/content/admin/configuration/accessing-the-management-console.md b/translations/zh-CN/content/admin/configuration/accessing-the-management-console.md index 14e46bf20c64..0359c2c7e611 100644 --- a/translations/zh-CN/content/admin/configuration/accessing-the-management-console.md +++ b/translations/zh-CN/content/admin/configuration/accessing-the-management-console.md @@ -1,5 +1,5 @@ --- -title: Accessing the management console +title: 访问管理控制台 intro: '使用 {% data variables.enterprise.management_console %} 可以设置和配置 {% data variables.product.product_location %}、排定维护窗口、排查问题以及管理许可。' redirect_from: - /enterprise/admin/articles/about-the-management-console/ @@ -29,7 +29,7 @@ versions: ### 以站点管理员身份访问 {% data variables.enterprise.management_console %} -The first time that you access the {% data variables.enterprise.management_console %} as a site administrator, you must upload your {% data variables.product.prodname_enterprise %} license file to authenticate into the app. For more information, see "[Managing your {% data variables.product.prodname_enterprise %} license](/enterprise/{{ currentVersion }}/admin/guides/installation/managing-your-github-enterprise-license)." +第一次以网站管理员身份访问 {% data variables.enterprise.management_console %} 时，必须上传您的 {% data variables.product.prodname_enterprise %} 许可文件以向应用程序验证。 更多信息请参阅“[管理您的 {% data variables.product.prodname_enterprise %} 许可](/enterprise/{{ currentVersion }}/admin/guides/installation/managing-your-github-enterprise-license)”。 {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} diff --git a/translations/zh-CN/content/admin/configuration/command-line-utilities.md b/translations/zh-CN/content/admin/configuration/command-line-utilities.md index dd2cacc090fb..80ab83189bf2 100644 --- a/translations/zh-CN/content/admin/configuration/command-line-utilities.md +++ b/translations/zh-CN/content/admin/configuration/command-line-utilities.md @@ -20,7 +20,8 @@ versions: 此实用程序会在每个 {% data variables.product.prodname_enterprise %} 页面顶部设置横幅， 您可以使用横幅向用户广播消息。 {% if currentVersion ver_gt "enterprise-server@2.21" %} -You can also set an announcement banner using the enterprise settings on {% data variables.product.product_name %}. 更多信息请参阅“[自定义您的实例上的用户消息](/enterprise/admin/user-management/customizing-user-messages-on-your-instance#creating-a-global-announcement-banner)”。 +您还可以使用 +{% data variables.product.product_name %} 上的企业设置来设置公告横幅。 更多信息请参阅“[自定义您的实例上的用户消息](/enterprise/admin/user-management/customizing-user-messages-on-your-instance#creating-a-global-announcement-banner)”。 {% endif %} ```shell @@ -80,7 +81,7 @@ $ ghe-config -l ``` {% if currentVersion ver_gt "enterprise-server@2.21" %} -Allows you to exempt a list of users from API rate limits. For more information, see "[Resources in the REST API](/rest/overview/resources-in-the-rest-api#rate-limiting)." +允许您将用户列表从 API 速率限制中排除。 更多信息请参阅“[REST API 中的资源](/rest/overview/resources-in-the-rest-api#rate-limiting)”。 ``` shell $ ghe-config app.github.rate_limiting_exempt_users "hubot github-actions" @@ -158,7 +159,7 @@ $ ghe-es-index-status -do | column -ts, #### ghe-legacy-github-services-report -此实用程序会列出您的设备中使用 {% data variables.product.prodname_dotcom %} Services 的仓库，作为一种集成方法，此服务将于 2018 年 10 月 1 日停用。 您的设备上的用户可能已设置 {% data variables.product.prodname_dotcom %} Services，为发往某些仓库的推送创建通知。 For more information, see "[Announcing the deprecation of {% data variables.product.prodname_dotcom %} Services](https://developer.github.com/changes/2018-04-25-github-services-deprecation/)" on {% data variables.product.prodname_blog %} or "[Replacing {% data variables.product.prodname_dotcom %} Services](/v3/guides/replacing-github-services/)." 如需获取关于此命令的更多信息或附加选项，请使用 `-h` 标志。 +此实用程序会列出您的设备中使用 {% data variables.product.prodname_dotcom %} Services 的仓库，作为一种集成方法，此服务将于 2018 年 10 月 1 日停用。 您的设备上的用户可能已设置 {% data variables.product.prodname_dotcom %} Services，为发往某些仓库的推送创建通知。 更多信息请参阅 {% data variables.product.prodname_blog %} 上的“[宣布弃用 {% data variables.product.prodname_dotcom %} Services](https://developer.github.com/changes/2018-04-25-github-services-deprecation/)”或“[替换 {% data variables.product.prodname_dotcom %} Services](/v3/guides/replacing-github-services/)”。 如需获取关于此命令的更多信息或附加选项，请使用 `-h` 标志。 ```shell ghe-legacy-github-services-report @@ -181,7 +182,6 @@ ghe-logs-tail ghe-maintenance -h ``` -{% if currentVersion ver_gt "enterprise-server@2.17" %} #### ghe-motd 此实用程序重新显示管理员通过管理 shell 访问实例时看到的当天消息 (MOTD)。 输出包含实例状态的概述。 @@ -189,7 +189,6 @@ ghe-maintenance -h ```shell ghe-motd ``` -{% endif %} #### ghe-nwo @@ -394,7 +393,7 @@ ghe-ssl-acme -e 此实用程序允许您在 {% data variables.product.prodname_enterprise %} 服务器上安装自定义根 CA 证书。 证书必须采用 PEM 格式。 此外，如果您的证书提供者在一个文件中包含多个 CA 证书，则必须将其拆分到多个单独文件中，随后再将这些文件逐个传递到 `ghe-ssl-ca-certificate-install`。 -Run this utility to add a certificate chain for S/MIME commit signature verification. 更多信息请参阅“[关于提交签名验证](/enterprise/{{ currentVersion }}/user/articles/about-commit-signature-verification/)”。 +运行此实用程序可添加证书链进行 S/MIME 提交签名验证。 更多信息请参阅“[关于提交签名验证](/enterprise/{{ currentVersion }}/user/articles/about-commit-signature-verification/)”。 如果 {% data variables.product.product_location_enterprise %} 无法连接到另一台服务器的原因是后者使用自签名 SSL 证书或没有为其提供必要 CA 包的 SSL 证书，请运行此实用程序。 确认这种情况的一种方法是通过 {% data variables.product.product_location_enterprise %} 运行 `openssl s_client -connect host:port -verify 0 -CApath /etc/ssl/certs`。 如果可以验证远程服务器的 SSL 证书，`SSL-Session` 的返回代码应为 0，如下所示。 @@ -522,7 +521,7 @@ $ ssh -p 122 admin@hostname -- 'ghe-cluster-support-bundle -t ticke {% if currentVersion ver_gt "enterprise-server@2.21" %} #### ghe-cluster-failover -Fail over from active cluster nodes to passive cluster nodes. For more information, see "[Initiating a failover to your replica cluster](/enterprise/admin/enterprise-management/initiating-a-failover-to-your-replica-cluster)." +从主动群集节点故障转移至被动群集节点。 更多信息请参阅“[发起到副本群集的故障转移](/enterprise/admin/enterprise-management/initiating-a-failover-to-your-replica-cluster)”。 ```shell ghe-cluster-failover @@ -772,7 +771,7 @@ ghe-license-usage #### ghe-org-membership-update -此实用程序将对您的实例中的所有成员强制实施默认的组织成员关系可见性设置。 For more information, see "[Configuring visibility for organization membership](/enterprise/{{ currentVersion }}/admin/guides/user-management/configuring-visibility-for-organization-membership)." Setting options are `public` or `private`. +此实用程序将对您的实例中的所有成员强制实施默认的组织成员关系可见性设置。 更多信息请参阅“[配置组织成员关系的可见性](/enterprise/{{ currentVersion }}/admin/guides/user-management/configuring-visibility-for-organization-membership)”。 设置选项为 `public` 或 `private`。 ```shell ghe-org-membership-update --visibility=SETTING diff --git a/translations/zh-CN/content/admin/configuration/configuring-advanced-security-features.md b/translations/zh-CN/content/admin/configuration/configuring-advanced-security-features.md index 908439284670..32c78f84333c 100644 --- a/translations/zh-CN/content/admin/configuration/configuring-advanced-security-features.md +++ b/translations/zh-CN/content/admin/configuration/configuring-advanced-security-features.md @@ -1,14 +1,10 @@ --- -title: Configuring Advanced Security features -shortTitle: Configuring Advanced Security -intro: 'You can enable or disable {% data variables.product.prodname_advanced_security %} features, such as {% data variables.product.prodname_code_scanning %}, on your instance.' +title: 配置高级安全功能 +shortTitle: 配置高级安全 +intro: '您可以在您的实例上启用或禁用 {% data variables.product.prodname_advanced_security %} 功能，例如 {% data variables.product.prodname_code_scanning %}。' mapTopic: true redirect_from: - /enterprise/admin/configuration/configuring-advanced-security-features - - /enterprise/admin/configuration/configuring-advanced-security-features - - /enterprise/admin/configuration/configuring-advanced-security-features - - /enterprise/admin/configuration/configuring-advanced-security-features - - /enterprise/admin/configuration/configuring-advanced-security-features versions: enterprise-server: '>=2.22' --- diff --git a/translations/zh-CN/content/admin/configuration/configuring-applications.md b/translations/zh-CN/content/admin/configuration/configuring-applications.md index 4d82f3816329..0eac47c2b764 100644 --- a/translations/zh-CN/content/admin/configuration/configuring-applications.md +++ b/translations/zh-CN/content/admin/configuration/configuring-applications.md @@ -15,5 +15,7 @@ versions: {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} 3. 在左侧边栏中，单击 **Applications**。 ![设置侧边栏中的 Applications 选项卡](/assets/images/enterprise/management-console/sidebar-applications.png) -4. 在“Avatar image cache time (seconds)（头像图像缓存时间（秒））”下，输入希望 {% data variables.product.product_location_enterprise %} 缓存头像图像的秒数。 ![头像图像缓存表单字段](/assets/images/enterprise/management-console/add-image-caching-value-field.png) +4. 在“Avatar image cache time (seconds)（头像缓存时间[秒]）”下，输入您希望 +{% data variables.product.product_location_enterprise %} 缓存头像的秒数。 +![头像图像缓存表单字段](/assets/images/enterprise/management-console/add-image-caching-value-field.png) {% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/zh-CN/content/admin/configuration/configuring-built-in-firewall-rules.md b/translations/zh-CN/content/admin/configuration/configuring-built-in-firewall-rules.md index 378938a382d1..fe0294735c89 100644 --- a/translations/zh-CN/content/admin/configuration/configuring-built-in-firewall-rules.md +++ b/translations/zh-CN/content/admin/configuration/configuring-built-in-firewall-rules.md @@ -74,7 +74,7 @@ UFW 防火墙还会打开 {% data variables.product.prodname_ghe_server %} 所 {% warning %} -**Warning:** If you didn't back up the original rules before making changes to the firewall, contact {% data variables.contact.contact_ent_support %} for further assistance. +**警告**：如果您对防火墙进行更改之前未备份原始规则，请联系 {% data variables.contact.contact_ent_support %} 获取更多帮助。 {% endwarning %} diff --git a/translations/zh-CN/content/admin/configuration/configuring-code-scanning-for-your-appliance.md b/translations/zh-CN/content/admin/configuration/configuring-code-scanning-for-your-appliance.md index fcafae60d82b..cbf2c901ce34 100644 --- a/translations/zh-CN/content/admin/configuration/configuring-code-scanning-for-your-appliance.md +++ b/translations/zh-CN/content/admin/configuration/configuring-code-scanning-for-your-appliance.md @@ -1,7 +1,7 @@ --- -title: Configuring code scanning for your appliance +title: 为设备配置代码扫描 shortTitle: 配置代码扫描 -intro: 'You can enable, configure and disable {% data variables.product.prodname_code_scanning %} for {% data variables.product.product_location_enterprise %}. {% data variables.product.prodname_code_scanning_capc %} allows users to scan code for vulnerabilities and errors.' +intro: '您可以为 {% data variables.product.product_location_enterprise %} 启用、配置和禁用 {% data variables.product.prodname_code_scanning %}。 {% data variables.product.prodname_code_scanning_capc %} 允许用户扫描代码以发现漏洞和错误。' product: '{% data reusables.gated-features.code-scanning %}' miniTocMaxHeadingLevel: 4 redirect_from: @@ -16,19 +16,19 @@ versions: {% data reusables.code-scanning.about-code-scanning %} -The table below summarizes the available types of analysis for {% data variables.product.prodname_code_scanning %}, and provides links on enabling the feature for individual repositories. +下表概括了 {% data variables.product.prodname_code_scanning %} 的可用分析类型，并提供了为单个仓库启用功能的链接。 {% data reusables.code-scanning.enabling-options %} -For the users of {% data variables.product.product_location_enterprise %} to be able to enable and use {% data variables.product.prodname_code_scanning %} in their repositories, you need, as a site administrator, to enable this feature for the whole appliance. +为使用户 {% data variables.product.product_location_enterprise %} 在仓库中启用 {% data variables.product.prodname_code_scanning %}，您需要作为站点管理员为整个设备启用此功能。 -### How do I know if {% data variables.product.prodname_code_scanning %} is enabled for my appliance +### 如何知道我的设备是否启用 {% data variables.product.prodname_code_scanning %} {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} -1. Check if there is an **{% data variables.product.prodname_advanced_security %}** entry in the left sidebar. ![Advanced Security sidebar](/assets/images/enterprise/management-console/sidebar-advanced-security.png) +1. 检查左侧边栏中是否有 **{% data variables.product.prodname_advanced_security %}** 条目。 ![高级安全侧边栏](/assets/images/enterprise/management-console/sidebar-advanced-security.png) -If you can't see **{% data variables.product.prodname_advanced_security %}** in the sidebar, it means that your license doesn't include support for {% data variables.product.prodname_advanced_security %} features including {% data variables.product.prodname_code_scanning %}. The {% data variables.product.prodname_advanced_security %} license gives you and your users access to features that help you make your repositories and code more secure. +如果您在侧边栏中看不到 **{% data variables.product.prodname_advanced_security %}**，这意味着您的许可不支持 {% data variables.product.prodname_advanced_security %} 功能，包括 {% data variables.product.prodname_code_scanning %}。 {% data variables.product.prodname_advanced_security %} 的许可使您和您的用户能够访问那些有助于提高仓库和代码安全性的功能。 ### 启用 {% data variables.product.prodname_code_scanning %} @@ -37,37 +37,41 @@ If you can't see **{% data variables.product.prodname_advanced_security %}** in {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_management_console.advanced-security-tab %} -1. Under "{% data variables.product.prodname_advanced_security %}," click **{% data variables.product.prodname_code_scanning_capc %}**. ![Checkbox to enable or disable {% data variables.product.prodname_code_scanning %}](/assets/images/enterprise/management-console/enable-code-scanning-checkbox.png) +1. 在“ +{% data variables.product.prodname_advanced_security %}”下，单击 **{% data variables.product.prodname_code_scanning_capc %}**。 +![用于启用或禁用 {% data variables.product.prodname_code_scanning %} 的复选框](/assets/images/enterprise/management-console/enable-code-scanning-checkbox.png) {% data reusables.enterprise_management_console.save-settings %} -### Running {% data variables.product.prodname_code_scanning %} using {% data variables.product.prodname_actions %} +### 使用 {% data variables.product.prodname_actions %} 运行 {% data variables.product.prodname_code_scanning %} -#### Setting up a self-hosted runner +#### 设置自托管运行器 -If you are enrolled in the {% data variables.product.prodname_actions %} beta, then {% data variables.product.prodname_ghe_server %} can run {% data variables.product.prodname_code_scanning %} using a {% data variables.product.prodname_actions %} workflow. First, you need to provision one or more self-hosted {% data variables.product.prodname_actions %} runners in your environment. You can provision self-hosted runners at the repository, organization, or enterprise account level. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners)" and "[Adding self-hosted runners](/actions/hosting-your-own-runners/adding-self-hosted-runners)." +如果您参加 {% data variables.product.prodname_actions %} 公测，则 {% data variables.product.prodname_ghe_server %} 可以使用 {% data variables.product.prodname_actions %} 工作流程运行 {% data variables.product.prodname_code_scanning %}。 首先，您需要在环境中预配一个或多个自托管的 {% data variables.product.prodname_actions %} 运行器。 您可以在仓库、组织或企业帐户级别预配自托管运行器。 更多信息请参阅“[关于自托管的运行器](/actions/hosting-your-own-runners/about-self-hosted-runners)”和“[添加自托管的运行器](/actions/hosting-your-own-runners/adding-self-hosted-runners)”。 -#### Provisioning the action -To run {% data variables.product.prodname_code_scanning %} on {% data variables.product.prodname_ghe_server %} with {% data variables.product.prodname_actions %}, the appropriate action must be available locally. You can make the action available in three ways. +您必须确保 Git 在用于运行 {% data variables.product.prodname_codeql %} 操作的任何自托管运行器上的 PATH 变量中。 -- **Recommended** You can use [{% data variables.product.prodname_github_connect %}](/enterprise/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud) to automatically download actions from {% data variables.product.prodname_dotcom_the_website %}. The machine that hosts your instance must be able to access {% data variables.product.prodname_dotcom_the_website %}. This approach ensures that you get the latest software automatically. For more information, see "[Configuring {% data variables.product.prodname_github_connect %} to sync {% data variables.product.prodname_actions %}](/enterprise/admin/configuration/configuring-code-scanning-for-your-appliance#configuring-github-connect-to-sync-github-actions)." -- If you want to use the {% data variables.product.prodname_codeql_workflow %}, you can sync the repository from {% data variables.product.prodname_dotcom_the_website %} to {% data variables.product.prodname_ghe_server %}, by using the {% data variables.product.prodname_codeql %} Action sync tool available at [https://github.com/github/codeql-action-sync-tool](https://github.com/github/codeql-action-sync-tool/). You can use this tool regardless of whether {% data variables.product.product_location_enterprise %} or your {% data variables.product.prodname_actions %} runners have access to the internet, as long as you can access both {% data variables.product.product_location_enterprise %} and {% data variables.product.prodname_dotcom_the_website %} simultaneously on your computer. -- You can create a local copy of the action's repository on your server, by cloning the {% data variables.product.prodname_dotcom_the_website %} repository with the action. For example, if you want to use the {% data variables.product.prodname_codeql %} action, you can create a repository in your instance called `github/codeql-action`, then clone the [repository](https://github.com/github/codeql-action) from {% data variables.product.prodname_dotcom_the_website %}, and then push that repository to your instance's `github/codeql-action` repository. You will also need to download any of the releases from the repository on {% data variables.product.prodname_dotcom_the_website %} and upload them to your instance's `github/codeql-action` repository as releases. +#### 预配操作 +要在 {% data variables.product.prodname_ghe_server %} 上使用 {% data variables.product.prodname_actions %} 运行 {% data variables.product.prodname_code_scanning %}，必须在本地可以进行适当的操作。 您可以通过三种方式使操作可用。 +- **推荐** 您可以使用 [{% data variables.product.prodname_github_connect %}](/enterprise/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud) 自动从 {% data variables.product.prodname_dotcom_the_website %} 下载操作。 托管实例的机器必须能够访问 {% data variables.product.prodname_dotcom_the_website %}。 此方法可确保自动获取最新软件。 更多信息请参阅“[配置 {% data variables.product.prodname_github_connect %} 以同步 {% data variables.product.prodname_actions %}](/enterprise/admin/configuration/configuring-code-scanning-for-your-appliance#configuring-github-connect-to-sync-github-actions)”。 +- 如果要使用 {% data variables.product.prodname_codeql_workflow %}，可以使用 [https://github.com/github/codeql-action-sync-tool](https://github.com/github/codeql-action-sync-tool/) 上的 {% data variables.product.prodname_codeql %} 操作同步工具将仓库从 {% data variables.product.prodname_dotcom_the_website %} 同步到 {% data variables.product.prodname_ghe_server %}。 无论您的 {% data variables.product.product_location_enterprise %} 或 {% data variables.product.prodname_actions %} 运行器是否可以访问互联网， 只要您可以同时在计算机上访问 {% data variables.product.product_location_enterprise %} 和 {% data variables.product.prodname_dotcom_the_website %}，您都可以使用此工具。 +- 您可以通过使用操作克隆仓库，在服务器上创建 {% data variables.product.prodname_dotcom_the_website %} 仓库的本地副本。 例如，如果要使用 {% data variables.product.prodname_codeql %} 操作，可以在实例中创建一个名为 `github/codeql-action` 的仓库，然后从 {% data variables.product.prodname_dotcom_the_website %} 克隆[仓库](https://github.com/github/codeql-action)，再将该仓库推送到实例的 `github/codeql-action` 仓库。 您还需要从 {% data variables.product.prodname_dotcom_the_website %} 上的仓库下载任何发行版，并将它们作为发行版上传到实例的 `github/codeql-action` 仓库。 -##### Configuring {% data variables.product.prodname_github_connect %} to sync {% data variables.product.prodname_actions %} -1. If you want to download action workflows on demand from {% data variables.product.prodname_dotcom_the_website %}, you need to enable {% data variables.product.prodname_github_connect %}. For more information, see "[Enabling {% data variables.product.prodname_github_connect %}](/enterprise/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud#enabling-github-connect)." -2. You'll also need to enable {% data variables.product.prodname_actions %} for {% data variables.product.product_location_enterprise %}. For more information, see "[Enabling {% data variables.product.prodname_actions %} and configuring storage](/enterprise/admin/github-actions/enabling-github-actions-and-configuring-storage)." -3. The next step is to configure access to actions on {% data variables.product.prodname_dotcom_the_website %} using {% data variables.product.prodname_github_connect %}. For more information, see "[Enabling automatic access to {% data variables.product.prodname_dotcom_the_website %} actions using {% data variables.product.prodname_github_connect %}](/enterprise/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect)." -4. Add a self-hosted runner to your repository, organization, or enterprise account. 更多信息请参阅“[添加自托管的运行器](/actions/hosting-your-own-runners/adding-self-hosted-runners)”。 +##### 配置 {% data variables.product.prodname_github_connect %} 以同步 {% data variables.product.prodname_actions %} -After you configure a self-hosted runner, users can enable {% data variables.product.prodname_code_scanning %} for individual repositories on {% data variables.product.product_location_enterprise %}. 默认 {% data variables.product.prodname_code_scanning %} 工作流程使用 `on.push` 事件触发代码扫描 - 每次推送到任何包含工作流程文件的分支时触发。 +1. 如果要从 {% data variables.product.prodname_dotcom_the_website %} 下载按需操作工作流程，则需要启用 {% data variables.product.prodname_github_connect %}。 更多信息请参阅“[启用 {% data variables.product.prodname_github_connect %}](/enterprise/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud#enabling-github-connect)”。 +2. 您还需要为 {% data variables.product.product_location_enterprise %} 启用 {% data variables.product.prodname_actions %}。 更多信息请参阅“[启用 {% data variables.product.prodname_actions %} 和配置存储](/enterprise/admin/github-actions/enabling-github-actions-and-configuring-storage)”。 +3. 下一步是使用 {% data variables.product.prodname_github_connect %} 配置对 {% data variables.product.prodname_dotcom_the_website %} 上的操作的访问权限。 更多信息请参阅“[启用使用 {% data variables.product.prodname_github_connect %} 自动访问 {% data variables.product.prodname_dotcom_the_website %} 操作](/enterprise/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect)”。 +4. 将自托管运行器添加到仓库、组织或企业帐户。 更多信息请参阅“[添加自托管的运行器](/actions/hosting-your-own-runners/adding-self-hosted-runners)”。 -### Running {% data variables.product.prodname_code_scanning %} using the {% data variables.product.prodname_codeql_runner %} -If your organization isn't taking part in the beta for {% data variables.product.prodname_actions %}, or if you don't want to use {% data variables.product.prodname_actions %}, you can run {% data variables.product.prodname_code_scanning %} using the {% data variables.product.prodname_codeql_runner %}. +在配置自托管运行器后，用户可以对 {% data variables.product.prodname_code_scanning %} 上的单个仓库启用 {% data variables.product.product_location_enterprise %}。 默认 {% data variables.product.prodname_code_scanning %} 工作流程使用 `on.push` 事件触发代码扫描 - 每次推送到任何包含工作流程文件的分支时触发。 -The {% data variables.product.prodname_codeql_runner %} is a command-line tool that you can add to your third-party CI/CD system. The tool runs {% data variables.product.prodname_codeql %} analysis on a checkout of a {% data variables.product.prodname_dotcom %} repository. For more information, see "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)." +### 使用 {% data variables.product.prodname_codeql_runner %} 运行 {% data variables.product.prodname_code_scanning %} +如果您的组织未参加 {% data variables.product.prodname_actions %} 的测试版，或者您不想使用 {% data variables.product.prodname_actions %}，则可以使用 {% data variables.product.prodname_codeql_runner %} 运行 {% data variables.product.prodname_code_scanning %}。 + +该 {% data variables.product.prodname_codeql_runner %} 是一个命令行工具，您可以将其添加到第三方 CI/CD 系统中。 该工具在 {% data variables.product.prodname_dotcom %} 仓库检出时运行 {% data variables.product.prodname_codeql %} 分析。 更多信息请参阅“[在 CI 系统中运行 {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)”。 ### 禁用 {% data variables.product.prodname_code_scanning %} @@ -76,5 +80,7 @@ The {% data variables.product.prodname_codeql_runner %} is a command-line tool t {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_management_console.advanced-security-tab %} -1. Under "{% data variables.product.prodname_advanced_security %}", unselect **{% data variables.product.prodname_code_scanning_capc %}**. ![Checkbox to enable or disable {% data variables.product.prodname_code_scanning %}](/assets/images/enterprise/management-console/code-scanning-disable.png) +1. 在“ +{% data variables.product.prodname_advanced_security %}”下，取消选择 **{% data variables.product.prodname_code_scanning_capc %}**。 +![用于启用或禁用 {% data variables.product.prodname_code_scanning %} 的复选框](/assets/images/enterprise/management-console/code-scanning-disable.png) {% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/zh-CN/content/admin/configuration/configuring-network-settings.md b/translations/zh-CN/content/admin/configuration/configuring-network-settings.md index 5982df4cdbbf..e2b37628178b 100644 --- a/translations/zh-CN/content/admin/configuration/configuring-network-settings.md +++ b/translations/zh-CN/content/admin/configuration/configuring-network-settings.md @@ -1,5 +1,5 @@ --- -title: Configuring network settings +title: 配置网络设置 redirect_from: - /enterprise/admin/guides/installation/dns-hostname-subdomain-isolation-and-ssl/ - /enterprise/admin/articles/about-dns-ssl-and-subdomain-settings/ diff --git a/translations/zh-CN/content/admin/configuration/configuring-rate-limits.md b/translations/zh-CN/content/admin/configuration/configuring-rate-limits.md index 73e96c2d2aa9..9a82169c2cdd 100644 --- a/translations/zh-CN/content/admin/configuration/configuring-rate-limits.md +++ b/translations/zh-CN/content/admin/configuration/configuring-rate-limits.md @@ -10,10 +10,10 @@ versions: ### 为 {% data variables.product.prodname_enterprise_api %} 启用速率限制 -在 {% data variables.product.prodname_enterprise_api %} 上启用速率限制可以防止个别用户或未通过身份验证的用户过度使用资源。 For more information, see "[Resources in the REST API](/rest/overview/resources-in-the-rest-api#rate-limiting)." +在 {% data variables.product.prodname_enterprise_api %} 上启用速率限制可以防止个别用户或未通过身份验证的用户过度使用资源。 更多信息请参阅“[REST API 中的资源](/rest/overview/resources-in-the-rest-api#rate-limiting)”。 {% if currentVersion ver_gt "enterprise-server@2.21" %} -You can exempt a list of users from API rate limits using the `ghe-config` utility in the administrative shell. For more information, see "[Command-line utilities](/enterprise/admin/configuration/command-line-utilities#ghe-config)." +您可以使用管理 shell 中的 `ghe-config` 实用程序从 API 速率限制中排除用户列表。 更多信息请参阅“[命令行实用程序](/enterprise/admin/configuration/command-line-utilities#ghe-config)”。 {% endif %} {% note %} diff --git a/translations/zh-CN/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md b/translations/zh-CN/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md index 0c11eb3b5151..0cbb9658b49d 100644 --- a/translations/zh-CN/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md +++ b/translations/zh-CN/content/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console.md @@ -8,7 +8,15 @@ versions: enterprise-server: '*' --- +{% note %} + +**Note:** We do not support adding additional network adapters to {% data variables.product.prodname_ghe_server %}. + +{% endnote %} + {% data reusables.enterprise_installation.open-vm-console-start %} 3. 选择配置 `IPv4` 或 `IPv6` 协议。 ![用于选择 IPv4 或 IPv6 协议的选项](/assets/images/enterprise/network-configuration/IPv4-or-IPv6-protocol.png) 4. 配置所选协议的选项。 ![含 IP 协议选项的菜单](/assets/images/enterprise/network-configuration/network-settings-selection.png) {% data reusables.enterprise_installation.vm-console-done %} + + diff --git a/translations/zh-CN/content/admin/configuration/configuring-your-enterprise.md b/translations/zh-CN/content/admin/configuration/configuring-your-enterprise.md index 0df38e6db7aa..40dfca50a838 100644 --- a/translations/zh-CN/content/admin/configuration/configuring-your-enterprise.md +++ b/translations/zh-CN/content/admin/configuration/configuring-your-enterprise.md @@ -1,5 +1,5 @@ --- -title: Configuring your enterprise +title: 配置企业 intro: '在 {% data variables.product.prodname_ghe_server %} 启动并运行后，您可以根据组织的需求对设备进行配置。' redirect_from: - /enterprise/admin/guides/installation/basic-configuration/ diff --git a/translations/zh-CN/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md b/translations/zh-CN/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md index 2e53c9a5aa3e..aed92bf9fb4f 100644 --- a/translations/zh-CN/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md +++ b/translations/zh-CN/content/admin/configuration/connecting-github-enterprise-server-to-github-enterprise-cloud.md @@ -37,12 +37,12 @@ versions: 启用 {% data variables.product.prodname_github_connect %} 将不允许 {% data variables.product.prodname_dotcom_the_website %} 用户对 {% data variables.product.prodname_ghe_server %} 进行更改。 -{% if currentVersion ver_gt "enterprise-server@2.18" %} 有关使用 GraphQL API 管理企业帐户的信息，请参阅“[企业帐户](/v4/guides/managing-enterprise-accounts)”。 -{% endif %} ### 启用 {% data variables.product.prodname_github_connect %} -1. 登录到 {% data variables.product.product_location_enterprise %} 和 {% data variables.product.prodname_dotcom_the_website %}。 +1. 登录到 + +{% data variables.product.product_location_enterprise %} 和 {% data variables.product.prodname_dotcom_the_website %}。 {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.settings-tab %} diff --git a/translations/zh-CN/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md b/translations/zh-CN/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md index ec5e2f7268ba..a14ff97b1771 100644 --- a/translations/zh-CN/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md +++ b/translations/zh-CN/content/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md @@ -1,71 +1,65 @@ --- -title: Enabling alerts for vulnerable dependencies on GitHub Enterprise Server -intro: 'You can connect {% data variables.product.product_location_enterprise %} to {% data variables.product.prodname_ghe_cloud %} and enable {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies in repositories in your instance.' +title: 为 GitHub Enterprise Server 上易受攻击的依赖项启用警报 +intro: '您可以将 {% data variables.product.product_location_enterprise %} 连接到 {% data variables.product.prodname_ghe_cloud %}，并为实例仓库中易受攻击的依赖项启用{% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}安全{% endif %}警报。' redirect_from: - /enterprise/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server - /enterprise/admin/configuration/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server - /enterprise/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server - - /enterprise/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server - - /enterprise/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server - - /enterprise/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server - - /enterprise/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server - - /enterprise/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server -permissions: 'Site administrators for {% data variables.product.prodname_ghe_server %} who are also owners of the connected {% data variables.product.prodname_ghe_cloud %} organization or enterprise account can enable {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %}.' +permissions: '{% data variables.product.prodname_ghe_server %} 的站点管理员（同时也是已连接 {% data variables.product.prodname_ghe_cloud %} 组织或企业帐户的所有者）可以为 {% data variables.product.prodname_ghe_server %} 上易受攻击的依赖项启用 {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}安全{% endif %}警报。' versions: enterprise-server: '*' --- -### About alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %} +### 关于 {% data variables.product.prodname_ghe_server %} 上易受攻击的依赖项的警报 -{% data reusables.repositories.tracks-vulnerabilities %} For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." +{% data reusables.repositories.tracks-vulnerabilities %} 更多信息请参阅“[关于易受攻击的依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)”。 -You can connect {% data variables.product.product_location_enterprise %} to {% data variables.product.prodname_dotcom_the_website %}, then sync vulnerability data to your instance and generate {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts in repositories with a vulnerable dependency. +您可以将 {% data variables.product.product_location_enterprise %} 连接到 {% data variables.product.prodname_dotcom_the_website %}，然后将漏洞数据同步到您的实例，并在包含漏洞依赖项的仓库中生成 {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}安全{% endif %}警报。 -After connecting {% data variables.product.product_location_enterprise %} to {% data variables.product.prodname_dotcom_the_website %} and enabling {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies, vulnerability data is synced from {% data variables.product.prodname_dotcom_the_website %} to your instance once every hour. You can also choose to manually sync vulnerability data at any time. No code or information about code from {% data variables.product.product_location_enterprise %} is uploaded to {% data variables.product.prodname_dotcom_the_website %}. +将 {% data variables.product.product_location_enterprise %} 连接到 {% data variables.product.prodname_dotcom_the_website %} 并为易受攻击的依赖项启用 {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}安全{% endif %}警报后，每个小时都会将漏洞数据从 {% data variables.product.prodname_dotcom_the_website %} 同步到您的实例一次。 您还可以随时选择手动同步漏洞数据。 代码和关于代码的信息不会从 {% data variables.product.product_location_enterprise %} 上传到 {% data variables.product.prodname_dotcom_the_website %}。 -{% if currentVersion ver_gt "enterprise-server@2.21" %}When {% data variables.product.product_location_enterprise %} receives information about a vulnerability, it will identify repositories in your instance that use the affected version of the dependency and send {% data variables.product.prodname_dependabot_short %} alerts to owners and people with admin access in those repositories. They can customize how they receive {% data variables.product.prodname_dependabot_short %} alerts. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/#configuring-notifications-for-github-dependabot-alerts)." +{% if currentVersion ver_gt "enterprise-server@2.21" %}当 {% data variables.product.product_location_enterprise %} 接收到有关漏洞的信息时，它将识别实例中使用受影响版本依赖项的仓库，并向这些仓库中具有管理员访问权限的所有者和人员发送 {% data variables.product.prodname_dependabot_short %} 警报。 他们可以自定义接收 {% data variables.product.prodname_dependabot_short %} 警报的方式。 更多信息请参阅“[关于易受攻击的依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/#configuring-notifications-for-github-dependabot-alerts)”。 {% endif %} -{% if currentVersion ver_lt "enterprise-server@2.21" or currentVersion == "enterprise-server@2.21" %}When {% data variables.product.product_location_enterprise %} receives information about a vulnerability, it will identify repositories in your instance that use the affected version of the dependency and send security alerts to owners and people with admin access in those repositories. They can customize how they receive security alerts. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/#configuring-notifications-for-security-alerts)." +{% if currentVersion ver_lt "enterprise-server@2.21" or currentVersion == "enterprise-server@2.21" %}当 {% data variables.product.product_location_enterprise %} 接收到有关漏洞的信息时，它将识别实例中使用受影响版本依赖项的仓库，并向这些仓库中具有管理员访问权限的所有者和人员发送安全警报。 您可以自定义接收安全警报的方式。 更多信息请参阅“[关于易受攻击的依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/#configuring-notifications-for-security-alerts)”。 {% endif %} {% if currentVersion ver_gt "enterprise-server@2.21" %} -### Enabling {% data variables.product.prodname_dependabot_short %} alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %} +### 对 {% data variables.product.prodname_ghe_server %} 上易受攻击的依赖项启用 {% data variables.product.prodname_dependabot_short %} 警报 {% else %} -### Enabling security alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %} +### 为 {% data variables.product.prodname_ghe_server %} 上易受攻击的依赖项启用安全警报 {% endif %} -Before enabling {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies on {% data variables.product.product_location_enterprise %}, you must connect {% data variables.product.product_location_enterprise %} to {% data variables.product.prodname_dotcom_the_website %}. For more information, see "[Connecting {% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_ghe_cloud %}](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)." +对 {% data variables.product.product_location_enterprise %} 上易受攻击的依赖项启用 {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}安全{% endif %}警报之前，必须将 {% data variables.product.product_location_enterprise %} 连接到 {% data variables.product.prodname_dotcom_the_website %}。 更多信息请参阅“[将 {% data variables.product.prodname_ghe_server %} 连接到 {% data variables.product.prodname_ghe_cloud %}](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)”。 -{% if currentVersion ver_gt "enterprise-server@2.20" %} +{% if currentVersion ver_gt "enterprise-server@2.20" %} -{% if currentVersion ver_gt "enterprise-server@2.21" %}We recommend configuring {% data variables.product.prodname_dependabot_short %} alerts without notifications for the first few days to avoid an overload of emails. After a few days, you can enable notifications to receive {% data variables.product.prodname_dependabot_short %} alerts as usual.{% endif %} +{% if currentVersion ver_gt "enterprise-server@2.21" %}我们建议配置前几天的 {% data variables.product.prodname_dependabot_short %} 警报不发通知，以避免电子邮件过载。 几天后，您可以开启通知，像往常一样接收 {% data variables.product.prodname_dependabot_short %} 警报。{% endif %} -{% if currentVersion == "enterprise-server@2.21" %}We recommend configuring security alerts without notifications for the first few days to avoid an overload of emails. After a few days, you can enable notifications to receive security alerts as usual.{% endif %} +{% if currentVersion == "enterprise-server@2.21" %}我们建议配置前几天的安全警报不发通知，以避免电子邮件过载。 几天后，您可以启用通知，像平常一样接收安全警报。{% endif %} {% endif %} {% data reusables.enterprise_site_admin_settings.sign-in %} -1. In the administrative shell, enable the {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies on {% data variables.product.product_location_enterprise %}: +1. 在管理 shell 中，对 {% data variables.product.product_location_enterprise %} 上易受攻击的依赖项启用 {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}安全{% endif %}警报。 ``` shell $ ghe-dep-graph-enable ``` -3. Return to {% data variables.product.prodname_ghe_server %}. +3. 返回到 +{% data variables.product.prodname_ghe_server %}. {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.github-connect-tab %}{% if currentVersion ver_gt "enterprise-server@2.20" %} -5. Under "Repositories can be scanned for vulnerabilities", use the drop-down menu and select **Enabled without notifications**. Optionally, to enable alerts with notifications, select **Enabled with notifications**.{% else %} -5. Under "Repositories can be scanned for vulnerabilities", use the drop-down menu and select **Enabled**. +5. 在“Repositories can be scanned for vulnerabilities（可扫描仓库漏洞）”下，使用下拉菜单，并选择 **Enabled without notifications（启用但不发通知）**。 （可选）要启用包含通知的警报，请选择 **Enabled with notifications（启用并发通知）**。{% else %} +5. 在“Repositories can be scanned for vulnerabilities”下，使用下拉菜单，然后选择 **Enabled**。 {% endif %} - ![Drop-down menu to enable scanning repositories for vulnerabilities](/assets/images/enterprise/site-admin-settings/enable-vulnerability-scanning-in-repositories.png) + ![用于启用扫描仓库有无漏洞的下拉菜单](/assets/images/enterprise/site-admin-settings/enable-vulnerability-scanning-in-repositories.png) -### Viewing vulnerable dependencies on {% data variables.product.prodname_ghe_server %} +### 查看 {% data variables.product.prodname_ghe_server %} 上易受攻击的依赖项 -You can view all vulnerabilities in {% data variables.product.product_location_enterprise %} and manually sync vulnerability data from {% data variables.product.prodname_dotcom_the_website %} to update the list. +您可以查看 {% data variables.product.product_location_enterprise %} 中的所有漏洞，然后手动同步 {% data variables.product.prodname_dotcom_the_website %} 中的漏洞数据，以更新列表。 {% data reusables.enterprise_site_admin_settings.access-settings %} -2. In the left sidebar, click **Vulnerabilities**. - ![Vulnerabilities tab in the site admin sidebar](/assets/images/enterprise/business-accounts/vulnerabilities-tab.png) -3. To sync vulnerability data, click **Sync Vulnerabilities now**. - ![Sync vulnerabilities now button](/assets/images/enterprise/site-admin-settings/sync-vulnerabilities-button.png) +2. 在左侧边栏中，单击 **Vulnerabilities**。 ![站点管理员边栏中的 Vulnerabilities 选项卡](/assets/images/enterprise/business-accounts/vulnerabilities-tab.png) +3. 要同步漏洞数据，请单击 **Sync Vulnerabilities now**。 ![Sync vulnerabilities now 按钮](/assets/images/enterprise/site-admin-settings/sync-vulnerabilities-button.png) diff --git a/translations/zh-CN/content/admin/configuration/enabling-subdomain-isolation.md b/translations/zh-CN/content/admin/configuration/enabling-subdomain-isolation.md index ce1c8907368f..bb868f6b6849 100644 --- a/translations/zh-CN/content/admin/configuration/enabling-subdomain-isolation.md +++ b/translations/zh-CN/content/admin/configuration/enabling-subdomain-isolation.md @@ -16,28 +16,29 @@ versions: 启用子域隔离后，{% data variables.product.prodname_ghe_server %} 会以子域替代多个路径。 {% if currentVersion ver_gt "enterprise-server@2.21" %} -To use Docker with {% data variables.product.prodname_registry %}, you must also enable subdomain isolation. For more information, see "[Configuring Docker for use with {% data variables.product.prodname_registry %}](/enterprise/{{ currentVersion }}/user/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)." +要将 Docker 与 +{% data variables.product.prodname_registry %} 一起使用，您还必须启用子域隔离。 更多信息请参阅“[配置 Docker 与 {% data variables.product.prodname_registry %} 一起使用](/enterprise/{{ currentVersion }}/user/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)”。 {% data reusables.package_registry.packages-ghes-release-stage %} | {% endif %} -| 未使用子域隔离的路径 | 使用子域隔离的路径 | -| --------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- | -| `http(s)://HOSTNAME/assets/` | `http(s)://assets.HOSTNAME/` | -| `http(s)://HOSTNAME/avatars/` | `http(s)://avatars.HOSTNAME/` | -| `http(s)://HOSTNAME/codeload/` | `http(s)://codeload.HOSTNAME/` | -| `http(s)://HOSTNAME/gist/` | `http(s)://gist.HOSTNAME/` | -| `http(s)://HOSTNAME/media/` | `http(s)://media.HOSTNAME/` | -| `http(s)://HOSTNAME/pages/` | `http(s)://pages.HOSTNAME/` | -| `http(s)://HOSTNAME/raw/` | `http(s)://raw.HOSTNAME/` | -| `http(s)://HOSTNAME/render/` | `http(s)://render.HOSTNAME/` | -| `http(s)://HOSTNAME/reply/` | `http(s)://reply.HOSTNAME/` | -| `http(s)://HOSTNAME/uploads/` | `http(s)://uploads.HOSTNAME/` |{% if currentVersion ver_gt "enterprise-server@2.21" %} -| N/A, Docker with {% data variables.product.prodname_registry %} will not work with subdomain isolation disabled. | `http(s)://uploads.HOSTNAME/` | -| `https://HOSTNAME/_registry/npm/` | `https://npm.HOSTNAME/` | -| `https://HOSTNAME/_registry/rubygems/` | `https://rubygems.HOSTNAME/` | -| `https://HOSTNAME/_registry/maven/` | `https://maven.HOSTNAME/` | -| `https://HOSTNAME/_registry/nuget/` | `https://nuget.HOSTNAME/`{% endif %} +| 未使用子域隔离的路径 | 使用子域隔离的路径 | +| ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | +| `http(s)://HOSTNAME/assets/` | `http(s)://assets.HOSTNAME/` | +| `http(s)://HOSTNAME/avatars/` | `http(s)://avatars.HOSTNAME/` | +| `http(s)://HOSTNAME/codeload/` | `http(s)://codeload.HOSTNAME/` | +| `http(s)://HOSTNAME/gist/` | `http(s)://gist.HOSTNAME/` | +| `http(s)://HOSTNAME/media/` | `http(s)://media.HOSTNAME/` | +| `http(s)://HOSTNAME/pages/` | `http(s)://pages.HOSTNAME/` | +| `http(s)://HOSTNAME/raw/` | `http(s)://raw.HOSTNAME/` | +| `http(s)://HOSTNAME/render/` | `http(s)://render.HOSTNAME/` | +| `http(s)://HOSTNAME/reply/` | `http(s)://reply.HOSTNAME/` | +| `http(s)://HOSTNAME/uploads/` | `http(s)://uploads.HOSTNAME/` |{% if currentVersion ver_gt "enterprise-server@2.21" %} +| （不适用）装有 {% data variables.product.prodname_registry %} 的 Docker 不适用于禁用的子域隔离。 | `http(s)://uploads.HOSTNAME/` | +| `https://HOSTNAME/_registry/npm/` | `https://npm.HOSTNAME/` | +| `https://HOSTNAME/_registry/rubygems/` | `https://rubygems.HOSTNAME/` | +| `https://HOSTNAME/_registry/maven/` | `https://maven.HOSTNAME/` | +| `https://HOSTNAME/_registry/nuget/` | `https://nuget.HOSTNAME/`{% endif %} ### 基本要求 diff --git a/translations/zh-CN/content/admin/configuration/index.md b/translations/zh-CN/content/admin/configuration/index.md index 8d7263e33e6a..550b88189bd3 100644 --- a/translations/zh-CN/content/admin/configuration/index.md +++ b/translations/zh-CN/content/admin/configuration/index.md @@ -1,7 +1,7 @@ --- -title: Configuring GitHub Enterprise -shortTitle: Configuring GitHub Enterprise -intro: 'Once {% data variables.product.prodname_ghe_server %} is installed and set up, you can configure the appliance to suit your organization''s needs.' +title: 配置 GitHub Enterprise +shortTitle: 配置 GitHub Enterprise +intro: '在 {% data variables.product.prodname_ghe_server %} 安装并设置后，您可以根据组织的需求对设备进行配置。' redirect_from: - /enterprise/admin/configuration versions: @@ -40,7 +40,7 @@ versions: {% topic_link_in_list /managing-connections-between-github-enterprise-server-and-github-enterprise-cloud %} {% link_in_list /connecting-github-enterprise-server-to-github-enterprise-cloud %} {% link_in_list /enabling-unified-search-between-github-enterprise-server-and-githubcom %} - {% link_in_list /enabling-unified-contributions-between-github-enterprise-server-and-githubcom %} + {% link_in_list /enabling-unified-contributions-between-github-enterprise-server-and-githubcom %} {% link_in_list /enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server %} {% link_in_list /enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud %} @@ -49,3 +49,11 @@ versions: {% topic_link_in_list /configuring-advanced-security-features %} {% link_in_list /configuring-code-scanning-for-your-appliance %} + +{% if currentVersion ver_gt "enterprise-server@2.21" %} +{% note %} + +**注：**要为您的企业配置 {% data variables.product.prodname_actions %} 或 {% data variables.product.prodname_registry %}，请参阅“[管理企业的 GitHub Actions](/admin/github-actions)”或“[管理企业的 GitHub Packages](/admin/packages)”。 + +{% endnote %} +{% endif %} diff --git a/translations/zh-CN/content/admin/configuration/network-ports.md b/translations/zh-CN/content/admin/configuration/network-ports.md index 1513132ec96e..472cba4cc493 100644 --- a/translations/zh-CN/content/admin/configuration/network-ports.md +++ b/translations/zh-CN/content/admin/configuration/network-ports.md @@ -7,7 +7,7 @@ redirect_from: - /enterprise/admin/guides/installation/network-ports-to-open/ - /enterprise/admin/installation/network-ports - /enterprise/admin/configuration/network-ports -intro: 根据您需要为管理员、最终用户和电子邮件支持显示的网络服务有选择地打开网络端口。 +intro: '根据您需要为管理员、最终用户和电子邮件支持显示的网络服务有选择地打开网络端口。' versions: enterprise-server: '*' --- @@ -16,25 +16,25 @@ versions: 需要使用一些管理端口来配置 {% data variables.product.product_location_enterprise %} 和运行某些功能。 最终用户在使用基本应用程序时不需要管理端口。 -| 端口 | 服务 | 描述 | -| -------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------- | +| 端口 | 服务 | 描述 | +| -------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------- | | 8443 | HTTPS | 基于安全 Web 的 {% data variables.enterprise.management_console %}。 进行基本安装和配置时需要。 | | 8080 | HTTP | 基于纯文本 Web 的 {% data variables.enterprise.management_console %}。 除非手动禁用 SSL，否则不需要。 | | 122 | SSH | 对 {% data variables.product.product_location_enterprise %} 进行 Shell 访问。 对来自高可用性配置中的其他所有节点的传入连接开放时需要。 默认 SSH 端口 (22) 专用于 Git 和 SSH 应用程序网络流量。 | -| 1194/UDP | VPN | 采用高可用性配置的安全复制网络隧道。 对配置中的其他所有节点开放时需要。 | -| 123/UDP | NTP | 为时间协议操作所需。 | -| 161/UDP | SNMP | 为网络监视协议操作所需。 | +| 1194/UDP | VPN | 采用高可用性配置的安全复制网络隧道。 对配置中的其他所有节点开放时需要。 | +| 123/UDP | NTP | 为时间协议操作所需。 | +| 161/UDP | SNMP | 为网络监视协议操作所需。 | ### 最终用户的应用程序端口 应用程序端口为最终用户提供 Web 应用程序和 Git 访问。 -| 端口 | 服务 | 描述 | -| ---- | ----- | ------------------------------------------- | -| 443 | HTTPS | 通过 HTTPS 访问 Web 应用程序和 Git。 | -| 80 | HTTP | 访问 Web 应用程序。 当 SSL 启用时，所有请求都会重定向到 HTTPS 端口。 | -| 22 | SSH | 通过 SSH 访问 Git。 支持对公共和私有仓库执行克隆、提取和推送操作。 | -| 9418 | Git | Git 协议端口支持通过未加密网络通信对公共仓库执行克隆和提取操作。 | +| 端口 | 服务 | 描述 | +| ---- | ----- | --------------------------------------------------------------------------------------------------- | +| 443 | HTTPS | 通过 HTTPS 访问 Web 应用程序和 Git。 | +| 80 | HTTP | 访问 Web 应用程序。 当 SSL 启用时，所有请求都会重定向到 HTTPS 端口。 | +| 22 | SSH | 通过 SSH 访问 Git。 支持对公共和私有仓库执行克隆、提取和推送操作。 | +| 9418 | Git | Git 协议端口支持通过未加密网络通信对公共仓库执行克隆和提取操作。 {% data reusables.enterprise_installation.when-9418-necessary %} {% data reusables.enterprise_installation.terminating-tls %} diff --git a/translations/zh-CN/content/admin/configuration/site-admin-dashboard.md b/translations/zh-CN/content/admin/configuration/site-admin-dashboard.md index ee262b59fd17..7dff1afe8352 100644 --- a/translations/zh-CN/content/admin/configuration/site-admin-dashboard.md +++ b/translations/zh-CN/content/admin/configuration/site-admin-dashboard.md @@ -15,7 +15,7 @@ versions: ### 搜索 -您可以在此处启动 {% data variables.enterprise.management_console %}，以管理域、身份验证和 SSL 等虚拟设备设置。 +您可以在此处启动 {{ site.data.variables.enterprise.management_console }}，以管理域、身份验证和 SSL 等虚拟设备设置。 {% else %} @@ -39,7 +39,7 @@ GitHub [趋势页面][]中的数据按每天、每周和每月的时间跨度为 默认情况下，审核日志会按时间倒序显示所有已审核操作的列表。 要对此列表进行筛选，您可以在 **Query** 文本框中输入键值对，然后单击 **Search**，如“[搜索审核日志](/enterprise/{{ currentVersion }}/admin/guides/installation/searching-the-audit-log)”所述。 -For more information on audit logging in general, see "[Audit logging](/enterprise/{{ currentVersion }}/admin/guides/installation/audit-logging)." For a full list of audited actions, see "[Audited actions](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions)." +有关一般审核日志的更多信息，请参阅“[审核日志](/enterprise/{{ currentVersion }}/admin/guides/installation/audit-logging)”。 有关审核的操作的完整列表，请参阅“[审核的操作](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions)”。 ### 报告 @@ -162,7 +162,7 @@ GitHub 的[代码搜索][]功能由 [ElasticSearch][] 提供支持。 站点管 ### 所有用户 -您可以在此查看 {% data variables.product.product_location_enterprise %} 上所有已被挂起的用户，并[发起 SSH 密钥审核](/enterprise/{{ currentVersion }}/admin/guides/user-management/auditing-ssh-keys)。 +您可以在此查看 {{ site.data.variables.product.product_location_enterprise }} 上所有已被挂起的用户，并[发起 SSH 密钥审核](/enterprise/{{ page.version }}/admin/guides/user-management/auditing-ssh-keys)。 {% endif %} diff --git a/translations/zh-CN/content/admin/configuration/troubleshooting-ssl-errors.md b/translations/zh-CN/content/admin/configuration/troubleshooting-ssl-errors.md index 824038d834de..87433dad9b9d 100644 --- a/translations/zh-CN/content/admin/configuration/troubleshooting-ssl-errors.md +++ b/translations/zh-CN/content/admin/configuration/troubleshooting-ssl-errors.md @@ -1,6 +1,6 @@ --- title: 排查 SSL 错误 -intro: 如果您的设备遇到 SSL 问题，可以采取相应措施加以解决。 +intro: '如果您的设备遇到 SSL 问题，可以采取相应措施加以解决。' redirect_from: - /enterprise/admin/articles/troubleshooting-ssl-errors/ - /enterprise/admin/categories/dns-ssl-and-subdomain-configuration/ diff --git a/translations/zh-CN/content/admin/enterprise-management/about-clustering.md b/translations/zh-CN/content/admin/enterprise-management/about-clustering.md index bc451c41c764..f058d288b2e4 100644 --- a/translations/zh-CN/content/admin/enterprise-management/about-clustering.md +++ b/translations/zh-CN/content/admin/enterprise-management/about-clustering.md @@ -14,7 +14,7 @@ versions: {% data variables.product.prodname_ghe_server %} 由一组服务组成。 在集群中，这些服务跨多个节点运行，请求在它们之间进行负载均衡。 更改会与冗余副本一起自动存储在到单独的节点上。 大多数服务与相同服务的其他实例是对等的。 这种情况的例外是 `mysql-server` 和 `redis-server` 服务。 它们使用具有一个或多个_副本_节点的单个_主_节点来操作。 -Learn more about [services required for clustering](/enterprise/{{ currentVersion }}/admin/enterprise-management/about-cluster-nodes#services-required-for-clustering). +详细了解[群集所需的服务](/enterprise/{{ currentVersion }}/admin/enterprise-management/about-cluster-nodes#services-required-for-clustering)。 ### 集群是否适合我的组织？ diff --git a/translations/zh-CN/content/admin/enterprise-management/about-geo-replication.md b/translations/zh-CN/content/admin/enterprise-management/about-geo-replication.md index 77dbd014c10c..5eaa9e076dfa 100644 --- a/translations/zh-CN/content/admin/enterprise-management/about-geo-replication.md +++ b/translations/zh-CN/content/admin/enterprise-management/about-geo-replication.md @@ -18,7 +18,7 @@ Git 请求和特定的文件服务器请求（例如 LFS 和文件上传）可 ### 限制 -将请求写入副本需要将数据发送到主设备和所有副本。 这意味着所有写入操作的性能都受限于最慢的副本{% if currentVersion ver_gt "enterprise-server@2.17" %}，虽然新的地理副本可以从现有共同位置地理副本（而不是从主设备）播种大部分数据{% endif %}。 Geo-replication 不会增大 {% data variables.product.prodname_ghe_server %} 实例的容量，也不会解决与 CPU 或内存资源不足相关的性能问题。 如果主设备处于脱机状态，则活动副本将无法满足任何读取或写入请求。 +将请求写入副本需要将数据发送到主设备和所有副本。 这意味着所有写入操作的性能都受限于最慢的副本，虽然新的地理副本可以从现有共同位置地理副本（而不是从主设备）播种大部分数据。 Geo-replication 不会增大 {% data variables.product.prodname_ghe_server %} 实例的容量，也不会解决与 CPU 或内存资源不足相关的性能问题。 如果主设备处于脱机状态，则活动副本将无法满足任何读取或写入请求。 ### 监视 Geo-replication 配置 diff --git a/translations/zh-CN/content/admin/enterprise-management/about-high-availability-configuration.md b/translations/zh-CN/content/admin/enterprise-management/about-high-availability-configuration.md index e5a7b3530f0c..2aded12074c2 100644 --- a/translations/zh-CN/content/admin/enterprise-management/about-high-availability-configuration.md +++ b/translations/zh-CN/content/admin/enterprise-management/about-high-availability-configuration.md @@ -52,7 +52,7 @@ versions: `ghe-repl-setup` 命令可将 {% data variables.product.prodname_ghe_server %} 设备置于副本备用模式。 - - 为两个设备之间的通信配置加密的 {% if currentVersion ver_gt "enterprise-server@2.17" %}WireGuard VPN{% else %}OpenVPN{% endif %} 隧道。 + - 配置加密的 WireGuard VPN 隧道以实现两台设备之间的通信。 - 配置用于复制的数据库服务并启动。 - 禁用应用程序服务。 尝试通过 HTTP、Git 或其他受支持协议访问副本将出现“设备处于副本模式”维护页面或显示错误消息。 @@ -71,8 +71,7 @@ Run `ghe-repl-start' to start replicating against the newly configured primary. `ghe-repl-start` 命令可以启用所有数据存储的主动复制。 ```shell -admin@169-254-1-2:~$ ghe-repl-start{% if currentVersion ver_lt "enterprise-server@2.18" %} -Starting OpenVPN tunnel ... {% endif %} +admin@169-254-1-2:~$ ghe-repl-start Starting MySQL replication ... Starting Redis replication ... Starting Elasticsearch replication ... @@ -144,8 +143,7 @@ Stopping Pages replication ... Stopping Git replication ... Stopping MySQL replication ... Stopping Redis replication ... -Stopping Elasticsearch replication ...{% if currentVersion ver_lt "enterprise-server@2.18" %} -Stopping OpenVPN tunnel ...{% endif %} +Stopping Elasticsearch replication ... Success: replication was stopped for all services. ``` @@ -163,8 +161,7 @@ Stopping replication ... | Stopping Git replication ... | Stopping MySQL replication ... | Stopping Redis replication ... - | Stopping Elasticsearch replication ...{% if currentVersion ver_lt "enterprise-server@2.18" %} - | Stopping OpenVPN tunnel ...{% endif %} + | Stopping Elasticsearch replication ... | Success: replication was stopped for all services. Switching out of replica mode ... | Success: Replication configuration has been removed. diff --git a/translations/zh-CN/content/admin/enterprise-management/accessing-the-monitor-dashboard.md b/translations/zh-CN/content/admin/enterprise-management/accessing-the-monitor-dashboard.md index 4f6751b66edd..603eb7860dc2 100644 --- a/translations/zh-CN/content/admin/enterprise-management/accessing-the-monitor-dashboard.md +++ b/translations/zh-CN/content/admin/enterprise-management/accessing-the-monitor-dashboard.md @@ -24,10 +24,10 @@ versions: 使用监视仪表板实时了解设备资源健康状况并确定如何解决高利用率问题。 -| 问题 | 可能原因 | 建议 | -| ---------- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| CPU 利用率高 | 在同一主机上运行的其他服务或程序争用 VM | 如有可能，请将其他服务或程序重新配置为占用较少的 CPU 资源。 要增加 VM 的总 CPU 资源，请参阅“[增加 CPU 或内存资源](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)”。 | -| 内存使用量高 | 在同一主机上运行的其他服务或程序争用 VM | 如有可能，请将其他服务或程序重新配置为占用较少内存。 要增加 VM 上可用的总内存大小，请参阅“[增加 CPU 或内存资源](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)”。 | -| 可用磁盘空间小 | 较大的二进制或日志文件占用磁盘空间 | 如有可能，请在独立服务器上托管较大的二进制文件，并压缩或存档日志文件。 如有必要，请按“[增加存储容量](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity/)”中的步骤操作，为您的平台增加 VM 的磁盘空间。 | -| 响应时间较正常时间长 | 通常是上述问题之一造成的 | 确定并解决根本问题。 如果响应时间仍较长，请联系 {% data variables.contact.contact_ent_support %}。 | +| 问题 | 可能原因 | 建议 | +| ---------- | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| CPU 利用率高 | 在同一主机上运行的其他服务或程序争用 VM | 如有可能，请将其他服务或程序重新配置为占用较少的 CPU 资源。 要增加 VM 的总 CPU 资源，请参阅“[增加 CPU 或内存资源](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)”。 | +| 内存使用量高 | 在同一主机上运行的其他服务或程序争用 VM | 如有可能，请将其他服务或程序重新配置为占用较少内存。 要增加 VM 上可用的总内存大小，请参阅“[增加 CPU 或内存资源](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)”。 | +| 可用磁盘空间小 | 较大的二进制或日志文件占用磁盘空间 | 如有可能，请在独立服务器上托管较大的二进制文件，并压缩或存档日志文件。 如有必要，请按“[增加存储容量](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity/)”中的步骤操作，为您的平台增加 VM 的磁盘空间。 | +| 响应时间较正常时间长 | 通常是上述问题之一造成的 | 确定并解决根本问题。 如果响应时间仍较长，请联系 {% data variables.contact.contact_ent_support %}。 | | 错误率提高 | 软件问题 | 联系 {% data variables.contact.contact_ent_support %} 并附上支持包。 更多信息请参阅“[向 {% data variables.product.prodname_enterprise %} Support 提供数据](/enterprise/{{ currentVersion}}/admin/guides/enterprise-support/providing-data-to-github-support#creating-and-sharing-support-bundles)”。 | diff --git a/translations/zh-CN/content/admin/enterprise-management/cluster-network-configuration.md b/translations/zh-CN/content/admin/enterprise-management/cluster-network-configuration.md index 7e57eeea9b8d..1237decc4117 100644 --- a/translations/zh-CN/content/admin/enterprise-management/cluster-network-configuration.md +++ b/translations/zh-CN/content/admin/enterprise-management/cluster-network-configuration.md @@ -10,9 +10,9 @@ versions: ### 网络考虑因素 -对于集群而言，最简单的网络设计是将节点置于单个 LAN 上。 If a cluster must span subnets, we do not recommend configuring any firewall rules between the networks. The latency between nodes should be less than 1 millisecond. +对于集群而言，最简单的网络设计是将节点置于单个 LAN 上。 如果群集必须跨子网，我们不建议在网络之间配置任何防火墙规则。 节点之间的延迟应小于 1 毫秒。 -{% if currentVersion ver_gt "enterprise-server@2.21" %}For high availability, the latency between the network with the active nodes and the network with the passive nodes must be less than 70 milliseconds. We don't recommend configuring a firewall between the two networks.{% endif %} +{% if currentVersion ver_gt "enterprise-server@2.21" %}为获取高可用性，具有主动节点的网络与具有被动节点的网络之间的延迟必须小于 70 毫秒。 我们不建议在两个网络之间配置防火墙。{% endif %} #### 最终用户的应用程序端口 @@ -71,7 +71,6 @@ versions: | 8302/UDP | Consul | | 25827/UDP | Collectd | - ### 配置负载均衡器 我们建议使用基于 TCP 的外部负载均衡器，它支持 PROXY 协议来跨节点分配流量。 请考虑以下负载均衡器配置： diff --git a/translations/zh-CN/content/admin/enterprise-management/configuring-clustering.md b/translations/zh-CN/content/admin/enterprise-management/configuring-clustering.md index 86836c9b0fbd..c656f0a24873 100644 --- a/translations/zh-CN/content/admin/enterprise-management/configuring-clustering.md +++ b/translations/zh-CN/content/admin/enterprise-management/configuring-clustering.md @@ -1,5 +1,5 @@ --- -title: Configuring clustering +title: 配置群集 intro: 了解具有高可用性的集群和差异。 redirect_from: - /enterprise/admin/clustering/setting-up-the-cluster-instances diff --git a/translations/zh-CN/content/admin/enterprise-management/configuring-collectd.md b/translations/zh-CN/content/admin/enterprise-management/configuring-collectd.md index 18b1cff830e8..4ffa9a5a37da 100644 --- a/translations/zh-CN/content/admin/enterprise-management/configuring-collectd.md +++ b/translations/zh-CN/content/admin/enterprise-management/configuring-collectd.md @@ -53,6 +53,6 @@ ssh -p 122 admin@[hostname] -- 'ghe-export-graphs' && scp -P 122 admin@[hostname #### 中央 collectd 服务器未收到数据 -{% data variables.product.prodname_enterprise %} ships with `collectd` version 5.x. `collectd` 5.x is not backwards compatible with the 4.x release series. 中央 `collectd` 服务器的版本至少需要是 5.x 才能接受从 {% data variables.product.product_location_enterprise %} 发送的数据。 +{% data variables.product.prodname_enterprise %} 随附 `collectd` 版本 5.x。 `collectd` 5.x 不能后向兼容 4.x 发行版系列。 中央 `collectd` 服务器的版本至少需要是 5.x 才能接受从 {% data variables.product.product_location_enterprise %} 发送的数据。 要获取其他问题的帮助，请联系 {% data variables.contact.contact_ent_support %}。 diff --git a/translations/zh-CN/content/admin/enterprise-management/configuring-high-availability-replication-for-a-cluster.md b/translations/zh-CN/content/admin/enterprise-management/configuring-high-availability-replication-for-a-cluster.md index 635bce24a171..902f80f5f05c 100644 --- a/translations/zh-CN/content/admin/enterprise-management/configuring-high-availability-replication-for-a-cluster.md +++ b/translations/zh-CN/content/admin/enterprise-management/configuring-high-availability-replication-for-a-cluster.md @@ -1,6 +1,6 @@ --- -title: Configuring high availability replication for a cluster -intro: 'You can configure a passive replica of your entire {% data variables.product.prodname_ghe_server %} cluster in a different location, allowing your cluster to fail over to redundant nodes.' +title: 为群集配置高可用性复制 +intro: '您可以在不同的位置配置整个 {% data variables.product.prodname_ghe_server %} 群集的被动副本，允许群集故障转移至冗余节点。' miniTocMaxHeadingLevel: 4 redirect_from: - /enterprise/admin/enterprise-management/configuring-high-availability-replication-for-a-cluster @@ -8,49 +8,49 @@ versions: enterprise-server: '>2.21' --- -### About high availability replication for clusters +### 关于集群的高可用性复制 -You can configure a cluster deployment of {% data variables.product.prodname_ghe_server %} for high availability, where an identical set of passive nodes sync with the nodes in your active cluster. If hardware or software failures affect the datacenter with your active cluster, you can manually fail over to the replica nodes and continue processing user requests without data loss. +您可以配置 {% data variables.product.prodname_ghe_server %} 的群集部署以实现高可用性，其中一组相同的被动节点与活动群集中的节点同步。 如果硬件或软件故障影响具有活动群集的数据中心，您可以手动故障转移到副本节点，继续处理用户请求，而不会丢失数据。 -In high availability mode, each active node syncs regularly with a corresponding passive node. The passive node runs in standby and does not serve applications or process user requests. +在高可用性模式下，每个活动节点定期与相应的被动节点同步。 被动节点在待机状态下运行，不服务于应用程序或处理用户请求。 -We recommend configuring high availability as a part of a comprehensive disaster recovery plan for {% data variables.product.prodname_ghe_server %}. We also recommend performing regular backups. 更多信息请参阅“[在设备上配置备份](/enterprise/admin/configuration/configuring-backups-on-your-appliance)”。 +我们建议配置高可用性，作为 {% data variables.product.prodname_ghe_server %} 全面灾难恢复计划的一部分。 我们还建议进行定期备份。 更多信息请参阅“[在设备上配置备份](/enterprise/admin/configuration/configuring-backups-on-your-appliance)”。 ### 基本要求 -#### Hardware and software +#### 硬件和软件 -For each existing node in your active cluster, you'll need to provision a second virtual machine with identical hardware resources. For example, if your cluster has 11 nodes and each node has 12 vCPUs, 96 GB of RAM, and 750 GB of attached storage, you must provision 11 new virtual machines that each have 12 vCPUs, 64 GB of RAM, and 750 GB of attached storage. +对于活动群集中的每个现有节点，都需要预配第二个具有相同硬件资源的虚拟机。 例如，如果您的群集有 11 个节点，并且每个节点有 12 个 vCP、96 GB 的 RAM 和 750 GB 的附加存储，则必须预配 11 个新虚拟机，每个虚拟机具有 12 个 vCP、64 GB 的 RAM 和 750 GB 的附加存储。 -On each new virtual machine, install the same version of {% data variables.product.prodname_ghe_server %} that runs on the nodes in your active cluster. You don't need to upload a license or perform any additional configuration. 更多信息请参阅“[设置 {% data variables.product.prodname_ghe_server %} 实例](/enterprise/admin/installation/setting-up-a-github-enterprise-server-instance)”。 +在每个新虚拟机上，安装活动群集的节点上运行的相同版本 {% data variables.product.prodname_ghe_server %}。 您不需要上传许可证或执行任何其他配置。 更多信息请参阅“[设置 {% data variables.product.prodname_ghe_server %} 实例](/enterprise/admin/installation/setting-up-a-github-enterprise-server-instance)”。 {% note %} -**Note**: The nodes that you intend to use for high availability replication should be standalone {% data variables.product.prodname_ghe_server %} instances. Don't initialize the passive nodes as a second cluster. +**注**：您打算用于高可用性副本的节点应该是独立的 {% data variables.product.prodname_ghe_server %} 实例。 不要将被动节点初始化为第二个群集。 {% endnote %} #### 网络 -You must assign a static IP address to each new node that you provision, and you must configure a load balancer to accept connections and direct them to the nodes in your cluster's front-end tier. +您必须为预配的每个新节点分配一个静态 IP 地址，并且必须配置负载均衡器以接受连接，并将其引导到群集前端层中的节点。 -We don't recommend configuring a firewall between the network with your active cluster and the network with your passive cluster. The latency between the network with the active nodes and the network with the passive nodes must be less than 70 milliseconds. For more information about network connectivity between nodes in the passive cluster, see "[Cluster network configuration](/enterprise/admin/enterprise-management/cluster-network-configuration)." +我们不建议在具有主动群集的网络和具有被动群集的网络之间配置防火墙。 具有主动节点的网络与具有被动节点的网络之间的延迟必须小于 70 毫秒。 有关被动群集中节点之间网络连接的信息，请参阅“[群集网络配置](/enterprise/admin/enterprise-management/cluster-network-configuration)”。 -### Creating a high availability replica for a cluster +### 为群集创建高可用性副本 -- [Assigning active nodes to the primary datacenter](#assigning-active-nodes-to-the-primary-datacenter) -- [Adding passive nodes to the cluster configuration file](#adding-passive-nodes-to-the-cluster-configuration-file) -- [Example configuration](#example-configuration) +- [将主动节点分配到主数据中心](#assigning-active-nodes-to-the-primary-datacenter) +- [将被动节点添加到群集配置文件](#adding-passive-nodes-to-the-cluster-configuration-file) +- [示例配置](#example-configuration) -#### Assigning active nodes to the primary datacenter +#### 将主动节点分配到主数据中心 -Before you define a secondary datacenter for your passive nodes, ensure that you assign your active nodes to the primary datacenter. +在为被动节点定义辅助数据中心之前，请确保将活动节点分配给主数据中心。 {% data reusables.enterprise_clustering.ssh-to-a-node %} {% data reusables.enterprise_clustering.open-configuration-file %} -3. Note the name of your cluster's primary datacenter. The `[cluster]` section at the top of the cluster configuration file defines the primary datacenter's name, using the `primary-datacenter` key-value pair. By default, the primary datacenter for your cluster is named `default`. +3. 记下群集主数据中心的名称。 群集配置文件顶部的 `[cluster]` 部分使用 `primary-datacenter` 键值对定义主数据中心的名称。 默认情况下，群集的主要数据中心名称为 `default`。 ```shell [cluster] @@ -59,13 +59,13 @@ Before you define a secondary datacenter for your passive nodes, ensure that you primary-datacenter = default ``` - - Optionally, change the name of the primary datacenter to something more descriptive or accurate by editing the value of `primary-datacenter`. + - （可选）通过编辑 `primary-datacenter` 的值，将主数据中心的名称更改为更具描述性或更准确的值。 -4. {% data reusables.enterprise_clustering.configuration-file-heading %} Under each node's heading, add a new key-value pair to assign the node to a datacenter. Use the same value as `primary-datacenter` from step 3 above. For example, if you want to use the default name (`default`), add the following key-value pair to the section for each node. +4. {% data reusables.enterprise_clustering.configuration-file-heading %} 在每个节点标题下，添加新的键值对，以将节点分配给数据中心。 使用与上述步骤 3 的 `primary-datacenter` 相同的值。 例如，如果要使用默认名称 (`default`)，请将以下键值对添加到每个节点的部分。 datacenter = default - When you're done, the section for each node in the cluster configuration file should look like the following example. {% data reusables.enterprise_clustering.key-value-pair-order-irrelevant %} + 完成后，群集配置文件中每个节点的部分应如下所示。 {% data reusables.enterprise_clustering.key-value-pair-order-irrelevant %} ```shell [cluster "HOSTNAME"] @@ -78,7 +78,7 @@ Before you define a secondary datacenter for your passive nodes, ensure that you {% note %} - **Note**: If you changed the name of the primary datacenter in step 3, find the `consul-datacenter` key-value pair in the section for each node and change the value to the renamed primary datacenter. For example, if you named the primary datacenter `primary`, use the following key-value pair for each node. + **注**：如果在步骤 3 中更改了主数据中心的名称，请在每个节点的部分找到 `consul-datacenter` 键值对，然后将值更改为重命名的主数据中心。 例如，如果您将主数据中心命名为 `primary`，则对每个节点使用以下键值对。 consul-datacenter = primary @@ -88,66 +88,66 @@ Before you define a secondary datacenter for your passive nodes, ensure that you {% data reusables.enterprise_clustering.configuration-finished %} -After {% data variables.product.prodname_ghe_server %} returns you to the prompt, you've finished assigning your nodes to the cluster's primary datacenter. +在 {% data variables.product.prodname_ghe_server %} 返回提示符，您已完成将节点分配给群集的主数据中心。 -#### Adding passive nodes to the cluster configuration file +#### 将被动节点添加到群集配置文件 -To configure high availability, you must define a corresponding passive node for every active node in your cluster. The following instructions create a new cluster configuration that defines both active and passive nodes. You will: +要配置高可用性，必须为群集中的每个主动节点定义相应的被动节点。 以下说明创建用于定义主动节点和被动节点的新群集配置。 您将： -- Create a copy of the active cluster configuration file. -- Edit the copy to define passive nodes that correspond to the active nodes, adding the IP addresses of the new virtual machines that you provisioned. -- Merge the modified copy of the cluster configuration back into your active configuration. -- Apply the new configuration to start replication. +- 创建主动群集配置文件的副本。 +- 编辑副本以定义与主动节点对应的被动节点，添加预配的新虚拟机的 IP 地址。 +- 将群集配置的修改副本合并回主动配置。 +- 应用新配置以开始复制。 -For an example configuration, see "[Example configuration](#example-configuration)." +关于示例配置，请参阅“[示例配置](#example-configuration)”。 -1. For each node in your cluster, provision a matching virtual machine with identical specifications, running the same version of {% data variables.product.prodname_ghe_server %}. Note the IPv4 address and hostname for each new cluster node. For more information, see "[Prerequisites](#prerequisites)." +1. 对于群集中的每个节点，预配规范相同的匹配虚拟机，运行相同版本的 {% data variables.product.prodname_ghe_server %}。 记下每个新群集节点的 IPv4 地址和主机名。 更多信息请参阅“[先决条件](#prerequisites)”。 {% note %} - **Note**: If you're reconfiguring high availability after a failover, you can use the old nodes from the primary datacenter instead. + **注**：如果在故障转移后重新配置高可用性，可以改为使用主数据中心的旧节点。 {% endnote %} {% data reusables.enterprise_clustering.ssh-to-a-node %} -3. Back up your existing cluster configuration. +3. 备份现有群集配置。 cp /data/user/common/cluster.conf ~/$(date +%Y-%m-%d)-cluster.conf.backup -4. Create a copy of your existing cluster configuration file in a temporary location, like _/home/admin/cluster-passive.conf_. Delete unique key-value pairs for IP addresses (`ipv*`), UUIDs (`uuid`), and public keys for WireGuard (`wireguard-pubkey`). +4. 在临时位置创建现有群集配置文件的副本，如 _/home/admin/cluster-passive.conf_。 删除 IP 地址的唯一键值对 (`ipv*`)、UUID (`uuid`) 和 WireGuard 的公钥 (`wireguard-pubkey`)。 grep -Ev "(?:|ipv|uuid|vpn|wireguard\-pubkey)" /data/user/common/cluster.conf > ~/cluster-passive.conf -5. Remove the `[cluster]` section from the temporary cluster configuration file that you copied in the previous step. +5. 从上一步复制的临时群集配置文件中删除 `[cluster]` 部分。 git config -f ~/cluster-passive.conf --remove-section cluster -6. Decide on a name for the secondary datacenter where you provisioned your passive nodes, then update the temporary cluster configuration file with the new datacenter name. Replace `SECONDARY` with the name you choose. +6. 确定在其中预配了被动节点的辅助数据中心的名称，然后使用新的数据中心名称更新临时群集配置文件。 将 `SECONDARY` 替换为您选择的名称。 ```shell sed -i 's/datacenter = default/datacenter = SECONDARY/g' ~/cluster-passive.conf ``` -7. Decide on a pattern for the passive nodes' hostnames. +7. 确定被动节点主机名的模式。 {% warning %} - **Warning**: Hostnames for passive nodes must be unique and differ from the hostname for the corresponding active node. + **警告**：被动节点的主机名必须是唯一的，并且与对应主动节点的主机名不同。 {% endwarning %} -8. Open the temporary cluster configuration file from step 3 in a text editor. For example, you can use Vim. +8. 在文本编辑器中打开步骤 3 中的临时群集配置文件。 例如，您可以使用 Vim。 ```shell sudo vim ~/cluster-passive.conf ``` -9. In each section within the temporary cluster configuration file, update the node's configuration. {% data reusables.enterprise_clustering.configuration-file-heading %} +9. 在临时群集配置文件中的每个部分，更新节点的配置。 {% data reusables.enterprise_clustering.configuration-file-heading %} - - Change the quoted hostname in the section heading and the value for `hostname` within the section to the passive node's hostname, per the pattern you chose in step 7 above. - - Add a new key named `ipv4`, and set the value to the passive node's static IPv4 address. - - Add a new key-value pair, `replica = enabled`. + - 根据上面步骤 7 中选择的模式，将部分标题中引用的主机名和部分中 `hostname` 的值更改为被动节点的主机名。 + - 新增一个名为 `ipv4` 的密钥，并将值设置为被动节点的静态 IPv4 地址。 + - 新增键值对 `replica = enabled`。 ```shell [cluster "NEW PASSIVE NODE HOSTNAME"] @@ -159,20 +159,20 @@ For an example configuration, see "[Example configuration](#example-configuratio ... ``` -10. Append the contents of the temporary cluster configuration file that you created in step 4 to the active configuration file. +10. 将步骤 4 中创建的临时群集配置文件的内容附加到活动的配置文件。 ```shell cat ~/cluster-passive.conf >> /data/user/common/cluster.conf ``` -11. Designate the primary MySQL and Redis nodes in the secondary datacenter. Replace `REPLICA MYSQL PRIMARY HOSTNAME` and `REPLICA REDIS PRIMARY HOSTNAME` with the hostnames of the passives node that you provisioned to match your existing MySQL and Redis primaries. +11. 在辅助数据中心中指定主 MySQL 和 Redis 节点。 将 `REPLICA MYSQL PRIMARY HOSTNAME` 和 `REPLICA REDIS PRIMARY HOSTNAME` 替换为您预配的被动节点的主机名，以匹配您现有的 MySQL 和 Redis 主节点。 ```shell git config -f /data/user/common/cluster.conf cluster.mysql-master-replica REPLICA MYSQL PRIMARY HOSTNAME git config -f /data/user/common/cluster.conf cluster.redis-master-replica REPLICA REDIS PRIMARY HOSTNAME ``` -12. Enable MySQL to fail over automatically when you fail over to the passive replica nodes. +12. 启用 MySQL 在故障转移到被动副本节点时自动故障转移。 ```shell git config -f /data/user/common/cluster.conf cluster.mysql-auto-failover true @@ -180,31 +180,31 @@ For an example configuration, see "[Example configuration](#example-configuratio {% warning %} - **Warning**: Review your cluster configuration file before proceeding. + **警告**：在继续操作之前查看群集配置文件。 - - In the top-level `[cluster]` section, ensure that the values for `mysql-master-replica` and `redis-master-replica` are the correct hostnames for the passive nodes in the secondary datacenter that will serve as the MySQL and Redis primaries after a failover. - - In each section for an active node named `[cluster "ACTIVE NODE HOSTNAME"]`, double-check the following key-value pairs. - - `datacenter` should match the value of `primary-datacenter` in the top-level `[cluster]` section. - - `consul-datacenter` should match the value of `datacenter`, which should be the same as the value for `primary-datacenter` in the top-level `[cluster]` section. - - Ensure that for each active node, the configuration has **one** corresponding section for **one** passive node with the same roles. In each section for a passive node, double-check each key-value pair. - - `datacenter` should match all other passive nodes. - - `consul-datacenter` should match all other passive nodes. - - `hostname` should match the hostname in the section heading. - - `ipv4` should match the node's unique, static IPv4 address. - - `replica` should be configured as `enabled`. - - Take the opportunity to remove sections for offline nodes that are no longer in use. + - 在顶层 `[cluster]` 部分中，确保 `mysql-master-replica` 和 `redis-master-replica` 的值，是辅助数据中心中在故障转移后用作 MySQL 和 Redis 主节点的被动节点的正确主机名。 + - 在名为 `[cluster "ACTIVE NODE HOSTNAME"]` 的主动节点的每个部分中，双击以下键值对。 + - `datacenter` 应匹配顶层 `[cluster]` 部分中 `primary-datacenter` 的值。 + - `consul-datacenter` 应匹配 `datacenter` 的值，应与顶层 `[cluster]` 部分中 `primary-datacenter` 的值相同。 + - 确保对于每个主动节点，配置都有**一个**部分对应**一个**具有相同角色的被动节点。 在被动节点的每个部分中，仔细检查每个键值对。 + - `datacenter` 应匹配所有其他被动节点。 + - `consul-datacenter` 应匹配所有其他被动节点。 + - `hostname` 应匹配部分标题中的主机名。 + - `ipv4` 应匹配节点唯一的静态 IPv4 地址。 + - `replica` 应配置为 `enabled`。 + - 利用机会删除已经不再使用的离线节点的部分。 - To review an example configuration, see "[Example configuration](#example-configuration)." + 要查看示例配置，请参阅“[示例配置](#example-configuration)”。 {% endwarning %} -13. Initialize the new cluster configuration. {% data reusables.enterprise.use-a-multiplexer %} +13. 初始化新群集配置。 {% data reusables.enterprise.use-a-multiplexer %} ```shell ghe-cluster-config-init ``` -14. After the initialization finishes, {% data variables.product.prodname_ghe_server %} displays the following message. +14. 初始化完成后，{% data variables.product.prodname_ghe_server %} 将显示以下消息。 ```shell Finished cluster initialization @@ -214,13 +214,13 @@ For an example configuration, see "[Example configuration](#example-configuratio {% data reusables.enterprise_clustering.configuration-finished %} -17. Configure a load balancer that will accept connections from users if you fail over to the passive nodes. For more information, see "[Cluster network configuration](/enterprise/admin/enterprise-management/cluster-network-configuration#configuring-a-load-balancer)." +17. 配置负载均衡器，如果故障转移到被动节点，该均衡器将接受来自用户的连接。 更多信息请参阅“[群集网络配置](/enterprise/admin/enterprise-management/cluster-network-configuration#configuring-a-load-balancer)”。 -You've finished configuring high availability replication for the nodes in your cluster. Each active node begins replicating configuration and data to its corresponding passive node, and you can direct traffic to the load balancer for the secondary datacenter in the event of a failure. For more information about failing over, see "[Initiating a failover to your replica cluster](/enterprise/admin/enterprise-management/initiating-a-failover-to-your-replica-cluster)." +您已完成为群集中的节点配置高可用性副本。 每个主动节点开始将配置和数据复制到其对应的被动节点，并且您可以在发生故障时将流量直接引导至辅助数据中心的负载均衡器。 有关故障转移的更多信息，请参阅“[发起到副本群集的故障转移](/enterprise/admin/enterprise-management/initiating-a-failover-to-your-replica-cluster)”。 -#### Example configuration +#### 示例配置 -The top-level `[cluster]` configuration should look like the following example. +顶级 `[cluster]` 配置应如下所示。 ```shell [cluster] @@ -233,7 +233,7 @@ The top-level `[cluster]` configuration should look like the following example. ... ``` -The configuration for an active node in your cluster's storage tier should look like the following example. +群集存储层中主动节点的配置应如下所示。 ```shell ... @@ -257,11 +257,11 @@ The configuration for an active node in your cluster's storage tier should look ... ``` -The configuration for the corresponding passive node in the storage tier should look like the following example. +存储层中对应的被动节点的配置应如下所示。 -- Important differences from the corresponding active node are **bold**. -- {% data variables.product.prodname_ghe_server %} assigns values for `vpn`, `uuid`, and `wireguard-pubkey` automatically, so you shouldn't define the values for passive nodes that you will initialize. -- The server roles, defined by `*-server` keys, match the corresponding active node. +- 与对应主动节点的重要差别以**粗体**显示。 +- {% data variables.product.prodname_ghe_server %} 为 `vpn`、`uuid` 和 `wireeguard-pubkey` 分配值，因此您不应该定义要初始化的被动节点的值。 +- 由 `*-server` 键定义的服务器角色匹配对应的主动节点。 ```shell ... @@ -286,59 +286,59 @@ The configuration for the corresponding passive node in the storage tier should ... ``` -### Monitoring replication between active and passive cluster nodes +### 监控主动与被动群集节点之间的复制 -Initial replication between the active and passive nodes in your cluster takes time. The amount of time depends on the amount of data to replicate and the activity levels for {% data variables.product.prodname_ghe_server %}. +群集中主动节点与被动节点之间的初始复制需要时间。 时间量取决于要复制的数据量和 {% data variables.product.prodname_ghe_server %} 的活动水平。 -You can monitor the progress on any node in the cluster, using command-line tools available via the {% data variables.product.prodname_ghe_server %} administrative shell. For more information about the administrative shell, see "[Accessing the administrative shell (SSH)](/enterprise/admin/configuration/accessing-the-administrative-shell-ssh)." +您可以通过 {% data variables.product.prodname_ghe_server %} 系统管理 shell 使用命令行工具监控群集中任何节点的进度。 有关系统管理 shell 的更多信息，请参阅“[访问管理 shell (SSH)](/enterprise/admin/configuration/accessing-the-administrative-shell-ssh)。” -- Monitor replication of databases: +- 监控数据库的复制： /usr/local/share/enterprise/ghe-cluster-status-mysql -- Monitor replication of repository and Gist data: +- 监控仓库和 Gist 数据的复制： ghe-spokes status -- Monitor replication of attachment and LFS data: +- 监控附件和 LFS 数据的复制： ghe-storage replication-status -- Monitor replication of Pages data: +- 监控 Pages 数据的复制： ghe-dpages replication-status -You can use `ghe-cluster-status` to review the overall health of your cluster. For more information, see "[Command-line utilities](/enterprise/admin/configuration/command-line-utilities#ghe-cluster-status)." +您可以使用 `ghe-cluster-status` 来审查群集的总体健康状况。 更多信息请参阅“[命令行实用程序](/enterprise/admin/configuration/command-line-utilities#ghe-cluster-status)”。 -### Reconfiguring high availability replication after a failover +### 故障转移后重新配置高可用性复制 -After you fail over from the cluster's active nodes to the cluster's passive nodes, you can reconfigure high availability replication in two ways. +从群集的产动节点故障转移到群集的被动节点后，您可以通过两种方式重新配置高可用性副本。 -#### Provisioning and configuring new passive nodes +#### 预配和配置新的被动节点 -After a failover, you can reconfigure high availability in two ways. The method you choose will depend on the reason that you failed over, and the state of the original active nodes. +故障转移后，您可以通过两种方式重新配置高可用性。 选择的方法将取决于故障转移的原因以及原始主动节点的状态。 -1. Provision and configure a new set of passive nodes for each of the new active nodes in your secondary datacenter. +1. 为辅助数据中心中的每个新主动节点预配和配置一组新的被动节点。 -2. Use the old active nodes as the new passive nodes. +2. 将旧的主动节点用作新的被动节点。 -The process for reconfiguring high availability is identical to the initial configuration of high availability. For more information, see "[Creating a high availability replica for a cluster](#creating-a-high-availability-replica-for-a-cluster)." +重新配置高可用性的过程与高可用性的初始配置相同。 更多信息请参阅“[为群集创建高可用性复制](#creating-a-high-availability-replica-for-a-cluster)”。 -### Disabling high availability replication for a cluster +### 禁用群集的高可用性复制 -You can stop replication to the passive nodes for your cluster deployment of {% data variables.product.prodname_ghe_server %}. +您可以停止复制到 {% data variables.product.prodname_ghe_server %} 群集部署的被动节点。 {% data reusables.enterprise_clustering.ssh-to-a-node %} {% data reusables.enterprise_clustering.open-configuration-file %} -3. In the top-level `[cluster]` section, delete the `mysql-auto-failover`, `redis-master-replica`, and `mysql-master-replica` key-value pairs. +3. 在顶层 `[cluster]` 部分，删除 `mysql-auto-failover`、`redis-master-replica` 和 `mysql-master-replica` 键值对。 -4. Delete each section for a passive node. For passive nodes, `replica` is configured as `enabled`. +4. 删除被动节点的每个部分。 对于被动节点，`replica` 配置为 `enabled`。 {% data reusables.enterprise_clustering.apply-configuration %} {% data reusables.enterprise_clustering.configuration-finished %} -After {% data variables.product.prodname_ghe_server %} returns you to the prompt, you've finished disabling high availability replication. +在 {% data variables.product.prodname_ghe_server %} 返回提示后，您已完成禁用高可用性复制操作。 diff --git a/translations/zh-CN/content/admin/enterprise-management/configuring-high-availability.md b/translations/zh-CN/content/admin/enterprise-management/configuring-high-availability.md index ac419025fdc4..44032f34f0f3 100644 --- a/translations/zh-CN/content/admin/enterprise-management/configuring-high-availability.md +++ b/translations/zh-CN/content/admin/enterprise-management/configuring-high-availability.md @@ -1,5 +1,5 @@ --- -title: Configuring high availability +title: 配置高可用性 redirect_from: - /enterprise/admin/installation/configuring-github-enterprise-server-for-high-availability - /enterprise/admin/guides/installation/high-availability-cluster-configuration/ diff --git a/translations/zh-CN/content/admin/enterprise-management/creating-a-high-availability-replica.md b/translations/zh-CN/content/admin/enterprise-management/creating-a-high-availability-replica.md index f33ac3236c21..d594a29fb7d5 100644 --- a/translations/zh-CN/content/admin/enterprise-management/creating-a-high-availability-replica.md +++ b/translations/zh-CN/content/admin/enterprise-management/creating-a-high-availability-replica.md @@ -1,6 +1,6 @@ --- title: 创建高可用性副本 -intro: 在主动/被动配置中，副本设备是主设备的冗余副本。 如果主设备发生故障，高可用性模式允许副本作为主设备运行，从而最大限度地减少服务中断。 +intro: '在主动/被动配置中，副本设备是主设备的冗余副本。 如果主设备发生故障，高可用性模式允许副本作为主设备运行，从而最大限度地减少服务中断。' redirect_from: - /enterprise/admin/installation/creating-a-high-availability-replica - /enterprise/admin/enterprise-management/creating-a-high-availability-replica @@ -49,7 +49,7 @@ versions: (replica2)$ ghe-repl-setup --add PRIMARY IP (replica2)$ ghe-repl-start ``` -3. 默认情况下，副本被配置到同一个数据中心{% if currentVersion ver_gt "enterprise-server@2.17" %}，现在将尝试从同一个数据中心中的现有节点播种{% endif %}。 为数据中心选项设置不同的值，通过这种方式为不同的数据中心配置副本。 可以随意设定特定值，只要数值彼此不同即可。 在每个节点上运行 `ghe-repl-node` 命令并指定数据中心。 +3. 默认情况下，副本被配置到同一个数据中心，现在将尝试从同一个数据中心中的现有节点播种。 为数据中心选项设置不同的值，通过这种方式为不同的数据中心配置副本。 可以随意设定特定值，只要数值彼此不同即可。 在每个节点上运行 `ghe-repl-node` 命令并指定数据中心。 在主设备上： ```shell diff --git a/translations/zh-CN/content/admin/enterprise-management/differences-between-clustering-and-high-availability-ha.md b/translations/zh-CN/content/admin/enterprise-management/differences-between-clustering-and-high-availability-ha.md index cdd8873f07d3..2bdb1f5adacb 100644 --- a/translations/zh-CN/content/admin/enterprise-management/differences-between-clustering-and-high-availability-ha.md +++ b/translations/zh-CN/content/admin/enterprise-management/differences-between-clustering-and-high-availability-ha.md @@ -1,5 +1,5 @@ --- -title: Differences between clustering and high availability (HA) +title: 配置群集与高可用性 (HA) 之间的差异 intro: '{% data variables.product.prodname_ghe_server %} 高可用性配置 (HA) 是一种可提供冗余功能的主设备/辅助设备故障切换配置，而集群则通过在多个节点之间分配读写负载来提供冗余和可扩展性。' redirect_from: - /enterprise/admin/clustering/differences-between-clustering-and-high-availability-ha diff --git a/translations/zh-CN/content/admin/enterprise-management/increasing-cpu-or-memory-resources.md b/translations/zh-CN/content/admin/enterprise-management/increasing-cpu-or-memory-resources.md index cee8a3b9a696..66f82748888e 100644 --- a/translations/zh-CN/content/admin/enterprise-management/increasing-cpu-or-memory-resources.md +++ b/translations/zh-CN/content/admin/enterprise-management/increasing-cpu-or-memory-resources.md @@ -22,8 +22,8 @@ versions: 在为 {% data variables.product.product_location_enterprise %} 增加 CPU 或内存资源之前： -- **Scale your memory with CPUs**. {% data reusables.enterprise_installation.increasing-cpus-req %} -- **Assign an Elastic IP address to the instance**. 如果未分配弹性 IP，则在重启后您必须调整 {% data variables.product.prodname_ghe_server %} 主机的 DNS A 记录，以反映公共 IP 地址的变更。 在实例重新启动后，如果它启动到 VPC 中，会自动保留弹性 IP (EIP)。 如果实例启动到 EC2-Classic 中，则必须手动重新关联弹性 IP。 +- **使用 CPU 扩展内存**。 {% data reusables.enterprise_installation.increasing-cpus-req %} +- **将 Elastic IP 地址分配给实例**。 如果未分配弹性 IP，则在重启后您必须调整 {% data variables.product.prodname_ghe_server %} 主机的 DNS A 记录，以反映公共 IP 地址的变更。 在实例重新启动后，如果它启动到 VPC 中，会自动保留弹性 IP (EIP)。 如果实例启动到 EC2-Classic 中，则必须手动重新关联弹性 IP。 #### 支持的 AWS 实例类型 @@ -59,7 +59,7 @@ versions: 2. 停止实例。 3. 选择包含所需 CPU 和/或内存资源的新实例。 -### Adding CPU or memory resources for VMware +### 为 VMWare 增加 CPU 或内存资源 {% data reusables.enterprise_installation.increasing-cpus-req %} diff --git a/translations/zh-CN/content/admin/enterprise-management/increasing-storage-capacity.md b/translations/zh-CN/content/admin/enterprise-management/increasing-storage-capacity.md index 6c4e7f8c095b..eec647e1d9a1 100644 --- a/translations/zh-CN/content/admin/enterprise-management/increasing-storage-capacity.md +++ b/translations/zh-CN/content/admin/enterprise-management/increasing-storage-capacity.md @@ -1,6 +1,6 @@ --- title: 增加存储容量 -intro: 您可以增加或更改可供 Git 仓库、数据库、搜索索引和其他持久应用程序数据使用的存储容量。 +intro: '您可以增加或更改可供 Git 仓库、数据库、搜索索引和其他持久应用程序数据使用的存储容量。' redirect_from: - /enterprise/admin/installation/increasing-storage-capacity - /enterprise/admin/enterprise-management/increasing-storage-capacity diff --git a/translations/zh-CN/content/admin/enterprise-management/index.md b/translations/zh-CN/content/admin/enterprise-management/index.md index 5c07f73c4d65..326723dd5cc4 100644 --- a/translations/zh-CN/content/admin/enterprise-management/index.md +++ b/translations/zh-CN/content/admin/enterprise-management/index.md @@ -1,20 +1,14 @@ --- -title: 'Monitoring, managing, and updating your enterprise' -intro: 'You can monitor your appliance, upgrade to a newer version, and configure clustering or high availability' +title: '监控、管理和更新企业' +intro: '您可以监控设备、升级到较新版本以及配置群集或高可用性' redirect_from: - /enterprise/admin/enterprise-management - - /enterprise/admin/enterprise-management - - /enterprise/admin/enterprise-management - - /enterprise/admin/enterprise-management - - /enterprise/admin/enterprise-management - - /enterprise/admin/enterprise-management - - /enterprise/admin/enterprise-management versions: enterprise-server: '*' --- -### Table of Contents +### 目录 {% topic_link_in_list /monitoring-your-appliance %} {% link_in_list /accessing-the-monitor-dashboard %} @@ -22,8 +16,7 @@ versions: {% link_in_list /setting-up-external-monitoring %} {% link_in_list /configuring-collectd %} {% link_in_list /log-forwarding %} - {% link_in_list /monitoring-using-snmp %}{% if currentVersion ver_gt "enterprise-server@2.21" %} - {% link_in_list /monitoring-using-analytics %}{% endif %} + {% link_in_list /monitoring-using-snmp %} {% topic_link_in_list /updating-the-virtual-machine-and-physical-resources %} {% link_in_list /upgrade-requirements %} {% link_in_list /upgrading-github-enterprise-server %} diff --git a/translations/zh-CN/content/admin/enterprise-management/initializing-the-cluster.md b/translations/zh-CN/content/admin/enterprise-management/initializing-the-cluster.md index 622dc3567623..a4d88cc08081 100644 --- a/translations/zh-CN/content/admin/enterprise-management/initializing-the-cluster.md +++ b/translations/zh-CN/content/admin/enterprise-management/initializing-the-cluster.md @@ -17,7 +17,7 @@ versions: ### 配置第一个节点 -1. 连接到将在 `cluster.conf` 中被指定为 `mysql-master` 的节点。 更多信息请参阅“[关于集群配置文件](/enterprise/{{ currentVersion }}/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)”。 +1. Connect to the node that will be designated as MySQL primary in `cluster.conf`. For more information, see "[About the cluster configuration file](/enterprise/{{ currentVersion }}/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)." 2. 在 Web 浏览器中，访问 `https://:8443/setup/`。 {% data reusables.enterprise_installation.upload-a-license-file %} {% data reusables.enterprise_installation.save-settings-in-web-based-mgmt-console %} @@ -43,7 +43,7 @@ versions: 节点的名称可以是您选择的任何有效主机名。 名称被设置为每个节点的主机名，并且还将添加到每个节点上的 `/etc/hosts` 中，以便节点可以在本地相互解析。 -通过 `mysql-server` 和 `mysql-master` 指定您配置为 MySQL master 的第一个集群节点。 +Specify the first cluster node you configured as the MySQL primary via `mysql-server` and `mysql-master`. ``` [cluster] diff --git a/translations/zh-CN/content/admin/enterprise-management/initiating-a-failover-to-your-replica-cluster.md b/translations/zh-CN/content/admin/enterprise-management/initiating-a-failover-to-your-replica-cluster.md index daf641dc3acd..6cb15c27fb13 100644 --- a/translations/zh-CN/content/admin/enterprise-management/initiating-a-failover-to-your-replica-cluster.md +++ b/translations/zh-CN/content/admin/enterprise-management/initiating-a-failover-to-your-replica-cluster.md @@ -1,29 +1,29 @@ --- -title: Initiating a failover to your replica cluster -intro: 'If your {% data variables.product.prodname_ghe_server %} cluster fails, you can fail over to the passive replica .' +title: 发起到副本群集的故障转移 +intro: '如果 {% data variables.product.prodname_ghe_server %} 群集失败，可以故障转移到被动副本 。' redirect_from: - /enterprise/admin/enterprise-management/initiating-a-failover-to-your-replica-cluster versions: enterprise-server: '>2.21' --- -### About failover to your replica cluster +### 关于到副本群集的故障转移 -In the event of a failure at your primary datacenter, you can fail over to the replica nodes in the secondary datacenter if you configure a passive replica node for each node in your active cluster. +如果为主动群集中的每个节点配置被动副本节点，当主数据中心发生故障时可以故障转移到辅助数据中心的副本节点。 -The time required to fail over depends on how long it takes to manually promote the replica cluster and redirect traffic. +故障转移所需的时间取决于手动升级副本群集和重定向流量所需的时长。 -Promoting a replica cluster does not automatically set up replication for the existing cluster. After promoting a replica cluster, you can reconfigure replication from the new active cluster. For more information, see "[Configuring high availability for a cluster](/enterprise/admin/enterprise-management/configuring-high-availability-replication-for-a-cluster#reconfiguring-high-availability-replication-after-a-failover)." +升级副本群集不会自动为现有群集创建副本。 升级副本群集后，可以重新配置新的主动群集复制。 更多信息请参阅“[为群集配置高可用性](/enterprise/admin/enterprise-management/configuring-high-availability-replication-for-a-cluster#reconfiguring-high-availability-replication-after-a-failover)”。 ### 基本要求 -To fail over to passive replica nodes, you must have configured high availability for your cluster. For more information, see "[Configuring high availability for a cluster](/enterprise/admin/enterprise-management/configuring-high-availability-replication-for-a-cluster)." +要故障转移到被动副本节点，必须为群集配置了高可用性。 更多信息请参阅“[为群集配置高可用性](/enterprise/admin/enterprise-management/configuring-high-availability-replication-for-a-cluster)”。 -### Initiating a failover to your replica cluster +### 发起到副本群集的故障转移 -1. SSH into any passive node in the secondary datacenter for your cluster. 更多信息请参阅“[访问管理 shell (SSH)](/enterprise/admin/configuration/accessing-the-administrative-shell-ssh#enabling-access-to-the-administrative-shell-via-ssh)。” +1. SSH 到群集的辅助数据中心中的任何被动节点。 更多信息请参阅“[访问管理 shell (SSH)](/enterprise/admin/configuration/accessing-the-administrative-shell-ssh#enabling-access-to-the-administrative-shell-via-ssh)。” -2. Initialize the failover to the secondary cluster and configure it to act as the active nodes. +2. 初始化到辅助群集的故障转移并将其配置为主动节点。 ```shell ghe-cluster-failover @@ -31,6 +31,6 @@ To fail over to passive replica nodes, you must have configured high availabilit {% data reusables.enterprise_clustering.configuration-finished %} -3. Update the DNS record to point to the IP address of the load balancer for your passive cluster. 流量会在经过 TTL 周期后定向到副本。 +3. 更新 DNS 记录以指向被动群集的负载均衡器的 IP 地址。 流量会在经过 TTL 周期后定向到副本。 -After {% data variables.product.prodname_ghe_server %} returns you to the prompt and your DNS updates have propagated, you've finished failing over. Users can access {% data variables.product.prodname_ghe_server %} using the usual hostname for your cluster. +在 {% data variables.product.prodname_ghe_server %} 返回提示并且 DNS 更新传播后，您便已完成故障转移。 用户可以使用群集的主机名访问 {% data variables.product.prodname_ghe_server %}。 diff --git a/translations/zh-CN/content/admin/enterprise-management/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md b/translations/zh-CN/content/admin/enterprise-management/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md index 57d0d2f304d6..c94a69f4ea29 100644 --- a/translations/zh-CN/content/admin/enterprise-management/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md +++ b/translations/zh-CN/content/admin/enterprise-management/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md @@ -13,7 +13,7 @@ versions: -{% data variables.product.prodname_ghe_server %} 2.14 includes an upgrade to Elasticsearch 5.6. Before upgrading to {% data variables.product.prodname_ghe_server %} 2.14 or later from 2.12 or 2.13, we recommend you download, install, and run the Elasticsearch migration tools, so your largest indices are migrated online while your appliance still has online access. +{% data variables.product.prodname_ghe_server %} 2.14 包括到 Elasticsearch 5.6 的升级。 从 2.12 或 2.13 升级到 {% data variables.product.prodname_ghe_server %} 2.14 或更高版本之前，我们建议您建议下载、安装并运行 Elasticsearch 迁移工具，以便在设备仍具有在线访问权限时在线迁移最大的索引。 ### 搜索索引 diff --git a/translations/zh-CN/content/admin/enterprise-management/migrating-from-github-enterprise-1110x-to-2123.md b/translations/zh-CN/content/admin/enterprise-management/migrating-from-github-enterprise-1110x-to-2123.md index b5c710fc5c7c..f23448937649 100644 --- a/translations/zh-CN/content/admin/enterprise-management/migrating-from-github-enterprise-1110x-to-2123.md +++ b/translations/zh-CN/content/admin/enterprise-management/migrating-from-github-enterprise-1110x-to-2123.md @@ -45,7 +45,7 @@ versions: 3. 设置管理员密码。 5. 单击 **Migrate**。 ![选择安装类型](/assets/images/enterprise/migration/migration-choose-install-type.png) 6. 将备份主机访问 SSH 密钥粘贴到“Add new SSH key”中。 ![授权备份](/assets/images/enterprise/migration/migration-authorize-backup-host.png) -7. Click **Add key** and then click **Continue**. +7. 单击 **Add key（添加密钥）**，然后单击 **Continue（继续）**。 8. 复制您将在备份主机上运行的 `ghe-restore` 命令，将数据迁移到新实例。 ![开始迁移](/assets/images/enterprise/migration/migration-restore-start.png) 9. 在旧实例上启用维护模式，并等待所有活动进程完成。 更多信息请参阅“[启用和排定维护模式](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)”。 diff --git a/translations/zh-CN/content/admin/enterprise-management/monitoring-cluster-nodes.md b/translations/zh-CN/content/admin/enterprise-management/monitoring-cluster-nodes.md index 6d6c8ba3409d..68feb1ed97aa 100644 --- a/translations/zh-CN/content/admin/enterprise-management/monitoring-cluster-nodes.md +++ b/translations/zh-CN/content/admin/enterprise-management/monitoring-cluster-nodes.md @@ -1,15 +1,16 @@ --- -title: Monitoring cluster nodes -intro: 'A {% data variables.product.prodname_ghe_server %} cluster is comprised of redundant services that are distributed across two or more nodes. If an individual service or an entire node were to fail, it should not be immediately apparent to users of the cluster. However since performance and redundancy are affected, it is important to monitor the health of a {% data variables.product.prodname_ghe_server %} cluster.' +title: 监视集群节点 +intro: '{% data variables.product.prodname_ghe_server %} 集群由分布在两个或多个节点上的冗余服务组成。 如果单个服务或整个节点将要发生故障，这种情况不应立即展示给集群的用户。 但是，由于性能和冗余受到影响，因此监视 {% data variables.product.prodname_ghe_server %} 集群的状态非常重要。' redirect_from: - /enterprise/admin/clustering/monitoring-cluster-nodes - /enterprise/admin/enterprise-management/monitoring-cluster-nodes versions: enterprise-server: '*' --- -### Manually checking cluster status -{% data variables.product.prodname_ghe_server %} has a built-in command line utility for monitoring the health of the cluster. From the administrative shell, running the `ghe-cluster-status` command executes a series of health checks on each node including verification of connectivity and service status. The output shows all test results including the text `ok` or `error`. For example, to only display failing tests, run: +### 手动检查集群状态 + +{% data variables.product.prodname_ghe_server %} 有一个内置的命令行实用程序，用于监视集群的状态。 在管理 shell 中，运行 `ghe-cluster-status` 命令会对每个节点执行一系列状态检查，包括验证连接和服务状态。 输出会显示所有测试结果，包括文本 `ok` 或 `error`。 例如，要仅显示失败的测试，请运行： ```shell admin@ghe-data-node-0:~$ ghe-cluster-status | grep error @@ -18,20 +19,20 @@ admin@ghe-data-node-0:~$ ghe-cluster-status | grep error ``` {% note %} -**Note:** If there are no failing tests, this command produces no output. This indicates the cluster is healthy. +**注：**如果没有失败的测试，则此命令不会产生任何输出。 这表明集群的状态是健康的。 {% endnote %} -### Monitoring cluster status with Nagios +### 使用 Nagios 监视集群状态 -You can configure [Nagios](https://www.nagios.org/) to monitor {% data variables.product.prodname_ghe_server %}. In addition to monitoring basic connectivity to each of the cluster nodes, you can check the cluster status by configuring Nagios to use the `ghe-cluster-status -n` command. This returns output in a format that Nagios understands. +您可以配置 [Nagios](https://www.nagios.org/) 来监视 {% data variables.product.prodname_ghe_server %}。 除了监视每个集群节点的基本连接以外，还可以通过将 Nagios 配置为使用 `ghe-cluster-status -n` 命令来检查集群状态。 这将以 Nagios 理解的格式返回输出。 -#### Prerequisites -* Linux host running Nagios. -* Network access to the {% data variables.product.prodname_ghe_server %} cluster. +#### 基本要求 +* 运行 Nagios 的 Linux 主机。 +* 对 {% data variables.product.prodname_ghe_server %} 集群的网络访问。 -#### Configuring the Nagios host -1. Generate an SSH key with a blank passphrase. Nagios uses this to authenticate to the {% data variables.product.prodname_ghe_server %} cluster. +#### 配置 Nagios 主机 +1. 使用空白密码生成 SSH 密钥。 Nagios 使用此密钥来对 {% data variables.product.prodname_ghe_server %} 集群进行身份验证。 ```shell nagiosuser@nagios:~$ ssh-keygen -t rsa -b 4096 > Generating public/private rsa key pair. @@ -43,18 +44,18 @@ You can configure [Nagios](https://www.nagios.org/) to monitor {% data variables ``` {% danger %} - **Security Warning:** An SSH key without a passphrase can pose a security risk if authorized for full access to a host. Limit this key's authorization to a single read-only command. + **安全警告：**如果授权完全访问主机，则没有密码的 SSH 密钥可能会构成安全风险。 将此密钥的授权限制为单个只读命令。 {% enddanger %} -2. Copy the private key (`id_rsa`) to the `nagios` home folder and set the appropriate ownership. +2. 将私钥 (`id_rsa`) 复制到 `nagios` 主文件夹并设置适当的所有权。 ```shell nagiosuser@nagios:~$ sudo cp .ssh/id_rsa /var/lib/nagios/.ssh/ nagiosuser@nagios:~$ sudo chown nagios:nagios /var/lib/nagios/.ssh/id_rsa ``` -3. To authorize the public key to run *only* the `ghe-cluster-status -n` command, use a `command=` prefix in the `/data/user/common/authorized_keys` file. From the administrative shell on any node, modify this file to add the public key generated in step 1. For example: `command="/usr/local/bin/ghe-cluster-status -n" ssh-rsa AAAA....` +3. 要授权公钥*仅*运行 `ghe-cluster-status -n` 命令，请在 `/data/user/common/authorized_keys` 文件中使用 `command=` 前缀。 从任何节点上的管理 shell，修改此文件以添加在步骤 1 中生成的公钥。 例如：`command="/usr/local/bin/ghe-cluster-status -n" ssh-rsa AAAA....` -4. Validate and copy the configuration to each node in the cluster by running `ghe-cluster-config-apply` on the node where you modified the `/data/user/common/authorized_keys` file. +4. 通过在修改了 `/data/user/common/authorized_keys` 文件的节点上运行 `ghe-cluster-config-apply`，验证配置并将其复制到集群中的每个节点。 ```shell admin@ghe-data-node-0:~$ ghe-cluster-config-apply @@ -63,14 +64,15 @@ You can configure [Nagios](https://www.nagios.org/) to monitor {% data variables > Finished cluster configuration ``` -5. To test that the Nagios plugin can successfully execute the command, run it interactively from Nagios host. +5. 要测试 Nagios 插件能否成功执行命令，请从 Nagios 主机以交互方式运行此命令。 ```shell nagiosuser@nagios:~$ /usr/lib/nagios/plugins/check_by_ssh -l admin -p 122 -H hostname -C "ghe-cluster-status -n" -t 30 > OK - No errors detected ``` -6. Create a command definition in your Nagios configuration. - ###### Example definition +6. 在 Nagios 配置中创建命令定义。 + + ###### 示例定义 ``` define command { @@ -78,9 +80,10 @@ You can configure [Nagios](https://www.nagios.org/) to monitor {% data variables command_line $USER1$/check_by_ssh -H $HOSTADDRESS$ -C "ghe-cluster-status -n" -l admin -p 122 -t 30 } ``` -7. Add this command to a service definition for a node in the {% data variables.product.prodname_ghe_server %} cluster. +7. 将此命令添加到 {% data variables.product.prodname_ghe_server %} 集群中节点的服务定义。 + - ###### Example definition + ###### 示例定义 ``` define host{ @@ -98,6 +101,6 @@ You can configure [Nagios](https://www.nagios.org/) to monitor {% data variables } ``` -Once you add the definition to Nagios, the service check executes according to your configuration. You should be able to see the newly configured service in the Nagios web interface. +将定义添加到 Nagios 后，将根据您的配置执行服务检查。 您应该能够在 Nagios Web 界面中看到新配置的服务。 -![Nagios Example](/assets/images/enterprise/cluster/nagios-example.png) +![Nagios 示例](/assets/images/enterprise/cluster/nagios-example.png) diff --git a/translations/zh-CN/content/admin/enterprise-management/monitoring-your-appliance.md b/translations/zh-CN/content/admin/enterprise-management/monitoring-your-appliance.md index 29ff3c89a69a..f9a3e6573975 100644 --- a/translations/zh-CN/content/admin/enterprise-management/monitoring-your-appliance.md +++ b/translations/zh-CN/content/admin/enterprise-management/monitoring-your-appliance.md @@ -1,5 +1,5 @@ --- -title: Monitoring your appliance +title: 监控设备 intro: '随着 {% data variables.product.product_location_enterprise %} 使用量的逐渐增加，系统资源（例如 CPU、内存和存储空间）的利用率也会提高。 您可以配置监视和警报来提示潜在问题，以免这些问题对应用程序性能或可用性造成严重的负面影响。' redirect_from: - /enterprise/admin/guides/installation/system-resource-monitoring-and-alerting/ diff --git a/translations/zh-CN/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources.md b/translations/zh-CN/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources.md index f982eb40e754..e59887269154 100644 --- a/translations/zh-CN/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources.md +++ b/translations/zh-CN/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources.md @@ -1,6 +1,6 @@ --- title: 更新虚拟机和物理资源 -intro: 升级虚拟软件和虚拟硬件需要您的实例停机一段时间，因此，请务必提前规划升级。 +intro: '升级虚拟软件和虚拟硬件需要您的实例停机一段时间，因此，请务必提前规划升级。' redirect_from: - '/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-the-vm/' - '/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-physical-resources/' diff --git a/translations/zh-CN/content/admin/enterprise-management/upgrading-github-enterprise-server.md b/translations/zh-CN/content/admin/enterprise-management/upgrading-github-enterprise-server.md index 0d0d8ee2c058..7a96c9abc3da 100644 --- a/translations/zh-CN/content/admin/enterprise-management/upgrading-github-enterprise-server.md +++ b/translations/zh-CN/content/admin/enterprise-management/upgrading-github-enterprise-server.md @@ -76,7 +76,7 @@ versions: 4. 在新的热补丁下载完毕后，请使用 Install package 下拉菜单： - 要立即安装，请选择 **Now**： - 要稍后安装，请选择以后的日期。 ![热补丁安装日期下拉菜单](/assets/images/enterprise/management-console/hotpatch-installation-date-dropdown.png) -5. Click **Install**. ![热补丁安装按钮](/assets/images/enterprise/management-console/hotpatch-installation-install-button.png) +5. 单击 **Install（安装）**。 ![热补丁安装按钮](/assets/images/enterprise/management-console/hotpatch-installation-install-button.png) ##### 使用管理 shell 安装热补丁 @@ -114,7 +114,7 @@ versions: {% endnote %} -1. Upgrade the replica instance by following the instructions in "[Installing a hotpatch using the administrative shell](#installing-a-hotpatch-using-the-administrative-shell)." If you are using multiple replicas for Geo-replication, you must repeat this procedure to upgrade each replica one at a time. +1. 按照“[使用管理 shell 安装热补丁](#installing-a-hotpatch-using-the-administrative-shell)”中的说明升级副本实例。 如果使用多个副本进行异地复制，则必须重复此过程，每次升级一个副本。 {% data reusables.enterprise_installation.replica-ssh %} {% data reusables.enterprise_installation.replica-verify %} @@ -183,7 +183,7 @@ versions: {% endnote %} -1. Upgrade the replica instance by following the instructions in "[Upgrading a single appliance with an upgrade package](#upgrading-a-single-appliance-with-an-upgrade-package)." If you are using multiple replicas for Geo-replication, you must repeat this procedure to upgrade each replica one at a time. +1. 按照“[使用升级包升级单个设备](#upgrading-a-single-appliance-with-an-upgrade-package)”中的说明升级副本实例。 如果使用多个副本进行异地复制，则必须重复此过程，每次升级一个副本。 {% data reusables.enterprise_installation.replica-ssh %} {% data reusables.enterprise_installation.replica-verify %} diff --git a/translations/zh-CN/content/admin/enterprise-support/about-github-enterprise-support.md b/translations/zh-CN/content/admin/enterprise-support/about-github-enterprise-support.md index 7e6381bc34cf..81603dfc4b5f 100644 --- a/translations/zh-CN/content/admin/enterprise-support/about-github-enterprise-support.md +++ b/translations/zh-CN/content/admin/enterprise-support/about-github-enterprise-support.md @@ -49,17 +49,17 @@ versions: 对于非紧急问题，日语支持的服务时间为周一至周五上午 9:00 至下午 5:00（日本标准时间），不包括日本的法定节假日。 对于紧急问题，我们每周 7 天、每天 24 小时提供英语支持，即使在美国法定节假日也不例外。 GitHub 每天二十四 (24) 小时、每周五 (5) 天（不包括周末和美国全国性假日）对软件提供标准技术支持，不收取额外费用。 -For a complete list of U.S. 有关 {% data variables.contact.enterprise_support %} 遵守的美国和日本法定节假日的完整列表，请参阅“[节假日安排](#holiday-schedules)”。 +有关 有关 {% data variables.contact.enterprise_support %} 遵守的美国和日本法定节假日的完整列表，请参阅“[节假日安排](#holiday-schedules)”。 ### 节假日安排 -For urgent issues, we can help you in English 24 hours per day, 7 days per week, including on U.S. and Japanese holidays. +对于紧急问题，我们全天候为您提供英语帮助，包括美国 和日本的节假日。 #### 美国的节假日 -{% data variables.contact.enterprise_support %} observes these U.S. holidays. {% data variables.contact.enterprise_support %} 会庆祝这些美国节假日，但我们的全球支持团队可以回答紧急事件单。 +{% data variables.contact.enterprise_support %} observes these U.S. holidays. {{ site.data.variables.contact.enterprise_support }} 会庆祝这些美国节假日，但我们的全球支持团队可以回答紧急事件单。 -| U.S. 美国节假日 | Date observed in {{ "now" | date: "%Y" }} | +| 美国 美国节假日 | Date observed in {{ "now" | date: "%Y" }} | | ----------- | ------------------------- | ------------- | | 元旦 | 1 月 1 日 | | | 马丁·路德·金纪念 日 | 1 月的第三个星期一 | | diff --git a/translations/zh-CN/content/admin/enterprise-support/about-support-for-advanced-security.md b/translations/zh-CN/content/admin/enterprise-support/about-support-for-advanced-security.md index 6cd8b07273a7..a2729952b0c4 100644 --- a/translations/zh-CN/content/admin/enterprise-support/about-support-for-advanced-security.md +++ b/translations/zh-CN/content/admin/enterprise-support/about-support-for-advanced-security.md @@ -15,7 +15,7 @@ versions: ### 关于 {% data variables.product.prodname_advanced_security %} 的支持 -{% data variables.product.prodname_advanced_security %} includes {% data variables.contact.enterprise_support %} in English, by email. +{% data variables.product.prodname_advanced_security %} 包括英语版的 {% data variables.contact.enterprise_support %}，通过电子邮件提供。 ### 支持范围 @@ -32,7 +32,7 @@ versions: ### 联系 {% data variables.contact.enterprise_support %} -You can contact {% data variables.contact.enterprise_support %} through the {% data variables.contact.contact_enterprise_portal %} for help with: +您可以通过 {% data variables.contact.enterprise_support %} 联系 {% data variables.contact.contact_enterprise_portal %} 来寻求以下帮助： - 安装和使用 {% data variables.product.prodname_advanced_security %} - 识别并验证受支持错误的原因 @@ -44,7 +44,7 @@ We offer support for {% data variables.product.prodname_advanced_security %} in {% data variables.contact.enterprise_support %} observes these U.S. holidays. GitHub 每天二十四 (24) 小时、每周五 (5) 天（不包括周末和美国全国性假日）对软件提供标准技术支持，不收取额外费用。 -| U.S. 美国节假日 | 2018 年的庆祝日 | +| 美国 美国节假日 | 2018 年的庆祝日 | | ----------- | ----------- | | 元旦 | 1 月 1 日 | | 马丁·路德·金纪念 日 | 1 月的第三个星期一 | @@ -62,7 +62,7 @@ We offer support for {% data variables.product.prodname_advanced_security %} in ### 安装 {% data variables.product.prodname_advanced_security %} 更新 -To ensure that your {% data variables.product.prodname_advanced_security %} instance is stable, you must install and implement new releases when they are made available. This ensures that you have the latest features, modifications, and enhancements as well as any updates to features, code corrections, patches, or other general updates and fixes to {% data variables.product.prodname_advanced_security %}. +为确保您的 {% data variables.product.prodname_advanced_security %} 实例稳定，您必须在新版本可用时安装并实施新版本。 这可确保您有最新功能、修改和增强，以及功能的所有更新、代码更正、补丁或 {% data variables.product.prodname_advanced_security %} 的其他一般更新和修复。 ### 为支持事件单分配优先级 @@ -70,8 +70,8 @@ To ensure that your {% data variables.product.prodname_advanced_security %} inst {% data reusables.support.github-can-modify-ticket-priority %} -| 优先级 | 描述 | -|:------------------------------------------------------------------:| ----------------------------------------------------------------------------------------------------------- | +| 优先级 | 描述 | +|:-------------------------------------------------------------:| ------------------------------------------------------------------------------------------------------ | | {% data variables.product.support_ticket_priority_high %} | {% data variables.product.prodname_advanced_security %} 未运行、已停止或受到严重影响，以致终端用户无法合理地继续使用软件，也没有可用的解决方法。 | | {% data variables.product.support_ticket_priority_normal %} | {% data variables.product.prodname_advanced_security %} 运行不一致，影响终端用户的使用和效率。 | | {% data variables.product.support_ticket_priority_low %} | {% data variables.product.prodname_advanced_security %} 能够一致地运行，但终端用户要求对软件稍作改动，例如文档更新、装饰性缺陷或增强功能。 | diff --git a/translations/zh-CN/content/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server.md b/translations/zh-CN/content/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server.md index d709d2f6319a..5549564932fc 100644 --- a/translations/zh-CN/content/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server.md +++ b/translations/zh-CN/content/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server.md @@ -1,13 +1,8 @@ --- -title: About using GitHub.com actions on GitHub Enterprise Server -intro: '{% data variables.product.prodname_ghe_server %} includes most {% data variables.product.prodname_dotcom %}-authored actions, and has options for enabling access to other actions from {% data variables.product.prodname_dotcom_the_website %} and {% data variables.product.prodname_marketplace %}.' +title: 关于在 GitHub Enterprise Server 上使用 GitHub.com 操作 +intro: '{% data variables.product.prodname_ghe_server %} 包含了大多数 {% data variables.product.prodname_dotcom %} 编写的操作，并且有选项允许访问来自 {% data variables.product.prodname_dotcom_the_website %} 和 {% data variables.product.prodname_marketplace %} 的其他操作。' redirect_from: - /enterprise/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server - - /enterprise/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server - - /enterprise/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server - - /enterprise/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server - - /enterprise/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server - - /enterprise/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server versions: enterprise-server: '>=2.22' --- @@ -17,24 +12,24 @@ versions: {% data reusables.actions.enterprise-no-internet-actions %} -### Official actions bundled with {% data variables.product.prodname_ghe_server %} +### {% data variables.product.prodname_ghe_server %} 随附的官方操作 -Most official {% data variables.product.prodname_dotcom %}-authored actions are automatically bundled with {% data variables.product.prodname_ghe_server %}, and are captured at a point in time from {% data variables.product.prodname_marketplace %}. When your {% data variables.product.prodname_ghe_server %} instance receives updates, the bundled official actions are also updated. +大多数官方 {% data variables.product.prodname_dotcom %} 编写的操作都会自动与 {% data variables.product.prodname_ghe_server %} 捆绑在一起，并且会在某个时间点从 {% data variables.product.prodname_marketplace %} 获取。 当您的 {% data variables.product.prodname_ghe_server %} 实例收到更新时，捆绑的官方操作也会更新。 -The bundled official actions include `actions/checkout`, `actions/upload-artifact`, `actions/download-artifact`, `actions/labeler`, and various `actions/setup-` actions, among others. To see all the official actions included on your enterprise instance, browse to the `actions` organization on your instance: https://{% data variables.product.product_url %}/actions. +捆绑的官方操作包括 `actions/checkout`、`actions/upload-artifact`、`actions/download-artifact`、`actions/labeler` 以及各种 `actions/setup-` 操作等。 要查看您的企业实例中包含的所有官方操作，请在您的实例上浏览到 `actions` 组织：https://{% data variables.product.product_url %}/actions。 -Each action is a repository in the `actions` organization, and each action repository includes the necessary tags, branches, and commit SHAs that your workflows can use to reference the action. +每个操作都是 `actions` 组织中的一个仓库，并且每个操作仓库都包含必要的标记、分支和提交 SHA，您的工作流程可以使用它们来引用操作。 {% note %} -**Note:** When using setup actions (such as `actions/setup-LANGUAGE`) on {% data variables.product.prodname_ghe_server %} with self-hosted runners, you might need to set up the tools cache on runners that do not have internet access. For more information, see "[Setting up the tool cache on self-hosted runners without internet access](/enterprise/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access)." +**注：**在包含自托管运行器的 {% data variables.product.prodname_ghe_server %} 上使用设置操作（例如 `actions/setup-LANGUAGE`）时，您可能需要在没有连接互联网的运行器上设置工具缓存。 更多信息请参阅“[在没有互联网连接的自托管运行器上设置工具缓存](/enterprise/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access)”。 {% endnote %} -### Configuring access to actions on {% data variables.product.prodname_dotcom_the_website %} +### 配置对 {% data variables.product.prodname_dotcom_the_website %} 上操作的访问权限 -If users on your enterprise instance need access to other actions from {% data variables.product.prodname_dotcom_the_website %} or {% data variables.product.prodname_marketplace %}, there are a few configuration options. +如果企业实例上的用户需要访问来自 {% data variables.product.prodname_dotcom_the_website %} 或 {% data variables.product.prodname_marketplace %} 的其他操作，有几个配置选项。 -You can manually download and sync actions onto your enterprise instance using the `actions-sync` tool. For more information, see "[Manually syncing actions from {% data variables.product.prodname_dotcom_the_website %}](/enterprise/admin/github-actions/manually-syncing-actions-from-githubcom)." +您可以使用 `actions-sync` 工具手动下载并同步操作到企业实例。 更多信息请参阅“[手动同步来自 {% data variables.product.prodname_dotcom_the_website %} 的操作](/enterprise/admin/github-actions/manually-syncing-actions-from-githubcom)”。 -Alternatively, you can enable automatic access to all actions from {% data variables.product.prodname_dotcom_the_website %} by connecting {% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_ghe_cloud %} using {% data variables.product.prodname_github_connect %}. For more information, see "[Enabling automatic access to {% data variables.product.prodname_dotcom_the_website %} actions using {% data variables.product.prodname_github_connect %}](/enterprise/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect)". +或者，您也可以使用 {% data variables.product.prodname_github_connect %} 将 {% data variables.product.prodname_ghe_server %} 连接到 {% data variables.product.prodname_ghe_cloud %}，启用对 {% data variables.product.prodname_dotcom_the_website %} 上所有操作的自动访问。 更多信息请参阅“[启用使用 {% data variables.product.prodname_github_connect %} 自动访问 {% data variables.product.prodname_dotcom_the_website %} 操作](/enterprise/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect)”。 diff --git a/translations/zh-CN/content/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect.md b/translations/zh-CN/content/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect.md index c4260a2a103f..d6e5fdc0078c 100644 --- a/translations/zh-CN/content/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect.md +++ b/translations/zh-CN/content/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect.md @@ -1,7 +1,7 @@ --- -title: Enabling automatic access to GitHub.com actions using GitHub Connect -intro: 'To allow {% data variables.product.prodname_actions %} on your enterprise instance to use actions from {% data variables.product.prodname_dotcom_the_website %}, you can connect {% data variables.product.product_location_enterprise %} to {% data variables.product.prodname_ghe_cloud %}.' -permissions: 'Site administrators for {% data variables.product.prodname_ghe_server %} who are also owners of the connected {% data variables.product.prodname_ghe_cloud %} organization or enterprise account can enable access to all {% data variables.product.prodname_dotcom_the_website %} actions.' +title: 启用使用 GitHub Connect 自动访问 GitHub.com 操作 +intro: '要允许企业实例上的 {% data variables.product.prodname_actions %} 使用来自 {% data variables.product.prodname_dotcom_the_website %} 的操作，您可以将 {% data variables.product.product_location_enterprise %} 连接到 {% data variables.product.prodname_ghe_cloud %}。' +permissions: '{% data variables.product.prodname_ghe_server %} 的站点管理员（同时也是已连接 {% data variables.product.prodname_ghe_cloud %} 组织或企业帐户的所有者）可以启用对所有 {% data variables.product.prodname_dotcom_the_website %} 操作的访问。' redirect_from: - /enterprise/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect versions: @@ -11,16 +11,16 @@ versions: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -By default, {% data variables.product.prodname_actions %} workflows on {% data variables.product.prodname_ghe_server %} cannot use actions directly from {% data variables.product.prodname_dotcom_the_website %} or [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=actions). +默认情况下，{% data variables.product.prodname_ghe_server %} 上的 {% data variables.product.prodname_actions %} 工作流程不能使用直接来自 {% data variables.product.prodname_dotcom_the_website %} 或 [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=actions) 的操作。 -To make all actions from {% data variables.product.prodname_dotcom_the_website %} available on your enterprise instance, you can connect {% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_ghe_cloud %} using {% data variables.product.prodname_github_connect %}. For other ways of accessing actions from {% data variables.product.prodname_dotcom_the_website %}, see "[About using {% data variables.product.prodname_dotcom_the_website %} actions on {% data variables.product.prodname_ghe_server %}](/enterprise/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server)." +要使 {% data variables.product.prodname_dotcom_the_website %} 上的所有操作可用于您的企业实例，您可以使用 {% data variables.product.prodname_github_connect %} 将 {% data variables.product.prodname_ghe_server %} 连接到 {% data variables.product.prodname_ghe_cloud %}。 有关访问 {% data variables.product.prodname_dotcom_the_website %} 上操作的其他方式，请参阅“[关于 {% data variables.product.prodname_ghe_server %} 上的 {% data variables.product.prodname_dotcom_the_website %} 操作](/enterprise/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server)”。 -### Enabling automatic access to all {% data variables.product.prodname_dotcom_the_website %} actions +### 启用对所有 {% data variables.product.prodname_dotcom_the_website %} 操作的自动访问 -Before enabling access to all actions from {% data variables.product.prodname_dotcom_the_website %} on {% data variables.product.product_location_enterprise %}, you must connect {% data variables.product.product_location_enterprise %} to {% data variables.product.prodname_dotcom_the_website %}. 更多信息请参阅“[将 {% data variables.product.prodname_ghe_server %} 连接到 {% data variables.product.prodname_ghe_cloud %}](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)”。 +在 {% data variables.product.product_location_enterprise %} 上启用访问来自 {% data variables.product.prodname_dotcom_the_website %} 的所有操作之前，必须将 {% data variables.product.product_location_enterprise %} 连接到 {% data variables.product.prodname_dotcom_the_website %}。 更多信息请参阅“[将 {% data variables.product.prodname_ghe_server %} 连接到 {% data variables.product.prodname_ghe_cloud %}](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)”。 {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.github-connect-tab %} -1. Under "Server can use actions from GitHub.com in workflows runs", use the drop-down menu and select **Enabled**. ![Drop-down menu to actions from GitHub.com in workflows runs](/assets/images/enterprise/site-admin-settings/enable-marketplace-actions-drop-down.png) +1. 在“Server can use actions from GitHub.com in workflows runs（服务器在工作流程运行中可以使用 GitHub.com 上的操作）”下，使用下拉菜单选择 **Enabled（已启用）**。 ![工作流程运行中用于访问 GitHub.com 上操作的下拉菜单](/assets/images/enterprise/site-admin-settings/enable-marketplace-actions-drop-down.png) diff --git a/translations/zh-CN/content/admin/github-actions/enabling-github-actions-and-configuring-storage.md b/translations/zh-CN/content/admin/github-actions/enabling-github-actions-and-configuring-storage.md index 9e2ceab7ef75..cf5310ad9178 100644 --- a/translations/zh-CN/content/admin/github-actions/enabling-github-actions-and-configuring-storage.md +++ b/translations/zh-CN/content/admin/github-actions/enabling-github-actions-and-configuring-storage.md @@ -1,7 +1,7 @@ --- -title: Enabling GitHub Actions and configuring storage -intro: 'External storage must be configured as part of enabling {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %}.' -permissions: 'Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings.' +title: 启用 GitHub Actions 并配置存储 +intro: '外部存储必须配置为在 {% data variables.product.prodname_ghe_server %} 上启用 {% data variables.product.prodname_actions %} 的一部分。' +permissions: '站点管理员可以启用 {% data variables.product.prodname_actions %} 并配置企业设置。' redirect_from: - /enterprise/admin/github-actions/enabling-github-actions-and-configuring-storage versions: @@ -11,27 +11,27 @@ versions: {% if currentVersion == "enterprise-server@2.22" %} {% note %} -**Note:** {% data variables.product.prodname_actions %} support on {% data variables.product.prodname_ghe_server %} 2.22 is a limited public beta. Review the external storage requirements below and [sign up for the beta](https://resources.github.com/beta-signup/). +**注：**{% data variables.product.prodname_ghe_server %} 2.22 上的 {% data variables.product.prodname_actions %} 支持是有限的公测版。 查看下面的外部存储要求并[注册测试版](https://resources.github.com/beta-signup/)。 {% endnote %} {% endif %} {% data reusables.actions.enterprise-github-hosted-runners %} -### About external storage requirements +### 关于外部存储要求 -To enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %}, you must have access to external blob storage. +要在 {% data variables.product.prodname_ghe_server %} 上启用 {% data variables.product.prodname_actions %}，您必须有权访问外部 Blob 存储。 -{% data variables.product.prodname_actions %} uses blob storage to store artifacts generated by workflow runs, such as workflow logs and user-uploaded build artifacts. The amount of storage required depends on your usage of {% data variables.product.prodname_actions %}. +{% data variables.product.prodname_actions %} 使用 Blob 存储来存储工作流程运行生成的构件，如工作流程日志和用户上传的构建构件。 所需存储量取决于您使用 {% data variables.product.prodname_actions %} 的情况。 -{% data variables.product.prodname_actions %} supports these storage providers: +{% data variables.product.prodname_actions %} 支持以下存储提供商： * Amazon S3 -* Azure Blob storage -* S3-compatible MinIO Gateway for NAS +* Azure Blob 存储 +* S3 兼容的 MinIO Gateway for NAS -#### Amazon S3 permissions +#### Amazon S3 权限 -If you use Amazon S3, {% data variables.product.prodname_actions %} requires the following permissions for your AWS access key ID and secret: +如果您使用 Amazon S3，{% data variables.product.prodname_actions %} 需要以下权限来访问您的 AWS 访问密钥 ID 和密码： * `s3:PutObject` * `s3:GetObject` @@ -40,12 +40,12 @@ If you use Amazon S3, {% data variables.product.prodname_actions %} requires the * `s3:AbortMultipartUpload` * `s3:DeleteObject` -### Enabling {% data variables.product.prodname_actions %} +### 启用 {% data variables.product.prodname_actions %} {% if currentVersion == "enterprise-server@2.22" %} -{% data variables.product.prodname_actions %} support on {% data variables.product.prodname_ghe_server %} 2.22 is a limited public beta. [Sign up for the beta](https://resources.github.com/beta-signup/). +{% data variables.product.prodname_ghe_server %} 2.22 上的 {% data variables.product.prodname_actions %} 支持是有限的公测版。 [注册测试版](https://resources.github.com/beta-signup/)。 {% endif %} ### 延伸阅读 -- "Hardware considerations" for your platform in "[Setting up a {% data variables.product.prodname_ghe_server %} instance](/enterprise/admin/installation/setting-up-a-github-enterprise-server-instance)" +- “[设置 {% data variables.product.prodname_ghe_server %} 实例](/enterprise/admin/installation/setting-up-a-github-enterprise-server-instance)”中平台的“硬件考量因素”。 diff --git a/translations/zh-CN/content/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise.md b/translations/zh-CN/content/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise.md index 288777f69efd..e23567553b6c 100644 --- a/translations/zh-CN/content/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise.md +++ b/translations/zh-CN/content/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise.md @@ -1,12 +1,8 @@ --- -title: Enforcing GitHub Actions policies for your enterprise -intro: 'Enterprise administrators can manage access to {% data variables.product.prodname_actions %} in an enterprise.' +title: 为企业实施 GitHub Actions 策略 +intro: '企业管理员可以管理对企业中 {% data variables.product.prodname_actions %} 的访问。' redirect_from: - /enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise - - /enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise - - /enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise - - /enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise - - /enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise versions: enterprise-server: '>=2.22' --- @@ -14,11 +10,11 @@ versions: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -### About {% data variables.product.prodname_actions %} permissions for your enterprise +### 关于企业的 {% data variables.product.prodname_actions %} 权限 -When you enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %}, it is enabled for all organizations in your enterprise. You can choose to disable {% data variables.product.prodname_actions %} for all organizations in your enterprise, or only allow specific organizations. You can also limit the use of public actions, so that people can only use local actions that exist in an organization. +在 {% data variables.product.prodname_ghe_server %} 上启用 {% data variables.product.prodname_actions %} 时，它会对您企业中的所有组织启用。 您可以选择对企业中的所有组织禁用 {% data variables.product.prodname_actions %}，或只允许特定的组织。 您还可以限制公共操作的使用，以使人们只能使用组织中存在的本地操作。 -### Managing {% data variables.product.prodname_actions %} permissions for your enterprise +### 管理企业的 {% data variables.product.prodname_actions %} 权限 {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} @@ -27,11 +23,11 @@ When you enable {% data variables.product.prodname_actions %} on {% data variabl {% data reusables.actions.enterprise-actions-permissions %} {% if currentVersion ver_gt "enterprise-server@2.22" %} -### Enabling workflows for private repository forks +### 为私有仓库复刻启用工作流程 {% data reusables.github-actions.private-repository-forks-overview %} -#### Configuring the private fork policy for your enterprise +#### 为企业配置私有复刻策略 {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} diff --git a/translations/zh-CN/content/admin/github-actions/index.md b/translations/zh-CN/content/admin/github-actions/index.md index 1d06849049fe..b232c3ec2dbc 100644 --- a/translations/zh-CN/content/admin/github-actions/index.md +++ b/translations/zh-CN/content/admin/github-actions/index.md @@ -1,6 +1,6 @@ --- -title: Managing GitHub Actions for your enterprise -intro: 'Enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %}, and manage {% data variables.product.prodname_actions %} policies and settings.' +title: 管理企业的 GitHub Actions +intro: '在 {% data variables.product.prodname_ghe_server %} 上启用 {% data variables.product.prodname_actions %}，并管理 {% data variables.product.prodname_actions %} 策略和设置。' redirect_from: - /enterprise/admin/github-actions versions: diff --git a/translations/zh-CN/content/admin/github-actions/managing-access-to-actions-from-githubcom.md b/translations/zh-CN/content/admin/github-actions/managing-access-to-actions-from-githubcom.md index 59ce970f68a3..36836fafb378 100644 --- a/translations/zh-CN/content/admin/github-actions/managing-access-to-actions-from-githubcom.md +++ b/translations/zh-CN/content/admin/github-actions/managing-access-to-actions-from-githubcom.md @@ -1,14 +1,9 @@ --- -title: Managing access to actions from GitHub.com -intro: 'Controlling which actions on {% data variables.product.prodname_dotcom_the_website %} and {% data variables.product.prodname_marketplace %} can be used in your enterprise.' +title: 管理对 GitHub.com 上操作的访问 +intro: '控制在您的企业中可以使用 {% data variables.product.prodname_dotcom_the_website %} 和 {% data variables.product.prodname_marketplace %} 上的哪些操作。' mapTopic: true redirect_from: - /enterprise/admin/github-actions/managing-access-to-actions-from-githubcom - - /enterprise/admin/github-actions/managing-access-to-actions-from-githubcom - - /enterprise/admin/github-actions/managing-access-to-actions-from-githubcom - - /enterprise/admin/github-actions/managing-access-to-actions-from-githubcom - - /enterprise/admin/github-actions/managing-access-to-actions-from-githubcom - - /enterprise/admin/github-actions/managing-access-to-actions-from-githubcom versions: enterprise-server: '>=2.22' --- diff --git a/translations/zh-CN/content/admin/github-actions/manually-syncing-actions-from-githubcom.md b/translations/zh-CN/content/admin/github-actions/manually-syncing-actions-from-githubcom.md index 4f1d558ecacc..ebc6f32b3cf1 100644 --- a/translations/zh-CN/content/admin/github-actions/manually-syncing-actions-from-githubcom.md +++ b/translations/zh-CN/content/admin/github-actions/manually-syncing-actions-from-githubcom.md @@ -1,6 +1,6 @@ --- -title: Manually syncing actions from GitHub.com -intro: 'For users that need access to actions from {% data variables.product.prodname_dotcom_the_website %}, you can sync specific actions to your {% data variables.product.prodname_ghe_server %} instance.' +title: 手动从 GitHub.com 同步操作 +intro: '对于需要访问 {% data variables.product.prodname_dotcom_the_website %} 上操作的用户，您可以将特定操作同步到 {% data variables.product.prodname_ghe_server %} 实例。' redirect_from: - /enterprise/admin/github-actions/manually-syncing-actions-from-githubcom versions: @@ -12,34 +12,34 @@ versions: {% data reusables.actions.enterprise-no-internet-actions %} -To make specific actions from {% data variables.product.prodname_dotcom_the_website %} available to use in workflows, you can use {% data variables.product.company_short %}'s open source [`actions-sync`](https://github.com/actions/actions-sync) tool to sync action repositories from {% data variables.product.prodname_dotcom_the_website %} to your enterprise instance. For other ways of accessing actions from {% data variables.product.prodname_dotcom_the_website %}, see "[About using {% data variables.product.prodname_dotcom_the_website %} actions on {% data variables.product.prodname_ghe_server %}](/enterprise/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server)." +要使 {% data variables.product.prodname_dotcom_the_website %} 中的特定操作可用于工作流程，您可以使用 {% data variables.product.company_short %} 的开源 [`actions-sync`](https://github.com/actions/actions-sync) 工具将操作仓库从 {% data variables.product.prodname_dotcom_the_website %} 同步到企业实例。 有关访问 {% data variables.product.prodname_dotcom_the_website %} 上操作的其他方式，请参阅“[关于 {% data variables.product.prodname_ghe_server %} 上的 {% data variables.product.prodname_dotcom_the_website %} 操作](/enterprise/admin/github-actions/about-using-githubcom-actions-on-github-enterprise-server)”。 -### About the `actions-sync` tool +### 关于 `actions-sync` 工具 -The `actions-sync` tool must be run on a machine that can access the {% data variables.product.prodname_dotcom_the_website %} API and your {% data variables.product.prodname_ghe_server %} instance's API. The machine doesn't need to be connected to both at the same time. +`actions-sync` 工具必须在可以访问 {% data variables.product.prodname_dotcom_the_website %} API 和 {% data variables.product.prodname_ghe_server %} 实例的 API 的计算机上运行。 计算机不需要同时连接到两者。 -If your machine has access to both systems at the same time, you can do the sync with a single `actions-sync sync` command. If you can only access one system at a time, you can use the `actions-sync pull` and `push` commands. +如果计算机可以同时访问这两个系统，您可以使用单一 `actions-sync sync` 命令进行同步。 如果您一次只能访问一个系统，您可以使用 `actions-sync pull` 和 `push` 命令。 -The `actions-sync` tool can only download actions from {% data variables.product.prodname_dotcom_the_website %} that are stored in public repositories. +`actions-sync` 工具只能从存储在公有仓库中的 {% data variables.product.prodname_dotcom_the_website %} 下载操作。 ### 基本要求 -* Before using the the `actions-sync` tool, you must ensure that all destination organizations already exist on your enterprise instance. The following example demonstrates how to sync actions to an organization named `synced-actions` on an enterprise instance. For more information, see "[Creating organizations](/enterprise/admin/user-management/creating-organizations)." -* You must create a personal access token (PAT) on your enterprise instance that can create and write to repositories in the destination organizations. 更多信息请参阅“[创建个人访问令牌](/github/authenticating-to-github/creating-a-personal-access-token)”。 +* 在使用 `actions-sync` 工具之前，您必须确保所有目标组织已经存在于您的企业实例中。 以下示例演示如何将操作同步到企业实例上名为 `synced-actions` 的组织。 更多信息请参阅“[创建组织](/enterprise/admin/user-management/creating-organizations)”。 +* 您必须在企业实例上创建可以创建并写入目标组织中的仓库的个人访问令牌 (PAT)。 更多信息请参阅“[创建个人访问令牌](/github/authenticating-to-github/creating-a-personal-access-token)”。 -### Example: Using the `actions-sync` tool +### 示例：使用 `actions-sync` 工具 -This example demonstrates using the `actions-sync` tool to sync an individual action from {% data variables.product.prodname_dotcom_the_website %} to an enterprise instance. +此示例演示使用 `actions-sync` 工具将个别操作从 {% data variables.product.prodname_dotcom_the_website %} 同步到企业实例。 {% note %} -**Note:** This example uses the `actions-sync sync` command, which requires concurrent access to both the {% data variables.product.prodname_dotcom_the_website %} API and your {% data variables.product.prodname_ghe_server %} instance's API from your machine. If you can only access one system at a time, you can use the `actions-sync pull` and `push` commands. For more information, see the [`actions-sync` README](https://github.com/actions/actions-sync#not-connected-instances). +**注：**此示例使用 `actions-sync sync` 命令 它要求从您的计算机同时访问 {% data variables.product.prodname_dotcom_the_website %} API 和 {% data variables.product.prodname_ghe_server %} 实例的 API。 如果您一次只能访问一个系统，您可以使用 `actions-sync pull` 和 `push` 命令。 更多信息请参阅 [`actions-sync` README](https://github.com/actions/actions-sync#not-connected-instances)。 {% endnote %} -1. Download and extract the latest [`actions-sync` release](https://github.com/actions/actions-sync/releases) for your machine's operating system. -1. Create a directory to store cache files for the tool. -1. Run the `actions-sync sync` command: +1. 为您计算机的操作系统下载并解压缩最新的 [`actions-sync` 版本](https://github.com/actions/actions-sync/releases)。 +1. 创建一个目录来存储工具的缓存文件。 +1. 运行 `actions-sync sync` 命令： ```shell ./actions-sync sync \ @@ -49,17 +49,17 @@ This example demonstrates using the `actions-sync` tool to sync an individual ac --repo-name "docker/build-push-action:synced-actions/docker-build-push-action" ``` - The above command uses the following arguments: + 上述命令使用以下参数： - * `--cache-dir`: The cache directory on the machine running the command. - * `--destination-token`: A personal access token for the destination enterprise instance. - * `--destination-url`: The URL of the destination enterprise instance. - * `--repo-name`: The action repository to sync. This takes the format of `owner/repository:destination_owner/destination_repository`. + * `--cache-dir`：运行命令的计算机上的缓存目录。 + * `--destination-toke`：目标企业实例的个人访问令牌。 + * `--destination-url`：目标企业实例的 URL。 + * `--repo-name`：要同步的操作仓库。 这将使用格式 `owner/repository:destination_owner/destination_repository`。 - * The above example syncs the [`docker/build-push-action`](https://github.com/docker/build-push-action) repository to the `synced-actions/docker-build-push-action` repository on the destination {% data variables.product.prodname_ghe_server %} instance. You must create the organization named `synced-actions` on your enterprise instance before running the above command. - * If you omit `:destination_owner/destination_repository`, the tool uses the original owner and repository name for your enterprise instance. Before running the command, you must create a new organization on your instance that matches the owner name of the action. Consider using a central organization to store the synced actions on your instance, as this means you will not need to create multiple new organizations if you sync actions from different owners. - * You can sync multiple actions by replacing the `--repo-name` parameter with `--repo-name-list` or `--repo-name-list-file`. For more information, see the [`actions-sync` README](https://github.com/actions/actions-sync#actions-sync). -1. After the action repository is created on your enterprise instance, people in your enterprise can use the destination repository to reference the action in their workflows. For the example action shown above: + * 上面的示例将 [`docker/build-push-action`](https://github.com/docker/build-push-action) 仓库同步到目标 {% data variables.product.prodname_ghe_server %} 实例上的 `synced-actions/docker-build-push-action` 仓库。 在运行上述命令之前，您必须在企业实例上创建名为 `synced-actions` 的组织。 + * 如果您省略 `:destination_owners/destination_repost`，工具将使用企业实例的原始所有者和仓库名称。 在运行命令之前，必须在实例上创建一个与操作的所有者名称匹配的新组织。 考虑使用一个中心组织来存储实例上同步的操作，因为这样在同步来自不同所有者的操作时，将无需创建多个新的组织。 + * 将 `--repo-name` 参数替换为 `--repo-name-list` 或 `--repo-name-list-file` 便可同步多个操作。 更多信息请参阅 [`actions-sync` README](https://github.com/actions/actions-sync#actions-sync)。 +1. 在企业实例上创建操作仓库后，企业中的人员可以使用目标仓库在其工作流程中引用操作。 对于上面显示的示例操作： ``` uses: synced-actions/docker-build-push-action@v1 diff --git a/translations/zh-CN/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md b/translations/zh-CN/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md index 6e8a2a4ff7ab..6c1380c82866 100644 --- a/translations/zh-CN/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md +++ b/translations/zh-CN/content/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md @@ -1,6 +1,6 @@ --- -title: Setting up the tool cache on self-hosted runners without internet access -intro: 'To use the the included `actions/setup` actions on self-hosted runners without internet access, you must first populate the runner''s tool cache for your workflows.' +title: 在未接入互联网的自托管运行器上设置工具缓存 +intro: '要在没有互联网连接的自托管运行器上使用包含的 '' actions/setup'' 操作，您必须先为工作流程填充运行器的工具缓存。' redirect_from: - /enterprise/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access versions: @@ -10,34 +10,34 @@ versions: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -### About the included setup actions and the runner tool cache +### 关于包含的设置操作和运行器工具缓存 {% data reusables.actions.enterprise-no-internet-actions %} -Most official {% data variables.product.prodname_dotcom %}-authored actions are automatically bundled with {% data variables.product.prodname_ghe_server %}. However, self-hosted runners without internet access will require some configuration before they can use the included `actions/setup-LANGUAGE` actions, such as `setup-node`. +大多数官方 {% data variables.product.prodname_dotcom %} 编写的操作都会自动与 {% data variables.product.prodname_ghe_server %} 捆绑在一起。 但是，没有接入互联网的自托管运行器需要进行一些配置，然后才能使用包含的 `actions/setup-LANGUAGE` 操作，例如 `setup-node`。 -The `actions/setup-LANGUAGE` actions normally need internet access to download the required environment binaries into the runner's tool cache. Self-hosted runners without internet access can't download the binaries, so you must manually populate the tool cache on the runner. +`actions/setup-LANGUAGE` 操作通常需要接入互联网才能将所需的环境二进制文件下载到运行器的工具缓存。 没有互联网连接的自托管运行器无法下载二进制文件，所以您必须手动填充运行器上的工具缓存。 -You can populate the runner tool cache by running a {% data variables.product.prodname_actions %} workflow on {% data variables.product.prodname_dotcom_the_website %} that uploads a {% data variables.product.prodname_dotcom %}-hosted runner's tool cache as an artifact, which you can then transfer and extract on your internet-disconnected self-hosted runner. +您可以通过在 {% data variables.product.prodname_dotcom_the_website %} 上运行 {% data variables.product.prodname_actions %} 工作流程来填充运行器工具缓存，该工作流程将 {% data variables.product.prodname_dotcom %} 托管的运行器的工具缓存作为项目上传，然后可以在互联网断开的自托管运行器上传输和提取。 {% note %} -**Note:** You can only use a {% data variables.product.prodname_dotcom %}-hosted runner's tool cache for a self-hosted runner that has an identical operating system and architecture. For example, if you are using a `ubuntu-18.04` {% data variables.product.prodname_dotcom %}-hosted runner to generate a tool cache, your self-hosted runner must be a 64-bit Ubuntu 18.04 machine. For more information on {% data variables.product.prodname_dotcom %}-hosted runners, see "    Virtual environments for GitHub-hosted runners." +**注：**您只能对拥有相同操作系统和架构的自托管运行器使用 {% data variables.product.prodname_dotcom %} 托管的运行器工具缓存。 例如，如果您使用 `ubuntu-18.04` {% data variables.product.prodname_dotcom %} 托管的运行器生成工具缓存，则自托管运行器必须是 64 位 Ubuntu 18.04 计算机。 有关 {% data variables.product.prodname_dotcom %} 托管的运行器的更多信息，请参阅“GitHub 托管运行器的虚拟环境”。 {% endnote %} ### 基本要求 -* Determine which development environments your self-hosted runners will need. The following example demonstrates how to populate a tool cache for the `setup-node` action, using Node.js versions 10 and 12. -* Access to a repository on {% data variables.product.prodname_dotcom_the_website %} that you can use to run a workflow. -* Access to your self-hosted runner's file system to populate the tool cache folder. +* 确定自托管运行器需要哪些开发环境。 下面的示例演示如何使用 Node.js 版本 10 和 12 填充 `setup-node` 操作的工具缓存。 +* 访问可用于运行工作流程的 {% data variables.product.prodname_dotcom_the_website %} 上的仓库。 +* 访问自托管运行器的文件系统以填充工具缓存文件夹。 -### Populating the tool cache for a self-hosted runner +### 填充自托管运行器的工具缓存 -1. On {% data variables.product.prodname_dotcom_the_website %}, navigate to a repostory that you can use to run a {% data variables.product.prodname_actions %} workflow. -1. Create a new workflow file in the repository's `.github/workflows` folder that uploads an artifact containing the {% data variables.product.prodname_dotcom %}-hosted runner's tool cache. +1. 在 {% data variables.product.prodname_dotcom_the_website %} 上，导航到可用于运行 {% data variables.product.prodname_actions %} 工作流程的仓库。 +1. 在仓库的 `.github/workflow` 文件夹中创建一个新的工作流程文件，用于上传包含 {% data variables.product.prodname_dotcom %} 托管的运行器工具缓存的构件。 - The following example demonstrates a workflow that uploads the tool cache for an Ubuntu 18.04 environment, using the `setup-node` action with Node.js versions 10 and 12. + 下面的示例演示了使用 Node.js 版本 10 和 12 的 `setup-node` 操作为 Ubuntu 18.04 环境上传工具缓存的工作流程。 {% raw %} ```yaml @@ -69,10 +69,10 @@ You can populate the runner tool cache by running a {% data variables.product.pr path: ${{runner.tool_cache}}/tool_cache.tar.gz ``` {% endraw %} -1. Download the tool cache artifact from the workflow run. For instructions on downloading artifacts, see "[Persisting workflow data using artifacts](/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts#downloading-and-deleting-artifacts-after-a-workflow-run-is-complete)." -1. Transfer the tool cache artifact to your self hosted runner and extract it to the local tool cache directory. The default tool cache directory is `RUNNER_DIR/_work/_tool`. If the runner hasn't processed any jobs yet, you might need to create the `_work/_tool` directories. +1. 从工作流程运行下载工具缓存构件。 For instructions on downloading artifacts, see "[Downloading workflow artifacts](/actions/managing-workflow-runs/downloading-workflow-artifacts)." +1. 将工具缓存构件传输到自托管的运行器，并将其提取到本地工具缓存目录。 默认工具缓存目录是 `RUNNER_DIR/_work/_tool`。 如果运行器尚未处理任何任务，您可能需要创建 `_work/_tool` 目录。 - After extracting the tool cache artifact uploaded in the above example, you should have a directory structure on your self-hosted runner that is similar to the following example: + 提取上述示例中上传的工具缓存构件后，自托管运行器上应具有类似于以下示例的目录结构： ``` RUNNER_DIR @@ -87,4 +87,4 @@ You can populate the runner tool cache by running a {% data variables.product.pr └── ... ``` -Your self-hosted runner without internet access should now be able to use the `setup-node` action. If you are having problems, make sure that you have populated the correct tool cache for your workflows. For example, if you need to use the `setup-python` action, you will need to populate the tool cache with the Python environment you want to use. +没有互联网接入的自托管运行器现在应该能够使用 `setup-node` 操作。 如果遇到问题，请确保已为工作流程填充了正确的工具缓存。 例如，如果您需要使用 `setup-python` 操作，则需要通过要使用的 Python 环境填充工具缓存。 diff --git a/translations/zh-CN/content/admin/index.md b/translations/zh-CN/content/admin/index.md index cbe67eed2553..81b56ca4db61 100644 --- a/translations/zh-CN/content/admin/index.md +++ b/translations/zh-CN/content/admin/index.md @@ -1,9 +1,9 @@ --- -title: Enterprise Administrators +title: 企业管理员 redirect_from: - /enterprise/admin/hidden/migrating-from-github-fi/ - /enterprise/admin -intro: 适用于部署、配置和管理 GitHub Enterprise 实例的组织管理员、系统管理员和安全专家的分步指南。 +intro: '适用于部署、配置和管理 GitHub Enterprise 实例的组织管理员、系统管理员和安全专家的分步指南。' versions: enterprise-server: '*' --- diff --git a/translations/zh-CN/content/admin/installation/index.md b/translations/zh-CN/content/admin/installation/index.md index bd455eb91f0a..65cd1c21ef65 100644 --- a/translations/zh-CN/content/admin/installation/index.md +++ b/translations/zh-CN/content/admin/installation/index.md @@ -1,7 +1,7 @@ --- title: '安装 {% data variables.product.prodname_enterprise %}' -shortTitle: Installing -intro: 'System administrators and operations and security specialists can install {% data variables.product.prodname_ghe_server %}.' +shortTitle: 安装 +intro: '系统管理员以及操作和安全专业人员可以安装 {% data variables.product.prodname_ghe_server %}。' redirect_from: - /enterprise/admin-guide/ - /enterprise/admin/guides/installation/ diff --git a/translations/zh-CN/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md b/translations/zh-CN/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md index 2d3e61cb129b..d75b38d01be0 100644 --- a/translations/zh-CN/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md +++ b/translations/zh-CN/content/admin/installation/installing-github-enterprise-server-on-google-cloud-platform.md @@ -24,7 +24,8 @@ versions: #### 支持的机器类型 -以下 Google Compute Engine (GCE) 机器类型支持 {% data variables.product.prodname_ghe_server %}。 更多信息请参阅 [Google Cloud Platform 机器类型文章](https://cloud.google.com/compute/docs/machine-types)。 | +以下 Google Compute Engine (GCE) 机器类型支持 {% data variables.product.prodname_ghe_server %}。 更多信息请参阅 [Google Cloud Platform 机器类型文章](https://cloud.google.com/compute/docs/machine-types)。 +| {% if currentVersion != "free-pro-team@latest" %} | | 高内存 | | | ------------- | diff --git a/translations/zh-CN/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md b/translations/zh-CN/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md index db9b4d5a8ecc..bd739cf875c2 100644 --- a/translations/zh-CN/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md +++ b/translations/zh-CN/content/admin/installation/installing-github-enterprise-server-on-openstack-kvm.md @@ -29,8 +29,10 @@ versions: {% data reusables.enterprise_installation.create-ghe-instance %} -1. 在 OpenStack Horizon 中，上传您下载的 {% data variables.product.prodname_ghe_server %} 映像。 For instructions, see the "Upload an image" section of the OpenStack guide "[Upload and manage images](https://docs.openstack.org/horizon/latest/user/manage-images.html)." -{% data reusables.enterprise_installation.create-attached-storage-volume %} For instructions, see the OpenStack guide "[Create and manage volumes](https://docs.openstack.org/horizon/latest/user/manage-volumes.html)." +1. 在 OpenStack Horizon 中，上传 + +您下载的 {% data variables.product.prodname_ghe_server %} 映像。 有关说明，请参阅 OpenStack 指南“[上传和管理图像](https://docs.openstack.org/horizon/latest/user/manage-images.html)”的“上传图像”部分。 +{% data reusables.enterprise_installation.create-attached-storage-volume %}有关说明，请参阅 OpenStack 指南“[创建和管理卷](https://docs.openstack.org/horizon/latest/user/manage-volumes.html)”。 3. 创建安全组，并为下表中的各个端口添加新的安全组规则。 有关说明，请参阅 OpenStack 指南“[为实例配置访问和安全](https://docs.openstack.org/horizon/latest/user/configure-access-and-security-for-instances.html)”。 {% data reusables.enterprise_installation.necessary_ports %} diff --git a/translations/zh-CN/content/admin/installation/installing-github-enterprise-server-on-vmware.md b/translations/zh-CN/content/admin/installation/installing-github-enterprise-server-on-vmware.md index 7436bde11d30..884b481b1ac4 100644 --- a/translations/zh-CN/content/admin/installation/installing-github-enterprise-server-on-vmware.md +++ b/translations/zh-CN/content/admin/installation/installing-github-enterprise-server-on-vmware.md @@ -1,6 +1,6 @@ --- title: 在 VMware 上安装 GitHub Enterprise Server -intro: 'To install {% data variables.product.prodname_ghe_server %} on VMware, you must download the VMware vSphere client, and then download and deploy the {% data variables.product.prodname_ghe_server %} software.' +intro: '要在 VMWare 上安装 {% data variables.product.prodname_ghe_server %}，您必须下载 VMWare vSphere 客户端，然后下载并部署 {% data variables.product.prodname_ghe_server %} 软件。' redirect_from: - /enterprise/admin/articles/getting-started-with-vmware/ - /enterprise/admin/articles/installing-vmware-tools/ @@ -14,7 +14,7 @@ versions: ### 基本要求 - {% data reusables.enterprise_installation.software-license %} -- 您必须为将要运行 {% data variables.product.product_location_enterprise %} 的裸金属机应用 VMware vSphere ESXi Hypervisor。 我们支持版本 5.5 到 6.7。 The ESXi Hypervisor is free and does not include the (optional) vCenter Server. 更多信息请参阅 [VMware ESXi 文档](https://www.vmware.com/products/esxi-and-esx.html)。 +- 您必须为将要运行 {% data variables.product.product_location_enterprise %} 的裸金属机应用 VMware vSphere ESXi Hypervisor。 我们支持版本 5.5 到 6.7。 ESXi Hypervisor 免费提供，不包含（可选）vCenter Server。 更多信息请参阅 [VMware ESXi 文档](https://www.vmware.com/products/esxi-and-esx.html)。 - 您将需要访问 vSphere Client。 如果您有 vCenter Server，可以使用 vSphere Web Client。 更多信息请参阅 VMware 指南“[使用 vSphere Web Client 登录 vCenter Server](https://docs.vmware.com/en/VMware-vSphere/6.5/com.vmware.vsphere.install.doc/GUID-CE128B59-E236-45FF-9976-D134DADC8178.html)”。 ### 硬件考量因素 @@ -34,7 +34,7 @@ versions: {% data reusables.enterprise_installation.create-ghe-instance %} 1. 使用 vSphere Windows Client 或 vCenter Web Client 导入您下载的 {% data variables.product.prodname_ghe_server %} 映像。 有关说明，请参阅 VMware 指南“[部署 OVF 或 OVA 模板](https://docs.vmware.com/en/VMware-vSphere/6.5/com.vmware.vsphere.vm_admin.doc/GUID-17BEDA21-43F6-41F4-8FB2-E01D275FE9B4.html)”。 - - 选择数据存储时，请选择空间足以容纳 VM 磁盘的数据存储。 For the minimum hardware specifications recommended for your instance size, see "[Hardware considerations](#hardware-considerations)." We recommend thick provisioning with lazy zeroing. + - 选择数据存储时，请选择空间足以容纳 VM 磁盘的数据存储。 有关建议为实例使用的最低硬件规格，请参阅“[硬件考量因素](#hardware-considerations)”。 建议采用支持延迟归零的密集预配。 - 让 **Power on after deployment** 框保持取消选中状态，因为您需要在配置 VM 后为仓库数据添加连接的存储卷。 {% data reusables.enterprise_installation.create-attached-storage-volume %} 有关说明，请参阅 VMware 指南“[向虚拟机添加新硬盘](https://docs.vmware.com/en/VMware-vSphere/6.5/com.vmware.vsphere.vm_admin.doc/GUID-F4917C61-3D24-4DB9-B347-B5722A84368C.html)”。 diff --git a/translations/zh-CN/content/admin/overview/about-enterprise-accounts.md b/translations/zh-CN/content/admin/overview/about-enterprise-accounts.md index f3ac50f0ebd8..778ee64ce917 100644 --- a/translations/zh-CN/content/admin/overview/about-enterprise-accounts.md +++ b/translations/zh-CN/content/admin/overview/about-enterprise-accounts.md @@ -13,7 +13,7 @@ versions: 企业帐户可用于管理多个 {% data variables.product.prodname_dotcom %} 组织和 {% data variables.product.prodname_ghe_server %} 实例。 您的企业帐户必须有操作点，如 {% data variables.product.prodname_dotcom %} 上的组织或个人帐户。 企业管理员可以管理设置和首选项，如： - 成员访问和管理（组织成员、外部协作者） -- 帐单和使用（{% data variables.product.prodname_ghe_server %} 实例、用户许可、{% data variables.large_files.product_name_short %} 包） +- 计费和使用（{% data variables.product.prodname_ghe_server %} 实例、用户许可、{% data variables.large_files.product_name_short %} 包） - 安全性（单点登录、双重身份验证） - 与 {% data variables.contact.enterprise_support %} 共享请求和支持包 diff --git a/translations/zh-CN/content/admin/overview/about-the-github-enterprise-server-api.md b/translations/zh-CN/content/admin/overview/about-the-github-enterprise-server-api.md index 9f03a9283c05..9f6bf1089720 100644 --- a/translations/zh-CN/content/admin/overview/about-the-github-enterprise-server-api.md +++ b/translations/zh-CN/content/admin/overview/about-the-github-enterprise-server-api.md @@ -11,9 +11,9 @@ versions: enterprise-server: '*' --- -For the complete documentation for {% data variables.product.prodname_enterprise_api %}, see [{% data variables.product.prodname_enterprise_api %} REST API reference docs](/enterprise/{{ currentVersion }}/v3/). 利用 API，您可以自动处理多种管理任务。 包含以下例子： +有关 {% data variables.product.prodname_enterprise_api %} 的完整文档，请参阅 [{% data variables.product.prodname_enterprise_api %} REST API 参考文档](/enterprise/{{ currentVersion }}/v3/)。 利用 API，您可以自动处理多种管理任务。 包含以下例子： - 对 {% data variables.enterprise.management_console %} 进行更改。 更多信息请参阅“[{% data variables.enterprise.management_console %}](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#management-console)”。 - 收集关于实例的统计信息。 更多信息请参阅“[管理员统计信息](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#admin-stats)”。 -- 配置 LDAP 同步。 更多信息请参阅“[LDAP](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#ldap)”。{% if currentVersion ver_gt "enterprise-server@2.18" %} -- 管理企业帐户。 更多信息请参阅“[企业帐户](/v4/guides/managing-enterprise-accounts)”。{% endif %} +- 配置 LDAP 同步。 更多信息请参阅“[LDAP](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#ldap)”。 +- 管理企业帐户。 更多信息请参阅“[企业帐户](/v4/guides/managing-enterprise-accounts)”。 diff --git a/translations/zh-CN/content/admin/overview/index.md b/translations/zh-CN/content/admin/overview/index.md index 134305ff678f..a5c2830d7347 100644 --- a/translations/zh-CN/content/admin/overview/index.md +++ b/translations/zh-CN/content/admin/overview/index.md @@ -1,6 +1,6 @@ --- title: 概览 -intro: 'With {% data variables.product.prodname_enterprise %} you can manage accounts and access, licenses, and billing.' +intro: '通过 {% data variables.product.prodname_enterprise %} 可以管理帐户和访问权限、许可及计费。' redirect_from: - /enterprise/admin/overview versions: diff --git a/translations/zh-CN/content/admin/overview/managing-billing-for-github-enterprise.md b/translations/zh-CN/content/admin/overview/managing-billing-for-github-enterprise.md index d850ee14f0ac..6652a2747c14 100644 --- a/translations/zh-CN/content/admin/overview/managing-billing-for-github-enterprise.md +++ b/translations/zh-CN/content/admin/overview/managing-billing-for-github-enterprise.md @@ -11,7 +11,7 @@ versions: ### 关于企业帐户的计费 -企业帐户目前适用于通过发票付款的 {% data variables.product.prodname_enterprise %} 客户。 对于所有付费 {% data variables.product.prodname_dotcom_the_website %} 服务（包括组织中的付费许可、{% data variables.large_files.product_name_long %} 数据包和 {% data variables.product.prodname_marketplace %} 应用程序订阅），连接至企业帐户的所有组织和 {% data variables.product.prodname_ghe_server %} 实例的帐单都将汇总为一个计费帐单。 +企业帐户目前适用于通过发票付费的 {% data variables.product.prodname_enterprise %} 客户。 对于所有付费 {% data variables.product.prodname_dotcom_the_website %} 服务（包括组织中的付费许可、{% data variables.large_files.product_name_long %} 数据包和 {% data variables.product.prodname_marketplace %} 应用程序订阅），连接至企业帐户的所有组织和 {% data variables.product.prodname_ghe_server %} 实例的帐单都将汇总为一个计费帐单。 企业所有者和帐单管理员均可访问和管理企业帐户的所有帐单设置。 有关企业帐户的更多信息，请参阅“[企业帐户的角色](/github/setting-up-and-managing-your-enterprise-account/roles-for-an-enterprise-account)”。 有关管理帐单管理员的更多信息，请参阅“[邀请人员管理企业帐户](/github/setting-up-and-managing-your-enterprise-account/inviting-people-to-manage-your-enterprise-account)”。 diff --git a/translations/zh-CN/content/admin/overview/managing-your-github-enterprise-license.md b/translations/zh-CN/content/admin/overview/managing-your-github-enterprise-license.md index 6758db4e2351..107141d679e2 100644 --- a/translations/zh-CN/content/admin/overview/managing-your-github-enterprise-license.md +++ b/translations/zh-CN/content/admin/overview/managing-your-github-enterprise-license.md @@ -34,7 +34,8 @@ versions: {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.enterprise-licensing-tab %} 4. 在“Enterprise Server Instances（企业服务器实例）”下，单击 {% octicon "download" aria-label="The download icon" %} 下载您的许可文件。 ![下载 GitHub Enterprise Server 许可](/assets/images/help/business-accounts/download-ghes-license.png) -5. 作为站点管理员登录到您的 {% data variables.product.prodname_ghe_server %} 实例。 +5. 作为站点管理员登录到 +您的 {% data variables.product.prodname_ghe_server %} 实例。 {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.settings-tab %} @@ -63,7 +64,8 @@ versions: {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.license-tab %} 5. 在“Quick links”下，要下载包含 {% data variables.product.prodname_ghe_server %} 上当前许可使用情况的文件，请单击 **Export license usage**。 ![Export license usage 链接](/assets/images/enterprise/business-accounts/export-license-usage-link.png) -6. 导航至 {% data variables.product.prodname_ghe_cloud %}。 +6. 导航到 +{% data variables.product.prodname_ghe_cloud %}. {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.enterprise-licensing-tab %} diff --git a/translations/zh-CN/content/admin/overview/system-overview.md b/translations/zh-CN/content/admin/overview/system-overview.md index 712dccb99470..9ed4c6c68059 100644 --- a/translations/zh-CN/content/admin/overview/system-overview.md +++ b/translations/zh-CN/content/admin/overview/system-overview.md @@ -139,4 +139,4 @@ versions: - “[设置 {% data variables.product.prodname_ghe_server %} 的试用版](/articles/setting-up-a-trial-of-github-enterprise-server)” - “[设置 {% data variables.product.prodname_ghe_server %} 实例](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-github-enterprise-server-instance)” -- [ {% data variables.product.prodname_roadmap %} ]({% data variables.product.prodname_roadmap_link %}) in the `github/roadmap` repository +- `github/roadmap` 仓库中的 [ {% data variables.product.prodname_roadmap %} ]({% data variables.product.prodname_roadmap_link %}) diff --git a/translations/zh-CN/content/admin/packages/configuring-packages-support-for-your-enterprise.md b/translations/zh-CN/content/admin/packages/configuring-packages-support-for-your-enterprise.md index 8800e8877fcf..54eb828a9ddc 100644 --- a/translations/zh-CN/content/admin/packages/configuring-packages-support-for-your-enterprise.md +++ b/translations/zh-CN/content/admin/packages/configuring-packages-support-for-your-enterprise.md @@ -1,24 +1,20 @@ --- -title: Configuring packages support for your enterprise -intro: 'You can configure {% data variables.product.prodname_registry %} for your enterprise by enabling or disabling each package ecosystem.' +title: 为企业配置包支持 +intro: '您可以通过启用或禁用每个包生态系统来为企业配置 {% data variables.product.prodname_registry %}。' redirect_from: - /enterprise/admin/packages/configuring-packages-support-for-your-enterprise - - /enterprise/admin/packages/configuring-packages-support-for-your-enterprise - - /enterprise/admin/packages/configuring-packages-support-for-your-enterprise - - /enterprise/admin/packages/configuring-packages-support-for-your-enterprise - - /enterprise/admin/packages/configuring-packages-support-for-your-enterprise versions: enterprise-server: '>=2.22' --- {% data reusables.package_registry.packages-ghes-release-stage %} -You can enable or disable each package ecosystem for your instance. You can set an ecosystem you previously enabled to **Read-Only** to prevent new packages from being uploaded, while allowing existing packages to be downloaded. +您可以为实例启用或禁用每个包生态系统。 您可以将之前启用的生态系统设置为**只读**，以禁止上传新软件包，同时允许下载现有的软件包。 -To use {% data variables.product.prodname_registry %} with Docker, you must have subdomain isolation enabled for your instance. For more information, see "[Enabling subdomain isolation](/enterprise/admin/configuration/enabling-subdomain-isolation)." +要将 {% data variables.product.prodname_registry %} 用于 Docker，您必须为实例启用子域隔离。 更多信息请参阅“[启用子域隔离](/enterprise/admin/configuration/enabling-subdomain-isolation)”。 {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_site_admin_settings.packages-tab %} -1. Under "Ecosystem Toggles", for each package type, select **Enabled**, **Read-Only**, or **Disabled**. ![Ecosystem toggles](/assets/images/enterprise/site-admin-settings/ecosystem-toggles.png) +1. 在“Ecosystem Toggles（生态系统切换）”下，为每个包类型选择 **Enabled（启用）**、**Read-Only（只读）**或 **Disabled（禁用）**。 ![生态系统切换](/assets/images/enterprise/site-admin-settings/ecosystem-toggles.png) {% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/zh-CN/content/admin/packages/configuring-third-party-storage-for-packages.md b/translations/zh-CN/content/admin/packages/configuring-third-party-storage-for-packages.md index 27e122cd721d..4e1f82c7f5d3 100644 --- a/translations/zh-CN/content/admin/packages/configuring-third-party-storage-for-packages.md +++ b/translations/zh-CN/content/admin/packages/configuring-third-party-storage-for-packages.md @@ -1,35 +1,31 @@ --- -title: Configuring third-party storage for packages -intro: 'You can configure the third-party service that {% data variables.product.prodname_registry %} uses to store your enterprise''s packages.' +title: 为包配置第三方存储 +intro: '您可以配置 {% data variables.product.prodname_registry %} 用于存储企业软件包的第三方服务。' redirect_from: - /enterprise/admin/packages/configuring-third-party-storage-for-packages - - /enterprise/admin/packages/configuring-third-party-storage-for-packages - - /enterprise/admin/packages/configuring-third-party-storage-for-packages - - /enterprise/admin/packages/configuring-third-party-storage-for-packages - - /enterprise/admin/packages/configuring-third-party-storage-for-packages versions: enterprise-server: '>=2.22' --- {% data reusables.package_registry.packages-ghes-release-stage %} -### About third-party storage for {% data variables.product.prodname_registry %} +### 关于 {% data variables.product.prodname_registry %} 的第三方存储 -{% data variables.product.prodname_registry %} on {% data variables.product.prodname_ghe_server %} uses external blob storage to store your packages. The amount of storage required depends on your usage of {% data variables.product.prodname_registry %}. +{% data variables.product.prodname_ghe_server %} 上的 {% data variables.product.prodname_registry %} 使用外部 Blob 存储来存储您的软件包。 所需存储量取决于您使用 {% data variables.product.prodname_registry %} 的情况。 -At this time, {% data variables.product.prodname_registry %} supports blob storage with Amazon Web Services (AWS) S3. MinIO is also supported, but configuration is not currently implemented in the {% data variables.product.product_name %} interface. You can use MinIO for storage by following the instructions for AWS S3, entering the analagous information for your MinIO configuration. +目前，{% data variables.product.prodname_registry %} 支持使用 Amazon Web Services (AWS) S3 的 Blob 存储。 还支持 MinIO，但配置当前未在 {% data variables.product.product_name %} 界面中实现。 您可以按照 AWS S3 的说明使用 MinIO 进行存储，输入 MinIO 配置的类似信息。 -For the best experience, we recommend using a dedicated bucket for {% data variables.product.prodname_registry %}, separate from the bucket you use for {% data variables.product.prodname_actions %} storage. +为了获得最佳体验，我们建议对 {% data variables.product.prodname_registry %} 使用专用存储桶，与用于 {% data variables.product.prodname_actions %} 存储的存储桶分开。 -### Configuring AWS S3 as storage for {% data variables.product.prodname_registry %} +### 将 AWS S3 配置为 {% data variables.product.prodname_registry %} 的存储系统 {% warning %} -**Warning:** Make sure to configure the bucket you'll want to use in the future. We do not recommend changing your storage after you start using {% data variables.product.prodname_registry %}. +**警告**：确保配置将来要使用的存储桶。 在开始使用 {% data variables.product.prodname_registry %} 后，我们不建议更改存储系统。 {% endwarning %} -Before you configure AWS as storage for {% data variables.product.prodname_registry %}, make sure your AWS access key ID and secret have the following permissions: +在将 AWS 配置为 {% data variables.product.prodname_registry %} 的存储系统之前，请确保您的 AWS 访问密钥 ID 和密码具有以下权限： - `s3:PutObject` - `s3:GetObject` - `s3:ListBucketMultipartUploads` @@ -41,9 +37,9 @@ Before you configure AWS as storage for {% data variables.product.prodname_regis {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_site_admin_settings.packages-tab %} -1. Under "AWS Service URL", type the S3 endpoint URL for your bucket's region. ![AWS Service URL field](/assets/images/enterprise/site-admin-settings/storage-service-url.png) -1. Under "AWS S3 Bucket", type the name of the S3 bucket you want to use to store package artifacts. ![AWS S3 Bucket field](/assets/images/enterprise/site-admin-settings/aws-s3-bucket.png) -1. Under "AWS S3 Access Key", type your access key for S3. ![AWS S3 Access Key field](/assets/images/enterprise/site-admin-settings/aws-s3-access-key.png) -1. Under "AWS S3 Secret Key", type your secret key for S3. ![AWS S3 Secret Key field](/assets/images/enterprise/site-admin-settings/aws-s3-secret-key.png) -1. Under "AWS S3 Region", type your region for S3. ![AWS S3 Region field](/assets/images/enterprise/site-admin-settings/aws-s3-region.png) +1. 在“AWS Service URL（AWS 服务 URL）”下，请为存储桶的区域键入S3 端点 URL。 ![AWS 服务 URL 字段](/assets/images/enterprise/site-admin-settings/storage-service-url.png) +1. 在“AWS S3 Bucket（AWS S3 存储桶）”下，键入您想要用来存储软件包工件的 S3 存储桶。 ![AWS S3 存储桶字段](/assets/images/enterprise/site-admin-settings/aws-s3-bucket.png) +1. 在“AWS S3 Access Key（AWS S3 访问密钥）”下，键入 S3 的访问密钥。 ![AWS S3 访问密钥字段](/assets/images/enterprise/site-admin-settings/aws-s3-access-key.png) +1. 在“AWS S3 Secret Key（AWS S3 密码密钥”下，请输入 S3 的密码密钥。 ![AWS S3 密码密钥字段](/assets/images/enterprise/site-admin-settings/aws-s3-secret-key.png) +1. 在“AWS S3 Region（AWS S3 区域）”下，键入 S3 的区域。 ![AWS S3 区域字段](/assets/images/enterprise/site-admin-settings/aws-s3-region.png) {% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/zh-CN/content/admin/packages/enabling-github-packages-for-your-enterprise.md b/translations/zh-CN/content/admin/packages/enabling-github-packages-for-your-enterprise.md index 0d06c936d1c2..c27e7985dc36 100644 --- a/translations/zh-CN/content/admin/packages/enabling-github-packages-for-your-enterprise.md +++ b/translations/zh-CN/content/admin/packages/enabling-github-packages-for-your-enterprise.md @@ -1,23 +1,17 @@ --- -title: Enabling GitHub Packages for your enterprise -intro: 'You can start using {% data variables.product.prodname_registry %} on your instance by enabling the feature, configuring third-party storage, configuring the ecosystems you want to support, and updating your TLS certificate.' +title: 为企业启用 GitHub Packages +intro: '您可以通过启用功能、配置第三方存储、配置您想要支持的生态系统以及更新您的 TLS 证书，开始使用 {% data variables.product.prodname_registry %}。' redirect_from: - /enterprise/admin/packages/enabling-github-packages-for-your-enterprise - - /enterprise/admin/packages/enabling-github-packages-for-your-enterprise - - /enterprise/admin/packages/enabling-github-packages-for-your-enterprise - - /enterprise/admin/packages/enabling-github-packages-for-your-enterprise - - /enterprise/admin/packages/enabling-github-packages-for-your-enterprise - - /enterprise/admin/packages/enabling-github-packages-for-your-enterprise - - /enterprise/admin/packages/enabling-github-packages-for-your-enterprise versions: enterprise-server: '>=2.22' --- {% data reusables.package_registry.packages-ghes-release-stage %} -1. After you've been invited to join the beta, to enable {% data variables.product.prodname_registry %} for your instance, follow the instructions from your account representative. -1. Configure third-party storage for your enterprise's packages. For more information, see "[Configuring third-party storage for packages](/enterprise/admin/packages/configuring-third-party-storage-for-packages)." -1. Enable or disable each package ecosystem for your enterprise. For more information, see "[Configuring packages support for your enterprise](/enterprise/admin/packages/configuring-packages-support-for-your-enterprise)." -1. If subdomain isolation is enabled for your instance, which is required to use {% data variables.product.prodname_registry %} with Docker, create and upload a TLS certificate that allows the package host URL for each ecosystem you want to use, such as `npm.HOSTNAME`. Make sure each package host URL includes `https://`. +1. 在您被邀请加入测试版后，要为实例启用 {% data variables.product.prodname_registry %}，请按照客户代表的指示操作。 +1. 为企业软件包配置第三方存储。 更多信息请参阅“[为软件包配置第三方存储](/enterprise/admin/packages/configuring-third-party-storage-for-packages)”。 +1. 为企业启用或禁用每个包生态系统。 更多信息请参阅“[为企业配置软件包支持](/enterprise/admin/packages/configuring-packages-support-for-your-enterprise)”。 +1. 如果您的实例启用了子域隔离，这需要 {% data variables.product.prodname_registry %} 与 Docker 一起使用，请创建并上传 TLS 证书以允许您想要使用的每个生态系统的包主机 URL，例如 `npm.HOSTNAME`。 确保每个软件包主机 URL 包含 `https:///`。 - You can create the certificate manually or using Let's Encrypt. If you already use Let's Encrypt, you must request a new TLS certificate after enabling {% data variables.product.prodname_registry %}. For more information about package host URLs, see "[Enabling subdomain isolation](/enterprise/admin/configuration/enabling-subdomain-isolation)." For more information about uploading TLS certificates to {% data variables.product.product_name %}, see "[Configuring TLS](/enterprise/admin/configuration/configuring-tls)." + 您可以手动创建证书或使用 Let's Encrypt（让我们加密）。 如果您已经使用 Let's Encrypt（让我们加密），您必须在启用 {% data variables.product.prodname_registry %} 后申请新的 TLS 证书。 有关包主机 URL 的更多信息，请参阅“[启用子域隔离](/enterprise/admin/configuration/enabling-subdomain-isolation)”。 有关将 TLS 证书上载到 {% data variables.product.product_name %} 的更多信息，请参阅“[配置 TLS](/enterprise/admin/configuration/configuring-tls)”。 diff --git a/translations/zh-CN/content/admin/packages/index.md b/translations/zh-CN/content/admin/packages/index.md index 23e44c3fbbe3..8e36ad1cf8a1 100644 --- a/translations/zh-CN/content/admin/packages/index.md +++ b/translations/zh-CN/content/admin/packages/index.md @@ -1,13 +1,9 @@ --- -title: Managing GitHub Packages for your enterprise +title: 管理企业的 GitHub Packages shortTitle: GitHub Packages -intro: 'You can enable {% data variables.product.prodname_registry %} for your enterprise and manage {% data variables.product.prodname_registry %} settings and allowed packaged types.' +intro: '您可以为企业启用 {% data variables.product.prodname_registry %}，并管理 {% data variables.product.prodname_registry %} 设置和允许的包类型。' redirect_from: - /enterprise/admin/packages - - /enterprise/admin/packages - - /enterprise/admin/packages - - /enterprise/admin/packages - - /enterprise/admin/packages versions: enterprise-server: '>=2.22' --- diff --git a/translations/zh-CN/content/admin/policies/creating-a-pre-receive-hook-environment.md b/translations/zh-CN/content/admin/policies/creating-a-pre-receive-hook-environment.md index cffad6884977..efd9096f2515 100644 --- a/translations/zh-CN/content/admin/policies/creating-a-pre-receive-hook-environment.md +++ b/translations/zh-CN/content/admin/policies/creating-a-pre-receive-hook-environment.md @@ -1,6 +1,6 @@ --- title: 创建预接收挂钩环境 -intro: 要执行预接收挂钩，请使用默认的预接收环境，或者创建自定义环境。 +intro: '要执行预接收挂钩，请使用默认的预接收环境，或者创建自定义环境。' redirect_from: - /enterprise/admin/developer-workflow/creating-a-pre-receive-hook-environment - /enterprise/admin/policies/creating-a-pre-receive-hook-environment diff --git a/translations/zh-CN/content/admin/policies/creating-a-pre-receive-hook-script.md b/translations/zh-CN/content/admin/policies/creating-a-pre-receive-hook-script.md index b9aa65c4c6ee..bbf8517ed98c 100644 --- a/translations/zh-CN/content/admin/policies/creating-a-pre-receive-hook-script.md +++ b/translations/zh-CN/content/admin/policies/creating-a-pre-receive-hook-script.md @@ -54,11 +54,11 @@ versions: | $GITHUB_REPO_PUBLIC | 一个布尔值，为 `true` 时表示公共仓库，为 `false` 时表示私有仓库。 | | $GITHUB_PUBLIC_KEY_FINGERPRINT | 用户的公钥指纹。 | | $GITHUB_PULL_REQUEST_HEAD | 格式中的字符串：`user:branch`，适用于 PR 的 HEAD。
    示例：`octocat:fix-bug` | -| $GITHUB_PULL_REQUEST_BASE | A string in the format: `user:branch` for the BASE of the PR.
    Example: `octocat:main` | +| $GITHUB_PULL_REQUEST_BASE | 格式中的字符串：`user:branch`，适用于 PR 的 BASE。
    示例： `octocat:main` | | $GITHUB_VIA | 用于创建 ref 的方法。
    **可选值：**
    - `auto-merge deployment api`
    - `blob edit`
    - `branch merge api`
    - `branches page delete button`
    - `git refs create api`
    - `git refs delete api`
    - `git refs update api`
    - `merge api`
    - `pull request branch delete button`
    - `pull request branch undo button`
    - `pull request merge api`
    - `pull request merge button`
    - `pull request revert button`
    - `releases delete button`
    - `stafftools branch restore`
    - `slumlord (#{sha})` | | $GIT_PUSH_OPTION_COUNT | 客户端发送的推送选项数。 关于推送选项的更多信息，请参阅 Git 文档中的“[git-push](https://git-scm.com/docs/git-push#git-push---push-optionltoptiongt)”。 | | $GIT_PUSH_OPTION_N | 其中 N 是一个从 0 开始的整数，此变量包含客户端发送的推送选项字符串。 发送的第一个选项存储在 GIT_PUSH_OPTION_0 中，发送的第二个选项存储在 GIT_PUSH_OPTION_1 中，依此类推。 关于推送选项的更多信息，请参阅 Git 文档中的“[git-push](https://git-scm.com/docs/git-push#git-push---push-optionltoptiongt)”。 |{% if currentVersion ver_gt "enterprise-server@2.21" %} -| $GIT_USER_AGENT | The user-agent string sent by the client that pushed the changes. |{% endif %} +| $GIT_USER_AGENT | 推送更改的客户端发送的 user-agent 字符串。 |{% endif %} ### 设置权限并将预接收挂钩推送到 {% data variables.product.prodname_ghe_server %} @@ -182,7 +182,7 @@ versions: $ git clone git@github.com:octocat/Hello-World.git $ cd Hello-World $ git remote add test git@127.0.0.1:test.git - $ GIT_SSH_COMMAND="ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no -p 52311 -i ../id_rsa" git push -u test master + $ GIT_SSH_COMMAND="ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no -p 52311 -i ../id_rsa" git push -u test main > Warning: Permanently added '[192.168.99.100]:52311' (ECDSA) to the list of known hosts. > Counting objects: 7, done. > Delta compression using up to 4 threads. @@ -191,7 +191,7 @@ versions: > Total 7 (delta 0), reused 7 (delta 0) > remote: error: rejecting all pushes > To git@192.168.99.100:test.git - > ! [remote rejected] master -> master (pre-receive hook declined) + > ! [remote rejected] main -> main (pre-receive hook declined) > error: failed to push some refs to 'git@192.168.99.100:test.git' ``` diff --git a/translations/zh-CN/content/admin/policies/enforcing-policies-for-your-enterprise.md b/translations/zh-CN/content/admin/policies/enforcing-policies-for-your-enterprise.md index 9c310ffe3e5f..dfd524307334 100644 --- a/translations/zh-CN/content/admin/policies/enforcing-policies-for-your-enterprise.md +++ b/translations/zh-CN/content/admin/policies/enforcing-policies-for-your-enterprise.md @@ -1,13 +1,8 @@ --- -title: Enforcing policies for your enterprise +title: 为企业实施策略 mapTopic: true redirect_from: - /enterprise/admin/policies/enforcing-policies-for-your-enterprise - - /enterprise/admin/policies/enforcing-policies-for-your-enterprise - - /enterprise/admin/policies/enforcing-policies-for-your-enterprise - - /enterprise/admin/policies/enforcing-policies-for-your-enterprise - - /enterprise/admin/policies/enforcing-policies-for-your-enterprise - - /enterprise/admin/policies/enforcing-policies-for-your-enterprise versions: enterprise-server: '*' --- diff --git a/translations/zh-CN/content/admin/policies/enforcing-policy-with-pre-receive-hooks.md b/translations/zh-CN/content/admin/policies/enforcing-policy-with-pre-receive-hooks.md index 9f7c86bbbfef..2d9695244db3 100644 --- a/translations/zh-CN/content/admin/policies/enforcing-policy-with-pre-receive-hooks.md +++ b/translations/zh-CN/content/admin/policies/enforcing-policy-with-pre-receive-hooks.md @@ -1,5 +1,5 @@ --- -title: Enforcing policy with pre-receive hooks +title: 使用预接收挂钩实施策略 intro: 使用预接收挂钩在您的组织内强制实施工作流程标准。 预接收挂钩需要代码在推送被送入仓库之前传递一组预定义的质量检查。 mapTopic: true redirect_from: diff --git a/translations/zh-CN/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md b/translations/zh-CN/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md index b4cb64b269f9..6e84bb8552e9 100644 --- a/translations/zh-CN/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md +++ b/translations/zh-CN/content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md @@ -1,6 +1,6 @@ --- -title: Enforcing repository management policies in your enterprise -intro: 'Enterprise owners can enforce certain repository management policies for all organizations owned by an enterprise account, or allow policies to be set in each organization.' +title: 在企业中实施仓库管理策略 +intro: '企业所有者可为企业帐户拥有的所有组织实施特定仓库管理策略，或允许在每个组织中设置策略。' redirect_from: - /enterprise/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance - /enterprise/admin/guides/user-management/preventing-users-from-changing-a-repository-s-visibility @@ -29,15 +29,15 @@ versions: enterprise-server: '*' --- -### Configuring the default visibility of new repositories on your appliance +### 在设备上配置新仓库的默认可见性 -Each time someone creates a new repository on {% data variables.product.product_location_enterprise %}, that person must choose a visibility for the repository. When you configure a default visibility setting for the instance, you choose which visibility is selected by default. For more information on repository visibility, see "[About repository visibility](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)." +每次有人在 {% data variables.product.product_location_enterprise %} 上创建新仓库时，此人必须为仓库选择可见性。 当您为实例配置默认可见性设置时，需要选择默认可见性。 有关仓库可见性的更多信息，请参阅“[关于仓库可见性](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)。” -If a site administrator disallows members from creating certain types of repositories, members will not be able to create that type of repository even if the visibility setting defaults to that type. For more information, see "[Restricting repository creation in your instance](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)." +如果站点管理员不允许成员创建某种类型的仓库，成员将无法创建此类仓库，即使可见性设置默认为此类型。 更多信息请参阅“[限制在实例中创建仓库](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)”。 {% tip %} -**Tip:** You can restrict the ability to change repository visibility to site administrators only. For more information, see "[Preventing users from changing a repository's visibility](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-a-repository-s-visibility)." +**提示**：您可以将更改仓库可见性的权限仅分配给站点管理员。 更多信息请参阅“[阻止用户更改仓库可见性](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-a-repository-s-visibility)”。 {% endtip %} @@ -49,26 +49,25 @@ If a site administrator disallows members from creating certain types of reposit {% data reusables.enterprise-accounts.settings-tab %} {% endif %} {% data reusables.enterprise-accounts.options-tab %} -1. Under "Default repository visibility", use the drop-down menu and select a default visibility. - ![Drop-down menu to choose the default repository visibility for your instance](/assets/images/enterprise/site-admin-settings/default-repository-visibility-settings.png) +1. 在“默认仓库可见性”下，使用下拉菜单并选择默认可见性。 ![用于为实例选择默认仓库可见性的下拉菜单](/assets/images/enterprise/site-admin-settings/default-repository-visibility-settings.png) {% data reusables.enterprise_installation.image-urls-viewable-warning %} -### Setting a policy for changing a repository's visibility +### 设置有关更改仓库可见性的策略 -When you prevent members from changing repository visibility, only site administrators have the ability to make public repositories private or make private repositories public. +当您阻止成员更改仓库可见性时，只有站点管理员可以将公共仓库设置为私有或者将私有仓库设置为公共。 -If a site administrator has restricted repository creation to organization owners only, then members will not be able to change repository visibility. If a site administrator has restricted member repository creation to private repositories only, then members will only be able to change repositories from public to private. For more information, see "[Setting a policy for repository creation](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)." +如果站点管理员仅允许组织所有者创建仓库，成员将无法更改仓库可见性。 如果站点管理员只允许成员创建私有仓库，则成员只能将仓库从公共更改为私有。 更多信息请参阅“[设置仓库创建策略](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)”。 {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.repositories-tab %} -5. Under "Repository visibility change", review the information about changing the setting. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} +5. 在“Repository visibility change”下，检查有关更改设置的信息。 {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} {% data reusables.enterprise-accounts.repository-visibility-policy %} -### Setting a policy for repository creation +### 设置仓库创建策略 {% data reusables.organizations.repo-creation-constants %} @@ -76,35 +75,34 @@ If a site administrator has restricted repository creation to organization owner {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.repositories-tab %} -5. Under "Repository creation", review the information about changing the setting. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} +5. 在“Repository creation”下，检查有关更改设置的信息。 {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} {% if currentVersion ver_gt "enterprise-server@2.19" %} {% data reusables.enterprise-accounts.repo-creation-policy %} {% data reusables.enterprise-accounts.repo-creation-types %} {% else %} -6. Under "Repository creation", use the drop-down menu and choose a policy. - ![Drop-down menu with repository creation policies](/assets/images/enterprise/site-admin-settings/repository-creation-drop-down.png) +6. 在“Repository creation（仓库创建）”下，使用下拉菜单并选择策略。 ![包含仓库创建策略的下拉菜单](/assets/images/enterprise/site-admin-settings/repository-creation-drop-down.png) {% endif %} -### Setting a policy for repository deletion and transfer +### 设置仓库删除和转移的策略 {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.repositories-tab %} -5. Under "Repository deletion and transfer", review the information about changing the setting. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} +5. 在“Repository deletion and transfer”下，检查有关更改设置的信息。 {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} {% data reusables.enterprise-accounts.repository-deletion-policy %} -### Setting a policy for Git push limits +### 设置 Git 推送限制策略 -To keep your repository size manageable and prevent performance issues, you can configure a file size limit for repositories on your instance. +要使仓库大小保持可管理并防止发生性能问题，可以为实例上的仓库配置文件大小限制。 -By default, when you enforce repository upload limits, people cannot add or update files larger than 100 MB. +默认情况下，强制执行仓库上传限制时，无法添加或上传超过 100 MB 的文件。 {% if currentVersion ver_lt "enterprise-server@2.20" %} {% tip %} -**Note:** Only files larger than {% data variables.large_files.warning_size %} will be checked against the Git push limit. If you need to set a lower push limit, contact {% data variables.contact.contact_ent_support %} for assistance. +**注**：仅会根据 Git 推送限制检查大于 {% data variables.large_files.warning_size %} 的文件。 如果需要设置较低的推送限制，请联系 {% data variables.contact.contact_ent_support %} 获得帮助。 {% endtip %} {% endif %} @@ -117,14 +115,12 @@ By default, when you enforce repository upload limits, people cannot add or upda {% data reusables.enterprise-accounts.settings-tab %} {% endif %} {% data reusables.enterprise-accounts.options-tab %} -4. Under "Repository upload limit", use the drop-down menu and click a maximum object size. -![Drop-down menu with maximum object size options](/assets/images/enterprise/site-admin-settings/repo-upload-limit-dropdown.png) -5. Optionally, to enforce a maximum upload limit for all repositories on {% data variables.product.product_location_enterprise %}, select **Enforce on all repositories** -![Enforce maximum object size on all repositories option](/assets/images/enterprise/site-admin-settings/all-repo-upload-limit-option.png) +4. 在“Repository upload limit”下，使用下拉菜单，然后单击最大对象大小。 ![包含最大对象大小选项的下拉菜单](/assets/images/enterprise/site-admin-settings/repo-upload-limit-dropdown.png) +5. 或者，要对 {% data variables.product.product_location_enterprise %} 上的所有仓库执行最大上传限制，请选择 select **Enforce on all repositories（对所有仓库强制执行）** ![对所有仓库选项强制执行最大对象限制](/assets/images/enterprise/site-admin-settings/all-repo-upload-limit-option.png) -### Configuring the merge conflict editor for pull requests between repositories +### 为仓库之间的拉取请求配置合并冲突编辑器 -Requiring users to resolve merge conflicts locally on their computer can prevent people from inadvertently writing to an upstream repository from a fork. +要求用户在其计算机上本地解决合并冲突可以避免用户因疏忽而从分叉写入到上游仓库。 {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} @@ -134,14 +130,13 @@ Requiring users to resolve merge conflicts locally on their computer can prevent {% data reusables.enterprise-accounts.settings-tab %} {% endif %} {% data reusables.enterprise-accounts.options-tab %} -1. Under "Conflict editor for pull requests between repositories", use the drop-down menu, and click **Disabled**. - ![Drop-down menu with option to disable the merge conflict editor](/assets/images/enterprise/settings/conflict-editor-settings.png) +1. 在“Conflict editor for pull requests between repositories”下，使用下拉菜单，然后单击 **Disabled**。 ![包含用于禁用合并冲突编辑器的选项的下拉菜单](/assets/images/enterprise/settings/conflict-editor-settings.png) -### Configuring force pushes +### 配置强制推送 -Each repository inherits a default force push setting from the settings of the user account or organization to which it belongs. Likewise, each organization and user account inherits a default force push setting from the force push setting for the entire appliance. If you change the force push setting for the appliance, it will change for all repositories owned by any user or organization. +每个仓库都从其所属的用户帐户或组织的设置继承了默认强制推送设置。 同样，每个组织和用户帐户都会从整个设备的强制推送设置继承默认强制推送设置。 如果更改设备的强制推送设置，则会更改任何用户或组织拥有的所有仓库。 -#### Blocking all force pushes on your appliance +#### 阻止设备上的所有强制推送 {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} @@ -151,11 +146,10 @@ Each repository inherits a default force push setting from the settings of the u {% data reusables.enterprise-accounts.settings-tab %} {% endif %} {% data reusables.enterprise-accounts.options-tab %} -4. Under "Force pushes", use the drop-down menu, and click **Allow**, **Block** or **Block to the default branch**. -![Force pushes dropdown](/assets/images/enterprise/site-admin-settings/force-pushes-dropdown.png) -5. Optionally, select **Enforce on all repositories**, which will override organization and repository level settings for force pushes. +4. 在“Force pushes（强制推送）”下，使用下拉菜单，然后单击 **Allow（允许）**、**Block（阻止）**或 **Block to the default branch（阻止到默认分支）**。 ![强制推送下拉菜单](/assets/images/enterprise/site-admin-settings/force-pushes-dropdown.png) +5. 可以视情况选择 **Enforce on all repositories**，这将覆盖强制推送的组织和仓库级别设置。 -#### Blocking force pushes to a specific repository +#### 阻止特定仓库的强制推送 {% data reusables.enterprise_site_admin_settings.override-policy %} @@ -165,14 +159,13 @@ Each repository inherits a default force push setting from the settings of the u {% data reusables.enterprise_site_admin_settings.click-repo %} {% data reusables.enterprise_site_admin_settings.admin-top-tab %} {% data reusables.enterprise_site_admin_settings.admin-tab %} -4. Select **Block** or **Block to the default branch** under **Push and Pull**. - ![Block force pushes](/assets/images/enterprise/site-admin-settings/repo/repo-block-force-pushes.png) +4. 在 **Push and Pull（推送和拉取）**下，选择 **Block（阻止）**或 **Block to the default branch（阻止到默认分支）**。 ![阻止强制推送](/assets/images/enterprise/site-admin-settings/repo/repo-block-force-pushes.png) -#### Blocking force pushes to repositories owned by a user account or organization +#### 阻止对用户帐户或组织拥有的仓库进行强制推送 -Repositories inherit force push settings from the user account or organization to which they belong. User accounts and organizations in turn inherit their force push settings from the force push settings for the entire appliance. +仓库从它们所属的用户帐户或组织继承强制推送设置。 反过来，用户帐户和组织从整个设备的强制推送设置继承其强制推送设置。 -You can override the default inherited settings by configuring the settings for a user account or organization. +您可以通过配置用户帐户或组织的设置来覆盖默认的继承设置。 {% data reusables.enterprise_site_admin_settings.sign-in %} {% data reusables.enterprise_site_admin_settings.access-settings %} @@ -180,28 +173,26 @@ You can override the default inherited settings by configuring the settings for {% data reusables.enterprise_site_admin_settings.click-user-or-org %} {% data reusables.enterprise_site_admin_settings.admin-top-tab %} {% data reusables.enterprise_site_admin_settings.admin-tab %} -5. Under "Repository default settings" in the "Force pushes" section, select - - **Block** to block force pushes to all branches. - - **Block to the default branch** to only block force pushes to the default branch. - ![Block force pushes](/assets/images/enterprise/site-admin-settings/user/user-block-force-pushes.png) -6. Optionally, select **Enforce on all repositories** to override repository-specific settings. Note that this will **not** override an appliance-wide policy. - ![Block force pushes](/assets/images/enterprise/site-admin-settings/user/user-block-all-force-pushes.png) +5. 在“Force pushes”部分的“Repository default settings”下，选择 + - **Block** 来阻止对所有分支进行强制推送。 + - **Block to the default branch** 来仅阻止对默认分支进行强制推送。 ![阻止强制推送](/assets/images/enterprise/site-admin-settings/user/user-block-force-pushes.png) +6. 可以视情况选择 **Enforce on all repositories** 来覆盖仓库特定的设置。 注意，这**不**会覆盖设备范围的策略。 ![阻止强制推送](/assets/images/enterprise/site-admin-settings/user/user-block-all-force-pushes.png) -### Configuring anonymous Git read access +### 配置匿名 Git 读取访问 {% data reusables.enterprise_user_management.disclaimer-for-git-read-access %} -If you have [enabled private mode](/enterprise/admin/configuration/enabling-private-mode) on your instance, you can allow repository administrators to enable anonymous Git read access to public repositories. +如果您已经在实例上[启用私密模式](/enterprise/admin/configuration/enabling-private-mode)，您可以允许仓库管理员启用对公共仓库的匿名 Git 读取访问。 -Enabling anonymous Git read access allows users to bypass authentication for custom tools on your instance. When you or a repository administrator enable this access setting for a repository, unauthenticated Git operations (and anyone with network access to {% data variables.product.prodname_ghe_server %}) will have read access to the repository without authentication. +启用匿名 Git 读取允许用户在实例上为自定义工具绕过身份验证。 当您或仓库管理员为仓库启用此权限设置时，未经过身份验证的 Git 操作（和具有 {% data variables.product.prodname_ghe_server %} 的网络访问权限的任何人）将获得仓库的读取权限（无需身份验证）。 -If necessary, you can prevent repository administrators from changing anonymous Git access settings for repositories on {% data variables.product.product_location_enterprise %} by locking the repository's access settings. After you lock a repository's Git read access setting, only a site administrator can change the setting. +如有必要，您可以通过锁定仓库的访问设置，阻止仓库管理员更改 {% data variables.product.product_location_enterprise %} 上仓库的匿名 Git 访问设置。 在您锁定仓库的 Git 读取权限设置后，只有站点管理员可以更改设置。 {% data reusables.enterprise_site_admin_settings.list-of-repos-with-anonymous-git-read-access-enabled %} {% data reusables.enterprise_user_management.exceptions-for-enabling-anonymous-git-read-access %} -#### Setting anonymous Git read access for all repositories +#### 设置所有仓库的匿名 Git 读取访问 {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} @@ -211,23 +202,17 @@ If necessary, you can prevent repository administrators from changing anonymous {% data reusables.enterprise-accounts.settings-tab %} {% endif %} {% data reusables.enterprise-accounts.options-tab %} -4. Under "Anonymous Git read access", use the drop-down menu, and click **Enabled**. -![Anonymous Git read access drop-down menu showing menu options "Enabled" and "Disabled"](/assets/images/enterprise/site-admin-settings/enable-anonymous-git-read-access.png) -3. Optionally, to prevent repository admins from changing anonymous Git read access settings in all repositories on your instance, select **Prevent repository admins from changing anonymous Git read access**. -![Select checkbox to prevent repository admins from changing anonymous Git read access settings for all repositories on your instance](/assets/images/enterprise/site-admin-settings/globally-lock-repos-from-changing-anonymous-git-read-access.png) +4. 在“Anonymous Git read access”下，使用下列菜单并单击 **Enabled**。 ![匿名 Git 读取权限下拉菜单显示菜单选项"Enabled（已启用）"和"Disabled（已禁用）"](/assets/images/enterprise/site-admin-settings/enable-anonymous-git-read-access.png) +3. 或者，如果要阻止仓库管理员为实例上的所有仓库更改匿名 Git 读取权限设置，请选择 **Prevent repository admins from changing anonymous Git read access**。 ![选中复选框可阻止仓库管理员更改实例上所有仓库的匿名 Git 读取权限设置。](/assets/images/enterprise/site-admin-settings/globally-lock-repos-from-changing-anonymous-git-read-access.png) -#### Setting anonymous Git read access for a specific repository +#### 设置特定仓库的匿名 Git 读取访问 {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.repository-search %} {% data reusables.enterprise_site_admin_settings.click-repo %} {% data reusables.enterprise_site_admin_settings.admin-top-tab %} {% data reusables.enterprise_site_admin_settings.admin-tab %} -6. Under "Danger Zone", next to "Enable Anonymous Git read access", click **Enable**. -!["Enabled" button under "Enable anonymous Git read access" in danger zone of a repository's site admin settings ](/assets/images/enterprise/site-admin-settings/site-admin-enable-anonymous-git-read-access.png) -7. Review the changes. To confirm, click **Yes, enable anonymous Git read access.** -![Confirm anonymous Git read access setting in pop-up window](/assets/images/enterprise/site-admin-settings/confirm-anonymous-git-read-access-for-specific-repo-as-site-admin.png) -8. Optionally, to prevent repository admins from changing this setting for this repository, select **Prevent repository admins from changing anonymous Git read access**. -![Select checkbox to prevent repository admins from changing anonymous Git read access for this repository](/assets/images/enterprise/site-admin-settings/lock_anonymous_git_access_for_specific_repo.png) - +6. 在“Danger Zone”下的“Enable Anonymous Git read access”旁，请单击 **Enable**。 ![仓库站点管理员设置的危险区域中“Enable anonymous Git read access”下的“Enabled”按钮 ](/assets/images/enterprise/site-admin-settings/site-admin-enable-anonymous-git-read-access.png) +7. 审查更改。 要确认，请单击 **Yes, enable anonymous Git read access（是，启用匿名 Git 读取权限）**。 ![在弹出窗口中确认匿名 Git 读取权限设置](/assets/images/enterprise/site-admin-settings/confirm-anonymous-git-read-access-for-specific-repo-as-site-admin.png) +8. 或者，如果要阻止仓库管理员为此仓库更改设置，请选择 **Prevent repository admins from changing anonymous Git read access**。 ![选中复选框可阻止仓库管理员更改此仓库的匿名 Git 读取权限。](/assets/images/enterprise/site-admin-settings/lock_anonymous_git_access_for_specific_repo.png) diff --git a/translations/zh-CN/content/admin/policies/index.md b/translations/zh-CN/content/admin/policies/index.md index fcb4d040358b..c9ea0e2f4601 100644 --- a/translations/zh-CN/content/admin/policies/index.md +++ b/translations/zh-CN/content/admin/policies/index.md @@ -1,6 +1,6 @@ --- -title: Setting policies for your enterprise -intro: 'You can set policies in {% data variables.product.prodname_enterprise %} to reduce risk and increase quality.' +title: 为企业设置策略 +intro: '您可以在 {% data variables.product.prodname_enterprise %} 中设置策略来降低风险并提高质量。' redirect_from: - /enterprise/admin/developer-workflow - /enterprise/admin/policies diff --git a/translations/zh-CN/content/admin/user-management/audit-logging.md b/translations/zh-CN/content/admin/user-management/audit-logging.md index 06d7afbc09ef..6c0f6fb7f37f 100644 --- a/translations/zh-CN/content/admin/user-management/audit-logging.md +++ b/translations/zh-CN/content/admin/user-management/audit-logging.md @@ -9,7 +9,7 @@ versions: enterprise-server: '*' --- -For a full list, see "[Audited actions](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions)." For more information on finding a particular action, see "[Searching the audit log](/enterprise/{{ currentVersion }}/admin/guides/installation/searching-the-audit-log)." +有关完整列表，请参阅“[审核的操作](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions)”。 有关查找特定操作的详细信息，请参阅“[搜索审核日志](/enterprise/{{ currentVersion }}/admin/guides/installation/searching-the-audit-log)”。 ### 推送日志 @@ -34,5 +34,5 @@ Oct 26 01:42:08 github-ent github_audit: {:created_at=>1351215728326, :actor_ip= 此示例显示提交已推送到仓库。 ``` -Oct 26 02:19:31 github-ent github_audit: { "pid":22860, "ppid":22859, "program":"receive-pack", "git_dir":"/data/repositories/some-user/some-repository.git", "hostname":"github-ent", "pusher":"some-user", "real_ip":"10.0.0.51", "user_agent":"git/1.7.10.4", "repo_id":1, "repo_name":"some-user/some-repository", "transaction_id":"b031b7dc7043c87323a75f7a92092ef1456e5fbaef995c68", "frontend_ppid":1, "repo_public":true, "user_name":"some-user", "user_login":"some-user", "frontend_pid":18238, "frontend":"github-ent", "user_email":"some-user@github.example.com", "user_id":2, "pgroup":"github-ent_22860", "status":"post_receive_hook", "features":" report-status side-band-64k", "received_objects":3, "receive_pack_size":243, "non_fast_forward":false, "current_ref":"refs/heads/master" } +Oct 26 02:19:31 github-ent github_audit: { "pid":22860, "ppid":22859, "program":"receive-pack", "git_dir":"/data/repositories/some-user/some-repository.git", "hostname":"github-ent", "pusher":"some-user", "real_ip":"10.0.0.51", "user_agent":"git/1.7.10.4", "repo_id":1, "repo_name":"some-user/some-repository", "transaction_id":"b031b7dc7043c87323a75f7a92092ef1456e5fbaef995c68", "frontend_ppid":1, "repo_public":true, "user_name":"some-user", "user_login":"some-user", "frontend_pid":18238, "frontend":"github-ent", "user_email":"some-user@github.example.com", "user_id":2, "pgroup":"github-ent_22860", "status":"post_receive_hook", "features":" report-status side-band-64k", "received_objects":3, "receive_pack_size":243, "non_fast_forward":false, "current_ref":"refs/heads/main" } ``` diff --git a/translations/zh-CN/content/admin/user-management/audited-actions.md b/translations/zh-CN/content/admin/user-management/audited-actions.md index a7a83500898d..de5c4c8e963a 100644 --- a/translations/zh-CN/content/admin/user-management/audited-actions.md +++ b/translations/zh-CN/content/admin/user-management/audited-actions.md @@ -35,8 +35,8 @@ versions: #### 实例配置设置 -| 名称 | 描述 | -| -------------------------------------------------------:| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 名称 | 描述 | +| -------------------------------------------------------:| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `business.update_member_repository_creation_permission` | 站点管理员限制在实例上的组织中创建仓库。 更多信息请参阅“[限制在实例中创建仓库](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)”。 | | `business.clear_members_can_create_repos` | 站点管理员取消了对在实例上的组织中创建仓库的限制。 更多信息请参阅“[限制在实例中创建仓库](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)”。 | | `enterprise.config.lock_anonymous_git_access` | 站点管理员锁定匿名 Git 读取权限，以防止仓库管理员更改该实例上仓库的现有匿名 Git 读取权限设置。 更多信息请参阅“[阻止用户更改匿名 Git 读取权限](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)”。 | @@ -44,19 +44,19 @@ versions: #### 议题和拉取请求 -| 名称 | 描述 | -| ------------------------------------:| -------------------------------------------------------------------------------------------- | -| `issue.update` | 问题的正文文本（初始注释）已更改。 | -| `issue_comment.update` | 已更改问题的正文文本（初始注释）。 | -| `pull_request_review_comment.delete` | A comment on a pull request was deleted. | +| 名称 | 描述 | +| ------------------------------------:| ---------------------------------------------------------------------------------------------- | +| `issue.update` | 问题的正文文本（初始注释）已更改。 | +| `issue_comment.update` | 已更改问题的正文文本（初始注释）。 | +| `pull_request_review_comment.delete` | 已删除对拉取请求的评论。 | | `issue.destroy` | 已从仓库中删除问题。 更多信息请参阅“[删除问题](/enterprise/{{ currentVersion }}/user/articles/deleting-an-issue)"。” | #### 组织 -| 名称 | 描述 | -| ------------------:| ---------------------------------------------------------------------------------------------------------------------- | -| `org.async_delete` | 用户发起了删除组织的后台作业。 | -| `org.delete` | 组织已由用户发起的后台作业删除。 | +| 名称 | 描述 | +| ------------------:| ------------------------------------------------------------------------------------------------------------------------ | +| `org.async_delete` | 用户发起了删除组织的后台作业。 | +| `org.delete` | 组织已由用户发起的后台作业删除。 | | `org.transform` | 已将用户帐户转换为组织。 更多信息请参阅“[将用户转换为组织](/enterprise/{{ currentVersion}}/user/articles/converting-a-user-into-an-organization/)”。 | #### 受保护分支 @@ -76,18 +76,18 @@ versions: #### 仓库 -| 名称 | 描述 | -| ------------------------------------------:| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `repo.access` | 已将私有仓库设为公共，或者已将公共仓库设为私有。 | +| 名称 | 描述 | +| ------------------------------------------:| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `repo.access` | 已将私有仓库设为公共，或者已将公共仓库设为私有。 | | `repo.archive` | 已存档仓库。 更多信息请参阅“[存档和取消存档仓库](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/)”。 | -| `repo.add_member` | 已向仓库添加协作者。 | +| `repo.add_member` | 已向仓库添加协作者。 | | `repo.config` | 站点管理员已阻止强制推送。 更多信息请参阅“[阻止对仓库进行强制推送](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository/)”。 | -| `repo.create` | 已创建仓库。 | -| `repo.destroy` | 已删除仓库。 | -| `repo.remove_member` | 已从仓库中移除协作者。 | -| `repo.rename` | 已重命名仓库。 | -| `repo.transfer` | 用户已接受接收传输仓库的请求。 | -| `repo.transfer_start` | 用户已发送向另一用户或组织传输仓库的请求。 | +| `repo.create` | 已创建仓库。 | +| `repo.destroy` | 已删除仓库。 | +| `repo.remove_member` | 已从仓库中移除协作者。 | +| `repo.rename` | 已重命名仓库。 | +| `repo.transfer` | 用户已接受接收传输仓库的请求。 | +| `repo.transfer_start` | 用户已发送向另一用户或组织传输仓库的请求。 | | `repo.unarchive` | 已取消存档仓库。 更多信息请参阅“[存档和取消存档仓库](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/)”。 | | `repo.config.disable_anonymous_git_access` | 已为公共仓库禁用匿名 Git 读取权限。 更多信息请参阅“[为仓库启用匿名 Git 读取权限](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)。” | | `repo.config.enable_anonymous_git_access` | 已为公共仓库启用匿名 Git 读取权限。 更多信息请参阅“[为仓库启用匿名 Git 读取权限](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)。” | @@ -96,13 +96,13 @@ versions: #### 站点管理员工具 -| 名称 | 描述 | -| --------------------:| ---------------------------------------------------------------------- | -| `staff.disable_repo` | 站点管理员已禁用对仓库及其所有复刻的访问。 | -| `staff.enable_repo` | 站点管理员已重新启用对仓库及其所有复刻的访问。 | +| 名称 | 描述 | +| --------------------:| ----------------------------------------------------------------- | +| `staff.disable_repo` | 站点管理员已禁用对仓库及其所有复刻的访问。 | +| `staff.enable_repo` | 站点管理员已重新启用对仓库及其所有复刻的访问。 | | `staff.fake_login` | 站点管理员以另一用户的身份登录 {% data variables.product.prodname_enterprise %}。 | -| `staff.repo_unlock` | 站点管理员已解锁（临时获得完全访问权限）用户的一个私有仓库。 | -| `staff.unlock` | 站点管理员已解锁（临时获得完全访问权限）用户的所有私有仓库。 | +| `staff.repo_unlock` | 站点管理员已解锁（临时获得完全访问权限）用户的一个私有仓库。 | +| `staff.unlock` | 站点管理员已解锁（临时获得完全访问权限）用户的所有私有仓库。 | #### 团队 diff --git a/translations/zh-CN/content/admin/user-management/configuring-email-for-notifications.md b/translations/zh-CN/content/admin/user-management/configuring-email-for-notifications.md index 72aedbe656fa..79c82f720a7e 100644 --- a/translations/zh-CN/content/admin/user-management/configuring-email-for-notifications.md +++ b/translations/zh-CN/content/admin/user-management/configuring-email-for-notifications.md @@ -44,7 +44,7 @@ versions: 1. 确保您的 SMTP 服务器可以访问实例上的端口 25。 2. 创建一个指向 `reply.[hostname]` 的 A 记录。 根据您的 DNS 提供商和实例主机配置，您可以创建一个指向 `*.[hostname]` 的 A 记录。 3. 创建一个指向 `reply.[hostname]` 的 MX 记录，以便发送到该域的电子邮件可以路由到实例。 -4. 创建一个将 `noreply.[hostname]` 指向 `[hostname]` 的 MX 记录，以便对通知电子邮件中 `cc` 地址的回复可以路由到实例。 更多信息请参阅{% if currentVersion ver_gt "enterprise-server@2.20" %}"[配置通知](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications){% else %}“[关于电子邮件通知](/github/receiving-notifications-about-activity-on-github/about-email-notifications){% endif %}。” +4. 创建一个将 `noreply.[hostname]` 指向 `[hostname]` 的 MX 记录，以便对通知电子邮件中 `cc` 地址的回复可以路由到实例。 更多信息请参阅{% if currentVersion ver_gt "enterprise-server@2.20" %}“[配置通知](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications){% else %}“[关于电子邮件通知](/github/receiving-notifications-about-activity-on-github/about-email-notifications){% endif %}。” 借助 DNS 配置，您现在可以测试设置是否能够正常运行。 diff --git a/translations/zh-CN/content/admin/user-management/configuring-git-large-file-storage-for-your-enterprise.md b/translations/zh-CN/content/admin/user-management/configuring-git-large-file-storage-for-your-enterprise.md index 5d7f438b7474..6081e1264980 100644 --- a/translations/zh-CN/content/admin/user-management/configuring-git-large-file-storage-for-your-enterprise.md +++ b/translations/zh-CN/content/admin/user-management/configuring-git-large-file-storage-for-your-enterprise.md @@ -1,5 +1,5 @@ --- -title: Configuring Git Large File Storage for your enterprise +title: 为企业配置 Git 大型文件存储 intro: '{% data reusables.enterprise_site_admin_settings.configuring-large-file-storage-short-description %}' redirect_from: - /enterprise/admin/guides/installation/configuring-git-large-file-storage-on-github-enterprise/ @@ -94,11 +94,11 @@ versions: $ git add .lfsconfig $ git commit -m "Adding LFS config file" ``` -3. 迁移任何现有的 {% data variables.large_files.product_name_short %} 资源。 For more information, see "[Migrating to a different {% data variables.large_files.product_name_long %} server](#migrating-to-a-different-git-large-file-storage-server)." +3. 迁移任何现有的 {% data variables.large_files.product_name_short %} 资源。 更多信息请参阅“[迁移到不同的 {% data variables.large_files.product_name_long %} 服务器](#migrating-to-a-different-git-large-file-storage-server)”。 ### 迁移到其他 Git Large File Storage 服务器 -迁移到其他 {% data variables.large_files.product_name_long %} 服务器之前，您必须将 {% data variables.large_files.product_name_short %} 配置为使用第三方服务器。 For more information, see "[Configuring {% data variables.large_files.product_name_long %} to use a third party server](#configuring-git-large-file-storage-to-use-a-third-party-server)." +迁移到其他 {% data variables.large_files.product_name_long %} 服务器之前，您必须将 {% data variables.large_files.product_name_short %} 配置为使用第三方服务器。 解更多信息请参阅“[配置 {% data variables.large_files.product_name_long %} 使用第三方服务器](#configuring-git-large-file-storage-to-use-a-third-party-server)”。 1. 使用第二个远端配置仓库。 ```shell diff --git a/translations/zh-CN/content/admin/user-management/creating-teams.md b/translations/zh-CN/content/admin/user-management/creating-teams.md index 70c735994d75..e50cf0d86b01 100644 --- a/translations/zh-CN/content/admin/user-management/creating-teams.md +++ b/translations/zh-CN/content/admin/user-management/creating-teams.md @@ -1,6 +1,6 @@ --- title: 创建团队 -intro: 借助团队，组织可以创建成员组和控制仓库的访问权限。 可以向团队成员授予特定仓库的读取、写入或管理员权限。 +intro: '借助团队，组织可以创建成员组和控制仓库的访问权限。 可以向团队成员授予特定仓库的读取、写入或管理员权限。' redirect_from: - /enterprise/admin/user-management/creating-teams versions: @@ -15,7 +15,7 @@ versions: ### 创建团队 -审慎的团队组合是控制仓库权限的强有力方式。 For example, if your organization allows only your release engineering team to push code to the default branch of any repository, you could give only the release engineering team **admin** permissions to your organization's repositories and give all other teams **read** permissions. +审慎的团队组合是控制仓库权限的强有力方式。 例如，如果您的组织仅允许发布工程团队向任何仓库的默认分支推送代码，您可以仅向发布工程团队授予组织仓库的**管理员**权限，向所有其他团队授予**读取**权限。 {% data reusables.profile.enterprise_access_profile %} {% data reusables.profile.access_org %} @@ -28,7 +28,7 @@ versions: ### 创建启用 LDAP 同步的团队 -使用 LDAP 进行用户身份验证的实例可以使用 LDAP 同步管理团队的成员。 在 **LDAP group（LDAP 组）** 字段中设置组的 **Distinguished Name（识别名称）**(DN) 会在您的 LDAP 服务器上将团队映射到 LDAP 组。 如果您使用 LDAP 同步管理团队的成员，将无法管理 {% data variables.product.product_location_enterprise %} 内的团队。 启用 LDAP 同步后，映射的团队将以配置的间隔定期在后台同步成员。 更多信息请参阅“[启用 LDAP 同步](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)”。 +使用 LDAP 进行用户身份验证的实例可以使用 LDAP 同步管理团队的成员。 在 **LDAP group（LDAP 组）** 字段中设置组的 **Distinguished Name（识别名称）**(DN) 会在您的 LDAP 服务器上将团队映射到 LDAP 组。 如果您使用 LDAP 同步管理团队的成员，将无法管理 {% data variables.product.product_location_enterprise %} 内的团队。 启用 LDAP 同步后，映射的团队将以配置的间隔定期在后台同步成员。 更多信息请参阅“[启用 LDAP 同步](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)”。 {% data reusables.enterprise_user_management.ldap-sync-nested-teams %} @@ -36,17 +36,19 @@ versions: **注意：** - LDAP 同步仅管理团队的成员列表。 您必须在 {% data variables.product.prodname_ghe_server %} 内管理团队的仓库和权限。 -- 如果到 DN 的 LDAP 组映射被移除（例如，LDAP 组被删除），将从同步的 {% data variables.product.prodname_ghe_server %} 团队中移除每个成员。 要解决这个问题，请将团队映射到新 DN，重新添加团队成员，并[手动同步映射](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap/#manually-syncing-ldap-accounts)。 +- 如果到 DN 的 LDAP 组映射被移除（例如，LDAP 组被删除），将从同步的 {% data variables.product.prodname_ghe_server %} 团队中移除每个成员。 要解决这个问题，请将团队映射到新 DN，重新添加团队成员，并[手动同步映射](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap/#manually-syncing-ldap-accounts)。 - 启用 LDAP 同步后，如果某个用户被从仓库中移除，他们将失去访问权限，但是他们的分叉将不会删除。 如果某个用户被添加到团队中并在三个月内拥有原始组织仓库的访问权限，他们对分叉的访问权限将在下一次同步时自动恢复。 {% endwarning %} -1. 确保[启用 LDAP 同步](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)。 +1. 确保[启用 LDAP 同步](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)。 {% data reusables.profile.enterprise_access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.new_team %} {% data reusables.organizations.team_name %} -6. 搜索要映射团队的目标 LDAP 组的 DN。 如果您不知道 DN，请输入 LDAP 组的名称。 {% data variables.product.prodname_ghe_server %} 将搜索并自动完成任何匹配。 ![映射到 LDAP 组 DN](/assets/images/enterprise/orgs-and-teams/ldap-group-mapping.png) +6. 搜索要映射团队的目标 LDAP 组的 DN。 如果您不知道 DN，请输入 LDAP 组的名称。 +{% data variables.product.prodname_ghe_server %} 将搜索并自动完成任何匹配。 +![映射到 LDAP 组 DN](/assets/images/enterprise/orgs-and-teams/ldap-group-mapping.png) {% data reusables.organizations.team_description %} {% data reusables.organizations.team_visibility %} {% data reusables.organizations.create-team-choose-parent %} diff --git a/translations/zh-CN/content/admin/user-management/customizing-user-messages-on-your-instance.md b/translations/zh-CN/content/admin/user-management/customizing-user-messages-on-your-instance.md index 5d839423a01b..2ff11f5021da 100644 --- a/translations/zh-CN/content/admin/user-management/customizing-user-messages-on-your-instance.md +++ b/translations/zh-CN/content/admin/user-management/customizing-user-messages-on-your-instance.md @@ -3,7 +3,7 @@ title: 自定义您的实例上的用户消息 redirect_from: - /enterprise/admin/user-management/creating-a-custom-sign-in-message/ - /enterprise/admin/user-management/customizing-user-messages-on-your-instance -intro: '您可以创建{% if currentVersion ver_gt "enterprise-server@2.15" %}用户将在登录和退出页面上看到的自定义消息{% else %}用户将在登录页面上看到的自定义消息{% endif %}。' +intro: '您可以创建用户将在登录和退出页面上{% if currentVersion ver_gt "enterprise-server@2.21" %} 或在每个页面顶部的公告横幅中{% endif %} 看到的自定义消息。' versions: enterprise-server: '*' --- @@ -43,19 +43,19 @@ versions: {% data reusables.enterprise_site_admin_settings.save-changes %} {% if currentVersion ver_gt "enterprise-server@2.21" %} -### Creating a global announcement banner +### 创建全局公告横幅 -You can set a global announcement banner to be displayed to all users at the top of every page. +您可以设置全局公告横幅，以便在每个页面顶部向所有用户显示。 -You can also set an announcement banner in the administrative shell using a command line utility. For more information, see "[Command-line utilities](/enterprise/admin/configuration/command-line-utilities#ghe-announce)." +您还可以使用命令行工具在管理 shell 中设置公告横幅。 更多信息请参阅“[命令行实用程序](/enterprise/admin/configuration/command-line-utilities#ghe-announce)”。 {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.messages-tab %} 1. 在“Sign out page”下，单击 **Add message** 或 **Edit message**。 ![Add message 按钮](/assets/images/enterprise/site-admin-settings/add-announcement-button.png) -1. Under "Announcement", in the text field, type the announcement you want displayed in a banner. ![Text field to enter announcement](/assets/images/enterprise/site-admin-settings/announcement-text-field.png) -1. Optionally, under "Expires on", use the calendar drop-down menu, and select an expiration date. ![Calendar drop-down menu to choose expiration date](/assets/images/enterprise/site-admin-settings/expiration-drop-down.png) +1. 在“Announcement（公告）”下的在文本字段中键入要显示在横幅中的公告。 ![用于输入公告的文本字段](/assets/images/enterprise/site-admin-settings/announcement-text-field.png) +1. （可选）在“Expires on（到期日）”下，使用日历下拉菜单选择一个到期日。 ![用于选择到期日期的日历下拉菜单](/assets/images/enterprise/site-admin-settings/expiration-drop-down.png) 1. 在“Sign in page”下，单击 **Add message** 或 **Edit message**。 ![Preview 按钮](/assets/images/enterprise/site-admin-settings/preview-announcement-button.png) 1. 单击 **Save changes（保存更改）**。 ![Edit message 按钮](/assets/images/enterprise/site-admin-settings/save-announcement-button.png) {% endif %} diff --git a/translations/zh-CN/content/admin/user-management/exporting-migration-data-from-githubcom.md b/translations/zh-CN/content/admin/user-management/exporting-migration-data-from-githubcom.md index 0b4cec9a4eef..e39978d80b9e 100644 --- a/translations/zh-CN/content/admin/user-management/exporting-migration-data-from-githubcom.md +++ b/translations/zh-CN/content/admin/user-management/exporting-migration-data-from-githubcom.md @@ -1,6 +1,6 @@ --- title: 从 GitHub.com 导出迁移数据 -intro: 'You can export migration data from an organization on {% data variables.product.prodname_dotcom_the_website %} by using the API to select repositories to migrate, then generating a migration archive that you can import into a {% data variables.product.prodname_ghe_server %} instance.' +intro: '您可以使用 API 选择要迁移的创建，然后生成可导入到 {% data variables.product.prodname_ghe_server %} 实例的迁移存档，从而从 {% data variables.product.prodname_dotcom_the_website %} 上的组织导出迁移数据。' redirect_from: - /enterprise/admin/guides/migrations/exporting-migration-data-from-github-com - /enterprise/admin/migrations/exporting-migration-data-from-githubcom @@ -13,7 +13,7 @@ versions: enterprise-server: '*' --- -### Preparing the source organization on {% data variables.product.prodname_dotcom %} +### 在 {% data variables.product.prodname_dotcom %} 上准备源组织 1. 确保您在源组织的仓库上具有[所有者权限](/articles/permission-levels-for-an-organization/)。 @@ -21,7 +21,7 @@ versions: {% data reusables.enterprise_migrations.make-a-list %} -### Exporting the organization's repositories +### 导出组织的仓库 {% data reusables.enterprise_migrations.fork-persistence %} diff --git a/translations/zh-CN/content/admin/user-management/exporting-migration-data-from-your-enterprise.md b/translations/zh-CN/content/admin/user-management/exporting-migration-data-from-your-enterprise.md index 49d59788ed54..42d28e734df1 100644 --- a/translations/zh-CN/content/admin/user-management/exporting-migration-data-from-your-enterprise.md +++ b/translations/zh-CN/content/admin/user-management/exporting-migration-data-from-your-enterprise.md @@ -1,6 +1,6 @@ --- -title: Exporting migration data from your enterprise -intro: 'To change platforms or move from a trial instance to a production instance, you can export migration data from a {% data variables.product.prodname_ghe_server %} instance by preparing the instance, locking the repositories, and generating a migration archive.' +title: 从企业导出迁移数据 +intro: '要更改平台或从试用实例迁移到生产实例，可以通过准备实例、锁定仓库和生成迁移存档来从 {% data variables.product.prodname_ghe_server %} 实例导出迁移数据。' redirect_from: - /enterprise/admin/guides/migrations/exporting-migration-data-from-github-enterprise/ - /enterprise/admin/migrations/exporting-migration-data-from-github-enterprise-server @@ -13,7 +13,7 @@ versions: enterprise-server: '*' --- -### Preparing the {% data variables.product.prodname_ghe_server %} source instance +### 准备 {% data variables.product.prodname_ghe_server %} 源实例 1. 验证您在 {% data variables.product.prodname_ghe_server %} 源上是站点管理员。 最好的方式是验证您可以[通过 SSH 访问实例](/enterprise/admin/guides/installation/accessing-the-administrative-shell-ssh/)。 @@ -21,7 +21,7 @@ versions: {% data reusables.enterprise_migrations.make-a-list %} -### Exporting the {% data variables.product.prodname_ghe_server %} source repositories +### 导出 {% data variables.product.prodname_ghe_server %} 源仓库 {% data reusables.enterprise_migrations.locking-repositories %} diff --git a/translations/zh-CN/content/admin/user-management/index.md b/translations/zh-CN/content/admin/user-management/index.md index 063ba0acf247..b5fe990e481f 100644 --- a/translations/zh-CN/content/admin/user-management/index.md +++ b/translations/zh-CN/content/admin/user-management/index.md @@ -1,6 +1,6 @@ --- -title: 'Managing users, organizations, and repositories' -shortTitle: 'Managing users, organizations, and repositories' +title: '管理用户、组织和仓库' +shortTitle: '管理用户、组织和仓库' redirect_from: - /enterprise/admin/categories/user-management/ - /enterprise/admin/developer-workflow/using-webhooks-for-continuous-integration diff --git a/translations/zh-CN/content/admin/user-management/managing-dormant-users.md b/translations/zh-CN/content/admin/user-management/managing-dormant-users.md index bad769240511..f21b2ea49518 100644 --- a/translations/zh-CN/content/admin/user-management/managing-dormant-users.md +++ b/translations/zh-CN/content/admin/user-management/managing-dormant-users.md @@ -1,47 +1,38 @@ --- -title: Managing dormant users +title: 管理休眠用户 redirect_from: - /enterprise/admin/articles/dormant-users/ - /enterprise/admin/articles/viewing-dormant-users/ - /enterprise/admin/articles/determining-whether-a-user-account-is-dormant/ - /enterprise/admin/user-management/managing-dormant-users - - /enterprise/admin/user-management/managing-dormant-users - - /enterprise/admin/user-management/managing-dormant-users - - /enterprise/admin/user-management/managing-dormant-users - - /enterprise/admin/user-management/managing-dormant-users - - /enterprise/admin/user-management/managing-dormant-users -intro: A user account is considered to be dormant if it has not been active for at least a month. You may choose to suspend dormant users to free up user licenses. +intro: 如果一个月或更长时间不活动，用户帐户会被视为休眠。 您可以选择暂停休眠用户以释放用户许可证。 versions: enterprise-server: '*' --- -"Activity" includes, but is not limited to: -- Signing in to {% data variables.product.prodname_ghe_server %}. -- Commenting on issues and pull requests. -- Creating, deleting, watching, and starring repositories. -- Pushing commits.{% if currentVersion ver_gt "enterprise-server@2.21" %} -- Accessing resources by using a personal access token or SSH key.{% endif %} +“活动”包括但不限于： +- 登录 {% data variables.product.prodname_ghe_server %}。 +- 评论问题和拉取请求。 +- 创建、删除、关注仓库和加星标。 +- 推送提交。{% if currentVersion ver_gt "enterprise-server@2.21" %} +- 使用个人访问令牌或 SSH 密钥访问资源。{% endif %} -### Viewing dormant users +### 查看休眠用户 -You can view a list of all dormant users who have not been suspended and who are not site administrators. +您可以查看未被挂起和不属于站点管理员的所有休眠用户的列表。 {% data reusables.enterprise_site_admin_settings.access-settings %} -3. In the left sidebar, click **Dormant users**. -![Dormant users tab](/assets/images/enterprise/site-admin-settings/dormant-users-tab.png) -4. To suspend all the dormant users in this list, at the top of the page, click **Suspend all**. -![Suspend all button](/assets/images/enterprise/site-admin-settings/suspend-all.png) +3. 在左侧边栏中，单击 **Dormant users**。 ![Dormant users 选项卡](/assets/images/enterprise/site-admin-settings/dormant-users-tab.png) +4. 要挂起此列表中的所有休眠用户，请在页面顶部单击 **Suspend all**。 ![Suspend all 按钮](/assets/images/enterprise/site-admin-settings/suspend-all.png) -### Determining whether a user account is dormant +### 确定用户帐户是否休眠 {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.search-user %} {% data reusables.enterprise_site_admin_settings.click-user %} -5. In the **User info** section, a red dot with the word "Dormant" indicates the user account is dormant, and a green dot with the word "Active" indicates the user account is active. -![Dormant user account](/assets/images/enterprise/stafftools/dormant-user.png) -![Active user account](/assets/images/enterprise/stafftools/active-user.png) +5. 在 **User info** 部分中，后面为“Dormant”的红点表示该用户帐户为休眠状态，后面为“Active”的绿点表示该用户帐户处于活跃状态。 ![Dormant 用户帐户](/assets/images/enterprise/stafftools/dormant-user.png) ![Active 用户帐户](/assets/images/enterprise/stafftools/active-user.png) -### Configuring the dormancy threshold +### 配置休眠阈值 {% data reusables.enterprise_site_admin_settings.dormancy-threshold %} @@ -53,5 +44,4 @@ You can view a list of all dormant users who have not been suspended and who are {% data reusables.enterprise-accounts.settings-tab %} {% endif %} {% data reusables.enterprise-accounts.options-tab %} -4. Under "Dormancy threshold", use the drop-down menu, and click the desired dormancy threshold. -![The Dormancy threshold drop-down menu](/assets/images/enterprise/site-admin-settings/dormancy-threshold-menu.png) +4. 在“Dormancy threshold”，使用下拉菜单，然后单击所需的休眠阈值。 ![Dormancy threshold 下拉菜单](/assets/images/enterprise/site-admin-settings/dormancy-threshold-menu.png) diff --git a/translations/zh-CN/content/admin/user-management/managing-global-webhooks.md b/translations/zh-CN/content/admin/user-management/managing-global-webhooks.md index ff8f501538e4..b22be32a5212 100644 --- a/translations/zh-CN/content/admin/user-management/managing-global-webhooks.md +++ b/translations/zh-CN/content/admin/user-management/managing-global-webhooks.md @@ -1,6 +1,6 @@ --- title: 管理全局 web 挂钩 -intro: 站点管理员可以查看、添加、编辑和删除全局 web 挂钩，在实例级别跟踪事件。 +intro: '站点管理员可以查看、添加、编辑和删除全局 web 挂钩，在实例级别跟踪事件。' redirect_from: - /enterprise/admin/user-management/about-global-webhooks - /enterprise/admin/user-management/managing-global-webhooks @@ -12,9 +12,9 @@ versions: 您可以使用全局 web 挂钩自动监视、响应或者为实例上的用户和组织管理强制执行规则。 例如，您可以将 web 挂钩配置为在以下情况下执行： - 创建或删除用户帐户 -- An organization is created or deleted +- 创建或删除组织 - 向仓库添加协作者或从仓库中移除协作者 -- A repository is forked +- 复刻仓库 ![全局 web 挂钩列表](/assets/images/enterprise/site-admin-settings/list-of-global-webhooks.png) diff --git a/translations/zh-CN/content/admin/user-management/managing-organizations-in-your-enterprise.md b/translations/zh-CN/content/admin/user-management/managing-organizations-in-your-enterprise.md index 563061a8a1f3..5fd3de9f9962 100644 --- a/translations/zh-CN/content/admin/user-management/managing-organizations-in-your-enterprise.md +++ b/translations/zh-CN/content/admin/user-management/managing-organizations-in-your-enterprise.md @@ -1,11 +1,11 @@ --- -title: Managing organizations in your enterprise +title: 管理企业中的组织 redirect_from: - /enterprise/admin/articles/adding-users-and-teams/ - /enterprise/admin/categories/admin-bootcamp/ - /enterprise/admin/user-management/organizations-and-teams - /enterprise/admin/user-management/managing-organizations-in-your-enterprise -intro: 组织适合在您的公司内创建不同的用户组，例如部门或参与相似项目的组。 属于某个组织的公共仓库也可供其他组织的用户使用，但私有仓库仅供该组织的成员使用。 +intro: '组织适合在您的公司内创建不同的用户组，例如部门或参与相似项目的组。 属于某个组织的公共仓库也可供其他组织的用户使用，但私有仓库仅供该组织的成员使用。' mapTopic: true versions: enterprise-server: '*' diff --git a/translations/zh-CN/content/admin/user-management/managing-repositories-in-your-enterprise.md b/translations/zh-CN/content/admin/user-management/managing-repositories-in-your-enterprise.md index 99a1349b282d..a320194df2fc 100644 --- a/translations/zh-CN/content/admin/user-management/managing-repositories-in-your-enterprise.md +++ b/translations/zh-CN/content/admin/user-management/managing-repositories-in-your-enterprise.md @@ -1,5 +1,5 @@ --- -title: Managing repositories in your enterprise +title: 管理企业中的仓库 intro: '您可以管理您的 {% data variables.product.prodname_ghe_server %} 设备上可供仓库管理员使用的设置。' redirect_from: - /enterprise/admin/user-management/repositories diff --git a/translations/zh-CN/content/admin/user-management/managing-users-in-your-enterprise.md b/translations/zh-CN/content/admin/user-management/managing-users-in-your-enterprise.md index 3a731bfdc620..43f1854f6e10 100644 --- a/translations/zh-CN/content/admin/user-management/managing-users-in-your-enterprise.md +++ b/translations/zh-CN/content/admin/user-management/managing-users-in-your-enterprise.md @@ -1,5 +1,5 @@ --- -title: Managing users in your enterprise +title: 管理企业中的用户 intro: '在用户能够在 {% data variables.product.product_location_enterprise %} 上进行身份验证后，他们会想要设置几项基本的自定义个人资料，例如头像和电子邮件通知。' redirect_from: - /enterprise/admin/guides/user-management/enabling-avatars-and-identicons/ diff --git a/translations/zh-CN/content/admin/user-management/migrating-data-to-and-from-your-enterprise.md b/translations/zh-CN/content/admin/user-management/migrating-data-to-and-from-your-enterprise.md index 483b9b7cfc9a..53615fedb8c9 100644 --- a/translations/zh-CN/content/admin/user-management/migrating-data-to-and-from-your-enterprise.md +++ b/translations/zh-CN/content/admin/user-management/migrating-data-to-and-from-your-enterprise.md @@ -1,5 +1,5 @@ --- -title: Migrating data to and from your enterprise +title: 将数据迁移到企业或从企业迁移数据 intro: '您可以从 {% data variables.product.prodname_ghe_server %} 或 {% data variables.product.prodname_dotcom_the_website %} 导出用户、组织和仓库数据，然后将此数据导入至 {% data variables.product.product_location_enterprise %}。' mapTopic: true redirect_from: diff --git a/translations/zh-CN/content/admin/user-management/migrating-data-to-your-enterprise.md b/translations/zh-CN/content/admin/user-management/migrating-data-to-your-enterprise.md index 6751a4e2bd83..31eaa6921eff 100644 --- a/translations/zh-CN/content/admin/user-management/migrating-data-to-your-enterprise.md +++ b/translations/zh-CN/content/admin/user-management/migrating-data-to-your-enterprise.md @@ -1,5 +1,5 @@ --- -title: Migrating data to your enterprise +title: 将数据迁移到企业 intro: '生成迁移存档后，您可以将数据导入目标 {% data variables.product.prodname_ghe_server %} 实例。 在将变更永久应用到目标实例之前，您需要检查变更，查看有无潜在的冲突。' redirect_from: - /enterprise/admin/guides/migrations/importing-migration-data-to-github-enterprise/ @@ -15,7 +15,7 @@ versions: enterprise-server: '*' --- -### Applying the imported data on {% data variables.product.prodname_ghe_server %} +### 在 {% data variables.product.prodname_ghe_server %} 上应用导入的数据 {% data reusables.enterprise_installation.ssh-into-target-instance %} @@ -106,9 +106,9 @@ $ ghe-migrator audit -s failed_import,failed_map,failed_rename,failed_merge -g < 如果您对失败的导入有任何疑问，请联系 {% data variables.contact.contact_ent_support %}。 -### Completing the import on {% data variables.product.prodname_ghe_server %} +### 在 {% data variables.product.prodname_ghe_server %} 上完成导入 -After your migration is applied to your target instance and you have reviewed the migration, you''ll unlock the repositories and delete them off the source. 我们建议等待两周再删除您的源数据，以便确保所有数据都能按预期运行。 +在迁移应用到目标实例并且您已审查迁移后，您需要解锁仓库并将其从源中删除。 我们建议等待两周再删除您的源数据，以便确保所有数据都能按预期运行。 ### 在目标实例上解锁仓库 @@ -117,7 +117,7 @@ After your migration is applied to your target instance and you have reviewed th ### 在源上解锁仓库 -#### Unlocking repositories from an organization on {% data variables.product.prodname_dotcom_the_website %} +#### 从 {% data variables.product.prodname_dotcom_the_website %} 上的组织解锁仓库 要在 {% data variables.product.prodname_dotcom_the_website %} 组织中解锁仓库，您需要向迁移解锁端点发送 `DELETE` 请求。 您需要： * 身份验证的访问令牌 @@ -129,7 +129,7 @@ curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X DELETE \ https://api.github.com/orgs/orgname/migrations/id/repos/repo_name/lock ``` -#### Deleting repositories from an organization on {% data variables.product.prodname_dotcom_the_website %} +#### 从 {% data variables.product.prodname_dotcom_the_website %} 上的组织中删除仓库 在解锁 {% data variables.product.prodname_dotcom_the_website %} 组织的仓库后，您应当使用[仓库删除端点](/enterprise/{{ currentVersion }}/v3/repos/#delete-a-repository)删除之前迁移的每一个仓库。 您需要身份验证的访问令牌： ```shell diff --git a/translations/zh-CN/content/admin/user-management/monitoring-activity-in-your-enterprise.md b/translations/zh-CN/content/admin/user-management/monitoring-activity-in-your-enterprise.md index 4cb0fba63363..da617866c7db 100644 --- a/translations/zh-CN/content/admin/user-management/monitoring-activity-in-your-enterprise.md +++ b/translations/zh-CN/content/admin/user-management/monitoring-activity-in-your-enterprise.md @@ -1,14 +1,9 @@ --- -title: Monitoring activity in your enterprise +title: 监控企业中的活动 mapTopic: true redirect_from: - /enterprise/admin/installation/monitoring-activity-on-your-github-enterprise-server-instance - /enterprise/admin/user-management/monitoring-activity-in-your-enterprise - - /enterprise/admin/user-management/monitoring-activity-in-your-enterprise - - /enterprise/admin/user-management/monitoring-activity-in-your-enterprise - - /enterprise/admin/user-management/monitoring-activity-in-your-enterprise - - /enterprise/admin/user-management/monitoring-activity-in-your-enterprise - - /enterprise/admin/user-management/monitoring-activity-in-your-enterprise versions: enterprise-server: '*' --- diff --git a/translations/zh-CN/content/admin/user-management/preparing-to-migrate-data-to-your-enterprise.md b/translations/zh-CN/content/admin/user-management/preparing-to-migrate-data-to-your-enterprise.md index f042f29c3c7f..3456d3ba6957 100644 --- a/translations/zh-CN/content/admin/user-management/preparing-to-migrate-data-to-your-enterprise.md +++ b/translations/zh-CN/content/admin/user-management/preparing-to-migrate-data-to-your-enterprise.md @@ -1,5 +1,5 @@ --- -title: Preparing to migrate data to your enterprise +title: 准备将数据迁移到企业 intro: '生成迁移存档后，您可以将数据导入目标 {% data variables.product.prodname_ghe_server %} 实例。 在将变更永久应用到目标实例之前，您需要检查变更，查看有无潜在的冲突。' redirect_from: - /enterprise/admin/migrations/preparing-the-migrated-data-for-import-to-github-enterprise-server @@ -12,7 +12,7 @@ versions: enterprise-server: '*' --- -### Preparing the migrated data for import to {% data variables.product.prodname_ghe_server %} +### 准备迁移的数据以导入到 {% data variables.product.prodname_ghe_server %} 1. 使用 [`scp`](https://linuxacademy.com/blog/linux/ssh-and-scp-howto-tips-tricks#scp) 命令将从源实例或组织生成的迁移存档复制到 {% data variables.product.prodname_ghe_server %} 目标： @@ -37,7 +37,7 @@ versions: ```shell $ ghe-migrator conflicts -g MIGRATION_GUID > conflicts.csv ``` - - If no conflicts are reported, you can safely import the data by following the steps in "[Migrating data to your enterprise](/enterprise/admin/guides/migrations/applying-the-imported-data-on-github-enterprise-server/)". + - 如果未报告冲突，您可以按照“[将数据迁移到企业](/enterprise/admin/guides/migrations/applying-the-imported-data-on-github-enterprise-server/)”中的步骤操作，安全地导入数据。 2. 如果存在冲突，请使用 [`scp`](https://linuxacademy.com/blog/linux/ssh-and-scp-howto-tips-tricks#scp) 命令将 *conflicts.csv* 复制到您的本地计算机： ```shell $ scp -P 122 admin@hostname:conflicts.csv ~/Desktop @@ -79,7 +79,7 @@ versions: | `map_or_rename` | 如果存在目标，请映射到该目标。 否则，请重命名导入的模型。 | 用户 | | `合并` | 源中的数据将与目标中的现有数据合并。 | 团队 | -**We strongly suggest you review the *conflicts.csv* file and use [`ghe-migrator audit`](/enterprise/admin/guides/migrations/reviewing-migration-data) to ensure that the proper actions are being taken.** If everything looks good, you can continue to "[Migrating data to your enterprise](/enterprise/admin/guides/migrations/applying-the-imported-data-on-github-enterprise-server)". +**我们强烈建议您检查 *conflicts.csv* 文件并使用 [`ghe-migrator audit`](/enterprise/admin/guides/migrations/reviewing-migration-data)，以确保正确的操作。**如果一切正常，您可以继续“[将数据迁移到企业](/enterprise/admin/guides/migrations/applying-the-imported-data-on-github-enterprise-server)”。 ### 解决迁移冲突或设置自定义映射 diff --git a/translations/zh-CN/content/admin/user-management/promoting-or-demoting-a-site-administrator.md b/translations/zh-CN/content/admin/user-management/promoting-or-demoting-a-site-administrator.md index 86b12da5a4b3..6d949b1a0cf1 100644 --- a/translations/zh-CN/content/admin/user-management/promoting-or-demoting-a-site-administrator.md +++ b/translations/zh-CN/content/admin/user-management/promoting-or-demoting-a-site-administrator.md @@ -4,14 +4,14 @@ redirect_from: - /enterprise/admin/articles/promoting-a-site-administrator/ - /enterprise/admin/articles/demoting-a-site-administrator/ - /enterprise/admin/user-management/promoting-or-demoting-a-site-administrator -intro: 站点管理员可以将任何普通用户升级为站点管理员，也可以将其他站点管理员降级为普通用户。 +intro: '站点管理员可以将任何普通用户升级为站点管理员，也可以将其他站点管理员降级为普通用户。' versions: enterprise-server: '*' --- {% tip %} -**注**：如果已[启用 LDAP 同步](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)并且在[为用户配置 LDAP 访问](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#configuring-ldap-with-your-github-enterprise-server-instance)时设置了 `Administrators group` 属性，这些用户将自动获得您的实例的站点管理员访问权限。 在这种情况下，您无法按照下面的步骤手动升级用户；您必须将其添加到 LDAP 管理员组中。 +**注**：如果已[启用 LDAP 同步](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)并且在[为用户配置 LDAP 访问](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#configuring-ldap-with-your-github-enterprise-server-instance)时设置了 `Administrators group` 属性，这些用户将自动获得您的实例的站点管理员访问权限。 在这种情况下，您无法按照下面的步骤手动升级用户；您必须将其添加到 LDAP 管理员组中。 {% endtip %} @@ -34,7 +34,7 @@ versions: {% data reusables.enterprise-accounts.administrators-tab %} 1. 在页面左上角的“Find an administrator（查找管理员）”搜索字段中，输入您想要降级的人员的用户名。 ![用于查找管理员的搜索字段](/assets/images/help/business-accounts/business-account-search-for-admin.png) -1. In the search results, find the username of the person you want to demote, then use the {% octicon "gear" %} drop-down menu, and select **Remove owner**. ![从企业选项中删除](/assets/images/help/business-accounts/demote-admin-button.png) +1. 在搜索结果中，查找您想要降级的人员的用户名，然后使用 {% octicon "gear" %} 下拉菜单选择 **Remove owner（删除所有者）**。 ![从企业选项中删除](/assets/images/help/business-accounts/demote-admin-button.png) ### 从命令行升级用户 diff --git a/translations/zh-CN/content/admin/user-management/rebuilding-contributions-data.md b/translations/zh-CN/content/admin/user-management/rebuilding-contributions-data.md index 804706c8bed5..05293c009493 100644 --- a/translations/zh-CN/content/admin/user-management/rebuilding-contributions-data.md +++ b/translations/zh-CN/content/admin/user-management/rebuilding-contributions-data.md @@ -15,4 +15,5 @@ versions: 3. 在页面的左侧，单击 **Admin**。 ![Admin 选项卡](/assets/images/enterprise/site-admin-settings/admin-tab.png) 4. 在 **Contributions data** 下，单击 **Rebuild**。 ![Rebuild 按钮](/assets/images/enterprise/site-admin-settings/rebuild-button.png) -{% data variables.product.prodname_enterprise %} 现在会开始后台作业，将提交与用户帐户重新关联。 ![已排队的重构作业](/assets/images/enterprise/site-admin-settings/rebuild-jobs.png) +{% data variables.product.prodname_enterprise %} 现在会开始后台作业，将提交与用户帐户重新关联。 + ![已排队的重构作业](/assets/images/enterprise/site-admin-settings/rebuild-jobs.png) diff --git a/translations/zh-CN/content/admin/user-management/removing-users-from-teams-and-organizations.md b/translations/zh-CN/content/admin/user-management/removing-users-from-teams-and-organizations.md index 3be506f496c7..269c28e0dc88 100644 --- a/translations/zh-CN/content/admin/user-management/removing-users-from-teams-and-organizations.md +++ b/translations/zh-CN/content/admin/user-management/removing-users-from-teams-and-organizations.md @@ -1,6 +1,6 @@ --- title: 从团队和组织中移除用户 -intro: 如果组织的成员不再需要某些仓库的访问权限，您可以从允许权限的团队中移除他们。 如果组织的成员不再需要组织拥有的任何仓库的访问权限 ，则可以从组织中移除他们。 +intro: '如果组织的成员不再需要某些仓库的访问权限，您可以从允许权限的团队中移除他们。 如果组织的成员不再需要组织拥有的任何仓库的访问权限 ，则可以从组织中移除他们。' redirect_from: - /enterprise/admin/user-management/removing-users-from-teams-and-organizations versions: diff --git a/translations/zh-CN/content/admin/user-management/requiring-two-factor-authentication-for-an-organization.md b/translations/zh-CN/content/admin/user-management/requiring-two-factor-authentication-for-an-organization.md index c2774db7400f..636b0d93e2f3 100644 --- a/translations/zh-CN/content/admin/user-management/requiring-two-factor-authentication-for-an-organization.md +++ b/translations/zh-CN/content/admin/user-management/requiring-two-factor-authentication-for-an-organization.md @@ -1,6 +1,6 @@ --- title: 为组织要求双重身份验证 -intro: 您可以要求组织成员和外部协作者为他们在组织中的个人帐户启用双重身份验证，使恶意操作者更难以访问组织的仓库和设置。 +intro: '您可以要求组织成员和外部协作者为他们在组织中的个人帐户启用双重身份验证，使恶意操作者更难以访问组织的仓库和设置。' redirect_from: - /enterprise/admin/user-management/requiring-two-factor-authentication-for-an-organization versions: @@ -49,7 +49,7 @@ versions: 您还可以在搜索中使用组织名称，查看已从特定组织中移除的用户： - `org:octo-org AND reason:two_factor_requirement_non_compliance` -5. Click **Search**. +5. 单击 **Search（搜索）**。 ### 帮助被删除的成员和外部协作者重新加入您的组织 diff --git a/translations/zh-CN/content/admin/user-management/searching-the-audit-log.md b/translations/zh-CN/content/admin/user-management/searching-the-audit-log.md index 6622d1a93141..fab192c52e2f 100644 --- a/translations/zh-CN/content/admin/user-management/searching-the-audit-log.md +++ b/translations/zh-CN/content/admin/user-management/searching-the-audit-log.md @@ -13,22 +13,22 @@ versions: 由一个或多个键值对（以 AND/OR 逻辑运算符分隔）构成一个搜索查询。 -| 键 | 值 | -| --------------:| ------------------------------------------------------------------------------------ | -| `actor_id` | 发起操作的用户帐户的 ID | -| `actor` | 发起操作的用户帐户的名称 | -| `oauth_app_id` | 与操作相关联的 OAuth 应用程序的 ID | +| 键 | 值 | +| --------------:| -------------------------------------------------------------------------------------- | +| `actor_id` | 发起操作的用户帐户的 ID | +| `actor` | 发起操作的用户帐户的名称 | +| `oauth_app_id` | 与操作相关联的 OAuth 应用程序的 ID | | `action` | [审核的操作](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions)的名称 | -| `user_id` | 受操作影响的用户的 ID | -| `用户` | 受操作影响的用户的名称 | -| `repo_id` | 受操作影响的仓库的 ID（若适用） | -| `repo` | 受操作影响的仓库的名称（若适用） | -| `actor_ip` | 发起操作的 IP 地址 | -| `created_at` | 操作发生的时间 | -| `from` | 发起操作的视图 | -| `note` | 事件特定的其他信息（采用纯文本或 JSON 格式） | -| `org` | 受操作影响的组织的名称（若适用） | -| `org_id` | 受操作影响的组织的 ID（若适用） | +| `user_id` | 受操作影响的用户的 ID | +| `用户` | 受操作影响的用户的名称 | +| `repo_id` | 受操作影响的仓库的 ID（若适用） | +| `repo` | 受操作影响的仓库的名称（若适用） | +| `actor_ip` | 发起操作的 IP 地址 | +| `created_at` | 操作发生的时间 | +| `from` | 发起操作的视图 | +| `note` | 事件特定的其他信息（采用纯文本或 JSON 格式） | +| `org` | 受操作影响的组织的名称（若适用） | +| `org_id` | 受操作影响的组织的 ID（若适用） | 例如，要查看自 2017 年初开始影响仓库 `octocat/Spoon-Knife` 的所有操作： diff --git a/translations/zh-CN/content/admin/user-management/suspending-and-unsuspending-users.md b/translations/zh-CN/content/admin/user-management/suspending-and-unsuspending-users.md index 9d47c0fec23a..1e5119c1678a 100644 --- a/translations/zh-CN/content/admin/user-management/suspending-and-unsuspending-users.md +++ b/translations/zh-CN/content/admin/user-management/suspending-and-unsuspending-users.md @@ -27,7 +27,7 @@ fatal: The remote end hung up unexpectedly {% tip %} -**注**：如果已为 {% data variables.product.product_location_enterprise %} [启用 LDAP 同步](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)，那么当用户从 LDAP 目录服务器中移除时，他们也将被自动挂起。 为您的实例启用 LDAP 同步后，将禁用普通用户挂起方法。 +**注**：如果已为 {% data variables.product.product_location_enterprise %} [启用 LDAP 同步](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)，那么当用户从 LDAP 目录服务器中移除时，他们也将被自动挂起。 为您的实例启用 LDAP 同步后，将禁用普通用户挂起方法。 {% endtip %} diff --git a/translations/zh-CN/content/admin/user-management/troubleshooting-service-hooks.md b/translations/zh-CN/content/admin/user-management/troubleshooting-service-hooks.md index a1fa85471af1..7f307cc7951b 100644 --- a/translations/zh-CN/content/admin/user-management/troubleshooting-service-hooks.md +++ b/translations/zh-CN/content/admin/user-management/troubleshooting-service-hooks.md @@ -1,6 +1,6 @@ --- title: 排查服务挂钩问题 -intro: 如果没有交付有效负载，请检查这些常见问题。 +intro: '如果没有交付有效负载，请检查这些常见问题。' redirect_from: - /enterprise/admin/articles/troubleshooting-service-hooks/ - /enterprise/admin/developer-workflow/troubleshooting-service-hooks @@ -25,7 +25,7 @@ versions: 2. 浏览到您要调查的仓库。 3. 单击导航侧栏中的 **Hooks** 链接。 ![挂钩侧边栏](/assets/images/enterprise/settings/Enterprise-Hooks-Sidebar.png) 4. 单击有问题的服务挂钩下的 **Latest Delivery** 链接。 -5. Click **Delivery**. ![查看有效负载](/assets/images/enterprise/settings/Enterprise-Hooks-Payload.png) +5. 单击 **Delivery（交付）**。 ![查看有效负载](/assets/images/enterprise/settings/Enterprise-Hooks-Payload.png) ### 查看过去的交付 diff --git a/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-a-repository-from-github-to-github-desktop.md b/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-a-repository-from-github-to-github-desktop.md index afe3d5cbc15b..e930a5d95baa 100644 --- a/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-a-repository-from-github-to-github-desktop.md +++ b/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-a-repository-from-github-to-github-desktop.md @@ -15,7 +15,9 @@ versions: {% mac %} -1. 开始克隆前，请先登录到 {% data variables.product.product_location %} 和 {% data variables.product.prodname_desktop %}。 +1. 登录到 + +{% data variables.product.product_location %} 和 {% data variables.product.prodname_desktop %}，然后开始克隆。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.open-with-github-desktop %} 5. 单击 **Choose...（选择...）**，并使用 Finder 窗口找到要克隆仓库的本地路径。 ![URL 选项卡中的选择按钮](/assets/images/help/desktop/clone-choose-button-url-mac.png) @@ -32,7 +34,9 @@ versions: {% windows %} -1. 开始克隆前，请先登录到 {% data variables.product.product_location %} 和 {% data variables.product.prodname_desktop %}。 +1. 登录到 + +{% data variables.product.product_location %} 和 {% data variables.product.prodname_desktop %}，然后开始克隆。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.open-with-github-desktop %} 5. 单击 **Choose...（选择...）**，并使用 Windows 资源管理器找到要克隆仓库的本地路径。 ![选择按钮](/assets/images/help/desktop/clone-choose-button-url-win.png) diff --git a/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop.md b/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop.md index bce2f4cff407..549f065d12ea 100644 --- a/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop.md +++ b/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop.md @@ -19,8 +19,8 @@ versions: ![Mac 应用程序中的克隆菜单选项](/assets/images/help/desktop/clone-file-menu-mac.png) {% data reusables.desktop.cloning-location-tab %} ![克隆仓库菜单中的 Location（位置）选项卡](/assets/images/help/desktop/choose-repository-location-mac.png) -{% data reusables.desktop.cloning-repository-list %} -![克隆仓库列表](/assets/images/help/desktop/clone-a-repository-list-mac.png) +{% data reusables.desktop.cloning-repository-list %} + ![克隆仓库列表](/assets/images/help/desktop/clone-a-repository-list-mac.png) 4. 单击 **Choose...（选择...）**，并使用 Finder 窗口找到要克隆仓库的本地路径。 ![选择按钮](/assets/images/help/desktop/clone-choose-button-mac.png) 5. 单击 **Clone（克隆）**。 ![克隆按钮](/assets/images/help/desktop/clone-button-mac.png) @@ -32,8 +32,8 @@ versions: ![Windows 应用程序中的克隆菜单选项](/assets/images/help/desktop/clone-file-menu-windows.png) {% data reusables.desktop.cloning-location-tab %} ![克隆仓库菜单中的 Location（位置）选项卡](/assets/images/help/desktop/choose-repository-location-win.png) -{% data reusables.desktop.cloning-repository-list %} -![克隆仓库列表](/assets/images/help/desktop/clone-a-repository-list-win.png) +{% data reusables.desktop.cloning-repository-list %} + ![克隆仓库列表](/assets/images/help/desktop/clone-a-repository-list-win.png) 4. 单击 **Choose...（选择...）**，并使用 Windows 资源管理器找到要克隆仓库的本地路径。 ![选择按钮](/assets/images/help/desktop/clone-choose-button-win.png) 5. 单击 **Clone（克隆）**。 ![克隆按钮](/assets/images/help/desktop/clone-button-win.png) diff --git a/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/committing-and-reviewing-changes-to-your-project.md b/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/committing-and-reviewing-changes-to-your-project.md index 5e5348a715ca..d39ec7603241 100644 --- a/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/committing-and-reviewing-changes-to-your-project.md +++ b/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/committing-and-reviewing-changes-to-your-project.md @@ -15,9 +15,9 @@ versions: ### 1. 选择一个分支并进行更改 -1. [Create a new branch](/desktop/guides/contributing-to-projects/managing-branches), or select an existing branch by clicking +1. [创建一个新分支](/desktop/guides/contributing-to-projects/managing-branches)，或选择一个现有分支，方法是单击 -{% octicon "git-branch" aria-label="The branch icon" %} **Current Branch** on the toolbar and selecting the branch from the list. +工具栏上的 {% octicon "git-branch" aria-label="The branch icon" %} **Current Branch（当前分支）**并从列表中选择分支。 ![用于切换当前分支的下拉菜单](/assets/images/help/desktop/click-branch-in-drop-down.png) {% data reusables.desktop.make-changes %} diff --git a/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request.md b/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request.md index 2a4bdda50292..f3651dbcf187 100644 --- a/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request.md +++ b/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request.md @@ -1,7 +1,7 @@ --- title: 创建议题或拉取请求 intro: 您可以创建议题或拉取请求，以提议并协作更改仓库。 -permissions: 任何人都可以在已启用议题的公共仓库创建议题。 对仓库具有读取权限的任何人都可以创建拉取请求，但要创建分支，必须具有写入权限。 +permissions: '任何人都可以在已启用议题的公共仓库创建议题。 对仓库具有读取权限的任何人都可以创建拉取请求，但要创建分支，必须具有写入权限。' redirect_from: - /desktop/contributing-to-projects/creating-an-issue-or-pull-request - /desktop/contributing-to-projects/creating-a-pull-request @@ -50,7 +50,9 @@ versions: 1. 切换到要为其创建拉取请求的分支。 更多信息请参阅“[在分支之间切换](/desktop/contributing-and-collaborating-using-github-desktop/managing-branches#switching-between-branches)”。 2. 单击 **Create pull request（创建拉取请求）**。 {% data variables.product.prodname_desktop %} 会将您的默认浏览器打开至 {% data variables.product.prodname_dotcom %}。 ![创建拉取请求按钮](/assets/images/help/desktop/mac-create-pull-request.png) -4. 在 {% data variables.product.prodname_dotcom %} 上，确认 **base:** 下拉菜单中的分支是要合并更改的分支。 确认 **compare:** 下拉菜单中的分支是您进行了更改的主题分支。 ![用于选择基础和比较分支的下拉菜单](/assets/images/help/desktop/base-and-compare-branches.png) +4. 在 +{% data variables.product.prodname_dotcom %} 上，确认 **base:** 下拉菜单中的分支是要合并更改的分支。 确认 **compare:** 下拉菜单中的分支是您进行了更改的主题分支。 + ![用于选择基础和比较分支的下拉菜单](/assets/images/help/desktop/base-and-compare-branches.png) {% data reusables.repositories.pr-title-description %} {% data reusables.repositories.create-pull-request %} @@ -60,7 +62,9 @@ versions: 1. 切换到要为其创建拉取请求的分支。 更多信息请参阅“[在分支之间切换](/desktop/contributing-and-collaborating-using-github-desktop/managing-branches#switching-between-branches)”。 2. 单击 **Create pull request（创建拉取请求）**。 {% data variables.product.prodname_desktop %} 会将您的默认浏览器打开至 {% data variables.product.prodname_dotcom %}。 ![创建拉取请求按钮](/assets/images/help/desktop/windows-create-pull-request.png) -3. 在 {% data variables.product.prodname_dotcom %} 上，确认 **base:** 下拉菜单中的分支是要合并更改的分支。 确认 **compare:** 下拉菜单中的分支是您进行了更改的主题分支。 ![用于选择基础和比较分支的下拉菜单](/assets/images/help/desktop/base-and-compare-branches.png) +3. 在 +{% data variables.product.prodname_dotcom %} 上，确认 **base:** 下拉菜单中的分支是要合并更改的分支。 确认 **compare:** 下拉菜单中的分支是您进行了更改的主题分支。 + ![用于选择基础和比较分支的下拉菜单](/assets/images/help/desktop/base-and-compare-branches.png) {% data reusables.repositories.pr-title-description %} {% data reusables.repositories.create-pull-request %} diff --git a/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/index.md b/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/index.md index 6b3d25ebac05..f742c579dddb 100644 --- a/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/index.md +++ b/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/index.md @@ -1,7 +1,7 @@ --- title: 使用 GitHub Desktop 参与和协作 shortTitle: 参与和协作 -intro: 使用 GitHub Desktop 管理项目，创建有意义的提交，并在应用程序（而非命令行）中跟踪项目的历史记录。 +intro: '使用 GitHub Desktop 管理项目，创建有意义的提交，并在应用程序（而非命令行）中跟踪项目的历史记录。' redirect_from: - /desktop/contributing-to-projects versions: diff --git a/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/syncing-your-branch.md b/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/syncing-your-branch.md index 6203917ab116..91402217529f 100644 --- a/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/syncing-your-branch.md +++ b/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/syncing-your-branch.md @@ -21,10 +21,10 @@ versions: 1. 在 {% data variables.product.prodname_desktop %} 中，使用 {% octicon "git-branch" aria-label="The branch icon" %} **Current Branch（当前分支）**下拉菜单，然后选择要更新的本地分支。 2. 要检查远程分支上的提交，请单击 **Fetch origin（获取源)** ![提取源按钮](/assets/images/help/desktop/fetch-button.png) -3. To pull any commits from the remote branch, click **Pull origin** or **Pull origin with rebase**. ![拉取源按钮](/assets/images/help/desktop/pull-button.png) +3. 要从远程分支拉取任何提交，请点击 **Pull origin（拉取来源）**或 **Pull origin with rebase（包含变基的的拉取来源）**。 ![拉取源按钮](/assets/images/help/desktop/pull-button.png) {% data reusables.desktop.resolve-merge-conflicts %} -### Merging another branch into your project branch +### 将另一个分支合并到项目分支 {% data reusables.desktop.current-branch-menu %} {% data reusables.desktop.choose-a-branch-to-merge %} @@ -39,15 +39,15 @@ versions: ![合并按钮](/assets/images/help/desktop/merge-branch-button.png) {% data reusables.desktop.push-origin %} -### Rebasing your project branch onto another branch +### 将项目分支变基到另一个分支 {% mac %} -1. In the menu bar, use the **Branch** drop-down and click **Rebase Current Branch**. ![在分支中重新变基当前分支下拉菜单](/assets/images/help/desktop/mac-rebase-current-branch.png) +1. 在菜单栏中，使用 **Branch（分支）**下拉菜单，并单击 **Rebase Current Branch（变基当前分支）**。 ![在分支中重新变基当前分支下拉菜单](/assets/images/help/desktop/mac-rebase-current-branch.png) 2. 单击要变基到当前分支的分支，然后单击 **Start rebase（开始变基）**。 ![开始变基按钮](/assets/images/help/desktop/start-rebase-button.png) 3. 如果确定要变基，请单击 **Begin rebase（开始变基）**。 ![开始变基按钮](/assets/images/help/desktop/begin-rebase-button.png) {% data reusables.desktop.resolve-merge-conflicts %} -4. To push your local changes, click **Force push origin**. ![强制推送源](/assets/images/help/desktop/force-push-origin.png) +4. 要推送本地更改，请单击 **Force push origin（强制推送源）**。 ![强制推送源](/assets/images/help/desktop/force-push-origin.png) {% endmac %} @@ -62,6 +62,6 @@ versions: {% endwindows %} ### 延伸阅读 -- "[Pull](/github/getting-started-with-github/github-glossary#pull)" in the {% data variables.product.prodname_dotcom %} glossary -- "[Merge](/github/getting-started-with-github/github-glossary#merge)" in the {% data variables.product.prodname_dotcom %} glossary -- "[Rebase](/github/getting-started-with-github/github-glossary#rebase)" in the {% data variables.product.prodname_dotcom %} glossary +- {% data variables.product.prodname_dotcom %} 词汇表中的“[拉取](/github/getting-started-with-github/github-glossary#pull)” +- {% data variables.product.prodname_dotcom %} 词汇表中的“[合并](/github/getting-started-with-github/github-glossary#merge)” +- {% data variables.product.prodname_dotcom %} 词汇表中的“[变基](/github/getting-started-with-github/github-glossary#rebase)” diff --git a/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/viewing-a-pull-request-in-github-desktop.md b/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/viewing-a-pull-request-in-github-desktop.md index bc7899a49721..d2a650b4edf8 100644 --- a/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/viewing-a-pull-request-in-github-desktop.md +++ b/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/viewing-a-pull-request-in-github-desktop.md @@ -1,6 +1,6 @@ --- -title: Viewing a pull request in GitHub Desktop -shortTitle: Viewing a pull request +title: 在 GitHub Desktop 中查看拉取请求 +shortTitle: 查看拉取请求 intro: '您可以在 {% data variables.product.prodname_desktop %} 上打开的拉取请求中查看提议的更改。' redirect_from: - /desktop/contributing-to-projects/accessing-a-pull-request-locally @@ -9,10 +9,10 @@ versions: free-pro-team: '*' --- -### About pull requests in {% data variables.product.prodname_desktop %} -You can view pull requests that you or your collaborators have proposed in {% data variables.product.prodname_desktop %}. Pull requests let you propose changes to projects, provide feedback and reviews, and merge changes into projects. 更多信息请参阅“[关于拉取请求](/github/collaborating-with-issues-and-pull-requests/about-pull-requests)”。 +### 关于 {% data variables.product.prodname_desktop %} 中的拉取请求 +您可以查看您或您的协作者在 {% data variables.product.prodname_desktop %} 中提出的拉取请求。 拉取请求可让您对项目提出更改，提供反馈和评论，并将更改合并到项目中。 更多信息请参阅“[关于拉取请求](/github/collaborating-with-issues-and-pull-requests/about-pull-requests)”。 -When you view a pull request in {% data variables.product.prodname_desktop %}, you can see a history of commits that contributors made. You can also see which files the commits modified, added, or deleted. From {% data variables.product.prodname_desktop %}, you can open repositories in your preferred text editor to view any changes or make additional changes. After reviewing changes in a pull request, you can give feedback on {% data variables.product.prodname_dotcom %}. 更多信息请参阅“[关于拉取请求审查](/github/collaborating-with-issues-and-pull-requests/about-pull-request-reviews)”。 +在 {% data variables.product.prodname_desktop %} 中查看拉取请求时，您可以看到贡献者的提交历史记录。 您还可以查看修改、添加或删除了提交的文件。 从 {% data variables.product.prodname_desktop %} 可以在首选文本编辑器中打开仓库以查看任何更改或进行其他更改。 在审查拉取请求中的更改后，您可以对 {% data variables.product.prodname_dotcom %} 提供反馈。 更多信息请参阅“[关于拉取请求审查](/github/collaborating-with-issues-and-pull-requests/about-pull-request-reviews)”。 ### 在 {% data variables.product.prodname_desktop %} 中查看拉取请求 {% data reusables.desktop.current-branch-menu %} diff --git a/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/authenticating-to-github.md b/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/authenticating-to-github.md index a774719671df..6a8a1a6c48a3 100644 --- a/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/authenticating-to-github.md +++ b/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/authenticating-to-github.md @@ -37,7 +37,9 @@ versions: {% data reusables.desktop.mac-select-desktop-menu %} {% data reusables.desktop.mac-select-accounts %} {% data reusables.desktop.choose-product-authenticate %} -4. 要添加 {% data variables.product.prodname_enterprise %} 帐户，请在“Enterprise server address（企业服务器地址）”下键入您的凭据，然后单击 **Continue（继续）**。 ![GitHub Enterprise 的登录按钮](/assets/images/help/desktop/mac-sign-in-button-enterprise.png) +4. 要添加 +{% data variables.product.prodname_enterprise %} 帐户，请在“Enterprise server address（企业服务器地址）”下键入您的凭据，然后单击 **Continue（继续）**。 + ![GitHub Enterprise 的登录按钮](/assets/images/help/desktop/mac-sign-in-button-enterprise.png) {% data reusables.desktop.retrieve-2fa %} {% endmac %} @@ -65,7 +67,9 @@ versions: {% data reusables.desktop.windows-choose-options %} {% data reusables.desktop.windows-select-accounts %} {% data reusables.desktop.choose-product-authenticate %} -4. 要添加 {% data variables.product.prodname_enterprise %} 帐户，请在“Enterprise server address（企业服务器地址）”下键入您的凭据，然后单击 **Continue（继续）**。 ![GitHub Enterprise 的登录按钮](/assets/images/help/desktop/windows-sign-in-button-enterprise.png) +4. 要添加 +{% data variables.product.prodname_enterprise %} 帐户，请在“Enterprise server address（企业服务器地址）”下键入您的凭据，然后单击 **Continue（继续）**。 + ![GitHub Enterprise 的登录按钮](/assets/images/help/desktop/windows-sign-in-button-enterprise.png) {% data reusables.desktop.retrieve-2fa %} {% endwindows %} diff --git a/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop.md b/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop.md index 5bb568e8ffa8..bb49237325d5 100644 --- a/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop.md +++ b/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop.md @@ -1,6 +1,6 @@ --- title: 配置和自定义 GitHub Desktop -intro: 设置 Git，连接默认编辑器并自定义设置，使 GitHub Desktop 与您的工作流程保持一致。 +intro: '设置 Git，连接默认编辑器并自定义设置，使 GitHub Desktop 与您的工作流程保持一致。' mapTopic: true redirect_from: - /desktop/getting-started-with-github-desktop/configuring-and-customizing-github-desktop diff --git a/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/configuring-basic-settings.md b/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/configuring-basic-settings.md index b5ad0cd1d5bb..c4f07226af0a 100644 --- a/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/configuring-basic-settings.md +++ b/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/configuring-basic-settings.md @@ -1,6 +1,6 @@ --- title: 配置基本设置 -intro: 您可以访问隐私保护设置，将帐户连接到 GitHub Desktop，以及配置 Git。 +intro: '您可以访问隐私保护设置，将帐户连接到 GitHub Desktop，以及配置 Git。' redirect_from: - /desktop/getting-started-with-github-desktop/configuring-basic-settings versions: diff --git a/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/configuring-git-for-github-desktop.md b/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/configuring-git-for-github-desktop.md index 4b4c31db8e61..4f1138dfdbd6 100644 --- a/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/configuring-git-for-github-desktop.md +++ b/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/configuring-git-for-github-desktop.md @@ -1,7 +1,7 @@ --- title: 配置 Git 用于 GitHub Desktop shortTitle: 配置 Git -intro: 如果尚未安装 Git，在使用 GitHub Desktop 前必须先配置。 +intro: '如果尚未安装 Git，在使用 GitHub Desktop 前必须先配置。' redirect_from: - /desktop/getting-started-with-github-desktop/configuring-git-for-github-desktop versions: diff --git a/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/creating-your-first-repository-using-github-desktop.md b/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/creating-your-first-repository-using-github-desktop.md index e3ab6af2c395..e89aa89438b1 100644 --- a/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/creating-your-first-repository-using-github-desktop.md +++ b/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/creating-your-first-repository-using-github-desktop.md @@ -49,53 +49,53 @@ versions: 在 {% data variables.product.prodname_desktop %} 应用程序的顶部，您将看到一个显示仓库当前状态的栏。 - **Current repository（当前仓库）**显示您处理的仓库的名称。 您可以单击 **Current repository（当前仓库）**切换到 {% data variables.product.prodname_desktop %} 中的不同仓库。 - **Current branch（当前分支）**显示您处理的分支的名称。 您可以单击 **Current branch（当前分支）**来查看仓库中的所有分支、切换到不同的分支或者创建新分支。 在仓库中创建拉取请求后，也可单击 **Current branch（当前分支）**查看它们。 - - **Publish repository（发布仓库）**会出现，因为您尚未将仓库发布到 {% data variables.product.product_name %}，下一个步骤才发布。 This section of the bar will change based on the status of your current branch and repository. Different context dependent actions will be available that let you exchange data between your local and remote repositories. + - **Publish repository（发布仓库）**会出现，因为您尚未将仓库发布到 {% data variables.product.product_name %}，下一个步骤才发布。 工具栏的这部分将根据您当前分支和仓库的状态而改变。 不同的上下文相关操作将可以使用，允许您在本地仓库与远程仓库之间交换数据。 ![探索 GitHub Desktop](/assets/images/help/desktop/getting-started-guide/explore-github-desktop.png) -#### Changes and History -在左侧边栏中，您会看到 **Changes（更改）**和 **History（历史记录）**视图。 ![The Changes and History tabs](/assets/images/help/desktop/changes-and-history.png) +#### 更改历史记录 +在左侧边栏中，您会看到 **Changes（更改）**和 **History（历史记录）**视图。 ![Changes（更改）和 History（历史记录）选项卡](/assets/images/help/desktop/changes-and-history.png) - - **Changes（更改）**视图显示您对当前分支中的文件已经做出但尚未提交到本地仓库的更改。 At the bottom, there is a box with "Summary" and "Description" text boxes and a **Commit to BRANCH** button. 这是提交新更改的位置。 The **Commit to BRANCH** button is dynamic and will display which branch you're committing your changes to. ![提交区域](/assets/images/help/desktop/getting-started-guide/commit-area.png) + - **Changes（更改）**视图显示您对当前分支中的文件已经做出但尚未提交到本地仓库的更改。 在底部有“Summary（摘要）”和“Description（说明）”文本框，以及 **Commit to BRANCH（提交到 [分支]）**按钮。 这是提交新更改的位置。 **Commit to BRANCH（提交到 [分支]）**按钮是动态的，将显示您提交更改到哪个分支。 ![提交区域](/assets/images/help/desktop/getting-started-guide/commit-area.png) - **History（历史记录）**视图显示仓库当前分支上以前的提交。 您应会看到在创建仓库时 {% data variables.product.prodname_desktop %} 所创建的“初始提交”。 在提交的右侧，根据您在创建仓库时选择的选项，可能会看到 _.gitattributes_、_.gitignore_、_LICENSE_ 或 _README_ 文件。 您可以单击每个文件以查看该文件的差异，也就是提交中对该文件的更改。 差异只显示文件已更改的部分，而不显示文件的全部内容。 ![历史记录视图](/assets/images/help/desktop/getting-started-guide/history-view.png) -### Part 4: Publishing your repository to {% data variables.product.product_name %} -When you create a new repository, it only exists on your computer and you are the only one who can access the repository. You can publish your repository to {% data variables.product.product_name %} to keep it synchronized across multiple computers and allow other people to access it. To publish your repository, push your local changes to {% data variables.product.product_name %}. +### 第 4 部分：将仓库推送到 {% data variables.product.product_name %} +创建新仓库时，它仅存在于您的计算机上，您是唯一可以访问该仓库的人。 您可以将仓库发布到 {% data variables.product.product_name %} 以在多台计算机上保持同步，并允许其他人访问它。 要发布仓库，请将本地更改推送到 {% data variables.product.product_name %}。 -1. Click **Publish repository** in the menu bar. ![发布仓库](/assets/images/help/desktop/getting-started-guide/publish-repository.png) - - {% data variables.product.prodname_desktop %} automatically fills the "Name" and "Description" fields with the information you entered when you created the repository. - - **Keep this code private** lets you control who can view your project. If you leave this option unselected, other users on {% data variables.product.product_name %} will be able to view your code. If you select this option, your code will not be publicly available. - - The **Organization** drop-down menu, if present, lets you publish your repository to a specific organization that you belong to on {% data variables.product.product_name %}. +1. 单击菜单栏中的 **Publish repository（发布仓库）**。 ![发布仓库](/assets/images/help/desktop/getting-started-guide/publish-repository.png) + - {% data variables.product.prodname_desktop %} 自动使用创建仓库时输入的信息填充“Name（名称）”和“Description（说明）”字段。 + - **Keep this code private（保持此代码为私有）**可让您控制谁可以查看您的项目。 如果您不选中此选项，{% data variables.product.product_name %} 上的其他用户将能够查看您的代码。 如果选中此选项，您的代码将不会公开。 + - **Organization（组织）**下拉菜单（如果有）可让您将仓库发布到 {% data variables.product.product_name %} 上您所属的特定组织。 ![发布仓库步骤](/assets/images/help/desktop/getting-started-guide/publish-repository-steps.png) 2. 单击 **Publish Repository（发布仓库）**按钮。 3. 您可以从 {% data variables.product.prodname_desktop %} 访问 {% data variables.product.prodname_dotcom_the_website %} 上的仓库。 在文件菜单中，单击 **Repository（仓库）**，然后单击 **View on GitHub（在 GitHub 上查看）**。 这会直接在默认浏览器中打开仓库。 -### Part 5: Making, committing, and pushing changes -Now that you've created and published your repository, you're ready to make changes to your project and start crafting your first commit to your repository. +### 第 5 部分：进行更改、提交更改和推送更改 +现在，您已经创建并发布仓库，已经准备好对项目进行更改，并开始创建第一个对仓库的提交。 -1. To launch your external editor from within {% data variables.product.prodname_desktop %}, click **Repository**, then click **Open in EDITOR**. For more information, see "[Configuring a default editor](/desktop/getting-started-with-github-desktop/configuring-a-default-editor)." ![在编辑器中打开](/assets/images/help/desktop/getting-started-guide/open-in-editor.png) +1. 要从 {% data variables.product.prodname_desktop %} 启动外部编辑器，请单击 **Repository（仓库）**，然后单击 **Open in EDITOR（在 [编辑器] 中打开）**。 更多信息请参阅“[配置默认编辑器](/desktop/getting-started-with-github-desktop/configuring-a-default-editor)。 ![在编辑器中打开](/assets/images/help/desktop/getting-started-guide/open-in-editor.png) -2. Make some changes to the _README.md_ file that you previously created. You can add information that describes your project, like what it does and why it is useful. When you are satisfied with your changes, save them in your text editor. -3. In {% data variables.product.prodname_desktop %}, navigate to the **Changes** view. 在文件列表中，您应该会看到 _README.md_。 The checkmark to the left of the _README.md_ file indicates that the changes you've made to the file will be part of the commit you make. 以后您可能会更改多个文件，但只想提交对其中部分文件所做的更改。 If you click the checkmark next to a file, that file will not be included in the commit. ![查看更改](/assets/images/help/desktop/getting-started-guide/viewing-changes.png) +2. 对以前创建的 _README.md_ 文件做一些更改。 您可以添加描述项目的信息，比如它做什么，以及为什么有用。 当您对更改满意时，请将它们保存在文本编辑器中。 +3. 在 {% data variables.product.prodname_desktop %} 中，导航到 **Changes（更改）**视图。 在文件列表中，您应该会看到 _README.md_。 _README.md_ 文件左边的勾选标记表示您对文件的更改将成为提交的一部分。 以后您可能会更改多个文件，但只想提交对其中部分文件所做的更改。 如果单击文件旁边的复选标记，则该文件不会包含在提交中。 ![查看更改](/assets/images/help/desktop/getting-started-guide/viewing-changes.png) -4. 在 **Changes（更改）**列表底部，输入提交消息。 在头像右侧，键入提交的简短描述。 由于我们在更改 _README.md_ 文件，因此“添加关于项目目的的信息”将是比较好的提交摘要。 Below the summary, you'll see a "Description" text field where you can type a longer description of the changes in the commit, which is helpful when looking back at the history of a project and understanding why changes were made. 由于您是对 _README.md_ 文件做基本的更新，因此可跳过描述。 ![Commit message](/assets/images/help/desktop/getting-started-guide/commit-message.png) <<<<<<< HEAD -5. Click **Commit to BRANCH NAME**. The commit button shows your current branch so you can be sure to commit to the branch you want. -![Commit to branch](/assets/images/help/desktop/getting-started-guide/click-commit-to-master.png) +4. 在 **Changes（更改）**列表底部，输入提交消息。 在头像右侧，键入提交的简短描述。 由于我们在更改 _README.md_ 文件，因此“添加关于项目目的的信息”将是比较好的提交摘要。 在摘要下方，您会看到“Description（说明）”文本字段，在其中可以键入较长的提交更改描述，这有助于回顾项目的历史记录和了解更改的原因。 由于您是对 _README.md_ 文件做基本的更新，因此可跳过描述。 ![Commit message](/assets/images/help/desktop/getting-started-guide/commit-message.png) <<<<<<< HEAD +5. 单击 **Commit to BRANCH NAME（提交到 [分支名称]）**。 提交按钮显示当前分支，因此您可以确保提交到所需的分支。 +![提交到分支](/assets/images/help/desktop/getting-started-guide/click-commit-to-master.png) ======= -5. 单击 **Commit to master（提交至 master）**。 The commit button shows your current branch, which in this case is `master`, so that you know which branch you are making a commit to. ![提交到 master](/assets/images/help/desktop/getting-started-guide/click-commit-to-master.png) +5. 单击 **Commit to master（提交至 master）**。 提交按钮显示您当前的分支，在本例中是 `master`，这样您就知道要提交到哪个分支。 ![提交到 master](/assets/images/help/desktop/getting-started-guide/click-commit-to-master.png) > > > > > > > master 6. 要将更改推送到 {% data variables.product.product_name %} 上的远程仓库，请单击 **Push origin（推送源）**。 ![推送源](/assets/images/help/desktop/getting-started-guide/push-to-origin.png) - - The **Push origin** button is the same one that you clicked to publish your repository to {% data variables.product.product_name %}. This button changes contextually based on where you are at in the Git workflow. It should now say `Push origin` with a `1` next to it, indicating that there is one commit that has not been pushed up to {% data variables.product.product_name %}. - - The "origin" in **Push origin** means that you are pushing changes to the remote called `origin`, which in this case is your project's repository on {% data variables.product.prodname_dotcom_the_website %}. 在推送任何新提交到 {% data variables.product.product_name %} 之前，您的计算机上的项目仓库与 {% data variables.product.prodname_dotcom_the_website %} 上的项目仓库之间存在差异。 This allows you to work locally and only push your changes to {% data variables.product.prodname_dotcom_the_website %} when you're ready. -7. In the window to the right of the **Changes** view, you'll see suggestions for actions you can do next. To open the repository on {% data variables.product.product_name %} in your browser, click **View on {% data variables.product.product_name %}**. ![Available actions](/assets/images/help/desktop/available-actions.png) -8. 在浏览器中，单击 **2 commits（2 次提交）**。 您会看到 {% data variables.product.product_name %} 上此仓库中的提交列表。 The first commit should be the commit you just made in {% data variables.product.prodname_desktop %}. ![单击两个提交](/assets/images/help/desktop/getting-started-guide/click-two-commits.png) + - **Push origin（推送源）**按钮就是您单击以发布仓库到 {% data variables.product.product_name %} 的按钮。 此按钮根据 Git 工作流程中的上下文而变。 现在改为 `Push origin（推送源）`了，其旁边的 `1` 表示有一个提交尚未推送到 {% data variables.product.product_name %}。 + - **Push origin（推送源）**中的“源”表示我们将更改推送到名为 `origin` 的远程，在本例中是 {% data variables.product.prodname_dotcom_the_website %} 上的项目仓库。 在推送任何新提交到 {% data variables.product.product_name %} 之前，您的计算机上的项目仓库与 {% data variables.product.prodname_dotcom_the_website %} 上的项目仓库之间存在差异。 这可让您在本地工作，并且仅在准备好后才将更改推送到 {% data variables.product.prodname_dotcom_the_website %}。 +7. 在 **Changes（更改）**视图右边的窗口中，您会看到接下来可以执行的操作提示。 要在浏览器中打开 {% data variables.product.product_name %} 上的仓库，请单击 **View on {% data variables.product.product_name %}（在 GitHub 中查看）**。 ![可用操作](/assets/images/help/desktop/available-actions.png) +8. 在浏览器中，单击 **2 commits（2 次提交）**。 您会看到 {% data variables.product.product_name %} 上此仓库中的提交列表。 第一个提交应是您刚才在 {% data variables.product.prodname_desktop %} 中的提交。 ![单击两个提交](/assets/images/help/desktop/getting-started-guide/click-two-commits.png) ### 结论 -You've now created a repository, published the repository to {% data variables.product.product_name %}, made a commit, and pushed your changes to {% data variables.product.product_name %}. You can follow this same workflow when contributing to other projects that you create or collaborate on. +您现已创建一个仓库，并且已将仓库发布到 {% data variables.product.product_name %}，进行了提交，并且已将更改推送到 {% data variables.product.product_name %}。 在参与创建或协作的其他项目时，可以遵循这个相同的工作流程。 ### 延伸阅读 -- "[Learning about Git](/github/using-git/learning-about-git)" -- "[Learning about {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/learning-about-github)" -- "[Getting started with {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github)" +- [[了解 Git](/github/using-git/learning-about-git)] +- "[了解 {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/learning-about-github)" +- "[开始使用 {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github)" diff --git a/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/getting-started-with-github-desktop.md b/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/getting-started-with-github-desktop.md index 160259556ff0..1430c218eb46 100644 --- a/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/getting-started-with-github-desktop.md +++ b/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/getting-started-with-github-desktop.md @@ -1,107 +1,107 @@ --- title: GitHub Desktop 使用入门 -intro: 'Learn how to set up, authenticate, and configure {% data variables.product.prodname_desktop %} to allow you to contribute to projects directly from your machine.' +intro: '了解如何设置、验证和配置 {% data variables.product.prodname_desktop %}，以便直接从您的计算机直接参与项目。' miniTocMaxHeadingLevel: 4 versions: free-pro-team: '*' --- ### 简介 -{% data variables.product.prodname_desktop %} is an application that enables you to interact with {% data variables.product.prodname_dotcom %} using a GUI instead of the command line or a web browser. {% data variables.product.prodname_desktop %} 鼓励您和您的团队使用最佳实践协作处理 Git 和 {% data variables.product.prodname_dotcom %}。 You can use {% data variables.product.prodname_desktop %} to complete most Git commands from your desktop with visual confirmation of changes. You can push to, pull from, and clone remote repositories with {% data variables.product.prodname_desktop %}, and use collaborative tools such as attributing commits and creating pull requests. +{% data variables.product.prodname_desktop %} 是一个可让您使用 GUI 而非命令行或网络浏览器与 {% data variables.product.prodname_dotcom %} 交互的应用程序。 {% data variables.product.prodname_desktop %} 鼓励您和您的团队使用最佳实践协作处理 Git 和 {% data variables.product.prodname_dotcom %}。 您可以使用 {% data variables.product.prodname_desktop %}，通过视觉确认更改从桌面完成大部分 Git 命令。 您可以使用 {% data variables.product.prodname_desktop %} 推送到、从中拉取和克隆远程仓库，以及使用协作工具，如归因提交和创建拉取请求。 -This guide will help you get started with {% data variables.product.prodname_desktop %} by setting up the application, authenticating your account, configuring basic settings, and introducing the fundamentals of managing projects with {% data variables.product.prodname_desktop %}. You will be able to use {% data variables.product.prodname_desktop %} to collaborate on projects and connect to remote repositories after working through this guide. +本指南将介绍设置应用程序、验证帐户、配置基本设置，以及介绍使用 {% data variables.product.prodname_desktop %} 管理项目的基础知识，帮助您开始使用 {% data variables.product.prodname_desktop %}。 在读完本指南后，您将能够使用 {% data variables.product.prodname_desktop %} 协作处理项目并连接到远程仓库。 -You might find it helpful to have a basic understanding of Git and {% data variables.product.prodname_dotcom %} before getting started with {% data variables.product.prodname_desktop %}. For more information, see the following articles. +您可能会发现，在开始使用 {% data variables.product.prodname_dotcom %} 之前，基本了解 Git 和 {% data variables.product.prodname_desktop %} 会有帮助。 更多信息请参阅以下文章。 -- "[Learning about Git](/github/using-git/learning-about-git)" -- "[Learning about {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/learning-about-github)" -- "[Getting started with {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github)" +- [[了解 Git](/github/using-git/learning-about-git)] +- "[了解 {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/learning-about-github)" +- "[开始使用 {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github)" -{% data variables.product.prodname_desktop %} is an open source project. You can see the roadmap, contribute to the project, or open an issue to provide feedback or feature requests. For more information, see the [`desktop/desktop`](https://github.com/desktop/desktop) repository. +{% data variables.product.prodname_desktop %} 是一个开源项目。 您可以查看路线图、为项目做出贡献，或者打开议题以提供反馈或功能请求。 更多信息请参阅 [`desktop/desktop`](https://github.com/desktop/desktop) 仓库。 -### Part 1: Installing and authenticating -您可以在任何支持的操作系统上安装 {% data variables.product.prodname_desktop %}。 For more information, see "[Supported operating systems](/desktop/getting-started-with-github-desktop/supported-operating-systems)." +### 第 1 部分：安装和身份验证 +您可以在任何支持的操作系统上安装 {% data variables.product.prodname_desktop %}。 更多信息请参阅“[支持的操作系统](/desktop/getting-started-with-github-desktop/supported-operating-systems)”。 -To install {% data variables.product.prodname_desktop %}, visit the download page for [{% data variables.product.prodname_desktop %}](https://desktop.github.com/). 更多信息请参阅“[安装 {% data variables.product.prodname_desktop %}](/desktop/installing-and-configuring-github-desktop/installing-github-desktop)。” +要安装 {% data variables.product.prodname_desktop %}，请访问 [{% data variables.product.prodname_desktop %}](https://desktop.github.com/) 的下载页面。 更多信息请参阅“[安装 {% data variables.product.prodname_desktop %}](/desktop/installing-and-configuring-github-desktop/installing-github-desktop)。” -After you have installed {% data variables.product.prodname_desktop %}, you can authenticate the application with your account on {% data variables.product.prodname_dotcom %} or {% data variables.product.prodname_enterprise %}. Authenticating allows you to connect to remote repositories on {% data variables.product.prodname_dotcom %} or {% data variables.product.prodname_enterprise %}. +在安装 {% data variables.product.prodname_desktop %} 后，您可以使用您在 {% data variables.product.prodname_dotcom %} 或 {% data variables.product.prodname_enterprise %} 上的帐户验证应用程序。 身份验证允许您连接到 {% data variables.product.prodname_dotcom %} 或 {% data variables.product.prodname_enterprise %} 上的远程仓库。 {% mac %} -1. Before you can authenticate to {% data variables.product.prodname_dotcom %} or {% data variables.product.prodname_enterprise %}, you will need an account. 有关创建帐户的更多信息，请参阅“[注册新 {% data variables.product.prodname_dotcom %} 帐户](/github/getting-started-with-github/signing-up-for-a-new-github-account)”或联系您的 {% data variables.product.prodname_enterprise %} 帐户管理员。 +1. 必须有帐户才可向 {% data variables.product.prodname_dotcom %} 或 {% data variables.product.prodname_enterprise %} 验证。 有关创建帐户的更多信息，请参阅“[注册新 {% data variables.product.prodname_dotcom %} 帐户](/github/getting-started-with-github/signing-up-for-a-new-github-account)”或联系您的 {% data variables.product.prodname_enterprise %} 帐户管理员。 -2. In the {% data variables.product.prodname_desktop %} drop-down menu, click **Preferences**. In the preferences window, click **Accounts** and follow the steps to sign in. For more information on authenticating, see "[Authenticating to {% data variables.product.prodname_dotcom %}](/desktop/getting-started-with-github-desktop/authenticating-to-github)." ![GitHub 的登录按钮](/assets/images/help/desktop/mac-sign-in-github.png) +2. 在 {% data variables.product.prodname_desktop %} 下拉菜单中，单击 **Preferences（首选项）**。 在首选项窗口中，单击 **Accounts（帐户）**并按照登录步骤操作。 有关身份验证的更多信息，请参阅“[向 {% data variables.product.prodname_dotcom %} 验证](/desktop/getting-started-with-github-desktop/authenticating-to-github)”。 ![GitHub 的登录按钮](/assets/images/help/desktop/mac-sign-in-github.png) {% endmac %} {% windows %} -1. Before you can authenticate to {% data variables.product.prodname_dotcom %} or {% data variables.product.prodname_enterprise %}, you will need an account. 有关创建帐户的更多信息，请参阅“[注册新 {% data variables.product.prodname_dotcom %} 帐户](/github/getting-started-with-github/signing-up-for-a-new-github-account)”或联系您的 {% data variables.product.prodname_enterprise %} 帐户管理员。 +1. 必须有帐户才可向 {% data variables.product.prodname_dotcom %} 或 {% data variables.product.prodname_enterprise %} 验证。 有关创建帐户的更多信息，请参阅“[注册新 {% data variables.product.prodname_dotcom %} 帐户](/github/getting-started-with-github/signing-up-for-a-new-github-account)”或联系您的 {% data variables.product.prodname_enterprise %} 帐户管理员。 -2. In the File drop-down menu, click **Options**. In the options window, click **Accounts** and follow the steps to sign in. For more information on authenticating, see "[Authenticating to {% data variables.product.prodname_dotcom %}](/desktop/getting-started-with-github-desktop/authenticating-to-github)." ![GitHub 的登录按钮](/assets/images/help/desktop/windows-sign-in-github.png) +2. 在 File（文件）下拉菜单中，单击 **Options（选项）**。 在选项窗口中，单击 **Accounts（帐户）**并按照登录步骤操作。 有关身份验证的更多信息，请参阅“[向 {% data variables.product.prodname_dotcom %} 验证](/desktop/getting-started-with-github-desktop/authenticating-to-github)”。 ![GitHub 的登录按钮](/assets/images/help/desktop/windows-sign-in-github.png) {% endwindows %} -### Part 2: Configuring and customizing {% data variables.product.prodname_desktop %} -After you install {% data variables.product.prodname_desktop %}, you can configure and customize the app to best suit your needs. +### 第 2 部分：配置和自定义 {% data variables.product.prodname_desktop %} +安装 {% data variables.product.prodname_desktop %} 后，您可以配置并自定义应用程序，使之最适合您的需求。 {% mac %} -You can connect or remove accounts on {% data variables.product.prodname_dotcom %} or {% data variables.product.prodname_enterprise %}, choose a default text editor or shell, edit your Git configuration, change the appearance of {% data variables.product.prodname_desktop %}, customize system dialogs, and set privacy preferences in the {% data variables.product.prodname_desktop %} Preferences window. 更多信息请参阅“[配置基本设置](/desktop/getting-started-with-github-desktop/configuring-basic-settings)”。 +您可以连接或删除 {% data variables.product.prodname_dotcom %} 或 {% data variables.product.prodname_enterprise %} 上的帐户、选择默认文本编辑器或 shell、编辑 Git 配置、更改 {% data variables.product.prodname_desktop %} 的外观、自定义系统对话框，以及在 {% data variables.product.prodname_desktop %} Preferences（首选项）窗口中设置隐私首选项。 更多信息请参阅“[配置基本设置](/desktop/getting-started-with-github-desktop/configuring-basic-settings)”。 - ![The basic settings in the Preference window](/assets/images/help/desktop/mac-appearance-tab-themes.png) + ![Preferences（首选项）窗口中的基本设置](/assets/images/help/desktop/mac-appearance-tab-themes.png) {% endmac %} {% windows %} -You can connect or remove accounts on {% data variables.product.prodname_dotcom %} or {% data variables.product.prodname_enterprise %}, choose a default text editor or shell, edit your Git configuration, change the appearance of {% data variables.product.prodname_desktop %}, customize system dialogs, and set privacy preferences in the {% data variables.product.prodname_desktop %} Options window. 更多信息请参阅“[配置基本设置](/desktop/getting-started-with-github-desktop/configuring-basic-settings)”。 +您可以连接或删除 {% data variables.product.prodname_dotcom %} 或 {% data variables.product.prodname_enterprise %} 上的帐户、选择默认文本编辑器或 shell、编辑 Git 配置、更改 {% data variables.product.prodname_desktop %} 的外观、自定义系统对话框，以及在 {% data variables.product.prodname_desktop %} Options（选项）窗口中设置隐私首选项。 更多信息请参阅“[配置基本设置](/desktop/getting-started-with-github-desktop/configuring-basic-settings)”。 - ![The basic settings in the Options window](/assets/images/help/desktop/windows-appearance-tab-themes.png) + ![Options（选项）窗口中的基本设置](/assets/images/help/desktop/windows-appearance-tab-themes.png) {% endwindows %} -### Part 3: Contributing to projects with {% data variables.product.prodname_desktop %} -After installing, authenticating, and configuring the app, you are ready to start using {% data variables.product.prodname_desktop %}. You can create, add, or clone repositories and use {% data variables.product.prodname_desktop %} to manage contributions to your repositories. +### 第 3 部分：通过 {% data variables.product.prodname_desktop %} 参与项目 +在安装、验证和配置应用程序后，便可开始使用 {% data variables.product.prodname_desktop %}。 您可以创建、添加或克隆仓库，并使用 {% data variables.product.prodname_desktop %} 来管理对您的仓库的参与。 -#### Creating, adding, and cloning repositories -You can create a new repository by selecting the File menu and clicking **New repository...**. For more information, see "[Creating your first repository using {% data variables.product.prodname_desktop %}](/desktop/getting-started-with-github-desktop/creating-your-first-repository-using-github-desktop)." +#### 创建、添加和克隆仓库 +您可以选择 File（文件）菜单并点击 **New repository...（新仓库...）**来创建一个新的仓库。 更多信息请参阅“[使用 {% data variables.product.prodname_desktop %}](/desktop/getting-started-with-github-desktop/creating-your-first-repository-using-github-desktop) 创建第一个仓库”。 -You can add a repository from your local computer by selecting the File menu and clicking **Add Local Repository...**. For more information, see "[Adding a repository from your local computer to {% data variables.product.prodname_desktop %}](/desktop/contributing-and-collaborating-using-github-desktop/adding-a-repository-from-your-local-computer-to-github-desktop)." +您可以选择 File（文件）菜单并单击 **Add Local Repository...（添加本地仓库...）**从本地计算机添加仓库。 更多信息请参阅“[从本地计算机添加仓库到 {% data variables.product.prodname_desktop %}](/desktop/contributing-and-collaborating-using-github-desktop/adding-a-repository-from-your-local-computer-to-github-desktop)”。 -You can clone a repository from {% data variables.product.prodname_dotcom %} by selecting the File menu and clicking **Clone Repository...**. For more information, see "[Cloning and Forking Repositories from {% data variables.product.prodname_desktop %}](/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop)." +您可以选择 File（文件）菜单并单击 **Clone Repository...（克隆仓库...）**从 {% data variables.product.prodname_dotcom %} 克隆仓库。 更多信息请参阅“[从 {% data variables.product.prodname_desktop %} 克隆和复刻仓库](/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop)”。 {% mac %} - ![The File menu options for creating, adding, and cloning repositories](/assets/images/help/desktop/mac-file-menu.png) + ![用于创建、添加和克隆仓库的 File（文件）菜单选项](/assets/images/help/desktop/mac-file-menu.png) {% endmac %} {% windows %} - ![The File menu options for creating, adding, and cloning repositories](/assets/images/help/desktop/windows-file-menu.png) + ![用于创建、添加和克隆仓库的 File（文件）菜单选项](/assets/images/help/desktop/windows-file-menu.png) {% endwindows %} #### 在分支中更改 -You can use {% data variables.product.prodname_desktop %} to create a branch of a project. Branches isolate your development work from other branches in the repository, so that you can safely experiment with changes. 更多信息请参阅“[管理分支](/desktop/contributing-and-collaborating-using-github-desktop/managing-branches)。” +您可以使用 {% data variables.product.prodname_desktop %} 创建项目分支。 分支将开发工作与仓库中的其他分支相分隔，以便您安全地尝试更改。 更多信息请参阅“[管理分支](/desktop/contributing-and-collaborating-using-github-desktop/managing-branches)。” - ![The New Branch button](/assets/images/help/desktop/new-branch-button-mac.png) + ![New Branch（新分支）按钮](/assets/images/help/desktop/new-branch-button-mac.png) -After you make changes to a branch, you can review them in {% data variables.product.prodname_desktop %} and make a commit to keep track of your changes. 更多信息请参阅“[提交和审查对项目的更改](/desktop/contributing-and-collaborating-using-github-desktop/committing-and-reviewing-changes-to-your-project)”。 +对分支进行更改后，您可以在 {% data variables.product.prodname_desktop %} 中审查它们，并创建提交以跟踪您的更改。 更多信息请参阅“[提交和审查对项目的更改](/desktop/contributing-and-collaborating-using-github-desktop/committing-and-reviewing-changes-to-your-project)”。 - ![Viewing and making commits](/assets/images/help/desktop/commit-button.png) + ![查看和创建提交](/assets/images/help/desktop/commit-button.png) -If you want to access your changes remotely or share them with other people, you can push your commits to {% data variables.product.prodname_dotcom %}. 更多信息请参阅“[推送更改到 {% data variables.product.prodname_dotcom %}](/desktop/contributing-and-collaborating-using-github-desktop/pushing-changes-to-github)”。 +如果要远程访问更改或与他人共享更改，您可以将提交推送到 {% data variables.product.prodname_dotcom %}。 更多信息请参阅“[推送更改到 {% data variables.product.prodname_dotcom %}](/desktop/contributing-and-collaborating-using-github-desktop/pushing-changes-to-github)”。 -#### Collaborating with {% data variables.product.prodname_desktop %} -You can use {% data variables.product.prodname_desktop %} to create issues or pull requests to collaborate on projects with other people. Issues help you keep track of ideas and discuss possible changes to projects. Pull requests let you share your proposed changes with others, receive feedback, and merge changes into a project. For more information, see "[Creating an issue or pull request](/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request)."'' +#### 使用 {% data variables.product.prodname_desktop %} 进行协作 +您可以使用 {% data variables.product.prodname_desktop %} 创建议题或拉取请求来与其他人协作处理项目。 议题有助于您跟踪想法和讨论项目可能发生的变化。 拉取请求可让您与他人共享提议的更改、接收反馈并将更改合并到项目中。 更多信息请参阅“[创建议题或拉取请求](/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request)”。 -You can view your own or your collaborator's pull requests in {% data variables.product.prodname_desktop %}. Viewing a pull request in {% data variables.product.prodname_desktop %} lets you see any proposed changes and make additional changes by opening the project's files and repositories in your default text editor. For more information, see "[Viewing a pull request in {% data variables.product.prodname_desktop %}](/desktop/contributing-and-collaborating-using-github-desktop/viewing-a-pull-request-in-github-desktop)." +您可以在 {% data variables.product.prodname_desktop %} 中查看您自己或您的协作者的拉取请求。 在 {% data variables.product.prodname_desktop %} 中查看拉取请求可让您查看任何提议的更改，以及在默认文本编辑器中打开项目文件和仓库进行其他更改。 更多信息请参阅“[在 {% data variables.product.prodname_desktop %} 中查看拉取请求](/desktop/contributing-and-collaborating-using-github-desktop/viewing-a-pull-request-in-github-desktop)”。 -#### Keeping your local repository in sync -When you make changes to your local repositories or when other people make changes to the remote repositories, you will need to sync your local copy of the project with the remote repository. {% data variables.product.prodname_desktop %} can keep your local copy of a project in sync with the remote version by pushing and pulling commits. 更多信息请参阅“[同步分支](/desktop/contributing-and-collaborating-using-github-desktop/syncing-your-branch)”。 +#### 保持本地仓库同步 +当您对更改本地仓库或者其他人更改远程仓库时，您需要将项目的本地副本与远程仓库同步。 {% data variables.product.prodname_desktop %} 可以通过推送和拉取提交来保持项目本地副本与远程版本同步。 更多信息请参阅“[同步分支](/desktop/contributing-and-collaborating-using-github-desktop/syncing-your-branch)”。 ### 延伸阅读 -- "[Installing and authenticating to {% data variables.product.prodname_desktop %}](/desktop/getting-started-with-github-desktop/installing-and-authenticating-to-github-desktop)" -- "[Contributing and collaborating using {% data variables.product.prodname_desktop %}](/desktop/contributing-and-collaborating-using-github-desktop)" +- "[安装 {% data variables.product.prodname_desktop %} 并进行身份验证](/desktop/getting-started-with-github-desktop/installing-and-authenticating-to-github-desktop)" +- "[使用 {% data variables.product.prodname_desktop %} 参与和协作](/desktop/contributing-and-collaborating-using-github-desktop)" diff --git a/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/index.md b/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/index.md index cdaa33dde3bb..f35c7ce8ce34 100644 --- a/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/index.md +++ b/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/index.md @@ -1,7 +1,7 @@ --- -title: Installing and configuring GitHub Desktop +title: 安装和配置 GitHub Desktop shortTitle: 安装和配置 -intro: 'Get {% data variables.product.prodname_desktop %} set up to manage your project work. Authenticate to {% data variables.product.prodname_dotcom_the_website %} or {% data variables.product.prodname_enterprise %}, keep the app up-to-date, and review your preferred settings.' +intro: '获取 {% data variables.product.prodname_desktop %} 设置以管理项目工作。 向 {% data variables.product.prodname_dotcom_the_website %} 或 {% data variables.product.prodname_enterprise %} 验证，保持应用程序的更新，并检查您的首选设置。' redirect_from: - /desktop/getting-started-with-github-desktop versions: diff --git a/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/keyboard-shortcuts.md b/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/keyboard-shortcuts.md index cbe922dd8d3a..79dc22a1285d 100644 --- a/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/keyboard-shortcuts.md +++ b/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/keyboard-shortcuts.md @@ -14,51 +14,51 @@ MacOS 上的 GitHub Desktop 快捷键 ### 站点快捷键 -| 键盘快捷键 | 描述 | -| ------------------------------------ | ---------------------------------------------------------- | -| ⌘, | 进入 Preferences（首选项） | +| 键盘快捷键 | 描述 | +| ------------------------------------ | ----------------------------------------------------- | +| ⌘, | 进入 Preferences（首选项） | | ⌘H | 隐藏 {% data variables.product.prodname_desktop %} 应用程序 | -| ⌥⌘H | 隐藏所有其他应用程序 | -| ⌘Q | 退出 {% data variables.product.prodname_desktop %} | -| ⌃⌘F | 切换全屏视图 | -| ⌘0 | 将缩放比例重置为默认的文本大小 | -| ⌘= | 放大文本和图形 | -| ⌘- | 缩小文本和图形 | -| ⌥⌘I | 切换开发者工具 | +| ⌥⌘H | 隐藏所有其他应用程序 | +| ⌘Q | 退出 {% data variables.product.prodname_desktop %} +| ⌃⌘F | 切换全屏视图 | +| ⌘0 | 将缩放比例重置为默认的文本大小 | +| ⌘= | 放大文本和图形 | +| ⌘- | 缩小文本和图形 | +| ⌥⌘I | 切换开发者工具 | ### 仓库 -| 键盘快捷键 | 描述 | -| ------------------------------------ | ---------------------------------------------------------- | -| ⌘N | 新增仓库 | -| ⌘O | 添加本地仓库 | +| 键盘快捷键 | 描述 | +| ------------------------------------ | ----------------------------------------------------- | +| ⌘N | 新增仓库 | +| ⌘O | 添加本地仓库 | | ⇧⌘O | 从 {% data variables.product.prodname_dotcom %} 克隆仓库 | -| ⌘T | 显示仓库列表 | -| ⌘P | 将最新提交推送到 {% data variables.product.prodname_dotcom %} | +| ⌘T | 显示仓库列表 | +| ⌘P | 将最新提交推送到 {% data variables.product.prodname_dotcom %} | ⇧⌘P | 从 {% data variables.product.prodname_dotcom %} 拉取最新更改 | -| ⌘⌫ | 删除现有仓库 | +| ⌘⌫ | 删除现有仓库 | | ⇧⌘G | 在 {% data variables.product.prodname_dotcom %} 上查看仓库 | -| ⌃` | 在首选的终端工具中打开仓库 | -| ⇧⌘F | 在 Finder 中显示仓库 | -| ⇧⌘A | 在首选的编辑器工具中打开仓库 | +| ⌃` | 在首选的终端工具中打开仓库 | +| ⇧⌘F | 在 Finder 中显示仓库 | +| ⇧⌘A | 在首选的编辑器工具中打开仓库 | | ⌘I | 在 {% data variables.product.prodname_dotcom %} 上创建议题 | ### 分支 -| 键盘快捷键 | 描述 | -| ------------------------------------ | ------------------------------------------------------------- | -| ⌘1 | 在提交前显示所有更改 | -| ⌘2 | 显示提交历史记录 | -| ⌘B | 显示所有分支 | -| ⌘G | 转到提交摘要字段 | -| space | 选择或取消选择所有突出显示的文件 | -| ⇧⌘N | 创建新分支 | -| ⇧⌘R | 重命名当前分支 | -| ⇧⌘D | 删除当前分支 | -| ⇧⌘U | 从默认分支更新 | -| ⇧⌘B | 与现有分支比较 | -| ⇧⌘M | 合并到当前分支 | -| ⌃H | 显示或隐藏储存的更改 | +| 键盘快捷键 | 描述 | +| ------------------------------------ | -------------------------------------------------------- | +| ⌘1 | 在提交前显示所有更改 | +| ⌘2 | 显示提交历史记录 | +| ⌘B | 显示所有分支 | +| ⌘G | 转到提交摘要字段 | +| space | 选择或取消选择所有突出显示的文件 | +| ⇧⌘N | 创建新分支 | +| ⇧⌘R | 重命名当前分支 | +| ⇧⌘D | 删除当前分支 | +| ⇧⌘U | 从默认分支更新 | +| ⇧⌘B | 与现有分支比较 | +| ⇧⌘M | 合并到当前分支 | +| ⌃H | 显示或隐藏储存的更改 | | ⇧⌘C | 比较 {% data variables.product.prodname_dotcom %} 上的分支 | | ⌘R | 在 {% data variables.product.prodname_dotcom %} 上显示当前拉取请求 | @@ -81,37 +81,37 @@ Windows 上的 GitHub Desktop 键盘快捷键 ### 仓库 -| 键盘快捷键 | 描述 | -| ------------------------------------------- | ---------------------------------------------------------- | -| CtrlN | 新增仓库 | -| CtrlO | 添加本地仓库 | +| 键盘快捷键 | 描述 | +| ------------------------------------------- | ----------------------------------------------------- | +| CtrlN | 新增仓库 | +| CtrlO | 添加本地仓库 | | CtrlShiftO | 从 {% data variables.product.prodname_dotcom %} 克隆仓库 | -| CtrlT | 显示仓库列表 | -| CtrlP | 将最新提交推送到 {% data variables.product.prodname_dotcom %} | +| CtrlT | 显示仓库列表 | +| CtrlP | 将最新提交推送到 {% data variables.product.prodname_dotcom %} | CtrlShiftP | 从 {% data variables.product.prodname_dotcom %} 拉取最新更改 | -| CtrlDelete | 删除现有仓库 | +| CtrlDelete | 删除现有仓库 | | CtrlShiftG | 在 {% data variables.product.prodname_dotcom %} 上查看仓库 | -| Ctrl` | 在首选的命令行工具中打开仓库 | -| CtrlShiftF | 在 Explorer 中显示仓库 | -| CtrlShiftA | 在首选的编辑器工具中打开仓库 | +| Ctrl` | 在首选的命令行工具中打开仓库 | +| CtrlShiftF | 在 Explorer 中显示仓库 | +| CtrlShiftA | 在首选的编辑器工具中打开仓库 | | CtrlI | 在 {% data variables.product.prodname_dotcom %} 上创建议题 | ### 分支 -| 键盘快捷键 | 描述 | -| ------------------------------------------- | ------------------------------------------------------------- | -| Ctrl1 | 在提交前显示所有更改 | -| Ctrl2 | 显示提交历史记录 | -| CtrlB | 显示所有分支 | -| CtrlG | 转到提交摘要字段 | -| space | 选择或取消选择所有突出显示的文件 | -| CtrlShiftN | 创建新分支 | -| CtrlShiftR | 重命名当前分支 | -| CtrlShiftD | 删除当前分支 | -| CtrlShiftU | 从默认分支更新 | -| CtrlShiftB | 与现有分支比较 | -| CtrlShiftM | 合并到当前分支 | -| CtrlH | 显示或隐藏储存的更改 | +| 键盘快捷键 | 描述 | +| ------------------------------------------- | -------------------------------------------------------- | +| Ctrl1 | 在提交前显示所有更改 | +| Ctrl2 | 显示提交历史记录 | +| CtrlB | 显示所有分支 | +| CtrlG | 转到提交摘要字段 | +| space | 选择或取消选择所有突出显示的文件 | +| CtrlShiftN | 创建新分支 | +| CtrlShiftR | 重命名当前分支 | +| CtrlShiftD | 删除当前分支 | +| CtrlShiftU | 从默认分支更新 | +| CtrlShiftB | 与现有分支比较 | +| CtrlShiftM | 合并到当前分支 | +| CtrlH | 显示或隐藏储存的更改 | | CtrlShiftC | 比较 {% data variables.product.prodname_dotcom %} 上的分支 | | CtrlR | 在 {% data variables.product.prodname_dotcom %} 上显示当前拉取请求 | diff --git a/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/setting-up-github-desktop.md b/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/setting-up-github-desktop.md index 2da14cafbcf8..f8bd01e919d3 100644 --- a/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/setting-up-github-desktop.md +++ b/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/setting-up-github-desktop.md @@ -1,43 +1,43 @@ --- title: 设置 GitHub Desktop -shortTitle: Setup -intro: 'You can set up {% data variables.product.prodname_desktop %} to suit your needs and contribute to projects.' +shortTitle: 设置 +intro: '您可以设置 {% data variables.product.prodname_desktop %} 以适应您的需求并参与项目。' redirect_from: - /desktop/getting-started-with-github-desktop/setting-up-github-desktop versions: free-pro-team: '*' --- -### Part 1: Installing {% data variables.product.prodname_desktop %} +### 第 1 部分：安装 {% data variables.product.prodname_desktop %} -您可以在任何支持的操作系统上安装 {% data variables.product.prodname_desktop %}。 For more information, see "[Supported Operating Systems](/desktop/getting-started-with-github-desktop/supported-operating-systems)." +您可以在任何支持的操作系统上安装 {% data variables.product.prodname_desktop %}。 更多信息请参阅“[支持的操作系统](/desktop/getting-started-with-github-desktop/supported-operating-systems)”。 -To install {% data variables.product.prodname_desktop %}, navigate to [https://desktop.github.com/](https://desktop.github.com/) and download the appropriate version of {% data variables.product.prodname_desktop %} for your operating system. Follow the prompts to complete the installation. 更多信息请参阅“[安装 {% data variables.product.prodname_desktop %}](/desktop/getting-started-with-github-desktop/installing-github-desktop)。” +要安装 {% data variables.product.prodname_desktop %}，请导航到 [https://desktop.github.com/](https://desktop.github.com/) 并为操作系统下载适当的 {% data variables.product.prodname_desktop %} 版本。 按照提示完成安装。 更多信息请参阅“[安装 {% data variables.product.prodname_desktop %}](/desktop/getting-started-with-github-desktop/installing-github-desktop)。” -### Part 2: Configuring your account +### 第 2 部分：配置您的帐户 -If you have an account on {% data variables.product.prodname_dotcom %} or {% data variables.product.prodname_enterprise %}, you can use {% data variables.product.prodname_desktop %} to exchange data between your local and remote repositories. +如果您在 {% data variables.product.prodname_dotcom %} 或 {% data variables.product.prodname_enterprise %} 上有帐户，可以使用 {% data variables.product.prodname_desktop %} 在本地与远程仓库之间交换数据。 -#### Creating an account -If you do not already have an account on {% data variables.product.prodname_dotcom %}, see "[Signing up for a new {% data variables.product.prodname_dotcom %} account](/articles/signing-up-for-a-new-github-account/)." +#### 创建帐户 +如果您在 {% data variables.product.prodname_dotcom %} 上还没有帐户，请参阅“[Signing up for a new {% data variables.product.prodname_dotcom %} 帐户](/articles/signing-up-for-a-new-github-account/)”。 -If you are part of an organization that uses {% data variables.product.prodname_enterprise %} and you do not have an account, contact your {% data variables.product.prodname_enterprise %} site administrator. +如果您属于使用 {% data variables.product.prodname_enterprise %} 的组织但没有帐户，请联系您的 {% data variables.product.prodname_enterprise %} 网站管理员。 #### 向 {% data variables.product.prodname_dotcom %} 验证 -To connect to {% data variables.product.prodname_desktop %} with {% data variables.product.prodname_dotcom %}, you'll need to authenticate your account. 更多信息请参阅“[向 {% data variables.product.prodname_desktop %} 验证](/desktop/getting-started-with-github-desktop/authenticating-to-github)”。 +要使用 {% data variables.product.prodname_dotcom %} 连接到 {% data variables.product.prodname_desktop %}，您必须验证您的帐户。 更多信息请参阅“[向 {% data variables.product.prodname_desktop %} 验证](/desktop/getting-started-with-github-desktop/authenticating-to-github)”。 -After authenticating your account, you are ready to manage and contribute to projects with {% data variables.product.prodname_desktop %}. +验证您的帐户后，您就可以使用 {% data variables.product.prodname_desktop %} 管理和参与项目。 -### Part 3: Configuring Git -You must have Git installed before using {% data variables.product.prodname_desktop %}. If you do not already have Git installed, you can download and install the latest version of Git from [https://git-scm.com/downloads](https://git-scm.com/downloads). +### 第 3 部分：配置 Git +必须先安装 Git 后才能使用 {% data variables.product.prodname_desktop %}。 如果尚未安装 Git，可以从 [https://git-scm.com/downloads](https://git-scm.com/downloads)下载和安装最新版本的 Git。 -After you have Git installed, you'll need to configure Git for {% data variables.product.prodname_desktop %}. For more information, see "[Configuring Git for {% data variables.product.prodname_desktop %}](/desktop/getting-started-with-github-desktop/configuring-git-for-github-desktop)." +安装 Git 后，需要为 {% data variables.product.prodname_desktop %} 配置 Git。 更多信息请参阅“[为 {% data variables.product.prodname_desktop %} 配置 Git](/desktop/getting-started-with-github-desktop/configuring-git-for-github-desktop)”。 -### Part 4: Customizing {% data variables.product.prodname_desktop %} -You can adjust defaults and settings to tailor {% data variables.product.prodname_desktop %} to your needs. +### 第 4 部分：自定义 {% data variables.product.prodname_desktop %} +您可以调整默认值和设置，使 {% data variables.product.prodname_desktop %} 适合您的需求。 -#### Choosing a default text editor -You can open a text editor from {% data variables.product.prodname_desktop %} to manipulate files and repositories. {% data variables.product.prodname_desktop %} supports a variety of text editors and integrated development environments (IDEs) for Windows and macOS. You can choose a default editor in the {% data variables.product.prodname_desktop %} settings. For more information, see "[Configuring a default editor](/desktop/getting-started-with-github-desktop/configuring-a-default-editor)." +#### 选择默认文本编辑器 +您可以从 {% data variables.product.prodname_desktop %} 打开文本编辑器来操作文件和仓库。 {% data variables.product.prodname_desktop %} 支持用于 Windows 和 macOS 的各种文本编辑器和集成开发环境 (IDE)。 您可以在 {% data variables.product.prodname_desktop %} 设置中选择默认编辑器。 更多信息请参阅“[配置默认编辑器](/desktop/getting-started-with-github-desktop/configuring-a-default-editor)。 -#### Choosing a theme -{% data variables.product.prodname_desktop %} has multiple themes available to customize the look and feel of the app. You can choose a theme in the {% data variables.product.prodname_desktop %} settings. For more information, see "[Setting a theme for {% data variables.product.prodname_desktop %}](/desktop/getting-started-with-github-desktop/setting-a-theme-for-github-desktop)." +#### 选择主题 +{% data variables.product.prodname_desktop %} 有多个主题可用于自定义应用程序的外观。 您可以在 {% data variables.product.prodname_desktop %} 设置中选择主题。 更多信息请参阅“[设置 {% data variables.product.prodname_desktop %} 的主题](/desktop/getting-started-with-github-desktop/setting-a-theme-for-github-desktop)”。 diff --git a/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/supported-operating-systems.md b/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/supported-operating-systems.md index bcc7bc1692c3..b50a80889f0f 100644 --- a/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/supported-operating-systems.md +++ b/translations/zh-CN/content/desktop/installing-and-configuring-github-desktop/supported-operating-systems.md @@ -1,6 +1,6 @@ --- -title: Supported operating systems -intro: 'You can use {% data variables.product.prodname_desktop %} on any supported operating system.' +title: 支持的操作系统 +intro: '您可以在任何支持的操作系统上使用 {% data variables.product.prodname_desktop %}。' miniTocMaxHeadingLevel: 4 redirect_from: - /desktop/getting-started-with-github-desktop/supported-operating-systems @@ -8,54 +8,54 @@ versions: free-pro-team: '*' --- -### About supported operating systems +### 关于支持的操作系统 -The following operating systems are supported for {% data variables.product.prodname_desktop %}. +{% data variables.product.prodname_desktop %} 支持以下操作系统。 - {% data variables.desktop.mac-osx-versions %} -- {% data variables.desktop.windows-versions %}. You must have a 64-bit operating system to run {% data variables.product.prodname_desktop %}. +- {% data variables.desktop.windows-versions %}. 必须有 64 位操作系统才可运行 {% data variables.product.prodname_desktop %}。 -### Troubleshooting problems on macOS -If you're encountering problems using {% data variables.product.prodname_desktop %} on macOS, here are resolutions to try. For more information, see [`known-issues`](https://github.com/desktop/desktop/blob/development/docs/known-issues.md). +### macOS 问题疑难排解 +如果您在 macOS 上使用 {% data variables.product.prodname_desktop %} 时遇到问题，请尝试以下解决方法。 更多信息请参阅 [`known-issues`](https://github.com/desktop/desktop/blob/development/docs/known-issues.md)。 -#### `The username or passphrase you entered is not correct` error after signing into your account +#### 登录帐户后发生 `The username or passphrase you entered is not correct` 错误 -This error can occur when {% data variables.product.prodname_desktop %} can't access your stored credentials on Keychain. +当 {% data variables.product.prodname_desktop %} 无法访问您存储在 Keychain 上的凭据时就可能发生这个错误。 -To troubleshoot this error, follow these steps. +要解决此错误，请按照以下步骤操作。 -1. Open the "Keychain Access" app. -2. Right-click on **login** and then click **Lock Keychain "login"**. ![The "Lock Keychain "login" option](/assets/images/help/desktop/mac-lock-keychain.png) -3. Right-click on **login** and then click **Unlock Keychain "login"**. Follow any onscreen prompts to finish unlocking the Keychain "login." ![The "Unlock Keychain "login" option](/assets/images/help/desktop/mac-unlock-keychain.png) -4. Re-authenticate your account on {% data variables.product.prodname_dotcom %} or {% data variables.product.prodname_enterprise %}. +1. 打开“Keychain Access”应用程序。 +2. 右键单击 **login（登录）**，然后单击 **Lock Keychain "login"（锁定密钥链 [登录]）**。 !["锁定密钥链 "登录" 选项](/assets/images/help/desktop/mac-lock-keychain.png) +3. 右键单击 **login（登录）**，然后单击 **Unlock Keychain "login"（解锁密钥链 [登录]）**。 按照屏幕上的提示完成解锁密钥链“登录”。 !["解锁密钥链 "登录" 选项](/assets/images/help/desktop/mac-unlock-keychain.png) +4. 重新验证您在 {% data variables.product.prodname_dotcom %} 或 {% data variables.product.prodname_enterprise %} 上的帐户。 -#### `Could not create temporary directory: Permission denied` error after checking for updates +#### 检查更新后发生 `Could not create temporary directory: Permission denied` 错误 -This error can be caused by missing permissions for the `~/Library/Caches/com.github.GitHubClient.ShipIt` directory. {% data variables.product.prodname_desktop %} uses this directory to create and unpack temporary files as part of updating the application. +此错误可能是缺少对目录 `~/Library/Caches/com.github.GitHubClient.ShipIt` 的权限引起的。 {% data variables.product.prodname_desktop %} 使用此目录创建和解压临时文件，作为更新应用程序的一部分。 -To troubleshoot this error, follow these steps. +要解决此错误，请按照以下步骤操作。 -1. Close {% data variables.product.prodname_desktop %}. -2. Open "Finder" and navigate to `~/Library/Caches/`. -3. Right-click `com.github.GitHubClient.ShipIt` and then click **Get Info**. -4. Click the arrow to the left of "Sharing & Permissions." -5. If the Privilege to the right of your user account does not say "Read & Write," click the text and then click **Read & Write**. ![The "Sharing & Permissions" options](/assets/images/help/desktop/mac-adjust-permissions.png) -6. Open {% data variables.product.prodname_desktop %} and check for updates. +1. 关闭 {% data variables.product.prodname_desktop %}。 +2. 打开 "Finder" 并导航到 `~/Library/Caches/`。 +3. 右键单击 `.github.githubClient.shipIt` ，然后单击 **Get Info（获取信息）**。 +4. 单击“Sharing & Permissions（共享和权限）”左边的箭头。 +5. 如果用户帐户右侧的权限没有显示“Read & Write（读取和写入）”，请单击文本，然后单击 **Read & Write（读取和写入）**。 !["共享和权限"选项](/assets/images/help/desktop/mac-adjust-permissions.png) +6. 打开 {% data variables.product.prodname_desktop %} 并检查更新。 -### Troubleshooting problems on Windows -If you're encountering problems using {% data variables.product.prodname_desktop %} on Windows, here are resolutions to try. For more information, see [`known-issues`](https://github.com/desktop/desktop/blob/development/docs/known-issues.md). +### Windows 问题疑难排解 +如果您在 Windows 上使用 {% data variables.product.prodname_desktop %} 时遇到问题，请尝试以下解决方法。 更多信息请参阅 [`known-issues`](https://github.com/desktop/desktop/blob/development/docs/known-issues.md)。 -#### `The revocation function was unable to check revocation for the certificate.` error +#### `The revocation function was unable to check revocation for the certificate.` 错误 -This error can occur if you are using {% data variables.product.prodname_desktop %} on a corporate network that blocks Windows from checking the revocation status of a certificate. +如果您在公司网络上使用 {% data variables.product.prodname_desktop %} 阻止Windows 检查证书的撤销状态，就可能发生这个错误。 -To troubleshoot, contact your system administrator. +要解决问题，请联系您的系统管理员。 -#### `git clone failed` error while cloning a repository configured with Folder Redirection +#### 克隆使用文件夹重定向配置的仓库时发生 `git clone failed` 错误 -{% data variables.product.prodname_desktop %} does not support repositories configured with Folder Redirection. +{% data variables.product.prodname_desktop %} 不支持使用文件夹重定向配置的仓库。 -#### `cygheap base mismatch detected` error +#### `cygheap base mismatch detected` 错误 -This error can occur when Mandatory ASLR is enabled. Enabling Mandatory ASLR affects the MSYS2 core library, which {% data variables.product.prodname_desktop %} relies upon to emulate process forking. +启用强制 ASLR 时可能会发生此错误。 启用强制 ASLR 会影响 MSYS2 核心库，{% data variables.product.prodname_desktop %} 使用该库来模拟进程复刻。 -To troubleshoot this error, either disable Mandatory ASLR or explicitly allow all executables under `\usr\bin` which depend on MSYS2. +要排除此错误，请禁用强制 ASLR 或明确允许 `[usr] bin` 依赖 MSYS2 的所有可执行文件。 diff --git a/translations/zh-CN/content/developers/apps/activating-beta-features-for-apps.md b/translations/zh-CN/content/developers/apps/activating-beta-features-for-apps.md index 389ecf6690b1..f349501d5f0c 100644 --- a/translations/zh-CN/content/developers/apps/activating-beta-features-for-apps.md +++ b/translations/zh-CN/content/developers/apps/activating-beta-features-for-apps.md @@ -15,7 +15,8 @@ versions: {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} -3. Select the {% data variables.product.prodname_github_app %} you want to enable a beta feature for. +3. Select the +{% data variables.product.prodname_github_app %} you want to enable a beta feature for. {% data reusables.apps.beta_feature_activation %} ### Activating beta features for {% data variables.product.prodname_oauth_app %}s diff --git a/translations/zh-CN/content/developers/apps/authenticating-with-github-apps.md b/translations/zh-CN/content/developers/apps/authenticating-with-github-apps.md index 39662f986f95..729710ff0dce 100644 --- a/translations/zh-CN/content/developers/apps/authenticating-with-github-apps.md +++ b/translations/zh-CN/content/developers/apps/authenticating-with-github-apps.md @@ -37,7 +37,7 @@ versions: {% endnote %} ### 验证私钥 -{% data variables.product.product_name %} 使用 {% if currentVersion ver_lt "enterprise-server@2.23" %}SHA-1{% else %}SHA-256{% endif %} 哈希函数为每对私钥和公钥生成指纹。 您可以生成私钥指纹，然后与 {% data variables.product.product_name %} 显示的指纹相比较，以验证私钥是否与 {% data variables.product.product_name %} 上存储的公钥匹配。 +{% data variables.product.product_name %} generates a fingerprint for each private and public key pair using the {% if currentVersion ver_lt "enterprise-server@2.23" %}SHA-1{% else %}SHA-256{% endif %} hash function. 您可以生成私钥指纹，然后与 {% data variables.product.product_name %} 显示的指纹相比较，以验证私钥是否与 {% data variables.product.product_name %} 上存储的公钥匹配。 要验证私钥： diff --git a/translations/zh-CN/content/developers/apps/authorizing-oauth-apps.md b/translations/zh-CN/content/developers/apps/authorizing-oauth-apps.md index 2ef598e06543..87f8be697567 100644 --- a/translations/zh-CN/content/developers/apps/authorizing-oauth-apps.md +++ b/translations/zh-CN/content/developers/apps/authorizing-oauth-apps.md @@ -1,5 +1,5 @@ --- -title: 授权 OAuth 应用程序 +title: Authorizing OAuth Apps intro: '{% data reusables.shortdesc.authorizing_oauth_apps %}' redirect_from: - /apps/building-integrations/setting-up-and-registering-oauth-apps/about-authorization-options-for-oauth-apps/ @@ -21,75 +21,76 @@ If you want to skip authorizing your app in the standard way, such as when testi To authorize your OAuth app, consider which authorization flow best fits your app. -- [web application flow](#web-application-flow): Used to authorize users for standard OAuth apps that run in the browser. （不支持[隐式授予类型](https://tools.ietf.org/html/rfc6749#section-4.2)。） +- [web application flow](#web-application-flow): Used to authorize users for standard OAuth apps that run in the browser. (The [implicit grant type](https://tools.ietf.org/html/rfc6749#section-4.2) is not supported.) - [device flow](#device-flow): Used for headless apps, such as CLI tools. {% else %} -For standard apps that run in the browser, use the [web application flow](#web-application-flow) to obtain an authorization code and exchange it for a token. （不支持[隐式授予类型](https://tools.ietf.org/html/rfc6749#section-4.2)。） +For standard apps that run in the browser, use the [web application flow](#web-application-flow) to obtain an authorization code and exchange it for a token. (The [implicit grant type](https://tools.ietf.org/html/rfc6749#section-4.2) is not supported.) {% endif %} -### Web 应用程序流程 +### Web application flow {% note %} -**注：**如果您要构建 GitHub 应用程序，依然可以使用 OAuth web 应用程序流程，但设置方面有一些重要差异。 See "[Identifying and authorizing users for GitHub Apps](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/)" for more information. +**Note:** If you are building a GitHub App, you can still use the OAuth web application flow, but the setup has some important differences. See "[Identifying and authorizing users for GitHub Apps](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/)" for more information. {% endnote %} The web application flow to authorize users for your app is: -1. 用户被重定向，以请求他们的 GitHub 身份 -2. 用户被 GitHub 重定向回您的站点 -3. 您的应用程序使用用户的访问令牌访问 API +1. Users are redirected to request their GitHub identity +2. Users are redirected back to your site by GitHub +3. Your app accesses the API with the user's access token -#### 1. 请求用户的 GitHub 身份 +#### 1. Request a user's GitHub identity GET {% data variables.product.oauth_host_code %}/login/oauth/authorize -当您的 GitHub 应用程序指定 `login` 参数后，它将提示拥有特定账户的用户可以用来登录和授权您的应用程序。 +When your GitHub App specifies a `login` parameter, it prompts users with a specific account they can use for signing in and authorizing your app. -##### 参数 +##### Parameters -| 名称 | 类型 | 描述 | -| -------------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `client_id` | `字符串` | **必填**。 您{% if currentVersion == "free-pro-team@latest" %}[注册 ](https://github.com/settings/applications/new){% else %}registered{% endif %} 时从 GitHub 收到的客户端 ID。 | -| `redirect_uri` | `字符串` | 用户获得授权后被发送到的应用程序中的 URL。 有关[重定向 url](#redirect-urls)，请参阅下方的详细信息。 | -| `login` | `字符串` | 提供用于登录和授权应用程序的特定账户。 | -| `作用域` | `字符串` | 用空格分隔的[作用域](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/)列表。 如果未提供，对于未向应用程序授权任何作用域的用户，`scope` 将默认为空白列表。 对于已向应用程序授权作用域的用户，不会显示含作用域列表的 OAuth 授权页面。 相反，通过用户向应用程序授权的作用域集，此流程步骤将自动完成。 例如，如果用户已执行两次 web 流程，且授权了一个拥有 `user` 作用域的令牌和一个拥有 `repo` 作用域的令牌，未提供 `scope` 的第三次 web 流程将收到拥有 `user` 和 `repo` 作用域的令牌。 | -| `state` | `字符串` | {% data reusables.apps.state_description %} | -| `allow_signup` | `字符串` | 在 OAuth 流程中，是否向经过验证的用户提供注册 GitHub 的选项。 默认值为 `true`。 如有政策禁止注册，请使用 `false`。 | +Name | Type | Description +-----|------|-------------- +`client_id`|`string` | **Required**. The client ID you received from GitHub when you {% if currentVersion == "free-pro-team@latest" %}[registered](https://github.com/settings/applications/new){% else %}registered{% endif %}. +`redirect_uri`|`string` | The URL in your application where users will be sent after authorization. See details below about [redirect urls](#redirect-urls). +`login` | `string` | Suggests a specific account to use for signing in and authorizing the app. +`scope`|`string` | A space-delimited list of [scopes](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/). If not provided, `scope` defaults to an empty list for users that have not authorized any scopes for the application. For users who have authorized scopes for the application, the user won't be shown the OAuth authorization page with the list of scopes. Instead, this step of the flow will automatically complete with the set of scopes the user has authorized for the application. For example, if a user has already performed the web flow twice and has authorized one token with `user` scope and another token with `repo` scope, a third web flow that does not provide a `scope` will receive a token with `user` and `repo` scope. +`state` | `string` | {% data reusables.apps.state_description %} +`allow_signup`|`string` | Whether or not unauthenticated users will be offered an option to sign up for GitHub during the OAuth flow. The default is `true`. Use `false` when a policy prohibits signups. -#### 2. 用户被 GitHub 重定向回您的站点 +#### 2. Users are redirected back to your site by GitHub -如果用户接受您的请求，{% data variables.product.product_name %} 将重定向回您的站点，其中，代码参数为临时 `code`，`state` 参数为您在上一步提供的状态。 临时代码将在 10 分钟后到期。 如果状态不匹配，然后第三方创建了请求，您应该中止此过程。 +If the user accepts your request, {% data variables.product.product_name %} redirects back to your site with a temporary `code` in a code parameter as well as the state you provided in the previous step in a `state` parameter. The temporary code will expire after 10 minutes. If the states don't match, then a third party created the request, and you should abort the process. -用此 `code` 换访问令牌： +Exchange this `code` for an access token: POST {% data variables.product.oauth_host_code %}/login/oauth/access_token -##### 参数 +##### Parameters -| 名称 | 类型 | 描述 | -| --------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------- | -| `client_id` | `字符串` | **必填。**您从 {% data variables.product.product_name %} 收到的 {% data variables.product.prodname_github_app %} 的客户端 ID。 | -| `client_secret` | `字符串` | **必填。**您从 {% data variables.product.product_name %} 收到的 {% data variables.product.prodname_github_app %} 的客户端密钥。 | -| `代码` | `字符串` | **必填。**您收到的响应第 1 步的代码。 | -| `redirect_uri` | `字符串` | 用户获得授权后被发送到的应用程序中的 URL。 | -| `state` | `字符串` | 您在第 1 步提供的不可猜测的随机字符串。 | +Name | Type | Description +-----|------|-------------- +`client_id` | `string` | **Required.** The client ID you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_github_app %}. +`client_secret` | `string` | **Required.** The client secret you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_github_app %}. +`code` | `string` | **Required.** The code you received as a response to Step 1. +`redirect_uri` | `string` | The URL in your application where users are sent after authorization. +`state` | `string` | The unguessable random string you provided in Step 1. -##### 响应 +##### Response -默认情况下，响应采用以下形式： +By default, the response takes the following form: access_token=e72e16c7e42f292c6912e7710c838347ae178b4a&token_type=bearer -您也可以根据“接受”标头接收不同格式的内容： +You can also receive the content in different formats depending on the Accept +header: Accept: application/json {"access_token":"e72e16c7e42f292c6912e7710c838347ae178b4a", "scope":"repo,gist", "token_type":"bearer"} - + Accept: application/xml bearer @@ -97,14 +98,14 @@ The web application flow to authorize users for your app is: e72e16c7e42f292c6912e7710c838347ae178b4a -#### 3. 使用访问令牌访问 API +#### 3. Use the access token to access the API -访问令牌可用于代表用户向 API 提出请求。 +The access token allows you to make requests to the API on a behalf of a user. Authorization: token OAUTH-TOKEN GET {% data variables.product.api_url_code %}/user -例如，您可以像以下这样在 curl 中设置“授权”标头： +For example, in curl you can set the Authorization header like this: ```shell curl -H "Authorization: token OAUTH-TOKEN" {% data variables.product.api_url_pre %}/user @@ -135,13 +136,12 @@ Your app must request a user verification code and verification URL that the app ##### Input Parameters -| 名称 | 类型 | 描述 | -| ----------- | ----- | ---------------------------------------------------------------------------------------------------------- | -| `client_id` | `字符串` | **Required.** The client ID you received from {% data variables.product.product_name %} for your app. | -| `作用域` | `字符串` | The scope that your app is requesting access to. | - -##### 响应 +Name | Type | Description +-----|------|-------------- +`client_id` | `string` | **Required.** The client ID you received from {% data variables.product.product_name %} for your app. +`scope` | `string` | The scope that your app is requesting access to. +##### Response {% if currentVersion == "free-pro-team@latest" %} ```JSON @@ -167,13 +167,13 @@ Your app must request a user verification code and verification URL that the app ##### Response parameters -| 名称 | 类型 | 描述 | -| ------------------ | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `device_code` | `字符串` | The device verification code is 40 characters and used to verify the device. | -| `user_code` | `字符串` | The user verification code is displayed on the device so the user can enter the code in a browser. This code is 8 characters with a hyphen in the middle. | -| `verification_uri` | `字符串` | The verification URL where users need to enter the `user_code`: {% data variables.product.device_authorization_url %}. | -| `expires_in` | `整数` | The number of seconds before the `device_code` and `user_code` expire. The default is 900 seconds or 15 minutes. | -| `interval` | `整数` | The minimum number of seconds that must pass before you can make a new access token request (`POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`) to complete the device authorization. For example, if the interval is 5, then you cannot make a new request until 5 seconds pass. If you make more than one request over 5 seconds, then you will hit the rate limit and receive a `slow_down` error. | +Name | Type | Description +-----|------|-------------- +`device_code` | `string` | The device verification code is 40 characters and used to verify the device. +`user_code` | `string` | The user verification code is displayed on the device so the user can enter the code in a browser. This code is 8 characters with a hyphen in the middle. +`verification_uri` | `string` | The verification URL where users need to enter the `user_code`: {% data variables.product.device_authorization_url %}. +`expires_in` | `integer`| The number of seconds before the `device_code` and `user_code` expire. The default is 900 seconds or 15 minutes. +`interval` | `integer` | The minimum number of seconds that must pass before you can make a new access token request (`POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`) to complete the device authorization. For example, if the interval is 5, then you cannot make a new request until 5 seconds pass. If you make more than one request over 5 seconds, then you will hit the rate limit and receive a `slow_down` error. #### Step 2: Prompt the user to enter the user code in a browser @@ -193,13 +193,13 @@ Once the user has authorized, the app will receive an access token that can be u ##### Input parameters -| 名称 | 类型 | 描述 | -| ------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | -| `client_id` | `字符串` | **必填。**您从 {% data variables.product.product_name %} 收到的 {% data variables.product.prodname_oauth_app %} 的客户端 ID。 | -| `device_code` | `字符串` | **Required.** The device verification code you received from the `POST {% data variables.product.oauth_host_code %}/login/device/code` request. | -| `grant_type` | `字符串` | **Required.** The grant type must be `urn:ietf:params:oauth:grant-type:device_code`. | +Name | Type | Description +-----|------|-------------- +`client_id` | `string` | **Required.** The client ID you received from {% data variables.product.product_name %} for your {% data variables.product.prodname_oauth_app %}. +`device_code` | `string` | **Required.** The device verification code you received from the `POST {% data variables.product.oauth_host_code %}/login/device/code` request. +`grant_type` | `string` | **Required.** The grant type must be `urn:ietf:params:oauth:grant-type:device_code`. -##### 响应 +##### Response ```json { @@ -217,36 +217,42 @@ If you make more than one access token request (`POST {% data variables.product. #### Error codes for the device flow -| Error code | 描述 | -| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `authorization_pending` | This error occurs when the authorization request is pending and the user hasn't entered the user code yet. The app is expected to keep polling the `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token` request without exceeding the [`interval`](#response-parameters), which requires a minimum number of seconds between each request. | -| `slow_down` | When you receive the `slow_down` error, 5 extra seconds are added to the minimum `interval` or timeframe required between your requests using `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`. For example, if the starting interval required at least 5 seconds between requests and you get a `slow_down` error response, you must now wait a minimum of 10 seconds before making a new request for an OAuth access token. The error response includes the new `interval` that you must use. | -| `expired_token` | If the device code expired, then you will see the `token_expired` error. You must make a new request for a device code. | -| `unsupported_grant_type` | The grant type must be `urn:ietf:params:oauth:grant-type:device_code` and included as an input parameter when you poll the OAuth token request `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`. | -| `incorrect_client_credentials` | For the device flow, you must pass your app's client ID, which you can find on your app settings page. The `client_secret` is not needed for the device flow. | -| `incorrect_device_code` | The device_code provided is not valid. | -| `access_denied` | When a user clicks cancel during the authorization process, you'll receive a `access_denied` error and the user won't be able to use the verification code again. | +| Error code | Description | +|----|----| +| `authorization_pending`| This error occurs when the authorization request is pending and the user hasn't entered the user code yet. The app is expected to keep polling the `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token` request without exceeding the [`interval`](#response-parameters), which requires a minimum number of seconds between each request. | +| `slow_down` | When you receive the `slow_down` error, 5 extra seconds are added to the minimum `interval` or timeframe required between your requests using `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`. For example, if the starting interval required at least 5 seconds between requests and you get a `slow_down` error response, you must now wait a minimum of 10 seconds before making a new request for an OAuth access token. The error response includes the new `interval` that you must use. +| `expired_token` | If the device code expired, then you will see the `token_expired` error. You must make a new request for a device code. +| `unsupported_grant_type` | The grant type must be `urn:ietf:params:oauth:grant-type:device_code` and included as an input parameter when you poll the OAuth token request `POST {% data variables.product.oauth_host_code %}/login/oauth/access_token`. +| `incorrect_client_credentials` | For the device flow, you must pass your app's client ID, which you can find on your app settings page. The `client_secret` is not needed for the device flow. +| `incorrect_device_code` | The device_code provided is not valid. +| `access_denied` | When a user clicks cancel during the authorization process, you'll receive a `access_denied` error and the user won't be able to use the verification code again. For more information, see the "[OAuth 2.0 Device Authorization Grant](https://tools.ietf.org/html/rfc8628#section-3.5)." {% endif %} -### 非 Web 应用程序流程 +### Non-Web application flow -非 web 身份验证适用于测试等有限的情况。 如果您需要，可以使用[基本验证](/v3/auth#basic-authentication)，通过[个人访问令牌设置页面](/articles/creating-an-access-token-for-command-line-use)创建个人访问令牌。 此方法支持用户随时撤销访问权限。 +Non-web authentication is available for limited situations like testing. If you need to, you can use [Basic Authentication](/v3/auth#basic-authentication) to create a personal access token using your [Personal access tokens settings page](/articles/creating-an-access-token-for-command-line-use). This technique enables the user to revoke access at any time. {% note %} -**注：**使用非 web 应用流程创建 OAuth2 令牌时，如果您或您的用户已启用双重身份验证，请确保明白如何[使用双重身份验证](/v3/auth/#working-with-two-factor-authentication)。 +**Note:** When using the non-web application flow to create an OAuth2 token, make sure to understand how to [work with +two-factor authentication](/v3/auth/#working-with-two-factor-authentication) if +you or your users have two-factor authentication enabled. {% endnote %} -### 重定向 URL +### Redirect URLs -`redirect_uri` 参数是可选参数。 如果遗漏，GitHub 则将用户重定向到 OAuth 应用程序设置中配置的回调 URL。 如果提供，重定向 URL 的主机和端口必须完全匹配回调 URL。 重定向 URL 的路径必须引用回调 URL 的子目录。 +The `redirect_uri` parameter is optional. If left out, GitHub will +redirect users to the callback URL configured in the OAuth Application +settings. If provided, the redirect URL's host and port must exactly +match the callback URL. The redirect URL's path must reference a +subdirectory of the callback URL. CALLBACK: http://example.com/path - + GOOD: http://example.com/path GOOD: http://example.com/path/subdir/other BAD: http://example.com/bar @@ -255,29 +261,29 @@ For more information, see the "[OAuth 2.0 Device Authorization Grant](https://to BAD: http://oauth.example.com:8080/path BAD: http://example.org -#### 本地主机重定向 URL +#### Localhost redirect urls -可选的 `redirect_uri` 参数也可用于本地主机 URL。 如果应用程序指定 URL 和端口，授权后，应用程序用户将被重定向到提供的 URL 和端口。 `redirect_uri` 不需要匹配应用程序回调 url 中指定的端口。 +The optional `redirect_uri` parameter can also be used for localhost URLs. If the application specifies a localhost URL and a port, then after authorizing the application users will be redirected to the provided URL and port. The `redirect_uri` does not need to match the port specified in the callback url for the app. -对于 `http://localhost/path` 回调 URL，您可以使用此 `redirect_uri`： +For the `http://localhost/path` callback URL, you can use this `redirect_uri`: http://localhost:1234/path -### 为 OAuth 应用程序创建多个令牌 +### Creating multiple tokens for OAuth Apps -您可以为用户/应用程序/作用域组合创建多个令牌，以便为特定用例创建令牌。 +You can create multiple tokens for a user/application/scope combination to create tokens for specific use cases. -如果您的 OAuth 应用程序支持一个使用 GitHub 登录且只需基本用户信息的工作流程，此方法将非常有用。 另一个工作流程可能需要访问用户的私有仓库。 您的 OAuth 应用程序可以使用多个令牌为每个用例执行 web 流程，只需要所需的作用域。 如果用户仅使用您的应用程序登录，则无需向他们的私有仓库授予您的 OAuth 应用程序访问权限。 +This is useful if your OAuth App supports one workflow that uses GitHub for sign-in and only requires basic user information. Another workflow may require access to a user's private repositories. Using multiple tokens, your OAuth App can perform the web flow for each use case, requesting only the scopes needed. If a user only uses your application to sign in, they are never required to grant your OAuth App access to their private repositories. -每个用户/应用程序/作用域组合签发的令牌数量有限。 如果您的应用程序请求足够的令牌超越其中一个限制，_所请求的作用域相同的_旧令牌将停止工作。 +There is a limit to the number of tokens that are issued per user/application/scope combination. If your application requests enough tokens to go over one of the limits, older tokens _with the same scope being requested_ will stop working. {% data reusables.apps.deletes_ssh_keys %} -### 指示用户审查其访问权限 +### Directing users to review their access -您可以链接至 OAuth 应用程序的授权信息，以便用户审查和撤销其应用程序授权。 +You can link to authorization information for an OAuth App so that users can review and revoke their application authorizations. -要构建此链接，需要使用注册应用程序时从 GitHub 收到的 OAuth 应用程序 `client_id`。 +To build this link, you'll need your OAuth Apps `client_id` that you received from GitHub when you registered the application. ``` {% data variables.product.oauth_host_code %}/settings/connections/applications/:client_id @@ -285,14 +291,14 @@ For more information, see the "[OAuth 2.0 Device Authorization Grant](https://to {% tip %} -**提示：**要详细了解您的 OAuth 应用程序可以为用户访问的资源，请参阅“[为用户发现资源](/v3/guides/discovering-resources-for-a-user/)。” +**Tip:** To learn more about the resources that your OAuth App can access for a user, see "[Discovering resources for a user](/v3/guides/discovering-resources-for-a-user/)." {% endtip %} -### 疑难解答 +### Troubleshooting -* "[对授权请求错误进行故障排除](/apps/managing-oauth-apps/troubleshooting-authorization-request-errors)" -* "[对 OAuth 应用程序访问令牌请求错误进行故障排除](/apps/managing-oauth-apps/troubleshooting-oauth-app-access-token-request-errors)" +* "[Troubleshooting authorization request errors](/apps/managing-oauth-apps/troubleshooting-authorization-request-errors)" +* "[Troubleshooting OAuth App access token request errors](/apps/managing-oauth-apps/troubleshooting-oauth-app-access-token-request-errors)" {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} * "[Device flow errors](#errors-for-the-device-flow)" {% endif %} diff --git a/translations/zh-CN/content/developers/apps/creating-a-custom-badge-for-your-github-app.md b/translations/zh-CN/content/developers/apps/creating-a-custom-badge-for-your-github-app.md index 239a7095e36b..a8c5a02aca7c 100644 --- a/translations/zh-CN/content/developers/apps/creating-a-custom-badge-for-your-github-app.md +++ b/translations/zh-CN/content/developers/apps/creating-a-custom-badge-for-your-github-app.md @@ -14,7 +14,7 @@ versions: 创建 GitHub 应用程序后，可以通过上传徽标和选择背景颜色自定义应用程序的徽章。 徽章是圆形徽章内的方形徽标图像。 您可以为徽章选择背景颜色，以便从视觉上与应用程序区分开。 -徽标应为 1 MB 以下的 PNG、JPG 或 GIF 文件。 为获得最佳渲染效果，建议图像大小至少为 200px x 200px。 {% if currentVersion == "free-pro-team@latest" %}请参阅“[徽标和徽章图像提示](/marketplace/listing-on-github-marketplace/writing-github-marketplace-listing-descriptions/#guidelines-for-logos)”，了解更详细的自定义徽章指南。{% endif %} +徽标应为 1 MB 以下的 PNG、JPG 或 GIF 文件。 为获得最佳渲染效果，建议图像大小至少为 200px x 200px。 {% if currentVersion == "free-pro-team@latest" %}See "[Tips for logo and badge images](/marketplace/listing-on-github-marketplace/writing-github-marketplace-listing-descriptions/#guidelines-for-logos)" for more guidance on customizing badges.{% endif %} {% if currentVersion == "free-pro-team@latest" %} @@ -30,7 +30,7 @@ versions: {% data reusables.user-settings.modify_github_app %} 5. 在“Display information（显示信息）”中，从本地文件夹拖放图像，或单击 **Upload a logo（上传徽标）**，从计算机选择图像。 ![上传徽标](/assets/images/github-apps/github_apps_upload_logo.png) 6. 裁剪图片。 完成后，单击 **Set new avatar（设置新头像）**。 ![裁剪和设置徽标 ](/assets/images/github-apps/github_apps_crop_and_set_avatar.png) -7. 在“Badge background color（徽章背景颜色）”中，输入徽章背景颜色的[十六进制颜色代码](http://www.color-hex.com/)。 {% if currentVersion == "free-pro-team@latest" %}**注：**只有在上传应用程序徽标后才会显示“徽章背景颜色”输入字段。{% endif %} ![徽章背景颜色](/assets/images/github-apps/github_apps_badge_background_color.png) +7. 在“Badge background color（徽章背景颜色）”中，输入徽章背景颜色的[十六进制颜色代码](http://www.color-hex.com/)。 {% if currentVersion == "free-pro-team@latest" %}**Note:** The "Badge background color" input field will only appear after you upload an application logo.{% endif %} ![徽章背景颜色](/assets/images/github-apps/github_apps_badge_background_color.png) {% if currentVersion == "free-pro-team@latest" %} diff --git a/translations/zh-CN/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md b/translations/zh-CN/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md index 003c7be9d5e7..130fce0adb15 100644 --- a/translations/zh-CN/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md +++ b/translations/zh-CN/content/developers/apps/creating-a-custom-badge-for-your-oauth-app.md @@ -8,16 +8,13 @@ versions: enterprise-server: '*' --- - - - By default, a new OAuth App will have an automatically generated [identicon](https://github.com/blog/1586-identicons). 默认肖像徽章如下所示： ![默认肖像](/assets/images/identicon.png) After you create an OAuth App, you can customize the app's badge by uploading a logo and selecting a background color. 徽章是圆形徽章内的方形徽标图像。 You can choose a background color for the badge, which can be used to visually distinguish your app. -徽标应为 1 MB 以下的 PNG、JPG 或 GIF 文件。 为获得最佳渲染效果，建议图像大小至少为 200px x 200px。 {% if currentVersion == "free-pro-team@latest" %}请参阅“[徽标和徽章图像提示](/marketplace/listing-on-github-marketplace/writing-github-marketplace-listing-descriptions/#guidelines-for-logos)”，了解更详细的自定义徽章指南。{% endif %} +徽标应为 1 MB 以下的 PNG、JPG 或 GIF 文件。 为获得最佳渲染效果，建议图像大小至少为 200px x 200px。 {% if currentVersion == "free-pro-team@latest" %}See "[Tips for logo and badge images](/marketplace/listing-on-github-marketplace/writing-github-marketplace-listing-descriptions/#guidelines-for-logos)" for more guidance on customizing badges.{% endif %} {% if currentVersion == "free-pro-team@latest" %} @@ -31,7 +28,7 @@ After you create an OAuth App, you can customize the app's badge by uploading a {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.oauth_apps %} {% data reusables.user-settings.modify_oauth_app %} -5. In "Application logo", drag-and-drop an image from a local folder or click **Upload new logo** to select an image from your computer. ![上传徽标](/assets/images/oauth-apps/oauth_apps_upload_logo.png) +1. In "Application logo", drag-and-drop an image from a local folder or click **Upload new logo** to select an image from your computer. ![上传徽标](/assets/images/oauth-apps/oauth_apps_upload_logo.png) 6. 裁剪图片。 When you're done, click **Set new application logo**. ![裁剪和设置徽标](/assets/images/oauth-apps/oauth_apps_crop_and_set_logo.png) 7. 在“Badge background color（徽章背景颜色）”中，输入徽章背景颜色的[十六进制颜色代码](http://www.color-hex.com/)。 {% if currentVersion == "free-pro-team@latest" %}**Note:** The "Badge background color" input field will be visible after an application logo has been uploaded.{% endif %} diff --git a/translations/zh-CN/content/developers/apps/creating-a-github-app-from-a-manifest.md b/translations/zh-CN/content/developers/apps/creating-a-github-app-from-a-manifest.md index e702fd84d0a3..cc98ff80aa76 100644 --- a/translations/zh-CN/content/developers/apps/creating-a-github-app-from-a-manifest.md +++ b/translations/zh-CN/content/developers/apps/creating-a-github-app-from-a-manifest.md @@ -71,9 +71,9 @@ The `hook_attributes` object has the following key: ##### 参数 - | 名称 | 类型 | 描述 | - | ------- | ----- | ------------------------------------------------ | - | `state` | `字符串` | {% data reusables.apps.state_description %} | + | 名称 | 类型 | 描述 | + | ------- | ----- | ------------------------------------------- | + | `state` | `字符串` | {% data reusables.apps.state_description %} ##### 示例 diff --git a/translations/zh-CN/content/developers/apps/creating-a-github-app-using-url-parameters.md b/translations/zh-CN/content/developers/apps/creating-a-github-app-using-url-parameters.md index 60caae4f1f8f..d718d3f89bdd 100644 --- a/translations/zh-CN/content/developers/apps/creating-a-github-app-using-url-parameters.md +++ b/translations/zh-CN/content/developers/apps/creating-a-github-app-using-url-parameters.md @@ -27,93 +27,93 @@ The complete list of available query parameters, permissions, and events is list ### {% data variables.product.prodname_github_app %} configuration parameters - | 名称 | 类型 | 描述 | - | -------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - | `name` | `字符串` | The name of the {% data variables.product.prodname_github_app %}. Give your app a clear and succinct name. Your app cannot have the same name as an existing GitHub user, unless it is your own user or organization name. A slugged version of your app's name will be shown in the user interface when your integration takes an action. | - | `说明` | `字符串` | A description of the {% data variables.product.prodname_github_app %}. | - | `url` | `字符串` | The full URL of your {% data variables.product.prodname_github_app %}'s website homepage. | - | `callback_url` | `字符串` | The full URL to redirect to after someone authorizes an installation. This URL is used if your app needs to identify and authorize user-to-server requests. | - | `request_oauth_on_install` | `布尔值` | If your app authorizes users using the OAuth flow, you can set this option to `true` to allow people to authorize the app when they install it, saving a step. If you select this option, the `setup_url` becomes unavailable and users will be redirected to your `callback_url` after installing the app. | - | `setup_url` | `字符串` | The full URL to redirect to after someone installs the {% data variables.product.prodname_github_app %} if the app requires additional setup after installation. | - | `setup_on_update` | `布尔值` | Set to `true` to redirect people to the setup URL when installations have been updated, for example, after repositories are added or removed. | - | `public` | `布尔值` | Set to `true` when your {% data variables.product.prodname_github_app %} is available to the public or `false` when it is only accessible to the owner of the app. | - | `webhook_url` | `字符串` | The full URL that you would like to send webhook event payloads to. | - | `webhook_secret` | `字符串` | You can specify a secret to secure your webhooks. See "[Securing your webhooks](/webhooks/securing/)" for more details. | - | `事件` | `字符串数组` | Web 挂钩事件. Some webhook events require `read` or `write` permissions for a resource before you can select the event when registering a new {% data variables.product.prodname_github_app %}. See the "[{% data variables.product.prodname_github_app %} webhook events](#github-app-webhook-events)" section for available events and their required permissions. You can select multiple events in a query string. For example, `events[]=public&events[]=label`. | - | `域` | `字符串` | The URL of a content reference. | - | `single_file_name` | `字符串` | When you grant `read` or `write` access to the `single_file` permission, this field provides the path to the single file your {% data variables.product.prodname_github_app %} will manage. | + Name | Type | Description +-----|------|------------- +`name` | `string` | The name of the {% data variables.product.prodname_github_app %}. Give your app a clear and succinct name. Your app cannot have the same name as an existing GitHub user, unless it is your own user or organization name. A slugged version of your app's name will be shown in the user interface when your integration takes an action. +`description` | `string` | A description of the {% data variables.product.prodname_github_app %}. +`url` | `string` | The full URL of your {% data variables.product.prodname_github_app %}'s website homepage. +`callback_url` | `string` | The full URL to redirect to after someone authorizes an installation. This URL is used if your app needs to identify and authorize user-to-server requests. +`request_oauth_on_install` | `boolean` | If your app authorizes users using the OAuth flow, you can set this option to `true` to allow people to authorize the app when they install it, saving a step. If you select this option, the `setup_url` becomes unavailable and users will be redirected to your `callback_url` after installing the app. +`setup_url` | `string` | The full URL to redirect to after someone installs the {% data variables.product.prodname_github_app %} if the app requires additional setup after installation. +`setup_on_update` | `boolean` | Set to `true` to redirect people to the setup URL when installations have been updated, for example, after repositories are added or removed. +`public` | `boolean` | Set to `true` when your {% data variables.product.prodname_github_app %} is available to the public or `false` when it is only accessible to the owner of the app. +`webhook_url` | `string` | The full URL that you would like to send webhook event payloads to. +`webhook_secret` | `string` | You can specify a secret to secure your webhooks. See "[Securing your webhooks](/webhooks/securing/)" for more details. +`events` | `array of strings` | Webhook events. Some webhook events require `read` or `write` permissions for a resource before you can select the event when registering a new {% data variables.product.prodname_github_app %}. See the "[{% data variables.product.prodname_github_app %} webhook events](#github-app-webhook-events)" section for available events and their required permissions. You can select multiple events in a query string. For example, `events[]=public&events[]=label`. +`domain` | `string` | The URL of a content reference. +`single_file_name` | `string` | When you grant `read` or `write` access to the `single_file` permission, this field provides the path to the single file your {% data variables.product.prodname_github_app %} will manage. ### {% data variables.product.prodname_github_app %} permissions You can select permissions in a query string using the permission name in the following table as the query parameter name and the permission type as the query value. For example, to select `Read & write` permissions in the user interface for `contents`, your query string would include `&contents=write`. To select `Read-only` permissions in the user interface for `blocking`, your query string would include `&blocking=read`. To select `no-access` in the user interface for `checks`, your query string would not include the `checks` permission. -| 权限 | 描述 | -| -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`管理`](/rest/reference/permissions-required-for-github-apps/#permission-on-administration) | Grants access to various endpoints for organization and repository administration. Can be one of: `none`, `read`, or `write`.{% if currentVersion == "free-pro-team@latest" %} -| [`blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-blocking) | Grants access to the [Blocking Users API](/v3/users/blocking/). Can be one of: `none`, `read`, or `write`.{% endif %} -| [`检查`](/rest/reference/permissions-required-for-github-apps/#permission-on-checks) | Grants access to the [Checks API](/v3/checks/). Can be one of: `none`, `read`, or `write`. | -| `content_references` | Grants access to the "[Create a content attachment](/v3/apps/installations/#create-a-content-attachment)" endpoint. Can be one of: `none`, `read`, or `write`. | -| [`内容`](/rest/reference/permissions-required-for-github-apps/#permission-on-contents) | Grants access to various endpoints that allow you to modify repository contents. Can be one of: `none`, `read`, or `write`. | -| [`部署`](/rest/reference/permissions-required-for-github-apps/#permission-on-deployments) | Grants access to the [Deployments API](/v3/repos/deployments/). Can be one of: `none`, `read`, or `write`. | -| [`emails`](/rest/reference/permissions-required-for-github-apps/#permission-on-emails) | Grants access to the [Emails API](/v3/users/emails/). Can be one of: `none`, `read`, or `write`. | -| [`关注者`](/rest/reference/permissions-required-for-github-apps/#permission-on-followers) | Grants access to the [Followers API](/v3/users/followers/). Can be one of: `none`, `read`, or `write`. | -| [`gpg_keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-gpg-keys) | Grants access to the [GPG Keys API](/v3/users/gpg_keys/). Can be one of: `none`, `read`, or `write`. | -| [`issues`](/rest/reference/permissions-required-for-github-apps/#permission-on-issues) | Grants access to the [Issues API](/v3/issues/). Can be one of: `none`, `read`, or `write`. | -| [`键`](/rest/reference/permissions-required-for-github-apps/#permission-on-keys) | Grants access to the [Public Keys API](/v3/users/keys/). Can be one of: `none`, `read`, or `write`. | -| [`members`](/rest/reference/permissions-required-for-github-apps/#permission-on-members) | Grants access to manage an organization's members. Can be one of: `none`, `read`, or `write`.{% if currentVersion == "free-pro-team@latest" %} -| [`元数据`](/rest/reference/permissions-required-for-github-apps/#metadata-permissions) | Grants access to read-only endpoints that do not leak sensitive data. Can be `read` or `none`. Defaults to `read` when you set any permission, or defaults to `none` when you don't specify any permissions for the {% data variables.product.prodname_github_app %}. | -| [`organization_administration`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-administration) | Grants access to "[Update an organization](/v3/orgs/#update-an-organization)" endpoint and the [Organization Interaction Restrictions API](/v3/interactions/orgs/#set-interaction-restrictions-for-an-organization). Can be one of: `none`, `read`, or `write`.{% endif %} -| [`organization_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-hooks) | Grants access to the [Organization Webhooks API](/v3/orgs/hooks/). Can be one of: `none`, `read`, or `write`. | -| `organization_plan` | Grants access to get information about an organization's plan using the "[Get an organization](/v3/orgs/#get-an-organization)" endpoint. Can be one of: `none` or `read`. | -| [`organization_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects) | Grants access to the [Projects API](/v3/projects/). Can be one of: `none`, `read`, `write`, or `admin`.{% if currentVersion == "free-pro-team@latest" %} -| [`organization_user_blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects) | Grants access to the [Blocking Organization Users API](/v3/orgs/blocking/). Can be one of: `none`, `read`, or `write`.{% endif %} -| [`页面`](/rest/reference/permissions-required-for-github-apps/#permission-on-pages) | Grants access to the [Pages API](/v3/repos/pages/). Can be one of: `none`, `read`, or `write`. | -| `plan` | Grants access to get information about a user's GitHub plan using the "[Get a user](/v3/users/#get-a-user)" endpoint. Can be one of: `none` or `read`. | -| [`pull_requests`](/rest/reference/permissions-required-for-github-apps/#permission-on-pull-requests) | Grants access to various pull request endpoints. Can be one of: `none`, `read`, or `write`. | -| [`repository_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-hooks) | Grants access to the [Repository Webhooks API](/v3/repos/hooks/). Can be one of: `none`, `read`, or `write`. | -| [`repository_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-projects) | Grants access to the [Projects API](/v3/projects/). Can be one of: `none`, `read`, `write`, or `admin`. | -| [`single_file`](/rest/reference/permissions-required-for-github-apps/#permission-on-single-file) | Grants access to the [Contents API](/v3/repos/contents/). Can be one of: `none`, `read`, or `write`. | -| [`标星`](/rest/reference/permissions-required-for-github-apps/#permission-on-starring) | Grants access to the [Starring API](/v3/activity/starring/). Can be one of: `none`, `read`, or `write`. | -| [`statuses`](/rest/reference/permissions-required-for-github-apps/#permission-on-statuses) | Grants access to the [Statuses API](/v3/repos/statuses/). Can be one of: `none`, `read`, or `write`. | -| [`team_discussions`](/rest/reference/permissions-required-for-github-apps/#permission-on-team-discussions) | Grants access to the [Team Discussions API](/v3/teams/discussions/) and the [Team Discussion Comments API](/v3/teams/discussion_comments/). Can be one of: `none`, `read`, or `write`. | -| `vulnerability_alerts` | Grants access to receive security alerts for vulnerable dependencies in a repository. See "[About security alerts for vulnerable dependencies](/articles/about-security-alerts-for-vulnerable-dependencies)" to learn more. Can be one of: `none` or `read`. | -| `关注` | Grants access to list and change repositories a user is subscribed to. Can be one of: `none`, `read`, or `write`. | +Permission | Description +---------- | ----------- +[`administration`](/rest/reference/permissions-required-for-github-apps/#permission-on-administration) | Grants access to various endpoints for organization and repository administration. Can be one of: `none`, `read`, or `write`.{% if currentVersion == "free-pro-team@latest" %} +[`blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-blocking) | Grants access to the [Blocking Users API](/v3/users/blocking/). Can be one of: `none`, `read`, or `write`.{% endif %} +[`checks`](/rest/reference/permissions-required-for-github-apps/#permission-on-checks) | Grants access to the [Checks API](/v3/checks/). Can be one of: `none`, `read`, or `write`. +`content_references` | Grants access to the "[Create a content attachment](/v3/apps/installations/#create-a-content-attachment)" endpoint. Can be one of: `none`, `read`, or `write`. +[`contents`](/rest/reference/permissions-required-for-github-apps/#permission-on-contents) | Grants access to various endpoints that allow you to modify repository contents. Can be one of: `none`, `read`, or `write`. +[`deployments`](/rest/reference/permissions-required-for-github-apps/#permission-on-deployments) | Grants access to the [Deployments API](/rest/reference/repos#deployments). Can be one of: `none`, `read`, or `write`. +[`emails`](/rest/reference/permissions-required-for-github-apps/#permission-on-emails) | Grants access to the [Emails API](/v3/users/emails/). Can be one of: `none`, `read`, or `write`. +[`followers`](/rest/reference/permissions-required-for-github-apps/#permission-on-followers) | Grants access to the [Followers API](/v3/users/followers/). Can be one of: `none`, `read`, or `write`. +[`gpg_keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-gpg-keys) | Grants access to the [GPG Keys API](/v3/users/gpg_keys/). Can be one of: `none`, `read`, or `write`. +[`issues`](/rest/reference/permissions-required-for-github-apps/#permission-on-issues) | Grants access to the [Issues API](/v3/issues/). Can be one of: `none`, `read`, or `write`. +[`keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-keys) | Grants access to the [Public Keys API](/v3/users/keys/). Can be one of: `none`, `read`, or `write`. +[`members`](/rest/reference/permissions-required-for-github-apps/#permission-on-members) | Grants access to manage an organization's members. Can be one of: `none`, `read`, or `write`.{% if currentVersion == "free-pro-team@latest" %} +[`metadata`](/rest/reference/permissions-required-for-github-apps/#metadata-permissions) | Grants access to read-only endpoints that do not leak sensitive data. Can be `read` or `none`. Defaults to `read` when you set any permission, or defaults to `none` when you don't specify any permissions for the {% data variables.product.prodname_github_app %}. +[`organization_administration`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-administration) | Grants access to "[Update an organization](/v3/orgs/#update-an-organization)" endpoint and the [Organization Interaction Restrictions API](/v3/interactions/orgs/#set-interaction-restrictions-for-an-organization). Can be one of: `none`, `read`, or `write`.{% endif %} +[`organization_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-hooks) | Grants access to the [Organization Webhooks API](/rest/reference/orgs#webhooks/). Can be one of: `none`, `read`, or `write`. +`organization_plan` | Grants access to get information about an organization's plan using the "[Get an organization](/v3/orgs/#get-an-organization)" endpoint. Can be one of: `none` or `read`. +[`organization_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects) | Grants access to the [Projects API](/v3/projects/). Can be one of: `none`, `read`, `write`, or `admin`.{% if currentVersion == "free-pro-team@latest" %} +[`organization_user_blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects) | Grants access to the [Blocking Organization Users API](/v3/orgs/blocking/). Can be one of: `none`, `read`, or `write`.{% endif %} +[`pages`](/rest/reference/permissions-required-for-github-apps/#permission-on-pages) | Grants access to the [Pages API](/rest/reference/repos#pages). Can be one of: `none`, `read`, or `write`. +`plan` | Grants access to get information about a user's GitHub plan using the "[Get a user](/v3/users/#get-a-user)" endpoint. Can be one of: `none` or `read`. +[`pull_requests`](/rest/reference/permissions-required-for-github-apps/#permission-on-pull-requests) | Grants access to various pull request endpoints. Can be one of: `none`, `read`, or `write`. +[`repository_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-hooks) | Grants access to the [Repository Webhooks API](/v3/repos/hooks/). Can be one of: `none`, `read`, or `write`. +[`repository_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-projects) | Grants access to the [Projects API](/v3/projects/). Can be one of: `none`, `read`, `write`, or `admin`. +[`single_file`](/rest/reference/permissions-required-for-github-apps/#permission-on-single-file) | Grants access to the [Contents API](/v3/repos/contents/). Can be one of: `none`, `read`, or `write`. +[`starring`](/rest/reference/permissions-required-for-github-apps/#permission-on-starring) | Grants access to the [Starring API](/v3/activity/starring/). Can be one of: `none`, `read`, or `write`. +[`statuses`](/rest/reference/permissions-required-for-github-apps/#permission-on-statuses) | Grants access to the [Statuses API](/v3/repos/statuses/). Can be one of: `none`, `read`, or `write`. +[`team_discussions`](/rest/reference/permissions-required-for-github-apps/#permission-on-team-discussions) | Grants access to the [Team Discussions API](/v3/teams/discussions/) and the [Team Discussion Comments API](/v3/teams/discussion_comments/). Can be one of: `none`, `read`, or `write`. +`vulnerability_alerts`| Grants access to receive security alerts for vulnerable dependencies in a repository. See "[About security alerts for vulnerable dependencies](/articles/about-security-alerts-for-vulnerable-dependencies)" to learn more. Can be one of: `none` or `read`. +`watching` | Grants access to list and change repositories a user is subscribed to. Can be one of: `none`, `read`, or `write`. ### {% data variables.product.prodname_github_app %} webhook events -| Web 挂钩事件名称 | Required permission | 描述 | -| -------------------------------------------------------------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------ | -| [`check_run`](/webhooks/event-payloads/#check_run) | `检查` | {% data reusables.webhooks.check_run_short_desc %} | -| [`check_suite`](/webhooks/event-payloads/#check_suite) | `检查` | {% data reusables.webhooks.check_suite_short_desc %} | -| [`commit_comment`](/webhooks/event-payloads/#commit_comment) | `内容` | {% data reusables.webhooks.commit_comment_short_desc %} | -| [`content_reference`](/webhooks/event-payloads/#content_reference) | `content_references` | {% data reusables.webhooks.content_reference_short_desc %} | -| [`create`](/webhooks/event-payloads/#create) | `内容` | {% data reusables.webhooks.create_short_desc %} | -| [`delete`](/webhooks/event-payloads/#delete) | `内容` | {% data reusables.webhooks.delete_short_desc %} | -| [`deployment`](/webhooks/event-payloads/#deployment) | `部署` | {% data reusables.webhooks.deployment_short_desc %} | -| [`deployment_status`](/webhooks/event-payloads/#deployment_status) | `部署` | {% data reusables.webhooks.deployment_status_short_desc %} | -| [`复刻`](/webhooks/event-payloads/#fork) | `内容` | {% data reusables.webhooks.fork_short_desc %} | -| [`gollum`](/webhooks/event-payloads/#gollum) | `内容` | {% data reusables.webhooks.gollum_short_desc %} | -| [`issues`](/webhooks/event-payloads/#issues) | `issues` | {% data reusables.webhooks.issues_short_desc %} | -| [`issue_comment`](/webhooks/event-payloads/#issue_comment) | `issues` | {% data reusables.webhooks.issue_comment_short_desc %} | -| [`标签`](/webhooks/event-payloads/#label) | `元数据` | {% data reusables.webhooks.label_short_desc %} | -| [`成员`](/webhooks/event-payloads/#member) | `members` | {% data reusables.webhooks.member_short_desc %} | -| [`membership`](/webhooks/event-payloads/#membership) | `members` | {% data reusables.webhooks.membership_short_desc %} | -| [`里程碑`](/webhooks/event-payloads/#milestone) | `pull_request` | {% data reusables.webhooks.milestone_short_desc %}{% if currentVersion == "free-pro-team@latest" %} -| [`org_block`](/webhooks/event-payloads/#org_block) | `organization_administration` | {% data reusables.webhooks.org_block_short_desc %}{% endif %} -| [`组织`](/webhooks/event-payloads/#organization) | `members` | {% data reusables.webhooks.organization_short_desc %} | -| [`page_build`](/webhooks/event-payloads/#page_build) | `页面` | {% data reusables.webhooks.page_build_short_desc %} | -| [`project`](/webhooks/event-payloads/#project) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_short_desc %} | -| [`project_card`](/webhooks/event-payloads/#project_card) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_card_short_desc %} | -| [`project_column`](/webhooks/event-payloads/#project_column) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_column_short_desc %} | -| [`public`](/webhooks/event-payloads/#public) | `元数据` | {% data reusables.webhooks.public_short_desc %} | -| [`pull_request`](/webhooks/event-payloads/#pull_request) | `pull_requests` | {% data reusables.webhooks.pull_request_short_desc %} | -| [`pull_request_review`](/webhooks/event-payloads/#pull_request_review) | `pull_request` | {% data reusables.webhooks.pull_request_review_short_desc %} | -| [`pull_request_review_comment`](/webhooks/event-payloads/#pull_request_review_comment) | `pull_request` | {% data reusables.webhooks.pull_request_review_comment_short_desc %} | -| [`推送`](/webhooks/event-payloads/#push) | `内容` | {% data reusables.webhooks.push_short_desc %} | -| [`发行版`](/webhooks/event-payloads/#release) | `内容` | {% data reusables.webhooks.release_short_desc %} | -| [`仓库`](/webhooks/event-payloads/#repository) | `元数据` | {% data reusables.webhooks.repository_short_desc %}{% if currentVersion == "free-pro-team@latest"%} -| [`repository_dispatch`](/webhooks/event-payloads/#repository_dispatch) | `内容` | Allows integrators using GitHub Actions to trigger custom events.{% endif %} -| [`状态`](/webhooks/event-payloads/#status) | `statuses` | {% data reusables.webhooks.status_short_desc %} | -| [`团队`](/webhooks/event-payloads/#team) | `members` | {% data reusables.webhooks.team_short_desc %} | -| [`team_add`](/webhooks/event-payloads/#team_add) | `members` | {% data reusables.webhooks.team_add_short_desc %} | -| [`查看`](/webhooks/event-payloads/#watch) | `元数据` | {% data reusables.webhooks.watch_short_desc %} | +Webhook event name | Required permission | Description +------------------ | ------------------- | ----------- +[`check_run`](/webhooks/event-payloads/#check_run) |`checks` | {% data reusables.webhooks.check_run_short_desc %} +[`check_suite`](/webhooks/event-payloads/#check_suite) |`checks` | {% data reusables.webhooks.check_suite_short_desc %} +[`commit_comment`](/webhooks/event-payloads/#commit_comment) | `contents` | {% data reusables.webhooks.commit_comment_short_desc %} +[`content_reference`](/webhooks/event-payloads/#content_reference) |`content_references` | {% data reusables.webhooks.content_reference_short_desc %} +[`create`](/webhooks/event-payloads/#create) | `contents` | {% data reusables.webhooks.create_short_desc %} +[`delete`](/webhooks/event-payloads/#delete) | `contents` | {% data reusables.webhooks.delete_short_desc %} +[`deployment`](/webhooks/event-payloads/#deployment) | `deployments` | {% data reusables.webhooks.deployment_short_desc %} +[`deployment_status`](/webhooks/event-payloads/#deployment_status) | `deployments` | {% data reusables.webhooks.deployment_status_short_desc %} +[`fork`](/webhooks/event-payloads/#fork) | `contents` | {% data reusables.webhooks.fork_short_desc %} +[`gollum`](/webhooks/event-payloads/#gollum) | `contents` | {% data reusables.webhooks.gollum_short_desc %} +[`issues`](/webhooks/event-payloads/#issues) | `issues` | {% data reusables.webhooks.issues_short_desc %} +[`issue_comment`](/webhooks/event-payloads/#issue_comment) | `issues` | {% data reusables.webhooks.issue_comment_short_desc %} +[`label`](/webhooks/event-payloads/#label) | `metadata` | {% data reusables.webhooks.label_short_desc %} +[`member`](/webhooks/event-payloads/#member) | `members` | {% data reusables.webhooks.member_short_desc %} +[`membership`](/webhooks/event-payloads/#membership) | `members` | {% data reusables.webhooks.membership_short_desc %} +[`milestone`](/webhooks/event-payloads/#milestone) | `pull_request` | {% data reusables.webhooks.milestone_short_desc %}{% if currentVersion == "free-pro-team@latest" %} +[`org_block`](/webhooks/event-payloads/#org_block) | `organization_administration` | {% data reusables.webhooks.org_block_short_desc %}{% endif %} +[`organization`](/webhooks/event-payloads/#organization) | `members` | {% data reusables.webhooks.organization_short_desc %} +[`page_build`](/webhooks/event-payloads/#page_build) | `pages` | {% data reusables.webhooks.page_build_short_desc %} +[`project`](/webhooks/event-payloads/#project) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_short_desc %} +[`project_card`](/webhooks/event-payloads/#project_card) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_card_short_desc %} +[`project_column`](/webhooks/event-payloads/#project_column) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_column_short_desc %} +[`public`](/webhooks/event-payloads/#public) | `metadata` | {% data reusables.webhooks.public_short_desc %} +[`pull_request`](/webhooks/event-payloads/#pull_request) | `pull_requests` | {% data reusables.webhooks.pull_request_short_desc %} +[`pull_request_review`](/webhooks/event-payloads/#pull_request_review) | `pull_request` | {% data reusables.webhooks.pull_request_review_short_desc %} +[`pull_request_review_comment`](/webhooks/event-payloads/#pull_request_review_comment) | `pull_request` | {% data reusables.webhooks.pull_request_review_comment_short_desc %} +[`push`](/webhooks/event-payloads/#push) | `contents` | {% data reusables.webhooks.push_short_desc %} +[`release`](/webhooks/event-payloads/#release) | `contents` | {% data reusables.webhooks.release_short_desc %} +[`repository`](/webhooks/event-payloads/#repository) |`metadata` | {% data reusables.webhooks.repository_short_desc %}{% if currentVersion == "free-pro-team@latest"%} +[`repository_dispatch`](/webhooks/event-payloads/#repository_dispatch) | `contents` | Allows integrators using GitHub Actions to trigger custom events.{% endif %} +[`status`](/webhooks/event-payloads/#status) | `statuses` | {% data reusables.webhooks.status_short_desc %} +[`team`](/webhooks/event-payloads/#team) | `members` | {% data reusables.webhooks.team_short_desc %} +[`team_add`](/webhooks/event-payloads/#team_add) | `members` | {% data reusables.webhooks.team_add_short_desc %} +[`watch`](/webhooks/event-payloads/#watch) | `metadata` | {% data reusables.webhooks.watch_short_desc %} diff --git a/translations/zh-CN/content/developers/apps/creating-ci-tests-with-the-checks-api.md b/translations/zh-CN/content/developers/apps/creating-ci-tests-with-the-checks-api.md index 252b2687fd00..a2b1a9e90351 100644 --- a/translations/zh-CN/content/developers/apps/creating-ci-tests-with-the-checks-api.md +++ b/translations/zh-CN/content/developers/apps/creating-ci-tests-with-the-checks-api.md @@ -9,7 +9,6 @@ versions: --- - ### 简介 This guide will introduce you to [Github Apps](/apps/) and the [Checks API](/v3/checks/), which you'll use to build a continuous integration (CI) server that runs tests. @@ -134,6 +133,26 @@ The `requested` action requests a check run each time code is pushed to the repo You'll add this new method as a [Sinatra helper](https://github.com/sinatra/sinatra#helpers) in case you want other routes to use it too. Under `helpers do`, add this `create_check_run` method: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +``` ruby +# Create a new check run with the status queued +def create_check_run + # # At the time of writing, Octokit does not support the Checks API yet, but + # it does provide generic HTTP methods you can use: + # /v3/checks/runs/#create-a-check-run + check_run = @installation_client.post( + "repos/#{@payload['repository']['full_name']}/check-runs", + { + accept: 'application/vnd.github.v3+json', + # The name of your check run. + name: 'Octo RuboCop', + # The payload structure differs depending on whether a check run or a check suite event occurred. + head_sha: @payload['check_run'].nil? ? @payload['check_suite']['head_sha'] : @payload['check_run']['head_sha'] + } + ) +end +``` +{% else %} ``` ruby # Create a new check run with the status queued def create_check_run @@ -153,6 +172,7 @@ def create_check_run ) end ``` +{% endif %} This code calls the "[Create a check run](/v3/checks/runs/#create-a-check-run)" endpoint using the generic [HTTP `POST` method](http://octokit.github.io/octokit.rb/Octokit/Connection.html#post-instance_method). This method takes two parameters: the URL of the endpoint and the input parameters to the method. @@ -180,7 +200,7 @@ If you see other apps in the Checks tab, it means you have other apps installed 太好了！ You've told GitHub to create a check run. You can see the check run status is set to `queued` next to a yellow icon. Next, you'll want to wait for GitHub to create the check run and update its status. -### Step 1.4. Updating a check run +### 步骤 1.4. Updating a check run When your `create_check_run` method runs, it asks GitHub to create a new check run. When Github finishes creating the check run, you'll receive the `check_run` webhook event with the `created` action. That event is your signal to begin running the check. @@ -209,6 +229,43 @@ In this section, you're not going to kick off the CI test yet, but you'll walk t Let's create the `initiate_check_run` method and update the status of the check run. Add the following code to the helpers section: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +``` ruby +# Start the CI process +def initiate_check_run + # Once the check run is created, you'll update the status of the check run + # to 'in_progress' and run the CI process. When the CI finishes, you'll + # update the check run status to 'completed' and add the CI results. + + # Octokit doesn't yet support the Checks API, but it does provide generic + # HTTP methods you can use: + # /v3/checks/runs/#update-a-check-run + updated_check_run = @installation_client.patch( + "repos/#{@payload['repository']['full_name']}/check-runs/#{@payload['check_run']['id']}", + { + accept: 'application/vnd.github.v3+json', + name: 'Octo RuboCop', + status: 'in_progress', + started_at: Time.now.utc.iso8601 + } + ) + + # ***** RUN A CI TEST ***** + + # Mark the check run as complete! + updated_check_run = @installation_client.patch( + "repos/#{@payload['repository']['full_name']}/check-runs/#{@payload['check_run']['id']}", + { + accept: 'application/vnd.github.v3+json', + name: 'Octo RuboCop', + status: 'completed', + conclusion: 'success', + completed_at: Time.now.utc.iso8601 + } + ) +end +``` +{% else %} ``` ruby # Start the CI process def initiate_check_run @@ -245,6 +302,7 @@ def initiate_check_run ) end ``` +{% endif %} The code above calls the "[Update a check run](/v3/checks/runs/#update-a-check-run)" API endpoint using the generic [`patch` HTTP method](http://octokit.github.io/octokit.rb/Octokit/Connection.html#patch-instance_method) to update the check run that you already created. @@ -549,6 +607,21 @@ text = "Octo RuboCop version: #{@output['metadata']['rubocop_version']}" Now you've got all the information you need to update your check run. In the [first half of this quickstart](#step-14-updating-a-check-run), you added this code to set the status of the check run to `success`: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +``` ruby +# Mark the check run as complete! +updated_check_run = @installation_client.patch( + "repos/#{@payload['repository']['full_name']}/check-runs/#{@payload['check_run']['id']}", + { + accept: 'application/vnd.github.v3+json', + name: 'Octo RuboCop', + status: 'completed', + conclusion: 'success', + completed_at: Time.now.utc.iso8601 + } +) +``` +{% else %} ``` ruby # Mark the check run as complete! updated_check_run = @installation_client.patch( @@ -562,9 +635,36 @@ updated_check_run = @installation_client.patch( } ) ``` +{% endif %} You'll need to update that code to use the `conclusion` variable you set based on the RuboCop results (to `success` or `neutral`). You can update the code with the following: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +``` ruby +# Mark the check run as complete! And if there are warnings, share them. +updated_check_run = @installation_client.patch( + "repos/#{@payload['repository']['full_name']}/check-runs/#{@payload['check_run']['id']}", + { + accept: 'application/vnd.github.v3+json', + name: 'Octo RuboCop', + status: 'completed', + conclusion: conclusion, + completed_at: Time.now.utc.iso8601, + output: { + title: 'Octo RuboCop', + summary: summary, + text: text, + annotations: annotations + }, + actions: [{ + label: 'Fix this', + description: 'Automatically fix all linter notices.', + identifier: 'fix_rubocop_notices' + }] + } +) +``` +{% else %} ``` ruby # Mark the check run as complete! And if there are warnings, share them. updated_check_run = @installation_client.patch( @@ -589,6 +689,7 @@ updated_check_run = @installation_client.patch( } ) ``` +{% endif %} Now that you're setting a conclusion based on the status of the CI test and you've added the output from the RuboCop results, you've created a CI test! Congratulations. 🙌 diff --git a/translations/zh-CN/content/developers/apps/differences-between-github-apps-and-oauth-apps.md b/translations/zh-CN/content/developers/apps/differences-between-github-apps-and-oauth-apps.md index eecf05993332..d4d03162b48b 100644 --- a/translations/zh-CN/content/developers/apps/differences-between-github-apps-and-oauth-apps.md +++ b/translations/zh-CN/content/developers/apps/differences-between-github-apps-and-oauth-apps.md @@ -50,13 +50,13 @@ An _authorized_ OAuth App has access to all of the user's or organization owner' {% endnote %} -| GitHub 应用程序 | OAuth Apps | -| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| A GitHub App can request an installation access token by using a private key with a JSON web token format out-of-band. | An OAuth app can exchange a request token for an access token after a redirect via a web request. | -| An installation token identifies the app as the GitHub Apps bot, such as @jenkins-bot. | An access token identifies the app as the user who granted the token to the app, such as @octocat. | -| Installation tokens expire after a predefined amount of time (currently 1 hour). | OAuth tokens remain active until they're revoked by the customer. | -| {% data reusables.apps.api-rate-limits-non-ghec %}{% if currentVersion == "free-pro-team@latest" %} Higher rate limits apply for {% data variables.product.prodname_ghe_cloud %}. For more information, see "[Rate limits for GitHub Apps](/developers/apps/rate-limits-for-github-apps)."{% endif %} | OAuth tokens use the user's rate limit of 5,000 requests per hour. | -| Rate limit increases can be granted both at the GitHub Apps level (affecting all installations) and at the individual installation level. | Rate limit increases are granted per OAuth App. Every token granted to that OAuth App gets the increased limit. |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} +| GitHub 应用程序 | OAuth Apps | +| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| A GitHub App can request an installation access token by using a private key with a JSON web token format out-of-band. | An OAuth app can exchange a request token for an access token after a redirect via a web request. | +| An installation token identifies the app as the GitHub Apps bot, such as @jenkins-bot. | An access token identifies the app as the user who granted the token to the app, such as @octocat. | +| Installation tokens expire after a predefined amount of time (currently 1 hour). | OAuth tokens remain active until they're revoked by the customer. | +| {% data reusables.apps.api-rate-limits-non-ghec %}{% if currentVersion == "free-pro-team@latest" %} Higher rate limits apply for {% data variables.product.prodname_ghe_cloud %}. For more information, see "[Rate limits for GitHub Apps](/developers/apps/rate-limits-for-github-apps)."{% endif %} | OAuth tokens use the user's rate limit of 5,000 requests per hour. | +| Rate limit increases can be granted both at the GitHub Apps level (affecting all installations) and at the individual installation level. | Rate limit increases are granted per OAuth App. Every token granted to that OAuth App gets the increased limit. |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} | {% data variables.product.prodname_github_app %}s can authenticate on behalf of the user, which is called user-to-server requests. The flow to authorize is the same as the OAuth App authorization flow. User-to-server tokens can expire and be renewed with a refresh token. For more information, see "[Refreshing user-to-server access tokens](/apps/building-github-apps/refreshing-user-to-server-access-tokens/)" and "[Identifying and authorizing users for GitHub Apps](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/)." | The OAuth flow used by {% data variables.product.prodname_oauth_app %}s authorizes an {% data variables.product.prodname_oauth_app %} on behalf of the user. This is the same flow used in {% data variables.product.prodname_github_app %} user-to-server authorization. |{% endif %} ### Requesting permission levels for resources @@ -102,5 +102,5 @@ Bot accounts are specific to GitHub Apps and are built into every GitHub App. | GitHub 应用程序 | OAuth Apps | | --------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | -| GitHub App bots do not consume a {% data variables.product.prodname_enterprise %} seat. | A machine user account consumes a {% data variables.product.prodname_enterprise %} seat. | +| GitHub App bots do not consume a {% data variables.product.prodname_enterprise %} seat. | A machine user account consumes a {% data variables.product.prodname_enterprise %} seat. | | Because a GitHub App bot is never granted a password, a customer can't sign into it directly. | A machine user account is granted a username and password to be managed and secured by the customer. | diff --git a/translations/zh-CN/content/developers/apps/editing-a-github-apps-permissions.md b/translations/zh-CN/content/developers/apps/editing-a-github-apps-permissions.md index 81fff7a88b35..9f78fd1466b3 100644 --- a/translations/zh-CN/content/developers/apps/editing-a-github-apps-permissions.md +++ b/translations/zh-CN/content/developers/apps/editing-a-github-apps-permissions.md @@ -18,15 +18,9 @@ versions: {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.github_apps %} -4. Select the GitHub App whose permissions you want to change. -![App selection](/assets/images/github-apps/github_apps_select-app.png) -5. In the left sidebar, click **Permissions & webhooks**. -![Permissions and webhooks](/assets/images/github-apps/github_apps_permissions_and_webhooks.png) -6. Modify the permissions you'd like to change. For each type of permission, select either "Read-only", "Read & write", or "No access" from the dropdown. -![Permissions selections for your GitHub App](/assets/images/github-apps/github_apps_permissions_post2dot13.png) -7. In "Subscribe to events", select any events to which you'd like to subscribe your app. -![Permissions selections for subscribing your GitHub App to events](/assets/images/github-apps/github_apps_permissions_subscribe_to_events.png) -8. Optionally, in "Add a note to users", add a note telling your users why you are changing the permissions that your GitHub App requests. -![Input box to add a note to users explaining why your GitHub App permissions have changed](/assets/images/github-apps/github_apps_permissions_note_to_users.png) -9. Click **Save changes**. -![Button to save permissions changes](/assets/images/github-apps/github_apps_save_changes.png) +4. Select the GitHub App whose permissions you want to change. ![App selection](/assets/images/github-apps/github_apps_select-app.png) +5. In the left sidebar, click **Permissions & webhooks**. ![Permissions and webhooks](/assets/images/github-apps/github_apps_permissions_and_webhooks.png) +6. Modify the permissions you'd like to change. For each type of permission, select either "Read-only", "Read & write", or "No access" from the dropdown. ![Permissions selections for your GitHub App](/assets/images/github-apps/github_apps_permissions_post2dot13.png) +7. In "Subscribe to events", select any events to which you'd like to subscribe your app. ![Permissions selections for subscribing your GitHub App to events](/assets/images/github-apps/github_apps_permissions_subscribe_to_events.png) +8. Optionally, in "Add a note to users", add a note telling your users why you are changing the permissions that your GitHub App requests. ![Input box to add a note to users explaining why your GitHub App permissions have changed](/assets/images/github-apps/github_apps_permissions_note_to_users.png) +9. 单击 **Save changes（保存更改）**。 ![Button to save permissions changes](/assets/images/github-apps/github_apps_save_changes.png) diff --git a/translations/zh-CN/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md b/translations/zh-CN/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md index 58d59bfadba9..95d7ec2ffca2 100644 --- a/translations/zh-CN/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md +++ b/translations/zh-CN/content/developers/apps/identifying-and-authorizing-users-for-github-apps.md @@ -25,30 +25,30 @@ To authorize users for standard apps that run in the browser, use the [web appli To authorize users for headless apps without direct access to the browser, such as CLI tools or Git credential managers, use the [device flow](#device-flow). The device flow uses the OAuth 2.0 [Device Authorization Grant](https://tools.ietf.org/html/rfc8628). {% endif %} -### Web 应用程序流程 +### Web application flow Using the web application flow, the process to identify users on your site is: -1. 用户被重定向，以请求他们的 GitHub 身份 -2. 用户被 GitHub 重定向回您的站点 +1. Users are redirected to request their GitHub identity +2. Users are redirected back to your site by GitHub 3. Your GitHub App accesses the API with the user's access token If you select **Request user authorization (OAuth) during installation** when creating or modifying your app, step 1 will be completed during app installation. For more information, see "[Authorizing users during installation](/apps/installing-github-apps/#authorizing-users-during-installation)." -#### 1. 请求用户的 GitHub 身份 +#### 1. Request a user's GitHub identity GET {% data variables.product.oauth_host_code %}/login/oauth/authorize -当您的 GitHub 应用程序指定 `login` 参数后，它将提示拥有特定账户的用户可以用来登录和授权您的应用程序。 +When your GitHub App specifies a `login` parameter, it prompts users with a specific account they can use for signing in and authorizing your app. -##### 参数 +##### Parameters -| 名称 | 类型 | 描述 | -| -------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `client_id` | `字符串` | **Required.** The client ID for your GitHub App. You can find this in your [GitHub App settings](https://github.com/settings/apps) when you select your app. | -| `redirect_uri` | `字符串` | 用户获得授权后被发送到的应用程序中的 URL。 This must be an exact match to the URL you provided in the **User authorization callback URL** field when setting up your GitHub App and can't contain any additional parameters. | -| `state` | `字符串` | This should contain a random string to protect against forgery attacks and could contain any other arbitrary data. | -| `login` | `字符串` | 提供用于登录和授权应用程序的特定账户。 | +Name | Type | Description +-----|------|------------ +`client_id` | `string` | **Required.** The client ID for your GitHub App. You can find this in your [GitHub App settings](https://github.com/settings/apps) when you select your app. +`redirect_uri` | `string` | The URL in your application where users will be sent after authorization. This must be an exact match to the URL you provided in the **User authorization callback URL** field when setting up your GitHub App and can't contain any additional parameters. +`state` | `string` | This should contain a random string to protect against forgery attacks and could contain any other arbitrary data. +`login` | `string` | Suggests a specific account to use for signing in and authorizing the app. {% note %} @@ -56,7 +56,7 @@ If you select **Request user authorization (OAuth) during installation** when cr {% endnote %} -#### 2. 用户被 GitHub 重定向回您的站点 +#### 2. Users are redirected back to your site by GitHub If the user accepts your request, GitHub redirects back to your site with a temporary `code` in a code parameter as well as the state you provided in the previous step in a `state` parameter. If the states don't match, the request was created by a third party and the process should be aborted. @@ -72,17 +72,17 @@ Expiring user tokens are currently part of the user-to-server token expiration b POST {% data variables.product.oauth_host_code %}/login/oauth/access_token -##### 参数 +##### Parameters -| 名称 | 类型 | 描述 | -| --------------- | ----- | ----------------------------------------------------- | -| `client_id` | `字符串` | **Required.** The client ID for your GitHub App. | -| `client_secret` | `字符串` | **Required.** The client secret for your GitHub App. | -| `代码` | `字符串` | **必填。**您收到的响应第 1 步的代码。 | -| `redirect_uri` | `字符串` | 用户获得授权后被发送到的应用程序中的 URL。 | -| `state` | `字符串` | 您在第 1 步提供的不可猜测的随机字符串。 | +Name | Type | Description +-----|------|------------ +`client_id` | `string` | **Required.** The client ID for your GitHub App. +`client_secret` | `string` | **Required.** The client secret for your GitHub App. +`code` | `string` | **Required.** The code you received as a response to Step 1. +`redirect_uri` | `string` | The URL in your application where users are sent after authorization. +`state` | `string` | The unguessable random string you provided in Step 1. -##### 响应 +##### Response {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} @@ -100,7 +100,7 @@ By default, the response takes the following form. The response parameters `expi ``` {% else %} -默认情况下，响应采用以下形式： +By default, the response takes the following form: access_token=e72e16c7e42f292c6912e7710c838347ae178b4a&token_type=bearer @@ -113,7 +113,7 @@ The user's access token allows the GitHub App to make requests to the API on beh Authorization: token OAUTH-TOKEN GET {% data variables.product.api_url_code %}/user -例如，您可以像以下这样在 curl 中设置“授权”标头： +For example, in curl you can set the Authorization header like this: ```shell curl -H "Authorization: token OAUTH-TOKEN" {% data variables.product.api_url_pre %}/user @@ -208,7 +208,7 @@ While most of your API interaction should occur using your server-to-server inst {% endif %} {% if currentVersion == "free-pro-team@latest" %} -##### 构件 +##### Artifacts * [List artifacts for a repository](/v3/actions/artifacts/#list-artifacts-for-a-repository) * [List workflow run artifacts](/v3/actions/artifacts/#list-workflow-run-artifacts) @@ -217,7 +217,7 @@ While most of your API interaction should occur using your server-to-server inst * [Download an artifact](/v3/actions/artifacts/#download-an-artifact) {% endif %} -##### 检查运行 +##### Check Runs * [Create a check run](/v3/checks/runs/#create-a-check-run) * [Get a check run](/v3/checks/runs/#get-a-check-run) @@ -226,7 +226,7 @@ While most of your API interaction should occur using your server-to-server inst * [List check runs in a check suite](/v3/checks/runs/#list-check-runs-in-a-check-suite) * [List check runs for a Git reference](/v3/checks/runs/#list-check-runs-for-a-git-reference) -##### 检查套件 +##### Check Suites * [Create a check suite](/v3/checks/suites/#create-a-check-suite) * [Get a check suite](/v3/checks/suites/#get-a-check-suite) @@ -241,25 +241,25 @@ While most of your API interaction should occur using your server-to-server inst ##### Deployment Statuses -* [List deployment statuses](/v3/repos/deployments/#list-deployment-statuses) -* [Create a deployment status](/v3/repos/deployments/#create-a-deployment-status) -* [Get a deployment status](/v3/repos/deployments/#get-a-deployment-status) +* [List deployment statuses](/rest/reference/repos#list-deployment-statuses) +* [Create a deployment status](/rest/reference/repos#create-a-deployment-status) +* [Get a deployment status](/rest/reference/repos#get-a-deployment-status) -##### 部署 +##### Deployments -* [List deployments](/v3/repos/deployments/#list-deployments) -* [Create a deployment](/v3/repos/deployments/#create-a-deployment) -* [Get a deployment](/v3/repos/deployments/#get-a-deployment){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -* [Delete a deployment](/v3/repos/deployments/#delete-a-deployment){% endif %} +* [List deployments](/rest/reference/repos#list-deployments) +* [Create a deployment](/rest/reference/repos#create-a-deployment) +* [Get a deployment](/rest/reference/repos#get-a-deployment){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +* [Delete a deployment](/rest/reference/repos#delete-a-deployment){% endif %} -##### 事件 +##### Events -* [List public events for a network of repositories](/v3/activity/events/#list-public-events-for-a-network-of-repositories) -* [List public organization events](/v3/activity/events/#list-public-organization-events) +* [List public events for a network of repositories](/rest/reference/activity#list-public-events-for-a-network-of-repositories) +* [List public organization events](/rest/reference/activity#list-public-organization-events) -##### 馈送 +##### Feeds -* [Get feeds](/v3/activity/feeds/#get-feeds) +* [Get feeds](/rest/reference/activity#get-feeds) ##### Git Blobs @@ -273,11 +273,8 @@ While most of your API interaction should occur using your server-to-server inst ##### Git Refs -* [Create a reference](/v3/git/refs/#create-a-reference){% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -* [List references](/v3/git/refs/#list-references) -* [Get a reference](/v3/git/refs/#get-a-reference){% else %} -* [Get a reference](/v3/git/refs/#get-a-reference) -* [List matching references](/v3/git/refs/#list-matching-references){% endif %} +* [Create a reference](/v3/git/refs/#create-a-reference)* [Get a reference](/v3/git/refs/#get-a-reference) +* [List matching references](/v3/git/refs/#list-matching-references) * [Update a reference](/v3/git/refs/#update-a-reference) * [Delete a reference](/v3/git/refs/#delete-a-reference) @@ -296,7 +293,7 @@ While most of your API interaction should occur using your server-to-server inst * [Get all gitignore templates](/v3/gitignore/#get-all-gitignore-templates) * [Get a gitignore template](/v3/gitignore/#get-a-gitignore-template) -##### 安装设施 +##### Installations * [List repositories accessible to the user access token](/v3/apps/installations/#list-repositories-accessible-to-the-user-access-token) @@ -333,13 +330,13 @@ While most of your API interaction should occur using your server-to-server inst * [List timeline events for an issue](/v3/issues/timeline/#list-timeline-events-for-an-issue) -##### 议题 +##### Issues * [List issues assigned to the authenticated user](/v3/issues/#list-issues-assigned-to-the-authenticated-user) * [List assignees](/v3/issues/assignees/#list-assignees) * [Check if a user can be assigned](/v3/issues/assignees/#check-if-a-user-can-be-assigned) * [List repository issues](/v3/issues/#list-repository-issues) -* [创建议题](/v3/issues/#create-an-issue) +* [Create an issue](/v3/issues/#create-an-issue) * [Get an issue](/v3/issues/#get-an-issue) * [Update an issue](/v3/issues/#update-an-issue) * [Lock an issue](/v3/issues/#lock-an-issue) @@ -353,7 +350,7 @@ While most of your API interaction should occur using your server-to-server inst * [List jobs for a workflow run](/v3/actions/workflow-jobs/#list-jobs-for-a-workflow-run) {% endif %} -##### 标签 +##### Labels * [List labels for an issue](/v3/issues/labels/#list-labels-for-an-issue) * [Add labels to an issue](/v3/issues/labels/#add-labels-to-an-issue) @@ -367,7 +364,7 @@ While most of your API interaction should occur using your server-to-server inst * [Delete a label](/v3/issues/labels/#delete-a-label) * [Get labels for every issue in a milestone](/v3/issues/labels/#list-labels-for-issues-in-a-milestone) -##### 许可 +##### Licenses * [Get all commonly used licenses](/v3/licenses/#get-all-commonly-used-licenses) * [Get a license](/v3/licenses/#get-a-license) @@ -377,11 +374,11 @@ While most of your API interaction should occur using your server-to-server inst * [Render a Markdown document](/v3/markdown/#render-a-markdown-document) * [Render a markdown document in raw mode](/v3/markdown/#render-a-markdown-document-in-raw-mode) -##### 元数据 +##### Meta -* [元数据](/v3/meta/#meta) +* [Meta](/v3/meta/#meta) -##### 里程碑 +##### Milestones * [List milestones](/v3/issues/milestones/#list-milestones) * [Create a milestone](/v3/issues/milestones/#create-a-milestone) @@ -391,12 +388,12 @@ While most of your API interaction should occur using your server-to-server inst ##### Organization Hooks -* [List organization webhooks](/v3/orgs/hooks/#list-organization-webhooks) -* [Create an organization webhook](/v3/orgs/hooks/#create-an-organization-webhook) -* [Get an organization webhook](/v3/orgs/hooks/#get-an-organization-webhook) -* [Update an organization webhook](/v3/orgs/hooks/#update-an-organization-webhook) -* [Delete an organization webhook](/v3/orgs/hooks/#delete-an-organization-webhook) -* [Ping an organization webhook](/v3/orgs/hooks/#ping-an-organization-webhook) +* [List organization webhooks](/rest/reference/orgs#webhooks/#list-organization-webhooks) +* [Create an organization webhook](/rest/reference/orgs#webhooks/#create-an-organization-webhook) +* [Get an organization webhook](/rest/reference/orgs#webhooks/#get-an-organization-webhook) +* [Update an organization webhook](/rest/reference/orgs#webhooks/#update-an-organization-webhook) +* [Delete an organization webhook](/rest/reference/orgs#webhooks/#delete-an-organization-webhook) +* [Ping an organization webhook](/rest/reference/orgs#webhooks/#ping-an-organization-webhook) {% if currentVersion == "free-pro-team@latest" %} ##### Organization Invitations @@ -445,7 +442,7 @@ While most of your API interaction should occur using your server-to-server inst ##### Organization Team Repositories -* [列出团队仓库](/v3/teams/#list-team-repositories) +* [List team repositories](/v3/teams/#list-team-repositories) * [Check team permissions for a repository](/v3/teams/#check-team-permissions-for-a-repository) * [Add or update team repository permissions](/v3/teams/#add-or-update-team-repository-permissions) * [Remove a repository from a team](/v3/teams/#remove-a-repository-from-a-team) @@ -478,7 +475,7 @@ While most of your API interaction should occur using your server-to-server inst * [List child teams](/v3/teams/#list-child-teams) * [List teams for the authenticated user](/v3/teams/#list-teams-for-the-authenticated-user) -##### 组织 +##### Organizations * [List organizations](/v3/orgs/#list-organizations) * [Get an organization](/v3/orgs/#get-an-organization) @@ -527,7 +524,7 @@ While most of your API interaction should occur using your server-to-server inst * [Remove project collaborator](/v3/projects/collaborators/#remove-project-collaborator) * [Get project permission for a user](/v3/projects/collaborators/#get-project-permission-for-a-user) -##### 项目 +##### Projects * [List organization projects](/v3/projects/#list-organization-projects) * [Create an organization project](/v3/projects/#create-an-organization-project) @@ -577,7 +574,7 @@ While most of your API interaction should occur using your server-to-server inst * [Update a review for a pull request](/v3/pulls/reviews/#update-a-review-for-a-pull-request) * [List comments for a pull request review](/v3/pulls/reviews/#list-comments-for-a-pull-request-review) -##### 拉取 +##### Pulls * [List pull requests](/v3/pulls/#list-pull-requests) * [Create a pull request](/v3/pulls/#create-a-pull-request) @@ -588,7 +585,7 @@ While most of your API interaction should occur using your server-to-server inst * [Check if a pull request has been merged](/v3/pulls/#check-if-a-pull-request-has-been-merged) * [Merge a pull request (Merge Button)](/v3/pulls/#merge-a-pull-request) -##### 反应 +##### Reactions {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}* [Delete a reaction](/v3/reactions/#delete-a-reaction-legacy){% else %}* [Delete a reaction](/v3/reactions/#delete-a-reaction){% endif %} * [List reactions for a commit comment](/v3/reactions/#list-reactions-for-a-commit-comment) @@ -610,16 +607,16 @@ While most of your API interaction should occur using your server-to-server inst * [Delete team discussion reaction](/v3/reactions/#delete-team-discussion-reaction) * [Delete team discussion comment reaction](/v3/reactions/#delete-team-discussion-comment-reaction){% endif %} -##### 仓库 +##### Repositories -* [列出组织仓库](/v3/repos/#list-organization-repositories) +* [List organization repositories](/v3/repos/#list-organization-repositories) * [Create a repository for the authenticated user](/v3/repos/#create-a-repository-for-the-authenticated-user) -* [获取仓库](/v3/repos/#get-a-repository) +* [Get a repository](/v3/repos/#get-a-repository) * [Update a repository](/v3/repos/#update-a-repository) * [Delete a repository](/v3/repos/#delete-a-repository) * [Compare two commits](/v3/repos/commits/#compare-two-commits) * [List repository contributors](/v3/repos/#list-repository-contributors) -* [列出复刻](/v3/repos/forks/#list-forks) +* [List forks](/rest/reference/repos#list-forks) * [Create a fork](/v3/repos/forks/#create-a-fork) * [List repository languages](/v3/repos/#list-repository-languages) * [List repository tags](/v3/repos/#list-repository-tags) @@ -627,18 +624,18 @@ While most of your API interaction should occur using your server-to-server inst * [Transfer a repository](/v3/repos/#transfer-a-repository) * [List public repositories](/v3/repos/#list-public-repositories) * [List repositories for the authenticated user](/v3/repos/#list-repositories-for-the-authenticated-user) -* [列出用户的仓库](/v3/repos/#list-repositories-for-a-user) +* [List repositories for a user](/v3/repos/#list-repositories-for-a-user) * [Create repository using a repository template](/v3/repos/#create-repository-using-a-repository-template) ##### Repository Activity -* [List stargazers](/v3/activity/starring/#list-stargazers) -* [List watchers](/v3/activity/watching/#list-watchers) -* [List repositories starred by a user](/v3/activity/starring/#list-repositories-starred-by-a-user) -* [Check if a repository is starred by the authenticated user](/v3/activity/starring/#check-if-a-repository-is-starred-by-the-authenticated-user) -* [Star a repository for the authenticated user](/v3/activity/starring/#star-a-repository-for-the-authenticated-user) -* [Unstar a repository for the authenticated user](/v3/activity/starring/#unstar-a-repository-for-the-authenticated-user) -* [列出用户关注的仓库](/v3/activity/watching/#list-repositories-watched-by-a-user) +* [List stargazers](/rest/reference/activity#list-stargazers) +* [List watchers](/rest/reference/activity#list-watchers) +* [List repositories starred by a user](/rest/reference/activity#list-repositories-starred-by-a-user) +* [Check if a repository is starred by the authenticated user](/rest/reference/activity#check-if-a-repository-is-starred-by-the-authenticated-user) +* [Star a repository for the authenticated user](/rest/reference/activity#star-a-repository-for-the-authenticated-user) +* [Unstar a repository for the authenticated user](/rest/reference/activity#unstar-a-repository-for-the-authenticated-user) +* [List repositories watched by a user](/rest/reference/activity#list-repositories-watched-by-a-user) {% if currentVersion == "free-pro-team@latest" %} ##### Repository Automated Security Fixes @@ -756,14 +753,14 @@ While most of your API interaction should occur using your server-to-server inst ##### Repository Pages -* [Get a GitHub Pages site](/v3/repos/pages/#get-a-github-pages-site) -* [Create a GitHub Pages site](/v3/repos/pages/#create-a-github-pages-site) -* [Update information about a GitHub Pages site](/v3/repos/pages/#update-information-about-a-github-pages-site) -* [Delete a GitHub Pages site](/v3/repos/pages/#delete-a-github-pages-site) -* [List GitHub Pages builds](/v3/repos/pages/#list-github-pages-builds) -* [Request a GitHub Pages build](/v3/repos/pages/#request-a-github-pages-build) -* [Get GitHub Pages build](/v3/repos/pages/#get-github-pages-build) -* [Get latest pages build](/v3/repos/pages/#get-latest-pages-build) +* [Get a GitHub Pages site](/rest/reference/repos#get-a-github-pages-site) +* [Create a GitHub Pages site](/rest/reference/repos#create-a-github-pages-site) +* [Update information about a GitHub Pages site](/rest/reference/repos#update-information-about-a-github-pages-site) +* [Delete a GitHub Pages site](/rest/reference/repos#delete-a-github-pages-site) +* [List GitHub Pages builds](/rest/reference/repos#list-github-pages-builds) +* [Request a GitHub Pages build](/rest/reference/repos#request-a-github-pages-build) +* [Get GitHub Pages build](/rest/reference/repos#get-github-pages-build) +* [Get latest pages build](/rest/reference/repos#get-latest-pages-build) {% if currentVersion != "free-pro-team@latest" %} ##### Repository Pre Receive Hooks @@ -776,17 +773,17 @@ While most of your API interaction should occur using your server-to-server inst ##### Repository Releases -* [列出发行版](/v3/repos/releases/#list-releases) -* [Create a release](/v3/repos/releases/#create-a-release) -* [Get a release](/v3/repos/releases/#get-a-release) -* [更新发行版](/v3/repos/releases/#update-a-release) -* [Delete a release](/v3/repos/releases/#delete-a-release) -* [List release assets](/v3/repos/releases/#list-release-assets) -* [Get a release asset](/v3/repos/releases/#get-a-release-asset) -* [Update a release asset](/v3/repos/releases/#update-a-release-asset) -* [Delete a release asset](/v3/repos/releases/#delete-a-release-asset) -* [Get the latest release](/v3/repos/releases/#get-the-latest-release) -* [Get a release by tag name](/v3/repos/releases/#get-a-release-by-tag-name) +* [List releases](/rest/reference/repos/#list-releases) +* [Create a release](/rest/reference/repos/#create-a-release) +* [Get a release](/rest/reference/repos/#get-a-release) +* [Update a release](/rest/reference/repos/#update-a-release) +* [Delete a release](/rest/reference/repos/#delete-a-release) +* [List release assets](/rest/reference/repos/#list-release-assets) +* [Get a release asset](/rest/reference/repos/#get-a-release-asset) +* [Update a release asset](/rest/reference/repos/#update-a-release-asset) +* [Delete a release asset](/rest/reference/repos/#delete-a-release-asset) +* [Get the latest release](/rest/reference/repos/#get-the-latest-release) +* [Get a release by tag name](/rest/reference/repos/#get-a-release-by-tag-name) ##### Repository Stats @@ -797,28 +794,28 @@ While most of your API interaction should occur using your server-to-server inst * [Get the hourly commit count for each day](/v3/repos/statistics/#get-the-hourly-commit-count-for-each-day) {% if currentVersion == "free-pro-team@latest" %} -##### 仓库漏洞警报 +##### Repository Vulnerability Alerts * [Enable vulnerability alerts](/v3/repos/#enable-vulnerability-alerts) * [Disable vulnerability alerts](/v3/repos/#disable-vulnerability-alerts) {% endif %} -##### 根 +##### Root -* [根端点](/v3/#root-endpoint) -* [表情符号](/v3/emojis/#emojis) +* [Root endpoint](/v3/#root-endpoint) +* [Emojis](/v3/emojis/#emojis) * [Get rate limit status for the authenticated user](/v3/rate_limit/#get-rate-limit-status-for-the-authenticated-user) -##### 搜索 +##### Search * [Search code](/v3/search/#search-code) * [Search commits](/v3/search/#search-commits) * [Search labels](/v3/search/#search-labels) -* [搜索仓库](/v3/search/#search-repositories) +* [Search repositories](/v3/search/#search-repositories) * [Search topics](/v3/search/#search-topics) * [Search users](/v3/search/#search-users) -##### 状态 +##### Statuses * [Get the combined status for a specific reference](/v3/repos/statuses/#get-the-combined-status-for-a-specific-reference) * [List commit statuses for a reference](/v3/repos/statuses/#list-commit-statuses-for-a-reference) @@ -837,13 +834,13 @@ While most of your API interaction should occur using your server-to-server inst * [Update a discussion comment](/v3/teams/discussion_comments/#update-a-discussion-comment) * [Delete a discussion comment](/v3/teams/discussion_comments/#delete-a-discussion-comment) -##### 主题 +##### Topics * [Get all repository topics](/v3/repos#get-all-repository-topics) * [Replace all repository topics](/v3/repos/#replace-all-repository-topics) {% if currentVersion == "free-pro-team@latest" %} -##### 流量 +##### Traffic * [Get repository clones](/v3/repos/traffic/#get-repository-clones) * [Get top referral paths](/v3/repos/traffic/#get-top-referral-paths) @@ -899,7 +896,7 @@ While most of your API interaction should occur using your server-to-server inst * [Delete a public SSH key for the authenticated user](/v3/users/keys/#delete-a-public-ssh-key-for-the-authenticated-user) * [List public keys for a user](/v3/users/keys/#list-public-keys-for-a-user) -##### 用户 +##### Users * [Get the authenticated user](/v3/users/#get-the-authenticated-user) * [List app installations accessible to the user access token](/v3/apps/installations/#list-app-installations-accessible-to-the-user-access-token) @@ -923,7 +920,7 @@ While most of your API interaction should occur using your server-to-server inst {% endif %} {% if currentVersion == "free-pro-team@latest" %} -##### 工作流程 +##### Workflows * [List repository workflows](/v3/actions/workflows/#list-repository-workflows) * [Get a workflow](/v3/actions/workflows/#get-a-workflow) diff --git a/translations/zh-CN/content/developers/apps/migrating-oauth-apps-to-github-apps.md b/translations/zh-CN/content/developers/apps/migrating-oauth-apps-to-github-apps.md index 95cc7b31738d..677df33ce6e1 100644 --- a/translations/zh-CN/content/developers/apps/migrating-oauth-apps-to-github-apps.md +++ b/translations/zh-CN/content/developers/apps/migrating-oauth-apps-to-github-apps.md @@ -11,7 +11,6 @@ versions: This article provides guidelines for existing integrators who are considering migrating from an OAuth App to a GitHub App. - ### Reasons for switching to GitHub Apps [GitHub Apps](/apps/) are the officially recommended way to integrate with GitHub because they offer many advantages over a pure OAuth-based integration: diff --git a/translations/zh-CN/content/developers/apps/modifying-an-oauth-app.md b/translations/zh-CN/content/developers/apps/modifying-an-oauth-app.md index 869475ce85bd..3e45db618208 100644 --- a/translations/zh-CN/content/developers/apps/modifying-an-oauth-app.md +++ b/translations/zh-CN/content/developers/apps/modifying-an-oauth-app.md @@ -9,12 +9,10 @@ versions: enterprise-server: '*' --- - - - {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.oauth_apps %} {% data reusables.user-settings.modify_oauth_app %} -5. Modify the {% data variables.product.prodname_oauth_app %} information that you'd like to change. +1. Modify the +{% data variables.product.prodname_oauth_app %} information that you'd like to change. {% data reusables.user-settings.update_oauth_app %} diff --git a/translations/zh-CN/content/developers/apps/refreshing-user-to-server-access-tokens.md b/translations/zh-CN/content/developers/apps/refreshing-user-to-server-access-tokens.md index 61beac48a729..181479ef09ca 100644 --- a/translations/zh-CN/content/developers/apps/refreshing-user-to-server-access-tokens.md +++ b/translations/zh-CN/content/developers/apps/refreshing-user-to-server-access-tokens.md @@ -28,10 +28,10 @@ This callback request will send you a new access token and a new refresh token. #### 参数 -| 名称 | 类型 | 描述 | -| --------------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 名称 | 类型 | 描述 | +| --------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `refresh_token` | `字符串` | **Required.** The token generated when the {% data variables.product.prodname_github_app %} owner enables expiring tokens and issues a new user access token. | -| `grant_type` | `字符串` | **Required.** Value must be `refresh_token` (required by the OAuth specification). | +| `grant_type` | `字符串` | **Required.** Value must be `refresh_token` (required by the OAuth specification). | | `client_id` | `字符串` | **Required.** The client ID for your {% data variables.product.prodname_github_app %}. | | `client_secret` | `字符串` | **Required.** The client secret for your {% data variables.product.prodname_github_app %}. | diff --git a/translations/zh-CN/content/developers/apps/scopes-for-oauth-apps.md b/translations/zh-CN/content/developers/apps/scopes-for-oauth-apps.md index a1981337213c..ff5b4dc33152 100644 --- a/translations/zh-CN/content/developers/apps/scopes-for-oauth-apps.md +++ b/translations/zh-CN/content/developers/apps/scopes-for-oauth-apps.md @@ -36,46 +36,47 @@ X-Accepted-OAuth-Scopes: user ### Available scopes -| 名称 | 描述 | -| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| **`(no scope)`** | Grants read-only access to public information (includes public user profile info, public repository info, and gists){% if currentVersion != "free-pro-team@latest" %} -| **`site_admin`** | Grants site administrators access to [{% data variables.product.prodname_ghe_server %} Administration API endpoints](/v3/enterprise-admin).{% endif %} -| **`repo`** | Grants full access to private and public repositories. That includes read/write access to code, commit statuses, repository and organization projects, invitations, collaborators, adding team memberships, deployment statuses, and repository webhooks for public and private repositories and organizations. Also grants ability to manage user projects. | -|  `repo:status` | Grants read/write access to public and private repository commit statuses. This scope is only necessary to grant other users or services access to private repository commit statuses *without* granting access to the code. | -|  `repo_deployment` | Grants access to [deployment statuses](/v3/repos/deployments) for public and private repositories. This scope is only necessary to grant other users or services access to deployment statuses, *without* granting access to the code. | -|  `public_repo` | Limits access to public repositories. That includes read/write access to code, commit statuses, repository projects, collaborators, and deployment statuses for public repositories and organizations. Also required for starring public repositories. | -|  `repo:invite` | Grants accept/decline abilities for invitations to collaborate on a repository. Grants accept/decline abilities for invitations to collaborate on a repository. This scope is only necessary to grant other users or services access to invites *without* granting access to the code.{% if currentVersion == "free-pro-team@latest" %} -|  `security_events` | Grants read and write access to security events in the [{% data variables.product.prodname_code_scanning %} API](/v3/code-scanning).{% endif %} -| **`admin:repo_hook`** | Grants read, write, ping, and delete access to repository hooks in public and private repositories. The `repo` and `public_repo` scopes grants full access to repositories, including repository hooks. Use the `admin:repo_hook` scope to limit access to only repository hooks. | -|  `write:repo_hook` | Grants read, write, and ping access to hooks in public or private repositories. | -|  `read:repo_hook` | Grants read and ping access to hooks in public or private repositories. | -| **`admin:org`** | Fully manage the organization and its teams, projects, and memberships. | -|  `write:org` | Read and write access to organization membership, organization projects, and team membership. | -|  `read:org` | Read-only access to organization membership, organization projects, and team membership. | -| **`admin:public_key`** | Fully manage public keys. | -|  `write:public_key` | Create, list, and view details for public keys. | -|  `read:public_key` | List and view details for public keys. | -| **`admin:org_hook`** | Grants read, write, ping, and delete access to organization hooks. **Note:** OAuth tokens will only be able to perform these actions on organization hooks which were created by the OAuth App. Personal access tokens will only be able to perform these actions on organization hooks created by a user. | -| **`gist`** | Grants write access to gists. | -| **`通知`** | Grants:
    * read access to a user's notifications
    * mark as read access to threads
    * watch and unwatch access to a repository, and
    * read, write, and delete access to thread subscriptions. | -| **`用户`** | Grants read/write access to profile info only. Note that this scope includes `user:email` and `user:follow`. | -|  `read:user` | Grants access to read a user's profile data. | -|  `user:email` | Grants read access to a user's email addresses. | -|  `user:follow` | Grants access to follow or unfollow other users. | -| **`delete_repo`** | Grants access to delete adminable repositories. | -| **`write:discussion`** | Allows read and write access for team discussions. | -|  `read:discussion` | Allows read access for team discussions.{% if currentVersion == "free-pro-team@latest" %} -| **`write:packages`** | Grants access to upload or publish a package in {% data variables.product.prodname_registry %}. For more information, see "[Publishing a package](/github/managing-packages-with-github-packages/publishing-a-package)". | -| **`read:packages`** | Grants access to download or install packages from {% data variables.product.prodname_registry %}. For more information, see "[Installing a package](/github/managing-packages-with-github-packages/installing-a-package)". | -| **`delete:packages`** | Grants access to delete packages from {% data variables.product.prodname_registry %}. For more information, see "[Deleting packages](/github/managing-packages-with-github-packages/deleting-a-package)".{% endif %} -| **`admin:gpg_key`** | Fully manage GPG keys. | -|  `write:gpg_key` | Create, list, and view details for GPG keys. | -|  `read:gpg_key` | List and view details for GPG keys.{% if currentVersion == "free-pro-team@latest" %} -| **`工作流程`** | Grants the ability to add and update {% data variables.product.prodname_actions %} workflow files. Workflow files can be committed without this scope if the same file (with both the same path and contents) exists on another branch in the same repository.{% endif %} +Name | Description +-----|-----------| +**`(no scope)`** | Grants read-only access to public information (includes public user profile info, public repository info, and gists){% if currentVersion != "free-pro-team@latest" %} +**`site_admin`** | Grants site administrators access to [{% data variables.product.prodname_ghe_server %} Administration API endpoints](/v3/enterprise-admin).{% endif %} +**`repo`** | Grants full access to private and public repositories. That includes read/write access to code, commit statuses, repository and organization projects, invitations, collaborators, adding team memberships, deployment statuses, and repository webhooks for public and private repositories and organizations. Also grants ability to manage user projects. + `repo:status`| Grants read/write access to public and private repository commit statuses. This scope is only necessary to grant other users or services access to private repository commit statuses *without* granting access to the code. + `repo_deployment`| Grants access to [deployment statuses](/v3/repos/deployments) for public and private repositories. This scope is only necessary to grant other users or services access to deployment statuses, *without* granting access to the code. + `public_repo`| Limits access to public repositories. That includes read/write access to code, commit statuses, repository projects, collaborators, and deployment statuses for public repositories and organizations. Also required for starring public repositories. + `repo:invite` | Grants accept/decline abilities for invitations to collaborate on a repository. This scope is only necessary to grant other users or services access to invites *without* granting access to the code.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21"%} + `security_events` | Grants read and write access to security events in the [{% data variables.product.prodname_code_scanning %} API](/v3/code-scanning).{% endif %} +**`admin:repo_hook`** | Grants read, write, ping, and delete access to repository hooks in public and private repositories. The `repo` and `public_repo` scopes grants full access to repositories, including repository hooks. Use the `admin:repo_hook` scope to limit access to only repository hooks. + `write:repo_hook` | Grants read, write, and ping access to hooks in public or private repositories. + `read:repo_hook`| Grants read and ping access to hooks in public or private repositories. +**`admin:org`** | Fully manage the organization and its teams, projects, and memberships. + `write:org`| Read and write access to organization membership, organization projects, and team membership. + `read:org`| Read-only access to organization membership, organization projects, and team membership. +**`admin:public_key`** | Fully manage public keys. + `write:public_key`| Create, list, and view details for public keys. + `read:public_key`| List and view details for public keys. +**`admin:org_hook`** | Grants read, write, ping, and delete access to organization hooks. **Note:** OAuth tokens will only be able to perform these actions on organization hooks which were created by the OAuth App. Personal access tokens will only be able to perform these actions on organization hooks created by a user. +**`gist`** | Grants write access to gists. +**`notifications`** | Grants:
    * read access to a user's notifications
    * mark as read access to threads
    * watch and unwatch access to a repository, and
    * read, write, and delete access to thread subscriptions. +**`user`** | Grants read/write access to profile info only. Note that this scope includes `user:email` and `user:follow`. + `read:user`| Grants access to read a user's profile data. + `user:email`| Grants read access to a user's email addresses. + `user:follow`| Grants access to follow or unfollow other users. +**`delete_repo`** | Grants access to delete adminable repositories. +**`write:discussion`** | Allows read and write access for team discussions. + `read:discussion` | Allows read access for team discussions.{% if currentVersion == "free-pro-team@latest" %} +**`write:packages`** | Grants access to upload or publish a package in {% data variables.product.prodname_registry %}. For more information, see "[Publishing a package](/github/managing-packages-with-github-packages/publishing-a-package)". +**`read:packages`** | Grants access to download or install packages from {% data variables.product.prodname_registry %}. For more information, see "[Installing a package](/github/managing-packages-with-github-packages/installing-a-package)". +**`delete:packages`** | Grants access to delete packages from {% data variables.product.prodname_registry %}. For more information, see "[Deleting packages](/github/managing-packages-with-github-packages/deleting-a-package)".{% endif %} +**`admin:gpg_key`** | Fully manage GPG keys. + `write:gpg_key`| Create, list, and view details for GPG keys. + `read:gpg_key`| List and view details for GPG keys.{% if currentVersion == "free-pro-team@latest" %} +**`workflow`** | Grants the ability to add and update {% data variables.product.prodname_actions %} workflow files. Workflow files can be committed without this scope if the same file (with both the same path and contents) exists on another branch in the same repository.{% endif %} {% note %} -**Note:** Your OAuth App can request the scopes in the initial redirection. You can specify multiple scopes by separating them with a space: +**Note:** Your OAuth App can request the scopes in the initial redirection. You +can specify multiple scopes by separating them with a space: https://github.com/login/oauth/authorize? client_id=...& @@ -85,14 +86,29 @@ X-Accepted-OAuth-Scopes: user ### Requested scopes and granted scopes -The `scope` attribute lists scopes attached to the token that were granted by the user. Normally, these scopes will be identical to what you requested. However, users can edit their scopes, effectively granting your application less access than you originally requested. Also, users can edit token scopes after the OAuth flow is completed. You should be aware of this possibility and adjust your application's behavior accordingly. +The `scope` attribute lists scopes attached to the token that were granted by +the user. Normally, these scopes will be identical to what you requested. +However, users can edit their scopes, effectively +granting your application less access than you originally requested. Also, users +can edit token scopes after the OAuth flow is completed. +You should be aware of this possibility and adjust your application's behavior +accordingly. -It's important to handle error cases where a user chooses to grant you less access than you originally requested. For example, applications can warn or otherwise communicate with their users that they will see reduced functionality or be unable to perform some actions. +It's important to handle error cases where a user chooses to grant you +less access than you originally requested. For example, applications can warn +or otherwise communicate with their users that they will see reduced +functionality or be unable to perform some actions. -Also, applications can always send users back through the flow again to get additional permission, but don’t forget that users can always say no. +Also, applications can always send users back through the flow again to get +additional permission, but don’t forget that users can always say no. -Check out the [Basics of Authentication guide](/guides/basics-of-authentication/), which provides tips on handling modifiable token scopes. +Check out the [Basics of Authentication guide](/guides/basics-of-authentication/), which +provides tips on handling modifiable token scopes. ### Normalized scopes -When requesting multiple scopes, the token is saved with a normalized list of scopes, discarding those that are implicitly included by another requested scope. For example, requesting `user,gist,user:email` will result in a token with `user` and `gist` scopes only since the access granted with `user:email` scope is included in the `user` scope. +When requesting multiple scopes, the token is saved with a normalized list +of scopes, discarding those that are implicitly included by another requested +scope. For example, requesting `user,gist,user:email` will result in a +token with `user` and `gist` scopes only since the access granted with +`user:email` scope is included in the `user` scope. diff --git a/translations/zh-CN/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md b/translations/zh-CN/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md index 0593dc1c9f91..cbfe14f6197c 100644 --- a/translations/zh-CN/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md +++ b/translations/zh-CN/content/developers/apps/setting-up-your-development-environment-to-create-a-github-app.md @@ -9,7 +9,6 @@ versions: --- - ### 简介 This guide will walk through the steps needed to configure a GitHub App and run it on a server. GitHub Apps require some setup steps to manage webhook events and connect the app registration on GitHub to your code. The app in this guide serves as a foundation that you can use to extend and build new GitHub Apps. diff --git a/translations/zh-CN/content/developers/apps/suspending-a-github-app-installation.md b/translations/zh-CN/content/developers/apps/suspending-a-github-app-installation.md index 30af3656038b..ca8e90949250 100644 --- a/translations/zh-CN/content/developers/apps/suspending-a-github-app-installation.md +++ b/translations/zh-CN/content/developers/apps/suspending-a-github-app-installation.md @@ -10,20 +10,22 @@ versions: {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} {% note %} -**注意：** {% data reusables.pre-release-program.suspend-installation-beta %} +**注：**{% data reusables.pre-release-program.suspend-installation-beta %} {% endnote %} {% endif %} ### Suspending a GitHub App -To suspend a {% data variables.product.prodname_github_app %}, you must be an account owner or have admin permissions in the repository or organization where the app you want to suspend is installed. +The integrator who owns and maintains a GitHub app, also called a GitHub App owner, can suspend or unsuspend a GitHub App installation using REST API endpoints with a JWT. For more information, see the [GitHub Apps REST API](/rest/reference/apps). -You can also suspend and unsuspend {% data variables.product.prodname_github_app %} installations using the REST API. For more information, see the [GitHub Apps REST API](/v3/apps/). +People who have installed a GitHub App, also called installation owners, can only suspend or unsuspend a GitHub App through their app's installation settings. Installation owners cannot use the API to suspend or unsuspend their app installation. Before people can suspend a GitHub app installation, the GitHub App owner must opt-in to the beta release. 更多信息请参阅“[挂起 GitHub 应用程序安装](/apps/managing-github-apps/suspending-a-github-app-installation/)”。 {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.github_apps %} -4. Select the {% data variables.product.prodname_github_app %} you want to suspend. ![App selection](/assets/images/github-apps/github_apps_select-app.png) +4. Select the +{% data variables.product.prodname_github_app %} you want to suspend. +![App selection](/assets/images/github-apps/github_apps_select-app.png) {% data reusables.user-settings.github_apps_advanced %} 6. Next to the suspension settings for the installation, click **Suspend** or **Unsuspend**. ![Suspend a GitHub App](/assets/images/github-apps/suspend-a-github-app.png) diff --git a/translations/zh-CN/content/developers/apps/using-the-github-api-in-your-app.md b/translations/zh-CN/content/developers/apps/using-the-github-api-in-your-app.md index 8c4a410a2ce0..50a7acfc2a0b 100644 --- a/translations/zh-CN/content/developers/apps/using-the-github-api-in-your-app.md +++ b/translations/zh-CN/content/developers/apps/using-the-github-api-in-your-app.md @@ -10,7 +10,6 @@ versions: --- - ### 简介 This guide will help you build a GitHub App and run it on a server. The app you build will add a label to all new issues opened in the repository where the app is installed. diff --git a/translations/zh-CN/content/developers/github-marketplace/drafting-a-listing-for-your-app.md b/translations/zh-CN/content/developers/github-marketplace/drafting-a-listing-for-your-app.md index 0da8b2f8d741..7bc6b6e54221 100644 --- a/translations/zh-CN/content/developers/github-marketplace/drafting-a-listing-for-your-app.md +++ b/translations/zh-CN/content/developers/github-marketplace/drafting-a-listing-for-your-app.md @@ -40,7 +40,10 @@ To create a {% data variables.product.prodname_marketplace %} listing: ![App type selection](/assets/images/settings/apps_choose_app.png) -4. Select the app you'd like to add to {% data variables.product.prodname_marketplace %}. ![App selection for {% data variables.product.prodname_marketplace %} listing](/assets/images/github-apps/github_apps_select-app.png) +4. Select the app you'd like to add to + +{% data variables.product.prodname_marketplace %}. +![App selection for {% data variables.product.prodname_marketplace %} listing](/assets/images/github-apps/github_apps_select-app.png) {% data reusables.user-settings.edit_marketplace_listing %} 5. Once you've created a new draft listing, you'll see an overview of the sections that you'll need to visit before your {% data variables.product.prodname_marketplace %} listing will be complete. ![GitHub Marketplace listing](/assets/images/marketplace/marketplace_listing_overview.png) diff --git a/translations/zh-CN/content/developers/github-marketplace/viewing-metrics-for-your-listing.md b/translations/zh-CN/content/developers/github-marketplace/viewing-metrics-for-your-listing.md index fe55776d9baa..045237bda979 100644 --- a/translations/zh-CN/content/developers/github-marketplace/viewing-metrics-for-your-listing.md +++ b/translations/zh-CN/content/developers/github-marketplace/viewing-metrics-for-your-listing.md @@ -47,7 +47,8 @@ To access {% data variables.product.prodname_marketplace %} Insights: {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.marketplace_apps %} -4. Select the {% data variables.product.prodname_github_app %} that you'd like to view Insights for. +4. Select the +{% data variables.product.prodname_github_app %} that you'd like to view Insights for. {% data reusables.user-settings.edit_marketplace_listing %} 6. Click the **Insights** tab. 7. Optionally, select a different time period by clicking the Period dropdown in the upper-right corner of the Insights page. ![Marketplace time period](/assets/images/marketplace/marketplace_insights_time_period.png) diff --git a/translations/zh-CN/content/developers/github-marketplace/viewing-transactions-for-your-listing.md b/translations/zh-CN/content/developers/github-marketplace/viewing-transactions-for-your-listing.md index 5f87adff43f0..15ede21ee304 100644 --- a/translations/zh-CN/content/developers/github-marketplace/viewing-transactions-for-your-listing.md +++ b/translations/zh-CN/content/developers/github-marketplace/viewing-transactions-for-your-listing.md @@ -39,7 +39,8 @@ To access {% data variables.product.prodname_marketplace %} transactions: {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.marketplace_apps %} -4. Select the {% data variables.product.prodname_github_app %} that you'd like to view transactions for. +4. Select the +{% data variables.product.prodname_github_app %} that you'd like to view transactions for. {% data reusables.user-settings.edit_marketplace_listing %} 6. Click the **Transactions** tab. 7. Optionally, select a different time period by clicking the Period dropdown in the upper-right corner of the Transactions page. ![Marketplace time period](/assets/images/marketplace/marketplace_insights_time_period.png) diff --git a/translations/zh-CN/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md b/translations/zh-CN/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md index c805fe30ca85..8aba97ad0af3 100644 --- a/translations/zh-CN/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md +++ b/translations/zh-CN/content/developers/github-marketplace/webhook-events-for-the-github-marketplace-api.md @@ -27,18 +27,18 @@ Web 挂钩 `POST` 请求具有特殊标头。 有关详细信息，请参阅“[ | `action` | `字符串` | 为生成 web 挂钩而执行的操作。 可以是 `purchased`、`cancelled`、`pending_change`、`pending_change_cancelled` 或 `changed`。 更多信息请参阅下面的 web 挂钩有效负载示例。 **注：**`pending_change` 和 `pending_change_cancelled` 有效负载包含与 [`changed` 有效负载示例](#example-webhook-payload-for-a-changed-event)中所示键相同的键。 | | `effective_date` | `字符串` | `action` 开始生效的日期。 | | `sender` | `对象` | 执行 `action` 触发 web 挂钩的人。 | -| `marketplace_purchase` | `对象` | {% data variables.product.prodname_marketplace %} 购买信息。 | +| `marketplace_purchase` | `对象` | {% data variables.product.prodname_marketplace %} 购买信息。 | `marketplace_purchase` 对象含有以下键： | 键 | 类型 | 描述 | | -------------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `帐户` | `对象` | 与订阅关联的 `organization` 或 `user` 帐户。 组织帐户将包含 `Organization_billing_email`, 这是组织的行政电子邮件地址。 要查找个人帐户的电子邮件地址，您可以使用[获取经过身份验证的用户](/v3/users/#get-the-authenticated-user)端点。 | -| `billing_cycle` | `字符串` | 可以是 `yearly` 或 `monthly`。 如果 `account` 所有者拥有免费 GitHub 计划并且购买了免费 {% data variables.product.prodname_marketplace %} 计划，则 `billing_cycle` 将为 `nil`。 | +| `billing_cycle` | `字符串` | 可以是 `yearly` 或 `monthly`。 如果 `account` 所有者拥有免费 GitHub 计划并且购买了免费 {% data variables.product.prodname_marketplace %} 计划，则 `billing_cycle` 将为 `nil`。 | | `unit_count` | `整数` | 购买的单位数。 | | `on_free_trial` | `布尔值` | 当 `account` 处于免费试用期时，该值为 `true`。 | | `free_trial_ends_on` | `字符串` | 免费试用到期日期。 | -| `next_billing_date` | `字符串` | 下一个结算周期开始日期。 如果 `account` 所有者拥有免费 GitHub.com 计划并且购买了免费 {% data variables.product.prodname_marketplace %} 计划，则 `next_billing_date` 将为 `nil`。 | +| `next_billing_date` | `字符串` | 下一个结算周期开始日期。 如果 `account` 所有者拥有免费 GitHub.com 计划并且购买了免费 {% data variables.product.prodname_marketplace %} 计划，则 `next_billing_date` 将为 `nil`。 | | `plan` | `对象` | `user` 或 `organization` 购买的计划。 | `plan` 对象含有以下键： diff --git a/translations/zh-CN/content/developers/overview/about-githubs-apis.md b/translations/zh-CN/content/developers/overview/about-githubs-apis.md index 4d21a0f8419f..b37493136fce 100644 --- a/translations/zh-CN/content/developers/overview/about-githubs-apis.md +++ b/translations/zh-CN/content/developers/overview/about-githubs-apis.md @@ -28,7 +28,7 @@ For information on using the GraphQL API, see the [v4 docs](/v4/). ## Deprecated versions -### beta +### 测试版 We deprecated the beta API on April 22, 2014. diff --git a/translations/zh-CN/content/developers/overview/managing-deploy-keys.md b/translations/zh-CN/content/developers/overview/managing-deploy-keys.md index 1e75e5243978..439865b39808 100644 --- a/translations/zh-CN/content/developers/overview/managing-deploy-keys.md +++ b/translations/zh-CN/content/developers/overview/managing-deploy-keys.md @@ -10,7 +10,6 @@ versions: --- - You can manage SSH keys on your servers when automating deployment scripts using SSH agent forwarding, HTTPS with OAuth tokens, deploy keys, or machine users. ### SSH agent forwarding @@ -28,7 +27,7 @@ In many cases, especially in the beginning of a project, SSH agent forwarding is * Users **must** SSH in to deploy; automated deploy processes can't be used. * SSH agent forwarding can be troublesome to run for Windows users. -##### Setup +##### 设置 1. Turn on agent forwarding locally. See [our guide on SSH agent forwarding][ssh-agent-forwarding] for more information. 2. Set your deploy scripts to use agent forwarding. For example, on a bash script, enabling agent forwarding would look something like this: `ssh -A serverA 'bash -s' < deploy.sh` @@ -50,7 +49,7 @@ If you don't want to use SSH keys, you can use [HTTPS with OAuth tokens][git-aut * You must make sure that you configure your token with the correct access scopes. * Tokens are essentially passwords, and must be protected the same way. -##### Setup +##### 设置 See [our guide on Git automation with tokens][git-automation]. @@ -71,7 +70,7 @@ See [our guide on Git automation with tokens][git-automation]. * Deploy keys only grant access to a single repository. More complex projects may have many repositories to pull to the same server. * Deploy keys are usually not protected by a passphrase, making the key easily accessible if the server is compromised. -##### Setup +##### 设置 1. [Run the `ssh-keygen` procedure][generating-ssh-keys] on your server, and remember where you save the generated public/private rsa key pair. 2. In the upper-right corner of any {% data variables.product.product_name %} page, click your profile photo, then click **Your profile**. ![Navigation to profile](/assets/images/profile-page.png) @@ -111,7 +110,7 @@ This means that you cannot automate the creation of accounts. But if you want to * Only organizations can restrict machine users to read-only access. Personal repositories always grant collaborators read/write access. * Machine user keys, like deploy keys, are usually not protected by a passphrase. -##### Setup +##### 设置 1. [Run the `ssh-keygen` procedure][generating-ssh-keys] on your server and attach the public key to the machine user account. 2. Give the machine user account access to the repositories you want to automate. You can do this by adding the account as a [collaborator][collaborator], as an [outside collaborator][outside-collaborator], or to a [team][team] in an organization. diff --git a/translations/zh-CN/content/developers/overview/replacing-github-services.md b/translations/zh-CN/content/developers/overview/replacing-github-services.md index 13ea935a867a..eb1925fc9e60 100644 --- a/translations/zh-CN/content/developers/overview/replacing-github-services.md +++ b/translations/zh-CN/content/developers/overview/replacing-github-services.md @@ -19,7 +19,6 @@ As an alternative to the email service, you can now start using email notificati {% endnote %} - ### Deprecation timeline - **October 1, 2018**: GitHub discontinued allowing users to install services. We removed GitHub Services from the GitHub.com user interface. diff --git a/translations/zh-CN/content/developers/overview/using-ssh-agent-forwarding.md b/translations/zh-CN/content/developers/overview/using-ssh-agent-forwarding.md index bf7f696feeff..aa7d8c9e59e7 100644 --- a/translations/zh-CN/content/developers/overview/using-ssh-agent-forwarding.md +++ b/translations/zh-CN/content/developers/overview/using-ssh-agent-forwarding.md @@ -93,7 +93,7 @@ Sometimes, system configurations disallow SSH agent forwarding. You can check if ```shell $ ssh -v example.com # Connect to example.com with verbose debug output -> OpenSSH_5.6p1, OpenSSL 0.9.8r 8 Feb 2011 +> OpenSSH_8.1p1, LibreSSL 2.7.3 > debug1: Reading configuration data /Users/you/.ssh/config > debug1: Applying options for example.com > debug1: Reading configuration data /etc/ssh_config diff --git a/translations/zh-CN/content/developers/webhooks-and-events/about-webhooks.md b/translations/zh-CN/content/developers/webhooks-and-events/about-webhooks.md index c5fc234eba0e..64b973bcf586 100644 --- a/translations/zh-CN/content/developers/webhooks-and-events/about-webhooks.md +++ b/translations/zh-CN/content/developers/webhooks-and-events/about-webhooks.md @@ -1,5 +1,5 @@ --- -title: 关于 web 挂钩 +title: About webhooks intro: Learn the basics of how webhooks work to help you build and set up integrations. redirect_from: - /webhooks @@ -9,14 +9,13 @@ versions: --- - Webhooks allow you to build or set up integrations, such as [{% data variables.product.prodname_github_app %}s](/apps/building-github-apps/) or [{% data variables.product.prodname_oauth_app %}s](/apps/building-oauth-apps/), which subscribe to certain events on GitHub.com. When one of those events is triggered, we'll send a HTTP POST payload to the webhook's configured URL. Webhooks can be used to update an external issue tracker, trigger CI builds, update a backup mirror, or even deploy to your production server. You're only limited by your imagination. -Webhooks can be installed on{% if currentVersion != "free-pro-team@latest" %} a [{% data variables.product.prodname_ghe_server %} instance](/v3/enterprise-admin/global_webhooks/),{% endif %} an [organization][org-hooks], a specific [repository][repo-hooks], or a {% data variables.product.prodname_github_app %}. Once installed, the webhook will be sent each time one or more subscribed events occurs. +Webhooks can be installed on{% if currentVersion != "free-pro-team@latest" %} a [{% data variables.product.prodname_ghe_server %} instance](/rest/reference/enterprise-admin#global-webhooks/),{% endif %} an [organization][org-hooks], a specific [repository][repo-hooks], or a {% data variables.product.prodname_github_app %}. Once installed, the webhook will be sent each time one or more subscribed events occurs. You can create up to {% if currentVersion != "free-pro-team@latest" %}250{% else %}20{% endif %} webhooks for each event on each installation target {% if currentVersion != "free-pro-team@latest" %}({% data variables.product.prodname_ghe_server %} instance, specific organization, or specific repository).{% else %}(specific organization or specific repository).{% endif %} -### 事件 +### Events {% data reusables.webhooks.webhooks_intro %} @@ -30,5 +29,5 @@ See "[Webhook event payloads](/webhooks/event-payloads)" for the list of availab For more information about the `ping` event webhook payload, see the [`ping`](/webhooks/event-payloads/#ping) event. -[org-hooks]: /v3/orgs/hooks/ +[org-hooks]: /rest/reference/orgs#webhooks/ [repo-hooks]: /v3/repos/hooks/ diff --git a/translations/zh-CN/content/developers/webhooks-and-events/github-event-types.md b/translations/zh-CN/content/developers/webhooks-and-events/github-event-types.md index 4519fcac7c45..de220b69222b 100644 --- a/translations/zh-CN/content/developers/webhooks-and-events/github-event-types.md +++ b/translations/zh-CN/content/developers/webhooks-and-events/github-event-types.md @@ -16,7 +16,6 @@ The Events API can return different types of events triggered by activity on Git {% endif %} - ### Event object common properties The event objects returned from the Events API endpoints have the same structure. @@ -203,7 +202,7 @@ This event returns an empty `payload` object. | `push_id` | `整数` | Unique identifier for the push. | | `size` | `整数` | The number of commits in the push. | | `distinct_size` | `整数` | The number of distinct commits in the push. | -| `ref` | `字符串` | 被推送的完整 [`git ref`](/v3/git/refs/)。 例如：`refs/heads/master`。 | +| `ref` | `字符串` | 被推送的完整 [`git ref`](/v3/git/refs/)。 Example: `refs/heads/main`. | | `头部` | `字符串` | 推送之后在 `ref` 上最近提交的 SHA。 | | `before` | `字符串` | 推送之前在 `ref` 上最近提交的 SHA。 | | `commits` | `数组` | 描述所推送提交的提交对象数组。 （该数组最多包含 20 个提交。 如有必要，可使用 [Commits API](/v3/repos/commits/) 获取更多提交。 此限制仅适用于时间表事件，而不适用于 web 挂钩递送。） | diff --git a/translations/zh-CN/content/developers/webhooks-and-events/issue-event-types.md b/translations/zh-CN/content/developers/webhooks-and-events/issue-event-types.md index b07114ce0c35..c1156e9d0d60 100644 --- a/translations/zh-CN/content/developers/webhooks-and-events/issue-event-types.md +++ b/translations/zh-CN/content/developers/webhooks-and-events/issue-event-types.md @@ -11,7 +11,6 @@ versions: Issue events are triggered by activity in issues and pull requests and are available in the [Issue Events API](/v3/issues/events) and the [Timeline Events API](/v3/issues/timeline). Each event type specifies whether the event is available in the Issue Events or Timeline Events APIs. - GitHub's REST API considers every pull request to be an issue, but not every issue is a pull request. For this reason, the Issue Events and Timeline Events endpoints may return both issues and pull requests in the response. Pull requests have a `pull_request` property in the `issue` object. Because pull requests are issues, issue and pull request numbers do not overlap in a repository. For example, if you open your first issue in a repository, the number will be 1. If you then open a pull request, the number will be 2. Each event type specifies if the event occurs in pull request, issues, or both. ### Issue event object common properties diff --git a/translations/zh-CN/content/developers/webhooks-and-events/securing-your-webhooks.md b/translations/zh-CN/content/developers/webhooks-and-events/securing-your-webhooks.md index 7f135f37bdae..0a5ed843591b 100644 --- a/translations/zh-CN/content/developers/webhooks-and-events/securing-your-webhooks.md +++ b/translations/zh-CN/content/developers/webhooks-and-events/securing-your-webhooks.md @@ -33,9 +33,17 @@ $ export SECRET_TOKEN=your_token ### Validating payloads from GitHub -When your secret token is set, GitHub uses it to create a hash signature with each payload. +When your secret token is set, {% data variables.product.product_name %} uses it to create a hash signature with each payload. This hash signature is included with the headers of each request as {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %}`X-Hub-Signature-256`{% else if currentVersion ver_lt "enterprise-server@2.23" %}`X-Hub-Signature`{% endif %}. -This hash signature is passed along with each request in the headers as `X-Hub-Signature`. Suppose you have a basic server listening to webhooks that looks like this: +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %} +{% note %} + +**Note:** For backward-compatibility, we also include the `X-Hub-Signature` header that is generated using the SHA-1 hash function. If possible, we recommend that you use the `X-Hub-Signature-256` header for improved security. The example below demonstrate using the `X-Hub-Signature-256` header. + +{% endnote %} +{% endif %} + +For example, if you have a basic server that listens for webhooks, it might be configured similar to this: ``` ruby require 'sinatra' @@ -47,7 +55,7 @@ post '/payload' do end ``` -The goal is to compute a hash using your `SECRET_TOKEN`, and ensure that the hash from GitHub matches. GitHub uses an HMAC hexdigest to compute the hash, so you could change your server to look a little like this: +The intention is to calculate a hash using your `SECRET_TOKEN`, and ensure that the result matches the hash from {% data variables.product.product_name %}. {% data variables.product.product_name %} uses an HMAC hex digest to compute the hash, so you could reconfigure your server to look a little like this: ``` ruby post '/payload' do @@ -58,16 +66,21 @@ post '/payload' do "I got some JSON: #{push.inspect}" end +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %} +def verify_signature(payload_body) + signature = 'sha256=' + OpenSSL::HMAC.hexdigest(OpenSSL::Digest.new('sha256'), ENV['SECRET_TOKEN'], payload_body) + return halt 500, "Signatures didn't match!" unless Rack::Utils.secure_compare(signature, request.env['HTTP_X_HUB_SIGNATURE_2']) +end{% else if currentVersion ver_lt "enterprise-server@2.23" %} def verify_signature(payload_body) signature = 'sha1=' + OpenSSL::HMAC.hexdigest(OpenSSL::Digest.new('sha1'), ENV['SECRET_TOKEN'], payload_body) return halt 500, "Signatures didn't match!" unless Rack::Utils.secure_compare(signature, request.env['HTTP_X_HUB_SIGNATURE']) -end +end{% endif %} ``` -Obviously, your language and server implementations may differ than this code. There are a couple of very important things to point out, however: +Your language and server implementations may differ from this example code. However, there are a number of very important things to point out: -* No matter which implementation you use, the hash signature starts with `sha1=`, using the key of your secret token and your payload body. +* No matter which implementation you use, the hash signature starts with {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or "private-instances@latest" %}`sha256=`{% else if currentVersion ver_lt "enterprise-server@2.23" %}`sha1=`{% endif %}, using the key of your secret token and your payload body. -* Using a plain `==` operator is **not advised**. A method like [`secure_compare`][secure_compare] performs a "constant time" string comparison, which renders it safe from certain timing attacks against regular equality operators. +* Using a plain `==` operator is **not advised**. A method like [`secure_compare`][secure_compare] performs a "constant time" string comparison, which helps mitigate certain timing attacks against regular equality operators. [secure_compare]: http://rubydoc.info/github/rack/rack/master/Rack/Utils.secure_compare diff --git a/translations/zh-CN/content/developers/webhooks-and-events/testing-webhooks.md b/translations/zh-CN/content/developers/webhooks-and-events/testing-webhooks.md index 470f8613035c..82c62d3e5130 100644 --- a/translations/zh-CN/content/developers/webhooks-and-events/testing-webhooks.md +++ b/translations/zh-CN/content/developers/webhooks-and-events/testing-webhooks.md @@ -9,7 +9,6 @@ versions: --- - Now that you've [configured your local server](/webhooks/configuring/), you might be interested in pushing your code to the limits. To that end, GitHub's webhooks view provides some tooling for testing your deployed payloads. ### Listing recent deliveries diff --git a/translations/zh-CN/content/developers/webhooks-and-events/webhook-events-and-payloads.md b/translations/zh-CN/content/developers/webhooks-and-events/webhook-events-and-payloads.md index fe5723524276..5908a354da66 100644 --- a/translations/zh-CN/content/developers/webhooks-and-events/webhook-events-and-payloads.md +++ b/translations/zh-CN/content/developers/webhooks-and-events/webhook-events-and-payloads.md @@ -20,7 +20,6 @@ versions: 您可以创建订阅此页所列事件的 web 挂钩。 每个 web 挂钩事件都包括 web 挂钩属性的说明和示例有效负载。 更多信息请参阅“[创建 web 挂钩](/webhooks/creating/)”。 - ### Web 挂钩有效负载对象共有属性 每个 web 挂钩事件有效负载还包含特定于事件的属性。 您可以在各个事件类型部分中找到这些独特属性。 @@ -28,11 +27,8 @@ versions: | 键 | 类型 | 描述 | | -------- | ----- | -------------------------------------------- | | `action` | `字符串` | 大多数 web 挂钩有效负载都包括 `action` 属性，其中包含触发事件的特定活动。 | - {% data reusables.webhooks.sender_desc %} 此属性包含在每个 web 挂钩有效负载中。 -{% data reusables.webhooks.repo_desc %} 当事件发生源于仓库中的活动时，web 挂钩有效负载包含 - -`repository` 属性。 +{% data reusables.webhooks.repo_desc %} 当事件发生源于仓库中的活动时，web 挂钩有效负载包含 `repository` 属性。 {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} 更多信息请参阅“[构建 {% data variables.product.prodname_github_app %}](/apps/building-github-apps/)”。 @@ -48,13 +44,14 @@ Web 挂钩事件的独特属性与您使用 [Events API](/v3/activity/events/) 递送到 web 挂钩已配置 URL 端点的 HTTP POST 有效负载将包含几个特殊标头： -| 标头 | 描述 | -| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `X-GitHub-Event` | 触发递送的事件名称。 | -| `X-GitHub-Delivery` | 用于标识递送的 [GUID](http://en.wikipedia.org/wiki/Globally_unique_identifier)。{% if currentVersion != "free-pro-team@latest" %} -| `X-GitHub-Enterprise-Version` | 发送 HTTP POST 有效负载的 {% data variables.product.prodname_ghe_server %} 实例的版本。 | -| `X-GitHub-Enterprise-Host` | 发送 HTTP POST 有效负载的 {% data variables.product.prodname_ghe_server %} 实例的主机名。{% endif %} -| `X-Hub-Signature` | 响应正文的 HMAC 十六进制摘要。 如果使用 [`secret`](/v3/repos/hooks/#create-hook-config-params) 配置了 web 挂钩，则将发送此标头。 HMAC 十六进制摘要是使用 `sha1` 哈希函数和作为 HMAC `key` 的 `secret` 生成的。 | +| 标头 | 描述 | +| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `X-GitHub-Event` | 触发递送的事件名称。 | +| `X-GitHub-Delivery` | A [GUID](http://en.wikipedia.org/wiki/Globally_unique_identifier) to identify the delivery.{% if currentVersion != "free-pro-team@latest" %} +| `X-GitHub-Enterprise-Version` | 发送 HTTP POST 有效负载的 {% data variables.product.prodname_ghe_server %} 实例的版本。 | +| `X-GitHub-Enterprise-Host` | The hostname of the {% data variables.product.prodname_ghe_server %} instance that sent the HTTP POST payload.{% endif %}{% if currentVersion != "private-instances@latest" %} +| `X-Hub-Signature` | This header is sent if the webhook is configured with a [`secret`](/v3/repos/hooks/#create-hook-config-params). This is the HMAC hex digest of the request body, and is generated using the SHA-1 hash function and the `secret` as the HMAC `key`.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} `X-Hub-Signature` is provided for compatibility with existing integrations, and we recommend that you use the more secure `X-Hub-Signature-256` instead.{% endif %}{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %} +| `X-Hub-Signature-256` | This header is sent if the webhook is configured with a [`secret`](/v3/repos/hooks/#create-hook-config-params). This is the HMAC hex digest of the request body, and is generated using the SHA-256 hash function and the `secret` as the HMAC `key`.{% endif %} 此外，请求的 `User-Agent` 将含有前缀 `GitHub-Hookshot/`。 @@ -66,8 +63,9 @@ Web 挂钩事件的独特属性与您使用 [Events API](/v3/activity/events/) > Host: localhost:4567 > X-GitHub-Delivery: 72d3162e-cc78-11e3-81ab-4c9367dc0958{% if currentVersion != "free-pro-team@latest" %} > X-GitHub-Enterprise-Version: 2.15.0 -> X-GitHub-Enterprise-Host: example.com{% endif %} -> X-Hub-Signature: sha1=7d38cdd689735b008b3c702edd92eea23791c5f6 +> X-GitHub-Enterprise-Host: example.com{% endif %}{% if currentVersion != "private-instances@latest" %} +> X-Hub-Signature: sha1=7d38cdd689735b008b3c702edd92eea23791c5f6{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "private-instances@latest" %} +> X-Hub-Signature-256: sha256=d57c68ca6f92289e6987922ff26938930f6e66a2d161ef06abdf1859230aa23c{% endif %} > User-Agent: GitHub-Hookshot/044aadd > Content-Type: application/json > Content-Length: 6615 @@ -292,10 +290,10 @@ Web 挂钩事件是基于您注册的域的特异性而触发的。 例如，如 #### Web 挂钩有效负载对象 -| 键 | 类型 | 描述 | -| ------------ | --------------------------------------------------------------- | ---------------------------------------------- |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -| `action` | `字符串` | 执行的操作。 可以是 `created`。{% endif %} -| `deployment` | `对象` | [部署](/v3/repos/deployments/#list-deployments)。 | +| 键 | 类型 | 描述 | +| ------------ | --------------------------------------------------------------------------------------------------- | --------------------------------------------- |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +| `action` | `字符串` | 执行的操作。 可以是 `created`。{% endif %} +| `deployment` | `对象` | [部署](/rest/reference/repos#list-deployments)。 | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} @@ -317,14 +315,14 @@ Web 挂钩事件是基于您注册的域的特异性而触发的。 例如，如 #### Web 挂钩有效负载对象 -| 键 | 类型 | 描述 | -| ---------------------------------- | --------------------------------------------------------------- | -------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -| `action` | `字符串` | 执行的操作。 可以是 `created`。{% endif %} -| `deployment_status` | `对象` | [部署状态](/v3/repos/deployments/#list-deployment-statuses)。 | -| `deployment_status["state"]` | `字符串` | 新状态。 可以是 `pending`、`success`、`failure` 或 `error`。 | -| `deployment_status["target_url"]` | `字符串` | 添加到状态的可选链接。 | -| `deployment_status["description"]` | `字符串` | 添加到状态的可选人类可读说明。 | -| `deployment` | `对象` | 此状态关联的[部署](/v3/repos/deployments/#list-deployments)。 | +| 键 | 类型 | 描述 | +| ---------------------------------- | --------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +| `action` | `字符串` | 执行的操作。 可以是 `created`。{% endif %} +| `deployment_status` | `对象` | [部署状态](/rest/reference/repos#list-deployment-statuses)。 | +| `deployment_status["state"]` | `字符串` | 新状态。 可以是 `pending`、`success`、`failure` 或 `error`。 | +| `deployment_status["target_url"]` | `字符串` | 添加到状态的可选链接。 | +| `deployment_status["description"]` | `字符串` | 添加到状态的可选人类可读说明。 | +| `deployment` | `对象` | 此状态关联的[部署](/rest/reference/repos#list-deployments)。 | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} @@ -336,13 +334,13 @@ Web 挂钩事件是基于您注册的域的特异性而触发的。 例如，如 {% if currentVersion != "free-pro-team@latest" %} -### enterprise +### 企业 {% data reusables.webhooks.enterprise_short_desc %} #### 可用性 -- GitHub Enterprise web 挂钩。 更多信息请参阅“[全局 web 挂钩](/v3/enterprise-admin/global_webhooks/)”。 +- GitHub Enterprise web 挂钩。 更多信息请参阅“[全局 web 挂钩](/rest/reference/enterprise-admin#global-webhooks/)”。 #### Web 挂钩有效负载对象 @@ -670,17 +668,17 @@ Web 挂钩事件是基于您注册的域的特异性而触发的。 例如，如 #### 可用性 {% if currentVersion != "free-pro-team@latest" %} -- GitHub Enterprise web 挂钩只接收 `created` 和 `deleted` 事件。 更多信息请参阅“[全局 web 挂钩](/v3/enterprise-admin/global_webhooks/)”。{% endif %} +- GitHub Enterprise web 挂钩只接收 `created` 和 `deleted` 事件。 更多信息请参阅“[全局 web 挂钩](/rest/reference/enterprise-admin#global-webhooks/)”。{% endif %} - 组织 web 挂钩只接收 `deleted`、`added`、`removed`、`renamed` 和 `invited` 事件 - 具有 `members` 权限的 {% data variables.product.prodname_github_app %} #### Web 挂钩有效负载对象 -| 键 | 类型 | 描述 | -| ------------ | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------ | -| `action` | `字符串` | 执行的操作内容. 可以是以下选项之一：{% if currentVersion != "free-pro-team@latest" %}`created`、{% endif %}`deleted`、`renamed`、`member_added`、`member_removed` 或 `member_invited`。 | -| `邀请` | `对象` | 对用户的邀请或电子邮件邀请（如果操作为 `member_invited`）。 | -| `membership` | `对象` | 用户和组织之间的成员资格。 当操作为 `member_invited` 时不存在。 | +| 键 | 类型 | 描述 | +| ------------ | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `action` | `字符串` | 执行的操作内容. Can be one of:{% if currentVersion != "free-pro-team@latest" %} `created`,{% endif %} `deleted`, `renamed`, `member_added`, `member_removed`, or `member_invited`. | +| `邀请` | `对象` | 对用户的邀请或电子邮件邀请（如果操作为 `member_invited`）。 | +| `membership` | `对象` | 用户和组织之间的成员资格。 当操作为 `member_invited` 时不存在。 | {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} @@ -747,10 +745,10 @@ Web 挂钩事件是基于您注册的域的特异性而触发的。 例如，如 #### Web 挂钩有效负载对象 -| 键 | 类型 | 描述 | -| ---- | ---- | --------------------------------------------------------------------------------- | -| `id` | `整数` | 页面构建的唯一标识符。 | -| `构建` | `对象` | The [List GitHub Pages builds](/v3/repos/pages/#list-github-pages-builds) itself. | +| 键 | 类型 | 描述 | +| ---- | ---- | -------------------------------------------------------------------------------------- | +| `id` | `整数` | 页面构建的唯一标识符。 | +| `构建` | `对象` | The [List GitHub Pages builds](/rest/reference/repos#list-github-pages-builds) itself. | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} @@ -772,11 +770,11 @@ Web 挂钩事件是基于您注册的域的特异性而触发的。 例如，如 #### Web 挂钩有效负载对象 -| 键 | 类型 | 描述 | -| -------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `zen` | `字符串` | GitHub zen 的随机字符串。 | -| `hook_id` | `整数` | 触发 ping 的 web 挂钩的 ID。 | -| `挂钩` | `对象` | [web 挂钩配置](/v3/repos/hooks/#get-a-repository-webhook)。 | +| 键 | 类型 | 描述 | +| -------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `zen` | `字符串` | GitHub zen 的随机字符串。 | +| `hook_id` | `整数` | 触发 ping 的 web 挂钩的 ID。 | +| `挂钩` | `对象` | [web 挂钩配置](/v3/repos/hooks/#get-a-repository-webhook)。 | | `hook[app_id]` | `整数` | 注册新的 {% data variables.product.prodname_github_app %} 时，{% data variables.product.product_name %} 将 ping 事件发送到您在注册过程中指定的 **web 挂钩 URL**。 该事件包含 `app_id`，这是[验证](/apps/building-integrations/setting-up-and-registering-github-apps/about-authentication-options-for-github-apps/)应用程序的必需项。 | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} @@ -972,7 +970,7 @@ Web 挂钩事件是基于您注册的域的特异性而触发的。 例如，如 | 键 | 类型 | 描述 | | -------------------------- | ----- | ----------------------------------------------------------------------------------------------------------------- | -| `ref` | `字符串` | 被推送的完整 [`git ref`](/v3/git/refs/)。 例如：`refs/heads/master`。 | +| `ref` | `字符串` | 被推送的完整 [`git ref`](/v3/git/refs/)。 Example: `refs/heads/main`. | | `before` | `字符串` | 推送之前在 `ref` 上最近提交的 SHA。 | | `after` | `字符串` | 推送之后在 `ref` 上最近提交的 SHA。 | | `commits` | `数组` | 描述所推送提交的提交对象数组。 （该数组最多包含 20 个提交。 如有必要，可使用 [Commits API](/v3/repos/commits/) 获取更多提交。 此限制仅适用于时间表事件，而不适用于 web 挂钩递送。） | @@ -1044,7 +1042,7 @@ Web 挂钩事件是基于您注册的域的特异性而触发的。 例如，如 | 键 | 类型 | 描述 | | -------- | ----- | -------------------------------------------- | -| `action` | `字符串` | 执行的操作内容. 可以是以下选项之一：
    • `created` - 创建了仓库。
    • `deleted` - 仓库被删除。 此事件类型仅适用于[组织挂钩](/v3/orgs/hooks/)
    • `archived` - 仓库被存档。
    • `unarchived` - 仓库被取消存档。
      • {% if currentVersion != "free-pro-team@latest" %}
    • `anonymous_access_enabled` - 仓库被[启用匿名 Git 访问](/v3/previews/#anonymous-git-access-to-repositories)，`anonymous_access_disabled` - 仓库被[禁用匿名 Git 访问](/v3/previews/#anonymous-git-access-to-repositories)
      • {% endif %}
    • `edited` - 仓库的信息被编辑。
    • `renamed` - 仓库被重命名。
    • `transferred` - 仓库被转让。
    • `publicized` - 仓库被设为公共。
    • `privatized` - 仓库被设为私有。
    | +| `action` | `字符串` | 执行的操作内容. 可以是以下选项之一：
    • `created` - 创建了仓库。
    • `deleted` - 仓库被删除。 This event type is only available to [organization hooks](/rest/reference/orgs#webhooks/)
    • `archived` - 仓库被存档。
    • `unarchived` - 仓库被取消存档。
      • {% if currentVersion != "free-pro-team@latest" %}
    • `anonymous_access_enabled` - 仓库被[启用匿名 Git 访问](/v3/previews/#anonymous-git-access-to-repositories)，`anonymous_access_disabled` - 仓库被[禁用匿名 Git 访问](/v3/previews/#anonymous-git-access-to-repositories)
      • {% endif %}
    • `edited` - 仓库的信息被编辑。
    • `renamed` - 仓库被重命名。
    • `transferred` - 仓库被转让。
    • `publicized` - 仓库被设为公共。
    • `privatized` - 仓库被设为私有。
    | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} @@ -1253,7 +1251,7 @@ Web 挂钩事件是基于您注册的域的特异性而触发的。 例如，如 当用户被 `created` 或 `deleted` 时。 #### 可用性 -- GitHub Enterprise web 挂钩。 更多信息请参阅“[全局 web 挂钩](/v3/enterprise-admin/global_webhooks/)”。 +- GitHub Enterprise web 挂钩。 更多信息请参阅“[全局 web 挂钩](/rest/reference/enterprise-admin#global-webhooks/)”。 #### Web 挂钩有效负载示例 @@ -1299,7 +1297,6 @@ This event occurs when someone triggers a workflow run on GitHub or sends a `POS {{ webhookPayloadsForCurrentVersion.workflow_dispatch }} {% endif %} - ### workflow_run When a {% data variables.product.prodname_actions %} workflow run is requested or completed. 更多信息请参阅“[触发工作流程的事件](/actions/reference/events-that-trigger-workflows#workflow_run)”。 diff --git a/translations/zh-CN/content/github/administering-a-repository/about-branch-restrictions.md b/translations/zh-CN/content/github/administering-a-repository/about-branch-restrictions.md index 0077e9147528..cf02042e7990 100644 --- a/translations/zh-CN/content/github/administering-a-repository/about-branch-restrictions.md +++ b/translations/zh-CN/content/github/administering-a-repository/about-branch-restrictions.md @@ -1,6 +1,6 @@ --- title: 关于分支限制 -intro: '属于组织的仓库内的分支可配置为只允许特定用户{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %}或{% endif %}团队{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}或应用{% endif %}推送到该分支。' +intro: 'Branches within repositories that belong to organizations can be configured so that only certain users{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %} or{% endif %} teams{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, or apps{% endif %} can push to the branch.' product: '{% data reusables.gated-features.branch-restrictions %}' redirect_from: - /articles/about-branch-restrictions @@ -9,15 +9,15 @@ versions: enterprise-server: '*' --- -在启用分支限制后，只有被授予权限的用户{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %}或{% endif %}团队{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}或应用{% endif %}才可推送到受保护分支。 在启用分支限制后，只有被授予权限的用户{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %}或{% endif %}团队{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}或应用{% endif %}才可推送到受保护分支。 您可以在受保护分支的设置中查看和编辑对该受保护分支具有推送权限的用户{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %}或{% endif %}团队{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}或应用{% endif %}。 +When you enable branch restrictions, only users, teams, or apps that have been given permission can push to the protected branch. 在启用分支限制后，只有被授予权限的用户{% if page.version == "dotcom" or page.version ver_gt "2.18" %},{% else %}或{% endif %}团队{% if page.version == "dotcom" or page.version ver_gt "2.18" %}或应用{% endif %}才可推送到受保护分支。 You can view and edit the users, teams, or apps with push access to a protected branch in the protected branch's settings. -您只能将推送到受保护分支的权限授予具有仓库`写入`权限的用户{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}、{% else %}或{% endif %}团队{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}或安装的{% data variables.product.prodname_github_apps %}{% endif %}。 +You can only give push access to a protected branch to users, teams, or installed {% data variables.product.prodname_github_apps %} with `write` access to a repository. -具有仓库管理员权限的人员{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}和应用{% endif %}始终可以推送到受保护分支。 +People and apps with admin permissions to a repository are always able to push to a protected branch. {% tip %} -**注：**如果选中“Include administrators（包括管理员）”，并且您对分支启用了必需状态检查，如有任何状态检查失败，则即使是具有管理员权限的人员{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}和应用{% endif %}，将更改推送到受保护分支的任何尝试也会失败。 更多信息请参阅“[启用必需状态检查](/articles/enabling-required-status-checks)”。 +**Note:** If "Include administrators" is selected, you've enabled required status checks on the branch, and if any status checks fail, any attempt to push changes to the protected branch will also fail, even for people and apps with admin permissions. 更多信息请参阅“[启用必需状态检查](/articles/enabling-required-status-checks)”。 {% endtip %} diff --git a/translations/zh-CN/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md b/translations/zh-CN/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md index 0c532b193fbf..05c9bdb06ba0 100644 --- a/translations/zh-CN/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md +++ b/translations/zh-CN/content/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository.md @@ -24,7 +24,7 @@ versions: - 作为提交一部分所更改的文件 - 提交消息 -您可以过滤因推送到仓库而收到的电子邮件通知。 更多信息请参阅{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}“[配置通知](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#filtering-email-notifications){% else %}”[关于通知电子邮件](/github/receiving-notifications-about-activity-on-github/about-email-notifications)”。 您还可以对推送关闭电子邮件通知。 更多信息请参阅“[选择通知的递送方式](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications){% endif %}”。 +您可以过滤因推送到仓库而收到的电子邮件通知。 For more information, see {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#filtering-email-notifications){% else %}"[About notification emails](/github/receiving-notifications-about-activity-on-github/about-email-notifications)." 您还可以对推送关闭电子邮件通知。 更多信息请参阅“[选择通知的递送方式](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications){% endif %}”。 ### 对推送到仓库启用电子邮件通知 @@ -33,8 +33,7 @@ versions: {% data reusables.repositories.sidebar-notifications %} 5. 输入最多两个您希望通知发送到的电子邮件地址，用空格分隔。 如果要将电子邮件发送到两个以上的帐户，请将其中一个电子邮件地址设为群组电子邮件地址。 ![电子邮件地址文本框](/assets/images/help/settings/email_services_addresses.png) 6. 如果您操作自己的服务器，可通过**秘密**令牌验证电子邮件的真实性。 此令牌随电子邮件作为 `Approved` 标头发送。 如果 `Approved` 标头与您发送的令牌匹配，则可以信任该电子邮件来自 {% data variables.product.product_name %}。 ![电子邮件密码文本框](/assets/images/help/settings/email_services_token.png) -7. 也可选择 **Send from author（发送自作者）**，以使用提交人的电子邮件地址发送电子邮件。 否则，电子邮件发送自 {% data variables.notifications.no_reply_address %}。 ![电子邮件作者复选框](/assets/images/help/settings/email_services_author.png) -8. 单击 **Save settings（保存设置）**。 ![Save settings 按钮](/assets/images/help/settings/save_notification_settings.png) +7. 单击 **Save settings（保存设置）**。 ![Save settings 按钮](/assets/images/help/settings/save_notification_settings.png) ### 延伸阅读 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} diff --git a/translations/zh-CN/content/github/administering-a-repository/about-github-dependabot-version-updates.md b/translations/zh-CN/content/github/administering-a-repository/about-github-dependabot-version-updates.md index 74859dd15ba8..df926ead3465 100644 --- a/translations/zh-CN/content/github/administering-a-repository/about-github-dependabot-version-updates.md +++ b/translations/zh-CN/content/github/administering-a-repository/about-github-dependabot-version-updates.md @@ -13,9 +13,11 @@ versions: {% data variables.product.prodname_dependabot %} 负责维护您的依赖项。 您可以使用它来确保仓库自动跟上它所依赖的包和应用程序的最新版本。 -通过将配置文件检入仓库，可启用 {% data variables.product.prodname_dependabot_version_updates %}。 配置文件指定存储在仓库中的清单或其他包定义文件的位置。 {% data variables.product.prodname_dependabot_short %} 使用此信息来检查过时的软件包和应用程序。 {% data variables.product.prodname_dependabot_short %} 确定依赖项是否有新版本，它通过查看依赖的语义版本 ([semver](https://semver.org/)) 来决定是否应更新该版本。 当 {% data variables.product.prodname_dependabot_short %} 发现过时的依赖项时，它会发起拉取请求以将清单更新到依赖项的最新版本。 检查测试是否通过，查看拉取请求摘要中包含的更改日志和发行说明，然后合并它。 更多信息请参阅“[启用和禁用版本更新](/github/administering-a-repository/enabling-and-disabling-version-updates)”。 +通过将配置文件检入仓库，可启用 {% data variables.product.prodname_dependabot_version_updates %}。 配置文件指定存储在仓库中的清单或其他包定义文件的位置。 {% data variables.product.prodname_dependabot_short %} 使用此信息来检查过时的软件包和应用程序。 {% data variables.product.prodname_dependabot_short %} 确定依赖项是否有新版本，它通过查看依赖的语义版本 ([semver](https://semver.org/)) 来决定是否应更新该版本。 For certain package managers, {% data variables.product.prodname_dependabot_version_updates %} also supports vendoring. Vendored (or cached) dependencies are dependencies that are checked in to a specific directory in a repository, rather than referenced in a manifest. Vendored dependencies are available at build time even if package servers are unavailable. {% data variables.product.prodname_dependabot_version_updates %} can be configured to check vendored dependencies for new versions and update them if necessary. -如果启用安全更新，{% data variables.product.prodname_dependabot %} 还会发起拉取请求以更新易受攻击依赖项。 更多信息请参阅“[配置 {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)”。 +当 {% data variables.product.prodname_dependabot_short %} 发现过时的依赖项时，它会发起拉取请求以将清单更新到依赖项的最新版本。 For vendored dependencies, {% data variables.product.prodname_dependabot_short %} raises a pull request to directly replace the outdated dependency with the new version. 检查测试是否通过，查看拉取请求摘要中包含的更改日志和发行说明，然后合并它。 更多信息请参阅“[启用和禁用版本更新](/github/administering-a-repository/enabling-and-disabling-version-updates)”。 + +如果启用安全更新，{% data variables.product.prodname_dependabot %} 还会发起拉取请求以更新易受攻击依赖项。 更多信息请参阅“[配置 {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)。” {% data reusables.dependabot.dependabot-tos %} @@ -35,7 +37,7 @@ versions: {% endnote %} -您可以为包含其中一个受支持包管理器的依赖项清单或锁定文件的仓库配置版本更新。 +您可以为包含其中一个受支持包管理器的依赖项清单或锁定文件的仓库配置版本更新。 For some package managers, you can also configure vendoring for dependencies. 更多信息请参阅“[依赖项更新的配置选项](/github/administering-a-repository/configuration-options-for-dependency-updates#vendor)。” {% data reusables.dependabot.supported-package-managers %} diff --git a/translations/zh-CN/content/github/administering-a-repository/about-protected-branches.md b/translations/zh-CN/content/github/administering-a-repository/about-protected-branches.md index c974235ddbd1..c1fb32ca1f10 100644 --- a/translations/zh-CN/content/github/administering-a-repository/about-protected-branches.md +++ b/translations/zh-CN/content/github/administering-a-repository/about-protected-branches.md @@ -1,6 +1,6 @@ --- title: 关于受保护分支 -intro: 受保护分支确保仓库的协作者无法对分支进行不可撤销的更改。 启用受保护分支也可让您启用其他可选检查和要求，例如必要的状态检查和必要的审查。 +intro: '受保护分支确保仓库的协作者无法对分支进行不可撤销的更改。 启用受保护分支也可让您启用其他可选检查和要求，例如必要的状态检查和必要的审查。' product: '{% data reusables.gated-features.protected-branches %}' redirect_from: - /articles/about-protected-branches @@ -24,7 +24,7 @@ versions: ### 分支保护设置 -在仓库中创建分支保护规则时，{% if currentVersion == "free-pro-team@latest" %} 默认情况下{% endif %}协作者无法强制推送到受保护的分支或删除分支。 您可以启用其他分支保护设置。 有关信息，请参阅“[定义拉取请求的可合并性](/github/administering-a-repository/defining-the-mergeability-of-pull-requests)”。 +When you create a branch protection rule in a repository, collaborators cannot force push to the protected branch or delete the branch{% if currentVersion == "free-pro-team@latest" %} by default{% endif %}. 您可以启用其他分支保护设置。 有关信息，请参阅“[定义拉取请求的可合并性](/github/administering-a-repository/defining-the-mergeability-of-pull-requests)”。 ### 延伸阅读 diff --git a/translations/zh-CN/content/github/administering-a-repository/about-releases.md b/translations/zh-CN/content/github/administering-a-repository/about-releases.md index 2aa53e17a1bc..7e21bb8b798d 100644 --- a/translations/zh-CN/content/github/administering-a-repository/about-releases.md +++ b/translations/zh-CN/content/github/administering-a-repository/about-releases.md @@ -1,6 +1,6 @@ --- title: 关于发行版 -intro: 您可以创建包软件的发行版，以及发行说明和二进制文件链接，以供其他人使用。 +intro: '您可以创建包软件的发行版，以及发行说明和二进制文件链接，以供其他人使用。' redirect_from: - /articles/downloading-files-from-the-command-line/ - /articles/downloading-files-with-curl/ @@ -20,18 +20,20 @@ versions: 发行版基于 [Git 标记](https://git-scm.com/book/en/Git-Basics-Tagging)，这些标记会标记仓库历史记录中的特定点。 标记日期可能与发行日期不同，因为它们可在不同的时间创建。 有关查看现有标记的更多信息，请参阅“[查看仓库的发行版和标记](/github/administering-a-repository/viewing-your-repositorys-releases-and-tags)”。 -当仓库中发布新发行版时您可以接收通知，但不会接受有关仓库其他更新的通知。 更多信息请参阅{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}“[查看您的订阅](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions){% else %}”[关注和取消关注仓库的发行版](/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-releases-for-a-repository){% endif %}”。 +当仓库中发布新发行版时您可以接收通知，但不会接受有关仓库其他更新的通知。 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 releases for a repository](/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-releases-for-a-repository){% endif %}." 对仓库具有读取访问权限的任何人都可以查看和比较发行版，但只有对仓库具有写入权限的人员才能管理发行版。 更多信息请参阅“[管理仓库中的发行版](/github/administering-a-repository/managing-releases-in-a-repository)”。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -People with admin permissions to a repository can choose whether {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in the ZIP files and tarballs that {% data variables.product.product_name %} creates for each release. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)." +People with admin permissions to a repository can choose whether +{% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in the ZIP files and tarballs that {% data variables.product.product_name %} creates for each release. 更多信息请参阅“[管理仓库存档中的 {% data variables.large_files.product_name_short %} 对象](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)”。 {% endif %} {% if currentVersion == "free-pro-team@latest" %} -If a release fixes a security vulnerability, you should publish a security advisory in your repository. {% data variables.product.prodname_dotcom %} reviews each published security advisory and may use it to send {% data variables.product.prodname_dependabot_short %} alerts to affected repositories. For more information, see "[About GitHub Security Advisories](/github/managing-security-vulnerabilities/about-github-security-advisories)." +如果发行版修复了安全漏洞，您应该在仓库中发布安全通告。 +{% data variables.product.prodname_dotcom %} 审查每个发布的安全通告，并且可能使用它向受影响的仓库发送 {% data variables.product.prodname_dependabot_short %} 警报。 更多信息请参阅“[关于 GitHub 安全通告](/github/managing-security-vulnerabilities/about-github-security-advisories)”。 -You can view the **Dependents** tab of the dependency graph to see which repositories and packages depend on code in your repository, and may therefore be affected by a new release. 更多信息请参阅“[关于依赖关系图](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)”。 +您可以查看依赖项图的 **Dependents（依赖项）**选项卡，了解哪些仓库和包依赖于您仓库中的代码，并因此可能受到新发行版的影响。 更多信息请参阅“[关于依赖关系图](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)”。 {% endif %} 您也可以使用发行版 API 来收集信息，例如人们下载发行版资产的次数。 更多信息请参阅“[发行版](/v3/repos/releases/)”。 diff --git a/translations/zh-CN/content/github/administering-a-repository/about-required-commit-signing.md b/translations/zh-CN/content/github/administering-a-repository/about-required-commit-signing.md index f58d4545a938..4f9fffe30cbd 100644 --- a/translations/zh-CN/content/github/administering-a-repository/about-required-commit-signing.md +++ b/translations/zh-CN/content/github/administering-a-repository/about-required-commit-signing.md @@ -11,9 +11,9 @@ versions: 如果您在仓库中实施了分支保护，便可设置必需提交签名。 更多信息请参阅“[配置受保护分支](/articles/configuring-protected-branches/)”。 -在分支上启用必需提交签名时，贡献者{% if currentVersion == "free-pro-team@latest" %}和自动程序{% endif %}只能将已经签名并验证的提交推送到分支。 更多信息请参阅“[关于提交签名验证](/articles/about-commit-signature-verification)”。 +When you enable required commit signing on a branch, contibutors {% if currentVersion == "free-pro-team@latest" %}and bots{% endif %} can only push commits that have been signed and verified to the branch. 更多信息请参阅“[关于提交签名验证](/articles/about-commit-signature-verification)”。 -如果提交已进行签名和验证，则始终可以将本地提交推送到分支。 {% if currentVersion == "free-pro-team@latest" %}您也可以使用 {% data variables.product.product_name %} 上的拉请求将已经签名和验证的提交合并到分支。 但除非您是拉取请求的作者，否则不能将拉取请求压缩并合并到 {% data variables.product.product_name %} 。{% else %}但不能将拉取请求合并到 {% data variables.product.product_name %} 上的分支。{% endif %} 您可以在本地{% if currentVersion == "free-pro-team@latest" %}压缩和{% endif %}合并拉取请求。 更多信息请参阅“[本地检出拉取请求](/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally)”。{% if currentVersion == "free-pro-team@latest" %} 有关合并方法的详细信息，请参阅“[关于 {% data variables.product.prodname_dotcom %}](/github/administering-a-repository/about-merge-methods-on-github) 上的合并方法”。{% endif %} +如果提交已进行签名和验证，则始终可以将本地提交推送到分支。 {% if currentVersion == "free-pro-team@latest" %}You can also merge signed and verified commits into the branch using a pull request on {% data variables.product.product_name %}. However, you cannot squash and merge a pull request into the branch on {% data variables.product.product_name %} unless you are the author of the pull request.{% else %} However, you cannot merge pull requests into the branch on {% data variables.product.product_name %}.{% endif %} You can {% if currentVersion == "free-pro-team@latest" %}squash and {% endif %}merge pull requests locally. For more information, see "[Checking out pull requests locally](/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally)."{% if currentVersion == "free-pro-team@latest" %} For more information about merge methods, see "[About merge methods on {% data variables.product.prodname_dotcom %}](/github/administering-a-repository/about-merge-methods-on-github)."{% endif %} {% note %} diff --git a/translations/zh-CN/content/github/administering-a-repository/about-required-status-checks.md b/translations/zh-CN/content/github/administering-a-repository/about-required-status-checks.md index 83016fbd386e..77370584eaa3 100644 --- a/translations/zh-CN/content/github/administering-a-repository/about-required-status-checks.md +++ b/translations/zh-CN/content/github/administering-a-repository/about-required-status-checks.md @@ -23,7 +23,7 @@ versions: {% endtip %} -即使必需状态检查失败或待处理，仓库管理员也可以合并受保护分支。 You can require administrators to be subject to required status checks. 更多信息请参阅“[启用必需状态检查](/github/administering-a-repository/enabling-required-status-checks)”。 +即使必需状态检查失败或待处理，仓库管理员也可以合并受保护分支。 您可以要求管理员接受所需的状态检查。 更多信息请参阅“[启用必需状态检查](/github/administering-a-repository/enabling-required-status-checks)”。 ![管理员合并受保护分支](/assets/images/help/repository/req-status-check-admin-merge.png) diff --git a/translations/zh-CN/content/github/administering-a-repository/about-secret-scanning.md b/translations/zh-CN/content/github/administering-a-repository/about-secret-scanning.md index bb6282d94f6d..62a348d61049 100644 --- a/translations/zh-CN/content/github/administering-a-repository/about-secret-scanning.md +++ b/translations/zh-CN/content/github/administering-a-repository/about-secret-scanning.md @@ -116,5 +116,5 @@ versions: ### 延伸阅读 -- "[About securing your repository](/github/administering-a-repository/about-securing-your-repository)" +- “[关于保护仓库](/github/administering-a-repository/about-securing-your-repository)” - "[保护帐户和数据安全](/github/authenticating-to-github/keeping-your-account-and-data-secure)" diff --git a/translations/zh-CN/content/github/administering-a-repository/about-securing-your-repository.md b/translations/zh-CN/content/github/administering-a-repository/about-securing-your-repository.md index 566c9d4fea08..520338cdd854 100644 --- a/translations/zh-CN/content/github/administering-a-repository/about-securing-your-repository.md +++ b/translations/zh-CN/content/github/administering-a-repository/about-securing-your-repository.md @@ -1,44 +1,44 @@ --- -title: About securing your repository -intro: '{% data variables.product.product_name %} provides a number of ways that you can help keep your repository secure.' +title: 关于保护仓库 +intro: '{% data variables.product.product_name %} 提供了许多可帮助您保护仓库安全的方法。' versions: free-pro-team: '*' --- -### Setting up your repository securely +### 安全地设置仓库 -The first step to securing a repository is to set up who can see and modify your code. For more information, see "[Managing repository settings](/github/administering-a-repository/managing-repository-settings)." +保护仓库的第一步是设置谁可以查看和修改您的代码。 更多信息请参阅“[管理仓库设置](/github/administering-a-repository/managing-repository-settings)”。 ### 保护您的仓库 -{% data variables.product.prodname_dotcom %} has a growing set of security features that help you keep your code secure. You can find these on the **Security** tab for your repository. +{% data variables.product.prodname_dotcom %} 有越来越多的安全功能，可帮助您保护代码安全。 您可以在仓库的 **Security（安全）**选项卡上找到这些功能。 -- **Security policy** +- **安全策略** - Make it easy for people to confidentially report security vulnerabilities they've found in your repository. 更多信息请参阅“[添加安全政策到仓库](/github/managing-security-vulnerabilities/adding-a-security-policy-to-your-repository)”。 + 让人们能够轻松地秘密报告他们在仓库中发现的安全漏洞。 更多信息请参阅“[添加安全政策到仓库](/github/managing-security-vulnerabilities/adding-a-security-policy-to-your-repository)”。 -- **Security advisories** +- **安全通告** - Privately discuss and fix security vulnerabilities in your repository's code. You can then publish a security advisory to alert your community to the vulnerability and encourage them to upgrade. 更多信息请参阅“[关于 {% data variables.product.prodname_security_advisories %}](/github/managing-security-vulnerabilities/about-github-security-advisories)”。 + 私下讨论并修复仓库代码中的安全漏洞。 然后，您可以发布安全通告，提醒您的社区注意漏洞并鼓励他们升级。 更多信息请参阅“[关于 {% data variables.product.prodname_security_advisories %}](/github/managing-security-vulnerabilities/about-github-security-advisories)”。 -- **{% data variables.product.prodname_dependabot_short %} alerts** +- **{% data variables.product.prodname_dependabot_short %} 警报** - View alerts about dependencies that are known to contain security vulnerabilities, and choose whether to have pull requests generated automatically to update these dependencies. For more information, see "[Viewing and updating vulnerable dependencies in your repository](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)" and "[Configuring {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)." + 查看有关已知包含安全漏洞的依赖项的警报，并选择是否自动生成拉取请求以更新这些依赖项。 更多信息请参阅“[查看和更新仓库中的漏洞依赖项](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)”和“[配置 {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)”。 -- **{% data variables.product.prodname_code_scanning_capc %} alerts** +- **{% data variables.product.prodname_code_scanning_capc %} 警报** - Automatically detect security vulnerabilities and coding errors in new or modified code. Potential problems are highlighted, with detailed information, allowing you to fix the code before it's merged into your default branch. For more information, see "[About code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)." + 自动检测新代码或修改代码中的安全漏洞和编码错误。 潜在的问题被高亮显示，并附有详细信息，允许您在将代码合并到默认分支之前修复它。 更多信息请参阅“[关于代码扫描](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)”。 -- **Detected secrets** +- **检测到的密钥** - View any secrets that {% data variables.product.prodname_dotcom %} has found in your code. You should treat tokens or credentials that have been checked into the repository as compromised. For more information, see "[About secret scanning](/github/administering-a-repository/about-secret-scanning)." + 查看 {% data variables.product.prodname_dotcom %} 在您的代码中找到的任何密钥。 应将已检入仓库的令牌或凭据视为已泄露。 更多信息请参阅“[关于密钥扫描](/github/administering-a-repository/about-secret-scanning)”。 -### Exploring dependencies -{% data variables.product.prodname_dotcom %}'s dependency graph allows you to explore: +### 探索依赖项 +{% data variables.product.prodname_dotcom %} 的依赖项图允许您探索： -* Ecosystems and packages that your repository depends on -* Repositories and packages that depend on your repository +* 您的仓库依赖的生态系统和包 +* 依赖于您的仓库的仓库和包 -You must enable the dependency graph before {% data variables.product.prodname_dotcom %} can generate {% data variables.product.prodname_dependabot_short %} alerts for dependencies with security vulnerabilities. +必须先启用依赖项图，然后 {% data variables.product.prodname_dotcom %} 才能针对有安全漏洞的依赖项生成 {% data variables.product.prodname_dependabot_short %} 警报。 -You can find the dependency graph on the **Insights** tab for your repository. 更多信息请参阅“[关于依赖关系图](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)”。 +您可以在仓库的 **Insights（洞察）**选项卡上找到依赖项图。 更多信息请参阅“[关于依赖关系图](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)”。 diff --git a/translations/zh-CN/content/github/administering-a-repository/automation-for-release-forms-with-query-parameters.md b/translations/zh-CN/content/github/administering-a-repository/automation-for-release-forms-with-query-parameters.md index a7ac7a8041ae..f926f2dab542 100644 --- a/translations/zh-CN/content/github/administering-a-repository/automation-for-release-forms-with-query-parameters.md +++ b/translations/zh-CN/content/github/administering-a-repository/automation-for-release-forms-with-query-parameters.md @@ -1,6 +1,6 @@ --- title: 使用查询参数自动化发行版表单 -intro: 要通过使用自定义信息自动填充新发行版表单来快速创建发行版，可以添加查询参数到发行版表单页面的 URL。 +intro: '要通过使用自定义信息自动填充新发行版表单来快速创建发行版，可以添加查询参数到发行版表单页面的 URL。' redirect_from: - /articles/automation-for-release-forms-with-query-parameters versions: diff --git a/translations/zh-CN/content/github/administering-a-repository/changing-the-default-branch.md b/translations/zh-CN/content/github/administering-a-repository/changing-the-default-branch.md new file mode 100644 index 000000000000..f03827cdf08c --- /dev/null +++ b/translations/zh-CN/content/github/administering-a-repository/changing-the-default-branch.md @@ -0,0 +1,53 @@ +--- +title: Changing the default branch +intro: 'If you have more than one branch in your repository, you can configure any branch as the default branch.' +permissions: People with admin permissions to a repository can change the default branch for the repository. +versions: + free-pro-team: '*' + enterprise-server: '*' +redirect_from: + - /github/administering-a-repository/setting-the-default-branch + - /articles/setting-the-default-branch +--- + +### About changing the default branch + +You can choose the default branch for a repository. The default branch is the base branch for pull requests and code commits. For more information about the default branch, see "[About branches](/github/collaborating-with-issues-and-pull-requests/about-branches#about-the-default-branch)." + +{% note %} + +**Note**: If you use the Git-Subversion bridge, changing the default branch will affect your `trunk` branch contents and the `HEAD` you see when you list references for the remote repository. For more information, see "[Support for Subversion clients](/github/importing-your-projects-to-github/support-for-subversion-clients)" and [git-ls-remote](https://git-scm.com/docs/git-ls-remote.html) in the Git documentation. + +{% endnote %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} + +{% data reusables.branches.set-default-branch %} + +{% endif %} + +### 基本要求 + +To change the default branch, your repository must have more than one branch. 更多信息请参阅“[创建和删除仓库中的分支](/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository#creating-a-branch)”。 + +### Changing the default branch + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.repository-branches %} +1. Under "Default branch", to the right of the default branch name, click {% octicon "arrow-switch" aria-label="The switch icon with two arrows" %}. ![Switch icon with two arrows to the right of current default branch name](/assets/images/help/repository/repository-options-defaultbranch-change.png) +1. Use the drop-down, then click a branch name. ![Drop-down to choose new default branch](/assets/images/help/repository/repository-options-defaultbranch-drop-down.png) +1. 单击 **Update（更新）**。 !["Update" button after choosing a new default branch](/assets/images/help/repository/repository-options-defaultbranch-update.png) +1. Read the warning, then click **I understand, update the default branch.** !["Update" button after choosing a new default branch](/assets/images/help/repository/repository-options-defaultbranch-i-understand.png) + +{% else %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.repository-branches %} +1. 在默认分支下拉菜单中，选择新的默认分支。 ![默认分支下拉选择器](/assets/images/help/repository/repository-options-defaultbranch.png) +1. 单击 **Update（更新）**。 + +{% endif %} diff --git a/translations/zh-CN/content/github/administering-a-repository/classifying-your-repository-with-topics.md b/translations/zh-CN/content/github/administering-a-repository/classifying-your-repository-with-topics.md index 5a48d307c9ed..1adf59df661f 100644 --- a/translations/zh-CN/content/github/administering-a-repository/classifying-your-repository-with-topics.md +++ b/translations/zh-CN/content/github/administering-a-repository/classifying-your-repository-with-topics.md @@ -1,6 +1,6 @@ --- -title: 使用主题对仓库分类 -intro: 为帮助其他人找到并参与您的项目，可以为仓库添加主题，这些主题可以与项目的预期目的、学科领域、关联团队或其他重要特点相关。 +title: Classifying your repository with topics +intro: 'To help other people find and contribute to your project, you can add topics to your repository related to your project''s intended purpose, subject area, affinity groups, or other important qualities.' redirect_from: - /articles/about-topics/ - /articles/classifying-your-repository-with-topics @@ -9,30 +9,36 @@ versions: enterprise-server: '*' --- -### 关于主题 +### About topics -使用主题可以探索特定主题领域的仓库，查找要参与的项目，以及发现特定问题的新解决方案。 主题显示在仓库的主页面上。 您可以单击主题名称以{% if currentVersion == "free-pro-team@latest" %}查看相关主题及其他以该主题分类的仓库列表{% else %}搜索使用该主题的其他仓库{% endif %}。 +With topics, you can explore repositories in a particular subject area, find projects to contribute to, and discover new solutions to a specific problem. Topics appear on the main page of a repository. You can click a topic name to {% if currentVersion == "free-pro-team@latest" %}see related topics and a list of other repositories classified with that topic{% else %}search for other repositories with that topic{% endif %}. -![显示主题的测试仓库主页面](/assets/images/help/repository/os-repo-with-topics.png) +![Main page of the test repository showing topics](/assets/images/help/repository/os-repo-with-topics.png) -要浏览最常用的主题，请访问 https://github.com/topics/ +To browse the most used topics, go to https://github.com/topics/. -{% if currentVersion == "free-pro-team@latest" %}您可以在 [github/explore](https://github.com/github/explore) 仓库中参与 {% data variables.product.product_name %} 的专有主题集。 {% endif %} +{% if currentVersion == "free-pro-team@latest" %}You can contribute to {% data variables.product.product_name %}'s set of featured topics in the [github/explore](https://github.com/github/explore) repository. {% endif %} -仓库管理员可以添加他们喜欢的任何主题到仓库。 适用于对仓库分类的主题包括仓库的预期目的、主题领域、社区或语言。{% if currentVersion == "free-pro-team@latest" %} 此外，{% data variables.product.product_name %} 也会分析公共仓库内容，生成建议的主题，仓库管理员可以接受或拒绝。 私有仓库内容不可分析，也不会收到主题建议。{% endif %} +Repository admins can add any topics they'd like to a repository. Helpful topics to classify a repository include the repository's intended purpose, subject area, community, or language.{% if currentVersion == "free-pro-team@latest" %} Additionally, {% data variables.product.product_name %} analyzes public repository content and generates suggested topics that repository admins can accept or reject. Private repository content is not analyzed and does not receive topic suggestions.{% endif %} -公共和私有仓库都可有主题，但在主题搜索结果中只能看到您可以访问的私有仓库。 +Public and private repositories can have topics, although you will only see private repositories that you have access to in topic search results. -您可以搜索与公共仓库关联的仓库。 更多信息请参阅“[搜索仓库](/articles/searching-for-repositories#search-by-topic)”。 您也可以搜索 {% data variables.product.product_name %} 中的主题列表。 更多信息请参阅“[搜索主题](/articles/searching-topics)”。 +You can search for repositories that are associated with a particular topic. For more information, see "[Searching for repositories](/articles/searching-for-repositories#search-by-topic)." You can also search for a list of topics on {% data variables.product.product_name %}. For more information, see "[Searching topics](/articles/searching-topics)." -### 添加主题到仓库 +### Adding topics to your repository {% data reusables.repositories.navigate-to-repo %}{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %} -2. 在仓库说明下，单击 **Add topics（添加主题）**。 ![在仓库的主页面上添加主题链接](/assets/images/help/repository/add-topics-link.png) -3. 键入要添加到仓库的主题，然后键入空格。 ![输入主题的表单](/assets/images/help/repository/add-topic-form.png) -4. 完成添加主题后，单击 **Done（完成）**。 ![含主题列表和完成按钮的表单](/assets/images/help/repository/add-topics-done-button.png) +2. Under your repository description, click **Add topics**. + ![Add topics link on a repository's main page](/assets/images/help/repository/add-topics-link.png) +3. Type the topic you want to add to your repository, then type a space. + ![Form to enter topics](/assets/images/help/repository/add-topic-form.png) +4. After you've finished adding topics, click **Done**. + ![Form with a list of topics and Done button](/assets/images/help/repository/add-topics-done-button.png) {% else %} -2. 在“About（关于）”右侧，单击 {% octicon "gear" aria-label="The Gear icon" %}。 ![仓库主页上的齿轮图标](/assets/images/help/repository/edit-repository-details-gear.png) -3. 在“"Topics（主题）”下，键入要添加到仓库的主题，然后键入空格。 ![输入主题的表单](/assets/images/help/repository/add-topic-form.png) -4. 完成添加主题后，单击 **Save changes（保存更改）**。 !["Edit repository details（编辑仓库详细信息）"中的"Save changes（保存更改）"按钮](/assets/images/help/repository/edit-repository-details-save-changes-button.png) +2. To the right of "About", click {% octicon "gear" aria-label="The Gear icon" %}. + ![Gear icon on main page of a repository](/assets/images/help/repository/edit-repository-details-gear.png) +3. Under "Topics", type the topic you want to add to your repository, then type a space. + ![Form to enter topics](/assets/images/help/repository/add-topic-form.png) +4. After you've finished adding topics, click **Save changes**. + !["Save changes" button in "Edit repository details"](/assets/images/help/repository/edit-repository-details-save-changes-button.png) {% endif %} diff --git a/translations/zh-CN/content/github/administering-a-repository/configuration-options-for-dependency-updates.md b/translations/zh-CN/content/github/administering-a-repository/configuration-options-for-dependency-updates.md index 6efe68ce935b..f746607004e2 100644 --- a/translations/zh-CN/content/github/administering-a-repository/configuration-options-for-dependency-updates.md +++ b/translations/zh-CN/content/github/administering-a-repository/configuration-options-for-dependency-updates.md @@ -18,32 +18,33 @@ versions: *dependabot.yml* 文件必须以 `version: 2` 开头，后接 `updates` 数组。 -| 选项 | 必选 | 描述 | -|:-------------------------------------------------------------------------- |:-----:|:----------------- | -| [`package-ecosystem`](#package-ecosystem) | **X** | 要使用的包管理器 | -| [`目录`](#directory) | **X** | 包清单位置 | -| [`schedule.interval`](#scheduleinterval) | **X** | 检查更新的频率 | -| [`allow`](#allow) | | 自定义允许的更新 | -| [`assignees`](#assignees) | | 要在拉取请求上设置的受让人 | -| [`commit-message`](#commit-message) | | 提交消息首选项 | -| [`ignore`](#ignore) | | 忽略某些依赖项或版本 | -| [`labels`](#labels) | | 要在拉取请求上设置的标签 | -| [`里程碑`](#milestone) | | 要在拉取请求上设置的里程碑 | -| [`open-pull-requests-limit`](#open-pull-requests-limit) | | 限制对版本更新打开的拉取请求数 | -| [`pull-request-branch-name.separator`](#pull-request-branch-nameseparator) | | 更改拉取请求分支名称的分隔符 | -| [`rebase-strategy`](#rebase-strategy) | | 禁用自动变基 | -| [`reviewers`](#reviewers) | | 要在拉取请求上设置的审查者 | -| [`schedule.day`](#scheduleday) | | 检查更新的周日期 | -| [`schedule.time`](#scheduletime) | | 每天检查更新的时间 (hh:mm) | -| [`schedule.timezone`](#scheduletimezone) | | 一天中时间的时区（区域标识符） | -| [`target-branch`](#target-branch) | | 对其创建拉取请求的分支 | -| [`versioning-strategy`](#versioning-strategy) | | 如何更新清单版本要求 | +| 选项 | 必选 | 描述 | +|:-------------------------------------------------------------------------- |:-----:|:-------------------------------------- | +| [`package-ecosystem`](#package-ecosystem) | **X** | 要使用的包管理器 | +| [`目录`](#directory) | **X** | 包清单位置 | +| [`schedule.interval`](#scheduleinterval) | **X** | 检查更新的频率 | +| [`allow`](#allow) | | 自定义允许的更新 | +| [`assignees`](#assignees) | | 要在拉取请求上设置的受让人 | +| [`commit-message`](#commit-message) | | 提交消息首选项 | +| [`ignore`](#ignore) | | 忽略某些依赖项或版本 | +| [`labels`](#labels) | | 要在拉取请求上设置的标签 | +| [`里程碑`](#milestone) | | 要在拉取请求上设置的里程碑 | +| [`open-pull-requests-limit`](#open-pull-requests-limit) | | 限制对版本更新打开的拉取请求数 | +| [`pull-request-branch-name.separator`](#pull-request-branch-nameseparator) | | 更改拉取请求分支名称的分隔符 | +| [`rebase-strategy`](#rebase-strategy) | | 禁用自动变基 | +| [`reviewers`](#reviewers) | | 要在拉取请求上设置的审查者 | +| [`schedule.day`](#scheduleday) | | 检查更新的周日期 | +| [`schedule.time`](#scheduletime) | | 每天检查更新的时间 (hh:mm) | +| [`schedule.timezone`](#scheduletimezone) | | 一天中时间的时区（区域标识符） | +| [`target-branch`](#target-branch) | | 对其创建拉取请求的分支 | +| [`vendor`](#vendor) | | Update vendored or cached dependencies | +| [`versioning-strategy`](#versioning-strategy) | | 如何更新清单版本要求 | 这些选项大致分为以下类别。 - 必须包含在所有配置中的基本设置选项：[`package-ecosystem`](#package-ecosystem)、[`directory`](#directory)、[`schedule.interval`](#scheduleinterval)。 - 用于自定义更新计划的选项：[`schedule.time`](#scheduletime)、[`schedule.timezone`](#scheduletimezone)、[`schedule.day`](#scheduleday)。 -- 用于控制更新哪些依赖项的选项：[`allow`](#allow)、[`ignore`](#ignore)。 +- Options to control which dependencies are updated: [`allow`](#allow), [`ignore`](#ignore), [`vendor`](#vendor). - 用于将元数据添加到拉取请求的选项：[`reviewers`](#reviewers)、[`assignees`](#assignees)、[`labels`](#labels)、[`milestone`](#milestone)。 - 用于更改拉取请求行为的选项：[`target-branch`](#target-branch)、[`versioning-strategy`](#versioning-strategy)、[`commit-message`](#commit-message)、[`rebase-strategy`](#rebase-strategy)、[`pull-request-branch-name.separator`](#pull-request-branch-nameseparator)。 @@ -61,7 +62,7 @@ versions: ### `package-ecosystem` -**必选** 为您希望 {% data variables.product.prodname_dependabot %} 监控新版本的每个包管理器添加一个 `package-ecosystem` 元素。 仓库还必须包含其中每个包管理器的依赖项清单或锁定文件。 +**Required** You add one `package-ecosystem` element for each package manager that you want {% data variables.product.prodname_dependabot_short %} to monitor for new versions. The repository must also contain a dependency manifest or lock file for each of these package managers. If you want to enable vendoring for a package manager that supports it, the vendored dependencies must be located in the required directory. For more information, see [`vendor`](#vendor) below. {% data reusables.dependabot.supported-package-managers %} @@ -155,13 +156,13 @@ updates: - `dependency-name`—用于更新名称匹配的依赖项，可以选择使用 `*` 来匹配零个或更多字符。 对于 Java 依赖项，`dependency-name` 属性的格式为：`groupId:artifactId`，例如：`org.kohsuke:github-api`。 - `dependency-type`—用于更新特定类型的依赖项。 - | 依赖项类型 | 支持的包管理器 | 允许更新 | - | ------------- | ---------------------------------------------- | --------------------------------------------------------------- | - | `直接` | 所有 | 所有明确定义的依赖项。 | - | `间接` | `bundler`、`pip`、`composer`、`cargo` | 直接依赖关系的依赖项（也称为子依赖项或暂时依赖项）。 | - | `all` | 所有 | 所有明确定义的依赖项。 对于 `bundler`、`pip`、`composer`、`cargo` 以及直接依赖关系的依赖项。 | - | `生产` | `bundler`、`composer`、`mix`、`maven`、`npm`、`pip` | 仅“产品依赖项组”中的依赖项。 | - | `development` | `bundler`、`composer`、`mix`、`maven`、`npm`、`pip` | 仅“产品依赖项组”中的依赖项。 | + | 依赖项类型 | 支持的包管理器 | 允许更新 | + | ----- | ---------------------------------------------- | --------------------------------------------------------------- | + | `直接` | 所有 | 所有明确定义的依赖项。 | + | `间接` | `bundler`、`pip`、`composer`、`cargo` | 直接依赖关系的依赖项（也称为子依赖项或暂时依赖项）。 | + | `all` | 所有 | 所有明确定义的依赖项。 对于 `bundler`、`pip`、`composer`、`cargo` 以及直接依赖关系的依赖项。 | + | `生产` | `bundler`、`composer`、`mix`、`maven`、`npm`、`pip` | 仅“产品依赖项组”中的依赖项。 | + | `开发` | `bundler`、`composer`、`mix`、`maven`、`npm`、`pip` | 仅“产品依赖项组”中的依赖项。 | ```yaml # Customizing the dependencies to maintain with `allow` @@ -273,7 +274,7 @@ updates: #### 检查现有的 ignore 首选项 -在添加 `ignore` 选项到配置文件之前，检查您以前是否对安全更新或版本更新拉取请求使用过任何e `@dependabot ignore` 命令。 {% data variables.product.prodname_dependabot %} 集中存储每个包管理器的这些首选项，并且此信息被 `ignore` 选项覆盖。 For more information about the `@dependabot ignore` commands, see "[Managing pull requests for dependency updates](/github/administering-a-repository/managing-pull-requests-for-dependency-updates)." +在添加 `ignore` 选项到配置文件之前，检查您以前是否对安全更新或版本更新拉取请求使用过任何e `@dependabot ignore` 命令。 {% data variables.product.prodname_dependabot %} 集中存储每个包管理器的这些首选项，并且此信息被 `ignore` 选项覆盖。 有关 `@dependabot ignore` 命令的更多信息，请参阅“[管理依赖项更新的拉取请求](/github/administering-a-repository/managing-pull-requests-for-dependency-updates)”。 您可以搜索仓库中是否有 `"@dependabot ignore" in:comments`，以检查仓库是否存储了首选项。 如果审查结果中的任何拉取请求，您可以决定是否在配置文件中指定这些忽略的依赖项或版本。 @@ -307,7 +308,7 @@ updates: {% note %} -{% data variables.product.prodname_dependabot_version_updates %} can't run version updates for any dependencies in manifests containing private git dependencies or private git registries, even if you add the private dependencies to the `ignore` option of your configuration file. For more information, see "[About {% data variables.product.prodname_dependabot_version_updates %}](/github/administering-a-repository/about-github-dependabot#supported-repositories-and-ecosystems)." +**Note**: {% data variables.product.prodname_dependabot_version_updates %} can't run version updates for any dependencies in manifests containing private git dependencies or private git registries, even if you add the private dependencies to the `ignore` option of your configuration file. 更多信息请参阅“[关于 {% data variables.product.prodname_dependabot_version_updates %}](/github/administering-a-repository/about-github-dependabot#supported-repositories-and-ecosystems)”。 {% endnote %} @@ -540,6 +541,31 @@ updates: - "npm dependencies" ``` +### `vendor` + +Use the `vendor` option to tell {% data variables.product.prodname_dependabot_short %} to vendor dependencies when updating them. + +{% note %} + +Currently, {% data variables.product.prodname_dependabot_short %} only supports vendoring dependencies for Bundler. + +{% endnote %} + +```yaml +# Configure version updates for both dependencies defined in manifests and vendored dependencies + +version: 2 +updates: + - package-ecosystem: "bundler" + # Raise pull requests to update vendored dependencies that are checked in to the repository + vendor: true + directory: "/" + schedule: + interval: "weekly" +``` + +{% data variables.product.prodname_dependabot_short %} only updates the vendored dependencies located in specific directories in a repository. For Bundler, the dependencies must be in the _vendor/cache_ directory. Other file paths are not supported. For more information, see the [`bundle cache` documentation](https://bundler.io/man/bundle-cache.1.html). + ### `versioning-strategy` {% data variables.product.prodname_dependabot %} 在编辑清单文件来更新版本时，使用以下总体策略： diff --git a/translations/zh-CN/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md b/translations/zh-CN/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md index 113ce184d66b..a5a6d538b59f 100644 --- a/translations/zh-CN/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md +++ b/translations/zh-CN/content/github/administering-a-repository/configuring-autolinks-to-reference-external-resources.md @@ -6,7 +6,7 @@ redirect_from: - /articles/configuring-autolinks-to-reference-external-resources versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- Anyone with admin permissions to a repository can configure autolink references to link issues, pull requests,{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} commit messages, and release descriptions{% else %} and commit messages{% endif %} to external third-party services. diff --git a/translations/zh-CN/content/github/administering-a-repository/configuring-protected-branches.md b/translations/zh-CN/content/github/administering-a-repository/configuring-protected-branches.md index 739669d2aa97..074f5c638100 100644 --- a/translations/zh-CN/content/github/administering-a-repository/configuring-protected-branches.md +++ b/translations/zh-CN/content/github/administering-a-repository/configuring-protected-branches.md @@ -1,6 +1,6 @@ --- title: 配置受保护分支 -intro: 如果您是仓库所有者或者拥有仓库管理员权限，您可以自定义仓库中的分支保护和实施某些工作流程，例如要求在合并拉取请求之前进行多次拉取请求审查或某些状态检查。 +intro: '如果您是仓库所有者或者拥有仓库管理员权限，您可以自定义仓库中的分支保护和实施某些工作流程，例如要求在合并拉取请求之前进行多次拉取请求审查或某些状态检查。' product: '{% data reusables.gated-features.protected-branches %}' redirect_from: - /articles/configuring-protected-branches diff --git a/translations/zh-CN/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md b/translations/zh-CN/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md new file mode 100644 index 000000000000..c759845dad4e --- /dev/null +++ b/translations/zh-CN/content/github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository.md @@ -0,0 +1,18 @@ +--- +title: Configuring the retention period for GitHub Actions artifacts and logs in your repository +intro: 'You can configure the retention period for {% data variables.product.prodname_actions %} artifacts and logs in your repository.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.23' +--- + +{% data reusables.actions.about-artifact-log-retention %} + +You can also define a custom retention period for a specific artifact created by a workflow. For more information, see "[Setting the retention period for an artifact](/actions/managing-workflow-runs/removing-workflow-artifacts#setting-the-retention-period-for-an-artifact)." + +## Setting the retention period for a repository + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.settings-sidebar-actions %} +{% data reusables.github-actions.change-retention-period-for-artifacts-logs %} diff --git a/translations/zh-CN/content/github/administering-a-repository/customizing-how-changed-files-appear-on-github.md b/translations/zh-CN/content/github/administering-a-repository/customizing-how-changed-files-appear-on-github.md index 60f5ecda7439..df5706f6313f 100644 --- a/translations/zh-CN/content/github/administering-a-repository/customizing-how-changed-files-appear-on-github.md +++ b/translations/zh-CN/content/github/administering-a-repository/customizing-how-changed-files-appear-on-github.md @@ -1,6 +1,6 @@ --- title: 自定义更改的文件在 GitHub 中如何显示 -intro: 要确保某些文件默认显示差异，或者计入仓库语言，您可以使用 *.gitattributes* 文件中的 `linguist-generated` 属性标记它们。 +intro: '要确保某些文件默认显示差异，或者计入仓库语言，您可以使用 *.gitattributes* 文件中的 `linguist-generated` 属性标记它们。' redirect_from: - /articles/customizing-how-changed-files-appear-on-github versions: diff --git a/translations/zh-CN/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md b/translations/zh-CN/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md index fe85fe9c622b..80c4b969b651 100644 --- a/translations/zh-CN/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md +++ b/translations/zh-CN/content/github/administering-a-repository/customizing-your-repositorys-social-media-preview.md @@ -5,7 +5,7 @@ redirect_from: - /articles/customizing-your-repositorys-social-media-preview versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- 在添加图像之前，请展开仓库链接以显示关于仓库和所有者头像的基本信息。 为仓库添加图像有助于在各种社交平台上识别您的项目。 @@ -13,7 +13,7 @@ versions: 可以向私有仓库上传图像，但只能从公共仓库下载图像。 {% tip %} -Tip: Your image should be a PNG, JPG, or GIF file under 1 MB in size. 为获取质量最佳的渲染，建议图像的像素保持在 640 x 320 像素。 +提示：您的图像应为大小在 1 MB 以下的 PNG、JPG 或 GIF 文件。 为获取质量最佳的渲染，建议图像的像素保持在 640 x 320 像素。 {% endtip %} {% data reusables.repositories.navigate-to-repo %} diff --git a/translations/zh-CN/content/github/administering-a-repository/defining-the-mergeability-of-pull-requests.md b/translations/zh-CN/content/github/administering-a-repository/defining-the-mergeability-of-pull-requests.md index 184ca1197e60..5446851fba64 100644 --- a/translations/zh-CN/content/github/administering-a-repository/defining-the-mergeability-of-pull-requests.md +++ b/translations/zh-CN/content/github/administering-a-repository/defining-the-mergeability-of-pull-requests.md @@ -1,6 +1,6 @@ --- title: 定义拉取请求的可合并性 -intro: 您可以要求拉取请求在可以合并之前先通过一组检查。 例如，您可以阻止未通过状态检查的拉取请求，或要求拉取请求在获得特定数量的批准审查之后才可合并。 +intro: '您可以要求拉取请求在可以合并之前先通过一组检查。 例如，您可以阻止未通过状态检查的拉取请求，或要求拉取请求在获得特定数量的批准审查之后才可合并。' redirect_from: - /articles/defining-the-mergeability-of-a-pull-request/ - /articles/defining-the-mergeability-of-pull-requests diff --git a/translations/zh-CN/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md b/translations/zh-CN/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md index f024875d5d12..ef2332e1d43d 100644 --- a/translations/zh-CN/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md +++ b/translations/zh-CN/content/github/administering-a-repository/deleting-and-restoring-branches-in-a-pull-request.md @@ -1,6 +1,6 @@ --- title: 删除和恢复拉取请求中的分支 -intro: 如果拥有仓库的写入权限，可删除与已关闭或已合并拉取请求关联的分支。 无法删除与已打开拉取请求关联的分支。 +intro: '如果拥有仓库的写入权限，可删除与已关闭或已合并拉取请求关联的分支。 无法删除与已打开拉取请求关联的分支。' redirect_from: - /articles/tidying-up-pull-requests/ - /articles/restoring-branches-in-a-pull-request/ @@ -35,6 +35,5 @@ versions: ### 延伸阅读 -- “[在仓库内创建和删除分支](/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository)”{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} +- “[在仓库内创建和删除分支](/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository)” - "[管理分支的自动删除](/github/administering-a-repository/managing-the-automatic-deletion-of-branches)."。 -{% endif %} diff --git a/translations/zh-CN/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md b/translations/zh-CN/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md index e910d970a725..a58b62fe8f8c 100644 --- a/translations/zh-CN/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md +++ b/translations/zh-CN/content/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository.md @@ -17,11 +17,13 @@ versions: 此外，您可以在您的仓库中启用 {% data variables.product.prodname_actions %}，但限制工作流程可以运行的操作。 {% data reusables.github-actions.enabled-local-github-actions %} +{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.23" %} + ### 管理仓库的 {% data variables.product.prodname_actions %} 权限 {% note %} -**注：**如果您的组织有覆盖策略或由具有覆盖策略的企业帐户管理，则可能无法管理这些设置。 更多信息请参阅“[禁用或限制组织的 {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization)”或“[在企业帐户中实施 {% data variables.product.prodname_actions %} 策略](/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account)”。 +**注：**如果您的组织有覆盖策略或由具有覆盖策略的企业帐户管理，则可能无法管理这些设置。 For more information, see "[Disabling or limiting {% data variables.product.prodname_actions %} for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization)" or {% if currentVersion == "free-pro-team@latest" %}"[Enforcing {% data variables.product.prodname_actions %} policies in your enterprise account](/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account)."{% else if currentVersion ver_gt "enterprise-server@2.21"%}"[Enforcing {% data variables.product.prodname_actions %} policies for your enterprise](/enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise)."{% endif %} {% endnote %} @@ -30,12 +32,47 @@ versions: {% data reusables.repositories.settings-sidebar-actions %} 4. 在“Actions permissions（操作权限）”下，选择一个选项。 ![启用、禁用或限制此仓库的操作](/assets/images/help/repository/enable-repo-actions.png) +{% endif %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} + +### 管理仓库的 {% data variables.product.prodname_actions %} 权限 + +You can disable all workflows for a repository or set a policy that configures which actions can be used in a repository. + +{% data reusables.actions.actions-use-policy-settings %} + +{% note %} + +**注：**如果您的组织有覆盖策略或由具有覆盖策略的企业帐户管理，则可能无法管理这些设置。 For more information, see "[Disabling or limiting {% data variables.product.prodname_actions %} for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization)" or {% if currentVersion == "free-pro-team@latest" %}"[Enforcing {% data variables.product.prodname_actions %} policies in your enterprise account](/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account)."{% else if currentVersion ver_gt "enterprise-server@2.21" %}"[Enforcing {% data variables.product.prodname_actions %} policies for your enterprise](/enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise)." + +{% endif %} + +{% endnote %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.settings-sidebar-actions %} +1. Under **Actions permissions**, select an option. ![Set actions policy for this organization](/assets/images/help/repository/actions-policy.png) +1. 单击 **Save（保存）**。 + +### Allowing specific actions to run + +{% data reusables.actions.allow-specific-actions-intro %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.settings-sidebar-actions %} +1. Under **Actions permissions**, select **Allow specific actions** and add your required actions to the list. ![Add actions to allow list](/assets/images/help/repository/actions-policy-allow-list.png) +2. 单击 **Save（保存）**。 +{% endif %} + {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -### Enabling workflows for private repository forks +### 为私有仓库复刻启用工作流程 {% data reusables.github-actions.private-repository-forks-overview %} -#### Configuring the private fork policy for a repository +#### 为仓库配置私有复刻策略 {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} diff --git a/translations/zh-CN/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md b/translations/zh-CN/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md index ea7e3453cf62..2d2dafa7bf3c 100644 --- a/translations/zh-CN/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md +++ b/translations/zh-CN/content/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository.md @@ -14,18 +14,18 @@ versions: 您也可以每个赞助平台添加一个用户名、包名称或项目名，以及最多四个自定义 URL。 最多可在 {% data variables.product.prodname_sponsors %} 中添加四位被赞助的开发者或组织。 在新行上添加每个平台，使用以下语法： -| 平台 | 语法 | -| ---------------------------------------------------------------------------------- | ----------------------------------------------------------------------- | -| [CommunityBridge](https://communitybridge.org) | `community_bridge: PROJECT-NAME` | +| 平台 | 语法 | +| ----------------------------------------------------------------------------- | ----------------------------------------------------------------------- | +| [CommunityBridge](https://communitybridge.org) | `community_bridge: PROJECT-NAME` | | [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors) | `github: USERNAME` 或 `github: [USERNAME, USERNAME, USERNAME, USERNAME]` | -| [IssueHunt](https://issuehunt.io/) | `issuehunt: USERNAME` | -| [Ko-fi](https://ko-fi.com/) | `ko_fi: USERNAME` | -| [Liberapay](https://en.liberapay.com/) | `liberapay: USERNAME` | -| [Open Collective](https://opencollective.com/) | `open_collective: USERNAME` | -| [Otechie](https://otechie.com/) | `otechie: USERNAME` | -| [Patreon](https://www.patreon.com/) | `patreon: USERNAME` | -| [Tidelift](https://tidelift.com/) | `tidelift: PLATFORM-NAME/PACKAGE-NAME` | -| Custom URL | `custom: LINK1` 或 `custom: [LINK1, LINK2, LINK3, LINK4]` | +| [IssueHunt](https://issuehunt.io/) | `issuehunt: USERNAME` | +| [Ko-fi](https://ko-fi.com/) | `ko_fi: USERNAME` | +| [Liberapay](https://en.liberapay.com/) | `liberapay: USERNAME` | +| [Open Collective](https://opencollective.com/) | `open_collective: USERNAME` | +| [Otechie](https://otechie.com/) | `otechie: USERNAME` | +| [Patreon](https://www.patreon.com/) | `patreon: USERNAME` | +| [Tidelift](https://tidelift.com/) | `tidelift: PLATFORM-NAME/PACKAGE-NAME` | +| Custom URL | `custom: LINK1` 或 `custom: [LINK1, LINK2, LINK3, LINK4]` | 对于 TideLift，请使用 `platform-name/package-name` 带有以下平台名称的语法： diff --git a/translations/zh-CN/content/github/administering-a-repository/enabling-and-disabling-version-updates.md b/translations/zh-CN/content/github/administering-a-repository/enabling-and-disabling-version-updates.md index e8371bbad63e..774d0a3c179a 100644 --- a/translations/zh-CN/content/github/administering-a-repository/enabling-and-disabling-version-updates.md +++ b/translations/zh-CN/content/github/administering-a-repository/enabling-and-disabling-version-updates.md @@ -10,11 +10,11 @@ versions: ### 关于依赖项的版本更新 -You enable {% data variables.product.prodname_dependabot_version_updates %} by checking a *dependabot.yml* configuration file in to your repository's `.github` directory. {% data variables.product.prodname_dependabot_short %} then raises pull requests to keep the dependencies you configure up-to-date. 对于您想更新的每个包管理器的依赖项，必须指定包清单文件的位置及为文件所列的依赖项检查更新的频率。 有关启用安全更新的信息，请参阅“[配置 {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)。” +通过将 *dependabot.yml* 配置文件检入仓库的 `.github` 目录，可启用 {% data variables.product.prodname_dependabot_version_updates %}。 {% data variables.product.prodname_dependabot_short %} 然后提出拉取请求，使您配置的依赖项保持最新。 对于您想更新的每个包管理器的依赖项，必须指定包清单文件的位置及为文件所列的依赖项检查更新的频率。 有关启用安全更新的信息，请参阅“[配置 {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)。” {% data reusables.dependabot.initial-updates %} 更多信息请参阅“[自定义依赖项更新](/github/administering-a-repository/customizing-dependency-updates)。” -### 启用 {% data variables.product.prodname_dependabot_version_updates %} +### Enabling {% data variables.product.prodname_dependabot_version_updates %} {% note %} @@ -72,11 +72,11 @@ updates: ### 检查版本更新的状态 -启用版本更新后，将在仓库的依赖关系图中发现新的 **Dependabot** 选项卡。 This tab shows which package managers {% data variables.product.prodname_dependabot %} is configured to monitor and when {% data variables.product.prodname_dependabot_short %} last checked for new versions. +启用版本更新后，将在仓库的依赖关系图中发现新的 **Dependabot** 选项卡。 此选项卡显示配置了哪些要监视的包管理器 {% data variables.product.prodname_dependabot %} 以及 {% data variables.product.prodname_dependabot_short %} 上次检查新版本的时间。 ![仓库洞察选项卡，依赖关系图，Dependabot 选项卡](/assets/images/help/dependabot/dependabot-tab-view-beta.png) -For information, see "[Listing dependencies configured for version updates](/github/administering-a-repository/listing-dependencies-configured-for-version-updates)." +更多信息请参阅“[列出为版本更新配置的依赖项](/github/administering-a-repository/listing-dependencies-configured-for-version-updates)。” ### 禁用 {% data variables.product.prodname_dependabot_version_updates %} diff --git a/translations/zh-CN/content/github/administering-a-repository/enabling-anonymous-git-read-access-for-a-repository.md b/translations/zh-CN/content/github/administering-a-repository/enabling-anonymous-git-read-access-for-a-repository.md index 5771b9e77f18..366ccf45e2d8 100644 --- a/translations/zh-CN/content/github/administering-a-repository/enabling-anonymous-git-read-access-for-a-repository.md +++ b/translations/zh-CN/content/github/administering-a-repository/enabling-anonymous-git-read-access-for-a-repository.md @@ -1,6 +1,6 @@ --- title: 启用仓库的匿名 Git 读取权限 -intro: 作为仓库管理员，您可以启用或禁用满足特定要求的公共仓库的匿名 Git 读取权限。 +intro: '作为仓库管理员，您可以启用或禁用满足特定要求的公共仓库的匿名 Git 读取权限。' redirect_from: - /articles/enabling-anonymous-git-read-access-for-a-repository versions: diff --git a/translations/zh-CN/content/github/administering-a-repository/enabling-branch-restrictions.md b/translations/zh-CN/content/github/administering-a-repository/enabling-branch-restrictions.md index b127e6b910d4..edd2c8c4e984 100644 --- a/translations/zh-CN/content/github/administering-a-repository/enabling-branch-restrictions.md +++ b/translations/zh-CN/content/github/administering-a-repository/enabling-branch-restrictions.md @@ -1,6 +1,6 @@ --- title: 启用分支限制 -intro: '您可以强制实施分支限制以便只有特定用户{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}{% else %}或{% endif %}团队{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}或应用{% endif %}能够推送到组织所拥有的仓库中的受保护分支。' +intro: 'You can enforce branch restrictions so that only certain users{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %},{% else %} or{% endif %} teams{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, or apps{% endif %} can push to a protected branch in repositories owned by your organization.' product: '{% data reusables.gated-features.branch-restrictions %}' redirect_from: - /articles/enabling-branch-restrictions @@ -19,7 +19,7 @@ versions: {% data reusables.repositories.add-branch-protection-rules %} {% data reusables.repositories.include-administrators %} 6. 在“Protect matching branches（保护匹配分支）”下，选择 **Restrict who can push to matching branches（限制可推送到匹配分支的人员）**。 ![分支限制复选框](/assets/images/help/repository/restrict-branch.png) -8. 搜索并选择将有权推送到受保护分支的人员{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}、{% else %}或{% endif %}团队{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}或应用{% endif %}。 ![分支限制搜索](/assets/images/help/repository/restrict-branch-search.png) +8. Search for and select the people, teams, or apps who will have permission to push to the protected branch. ![分支限制搜索](/assets/images/help/repository/restrict-branch-search.png) 9. 单击 **Create（创建）**。 ### 延伸阅读 diff --git a/translations/zh-CN/content/github/administering-a-repository/enabling-force-pushes-to-a-protected-branch.md b/translations/zh-CN/content/github/administering-a-repository/enabling-force-pushes-to-a-protected-branch.md index 3a12f696460c..3cb9b4f7ebf3 100644 --- a/translations/zh-CN/content/github/administering-a-repository/enabling-force-pushes-to-a-protected-branch.md +++ b/translations/zh-CN/content/github/administering-a-repository/enabling-force-pushes-to-a-protected-branch.md @@ -1,31 +1,32 @@ --- -title: 启用强制推送到受保护分支 -intro: 您可以允许强制推送到受保护分支。 +title: Enabling force pushes to a protected branch +intro: You can allow force pushes to a protected branch. product: '{% data reusables.gated-features.protected-branches %}' versions: free-pro-team: '*' enterprise-server: '>=2.20' --- -对仓库具有管理员权限的任何人都可以启用强制推送。 +Anyone with admin permissions to a repository can enable force pushes. -### 关于强制推送到受保护分支 +### About force pushes to protected branches -默认情况下，所有受保护分支上阻止强制推送。 对受保护分支启用强制推送时，只要具有仓库写入权限，任何人（包括具有管理员权限的人）都可以强制推送到该分支。 +By default, force pushes are blocked on all protected branches. When you enable force pushes to a protected branch, anyone with at least write permissions to the repository can force push to the branch, including those with admin permissions. -启用强制推送不会覆盖任何其他分支保护规则。 例如，如果分支需要线性提交历史记录，则无法强制推送合并提交到该分支。 +Enabling force pushes will not override any other branch protection rules. For example, if a branch requires a linear commit history, you cannot force push merge commits to that branch. -{% if currentVersion != "free-pro-team@latest" %}如果站点管理员阻止了强制推送到仓库中的所有分支，则无法对受保护分支启用强制推送。 更多信息请参阅“[阻止强制推送到用户帐户或组织拥有的仓库](/enterprise/{{ currentVersion }}/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization)”。 +{% if currentVersion != "free-pro-team@latest" %}You cannot enable force pushes for a protected branch if a site administrator has blocked force pushes to all branches in your repository. For more information, see "[Blocking force pushes to repositories owned by a user account or organization](/enterprise/{{ currentVersion }}/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization)." -如果站点管理员只阻止强制推送到默认分支，您仍然可以为任何其他受保护分支启用强制推送。{% endif %} +If a site administrator has blocked force pushes to the default branch only, you can still enable force pushes for any other protected branch.{% endif %} {% data reusables.repositories.protected-branches-options %} -### 启用强制推送 +### Enabling force pushes {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.repositories.repository-branches %} {% data reusables.repositories.add-branch-protection-rules %} -6. 在“Rules applied to everyone including administrators（适用于包括管理员在内的所有人规则）”下，选择 **Allow force pushes（允许强制推送）**。 ![允许强制推送选项](/assets/images/help/repository/allow-force-pushes.png) -7. 单击 **Create（创建）**。 +6. Under "Rules applied to everyone including administrators", select **Allow force pushes**. +![Allow force pushes option](/assets/images/help/repository/allow-force-pushes.png) +7. Click **Create**. diff --git a/translations/zh-CN/content/github/administering-a-repository/index.md b/translations/zh-CN/content/github/administering-a-repository/index.md index 696ac81d1956..193dfab3cb62 100644 --- a/translations/zh-CN/content/github/administering-a-repository/index.md +++ b/translations/zh-CN/content/github/administering-a-repository/index.md @@ -27,6 +27,7 @@ versions: {% link_in_list /managing-the-forking-policy-for-your-repository %} + {% link_in_list /configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository %} {% link_in_list /disabling-or-limiting-github-actions-for-a-repository %} {% link_in_list /managing-git-lfs-objects-in-archives-of-your-repository %} {% link_in_list /enabling-anonymous-git-read-access-for-a-repository %} @@ -41,8 +42,8 @@ versions: {% link_in_list /restoring-a-deleted-repository %} {% topic_link_in_list /managing-branches-in-your-repository %} - {% link_in_list /setting-the-default-branch %} {% link_in_list /viewing-branches-in-your-repository %} + {% link_in_list /changing-the-default-branch %} {% link_in_list /deleting-and-restoring-branches-in-a-pull-request %} {% topic_link_in_list /configuring-pull-request-merges %} {% link_in_list /about-merge-methods-on-github %} diff --git a/translations/zh-CN/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot.md b/translations/zh-CN/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot.md index aadbfbcf7506..b385d10d4c78 100644 --- a/translations/zh-CN/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot.md +++ b/translations/zh-CN/content/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot.md @@ -9,7 +9,7 @@ versions: ### 关于操作的 {% data variables.product.prodname_dependabot_version_updates %} -操作通常使用漏洞修复和新功能进行更新，以使自动化流程更可靠、更快速、更安全。 为 {% data variables.product.prodname_actions %} 启用 {% data variables.product.prodname_dependabot_version_updates %} 时，{% data variables.product.prodname_dependabot %} 将帮助确保仓库 *workflow.yml* 文件中操作的引用保持最新。 对于文件中的每个操作，{% data variables.product.prodname_dependabot_short %} 根据最新版本检查操作的引用（通常是与操作关联的版本号或提交标识符）。 如果操作有更新的版本，{% data variables.product.prodname_dependabot_short %} 将向您发送拉取请求，要求将工作流程文件中的引用更新到最新版本。 有关 {% data variables.product.prodname_dependabot_version_updates %} 的更多信息，请参阅“[关于 {% data variables.product.prodname_dependabot_version_updates %}](/github/administering-a-repository/about-github-dependabot-version-updates)”。 有关为 {% data variables.product.prodname_actions %} 配置工作流程的更多信息，请参阅“[配置工作流程](/actions/configuring-and-managing-workflows/configuring-a-workflow)”。 +操作通常使用漏洞修复和新功能进行更新，以使自动化流程更可靠、更快速、更安全。 为 {% data variables.product.prodname_actions %} 启用 {% data variables.product.prodname_dependabot_version_updates %} 时，{% data variables.product.prodname_dependabot %} 将帮助确保仓库 *workflow.yml* 文件中操作的引用保持最新。 对于文件中的每个操作，{% data variables.product.prodname_dependabot_short %} 根据最新版本检查操作的引用（通常是与操作关联的版本号或提交标识符）。 如果操作有更新的版本，{% data variables.product.prodname_dependabot_short %} 将向您发送拉取请求，要求将工作流程文件中的引用更新到最新版本。 有关 {% data variables.product.prodname_dependabot_version_updates %} 的更多信息，请参阅“[关于 {% data variables.product.prodname_dependabot_version_updates %}](/github/administering-a-repository/about-github-dependabot-version-updates)”。 For more information about configuring workflows for {% data variables.product.prodname_actions %}, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." ### 为操作启用 {% data variables.product.prodname_dependabot_version_updates %} diff --git a/translations/zh-CN/content/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository.md b/translations/zh-CN/content/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository.md index fc52191ea41a..8230d8d4dfb7 100644 --- a/translations/zh-CN/content/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository.md +++ b/translations/zh-CN/content/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository.md @@ -1,21 +1,21 @@ --- -title: Managing Git LFS objects in archives of your repository -shortTitle: 'Managing {% data variables.large_files.product_name_short %} objects in archives' -intro: 'You can choose whether {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in source code archives, such as ZIP files and tarballs, {% data variables.product.product_name %} creates for your repository.' -permissions: 'People with admin permissions for a repository can manage whether {% data variables.large_files.product_name_short %} objects are included in archives of the repository.' +title: 管理仓库存档中的 Git LFS 对象 +shortTitle: '管理存档中的 {% data variables.large_files.product_name_short %} 对象' +intro: '您可以选择是否将 {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) 对象包含在源代码存档（例如 {% data variables.product.product_name %} 为仓库创建的 ZIP 文件和 tarball）中。' +permissions: '对仓库具有管理员权限的人可以管理是否将 {% data variables.large_files.product_name_short %} 对象包含在仓库的存档中。' versions: free-pro-team: '*' enterprise-server: '=>2.23' --- -### About {% data variables.large_files.product_name_short %} objects in archives +### 关于存档中的 {% data variables.large_files.product_name_short %} 对象 -{% data variables.product.product_name %} creates source code archives of your repository in the form of ZIP files and tarballs. People can download these archives on the main page of your repository or as release assets. By default, {% data variables.large_files.product_name_short %} objects are not included in these archives, only the pointer files to these objects. To improve the usability of archives for your repository, you can choose to include the {% data variables.large_files.product_name_short %} objects instead. +{% data variables.product.product_name %} 以 ZIP 文件和 tarball 的形式创建仓库的源代码存档。 用户可以在您仓库的主页上下载这些存档或者将其作为发行版资产。 默认情况下，{% data variables.large_files.product_name_short %} 对象不会包含在这些存档中，只有这些对象的指针文件包含在其中。 为了提高仓库存档的可用性，您可以选择包含 {% data variables.large_files.product_name_short %} 对象。 -If you choose to include {% data variables.large_files.product_name_short %} objects in archives of your repository, every download of those archives will count towards bandwidth usage for your account. Each account receives {% data variables.large_files.initial_bandwidth_quota %} per month of bandwidth for free, and you can pay for additional usage. For more information, see "[About storage and bandwidth usage](/github/managing-large-files/about-storage-and-bandwidth-usage)" and "[Managing billing for {% data variables.large_files.product_name_long %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-git-large-file-storage)." +如果您选择在仓库存档中包含 {% data variables.large_files.product_name_short %} 对象，则每次下载这些存档都会计入您帐户的带宽使用量。 每个帐户每月免费获得 {% data variables.large_files.initial_bandwidth_quota %} 的带宽，您可以付费获得额外用量。 更多信息请参阅“[关于存储和带宽使用](/github/managing-large-files/about-storage-and-bandwidth-usage)”和“[管理 {% data variables.large_files.product_name_long %} 的计费](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-git-large-file-storage)”。 -### Managing {% data variables.large_files.product_name_short %} objects in archives +### 管理存档中的 {% data variables.large_files.product_name_short %} 对象 {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} -3. Under "Archives", select or deselect **Include {% data variables.large_files.product_name_short %} objects in archives**. ![Checkbox to include {% data variables.large_files.product_name_short %} objects in archives](/assets/images/help/repository/include-git-lfs-objects-checkbox.png) +3. 在“Archives（存档）”下，选择或取消选择**在存档中包含 {% data variables.large_files.product_name_short %} 对象**。 ![在存档中包含 {% data variables.large_files.product_name_short %} 对象的复选框](/assets/images/help/repository/include-git-lfs-objects-checkbox.png) diff --git a/translations/zh-CN/content/github/administering-a-repository/managing-pull-requests-for-dependency-updates.md b/translations/zh-CN/content/github/administering-a-repository/managing-pull-requests-for-dependency-updates.md index 6b91f447eaad..33e5f55c74ed 100644 --- a/translations/zh-CN/content/github/administering-a-repository/managing-pull-requests-for-dependency-updates.md +++ b/translations/zh-CN/content/github/administering-a-repository/managing-pull-requests-for-dependency-updates.md @@ -9,7 +9,7 @@ versions: ### 关于 {% data variables.product.prodname_dependabot %} 拉取请求 -{% data variables.product.prodname_dependabot %} 提出拉取请求，以更新依赖项。 Depending on how your repository is configured, {% data variables.product.prodname_dependabot_short %} may raise pull requests for version updates and/or for security updates. 您可以按与任何其他拉取请求相同的方式管理这些拉取请求，但也有一些额外的可用命令。 有关启用 {% data variables.product.prodname_dependabot %} 依赖项更新的更多信息，请参阅“[配置 {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)”和“[启用和禁用版本更新](/github/administering-a-repository/enabling-and-disabling-version-updates)”。 +{% data variables.product.prodname_dependabot %} 提出拉取请求，以更新依赖项。 {% data variables.product.prodname_dependabot_short %} 可能会针对版本更新和/或安全更新提出拉取请求，具体取决于仓库的配置方式。 您可以按与任何其他拉取请求相同的方式管理这些拉取请求，但也有一些额外的可用命令。 有关启用 {% data variables.product.prodname_dependabot %} 依赖项更新的更多信息，请参阅“[配置 {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)”和“[启用和禁用版本更新](/github/administering-a-repository/enabling-and-disabling-version-updates)”。 当 {% data variables.product.prodname_dependabot %} 提出拉取请求时，将以您为仓库选择的方式通知您。 每个拉取请求都包含关于来自包管理系统的拟议变更的详细信息。 这些拉取请求将遵循仓库中定义的正常检查和测试。 此外，如果有足够的信息，您将看到兼容性分数。 这也有助于您决定是否合并变更。 有关此分数的信息，请参阅“[配置 {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)”。 @@ -20,7 +20,7 @@ versions: {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-pr %} 1. 安全和版本更新的任何拉取请求都很容易识别。 - - The author is [dependabot](https://github.com/dependabot), the bot account used by {% data variables.product.prodname_dependabot %}. + - 作者为 [dependabot](https://github.com/dependabot)，即 {% data variables.product.prodname_dependabot %} 使用的自动程序帐户。 - 默认情况下，它们拥有 `dependencies` 标签。 ### 更改 {% data variables.product.prodname_dependabot %} 拉取请求的变基策略 diff --git a/translations/zh-CN/content/github/administering-a-repository/managing-releases-in-a-repository.md b/translations/zh-CN/content/github/administering-a-repository/managing-releases-in-a-repository.md index c43785c94e35..024e9b0ddd20 100644 --- a/translations/zh-CN/content/github/administering-a-repository/managing-releases-in-a-repository.md +++ b/translations/zh-CN/content/github/administering-a-repository/managing-releases-in-a-repository.md @@ -8,24 +8,25 @@ redirect_from: - /articles/managing-releases-in-a-repository - /github/administering-a-repository/creating-releases - /github/administering-a-repository/editing-and-deleting-releases -permissions: 仓库协作者以及对仓库具有写入权限的人员可以创建、编辑和删除发行版。 +permissions: '仓库协作者以及对仓库具有写入权限的人员可以创建、编辑和删除发行版。' versions: free-pro-team: '*' enterprise-server: '*' --- -### About release management +### 关于发行版管理 -您也可以在 {% data variables.product.prodname_marketplace %} 中从特定的发行版发布操作。 更多信息请参阅“[在 {% data variables.product.prodname_marketplace %} 中发布操作](/actions/creating-actions/publishing-actions-in-github-marketplace)”。 +您也可以在 {% data variables.product.prodname_marketplace %} 中从特定的发行版发布操作。 更多信息请参阅“在 {% data variables.product.prodname_marketplace %} 中发布操作”。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -You can choose whether {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in the ZIP files and tarballs that {% data variables.product.product_name %} creates for each release. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)." +You can choose whether +{% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in the ZIP files and tarballs that {% data variables.product.product_name %} creates for each release. 更多信息请参阅“[管理仓库存档中的 {% data variables.large_files.product_name_short %} 对象](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)”。 {% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} {% tip %} -**Tip**: You can also manage releases using the {% data variables.product.prodname_cli %}. For more information, see "[`gh release`](https://cli.github.com/manual/gh_release)" in the {% data variables.product.prodname_cli %} documentation. +**提示**：您也可以使用 {% data variables.product.prodname_cli %} 管理发行版。 更多信息请参阅 {% data variables.product.prodname_cli %} 文档中的“[`gh 发行版`](https://cli.github.com/manual/gh_release)”。 {% endtip %} {% endif %} @@ -42,7 +43,7 @@ You can choose whether {% data variables.large_files.product_name_long %} ({% da 8. 要通知用户发行版本尚不可用于生产，可能不稳定，请选择 **This is a pre-release（这是预发布）**。 ![将版本标记为预发行版的复选框](/assets/images/help/releases/prerelease_checkbox.png) 9. 如果您准备推广您的发行版，请单击 **Publish release（发布版本）**。 要在以后处理该发行版，请单击 **Save draft（保存草稿）**。 ![发布版本和草拟发行版按钮](/assets/images/help/releases/release_buttons.png) -您也可以从命令行或脚本自动创建发行版。 更多信息请参阅“[发行版](/v3/repos/releases/#create-a-release)”。 +您也可以从命令行或脚本自动创建发行版。 更多信息请参阅“[发行版](/rest/reference/repos/#create-a-release)”。 ### 编辑发行版 diff --git a/translations/zh-CN/content/github/administering-a-repository/managing-repository-settings.md b/translations/zh-CN/content/github/administering-a-repository/managing-repository-settings.md index 184c1aad7de5..ad37c5f1063d 100644 --- a/translations/zh-CN/content/github/administering-a-repository/managing-repository-settings.md +++ b/translations/zh-CN/content/github/administering-a-repository/managing-repository-settings.md @@ -1,6 +1,6 @@ --- title: 管理仓库设置 -intro: 仓库管理员和组织所有者可以更改多项设置，包括仓库的名称和所有权，以及仓库的公有或私有可见性。 他们还可以删除仓库。 +intro: '仓库管理员和组织所有者可以更改多项设置，包括仓库的名称和所有权，以及仓库的公有或私有可见性。 他们还可以删除仓库。' mapTopic: true redirect_from: - /articles/managing-repository-settings diff --git a/translations/zh-CN/content/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository.md b/translations/zh-CN/content/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository.md index 3f0191ce2626..bd6e7acafbd3 100644 --- a/translations/zh-CN/content/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository.md +++ b/translations/zh-CN/content/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository.md @@ -28,7 +28,7 @@ versions: {% note %} -Organization owners and repository administrators can only grant access to view {% data variables.product.prodname_dependabot_alerts %} to people or teams who have write access to the repo. +组织所有者和仓库管理员只能将查看 {% data variables.product.prodname_dependabot_alerts %} 的权限授予对仓库有写入权限的人员或团队。 {% endnote %} @@ -47,5 +47,5 @@ Organization owners and repository administrators can only grant access to view ### 延伸阅读 -- "[About securing your repository](/github/administering-a-repository/about-securing-your-repository)" +- “[关于保护仓库](/github/administering-a-repository/about-securing-your-repository)” - “[管理组织的安全性和分析设置](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization)” diff --git a/translations/zh-CN/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md b/translations/zh-CN/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md index dcef8ce69f37..65201c4e7e8a 100644 --- a/translations/zh-CN/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md +++ b/translations/zh-CN/content/github/administering-a-repository/managing-the-automatic-deletion-of-branches.md @@ -5,7 +5,7 @@ redirect_from: - /articles/managing-the-automatic-deletion-of-branches versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- 对仓库具有管理员权限的任何人都可启用或禁用分支的自动删除。 diff --git a/translations/zh-CN/content/github/administering-a-repository/managing-the-forking-policy-for-your-repository.md b/translations/zh-CN/content/github/administering-a-repository/managing-the-forking-policy-for-your-repository.md index 9bafd85b640b..3a1d14ebe5b6 100644 --- a/translations/zh-CN/content/github/administering-a-repository/managing-the-forking-policy-for-your-repository.md +++ b/translations/zh-CN/content/github/administering-a-repository/managing-the-forking-policy-for-your-repository.md @@ -1,6 +1,6 @@ --- title: 管理仓库的复刻政策 -intro: '您可以允许或阻止对组织拥有的特定私有{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}或内部{% endif %}仓库进行复刻。' +intro: 'You can allow or prevent the forking of a specific private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %} repository owned by an organization.' redirect_from: - /articles/allowing-people-to-fork-a-private-repository-owned-by-your-organization - /github/administering-a-repository/allowing-people-to-fork-a-private-repository-owned-by-your-organization @@ -10,7 +10,7 @@ versions: enterprise-server: '*' --- -组织所有者必须在组织级别上允许复刻私有{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}和内部{% endif %}仓库，然后才能允许或禁止对特定仓库进行复刻。 更多信息请参阅“[管理组织的复刻政策](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization)”。 +An organization owner must allow forks of private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and internal{% endif %} repositories on the organization level before you can allow or disallow forks for a specific repository. 更多信息请参阅“[管理组织的复刻政策](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization)”。 {% data reusables.organizations.internal-repos-enterprise %} diff --git a/translations/zh-CN/content/github/administering-a-repository/releasing-projects-on-github.md b/translations/zh-CN/content/github/administering-a-repository/releasing-projects-on-github.md index 2e23f3ac6c77..f8d8807da4f6 100644 --- a/translations/zh-CN/content/github/administering-a-repository/releasing-projects-on-github.md +++ b/translations/zh-CN/content/github/administering-a-repository/releasing-projects-on-github.md @@ -1,6 +1,6 @@ --- title: 在 GitHub 上发布项目 -intro: 您可以创建发行版以打包软件、发行说明和二进制文件，供他人下载。 +intro: '您可以创建发行版以打包软件、发行说明和二进制文件，供他人下载。' mapTopic: true redirect_from: - /categories/85/articles/ diff --git a/translations/zh-CN/content/github/administering-a-repository/restoring-a-deleted-repository.md b/translations/zh-CN/content/github/administering-a-repository/restoring-a-deleted-repository.md index 75e653598602..c1546ad3a1fa 100644 --- a/translations/zh-CN/content/github/administering-a-repository/restoring-a-deleted-repository.md +++ b/translations/zh-CN/content/github/administering-a-repository/restoring-a-deleted-repository.md @@ -17,7 +17,7 @@ versions: 仓库被删除后，可能需要一个小时才能恢复。 -恢复仓库不会恢复发行版附件或团队权限。 Issues that are restored will not be labeled. +恢复仓库不会恢复发行版附件或团队权限。 已恢复的议题不会被标记。 ### 恢复用户帐户所拥有的已删除仓库 diff --git a/translations/zh-CN/content/github/administering-a-repository/setting-repository-visibility.md b/translations/zh-CN/content/github/administering-a-repository/setting-repository-visibility.md index e9b3400f6284..4a7f7fc1e309 100644 --- a/translations/zh-CN/content/github/administering-a-repository/setting-repository-visibility.md +++ b/translations/zh-CN/content/github/administering-a-repository/setting-repository-visibility.md @@ -19,16 +19,16 @@ versions: #### 将仓库设为私有 - * {% data variables.product.prodname_dotcom %} 将会分离公共仓库的公共复刻并将其放入新的网络中。 公共复刻无法设为私有。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}如果将仓库的可见性从内部更改为私有，{% data variables.product.prodname_dotcom %} 将删除属于无法访问新私有仓库的任何用户的复刻。{% endif %}更多信息请参阅“[删除仓库或更改其可见性时，复刻会发生什么变化？](/articles/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility#changing-a-public-repository-to-a-private-repository)” - {% if currentVersion == "free-pro-team@latest" %}* 如果对用户帐户或组织使用 {% data variables.product.prodname_free_user %}，有些功能在您将可见性更改为私有后不可用于仓库。 {% data reusables.gated-features.more-info %} + * {% data variables.product.prodname_dotcom %} 将会分离公共仓库的公共复刻并将其放入新的网络中。 公共复刻无法设为私有。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}If you change a repository's visibility from internal to private, {% data variables.product.prodname_dotcom %} will remove forks that belong to any user without access to the newly private repository.{% endif %} For more information, see "[What happens to forks when a repository is deleted or changes visibility?](/articles/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility#changing-a-public-repository-to-a-private-repository)" + {% if currentVersion == "free-pro-team@latest" %}* If you're using {% data variables.product.prodname_free_user %} for user accounts or organizations, some features won't be available in the repository after you change the visibility to private. {% data reusables.gated-features.more-info %} * 任何已发布的 {% data variables.product.prodname_pages %} 站点都将自动取消发布。 如果您将自定义域添加到 {% data variables.product.prodname_pages %} 站点，应在将仓库设为私有之前删除或更新 DNS 记录，以避免域接管的风险。 更多信息请参阅“[管理 {% data variables.product.prodname_pages %} 网站的自定义域](/articles/managing-a-custom-domain-for-your-github-pages-site)。 * {% data variables.product.prodname_dotcom %} 不再在 {% data variables.product.prodname_archive %} 中包含该仓库。 更多信息请参阅“[关于在 {% data variables.product.prodname_dotcom %}](/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github#about-the-github-archive-program) 上存档内容和数据”。{% endif %} - {% if currentVersion != "free-pro-team@latest" %}* 匿名 Git 读取权限不再可用。 更多信息请参阅“[为仓库启用匿名 Git 读取权限](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)”。{% endif %} + {% if currentVersion != "free-pro-team@latest" %}* Anonymous Git read access is no longer available. For more information, see "[Enabling anonymous Git read access for a repository](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)."{% endif %} #### 将仓库设为公共 * {% data variables.product.prodname_dotcom %} 将会分离私有复刻并将它们变成独立的私有仓库。 更多信息请参阅“[删除仓库或更改其可见性时，复刻会发生什么变化？](/articles/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility#changing-a-private-repository-to-a-public-repository)” - * 如果您将私有仓库转换为公共仓库作为转向创建开源项目的组成部分， 请参阅[开源指南](http://opensource.guide)以获得有用的提示和指导。{% if currentVersion == "free-pro-team@latest" %} 您还可以通过 [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}) 参加有关管理开源项目的免费课程。 您的仓库设为公共后，您还可以查看仓库的社区资料以了解项目是否符合支持贡献者的最佳做法。 更多信息请参阅“[查看您的社区资料](/articles/viewing-your-community-profile)”。{% endif %} + * If you're converting your private repository to a public repository as part of a move toward creating an open source project, see the [Open Source Guides](http://opensource.guide) for helpful tips and guidelines.{% if currentVersion == "free-pro-team@latest" %} You can also take a free course on managing an open source project with [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}). 您的仓库设为公共后，您还可以查看仓库的社区资料以了解项目是否符合支持贡献者的最佳做法。 更多信息请参阅“[查看您的社区资料](/articles/viewing-your-community-profile)”。{% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} @@ -49,19 +49,19 @@ versions: {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} -3. Under "Danger Zone", next to "Make this repository private", click **Make private**. ![设为私有按钮](/assets/images/help/repository/repo-makeprivate.png) +3. 在“Danger Zone（危险区域）”下“Make this repository private（将此仓库设为私有）”旁边，单击 **Make private（设为私有）**。 ![设为私有按钮](/assets/images/help/repository/repo-makeprivate.png) 4. 阅读关于将仓库设为私有的警告。 ![警告弹出窗口](/assets/images/help/repository/repo-privateconfirm.png) 5. 输入您要设为私有的仓库的名称，例如 `accountname/reponame`。 -6. Click **I understand, make this repository private**. +6. 单击 **I understand, make this repository private（我已了解，请将此仓库设为私有）**。 ### 将仓库设为公共 {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} -3. Under "Danger Zone", next to "Make this repository public", click **Make public**. ![设为公共按钮](/assets/images/help/repository/repo-makepublic.png) +3. 在“Danger Zone（危险区域）”下“Make this repository public（将此仓库设为公共）”旁边，单击 **Make public（设为公共）**。 ![设为公共按钮](/assets/images/help/repository/repo-makepublic.png) 4. 阅读关于将仓库设为公共的警告。 ![含有将私有仓库设为公共相关信息的弹出窗口](/assets/images/help/repository/repo-publicconfirm.png) 5. 输入您要设为公共的仓库的名称，例如 `accountname/reponame`。 -6. Click **I understand, make this repository public**. +6. 单击 **I understand, make this repository public（我已了解，请将此仓库设为公共）**。 {% if currentVersion ver_gt "enterprise-server@2.19" %} ### 将仓库设为内部 @@ -70,10 +70,10 @@ versions: {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} -3. Under "Danger Zone", next to "Make this repository internal", click **Make internal**. ![设为内部按钮](/assets/images/help/repository/repo-makeinternal.png) +3. 在“Danger Zone（危险区域）”下“Make this repository internal（将此仓库设为内部）”旁边，单击 **Make internal（设为内部）**。 ![设为内部按钮](/assets/images/help/repository/repo-makeinternal.png) 4. 阅读关于将仓库设为内部的警告。 ![警告弹出窗口](/assets/images/help/repository/repo-internalconfirm.png) 5. 输入您要设为内部的仓库的名称，例如 `accountname/reponame`。 -6. Click **I understand, make this repository internal**. +6. 单击 **I understand, make this repository internal（我已了解，请将此仓库设为内部）**。 {% endif %} {% endif %} diff --git a/translations/zh-CN/content/github/administering-a-repository/transferring-a-repository.md b/translations/zh-CN/content/github/administering-a-repository/transferring-a-repository.md index 67bd421c1221..48c5add2003c 100644 --- a/translations/zh-CN/content/github/administering-a-repository/transferring-a-repository.md +++ b/translations/zh-CN/content/github/administering-a-repository/transferring-a-repository.md @@ -21,14 +21,14 @@ versions: 当您将仓库转让给新所有者时，他们可以立即管理仓库的内容、议题、拉取请求、版本、项目板和设置。 -仓库转让的前提条件： {% if currentVersion == "free-pro-team@latest" %} +Prerequisites for repository transfers: {% if currentVersion == "free-pro-team@latest" %} - 当您将拥有的仓库转让给另一个用户帐户时，新所有者将收到一封确认电子邮件。 确认电子邮件包括接受转让的说明。 如果新所有者在一天之内没有接受转让，则邀请将过期。{% endif %} - 要将您拥有的仓库转让给一个组织，您必须拥有在目标组织中创建仓库的权限。 - 目标帐户不得具有相同名称的仓库，或位于同一网络中的复刻。 - 仓库原来的所有者将添加为已转让仓库的协作者。 已转让仓库的其他协作者保持不变。 - 私有复刻无法进行转让。 -{% if currentVersion == "free-pro-team@latest" %}如果您将私有仓库转让给 {% data variables.product.prodname_free_user %} 用户或组织帐户，该仓库将无法访问比如受保护分支和 {% data variables.product.prodname_pages %} 之类的功能。 {% data reusables.gated-features.more-info %}{% endif %} +{% if currentVersion == "free-pro-team@latest" %}If you transfer a private repository to a {% data variables.product.prodname_free_user %} user or organization account, the repository will lose access to features like protected branches and {% data variables.product.prodname_pages %}. {% data reusables.gated-features.more-info %}{% endif %} #### 随仓库一起转让的有哪些内容？ @@ -36,7 +36,7 @@ versions: - 如果转让的仓库是复刻，则它仍与上游仓库关联。 - 如果转让的仓库有任何复刻，则这些复刻在转让完成后仍与该仓库关联。 -- 如果转让的仓库使用 {% data variables.large_files.product_name_long %}，则所有 {% data variables.large_files.product_name_short %} 对象均自动移动。 此转让在后台进行，因此如果您有大量的 {% data variables.large_files.product_name_short %} 对象或者如果 {% data variables.large_files.product_name_short %} 对象本身很大，则进行转让可能需要一些时间。{% if currentVersion == "free-pro-team@latest" %}转让使用 {% data variables.large_files.product_name_short %} 的仓库之前，确保接收帐户有足够的数据包用来存储您将移动的 {% data variables.large_files.product_name_short %} 对象。 有关为用户帐户增加存储的更多详细，请参阅“[升级 {% data variables.large_files.product_name_long %}](/articles/upgrading-git-large-file-storage)”。{% endif %} +- 如果转让的仓库使用 {% data variables.large_files.product_name_long %}，则所有 {% data variables.large_files.product_name_short %} 对象均自动移动。 This transfer occurs in the background, so if you have a large number of {% data variables.large_files.product_name_short %} objects or if the {% data variables.large_files.product_name_short %} objects themselves are large, it may take some time for the transfer to occur.{% if currentVersion == "free-pro-team@latest" %} Before you transfer a repository that uses {% data variables.large_files.product_name_short %}, make sure the receiving account has enough data packs to store the {% data variables.large_files.product_name_short %} objects you'll be moving over. 有关为用户帐户增加存储的更多详细，请参阅“[升级 {% data variables.large_files.product_name_long %}](/articles/upgrading-git-large-file-storage)”。{% endif %} - 仓库在两个用户帐户之间转让时，议题分配保持不变。 当您将仓库从用户帐户转让给组织时，分配给组织中该成员的议题保持不变，所有其他议题受理人都将被清除。 只允许组织中的所有者创建新的议题分配。 当您将仓库从组织转让给用户帐户时，只有分配给仓库所有者的议题保留，所有其他议题受理人都将被清除。 - 如果转让的仓库包含 {% data variables.product.prodname_pages %} 站点，则指向 Web 上 Git 仓库和通过 Git 活动的链接将重定向。 不过，我们不会重定向与仓库关联的 {% data variables.product.prodname_pages %}。 - 指向以前仓库位置的所有链接均自动重定向到新位置。 当您对转让的仓库使用 `git clone`、`git fetch` 或 `git push` 时，这些命令将重定向到新仓库位置或 URL。 不过，为了避免混淆，我们强烈建议将任何现有的本地克隆副本更新为指向新仓库 URL。 您可以通过在命令行中使用 `git remote` 来执行此操作： @@ -57,7 +57,7 @@ versions: 您可以将仓库转让给接受仓库转让的任何用户帐户。 在两个用户帐户之间转让仓库时，原来的仓库所有者和协作者将自动添加为新仓库的协作者。 -{% if currentVersion == "free-pro-team@latest" %}如果您在私有仓库中发布了 {% data variables.product.prodname_pages %} 站点并添加了自定义域，则转让仓库之前，您可能想要删除或更新 DNS 记录以避免域接管风险。 更多信息请参阅“[管理 {% data variables.product.prodname_pages %} 网站的自定义域](/articles/managing-a-custom-domain-for-your-github-pages-site)。{% endif %} +{% if currentVersion == "free-pro-team@latest" %}If you published a {% data variables.product.prodname_pages %} site in a private repository and added a custom domain, before transferring the repository, you may want to remove or update your DNS records to avoid the risk of a domain takeover. 更多信息请参阅“[管理 {% data variables.product.prodname_pages %} 网站的自定义域](/articles/managing-a-custom-domain-for-your-github-pages-site)。{% endif %} {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} diff --git a/translations/zh-CN/content/github/administering-a-repository/viewing-deployment-activity-for-your-repository.md b/translations/zh-CN/content/github/administering-a-repository/viewing-deployment-activity-for-your-repository.md index 866ac0683728..a8fddc6991c2 100644 --- a/translations/zh-CN/content/github/administering-a-repository/viewing-deployment-activity-for-your-repository.md +++ b/translations/zh-CN/content/github/administering-a-repository/viewing-deployment-activity-for-your-repository.md @@ -14,7 +14,7 @@ versions: {% endnote %} -如果仓库的部署工作流程通过 Deployments API 或来自 [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace/category/deployment) 的应用程序与 {% data variables.product.product_name %} 集成，则具有读取权限的人员可以查看所有当前部署的概览以及过去部署活动的日志。 更多信息请参阅“[部署](/v3/repos/deployments/)”。 +如果仓库的部署工作流程通过 Deployments API 或来自 [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace/category/deployment) 的应用程序与 {% data variables.product.product_name %} 集成，则具有读取权限的人员可以查看所有当前部署的概览以及过去部署活动的日志。 更多信息请参阅“[部署](/rest/reference/repos#deployments)”。 您还可以在拉取请求的“Conversation（对话）”选项卡中查看部署信息。 diff --git a/translations/zh-CN/content/github/administering-a-repository/viewing-your-repositorys-releases-and-tags.md b/translations/zh-CN/content/github/administering-a-repository/viewing-your-repositorys-releases-and-tags.md index b1912b04524d..39e406876ba7 100644 --- a/translations/zh-CN/content/github/administering-a-repository/viewing-your-repositorys-releases-and-tags.md +++ b/translations/zh-CN/content/github/administering-a-repository/viewing-your-repositorys-releases-and-tags.md @@ -13,7 +13,7 @@ versions: {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} {% tip %} -**Tip**: You can also view a release using the {% data variables.product.prodname_cli %}. For more information, see "[`gh release view`](https://cli.github.com/manual/gh_release_view)" in the {% data variables.product.prodname_cli %} documentation. +**提示**：您也可以使用 {% data variables.product.prodname_cli %} 查看发行版。 更多信息请参阅 {% data variables.product.prodname_cli %} 文档中的“[`gh 发行版视图`](https://cli.github.com/manual/gh_release_view)”。 {% endtip %} {% endif %} diff --git a/translations/zh-CN/content/github/authenticating-to-github/about-authentication-to-github.md b/translations/zh-CN/content/github/authenticating-to-github/about-authentication-to-github.md index 7b52ac40549c..ff4b5d2c96f4 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/about-authentication-to-github.md +++ b/translations/zh-CN/content/github/authenticating-to-github/about-authentication-to-github.md @@ -16,7 +16,6 @@ versions: - 个人访问令牌 - SSH 密钥 - ### 在浏览器中进行身份验证 您可以在浏览器中以不同方式向 {% data variables.product.product_name %} 验证。 @@ -50,4 +49,4 @@ versions: * 您可以通过 SSH 处理 {% data variables.product.product_name %} 上的所有仓库，尽管防火墙和代理可能拒绝允许 SSH 连接。 使用 SSH 需要在本地计算机上生成 SSH 公钥/私密对，并将公钥添加到 {% data variables.product.product_name %} 帐户。 除非您已[存储密钥](/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent#adding-your-ssh-key-to-the-ssh-agent)，否则每次使用 Git 向 {% data variables.product.product_name %} 验证时，系统都会提示您输入 SSH 密钥密码短语。 更多信息请参阅“[生成新的 SSH 密钥并添加到 ssh-agent](/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)”。 -{% if currentVersion == "free-pro-team@latest" %}要使用个人访问令牌或 SSH 密钥访问由使用 SAML 单点登录的组织所拥有的资源，还必须授权个人令牌或 SSH 密钥。 更多信息请参阅“[授权个人访问令牌用于 SAML 单点登录](/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on)”或“[授权 SSH 密钥用于 SAML 单点登录](/github/authenticating-to-github/authorizing-an-ssh-key-for-use-with-saml-single-sign-on)”。{% endif %} +{% if currentVersion == "free-pro-team@latest" %}To use a personal access token or SSH key to access resources owned by an organization that uses SAML single sign-on, you must also authorize the personal token or SSH key. 更多信息请参阅“[授权个人访问令牌用于 SAML 单点登录](/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on)”或“[授权 SSH 密钥用于 SAML 单点登录](/github/authenticating-to-github/authorizing-an-ssh-key-for-use-with-saml-single-sign-on)”。{% endif %} diff --git a/translations/zh-CN/content/github/authenticating-to-github/about-authentication-with-saml-single-sign-on.md b/translations/zh-CN/content/github/authenticating-to-github/about-authentication-with-saml-single-sign-on.md index 35a2fad574a1..ac8652a2df19 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/about-authentication-with-saml-single-sign-on.md +++ b/translations/zh-CN/content/github/authenticating-to-github/about-authentication-with-saml-single-sign-on.md @@ -1,6 +1,6 @@ --- title: 关于使用 SAML 单点登录进行身份验证 -intro: 您可以通过身份提供程序 (IdP) 验证来访问使用 SAML 单点登录 (SSO) 的组织。 要在组织实施 SAML SSO 时使用命令行上的 API 或 Git 进行身份验证，您必须授权个人访问令牌或 SSH 密钥。 +intro: '您可以通过身份提供程序 (IdP) 验证来访问使用 SAML 单点登录 (SSO) 的组织。 要在组织实施 SAML SSO 时使用命令行上的 API 或 Git 进行身份验证，您必须授权个人访问令牌或 SSH 密钥。' product: '{% data reusables.gated-features.saml-sso %}' redirect_from: - /articles/about-authentication-with-saml-single-sign-on diff --git a/translations/zh-CN/content/github/authenticating-to-github/about-commit-signature-verification.md b/translations/zh-CN/content/github/authenticating-to-github/about-commit-signature-verification.md index 4a1e9d5b4e89..d023fe0414aa 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/about-commit-signature-verification.md +++ b/translations/zh-CN/content/github/authenticating-to-github/about-commit-signature-verification.md @@ -1,6 +1,6 @@ --- title: 关于提交签名验证 -intro: '使用 GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} 或 S/MIME{% endif %} 可在本地签名标记并提交。 这些标记或提交在 {% data variables.product.product_name %} 上标示为已验证，便于其他人信任更改来自可信的来源。' +intro: 'Using GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} or S/MIME{% endif %}, you can sign tags and commits locally. 这些标记或提交在 {% data variables.product.product_name %} 上标示为已验证，便于其他人信任更改来自可信的来源。' redirect_from: - /articles/about-gpg-commit-and-tag-signatures/ - /articles/about-gpg/ @@ -22,7 +22,7 @@ versions: 您可以在 {% data variables.product.product_name %} 上检查已签名提交或标记的验证状态，并查看提交签名未验证的原因。 更多信息请参阅“[检查提交和标记签名验证状态](/articles/checking-your-commit-and-tag-signature-verification-status)”。 -{% if currentVersion == "free-pro-team@latest" %} {% data variables.product.product_name %} 将自动使用 GPG 通过 {% data variables.product.product_name %} web 界面对您创建的提交进行签名，当您压缩且合并您不是其作者的拉取请求时除外。 由 {% data variables.product.product_name %} 签名的提交在 {% data variables.product.product_name %} 上将具有已验证的状态。 您可以使用 https://github.com/web-flow.gpg 上的公钥本地验证签名。{% endif %} +{% if currentVersion == "free-pro-team@latest" %} {% data variables.product.product_name %} will automatically use GPG to sign commits you make using the {% data variables.product.product_name %} web interface, except for when you squash and merge a pull request that you are not the author of. 由 {% data variables.product.product_name %} 签名的提交在 {% data variables.product.product_name %} 上将具有已验证的状态。 您可以使用 https://github.com/web-flow.gpg 上的公钥本地验证签名。{% endif %} ### GPG 提交签名验证 @@ -59,8 +59,9 @@ versions: ### 自动程序的签名验证 需要提交签名的组织和 {% data variables.product.prodname_github_app %} 可使用自动程序对提交签名。 如果提交或标记具有密码可验证的自动程序签名，则 {% data variables.product.product_name %} 会将提交或标记标示为已验证。 +Signature verification for bots will only work if the request is verified and authenticated as the -自动程序的签名验证仅在请求被验证为 {% data variables.product.prodname_github_app %} 或自动程序并且不含自定义作者信息、自定义提交者信息、自定义签名信息（如提交 API）时才有效。 +{% data variables.product.prodname_github_app %} or bot and contains no custom author information, custom committer information, and no custom signature information, such as Commits API. {% endif %} ### 延伸阅读 diff --git a/translations/zh-CN/content/github/authenticating-to-github/about-ssh.md b/translations/zh-CN/content/github/authenticating-to-github/about-ssh.md index 434c513d229b..9ae0d179d629 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/about-ssh.md +++ b/translations/zh-CN/content/github/authenticating-to-github/about-ssh.md @@ -10,17 +10,16 @@ versions: 在设置 SSH 时，将会[生成 SSH 密钥并将其添加到 ssh-agent](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)，然后[将该密钥添加到您的 {% data variables.product.product_name %} 帐户](/articles/adding-a-new-ssh-key-to-your-github-account)。 将 SSH 密钥添加到 ssh-agent，通过使用密码确保 SSH 密钥增加一层保护。 更多信息请参阅“[使用 SSH 密钥密码](/articles/working-with-ssh-key-passphrases)”。 -{% if currentVersion == "free-pro-team@latest" %}要对使用 SAML 单点登录的组织所拥有的仓库使用 SSH 密钥，您需要先授权。 更多信息请参阅“[授权 SSH 密钥用于 SAML 单点登录](/articles/authorizing-an-ssh-key-for-use-with-saml-single-sign-on)”。{% endif %} +{% if currentVersion == "free-pro-team@latest" %}To use your SSH key with a repository owned by an organization that uses SAML single sign-on, you'll need to authorize it first. 更多信息请参阅“[授权 SSH 密钥用于 SAML 单点登录](/articles/authorizing-an-ssh-key-for-use-with-saml-single-sign-on)”。{% endif %} 建议定期[查阅 SSH 密钥列表](/articles/reviewing-your-ssh-keys)，撤销任何无效或安全受到威胁的密钥。 {% if currentVersion == "free-pro-team@latest" %} -如果 SSH 密钥一年未使用，则作为安全预防措施，{% data variables.product.prodname_dotcom %} 会自动删除非活动的 SSH 密钥。 更多信息请参阅“[删除或缺失的 SSH 密钥](/articles/deleted-or-missing-ssh-keys)”。 +If you haven't used your SSH key for a year, then +{% data variables.product.prodname_dotcom %} will automatically delete your inactive SSH key as a security precaution. 更多信息请参阅“[删除或缺失的 SSH 密钥](/articles/deleted-or-missing-ssh-keys)”。 {% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} 如果您是提供 SSH 证书的组织成员，可以使用证书来访问组织的仓库，而无需添加证书到您的 {% data variables.product.product_name %} 帐户。 更多信息请参阅“[关于 SSH 认证中心](/articles/about-ssh-certificate-authorities)”。 -{% endif %} ### 延伸阅读 diff --git a/translations/zh-CN/content/github/authenticating-to-github/about-two-factor-authentication.md b/translations/zh-CN/content/github/authenticating-to-github/about-two-factor-authentication.md index f17f937ad22d..d5d470c445db 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/about-two-factor-authentication.md +++ b/translations/zh-CN/content/github/authenticating-to-github/about-two-factor-authentication.md @@ -1,6 +1,6 @@ --- title: 关于双重身份验证 -intro: 双重身份验证（或 2FA）是登录网站或应用时使用的额外保护层。 启用 2FA 时，必须使用您的用户名和密码登录，并提供另一种只有您知道或可以访问的身份验证形式。 +intro: '{% data reusables.two_fa.about-2fa %} With 2FA, you have to log in with your username and password and provide another form of authentication that only you know or have access to.' redirect_from: - /articles/about-two-factor-authentication versions: @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -对于 {% data variables.product.product_name %}，第二种身份验证形式是应用程序在移动设备上生成的代码{% if currentVersion == "free-pro-team@latest" %}或发送的短信 (SMS){% endif %}。 在启用 2FA 后，只要有人尝试登录您的 {% data variables.product.product_name %} 帐户，{% data variables.product.product_name %} 就会生成验证码。 别人登录您的帐户的唯一方式是知道您的密码，并且获取您的手机上的验证码。 +For {% data variables.product.product_name %}, the second form of authentication is a code that's generated by an application on your mobile device{% if currentVersion == "free-pro-team@latest" %} or sent as a text message (SMS){% endif %}. 在启用 2FA 后，只要有人尝试登录您的 {% data variables.product.product_name %} 帐户，{% data variables.product.product_name %} 就会生成验证码。 别人登录您的帐户的唯一方式是知道您的密码，并且获取您的手机上的验证码。 {% data reusables.two_fa.after-2fa-add-security-key %} @@ -34,6 +34,6 @@ versions: ### 您的组织中需要双重身份验证 -组织所有者可要求组织成员{% if currentVersion == "free-pro-team@latest" %}、帐单管理员{% endif %}和外部协作者使用双重身份验证保护其个人帐户的安全。 更多信息请参阅“[您的组织中需要双重身份验证](/articles/requiring-two-factor-authentication-in-your-organization)”。 +Organization owners can require that organization members{% if currentVersion == "free-pro-team@latest" %}, billing managers,{% endif %} and outside collaborators use two-factor authentication to secure their personal accounts. 更多信息请参阅“[您的组织中需要双重身份验证](/articles/requiring-two-factor-authentication-in-your-organization)”。 {% data reusables.two_fa.auth_methods_2fa %} diff --git a/translations/zh-CN/content/github/authenticating-to-github/accessing-github-using-two-factor-authentication.md b/translations/zh-CN/content/github/authenticating-to-github/accessing-github-using-two-factor-authentication.md index 1851052e9867..5dbd71dfcf76 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/accessing-github-using-two-factor-authentication.md +++ b/translations/zh-CN/content/github/authenticating-to-github/accessing-github-using-two-factor-authentication.md @@ -15,7 +15,7 @@ versions: ### 登录网站时提供 2FA 码 -在使用密码登录 {% data variables.product.product_name %} 后，系统会提示您提供{% if currentVersion == "free-pro-team@latest" %}短信或{% endif %} TOTP 应用程序中的验证码。 +After you sign in to {% data variables.product.product_name %} using your password, you'll be prompted to provide an authentication code from {% if currentVersion == "free-pro-team@latest" %}a text message or{% endif %} your TOTP app. {% data variables.product.product_name %} 仅在您注销后、使用新设备或会话过期时才会要求您再次提供 2FA 验证码。 diff --git a/translations/zh-CN/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md b/translations/zh-CN/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md index b1404daf3eff..75663559caad 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md +++ b/translations/zh-CN/content/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account.md @@ -80,7 +80,7 @@ versions: $ sudo apt-get install xclip # Downloads and installs xclip. If you don't have `apt-get`, you might need to use another installer (like `yum`) - $ xclip -sel clip < ~/.ssh/id_rsa.pub + $ xclip -selection clipboard < ~/.ssh/id_rsa.pub # Copies the contents of the id_rsa.pub file to your clipboard ``` {% tip %} diff --git a/translations/zh-CN/content/github/authenticating-to-github/associating-an-email-with-your-gpg-key.md b/translations/zh-CN/content/github/authenticating-to-github/associating-an-email-with-your-gpg-key.md index 0f57cea30abd..1810325b1b42 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/associating-an-email-with-your-gpg-key.md +++ b/translations/zh-CN/content/github/authenticating-to-github/associating-an-email-with-your-gpg-key.md @@ -25,7 +25,7 @@ versions: ```shell $ gpg> adduid ``` -6. 按照提示提供您的真实姓名、电子邮件地址和任何注释。 您可以选择 `N`、`C` 或 `E` 来修改各个条目。 {% data reusables.gpg.private-email %} {% if currentVersion == "free-pro-team@latest" %} 更多信息请参阅“[设置提交电子邮件地址](/articles/setting-your-commit-email-address)”。{% endif %} +6. 按照提示提供您的真实姓名、电子邮件地址和任何注释。 您可以选择 `N`、`C` 或 `E` 来修改各个条目。 {% data reusables.gpg.private-email %} {% if currentVersion == "free-pro-team@latest" %} For more information, see "[Setting your commit email address](/articles/setting-your-commit-email-address)."{% endif %} ```shell Real Name: Octocat Email address: octocat@github.com diff --git a/translations/zh-CN/content/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on.md b/translations/zh-CN/content/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on.md index ee1e7678e9ba..fafc45478f42 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on.md +++ b/translations/zh-CN/content/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on.md @@ -1,6 +1,6 @@ --- title: 授权用于 SAML 单点登录的个人访问令牌 -intro: 要将个人访问令牌用于使用 SAML 单点登录 (SSO) 的组织，必须先授权该令牌。 +intro: '要将个人访问令牌用于使用 SAML 单点登录 (SSO) 的组织，必须先授权该令牌。' redirect_from: - /articles/authorizing-a-personal-access-token-for-use-with-a-saml-single-sign-on-organization/ - /articles/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on @@ -15,7 +15,7 @@ versions: {% data reusables.user_settings.personal_access_tokens %} 3. 在要授权的令牌旁边，单击 **Enable SSO（启用 SSO）**或 **Disable SSO（禁用 SSO）**。 ![SSO 令牌授权按钮](/assets/images/help/settings/sso-allowlist-button.png) 4. 找到要为其授权访问令牌的组织。 -4. Click **Authorize**. ![令牌授权按钮](/assets/images/help/settings/token-authorize-button.png) +4. 单击 **Authorize（授权）**。 ![令牌授权按钮](/assets/images/help/settings/token-authorize-button.png) ### 延伸阅读 diff --git a/translations/zh-CN/content/github/authenticating-to-github/authorizing-an-ssh-key-for-use-with-saml-single-sign-on.md b/translations/zh-CN/content/github/authenticating-to-github/authorizing-an-ssh-key-for-use-with-saml-single-sign-on.md index 0532381cf9a8..0c54e10ab865 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/authorizing-an-ssh-key-for-use-with-saml-single-sign-on.md +++ b/translations/zh-CN/content/github/authenticating-to-github/authorizing-an-ssh-key-for-use-with-saml-single-sign-on.md @@ -1,6 +1,6 @@ --- title: 授权用于 SAML 单点登录的 SSH 密钥 -intro: 要将 SSH 密钥用于使用 SAML 单点登录 (SSO) 的组织，必须先授权该密钥。 +intro: '要将 SSH 密钥用于使用 SAML 单点登录 (SSO) 的组织，必须先授权该密钥。' redirect_from: - /articles/authorizing-an-ssh-key-for-use-with-a-saml-single-sign-on-organization/ - /articles/authorizing-an-ssh-key-for-use-with-saml-single-sign-on @@ -20,7 +20,7 @@ versions: {% data reusables.user_settings.ssh %} 3. 在要授权的 SSH 密钥旁边，单击 **Enable SSO（启用 SSO）**或 **Disable SSO（禁用 SSO）**。 ![SSO 令牌授权按钮](/assets/images/help/settings/ssh-sso-button.png) 4. 找到要为其授权访 SSH 密钥的组织。 -5. Click **Authorize**. ![令牌授权按钮](/assets/images/help/settings/ssh-sso-authorize.png) +5. 单击 **Authorize（授权）**。 ![令牌授权按钮](/assets/images/help/settings/ssh-sso-authorize.png) ### 延伸阅读 diff --git a/translations/zh-CN/content/github/authenticating-to-github/authorizing-oauth-apps.md b/translations/zh-CN/content/github/authenticating-to-github/authorizing-oauth-apps.md index 575bf34b312a..51c380013d51 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/authorizing-oauth-apps.md +++ b/translations/zh-CN/content/github/authenticating-to-github/authorizing-oauth-apps.md @@ -49,17 +49,17 @@ versions: {% data variables.product.prodname_oauth_app %} 可以申请多种类型的数据。 -| 数据类型 | 描述 | -| ------ | ---------------------------------------------------------------------------------------------------- | -| 提交状态 | 您可以授权应用程序报告您的提交状态。 提交状态访问权限允许应用程序确定对特定提交的构建是否成功。 应用程序无法访问您的代码，但可以读取和写入特定提交的状态信息。 | -| 部署 | 部署状态访问权限允许应用程序根据公共和私有仓库的特定提交确定部署是否成功。 应用程序无法访问您的代码。 | -| Gist | [Gist](https://gist.github.com) 访问权限允许应用程序读取或写入公共和机密 Gist。 | -| 挂钩 | [Web 挂钩](/webhooks)访问权限允许应用程序读取或写入您管理的仓库中的挂钩配置。 | +| 数据类型 | 描述 | +| ------ | ----------------------------------------------------------------------------------------------- | +| 提交状态 | 您可以授权应用程序报告您的提交状态。 提交状态访问权限允许应用程序确定对特定提交的构建是否成功。 应用程序无法访问您的代码，但可以读取和写入特定提交的状态信息。 | +| 部署 | 部署状态访问权限允许应用程序根据公共和私有仓库的特定提交确定部署是否成功。 应用程序无法访问您的代码。 | +| Gist | [Gist](https://gist.github.com) 访问权限允许应用程序读取或写入公共和机密 Gist。 | +| 挂钩 | [Web 挂钩](/webhooks)访问权限允许应用程序读取或写入您管理的仓库中的挂钩配置。 | | 通知 | 通知访问权限允许应用程序读取您的 {% data variables.product.product_name %} 通知，如议题和拉取请求的评论。 但应用程序仍然无法访问仓库中的任何内容。 | -| 组织和团队 | 组织和团队访问权限允许应用程序访问并管理组织和团队成员资格。 | -| 个人用户数据 | 用户数据包括您的用户个人资料中的信息，例如您的姓名、电子邮件地址和地点。 | -| 仓库 | 仓库信息包括贡献者的姓名、您创建的分支以及仓库中的实际文件。 应用程序可以申请访问用户级别的公共或私有仓库。 | -| 仓库删除 | 应用程序可以申请删除您管理的仓库，但无法访问您的代码。 | +| 组织和团队 | 组织和团队访问权限允许应用程序访问并管理组织和团队成员资格。 | +| 个人用户数据 | 用户数据包括您的用户个人资料中的信息，例如您的姓名、电子邮件地址和地点。 | +| 仓库 | 仓库信息包括贡献者的姓名、您创建的分支以及仓库中的实际文件。 应用程序可以申请访问用户级别的公共或私有仓库。 | +| 仓库删除 | 应用程序可以申请删除您管理的仓库，但无法访问您的代码。 | ### 申请更新的权限 diff --git a/translations/zh-CN/content/github/authenticating-to-github/checking-for-existing-gpg-keys.md b/translations/zh-CN/content/github/authenticating-to-github/checking-for-existing-gpg-keys.md index 09a54db1383b..6a4d92c42665 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/checking-for-existing-gpg-keys.md +++ b/translations/zh-CN/content/github/authenticating-to-github/checking-for-existing-gpg-keys.md @@ -1,6 +1,6 @@ --- title: 检查现有 GPG 密钥 -intro: 在生成 GPG 密钥之前，您可以检查是否有任何现有的 GPG 密钥。 +intro: '在生成 GPG 密钥之前，您可以检查是否有任何现有的 GPG 密钥。' redirect_from: - /articles/checking-for-existing-gpg-keys versions: diff --git a/translations/zh-CN/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md b/translations/zh-CN/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md index 4139b905ca02..c7ad1f73eaa2 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md +++ b/translations/zh-CN/content/github/authenticating-to-github/checking-for-existing-ssh-keys.md @@ -1,6 +1,6 @@ --- title: 检查现有 SSH 密钥 -intro: 在生成 SSH 密钥之前，您可以检查是否有任何现有的 SSH 密钥。 +intro: '在生成 SSH 密钥之前，您可以检查是否有任何现有的 SSH 密钥。' redirect_from: - /articles/checking-for-existing-ssh-keys versions: @@ -20,8 +20,7 @@ versions: 3. 检查目录列表以查看是否已经有 SSH 公钥。 默认情况下，公钥的文件名是以下之一： - *id_rsa.pub* - *id_ecdsa.pub* - - *id_ed25519.pub*{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} - - *id_dsa.pub*{% endif %} + - *id_ed25519.pub* 如果您没有现有的公钥和私钥对，或者不想使用任何可用于连接到 {% data variables.product.product_name %} 的密钥对，则[生成新的 SSH 密钥](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)。 diff --git a/translations/zh-CN/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md b/translations/zh-CN/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md index 29e73256a793..c350c41e6ba4 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md +++ b/translations/zh-CN/content/github/authenticating-to-github/checking-your-commit-and-tag-signature-verification-status.md @@ -11,7 +11,9 @@ versions: ### 检查提交签名验证状态 -1. 在 {% data variables.product.product_name %} 上，导航到您的拉取请求。 +1. 在 + +{% data variables.product.product_name %}, navigate to your pull request. {% data reusables.repositories.review-pr-commits %} 3. 在提交的缩写提交哈希旁边有一个框，显示您的提交签名是否经过验证。 ![已签名提交](/assets/images/help/commits/gpg-signed-commit-verified-without-details.png) 4. 要查看有关提交签名的更详细信息，请单击 **Verified（已验证）**或 **Unverified（未验证）**。 ![经验证签名提交](/assets/images/help/commits/gpg-signed-commit_verified_details.png) diff --git a/translations/zh-CN/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md b/translations/zh-CN/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md index 5b4c47c15c6b..cd8624ced367 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md +++ b/translations/zh-CN/content/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods.md @@ -91,7 +91,9 @@ versions: 您可以生成帐户恢复令牌并通过合作伙伴的恢复提供程序存储它。 -1. 登录您的 Facebook 帐户，然后返回到 {% data variables.product.product_name %}。 +1. Sign in to your Facebook account, then return to + +{% data variables.product.product_name %} 上的企业设置来设置公告横幅。 {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.security %} 4. 要生成新令牌，请在“Recovery tokens（恢复令牌）”下，单击 **Store new token（存储新令牌）**。 ![用于存储新恢复令牌的按钮](/assets/images/help/settings/store-new-recovery-token.png) diff --git a/translations/zh-CN/content/github/authenticating-to-github/configuring-two-factor-authentication.md b/translations/zh-CN/content/github/authenticating-to-github/configuring-two-factor-authentication.md index a18fe3bc3d37..4c79ada64e95 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/configuring-two-factor-authentication.md +++ b/translations/zh-CN/content/github/authenticating-to-github/configuring-two-factor-authentication.md @@ -11,14 +11,14 @@ versions: enterprise-server: '*' --- -您可以使用移动应用程序{% if currentVersion == "free-pro-team@latest" %} 或通过短信{% endif %}配置双重身份验证。 您也可以添加安全密钥。 +You can configure two-factor authentication using a mobile app{% if currentVersion == "free-pro-team@latest" %} or via text message{% endif %}. 您也可以添加安全密钥。 -我们强力建议使用基于时间的一次性密码 (TOTP) 应用程序来配置 2FA。{% if currentVersion == "free-pro-team@latest" %} TOTP 应用程序比 SMS 更可靠，特别是对于美国以外的地区。{% endif %} TOTP 应用程序支持在云中安全备份您的验证码，在无法访问设备的情况下也可以进行恢复。 +We strongly recommend using a time-based one-time password (TOTP) application to configure 2FA.{% if currentVersion == "free-pro-team@latest" %} TOTP applications are more reliable than SMS, especially for locations outside the United States.{% endif %} TOTP apps support the secure backup of your authentication codes in the cloud and can be restored if you lose access to your device. {% warning %} **警告：** -- 如果您是要求双重身份验证的组织中的成员{% if currentVersion == "free-pro-team@latest" %}、帐单管理员{% endif %}或其私有仓库的外部协作者，则必须离开该组织后才能在 {% data variables.product.product_location %} 上禁用 2FA。 +- If you're a member{% if currentVersion == "free-pro-team@latest" %}, billing manager,{% endif %} or outside collaborator to a private repository of an organization that requires two-factor authentication, you must leave the organization before you can disable 2FA on {% data variables.product.product_location %}. - 如果禁用 2FA，您将自动失去对该组织以及您在该组织私有仓库中所拥有的任何私有复刻的访问权限。 要恢复对该组织和复刻的访问权限，请重新启用双重身份验证并联系组织所有者。 {% endwarning %} @@ -45,7 +45,9 @@ versions: 8. 在双重身份验证页面上，执行以下操作之一： - 使用移动设备的应用程序扫描 QR 码。 扫描完成后，应用程序会显示六位数代码，您可以在 {% data variables.product.product_name %} 输入该代码。 - 如果无法扫描 QR 码，请单击 **enter this text code（输入此文本代码）**以查看可复制的代码，然后在 {% data variables.product.product_name %} 上手动输入。 ![单击输入此代码](/assets/images/help/2fa/totp-click-enter-code.png) -9. TOTP 移动应用程序将保存您的 {% data variables.product.product_name %} 帐户并每隔几秒生成新的验证码。 在 {% data variables.product.product_name %} 中的 2FA 页面上，键入代码并单击 **Enable（启用）**。 ![TOTP 启用字段](/assets/images/help/2fa/totp-enter-code.png) +9. The TOTP mobile application saves your +{% data variables.product.product_name %} account and generates a new authentication code every few seconds. 在 {% data variables.product.product_name %} 中的 2FA 页面上，键入代码并单击 **Enable（启用）**。 + ![TOTP 启用字段](/assets/images/help/2fa/totp-enter-code.png) {% data reusables.two_fa.test_2fa_immediately %} {% if currentVersion == "free-pro-team@latest" %} @@ -79,32 +81,16 @@ versions: 在大多数设备和浏览器上，您可以通过 USB 或 NFC 使用物理安全密钥。 某些浏览器可以使用设备上的指纹读取器、面部识别或密码/PIN 作为安全密钥。 -安全密钥验证是 TOTP 应用程序{% if currentVersion == "free-pro-team@latest" %} 或短信{% endif %}验证的*备用*选择。 如果您丢失了安全密钥，仍可以使用手机的代码进行登录。 +Authentication with a security key is *secondary* to authentication with a TOTP application{% if currentVersion == "free-pro-team@latest" %} or a text message{% endif %}. 如果您丢失了安全密钥，仍可以使用手机的代码进行登录。 -1. 必须已通过 TOTP 移动应用程序{% if currentVersion == "free-pro-team@latest" %} 或通过 SMS{% endif %} 配置了 2FA。 -2. 确保您已将 -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}WebAuthn{% else %}FIDO U2F{% endif %} 兼容的安全密钥插入计算机。 +1. You must have already configured 2FA via a TOTP mobile app{% if currentVersion == "free-pro-team@latest" %} or via SMS{% endif %}. +2. Ensure that you have a WebAuthn compatible security key inserted into your computer. {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.security %} 5. 在“Security keys（安全密钥）”旁边，单击 **添加**。 ![添加安全密钥选项](/assets/images/help/2fa/add-security-keys-option.png) -6. 在“Security keys（安全密钥）”下，单击 **Register new security key（注册新安全密钥）**。 - {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - ![注册新安全密钥](/assets/images/help/2fa/security-key-register.png) - {% else %} - ![注册新 FIDO U2F 设备](/assets/images/help/2fa/register_new_fido_u2f_device.png) - {% endif %} -7. 键入安全密钥的昵称，然后单击 **Add（添加）**。 - {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - ![为安全密钥提供昵称](/assets/images/help/2fa/security-key-nickname.png) - {% else %} - ![提供 FIDO U2F 设备的昵称](/assets/images/help/2fa/fido_u2f_nickname.png) - {% endif %} -8. 按照安全密钥的文档激活安全密钥。 - {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - ![提示安全密钥](/assets/images/help/2fa/security-key-prompt.png) - {% else %} - ![关于 FIDO U2F 设备的提示](/assets/images/help/2fa/fido_u2f_prompt_key.png) - {% endif %} +6. 在“Security keys（安全密钥）”下，单击 **Register new security key（注册新安全密钥）**。 ![注册新安全密钥](/assets/images/help/2fa/security-key-register.png) +7. 键入安全密钥的昵称，然后单击 **Add（添加）**。 ![为安全密钥提供昵称](/assets/images/help/2fa/security-key-nickname.png) +8. 按照安全密钥的文档激活安全密钥。 ![提示安全密钥](/assets/images/help/2fa/security-key-prompt.png) 9. 确认您已下载并且能够访问恢复代码。 如果尚未下载，或者要生成另一组代码，请下载代码并将其保存在安全位置。 如果无法访问自己的帐户，您可以使用恢复代码来恢复帐户访问。 更多信息请参阅“[丢失 2FA 凭据时恢复帐户](/articles/recovering-your-account-if-you-lose-your-2fa-credentials)”。 ![下载恢复代码按钮](/assets/images/help/2fa/2fa-recover-during-setup.png) {% data reusables.two_fa.test_2fa_immediately %} diff --git a/translations/zh-CN/content/github/authenticating-to-github/connecting-with-third-party-applications.md b/translations/zh-CN/content/github/authenticating-to-github/connecting-with-third-party-applications.md index 33683cbb34be..84b91bca654f 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/connecting-with-third-party-applications.md +++ b/translations/zh-CN/content/github/authenticating-to-github/connecting-with-third-party-applications.md @@ -57,7 +57,7 @@ versions: | 部署 | 部署状态访问权限允许应用程序根据公共和私有仓库的特定提交确定部署是否成功。 应用程序无法访问您的代码。 | | Gist | [Gist](https://gist.github.com) 访问权限允许应用程序读取或写入公共和机密 Gist。 | | 挂钩 | [Web 挂钩](/webhooks)访问权限允许应用程序读取或写入您管理的仓库中的挂钩配置。 | -| 通知 | 通知访问权限允许应用程序读取您的 {% data variables.product.product_name %} 通知，如议题和拉取请求的评论。 但应用程序仍然无法访问仓库中的任何内容。 | +| 通知 | 通知访问权限允许应用程序读取您的 {% data variables.product.product_name %} 通知，如议题和拉取请求的评论。 但应用程序仍然无法访问仓库中的任何内容。 | | 组织和团队 | 组织和团队访问权限允许应用程序访问并管理组织和团队成员资格。 | | 个人用户数据 | 用户数据包括您的用户个人资料中的信息，例如您的姓名、电子邮件地址和地点。 | | 仓库 | 仓库信息包括贡献者的姓名、您创建的分支以及仓库中的实际文件。 应用程序可以申请访问用户级别的公共或私有仓库。 | diff --git a/translations/zh-CN/content/github/authenticating-to-github/creating-a-personal-access-token.md b/translations/zh-CN/content/github/authenticating-to-github/creating-a-personal-access-token.md index 6e81b7c2d17e..0495eef00f84 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/creating-a-personal-access-token.md +++ b/translations/zh-CN/content/github/authenticating-to-github/creating-a-personal-access-token.md @@ -13,7 +13,7 @@ versions: 在使用[GitHub API 或](/v3/auth/#via-oauth-and-personal-access-tokens)命令[行](#using-a-token-on-the-command-line)时，可使用个人访问令牌 (PAT) 代替密码向 {% data variables.product.product_name %} 进行身份验证。 -{% if currentVersion == "free-pro-team@latest" %}如果要使用 PAT 访问使用 SAML SSO 的组织所拥有的资源，则必须授权 PAT。 更多信息请参阅“[关于使用 SAML 单点登录进行身份验证](/articles/about-authentication-with-saml-single-sign-on)”和“[授权个人访问令牌用于 SAML 单点登录](/articles/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on)”。{% endif %} +{% if currentVersion == "free-pro-team@latest" %}If you want to use a PAT to access resources owned by an organization that uses SAML SSO, you must authorize the PAT. 更多信息请参阅“[关于使用 SAML 单点登录进行身份验证](/articles/about-authentication-with-saml-single-sign-on)”和“[授权个人访问令牌用于 SAML 单点登录](/articles/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on)”。{% endif %} {% if currentVersion == "free-pro-team@latest" %}{% data reusables.user_settings.removes-personal-access-tokens %}{% endif %} @@ -27,8 +27,8 @@ versions: 5. 给令牌一个描述性名称。 ![令牌说明字段](/assets/images/help/settings/token_description.png) 6. 选择要授予此令牌的作用域或权限。 要使用令牌从命令行访问仓库，请选择 **repo（仓库）**。 ![选择令牌作用域](/assets/images/help/settings/token_scopes.gif) 7. 单击 **Generate token（生成令牌）**。 ![生成令牌按钮](/assets/images/help/settings/generate_token.png) -8. 单击 {% octicon "clippy" aria-label="The copy to clipboard icon" %} 将令牌复制到剪贴板。 出于安全原因，离开此页面后，您将无法再次看到令牌。{% if currentVersion == "free-pro-team@latest" %} ![新创建的令牌](/assets/images/help/settings/personal_access_tokens.png){% else %} -![新创建的令牌](/assets/images/help/settings/personal_access_tokens_ghe.png){% endif %} +8. 单击 {% octicon "clippy" aria-label="The copy to clipboard icon" %} 将令牌复制到剪贴板。 For security reasons, after you navigate off the page, you will not be able to see the token again.{% if currentVersion == "free-pro-team@latest" %} ![Newly created token](/assets/images/help/settings/personal_access_tokens.png){% else %} +![Newly created token](/assets/images/help/settings/personal_access_tokens_ghe.png){% endif %} {% warning %} diff --git a/translations/zh-CN/content/github/authenticating-to-github/creating-a-strong-password.md b/translations/zh-CN/content/github/authenticating-to-github/creating-a-strong-password.md index 42aea3201fcb..91420f0bd853 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/creating-a-strong-password.md +++ b/translations/zh-CN/content/github/authenticating-to-github/creating-a-strong-password.md @@ -21,7 +21,7 @@ versions: {% data reusables.repositories.blocked-passwords %} -You can only use your password to log on to {% data variables.product.product_name %} using your browser. When you authenticate to {% data variables.product.product_name %} with other means, such as the command line or API, you should use other credentials. 更多信息请参阅“[关于 {% data variables.product.prodname_dotcom %} 向验证身份](/github/authenticating-to-github/about-authentication-to-github)”。 +您只能使用密码通过浏览器登录 {% data variables.product.product_name %}。 使用其他方式（例如命令行或 API）向 {% data variables.product.product_name %} 验证时，应使用其他凭据。 更多信息请参阅“[关于 {% data variables.product.prodname_dotcom %} 向验证身份](/github/authenticating-to-github/about-authentication-to-github)”。 {% if currentVersion == "free-pro-team@latest" %}{% data reusables.user_settings.password-authentication-deprecation %}{% endif %} diff --git a/translations/zh-CN/content/github/authenticating-to-github/deleted-or-missing-ssh-keys.md b/translations/zh-CN/content/github/authenticating-to-github/deleted-or-missing-ssh-keys.md index 83fc282d49c9..d0784b9c99a7 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/deleted-or-missing-ssh-keys.md +++ b/translations/zh-CN/content/github/authenticating-to-github/deleted-or-missing-ssh-keys.md @@ -7,7 +7,7 @@ versions: free-pro-team: '*' --- -{% data variables.product.prodname_dotcom %} 会自动删除非活动的 SSH 密钥以确保帐户安全，例如在某人离职或丢失计算机后。 +{% data variables.product.prodname_dotcom %} 会自动删除非活动的 SSH 密钥以确保账户安全，例如在某人离职或丢失计算机后。 可以通过查看帐户的安全日志，检查是否在一年内未使用过 SSH 密钥。 更多信息请参阅“[查看您的安全日志](/articles/reviewing-your-security-log/)”。 diff --git a/translations/zh-CN/content/github/authenticating-to-github/disabling-two-factor-authentication-for-your-personal-account.md b/translations/zh-CN/content/github/authenticating-to-github/disabling-two-factor-authentication-for-your-personal-account.md index 9df55abdd105..c328dc78f5c7 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/disabling-two-factor-authentication-for-your-personal-account.md +++ b/translations/zh-CN/content/github/authenticating-to-github/disabling-two-factor-authentication-for-your-personal-account.md @@ -1,6 +1,6 @@ --- title: 禁用个人帐户的双重身份验证 -intro: 如果禁用个人帐户的双重身份验证，可能失去对所属组织的访问权限。 +intro: '如果禁用个人帐户的双重身份验证，可能失去对所属组织的访问权限。' redirect_from: - /articles/disabling-two-factor-authentication-for-your-personal-account versions: @@ -12,7 +12,7 @@ versions: {% warning %} -**警告：** 如果您是需要双重身份验证的某组织的公共仓库的成员{% if currentVersion == "free-pro-team@latest" %}、帐单管理员{% endif %} 或外部协作者，并且已禁用 2FA，您将被从该组织中自动删除，并会失去对其仓库的访问权限。 要重新获得对组织的访问权限，请重新启用双重身份验证并联系组织所有者。 +**Warning:** If you're a member{% if currentVersion == "free-pro-team@latest" %}, billing manager,{% endif %} or outside collaborator to a public repository of an organization that requires two-factor authentication and you disable 2FA, you'll be automatically removed from the organization, and you'll lose your access to their repositories. 要重新获得对组织的访问权限，请重新启用双重身份验证并联系组织所有者。 {% endwarning %} @@ -24,7 +24,7 @@ versions: {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.security %} -3. Click **Disable**. ![禁用双重身份验证](/assets/images/help/2fa/disable-two-factor-authentication.png) +3. 单击 **Disable（禁用）**。 ![禁用双重身份验证](/assets/images/help/2fa/disable-two-factor-authentication.png) ### 延伸阅读 diff --git a/translations/zh-CN/content/github/authenticating-to-github/error-agent-admitted-failure-to-sign.md b/translations/zh-CN/content/github/authenticating-to-github/error-agent-admitted-failure-to-sign.md index 1ee582fd06f3..d513cef8d828 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/error-agent-admitted-failure-to-sign.md +++ b/translations/zh-CN/content/github/authenticating-to-github/error-agent-admitted-failure-to-sign.md @@ -1,5 +1,5 @@ --- -title: 错误：代理承认没有签署 +title: '错误：代理承认没有签署' intro: '在极少数情况下，在 Linux 上通过 SSH 连接 {% data variables.product.product_name %} 会产生错误“Agent admitted failure to sign using the key”（代理承认没有使用密钥签署）。 请遵循以下步骤解决此问题。' redirect_from: - /articles/error-agent-admitted-failure-to-sign-using-the-key/ diff --git a/translations/zh-CN/content/github/authenticating-to-github/error-bad-file-number.md b/translations/zh-CN/content/github/authenticating-to-github/error-bad-file-number.md index f79c05374115..b5a347434deb 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/error-bad-file-number.md +++ b/translations/zh-CN/content/github/authenticating-to-github/error-bad-file-number.md @@ -1,5 +1,5 @@ --- -title: 错误：文件编号错误 +title: '错误：文件编号错误' intro: 此错误通常表示您无法连接到服务器。 这通常由防火墙和代理服务器造成。 redirect_from: - /articles/error-bad-file-number @@ -12,7 +12,7 @@ versions: ```shell $ ssh -vT git@{% data variables.command_line.codeblock %} -> OpenSSH_5.8p1, OpenSSL 1.0.0d 8 Feb 2011 +> OpenSSH_8.1p1, LibreSSL 2.7.3 > debug1: Connecting to {% data variables.command_line.codeblock %} [207.97.227.239] port 22. > debug1: connect to address 207.97.227.239 port 22: Connection timed out > ssh: connect to host {% data variables.command_line.codeblock %} port 22: Connection timed out diff --git a/translations/zh-CN/content/github/authenticating-to-github/error-key-already-in-use.md b/translations/zh-CN/content/github/authenticating-to-github/error-key-already-in-use.md index e65f74aeb738..7e6c4bf2aba1 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/error-key-already-in-use.md +++ b/translations/zh-CN/content/github/authenticating-to-github/error-key-already-in-use.md @@ -1,5 +1,5 @@ --- -title: 错误：密钥已被使用 +title: '错误：密钥已被使用' intro: '在尝试 [添加密钥](/articles/adding-a-new-ssh-key-to-your-github-account) 但该密钥尚未添加到另一个帐户或仓库时，就会发生此错误。' redirect_from: - /articles/error-key-already-in-use diff --git a/translations/zh-CN/content/github/authenticating-to-github/error-permission-denied-publickey.md b/translations/zh-CN/content/github/authenticating-to-github/error-permission-denied-publickey.md index b6f240fba04c..75af14ce4136 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/error-permission-denied-publickey.md +++ b/translations/zh-CN/content/github/authenticating-to-github/error-permission-denied-publickey.md @@ -1,6 +1,6 @@ --- -title: 错误：权限被拒绝（公钥） -intro: “权限被拒绝”错误表示服务器拒绝了您的连接。 可能有多个原因，最常见的如下所述。 +title: 'Error: Permission denied (publickey)' +intro: 'A "Permission denied" error means that the server rejected your connection. There could be several reasons why, and the most common examples are explained below.' redirect_from: - /articles/error-permission-denied-publickey versions: @@ -8,50 +8,50 @@ versions: enterprise-server: '*' --- -### 对 Git 是否应该使用 `sudo` 命令？ +### Should the `sudo` command be used with Git? -不应对 Git 使用 `sudo` 命令。 如果有*很好的原因*必须使用 `sudo`，请确保对每个命令使用它（可能使用 `su` 获取 shell 作为该点的根更好）。 如果[生成 SSH 密钥](/articles/generating-an-ssh-key)而不使用 `sudo`，则尝试使用 `sudo git push` 而不使用生成的相同密钥。 +You should not be using the `sudo` command with Git. If you have a *very good reason* you must use `sudo`, then ensure you are using it with every command (it's probably just better to use `su` to get a shell as root at that point). If you [generate SSH keys](/articles/generating-an-ssh-key) without `sudo` and then try to use a command like `sudo git push`, you won't be using the same keys that you generated. -### 检查是否连接到正确的服务器 +### Check that you are connecting to the correct server -我们知道，键入 Url 很麻烦。 请注意您键入的内容；您无法连接到 "githib.com" 或 "guthub.com"。 有某些情况下，公司网络可能导致解析 DNS 记录有问题。 +Typing is hard, we all know it. Pay attention to what you type; you won't be able to connect to "githib.com" or "guthub.com". In some cases, a corporate network may cause issues resolving the DNS record as well. -为确保连接到正确的域，可以输入以下命令： +To make sure you are connecting to the right domain, you can enter the following command: ```shell $ ssh -vT git@{% data variables.command_line.codeblock %} -> OpenSSH_5.6p1, OpenSSL 0.9.8r 8 Feb 2011 +> OpenSSH_8.1p1, LibreSSL 2.7.3 > debug1: Reading configuration data /Users/you/.ssh/config -> debug1: Reading configuration data /etc/ssh_config -> debug1: Applying options for * -> debug1: Connecting to {% data variables.command_line.codeblock %} [IP ADDRESS] port 22. +> debug1: Reading configuration data /etc/ssh/ssh_config +> debug1: /etc/ssh/ssh_config line 47: Applying options for * +> debug1: Connecting to {% data variables.command_line.codeblock %} port 22. ``` -应连接端口 22{% if currentVersion == "free-pro-team@latest" %}，除非覆盖设置以使用[通过 HTTPS 的 SSH](/articles/using-ssh-over-the-https-port){% endif %}。 +The connection should be made on port 22{% if currentVersion == "free-pro-team@latest" %}, unless you're overriding settings to use [SSH over HTTPS](/articles/using-ssh-over-the-https-port){% endif %}. -### 始终使用 "git" 用户 +### Always use the "git" user -所有连接（包括远程 URL 的连接）必须以 "git" 用户进行。 如果尝试以 {% data variables.product.product_name %} 用户名连接，将会失败： +All connections, including those for remote URLs, must be made as the "git" user. If you try to connect with your {% data variables.product.product_name %} username, it will fail: ```shell $ ssh -T GITHUB-USERNAME@{% data variables.command_line.codeblock %} > Permission denied (publickey). ``` -如果连接失败且您通过 {% data variables.product.product_name %} 用户名使用远程 URL，可以[更改远程 URL 以使用 "git" 用户](/articles/changing-a-remote-s-url/)。 +If your connection failed and you're using a remote URL with your {% data variables.product.product_name %} username, you can [change the remote URL to use the "git" user](/articles/changing-a-remote-s-url/). -应键入以下命令来验证连接： +You should verify your connection by typing: ```shell $ ssh -T git@{% data variables.command_line.codeblock %} > Hi username! You've successfully authenticated... ``` -### 确保您有使用的密钥 +### Make sure you have a key that is being used {% mac %} {% data reusables.command_line.open_the_multi_os_terminal %} -2. 确认您的私钥已生成并加载到 SSH。 如果使用的是 OpenSSH 6.7 或更早版本： +2. Verify that you have a private key generated and loaded into SSH. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell # start the ssh-agent in the background $ eval "$(ssh-agent -s)" @@ -60,7 +60,7 @@ $ ssh -T git@{% data variables.command_line.codeblock %} > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` - 如果使用的是 OpenSSH 6.8 或更新版本： + If you're using OpenSSH 6.8 or newer: ```shell # start the ssh-agent in the background $ eval "$(ssh-agent -s)" @@ -68,6 +68,14 @@ $ ssh -T git@{% data variables.command_line.codeblock %} $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + # start the ssh-agent in the background + $ eval "$(ssh-agent -s)" + > Agent pid 59566 + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} {% endmac %} @@ -78,24 +86,29 @@ $ ssh -T git@{% data variables.command_line.codeblock %} 1. {% data reusables.desktop.windows_git_bash_turn_on_ssh_agent %} {% data reusables.desktop.windows_git_for_windows_turn_on_ssh_agent %} -2. 确认您的私钥已生成并加载到 SSH。 如果使用的是 OpenSSH 6.7 或更早版本： +2. Verify that you have a private key generated and loaded into SSH. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` - 如果使用的是 OpenSSH 6.8 或更新版本： + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} {% endwindows %} {% linux %} {% data reusables.command_line.open_the_multi_os_terminal %} -2. 确认您的私钥已生成并加载到 SSH。 如果使用的是 OpenSSH 6.7 或更早版本： +2. Verify that you have a private key generated and loaded into SSH. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell # start the ssh-agent in the background $ eval "$(ssh-agent -s)" @@ -104,7 +117,7 @@ $ ssh -T git@{% data variables.command_line.codeblock %} > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` - 如果使用的是 OpenSSH 6.8 或更新版本： + If you're using OpenSSH 6.8 or newer: ```shell # start the ssh-agent in the background $ eval "$(ssh-agent -s)" @@ -112,20 +125,26 @@ $ ssh -T git@{% data variables.command_line.codeblock %} $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/you/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} + {% endlinux %} -`ssh-add` 命令*应*印出一个长的数字和字母字符串。 如果未印出任何内容，则需要[生成新 SSH 密钥](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)并将其与 {% data variables.product.product_name %} 关联。 +The `ssh-add` command *should* print out a long string of numbers and letters. If it does not print anything, you will need to [generate a new SSH key](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) and associate it with {% data variables.product.product_name %}. {% tip %} -**提示**：在大多数系统中，默认私钥 (`~/.ssh/id_rsa`{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}、`~/.ssh/id_dsa`{% endif %} 和 `~/.ssh/identity`) 会自动添加到 SSH 身体验证代理中。 应无需运行 `ssh-add path/to/key`，除非在生成密钥时覆盖文件名。 +**Tip**: On most systems the default private keys (`~/.ssh/id_rsa` and `~/.ssh/identity`) are automatically added to the SSH authentication agent. You shouldn't need to run `ssh-add path/to/key` unless you override the file name when you generate a key. {% endtip %} -#### 获取更多详细信息 +#### Getting more details -也可尝试连接 `git@{% data variables.command_line.backticks %}` 来检查使用的密钥： +You can also check that the key is being used by trying to connect to `git@{% data variables.command_line.backticks %}`: ```shell $ ssh -vT git@{% data variables.command_line.codeblock %} @@ -143,7 +162,7 @@ $ ssh -vT git@{% data variables.command_line.codeblock %} > Permission denied (publickey). ``` -在该示例中，我们没有任何密钥供 SSH 使用。 "identity file" 行末的 "-1" 表示 SSH 找不到可使用的文件。 后面的 "Trying private key" 行也表示未找到文件。 如果文件存在，这些行将分别是 "1" 和 "Offering public key"： +In that example, we did not have any keys for SSH to use. The "-1" at the end of the "identity file" lines means SSH couldn't find a file to use. Later on, the "Trying private key" lines also indicate that no file was found. If a file existed, those lines would be "1" and "Offering public key", respectively: ```shell $ ssh -vT git@{% data variables.command_line.codeblock %} @@ -155,77 +174,89 @@ $ ssh -vT git@{% data variables.command_line.codeblock %} > debug1: Offering RSA public key: /Users/you/.ssh/id_rsa ``` -### 确认公钥已附加到您的帐户 +### Verify the public key is attached to your account -必须向 {% data variables.product.product_name %} 提供公钥才可建立安全连接。 +You must provide your public key to {% data variables.product.product_name %} to establish a secure connection. {% mac %} -1. 打开终端。 -2. 在后台启动 SSH 代理程序。 +1. Open Terminal. +2. Start SSH agent in the background. ```shell $ eval "$(ssh-agent -s)" > Agent pid 59566 ``` -3. 找到并记录公钥指纹。 如果使用的是 OpenSSH 6.7 或更早版本： +3. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` - 如果使用的是 OpenSSH 6.8 或更新版本： + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -6. 比较 SSH 公钥列表与 `ssh-add` 命令的输出。 ![{% data variables.product.product_name %} 中的 SSH 密钥列表](/assets/images/help/settings/ssh_key_listing.png) +6. Compare the list of SSH keys with the output from the `ssh-add` command. +![SSH key listing in {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png) {% endmac %} {% windows %} -1. 打开命令行。 -2. 在后台启动 SSH 代理程序。 +1. Open the command line. +2. Start SSH agent in the background. ```shell $ ssh-agent -s > Agent pid 59566 ``` -3. 找到并记录公钥指纹。 如果使用的是 OpenSSH 6.7 或更早版本： +3. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` - 如果使用的是 OpenSSH 6.8 或更新版本： + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -6. 比较 SSH 公钥列表与 `ssh-add` 命令的输出。 ![{% data variables.product.product_name %} 中的 SSH 密钥列表](/assets/images/help/settings/ssh_key_listing.png) +6. Compare the list of SSH keys with the output from the `ssh-add` command. +![SSH key listing in {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png) {% endwindows %} {% linux %} -1. 打开终端。 -2. 在后台启动 SSH 代理程序。 +1. Open Terminal. +2. Start SSH agent in the background. ```shell $ eval "$(ssh-agent -s)" > Agent pid 59566 ``` -3. 找到并记录公钥指纹。 如果使用的是 OpenSSH 6.7 或更早版本： +3. Find and take a note of your public key fingerprint. If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` - 如果使用的是 OpenSSH 6.8 或更新版本： + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) @@ -233,14 +264,15 @@ $ ssh -vT git@{% data variables.command_line.codeblock %} {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -6. 比较 SSH 公钥列表与 `ssh-add` 命令的输出。 ![{% data variables.product.product_name %} 中的 SSH 密钥列表](/assets/images/help/settings/ssh_key_listing.png) +6. Compare the list of SSH keys with the output from the `ssh-add` command. +![SSH key listing in {% data variables.product.product_name %}](/assets/images/help/settings/ssh_key_listing.png) {% endlinux %} -如果在 {% data variables.product.product_name %} 中未看到公钥，则需要[添加 SSH 密钥到 {% data variables.product.product_name %}](/articles/adding-a-new-ssh-key-to-your-github-account) 并将其与您的计算机关联。 +If you don't see your public key in {% data variables.product.product_name %}, you'll need to [add your SSH key to {% data variables.product.product_name %}](/articles/adding-a-new-ssh-key-to-your-github-account) to associate it with your computer. {% warning %} -**警告**：如果在 {% data variables.product.product_name %} 上看到您不熟悉的 SSH 密钥，请立即删除并联系 {% data variables.contact.contact_support %} 寻求进一步的帮助。 无法识别的公钥可能表示安全问题。 更多信息请参阅“[审查 SSH 密钥](/articles/reviewing-your-ssh-keys)”。 +**Warning**: If you see an SSH key you're not familiar with on {% data variables.product.product_name %}, delete it immediately and contact {% data variables.contact.contact_support %}, for further help. An unidentified public key may indicate a possible security concern. For more information, see "[Reviewing your SSH keys](/articles/reviewing-your-ssh-keys)." {% endwarning %} diff --git a/translations/zh-CN/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-other-user.md b/translations/zh-CN/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-other-user.md index b50cd7a434f6..ee8a4b1f8bbc 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-other-user.md +++ b/translations/zh-CN/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-other-user.md @@ -1,5 +1,5 @@ --- -title: 错误：用户/仓库拒绝其他用户的权限 +title: '错误：用户/仓库拒绝其他用户的权限' intro: 此错误意味着您正在推送的密钥附加到无仓库访问权限的帐户。 redirect_from: - /articles/error-permission-to-user-repo-denied-to-other-user diff --git a/translations/zh-CN/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-userother-repo.md b/translations/zh-CN/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-userother-repo.md index 4250f2912493..759aaec2eae2 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-userother-repo.md +++ b/translations/zh-CN/content/github/authenticating-to-github/error-permission-to-userrepo-denied-to-userother-repo.md @@ -1,6 +1,6 @@ --- -title: 错误：用户/仓库拒绝用户/其他仓库的权限 -intro: 此错误意味着您正在推送的密钥作为 deploy key 附加到另一个仓库，并且对您尝试推送到的仓库的没有访问权限。 +title: '错误：用户/仓库拒绝用户/其他仓库的权限' +intro: '此错误意味着您正在推送的密钥作为 deploy key 附加到另一个仓库，并且对您尝试推送到的仓库的没有访问权限。' redirect_from: - /articles/error-permission-to-user-repo-denied-to-user-other-repo - /articles/error-permission-to-userrepo-denied-to-userother-repo diff --git a/translations/zh-CN/content/github/authenticating-to-github/error-ssh-add-illegal-option----k.md b/translations/zh-CN/content/github/authenticating-to-github/error-ssh-add-illegal-option----k.md index bd7510e83779..1a0332ad7340 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/error-ssh-add-illegal-option----k.md +++ b/translations/zh-CN/content/github/authenticating-to-github/error-ssh-add-illegal-option----k.md @@ -1,6 +1,6 @@ --- -title: 错误：ssh-add：非法选项 -- K -intro: 此错误意味着您的‘ssh-add’版本不支持 macOS 密钥链集成，此集成允许您将密码存储在密钥链中。 +title: '错误：ssh-add：非法选项 -- K' +intro: '此错误意味着您的‘ssh-add’版本不支持 macOS 密钥链集成，此集成允许您将密码存储在密钥链中。' redirect_from: - /articles/error-ssh-add-illegal-option-k - /articles/error-ssh-add-illegal-option----k diff --git a/translations/zh-CN/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md b/translations/zh-CN/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md index d472b88bccc3..48863702f2e6 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md +++ b/translations/zh-CN/content/github/authenticating-to-github/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok.md @@ -1,5 +1,5 @@ --- -title: 错误：SSL 证书有问题，请验证 CA 证书是否正常 +title: '错误：SSL 证书有问题，请验证 CA 证书是否正常' intro: '此错误意味着您的 CA 根证书已过期。 如果您的 CA 根证书需要更新，您将无法从 {% data variables.product.product_name %} 仓库推送或拉取。' redirect_from: - /articles/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok @@ -10,8 +10,8 @@ versions: 您可能收到像以下这样的错误： ```shell -$ git push -u github.master -> fatal: 'github.master' does not appear to be a git repository +$ git push -u github.main +> fatal: 'github.main' does not appear to be a git repository > fatal: The remote end hung up unexpectedly $ git pull -u github diff --git a/translations/zh-CN/content/github/authenticating-to-github/error-were-doing-an-ssh-key-audit.md b/translations/zh-CN/content/github/authenticating-to-github/error-were-doing-an-ssh-key-audit.md index 9b14ea0f5334..18adb8ebcfb1 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/error-were-doing-an-ssh-key-audit.md +++ b/translations/zh-CN/content/github/authenticating-to-github/error-were-doing-an-ssh-key-audit.md @@ -1,5 +1,5 @@ --- -title: 错误：我们正在进行 SSH 密钥审核 +title: '错误：我们正在进行 SSH 密钥审核' intro: 此错误意味着无法验证正在用于执行 Git 操作的 SSH 密钥。 redirect_from: - /articles/error-we-re-doing-an-ssh-key-audit diff --git a/translations/zh-CN/content/github/authenticating-to-github/generating-a-new-gpg-key.md b/translations/zh-CN/content/github/authenticating-to-github/generating-a-new-gpg-key.md index f4262bfb02fd..8aee0e6b15bd 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/generating-a-new-gpg-key.md +++ b/translations/zh-CN/content/github/authenticating-to-github/generating-a-new-gpg-key.md @@ -1,6 +1,6 @@ --- title: 生成新 GPG 密钥 -intro: 如果没有现有的 GPG 密钥，您可以生成新的 GPG 密钥以用于签名提交和标记。 +intro: '如果没有现有的 GPG 密钥，您可以生成新的 GPG 密钥以用于签名提交和标记。' redirect_from: - /articles/generating-a-new-gpg-key versions: @@ -14,7 +14,7 @@ versions: {% note %} -**注：**在生成新 GPG 密钥之前，请确保已验证您的电子邮件地址。 如果尚未验证电子邮件地址，您将无法使用 GPG 对提交和标记签名。{% if currentVersion == "free-pro-team@latest" %}更多信息请参阅“[验证电子邮件地址](/articles/verifying-your-email-address)”。{% endif %} +**注：**在生成新 GPG 密钥之前，请确保已验证您的电子邮件地址。 If you haven't verified your email address, you won't be able to sign commits and tags with GPG.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[Verifying your email address](/articles/verifying-your-email-address)."{% endif %} {% endnote %} @@ -37,7 +37,7 @@ versions: {% note %} - **注：**要求您输入电子邮件地址时，请确保输入您 GitHub 帐户的经验证电子邮件地址。 {% data reusables.gpg.private-email %} {% if currentVersion == "free-pro-team@latest" %} 更多信息请参阅“[验证电子邮件地址](/articles/verifying-your-email-address)”和“[设置提交电子邮件地址](/articles/setting-your-commit-email-address)”。{% endif %} + **注：**要求您输入电子邮件地址时，请确保输入您 GitHub 帐户的经验证电子邮件地址。 {% data reusables.gpg.private-email %} {% if currentVersion == "free-pro-team@latest" %} For more information, see "[Verifying your email address](/articles/verifying-your-email-address)" and "[Setting your commit email address](/articles/setting-your-commit-email-address)."{% endif %} {% endnote %} diff --git a/translations/zh-CN/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md b/translations/zh-CN/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md index cc666c85f51a..ceaf5312eb09 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md +++ b/translations/zh-CN/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md @@ -1,6 +1,6 @@ --- title: 生成新 SSH 密钥并添加到 ssh-agent -intro: 检查现有 SSH 密钥后，您可以生成新 SSH 密钥以用于身份验证，然后将其添加到 ssh-agent。 +intro: '检查现有 SSH 密钥后，您可以生成新 SSH 密钥以用于身份验证，然后将其添加到 ssh-agent。' redirect_from: - /articles/adding-a-new-ssh-key-to-the-ssh-agent/ - /articles/generating-a-new-ssh-key/ diff --git a/translations/zh-CN/content/github/authenticating-to-github/index.md b/translations/zh-CN/content/github/authenticating-to-github/index.md index b2e8764045cc..07ab1865cdd3 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/index.md +++ b/translations/zh-CN/content/github/authenticating-to-github/index.md @@ -1,7 +1,7 @@ --- title: 向 GitHub 验证 shortTitle: 身份验证 -intro: 使用双重身份验证、SSH 和提交签名验证等功能保护帐户和数据安全。 +intro: '使用双重身份验证、SSH 和提交签名验证等功能保护帐户和数据安全。' redirect_from: - /categories/56/articles/ - /categories/ssh/ diff --git a/translations/zh-CN/content/github/authenticating-to-github/managing-commit-signature-verification.md b/translations/zh-CN/content/github/authenticating-to-github/managing-commit-signature-verification.md index 7733f5e5929f..e21e5bcfac1a 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/managing-commit-signature-verification.md +++ b/translations/zh-CN/content/github/authenticating-to-github/managing-commit-signature-verification.md @@ -1,6 +1,6 @@ --- title: 管理提交签名验证 -intro: '您可以使用 GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} 或 S/MIME{% endif %} 在本地签名您的工作。 {% data variables.product.product_name %} 将会验证这些签名，以便其他人知道提交来自可信的来源。{% if currentVersion == "free-pro-team@latest" %} {% data variables.product.product_name %} 将自动使用 {% data variables.product.product_name %} web 界面{% endif %}对您的提交签名。' +intro: 'You can sign your work locally using GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} or S/MIME{% endif %}. {% data variables.product.product_name %} will verify these signatures so other people will know that your commits come from a trusted source.{% if currentVersion == "free-pro-team@latest" %} {% data variables.product.product_name %} will automatically sign commits you make using the {% data variables.product.product_name %} web interface.{% endif %}' redirect_from: - /articles/generating-a-gpg-key/ - /articles/signing-commits-with-gpg/ diff --git a/translations/zh-CN/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md b/translations/zh-CN/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md index 0b0c1c8b186a..cee1b2e7e1c1 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md +++ b/translations/zh-CN/content/github/authenticating-to-github/recovering-your-account-if-you-lose-your-2fa-credentials.md @@ -1,6 +1,6 @@ --- title: 丢失 2FA 凭据时恢复帐户 -intro: 如果无法访问双重身份验证凭据，您可以使用恢复代码或其他恢复选项重新获取对帐户的访问权限。 +intro: '如果无法访问双重身份验证凭据，您可以使用恢复代码或其他恢复选项重新获取对帐户的访问权限。' redirect_from: - /articles/recovering-your-account-if-you-lost-your-2fa-credentials/ - /articles/authenticating-with-an-account-recovery-token/ @@ -81,7 +81,8 @@ versions: 1. 在 Facebook 中，导航到 [Security Settings（安全设置）](https://www.facebook.com/settings?tab=security)，然后单击 **Recover Accounts Elsewhere（异地恢复帐户）**。 ![含有异地恢复帐户链接的 Facebook 安全设置页面](/assets/images/help/settings/security-facebook-security-settings-page.png) 2. 单击与您的 {% data variables.product.product_name %} 帐户关联的恢复令牌。 ![Facebook 中存储的恢复令牌列表](/assets/images/help/settings/security-github-rae-token-on-facebook.png) 3. 要取回帐户恢复令牌，请单击 **Recover This Account（恢复此帐户）**。 此时将打开一个新窗口，将您返回到 {% data variables.product.product_name %}。 ![含有恢复令牌相关信息的模态框和恢复此帐户按钮](/assets/images/help/settings/security-recover-account-facebook.png) -4. 联系 {% data variables.contact.contact_support %}，告知他们您的帐户恢复令牌已准备好进行审查。 +4. 联系我们 +{% data variables.contact.contact_support %} to let them know that your account recovery token is ready for review. {% endif %} ### 延伸阅读 diff --git a/translations/zh-CN/content/github/authenticating-to-github/recovering-your-ssh-key-passphrase.md b/translations/zh-CN/content/github/authenticating-to-github/recovering-your-ssh-key-passphrase.md index 416429849b5e..282204cccbb9 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/recovering-your-ssh-key-passphrase.md +++ b/translations/zh-CN/content/github/authenticating-to-github/recovering-your-ssh-key-passphrase.md @@ -1,6 +1,6 @@ --- title: 恢复 SSH 密钥密码 -intro: 如果您丢失 SSH 密钥密码，则根据您使用的操作系统，您可能可以恢复它，也可能需要生成新的 SSH 密钥密码。 +intro: '如果您丢失 SSH 密钥密码，则根据您使用的操作系统，您可能可以恢复它，也可能需要生成新的 SSH 密钥密码。' redirect_from: - /articles/how-do-i-recover-my-passphrase/ - /articles/how-do-i-recover-my-ssh-key-passphrase/ diff --git a/translations/zh-CN/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md b/translations/zh-CN/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md index 141dcfcac4be..3eef64f1f115 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md +++ b/translations/zh-CN/content/github/authenticating-to-github/removing-sensitive-data-from-a-repository.md @@ -1,6 +1,6 @@ --- title: 从仓库中删除敏感数据 -intro: 如果将敏感数据（例如密码或 SSH 密钥）提交到 Git 仓库，您可以将其从历史记录中删除。 要从仓库的历史记录中彻底删除不需要的文件，您可以使用 `git filter-branch` 命令或 BFG Repo-Cleaner 开源工具。 +intro: '如果将敏感数据（例如密码或 SSH 密钥）提交到 Git 仓库，您可以将其从历史记录中删除。 要从仓库的历史记录中彻底删除不需要的文件，您可以使用 `git filter-branch` 命令或 BFG Repo-Cleaner 开源工具。' redirect_from: - /remove-sensitive-data/ - /removing-sensitive-data/ @@ -74,7 +74,7 @@ $ bfg --replace-text passwords.txt "git rm --cached --ignore-unmatch PATH-TO-YOUR-FILE-WITH-SENSITIVE-DATA" \ --prune-empty --tag-name-filter cat -- --all > Rewrite 48dc599c80e20527ed902928085e7861e6b3cbe6 (266/266) - > Ref 'refs/heads/master' was rewritten + > Ref 'refs/heads/main' was rewritten ``` {% note %} @@ -89,7 +89,7 @@ $ bfg --replace-text passwords.txt $ echo "YOUR-FILE-WITH-SENSITIVE-DATA" >> .gitignore $ git add .gitignore $ git commit -m "Add YOUR-FILE-WITH-SENSITIVE-DATA to .gitignore" - > [master 051452f] Add YOUR-FILE-WITH-SENSITIVE-DATA to .gitignore + > [main 051452f] Add YOUR-FILE-WITH-SENSITIVE-DATA to .gitignore > 1 files changed, 1 insertions(+), 0 deletions(-) ``` 5. 仔细检查您是否已从仓库历史记录中删除所需的所有内容，并且所有分支均已检出。 @@ -102,7 +102,7 @@ $ bfg --replace-text passwords.txt > Writing objects: 100% (1058/1058), 148.85 KiB, done. > Total 1058 (delta 590), reused 602 (delta 378) > To https://{% data variables.command_line.codeblock %}/YOUR-USERNAME/YOUR-REPOSITORY.git - > + 48dc599...051452f master -> master (forced update) + > + 48dc599...051452f main -> main (forced update) ``` 7. 要从[标记的发行版](/articles/about-releases)删除敏感文件，您还需要强制推送 Git 标记： ```shell @@ -113,7 +113,7 @@ $ bfg --replace-text passwords.txt > Writing objects: 100% (321/321), 331.74 KiB | 0 bytes/s, done. > Total 321 (delta 124), reused 269 (delta 108) > To https://{% data variables.command_line.codeblock %}/YOUR-USERNAME/YOUR-REPOSITORY.git - > + 48dc599...051452f master -> master (forced update) + > + 48dc599...051452f main -> main (forced update) ``` 8. 联系 {% data variables.contact.contact_support %}，请求他们删除 {% data variables.product.product_name %} 上拉取请求中敏感数据的缓存视图和引用。 9. 告知协作者[变基](https://git-scm.com/book/en/Git-Branching-Rebasing)而*不是*合并他们从旧的（污染的） 仓库历史记录创建的任何分支。 一次合并提交可能会重新引入您刚刚遇到清除问题的部分或全部污染的历史记录。 diff --git a/translations/zh-CN/content/github/authenticating-to-github/reviewing-your-authorized-applications-oauth.md b/translations/zh-CN/content/github/authenticating-to-github/reviewing-your-authorized-applications-oauth.md index b7720cd61c00..7ee281d402dd 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/reviewing-your-authorized-applications-oauth.md +++ b/translations/zh-CN/content/github/authenticating-to-github/reviewing-your-authorized-applications-oauth.md @@ -1,6 +1,6 @@ --- title: 审查您的授权应用程序 (OAuth) -intro: 您应检查授权的应用程序，以验证没有授权具有扩展权限的新应用程序，例如那些可以访问您的私有仓库的应用程序。 +intro: '您应检查授权的应用程序，以验证没有授权具有扩展权限的新应用程序，例如那些可以访问您的私有仓库的应用程序。' redirect_from: - /articles/reviewing-your-authorized-applications-oauth versions: diff --git a/translations/zh-CN/content/github/authenticating-to-github/reviewing-your-security-log.md b/translations/zh-CN/content/github/authenticating-to-github/reviewing-your-security-log.md index ee273b18626b..38e933477191 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/reviewing-your-security-log.md +++ b/translations/zh-CN/content/github/authenticating-to-github/reviewing-your-security-log.md @@ -1,6 +1,6 @@ --- -title: 审查您的安全日志 -intro: 您可以查看用户帐户的安全日志，以更好地了解您执行的操作以及其他人执行的与您有关的操作。 +title: Reviewing your security log +intro: You can review the security log for your user account to better understand actions you've performed and actions others have performed that involve you. redirect_from: - /articles/reviewing-your-security-log versions: @@ -8,233 +8,238 @@ versions: enterprise-server: '*' --- -### 访问安全日志 +### Accessing your security log -安全日志列出过去 90 天内执行的所有操作{% if currentVersion ver_lt "enterprise-server@2.20" %}最多 50 条{% endif %}。 +The security log lists all actions performed within the last 90 days{% if currentVersion ver_lt "enterprise-server@2.20" %}, up to 50{% endif %}. {% data reusables.user_settings.access_settings %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -2. 在用户设置侧边栏中，单击 **Security log（安全日志）**。 ![安全日志选项卡](/assets/images/help/settings/audit-log-tab.png) +2. In the user settings sidebar, click **Security log**. + ![Security log tab](/assets/images/help/settings/audit-log-tab.png) {% else %} {% data reusables.user_settings.security %} -3. 在“Security history（安全历史记录）”下，将显示您的日志。 ![安全日志](/assets/images/help/settings/user_security_log.png) -4. 单击条目以查看有关该事件的更多信息。 ![安全日志](/assets/images/help/settings/user_security_history_action.png) +3. Under "Security history," your log is displayed. + ![Security log](/assets/images/help/settings/user_security_log.png) +4. Click on an entry to see more information about the event. + ![Security log](/assets/images/help/settings/user_security_history_action.png) {% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -### 搜索安全日志 +### Searching your security log {% data reusables.audit_log.audit-log-search %} -#### 基于执行的操作搜索 +#### Search based on the action performed {% else %} -### 了解安全日志中的事件 - -安全日志中列出的操作分为以下类别： |{% endif %} -| 类别名称 | 描述 | -| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |{% if currentVersion == "free-pro-team@latest" %} -| `account_recovery_token` | 包含与[添加恢复令牌](/articles/configuring-two-factor-authentication-recovery-methods)相关的所有活动。 | -| `计费，帐单` | 包含与帐单信息相关的所有活动。 | -| `marketplace_agreement_signature` | 包含与签署 {% data variables.product.prodname_marketplace %} 开发者协议相关的所有活动。 | -| `marketplace_listing` | 包含与 {% data variables.product.prodname_marketplace %} 中列出的应用程序相关的所有活动。{% endif %} -| `oauth_access` | 包含与您已连接的 [{% data variables.product.prodname_oauth_app %}](/articles/authorizing-oauth-apps) 相关的所有活动。{% if currentVersion == "free-pro-team@latest" %} -| `payment_method` | 包含与 {% data variables.product.prodname_dotcom %} 订阅支付相关的所有活动。{% endif %} -| `profile_picture` | 包含与头像相关的所有活动。 | -| `project` | 包含与项目板相关的所有活动。 | -| `public_key` | 包含与[公共 SSH 密钥](/articles/adding-a-new-ssh-key-to-your-github-account)相关的所有活动。 | -| `repo` | 包含与您拥有的仓库相关的所有活动。{% if currentVersion == "free-pro-team@latest" %} -| `sponsors` | 包含与 {% data variables.product.prodname_sponsors %}和赞助者按钮相关的所有事件（请参阅“[关于 {% data variables.product.prodname_sponsors %}](/articles/about-github-sponsors)”和“[在仓库中显示赞助者按钮](/articles/displaying-a-sponsor-button-in-your-repository)”）{% endif %}{% if currentVersion != "free-pro-team@latest" %} -| `团队` | 包含与您作为成员的团队相关的所有活动。{% endif %} -| `two_factor_authentication` | 包含与[双重身份验证](/articles/securing-your-account-with-two-factor-authentication-2fa)相关的所有活动。 | -| `用户` | 包含与您的帐户相关的所有活动。 | - -下面列出了这些类别中各事件的说明。 +### Understanding events in your security log + +Actions listed in your security log are grouped within the following categories: +{% endif %} + +| Category Name | Description +|------------------|-------------------{% if currentVersion == "free-pro-team@latest" %} +| `account_recovery_token` | Contains all activities related to [adding a recovery token](/articles/configuring-two-factor-authentication-recovery-methods). +| `billing` | Contains all activities related to your billing information. +| `marketplace_agreement_signature` | Contains all activities related to signing the {% data variables.product.prodname_marketplace %} Developer Agreement. +| `marketplace_listing` | Contains all activities related to listing apps in {% data variables.product.prodname_marketplace %}.{% endif %} +| `oauth_access` | Contains all activities related to [{% data variables.product.prodname_oauth_app %}s](/articles/authorizing-oauth-apps) you've connected with.{% if currentVersion == "free-pro-team@latest" %} +| `payment_method` | Contains all activities related to paying for your {% data variables.product.prodname_dotcom %} subscription.{% endif %} +| `profile_picture` | Contains all activities related to your profile picture. +| `project` | Contains all activities related to project boards. +| `public_key` | Contains all activities related to [your public SSH keys](/articles/adding-a-new-ssh-key-to-your-github-account). +| `repo` | Contains all activities related to the repositories you own.{% if currentVersion == "free-pro-team@latest" %} +| `sponsors` | Contains all events related to {% data variables.product.prodname_sponsors %} and sponsor buttons (see "[About {% data variables.product.prodname_sponsors %}](/articles/about-github-sponsors)" and "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)"){% endif %}{% if currentVersion != "free-pro-team@latest" %} +| `team` | Contains all activities related to teams you are a part of.{% endif %} +| `two_factor_authentication` | Contains all activities related to [two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa). +| `user` | Contains all activities related to your account. + +A description of the events within these categories is listed below. {% if currentVersion == "free-pro-team@latest" %} -#### `account_recovery_token` 类别 +#### The `account_recovery_token` category -| 操作 | 描述 | -| ------------- | ----------------------------------------------------------------------------------------- | -| confirm | 当您成功[使用恢复提供程序存储新令牌](/articles/configuring-two-factor-authentication-recovery-methods)时触发。 | -| recover | 当您成功[取回帐户恢复令牌](/articles/recovering-your-account-if-you-lose-your-2fa-credentials)时触发。 | -| recover_error | 当 {% data variables.product.prodname_dotcom %} 无法验证所使用的令牌时触发。 | +| Action | Description +|------------------|------------------- +| confirm | Triggered when you successfully [store a new token with a recovery provider](/articles/configuring-two-factor-authentication-recovery-methods). +| recover | Triggered when you successfully [redeem an account recovery token](/articles/recovering-your-account-if-you-lose-your-2fa-credentials). +| recover_error | Triggered when a token is used but {% data variables.product.prodname_dotcom %} is not able to validate it. -#### `billing` 类别 +#### The `billing` category -| 操作 | 描述 | -| --------------------- | ---------------------------------------------------------------------------------------------------------------- | -| change_billing_type | 当您[更改 {% data variables.product.prodname_dotcom %} 的支付方式](/articles/adding-or-editing-a-payment-method)时触发。 | -| change_email | 当您[更改您的电子邮件地址](/articles/changing-your-primary-email-address)时触发。 | +| Action | Description +|------------------|------------------- +| change_billing_type | Triggered when you [change how you pay](/articles/adding-or-editing-a-payment-method) for {% data variables.product.prodname_dotcom %}. +| change_email | Triggered when you [change your email address](/articles/changing-your-primary-email-address). -#### `marketplace_agreement_signature` 类别 +#### The `marketplace_agreement_signature` category -| 操作 | 描述 | -| ------ | -------------------------------------------------------------------- | -| create | 在签署 {% data variables.product.prodname_marketplace %} 开发者协议时触发。 | +| Action | Description +|------------------|------------------- +| create | Triggered when you sign the {% data variables.product.prodname_marketplace %} Developer Agreement. -#### `marketplace_listing` 类别 +#### The `marketplace_listing` category -| 操作 | 描述 | -| ------- | ------------------------------------------------------------------------- | -| 批准 | 当您的列表被批准包含在 {% data variables.product.prodname_marketplace %} 中时触发。 | -| create | 当您在 {% data variables.product.prodname_marketplace %} 中为应用程序创建列表时触发。 | -| delist | 当您的列表从 {% data variables.product.prodname_marketplace %} 中被删除时触发。 | -| redraft | 将您的列表被返回到草稿状态时触发。 | -| reject | 当您的列表被拒绝包含在 {% data variables.product.prodname_marketplace %} 中时触发。 | +| Action | Description +|------------------|------------------- +| approve | Triggered when your listing is approved for inclusion in {% data variables.product.prodname_marketplace %}. +| create | Triggered when you create a listing for your app in {% data variables.product.prodname_marketplace %}. +| delist | Triggered when your listing is removed from {% data variables.product.prodname_marketplace %}. +| redraft | Triggered when your listing is sent back to draft state. +| reject | Triggered when your listing is not accepted for inclusion in {% data variables.product.prodname_marketplace %}. {% endif %} -#### `oauth_access` 类别 +#### The `oauth_access` category -| 操作 | 描述 | -| ------- | ----------------------------------------------------------------------------------------------------------------------------- | -| create | 当您[授予 {% data variables.product.prodname_oauth_app %} 访问权限](/articles/authorizing-oauth-apps)时触发。 | -| destroy | 当您[撤销 {% data variables.product.prodname_oauth_app %} 对您帐户的访问权限](/articles/reviewing-your-authorized-integrations)时触发。 | +| Action | Description +|------------------|------------------- +| create | Triggered when you [grant access to an {% data variables.product.prodname_oauth_app %}](/articles/authorizing-oauth-apps). +| destroy | Triggered when you [revoke an {% data variables.product.prodname_oauth_app %}'s access to your account](/articles/reviewing-your-authorized-integrations). {% if currentVersion == "free-pro-team@latest" %} -#### `payment_method` 类别 +#### The `payment_method` category -| 操作 | 描述 | -| ------ | ------------------------------------------------------ | -| clear | 当存档的[付款方式](/articles/removing-a-payment-method)被删除时触发。 | -| create | 在添加新的付款方式（例如新的信用卡或 PayPal 帐户）时触发。 | -| update | 当现有付款方式被更新时触发。 | +| Action | Description +|------------------|------------------- +| clear | Triggered when [a payment method](/articles/removing-a-payment-method) on file is removed. +| create | Triggered when a new payment method is added, such as a new credit card or PayPal account. +| update | Triggered when an existing payment method is updated. {% endif %} -#### `profile_picture` 类别 - -| 操作 | 描述 | -| ------ | ------------------------------------------------------------ | -| update | 当您[设置或更新个人资料图片](/articles/setting-your-profile-picture/)时触发。 | - -#### `project` 类别 - -| 操作 | 描述 | -| ------------------------ | ------------------------------------------------------------------------------------------------------------------------- | -| `create` | 在创建项目板时触发。 | -| `rename` | 当项目板被重命名时触发。 | -| `update` | 当项目板被更新时触发。 | -| `delete` | 在删除项目板时触发。 | -| `link` | 当仓库被链接到项目板时触发。 | -| `unlink` | 当仓库从项目板解除链接时触发。 | -| `project.access` | 当项目板的可见性被更改时触发。 | -| `update_user_permission` | Triggered when an outside collaborator is added to or removed from a project board or has their permission level changed. | - -#### `public_key` 类别 - -| 操作 | 描述 | -| ------ | ------------------------------------------------------------------------------------------------------------------------------ | -| create | 当您[为 {% data variables.product.product_name %} 帐户添加新公共 SSH 密钥](/articles/adding-a-new-ssh-key-to-your-github-account)时触发。 | -| delete | 当您[删除 {% data variables.product.product_name %} 帐户的公共 SSH 密钥](/articles/reviewing-your-ssh-keys)时触发。 | - -#### `repo` 类别 - -| 操作 | 描述 | -| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| access | 当您拥有的仓库[从“私有”切换到“公共”](/articles/making-a-private-repository-public)（反之亦然）时触发。 | -| add_member | 当 {% data variables.product.product_name %} 用户{% if currentVersion == "free-pro-team@latest" %}[被邀请协作使用](/articles/inviting-collaborators-to-a-personal-repository){% else %}[被授权协作使用](/articles/inviting-collaborators-to-a-personal-repository){% endif %}仓库时触发。 | -| add_topic | 当仓库所有者向仓库[添加主题](/articles/classifying-your-repository-with-topics)时触发。 | -| archived | 当仓库所有者[存档仓库](/articles/about-archiving-repositories)时触发。{% if currentVersion != "free-pro-team@latest" %} -| config.disable_anonymous_git_access | 当公共仓库中[禁用匿名 Git 读取权限](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)时触发。 | -| config.enable_anonymous_git_access | 当公共仓库中[启用匿名 Git 读取权限](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)时触发。 | -| config.lock_anonymous_git_access | 当仓库的[匿名 Git 读取权限设置被锁定](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)时触发。 | -| config.unlock_anonymous_git_access | 当仓库的[匿名 Git 读取权限设置被解锁](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)时触发。{% endif %} -| create | 在[创建新仓库](/articles/creating-a-new-repository)时触发。 | -| destroy | 当[仓库被删除](/articles/deleting-a-repository)时触发。{% if currentVersion == "free-pro-team@latest" %} -| 禁用 | 当仓库被禁用（例如，因[资金不足](/articles/unlocking-a-locked-account)）时触发。{% endif %}{% if currentVersion == "free-pro-team@latest" %} -| 启用 | 在重新启用仓库时触发。{% endif %} -| remove_member | 从[仓库中删除 {% data variables.product.product_name %} 用户的协作者身份](/articles/removing-a-collaborator-from-a-personal-repository)时触发。 | -| remove_topic | 当仓库所有者从仓库中删除主题时触发。 | -| rename | 当[仓库被重命名](/articles/renaming-a-repository)时触发。 | -| 转让 | 当[仓库被转让](/articles/how-to-transfer-a-repository)时触发。 | -| transfer_start | 在仓库转让即将发生时触发。 | -| unarchived | 当仓库所有者取消存档仓库时触发。 | +#### The `profile_picture` category + +| Action | Description +|------------------|------------------- +| update | Triggered when you [set or update your profile picture](/articles/setting-your-profile-picture/). + +#### The `project` category + +| Action | Description +|--------------------|--------------------- +| `create` | Triggered when a project board is created. +| `rename` | Triggered when a project board is renamed. +| `update` | Triggered when a project board is updated. +| `delete` | Triggered when a project board is deleted. +| `link` | Triggered when a repository is linked to a project board. +| `unlink` | Triggered when a repository is unlinked from a project board. +| `project.access` | Triggered when a project board's visibility is changed. +| `update_user_permission` | Triggered when an outside collaborator is added to or removed from a project board or has their permission level changed. + +#### The `public_key` category + +| Action | Description +|------------------|------------------- +| create | Triggered when you [add a new public SSH key to your {% data variables.product.product_name %} account](/articles/adding-a-new-ssh-key-to-your-github-account). +| delete | Triggered when you [remove a public SSH key to your {% data variables.product.product_name %} account](/articles/reviewing-your-ssh-keys). + +#### The `repo` category + +| Action | Description +|------------------|------------------- +| access | Triggered when you a repository you own is [switched from "private" to "public"](/articles/making-a-private-repository-public) (or vice versa). +| add_member | Triggered when a {% data variables.product.product_name %} user is {% if currentVersion == "free-pro-team@latest" %}[invited to have collaboration access](/articles/inviting-collaborators-to-a-personal-repository){% else %}[given collaboration access](/articles/inviting-collaborators-to-a-personal-repository){% endif %} to a repository. +| add_topic | Triggered when a repository owner [adds a topic](/articles/classifying-your-repository-with-topics) to a repository. +| archived | Triggered when a repository owner [archives a repository](/articles/about-archiving-repositories).{% if currentVersion != "free-pro-team@latest" %} +| config.disable_anonymous_git_access | Triggered when [anonymous Git read access is disabled](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) in a public repository. +| config.enable_anonymous_git_access | Triggered when [anonymous Git read access is enabled](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) in a public repository. +| config.lock_anonymous_git_access | Triggered when a repository's [anonymous Git read access setting is locked](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access). +| config.unlock_anonymous_git_access | Triggered when a repository's [anonymous Git read access setting is unlocked](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access).{% endif %} +| create | Triggered when [a new repository is created](/articles/creating-a-new-repository). +| destroy | Triggered when [a repository is deleted](/articles/deleting-a-repository).{% if currentVersion == "free-pro-team@latest" %} +| disable | Triggered when a repository is disabled (e.g., for [insufficient funds](/articles/unlocking-a-locked-account)).{% endif %}{% if currentVersion == "free-pro-team@latest" %} +| enable | Triggered when a repository is re-enabled.{% endif %} +| remove_member | Triggered when a {% data variables.product.product_name %} user is [removed from a repository as a collaborator](/articles/removing-a-collaborator-from-a-personal-repository). +| remove_topic | Triggered when a repository owner removes a topic from a repository. +| rename | Triggered when [a repository is renamed](/articles/renaming-a-repository). +| transfer | Triggered when [a repository is transferred](/articles/how-to-transfer-a-repository). +| transfer_start | Triggered when a repository transfer is about to occur. +| unarchived | Triggered when a repository owner unarchives a repository. {% if currentVersion == "free-pro-team@latest" %} -#### `sponsors` 类别 - -| 操作 | 描述 | -| ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| repo_funding_link_button_toggle | 在仓库中启用或禁用赞助按钮时触发（请参阅“[在仓库中显示赞助按钮](/articles/displaying-a-sponsor-button-in-your-repository)”） | -| repo_funding_links_file_action | 更改仓库中的 FUNDING 文件时触发（请参阅“[在仓库中显示赞助按钮](/articles/displaying-a-sponsor-button-in-your-repository)”） | -| sponsor_sponsorship_cancel | 当您取消赞助时触发（请参阅“[降级赞助](/articles/downgrading-a-sponsorship)”） | -| sponsor_sponsorship_create | 当您赞助开发者时触发（请参阅“[赞助开源开发者](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor#sponsoring-a-developer)”） | -| sponsor_sponsorship_preference_change | 当您更改是否接收被赞助开发者的电子邮件更新时触发（请参阅“[管理赞助](/articles/managing-your-sponsorship)”） | -| sponsor_sponsorship_tier_change | 当您升级或降级赞助时触发（请参阅“[升级赞助](/articles/upgrading-a-sponsorship)”和“[降级赞助](/articles/downgrading-a-sponsorship)”） | -| sponsored_developer_approve | 当您的 {% data variables.product.prodname_sponsors %} 帐户被批准时触发（请参阅“[为您的用户帐户设置 {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)”） | -| sponsored_developer_create | 当您的 {% data variables.product.prodname_sponsors %} 帐户创建时触发（请参阅“[为您的用户帐户设置 {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)”） | -| sponsored_developer_profile_update | 在编辑您的被赞助开发者个人资料时触发（请参阅“[编辑 {% data variables.product.prodname_sponsors %} 的个人资料详细信息](/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors)”） | -| sponsored_developer_request_approval | 提交您对 {% data variables.product.prodname_sponsors %} 的申请以供审批时触发（请参阅“[为您的用户帐户设置 {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)”） | -| sponsored_developer_tier_description_update | 当您更改赞助等级的说明时触发（请参阅“[更改赞助等级](/articles/changing-your-sponsorship-tiers)”） | -| sponsored_developer_update_newsletter_send | 当您向赞助者发送电子邮件更新时触发（请参阅“[联系赞助者](/articles/contacting-your-sponsors)”） | -| waitlist_invite_sponsored_developer | 当您从等候名单被邀请加入 {% data variables.product.prodname_sponsors %} 时触发（请参阅“[为您的用户帐户设置 {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)”） | -| waitlist_join | 当您加入成为被赞助开发者的等候名单时触发（请参阅“[为您的用户帐户设置 {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)”） | +#### The `sponsors` category + +| Action | Description +|------------------|------------------- +| repo_funding_link_button_toggle | Triggered when you enable or disable a sponsor button in your repository (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)") +| repo_funding_links_file_action | Triggered when you change the FUNDING file in your repository (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)") +| sponsor_sponsorship_cancel | Triggered when you cancel a sponsorship (see "[Downgrading a sponsorship](/articles/downgrading-a-sponsorship)") +| sponsor_sponsorship_create | Triggered when you sponsor a developer (see "[Sponsoring an open source contributor](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor#sponsoring-a-developer)") +| sponsor_sponsorship_preference_change | Triggered when you change whether you receive email updates from a sponsored developer (see "[Managing your sponsorship](/articles/managing-your-sponsorship)") +| sponsor_sponsorship_tier_change | Triggered when you upgrade or downgrade your sponsorship (see "[Upgrading a sponsorship](/articles/upgrading-a-sponsorship)" and "[Downgrading a sponsorship](/articles/downgrading-a-sponsorship)") +| sponsored_developer_approve | Triggered when your {% data variables.product.prodname_sponsors %} account is approved (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") +| sponsored_developer_create | Triggered when your {% data variables.product.prodname_sponsors %} account is created (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") +| sponsored_developer_profile_update | Triggered when you edit your sponsored developer profile (see "[Editing your profile details for {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors)") +| sponsored_developer_request_approval | Triggered when you submit your application for {% data variables.product.prodname_sponsors %} for approval (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") +| sponsored_developer_tier_description_update | Triggered when you change the description for a sponsorship tier (see "[Changing your sponsorship tiers](/articles/changing-your-sponsorship-tiers)") +| sponsored_developer_update_newsletter_send | Triggered when you send an email update to your sponsors (see "[Contacting your sponsors](/articles/contacting-your-sponsors)") +| waitlist_invite_sponsored_developer | Triggered when you are invited to join {% data variables.product.prodname_sponsors %} from the waitlist (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") +| waitlist_join | Triggered when you join the waitlist to become a sponsored developer (see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)") {% endif %} {% if currentVersion == "free-pro-team@latest" %} -#### `successor_invitation` 类别 - -| 操作 | 描述 | -| ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| accept | 当您接受继承邀请时触发（请参阅“[保持用户帐户仓库的所有权连续性](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)”） | -| cancel | 当您取消继承邀请时触发（请参阅“[保持用户帐户仓库的所有权连续性](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)”） | -| create | 当您创建继承邀请时触发（请参阅“[保持用户帐户仓库的所有权连续性](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)”） | -| decline | 当您拒绝继承邀请时触发（请参阅“[保持用户帐户仓库的所有权连续性](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)”） | -| revoke | 当您撤销继承邀请时触发（请参阅“[保持用户帐户仓库的所有权连续性](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)”） | +#### The `successor_invitation` category + +| Action | Description +|------------------|------------------- +| accept | Triggered when you accept a succession invitation (see "[Maintaining ownership continuity of your user account's repositories](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") +| cancel | Triggered when you cancel a succession invitation (see "[Maintaining ownership continuity of your user account's repositories](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") +| create | Triggered when you create a succession invitation (see "[Maintaining ownership continuity of your user account's repositories](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") +| decline | Triggered when you decline a succession invitation (see "[Maintaining ownership continuity of your user account's repositories](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") +| revoke | Triggered when you revoke a succession invitation (see "[Maintaining ownership continuity of your user account's repositories](/github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories)") {% endif %} {% if currentVersion != "free-pro-team@latest" %} -#### `team` 类别 +#### The `team` category -| 操作 | 描述 | -| ----------------- | ------------------------------------------------------------------------ | -| add_member | 当您所属组织的成员[将您添加到团队](/articles/adding-organization-members-to-a-team)时触发。 | -| add_repository | 当您所属团队被授予控制仓库的权限时触发。 | -| create | 当您所属组织中创建了新团队时触发。 | -| destroy | 当您所属团队从组织中被删除时触发。 | -| remove_member | [从您所属团队中删除组织成员](/articles/removing-organization-members-from-a-team)时触发。 | -| remove_repository | 当仓库不再受团队控制时触发。 | +| Action | Description +|------------------|------------------- +| add_member | Triggered when a member of an organization you belong to [adds you to a team](/articles/adding-organization-members-to-a-team). +| add_repository | Triggered when a team you are a member of is given control of a repository. +| create | Triggered when a new team in an organization you belong to is created. +| destroy | Triggered when a team you are a member of is deleted from the organization. +| remove_member | Triggered when a member of an organization is [removed from a team](/articles/removing-organization-members-from-a-team) you are a member of. +| remove_repository | Triggered when a repository is no longer under a team's control. {% endif %} -#### `two_factor_authentication` 类别 - -| 操作 | 描述 | -| -------- | ----------------------------------------------------------------------------------- | -| enabled | 在启用[双重身份验证](/articles/securing-your-account-with-two-factor-authentication-2fa)时触发。 | -| disabled | 在禁用双重身份验证时触发。 | - -#### `user` 类别 - -| 操作 | 描述 | -| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | -| add_email | 当您[添加新电子邮件地址](/articles/changing-your-primary-email-address)时触发。 | -| create | 当您创建新用户帐户时触发。 | -| remove_email | 当您删除电子邮件地址时触发。 | -| rename | 当您重命名帐户时触发。 | -| change_password | 当您更改密码时触发。 | -| forgot_password | 当您要求[重置密码](/articles/how-can-i-reset-my-password)时触发。 | -| login | 当您登录 {% data variables.product.product_location %} 时触发。 | -| failed_login | 当您未能成功登录时触发。 | -| two_factor_requested | 当 {% data variables.product.product_name %} 要求您提供[双重身份验证代码](/articles/accessing-github-using-two-factor-authentication)时触发。 | -| show_private_contributions_count | 当您[在个人资料中公开私有贡献](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile)时触发。 | -| hide_private_contributions_count | 当您[在个人资料中隐藏私有贡献](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile)时触发。{% if currentVersion == "free-pro-team@latest" %} -| report_content | 当您[举报议题或拉取请求，或者举报对议题、拉取请求或提交的评论](/articles/reporting-abuse-or-spam)时触发。{% endif %} - -#### `user_status` 类别 - -| 操作 | 描述 | -| ------- | -------------------------------------------------------------------------------------------- | -| update | 当您在个人资料中设置或更改状态时触发。 更多信息请参阅“[设置状态](/articles/personalizing-your-profile/#setting-a-status)”。 | -| destroy | 当您在个人资料中清除状态时触发。 | +#### The `two_factor_authentication` category + +| Action | Description +|------------------|------------------- +| enabled | Triggered when [two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa) is enabled. +| disabled | Triggered when two-factor authentication is disabled. + +#### The `user` category + +| Action | Description +|--------------------|--------------------- +| add_email | Triggered when you [add a new email address](/articles/changing-your-primary-email-address). +| create | Triggered when you create a new user account. +| remove_email | Triggered when you remove an email address. +| rename | Triggered when you rename your account. +| change_password | Triggered when you change your password. +| forgot_password | Triggered when you ask for [a password reset](/articles/how-can-i-reset-my-password). +| login | Triggered when you log in to {% data variables.product.product_location %}. +| failed_login | Triggered when you failed to log in successfully. +| two_factor_requested | Triggered when {% data variables.product.product_name %} asks you for [your two-factor authentication code](/articles/accessing-github-using-two-factor-authentication). +| show_private_contributions_count | Triggered when you [publicize private contributions on your profile](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile). +| hide_private_contributions_count | Triggered when you [hide private contributions on your profile](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile).{% if currentVersion == "free-pro-team@latest" %} +| report_content | Triggered when you [report an issue or pull request, or a comment on an issue, pull request, or commit](/articles/reporting-abuse-or-spam).{% endif %} + +#### The `user_status` category + +| Action | Description +|--------------------|--------------------- +| update | Triggered when you set or change the status on your profile. For more information, see "[Setting a status](/articles/personalizing-your-profile/#setting-a-status)." +| destroy | Triggered when you clear the status on your profile. {% if currentVersion == "free-pro-team@latest" %} -### 导出安全日志 +### Exporting your security log {% data reusables.audit_log.export-log %} {% data reusables.audit_log.exported-log-keys-and-values %} diff --git a/translations/zh-CN/content/github/authenticating-to-github/reviewing-your-ssh-keys.md b/translations/zh-CN/content/github/authenticating-to-github/reviewing-your-ssh-keys.md index 601d53c3660c..71ea5e3d0586 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/reviewing-your-ssh-keys.md +++ b/translations/zh-CN/content/github/authenticating-to-github/reviewing-your-ssh-keys.md @@ -1,6 +1,6 @@ --- -title: 审查 SSH 密钥 -intro: '为确保凭据安全，您应定期审核 SSH 密钥、部署密钥并审查访问 {% data variables.product.product_name %} 帐户的授权应用程序。' +title: Reviewing your SSH keys +intro: 'To keep your credentials secure, you should regularly audit your SSH keys, deploy keys, and review authorized applications that access your {% data variables.product.product_name %} account.' redirect_from: - /articles/keeping-your-application-access-tokens-safe/ - /articles/keeping-your-ssh-keys-and-application-access-tokens-safe/ @@ -10,37 +10,43 @@ versions: enterprise-server: '*' --- -您可以删除未经授权（或可能已泄密）的 SSH 密钥，以确保攻击者无法再访问您的仓库。 您还可以批准有效的现有 SSH 密钥。 +You can delete unauthorized (or possibly compromised) SSH keys to ensure that an attacker no longer has access to your repositories. You can also approve existing SSH keys that are valid. {% mac %} {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -3. 在 SSH Settings（SSH 设置）页面中，记下与您的帐户关联的 SSH 密钥。 对于您无法识别或已过期的密钥，请单击 **Delete（删除）**。 如果有您要保留的有效 SSH 密钥，请单击 **Approve（批准）**。 ![SSH 密钥列表](/assets/images/help/settings/settings-ssh-key-review.png) +3. On the SSH Settings page, take note of the SSH keys associated with your account. For those that you don't recognize, or that are out-of-date, click **Delete**. If there are valid SSH keys you'd like to keep, click **Approve**. + ![SSH key list](/assets/images/help/settings/settings-ssh-key-review.png) {% tip %} - **注：**如果您由于 Git 操作失败而审核 SSH 密钥，则导致 [SSH 密钥审核错误](/articles/error-we-re-doing-an-ssh-key-audit)的未验证密钥将在 SSH 密钥列表中突出显示。 ![未验证的 SSH 密钥](/assets/images/help/settings/settings-ssh-key-review-highlight.png) + **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys. {% endtip %} -4. 打开终端。 +4. Open Terminal. 5. {% data reusables.command_line.start_ssh_agent %} -6. 找到并记录公钥指纹。 如果使用的是 OpenSSH 6.7 或更早版本： +6. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` - 如果使用的是 OpenSSH 6.8 或更新版本： + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} -7. {% data variables.product.product_name %} 上的 SSH 密钥*应*匹配您计算机上的相同密钥。 +7. The SSH keys on {% data variables.product.product_name %} *should* match the same keys on your computer. {% endmac %} @@ -48,33 +54,39 @@ versions: {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -3. 在 SSH Settings（SSH 设置）页面中，记下与您的帐户关联的 SSH 密钥。 对于您无法识别或已过期的密钥，请单击 **Delete（删除）**。 如果有您要保留的有效 SSH 密钥，请单击 **Approve（批准）**。 ![SSH 密钥列表](/assets/images/help/settings/settings-ssh-key-review.png) +3. On the SSH Settings page, take note of the SSH keys associated with your account. For those that you don't recognize, or that are out-of-date, click **Delete**. If there are valid SSH keys you'd like to keep, click **Approve**. + ![SSH key list](/assets/images/help/settings/settings-ssh-key-review.png) {% tip %} - **注：**如果您由于 Git 操作失败而审核 SSH 密钥，则导致 [SSH 密钥审核错误](/articles/error-we-re-doing-an-ssh-key-audit)的未验证密钥将在 SSH 密钥列表中突出显示。![未验证的 SSH 密钥](/assets/images/help/settings/settings-ssh-key-review-highlight.png) + **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys. {% endtip %} -4. 打开 Git Bash。 如果您使用 {% data variables.product.prodname_desktop %} 中随附的 Git Shell，请打开 Git Shell 并跳至步骤 6。 +4. Open Git Bash. If you're using Git Shell, which is included in {% data variables.product.prodname_desktop %}, open Git Shell and skip to step 6. 5. {% data reusables.desktop.windows_git_bash_turn_on_ssh_agent %} {% data reusables.desktop.windows_git_for_windows_turn_on_ssh_agent %} -6. 找到并记录公钥指纹。 如果使用的是 OpenSSH 6.7 或更早版本： +6. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` - 如果使用的是 OpenSSH 6.8 或更新版本： + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} -7. {% data variables.product.product_name %} 上的 SSH 密钥*应*匹配您计算机上的相同密钥。 +7. The SSH keys on {% data variables.product.product_name %} *should* match the same keys on your computer. {% endwindows %} @@ -82,36 +94,42 @@ versions: {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} -3. 在 SSH Settings（SSH 设置）页面中，记下与您的帐户关联的 SSH 密钥。 对于您无法识别或已过期的密钥，请单击 **Delete（删除）**。 如果有您要保留的有效 SSH 密钥，请单击 **Approve（批准）**。 ![SSH 密钥列表](/assets/images/help/settings/settings-ssh-key-review.png) +3. On the SSH Settings page, take note of the SSH keys associated with your account. For those that you don't recognize, or that are out-of-date, click **Delete**. If there are valid SSH keys you'd like to keep, click **Approve**. + ![SSH key list](/assets/images/help/settings/settings-ssh-key-review.png) {% tip %} - **注：**如果您由于 Git 操作失败而审核 SSH 密钥，则导致 [SSH 密钥审核错误](/articles/error-we-re-doing-an-ssh-key-audit)的未验证密钥将在 SSH 密钥列表中突出显示。 ![未验证的 SSH 密钥](/assets/images/help/settings/settings-ssh-key-review-highlight.png) + **Note:** If you're auditing your SSH keys due to an unsuccessful Git operation, the unverified key that caused the [SSH key audit error](/articles/error-we-re-doing-an-ssh-key-audit) will be highlighted in the list of SSH keys. {% endtip %} -4. 打开终端。 +4. Open Terminal. 5. {% data reusables.command_line.start_ssh_agent %} -6. 找到并记录公钥指纹。 如果使用的是 OpenSSH 6.7 或更早版本： +6. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're using OpenSSH 6.7 or older: ```shell $ ssh-add -l > 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` - 如果使用的是 OpenSSH 6.8 或更新版本： + If you're using OpenSSH 6.8 or newer: ```shell $ ssh-add -l -E md5 > 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA) ``` + {% else %} + ```shell + $ ssh-add -l -E sha256 + > 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA) + ```{% endif %} -7. {% data variables.product.product_name %} 上的 SSH 密钥*应*匹配您计算机上的相同密钥。 +7. The SSH keys on {% data variables.product.product_name %} *should* match the same keys on your computer. {% endlinux %} {% warning %} -**警告**：如果在 {% data variables.product.product_name %} 上看到您不熟悉的 SSH 密钥，请立即删除并联系 {% data variables.contact.contact_support %}寻求进一步的帮助。 无法识别的公钥可能表示安全问题。 +**Warning**: If you see an SSH key you're not familiar with on {% data variables.product.product_name %}, delete it immediately and contact {% data variables.contact.contact_support %} for further help. An unidentified public key may indicate a possible security concern. {% endwarning %} diff --git a/translations/zh-CN/content/github/authenticating-to-github/signing-commits.md b/translations/zh-CN/content/github/authenticating-to-github/signing-commits.md index 389267a8b1c3..6d4e5f646119 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/signing-commits.md +++ b/translations/zh-CN/content/github/authenticating-to-github/signing-commits.md @@ -1,6 +1,6 @@ --- title: 对提交签名 -intro: '您可以使用 GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} 或 S/MIME{% endif %} 在本地为提交签名。' +intro: 'You can sign commits locally using GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} or S/MIME{% endif %}.' redirect_from: - /articles/signing-commits-and-tags-using-gpg/ - /articles/signing-commits-using-gpg/ @@ -39,7 +39,8 @@ versions: $ git push # Pushes your local commits to the remote repository ``` -4. 在 {% data variables.product.product_name %} 上，导航到您的拉取请求。 +4. 在 +{% data variables.product.product_name %}, navigate to your pull request. {% data reusables.repositories.review-pr-commits %} 5. 要查看关于已验证签名的更多详细信息，请单击 Verified（已验证）。 ![已签名提交](/assets/images/help/commits/gpg-signed-commit-verified-without-details.png) diff --git a/translations/zh-CN/content/github/authenticating-to-github/signing-tags.md b/translations/zh-CN/content/github/authenticating-to-github/signing-tags.md index bf2bdfb0d650..f715b542e0f7 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/signing-tags.md +++ b/translations/zh-CN/content/github/authenticating-to-github/signing-tags.md @@ -1,6 +1,6 @@ --- title: 对标记签名 -intro: You can sign tags locally using GPG or S/MIME. +intro: 您可以使用 GPG 或 S/MIME 在本地对标记进行签名。 redirect_from: - /articles/signing-tags-using-gpg/ - /articles/signing-tags diff --git a/translations/zh-CN/content/github/authenticating-to-github/telling-git-about-your-signing-key.md b/translations/zh-CN/content/github/authenticating-to-github/telling-git-about-your-signing-key.md index 353f86380c17..843829686bc8 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/telling-git-about-your-signing-key.md +++ b/translations/zh-CN/content/github/authenticating-to-github/telling-git-about-your-signing-key.md @@ -1,6 +1,6 @@ --- title: 将您的签名密钥告知 Git -intro: '要在本地对提交签名，您需要告知 Git 您有想要使用的 GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} 或 X.509{% endif %} 密钥。' +intro: 'To sign commits locally, you need to inform Git that there''s a GPG{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} or X.509{% endif %} key you''d like to use.' redirect_from: - /articles/telling-git-about-your-gpg-key/ - /articles/telling-git-about-your-signing-key diff --git a/translations/zh-CN/content/github/authenticating-to-github/updating-your-github-access-credentials.md b/translations/zh-CN/content/github/authenticating-to-github/updating-your-github-access-credentials.md index 6b6214ea6cc2..7b783b14c0e2 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/updating-your-github-access-credentials.md +++ b/translations/zh-CN/content/github/authenticating-to-github/updating-your-github-access-credentials.md @@ -12,7 +12,7 @@ versions: ### 请求新密码 -1. 要请求新密码，请访问 {% if currentVersion == "free-pro-team@latest" %}https://{% data variables.product.product_url %}/password_reset{% else %}`https://{% data variables.product.product_url %}/password_reset`{% endif %}。 +1. To request a new password, visit {% if currentVersion == "free-pro-team@latest" %}https://{% data variables.product.product_url %}/password_reset{% else %}`https://{% data variables.product.product_url %}/password_reset`{% endif %}. 2. 输入与您的个人 {% data variables.product.product_name %} 帐户关联的电子邮件地址，然后单击 **Send password reset email（发送密码重置电子邮件）**。如果您已配置，该电子邮件将发送到备用电子邮件地址。 ![密码重置电子邮件请求对话框](/assets/images/help/settings/password-recovery-email-request.png) 3. 我们将向您发送一封电子邮件，其中含有可让您重置密码的链接。 您必须在收到电子邮件后的 3 小时内单击此链接。 如果您没有收到来自我们的电子邮件，请确保检查垃圾邮件文件夹。 4. 单击电子邮件中的该链接后，系统将要求您输入新密码。 ![密码恢复框](/assets/images/help/settings/password_recovery_page.png) @@ -29,11 +29,7 @@ versions: 1. {% data variables.product.signin_link %}到 {% data variables.product.product_name %}。 {% data reusables.user_settings.access_settings %} -{%- if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} {% data reusables.user_settings.security %} -{%- else %} -{% data reusables.user_settings.account_settings %} -{%- endif %} 4. 在“Change password（更改密码）”下，输入旧密码、强新密码并确认新密码。 有关创建强密码的帮助，请参阅“[创建强密码](/articles/creating-a-strong-password)” 5. 单击 **Update password（更新密码）**。 diff --git a/translations/zh-CN/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md b/translations/zh-CN/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md index b1961b141151..773f628dc3fc 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md +++ b/translations/zh-CN/content/github/authenticating-to-github/working-with-ssh-key-passphrases.md @@ -73,7 +73,7 @@ fi unset env ``` -如果您的私钥没有存储在默认位置之一（如 `~/.ssh/id_rsa`{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} 或 `~/.ssh/id_dsa`{% endif %}），您需要告知 SSH 身份验证代理其所在位置。 要将密钥添加到 ssh-agent，请输入 `ssh-add ~/path/to/my_key`。 更多信息请参阅“[生成新的 SSH 密钥并添加到 ssh-agent](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/)” +If your private key is not stored in one of the default locations (like `~/.ssh/id_rsa`), you'll need to tell your SSH authentication agent where to find it. 要将密钥添加到 ssh-agent，请输入 `ssh-add ~/path/to/my_key`。 更多信息请参阅“[生成新的 SSH 密钥并添加到 ssh-agent](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/)” {% tip %} @@ -104,8 +104,7 @@ unset env 在 OS X Leopard 上通过 OS X El Capitan，这些默认私钥文件将自动处理： -- *.ssh/id_rsa*{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -- *.ssh/id_dsa*{% endif %} +- *.ssh/id_rsa* - *.ssh/identity* 初次使用密钥时，系统将提示您输入密码。 如果选择使用密钥链保存密码，则无需再次输入密码。 diff --git a/translations/zh-CN/content/github/building-a-strong-community/about-issue-and-pull-request-templates.md b/translations/zh-CN/content/github/building-a-strong-community/about-issue-and-pull-request-templates.md index df32a4b72268..d05b65396122 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/about-issue-and-pull-request-templates.md +++ b/translations/zh-CN/content/github/building-a-strong-community/about-issue-and-pull-request-templates.md @@ -1,6 +1,6 @@ --- title: 关于议题和拉取请求模板 -intro: 利用议题和拉取请求模板，可以自定义和标准化您希望贡献者在您的仓库中打开议题和拉取请求时加入的信息。 +intro: '利用议题和拉取请求模板，可以自定义和标准化您希望贡献者在您的仓库中打开议题和拉取请求时加入的信息。' redirect_from: - /articles/about-issue-and-pull-request-templates versions: @@ -10,7 +10,7 @@ versions: 在仓库中创建议题和拉取请求后，贡献者可以根据仓库的参与指南使用模板打开议题或描述其拉取请求中提议的更改。 有关向仓库添加参与指南的更多信息，请参阅“[设置仓库贡献者指南](/articles/setting-guidelines-for-repository-contributors)”。 -您可以为组织{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}或用户帐户{% endif %}创建默认的议题和拉取请求模板。 更多信息请参阅“[创建默认社区健康文件](/github/building-a-strong-community/creating-a-default-community-health-file)”。 +You can create default issue and pull request templates for your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %}. 更多信息请参阅“[创建默认社区健康文件](/github/building-a-strong-community/creating-a-default-community-health-file)”。 ### 议题模板 @@ -21,7 +21,7 @@ versions: 使用模板构建器，可以指定每个模板的标题和描述，添加模板内容，然后提交模板到默认分支或在仓库中打开拉取请求。 模板构建器会自动添加模板显示于新议题页面所需的 YAML 扉页标记。 更多信息请参阅“[为仓库配置议题模板](/articles/configuring-issue-templates-for-your-repository)”。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -{% data reusables.repositories.issue-template-config %} For more information, see "[Configuring issue templates for your repository](/github/building-a-strong-community/configuring-issue-templates-for-your-repository#configuring-the-template-chooser)." +{% data reusables.repositories.issue-template-config %}更多信息请参阅“[为仓库配置议题模板](/github/building-a-strong-community/configuring-issue-templates-for-your-repository#configuring-the-template-chooser)”。 {% endif %} 议题模板存储在仓库的默认分支的隐藏目录 `.github/ISSUE_TEMPLATE` 中。 如果您在另一个分支中创建模板，协作者将无法使用。 议题模板文件名不区分大小写，并且需要 *.md* 扩展名。 {% data reusables.repositories.valid-community-issues %} diff --git a/translations/zh-CN/content/github/building-a-strong-community/about-team-discussions.md b/translations/zh-CN/content/github/building-a-strong-community/about-team-discussions.md index 103a5a55c23c..d524ca5ee7e9 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/about-team-discussions.md +++ b/translations/zh-CN/content/github/building-a-strong-community/about-team-discussions.md @@ -1,6 +1,6 @@ --- title: 关于团队讨论 -intro: 您的团队可以共同计划、互相更新，或者在组织中团队页面的讨论帖子中讨论任何主题。 +intro: '您的团队可以共同计划、互相更新，或者在组织中团队页面的讨论帖子中讨论任何主题。' redirect_from: - /articles/about-team-discussions versions: @@ -26,7 +26,7 @@ versions: {% tip %} -**提示：**根据通知设置，您将通过电子邮件和/或 {% data variables.product.product_name %} 上的 web 通知页面收到更新。 更多信息请参阅{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}“[配置通知](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications){% else %}“[关于电子邮件通知](/github/receiving-notifications-about-activity-on-github/about-email-notifications)”和“[关于 web 通知](/github/receiving-notifications-about-activity-on-github/about-web-notifications){% endif %}”。 +**提示：**根据通知设置，您将通过电子邮件和/或 {% data variables.product.product_name %} 上的 web 通知页面收到更新。 For more information, see {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications){% else %}"[About email notifications](/github/receiving-notifications-about-activity-on-github/about-email-notifications)" and "[About web notifications](/github/receiving-notifications-about-activity-on-github/about-web-notifications){% endif %}." {% endtip %} @@ -34,7 +34,7 @@ versions: 要关闭团队讨论的通知，您可以取消订阅特定的讨论帖子，或者更改通知设置，以取消关注或完全忽略特定团队的讨论。 即使您取消关注团队的讨论，也可订阅特定讨论帖子的通知。 -更多信息请参阅{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}“[查看您的订阅](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions){% else %}“[订阅和退订通知](/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications){% endif %}”和“[嵌套的团队](/articles/about-teams/#nested-teams)”。 +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 %}"[Subscribing to and unsubscribing from notifications](/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications){% endif %}" and "[Nested teams](/articles/about-teams/#nested-teams)." ### 延伸阅读 diff --git a/translations/zh-CN/content/github/building-a-strong-community/about-wikis.md b/translations/zh-CN/content/github/building-a-strong-community/about-wikis.md index 0b2495706e79..0e68960be94f 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/about-wikis.md +++ b/translations/zh-CN/content/github/building-a-strong-community/about-wikis.md @@ -1,6 +1,6 @@ --- title: 关于 wikis -intro: 您可以将仓库文档托管在 wiki 中，以便其他人使用和参与您的项目。 +intro: '您可以将仓库文档托管在 wiki 中，以便其他人使用和参与您的项目。' redirect_from: - /articles/about-github-wikis/ - /articles/about-wikis diff --git a/translations/zh-CN/content/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project.md b/translations/zh-CN/content/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project.md index 6f7397bb4f5b..a91a91ce820d 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project.md +++ b/translations/zh-CN/content/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project.md @@ -1,6 +1,6 @@ --- title: 为项目添加行为准则 -intro: 采用行为准则制定社区标准，宣示欢迎大家参与的包容性项目，并且阐述对滥用的处理程序。 +intro: '采用行为准则制定社区标准，宣示欢迎大家参与的包容性项目，并且阐述对滥用的处理程序。' redirect_from: - /articles/adding-a-code-of-conduct-to-your-project versions: diff --git a/translations/zh-CN/content/github/building-a-strong-community/adding-a-license-to-a-repository.md b/translations/zh-CN/content/github/building-a-strong-community/adding-a-license-to-a-repository.md index 464b4c4a4e53..99f83b82d87d 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/adding-a-license-to-a-repository.md +++ b/translations/zh-CN/content/github/building-a-strong-community/adding-a-license-to-a-repository.md @@ -40,7 +40,7 @@ versions: 4. 在 **Edit new file（编辑新文件）**选项卡中，粘贴要使用的许可的全文。 {% data reusables.files.write_commit_message %} {% data reusables.files.choose-commit-email %} -7. 在提交消息字段下面，确定是要将提交添加到当前分支还是新分支。 If your current branch is `main`, you should choose to create a new branch for your commit and then create a pull request. For more information, see "[Creating a pull request](/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request)". ![提交分支选项](/assets/images/help/repository/choose-commit-branch.png) +7. 在提交消息字段下面，确定是要将提交添加到当前分支还是新分支。 如果当前分支是 `main`，则应选择为提交创建新分支，然后创建拉取请求。 更多信息请参阅“[创建拉取请求](/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request)”。 ![提交分支选项](/assets/images/help/repository/choose-commit-branch.png) 8. 单击 **Commit new file（提交新文件）**。 ![提交许可到分支](/assets/images/help/repository/license-submit-tool.png) {% endif %} diff --git a/translations/zh-CN/content/github/building-a-strong-community/adding-or-editing-wiki-pages.md b/translations/zh-CN/content/github/building-a-strong-community/adding-or-editing-wiki-pages.md index d8938cdbe059..16cbf6d37348 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/adding-or-editing-wiki-pages.md +++ b/translations/zh-CN/content/github/building-a-strong-community/adding-or-editing-wiki-pages.md @@ -45,7 +45,7 @@ $ git clone https://github.com/YOUR_USERNAME/YOUR_REPOSITORY.w # Clones the wiki locally ``` -在克隆 wiki 后，可以添加新文件、编辑现有文件以及提交更改。 You and your collaborators can create branches when working on wikis, but only changes pushed to the default branch will be made live and available to your readers. +在克隆 wiki 后，可以添加新文件、编辑现有文件以及提交更改。 您与协作者在操作 wiki 时可以创建分支，但只有推送到默认分支的更改才会生效并供读者使用。 ### 关于 wiki 文件名 diff --git a/translations/zh-CN/content/github/building-a-strong-community/adding-support-resources-to-your-project.md b/translations/zh-CN/content/github/building-a-strong-community/adding-support-resources-to-your-project.md index 97e3407165bf..447c28d38f8b 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/adding-support-resources-to-your-project.md +++ b/translations/zh-CN/content/github/building-a-strong-community/adding-support-resources-to-your-project.md @@ -12,7 +12,7 @@ versions: ![支持指南](/assets/images/help/issues/support_guidelines_in_issue.png) -您可以为组织{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}或用户帐户{% endif %}创建默认的支持资源。 更多信息请参阅“[创建默认社区健康文件](/github/building-a-strong-community/creating-a-default-community-health-file)”。 +You can create default support resources for your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %}. 更多信息请参阅“[创建默认社区健康文件](/github/building-a-strong-community/creating-a-default-community-health-file)”。 {% tip %} diff --git a/translations/zh-CN/content/github/building-a-strong-community/blocking-a-user-from-your-personal-account.md b/translations/zh-CN/content/github/building-a-strong-community/blocking-a-user-from-your-personal-account.md index 81278da62e05..dd63c292427d 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/blocking-a-user-from-your-personal-account.md +++ b/translations/zh-CN/content/github/building-a-strong-community/blocking-a-user-from-your-personal-account.md @@ -1,6 +1,6 @@ --- title: 阻止用户访问您的个人帐户 -intro: 您可以阻止用户以拒绝他们访问您的活动和仓库，以及阻止他们向您发送通知。 +intro: '您可以阻止用户以拒绝他们访问您的活动和仓库，以及阻止他们向您发送通知。' redirect_from: - /articles/blocking-a-user-from-your-personal-account versions: @@ -38,7 +38,7 @@ versions: - 关注您或在其活动馈送中查看您的内容 - 将您分配到议题或拉取请求 - 邀请您成为其仓库的协作者 -- Invite you as a collaborator on a security advisory +- 邀请您作为安全通告的协作者 - 在评论中交叉引用您的仓库 - 复刻、关注、固定您的仓库或对其标星 - 赞助您 diff --git a/translations/zh-CN/content/github/building-a-strong-community/collaborating-with-your-team.md b/translations/zh-CN/content/github/building-a-strong-community/collaborating-with-your-team.md index 35fe60483d7e..f9b327170b09 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/collaborating-with-your-team.md +++ b/translations/zh-CN/content/github/building-a-strong-community/collaborating-with-your-team.md @@ -1,6 +1,6 @@ --- title: 与您的团队协作 -intro: 在组织内，您的团队可使用团队讨论功能展开跨项目协作。 +intro: '在组织内，您的团队可使用团队讨论功能展开跨项目协作。' mapTopic: true redirect_from: - /articles/collaborating-with-your-team diff --git a/translations/zh-CN/content/github/building-a-strong-community/configuring-issue-templates-for-your-repository.md b/translations/zh-CN/content/github/building-a-strong-community/configuring-issue-templates-for-your-repository.md index 82b59e8301ed..88ee827896a8 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/configuring-issue-templates-for-your-repository.md +++ b/translations/zh-CN/content/github/building-a-strong-community/configuring-issue-templates-for-your-repository.md @@ -24,7 +24,7 @@ versions: 7. 要自动设置默认的议题标题、将议题分配给对仓库有读取权限的人或者对议题模板应用标签，请在“Optional additional information（可选附加信息）”下输入这些详细信息。 还可以通过 YAML 前页格式中的 `title`、`labels` 或 `assignees` 为议题模板添加这些详细信息。 ![议题模板的其他信息](/assets/images/help/repository/additional-issue-template-info.png) 8. 完成编辑和预览模板后，请单击页面右上角的 **Propose changes（提议更改）**。 ![提议更改按钮](/assets/images/help/repository/propose-changes-button.png) 9. 输入提交消息，描述您的更改。 ![议题模板提交消息字段](/assets/images/help/repository/issue-template-commit-message-field.png) -10. 在提交消息字段的下方，决定是直接将模板提交到默认分支，还是创建新分支并打开拉取请求。 有关拉取请求的更多信息，请参阅“[关于拉取请求](/articles/about-pull-requests)”。 ![选择将议题模板提交到 master 或打开拉取请求](/assets/images/help/repository/issue-template-commit-to-master-or-open-pull-request.png) +10. 在提交消息字段的下方，决定是直接将模板提交到默认分支，还是创建新分支并打开拉取请求。 有关拉取请求的更多信息，请参阅“[关于拉取请求](/articles/about-pull-requests)”。 ![Issue template commit to main or open pull request choice](/assets/images/help/repository/issue-template-commit-to-master-or-open-pull-request.png) 11. 单击 **Commit changes（提交更改）**。 将这些更改合并到默认分支后，贡献者在仓库中打开新议题时便可使用该模板。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} diff --git a/translations/zh-CN/content/github/building-a-strong-community/creating-a-default-community-health-file.md b/translations/zh-CN/content/github/building-a-strong-community/creating-a-default-community-health-file.md index d74d530b4eb2..792405b6aa19 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/creating-a-default-community-health-file.md +++ b/translations/zh-CN/content/github/building-a-strong-community/creating-a-default-community-health-file.md @@ -1,6 +1,6 @@ --- title: 创建默认社区健康文件 -intro: 您可以创建默认社区健康文件，例如 CONTRIBUTING 和 CODE_OF_CONDUCT。 默认文件将用于不包含该类型自有文件的帐户所拥有的任何公共仓库。 +intro: '您可以创建默认社区健康文件，例如 CONTRIBUTING 和 CODE_OF_CONDUCT。 默认文件将用于不包含该类型自有文件的帐户所拥有的任何公共仓库。' redirect_from: - /articles/creating-a-default-community-health-file-for-your-organization - /github/building-a-strong-community/creating-a-default-community-health-file-for-your-organization @@ -11,38 +11,38 @@ versions: ### 关于默认社区健康文件 -您可以将默认社区健康文件添加到组织{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}或用户帐户{% endif %}拥有的公共仓库 `.github` 的根目录。 +You can add default community health files to the root of a public repository called `.github` that is owned by an organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %}. 对于在以下任何位置不含该类型自有文件的帐户所拥有的任何公共仓库，{% data variables.product.product_name %} 将使用并显示默认文件： - 仓库的根目录 - `.github` 文件夹 - `docs` 文件夹 -例如，在不含自有 CONTRIBUTING 文件的公共仓库中创建议题或拉取请求的人将会看到指向默认 CONTRIBUTING 文件的链接。 如果仓库在其自己的 `.github/ISSUE_TEMPLATE` 文件夹{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}中含有任何文件，包括议题模板或*config.yml*文件{% endif %}，则不会使用默认 `.github/ISSUE_TEMPLATE` 文件夹的内容。 +例如，在不含自有 CONTRIBUTING 文件的公共仓库中创建议题或拉取请求的人将会看到指向默认 CONTRIBUTING 文件的链接。 If a repository has any files in its own `.github/ISSUE_TEMPLATE` folder{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}, including issue templates or a *config.yml* file,{% endif %} none of the contents of the default `.github/ISSUE_TEMPLATE` folder will be used. 默认文件不包含在各个仓库的克隆、包或下载中，因为它们只存储在 `.github` 仓库中。 ### 支持的文件类型 -您可以在组织{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}或用户帐户{% endif %}中为以下社区健康文件创建默认内容： +You can create defaults in your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %} for the following community health files: -| 社区健康文件 | 描述 | -| -------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" %} -| *CODE_OF_CONDUCT.md* | CODE_OF_CONDUCT 文件定义如何参与社区的标准。 更多信息请参阅“[为项目添加行为准则](/articles/adding-a-code-of-conduct-to-your-project/)”。{% endif %} -| *CONTRIBUTING.md* | CONTRIBUTING 文件说明人们应如何参与您的项目。 更多信息请参阅“[设置仓库参与者指南](/articles/setting-guidelines-for-repository-contributors/)”。{% if currentVersion == "free-pro-team@latest" %} -| *FUNDING.yml* | FUNDING 文件在仓库中显示赞助者按钮，以提高开源项目资助选项的可见性。 更多信息请参阅“[在仓库中显示赞助按钮](/articles/displaying-a-sponsor-button-in-your-repository)”。{% endif %} -| 议题和拉取请求模板{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} 和 *config.yml*{% endif %} | 议题和拉取请求模板可自定义和标准化您希望贡献者在您的仓库中打开议题和拉取请求时加入的信息。 更多信息请参阅“[关于议题和拉取请求模板](/articles/about-issue-and-pull-request-templates/)”。{% if currentVersion == "free-pro-team@latest" %} -| *SECURITY.md* | SECURITY 文件说明如何负责任地报告项目中的安全漏洞。 更多信息请参阅“[添加安全政策到仓库](/articles/adding-a-security-policy-to-your-repository)”。{% endif %} -| *SUPPORT.md* | SUPPORT 文件告知获取项目相关帮助的方式。 更多信息请参阅“[为项目添加支持资源](/articles/adding-support-resources-to-your-project/)”。 | +| 社区健康文件 | 描述 | +| --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% if currentVersion == "free-pro-team@latest" %} +| *CODE_OF_CONDUCT.md* | CODE_OF_CONDUCT 文件定义如何参与社区的标准。 更多信息请参阅“[为项目添加行为准则](/articles/adding-a-code-of-conduct-to-your-project/)”。{% endif %} +| *CONTRIBUTING.md* | CONTRIBUTING 文件说明人们应如何参与您的项目。 For more information, see "[Setting guidelines for repository contributors](/articles/setting-guidelines-for-repository-contributors/)."{% if currentVersion == "free-pro-team@latest" %} +| *FUNDING.yml* | FUNDING 文件在仓库中显示赞助者按钮，以提高开源项目资助选项的可见性。 更多信息请参阅“[在仓库中显示赞助按钮](/articles/displaying-a-sponsor-button-in-your-repository)”。{% endif %} +| Issue and pull request templates{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and *config.yml*{% endif %} | 议题和拉取请求模板可自定义和标准化您希望贡献者在您的仓库中打开议题和拉取请求时加入的信息。 For more information, see "[About issue and pull request templates](/articles/about-issue-and-pull-request-templates/)."{% if currentVersion == "free-pro-team@latest" %} +| *SECURITY.md* | SECURITY 文件说明如何负责任地报告项目中的安全漏洞。 更多信息请参阅“[添加安全政策到仓库](/articles/adding-a-security-policy-to-your-repository)”。{% endif %} +| *SUPPORT.md* | SUPPORT 文件告知获取项目相关帮助的方式。 更多信息请参阅“[为项目添加支持资源](/articles/adding-support-resources-to-your-project/)”。 | 您不能创建默认许可文件。 必须将许可文件添加到各个仓库中，以便在克隆、打包或下载项目时包含该文件。 ### 创建用于默认文件的仓库 {% data reusables.repositories.create_new %} -2. 使用 **Owner（所有者）** 下拉菜单选择要为其创建默认文件的组织{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} 或用户帐户{% endif %}。 ![所有者下拉菜单](/assets/images/help/repository/create-repository-owner.png) +2. Use the **Owner** drop-down menu, and select the organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %} you want to create default files for. ![所有者下拉菜单](/assets/images/help/repository/create-repository-owner.png) 3. 键入 **.github** 作为仓库的名称，可选择键入说明。 ![创建仓库字段](/assets/images/help/repository/default-file-repository-name.png) -4. 选择让仓库公开。 ![用于选择机密或公开状态的单选按钮](/assets/images/help/repository/create-repository-public-private.png) +4. Make sure the repository status is set to **Public** (a repository for default files cannot be private). ![用于选择机密或公开状态的单选按钮](/assets/images/help/repository/create-repository-public-private.png) {% data reusables.repositories.initialize-with-readme %} {% data reusables.repositories.create-repo %} -7. 在仓库中，创建一个受支持的社区健康文件。 议题模板{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}及其配置文件{% endif %} 必须在一个名为 `.github/ISSUE_TEMPLATE` 的文件夹中。 所有其他支持的文件必须在仓库的根目录中。 更多信息请参阅“[创建新文件](/articles/creating-new-files/)”。 +7. 在仓库中，创建一个受支持的社区健康文件。 Issue templates{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and their configuration file{% endif %} must be in a folder called `.github/ISSUE_TEMPLATE`. 所有其他支持的文件必须在仓库的根目录中。 更多信息请参阅“[创建新文件](/articles/creating-new-files/)”。 diff --git a/translations/zh-CN/content/github/building-a-strong-community/creating-a-pull-request-template-for-your-repository.md b/translations/zh-CN/content/github/building-a-strong-community/creating-a-pull-request-template-for-your-repository.md index 76dafa55051c..906d086356c7 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/creating-a-pull-request-template-for-your-repository.md +++ b/translations/zh-CN/content/github/building-a-strong-community/creating-a-pull-request-template-for-your-repository.md @@ -1,6 +1,6 @@ --- title: 为仓库创建拉取请求模板 -intro: 将拉取请求模板添加到仓库后，项目贡献者会自动在拉取请求正文中看到模板的内容。 +intro: '将拉取请求模板添加到仓库后，项目贡献者会自动在拉取请求正文中看到模板的内容。' redirect_from: - /articles/creating-a-pull-request-template-for-your-repository versions: @@ -12,7 +12,7 @@ versions: 您可以在任何支持的文件夹中创建 *PULL_REQUEST_TEMPLATE/* 子目录，以包含多个拉取请求模板，并使用 `template` 查询参数指定填充拉取请求正文的模板。 更多信息请参阅“[关于使用查询参数自动化议题和拉取请求](/articles/about-automation-for-issues-and-pull-requests-with-query-parameters)”。 -您可以为组织{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}或用户帐户{% endif %}创建默认的拉取请求模板。 更多信息请参阅“[创建默认社区健康文件](/github/building-a-strong-community/creating-a-default-community-health-file)”。 +You can create default pull request templates for your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %}. 更多信息请参阅“[创建默认社区健康文件](/github/building-a-strong-community/creating-a-default-community-health-file)”。 ### 添加拉取请求模板 diff --git a/translations/zh-CN/content/github/building-a-strong-community/creating-a-team-discussion.md b/translations/zh-CN/content/github/building-a-strong-community/creating-a-team-discussion.md index da290d8166bd..b7b140ea5b77 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/creating-a-team-discussion.md +++ b/translations/zh-CN/content/github/building-a-strong-community/creating-a-team-discussion.md @@ -1,6 +1,6 @@ --- title: 创建团队讨论 -intro: 任何组织成员都可以创建公开的团队讨论帖子。 要创建私密的团队讨论帖子，您必须是团队成员或组织所有者。 +intro: '任何组织成员都可以创建公开的团队讨论帖子。 要创建私密的团队讨论帖子，您必须是团队成员或组织所有者。' redirect_from: - /articles/creating-a-team-discussion versions: @@ -16,7 +16,7 @@ versions: {% data reusables.organizations.team-discussions-tab %} 6. 输入团队讨论标题和评论以开始对话。 ![新的团队讨论评论](/assets/images/help/projects/team-discussions-comment.png) 7. （可选）使用下拉菜单选择您的帖子是私密还是公开。 ![团队讨论隐私设置菜单](/assets/images/help/projects/team-discussions-privacy-menu.png) -8. Click **Comment**. ![创建新的团队讨论评论按钮](/assets/images/help/projects/team-discussions-comment-button.png) +8. 单击 **Comment（注释）**。 ![创建新的团队讨论评论按钮](/assets/images/help/projects/team-discussions-comment-button.png) ### 延伸阅读 diff --git a/translations/zh-CN/content/github/building-a-strong-community/documenting-your-project-with-wikis.md b/translations/zh-CN/content/github/building-a-strong-community/documenting-your-project-with-wikis.md index 9d1d3f53df36..7dd2904da15a 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/documenting-your-project-with-wikis.md +++ b/translations/zh-CN/content/github/building-a-strong-community/documenting-your-project-with-wikis.md @@ -1,6 +1,6 @@ --- title: 使用 wiki 为项目写文档 -intro: 可使用 wiki 分享有关项目的详细、长式信息。 +intro: '可使用 wiki 分享有关项目的详细、长式信息。' redirect_from: - /categories/49/articles/ - /categories/wiki/ diff --git a/translations/zh-CN/content/github/building-a-strong-community/editing-or-deleting-a-team-discussion.md b/translations/zh-CN/content/github/building-a-strong-community/editing-or-deleting-a-team-discussion.md index ae4e2ab11473..eecbc2c3ac50 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/editing-or-deleting-a-team-discussion.md +++ b/translations/zh-CN/content/github/building-a-strong-community/editing-or-deleting-a-team-discussion.md @@ -1,6 +1,6 @@ --- title: 编辑或删除团队讨论 -intro: 组织成员可在编辑或删除团队页面上的讨论 如果您是组织成员，您可以编辑或删除讨论。 +intro: '组织成员可在编辑或删除团队页面上的讨论 如果您是组织成员，您可以编辑或删除讨论。' redirect_from: - /articles/editing-or-deleting-a-team-discussion versions: @@ -13,7 +13,7 @@ versions: {% data reusables.organizations.specific_team %} {% data reusables.organizations.team-discussions-tab %} 6. 单击要编辑或删除的团队讨论旁边的 {% octicon "kebab-horizontal" aria-label="The edit icon" %}。 -7. Click **Edit**. 可选择单击 **Delete（删除）**。 ![编辑团队讨论按钮](/assets/images/help/projects/edit-team-discussions-button.png) +7. 单击 **Edit（编辑）**。 可选择单击 **Delete（删除）**。 ![编辑团队讨论按钮](/assets/images/help/projects/edit-team-discussions-button.png) 8. 根据需要修改团队讨论标题和评论，然后单击 **Update comment（更新评论）**。 ![更新评论按钮](/assets/images/help/projects/update-comment-button.png) ### 延伸阅读 diff --git a/translations/zh-CN/content/github/building-a-strong-community/editing-wiki-content.md b/translations/zh-CN/content/github/building-a-strong-community/editing-wiki-content.md index 7ddd4eae1c47..0a7dae8d0a1d 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/editing-wiki-content.md +++ b/translations/zh-CN/content/github/building-a-strong-community/editing-wiki-content.md @@ -1,6 +1,6 @@ --- title: 编辑 wiki 内容 -intro: 您可以将图片和内容链接添加到您的 wiki，并使用某些受支持的 MediaWiki 格式。 +intro: '您可以将图片和内容链接添加到您的 wiki，并使用某些受支持的 MediaWiki 格式。' redirect_from: - /articles/adding-links-to-wikis/ - /articles/how-do-i-add-links-to-my-wiki/ @@ -32,7 +32,7 @@ Wikis 可显示 PNG、JPEG 和 GIF 图片。 3. 使用 wiki 边栏，导航至要更改的页面，然后单击 **Edit（编辑）**。 4. 在 wiki 工具栏上，单击 **Image（图像）**。 ![Wiki 添加图像按钮](/assets/images/help/wiki/wiki_add_image.png) 5. 在“Insert Image”（插入图像）对话框，输入 URL 和 alt 文本（由搜索引擎和屏幕阅读器使用）。 -6. Click **OK**. +6. 单击 **OK（确定）**。 #### 链接到仓库中的图片 diff --git a/translations/zh-CN/content/github/building-a-strong-community/index.md b/translations/zh-CN/content/github/building-a-strong-community/index.md index 6f85fd6a017f..fca447f458ae 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/index.md +++ b/translations/zh-CN/content/github/building-a-strong-community/index.md @@ -1,6 +1,6 @@ --- title: 建立强大的社区 -intro: 无论您的项目是开源项目还是私有项目，您都可以创建一个健康和高效的协作环境。 +intro: '无论您的项目是开源项目还是私有项目，您都可以创建一个健康和高效的协作环境。' redirect_from: - /categories/building-a-strong-community versions: diff --git a/translations/zh-CN/content/github/building-a-strong-community/limiting-interactions-in-your-organization.md b/translations/zh-CN/content/github/building-a-strong-community/limiting-interactions-in-your-organization.md index 5a47d07e9a15..cc7b287aecae 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/limiting-interactions-in-your-organization.md +++ b/translations/zh-CN/content/github/building-a-strong-community/limiting-interactions-in-your-organization.md @@ -1,6 +1,6 @@ --- title: 限制组织中的交互 -intro: 组织所有者可临时限制某些用户在组织的公共仓库中评论、打开议题或创建拉取请求，在一定的期限内限制活动。 +intro: '组织所有者可临时限制某些用户在组织的公共仓库中评论、打开议题或创建拉取请求，在一定的期限内限制活动。' redirect_from: - /github/setting-up-and-managing-organizations-and-teams/limiting-interactions-in-your-organization - /articles/limiting-interactions-in-your-organization diff --git a/translations/zh-CN/content/github/building-a-strong-community/limiting-interactions-in-your-repository.md b/translations/zh-CN/content/github/building-a-strong-community/limiting-interactions-in-your-repository.md index a0dd3a548bea..5a84fc98fb79 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/limiting-interactions-in-your-repository.md +++ b/translations/zh-CN/content/github/building-a-strong-community/limiting-interactions-in-your-repository.md @@ -1,6 +1,6 @@ --- title: 限制仓库中的交互 -intro: 组织所有者或管理员可临时限制某些用户在公共仓库中评论、打开议题或创建拉取请求，在一定的期限内限制活动。 +intro: '组织所有者或管理员可临时限制某些用户在公共仓库中评论、打开议题或创建拉取请求，在一定的期限内限制活动。' redirect_from: - /articles/limiting-interactions-with-your-repository/ - /articles/limiting-interactions-in-your-repository diff --git a/translations/zh-CN/content/github/building-a-strong-community/locking-conversations.md b/translations/zh-CN/content/github/building-a-strong-community/locking-conversations.md index 2e3cfe139f5a..5e86b60383ee 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/locking-conversations.md +++ b/translations/zh-CN/content/github/building-a-strong-community/locking-conversations.md @@ -1,6 +1,6 @@ --- -title: 锁定对话 -intro: 仓库所有者和协作者以及对仓库具有写入权限的人员，能够永久或临时锁定关于议题、拉取请求和提交的对话，以缓和激烈的交互。 +title: Locking conversations +intro: 'Repository owners and collaborators, and people with write access to a repository, can lock conversations on issues, pull requests, and commits permanently or temporarily to defuse a heated interaction.' redirect_from: - /articles/locking-conversations versions: @@ -8,28 +8,32 @@ versions: enterprise-server: '*' --- -当整个对话没有建设性或者违反社区的行为准则{% if currentVersion == "free-pro-team@latest" %}或 GitHub 的[社区指导方针](/articles/github-community-guidelines){% endif %}时，锁定对话是明智之举。 在锁定对话时，也可公开说明锁定的原因。 +It's appropriate to lock a conversation when the entire conversation is not constructive or violates your community's code of conduct{% if currentVersion == "free-pro-team@latest" %} or GitHub's [Community Guidelines](/articles/github-community-guidelines){% endif %}. When you lock a conversation, you can also specify a reason, which is publicly visible. -锁定对话会创建对仓库具有读取权限的所有人可见的时间表事件。 但对话锁定者的用户名只有能够写入仓库的人可见。 对于没有写入权限的任何人，时间表事件会匿名化。 +Locking a conversation creates a timeline event that is visible to anyone with read access to the repository. However, the username of the person who locked the conversation is only visible to people with write access to the repository. For anyone without write access, the timeline event is anonymized. -![已锁定对话的匿名化时间表事件](/assets/images/help/issues/anonymized-timeline-entry-for-locked-conversation.png) +![Anonymized timeline event for a locked conversation](/assets/images/help/issues/anonymized-timeline-entry-for-locked-conversation.png) -当对话锁定时，仅[具有写入权限的人员](/articles/repository-permission-levels-for-an-organization/)以及[仓库所有者和协作者](/articles/permission-levels-for-a-user-account-repository/#collaborator-access-on-a-repository-owned-by-a-user-account)才可添加、隐藏和删除评论。 +While a conversation is locked, only [people with write access](/articles/repository-permission-levels-for-an-organization/) and [repository owners and collaborators](/articles/permission-levels-for-a-user-account-repository/#collaborator-access-on-a-repository-owned-by-a-user-account) can add, hide, and delete comments. -要搜索仓库中未存档的已锁定对话，可以使用搜索限定符 `is:locked` 和 `archived:false`。 对话在存档的仓库中会自动锁定。 更多信息请参阅“[搜索议题和拉取请求](/articles/searching-issues-and-pull-requests#search-based-on-whether-a-conversation-is-locked)”。 +To search for locked conversations in a repository that is not archived, you can use the search qualifiers `is:locked` and `archived:false`. Conversations are automatically locked in archived repositories. For more information, see "[Searching issues and pull requests](/articles/searching-issues-and-pull-requests#search-based-on-whether-a-conversation-is-locked)." -1. 也可选择撰写注释，解释您锁定对话的原因。 -2. 在议题或拉取请求的右边，或者提交页面中注释框的上方，单击 **Lock conversation（锁定对话）**。 ![锁定对话链接](/assets/images/help/repository/lock-conversation.png) -3. 可以选择锁定对话的原因。 ![锁定对话的原因菜单](/assets/images/help/repository/locking-conversation-reason-menu.png) -4. 阅读有关锁定对话的信息，然后单击 **Lock conversation on this issue（锁定关于此议题的对话）**、**Lock conversation on this pull request（锁定关于此拉取请求的对话）**或 **Lock conversation on this commit（锁定关于此提交的对话）**。 ![确定锁定并说明原因对话框](/assets/images/help/repository/lock-conversation-confirm-with-reason.png) -5. 准备好解锁对话时，单击 **Unlock conversation（解锁对话）**。 ![解锁对话链接](/assets/images/help/repository/unlock-conversation.png) +1. Optionally, write a comment explaining why you're locking the conversation. +2. In the right margin of the issue or pull request, or above the comment box on the commit page, click **Lock conversation**. +![Lock conversation link](/assets/images/help/repository/lock-conversation.png) +3. Optionally, choose a reason for locking the conversation. +![Reason for locking a conversation menu](/assets/images/help/repository/locking-conversation-reason-menu.png) +4. Read the information about locking conversations and click **Lock conversation on this issue**, **Lock conversation on this pull request**, or **Lock conversation on this commit**. +![Confirm lock with a reason dialog box](/assets/images/help/repository/lock-conversation-confirm-with-reason.png) +5. When you're ready to unlock the conversation, click **Unlock conversation**. +![Unlock conversation link](/assets/images/help/repository/unlock-conversation.png) -### 延伸阅读 +### Further reading -- "[设置健康参与的项目](/articles/setting-up-your-project-for-healthy-contributions)" -- "[使用模板鼓励有用的议题和拉取请求](/github/building-a-strong-community/using-templates-to-encourage-useful-issues-and-pull-requests)" -- "[管理破坏性评论](/articles/managing-disruptive-comments)"{% if currentVersion == "free-pro-team@latest" %} -- “[在 {% data variables.product.prodname_dotcom %} 上维护您的安全](/github/building-a-strong-community/maintaining-your-safety-on-github)” -- “[举报滥用或垃圾邮件](/articles/reporting-abuse-or-spam)” -- “[限制仓库中的交互](/github/building-a-strong-community/limiting-interactions-in-your-repository)” +- "[Setting up your project for healthy contributions](/articles/setting-up-your-project-for-healthy-contributions)" +- "[Using templates to encourage useful issues and pull requests](/github/building-a-strong-community/using-templates-to-encourage-useful-issues-and-pull-requests)" +- "[Managing disruptive comments](/articles/managing-disruptive-comments)"{% if currentVersion == "free-pro-team@latest" %} +- "[Maintaining your safety on {% data variables.product.prodname_dotcom %}](/github/building-a-strong-community/maintaining-your-safety-on-github)" +- "[Reporting abuse or spam](/articles/reporting-abuse-or-spam)" +- "[Limiting interactions in your repository](/github/building-a-strong-community/limiting-interactions-in-your-repository)" {% endif %} diff --git a/translations/zh-CN/content/github/building-a-strong-community/managing-disruptive-comments.md b/translations/zh-CN/content/github/building-a-strong-community/managing-disruptive-comments.md index 70492db403ba..809825ccfb66 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/managing-disruptive-comments.md +++ b/translations/zh-CN/content/github/building-a-strong-community/managing-disruptive-comments.md @@ -1,6 +1,6 @@ --- -title: 管理破坏性评论 -intro: '您可以{% if currentVersion == "free-pro-team@latest" %}隐藏、编辑、{% else %}编辑{% endif %}或删除对议题、拉取请求和提交的评论。' +title: Managing disruptive comments +intro: 'You can {% if currentVersion == "free-pro-team@latest" %}hide, edit,{% else %}edit{% endif %} or delete comments on issues, pull requests, and commits.' redirect_from: - /articles/editing-a-comment/ - /articles/deleting-a-comment/ @@ -10,69 +10,76 @@ versions: enterprise-server: '*' --- -### 隐藏评论 +### Hiding a comment -对仓库具有写入权限的任何人都可以隐藏议题、拉取请求及提交上的评论。 +Anyone with write access to a repository can hide comments on issues, pull requests, and commits. -如果评论偏离主题、已过期或已解决，您可能想要隐藏评论，以保持讨论重点或使拉取请求更易于导航和审查。 隐藏的评论已最小化，但对仓库具有读取权限的人员可将其展开。 +If a comment is off-topic, outdated, or resolved, you may want to hide a comment to keep a discussion focused or make a pull request easier to navigate and review. Hidden comments are minimized but people with read access to the repository can expand them. -![最小化的评论](/assets/images/help/repository/hidden-comment.png) +![Minimized comment](/assets/images/help/repository/hidden-comment.png) -1. 导航到您要隐藏的评论。 -2. 在评论的右上角，单击 {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}，然后单击 **Hide（隐藏）**。 ![显示编辑、隐藏、删除选项的水平烤肉串图标和评论调解菜单](/assets/images/help/repository/comment-menu.png) -3. 使用 "Choose a reason"（选择原因）下拉菜单，单击隐藏评论的原因。 然后单击 **Hide comment（隐藏评论）**。 +1. Navigate to the comment you'd like to hide. +2. In the upper-right corner of the comment, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Hide**. + ![The horizontal kebab icon and comment moderation menu showing the edit, hide, delete options](/assets/images/help/repository/comment-menu.png) +3. Using the "Choose a reason" drop-down menu, click a reason to hide the comment. Then click, **Hide comment**. {% if currentVersion == "free-pro-team@latest" %} - ![选择隐藏评论的原因下拉菜单](/assets/images/help/repository/choose-reason-for-hiding-comment.png) + ![Choose reason for hiding comment drop-down menu](/assets/images/help/repository/choose-reason-for-hiding-comment.png) {% else %} - ![选择隐藏评论的原因下拉菜单](/assets/images/help/repository/choose-reason-for-hiding-comment-ghe.png) + ![Choose reason for hiding comment drop-down menu](/assets/images/help/repository/choose-reason-for-hiding-comment-ghe.png) {% endif %} -### 取消隐藏评论 +### Unhiding a comment -对仓库具有写入权限的任何人都可以取消隐藏议题、拉取请求及提交上的评论。 +Anyone with write access to a repository can unhide comments on issues, pull requests, and commits. -1. 导航到您要取消隐藏的评论。 -2. 在评论右上角，单击 **{% octicon "fold" aria-label="The fold icon" %} Show comment（显示评论）**。 ![显示评论文本](/assets/images/help/repository/hidden-comment-show.png) -3. 在展开的评论右上角，单击 {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}，然后单击 **Unhide（取消隐藏）**。 ![显示编辑、取消隐藏、删除选项的水平烤肉串图标和评论调解菜单](/assets/images/help/repository/comment-menu-hidden.png) +1. Navigate to the comment you'd like to unhide. +2. In the upper-right corner of the comment, click **{% octicon "fold" aria-label="The fold icon" %} Show comment**. + ![Show comment text](/assets/images/help/repository/hidden-comment-show.png) +3. On the right side of the expanded comment, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then **Unhide**. + ![The horizontal kebab icon and comment moderation menu showing the edit, unhide, delete options](/assets/images/help/repository/comment-menu-hidden.png) -### 编辑评论 +### Editing a comment -对仓库具有写入权限的任何人都可以编辑议题、拉取请求及提交上的评论。 +Anyone with write access to a repository can edit comments on issues, pull requests, and commits. -编辑评论和删除无助于促进对话以及违反社区行为准则{% if currentVersion == "free-pro-team@latest" %}或 GitHub [社区指导方针](/articles/github-community-guidelines){% endif %}的内容是明智之举。 +It's appropriate to edit a comment and remove content that doesn't contribute to the conversation and violates your community's code of conduct{% if currentVersion == "free-pro-team@latest" %} or GitHub's [Community Guidelines](/articles/github-community-guidelines){% endif %}. -编辑评论时，请记下删除的内容所在的位置，也可记下删除的原因。 +When you edit a comment, note the location that the content was removed from and optionally, the reason for removing it. -对仓库具有读取权限的任何人都可查看评论的编辑历史记录。 评论顶部的 **edited（已编辑）**下拉菜单包含编辑历史记录，其中会显示每次编辑的用户和时间戳。 +Anyone with read access to a repository can view a comment's edit history. The **edited** dropdown at the top of the comment contains a history of edits showing the user and timestamp for each edit. -![添加了表示内容编辑过的注释的评论](/assets/images/help/repository/content-redacted-comment.png) +![Comment with added note that content was redacted](/assets/images/help/repository/content-redacted-comment.png) -评论作者和具有仓库写入权限的任何人也都可以删除评论编辑历史记录中的敏感信息。 更多信息请参阅“[跟踪评论中的更改](/github/building-a-strong-community/tracking-changes-in-a-comment)”。 +Comment authors and anyone with write access to a repository can also delete sensitive information from a comment's edit history. For more information, see "[Tracking changes in a comment](/github/building-a-strong-community/tracking-changes-in-a-comment)." -1. 导航到您要编辑的评论。 -2. 在评论的右上角，单击 {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}，然后单击 **Edit（编辑）**。 ![显示编辑、隐藏、删除和报告选项的水平烤肉串图标和评论调解菜单](/assets/images/help/repository/comment-menu.png) -3. 在评论窗口中，删除要删除的评论，然后输入 `[REDACTED]` 进行替换。 ![包含编辑过的内容的评论窗口](/assets/images/help/issues/redacted-content-comment.png) -4. 在评论底部，输入注释，说明您已编辑评论，也可以输入编辑的原因。 ![添加了表示内容编辑过的注释的评论窗口](/assets/images/help/issues/note-content-redacted-comment.png) -5. 单击 **Update comment（更新评论）**。 +1. Navigate to the comment you'd like to edit. +2. In the upper-right corner of the comment, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Edit**. + ![The horizontal kebab icon and comment moderation menu showing the edit, hide, delete, and report options](/assets/images/help/repository/comment-menu.png) +3. In the comment window, delete the content you'd like to remove, then type `[REDACTED]` to replace it. + ![Comment window with redacted content](/assets/images/help/issues/redacted-content-comment.png) +4. At the bottom of the comment, type a note indicating that you have edited the comment, and optionally, why you edited the comment. + ![Comment window with added note that content was redacted](/assets/images/help/issues/note-content-redacted-comment.png) +5. Click **Update comment**. -### 删除评论 +### Deleting a comment -对仓库具有写入权限的任何人都可以删除议题、拉取请求及提交上的评论。 组织所有者、团队维护员和评论作者也可删除团队页面上的评论。 +Anyone with write access to a repository can delete comments on issues, pull requests, and commits. Organization owners, team maintainers, and the comment author can also delete a comment on a team page. -删除评论是调解员最后的选择。 如果整个评论没有给对话带来建设性的内容，或者违反社区的行为准则{% if currentVersion == "free-pro-team@latest" %}或 GitHub [社区指导方针](/articles/github-community-guidelines){% endif %}，删除评论是明智之举。 +Deleting a comment is your last resort as a moderator. It's appropriate to delete a comment if the entire comment adds no constructive content to a conversation and violates your community's code of conduct{% if currentVersion == "free-pro-team@latest" %} or GitHub's [Community Guidelines](/articles/github-community-guidelines){% endif %}. -删除评论会创建对仓库具有读取权限的所有人可见的时间表事件。 但评论删除者的用户名只有能够写入仓库的人可见。 对于没有写入权限的任何人，时间表事件会匿名化。 +Deleting a comment creates a timeline event that is visible to anyone with read access to the repository. However, the username of the person who deleted the comment is only visible to people with write access to the repository. For anyone without write access, the timeline event is anonymized. -![已删除评论的匿名化时间表事件](/assets/images/help/issues/anonymized-timeline-entry-for-deleted-comment.png) +![Anonymized timeline event for a deleted comment](/assets/images/help/issues/anonymized-timeline-entry-for-deleted-comment.png) -如果评论包含一些对议题或拉取请求中的对话有建设性的内容，您可以编辑评论。 +If a comment contains some constructive content that adds to the conversation in the issue or pull request, you can edit the comment instead. {% note %} -**注：**议题或拉取请求的初始评论（或正文）不能删除。 但可以编辑议题和拉取请求正文，以删除不需要的内容。 +**Note:** The initial comment (or body) of an issue or pull request can't be deleted. Instead, you can edit issue and pull request bodies to remove unwanted content. {% endnote %} -1. 导航到您要删除的评论。 -2. 在评论的右上角，单击 {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}，然后单击 **Delete（删除）**。 ![显示编辑、隐藏、删除和报告选项的水平烤肉串图标和评论调解菜单](/assets/images/help/repository/comment-menu.png) -3. 也可以说明您删除了哪些评论，为什么要删除。 +1. Navigate to the comment you'd like to delete. +2. In the upper-right corner of the comment, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Delete**. + ![The horizontal kebab icon and comment moderation menu showing the edit, hide, delete, and report options](/assets/images/help/repository/comment-menu.png) +3. Optionally, write a comment noting that you deleted a comment and why. diff --git a/translations/zh-CN/content/github/building-a-strong-community/managing-reported-content-in-your-organizations-repository.md b/translations/zh-CN/content/github/building-a-strong-community/managing-reported-content-in-your-organizations-repository.md index 101adc78c7c1..6d8dd2097b52 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/managing-reported-content-in-your-organizations-repository.md +++ b/translations/zh-CN/content/github/building-a-strong-community/managing-reported-content-in-your-organizations-repository.md @@ -1,6 +1,6 @@ --- title: 管理组织仓库中报告的内容 -intro: 在贡献者报告仓库中的破坏性内容后，仓库维护员可以查看和管理报告。 +intro: '在贡献者报告仓库中的破坏性内容后，仓库维护员可以查看和管理报告。' versions: free-pro-team: '*' --- diff --git a/translations/zh-CN/content/github/building-a-strong-community/manually-creating-a-single-issue-template-for-your-repository.md b/translations/zh-CN/content/github/building-a-strong-community/manually-creating-a-single-issue-template-for-your-repository.md index 7baeb4ca67cc..d261170b1db9 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/manually-creating-a-single-issue-template-for-your-repository.md +++ b/translations/zh-CN/content/github/building-a-strong-community/manually-creating-a-single-issue-template-for-your-repository.md @@ -1,6 +1,6 @@ --- title: 手动为仓库创建单一议题模板 -intro: 将手动创建的议题模板添加到仓库后，项目贡献者会自动在议题正文中看到模板的内容。 +intro: '将手动创建的议题模板添加到仓库后，项目贡献者会自动在议题正文中看到模板的内容。' redirect_from: - /articles/creating-an-issue-template-for-your-repository/ - /articles/manually-creating-a-single-issue-template-for-your-repository diff --git a/translations/zh-CN/content/github/building-a-strong-community/moderating-comments-and-conversations.md b/translations/zh-CN/content/github/building-a-strong-community/moderating-comments-and-conversations.md index 8186c0d847cb..508ce670ef52 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/moderating-comments-and-conversations.md +++ b/translations/zh-CN/content/github/building-a-strong-community/moderating-comments-and-conversations.md @@ -1,6 +1,6 @@ --- title: 调解评论和对话 -intro: 调解对话以促进健康的协作和缓解冲突，可创建一个热情的社区，吸引所有贡献者参与项目。 您可以查看报告的内容、编辑和删除评论以及锁定对话，对讨论应用社区的行为准则。 +intro: '调解对话以促进健康的协作和缓解冲突，可创建一个热情的社区，吸引所有贡献者参与项目。 您可以查看报告的内容、编辑和删除评论以及锁定对话，对讨论应用社区的行为准则。' mapTopic: true redirect_from: - /articles/moderating-comments-and-conversations diff --git a/translations/zh-CN/content/github/building-a-strong-community/pinning-a-team-discussion.md b/translations/zh-CN/content/github/building-a-strong-community/pinning-a-team-discussion.md index ecc5bd5fd2d1..b83534e0759a 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/pinning-a-team-discussion.md +++ b/translations/zh-CN/content/github/building-a-strong-community/pinning-a-team-discussion.md @@ -1,6 +1,6 @@ --- title: 固定团队讨论 -intro: 您可以将重要的讨论固定到组织的团队页面，以便于参考，也可取消固定不再相关的讨论。 +intro: '您可以将重要的讨论固定到组织的团队页面，以便于参考，也可取消固定不再相关的讨论。' redirect_from: - /articles/pinning-a-team-discussion versions: diff --git a/translations/zh-CN/content/github/building-a-strong-community/reporting-abuse-or-spam.md b/translations/zh-CN/content/github/building-a-strong-community/reporting-abuse-or-spam.md index db54be35823b..6767831fb711 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/reporting-abuse-or-spam.md +++ b/translations/zh-CN/content/github/building-a-strong-community/reporting-abuse-or-spam.md @@ -27,16 +27,16 @@ versions: ### 举报议题或拉取请求 1. 导航到您想要举报的议题或拉取请求。 -2. In the upper-right corner of the issue or pull request, click -{% octicon "kebab-horizontal" aria-label="The horizontal kebab octicon" %}, then click **Report content**. +2. 在议题或拉取请求的右上角，单击 +{% octicon "kebab-horizontal" aria-label="The horizontal kebab octicon" %}，然后单击 **Report content（报告内容）**。 ![用于报告评论的按钮](/assets/images/help/repository/menu-report-issue-or-pr.png) {% data reusables.community.report-content %} ### 举报评论 1. 导航到您要举报的评论。 -2. In the upper-right corner of the comment, click -{% octicon "kebab-horizontal" aria-label="The horizontal kebab octicon" %}, then click **Report content**. +2. 在注释的右上角，单击 +{% octicon "kebab-horizontal" aria-label="The horizontal kebab octicon" %}，然后单击 **Report content（报告内容）**。 ![包含报告评论选项的烤肉串式菜单](/assets/images/help/repository/menu-report-comment.png) {% data reusables.community.report-content %} @@ -58,7 +58,7 @@ versions: - "[设置健康参与的项目](/articles/setting-up-your-project-for-healthy-contributions)" - "[使用模板鼓励有用的议题和拉取请求](/github/building-a-strong-community/using-templates-to-encourage-useful-issues-and-pull-requests)" -- "[管理破坏性评论](/articles/managing-disruptive-comments)"{% if currentVersion == "free-pro-team@latest" %} +- "[Managing disruptive comments](/articles/managing-disruptive-comments)"{% if currentVersion == "free-pro-team@latest" %} - "[在 {% data variables.product.prodname_dotcom %} 上维护您的安全](/github/building-a-strong-community/maintaining-your-safety-on-github)" - "[限制仓库中的交互](/github/building-a-strong-community/limiting-interactions-in-your-repository)"{% endif %} - “[跟踪评论中的更改](/articles/tracking-changes-in-a-comment)” diff --git a/translations/zh-CN/content/github/building-a-strong-community/setting-guidelines-for-repository-contributors.md b/translations/zh-CN/content/github/building-a-strong-community/setting-guidelines-for-repository-contributors.md index 6110d972a414..88cc5837c6e0 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/setting-guidelines-for-repository-contributors.md +++ b/translations/zh-CN/content/github/building-a-strong-community/setting-guidelines-for-repository-contributors.md @@ -19,7 +19,7 @@ versions: 对于所有者和参与者来说，参与指南节省了由于不正确创建必须拒绝和重新提交的拉取请求或议题而导致的时间和麻烦。 -您可以为组织{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}或用户帐户{% endif %}创建默认的参与指南。 更多信息请参阅“[创建默认社区健康文件](/github/building-a-strong-community/creating-a-default-community-health-file)”。 +You can create default contribution guidelines for your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %}. 更多信息请参阅“[创建默认社区健康文件](/github/building-a-strong-community/creating-a-default-community-health-file)”。 {% tip %} @@ -51,6 +51,6 @@ versions: - Open Government [参与指南](https://github.com/opengovernment/opengovernment/blob/master/CONTRIBUTING.md)。 ### 延伸阅读 -- 开源指南的“[启动开源项目](https://opensource.guide/starting-a-project/)”部分{% if currentVersion == "free-pro-team@latest" %} +- The Open Source Guides' section "[Starting an Open Source Project](https://opensource.guide/starting-a-project/)"{% if currentVersion == "free-pro-team@latest" %} - [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}){% endif %} - "[添加许可到仓库](/articles/adding-a-license-to-a-repository)" diff --git a/translations/zh-CN/content/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions.md b/translations/zh-CN/content/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions.md index 2449f92d7bff..4caf5527b589 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions.md +++ b/translations/zh-CN/content/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions.md @@ -1,6 +1,6 @@ --- title: 设置项目的健康贡献 -intro: 仓库维护员可以设置参与指南，帮助协作者对项目做出有意义、有用的贡献。 +intro: '仓库维护员可以设置参与指南，帮助协作者对项目做出有意义、有用的贡献。' redirect_from: - /articles/helping-people-contribute-to-your-project/ - /articles/setting-up-your-project-for-healthy-contributions diff --git a/translations/zh-CN/content/github/building-a-strong-community/tracking-changes-in-a-comment.md b/translations/zh-CN/content/github/building-a-strong-community/tracking-changes-in-a-comment.md index d3a85b10f2c3..f88901cba281 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/tracking-changes-in-a-comment.md +++ b/translations/zh-CN/content/github/building-a-strong-community/tracking-changes-in-a-comment.md @@ -28,5 +28,5 @@ versions: ### 延伸阅读 -{% if currentVersion == "free-pro-team@latest" %}-“[举报滥用或垃圾邮件](/articles/reporting-abuse-or-spam)”{% endif %} +{% if currentVersion == "free-pro-team@latest" %}- "[Reporting abuse or spam](/articles/reporting-abuse-or-spam)"{% endif %} - “[编辑评论](/articles/editing-a-comment)” diff --git a/translations/zh-CN/content/github/building-a-strong-community/unblocking-a-user-from-your-organization.md b/translations/zh-CN/content/github/building-a-strong-community/unblocking-a-user-from-your-organization.md index acd76e8bb059..8c7e35f9a56f 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/unblocking-a-user-from-your-organization.md +++ b/translations/zh-CN/content/github/building-a-strong-community/unblocking-a-user-from-your-organization.md @@ -1,6 +1,6 @@ --- title: 取消阻止用户对组织的访问 -intro: 组织所有者可以取消阻止以前阻止的用户，恢复其对组织仓库的访问权限。 +intro: '组织所有者可以取消阻止以前阻止的用户，恢复其对组织仓库的访问权限。' redirect_from: - /articles/unblocking-a-user-from-your-organization versions: diff --git a/translations/zh-CN/content/github/building-a-strong-community/viewing-a-wikis-history-of-changes.md b/translations/zh-CN/content/github/building-a-strong-community/viewing-a-wikis-history-of-changes.md index 602232c94b80..ea42e165d139 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/viewing-a-wikis-history-of-changes.md +++ b/translations/zh-CN/content/github/building-a-strong-community/viewing-a-wikis-history-of-changes.md @@ -1,6 +1,6 @@ --- title: 查看 wiki 的更改历史记录 -intro: 由于 wiki 是 Git 仓库，因此您进行的每个更改均为可查看的提交。 +intro: '由于 wiki 是 Git 仓库，因此您进行的每个更改均为可查看的提交。' product: '{% data reusables.gated-features.wikis %}' redirect_from: - /articles/viewing-a-wiki-s-history-of-changes diff --git a/translations/zh-CN/content/github/building-a-strong-community/viewing-users-who-are-blocked-from-your-organization.md b/translations/zh-CN/content/github/building-a-strong-community/viewing-users-who-are-blocked-from-your-organization.md index 08eacc5df518..e3803abbb78a 100644 --- a/translations/zh-CN/content/github/building-a-strong-community/viewing-users-who-are-blocked-from-your-organization.md +++ b/translations/zh-CN/content/github/building-a-strong-community/viewing-users-who-are-blocked-from-your-organization.md @@ -1,6 +1,6 @@ --- title: 查看被阻止访问组织的用户 -intro: 您可以查看您或其他所有者已阻止访问组织的所有用户的列表。 如果用户在特定时间内被阻止，您可以看到他们被阻止的时间。 +intro: '您可以查看您或其他所有者已阻止访问组织的所有用户的列表。 如果用户在特定时间内被阻止，您可以看到他们被阻止的时间。' redirect_from: - /articles/viewing-users-who-are-blocked-from-your-organization versions: diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-branches.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-branches.md index cb0713ee0a3b..957b78c117ed 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-branches.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-branches.md @@ -1,6 +1,6 @@ --- title: 关于分支 -intro: 使用分支隔离开发工作而不影响仓库中的其他分支。 每个仓库都有一个默认分支，也可有多个其他分支。 您可以使用拉取请求将一个分支合并到另一个分支。 +intro: '使用分支隔离开发工作而不影响仓库中的其他分支。 每个仓库都有一个默认分支，也可有多个其他分支。 您可以使用拉取请求将一个分支合并到另一个分支。' redirect_from: - /articles/working-with-protected-branches/ - /articles/about-branches @@ -10,28 +10,30 @@ versions: --- -### 引入分支 +### 关于分支 -Branches allow you to develop features, fix bugs, or safely experiment with new ideas in a contained area of your repository. +分支允许您在仓库的包含区域中开发功能、修复错误或安全地试验新的想法。 -始终可以从现有分支创建分支。 Typically, you might create a new branch from the default branch of your repository. 然后，您可以单独处理这个新分支，不受其他人对仓库所做更改的影响。 为构建功能而创建的分支通常称为功能分支或主题分支。 更多信息请参阅“[创建和删除仓库中的分支](/articles/creating-and-deleting-branches-within-your-repository/)”。 +始终可以从现有分支创建分支。 通常，您可能会从仓库的默认分支创建新的分支。 然后，您可以单独处理这个新分支，不受其他人对仓库所做更改的影响。 为构建功能而创建的分支通常称为功能分支或主题分支。 更多信息请参阅“[创建和删除仓库中的分支](/articles/creating-and-deleting-branches-within-your-repository/)”。 -也可以使用分支发布 {% data variables.product.prodname_pages %} 网站。 更多信息请参阅“[什么是 {% data variables.product.prodname_dotcom %} 页面？](/articles/what-is-github-pages)” +也可以使用分支发布 {% data variables.product.prodname_pages %} 网站。 更多信息请参阅“[关于 {% data variables.product.prodname_pages %}](/articles/what-is-github-pages)”。 -必须对仓库有写入权限才可在拉取请求中创建分支、打开拉取请求或者删除和恢复分支。 更多信息请参阅“[{% data variables.product.product_name %} 上的访问权限](/articles/access-permissions-on-github)”。 +必须对仓库有写入权限才可在拉取请求中创建分支、打开拉取请求或者删除和恢复分支。 更多信息请参阅“[{% data variables.product.prodname_dotcom %} 上的访问权限](/github/getting-started-with-github/access-permissions-on-github)”。 -### About the default branch +### 关于默认分支 -{% data reusables.branches.new-repo-default-branch %} The default branch is the branch that {% data variables.product.prodname_dotcom %} displays when anyone visits your repository. The default branch is also the initial branch that Git checks out locally out when someone clones the repository. {% data reusables.branches.default-branch-automatically-base-branch %} +{% data reusables.branches.new-repo-default-branch %} 默认分支是任何人访问您的仓库时 {% data variables.product.prodname_dotcom %} 显示的分支。 默认分支也是初始分支，当有人克隆存储库时，Git 会在本地检出该分支。 {% data reusables.branches.default-branch-automatically-base-branch %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +By default, {% data variables.product.product_name %} names the default branch {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.23" %}`main`{% else %}`master`{% endif %} in any new repository. -By default, the default branch name is `master`, but you can set the name to anything that makes sense for your workflow. For more information on the default branch name, see "[Managing the default branch name for your repositories](/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories)." +{% data reusables.branches.set-default-branch %} -{% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} {% data reusables.branches.set-default-branch %} +{% endif %} + ### 使用分支 对您的工作感到满意后，可以打开拉取请求以将当前分支（*头部*分支）的更改合并到另一个分支（*基础*分支）。 更多信息请参阅“[关于拉取请求](/articles/about-pull-requests)”。 @@ -71,7 +73,7 @@ By default, the default branch name is `master`, but you can set the name to any - 如果对分支启用了必需状态检查，则在所有必需 CI 测试通过之前，无法将更改合并到分支。 更多信息请参阅“[关于状态检查](/articles/about-status-checks)”。 - 如果对分支启用了必需拉取请求审查，则在满足拉取请求审查策略中的所有要求之前，无法将更改合并到分支。 更多信息请参阅“[合并拉取请求](/articles/merging-a-pull-request)”。 - 如果对分支启用了代码所有者的必需审查，并且拉取请求修改具有所有者的代码，则代码所有者必须批准拉取请求后才可合并。 更多信息请参阅“[关于代码所有者](/articles/about-code-owners)”。 -- 如果对分支启用了必需提交签名，则无法将任何提交推送到未签名和验证的分支。 更多信息请参阅“[关于提交签名验证](/articles/about-commit-signature-verification)”和“[关于必需提交签名](/articles/about-required-commit-signing)”。{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} +- 如果对分支启用了必需提交签名，则无法将任何提交推送到未签名和验证的分支。 For more information, see "[About commit signature verification](/articles/about-commit-signature-verification)" and "[About required commit signing](/articles/about-required-commit-signing)."{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} - 如果您使用 {% data variables.product.prodname_dotcom %} 的冲突编辑器来解决从受保护分支创建拉取请求的冲突，{% data variables.product.prodname_dotcom %} 可帮助您为拉取请求创建一个备用分支，以解决合并冲突。 更多信息请参阅“[解决 {% data variables.product.prodname_dotcom %} 上的合并冲突](/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github)”。{% endif %} ### 延伸阅读 diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md index b131c080bd55..361cc41f2245 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-comparing-branches-in-pull-requests.md @@ -38,7 +38,7 @@ versions: ![差异查看选项菜单](/assets/images/help/pull_requests/diff-settings-menu.png) -为简化审查大型拉取请求中的更改，您可以过滤差异，只显示所选的文件类型{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}、显示您是其代码所有者的文件、隐藏您查看过的文件{% endif %}或隐藏已删除的文件。 更多信息请参阅“[按文件类型过滤拉取请求中的文件](/articles/filtering-files-in-a-pull-request)”。 +To simplify reviewing changes in a large pull request, you can filter the diff to only show selected file types, show files you are a CODEOWNER of, hide files you have already viewed, or hide deleted files. 更多信息请参阅“[按文件类型过滤拉取请求中的文件](/articles/filtering-files-in-a-pull-request)”。 ![文件过滤器下拉菜单](/assets/images/help/pull_requests/file-filter-menu.png) @@ -54,7 +54,7 @@ versions: 如果要模拟拉取请求中的两点差异并查看每个分支最新版本之间的比较结果，可以将基本分支合并到主题分支，以更新分支之间最新的共同原型。 -有关用于比较更改的 Git 命令的更多信息，请参阅 _Pro Git_ 书籍网站中的“[Git 差异选项](https://git-scm.com/docs/git-diff#git-diff-emgitdiffemltoptionsgtltcommitgtltcommitgt--ltpathgt82308203)”。 +For more information about Git commands to compare changes, see "[Git diff options](https://git-scm.com/docs/git-diff#git-diff-emgitdiffemltoptionsgtltcommitgtltcommitgt--ltpathgt82308203)" from the _Pro Git_ book site. ### 差异不显示的原因 - 您超过了文件或特定文件类型的总限制。 更多信息请参阅“[在仓库中查看内容和差异的限制](/articles/limits-for-viewing-content-and-diffs-in-a-repository/#diff-limits)”。 diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github.md index 9f8c724a8d99..b7c1c5ba0c23 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github.md @@ -19,7 +19,7 @@ versions: ### 反应评论意见 -您可以在对话中对某种想法表示支持或反对。 在对评论或者团队讨论、议题或拉取请求添加反应时，订阅对话的人不会收到通知。 有关订阅的更多信息，请参阅{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[关于通知](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}“[订阅和退订通知](/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications){% endif %}”。 +您可以在对话中对某种想法表示支持或反对。 在对评论或者团队讨论、议题或拉取请求添加反应时，订阅对话的人不会收到通知。 For more information about subscriptions, 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 %}"[Subscribing to and unsubscribing from notifications](/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications){% endif %}." ![包含反应的议题示例](/assets/images/help/repository/issue-reactions.png) diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-forks.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-forks.md index 7f32cd1f95e7..f5cabef0625c 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-forks.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-forks.md @@ -17,17 +17,17 @@ versions: {% data reusables.repositories.desktop-fork %} -删除复刻不会删除原始上游仓库。 您可以对复刻执行所需的任何更改—添加协作者、重命名文件、生成 {% data variables.product.prodname_pages %}—不会影响原始仓库。{% if currentVersion == "free-pro-team@latest" %} 复刻的仓库在删除后无法恢复。 更多信息请参阅“[恢复删除的仓库](/articles/restoring-a-deleted-repository)”。{% endif %} +删除复刻不会删除原始上游仓库。 You can make any changes you want to your fork—add collaborators, rename files, generate {% data variables.product.prodname_pages %}—with no effect on the original.{% if currentVersion == "free-pro-team@latest" %} You cannot restore a deleted forked repository. 更多信息请参阅“[恢复删除的仓库](/articles/restoring-a-deleted-repository)”。{% endif %} 在开源项目中，复刻常用于迭代想法或更改，然后将其提交回上游仓库。 在用户拥有的复刻中进行更改，然后打开拉取请求以比较您的工作与上游仓库，便可允许对上游仓库具有推送权限的任何推送更改到拉取请求分支。 这可加速协作，让仓库维护员在合并之前于本地从用户拥有的复刻对拉取请求进行提交或运行测试。 不可向组织拥有的复刻授予推送权限。 {% data reusables.repositories.private_forks_inherit_permissions %} -如果以后要从现有仓库的内容创建新仓库，但不想合并上游更改，您可以复制仓库 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}，或者，如果该仓库是模板，则使用该仓库作为模板{% endif %}。 更多信息请参阅“[复制仓库](/articles/duplicating-a-repository)"{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} 和[从模板创建仓库](/articles/creating-a-repository-from-a-template)"{% endif %}。 +If you want to create a new repository from the contents of an existing repository but don't want to merge your changes upstream in the future, you can duplicate the repository or, if the repository is a template, use the repository as a template. 更多信息请参阅“[复制仓库](/articles/duplicating-a-repository)" 和[从模板创建仓库](/articles/creating-a-repository-from-a-template)"。 ### 延伸阅读 - "[关于协作开发模式](/articles/about-collaborative-development-models)" - "[从复刻创建拉取请求](/articles/creating-a-pull-request-from-a-fork)" -- [开源指南](https://opensource.guide/){% if currentVersion == "free-pro-team@latest" %} +- [Open Source Guides](https://opensource.guide/){% if currentVersion == "free-pro-team@latest" %} - [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}){% endif %} diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-merge-conflicts.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-merge-conflicts.md index 6aef1a431102..a0996e9a7598 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-merge-conflicts.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-merge-conflicts.md @@ -1,6 +1,6 @@ --- title: 关于合并冲突 -intro: 在合并竞争提交的分支时会发生合并冲突，Git 需要您帮助确定最终合并中要加入哪些更改。 +intro: '在合并竞争提交的分支时会发生合并冲突，Git 需要您帮助确定最终合并中要加入哪些更改。' redirect_from: - /articles/about-merge-conflicts versions: diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-reviews.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-reviews.md index 6f2478d9b06a..e22c66e934aa 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-reviews.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-pull-request-reviews.md @@ -1,6 +1,6 @@ --- title: 关于拉取请求审查 -intro: 审查允许协作者评论拉取请求中提议的更改、审批更改或在拉取请求合并之前请求进一步更改。 仓库管理员可要求所有拉取请求在合并之前获得批准。 +intro: '审查允许协作者评论拉取请求中提议的更改、审批更改或在拉取请求合并之前请求进一步更改。 仓库管理员可要求所有拉取请求在合并之前获得批准。' redirect_from: - /articles/about-pull-request-reviews versions: @@ -12,11 +12,11 @@ versions: 打开拉取请求后，具有*读取*权限的任何人都可以查看该拉取请求提议的更改并进行评论。 您也可以建议对代码行的具体更改，作者可直接从拉取请求应用这些更改。 更多信息请参阅“[审查拉取请求中提议的更改](/articles/reviewing-proposed-changes-in-a-pull-request)”。 -仓库所有者和协作者可向具体的个人申请拉取请求审查。 组织成员也可向具有仓库读取权限的团队申请拉取请求审查。 更多信息请参阅“[申请拉取请求审查](/articles/requesting-a-pull-request-review)”。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}您可以指定自动分配一部分团队成员，而不是分配整个团队。 更多信息请参阅“[管理团队的代码审查分配](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)”。{% endif %} +仓库所有者和协作者可向具体的个人申请拉取请求审查。 组织成员也可向具有仓库读取权限的团队申请拉取请求审查。 更多信息请参阅“[申请拉取请求审查](/articles/requesting-a-pull-request-review)”。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}You can specify a subset of team members to be automatically assigned in the place of the whole team. 更多信息请参阅“[管理团队的代码审查分配](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)”。{% endif %} 审查允许讨论提议的更改，帮助确保更改符合仓库的参与指南及其他质量标准。 您可以在 CODEOWNERS 文件中定义哪些个人或团队拥有代码的特定类型或区域。 当拉取请求修改定义了所有者的代码时，该个人或团队将自动被申请为审查者。 更多信息请参阅“[关于代码所有者](/articles/about-code-owners/)”。 -{% if currentVersion == "free-pro-team@latest" %}您可以对需要审查的拉取请求预定提醒。 更多信息请参阅“[管理拉取请求的预定提醒](/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests)”。{% endif %} +{% if currentVersion == "free-pro-team@latest" %}You can schedule reminders for pull requests that need to be reviewed. 更多信息请参阅“[管理拉取请求的预定提醒](/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests)”。{% endif %} ![包含行注释的拉取请求更改的标头](/assets/images/help/pull_requests/review-header-with-line-comment.png) diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-pull-requests.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-pull-requests.md index c69ac204cc45..ee92ba8aaaa1 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-pull-requests.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-pull-requests.md @@ -26,7 +26,7 @@ versions: 其他贡献者可以审查您提议的更改，添加审查注释，参与拉取请求讨论，甚至对拉取请求添加评论。 {% if currentVersion == "free-pro-team@latest" %} -You can see information about the branch's current deployment status and past deployment activity on the "Conversation" tab. 更多信息请参阅“[查看仓库的部署活动](/articles/viewing-deployment-activity-for-your-repository)”。 +您可以在“Conversation（对话）”选项卡上查看有关分支当前部署状态和以前部署活动的信息。 更多信息请参阅“[查看仓库的部署活动](/articles/viewing-deployment-activity-for-your-repository)”。 {% endif %} 对提议的更改感到满意后，您可以合并拉取请求。 如果您在使用共享仓库模型，可以创建一个拉取请求，然后您或其他人将您的功能分支中的更改合并到您在拉取请求中指定的基础分支。 更多信息请参阅“[合并拉取请求](/articles/merging-a-pull-request)”。 diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md index 726d9e65ae8f..aebfe1cb0739 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/about-status-checks.md @@ -46,7 +46,7 @@ _检查_与_状态_的不同之处在于它们提供行注解、更详细的信 #### 跳过和申请个别提交的检查 -当仓库设置为自动申请检查推送时，您可以选择跳过所推送的个别提交的检查。 当仓库_未_设置为自动申请检查推送时，您可以申请检查您推送的个别提交。 有关这些设置的更多信息，请参阅“[检查套件](/v3/checks/suites/#set-preferences-for-check-suites-on-a-repository)”。 +当仓库设置为自动申请检查推送时，您可以选择跳过所推送的个别提交的检查。 当仓库_未_设置为自动申请检查推送时，您可以申请检查您推送的个别提交。 有关这些设置的更多信息，请参阅“[检查套件](/rest/reference/checks#update-repository-preferences-for-check-suites)”。 要跳过或申请检查提交，请在提交消息末添加以下尾行之一： diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/addressing-merge-conflicts.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/addressing-merge-conflicts.md index 0bd0394df43f..89b964e11060 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/addressing-merge-conflicts.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/addressing-merge-conflicts.md @@ -1,6 +1,6 @@ --- title: 解决合并冲突 -intro: 如果您的更改与基本分支存在合并冲突，必须解决该冲突后才可合并拉取请求的更改。 +intro: '如果您的更改与基本分支存在合并冲突，必须解决该冲突后才可合并拉取请求的更改。' mapTopic: true redirect_from: - /articles/addressing-merge-conflicts diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/allowing-changes-to-a-pull-request-branch-created-from-a-fork.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/allowing-changes-to-a-pull-request-branch-created-from-a-fork.md index 15f67d2d1267..0d56843adbc1 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/allowing-changes-to-a-pull-request-branch-created-from-a-fork.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/allowing-changes-to-a-pull-request-branch-created-from-a-fork.md @@ -1,6 +1,6 @@ --- title: 允许更改从复刻创建的拉取请求分支 -intro: 为增强协作，您可以允许在您从自己用户帐户拥有的复刻所创建的分支上提交。 +intro: '为增强协作，您可以允许在您从自己用户帐户拥有的复刻所创建的分支上提交。' redirect_from: - /articles/allowing-changes-to-a-pull-request-branch-created-from-a-fork permissions: 如对用户帐户拥有的复刻的上游仓库具有推送权限，则可提交到复刻的分支。 diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/approving-a-pull-request-with-required-reviews.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/approving-a-pull-request-with-required-reviews.md index a87166d17c58..661aaea4c6ab 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/approving-a-pull-request-with-required-reviews.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/approving-a-pull-request-with-required-reviews.md @@ -1,6 +1,6 @@ --- title: 批准需要审查的拉取请求 -intro: 如果您的仓库需要审查，拉取请求必须由对仓库具有写入或管理员权限的人员进行特定数量的批准审查，然后才可合并。 +intro: '如果您的仓库需要审查，拉取请求必须由对仓库具有写入或管理员权限的人员进行特定数量的批准审查，然后才可合并。' redirect_from: - /articles/approving-a-pull-request-with-required-reviews versions: diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/changing-the-base-branch-of-a-pull-request.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/changing-the-base-branch-of-a-pull-request.md index 9df5f0f7dd94..386012a895a6 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/changing-the-base-branch-of-a-pull-request.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/changing-the-base-branch-of-a-pull-request.md @@ -1,6 +1,6 @@ --- title: 更改拉取请求的基本分支 -intro: 打开拉取请求后，您可以更改基本分支，以根据不同的分支比较拉取请求中的更改。 +intro: '打开拉取请求后，您可以更改基本分支，以根据不同的分支比较拉取请求中的更改。' redirect_from: - /articles/changing-the-base-branch-of-a-pull-request versions: diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/changing-the-stage-of-a-pull-request.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/changing-the-stage-of-a-pull-request.md index 8cc21c0147a6..fd9a031c7bb5 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/changing-the-stage-of-a-pull-request.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/changing-the-stage-of-a-pull-request.md @@ -1,6 +1,6 @@ --- title: 更改拉取请求的阶段 -intro: '您可以将拉取请求草稿标记为可供审查{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}或将拉取请求转换为草稿{% endif %}。' +intro: 'You can mark a draft pull request as ready for review{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} or convert a pull request to a draft{% endif %}.' permissions: 具有仓库写入权限的人员和拉取请求作者可以更改拉取请求的阶段。 product: '{% data reusables.gated-features.draft-prs %}' redirect_from: diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally.md index 0ddc5810a39c..5f004bf0d9c6 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/checking-out-pull-requests-locally.md @@ -18,7 +18,7 @@ versions: ### 在本地修改活动的拉取请求 {% data reusables.repositories.sidebar-pr %} -2. 在拉取请求列表中，单击要修改的拉取请求。{% if currentVersion == "free-pro-team@latest" %} +2. In the list of pull requests, click the pull request you'd like to modify.{% if currentVersion == "free-pro-team@latest" %} 3. 要选择想打开拉取请求的位置，请选择**使用 {% octicon "triangle-down" aria-label="The down triangle icon" %} 打开**下拉列表，然后单击其中一个选项卡。 ![Link to access command line pull request instructions](/assets/images/help/pull_requests/open-with-button.png){% else %} 3. 在合并框中，单击**命令行说明**。 按照步骤顺序解决提议的拉取请求。 ![访问命令行拉取请求说明的链接](/assets/images/help/pull_requests/pull_request_show_command_line_merge.png) 4. （可选）要在 {% data variables.product.prodname_desktop %} 中查看提议的更改，请单击 **open this in {% data variables.product.prodname_desktop %}（在 GitHub Desktop 中打开）**。 ![Link to open a pull request locally in Desktop](/assets/images/help/desktop/open-pr-in-desktop.png){% endif %} @@ -44,7 +44,7 @@ versions: [main] $ git checkout BRANCHNAME > Switched to a new branch 'BRANCHNAME' ``` -7. 现在，您可以使用此分支执行任何操作。 You can run some local tests, or merge other branches into the branch. +7. 现在，您可以使用此分支执行任何操作。 您可以运行一些本地测试，或者将其他分支合并到该分支。 8. 准备就绪后，可以向上推送新分支： ```shell [pull-inactive-pull-request] $ git push origin BRANCHNAME diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/collaborating-on-repositories-with-code-quality-features.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/collaborating-on-repositories-with-code-quality-features.md index 885ad8a45fea..95ca378e1e12 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/collaborating-on-repositories-with-code-quality-features.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/collaborating-on-repositories-with-code-quality-features.md @@ -1,6 +1,6 @@ --- -title: 在具有代码质量功能的仓库上进行协作 -intro: '代码质量功能，例如状态、{% if currentVersion != "free-pro-team@latest" %}预接收挂钩、{% endif %}受保护分支和必需状态检查，可帮助协作者做出符合组织和仓库管理员设置条件的贡献。' +title: Collaborating on repositories with code quality features +intro: 'Workflow quality features like statuses, {% if currentVersion != "free-pro-team@latest" %}pre-receive hooks, {% endif %}protected branches, and required status checks help collaborators make contributions that meet conditions set by organization and repository administrators.' mapTopic: true redirect_from: - /articles/collaborating-on-repositories-with-code-quality-features-enabled/ diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request.md index 87e49a4c4a28..d19e1aff9040 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request.md @@ -5,7 +5,7 @@ redirect_from: - /articles/commenting-on-the-diff-of-a-pull-request/ - /articles/commenting-on-differences-between-files/ - /articles/commenting-on-a-pull-request -intro: 在仓库中打开拉取请求后，协作者或团队成员可以评论两个指定分支之间的文件比较，或者对整个项目做出总体评论。 +intro: '在仓库中打开拉取请求后，协作者或团队成员可以评论两个指定分支之间的文件比较，或者对整个项目做出总体评论。' versions: free-pro-team: '*' enterprise-server: '*' @@ -54,5 +54,5 @@ versions: ### 延伸阅读 - “[创建指向代码段的永久链接](/articles/creating-a-permanent-link-to-a-code-snippet/)” -{% if currentVersion == "free-pro-team@latest" %}-“[举报滥用或垃圾邮件](/articles/reporting-abuse-or-spam)” +{% if currentVersion == "free-pro-team@latest" %}- "[Reporting abuse or spam](/articles/reporting-abuse-or-spam)" {% endif %} diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md index bf49dff2f6ee..49cf01a95251 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork.md @@ -22,7 +22,9 @@ versions: {% endnote %} -1. 在 {% data variables.product.product_name %} 上，导航到创建拉取请求分支的复刻（或仓库副本）的主页面。 +1. 在 + +{% data variables.product.product_name %}, navigate to the main page of the fork (or copy of your repository) where the pull request branch was created. {% data reusables.repositories.copy-clone-url %} {% data reusables.command_line.open_the_multi_os_terminal %} {% tip %} @@ -66,7 +68,7 @@ versions: **提示：**有关拉取请求分支的更多信息，包括示例，请参阅“[创建拉取请求](/articles/creating-a-pull-request/#changing-the-branch-range-and-destination-repository)”。 {% endtip %} -8. 现在，您可以使用此分支执行任何操作。 You can push new commits to it, run some local tests, or merge other branches into the branch. 根据需要进行修改。 +8. 现在，您可以使用此分支执行任何操作。 您可以向该分支推送新提交、运行一些本地测试或将其他分支合并到其中。 根据需要进行修改。 9. 在更改提交到拉取请求的头部分支后，您可以将更改直接推送到原始拉取请求。 在此例中，头部分支为 `test-branch`： ```shell $ git push origin test-branch diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md index 3987886c5bdb..b46ea0c9fe70 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request.md @@ -1,6 +1,6 @@ --- title: 创建拉取请求 -intro: '创建拉取请求以提议和协作处理对仓库的更改。 These changes are proposed in a *branch*, which ensures that the default branch only contains finished and approved work.' +intro: '创建拉取请求以提议和协作处理对仓库的更改。 这些更改在*分支*中提议，以确保默认分支只包含已完成和已批准的工作。' redirect_from: - /articles/creating-a-pull-request versions: @@ -18,7 +18,7 @@ versions: ### 更改分支范围和目标仓库 -默认情况下，拉取请求基于父仓库的[默认分支](/articles/setting-the-default-branch)。 +By default, pull requests are based on the parent repository's default branch. 更多信息请参阅“[关于分支](/github/collaborating-with-issues-and-pull-requests/about-branches#about-the-default-branch)”。 如果默认父仓库不正确，您可以使用下拉列表更改父仓库和分支， 还可以使用下拉列表交换头部分支和基本分支，以确定引用点之间的差异。 这里的引用必须是 GitHub 仓库中的分支名称。 @@ -32,7 +32,7 @@ versions: {% tip %} -**Tips**: +**提示**： - 使用比较视图可设置跨任何时间范围的比较。 更多信息请参阅“[比较提交](/github/committing-changes-to-your-project/comparing-commits)”。 - 项目维护员可以为仓库添加拉取请求模板。 模板包括拉取请求正文中的信息提示。 更多信息请参阅“[关于议题和拉取请求模板](/articles/about-issue-and-pull-request-templates)”。 diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md index 0fafe0dde479..cf6bc66d0a84 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md @@ -21,9 +21,9 @@ versions: {% data reusables.pull_requests.automatically-delete-branches %} -If the branch you want to delete is the repository's default branch, you must choose a new default branch before deleting the branch. For more information, see "[Setting the default branch](/github/administering-a-repository/setting-the-default-branch)." +如果要删除的分支是仓库的默认分支，则在删除该分支之前必须选择新的默认分支。 For more information, see "[Changing the default branch](/github/administering-a-repository/changing-the-default-branch)." -If the branch you want to delete is associated with an open pull request, you must merge or close the pull request before deleting the branch. For more information, see "[Merging a pull request](/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request)" or "[Closing a pull request](/github/collaborating-with-issues-and-pull-requests/closing-a-pull-request)." +如果要删除的分支与打开的拉取请求关联，则在删除该分支之前必须合并或关闭拉取请求。 更多信息请参阅“[合并拉取请求](/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request)”和“[关闭拉取请求](/github/collaborating-with-issues-and-pull-requests/closing-a-pull-request)”。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.navigate-to-branches %} diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md index 5f79e430d904..8b272b9da850 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/dismissing-a-pull-request-review.md @@ -14,14 +14,10 @@ versions: {% data reusables.search.requested_reviews_search %} {% data reusables.repositories.sidebar-pr %} -{% data reusables.repositories.choose-pr-review %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} +{% data reusables.repositories.choose-pr-review %} 3. 在 "Conversation"（转换）选项卡中，滚动到要忽略的审查，然后单击 {% octicon "chevron-down" aria-label="The down button" %}。 ![合并框中的 V 形图标](/assets/images/help/pull_requests/merge_box/pull-request-open-menu.png) 4. 单击 {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}，然后单击 **Dismiss review（忽略审查）**。 ![合并框中的烤肉串图标](/assets/images/help/pull_requests/merge_box/pull-request-dismiss-review.png) 5. 输入忽略审查的原因，然后单击 **Dismiss review（忽略审查）**。 ![忽略审查按钮](/assets/images/help/pull_requests/merge_box/pull-request-dismiss-review-button.png) -{% else %} -3. 在“Conversation（对话）”选项卡上，滚动到想要查看的评论，然后单击 **Dismiss review（忽略审查）**。 ![忽略审查选项](/assets/images/help/pull_requests/merge_box/pull-request-dismiss-review.png) -4. 输入忽略审查的原因，然后单击 **Dismiss review（忽略审查）**。 ![忽略审查按钮](/assets/images/help/pull_requests/merge_box/pull-request-dismiss-review-button.png) -{% endif %} ### 延伸阅读 diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md index dbe2b7c59d3c..afac08558306 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/filtering-files-in-a-pull-request.md @@ -1,6 +1,6 @@ --- title: 过滤拉取请求中的文件 -intro: 要快速查看大型拉取请求中的更改，您可以过滤已更改的文件。 +intro: '要快速查看大型拉取请求中的更改，您可以过滤已更改的文件。' redirect_from: - /articles/filtering-files-in-a-pull-request-by-file-type/ - /articles/filtering-files-in-a-pull-request @@ -9,11 +9,11 @@ versions: enterprise-server: '*' --- -您可以按文件扩展名类型（例如 `.html` 或 `.js`）、无扩展名、{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}代码所有权、{% endif %}或点文件过滤拉取请求中的文件。 +You can filter files in a pull request by file extension type, such as `.html` or `.js`, lack of an extension, code ownership, or dotfiles. {% tip %} -**提示：**为简化拉取请求差异视图，也可以从过滤器下拉菜单在拉取请求差异中临时隐藏删除的文件{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}或您已经查看过的文件{% endif %}。 +**Tip:** To simplify your pull request diff view, you can also temporarily hide deleted files or files you have already viewed in the pull request diff from the file filter drop-down menu. {% endtip %} diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/finding-changed-methods-and-functions-in-a-pull-request.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/finding-changed-methods-and-functions-in-a-pull-request.md index facfd89d45c2..bd96c9d876af 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/finding-changed-methods-and-functions-in-a-pull-request.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/finding-changed-methods-and-functions-in-a-pull-request.md @@ -1,6 +1,6 @@ --- title: 在拉取请求中查找已更改的方法和函数 -intro: 您可以快速查找拉取请求中提议的对 *.go*、*.js*、*.ts*、*.py*、*.php* 和 *.rb* 文件中的方法或函数的更改。 +intro: '您可以快速查找拉取请求中提议的对 *.go*、*.js*、*.ts*、*.py*、*.php* 和 *.rb* 文件中的方法或函数的更改。' redirect_from: - /articles/finding-changed-methods-and-functions-in-a-pull-request versions: diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/github-flow.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/github-flow.md index 5e8a6ddff0d8..d3c90170f2ac 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/github-flow.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/github-flow.md @@ -1,6 +1,6 @@ --- title: GitHub 流程 -intro: 在 GitHub，我们每天都在研究自己的产品，开发了一个适合项目协作的工作流程。 为了使其适用于不同规模或技术专长的团队，我们确保工作流程中的每个步骤都可以在基于 Web 的界面中完成。 +intro: '在 GitHub，我们每天都在研究自己的产品，开发了一个适合项目协作的工作流程。 为了使其适用于不同规模或技术专长的团队，我们确保工作流程中的每个步骤都可以在基于 Web 的界面中完成。' redirect_from: - /articles/creating-and-editing-files-in-your-repository/ - /articles/github-flow-in-the-browser/ diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request.md index d76f1ae54197..d254ea75d51b 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request.md @@ -1,6 +1,6 @@ --- title: 在拉取请求中加入反馈 -intro: 当审查者建议拉取请求中的更改时，您可以自动将这些更改合并到拉取请求中，或者开一个议题来跟踪范围外的建议。 +intro: '当审查者建议拉取请求中的更改时，您可以自动将这些更改合并到拉取请求中，或者开一个议题来跟踪范围外的建议。' redirect_from: - /articles/incorporating-feedback-in-your-pull-request versions: diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md index c3c9c1f74435..0835aad7f7f5 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request.md @@ -11,11 +11,11 @@ versions: ### 关于拉取请求合并 -在拉取请求中，您提议将您对头部分支所做的更改合并到基础分支。 {% data reusables.pull_requests.about-protected-branches %} 但是，对于何时可以将拉取请求合并到特定分支可能会有限制。 For example, you may only be able to merge a pull request into the default branch if required status checks are passing. 更多信息请参阅“[关于受保护分支](/github/administering-a-repository/about-protected-branches)”。 +在拉取请求中，您提议将您对头部分支所做的更改合并到基础分支。 {% data reusables.pull_requests.about-protected-branches %} 但是，对于何时可以将拉取请求合并到特定分支可能会有限制。 例如，如果必需状态检查通过，您可能只能将拉取请求合并到默认分支。 更多信息请参阅“[关于受保护分支](/github/administering-a-repository/about-protected-branches)”。 如果拉取请求具有合并冲突，或者您在测试前想测试更改，可以[本地检出拉取请求](/articles/checking-out-pull-requests-locally)，然后使用命令行合并。 -You can't merge a draft pull request. 有关拉取请求草稿的更多信息，请参阅“[关于拉取请求](/articles/about-pull-requests#draft-pull-requests)”。 +无法合并草稿拉取请求。 有关拉取请求草稿的更多信息，请参阅“[关于拉取请求](/articles/about-pull-requests#draft-pull-requests)”。 {% data reusables.pull_requests.automatically-delete-branches %} @@ -45,13 +45,13 @@ You can't merge a draft pull request. 有关拉取请求草稿的更多信息， 6. 单击 **Confirm merge（确认合并）**、**Confirm squash and merge（确认压缩并合并）**或 **Confirm rebase and merge（确认变基并合并）**。 6. （可选）[删除分支](/articles/deleting-unused-branches)。 这有助于仓库的分支列表保持整洁。 - {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}仓库可配置为在您合并拉请求时自动删除拉取请求的头部分支。 更多信息请参阅“[管理分支的自动删除](/github/administering-a-repository/managing-the-automatic-deletion-of-branches)”。{% endif %} +The repository may be configured so that the head branch for a pull request is automatically deleted when you merge a pull request. 更多信息请参阅“[管理分支的自动删除](/github/administering-a-repository/managing-the-automatic-deletion-of-branches)”。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} {% note %} - **注：** {% data reusables.pull_requests.retargeted-on-branch-deletion %} -更多信息请参阅“[关于分支](/github/collaborating-with-issues-and-pull-requests/about-branches#working-with-branches)”。 + **Note:** {% data reusables.pull_requests.retargeted-on-branch-deletion %} + For more information, see "[About branches](/github/collaborating-with-issues-and-pull-requests/about-branches#working-with-branches)." {% endnote %} {% endif %} diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md index 788f9f82a1c6..94c2f79d3f87 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/merging-an-upstream-repository-into-your-fork.md @@ -1,6 +1,6 @@ --- title: 将上游仓库合并到复刻 -intro: 如果您对上游仓库没有推送（写入）权限，便可将提交从该仓库拉入您自己的复刻。 +intro: '如果您对上游仓库没有推送（写入）权限，便可将提交从该仓库拉入您自己的复刻。' redirect_from: - /articles/merging-an-upstream-repository-into-your-fork versions: @@ -10,9 +10,9 @@ versions: {% data reusables.command_line.open_the_multi_os_terminal %} 2. 将当前工作目录更改为您的本地仓库。 -3. 检出要合并到其中的分支。 Usually, you will merge into the default branch. +3. 检出要合并到其中的分支。 通常，您会合并到默认分支中。 ```shell - $ git checkout master + $ git checkout DEFAULT_BRANCH_NAME ``` 4. 从上游仓库拉取所需的分支。 此方法将保留提交历史记录而不做修改。 ```shell @@ -23,5 +23,5 @@ versions: 7. 检查更改，确认对更改满意。 8. 将合并推送到 GitHub 仓库。 ```shell - $ git push origin master + $ git push origin DEFAULT_BRANCH_NAME ``` diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/proposing-changes-to-your-work-with-pull-requests.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/proposing-changes-to-your-work-with-pull-requests.md index 0dff4a1eee2f..6be2abde3c56 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/proposing-changes-to-your-work-with-pull-requests.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/proposing-changes-to-your-work-with-pull-requests.md @@ -1,6 +1,6 @@ --- title: 通过拉取请求提议工作更改 -intro: 在添加更改到主题分支或复刻后，您可以打开拉取请求，要求协作者或仓库管理员审查您的更改，然后将其合并到项目中。 +intro: '在添加更改到主题分支或复刻后，您可以打开拉取请求，要求协作者或仓库管理员审查您的更改，然后将其合并到项目中。' mapTopic: true redirect_from: - /articles/proposing-changes-to-your-work-with-pull-requests diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/requesting-a-pull-request-review.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/requesting-a-pull-request-review.md index bc32e2ff6de7..507fa37d335c 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/requesting-a-pull-request-review.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/requesting-a-pull-request-review.md @@ -1,6 +1,6 @@ --- title: 请求拉取请求审查 -intro: 创建拉取请求后，您可以请求特定人员审查您提议的更改。 如果您是组织成员，还可以请求特定团队审查您的更改。 +intro: '创建拉取请求后，您可以请求特定人员审查您提议的更改。 如果您是组织成员，还可以请求特定团队审查您的更改。' redirect_from: - /articles/requesting-a-pull-request-review versions: @@ -10,7 +10,7 @@ versions: 用户帐户拥有的仓库的所有者和协作者可以分配拉取请求审查。 拥有仓库查验漏洞权限的组织成员可以分配拉取请求审查。 -所有者或协作者可以将拉取请求审核分配给被明确授予用户拥有仓库[读取权限](/articles/access-permissions-on-github)的任何人。 组织成员也可将拉取请求审查分配给拥有仓库读取权限的任何个人或团队。 被请求的审查者或团队将收到您请求他们审查拉取请求的通知。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}如果您请求团队审查，并且启用了代码审查分配，则会向特定成员发出申请，并且取消团队作为审查者。 更多信息请参阅“[管理团队的代码审查分配](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)”。{% endif %} +所有者或协作者可以将拉取请求审核分配给被明确授予用户拥有仓库[读取权限](/articles/access-permissions-on-github)的任何人。 组织成员也可将拉取请求审查分配给拥有仓库读取权限的任何个人或团队。 被请求的审查者或团队将收到您请求他们审查拉取请求的通知。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}If you request a review from a team and code review assignment is enabled, specific members will be requested and the team will be removed as a reviewer. 更多信息请参阅“[管理团队的代码审查分配](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)”。{% endif %} {% note %} diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md index c75dc4effe3c..1b9ed3f8d809 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-on-github.md @@ -1,6 +1,6 @@ --- -title: 在 GitHub 上解决合并冲突 -intro: 您可以使用冲突编辑器在 GitHub 上解决涉及竞争行更改的简单合并冲突。 +title: Resolving a merge conflict on GitHub +intro: 'You can resolve simple merge conflicts that involve competing line changes on GitHub, using the conflict editor.' redirect_from: - /articles/resolving-a-merge-conflict-on-github versions: @@ -8,50 +8,56 @@ versions: enterprise-server: '*' --- -您只能在 {% data variables.product.product_name %} 上解决由竞争行更改引起的合并冲突，例如当人们对 Git 仓库中不同分支上同一文件的同一行进行不同的更改时。 对于所有其他类型的合并冲突，您必须在命令行上本地解决冲突。 更多信息请参阅“[使用命令行解决合并冲突](/articles/resolving-a-merge-conflict-using-the-command-line/)”。 +You can only resolve merge conflicts on {% data variables.product.product_name %} that are caused by competing line changes, such as when people make different changes to the same line of the same file on different branches in your Git repository. For all other types of merge conflicts, you must resolve the conflict locally on the command line. For more information, see "[Resolving a merge conflict using the command line](/articles/resolving-a-merge-conflict-using-the-command-line/)." {% if currentVersion != "free-pro-team@latest" %} -如果站点管理员对仓库之间的拉取请求禁用合并冲突编辑器，则无法在 {% data variables.product.product_name %} 上使用冲突编辑器，并且必须在命令行上解决合并冲突。 例如，如果禁用合并冲突编辑器，则无法在复刻和上游仓库之间的拉取请求中使用它。 +If a site administrator disables the merge conflict editor for pull requests between repositories, you cannot use the conflict editor on {% data variables.product.product_name %} and must resolve merge conflicts on the command line. For example, if the merge conflict editor is disabled, you cannot use it on a pull request between a fork and upstream repository. {% endif %} {% warning %} {% if currentVersion ver_lt "enterprise-server@2.22" %} -**Warning:** When you resolve a merge conflict on {% data variables.product.product_name %}, the entire [base branch](/github/getting-started-with-github/github-glossary#base-branch) of your pull request is merged into the [head branch](/github/getting-started-with-github/github-glossary#head-branch), even if the head branch is the default branch of your repository or a protected branch. 确保您确实想要提交到此分支。 +**Warning:** When you resolve a merge conflict on {% data variables.product.product_name %}, the entire [base branch](/github/getting-started-with-github/github-glossary#base-branch) of your pull request is merged into the [head branch](/github/getting-started-with-github/github-glossary#head-branch), even if the head branch is the default branch of your repository or a protected branch. Make sure you really want to commit to this branch. {% else %} -**警告：**在 {% data variables.product.product_name %} 上解决合并冲突时，拉取请求的整个[基本分支](/github/getting-started-with-github/github-glossary#base-branch)都会合并到[头部分支](/github/getting-started-with-github/github-glossary#head-branch)中。 确保您确实想要提交到此分支。 If the head branch is the default branch of your repository, you'll be given the option of creating a new branch to serve as the head branch for your pull request. 如果头部分支是受保护分支，则无法将冲突解决合并到其中，因此系统会提示您创建一个新的头部分支。 更多信息请参阅“[关于受保护分支](/github/administering-a-repository/about-protected-branches)”。 +**Warning:** When you resolve a merge conflict on {% data variables.product.product_name %}, the entire [base branch](/github/getting-started-with-github/github-glossary#base-branch) of your pull request is merged into the [head branch](/github/getting-started-with-github/github-glossary#head-branch). Make sure you really want to commit to this branch. If the head branch is the default branch of your repository, you'll be given the option of creating a new branch to serve as the head branch for your pull request. If the head branch is protected you won't be able to merge your conflict resolution into it, so you'll be prompted to create a new head branch. For more information, see "[About protected branches](/github/administering-a-repository/about-protected-branches)." {% endif %} {% endwarning %} {% data reusables.repositories.sidebar-pr %} -1. 在“Pull Requests（拉取请求）”列表中，单击含有您想要解决的合并冲突的拉取请求。 -1. 在拉取请求底部附近，单击 **Resolve conflicts（解决冲突）**。 ![解决合并冲突按钮](/assets/images/help/pull_requests/resolve-merge-conflicts-button.png) +1. In the "Pull Requests" list, click the pull request with a merge conflict that you'd like to resolve. +1. Near the bottom of your pull request, click **Resolve conflicts**. +![Resolve merge conflicts button](/assets/images/help/pull_requests/resolve-merge-conflicts-button.png) {% tip %} - **提示：**如果停用 **Resolve conflicts（解决冲突）**按钮，则拉取请求的合并冲突过于复杂而无法在 {% data variables.product.product_name %} 上解决{% if currentVersion != "free-pro-team@latest" %}或站点管理员已禁用仓库之间拉取请求的冲突编辑器{% endif %}。 必须使用备用 Git 客户端或在命令行上使用 Git 解决合并冲突。 更多信息请参阅“[使用命令行解决合并冲突](/articles/resolving-a-merge-conflict-using-the-command-line)”。 + **Tip:** If the **Resolve conflicts** button is deactivated, your pull request's merge conflict is too complex to resolve on {% data variables.product.product_name %}{% if currentVersion != "free-pro-team@latest" %} or the site administrator has disabled the conflict editor for pull requests between repositories{% endif %}. You must resolve the merge conflict using an alternative Git client, or by using Git on the command line. For more information see "[Resolving a merge conflict using the command line](/articles/resolving-a-merge-conflict-using-the-command-line)." {% endtip %} {% data reusables.pull_requests.decide-how-to-resolve-competing-line-change-merge-conflict %} - ![查看带有冲突标记的合并冲突示例](/assets/images/help/pull_requests/view-merge-conflict-with-markers.png) -1. 如果文件中有多个合并冲突，请向下滚动到下一组冲突标记，然后重复步骤 4 和步骤 5 以解决合并冲突。 -1. 解决文件中的所有冲突后，单击 **Mark as resolved（标记为已解决）**。 ![单击“标记为已解决”按钮](/assets/images/help/pull_requests/mark-as-resolved-button.png) -1. 如果您有多个冲突文件，请在“冲突文件”下的页面左侧选择您要编辑的下一个文件，并重复步骤 4 到 7，直到您解决所有拉取请求的合并冲突。 ![适用时选择下一个冲突文件](/assets/images/help/pull_requests/resolve-merge-conflict-select-conflicting-file.png) -1. 解决所有合并冲突后，单击 **Commit merge（提交合并）**。 这会将整个基本分支合并到头部分支。 ![Resolve merge conflicts button](/assets/images/help/pull_requests/merge-conflict-commit-changes.png){% if currentVersion ver_lt "enterprise-server@2.22" %} -1. 如果出现提示，请审查您要提交的分支。 如果要提交到此分支，请单击 **I understand, update _BRANCH_（我已了解，请更新 BRANCH）**。 ![合并冲突确认窗口](/assets/images/help/pull_requests/merge-conflict-confirmation.png){% else %} -1. 如果出现提示，请审查您要提交的分支。 - - 如果头部分支是仓库的默认分支，您可以选择使用为解决冲突所做的更改来更新此分支，或者选择创建一个新分支并将其用作拉取请求的头部分支。 ![提示审查将要更新的分支](/assets/images/help/pull_requests/conflict-resolution-merge-dialog-box.png) - - 如果您选择创建一个新分支，请输入该分支的名称。 - - 如果拉取请求的头部分支是受保护分支，则必须创建新分支。 您将无法选择更新受保护分支。 - - 单击 **Create branch and update my pull request（创建分支并更新我的拉取请求**或 **I understand, continue updating（我了解，继续更新）_BRANCH（分支）_**。 按钮文本对应于您正在执行的操作。 + ![View merge conflict example with conflict markers](/assets/images/help/pull_requests/view-merge-conflict-with-markers.png) +1. If you have more than one merge conflict in your file, scroll down to the next set of conflict markers and repeat steps four and five to resolve your merge conflict. +1. Once you've resolved all the conflicts in the file, click **Mark as resolved**. + ![Click mark as resolved button](/assets/images/help/pull_requests/mark-as-resolved-button.png) +1. If you have more than one file with a conflict, select the next file you want to edit on the left side of the page under "conflicting files" and repeat steps four through seven until you've resolved all of your pull request's merge conflicts. + ![Select next conflicting file if applicable](/assets/images/help/pull_requests/resolve-merge-conflict-select-conflicting-file.png) +1. Once you've resolved all your merge conflicts, click **Commit merge**. This merges the entire base branch into your head branch. + ![Resolve merge conflicts button](/assets/images/help/pull_requests/merge-conflict-commit-changes.png){% if currentVersion ver_lt "enterprise-server@2.22" %} +1. If prompted, review the branch that you are committing to. If you want to commit to this branch, click **I understand, update _BRANCH_**. +![Merge conflict confirmation window](/assets/images/help/pull_requests/merge-conflict-confirmation.png){% else %} +1. If prompted, review the branch that you are committing to. + + If the head branch is the default branch of the repository, you can choose either to update this branch with the changes you made to resolve the conflict, or to create a new branch and use this as the head branch of the pull request. + ![Prompt to review the branch that will be updated](/assets/images/help/pull_requests/conflict-resolution-merge-dialog-box.png) + + If you choose to create a new branch, enter a name for the branch. + + If the head branch of your pull request is protected you must create a new branch. You won't get the option to update the protected branch. + + Click **Create branch and update my pull request** or **I understand, continue updating _BRANCH_**. The button text corresponds to the action you are performing. {% endif %} -1. 要合并拉取请求，请单击 **Merge pull request（合并拉取请求）**。 有关其他拉取请求合并选项的更多信息，请参阅“[合并拉取请求](/articles/merging-a-pull-request/)”。 +1. To merge your pull request, click **Merge pull request**. For more information about other pull request merge options, see "[Merging a pull request](/articles/merging-a-pull-request/)." -### 延伸阅读 +### Further reading -- "[关于拉取请求合并](/articles/about-pull-request-merges)" +- "[About pull request merges](/articles/about-pull-request-merges)" diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-using-the-command-line.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-using-the-command-line.md index 867781105328..39aa3f7b6c69 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-using-the-command-line.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/resolving-a-merge-conflict-using-the-command-line.md @@ -83,8 +83,8 @@ ask your question in IRC. 2. 生成受合并冲突影响的文件列表。 在此例中，文件 *README.md* 存在合并冲突。 ```shell $ git status - > # On branch master - > # Your branch and 'origin/master' have diverged, + > # On branch main + > # Your branch and 'origin/main' have diverged, > # and have 1 and 2 different commits each, respectively. > # (use "git pull" to merge the remote branch into yours) > # You have unmerged paths. diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/reviewing-changes-in-pull-requests.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/reviewing-changes-in-pull-requests.md index 12769016400c..ae7de5785ede 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/reviewing-changes-in-pull-requests.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/reviewing-changes-in-pull-requests.md @@ -3,7 +3,7 @@ title: 审查拉取请求中的更改 redirect_from: - /articles/reviewing-and-discussing-changes-in-pull-requests/ - /articles/reviewing-changes-in-pull-requests -intro: 打开拉取请求后，您可以审查和讨论一组提议的更改。 +intro: '打开拉取请求后，您可以审查和讨论一组提议的更改。' mapTopic: true versions: free-pro-team: '*' diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md index c06e9c82b7bc..e0cd74d52f80 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request.md @@ -1,6 +1,6 @@ --- title: 审查拉取请求中的建议更改 -intro: 在拉取请求中，您可以审查和讨论提交、更改的文件以及基本和比较分支中文件之间的区别（或“差异”）。 +intro: '在拉取请求中，您可以审查和讨论提交、更改的文件以及基本和比较分支中文件之间的区别（或“差异”）。' redirect_from: - /articles/reviewing-proposed-changes-in-a-pull-request versions: @@ -10,7 +10,7 @@ versions: ### 关于审查拉取请求 -您可以在拉取请求中每次审查一个文件的更改。 在审查拉取请求中的文件时，可对特定更改进行个别评论。{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} 在完成审查每个文件后，您可以将该文件标记为已查看。 这会折叠文件，帮助您识别还需要审查的文件。 拉取请求标头中的进度条显示您查看过的文件数。{% endif %} 在按需要审查多个文件后，您可以在摘要评论中提交审查，以批准拉取请求或申请其他更改。 +您可以在拉取请求中每次审查一个文件的更改。 While reviewing the files in a pull request, you can leave individual comments on specific changes. After you finish reviewing each file, you can mark the file as viewed. 这会折叠文件，帮助您识别还需要审查的文件。 A progress bar in the pull request header shows the number of files you've viewed. After reviewing as many files as you want, you can approve the pull request or request additional changes by submitting your review with a summary comment. {% data reusables.search.requested_reviews_search_tip %} @@ -28,14 +28,12 @@ versions: ![取消审查按钮](/assets/images/help/pull_requests/cancel-review-button.png) -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} ### 将文件标记为已查看 在完成审查文件后，您可以将文件标记为已查看，该文件将会收起。 如果查看过的文件有更改，将会取消已查看的标记。 {% data reusables.repositories.changed-files %} 2. 在完成审查的文件的标头右侧，选择**已查看**。 ![已查看复选框](/assets/images/help/pull_requests/viewed-checkbox.png) -{% endif %} ### 提交审查 diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/working-with-pre-receive-hooks.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/working-with-pre-receive-hooks.md index d9fc3bd167f5..44864ce1f906 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/working-with-pre-receive-hooks.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/working-with-pre-receive-hooks.md @@ -21,7 +21,7 @@ Total 3 (delta 0), reused 0 (delta 0) remote: always_reject.sh: failed with exit status 1 remote: error: rejecting all pushes To https://54.204.174.51/hodor/nope.git - ! [remote rejected] master -> master (pre-receive hook declined) + ! [remote rejected] main -> main (pre-receive hook declined) error: failed to push some refs to 'https://54.204.174.51/hodor/nope.git' ``` diff --git a/translations/zh-CN/content/github/committing-changes-to-your-project/changing-a-commit-message.md b/translations/zh-CN/content/github/committing-changes-to-your-project/changing-a-commit-message.md index 6eb5afb8939d..13825edc3a54 100644 --- a/translations/zh-CN/content/github/committing-changes-to-your-project/changing-a-commit-message.md +++ b/translations/zh-CN/content/github/committing-changes-to-your-project/changing-a-commit-message.md @@ -13,13 +13,9 @@ versions: 您可以使用 `git commit --amend` 命令更改最近的提交消息。 -{% warning %} - 在 Git 中，提交消息的文本是提交的一部分。 更改提交消息将更改提交 ID - 即用于命名提交的 SHA1 校验和。 实际上，您是创建一个新提交以替换旧提交。 -{% endwarning %} - -#### 提交尚未推送上线 +### 提交尚未推送上线 如果提交仅存在于您的本地仓库中，尚未推送到 {% data variables.product.product_location %}，您可以使用 `git commit --amend` 命令修改提交消息。 @@ -39,7 +35,7 @@ versions: {% endtip %} -#### 修改旧提交或多个提交的消息 +### 修改旧提交或多个提交的消息 如果您已将提交推送到 {% data variables.product.product_location %}，则必须强制推送含有修正消息的提交。 @@ -93,7 +89,6 @@ versions: # # Note that empty commits are commented out ``` - 3. 在要更改的每个提交消息的前面，用 `reword` 替换 `pick`。 ```shell pick e499d89 Delete CNAME @@ -102,10 +97,10 @@ versions: ``` 4. 保存并关闭提交列表文件。 5. 在每个生成的提交文件中，键入新的提交消息，保存文件，然后关闭它。 -6. 强制推送修改后的提交。 - ```shell - $ git push --force - ``` +6. $ git push --force +```shell +$ git push --force example-branch +``` 有关交互式变基的更多信息，请参阅 Git 手册中的“[交互模式](https://git-scm.com/docs/git-rebase#_interactive_mode)”。 diff --git a/translations/zh-CN/content/github/committing-changes-to-your-project/commit-branch-and-tag-labels.md b/translations/zh-CN/content/github/committing-changes-to-your-project/commit-branch-and-tag-labels.md index e0328d34a5dd..e9dbfd77396a 100644 --- a/translations/zh-CN/content/github/committing-changes-to-your-project/commit-branch-and-tag-labels.md +++ b/translations/zh-CN/content/github/committing-changes-to-your-project/commit-branch-and-tag-labels.md @@ -14,7 +14,7 @@ versions: 如果提交在默认分支上，将显示包含提交的任何标记，并且默认分支将是列出的唯一分支。 -![Commit-master-label](/assets/images/help/commits/Commit-master-label.png) +![Commit-main-label](/assets/images/help/commits/Commit-master-label.png) ### 延伸阅读 diff --git a/translations/zh-CN/content/github/committing-changes-to-your-project/comparing-commits.md b/translations/zh-CN/content/github/committing-changes-to-your-project/comparing-commits.md index 9973bc87b16f..1d507b5460fb 100644 --- a/translations/zh-CN/content/github/committing-changes-to-your-project/comparing-commits.md +++ b/translations/zh-CN/content/github/committing-changes-to-your-project/comparing-commits.md @@ -26,9 +26,9 @@ versions: ### 比较标记 -比较发行版标记将显示自上次发布以来您对仓库的更改。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} 更多信息请参阅“[比较发行版](/github/administering-a-repository/comparing-releases)”。{% endif %} +比较发行版标记将显示自上次发布以来您对仓库的更改。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} For more information, see "[Comparing releases](/github/administering-a-repository/comparing-releases)."{% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}要比较标记，可以从页面顶部的 `compare` 下拉菜单选择标记名称。{% else %} 不是键入分支名称，而是键入 `compare` 下拉菜单中的标记名称。{% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}To compare tags, you can select a tag name from the `compare` drop-down menu at the top of the page.{% else %} Instead of typing a branch name, type the name of your tag in the `compare` drop down menu.{% endif %} 此处是[在两个标记之间进行比较](https://github.com/octocat/linguist/compare/v2.2.0...octocat:v2.3.3)的示例。 diff --git a/translations/zh-CN/content/github/committing-changes-to-your-project/creating-a-commit-with-multiple-authors.md b/translations/zh-CN/content/github/committing-changes-to-your-project/creating-a-commit-with-multiple-authors.md index b6efbe00be8a..079e81663f51 100644 --- a/translations/zh-CN/content/github/committing-changes-to-your-project/creating-a-commit-with-multiple-authors.md +++ b/translations/zh-CN/content/github/committing-changes-to-your-project/creating-a-commit-with-multiple-authors.md @@ -1,6 +1,6 @@ --- -title: 创建有多个作者的提交 -intro: '通过在提交消息中添加一个或多个 `Co-authored-by` 尾行，可将提交归属于多个作者。 合作提交在 {% data variables.product.product_name %}{% if currentVersion != "free-pro-team@latest" %} 上可见，并且可包含在个人资料贡献图和仓库统计信息中{% endif %}。' +title: Creating a commit with multiple authors +intro: 'You can attribute a commit to more than one author by adding one or more `Co-authored-by` trailers to the commit''s message. Co-authored commits are visible on {% data variables.product.product_name %}{% if currentVersion != "free-pro-team@latest" %} and can be included in the profile contributions graph and the repository''s statistics{% endif %}.' redirect_from: - /articles/creating-a-commit-with-multiple-authors versions: @@ -8,41 +8,41 @@ versions: enterprise-server: '*' --- -### 必需的合作作者信息 +### Required co-author information -向提交添加合作作者之前，您必须知道用于每个合作作者的适当电子邮件地址。 对于计为贡献的合作作者提交，必须使用与其 {% data variables.product.product_name %} 帐户相关联的电子邮件地址。 +Before you can add a co-author to a commit, you must know the appropriate email to use for each co-author. For the co-author's commit to count as a contribution, you must use the email associated with their {% data variables.product.product_name %} account. {% if currentVersion == "free-pro-team@latest" %} -如果有人选择对其电子邮件地址保密，则应使用其 {% data variables.product.product_name %}-提供的 `no-reply` 电子邮件地址以保护其隐私。 否则，合作作者的电子邮件地址将在提交消息中公开。 如果要保密您的电子邮件地址，您可以选择使用 {% data variables.product.product_name %}-为 Git 操作提供的 `no-reply` 电子邮件地址，并要求其他合作作者在提交尾行中列出您的 `no-reply` 电子邮件地址。 +If a person chooses to keep their email address private, you should use their {% data variables.product.product_name %}-provided `no-reply` email to protect their privacy. Otherwise, the co-author's email will be available to the public in the commit message. If you want to keep your email private, you can choose to use a {% data variables.product.product_name %}-provided `no-reply` email for Git operations and ask other co-authors to list your `no-reply` email in commit trailers. -更多信息请参阅“[设置提交电子邮件地址](/articles/setting-your-commit-email-address)”。 +For more information, see "[Setting your commit email address](/articles/setting-your-commit-email-address)." {% tip %} - **提示：**通过分享此信息可帮助合作作者找到其首选电子邮件地址： - - 要查找 {% data variables.product.product_name %}-提供的 `no-reply` 电子邮件地址，请导航至“Keep my email address private（对我的电子邮件地址保密）”下的电子邮件设置页面。 - - 要在计算机上查找用于配置 Git 的电子邮件地址，请在命令行上运行 `git config user.email`。 + **Tip:** You can help a co-author find their preferred email address by sharing this information: + - To find your {% data variables.product.product_name %}-provided `no-reply` email, navigate to your email settings page under "Keep my email address private." + - To find the email you used to configure Git on your computer, run `git config user.email` on the command line. {% endtip %} {% endif %} -### 使用 {% data variables.product.prodname_desktop %} 创建合作提交 +### Creating co-authored commits using {% data variables.product.prodname_desktop %} -可以使用 {% data variables.product.prodname_desktop %} 创建合作提交。 更多信息请参阅“[编写提交消息并推送更改](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project#3-write-a-commit-message-and-push-your-changes)”和 [{% data variables.product.prodname_desktop %}](https://desktop.github.com)。 +You can use {% data variables.product.prodname_desktop %} to create a commit with a co-author. For more information, see "[Write a commit message and push your changes](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project#3-write-a-commit-message-and-push-your-changes)" and [{% data variables.product.prodname_desktop %}](https://desktop.github.com). -![添加合作作者到提交消息](/assets/images/help/desktop/co-authors-demo-hq.gif) +![Add a co-author to the commit message](/assets/images/help/desktop/co-authors-demo-hq.gif) -### 在命令行上创建合作提交 +### Creating co-authored commits on the command line {% data reusables.pull_requests.collect-co-author-commit-git-config-info %} {% data reusables.pull_requests.commit-message-with-trailer-beginning %} -3. 在提交消息的下一行，根据每个合作作者的特定信息键入 `Co-authored-by: name `。 在合作作者的信息后面，添加一个右引号。 +3. On the next line of the commit message, type `Co-authored-by: name ` with specific information for each co-author. After the co-author information, add a closing quotation mark. - 如果要添加多个合作作者，请为每个合作作者键入一个 `Co-authored-by:` 提交尾行。 + If you're adding multiple co-authors, give each co-author their own line and `Co-authored-by:` commit trailer. ```shell $ git commit -m "Refactor usability tests. > @@ -51,26 +51,27 @@ versions: Co-authored-by: another-name <another-name@example.com>" ``` -在下次推送时，新的提交和消息将显示在 {% data variables.product.product_location %} 上。 更多信息请参阅“[推送更改到远程仓库](/articles/pushing-commits-to-a-remote-repository/)”。 +The new commit and message will appear on {% data variables.product.product_location %} the next time you push. For more information, see "[Pushing changes to a remote repository](/articles/pushing-commits-to-a-remote-repository/)." -### 在 {% data variables.product.product_name %} 上创建合作提交 +### Creating co-authored commits on {% data variables.product.product_name %} -在 {% data variables.product.product_name %} 上使用 web 编辑器对文件进行更改后，您可以通过在提交消息中添加 `Co-authored-by:` 尾行来创建合作提交。 +After you've made changes in a file using the web editor on {% data variables.product.product_name %}, you can create a co-authored commit by adding a `Co-authored-by:` trailer to the commit's message. {% data reusables.pull_requests.collect-co-author-commit-git-config-info %} -2. 合作进行更改后，在页面底部键入简短、有意义的提交消息，以描述你们所做的更改。 ![有关更改的提交消息](/assets/images/help/repository/write-commit-message-quick-pull.png) -3. 在提交消息下方的文本框中，根据每个合作作者的特定信息添加 `Co-authored-by: name `。 如果要添加多个合作作者，请为每个合作作者键入一个 `Co-authored-by:` 提交尾行。 +2. After making your changes together, at the bottom of the page, type a short, meaningful commit message that describes the changes you made. + ![Commit message for your change](/assets/images/help/repository/write-commit-message-quick-pull.png) +3. In the text box below your commit message, add `Co-authored-by: name ` with specific information for each co-author. If you're adding multiple co-authors, give each co-author their own line and `Co-authored-by:` commit trailer. - ![第二个提交消息文本框中的提交消息合作作者尾行示例](/assets/images/help/repository/write-commit-message-co-author-trailer.png) -4. 单击 **Commit changes（提交更改）**或 **Propose changes（提议更改）**。 + ![Commit message co-author trailer example in second commit message text box](/assets/images/help/repository/write-commit-message-co-author-trailer.png) +4. Click **Commit changes** or **Propose changes**. -新的提交和消息将显示在 {% data variables.product.product_location %} 上。 +The new commit and message will appear on {% data variables.product.product_location %}. -### 延伸阅读 +### Further reading {% if currentVersion != "free-pro-team@latest" %} -- "[在个人资料中查看贡献](/articles/viewing-contributions-on-your-profile)" -- “[为什么我的贡献没有在我的个人资料中显示？](/articles/why-are-my-contributions-not-showing-up-on-my-profile)”{% endif %} -- “[查看仓库活动的摘要](/articles/viewing-a-summary-of-repository-activity)” -- “[查看项目的贡献者](/articles/viewing-a-projects-contributors)” -- “[更改提交消息](/articles/changing-a-commit-message)” -- {% data variables.product.prodname_desktop %} 文档中的“[提交和审查对项目的更改](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project#3-write-a-commit-message-and-push-your-changes)” +- "[Viewing contributions on your profile](/articles/viewing-contributions-on-your-profile)" +- "[Why are my contributions not showing up on my profile?](/articles/why-are-my-contributions-not-showing-up-on-my-profile)"{% endif %} +- "[Viewing a summary of repository activity](/articles/viewing-a-summary-of-repository-activity)" +- "[Viewing a project's contributors](/articles/viewing-a-projects-contributors)" +- "[Changing a commit message](/articles/changing-a-commit-message)" +- "[Committing and reviewing changes to your project](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project#3-write-a-commit-message-and-push-your-changes)" in the {% data variables.product.prodname_desktop %} documentation diff --git a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/about-archiving-repositories.md b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/about-archiving-repositories.md index 540bde1aec74..2c1d364d23fa 100644 --- a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/about-archiving-repositories.md +++ b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/about-archiving-repositories.md @@ -1,6 +1,6 @@ --- title: 关于存档仓库 -intro: 在存档仓库时，要让人们知道不再主动维护项目。 +intro: '在存档仓库时，要让人们知道不再主动维护项目。' redirect_from: - /articles/about-archiving-repositories versions: @@ -20,7 +20,7 @@ versions: 在仓库存档后，便无法添加或删除协作者或团队。 具有仓库访问权限的贡献者只能对项目复刻或标星。 -当仓库存档后，其议题、拉取请求、代码、标签、重要事件、项目、wiki、版本、提交、标记、分支、反应和注解都会变成只读。 要更改存档的仓库，必须先对仓库取消存档。 +When a repository is archived, its issues, pull requests, code, labels, milestones, projects, wiki, releases, commits, tags, branches, reactions, code scanning alerts, and comments become read-only. 要更改存档的仓库，必须先对仓库取消存档。 您可以搜索已存档的仓库。 更多信息请参阅“[搜索仓库](/articles/searching-for-repositories/#search-based-on-whether-a-repository-is-archived)”。 更多信息请参阅“[搜索仓库](/articles/searching-for-repositories/#search-based-on-whether-a-repository-is-archived)”。 更多信息请参阅“[搜索议题和拉取请求](/articles/searching-issues-and-pull-requests/#search-based-on-whether-a-repository-is-archived)”。 diff --git a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md index 3a1c80e6f33f..7d29e4c4cc2d 100644 --- a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md +++ b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/about-code-owners.md @@ -20,10 +20,10 @@ versions: 当具有管理员或所有者权限的人员启用必需审查时，他们也可选择性要求代码所有者批准后，作者才可合并仓库中的拉取请求。 更多信息请参阅“[启用拉取请求的必需审查](/github/administering-a-repository/enabling-required-reviews-for-pull-requests)”。 -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}如果团队启用了代码审查分配，则个别审批无法满足受保护分支中代码所有者审批的要求。 更多信息请参阅“[管理团队的代码审查分配](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)”。{% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}If a team has enabled code review assignments, the individual approvals won't satisfy the requirement for code owner approval in a protected branch. 更多信息请参阅“[管理团队的代码审查分配](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)”。{% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -如果文件具有代码所有者，则在打开拉取请求之前可以看到代码所有者是谁。 In the repository, you can browse to the file and hover over +如果文件具有代码所有者，则在打开拉取请求之前可以看到代码所有者是谁。 在仓库中，您可以浏览文件并将鼠标悬停在上方 {% octicon "shield-lock" aria-label="The edit icon" %}. ![仓库中文件的代码所有者](/assets/images/help/repository/code-owner-for-a-file.png) @@ -33,7 +33,7 @@ versions: 要使用 CODEOWNERS 文件，请在仓库中您要添加代码所有者的分支的根目录 `docs/` 或 `.github/` 中，创建一个名为 `CODEOWNERS` 的新文件。 -每个 CODEOWNERS 文件将为仓库中的一个分支分配代码所有者。 Thus, you can assign different code owners for different branches, such as `@octo-org/codeowners-team` for a code base on the default branch and `@octocat` for a {% data variables.product.prodname_pages %} site on the `gh-pages` branch. +每个 CODEOWNERS 文件将为仓库中的一个分支分配代码所有者。 因此，您可以为不同的分支分配不同的代码所有者，例如为默认分支的代码基础分配 `@octo-org/codeowners-team`，为 `gh-pages` 分支的 {% data variables.product.prodname_pages %} 站点分配 `@octocat`。 为使代码所有者接收审查请求，CODEOWNERS 文件必须在拉取请求的基本分支上。 例如，如果您将 `@octocat` 分配为仓库 `gh-pages` 分支上 *.js* 文件的代码所有者，则在头部分支与 `gh-pages` 之间打开更改 *.js* 文件的拉取请求时，`@octocat` 将会收到审查请求。 @@ -41,7 +41,7 @@ versions: CODEOWNERS 文件使用遵循 [gitignore](https://git-scm.com/docs/gitignore#_pattern_format) 文件中所用规则的模式。 模式后接一个或多个使用标准 `@username` 或 `@org/team-name` 格式的 {% data variables.product.prodname_dotcom %} 用户名或团队名称。 您也可以通过已经添加到其 {% data variables.product.product_name %} 帐户的电子邮件地址来指代用户，如 `user@example.com`。 -If any line in your CODEOWNERS file contains invalid syntax, the file will not be detected and will not be used to request reviews. Invalid syntax includes inline comments and user or team names that do not exist on {% data variables.product.product_name %}. +如果 CODEOWNERS 文件中的任何行包含无效语法，则该文件将不会被检测并且不会用于请求审查。 无效语法包括 {% data variables.product.product_name %} 上不存在的内联注释和用户或团队名称。 #### CODEOWNERS 文件示例 ``` # This is a comment. @@ -79,7 +79,8 @@ docs/* docs@example.com apps/ @octocat # In this example, @doctocat owns any file in the `/docs` -# directory in the root of your repository. +# directory in the root of your repository and any of its +# subdirectories. /docs/ @doctocat ``` diff --git a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/about-readmes.md b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/about-readmes.md index 5d7e034dbd62..8f55b6c161d4 100644 --- a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/about-readmes.md +++ b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/about-readmes.md @@ -1,6 +1,6 @@ --- title: 关于自述文件 -intro: 您可以将自述文件添加到仓库，告知其他人您的项目为什么有用，他们可以对您的项目做什么，以及他们可以如何使用。 +intro: '您可以将自述文件添加到仓库，告知其他人您的项目为什么有用，他们可以对您的项目做什么，以及他们可以如何使用。' redirect_from: - /articles/section-links-on-readmes-and-blob-pages/ - /articles/relative-links-in-readmes/ @@ -10,7 +10,7 @@ versions: enterprise-server: '*' --- -自述文件连同{% if currentVersion == "free-pro-team@latest" %}a [仓库许可证](/articles/licensing-a-repository)、[参与指南](/articles/setting-guidelines-for-repository-contributors)和[行为准则](/articles/adding-a-code-of-conduct-to-your-project){% else %}、[仓库许可证](/articles/licensing-a-repository)和[参与指南](/articles/setting-guidelines-for-repository-contributors){% endif %}一起，帮助您,沟通项目要求以及管理对项目的参与。 +A README file, along with {% if currentVersion == "free-pro-team@latest" %}a [repository license](/articles/licensing-a-repository), [contribution guidelines](/articles/setting-guidelines-for-repository-contributors), and a [code of conduct](/articles/adding-a-code-of-conduct-to-your-project){% else %}a [repository license](/articles/licensing-a-repository) and [contribution guidelines](/articles/setting-guidelines-for-repository-contributors){% endif %}, helps you communicate expectations for and manage contributions to your project. 自述文件通常是访问者在访问仓库时看到的第一个项目。 自述文件通常包含以下信息： - 项目做什么 @@ -27,7 +27,7 @@ versions: {% data reusables.profile.profile-readme %} -![README file on your username/username repository](/assets/images/help/repository/username-repo-with-readme.png) +![用户名/用户名仓库上的自述文件](/assets/images/help/repository/username-repo-with-readme.png) {% endif %} diff --git a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/about-repositories.md b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/about-repositories.md index aba6603a244b..cdc747994713 100644 --- a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/about-repositories.md +++ b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/about-repositories.md @@ -15,7 +15,8 @@ versions: 对于用户拥有的仓库，您可以向其他人授予协作者访问权限，以便他们可以协作处理您的项目。 如果仓库归组织所有，您可以向组织成员授予访问权限，以便协作处理您的仓库。 更多信息请参阅“[用户帐户仓库的权限级别](/articles/permission-levels-for-a-user-account-repository/)”和“[组织的仓库权限级别](/articles/repository-permission-levels-for-an-organization/)”。 {% if currentVersion == "free-pro-team@latest" %} -通过用户帐户和组织的 {% data variables.product.prodname_free_team %}，可与无限的协作者合作处理设置了完全功能的无限公共仓库，或者是设置了有限功能的无限私有仓库， 要获取对私有仓库的高级处理，您可以升级到 {% data variables.product.prodname_pro %}、{% data variables.product.prodname_team %} 或 {% data variables.product.prodname_ghe_cloud %}。 {% data reusables.gated-features.more-info %} +With +{% data variables.product.prodname_free_team %} for user accounts and 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. 要获取对私有仓库的高级处理，您可以升级到 {% data variables.product.prodname_pro %}、{% data variables.product.prodname_team %} 或 {% data variables.product.prodname_ghe_cloud %}。 {% data reusables.gated-features.more-info %} {% else %} 每个人和组织都可拥有无限的仓库，并且可以邀请无限的协作者参与所有仓库。 {% endif %} diff --git a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md index 0c14e447cd49..2afea191a08c 100644 --- a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md +++ b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/about-repository-languages.md @@ -13,7 +13,8 @@ versions: enterprise-server: '*' --- -{% data variables.product.product_name %} 使用开源 [Linguist 库](https://github.com/github/linguist)来确定语言突出和仓库统计数据的文件语言。 Language statistics will update after you push changes to your default branch. +{% data variables.product.product_name %} uses the open source [Linguist library](https://github.com/github/linguist) to +determine file languages for syntax highlighting and repository statistics. 语言统计数据在您推送更改到默认分支后将会更新。 有些文件难以识别，有时项目包含的库和供应商文件多于其主要代码。 如果您收到错误结果，请查阅 Linguist [故障排除指南](https://github.com/github/linguist#troubleshooting)寻求帮助。 diff --git a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/about-repository-visibility.md b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/about-repository-visibility.md index e2b91e7246d3..d8c3f2ea37c5 100644 --- a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/about-repository-visibility.md +++ b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/about-repository-visibility.md @@ -1,23 +1,23 @@ --- -title: 关于仓库可见性 -intro: '您可以通过选择仓库的可见性来限制谁有权访问仓库：{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}公共、内部或私有{% else %} 公共或私有{% endif %}。' +title: About repository visibility +intro: 'You can restrict who has access to a repository by choosing a repository''s visibility: {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}public, internal, or private{% else %} public or private{% endif %}.' versions: free-pro-team: '*' enterprise-server: '*' --- -### 关于仓库可见性 +### About repository visibility -创建仓库时，您可以选择将仓库设为公共或私有仓库。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}如果您在一个{% if currentVersion == "free-pro-team@latest" %}由企业帐户拥有的{% endif %}组织中创建仓库，您还可以选择将仓库设为内部仓库。{% endif %} +When you create a repository, you can choose to make the repository public or private. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}If you're creating the repository in an organization{% if currentVersion == "free-pro-team@latest" %} that is owned by an enterprise account{% endif %}, you can also choose to make the repository internal.{% endif %} -{% if currentVersion != "free-pro-team@latest" %}如果 {% data variables.product.product_location_enterprise %} 未处于私有模式或位于防火墙后，则{% else %}{% endif %}公共仓库将对互联网上的所有人开放。{% if currentVersion != "free-pro-team@latest" %}否则，公共仓库将对所有 {% data variables.product.product_location_enterprise %} 用户开放，包括外部协作者。{% endif %}私有仓库仅供您、您明确与之共享访问权限的人访问，组织仓库则[供组织成员](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization)访问。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}内部仓库可供{% if currentVersion == "free-pro-team@latest" %}企业帐户的成员{% else %}实例上任何组织的成员{% endif %}访问。 更多信息请参阅“[关于内部仓库](#about-internal-repositories)”。{% endif %} +{% if currentVersion != "free-pro-team@latest" %}If {% data variables.product.product_location_enterprise %} is not in private mode or behind a firewall, p{% else %}P{% endif %}ublic repositories are accessible to everyone on the internet.{% if currentVersion != "free-pro-team@latest" %} Otherwise, public repositories are available to everyone using {% data variables.product.product_location_enterprise %}, including outside collaborators.{% endif %} Private repositories are only accessible to you, people you explicitly share access with, and, for organization repositories, [certain organization members](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization). {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}Internal repositories are accessible to {% if currentVersion == "free-pro-team@latest" %}members of your enterprise account{% else %}members of any organization on your instance{% endif %}. For more information, see "[About internal repositories](#about-internal-repositories)."{% endif %} -组织所有者始终有权访问其组织中创建的每个仓库。 更多信息请参阅“[组织的仓库权限级别](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization)”。 +Organization owners always have access to every repository created in an organization. For more information, see "[Repository permission levels for an organization](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization)." -拥有仓库管理员权限的人可更改现有仓库的可见性。 更多信息请参阅“[设置仓库可见性](/github/administering-a-repository/setting-repository-visibility)”。 +People with admin permissions for a repository can change an existing repository's visibility. For more information, see "[Setting repository visibility](/github/administering-a-repository/setting-repository-visibility)." {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -### 关于内部仓库 +### About internal repositories {% note %} @@ -25,12 +25,11 @@ versions: {% endnote %} -{% data reusables.repositories.about-internal-repos %} 有关内部资源的更多信息，请参阅 {% data variables.product.prodname_dotcom %} 的白皮书“[内部资源简介](https://resources.github.com/whitepapers/introduction-to-innersource/)”。 +{% data reusables.repositories.about-internal-repos %} For more information on innersource, see {% data variables.product.prodname_dotcom %}'s whitepaper "[An introduction to innersource](https://resources.github.com/whitepapers/introduction-to-innersource/)." -所有{% if currentVersion == "free-pro-team@latest" %}企业成员{% else %}组织成员{% endif %}都拥有对内部仓库的读取权限，但内部仓库对{% if currentVersion == "free-pro-team@latest" %}企业帐户外部{% else %}非组织成员{% endif %}的人员不可见，包括组织仓库的外部协作者。 更多信息请参阅{% if currentVersion == "free-pro-team@latest" %}“[企业帐户的角色](/articles/roles-for-an-enterprise-account#enterprise-members)”和{% endif %}“[组织的仓库权限级别](/articles/repository-permission-levels-for-an-organization)”。 +All {% if currentVersion == "free-pro-team@latest" %}enterprise members{% else %}organization members{% endif %} have read permissions to the internal repository, but internal repositories are not visible to people {% if currentVersion == "free-pro-team@latest" %}outside of the enterprise account{% else %}who are not members of an organization{% endif %}, including outside collaborators on organization repositories. For more information, see {% if currentVersion == "free-pro-team@latest" %}"[Roles for an enterprise account](/articles/roles-for-an-enterprise-account#enterprise-members)" and {% endif %}"[Repository permission levels for an organization](/articles/repository-permission-levels-for-an-organization)." {% data reusables.repositories.internal-repo-default %} -如果用户从 -{% if currentVersion == "free-pro-team@latest" %}企业帐户{% else %}实例上的所有组织 {% endif %}中被删除，则该用户对内部仓库的复刻将被自动删除。 +If a user is removed from {% if currentVersion == "free-pro-team@latest" %}an enterprise account{% else %}all organizations on the instance{% endif %}, that user's forks of internal repositories are removed automatically. {% endif %} diff --git a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md index 329ce1fbd7b6..5364873fbeb0 100644 --- a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md +++ b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/backing-up-a-repository.md @@ -1,42 +1,41 @@ --- -title: 备份仓库 -intro: '可使用{% if currentVersion != "free-pro-team@latest" %} Git 和{% endif %} API {% if currentVersion == "free-pro-team@latest" %}或第三方工具{% endif %}备份仓库。' +title: Backing up a repository +intro: 'You can use{% if currentVersion != "free-pro-team@latest" %} Git and{% endif %} the API {% if currentVersion == "free-pro-team@latest" %}or a third-party tool {% endif %}to back up your repository.' redirect_from: - /articles/backing-up-a-repository versions: free-pro-team: '*' enterprise-server: '*' --- - {% if currentVersion == "free-pro-team@latest" %} -要下载仓库的存档，您可以使用 API 进行用户或组织迁移。 更多信息请参阅“[迁移](/v3/migrations/)”。 +To download an archive of your repository, you can use the API for user or organization migrations. For more information, see "[Migrations](/v3/migrations/)." {% else %} -您可以手动下载和备份仓库： +You can download and back up your repositories manually: -- 要将仓库的 Git 数据下载到本地计算机，您需要克隆该仓库。 更多信息请参阅“[克隆仓库](/articles/cloning-a-repository)”。 -- 还可以下载仓库的 wiki。 更多信息请参阅“[添加或删除 wiki 页面](/articles/adding-or-editing-wiki-pages)”。 +- To download a repository's Git data to your local machine, you'll need to clone the repository. For more information, see "[Cloning a repository](/articles/cloning-a-repository)." +- You can also download your repository's wiki. For more information, see "[Adding or editing wiki pages](/articles/adding-or-editing-wiki-pages)." -克隆仓库或 wiki 时，仅下载 Git 数据，例如项目文件和提交历史记录。 您可以使用我们的 API 将 {% data variables.product.product_name %} 仓库的其他元素导出到您的本地计算机： +When you clone a repository or wiki, only Git data, such as project files and commit history, is downloaded. You can use our API to export other elements of your {% data variables.product.product_name %} repository to your local machine: -- [议题](/v3/issues/#list-issues-for-a-repository) -- [拉取请求](/v3/pulls/#list-pull-requests) -- [复刻](/v3/repos/forks/#list-forks) -- [评论](/v3/issues/comments/#list-comments-in-a-repository) -- [里程碑](/v3/issues/milestones/#list-milestones-for-a-repository) -- [标签](/v3/issues/labels/#list-all-labels-for-this-repository) -- [关注者](/v3/activity/watching/#list-watchers) -- [空想家](/v3/activity/starring/#list-stargazers) -- [项目](/v3/projects/#list-repository-projects) +- [Issues](/v3/issues/#list-issues-for-a-repository) +- [Pull requests](/v3/pulls/#list-pull-requests) +- [Forks](/rest/reference/repos#list-forks) +- [Comments](/rest/reference/issues#list-issue-comments-for-a-repository) +- [Milestones](/rest/reference/issues#list-milestones) +- [Labels](/rest/reference/issues#list-labels-for-a-repository) +- [Watchers](/rest/reference/activity#list-watchers) +- [Stargazers](/rest/reference/activity#list-stargazers) +- [Projects](/v3/projects/#list-repository-projects) {% endif %} -一旦您拥有{% if currentVersion != "free-pro-team@latest" %}所有要备份内容的本地版本，您就可以创建一个 zip 存档并{% else %}下载您的存档。您可以{% endif %}将其复制到外部硬盘和/或将其上传到基于云的备份服务，例如 [Google Drive](https://www.google.com/drive/) 或 [Dropbox](https://www.dropbox.com/)。 +Once you have {% if currentVersion != "free-pro-team@latest" %}a local version of all the content you want to back up, you can create a zip archive and {% else %}downloaded your archive, you can {% endif %}copy it to an external hard drive and/or upload it to a cloud-based backup service such as [Google Drive](https://www.google.com/drive/) or [Dropbox](https://www.dropbox.com/). {% if currentVersion == "free-pro-team@latest" %} -### 第三方备份工具 +### Third-party backup tools -有许多自助服务工具可自动备份仓库。 与存档项目不同，存档项目将将_所有_公共仓库存档在未选择退出的 {% data variables.product.product_name %} 上，并让任何人都可以访问数据，而备份工具将从_特定_仓库下载数据并组织在新分支或目录中。 有关存档项目的更多信息，请参阅“[关于在 {% data variables.product.prodname_dotcom %}](/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github#about-the-github-archive-program) 上存档内容和数据”。 +A number of self-service tools exist that automate backups of repositories. Unlike archival projects, which archive _all_ public repositories on {% data variables.product.product_name %} that have not opted out and make the data accessible to anyone, backup tools will download data from _specific_ repositories and organize it within a new branch or directory. For more information about archival projects, see "[About archiving content and data on {% data variables.product.prodname_dotcom %}](/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github#about-the-github-archive-program)." -利用 [BackHub](https://github.com/marketplace/backhub)，您可以备份仓库的所有 Git 数据（例如项目文件和提交历史记录），以及许多来自 {% data variables.product.product_name %} 的数据（例如议题和拉取请求），通过该工具可创建每日定期备份仓库计划，并且可查看过去最多 30 天的快照。 BackHub 可在 {% data variables.product.prodname_marketplace %} 中找到。 +You can back up all of a repository's Git data (such as project files and commit history), as well as much data from {% data variables.product.product_name %} (such as issues and pull requests), with [BackHub](https://github.com/marketplace/backhub), which creates daily recurring backups of your repositories with snapshots up to 30 days back in time. BackHub is available in {% data variables.product.prodname_marketplace %}. {% endif %} diff --git a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository-from-github.md b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository-from-github.md index a8108af68d0b..255b59624f91 100644 --- a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository-from-github.md +++ b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository-from-github.md @@ -1,6 +1,6 @@ --- title: 从 GitHub 克隆仓库 -intro: 您可以将远程仓库克隆到本地计算机上。 如果遇到错误，可使用一些常见的疑难解答解决方案。 +intro: '您可以将远程仓库克隆到本地计算机上。 如果遇到错误，可使用一些常见的疑难解答解决方案。' mapTopic: true redirect_from: - /articles/cloning-a-repository-from-github diff --git a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md index 22fcd652cccb..a0bb607ed908 100644 --- a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md +++ b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/cloning-a-repository.md @@ -1,6 +1,6 @@ --- title: 克隆仓库 -intro: 'When you create a repository on {% data variables.product.product_location %}, it exists as a remote repository. You can clone your repository to create a local copy on your computer and sync between the two locations.' +intro: '在 {% data variables.product.product_location %} 上创建仓库时，它将作为远程仓库存在。 您可以克隆仓库以在计算机上创建本地副本，并在两个位置之间进行同步。' redirect_from: - /articles/cloning-a-repository versions: @@ -10,16 +10,16 @@ versions: ### 关于克隆仓库 -You can clone a repository from {% data variables.product.product_location %} to your local computer to make it easier to fix merge conflicts, add or remove files, and push larger commits. When you clone a repository, you copy the repository from {% data variables.product.product_location %} to your local machine. +您可以将仓库从 {% data variables.product.product_location %} 克隆到本地计算机，以便修复合并冲突、添加或删除文件以及推送较大的提交。 克隆仓库时，将仓库从 {% data variables.product.product_location %} 复制到本地计算机。 -克隆仓库将提取 {% data variables.product.product_location %} 在当时拥有的所有仓库数据的完整副本，包括项目每个文件和文件夹的所有版本。 You can push your changes to the remote repository on {% data variables.product.product_location %}, or pull other people's changes from {% data variables.product.product_location %}. 更多信息请参阅“[使用常见的 Git 命令](/github/using-git/using-common-git-commands)”。 +克隆仓库将提取 {% data variables.product.product_location %} 在当时拥有的所有仓库数据的完整副本，包括项目每个文件和文件夹的所有版本。 您可以将更改推送到 {% data variables.product.product_location %} 上的远程仓库，或者从 {% data variables.product.product_location %} 拉取其他人的更改。 更多信息请参阅“[使用常见的 Git 命令](/github/using-git/using-common-git-commands)”。 -You can clone your existing repository or clone another person's existing repository to contribute to a project. +您可以克隆自己的现有仓库或克隆其他人的现有仓库以参与项目。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} {% tip %} -**Tip**: You can also clone a repository using the {% data variables.product.prodname_cli %}. For more information, see "[`gh repo clone`](https://cli.github.com/manual/gh_repo_clone)" in the {% data variables.product.prodname_cli %} documentation. +**提示**：您也可以使用 {% data variables.product.prodname_cli %} 克隆仓库。 更多信息请参阅 {% data variables.product.prodname_cli %} 文档中的“[`gh 仓库克隆`](https://cli.github.com/manual/gh_repo_clone)”。 {% endtip %} {% endif %} @@ -46,7 +46,7 @@ You can clone your existing repository or clone another person's existing reposi 空仓库不含任何文件。 如果创建仓库时不使用 README 初始化仓库，通常会出现空仓库。 {% data reusables.repositories.navigate-to-repo %} -2. 要使用 HTTPS 以命令行克隆仓库，请在“Quick setup（快速设置）”下单击 {% octicon "clippy" aria-label="The clipboard icon" %}。 要使用 SSH 密钥克隆仓库{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}，包括组织的 SSH 认证中心颁发的证书，{% endif %} 单击 **SSH**，然后单击 {% octicon "clippy" aria-label="The clipboard icon" %}。 ![空仓库克隆 URL 按钮](/assets/images/help/repository/empty-https-url-clone-button.png) +2. 要使用 HTTPS 以命令行克隆仓库，请在“Quick setup（快速设置）”下单击 {% octicon "clippy" aria-label="The clipboard icon" %}。 To clone the repository using an SSH key, including a certificate issued by your organization's SSH certificate authority, click **SSH**, then click {% octicon "clippy" aria-label="The clipboard icon" %}. ![空仓库克隆 URL 按钮](/assets/images/help/repository/empty-https-url-clone-button.png) 或者，要在 Desktop 中克隆仓库，请单击 {% octicon "desktop-download" aria-label="The desktop download button" %} **Set up in Desktop（在 Desktop 中设置）**并按照提示完成克隆。 ![空仓库克隆桌面按钮](/assets/images/help/repository/empty-desktop-clone-button.png) @@ -55,7 +55,6 @@ You can clone your existing repository or clone another person's existing reposi {% data reusables.command_line.git-clone-url %} {% data reusables.command_line.local-clone-created %} - ### 排查克隆错误 在克隆仓库时，可能会遇到一些错误。 @@ -66,7 +65,6 @@ You can clone your existing repository or clone another person's existing reposi - 您有权访问要克隆的仓库。 更多信息请参阅“[错误：找不到仓库](/github/creating-cloning-and-archiving-repositories/error-repository-not-found)”。 - 要克隆的默认分支仍然存在。 您有权访问要克隆的仓库。 更多信息请参阅“[错误：远程 HEAD 引用不存在的 ref，无法检出](/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout)”。 - {% if currentVersion == "free-pro-team@latest" %} ### 延伸阅读 diff --git a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md index c2f0c1152faa..af87d8f86cb1 100644 --- a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md +++ b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/creating-a-new-repository.md @@ -23,20 +23,20 @@ versions: {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} {% tip %} -**Tip**: You can also create a repository using the {% data variables.product.prodname_cli %}. For more information, see "[`gh repo create`](https://cli.github.com/manual/gh_repo_create)" in the {% data variables.product.product_location %} documentation. +**提示**：您也可以使用 {% data variables.product.prodname_cli %} 创建仓库。 更多信息请参阅 {% data variables.product.product_location %} 文档中的“[`gh 仓库创建`](https://cli.github.com/manual/gh_repo_create)”。 {% endtip %} {% endif %} -{% data reusables.repositories.create_new %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} +{% data reusables.repositories.create_new %} 2. （可选）要创建具有现有仓库的目录结构和文件的仓库，请使用 **Choose a template（选择模板）**下拉菜单并选择一个模板仓库。 您将看到由您和您所属组织拥有的模板仓库，或者您以前使用过的模板仓库。 更多信息请参阅“[从模板创建仓库](/articles/creating-a-repository-from-a-template)”。 ![Template drop-down menu](/assets/images/help/repository/template-drop-down.png){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -3. （可选）如果您选择使用模板，要包括模板中所有分支的目录结构和文件，而不仅仅是默认分支，请选择 **Include all branches（包括所有分支）**。 ![Include all branches checkbox](/assets/images/help/repository/include-all-branches.png){% endif %}{% endif %} +3. （可选）如果您选择使用模板，要包括模板中所有分支的目录结构和文件，而不仅仅是默认分支，请选择 **Include all branches（包括所有分支）**。 ![Include all branches checkbox](/assets/images/help/repository/include-all-branches.png){% endif %} 3. 在“Owner（所有者）”下拉菜单中，选择要在其上创建仓库的帐户。 ![所有者下拉菜单](/assets/images/help/repository/create-repository-owner.png) {% data reusables.repositories.repo-name %} {% data reusables.repositories.choose-repo-visibility %} -6. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}如果没有使用模板，{% else %}{% endif %}您可以使用许多可选项预填充仓库。 如果要将现有仓库导入 {% data variables.product.product_name %}，请不要选择上述任何选项，否则可能会导致合并冲突。 您可以{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.15" %}通过用户界面添加或创建新文件，或者{% endif %}选择稍后使用命令行添加新文件。 更多信息请参阅“[使用命令行导入 Git 仓库](/articles/importing-a-git-repository-using-the-command-line/)”、“[使用命令行将文件添加到仓库](/articles/adding-a-file-to-a-repository-using-the-command-line)”和“[解决合并冲突](/articles/addressing-merge-conflicts/)”。 +6. If you're not using a template, there are a number of optional items you can pre-populate your repository with. 如果要将现有仓库导入 {% data variables.product.product_name %}，请不要选择上述任何选项，否则可能会导致合并冲突。 您可以通过用户界面添加或创建新文件，或者选择稍后使用命令行添加新文件。 更多信息请参阅“[使用命令行导入 Git 仓库](/articles/importing-a-git-repository-using-the-command-line/)”、“[使用命令行将文件添加到仓库](/articles/adding-a-file-to-a-repository-using-the-command-line)”和“[解决合并冲突](/articles/addressing-merge-conflicts/)”。 - 您可以创建自述文件以介绍您的项目。 更多信息请参阅“[关于自述文件](/articles/about-readmes/)”。 - - 您可以创建 *.gitignore* 文件以设置忽略规则。 更多信息请参阅“[忽略文件](/articles/ignoring-files)”。{% if currentVersion == "free-pro-team@latest" %} + - 您可以创建 *.gitignore* 文件以设置忽略规则。 For more information, see "[Ignoring files](/articles/ignoring-files)."{% if currentVersion == "free-pro-team@latest" %} - 您可以选择为项目添加软件许可。 更多信息请参阅“[许可仓库](/articles/licensing-a-repository)”。{% endif %} {% data reusables.repositories.select-marketplace-apps %} {% data reusables.repositories.create-repo %} @@ -47,6 +47,5 @@ versions: ### 延伸阅读 - “[管理对组织仓库的访问](/articles/managing-access-to-your-organization-s-repositories)” -- [开源指南](https://opensource.guide/){% if currentVersion == "free-pro-team@latest" %} -- [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}){% endif %}{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.16" %} -- “[使用自述文件初始化空仓库](/articles/initializing-an-empty-repository-with-a-readme)”。{% endif %} +- [Open Source Guides](https://opensource.guide/){% if currentVersion == "free-pro-team@latest" %} +- [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}){% endif %} diff --git a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md index ca52e70f681b..dd3a80f86010 100644 --- a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md +++ b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template.md @@ -5,17 +5,17 @@ redirect_from: - /articles/creating-a-repository-from-a-template versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- -### About repository templates +### 关于仓库模板 任何对模板仓库具有读取权限的人都可以从该模板创建仓库。 更多信息请参阅“[创建模板仓库](/articles/creating-a-template-repository)”。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} {% tip %} -**Tip**: You can also create a repository from a template using the {% data variables.product.prodname_cli %}. For more information, see "[`gh repo create`](https://cli.github.com/manual/gh_repo_create)" in the {% data variables.product.product_location %} documentation. +**提示**：您也可以使用 {% data variables.product.prodname_cli %} 从模板创建仓库。 更多信息请参阅 {% data variables.product.product_location %} 文档中的“[`gh 仓库创建`](https://cli.github.com/manual/gh_repo_create)”。 {% endtip %} {% endif %} diff --git a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md index 96ae76cde85a..985918901d8d 100644 --- a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md +++ b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/creating-a-template-repository.md @@ -1,19 +1,20 @@ --- -title: 创建模板仓库 -intro: '您可以将现有仓库设置为模板，以便您与其他人能够生成目录结构相同的新仓库{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}、分支{% endif %} 和文件。' +title: Creating a template repository +intro: 'You can make an existing repository a template, so you and others can generate new repositories with the same directory structure{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}, branches,{% endif %} and files.' redirect_from: - /articles/creating-a-template-repository versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- -任何对仓库有管理员权限的人都可以将该仓库设置为模板。 +Anyone with admin permissions to a repository can make the repository a template. -要创建模板仓库，必须先创建一个仓库，然后将该仓库设置为模板。 关于创建仓库的更多信息，请参阅“[创建新仓库](/articles/creating-a-new-repository)”。 +To create a template repository, you must create a repository, then make the repository a template. For more information about creating a repository, see "[Creating a new repository](/articles/creating-a-new-repository)." -将仓库设置为模板后，有权访问仓库的任何人都可以生成与默认分支具有相同目录结构和文件的新仓库。{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} 他们还可以选择包含您的仓库中的所有其他分支。{% endif %}更多信息请参阅“[从模板创建仓库](/articles/creating-a-repository-from-a-template)”。 +After you make your repository a template, anyone with access to the repository can generate a new repository with the same directory structure and files as your default branch.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} They can also choose to include all the other branches in your repository.{% endif %} For more information, see "[Creating a repository from a template](/articles/creating-a-repository-from-a-template)." {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} -3. 选择 **Template repository（模板仓库）**。 ![将仓库设置为模板的复选框](/assets/images/help/repository/template-repository-checkbox.png) +3. Select **Template repository**. + ![Checkbox to make a repository a template](/assets/images/help/repository/template-repository-checkbox.png) diff --git a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/duplicating-a-repository.md b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/duplicating-a-repository.md index 25b10eabae9d..3cb46985a98b 100644 --- a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/duplicating-a-repository.md +++ b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/duplicating-a-repository.md @@ -1,6 +1,6 @@ --- title: 复制仓库 -intro: 要复制存储库而不对其进行复制，可以运行特殊克隆命令，然后镜像推送到新仓库。 +intro: '要复制存储库而不对其进行复制，可以运行特殊克隆命令，然后镜像推送到新仓库。' redirect_from: - /articles/duplicating-a-repo/ - /articles/duplicating-a-repository diff --git a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md index 489c54277c98..7778005efe0c 100644 --- a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md +++ b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout.md @@ -1,5 +1,5 @@ --- -title: 错误：远程 HEAD 引用不存在的 ref，无法检出 +title: '错误：远程 HEAD 引用不存在的 ref，无法检出' intro: '如果已在 {% data variables.product.product_location %} 上删除仓库的默认分支，会发生此错误。' redirect_from: - /articles/error-remote-head-refers-to-nonexistent-ref-unable-to-checkout @@ -22,7 +22,7 @@ $ git clone https://{% data variables.command_line.codeblock %}/user/ warning: remote HEAD refers to nonexistent ref, unable to checkout. ``` -要修复此错误，您需要成为 {% data variables.product.product_location %} 上仓库的管理员。 您需要[更改仓库的默认分支](/articles/setting-the-default-branch)。 +要修复此错误，您需要成为 {% data variables.product.product_location %} 上仓库的管理员。 您需要[更改仓库的默认分支](/github/administering-a-repository/changing-the-default-branch)。 之后，您可以从命令行获取所有可用分支的列表： @@ -41,4 +41,5 @@ $ git checkout new-master # Create and checkout a tracking branch > Branch new-master set up to track remote branch new-master from origin. > Switched to a new branch 'new-master' +> Switched to a new branch 'new-main' ``` diff --git a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/error-repository-not-found.md b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/error-repository-not-found.md index aa392be295b4..d8fd8dd73c37 100644 --- a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/error-repository-not-found.md +++ b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/error-repository-not-found.md @@ -1,6 +1,6 @@ --- -title: 错误：未找到仓库 -intro: '{% if currentVersion == "free-pro-team@latest" %}如果在克隆仓库时看到此错误，则意味着仓库不存在或您无权访问仓库。 有一些针对此错误的解决方案，具体根据原因而定。{% else %}如果在克隆仓库时看到此错误，则意味着仓库不存在，您无权访问仓库，或者您的 GitHub Enterprise 实例处于私有模式。 有一些针对此错误的解决方案，具体根据原因而定。{% endif %}' +title: '错误：未找到仓库' +intro: '{% if currentVersion == "free-pro-team@latest" %}If you see this error when cloning a repository, it means that the repository does not exist or you do not have permission to access it. 有一些针对此错误的解决方案，具体根据原因而定。{% else %}如果在克隆仓库时看到此错误，则意味着仓库不存在，您无权访问仓库，或者您的 GitHub Enterprise 实例处于私有模式。 有一些针对此错误的解决方案，具体根据原因而定。{% endif %}' redirect_from: - /articles/error-repository-not-found versions: diff --git a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/https-cloning-errors.md b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/https-cloning-errors.md index b632d0b9d55d..c31f68f23d50 100644 --- a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/https-cloning-errors.md +++ b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/https-cloning-errors.md @@ -1,6 +1,6 @@ --- title: HTTPS 克隆错误 -intro: 对 Git 使用 HTTPS 时有几种常见错误。 这些错误通常表示您有旧版 Git，或无法访问仓库。 +intro: '对 Git 使用 HTTPS 时有几种常见错误。 这些错误通常表示您有旧版 Git，或无法访问仓库。' redirect_from: - /articles/error-the-requested-url-returned-error-403/ - /articles/error-the-requested-url-returned-error-401/ diff --git a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/index.md b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/index.md index 37b39a0cebd6..03bae93005bb 100644 --- a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/index.md +++ b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/index.md @@ -1,5 +1,5 @@ --- -title: 创建、克隆和存档仓库 +title: '创建、克隆和存档仓库' intro: '创建或克隆仓库时，您可以从各种配置选项中选择。 您还可以使用仓库来存档 {% data variables.product.prodname_dotcom %} 上的内容和数据。' redirect_from: - /categories/repositories/ diff --git a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md index b53bc5712143..432486c480ec 100644 --- a/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md +++ b/translations/zh-CN/content/github/creating-cloning-and-archiving-repositories/licensing-a-repository.md @@ -1,6 +1,6 @@ --- title: 许可仓库 -intro: GitHub 上的公共仓库常用于共享开源软件。 要使仓库真正开源，您需要许可它供其他人免费使用、更改和分发软件。 +intro: 'GitHub 上的公共仓库常用于共享开源软件。 要使仓库真正开源，您需要许可它供其他人免费使用、更改和分发软件。' redirect_from: - /articles/open-source-licensing/ - /articles/licensing-a-repository @@ -17,7 +17,7 @@ versions: {% note %} -**注：**如果您在 GitHub 的公共仓库中发布源代码，{% if currentVersion == "free-pro-team@latest" %}根据[服务条款](/articles/github-terms-of-service)，{% endif %}其他 GitHub 用户有权利在 GitHub 站点中查看您的仓库并对其复刻。 如果您已创建公共仓库，并且不再希望用户访问它，便可将仓库设为私有。 在将公共仓库转换为私有仓库时，其他用户创建的现有复刻或本地副本仍将存在。 更多信息请参阅“[将公共仓库设为私有](/articles/making-a-public-repository-private)”。 +**Note:** If you publish your source code in a public repository on GitHub, {% if currentVersion == "free-pro-team@latest" %}according to the [Terms of Service](/articles/github-terms-of-service), {% endif %}other GitHub users have the right to view and fork your repository within the GitHub site. 如果您已创建公共仓库，并且不再希望用户访问它，便可将仓库设为私有。 在将公共仓库转换为私有仓库时，其他用户创建的现有复刻或本地副本仍将存在。 更多信息请参阅“[将公共仓库设为私有](/articles/making-a-public-repository-private)”。 {% endnote %} @@ -49,6 +49,7 @@ versions: | | Do What The F*ck You Want To Public License | `wtfpl` | | | Educational Community License v2.0 | `ecl-2.0` | | | Eclipse Public License 1.0 | `epl-1.0` | +| | Eclipse Public License 2.0 | `epl-2.0` | | | European Union Public License 1.1 | `eupl-1.1` | | | GNU Affero General Public License v3.0 | `agpl-3.0` | | | GNU General Public License 系列 | `gpl` | @@ -89,5 +90,5 @@ GitHub 开源许可的目标是提供一个起点，帮助您做出明智的决 ### 延伸阅读 -- 开源指南的“[开源的法律方面](https://opensource.guide/legal/)”部分{% if currentVersion == "free-pro-team@latest" %} +- The Open Source Guides' section "[The Legal Side of Open Source](https://opensource.guide/legal/)"{% if currentVersion == "free-pro-team@latest" %} - [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}){% endif %} diff --git a/translations/zh-CN/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md b/translations/zh-CN/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md new file mode 100644 index 000000000000..0871503bf376 --- /dev/null +++ b/translations/zh-CN/content/github/developing-online-with-codespaces/about-billing-for-codespaces.md @@ -0,0 +1,27 @@ +--- +title: About billing for Codespaces +intro: 'When {% data variables.product.prodname_codespaces %} becomes generally available, you will be billed for storage and compute usage.' +product: '{% data reusables.gated-features.codespaces %}' +versions: + free-pro-team: '*' +--- + +{% data reusables.codespaces.release-stage %} + +{% data reusables.codespaces.about-billing-for-codespaces %} + +Compute costs are incurred only when a codespace is active. When you're using a codespace, the codespace is active. After 30 minutes of inactivity, a codespace becomes suspended automatically. + +Compute usage is billed per hour, at a rate that depends on your codespace's instance type. During the beta, {% data variables.product.prodname_codespaces %} offers a single, Linux instance type. At general availability, we'll support three Linux instance types. + +| Instance Type (Linux) | Per-hour rate | +| --------------------------------------- | ------------- | +| Basic (2 cores, 4GB RAM, 32 GB SSD) | $0.085 | +| Standard (4 cores, 8 GB RAM, 32 GB SSD) | $0.169 | +| Premium (8 cores, 16 GB RAM, 32 GB SSD) | $0.339 | + +Compute pricing may vary for additional instance types and operating systems supported in the future. + +Each codespace also incurs monthly storage costs until you delete the codespace. Storage costs for all instance types are $0.10/GB-month. + +We'll share more information about any compute and storage usage included in each plan at general availability. diff --git a/translations/zh-CN/content/github/developing-online-with-codespaces/about-codespaces.md b/translations/zh-CN/content/github/developing-online-with-codespaces/about-codespaces.md index dbcccf796c69..8328dc22cae1 100644 --- a/translations/zh-CN/content/github/developing-online-with-codespaces/about-codespaces.md +++ b/translations/zh-CN/content/github/developing-online-with-codespaces/about-codespaces.md @@ -16,7 +16,7 @@ versions: ### 关于 {% data variables.product.prodname_codespaces %} -{% data variables.product.prodname_codespaces %} is a cloud development environment available in your browser. 代码空间包括为特定仓库开发所需的一切，其中包括具有语法突出显示和自动完成功能的文本编辑器、终端、调试工具和 Git 命令，所有这些都集成在 {% data variables.product.prodname_dotcom %} 中。 您也可以在代码空间中安装 {% data variables.product.prodname_vscode %} 扩展以添加更多功能。 +{% data variables.product.prodname_codespaces %} 是适用于浏览器的云开发环境。 代码空间包括为特定仓库开发所需的一切，其中包括具有语法突出显示和自动完成功能的文本编辑器、终端、调试工具和 Git 命令，所有这些都集成在 {% data variables.product.prodname_dotcom %} 中。 您也可以在代码空间中安装 {% data variables.product.prodname_vscode %} 扩展以添加更多功能。 {% data variables.product.prodname_codespaces %} 使开发人员更容易加入新公司或开始为开源项目做出贡献。 项目维护员可以配置仓库，以便在为仓库创建代码空间时自动包含项目的依赖项。 减少配置环境所用的时间，可以更快地开始编码。 @@ -44,7 +44,7 @@ versions: ### 关于 {% data variables.product.prodname_codespaces %} 的计费 -During the limited public beta, {% data variables.product.prodname_codespaces %} is free to use and users are limited to 2 codespaces. 计划和定价将在公开发布前公布。 +{% data reusables.codespaces.about-billing-for-codespaces %} 更多信息请参阅“[关于 {% data variables.product.prodname_codespaces %} 的计费](/github/developing-online-with-codespaces/about-billing-for-codespaces)”。 ### 加入公测 @@ -54,4 +54,4 @@ During the limited public beta, {% data variables.product.prodname_codespaces %} 如果在使用 {% data variables.product.prodname_codespaces %} 时遇到问题，请参阅“[代码空间故障排除](/github/developing-online-with-codespaces/troubleshooting-your-codespace)”。 -If you still need help or have feedback about {% data variables.product.prodname_codespaces %}, use the [Community Forum](https://github.community/c/codespaces-beta/45). +如果您仍需帮助或有关于 {% data variables.product.prodname_codespaces %} 的反馈，请使用[社区论坛](https://github.community/c/codespaces-beta/45)。 diff --git a/translations/zh-CN/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md b/translations/zh-CN/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md index 4616a13f2574..3316eaf911bf 100644 --- a/translations/zh-CN/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md +++ b/translations/zh-CN/content/github/developing-online-with-codespaces/configuring-codespaces-for-your-project.md @@ -15,13 +15,15 @@ versions: {% data reusables.codespaces.about-configuration %} -If you don't define a configuration in your repository, {% data variables.product.prodname_dotcom %} creates a codespace with a base Linux image. The base Linux image includes tools for Node.js, JavaScript, TypeScript, Python, C++, Java, C#, .NET Core, PHP, and PowerShell. For more information about the base Linux image, see the [`microsoft/vscode-dev-containers`](https://github.com/microsoft/vscode-dev-containers/tree/master/containers/codespaces-linux) repository. +如果您没有在仓库中定义配置，{% data variables.product.prodname_dotcom %} 将创建一个具有基本 Linux 映像的代码空间。 基本 Linux 映像包括适用于 Node.js、JavaScript、TypeScript、Python、C++、Java、C#、.NET Core、PHP 和 PowerShell 的工具。 有关基本 Linux 映像的更多信息，请参阅 [`microsoft/vscode-dev-containers`](https://github.com/microsoft/vscode-dev-containers/tree/master/containers/codespaces-linux) 仓库。 {% data reusables.codespaces.about-personalization %} {% data reusables.codespaces.codespace-config-order %} 更多信息请参阅“[个性化您帐户的 {% data variables.product.prodname_codespaces %}](/github/developing-online-with-codespaces/personalizing-codespaces-for-your-account)”。 您可以使用项目类型的预建容器配置创建默认代码空间配置，也可以根据项目需要创建自定义配置。 -{% data variables.product.prodname_codespaces %} 使用仓库根目录下或 `.devcontainer` 文件夹下 `devcontainer.json` 文件包含的设置。 您可以使用 `devcontainer.json` 为整个代码空间环境设置默认设置，包括 {% data variables.product.prodname_vscode %} 编辑器，但您也可以在 `.vscode/set.json` 文件中设置编辑器特定的设置。 +{% data variables.product.prodname_codespaces %} uses settings contained in a configuration file named `devcontainer.json`. {% data reusables.codespaces.devcontainer-location %} + +You can use your `devcontainer.json` to set default settings for the entire codespace environment, including the {% data variables.product.prodname_vscode %} editor, but you can also set editor-specific settings in a file named `.vscode/settings.json`. 对仓库代码空间配置的更改只会应用到每个新的代码空间，而不影响任何现有的代码空间。 @@ -30,15 +32,17 @@ If you don't define a configuration in your repository, {% data variables.produc 您可以对 [`vscode-dev-containers`](https://github.com/microsoft/vscode-dev-containers) 仓库中的 {% data variables.product.prodname_vscode %} 使用任何预建容器配置。 预建容器定义包括特定项目类型的共同配置，可帮助您利用现有的配置快速开始使用，配置中已经有适当的容器选项、{% data variables.product.prodname_vscode %} 设置和应该安装的 {% data variables.product.prodname_vscode %} 扩展。 1. 克隆或下载 [`vscode-dev-containers`](https://github.com/microsoft/vscode-dev-containers) 仓库。 -1. 在 `vscode-dev-containers` 仓库中，导航到 [`containers`](https://github.com/microsoft/vscode-dev-containers/tree/master/containers) 文件夹，然后选择符合项目需求的容器配置。 We'll use the [Node.js & JavaScript](https://aka.ms/vscode-dev-containers/definitions/node) container configuration as an example. -1. From the [`Node.js & JavaScript`](https://aka.ms/vscode-dev-containers/definitions/node) folder, copy the `.devcontainer` folder to the root of your project's repository. +1. 在 `vscode-dev-containers` 仓库中，导航到 [`containers`](https://github.com/microsoft/vscode-dev-containers/tree/master/containers) 文件夹，然后选择符合项目需求的容器配置。 我们将使用 [Node.js & JavaScript](https://aka.ms/vscode-dev-containers/definitions/node) 容器配置作为示例。 +1. 将 `.devcontainer` 文件夹从 [`Node.js & JavaScript`](https://aka.ms/vscode-dev-containers/definitions/node) 文件夹复制到项目仓库的根目录。 1. 提交并推送新配置到 {% data variables.product.prodname_dotcom %} 上的项目仓库。 从包含 `.devcontainer` 文件夹的分支创建的每个新代码空间将根据文件夹内容进行配置。 更多信息请参阅“[创建代码空间](/github/developing-online-with-codespaces/creating-a-codespace)”。 ### 创建自定义代码空间配置 -如果没有预建配置满足您的需求，可通过将 `devcontainer.json` 文件添加到仓库根目录或`.devcontainer` 文件夹来创建自定义配置。 在该文件中，您可以使用支持的配置键来指定代码库环境的各个方面，例如要安装哪些 {% data variables.product.prodname_vscode %} 扩展。 +If none of the pre-built configurations meet your needs, you can create a custom configuration by adding a `devcontainer.json` file. {% data reusables.codespaces.devcontainer-location %} + +在该文件中，您可以使用支持的配置键来指定代码库环境的各个方面，例如要安装哪些 {% data variables.product.prodname_vscode %} 扩展。 {% data reusables.codespaces.vscode-settings-order %} diff --git a/translations/zh-CN/content/github/developing-online-with-codespaces/creating-a-codespace.md b/translations/zh-CN/content/github/developing-online-with-codespaces/creating-a-codespace.md index 5037e6799321..47b57bc6ccb0 100644 --- a/translations/zh-CN/content/github/developing-online-with-codespaces/creating-a-codespace.md +++ b/translations/zh-CN/content/github/developing-online-with-codespaces/creating-a-codespace.md @@ -2,7 +2,7 @@ title: 创建代码空间 intro: 您可以为仓库中的分支创建代码空间以便在线开发。 product: '{% data reusables.gated-features.codespaces %}' -permissions: 任何人都可以为任何公共仓库或其用户帐户拥有的任何私有仓库创建代码空间。 +permissions: '任何人都可以为任何公共仓库或其用户帐户拥有的任何私有仓库创建代码空间。' redirect_from: - /github/developing-online-with-github-codespaces/creating-a-codespace versions: diff --git a/translations/zh-CN/content/github/developing-online-with-codespaces/developing-in-a-codespace.md b/translations/zh-CN/content/github/developing-online-with-codespaces/developing-in-a-codespace.md index 9678999985b5..cc30dddc201e 100644 --- a/translations/zh-CN/content/github/developing-online-with-codespaces/developing-in-a-codespace.md +++ b/translations/zh-CN/content/github/developing-online-with-codespaces/developing-in-a-codespace.md @@ -15,29 +15,29 @@ versions: {% data reusables.codespaces.use-chrome %} 更多信息请参阅“[代码空间故障排除](/github/developing-online-with-codespaces/troubleshooting-your-codespace)”。 -### Connecting to a codespace from {% data variables.product.prodname_vscode %} +### 从 {% data variables.product.prodname_vscode %} 连接到代码空间 {% data reusables.codespaces.connect-to-codespace-from-vscode %} -### Navigating to your codespace +### 导航到您的代码空间 {% data reusables.codespaces.navigate-to-codespaces %} 2. 单击您要在其中开发的代码空间的名称。 ![代码空间的名称](/assets/images/help/codespaces/click-name-codespace.png) -### Forwarding ports +### 转发端口 -Port forwarding gives you access to TCP ports running within your codespace. For example, if you're running a web application on port 3000, you can access the application from your browser to test and debug it. +通过端口转发，您可以访问在代码空间内运行的 TCP 端口。 例如，如果您在端口 3000 上运行 Web 应用程序，您可以从浏览器访问该应用程序以测试和调试它。 -When an application running inside a codespace outputs a port to the console, {% data variables.product.prodname_codespaces %} detects the localhost URL pattern and automatically forwards those ports. You can click on the URL in the terminal to open it in a browser. For example, if an application outputs `http://127.0.0.1:3000` or `http://localhost:3000` to the console, the log would automatically convert the output to a clickable URL for port 3000. +在代码空间内运行的应用程序向控制台输出端口时，{% data variables.product.prodname_codespaces %} 将检测到 localhost URL 模式并自动转发这些端口。 您可以单击终端中的 URL 在浏览器中打开它。 例如，如果应用程序向控制台输出 `http://127.0.0.1:3000` 或 `http://localhost:3000`，则日志会自动将输出转换为端口 3000 的可单击 URL。 -![Automatic Port Forwarding](/assets/images/help/codespaces/automatic-port-forwarding.png) +![自动端口转发](/assets/images/help/codespaces/automatic-port-forwarding.png) -Alternatively, you can also use any of the following ways to forward a port. +或者，您也可以使用以下任意方式转发端口。 -* You can forward a port on demand by triggering the command palette (`shift command P` / `shift control P`) and typing "Codespaces: Forward Port". You can then enter the number of the port you want to forward. +* 您可以通过触发命令面板 (`shift command P` / `shift control P`) 并键入 "Codespaces: Forward Port" 来按需转发端口。 然后，您可以输入要转发的端口的编号。 - ![Command Palette Port Forwarding](/assets/images/help/codespaces/command-palette-port-forwarding.png) + ![命令面板端口转发](/assets/images/help/codespaces/command-palette-port-forwarding.png) -* You can automatically configure forwarded ports in a `.devcontainer.json` file using the `forwardPorts` property. +* 您可以使用 `forwardPorts` 属性在 `.devcontainer.json` 文件中自动配置转发的端口。 -* You can add or remove forwarded ports within the Remote Explorer extension. From the Remote Explorer you can copy and paste the URLs for forwarded ports, allowing you to access them through your browser. +* 您可以在远程资源管理器扩展中添加或删除转发的端口。 从远程资源管理器中，您可以复制和粘贴转发端口的 URL，从而可以通过浏览器访问它们。 - ![Remote Explorer Port Forwarding](/assets/images/help/codespaces/remote-explorer-port-forwarding.png) + ![远程资源管理器端口转发](/assets/images/help/codespaces/remote-explorer-port-forwarding.png) diff --git a/translations/zh-CN/content/github/developing-online-with-codespaces/index.md b/translations/zh-CN/content/github/developing-online-with-codespaces/index.md index 5b99109849c7..df194c0a02d6 100644 --- a/translations/zh-CN/content/github/developing-online-with-codespaces/index.md +++ b/translations/zh-CN/content/github/developing-online-with-codespaces/index.md @@ -14,10 +14,12 @@ versions: ### 目录 {% link_in_list /about-codespaces %} +{% link_in_list /about-billing-for-codespaces %} {% link_in_list /configuring-codespaces-for-your-project %} {% link_in_list /creating-a-codespace %} {% link_in_list /developing-in-a-codespace %} {% link_in_list /personalizing-codespaces-for-your-account %} {% link_in_list /deleting-a-codespace %} {% link_in_list /troubleshooting-your-codespace %} -{% link_in_list /connecting-to-your-codespace-from-visual-studio-code %} +{% link_in_list /using-codespaces-in-visual-studio-code %} +{% link_in_list /using-codespaces-in-visual-studio %} diff --git a/translations/zh-CN/content/github/developing-online-with-codespaces/personalizing-codespaces-for-your-account.md b/translations/zh-CN/content/github/developing-online-with-codespaces/personalizing-codespaces-for-your-account.md index 92e2affc8564..d3b61129a8ec 100644 --- a/translations/zh-CN/content/github/developing-online-with-codespaces/personalizing-codespaces-for-your-account.md +++ b/translations/zh-CN/content/github/developing-online-with-codespaces/personalizing-codespaces-for-your-account.md @@ -22,7 +22,7 @@ Dotfiles 是类似 Unix 的系统上以 `.` 开头的文件和文件夹，用于 创建新的代码空间时，{% data variables.product.prodname_dotcom %} 会将 `dotfile` 仓库克隆到代码空间环境，并查找以下文件之一来设置环境。 * _install.sh_ -* _install_ +* _安装_ * _bootstrap.sh_ * _bootstrap_ * _setup.sh_ diff --git a/translations/zh-CN/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md b/translations/zh-CN/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md new file mode 100644 index 000000000000..49a0d649aa10 --- /dev/null +++ b/translations/zh-CN/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md @@ -0,0 +1,45 @@ +--- +title: 在 Visual Studio Code 中使用代码空间 +intro: '您可以将 {% data variables.product.prodname_vs_codespaces %} 扩展连接到您在 {% data variables.product.product_name %} 上的帐户，直接在 {% data variables.product.prodname_vscode %} 代码空间中开发。' +product: '{% data reusables.gated-features.codespaces %}' +redirect_from: + - /github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code +versions: + free-pro-team: '*' +--- + +{% data reusables.codespaces.release-stage %} + +### 基本要求 + +直接在 {% data variables.product.prodname_vscode %} 的代码空间中开发之前，您必须配置 {% data variables.product.prodname_vs_codespaces %} 扩展连接到您的 {% data variables.product.product_name %} 帐户。 + +1. 使用 {% data variables.product.prodname_vs %} Marketplace 安装 [{% data variables.product.prodname_vs_codespaces %}](https://marketplace.visualstudio.com/items?itemName=ms-vsonline.vsonline) 扩展。 更多信息请参阅 {% data variables.product.prodname_vscode %} 文档中的[扩展 Marketplace](https://code.visualstudio.com/docs/editor/extension-gallery)。 +2. 在 {% data variables.product.prodname_vscode %} 中，从左侧边栏单击 Extensions（扩展）图标。 ![{% data variables.product.prodname_vscode %} 中的 Extensions（扩展）图标](/assets/images/help/codespaces/click-extensions-icon-vscode.png) +3. 在 {% data variables.product.prodname_vs_codespaces %} 下面，单击 Manage（管理）图标，然后单击 **Extension Settings（扩展设置）**。 ![Extension Settings（扩展设置）选项](/assets/images/help/codespaces/select-extension-settings.png) +4. 使用“Vsonline: Account Provider（Vsonline：帐户提供商）”下拉菜单，选择 {% data variables.product.prodname_dotcom %}。 ![设置帐户提供者为 {% data variables.product.prodname_dotcom %}](/assets/images/help/codespaces/select-account-provider-vscode.png) +{% data reusables.codespaces.click-remote-explorer-icon-vscode %} +6. 如果尚未在标题中选择 {% data variables.product.prodname_codespaces %}，请单击 **{% data variables.product.prodname_codespaces %}**。 ![{% data variables.product.prodname_codespaces %} 标头](/assets/images/help/codespaces/codespaces-header-vscode.png) +7. 单击 **Sign in to view {% data variables.product.prodname_codespaces %}...（登录以查看 Codespaces...）**。 ![登录以查看 {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/sign-in-to-view-codespaces-vscode.png) +8. 要授权 {% data variables.product.prodname_vscode %} 访问您在 {% data variables.product.product_name %} 上的帐户，请单击 **Allow（允许）**。 +9. 登录 {% data variables.product.product_name %} 以审批扩展。 + +### 在 {% data variables.product.prodname_vscode %} 中创建代码空间 + +After you connect your {% data variables.product.product_name %} account to the {% data variables.product.prodname_vs_codespaces %} extension, you can develop in a codespace that you created on {% data variables.product.product_name %} or in {% data variables.product.prodname_vscode %}. + +{% data reusables.codespaces.click-remote-explorer-icon-vscode %} +2. Click the Add icon, then click **Create New Codespace**. ![The Create new Codespace option in {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/create-codespace-vscode.png) +3. Type, then click the repository's name you want to develop in. ![Searching for repository to create a new {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/choose-repository-vscode.png) +4. Click the branch you want to develop in. ![Searching for a branch to create a new {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/choose-branch-vscode.png) + +### 在 {% data variables.product.prodname_vscode %} 中打开代码空间 + +{% data reusables.codespaces.click-remote-explorer-icon-vscode %} +2. 在 Codespaces（代码空间）下，单击您要在其中开发的代码空间。 +3. 单击 Connect to Codespace（连接到代码空间）图标。 ![{% data variables.product.prodname_vscode %} 中的连接到代码空间图标](/assets/images/help/codespaces/click-connect-to-codespace-icon-vscode.png) + +### Deleting a codespace in {% data variables.product.prodname_vscode %} + +1. Under Codespaces, right-click the codespace you want to delete. +2. In the drop-down menu, click **Delete Codespace**. ![Deleting a codespace in {% data variables.product.prodname_dotcom %}](/assets/images/help/codespaces/delete-codespace-vscode.png) diff --git a/translations/zh-CN/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md b/translations/zh-CN/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md new file mode 100644 index 000000000000..09bb634fa2a7 --- /dev/null +++ b/translations/zh-CN/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio.md @@ -0,0 +1,53 @@ +--- +title: 在 Visual Studio 中使用代码空间 +intro: '通过与 {% data variables.product.product_name %} 上的帐户连接，您可以直接在 {% data variables.product.prodname_vs %} 的代码空间中进行开发。' +product: '{% data reusables.gated-features.codespaces %}' +versions: + free-pro-team: '*' +--- + +{% note %} + +**注：**{% data variables.product.prodname_codespaces %} 目前是有限公测版，可能会有变动。 在公测期间，{% data variables.product.prodname_dotcom %} 不对 {% data variables.product.prodname_codespaces %} 的可用性做任何保证。 [注册有限公测版](https://github.com/features/codespaces/signup-vs)。 有关加入公测的更多信息，请参阅“[关于 {% data variables.product.prodname_codespaces %}](/github/developing-online-with-codespaces/about-codespaces#joining-the-beta)”。 + +{% endnote %} + +### 关于 {% data variables.product.prodname_vs %} 中的代码空间 + +您可以在 {% data variables.product.prodname_vs %} 中创建代码来开发 Windows 环境中的应用程序。 在 {% data variables.product.prodname_vs %} 中使用代码空间时，您可以浏览源代码、构建解决方案以及将更改提交到仓库。 + +您必须在 {% data variables.product.prodname_vs %} 中创建代码空间才能将其用于应用程序。 在 {% data variables.product.prodname_vs %} 外部创建的代码空间目前无法与 {% data variables.product.prodname_vs %} 结合使用。 + +### 基本要求 + +在 {% data variables.product.prodname_vs %} 中配置代码空间之前，您必须下载最新版本的 [{% data variables.product.prodname_vs %} 预览](https://aka.ms/vspreview)。 + +#### 启用 {% data variables.product.prodname_vs %} 与 {% data variables.product.prodname_github_codespaces %} 之间的连接 + +{% data variables.product.prodname_github_codespaces %} 与 {% data variables.product.prodname_vs %} 的连接在默认情况下未启用，因此您首先需要启用 Preview Features（预览功能）选项。 + +1. 在 {% data variables.product.prodname_vs %} 预览中，使用 Tools（工具）下拉菜单，然后单击 **Options（选项）**。 +2. 在 **Environment（环境）**下，选择 **Preview Features（预览功能）**，然后选中**连接到 {% data variables.product.prodname_github_codespaces %}** 预览功能。 ![选中“连接到 {% data variables.product.prodname_github_codespaces %} 预览功能”](/assets/images/help/codespaces/connect-to-github-codespaces-preview-feature.png) +3. 您需要重新启动 {% data variables.product.prodname_vs %} 才能使用该功能。 + +### 在 {% data variables.product.prodname_vs %} 中创建代码空间 + +1. 启动 {% data variables.product.prodname_vs %} 时，Start （开始）窗口将在“Get started（开始使用）”下显示 **Connect to a codespace（连接到代码空间）**按钮。 ![带有“连接到代码空间”的 Visual Studio 开始窗口](/assets/images/help/codespaces/visual-studio-start-window.png) +2. 单击 **Connect to a codespace（连接到代码空间）**。 +3. 单击**登录 {% data variables.product.prodname_dotcom %}** 并按提示操作，或者单击 **Create one!（创建一个！）**以创建新的 {% data variables.product.prodname_dotcom %} 帐户并登录该帐户。 ![Visual Studio 登录到 {% data variables.product.prodname_dotcom %}](/assets/images/help/codespaces/visual-studio-sign-in-to-github.png) +4. 在“Codespace details（代码空间详情）”下，键入您希望 {% data variables.product.prodname_github_codespaces %} 克隆到代码空间的仓库 URL。 +5. （可选）使用 Instance type（实例类型）和 Suspend after（完成后挂起）下拉菜单配置更多代码空间详细信息。 ![Visual Studio 代码空间详情](/assets/images/help/codespaces/visual-studio-codespace-details.png) +6. 单击 **Create and Connect（创建并连接）**。 {% data variables.product.prodname_github_codespaces %} 将开始准备代码空间，并在代码空间准备就绪后打开 {% data variables.product.prodname_vs %}。 代码空间名称将出现在菜单的远程指示器中。 ![连接到 eShopOnWeb 仓库代码空间的 Visual Studio](/assets/images/help/codespaces/visual-studio-eshoponweb-codespace.png) + +### 在 {% data variables.product.prodname_vs %} 中打开代码空间 + +1. 使用 File（文件）下拉菜单，然后单击 **Connect to a Codespace（连接到代码空间）**。 ![Visual Studio 文件连接到代码空间菜单项](/assets/images/help/codespaces/visual-studio-file-connect-to-codespace.png) +2. 在 "{% data variables.product.prodname_github_codespaces %}" 下，单击要连接到的代码空间，然后单击 **Connect（连接）**。 ![显示可用代码空间和详细信息的 Visual Studio](/assets/images/help/codespaces/visual-studio-connect-codespace.png) + +### 配置 {% data variables.product.prodname_vs %} 的代码空间 + +通过 {% data variables.product.prodname_vs %} 创建的默认代码空间环境包括流行的框架和工具，例如 .NET Core、Microsoft SQL Server、Python 和 Windows SDK。 使用 {% data variables.product.prodname_vs %} 创建的{% data variables.product.prodname_github_codespaces %} 可通过一组 `devcontainers.json` 属性和 {% data variables.product.prodname_vs %} 随附的新工具 devinit 进行自定义。 + +#### devinit + +[devinit](https://docs.microsoft.com/visualstudio/devinit/getting-started-with-devinit) 命令行工具允许您将额外的框架和工具安装到 Windows 开发代码空间中，以及运行 PowerShell 脚本或修改环境变量。 devinit 支持名为 [devinit.json](https://docs.microsoft.com/visualstudio/devinit/devinit-json) 的配置文件，该文件可添加到您的项目中用于创建自定义和可重复的开发环境。 有关 Windows 代码空间配置和 devinit 的更多信息，请参阅 {% data variables.product.prodname_vs %} 文档中的[自定义代码空间](https://docs.microsoft.com/visualstudio/ide/codespaces/customize-codespaces)。 diff --git a/translations/zh-CN/content/github/extending-github/getting-started-with-the-api.md b/translations/zh-CN/content/github/extending-github/getting-started-with-the-api.md index 87d94c79def7..7a79d92ee778 100644 --- a/translations/zh-CN/content/github/extending-github/getting-started-with-the-api.md +++ b/translations/zh-CN/content/github/extending-github/getting-started-with-the-api.md @@ -13,5 +13,5 @@ versions: ### 延伸阅读 -- "[备份仓库](/articles/backing-up-a-repository)"{% if currentVersion == "free-pro-team@latest" %} +- "[Backing up a repository](/articles/backing-up-a-repository)"{% if currentVersion == "free-pro-team@latest" %} - “[关于集成](/articles/about-integrations)”{% endif %} diff --git a/translations/zh-CN/content/github/extending-github/git-automation-with-oauth-tokens.md b/translations/zh-CN/content/github/extending-github/git-automation-with-oauth-tokens.md index 2e2ed413a628..67003898b460 100644 --- a/translations/zh-CN/content/github/extending-github/git-automation-with-oauth-tokens.md +++ b/translations/zh-CN/content/github/extending-github/git-automation-with-oauth-tokens.md @@ -18,7 +18,7 @@ versions: {% if currentVersion == "free-pro-team@latest" %} **提示：** -- You must verify your email address before you can create a personal access token. 更多信息请参阅“[验证电子邮件地址](/articles/verifying-your-email-address)”。 +- 您必须先验证您的电子邮件地址才能创建个人访问令牌。 更多信息请参阅“[验证电子邮件地址](/articles/verifying-your-email-address)”。 - {% data reusables.user_settings.review_oauth_tokens_tip %} {% else %} **提示：**{% data reusables.user_settings.review_oauth_tokens_tip %} @@ -32,7 +32,7 @@ versions: {% data reusables.command_line.providing-token-as-password %} -To avoid these prompts, you can use Git password caching. 有关信息请参阅“[在 Git 中缓存 GitHub 凭据](/github/using-git/caching-your-github-credentials-in-git)”。 +为了避免这些提示，您可以使用 Git 密码缓存。 有关信息请参阅“[在 Git 中缓存 GitHub 凭据](/github/using-git/caching-your-github-credentials-in-git)”。 {% warning %} diff --git a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md index defb7d667560..ff27712b4928 100644 --- a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md +++ b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning.md @@ -18,7 +18,7 @@ versions: You can use {% data variables.product.prodname_code_scanning %} to find, triage, and prioritize fixes for existing problems in your code. {% data variables.product.prodname_code_scanning_capc %} also prevents developers from introducing new problems. You can schedule scans for specific days and times, or trigger scans when a specific event occurs in the repository, such as a push. -If {% data variables.product.prodname_code_scanning %} finds a potential vulnerability or error in your code, {% data variables.product.prodname_dotcom %} displays an alert in the repository. After you fix the code that triggered the alert, {% data variables.product.prodname_dotcom %} closes the alert. For more information, see "[Managing alerts from {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." +If {% data variables.product.prodname_code_scanning %} finds a potential vulnerability or error in your code, {% data variables.product.prodname_dotcom %} displays an alert in the repository. After you fix the code that triggered the alert, {% data variables.product.prodname_dotcom %} closes the alert. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." To monitor results from {% data variables.product.prodname_code_scanning %} across your repositories or your organization, you can use the {% data variables.product.prodname_code_scanning %} API. For more information about API endpoints, see "[{% data variables.product.prodname_code_scanning_capc %}](/v3/code-scanning)." diff --git a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md index 6bbfe1543f37..09829181e933 100644 --- a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md +++ b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning.md @@ -1,7 +1,7 @@ --- -title: About integration with code scanning -shortTitle: About integration -intro: 'You can perform {% data variables.product.prodname_code_scanning %} externally and then display the results in {% data variables.product.prodname_dotcom %}.' +title: 关于与代码扫描的集成 +shortTitle: 关于集成 +intro: 'You can perform {% data variables.product.prodname_code_scanning %} externally and then display the results in {% data variables.product.prodname_dotcom %}, or set up webhooks that listen to {% data variables.product.prodname_code_scanning %} activity in your repository.' product: '{% data reusables.gated-features.code-scanning %}' versions: free-pro-team: '*' @@ -11,14 +11,16 @@ versions: {% data reusables.code-scanning.beta %} {% data reusables.code-scanning.enterprise-enable-code-scanning %} -As an alternative to running {% data variables.product.prodname_code_scanning %} within {% data variables.product.prodname_dotcom %}, you can perform analysis elsewhere and then upload the results. Alerts for {% data variables.product.prodname_code_scanning %} that you run externally are displayed in the same way as those for {% data variables.product.prodname_code_scanning %} that you run within {% data variables.product.prodname_dotcom %}. For more information, see "[Managing alerts from code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." +作为在 {% data variables.product.prodname_dotcom %} 中运行 {% data variables.product.prodname_code_scanning %} 的替代方法，您可以在其他地方执行分析，然后上传结果。 在外部运行的 {% data variables.product.prodname_code_scanning %} 的警报显示方式与在 {% data variables.product.prodname_dotcom %} 内运行的 {% data variables.product.prodname_code_scanning %} 的警报显示方式相同。 For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." -You can use your continuous integration or continuous delivery/deployment (CI/CD) system to run {% data variables.product.prodname_dotcom %}'s {% data variables.product.prodname_codeql %} analysis and upload the results to {% data variables.product.prodname_dotcom %}. This is an alternative to using {% data variables.product.prodname_actions %} to run {% data variables.product.prodname_codeql %} analysis. For more information, see "[Running code scanning in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)." +如果使用可生成结果为静态分析结果交换格式 (SARIF) 2.1.0 数据的第三方静态分析工具，您可以将其上传到 {% data variables.product.prodname_dotcom %}。 更多信息请参阅“[将 SARIF 文件上传到 GitHub](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)”。 -If you use a third-party static analysis tool that can produce results as Static Analysis Results Interchange Format (SARIF) 2.1.0 data, you can upload this to {% data variables.product.prodname_dotcom %}. 更多信息请参阅“[将 SARIF 文件上传到 GitHub](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)”。 +### Integrations with webhooks + +You can use {% data variables.product.prodname_code_scanning %} webhooks to build or set up integrations, such as [{% data variables.product.prodname_github_app %}s](/apps/building-github-apps/) or [{% data variables.product.prodname_oauth_app %}s](/apps/building-oauth-apps/), that subscribe to {% data variables.product.prodname_code_scanning %} events in your repository. For example, you could build an integration that creates an issue on {% data variables.product.product_location %} or sends you a Slack notification when a new {% data variables.product.prodname_code_scanning %} alert is added in your repository. For more information, see "[Creating webhooks](/developers/webhooks-and-events/creating-webhooks)" and "[Webhook events and payloads](/developers/webhooks-and-events/webhook-events-and-payloads#code_scanning_alert)." ### 延伸阅读 -* "[About code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)" -* "[Configuring code scanning in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-in-your-ci-system)" -* "[SARIF support for code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning)" +* "[About {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)" +* "[Using {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} with your existing CI system +* "[SARIF support for {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning)" diff --git a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md index dae568835e64..f284249b672c 100644 --- a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md +++ b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors.md @@ -3,6 +3,7 @@ title: 自动扫描代码以查找漏洞和错误 shortTitle: 自动扫描 intro: '您可以在 {% data variables.product.prodname_dotcom %} 上查找项目代码中的漏洞和错误。' mapTopic: true +product: '{% data reusables.gated-features.code-scanning %}' versions: free-pro-team: '*' enterprise-server: '>=2.22' diff --git a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md index 5ba752e81d4d..af2300e7a3c5 100644 --- a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md +++ b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md @@ -1,8 +1,8 @@ --- -title: 配置代码扫描 -intro: '您可以配置 {% data variables.product.prodname_dotcom %} 如何扫描项目代码以查找漏洞和错误。' +title: Configuring code scanning +intro: 'You can configure how {% data variables.product.prodname_dotcom %} scans the code in your project for vulnerabilities and errors.' product: '{% data reusables.gated-features.code-scanning %}' -permissions: '拥有仓库写入权限的人可配置仓库的 {% data variables.product.prodname_code_scanning %}。' +permissions: 'People with write permissions to a repository can configure {% data variables.product.prodname_code_scanning %} for the repository.' miniTocMaxHeadingLevel: 4 versions: free-pro-team: '*' @@ -12,63 +12,66 @@ versions: {% data reusables.code-scanning.beta %} {% data reusables.code-scanning.enterprise-enable-code-scanning-actions %} +### About {% data variables.product.prodname_code_scanning %} configuration -### 关于 {% data variables.product.prodname_code_scanning %} 配置 +You can run {% data variables.product.prodname_code_scanning %} within {% data variables.product.product_location %}, using {% data variables.product.prodname_actions %}, or from your continuous integration (CI) system, using the {% data variables.product.prodname_codeql_runner %}. For more information about {% data variables.product.prodname_actions %}, see "[About {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)." For more information about the {% data variables.product.prodname_codeql_runner %}, see "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)." -You can run {% data variables.product.prodname_code_scanning %} within {% data variables.product.product_location %}, using {% data variables.product.prodname_actions %}, or from your continuous integration (CI) system, using the {% data variables.product.prodname_codeql_runner %}. 有关 {% data variables.product.prodname_actions %} 的更多信息，请参阅“[关于 {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)”。 For more information about the {% data variables.product.prodname_codeql_runner %}, see "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)." +This article is about running {% data variables.product.prodname_code_scanning %} within {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_ghe_server %}{% else %}{% data variables.product.prodname_dotcom %}{% endif %}. -以下查询套件内置于 {% data variables.product.prodname_code_scanning %}，可用于您的配置文件。 - -在为仓库配置 {% data variables.product.prodname_code_scanning %} 之前，必须将 {% data variables.product.prodname_actions %} 工作流程添加到仓库中以启用 {% data variables.product.prodname_code_scanning %}。 默认 {% data variables.product.prodname_code_scanning %} 工作流程使用 `on.push` 事件触发代码扫描 - 每次推送到任何包含工作流程文件的分支时触发。 +Before you can configure {% data variables.product.prodname_code_scanning %} for a repository, you must enable {% data variables.product.prodname_code_scanning %} by adding a {% data variables.product.prodname_actions %} workflow to the repository. For more information, see "[Enabling {% data variables.product.prodname_code_scanning %} for a repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository)." {% data reusables.code-scanning.edit-workflow %} -您可以为 {% data variables.product.prodname_code_scanning %} 编写配置文件。 {% data variables.product.prodname_marketplace %}{% if currentVersion ver_gt "enterprise-server@2.21" %} on {% data variables.product.prodname_dotcom_the_website %}{% endif %} contains other {% data variables.product.prodname_code_scanning %} workflows you can use. {% if currentVersion == "free-pro-team@latest" %}You can find a selection of these on the "Get started with {% data variables.product.prodname_code_scanning %}" page, which you can access from the **{% octicon "shield" aria-label="The shield symbol" %} Security** tab.{% endif %} The specific examples given in this article relate to the {% data variables.product.prodname_codeql_workflow %} file. +{% data variables.product.prodname_codeql %} analysis is just one type of {% data variables.product.prodname_code_scanning %} you can do in {% data variables.product.prodname_dotcom %}. {% data variables.product.prodname_marketplace %}{% if currentVersion ver_gt "enterprise-server@2.21" %} on {% data variables.product.prodname_dotcom_the_website %}{% endif %} contains other {% data variables.product.prodname_code_scanning %} workflows you can use. {% if currentVersion == "free-pro-team@latest" %}You can find a selection of these on the "Get started with {% data variables.product.prodname_code_scanning %}" page, which you can access from the **{% octicon "shield" aria-label="The shield symbol" %} Security** tab.{% endif %} The specific examples given in this article relate to the {% data variables.product.prodname_codeql_workflow %} file. -### Editing a code scanning workflow +### Editing a {% data variables.product.prodname_code_scanning %} workflow {% data variables.product.prodname_dotcom %} saves workflow files in the _.github/workflows_ directory of your repository. You can find a workflow you have enabled by searching for its file name. For example, by default, the workflow file for {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} is called _codeql-analysis.yml_. -1. 在仓库中，浏览至要编辑的工作流程文件。 -1. 要打开工作流程编辑器，在文件视图右上角单击 {% octicon "pencil" aria-label="The edit icon" %}。 ![编辑工作流程文件按钮](/assets/images/help/repository/code-scanning-edit-workflow-button.png) -1. After you have edited the file, click **Start commit** and complete the "Commit changes" form. You can choose to commit directly to the current branch, or create a new branch and start a pull request. ![Commit update to codeql.yml workflow](/assets/images/help/repository/code-scanning-workflow-update.png) +1. In your repository, browse to the workflow file you want to edit. +1. In the upper right corner of the file view, to open the workflow editor, click {% octicon "pencil" aria-label="The edit icon" %}. +![Edit workflow file button](/assets/images/help/repository/code-scanning-edit-workflow-button.png) +1. After you have edited the file, click **Start commit** and complete the "Commit changes" form. You can choose to commit directly to the current branch, or create a new branch and start a pull request. +![Commit update to codeql.yml workflow](/assets/images/help/repository/code-scanning-workflow-update.png) -有关编辑工作流程文件的更多信息，请参阅“[配置工作流程](/actions/configuring-and-managing-workflows/configuring-a-workflow)”。 +For more information about editing workflow files, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." -### 配置频率 +### Configuring frequency -您可以按时间表或在仓库中发生特定事件时扫描代码。 +You can configure the {% data variables.product.prodname_codeql_workflow %} to scan code on a schedule or when specific events occur in a repository. -每当推送到仓库以及每次创建拉取请求时，时扫描代码可防止开发者在代码中引入新的漏洞和错误。 按时间表扫描可了解 {% data variables.product.company_short %}、安全研究者和社区发现的最新漏洞和错误，即使开发者并未主动维护仓库。 +Scanning code when someone pushes a change, and whenever a pull request is created, prevents developers from introducing new vulnerabilities and errors into the code. Scanning code on a schedule informs you about the latest vulnerabilities and errors that {% data variables.product.company_short %}, security researchers, and the community discover, even when developers aren't actively maintaining the repository. -#### 按推送扫描 +#### Scanning on push -如果使用默认工作流程，则除了事件触发的扫描之外，{% data variables.product.prodname_code_scanning %} 还会每周扫描一次仓库代码。 要调整此时间表，请编辑工作流程中的 `cron` 值。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/reference/workflow-syntax-for-github-actions#on)”。 +By default, the {% data variables.product.prodname_codeql_workflow %} uses the `on.push` event to trigger a code scan on every push to the default branch of the repository and any protected branches. For {% data variables.product.prodname_code_scanning %} to be triggered on a specified branch, the workflow must exist in that branch. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#on)." -#### 扫描拉取请求 +#### Scanning pull requests -**注**：在 {% data variables.product.prodname_code_scanning %} 配置文件上下文中使用的 `paths` 和 `paths-ignore` 关键字，不应与用于 `on..paths` 的相同关键字相混淆。 当它们用于修改工作流程文件中的 `on.` 时，它们将决定在有人修改指定目录中的代码时是否运行操作。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)”。 +The default {% data variables.product.prodname_codeql_workflow %} uses the `pull_request` event to trigger a code scan on the `HEAD` commit of a pull request against the default branch. {% if currentVersion ver_gt "enterprise-server@2.21" %}The `pull_request` event is not triggered if the pull request was opened from a private fork.{% else %}If a pull request is from a private fork, the `pull_request` event will only be triggered if you've selected the "Run workflows from fork pull requests" option in the repository settings. For more information, see "[Disabling or limiting {% data variables.product.prodname_actions %} for a repository](/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository#enabling-workflows-for-private-repository-forks)."{% endif %} -有关 `pull_request` 事件的更多信息，请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)”。 +For more information about the `pull_request` event, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)." -#### 按时间表扫描 +#### Scanning on a schedule -默认 {% data variables.product.prodname_code_scanning %} 工作流程在拉取请求的 `HEAD` 提交时使用 `pull_request` 事件触发代码扫描。 要调整此时间表，请编辑工作流程中的 `cron` 值。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/reference/workflow-syntax-for-github-actions#onschedule)”。 +If you use the default {% data variables.product.prodname_codeql_workflow %}, the workflow will scan the code in your repository once a week, in addition to the scans triggered by events. To adjust this schedule, edit the `cron` value in the workflow. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onschedule)." {% note %} -**注**：{% data variables.product.prodname_dotcom %} 只运行默认分支上工作流程中的预定作业。 在任何其他分支上的工作流程中更改时间表后，需要将该分支合并到默认分支才能使更改生效。 +**Note**: {% data variables.product.prodname_dotcom %} only runs scheduled jobs that are in workflows on the default branch. Changing the schedule in a workflow on any other branch has no effect until you merge the branch into the default branch. {% endnote %} -#### 示例 +#### Example -{% data variables.product.prodname_dotcom %} saves workflow files in the `.github/workflows` directory of your repository. You can find the workflow by searching for its file name. For example, the default workflow file for CodeQL code scanning is called `codeql-analysis.yml`. +The following example shows a {% data variables.product.prodname_codeql_workflow %} for a particular repository that has a default branch called `main` and one protected branch called `protected`. ``` yaml on: push: + branches: [main, protected] pull_request: + branches: [main] schedule: - cron: '0 15 * * 0' ``` @@ -78,9 +81,11 @@ This workflow scans: * Every pull request to the default branch * The default branch at 3 P.M. every Sunday -### 指定操作系统 +### Specifying an operating system + +If your code requires a specific operating system to compile, you can configure the operating system in your {% data variables.product.prodname_codeql_workflow %}. Edit the value of `jobs.analyze.runs-on` to specify the operating system for the machine that runs your {% data variables.product.prodname_code_scanning %} actions. {% if currentVersion ver_gt "enterprise-server@2.21" %}You specify the operating system by using an appropriate label as the second element in a two-element array, after `self-hosted`.{% else %} -如果您的代码需要使用特定的操作系统进行编译，您可以在工作流程中配置它。 编辑 `jobs..runs-on` 的值以指定运行 {% data variables.product.prodname_code_scanning %} 操作的机器操作系统。 {% if currentVersion ver_gt "enterprise-server@2.21" %}You specify the operating system by using an appropriate label as the second element in a two-element array, after `self-hosted`. +If you choose to use a self-hosted runner for code scanning, you can specify an operating system by using an appropriate label as the second element in a two-element array, after `self-hosted`.{% endif %} ``` yaml jobs: @@ -88,59 +93,122 @@ jobs: name: Analyze runs-on: [self-hosted, ubuntu-latest] ``` -{% endif %} -{% data variables.product.prodname_code_scanning_capc %} 支持 macOS、Ubuntu 和 Windows 的最新版本。 Typical values for this setting are therefore: `ubuntu-latest`, `windows-latest`, and `macos-latest`. For more information, see {% if currentVersion ver_gt "enterprise-server@2.21" %}"[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#self-hosted-runners)" and "[Using labels with self-hosted runners](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners){% else %}"[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on){% endif %}." +{% if currentVersion == "free-pro-team@latest" %}For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners)" and "[Adding self-hosted runners](/actions/hosting-your-own-runners/adding-self-hosted-runners)."{% endif %} + +{% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} supports the latest versions of Ubuntu, Windows, and macOS. Typical values for this setting are therefore: `ubuntu-latest`, `windows-latest`, and `macos-latest`. For more information, see {% if currentVersion ver_gt "enterprise-server@2.21" %}"[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#self-hosted-runners)" and "[Using labels with self-hosted runners](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners){% else %}"[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on){% endif %}." -### 覆盖自动语言检测 +{% if currentVersion ver_gt "enterprise-server@2.21" %}You must ensure that Git is in the PATH variable on your self-hosted runners.{% else %}If you use a self-hosted runner, you must ensure that Git is in the PATH variable.{% endif %} -{% data reusables.code-scanning.autobuild-add-build-steps %} For more information about how to configure {% data variables.product.prodname_code_scanning %} for compiled languages, see "[Configuring {% data variables.product.prodname_code_scanning %} for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages)." +### Changing the languages that are analyzed + +{% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} automatically detects code written in the supported languages. {% data reusables.code-scanning.supported-languages %} +The default {% data variables.product.prodname_codeql_workflow %} file contains a build matrix called `language` which lists the languages in your repository that are analyzed. {% data variables.product.prodname_codeql %} automatically populates this matrix when you add {% data variables.product.prodname_code_scanning %} to a repository. Using the `language` matrix optimizes {% data variables.product.prodname_codeql %} to run each analysis in parallel. We recommend that all workflows adopt this configuration due to the performance benefits of parallelizing builds. For more information about build matrices, see "[Managing complex workflows](/actions/learn-github-actions/managing-complex-workflows#using-a-build-matrix)." + {% data reusables.code-scanning.specify-language-to-analyze %} -要覆盖自动语言检测，请将 `with:languages:` 添加到工作流程中的 `init` 操作。 受支持语言的关键字是 `cpp`、`csharp`、`go`、`java`、`javascript` 和 `python`。 +If your workflow uses the `language` matrix then {% data variables.product.prodname_codeql %} is hardcoded to analyze only the languages in the matrix. To change the languages you want to analyze, edit the value of the matrix variable. You can remove a language to prevent it being analyzed or you can add a language that was not present in the repository when {% data variables.product.prodname_code_scanning %} was enabled. For example, if the repository initially only contained JavaScript when {% data variables.product.prodname_code_scanning %} was enabled, and you later added Python code, you will need to add `python` to the matrix. -例如，以下配置可将 {% data variables.product.prodname_code_scanning %} 限制到 C/C++、C# 和 Python。 +```yaml +jobs: + analyze: + name: Analyze + ... + strategy: + fail-fast: false + matrix: + language: ['javascript', 'python'] +``` + +If your workflow does not contain a matrix called `language`, then {% data variables.product.prodname_codeql %} is configured to run analysis sequentially. If you don't specify languages in the workflow, {% data variables.product.prodname_codeql %} automatically detects, and attempts to analyze, any supported languages in the repository. If you want to choose which languages to analyze, without using a matrix, you can use the `languages` parameter under the `init` action. -``` yaml +```yaml - uses: github/codeql-action/init@v1 with: languages: cpp, csharp, python -``` +``` +{% if currentVersion == "free-pro-team@latest" %} +### Analyzing Python dependencies -### 运行额外查询 +For GitHub-hosted runners that use Linux only, the {% data variables.product.prodname_codeql_workflow %} will try to auto-install Python dependencies to give more results for the CodeQL analysis. You can control this behavior by specifying the `setup-python-dependencies` parameter for the action called by the "Initialize CodeQL" step. By default, this parameter is set to `true`: + +- If the repository contains code written in Python, the "Initialize CodeQL" step installs the necessary dependencies on the GitHub-hosted runner. If the auto-install succeeds, the action also sets the environment variable `CODEQL_PYTHON` to the Python executable file that includes the dependencies. + +- If the repository doesn't have any Python dependencies, or the dependencies are specified in an unexpected way, you'll get a warning and the action will continue with the remaining jobs. The action can run successfully even when there are problems interpreting dependencies, but the results may be incomplete. + +Alternatively, you can install Python dependencies manually on any operating system. You will need to add `setup-python-dependencies` and set it to `false`, as well as set `CODEQL_PYTHON` to the Python executable that includes the dependencies, as shown in this workflow extract: + +```yaml +jobs: + CodeQL-Build: + + runs-on: ubuntu-latest + + steps: + - name: Checkout repository + uses: actions/checkout@v2 + with: + fetch-depth: 2 + - name: Set up Python + uses: actions/setup-python@v2 + with: + python-version: '3.x' + - name: Install dependencies + run: | + python -m pip install --upgrade pip + if [ -f requirements.txt ]; + then pip install -r requirements.txt; + fi + # Set the `CODEQL-PYTHON` environment variable to the Python executable + # that includes the dependencies + echo "::set-env name=CODEQL_PYTHON::$(which python)" + - run: git checkout HEAD^2 + if: ${{ github.event_name == 'pull_request' }} + - name: Initialize CodeQL + uses: github/codeql-action/init@v1 + with: + languages: python + # Override the default behavior so that the action doesn't attempt + # to auto-install Python dependencies + setup-python-dependencies: false +``` +{% endif %} + +### Running additional queries {% data reusables.code-scanning.run-additional-queries %} -要添加一个或多个查询套件，请在配置文件中添加 `queries` 部分。 +To add one or more queries, add a `with: queries:` entry within the `uses: github/codeql-action/init@v1` section of the workflow. ``` yaml - uses: github/codeql-action/init@v1 with: - - queries: COMMA-SEPARATED LIST OF PATHS + queries: COMMA-SEPARATED LIST OF PATHS ``` -您也可以在配置文件中指定额外查询套件以运行它们。 查询套件是查询的集合，通常按目的或语言分组。 +You can also specify query suites in the value of `queries`. Query suites are collections of queries, usually grouped by purpose or language. {% data reusables.code-scanning.codeql-query-suites %} -If you are also using a configuration file for custom settings, any additional queries specified in your workflow are used instead of any specified in the configuration file. If you want to run the combined set of additional queries specified here and in the configuration file, prefix the value of `queries` in the workflow with the `+` symbol. 有关配置文件的示例，请参阅“[配置文件示例](#example-configuration-files)”。 +If you are also using a configuration file for custom settings, any additional queries specified in your workflow are used instead of any specified in the configuration file. If you want to run the combined set of additional queries specified here and in the configuration file, prefix the value of `queries` in the workflow with the `+` symbol. For more information, see "[Using a custom configuration file](#using-a-custom-configuration-file)." In the following example, the `+` symbol ensures that the specified additional queries are used together with any queries specified in the referenced configuration file. ``` yaml -queries: - - name: DESCRIPTION OF YOUR CHOICE - uses: PATH +- uses: github/codeql-action/init@v1 + with: + config-file: ./.github/codeql/codeql-config.yml + queries: +security-and-quality,octo-org/python-qlpack/show_ifs.ql@main ``` -### 使用第三方代码扫描工具 +### Using a custom configuration file As an alternative to specifying which queries to run in the workflow file, you can do this in a separate configuration file. You can also use a configuration file to disable the default queries and to specify which directories to scan during analysis. -In the workflow file, use the `config-file` parameter of the `init` action to specify the path to the configuration file you want to use. 此示例加载配置文件 _./.github/codeql/codeql-config.yml_。 +In the workflow file, use the `config-file` parameter of the `init` action to specify the path to the configuration file you want to use. This example loads the configuration file _./.github/codeql/codeql-config.yml_. ``` yaml - uses: github/codeql-action/init@v1 @@ -149,7 +217,7 @@ In the workflow file, use the `config-file` parameter of the `init` action to sp ``` The configuration file can be located within the local repository, or in a public, remote repository. For remote repositories, you can use the _owner/repository/file.yml@branch_ syntax. The settings in the file are written in YAML format. - + #### Specifying additional queries You specify additional queries in a `queries` array. Each element of the array contains a `uses` parameter with a value that identifies a single query file, a directory containing query files, or a query suite definition file. @@ -165,11 +233,11 @@ Optionally, you can give each array element a name, as shown in the example conf For more information about additional queries, see "[Running additional queries](#running-additional-queries)" above. -#### 禁用默认查询 +#### Disabling the default queries -如果只想运行自定义查询，您可以通过在配置文件中添加 `disable-default-queries: true` 来禁用默认安全查询。 +If you only want to run custom queries, you can disable the default security queries by using `disable-default-queries: true`. -#### 指定要扫描的目录 +#### Specifying directories to scan For the interpreted languages that {% data variables.product.prodname_codeql %} supports (Python and JavaScript/TypeScript), you can restrict {% data variables.product.prodname_code_scanning %} to files in specific directories by adding a `paths` array to the configuration file. You can exclude the files in specific directories from scans by adding a `paths-ignore` array. @@ -183,37 +251,37 @@ paths-ignore: {% note %} -**注**： +**Note**: -* The `paths` and `paths-ignore` keywords, used in the context of the {% data variables.product.prodname_code_scanning %} configuration file, should not be confused with the same keywords when used for `on..paths` in a workflow. When they are used to modify `on.` in a workflow, they determine whether the actions will be run when someone modifies code in the specified directories. 更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)”。 +* The `paths` and `paths-ignore` keywords, used in the context of the {% data variables.product.prodname_code_scanning %} configuration file, should not be confused with the same keywords when used for `on..paths` in a workflow. When they are used to modify `on.` in a workflow, they determine whether the actions will be run when someone modifies code in the specified directories. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)." * `**` characters can only be at the start or end of a line, or surrounded by slashes, and you can't mix `**` and other characters. For example, `foo/**`, `**/foo`, and `foo/**/bar` are all allowed syntax, but `**foo` isn't. However you can use single stars along with other characters, as shown in the example. You'll need to quote anything that contains a `*` character. {% endnote %} -对于 C/C++、C# 和 Java，如果要将 {% data variables.product.prodname_code_scanning %} 限制到项目中的特定目录，您必须在工作流程中指定适当的构建步骤。 用于在构建过程中排除目录的命令将取决于您的构建系统。 For more information, see "[Configuring the {% data variables.product.prodname_codeql %} action for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages#adding-build-steps-for-a-compiled-language)." +For C/C++, C#, and Java, if you want to limit {% data variables.product.prodname_code_scanning %} to specific directories in your project, you must specify appropriate build steps in the workflow. The commands you need to use to exclude a directory from the build will depend on your build system. For more information, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." -在修改特定目录中的代码时，您可以快速分析单个仓库中的小部分。 您需要在构建步骤中排除目录并在工作流程文件中对 [`on.`](https://help.github.com/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths) 使用 `paths-ignore` 和 `paths` 关键字。 +You can quickly analyze small portions of a monorepo when you modify code in specific directories. You'll need to both exclude directories in your build steps and use the `paths-ignore` and `paths` keywords for [`on.`](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths) in your workflow. -#### 配置文件示例 +#### Example configuration files {% data reusables.code-scanning.example-configuration-files %} ### Configuring {% data variables.product.prodname_code_scanning %} for compiled languages -{% data reusables.code-scanning.autobuild-compiled-languages %} +{% data reusables.code-scanning.autobuild-compiled-languages %} {% data reusables.code-scanning.analyze-go %} -{% data reusables.code-scanning.autobuild-add-build-steps %} For more information about how to configure {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} for compiled languages, see "[Configuring the {% data variables.product.prodname_codeql %} action for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages)." +{% data reusables.code-scanning.autobuild-add-build-steps %} For more information about how to configure {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} for compiled languages, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages)." -### 访问私有仓库 +### Accessing private repositories -如果 {% data variables.product.prodname_code_scanning %} 的工作流程访问 {% data variables.product.prodname_dotcom %} 上的私有仓库，您需要将 Git 配置为使用个人访问令牌进行身份验证。 在执行任何 {% data variables.product.prodname_codeql %} 操作之前，请使用工作流程中的 `jobs..steps.env` 定义运行环境中的密码。 更多信息请参阅“[创建用于命令行的个人访问令牌](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)”和“[创建和存储加密密码](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)”。 +If your workflow for {% data variables.product.prodname_code_scanning %} accesses a private repository, other than the repository that contains the workflow, you'll need to configure Git to authenticate with a personal access token. Define the secret in the runner environment by using `jobs..steps.env` in your workflow before any {% data variables.product.prodname_codeql %} actions. For more information, see "[Creating a personal access token for the command line](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)" and "[Creating and storing encrypted secrets](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)." -例如，以下 Git 配置将 {% data variables.product.prodname_dotcom_the_website %} 上 `github/foo`、`github/bar` 和 `github/baz` 仓库的完整 URL替换为包含您存储在 `ACCESS_TOKEN` 环境变量中的个人访问令牌的 URL。 +For example, the following configuration has Git replace the full URLs to the `github/foo`, `github/bar`, and `github/baz` repositories on {% data variables.product.prodname_dotcom_the_website %} with URLs that include the personal access token that you store in the `ACCESS_TOKEN` environment variable. {% raw %} ```yaml steps: -- name: Configure access to private repository on GitHub.com +- name: Configure access to private repositories env: TOKEN: ${{ secrets.ACCESS_TOKEN }} run: | @@ -225,4 +293,4 @@ steps: ### Uploading {% data variables.product.prodname_code_scanning %} data to {% data variables.product.prodname_dotcom %} -{% data variables.product.prodname_dotcom %} can display code analysis data generated externally by a third-party tool. 通过在工作流程中添加 `upload-sarif` 操作，您可以在 {% data variables.product.prodname_dotcom %} 中显示第三方工具的代码分析。 更多信息请参阅“[将 SARIF 文件上传到 GitHub](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)”。 +{% data variables.product.prodname_dotcom %} can display code analysis data generated externally by a third-party tool. You can upload code analysis data with the `upload-sarif` action. For more information, see "[Uploading a SARIF file to GitHub](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)." diff --git a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md new file mode 100644 index 000000000000..c5c73938eda8 --- /dev/null +++ b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system.md @@ -0,0 +1,166 @@ +--- +title: Configuring CodeQL code scanning in your CI system +shortTitle: 在 CI 中配置 +intro: '您可以配置 {% data variables.product.prodname_codeql_runner %} 如何扫描项目中的代码并将结果上传到 {% data variables.product.prodname_dotcom %}。' +product: '{% data reusables.gated-features.code-scanning %}' +miniTocMaxHeadingLevel: 4 +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-in-your-ci-system +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta-codeql-runner %} +{% data reusables.code-scanning.beta %} +{% data reusables.code-scanning.enterprise-enable-code-scanning %} + +### About configuring {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in your CI system + +要将 {% data variables.product.prodname_code_scanning %} 集成到 CI 系统中，您可以使用 {% data variables.product.prodname_codeql_runner %}。 For more information, see "[Running {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)." + +一般情况下，调用 {% data variables.product.prodname_codeql_runner %} 如下所示。 + +``` +$ /path/to-runner/codeql-runner-OS +``` + +`/path/to-runner/` 取决于您在 CI 系统上保存 {% data variables.product.prodname_codeql_runner %} 的位置。 `codeql-runner-OS` 取决于您使用的操作系统。 +{% data variables.product.prodname_codeql_runner %} 有三个版本：`codeql-runner-linux`、`codeql-runner-macos` 和 `codeql-runner-win`，分别用于 Linux、macOS 和 Windows 系统。 + +要自定义 {% data variables.product.prodname_codeql_runner %} 扫描代码的方式，您可以使用 `--languages` 和 `--queries` 等标志，也可以在单独的配置文件中指定自定义设置。 + +### 覆盖自动语言检测 + +{% data variables.product.prodname_codeql_runner %} 自动检测并扫描用支持的语言编写的代码。 + +{% data reusables.code-scanning.supported-languages %} + +{% data reusables.code-scanning.specify-language-to-analyze %} + +要覆盖自动语言检测，请运行 `init` 命令：带 `--languages` 标志，后跟以逗号分隔的语言关键字列表。 受支持语言的关键字是 `cpp`、`csharp`、`go`、`java`、`javascript` 和 `python`。 + +``` +$ /path/to-runner/codeql-runner-linux init --languages cpp,java +``` + +### 运行额外查询 + +{% data reusables.code-scanning.run-additional-queries %} + +{% data reusables.code-scanning.codeql-query-suites %} + +要添加一个或多个查询，请将逗号分隔的路径列表传递给 `init` 命令的 `--queries` 标志。 您也可以在配置文件中指定额外查询。 + +如果您还使用配置文件进行自定义设置，并且还使用 `--queries` 标志指定额外查询，则 {% data variables.product.prodname_codeql_runner %} 将使用 `--queries` 标志指定的额外查询，而不是配置文件中的任何查询。 如果您要运行使用标志指定的额外查询与配置文件中指定的查询的组合，请在传递给 `--queries` 的值之前加上前缀 `+` 符号。 有关配置文件的示例，请参阅“[配置文件示例](#example-configuration-files)”。 + +在下面的示例中，`+` 符号可确保 {% data variables.product.prodname_codeql_runner %} 结合使用额外查询与所引用配置文件中指定的任何查询。 + +``` +$ /path/to-runner/codeql-runner-linux init --config-file .github/codeql/codeql-config.yml + --queries +security-and-quality,octo-org/python-qlpack/show_ifs.ql@main +``` + +### 使用第三方代码扫描工具 + +您可以在单独的配置文件中指定自定义设置，而不向 {% data variables.product.prodname_codeql_runner %} 命令传递额外信息。 + +配置文件为 YAML 文件。 它使用的语法类似于 {% data variables.product.prodname_actions %} 的工作流程语法，如下例所示。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/reference/workflow-syntax-for-github-actions)”。 + +使用 `init` 命令的 `--config-file` 标志指定配置文件。 标志 `--config-file` 的值是您要使用的配置文件的路径。 此示例加载配置文件 _.github/codeql/codeql-config.yml_。 + +``` +$ /path/to-runner/codeql-runner-linux init --config-file .github/codeql/codeql-config.yml +``` + +#### 配置文件示例 + +{% data reusables.code-scanning.example-configuration-files %} + +### 为编译语言配置 {% data variables.product.prodname_code_scanning %} + +对于编译语言 C/C++、C# 和 Java，{% data variables.product.prodname_codeql %} 在分析之前构建代码。 {% data reusables.code-scanning.analyze-go %} + +对于许多常见的构建系统，{% data variables.product.prodname_codeql_runner %} 可以自动构建代码。 要尝试自动构建代码，请在 `init` 与 `analyze` 步骤之间运行 `autobuild`。 请注意，如果您的仓库需要特定版本的构建工具，您可能需要先手动安装该构建工具。 + +`autobuild` 进程仅尝试为仓库构建_一种_编译语言。 自动选择用于分析的语言是涵盖文件最多的语言。 如果您要明确选择某种语言，请使用 `autobuild` 命令的 `--language` 标志。 + +``` +$ /path/to-runner/codeql-runner-linux autobuild --language csharp +``` + +如果 `autobuild` 命令无法构建您的代码，您可以在 `init` 与 `analyze` 步骤之间手动运行构建步骤。 For more information, see "[Running {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system#compiled-language-example)." + +### 将 {% data variables.product.prodname_code_scanning %} 数据上传到 {% data variables.product.prodname_dotcom %} + +默认情况下，当您运行 `analyze` 命令时，{% data variables.product.prodname_codeql_runner %} 上传来自 {% data variables.product.prodname_code_scanning %} 的结果。 您也可以使用 `upload` 命令单独上传 SARIF 文件。 + +上传数据后，{% data variables.product.prodname_dotcom %} 将在您的仓库中显示警报。 For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository#viewing-an-alert)." + +### {% data variables.product.prodname_codeql_runner %} 命令引用 + +{% data variables.product.prodname_codeql_runner %} 支持以下命令和标志。 + +#### `init` + +为每种要分析的语言初始化 {% data variables.product.prodname_codeql_runner %} 并创建 {% data variables.product.prodname_codeql %} 数据库。 + +| 标志 | 必选 | 输入值 | +| -------------------------------- |:--:| ----------------------------------------------------------------------------------------------------------------------------------- | +| `--repository` | ✓ | 要初始化的仓库名称。 | +| `--github-url` | ✓ | 托管仓库的 {% data variables.product.prodname_dotcom %} 实例的 URL。 | +| `--github-auth` | ✓ | {% data variables.product.prodname_github_apps %} 令牌或个人访问令牌。 | +| `--languages` | | 要分析的语言列表，以逗号分隔。 默认情况下，{% data variables.product.prodname_codeql_runner %} 检测和分析仓库中所有支持的语言。 | +| `--queries` | | 除了默认的安全查询套件之外，要运行的额外查询列表，以逗号分隔。 | +| `--config-file` | | 自定义配置文件的路径。 | +| `--codeql-path` | | 要使用的 {% data variables.product.prodname_codeql %} CLI 可执行文件副本的路径。 默认情况下，{% data variables.product.prodname_codeql_runner %} 下载副本。 | +| `--temp-dir` | | 存储临时文件的目录。 默认值为 _./codeql-runner_。 | +| `--tools-dir` | | 在运行之间存储 {% data variables.product.prodname_codeql %} 工具和其他文件的目录。 默认值为主目录的子目录。 | +| `--checkout-path` | | 检出仓库的路径。 默认值为当前工作目录。 | +| `--debug` | | 无. 打印更详细的输出。 | +| `-h`, `--help` | | 无. 显示命令的帮助。 | + +#### `autobuild` + +尝试为编译语言 C/C++、C# 和 Java 构建代码。 对于这些语言，{% data variables.product.prodname_codeql %} 在分析之前构建代码。 在 `init` 与 `analyze` 步骤之间运行 `autobuild`。 + +| 标志 | 必选 | 输入值 | +| --------------------------- |:--:| ---------------------------------------------------------------------------------- | +| `--language` | | 要构建的语言。 默认情况下，{% data variables.product.prodname_codeql_runner %} 构建涵盖最多文件的编译语言。 | +| `--temp-dir` | | 存储临时文件的目录。 默认值为 _./codeql-runner_。 | +| `--debug` | | 无. 打印更详细的输出。 | +| `-h`, `--help` | | 无. 显示命令的帮助。 | + +#### `analyze` + +分析 {% data variables.product.prodname_codeql %} 数据库中的代码并将结果上传到 {% data variables.product.product_location %}。 + +| 标志 | 必选 | 输入值 | +| -------------------------------- |:--:| --------------------------------------------------------------------------------------------------------------------------------- | +| `--repository` | ✓ | 要分析的仓库名称。 | +| `--commit` | ✓ | 要分析的提交的 SHA。 在 Git 和 Azure DevOps 中，这对应于 `git rev-parse HEAD` 的值。 在 Jenkins 中，这对应于 `$GIT_COMMIT`。 | +| `--ref` | ✓ | 要分析的引用的名称，例如 `refs/heads/main`。 在 Git 和 Jenkins 中，这对应于 `git symbolic-ref HEAD` 的值。 在 Azure DevOps 中，这对应于 `$(Build.SourceBranch)`。 | +| `--github-url` | ✓ | 托管仓库的 {% data variables.product.prodname_dotcom %} 实例的 URL。 | +| `--github-auth` | ✓ | {% data variables.product.prodname_github_apps %} 令牌或个人访问令牌。 | +| `--checkout-path` | | 检出仓库的路径。 默认值为当前工作目录。 | +| `--no-upload` | | 无. 阻止 {% data variables.product.prodname_codeql_runner %} 将结果上传到 {% data variables.product.product_location %}。 | +| `--output-dir` | | 存储输出 SARIF 文件的目录。 默认在临时文件目录中。 | +| `--temp-dir` | | 存储临时文件的目录。 默认值为 _./codeql-runner_。 | +| `--debug` | | 无. 打印更详细的输出。 | +| `-h`, `--help` | | 无. 显示命令的帮助。 | + +#### `上传` + +将 SARIF 文件上传到 {% data variables.product.product_location %}。 + +| 标志 | 必选 | 输入值 | +| -------------------------------- |:--:| --------------------------------------------------------------------------------------------------------------------------------- | +| `--sarif-file` | ✓ | 要上传的 SARIF 文件，或包含多个 SARIF 文件的目录。 | +| `--repository` | ✓ | 已分析的仓库名称。 | +| `--commit` | ✓ | 已分析的提交的 SHA。 在 Git 和 Azure DevOps 中，这对应于 `git rev-parse HEAD` 的值。 在 Jenkins 中，这对应于 `$GIT_COMMIT`。 | +| `--ref` | ✓ | 已分析的引用的名称，例如 `refs/heads/main`。 在 Git 和 Jenkins 中，这对应于 `git symbolic-ref HEAD` 的值。 在 Azure DevOps 中，这对应于 `$(Build.SourceBranch)`。 | +| `--github-url` | ✓ | 托管仓库的 {% data variables.product.prodname_dotcom %} 实例的 URL。 | +| `--github-auth` | ✓ | {% data variables.product.prodname_github_apps %} 令牌或个人访问令牌。 | +| `--checkout-path` | | 检出仓库的路径。 默认值为当前工作目录。 | +| `--debug` | | 无. 打印更详细的输出。 | +| `-h`, `--help` | | 无. 显示命令的帮助。 | diff --git a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md new file mode 100644 index 000000000000..1a16bfd67135 --- /dev/null +++ b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages.md @@ -0,0 +1,116 @@ +--- +title: 为编译语言配置 CodeQL 工作流程 +shortTitle: 为编译语言配置 +intro: '您可以配置 {% data variables.product.prodname_dotcom %} 如何使用 {% data variables.product.prodname_codeql_workflow %} 扫描用编译语言编写的代码以查找漏洞和错误。' +product: '{% data reusables.gated-features.code-scanning %}' +permissions: '拥有仓库写入权限的人可配置仓库的 {% data variables.product.prodname_code_scanning %}。' +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages + - /github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta %} +{% data reusables.code-scanning.enterprise-enable-code-scanning-actions %} + +### 关于 {% data variables.product.prodname_codeql_workflow %} 和编译语言 + +To enable {% data variables.product.prodname_code_scanning %} for your repository, you add to the repository a {% data variables.product.prodname_actions %} workflow which includes {% data variables.product.prodname_codeql %} analysis. 更多信息请参阅“[启用 {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning)”。 对于 {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %}，您可以添加 {% data variables.product.prodname_codeql_workflow %}。 默认 {% data variables.product.prodname_code_scanning %} 工作流程使用 `on.push` 事件触发代码扫描 - 每次推送到任何包含工作流程文件的分支时触发。 + +{% data reusables.code-scanning.edit-workflow %} +For general information about configuring +{% data variables.product.prodname_code_scanning %} and editing workflow files, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" and "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." + +### 关于 {% data variables.product.prodname_codeql %} 的自动构建 + +代码扫描的工作方式是对一个或多个数据库运行查询。 每个数据库都包含仓库中所有代码的单一语言表示形式。 对于编译语言 C/C++、C# 和 Java，填充此数据库的过程涉及构建代码和提取数据。 {% data reusables.code-scanning.analyze-go %} + +{% data reusables.code-scanning.autobuild-compiled-languages %} + +如果您的工作流程使用 `language` 矩阵，`autobuild` 将尝试构建矩阵中列出的每种编译语言。 如果不使用矩阵，`autobuild` 将尝试构建涵盖仓库中最多源文件的受支持编译语言。 除 Go 以外，除非您提供明确的构建命令，否则您仓库中其他编译语言的分析将失败。 + +{% note %} + +**注**：如果使用 {% data variables.product.prodname_actions %} 的自托管运行器，您可能需要安装其他软件才能使用 `autobuild` 进程。 此外，如果您的仓库需要特定版本的构建工具，您可能需要手动安装它。 更多信息请参阅“[{% data variables.product.prodname_dotcom %} 托管运行器的规范](/actions/reference/specifications-for-github-hosted-runners/#supported-software)”。 + +{% endnote %} + +#### C/C++ + +| 支持的系统类型 | 系统名称 | +| ------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | +| 操作系统 | Windows, macOS, and Linux | +| 构建系统 | Windows: MSbuild and build scripts
    Linux and macOS: Autoconf, Make, CMake, qmake, Meson, Waf, SCons, Linux Kbuild, and build scripts | + +`autobuild` 步骤的行为因提取运行所在的操作系统而异。 On Windows, the `autobuild` step attempts to autodetect a suitable build method for C/C++ using the following approach: + +1. Invoke `MSBuild.exe` on the solution (`.sln`) or project (`.vcxproj`) file closest to the root. 如果 `autobuild` 在顶层目录下的相同深度（最短）检测到多个解决方案或项目文件，它将尝试构建所有这些文件。 +2. Invoke a script that looks like a build script—_build.bat_, _build.cmd_, _and build.exe_ (in that order). + +On Linux and macOS, the `autobuild` step reviews the files present in the repository to determine the build system used: + +1. 在根目录中查找构建系统。 +2. 如果未找到，则搜索子目录以查找含有 C/C++ 构建系统的唯一目录。 +3. 运行适当的命令来配置系统。 + +#### C + +| 支持的系统类型 | 系统名称 | +| ------- | --------------------- | +| 操作系统 | Windows 和 Linux | +| 构建系统 | .NET 和 MSbuild，以及构建脚本 | + +`autobuild` 进程尝试使用以下方法自动检测合适的 C# 构建方法： + +1. 在最接近根目录的解决方案 (`.sln`) 或项目 (`.csproj`) 文件上调用 `dotnet build`。 +2. 在最接近根目录的解决方案或项目文件上调用 `MSbuild` (Linux) 或 `MSBuild.exe` (Windows)。 如果 `autobuild` 在顶层目录下的相同深度（最短）检测到多个解决方案或项目文件，它将尝试构建所有这些文件。 +3. 调用一个看起来像构建脚本的脚本—_build_ 和 _build.sh_（对于 Linux，按此顺序）或 _build.bat_、_build.cmd_ 和 _build.exe_（对于 Windows，按此顺序）。 + +#### Java + +| 支持的系统类型 | 系统名称 | +| ------- | ------------------------------------------ | +| 操作系统 | Windows, macOS, and Linux (no restriction) | +| 构建系统 | Gradle、Maven 和 Ant | + +`autobuild` 进程尝试通过应用此策略来确定 Java 代码库的构建系统： + +1. 在根目录中搜索构建文件。 先后检查 Gradle、Maven 和 Ant 构建文件。 +2. 运行找到的第一个构建文件。 如果 Gradle 和 Maven 文件都存在，则使用 Gradle 文件。 +3. 否则，在根目录的直接子目录中搜索构建文件。 如果只有一个子目录包含构建文件，则运行该子目录中标识的第一个文件（使用与 1 相同的首选项）。 如果多个子目录包含构建文件，则报告错误。 + +### 添加编译语言的构建步骤 + +{% data reusables.code-scanning.autobuild-add-build-steps %} 有关如何编辑工作流程文件的更多信息，请参阅“[配置 {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)”。 + +删除 `autobuild` 步骤后，请取消注释 `run` 步骤并添加适合您仓库的构建命令。 工作流程 `run` 步骤使用操作系统的 shell 运行命令行程序。 您可以修改这些命令并添加更多命令来自定义构建过程。 + +``` yaml +- run: | + make bootstrap + make release +``` + +有关 `run` 关键词的更多信息，请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)”。 + +如果仓库中包含多种编译语言，您可以指定特定于语言的构建命令。 例如，如果您的仓库包含 C/C++、C# 和 Java，并且 `autobuild` 正确地构建了 C/C++ 和 C#，但未能构建 Java，您可以在 `init` 步骤之后的工作流程中使用以下配置。 这将指定 Java 的构建步骤，而对 C/C++ 和 C# 仍然使用 `autobuild`： + +```yaml +- if: matrix.language == 'cpp' || matrix.language == 'csharp' + name: Autobuild + uses: github/codeql-action/autobuild@v1 + +- if: matrix.language == 'java' + name: Build Java + run: | + make bootstrap + make release +``` + +有关 `if` 条件的更多信息，请参阅“[GitHub 操作的工作流程语法](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsif)”。 + +有关为什么 `autobuild` 无法构建代码的更多提示和技巧，请参阅“[{% data variables.product.prodname_codeql %} 工作流程疑难解答](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow)”。 + +如果您为编译语言添加了手动构建步骤，但 {% data variables.product.prodname_code_scanning %} 仍然无法处理您的仓库，请联系 {% data variables.contact.contact_support %}。 diff --git a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md index 14a835f18f1a..f4cabb2462b7 100644 --- a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md +++ b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository.md @@ -27,23 +27,91 @@ You decide how you generate {% data variables.product.prodname_code_scanning %} {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-security %} -3. To the right of "Code scanning", click **Set up code scanning**. - !["Set up code scanning" button to the right of "Code scanning" in the Security Overview](/assets/images/help/security/overview-set-up-code-scanning.png) -4. Under "Get started with code scanning", click **Set up this workflow** on the {% data variables.product.prodname_codeql_workflow %} or on a third-party workflow. - !["Set up this workflow" button under "Get started with code scanning" heading](/assets/images/help/repository/code-scanning-set-up-this-workflow.png) -5. Optionally, to customize how {% data variables.product.prodname_code_scanning %} scans your code, edit the workflow. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." +3. To the right of "{% data variables.product.prodname_code_scanning_capc %}", click **Set up {% data variables.product.prodname_code_scanning %}**. + !["Set up {% data variables.product.prodname_code_scanning %}" button to the right of "{% data variables.product.prodname_code_scanning_capc %}" in the Security Overview](/assets/images/help/security/overview-set-up-code-scanning.png) +4. Under "Get started with {% data variables.product.prodname_code_scanning %}", click **Set up this workflow** on the {% data variables.product.prodname_codeql_workflow %} or on a third-party workflow. + !["Set up this workflow" button under "Get started with {% data variables.product.prodname_code_scanning %}" heading](/assets/images/help/repository/code-scanning-set-up-this-workflow.png) +5. To customize how {% data variables.product.prodname_code_scanning %} scans your code, edit the workflow. + + Generally you can commit the {% data variables.product.prodname_codeql_workflow %} without making any changes to it. However, many of the third-party workflows require additional configuration, so read the comments in the workflow before committing. + + For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." 6. Use the **Start commit** drop-down, and type a commit message. ![Start commit](/assets/images/help/repository/start-commit-commit-new-file.png) 7. Choose whether you'd like to commit directly to the default branch, or create a new branch and start a pull request. ![Choose where to commit](/assets/images/help/repository/start-commit-choose-where-to-commit.png) 8. Click **Commit new file** or **Propose new file**. -After you commit the workflow file or create a pull request, {% data variables.product.prodname_code_scanning %} will analyze your code according to the frequency you specified in your workflow file. If you created a pull request, {% data variables.product.prodname_code_scanning %} will only analyze the code on the pull request's topic branch until you merge the pull request into the default branch of the repository. +In the default {% data variables.product.prodname_codeql_workflow %}, {% data variables.product.prodname_code_scanning %} is configured to analyze your code each time you either push a change to the default branch or any protected branches, or raise a pull request against the default branch or any protected branches. As a result, {% data variables.product.prodname_code_scanning %} will now commence. + +### Viewing the logging output from {% data variables.product.prodname_code_scanning %} + +After enabling {% data variables.product.prodname_code_scanning %} for your repository, you can watch the output of the actions as they run. + +{% data reusables.repositories.actions-tab %} + + You'll see a list that includes an entry for running the {% data variables.product.prodname_code_scanning %} workflow. + + ![Actions list showing {% data variables.product.prodname_code_scanning %} workflow](/assets/images/help/repository/code-scanning-actions-list.png) + +1. Click the entry for the {% data variables.product.prodname_code_scanning %} workflow. + +1. Click the job name on the left. For example, **Analyze (LANGUAGE)**. + + ![Log output from the {% data variables.product.prodname_code_scanning %} workflow](/assets/images/help/repository/code-scanning-logging-analyze-action.png) + +1. Review the logging output from the actions in this workflow as they run. + +1. Once all jobs are complete, you can view the details of any {% data variables.product.prodname_code_scanning %} alerts that were identified. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository#viewing-an-alert)." + +{% note %} + +**Note:** If you raised a pull request to add the {% data variables.product.prodname_code_scanning %} workflow to the repository, alerts from that pull request aren't displayed directly on the {% data variables.product.prodname_code_scanning_capc %} page until the pull request is merged. If any alerts were found you can view these, before the pull request is merged, by clicking the **_n_ alerts found** link in the banner on the {% data variables.product.prodname_code_scanning_capc %} page. + + ![Click the "n alerts found" link](/assets/images/help/repository/code-scanning-alerts-found-link.png) + +{% endnote %} + +### Understanding the pull request checks + +Each {% data variables.product.prodname_code_scanning %} workflow you enable to run on pull requests always has at least two entries listed in the checks section of a pull request. There is one entry for each of the analysis jobs in the workflow, and a final one for the results of the analysis. + +The names of the {% data variables.product.prodname_code_scanning %} analysis checks take the form: "TOOL NAME / JOB NAME (TRIGGER)." For example, for {% data variables.product.prodname_codeql %}, analysis of C++ code has the entry "{% data variables.product.prodname_codeql %} / Analyze (cpp) (pull_request)." You can click **Details** on a {% data variables.product.prodname_code_scanning %} analysis entry to see logging data. This allows you to debug a problem if the analysis job failed. For example, for {% data variables.product.prodname_code_scanning %} analysis of compiled languages, this can happen if the action can't build the code. + + ![{% data variables.product.prodname_code_scanning %} pull request checks](/assets/images/help/repository/code-scanning-pr-checks.png) + +When the {% data variables.product.prodname_code_scanning %} jobs complete, {% data variables.product.prodname_dotcom %} works out whether any alerts were added by the pull request and adds the "{% data variables.product.prodname_code_scanning_capc %} results / TOOL NAME" entry to the list of checks. After {% data variables.product.prodname_code_scanning %} has been performed at least once, you can click **Details** to view the results of the analysis. If you used a pull request to add {% data variables.product.prodname_code_scanning %} to the repository, you will initially see a "Missing analysis" message when you click **Details** on the "{% data variables.product.prodname_code_scanning_capc %} results / TOOL NAME" check. + + ![Missing analysis for commit message](/assets/images/help/repository/code-scanning-missing-analysis.png) + +#### Reasons for the "missing analysis" message + +After {% data variables.product.prodname_code_scanning %} has analyzed the code in a pull request, it needs to compare the analysis of the topic branch (the branch you used to create the pull request) with the analysis of the base branch (the branch into which you want to merge the pull request). This allows {% data variables.product.prodname_code_scanning %} to compute which alerts are newly introduced by the pull request, which alerts were already present in the base branch, and whether any existing alerts are fixed by the changes in the pull request. Initially, if you use a pull request to add {% data variables.product.prodname_code_scanning %} to a repository, the base branch has not yet been analyzed, so it's not possible to compute these details. In this case, when you click through from the results check on the pull request you will see the "Missing analysis for base commit SHA-HASH" message. + +There are other situations where there may be no analysis for the latest commit to the base branch for a pull request. These include: + +* The pull request has been raised against a branch other than the default branch or a protected branch, and this branch hasn't been analyzed. + + To check whether a branch has been scanned, go to the {% data variables.product.prodname_code_scanning_capc %} page, click the **Branch** drop-down and select the relevant branch. + + ![Choose a branch from the Branch drop-down menu](/assets/images/help/repository/code-scanning-branch-dropdown.png) + + The solution in this situation is to add the name of the base branch to the `on:push` and `on:pull_request` specification in the {% data variables.product.prodname_code_scanning %} workflow on that branch and then make a change that updates the open pull request that you want to scan. + +* The latest commit on the base branch for the pull request is currently being analyzed and analysis is not yet available. + + Wait a few minutes and then push a change to the pull request to retrigger {% data variables.product.prodname_code_scanning %}. + +* An error occurred while analyzing the latest commit on the base branch and analysis for that commit isn't available. + + Merge a trivial change into the base branch to trigger {% data variables.product.prodname_code_scanning %} on this latest commit, then push a change to the pull request to retrigger {% data variables.product.prodname_code_scanning %}. ### Next steps -After you enable {% data variables.product.prodname_code_scanning %}, you can monitor analysis, view results, and further customize how you scan your code. +After enabling {% data variables.product.prodname_code_scanning %}, and allowing its actions to complete, you can: -- You can view the run status of {% data variables.product.prodname_code_scanning %} and get notifications for completed runs. For more information, see "[Managing a workflow run](/actions/configuring-and-managing-workflows/managing-a-workflow-run)" and "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)." -- After a scan completes, you can view alerts from a completed scan. For more information, see "[Managing alerts from {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." -- You can customize how {% data variables.product.prodname_code_scanning %} scans the code in your repository. For more information, see "[Configuring code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." +- View all of the {% data variables.product.prodname_code_scanning %} alerts generated for this repository. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." +- View any alerts generated for a pull request submitted after you enabled {% data variables.product.prodname_code_scanning %}. For more information, see "[Triaging {% data variables.product.prodname_code_scanning %} alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests)." +- Set up notifications for completed runs. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)." +- Investigate any problems that occur with the initial setup of {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %}. For more information, see "[Troubleshooting the {% data variables.product.prodname_codeql %} workflow](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow)." +- Customize how {% data variables.product.prodname_code_scanning %} scans the code in your repository. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." diff --git a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md index 5f6a1a7f5788..946d0f99fc23 100644 --- a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md +++ b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/index.md @@ -1,5 +1,6 @@ --- title: 查找代码中的安全漏洞和错误 +product: '{% data reusables.gated-features.code-scanning %}' redirect_from: - /github/managing-security-vulnerabilities/finding-security-vulnerabilities-in-your-projects-code versions: @@ -11,14 +12,17 @@ versions: {% topic_link_in_list /automatically-scanning-your-code-for-vulnerabilities-and-errors %} {% link_in_list /about-code-scanning %} + {% link_in_list /triaging-code-scanning-alerts-in-pull-requests %} {% link_in_list /enabling-code-scanning %} - {% link_in_list /managing-alerts-from-code-scanning %} + {% link_in_list /managing-code-scanning-alerts-for-your-repository %} {% link_in_list /configuring-code-scanning %} - {% link_in_list /configuring-the-codeql-action-for-compiled-languages %} - {% link_in_list /troubleshooting-code-scanning %} + {% link_in_list /configuring-the-codeql-workflow-for-compiled-languages %} + {% link_in_list /troubleshooting-the-codeql-workflow %} {% topic_link_in_list /managing-results-from-code-scanning %} {% link_in_list /about-integration-with-code-scanning %} - {% link_in_list /running-code-scanning-in-your-ci-system %} - {% link_in_list /configuring-code-scanning-in-your-ci-system %} {% link_in_list /uploading-a-sarif-file-to-github %} {% link_in_list /sarif-support-for-code-scanning %} +{% link_in_list /running-code-scanning-in-your-ci-system %} + {% link_in_list /configuring-code-scanning-in-your-ci-system %} + {% link_in_list /configuring-the-codeql-action-for-compiled-languages %} + {% link_in_list /troubleshooting-codeql-code-scanning-in-your-ci-system %} diff --git a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md index 9caa80f45c73..9e4ac5a93d71 100644 --- a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md +++ b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning.md @@ -1,8 +1,9 @@ --- -title: Integrating with code scanning -shortTitle: Integration -intro: 'You can integrate {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} with your existing CI systems or upload results from other tools.' +title: 与代码扫描集成 +shortTitle: 集成 +intro: 'You can integrate third-party code analysis tools with {% data variables.product.prodname_dotcom %} {% data variables.product.prodname_code_scanning %} by uploading data as SARIF files.' mapTopic: true +product: '{% data reusables.gated-features.code-scanning %}' redirect_from: - /github/finding-security-vulnerabilities-and-errors-in-your-code/managing-results-from-code-scanning versions: diff --git a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository.md b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository.md new file mode 100644 index 000000000000..7c557b3fd198 --- /dev/null +++ b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository.md @@ -0,0 +1,63 @@ +--- +title: Managing code scanning alerts for your repository +shortTitle: 管理警报 +intro: '您可以查看、修复和关闭项目代码中潜在漏洞或错误的警报。' +product: '{% data reusables.gated-features.code-scanning %}' +permissions: 'People with write permission to a repository can manage {% data variables.product.prodname_code_scanning %} alerts for the repository.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +redirect_from: + - /github/managing-security-vulnerabilities/managing-alerts-from-automated-code-scanning + - /github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning +--- + +{% data reusables.code-scanning.beta %} + +### 关于 {% data variables.product.prodname_code_scanning %} 中的警报 + +You can set up {% data variables.product.prodname_code_scanning %} to check the code in a repository using the default {% data variables.product.prodname_codeql %} analysis, a third-party analysis, or multiple types of analysis. When the analysis is complete, the resulting alerts are displayed alongside each other in the security view of the repository. Results from third-party tools or from custom queries may not include all of the properties that you see for alerts detected by {% data variables.product.company_short %}'s default {% data variables.product.prodname_codeql %} analysis. 默认 {% data variables.product.prodname_code_scanning %} 工作流程使用 `on.push` 事件触发代码扫描 - 每次推送到任何包含工作流程文件的分支时触发。 + +By default, {% data variables.product.prodname_code_scanning %} analyzes your code periodically on the default branch and during pull requests. For information about managing alerts on a pull request, see "[Triaging {% data variables.product.prodname_code_scanning %} alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests)." + +### About alerts details + +每个警报都会高亮显示代码的问题以及识别该问题的工具名称。 您可以看到触发警报的代码行以及警报的属性，例如问题的严重程度和性质。 警报还会告知该问题第一次被引入的时间。 对于由 {% data variables.product.prodname_codeql %} 分析确定的警报，您还会看到如何解决问题的信息。 + +![来自 {% data variables.product.prodname_code_scanning %} 的警报示例](/assets/images/help/repository/code-scanning-alert.png) + +如果使用 {% data variables.product.prodname_codeql %} 启用 {% data variables.product.prodname_code_scanning %}，也可以检测代码中的数据流问题。 数据流分析将查找代码中的潜在安全问题，例如：不安全地使用数据、将危险参数传递给函数以及泄漏敏感信息。 + +当 {% data variables.product.prodname_code_scanning %} 报告数据流警报时，{% data variables.product.prodname_dotcom %} 将显示数据在代码中如何移动。 {% data variables.product.prodname_code_scanning_capc %} 可用于识别泄露敏感信息的代码区域，以及可能成为恶意用户攻击切入点的代码区域。 + +### 查看警报 + +Anyone with read permission for a repository can see {% data variables.product.prodname_code_scanning %} alerts on pull requests. However, you need write permission to view a summary of alerts for repository on the **Security** tab. By default, alerts are shown for the default branch. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-security %} +{% data reusables.repositories.sidebar-code-scanning-alerts %} +{% data reusables.code-scanning.click-alert-in-list %} +5. Optionally, if the alert highlights a problem with data flow, click **Show paths** to display the path from the data source to the sink where it's used. ![数据流警报示例](/assets/images/help/repository/code-scanning-show-paths.png) + +### Fixing an alert + +Anyone with write permission for a repository can fix an alert by committing a correction to the code. If the repository has {% data variables.product.prodname_code_scanning %} scheduled to run on pull requests, it's best to raise a pull request with your correction. This will trigger {% data variables.product.prodname_code_scanning %} analysis of the changes and test that your fix doesn't introduce any new problems. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" and "[Triaging {% data variables.product.prodname_code_scanning %} alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests)." + +### 关闭警报 + +Closing an alert is a way to resolve an alert that you don't think needs to be fixed. {% data reusables.code-scanning.close-alert-examples %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-security %} +{% data reusables.repositories.sidebar-code-scanning-alerts %} +{% data reusables.code-scanning.click-alert-in-list %} +5. Select the Close drop-down menu and click a reason for closing the alert. ![Choosing reason for closing the alert via the Close drop-down](/assets/images/help/repository/code-scanning-alert-close-drop-down.png) + +{% data reusables.code-scanning.false-positive-fix-codeql %} + +### 延伸阅读 + +- "[Triaging {% data variables.product.prodname_code_scanning %} alerts in pull requests](/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests)" +- "[Enabling {% data variables.product.prodname_code_scanning %} for a repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository)" +- "[About integration with {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning)" diff --git a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md new file mode 100644 index 000000000000..5b7faf0e62b0 --- /dev/null +++ b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system.md @@ -0,0 +1,161 @@ +--- +title: Running CodeQL code scanning in your CI system +shortTitle: Running in your CI +intro: 'You can use the {% data variables.product.prodname_codeql_runner %} to perform {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in a third-party continuous integration system.' +product: '{% data reusables.gated-features.code-scanning %}' +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta-codeql-runner %} +{% data reusables.code-scanning.beta %} +{% data reusables.code-scanning.enterprise-enable-code-scanning %} + +### Using {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} with your existing CI system + +If you use a continuous integration or continuous delivery/deployment (CI/CD) system other than {% data variables.product.prodname_actions %}, you can use your existing system to run {% data variables.product.prodname_dotcom %}'s {% data variables.product.prodname_codeql %} analysis and upload the results to {% data variables.product.prodname_dotcom %}. To do this, use the {% data variables.product.prodname_codeql_runner %}. + +### About the {% data variables.product.prodname_codeql_runner %} + +{% data reusables.code-scanning.about-code-scanning %} For information, see "[About {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)." + +You can use the {% data variables.product.prodname_codeql_runner %} to run {% data variables.product.prodname_code_scanning %} on code that you're processing in a third-party continuous integration (CI) system. Alternatively, you can use {% data variables.product.prodname_actions %} to run {% data variables.product.prodname_code_scanning %} on {% data variables.product.product_location %}. For information, see "[Enabling {% data variables.product.prodname_code_scanning %} for a repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning-for-a-repository)." + +The {% data variables.product.prodname_codeql_runner %} is a command-line tool that runs {% data variables.product.prodname_codeql %} analysis on a checkout of a {% data variables.product.prodname_dotcom %} repository. You add the runner to your third-party system, then call the runner to analyze code and upload the results to {% data variables.product.product_location %}. These results are displayed as {% data variables.product.prodname_code_scanning %} alerts in the repository. + +{% data reusables.code-scanning.codeql-runner-license %} + +### Downloading the {% data variables.product.prodname_codeql_runner %} + +You can download the {% data variables.product.prodname_codeql_runner %} from https://github.com/github/codeql-action/releases. On some operating systems, you may need to change permissions for the downloaded file before you can run it. + +On Linux: + +```shell +chmod +x codeql-runner-linux +``` + +On MacOS: + +```shell +chmod +x codeql-runner-macos +sudo xattr -d com.apple.quarantine codeql-runner-macos +``` + +On Windows, the `codeql-runner-win.exe` file usually requires no change to permissions. + +### Adding the {% data variables.product.prodname_codeql_runner %} to your CI system + +Once you have downloaded the {% data variables.product.prodname_codeql_runner %} and verified that it can be executed, you should make the runner available to each CI server that you intend to use for {% data variables.product.prodname_code_scanning %}. It is important to notice that each CI server that you intend to use for {% data variables.product.prodname_code_scanning %} needs to have the {% data variables.product.prodname_codeql_runner %}. You might configure each server to copy the runner from a central, internal location, or you could use the REST API to get the runner direct from GitHub, for example: + +```shell +wget https://github.com/github/codeql-action/releases/download/codeql-bundle-20200826/codeql-runner-linux +chmod +x codeql-runner-linux +``` + +In addition to this, each CI server also needs: + +- A {% data variables.product.prodname_github_apps %} or personal access token for the {% data variables.product.prodname_codeql_runner %} to use. For private repositories the token must have the `repo` scope. For public the token needs only the `public_repo` and `repo:security_events` scopes. For information, see "[Building {% data variables.product.prodname_github_apps %}](/developers/apps/building-github-apps)" and "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token)." +- Access to the {% data variables.product.prodname_codeql %} bundle associated with this release of the {% data variables.product.prodname_codeql_runner %}. This package contains the {% data variables.product.prodname_codeql %} CLI, queries, and libraries needed for {% data variables.product.prodname_codeql %} analysis. For information, see "[{% data variables.product.prodname_codeql %} CLI](https://help.semmle.com/codeql/codeql-cli.html)." + +The options for providing access to the {% data variables.product.prodname_codeql %} bundle are: + +1. Allow the CI servers access to {% data variables.product.prodname_dotcom_the_website %} so that the {% data variables.product.prodname_codeql_runner %} can download the bundle automatically. +1. Manually download/extract the bundle, store it with other central resources, and use the `--codeql-path` flag to specify the location of the bundle in calls to initialize the {% data variables.product.prodname_codeql_runner %}. +{% if currentVersion != "free-pro-team@latest" %} +1. You can mirror the `github/codeql-action` repository on {% data variables.product.product_location %}. Unless you specify the `--codeql-path` flag, the runner automatically checks for the bundle in this location and on {% data variables.product.prodname_dotcom_the_website %}.{% endif %} + +### Calling the {% data variables.product.prodname_codeql_runner %} + +You should call the {% data variables.product.prodname_codeql_runner %} from the checkout location of the repository you want to analyze. The two main commands are: + +1. `init` required to initialize the runner and create a {% data variables.product.prodname_codeql %} database for each language to be analyzed. These databases are populated and analyzed by subsequent commands. +1. `analyze` required to populate the {% data variables.product.prodname_codeql %} databases, analyze them, and upload results to {% data variables.product.product_location %}. + +For both commands, you must specify the URL of {% data variables.product.product_location %}, the repository *OWNER/NAME*, and the GitHub Apps or personal access token to use for authentication. You also need to specify the location of the CodeQL bundle unless the CI server has access to download it directly from the `github/codeql-action` repository on {% data variables.product.prodname_dotcom_the_website %}{% if currentVersion != "free-pro-team@latest" %} or mirrored on {% data variables.product.product_location %}{% endif %}. + +You can configure where the {% data variables.product.prodname_codeql_runner %} stores the CodeQL bundle for future analysis on a server using the `--tools-dir` flag and where it stores temporary files during analysis using `--temp-dir`. + +To view the command-line reference for the runner, use the `-h` flag. For example, to list all commands run: `codeql-runner-OS -h`, or to list all the flags available for the `init` command run: `codeql-runner-OS init -h` (where `OS` varies according to the executable that you are using). For more information, see "[Configuring {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system#codeql-runner-command-reference)." + +#### Basic example + +This example runs {% data variables.product.prodname_codeql %} analysis on a Linux CI server for the `octo-org/example-repo` repository hosted on `{% data variables.command_line.git_url_example %}`. The process is very simple because the repository contains only languages that can be analyzed by {% data variables.product.prodname_codeql %} directly, without being built (that is, Go, JavaScript, Python, and TypeScript). + +1. Check out the repository to analyze. +1. Move into the directory where the repository is checked out. +1. Initialize the {% data variables.product.prodname_codeql_runner %} and create {% data variables.product.prodname_codeql %} databases for the languages detected. + + ```shell + $ /path/to-runner/codeql-runner-linux init --repository octo-org/example-repo + --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN + > Cleaning temp directory /srv/checkout/example-repo/codeql-runner + > ... + > Created CodeQL database at /srv/checkout/example-repo/codeql-runner/codeql_databases/javascript. + ``` + +1. Populate the {% data variables.product.prodname_codeql_runner %} databases, analyze them, and upload the results to {% data variables.product.product_name %}. + + ```shell + $ /path/to-runner/codeql-runner-linux analyze --repository octo-org/example-repo + --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN + --commit 5b6a3078b31dc346e5ce7b86837d6abbe7a18bbd --ref refs/heads/main + > Finalizing database creation + > ... + > POST /repos/octo-org/example-repo/code-scanning/sarifs - 202 in 786ms + > Successfully uploaded results + ``` + +The server has access to download the {% data variables.product.prodname_codeql %} bundle directly from the `github/codeql-action` repository on {% data variables.product.prodname_dotcom_the_website %}{% if currentVersion != "free-pro-team@latest" %} or mirrored on {% data variables.product.product_location %}{% endif %}, so there is no need to use the `--codeql-path` flag. When the analysis is complete, the {% data variables.product.prodname_codeql_runner %} uploads the results to the {% data variables.product.prodname_code_scanning %} view. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." + +#### Compiled language example + +This example is similar to the previous example, however this time the repository has code in C/C++, C#, or Java. To create a {% data variables.product.prodname_codeql %} database for these languages, the CLI needs to monitor the build. At the end of the initialization process, the runner reports the command you need to set up the environment before building the code. You need to run this command, before calling the normal CI build process, and then running the `analyze` command. + +1. Check out the repository to analyze. +1. Move into the directory where the repository is checked out. +1. Initialize the {% data variables.product.prodname_codeql_runner %} and create {% data variables.product.prodname_codeql %} databases for the languages detected. + + ```shell + $ /path/to-runner/codeql-runner-linux init --repository octo-org/example-repo-2 + --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN + > Cleaning temp directory /srv/checkout/example-repo-2/codeql-runner + > ... + > CodeQL environment output to "/srv/checkout/example-repo-2/codeql-runner/codeql-env.json" + and "/srv/checkout/example-repo-2/codeql-runner/codeql-env.sh". + Please export these variables to future processes so the build can be traced, for example by running " + . /srv/checkout/example-repo-2/codeql-runner/codeql-env.sh". + ``` + +1. Run the script generated by the `init` action to set up the environment to monitor the build. + + ```shell + $ . /srv/checkout/example-repo-2/codeql-runner/codeql-env.sh + ``` + +1. Build the code. +1. Populate the {% data variables.product.prodname_codeql %} databases, analyze them, and upload the results to GitHub. + + ```shell + $ /path/to-runner/codeql-runner-linux analyze --repository octo-org/example-repo-2 + --github-url {% data variables.command_line.git_url_example %} --github-auth TOKEN + --commit ae7b655ef30b50fb726ae7b3daa79571a39d194d --ref refs/heads/main + > Finalizing database creation + > ... + > POST /repos/octo-org/example-repo-2/code-scanning/sarifs - 202 in 573ms + > Successfully uploaded results + ``` + +{% note %} + +**Note:** If you use a containerized build, you need to run the {% data variables.product.prodname_codeql_runner %} in the container where your build task takes place. + +{% endnote %} + +### Further reading + +- "[Configuring {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system)" +- "[Troubleshooting {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system)" diff --git a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md index 672d93084d1b..d1e0bfc748b0 100644 --- a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md +++ b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning.md @@ -1,7 +1,7 @@ --- title: 对代码扫描的 SARIF 支持 shortTitle: SARIF 支持 -intro: '要在 {% data variables.product.prodname_dotcom %} 上的仓库中显示第三方静态分析工具的结果，您需要将结果存储在 SARIF 文件中，以支持用于代码扫描的 SARIF 2.1.0 JSON 架构的特定子集。 如果使用默认 {% data variables.product.prodname_codeql %} 静态分析引擎，结果将自动显示于您在 {% data variables.product.prodname_dotcom %} 上的仓库中。' +intro: 'To display results from a third-party static analysis tool in your repository on {% data variables.product.prodname_dotcom %}, you''ll need your results stored in a SARIF file that supports a specific subset of the SARIF 2.1.0 JSON schema for {% data variables.product.prodname_code_scanning %}. 如果使用默认 {% data variables.product.prodname_codeql %} 静态分析引擎，结果将自动显示于您在 {% data variables.product.prodname_dotcom %} 上的仓库中。' product: '{% data reusables.gated-features.code-scanning %}' redirect_from: - /github/finding-security-vulnerabilities-and-errors-in-your-code/about-sarif-support-for-code-scanning @@ -11,27 +11,32 @@ versions: --- {% data reusables.code-scanning.beta %} -{% data reusables.code-scanning.enterprise-enable-code-scanning %} ### 关于 SARIF 支持 SARIF（数据分析结果交换格式）是定义输出文件格式的 [OASIS 标准](https://docs.oasis-open.org/sarif/sarif/v2.1.0/sarif-v2.1.0.html)。 SARIF 标准用于简化静态分析工具分享其结果的方式。 {% data variables.product.prodname_code_scanning_capc %} 支持 SARIF 2.1.0 JSON 架构的子集。 -要从第三方静态代码分析引擎上传 SARIF 文件，需确保上传的文件使用 SARIF 2.1.0 版本。 {% data variables.product.prodname_dotcom %} 将剖析 SARIF 文件，并在代码扫描过程中使用仓库中的结果显示警报。 更多信息请参阅“[将 SARIF 文件上传到 {% data variables.product.prodname_dotcom %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)”。 有关 SARIF 2.1.0 JSON 架构的更多信息，请参阅 [`sarif-schema-2.1.0.json`](https://github.com/oasis-tcs/sarif-spec/blob/master/Schemata/sarif-schema-2.1.0.json)。 +要从第三方静态代码分析引擎上传 SARIF 文件，需确保上传的文件使用 SARIF 2.1.0 版本。 {% data variables.product.prodname_dotcom %} will parse the SARIF file and show alerts using the results in your repository as a part of the {% data variables.product.prodname_code_scanning %} experience. 更多信息请参阅“[将 SARIF 文件上传到 {% data variables.product.prodname_dotcom %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github)”。 有关 SARIF 2.1.0 JSON 架构的更多信息，请参阅 [`sarif-schema-2.1.0.json`](https://github.com/oasis-tcs/sarif-spec/blob/master/Schemata/sarif-schema-2.1.0.json)。 -If you're using {% data variables.product.prodname_actions %} with the {% data variables.product.prodname_codeql_workflow %} or using the {% data variables.product.prodname_codeql_runner %}, then the {% data variables.product.prodname_code_scanning %} results will automatically use the supported subset of SARIF 2.1.0. For more information, see "[Enabling {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning)" or "[Running code scanning in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system)." +如果您结合使用 {% data variables.product.prodname_actions %} 和 {% data variables.product.prodname_codeql_workflow %}，或者使用 {% data variables.product.prodname_codeql_runner %}，则 {% data variables.product.prodname_code_scanning %} 结果将自动使用受支持的 SARIF 2.1.0 子集。 For more information, see "[Enabling {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning)" or "[Running {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)." -{% data variables.product.prodname_dotcom %} 使用 SARIF 文件中的属性来显示警报。 例如，`shortDescription` 和 `fullDescription` 出现在 {% data variables.product.prodname_code_scanning %} 警报的顶部。 `location` 允许 {% data variables.product.prodname_dotcom %} 在代码文件中显示注释。 更多信息请参阅“[管理来自 {% data variables.product.prodname_code_scanning %} 的警报](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)”。 +{% data variables.product.prodname_dotcom %} 使用 SARIF 文件中的属性来显示警报。 例如，`shortDescription` 和 `fullDescription` 出现在 {% data variables.product.prodname_code_scanning %} 警报的顶部。 `location` 允许 {% data variables.product.prodname_dotcom %} 在代码文件中显示注释。 For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." 如果您是 SARIF 的新用户，想了解更多信息，请参阅 Microsoft 的[`SARIF 教程`](https://github.com/microsoft/sarif-tutorials)库。 ### 使用指纹防止重复警报 -Each time the results of a new code scan are uploaded, the results are processed and alerts are added to the repository. 为防止出现针对同一问题的重复警报，{% data variables.product.prodname_code_scanning %} 使用指纹匹配各个运行的结果，使它们只会出现在所选分支的最新运行中出现一次。 +每次上传新的代码扫描结果时，都会处理结果并将警报添加到仓库中。 为防止出现针对同一问题的重复警报，{% data variables.product.prodname_code_scanning %} 使用指纹匹配各个运行的结果，使它们只会出现在所选分支的最新运行中出现一次。 This makes it possible to match alerts to the right line of code when files are edited. {% data variables.product.prodname_dotcom %} 使用 OASIS 标准中的 `partialFingerprints` 属性来检测两个结果在逻辑上是否相同。 更多信息请参阅 OASIS 文档中的 "[partialFingerprints property](https://docs.oasis-open.org/sarif/sarif/v2.1.0/cs01/sarif-v2.1.0-cs01.html#_Toc16012611)" 条目。 -SARIF files created by the {% data variables.product.prodname_codeql_workflow %} or using the {% data variables.product.prodname_codeql_runner %} include fingerprint data. If your SARIF file doesn't include `partialFingerprints`, the `partialFingerprints` field will be calculated if you upload the SARIF file using {% data variables.product.prodname_actions %}. 更多信息请参阅“[将 SARIF 文件上传到 {% data variables.product.prodname_dotcom %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github#uploading-a-code-scanning-analysis-with-github-actions)”。 +通过 {% data variables.product.prodname_codeql_workflow %} 或 {% data variables.product.prodname_codeql_runner %} 创建的 SARIF 文件包含指纹数据。 If you upload a SARIF file using the `upload-sarif` action and this data is missing, {% data variables.product.prodname_dotcom %} attempts to populate the `partialFingerprints` field from the source files. For more information about uploading results, see "[Uploading a SARIF file to {% data variables.product.prodname_dotcom %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github#uploading-a-code-scanning-analysis-with-github-actions)." + +If you upload a SARIF file without fingerprint data using the `/code-scanning/sarifs` API endpoint, the {% data variables.product.prodname_code_scanning %} alerts will be processed and displayed, but users may see duplicate alerts. To avoid seeing duplicate alerts, you should calculate fingerprint data and populate the `partialFingerprints` property before you upload the SARIF file. You may find the script that the `upload-sarif` action uses a helpful starting point: https://github.com/github/codeql-action/blob/main/src/fingerprints.ts. For more information about the API, see "[Upload a SARIF file](/rest/reference/code-scanning#upload-a-sarif-file)." + +### Validating your SARIF file + +You can check a SARIF file is compatible with {% data variables.product.prodname_code_scanning %} by testing it against the {% data variables.product.prodname_dotcom %} ingestion rules. For more information, visit the [Microsoft SARIF validator](https://sarifweb.azurewebsites.net/). ### 支持的 SARIF 输出文件属性 @@ -44,49 +49,49 @@ SARIF files created by the {% data variables.product.prodname_codeql_workflow %} | 名称 | 描述 | | --------- | -------------------------------------------------------------------------------------------------------------------------------------- | | `$schema` | **必需。**2.1.0 版 SARIFJSON 架构的 URI。 例如，`https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json`。 | -| `version` | **必选。** {% data variables.product.prodname_code_scanning_capc %} 只支持 SARIF 版本 `2.1.0`。 | +| `version` | **必选。** {% data variables.product.prodname_code_scanning_capc %} 只支持 SARIF 版本 `2.1.0`。 | | `runs[]` | **必选。** SARIF 文件包含一个或多个运行的数组。 每个运行代表分析工具的一次运行。 有关 `run` 的更多信息，请参阅 [`run` 对象](#run-object)。 | #### `run` 对象 {% data variables.product.prodname_code_scanning_capc %} 使用 `run` 对象按工具过滤结果并提供关于结果来源的信息。 `run` 对象包含 `tool.driver` 工具组件对象，该对象包含有关生成结果的工具的信息。 每个 `run` 只能获得一个分析工具的结果。 -| 名称 | 描述 | -| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 名称 | 描述 | +| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `tool.driver.name` | **必需。**分析工具的名称。 {% data variables.product.prodname_code_scanning_capc %} 在 {% data variables.product.prodname_dotcom %} 上显示名称，以允许您按工具过滤结果。 | | `tool.driver.version` | **可选。**分析工具的版本。 {% data variables.product.prodname_code_scanning_capc %} 使用版本号来跟踪何时可能因工具版本的变更而不是所分析代码的变更而导致了结果变化。 如果 SARIF 文件包含 `semanticVersion` 字段，则 {% data variables.product.prodname_code_scanning %} 不使用 `version`。 | | `tool.driver.semanticVersion` | **可选。**以语义版本 2.0 格式指定的分析工具版本。 {% data variables.product.prodname_code_scanning_capc %} 使用版本号来跟踪何时可能因工具版本的变更而不是所分析代码的变更而导致了结果变化。 如果 SARIF 文件包含 `semanticVersion` 字段，则 {% data variables.product.prodname_code_scanning %} 不使用 `version`。 更多信息请参阅语义版本文档中的“[语义版本 2.0.0](https://semver.org/)”。 | -| `tool.driver.rules[]` | **必需。**用于表示规则的 `reportingDescriptor` 对象数组。 分析工具使用规则来查找所分析代码中的问题。 更多信息请参阅 [`reportingDescriptor` 对象](#reportingdescriptor-object)。 | +| `tool.driver.rules[]` | **必需。**用于表示规则的 `reportingDescriptor` 对象数组。 分析工具使用规则来查找所分析代码中的问题。 更多信息请参阅 [`reportingDescriptor` 对象](#reportingdescriptor-object)。 | | `results[]` | **必需。**分析工具的结果。 {% data variables.product.prodname_code_scanning_capc %} 在 {% data variables.product.prodname_dotcom %} 上显示结果。 更多信息请参阅 [`result` 对象](#result-object)。 | #### `reportingDescriptor` 对象 -| 名称 | 描述 | -| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `id` | **必需。**规则的唯一标识符。 `id` 是从 SARIF 文件的其他部分引用的，可能被 {% data variables.product.prodname_code_scanning %} 用于在 {% data variables.product.prodname_dotcom %} 上显示 URL。 | -| `name` | **可选。**规则的名称。 {% data variables.product.prodname_code_scanning_capc %} 显示名称，以允许按 {% data variables.product.prodname_dotcom %} 上的规则过滤结果。 | -| `shortDescription.text` | **必需。**规则的简要说明。 {% data variables.product.prodname_code_scanning_capc %} 在 {% data variables.product.prodname_dotcom %} 上的相关结果旁边显示简短说明。 | -| `fullDescription.text` | **必需。**规则的说明。 {% data variables.product.prodname_code_scanning_capc %} 在 {% data variables.product.prodname_dotcom %} 上的相关结果旁边显示完整说明。 最大字符数限制为 1000。 | -| `defaultConfiguration.level` | **可选。**规则的默认严重级别。 {% data variables.product.prodname_code_scanning_capc %} 使用严重级别帮助您了解结果对于给定规则的严重程度。 此值可用 `result` 对象中的 `level` 属性进行覆盖。 更多信息请参阅 [`result` 对象](#result-object)。 默认值：`warning`。 | -| `help.text` | **Required.** Documentation for the rule using text format. {% data variables.product.prodname_code_scanning_capc %} 在相关结果旁边显示此帮助文档。 | -| `help.markdown` | **推荐。**使用 Markdown 格式的规则文档。 {% data variables.product.prodname_code_scanning_capc %} 在相关结果旁边显示此帮助文档。 When `help.markdown` is available, it is displayed instead of `help.text`. | -| `properties.tags[]` | **可选。**字符串数组。 {% data variables.product.prodname_code_scanning_capc %} 使用 `tags` 允许您在 {% data variables.product.prodname_dotcom %} 上过滤结果。 例如，可以过滤带标记 `security` 的所有结果。 | -| `properties.precision` | **推荐。**一个字符串，表示此规则指示的结果为真的频率。 例如，如果已知某项规则的误报率较高，则其准确性应为 `low`。 {% data variables.product.prodname_code_scanning_capc %} 在 {% data variables.product.prodname_dotcom %} 上按准确性对结果进行排序，使具有最高 `level` 和最高 `precision` 的结果显示在最前面。 Can be one of: `very-high`, `high`, `medium`, or `low`. | +| 名称 | 描述 | +| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `id` | **必需。**规则的唯一标识符。 `id` 是从 SARIF 文件的其他部分引用的，可能被 {% data variables.product.prodname_code_scanning %} 用于在 {% data variables.product.prodname_dotcom %} 上显示 URL。 | +| `name` | **可选。**规则的名称。 {% data variables.product.prodname_code_scanning_capc %} 显示名称，以允许按 {% data variables.product.prodname_dotcom %} 上的规则过滤结果。 | +| `shortDescription.text` | **必需。**规则的简要说明。 {% data variables.product.prodname_code_scanning_capc %} 在 {% data variables.product.prodname_dotcom %} 上的相关结果旁边显示简短说明。 | +| `fullDescription.text` | **必需。**规则的说明。 {% data variables.product.prodname_code_scanning_capc %} 在 {% data variables.product.prodname_dotcom %} 上的相关结果旁边显示完整说明。 最大字符数限制为 1000。 | +| `defaultConfiguration.level` | **可选。**规则的默认严重级别。 {% data variables.product.prodname_code_scanning_capc %} 使用严重级别帮助您了解结果对于给定规则的严重程度。 此值可用 `result` 对象中的 `level` 属性进行覆盖。 更多信息请参阅 [`result` 对象](#result-object)。 默认值：`warning`。 | +| `help.text` | **必需。**使用文本格式的规则文档。 {% data variables.product.prodname_code_scanning_capc %} 在相关结果旁边显示此帮助文档。 | +| `help.markdown` | **推荐。**使用 Markdown 格式的规则文档。 {% data variables.product.prodname_code_scanning_capc %} 在相关结果旁边显示此帮助文档。 当 `help.markdown` 可用时，将显示它，而不是 `help.text`。 | +| `properties.tags[]` | **可选。**字符串数组。 {% data variables.product.prodname_code_scanning_capc %} 使用 `tags` 允许您在 {% data variables.product.prodname_dotcom %} 上过滤结果。 例如，可以过滤带标记 `security` 的所有结果。 | +| `properties.precision` | **推荐。**一个字符串，表示此规则指示的结果为真的频率。 例如，如果已知某项规则的误报率较高，则其准确性应为 `low`。 {% data variables.product.prodname_code_scanning_capc %} 在 {% data variables.product.prodname_dotcom %} 上按准确性对结果进行排序，使具有最高 `level` 和最高 `precision` 的结果显示在最前面。 可以是以下值之一：`very-high`、`high`、`medium` 或 `low`。 | #### `result` 对象 -| 名称 | 描述 | -| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `ruleId` | **可选。**规则的唯一标识符 (`reportingDescriptor.id`)。 更多信息请参阅 [`reportingDescriptor` 对象](#reportingdescriptor-object)。 {% data variables.product.prodname_code_scanning_capc %} 使用规则标识符在 {% data variables.product.prodname_dotcom %} 上按规则过滤结果。 | -| `ruleIndex` | **可选。**工具组件 `rules` 数组中相关规则（`reportingDescriptor` 对象）的索引。 更多信息请参阅 [`run` 对象](#run-object)。 | -| `rule` | **可选。**用于定位此结果的规则 (reportingdescriptor) 的引用。 更多信息请参阅 [`reportingDescriptor` 对象](#reportingdescriptor-object)。 | -| `level` | **可选。**结果的严重程度。 此级别覆盖规则定义的默认严重程度。 {% data variables.product.prodname_code_scanning_capc %} 使用级别在 {% data variables.product.prodname_dotcom %} 上按严重程度过滤结果。 | -| `message.text` | **必选。**描述结果的消息。 {% data variables.product.prodname_code_scanning_capc %} 显示消息文本作为结果的标题。 当可见空间有限时，仅显示消息的第一句。 | -| `locations[]` | **必选。**检测到结果的位置集。 应只包含一个位置，除非只能通过在每个指定位置进行更改来更正问题。 **注：**{% data variables.product.prodname_code_scanning %} 至少需要一个位置才能显示结果。 {% data variables.product.prodname_code_scanning_capc %} 将使用此属性来决定要用结果注释哪个文件。 仅使用此数组的第一个值。 所有其他值都被忽略。 | +| 名称 | 描述 | +| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `ruleId` | **可选。**规则的唯一标识符 (`reportingDescriptor.id`)。 更多信息请参阅 [`reportingDescriptor` 对象](#reportingdescriptor-object)。 {% data variables.product.prodname_code_scanning_capc %} 使用规则标识符在 {% data variables.product.prodname_dotcom %} 上按规则过滤结果。 | +| `ruleIndex` | **可选。**工具组件 `rules` 数组中相关规则（`reportingDescriptor` 对象）的索引。 更多信息请参阅 [`run` 对象](#run-object)。 | +| `rule` | **可选。**用于定位此结果的规则 (reportingdescriptor) 的引用。 更多信息请参阅 [`reportingDescriptor` 对象](#reportingdescriptor-object)。 | +| `level` | **可选。**结果的严重程度。 此级别覆盖规则定义的默认严重程度。 {% data variables.product.prodname_code_scanning_capc %} 使用级别在 {% data variables.product.prodname_dotcom %} 上按严重程度过滤结果。 | +| `message.text` | **必选。**描述结果的消息。 {% data variables.product.prodname_code_scanning_capc %} 显示消息文本作为结果的标题。 当可见空间有限时，仅显示消息的第一句。 | +| `locations[]` | **必选。**检测到结果的位置集。 应只包含一个位置，除非只能通过在每个指定位置进行更改来更正问题。 **注：**{% data variables.product.prodname_code_scanning %} 至少需要一个位置才能显示结果。 {% data variables.product.prodname_code_scanning_capc %} 将使用此属性来决定要用结果注释哪个文件。 仅使用此数组的第一个值。 所有其他值都被忽略。 | | `partialFingerprints` | **必选。**用于跟踪结果的唯一标识的一组字符串。 {% data variables.product.prodname_code_scanning_capc %} 使用 `partialFingerprints` 准确地识别在提交和分支之间相同的结果。 {% data variables.product.prodname_code_scanning_capc %} 将尝试使用 `partialFingerprints`（如果存在）。 如果您使用 `upload-action` 上传第三方 SARIF 文件，该操作将为您创建 `partialFingerprints`（如果它们未包含在 SARIF 文件中）。 更多信息请参阅“[使用指纹防止重复警报](#preventing-duplicate-alerts-using-fingerprints)”。 **注：**{% data variables.product.prodname_code_scanning_capc %} 只使用 `primaryLocationLineHash`。 | -| `codeFlows[].threadFlows[].locations[]` | **可选。**`threadFlow` 对象的 `location` 对象数组，它描述程序通过执行线程的进度。 `codeFlow` 对象描述用于检测结果的代码执行模式。 如果提供了代码流，{% data variables.product.prodname_code_scanning %} 将在 {% data variables.product.prodname_dotcom %} 上扩展代码流以获取相关结果。 更多信息请参阅 [`location` 对象](#location-object)。 | -| `relatedLocations[]` | 与此结果相关的一组位置。 当相关位置嵌入在结果消息中时，{% data variables.product.prodname_code_scanning_capc %} 将链接到这些位置。 更多信息请参阅 [`location` 对象](#location-object)。 | -| `suppressions[].state` | **可选。**当 `state` 设置为 `accepted` 时，{% data variables.product.prodname_code_scanning %} 将在 {% data variables.product.prodname_dotcom %} 上将结果的状态更新为 `Closed`。 | +| `codeFlows[].threadFlows[].locations[]` | **可选。**`threadFlow` 对象的 `location` 对象数组，它描述程序通过执行线程的进度。 `codeFlow` 对象描述用于检测结果的代码执行模式。 如果提供了代码流，{% data variables.product.prodname_code_scanning %} 将在 {% data variables.product.prodname_dotcom %} 上扩展代码流以获取相关结果。 更多信息请参阅 [`location` 对象](#location-object)。 | +| `relatedLocations[]` | 与此结果相关的一组位置。 当相关位置嵌入在结果消息中时，{% data variables.product.prodname_code_scanning_capc %} 将链接到这些位置。 更多信息请参阅 [`location` 对象](#location-object)。 | +| `suppressions[].state` | **可选。**当 `state` 设置为 `accepted` 时，{% data variables.product.prodname_code_scanning %} 将在 {% data variables.product.prodname_dotcom %} 上将结果的状态更新为 `Closed`。 | #### `location` 对象 @@ -100,13 +105,13 @@ SARIF files created by the {% data variables.product.prodname_codeql_workflow %} #### `physicalLocation` 对象 -| 名称 | 描述 | -| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 名称 | 描述 | +| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `artifactLocation.uri` | **必选。**表示构件位置的 URI，通常是仓库中或在构建期间生成的文件。 如果 URI 是相对的，它应相对于正在分析的 {% data variables.product.prodname_dotcom %} 仓库的根目录。 例如，main.js 或 src/script.js 相对于仓库的根目录。 如果 URI 是绝对的，则 {% data variables.product.prodname_code_scanning %} 可使用 URI 检出构件并匹配仓库中的文件。 例如，`https://github.com/github/example/blob/00/src/promiseUtils.js`。 | -| `region.startLine` | **必选。**区域中第一个字符的行号。 | -| `region.startColumn` | **必选。**区域中第一个字符的列编号。 | -| `region.endLine` | **必选。**区域中最后一个字符的行号。 | -| `region.endColumn` | **必选。**区域结束后字符的列编号。 | +| `region.startLine` | **必选。**区域中第一个字符的行号。 | +| `region.startColumn` | **必选。**区域中第一个字符的列编号。 | +| `region.endLine` | **必选。**区域中最后一个字符的行号。 | +| `region.endColumn` | **必选。**区域结束后字符的列编号。 | ### SARIF 输出文件示例 @@ -119,38 +124,47 @@ SARIF files created by the {% data variables.product.prodname_codeql_workflow %} ```json { - "$schema" : "https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json", - "version" : "2.1.0", - "runs" : - [ + "$schema": "https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json", + "version": "2.1.0", + "runs": [ { - "tool" : { - "driver" : { - "name" : "Tool Name" - } - }, - "results" : [ { - "message" : { - "text" : "Result text. This result does not have a rule associated." - }, - "locations" : [ { - "physicalLocation" : { - "artifactLocation" : { - "uri" : "src/build.cmd" - }, - "region" : { - "startLine" : 2, - "startColumn" : 7, - "endColumn" : 10 + "tool": { + "driver": { + "name": "Tool Name", + "rules": [ + { + "id": "R01" } + ] + } + }, + "results": [ + { + "ruleId": "R01", + "message": { + "text": "Result text. This result does not have a rule associated." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "fileURI" + }, + "region": { + "startLine": 2, + "startColumn": 7, + "endColumn": 10 + } + } } - } ], - "partialFingerprints" : { - "primaryLocationLineHash" : "39fa2ee980eb94b0:1" + ], + "partialFingerprints": { + "primaryLocationLineHash": "39fa2ee980eb94b0:1" + } } - }] - } - ] + ] + } + ] } ``` @@ -170,7 +184,7 @@ SARIF files created by the {% data variables.product.prodname_codeql_workflow %} "semanticVersion": "2.0.0", "rules": [ { - "id": "js/unused-local-variable", + "id": "3f292041e51d22005ce48f39df3585d44ce1b0ad", "name": "js/unused-local-variable", "shortDescription": { "text": "Unused variable, import, function or class" @@ -189,7 +203,7 @@ SARIF files created by the {% data variables.product.prodname_codeql_workflow %} } }, { - "id": "js/inconsistent-use-of-new", + "id": "d5b664aefd5ca4b21b52fdc1d744d7d6ab6886d0", "name": "js/inconsistent-use-of-new", "shortDescription": { "text": "Inconsistent use of 'new'" @@ -197,7 +211,6 @@ SARIF files created by the {% data variables.product.prodname_codeql_workflow %} "fullDescription": { "text": "If a function is intended to be a constructor, it should always be invoked with 'new'. Otherwise, it should always be invoked as a normal function, that is, without 'new'." }, - "defaultConfiguration": null, "properties": { "tags": [ "reliability", @@ -206,13 +219,16 @@ SARIF files created by the {% data variables.product.prodname_codeql_workflow %} ], "precision": "very-high" } + }, + { + "id": "R01" } ] } }, "results": [ { - "ruleId": "js/unused-local-variable", + "ruleId": "3f292041e51d22005ce48f39df3585d44ce1b0ad", "ruleIndex": 0, "message": { "text": "Unused variable foo." @@ -222,8 +238,7 @@ SARIF files created by the {% data variables.product.prodname_codeql_workflow %} "physicalLocation": { "artifactLocation": { "uri": "main.js", - "uriBaseId": "%SRCROOT%", - "index": 0 + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 2, @@ -239,7 +254,7 @@ SARIF files created by the {% data variables.product.prodname_codeql_workflow %} } }, { - "ruleId": "js/inconsistent-use-of-new", + "ruleId": "d5b664aefd5ca4b21b52fdc1d744d7d6ab6886d0", "ruleIndex": 1, "message": { "text": "Function resolvingPromise is sometimes invoked as a constructor (for example [here](1)), and sometimes as a normal function (for example [here](2))." @@ -248,8 +263,8 @@ SARIF files created by the {% data variables.product.prodname_codeql_workflow %} { "physicalLocation": { "artifactLocation": { - "uri": "https://github.com/github/example/blob/0000000000000000000000000000000000000000/src/promiseUtils.js", - "index": 1 + "uri": "src/promises.js", + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 2 @@ -267,8 +282,7 @@ SARIF files created by the {% data variables.product.prodname_codeql_workflow %} "physicalLocation": { "artifactLocation": { "uri": "src/ParseObject.js", - "uriBaseId": "%SRCROOT%", - "index": 3 + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 2281, @@ -285,8 +299,7 @@ SARIF files created by the {% data variables.product.prodname_codeql_workflow %} "physicalLocation": { "artifactLocation": { "uri": "src/LiveQueryClient.js", - "uriBaseId": "%SRCROOT%", - "index": 2 + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 166 @@ -299,6 +312,7 @@ SARIF files created by the {% data variables.product.prodname_codeql_workflow %} ] }, { + "ruleId": "R01", "message": { "text": "Specifying both [ruleIndex](1) and [ruleID](2) might lead to inconsistencies." }, @@ -308,8 +322,7 @@ SARIF files created by the {% data variables.product.prodname_codeql_workflow %} "physicalLocation": { "artifactLocation": { "uri": "full.sarif", - "uriBaseId": "%SRCROOT%", - "index": 0 + "uriBaseId": "%SRCROOT%" }, "region": { "startLine": 54, @@ -403,12 +416,6 @@ SARIF files created by the {% data variables.product.prodname_codeql_workflow %} } } ], - "newlineSequences": [ - "\r\n", - "\n", - "", - "" - ], "columnKind": "utf16CodeUnits" } ] diff --git a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md new file mode 100644 index 000000000000..53790163b86a --- /dev/null +++ b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/triaging-code-scanning-alerts-in-pull-requests.md @@ -0,0 +1,48 @@ +--- +title: Triaging code scanning alerts in pull requests +shortTitle: Triaging alerts in pull requests +intro: 'When {% data variables.product.prodname_code_scanning %} identifies a problem in a pull request, you can review the highlighted code and resolve the alert.' +product: '{% data reusables.gated-features.code-scanning %}' +permissions: 'People with write permission to a repository can resolve {% data variables.product.prodname_code_scanning %} alerts.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta %} + +### About {% data variables.product.prodname_code_scanning %} results on pull requests + +In repositories where {% data variables.product.prodname_code_scanning %} is configured as a pull request check, {% data variables.product.prodname_code_scanning %} checks the code in the pull request. By default, this is limited to pull requests that target the default branch or protected branches, but you can change this configuration within {% data variables.product.prodname_actions %} or in a third-party CI/CD system. If merging the changes would introduce new {% data variables.product.prodname_code_scanning %} alerts to the target branch, these are reported as check results in the pull request. The alerts are also shown as annotations in the **Files changed** tab of the pull request. If you have write permission for the repository, you can see any existing {% data variables.product.prodname_code_scanning %} alerts on the **Security** tab. For information about repository alerts, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." + +If {% data variables.product.prodname_code_scanning %} has any results with a severity of `error`, the check fails and the error is reported in the check results. If all the results found by {% data variables.product.prodname_code_scanning %} have lower severities, the alerts are treated as warnings or notices and the check succeeds. If your pull request targets a protected branch, and the repository owner has configured required status checks, then you must either fix or close any error alerts before the pull request can be merged. 更多信息请参阅“[关于必要的状态检查](/github/administering-a-repository/about-required-status-checks)”。 + +![Example pull request check status with {% data variables.product.prodname_code_scanning %} alert](/assets/images/help/repository/code-scanning-check-failure.png) + +### About {% data variables.product.prodname_code_scanning %} as a pull request check + +There are many options for configuring {% data variables.product.prodname_code_scanning %} as a pull request check, so the exact setup of each repository will vary and some will have more than one check. The check that contains the results of {% data variables.product.prodname_code_scanning %} is: **Code scanning results**. + +If the repository uses the {% data variables.product.prodname_codeql_workflow %} a **{% data variables.product.prodname_codeql %} / Analyze (LANGUAGE)** check is run for each language before the results check runs. The analysis check may fail if there are configuration problems, or if the pull request breaks the build for a language that the analysis needs to compile (for example, C/C++, C#, or Java). As with other pull request checks, you can see full details of the check failure on the **Checks** tab. For more information about configuring and troubleshooting, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" or "[Troubleshooting {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning)." + +### Triaging an alert on your pull request + +When you look at the **Files changed** tab for a pull request, you see annotations for any lines of code that triggered the alert. + +![Example {% data variables.product.prodname_code_scanning %} alert shown as an annotation in the "Files changed" view of a pull request](/assets/images/help/repository/code-scanning-pr-annotation.png) + +Some annotations contain links with extra context for the alert. In the example above, from {% data variables.product.prodname_codeql %} analysis, you can click **user-provided value** to see where the untrusted data enters the data flow (this is referred to as the source). In this case you can view the full path from the source to the code that uses the data (the sink) by clicking **Show paths**. This makes it easy to check whether the data is untrusted or if the analysis failed to recognize a data sanitization step between the source and the sink. For information about analyzing data flow using {% data variables.product.prodname_codeql %}, see "[About data flow analysis](https://help.semmle.com/QL/learn-ql/intro-to-data-flow.html)." + +For more information about an alert, click **Show more details** on the annotation. This allows you to see all of the context and metadata provided by the tool in an alert view. In the example below, you can see tags showing the severity, type, and relevant common weakness enumerations (CWEs) for the problem. The view also shows which commit introduced the problem. + +Alerts from some tools, like {% data variables.product.prodname_codeql %}, also include a description and a **Show more** link for guidance on how to fix the problem in the code. + +![Example of "Show more details" for a {% data variables.product.prodname_code_scanning %} alert in a pull request](/assets/images/help/repository/code-scanning-pr-alert.png) + +### Resolving an alert on your pull request + +Anyone with write permission for a repository can resolve alerts on a pull request. If you commit changes to the pull request this triggers a new run of the pull request checks. If your changes fix the problem, the alert is resolved and the annotation removed. + +If you don't think that an alert needs to be fixed, you can close the alert manually. {% data reusables.code-scanning.close-alert-examples %} The **Close** button is available in annotations and in the alerts view if you have write permission for the repository. + +{% data reusables.code-scanning.false-positive-fix-codeql %} diff --git a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md new file mode 100644 index 000000000000..93dc769fe527 --- /dev/null +++ b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-codeql-code-scanning-in-your-ci-system.md @@ -0,0 +1,52 @@ +--- +title: Troubleshooting CodeQL code scanning in your CI system +shortTitle: Troubleshooting in your CI +intro: 'If you''re having problems with the {% data variables.product.prodname_codeql_runner %}, you can troubleshoot by using these tips.' +product: '{% data reusables.gated-features.code-scanning %}' +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning-in-your-ci-system +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta-codeql-runner %} +{% data reusables.code-scanning.beta %} + +### The `init` command takes too long + +Before the {% data variables.product.prodname_codeql_runner %} can build and analyze code, it needs access to the {% data variables.product.prodname_codeql %} bundle, which contains the {% data variables.product.prodname_codeql %} CLI and the {% data variables.product.prodname_codeql %} libraries. + +When you use the {% data variables.product.prodname_codeql_runner %} for the first time on your machine, the `init` command downloads the {% data variables.product.prodname_codeql %} bundle to your machine. This download can take a few minutes. The {% data variables.product.prodname_codeql %} bundle is cached between runs, so if you use the {% data variables.product.prodname_codeql_runner %} again on the same machine, it won't download the {% data variables.product.prodname_codeql %} bundle again. + +To avoid this automatic download, you can manually download the {% data variables.product.prodname_codeql %} bundle to your machine and specify the path using the `--codeql-path` flag of the `init` command. + +### 构建过程中找不到代码 + +If the `analyze` command for the {% data variables.product.prodname_codeql_runner %} fails with an error `No source code was seen during the build`, this indicates that {% data variables.product.prodname_codeql %} was unable to monitor your code. Several reasons can explain such a failure. + +1. 自动语言检测发现了受支持的语言，但仓库中没有该语言的可分析代码。 一个典型的例子是，我们的语言检测服务发现了一个与特定的编程语言相关的文件，例如 `.h` 或 `.gyp` 文件，但仓库中没有相应的可执行代码。 To solve the problem, you can manually define the languages you want to analyze by using the `--languages` flag of the `init` command. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system)." + +1. You're analyzing a compiled language without using the `autobuild` command and you run the build steps yourself after the `init` step. For the build to work, you must set up the environment such that the {% data variables.product.prodname_codeql_runner %} can monitor the code. The `init` command generates instructions for how to export the required environment variables, so you can copy and run the script after you've run the `init` command. + - On macOS and Linux: + ```shell + $ . codeql-runner/codeql-env.sh + ``` + - On Windows, using the Command shell (`cmd`) or a batch file (`.bat`): + ```shell + > call codeql-runner\codeql-env.bat + ``` + - On Windows, using PowerShell: + ```shell + > cat codeql-runner\codeql-env.sh | Invoke-Expression + ``` + + The environment variables are also stored in the file `codeql-runner/codeql-env.json`. This file contains a single JSON object which maps environment variable keys to values. If you can't run the script generated by the `init` command, then you can use the data in JSON format instead. + + {% note %} + + **Note:** If you used the `--temp-dir` flag of the `init` command to specify a custom directory for temporary files, the path to the `codeql-env` files might be different. + + {% endnote %} + +1. The code is built in a container or on a separate machine. If you use a containerized build or if you outsource the build to another machine, make sure to run the {% data variables.product.prodname_codeql_runner %} in the container or on the machine where your build task takes place. diff --git a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md new file mode 100644 index 000000000000..f42dbb3db617 --- /dev/null +++ b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-the-codeql-workflow.md @@ -0,0 +1,125 @@ +--- +title: Troubleshooting the CodeQL workflow +shortTitle: Troubleshooting CodeQL +intro: 'If you''re having problems with {% data variables.product.prodname_code_scanning %}, you can troubleshoot by using these tips for resolving issues.' +product: '{% data reusables.gated-features.code-scanning %}' +redirect_from: + - /github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta %} + +### Automatic build for a compiled language fails + +If an automatic build of code for a compiled language within your project fails, try the following troubleshooting steps. + +- Remove the `autobuild` step from your {% data variables.product.prodname_code_scanning %} workflow and add specific build steps. For information about editing the workflow, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)." For more information about replacing the `autobuild` step, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." + +- If your workflow doesn't explicitly specify the languages to analyze, {% data variables.product.prodname_codeql %} implicitly detects the supported languages in your code base. In this configuration, out of the compiled languages C/C++, C#, and Java, {% data variables.product.prodname_codeql %} only analyzes the language with the most source files. Edit the workflow and add a build matrix specifying the languages you want to analyze. The default CodeQL analysis workflow uses such a matrix. + + The following extracts from a workflow show how you can use a matrix within the job strategy to specify languages, and then reference each language within the "Initialize {% data variables.product.prodname_codeql %}" step: + + ```yaml + jobs: + analyze: + ... + strategy: + fail-fast: false + matrix: + language: ['csharp', 'cpp', 'javascript'] + + ... + + - name: Initialize {% data variables.product.prodname_codeql %} + uses: github/codeql-action/init@v1 + with: + languages: {% raw %}${{ matrix.language }}{% endraw %} + ``` + + For more information about editing the workflow, see "[Configuring code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." + +### No code found during the build + +If your workflow fails with an error `No source code was seen during the build` or `The process '/opt/hostedtoolcache/CodeQL/0.0.0-20200630/x64/codeql/codeql' failed with exit code 32`, this indicates that {% data variables.product.prodname_codeql %} was unable to monitor your code. Several reasons can explain such a failure: + +1. Automatic language detection identified a supported language, but there is no analyzable code of that language in the repository. A typical example is when our language detection service finds a file associated with a particular programming language like a `.h`, or `.gyp` file, but no corresponding executable code is present in the repository. To solve the problem, you can manually define the languages you want to analyze by updating the list of languages in the `language` matrix. For example, the following configuration will analyze only Go, and JavaScript. + + ```yaml + strategy: + fail-fast: false + matrix: + # Override automatic language detection by changing the list below + # Supported options are: + # ['csharp', 'cpp', 'go', 'java', 'javascript', 'python'] + language: ['go', 'javascript'] + ``` +For more information, see the workflow extract in "[Automatic build for a compiled language fails](#automatic-build-for-a-compiled-language-fails)" above. +1. Your {% data variables.product.prodname_code_scanning %} workflow is analyzing a compiled language (C, C++, C#, or Java), but the code was not compiled. By default, the {% data variables.product.prodname_codeql %} analysis workflow contains an `autobuild` step, however, this step represents a best effort process, and may not succeed in building your code, depending on your specific build environment. Compilation may also fail if you have removed the `autobuild` step and did not include build steps manually. For more information about specifying build steps, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." +1. Your workflow is analyzing a compiled language (C, C++, C#, or Java), but portions of your build are cached to improve performance (most likely to occur with build systems like Gradle or Bazel). Since {% data variables.product.prodname_codeql %} observes the activity of the compiler to understand the data flows in a repository, {% data variables.product.prodname_codeql %} requires a complete build to take place in order to perform analysis. +1. Your workflow is analyzing a compiled language (C, C++, C#, or Java), but compilation does not occur between the `init` and `analyze` steps in the workflow. {% data variables.product.prodname_codeql %} requires that your build happens in between these two steps in order to observe the activity of the compiler and perform analysis. +1. Your compiled code (in C, C++, C#, or Java) was compiled successfully, but {% data variables.product.prodname_codeql %} was unable to detect the compiler invocations. The most common causes are certain configuration options like running your build process in a container, if you're building using a distributed build system external to {% data variables.product.prodname_actions %} using a daemon process, or if {% data variables.product.prodname_codeql %} isn't aware of the specific compiler you are using. + + For C# projects using either `dotnet build` or `msbuild` which target .NET Core 2, you should specify `/p:UseSharedCompilation=false` in your workflow's `run` step, when you build your code. The `UseSharedCompilation` flag isn't necessary for .NET Core 3.0 and later. + + For example, the following configuration for C# will pass the flag during the first build step. + + ``` yaml + - run: | + dotnet build /p:UseSharedCompilation=false + ``` + + If you encounter another problem with your specific compiler or configuration, contact {% data variables.contact.contact_support %}. + +For more information about specifying build steps, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." + +### Portions of my repository were not analyzed using `autobuild` + +The {% data variables.product.prodname_codeql %} `autobuild` feature uses heuristics to build the code in a repository, however, sometimes this approach results in incomplete analysis of a repository. For example, when multiple `build.sh` commands exist in a single repository, the analysis may not complete since the `autobuild` step will only execute one of the commands. The solution is to replace the `autobuild` step with build steps which build all of the source code which you wish to analyze. For more information, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." + +### Error: "Server error" + +If the run of a workflow for {% data variables.product.prodname_code_scanning %} fails due to a server error, try running the workflow again. If the problem persists, contact {% data variables.contact.contact_support %}. + +### Error: "Out of disk" or "Out of memory" + +On very large projects, {% data variables.product.prodname_codeql %} may run out of disk or memory on the runner. +{% if currentVersion == "free-pro-team@latest" %}If you encounter this issue on a hosted {% data variables.product.prodname_actions %} runner, contact {% data variables.contact.contact_support %} so that we can investigate the problem. +{% else %}If you encounter this issue, try increasing the memory on the runner.{% endif %} + +### The build takes too long + +If your build with {% data variables.product.prodname_codeql %} analysis takes too long to run, there are several approaches you can try to reduce the build time. + +#### Increase the memory or cores + +If you use self-hosted runners to run {% data variables.product.prodname_codeql %} analysis, you can increase the memory or the number of cores on those runners. + +#### Use matrix builds to parallelize the analysis + +The default {% data variables.product.prodname_codeql_workflow %} uses a build matrix of languages, which causes the analysis of each language to run in parallel. If you have specified the languages you want to analyze directly in the "Initialize CodeQL" step, analysis of each language will happen sequentially. To speed up analysis of multiple languages, modify your workflow to use a matrix. For more information, see the workflow extract in "[Automatic build for a compiled language fails](#automatic-build-for-a-compiled-language-fails)" above. + +#### Reduce the amount of code being analyzed in a single workflow + +Analysis time is typically proportional to the amount of code being analyzed. You can reduce the analysis time by reducing the amount of code being analyzed at once, for example, by excluding test code, or breaking analysis into multiple workflows that analyze only a subset of your code at a time. + +For compiled languages like Java, C, C++, and C#, {% data variables.product.prodname_codeql %} analyzes all of the code which was built during the workflow run. To limit the amount of code being analyzed, build only the code which you wish to analyze by specifying your own build steps in a `run` block. You can combine specifying your own build steps with using the `paths` or `paths-ignore` filters on the `pull_request` and `push` events to ensure that your workflow only runs when specific code is changed. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)." + +For interpreted languages like Go, JavaScript, Python, and TypeScript, that {% data variables.product.prodname_codeql %} analyzes without a specific build, you can specify additional configuration options to limit the amount of code to analyze. For more information, see "[Specifying directories to scan](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#specifying-directories-to-scan)." + +If you split your analysis into multiple workflows as described above, we still recommend that you have at least one workflow which runs on a `schedule` which analyzes all of the code in your repository. Because {% data variables.product.prodname_codeql %} analyzes data flows between components, some complex security behaviors may only be detected on a complete build. + +#### Run only during a `schedule` event + +If your analysis is still too slow to be run during `push` or `pull_request` events, then you may want to only trigger analysis on the `schedule` event. For more information, see "[Events](/actions/learn-github-actions/introduction-to-github-actions#events)." + +{% if currentVersion == "free-pro-team@latest" %} +### Results differ between analysis platforms + +If you are analyzing code written in Python, you may see different results depending on whether you run the {% data variables.product.prodname_codeql_workflow %} on Linux, macOS, or Windows. + +On GitHub-hosted runners that use Linux, the {% data variables.product.prodname_codeql_workflow %} tries to install and analyze Python dependencies, which could lead to more results. To disable the auto-install, add `setup-python-dependencies: false` to the "Initialize CodeQL" step of the workflow. For more information about configuring the analysis of Python dependencies, see "[Analyzing Python dependencies](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#analyzing-python-dependencies)." + +{% endif %} \ No newline at end of file diff --git a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md index 6afa65c3baf6..329c7194e482 100644 --- a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md +++ b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/uploading-a-sarif-file-to-github.md @@ -16,22 +16,22 @@ versions: ### 关于 {% data variables.product.prodname_code_scanning %} 的 SARIF 文件上传 -{% data variables.product.prodname_dotcom %} creates {% data variables.product.prodname_code_scanning %} alerts in a repository using information from Static Analysis Results Interchange Format (SARIF) files. SARIF 文件可通过在用于上传文件的 {% data variables.product.prodname_actions %} 工作流程中运行的 SARIF 兼容分析工具生成。 或者，当文件生成为仓库外部的构件时， 您可以直接将 SARIF 文件推送到仓库，并使用工作流程上传 SARIF 文件。 更多信息请参阅“[管理来自 {% data variables.product.prodname_code_scanning %} 的警报](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)”。 +{% data variables.product.prodname_dotcom %} 使用静态分析结果交换格式 (SARIF) 文件中的信息创建 {% data variables.product.prodname_code_scanning %} 警报。 SARIF 文件可通过在用于上传文件的 {% data variables.product.prodname_actions %} 工作流程中运行的 SARIF 兼容分析工具生成。 或者，当文件生成为仓库外部的构件时， 您可以直接将 SARIF 文件推送到仓库，并使用工作流程上传 SARIF 文件。 For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository)." -You can generate SARIF files using many static analysis security testing tools, including {% data variables.product.prodname_codeql %}. The results must use SARIF version 2.1.0. 更多信息请参阅“[关于代码扫描的 SARIF 支持](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-sarif-support-for-code-scanning)”。 +您可以使用许多静态分析安全测试工具来生成 SARIF 文件，包括 {% data variables.product.prodname_codeql %}。 结果必须使用 SARIF 版本 2.1.0。 更多信息请参阅“[关于代码扫描的 SARIF 支持](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-sarif-support-for-code-scanning)”。 -You can upload the results using {% data variables.product.prodname_actions %}{% if currentVersion == "enterprise-server@2.22" %} (available if your organization is taking part in the beta program){% endif %}, the {% data variables.product.prodname_code_scanning %} API, or the {% data variables.product.prodname_codeql_runner %}. The best upload method will depend on how you generate the SARIF file, for example, if you use: +You can upload the results using {% data variables.product.prodname_actions %}{% if currentVersion == "enterprise-server@2.22" %} (available if your organization is taking part in the beta program){% endif %}, the {% data variables.product.prodname_code_scanning %} API, or the {% data variables.product.prodname_codeql_runner %}. 最佳上传方法将取决于您如何生成 SARIF 文件，例如，如果您使用： -- {% data variables.product.prodname_actions %} to run the {% data variables.product.prodname_codeql %} action, there is no further action required. The {% data variables.product.prodname_codeql %} action uploads the SARIF file automatically when it completes analysis. +- {% data variables.product.prodname_actions %} 来运行 {% data variables.product.prodname_codeql %} 操作，则无需进一步操作。 {% data variables.product.prodname_codeql %} 操作在完成分析后自动上传 SARIF 文件。 - "[管理工作流程运行](/actions/configuring-and-managing-workflows/managing-a-workflow-run#viewing-your-workflow-history)" -- {% data variables.product.prodname_dotcom %} 将在仓库中显示来自上传的 SARIF 文件的 {% data variables.product.prodname_code_scanning %} 警报。 更多信息请参阅“[管理来自 {% data variables.product.prodname_code_scanning %} 的警报](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)”。 -- A tool that generates results as an artifact outside of your repository, you can use the {% data variables.product.prodname_code_scanning %} API to upload the file (for more information, see "[Upload a SARIF file](/rest/reference/code-scanning#upload-a-sarif-file)"). +- {% data variables.product.prodname_dotcom %} 将在仓库中显示来自上传的 SARIF 文件的 {% data variables.product.prodname_code_scanning %} 警报。 If you block the automatic upload, when you are ready to upload results you can use the `upload` command (for more information, see "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)"). +- 作为仓库外部构件生成结果的工具，您可以使用 {% data variables.product.prodname_code_scanning %} API 上传文件（更多信息请参阅“[上传 SARIF 文件](/rest/reference/code-scanning#upload-a-sarif-file)”）。 ### 通过 {% data variables.product.prodname_actions %} 上传 {% data variables.product.prodname_code_scanning %} 分析 -要将第三方 SARIF 文件上传到 {% data variables.product.prodname_dotcom %}，需要 {% data variables.product.prodname_actions %} 工作流程。 更多信息请参阅“[关于 {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)”和“[配置工作流程](/actions/configuring-and-managing-workflows/configuring-a-workflow)”。 +要将第三方 SARIF 文件上传到 {% data variables.product.prodname_dotcom %}，需要 {% data variables.product.prodname_actions %} 工作流程。 For more information, see "[Learn {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)" and "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." -您的工作流需要使用 `upload-sarif` 操作，该操作包含可用于配置上传的输入参数。 It has input parameters that you can use to configure the upload. 您将要使用的主要输入参数是 `sarif-file`，它会配置要上传的文件或 SARIF 文件的目录。 目录或文件路径相对于仓库的根目录。 更多信息请参阅 [`upload-sarif` 操作](https://github.com/github/codeql-action/tree/HEAD/upload-sarif)。 +您的工作流需要使用 `upload-sarif` 操作，该操作包含可用于配置上传的输入参数。 它包含可用于配置上传的输入参数。 您将要使用的主要输入参数是 `sarif-file`，它会配置要上传的文件或 SARIF 文件的目录。 目录或文件路径相对于仓库的根目录。 更多信息请参阅 [`upload-sarif` 操作](https://github.com/github/codeql-action/tree/HEAD/upload-sarif)。 `upload-sarif` 操作可配置为在 `push` and `scheduled` 事件发生时运行。 有关 {% data variables.product.prodname_actions %} 事件的更多信息，请参阅“[触发工作流程的事件](/actions/reference/events-that-trigger-workflows)”。 @@ -43,7 +43,7 @@ You can upload the results using {% data variables.product.prodname_actions %}{% 只要提交被推送到仓库，此示例工作流程就会运行。 该操作使用 `partialFingerprints` 属性来确定是否发生了更改。 除了推送提交时运行之外，工作流程还预定每周运行一次。 更多信息请参阅“[触发工作流程的事件](/actions/reference/events-that-trigger-workflows)”。 -此工作流上传位于仓库根目录中的 `results.sarif` 文件。 有关创建工作流程文件的更多信息，请参阅“[配置工作流程](/actions/configuring-and-managing-workflows/configuring-a-workflow)”。 +此工作流上传位于仓库根目录中的 `results.sarif` 文件。 For more information about creating a workflow file, see "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)." 或者，您也可以修改此工作流程以上传 SARIF 文件的目录。 例如，您可以将所有 SARIF 文件放在仓库根目录中的 `sarif-output` 目录中，并将操作的输入参数 `sarif_file` 设置为 `sarif-output`。 @@ -73,11 +73,11 @@ jobs: #### 运行 ESLint 分析工具的示例工作流程 -如果将第三方 SARIF 文件生成为持续集成 (CI) 工作流程的一部分，您可以将 `upload-sarif` 操作添加为运行 CI 测试后的一个步骤。 如果您还没有 CI 工作流程，可以使用 {% data variables.product.prodname_actions %} 模板创建一个。 更多信息请参阅“[从预配置的工作流程模板开始](/actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates)”。 +如果将第三方 SARIF 文件生成为持续集成 (CI) 工作流程的一部分，您可以将 `upload-sarif` 操作添加为运行 CI 测试后的一个步骤。 如果您还没有 CI 工作流程，可以使用 {% data variables.product.prodname_actions %} 模板创建一个。 更多信息请参阅“[{% data variables.product.prodname_actions %} 快速入门](/actions/quickstart)”。 只要提交被推送到仓库，此示例工作流程就会运行。 该操作使用 `partialFingerprints` 属性来确定是否发生了更改。 除了推送提交时运行之外，工作流程还预定每周运行一次。 更多信息请参阅“[触发工作流程的事件](/actions/reference/events-that-trigger-workflows)”。 -工作流程显示了将 ESLint 静态分析工具作为工作流程中一个步骤运行的示例。 `Run ESLint` 步骤运行 ESLint 工具，输出 `results.sarif` 文件。 然后，工作流程使用 `upload-sarif` 操作将 `results.sarif` 文件上传到 {% data variables.product.prodname_dotcom %}。 有关创建工作流程文件的更多信息，请参阅“[配置工作流程](/actions/configuring-and-managing-workflows/configuring-a-workflow)”。 +工作流程显示了将 ESLint 静态分析工具作为工作流程中一个步骤运行的示例。 `Run ESLint` 步骤运行 ESLint 工具，输出 `results.sarif` 文件。 然后，工作流程使用 `upload-sarif` 操作将 `results.sarif` 文件上传到 {% data variables.product.prodname_dotcom %}。 For more information about creating a workflow file, see "[Introduction to GitHub Actions](/actions/learn-github-actions/introduction-to-github-actions)." ```yml name: "ESLint analysis" @@ -108,7 +108,7 @@ jobs: ### 延伸阅读 -- "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions)" -- "[Managing a workflow run](/actions/configuring-and-managing-workflows/managing-a-workflow-run#viewing-your-workflow-history)" - "[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/reference/workflow-syntax-for-github-actions)" -- "[Upload a SARIF file](/rest/reference/code-scanning#upload-a-sarif-file)" +- "[查看工作流程历史记录](/actions/managing-workflow-runs/viewing-workflow-run-history)" +- "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)" +- "[上传 SARIF 文件](/rest/reference/code-scanning#upload-a-sarif-file)" diff --git a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md new file mode 100644 index 000000000000..af71f4047d5b --- /dev/null +++ b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system.md @@ -0,0 +1,11 @@ +--- +title: Using CodeQL code scanning with your existing CI system +shortTitle: CodeQL CI system support +intro: 'The {% data variables.product.prodname_codeql_runner %} allows you to use your existing CI system to run {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %}.' +mapTopic: true +product: '{% data reusables.gated-features.code-scanning %}' +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + diff --git a/translations/zh-CN/content/github/getting-started-with-github/access-permissions-on-github.md b/translations/zh-CN/content/github/getting-started-with-github/access-permissions-on-github.md index 107b081f7fef..5eb29e15a5e5 100644 --- a/translations/zh-CN/content/github/getting-started-with-github/access-permissions-on-github.md +++ b/translations/zh-CN/content/github/getting-started-with-github/access-permissions-on-github.md @@ -5,7 +5,7 @@ redirect_from: - /articles/what-are-the-different-types-of-team-permissions/ - /articles/what-are-the-different-access-permissions/ - /articles/access-permissions-on-github -intro: 您可以授权协作者对个人仓库的读取/写入权限，但组织成员对组织的仓库可有更细致的访问权限。 +intro: '您可以授权协作者对个人仓库的读取/写入权限，但组织成员对组织的仓库可有更细致的访问权限。' versions: free-pro-team: '*' enterprise-server: '*' @@ -17,7 +17,7 @@ versions: ### 组织帐户 -组织成员可以是*所有者*{% if currentVersion == "free-pro-team@latest" %}、*帐单管理员*{% endif %}或*成员*角色。 所有者对组织具有完全管理权限{% if currentVersion == "free-pro-team@latest" %}，而帐单管理员负责管理帐单设置{% endif %}。 成员是其他每个人的默认角色。 您可以通过团队一次管理多个成员的访问权限。 更多信息请参阅： +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 %}. 成员是其他每个人的默认角色。 您可以通过团队一次管理多个成员的访问权限。 更多信息请参阅： - "[组织的权限级别](/articles/permission-levels-for-an-organization)" - "[组织的项目板权限](/articles/project-board-permissions-for-an-organization)" - "[组织的仓库权限级别](/articles/repository-permission-levels-for-an-organization)" diff --git a/translations/zh-CN/content/github/getting-started-with-github/be-social.md b/translations/zh-CN/content/github/getting-started-with-github/be-social.md index 7ae2d716185d..59c447dc2cb8 100644 --- a/translations/zh-CN/content/github/getting-started-with-github/be-social.md +++ b/translations/zh-CN/content/github/getting-started-with-github/be-social.md @@ -21,7 +21,7 @@ versions: ### 关注仓库 -您可以关注仓库以接收有关新拉取请求和议题的通知。 当所有者更新仓库时，您将在个人仪表板中看到其更改。 更多信息请参阅{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}“[查看您的订阅](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions){% else %}”[关注和取消关注仓库](/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories){% endif %}”。 +您可以关注仓库以接收有关新拉取请求和议题的通知。 当所有者更新仓库时，您将在个人仪表板中看到其更改。 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 %}." 在仓库顶部单击 **Watch（关注）**可关注它。 diff --git a/translations/zh-CN/content/github/getting-started-with-github/create-a-repo.md b/translations/zh-CN/content/github/getting-started-with-github/create-a-repo.md index a9c679056391..4ca2aae18cf8 100644 --- a/translations/zh-CN/content/github/getting-started-with-github/create-a-repo.md +++ b/translations/zh-CN/content/github/getting-started-with-github/create-a-repo.md @@ -19,7 +19,9 @@ versions: {% data reusables.repositories.create_new %} 2. 为仓库键入简短、令人难忘的名称。 例如 "hello-world"。 ![用于输入仓库名称的字段](/assets/images/help/repository/create-repository-name.png) -3. （可选）添加仓库的说明。 例如，“我在 {% data variables.product.product_name %} 上的第一个仓库”。 ![用于输入仓库说明的字段](/assets/images/help/repository/create-repository-desc.png) +3. （可选）添加仓库的说明。 For example, "My first repository on +{% data variables.product.product_name %}。" + ![用于输入仓库说明的字段](/assets/images/help/repository/create-repository-desc.png) {% data reusables.repositories.choose-repo-visibility %} {% data reusables.repositories.initialize-with-readme %} {% data reusables.repositories.create-repo %} @@ -29,7 +31,7 @@ versions: {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} {% tip %} -**Tip**: You can also create repositories using the {% data variables.product.prodname_cli %}. For more information, see "[`gh repo create`](https://cli.github.com/manual/gh_repo_create)" in the {% data variables.product.prodname_cli %} documentation. +**提示**：您也可以使用 {% data variables.product.prodname_cli %} 创建仓库。 更多信息请参阅 {% data variables.product.prodname_cli %} 文档中的“[`gh 仓库创建`](https://cli.github.com/manual/gh_repo_create)”。 {% endtip %} {% endif %} diff --git a/translations/zh-CN/content/github/getting-started-with-github/exploring-early-access-releases-with-feature-preview.md b/translations/zh-CN/content/github/getting-started-with-github/exploring-early-access-releases-with-feature-preview.md index e46e16412344..7c751c4c8be5 100644 --- a/translations/zh-CN/content/github/getting-started-with-github/exploring-early-access-releases-with-feature-preview.md +++ b/translations/zh-CN/content/github/getting-started-with-github/exploring-early-access-releases-with-feature-preview.md @@ -14,7 +14,7 @@ versions: | 阶段 | 描述 | | ------- | --------------------------------------------------------------------------------------------- | | Alpha | 产品或功能正在大量开发中，要求和范围通常不断变化。 此功能可用于演示和测试目的，但可能不会形成文档。 Alpha 版本功能不一定完整，不提供服务水平协议 (SLA)，也没有技术支持义务。 | -| Beta | 产品或功能已准备好进行更广泛的分发。 Beta 版本可以是公共版本或私有版本，会形成文档，但没有任何 SLA 或技术支持义务。 | +| 测试版 | 产品或功能已准备好进行更广泛的分发。 Beta 版本可以是公共版本或私有版本，会形成文档，但没有任何 SLA 或技术支持义务。 | | 通用 (GA) | 产品或功能经过全面测试，并公开向所有用户开放。 GA 版本已经可以用于生产，具有相关的 SLA 和技术支持义务。 | ### 通过功能预览了解发行版 diff --git a/translations/zh-CN/content/github/getting-started-with-github/faq-about-changes-to-githubs-plans.md b/translations/zh-CN/content/github/getting-started-with-github/faq-about-changes-to-githubs-plans.md index 82fd8e8bb60b..1f29e9581521 100644 --- a/translations/zh-CN/content/github/getting-started-with-github/faq-about-changes-to-githubs-plans.md +++ b/translations/zh-CN/content/github/getting-started-with-github/faq-about-changes-to-githubs-plans.md @@ -1,6 +1,6 @@ --- title: 有关 GitHub 计划变更的常见问题解答 -intro: GitHub 宣布，从 2020 年 4 月 14 日起，向所有人免费提供所有核心 GitHub 功能。 +intro: 'GitHub 宣布，从 2020 年 4 月 14 日起，向所有人免费提供所有核心 GitHub 功能。' versions: free-pro-team: '*' --- @@ -83,8 +83,8 @@ GitHub Community Support 包括通过我们的[社区论坛](https://github.comm 如果您目前是发票客户，请向您的销售代表发送电子邮件以获取更多信息。 如果不确定您的销售代表是谁，请联系您的帐单管理员或帐户所有者。 -### How will this impact users and organizations in regions where U.S. government sanctions are applied? government sanctions are applied? +### How will this impact users and organizations in regions where U.S. government sanctions are applied? 政府制裁是否适用？ -Due to U.S. 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. 请阅读 [GitHub 和贸易管制](https://help.github.com/github/site-policy/github-and-trade-controls)了解更多信息。 sanctioned regions. 但是，GitHub 保留了对免费公共仓库服务的使用权。 请阅读 [GitHub 和贸易管制](/github/site-policy/github-and-trade-controls)了解更多信息。 +由于美国 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. 请阅读 [GitHub 和贸易管制](https://help.github.com/github/site-policy/github-and-trade-controls)了解更多信息。 受制裁区域。 但是，GitHub 保留了对免费公共仓库服务的使用权。 请阅读 [GitHub 和贸易管制](/github/site-policy/github-and-trade-controls)了解更多信息。 -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. regulators for the greatest possible access to free code collaboration services to developers in sanctioned regions, including free private repositories. 我们认为，提供这些免费服务有助于美国关于鼓励这些地区的信息自由流动和言论自由的外交政策。 foreign policy of encouraging the free flow of information and free speech in those regions. +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. 监管机构提倡让受制裁地区的开发者尽可能获得免费代码协作服务，包括访问免费私有仓库。 我们认为，提供这些免费服务有助于美国关于鼓励这些地区的信息自由流动和言论自由的外交政策。 关于鼓励这些市场的信息自由流动和言论自由的外交政策。 diff --git a/translations/zh-CN/content/github/getting-started-with-github/following-people.md b/translations/zh-CN/content/github/getting-started-with-github/following-people.md index e1002c0f4db1..783e495b4abd 100644 --- a/translations/zh-CN/content/github/getting-started-with-github/following-people.md +++ b/translations/zh-CN/content/github/getting-started-with-github/following-people.md @@ -1,6 +1,6 @@ --- title: 关注他人 -intro: '您可以在 {% data variables.product.product_name %} 上关注他人，以接收有关其活动的通知{% if currentVersion == "free-pro-team@latest" %} 和发现其社区中的项目{% endif %}。' +intro: 'You can follow people on {% 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: @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -关注他人后，您将在消息馈送的活动视图中看到其公开活动。{% if currentVersion == "free-pro-team@latest" %}如果您关注的人标注了某个公共仓库，{% data variables.product.product_name %} 可能会在您的消息馈送发现视图中向您推荐该仓库。{% endif %}要关注某人，请访问其个人资料页面，然后在其个人资料图像下面单击 **Follow（关注）**。 +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, {% 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. ![关注用户按钮](/assets/images/help/profile/follow-user-button.png) diff --git a/translations/zh-CN/content/github/getting-started-with-github/fork-a-repo.md b/translations/zh-CN/content/github/getting-started-with-github/fork-a-repo.md index 8bedd21a8016..6282f4617d1e 100644 --- a/translations/zh-CN/content/github/getting-started-with-github/fork-a-repo.md +++ b/translations/zh-CN/content/github/getting-started-with-github/fork-a-repo.md @@ -18,7 +18,7 @@ versions: - 复刻仓库 - 进行修复 -- Submit a pull request to the project owner. +- 向项目所有者提交拉取请求。 #### 将其他人的项目用作自己创意的起点。 @@ -37,7 +37,7 @@ versions: {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} {% tip %} -**Tip**: You can also fork a repository using the {% data variables.product.prodname_cli %}. For more information, see "[`gh repo fork`](https://cli.github.com/manual/gh_repo_fork)" in the {% data variables.product.prodname_cli %} documentation. +**提示**：您也可以使用 {% data variables.product.prodname_cli %} 复刻仓库。 更多信息请参阅 {% data variables.product.prodname_cli %} 文档中的“[`gh 仓库复刻`](https://cli.github.com/manual/gh_repo_fork)”。 {% endtip %} {% endif %} @@ -59,9 +59,11 @@ versions: #### 第 2 步：创建复刻的本地克隆 -现在，您有了 Spoon-Knife 仓库的复刻，但您的计算机上还没有该仓库中的文件。 Let's create a clone of your fork locally on your computer. +现在，您有了 Spoon-Knife 仓库的复刻，但您的计算机上还没有该仓库中的文件。 让我们在计算机上本地创建复刻的克隆。 -1. 在 {% data variables.product.product_name %} 上，导航到 Spoon-Knife 仓库的**复刻**。 +1. 在 + +{% data variables.product.product_name %}, navigate to **your fork** of the Spoon-Knife repository. {% data reusables.repositories.copy-clone-url %} {% data reusables.command_line.open_the_multi_os_terminal %} {% data reusables.command_line.change-current-directory-clone %} @@ -86,7 +88,9 @@ versions: 为了对原始仓库提议更改而复刻项目时，您可以配置 Git 以将更改从原始或上游仓库拉取到复刻的本地克隆。 -1. 在 {% data variables.product.product_name %} 上，导航到 [octocat/Spoon-Knife](https://github.com/octocat/Spoon-Knife) 仓库。 +1. 在 + +{% data variables.product.product_name %}, navigate to the [octocat/Spoon-Knife](https://github.com/octocat/Spoon-Knife) repository. {% data reusables.repositories.copy-clone-url %} {% data reusables.command_line.open_the_multi_os_terminal %} 4. 将目录更改为您在[第 2 步：创建复刻的本地克隆](#step-2-create-a-local-clone-of-your-fork)中克隆复刻的位置。 @@ -128,7 +132,7 @@ versions: 复刻仓库，开始参与项目。 {% data reusables.repositories.you-can-fork %} -{% if currentVersion == "free-pro-team@latest" %}您可以浏览 [Explore](https://github.com/explore) 以查找项目并开始参与开源仓库。 更多信息请参阅“[寻找在 {% data variables.product.prodname_dotcom %} 上参与开源项目的方法](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)”。 +{% if currentVersion == "free-pro-team@latest" %}You can browse [Explore](https://github.com/explore) to find projects and start contributing to open source repositories. 更多信息请参阅“[寻找在 {% data variables.product.prodname_dotcom %} 上参与开源项目的方法](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)”。 {% endif %} diff --git a/translations/zh-CN/content/github/getting-started-with-github/git-and-github-learning-resources.md b/translations/zh-CN/content/github/getting-started-with-github/git-and-github-learning-resources.md index 9ff58126f9da..bf01c797e6ed 100644 --- a/translations/zh-CN/content/github/getting-started-with-github/git-and-github-learning-resources.md +++ b/translations/zh-CN/content/github/getting-started-with-github/git-and-github-learning-resources.md @@ -54,6 +54,6 @@ versions: [Code School](http://codeschool.com) 的互动式[在线 Git 课程](http://www.codeschool.com/courses/git-real)有七个等级，以有趣的游戏形式提供数十个练习。 您可以自由调整 [.gitignore 模板](https://github.com/github/gitignore)以满足您的需求。 -通过{% if currentVersion == "free-pro-team@latest" %}[集成](/articles/about-integrations){% else %}集成{% endif %}或通过安装 [{% data variables.product.prodname_desktop %}](https://desktop.github.com) 和强大的 [Atom](https://atom.io) 文本编辑器来扩展您的 {% data variables.product.prodname_dotcom %} 的作用范围。 +Extend your {% data variables.product.prodname_dotcom %} reach through {% if currentVersion == "free-pro-team@latest" %}[integrations](/articles/about-integrations){% else %}integrations{% endif %}, or by installing [{% data variables.product.prodname_desktop %}](https://desktop.github.com) and the robust [Atom](https://atom.io) text editor. 通过[开源指南](https://opensource.guide/)了解如何启动和发展您的开源项目。 diff --git a/translations/zh-CN/content/github/getting-started-with-github/github-cli.md b/translations/zh-CN/content/github/getting-started-with-github/github-cli.md index 980319fcb1c2..58672bd0a2d1 100644 --- a/translations/zh-CN/content/github/getting-started-with-github/github-cli.md +++ b/translations/zh-CN/content/github/getting-started-with-github/github-cli.md @@ -1,6 +1,6 @@ --- title: GitHub CLI -intro: 'The {% data variables.product.prodname_cli %} is a command-line tool for using {% data variables.product.product_name %} features on your computer.' +intro: '{% data variables.product.prodname_cli %} 是用于在计算机上使用 {% data variables.product.product_name %} 功能的命令行工具。' versions: free-pro-team: '*' enterprise-server: '>2.19' @@ -8,14 +8,14 @@ versions: ### 关于 {% data variables.product.prodname_cli %} -{% data variables.product.prodname_cli %} is an open source tool for using {% data variables.product.product_name %} from your computer's command line. When you're working from the command line, you can use the {% data variables.product.prodname_cli %} to save time and avoid switching context. +{% data variables.product.prodname_cli %} 是用于从计算机的命令行使用 {% data variables.product.product_name %} 的开源工具。 从命令行操作时，您可以使用 {% data variables.product.prodname_cli %} 来节省时间并避免切换上下文。 -You can use the following {% data variables.product.prodname_dotcom %} features with the {% data variables.product.prodname_cli %}. +您可以将以下 {% data variables.product.prodname_dotcom %} 功能与 {% 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 +- 查看、创建、克隆和复刻仓库 +- 创建、关闭和列出议题和拉取请求 +- 审查、差异和合并拉取请求 +- 创建、编辑、列出和查看 Gist 有关 {% data variables.product.prodname_cli %} 用途的更多信息，请参阅 [{% data variables.product.prodname_cli %} 手册](https://cli.github.com/manual)。 diff --git a/translations/zh-CN/content/github/getting-started-with-github/github-desktop.md b/translations/zh-CN/content/github/getting-started-with-github/github-desktop.md index 27bfd365603f..252567aeb49c 100644 --- a/translations/zh-CN/content/github/getting-started-with-github/github-desktop.md +++ b/translations/zh-CN/content/github/getting-started-with-github/github-desktop.md @@ -10,7 +10,7 @@ versions: {% data reusables.desktop.about-github-desktop %} -For more information about {% data variables.product.prodname_desktop %}, see "[Installing and configuring {% data variables.product.prodname_desktop %}](/desktop/installing-and-configuring-github-desktop)" in the {% data variables.product.prodname_desktop %} documentation. +有关 {% data variables.product.prodname_desktop %} 的更多信息，请参阅 {% data variables.product.prodname_desktop %} 文档中的“[安装和配置 {% data variables.product.prodname_desktop %}](/desktop/installing-and-configuring-github-desktop)”。 ### 分享反馈 diff --git a/translations/zh-CN/content/github/getting-started-with-github/github-for-mobile.md b/translations/zh-CN/content/github/getting-started-with-github/github-for-mobile.md index b4baa0a13e70..70c3be634d9b 100644 --- a/translations/zh-CN/content/github/getting-started-with-github/github-for-mobile.md +++ b/translations/zh-CN/content/github/getting-started-with-github/github-for-mobile.md @@ -9,20 +9,30 @@ versions: {% data variables.product.prodname_mobile %} 目前作为 Android 和 iOS app 提供给 {% data variables.product.prodname_dotcom_the_website %} 用户。 -{% data variables.product.prodname_mobile %} gives you a way to do high-impact work on {% data variables.product.prodname_dotcom %} quickly and from anywhere. {% data variables.product.prodname_mobile %} is a safe and secure way to access your {% data variables.product.prodname_dotcom %} data through a trusted, first-party client application. +{% data variables.product.prodname_mobile %} 为您提供随时随地快速高效使用 {% data variables.product.prodname_dotcom %} 的方式。 {% data variables.product.prodname_mobile %} 是通过可信的第一方客户端应用程序访问 {% data variables.product.prodname_dotcom %} 数据的安全可靠方式。 -With {% data variables.product.prodname_mobile %} you can: +通过 {% data variables.product.prodname_mobile %}，您可以： - 管理、分类和清除通知 - 阅读、审查及协作处理问题和拉取请求 - 搜索、浏览用户、仓库和组织以及与之交互 - 当有人提及您的用户名时收到推送通知 -For more information about notifications for {% data variables.product.prodname_mobile %}, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#enabling-push-notifications-with-github-for-mobile)." +有关 {% data variables.product.prodname_mobile %} 通知的更多信息，请参阅“[配置通知](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#enabling-push-notifications-with-github-for-mobile)”。 ### 安装 {% data variables.product.prodname_mobile %} 要安装 Android 或 iOS 版 {% data variables.product.prodname_mobile %}，请参阅 [{% data variables.product.prodname_mobile %}](https://github.com/mobile)。 +### Supported languages for {% data variables.product.prodname_mobile %} + +{% data variables.product.prodname_mobile %} is available in the following languages. + +- 日语 +- Brazilian Portuguese +- 西班牙语 + +If you configure the language on your device to a supported language, {% data variables.product.prodname_mobile %} will default to the language. You can change the language for {% data variables.product.prodname_mobile %} in {% data variables.product.prodname_mobile %}'s **Settings** menu. + ### 管理 iOS 上 {% data variables.product.prodname_mobile %} 的通用链接 {% data variables.product.prodname_mobile %} 自动启用 iOS 的通用链接。 当您点击任何 {% data variables.product.product_name %} 链接时，目标 URL 都会在 {% data variables.product.prodname_mobile %} 中打开，而不是在 Safari 中打开。 更多信息请参阅 Apple Developer 网站上的[通用链接](https://developer.apple.com/ios/universal-links/)。 diff --git a/translations/zh-CN/content/github/getting-started-with-github/githubs-products.md b/translations/zh-CN/content/github/getting-started-with-github/githubs-products.md index 6c496b2ede49..b37bec54341a 100644 --- a/translations/zh-CN/content/github/getting-started-with-github/githubs-products.md +++ b/translations/zh-CN/content/github/getting-started-with-github/githubs-products.md @@ -70,9 +70,9 @@ versions: ### {% data variables.product.prodname_enterprise %} -{% data variables.product.prodname_enterprise %} includes two deployment options: cloud-hosted and self-hosted. +{% data variables.product.prodname_enterprise %} 包括两个部署选项：云托管和自托管。 -In addition to the features available with {% data variables.product.prodname_team %}, {% data variables.product.prodname_enterprise %} includes: +除了 {% data variables.product.prodname_team %} 的可用功能之外，{% data variables.product.prodname_enterprise %} 还包括： - {% data variables.contact.enterprise_support %} - 更多安全、合规和部署控件 - SAML 单点登录进行身份验证 @@ -86,17 +86,17 @@ In addition to the features available with {% data variables.product.prodname_te - 99.95% 月持续运行时间的服务等级协议 - 通过企业帐户集中管理多个 {% data variables.product.prodname_dotcom_the_website %} 组织的策略和帐单的选项。 更多信息请参阅“关于企业帐户”。 -You can set up a trial to evaluate {% data variables.product.prodname_ghe_cloud %}. 更多信息请参阅“[设置 {% data variables.product.prodname_ghe_cloud %} 的试用](/articles/setting-up-a-trial-of-github-enterprise-cloud)”。 +您可以设置试用版来评估 {% data variables.product.prodname_ghe_cloud %}。 更多信息请参阅“[设置 {% data variables.product.prodname_ghe_cloud %} 的试用](/articles/setting-up-a-trial-of-github-enterprise-cloud)”。 有关托管理您自己的 [{% data variables.product.prodname_ghe_server %}](https://enterprise.github.com) 实例的更多信息，请联系 {% data variables.contact.contact_enterprise_sales %}。 {% data reusables.enterprise_installation.request-a-trial %} ### {% data variables.product.prodname_ghe_one %} -{% data variables.product.prodname_ghe_one %} includes [{% data variables.product.prodname_enterprise %}](#github-enterprise), plus: +{% data variables.product.prodname_ghe_one %} 包括 [{% data variables.product.prodname_enterprise %}](#github-enterprise)，加上： - {% data variables.contact.github_support %} {% data variables.product.premium_plus_support_plan %} - {% data variables.product.prodname_insights %} -- {% data variables.product.prodname_advanced_security %} +- {% data variables.product.prodname_advanced_security %}{% if currentVersion == "free-pro-team@latest" %}. For more information, see "[About {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)" and "[About {% data variables.product.prodname_secret_scanning %}](/github/administering-a-repository/about-secret-scanning) (beta)."{% endif %}{% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %}. For more information, see "[About {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning) (beta)."{% endif %} - [组织的 {% data variables.product.prodname_learning %}](https://lab.github.com/organizations) -For more information about signing up for {% data variables.product.prodname_ghe_one %}, contact [{% data variables.product.product_name %}'s Sales team](https://enterprise.github.com/contact). +有关注册 {% data variables.product.prodname_ghe_one %} 的更多信息，请联系 [{% data variables.product.product_name %} 的销售团队](https://enterprise.github.com/contact)。 diff --git a/translations/zh-CN/content/github/getting-started-with-github/keyboard-shortcuts.md b/translations/zh-CN/content/github/getting-started-with-github/keyboard-shortcuts.md index e0b12e2aca9e..61ac5aefc044 100644 --- a/translations/zh-CN/content/github/getting-started-with-github/keyboard-shortcuts.md +++ b/translations/zh-CN/content/github/getting-started-with-github/keyboard-shortcuts.md @@ -20,37 +20,37 @@ versions: ### 站点快捷键 -| 键盘快捷键 | 描述 | -| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| s 或 / | 聚焦于搜索栏。 更多信息请参阅“[关于在 {% data variables.product.company_short %} 上搜索](/articles/about-searching-on-github)”。 | -| g n | 转到您的通知。 更多信息请参阅{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[关于通知](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}“[关于通知](/github/receiving-notifications-about-activity-on-github/about-notifications){% endif %}”。 | -| esc | 当聚焦于用户、议题或拉取请求悬停卡时，关闭悬停卡并重新聚焦于悬停卡所在的元素 | +| 键盘快捷键 | 描述 | +| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| s 或 / | 聚焦于搜索栏。 更多信息请参阅“[关于在 {% data variables.product.company_short %} 上搜索](/articles/about-searching-on-github)”。 | +| g n | 转到您的通知。 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 %}." | +| esc | 当聚焦于用户、议题或拉取请求悬停卡时，关闭悬停卡并重新聚焦于悬停卡所在的元素 | ### 仓库 -| 键盘快捷键 | 描述 | -| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | -| g c | 转到 **Code（代码）**选项卡 | -| g i | 转到 **Issues（议题）**选项卡。 更多信息请参阅“[关于议题](/articles/about-issues)”。 | -| g p | 转到 **Pull requests（拉取请求）**选项卡。 更多信息请参阅“[关于拉取请求](/articles/about-pull-requests)”。 | -| g a | Go to the **Actions** tab. For more information, see "[About Actions](/actions/getting-started-with-github-actions/about-github-actions)." | -| g b | 转到 **Projects（项目）**选项卡。 更多信息请参阅“[关于项目板](/articles/about-project-boards)”。 | -| g w | 转到 **Wiki** 选项卡。 更多信息请参阅“[关于 wikis](/articles/about-wikis)”。 | +| 键盘快捷键 | 描述 | +| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| g c | 转到 **Code（代码）**选项卡 | +| g i | 转到 **Issues（议题）**选项卡。 更多信息请参阅“[关于议题](/articles/about-issues)”。 | +| g p | 转到 **Pull requests（拉取请求）**选项卡。 For more information, see "[About pull requests](/articles/about-pull-requests)."{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} +| g a | 转到 **Actions（操作）**选项卡。 For more information, see "[About Actions](/actions/getting-started-with-github-actions/about-github-actions)."{% endif %} +| g b | 转到 **Projects（项目）**选项卡。 更多信息请参阅“[关于项目板](/articles/about-project-boards)”。 | +| g w | 转到 **Wiki** 选项卡。 更多信息请参阅“[关于 wikis](/articles/about-wikis)”。 | ### 源代码编辑 -| 键盘快捷键 | 描述 | -| -------------------------------------------------------------- | -------------------------------------------------------------- | -| e | 在 **Edit file（编辑文件）**选项卡中打开源代码文件 | -| control f 或 command f | 开始在文件编辑器中搜索 | -| control g 或 command g | 查找下一个 | -| shift control g 或 shift command g | 查找上一个 | -| shift control f 或 command option f | 替换 | -| shift control r 或 shift command option f | 全部替换 | -| alt g | 跳至行 | -| control z 或 command z | 撤消 | -| control y 或 command y | 重做 | -| cmd + shift + p | Toggles between the **Edit file** and **Preview changes** tabs | +| 键盘快捷键 | 描述 | +| -------------------------------------------------------------- | -------------------------------------------------------- | +| e | 在 **Edit file（编辑文件）**选项卡中打开源代码文件 | +| control f 或 command f | 开始在文件编辑器中搜索 | +| control g 或 command g | 查找下一个 | +| shift control g 或 shift command g | 查找上一个 | +| shift control f 或 command option f | 替换 | +| shift control r 或 shift command option f | 全部替换 | +| alt g | 跳至行 | +| control z 或 command z | 撤消 | +| control y 或 command y | 重做 | +| cmd + shift + p | 在 **Edit file（编辑文件）** 与 **Preview changes（预览更改）**选项卡之间切换 | 有关更多键盘快捷键，请参阅 [CodeMirror 文档](https://codemirror.net/doc/manual.html#commands)。 @@ -67,16 +67,16 @@ versions: ### 评论 -| 键盘快捷键 | 描述 | -| ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | -| control b 或 command b | 插入 Markdown 格式用于粗体文本 | -| control i 或 command i | 插入 Markdown 格式用于斜体文本 | -| control k 或 command k | 插入 Markdown 格式用于创建链接 | -| control shift p 或 command shift p | 在 **Write（撰写）**和 **Preview（预览）**评论选项卡之间切换 | -| control enter | 提交评论 | -| control .，然后 control [已保存回复编号] | 打开已保存回复菜单，然后使用已保存回复自动填写评论字段。 更多信息请参阅“[关于已保存回复](/articles/about-saved-replies)”。{% if currentVersion == "free-pro-team@latest" %} +| 键盘快捷键 | 描述 | +| ------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| control b 或 command b | 插入 Markdown 格式用于粗体文本 | +| control i 或 command i | 插入 Markdown 格式用于斜体文本 | +| control k 或 command k | 插入 Markdown 格式用于创建链接 | +| control shift p 或 command shift p | 在 **Write（撰写）**和 **Preview（预览）**评论选项卡之间切换 | +| control enter | 提交评论 | +| control .，然后 control [已保存回复编号] | 打开已保存回复菜单，然后使用已保存回复自动填写评论字段。 For more information, see "[About saved replies](/articles/about-saved-replies)."{% if currentVersion == "free-pro-team@latest" %} | control g 或 command g | 插入建议。 更多信息请参阅“[审查拉取请求中提议的更改](/articles/reviewing-proposed-changes-in-a-pull-request)”。 |{% endif %} -| r | 在您的回复中引用所选的文本。 更多信息请参阅“[基本撰写和格式语法](/articles/basic-writing-and-formatting-syntax#quoting-text)”。 | +| r | 在您的回复中引用所选的文本。 更多信息请参阅“[基本撰写和格式语法](/articles/basic-writing-and-formatting-syntax#quoting-text)”。 | ### 议题和拉取请求列表 @@ -92,24 +92,24 @@ versions: | o 或 enter | 打开议题 | ### 议题和拉取请求 -| 键盘快捷键 | 描述 | -| ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | -| q | 请求审查者。 更多信息请参阅“[申请拉取请求审查](/articles/requesting-a-pull-request-review/)”。 | -| m | 设置里程碑。 更多信息请参阅“[将里程碑与议题及拉取请求关联](/articles/associating-milestones-with-issues-and-pull-requests/)”。 | -| l | 应用标签。 更多信息请参阅“[应用标签到议题和拉取请求](/articles/applying-labels-to-issues-and-pull-requests/)”。 | +| 键盘快捷键 | 描述 | +| ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | +| q | 请求审查者。 更多信息请参阅“[申请拉取请求审查](/articles/requesting-a-pull-request-review/)”。 | +| m | 设置里程碑。 更多信息请参阅“[将里程碑与议题及拉取请求关联](/articles/associating-milestones-with-issues-and-pull-requests/)”。 | +| l | 应用标签。 更多信息请参阅“[应用标签到议题和拉取请求](/articles/applying-labels-to-issues-and-pull-requests/)”。 | | a | 设置受理人。 更多信息请参阅“[分配议题和拉取请求到其他 {% data variables.product.company_short %} 用户](/articles/assigning-issues-and-pull-requests-to-other-github-users/)”。 | -| cmd + shift + p 或 control + shift + p | 在 **Write（撰写）**和 **Preview（预览）**选项卡之间切换 | +| cmd + shift + p 或 control + shift + p | 在 **Write（撰写）**和 **Preview（预览）**选项卡之间切换 | ### 拉取请求中的更改 -| 键盘快捷键 | 描述 | -| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| c | 在拉取请求中打开提交列表 | -| t | 在拉取请求中打开已更改文件列表 | -| j | 将所选内容在列表中向下移动 | -| k | 将所选内容在列表中向上移动 | -| cmd + shift + enter | 添加一条有关拉取请求差异的评论 | -| alt 并单击 | 通过按下 `alt` 并单击 **Show outdated（显示已过期）**或 **Hide outdated（隐藏已过期）**，在折叠和展开拉取请求中所有过期的审查评论之间切换。{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +| 键盘快捷键 | 描述 | +| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| c | 在拉取请求中打开提交列表 | +| t | 在拉取请求中打开已更改文件列表 | +| j | 将所选内容在列表中向下移动 | +| k | 将所选内容在列表中向上移动 | +| cmd + shift + enter | 添加一条有关拉取请求差异的评论 | +| alt 并单击 | 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" %} | 单击，然后按住 shift 并单击 | 单击一个行号，按住 shift，然后单击另一行号，便可对拉取请求的多行发表评论。 更多信息请参阅“[评论拉取请求](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request#adding-line-comments-to-a-pull-request)。”|{% endif %} ### 项目板 diff --git a/translations/zh-CN/content/github/getting-started-with-github/saving-repositories-with-stars.md b/translations/zh-CN/content/github/getting-started-with-github/saving-repositories-with-stars.md index cb3c8c9842e8..ef0fce5434df 100644 --- a/translations/zh-CN/content/github/getting-started-with-github/saving-repositories-with-stars.md +++ b/translations/zh-CN/content/github/getting-started-with-github/saving-repositories-with-stars.md @@ -1,6 +1,6 @@ --- title: 使用星标保存仓库 -intro: '您可以对仓库{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.16" %}和主题{% endif %}加星标，以跟踪您认为有趣的项目{% if currentVersion == "free-pro-team@latest" %}，并发现消息馈送中的相关内容{% endif %}。' +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/ @@ -19,7 +19,8 @@ versions: 标星操作便于以后再次找到仓库或主题。 您可以到 {% data variables.explore.your_stars_page %} 查看已经加星标的所有仓库和主题。 {% if currentVersion == "free-pro-team@latest" %} -您可以对仓库和主题加星标以在 {% data variables.product.product_name %} 上发现类似的项目。 对仓库或主题加星标时，{% data variables.product.product_name %} 可能会在消息馈送的发现视图中推荐相关内容。 更多信息请参阅“[寻找在 {% data variables.product.prodname_dotcom %} 上参与开源项目的方法](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)”。 +You can star repositories and topics to discover similar projects on +{% data variables.product.product_name %} 上的企业设置来设置公告横幅。 对仓库或主题加星标时，{% data variables.product.product_name %} 可能会在消息馈送的发现视图中推荐相关内容。 更多信息请参阅“[寻找在 {% data variables.product.prodname_dotcom %} 上参与开源项目的方法](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)”。 {% endif %} 对仓库加星标也可表示赞赏仓库维护员的工作。 许多 {% data variables.product.prodname_dotcom %} 的仓库评级取决于仓库拥有的星标数。 此外，[Explore](https://github.com/explore) 也会根据星标数显示最受欢迎的仓库。 @@ -42,7 +43,7 @@ versions: ### 浏览好友的星标 - 在页面右下角，可以浏览好友的星标。 You can use this to find new repositories and topics to star. + 在页面右下角，可以浏览好友的星标。 您可以使用它来查找新的仓库和主题以标星。 ![查看好友的星标](/assets/images/help/stars/stars_jump_to_a_friend.png) diff --git a/translations/zh-CN/content/github/getting-started-with-github/set-up-git.md b/translations/zh-CN/content/github/getting-started-with-github/set-up-git.md index 76fc0c159814..21af32444630 100644 --- a/translations/zh-CN/content/github/getting-started-with-github/set-up-git.md +++ b/translations/zh-CN/content/github/getting-started-with-github/set-up-git.md @@ -16,9 +16,9 @@ versions: enterprise-server: '*' --- -要在命令行中使用 Git，您将需要在计算机上下载、安装和配置 Git。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} You can also install {% data variables.product.prodname_cli %} to use {% data variables.product.product_name %} from the command line. For more information on {% data variables.product.prodname_cli %}, see the [{% data variables.product.prodname_cli %}](https://cli.github.com/manual/) documentation.{% endif %} +要在命令行中使用 Git，您将需要在计算机上下载、安装和配置 Git。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} You can also install {% data variables.product.prodname_cli %} to use {% data variables.product.product_name %} from the command line. 有关 {% data variables.product.prodname_cli %} 的更多信息，请参阅 [{% data variables.product.prodname_cli %}](https://cli.github.com/manual/) 文档。{% endif %} -如果要在本地使用 Git，但不想使用命令行，您可以下载并安装 [{% data variables.product.prodname_desktop %}]({% data variables.product.desktop_link %}) 客户端。 For more information, see "[Installing and configuring {% data variables.product.prodname_desktop %}](/desktop/installing-and-configuring-github-desktop/)." +如果要在本地使用 Git，但不想使用命令行，您可以下载并安装 [{% data variables.product.prodname_desktop %}]({% data variables.product.desktop_link %}) 客户端。 更多信息请参阅“[安装和配置 {% data variables.product.prodname_desktop %}](/desktop/installing-and-configuring-github-desktop/)”。 如果无需在本地使用文件，{% data variables.product.product_name %} 可让您在浏览器中直接完成许多 Git 相关的操作，包括： diff --git a/translations/zh-CN/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-server.md b/translations/zh-CN/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-server.md index a6cf0ef9c71f..41225d56aed0 100644 --- a/translations/zh-CN/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-server.md +++ b/translations/zh-CN/content/github/getting-started-with-github/setting-up-a-trial-of-github-enterprise-server.md @@ -13,7 +13,7 @@ versions: 您可以申请 45 天试用版来试用 {% data variables.product.prodname_ghe_server %}。 您的试用版将作为虚拟设备安装，带有内部或云部署选项。 有关支持的可视化平台列表，请参阅“[设置 GitHub Enterprise Server 实例](/enterprise/admin/installation/setting-up-a-github-enterprise-server-instance)”。 -安全警报和 {% data variables.product.prodname_github_connect %} 在 {% data variables.product.prodname_ghe_server %} 试用版中目前不提供。 要获取这些功能的演示，请联系 {% data variables.contact.contact_enterprise_sales %}。 有关这些功能的更多信息，请参阅“[关于对有漏洞的依赖项发出警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)”和“[将 {% data variables.product.prodname_ghe_server %} 连接到 {% data variables.product.prodname_dotcom_the_website %}](/enterprise/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)”。 +{% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}Security{% endif %} alerts and {% data variables.product.prodname_github_connect %} are not currently available in trials of {% data variables.product.prodname_ghe_server %}. 要获取这些功能的演示，请联系 {% data variables.contact.contact_enterprise_sales %}。 有关这些功能的更多信息，请参阅“[关于对有漏洞的依赖项发出警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)”和“[将 {% data variables.product.prodname_ghe_server %} 连接到 {% data variables.product.prodname_dotcom_the_website %}](/enterprise/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)”。 试用版也可用于 {% data variables.product.prodname_ghe_cloud %}。 更多信息请参阅“[设置 {% data variables.product.prodname_ghe_cloud %} 的试用](/articles/setting-up-a-trial-of-github-enterprise-cloud)”。 @@ -44,7 +44,7 @@ versions: {% note %} - **Note:** People you invite to become account administrators will receive an email with a link to accept your invitation. + **注：**您邀请成为帐户管理员的人员将收到一封电子邮件，其中包含接受邀请的链接。 {% endnote %} diff --git a/translations/zh-CN/content/github/getting-started-with-github/signing-up-for-a-new-github-account.md b/translations/zh-CN/content/github/getting-started-with-github/signing-up-for-a-new-github-account.md index c6519ba339e6..0d85da218692 100644 --- a/translations/zh-CN/content/github/getting-started-with-github/signing-up-for-a-new-github-account.md +++ b/translations/zh-CN/content/github/getting-started-with-github/signing-up-for-a-new-github-account.md @@ -19,4 +19,4 @@ versions: - “[配置双重身份验证](/articles/configuring-two-factor-authentication)” - “[将个人简历添加到个人资料](/articles/adding-a-bio-to-your-profile)” - “[创建组织](/articles/creating-a-new-organization-from-scratch)” -- [ {% data variables.product.prodname_roadmap %} ]({% data variables.product.prodname_roadmap_link %}) in the `github/roadmap` repository +- `github/roadmap` 仓库中的 [ {% data variables.product.prodname_roadmap %} ]({% data variables.product.prodname_roadmap_link %}) diff --git a/translations/zh-CN/content/github/getting-started-with-github/supported-browsers.md b/translations/zh-CN/content/github/getting-started-with-github/supported-browsers.md index 2326e97af880..f056e39ddb7f 100644 --- a/translations/zh-CN/content/github/getting-started-with-github/supported-browsers.md +++ b/translations/zh-CN/content/github/getting-started-with-github/supported-browsers.md @@ -4,7 +4,7 @@ redirect_from: - /articles/why-doesn-t-graphs-work-with-ie-8/ - /articles/why-don-t-graphs-work-with-ie8/ - /articles/supported-browsers -intro: '我们将 {% data variables.product.product_name %} 设计为支持最新的 Web 浏览器。 我们支持最新版本的 [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 %}和 [Microsoft Edge](https://www.microsoft.com/en-us/windows/microsoft-edge)。' +intro: '我们将 {% data variables.product.product_name %} 设计为支持最新的 Web 浏览器。 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: '*' diff --git a/translations/zh-CN/content/github/getting-started-with-github/types-of-github-accounts.md b/translations/zh-CN/content/github/getting-started-with-github/types-of-github-accounts.md index 0595ebf31d1a..cb03124c0085 100644 --- a/translations/zh-CN/content/github/getting-started-with-github/types-of-github-accounts.md +++ b/translations/zh-CN/content/github/getting-started-with-github/types-of-github-accounts.md @@ -1,6 +1,6 @@ --- title: GitHub 帐户的类型 -intro: '您的用户帐户是您在 {% data variables.product.product_location %} 中的身份。 您的用户帐户可以是任意数量组织的成员。{% if currentVersion == "free-pro-team@latest" %}组织可属于企业帐户。{% endif %}' +intro: '您的用户帐户是您在 {% 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/ @@ -13,12 +13,13 @@ versions: --- {% if currentVersion == "free-pro-team@latest" %} -有关各 {% data variables.product.product_name %} 产品功能的完整列表，请参阅“[{% data variables.product.prodname_dotcom %} 的产品](/github/getting-started-with-github/githubs-products)”。 +For a full list of features for each +{% data variables.product.product_name %} product, see "[{% data variables.product.prodname_dotcom %}'s products](/github/getting-started-with-github/githubs-products)." {% endif %} ### 个人用户帐户 -Every person who uses {% data variables.product.product_location %} has their own user account, which includes: +使用 {% data variables.product.product_location %} 的每个人都有其自己的用户帐户，其中包括： {% if currentVersion == "free-pro-team@latest" %} @@ -38,7 +39,7 @@ Every person who uses {% data variables.product.product_location %} has their ow {% tip %} -**Tips**: +**提示**： - 您可以将一个帐户用于多种用途，例如个人用途和业务用途。 我们不建议创建多个帐户。 更多信息请参阅“[合并多个用户帐户](/articles/merging-multiple-user-accounts)”。 - 用户帐户适用于人类，但必要时可将其提供给机器人，例如持续集成自动程序。 @@ -71,6 +72,6 @@ Every person who uses {% data variables.product.product_location %} has their ow ### 延伸阅读 -{% if currentVersion == "free-pro-team@latest" %}-“[注册新 {% data variables.product.prodname_dotcom %} 帐户](/articles/signing-up-for-a-new-github-account)” +{% if currentVersion == "free-pro-team@latest" %}- "[Signing up for a new {% data variables.product.prodname_dotcom %} account](/articles/signing-up-for-a-new-github-account)" - “[{% data variables.product.prodname_dotcom %} 的产品](/articles/githubs-products)”{% endif %} - “[创建新组织帐户](/articles/creating-a-new-organization-account)” diff --git a/translations/zh-CN/content/github/getting-started-with-github/verifying-your-email-address.md b/translations/zh-CN/content/github/getting-started-with-github/verifying-your-email-address.md index 92d3a8622331..1288c8fff49c 100644 --- a/translations/zh-CN/content/github/getting-started-with-github/verifying-your-email-address.md +++ b/translations/zh-CN/content/github/getting-started-with-github/verifying-your-email-address.md @@ -28,7 +28,7 @@ versions: {% warning %} -**Warnings**: +**警告**： - {% data reusables.user_settings.no-verification-disposable-emails %} - {% data reusables.user_settings.verify-org-approved-email-domain %} diff --git a/translations/zh-CN/content/github/importing-your-projects-to-github/about-github-importer.md b/translations/zh-CN/content/github/importing-your-projects-to-github/about-github-importer.md index 125d8ded748f..6f78625ff38a 100644 --- a/translations/zh-CN/content/github/importing-your-projects-to-github/about-github-importer.md +++ b/translations/zh-CN/content/github/importing-your-projects-to-github/about-github-importer.md @@ -1,6 +1,6 @@ --- title: 关于 GitHub 导入工具 -intro: 如果您在 Subversion、Mercurial、Team Foundation Server 或其他 Git 仓库中有源代码，可使用 GitHub 导入工具将其移至 GitHub。 +intro: '如果您在 Subversion、Mercurial、Team Foundation Server 或其他 Git 仓库中有源代码，可使用 GitHub 导入工具将其移至 GitHub。' redirect_from: - /articles/about-github-importer versions: diff --git a/translations/zh-CN/content/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line.md b/translations/zh-CN/content/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line.md index 41e1c59df458..dc060e337fc8 100644 --- a/translations/zh-CN/content/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line.md +++ b/translations/zh-CN/content/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line.md @@ -21,7 +21,10 @@ versions: {% mac %} -1. 在 {% data variables.product.product_location %} 上[创建新仓库](/articles/creating-a-new-repository) 为避免错误，请勿使用*自述文件*、许可或 `gitignore` 文件初始化新仓库。 您可以在项目推送到 {% data variables.product.product_name %} 之后添加这些文件。 ![创建新仓库下拉列表](/assets/images/help/repository/repo-create.png) +1. [Create a new repository](/articles/creating-a-new-repository) on + +{% data variables.product.product_location %}. 为避免错误，请勿使用*自述文件*、许可或 `gitignore` 文件初始化新仓库。 您可以在项目推送到 {% data variables.product.product_name %} 之后添加这些文件。 + ![创建新仓库下拉列表](/assets/images/help/repository/repo-create.png) {% data reusables.command_line.open_the_multi_os_terminal %} 3. 将当前工作目录更改为您的本地仓库。 4. 将本地目录初始化为 Git 仓库。 @@ -56,7 +59,10 @@ versions: {% windows %} -1. 在 {% data variables.product.product_location %} 上[创建新仓库](/articles/creating-a-new-repository) 为避免错误，请勿使用*自述文件*、许可或 `gitignore` 文件初始化新仓库。 您可以在项目推送到 {% data variables.product.product_name %} 之后添加这些文件。 ![创建新仓库下拉列表](/assets/images/help/repository/repo-create.png) +1. [Create a new repository](/articles/creating-a-new-repository) on + +{% data variables.product.product_location %}. 为避免错误，请勿使用*自述文件*、许可或 `gitignore` 文件初始化新仓库。 您可以在项目推送到 {% data variables.product.product_name %} 之后添加这些文件。 + ![创建新仓库下拉列表](/assets/images/help/repository/repo-create.png) {% data reusables.command_line.open_the_multi_os_terminal %} 3. 将当前工作目录更改为您的本地仓库。 4. 将本地目录初始化为 Git 仓库。 @@ -91,7 +97,10 @@ versions: {% linux %} -1. 在 {% data variables.product.product_location %} 上[创建新仓库](/articles/creating-a-new-repository) 为避免错误，请勿使用*自述文件*、许可或 `gitignore` 文件初始化新仓库。 您可以在项目推送到 {% data variables.product.product_name %} 之后添加这些文件。 ![创建新仓库下拉列表](/assets/images/help/repository/repo-create.png) +1. [Create a new repository](/articles/creating-a-new-repository) on + +{% data variables.product.product_location %}. 为避免错误，请勿使用*自述文件*、许可或 `gitignore` 文件初始化新仓库。 您可以在项目推送到 {% data variables.product.product_name %} 之后添加这些文件。 + ![创建新仓库下拉列表](/assets/images/help/repository/repo-create.png) {% data reusables.command_line.open_the_multi_os_terminal %} 3. 将当前工作目录更改为您的本地仓库。 4. 将本地目录初始化为 Git 仓库。 diff --git a/translations/zh-CN/content/github/importing-your-projects-to-github/importing-a-git-repository-using-the-command-line.md b/translations/zh-CN/content/github/importing-your-projects-to-github/importing-a-git-repository-using-the-command-line.md index 58a4645be578..6a26ad05c0df 100644 --- a/translations/zh-CN/content/github/importing-your-projects-to-github/importing-a-git-repository-using-the-command-line.md +++ b/translations/zh-CN/content/github/importing-your-projects-to-github/importing-a-git-repository-using-the-command-line.md @@ -1,6 +1,6 @@ --- title: 使用命令行导入 Git 仓库 -intro: '{% if currentVersion == "free-pro-team@latest" %}If [GitHub Importer](/articles/importing-a-repository-with-github-importer) 不适用于您的目的，例如，如果您现有的代码托管在私有网络上，则我们建议使用命令行导入。{% else %}当您现有的代码托管在私有网络上时，适合使用命令行导入 Git 项目。{% endif %}' +intro: '{% if currentVersion == "free-pro-team@latest" %}If [GitHub Importer](/articles/importing-a-repository-with-github-importer) is not suitable for your purposes, such as if your existing code is hosted on a private network, then we recommend importing using the command line.{% else %}Importing Git projects using the command line is suitable when your existing code is hosted on a private network.{% endif %}' redirect_from: - /articles/importing-a-git-repository-using-the-command-line versions: diff --git a/translations/zh-CN/content/github/importing-your-projects-to-github/importing-a-repository-with-github-importer.md b/translations/zh-CN/content/github/importing-your-projects-to-github/importing-a-repository-with-github-importer.md index debb472e3b14..78351c74dfaa 100644 --- a/translations/zh-CN/content/github/importing-your-projects-to-github/importing-a-repository-with-github-importer.md +++ b/translations/zh-CN/content/github/importing-your-projects-to-github/importing-a-repository-with-github-importer.md @@ -1,6 +1,6 @@ --- title: 使用 GitHub 导入工具导入仓库 -intro: 如果您有项目托管在另一个版本控制系统上，可以使用 GitHub 导入工具将其自动导入到 GitHub。 +intro: '如果您有项目托管在另一个版本控制系统上，可以使用 GitHub 导入工具将其自动导入到 GitHub。' redirect_from: - /articles/importing-from-other-version-control-systems-to-github/ - /articles/importing-a-repository-with-github-importer diff --git a/translations/zh-CN/content/github/importing-your-projects-to-github/importing-source-code-to-github.md b/translations/zh-CN/content/github/importing-your-projects-to-github/importing-source-code-to-github.md index f72f33c2d70a..7cb243e6c62b 100644 --- a/translations/zh-CN/content/github/importing-your-projects-to-github/importing-source-code-to-github.md +++ b/translations/zh-CN/content/github/importing-your-projects-to-github/importing-source-code-to-github.md @@ -1,6 +1,6 @@ --- title: 将源代码导入到 GitHub -intro: '您可以使用 {% if currentVersion == "free-pro-team@latest" %}GitHub 导入工具、命令行、{% else %}命令行{% endif %}或外部迁移工具将仓库导入到 GitHub。' +intro: 'You can import repositories to GitHub using {% if currentVersion == "free-pro-team@latest" %}GitHub Importer, the command line,{% else %}the command line{% endif %} or external migration tools.' redirect_from: - /articles/importing-an-external-git-repository/ - /articles/importing-from-bitbucket/ diff --git a/translations/zh-CN/content/github/importing-your-projects-to-github/support-for-subversion-clients.md b/translations/zh-CN/content/github/importing-your-projects-to-github/support-for-subversion-clients.md index 3d5ca8bac33d..4033dc047182 100644 --- a/translations/zh-CN/content/github/importing-your-projects-to-github/support-for-subversion-clients.md +++ b/translations/zh-CN/content/github/importing-your-projects-to-github/support-for-subversion-clients.md @@ -28,7 +28,7 @@ Subversion 检出则不同：它们混合工作目录中的仓库数据，因此 $ cd repo ``` -4. 获取 `trunk` 分支。 The Subversion bridge maps trunk to the Git HEAD branch. +4. 获取 `trunk` 分支。 Subversion 网桥将主干映射到 Git HEAD 分支。 ```shell $ svn up trunk > A trunk diff --git a/translations/zh-CN/content/github/importing-your-projects-to-github/updating-commit-author-attribution-with-github-importer.md b/translations/zh-CN/content/github/importing-your-projects-to-github/updating-commit-author-attribution-with-github-importer.md index a1eda3e90251..ad7615fb9710 100644 --- a/translations/zh-CN/content/github/importing-your-projects-to-github/updating-commit-author-attribution-with-github-importer.md +++ b/translations/zh-CN/content/github/importing-your-projects-to-github/updating-commit-author-attribution-with-github-importer.md @@ -1,6 +1,6 @@ --- title: 使用 GitHub 导入工具更新提交作者归属 -intro: 导入期间，您可以将仓库中的提交匹配提交作者的 GitHub 帐户。 +intro: '导入期间，您可以将仓库中的提交匹配提交作者的 GitHub 帐户。' redirect_from: - /articles/updating-commit-author-attribution-with-github-importer versions: diff --git a/translations/zh-CN/content/github/importing-your-projects-to-github/what-are-the-differences-between-subversion-and-git.md b/translations/zh-CN/content/github/importing-your-projects-to-github/what-are-the-differences-between-subversion-and-git.md index b98070bdddbc..e85088c4270c 100644 --- a/translations/zh-CN/content/github/importing-your-projects-to-github/what-are-the-differences-between-subversion-and-git.md +++ b/translations/zh-CN/content/github/importing-your-projects-to-github/what-are-the-differences-between-subversion-and-git.md @@ -1,6 +1,6 @@ --- title: Subversion 和 Git 有哪些区别？ -intro: Subversion (SVN) 仓库与 Git 仓库类似，但涉及项目架构时有一些区别。 +intro: 'Subversion (SVN) 仓库与 Git 仓库类似，但涉及项目架构时有一些区别。' redirect_from: - /articles/what-are-the-differences-between-svn-and-git/ - /articles/what-are-the-differences-between-subversion-and-git @@ -35,9 +35,9 @@ Git 项目也存储在一个目录中。 不过，Git 通过将其引用存储 Git 工作流程可能类似如下： * Git 仓库在 *.git* 目录中存储所有其分支和标记的完整历史记录。 -* 最新稳定发行版包含在 `master` 分支中。 +* The latest stable release is contained within the default branch. * 活动功能工作在单独的分支中进行开发。 -* 功能完成后，该功能分支将合并到 `master` 中并删除。 +* When a feature is finished, the feature branch is merged into the default branch and deleted. 与 SVN 不同的是，使用 Git 时目录结构保持不变，但文件内容会根据您的分支而变化。 diff --git a/translations/zh-CN/content/github/index.md b/translations/zh-CN/content/github/index.md index 8d635f2e237a..09a81961f5db 100644 --- a/translations/zh-CN/content/github/index.md +++ b/translations/zh-CN/content/github/index.md @@ -4,7 +4,7 @@ redirect_from: - /articles/ - /common-issues-and-questions/ - /troubleshooting-common-issues/ -intro: 适用于软件开发者、设计师和项目经理的文档、指南和帮助主题。 涵盖 Git、拉取请求、问题、wiki、gist 和充分使用 GitHub 进行开发所需的一切。 +intro: '适用于软件开发者、设计师和项目经理的文档、指南和帮助主题。 涵盖 Git、拉取请求、问题、wiki、gist 和充分使用 GitHub 进行开发所需的一切。' versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/zh-CN/content/github/managing-files-in-a-repository/3d-file-viewer.md b/translations/zh-CN/content/github/managing-files-in-a-repository/3d-file-viewer.md index 921be1333aa4..f2b9adedceec 100644 --- a/translations/zh-CN/content/github/managing-files-in-a-repository/3d-file-viewer.md +++ b/translations/zh-CN/content/github/managing-files-in-a-repository/3d-file-viewer.md @@ -57,6 +57,6 @@ versions: {% tip %} -**Note**: `ref` can be a branch or the hash to an individual commit (like `2391ae`). +**注**：`ref` 可以是分支或个别提交的哈希（如 `2391ae`）。 {% endtip %} diff --git a/translations/zh-CN/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md b/translations/zh-CN/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md index 613da729f9b5..2a5cd01ca56c 100644 --- a/translations/zh-CN/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md +++ b/translations/zh-CN/content/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line.md @@ -19,7 +19,9 @@ versions: {% data reusables.repositories.sensitive-info-warning %} -1. 在计算机上，将要上传到 {% data variables.product.product_name %} 的文件移入在克隆仓库时创建的本地目录。 +1. On your computer, move the file you'd like to upload to + +{% data variables.product.product_name %} into the local directory that was created when you cloned the repository. {% data reusables.command_line.open_the_multi_os_terminal %} {% data reusables.command_line.switching_directories_procedural %} {% data reusables.git.stage_for_commit %} diff --git a/translations/zh-CN/content/github/managing-files-in-a-repository/deleting-files.md b/translations/zh-CN/content/github/managing-files-in-a-repository/deleting-files.md index 75f4d3c0aa42..2d299f6c5972 100644 --- a/translations/zh-CN/content/github/managing-files-in-a-repository/deleting-files.md +++ b/translations/zh-CN/content/github/managing-files-in-a-repository/deleting-files.md @@ -15,7 +15,7 @@ versions: {% endtip %} 1. 浏览到要删除仓库中的文件。 -2. At the top of the file, click +2. 在文件顶部，单击 {% octicon "trashcan" aria-label="The trashcan icon" %}. {% data reusables.files.write_commit_message %} {% data reusables.files.choose-commit-email %} diff --git a/translations/zh-CN/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md b/translations/zh-CN/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md index e5516b0375ac..a28ff7f6586e 100644 --- a/translations/zh-CN/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md +++ b/translations/zh-CN/content/github/managing-files-in-a-repository/getting-permanent-links-to-files.md @@ -20,19 +20,19 @@ versions: 在 {% data variables.product.product_location %} 上查看文件时，通常会在分支头部看到当前版本。 例如： -* [https://github.com/github/hubot/blob/**master**/README.md](https://github.com/github/hubot/blob/master/README.md) +* [https://github.com/github/codeql/blob/**main**/README.md](https://github.com/github/codeql/blob/main/README.md) -引用 GitHub 的 `hubot` 仓库，并显示 `master` 分支中 `README.md` 文件的当前版本。 +refers to GitHub's `codeql` repository, and shows the `main` branch's current version of the `README.md` file. 分支头部的文件版本可能会随着新的提交而改变，因此如果您复制常规的 URL，当以后有人查看时，文件内容可能会不同。 ### 按 y 键可永久链接到特定提交中的文件 -要创建所查看文件特定版本的永久链接，不要在 URL 中使用分支名称（例如上例中的 `master` 部分），而是输入提交 id。 这将永久链接到该提交中文件的精确版本。 例如： +For a permanent link to the specific version of a file that you see, instead of using a branch name in the URL (i.e. the `main` part in the example above), put a commit id. 这将永久链接到该提交中文件的精确版本。 例如： -* [https://github.com/github/hubot/blob/**ed25584f5ac2520a6c28547ffd0961c7abd7ea49**/README.md](https://github.com/github/hubot/blob/ed25584f5ac2520a6c28547ffd0961c7abd7ea49/README.md) +* [https://github.com/github/codeql/blob/**b212af08a6cffbb434f3c8a2795a579e092792fd**/README.md](https://github.com/github/codeql/blob/b212af08a6cffbb434f3c8a2795a579e092792fd/README.md) -将 `master` 替换为特定提交 id，文件内容将不会改变。 +replaces `main` with a specific commit id and the file content will not change. 但是，手动查找提交 SHA 比较麻烦，因此您可以采用便捷方式，通过键入 y 将 URL 自动更新为永久链接版本。 然后，您可以复制该 URL，以后访问它的任何人都将看到与您所见完全一致的内容。 diff --git a/translations/zh-CN/content/github/managing-files-in-a-repository/managing-files-using-the-command-line.md b/translations/zh-CN/content/github/managing-files-in-a-repository/managing-files-using-the-command-line.md index efacc4738604..a3a4e9be42fd 100644 --- a/translations/zh-CN/content/github/managing-files-in-a-repository/managing-files-using-the-command-line.md +++ b/translations/zh-CN/content/github/managing-files-in-a-repository/managing-files-using-the-command-line.md @@ -1,6 +1,6 @@ --- title: 使用命令行管理文件 -intro: 使用命令行可以添加、重命名和删除仓库中的文件。 +intro: '使用命令行可以添加、重命名和删除仓库中的文件。' mapTopic: true redirect_from: - /articles/managing-files-using-the-command-line diff --git a/translations/zh-CN/content/github/managing-files-in-a-repository/mapping-geojson-files-on-github.md b/translations/zh-CN/content/github/managing-files-in-a-repository/mapping-geojson-files-on-github.md index 581a40ac8a06..4227c6229c2d 100644 --- a/translations/zh-CN/content/github/managing-files-in-a-repository/mapping-geojson-files-on-github.md +++ b/translations/zh-CN/content/github/managing-files-in-a-repository/mapping-geojson-files-on-github.md @@ -50,7 +50,7 @@ versions: {% tip %} -**Note**: `ref` can be a branch or the hash to an individual commit (like `2391ae`). +**注**：`ref` 可以是分支或个别提交的哈希（如 `2391ae`）。 {% endtip %} diff --git a/translations/zh-CN/content/github/managing-files-in-a-repository/moving-a-file-to-a-new-location.md b/translations/zh-CN/content/github/managing-files-in-a-repository/moving-a-file-to-a-new-location.md index 58b37c0a6baa..78728c6c28d0 100644 --- a/translations/zh-CN/content/github/managing-files-in-a-repository/moving-a-file-to-a-new-location.md +++ b/translations/zh-CN/content/github/managing-files-in-a-repository/moving-a-file-to-a-new-location.md @@ -1,6 +1,6 @@ --- title: 将文件移至新位置 -intro: 在编辑文件时，可以选择在仓库中随处移动，即使目录不存在。 +intro: '在编辑文件时，可以选择在仓库中随处移动，即使目录不存在。' redirect_from: - /articles/moving-a-file-to-a-new-location versions: @@ -12,7 +12,7 @@ versions: {% tip %} -**Tips**: +**提示**： - 如果尝试在您没有访问权限的仓库中移动文件，我们会将项目复刻到您的用户帐户，并在您提交更改后帮助您发送[拉取请求](/articles/about-pull-requests)到原仓库。 - 有些文件（如图像）需要您从命令行移动它们。 更多信息请参阅“[使用命令行将文件移至新位置](/articles/moving-a-file-to-a-new-location-using-the-command-line)”。 diff --git a/translations/zh-CN/content/github/managing-files-in-a-repository/navigating-code-on-github.md b/translations/zh-CN/content/github/managing-files-in-a-repository/navigating-code-on-github.md index b15d663b07b5..153f661e949f 100644 --- a/translations/zh-CN/content/github/managing-files-in-a-repository/navigating-code-on-github.md +++ b/translations/zh-CN/content/github/managing-files-in-a-repository/navigating-code-on-github.md @@ -27,13 +27,13 @@ versions: ### 跳至功能或方法的定义 -You can jump to a function or method's definition within the same repository by clicking the function or method call in a file. +您可以在文件中单击函数或方法调用，跳至同一仓库中该函数或方法的定义。 ![跳至定义选项卡](/assets/images/help/repository/jump-to-definition-tab.png) ### 查找函数或方法的所有引用 -You can find all references for a function or method within the same repository by clicking the function or method call in a file, then clicking the **References** tab. +您可以在文件中单击函数或方法调用，然后单击 **References（引用）**选项卡，查找同一仓库中该函数或方法的所有引用。 ![查找所有引用选项卡](/assets/images/help/repository/find-all-references-tab.png) diff --git a/translations/zh-CN/content/github/managing-files-in-a-repository/renaming-a-file.md b/translations/zh-CN/content/github/managing-files-in-a-repository/renaming-a-file.md index 120efabd7dfc..f5f319fdc3ab 100644 --- a/translations/zh-CN/content/github/managing-files-in-a-repository/renaming-a-file.md +++ b/translations/zh-CN/content/github/managing-files-in-a-repository/renaming-a-file.md @@ -10,7 +10,7 @@ versions: {% tip %} -**Tips**: +**提示**： - 如果您尝试在没有访问权限的仓库中重命名文件，我们会将项目复刻到您的用户帐户，并在您提交更改后帮助您发送[拉取请求](/articles/about-pull-requests)到原始仓库。 - 通过 Web 界面创建的文件名只能包含字母数字字符和连字符 (`-`)。 要使用其他字符，请在本地创建和提交文件，然后将它们推送到仓库。 diff --git a/translations/zh-CN/content/github/managing-files-in-a-repository/rendering-differences-in-prose-documents.md b/translations/zh-CN/content/github/managing-files-in-a-repository/rendering-differences-in-prose-documents.md index be206753c614..1f0f1808a2a5 100644 --- a/translations/zh-CN/content/github/managing-files-in-a-repository/rendering-differences-in-prose-documents.md +++ b/translations/zh-CN/content/github/managing-files-in-a-repository/rendering-differences-in-prose-documents.md @@ -45,9 +45,9 @@ versions: ### 查看复杂的差异 -一些拉取请求涉及大型复杂文档的大量更改。 When the changes take too long to analyze, {% data variables.product.product_name %} can't always produce a rendered view of the changes. If this happens, you'll see an error message when you click the rendered button. +一些拉取请求涉及大型复杂文档的大量更改。 当更改需要太长时间来分析时，{% data variables.product.product_name %} 不能总是生成更改的渲染视图。 如果发生这种情况，当您单击渲染按钮时，将会看到错误消息。 -![Message when view can't be rendered](/assets/images/help/repository/prose_diff_rendering.png) +![无法渲染视图时的消息](/assets/images/help/repository/prose_diff_rendering.png) 您仍可使用源视图来分析和评论更改。 diff --git a/translations/zh-CN/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md b/translations/zh-CN/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md index 3ca357e1cc1c..23ccc7f99717 100644 --- a/translations/zh-CN/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md +++ b/translations/zh-CN/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md @@ -9,9 +9,9 @@ versions: --- -笔记本的交互式功能（例如自定义的 JavaScript 图）在 {% data variables.product.product_location %} 上的仓库中不起作用。 有关示例，请参阅 [*Linking and Interactions.ipynb*](https://github.com/bokeh/bokeh-notebooks/blob/master/tutorial/06%20-%20Linking%20and%20Interactions.ipynb)。 +笔记本的交互式功能（例如自定义的 JavaScript 图）在 {% data variables.product.product_location %} 上的仓库中不起作用。 有关示例，请参阅 [*Linking and Interactions.ipynb*](https://github.com/bokeh/bokeh-notebooks/blob/main/tutorial/06%20-%20Linking%20and%20Interactions.ipynb)。 -要查看呈现 JavaScript 内容的 Jupyter notebook 或与其他人共享您的笔记本文件，您可以使用 [nbviewer](https://nbviewer.jupyter.org/)。 有关示例，请参阅在 nbviewer 上呈现的 [*Linking and Interactions.ipynb*](https://nbviewer.jupyter.org/github/bokeh/bokeh-notebooks/blob/master/tutorial/06%20-%20Linking%20and%20Interactions.ipynb)。 +要查看呈现 JavaScript 内容的 Jupyter notebook 或与其他人共享您的笔记本文件，您可以使用 [nbviewer](https://nbviewer.jupyter.org/)。 有关示例，请参阅在 nbviewer 上呈现的 [*Linking and Interactions.ipynb*](https://nbviewer.jupyter.org/github/bokeh/bokeh-notebooks/blob/main/tutorial/06%20-%20Linking%20and%20Interactions.ipynb)。 要查看 Jupyter Notebook 的完全交互式版本，您可以在本地设置笔记本服务器。 更多信息请参阅“[Jupyter 的正式文档](http://jupyter.readthedocs.io/en/latest/index.html)”。 diff --git a/translations/zh-CN/content/github/managing-large-files/about-git-large-file-storage.md b/translations/zh-CN/content/github/managing-large-files/about-git-large-file-storage.md index 85fe7987e1c4..ded2a0bcf1a1 100644 --- a/translations/zh-CN/content/github/managing-large-files/about-git-large-file-storage.md +++ b/translations/zh-CN/content/github/managing-large-files/about-git-large-file-storage.md @@ -12,16 +12,17 @@ versions: {% data variables.large_files.product_name_short %} 处理大文件的方式是存储对仓库中文件的引用，而不实际文件本身。 为满足 Git 的架构要求，{% data variables.large_files.product_name_short %} 创建了指针文件，用于对实际文件（存储在其他位置）的引用。 {% data variables.product.product_name %} 在仓库中管理此指针文件。 克隆仓库时，{% data variables.product.product_name %} 使用指针文件作为映射来查找大文件。 {% if currentVersion == "free-pro-team@latest" %} -使用 {% data variables.large_files.product_name_short %}，可以将文件存储到： +Using +{% data variables.large_files.product_name_short %}, you can store files up to: -| 产品 | 最大文件大小 | -| ------------------------------------------------------ | ---------------- | +| 产品 | 最大文件大小 | +| ------------------------------------------------- | ---------------- | | {% data variables.product.prodname_free_user %} | 2 GB | | {% data variables.product.prodname_pro %} | 2 GB | | {% data variables.product.prodname_team %} | 4 GB | | {% data variables.product.prodname_ghe_cloud %} | 5 GB |{% else %} - 使用 {% data variables.large_files.product_name_short %}，可在仓库中存储的最大文件量： -{% if currentVersion ver_lt "enterprise-server@2.21" %}{% data variables.large_files.max_lfs_size %}{% else %}5 GB{% endif %}。 + Using +{% data variables.large_files.product_name_short %}, you can store files up to {% if currentVersion ver_lt "enterprise-server@2.21" %}{% data variables.large_files.max_lfs_size %}{% else %}5 GB{% endif %} in your repository. {% endif %} 您也可以将 {% data variables.large_files.product_name_short %} 与 {% data variables.product.prodname_desktop %} 结合使用。 有关在 {% data variables.product.prodname_desktop %} 中克隆 Git LFS 仓库的更多信息，请参阅"[将仓库从 GitHub 克隆到 GitHub Desktop](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop)"。 diff --git a/translations/zh-CN/content/github/managing-large-files/about-storage-and-bandwidth-usage.md b/translations/zh-CN/content/github/managing-large-files/about-storage-and-bandwidth-usage.md index fbd7637f2d70..7c60f4369583 100644 --- a/translations/zh-CN/content/github/managing-large-files/about-storage-and-bandwidth-usage.md +++ b/translations/zh-CN/content/github/managing-large-files/about-storage-and-bandwidth-usage.md @@ -20,12 +20,13 @@ versions: - 如果下载一个使用 LFS 跟踪的 500 MB 文件，您将使用仓库所有者分配的 500 MB 带宽。 如果协作者推送文件更改并将新版本拉取到本地仓库，您将使用另外 500 MB 的带宽，所以两次下载的总使用量是 1 GB 带宽。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -If {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in source code archives for your repository, downloads of those archives will count towards bandwidth usage for the repository. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)." +If +{% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in source code archives for your repository, downloads of those archives will count towards bandwidth usage for the repository. 更多信息请参阅“[管理仓库存档中的 {% data variables.large_files.product_name_short %} 对象](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)”。 {% endif %} {% tip %} -**Tips**: +**提示**： - {% data reusables.large_files.owner_quota_only %} - {% data reusables.large_files.does_not_carry %} diff --git a/translations/zh-CN/content/github/managing-large-files/collaboration-with-git-large-file-storage.md b/translations/zh-CN/content/github/managing-large-files/collaboration-with-git-large-file-storage.md index 51064ed0cafd..af76b0adf61c 100644 --- a/translations/zh-CN/content/github/managing-large-files/collaboration-with-git-large-file-storage.md +++ b/translations/zh-CN/content/github/managing-large-files/collaboration-with-git-large-file-storage.md @@ -19,7 +19,7 @@ versions: ### 查看拉取请求中的大文件 -{% data variables.product.product_name %} 不会渲染拉取请求中的 {% data variables.large_files.product_name_short %} 对象。 Only the pointer file is shown: +{% data variables.product.product_name %} 不会渲染拉取请求中的 {% data variables.large_files.product_name_short %} 对象。 仅显示指针文件： ![大文件的示例 PR](/assets/images/help/large_files/large_files_pr.png) diff --git a/translations/zh-CN/content/github/managing-large-files/conditions-for-large-files.md b/translations/zh-CN/content/github/managing-large-files/conditions-for-large-files.md index 4af821a7bda3..c15a457a3472 100644 --- a/translations/zh-CN/content/github/managing-large-files/conditions-for-large-files.md +++ b/translations/zh-CN/content/github/managing-large-files/conditions-for-large-files.md @@ -16,4 +16,4 @@ versions: ### 阻止大文件的推送 -{% if currentVersion != "free-pro-team@latest" %}默认情况下， {% endif %}{% data variables.product.product_name %} 阻止超过 {% data variables.large_files.max_github_size %} 的推送。 {% if currentVersion != "free-pro-team@latest" %}但站点管理员可为您的 {% data variables.product.prodname_ghe_server %} 实例配置不同的限制。 更多信息请参阅“[设置 Git 推送限制](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-git-push-limits)”。{% endif %} +{% if currentVersion != "free-pro-team@latest" %}By default, {% endif %}{% data variables.product.product_name %} blocks pushes that exceed {% data variables.large_files.max_github_size %}. {% if currentVersion != "free-pro-team@latest" %}However, a site administrator can configure a different limit for your {% data variables.product.prodname_ghe_server %} instance. 更多信息请参阅“[设置 Git 推送限制](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-git-push-limits)”。{% endif %} diff --git a/translations/zh-CN/content/github/managing-large-files/configuring-git-large-file-storage.md b/translations/zh-CN/content/github/managing-large-files/configuring-git-large-file-storage.md index f0587311a47a..eb040a022955 100644 --- a/translations/zh-CN/content/github/managing-large-files/configuring-git-large-file-storage.md +++ b/translations/zh-CN/content/github/managing-large-files/configuring-git-large-file-storage.md @@ -47,7 +47,7 @@ versions: 5. 提交文件并将其推送到 {% data variables.product.product_name %}： ```shell $ git commit -m "add file.psd" - $ git push origin master + $ git push ``` 您会看到一些有关文件上传的诊断信息： ```shell @@ -59,4 +59,4 @@ versions: ### 延伸阅读 - "[Collaboration with {% data variables.large_files.product_name_long %}](/articles/collaboration-with-git-large-file-storage/)"{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -- "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)"{% endif %} +- "[管理仓库存档中的 {% data variables.large_files.product_name_short %} 对象](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)"{% endif %} diff --git a/translations/zh-CN/content/github/managing-large-files/distributing-large-binaries.md b/translations/zh-CN/content/github/managing-large-files/distributing-large-binaries.md index 686508a50574..ca73059296f4 100644 --- a/translations/zh-CN/content/github/managing-large-files/distributing-large-binaries.md +++ b/translations/zh-CN/content/github/managing-large-files/distributing-large-binaries.md @@ -1,6 +1,6 @@ --- title: 分发大型二进制文件 -intro: 除了分发源代码外，一些项目还需要分发大型文件，例如二进制文件或安装程序。 +intro: '除了分发源代码外，一些项目还需要分发大型文件，例如二进制文件或安装程序。' redirect_from: - /articles/distributing-large-binaries versions: diff --git a/translations/zh-CN/content/github/managing-large-files/installing-git-large-file-storage.md b/translations/zh-CN/content/github/managing-large-files/installing-git-large-file-storage.md index 96af4323c474..8c0aa8d3f3e5 100644 --- a/translations/zh-CN/content/github/managing-large-files/installing-git-large-file-storage.md +++ b/translations/zh-CN/content/github/managing-large-files/installing-git-large-file-storage.md @@ -57,7 +57,8 @@ versions: {% endtip %} 2. 在计算机上，找到下载的文件。 -3. 双击文件 *git-lfs-windows-1.X.X.exe*，其中 1.X.X 替换为您下载的 Git LFS 版本。 打开此文件时，Windows 将运行安装程序向导以安装 {% data variables.large_files.product_name_short %}。 +3. 双击文件 *git-lfs-windows-1.X.X.exe*，其中 1.X.X 替换为您下载的 Git LFS 版本。 When you open this file Windows will run a setup wizard to install +{% data variables.large_files.product_name_short %}. {% data reusables.command_line.open_the_multi_os_terminal %} 5. 验证安装成功： ```shell diff --git a/translations/zh-CN/content/github/managing-large-files/removing-files-from-git-large-file-storage.md b/translations/zh-CN/content/github/managing-large-files/removing-files-from-git-large-file-storage.md index cc37ad3e9a50..9290d04394dc 100644 --- a/translations/zh-CN/content/github/managing-large-files/removing-files-from-git-large-file-storage.md +++ b/translations/zh-CN/content/github/managing-large-files/removing-files-from-git-large-file-storage.md @@ -1,6 +1,6 @@ --- -title: 从 Git Large File Storage 中删除文件 -intro: '如果您已设置仓库的 {% data variables.large_files.product_name_short %}，则可以从 {% data variables.large_files.product_name_short %} 中删除所有文件或文件的子集。' +title: Removing files from Git Large File Storage +intro: 'If you''ve set up {% data variables.large_files.product_name_short %} for your repository, you can remove all files or a subset of files from {% data variables.large_files.product_name_short %}.' redirect_from: - /articles/removing-files-from-git-large-file-storage versions: @@ -8,45 +8,45 @@ versions: enterprise-server: '*' --- -### 删除单个文件 +### Removing a single file -1. 使用 `filter-branch` 命令或 BFG Repo-Cleaner 从仓库的 Git 历史记录中删除文件。 有关使用这些命令或工具的详细信息，请参阅“[从仓库中删除敏感数据](/articles/removing-sensitive-data-from-a-repository)”。 -2. 导航到 *.gitattributes* 文件。 +1. Remove the file from the repository's Git history using either the `filter-branch` command or BFG Repo-Cleaner. For detailed information on using these, see "[Removing sensitive data from a repository](/articles/removing-sensitive-data-from-a-repository)." +2. Navigate to your *.gitattributes* file. {% note %} - **注：**您的 *.gitattributes* 文件通常保存在本地仓库中。 在某些情况下，您可能已创建包含所有 {% data variables.large_files.product_name_short %} 关联的全局 *.gitattributes* 文件。 + **Note:** Your *.gitattributes* file is generally saved within your local repository. In some cases, you may have created a global *.gitattributes* file that contains all of your {% data variables.large_files.product_name_short %} associations. {% endnote %} -3. 找到并删除 *.gitattributes* 文件内关联的 {% data variables.large_files.product_name_short %} 跟踪规则。 -4. 保存并退出 *.gitattributes* 文件。 +3. Find and remove the associated {% data variables.large_files.product_name_short %} tracking rule within the *.gitattributes* file. +4. Save and exit the *.gitattributes* file. -### 删除 {% data variables.large_files.product_name_short %} 仓库内的所有文件 +### Removing all files within a {% data variables.large_files.product_name_short %} repository -1. 使用 `filter-branch` 命令或 BFG Repo-Cleaner 从仓库的 Git 历史记录中删除文件。 有关使用这些命令或工具的详细信息，请参阅“[从仓库中删除敏感数据](/articles/removing-sensitive-data-from-a-repository)”。 -2. （可选）要卸载仓库中的 {% data variables.large_files.product_name_short %}，请运行： +1. Remove the files from the repository's Git history using either the `filter-branch` command or BFG Repo-Cleaner. For detailed information on using these, see "[Removing sensitive data from a repository](/articles/removing-sensitive-data-from-a-repository)." +2. Optionally, to uninstall {% data variables.large_files.product_name_short %} in the repository, run: ```shell $ git lfs uninstall ``` - 对于 1.1.0 以下的 {% data variables.large_files.product_name_short %} 版本，运行： + For {% data variables.large_files.product_name_short %} versions below 1.1.0, run: ```shell $ git lfs uninit ``` -### 仓库中的 {% data variables.large_files.product_name_short %} 对象 +### {% data variables.large_files.product_name_short %} objects in your repository -从 {% data variables.large_files.product_name_short %} 中删除文件后，{% data variables.large_files.product_name_short %} 对象仍存在于远程存储中{% if currentVersion == "free-pro-team@latest" %} 并将继续计入您的 {% data variables.large_files.product_name_short %} 存储配额{% endif %}。 +After you remove files from {% data variables.large_files.product_name_short %}, the {% data variables.large_files.product_name_short %} objects still exist on the remote storage{% if currentVersion == "free-pro-team@latest" %} and will continue to count toward your {% data variables.large_files.product_name_short %} storage quota{% endif %}. -要从仓库中删除 {% data variables.large_files.product_name_short %} 对象，请{% if currentVersion == "free-pro-team@latest" %}删除并重新创建仓库。 删除仓库时，所有关联的议题、星标和复刻也会被删除。 更多信息请参阅“[删除仓库](/github/administering-a-repository/deleting-a-repository)”。{% else %}请联系 {% data variables.product.prodname_enterprise %} 管理员以存档对象。 存档的对象将在三个月后清除。{% endif %} +To remove {% data variables.large_files.product_name_short %} objects from a repository, {% if currentVersion == "free-pro-team@latest" %}delete and recreate the repository. When you delete a repository, any associated issues, stars, and forks are also deleted. For more information, see "[Deleting a repository](/github/administering-a-repository/deleting-a-repository)."{% else %}contact your {% data variables.product.prodname_enterprise %} administrator to archive the objects. Archived objects are purged after three months.{% endif %} {% note %} -**注：**如果删除了单个文件并有想要留在仓库中的其他 {% data variables.large_files.product_name_short %} 对象，则删除并重新创建仓库后，重新配置您的 {% data variables.large_files.product_name_short %} 关联文件。 更多信息请参阅“[删除单个文件](#removing-a-single-file)”和“[配置 {% data variables.large_files.product_name_long %}](/github/managing-large-files/configuring-git-large-file-storage)”。 +**Note:** If you removed a single file and have other {% data variables.large_files.product_name_short %} objects that you'd like to keep in your repository, after deleting and recreating your repository, reconfigure your {% data variables.large_files.product_name_short %}-associated files. For more information, see "[Removing a single file](#removing-a-single-file)" and "[Configuring {% data variables.large_files.product_name_long %}](/github/managing-large-files/configuring-git-large-file-storage)." {% endnote %} -### 延伸阅读 +### Further reading -- "[关于 {% data variables.large_files.product_name_long %}](/articles/about-git-large-file-storage)" -- “[使用 {% data variables.large_files.product_name_long %} 进行协作](/articles/collaboration-with-git-large-file-storage/)” -- "[安装 {% data variables.large_files.product_name_long %}](/articles/installing-git-large-file-storage)" +- "[About {% data variables.large_files.product_name_long %}](/articles/about-git-large-file-storage)" +- "[Collaboration with {% data variables.large_files.product_name_long %}](/articles/collaboration-with-git-large-file-storage/)" +- "[Installing {% data variables.large_files.product_name_long %}](/articles/installing-git-large-file-storage)" diff --git a/translations/zh-CN/content/github/managing-large-files/working-with-large-files.md b/translations/zh-CN/content/github/managing-large-files/working-with-large-files.md index 33e0fb6d1872..34db4b02a53f 100644 --- a/translations/zh-CN/content/github/managing-large-files/working-with-large-files.md +++ b/translations/zh-CN/content/github/managing-large-files/working-with-large-files.md @@ -1,6 +1,6 @@ --- title: 使用大文件 -intro: Git 仓库包含每个文件的每个版本。 但对于一些文件类型来说，这是不实际的。 多次修订大文件会增加仓库其他用户克隆和获取的时间。 +intro: 'Git 仓库包含每个文件的每个版本。 但对于一些文件类型来说，这是不实际的。 多次修订大文件会增加仓库其他用户克隆和获取的时间。' mapTopic: true redirect_from: - /articles/working-with-large-files diff --git a/translations/zh-CN/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md b/translations/zh-CN/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md index 73b8dce6840a..0ce617f2fdb2 100644 --- a/translations/zh-CN/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md +++ b/translations/zh-CN/content/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies.md @@ -77,15 +77,15 @@ We send security alerts to people with admin permissions in the affected reposit ### Configuring notifications for {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} {% if currentVersion == "free-pro-team@latest" %} -By default, you will receive {% data variables.product.prodname_dependabot_alerts %} by email, grouped by the specific vulnerability. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-options)." +By default, you will receive {% data variables.product.prodname_dependabot_alerts %} by email, grouped by the specific vulnerability. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-notification-options)." {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %} -By default, if your site administrator has configured email for notifications on your instance, you will receive {% data variables.product.prodname_dependabot_alerts %} by email. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-options)." +By default, if your site administrator has configured email for notifications on your instance, you will receive {% data variables.product.prodname_dependabot_alerts %} by email. You can also choose to receive {% data variables.product.prodname_dependabot_alerts %} in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-dependabot-alerts-notification-options)." {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion == "enterprise-server@2.21" %} -By default, if your site administrator has configured email for notifications on your instance, you will receive security alerts by email. You can also choose to receive security alerts in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#security-alert-options)." +By default, if your site administrator has configured email for notifications on your instance, you will receive security alerts by email. You can also choose to receive security alerts in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#security-alert-notification-options)." {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.21" %} diff --git a/translations/zh-CN/content/github/managing-security-vulnerabilities/about-github-security-advisories.md b/translations/zh-CN/content/github/managing-security-vulnerabilities/about-github-security-advisories.md index bb94f17fa640..50d915a89473 100644 --- a/translations/zh-CN/content/github/managing-security-vulnerabilities/about-github-security-advisories.md +++ b/translations/zh-CN/content/github/managing-security-vulnerabilities/about-github-security-advisories.md @@ -34,9 +34,9 @@ versions: ### CVE 识别号 -{% data variables.product.prodname_security_advisories %} builds upon the foundation of the Common Vulnerabilities and Exposures (CVE) list. {% data variables.product.prodname_dotcom %} is a CVE Numbering Authority (CNA) and is authorized to assign CVE identification numbers. For more information, see "[About CVE](https://cve.mitre.org/about/index.html)" and "[CVE Numbering Authorities](https://cve.mitre.org/cve/cna.html)" on the CVE website. +{% data variables.product.prodname_security_advisories %} 基于通用漏洞披露 (CVE) 列表而构建。 {% data variables.product.prodname_dotcom %} 是 CVE 编号颁发机构 (CNA)，被授权分配 CVE 标识号。 更多信息请参阅 CVE 网站上的“[关于 CVE](https://cve.mitre.org/about/index.html)”和“[CVE 编号颁发机构](https://cve.mitre.org/cve/cna.html)”。 -When you create a security advisory for a public repository on {% data variables.product.prodname_dotcom %}, you have the option of providing an existing CVE identification number for the security vulnerability. {% data reusables.repositories.request-security-advisory-cve-id %} +在 {% data variables.product.prodname_dotcom %} 上为公共仓库创建安全通告时，您可以选择为安全漏洞提供现有的 CVE 标识号。 {% data reusables.repositories.request-security-advisory-cve-id %} 在您发布了安全通告并且 {% data variables.product.prodname_dotcom %} 为漏洞分配 CVE 标识号后，{% data variables.product.prodname_dotcom %} 会将 CVE 发布到 MITRE 数据库。 更多信息请参阅“[发布安全通告](/github/managing-security-vulnerabilities/publishing-a-security-advisory#requesting-a-cve-identification-number)”。 diff --git a/translations/zh-CN/content/github/managing-security-vulnerabilities/adding-a-security-policy-to-your-repository.md b/translations/zh-CN/content/github/managing-security-vulnerabilities/adding-a-security-policy-to-your-repository.md index 289c3856c794..f4d906143c2e 100644 --- a/translations/zh-CN/content/github/managing-security-vulnerabilities/adding-a-security-policy-to-your-repository.md +++ b/translations/zh-CN/content/github/managing-security-vulnerabilities/adding-a-security-policy-to-your-repository.md @@ -37,6 +37,6 @@ versions: ### 延伸阅读 -- "[About securing your repository](/github/administering-a-repository/about-securing-your-repository)" +- “[关于保护仓库](/github/administering-a-repository/about-securing-your-repository)” - "[设置健康参与的项目](/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions)" - [{% data variables.product.prodname_security %}]({% data variables.product.prodname_security_link %}) diff --git a/translations/zh-CN/content/github/managing-security-vulnerabilities/browsing-security-vulnerabilities-in-the-github-advisory-database.md b/translations/zh-CN/content/github/managing-security-vulnerabilities/browsing-security-vulnerabilities-in-the-github-advisory-database.md index 1b74e3181a0f..23912381cc7d 100644 --- a/translations/zh-CN/content/github/managing-security-vulnerabilities/browsing-security-vulnerabilities-in-the-github-advisory-database.md +++ b/translations/zh-CN/content/github/managing-security-vulnerabilities/browsing-security-vulnerabilities-in-the-github-advisory-database.md @@ -9,13 +9,13 @@ versions: {% data reusables.repositories.a-vulnerability-is %} -{% data variables.product.product_name %} will send you {% data variables.product.prodname_dependabot_alerts %} if we detect that any of the vulnerabilities from the {% data variables.product.prodname_advisory_database %} affect the packages that your repository depends on. 更多信息请参阅“[关于易受攻击的依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)”。 +如果我们检测到 {% data variables.product.prodname_advisory_database %} 中存在会影响您的仓库所依赖的软件包的任何漏洞，{% data variables.product.product_name %} 将会向您发送 {% data variables.product.prodname_dependabot_alerts %}。 更多信息请参阅“[关于易受攻击的依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)”。 ### 关于 {% data variables.product.prodname_advisory_database %} {% data variables.product.prodname_advisory_database %} 包含已映射到 {% data variables.product.company_short %} 依赖关系图跟踪的软件包的安全漏洞列表。 {% data reusables.repositories.tracks-vulnerabilities %} -Each security advisory contains information about the vulnerability, including the description, severity, affected package, package ecosystem, affected versions and patched versions, impact, and optional information such as references, workarounds, and credits. 此外，国家漏洞数据库列表中的公告包含 CVE 记录链接，通过链接可以查看漏洞、其 CVSS 得分及其质化严重等级的更多详细信息。 更多信息请参阅国家标准和技术研究所 (National Institute of Standards and Technology) 的“[国家漏洞数据库](https://nvd.nist.gov/)”。 +每个安全通告都包含有关漏洞的信息，包括说明、严重程度、受影响的包、包生态系统、受影响的版本和修补版本、影响以及可选信息（如引用、解决方法和积分）。 此外，国家漏洞数据库列表中的公告包含 CVE 记录链接，通过链接可以查看漏洞、其 CVSS 得分及其质化严重等级的更多详细信息。 更多信息请参阅国家标准和技术研究所 (National Institute of Standards and Technology) 的“[国家漏洞数据库](https://nvd.nist.gov/)”。 我们在[常见漏洞评分系统 (CVSS) 第 2.1.2 节](https://www.first.org/cvss/specification-document)中定义了以下四种可能的严重性等级： - 低 @@ -23,14 +23,14 @@ Each security advisory contains information about the vulnerability, including t - 高 - 关键 -The {% data variables.product.prodname_advisory_database %} uses CVSS version 3.0 standards and the CVSS levels described above. {% data variables.product.product_name %} doesn't publish CVSS scores. +{% data variables.product.prodname_advisory_database %} 使用 CVSS 版本 3.0 标准和上述 CVSS 级别。 {% data variables.product.product_name %} 不发布 CVSS 分数。 {% data reusables.repositories.github-security-lab %} ### 访问 {% data variables.product.prodname_advisory_database %} 中的通告 1. 导航到 https://github.com/advisories。 -2. Optionally, to filter the list, use any of the drop-down menus. ![下拉过滤器](/assets/images/help/security/advisory-database-dropdown-filters.png) +2. （可选）要过滤列表，请使用任意下拉菜单。 ![下拉过滤器](/assets/images/help/security/advisory-database-dropdown-filters.png) 3. 单击任何通告以查看详情。 {% note %} diff --git a/translations/zh-CN/content/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates.md b/translations/zh-CN/content/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates.md index 97938f9aa441..17d581a5328f 100644 --- a/translations/zh-CN/content/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates.md +++ b/translations/zh-CN/content/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates.md @@ -23,12 +23,12 @@ versions: {% note %} -**注** -{% data variables.product.prodname_dependabot_security_updates %} 只解决依赖关系图跟踪的依赖项中的安全漏洞。 安全更新创建的目标不是解决托管在私有仓库中的私有注册表或包中的漏洞。 但是，如果间接或过渡的依赖项已在锁定文件或类似文件中明确定义，则会包含在内。 更多信息请参阅“[关于依赖关系图](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)”。 此外，对于被检测出漏洞的依赖项，必须强调 {% data variables.product.prodname_dependabot_security_updates %} 自动使用建议用于锁定文件的修复程序创建拉取请求。 +**注** +{% data variables.product.prodname_dependabot_security_updates %} only resolve security vulnerabilities in the dependencies tracked by your dependency graph. 安全更新创建的目标不是解决托管在私有仓库中的私有注册表或包中的漏洞。 但是，如果间接或过渡的依赖项已在锁定文件或类似文件中明确定义，则会包含在内。 更多信息请参阅“[关于依赖关系图](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)”。 此外，对于被检测出漏洞的依赖项，必须强调 {% data variables.product.prodname_dependabot_security_updates %} 自动使用建议用于锁定文件的修复程序创建拉取请求。 {% endnote %} -您可以为任何使用 {% data variables.product.prodname_dependabot_short %} 警报和依赖关系图的仓库启用 {% data variables.product.prodname_dependabot_security_updates %}。 您可以对个别仓库或所有由您的用户帐户或组织拥有的仓库禁用 {% data variables.product.prodname_dependabot_security_updates %}。 For more information, see "[Managing {% data variables.product.prodname_dependabot_security_updates %} for your repositories](#managing-github-dependabot-security-updates-for-your-repositories)" below. +您可以为任何使用 {% data variables.product.prodname_dependabot_short %} 警报和依赖关系图的仓库启用 {% data variables.product.prodname_dependabot_security_updates %}。 您可以对个别仓库或所有由您的用户帐户或组织拥有的仓库禁用 {% data variables.product.prodname_dependabot_security_updates %}。 更多信息请参阅下面的“[管理仓库的 {% data variables.product.prodname_dependabot_security_updates %}](#managing-github-dependabot-security-updates-for-your-repositories)”。 {% data reusables.dependabot.dependabot-tos %} @@ -38,18 +38,18 @@ versions: {% note %} -**Note**: You can manually enable {% data variables.product.prodname_dependabot_security_updates %}, even if the repository doesn't meet some of the prerequisites below. For example, you can enable {% data variables.product.prodname_dependabot_security_updates %} on a fork, or for a package manager that isn't directly supported by following the instructions in "[Managing {% data variables.product.prodname_dependabot_security_updates %} for your repositories](#managing-github-dependabot-security-updates-for-your-repositories)." +**注**：您可以手动启用 {% data variables.product.prodname_dependabot_security_updates %}，即使仓库不符合以下某些先决条件。 例如，您可以按照“[管理仓库的 {% data variables.product.prodname_dependabot_security_updates %}](#managing-github-dependabot-security-updates-for-your-repositories)”中的说明，在复刻上或对于不直接支持的包管理器启用 {% data variables.product.prodname_dependabot_security_updates %}。 {% endnote %} -| 自动启用前提条件 | 更多信息 | -| ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | -| 存储库不是复刻 | "[关于复刻](/github/collaborating-with-issues-and-pull-requests/about-forks)" | -| 仓库未存档 | "[存档仓库](/github/creating-cloning-and-archiving-repositories/archiving-repositories)" | -| 仓库是公共的，或者仓库是私有的但您在仓库的设置中启用了 {% data variables.product.prodname_dotcom %} 只读分析、依赖关系图和漏洞警报。 | “[管理私有仓库的数据使用设置](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository)”。 | -| 仓库包含软件包生态系统中 {% data variables.product.prodname_dotcom %} 支持的依赖项清单文件 | "[支持的软件包生态系统](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph#supported-package-ecosystems)" | +| 自动启用前提条件 | 更多信息 | +| ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | +| 存储库不是复刻 | "[关于复刻](/github/collaborating-with-issues-and-pull-requests/about-forks)" | +| 仓库未存档 | "[存档仓库](/github/creating-cloning-and-archiving-repositories/archiving-repositories)" | +| 仓库是公共的，或者仓库是私有的但您在仓库的设置中启用了 {% data variables.product.prodname_dotcom %} 只读分析、依赖关系图和漏洞警报。 | “[管理私有仓库的数据使用设置](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository)”。 | +| 仓库包含软件包生态系统中 {% data variables.product.prodname_dotcom %} 支持的依赖项清单文件 | "[支持的软件包生态系统](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph#supported-package-ecosystems)" | | {% data variables.product.prodname_dependabot_security_updates %} 未对仓库禁用 | "[管理仓库的 {% data variables.product.prodname_dependabot_security_updates %}](#managing-github-dependabot-security-updates-for-your-repositories)" | -| 仓库尚未使用集成进行依赖项管理 | “[关于集成](/github/customizing-your-github-workflow/about-integrations)” | +| 仓库尚未使用集成进行依赖项管理 | “[关于集成](/github/customizing-your-github-workflow/about-integrations)” | 如果未为存储库启用安全更新，并且您不知道原因么，请先尝试使用以下程序部分的说明启用它们。 如果安全更新还是不工作，您可以[联系支持](https://support.github.com/contact)。 @@ -57,11 +57,11 @@ versions: {% data variables.product.prodname_dependabot_security_updates %} 还包括兼容性分数，以便您了解更新漏洞是否可能导致对项目的重大更改。 我们从已生成特定安全更新的公共仓库中查看此前通过的 CI 测试，以了解更新是否会导致测试失败。 更新的兼容性分数是在依赖项的相关版本之间进行更新时，CI 运行被视为通过的百分比。 -### Managing {% data variables.product.prodname_dependabot_security_updates %} for your repositories +### 管理仓库的 {% data variables.product.prodname_dependabot_security_updates %} 您可以对单个仓库启用或禁用 {% data variables.product.prodname_dependabot_security_updates %}。 -You can also enable or disable {% data variables.product.prodname_dependabot_security_updates %} for all repositories owned by your user account or organization. For more information, see "[Managing security and analysis settings for your user account](/github/setting-up-and-managing-your-github-user-account/managing-security-and-analysis-settings-for-your-user-account)" or "[Managing security and analysis settings for your organization](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization)." +您也可以为用户帐户或组织拥有的所有仓库启用或禁用 {% data variables.product.prodname_dependabot_security_updates %}。 更多信息请参阅“[管理用户帐户的安全和分析设置](/github/setting-up-and-managing-your-github-user-account/managing-security-and-analysis-settings-for-your-user-account)”或“[管理组织的安全和分析设置](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization)”。 {% data variables.product.prodname_dependabot_security_updates %} 需要特定的仓库设置。 更多信息请参阅“[支持的仓库](#supported-repositories)”。 diff --git a/translations/zh-CN/content/github/managing-security-vulnerabilities/creating-a-security-advisory.md b/translations/zh-CN/content/github/managing-security-vulnerabilities/creating-a-security-advisory.md index 1e1be57775bb..58679f0454da 100644 --- a/translations/zh-CN/content/github/managing-security-vulnerabilities/creating-a-security-advisory.md +++ b/translations/zh-CN/content/github/managing-security-vulnerabilities/creating-a-security-advisory.md @@ -21,7 +21,7 @@ versions: 5. 键入安全通告的标题。 ![标题字段](/assets/images/help/security/security-advisory-title.png) {% data reusables.repositories.security-advisory-edit-details %} {% data reusables.repositories.security-advisory-edit-description %} -8. Click **Create security advisory**. ![Create security advisory button](/assets/images/help/security/security-advisory-create-security-advisory-button.png) +8. 单击 **Create security advisory（创建安全通告）**。 ![创建安全通告按钮。](/assets/images/help/security/security-advisory-create-security-advisory-button.png) ### 后续步骤 diff --git a/translations/zh-CN/content/github/managing-security-vulnerabilities/editing-a-security-advisory.md b/translations/zh-CN/content/github/managing-security-vulnerabilities/editing-a-security-advisory.md index 70729143933b..47c430391a49 100644 --- a/translations/zh-CN/content/github/managing-security-vulnerabilities/editing-a-security-advisory.md +++ b/translations/zh-CN/content/github/managing-security-vulnerabilities/editing-a-security-advisory.md @@ -19,7 +19,7 @@ versions: {% data reusables.repositories.sidebar-security %} {% data reusables.repositories.sidebar-advisories %} 4. 在“Security Advisories（安全通告）”列表中，单击您要编辑的安全通告。 -5. In the upper-right corner of the details for the security advisory, click +5. 在安全通告详细信息的右上角，单击 {% octicon "pencil" aria-label="The edit icon" %}. ![安全通告的编辑按钮](/assets/images/help/security/security-advisory-edit-button.png) {% data reusables.repositories.security-advisory-edit-details %} diff --git a/translations/zh-CN/content/github/managing-security-vulnerabilities/managing-security-vulnerabilities-in-your-project.md b/translations/zh-CN/content/github/managing-security-vulnerabilities/managing-security-vulnerabilities-in-your-project.md index 89f6fd747463..141725e0a582 100644 --- a/translations/zh-CN/content/github/managing-security-vulnerabilities/managing-security-vulnerabilities-in-your-project.md +++ b/translations/zh-CN/content/github/managing-security-vulnerabilities/managing-security-vulnerabilities-in-your-project.md @@ -1,6 +1,6 @@ --- title: 管理项目中的安全漏洞 -intro: 您可以发现、讨论、修复和披露仓库中的安全漏洞。 +intro: '您可以发现、讨论、修复和披露仓库中的安全漏洞。' mapTopic: true redirect_from: - /articles/managing-security-vulnerabilities-in-your-project diff --git a/translations/zh-CN/content/github/managing-security-vulnerabilities/managing-vulnerabilities-in-your-projects-dependencies.md b/translations/zh-CN/content/github/managing-security-vulnerabilities/managing-vulnerabilities-in-your-projects-dependencies.md index 848a7a97b880..81083d1f3959 100644 --- a/translations/zh-CN/content/github/managing-security-vulnerabilities/managing-vulnerabilities-in-your-projects-dependencies.md +++ b/translations/zh-CN/content/github/managing-security-vulnerabilities/managing-vulnerabilities-in-your-projects-dependencies.md @@ -1,6 +1,6 @@ --- title: 管理项目依赖项中的漏洞 -intro: '您可以跟踪仓库的依赖项，在 {% data variables.product.product_name %} 检测到有漏洞的依赖项时接收{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}安全警报{% endif %}。' +intro: 'You can track your repository''s dependencies and receive {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} when {% data variables.product.product_name %} detects vulnerable dependencies.' mapTopic: true redirect_from: - /articles/updating-your-project-s-dependencies/ diff --git a/translations/zh-CN/content/github/managing-security-vulnerabilities/publishing-a-security-advisory.md b/translations/zh-CN/content/github/managing-security-vulnerabilities/publishing-a-security-advisory.md index e1c7830b5714..babf154b6929 100644 --- a/translations/zh-CN/content/github/managing-security-vulnerabilities/publishing-a-security-advisory.md +++ b/translations/zh-CN/content/github/managing-security-vulnerabilities/publishing-a-security-advisory.md @@ -12,38 +12,38 @@ versions: ### 基本要求 -Before you can publish a security advisory or request a CVE identification number, you must create a draft security advisory and provide information about the versions of your project affected by the security vulnerability. 更多信息请参阅“[创建安全通告](/github/managing-security-vulnerabilities/creating-a-security-advisory)”。 +在发布安全通告或申请 CVE 标识号之前，必须创建安全通告草稿，并提供受安全漏洞影响的项目版本的相关信息。 更多信息请参阅“[创建安全通告](/github/managing-security-vulnerabilities/creating-a-security-advisory)”。 如果您已创建安全通告，但尚未提供有关安全漏洞影响的项目版本的详细信息，则可以编辑安全通告。 更多信息请参阅“[编辑安全通告](/github/managing-security-vulnerabilities/editing-a-security-advisory)”。 ### 关于发布安全通告 -When you publish a security advisory, you notify your community about the security vulnerability that the security advisory addresses. Publishing a security advisory makes it easier for your community to update package dependencies and research the impact of the security vulnerability. +发布安全通告时，会通知您的社区关于该安全通告解决的安全漏洞。 发布安全通告使您的社区能够更轻松地更新包依赖项和研究安全漏洞的影响。 {% data reusables.repositories.security-advisories-republishing %} -Before you publish a security advisory, you can privately collaborate to fix the vulnerability in a temporary private fork. 更多信息请参阅“[在临时私有复刻中协作以解决安全漏洞](/articles/collaborating-in-a-temporary-private-fork-to-resolve-a-security-vulnerability)”。 +在发布安全通告之前，您可以私下协作在临时私有复刻中修复漏洞。 更多信息请参阅“[在临时私有复刻中协作以解决安全漏洞](/articles/collaborating-in-a-temporary-private-fork-to-resolve-a-security-vulnerability)”。 -When you publish a draft advisory from a public repository, everyone is able to see: +从公共仓库发布通告草稿时，每个人都可以看到： -- The current version of the advisory data. -- Any advisory credits that the credited users have accepted. +- 通告数据的当前版本。 +- 积分用户已接受的任何通告积分。 {% note %} -**Note**: The general public will never have access to the edit history of the advisory, and will only see the published version. +**注**：公众无权查看通告的编辑历史记录，只能看到已发布的版本。 {% endnote %} -发布安全通告后，安全通告的 URL 将与发布安全通告之前保持相同。 对仓库具有读取权限的任何人都能看到安全通告。 Collaborators on the security advisory can continue to view past conversations, including the full comment stream, in the security advisory unless someone with admin permissions removes the collaborator from the security advisory. +发布安全通告后，安全通告的 URL 将与发布安全通告之前保持相同。 对仓库具有读取权限的任何人都能看到安全通告。 安全通告的协作者可以继续查看安全通告中过去的对话，包括完整的评论流，除非有管理员权限的人从安全通告删除该协作者。 如果需要更新或更正已发布的安全通告中的信息，可以编辑安全通告。 更多信息请参阅“[编辑安全通告](/github/managing-security-vulnerabilities/editing-a-security-advisory)”。 ### 申请 CVE 识别号 -Anyone with admin permissions to a security advisory can request a CVE identification number for the security advisory. +对安全通告具有管理员权限的任何人都可以为安全通告申请 CVE 标识号。 -{% data reusables.repositories.request-security-advisory-cve-id %} For more information, see "[About {% data variables.product.prodname_security_advisories %}](/github/managing-security-vulnerabilities/about-github-security-advisories#cve-identification-numbers)." +{% data reusables.repositories.request-security-advisory-cve-id %} 更多信息请参阅“[关于 {% data variables.product.prodname_security_advisories %}](/github/managing-security-vulnerabilities/about-github-security-advisories#cve-identification-numbers)”。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-security %} @@ -54,7 +54,7 @@ Anyone with admin permissions to a security advisory can request a CVE identific ### 发布安全通告 -Publishing a security advisory deletes the temporary private fork for the security advisory. +发布安全通告会删除该安全通告的临时私有复刻。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-security %} diff --git a/translations/zh-CN/content/github/managing-security-vulnerabilities/removing-a-collaborator-from-a-security-advisory.md b/translations/zh-CN/content/github/managing-security-vulnerabilities/removing-a-collaborator-from-a-security-advisory.md index df6779fe3f26..40a3160ce245 100644 --- a/translations/zh-CN/content/github/managing-security-vulnerabilities/removing-a-collaborator-from-a-security-advisory.md +++ b/translations/zh-CN/content/github/managing-security-vulnerabilities/removing-a-collaborator-from-a-security-advisory.md @@ -1,6 +1,6 @@ --- title: 从安全通告删除协作者 -intro: 协作者从安全通告中删除后，将失去对安全通告的讨论和元数据的读取和写入权限。 +intro: '协作者从安全通告中删除后，将失去对安全通告的讨论和元数据的读取和写入权限。' versions: free-pro-team: '*' --- diff --git a/translations/zh-CN/content/github/managing-security-vulnerabilities/troubleshooting-the-detection-of-vulnerable-dependencies.md b/translations/zh-CN/content/github/managing-security-vulnerabilities/troubleshooting-the-detection-of-vulnerable-dependencies.md index 14d21d6405d4..e9425cb934d9 100644 --- a/translations/zh-CN/content/github/managing-security-vulnerabilities/troubleshooting-the-detection-of-vulnerable-dependencies.md +++ b/translations/zh-CN/content/github/managing-security-vulnerabilities/troubleshooting-the-detection-of-vulnerable-dependencies.md @@ -1,99 +1,99 @@ --- -title: Troubleshooting the detection of vulnerable dependencies -intro: 'If the dependency information reported by {% data variables.product.product_name %} is not what you expected, there are a number of points to consider, and various things you can check.' +title: 漏洞依赖项检测疑难解答 +intro: '如果 {% data variables.product.product_name %} 报告的依赖项信息不符合您的预期，则需要考虑许多因素，您可以检查各种问题。' versions: free-pro-team: '*' --- -The results of dependency detection reported by {% data variables.product.product_name %} may be different from the results returned by other tools. There are good reasons for this and it's helpful to understand how {% data variables.product.prodname_dotcom %} determines dependencies for your project. +{% data variables.product.product_name %} 报告的依赖项检测结果可能不同于其他工具返回的结果。 这是有原因的，它有助于了解 {% data variables.product.prodname_dotcom %} 如何确定项目的依赖项。 -### Why do some dependencies seem to be missing? +### 为什么似乎缺少某些依赖项？ -{% data variables.product.prodname_dotcom %} generates and displays dependency data differently than other tools. Consequently, if you've been using another tool to identify dependencies you will almost certainly see different results. Consider the following: +{% data variables.product.prodname_dotcom %} 生成和显示依赖项数据不同于其他工具。 因此，如果您过去使用其他工具来识别依赖项，则几乎可以肯定您会看到不同的结果。 考虑以下事项： -* {% data variables.product.prodname_advisory_database %} is one of the data sources that {% data variables.product.prodname_dotcom %} uses to identify vulnerable dependencies. It's a free, curated database of vulnerability information for common package ecosystems on {% data variables.product.prodname_dotcom %}. It includes both data reported directly to {% data variables.product.prodname_dotcom %} from {% data variables.product.prodname_security_advisories %}, as well as official feeds and community sources. This data is reviewed and curated by {% data variables.product.prodname_dotcom %} to ensure that false or unactionable information is not shared with the development community. For more information, see "[Browsing security vulnerabilities in the {% data variables.product.prodname_advisory_database %}](/github/managing-security-vulnerabilities/browsing-security-vulnerabilities-in-the-github-advisory-database)" and "[About {% data variables.product.prodname_security_advisories %}](/github/managing-security-vulnerabilities/about-github-security-advisories)." -* The dependency graph parses all known package manifest files in a user’s repository. For example, for npm it will parse the _package-lock.json_ file. It constructs a graph of all of the repository’s dependencies and public dependents. This happens when you enable the dependency graph and when anyone pushes to the default branch, and it includes commits that makes changes to a supported manifest format. 更多信息请参阅“[关于依赖关系图](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)”。 -* {% data variables.product.prodname_dependabot_short %} scans any push, to the default branch, that contains a manifest file. When a new vulnerability record is added, it scans all existing repositories and generates an alert for each vulnerable repository. {% data variables.product.prodname_dependabot_short %} alerts are aggregated at the repository level, rather than creating one alert per vulnerability. 更多信息请参阅“[关于易受攻击的依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)”。 -* {% data variables.product.prodname_dependabot_security_updates %} are triggered when you receive a security alert about a vulnerable dependency in your repository. {% data variables.product.prodname_dotcom %} automatically creates a pull request in your repository to upgrade the vulnerable dependency to the minimum possible secure version needed to avoid the vulnerability. 更多信息请参阅“[配置 {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)”。 +* {% data variables.product.prodname_advisory_database %} 是 {% data variables.product.prodname_dotcom %} 用来识别漏洞依赖项的数据源之一。 它是一款免费的、具有整理功能的数据库，用于检测 {% data variables.product.prodname_dotcom %} 上常见软件包生态系统的漏洞信息。 它包括从 {% data variables.product.prodname_security_advisories %} 直接报告给 {% data variables.product.prodname_dotcom %} 的数据，以及官方馈送和社区来源。 这些数据由 {% data variables.product.prodname_dotcom %} 审查和整理，以确保不会与开发社区分享虚假或不可行的信息。 更多信息请参阅“[浏览 {% data variables.product.prodname_advisory_database %} 中的安全漏洞](/github/managing-security-vulnerabilities/browsing-security-vulnerabilities-in-the-github-advisory-database)”和“[关于 {% data variables.product.prodname_security_advisories %}](/github/managing-security-vulnerabilities/about-github-security-advisories)”。 +* 依赖项图解析用户仓库中所有已知的包清单文件。 例如，对于 npm，它将解析 _package-lock.json_ 文件。 它构造所有仓库依赖项和公共依赖项的图表。 当启用依赖关系图时，当任何人推送到默认分支时，都会发生这种情况，其中包括对支持的清单格式进行更改的提交。 更多信息请参阅“[关于依赖关系图](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)”。 +* {% data variables.product.prodname_dependabot_short %} 扫描对包含清单文件的默认分支的任何推送。 添加新的漏洞记录时，它会扫描所有现有仓库，并为每个存在漏洞的仓库生成警报。 {% data variables.product.prodname_dependabot_short %} 警报在仓库级别汇总，而不是针对每个漏洞创建一个警报。 更多信息请参阅“[关于易受攻击的依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)”。 +* {% data variables.product.prodname_dependabot_security_updates %} 在您收到关于仓库中漏洞依赖项的安全警报时触发。 {% data variables.product.prodname_dotcom %} 会自动在您的仓库中创建拉取请求，以将漏洞依赖项升级到避免漏洞所需的最低安全版本。 更多信息请参阅“[配置 {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)。” - {% data variables.product.prodname_dependabot_short %} doesn't scan repositories on a schedule, but rather when something changes. For example, a scan is triggered when a new dependency is added ({% data variables.product.prodname_dotcom %} checks for this on every push), or when a new vulnerability is discovered and added to the advisory database. + {% data variables.product.prodname_dependabot_short %} 不会按计划扫描仓库，而是在发生某些变更时扫描仓库。 例如，当新的依赖项被添加到 {% data variables.product.prodname_dotcom %} 时（对于每次推送都会进行此项检查），或者当新的漏洞被发现并添加到通告数据库时，就会触发扫描。 -### Why don't I get vulnerability alerts for some ecosystems? +### 为什么我没有收到某些生态系统的漏洞警报？ -{% data variables.product.prodname_dotcom %} limits its support for vulnerability alerts to a set of ecosystems where we can provide high-quality, actionable data. Curated vulnerabilities in the {% data variables.product.prodname_advisory_database %}, the dependency graph, {% data variables.product.prodname_dependabot_short %} alerts, and {% data variables.product.prodname_dependabot_short %} security updates are provided for several ecosystems, including Java’s Maven, JavaScript’s npm and Yarn, .NET’s NuGet, Python’s pip, Ruby's RubyGems, and PHP’s Composer. We'll continue to add support for more ecosystems over time. For an overview of the package ecosystems that we support, see "[About the dependency graph](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph#supported-package-ecosystems)." +{% data variables.product.prodname_dotcom %} 对漏洞警报的支持限于一组可提供高质量、可操作数据的生态系统。 {% data variables.product.prodname_advisory_database %} 中经整理的漏洞、依赖关系图、{% data variables.product.prodname_dependabot_short %} 警报和 {% data variables.product.prodname_dependabot_short %} 安全更新等功能适用于多个生态系统，包括 Java’s Maven、JavaScript’s npm 和 Yarn、.NET’s NuGet、Python’s pip、Ruby's RubyGems 以及 PHP’s Composer。 我们将在今后继续增加对更多生态系统的支持。 有关我们支持的包生态系统的概述，请参阅“[关于依赖项图](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph#supported-package-ecosystems)”。 -It's worth noting that [{% data variables.product.prodname_dotcom %} Security Advisories](/github/managing-security-vulnerabilities/about-github-security-advisories) may exist for other ecosystems. The information in a security advisory is provided by the maintainers of a particular repository. This data is not curated in the same way as information for the supported ecosystems. +值得注意的是，[{% data variables.product.prodname_dotcom %} 安全通告](/github/managing-security-vulnerabilities/about-github-security-advisories)可能存在于其他生态系统中。 安全通告中的信息由特定仓库的维护员提供。 此数据的整理方式与支持的生态系统整理信息的方式不同。 -**Check**: Does the uncaught vulnerability apply to an unsupported ecosystem? +**检查**：未捕获的漏洞是否适用于不受支持的生态系统？ -### Does the dependency graph only find dependencies in manifests and lockfiles? +### 依赖项图是否只查找清单和锁文件中的依赖项？ -The dependency graph includes information on dependencies that are explicitly declared in your environment. That is, dependencies that are specified in a manifest or a lockfile. The dependency graph generally also includes transitive dependencies, even when they aren't specified in a lockfile, by looking at the dependencies of the dependencies in a manifest file. +依赖项图包含在环境中明确声明的依赖项的信息。 也就是说，在清单或锁定文件中指定的依赖项。 依赖项图通常还包括过渡依赖项，即使它们没有在锁定文件中指定，也可以通过查看清单文件中的依赖项来实现。 -{% data variables.product.prodname_dependabot_short %} alerts advise you about dependencies you should update, including transitive dependencies, where the version can be determined from a manifest or a lockfile. {% data variables.product.prodname_dependabot_short %} security updates only suggests a change where it can directly "fix" the dependency, that is, when these are: -* Direct dependencies explicitly declared in a manifest or lockfile -* Transitive dependencies declared in a lockfile +{% data variables.product.prodname_dependabot_short %} 警报提醒您应更新的依赖项，包括可从清单或锁定文件确定版本的过渡依赖项。 {% data variables.product.prodname_dependabot_short %} 安全更新仅在可直接“修复”依赖项的情况下建议更改，即，在以下情况下： +* 在清单或锁定文件中明确声明的直接依赖项 +* 在锁定文件中声明的过渡依赖项 -The dependency graph doesn't include “loose” dependencies. “Loose” dependencies are individual files that are copied from another source and checked into the repository directly or within an archive (such as a ZIP or JAR file), rather than being referenced by in a package manager’s manifest or lockfile. +依赖项图不包括“宽松”依赖项。 “宽松”依赖项是指从另一个来源复制并直接或在存档文件（例如 ZIP 或 JAR 文件）中检入仓库的单个文件，而不是在包管理器的清单或锁定文件中引用的文件。 -**Check**: Is the uncaught vulnerability for a component that's not specified in the repository's manifest or lockfile? +**检查k**：是否存在仓库清单或锁定文件中未指定组件的未捕获漏洞？ -### Does the dependency graph detect dependencies specified using variables? +### 依赖项图是否检测使用变量指定的依赖项？ -The dependency graph analyzes manifests as they’re pushed to {% data variables.product.prodname_dotcom %}. The dependency graph doesn't, therefore, have access to the build environment of the project, so it can't resolve variables used within manifests. If you use variables within a manifest to specify the name, or more commonly the version of a dependency, then that dependency will not be included in the dependency graph. +依赖项图在清单被推送到 {% data variables.product.prodname_dotcom %} 时分析它们。 因此，依赖项图无法访问项目的构建环境，从而无法解析清单中使用的变量。 如果在清单中使用变量指定名称，或指定依赖项的版本（更常见），则该依赖项不会包括在依赖项图中。 -**Check**: Is the missing dependency declared in the manifest by using a variable for its name or version? +**检查**: 在清单中缺少的依赖项是否使用变量声明其名称或版本？ -### Are there limits which affect the dependency graph data? +### 是否存在影响依赖项图数据的限制？ -Yes, the dependency graph has two categories of limits: +是的，依赖项图有两个限制类别： -1. **Processing limits** +1. **处理限制** - These affect the dependency graph displayed within {% data variables.product.prodname_dotcom %} and also prevent {% data variables.product.prodname_dependabot_short %} alerts being created. + 这会影响 {% data variables.product.prodname_dotcom %} 中显示的依赖项图，还会阻止 {% data variables.product.prodname_dependabot_short %} 警报的创建。 - Manifests over 0.5 MB in size are only processed for enterprise accounts. For other accounts, manifests over 0.5 MB are ignored and will not create {% data variables.product.prodname_dependabot_short %} alerts. + 仅为企业帐户处理大小超过 0.5 MB 的清单。 对于其他帐户，将忽略超过 0.5 MB 的清单，并且不会创建 {% data variables.product.prodname_dependabot_short %} 警报。 - By default, {% data variables.product.prodname_dotcom %} will not process more than 20 manifests per repository. {% data variables.product.prodname_dependabot_short %} alerts are not be created for manifests beyond this limit. If you need to increase the limit, contact {% data variables.contact.contact_support %}. + 默认情况下， {% data variables.product.prodname_dotcom %} 对每个仓库处理的清单不会超过 20 个。 对于超出此限制的清单，不会创建 {% data variables.product.prodname_dependabot_short %} 警报。 如果您需要提高限值，请联系 {% data variables.contact.contact_support %}。 -2. **Visualization limits** +2. **可视化限制** - These affect what's displayed in the dependency graph within {% data variables.product.prodname_dotcom %}. However, they don't affect the {% data variables.product.prodname_dependabot_short %} alerts that are created. + 这会影响 {% data variables.product.prodname_dotcom %} 中依赖项图的显示内容。 但是，它们不会影响 {% data variables.product.prodname_dependabot_short %} 警报的创建。 - The Dependencies view of the dependency graph for a repository only displays 100 manifests. Typically this is adequate as it is significantly higher than the processing limit described above. In situations where the processing limit is over 100, {% data variables.product.prodname_dependabot_short %} alerts are still created for any manifests that are not shown within {% data variables.product.prodname_dotcom %}. + 仓库依赖项图的依赖项视图只显示 100 个清单。 通常这就足够了，因为它明显高于上述处理限制。 处理限制超过 100 的情况下，对于任何未在 {% data variables.product.prodname_dotcom %} 中显示的任何清单，仍会创建 {% data variables.product.prodname_dependabot_short %} 警报。 -**Check**: Is the missing dependency in a manifest file that's over 0.5 MB, or in a repository with a large number of manifests? +**检查**：在超过 0.5 MB 的清单文件或包含大量清单的仓库中是否存在缺少的依赖项？ -### Does {% data variables.product.prodname_dependabot_short %} generate alerts for vulnerabilities that have been known for many years? +### {% data variables.product.prodname_dependabot_short %} 是否会针对已知多年的漏洞生成警报？ -The {% data variables.product.prodname_advisory_database %} was launched in November 2019, and initially back-filled to include vulnerability information for the supported ecosystems, starting from 2017. When adding CVEs to the database, we prioritize curating newer CVEs, and CVEs affecting newer versions of software. +{% data variables.product.prodname_advisory_database %} 于 2019 年 11 月推出，并在最初回顾性包含了受支持生态系统的漏洞信息（从 2017 年开始）。 将 CVE 添加到数据库时，我们会优先处理较新的 CVE，以及影响较新版本软件的 CVE。 -Some information on older vulnerabilities is available, especially where these CVEs are particularly widespread, however some old vulnerabilities are not included in the {% data variables.product.prodname_advisory_database %}. If there's a specific old vulnerability that you need to be included in the database, contact {% data variables.contact.contact_support %}. +提供了一些有关较旧漏洞的信息，尤其是在这些 CVE 特别普遍的地方，但一些较旧的漏洞未包含在 {% data variables.product.prodname_advisory_database %} 中。 如果您需要将一些特定的旧漏洞包含在数据库中，请联系 {% data variables.contact.contact_support %}。 -**Check**: Does the uncaught vulnerability have a publish date earlier than 2017 in the National Vulnerability Database? +**检查**：未捕获的漏洞在国家漏洞数据库中的发布日期是否早于 2017 年？ -### Why does {% data variables.product.prodname_advisory_database %} use a subset of published vulnerability data? +### 为什么 {% data variables.product.prodname_advisory_database %} 使用已发布漏洞数据的子集？ -Some third-party tools use uncurated CVE data that isn't checked or filtered by a human. This means that CVEs with tagging or severity errors, or other quality issues, will cause more frequent, more noisy, and less useful alerts. +有些第三方工具使用未经人为检查或过滤的未整理 CVE 数据。 这意味着 CVE 带有标签或严重错误或其他质量问题，将导致更频繁，更嘈杂且更无用的警报。 -Since {% data variables.product.prodname_dependabot_short %} uses curated data in the {% data variables.product.prodname_advisory_database %}, the volume of alerts may be lower, but the alerts you do receive will be accurate and relevant. +由于 {% data variables.product.prodname_dependabot_short %} 使用 {% data variables.product.prodname_advisory_database %} 中的精选数据，因此警报量可能较少，但是您收到的警报将是准确和相关的。 -### Does each dependency vulnerability generate a separate alert? +### 是否每个依赖项漏洞都会生成单独的警报？ -When a dependency has multiple vulnerabilities, only one aggregated alert is generated for that dependency, instead of one alert per vulnerability. +当一个依赖项有多个漏洞时，只会为该依赖项生成一个汇总警报，而不是针对每个漏洞生成一个警报。 -The {% data variables.product.prodname_dependabot_short %} alerts count in {% data variables.product.prodname_dotcom %} shows a total for the number of alerts, that is, the number of dependencies with vulnerabilities, not the number of vulnerabilities. +{% data variables.product.prodname_dotcom %} 中的 {% data variables.product.prodname_dependabot_short %} 警报计数显示警报总数，即有漏洞的依赖项数量，而不是漏洞的数量。 -![{% data variables.product.prodname_dependabot_short %} alerts view](/assets/images/help/repository/dependabot-alerts-view.png) +![{% data variables.product.prodname_dependabot_short %} 警报视图](/assets/images/help/repository/dependabot-alerts-view.png) -When you click to display the alert details, you can see how many vulnerabilities are included in the alert. +单击以显示警报详细信息时，您可以查看警报中包含多少个漏洞。 -![Multiple vulnerabilities for a {% data variables.product.prodname_dependabot_short %} alert](/assets/images/help/repository/dependabot-vulnerabilities-number.png) +![{% data variables.product.prodname_dependabot_short %} 警报的多个漏洞](/assets/images/help/repository/dependabot-vulnerabilities-number.png) -**Check**: If there is a discrepancy in the totals you are seeing, check that you are not comparing alert numbers with vulnerability numbers. +**检查**: 如果您所看到的总数有出入，请检查您是否没有将警报数量与漏洞数量进行比较。 ### 延伸阅读 - “[关于有易受攻击依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)” - "[查看和更新仓库中的漏洞依赖项](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)" -- "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)" +- "[管理仓库的安全和分析设置](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)" diff --git a/translations/zh-CN/content/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository.md b/translations/zh-CN/content/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository.md index 6f50243eb4b4..7dcdb610cc21 100644 --- a/translations/zh-CN/content/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository.md +++ b/translations/zh-CN/content/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository.md @@ -10,7 +10,7 @@ versions: 仓库的 {% data variables.product.prodname_dependabot %} 警报选项卡列出所有打开和关闭的 {% data variables.product.prodname_dependabot_alerts %} 以及对应的 {% data variables.product.prodname_dependabot_security_updates %}。 您可以使用下拉菜单对警报列表进行排序，并且可以单击特定警报以获取更多详细信息。 更多信息请参阅“[关于易受攻击的依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)”。 -您可以为使用 {% data variables.product.prodname_dependabot_alerts %} 和依赖关系图的任何仓库启用自动安全更新。 更多信息请参阅“[配置 {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)”。 +您可以为使用 {% data variables.product.prodname_dependabot_alerts %} 和依赖关系图的任何仓库启用自动安全更新。 更多信息请参阅“[配置 {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)。” ### 关于仓库中有漏洞的依赖项的更新 @@ -31,5 +31,5 @@ versions: - “[关于有易受攻击依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)” - "[配置 {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)" -- "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)" -- "[Troubleshooting the detection of vulnerable dependencies](/github/managing-security-vulnerabilities/troubleshooting-the-detection-of-vulnerable-dependencies)" +- "[管理仓库的安全和分析设置](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)" +- "[漏洞依赖项检测疑难解答](/github/managing-security-vulnerabilities/troubleshooting-the-detection-of-vulnerable-dependencies)" diff --git a/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md b/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md index 887048c704ff..c96b5fa0b243 100644 --- a/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md +++ b/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/about-notifications.md @@ -44,7 +44,7 @@ versions: ### 自定义通知和订阅 -您可以选择通过 [https://github.com/notifications](https://github.com/notifications){% if currentVersion == "free-pro-team@latest" %} 上和 {% data variables.product.prodname_mobile %} 应用程序{% endif %}中的通知收件箱、电子邮件或这些选项的某些组合来查看通知。 +You can choose to view your notifications through the notifications inbox at [https://github.com/notifications](https://github.com/notifications){% if currentVersion == "free-pro-team@latest" %} and in the {% data variables.product.prodname_mobile %} app{% endif %}, through your email, or some combination of these options. 要自定义您希望接收的更新类型以及将这些更新发送至何处，请配置通知设置。 更多信息请参阅“[配置通知](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications)”。 @@ -53,7 +53,8 @@ versions: 要自定义如何接收特定拉取请求或议题的更新，可以在议题或拉取请求中配置首选项。 更多信息请参阅“[对单个通知进行分类](/github/managing-subscriptions-and-notifications-on-github/triaging-a-single-notification#customizing-when-to-receive-future-updates-for-an-issue-or-pull-request)”。 {% if currentVersion == "free-pro-team@latest" %} -您可以在 {% data variables.product.prodname_mobile %} 应用程序中启用推送通知。 更多信息请参阅“[配置通知](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#enabling-push-notifications-with-github-for-mobile)”。 +You can enable push notifications in the +{% data variables.product.prodname_mobile %} app. 更多信息请参阅“[配置通知](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#enabling-push-notifications-with-github-for-mobile)”。 {% endif %} ### 接收通知的原因 @@ -82,7 +83,7 @@ versions: ### 自定义通知收件箱 -要在 {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} 或 {% data variables.product.prodname_mobile %}{% endif %} 上的收件箱中关注一组通知，您可以创建自定义过滤器。 例如，您可以为您参与的开源项目创建自定义过滤器，只查看您被提及的仓库的通知。 更多信息请参阅“[从收件箱管理通知](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox)”。 有关如何自定义分类工作流程的更多示例，请参阅“[自定义对通知分类的工作流程](/github/managing-subscriptions-and-notifications-on-github/customizing-a-workflow-for-triaging-your-notifications)”。 +To focus on a group of notifications in your inbox on {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} or {% data variables.product.prodname_mobile %}{% endif %}, you can create custom filters. 例如，您可以为您参与的开源项目创建自定义过滤器，只查看您被提及的仓库的通知。 更多信息请参阅“[从收件箱管理通知](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox)”。 有关如何自定义分类工作流程的更多示例，请参阅“[自定义对通知分类的工作流程](/github/managing-subscriptions-and-notifications-on-github/customizing-a-workflow-for-triaging-your-notifications)”。 ### 通知保留策略 diff --git a/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md b/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md index 35e1284863d2..6045f27f3e3d 100644 --- a/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md +++ b/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/configuring-notifications.md @@ -1,6 +1,6 @@ --- -title: Configuring notifications -intro: 'Choose the type of activity on {% data variables.product.product_name %} that you want to receive notifications for and how you want these updates delivered.' +title: 配置通知 +intro: '选择 {% data variables.product.product_name %} 上您想要接收其通知的活动类型以及您希望如何发送这些更新。' redirect_from: - /articles/about-web-notifications - /format-of-notification-emails/ @@ -18,62 +18,63 @@ versions: enterprise-server: '>=2.21' --- -### Notification delivery options +### 通知递送选项 -You have three basic options for notification delivery: +您有三个基本的通知递送选项： - the notifications inbox on {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} - - the notifications inbox on {% data variables.product.prodname_mobile %}, which syncs with the inbox on {% data variables.product.product_name %}{% endif %} + - {% data variables.product.prodname_mobile %} 上的通知收件箱，它与 {% data variables.product.product_name %} 上的收件箱同步{% endif %} - an email client that uses a verified email address, which can also sync with the notifications inbox on {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} and {% data variables.product.prodname_mobile %}{% endif %} {% if currentVersion == "free-pro-team@latest" %} -{% data reusables.notifications-v2.notifications-inbox-required-setting %} For more information, see "[Choosing your notification settings](#choosing-your-notification-settings)." +{% data reusables.notifications-v2.notifications-inbox-required-setting %} 更多信息请参阅“[选择通知设置](#choosing-your-notification-settings)”。 {% endif %} {% data reusables.notifications-v2.tip-for-syncing-email-and-your-inbox-on-github %} -#### Benefits of the notifications inbox +#### 通知收件箱的优点 The notifications inbox on {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} and {% data variables.product.prodname_mobile %}{% endif %} includes triaging options designed specifically for your {% data variables.product.product_name %} notifications flow, including options to: - - Triage multiple notifications at once. - - Mark completed notifications as **Done** and remove them from your inbox. To view all of your notifications marked as **Done**, use the `is:done` query. - - Save a notification to review later. Saved notifications are flagged in your inbox and kept indefinitely. To view all of your saved notifications, use the `is:saved` query. - - Unsubscribe and remove a notification from your inbox. - - Preview the issue, pull request, or team discussion where the notification originates on {% data variables.product.product_name %} from within the notifications inbox. - - See one of the latest reasons you're receiving a notification from your inbox with a `reasons` label. - - Create custom filters to focus on different notifications when you want. - - Group notifications in your inbox by repository or date to get a quick overview with less context switching + - 一次对多种通知进行分类。 + - 将已完成的通知标记为**完成**并从收件箱中删除它们。 要查看标记为**完成**的所有通知，请使用 `is:done` 查询。 + - 保存通知以供以后查看。 保存的通知将在收件箱中标记并无限期保留。 要查看所有已保存的通知，请使用 `is:saved` 查询。 + - 取消订阅并从收件箱中删除通知。 + - 从通知收件箱预览 {% data variables.product.product_name %} 上产生通知的议题、拉取请求或团队讨论。 + - 使用 `reasons` 标签查看收件箱中收到通知的最新原因之一。 + - 创建自定义过滤器，以便按需要关注不同的通知。 + - 按仓库或日期对收件箱中的通知进行分组，以快速概览通知，减少上下文切换 {% if currentVersion == "free-pro-team@latest" %} -In addition, the notifications inbox on {% data variables.product.prodname_mobile %} allows you to triage notifications in dark mode and receive push notifications for direct mentions. For more information, see "[Enabling push notifications with GitHub for mobile](#enabling-push-notifications-with-github-for-mobile)" or "[GitHub for mobile](/github/getting-started-with-github/github-for-mobile)." +In addition, the notifications inbox on +{% data variables.product.prodname_mobile %} allows you to triage notifications in dark mode and receive push notifications for direct mentions. 更多信息请参阅“[为移动版 GitHub 启用推送通知](#enabling-push-notifications-with-github-for-mobile)”或“[移动版 GitHub](/github/getting-started-with-github/github-for-mobile)”。 {% endif %} -#### Benefits of using an email client for notifications +#### 对通知使用电子邮件客户端的优点 -One benefit of using an email client is that all of your notifications can be kept indefinitely depending on your email client's storage capacity. Your inbox notifications are only kept for 5 months unless you've marked them as **Saved**. **Saved** notifications are kept indefinitely. For more information about your inbox's retention policy, see "[About notifications](/github/managing-subscriptions-and-notifications-on-github/about-notifications#notification-retention-policy)." +使用电子邮件客户端的一个好处是，可以无限期地保留所有通知，具体取决于电子邮件客户端的存储容量。 收件箱通知仅保留 5 个月，除非您将它们标记为 **Saved（已保存）**。 **Saved（已保存）**通知将无限期保留。 有关收件箱保留政策的更多信息，请参阅“[关于通知](/github/managing-subscriptions-and-notifications-on-github/about-notifications#notification-retention-policy)”。 -Sending notifications to your email client also allows you to customize your inbox according to your email client's settings, which can include custom or color-coded labels. +向电子邮件客户端发送通知还允许您根据电子邮件客户端的设置（可以包括自定义或颜色编码的标签）自定义收件箱。 -Email notifications also allow flexibility with the types of notifications you receive and allow you to choose different email addresses for updates. For example, you can send certain notifications for a repository to a verified personal email address. For more information, about your email customization options, see "[Customizing your email notifications](#customizing-your-email-notifications)." +电子邮件通知还允许您灵活地设置收到的通知类型，并允许您选择不同的电子邮件地址进行更新。 例如，您可以向经验证的个人电子邮件地址发送仓库的某些通知。 有关电子邮件自定义选项的更多信息，请参阅“[自定义电子邮件通知](#customizing-your-email-notifications)”。 -### About participating and watching notifications +### 关于参与和查看通知 -When you watch a repository, you're subscribing to updates for activity in that repository. Similarly, when you watch a specific team's discussions, you're subscribing to all conversation updates on that team's page. To see repositories that you're watching, see [https://github.com/watching](https://github.com/watching). For more information, see "[Managing subscriptions and notifications on GitHub](/github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github)." +关注仓库，意味着订阅该仓库中的活动更新。 同样，关注特定团队的讨论，意味着订阅该团队页面上的所有对话更新。 要查看您关注的仓库，请参阅 [https://github.com/watching](https://github.com/watching)。 更多信息请参阅“[在 GitHub 上管理订阅和通知](/github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github)”。 -Anytime you comment in a conversation or when someone @mentions your username, you are _participating_ in a conversation. By default, you are automatically subscribed to a conversation when you participate in it. You can unsubscribe from a conversation you've participated in manually by clicking **Unsubscribe** on the issue or pull request or through the **Unsubscribe** option in the notifications inbox. +每当您在对话中发表评论或有人 @提及您的用户名时，您都在_参与_对话。 默认情况下，当您参与对话时，会自动订阅该对话。 您可以通过单击议题或拉取请求上的 **Unsubscribe（取消订阅）**或通过通知收件箱中的 **Unsubscribe（取消订阅）**选项，手动取消订阅已参与的对话。 For conversations you're watching or participating in, you can choose whether you want to receive notifications by email or through the notifications inbox on {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} and {% data variables.product.prodname_mobile %}{% endif %}. -![Participating and watching notifications options](/assets/images/help/notifications-v2/participating-and-watching-options.png) +![参与和关注通知选项](/assets/images/help/notifications-v2/participating-and-watching-options.png) -For example: - - If you don't want notifications to be sent to your email, unselect **email** for participating and watching notifications. - - If you want to receive notifications by email when you've participated in a conversation, then you can select **email** under "Participating". +例如： + - 如果您不希望将通知发送到您的电子邮件地址，请取消选中 **email（电子邮件）**以便参与和查看通知。 + - 如果您希望在参与对话时通过电子邮件接收通知，则可以选中“Participating（参与）”下的 **email（电子邮件）**。 If you do not enable watching or participating notifications for web{% if currentVersion == "free-pro-team@latest" %} and mobile{% endif %}, then your notifications inbox will not have any updates. -### Customizing your email notifications +### 自定义电子邮件通知 -After enabling email notifications, {% data variables.product.product_name %} will send notifications to you as multipart emails that contain both HTML and plain text copies of the content. Email notification content includes any Markdown, @mentions, emojis, hash-links, and more, that appear in the original content on {% data variables.product.product_name %}. If you only want to see the text in the email, you can configure your email client to display the plain text copy only. +在启用电子邮件通知后，{% data variables.product.product_name %} 将以多部分电子邮件向您发送通知，其中包含内容的 HTML 和明文副本。 电子邮件通知内容包含出现在 {% data variables.product.product_name %} 上的原始内容中的任何 Markdown、@提及、表情符号、哈希链接等。 如果您只想查看电子邮件中的文本，可以配置电子邮件客户端只显示明文副本。 {% data reusables.notifications.outbound_email_tip %} @@ -81,132 +82,135 @@ After enabling email notifications, {% data variables.product.product_name %} wi {% if currentVersion == "free-pro-team@latest" %} -If you're using Gmail, you can click a button beside the notification email to visit the original issue or pull request that generated the notification. +如果您使用 Gmail，可以单击通知电子邮件旁边的按钮访问生成该通知的原始议题或拉取请求。 -![Buttons in Gmail](/assets/images/help/notifications/gmail-buttons.png) +![Gmail 中的按钮](/assets/images/help/notifications/gmail-buttons.png) {% endif %} -Choose a default email address where you want to send updates for conversations you're participating in or watching. You can also specify which activity on {% data variables.product.product_name %} you want to receive updates for using your default email address. For example, choose whether you want updates to your default email from: - - Comments on issues and pull requests. - - Pull request reviews. - - Pull request pushes. - - Your own updates, such as when you open, comment on, or close an issue or pull request. +选择一个默认电子邮件地址，用于发送您参与或关注的对话的更新。 您还可以指定希望使用默认电子邮件地址接收 {% data variables.product.product_name %} 上哪些活动的更新。 例如，选择您的默认电子邮件地址是否要接收以下更新： + - 对问题和拉取请求的评论。 + - 拉取请求审查. + - 拉取请求推送。 + - 您自己的更新，例如当您打开、评论或关闭议题或拉取请求时。 -Depending on the organization that owns the repository, you can also send notifications to different email addresses for specific repositories. For example, you can send notifications for a specific public repository to a verified personal email address. Your organization may require the email address to be verified for a specific domain. For more information, see “[Choosing where your organization’s email notifications are sent](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#choosing-where-your-organizations-email-notifications-are-sent)." +您还可以向特定仓库的不同电子邮件地址发送通知，具体取决于拥有仓库的组织。 例如，您可以向经验证的个人电子邮件地址发送特定公共仓库的通知。 您的组织可能要求验证特定域的电子邮件地址。 更多信息请参阅“[选择接收组织的电子邮件通知的位置](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#choosing-where-your-organizations-email-notifications-are-sent)”。 {% data reusables.notifications-v2.email-notification-caveats %} -### Filtering email notifications +### 过滤电子邮件通知 -Each email notification that {% data variables.product.product_name %} sends contains header information. The header information in every email is consistent, so you can use it in your email client to filter or forward all {% data variables.product.product_name %} notifications, or certain types of {% data variables.product.product_name %} notifications. +{% data variables.product.product_name %} 发送的每封电子邮件通知都包含标头信息。 每封电子邮件的标头信息都是一致的，因此可用于电子邮件客户端中过滤或转发所有 {% data variables.product.product_name %} 通知，或特定类型的 {% data variables.product.product_name %} 通知。 -If you believe you're receiving notifications that don't belong to you, examine the `X-GitHub-Recipient` and `X-GitHub-Recipient-Address` headers. These headers show who the intended recipient is. Depending on your email setup, you may receive notifications intended for another user. +如果您认为收到的通知不属于您，请检查 `X-GitHub-recepient` 和 `X-GitHub-recipient-Address` 标头。 这些标头显示预期的收件人。 根据您的电子邮件设置，您可能会收到预期发给其他用户的通知。 -Email notifications from {% data variables.product.product_name %} contain the following header information: +来自 {% data variables.product.product_name %} 的电子邮件通知包含以下标头信息： -| Header | Information | -| --- | --- | -| `From` address | This address will always be {% if currentVersion == "free-pro-team@latest" %}'`notifications@github.com`'{% else %}'the no-reply email address configured by your site administrator'{% endif %}. | -| `To` field | This field connects directly to the thread. If you reply to the email, you'll add a new comment to the conversation. | -| `Cc` address | {% data variables.product.product_name %} will `Cc` you if you're subscribed to a conversation. The second `Cc` email address matches the notification reason. The suffix for these notification reasons is {% data variables.notifications.cc_address %}. The possible notification reasons are:
    • `assign`: You were assigned to an issue or pull request.
    • `author`: You created an issue or pull request.
    • `comment`: You commented on an issue or pull request.
    • `manual`: There was an update to an issue or pull request you manually subscribed to.
    • `mention`: You were mentioned on an issue or pull request.
    • `push`: Someone committed to a pull request you're subscribed to.
    • `review_requested`: You or a team you're a member of was requested to review a pull request.
    • `security_alert`: {% data variables.product.prodname_dotcom %} detected a vulnerability in a repository you receive alerts for.
    • `state_change`: An issue or pull request you're subscribed to was either closed or opened.
    • `subscribed`: There was an update in a repository you're watching.
    • `team_mention`: A team you belong to was mentioned on an issue or pull request.
    • `your_activity`: You opened, commented on, or closed an issue or pull request.
    | -| `mailing list` field | This field identifies the name of the repository and its owner. The format of this address is always `..{% data variables.command_line.backticks %}`. |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" % %} -| `X-GitHub-Severity` field | {% data reusables.repositories.security-alerts-x-github-severity %} The possible severity levels are:
    • `low`
    • `moderate`
    • `high`
    • `critical`
    For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." |{% endif %} +| 标头 | 信息 | +| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `From` 地址 | This address will always be {% if currentVersion == "free-pro-team@latest" %}'`notifications@github.com`'{% else %}'the no-reply email address configured by your site administrator'{% endif %}. | +| `To` 字段 | 此字段直接连接到线程。 如果您回复电子邮件，将会为对话添加新评论。 | +| `Cc` 地址 | 如果您订阅了对话，{% data variables.product.product_name %} 将会 `Cc` 给您。 第二个 `Cc` 电子邮件地址与通知原因匹配。 这些通知原因的后缀是 {% data variables.notifications.cc_address %}。 可能的通知原因包括：
    • `assign`：您被分配到议题或拉取请求。
    • `author`：您创建了议题或拉取请求。
    • `comment`：您评论了议题或拉取请求。
    • `manual`：您手动订阅的议题或拉取请求有更新。
    • `mention`：您提及了议题或拉取请求。
    • `push`：有人提交了您订阅的拉取请求。
    • `review_requested`：您或您所在的团队已请求审查拉取请求。
    • `security_alert`：{% data variables.product.prodname_dotcom %} 检测到您要接收其漏洞警报的仓库中存在漏洞。
    • `state_change`：您订阅的议题或拉取请求已关闭或打开。
    • `subscribed`：您查看的仓库有更新。
    • `team_mention`：您所属的团队在议题或拉取请求中被提及。
    • `your_activity`：您打开、评论或关闭了议题或拉取请求。
    | +| `mailing list` 字段 | 此字段识别仓库名称及其所有者。 此地址的格式始终是 `<仓库名称>.<仓库所有者>.{% data variables.command_line.backticks %}`。 |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" % %} +| `X-GitHub-Severity` 字段 | {% data reusables.repositories.security-alerts-x-github-severity %} 可能的严重程度等级包括：
    • `低`
    • `中`
    • `高`
    • `严重`
    更多信息请参阅“[关于易受攻击的依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)”。 |{% endif %} -### Choosing your notification settings +### 选择通知设置 {% data reusables.notifications.access_notifications %} {% data reusables.notifications-v2.manage-notifications %} -3. On the notifications settings page, choose how you receive notifications when: - - There are updates in repositories or team discussions you're watching or in a conversation you're participating in. For more information, see "[About participating and watching notifications](#about-participating-and-watching-notifications)." - - You gain access to a new repository or you've joined a new team. For more information, see "[Automatic watching](#automatic-watching)."{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} - - There are new {% data variables.product.prodname_dependabot_alerts %} in your repository. For more information, see "[{% data variables.product.prodname_dependabot_alerts %} options](#github-dependabot-alerts-options)." {% endif %}{% if currentVersion == "enterprise-server@2.21" %} - - There are new security alerts in your repository. For more information, see "[Security alert options](#security-alert-options)." {% endif %} {% if currentVersion == "free-pro-team@latest" %} - - There are workflow runs updates on repositories set up with {% data variables.product.prodname_actions %}. For more information, see "[{% data variables.product.prodname_actions %} notification options](#github-actions-notification-options)."{% endif %} +3. 在通知设置页面上，选择在以下情况下如何接收通知： + - 在您关注的仓库或团队讨论或参与的对话中发生了更新。 更多信息请参阅“[关于参与和关注通知](#about-participating-and-watching-notifications)”。 + - 您获得了新仓库的访问权限或加入了新团队。 For more information, see "[Automatic watching](#automatic-watching)."{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} + - 您的仓库中有新的 {% if page.version == 'dotcom' %} {% data variables.product.prodname_dependabot_alerts %} {% else %} 安全警报 {% endif %}。 更多信息请参阅“[{% data variables.product.prodname_dependabot_alerts %} 通知选项](#github-dependabot-alerts-notification-options)”。 {% endif %}{% if currentVersion == "enterprise-server@2.21" %} + - 您的仓库中有新的安全警报。 For more information, see "[Security alert notification options](#security-alert-notification-options)." {% endif %} {% if currentVersion == "free-pro-team@latest" %} + - 在使用 {% data variables.product.prodname_actions %} 设置的仓库上有工作流程运行更新。 更多信息请参阅“[{% data variables.product.prodname_actions %} 通知选项](#github-actions-notification-options)”。{% endif %} -### Automatic watching +### 自动关注 -By default, anytime you gain access to a new repository, you will automatically begin watching that repository. Anytime you join a new team, you will automatically be subscribed to updates and receive notifications when that team is @mentioned. If you don't want to automatically be subscribed, you can unselect the automatic watching options. +默认情况下，每当您获得新仓库的访问权限时，您将会自动开始关注该仓库。 每当您加入新团队时，您都会自动订阅更新，并在该团队被 @提及时收到通知。 如果不想自动订阅，您可以取消选择自动关注选项。 - ![Automatic watching options](/assets/images/help/notifications-v2/automatic-watching-options.png) + ![自动关注选项](/assets/images/help/notifications-v2/automatic-watching-options.png) -If "Automatically watch repositories" is disabled, then you will not automatically watch your own repositories. You must navigate to your repository page and choose the watch option. +如果禁用了“Automatically watch repositories（自动关注仓库）”，您将不会自动关注自己拥有的仓库。 您必须导航到仓库页面，然后选择关注选项。 -### Choosing where your organization’s email notifications are sent +### 选择接收组织的电子邮件通知的位置 -If you belong to an organization, you can choose the email account you want notifications for organization activity sent to. For example, if you belong to an organization for work, you may want your notifications sent to your work email address, rather than your personal address. +如果您属于某个组织，您可以选择要接收组织活动通知的电子邮件帐户。 例如，如果您属于某个工作组织，您可能希望通知发送到您的工作电子邮件地址，而不是您的个人地址。 {% data reusables.notifications-v2.email-notification-caveats %} {% data reusables.notifications.access_notifications %} {% data reusables.notifications-v2.manage-notifications %} -3. Under "Default notification email", select the email address you'd like notifications sent to. -![Default notification email address drop-down](/assets/images/help/notifications/notifications_primary_email_for_orgs.png) -4. Click **Save**. +3. 在“Default notification email（默认通知电子邮件）”下，选择要接收通知的电子邮件地址。 + ![默认通知电子邮件地址下拉菜单](/assets/images/help/notifications/notifications_primary_email_for_orgs.png) +4. 单击 **Save（保存）**。 -#### Customizing email routes per organization +#### 自定义每个组织的电子邮件路由 -If you are a member of more than one organization, you can configure each one to send notifications to any of{% if currentVersion == "free-pro-team@latest" %} your verified email addresses{% else %} the email addressed you've added to your {% data variables.product.product_name %} account{% endif %}. {% if currentVersion == "free-pro-team@latest" %} For more information, see "[Verifying your email address](/articles/verifying-your-email-address)."{% endif %} +If you are a member of more than one organization, you can configure each one to send notifications to any of{% if currentVersion == "free-pro-team@latest" %} your verified email addresses{% else %} the email addressed you've added to your {% data variables.product.product_name %} account{% endif %}. {% if currentVersion == "free-pro-team@latest" %} For more information, see "[Verifying your email address](/articles/verifying-your-email-address)."{% endif %} {% data reusables.notifications.access_notifications %} {% data reusables.notifications-v2.manage-notifications %} -3. Under "Custom routing," find your organization's name in the list. -![List of organizations and email addresses](/assets/images/help/notifications/notifications_org_emails.png) -4. Click **Edit** next to the email address you want to change. -![Editing an organization's email addresses](/assets/images/help/notifications/notifications_edit_org_emails.png) -5. Select one of your verified email addresses, then click **Save**. -![Switching your per-org email address](/assets/images/help/notifications/notifications_switching_org_email.gif) +3. 在“Custom routing（自定义路由）”下，在列表中找到您组织的名称。 + ![组织和电子邮件地址列表](/assets/images/help/notifications/notifications_org_emails.png) +4. 在要更改的电子邮件地址旁边单击 **Edit（编辑）**。 ![编辑组织的电子邮件地址](/assets/images/help/notifications/notifications_edit_org_emails.png) +5. 选择一个经验证电子邮件地址，然后单击 **Save（保存）**。 + ![切换每个组织的电子邮件地址](/assets/images/help/notifications/notifications_switching_org_email.gif) {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -### {% data variables.product.prodname_dependabot_alerts %} options +### {% data variables.product.prodname_dependabot_alerts %} 通知选项 {% else %} -### Security alert options +### Security alert notification options {% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}Choose how you want to receive {% data variables.product.prodname_dependabot_alerts %} for repositories that you are watching. You can receive {% data variables.product.prodname_dependabot_alerts %} in your inbox, as a banner on {% data variables.product.product_name %}, on the command line, through email, or some combination of these options. +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}Choose how you want to receive {% data variables.product.prodname_dependabot_alerts %} for repositories that you are watching. 您可以在收件箱中接收 {% if page.version == 'dotcom' %} {% data variables.product.prodname_dependabot_alerts %} {% else %} 安全警报 {% endif %}、作为 {% data variables.product.product_name %} 的横幅、在命令行上接收、通过电子邮件接收，或使用这些选项的一些组合。 -If you want to receive {% data variables.product.prodname_dependabot_alerts %} by email, choose whether you want a weekly email summary of vulnerabilities for up 10 repositories or a new email each time a vulnerability is detected. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)."{% endif %} +如果您想通过电子邮件接收 {% data variables.product.prodname_dependabot_alerts %} ，请选择您是想每周接收最多 10 个仓库的漏洞电子邮件摘要，还是在每次检测到漏洞时接收一封新的电子邮件。 更多信息请参阅“[关于易受攻击的依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)”。 {% endif %} -{% if currentVersion == "enterprise-server@2.21" %}Choose how you want to receive security alerts for repositories that you are watching. You can receive security alerts in your inbox, as a banner on {% data variables.product.product_name %}, on the command line, through email, or some combination of these options. +{% if currentVersion == "enterprise-server@2.21" %}Choose how you want to receive security alerts for repositories that you are watching. 您可以在收件箱中接收安全警报、作为 {% data variables.product.product_name %} 的横幅、在命令行上接收、通过电子邮件接收，或使用这些选项的一些组合。 -If you want to receive security alerts by email, choose whether you want a weekly email summary of vulnerabilities for up 10 repositories or a new email each time a vulnerability is detected. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)."{% endif %} +如果您想通过电子邮件接收安全警报 ，请选择您是想每周接收最多 10 个仓库的漏洞电子邮件摘要，还是在每次检测到漏洞时接收一封新的电子邮件。 更多信息请参阅“[关于易受攻击的依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)”。 {% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} - ![{% data variables.product.prodname_dependabot_short %} alerts options](/assets/images/help/notifications-v2/dependabot-alerts-options.png) + ![{% data variables.product.prodname_dependabot_short %} 警报选项](/assets/images/help/notifications-v2/dependabot-alerts-options.png) {% else %} - ![Security alerts options](/assets/images/help/notifications-v2/security-alerts-options.png) + ![安全警报选项](/assets/images/help/notifications-v2/security-alerts-options.png) {% endif %} +{% note %} + +**Note:** You can filter your {% data variables.product.company_short %} inbox notifications by {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %} security{% endif %} alerts. 更多信息请参阅“[从收件箱管理通知](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox#supported-queries-for-custom-filters)”。 + +{% endnote %} + {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -### {% data variables.product.prodname_actions %} notification options +### {% data variables.product.prodname_actions %} 通知选项 -Choose how you want to receive workflow run updates for repositories that you are watching that are set up with {% data variables.product.prodname_actions %}. You can also choose to only receive notifications for failed workflow runs. +选择您希望如何接收所关注仓库的工作流程运行更新，通过 {% data variables.product.prodname_actions %} 设置。 您也可以选择仅接收关于失败的工作流程运行的通知。 - ![Notification options for {% data variables.product.prodname_actions %}](/assets/images/help/notifications-v2/github-actions-notification-options.png) + ![{% data variables.product.prodname_dependabot_short %} 警报选项](/assets/images/help/notifications-v2/github-actions-notification-options.png) {% endif %} {% if currentVersion == "free-pro-team@latest" %} -### Enabling push notifications with {% data variables.product.prodname_mobile %} +### 使用 {% data variables.product.prodname_mobile %} 启用推送通知 -When you install {% data variables.product.prodname_mobile %}, you will automatically be opted into web notifications. You can then enable push notifications for direct mentions within the app. +安装 {% data variables.product.prodname_mobile %} 时，您将自动选择 web 通知。 然后，您可以针对应用程序中的直接提及启用推送通知。 -You can only receive notifications for pushes to repositories on {% data variables.product.prodname_mobile %} at this time. +目前，您只能针对 {% data variables.product.prodname_mobile %} 上仓库的推送接收通知。 -#### Enabling push notifications with {% data variables.product.prodname_ios %} +#### 使用 {% data variables.product.prodname_ios %} 启用推送通知 -1. Above "Home", tap your profile photo. -2. To view your settings, tap {% octicon "gear" aria-label="The Gear icon" %}. - ![Settings icon for GitHub for iOS](/assets/images/help/mobile/ios-settings-icon.png) -3. To update your notification settings, tap **Push notifications**. -4. To turn on push notifications for direct mentions, use the **Direct Mentions** toggle. +1. 在“Home（主页）”上，点击您的个人资料照片。 +2. 要查看设置，请点击 {% octicon "gear" aria-label="The Gear icon" %}。 ![iOS 版 GitHub 的设置图标](/assets/images/help/mobile/ios-settings-icon.png) +3. 要更新通知设置，请点击 **Push notifications（推送通知）**。 +4. 要针对直接提及开启推送通知，请使用 **Direct Mentions（直接提及）**切换按钮。 -#### Enabling push notifications with {% data variables.product.prodname_android %} +#### 使用 {% data variables.product.prodname_android %} 启用推送通知 -1. Above "Home", tap your profile photo. -2. To view your settings, tap {% octicon "gear" aria-label="The Gear icon" %}. - ![Settings icon for GitHub for Android](/assets/images/help/mobile/android-settings-icon.png) -3. To turn on push notifications for direct mentions, use the **Direct mentions** toggle. +1. 在“Home（主页）”上，点击您的个人资料照片。 +2. 要查看设置，请点击 {% octicon "gear" aria-label="The Gear icon" %}。 ![Android 版 GitHub 的设置图标](/assets/images/help/mobile/android-settings-icon.png) +3. 要针对直接提及开启推送通知，请使用 **Direct mentions（直接提及）**切换按钮。 {% endif %} diff --git a/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/customizing-a-workflow-for-triaging-your-notifications.md b/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/customizing-a-workflow-for-triaging-your-notifications.md index c01d80fb19dc..dfb70ef7d8da 100644 --- a/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/customizing-a-workflow-for-triaging-your-notifications.md +++ b/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/customizing-a-workflow-for-triaging-your-notifications.md @@ -1,6 +1,6 @@ --- title: 自定义对通知分类的工作流程 -intro: 要创建对通知分类的理想工作流程，可以调整和自定义以下示例工作流程。 +intro: '要创建对通知分类的理想工作流程，可以调整和自定义以下示例工作流程。' versions: free-pro-team: '*' enterprise-server: '>=2.21' @@ -8,19 +8,19 @@ versions: ### 开始收件箱分类 -Before you start triaging your inbox, consider whether you prefer to first find and respond to the most important updates or to clear your inbox of distracting updates that are easy to remove or triage. +在开始对收件箱进行分类之前，请考虑您是希望首先查找并响应最重要的更新，还是清除收件箱中容易删除或分类的干扰更新。 -You may decide to use a combination of both approaches at various times depending on the volume of notifications you have. +您可以在不同时间根据收到的通知数量决定使用这两种方法的组合。 -For an example workflow of finding and responding to the most important notifications, see "[Checking your highest notification priorities](#checking-your-highest-notification-priorities)." +有关查找和响应最重要通知的工作流程示例，请参阅“[检查您的最高通知优先级](#checking-your-highest-notification-priorities)”。 -For an example workflow of removing notifications that are easy to remove or triage, see "[Clearing your least important notifications](#clearing-your-least-important-notifications)." +有关清除易删除或易分类通知的工作流程示例，请参阅“[清除最不重要的通知](#clearing-your-least-important-notifications)”。 ### 检查您的最高通知优先级 -Choose which type of notifications are most urgent to review and pick a time to review them that's best for you. You might consider the question "Who am I blocking?" +选择最迫切需要查看的通知类型，并选择最适合查看的时间。 您可能会考虑“我在阻止谁？” -For example, you may decide to check your notifications in this order in the morning during your daily planning time: +例如，您可以决定在每日计划时间的早上按此顺序检查通知： - 已请求您审查的拉取请求。 （按 `reason:review-requested` 过滤） - @提及了您的用户名的事件，也称为直接提及。 （按 `reason:mention` 过滤） - @提及了您所在团队的事件，也称为团队提及。 （按 `reason:team-mention` 过滤） @@ -34,15 +34,15 @@ For example, you may decide to check your notifications in this order in the mor ### 跟进正在进行的通知更新 -To follow-up on notifications, you might consider the question "What was I blocked on that I'm no longer blocked on?" Choose your follow-up notification priorities. Choose your follow-up notification priorities. +To follow-up on notifications, you might consider the question "What was I blocked on that I'm no longer blocked on?" Choose your follow-up notification priorities. 选择后续通知优先级。 -For example, you may decide to follow up in this order: +例如，您可以决定按照以下顺序采取后续行动： - 分配给您的议题和拉取请求。 立即关闭您可以关闭的任何议题或拉取请求，并添加更新。 需要时，保存通知供以后查看。 - 查看已保存的收件箱中的通知，尤其是未读更新。 如果帖子不再相关，请取消选中 {% octicon "bookmark" aria-label="The bookmark icon" %} 以从保存的收件箱中删除通知并取消保存它。 ### 管理低优先级通知 -After triaging the higher priority notifications, review the remaining notifications, such as participating notifications. Consider these questions: +对较高优先级的通知进行分类之后，查看其余的通知，例如参与通知。 考虑以下问题： - 您可以取消订阅此通知吗？ 此通知是否已完成并且可以标记为**完成**？ {% tip %} @@ -54,12 +54,12 @@ After triaging the higher priority notifications, review the remaining notificat ### 清除最不重要的通知 -Choose which type of notifications are quickest and easiest for you to triage and remove from your inbox, ideally triaging multiple notifications at once. +选择收件箱中最快和最容易分类和删除的通知类型，最好是一次对多个通知进行分类。 例如，您可以决定按以下顺序清除通知： - 参与您可以取消订阅的通知。 - 与保留或跟进无关的仓库更新。 -For more information on managing multiple notifications in your inbox at the same time, see "[Managing notifications from your inbox](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox#triaging-multiple-notifications-at-the-same-time)." +有关同时管理收件箱中多个通知的更多信息，请参阅“[管理收件箱中的通知](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox#triaging-multiple-notifications-at-the-same-time)”。 -You may also consider changing your notification settings or unsubscribing from these updates if possible. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications)" or "[Managing subscriptions for activity on GitHub](/github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github)." +如果可能，您还可以考虑更改通知设置或取消订阅这些更新。 更多信息请参阅"[配置通知](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications)“[管理 GitHub 上的活动订阅](/github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github)。” diff --git a/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md b/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md index 264c8496c262..51e8628e6933 100644 --- a/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md +++ b/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox.md @@ -1,6 +1,6 @@ --- title: 从收件箱管理通知 -intro: '使用收件箱快速分类并在电子邮件{% if currentVersion == "free-pro-team@latest" %}与手机{% endif %}之间同步您的通知。' +intro: 'Use your inbox to quickly triage and sync your notifications across email{% if currentVersion == "free-pro-team@latest" %} and mobile{% endif %}.' redirect_from: - /articles/marking-notifications-as-read - /articles/saving-notifications-for-later @@ -12,25 +12,24 @@ versions: ### 关于收件箱 {% if currentVersion == "free-pro-team@latest" %} -{% data reusables.notifications-v2.notifications-inbox-required-setting %} For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#choosing-your-notification-settings)." +{% data reusables.notifications-v2.notifications-inbox-required-setting %} 更多信息请参阅“[配置通知](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#choosing-your-notification-settings)”。 {% endif %} -To access your notifications inbox, in the upper-right corner of any page, click {% octicon "bell" aria-label="The notifications bell" %}. +要访问通知收件箱，请在任意页面的右上角单击 {% octicon "bell" aria-label="The notifications bell" %}。 ![表示任何未读消息的通知](/assets/images/help/notifications/notifications_general_existence_indicator.png) - 收件箱显示您尚未取消订阅或标记为**完成**的所有通知。您可以使用过滤器自定义收件箱，使之最适合您的工作流程，查看所有通知或只查看未读通知，对通知分组通知以获取快速概览。 - ![inbox view](/assets/images/help/notifications-v2/inbox-view.png) + ![收件箱视图](/assets/images/help/notifications-v2/inbox-view.png) -By default, your inbox will show read and unread notifications. To only see unread notifications, click **Unread** or use the `is:unread` query. +默认情况下，您的收件箱将显示已读和未读通知。 如果只想查看未读通知，请单击 **Unread（未读）**或使用 `is:unread` 查询。 - ![unread inbox view](/assets/images/help/notifications-v2/unread-inbox-view.png) + ![未读收件箱视图](/assets/images/help/notifications-v2/unread-inbox-view.png) ### 分类选项 -You have several options for triaging notifications from your inbox. +有多个选项可对收件箱中的通知进行分类。 | 分类选项 | 描述 | | ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -42,23 +41,23 @@ You have several options for triaging notifications from your inbox. 要查看可用的键盘快捷键，请参阅“[键盘快捷键](/github/getting-started-with-github/keyboard-shortcuts#notifications)”。 -Before choosing a triage option, you can preview your notification's details first and investigate. For more information, see "[Triaging a single notification](/github/managing-subscriptions-and-notifications-on-github/triaging-a-single-notification)." +在选择分类选项之前，您可以先预览通知的详细信息并进行调查。 更多信息请参阅“[对单个通知进行分类](/github/managing-subscriptions-and-notifications-on-github/triaging-a-single-notification)”。 ### 同时对多种通知分类 要一次对多种通知分类，请选择相关通知并使用 {% octicon "kebab-horizontal" aria-label="The edit icon" %} 下拉列表以选择分类选项。 -![Drop-down menu with triage options and selected notifications](/assets/images/help/notifications-v2/triage-multiple-notifications-together.png) +![带有分类选项和选定通知的下拉菜单](/assets/images/help/notifications-v2/triage-multiple-notifications-together.png) ### 默认通知过滤器 -By default, your inbox has filters for when you are assigned, participating in a thread, requested to review a pull request, or when your username is @mentioned directly or a team you're a member of is @mentioned. +默认情况下，收件箱中有针对您被分配任务、参与帖子、请求审查拉取请求的过滤器，或者针对您的用户名被直接 @提及或您所属团队被 @提及的过滤器。 - ![Default custom filters](/assets/images/help/notifications-v2/default-filters.png) + ![默认自定义过滤器](/assets/images/help/notifications-v2/default-filters.png) ### 使用自定义过滤器自定义收件箱 -You can add up to 15 of your own custom filters. +您可以添加最多 15 个自定义过滤器。 {% data reusables.notifications.access_notifications %} 2. 若要打开过滤器设置，在左侧边栏的“Filters（过滤器）”旁边，单击 {% octicon "gear" aria-label="The Gear icon" %}。 @@ -77,7 +76,7 @@ You can add up to 15 of your own custom filters. ### 自定义过滤器限制 -Custom filters do not currently support: +自定义过滤器当前不支持： - 收件箱中的全文搜索，包括搜索拉取请求或议题标题。 - 区分 `is:issue`、`is:pr` 及 `is:pull-request` 查询过滤器。 这些查询将返回议题和拉取请求。 - 创建超过 15 个自定义过滤器。 @@ -85,16 +84,16 @@ Custom filters do not currently support: ### 支持的自定义过滤器查询 -There are three types of filters that you can use: +您可以使用三种类型的过滤器： - 使用 `repo:` 按仓库过滤 - 使用 `is:` 按讨论类型过滤 - 使用 `reason:` 按通知原因过滤 -To add a `repo:` filter, you must include the owner of the repository in the query. For example, `repo:atom/atom` represents the Atom repository owned by the Atom organization. +要添加 `repo:` 过滤器，您必须在查询中包含仓库的所有者。 例如，`repo:atom/atom` 表示 Atom 组织拥有的 Atom 仓库。 #### 支持的 `reason:` 查询 -To filter notifications by why you've received an update, you can use the `reason:` query. For example, to see notifications when you (or a team you're on) is requested to review a pull request, use `reason:review-requested`. 更多信息请参阅“[关于通知](/github/managing-subscriptions-and-notifications-on-github/about-notifications#reasons-for-receiving-notifications)”。 +要根据收到更新的原因过滤通知，您可以使用 `reason:` 查询。 例如，要查看当您（或您所属团队）被请求审查拉取请求时的通知，请使用 `reason:review-requested`。 更多信息请参阅“[关于通知](/github/managing-subscriptions-and-notifications-on-github/about-notifications#reasons-for-receiving-notifications)”。 | 查询 | 描述 | | ------------------------- | -------------------------------------- | @@ -113,7 +112,7 @@ To filter notifications by why you've received an update, you can use the `reaso #### 支持的 `is:` 查询 -要在 {% data variables.product.product_name %} 上过滤特定活动的通知，您可以使用 `is` 查询。 For example, to only see repository invitation updates, use `is:repository-invitation`. +要在 {% data variables.product.product_name %} 上过滤特定活动的通知，您可以使用 `is` 查询。 For example, to only see repository invitation updates, use `is:repository-invitation`, and to only see {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %} security{% endif %} alerts, use `is:repository-vulnerability-alert`. - `is:check-suite` - `is:commit` @@ -125,7 +124,7 @@ To filter notifications by why you've received an update, you can use the `reaso - `is:repository-advisory` - `is:team-discussion` -You can also use the `is:` query to describe how the notification was triaged. +您还可以使用 `is:` 查询来描述如何对通知进行分类。 - `is:saved` - `is:done` diff --git a/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github.md b/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github.md index 5eb876151c8b..47700c32e66d 100644 --- a/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github.md +++ b/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github.md @@ -1,6 +1,6 @@ --- title: 在 GitHub 上管理活动的订阅 -intro: 要维护可持续的通知工作流程，请了解并定期查看您的订阅。 +intro: '要维护可持续的通知工作流程，请了解并定期查看您的订阅。' mapTopic: true versions: free-pro-team: '*' diff --git a/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md b/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md index 3b81d193b728..334747df4d8b 100644 --- a/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md +++ b/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md @@ -1,40 +1,40 @@ --- title: 管理订阅 -intro: 为帮助您有效地管理通知，提供了多种取消订阅的方法。 +intro: '为帮助您有效地管理通知，提供了多种取消订阅的方法。' versions: free-pro-team: '*' enterprise-server: '>=2.21' --- -To help you understand your subscriptions and decide whether to unsubscribe, see "[Viewing your subscriptions](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions)." +为帮助您了解您的订阅和决定是否取消订阅，请参阅“[查看您的订阅](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions)”。 {% note %} -**Note:** Instead of unsubscribing, you have the option to ignore a repository. 如果忽略仓库，将不会收到任何通知。 我们不建议忽略仓库，因为这样您被@提及时将不会收到通知。 {% if currentVersion == "free-pro-team@latest" %}If you're experiencing abuse and want to ignore a repository, please [contact support](/contact) so we can help. {% data reusables.policies.abuse %}{% endif %} +**注：**您可以选择忽略仓库，而不取消订阅。 如果忽略仓库，将不会收到任何通知。 我们不建议忽略仓库，因为这样您被@提及时将不会收到通知。 {% if currentVersion == "free-pro-team@latest" %}If you're experiencing abuse and want to ignore a repository, please [contact support](/contact) so we can help. {% data reusables.policies.abuse %}{% endif %} {% endnote %} ### 选择如何取消订阅 -To unwatch (or unsubscribe from) repositories quickly, go to the "Watched repositories" page, where you can see all repositories you're watching. For more information, see "[Unwatch a repository](#unwatch-a-repository)." +要快速取消关注（或取消订阅）仓库，请转到“Watched repositories（已关注仓库）”页面，您可以在该页面查看您当前关注的所有仓库。 更多信息请参阅“[取消关注仓库](#unwatch-a-repository)”。 -To unsubscribe from multiple notifications at the same time, you can unsubscribe using your inbox or on the subscriptions page. Both of these options offer more context about your subscriptions than the "Watched repositories" page. +要同时取消订阅多个通知，您可以使用收件箱或订阅页面上取消订阅。 相比“Watched repositories（已关注仓库）”页面，这两个选项可提供有关您的订阅的更多上下文。 #### 从收件箱中取消订阅的优点 -When you unsubscribe from notifications in your inbox, you have several other triaging options and can filter your notifications by custom filters and discussion types. 更多信息请参阅“[从收件箱管理通知](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox)”。 +在收件箱中取消订阅通知时，您还有其他一些分类选项，并且可以按自定义过滤器和讨论类型来过滤通知。 更多信息请参阅“[从收件箱管理通知](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox)”。 #### 从订阅页面取消订阅的优点 -When you unsubscribe from notifications on the subscriptions page, you can see more of the notifications you're subscribed to and sort them by "Most recently subscribed" or "Least recently subscribed". +在订阅页面上取消订阅通知时，您可以查看更多已订阅的通知，并且可以按“最多最近订阅”或“最少最近订阅”对它们进行排序。 -The subscriptions page shows you all of the notifications that you're currently subscribed to, including notifications that you have marked as **Done** in your inbox. +订阅页面显示您当前已订阅的所有通知，包括在收件箱中标记为 **Done（完成）**的通知。 -You can only filter your subscriptions by repository and the reason you're receiving the notification. +您只能按仓库和接收通知的原因过滤订阅。 ### 在收件箱中取消订阅通知 -When you unsubscribe from notifications in your inbox, they will automatically disappear from your inbox. +当您取消订阅收件箱中的通知时，它们将自动从您的收件箱中消失。 {% data reusables.notifications.access_notifications %} 1. 从通知收件箱中选择您想要取消订阅的通知。 @@ -49,7 +49,7 @@ When you unsubscribe from notifications in your inbox, they will automatically d ### 取消关注仓库 -When you unwatch a repository, you unsubscribe from future updates from that repository unless you participate in a conversation or are @mentioned. +当您取消关注某个仓库时，您将取消订阅该仓库的未来更新，除非您参与对话或被 @提及。 {% data reusables.notifications.access_notifications %} 1. 在左侧边栏中的仓库列表下，使用“Manage notifications（管理通知）”下拉按钮单击 **Watched repositories（已关注的仓库）**。 ![管理通知下拉菜单选项](/assets/images/help/notifications-v2/manage-notifications-options.png) diff --git a/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/setting-up-notifications.md b/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/setting-up-notifications.md index 0e08594a7b51..3a7cbd6a1537 100644 --- a/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/setting-up-notifications.md +++ b/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/setting-up-notifications.md @@ -1,6 +1,6 @@ --- title: 设置通知 -intro: 要改进通知的相关性并简化分类工作流程，请设置通知以匹配您的优先级。 +intro: '要改进通知的相关性并简化分类工作流程，请设置通知以匹配您的优先级。' mapTopic: true redirect_from: - /articles/getting-started-with-notifications diff --git a/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/triaging-a-single-notification.md b/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/triaging-a-single-notification.md index 6df1cdf2c98f..6fc3836c3e4d 100644 --- a/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/triaging-a-single-notification.md +++ b/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/triaging-a-single-notification.md @@ -1,6 +1,6 @@ --- title: 对单个通知进行分类 -intro: 查看和调查单个通知时，有几个针对详细通知视图优化的分类选项可以使用。 +intro: '查看和调查单个通知时，有几个针对详细通知视图优化的分类选项可以使用。' versions: free-pro-team: '*' enterprise-server: '>=2.21' @@ -8,11 +8,11 @@ versions: ### 保存单个通知 -要保存单一通知供以后查看，在通知右侧单击 {% octicon "bookmark" aria-label="The bookmark icon" %}。 You can only save one notification at a time. +要保存单一通知供以后查看，在通知右侧单击 {% octicon "bookmark" aria-label="The bookmark icon" %}。 一次只能保存一个通知。 -Saved notifications are kept indefinitely and can be viewed by clicking **Saved** in the sidebar or with the `is:saved` query. 如果您保存的通知超过5个月并且变成未保存，通知将在一天内从收件箱消失。 +已保存的通知将无限期保存，可单击侧边栏中的 **Saved（已保存）** 或通过 `is:saved` 查询进行查看。 如果您保存的通知超过5个月并且变成未保存，通知将在一天内从收件箱消失。 - ![Save triaging option](/assets/images/help/notifications-v2/save-triaging-option.png) + ![保存分类选项](/assets/images/help/notifications-v2/save-triaging-option.png) ### 调查通知 @@ -23,7 +23,7 @@ Saved notifications are kept indefinitely and can be viewed by clicking **Saved* - 保存通知以供以后查看 - 返回通知收件箱 -For more information about your triage options, see "[Managing notifications from your inbox](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox#triaging-options)." +有关分类选项的更多信息，请参阅“[管理收件箱中的通知](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox#triaging-options)”。 ### 自定义何时接收议题或拉取请求的未来更新 @@ -31,10 +31,10 @@ For more information about your triage options, see "[Managing notifications fro 1. 在议题或拉取请求的右侧列的“Notifications（通知）”旁边单击 **Customize（自定义）**。 - ![Customize option under "Notifications"](/assets/images/help/notifications-v2/customize-notifications-for-specific-thread.png) + !["Notifications（通知）"下的自定义选项](/assets/images/help/notifications-v2/customize-notifications-for-specific-thread.png) -2. Select **Custom** and choose when you'd like to receive a notification update for this thread. For example, you can choose to receive an update when the pull request has been merged, closed, or reopened. You will be subscribed again if you participate in the thread, your username is @mentioned, or a team you're a member of is @mentioned. +2. 选择 **Custom（自定义）**，然后选择您希望在什么情况下接收有关此帖子的更新通知。 例如，您可以选择在拉取请求被合并、关闭或重新打开时接收更新。 如果您参与帖子、您的用户名被 @提及或您所属的团队被 @提及，您将会重新订阅。 - ![Options for customizing notifications](/assets/images/help/notifications-v2/custom-options-for-customizing-notification-thread-updates.png) + ![自定义通知的选项](/assets/images/help/notifications-v2/custom-options-for-customizing-notification-thread-updates.png) 3. 单击 **Save（保存）**。 diff --git a/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications.md b/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications.md index f70c139fea69..a398eab36570 100644 --- a/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications.md +++ b/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications.md @@ -1,6 +1,6 @@ --- title: 查看和分类通知 -intro: 为优化通知工作流程，您可以自定义如何查看通知以及对通知分类。 +intro: '为优化通知工作流程，您可以自定义如何查看通知以及对通知分类。' mapTopic: true redirect_from: - /articles/managing-notifications/ diff --git a/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions.md b/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions.md index 2f3c5e096057..dada34836160 100644 --- a/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions.md +++ b/translations/zh-CN/content/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions.md @@ -1,6 +1,6 @@ --- title: 查看订阅 -intro: 为了解通知来自何处以及通知量，建议定期查看订阅和关注的仓库。 +intro: '为了解通知来自何处以及通知量，建议定期查看订阅和关注的仓库。' redirect_from: - /articles/subscribing-to-conversations/ - /articles/unsubscribing-from-conversations/ @@ -19,19 +19,19 @@ versions: enterprise-server: '>=2.21' --- -接收 {% data variables.product.product_name %} 上长期活动的订阅通知。 There are many reasons you can be subscribed to a conversation. 更多信息请参阅“[关于通知](/github/managing-subscriptions-and-notifications-on-github/about-notifications#notifications-and-subscriptions)”。 +接收 {% data variables.product.product_name %} 上长期活动的订阅通知。 有很多原因可能导致您订阅对话。 更多信息请参阅“[关于通知](/github/managing-subscriptions-and-notifications-on-github/about-notifications#notifications-and-subscriptions)”。 -We recommend auditing and unsubscribing from your subscriptions as a part of a healthy notifications workflow. For more information about your options for unsubscribing, see "[Managing subscriptions](/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions)." +我们建议将审核订阅和取消订阅作为健康通知工作流程的一部分。 有关取消订阅选项的更多信息，请参阅“[管理订阅](/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions)”。 ### 诊断收到太多通知的原因 -When your inbox has too many notifications to manage, consider whether you have oversubscribed or how you can change your notification settings to reduce the subscriptions you have and the types of notifications you're receiving. For example, you may consider disabling the settings to automatically watch all repositories and all team discussions whenever you've joined a team or repository. +当收件箱中要管理的通知过多时，请考虑您是否订阅过多，或者如何更改通知设置以减少订阅数量和接收的通知类型。 例如，您可以考虑禁用在加入团队或仓库时自动关注所有仓库和所有团队讨论的设置。 ![自动关注](/assets/images/help/notifications-v2/automatic-watching-example.png) 更多信息请参阅“[配置通知](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#automatic-watching)”。 -To see an overview of your repository subscriptions, see "[Reviewing repositories that you're watching](#reviewing-repositories-that-youre-watching)." Many people forget about repositories that they've chosen to watch in the past. From the "Watched repositories" page you can quickly unwatch repositories. For more information on ways to unsubscribe, see "[Managing subscriptions](/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions)." Many people forget about repositories that they've chosen to watch in the past. From the "Watched repositories" page you can quickly unwatch repositories. For more information on ways to unsubscribe, see "[Managing subscriptions](/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions)." +To see an overview of your repository subscriptions, see "[Reviewing repositories that you're watching](#reviewing-repositories-that-youre-watching)." Many people forget about repositories that they've chosen to watch in the past. From the "Watched repositories" page you can quickly unwatch repositories. For more information on ways to unsubscribe, see "[Managing subscriptions](/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions)." 许多人忘记了他们过去选择关注的仓库。 从“Watched repositories（已关注仓库）”页面，您可以快速取消关注仓库。 有关取消订阅方式的更多信息，请参阅“[管理订阅](/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions)”。 ### 查看所有订阅 diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md b/translations/zh-CN/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md index 97496817623c..7e38fef80417 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/about-automation-for-issues-and-pull-requests-with-query-parameters.md @@ -22,15 +22,15 @@ versions: ### 支持的查询参数 -| 查询参数 | 示例 | -| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `正文` | `https://github.com/octo-org/octo-repo/compare/master...pull-request-test?quick_pull=1&body=Fixes+the+problem.` 创建拉取请求，比较分支 `master` 与 `pull-request-test`，在拉取请求正文中包含注释 "Fixes the problem"。 | -| `title` | `https://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report` 使用标签 "bug" 和标题 "New bug report" 创建议题。 | -| `labels` | `https://github.com/octo-org/octo-repo/compare/master...pull-request-test?quick_pull=1&labels=bug` 创建拉取请求，比较分支 `master` 与 `pull-request-test`，加标签 "bug"。 | -| `模板` | `https://github.com/octo-org/octo-repo/issues/new?template=issue_template.md` 使用模板在议题正文中创建议题。 | -| `里程碑` | `https://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones` 创建包含里程碑 "testing milestones" 的议题。 | -| `assignees` | `https://github.com/octo-org/octo-repo/issues/new?assignees=octocat` 创建议题并分配到 @octocat。 | -| `projects` | `https://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1` 创建标题为 "Bug fix" 的议题并将其添加到组织的项目板 1。 | +| 查询参数 | 示例 | +| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `正文` | `https://github.com/octo-org/octo-repo/compare/main...pull-request-test?quick_pull=1&body=Fixes+the+problem.` creates a pull request, comparing the branches `main` and `pull-request-test`, with the comment "Fixes the problem" in the pull request body. | +| `title` | `https://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report` 使用标签 "bug" 和标题 "New bug report" 创建议题。 | +| `labels` | `https://github.com/octo-org/octo-repo/compare/main...pull-request-test?quick_pull=1&labels=bug` creates a pull request, comparing the branches `main` and `pull-request-test`, with the label "bug." | +| `模板` | `https://github.com/octo-org/octo-repo/issues/new?template=issue_template.md` 使用模板在议题正文中创建议题。 | +| `里程碑` | `https://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones` 创建包含里程碑 "testing milestones" 的议题。 | +| `assignees` | `https://github.com/octo-org/octo-repo/issues/new?assignees=octocat` 创建议题并分配到 @octocat。 | +| `projects` | `https://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1` 创建标题为 "Bug fix" 的议题并将其添加到组织的项目板 1。 | ### 使用自定义模板填写议题和拉取请求 diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/about-automation-for-project-boards.md b/translations/zh-CN/content/github/managing-your-work-on-github/about-automation-for-project-boards.md index 329310fd8721..e3248abc785d 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/about-automation-for-project-boards.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/about-automation-for-project-boards.md @@ -32,5 +32,5 @@ versions: 项目板自动化默认启用进度跟踪。 "To do"（待处理）、"In progress"（进行中）或 "Done"（完成）列中的卡会预置总体目标进度值。 {% data reusables.project-management.project-progress-locations %} ### 延伸阅读 -- "[配置项目板的自动化](/articles/configuring-automation-for-project-boards)"{% if currentVersion == "free-pro-team@latest" %} +- "[Configuring automation for project boards](/articles/configuring-automation-for-project-boards)"{% if currentVersion == "free-pro-team@latest" %} - "[复制项目板](/articles/copying-a-project-board)"{% endif %} diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/about-issues.md b/translations/zh-CN/content/github/managing-your-work-on-github/about-issues.md index 3a566d3ba2be..9d741913ef24 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/about-issues.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/about-issues.md @@ -3,7 +3,7 @@ title: 关于议题 intro: '使用议题跟踪想法、增强、任务或漏洞以便操作 {% data variables.product.product_name %}。' redirect_from: - /articles/creating-issues/ - - /articles/about-issues + - /articles/about-issues/ versions: free-pro-team: '*' enterprise-server: '*' @@ -13,7 +13,7 @@ versions: {% data reusables.pull_requests.close-issues-using-keywords %} -为保持更新议题中的最新评论，您可以监控问题以接收关于最新评论的通知。 更多信息请参阅{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[关于通知](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}“[关于通知](/github/receiving-notifications-about-activity-on-github/about-notifications){% endif %}”。 +为保持更新议题中的最新评论，您可以监控问题以接收关于最新评论的通知。 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 %}." 要快速查找指向您订阅的最新议题的链接，请访问仪表板。 更多信息请参阅“[关于个人仪表板](/articles/about-your-personal-dashboard)”。 @@ -22,10 +22,10 @@ versions: 通过议题可以： - 使用项目仪表板跟踪工作和排列工作的优先级。 更多信息请参阅“[使用项目板](/articles/about-project-boards)”。 - 创建新议题以跟踪议题或拉取请求审查中评论范围外的反馈。 更多信息请参阅“[从评论打开议题](/github/managing-your-work-on-github/opening-an-issue-from-a-comment)”。 -- 创建议题模板可帮助贡献者打开有意义的议题。 更多信息请参阅“[关于议题和拉取请求模板](/articles/about-issue-and-pull-request-templates)”。{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -- 将打开的议题传输到其他仓库。 更多信息请参阅“[将议题转让给其他仓库](/articles/transferring-an-issue-to-another-repository)”。{% endif %} +- 创建议题模板可帮助贡献者打开有意义的议题。 更多信息请参阅“[关于议题和拉取请求模板](/articles/about-issue-and-pull-request-templates)”。 +- 将打开的议题传输到其他仓库。 更多信息请参阅“[将议题传输到其他仓库](/articles/transferring-an-issue-to-another-repository)”。 - 固定重要议题以使其更易于查找，防止重复的议题，减少干扰。 更多信息请参阅“[将议题固定到仓库](/articles/pinning-an-issue-to-your-repository)”。 -- 使用保存的回复跟踪重复的议题。 更多信息请参阅“[关于已保存回复](/articles/about-saved-replies)”。{% if currentVersion == "free-pro-team@latest" %} +- 使用保存的回复跟踪重复的议题。 For more information, see "[About saved replies](/articles/about-saved-replies)."{% if currentVersion == "free-pro-team@latest" %} - 报告违反{% data variables.product.prodname_dotcom %}'s [社区指导方针](/articles/github-community-guidelines)的评论。 更多信息请参阅“[报告滥用或垃圾邮件](/articles/reporting-abuse-or-spam)”。{% endif %} 议题也可以[分配到其他用户](/articles/assigning-issues-and-pull-requests-to-other-github-users)，[用标签标记](/articles/applying-labels-to-issues-and-pull-requests)以便快速搜索，以及[与里程碑组合](/articles/creating-and-editing-milestones-for-issues-and-pull-requests)。 diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/about-labels.md b/translations/zh-CN/content/github/managing-your-work-on-github/about-labels.md index 2a4cef9dee5f..f67297227e33 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/about-labels.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/about-labels.md @@ -16,17 +16,17 @@ versions: {% data variables.product.product_name %} 在每个新仓库中提供默认标签。 您可以使用这些默认标签帮助在仓库中创建标准工作流程： -| 标签 | 描述 | -| ------------------ | -------------------------------------------------------------------------- | -| `bug` | 表示非预期的问题或行为{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| `文档` | 表示文档需要改进或补充{% endif %} -| `duplicate` | 表示类似的议题或拉取请求 | -| `enhancement` | 表示新功能申请 | -| `good first issue` | 表示适用首次贡献者的议题 | -| `help wanted` | 表示维护员需要议题或拉取请求方面的帮助 | -| `invalid` | 表示议题或拉取请求不再相关 | -| `question` | 表示议题或拉取请求需要更多信息 | -| `wontfix` | 表示不会继续处理议题或拉取请求 | +| 标签 | 描述 | +| ------------------ | --------------------------------------------------------------- | +| `bug` | Indicates an unexpected problem or unintended behavior | +| `文档` | Indicates a need for improvements or additions to documentation | +| `duplicate` | 表示类似的议题或拉取请求 | +| `enhancement` | 表示新功能申请 | +| `good first issue` | 表示适用首次贡献者的议题 | +| `help wanted` | 表示维护员需要议题或拉取请求方面的帮助 | +| `invalid` | 表示议题或拉取请求不再相关 | +| `question` | 表示议题或拉取请求需要更多信息 | +| `wontfix` | 表示不会继续处理议题或拉取请求 | 创建仓库时，每个新仓库中均包含默认标签，但您稍后可以编辑或删除标签。 更多信息请参阅“[删除标签](/articles/deleting-a-label/)”。 diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/about-project-boards.md b/translations/zh-CN/content/github/managing-your-work-on-github/about-project-boards.md index 65985560a6b9..25f22723518f 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/about-project-boards.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/about-project-boards.md @@ -59,7 +59,7 @@ versions: ### 延伸阅读 - "[创建项目板](/articles/creating-a-project-board)" -- "[编辑项目板](/articles/editing-a-project-board)"{% if currentVersion == "free-pro-team@latest" %} +- "[Editing a project board](/articles/editing-a-project-board)"{% if currentVersion == "free-pro-team@latest" %} - "[复制项目板](/articles/copying-a-project-board)"{% endif %} - "[添加议题和拉取请求到项目板](/articles/adding-issues-and-pull-requests-to-a-project-board)" - "[组织的项目板权限](/articles/project-board-permissions-for-an-organization)" diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md b/translations/zh-CN/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md index a8b2753c5555..7c3b6b0e5e0c 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board.md @@ -54,15 +54,8 @@ versions: 1. 在议题或拉取请求右侧单击 **Projects（项目）{% octicon "gear" aria-label="The Gear icon" %}**。 ![侧栏中的项目板按钮](/assets/images/help/projects/sidebar-project.png) 2. 单击要添加到其中的项目板对应的 **Recent（最近）**、**Repository（仓库）**、**User（用户）**或 **Organization（组织）**选项卡。 ![最近、仓库和组织选项卡](/assets/images/help/projects/sidebar-project-tabs.png) 3. 在 **Filter projects（过滤项目）**字段中输入项目的名称。 ![项目板搜索框](/assets/images/help/projects/sidebar-search-project.png) -4. 选择要添加议题或拉取请求的一个或多个项目板。 ![Selected project board](/assets/images/help/projects/sidebar-select-project.png){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -5. Click -{% octicon "triangle-down" aria-label="The down triangle icon" %}, then click the column where you want your issue or pull request. 该卡将移到您选择的项目板列的底部。 - ![将卡移至列菜单](/assets/images/help/projects/sidebar-select-project-board-column-menu.png) -{% else %} -5. 在议题或拉取请求右侧，单击 **PROJECT-BOARD-NAME（等待分类）**。 ![链接到项目板](/assets/images/help/projects/sidebar-project-board-link.png) -6. 在项目板中，单击 **{% octicon "plus" aria-label="The Plus icon" %} Add cards (1 new)（添加卡 [1 新]）**。 ![添加卡按钮](/assets/images/help/projects/add-cards-pending-button.png) -7. 将议题或拉取请求的卡片从 **Triage（分类）**部分拖到项目板中所需的列。 也可以使用键盘快捷键移动卡片。 {% data reusables.project-management.for-more-info-project-keyboard-shortcuts %} -{% endif %} +4. Select one or more project boards where you want to add the issue or pull request. ![选择的项目板](/assets/images/help/projects/sidebar-select-project.png) +5. 单击 {% octicon "triangle-down" aria-label="The down triangle icon" %}，然后单击您希望议题或拉取请求所在的列。 该卡将移到您选择的项目板列的底部。 ![将卡移至列菜单](/assets/images/help/projects/sidebar-select-project-board-column-menu.png) ### 延伸阅读 diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/applying-labels-to-issues-and-pull-requests.md b/translations/zh-CN/content/github/managing-your-work-on-github/applying-labels-to-issues-and-pull-requests.md index d9556aa7a27d..4f35a79262da 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/applying-labels-to-issues-and-pull-requests.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/applying-labels-to-issues-and-pull-requests.md @@ -1,6 +1,6 @@ --- title: 应用标签到议题和拉取请求 -intro: 在您有写入权限的仓库中，您可以分配标签到议题和拉取请求以帮助组织您的项目。 +intro: '在您有写入权限的仓库中，您可以分配标签到议题和拉取请求以帮助组织您的项目。' redirect_from: - /articles/customizing-issue-labels/ - /articles/applying-labels-to-issues-and-pull-requests @@ -11,14 +11,15 @@ versions: {% tip %} -**提示：**您也可以从议题或拉取请求的 Labels（标签）下拉菜单应用标签。 +**Tip:** You can apply up to a maximum of 100 labels to issues and pull requests. {% endtip %} {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issue-pr %} {% data reusables.repositories.select-items-in-issue-or-pr-list %} -4. 在右上角单击 **Label（标签）**，然后开始输入现有标签的名称。 单击标签名称以将其与所选项目关联。 ![议题里程碑分配下拉菜单](/assets/images/help/issues/issues_applying_labels_dropdown.png) +4. 在右上角单击 **Label（标签）**，然后开始输入现有标签的名称。 单击标签名称以将其与所选项目关联。 You can also apply a label in the Labels drop-down menu within an issue or pull request. ![议题里程碑分配下拉菜单](/assets/images/help/issues/issues_applying_labels_dropdown.png) + ### 延伸阅读 diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/archiving-cards-on-a-project-board.md b/translations/zh-CN/content/github/managing-your-work-on-github/archiving-cards-on-a-project-board.md index 63a7d42ad1fb..4a064f0016e9 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/archiving-cards-on-a-project-board.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/archiving-cards-on-a-project-board.md @@ -13,7 +13,7 @@ versions: ### 存档项目板上的卡 1. 在项目板中，找到要存档的卡，然后单击 {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}。 ![用于编辑项目板卡的选项列表](/assets/images/help/projects/select-archiving-options-project-board-card.png) -2. Click **Archive**. ![从菜单中选择存档选项](/assets/images/help/projects/archive-project-board-card.png) +2. 单击 **Archive（存档）**。 ![从菜单中选择存档选项](/assets/images/help/projects/archive-project-board-card.png) ### 从侧栏恢复项目板中的卡 diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md b/translations/zh-CN/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md index b060eafe5c4a..617e81f9345b 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/assigning-issues-and-pull-requests-to-other-github-users.md @@ -10,7 +10,7 @@ versions: 对仓库有写入权限的任何人都可以分配议题和拉取请求。 -每个议题和拉取请求最多可分配给 10 个人，包括您自己、{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} 任何评论了议题或拉取请求的人、{% endif %}任何对仓库有写入权限的人以及对仓库有读取权限的组织成员 。 更多信息请参阅“[{% data variables.product.prodname_dotcom %} 上的访问权限](/articles/access-permissions-on-github)”。 +You can assign up to 10 people to each issue or pull request, including yourself, anyone who has commented on the issue or pull request, anyone with write permissions to the repository, and organization members with read permissions to the repository. 更多信息请参阅“[{% data variables.product.prodname_dotcom %} 上的访问权限](/articles/access-permissions-on-github)”。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issue-pr %} diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/changing-project-board-visibility.md b/translations/zh-CN/content/github/managing-your-work-on-github/changing-project-board-visibility.md index 5a4e2400d5f8..1be421047437 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/changing-project-board-visibility.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/changing-project-board-visibility.md @@ -1,6 +1,6 @@ --- title: 更改项目板可见性 -intro: 作为组织所有者或项目板管理员，您可以将项目板设为公共或私有。 +intro: '作为组织所有者或项目板管理员，您可以将项目板设为公共或私有。' redirect_from: - /articles/changing-project-board-visibility versions: diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/closing-a-project-board.md b/translations/zh-CN/content/github/managing-your-work-on-github/closing-a-project-board.md index a31662e48b29..a39326d365ca 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/closing-a-project-board.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/closing-a-project-board.md @@ -1,6 +1,6 @@ --- title: 关闭项目板 -intro: 如果您已完成项目板中所有任务或不再需要使用项目板，可以关闭项目板。 +intro: '如果您已完成项目板中所有任务或不再需要使用项目板，可以关闭项目板。' redirect_from: - /articles/closing-a-project/ - /articles/closing-a-project-board @@ -15,7 +15,7 @@ versions: 1. 导航到仓库或组织中或由用户帐户拥有的项目板列表。 2. 在项目列表中，在要关闭的项目板旁边单击 {% octicon "chevron-down" aria-label="The chevron icon" %}。 ![项目板名称右边的 V 形图标](/assets/images/help/projects/project-list-action-chevron.png) -3. Click **Close**. ![关闭项目板下拉菜单中的项](/assets/images/help/projects/close-project.png) +3. 单击 **Close（关闭）**。 ![关闭项目板下拉菜单中的项](/assets/images/help/projects/close-project.png) ### 延伸阅读 diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/creating-a-label.md b/translations/zh-CN/content/github/managing-your-work-on-github/creating-a-label.md index 989bf56dea2d..6d965800de2e 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/creating-a-label.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/creating-a-label.md @@ -1,6 +1,6 @@ --- title: 创建标签 -intro: 在有写入权限的仓库中，您可以创建标签来组织议题和提取请求。 +intro: '在有写入权限的仓库中，您可以创建标签来组织议题和提取请求。' redirect_from: - /articles/creating-and-editing-labels-for-issues-and-pull-requests/ - /articles/creating-a-label @@ -29,6 +29,6 @@ versions: - "[关于标签](/articles/about-labels)" - “[应用标签到议题和拉取请求](/articles/applying-labels-to-issues-and-pull-requests)” - “[编辑标签](/articles/editing-a-label)” -- "[按标签过滤议题和拉取请求](/articles/filtering-issues-and-pull-requests-by-labels)"{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} +- "[Filtering issues and pull requests by labels](/articles/filtering-issues-and-pull-requests-by-labels)"{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} - "[管理组织中仓库的默认标签](/articles/managing-default-labels-for-repositories-in-your-organization)" {% endif %} diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/creating-a-project-board.md b/translations/zh-CN/content/github/managing-your-work-on-github/creating-a-project-board.md index 52b8dd27972d..f2b53d10636c 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/creating-a-project-board.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/creating-a-project-board.md @@ -1,6 +1,6 @@ --- title: 创建项目板 -intro: 项目板可用于创建满足您需求的自定义工作流程，例如对特定功能工作、全面路线图甚至发布检查清单进行跟踪和排列优先级。 +intro: '项目板可用于创建满足您需求的自定义工作流程，例如对特定功能工作、全面路线图甚至发布检查清单进行跟踪和排列优先级。' redirect_from: - /articles/creating-a-project/ - /articles/creating-a-project-board @@ -24,8 +24,8 @@ versions: ### 创建用户拥有的项目板 {% data reusables.profile.access_profile %} -2. On the top of your profile page, in the main navigation, click -{% octicon "project" aria-label="The project board icon" %} **Projects**. +2. 在个人资料页面顶部的主导航中，单击 +{% octicon "project" aria-label="The project board icon" %} **Projects（项目）**。 ![项目选项卡](/assets/images/help/projects/user-projects-tab.png) {% data reusables.project-management.click-new-project %} {% data reusables.project-management.create-project-name-description %} @@ -63,8 +63,8 @@ versions: ### 创建仓库项目板 {% data reusables.repositories.navigate-to-repo %} -2. Under your repository name, click -{% octicon "project" aria-label="The project board icon" %} **Projects**. +2. 在仓库名称下，单击 +{% octicon "project" aria-label="The project board icon" %} **Projects（项目）**。 ![项目选项卡](/assets/images/help/projects/repo-tabs-projects.png) {% data reusables.project-management.click-new-project %} {% data reusables.project-management.create-project-name-description %} @@ -82,7 +82,7 @@ versions: ### 延伸阅读 - "[关于项目板](/articles/about-project-boards)" -- "[编辑项目板](/articles/editing-a-project-board)"{% if currentVersion == "free-pro-team@latest" %} +- "[Editing a project board](/articles/editing-a-project-board)"{% if currentVersion == "free-pro-team@latest" %} - "[复制项目板](/articles/copying-a-project-board)"{% endif %} - "[关闭项目板](/articles/closing-a-project-board)" - “[关于项目板的自动化](/articles/about-automation-for-project-boards)” diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/creating-an-issue.md b/translations/zh-CN/content/github/managing-your-work-on-github/creating-an-issue.md index 4ad547f125e4..3580f09a9578 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/creating-an-issue.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/creating-an-issue.md @@ -1,6 +1,6 @@ --- title: 创建议题 -intro: 议题可用于跟踪漏洞、增强功能或其他请求。 +intro: '议题可用于跟踪漏洞、增强功能或其他请求。' redirect_from: - /articles/creating-an-issue versions: @@ -17,7 +17,7 @@ versions: {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} {% tip %} -**Tip**: You can also create an issue using the {% data variables.product.prodname_cli %}. For more information, see "[`gh issue create`](https://cli.github.com/manual/gh_issue_create)" in the {% data variables.product.prodname_cli %} documentation. +**提示**：您也可以使用 {% data variables.product.prodname_cli %} 创建议题。 更多信息请参阅 {% data variables.product.prodname_cli %} 文档中的“[`gh 议题创建`](https://cli.github.com/manual/gh_issue_create)”。 {% endtip %} {% endif %} diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/deleting-a-label.md b/translations/zh-CN/content/github/managing-your-work-on-github/deleting-a-label.md index 8179a3153d76..202faef965fc 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/deleting-a-label.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/deleting-a-label.md @@ -1,6 +1,6 @@ --- title: 删除标签 -intro: 在拥有写入权限的仓库中，如果您不再需要某一标签来分类 issue 或拉取请求，可将其删除。 +intro: '在拥有写入权限的仓库中，如果您不再需要某一标签来分类 issue 或拉取请求，可将其删除。' redirect_from: - /articles/deleting-a-label versions: @@ -18,6 +18,6 @@ versions: ### 延伸阅读 - “[应用标签到议题和拉取请求](/articles/applying-labels-to-issues-and-pull-requests)” -- "[按标签过滤议题和拉取请求](/articles/filtering-issues-and-pull-requests-by-labels)"{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} +- "[Filtering issues and pull requests by labels](/articles/filtering-issues-and-pull-requests-by-labels)"{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} - "[管理组织中仓库的默认标签](/articles/managing-default-labels-for-repositories-in-your-organization)" {% endif %} diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/disabling-issues.md b/translations/zh-CN/content/github/managing-your-work-on-github/disabling-issues.md index 9704fe06db72..66e04f08d453 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/disabling-issues.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/disabling-issues.md @@ -17,8 +17,9 @@ versions: {% if currentVersion == "free-pro-team@latest" %} {% tip %} +Please contact -如果您因陌生人滥用而需要关闭议题，请联系 {% data variables.contact.contact_support %}。 +{% data variables.contact.contact_support %} if you want to turn off issues because of abuse from strangers. {% data reusables.policies.abuse %} {% endtip %} diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/editing-a-label.md b/translations/zh-CN/content/github/managing-your-work-on-github/editing-a-label.md index caad600d1fdc..a48ca2b3eb36 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/editing-a-label.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/editing-a-label.md @@ -1,6 +1,6 @@ --- title: 编辑标签 -intro: 在拥有写入权限的仓库中，您可以编辑现有标签的名称、颜色和说明。 +intro: '在拥有写入权限的仓库中，您可以编辑现有标签的名称、颜色和说明。' redirect_from: - /articles/editing-a-label versions: @@ -23,6 +23,6 @@ versions: - “[创建标签](/articles/creating-a-label)” - “[删除标签](/articles/deleting-a-label)” - “[应用标签到议题和拉取请求](/articles/applying-labels-to-issues-and-pull-requests)” -- "[按标签过滤议题和拉取请求](/articles/filtering-issues-and-pull-requests-by-labels)"{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} +- "[Filtering issues and pull requests by labels](/articles/filtering-issues-and-pull-requests-by-labels)"{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} - "[管理组织中仓库的默认标签](/articles/managing-default-labels-for-repositories-in-your-organization)" {% endif %} diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests.md b/translations/zh-CN/content/github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests.md index 97571b36886d..53a67879b052 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests.md @@ -1,6 +1,6 @@ --- -title: 议题和拉取请求中的文件附件 -intro: 在打开议题或更新拉取请求时，您可以使用议题附件上传提议功能的图像或漏洞的屏幕截图。 +title: File attachments on issues and pull requests +intro: 'When you open issue or update a pull request, you can use issue attachments to upload images of proposed features or screenshots of bugs.' redirect_from: - /articles/issue-attachments/ - /articles/file-attachments-on-issues-and-pull-requests @@ -8,34 +8,33 @@ versions: free-pro-team: '*' enterprise-server: '*' --- - {% warning %} -**警告：**如果您在拉取请求或议题评论中添加了图像，则任何人都可以查看匿名图像 URL，无需身份验证，即使该拉取请求位于私有仓库中{% if currentVersion != "free-pro-team@latest" %}或者启用了私有模式{% endif %}。 要对敏感图像保密，请从需要身份验证的私有网络或服务器提供它们。 {% if currentVersion == "free-pro-team@latest" %}有关匿名 URL 的更多信息，请参阅“[关于匿名图像 URL](/articles/about-anonymized-image-urls)”。{% endif %} +**Warning:** If you add an image to a pull request or issue comment, anyone can view the anonymized image URL without authentication, even if the pull request is in a private repository{% if currentVersion != "free-pro-team@latest" %}, or if private mode is enabled{% endif %}. To keep sensitive images private, serve them from a private network or server that requires authentication. {% if currentVersion == "free-pro-team@latest" %}For more information on anonymized URLs see "[About anonymized image URLs](/articles/about-anonymized-image-urls)".{% endif %} {% endwarning %} -要将文件附加到议题或拉取请求对话，请将它拖放到评论框中。 或者，您也可以单击评论框底部的栏来浏览、选择和添加计算机中的文件。 +To attach a file to an issue or pull request conversation, drag and drop it into the comment box. Alternatively, you can click the bar at the bottom of the comment box to browse, select, and add a file from your computer. -![从计算机选择附件](/assets/images/help/pull_requests/select-bar.png) +![Select attachments from computer](/assets/images/help/pull_requests/select-bar.png) {% tip %} -**提示：**如果使用 Chrome，您还可以将图像直接复制并粘贴到该框中。 +**Tip:** If you're using Chrome, you can also copy-and-paste images directly into the box. {% endtip %} -文件大小不得超过 25MB，图像大小不得超过 10MB。 +The maximum size for files is 25MB and the maximum size for images is 10MB. -我们支持这些文件： +We support these files: * PNG (*.png*) * GIF (*.gif*) * JPEG (*.jpg*) -* 日志文件 (*.log*) -* Microsoft Word (*.docx*)、Powerpoint (*.pptx*) 和 Excel (*.xlsx*) 文档 -* 文本文件 (*.txt*) -* PDF (*.pdf*) -* ZIP (*.zip*、*.gz*) +* Log files (*.log*) +* Microsoft Word (*.docx*), Powerpoint (*.pptx*), and Excel (*.xlsx*) documents +* Text files (*.txt*) +* PDFs (*.pdf*) +* ZIP (*.zip*, *.gz*) -![附件动画 GIF](/assets/images/help/pull_requests/dragging_images.gif) +![Attachments animated GIF](/assets/images/help/pull_requests/dragging_images.gif) diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md b/translations/zh-CN/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md index 51b194d035fd..68f6d9e840d6 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/filtering-cards-on-a-project-board.md @@ -8,20 +8,20 @@ versions: enterprise-server: '*' --- -在卡上可以单击任何受理人{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}、里程碑{% endif %}或标签来按限定条件过滤项目板。 要清除搜索，可再次单击同一个受理人{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}、里程碑{% endif %}或标签。 +On a card, you can click any assignee, milestone, or label to filter the project board by that qualifier. To clear the search, you can click the same assignee, milestone, or label again. 也可使用每个项目板顶部的“Filter cards（过滤卡）”搜索栏来搜索卡。 您可以使用以下搜索限定符的任意组合来过滤卡，或者直接输入您要搜索的某些文本。 - 使用 `author:USERNAME` 按作者过滤卡 - 使用 `assignee:USERNAME` 或 `no:assignee` 按受理人过滤卡 -- 使用 `label:LABEL`、`label:"MULTI-WORD LABEL NAME"` 或 `no:label`{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} 按标签过滤卡 -- 使用 `milestone:MY-MILESTONE`{% endif %} 按里程碑过滤 +- Filter cards by label using `label:LABEL`, `label:"MULTI-WORD LABEL NAME"`, or `no:label` +- 使用 `milestone:MY-MILESTONE` 按里程碑过滤 - 使用 `state:open`、`state:closed` 或 `state:merged` 按状态过滤卡 - 使用 `review:none`、`review:required`、`review:approved` 或 `review:changes_requested` 按审查状态过滤 - 使用 `status:pending`、`status:success` 或 `status:failure` 按检查状态过滤 - 使用 `type:issue`、`type:pr` 或 `type:note` 按类型过滤卡 - 使用 `is:open`、`is:closed` 或 `is:merged` 和 `is:issue`、`is:pr` 或 `is:note` 按状态和类型过滤卡 -- 使用 `linked:pr` 关闭引用，按链接到拉取请求的议题过滤卡{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +- Filter cards by issues that are linked to a pull request by a closing reference using `linked:pr`{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} - 使用 `repo:ORGANIZATION/REPOSITORY` 在组织范围的项目板中按仓库过滤卡{% endif %} 1. 导航到包含要过滤的卡的项目板。 diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests-by-milestone.md b/translations/zh-CN/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests-by-milestone.md index 969fa5b9b2e2..347d1ab13fbd 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests-by-milestone.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/filtering-issues-and-pull-requests-by-milestone.md @@ -14,7 +14,7 @@ versions: - 如果要使用搜索栏过滤议题和拉取请求，您可以使用里程碑搜索语法。 对于名为 My Milestone 的里程碑，搜索语法为：`milestone:"My Milestone"`。 - 要清除过滤器选择，请单击 **Clear current search query, filters, and sorts（清除当前搜索查询、过滤和排序）**。 -- You can also filter issues or pull requests using the {% data variables.product.prodname_cli %}. For more information, see "[`gh issue list`](https://cli.github.com/manual/gh_issue_list)" or "[`gh pr list`](https://cli.github.com/manual/gh_pr_list)" in the {% data variables.product.prodname_cli %} documentation. +- 还可以使用 {% data variables.product.prodname_cli %} 过滤议题或拉取请求。 For more information, see "[`gh issue list`](https://cli.github.com/manual/gh_issue_list)" or "[`gh pr list`](https://cli.github.com/manual/gh_pr_list)" in the {% data variables.product.prodname_cli %} documentation. {% endtip %} diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/finding-information-in-a-repository.md b/translations/zh-CN/content/github/managing-your-work-on-github/finding-information-in-a-repository.md index a98c433ec12c..fe046ab27c1c 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/finding-information-in-a-repository.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/finding-information-in-a-repository.md @@ -1,6 +1,6 @@ --- title: 查找仓库中的信息 -intro: 要在 GitHub 上查找有关仓库的详细信息，您可以过滤、排序和搜索与仓库相关的议题和拉取请求。 +intro: '要在 GitHub 上查找有关仓库的详细信息，您可以过滤、排序和搜索与仓库相关的议题和拉取请求。' mapTopic: true redirect_from: - /articles/finding-information-in-a-repository diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md b/translations/zh-CN/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md index 63a72fbe34c7..540a63bc0c6b 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue.md @@ -1,6 +1,6 @@ --- title: 将拉取请求链接到议题 -intro: '您可以将拉取请求链接到议题，以便{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}显示正在进行的修复并且{% endif %}在拉取请求合并时自动关闭议题。' +intro: 'You can link a pull request to an issue to{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} show that a fix is in progress and to{% endif %} automatically close the issue when the pull request is merged.' redirect_from: - /articles/closing-issues-via-commit-message/ - /articles/closing-issues-via-commit-messages/ @@ -11,15 +11,19 @@ versions: enterprise-server: '*' --- +{% note %} + +**Note:** The special keywords in a pull request description are interpreted when the pull request targets the repository's *default* branch. However, if the PR's base is *any other branch*, then these keywords are ignored, no links are created and merging the PR has no effect on the issues. **If you want to link a pull request to an issue using a keyword, the PR must be on the default branch.** + +{% endnote %} + ### 关于链接的议题和拉取请求 -您可以{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}手动或{% endif %}使用拉取请求说明中支持的关键词将议题链接到拉取请求。 +You can link an issue to a pull request {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}manually or {% endif %}using a supported keyword in the pull request description. -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -当您将拉取请求链接到拉取请求指向的议题，如果有人正在操作该议题，协作者可以看到。 -{% if currentVersion ver_lt "enterprise-server@2.21" %}如果拉取请求和议题在不同的仓库中，{% data variables.product.product_name %} 将在拉取请求合并后并且合并拉取请求的人有权限关闭议题时才会显示链接。{% endif %}{% endif %} +当您将拉取请求链接到拉取请求指向的议题，如果有人正在操作该议题，协作者可以看到。 {% if currentVersion ver_lt "enterprise-server@2.21" %}If the pull request and the issue are in different repositories, {% data variables.product.product_name %} will display the link after the pull request is merged, if the person who merges the pull request also has permission to close the issue.{% endif %} -将链接的拉取请求合并到仓库的默认分支时，其链接的议题将自动关闭。 有关默认分支的更多信息，请参阅“[设置默认分支](/github/administering-a-repository/setting-the-default-branch)”。 +将链接的拉取请求合并到仓库的默认分支时，其链接的议题将自动关闭。 For more information about the default branch, see "[Changing the default branch](/github/administering-a-repository/changing-the-default-branch)." {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} ### 手动将拉取请求链接到议题 @@ -37,7 +41,7 @@ versions: ### 使用关键词将拉取请求链接到议题 -您可以通过在拉取请求说明中使用支持的关键词将拉取请求链接到议题。 +You can link a pull request to an issue by using a supported keyword in the pull request's description or in a commit message (please note that the pull request must be on the default branch). * close * closes @@ -57,9 +61,9 @@ versions: | 不同仓库中的议题 | *KEYWORD* *OWNER*/*REPOSITORY*#*ISSUE-NUMBER* | `Fixes octo-org/octo-repo#100` | | 多个议题 | 对每个议题使用完整语法 | `Resolves #10, resolves #123, resolves octo-org/octo-repo#100` | -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}只有手动链接的拉取请求才能手动取消链接。 要取消链接您使用关键词链接的议题，必须编辑拉取请求说明以删除该关键词。{% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}Only manually linked pull requests can be manually unlinked. 要取消链接您使用关键词链接的议题，必须编辑拉取请求说明以删除该关键词。{% endif %} -您也可以在提交消息中使用关闭关键词。 议题将在提交合并到默认分支时关闭{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}，但包含提交的拉取请求不会列为链接的拉取请求{% endif %}。 +您也可以在提交消息中使用关闭关键词。 The issue will be closed when you merge the commit into the default branch, but the pull request that contains the commit will not be listed as a linked pull request. ### 延伸阅读 diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/linking-a-repository-to-a-project-board.md b/translations/zh-CN/content/github/managing-your-work-on-github/linking-a-repository-to-a-project-board.md index 10ce2d8313b1..6065e1d7387c 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/linking-a-repository-to-a-project-board.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/linking-a-repository-to-a-project-board.md @@ -18,7 +18,7 @@ versions: 4. 在左侧边栏中，单击 **Linked repositories（链接的仓库）**。 ![左侧边栏中链接的仓库菜单选项](/assets/images/help/projects/project-board-linked-repositories-setting.png) 5. 单击 **Link a repository（链接仓库）**。 ![链接的仓库选项卡中的链接仓库按钮](/assets/images/help/projects/link-repository-button.png) 6. 搜索要链接的仓库。 ![链接仓库窗口中的搜索字段](/assets/images/help/projects/search-to-link-repository.png) -7. Click **Link**. 要取消链接，请单击 **Unlink（取消链接）**。 ![链接按钮](/assets/images/help/projects/link-button.png) +7. 单击 **Link（链接）**。 要取消链接，请单击 **Unlink（取消链接）**。 ![链接按钮](/assets/images/help/projects/link-button.png) ### 延伸阅读 diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/opening-an-issue-from-code.md b/translations/zh-CN/content/github/managing-your-work-on-github/opening-an-issue-from-code.md index 98f38c031d39..def202fc4639 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/opening-an-issue-from-code.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/opening-an-issue-from-code.md @@ -19,7 +19,7 @@ versions: - 要打开文件中代码相关的议题，请找到该文件。 - 要打开拉取请求中代码相关的议题，请找到该拉取请求并单击 {% octicon "diff" aria-label="The file diff icon" %} **Files changed（文件已更改）**。 然后浏览到含有要包含在评论中的代码的文件，并单击 **View（查看）**。 {% data reusables.repositories.choose-line-or-range %} -4. To the left of the code range, click +4. 在代码范围的左侧，单击 {% octicon "kebab-horizontal" aria-label="The horizontal kebab octicon" %}. 在下拉菜单中，单击 **Reference in new issue（新议题中的引用）**。 ![带有从所选行打开新议题的选项的烤肉串式菜单](/assets/images/help/repository/open-new-issue-specific-line.png) {% data reusables.repositories.type-issue-title-and-description %} diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/sharing-filters.md b/translations/zh-CN/content/github/managing-your-work-on-github/sharing-filters.md index 9d027fc59ae7..4888eaa235c3 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/sharing-filters.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/sharing-filters.md @@ -1,6 +1,6 @@ --- title: 共享过滤器 -intro: 当您过滤或排序议题和拉取请求时，浏览器的 URL 自动更新以匹配新视图。 +intro: '当您过滤或排序议题和拉取请求时，浏览器的 URL 自动更新以匹配新视图。' redirect_from: - /articles/sharing-filters versions: diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/tracking-progress-on-your-project-board.md b/translations/zh-CN/content/github/managing-your-work-on-github/tracking-progress-on-your-project-board.md index b5003cfe12fe..5231fe89271c 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/tracking-progress-on-your-project-board.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/tracking-progress-on-your-project-board.md @@ -1,6 +1,6 @@ --- title: 跟踪项目板上的进度 -intro: 默认情况下，当您在项目板上启用自动化后，将在进度栏中跟踪项目的总体进度。 +intro: '默认情况下，当您在项目板上启用自动化后，将在进度栏中跟踪项目的总体进度。' redirect_from: - /articles/tracking-progress-on-your-project-board versions: diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md b/translations/zh-CN/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md index a26c89ba519d..41b605632e55 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/transferring-an-issue-to-another-repository.md @@ -1,18 +1,18 @@ --- title: 将议题转让给其他仓库 -intro: 要移动议题以更好地过滤仓库，您可以将开放的议题转让给其他仓库。 +intro: '要移动议题以更好地过滤仓库，您可以将开放的议题转让给其他仓库。' redirect_from: - /articles/transferring-an-issue-to-another-repository versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- 要将打开的议题转让给另一个仓库，必须对议题所在的仓库以及议题要转让到的仓库都有写入权限。 更多信息请参阅“[组织的仓库权限级别](/articles/repository-permission-levels-for-an-organization)”。 您只能在同一用户或组织帐户拥有的仓库之间转让议题。 您无法将私有仓库的议题转让给公共仓库。 -转让议题时，评论和受理人将保留。 议题的标签{% if currentVersion ver_lt "enterprise-server@2.19" %}、项目{% endif %} 和里程碑不予保留。{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} 此议题将保留在任何用户拥有或组织范围的项目板上，并从任何仓库项目板中删除。 更多信息请参阅“[关于项目板](/articles/about-project-boards)”。{% endif %} +转让议题时，评论和受理人将保留。 The issue's labels and milestones are not retained. This issue will stay on any user-owned or organization-wide project boards and be removed from any repository project boards. 更多信息请参阅“[关于项目板](/articles/about-project-boards)”。 议题中提及的人员或团队将收到通知，告知他们该议题已转让给新仓库。 原来的 URL 会重定向到新议题的 URL。 在新仓库中没有读取权限的人员将看到一个横幅，告知他们该议题已转让给他们无法访问的新仓库。 diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/using-search-to-filter-issues-and-pull-requests.md b/translations/zh-CN/content/github/managing-your-work-on-github/using-search-to-filter-issues-and-pull-requests.md index 9468779b94e1..5874f3dd2705 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/using-search-to-filter-issues-and-pull-requests.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/using-search-to-filter-issues-and-pull-requests.md @@ -31,7 +31,7 @@ versions: - 通过关闭引用过滤链接到拉取请求的议题：`linked:pr` {% endif %} -For pull requests, you can also use search to: +对于拉取请求，您还可以使用搜索来： - 过滤[草稿](/articles/about-pull-requests#draft-pull-requests)拉取请求：`is:draft` - 过滤尚未[审查](/articles/about-pull-request-reviews)的拉取请求：`state:open type:pr review:none` - 过滤[需要审查](/articles/about-required-reviews-for-pull-requests)然后才能合并的拉取请求：`state:open type:pr review:required` @@ -39,7 +39,7 @@ For pull requests, you can also use search to: - 过滤审查者要求更改的拉取请求：`state:open type:pr review:changes_requested` - 按[审查者](/articles/about-pull-request-reviews/)过滤拉取请求：`state:open type:pr reviewed-by:octocat` - 按[请求审查](/articles/requesting-a-pull-request-review)的特定用户过滤拉取请求：`state:open type:pr review-requested:octocat` -- 按申请审查的团队过滤拉取请求：`state:open type:pr team-review-requested:github/atom`{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +- Filter pull requests by the team requested for review: `state:open type:pr team-review-requested:github/atom`{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} - 过滤链接到拉取请求可能关闭的议题的拉取请求：`linked:issue`{% endif %} ### 延伸阅读 diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/viewing-all-of-your-issues-and-pull-requests.md b/translations/zh-CN/content/github/managing-your-work-on-github/viewing-all-of-your-issues-and-pull-requests.md index a51b5096d474..f22f7a794b1f 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/viewing-all-of-your-issues-and-pull-requests.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/viewing-all-of-your-issues-and-pull-requests.md @@ -1,6 +1,6 @@ --- title: 查看所有议题和拉取请求 -intro: 议题和拉取请求仪表板列出您已创建的开放议题和拉取请求。 您可以使用它们更新已过时的项目、关闭它们或跟踪所有仓库（包括您没有订阅的仓库）内提到的位置。 +intro: '议题和拉取请求仪表板列出您已创建的开放议题和拉取请求。 您可以使用它们更新已过时的项目、关闭它们或跟踪所有仓库（包括您没有订阅的仓库）内提到的位置。' redirect_from: - /articles/viewing-all-of-your-issues-and-pull-requests versions: @@ -15,4 +15,4 @@ versions: ### 延伸阅读 -- {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}”[查看您的订阅](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions#reviewing-repositories-that-youre-watching){% else %}”[列出您关注的仓库](/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching){% endif %}" +- {% 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#reviewing-repositories-that-youre-watching){% else %}”[Listing the repositories you're watching](/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching){% endif %}" diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/viewing-your-milestones-progress.md b/translations/zh-CN/content/github/managing-your-work-on-github/viewing-your-milestones-progress.md index b6111d26b642..2bfbeee2239c 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/viewing-your-milestones-progress.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/viewing-your-milestones-progress.md @@ -1,6 +1,6 @@ --- title: 查看里程碑的进度 -intro: 为了跟踪您的里程碑，您需要更好地了解剩余多少未解决的议题和拉取请求。 +intro: '为了跟踪您的里程碑，您需要更好地了解剩余多少未解决的议题和拉取请求。' redirect_from: - /articles/viewing-your-milestone-s-progress - /articles/viewing-your-milestones-progress diff --git a/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/about-email-notifications.md b/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/about-email-notifications.md index 89e92a164e68..767f0108df5c 100644 --- a/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/about-email-notifications.md +++ b/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/about-email-notifications.md @@ -1,6 +1,6 @@ --- title: 关于电子邮件通知 -intro: 启用电子邮件通知后，您在电子邮件客户端中将会收到参与和观看通知，您也可以使用电子邮件标头信息过滤电子邮件。 +intro: '启用电子邮件通知后，您在电子邮件客户端中将会收到参与和观看通知，您也可以使用电子邮件标头信息过滤电子邮件。' versions: enterprise-server: <2.21 --- @@ -19,17 +19,17 @@ versions: 来自 {% data variables.product.product_name %} 的电子邮件通知包含以下标头信息： -| 标头 | 信息 | -| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `From` 地址 | 此地址始终是“站点管理员配置的无需回复电子邮件地址”。 | -| `To` 字段 | 此字段直接连接到线程。 如果您回复电子邮件，将会为对话添加新评论。 | -| `Cc` 地址 | 如果您订阅了对话，{% data variables.product.product_name %} 将会 `Cc` 给您。 第二个 `Cc` 电子邮件地址与通知原因匹配。 这些通知原因的后缀是 {% data variables.notifications.cc_address %}。 可能的通知原因包括：
    • `assign`：您被分配到议题或拉取请求。
    • `author`：您创建了议题或拉取请求。
    • `comment`：您评论了议题或拉取请求。
    • `manual`：您手动订阅的议题或拉取请求有更新。
    • `mention`：您提及了议题或拉取请求。
    • `push`：有人提交了您订阅的拉取请求。
    • `review_requested`：您或您所在的团队已请求审查拉取请求。
    • `security_alert`：{% data variables.product.prodname_dotcom %} 检测到您要接收其漏洞警报的仓库中存在漏洞。
    • `state_change`：您订阅的议题或拉取请求已关闭或打开。
    • `subscribed`：您查看的仓库有更新。
    • `team_mention`：您所属的团队在议题或拉取请求中被提及。
    • `your_activity`：您打开、评论或关闭了议题或拉取请求。
    | -| `mailing list` 字段 | 此字段识别仓库名称及其所有者。 此地址的格式始终是 `<仓库名称>.<仓库所有者>.{% data variables.command_line.backticks %}`。 |{% if currentVersion ver_gt "enterprise-server@2.19" % %} -| `X-GitHub-Severity` 字段 | {% data reusables.repositories.security-alerts-x-github-severity %} 可能的严重程度等级包括：
    • `low`
    • `moderate`
    • `high`
    • `critical`
    更多信息请参阅“[关于易受攻击的依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)”。 |{% endif %} +| 标头 | 信息 | +| --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `From` 地址 | 此地址始终是“站点管理员配置的无需回复电子邮件地址”。 | +| `To` 字段 | 此字段直接连接到线程。 如果您回复电子邮件，将会为对话添加新评论。 | +| `Cc` 地址 | 如果您订阅了对话，{% data variables.product.product_name %} 将会 `Cc` 给您。 第二个 `Cc` 电子邮件地址与通知原因匹配。 这些通知原因的后缀是 {% data variables.notifications.cc_address %}。 可能的通知原因包括：
    • `assign`：您被分配到议题或拉取请求。
    • `author`：您创建了议题或拉取请求。
    • `comment`：您评论了议题或拉取请求。
    • `manual`：您手动订阅的议题或拉取请求有更新。
    • `mention`：您提及了议题或拉取请求。
    • `push`：有人提交了您订阅的拉取请求。
    • `review_requested`：您或您所在的团队已请求审查拉取请求。
    • `security_alert`：{% data variables.product.prodname_dotcom %} 检测到您要接收其漏洞警报的仓库中存在漏洞。
    • `state_change`：您订阅的议题或拉取请求已关闭或打开。
    • `subscribed`：您查看的仓库有更新。
    • `team_mention`：您所属的团队在议题或拉取请求中被提及。
    • `your_activity`：您打开、评论或关闭了议题或拉取请求。
    | +| `mailing list` 字段 | 此字段识别仓库名称及其所有者。 此地址的格式始终是 `<仓库名称>.<仓库所有者>.{% data variables.command_line.backticks %}`。 |{% if currentVersion ver_gt "enterprise-server@2.19" % %} +| `X-GitHub-Severity` 字段 | {% data reusables.repositories.security-alerts-x-github-severity %} 可能的严重程度等级包括：
    • `低`
    • `中`
    • `高`
    • `严重`
    更多信息请参阅“[关于易受攻击的依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)”。 |{% endif %} ### 延伸阅读 - "[列出您关注的仓库](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-repositories-youre-watching)" - "[关注和取消关注仓库](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories)" -- "[订阅和退订通知](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)"{% if currentVersion ver_gt "enterprise-server@2.17" %} -- "[创建 gists](/articles/creating-gists)"{% endif %} +- "[订阅和退订通知](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications)" +- "[创建 gists](/articles/creating-gists)" diff --git a/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/about-notifications.md b/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/about-notifications.md index 269fd4ae0553..adcebcb5d24b 100644 --- a/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/about-notifications.md +++ b/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/about-notifications.md @@ -33,9 +33,8 @@ versions: #### 查看通知 -您查看的仓库或团队讨论如有更新，{% data variables.product.product_name %} 会发送*查看*通知。 {% if currentVersion ver_gt "enterprise-server@2.17" %} {% data reusables.notifications.auto-watch %}更多信息请参阅“[关注和取消关注仓库](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories)”。 - -{% endif %}您在以下情况下会收到通知： +您查看的仓库或团队讨论如有更新，{% data variables.product.product_name %} 会发送*查看*通知。 {% data reusables.notifications.auto-watch %}For more information, see "[Watching and unwatching repositories](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories)." +您在以下情况下会收到通知： - 新开了一个议题。 - 打开的议题新增了评论。 - 新开了一个拉取请求。 diff --git a/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/about-web-notifications.md b/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/about-web-notifications.md index 404554af3722..e7d5e7ba3037 100644 --- a/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/about-web-notifications.md +++ b/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/about-web-notifications.md @@ -7,11 +7,11 @@ versions: 有关*参与*和*关注*通知之间差异的更多信息，请参阅“[关于通知](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/about-notifications)”。 -为帐户启用 web 通知后，您可以单击通知页面中的项目，并且会重定向到通知所参考的对话。 为帐户启用 web 通知后，您可以单击通知页面中的项目，并且会重定向到通知所参考的对话。 有关启用 web 通知的更多信息，请参阅“[选择通知的递送方式](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications)”。 +为帐户启用 web 通知后，您可以单击通知页面中的项目，并且会重定向到通知所参考的对话。 For more information on enabling web notifications, see "[Choosing the delivery method for your notifications](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications)." 有关启用 web 通知的更多信息，请参阅“[选择通知的递送方式](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications)”。 {% data reusables.notifications.shared_state %} -From your notifications page, you can also mark notifications as read, save notifications for later, and unsubscribe from threads. 更多信息请参阅： +在通知页面上，您还可以将通知标记为已读、保存通知供以后使用以及取消订阅帖子。 更多信息请参阅： - "[将通知标记为已读](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/marking-notifications-as-read)" - "[保存通知供以后查看](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/saving-notifications-for-later)" diff --git a/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications.md b/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications.md index 5e01a6e46842..16b9873daae3 100644 --- a/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications.md +++ b/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications.md @@ -15,7 +15,7 @@ versions: {% data reusables.user_settings.notifications %} 3. 通过选中复选框，配置您希望如何接收有关您参与或关注的通知： - 选中 **Email（电子邮件）**将通过您的默认通知电子邮件地址接收通知。 - - 选中 **Web**将允许您在 {% data variables.product.product_location %} 上访问通知。 ![Configuring notification settings](/assets/images/help/settings/ent-notifications-settings.png) + - 选中 **Web**将允许您在 {% data variables.product.product_location %} 上访问通知。 ![配置通知设置](/assets/images/help/settings/ent-notifications-settings.png) 4. 如果为参与或关注的对话选择了 **Email（电子邮件）**， 请在“Notification email（通知电子邮件）”部分选中复选框以选择要接收哪些更新： - 选中 **Comments on Issues and Pull Requests（议题和拉取请求评论）**，则有人在议题或拉取请求的“Conversation（对话）”选项卡中发表评论时，您将会收到电子邮件。 - 选中 **Pull request reviews（拉取请求审查）**，则有人在拉取请求的“Files changed（已更改文件）”选项卡中发表审查评论时，您将会收到电子邮件。 diff --git a/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/listing-the-issues-and-pull-requests-youre-subscribed-to.md b/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/listing-the-issues-and-pull-requests-youre-subscribed-to.md index 87b2ccfdc2d2..1512569591fa 100644 --- a/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/listing-the-issues-and-pull-requests-youre-subscribed-to.md +++ b/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/listing-the-issues-and-pull-requests-youre-subscribed-to.md @@ -1,6 +1,6 @@ --- title: 列出您订阅的议题和拉取请求 -intro: 您可以查看您订阅的所有议题和拉取请求的概述，以便于找到您感兴趣但未收到近期通知的对话。 +intro: '您可以查看您订阅的所有议题和拉取请求的概述，以便于找到您感兴趣但未收到近期通知的对话。' versions: enterprise-server: <2.21 --- @@ -10,7 +10,7 @@ versions: ### 查看订阅列表 1. 在任何页面的右上角，单击 {% octicon "bell" aria-label="The notifications bell" %}。 如果您禁用了 web 通知，并且未看到铃铛图标，可以导航到 。 更多信息请参阅“[选择通知的递送方式](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications)”。 ![表示任何未读消息的通知](/assets/images/help/notifications/notifications_general_existence_indicator.png) -2. Click **Subscriptions** ![订阅选项卡](/assets/images/help/notifications/subscriptions-tab.png) +2. 单击 **Subscriptions（订阅）** ![订阅选项卡](/assets/images/help/notifications/subscriptions-tab.png) ### 取消订阅议题和拉取请求 diff --git a/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/managing-your-notifications.md b/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/managing-your-notifications.md index 0eccfb84fc6e..633fc8a050b8 100644 --- a/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/managing-your-notifications.md +++ b/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/managing-your-notifications.md @@ -1,6 +1,6 @@ --- title: 管理通知 -intro: 为便于接收您感兴趣的通知，您可以将通知标记为已读，订阅和退订通知，以及关注和取消关注仓库。 +intro: '为便于接收您感兴趣的通知，您可以将通知标记为已读，订阅和退订通知，以及关注和取消关注仓库。' mapTopic: true versions: enterprise-server: <2.21 diff --git a/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/marking-notifications-as-read.md b/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/marking-notifications-as-read.md index 316d4f541e23..c4d4a6b51c93 100644 --- a/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/marking-notifications-as-read.md +++ b/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/marking-notifications-as-read.md @@ -1,6 +1,6 @@ --- title: 将通知标记为已读 -intro: 您可以将 web 通知标记为已读而不查阅。 如果对话有更新，您将收到新的通知。 您也可以将已读通知标记为未读，便于以后再次轻松找到它们。 +intro: '您可以将 web 通知标记为已读而不查阅。 如果对话有更新，您将收到新的通知。 您也可以将已读通知标记为未读，便于以后再次轻松找到它们。' versions: enterprise-server: <2.21 --- diff --git a/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/saving-notifications-for-later.md b/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/saving-notifications-for-later.md index 74a5d6d293a3..366250fd29f4 100644 --- a/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/saving-notifications-for-later.md +++ b/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/saving-notifications-for-later.md @@ -11,7 +11,7 @@ versions: {% data reusables.notifications.access_notifications %} 1. 在通知列表中，找到您想要保存以供稍后使用的通知。 -1. On the right side of the notification, click +1. 在通知的右侧，单击 {% octicon "bookmark" aria-label="The bookmark button" %}. ![用于保存通知的按钮](/assets/images/help/notifications/save_notification.png) {% data reusables.notifications.saved_for_late_sidebar %} diff --git a/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications.md b/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications.md index 8f43f7ef3b57..27297b722e5e 100644 --- a/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications.md +++ b/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/subscribing-to-and-unsubscribing-from-notifications.md @@ -1,27 +1,18 @@ --- title: 订阅和取消订阅通知 -intro: 您可以订阅议题、拉取请求和团队讨论中的单个对话，即使没有看到仓库或正在进行对话的团队成员。 如果您对对话不再感兴趣，您可以取消订阅或自定义接收的通知类型。 +intro: '您可以订阅议题、拉取请求和团队讨论中的单个对话，即使没有看到仓库或正在进行对话的团队成员。 如果您对对话不再感兴趣，您可以取消订阅或自定义接收的通知类型。' versions: enterprise-server: <2.21 --- ### 管理议题或拉取请求的通知设置 -{% if currentVersion ver_lt "enterprise-server@2.18" %}如果您在议题或拉取请求中订阅对话，将在每次对话更新时收到通知，即使您未参与该对话。 - -如果您在议题或拉取请求中取消订阅对话，您将不再收到关于该对话的通知。 如果对话中@提及您或您所属的团队，您将再次开始接收通知。 有关@提及的更多信息，请参阅“[基本撰写和格式语法](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams)”。{% endif %} - {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issue-pr %} 3. 选择要订阅的议题或拉取请求。 -{% if currentVersion ver_gt "enterprise-server@2.17" %} 4. 在右侧边栏中，单击 **Subscribe（订阅）**或 **Unsubscribe（取消订阅）**。 ![对话订阅按钮](/assets/images/help/notifications/subscribe_button_with_gear.png) 5. 要自定义您的通知，请单击 {% octicon "gear" aria-label="The gear icon" %}。 ![对话订阅旁边的齿轮按钮](/assets/images/help/notifications/subscribe_button_with_gear_chosen.png) -6. 选择您要为此对话接收的通知类型，然后单击 **Save（保存）**。 ![对话订阅选项列表](/assets/images/help/notifications/subscribe_options.png) -{% else %} -4. 要订阅或取消订阅对话，在右侧边栏中，单击 **Subscribe（订阅）**或 **Unsubscribe（取消订阅）**。 ![对话订阅按钮](/assets/images/help/notifications/subscribe_button.png) -{% endif %} -You can see a list of all the issues and pull requests you're subscribed to. 更多信息请参阅“[列出您订阅的议题和拉取请求](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-issues-and-pull-requests-youre-subscribed-to)”。 +6. 选择您要为此对话接收的通知类型，然后单击 **Save（保存）**。 ![Conversation Subscribe options list](/assets/images/help/notifications/subscribe_options.png) You can see a list of all the issues and pull requests you're subscribed to. 更多信息请参阅“[列出您订阅的议题和拉取请求](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/listing-the-issues-and-pull-requests-youre-subscribed-to)”。 ### 订阅团队讨论 diff --git a/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories.md b/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories.md index 6d8c094729b5..24d368664adf 100644 --- a/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories.md +++ b/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories.md @@ -5,16 +5,14 @@ versions: enterprise-server: <2.21 --- -{% if currentVersion ver_gt "enterprise-server@2.17" %} {% data reusables.notifications.auto-watch %} 更多信息请参阅“[关于通知](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/about-notifications)”。 -{% endif %} -You can also watch and unwatch releases in a repository. 更多信息请参阅“[关注和取消关注仓库的发行版](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-releases-for-a-repository)”。 +还可以关注和取消关注仓库中的发行版。 更多信息请参阅“[关注和取消关注仓库的发行版](/enterprise/{{ currentVersion }}/user/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-releases-for-a-repository)”。 ### 关注您有推送权限的所有仓库 {% data reusables.notifications.access_watching %} -2. Click **Watching**. ![关注的仓库列表](/assets/images/help/notifications/notifications-watching-tab.png) +2. 单击 **Watching（关注）**。 ![关注的仓库列表](/assets/images/help/notifications/notifications-watching-tab.png) 3. 在页面右侧，选择 **Automatically watch（自动关注）**。 ![自动配置关注仓库的复选框](/assets/images/help/notifications/ent-automatically-watch-repos.png) ### 关注单个仓库 @@ -25,7 +23,7 @@ You can also watch and unwatch releases in a repository. 更多信息请参阅 ### 取消关注您有推送权限的所有仓库 {% data reusables.notifications.access_watching %} -2. Click **Watching**. ![关注的仓库列表](/assets/images/help/notifications/notifications-watching-tab.png) +2. 单击 **Watching（关注）**。 ![关注的仓库列表](/assets/images/help/notifications/notifications-watching-tab.png) 3. 在页面右侧，取消选择 **Automatically watch（自动关注）**。 ![自动配置关注仓库的复选框](/assets/images/help/notifications/ent-automatically-watch-repos.png) ### 取消关注单个仓库 @@ -35,7 +33,7 @@ You can also watch and unwatch releases in a repository. 更多信息请参阅 {% note %} -**注：**您也可以选择忽略仓库。 如果忽略仓库，将不会收到任何通知。 我们不建议忽略仓库，因为这样您被@提及时将不会收到通知。 {% if currentVersion == "free-pro-team@latest" %}如果您遇到滥用并想要忽略仓库，请[联系支持人员](/contact)以便我们能提供帮助。 {% data reusables.policies.abuse %}{% endif %} +**注：**您也可以选择忽略仓库。 如果忽略仓库，将不会收到任何通知。 我们不建议忽略仓库，因为这样您被@提及时将不会收到通知。 {% if currentVersion == "free-pro-team@latest" %}If you experiencing abuse and want to ignore a repository, please [contact support](/contact) so we can help. {% data reusables.policies.abuse %}{% endif %} {% endnote %} diff --git a/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md b/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md index 47301151cd4b..653ebf1cc5d7 100644 --- a/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md +++ b/translations/zh-CN/content/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-team-discussions.md @@ -21,14 +21,16 @@ versions: {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.notifications %} -{% data reusables.user_settings.automatic_watching_box %} select **Automatically watch teams**. ![自动关注团队的复选框](/assets/images/help/notifications/automatic-team-discussions-watching.png) +{% data reusables.user_settings.automatic_watching_box %} 选择 **Automatically watch teams（自动关注团队）**。 +![自动关注团队的复选框](/assets/images/help/notifications/automatic-team-discussions-watching.png) ### 关注单个团队讨论 {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.specific_team %} -{% data reusables.organizations.watch-team-options %} click **Watch** to open your notifications options. 然后单击 **Watching（关注）**。 ![特定团队下拉菜单中的关注选项](/assets/images/help/notifications/specific-team-watch-options.png) +{% data reusables.organizations.watch-team-options %} 单击 **Watch（关注）**以打开通知选项。 然后单击 **Watching（关注）**。 +![特定团队下拉菜单中的关注选项](/assets/images/help/notifications/specific-team-watch-options.png) ### 取消关注您加入的所有新团队的团队讨论 @@ -36,14 +38,16 @@ versions: {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.notifications %} -{% data reusables.user_settings.automatic_watching_box %} unselect **Automatically watch teams**. ![默认选择的自动关注团队设置](/assets/images/help/notifications/automatic-team-discussions-watching.png) +{% data reusables.user_settings.automatic_watching_box %} 取消选择 **Automatically watch teams（自动关注团队）**。 +![默认选择的自动关注团队设置](/assets/images/help/notifications/automatic-team-discussions-watching.png) ### 取消关注单个团队讨论 {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.specific_team %} -{% data reusables.organizations.watch-team-options %} click **Unwatch** to open your notifications options. 然后单击 **Not watching（不再关注）**。 ![特定团队下拉菜单中的关注选项](/assets/images/help/notifications/specific-team-unwatch.png) +{% data reusables.organizations.watch-team-options %} 单击 **Unwatch（取消关注）**以打开通知选项。 然后单击 **Not watching（不再关注）**。 +![特定团队下拉菜单中的关注选项](/assets/images/help/notifications/specific-team-unwatch.png) {% note %} diff --git a/translations/zh-CN/content/github/searching-for-information-on-github/about-searching-on-github.md b/translations/zh-CN/content/github/searching-for-information-on-github/about-searching-on-github.md index 16c1e7815f8d..de05d23ce74d 100644 --- a/translations/zh-CN/content/github/searching-for-information-on-github/about-searching-on-github.md +++ b/translations/zh-CN/content/github/searching-for-information-on-github/about-searching-on-github.md @@ -1,6 +1,6 @@ --- title: 关于在 GitHub 上搜索 -intro: '使用我们强大的搜索工具在 {% data variables.product.product_name %} 上的多个仓库、用户和代码行中查找所需的内容。' +intro: 'Our integrated search covers the many repositories, users, and lines of code on {% data variables.product.product_name %}.' redirect_from: - /articles/using-the-command-bar/ - /articles/github-search-basics/ @@ -24,6 +24,8 @@ versions: - {% data reusables.search.required_login %} - {% data variables.product.prodname_pages %} 网站在 {% data variables.product.product_name %} 上不可搜索。 但如果源代码内容存在于仓库的默认分支中，您可以使用代码搜索来搜索。 更多信息请参阅“[搜索代码](/articles/searching-code)”。 有关 {% data variables.product.prodname_pages %} 的更多信息，请参阅“[什么是 GitHub Pages？ ](/articles/what-is-github-pages/)” +- Currently our search doesn't support exact matching. +- Whenever you are searching in code files, only the first two results in each file will be returned. {% endnote %} @@ -40,7 +42,7 @@ versions: - [议题和拉取请求](/articles/searching-issues-and-pull-requests) - [代码](/articles/searching-code) - [提交](/articles/searching-commits) -- [用户](/articles/searching-users){% if currentVersion == "free-pro-team@latest" %} +- [Users](/articles/searching-users){% if currentVersion == "free-pro-team@latest" %} - [包](/github/searching-for-information-on-github/searching-for-packages){% endif %} - [Wikis](/articles/searching-wikis) diff --git a/translations/zh-CN/content/github/searching-for-information-on-github/searching-code.md b/translations/zh-CN/content/github/searching-for-information-on-github/searching-code.md index f276caf875ee..b78fa7a5d40c 100644 --- a/translations/zh-CN/content/github/searching-for-information-on-github/searching-code.md +++ b/translations/zh-CN/content/github/searching-for-information-on-github/searching-code.md @@ -101,5 +101,5 @@ versions: ### 延伸阅读 - “[排序搜索结果](/articles/sorting-search-results/)” -- "[在复刻中搜索](/articles/searching-in-forks)"{% if currentVersion == "free-pro-team@latest" %} +- "[Searching in forks](/articles/searching-in-forks)"{% if currentVersion == "free-pro-team@latest" %} - "[在 {% data variables.product.prodname_dotcom %} 上导航代码](/github/managing-files-in-a-repository/navigating-code-on-github)"{% endif %} diff --git a/translations/zh-CN/content/github/searching-for-information-on-github/searching-for-packages.md b/translations/zh-CN/content/github/searching-for-information-on-github/searching-for-packages.md index 696263f6518a..40c60730ab75 100644 --- a/translations/zh-CN/content/github/searching-for-information-on-github/searching-for-packages.md +++ b/translations/zh-CN/content/github/searching-for-information-on-github/searching-for-packages.md @@ -15,7 +15,8 @@ versions: 您可以在所有 {% data variables.product.product_name %} 中全局搜索包，也可以在特定组织内搜索包。 更多信息请参阅“[关于在 {% data variables.product.prodname_dotcom %} 上搜索](/articles/about-searching-on-github)”。 {% if currentVersion != "free-pro-team@latest" %} -要查找特定用户或组织拥有的包，请使用 `user` 或 `org` 限定符。 +You can only search for packages on +{% data variables.product.product_location_enterprise %}, not {% data variables.product.prodname_dotcom_the_website %}, even if {% data variables.product.prodname_github_connect %} is enabled. {% endif %} {% data reusables.search.syntax_tips %} @@ -24,9 +25,9 @@ versions: 要查找特定用户或组织拥有的包，请使用 `user` 或 `org` 限定符。 -| 限定符 | 示例 | -| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | -| user:USERNAME | [**user:codertocat**](https://github.com/search?q=user%3Acodertocat&type=RegistryPackages) 匹配 @codertocat 拥有的包 | +| 限定符 | 示例 | +| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | +| user:USERNAME | [**user:codertocat**](https://github.com/search?q=user%3Acodertocat&type=RegistryPackages) 匹配 @codertocat 拥有的包 | | org:ORGNAME | [**org:github**](https://github.com/search?q=org%3Agithub&type=RegistryPackages) 匹配 {% data variables.product.prodname_dotcom %} 组织拥有的包 | ### 按包可见性过滤 diff --git a/translations/zh-CN/content/github/searching-for-information-on-github/searching-issues-and-pull-requests.md b/translations/zh-CN/content/github/searching-for-information-on-github/searching-issues-and-pull-requests.md index 5af2ab962f92..525dd2af8fad 100644 --- a/translations/zh-CN/content/github/searching-for-information-on-github/searching-issues-and-pull-requests.md +++ b/translations/zh-CN/content/github/searching-for-information-on-github/searching-issues-and-pull-requests.md @@ -13,7 +13,7 @@ versions: {% tip %} -**提示：**{% if currentVersion != "free-pro-team@latest" %} +**Tips:**{% if currentVersion != "free-pro-team@latest" %} - 本文章包含在 {% data variables.product.prodname_dotcom %}.com 网站上的示例搜索，但您可以在 {% data variables.product.product_location_enterprise %} 上使用相同的搜索过滤器。{% endif %} - 有关可以添加到任何搜索限定符以进一步改善结果的搜索语法列表，请参阅“[了解搜索语法](/articles/understanding-the-search-syntax)”。 - 对多个字词的搜索词使用引号。 例如，如果要搜索具有标签 "In progress" 的议题，可搜索 `label:"in progress"`。 搜索不区分大小写。 @@ -229,11 +229,11 @@ versions: ### 搜索草稿拉取请求 您可以过滤草稿拉取请求。 更多信息请参阅“[关于拉取请求](/articles/about-pull-requests#draft-pull-requests)”。 -| 限定符 | 示例 | ------------- | -------------{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} | `draft:true` | [**draft:true**](https://github.com/search?q=draft%3Atrue) 匹配拉取请求草稿。 | `draft:false` | [**draft:false**](https://github.com/search?q=draft%3Afalse) 匹配可供审查的拉取请求。{% else %} | `is:draft` | [**is:draft**](https://github.com/search?q=is%3Adraft) 匹配拉取请求草稿。{% endif %} +| Qualifier | Example | ------------- | -------------{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} | `draft:true` | [**draft:true**](https://github.com/search?q=draft%3Atrue) matches draft pull requests. | `draft:false` | [**draft:false**](https://github.com/search?q=draft%3Afalse) 匹配可供审查的拉取请求。{% else %} | `is:draft` | [**is:draft**](https://github.com/search?q=is%3Adraft) 匹配拉取请求草稿。{% endif %} ### 按拉取请求审查状态和审查者搜索 -You can filter pull requests based on their [review status](/articles/about-pull-request-reviews) (_none_, _required_, _approved_, or _changes requested_), by reviewer, and by requested reviewer. +您可以基于拉取请求的[审查状态](/articles/about-pull-request-reviews)（_无_、_必需_、_批准_或_请求更改_）、按审查者和请求的审查者过滤拉取请求。 | 限定符 | 示例 | | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -253,10 +253,10 @@ You can filter pull requests based on their [review status](/articles/about-pull {% data reusables.search.date_gt_lt %} -| 限定符 | 示例 | -| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| created:YYYY-MM-DD | [**language:c# created:<2011-01-01 state:open**](https://github.com/search?q=language%3Ac%23+created%3A%3C2011-01-01+state%3Aopen&type=Issues) matches open issues that were created before 2011 in repositories written in C#. | -| updated:YYYY-MM-DD | [**weird in:body updated:>=2013-02-01**](https://github.com/search?q=weird+in%3Abody+updated%3A%3E%3D2013-02-01&type=Issues) matches issues with the word "weird" in the body that were updated after February 2013. | +| 限定符 | 示例 | +| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| created:YYYY-MM-DD | [**language:c# created:<2011-01-01 state:open**](https://github.com/search?q=language%3Ac%23+created%3A%3C2011-01-01+state%3Aopen&type=Issues) 匹配以 C# 编写的仓库中 2011 年以前创建的开放议题。 | +| updated:YYYY-MM-DD | [**weird in:body updated:>=2013-02-01**](https://github.com/search?q=weird+in%3Abody+updated%3A%3E%3D2013-02-01&type=Issues) 匹配 2013 年 2 月后更新的、正文中含有 "weird" 字样的议题。 | ### 按议题或拉取请求关闭的时间搜索 @@ -266,10 +266,10 @@ You can filter pull requests based on their [review status](/articles/about-pull {% data reusables.search.date_gt_lt %} -| 限定符 | 示例 | -| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| closed:YYYY-MM-DD | [**language:swift closed:>2014-06-11**](https://github.com/search?q=language%3Aswift+closed%3A%3E2014-06-11&type=Issues) matches issues and pull requests in Swift that were closed after June 11, 2014. | -| | [**data in:body closed:<2012-10-01**](https://github.com/search?utf8=%E2%9C%93&q=data+in%3Abody+closed%3A%3C2012-10-01+&type=Issues) matches issues and pull requests with the word "data" in the body that were closed before October 2012. | +| 限定符 | 示例 | +| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| closed:YYYY-MM-DD | [**language:swift closed:>2014-06-11**](https://github.com/search?q=language%3Aswift+closed%3A%3E2014-06-11&type=Issues) 匹配 2014 年 6 月 11 日后关闭的 Swift 中的议题和拉取请求。 | +| | [**data in:body closed:<2012-10-01**](https://github.com/search?utf8=%E2%9C%93&q=data+in%3Abody+closed%3A%3C2012-10-01+&type=Issues) 匹配 2012 年 10 月后关闭、正文中含有 "data" 字样的议题和拉取请求。 | ### 按拉取请求合并的时间搜索 @@ -279,10 +279,10 @@ You can filter pull requests based on their [review status](/articles/about-pull {% data reusables.search.date_gt_lt %} -| 限定符 | 示例 | -| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| merged:YYYY-MM-DD | [**language:javascript merged:<2011-01-01**](https://github.com/search?q=language%3Ajavascript+merged%3A%3C2011-01-01+&type=Issues) matches pull requests in JavaScript repositories that were merged before 2011. | -| | [**fast in:title language:ruby merged:>=2014-05-01**](https://github.com/search?q=fast+in%3Atitle+language%3Aruby+merged%3A%3E%3D2014-05-01+&type=Issues) matches pull requests in Ruby with the word "fast" in the title that were merged after May 2014. | +| 限定符 | 示例 | +| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| merged:YYYY-MM-DD | [**language:javascript merged:<2011-01-01**](https://github.com/search?q=language%3Ajavascript+merged%3A%3C2011-01-01+&type=Issues) 匹配 2011 年以前合并的 JavaScript 仓库中的拉取请求。 | +| | [**fast in:title language:ruby merged:>=2014-05-01**](https://github.com/search?q=fast+in%3Atitle+language%3Aruby+merged%3A%3E%3D2014-05-01+&type=Issues) 匹配 2014 年 5 月之后合并、标题中含有 "fast" 字样、以 Ruby 编写的拉取请求。 | ### 基于拉取请求是否已合并搜索 diff --git a/translations/zh-CN/content/github/searching-for-information-on-github/sorting-search-results.md b/translations/zh-CN/content/github/searching-for-information-on-github/sorting-search-results.md index 625776cf790e..97c4f291475b 100644 --- a/translations/zh-CN/content/github/searching-for-information-on-github/sorting-search-results.md +++ b/translations/zh-CN/content/github/searching-for-information-on-github/sorting-search-results.md @@ -18,8 +18,8 @@ versions: `sort:interactions` 限定符按最高反应和评论总数排序。 -| 限定符 | 示例 | -| ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 限定符 | 示例 | +| ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sort:interactions` 或 `sort:interactions-desc` | [**org:github sort:interactions**](https://github.com/search?q=org%3Agithub+sort%3Ainteractions&type=Issues) 匹配 {% data variables.product.product_name %} 所拥有仓库中的议题，按最高反应和评论总数排序。 | | `sort:interactions-asc` | [**org:github sort:interactions-asc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Ainteractions-asc&type=Issues) 匹配 {% data variables.product.product_name %} 所拥有仓库中的议题，按最低反应和评论总数排序。 | @@ -27,8 +27,8 @@ versions: `sort:reactions` 限定符按反应数量或类型排序。 -| 限定符 | 示例 | -| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 限定符 | 示例 | +| ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sort:reactions` 或 `sort:reactions-desc` | [**org:github sort:reactions**](https://github.com/search?q=org%3Agithub+sort%3Areactions&type=Issues) 匹配 {% data variables.product.product_name %} 所拥有仓库中的议题，按最高反应数量排序。 | | `sort:reactions-asc` | [**org:github sort:reactions-asc**](https://github.com/search?q=org%3Agithub+sort%3Areactions-asc&type=Issues) 匹配 {% data variables.product.product_name %} 所拥有仓库中的议题，按反应数量升序排序（最少到最多）。 | | sort:reactions-reaction | [**org:github sort:reactions-+1**](https://github.com/search?q=org%3Agithub+sort%3Areactions-%2B1&type=Issues) 匹配 {% data variables.product.product_name %} 所拥有仓库中的议题，按最多赞成 (:+1:) 反应数排序。 | @@ -41,8 +41,8 @@ versions: `sort:author-date` 限定符按作者日期降序或升序排序。 -| 限定符 | 示例 | -| -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 限定符 | 示例 | +| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sort:author-date` 或 `sort:author-date-desc` | [**feature org:github sort:author-date**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Aauthor-date&type=Commits) 匹配 {% data variables.product.product_name %} 所拥有仓库中含有 "feature" 字样的提交，按作者日期降序排序。 | | `sort:author-date-asc` | [**feature org:github sort:author-date-asc**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Aauthor-date-asc&type=Commits) 匹配 {% data variables.product.product_name %} 所拥有仓库中含有 "feature" 字样的提交，按作者日期升序排序。 | @@ -50,8 +50,8 @@ versions: `sort:committer-date` 限定符按提交者日期降序或升序排序。 -| 限定符 | 示例 | -| -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 限定符 | 示例 | +| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `sort:committer-date` 或 `sort:committer-date-desc` | [**feature org:github sort:committer-date**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Acommitter-date&type=Commits) 匹配 {% data variables.product.product_name %} 所拥有仓库中含有 "feature" 字样的提交，按提交者日期降序排序。 | | `sort:committer-date-asc` | [**feature org:github sort:committer-date-asc**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Acommitter-date-asc&type=Commits) 匹配 {% data variables.product.product_name %} 所拥有仓库中含有 "feature" 字样的提交，按提交者日期升序排序。 | diff --git a/translations/zh-CN/content/github/searching-for-information-on-github/understanding-the-search-syntax.md b/translations/zh-CN/content/github/searching-for-information-on-github/understanding-the-search-syntax.md index 1102d66cec95..87903903bcf4 100644 --- a/translations/zh-CN/content/github/searching-for-information-on-github/understanding-the-search-syntax.md +++ b/translations/zh-CN/content/github/searching-for-information-on-github/understanding-the-search-syntax.md @@ -51,10 +51,10 @@ versions: {% data reusables.time_date.time_format %} -| 查询 | 示例 | -| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| YYYY-MM-DDTHH:MM:SS+00:00 | **[cats created:2017-01-01T01:00:00+07:00..2017-03-01T15:30:15+07:00](https://github.com/search?utf8=%E2%9C%93&q=cats+created%3A2017-01-01T01%3A00%3A00%2B07%3A00..2017-03-01T15%3A30%3A15%2B07%3A00&type=Issues)** 匹配在 2017 年 1 月 1 日凌晨 1 点（UTC 偏移为 `07:00`）与 2017 年 3 月 1 日下午 3 点（UTC 偏移为 `07:00`）之间创建的议题。 with a UTC offset of `07:00` and March 1, 2017 at 3 p.m. with a UTC offset of `07:00`. | -| YYYY-MM-DDTHH:MM:SSZ | **[cats created:2016-03-21T14:11:00Z..2016-04-07T20:45:00Z](https://github.com/search?utf8=%E2%9C%93&q=cats+created%3A2016-03-21T14%3A11%3A00Z..2016-04-07T20%3A45%3A00Z&type=Issues)** 匹配在 2016 年 3 月 21 日下午 2:11 与 2016 年 4 月 7 日晚上 8:45 之间创建的议题。 | +| 查询 | 示例 | +| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| YYYY-MM-DDTHH:MM:SS+00:00 | **[cats created:2017-01-01T01:00:00+07:00..2017-03-01T15:30:15+07:00](https://github.com/search?utf8=%E2%9C%93&q=cats+created%3A2017-01-01T01%3A00%3A00%2B07%3A00..2017-03-01T15%3A30%3A15%2B07%3A00&type=Issues)** 匹配在 2017 年 1 月 1 日凌晨 1 点（UTC 偏移为 `07:00`）与 2017 年 3 月 1 日下午 3 点（UTC 偏移为 `07:00`）之间创建的议题。 UTC 偏移量 `07:00`，2017 年 3 月 1 日下午 3 点。 UTC 偏移量 `07:00`。 | +| YYYY-MM-DDTHH:MM:SSZ | **[cats created:2016-03-21T14:11:00Z..2016-04-07T20:45:00Z](https://github.com/search?utf8=%E2%9C%93&q=cats+created%3A2016-03-21T14%3A11%3A00Z..2016-04-07T20%3A45%3A00Z&type=Issues)** 匹配在 2016 年 3 月 21 日下午 2:11 与 2016 年 4 月 7 日晚上 8:45 之间创建的议题。 | ### 排除特定结果 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md index 5aaacbf138cd..3356c3b42d75 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions.md @@ -12,15 +12,15 @@ versions: 分钟数每月都会重置，而存储使用量不重置。 -| 产品 | 存储器 | 分钟数（每月） | -| ---------------------------------------------------------- | ------ | ------- | +| 产品 | 存储器 | 分钟数（每月） | +| ----------------------------------------------------- | ------ | ------- | | {% data variables.product.prodname_free_user %} | 500 MB | 2,000 | | {% data variables.product.prodname_pro %} | 1 GB | 3,000 | | 组织的 {% data variables.product.prodname_free_team %} | 500 MB | 2,000 | | {% data variables.product.prodname_team %} | 2 GB | 3,000 | | {% data variables.product.prodname_ghe_cloud %} | 50 GB | 50,000 | -Jobs that run on Windows and macOS runners that {% data variables.product.prodname_dotcom %} hosts consume minutes at 2 and 10 times the rate that jobs on Linux runners consume. For example, using 1,000 Windows minutes would consume 2,000 of the minutes included in your account. Using 1,000 macOS minutes, would consume 10,000 minutes included in your account. +在 {% data variables.product.prodname_dotcom %} 主机的 Windows 和 macOS 运行器上运行的作业，其消耗分钟数是在 Linux 运行器上运行的作业的 2 倍和 10 倍。 例如，使用 1,000 Windows 分钟将消耗帐户中包含的 2,000 分钟。 使用 1,000 macOS 分钟，将消耗帐户中包含的 10,000 分钟。 | 操作系统 | 分钟乘数 | | ------- | ---- | @@ -28,13 +28,13 @@ Jobs that run on Windows and macOS runners that {% data variables.product.prodna | macOS | 10 | | Windows | 2 | -The storage used by a repository is the total storage used by {% data variables.product.prodname_actions %} artifacts and {% data variables.product.prodname_registry %}. Your storage cost is the total usage for all repositories owned by your account. For more information about pricing for {% data variables.product.prodname_registry %}, see "[About billing for {% data variables.product.prodname_registry %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)." +仓库使用的存储空间是 {% data variables.product.prodname_actions %} 构件和 {% data variables.product.prodname_registry %} 使用的存储空间总计。 您的存储成本是您帐户拥有的所有帐户的总使用量。 有关 {% data variables.product.prodname_registry %} 定价的更多信息，请参阅“[关于 {% data variables.product.prodname_registry %} 的计费](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)”。 - If your account's usage surpasses these limits and you have set a spending limit above $0, you will pay $0.25 USD per GB of storage per month and per-minute usage depending on the operating system used by the {% data variables.product.prodname_dotcom %}-hosted runner. {% data variables.product.prodname_dotcom %} rounds the minutes each job uses up to the nearest minute. + 如果您的帐户使用量超出了这些限额，并且您设置的支出限额高于 0 美元，则每月的每 GB 存储用量和每分钟用量需要支付 0.25 美元，具体取决于 {% data variables.product.prodname_dotcom %} 托管运行器使用的操作系统。 {% data variables.product.prodname_dotcom %} 将每个作业使用的分钟数舍入到最接近的分钟整数。 {% note %} -**Note:** Minute multipliers do not apply to the per-minute rates shown below. +**注：**分钟倍数不适用于以下所示的每分钟费率。 {% endnote %} @@ -44,11 +44,11 @@ The storage used by a repository is the total storage used by {% data variables. | macOS | $0.08 | | Windows | $0.016 | -The number of jobs you can run concurrently across all repositories in your user or organization account depends on your GitHub plan. 更多信息请参阅“[关于 {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/about-github-actions/#usage-limits)”。 +可在用户或组织帐户的所有仓库中同时运行的作业数量取决于您的 GitHub 计划。 更多信息请参阅“[使用限制和计费](/actions/reference/usage-limits-billing-and-administration)”（对于 {% data variables.product.prodname_dotcom %} 托管的运行器）和“[关于自托管运行器](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)”（对于自托管运行器使用限制）。 ### 计算分钟和存储支出 -At the end of the month, {% data variables.product.prodname_dotcom %} calculates the cost of minutes and storage used over the amount included in your account. For example, if your organization uses {% data variables.product.prodname_team %} and allows unlimited spending, using 15,000 minutes could have a total storage and minute overage cost of $56, depending on the operating systems used to run jobs. +在月末，{% data variables.product.prodname_dotcom %} 会计算您使用的超过帐户自带限额的分钟数和存储空间费用。 例如，如果您的组织使用 {% data variables.product.prodname_team %} 并允许无限制支出，则使用 15,000 分钟可能会产生 56 美元的总存储空间和分钟数超额费用，具体取决于用于运行作业的操作系统。 - 5,000（3,000 Linux 加 2,000 Windows）分钟 = $56 ($24 + $32)。 - 3,000 Linux 分钟（每分钟 $0.008）= $24。 @@ -69,7 +69,7 @@ At the end of the month, {% data variables.product.prodname_dotcom %} calculates ### 关于支出限制 -默认情况下，您的帐户对 {% data variables.product.prodname_actions %} 使用的支出限额为 0 美元。 To enable using minutes and storage for private repositories beyond the amounts included with your account, you can increase the spending limit or allow unlimited spending. 更多信息请参阅“[管理 {% data variables.product.prodname_actions %} 的支出限制](/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions)”。 +默认情况下，您的帐户对 {% data variables.product.prodname_actions %} 使用的支出限额为 0 美元。 要为私有仓库启用超过帐户自带量使用分钟数和存储空间，您可以增加支出限额或允许无限制支出。 更多信息请参阅“[管理 {% data variables.product.prodname_actions %} 的支出限制](/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions)”。 {% data reusables.github-actions.spending-limit-enterprise-account %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md index 0cec58bfdf8a..3272ffef6e25 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages.md @@ -14,8 +14,8 @@ versions: 数据传输每月都会重置，而存储使用量不重置。 -| 产品 | 存储器 | 数据传输（每月） | -| ---------------------------------------------------------- | ----- | -------- | +| 产品 | 存储器 | 数据传输（每月） | +| ----------------------------------------------------- | ----- | -------- | | {% data variables.product.prodname_free_user %} | 500MB | 1GB | | {% data variables.product.prodname_pro %} | 2GB | 10GB | | 组织的 {% data variables.product.prodname_free_team %} | 500MB | 1GB | @@ -27,7 +27,7 @@ versions: | | 托管 | 自托管 | | -------------------- | -- | --- | | 使用 `GITHUB_TOKEN` 访问 | 免费 | 免费 | -| 使用个人访问令牌访问 | 免费 | $ | +| 使用个人访问令牌访问 | 免费 | 美元 | 存储使用情况与 {% data variables.product.prodname_actions %} 为您的帐户所拥有的仓库产生的构件共享。 更多信息请参阅“[关于 {% data variables.product.prodname_actions %} 的计费](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions)”。 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/about-organizations-for-procurement-companies.md b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/about-organizations-for-procurement-companies.md index 65d7e736c09b..8e32d0ef240b 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/about-organizations-for-procurement-companies.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/about-organizations-for-procurement-companies.md @@ -1,6 +1,6 @@ --- title: 关于采购公司的组织 -intro: 企业使用组织与多个所有者和管理员协作处理共享的项目。 您可以为客户创建组织，代他们付款，然后将组织的所有权转给客户。 +intro: '企业使用组织与多个所有者和管理员协作处理共享的项目。 您可以为客户创建组织，代他们付款，然后将组织的所有权转给客户。' redirect_from: - /articles/about-organizations-for-resellers/ - /articles/about-organizations-for-procurement-companies diff --git a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/about-per-user-pricing.md b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/about-per-user-pricing.md index 46999749bca9..db2c6f544355 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/about-per-user-pricing.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/about-per-user-pricing.md @@ -1,6 +1,6 @@ --- title: 关于每用户定价 -intro: 通过每用户定价，组织根据团队规模付款，以访问团队高级协作和管理工具，并选择性访问安全、合规和部署控件。 +intro: '通过每用户定价，组织根据团队规模付款，以访问团队高级协作和管理工具，并选择性访问安全、合规和部署控件。' redirect_from: - /articles/about-per-user-pricing versions: diff --git a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/discounted-subscriptions-for-github-accounts.md b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/discounted-subscriptions-for-github-accounts.md index 4933b42cf47c..1235ca02f76f 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/discounted-subscriptions-for-github-accounts.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/discounted-subscriptions-for-github-accounts.md @@ -22,7 +22,7 @@ versions: ### 学校和大学折扣 -经验证的教师可出于教学和学术研究目的申请 {% data variables.product.prodname_team %}。 经验证的教师可出于教学和学术研究目的申请 {% data variables.product.prodname_team %}。 更多信息请参阅“[在课堂和研究中使用 {% data variables.product.prodname_dotcom %}](/articles/using-github-in-your-classroom-and-research)”。 更多信息请访问 [{% data variables.product.prodname_education %}](https://education.github.com/)。 +经验证的教师可出于教学和学术研究目的申请 {% data variables.product.prodname_team %}。 经验证的教师可出于教学和学术研究目的申请 {% data variables.product.prodname_team %}。 更多信息请参阅“[在课堂和研究中使用 {{ site.data.variables.product.prodname_dotcom }}](/articles/using-github-in-your-classroom-and-research)”。 更多信息请访问 [{% data variables.product.prodname_education %}](https://education.github.com/)。 ### 非赢利组织和图书馆折扣 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-your-github-subscription.md b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-your-github-subscription.md index 366f322f5681..128ac34e705e 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-your-github-subscription.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-your-github-subscription.md @@ -30,8 +30,8 @@ versions: {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.billing %} {% data reusables.user_settings.subscriptions-tab %} -4. Use the **Edit** drop-down and click **Downgrade to Free**. ![Downgrade to free button](/assets/images/help/billing/downgrade-to-free.png) -5. Read the information about the features your user account will no longer have access to on your next billing date, then click **I understand. Continue with downgrade**. ![继续降级按钮](/assets/images/help/billing/continue-with-downgrade.png) +4. 使用 **Edit（编辑）**下拉菜单并单击 **Downgrade to Free（降级到免费 ）**。 ![降级到免费按钮](/assets/images/help/billing/downgrade-to-free.png) +5. 阅读有关信息，了解您的用户帐户在下一个结算日期将不再拥有访问权限的功能，然后单击 **I understand. Continue with downgrade（我明白。继续降级）**。 ![继续降级按钮](/assets/images/help/billing/continue-with-downgrade.png) 如果您在私有仓库中发布了 {% data variables.product.prodname_pages %} 站点，并添加了自定义域，在从 {% data variables.product.prodname_pro %} 降级至 {% data variables.product.prodname_free_user %} 前，请删除或更新您的 DNS 记录，以避免域接管的风险。 更多信息请参阅“[管理 {% data variables.product.prodname_pages %} 网站的自定义域](/articles/managing-a-custom-domain-for-your-github-pages-site)。 @@ -61,9 +61,9 @@ versions: {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.billing %} -5. Under "Subscriptions", select the "Edit" drop-down, and click **Edit plan**. ![Edit Plan dropdown](/assets/images/help/billing/edit-plan-dropdown.png) +5. 在“Subscriptions（订阅）”下，选择“Edit（编辑）”下拉菜单，然后单击 **Edit plan（编辑计划）**。 ![编辑计划下拉菜单](/assets/images/help/billing/edit-plan-dropdown.png) 1. 在“Billing/Plans（计费/计划）”下您要更改的计划旁边，单击 **Downgrade（降级）**。 ![降级按钮](/assets/images/help/billing/downgrade-plan-option-button.png) -1. Enter the reason you're downgrading your account, then click **Downgrade plan**. ![Text box for downgrade reason and downgrade button](/assets/images/help/billing/downgrade-plan-button.png) +1. 输入要降级帐户的原因，然后单击 **Downgrade plan（降级计划）**。 ![降级原因文本框和降级按钮](/assets/images/help/billing/downgrade-plan-button.png) ### 从组织删除付费席位 @@ -77,9 +77,9 @@ versions: {% data reusables.organizations.org_settings %} {% data reusables.organizations.billing %} {% data reusables.user_settings.subscriptions-tab %} -6. Use the **Edit** drop-down and click **Remove seats**. ![remove seats dropdown](/assets/images/help/billing/remove-seats-dropdown.png) -1. 在“Remove seats”（删除席位）下，选择要降级的席位数。 ![remove seats option](/assets/images/help/billing/remove-seats-amount.png) -1. 审查有关在下一个结算日期执行新付款方式的信息，然后单击 **Remove seats（删除席位）**。 ![remove seats button](/assets/images/help/billing/remove-seats-button.png) +6. 使用 **Edit（编辑）**下拉菜单并单击 **Remove seats（删除席位）**。 ![删除席位下拉菜单](/assets/images/help/billing/remove-seats-dropdown.png) +1. 在“Remove seats”（删除席位）下，选择要降级的席位数。 ![删除席位选项](/assets/images/help/billing/remove-seats-amount.png) +1. 审查有关在下一个结算日期执行新付款方式的信息，然后单击 **Remove seats（删除席位）**。 ![删除席位按钮](/assets/images/help/billing/remove-seats-button.png) ### 延伸阅读 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/how-does-upgrading-or-downgrading-affect-the-billing-process.md b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/how-does-upgrading-or-downgrading-affect-the-billing-process.md index 5184ade529bc..c3f05d51dc10 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/how-does-upgrading-or-downgrading-affect-the-billing-process.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/how-does-upgrading-or-downgrading-affect-the-billing-process.md @@ -1,6 +1,6 @@ --- title: 升级或降级对结算过程有何影响？ -intro: 升级个人帐户或组织的订阅时，更改会立即应用。 降级订阅时，更改会在当前结算周期结束时应用。 +intro: '升级个人帐户或组织的订阅时，更改会立即应用。 降级订阅时，更改会在当前结算周期结束时应用。' redirect_from: - /articles/how-does-upgrading-or-downgrading-affect-the-billing-process versions: diff --git a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-github-billing-settings.md b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-github-billing-settings.md index 3c80cb371186..57137f4fd844 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-github-billing-settings.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-github-billing-settings.md @@ -1,6 +1,6 @@ --- title: 管理 GitHub 计费设置 -intro: 帐户的计费设置应用于您添加到帐户的每项付费功能或产品。 您可以管理支付方式、结算周期和帐音邮箱等设置。 您也可以查看帐单信息，如订阅、帐单日期、付款记录和以前的收据。 +intro: '帐户的计费设置应用于您添加到帐户的每项付费功能或产品。 您可以管理支付方式、结算周期和帐音邮箱等设置。 您也可以查看帐单信息，如订阅、帐单日期、付款记录和以前的收据。' redirect_from: - /articles/viewing-and-managing-your-personal-account-s-billing-information/ - /articles/paying-for-user-accounts/ diff --git a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md index 43107b7ac47e..8010fa334daf 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions.md @@ -10,7 +10,7 @@ versions: {% data reusables.github-actions.actions-billing %} {% data reusables.github-actions.actions-spending-limit %} -您可以设置更高的支出限额，或者对某些帐户允许无限制的支出。 如果您按发票为组织或企业帐户付款，可以预付超额费用以设置更高的支出限额。 The spending limit applies to your combined overages for {% data variables.product.prodname_actions %} and {% data variables.product.prodname_registry %}. For more information about pricing for {% data variables.product.prodname_actions %} usage, see "[About billing for {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions)." +您可以设置更高的支出限额，或者对某些帐户允许无限制的支出。 如果您按发票为组织或企业帐户付款，可以预付超额费用以设置更高的支出限额。 支出限额适用于 {% data variables.product.prodname_actions %} 和 {% data variables.product.prodname_registry %} 的总超支额。 有关 {% data variables.product.prodname_actions %} 使用价格的更多信息，请参阅“[关于 {% data variables.product.prodname_actions %} 的计费](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions)”。 只要您将支出限额设定在 0 美元以上，您就要对过去发生的任何超额情况负责。 例如，如果您的组织使用 {% data variables.product.prodname_team %}，不允许超额，并且创建将当月存储使用量从 1.9GB 增加到 2.1GB 的工作流程工件，那么您使用的存储空间将比产品包含的 2GB 稍高。 @@ -42,13 +42,15 @@ versions: ### 管理企业帐户的 {% data variables.product.prodname_actions %} 支出限额 -Enterprise owners and billing managers can manage the spending limit for {% data variables.product.prodname_actions %} for an enterprise account. +企业所有者和帐单管理员可管理企业帐户的 {% data variables.product.prodname_actions %} 支出限额。 {% data reusables.github-actions.spending-limit-enterprise-account %} {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %} -1. 在“{% data variables.product.prodname_actions %} and Packages monthly usage（GitHub 操作和包每月使用）”下，单击 **Cost management（成本管理）**。 ![成本管理选项卡](/assets/images/help/settings/cost-management-tab-enterprise.png) +1. 在“ +{% data variables.product.prodname_actions %} and Packages monthly usage", click **Cost management**. + ![成本管理选项卡](/assets/images/help/settings/cost-management-tab-enterprise.png) {% data reusables.dotcom_billing.monthly-spending-limit %} {% data reusables.dotcom_billing.update-spending-limit %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md index 397a0a3f59c8..3ef5ed1362b3 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages.md @@ -10,7 +10,7 @@ versions: {% data reusables.package_registry.packages-billing %} -您可以设置更高的支出限额，或者对某些帐户允许无限制的支出。 如果您按发票为组织或企业帐户付款，可以预付超额费用以设置更高的支出限额。 The spending limit applies to your combined overages for {% data variables.product.prodname_registry %} and {% data variables.product.prodname_actions %}. For more information about pricing for {% data variables.product.prodname_registry %} usage, see "[About billing for {% data variables.product.prodname_registry %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)." +您可以设置更高的支出限额，或者对某些帐户允许无限制的支出。 如果您按发票为组织或企业帐户付款，可以预付超额费用以设置更高的支出限额。 支出限额适用于 {% data variables.product.prodname_registry %} 和 {% data variables.product.prodname_actions %} 的总超支额。 有关 {% data variables.product.prodname_registry %} 使用价格的更多信息，请参阅“[关于 {% data variables.product.prodname_registry %} 的计费](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)”。 只要您将支出限额设定在 0 美元以上，您就要对过去发生的任何超额情况负责。 例如，如果您的组织使用 {% data variables.product.prodname_team %}，不允许超额，并且发布新版私有包，将当月存储使用量从 1.9GB 增加到 2.1GB，那么发布该版本使用的存储空间将比产品包含的 2GB 稍高。 @@ -42,13 +42,15 @@ versions: ### 管理企业帐户的 {% data variables.product.prodname_registry %} 支出限额 -Enterprise owners and billing managers can manage the spending limit for {% data variables.product.prodname_registry %} for an enterprise account. +企业所有者和帐单管理员可管理企业帐户的 {% data variables.product.prodname_registry %} 支出限额。 {% data reusables.package_registry.spending-limit-enterprise-account %} {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %} -1. 在“{% data variables.product.prodname_actions %} and Packages monthly usage（GitHub 操作和包每月使用）”下，单击 **Cost management（成本管理）**。 ![成本管理选项卡](/assets/images/help/settings/cost-management-tab-enterprise.png) +1. 在“ +{% data variables.product.prodname_actions %} and Packages monthly usage", click **Cost management**. + ![成本管理选项卡](/assets/images/help/settings/cost-management-tab-enterprise.png) {% data reusables.dotcom_billing.monthly-spending-limit %} {% data reusables.dotcom_billing.update-spending-limit %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/renewing-your-clients-paid-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/renewing-your-clients-paid-organization.md index c73ba0212b35..bcef38e405fd 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/renewing-your-clients-paid-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/renewing-your-clients-paid-organization.md @@ -1,6 +1,6 @@ --- title: 续订客户的付费组织 -intro: 如果您客户的组织有存档的有效付款方式，则其年度订阅将自动续订。 帐单管理员可以查看和更新组织的付款方式和订阅。 +intro: '如果您客户的组织有存档的有效付款方式，则其年度订阅将自动续订。 帐单管理员可以查看和更新组织的付款方式和订阅。' redirect_from: - /articles/renewing-your-client-s-paid-organization - /articles/renewing-your-clients-paid-organization diff --git a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/setting-your-billing-email.md b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/setting-your-billing-email.md index 093594df67fb..499b5ef927b5 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/setting-your-billing-email.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/setting-your-billing-email.md @@ -31,34 +31,34 @@ versions: 4. 在 **Billing email（帐单邮箱）**下，输入有效的电子邮件地址。 该邮箱不需要是组织帐户唯一的邮箱。 ![帐单邮箱文本框](/assets/images/help/settings/org-billing-email.png) 5. 要确认您的更改，请单击 **Update profile（更新个人资料）**。 ![更新个人资料按钮](/assets/images/help/settings/update-profile-button.png) -### Managing additional recipients for your organization's billing email +### 管理组织帐单邮箱的其他收件人 -If you have users that want to receive billing reports, you can add their email addresses as billing email recipients. This feature is only available to organizations that are not managed by an enterprise. +如果您有用户希望接收帐单报告，您可以将他们的电子邮件地址添加为帐单邮箱收件人。 此功能仅适用于非企业管理的组织。 -#### Adding a recipient for billing notifications +#### 添加帐单通知的收件人 {% data reusables.organizations.navigate-to-org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.billing %} -1. Under "Billing management", to the right of "Email recipients", click **Add**. ![Add recipient](/assets/images/help/billing/billing-add-email-recipient.png) -1. Type the email address of the recipient, then click **Add**. ![Add recipient modal](/assets/images/help/billing/billing-add-email-recipient-modal.png) +1. 在“Billing management（帐单管理）”下，在“Email recipients（电子邮件收件人）”的右侧，单击 **Add（添加）**。 ![添加收件人](/assets/images/help/billing/billing-add-email-recipient.png) +1. 输入收件人的电子邮件地址，然后单击 **Add（添加）**。 ![添加收件人模式](/assets/images/help/billing/billing-add-email-recipient-modal.png) -#### Changing the primary recipient for billing notifications +#### 更改帐单通知的主要收件人 -One address must always be designated as the primary recipient. The address with this designation can't be removed until a new primary recipient is selected. +必须始终将一个地址指定为主要收件人。 在选择新的主要收件人之前，无法删除带有此指定地址。 {% data reusables.organizations.navigate-to-org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.billing %} -1. Under "Billing management", find the email address you want to set as the primary recipient. -1. To the right of the email address, use the "Edit" drop-down menu, and click **Mark as primary**. ![Mark primary recipient](/assets/images/help/billing/billing-change-primary-email-recipient.png) +1. 在“Billing management（帐单管理）”下，找到要设置为主要收件人的电子邮件地址。 +1. 在电子邮件地址的右侧，使用“Edit（编辑）”下拉菜单，然后单击 **Mark as primary（标记为主要收件人）**。 ![标记主要收件人](/assets/images/help/billing/billing-change-primary-email-recipient.png) -#### Removing a recipient from billing notifications +#### 从帐单通知中删除收件人 {% data reusables.organizations.navigate-to-org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.billing %} -1. Under "Email recipients", find the email address you want to remove. -1. For the user's entry in the list, click **Edit**. ![Edit recipient](/assets/images/help/billing/billing-edit-email-recipient.png) -1. To the right of the email address, use the "Edit" drop-down menu, and click *Remove**. ![Remove recipient](/assets/images/help/billing/billing-remove-email-recipient.png) -1. Review the confirmation prompt, then click **Remove**. +1. 在“Email recipients（电子邮件收件人）”下，找到要删除的电子邮件地址。 +1. 针对列表中的用户条目，单击 **Edit（编辑）**。 ![编辑收件人](/assets/images/help/billing/billing-edit-email-recipient.png) +1. 在电子邮件地址的右侧，使用“Edit（编辑）”下拉菜单，然后单击 *Remove（删除）**。 ![删除收件人](/assets/images/help/billing/billing-remove-email-recipient.png) +1. 查看确认提示，然后单击 **Remove（删除）**。 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-or-downgrading-your-clients-paid-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-or-downgrading-your-clients-paid-organization.md index db02d543b115..a729c6b65b20 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-or-downgrading-your-clients-paid-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-or-downgrading-your-clients-paid-organization.md @@ -12,7 +12,7 @@ versions: {% tip %} -**Tips**: +**提示**： - 升级客户的组织之前，您可以[查看或更新组织存档的付款方式](/articles/adding-or-editing-a-payment-method)。 - 这些说明适用于升级或降级*按席位订阅*的组织。 如果您的客户使用*旧的按仓库*方案支付 {% data variables.product.product_name %}，您可以升级或[降级](/articles/downgrading-your-github-subscription)其旧方案，或[将其组织切换为按席位定价](/articles/upgrading-your-github-subscription)。 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md index 0d8b5126fbad..734644bf11f7 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription.md @@ -28,7 +28,9 @@ versions: {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.billing %} {% data reusables.user_settings.subscriptions-tab %} -4. 在“{% data variables.product.prodname_free_user %}”旁边，单击 **Upgrade（升级）**。 ![升级按钮](/assets/images/help/billing/settings_billing_user_upgrade.png) +4. Next to " +{% data variables.product.prodname_free_user %}", click **Upgrade**. + ![升级按钮](/assets/images/help/billing/settings_billing_user_upgrade.png) {% data reusables.dotcom_billing.choose-monthly-or-yearly-billing %} {% data reusables.dotcom_billing.show-plan-details %} {% data reusables.dotcom_billing.enter-payment-info %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md index 30aa930b3d02..ceaad001941e 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage.md @@ -6,7 +6,7 @@ versions: free-pro-team: '*' --- -还可以查看单个工作流程运行的计费作业执行分钟数。 更多信息请参阅“[管理工作流程运行](/actions/configuring-and-managing-workflows/managing-a-workflow-run#viewing-billable-job-execution-minutes)”。 +还可以查看单个工作流程运行的计费作业执行分钟数。 For more information, see "[Viewing job execution time](/actions/managing-workflow-runs/viewing-job-execution-time)." ### 查看用户帐户的 {% data variables.product.prodname_actions %} 使用情况 @@ -20,7 +20,7 @@ versions: ### 查看组织的 {% data variables.product.prodname_actions %} 使用情况 -Organization owners and billing managers can view {% data variables.product.prodname_actions %} usage for an organization. For organizations managed by an enterprise account, only the organization owners can view {% data variables.product.prodname_actions %} usage in the organization billing page. +组织所有者和帐单管理员可查看组织的 {% data variables.product.prodname_actions %} 使用情况。 对于由企业帐户管理的组织，只有组织所有者可以在组织的帐单页面中查看 {% data variables.product.prodname_actions %} 使用情况。 {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} @@ -32,17 +32,19 @@ Organization owners and billing managers can view {% data variables.product.prod ### 查看企业帐户的 {% data variables.product.prodname_actions %} 使用情况 -Enterprise owners and billing managers can view {% data variables.product.prodname_actions %} usage for an enterprise account. +企业所有者和帐单管理员可查看企业帐户的 {% data variables.product.prodname_actions %} 使用情况。 {% note %} -**Note:** Billing details for enterprise accounts don't summarize the usage minutes for each operating system. {% data reusables.github-actions.enterprise-billing-details %} +**注：**企业帐户的计费详细信息不会汇总每个操作系统的使用分钟数。 {% data reusables.github-actions.enterprise-billing-details %} {% endnote %} {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %} -1. 在“{% data variables.product.prodname_actions %}”下，查看您的企业帐户中每个组织的数据传输使用详情。 ![分钟数使用详情](/assets/images/help/billing/actions-minutes-enterprise.png) +1. 在“ +{% data variables.product.prodname_actions %}", view details of usage of data transfer by each organization in your enterprise account. + ![分钟数使用详情](/assets/images/help/billing/actions-minutes-enterprise.png) {% data reusables.dotcom_billing.actions-packages-storage-enterprise-account %} {% data reusables.enterprise-accounts.actions-packages-report-download-enterprise-accounts %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md index 5bc3112502f3..2dc330daa84d 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-packages-usage.md @@ -18,7 +18,7 @@ versions: ### 查看组织的 {% data variables.product.prodname_registry %} 使用情况 -Organization owners and billing managers can view {% data variables.product.prodname_registry %} usage for an organization. For organizations managed by an enterprise account, only the organization owners can view {% data variables.product.prodname_registry %} usage in the organization billing page. +组织所有者和帐单管理员可查看组织的 {% data variables.product.prodname_registry %} 使用情况。 对于由企业帐户管理的组织，只有组织所有者可以在组织的帐单页面中查看 {% data variables.product.prodname_registry %} 使用情况。 {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} @@ -30,7 +30,7 @@ Organization owners and billing managers can view {% data variables.product.prod ### 查看企业帐户的 {% data variables.product.prodname_registry %} 使用情况 -Enterprise owners and billing managers can view {% data variables.product.prodname_registry %} usage for an enterprise account. +企业所有者和帐单管理员可查看企业帐户的 {% data variables.product.prodname_registry %} 使用情况。 {% note %} @@ -41,6 +41,8 @@ Enterprise owners and billing managers can view {% data variables.product.prodna {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %} -1. 在“{% data variables.product.prodname_registry %}”下，查看您的企业帐户中每个组织的数据传输使用详情。 ![数据传输使用详情](/assets/images/help/billing/packages-data-enterprise.png) +1. 在“ +{% data variables.product.prodname_registry %}", view details of usage of data transfer by each organization in your enterprise account. + ![数据传输使用详情](/assets/images/help/billing/packages-data-enterprise.png) {% data reusables.dotcom_billing.actions-packages-storage-enterprise-account %} {% data reusables.enterprise-accounts.actions-packages-report-download-enterprise-accounts %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-subscriptions-and-billing-date.md b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-subscriptions-and-billing-date.md index af71d8fb47c7..c9c9da3b6d77 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-subscriptions-and-billing-date.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-subscriptions-and-billing-date.md @@ -1,6 +1,6 @@ --- title: 查看订阅和结算日期 -intro: 您可以在帐户的计费设置中查看帐户的订阅、其他付费功能和产品以及下一个结算日期。 +intro: '您可以在帐户的计费设置中查看帐户的订阅、其他付费功能和产品以及下一个结算日期。' redirect_from: - /articles/finding-your-next-billing-date/ - /articles/finding-your-personal-account-s-next-billing-date/ diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md index 74c257b97a6c..62ea7b64e3f8 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/about-organizations.md @@ -25,5 +25,4 @@ versions: 实体（如公司、非营利组织或集团）可同意用于其组织的标准服务条款或公司服务条款。 更多信息请参阅“[升级到公司服务条款](/articles/upgrading-to-the-corporate-terms-of-service)”。 -{% data reusables.organizations.enter-data-protection-agreement %} 更多信息请参阅“[与 {% data variables.product.prodname_dotcom %} 签订符合 GDPR 规范的数据保护协议](/articles/entering-a-data-protection-agreement-with-github-for-gdpr-compliance)”。 {% endif %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md index be9b77199874..04d0a21620eb 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/about-ssh-certificate-authorities.md @@ -1,17 +1,17 @@ --- title: 关于 SSH 认证中心 -intro: 通过 SSH 认证中心，组织或企业帐户可提供 SSH 证书，供成员用来通过 Git 访问您的资源。 +intro: '通过 SSH 认证中心，组织或企业帐户可提供 SSH 证书，供成员用来通过 Git 访问您的资源。' product: '{% data reusables.gated-features.ssh-certificate-authorities %}' redirect_from: - /articles/about-ssh-certificate-authorities versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- SSH 证书是一种机制：一个 SSH 密钥对另一个 SSH 密钥签名。 如果使用 SSH 认证中心 (CA) 为组织成员提供已签名的 SSH 证书，您可以将 CA 添加到企业帐户或组织，以便组织成员使用其证书访问组织资源。 更多信息请参阅“[管理组织的 SSH 认证中心](/articles/managing-your-organizations-ssh-certificate-authorities)”。 -在将 SSH CA 添加到组织或企业帐户后，您可以使用 CA 为组织成员签名客户 SSH 证书。 组织成员可以使用已签名的证书通过 Git 访问组织的仓库（并且只访问您组织的仓库）。 您可能需要该成员使用 SSH 证书访问组织资源。{% if currentVersion == "free-pro-team@latest" %} 更多信息请参阅“[为企业帐户中的组织实施安全设置](/articles/enforcing-security-settings-in-your-enterprise-account#managing-your-enterprise-accounts-ssh-certificate-authorities)”。{% endif %} +在将 SSH CA 添加到组织或企业帐户后，您可以使用 CA 为组织成员签名客户 SSH 证书。 组织成员可以使用已签名的证书通过 Git 访问组织的仓库（并且只访问您组织的仓库）。 You can require that members use SSH certificates to access organization resources.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[Enforcing security settings in your enterprise account](/articles/enforcing-security-settings-in-your-enterprise-account#managing-your-enterprise-accounts-ssh-certificate-authorities)."{% endif %} 例如，您可以构建内部系统，每天早上向开发者颁发新证书。 每个开发者可以使用其每日证书处理组织在 {% data variables.product.product_name %} 上的仓库。 在一天结束时，证书会自动到期，以保护仓库，避免证书以后被窃取。 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/about-teams.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/about-teams.md index 4d85d614a703..287c2997e259 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/about-teams.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/about-teams.md @@ -21,7 +21,7 @@ versions: {% if currentVersion != "free-pro-team@latest" %} -您也可以使用 LDAP 同步根据建立的 LDAP 组同步 {% data variables.product.product_location_enterprise %} 团队成员和团队角色。 这可让您从 LDAP 服务器为用户建立基于角色的访问控制，而无需在 {% data variables.product.product_location_enterprise %} 中手动创建。 更多信息请参阅“[启用 LDAP 同步](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)”。 +您也可以使用 LDAP 同步根据建立的 LDAP 组同步 {% data variables.product.product_location_enterprise %} 团队成员和团队角色。 这可让您从 LDAP 服务器为用户建立基于角色的访问控制，而无需在 {% data variables.product.product_location_enterprise %} 中手动创建。 更多信息请参阅“[启用 LDAP 同步](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)”。 {% endif %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/about-your-organization-dashboard.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/about-your-organization-dashboard.md index cba787212d89..4f758335e891 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/about-your-organization-dashboard.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/about-your-organization-dashboard.md @@ -1,6 +1,6 @@ --- title: 关于组织仪表板 -intro: 作为组织成员，您可以全天访问组织仪表板，以了解近期活动的最新信息，跟踪您参与的议题和拉取请求，或者关注组织。 +intro: '作为组织成员，您可以全天访问组织仪表板，以了解近期活动的最新信息，跟踪您参与的议题和拉取请求，或者关注组织。' redirect_from: - /articles/about-your-organization-dashboard versions: @@ -28,7 +28,7 @@ versions: 在消息馈送的“All activity（所有活动）”部分，您可以查看来自组织中其他团队和仓库的更新。 -“All activity（所有活动）”部分显示组织中所有最近的活动，包括您未订阅的仓库中以及您未关注的人员的活动。 更多信息请参阅{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}“关于通知](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}”[关注和取消关注仓库](/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories){% endif %}”和“[关注人员](/articles/following-people)”。 +“All activity（所有活动）”部分显示组织中所有最近的活动，包括您未订阅的仓库中以及您未关注的人员的活动。 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 %}"[Watching and unwatching repositories](/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories){% endif %}" and "[Following people](/articles/following-people)." 例如，当组织中有人执行以下操作时，组织消息馈送会显示更新： - 创建新分支。 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/about-your-organizations-news-feed.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/about-your-organizations-news-feed.md index 7f0a4b5920d0..bec00402969e 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/about-your-organizations-news-feed.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/about-your-organizations-news-feed.md @@ -17,5 +17,5 @@ versions: 1. {% data variables.product.signin_link %} 到 {% data variables.product.product_name %} 帐户。 2. 打开 {% data reusables.user_settings.personal_dashboard %}。 3. 单击页面左上角的帐户上下文切换器。 ![Enterprise 中的上下文切换器按钮](/assets/images/help/organizations/account_context_switcher.png) -4. 从下拉菜单中选择组织。{% if currentVersion == "free-pro-team@latest" %} ![dotcom 中的上下文切换器菜单](/assets/images/help/organizations/account-context-switcher-selected-dotcom.png){% else %} -![Enterprise 中的上下文切换器菜单](/assets/images/help/organizations/account_context_switcher.png){% endif %} +4. Select an organization from the drop-down menu.{% if currentVersion == "free-pro-team@latest" %} ![Context switcher menu in dotcom](/assets/images/help/organizations/account-context-switcher-selected-dotcom.png){% else %} +![Context switcher menu in Enterprise](/assets/images/help/organizations/account_context_switcher.png){% endif %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/accessing-your-organization-if-your-identity-provider-is-unavailable.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/accessing-your-organization-if-your-identity-provider-is-unavailable.md index 546703f1e094..b455558da95a 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/accessing-your-organization-if-your-identity-provider-is-unavailable.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/accessing-your-organization-if-your-identity-provider-is-unavailable.md @@ -18,7 +18,7 @@ versions: 1. 在单点登录对话框底部，单击 **Use a recovery code（使用恢复代码）**绕过单点登录。 ![用于输入恢复代码的链接](/assets/images/help/saml/saml_use_recovery_code.png) 2. 在 "Recovery Code"（恢复代码）字段中，输入您的恢复代码。 ![无法输入恢复代码](/assets/images/help/saml/saml_recovery_code_entry.png) -3. Click **Verify**. ![用于确认恢复代码的按钮](/assets/images/help/saml/saml_verify_recovery_codes.png) +3. 单击 **Verify（验证）**。 ![用于确认恢复代码的按钮](/assets/images/help/saml/saml_verify_recovery_codes.png) 请务必注意，恢复代码在使用后便不再有效。 恢复代码不能重复使用。 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/accessing-your-organizations-settings.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/accessing-your-organizations-settings.md index b0299de63204..f5c913495fbf 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/accessing-your-organizations-settings.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/accessing-your-organizations-settings.md @@ -8,7 +8,7 @@ redirect_from: - /articles/managing-an-organization-s-settings/ - /articles/accessing-your-organization-s-settings - /articles/accessing-your-organizations-settings -intro: 组织帐户设置页面提供几种管理帐户的方式，如帐单、团队成员资格和仓库设置。 +intro: '组织帐户设置页面提供几种管理帐户的方式，如帐单、团队成员资格和仓库设置。' versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md index 55d7afb2837f..f142ab91df7a 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/adding-an-outside-collaborator-to-a-project-board-in-your-organization.md @@ -1,6 +1,6 @@ --- title: 添加外部协作者到组织的项目板 -intro: 作为组织所有者或项目板管理员，可以添加外部协作者并自定义他们对项目板的权限。 +intro: '作为组织所有者或项目板管理员，可以添加外部协作者并自定义他们对项目板的权限。' redirect_from: - /articles/adding-an-outside-collaborator-to-a-project-board-in-your-organization versions: @@ -17,6 +17,8 @@ versions: {% data reusables.project-management.click-menu %} {% data reusables.project-management.access-collaboration-settings %} {% data reusables.project-management.collaborator-option %} -9. 在 "Search by username, full name or email address"（按用户名、全名或电子邮件地址搜索）下，输入外部协作者的姓名、用户名或 {% data variables.product.prodname_dotcom %} 电子邮件地址。 ![在搜索字段中输入了 Octocat 用户名的协作者部分](/assets/images/help/projects/org-project-collaborators-find-name.png) +9. Under "Search by username, full name or email address", type the outside collaborator's name, username, or +{% data variables.product.prodname_dotcom %} email. + ![在搜索字段中输入了 Octocat 用户名的协作者部分](/assets/images/help/projects/org-project-collaborators-find-name.png) {% data reusables.project-management.add-collaborator %} {% data reusables.project-management.collaborator-permissions %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md index 953812f05f07..531a25692cf9 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization.md @@ -24,7 +24,9 @@ versions: {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.github-apps-settings-sidebar %} -1. 在 "{% data variables.product.prodname_github_app %}" 下，单击要为其添加 {% data variables.product.prodname_github_app %} 管理员的应用程序的头像。 ![选择 {% data variables.product.prodname_github_app %}](/assets/images/help/organizations/select-github-app.png) +1. 在“ +{% data variables.product.prodname_github_app %}s", click on the avatar of the app you'd like to add a {% data variables.product.prodname_github_app %} manager for. +![选择 {% data variables.product.prodname_github_app %}](/assets/images/help/organizations/select-github-app.png) {% data reusables.organizations.app-managers-settings-sidebar %} 1. 在“App managers（应用程序管理员）”下，输入要指定为应用程序 GitHub App 管理员的人员，然后单击 **Grant（授权）**。 ![添加特定应用程序的 {% data variables.product.prodname_github_app %} 管理员](/assets/images/help/organizations/add-github-app-manager-for-app.png) diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/adding-organization-members-to-a-team.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/adding-organization-members-to-a-team.md index e41880af9d14..6b112565b6de 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/adding-organization-members-to-a-team.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/adding-organization-members-to-a-team.md @@ -1,6 +1,6 @@ --- -title: 添加组织成员到团队 -intro: '拥有所有者或团队维护员权限的人员可以添加成员到团队。 具有所有者权限的人员也可{% if currentVersion == "free-pro-team@latest" %}邀请非成员加入{% else %}添加非成员到{% endif %}团队和组织。' +title: Adding organization members to a team +intro: 'People with owner or team maintainer permissions can add organization members to teams. People with owner permissions can also {% if currentVersion == "free-pro-team@latest" %}invite non-members to join{% else %}add non-members to{% endif %} a team and the organization.' redirect_from: - /articles/adding-organization-members-to-a-team-early-access-program/ - /articles/adding-organization-members-to-a-team @@ -15,13 +15,14 @@ versions: {% data reusables.profile.access_org %} {% data reusables.organizations.specific_team %} {% data reusables.organizations.team_members_tab %} -6. 在团队成员列表上方，单击 **Add a member（添加成员）**。 ![添加成员按钮](/assets/images/help/teams/add-member-button.png) +6. Above the list of team members, click **Add a member**. +![Add member button](/assets/images/help/teams/add-member-button.png) {% data reusables.organizations.invite_to_team %} {% data reusables.organizations.review-team-repository-access %} {% if currentVersion == "free-pro-team@latest" %}{% data reusables.organizations.cancel_org_invite %}{% endif %} -### 延伸阅读 +### Further reading -- "[关于团队](/articles/about-teams)" -- "[管理团队对组织仓库的访问](/articles/managing-team-access-to-an-organization-repository)" +- "[About teams](/articles/about-teams)" +- "[Managing team access to an organization repository](/articles/managing-team-access-to-an-organization-repository)" diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/adding-people-to-your-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/adding-people-to-your-organization.md index 929b9cfb3cd8..2fc533c72b80 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/adding-people-to-your-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/adding-people-to-your-organization.md @@ -9,7 +9,7 @@ versions: {% tip %} -**Tips**: +**提示**： - 仅组织所有者才可将用户添加到组织。 更多信息请参阅“[组织的权限级别](/articles/permission-levels-for-an-organization)”。 - 如果您的组织[要求成员使用双重身份验证](/articles/requiring-two-factor-authentication-in-your-organization)，则用户必须[启用双重身份验证](/articles/securing-your-account-with-two-factor-authentication-2fa)，然后您才可将他们添加到组织。 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/can-i-create-accounts-for-people-in-my-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/can-i-create-accounts-for-people-in-my-organization.md index 5f7b1e2b930e..f5fea28a7282 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/can-i-create-accounts-for-people-in-my-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/can-i-create-accounts-for-people-in-my-organization.md @@ -3,7 +3,7 @@ title: 我可以为组织中的人员创建帐户吗？ redirect_from: - /articles/can-i-create-accounts-for-those-in-my-organization/ - /articles/can-i-create-accounts-for-people-in-my-organization -intro: 虽然您可以将用户添加到您创建的组织，但您无法代表其他人创建其个人用户帐户。 +intro: '虽然您可以将用户添加到您创建的组织，但您无法代表其他人创建其个人用户帐户。' versions: free-pro-team: '*' --- diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md index a16058d12b6b..c77030162752 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta.md @@ -15,8 +15,8 @@ SAML SSO 控制并保护对组织资源（如仓库、议题和拉取请求） 启用 SCIM 后，您在 Okta 中为其分配了 {% data variables.product.prodname_ghe_cloud %} 应用程序的任何用户都可以使用以下配置。 -| 功能 | 描述 | -| -------- | ------------------------------------------------------------------------------------------------------- | +| 功能 | 描述 | +| -------- | -------------------------------------------------------------------------------------------------- | | 推送新用户 | 在 Okta 中创建新用户时，该用户将收到一封电子邮件，让其加入您的 {% data variables.product.prodname_dotcom %} 组织。 | | 推送用户停用 | 当您在 Okta 中停用某用户时，Okta 会将该用户从您的 {% data variables.product.prodname_dotcom %} 组织中删除。 | | 推送个人资料更新 | 当您在 Okta 中更新某用户的个人资料时，Okta 会在您的 {% data variables.product.prodname_dotcom %} 组织中更新该用户成员资格的元数据。 | diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md new file mode 100644 index 000000000000..5934c0738154 --- /dev/null +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization.md @@ -0,0 +1,16 @@ +--- +title: Configuring the retention period for GitHub Actions artifacts and logs in your organization +intro: 'You can configure the retention period for {% data variables.product.prodname_actions %} artifacts and logs in your organization.' +versions: + free-pro-team: '*' + enterprise-server: '>=2.23' +--- + +{% data reusables.actions.about-artifact-log-retention %} + +## Setting the retention period for an organization + +{% data reusables.organizations.navigate-to-org %} +{% data reusables.organizations.org_settings %} +{% data reusables.organizations.settings-sidebar-actions %} +{% data reusables.github-actions.change-retention-period-for-artifacts-logs %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/converting-an-admin-team-to-improved-organization-permissions.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/converting-an-admin-team-to-improved-organization-permissions.md index 139022fa320d..168343108768 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/converting-an-admin-team-to-improved-organization-permissions.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/converting-an-admin-team-to-improved-organization-permissions.md @@ -1,6 +1,6 @@ --- title: 将管理员团队转换为改进的组织权限 -intro: 如果您的组织是在 2015 年 9 月之后创建的，则您的组织默认具有改进的组织权限。 在 2015 年 9 月之前创建的组织可能需要将较旧的所有者和管理员团队迁移到改进的权限模型。 旧管理员团队的成员在其团队被迁移到改进的组织权限模型之前，自动保留创建仓库的权限。 +intro: '如果您的组织是在 2015 年 9 月之后创建的，则您的组织默认具有改进的组织权限。 在 2015 年 9 月之前创建的组织可能需要将较旧的所有者和管理员团队迁移到改进的权限模型。 旧管理员团队的成员在其团队被迁移到改进的组织权限模型之前，自动保留创建仓库的权限。' redirect_from: - /articles/converting-your-previous-admin-team-to-the-improved-organization-permissions/ - /articles/converting-an-admin-team-to-improved-organization-permissions diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-into-a-user.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-into-a-user.md index 86be62a29059..2a9007f9a18b 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-into-a-user.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-into-a-user.md @@ -1,6 +1,6 @@ --- title: 将组织转换为用户 -intro: 无法将组织转换为个人用户帐户，但您可以创建一个新用户帐户，然后将组织的仓库转让给该帐户。 +intro: '无法将组织转换为个人用户帐户，但您可以创建一个新用户帐户，然后将组织的仓库转让给该帐户。' redirect_from: - /articles/converting-an-organization-into-a-user versions: diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-member-to-an-outside-collaborator.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-member-to-an-outside-collaborator.md index 8e7ade65b387..568903c1e766 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-member-to-an-outside-collaborator.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/converting-an-organization-member-to-an-outside-collaborator.md @@ -1,6 +1,6 @@ --- title: 将组织成员转换为外部协作者 -intro: 如果组织的某些当前成员只需要访问特定仓库，例如顾问或临时员工，您可以将他们转换为*外部协作者*。 +intro: '如果组织的某些当前成员只需要访问特定仓库，例如顾问或临时员工，您可以将他们转换为*外部协作者*。' redirect_from: - /articles/converting-an-organization-member-to-an-outside-collaborator versions: @@ -23,7 +23,7 @@ versions: 建议查看组织成员对仓库的访问权限，以确保其访问权限符合您的预期。 更多信息请参阅“[管理个人对组织仓库的访问](/articles/managing-an-individual-s-access-to-an-organization-repository)”。 -将组织成员转换为外部协作者时，他们作为组织成员的权限将保存三个月，因此，如果您在该时间范围内{% if currentVersion == "free-pro-team@latest" %} 邀请他们重新加入{% else %} 将他们重新添加到{% endif %} 您的组织，您可以恢复其成员权限。 更多信息请参阅“[恢复组织的前成员](/articles/reinstating-a-former-member-of-your-organization)”。 +When you convert an organization member to an outside collaborator, their privileges as organization members are saved for three months so that you can restore their membership privileges if you{% if currentVersion == "free-pro-team@latest" %} invite them to rejoin{% else %} add them back to{% endif %} your organization within that time frame. 更多信息请参阅“[恢复组织的前成员](/articles/reinstating-a-former-member-of-your-organization)”。 {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/converting-an-outside-collaborator-to-an-organization-member.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/converting-an-outside-collaborator-to-an-organization-member.md index be8494f057ef..be985f927923 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/converting-an-outside-collaborator-to-an-organization-member.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/converting-an-outside-collaborator-to-an-organization-member.md @@ -1,6 +1,6 @@ --- -title: 将外部协作者转换为组织成员 -intro: '如果您希望为组织仓库的外部协作者提供更广泛的组织内权限，您可以{% if currentVersion == "free-pro-team@latest" %}邀请他们成为组织的成员{% else %}让他们成为组织的成员{% endif %}。' +title: Converting an outside collaborator to an organization member +intro: 'If you would like to give an outside collaborator on your organization''s repositories broader permissions within your organization, you can {% if currentVersion == "free-pro-team@latest" %}invite them to become a member of{% else %}make them a member of{% endif %} the organization.' redirect_from: - /articles/converting-an-outside-collaborator-to-an-organization-member versions: @@ -11,9 +11,9 @@ versions: {% tip %} **Tips**: -- 只有组织所有者才能{% if currentVersion == "free-pro-team@latest" %}邀请用户加入{% else %}将用户添加到{% endif %}组织。 更多信息请参阅“[组织的权限级别](/articles/permission-levels-for-an-organization)”。{% if currentVersion == "free-pro-team@latest" %} -- 如果您的组织采用付费的每用户订阅，则必须有未使用的许可才可邀请新成员加入组织或恢复前组织成员。 更多信息请参阅“[关于每用户定价](/articles/about-per-user-pricing)”。 {% data reusables.organizations.org-invite-expiration %}{% endif %} -- 如果您的组织[要求成员使用双重身份验证](/articles/requiring-two-factor-authentication-in-your-organization)，则{% if currentVersion == "free-pro-team@latest" %}您邀请的用户必须[启用双重身份验证](/articles/securing-your-account-with-two-factor-authentication-2fa)之后才能接受邀请。{% else %}要添加的用户必须[启用双重身份验证](/articles/securing-your-account-with-two-factor-authentication-2fa)之后您才能将其添加到组织。{% endif %} +- Only organization owners can {% if currentVersion == "free-pro-team@latest" %}invite users to join{% else %}add users to{% endif %} an organization. For more information, see "[Permission levels for an organization](/articles/permission-levels-for-an-organization)."{% if currentVersion == "free-pro-team@latest" %} +- If your organization is on a paid per-user subscription, an unused license must be available before you can invite a new member to join the organization or reinstate a former organization member. For more information, see "[About per-user pricing](/articles/about-per-user-pricing)." {% data reusables.organizations.org-invite-expiration %}{% endif %} +- If your organization [requires members to use two-factor authentication](/articles/requiring-two-factor-authentication-in-your-organization), users {% if currentVersion == "free-pro-team@latest" %}you invite must [enable two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa) before they can accept the invitation.{% else %}must [enable two-factor authentication](/articles/securing-your-account-with-two-factor-authentication-2fa) before you can add them to the organization.{% endif %} {% endtip %} @@ -22,10 +22,9 @@ versions: {% data reusables.organizations.people %} {% data reusables.organizations.people_tab_outside_collaborators %} {% if currentVersion == "free-pro-team@latest" %} -5. To the right of the name of the outside collaborator you want to become a member, use the -{% octicon "gear" aria-label="The gear icon" %} drop-down menu and click **Invite to organization**.![邀请外部协作者加入组织](/assets/images/help/organizations/invite_outside_collaborator_to_organization.png) +5. To the right of the name of the outside collaborator you want to become a member, use the {% octicon "gear" aria-label="The gear icon" %} drop-down menu and click **Invite to organization**.![Invite outside collaborators to organization](/assets/images/help/organizations/invite_outside_collaborator_to_organization.png) {% else %} -5. 在您希望其成为成员的外部协作者姓名右侧，单击 **Invite to organization（邀请加入组织）**。![邀请外部协作者加入组织](/assets/images/enterprise/orgs-and-teams/invite_outside_collabs_to_org.png) +5. To the right of the name of the outside collaborator you want to become a member, click **Invite to organization**.![Invite outside collaborators to organization](/assets/images/enterprise/orgs-and-teams/invite_outside_collabs_to_org.png) {% endif %} {% data reusables.organizations.choose-to-restore-privileges %} {% data reusables.organizations.choose-user-role-send-invitation %} @@ -33,6 +32,6 @@ versions: {% data reusables.organizations.user_must_accept_invite_email %} {% data reusables.organizations.cancel_org_invite %} {% endif %} -### 延伸阅读 +### Further reading -- "[将组织成员转换为外部协作者](/articles/converting-an-organization-member-to-an-outside-collaborator)" +- "[Converting an organization member to an outside collaborator](/articles/converting-an-organization-member-to-an-outside-collaborator)" diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/converting-an-owners-team-to-improved-organization-permissions.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/converting-an-owners-team-to-improved-organization-permissions.md index f79793ba64c9..853de490416c 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/converting-an-owners-team-to-improved-organization-permissions.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/converting-an-owners-team-to-improved-organization-permissions.md @@ -1,6 +1,6 @@ --- title: 将所有者团队转换为改进的组织权限 -intro: 如果您的组织是在 2015 年 9 月之后创建的，则您的组织默认具有改进的组织权限。 在 2015 年 9 月之前创建的组织可能需要将较旧的所有者和管理员团队迁移到改进的权限模型。 “所有者”现在是赋予组织中个别成员的管理角色。 旧所有者团队的成员自动获得所有者权限。 +intro: '如果您的组织是在 2015 年 9 月之后创建的，则您的组织默认具有改进的组织权限。 在 2015 年 9 月之前创建的组织可能需要将较旧的所有者和管理员团队迁移到改进的权限模型。 “所有者”现在是赋予组织中个别成员的管理角色。 旧所有者团队的成员自动获得所有者权限。' redirect_from: - /articles/converting-your-previous-owners-team-to-the-improved-organization-permissions-early-access-program/ - /articles/converting-your-previous-owners-team-to-the-improved-organization-permissions/ diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch.md index ac6c205ad7f7..8f4531cef981 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch.md @@ -13,7 +13,7 @@ versions: {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.organizations %} {% data reusables.organizations.new-organization %} -4. 按照提示创建组织。 {% if currentVersion == "free-pro-team@latest" %}要详细了解可用于您的团队的计划，请参阅“[{% data variables.product.prodname_dotcom %} 的产品](/articles/githubs-products)”。{% endif %} +4. 按照提示创建组织。 {% if currentVersion == "free-pro-team@latest" %}For more information about the plans available for your team, see "[{% data variables.product.prodname_dotcom %}'s products](/articles/githubs-products)."{% endif %} ### 延伸阅读 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/deleting-an-organization-account.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/deleting-an-organization-account.md index 506ac0e49499..89757fddd198 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/deleting-an-organization-account.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/deleting-an-organization-account.md @@ -1,6 +1,6 @@ --- title: 删除组织帐户 -intro: '删除组织时，所有仓库、私有仓库复刻、wiki、议题、拉取请求和项目或组织页面也被删除。 {% if currentVersion == "free-pro-team@latest" %}组织名称可用于新用户或组织帐户，并且计费将结束。{% endif %}' +intro: '删除组织时，所有仓库、私有仓库复刻、wiki、议题、拉取请求和项目或组织页面也被删除。 {% if currentVersion == "free-pro-team@latest" %}The organization name becomes available for use on a new user or organization account, and your billing will end.{% endif %}' redirect_from: - /articles/deleting-an-organization-account versions: diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md index b1da67dd7872..b2800bd16042 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization.md @@ -1,6 +1,6 @@ --- title: 禁用或限制组织的 GitHub 操作 -intro: 组织所有者可禁用、启用和限制组织的 GitHub 操作。 +intro: '组织所有者可禁用、启用和限制组织的 GitHub 操作。' versions: free-pro-team: '*' enterprise-server: '>=2.22' @@ -17,21 +17,59 @@ versions: 此外，您可以对组织中的所有仓库启用 {% data variables.product.prodname_actions %}，但限制工作流程可以运行的操作。 {% data reusables.github-actions.enabled-local-github-actions %} +{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.23" %} + +### 管理组织的 {% data variables.product.prodname_actions %} 权限 + +{% data reusables.profile.access_profile %} +{% data reusables.profile.access_org %} +{% data reusables.organizations.org_settings %} +{% data reusables.organizations.settings-sidebar-actions %} +1. 在 **Local and third-party Actions（本地和第三方操作）**下，选择一个选项。 ![启用、禁用或限制此组织的操作](/assets/images/help/repository/enable-org-actions.png) +1. 单击 **Save（保存）**。 + +{% endif %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} + ### 管理组织的 {% data variables.product.prodname_actions %} 权限 +You can disable all workflows for an organization or set a policy that configures which actions can be used in an organization. + +{% data reusables.actions.actions-use-policy-settings %} + +{% note %} + +**Note:** You might not be able to manage these settings if your organization is managed by an enterprise that has overriding policy. For more information, {% if currentVersion == "free-pro-team@latest" %}"[Enforcing {% data variables.product.prodname_actions %} policies in your enterprise account](/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account)."{% else %}"[Enforcing {% data variables.product.prodname_actions %} policies for your enterprise](/enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise)."{% endif %} + +{% endnote %} + +{% data reusables.profile.access_profile %} +{% data reusables.profile.access_org %} +{% data reusables.organizations.org_settings %} +{% data reusables.organizations.settings-sidebar-actions %} +1. Under **Policies**, select an option. ![Set actions policy for this organization](/assets/images/help/organizations/actions-policy.png) +1. 单击 **Save（保存）**。 + +### Allowing specific actions to run + +{% data reusables.actions.allow-specific-actions-intro %} + {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.settings-sidebar-actions %} -1. Under **Local and third-party Actions**, select an option. ![启用、禁用或限制此组织的操作](/assets/images/help/repository/enable-org-actions.png) +1. Under **Policies**, select **Allow specific actions** and add your required actions to the list. ![Add actions to allow list](/assets/images/help/organizations/actions-policy-allow-list.png) 1. 单击 **Save（保存）**。 +{% endif %} + {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -### Enabling workflows for private repository forks +### 为私有仓库复刻启用工作流程 {% data reusables.github-actions.private-repository-forks-overview %} -#### Configuring the private fork policy for an organization +#### 为组织配置私有复刻策略 {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization.md index e1386c96988e..f3231626ad45 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization.md @@ -10,9 +10,9 @@ versions: ### About restrictions on publication of {% data variables.product.prodname_pages %} sites -You can control whether members of your organization can publish websites from repositories in your organization using {% data variables.product.prodname_pages %}. 有关 {% data variables.product.prodname_pages %} 的更多信息，请参阅“[关于 {% data variables.product.prodname_pages %}](/github/working-with-github-pages/about-github-pages)”。 +You can control whether members of your organization can publish websites from repositories in your organization using {% data variables.product.prodname_pages %}. For more information about {% data variables.product.prodname_pages %}, see "[About {% data variables.product.prodname_pages %}](/github/working-with-github-pages/about-github-pages)." -{% if currentVersion != "free-pro-team@latest" %}If your site administrator has enabled Public Pages, {% endif %}{% data variables.product.prodname_pages %} sites are publicly available on the internet, even if the repository for the site is private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %}. 更多信息请参阅{% if currentVersion != "free-pro-team@latest" %} “[在设备上配置 {% data variables.product.prodname_pages %}](/enterprise/admin/installation/configuring-github-pages-on-your-appliance#making-github-pages-publicly-accessible)”和{% endif %}“[关于仓库可见性](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)”。 +{% if currentVersion != "free-pro-team@latest" %}If your site administrator has enabled Public Pages, {% endif %}{% data variables.product.prodname_pages %} sites are publicly available on the internet, even if the repository for the site is private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %}. For more information, see{% if currentVersion != "free-pro-team@latest" %} "[Configuring {% data variables.product.prodname_pages %} on your appliance](/enterprise/admin/installation/configuring-github-pages-on-your-appliance#making-github-pages-publicly-accessible)" and{% endif %} "[About repository visibility](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)." ### Disabling publication of {% data variables.product.prodname_pages %} sites @@ -22,5 +22,7 @@ After you disable publication of {% data variables.product.prodname_pages %} sit {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.member-privileges %} -1. Under "Pages creation", unselect **Allow members to publish sites**. ![Unselected checkbox for "Allow members to publish sites" option](/assets/images/help/organizations/org-settings-pages-disable-publication-checkbox.png) -1. 单击 **Save（保存）**。 !["Save" button for "Allow members to publish sites" option](/assets/images/help/organizations/org-settings-pages-disable-publication-save-button.png) +1. Under "Pages creation", unselect **Allow members to publish sites**. + ![Unselected checkbox for "Allow members to publish sites" option](/assets/images/help/organizations/org-settings-pages-disable-publication-checkbox.png) +1. Click **Save**. + !["Save" button for "Allow members to publish sites" option](/assets/images/help/organizations/org-settings-pages-disable-publication-save-button.png) diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/enabling-oauth-app-access-restrictions-for-your-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/enabling-oauth-app-access-restrictions-for-your-organization.md index ec97f0757aab..1c956b277b42 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/enabling-oauth-app-access-restrictions-for-your-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/enabling-oauth-app-access-restrictions-for-your-organization.md @@ -1,6 +1,6 @@ --- title: 对组织启用 OAuth App 访问限制 -intro: '组织所有者可启用 {% data variables.product.prodname_oauth_app %} 访问限制，以便在组织成员于其个人帐户上使用允许 {% data variables.product.prodname_oauth_app %} 的同时，防止不受信任的应用程序访问组织的资源。' +intro: '组织所有者可启用 {% data variables.product.prodname_oauth_app %} 访问限制，以便在组织成员在其个人账户上使用允许 {% data variables.product.prodname_oauth_app %} 的同时，防止不受信任的应用程序访问组织的资源。' redirect_from: - /articles/enabling-third-party-application-restrictions-for-your-organization/ - /articles/enabling-oauth-app-access-restrictions-for-your-organization @@ -12,7 +12,7 @@ versions: {% warning %} -**Warnings**: +**警告**： - 启用 {% data variables.product.prodname_oauth_app %} 访问限制将撤销对所有之前已授权 {% data variables.product.prodname_oauth_app %} 和 SSH 密钥的组织访问权限。 更多信息请参阅“[关于 {% data variables.product.prodname_oauth_app %} 访问限制](/articles/about-oauth-app-access-restrictions)”。 - 在设置 {% data variables.product.prodname_oauth_app %} 访问限制后，确保重新授权任何需要持续访问组织私有数据的 {% data variables.product.prodname_oauth_app %}。 所有组织成员将需要创建新的 SSH 密钥，并且组织将需要根据需要创建新的部署密钥。 - 启用 {% data variables.product.prodname_oauth_app %} 访问限制后，应用程序可以使用 OAuth 令牌访问有关 {% data variables.product.prodname_marketplace %} 事务的信息。 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/giving-team-maintainer-permissions-to-an-organization-member.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/giving-team-maintainer-permissions-to-an-organization-member.md index f91988223dff..80bb5f5dc606 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/giving-team-maintainer-permissions-to-an-organization-member.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/giving-team-maintainer-permissions-to-an-organization-member.md @@ -1,6 +1,6 @@ --- title: 向组织成员授予“团队维护员”权限 -intro: 组织所有者可将组织的任何成员升级为团队的*团队维护员*，向他们授予组织所有者的部分权限。 +intro: '组织所有者可将组织的任何成员升级为团队的*团队维护员*，向他们授予组织所有者的部分权限。' redirect_from: - /articles/giving-team-maintainer-permissions-to-an-organization-member-early-access-program/ - /articles/giving-team-maintainer-permissions-to-an-organization-member diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/granting-access-to-your-organization-with-saml-single-sign-on.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/granting-access-to-your-organization-with-saml-single-sign-on.md index be02979545ee..a48043512278 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/granting-access-to-your-organization-with-saml-single-sign-on.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/granting-access-to-your-organization-with-saml-single-sign-on.md @@ -1,6 +1,6 @@ --- title: 使用 SAML 单点登录授予对组织的访问 -intro: 组织管理员可使用 SAML 单点登录授予对其组织的访问。 此访问权限可授予组织成员、自动程序和服务帐户。 +intro: '组织管理员可使用 SAML 单点登录授予对其组织的访问。 此访问权限可授予组织成员、自动程序和服务帐户。' mapTopic: true redirect_from: - /articles/granting-access-to-your-organization-with-saml-single-sign-on diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/index.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/index.md index 434484e50aa5..5402ee7639f3 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/index.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/index.md @@ -100,6 +100,7 @@ versions: {% link_in_list /managing-the-forking-policy-for-your-organization %} {% link_in_list /disabling-or-limiting-github-actions-for-your-organization %} + {% link_in_list /configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization %} {% link_in_list /setting-permissions-for-adding-outside-collaborators %} @@ -131,7 +132,6 @@ versions: {% link_in_list /upgrading-to-the-corporate-terms-of-service %} - {% link_in_list /entering-a-data-protection-agreement-with-github-for-gdpr-compliance %} {% topic_link_in_list /migrating-to-improved-organization-permissions %} {% link_in_list /converting-an-owners-team-to-improved-organization-permissions %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/integrating-jira-with-your-organization-project-board.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/integrating-jira-with-your-organization-project-board.md index d6618d2693da..ae7607cf4286 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/integrating-jira-with-your-organization-project-board.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/integrating-jira-with-your-organization-project-board.md @@ -1,6 +1,6 @@ --- title: 集成 Jira 与组织项目板 -intro: 您可以将 Jira Cloud 与组织帐户集成，以扫描提交和拉取请求，在任何提及的 Jira 议题中创建相关的元数据和超链接。 +intro: '您可以将 Jira Cloud 与组织帐户集成，以扫描提交和拉取请求，在任何提及的 Jira 议题中创建相关的元数据和超链接。' redirect_from: - /articles/integrating-jira-with-your-organization-project-board versions: diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md index bd379ac1c85e..15b6141e9679 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization.md @@ -1,6 +1,7 @@ --- title: 邀请用户参加您的组织 intro: '您可以使用任何人的 {% data variables.product.product_name %} 用户名或电子邮件地址邀请其成为组织的成员。' +permissions: Organization owners can invite users to join an organization. redirect_from: - /articles/adding-or-inviting-members-to-a-team-in-an-organization/ - /articles/inviting-users-to-join-your-organization @@ -10,10 +11,9 @@ versions: {% tip %} -**Tips**: -- 仅组织所有者才可邀请用户加入组织。 更多信息请参阅“[组织的权限级别](/articles/permission-levels-for-an-organization)”。 +**提示**： - 如果您的组织采用付费的每用户订阅，则必须有未使用的许可才可邀请新成员加入组织或恢复前组织成员。 更多信息请参阅“[关于每用户定价](/articles/about-per-user-pricing)”。 {% data reusables.organizations.org-invite-expiration %} -- 如果您的组织[需要成员使用双重身份验证](/articles/requiring-two-factor-authentication-in-your-organization)，则您邀请的用户必须[启用双重身份验证](/articles/securing-your-account-with-two-factor-authentication-2fa)，然后才可接受邀请。 +- If your organization requires members to use two-factor authentication, users that you invite must enable two-factor authentication before accepting the invitation. For more information, see "[Requiring two-factor authentication in your organization](/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization)" and "[Securing your account with two-factor authentication (2FA)](/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa)." {% endtip %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/keeping-your-organization-secure.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/keeping-your-organization-secure.md index 6a6544cb438d..5f81b316777a 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/keeping-your-organization-secure.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/keeping-your-organization-secure.md @@ -3,7 +3,7 @@ title: 保护组织安全 redirect_from: - /articles/preventing-unauthorized-access-to-organization-information/ - /articles/keeping-your-organization-secure -intro: 组织所有者有多项功能来帮助保护其项目和数据的安全。 如果您是组织的所有者，应定期检查组织的审核日志、成员 2FA 状态和应用程序设置，以确保没有未授权或恶意的活动。 +intro: '组织所有者有多项功能来帮助保护其项目和数据的安全。 如果您是组织的所有者，应定期检查组织的审核日志、成员 2FA 状态和应用程序设置，以确保没有未授权或恶意的活动。' mapTopic: true versions: free-pro-team: '*' diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-a-project-board-for-organization-members.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-a-project-board-for-organization-members.md index b1f66643c430..77abd1717688 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-a-project-board-for-organization-members.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-a-project-board-for-organization-members.md @@ -1,6 +1,6 @@ --- title: 管理组织成员对项目板的访问 -intro: 作为组织所有者或项目板管理员，您可以为所有组织成员设置项目板的默认权限级别。 +intro: '作为组织所有者或项目板管理员，您可以为所有组织成员设置项目板的默认权限级别。' redirect_from: - /articles/managing-access-to-a-project-board-for-organization-members versions: diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-your-organizations-project-boards.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-your-organizations-project-boards.md index 502411716414..2463ae366b18 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-your-organizations-project-boards.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-access-to-your-organizations-project-boards.md @@ -1,6 +1,6 @@ --- title: 管理对组织项目板的访问 -intro: 作为组织所有者或项目板管理员，您可以向组织成员、团队及外部协作者授予对组织项目板不同的访问权限。 +intro: '作为组织所有者或项目板管理员，您可以向组织成员、团队及外部协作者授予对组织项目板不同的访问权限。' redirect_from: - /articles/managing-access-to-your-organization-s-project-boards - /articles/managing-access-to-your-organizations-project-boards diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-allowed-ip-addresses-for-your-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-allowed-ip-addresses-for-your-organization.md index 256658f2fc56..e47da9fa0346 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-allowed-ip-addresses-for-your-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-allowed-ip-addresses-for-your-organization.md @@ -46,7 +46,7 @@ versions: {% data reusables.identity-and-permissions.ip-allow-lists-edit-entry %} {% data reusables.identity-and-permissions.ip-allow-lists-edit-ip %} {% data reusables.identity-and-permissions.ip-allow-lists-edit-description %} -8. Click **Update**. +8. 单击 **Update（更新）**。 ### 删除允许的 IP 地址 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md index fe0bc7ff1dfb..2241b1ab6bed 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-project-board.md @@ -1,6 +1,6 @@ --- title: 管理个人对组织项目板的访问 -intro: 作为组织所有者或项目板管理员，您可以管理个别成员对组织拥有的项目板的访问。 +intro: '作为组织所有者或项目板管理员，您可以管理个别成员对组织拥有的项目板的访问。' redirect_from: - /articles/managing-an-individual-s-access-to-an-organization-project-board - /articles/managing-an-individuals-access-to-an-organization-project-board @@ -24,7 +24,9 @@ versions: {% data reusables.project-management.click-menu %} {% data reusables.project-management.access-collaboration-settings %} {% data reusables.project-management.collaborator-option %} -9. 在 "Search by username, full name or email address"（按用户名、全名或电子邮件地址搜索）下，输入协作者的姓名、用户名或 {% data variables.product.prodname_dotcom %} 电子邮件地址。 ![在搜索字段中输入了 Octocat 用户名的协作者部分](/assets/images/help/projects/org-project-collaborators-find-name.png) +9. Under "Search by username, full name or email address", type the collaborator's name, username, or +{% data variables.product.prodname_dotcom %} email. + ![在搜索字段中输入了 Octocat 用户名的协作者部分](/assets/images/help/projects/org-project-collaborators-find-name.png) {% data reusables.project-management.add-collaborator %} {% data reusables.project-management.collaborator-permissions %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-repository.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-repository.md index 45283d4cb66d..97caac22d6fd 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-repository.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-an-individuals-access-to-an-organization-repository.md @@ -30,5 +30,5 @@ versions: ### 延伸阅读 -{% if currentVersion == "free-pro-team@latest" %}- "[限制与仓库的交互](/articles/limiting-interactions-with-your-repository)"{% endif %} +{% if currentVersion == "free-pro-team@latest" %}- "[Limiting interactions with your repository](/articles/limiting-interactions-with-your-repository)"{% endif %} - "[组织的仓库权限级别](/articles/repository-permission-levels-for-an-organization)" diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md index 4f96cd6f2db5..bf40f0b9f6db 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-git-access-to-your-organizations-repositories.md @@ -8,6 +8,6 @@ redirect_from: - /articles/managing-git-access-to-your-organizations-repositories versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-membership-in-your-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-membership-in-your-organization.md index aa080e680ae6..e56ca1912864 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-membership-in-your-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-membership-in-your-organization.md @@ -1,6 +1,6 @@ --- title: 管理组织中的成员资格 -intro: '在创建组织后，您可以{% if currentVersion == "free-pro-team@latest" %}邀请人员成为{% else %}添加人员为{% endif %}组织的成员。 您也可以删除组织的成员，以及恢复前成员。' +intro: 'After you create your organization, you can {% if currentVersion == "free-pro-team@latest" %}invite people to become{% else %}add people as{% endif %} members of the organization. 您也可以删除组织的成员，以及恢复前成员。' redirect_from: - /articles/removing-a-user-from-your-organization/ - /articles/managing-membership-in-your-organization diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-organization-settings.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-organization-settings.md index fff3659cbd68..51030371e9c9 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-organization-settings.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-organization-settings.md @@ -1,6 +1,6 @@ --- title: 管理组织设置 -intro: 组织管理员可以更改多项设置，包括属于组织的仓库名称和所有者团队成员资格。 此外，组织管理员还可以删除组织及其所有仓库。 +intro: '组织管理员可以更改多项设置，包括属于组织的仓库名称和所有者团队成员资格。 此外，组织管理员还可以删除组织及其所有仓库。' mapTopic: true redirect_from: - /articles/managing-organization-settings diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-peoples-access-to-your-organization-with-roles.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-peoples-access-to-your-organization-with-roles.md index ce5ea49dd324..5de898d829ac 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-peoples-access-to-your-organization-with-roles.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-peoples-access-to-your-organization-with-roles.md @@ -1,6 +1,6 @@ --- title: 使用角色管理人们对您的组织的访问 -intro: 组织中的人员角色确定他们对您的组织、其设置和数据的访问权限。 您可以将人们设为组织的所有者、成员或帐单管理员，或者向他们授予团队维护员权限。 +intro: '组织中的人员角色确定他们对您的组织、其设置和数据的访问权限。 您可以将人们设为组织的所有者、成员或帐单管理员，或者向他们授予团队维护员权限。' redirect_from: - /articles/managing-people-s-access-to-your-organization-with-roles - /articles/managing-peoples-access-to-your-organization-with-roles diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-project-board.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-project-board.md index 5b65ce6bf82a..c602ed8f8419 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-project-board.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-project-board.md @@ -1,6 +1,6 @@ --- title: 管理团队对组织项目板的访问 -intro: 作为组织所有者或项目板管理员，您可以向团队授予对组织拥有的项目板的访问权限。 +intro: '作为组织所有者或项目板管理员，您可以向团队授予对组织拥有的项目板的访问权限。' redirect_from: - /articles/managing-team-access-to-an-organization-project-board versions: diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository.md index 66630d732bd8..1741d5868a54 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository.md @@ -1,6 +1,6 @@ --- title: 管理团队对组织仓库的访问 -intro: 您可以向团队授予仓库访问权限，删除团队的仓库访问权限，或者更改团队对仓库的权限级别。 +intro: '您可以向团队授予仓库访问权限，删除团队的仓库访问权限，或者更改团队对仓库的权限级别。' redirect_from: - /articles/managing-team-access-to-an-organization-repository-early-access-program/ - /articles/managing-team-access-to-an-organization-repository diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md index 580b1ed8e968..d073da061174 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization.md @@ -1,6 +1,7 @@ --- -title: Managing the default branch name for repositories in your organization -intro: You can set the default branch name for repositories that members create in your organization. +title: 管理组织中仓库的默认分支名称 +intro: 'You can set the default branch name for repositories that members create in your organization.' +permissions: Managing the default branch name for your repositories versions: free-pro-team: '*' enterprise-server: '>=2.23' @@ -8,27 +9,25 @@ versions: ### About the default branch name -When a member of your organization creates a new repository, {% data variables.product.prodname_dotcom %} will create a single branch and set it as the repository's default branch. {% data variables.product.prodname_dotcom %} currently names the default branch `master`, but you can set the default branch to be named anything that makes sense for your development environment. +When a member of your organization creates a new repository in your organization, the repository contains one branch, which is the default branch. When a member of your organization creates a new repository, {% data variables.product.prodname_dotcom %} will create a single branch and set it as the repository's default branch. {% data variables.product.prodname_dotcom %} currently names the default branch `master`, but you can set the default branch to be named anything that makes sense for your development environment. For more information about the default branch, see "[About branches](/github/collaborating-with-issues-and-pull-requests/about-branches#about-the-default-branch)." {% data reusables.branches.set-default-branch %} -{% data reusables.branches.rename-existing-branch %} - -### Setting the default branch name +### 设置默认分支名称 {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.repository-defaults %} -3. Under "Repository default branch", click **Change default branch name now**. ![Override button](/assets/images/help/organizations/repo-default-name-button.png) +3. 在“Repository default branch（仓库默认分支）”下，单击 **Change default branch name now（立即更改默认分支名称）**。 ![覆盖按钮](/assets/images/help/organizations/repo-default-name-button.png) {% note %} - **Note:** If your enterprise owner has enforced a policy for the default name, you won't be able to change it here. You will be able to set the default branch on individual repositories. For more information, see "[Enforcing a policy on the default branch name](/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account#enforcing-a-policy-on-the-default-branch-name)" and "[Setting the default branch](/github/administering-a-repository/setting-the-default-branch)." + **注：**如果企业所有者已强制实施默认名称策略，您将无法在此处更改它。 您将能够在单个仓库中设置默认分支。 **Note:** If your enterprise owner has enforced a policy for the default name, you won't be able to change it here. You will be able to set the default branch on individual repositories. For more information, see "[Enforcing a policy on the default branch name](/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account#enforcing-a-policy-on-the-default-branch-name)" and "[Setting the default branch](/github/administering-a-repository/setting-the-default-branch)." {% endnote %} -4. Type the default name that you would like to use for new branches. ![Text box for entering default name](/assets/images/help/organizations/repo-default-name-text.png) -5. Click **Update**. ![Update button](/assets/images/help/organizations/repo-default-name-update.png) +4. 键入要用于新分支的默认名称。 ![输入默认名称的文本框](/assets/images/help/organizations/repo-default-name-text.png) +5. 单击 **Update（更新）**。 ![更新按钮](/assets/images/help/organizations/repo-default-name-update.png) ### 延伸阅读 -- [Managing the default branch name for your repositories](/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories) +- /github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md index 75803632d58e..bdd6978ea218 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-the-display-of-member-names-in-your-organization.md @@ -6,7 +6,7 @@ redirect_from: - /articles/managing-the-display-of-member-names-in-your-organization versions: free-pro-team: '*' - enterprise-server: '>=2.18' + enterprise-server: '*' --- 组织所有者可管理组织中成员名称的显示。 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization.md index b02d824efce7..034e5ca7ed77 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization.md @@ -1,6 +1,6 @@ --- title: 管理组织的复刻政策 -intro: '您可以允许或阻止对组织拥有的任何私有{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}和内部{% endif %}仓库进行复刻。' +intro: 'You can can allow or prevent the forking of any private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and internal{% endif %} repositories owned by your organization.' redirect_from: - /articles/allowing-people-to-fork-private-repositories-in-your-organization - /github/setting-up-and-managing-organizations-and-teams/allowing-people-to-fork-private-repositories-in-your-organization @@ -10,9 +10,9 @@ versions: enterprise-server: '*' --- -默认情况下，新的组织被配置为禁止复刻私有{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}和内部{% endif %}仓库。 +By default, new organizations are configured to disallow the forking of private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and internal{% endif %} repositories. -如果您在组织级别上允许复刻私有{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}和内部{% endif %}仓库，则还可以配置复刻特定{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}或内部{% endif %}仓库的能力。 更多信息请参阅“[管理仓库的复刻政策](/github/administering-a-repository/managing-the-forking-policy-for-your-repository)”。 +If you allow forking of private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and internal{% endif %} repositories at the organization level, you can also configure the ability to fork a specific private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %} repository. 更多信息请参阅“[管理仓库的复刻政策](/github/administering-a-repository/managing-the-forking-policy-for-your-repository)”。 {% data reusables.organizations.internal-repos-enterprise %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md index 37d758051c16..6b03bdeb928e 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/managing-your-organizations-ssh-certificate-authorities.md @@ -6,7 +6,7 @@ redirect_from: - /articles/managing-your-organizations-ssh-certificate-authorities versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- 组织所有者可以管理组织的 SSH 认证中心 (CA)。 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/migrating-admin-teams-to-improved-organization-permissions.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/migrating-admin-teams-to-improved-organization-permissions.md index 7ccce32189a9..cdf6a33fc077 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/migrating-admin-teams-to-improved-organization-permissions.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/migrating-admin-teams-to-improved-organization-permissions.md @@ -1,6 +1,6 @@ --- title: 将管理团队迁移到改进的组织权限 -intro: 如果您的组织是在 2015 年 9 月之后创建的，则您的组织默认具有改进的组织权限。 在 2015 年 9 月之前创建的组织可能需要将较旧的所有者和管理员团队迁移到改进的权限模型。 旧管理员团队的成员在其团队被迁移到改进的组织权限模型之前，自动保留创建仓库的权限。 +intro: '如果您的组织是在 2015 年 9 月之后创建的，则您的组织默认具有改进的组织权限。 在 2015 年 9 月之前创建的组织可能需要将较旧的所有者和管理员团队迁移到改进的权限模型。 旧管理员团队的成员在其团队被迁移到改进的组织权限模型之前，自动保留创建仓库的权限。' redirect_from: - /articles/migrating-your-previous-admin-teams-to-the-improved-organization-permissions/ - /articles/migrating-admin-teams-to-improved-organization-permissions diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/migrating-to-improved-organization-permissions.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/migrating-to-improved-organization-permissions.md index dc4dacad279d..61e7a9fa4f94 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/migrating-to-improved-organization-permissions.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/migrating-to-improved-organization-permissions.md @@ -1,6 +1,6 @@ --- title: 迁移到改进的组织权限 -intro: 如果您的组织是在 2015 年 9 月之后创建的，则您的组织默认包括改进的组织权限。 在 2015 年 9 月之前创建的组织可能需要将较旧的所有者和管理员团队迁移到改进的组织权限模型。 +intro: '如果您的组织是在 2015 年 9 月之后创建的，则您的组织默认包括改进的组织权限。 在 2015 年 9 月之前创建的组织可能需要将较旧的所有者和管理员团队迁移到改进的组织权限模型。' mapTopic: true redirect_from: - /articles/improved-organization-permissions/ diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/moving-a-team-in-your-organizations-hierarchy.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/moving-a-team-in-your-organizations-hierarchy.md index d83cc651da2e..e3cb4d10be8b 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/moving-a-team-in-your-organizations-hierarchy.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/moving-a-team-in-your-organizations-hierarchy.md @@ -1,6 +1,6 @@ --- title: 在组织的层次结构中移动团队 -intro: 团队维护员和组织所有者可以在父团队下嵌套团队，或者更改或删除已嵌套团队的父团队。 +intro: '团队维护员和组织所有者可以在父团队下嵌套团队，或者更改或删除已嵌套团队的父团队。' redirect_from: - /articles/changing-a-team-s-parent/ - /articles/moving-a-team-in-your-organization-s-hierarchy @@ -28,7 +28,7 @@ versions: 4. 在团队列表中，单击您要更改其父团队的团队名称。 ![组织的团队列表](/assets/images/help/teams/click-team-name.png) {% data reusables.organizations.team_settings %} 6. 使用下拉菜单选择父团队，要删除现有团队，则选择 **Clear selected value（清除所选值）**。 ![列出组织团队的下拉菜单](/assets/images/help/teams/choose-parent-team.png) -7. Click **Update**. +7. 单击 **Update（更新）**。 {% data reusables.repositories.changed-repository-access-permissions %} 9. 单击 **Confirm new parent team（确认新的父团队）**。 ![包含仓库访问权限更改相关信息的模态框](/assets/images/help/teams/confirm-new-parent-team.png) diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md index 2cd2383f7bef..ae4469f41a5d 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization.md @@ -11,7 +11,7 @@ versions: ### 组织的权限级别 -组织成员可以是*所有者*{% if currentVersion == "free-pro-team@latest" %}、*帐单管理员*{% endif %}或*成员*角色： +Organization members can have *owner*{% if currentVersion == "free-pro-team@latest" %}, *billing manager*,{% endif %} or *member* roles: - **所有者**对组织具有全面的管理权限。 此角色应限于组织中的少数几个人，但不少于两人。 更多信息请参阅“[管理组织的所有权连续性](/github/setting-up-and-managing-organizations-and-teams/maintaining-ownership-continuity-for-your-organization)”。 {% if currentVersion == "free-pro-team@latest" %} @@ -22,102 +22,103 @@ versions: {% if currentVersion == "free-pro-team@latest" %} -| 组织操作 | 所有者 | 成员 | 帐单管理员 | -|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-----:|:-----:|:----------------------------------:| -| 创建仓库（详细信息请参阅“[限制在组织中创建仓库](/articles/restricting-repository-creation-in-your-organization)”） | **X** | **X** | | -| 查看和编辑帐单信息 | **X** | | **X** | -| 邀请人员加入组织 | **X** | | | -| 编辑和取消邀请加入组织 | **X** | | | -| 从组织删除成员 | **X** | | | -| 恢复组织的前成员 | **X** | | | -| 添加和删除**所有团队**的人员 | **X** | | | -| 将组织成员升级为*团队维护员* | **X** | | | -| 配置代码审查分配（请参阅“[管理团队的代码审查分配](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)”） | **X** | | | -| 设置预定提醒（请参阅“[管理拉取请求的预定提醒](/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests)”） | **X** | | | -| 添加协作者到**所有仓库** | **X** | | | -| 访问组织审核日志 | **X** | | | -| 编辑组织的资料页面（详细信息请参阅“[关于组织的资料](/articles/about-your-organization-s-profile)”） | **X** | | | -| 验证组织的域（详细信息请参阅“[验证组织的域](/articles/verifying-your-organization-s-domain)”） | **X** | | | -| 删除**所有团队** | **X** | | | -| 删除组织帐户，包括所有仓库 | **X** | | | -| 创建团队（详细信息请参阅“[在组织中设置团队创建权限](/articles/setting-team-creation-permissions-in-your-organization)”） | **X** | **X** | | -| [在组织的层次结构中移动团队](/articles/moving-a-team-in-your-organization-s-hierarchy) | **X** | | | -| 创建项目板（详细信息请参阅“[组织的项目板权限](/articles/project-board-permissions-for-an-organization)”） | **X** | **X** | | -| 查看所有组织成员和团队 | **X** | **X** | | -| @提及任何可见团队 | **X** | **X** | | -| 可成为*团队维护员* | **X** | **X** | | -| 查看组织洞见（详细信息请参阅“[查看用于组织的洞见](/articles/viewing-insights-for-your-organization)”） | **X** | **X** | | -| 查看并发布公共团队讨论到**所有团队**（详细信息请参阅“[关于团队讨论](/articles/about-team-discussions)”） | **X** | **X** | | -| 查看并发布私有团队讨论到**所有团队**（详细信息请参阅“[关于团队讨论](/articles/about-team-discussions)”） | **X** | | | -| 编辑和删除**所有团队**的团队讨论（详细信息请参阅“[管理破坏性评论](/articles/managing-disruptive-comments)”） | **X** | | | -| 隐藏对提交、拉取请求和议题的评论（详细信息请参阅“[管理破坏性评论](/articles/managing-disruptive-comments/#hiding-a-comment)”） | **X** | **X** | | -| 对组织禁用团队讨论（详细信息请参阅“[对组织禁用团队讨论](/articles/disabling-team-discussions-for-your-organization)”） | **X** | | |{% if currentVersion == "free-pro-team@latest" %} -| 管理组织依赖项洞见的显示（详细信息请参阅“[更改组织依赖项洞见的可见性](/articles/changing-the-visibility-of-your-organizations-dependency-insights)”） | **X** | | |{% endif %} -| 设置**所有团队**的团队头像（详细信息请参阅“[设置团队的头像](/articles/setting-your-team-s-profile-picture)”） | **X** | | | -| Disable publication of {% data variables.product.prodname_pages %} sites from repositories in the organization (see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)" for details) | **X** | | | -| 管理安全性和分析设置（详情请参阅“[管理组织的安全性和分析设置](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization)”） | **X** | | | -| 启用并实施 [SAML 单点登录](/articles/about-identity-and-access-management-with-saml-single-sign-on) | **X** | | | -| [管理用户对组织的 SAML 访问](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization) | **X** | | | -| 管理组织的 SSH 认证中心（详细信息请参阅“[管理组织的 SSH 认证中心](/articles/managing-your-organizations-ssh-certificate-authorities)”） | **X** | | | -| 转让仓库 | **X** | | | -| 购买、安装、管理其帐单以及取消 {% data variables.product.prodname_marketplace %} 应用程序 | **X** | | | -| 列出 {% data variables.product.prodname_marketplace %} 中的应用程序 | **X** | | | -| 接收所有组织仓库[关于易受攻击的依赖项的 {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) | **X** | | | -| 管理 {% data variables.product.prodname_dependabot_security_updates %}（请参阅“[配置 {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)”） | **X** | | | -| [管理复刻策略](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization) | **X** | | | -| [限制组织中公共仓库的活动](/articles/limiting-interactions-in-your-organization) | **X** | | | -| 拉取（读取）、推送（写入）和克隆（复制）组织中的*所有仓库* | **X** | | | -| 将组织成员转换为[外部协作者](#outside-collaborators) | **X** | | | -| [查看对组织仓库具有访问权限的人员](/articles/viewing-people-with-access-to-your-repository) | **X** | | | -| [导出具有组织仓库访问权限人员的列表](/articles/viewing-people-with-access-to-your-repository/#exporting-a-list-of-people-with-access-to-your-repository) | **X** | | | -| 管理默认标签（请参阅“[管理组织中仓库的默认标签](/articles/managing-default-labels-for-repositories-in-your-organization)”） | **X** | | | -| 启用团队同步（详情请参阅“[管理组织的团队同步](/github/setting-up-and-managing-organizations-and-teams/managing-team-synchronization-for-your-organization)”） | **X** | | | +| 组织操作 | 所有者 | 成员 | 帐单管理员 | +|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-----:|:-----:|:--------------------------------------------------:| +| 创建仓库（详细信息请参阅“[限制在组织中创建仓库](/articles/restricting-repository-creation-in-your-organization)”） | **X** | **X** | | +| 查看和编辑帐单信息 | **X** | | **X** | +| 邀请人员加入组织 | **X** | | | +| 编辑和取消邀请加入组织 | **X** | | | +| 从组织删除成员 | **X** | | | +| 恢复组织的前成员 | **X** | | | +| 添加和删除**所有团队**的人员 | **X** | | | +| 将组织成员升级为*团队维护员* | **X** | | | +| 配置代码审查分配（请参阅“[管理团队的代码审查分配](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)”） | **X** | | | +| 设置预定提醒（请参阅“[管理拉取请求的预定提醒](/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests)”） | **X** | | | +| 添加协作者到**所有仓库** | **X** | | | +| 访问组织审核日志 | **X** | | | +| 编辑组织的资料页面（详细信息请参阅“[关于组织的资料](/articles/about-your-organization-s-profile)”） | **X** | | | +| 验证组织的域（详细信息请参阅“[验证组织的域](/articles/verifying-your-organization-s-domain)”） | **X** | | | +| 删除**所有团队** | **X** | | | +| 删除组织帐户，包括所有仓库 | **X** | | | +| 创建团队（详细信息请参阅“[在组织中设置团队创建权限](/articles/setting-team-creation-permissions-in-your-organization)”） | **X** | **X** | | +| [在组织的层次结构中移动团队](/articles/moving-a-team-in-your-organization-s-hierarchy) | **X** | | | +| 创建项目板（详细信息请参阅“[组织的项目板权限](/articles/project-board-permissions-for-an-organization)”） | **X** | **X** | | +| 查看所有组织成员和团队 | **X** | **X** | | +| @提及任何可见团队 | **X** | **X** | | +| 可成为*团队维护员* | **X** | **X** | | +| 查看组织洞见（详细信息请参阅“[查看用于组织的洞见](/articles/viewing-insights-for-your-organization)”） | **X** | **X** | | +| 查看并发布公共团队讨论到**所有团队**（详细信息请参阅“[关于团队讨论](/articles/about-team-discussions)”） | **X** | **X** | | +| 查看并发布私有团队讨论到**所有团队**（详细信息请参阅“[关于团队讨论](/articles/about-team-discussions)”） | **X** | | | +| 编辑和删除**所有团队**的团队讨论（详细信息请参阅“[管理破坏性评论](/articles/managing-disruptive-comments)”） | **X** | | | +| 隐藏对提交、拉取请求和议题的评论（详细信息请参阅“[管理破坏性评论](/articles/managing-disruptive-comments/#hiding-a-comment)”） | **X** | **X** | | +| 对组织禁用团队讨论（详细信息请参阅“[对组织禁用团队讨论](/articles/disabling-team-discussions-for-your-organization)”） | **X** | | |{% if currentVersion == "free-pro-team@latest" %} +| 管理组织依赖项洞见的显示（详细信息请参阅“[更改组织依赖项洞见的可见性](/articles/changing-the-visibility-of-your-organizations-dependency-insights)”） | **X** | | |{% endif %} +| 设置**所有团队**的团队头像（详细信息请参阅“[设置团队的头像](/articles/setting-your-team-s-profile-picture)”） | **X** | | | +| 禁止从组织中的仓库发布 {% data variables.product.prodname_pages %} 站点（请参阅“[为组织禁止发布 {% data variables.product.prodname_pages %} 站点](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)”了解详细信息） | **X** | | | +| 管理安全性和分析设置（详情请参阅“[管理组织的安全性和分析设置](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization)”） | **X** | | | +| 启用并实施 [SAML 单点登录](/articles/about-identity-and-access-management-with-saml-single-sign-on) | **X** | | | +| [管理用户对组织的 SAML 访问](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization) | **X** | | | +| 管理组织的 SSH 认证中心（详细信息请参阅“[管理组织的 SSH 认证中心](/articles/managing-your-organizations-ssh-certificate-authorities)”） | **X** | | | +| 转让仓库 | **X** | | | +| 购买、安装、管理其帐单以及取消 {% data variables.product.prodname_marketplace %} 应用程序 | **X** | | | +| 列出 {% data variables.product.prodname_marketplace %} 中的应用程序 | **X** | | | +| 接收所有组织仓库[关于易受攻击的依赖项的 {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) | **X** | | | +| 管理 {% data variables.product.prodname_dependabot_security_updates %}（请参阅“[配置 {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)”） | **X** | | | +| [管理复刻策略](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization) | **X** | | | +| [限制组织中公共仓库的活动](/articles/limiting-interactions-in-your-organization) | **X** | | | +| 拉取（读取）、推送（写入）和克隆（复制）组织中的*所有仓库* | **X** | | | +| 将组织成员转换为[外部协作者](#outside-collaborators) | **X** | | | +| [查看对组织仓库具有访问权限的人员](/articles/viewing-people-with-access-to-your-repository) | **X** | | | +| [导出具有组织仓库访问权限人员的列表](/articles/viewing-people-with-access-to-your-repository/#exporting-a-list-of-people-with-access-to-your-repository) | **X** | | | +| 管理默认标签（请参阅“[管理组织中仓库的默认标签](/articles/managing-default-labels-for-repositories-in-your-organization)”） | **X** | | | +| 管理默认标签（请参阅“[管理组织中仓库的默认标签](/articles/managing-default-labels-for-repositories-in-your-organization)”） | **X** | | | +| 启用团队同步（详情请参阅“[管理组织的团队同步](/github/setting-up-and-managing-organizations-and-teams/managing-team-synchronization-for-your-organization)”） | **X** | | | {% else %} -| 组织操作 | 所有者 | 成员 | -|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-----:|:---------------------------------------:| -| 邀请人员加入组织 | **X** | | -| 编辑和取消邀请加入组织 | **X** | | -| 从组织删除成员 | **X** | | | -| 恢复组织的前成员 | **X** | | | -| 添加和删除**所有团队**的人员 | **X** | | -| 将组织成员升级为*团队维护员* | **X** | |{% if currentVersion ver_gt "enterprise-server@2.19" %} -| 配置代码审查分配（请参阅“[管理团队的代码审查分配](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)”） | **X** | |{% endif %} -| 添加协作者到**所有仓库** | **X** | | -| 访问组织审核日志 | **X** | | -| 编辑组织的资料页面（详细信息请参阅“[关于组织的资料](/articles/about-your-organization-s-profile)”） | **X** | | | -| 删除**所有团队** | **X** | | -| 删除组织帐户，包括所有仓库 | **X** | | -| 创建团队（详细信息请参阅“[在组织中设置团队创建权限](/articles/setting-team-creation-permissions-in-your-organization)”） | **X** | **X** | -| 查看所有组织成员和团队 | **X** | **X** | -| @提及任何可见团队 | **X** | **X** | -| 可成为*团队维护员* | **X** | **X** | -| 转让仓库 | **X** | |{% if currentVersion ver_gt "enterprise-server@2.18" %} -| 管理组织的 SSH 认证中心（详细信息请参阅“[管理组织的 SSH 认证中心](/articles/managing-your-organizations-ssh-certificate-authorities)”） | **X** | |{% endif %} -| 创建项目板（详细信息请参阅“[组织的项目板权限](/articles/project-board-permissions-for-an-organization)”） | **X** | **X** | | -| 查看并发布公共团队讨论到**所有团队**（详细信息请参阅“[关于团队讨论](/articles/about-team-discussions)”） | **X** | **X** | | -| 查看并发布私有团队讨论到**所有团队**（详细信息请参阅“[关于团队讨论](/articles/about-team-discussions)”） | **X** | | | -| 编辑和删除**所有团队**中的团队讨论（更多信息请参阅“[管理破坏性评论](/articles/managing-disruptive-comments)” | **X** | | | -| 隐藏对提交、拉取请求和议题的评论（详细信息请参阅“[管理破坏性评论](/articles/managing-disruptive-comments/#hiding-a-comment)”） | **X** | **X** | **X** | -| 对组织禁用团队讨论（详细信息请参阅“[对组织禁用团队讨论](/articles/disabling-team-discussions-for-your-organization)”） | **X** | | | -| 设置**所有团队**的团队头像（详细信息请参阅“[设置团队的头像](/articles/setting-your-team-s-profile-picture)”） | **X** | | |{% if currentVersion ver_gt "enterprise-server@2.22" %} -| Disable publication of {% data variables.product.prodname_pages %} sites from repositories in the organization (see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)" for details) | **X** | | |{% endif %} -| [在组织的层次结构中移动团队](/articles/moving-a-team-in-your-organization-s-hierarchy) | **X** | | | -| 拉取（读取）、推送（写入）和克隆（复制）组织中的*所有仓库* | **X** | | -| 将组织成员转换为[外部协作者](#outside-collaborators) | **X** | | -| [查看对组织仓库具有访问权限的人员](/articles/viewing-people-with-access-to-your-repository) | **X** | | -| [导出具有组织仓库访问权限人员的列表](/articles/viewing-people-with-access-to-your-repository/#exporting-a-list-of-people-with-access-to-your-repository) | **X** | |{% if currentVersion ver_gt "enterprise-server@2.19" %} -| 管理默认标签（请参阅“[管理组织中仓库的默认标签](/articles/managing-default-labels-for-repositories-in-your-organization)”） | **X** | |{% endif %} +| 组织操作 | 所有者 | 成员 | +|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-----:|:-----------------------------------------------------------:| +| 邀请人员加入组织 | **X** | | +| 编辑和取消邀请加入组织 | **X** | | +| 从组织删除成员 | **X** | | | +| 恢复组织的前成员 | **X** | | | +| 添加和删除**所有团队**的人员 | **X** | | +| 将组织成员升级为*团队维护员* | **X** | |{% if currentVersion ver_gt "enterprise-server@2.19" %} +| 配置代码审查分配（请参阅“[管理团队的代码审查分配](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team)”） | **X** | |{% endif %} +| 添加协作者到**所有仓库** | **X** | | +| 访问组织审核日志 | **X** | | +| 编辑组织的资料页面（详细信息请参阅“[关于组织的资料](/articles/about-your-organization-s-profile)”） | **X** | | | +| 删除**所有团队** | **X** | | +| 删除组织帐户，包括所有仓库 | **X** | | +| 创建团队（详细信息请参阅“[在组织中设置团队创建权限](/articles/setting-team-creation-permissions-in-your-organization)”） | **X** | **X** | +| 查看所有组织成员和团队 | **X** | **X** | +| @提及任何可见团队 | **X** | **X** | +| 可成为*团队维护员* | **X** | **X** | +| 转让仓库 | **X** | | +| 管理组织的 SSH 认证中心（详细信息请参阅“[管理组织的 SSH 认证中心](/articles/managing-your-organizations-ssh-certificate-authorities)”） | **X** | | +| 创建项目板（详细信息请参阅“[组织的项目板权限](/articles/project-board-permissions-for-an-organization)”） | **X** | **X** | | +| 查看并发布公共团队讨论到**所有团队**（详细信息请参阅“[关于团队讨论](/articles/about-team-discussions)”） | **X** | **X** | | +| 查看并发布私有团队讨论到**所有团队**（详细信息请参阅“[关于团队讨论](/articles/about-team-discussions)”） | **X** | | | +| 编辑和删除**所有团队**中的团队讨论（更多信息请参阅“[管理破坏性评论](/articles/managing-disruptive-comments)” | **X** | | | +| 隐藏对提交、拉取请求和议题的评论（详细信息请参阅“[管理破坏性评论](/articles/managing-disruptive-comments/#hiding-a-comment)”） | **X** | **X** | **X** | +| 对组织禁用团队讨论（详细信息请参阅“[对组织禁用团队讨论](/articles/disabling-team-discussions-for-your-organization)”） | **X** | | | +| 设置**所有团队**的团队头像（详细信息请参阅“[设置团队的头像](/articles/setting-your-team-s-profile-picture)”） | **X** | | |{% if currentVersion ver_gt "enterprise-server@2.22" %} +| 禁止从组织中的仓库发布 {% data variables.product.prodname_pages %} 站点（请参阅“[为组织禁止发布 {% data variables.product.prodname_pages %} 站点](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)”了解详细信息） | **X** | | |{% endif %} +| [在组织的层次结构中移动团队](/articles/moving-a-team-in-your-organization-s-hierarchy) | **X** | | | +| 拉取（读取）、推送（写入）和克隆（复制）组织中的*所有仓库* | **X** | | +| 将组织成员转换为[外部协作者](#outside-collaborators) | **X** | | +| [查看对组织仓库具有访问权限的人员](/articles/viewing-people-with-access-to-your-repository) | **X** | | +| [导出具有组织仓库访问权限人员的列表](/articles/viewing-people-with-access-to-your-repository/#exporting-a-list-of-people-with-access-to-your-repository) | **X** | |{% if currentVersion ver_gt "enterprise-server@2.19" %} +| 管理默认标签（请参阅“[管理组织中仓库的默认标签](/articles/managing-default-labels-for-repositories-in-your-organization)”） | **X** | |{% endif %} {% endif %} ### {% data variables.product.prodname_github_app %} 管理员 -By default, only organization owners can manage the settings of {% data variables.product.prodname_github_app %}s owned by an organization. To allow additional users to manage {% data variables.product.prodname_github_app %}s owned by an organization, an owner can grant them {% data variables.product.prodname_github_app %} manager permissions. +默认情况下，只有组织所有者才可管理组织拥有的 {% data variables.product.prodname_github_app %} 的设置。 要允许其他用户管理组织拥有的 {% data variables.product.prodname_github_app %}，所有者可向他们授予 {% data variables.product.prodname_github_app %} 管理员权限。 -When you designate a user as a {% data variables.product.prodname_github_app %} manager in your organization, you can grant them access to manage the settings of some or all {% data variables.product.prodname_github_app %}s owned by the organization. 更多信息请参阅： +指定用户为组织中 {% data variables.product.prodname_github_app %} 的管理员时，您可以授予他们对组织拥有的部分或全部 {% data variables.product.prodname_github_app %} 的设置进行管理的权限。 更多信息请参阅： - "[为组织添加 GitHub 应用程序管理员](/articles/adding-github-app-managers-in-your-organization)" - "[从组织删除 GitHub 应用程序管理员](/articles/removing-github-app-managers-from-your-organization)" diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-enforce-saml-single-sign-on-in-your-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-enforce-saml-single-sign-on-in-your-organization.md index ed086659372f..8e21804b63d0 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-enforce-saml-single-sign-on-in-your-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-enforce-saml-single-sign-on-in-your-organization.md @@ -1,6 +1,6 @@ --- title: 准备在组织中实施 SAML 单点登录 -intro: 在组织中实施 SAML 单点登录之前，应验证组织的成员资格，并配置到身份提供程序的连接设置。 +intro: '在组织中实施 SAML 单点登录之前，应验证组织的成员资格，并配置到身份提供程序的连接设置。' product: '{% data reusables.gated-features.saml-sso %}' redirect_from: - /articles/preparing-to-enforce-saml-single-sign-on-in-your-organization diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-require-two-factor-authentication-in-your-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-require-two-factor-authentication-in-your-organization.md index fba8ea3a2a40..a530f0c3429f 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-require-two-factor-authentication-in-your-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/preparing-to-require-two-factor-authentication-in-your-organization.md @@ -1,6 +1,6 @@ --- title: 准备在组织中要求双重身份验证 -intro: 在要求双重身份验证 (2FA) 之前，您可以向用户通知即将发生的更改，并验证谁已使用 2FA。 +intro: '在要求双重身份验证 (2FA) 之前，您可以向用户通知即将发生的更改，并验证谁已使用 2FA。' redirect_from: - /articles/preparing-to-require-two-factor-authentication-in-your-organization versions: @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -如果您的组织中需要 2FA，建议至少提前一周通知{% if currentVersion == "free-pro-team@latest" %}组织成员、外部协作者和帐单管理员{% else %}组织成员和外部协作者{% endif %}。 +We recommend that you notify {% if currentVersion == "free-pro-team@latest" %}organization members, outside collaborators, and billing managers{% else %}organization members and outside collaborators{% endif %} at least one week before you require 2FA in your organization. 需要对您的组织使用双重身份验证时，不使用 2FA 的成员、外部协作者和帐单管理员（包括自动程序帐户）将从组织中删除，并且失去访问其仓库的权限。 他们还会失去对组织私有仓库的复刻的访问权限。 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/project-board-permissions-for-an-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/project-board-permissions-for-an-organization.md index c9dc85af240f..5ce6395c542b 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/project-board-permissions-for-an-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/project-board-permissions-for-an-organization.md @@ -1,6 +1,6 @@ --- title: 组织的项目板权限 -intro: 组织所有者以及具有项目板管理员权限的人员能够自定义谁对您组织的项目板具有读取、写入和管理员权限。 +intro: '组织所有者以及具有项目板管理员权限的人员能够自定义谁对您组织的项目板具有读取、写入和管理员权限。' redirect_from: - /articles/project-board-permissions-for-an-organization versions: diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-member-of-your-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-member-of-your-organization.md index e7597c5502a3..39b20c8b9f95 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-member-of-your-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-member-of-your-organization.md @@ -1,6 +1,6 @@ --- title: 恢复组织的前成员 -intro: '组织所有者可以{% if currentVersion == "free-pro-team@latest" %}邀请前组织成员重新加入{% else %}将前成员添加到{% endif%}您的组织，并可选择是否恢复该人员以前的角色、访问权限、复刻和设置。' +intro: 'Organization owners can {% if currentVersion == "free-pro-team@latest" %}invite former organization members to rejoin{% else %}add former members to{% endif%} your organization, and choose whether to restore the person''s former role, access permissions, forks, and settings.' redirect_from: - /articles/reinstating-a-former-member-of-your-organization versions: @@ -8,7 +8,7 @@ versions: enterprise-server: '*' --- -如果您[从组织中删除用户](/articles/removing-a-member-from-your-organization)、[将组织成员转换为外部协作者](/articles/converting-an-organization-member-to-an-outside-collaborator)或者由于您[要求成员和外部协作者启用双因素身份验证 (2FA)](/articles/requiring-two-factor-authentication-in-your-organization) 而从组织中删除用户，则用户的访问权限和设置将保存三个月。 如果您在该时间范围内将用户{% if currentVersion =="free-pro-team@latest" %}邀请{% else %}添加{% endif %}回组织，则可以恢复该用户的权限。 +如果您[从组织中删除用户](/articles/removing-a-member-from-your-organization)、[将组织成员转换为外部协作者](/articles/converting-an-organization-member-to-an-outside-collaborator)或者由于您[要求成员和外部协作者启用双因素身份验证 (2FA)](/articles/requiring-two-factor-authentication-in-your-organization) 而从组织中删除用户，则用户的访问权限和设置将保存三个月。 You can restore the user's privileges if you {% if currentVersion =="free-pro-team@latest" %}invite{% else %}add{% endif %} them back to the organization within that time frame. {% data reusables.two_fa.send-invite-to-reinstate-user-before-2fa-is-enabled %} @@ -24,13 +24,13 @@ versions: {% tip %} {% if currentVersion == "free-pro-team@latest" %} - **Tips**: + **提示**： - 如果组织成员由于未使用双因素身份验证已从组织中删除，并且您的组织仍要求成员使用 2FA，则前成员必须启用双因素身份验证，然后才能恢复其成员身份。 - 仅组织所有者才可邀请用户加入组织。 更多信息请参阅“[组织的权限级别](/articles/permission-levels-for-an-organization)”。 - 如果您的组织采用付费的每用户订阅，则必须有未使用的许可才可恢复前组织成员。 更多信息请参阅“[关于每用户定价](/articles/about-per-user-pricing)”。 {% data reusables.organizations.org-invite-expiration %} {% else %} - **Tips**: + **提示**： - 如果组织成员由于未使用双因素身份验证已从组织中删除，并且您的组织仍要求成员使用 2FA，则前成员必须启用双因素身份验证，然后才能恢复其成员身份。 - 仅组织所有者才可将用户添加到组织。 更多信息请参阅“[组织的权限级别](/articles/permission-levels-for-an-organization)”。 {% endif %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-outside-collaborators-access-to-your-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-outside-collaborators-access-to-your-organization.md index fb041c53fbe9..90f63f350be0 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-outside-collaborators-access-to-your-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/reinstating-a-former-outside-collaborators-access-to-your-organization.md @@ -1,6 +1,6 @@ --- -title: 恢复前外部协作者对组织的访问权限 -intro: 如果您的组织中需要双因素身份验证，并且已从组织中删除了未启用 2FA 的外部协作者，则可以恢复前外部协作者对组织仓库、复刻和设置的访问权限。 +title: Reinstating a former outside collaborator's access to your organization +intro: 'If you required two-factor authentication in your organization and an outside collaborator was removed from the organization for not having 2FA enabled, you can reinstate a former outside collaborator''s access permissions for organization repositories, forks, and settings.' redirect_from: - /articles/reinstating-a-former-outside-collaborator-s-access-to-your-organization - /articles/reinstating-a-former-outside-collaborators-access-to-your-organization @@ -9,25 +9,25 @@ versions: enterprise-server: '*' --- -如果由于您[要求成员和外部协作者启用双因素身份验证](/articles/requiring-two-factor-authentication-in-your-organization)而删除了外部协作者对您组织私有仓库的访问权限，则用户的访问权限和设置将保存三个月。 如果您在该时间范围内将用户{% if currentVersion == "free-pro-team@latest" %}邀请{% else %}添加{% endif %}回组织，则可以恢复该用户的权限。 +If an outside collaborator's access to your organization's private repositories is removed because you've [required members and outside collaborators to enable two-factor authentication](/articles/requiring-two-factor-authentication-in-your-organization), the user's access privileges and settings are saved for three months. You can restore the user's privileges if you {% if currentVersion == "free-pro-team@latest" %}invite{% else %}add{% endif %} them back to the organization within that time frame. {% data reusables.two_fa.send-invite-to-reinstate-user-before-2fa-is-enabled %} -恢复前外部协作者时，您可以恢复以下各项： - - 用户对组织仓库以前的访问权限 - - 组织拥有的仓库的任何私有复刻 - - 组织团队的成员身份 - - 组织仓库以前的访问权限和权限 - - 组织仓库的星标 - - 组织中的议题分配 - - 仓库订阅（关注、不关注或忽略仓库活动的通知设置） +When you reinstate a former outside collaborator, you can restore: + - The user's former access to organization repositories + - Any private forks of repositories owned by the organization + - Membership in the organization's teams + - Previous access and permissions for the organization's repositories + - Stars for organization repositories + - Issue assignments in the organization + - Repository subscriptions (notification settings for watching, not watching, or ignoring a repository's activity) {% tip %} **Tips**: - - 只有组织所有者才能恢复外部协作者对组织的访问权限。 更多信息请参阅“[组织的权限级别](/articles/permission-levels-for-an-organization)”。 - - 恢复 {% data variables.product.product_location %} 上的成员流量可以使用术语“成员”来描述恢复外部协作者，但如果您恢复此人员并保留其以前的权限，则他们将只拥有以前的[外部协作者权限](/articles/permission-levels-for-an-organization/#outside-collaborators)。{% if currentVersion == "free-pro-team@latest" %} - - 如果您的组织采用付费的每用户订阅，则必须有未使用的许可才可邀请新成员加入组织或恢复前组织成员。 更多信息请参阅“[关于每用户定价](/articles/about-per-user-pricing)”。{% endif %} + - Only organization owners can reinstate outside collaborators' access to an organization. For more information, see "[Permission levels for an organization](/articles/permission-levels-for-an-organization)." + - The reinstating a member flow on {% data variables.product.product_location %} may use the term "member" to describe reinstating an outside collaborator but if you reinstate this person and keep their previous privileges, they will only have their previous [outside collaborator permissions](/articles/permission-levels-for-an-organization/#outside-collaborators).{% if currentVersion == "free-pro-team@latest" %} + - If your organization has a paid per-user subscription, an unused license must be available before you can invite a new member to join the organization or reinstate a former organization member. For more information, see "[About per-user pricing](/articles/about-per-user-pricing)."{% endif %} {% endtip %} @@ -37,35 +37,37 @@ versions: {% data reusables.organizations.invite_member_from_people_tab %} {% data reusables.organizations.reinstate-user-type-username %} {% if currentVersion == "free-pro-team@latest" %} -6. 通过单击 **Invite and reinstate（邀请并恢复）**选择恢复外部协作者在组织中以前的权限，或通过单击 **Invite and start fresh（邀请并重新开始）**选择清除其以前的权限并设置新的访问权限。 +6. Choose to restore the outside collaborator's previous privileges in the organization by clicking **Invite and reinstate** or choose to clear their previous privileges and set new access permissions by clicking **Invite and start fresh**. {% warning %} - **警告：**如果想要将外部协作者升级为组织成员，则选择 **Invite and start fresh（邀请并重新开始）**，然后为此人员选择新角色。 但是，请注意，如果您选择重新开始，则此人员组织仓库的私人复刻将会丢失。 要使前外部协作者成为您组织的成员*并*保留其私有复刻，请选择 **Invite and reinstate（邀请并恢复）**。 此人员接受邀请后，您可以通过[邀请他们作为成员加入组织](/articles/converting-an-outside-collaborator-to-an-organization-member)，将其转换为组织成员。 + **Warning:** If you want to upgrade the outside collaborator to a member of your organization, then choose **Invite and start fresh** and choose a new role for this person. Note, however, that this person's private forks of your organization's repositories will be lost if you choose to start fresh. To make the former outside collaborator a member of your organization *and* keep their private forks, choose **Invite and reinstate** instead. Once this person accepts the invitation, you can convert them to an organization member by [inviting them to join the organization as a member](/articles/converting-an-outside-collaborator-to-an-organization-member). {% endwarning %} - ![选择是否恢复设置](/assets/images/help/organizations/choose_whether_to_restore_org_member_info.png) + ![Choose to restore settings or not](/assets/images/help/organizations/choose_whether_to_restore_org_member_info.png) {% else %} -6. 通过单击 **Add and reinstate（添加并恢复）**选择恢复外部协作者在组织中以前的权限，或通过单击 **Add and start fresh（添加并重新开始）**选择清除其以前的权限并设置新的访问权限。 +6. Choose to restore the outside collaborator's previous privileges in the organization by clicking **Add and reinstate** or choose to clear their previous privileges and set new access permissions by clicking **Add and start fresh**. {% warning %} - **警告：**如果想要将外部协作者升级为组织成员，则选择 **Add and start fresh（添加并重新开始）**，然后为此人员选择新角色。 但是，请注意，如果您选择重新开始，则此人员组织仓库的私人复刻将会丢失。 要使前外部协作者成为您组织的成员*并*保留其私有复刻，请选择 **Add and reinstate（添加并恢复）**。 然后，您可以通过[将他们作为成员添加到组织](/articles/converting-an-outside-collaborator-to-an-organization-member)，将其转换为组织成员。 + **Warning:** If you want to upgrade the outside collaborator to a member of your organization, then choose **Add and start fresh** and choose a new role for this person. Note, however, that this person's private forks of your organization's repositories will be lost if you choose to start fresh. To make the former outside collaborator a member of your organization *and* keep their private forks, choose **Add and reinstate** instead. Then, you can convert them to an organization member by [adding them to the organization as a member](/articles/converting-an-outside-collaborator-to-an-organization-member). {% endwarning %} - ![选择是否恢复设置](/assets/images/help/organizations/choose_whether_to_restore_org_member_info_ghe.png) + ![Choose to restore settings or not](/assets/images/help/organizations/choose_whether_to_restore_org_member_info_ghe.png) {% endif %} {% if currentVersion == "free-pro-team@latest" %} -7. 如果已清除前外部协作者以前的权限，请为该用户选择一个角色，并（可选）将其添加到某些团队，然后单击 **Send invitation（发送邀请）**。 ![角色和团队选项及发送邀请按钮](/assets/images/help/organizations/add-role-send-invitation.png) +7. If you cleared the previous privileges for a former outside collaborator, choose a role for the user and optionally add them to some teams, then click **Send invitation**. + ![Role and team options and send invitation button](/assets/images/help/organizations/add-role-send-invitation.png) {% else %} -7. 如果已清除前外部协作者以前的权限，请为该用户选择一个角色，并（可选）将其添加到某些团队，然后单击 **Add member（添加成员）**。 ![角色和团队选项及添加成员按钮](/assets/images/help/organizations/add-role-add-member.png) +7. If you cleared the previous privileges for a former outside collaborator, choose a role for the user and optionally add them to some teams, then click **Add member**. + ![Role and team options and add member button](/assets/images/help/organizations/add-role-add-member.png) {% endif %} {% if currentVersion == "free-pro-team@latest" %} -8. 被邀请的人员将收到邀请其加入组织的电子邮件。 它们需要接受邀请，然后才能成为组织中的外部协作者。 {% data reusables.organizations.cancel_org_invite %} +8. The invited person will receive an email inviting them to the organization. They will need to accept the invitation before becoming an outside collaborator in the organization. {% data reusables.organizations.cancel_org_invite %} {% endif %} -### 延伸阅读 +### Further Reading -- "[组织的仓库权限级别](/articles/repository-permission-levels-for-an-organization)" +- "[Repository permission levels for an organization](/articles/repository-permission-levels-for-an-organization)" diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/removing-a-billing-manager-from-your-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/removing-a-billing-manager-from-your-organization.md index 2b86905507a6..a74c81996893 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/removing-a-billing-manager-from-your-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/removing-a-billing-manager-from-your-organization.md @@ -1,6 +1,6 @@ --- title: 从组织中删除帐单管理员 -intro: 如果具有*帐单管理员*角色的人员不再需要查看或更改组织的帐单信息，您可以删除其对组织的访问权限。 +intro: '如果具有*帐单管理员*角色的人员不再需要查看或更改组织的帐单信息，您可以删除其对组织的访问权限。' redirect_from: - /articles/removing-a-billing-manager-from-your-organization versions: diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/removing-a-member-from-your-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/removing-a-member-from-your-organization.md index 6ec8c6a90bba..1778cff0547b 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/removing-a-member-from-your-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/removing-a-member-from-your-organization.md @@ -1,6 +1,6 @@ --- title: 从组织中删除成员 -intro: 如果组织的成员不再需要访问组织拥有的任何仓库，则可以从组织中删除他们。 +intro: '如果组织的成员不再需要访问组织拥有的任何仓库，则可以从组织中删除他们。' redirect_from: - /articles/removing-a-member-from-your-organization versions: diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/removing-an-outside-collaborator-from-an-organization-project-board.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/removing-an-outside-collaborator-from-an-organization-project-board.md index 203c38af9aac..2ed8b53efccc 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/removing-an-outside-collaborator-from-an-organization-project-board.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/removing-an-outside-collaborator-from-an-organization-project-board.md @@ -1,6 +1,6 @@ --- title: 从组织项目板删除外部协作者 -intro: 作为组织所有者或项目板管理员，您可以删除外部协作者对项目板的访问权限。 +intro: '作为组织所有者或项目板管理员，您可以删除外部协作者对项目板的访问权限。' redirect_from: - /articles/removing-an-outside-collaborator-from-an-organization-project-board versions: diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md index 5142890d2d14..93eee15b92a2 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization.md @@ -24,7 +24,9 @@ versions: {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.github-apps-settings-sidebar %} -1. 在 "{% data variables.product.prodname_github_app %}" 下，单击要从其删除 {% data variables.product.prodname_github_app %}管理员的应用程序的头像。 ![选择 {% data variables.product.prodname_github_app %}](/assets/images/help/organizations/select-github-app.png) +1. 在“ +{% data variables.product.prodname_github_app %}s", click on the avatar of the app you'd like to remove a {% data variables.product.prodname_github_app %} manager from. +![选择 {% data variables.product.prodname_github_app %}](/assets/images/help/organizations/select-github-app.png) {% data reusables.organizations.app-managers-settings-sidebar %} 1. 在“App managers（应用程序管理员）”下，找到您要从其删除 {% data variables.product.prodname_github_app %}管理员权限的人员的用户名，然后单击 **Revoke（撤销）**。 ![撤销 {% data variables.product.prodname_github_app %}管理员权限](/assets/images/help/organizations/github-app-manager-revoke-permissions-individual-app.png) diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/removing-organization-members-from-a-team.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/removing-organization-members-from-a-team.md index 351b7e5f4a01..6bfbd7362dd2 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/removing-organization-members-from-a-team.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/removing-organization-members-from-a-team.md @@ -1,6 +1,6 @@ --- title: 从团队中删除组织成员 -intro: 具有*所有者*或*团队维护员*权限的人员可以从团队中删除团队成员。 如果人员不再需要团队授予的仓库访问权限，或者人员不再关注团队的项目，则可能有必要这样做。 +intro: '具有*所有者*或*团队维护员*权限的人员可以从团队中删除团队成员。 如果人员不再需要团队授予的仓库访问权限，或者人员不再关注团队的项目，则可能有必要这样做。' redirect_from: - /articles/removing-organization-members-from-a-team-early-access-program/ - /articles/removing-organization-members-from-a-team diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/renaming-a-team.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/renaming-a-team.md index df3aca8dd494..033356a666ed 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/renaming-a-team.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/renaming-a-team.md @@ -13,4 +13,4 @@ versions: {% data reusables.organizations.specific_team %} {% data reusables.organizations.team_settings %} 5. 输入团队的新名称或说明。 ![团队名称和说明的字段](/assets/images/help/teams/team-name-description.png) -6. Click **Update**. +6. 单击 **Update（更新）**。 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/renaming-an-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/renaming-an-organization.md index e282baba440b..680d651dfbe4 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/renaming-an-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/renaming-an-organization.md @@ -1,6 +1,6 @@ --- title: 重命名组织 -intro: 如果您的项目或公司已更改名称，您可以更新组织的名称以匹配。 +intro: '如果您的项目或公司已更改名称，您可以更新组织的名称以匹配。' redirect_from: - /articles/what-happens-when-i-change-my-organization-s-name/ - /articles/renaming-an-organization @@ -28,7 +28,7 @@ versions: #### 并非自动的更改 更改组织的名称后： -- 指向以前组织资料页面的链接（例如 `https://{% data variables.command_line.backticks %}/previousorgname`）将返回 404 错误。 我们建议您更新其他站点指向组织的链接{% if currentVersion == "free-pro-team@latest" %}，例如 LinkedIn 或 Twitter 个人资料{% endif %}。 +- 指向以前组织资料页面的链接（例如 `https://{% data variables.command_line.backticks %}/previousorgname`）将返回 404 错误。 We recommend you update links to your organization from other sites{% if currentVersion == "free-pro-team@latest" %}, such as your LinkedIn or Twitter profiles{% endif %}. - 使用旧组织名称的 API 请求将返回 404 错误。 我们建议您更新 API 请求中的旧组织名称。 - 对于使用旧组织名称的团队，没有自动[@提及](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams)重定向。 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md index a54b82f9bd44..b3d149cd04dd 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization.md @@ -1,6 +1,6 @@ --- title: 组织的仓库权限级别 -intro: 您可以通过细化权限级别自定义组织中每个仓库的权限，从而为每个用户提供所需的功能和任务权限。 +intro: '您可以通过细化权限级别自定义组织中每个仓库的权限，从而为每个用户提供所需的功能和任务权限。' redirect_from: - /articles/repository-permission-levels-for-an-organization-early-access-program/ - /articles/repository-permission-levels-for-an-organization @@ -16,10 +16,10 @@ versions: 您可以为组织成员、外部协作者和人员团队提供对组织仓库不同级别的权限。 每个权限级别都会逐步增加对仓库内容和设置的权限。 选择最适合每个人或团队在项目中的角色的权限级别，而不是提供超过其需求的项目权限。 组织仓库从低到高的权限级别分别为： -- **读取**：建议授予要查看或讨论项目的非代码参与者{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -- **分类**：建议授予需要主动管理议题和拉取请求的参与者，无写入权限{% endif %} -- **写入**：建议授予积极向项目推送的参与者{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -- **维护**：建议授予需要管理仓库的项目管理者，没有执行敏感或破坏性操作的权限{% endif %} +- **读取**：建议授予要查看或讨论项目的非代码参与者 +- **分类**：建议授予需要主动管理议题和拉取请求的参与者，无写入权限 +- **写入**：建议授予积极向项目推送的参与者 +- **维护**：建议授予需要管理仓库的项目管理者，没有执行敏感或破坏性操作的权限 - **管理员**：建议授予需要完全项目权限的人员，包括执行敏感和破坏性操作，例如管理安全性或删除仓库 {% if currentVersion == "free-pro-team@latest" %} @@ -41,135 +41,75 @@ versions: {% endwarning %} ### 每个权限级别的仓库权限 -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -| 仓库操作 | 读取 | 分类 | 写入 | 维护 | 管理员 | -|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |:-----:|:-----:|:-----:|:-----:|:---------------------------------------------------------------------------------------------------------------------------------------------------------:| -| 从人员或团队的已分配仓库拉取 | **X** | **X** | **X** | **X** | **X** | -| 复刻人员或团队的已分配仓库 | **X** | **X** | **X** | **X** | **X** | -| 编辑和删除自己的评论 | **X** | **X** | **X** | **X** | **X** | -| 打开议题 | **X** | **X** | **X** | **X** | **X** | -| 关闭自己打开的议题 | **X** | **X** | **X** | **X** | **X** | -| 重新打开自己关闭的议题 | **X** | **X** | **X** | **X** | **X** | -| 受理议题 | **X** | **X** | **X** | **X** | **X** | -| 从团队已分配仓库的复刻发送拉取请求 | **X** | **X** | **X** | **X** | **X** | -| 提交拉取请求审查 | **X** | **X** | **X** | **X** | **X** | -| 查看已发布的版本 | **X** | **X** | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| 查看 [GitHub 操作工作流程运行](/actions/automating-your-workflow-with-github-actions/managing-a-workflow-run) | **X** | **X** | **X** | **X** | **X** |{% endif %} -| 编辑 wiki | **X** | **X** | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [举报滥用或垃圾内容](/articles/reporting-abuse-or-spam) | **X** | **X** | **X** | **X** | **X** |{% endif %} -| 应用标签 | | **X** | **X** | **X** | **X** | -| 关闭、重新打开和分配所有议题与拉取请求 | | **X** | **X** | **X** | **X** | -| 应用里程碑 | | **X** | **X** | **X** | **X** | -| 标记[重复的议题和拉取请求](/articles/about-duplicate-issues-and-pull-requests) | | **X** | **X** | **X** | **X** | -| 申请[拉取请求审查](/articles/requesting-a-pull-request-review) | | **X** | **X** | **X** | **X** | -| 推送到（写入）人员或团队的已分配仓库 | | | **X** | **X** | **X** | -| 编辑和删除任何人对提交、拉取请求和议题的评论 | | | **X** | **X** | **X** | -| [隐藏任何人的评论](/articles/managing-disruptive-comments) | | | **X** | **X** | **X** | -| [锁定对话](/articles/locking-conversations) | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| 转让议题（更多信息请参阅“[将议题转让给其他仓库](/articles/transferring-an-issue-to-another-repository)”） | | | **X** | **X** | **X** |{% endif %} -| [作为仓库的指定代码所有者](/articles/about-code-owners) | | | **X** | **X** | **X** | -| [将拉取请求草稿标记为可供审查](/articles/changing-the-stage-of-a-pull-request) | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -| [将拉取请求转换为草稿](/articles/changing-the-stage-of-a-pull-request) | | | **X** | **X** | **X** |{% endif %} -| 提交影响拉取请求可合并性的审查 | | | **X** | **X** | **X** | -| 对拉取请求[应用建议的更改](/articles/incorporating-feedback-in-your-pull-request) | | | **X** | **X** | **X** | -| 创建[状态检查](/articles/about-status-checks) | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| Create, edit, run, re-run, and cancel [GitHub Actions workflows](/actions/automating-your-workflow-with-github-actions/) | | | **X** | **X** | **X** |{% endif %} -| 创建和编辑发行版 | | | **X** | **X** | **X** | -| 查看发行版草稿 | | | **X** | **X** | **X** | -| 编辑仓库的说明 | | | | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [View and install packages](/packages/publishing-and-managing-packages) | **X** | **X** | **X** | **X** | **X** | -| [Publish packages](/packages/publishing-and-managing-packages/publishing-a-package) | | | **X** | **X** | **X** | -| [Delete packages](/packages/publishing-and-managing-packages/deleting-a-package) | | | | | **X** |{% endif %} -| 管理[主题](/articles/classifying-your-repository-with-topics) | | | | **X** | **X** | -| 启用 wiki 和限制 wiki 编辑器 | | | | **X** | **X** | -| 启用项目板 | | | | **X** | **X** | -| 配置[拉取请求合并](/articles/configuring-pull-request-merges) | | | | **X** | **X** | -| 配置[ {% data variables.product.prodname_pages %} 的发布源](/articles/configuring-a-publishing-source-for-github-pages) | | | | **X** | **X** | -| [推送到受保护分支](/articles/about-protected-branches) | | | | **X** | **X** | -| [创建和编辑仓库社交卡](/articles/customizing-your-repositorys-social-media-preview) | | | | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| 限制[仓库中的交互](/github/building-a-strong-community/limiting-interactions-in-your-repository) | | | | **X** | **X** |{% endif %} -| 删除议题（请参阅“[删除议题](/articles/deleting-an-issue)”） | | | | | **X** | -| 合并受保护分支上的拉取请求（即使没有批准审查） | | | | | **X** | -| [定义仓库的代码所有者](/articles/about-code-owners) | | | | | **X** | -| 将仓库添加到团队（详细信息请参阅“[管理团队对组织仓库的访问](/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository#giving-a-team-access-to-a-repository)”） | | | | | **X** | -| [管理外部协作者对仓库的权限](/articles/adding-outside-collaborators-to-repositories-in-your-organization) | | | | | **X** | -| [更改仓库的可见性](/articles/restricting-repository-visibility-changes-in-your-organization) | | | | | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| 将仓库设为模板（请参阅“[创建模板仓库](/articles/creating-a-template-repository)”） | | | | | **X** |{% endif %} -| 更改仓库设置 | | | | | **X** | -| 管理团队和协作者对仓库的权限 | | | | | **X** | -| 编辑仓库的默认分支 | | | | | **X** | -| 管理 web 挂钩和部署密钥 | | | | | **X** |{% if currentVersion == "free-pro-team@latest" %} -| 为私有仓库[启用依赖关系图](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) | | | | | **X** | -| 接收仓库中[易受攻击的依赖项的 {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) | | | | | **X** | -| [忽略 {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository) | | | | | **X** | -| [指定其他人员或团队接收易受攻击依赖项的 {% data variables.product.prodname_dependabot_alerts %}](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository) | | | | | **X** | -| [管理私有仓库的数据使用设置](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository) | | | | | **X** |{% endif %}{% if currentVersion == "free-pro-team@latest" %}| 创造[安全通告](/github/managing-security-vulnerabilities/about-github-security-advisories) | | | | | **X** |{% endif %} -| [管理仓库的复刻策略](/github/administering-a-repository/managing-the-forking-policy-for-your-repository) | | | | | **X** | -| [将仓库转让给组织](/articles/restricting-repository-creation-in-your-organization) | | | | | **X** | -| [删除仓库或将仓库转让到组织外部](/articles/setting-permissions-for-deleting-or-transferring-repositories) | | | | | **X** | -| [存档仓库](/articles/about-archiving-repositories) | | | | | **X** |{% if currentVersion == "free-pro-team@latest" %} -| 显示赞助按钮（请参阅“[在仓库中显示赞助按钮](/articles/displaying-a-sponsor-button-in-your-repository)”）。 | | | | | **X** |{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -| 创建到外部资源的自动链接引用，如 JIRA 或 Zendesk（请参阅“[配置自动链接以引用外部资源](/articles/configuring-autolinks-to-reference-external-resources)”） | | | | | **X** |{% endif %} - -{% else %} - -| 仓库操作 | 读取权限 | 写入权限 | 管理员权限 | -|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-----:|:-----:|:----------------------------------------------------------------------:| -| 从人员或团队的已分配仓库拉取（读取） | **X** | **X** | **X** | -| 复刻（复制）人员或团队的已分配仓库 | **X** | **X** | **X** | -| 编辑和删除自己对提交、拉取请求和议题的评论 | **X** | **X** | **X** | -| 打开议题 | **X** | **X** | **X** | -| 关闭自己打开的议题 | **X** | **X** | **X** | -| 重新打开自己关闭的议题 | **X** | **X** | **X** | -| 受理议题 | **X** | **X** | **X** | -| 从团队已分配仓库的复刻发送拉取请求 | **X** | **X** | **X** | -| 提交拉取请求审查 | **X** | **X** | **X** | -| 查看已发布的版本 | **X** | **X** | **X** | -| 编辑 wiki | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| [举报滥用或垃圾内容](/articles/reporting-abuse-or-spam) | **X** | **X** | **X** |{% endif %} -| 推送到（写入）人员或团队的已分配仓库 | | **X** | **X** | -| 编辑和删除任何人对提交、拉取请求和议题的评论 | | **X** | **X** | -| [隐藏任何人的评论](/articles/managing-disruptive-comments) | | **X** | **X** | -| [锁定对话](/articles/locking-conversations) | | **X** | **X** | -| 应用标签和里程碑 | | **X** | **X** | -| 关闭、重新打开和分配所有议题 | | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} -| 标记[重复的议题和拉取请求](/articles/about-duplicate-issues-and-pull-requests) | | **X** | **X** |{% endif %} -| [作为仓库的指定代码所有者](/articles/about-code-owners) | | **X** | **X** | -| [将拉取请求草稿标记为可供审查](/articles/changing-the-stage-of-a-pull-request) | | **X** | **X** | -| 申请[拉取请求审查](/articles/requesting-a-pull-request-review) | | **X** | **X** | -| 提交影响拉取请求可合并性的审查 | | **X** | **X** | -| 对拉取请求应用建议的更改（更多信息请参阅“[合并拉取请求中的反馈](/articles/incorporating-feedback-in-your-pull-request)”） | | **X** | **X** | -| 创建[状态检查](/articles/about-status-checks) | | **X** | **X** | -| 创建和编辑发行版 | | **X** | **X** | -| 查看发行版草稿 | | **X** | **X** | -| 删除议题（请参阅“[删除议题](/articles/deleting-an-issue)”） | | | **X** | -| 合并受保护分支上的拉取请求（即使没有批准审查） | | | **X** | -| [定义仓库的代码所有者](/articles/about-code-owners) | | | **X** | -| 编辑仓库的说明 | | | **X** | -| 管理[主题](/articles/classifying-your-repository-with-topics) | | | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| 创建和编辑仓库社交卡（更多信息请参阅“[自定义仓库的社交媒体预览](/articles/customizing-your-repositorys-social-media-preview)”） | | | **X** |{% endif %} -| 将仓库添加到团队（详细信息请参阅“[管理团队对组织仓库的访问](/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository#giving-a-team-access-to-a-repository)”） | | | **X** | -| 管理外部协作者对仓库的权限（更多信息请参阅“a href="/articles/adding-outside-collaborators-to-repositories-in-your-organization">将外部协作者添加到组织中的仓库”） | | | **X** |{% if currentVersion == "free-pro-team@latest" %} -| 限制[仓库中的交互](/github/building-a-strong-community/limiting-interactions-in-your-repository) | | | **X** |{% endif %} -| 更改仓库的可见性（更多信息请参阅“[限制组织中的仓库可见性更改](/articles/restricting-repository-visibility-changes-in-your-organization)”） | | | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -| 将仓库设为模板（请参阅“[创建模板仓库](/articles/creating-a-template-repository)”） | | | | | **X** |{% endif %} -| 更改仓库设置 | | | **X** | -| 管理团队和协作者对仓库的权限 | | | **X** | -| 编辑仓库的默认分支 | | | **X** | -| 管理 web 挂钩和部署密钥 | | | **X** |{% if currentVersion == "free-pro-team@latest" %} -| 为私有仓库[启用依赖关系图](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) | | | **X** | -| 接收仓库中[易受攻击的依赖项的 {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) | | | **X** | -| [忽略 {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository) | | | **X** | -| [指定其他人员或团队接收易受攻击依赖项的 {% data variables.product.prodname_dependabot_alerts %}](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-github-dependabot-alerts) | | | **X** | -| [管理私有仓库的数据使用设置](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository) | | | **X** |{% endif %}{% if currentVersion == "free-pro-team@latest" %} -| 创建[安全通告](/github/managing-security-vulnerabilities/about-github-security-advisories)") | | | **X** |{% endif %} -| [管理仓库的复刻策略](/github/administering-a-repository/managing-the-forking-policy-for-your-repository) | | | **X** | -| 将仓库转让给组织帐户（更多信息请参阅“[限制在组织中创建仓库](/articles/restricting-repository-creation-in-your-organization)”） | | | **X** | -| 删除或转让仓库（更多信息请参阅“[在组织中设置删除或转让仓库的权限](/articles/setting-permissions-for-deleting-or-transferring-repositories)”） | | | **X** | -| [存档仓库](/articles/about-archiving-repositories) | | | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -| 创建到外部资源的自动链接引用，如 JIRA 或 Zendesk（请参阅“[配置自动链接以引用外部资源](/articles/configuring-autolinks-to-reference-external-resources)”） | | | | | **X** |{% endif %} -{% endif %} +| 仓库操作 | 读取 | 分类 | 写入 | 维护 | 管理员 | +|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:-----:|:-----:|:-----:|:-----:|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:| +| 从人员或团队的已分配仓库拉取 | **X** | **X** | **X** | **X** | **X** | +| 复刻人员或团队的已分配仓库 | **X** | **X** | **X** | **X** | **X** | +| 编辑和删除自己的评论 | **X** | **X** | **X** | **X** | **X** | +| 打开议题 | **X** | **X** | **X** | **X** | **X** | +| 关闭自己打开的议题 | **X** | **X** | **X** | **X** | **X** | +| 重新打开自己关闭的议题 | **X** | **X** | **X** | **X** | **X** | +| 受理议题 | **X** | **X** | **X** | **X** | **X** | +| 从团队已分配仓库的复刻发送拉取请求 | **X** | **X** | **X** | **X** | **X** | +| 提交拉取请求审查 | **X** | **X** | **X** | **X** | **X** | +| 查看已发布的版本 | **X** | **X** | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} +| 查看 [GitHub 操作工作流程运行](/actions/automating-your-workflow-with-github-actions/managing-a-workflow-run) | **X** | **X** | **X** | **X** | **X** |{% endif %} +| 编辑 wiki | **X** | **X** | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} +| [举报滥用或垃圾内容](/articles/reporting-abuse-or-spam) | **X** | **X** | **X** | **X** | **X** |{% endif %} +| 应用标签 | | **X** | **X** | **X** | **X** | +| 关闭、重新打开和分配所有议题与拉取请求 | | **X** | **X** | **X** | **X** | +| 应用里程碑 | | **X** | **X** | **X** | **X** | +| 标记[重复的议题和拉取请求](/articles/about-duplicate-issues-and-pull-requests) | | **X** | **X** | **X** | **X** | +| 申请[拉取请求审查](/articles/requesting-a-pull-request-review) | | **X** | **X** | **X** | **X** | +| 推送到（写入）人员或团队的已分配仓库 | | | **X** | **X** | **X** | +| 编辑和删除任何人对提交、拉取请求和议题的评论 | | | **X** | **X** | **X** | +| [隐藏任何人的评论](/articles/managing-disruptive-comments) | | | **X** | **X** | **X** | +| [锁定对话](/articles/locking-conversations) | | | **X** | **X** | **X** | +| 转让议题（更多信息请参阅“[将议题转让给其他仓库](/articles/transferring-an-issue-to-another-repository)”） | | | **X** | **X** | **X** | +| [作为仓库的指定代码所有者](/articles/about-code-owners) | | | **X** | **X** | **X** | +| [将拉取请求草稿标记为可供审查](/articles/changing-the-stage-of-a-pull-request) | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +| [将拉取请求转换为草稿](/articles/changing-the-stage-of-a-pull-request) | | | **X** | **X** | **X** |{% endif %} +| 提交影响拉取请求可合并性的审查 | | | **X** | **X** | **X** | +| 对拉取请求[应用建议的更改](/articles/incorporating-feedback-in-your-pull-request) | | | **X** | **X** | **X** | +| 创建[状态检查](/articles/about-status-checks) | | | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} +| 创建、编辑、运行、重新运行和取消 [GitHub 操作工作流程](/actions/automating-your-workflow-with-github-actions/) | | | **X** | **X** | **X** |{% endif %} +| 创建和编辑发行版 | | | **X** | **X** | **X** | +| 查看发行版草稿 | | | **X** | **X** | **X** | +| 编辑仓库的说明 | | | | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} +| [查看和安装包](/packages/publishing-and-managing-packages) | **X** | **X** | **X** | **X** | **X** | +| [发布包](/packages/publishing-and-managing-packages/publishing-a-package) | | | **X** | **X** | **X** | +| [删除包](/packages/publishing-and-managing-packages/deleting-a-package) | | | | | **X** |{% endif %} +| 管理[主题](/articles/classifying-your-repository-with-topics) | | | | **X** | **X** | +| 启用 wiki 和限制 wiki 编辑器 | | | | **X** | **X** | +| 启用项目板 | | | | **X** | **X** | +| 配置[拉取请求合并](/articles/configuring-pull-request-merges) | | | | **X** | **X** | +| 配置[ {% data variables.product.prodname_pages %} 的发布源](/articles/configuring-a-publishing-source-for-github-pages) | | | | **X** | **X** | +| [推送到受保护分支](/articles/about-protected-branches) | | | | **X** | **X** | +| [创建和编辑仓库社交卡](/articles/customizing-your-repositorys-social-media-preview) | | | | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} +| 限制[仓库中的交互](/github/building-a-strong-community/limiting-interactions-in-your-repository) | | | | **X** | **X** |{% endif %} +| 删除议题（请参阅“[删除议题](/articles/deleting-an-issue)”） | | | | | **X** | +| 合并受保护分支上的拉取请求（即使没有批准审查） | | | | | **X** | +| [定义仓库的代码所有者](/articles/about-code-owners) | | | | | **X** | +| 将仓库添加到团队（详细信息请参阅“[管理团队对组织仓库的访问](/github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-repository#giving-a-team-access-to-a-repository)”） | | | | | **X** | +| [管理外部协作者对仓库的权限](/articles/adding-outside-collaborators-to-repositories-in-your-organization) | | | | | **X** | +| [更改仓库的可见性](/articles/restricting-repository-visibility-changes-in-your-organization) | | | | | **X** | +| 将仓库设为模板（请参阅“[创建模板仓库](/articles/creating-a-template-repository)”） | | | | | **X** | +| 更改仓库设置 | | | | | **X** | +| 管理团队和协作者对仓库的权限 | | | | | **X** | +| 编辑仓库的默认分支 | | | | | **X** | +| 管理 web 挂钩和部署密钥 | | | | | **X** |{% if currentVersion == "free-pro-team@latest" %} +| 为私有仓库[启用依赖关系图](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) | | | | | **X** | +| 接收仓库中[易受攻击的依赖项的 {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) | | | | | **X** | +| [忽略 {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository) | | | | | **X** | +| [指定其他人员或团队接收易受攻击依赖项的 {% data variables.product.prodname_dependabot_alerts %}](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository) | | | | | **X** | +| [管理私有仓库的数据使用设置](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository) | | | | | **X** |{% endif %}{% if currentVersion == "free-pro-team@latest" %}| Create [security advisories](/github/managing-security-vulnerabilities/about-github-security-advisories) | | | | | **X** |{% endif %} +| [管理仓库的复刻策略](/github/administering-a-repository/managing-the-forking-policy-for-your-repository) | | | | | **X** | +| [将仓库转让给组织](/articles/restricting-repository-creation-in-your-organization) | | | | | **X** | +| [删除仓库或将仓库转让到组织外部](/articles/setting-permissions-for-deleting-or-transferring-repositories) | | | | | **X** | +| [存档仓库](/articles/about-archiving-repositories) | | | | | **X** |{% if currentVersion == "free-pro-team@latest" %} +| 显示赞助按钮（请参阅“[在仓库中显示赞助按钮](/articles/displaying-a-sponsor-button-in-your-repository)”）。 | | | | | **X** |{% endif %} +| 创建到外部资源的自动链接引用，如 JIRA 或 Zendesk（请参阅“[配置自动链接以引用外部资源](/articles/configuring-autolinks-to-reference-external-resources)”） | | | | | **X** | ### 延伸阅读 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/requesting-to-add-a-child-team.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/requesting-to-add-a-child-team.md index aeb19b56ec0d..19fb59a1cc87 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/requesting-to-add-a-child-team.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/requesting-to-add-a-child-team.md @@ -1,6 +1,6 @@ --- title: 申请添加子团队 -intro: 如果您在团队中具有维护员权限，可以申请在组织的层次结构中将现有团队嵌套在您的团队下面。 +intro: '如果您在团队中具有维护员权限，可以申请在组织的层次结构中将现有团队嵌套在您的团队下面。' redirect_from: - /articles/requesting-to-add-a-child-team versions: diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/requesting-to-add-or-change-a-parent-team.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/requesting-to-add-or-change-a-parent-team.md index 7e94faa016d5..a4616e17beb5 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/requesting-to-add-or-change-a-parent-team.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/requesting-to-add-or-change-a-parent-team.md @@ -1,6 +1,6 @@ --- title: 申请添加或更改父团队 -intro: 如果您在团队中具有维护员权限，可以申请在组织的层次结构中将团队嵌套在父团队下面。 +intro: '如果您在团队中具有维护员权限，可以申请在组织的层次结构中将团队嵌套在父团队下面。' redirect_from: - /articles/requesting-to-add-or-change-a-parent-team versions: diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md index d28b4424f2c2..228b75fd4bd5 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.md @@ -1,6 +1,6 @@ --- title: 您的组织中需要双重身份验证 -intro: '组织所有者可以要求{% if currentVersion == "free-pro-team@latest" %}组织成员、外部协作者和帐单管理员{% else %}组织成员和外部协作者{% endif %}为其个人帐户启用双重身份验证，从而使恶意行为者更难以访问组织的仓库和设置。' +intro: 'Organization owners can require {% if currentVersion == "free-pro-team@latest" %}organization members, outside collaborators, and billing managers{% else %}organization members and outside collaborators{% endif %} to enable two-factor authentication for their personal accounts, making it harder for malicious actors to access an organization''s repositories and settings.' redirect_from: - /articles/requiring-two-factor-authentication-in-your-organization versions: @@ -8,23 +8,35 @@ versions: enterprise-server: '*' --- -{% data reusables.two_fa.auth_methods_2fa %} +### About two-factor authentication for organizations + +{% data reusables.two_fa.about-2fa %} You can require all {% if currentVersion == "free-pro-team@latest" %}members, outside collaborators, and billing managers{% else %}members and outside collaborators{% endif %} in your organization to enable two-factor authentication on {% data variables.product.product_name %}. For more information about two-factor authentication, see "[Securing your account with two-factor authentication (2FA)](/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa)." -### 强制执行双重身份验证的要求 +{% if currentVersion == "free-pro-team@latest" %} -在可以要求{% if currentVersion == "free-pro-team@latest" %}组织成员、外部协作者和帐单管理员{% else %}组织成员和外部协作者{% endif %}使用 2FA 之前，您必须为自己的个人帐户[启用双重身份验证](/articles/securing-your-account-with-two-factor-authentication-2fa/)。 +You can also require two-factor authentication for organizations in an enterprise. 更多信息请参阅“[在企业帐户中实施安全设置](/github/setting-up-and-managing-your-enterprise-account/enforcing-security-settings-in-your-enterprise-account#requiring-two-factor-authentication-for-organizations-in-your-enterprise-account)”。 + +{% endif %} {% warning %} **警告：** -- 需要对您的组织使用双重身份验证时，不使用 2FA 的{% if currentVersion == "free-pro-team@latest" %}成员、外部协作者和帐单管理员{% else %}成员和外部协作者{% endif %}（包括自动程序帐户）将从组织中删除，并且失去访问其仓库的权限。 他们还会失去对组织私有仓库的复刻的访问权限。 如果他们在从您的组织中删除后的三个月内为其个人帐户启用双重身份验证，您可以[恢复其访问权限和设置](/articles/reinstating-a-former-member-of-your-organization)。 -- 如果组织所有者、成员{% if currentVersion == "free-pro-team@latest" %}、帐单管理员{% endif %}或外部协作者在您启用所需的双重身份验证后为其个人帐户禁用 2FA，则系统会自动将其从组织中删除。 +- When you require use of two-factor authentication for your organization, {% if currentVersion == "free-pro-team@latest" %}members, outside collaborators, and billing managers{% else %}members and outside collaborators{% endif %} (including bot accounts) who do not use 2FA will be removed from the organization and lose access to its repositories. 他们还会失去对组织私有仓库的复刻的访问权限。 如果他们在从您的组织中删除后的三个月内为其个人帐户启用双重身份验证，您可以[恢复其访问权限和设置](/articles/reinstating-a-former-member-of-your-organization)。 +- If an organization owner, member,{% if currentVersion == "free-pro-team@latest" %} billing manager,{% endif %} or outside collaborator disables 2FA for their personal account after you've enabled required two-factor authentication, they will automatically be removed from the organization. - 如果您是某个要求双重身份验证的组织的唯一所有者，则在不为组织禁用双重身份验证要求的情况下，您将无法为个人帐户禁用双重身份验证。 {% endwarning %} -在您需要使用双重身份验证之前，我们建议您通知{% if currentVersion == "free-pro-team@latest" %}组织成员、外部协作者和帐单管理员{% else %}组织成员和外部协作者{% endif %}，并要求他们为其帐户设置 2FA。 您可以在组织的 People（人员）页面中[查看成员和外部协作者是否已使用 2FA](/articles/viewing-whether-users-in-your-organization-have-2fa-enabled)。 +{% data reusables.two_fa.auth_methods_2fa %} + +### 基本要求 + +Before you can require {% if currentVersion == "free-pro-team@latest" %}organization members, outside collaborators, and billing managers{% else %}organization members and outside collaborators{% endif %} to use two-factor authentication, you must enable two-factor authentication for your account on {% data variables.product.product_name %}. 更多信息请参阅“[使用双重身份验证 (2FA) 保护您的帐户](/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa)”。 + +Before you require use of two-factor authentication, we recommend notifying {% if currentVersion == "free-pro-team@latest" %}organization members, outside collaborators, and billing managers{% else %}organization members and outside collaborators{% endif %} and asking them to set up 2FA for their accounts. You can see if members and outside collaborators already use 2FA. 更多信息请参阅“[查看组织中的用户是否已启用 2FA](/github/setting-up-and-managing-organizations-and-teams/viewing-whether-users-in-your-organization-have-2fa-enabled)”。 + +### 您的组织中需要双重身份验证 {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} @@ -47,7 +59,7 @@ versions: {% data reusables.audit_log.audit_log_sidebar_for_org_admins %} 4. 输入您的搜索查询。 要搜索： - 删除的组织成员，请在搜索查询中使用 `action:org.remove_member` - - 删除的外部协作者，请在搜索查询中使用 `action:org.remove_outside_collaborator`{% if currentVersion == "free-pro-team@latest" %} + - Outside collaborators removed, use `action:org.remove_outside_collaborator` in your search query{% if currentVersion == "free-pro-team@latest" %} - 删除的帐单管理员，请在搜索查询中使用 `action:org.remove_billing_manager`{% endif %} 您还可以在搜索中使用[时间范围](/articles/reviewing-the-audit-log-for-your-organization/#search-based-on-time-of-action)查看从组织中删除的人员。 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md index 198a83d7d205..f2ecc5cff69c 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md @@ -1,6 +1,6 @@ --- title: 将电子邮件通知限于已批准的域 -intro: 为防止将组织信息泄露到个人帐户，组织所有者可以将关于组织活动的电子邮件通知限于经过验证的域。 +intro: '为防止将组织信息泄露到个人帐户，组织所有者可以将关于组织活动的电子邮件通知限于经过验证的域。' product: '{% data reusables.gated-features.restrict-email-domain %}' redirect_from: - /articles/restricting-email-notifications-about-organization-activity-to-an-approved-email-domain/ diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md index fbc09600c9de..cc033ec60294 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization.md @@ -1,6 +1,6 @@ --- title: 限制在组织中创建仓库 -intro: 为保护组织的数据，您可以配置在组织中创建仓库的权限。 +intro: '为保护组织的数据，您可以配置在组织中创建仓库的权限。' redirect_from: - /articles/restricting-repository-creation-in-your-organization versions: @@ -8,15 +8,15 @@ versions: enterprise-server: '*' --- -您可以选择成员是否可以在组织中创建仓库。 如果允许成员创建仓库，您可以选择允许创建哪些类型的仓库。{% if currentVersion == "free-pro-team@latest" %} 若只允许成员创建私有仓库，您的组织必须使用 {% data variables.product.prodname_ghe_cloud %}。{% endif %}更多信息请参阅“[关于仓库可见性](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)”。 +您可以选择成员是否可以在组织中创建仓库。 If you allow members to create repositories, you can choose which types of repositories members can create.{% if currentVersion == "free-pro-team@latest" %} To allow members to create private repositories only, your organization must use {% data variables.product.prodname_ghe_cloud %}.{% endif %} For more information, see "[About repository visibility](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)." 组织所有者始终可以创建任何类型的仓库。 -{% if currentVersion == "free-pro-team@latest" %}企业所有者{% else %}网站管理员{% endif %} 可以限制用于组织仓库创建策略的选项。 更多信息请参阅{% if currentVersion == "free-pro-team@latest" %}“[在企业帐户中实施仓库管理策略](/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account)”。{% else %}“[限制实例中的仓库创建](/enterprise/admin/user-management/restricting-repository-creation-in-your-instance)”。{% endif %} +{% if currentVersion == "free-pro-team@latest" %}Enterprise owners{% else %}Site administrators{% endif %} can restrict the options you have available for your organization's repository creation policy. For more information, see {% if currentVersion == "free-pro-team@latest" %}"[Enforcing repository management policies in your enterprise account](/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account)."{% else %}"[Restricting repository creation in your instance](/enterprise/admin/user-management/restricting-repository-creation-in-your-instance)."{% endif %} {% warning %} -**Warning**: This setting only restricts the visibility options available when repositories are created and does not restrict the ability to change repository visibility at a later time. For more information about restricting changes to existing repositories' visibilities, see "[Restricting repository visibility changes in your organization](/github/setting-up-and-managing-organizations-and-teams/restricting-repository-visibility-changes-in-your-organization)." +**警告**：此设置仅限制在仓库创建时可用的可见性选项，而不会限制以后更改仓库可见性的能力。 有关限制更改现有仓库可见性的更多信息，请参阅“[限制组织的仓库可见性更改](/github/setting-up-and-managing-organizations-and-teams/restricting-repository-visibility-changes-in-your-organization)”。 {% endwarning %} @@ -26,5 +26,5 @@ versions: {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.member-privileges %} -5. 在“Repository creation（仓库创建）”下，选择{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}一个或多个选项{% else %}设置{% endif %}。 ![仓库创建选项](/assets/images/help/organizations/repo-creation-perms-radio-buttons.png) +5. Under "Repository creation", select one or more options. ![仓库创建选项](/assets/images/help/organizations/repo-creation-perms-radio-buttons.png) 6. 单击 **Save（保存）**。 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-visibility-changes-in-your-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-visibility-changes-in-your-organization.md index b14d11b7db89..52396a3360a3 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-visibility-changes-in-your-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-visibility-changes-in-your-organization.md @@ -1,6 +1,6 @@ --- title: 限制在组织中更改仓库可见性 -intro: 为保护组织的数据，您可以配置在组织中更改仓库可见性的权限。 +intro: '为保护组织的数据，您可以配置在组织中更改仓库可见性的权限。' redirect_from: - /articles/restricting-repository-visibility-changes-in-your-organization versions: @@ -12,7 +12,7 @@ versions: {% warning %} -**Warning**: If enabled, this setting allows people with admin permissions to change an existing repository to any visibility, even if you do not allow that type of repository to be created. For more information about restricting the visibility of repositories during creation, see "[Restricting repository creation in your organization](/articles/restricting-repository-creation-in-your-organization)." +**警告**：如果启用，此设置允许具有管理员权限的用户将现有仓库更改为任何可见性，即使您不允许创建该类型的仓库。 有关在创建过程中限制仓库可见性的更多信息，请参阅“[限制组织中的仓库创建](/articles/restricting-repository-creation-in-your-organization)”。 {% endwarning %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md index f256f2c28fdb..b0029b8eeabf 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization.md @@ -202,7 +202,8 @@ For more information, see "[Restricting publication of {% data variables.product | `remove_outside_collaborator` | Triggered when an owner removes an outside collaborator from an organization or when [two-factor authentication is required in an organization](/articles/requiring-two-factor-authentication-in-your-organization) and an outside collaborator does not use 2FA or disables 2FA. |{% if currentVersion == "free-pro-team@latest" %} | `revoke_external_identity` | Triggered when an organization owner revokes a member's linked identity. For more information, see "[Viewing and managing a member's SAML access to your organization](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization#viewing-and-revoking-a-linked-identity)." | `revoke_sso_session` | Triggered when an organization owner revokes a member's SAML session. For more information, see "[Viewing and managing a member's SAML access to your organization](/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization#viewing-and-revoking-a-linked-identity)." -| `unblock_user` | Triggered when an organization owner [unblocks a user from an organization](/articles/unblocking-a-user-from-your-organization).{% endif %} +| `unblock_user` | Triggered when an organization owner [unblocks a user from an organization](/articles/unblocking-a-user-from-your-organization).{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +| `update_new_repository_default_branch_setting` | Triggered when an owner changes the name of the default branch for new repositories in the organization. For more information, see "[Managing the default branch name for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization)."{% endif %} | `update_default_repository_permission` | Triggered when an owner changes the default repository permission level for organization members. | `update_member` | Triggered when an owner changes a person's role from owner to member or member to owner. | `update_member_repository_creation_permission` | Triggered when an owner changes the create repository permission for organization members.{% if currentVersion == "free-pro-team@latest" %} @@ -400,7 +401,6 @@ Using the qualifier `country`, you can filter actions in the audit log based on {% data reusables.audit_log.exported-log-keys-and-values %} {% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} ### Using the Audit log API {% note %} @@ -418,9 +418,7 @@ To ensure a secure IP and maintain compliance for your organization, you can use The GraphQL response can include data for up to 90 to 120 days. -For example, you can make a GraphQL request to see all the new organization members added to your organization. For more information, see the "[GraphQL API Audit Log](/v4/interface/auditentry/)." - -{% endif %} +For example, you can make a GraphQL request to see all the new organization members added to your organization. For more information, see the "[GraphQL API Audit Log](/graphql/reference/interfaces#auditentry/)." ### Further reading diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/reviewing-your-organizations-installed-integrations.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/reviewing-your-organizations-installed-integrations.md index b15cd54ace59..83bcbe3dd4f6 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/reviewing-your-organizations-installed-integrations.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/reviewing-your-organizations-installed-integrations.md @@ -1,6 +1,6 @@ --- -title: 审查组织安装的集成 -intro: 您可以审查组织安装的集成的权限级别，并配置每个集成对组织仓库的访问权限。 +title: Reviewing your organization's installed integrations +intro: You can review the permission levels for your organization's installed integrations and configure each integration's access to organization repositories. redirect_from: - /articles/reviewing-your-organization-s-installed-integrations - /articles/reviewing-your-organizations-installed-integrations @@ -12,9 +12,12 @@ versions: {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} -4. 在左侧边栏中，单击 **Installed {% data variables.product.prodname_github_app %}s（安装的 GitHub 应用程序）**。 ![组织设置边栏中安装的 {% data variables.product.prodname_github_app %}选项卡](/assets/images/help/organizations/org-settings-installed-github-apps.png) -5. 在您要审查的 {% data variables.product.prodname_github_app %} 旁边，单击 **Configure（配置）**。 ![配置按钮](/assets/images/help/organizations/configure-installed-integration-button.png) -6. 审查 {% data variables.product.prodname_github_app %} 的权限和仓库访问权限。 ![授予 {% data variables.product.prodname_github_app %}所有仓库或特定仓库访问权限的选项](/assets/images/help/organizations/toggle-integration-repo-access.png) - - 要授予 {% data variables.product.prodname_github_app %}所有组织仓库的访问权限，请选择 **All repositories（所有仓库）**。 - - 要选择特定仓库授予应用程序的访问权限，请选择 **Only select repositories（仅选择仓库）**，然后输入仓库名称。 -7. 单击 **Save（保存）**。 +4. In the left sidebar, click **Installed {% data variables.product.prodname_github_app %}s**. + ![Installed {% data variables.product.prodname_github_app %}s tab in the organization settings sidebar](/assets/images/help/organizations/org-settings-installed-github-apps.png) +5. Next to the {% data variables.product.prodname_github_app %} you'd like to review, click **Configure**. + ![Configure button](/assets/images/help/organizations/configure-installed-integration-button.png) +6. Review the {% data variables.product.prodname_github_app %}'s permissions and repository access. + ![Option to give the {% data variables.product.prodname_github_app %} access to all repositories or specific repositories](/assets/images/help/organizations/toggle-integration-repo-access.png) + - To give the {% data variables.product.prodname_github_app %} access to all of your organization's repositories, select **All repositories**. + - To choose specific repositories to give the application access to, select **Only select repositories**, then type a repository name. +7. Click **Save**. diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/setting-base-permissions-for-an-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/setting-base-permissions-for-an-organization.md index ceeedfa47d28..d29c132aff25 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/setting-base-permissions-for-an-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/setting-base-permissions-for-an-organization.md @@ -11,7 +11,7 @@ versions: 您可以在访问组织的任何仓库时设置适用于组织所有成员的基本权限。 基本权限不适用于外部协作者。 -{% if currentVersion == "free-pro-team@latest" %}默认情况下，组织成员具有对组织仓库的**读取**权限。{% endif %} +{% if currentVersion == "free-pro-team@latest" %}By default, members of an organization will have **Read** permissions to the organization's repositories.{% endif %} 如果拥有组织仓库管理员权限的人向组织成员授予更高级别的仓库权限，则更高级别的权限将覆盖基本权限。 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-adding-outside-collaborators.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-adding-outside-collaborators.md index 7c60e14c47ac..9f038f84ec7b 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-adding-outside-collaborators.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-adding-outside-collaborators.md @@ -1,6 +1,6 @@ --- -title: 设置添加外部协作者的权限 -intro: 为了保护组织的数据和组织中使用的付费许可数，您可以只允许所有者邀请外部协作者加入组织仓库。 +title: Setting permissions for adding outside collaborators +intro: 'To protect your organization''s data and the number of paid licenses used in your organization, you can allow only owners to invite outside collaborators to organization repositories.' product: '{% data reusables.gated-features.restict-add-collaborator %}' redirect_from: - /articles/restricting-the-ability-to-add-outside-collaborators-to-organization-repositories/ @@ -10,7 +10,7 @@ versions: enterprise-server: '*' --- -组织所有者和具有仓库管理员权限的成员可以邀请外部协作者处理仓库。 您还可以将外部协作者邀请权限仅限于组织所有者。 +Organization owners, and members with admin privileges for a repository, can invite outside collaborators to work on the repository. You can also restrict outside collaborator invite permissions to only organization owners. {% data reusables.organizations.outside-collaborators-use-seats %} @@ -18,6 +18,7 @@ versions: {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.member-privileges %} -5. 在“Repository invitations（仓库邀请）”下，选择 **Allow members to invite outside collaborators to repositories for this organization（允许成员邀请外部协作者访问本组织的仓库）**。{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} ![Checkbox to allow members to invite outside collaborators to organization repositories](/assets/images/help/organizations/repo-invitations-checkbox-updated.png){% else %} -![Checkbox to allow members to invite outside collaborators to organization repositories](/assets/images/help/organizations/repo-invitations-checkbox.png){% endif %} -6. 单击 **Save（保存）**。 +5. Under "Repository invitations", select **Allow members to invite outside collaborators to repositories for this organization**.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} + ![Checkbox to allow members to invite outside collaborators to organization repositories](/assets/images/help/organizations/repo-invitations-checkbox-updated.png){% else %} + ![Checkbox to allow members to invite outside collaborators to organization repositories](/assets/images/help/organizations/repo-invitations-checkbox.png){% endif %} +6. Click **Save**. diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-deleting-or-transferring-repositories.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-deleting-or-transferring-repositories.md index f243d08cacf5..27a8e0cd0ebc 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-deleting-or-transferring-repositories.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/setting-permissions-for-deleting-or-transferring-repositories.md @@ -1,6 +1,6 @@ --- title: 设置删除或转让仓库的权限 -intro: 您可以允许具有仓库管理员权限的组织成员删除或转让仓库，或者将删除或转让仓库的功能限制为仅组织所有者。 +intro: '您可以允许具有仓库管理员权限的组织成员删除或转让仓库，或者将删除或转让仓库的功能限制为仅组织所有者。' redirect_from: - /articles/setting-permissions-for-deleting-or-transferring-repositories-in-your-organization/ - /articles/setting-permissions-for-deleting-or-transferring-repositories diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/setting-your-teams-profile-picture.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/setting-your-teams-profile-picture.md index d65989579826..047ef8df3c37 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/setting-your-teams-profile-picture.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/setting-your-teams-profile-picture.md @@ -1,6 +1,6 @@ --- title: 设置团队的头像 -intro: 团队维护员和组织所有者可以设置团队的头像，这将在团队的页面中显示。 +intro: '团队维护员和组织所有者可以设置团队的头像，这将在团队的页面中显示。' redirect_from: - /articles/setting-your-team-s-profile-picture - /articles/setting-your-teams-profile-picture diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/transferring-organization-ownership.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/transferring-organization-ownership.md index c058e9bbaf70..dfbe54dab85f 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/transferring-organization-ownership.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/transferring-organization-ownership.md @@ -3,7 +3,7 @@ title: 转让组织所有权 redirect_from: - /articles/needs-polish-how-do-i-give-ownership-to-an-organization-to-someone-else/ - /articles/transferring-organization-ownership -intro: '要使其他人成为组织帐户的所有者，您必须添加新所有者{% if currentVersion == "free-pro-team@latest" %}，确保帐单信息已更新，{% endif %}然后将自身从该帐户中删除。' +intro: 'To make someone else the owner of an organization account, you must add a new owner{% if currentVersion == "free-pro-team@latest" %}, ensure that the billing information is updated,{% endif %} and then remove yourself from the account.' versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md index a40dbe80798c..7e59d8b0a7be 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/upgrading-to-the-corporate-terms-of-service.md @@ -9,7 +9,9 @@ versions: 标准服务条款是 {% data variables.product.prodname_dotcom %} 与您个人之间的协议。 要代表实体（例如公司、非营利性组织或团体）与 {% data variables.product.prodname_dotcom %} 签订协议，组织所有者可升级到公司服务条款。 -1. 联系 {% data variables.contact.contact_support %}以请求升级到公司服务条款。 他们将在组织的仪表板上启用横幅，从而允许您接受公司服务条款。 +1. 联系我们 + +{% data variables.contact.contact_support %} to request an upgrade to the Corporate Terms of Service. 他们将在组织的仪表板上启用横幅，从而允许您接受公司服务条款。 {% data reusables.dashboard.access-org-dashboard %} 3. 在页面顶部，服务条款横幅的右侧，单击 **Sign now（立即签署）**。 ![立即签署按钮](/assets/images/help/organizations/sign-now-button.png) 4. 阅读关于公司服务条款的信息，然后选择 **Yes, I want to sign these terms on behalf of my business.（是，我想代表我的公司签署这些条款。）** ![代表您的公司签署的复选框](/assets/images/help/organizations/sign-on-behalf-business.png) diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization.md index c53ca0c94b54..606721356697 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/viewing-and-managing-a-members-saml-access-to-your-organization.md @@ -1,6 +1,6 @@ --- title: 查看和管理成员对组织的 SAML 访问 -intro: 您可以查看和撤销组织成员的链接身份、活动会话和授权凭据。 +intro: '您可以查看和撤销组织成员的链接身份、活动会话和授权凭据。' permissions: 组织所有者可以查看和管理成员对组织的 SAML 访问。 product: '{% data reusables.gated-features.saml-sso %}' redirect_from: diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/viewing-insights-for-your-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/viewing-insights-for-your-organization.md index bf44bedcaa96..714a8993d96d 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/viewing-insights-for-your-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/viewing-insights-for-your-organization.md @@ -1,6 +1,6 @@ --- title: 查看组织的洞察 -intro: 组织洞察提供有关组织的活动、贡献和依赖项的数据。 +intro: '组织洞察提供有关组织的活动、贡献和依赖项的数据。' product: '{% data reusables.gated-features.org-insights %}' redirect_from: - /articles/viewing-insights-for-your-organization @@ -43,6 +43,6 @@ versions: ### 延伸阅读 - "[关于组织](/github/setting-up-and-managing-organizations-and-teams/about-organizations)" - - "[Exploring the dependencies of a repository](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository)" + - "[探索仓库的依赖项](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository)" - “[更改组织依赖项洞察的可见性](/github/setting-up-and-managing-organizations-and-teams/changing-the-visibility-of-your-organizations-dependency-insights)” - "[在企业帐户中实施关于依赖项洞察的策略](/github/setting-up-and-managing-your-enterprise-account/enforcing-a-policy-on-dependency-insights-in-your-enterprise-account)" diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/viewing-whether-users-in-your-organization-have-2fa-enabled.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/viewing-whether-users-in-your-organization-have-2fa-enabled.md index 28a9b241d99b..c7d06858907a 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/viewing-whether-users-in-your-organization-have-2fa-enabled.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/viewing-whether-users-in-your-organization-have-2fa-enabled.md @@ -1,6 +1,6 @@ --- title: 查看组织中的用户是否已启用 2FA -intro: 您可以查看哪些组织所有者、成员和外部协作者已启用双因素身份验证。 +intro: '您可以查看哪些组织所有者、成员和外部协作者已启用双因素身份验证。' redirect_from: - /articles/viewing-whether-users-in-your-organization-have-2fa-enabled versions: @@ -10,7 +10,7 @@ versions: {% note %} -**注：**您可以要求所有成员{% if currentVersion == "free-pro-team@latest" %}（包括组织中的所有者、帐单管理员和{% else %}{% endif %} 外部协作者）均启用双因素身份验证。 更多信息请参阅“[您的组织中需要双重身份验证](/articles/requiring-two-factor-authentication-in-your-organization)”。 +**Note:** You can require that all members{% if currentVersion == "free-pro-team@latest" %}, including, owners, billing managers and{% else %} and{% endif %} outside collaborators in your organization have two-factor authentication enabled. 更多信息请参阅“[您的组织中需要双重身份验证](/articles/requiring-two-factor-authentication-in-your-organization)”。 {% endnote %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/about-enterprise-accounts.md b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/about-enterprise-accounts.md index cbf2e65ae0a2..99a9751f8f5d 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/about-enterprise-accounts.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/about-enterprise-accounts.md @@ -15,7 +15,7 @@ versions: 企业帐户可用于管理多个 {% data variables.product.prodname_dotcom %} 组织和 {% data variables.product.prodname_ghe_server %} 实例。 您的企业帐户必须有操作点，如 {% data variables.product.prodname_dotcom %} 上的组织或个人帐户。 企业管理员可以管理设置和首选项，如： - 成员访问和管理（组织成员、外部协作者） -- 帐单和使用（{% data variables.product.prodname_ghe_server %} 实例、用户许可、{% data variables.large_files.product_name_short %} 包） +- 计费和使用（{% data variables.product.prodname_ghe_server %} 实例、用户许可、{% data variables.large_files.product_name_short %} 包） - 安全性（单点登录、双重身份验证） - 与 {% data variables.contact.enterprise_support %} 共享请求和支持包 @@ -25,9 +25,7 @@ versions: 有关成员访问和管理的更多信息，请参阅“[管理企业帐户的用户](/articles/managing-users-in-your-enterprise-account)”。 -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} 有关使用 GraphQL API 管理企业帐户的信息，请参阅“[企业帐户](/v4/guides/managing-enterprise-accounts)”。 -{% endif %} ### 管理链接到企业帐户的组织 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/adding-organizations-to-your-enterprise-account.md b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/adding-organizations-to-your-enterprise-account.md index f5a6cf26f877..2e8239ade0e1 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/adding-organizations-to-your-enterprise-account.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/adding-organizations-to-your-enterprise-account.md @@ -23,4 +23,4 @@ versions: 3. 在 "Organization name"（组织名称）下，输入组织的名称。 ![用于输入新组织名称的字段](/assets/images/help/business-accounts/new-organization-name-field.png) 4. 单击 **Create organization（创建组织）**。 5. 在 "Invite owners"（邀请所有者）下，输入您想邀其成为组织所有者的人员的用户名，然后单击 **Invite（邀请）**。 ![组织所有者搜索字段和邀请按钮](/assets/images/help/business-accounts/invite-org-owner.png) -6. Click **Finish**. +6. 单击 **Finish（完成）**。 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md new file mode 100644 index 000000000000..7a75d8c7a30d --- /dev/null +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account.md @@ -0,0 +1,19 @@ +--- +title: Configuring the retention period for GitHub Actions artifacts and logs in your enterprise account +intro: 'Enterprise owners can configure the retention period for {% data variables.product.prodname_actions %} artifacts and logs in an enterprise account.' +product: '{% data reusables.gated-features.enterprise-accounts %}' +miniTocMaxHeadingLevel: 4 +versions: + free-pro-team: '*' + enterprise-server: '>=2.23' +--- + +{% data reusables.actions.about-artifact-log-retention %} + +## Setting the retention period for an enterprise + +{% data reusables.enterprise_site_admin_settings.access-settings %} +{% data reusables.enterprise_site_admin_settings.business %} +{% data reusables.enterprise-accounts.policies-tab %} +{% data reusables.enterprise-accounts.actions-tab %} +{% data reusables.github-actions.change-retention-period-for-artifacts-logs %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/enforcing-a-policy-on-dependency-insights-in-your-enterprise-account.md b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/enforcing-a-policy-on-dependency-insights-in-your-enterprise-account.md index 40680e3769b0..2c0167101207 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/enforcing-a-policy-on-dependency-insights-in-your-enterprise-account.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/enforcing-a-policy-on-dependency-insights-in-your-enterprise-account.md @@ -1,6 +1,6 @@ --- title: 在企业帐户中实施关于依赖项洞察的策略 -intro: 在企业帐户拥有的所有组织中，可以允许或禁止成员查看依赖项洞察，或允许所有者管理组织级别的设置。 +intro: '在企业帐户拥有的所有组织中，可以允许或禁止成员查看依赖项洞察，或允许所有者管理组织级别的设置。' product: '{% data reusables.gated-features.enterprise-accounts %}' redirect_from: - /articles/enforcing-a-policy-on-dependency-insights/ diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account.md b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account.md index 45c608b5493e..b2cb7334c969 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account.md @@ -13,19 +13,32 @@ versions: 有关 {% data variables.product.prodname_actions %} 的更多信息，请参阅“[关于 {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)”。 - ### 管理企业帐户的 {% data variables.product.prodname_actions %} 权限 +You can disable all workflows for an enterprise or set a policy that configures which actions can be used in an organization. + +{% data reusables.actions.actions-use-policy-settings %} + {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.actions-tab %} {% data reusables.actions.enterprise-actions-permissions %} +1. 单击 **Save（保存）**。 + +### Allowing specific actions to run + +{% data reusables.actions.allow-specific-actions-intro %} + +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.policies-tab %} +{% data reusables.enterprise-accounts.actions-tab %} +1. Under **Policies**, select **Allow specific actions** and add your required actions to the list. ![Add actions to allow list](/assets/images/help/organizations/enterprise-actions-policy-allow-list.png) -### Enabling workflows for private repository forks +### 为私有仓库复刻启用工作流程 {% data reusables.github-actions.private-repository-forks-overview %} -#### Configuring the private fork policy for your enterprise account +#### 为企业帐户配置私有复刻策略 {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.policies-tab %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/enforcing-project-board-policies-in-your-enterprise-account.md b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/enforcing-project-board-policies-in-your-enterprise-account.md index 585a7f13b82a..3c48bff2f33a 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/enforcing-project-board-policies-in-your-enterprise-account.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/enforcing-project-board-policies-in-your-enterprise-account.md @@ -1,6 +1,6 @@ --- title: 在企业帐户中实施项目板策略 -intro: 企业所有者可实施企业帐户拥有的所有组织的特定项目板策略，或允许在每个组织中设置策略。 +intro: '企业所有者可实施企业帐户拥有的所有组织的特定项目板策略，或允许在每个组织中设置策略。' product: '{% data reusables.gated-features.enterprise-accounts %}' redirect_from: - /articles/enforcing-project-board-settings-for-organizations-in-your-business-account/ diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account.md b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account.md index ea27f6a99f88..fd75f2f94d0d 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account.md @@ -1,6 +1,6 @@ --- title: 在企业帐户中实施仓库管理策略 -intro: 企业所有者可为企业帐户拥有的所有组织实施特定仓库管理策略，或允许在每个组织中设置策略。 +intro: '企业所有者可为企业帐户拥有的所有组织实施特定仓库管理策略，或允许在每个组织中设置策略。' product: '{% data reusables.gated-features.enterprise-accounts %}' redirect_from: - /articles/enforcing-repository-management-settings-for-organizations-in-your-business-account/ @@ -78,12 +78,12 @@ versions: 3. 在 **Repository policies（仓库策略）**选项卡中的“Repository issue deletion（仓库议题删除）”下，审查有关更改设置的信息。 {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} 4. 在“Repository issue deletion（仓库议题删除）”下，使用下拉菜单并选择策略。 ![带有议题删除策略选项的下拉菜单](/assets/images/help/business-accounts/repository-issue-deletion-policy-drop-down.png) -### Enforcing a policy on the default branch name +### 对默认分支名称实施策略 -Across all organizations owned by your enterprise account, you can set the default branch name for any new repositories that members create. You can choose to enforce that default branch name across all organizations or allow individual organizations to set a different one. +在企业帐户拥有的所有组织中，您可以为成员创建的任何新仓库设置默认分支名称。 您可以选择在所有组织中强制实施默认分支名称，或允许个别组织设置不同的名称。 {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.policies-tab %} -3. On the **Repository policies** tab, under "Default branch name", enter the default branch name that new repositories should use. ![Text box for entering default branch name](/assets/images/help/business-accounts/default-branch-name-text.png) -4. Optionally, to enforce the default branch name for all organizations in the enterprise, select **Enforce across this enterprise**. ![Enforcement checkbox](/assets/images/help/business-accounts/default-branch-name-enforce.png) -5. Click **Update**. ![Update button](/assets/images/help/business-accounts/default-branch-name-update.png) +3. 在 **Repository policies（仓库策略）**选项卡的“Default branch name（默认分支名称）”下，输入新仓库应使用的默认分支名称。 ![输入默认分支名称的文本框](/assets/images/help/business-accounts/default-branch-name-text.png) +4. （可选）要对企业中的所有组织强制实施默认分支名称，请选择 **Enforce across this enterprise（在整个企业中实施）**。 ![强制实施复选框](/assets/images/help/business-accounts/default-branch-name-enforce.png) +5. 单击 **Update（更新）**。 ![更新按钮](/assets/images/help/business-accounts/default-branch-name-update.png) diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/enforcing-security-settings-in-your-enterprise-account.md b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/enforcing-security-settings-in-your-enterprise-account.md index 50cdd353d6d9..69af10c74b1f 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/enforcing-security-settings-in-your-enterprise-account.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/enforcing-security-settings-in-your-enterprise-account.md @@ -73,7 +73,7 @@ versions: {% data reusables.identity-and-permissions.ip-allow-lists-edit-entry %} {% data reusables.identity-and-permissions.ip-allow-lists-edit-ip %} {% data reusables.identity-and-permissions.ip-allow-lists-edit-description %} -8. Click **Update**. +8. 单击 **Update（更新）**。 #### 删除允许的 IP 地址 @@ -101,7 +101,7 @@ versions: {% note %} -**Note:** Enabling authentication with SAML single sign-on for your enterprise account will override any existing organization-level SAML configurations. +**注：**对企业帐户启用 SAML 单点登录身份验证将覆盖任何现有的组织级 SAML 配置。 {% endnote %} @@ -156,7 +156,7 @@ versions: {% data reusables.identity-and-permissions.team-sync-disable %} -You can also configure and manage team synchronization for an individual organization. 更多信息请参阅“[管理组织的团队同步](/github/setting-up-and-managing-organizations-and-teams/managing-team-synchronization-for-your-organization)”。 +您也可以配置和管理单个组织的团队同步。 更多信息请参阅“[管理组织的团队同步](/github/setting-up-and-managing-organizations-and-teams/managing-team-synchronization-for-your-organization)”。 #### 基本要求 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/enforcing-team-policies-in-your-enterprise-account.md b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/enforcing-team-policies-in-your-enterprise-account.md index 8c4c777ae5a8..1104b0b77330 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/enforcing-team-policies-in-your-enterprise-account.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/enforcing-team-policies-in-your-enterprise-account.md @@ -1,6 +1,6 @@ --- title: 在企业帐户中实施团队策略 -intro: 企业所有者可执行企业帐户拥有的所有组织的特定团队策略，或允许在每个组织中设置策略。 +intro: '企业所有者可执行企业帐户拥有的所有组织的特定团队策略，或允许在每个组织中设置策略。' product: '{% data reusables.gated-features.enterprise-accounts %}' redirect_from: - /articles/enforcing-team-settings-for-organizations-in-your-business-account/ diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/index.md b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/index.md index 1f5e16608dc0..943dcc3fd8ba 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/index.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/index.md @@ -14,6 +14,7 @@ versions: {% topic_link_in_list /managing-your-enterprise-account %} {% link_in_list /about-enterprise-accounts %} {% link_in_list /viewing-the-subscription-and-usage-for-your-enterprise-account %} + {% link_in_list /managing-licenses-for-visual-studio-subscription-with-github-enterprise %} {% topic_link_in_list /managing-users-in-your-enterprise-account %} {% link_in_list /roles-for-an-enterprise-account %} {% link_in_list /inviting-people-to-manage-your-enterprise-account %} @@ -32,3 +33,4 @@ versions: {% link_in_list /configuring-saml-single-sign-on-and-scim-for-your-enterprise-account-using-okta %} {% link_in_list /enforcing-a-policy-on-dependency-insights-in-your-enterprise-account %} {% link_in_list /enforcing-github-actions-policies-in-your-enterprise-account %} + {% link_in_list /configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md new file mode 100644 index 000000000000..6facdb2a10d1 --- /dev/null +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise.md @@ -0,0 +1,42 @@ +--- +title: Managing licenses for Visual Studio subscription with GitHub Enterprise +intro: 'You can manage {% data variables.product.prodname_enterprise %} licensing for {% data variables.product.prodname_vss_ghe %}.' +redirect_from: + - /github/setting-up-and-managing-your-enterprise-account/managing-licenses-for-the-github-enterprise-and-visual-studio-bundle + - /github/articles/about-the-github-and-visual-studio-bundle + - /articles/about-the-github-and-visual-studio-bundle +versions: + free-pro-team: '*' +--- + +### 关于 {% data variables.product.prodname_vss_ghe %} + +{% data variables.product.prodname_vss_ghe %} is a combined offering from Microsoft that allows a subscriber to use both {% data variables.product.prodname_enterprise %} and {% data variables.product.prodname_vs %}. {% data variables.product.prodname_vss_ghe %} is available from Microsoft under the terms of the Microsoft Enterprise Agreement. For more information, see [{% data variables.product.prodname_vss_ghe %}](https://visualstudio.microsoft.com/subscriptions/visual-studio-github/) on the {% data variables.product.prodname_vs %} website. + +After you assign a license for {% data variables.product.prodname_vss_ghe %} to a subscriber, the subscriber will use the {% data variables.product.prodname_enterprise %} portion of the license by joining an organization in your enterprise account with a user account on {% data variables.product.prodname_dotcom_the_website %}. + +有关 {% data variables.product.prodname_enterprise %} 的更多信息，请参阅“[{% data variables.product.company_short %} 的产品](/github/getting-started-with-github/githubs-products#github-enterprise)”。 For more information about accounts on {% data variables.product.prodname_dotcom_the_website %}, see "[Types of {% data variables.product.prodname_dotcom %} accounts](/github/getting-started-with-github/types-of-github-accounts)." + +### 基本要求 + +1. After you buy {% data variables.product.prodname_vss_ghe %}, contact {% data variables.contact.contact_enterprise_sales %} and mention "{% data variables.product.prodname_vss_ghe %}." You'll work with the Sales team to create an enterprise account on {% data variables.product.prodname_dotcom_the_website %}. If you already have an enterprise account on {% data variables.product.prodname_dotcom_the_website %}, or if you're not sure, please tell our Sales team. + +2. Assign licenses for {% data variables.product.prodname_vss_ghe %} to subscribers in {% data variables.product.prodname_vss_admin_portal_with_url %}. For more information about assigning licenses, see [Manage {% data variables.product.prodname_vs %} subscriptions with {% data variables.product.prodname_enterprise %}](https://docs.microsoft.com/en-us/visualstudio/subscriptions/assign-github) in the Microsoft Docs. + +3. On {% data variables.product.prodname_dotcom_the_website %}, create at least one organization owned by your enterprise account. For more information, see "[Adding organizations to your enterprise account](/github/setting-up-and-managing-your-enterprise-account/adding-organizations-to-your-enterprise-account)." + +4. The subscriber must create a user account on {% data variables.product.prodname_dotcom_the_website %}, and the email address for the account must be the same email address as the email address in the {% data variables.product.prodname_vs %} portal. For more information, see "[Signing up for {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/signing-up-for-github)" and "[Managing email preferences](/github/setting-up-and-managing-your-github-user-account/managing-email-preferences)." + +### Inviting a subscriber to use {% data variables.product.prodname_enterprise %} + +To use the {% data variables.product.prodname_enterprise %} portion of the license, the subscriber must join an organization owned by your enterprise account on {% data variables.product.prodname_dotcom_the_website %}. Organization owners can invite new members to an organization. For more information, see "[Inviting users to join your organization](/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization)." + +### Viewing {% data variables.product.prodname_enterprise %} licensing + +After assigning a license for {% data variables.product.prodname_vss_ghe %} in {% data variables.product.prodname_vss_admin_portal_with_url %}, you can view the number of {% data variables.product.prodname_enterprise %} licenses available to your enterprise account. 更多信息请参阅"[查看企业帐户的订阅和使用](/github/setting-up-and-managing-your-enterprise-account/viewing-the-subscription-and-usage-for-your-enterprise-account)"。 + +You can also see pending {% data variables.product.prodname_enterprise %} invitations to subscribers in {% data variables.product.prodname_vss_admin_portal_with_url %}. The list of pending invitations includes subscribers who are not yet members of at least one organization in your enterprise account. 更多信息请参阅“[查看企业帐户中的人员](/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account#viewing-members-and-outside-collaborators)”。 + +### 延伸阅读 + +- [Introducing Visual Studio subscriptions with GitHub Enterprise](https://docs.microsoft.com/en-us/visualstudio/subscriptions/access-github) in the Microsoft Docs diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/roles-for-an-enterprise-account.md b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/roles-for-an-enterprise-account.md index c17f4aca1ffc..11ea62e0d3e9 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/roles-for-an-enterprise-account.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/roles-for-an-enterprise-account.md @@ -1,6 +1,6 @@ --- title: 企业帐户的角色 -intro: 要控制对企业帐户的设置和数据的访问权限，您可以为企业帐户中的人员提供不同的角色。 +intro: '要控制对企业帐户的设置和数据的访问权限，您可以为企业帐户中的人员提供不同的角色。' product: '{% data reusables.gated-features.enterprise-accounts %}' redirect_from: - /articles/permission-levels-for-a-business-account/ diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/viewing-and-managing-a-users-saml-access-to-your-enterprise-account.md b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/viewing-and-managing-a-users-saml-access-to-your-enterprise-account.md index 199c81954b85..f4b684bd9967 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/viewing-and-managing-a-users-saml-access-to-your-enterprise-account.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/viewing-and-managing-a-users-saml-access-to-your-enterprise-account.md @@ -1,6 +1,6 @@ --- title: 查看和管理用户对企业帐户的 SAML 访问 -intro: 您可以查看和撤销企业成员的链接身份、活动会话和授权凭据。 +intro: '您可以查看和撤销企业成员的链接身份、活动会话和授权凭据。' permissions: 企业所有者可以查看和管理成员对组织的 SAML 访问。 product: '{% data reusables.gated-features.enterprise-accounts %}' versions: diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account.md b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account.md index 387a45dd7539..2db44fa600ca 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/viewing-people-in-your-enterprise-account.md @@ -1,6 +1,6 @@ --- title: 查看企业帐户中的人员 -intro: 要审核对企业拥有的资源或用户许可证使用的访问权限，企业所有者可以查看企业帐户的每个管理员和成员。 +intro: '要审核对企业拥有的资源或用户许可证使用的访问权限，企业所有者可以查看企业帐户的每个管理员和成员。' product: '{% data reusables.gated-features.enterprise-accounts %}' redirect_from: - /articles/viewing-people-in-your-enterprise-account @@ -16,6 +16,7 @@ versions: {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.people-tab %} {% data reusables.enterprise-accounts.administrators-tab %} +1. Optionally, to view a list of pending invitations, click **_NUMBER_ pending**. !["NUMBER pending" button to the right of search and filter options](/assets/images/help/enterprises/administrators-pending.png) ### 查看成员和外部协作者 @@ -25,7 +26,8 @@ versions: {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.people-tab %} -3. （可选）要查看外部协作者列表而不是成员列表，请单击 **Outside collaborators（外部协作者）**。 ![组织成员页面上的外部协作者选项卡](/assets/images/help/business-accounts/outside-collaborators-tab.png) +1. （可选）要查看外部协作者列表而不是成员列表，请单击 **Outside collaborators（外部协作者）**。 ![组织成员页面上的外部协作者选项卡](/assets/images/help/business-accounts/outside-collaborators-tab.png) +1. Optionally, to view a list of pending invitations, click **_NUMBER_ pending**. !["NUMBER pending" button to the right of search and filter options](/assets/images/help/enterprises/members-pending.png) ### 延伸阅读 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/viewing-the-subscription-and-usage-for-your-enterprise-account.md b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/viewing-the-subscription-and-usage-for-your-enterprise-account.md index 570c84c1ca4d..0d3040596902 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/viewing-the-subscription-and-usage-for-your-enterprise-account.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise-account/viewing-the-subscription-and-usage-for-your-enterprise-account.md @@ -1,6 +1,6 @@ --- title: 查看企业帐户的订阅和使用情况 -intro: 您可以查看企业帐户的当前订阅、许可证使用情况、发票、付款历史记录和其他结算信息。 +intro: '您可以查看企业帐户的当前订阅、许可证使用情况、发票、付款历史记录和其他结算信息。' product: '{% data reusables.gated-features.enterprise-accounts %}' permissions: '企业所有者和帐单管理员均可访问和管理企业帐户的所有帐单设置。 有关管理帐单管理员的更多信息，请参阅“[邀请人员管理您的企业帐户]](/articles/inviting-people-to-manage-your-enterprise-account)”。' redirect_from: @@ -12,7 +12,7 @@ versions: ### 关于企业帐户的计费 -企业帐户目前适用于通过发票付款的 {% data variables.product.prodname_enterprise %} 客户。 对与企业帐户关联的所有组织和 {% data variables.product.prodname_ghe_server %} 实例的结算将汇总为所有付费 {% data variables.product.prodname_dotcom_the_website %} 服务（包括组织中的付费许可、{% data variables.large_files.product_name_long %} 数据包和 {% data variables.product.prodname_marketplace %} 应用程序的订阅）的单一帐单费用。 +企业帐户目前适用于通过发票付费的 {% data variables.product.prodname_enterprise %} 客户。 对与企业帐户关联的所有组织和 {% data variables.product.prodname_ghe_server %} 实例的结算将汇总为所有付费 {% data variables.product.prodname_dotcom_the_website %} 服务（包括组织中的付费许可、{% data variables.large_files.product_name_long %} 数据包和 {% data variables.product.prodname_marketplace %} 应用程序的订阅）的单一帐单费用。 ### 查看企业帐户的订阅和使用情况 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/about-your-organizations-profile.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/about-your-organizations-profile.md index 2abe19347c77..8d4f0f5e1685 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/about-your-organizations-profile.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/about-your-organizations-profile.md @@ -11,7 +11,7 @@ versions: 您可以选择为组织添加说明、地点、网站和电子邮件地址，以及将重要仓库固定于页面顶部。 -{% if currentVersion == "free-pro-team@latest" %}要确认组织的身份并在组织资料页面显示“验证的”徽章，必须向 {% data variables.product.product_name %} 验证组织的域。 更多信息请参阅“[验证组织的域](/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain)”。 +{% if currentVersion == "free-pro-team@latest" %}To confirm your organization's identity and display a "Verified" badge on your organization profile page, you must verify your organization's domains with {% data variables.product.product_name %}. 更多信息请参阅“[验证组织的域](/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain)”。 ![验证过的组织资料页面示例](/assets/images/help/profile/org_profile_verified.png) {% else %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/about-your-profile.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/about-your-profile.md index d39a1689e240..24bf804581e6 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/about-your-profile.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/about-your-profile.md @@ -1,6 +1,6 @@ --- title: 关于您的个人资料 -intro: 您的个人资料向人们讲述您操作感兴趣的仓库的故事、您所做的贡献以及您进行过的对话。 +intro: '您的个人资料向人们讲述您操作感兴趣的仓库的故事、您所做的贡献以及您进行过的对话。' redirect_from: - /articles/viewing-your-feeds/ - /articles/profile-pages/ @@ -16,7 +16,7 @@ versions: {% data reusables.profile.profile-readme %} -![Profile README file displayed on profile](/assets/images/help/repository/profile-with-readme.png) +![个人资料上显示的个人资料自述文件](/assets/images/help/repository/profile-with-readme.png) {% endif %} @@ -26,11 +26,11 @@ versions: - 你拥有或参与的仓库和 gists。 您可以通过将仓库和 Gist 固定到个人资料中来展示您的最佳作品。 更多信息请参阅“[将项目嵌入到个人资料](/github/setting-up-and-managing-your-github-profile/pinning-items-to-your-profile)”。 - 您标星的仓库。 更多信息请参阅“[使用星标保存仓库](/articles/saving-repositories-with-stars/)” -- 您在经常参与的组织、仓库和团队中的活动概述。 更多信息请参阅“[在您的个人资料中显示活动概述](/articles/showing-an-overview-of-your-activity-on-your-profile)”。{% if currentVersion == "free-pro-team@latest" %} +- 您在经常参与的组织、仓库和团队中的活动概述。 For more information, see "[Showing an overview of your activity on your profile](/articles/showing-an-overview-of-your-activity-on-your-profile).{% if currentVersion == "free-pro-team@latest" %} - 为您参与 {% data variables.product.prodname_arctic_vault %}、{% data variables.product.prodname_sponsors %} 或 {% data variables.product.company_short %} 开发者计划等计划做宣传的徽章。 - 您是否在使用 {% data variables.product.prodname_pro %}。 更多信息请参阅“[个性化您的个人资料](/articles/personalizing-your-profile)”。{% endif %} -You can also set a status on your profile to provide information about your availability. 更多信息请参阅“[设置状态](/articles/personalizing-your-profile/#setting-a-status)”。 +您还可以在个人资料上设置状态，以提供有关您的可用性的信息。 更多信息请参阅“[设置状态](/articles/personalizing-your-profile/#setting-a-status)”。 ### 延伸阅读 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile.md index f76c0330aa5a..147833e24439 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile.md @@ -1,6 +1,6 @@ --- title: 管理个人资料中的贡献图 -intro: 您的贡献（包括提交、提议的拉取请求和打开的议题）将显示在个人资料中，便于人们轻松看到您所做的工作。 +intro: '您的贡献（包括提交、提议的拉取请求和打开的议题）将显示在个人资料中，便于人们轻松看到您所做的工作。' mapTopic: true redirect_from: - /articles/managing-contribution-graphs-on-your-profile diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/managing-your-profile-readme.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/managing-your-profile-readme.md index 2b7a858c696e..0eef53fee2df 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/managing-your-profile-readme.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/managing-your-profile-readme.md @@ -1,63 +1,63 @@ --- -title: Managing your profile README -intro: 'You can add a README to your {% data variables.product.prodname_dotcom %} profile to tell other people about yourself.' +title: 管理个人资料自述文件 +intro: '可以向您的 {% data variables.product.prodname_dotcom %} 个人资料添加自述文件以向其他人介绍自己。' versions: free-pro-team: '*' enterprise-server: '>=2.22' --- -### About your profile README +### 关于您的个人资料自述文件 -You can share information about yourself with the community on {% data variables.product.prodname_dotcom %} by creating a profile README. {% data variables.product.prodname_dotcom %} shows your profile README at the top of your profile page. +通过创建个人资料自述文件，您可以与 {% data variables.product.prodname_dotcom %} 上的社区分享有关自己的信息。 {% data variables.product.prodname_dotcom %} 在个人资料页面的顶部显示您的个人资料自述文件。 -You decide what information to include in your profile README, so you have full control over how you present yourself on {% data variables.product.prodname_dotcom %}. Here are some examples of information that visitors may find interesting, fun, or useful in your profile README. +您决定在个人资料自述文件中包含哪些信息，因此您可以完全控制如何在 {% data variables.product.prodname_dotcom %} 上展示自己。 以下是访客可能在您的个人资料自述文件中找到感兴趣、有趣或有用信息的一些示例。 -- An "About me" section that describes your work and interests -- Contributions you're proud of, and context about those contributions -- Guidance for getting help in communities where you're involved +- “About me（关于我）”部分介绍您的工作和兴趣。 +- 您引以为豪的贡献以及这些贡献的背景信息 +- 在您参与的社区获得帮助的指南 -![Profile README file displayed on profile](/assets/images/help/repository/profile-with-readme.png) +![个人资料上显示的个人资料自述文件](/assets/images/help/repository/profile-with-readme.png) -You can format text and include emoji, images, and GIFs in your profile README by using {% data variables.product.company_short %} Flavored Markdown. 更多信息请参阅“[在 {% data variables.product.prodname_dotcom %} 上编写和设置格式](/github/writing-on-github/getting-started-with-writing-and-formatting-on-github)”。 +您可以使用 {% data variables.product.company_short %} Flavored Markdown 在个人资料自述文件中设置文本格式和包含表情符号、图像及 GIF。 更多信息请参阅“[在 {% data variables.product.prodname_dotcom %} 上编写和设置格式](/github/writing-on-github/getting-started-with-writing-and-formatting-on-github)”。 ### 基本要求 -GitHub will display your profile README on your profile page if all of the following are true. +如果满足以下所有条件，GitHub 将在您的个人资料页面显示您的个人资料自述文件。 -- You've created a repository with a name that matches your {% data variables.product.prodname_dotcom %} username. -- The repository is public. -- The repository contains a file named README.md in its root. -- The README.md file contains any content. +- 您使用与您的 {% data variables.product.prodname_dotcom %} 用户名匹配的名称创建了仓库。 +- 该仓库为公共仓库。 +- 仓库的根目录中包含名为 README.md 的文件。 +- README.md 文件包含任何内容。 {% note %} -**Note**: If you created a public repository with the same name as your username before July 2020, {% data variables.product.prodname_dotcom %} won't automatically show the repository's README on your profile. You can manually share the repository's README to your profile by going to the repository on {% data variables.product.prodname_dotcom_the_website %} and clicking **Share to profile**. +**注**：如果您在 2020 年 7 月之前创建了一个与您的用户名同名的公共仓库，{% data variables.product.prodname_dotcom %} 不会自动在您的个人资料上显示该仓库的自述文件。 您可以转到 {% data variables.product.prodname_dotcom_the_website %} 上的仓库，然后单击 **Share to profile（分享到个人资料）**，从而手动将仓库的自述文件分享到您的个人资料。 -![Button to share README to profile](/assets/images/help/repository/share-to-profile.png) +![将自述文件分享到个人资料的按钮](/assets/images/help/repository/share-to-profile.png) {% endnote %} -### Adding a profile README +### 添加个人资料自述文件 {% data reusables.repositories.create_new %} -2. Under "Repository name", type a repository name that matches your {% data variables.product.prodname_dotcom %} username. For example, if your username is "octocat", the repository name must be "octocat". ![Repository name field which matches username](/assets/images/help/repository/repo-username-match.png) -3. （可选）添加仓库的说明。 For example, "My personal repository." ![用于输入仓库说明的字段](/assets/images/help/repository/create-personal-repository-desc.png) -4. Select **Public**. ![Radio button to select visibility with public selected](/assets/images/help/repository/create-personal-repository-visibility.png) +2. 在“Repository name（仓库名称）”下，输入与您的 {% data variables.product.prodname_dotcom %} 用户名匹配的仓库名称。 例如，如果您的用户名是 "octocat"，则仓库名称必须为 "octocat"。 ![与用户名匹配的仓库名称字段](/assets/images/help/repository/repo-username-match.png) +3. （可选）添加仓库的说明。 例如，“My personal repository（我的个人仓库）”。 ![用于输入仓库说明的字段](/assets/images/help/repository/create-personal-repository-desc.png) +4. 选择 **Public（公共）**。 ![选择公共仓库可见性的单选按钮](/assets/images/help/repository/create-personal-repository-visibility.png) {% data reusables.repositories.initialize-with-readme %} {% data reusables.repositories.create-repo %} -7. Above the right sidebar, click **Edit README**. ![Button to edit README file](/assets/images/help/repository/personal-repository-edit-readme.png) +7. 在左边栏上，单击 **Edit README（编辑自述文件）**。 ![编辑自述文件的按钮](/assets/images/help/repository/personal-repository-edit-readme.png) - The generated README file is pre-populated with a template to give you some inspiration for your profile README. ![README file with pre-populated template](/assets/images/help/repository/personal-repository-readme-template.png) + 生成的自述文件用模板预先填充，为您创建个人资料自述文件提供一些启发。 ![带有预填充模板的自述文件](/assets/images/help/repository/personal-repository-readme-template.png) -### Removing a profile README +### 删除个人资料自述文件 -The profile README is removed from your {% data variables.product.prodname_dotcom %} profile if any of the following apply: +如果以下任何一项适用，个人资料自述文件将从您的 {% data variables.product.prodname_dotcom %} 个人资料中被删除： -- The README file is empty or doesn't exist. -- The repository is private. -- The repository name no longer matches your username. +- 自述文件为空或不存在。 +- 该仓库为私有仓库。 +- 仓库名称不再与您的用户名匹配。 -The method you choose depends upon your needs, but if you're unsure, we recommend making your repository private. For steps on how to make your repository private, see ["Changing a repository's visibility."](/github/administering-a-repository/setting-repository-visibility#changing-a-repositorys-visibility) +您选择的方法取决于您的需求，但如果您不确定，我们建议您将仓库设为私有。 有关如何将仓库设为私有的步骤，请参阅[“更改仓库的可见性”](/github/administering-a-repository/setting-repository-visibility#changing-a-repositorys-visibility)。 ### 延伸阅读 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md index 5b66d154e6a0..d44cea2cf0eb 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/personalizing-your-profile.md @@ -40,7 +40,7 @@ versions: ### 更改个人资料名称 -您可以更改显示在个人资料中的名称。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %}此名称也可能显示在您对组织拥有的私有仓库所发表的评论旁边。 更多信息请参阅“[管理组织中成员名称的显示](/articles/managing-the-display-of-member-names-in-your-organization)”。{% endif %} +您可以更改显示在个人资料中的名称。 This name may also be displayed next to comments you make on private repositories owned by an organization. 更多信息请参阅“[管理组织中成员名称的显示](/articles/managing-the-display-of-member-names-in-your-organization)”。 {% data reusables.user_settings.access_settings %} 2. 在“Name（名称）”下，键入要显示在个人资料中的名称。 ![个人资料设置中的名称字段](/assets/images/help/profile/name-field.png) @@ -51,7 +51,7 @@ versions: {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -For a longer-form and more prominent way of displaying customized information about yourself, you can also use a profile README. For more information on the profile README, see "[Managing your profile README](/github/setting-up-and-managing-your-github-profile/managing-your-profile-readme)." +要以更长和更突出的方式显示有关自己的自定义信息，您还可以使用个人资料自述文件。 有关个人资料自述文件的更多信息，请参阅“[管理个人资料自述文件](/github/setting-up-and-managing-your-github-profile/managing-your-profile-readme)”。 {% endif %} @@ -101,12 +101,12 @@ For a longer-form and more prominent way of displaying customized information ab 当您参与某些计划时， {% data variables.product.prodname_dotcom %} 会自动在您的个人资料中显示徽章。 -| 徽章 | 计划 | 描述 | -| --------------------------------------------------------------- | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| {% octicon "north-star" aria-label="The North Star icon" %} | **{% data variables.product.prodname_arctic_vault %} 贡献者** | 如果您在存档于 2020 Arctic Vault 计划的仓库默认分支上编写了任何提交，您的个人资料上会获得一个 {% data variables.product.prodname_arctic_vault %} 贡献者徽章。 有关该计划的更多信息，请参阅 [{% data variables.product.prodname_archive %}](https://archiveprogram.github.com)。 | -| {% octicon "cpu" aria-label="The Developer Program icon" %} | **开发者计划成员** | 如果您是 GitHub 开发者计划的注册成员，使用 GitHub API 构建应用程序后，您的个人资料上将获得开发者计划成员徽章。 有关 GitHub 开发者计划的更多信息，请参阅 [GitHub 开发者](/program/)。 | -| {% octicon "heart-fill" aria-label="The GitHub Sponsor icon" %} | **GitHub 赞助者** | 如果您通过 {% data variables.product.prodname_sponsors %} 赞助了开源贡献者，您的个人资料中将获得一个 GitHub Sponge 徽章。 更多信息请参阅“[赞助开源贡献者](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-open-source-contributors)”。 | -| {% octicon "star-fill" aria-label="The star icon" %} | **Pro** | 如果您使用 {% data variables.product.prodname_pro %}，您的个人资料中将获得一个 PRO 徽章。 有关 {% data variables.product.prodname_pro %} 的更多信息，请参阅“[{% data variables.product.prodname_dotcom %} 的产品](/github/getting-started-with-github/githubs-products#github-pro)”。 | +| 徽章 | 计划 | 描述 | +| --------------------------------------------------------------- | ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| {% octicon "north-star" aria-label="The North Star icon" %} | **{% data variables.product.prodname_arctic_vault %} 贡献者** | 如果您在存档于 2020 Arctic Vault 计划的仓库默认分支上编写了任何提交，您的个人资料上会获得一个 {% data variables.product.prodname_arctic_vault %} 贡献者徽章。 有关该计划的更多信息，请参阅 [{% data variables.product.prodname_archive %}](https://archiveprogram.github.com)。 | +| {% octicon "cpu" aria-label="The Developer Program icon" %} | **开发者计划成员** | 如果您是 GitHub 开发者计划的注册成员，使用 GitHub API 构建应用程序后，您的个人资料上将获得开发者计划成员徽章。 有关 GitHub 开发者计划的更多信息，请参阅 [GitHub 开发者](/program/)。 | +| {% octicon "heart-fill" aria-label="The GitHub Sponsor icon" %} | **GitHub 赞助者** | 如果您通过 {% data variables.product.prodname_sponsors %} 赞助了开源贡献者，您的个人资料中将获得一个 GitHub Sponge 徽章。 更多信息请参阅“[赞助开源贡献者](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-open-source-contributors)”。 | +| {% octicon "star-fill" aria-label="The star icon" %} | **Pro** | 如果您使用 {% data variables.product.prodname_pro %}，您的个人资料中将获得一个 PRO 徽章。 有关 {% data variables.product.prodname_pro %} 的更多信息，请参阅“[{% data variables.product.prodname_dotcom %} 的产品](/github/getting-started-with-github/githubs-products#github-pro)”。 | ### 在个人资料中禁用徽章 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/pinning-items-to-your-profile.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/pinning-items-to-your-profile.md index fb718d1085d6..7367dc0d1480 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/pinning-items-to-your-profile.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/pinning-items-to-your-profile.md @@ -1,6 +1,6 @@ --- title: 在个人资料中嵌入项目 -intro: '您可以将 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.16" %}Gist 和{% endif %}仓库嵌入您的个人资料中，以便其他人能够快速查看您的最佳作品。' +intro: 'You can pin {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.16" %}gists and {% endif %}repositories to your profile so other people can quickly see your best work.' redirect_from: - /articles/pinning-repositories-to-your-profile/ - /articles/pinning-items-to-your-profile @@ -11,7 +11,7 @@ versions: 您可以嵌入您拥有的或者对其做出了贡献的公共仓库。 对复刻的提交不计为贡献，因此不能嵌入非自己所有的复刻。 更多信息请参阅“[为什么我的贡献没有在我的个人资料中显示？](/articles/why-are-my-contributions-not-showing-up-on-my-profile)” -You can pin any public gist you own. +您可以置顶自己的任何公开 Gist。 固定项包括有关项目的重要信息，例如仓库收到的星标数或 Gist 的前几行。 在将项目嵌入到个人资料后，个人资料中的“Pinned（已嵌入）”部分将替换“Popular repositories（常用仓库）”部分。 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/troubleshooting-commits-on-your-timeline.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/troubleshooting-commits-on-your-timeline.md index 7fa344e18d50..2a3392a8c662 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/troubleshooting-commits-on-your-timeline.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/troubleshooting-commits-on-your-timeline.md @@ -1,6 +1,6 @@ --- title: 对时间表上的提交进行故障排除 -intro: 您可以从个人资料的时间表查看提交的详细信息。 如果没有在个人资料中看到预期的提交，或者无法从个人资料页面找到提交详细信息，则提交日期和提交创作日期可能不同。 +intro: '您可以从个人资料的时间表查看提交的详细信息。 如果没有在个人资料中看到预期的提交，或者无法从个人资料页面找到提交详细信息，则提交日期和提交创作日期可能不同。' redirect_from: - /articles/troubleshooting-commits-on-your-timeline versions: diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/viewing-contributions-on-your-profile.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/viewing-contributions-on-your-profile.md index 435da069d9dd..6821a119a5d9 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/viewing-contributions-on-your-profile.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/viewing-contributions-on-your-profile.md @@ -25,7 +25,7 @@ versions: - 提交到仓库的默认分支或 `gh-pages` 分支 - 打开议题 - 提议拉取请求 -- 提交拉取请求审查{% if currentVersion != "free-pro-team@latest" %} +- Submitting a pull request review{% if currentVersion != "free-pro-team@latest" %} - 合作创作仓库默认分支或 `gh-pages` 分支中的提交{% endif %} {% data reusables.pull_requests.pull_request_merges_and_contributions %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/why-are-my-contributions-not-showing-up-on-my-profile.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/why-are-my-contributions-not-showing-up-on-my-profile.md index cecabe24fa60..04ba72a83ca6 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/why-are-my-contributions-not-showing-up-on-my-profile.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-profile/why-are-my-contributions-not-showing-up-on-my-profile.md @@ -19,7 +19,7 @@ versions: - 用于提交的电子邮件地址与您的 {% data variables.product.product_name %} 帐户关联。 - 提交在独立的仓库而不是复刻中进行。 - 提交在以下位置进行： - - In the repository's default branch + - 在仓库的默认分支中 - 在 `gh-pages` 分支中（对于包含项目站点的仓库） 有关项目网站的更多信息，请参阅“[关于 {% data variables.product.prodname_pages %}](/github/working-with-github-pages/about-github-pages#types-of-github-pages-sites)”。 @@ -42,7 +42,7 @@ versions: Commits must be made with an email address that has been added to your {% data variables.product.product_name %} account{% if currentVersion == "free-pro-team@latest" %}, or the {% data variables.product.product_name %}-provided `noreply` email address provided to you in your email settings,{% endif %} in order to appear on your contributions graph.{% if currentVersion == "free-pro-team@latest" %} For more information about `noreply` email addresses, see "[Setting your commit email address](/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address#about-commit-email-addresses)."{% endif %} -You can check the email address used for a commit by adding `.patch` to the end of a commit URL, e.g. https://github.com/octocat/octocat.github.io/commit/67c0afc1da354d8571f51b6f0af8f2794117fd10.patch: +您可以通过将 `.patch` 添加到提交 URL 结尾来检查用于提交的电子邮件地址，例如 https://github.com/octocat/octocat.github.io/commit/67c0afc1da354d8571f51b6f0af8f2794117fd10.patch： ``` From 67c0afc1da354d8571f51b6f0af8f2794117fd10 Mon Sep 17 00:00:00 2001 @@ -63,11 +63,11 @@ Subject: [PATCH] updated index for better welcome message #### 提交没有在默认或 `gh-pages` 分支中进行 -Commits are only counted if they are made in the default branch or the `gh-pages` branch (for repositories with project sites). For more information, see "[About {% data variables.product.prodname_pages %}](/github/working-with-github-pages/about-github-pages#types-of-github-pages-sites)." +仅发生在默认分支或 `gh-pages` 分支（对于包含项目站点的仓库）中的提交才会计入。 更多信息请参阅“[关于 {% data variables.product.prodname_pages %}](/github/working-with-github-pages/about-github-pages#types-of-github-pages-sites)”。 如果您的提交位于非默认或非 `gh-pages` 分支中，并且您希望将其计入您的贡献，则需要执行以下操作之一： - [打开拉取请求](/articles/creating-a-pull-request)以将您的更改合并到默认分支或 `gh-pages` 分支。 -- [更改仓库的默认分支](/articles/setting-the-default-branch)。 +- [更改仓库的默认分支](/github/administering-a-repository/changing-the-default-branch)。 {% warning %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/about-your-personal-dashboard.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/about-your-personal-dashboard.md index f9e438e6b688..9ee55297ca9b 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/about-your-personal-dashboard.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/about-your-personal-dashboard.md @@ -4,7 +4,7 @@ redirect_from: - /hidden/about-improved-navigation-to-commonly-accessed-pages-on-github/ - /articles/opting-into-the-public-beta-for-a-new-dashboard/ - /articles/about-your-personal-dashboard -intro: 您可以访问个人仪表板，以跟踪您参与或关注的议题和拉取请求，浏览常用仓库和团队页面，了解您订阅的组织和仓库中近期活动的最新信息，以及探索推荐的仓库。 +intro: '您可以访问个人仪表板，以跟踪您参与或关注的议题和拉取请求，浏览常用仓库和团队页面，了解您订阅的组织和仓库中近期活动的最新信息，以及探索推荐的仓库。' versions: free-pro-team: '*' enterprise-server: '*' @@ -46,7 +46,7 @@ versions: ### 探索推荐的仓库 -在仪表板右侧的“Explore repositories（浏览仓库）”部分，您可以浏览社区中推荐的仓库。 建议基于您已经标星或访问过的仓库、您关注的人以及您可以访问的仓库中的活动。{% if currentVersion == "free-pro-team@latest" %} 更多信息请参阅“[寻找在 {% data variables.product.prodname_dotcom %} 上参与开源项目的方法](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)”。{% endif %} +在仪表板右侧的“Explore repositories（浏览仓库）”部分，您可以浏览社区中推荐的仓库。 Recommendations are based on repositories you've starred or visited, the people you follow, and activity within repositories that you have access to.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[Finding ways to contribute to open source on {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)."{% endif %} ### 延伸阅读 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/accessing-an-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/accessing-an-organization.md index 9da39c72a78a..cdc0bc856b65 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/accessing-an-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/accessing-an-organization.md @@ -1,6 +1,6 @@ --- title: 访问组织 -intro: 要访问您是其成员的组织，必须登录您的个人用户帐户。 +intro: '要访问您是其成员的组织，必须登录您的个人用户帐户。' redirect_from: - /articles/error-cannot-log-in-that-account-is-an-organization/ - /articles/cannot-log-in-that-account-is-an-organization/ diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/best-practices-for-leaving-your-company.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/best-practices-for-leaving-your-company.md index e5a9280ba401..87c43014e0fd 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/best-practices-for-leaving-your-company.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/best-practices-for-leaving-your-company.md @@ -1,6 +1,6 @@ --- title: 关于离开公司的最佳实践 -intro: 换工作是不可回避的生活现实。 如果您的 GitHub 用户帐户同时用于个人*和*工作用途，那么您在离开公司或组织的时候需要注意一些问题。 +intro: '换工作是不可回避的生活现实。 如果您的 GitHub 用户帐户同时用于个人*和*工作用途，那么您在离开公司或组织的时候需要注意一些问题。' redirect_from: - /articles/best-practices-for-leaving-your-company versions: diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/blocking-command-line-pushes-that-expose-your-personal-email-address.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/blocking-command-line-pushes-that-expose-your-personal-email-address.md index 672e4856ef9c..3d1b70df758d 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/blocking-command-line-pushes-that-expose-your-personal-email-address.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/blocking-command-line-pushes-that-expose-your-personal-email-address.md @@ -1,6 +1,6 @@ --- title: 阻止会暴露个人电子邮件地址的命令行推送 -intro: 如果选择了在执行基于 web 的 Git 操作中保密您的电子邮件地址，您还可以选择阻止可能暴露您个人电子邮件地址的命令行推送。 +intro: '如果选择了在执行基于 web 的 Git 操作中保密您的电子邮件地址，您还可以选择阻止可能暴露您个人电子邮件地址的命令行推送。' redirect_from: - /articles/blocking-command-line-pushes-that-expose-your-personal-email-address versions: diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/changing-your-github-username.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/changing-your-github-username.md index 8b7681fd8d2c..8140f491016e 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/changing-your-github-username.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/changing-your-github-username.md @@ -1,6 +1,6 @@ --- -title: 更改 GitHub 用户名 -intro: '您可以随时更改自己的 {% data variables.product.product_name %} 用户名。' +title: Changing your GitHub username +intro: 'You can change your {% data variables.product.product_name %} username at any time.' redirect_from: - /articles/how-to-change-your-username/ - /articles/changing-your-github-user-name/ @@ -12,46 +12,50 @@ versions: enterprise-server: '*' --- -### 关于用户名更改 +### About username changes -您可以将用户名更改为当前未使用的另一个用户名。{% if currentVersion == "free-pro-team@latest" %} 如果所需的用户名不可用，您在键入所需的用户名时将看到您是否可以申请释放该用户名的信息。 +You can change your username to another username that is not currently in use.{% if currentVersion == "free-pro-team@latest" %} If the username you want is not available, you'll see information about whether you can request the username to be released when you type in the desired username. -如果该用户名不符合释放条件，并且您不持有该用户名的商标，则可选择其他用户名或保留您当前的用户名。 {% data variables.contact.github_support %} 无法为您释放不可用的用户名。 更多信息请参阅“[更改用户名](#changing-your-username)”。{% endif %} +If the username is not eligible for release and you don't hold a trademark for the username, you can choose another username or keep your current username. {% data variables.contact.github_support %} cannot release the unavailable username for you. For more information, see "[Changing your username](#changing-your-username)."{% endif %} -更改用户名后，您的旧用户名即可供其他人申请使用。 对旧用户名下仓库的大多数引用会自动更改为新用户名。 不过，指向您个人资料的某些链接不会自动重定向。 +After changing your username, your old username becomes available for anyone else to claim. Most references to your repositories under the old username automatically change to the new username. However, some links to your profile won't automatically redirect. -{% data variables.product.product_name %} 无法为以下各项设置重定向： -- 使用旧用户名的[@提及](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams) -- 包含旧用户名的 [gists](/articles/creating-gists) 链接 +{% data variables.product.product_name %} cannot set up redirects for: +- [@mentions](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams) using your old username +- Links to [gists](/articles/creating-gists) that include your old username -### 仓库引用 +### Repository references -您更改用户名后，{% data variables.product.product_name %} 自动将引用重定向到您的仓库。 -- 指向现有仓库的 Web 链接仍然有效。 进行更改后，可能需要几分钟时间才能完成。 -- 从本地仓库克隆推送到旧的远程跟踪 URL 的命令行仍然有效。 +After you change your username, {% data variables.product.product_name %} will automatically redirect references to your repositories. +- Web links to your existing repositories will continue to work. This can take a few minutes to complete after you make the change. +- Command line pushes from your local repository clones to the old remote tracking URLs will continue to work. -如果旧用户名的新所有者创建与您的仓库同名的仓库，则会覆盖重定向条目，并且您的重定向将停止工作。 由于这种可能性，我们建议您在更改用户名后更新所有现有的远程仓库 URL。 更多信息请参阅“[更改远程的 URL](/articles/changing-a-remote-s-url)”。 +If the new owner of your old username creates a repository with the same name as your repository, that will override the redirect entry and your redirect will stop working. Because of this possibility, we recommend you update all existing remote repository URLs after changing your username. For more information, see "[Changing a remote's URL](/articles/changing-a-remote-s-url)." -### 指向以前的个人资料页面的链接 +### Links to your previous profile page -更改用户名后，指向以前的个人资料页面的链接（例如 `https://{% data variables.command_line.backticks %}/previoususername`）将返回 404 错误。 我们建议从其他位置更新指向 {% data variables.product.product_name %} 帐户的所有链接{% if currentVersion == "free-pro-team@latest" %}，例如您的 LinkedIn 或 Twitter 个人资料{% endif %}。 +After changing your username, links to your previous profile page, such as `https://{% data variables.command_line.backticks %}/previoususername`, will return a 404 error. We recommend updating any links to your {% data variables.product.product_name %} account from elsewhere{% if currentVersion == "free-pro-team@latest" %}, such as your LinkedIn or Twitter profile{% endif %}. -### 您的 Git 提交 +### Your Git commits -{% if currentVersion == "free-pro-team@latest"%}与您的 {% data variables.product.product_name %} 提供的 `noreply` 电子邮件地址关联的 Git 提交不会归于新的用户名，并且不会在您的贡献图中显示。{% endif %}如果您的 Git 提交与您已[添加到 GitHub 帐户](/articles/adding-an-email-address-to-your-github-account)的其他电子邮件地址关联，{% if currentVersion == "free-pro-team@latest"%}包括基于 ID 的 {% data variables.product.product_name %} 提供的 `noreply` 电子邮件地址，{% endif %}它们在您更改用户名后将继续归于您并在您的贡献图中显示。 有关设置电子邮件地址的更多详细信息，请参阅“[设置您的提交电子邮件地址](/articles/setting-your-commit-email-address)”。 +{% if currentVersion == "free-pro-team@latest"%}Git commits that were associated with your {% data variables.product.product_name %}-provided `noreply` email address won't be attributed to your new username and won't appear in your contributions graph.{% endif %} If your Git commits are associated with another email address you've [added to your GitHub account](/articles/adding-an-email-address-to-your-github-account), {% if currentVersion == "free-pro-team@latest"%}including the ID-based {% data variables.product.product_name %}-provided `noreply` email address, {% endif %}they'll continue to be attributed to you and appear in your contributions graph after you've changed your username. For more information on setting your email address, see "[Setting your commit email address](/articles/setting-your-commit-email-address)." -### 更改用户名 +### Changing your username {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.account_settings %} -3. 在“Change username（更改用户名）”部分，单击 **Change username（更改用户名）**。 ![Change Username button](/assets/images/help/settings/settings-change-username.png){% if currentVersion == "free-pro-team@latest" %} -4. 阅读有关更改用户名的警告。 如果您仍要更改用户名，请单击 **I understand, let's change my username（我了解，让我们更改用户名）**。 ![更改用户名警告按钮](/assets/images/help/settings/settings-change-username-warning-button.png) -5. 键入新的用户名。 ![新用户名字段](/assets/images/help/settings/settings-change-username-enter-new-username.png) -6. 如果您选择的用户名可用，请单击 **Change my username（更改我的用户名）**。 如果您选择的用户名不可用，可以尝试其他用户名或您看到的建议之一。 ![更改用户名警告按钮](/assets/images/help/settings/settings-change-my-username-button.png) +3. In the "Change username" section, click **Change username**. + ![Change Username button](/assets/images/help/settings/settings-change-username.png){% if currentVersion == "free-pro-team@latest" %} +4. Read the warnings about changing your username. If you still want to change your username, click **I understand, let's change my username**. + ![Change Username warning button](/assets/images/help/settings/settings-change-username-warning-button.png) +5. Type a new username. + ![New username field](/assets/images/help/settings/settings-change-username-enter-new-username.png) +6. If the username you've chosen is available, click **Change my username**. If the username you've chosen is unavailable, you can try a different username or one of the suggestions you see. + ![Change Username warning button](/assets/images/help/settings/settings-change-my-username-button.png) {% endif %} -### 延伸阅读 +### Further reading -- “[更改远程的 URL](/articles/changing-a-remote-s-url)” -- “[我的提交为什么链接到错误的用户？](/articles/why-are-my-commits-linked-to-the-wrong-user)”{% if currentVersion == "free-pro-team@latest" %} -- "[{% data variables.product.prodname_dotcom %} 用户名策略](/articles/github-username-policy)"{% endif %} +- "[Changing a remote's URL](/articles/changing-a-remote-s-url)" +- "[Why are my commits linked to the wrong user?](/articles/why-are-my-commits-linked-to-the-wrong-user)"{% if currentVersion == "free-pro-team@latest" %} +- "[{% data variables.product.prodname_dotcom %} Username Policy](/articles/github-username-policy)"{% endif %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md index 248408597e0a..aa32121fa50c 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address.md @@ -8,14 +8,21 @@ versions: enterprise-server: '*' --- +{% note %} + +如果要添加新电子邮件地址以设置为您的主电子邮件地址，请在“Add email address（添加电子邮件地址）”下，键入新的电子邮件地址，然后单击 **Add（添加）**。 + +{% endnote %} + {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.emails %} 3. 如果要添加新电子邮件地址以设置为您的主电子邮件地址，请在“Add email address（添加电子邮件地址）”下，键入新的电子邮件地址，然后单击 **Add（添加）**。 ![添加其他电子邮件地址按钮](/assets/images/help/settings/add_another_email_address.png) 4. 在“Primary email address（主电子邮件地址）”下，使用下拉菜单，单击要设为主电子邮件地址的电子邮件地址，然后单击 **Save（保存）**。 ![设为主电子邮件地址按钮](/assets/images/help/settings/set_as_primary_email.png) -5. To remove the old email address from your account, next to the old email, click +5. 要从帐户中删除旧电子邮件地址，请在旧电子邮件地址旁边单击 {% octicon "trashcan" aria-label="The trashcan symbol" %}. {% if currentVersion == "free-pro-team@latest" %} -6. 验证新的主电子邮件地址。 如果没有经验证的电子邮件地址，您将无法使用 {% data variables.product.product_name %} 的所有功能。 更多信息请参阅“[验证电子邮件地址](/articles/verifying-your-email-address)”。 +6. 验证新的主电子邮件地址。 Without a verified email address, you won't be able to use all of +{% data variables.product.product_name %}'s features. 更多信息请参阅“[验证电子邮件地址](/articles/verifying-your-email-address)”。 {% endif %} ### 延伸阅读 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md index c2404f268735..c572f9f8564a 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization.md @@ -17,7 +17,7 @@ versions: - 您将**不再**能够登录被转换的用户帐户。 - 您将**不再**能够创建或修改被转换的用户帐户所拥有的 Gist。 - **无法**将组织转换回用户。 - - SSH 密钥、OAuth 令牌、作业档案、{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} 反应、{% endif %}及关联的用户信息**不会**传输到组织。 这只适用于被转换的用户帐户，而不适用于该用户帐户的任何协作者。 + - The SSH keys, OAuth tokens, job profile, reactions, and associated user information, **will not** be transferred to the organization. 这只适用于被转换的用户帐户，而不适用于该用户帐户的任何协作者。 - 使用被转换用户帐户进行的任何提交**将不再链接**到该帐户。 提交本身**将**保持原状。 {% endwarning %} @@ -35,7 +35,7 @@ versions: 也可以将个人用户帐户直接转换为组织。 转换帐户： - 按原样保留仓库，无需手动将其转让给另一个帐户 - 自动邀请协作者加入与他们以前的权限相当的团队 - {% if currentVersion == "free-pro-team@latest" %}-对 {% data variables.product.prodname_pro %} 上的用户帐户，自动将帐单转移到[付费 {% data variables.product.prodname_team %}](/articles/about-billing-for-github-accounts)，任何时候都无需重新输入付款信息、调整结算周期或双重付费{% endif %} + {% if currentVersion == "free-pro-team@latest" %}- For user accounts on {% data variables.product.prodname_pro %}, automatically transitions billing to [the paid {% data variables.product.prodname_team %}](/articles/about-billing-for-github-accounts) without the need to re-enter payment information, adjust your billing cycle, or double pay at any time{% endif %} 1. 创建新的个人帐户，转换后您将用它来登录 GitHub 以及访问组织和仓库。 2. [离开](/articles/removing-yourself-from-an-organization)要转换的用户帐户此前加入的任何组织。 @@ -56,5 +56,5 @@ versions: ### 延伸阅读 - "[设置团队](/articles/setting-up-teams)" -{% if currentVersion == "free-pro-team@latest" %}- "[邀请用户加入您的组织](/articles/inviting-users-to-join-your-organization)"{% endif %} +{% if currentVersion == "free-pro-team@latest" %}- "[Inviting users to join your organization](/articles/inviting-users-to-join-your-organization)"{% endif %} - “[访问组织](/articles/accessing-an-organization)” diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/deleting-your-user-account.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/deleting-your-user-account.md index 74bbe988adb3..bbe94cd1612b 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/deleting-your-user-account.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/deleting-your-user-account.md @@ -9,9 +9,9 @@ versions: enterprise-server: '*' --- -删除用户帐户会移除帐户所拥有的所有仓库、私有仓库分支、wiki、议题、拉取请求和页面。 {% if currentVersion == "free-pro-team@latest" %} 在其他用户拥有的仓库中创建的议题和拉取请求以及所做的评论将不会被删除，而是与我们的[Ghost 用户](https://github.com/ghost)关联。{% else %}在其他用户拥有的仓库中创建的议题和拉取请求以及所做的评论将不会被删除。{% endif %} +删除用户帐户会移除帐户所拥有的所有仓库、私有仓库分支、wiki、议题、拉取请求和页面。 {% if currentVersion == "free-pro-team@latest" %} Issues and pull requests you've created and comments you've made in repositories owned by other users will not be deleted - instead, they'll be associated with our [Ghost user](https://github.com/ghost).{% else %}Issues and pull requests you've created and comments you've made in repositories owned by other users will not be deleted.{% endif %} -{% if currentVersion == "free-pro-team@latest" %} 其他人也可以在新帐户中使用该帐户名称，我们会停止向您收费。 与该帐户关联的电子邮件地址可用于不同的 {% data variables.product.product_name %} 帐户。 {% endif %} +{% if currentVersion == "free-pro-team@latest" %} The account name also becomes available to anyone else to use on a new account, and we stop billing you. 与该账户关联的电子邮件地址可用于不同的 {% data variables.product.product_name %} 帐户。 {% endif %} 如果您是组织的唯一所有者，则必须先将所有权转让给其他人或删除该组织，然后才能删除您的用户帐户。 如果组织中有其他所有者，则必须先从组织中删除自己，然后才能删除用户帐户。 @@ -38,7 +38,7 @@ versions: - 如果您是组织中的唯一所有者，则必须将所有权转让给其他人或删除您的组织。 - 如果组织中有其他组织所有者，则必须将自己从组织中删除。 ![帐户删除按钮](/assets/images/help/settings/settings-account-delete.png) 4. 在“Make sure you want to do this（确保要执行此操作）”对话框中，完成以下步骤，以确认您了解删除帐户时会发生什么： ![删除帐户确认对话框](/assets/images/help/settings/settings-account-deleteconfirm.png) - {% if currentVersion == "free-pro-team@latest" %}- 重新考虑一下，您帐户拥有的所有仓库、私有仓库分支、wiki、议题、提取请求和网页都将被删除，您的计费将会终止，并且任何人将可在 {% data variables.product.product_name %} 上使用您的用户名。 + {% if currentVersion == "free-pro-team@latest" %}- Recall that all repositories, forks of private repositories, wikis, issues, pull requests and pages owned by your account will be deleted, your billing will end, and your username will be available to anyone for use on {% data variables.product.product_name %}. {% else %}- 重新考虑一下，您帐户拥有的所有仓库、私有仓库分支、wiki、议题、提取请求和网页都将被删除，并且任何人将可在 {% data variables.product.product_name %} 上使用您的用户名。 {% endif %}- 在第一个字段中，输入您的 {% data variables.product.product_name %} 用户名或电子邮件。 - 在第二个字段中，键入提示短语。 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/integrating-jira-with-your-personal-projects.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/integrating-jira-with-your-personal-projects.md index 1ca041a316d8..a7323f28ad9f 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/integrating-jira-with-your-personal-projects.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/integrating-jira-with-your-personal-projects.md @@ -1,6 +1,6 @@ --- title: 将 Jira 与个人项目集成 -intro: 您可以将 Jira Cloud 与您的用户帐户集成，以扫描提交和拉取请求，在任何提及的 Jira 议题中创建相关的元数据和超链接。 +intro: '您可以将 Jira Cloud 与您的用户帐户集成，以扫描提交和拉取请求，在任何提及的 Jira 议题中创建相关的元数据和超链接。' redirect_from: - /articles/integrating-jira-with-your-personal-projects versions: diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository.md index 03d8cebec19e..0b607f7a86d6 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository.md @@ -1,6 +1,6 @@ --- title: 邀请协作者参加个人仓库 -intro: '您可以{% if currentVersion == "free-pro-team@latest" %}邀请用户成为{% else %}添加用户成为{% endif %}个人仓库的协作者。' +intro: 'You can {% if currentVersion == "free-pro-team@latest" %}invite users to become{% else %}add users as{% endif %} collaborators to your personal repository.' redirect_from: - /articles/how-do-i-add-a-collaborator/ - /articles/adding-collaborators-to-a-personal-repository/ @@ -29,7 +29,7 @@ versions: 1. 询问您要邀请成为合作者的人员的用户名。 -{% if currentVersion == "free-pro-team@latest" %} 如果他们还没有用户名，他们可以注册 {% data variables.product.prodname_dotcom %} 更多信息请参阅“[注册新 {% data variables.product.prodname_dotcom %} 帐户](/articles/signing-up-for-a-new-github-account)”。{% endif %} +{% if currentVersion == "free-pro-team@latest" %} If they don't have a username yet, they can sign up for {% data variables.product.prodname_dotcom %} For more information, see "[Signing up for a new {% data variables.product.prodname_dotcom %} account](/articles/signing-up-for-a-new-github-account)".{% endif %} {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} {% if currentVersion == "free-pro-team@latest" %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md index b68e4a4af853..f83f9d21c212 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/managing-access-to-your-user-accounts-project-boards.md @@ -1,6 +1,6 @@ --- title: 管理对用户帐户项目板的访问 -intro: 作为项目板所有者，您可以添加或删除协作者，以及自定义他们对项目板的权限。 +intro: '作为项目板所有者，您可以添加或删除协作者，以及自定义他们对项目板的权限。' redirect_from: - /articles/managing-project-boards-in-your-repository-or-organization/ - /articles/managing-access-to-your-user-account-s-project-boards @@ -18,7 +18,9 @@ versions: {% data reusables.project-management.click-menu %} {% data reusables.project-management.access-collaboration-settings %} {% data reusables.project-management.collaborator-option %} -5. 在 "Search by username, full name or email address"（按用户名、全名或电子邮件地址搜索）下，输入协作者的姓名、用户名或 {% data variables.product.prodname_dotcom %} 电子邮件地址。 ![在搜索字段中输入了 Octocat 用户名的协作者部分](/assets/images/help/projects/org-project-collaborators-find-name.png) +5. Under "Search by username, full name or email address", type the collaborator's name, username, or +{% data variables.product.prodname_dotcom %} email. + ![在搜索字段中输入了 Octocat 用户名的协作者部分](/assets/images/help/projects/org-project-collaborators-find-name.png) {% data reusables.project-management.add-collaborator %} 7. 新协作者默认具有读取权限。 在新协作者名称旁边，可以选择使用下拉菜单选择不同的权限级别。 ![选择了权限下拉菜单的协作者部分](/assets/images/help/projects/user-project-collaborators-edit-permissions.png) diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/managing-security-and-analysis-settings-for-your-user-account.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/managing-security-and-analysis-settings-for-your-user-account.md index a72cadd22397..1e5f0df17a4c 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/managing-security-and-analysis-settings-for-your-user-account.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/managing-security-and-analysis-settings-for-your-user-account.md @@ -1,21 +1,21 @@ --- -title: Managing security and analysis settings for your user account -intro: 'You can control features that secure and analyze the code in your projects on {% data variables.product.prodname_dotcom %}.' +title: 管理用户帐户的安全和分析设置 +intro: '您可以控制功能以保护 {% data variables.product.prodname_dotcom %} 上项目的安全并分析其中的代码。' versions: free-pro-team: '*' --- ### 关于安全性和分析设置的管理 -{% data variables.product.prodname_dotcom %} can help secure your repositories. This topic tells you how you can manage the security and analysis features for all your existing or new repositories. +{% data variables.product.prodname_dotcom %} 可保护您的仓库。 本主题介绍如何管理所有现有或新仓库的安全和分析功能。 -You can still manage the security and analysis features for individual repositories. For more information, see "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)." +您仍然可以管理单个仓库的安全和分析功能。 更多信息请参阅“[管理仓库的安全和分析设置](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)”。 {% data reusables.security.some-security-and-analysis-features-are-enabled-by-default %} {% data reusables.security.security-and-analysis-features-enable-read-only %} -For an overview of repository-level security, see "[About securing your repository](/github/administering-a-repository/about-securing-your-repository)." +关于仓库级别安全的概述，请参阅“[关于保护仓库](/github/administering-a-repository/about-securing-your-repository)”。 ### 启用或禁用现有仓库的功能 @@ -23,7 +23,7 @@ For an overview of repository-level security, see "[About securing your reposito {% data reusables.user_settings.security-analysis %} 3. 在“Configure security and analysis features（配置安全性和分析功能）”下，单击功能右侧的 **Disable all（全部禁用）**或 **Enable all（全部启用）**。 !["Configure security and analysis（配置安全性和分析）"功能的"Enable all（全部启用）"或"Disable all（全部禁用）"按钮](/assets/images/help/settings/security-and-analysis-disable-or-enable-all.png) 6. （可选）为组织中的新仓库默认启用该功能。 ![新仓库的"Enable by default（默认启用）"选项](/assets/images/help/settings/security-and-analysis-enable-by-default-in-modal.png) -7. Click **Disable FEATURE** or **Enable FEATURE** to disable or enable the feature for all the repositories you own. ![用于禁用或启用功能的按钮](/assets/images/help/settings/security-and-analysis-enable-dependency-graph.png) +7. 单击 **Disable FEATURE（禁用功能）**或 **Enable FEATURE（启用功能）**以禁用或启用您拥有的所有仓库的功能。 ![用于禁用或启用功能的按钮](/assets/images/help/settings/security-and-analysis-enable-dependency-graph.png) ### 对新仓库启用或禁用功能 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md index ed61cad8256f..030edb1b55b8 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories.md @@ -1,6 +1,6 @@ --- -title: Managing the default branch name for your repositories -intro: You can set a default branch name for all new repositories that you create. +title: 管理仓库的默认分支名称 +intro: 'You can set a default branch name for all new repositories that you create.' versions: free-pro-team: '*' enterprise-server: '>=2.23' @@ -8,20 +8,18 @@ versions: ### About the default branch name -{% data reusables.branches.new-repo-default-branch %} This branch is currently named `master`, but you can set the default branch name to anything that makes sense for your development environment. +When you create a new repository on {% data variables.product.product_location %}, the repository contains one branch, which is the default branch. You can change the name that {% data variables.product.product_name %} uses for the default branch in new repositories you create. For more information about the default branch, see "[About branches](/github/collaborating-with-issues-and-pull-requests/about-branches#about-the-default-branch)." {% data reusables.branches.set-default-branch %} -{% data reusables.branches.rename-existing-branch %} - -### Setting the default branch name +### 设置默认分支名称 {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.repo-tab %} -3. Under "Repository default branch", click **Change default branch name now**. ![Override button](/assets/images/help/settings/repo-default-name-button.png) -4. Type the default name that you would like to use for new branches. ![Text box for entering default name](/assets/images/help/settings/repo-default-name-text.png) -5. Click **Update**. ![Update button](/assets/images/help/settings/repo-default-name-update.png) +3. 在“Repository default branch（仓库默认分支）”下，单击 **Change default branch name now（立即更改默认分支名称）**。 ![覆盖按钮](/assets/images/help/settings/repo-default-name-button.png) +4. 键入要用于新分支的默认名称。 ![输入默认名称的文本框](/assets/images/help/settings/repo-default-name-text.png) +5. 单击 **Update（更新）**。 ![更新按钮](/assets/images/help/settings/repo-default-name-update.png) ### 延伸阅读 -- [Managing the default branch name for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization) +- /github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/managing-user-account-settings.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/managing-user-account-settings.md index 408c419f5e86..e23965c55b71 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/managing-user-account-settings.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/managing-user-account-settings.md @@ -1,6 +1,6 @@ --- title: 管理用户帐户设置 -intro: 您可以更改个人帐户的多项设置，包括更改用户名和删除帐户。 +intro: '您可以更改个人帐户的多项设置，包括更改用户名和删除帐户。' redirect_from: - /categories/29/articles/ - /categories/user-accounts/ diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations.md index 249d74352f64..b988a5daaaa7 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations.md @@ -1,6 +1,6 @@ --- title: 管理组织中的成员资格 -intro: 如果您是组织的成员，便可公开或隐藏您的成员资格，查看其他人的角色，以及将您自己从组织中删除。 +intro: '如果您是组织的成员，便可公开或隐藏您的成员资格，查看其他人的角色，以及将您自己从组织中删除。' mapTopic: true redirect_from: - /articles/managing-your-membership-in-organizations diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/merging-multiple-user-accounts.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/merging-multiple-user-accounts.md index 71f7d5907676..35abb211d24f 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/merging-multiple-user-accounts.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/merging-multiple-user-accounts.md @@ -1,6 +1,6 @@ --- title: 合并多个用户帐户 -intro: 如果工作和个人分别使用不同的帐户，您可以合并这些帐户。 +intro: '如果工作和个人分别使用不同的帐户，您可以合并这些帐户。' redirect_from: - /articles/can-i-merge-two-accounts/ - /articles/keeping-work-and-personal-repositories-separate/ diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md index 0cacd3b04ee2..c6ebc8a604b9 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository.md @@ -1,6 +1,6 @@ --- -title: 用户帐户仓库的权限级别 -intro: 用户帐户拥有的仓库有两种权限级别：*仓库所有者*和*协作者*。 +title: Permission levels for a user account repository +intro: 'A repository owned by a user account has two permission levels: the *repository owner* and *collaborators*.' redirect_from: - /articles/permission-levels-for-a-user-account-repository versions: @@ -10,65 +10,64 @@ versions: {% tip %} -**提示：**如果需要对用户帐户拥有的仓库实施更细致的读/写权限，请考虑将仓库转让给组织。 更多信息请参阅“[转让仓库](/articles/transferring-a-repository)”。 +**Tip:** If you require more granular read/write access to a repository owned by your user account, consider transferring the repository to an organization. For more information, see "[Transferring a repository](/articles/transferring-a-repository)." {% endtip %} -#### 所有者对用户帐户拥有的仓库的访问权限 +#### Owner access on a repository owned by a user account -仓库所有者对仓库具有完全控制权。 除了仓库协作者的所有权限之外，仓库所有者还可以： +The repository owner has full control of the repository. In addition to all the permissions allowed by repository collaborators, the repository owner can: -- {% if currentVersion == "free-pro-team@latest" %}[邀请协作者](/articles/inviting-collaborators-to-a-personal-repository){% else %}[添加协作者](/articles/inviting-collaborators-to-a-personal-repository){% endif %} -- 更改仓库的可见性（从[公共改为私有](/articles/making-a-public-repository-private)，或从[私有改为公共](/articles/making-a-private-repository-public)）{% if currentVersion == "free-pro-team@latest" %} -- [限制与仓库的交互](/articles/limiting-interactions-with-your-repository){% endif %} -- 合并受保护分支上的拉取请求（即使没有批准审查） -- [删除仓库](/articles/deleting-a-repository) -- [管理仓库的主题](/articles/classifying-your-repository-with-topics){% if currentVersion == "free-pro-team@latest" %} +- {% if currentVersion == "free-pro-team@latest" %}[Invite collaborators](/articles/inviting-collaborators-to-a-personal-repository){% else %}[Add collaborators](/articles/inviting-collaborators-to-a-personal-repository){% endif %} +- Change the visibility of the repository (from [public to private](/articles/making-a-public-repository-private), or from [private to public](/articles/making-a-private-repository-public)){% if currentVersion == "free-pro-team@latest" %} +- [Limit interactions with a repository](/articles/limiting-interactions-with-your-repository){% endif %} +- Merge a pull request on a protected branch, even if there are no approving reviews +- [Delete the repository](/articles/deleting-a-repository) +- [Manage a repository's topics](/articles/classifying-your-repository-with-topics){% if currentVersion == "free-pro-team@latest" %} - Manage security and analysis settings. For more information, see "[Managing security and analysis settings for your user account](/github/setting-up-and-managing-your-github-user-account/managing-security-and-analysis-settings-for-your-user-account)."{% endif %}{% if currentVersion == "free-pro-team@latest" %} -- 为私有仓库[启用依赖关系图](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository){% endif %}{% if currentVersion == "free-pro-team@latest" %} -- 删除包。 更多信息请参阅“[删除包](/github/managing-packages-with-github-packages/deleting-a-package)”。{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -- 创建和编辑仓库社交卡。 更多信息请参阅“[自定义仓库的社交媒体审查](/articles/customizing-your-repositorys-social-media-preview)”。 -- 将仓库设为模板。 更多信息请参阅“[创建模板仓库](/articles/creating-a-template-repository)”。{% endif %} -- 接收[仓库中有漏洞的依赖项的{% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}安全警报{% endif %}](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies){% if currentVersion == "free-pro-team@latest" %} -- 忽略仓库中的 {% data variables.product.prodname_dependabot_alerts %}。 更多信息请参阅“[查看和更新仓库中的漏洞依赖项](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)”。 -- [管理私有仓库的数据使用](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository){% endif %} -- [定义仓库的代码所有者](/articles/about-code-owners) -- [存档仓库](/articles/about-archiving-repositories){% if currentVersion == "free-pro-team@latest" %} -- 创建安全通告。 更多信息请参阅“[关于 {% data variables.product.prodname_security_advisories %}](/github/managing-security-vulnerabilities/about-github-security-advisories)”。 -- 显示赞助按钮。 更多信息请参阅“[在仓库中显示赞助按钮](/articles/displaying-a-sponsor-button-in-your-repository)”。{% endif %} +- [Enable the dependency graph](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository) for a private repository{% endif %}{% if currentVersion == "free-pro-team@latest" %} +- Delete packages. For more information, see "[Deleting a package](/github/managing-packages-with-github-packages/deleting-a-package)."{% endif %} +- Create and edit repository social cards. For more information, see "[Customizing your repository's social media preview](/articles/customizing-your-repositorys-social-media-preview)." +- Make the repository a template. For more information, see "[Creating a template repository](/articles/creating-a-template-repository)." +- Receive [{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in a repository.{% if currentVersion == "free-pro-team@latest" %} +- Dismiss {% data variables.product.prodname_dependabot_alerts %} in your repository. For more information, see "[Viewing and updating vulnerable dependencies in your repository](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)." +- [Manage data usage for your private repository](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository){% endif %} +- [Define code owners for the repository](/articles/about-code-owners) +- [Archive repositories](/articles/about-archiving-repositories){% if currentVersion == "free-pro-team@latest" %} +- Create security advisories. For more information, see "[About {% data variables.product.prodname_security_advisories %}](/github/managing-security-vulnerabilities/about-github-security-advisories)." +- Display a sponsor button. For more information, see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)."{% endif %} -用户帐户拥有的仓库只有**一个所有者**，此权限无法与其他用户帐户共享。 要将仓库的所有权转让给其他用户，请参阅“[如何转让仓库](/articles/how-to-transfer-a-repository)”。 +There is only **one owner** of a repository owned by a user account; this permission cannot be shared with another user account. To transfer ownership of a repository to another user, see "[How to transfer a repository](/articles/how-to-transfer-a-repository)." -#### 协作者对用户帐户拥有的仓库的访问权限 +#### Collaborator access on a repository owned by a user account {% note %} -**注：**在私有仓库中，仓库所有者只能为协作者授予写入权限。 协作者不能对用户帐户拥有的仓库具有只读权限。 +**Note:** In a private repository, repository owners can only grant write access to collaborators. Collaborators can't have read-only access to repositories owned by a user account. {% endnote %} -个人仓库的协作者可以： +Collaborators on a personal repository can: -- 推送（写入）、拉取（读取）和复刻（复制）仓库 -- 创建、应用和删除标签及里程碑 -- 打开、关闭、重新打开和分配议题 -- 编辑和删除对提交、拉取请求和议题的评论 -- 将议题或拉取请求标记为重复。 更多信息请参阅“[关于重复的议题和拉取请求](/articles/about-duplicate-issues-and-pull-requests)”。 +- Push to (write), pull from (read), and fork (copy) the repository +- Create, apply, and delete labels and milestones +- Open, close, re-open, and assign issues +- Edit and delete comments on commits, pull requests, and issues +- Mark an issue or pull request as a duplicate. For more information, see "[About duplicate issues and pull requests](/articles/about-duplicate-issues-and-pull-requests)." - Open, merge and close pull requests -- 对拉取请求应用提议的更改。 更多信息请参阅“[合并拉取请求中的反馈](/articles/incorporating-feedback-in-your-pull-request)”。 -- 从仓库的复刻发送拉取请求{% if currentVersion == "free-pro-team@latest" %} -- 发布、查看和安装包。 更多信息请参阅“[发布和管理包](/github/managing-packages-with-github-packages/publishing-and-managing-packages)”。{% endif %} -- 创建和编辑 Wiki -- 创建和编辑发行版. 更多信息请参阅“[管理仓库中的发行版](/github/administering-a-repository/managing-releases-in-a-repository)”。 -- 作为仓库协作者删除自己 -- 提交会影响其合并性的拉取请求审查 -- 作为仓库的指定代码所有者。 更多信息请参阅“[关于代码所有者](/articles/about-code-owners)”。 -- 锁定对话。 更多信息请参阅“[锁定对话](/articles/locking-conversations)”。{% if currentVersion == "free-pro-team@latest" %} -- 向 {% data variables.contact.contact_support %} 报告滥用的内容。 更多信息请参阅“[报告滥用或垃圾邮件](/articles/reporting-abuse-or-spam)”。{% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} -- 将议题转让给不同的仓库 更多信息请参阅“[将议题转让给其他仓库](/articles/transferring-an-issue-to-another-repository)”。{% endif %} +- Apply suggested changes to pull requests. For more information, see "[Incorporating feedback in your pull request](/articles/incorporating-feedback-in-your-pull-request)." +- Send pull requests from forks of the repository{% if currentVersion == "free-pro-team@latest" %} +- Publish, view, and install packages. For more information, see "[Publishing and managing packages](/github/managing-packages-with-github-packages/publishing-and-managing-packages)."{% endif %} +- Create and edit Wikis +- Create and edit releases. For more information, see "[Managing releases in a repository](/github/administering-a-repository/managing-releases-in-a-repository). +- Remove themselves as collaborators on the repository +- Submit a review on a pull request that will affect its mergeability +- Act as a designated code owner for the repository. For more information, see "[About code owners](/articles/about-code-owners)." +- Lock a conversation. For more information, see "[Locking conversations](/articles/locking-conversations)."{% if currentVersion == "free-pro-team@latest" %} +- Report abusive content to {% data variables.contact.contact_support %}. For more information, see "[Reporting abuse or spam](/articles/reporting-abuse-or-spam)."{% endif %} +- Transfer an issue to a different repository. For more information, see "[Transferring an issue to another repository](/articles/transferring-an-issue-to-another-repository)." -### 延伸阅读 +### Further reading -- "[邀请个人仓库的协作者](/articles/inviting-collaborators-to-a-personal-repository)" -- "[组织的仓库权限级别](/articles/repository-permission-levels-for-an-organization)" +- "[Inviting collaborators to a personal repository](/articles/inviting-collaborators-to-a-personal-repository)" +- "[Repository permission levels for an organization](/articles/repository-permission-levels-for-an-organization)" diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-user-owned-project-boards.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-user-owned-project-boards.md index ad62fa83ff92..66c5968d2755 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-user-owned-project-boards.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/permission-levels-for-user-owned-project-boards.md @@ -1,6 +1,6 @@ --- title: 用户拥有的项目板的权限级别 -intro: 用户帐户拥有的项目板有两种权限级别：项目板所有者和协作者。 +intro: '用户帐户拥有的项目板有两种权限级别：项目板所有者和协作者。' redirect_from: - /articles/permission-levels-for-user-owned-project-boards versions: diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/publicizing-or-hiding-organization-membership.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/publicizing-or-hiding-organization-membership.md index 6510810396e4..3a17ae0aed64 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/publicizing-or-hiding-organization-membership.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/publicizing-or-hiding-organization-membership.md @@ -1,6 +1,6 @@ --- title: 公开或隐藏组织成员关系 -intro: 如果要公开显示您属于哪个组织，可以在个人资料中显示组织的头像。 +intro: '如果要公开显示您属于哪个组织，可以在个人资料中显示组织的头像。' redirect_from: - /articles/publicizing-or-concealing-organization-membership/ - /articles/publicizing-or-hiding-organization-membership diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/remembering-your-github-username-or-email.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/remembering-your-github-username-or-email.md index b7021bf26ad3..6712c55df8ff 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/remembering-your-github-username-or-email.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/remembering-your-github-username-or-email.md @@ -25,7 +25,7 @@ versions: ### {% data variables.product.prodname_desktop %} 用户 -1. In the **File** menu, click **Options**. +1. 在 **File（文件）**菜单中，单击 **Options（选项）**。 2. 在 Options（选项）窗口中，验证以下内容： - 要查看 {% data variables.product.product_name %} 用户名，请单击 **Accounts（帐户）**。 - 要查看您的 Git 电子邮件，请单击 **Git**。 请注意，此电子邮件不一定是[您的主 {% data variables.product.product_name %} 电子邮件](/articles/changing-your-primary-email-address)。 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/removing-a-collaborator-from-a-personal-repository.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/removing-a-collaborator-from-a-personal-repository.md index 70af475e8e5b..a360fec50ec5 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/removing-a-collaborator-from-a-personal-repository.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/removing-a-collaborator-from-a-personal-repository.md @@ -1,6 +1,6 @@ --- title: 从个人仓库中删除协作者 -intro: 当您从项目中删除协作者时，他们将失去对您仓库的读取/写入权限。 如果仓库为私有并且该人员已创建复刻，则该复刻也将删除。 +intro: '当您从项目中删除协作者时，他们将失去对您仓库的读取/写入权限。 如果仓库为私有并且该人员已创建复刻，则该复刻也将删除。' redirect_from: - /articles/how-do-i-remove-a-collaborator/ - /articles/what-happens-when-i-remove-a-collaborator-from-my-private-repository/ @@ -24,7 +24,7 @@ versions: {% data reusables.repositories.sidebar-settings %} {% if currentVersion == "free-pro-team@latest" %} {% data reusables.repositories.navigate-to-manage-access %} -4. To the right of the collaborator you want to remove, click +4. 在要删除的协作者右边，单击 {% octicon "trashcan" aria-label="The trashcan icon" %}. ![用于删除协作者的按钮](/assets/images/help/repository/collaborator-remove.png) {% else %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-a-collaborators-repository.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-a-collaborators-repository.md index 93b34fca5944..32c6c7bb44db 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-a-collaborators-repository.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-a-collaborators-repository.md @@ -1,6 +1,6 @@ --- title: 从协作者的仓库中删除您自己 -intro: 如果您不再想要成为其他人仓库中的协作者，您可以删除自己。 +intro: '如果您不再想要成为其他人仓库中的协作者，您可以删除自己。' redirect_from: - /leave-a-collaborative-repo/ - /leave-a-repo/ diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-an-organization.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-an-organization.md index 99190f76fba6..2f82c85553c4 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-an-organization.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-an-organization.md @@ -1,6 +1,6 @@ --- title: 从组织中删除自己 -intro: 如果您是外部协作者或组织成员，您可以随时离开组织。 +intro: '如果您是外部协作者或组织成员，您可以随时离开组织。' redirect_from: - /articles/how-do-i-remove-myself-from-an-organization/ - /articles/removing-yourself-from-an-organization diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address.md index 11cfa9f22764..ff9e2218ad56 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address.md @@ -21,7 +21,7 @@ versions: 对于基于 web 的 Git 操作，您可以在 {% data variables.product.product_name %} 上设置提交电子邮件地址。 对于从命令行推送的提交，您可以在 Git 中设置提交电子邮件地址。 -{% if currentVersion == "free-pro-team@latest" %}在更改提交电子邮件地址之前进行的提交仍与之前的电子邮件地址关联。{% else %}在 {% data variables.product.product_name %} 上更改提交电子邮件地址之后，新电子邮件地址默认在所有未来基于 web 的 Git 操作中可见。 在更改提交电子邮件地址之前进行的任何提交仍与之前的电子邮件地址关联。{% endif %} +{% if currentVersion == "free-pro-team@latest" %}Any commits you made prior to changing your commit email address are still associated with your previous email address.{% else %}After changing your commit email address on {% data variables.product.product_name %}, the new email address will be visible in all of your future web-based Git operations by default. 在更改提交电子邮件地址之前进行的任何提交仍与之前的电子邮件地址关联。{% endif %} {% if currentVersion == "free-pro-team@latest" %} @@ -33,11 +33,11 @@ versions: {% endif %} -{% if currentVersion == "free-pro-team@latest" %}如果要对个人电子邮件地址保密，可以使用 {% data variables.product.product_name %}-provided `no-reply` 电子邮件地址作为提交电子邮件地址。 要将 `noreply` 电子邮件地址用于从命令行推送的提交，请在 Git 中设置提交电子邮件地址时使用该电子邮件地址。 要将 `noreply` 地址用于基于 web 的 Git 操作，请在 GitHub 上设置提交电子邮件地址并选择**对我的电子邮件地址保密**。 +{% if currentVersion == "free-pro-team@latest" %}If you'd like to keep your personal email address private, you can use a {% data variables.product.product_name %}-provided `no-reply` email address as your commit email address. 要将 `noreply` 电子邮件地址用于从命令行推送的提交，请在 Git 中设置提交电子邮件地址时使用该电子邮件地址。 要将 `noreply` 地址用于基于 web 的 Git 操作，请在 GitHub 上设置提交电子邮件地址并选择**对我的电子邮件地址保密**。 您也可以选择阻止从命令行推送的提交显示您的个人电子邮件地址。 更多信息请参阅“[阻止推送的命令行显示您的个人电子邮件地址](/articles/blocking-command-line-pushes-that-expose-your-personal-email-address)”。{% endif %} -为确保提交归因于您并且出现在您的贡献图表中，请使用您已[添加到 GitHub 帐户](/articles/adding-an-email-address-to-your-github-account/)的电子邮件地址{% if currentVersion == "free-pro-team@latest" %}，或者在电子邮件设置中提供给您的 {% data variables.product.product_name %}-provided `noreply` 电子邮件地址{% endif %}。 +To ensure that commits are attributed to you and appear in your contributions graph, use an email address that you've [added to your GitHub account](/articles/adding-an-email-address-to-your-github-account/){% if currentVersion == "free-pro-team@latest" %}, or the {% data variables.product.product_name %}-provided `noreply` email address provided to you in your email settings{% endif %}. {% if currentVersion == "free-pro-team@latest" %} diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/what-does-the-available-for-hire-checkbox-do.md b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/what-does-the-available-for-hire-checkbox-do.md index ac8a8463a64d..f1320ebd97c9 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/what-does-the-available-for-hire-checkbox-do.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-github-user-account/what-does-the-available-for-hire-checkbox-do.md @@ -1,5 +1,5 @@ --- -title: “招聘职位”复选框有什么作用？ +title: '“招聘职位”复选框有什么作用？' intro: 使用 **Available for hire（招聘职位）**复选框可查看 GitHub 内的 GitHub Jobs 岗位。 redirect_from: - /articles/what-does-the-available-for-hire-checkbox-do diff --git a/translations/zh-CN/content/github/site-policy/amendment-to-github-terms-of-service-applicable-to-us-federal-government-users.md b/translations/zh-CN/content/github/site-policy/amendment-to-github-terms-of-service-applicable-to-us-federal-government-users.md index 1a597d23c9d0..da2ea7229891 100644 --- a/translations/zh-CN/content/github/site-policy/amendment-to-github-terms-of-service-applicable-to-us-federal-government-users.md +++ b/translations/zh-CN/content/github/site-policy/amendment-to-github-terms-of-service-applicable-to-us-federal-government-users.md @@ -1,5 +1,5 @@ --- -title: 适用于美国联邦政府用户的 GitHub 服务条款修正案 Federal Government Users +title: 适用于美国联邦政府用户的 GitHub 服务条款修正案 联邦政府用户 redirect_from: - /articles/amendment-to-github-terms-of-service-applicable-to-government-users/ - /articles/proposed-amendment-to-github-terms-of-service-applicable-to-u-s-federal-government-users/ @@ -11,11 +11,11 @@ versions: {% tip %} -本 GitHub [服务条款](/articles/github-terms-of-service)修正案仅适用于代表美国联邦政府使用 GitHub 的用户。 If you are not using GitHub on behalf of the U.S. 如果您不是代表美国联邦政府使用 GitHub，则标准 [GitHub 服务条款](/articles/github-terms-of-service)适用于您。 +本 GitHub [服务条款](/articles/github-terms-of-service)修正案仅适用于代表美国联邦政府使用 GitHub 的用户。 如果您不代表美国联邦政府使用 GitHub 如果您不是代表美国联邦政府使用 GitHub，则标准 [GitHub 服务条款](/articles/github-terms-of-service)适用于您。 {% endtip %} -本修正案是 GitHub, Inc. （"GitHub" 或“公司”）与 GitHub.com 网站（“服务”）的美国联邦政府用户之间的协议，仅适用于任何美国联邦政府机构以及代表美国联邦政府使用或访问服务的用户（“政府”）。 federal government users of the GitHub.com web site (the “Service”) and applies solely to any U.S. federal government agency and its users who use or access the Service on behalf of the U.S. federal government (the "Government"). +本修正案是 GitHub, Inc. （"GitHub" 或“公司”）与 GitHub.com 网站（“服务”）的美国联邦政府用户之间的协议，仅适用于任何美国联邦政府机构以及代表美国联邦政府使用或访问服务的用户（“政府”）。 与 GitHub.com 网站（“服务”）的美国联邦政府用户之间的协议，仅适用于任何美国 联邦政府机构以及代表美国 联邦政府使用或访问服务的用户（“政府”）。 您作为美国政府实体，在与其他方签订协议时，必须遵守适用的联邦法律和法规，包括以下方面的规范：道德；隐私和安全；可及性；记录保留；赔偿限制；财政法律约束；广告和背书；信息自由； 以及管辖法律和争端解决法庭。 @@ -33,7 +33,7 @@ GitHub 和您（合称为“双方”）同意对 [GitHub 服务协议](/article 2. *禁止背书* - 公司同意，对于您的印章、商标、徽标、服务标志、商品名称以及您在公司网站上存在并使用其服务的事实，公司不得将其用于声明或暗示：公司的产品或服务受到您或任何其他联邦政府部门的认可、赞助或推荐，或者被这些实体视为优于任何其他产品或服务。 公司同意，除了其设计和内容受政府控制的页面或此类页面的链接或推广外，不得在公司首页或公司网站的其他位置展示任何政府印章或徽标，除非得到政府或其他相关联邦政府机构的允许。 公司可以在公开的客户列表中列出政府的名称，但不得以比任何其他第三方名称更突出的方式显示它。 -3. *数据提供* - 如果终止服务，在终止后的 30 天内，公司将应您的要求，提供您在公司网站上创建的所有公开可见的用户生成内容。 数据将以公司认为适当的常用文件或数据库格式提供。 Company will not provide data if doing so would violate its privacy policy, available at [https://docs.github.com/privacy](/privacy). +3. *数据提供* - 如果终止服务，在终止后的 30 天内，公司将应您的要求，提供您在公司网站上创建的所有公开可见的用户生成内容。 数据将以公司认为适当的常用文件或数据库格式提供。 如果提供数据会违反隐私政策（详见 [https://docs.github.com/privacy](/privacy)），公司将拒绝提供。 ### C. 免费和付费计划 @@ -45,7 +45,7 @@ GitHub 和您（合称为“双方”）同意对 [GitHub 服务协议](/article ### D. 联邦法规 -1. *安全性* - 公司将本着诚意采用 IT 安全领域公认的商业实践进行尽职调查，以确保采用安全的方式运行和维护系统，并采用管理、运营和技术控制措施来确保系统和数据的安全。 鉴于 Web 不断变化的性质，公司将持续与用户合作，以确保采用安全的方式运行和维护其产品和服务。 公司同意讨论实施政府认为必要的其他安全控制措施，以符合联邦信息安全管理法 (FISMA)，44 U.S.C. 3541 及其后各段。 3541 et seq. +1. *安全性* - 公司将本着诚意采用 IT 安全领域公认的商业实践进行尽职调查，以确保采用安全的方式运行和维护系统，并采用管理、运营和技术控制措施来确保系统和数据的安全。 鉴于 Web 不断变化的性质，公司将持续与用户合作，以确保采用安全的方式运行和维护其产品和服务。 公司同意讨论实施政府认为必要的其他安全控制措施，以符合联邦信息安全管理法 (FISMA)，44 U.S.C. 3541 及其后各段。 3541 及其后各段。 2. *联邦记录* - 政府承认，使用公司网站和服务可能需要管理联邦记录。 政府和用户生成的内容可能符合该机构确定的联邦记录定义。 如果公司保留联邦记录，政府和公司必须根据所有适用的记录管理法律和法规来管理联邦记录，包括但不限于《联邦记录法》(44 U.S.C. chs. 21, 29, 31, 33) 和国家档案和记录局 (NARA) 在 36 CFR 第 XII 章第 B 部分的规定。 chs. 21, 29, 31, 33) 和国家档案和记录局 (NARA) 在 36 CFR 第 XII 章第 B 部分的规定。 管理记录包括但不限于安全存储、可检索性和正确处置所有联邦记录，包括以 NARA 可接受的格式和方式将永久有价值的记录转移到 NARA。 政府有责任在协议有效期内和终止之时确保公司遵守适用的记录管理法律和法规。 @@ -55,7 +55,7 @@ GitHub 和您（合称为“双方”）同意对 [GitHub 服务协议](/article 2. *责任限制* - 双方同意，责任限制条款或 ToS 其他条款的任何规定，均不构成以任何方式允许公司放弃、解除或限制与过去、现在或将来违反联邦法律相关的责任。 -3. *管辖法律和法庭* - 特此删除 ToS 中的争议解决条款。 ToS 和本修正案应根据适用的美国联邦法律进行管辖、解释和执行，适当的美国联邦法院具有专属管辖权。 federal courts. 在联邦法律允许的范围内，加利福尼亚州法律将在联邦法律空白的情况下适用。 +3. *管辖法律和法庭* - 特此删除 ToS 中的争议解决条款。 ToS 和本修正案应根据适用的美国联邦法律进行管辖、解释和执行，适当的美国联邦法院具有专属管辖权。 联邦法院。 在联邦法律允许的范围内，加利福尼亚州法律将在联邦法律空白的情况下适用。 4. *转让* - 未经对方事先书面同意，任何一方均不得将其在本修正案或 ToS 下的义务转让给任何第三方；但是，在 GitHub 发生兼并、收购、公司重组或合并，或者出售其所有或基本上所有资产的情况下，GitHub 可不经政府同意，将其在本修正案或 ToS 下对使用免费服务的政府的义务，转让给关联公司、继承人或收购方（视情况而定）。 diff --git a/translations/zh-CN/content/github/site-policy/dmca-takedown-policy.md b/translations/zh-CN/content/github/site-policy/dmca-takedown-policy.md index 67a101fb5b45..2a2dade25c93 100644 --- a/translations/zh-CN/content/github/site-policy/dmca-takedown-policy.md +++ b/translations/zh-CN/content/github/site-policy/dmca-takedown-policy.md @@ -28,7 +28,7 @@ DMCA 通过为托管涉嫌侵权用户生成内容的互联网服务提供商建 DMCA 规定了两个简单直接的程序，所有 GitHub 用户都应了解：(i) 版权持有者要求删除内容的[删除通知](/articles/guide-to-submitting-a-dmca-takedown-notice)程序；(ii) 内容被误删时用户要求恢复内容的[反通知](/articles/guide-to-submitting-a-dmca-counter-notice)程序。 -DMCA [删除通知](/articles/guide-to-submitting-a-dmca-takedown-notice)供版权所有者用于要求 GitHub 删除他们认为侵权的内容。 如果您是软件设计师或开发者，可能每天都会创建版权内容。 If someone else is using your copyrighted content in an unauthorized manner on GitHub, you can send us a DMCA takedown notice to request that the infringing content be changed or removed. +DMCA [删除通知](/articles/guide-to-submitting-a-dmca-takedown-notice)供版权所有者用于要求 GitHub 删除他们认为侵权的内容。 如果您是软件设计师或开发者，可能每天都会创建版权内容。 如果其他人以未经授权的方式在 GitHub 上使用您的版权内容，您可以向我们发送 DMCA 删除通知，要求更改或删除侵权内容。 另一方面，[反通知](/articles/guide-to-submitting-a-dmca-counter-notice)可用于纠正错误。 发送删除通知的人可能没有版权，或者没有意识到您拥有许可，或者在删除通知中犯了其他错误。 由于 GitHub 往往不知道通知是否有误，因此您可以通过 DMCA 反通知告诉我们并要求我们恢复内容。 @@ -45,13 +45,13 @@ DMCA 框架有点像课堂上传纸条。 版权所有者向 GitHub 提交对某 2. **版权所有者发送通知。**进行调查后，版权所有者编写[删除通知](/articles/guide-to-submitting-a-dmca-takedown-notice)并将其发送到 GitHub。 如果根据法律要求，该删除通知足够详细（如[操作指南](/articles/guide-to-submitting-a-dmca-takedown-notice)中所述），我们会[将该通知发布](#d-transparency)到我们的[公共仓库](https://github.com/github/dmca)中，并将链接传送给受影响的用户。 -3. **GitHub Asks User to Make Changes.** If the notice alleges that the entire contents of a repository infringe, or a package infringes, we will skip to Step 6 and disable the entire repository or package expeditiously. 否则，由于 GitHub 无法禁止访问仓库中的特定文件，我们将联系创建该仓库的用户，给他们 1 个工作日左右的时间来删除或修改通知中指定的内容。 如果我们给用户进行更改的机会，我们会通知版权所有者。 Because packages are immutable, if only part of a package is infringing, GitHub would need to disable the entire package, but we permit reinstatement once the infringing portion is removed. +3. **GitHub 要求用户进行更改。**如果通知指出仓库或包的整个内容都侵权，我们将跳到步骤 6 并迅速禁用整个仓库或包。 否则，由于 GitHub 无法禁止访问仓库中的特定文件，我们将联系创建该仓库的用户，给他们 1 个工作日左右的时间来删除或修改通知中指定的内容。 如果我们给用户进行更改的机会，我们会通知版权所有者。 由于包是不可变的，如果只有包的一部分侵权，GitHub 将需要禁用整个包，但我们允许在删除侵权部分后恢复。 4. **用户向 GitHub 通知更改。**如果用户选择进行指定的更改，则*必须*在大约 1 个工作日内告知我们。 如果没有，我们将禁用仓库（如步骤 6 所述）。 如果用户通知我们已进行更改，我们将进行核实然后通知版权所有者。 5. **版权所有者修改或撤回通知。**用户进行更改后，版权所有者必须进行审查，如果认为更改不充分，他们可以重申或修改其删除通知。 除非版权所有者联系我们以重申原删除通知或提交修改的通知，否则 GitHub 不会采取任何进一步行动。 如果版权所有者对更改感到满意，他们可以提交正式的撤回声明，或者什么都不做。 静默期超过两周，GitHub 将解释为默示撤回删除通知。 -6. **GitHub May Disable Access to the Content.** GitHub will disable a user's content if: (i) the copyright owner has alleged copyright over the user's entire repository or package (as noted in Step 3); (ii) the user has not made any changes after being given an opportunity to do so (as noted in Step 4); or (iii) the copyright owner has renewed their takedown notice after the user had a chance to make changes. 如果版权所有者选择*修改*通知，我们将回到步骤 2，将修改的通知当作新通知来重复这个流程。 +6. **GitHub 可能禁止访问内容。**在以下情况下，GitHub 将禁用用户内容：(i) 版权所有者声称对用户整个仓库或包的内容都拥有版权（如步骤 3 所述）；(ii) 用户在获得更改机会后没有进行任何更改（如步骤 4 所述）；或 (iii) 版权所有者在用户有机会进行更改后重申了删除通知。 如果版权所有者选择*修改*通知，我们将回到步骤 2，将修改的通知当作新通知来重复这个流程。 7. **用户可发送反通知。**我们鼓励用户在其内容被禁用后就其选择权咨询律师。 如果用户认为其内容是由于错误或错误指认而被禁用，他们可以向我们发送[反通知](/articles/guide-to-submitting-a-dmca-counter-notice)。 与原通知一样，我们将确保反通知足够详细（如[操作指南](/articles/guide-to-submitting-a-dmca-counter-notice)中所述）。 如果是，我们会将其[发布](#d-transparency)到我们的[公共仓库](https://github.com/github/dmca)，然后向版权所有者发送链接以传达该通知。 @@ -96,4 +96,4 @@ GitHub 的政策是，在适当的情况下，自行决定禁用和终止可能 - [Opportunities for Copyright Reform](https://www.cato-unbound.org/issues/january-2013/opportunities-copyright-reform) (Cato Unbound) - [Fair Use Doctrine and the Digital Millennium Copyright Act: Does Fair Use Exist on the Internet Under the DMCA?](https://digitalcommons.law.scu.edu/lawreview/vol42/iss1/6/) (Santa Clara Law Review) -GitHub 不一定支持这些文章中的任何观点。 我们提供链接的目的是鼓励您了解更多信息，形成自己的观点，然后联系您选举的代表（例如[美国国会](https://www.govtrack.us/congress/members)或[欧盟议会](https://www.europarl.europa.eu/meps/en/home)的官员），以求实现您认为应该进行的任何更改。 Congress or [E.U. Parliament](https://www.europarl.europa.eu/meps/en/home)) to seek whatever changes you think should be made. +GitHub 不一定支持这些文章中的任何观点。 我们提供链接的目的是鼓励您了解更多信息，形成自己的观点，然后联系您选举的代表（例如[美国国会](https://www.govtrack.us/congress/members)或[欧盟议会](https://www.europarl.europa.eu/meps/en/home)的官员），以求实现您认为应该进行的任何更改。 国会或[欧盟 议会](https://www.europarl.europa.eu/meps/en/home)的官员），以求实现您认为应该进行的任何更改。 diff --git a/translations/zh-CN/content/github/site-policy/github-acceptable-use-policies.md b/translations/zh-CN/content/github/site-policy/github-acceptable-use-policies.md index 952f20c77dd2..d27bc7ff6591 100644 --- a/translations/zh-CN/content/github/site-policy/github-acceptable-use-policies.md +++ b/translations/zh-CN/content/github/site-policy/github-acceptable-use-policies.md @@ -49,7 +49,7 @@ versions: 未获明确的书面同意，不得重制、重复、复制、销售、转售或利用服务的任何部分、使用服务或访问服务。 ### 5. 擦除和 API 使用限制 -擦除是指通过自动化过程（如自动程序或网络爬虫 ）从我们的服务中提取数据。 它不是指通过我们的 API 收集信息。 Please see Section H of our [Terms of Service](/articles/github-terms-of-service#h-api-terms) for our API Terms. 您可能因以下原因而擦除网站： +擦除是指通过自动化过程（如自动程序或网络爬虫 ）从我们的服务中提取数据。 它不是指通过我们的 API 收集信息。 有关我们的 API 条款，请参阅我们[服务条款](/articles/github-terms-of-service#h-api-terms)的 H 部分。 您可能因以下原因而擦除网站： - 研究人员可能出于研究目的而从服务中擦除公共的非个人信息，但仅当来自该研究的出版物开放访问时才可擦除。 - 档案管理人员可能出于存档目的而擦除服务中的公共数据。 @@ -73,7 +73,7 @@ versions: 不得推广或分发非法或我们的[服务条款](/github/site-policy/github-terms-of-service/)、[社区准则](/github/site-policy/github-community-guidelines/)或[可接受的使用政策](/github/site-policy/github-acceptable-use-policies/)禁止的内容或活动，包括过多的自动化批量活动（例如群发垃圾邮件、暴富方案以及与您的促销相关的虚假描述或欺骗。 -如果您决定在帐户中发布任何宣传材料，您将自行负责遵守所有适用的法律和法规，包括但不限于美国联邦贸易委员会的背书和推荐准则。 Federal Trade Commission's Guidelines on Endorsements and Testimonials. 我们保留删除我们单方面认为违反了任何 GitHub 条款或政策的任何宣传材料或广告的权利。 +如果您决定在帐户中发布任何宣传材料，您将自行负责遵守所有适用的法律和法规，包括但不限于美国联邦贸易委员会的背书和推荐准则。 联邦贸易委员会的背书和推荐准则。 我们保留删除我们单方面认为违反了任何 GitHub 条款或政策的任何宣传材料或广告的权利。 ### 9. GitHub 上的垃圾信息和假活动 GitHub 禁止自动化大量群发的活动和协调假活动，如垃圾邮件。 禁止的活动包括： diff --git a/translations/zh-CN/content/github/site-policy/github-additional-product-terms.md b/translations/zh-CN/content/github/site-policy/github-additional-product-terms.md index 09d8d2c8b802..05c63773c9e2 100644 --- a/translations/zh-CN/content/github/site-policy/github-additional-product-terms.md +++ b/translations/zh-CN/content/github/site-policy/github-additional-product-terms.md @@ -42,15 +42,15 @@ GitHub Pages 受某些特定带宽和使用限制的约束，可能不适用于 ### 5. Actions 和 Packages #### a. Actions 的使用 -GitHub Actions 使您能够直接在您的 GitHub 仓库中创建自定义软件开发生命周期工作流程。 每个帐户都自带可用于 Actions 的计算和存储空间，具体数量取决于您的帐户计划，可在 [Actions 文档](/github/automating-your-workflow-with-github-actions/about-github-actions#about-github-actions)中查阅。 Actions 的计算用量显示在[您的帐户设置](https://github.com/settings/billing)中，在达到自带空间的上限之前您会收到电子邮件通知。 如果要超出自带空间使用 Actions，您可以[启用超限](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions)。 +GitHub Actions 使您能够直接在您的 GitHub 仓库中创建自定义软件开发生命周期工作流程。 Each Account comes with included compute and storage quantities for use with Actions, depending on your Account plan, which can be found in the [Actions documentation](/actions). Actions 的计算用量显示在[您的帐户设置](https://github.com/settings/billing)中，在达到自带空间的上限之前您会收到电子邮件通知。 如果要超出自带空间使用 Actions，您可以[启用超限](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions)。 -自带和付费空间的计算用量以分钟为单位计算，具体取决于您执行的 Actions 类型（例如 Linux、Windows、macOS）。 每个 Action 的作业或任务所用的时间将取整到最接近的分钟数。 要判断自带空间是否充足，可以用倍数乘以执行每个作业或任务所用的时间量（取整之前），具体取决于 Action 的类型。 超限分钟数按[规定的每分钟价格](https://github.com/features/actions)收费，具体取决于您执行的 Actions 类型。 Actions 和 Packages 共用存储空间，您的存储空间用量显示在您的[帐户设置](https://github.com/settings/billing)中。 有关自带空间用量计算的更多信息，请参阅 [Actions 文档](/github/automating-your-workflow-with-github-actions/about-github-actions#about-github-actions)。 +自带和付费空间的计算用量以分钟为单位计算，具体取决于您执行的 Actions 类型（例如 Linux、Windows、macOS）。 每个 Action 的作业或任务所用的时间将取整到最接近的分钟数。 要判断自带空间是否充足，可以用倍数乘以执行每个作业或任务所用的时间量（取整之前），具体取决于 Action 的类型。 超限分钟数按[规定的每分钟价格](https://github.com/features/actions)收费，具体取决于您执行的 Actions 类型。 Actions 和 Packages 共用存储空间，您的存储空间用量显示在您的[帐户设置](https://github.com/settings/billing)中。 For additional details about included quantity usage calculations, see the [Actions documentation](/actions). -对 Actions 和任何 Action 服务元素的使用，不得违反协议、[可接受使用政策](/github/site-policy/github-acceptable-use-policies)或 GitHub Actions [服务限制](/github/automating-your-workflow-with-github-actions/about-github-actions#usage-limits)。 此外，Actions 不得用于： +对 Actions 和任何 Action 服务元素的使用，不得违反协议、[可接受使用政策](/github/site-policy/github-acceptable-use-policies)或 GitHub Actions [服务限制](/actions/reference/usage-limits-billing-and-administration/#usage-limits)。 此外，Actions 不得用于： - 密码破解; - 使用我们的服务器破坏、非授权访问或尝试非授权访问任何服务、设备、数据、帐户或网络（[GitHub 漏洞赏金计划](https://bounty.github.com)授权的活动除外）； -- the provision of a stand-alone or integrated application or service offering Actions or any elements of Actions for commercial purposes; -- any activity that places a burden on our servers, where that burden is disproportionate to the benefits provided to users (for example, don't use Actions as a content delivery network or as part of a serverless application, but a low benefit Action could be ok if it’s also low burden); or +- 出于商业目的，提供兜售 Actions 或任何 Actions 元素的独立或集成应用程序或服务； +- 任何给我们的服务器带来负担的活动，如果这种负担与提供给用户的收益不成比例（例如，不要将 Action 用作内容交付网络或作为无服务器应用程序的一部分，但收益低负担也低的 Action 可能没问题）；或 - 与使用 GitHub Actions 的仓库相关的软件项目创建、测试、部署或发布无关的任何其他活动。 为防止违反这些限制和滥用 GitHub Actions，GitHub 可能会监视您对 GitHub Actions 的使用。 滥用 GitHub Actions 可能会导致作业终止，或者您使用 GitHub Actions 的权限受限。 diff --git a/translations/zh-CN/content/github/site-policy/github-and-trade-controls.md b/translations/zh-CN/content/github/site-policy/github-and-trade-controls.md index 234f88c40bfd..8e1d09cecf45 100644 --- a/translations/zh-CN/content/github/site-policy/github-and-trade-controls.md +++ b/translations/zh-CN/content/github/site-policy/github-and-trade-controls.md @@ -9,25 +9,25 @@ versions: free-pro-team: '*' --- -GitHub.com、GitHub Enterprise Server 以及您上传至其中任一产品的信息都需遵守贸易管制法规，包括美国出口管理条例（Export Administration Regulations，EAR）。 Export Administration Regulations (the EAR). +GitHub.com、GitHub Enterprise Server 以及您上传至其中任一产品的信息都需遵守贸易管制法规，包括美国出口管理条例（Export Administration Regulations，EAR）。 出口管理条例 (EAR)。 GitHub 的愿景是成为开发者合作的全球平台，不管开发者居住在哪里都可参与。 我们认真履行全面研究政府法规的职责，以确保用户和客户不受法律以外因素的影响。 这包括保持公共仓库服务，其中包括提供开放源码项目并帮助用户访问，以支持受制裁区域开发人员的个人沟通。 -To comply with U.S. 为了遵守美国贸易管制法律，GitHub 对其提供服务的方式作了一些必要的更改。 As U.S. 随着美国贸易管制法律的发展，我们将继续配合美国监管机构，在允许的范围内向受制裁市场的开发者提供免费代码协作服务。 regulators about the extent to which we can offer free code collaboration services to developers in sanctioned markets. 我们认为，提供这些免费服务有助于美国关于鼓励这些地区的信息自由流动和言论自由的外交政策。 我们认为，提供这些免费服务有助于美国关于鼓励这些市场的信息自由流动和言论自由的外交政策。 有关我们的方法和制裁如何影响全球软件合作的更多见解，请参阅我们[关于制裁的博客](https://github.blog/2019-09-12-global-software-collaboration-in-the-face-of-sanctions/)。 +为了遵守美国 为了遵守美国贸易管制法律，GitHub 对其提供服务的方式作了一些必要的更改。 随着美国 随着美国贸易管制法律的发展，我们将继续配合美国监管机构，在允许的范围内向受制裁市场的开发者提供免费代码协作服务。 监管机构，在允许的范围内向受制裁市场的开发者提供免费代码协作服务。 我们认为，提供这些免费服务有助于美国关于鼓励这些地区的信息自由流动和言论自由的外交政策。 我们认为，提供这些免费服务有助于美国关于鼓励这些市场的信息自由流动和言论自由的外交政策。 有关我们的方法和制裁如何影响全球软件合作的更多见解，请参阅我们[关于制裁的博客](https://github.blog/2019-09-12-global-software-collaboration-in-the-face-of-sanctions/)。 -虽然我们为了方便您而提供了以下信息，但您要最终负责确保对 GitHub 产品和服务的使用符合所有适用法律和法规，包括美国出口管制法律。 export control laws. +虽然我们为了方便您而提供了以下信息，但您要最终负责确保对 GitHub 产品和服务的使用符合所有适用法律和法规，包括美国出口管制法律。 出口管制法律。 ### 出口概述 #### GitHub.com -根据我们的[服务条款](/articles/github-terms-of-service)，用户必须按照相关法律访问和使用 GitHub ，包括美国出口管制和制裁法律。 export control and sanctions laws. +根据我们的[服务条款](/articles/github-terms-of-service)，用户必须按照相关法律访问和使用 GitHub ，包括美国出口管制和制裁法律。 出口管制和制裁法律。 -用户负责确保他们在 GitHub.com 上开发和分享的内容符合美国出口管制法律，包括 EAR 和美国国际武器贩运条例（International Traffic in Arms Regulations，ITAR）。 export control laws, including the EAR and the U.S. International Traffic in Arms Regulations (ITAR). [GitHub.com](https://github.com) 上提供的云端托管服务不托管受 ITAR 约束的数据，目前也无法按国家或地区限制仓库访问。 如果寻求就 ITAR 或其他出口管制数据进行合作，我们建议您考虑 [GitHub Enterprise Server](https://enterprise.github.com) - GitHub 的本地服务。 +用户负责确保他们在 GitHub.com 上开发和分享的内容符合美国出口管制法律，包括 EAR 和美国国际武器贩运条例（International Traffic in Arms Regulations，ITAR）。 出口管制法律，包括 EAR 和美国 国际武器贩运条例（International Traffic in Arms Regulations，ITAR）。 [GitHub.com](https://github.com) 上提供的云端托管服务不托管受 ITAR 约束的数据，目前也无法按国家或地区限制仓库访问。 如果寻求就 ITAR 或其他出口管制数据进行合作，我们建议您考虑 [GitHub Enterprise Server](https://enterprise.github.com) - GitHub 的本地服务。 -U.S. 美国贸易管制法律限制向某些国家和地区的用户提供 GitHub.com 服务。 GitHub may allow users in or ordinarily resident in countries and territories subject to U.S. sanctions to access certain free GitHub.com services for personal communications in accordance to authorizations issued by the U.S. Treasury Department’s Office of Foreign Assets Controls (OFAC). 在这些国家和地区的个人或常住居民在访问 GitHub 时不得使用 IP 代理、VPN 或掩盖其位置的其他方法，并且只能将 GitHub.com 用于非商业个人通信。 +美国 美国贸易管制法律限制向某些国家和地区的用户提供 GitHub.com 服务。 根据美国财政部外国资产管制办公室（Office of Foreign Assets Controls，OFAC）颁发的授权，GitHub 可能允许受美国制裁的国家和地区的用户或常住居民 使用某些免费的 GitHub 服务， 以用于个人通信。 在这些国家和地区的个人或常住居民在访问 GitHub 时不得使用 IP 代理、VPN 或掩盖其位置的其他方法，并且只能将 GitHub.com 用于非商业个人通信。 -Specially Designated Nationals (SDNs) and other denied or blocked parties under U.S. and other applicable law are prohibited from accessing or using GitHub.com. 此外，用户不得为包括受制裁国政府在内的这类当事方或代表他们使用 GitHub.com。 此外，GitHub.com 不得用于适用的出口管制法律所禁止的目的，包括 [17 CFR 744](https://www.ecfr.gov/cgi-bin/text-idx?SID=ad384e1f1e017076f8c0136f322f0a4c&mc=true&node=pt15.2.744&rgn=div5) 中所述的被禁止最终用途。 +根据美国及其他适用法律，特别指定国民 (SDN) 及其他被拒绝或被阻止的当事方 不得访问或使用GitHub.com。 此外，用户不得为包括受制裁国政府在内的这类当事方或代表他们使用 GitHub.com。 此外，GitHub.com 不得用于适用的出口管制法律所禁止的目的，包括 [17 CFR 744](https://www.ecfr.gov/cgi-bin/text-idx?SID=ad384e1f1e017076f8c0136f322f0a4c&mc=true&node=pt15.2.744&rgn=div5) 中所述的被禁止最终用途。 #### GitHub Enterprise Server @@ -39,7 +39,7 @@ GitHub Enterprise Server 不能出售、出口或再出口到 EAR 的补充编 ### 常见问题 -#### On which countries and territories are U.S. government sanctions applied? +#### 美国政府对哪些国家和地区 实行制裁？ 克里米亚、古巴、伊朗、朝鲜和叙利亚。 @@ -47,7 +47,7 @@ GitHub Enterprise Server 不能出售、出口或再出口到 EAR 的补充编 在很少的情况下，会有帐户无意或错误地受到影响，此时我们有上诉流程来处理这种情况。 -如果个别用户或组织管理员认为他们被错误标记，则该用户有机会向 GitHub 提供验证信息，对该标记提出上诉。 如果 GitHub 收到充分的信息，能够核实用户或组织不属于美国制裁的地区或美国经济制裁限制的地区，则会撤销该标记。 economic sanctions, then the flag will be removed. 请参阅[个别帐户上诉申请表](https://airtable.com/shrGBcceazKIoz6pY)和[组织帐户上诉申请表](https://airtable.com/shrB2je5RBkqLEt5D)。 +如果个别用户或组织管理员认为他们被错误标记，则该用户有机会向 GitHub 提供验证信息，对该标记提出上诉。 如果 GitHub 收到充分的信息，能够核实用户或组织不属于美国制裁的地区或美国经济制裁限制的地区，则会撤销该标记。 经济制裁限制的地区，则会撤销该标记。 请参阅[个别帐户上诉申请表](https://airtable.com/shrGBcceazKIoz6pY)和[组织帐户上诉申请表](https://airtable.com/shrB2je5RBkqLEt5D)。 #### 到这些地区旅行是否会受到影响？ @@ -57,27 +57,27 @@ GitHub Enterprise Server 不能出售、出口或再出口到 EAR 的补充编 GitHub 承诺继续向受美国制裁地区拥有个人和组织帐户的开发者免费提供公共仓库服务。 包括有限制地访问免费服务，例如用于开源项目（和相关公共页面）的公共仓库、公共Gist 以及分配的免费操作分钟数，但只能用于个人通信，而不得用于商业目的。 -However, due to U.S. 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. 请阅读 [GitHub 和贸易管制](https://help.github.com/github/site-policy/github-and-trade-controls)了解更多信息。 sanctioned regions like North Korea, Iran, Syria, and Crimea. 该限制将暂停对私有仓库服务和付费服务的访问，例如免费或付费私有仓库、秘密 Gist、付费操作分钟数、赞助商和 GitHub Marketplace 服务的可用性。 +但是，由于美国 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. 请阅读 [GitHub 和贸易管制](https://help.github.com/github/site-policy/github-and-trade-controls)了解更多信息。 制裁地区，例如朝鲜、伊朗、叙利亚和克里米亚。 该限制将暂停对私有仓库服务和付费服务的访问，例如免费或付费私有仓库、秘密 Gist、付费操作分钟数、赞助商和 GitHub Marketplace 服务的可用性。 对于受制裁地区付费的组织级帐户，用户能够有限制地访问其公共仓库，这些仓库已降级为存档的只读仓库。 但是，对于受制裁地区的免费组织级帐户，用户仍然可以完全访问用于开源项目（和相关公共页面）的免费公共仓库、公共 Gist 和分配的免费操作分钟数。 -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. regulators for the greatest possible access to free code collaboration services to developers in sanctioned regions, including free private repositories. 我们认为，提供这些免费服务有助于美国关于鼓励这些地区的信息自由流动和言论自由的外交政策。 foreign policy of encouraging the free flow of information and free speech in those regions. +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. 监管机构提倡让受制裁地区的开发者尽可能获得免费代码协作服务，包括访问免费私有仓库。 我们认为，提供这些免费服务有助于美国关于鼓励这些地区的信息自由流动和言论自由的外交政策。 关于鼓励这些市场的信息自由流动和言论自由的外交政策。 #### 如何定义这些特定用户？ -如果 GitHub 确定用户或客户位于受美国贸易管制限制约束的区域，或用户受到美国经济制裁的限制，则关联帐户需遵守这些法律要求。 trade control restrictions, or a user is otherwise restricted under U.S. economic sanctions, then the affiliated account has been restricted to comply with those legal requirements. 为执行这些法律限制而确定用户和客户的位置时，从多个来源进行考虑，包括 IP 地址和付款记录。 国籍和族裔不用于标记适用于制裁限制的用户。 +如果 GitHub 确定用户或客户位于受美国贸易管制限制约束的区域，或用户受到美国经济制裁的限制，则关联帐户需遵守这些法律要求。 贸易管制限制约束的区域，或用户受到美国 经济制裁的限制，则关联帐户需遵守这些法律要求。 为执行这些法律限制而确定用户和客户的位置时，从多个来源进行考虑，包括 IP 地址和付款记录。 国籍和族裔不用于标记适用于制裁限制的用户。 #### 组织帐户受到何种影响？ -If an organization is based out of, or the key individuals or membership of an organization shows sufficient ties to, a sanctioned territory or country, or if the organization otherwise appears to be subject to U.S. economic sanctions, then the organization account and the affiliated owner account will be restricted. +如果组织的基地位于被制裁的地区或国家，或者组织的主要个人或成员显示与被制裁的地区或国家有充分的联系，或者该组织似乎受到美国 经济制裁的限制，则该组织帐户和关联的所有者帐户将受到限制。 该限制将暂停对私有仓库服务和付费服务的访问，例如免费或付费私有仓库、秘密 Gist、付费操作分钟数、赞助商和 GitHub Marketplace 服务的可用性。 对于与受制裁地区相关的付费组织级帐户，用户能够有限制地访问其公共仓库，这些仓库已降级为存档的只读仓库。 对于与受制裁地区相关的免费组织级帐户，用户仍然可以完全访问用于开源项目（和相关公共页面）的免费公共仓库、公共 Gist 和分配的免费操作分钟数。 #### 是否可将受交易限制的用户私有仓库设为公共？ -免费的个人帐户用户可以将受限制的私有仓库设为公共，但仅供个人通信使用，而不能用于商业目的。 用户可以通过导航到仓库设置选项卡并单击“make public（设为公共）”按钮来完成此操作。 仓库在设为公共后，用户便可访问公共仓库服务。 This action cannot be undone. +免费的个人帐户用户可以将受限制的私有仓库设为公共，但仅供个人通信使用，而不能用于商业目的。 用户可以通过导航到仓库设置选项卡并单击“make public（设为公共）”按钮来完成此操作。 仓库在设为公共后，用户便可访问公共仓库服务。 此操作无法撤消。 #### 受贸易限制的用户能否访问私有仓库数据（例如下载或删除仓库数据）？ -遗憾的是，我们对法律的理解并不能让我们选择允许下载或删除私有仓库内容，除非得到美国政府的批准。 government. We will strongly advocate, with U.S. 我们将向美国监管机构大力倡议让受贸易限制的用户有权保护其私有仓库的内容。 我们还将提倡向受制裁市场的开发人员提供更多的 GitHub 服务，并进一步强调代码协作在支持全球开发人员个人通信方面的重要性。 +遗憾的是，我们对法律的理解并不能让我们选择允许下载或删除私有仓库内容，除非得到美国政府的批准。 政府。 我们将向美国大力倡议 我们将向美国监管机构大力倡议让受贸易限制的用户有权保护其私有仓库的内容。 我们还将提倡向受制裁市场的开发人员提供更多的 GitHub 服务，并进一步强调代码协作在支持全球开发人员个人通信方面的重要性。 diff --git a/translations/zh-CN/content/github/site-policy/github-anti-bribery-statement.md b/translations/zh-CN/content/github/site-policy/github-anti-bribery-statement.md index 7d5286fae9d8..a5d04cef0ed5 100644 --- a/translations/zh-CN/content/github/site-policy/github-anti-bribery-statement.md +++ b/translations/zh-CN/content/github/site-policy/github-anti-bribery-statement.md @@ -19,7 +19,7 @@ GitHub 恪守道德经营的承诺，包括禁止贿赂和腐败。 正如[透 GitHub 在许多公司政策中明确展示了我们的反贿赂承诺。 作为 Microsoft 家族的一员，GitHub 除了遵守本文所述的政策外，还承诺遵守 Microsoft 的反腐败政策，这适用于所有 GitHub 员工和承包商。 GitHub 的**道德准则**禁止员工和承包商从事或促成贿赂或腐败，并制定了记录保留要求： -> 不得为了帮助 GitHub 或 Microsoft 获取或保持业务或任何其他不正当优势，向任何人（包括身居权力或权限职位的任何人，例如政府官员或商业交易决策者）支付、提议支付、承诺支付、诱使、接受或授权支付现金或任何其他有价值的事物。 也不得索取或接受贿赂、回扣或任何其他不当现金付款。 ... [GitHub 员工] 对于以下交易必须保留准确和公允的记录：涉及代表 GitHub 支出任何费用的所有交易，例如保留收据并准确说明您的费用支出；或者涉及处置或转让 GitHub 资产的任何其他交易。 Such actions are required by the U.S. Foreign Corrupt Practices Act, the U.K. 《美国反海外腐败法》、2010 年《英国反贿赂法》以及 GitHub 开展业务所在其他司法管辖区的反贿赂法律均要求采取此类措施，这也是正确行事的原则。 +> 不得为了帮助 GitHub 或 Microsoft 获取或保持业务或任何其他不正当优势，向任何人（包括身居权力或权限职位的任何人，例如政府官员或商业交易决策者）支付、提议支付、承诺支付、诱使、接受或授权支付现金或任何其他有价值的事物。 也不得索取或接受贿赂、回扣或任何其他不当现金付款。 ... [GitHub 员工] 对于以下交易必须保留准确和公允的记录：涉及代表 GitHub 支出任何费用的所有交易，例如保留收据并准确说明您的费用支出；或者涉及处置或转让 GitHub 资产的任何其他交易。 《美国反海外腐败法》、 2010 年《英国反贿赂法》 《美国反海外腐败法》、2010 年《英国反贿赂法》以及 GitHub 开展业务所在其他司法管辖区的反贿赂法律均要求采取此类措施，这也是正确行事的原则。 GitHub 的道德准则详细说明了某些情况，包括礼品、旅游和招待；疏通费；慈善捐赠；职位；与代表合作；以及谁被视为政府官员。 @@ -30,7 +30,7 @@ GitHub 的**礼品和招待政策**规定，不允许旅游或招待方面的贿 ### 培训我们的员工 -GitHub 员工必须参加有关腐败（包括贿赂）的培训。 我们还为特别相关的人员和团队（例如我们的销售团队）提供额外的培训。 The training explains relevant elements of the U.S. Foreign Corrupt Practices Act and the U.K. Bribery Act of 2010. 例如， +GitHub 员工必须参加有关腐败（包括贿赂）的培训。 我们还为特别相关的人员和团队（例如我们的销售团队）提供额外的培训。 培训讲解了《美国反海外腐败法》和 2010 年 《英国反贿赂法》 的相关要素。 例如， - 腐败的定义和结构影响 - 涵盖哪些人，包括 - 公职人员或身居要职的其他人员 @@ -47,7 +47,7 @@ GitHub 员工必须参加有关腐败（包括贿赂）的培训。 我们还为 此外，培训涵盖了 GitHub 有关反腐败和贿赂的内部政策，包括我们的反报复（举报者）政策。 -While the U.S. FCPA is focused on interactions with government officials, the U.K. Bribery Act is broader and extends to bribing anyone, regardless of whether they are a government official. 这两项法律均可扩展到管辖 GitHub 在全球其他地方的行动。 GitHub 的政策禁止贿赂全球任何地方的任何人。 +《美国反海外腐败法》 主要针对与政府官员的互动，而《英国反贿赂法》 涵盖范围更广，扩展到禁止贿赂任何人，无论他们是否为政府官员。 这两项法律均可扩展到管辖 GitHub 在全球其他地方的行动。 GitHub 的政策禁止贿赂全球任何地方的任何人。 ### 要求我们的合作伙伴 - GitHub 的标准**渠道合作伙伴转售协议**包括强制性的反腐败条款。 从今往后，GitHub 要求我们的渠道合作伙伴承诺遵守本反腐败声明。 diff --git a/translations/zh-CN/content/github/site-policy/github-community-forum-code-of-conduct.md b/translations/zh-CN/content/github/site-policy/github-community-forum-code-of-conduct.md index 12251a6e2350..0c38039fa27a 100644 --- a/translations/zh-CN/content/github/site-policy/github-community-forum-code-of-conduct.md +++ b/translations/zh-CN/content/github/site-policy/github-community-forum-code-of-conduct.md @@ -106,7 +106,7 @@ GitHub 社区论坛提倡互相尊重。 论坛是一种共享资源 — 通过 ### 联系 GitHub 工作人员 -If, for any reason, you want to contact GitHub Staff, the Community Managers, Administrators, or Moderators of this forum privately, you can use our [Support contact form](https://support.github.com/contact?tags=community-support). Contacting any member of GitHub Staff via channels other than the forum itself or the Support contact form is strongly discouraged and may be considered a violation of our prohibition against harassment. +如果出于任何原因要私下联系本论坛的 GitHub 工作人员、社区管理员或版主，您可以使用我们的[支持联系表](https://support.github.com/contact?tags=community-support)。 强烈建议不要通过论坛或支持联系表以外的渠道联系任何 GitHub 工作人员，否则可能被视为违反我们禁止骚扰的规定。 让我们共同努力，互相尊重并珍惜每个人的时间，使论坛成为一个人们可以安全舒适地参与的环境。 diff --git a/translations/zh-CN/content/github/site-policy/github-corporate-terms-of-service.md b/translations/zh-CN/content/github/site-policy/github-corporate-terms-of-service.md index 2bca7f08cbcc..c4d6f270ced9 100644 --- a/translations/zh-CN/content/github/site-policy/github-corporate-terms-of-service.md +++ b/translations/zh-CN/content/github/site-policy/github-corporate-terms-of-service.md @@ -9,7 +9,7 @@ versions: 感谢您选择 GitHub 满足贵公司的业务需求。 请仔细阅读本协议，因为它管辖对产品（定义如下）的使用，除非 GITHUB 在这方面与客户签订了单独的书面协议。 单击“I AGREE（我同意）”或类似按钮或者使用产品，即表示客户接受本协议的所有条款和条件。 如果客户代表公司或其他法律实体签订本协议，则表示其拥有让该公司或其他法律实体受本协议约束的法律权限。 ### GitHub 公司服务条款 -Version Effective Date: July 20, 2020 +版本生效日期：2020 年 7 月 20 日 本协议适用于以下 GitHub 产品（详细定义见下文，统称为**“产品”**）： - 服务； @@ -99,7 +99,7 @@ Version Effective Date: July 20, 2020 * 用户登录名不能多人共享。 -- Customer must not use the Products (a) in violation of export control or sanctions laws of the United States or any other applicable jurisdiction; (b) if it is located in or ordinarily resident in a country or territory subject to comprehensive to comprehensive sanctions administered by the U.S. Office of Foreign Assets Control (OFAC); or (c) if it is or is working on behalf of a [Specially Designated National (SDN)](https://www.treasury.gov/resource-center/sanctions/SDN-List/Pages/default.aspx) or a person subject to similar blocking or denied party prohibitions. 更多信息请参阅我们的[出口管制政策](/articles/github-and-export-controls)。 +- 客户在以下情况下不得使用产品 (a) 违反美国或任何其他司法管辖区的出口管制或制裁法律；(b) 如果位于或普通居住于遭受美国 “外国资产管制办公室”(OFAC) 全面制裁的国家或地区；或 (c) 如果客户是[特别指定的国民 (SDN)](https://www.treasury.gov/resource-center/sanctions/SDN-List/Pages/default.aspx) 或代表其工作，或者是遭受类似封锁或被拒绝方禁令的个人。 更多信息请参阅我们的[出口管制政策](/articles/github-and-export-controls)。 #### 3. 帐户安全 客户负责：(i) 在其公司帐户下发布的所有内容和发生的活动；(ii) 保持其帐户登录凭据的安全；以及 (iii) 在获悉通过其帐户对服务的任何未授权使用或访问时[及时通知 GitHub](https://github.com/contact)。 GitHub 对客户不遵守本 B 部分所造成的任何损失或损害概不负责。 @@ -107,11 +107,11 @@ Version Effective Date: July 20, 2020 #### 4. 第三方条款 在某些情况下，第三方的条款可能适用于客户对 GitHub 的使用。 例如，客户可能是本身具有条款或许可协议的组织的成员；客户可能下载与服务相集成的应用程序；或者，客户可能使用服务向另一项服务验证。 虽然本协议是 GitHub 与客户的完全协议，但其他方的条款也会管辖他们与客户的关系。 -#### 5. U.S. 5. 美国联邦政府条款 -If Customer is a U.S. government entity or otherwise accessing or using the Service in a government capacity, the [U.S. Federal Government Amendment](/articles/amendment-to-github-terms-of-service-applicable-to-us-federal-government-users) applies, and Customer agrees to its provisions. +#### 5. 美国 5. 美国联邦政府条款 +如果客户是美国 联邦政府机构或者在政府部门访问或使用服务，则[美国 联邦政府修正](/articles/amendment-to-github-terms-of-service-applicable-to-us-federal-government-users)适用，并且客户同意其条款。 -#### 6. Enterprise Cloud Service Level Agreement -GitHub’s quarterly uptime commitment for GitHub Enterprise Cloud is provided in the [Enterprise Service Level Agreement](/github/site-policy/github-enterprise-service-level-agreement). If Customer signed up for GitHub Enterprise Cloud, then Customer will be entitled to a service credit if GitHub does not meet its service level. +#### 6. Enterprise Cloud 服务等级协议 +GitHub 在[企业服务等级协议](/github/site-policy/github-enterprise-service-level-agreement)中提供了 GitHub Enterprise Cloud 的季度正常运行时间承诺。 客户注册 GitHub Enterprise Cloud 后，如果 GitHub 未达到其服务等级，则客户将有权获得服务积分。 ### C. 遵守法律；可接受的使用；隐私 @@ -122,7 +122,7 @@ GitHub’s quarterly uptime commitment for GitHub Enterprise Cloud is provided i 客户对服务的使用必须遵守 [GitHub 可接受的使用政策](/articles/github-acceptable-use-policies)和 [GitHub 社区指导方针](/articles/github-community-guidelines)。 客户不得在任何司法管辖区将服务用于非法、淫秽、冒犯性或欺诈性内容或活动，例如鼓吹或造成伤害；干扰或违反网络或系统的完整性或安全性；避开过滤器；发送主动、辱骂或欺诈性消息、病毒或有害代码；或者违反第三方权利。 #### 3. 隐私 -The [GitHub Privacy Statement](/articles/github-privacy-statement) and the [GitHub Data Protection Addendum](/github/site-policy/github-data-protection-addendum) provide detailed notice of GitHub's privacy and data use practices as well as GitHub's processing and security obligations with respect to Customer Personal Data. 任何个人、实体或服务从服务收集数据都必须遵守 GitHub 隐私声明，特别是收集用户个人信息（定义见“GitHub 隐私声明”）时。 如果客户从 GitHub 收集任何用户个人信息，则客户仅将其用于外部用户已授权的目的。 客户将合理保护任何此类个人信息，并且客户会及时响应 GitHub 或外部用户的投诉、删除请求以及“不要联系”请求。 +[GitHub 隐私声明](/articles/github-privacy-statement)和 [GitHub 数据保护附录](/github/site-policy/github-data-protection-addendum)详细介绍了 GitHub 的隐私保护和数据使用实践，以及 GitHub 在处理和保护客户个人数据方面的义务。 任何个人、实体或服务从服务收集数据都必须遵守 GitHub 隐私声明，特别是收集用户个人信息（定义见“GitHub 隐私声明”）时。 如果客户从 GitHub 收集任何用户个人信息，则客户仅将其用于外部用户已授权的目的。 客户将合理保护任何此类个人信息，并且客户会及时响应 GitHub 或外部用户的投诉、删除请求以及“不要联系”请求。 ### D. 内容责任；所有权；许可权利 diff --git a/translations/zh-CN/content/github/site-policy/github-data-protection-addendum.md b/translations/zh-CN/content/github/site-policy/github-data-protection-addendum.md index 76747d901403..886048eae487 100644 --- a/translations/zh-CN/content/github/site-policy/github-data-protection-addendum.md +++ b/translations/zh-CN/content/github/site-policy/github-data-protection-addendum.md @@ -160,8 +160,8 @@ e. 客户根据第 6.5 条反对再处理方，并且 GitHub 在九十天内无 #### 7.6 修改。 GitHub 可在提前三十天通知客户后，根据适用数据保护法律的要求不时修改本附录。 -#### 7.7 Termination Requirements. -Upon Termination, GitHub must: +#### 7.7 终止要求。 +终止后，GitHub 必须： a. 采取合理、适当的措施停止处理客户个人数据； @@ -171,188 +171,188 @@ c. 向客户提供合理的保证，确保 GitHub 已履行其在第 7.7 条中 ### 8. 数据处理责任。 -#### 8.1 Limitations. -Except as limited by the Applicable Data Protection Laws, any claims brought under this Addendum will be subject to the terms of the Agreement regarding Limitations of Liability. +#### 8.1 限制。 +适用数据保护法律限制的除外，在本附录下提出的任何要求需遵守关于责任限制的协议条款。 -## Attachment 1 – The Standard Contractual Clauses (Processors) -Execution of the applicable agreement by Customer includes execution of this Attachment 1 to the GitHub Data Protection Addendum, which is countersigned by GitHub, Inc. +## 附件 1 - 标准合同条款 (处理方) +客户执行的适用协议包括由 GitHub, Inc 签署的《数据保护附录》的本附件 1。 -In countries where regulatory approval is required for use of the Standard Contractual Clauses, the Standard Contractual Clauses cannot be relied upon under European Commission 2010/87/EU (of February 2010) to legitimize export of data from the country, unless Customer has the required regulatory approval. +在使用标准合同条款需要监管机构批准的国家/地区，除非客户获得了所需的监管机构批准，否则根据欧洲委员会 2010/87/EU（2010 年 2 月）的规定，客户不得根据标准合同条款确定从此类国家/地区出口数据的合法性。 -For the purposes of Article 46(2) of the General Data Protection Regulation (EU 2016/679) for the transfer of personal data to processors established in third countries which do not ensure an adequate level of data protection, Customer (as data exporter) and GitHub (as data importer, whose signature appears below), each a “party,” together “the parties,” have agreed on the following Contractual Clauses (the “Clauses” or “Standard Contractual Clauses”) in order to adduce adequate safeguards with respect to the protection of privacy and fundamental rights and freedoms of individuals for the transfer by the data exporter to the data importer of the personal data specified in Appendix 1. +根据《通用数据保护条例》(EU 2016/679) 第 46(2) 条针对将个人数据转移给在无法确保充分数据保护级别的第三国设立的处理方之规定，客户（作为数据出口方）和 GitHub（作为数据进口方，其签名见下文）每一方（合称为“双方”）都同意以下合同条款（以下简称“条款”或“标准合同条款”），以便在数据出口方将附录 1 中规定的个人数据转移给数据进口方时，为个人的隐私、基本权利和自由提供充分保障。 -#### Clause 1: Definitions -(a) 'personal data', 'special categories of data', 'process/processing', 'controller', 'processor', 'data subject' and 'supervisory authority' shall have the same meaning as in the General Data Protection Regulation (EU 2016/679) on the protection of individuals with regard to the processing of personal data and on the free movement of such data; +#### 第 1 条：定义 +(a) “个人数据”、“特殊数据类别”、“处理”、“控制方”、“处理方”、“数据主体”和“监督机构”应采用《通用数据保护条例》(EU 2016/679) 在个人数据处理和此类数据自由流通的个人保护方面规定的含义； -(b) 'the data exporter' means the controller who transfers the personal data; +(b) “数据出口方”是指负责转移个人数据的控制方； -(c) 'the data importer' means the processor who agrees to receive from the data exporter personal data intended for processing on his behalf after the transfer in accordance with his instructions and the terms of the Clauses and who is not subject to a third country's system ensuring adequate protection within the meaning of Article 45(2) of the General Data Protection Regulation (EU 2016/679); +(c) “数据进口方”是指从数据出口方接收个人数据，并在数据转移后，根据数据出口方的指示和条款规定代表其处理此类数据的处理方，并且不受第三国系统的约束，确保数据根据《通用数据保护条例》(EU 2016/679) 第 45(2) 条的规定得到充分保护。 -(d) 'the subprocessor' means any processor engaged by the data importer or by any other subprocessor of the data importer who agrees to receive from the data importer or from any other subprocessor of the data importer personal data exclusively intended for processing activities to be carried out on behalf of the data exporter after the transfer in accordance with his instructions, the terms of the Clauses and the terms of the written subcontract; +(d) “再处理方”是指数据进口方或数据进口方的任何其他再处理方雇佣的任何处理方，他们从数据进口方或数据进口方的任何其他再处理方接收个人数据，并在数据转移后，根据其指示、条款规定以及书面分包合同的条款代表其执行数据处理活动； -(e) 'the applicable data protection law' means the legislation protecting the fundamental rights and freedoms of individuals and, in particular, their right to privacy with respect to the processing of personal data applicable to a data controller in the Member State in which the data exporter is established; +(e) “适用的数据保护法”是指保护个人基本权利和自由的立法，尤其是保护个人在处理个人数据方面的隐私权，适用于数据出口方所在成员国的数据控制方； -(f) 'technical and organisational security measures' means those measures aimed at protecting personal data against accidental or unlawful destruction or accidental loss, alteration, unauthorised disclosure or access, in particular where the processing involves the transmission of data over a network, and against all other unlawful forms of processing. +(f) “技术和组织安全措施”是指旨在保护个人数据不受意外或非法破坏或意外丢失、更改、未经授权披露或访问的措施，尤其是涉及网络数据传输的处理以及针对所有其他非法处理方式。 -#### Clause 2: Details of the transfer -The details of the transfer and in particular the special categories of personal data where applicable are specified in Appendix 1 below which forms an integral part of the Clauses. +#### 第 2 条：转移细节 +转移细节，尤其是特殊类别个人数据的转移，应遵守下文附录 1 中的规定，该附录构成了本条款的组成部分。 -#### Clause 3: Third-party beneficiary clause -1. The data subject can enforce against the data exporter this Clause, Clause 4(b) to (i), Clause 5(a) to (e), and (g) to (j), Clause 6(1) and (2), Clause 7, Clause 8(2), and Clauses 9 to 12 as third-party beneficiary. +#### 第 3 条：第三方受益人条款 +1. 数据主体可以作为第三方受益人对数据出口方执行本条、第 4(b) 至 (i)、第 5(a) 至 (e) 和 (g) 至 (j)、第 6(1) 和 (2)、第 7、第 8(2) 和第 9 至 12 条。 -2. The data subject can enforce against the data importer this Clause, Clause 5(a) to (e) and (g), Clause 6, Clause 7, Clause 8(2), and Clauses 9 to 12, in cases where the data exporter has factually disappeared or has ceased to exist in law unless any successor entity has assumed the entire legal obligations of the data exporter by contract or by operation of law, as a result of which it takes on the rights and obligations of the data exporter, in which case the data subject can enforce them against such entity. +2. 在数据出口方事实上已经消失或在法律上不复存在的情况下，数据主体可对数据进口方执行本条、第 5(a) 至 (e) 和 (g)、第 6、第 7、第 8(2) 和第 9 至 12 条，除非任何继承实体通过合同或法律的实施承担了数据出口方的全部法律义务，并因此承担了数据出口方的权利和义务，在这种情况下，数据主体可以针对此类实体执行这些条款。 -3. The data subject can enforce against the subprocessor this Clause, Clause 5(a) to (e) and (g), Clause 6, Clause 7, Clause 8(2), and Clauses 9 to 12, in cases where both the data exporter and the data importer have factually disappeared or ceased to exist in law or have become insolvent, unless any successor entity has assumed the entire legal obligations of the data exporter by contract or by operation of law as a result of which it takes on the rights and obligations of the data exporter, in which case the data subject can enforce them against such entity. Such third-party liability of the subprocessor shall be limited to its own processing operations under the Clauses. +3. 在数据出口方和数据进口方事实上已经消失或在法律上不复存在或已经破产的情况下，数据主体可对再处理方执行本条、第 5(a) 至 (e) 和 (g)、第 6、第 7、第 8(2) 和第 9 至 12 条，除非任何继承实体通过合同或法律的实施承担了数据出口方的全部法律义务，并因此承担了数据出口方的权利和义务，在这种情况下，数据主体可以针对此类实体执行这些条款。 再处理方的此类第三方责任应限于其在本条款下的处理业务。 -4. The parties do not object to a data subject being represented by an association or other body if the data subject so expressly wishes and if permitted by national law. +4. 如果数据主体有明确的意愿并且国家法律允许，当事方不反对由协会或其他机构代表数据主体。 -#### Clause 4: Obligations of the data exporter -The data exporter agrees and warrants: +#### 第 4 条：数据出口方的义务 +数据出口方同意并保证： -(a) that the processing, including the transfer itself, of the personal data has been and will continue to be carried out in accordance with the relevant provisions of the applicable data protection law (and, where applicable, has been notified to the relevant authorities of the Member State where the data exporter is established) and does not violate the relevant provisions of that State; +(a) 个人数据的处理，包括数据转移过程，已经并将继续按照适用的数据保护法的相关规定进行（并且在适用的情况下通知数据出口方所在成员国的相关当局），并且不违反该国有关规定； -(b) that it has instructed and throughout the duration of the personal data processing services will instruct the data importer to process the personal data transferred only on the data exporter's behalf and in accordance with the applicable data protection law and the Clauses; +(b) 已指示并将在个人数据处理服务期间指示数据进口方，仅代表数据出口方并根据适用的数据保护法和本条款来处理所转移的个人数据； -(c) that the data importer will provide sufficient guarantees in respect of the technical and organisational security measures specified in Appendix 2 below; +(c) 数据进口方将为下文附录 2 中规定的技术和组织安全措施提供充分保证； -(d) that after assessment of the requirements of the applicable data protection law, the security measures are appropriate to protect personal data against accidental or unlawful destruction or accidental loss, alteration, unauthorised disclosure or access, in particular where the processing involves the transmission of data over a network, and against all other unlawful forms of processing, and that these measures ensure a level of security appropriate to the risks presented by the processing and the nature of the data to be protected having regard to the state of the art and the cost of their implementation; +(d) 在评估了适用数据保护法的要求后，安全措施适用于保护个人数据，使其免受意外或非法破坏或意外丢失、更改、未经授权的披露或访问，尤其是涉及网络数据传输的处理以及针对所有其他非法处理方式，并在考虑到最新技术和实施成本的情况下，确保这些措施能够提供与处理所带来的风险和要保护数据的性质相适应的安全水平； -(e) that it will ensure compliance with the security measures; +(e) 确保遵循安全措施； -(f) that, if the transfer involves special categories of data, the data subject has been informed or will be informed before, or as soon as possible after, the transfer that its data could be transmitted to a third country not providing adequate protection within the meaning of the General Data Protection Regulation (EU 2016/679); +(f) 如果数据转移涉及特殊类别的数据，则已经或将在转移之前或之后尽快告知数据主体，其数据可能被传输到《一般数据保护条例》 (EU 2016/679) 所指的无法提供充分保护的第三国； -(g) to forward any notification received from the data importer or any subprocessor pursuant to Clause 5(b) and Clause 8(3) to the data protection supervisory authority if the data exporter decides to continue the transfer or to lift the suspension; +(g) 如果数据出口方决定继续转移或取消中止，则根据第 5(b) 和第 8(3) 条，将从数据进口方或任何再处理方收到的任何通知转发给数据保护监管机构； -(h) to make available to the data subjects upon request a copy of the Clauses, with the exception of Appendix 2, and a summary description of the security measures, as well as a copy of any contract for subprocessing services which has to be made in accordance with the Clauses, unless the Clauses or the contract contain commercial information, in which case it may remove such commercial information; +(h) 应要求向数据主体提供条款副本（附录 2 除外）、安全措施概要说明，以及必须根据条款制定的任何再处理服务合同副本，除非条款或合同包含商业信息，在这种情况下，它可以删除这些商业信息； -(i) that, in the event of subprocessing, the processing activity is carried out in accordance with Clause 11 by a subprocessor providing at least the same level of protection for the personal data and the rights of data subject as the data importer under the Clauses; and +(i) 在再处理的情况下，处理活动由再处理方根据第 11 条执行，对个人数据和数据主体的权利提供至少与本条款下数据进口方相同的保护级别；以及 -(j) that it will ensure compliance with Clause 4(a) to (i). +(j) 确保遵守第 4(a) 至 (i) 条。 -#### Clause 5: Obligations of the data importer -The data importer agrees and warrants: +#### 第 5 条：数据进口方的义务 +数据进口方同意并保证： -(a) to process the personal data only on behalf of the data exporter and in compliance with its instructions and the Clauses; if it cannot provide such compliance for whatever reasons, it agrees to inform promptly the data exporter of its inability to comply, in which case the data exporter is entitled to suspend the transfer of data and/or terminate the contract; +(a) 只代表数据出口方并按照其指示和条款处理个人数据；如果出于任何原因无法提供此类遵循，则迅速将无法遵循的情况通知数据出口方， 在这种情况下，数据出口方有权中止数据转移和/或终止合同； -(b) that it has no reason to believe that the legislation applicable to it prevents it from fulfilling the instructions received from the data exporter and its obligations under the contract and that in the event of a change in this legislation which is likely to have a substantial adverse effect on the warranties and obligations provided by the Clauses, it will promptly notify the change to the data exporter as soon as it is aware, in which case the data exporter is entitled to suspend the transfer of data and/or terminate the contract; +(b) 没有理由认为适用于它的法律会阻止它履行从数据出口方那里收到的指示和它在合同下的义务，如果该立法发生变化，可能对条款规定的保证和义务产生重大不利影响，则在知情后立即通知数据出口方，在这种情况下，数据出口方有权中止数据转移和/或终止合同； -(c) that it has implemented the technical and organisational security measures specified in Appendix 2 before processing the personal data transferred; +(c) 在处理所转移的个人数据之前，已实施附录 2 中规定的技术和组织安全措施； -(d) that it will promptly notify the data exporter about: +(d) 将以下情况迅速通知数据出口方： -(i) any legally binding request for disclosure of the personal data by a law enforcement authority unless otherwise prohibited, such as a prohibition under criminal law to preserve the confidentiality of a law enforcement investigation, +(i) 执法机关提出披露个人数据等任何具有法律约束力的要求，除非另有禁止，例如刑法禁止通知以保护执法调查的机密性， -(ii) any accidental or unauthorised access, and +(ii) 任何意外或未经授权的访问，以及 -(iii) any request received directly from the data subjects without responding to that request, unless it has been otherwise authorised to do so; +(iii) 直接从数据主体收到的任何请求，但不会对该请求作出回应，除非另有授权； -(e) to deal promptly and properly with all inquiries from the data exporter relating to its processing of the personal data subject to the transfer and to abide by the advice of the supervisory authority with regard to the processing of the data transferred; +(e) 迅速妥善处理数据出口方就其处理所转移个人数据而提出的所有询问，并遵守监管机构关于处理所转移数据的建议； -(f) at the request of the data exporter to submit its data processing facilities for audit of the processing activities covered by the Clauses which shall be carried out by the data exporter or an inspection body composed of independent members and in possession of the required professional qualifications bound by a duty of confidentiality, selected by the data exporter, where applicable, in agreement with the supervisory authority; +(f) 应数据出口方的要求，提交其数据处理设施，以供审核本条款所涵盖的处理活动，此类审核应由数据出口方或由独立成员组成并拥有受保密义务约束的所需专业资格的检查机构进行，在适用的情况下，经监管机构同意，由数据出口方选择； -(g) to make available to the data subject upon request a copy of the Clauses, or any existing contract for subprocessing, unless the Clauses or contract contain commercial information, in which case it may remove such commercial information, with the exception of Appendix 2 which shall be replaced by a summary description of the security measures in those cases where the data subject is unable to obtain a copy from the data exporter; +(g) 应要求向数据主体提供条款副本或任何现有的再处理合同，除非条款或合同包含商业信息，在这种情况下，可以删除此类商业信息，但附录 2 除外，在数据主体无法从数据出口方获得副本的情况下应替换为安全措施概要说明； -(h) that, in the event of subprocessing, it has previously informed the data exporter and obtained its prior written consent; +(h) 在再处理的情况下，事先通知数据出口方并获得其事先书面同意； -(i) that the processing services by the subprocessor will be carried out in accordance with Clause 11; and +(i) 再处理方的处理服务将按照第 11 条的规定执行；以及 -(j) to send promptly a copy of any subprocessor agreement it concludes under the Clauses to the data exporter. +(j) 迅速将其根据本条款缔结的任何再处理方协议的副本发送给数据出口方。 -#### Clause 6: Liability -1. The parties agree that any data subject who has suffered damage as a result of any breach of the obligations referred to in Clause 3 or in Clause 11 by any party or subprocessor is entitled to receive compensation from the data exporter for the damage suffered. +#### 第 6 条：赔偿责任 +1. 双方同意，因任何一方或再处理方违反第 3 条或第 11 条所述义务而遭受损害的任何数据主体，有权就所遭受的损害向数据出口方索取赔偿。 -2. If a data subject is not able to bring a claim for compensation in accordance with paragraph 1 against the data exporter, arising out of a breach by the data importer or his subprocessor of any of their obligations referred to in Clause 3 or in Clause 11, because the data exporter has factually disappeared or ceased to exist in law or has become insolvent, the data importer agrees that the data subject may issue a claim against the data importer as if it were the data exporter, unless any successor entity has assumed the entire legal obligations of the data exporter by contract of by operation of law, in which case the data subject can enforce its rights against such entity. The data importer may not rely on a breach by a subprocessor of its obligations in order to avoid its own liabilities. +2. 如果由于数据进口方或其再处理方违反第 3 条或第 11 条所述的任何义务，数据主体无法根据第 1 款向数据出口方提出索赔，其原因是数据出口方事实上已消失或在法律上不复存在或已破产，数据进口方同意，数据主体可以像向数据出口方索赔一样向数据进口方提出索赔，除非任何继承实体通过合同或法律实施承担了数据出口方的全部法律义务，在这种情况下，数据主体可以针对此类实体履行其权利。 数据进口方不得以再处理方违反其义务为由而推卸自己的责任。 -3. If a data subject is not able to bring a claim against the data exporter or the data importer referred to in paragraphs 1 and 2, arising out of a breach by the subprocessor of any of their obligations referred to in Clause 3 or in Clause 11 because both the data exporter and the data importer have factually disappeared or ceased to exist in law or have become insolvent, the subprocessor agrees that the data subject may issue a claim against the data subprocessor with regard to its own processing operations under the Clauses as if it were the data exporter or the data importer, unless any successor entity has assumed the entire legal obligations of the data exporter or data importer by contract or by operation of law, in which case the data subject can enforce its rights against such entity. The liability of the subprocessor shall be limited to its own processing operations under the Clauses. +3. 如果由于再处理方违反第 3 条或第 11 条所述的任何义务，数据主体无法根据第 1 和第 2 款向数据出口方或数据进口方提出索赔，其原因是数据出口方和数据进口方均事实上已消失或在法律上不复存在或已破产，再处理方同意，数据主体可以像向数据出口方或数据进口方索赔一样，就再处理方在本条款下的处理业务向其提出索赔，除非任何继承实体通过合同或法律实施承担了数据出口方或数据进口方的全部法律义务，在这种情况下，数据主体可以针对此类实体履行其权利。 再处理方的赔偿责任应限于其在本条款下的处理业务。 -#### Clause 7: Mediation and jurisdiction -1. The data importer agrees that if the data subject invokes against it third-party beneficiary rights and/or claims compensation for damages under the Clauses, the data importer will accept the decision of the data subject: +#### 第 7 条：调解和管辖权 +1. 数据进口方同意，如果数据主体援引第三方受益权和/或根据条款要求赔偿损失，数据进口方将接受数据主体的以下决定： -(a) to refer the dispute to mediation, by an independent person or, where applicable, by the supervisory authority; +(a) 将争议交由独立人士调解，或在适用的情况下，由监管机构进行调解； -(b) to refer the dispute to the courts in the Member State in which the data exporter is established. +(b) 将争议提交给数据出口方所在成员国的法院处理。 -2. The parties agree that the choice made by the data subject will not prejudice its substantive or procedural rights to seek remedies in accordance with other provisions of national or international law. +2. 双方同意，数据主体的选择不影响其根据国内法或国际法的其他规定寻求补救的实质性或程序性权利。 -#### Clause 8: Cooperation with supervisory authorities -1. The data exporter agrees to deposit a copy of this contract with the supervisory authority if it so requests or if such deposit is required under the applicable data protection law. +#### 第 8 条：与监管机构的合作 +1. 数据出口方同意向监督机构交存本合同副本，如果监督机构或适用的数据保护法要求交存此类副本。 -2. The parties agree that the supervisory authority has the right to conduct an audit of the data importer, and of any subprocessor, which has the same scope and is subject to the same conditions as would apply to an audit of the data exporter under the applicable data protection law. +2. 双方同意，监管机构有权对数据进口方和任何再处理方进行审核，审计范围和条件与适用数据保护法对数据出口方规定的审核相同。 -3. The data importer shall promptly inform the data exporter about the existence of legislation applicable to it or any subprocessor preventing the conduct of an audit of the data importer, or any subprocessor, pursuant to paragraph 2. In such a case the data exporter shall be entitled to take the measures foreseen in Clause 5(b). +3. 如果存在阻止根据第 2 款对数据进口方或任何再处理方进行审核的适用立法，数据进口方应立即通知数据出口方。 在这种情况下，数据出口方应有权采取第 5(b) 条规定的措施。 -#### Clause 9: Governing Law. -The Clauses shall be governed by the law of the Member State in which the data exporter is established. +#### 第 9 条：管辖法律。 +本条款应受数据出口方所在成员国的法律管辖。 -#### Clause 10: Variation of the contract -The parties undertake not to vary or modify the Clauses. This does not preclude the parties from adding clauses on business related issues where required as long as they do not contradict the Clause. +#### 第 10 条：合同变更 +双方承诺不改变或修改条款。 但这并不妨碍双方在必要时添加有关业务问题的条款，前提是它们不与本条款相冲突。 -#### Clause 11: Subprocessing -1. The data importer shall not subcontract any of its processing operations performed on behalf of the data exporter under the Clauses without the prior written consent of the data exporter. Where the data importer subcontracts its obligations under the Clauses, with the consent of the data exporter, it shall do so only by way of a written agreement with the subprocessor which imposes the same obligations on the subprocessor as are imposed on the data importer under the Clauses. Where the subprocessor fails to fulfil its data protection obligations under such written agreement the data importer shall remain fully liable to the data exporter for the performance of the subprocessor's obligations under such agreement. +#### 第 11 条：再处理 +1. 未经数据出口方事先书面同意，数据进口方不得将其代表数据出口方执行的任何处理业务分包出去。 如果数据进口方在征得数据出口方同意的情况下，将其在本条款下的义务分包出去，则必须与再处理方签订书面协议，该协议对再处理方施加的义务应与本条款对数据进口方施加的义务相同。 如果再处理方未能履行该书面协议规定的数据保护义务，则数据进口方仍应对数据出口方负全部责任，以履行该协议下的再处理方义务。 -2. The prior written contract between the data importer and the subprocessor shall also provide for a third-party beneficiary clause as laid down in Clause 3 for cases where the data subject is not able to bring the claim for compensation referred to in paragraph 1 of Clause 6 against the data exporter or the data importer because they have factually disappeared or have ceased to exist in law or have become insolvent and no successor entity has assumed the entire legal obligations of the data exporter or data importer by contract or by operation of law. Such third-party liability of the subprocessor shall be limited to its own processing operations under the Clauses. +2. 数据进口方与再处理方之间的事先书面合同还应规定第 3 条中所述的第三方受益人条款，以防数据出口方或数据进口方事实上已消失或在法律上不复存在或已破产，而且没有任何继承实体通过合同或法律实施承担数据出口方或数据进口方的全部法律义务，导致数据主体无法向他们提出第 6 条第 1 款所述的索赔。 再处理方的此类第三方责任应限于其在本条款下的处理业务。 -3. The provisions relating to data protection aspects for subprocessing of the contract referred to in paragraph 1 shall be governed by the law of the Member State in which the data exporter is established. +3. 第 1 款所述再处理合同的数据保护方面的规定应受数据出口方所在成员国的法律管辖。 -4. The data exporter shall keep a list of subprocessing agreements concluded under the Clauses and notified by the data importer pursuant to Clause 5 (j), which shall be updated at least once a year. The list shall be available to the data exporter's data protection supervisory authority. +4. 数据出口方应保留根据本条款缔结并由数据进口方根据第 5(j) 条通知的再处理协议的清单，该清单应每年至少更新一次。 该清单应提供给数据出口方的数据保护监管机构。 -#### Clause 12: Obligation after the termination of personal data processing services -1. The parties agree that on the termination of the provision of data processing services, the data importer and the subprocessor shall, at the choice of the data exporter, return all the personal data transferred and the copies thereof to the data exporter or shall destroy all the personal data and certify to the data exporter that it has done so, unless legislation imposed upon the data importer prevents it from returning or destroying all or part of the personal data transferred. In that case, the data importer warrants that it will guarantee the confidentiality of the personal data transferred and will not actively process the personal data transferred anymore. +#### 第 12 条：个人数据处理服务终止后的义务 +1. 双方同意，在终止提供数据处理服务时，数据进口方和再处理方应根据数据出口方的选择，将传输的所有个人数据及其副本返还给数据出口方，或者销毁所有个人数据并向数据出口方提供相关证明，除非适用于数据进口方的法律阻止其返还或销毁所传输的全部或部分个人数据。 在这种情况下，数据进口方应保证将确保所传输个人数据的机密性，并且不再主动处理所传输的个人数据。 -2. The data importer and the subprocessor warrant that upon request of the data exporter and/or of the supervisory authority, it will submit its data processing facilities for an audit of the measures referred to in paragraph 1. +2. 数据进口方和再处理方保证，将应数据出口方和/或监管机构的要求，提交其数据处理设施以接受第 1 款所述的审核。 -### Appendix 1 to the Standard Contractual Clauses -Data exporter: Customer is the data exporter. +### 标准合同条款附录 1 +数据出口方：客户是数据出口方。 -**Data importer:** The data importer is GitHub, Inc., a global producer of software and services. +**数据进口方：**数据进口方是全球软件和服务生产商 GitHub, Inc.。 -**Data subjects:** Data subjects include the data exporter’s representatives and end-users including employees, contractors, collaborators, and customers of the data exporter. Data subjects may also include individuals attempting to communicate or transfer personal information to users of the services provided by data importer. GitHub acknowledges that, depending on Customer’s use of the Service, Customer may elect to include personal data from any of the following types of data subjects in the Customer Personal Data: +**数据主体：**数据主体是数据出口方的代表和最终用户，包括数据出口方的员工、承包商、协作者和客户。 数据主体还可能包括试图向数据进口方提供的服务的用户传达或传输个人信息的个人。 GitHub 承认，根据客户对服务的使用情况，客户可以选择在客户个人数据中包含来自以下任何类型数据主体的个人数据： -- Employees, contractors and temporary workers (current, former, prospective) of data exporter; -- Dependents of the above; -- Data exporter's collaborators/contact persons (natural persons) or employees, contractors or temporary workers of legal entity collaborators/contact persons (current, prospective, former); -- Users (e.g., customers, clients, patients, visitors, etc.) and other data subjects that are users of data exporter's services; -- Partners, stakeholders or individuals who actively collaborate, communicate or otherwise interact with employees of the data exporter and/or use communication tools such as apps and websites provided by the data exporter; -- Stakeholders or individuals who passively interact with data exporter (e.g., because they are the subject of an investigation, research or mentioned in documents or correspondence from or to the data exporter); or -- Professionals with professional privilege (e.g., doctors, lawyers, notaries, religious workers, etc.). +- 数据出口方的员工、承包商和临时工（现任、前任、未来）； +- 上述人员的家属； +- 数据出口方的协作者/联系人（自然人）或法律实体协作者/联系人的员工、承包商或临时工（现任、未来、前任）； +- 用户（例如，顾客、客户、患者、访客等）以及作为数据出口方服务用户的其他数据主体； +- 合作伙伴、利益相关者或与数据出口方的员工积极协作、交流或以其他方式互动的个人和/或使用数据出口方提供的应用程序和网站等沟通工具的个人； +- 被动地与数据出口方交互的利益相关者或个人（例如，因为他们是调查、研究的对象，或者是数据出口方的文件或通信中提到的对象）；或 +- 具有职业特权的专业人士（如医生、律师、公证人、宗教工作者等）。 -**Categories of data:** The personal data transferred that is included in e-mail, documents and other data in an electronic form in the context of the Service. GitHub acknowledges that, depending on Customer’s use of the Service, Customer may elect to include personal data from any of the following categories in the Customer Personal Data: -- Authentication data (for example, username, email, password); -- Contact information (for example, email); -- Unique identification numbers and signatures (IP addresses, unique identifier in tracking cookies or similar technology). -- Other unique identifying information. Data subjects may include more data such as real names, avatar images, and other personal information; +**数据类别：**在服务范围内，以电子形式包含在电子邮件、文档和其他数据中的所传输个人数据。 GitHub 承认，根据客户对服务的使用情况，客户可以选择在客户个人数据中包含来自以下任何类别的个人数据： +- 身份验证数据（例如，用户名、电子邮件、密码）； +- 联系信息（例如，电子邮件）; +- 唯一标识号和签名（IP 地址、跟踪 Cookie 或类似技术中的唯一标识符）。 +- 其他的唯一识别信息。 数据主体可能包含更多数据，例如真实姓名、头像图片和其他个人信息； -**Special categories of data (if appropriate):** The data importer does not intentionally collect or process any special categories of data in carrying out its services to the data exporter. +**特殊类别的数据（如适用）：**数据进口方在向数据出口方提供服务时不会有意收集或处理任何特殊类别的数据。 -However, because the data importer provides storage services and does not control the categories of data it stores, the data exporter may choose to transfer special categories of data. Consequently, the data exporter is solely responsible for ensuring that it complies with all obligations imposed by applicable laws and regulations relating to the collection and processing of any special categories of data, including obtaining the explicit consent of the data subject prior to processing sensitive personal data. +但是，由于数据进口方提供存储服务，并且不控制其存储的数据类别，因此数据出口方可以选择传输特殊类别的数据。 所以，数据出口方应全权负责确保其遵守适用法律和法规规定的与收集和处理任何特殊类别数据有关的所有义务，包括在处理敏感个人数据之前获得数据主体的明确同意。 -**Processing operations:** The personal data transferred will be subject to the following basic processing activities: GitHub uses personal data for the limited purposes set forth in the GitHub Privacy Statement, available at [https://docs.github.com/articles/github-privacy-statement](/articles/github-privacy-statement), and the “Data Processing” section of the DPA. Subcontractors: In accordance with the DPA, the data importer may hire other companies to provide limited services on data importer’s behalf, such as providing customer support. Any such subcontractors will be permitted to obtain Customer Personal Data only to deliver the services the data importer has retained them to provide, and they are prohibited from using Customer Personal Data for any other purpose. +**处理业务：**所传输的个人数据将受以下基本处理活动的约束：GitHub 将个人数据用于《GitHub 隐私声明》（见 [https://docs.github.com/articles/github-privacy-statement](/articles/github-privacy-statement)）和 DPA 的“数据处理”部分规定的有限目的。 分包商：根据 DPA，数据进口方可以雇佣其他公司代表他们提供有限的服务，例如提供客户支持。 任何此类分包商只能以提供数据进口商委托的服务为目的而获取客户个人数据，并且不得将客户个人数据用于任何其他目的。 -### Appendix 2 to the Standard Contractual Clauses -Description of the technical and organizational security measures implemented by the data importer in accordance with Clauses 4(d) and 5(c): +### 标准合同条款附录 2 +数据进口方根据第 4(d) 和 5(c) 条实施的技术和组织安全措施的说明： -**1. Personnel.** Data importer’s personnel will not process Customer Personal Data without authorization. Personnel are obligated to maintain the confidentiality of any Customer Personal Data and this obligation continues even after their engagement ends. +**1. 人员。**数据进口方的人员未经授权不得处理客户个人数据。 人员有义务对任何客户个人数据保密，即使在他们的工作结束后，这一义务仍将继续。 -**2. Data Privacy Contact.** The data privacy officer of the data importer can be reached at the following address: GitHub, Inc. Attn: Privacy 88 Colin P. Kelly Jr. Street San Francisco, CA 94107 USA +**2. 数据隐私联系人。**数据进口方的数据隐私专员的联系地址如下： GitHub, Inc. Attn: Privacy 88 Colin P. Kelly Jr. Street San Francisco, CA 94107 USA -**3. Technical and Organization Measures.** The data importer has implemented and will maintain appropriate technical and organizational measures, internal controls, and information security routines intended to protect Customer Personal Data, as defined in the GitHub Security Exhibit, against accidental loss, destruction, or alteration; unauthorized disclosure or access; or unlawful destruction as follows: The technical and organizational measures, internal controls, and information security routines set forth in the GitHub Security Exhibit are hereby incorporated into this Appendix 2 by this reference and are binding on the data importer as if they were set forth in this Appendix 2 in their entirety. Signature of GitHub, Inc. appears below. +**3. 技术和组织措施。**数据进口方已实施并将保持适当的技术和组织措施、内部控制和信息安全程序，以保护客户个人数据（如 GitHub 安全附件中所定义）免遭意外丢失、破坏或更改；未经授权的披露或访问；或非法破坏。GitHub 安全附件中规定的技术和组织措施、内部控制和信息安全程序在此通过此引用并入本附录 2 中，并且对数据进口方具有约束力，如同它们在本附录 2 中全部列出一样。 GitHub Inc. 的签名如下。 -Signing the Standard Contractual Clauses, Appendix 1 and Appendix 2 on behalf of the data importer +代表数据进口方签署标准合同条款、附录 1 和附录 2 -![Screen Shot 2020-07-20 at 2 20 29 PM](/assets/images/help/site-policy/docusign-signature.png) +![屏幕截图，2020-07-20，下午 2 20 29](/assets/images/help/site-policy/docusign-signature.png) -Lynn Hashimoto, Head of Product & Regulatory Legal +Lynn Hashimoto，产品与监管法律部主管 GitHub, Inc. -## SECURITY EXHIBIT +## 安全附件 ### 1. 信息安全计划。 #### 1.1 安全管理。 -Throughout the duration of the Agreement, GitHub will maintain and enforce a written information security program (**"Security Program"**) that aligns with industry recognized frameworks; includes security safeguards reasonably designed to protect the confidentiality, integrity, availability, and resilience of Customer Protected Data; is appropriate to the nature, size, and complexity of GitHub's business operations; and complies with the Applicable Data Protection Laws and other specific information security related laws and regulations that are applicable to the geographic regions in which GitHub does business. +在协议的整个期限内，GitHub 将维护并执行与行业公认框架一致的书面信息安全计划（“**安全计划**”）；包含采用合理设计的安全保护措施，保护客户受保护数据的机密性、完整性、可用性及弹性；适合 GitHub 业务运营的性质、规模和复杂性；遵守适用数据保护法律以及 GitHub 业务所在地适用的其他特定信息安全相关法律和法规。 a. 安全官。 GitHub 指定了资深员工负责监管和执行其安全计划，以及负责关于信息安全事务的治理和内部沟通。 @@ -368,22 +368,22 @@ c. GitHub 将保持标准的安全行业做法，包括但不限于： - 安全和隐私意识培训 -#### 1.2 Security Incident Management. -Throughout the duration of the Agreement, and where applicable, GitHub will provide a Security incident management program as follows: +#### 1.2 安全事件管理。 +在协议的整个期限内以及适用时，GitHub 将提供如下安全事件管理计划： a. 安全可用性和上报。 GitHub 将维护适当的全天候安全联系和上报流程，以确保客户和员工可以向 GitHub 安全团队提交问题。 -b. 事件响应。 If GitHub becomes aware of a breach of security leading to the accidental or unlawful destruction, loss, alteration, unauthorized disclosure of, or access to Customer Personal Data (each a **"Security Incident"**), GitHub will promptly and without undue delay (1) notify Customer of the Security Incident; (2) investigate the Security Incident and provide Customer with detailed information about the Security Incident; (3) take reasonable steps to mitigate the effects and to minimize any damage resulting from the Security Incident. +b. 事件响应。 如果 GitHub 知悉会导致客户个人数据意外或非法销毁、丢失、篡改、未授权披露或访问的安全违规（每个都是“**安全事件**”），GitHub 将及时 (1) 向客户通知安全事件；(2) 调查安全事件并向客户提供安全事件的详细信息；(3) 采取合理的措施减小影响，并尽可能减小安全事件造成的损害。 c. 通知。 安全事件通知将通过 GitHub 选择的方式提交给客户的一个或多个管理员。 客户独自负责确保客户的管理员监控并回应任何通知。 客户独自负责履行事件通知法律下适用于客户的义务，并且履行与任何安全事件相关的任何第三方通知义务。 d. 合理协助。 GitHub 将采取商业合理的努力协助客户履行其在适用法律或法规下的义务，以向相关的监管机构和数据主体通知该等安全事件。 -#### 1.3 Due Diligence over Subcontractors and Vendors. -GitHub will maintain appropriate due diligence when utilizing subcontractors and vendors. GitHub 将维护至少三年的供应商评估报告和任何评估工作。 +#### 1.3 对分包商和供应商的尽职调查。 +GitHub 在使用分包商和供应商时将保持适当的尽职调查。 GitHub 将维护至少三年的供应商评估报告和任何评估工作。 -#### 1.4 Data Center Physical Safeguards. -To the extent GitHub utilizes third party vendors to host production environments, GitHub will select vendors that comply with physical security controls outlined in industry standards and that issue an annual external audit report such as SOC 2 or ISO 27001 certification. 对电信区域、机箱或机架或者网络设备及其他“数据传输线路”或设备的访问的控制如下： +#### 1.4 数据中心物理保护。 +在 GitHub 使用第三方供应商托管生产环境的范围内，GitHub 将选择符合行业标准所述物理安全控制、并且发出年度外部审核报告（如 SOC 2 或 ISO 27001 认证）的供应商。 对电信区域、机箱或机架或者网络设备及其他“数据传输线路”或设备的访问的控制如下： a. 访问将由一个或多个入口的胸卡读取器控制； @@ -397,17 +397,17 @@ e. 所有读卡和视频系统都会连接到发电机或 UPS 备份系统。 ### 2. 信息申请和合规报告。 -#### 2.1 Requests for Information. -Upon Customer's written request and no more than once annually, GitHub will respond to one request for information to assess security and compliance risk-related information. 回应将在收到申请后三十天内以书面形式提供，任何申请需要澄清时待定。 +#### 2.1 信息申请。 +对客户每年不超过一次的书面申请，GitHub 将回应一次评估安全和合规风险相关信息的信息申请。 回应将在收到申请后三十天内以书面形式提供，任何申请需要澄清时待定。 -#### 2.2 Response Contents. -GitHub will include in its annual response relevant audit reports for production datacenter, IaaS, PaaS or private hosting providers, as deemed relevant by GitHub, in its sole discretion and based on data and services rendered. +#### 2.2 回应内容。 +GitHub 将根据提供的数据和服务自由裁量包含，在其年度回应中包含 GitHub 认为相关的生产数据中心、IaaS、PaaS 或私人托管提供商的相关审计报告。 -#### 2.3 GitHub Security Audit Report. -GitHub will execute external audits to produce a SOC1, type 2, audit report and a SOC2, type 2, audit report. GitHub 将在协议期限内继续每年至少执行一次审核并发布相应的报告。 +#### 2.3 GitHub 安全审计报告。 +GitHub 将执行外部审计以产生 SOC1、2 类审核报告和 SOC2、2 类审计报告。 GitHub 将在协议期限内继续每年至少执行一次审核并发布相应的报告。 ### 3. 配合监管审计。 -Should Customer realize a regulatory audit or an audit in response to a Supervisory Authority that requires participation from GitHub, GitHub will fully cooperate with related requests by providing access to relevant knowledgeable personnel, documentation, and application software. 客户对任何此类监管或主管机关审计具有以下责任： +如果客户意识到监管审计或因应主管机关的审计需要 GitHub 的参与，GitHub 将全力配合相关申请，提供对相关知情人员、文档和应用软件的访问权限。 客户对任何此类监管或主管机关审计具有以下责任： a. 客户必须确保使用独立第三方（意指监管者或监管者的代表），并且客户不能访问与其不相关的发现和数据。 diff --git a/translations/zh-CN/content/github/site-policy/github-enterprise-cloud-evaluation-agreement.md b/translations/zh-CN/content/github/site-policy/github-enterprise-cloud-evaluation-agreement.md index 5bb729151b39..7bf52a7d03ae 100644 --- a/translations/zh-CN/content/github/site-policy/github-enterprise-cloud-evaluation-agreement.md +++ b/translations/zh-CN/content/github/site-policy/github-enterprise-cloud-evaluation-agreement.md @@ -10,7 +10,7 @@ versions: ### 1. 公司服务条款 -客户必须在 GitHub.com 上拥有公司帐户才能获得评估权限。 Customer's evaluation of Enterprise Cloud will be governed by these terms and the Corporate Terms of Service (found at [https://docs.github.com/articles/github-corporate-terms-of-service](/articles/github-corporate-terms-of-service)) (together, the "**Evaluation Agreement**"). 但是，在客户升级为付费订阅 Enterprise Cloud 之前，与 [Enterprise Cloud 附录](https://help.github.com/articles/github-enterprise-cloud-addendum)相关的任何补充条款**均不**适用。  Any capitalized terms not defined in this Evaluation Agreement are defined in the Corporate Terms of Service. +客户必须在 GitHub.com 上拥有公司帐户才能获得评估权限。 客户对 Enterprise Cloud 的评估受这些条款和公司服务条款（见 [https://docs.github.com/articles/github-corporate-terms-of-service](/articles/github-corporate-terms-of-service)）（统称为“**评估协议**”）的约束。 但是，在客户升级为付费订阅 Enterprise Cloud 之前，与 [Enterprise Cloud 附录](https://help.github.com/articles/github-enterprise-cloud-addendum)相关的任何补充条款**均不**适用。本评估协议中未定义的任何大写术语采用公司服务条款中的定义。 ### 2. 期限与终止 diff --git a/translations/zh-CN/content/github/site-policy/github-enterprise-server-license-agreement.md b/translations/zh-CN/content/github/site-policy/github-enterprise-server-license-agreement.md index 2bc0f344fead..e815530bb1d5 100644 --- a/translations/zh-CN/content/github/site-policy/github-enterprise-server-license-agreement.md +++ b/translations/zh-CN/content/github/site-policy/github-enterprise-server-license-agreement.md @@ -88,21 +88,21 @@ versions: **8. 付款** -**8.1** *Fees.* Customer agrees to pay the Fees in full, up front without deduction or setoff of any kind, in U.S. Dollars. 客户必须在 GitHub 发票日期三十 (30) 天内支付费用。 本协议下应付的金额不可退款，第 13 和 14.1 条中规定的除外。 如果客户未及时支付任何费用，GitHub 有权寻求法律或公平裁决的任何行动，并且 (i) 以每月 1.0% 或法律允许的最高利率（取较小者）对逾期金额收取利息，并收取所有恢复费用，以及 (ii) 终止适用的订单或 SOW。 客户独自负责本协议造成或与之相关的所有税、费、关税和政府评估（基于 GitHub 净收入的税除外）。 +**8.1***费用。*客户同意以美元全额预付费用，没有任何形式的扣减或抵销。 Dollars. 客户必须在 GitHub 发票日期三十 (30) 天内支付费用。 本协议下应付的金额不可退款，第 13 和 14.1 条中规定的除外。 如果客户未及时支付任何费用，GitHub 有权寻求法律或公平裁决的任何行动，并且 (i) 以每月 1.0% 或法律允许的最高利率（取较小者）对逾期金额收取利息，并收取所有恢复费用，以及 (ii) 终止适用的订单或 SOW。 客户独自负责本协议造成或与之相关的所有税、费、关税和政府评估（基于 GitHub 净收入的税除外）。 **8.2** *购买额外的订阅许可。*客户通过 GitHub 的网站或其销售团队提交申请，可获得本协议下的额外订阅许可。 然后将生成新的订单，如果客户购买额外的订阅许可，则必须根据当时的适用价格，按比例支付适用订阅期的剩余时间。 在客户的订阅许可证再续订一个订阅期之后，除非订单另有规定，否则 GitHub 将以年为基础对所有订阅许可证开一次发票。 **8.3** *附加软件。*附加软件基于每个用户授予许可。 为免生疑问，除非订单中另有说明，否则在任何特定时间，客户拥有的附加软件订阅许可数量，必须与其在本协议下拥有的产品订阅许可数量相等。 例如，如果客户已持有 100 用户的产品订阅许可，想要购买“高级安全”订阅，则该客户必须购买 100 用户的高级安全订阅许可。 -**9. 交付。**GitHub 将在安全、有密码保护的网站提供许可密钥给客户下载。 All deliveries under this Section 9 will be electronic. 为避免疑问，客户负责安装任何软件，并承认 GitHub 在提供许可密钥后对软件没有进一步的交付义务。 当有更新时，GitHub 将放在同一网站上供下载。 客户必须在商业合理的基础上更新软件，但每年不少于一 (1) 次。 客户负责对其用户名和密码保密。 +**9. 交付。**GitHub 将在安全、有密码保护的网站提供许可密钥给客户下载。 本第 9 部分的所有交付都是电子形式。 为避免疑问，客户负责安装任何软件，并承认 GitHub 在提供许可密钥后对软件没有进一步的交付义务。 当有更新时，GitHub 将放在同一网站上供下载。 客户必须在商业合理的基础上更新软件，但每年不少于一 (1) 次。 客户负责对其用户名和密码保密。 **10. 验证。**在 GitHub 请求时，客户将及时向 GitHub 提供软件生成的报告，验证客户在根据本协议使用软件。 对于超出协议条款的任何其他使用，GitHub 将给客户开发票，从其第一次使用日期起生效。 -**11. Support.** +**11. 支持。** **11.1** *标准支持。 *GitHub 每天二十四 (24) 小时、每周五 (5) 天（不包括周末和美国全国性假日）对软件提供标准技术支持，不收取额外费用。 标准支持只通过 GitHub 以基于 web 的支持单提供，支持请求必须从 GitHub 支持团队可与之交互的用户发起。 GitHub 按订单或 SOW 规定的支持级别、费用和订阅期为软件提供高级支持（根据 [Enterprise Server 高级支持条款](/enterprise/admin/enterprise-support/about-github-premium-support-for-github-enterprise-server)）或专门的技术支持。 -**11.2** *Enhanced Support Offerings.* GitHub may provide enhanced Support offerings for the Software (including the Premium, Premium Plus, and Engineering Direct Support offerings) in accordance with the [Support terms](/enterprise/admin/enterprise-support/about-github-premium-support-for-github-enterprise), and at the Support level, Fees, and Subscription Term specified in an Order Form or SOW. +**11.2** *增强的支持服务。* GitHub 可能根据[支持条款](/enterprise/admin/enterprise-support/about-github-premium-support-for-github-enterprise)，按照订单或 SOW 中指定的支持级别、费用和订阅期为软件提供增强的支持服务（包括 Premium、Premium Plus 和工程直接支持服务）。 **11.3** *除外条款。* GitHub 将采取合理的努力更正客户告知的任何重大、可重现软件错误。 但 GitHub 在以下情况下不负责提供支持 (i) 有人（非 GitHub）修改软件；(ii) 客户以对软件或其性能产生不利影响的方式更改其操作系统或环境；(iii) 客户以本协议或文档授权以外的方式使用软件；或 (iv) 客户对软件存在疏忽或误用。 @@ -166,7 +166,7 @@ versions: **18.4** *政府用户。*产品和文档完全使用私人资金开发，被视为《联邦采购条例》12.212 和 27.405-3 以及《国防部联邦采购条例补充规定》227.7202-3 所述的“商业计算机软件”和“商业计算机软件文档”。 产品作为受限制的计算机软件和有限权利数据许可给美国政府最终用户。 没有技术数据或计算机软件是在本协议下开发的。 美国政府或其承包商对产品或文档的任何使用、披露、修改、分发或重制，需遵守本协议所述的限制。 禁止所有其他使用。 -**18.5** *Export.* The Products are subject to export and sanctions restrictions administered by the U.S. 产品受美国政府实施的出口和制裁限制以及某些外国政府的进口限制之约束，客户在使用产品时应遵守所有适用的进出口法律法规。 客户不得也不得允许任何第三方，从美国转移或出口或者允许出口或再出口产品的任何部分或任何直接派生品到以下目标：(i) 任何被禁运或恐怖主义支持的国家或地区（或其国民或居民）；(ii) 美国商务部实体名单或拒绝订购表中的任何人，根据美国外国资产控制办公室实施规则封锁的任何人，包括特别指定国民名单或受制裁国家“政府”实体中的任何人，或受其他适用的禁止或制裁人员名单约束的任何人；(iii) 被限制或禁止出口或再出口的任何国家或地区，或者美国政府或其任何机构要求出口或再出口时获取出口许可证或其他政府批准，但并未事先获得此类许可证或批准的国家/地区；或 (iv) 违反美国或外国机构或机关的任何进出口限制、制裁、法律或法规的其他实体或个人。 Commerce Department’s Entity List or Table of Denial Orders, anyone blocked pursuant to rules administered by the U.S. Office of Foreign Assets Control, including anyone on the List of Specially Designated Nationals or sanctioned country “Government” entities, or anyone subject to other applicable prohibited or sanctioned persons lists; (iii) to any country or territory to which such export or re-export is restricted or prohibited, or as to which the U.S. government or any agency thereof requires an export license or other governmental approval at the time of export or re-export without first obtaining such license or approval; or (iv) otherwise in violation of any export, sanctions, or import restrictions, laws or regulations of any United States or foreign agency or authority. 客户声明并保证，客户不是任何此类被禁国家的国民或居民或受其控制，也不在任何此类被禁方名单中。 GitHub Enterprise Server 是一种自托管的虚拟设备，可以在客户自己的数据中心或虚拟私有云中运行。 因此，GitHub Enterprise Server 可用于存储 ITAR 或其他受出口管制的信息。 但是，客户应负责确保其合规性。 客户承认并同意，未经美国政府事先许可，不得将产品用于设计或开发核能、化学或生物武器或导弹技术。 government. +**18.5** *出口。*产品受美国政府实施的出口和制裁限制 产品受美国政府实施的出口和制裁限制以及某些外国政府的进口限制之约束，客户在使用产品时应遵守所有适用的进出口法律法规。 客户不得也不得允许任何第三方，从美国转移或出口或者允许出口或再出口产品的任何部分或任何直接派生品到以下目标：(i) 任何被禁运或恐怖主义支持的国家或地区（或其国民或居民）；(ii) 美国商务部实体名单或拒绝订购表中的任何人，根据美国外国资产控制办公室实施规则封锁的任何人，包括特别指定国民名单或受制裁国家“政府”实体中的任何人，或受其他适用的禁止或制裁人员名单约束的任何人；(iii) 被限制或禁止出口或再出口的任何国家或地区，或者美国政府或其任何机构要求出口或再出口时获取出口许可证或其他政府批准，但并未事先获得此类许可证或批准的国家/地区；或 (iv) 违反美国或外国机构或机关的任何进出口限制、制裁、法律或法规的其他实体或个人。 商务部实体名单或拒绝订购表中的任何人，根据美国 外国资产控制办公室实施规则封锁的任何人，包括特别指定国民名单或受制裁国家“政府”实体中的任何人，或受其他适用的禁止或制裁人员名单约束的任何人；(iii) 被限制或禁止出口或再出口的任何国家或地区，或者美国 政府或其任何机构要求出口或再出口时获取出口许可证或其他政府批准，但并未事先获得此类许可证或批准的国家/地区；或 (iv) 违反美国或外国机构或机关的任何进出口限制、制裁、法律或法规的其他实体或个人。 客户声明并保证，客户不是任何此类被禁国家的国民或居民或受其控制，也不在任何此类被禁方名单中。 GitHub Enterprise Server 是一种自托管的虚拟设备，可以在客户自己的数据中心或虚拟私有云中运行。 因此，GitHub Enterprise Server 可用于存储 ITAR 或其他受出口管制的信息。 但是，客户应负责确保其合规性。 客户承认并同意，未经美国政府事先许可，不得将产品用于设计或开发核能、化学或生物武器或导弹技术。 政府。 **18.6** *未经许可不得公开。*GitHub 可将客户标识为现有客户和潜在客户。 但未经客户允许，GitHub 不得在任何广告或营销材料中使用客户的名称或徽标。 diff --git a/translations/zh-CN/content/github/site-policy/github-enterprise-service-level-agreement.md b/translations/zh-CN/content/github/site-policy/github-enterprise-service-level-agreement.md index 33b23a3d2496..9a5b8b10baca 100644 --- a/translations/zh-CN/content/github/site-policy/github-enterprise-service-level-agreement.md +++ b/translations/zh-CN/content/github/site-policy/github-enterprise-service-level-agreement.md @@ -1,5 +1,5 @@ --- -title: GitHub Enterprise Service Level Agreement +title: GitHub Enterprise 服务等级协议 redirect_from: - /github-enterprise-cloud-addendum/ - /github-business-cloud-addendum/ @@ -8,26 +8,24 @@ versions: free-pro-team: '*' --- -# GitHub Enterprise Service Level Agreement +**概述：**GitHub 保证 GitHub Enterprise Cloud 服务的季度正常运行时间达到 99.9%（“**服务等级**”或“**SLA**”）。 如果 GitHub 不符合 SLA，则客户将有权获得客户帐户的服务积分（“**服务积分**”）。 -**Short version:** GitHub guarantees a 99.9% quarterly uptime commitment for the GitHub Enterprise Cloud service (the “**Service Level**” or “**SLA**”). If GitHub does not meet the SLA, then Customer will be entitled to a service credit to Customer’s account (“**Service Credits**”). +有关每个服务功能（“**服务功能**”）的定义以及历史和当前正常运行时间的信息，请访问 [GitHub 状态页面](https://www.githubstatus.com/)。 本 SLA 中使用但未定义的大写术语采用客户适用协议中赋予的含义。 -For definitions of each Service feature (“**Service Feature**”) and to review historical and current Uptime, visit the [GitHub Status Page](https://www.githubstatus.com/). Capitalized terms used but not defined in this SLA have the meaning assigned in Customer’s applicable agreement. +## 正常运行时间保证 -## Uptime Guarantee +“**正常运行时间**”是在给定的日历季度内，服务可用总分钟数的百分比。 GitHub 承诺至少保持 99.9% 的服务正常运行时间。 每个服务功能的正常运行时间计算如下所述（“**正常运行时间计算**”）。 如果 GitHub 不符合 SLA，客户将有权根据以下计算（“**服务积分计算**”）获得服务积分。 请注意，停机时间不会同时或以同样的方式影响每个客户。 -“**Uptime**” is the percentage of total possible minutes the Service was available in a given calendar quarter. GitHub commits to maintain at least 99.9% Uptime for the Service. The Uptime calculation for each Service Feature is described below (“**Uptime Calculation**”). If GitHub does not meet the SLA, Customer will be entitled to Service Credits based on the calculation below (“**Service Credits Calculation**”). Note, Downtime does not affect every customer at the same time or in the same way. - -| **Service Feature** | **Uptime Calculation** | **定义** | **Service Credits Calculation** | -| --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | -| The **Service** includes the following Service Features:
    • 议题
    • 拉取请求
    • Git Operations
    • API Requests
    • Web 挂钩
    • 页面
    • 操作
    • Packages
    | (total minutes in a calendar quarter - Downtime) / total minutes in a calendar quarter | “**Downtime**” is a period of time where either (a) the error rate exceeds five percent (5%) in a given minute for any Service Feature or (b) the Service was unavailable as determined by a combination of GitHub's internal and external monitoring systems. | A Service Credits claim may be based on either (not both) of the following calculations:
    • 10% of the amount Customer paid for a Service Feature in a calendar quarter where the Uptime for that Service Feature was less than 99.9%, but greater than 99.0%.

      OR

    • 25% of the amount Customer paid for a Service Feature in a calendar quarter where the Uptime of that Service Feature was less than 99.0%.
    | | -| **操作** | (Total Triggered Executions – Unavailable Executions) / (Total Triggered Executions) x 100 | “**Total Triggered Executions**” is the total number of all Actions executions triggered by Customer in a calendar quarter.

    “**Unavailable Executions**” is the total number of executions within Total Triggered Executions which failed to run in a calendar quarter. An execution failed to run when the Actions history log did not capture any output five (5) minutes after the trigger was successfully fired. | Same as above | -| **Packages** | Transfers Uptime = same as Actions

    Storage Uptime = 100% - Average Error Rate*

    *The Uptime Calculation excludes public usage and storage transactions that do not count toward either Total Storage Transactions or Failed Storage Transactions (including pre-authentication failures; authentication failures; attempted transactions for storage accounts over their prescribed quotas). | “**Error Rate**” is the total number of Failed Storage Transactions divided by the Total Storage Transactions during a set time interval (currently set at one hour). If the Total Storage Transactions in a given one-hour interval is zero, the error rate for that interval is 0%.

    “**Average Error Rate**” is the sum of Error Rates for each hour in a calendar quarter divided by the total number of hours in a calendar quarter. | Same as above | +| **服务功能** | **正常运行时间计算** | **定义** | **服务积分计算** | +| ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- | +| **服务**包含以下服务功能：
    • 议题
    • 拉取请求
    • Git 操作
    • API 请求
    • Web 挂钩
    • 页面
    • 操作
    • 包
    | （日历季度的总分钟数 - 停机时间）/日历季度的总分钟数 | “**停机时间**”是指发生以下任一情况的时间段 (a) 在给定分钟内任何服务功能的错误率超过百分之五 (5%)；或 (b) 经 GitHub 的内部和外部监控系统组合确定，服务不可用。 | 服务积分索赔可能基于以下计算方法中的一种（而非两种）：
    • 10% of the amount Customer paid for a Service Feature in a calendar quarter where the Uptime for that Service Feature was less than or equal to 99.9%, but greater than 99.0%.

      或

    • 如果在一个日历季度内，服务功能的正常运行时间低于 99.0%，则结果为客户为该服务功能所支付金额的 25%。
    | | +| **操作** | （总触发执行数 - 不可用执行数）/（总触发执行数）x 100 | “**总触发执行数**”是客户在一个日历季度内触发的所有操作的执行总数。

    “**不可用执行数**”是指在一个日历季度内，总触发执行数中未能运行的执行总数。 在触发器被成功触发五 (5) 分钟后，如果操作历史记录日志未捕获任何输出，则执行失败。 | 同上 | +| **包** | 传输正常运行时间 = 同“操作”

    存储正常运行时间 = 100% - 平均错误率*

    *正常运行时间计算不包括不计入总存储事务或失败存储事务的公共使用和存储事务（包括预身份验证失败；身份验证失败；存储帐户的尝试事务超过其指定配额）。 | “**错误率**”是在设定的时间间隔（当前设置为一小时）内，失败的存储事务总数除以总存储事务数。 如果在给定的一小时间隔内总存储事务数为零，则该间隔的错误率为 0％。

    “**平均错误率**”是日历季度内每个小时的错误率之和除以日历季度的总小时数。 | 同上 | ## 排除 -Excluded from the Uptime Calculation are Service Feature failures resulting from (i) Customer’s acts, omissions, or misuse of the Service including violations of the Agreement; (ii) failure of Customer’s internet connectivity; (iii) factors outside GitHub's reasonable control, including force majeure events; or (iv) Customer’s equipment, services, or other technology. +正常运行时间计算不包括因以下原因导致的服务功能故障：(i) 客户的行为、疏忽或滥用服务，包括违反协议；(ii) 客户的网络连接故障；(iii) 超出 GitHub 合理控制范围的因素，包括不可抗力事件；或 (iv) 客户的设备、服务或其他技术。 -## Service Credits Redemption -If GitHub does not meet this SLA, Customer may redeem Service Credits only upon written request to GitHub within thirty (30) days of the end of the calendar quarter. Written requests for Service Credits redemption should be sent to [GitHub Support](https://support.github.com/contact). +## 服务积分兑换 +如果 GitHub 不符合此 SLA，则客户必须在该日历季度结束后的三十 (30) 天内向 GitHub 提出书面申请才能兑换服务积分。 服务积分兑换的书面申请应发送到 [GitHub 支持部门](https://support.github.com/contact)。 -Service Credits may take the form of a refund or credit to Customer’s account, cannot be exchanged into a cash amount, are limited to a maximum of ninety (90) days of paid service per calendar quarter, require Customer to have paid any outstanding invoices, and expire upon termination of Customer’s agreement with GitHub. Service Credits are the sole and exclusive remedy for any failure by GitHub to meet any obligations in this SLA. +服务积分可以采取退款或贷记给客户帐户的形式，不能兑换为现金，每个日历季度的上限为九十 (90) 天的付费服务，要求客户已支付任何未结发票， 并在客户与 GitHub 的协议终止后过期。 服务积分是针对 GitHub 未能履行此 SLA 中任何义务的唯一和排他性补救措施。 diff --git a/translations/zh-CN/content/github/site-policy/github-enterprise-subscription-agreement.md b/translations/zh-CN/content/github/site-policy/github-enterprise-subscription-agreement.md index 183bc75bde5e..051bc9437ad9 100644 --- a/translations/zh-CN/content/github/site-policy/github-enterprise-subscription-agreement.md +++ b/translations/zh-CN/content/github/site-policy/github-enterprise-subscription-agreement.md @@ -7,7 +7,7 @@ versions: free-pro-team: '*' --- -Version Effective Date: July 20, 2020 +版本生效日期：2020 年 7 月 20 日 只要单击“我同意”或类似按钮或者使用任何产品（定义如下），即表示客户接受本协议的条款和条件。 如果客户代表法人实体签订本协议，则客户表示其拥有确保该法人实体受本协议约束的法律权限。 @@ -29,13 +29,13 @@ Version Effective Date: July 20, 2020 * 第 3 部分：GitHub Enterprise Cloud 服务条款； -* EXHIBIT A: Definitions. +* 附件 A：定义。 如果客户从授权的 GitHub 经销商购买了任何产品，本协议的以下部分将替换为客户与 GitHub 经销商协作一致的条款：第 1.1 条（期限与终止）；1.2（付款）；第 2.3 条（交付）；以及第 2.4 条（验证）。 ## 第 1 部分：一般条款和条件 -第 1 部分规定适用于客户购买和使用任何产品的条款和条件。 Capitalized terms used but not defined in the body of this Agreement are defined in Exhibit A. +第 1 部分规定适用于客户购买和使用任何产品的条款和条件。 本协议正文中使用但未定义的术语在附件 A 中定义。 ### 1.1 期限与终止。 @@ -161,11 +161,11 @@ GitHub 将采取合理的努力更正客户向 GitHub 告知的软件中任何 #### 1.13.2 美国政府用户。 政府用户. -产品完全使用私人基金开发，被视为联邦联邦收购条例 12.212 和 27.405-3 以及国防联邦收购条例补充 227.7202-3 所述的“商业计算机软件”和“商业计算机软件文档”。 The Products are licensed to the U.S. 产品作为受限制的计算机软件和有限权利数据许可给美国政府最终用户。 没有技术数据或计算机软件是在本协议下开发的。 Any use, disclosure, modification, distribution, or reproduction of the Products or Documentation by the U.S. Government or its contractors is subject to the restrictions set forth in this Agreement. 禁止所有其他使用。 +产品完全使用私人基金开发，被视为联邦联邦收购条例 12.212 和 27.405-3 以及国防联邦收购条例补充 227.7202-3 所述的“商业计算机软件”和“商业计算机软件文档”。 产品许可给美国 产品作为受限制的计算机软件和有限权利数据许可给美国政府最终用户。 没有技术数据或计算机软件是在本协议下开发的。 美国政府或其承包商对产品或文档的任何使用、披露、修改、分发或重制， 需遵守本协议所述的限制。 禁止所有其他使用。 #### 1.13.3 出口。 -The Products are subject to export restrictions by the U.S.     产品受美国政府实施的出口和制裁限制以及某些外国政府的进口限制之约束，客户在使用产品时应遵守所有适用的进出口法律法规。 客户不得也不得允许任何第三方从美国转移或出口产品，或者允许出口或再出口产品的任何部分或任何直接派生品到：(i) 被禁运或恐怖主义支持的国家（或其任何国民或居民）；(ii) 美国商务部的拒绝订购表（Table of Denial Orders）或美国财政部的特别指定国民（Specially Designated Nationals）名单中的任何人；(iii) 被限制或禁止出口或再出口的任何国家/地区，或者美国政府或其任何机构要求出口或再出口时获取出口许可证或其他政府批准但未事先获得此类许可证或批准的国家/地区；或 (iv) 违反美国或外国机构或机关的任何进出口限制、法律或法规的其他实体或个人。 Commerce Department's Table of Denial Orders or U.S. Treasury Department's list of Specially Designated Nationals; (iii) to any country to which such export or re-export is restricted or prohibited, or as to which the U.S. government or any agency thereof requires an export license or other governmental approval at the time of export or re-export without first obtaining such license or approval; or (iv) otherwise in violation of any export or import restrictions, laws or regulations of any United States or foreign agency or authority. 客户表示并保证 (a) 客户不是任何此类被禁国家的国民或居民或受其控制，也不在任何此类被禁方名单中，以及 (b) 客户的任何数据都不在《美国国际军火贩运条例》的控制下。 International Traffic in Arms Regulations. 客户承认并同意，事先未获得美国政府的允许，产品不得用于设计或开发核能、化学或生物武器或导弹技术。 Government. +产品受美国政府实施的出口限制 产品受美国政府实施的出口和制裁限制以及某些外国政府的进口限制之约束，客户在使用产品时应遵守所有适用的进出口法律法规。 客户不得也不得允许任何第三方从美国转移或出口产品，或者允许出口或再出口产品的任何部分或任何直接派生品到：(i) 被禁运或恐怖主义支持的国家（或其任何国民或居民）；(ii) 美国商务部的拒绝订购表（Table of Denial Orders）或美国财政部的特别指定国民（Specially Designated Nationals）名单中的任何人；(iii) 被限制或禁止出口或再出口的任何国家/地区，或者美国政府或其任何机构要求出口或再出口时获取出口许可证或其他政府批准但未事先获得此类许可证或批准的国家/地区；或 (iv) 违反美国或外国机构或机关的任何进出口限制、法律或法规的其他实体或个人。 美国商务部的拒绝订购表（Table of Denial Orders）或美国 财政部的特别指定国民（Specially Designated Nationals）名单中的任何人；(iii) 被限制或禁止出口或再出口的任何国家/地区，或者美国 政府或其任何机构要求出口或再出口时获取出口许可证或其他政府批准但未事先获得此类许可证或批准的国家/地区；或 (iv) 违反美国或外国机构或机关的任何进出口限制、法律或法规的其他实体或个人。 客户表示并保证 (a) 客户不是任何此类被禁国家的国民或居民或受其控制，也不在任何此类被禁方名单中，以及 (b) 客户的任何数据都不在《美国国际军火贩运条例》的控制下。 《美国国际军火贩运条例》。 客户承认并同意，事先未获得美国政府的允许，产品不得用于设计或开发核能、化学或生物武器或导弹技术。 政府。 #### 1.13.4 未经许可不得公开。 @@ -259,7 +259,7 @@ GitHub 将在客户下载软件和许可密钥的安全网站上提供软件的 **(ii)** 用户登录名不能多人共享。 -**(iii)** Customer must not use the Service (a) in violation of export control or sanctions laws of the United States or any other applicable jurisdiction, (b) if it is located in or ordinarily resident in a country or territory subject to comprehensive sanctions administered by the U.S. Office of Foreign Assets Control (OFAC), or (c) if Customer is or is working on behalf of a [Specially Designated National (SDN)](https://www.treasury.gov/resource-center/sanctions/SDN-List/Pages/default.aspx) or a person subject to similar blocking or denied party prohibitions. 更多信息请参阅 [GitHub 的出口管制政策](/articles/github-and-export-controls)。 +**(iii)** 客户在以下情况下不得使用服务 (a) 违反美国或任何其他司法管辖区的出口管制或制裁法律；(b) 如果位于或普通居住于遭受美国 “外国资产管制办公室”(OFAC) 全面制裁的国家或地区；或 (c) 如果客户是[特别指定的国民 (SDN)](https://www.treasury.gov/resource-center/sanctions/SDN-List/Pages/default.aspx) 或代表其工作，或者是遭受类似封锁或被拒绝方禁令的个人。 更多信息请参阅 [GitHub 的出口管制政策](/articles/github-and-export-controls)。 #### 3.1.3 帐户安全。 @@ -271,7 +271,7 @@ GitHub 将在客户下载软件和许可密钥的安全网站上提供软件的 #### 3.1.5 U.S. 联邦政府条款。 5. 美国联邦政府条款. -If Customer is a U.S. federal government agency or otherwise accessing or using any portion of the Service in a government capacity, the [U.S. Federal Government Amendment](/articles/amendment-to-github-terms-of-service-applicable-to-us-federal-government-users) applies, and Customer agrees to its provisions. +如果客户是美国 联邦政府机构或者在政府部门访问或使用服务的任何部分，则[美国 联邦政府修正](/articles/amendment-to-github-terms-of-service-applicable-to-us-federal-government-users)适用，并且客户同意其条款。 ### 3.2 遵守法律；可接受的使用；隐私。 @@ -282,7 +282,7 @@ If Customer is a U.S. federal government agency or otherwise accessing or using 客户对服务的使用必须遵守 [GitHub 可接受的使用政策](/articles/github-acceptable-use-policies)和 [GitHub 社区指导方针](/articles/github-community-guidelines)。 客户不得在任何司法管辖区将服务用于非法、淫秽、冒犯性或欺诈性内容或活动，例如鼓吹或造成伤害；干扰或违反网络或系统的完整性或安全性；避开过滤器；发送主动、辱骂或欺诈性消息、病毒或有害代码；或者违反第三方权利。 #### 3.2.3 隐私。 -[The GitHub Privacy Statement](/articles/github-privacy-statement) and the [GitHub Data Protection Addendum](/github/site-policy/github-data-protection-addendum) provide detailed notice of GitHub's privacy and data use practices as well as GitHub's processing and security obligations with respect to Customer Personal Data. 任何个人、实体或服务从服务收集数据都必须遵守 [GitHub 隐私声明](/articles/github-privacy-statement)，特别是收集用户个人信息（定义见“GitHub 隐私声明”）时。 如果客户从 GitHub 收集任何用户个人信息，则客户仅将其用于外部用户已授权的目的。 客户将合理保护任何此类个人信息，并且客户会及时响应 GitHub 或外部用户的投诉、删除请求以及“不要联系”请求。 +[GitHub 隐私声明](/articles/github-privacy-statement)和 [GitHub 数据保护附录](/github/site-policy/github-data-protection-addendum)详细介绍了 GitHub 的隐私保护和数据使用实践，以及 GitHub 在处理和保护客户个人数据方面的义务。 任何个人、实体或服务从服务收集数据都必须遵守 [GitHub 隐私声明](/articles/github-privacy-statement)，特别是收集用户个人信息（定义见“GitHub 隐私声明”）时。 如果客户从 GitHub 收集任何用户个人信息，则客户仅将其用于外部用户已授权的目的。 客户将合理保护任何此类个人信息，并且客户会及时响应 GitHub 或外部用户的投诉、删除请求以及“不要联系”请求。 ### 3.3 内容责任；所有权；许可权利。 @@ -323,7 +323,7 @@ GitHub 只能在以下情况下访问客户的私有仓库 (i) 经客户同意 #### 3.4.4 除外条款。 如果 GitHub 有理由相信私有仓库的内容违反法律或本协议，则 GitHub 有权利访问、检查和删除该内容。 此外，法律可能要求 GitHub 披露客户私有仓库中的内容。 除非法律要求另有约束或者是回应安全威胁或其他安全风险，否则 GitHub 对此类操作需发出通知。 -### 3.5. Intellectual Property Notices. +### 3.5. 知识产权通告。 #### 3.5.1 GitHub 对内容的权利。 服务外观的版权归 © GitHub, Inc. 所有。 未经 GitHub 明确的书面许可，客户不得重复、复制或重复使用 HTML/CSS、Javascript 或者可视设计元素或概念的任何部分。 @@ -339,9 +339,9 @@ GitHub 只能在以下情况下访问客户的私有仓库 (i) 经客户同意 ### 3.6 暂停。 GitHub 有权利因违反本协议或为了保护服务的完整性、操作性和安全性而随时暂停服务的全部或部分，包括删除内容，在通知后立即生效，除非法律或法律程序禁止发出该等通知，或者妨碍预防对服务或任何第三方的迫切伤害。 GitHub 通常以横幅或者在此类暂停时或暂停之前发电子邮件的形式来提供通知。 GitHub 将根据需要自由裁量善意定制任何暂停，以保持服务的完整性、操作性和安全性。 -### 3.7 Service Level Agreement. +### 3.7 服务等级协议。 -GitHub’s quarterly uptime commitment for the Service is provided in the [Enterprise Service Level Agreement](/github/site-policy/github-enterprise-service-level-agreement). Customer will be entitled to a service credit if GitHub does not meet its service level. +GitHub 在[企业服务等级协议](/github/site-policy/github-enterprise-service-level-agreement)中提供了对服务的季度正常运行时间承诺。 如果 GitHub 不符合其服务等级，客户将有权获得服务积分。 ### 3.8 服务更改。 GitHub 通过更新和添加新功能来更改服务。 根据第 3.7 条，GitHub 保留随时临时或永久修改或中止服务（或其任何部分）的权利，可能通知或不通知。 @@ -350,7 +350,7 @@ GitHub 通过更新和添加新功能来更改服务。 根据第 3.7 条，GitH 某些服务功能可能受 [GitHub 附加产品条款](/github/site-policy/github-additional-product-terms)中规定的附加条款的约束。 客户访问或使用这些功能，即表示同意 GitHub 附加产品条款。 -## EXHIBIT A: DEFINITIONS +## 附件 A：定义 **“活跃用户”**是指在断电时尝试访问服务的用户。 diff --git a/translations/zh-CN/content/github/site-policy/github-gifts-and-entertainment-policy.md b/translations/zh-CN/content/github/site-policy/github-gifts-and-entertainment-policy.md index 04d2566f2428..184be10b011b 100644 --- a/translations/zh-CN/content/github/site-policy/github-gifts-and-entertainment-policy.md +++ b/translations/zh-CN/content/github/site-policy/github-gifts-and-entertainment-policy.md @@ -10,17 +10,17 @@ GitHub 确认，我们的业务建立在正当和透明的关系之上。 虽然 ### 公司政策 特此提醒，我们的道德准则规定： -> 不得为了帮助 GitHub 或 Microsoft 获取或保持业务或任何其他不正当优势，向任何人（包括身居权力或权限职位的任何人，例如政府官员或商业交易决策者）支付、提议支付、承诺支付、诱使、接受或授权支付现金或任何其他有价值的事物。 也不得索取或接受贿赂、回扣或任何其他不当现金付款。 ... [GitHub 员工] 对于以下交易必须保留准确和公允的记录：涉及代表 GitHub 支出任何费用的所有交易，例如保留收据并准确说明您的费用支出；或者涉及处置或转让 GitHub 资产的任何其他交易。 Such actions are required by the U.S. Foreign Corrupt Practices Act, the U.K. 《美国反海外腐败法》、2010 年《英国反贿赂法》以及 GitHub 开展业务所在其他司法管辖区的反贿赂法律均要求采取此类措施，这也是正确行事的原则。 +> 不得为了帮助 GitHub 或 Microsoft 获取或保持业务或任何其他不正当优势，向任何人（包括身居权力或权限职位的任何人，例如政府官员或商业交易决策者）支付、提议支付、承诺支付、诱使、接受或授权支付现金或任何其他有价值的事物。 也不得索取或接受贿赂、回扣或任何其他不当现金付款。 ... [GitHub 员工] 对于以下交易必须保留准确和公允的记录：涉及代表 GitHub 支出任何费用的所有交易，例如保留收据并准确说明您的费用支出；或者涉及处置或转让 GitHub 资产的任何其他交易。 《美国反海外腐败法》、 2010 年《英国反贿赂法》 《美国反海外腐败法》、2010 年《英国反贿赂法》以及 GitHub 开展业务所在其他司法管辖区的反贿赂法律均要求采取此类措施，这也是正确行事的原则。 GitHub 的道德准则详细说明了某些情况，包括礼品、旅游和招待；疏通费；慈善捐赠；职位；与代表合作；以及谁被视为政府官员。 我们的行为标准禁止： > 贿赂政府官员或其他个人以获取不正当优势，也不得收受任何人的贿赂。 -这意味着不仅不得向任何人（包括公务员、政府官员或身居权力或权限职位的任何人，以及不在这些特权职位的人）提供现金、任何形式的现金等价物或任何有价值的事物，以达到影响他们的目的，也不得向任何人收受这些贿赂以影响 GitHub。 Such activity is prohibited by the U.S. 《美国反海外腐败法》和《英国反贿赂法》均禁止此类活动，这两个法律均在全球范围内管辖 GitHub 的行为。 +这意味着不仅不得向任何人（包括公务员、政府官员或身居权力或权限职位的任何人，以及不在这些特权职位的人）提供现金、任何形式的现金等价物或任何有价值的事物，以达到影响他们的目的，也不得向任何人收受这些贿赂以影响 GitHub。 美国禁止此类活动。 《美国反海外腐败法》和《英国反贿赂法》均禁止此类活动，这两个法律均在全球范围内管辖 GitHub 的行为。 ### 可接受和不可接受礼物的示例 -那么，“有价值”是什么意思呢？ 请记住，对政府官员而言，任何礼物都是不可接受的（没错，可能送贴纸都不行）。 请务必先问清楚，他们的政策允许和禁止什么。 如果仍有疑问，请咨询法务部进行确认。 For example, many U.S. 例如，许多美国国会议员不会让您请他们吃饭。 +那么，“有价值”是什么意思呢？ 请记住，对政府官员而言，任何礼物都是不可接受的（没错，可能送贴纸都不行）。 请务必先问清楚，他们的政策允许和禁止什么。 如果仍有疑问，请咨询法务部进行确认。 例如，许多美国 例如，许多美国国会议员不会让您请他们吃饭。 至于其他客户或潜在客户，某些事情看似微不足道，但可能对其他人有很大价值。 例如，让您朋友的女儿被聘为实习生，对您来说可能不是什么大事，但对他们而言却具有巨大价值。 如果她不符合资格，但您通过幕后牵线促成此事，那就是违规操作。 此外，如果意图是产生不正当影响，则任何事物，无论价值多小，都可视为“有价值”。 @@ -60,4 +60,4 @@ GitHub 的道德准则详细说明了某些情况，包括礼品、旅游和招 罚款和入狱。 遭受处罚的不一定只有 GitHub。 您自己可能会面临几年牢狱之灾，这无关乎该客户在日本之旅后是否向 GitHub 提交了订单或者该政府官员是否拿走了那箱现金。 基本上，与您是否实际_完成_行贿没关系。 不论结果，只要尝试就是违法。 ### 更多信息 -For more information and context on rules, enforcement, and penalties, the U.S. 如需了解有关规则、执行和处罚的更多信息和相关背景，美国司法部的[《美国反海外腐败法》资源指南](https://www.justice.gov/sites/default/files/criminal-fraud/legacy/2015/01/16/guide.pdf)是一个很好的资源。 Foreign Corrupt Practices Act is an excellent resource. +如需了解有关规则、执行和处罚的更多信息和相关背景，美国 如需了解有关规则、执行和处罚的更多信息和相关背景，美国司法部的[《美国反海外腐败法》资源指南](https://www.justice.gov/sites/default/files/criminal-fraud/legacy/2015/01/16/guide.pdf)是一个很好的资源。 反海外腐败法是一种很好的资源。 diff --git a/translations/zh-CN/content/github/site-policy/github-gpl-cooperation-commitment.md b/translations/zh-CN/content/github/site-policy/github-gpl-cooperation-commitment.md index e4f9c5a5703b..ab8f5253a47e 100644 --- a/translations/zh-CN/content/github/site-policy/github-gpl-cooperation-commitment.md +++ b/translations/zh-CN/content/github/site-policy/github-gpl-cooperation-commitment.md @@ -1,5 +1,5 @@ --- -title: GitHub GPL Cooperation Commitment +title: GitHub GPL 合作承诺 redirect_from: - /articles/github-gpl-cooperation-commitment versions: diff --git a/translations/zh-CN/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md b/translations/zh-CN/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md index 56a072b05011..c079aa0894c1 100644 --- a/translations/zh-CN/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md +++ b/translations/zh-CN/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md @@ -1,6 +1,6 @@ --- -title: 组织的 GitHub Insights 和数据保护 -intro: '{% data variables.product.prodname_insights %} 会分析您的 {% data variables.product.prodname_ghe_server %} 数据。 这些数据可能包括贵组织中有权了解如何使用个人数据之人的个人数据。' +title: GitHub Insights and data protection for your organization +intro: '{% data variables.product.prodname_insights %} analyzes your {% data variables.product.prodname_ghe_server %} data. This data could include personal data of individuals in your organization who may have the right to understand how such personal data is being used.' product: '{% data reusables.gated-features.github-insights %}' redirect_from: - /github/installing-and-configuring-github-insights/github-insights-and-data-protection-for-your-organization @@ -9,38 +9,38 @@ versions: enterprise-server: '*' --- -有关 {% data variables.product.prodname_insights %} 管制条款的更多信息，请参阅您的 {% data variables.product.prodname_ghe_one %} 订阅协议。 +For more information about the terms that govern {% data variables.product.prodname_insights %}, see your {% data variables.product.prodname_ghe_one %} subscription agreement. -为了避免产生疑问，上述任何信息都不应被视为 {% data variables.product.prodname_dotcom %} 提供的法律建议。 您有责任对这里提供的信息进行法律分析，并遵守隐私和数据保护法律。 是否使用 {% data variables.product.prodname_insights %} 来处理您的员工和用户的数据，完全由您决定，如果您选择处理，则要自行负责按照适用的法律进行处理。 +For the avoidance of doubt, none of the foregoing information should be considered legal advice provided by {% data variables.product.prodname_dotcom %}. You are responsible for securing your own legal analysis of the information provided herein and for your compliance with privacy and data protection laws. It is up to you whether to use {% data variables.product.prodname_insights %} to process your employees’ and users’ data, and if you do so, you are solely responsible for conducting such processing in compliance with applicable law. -### 组织的角色和责任 +### The organization’s roles and responsibilities -使用 {% data variables.product.prodname_insights %} 时，您的组织是数据控制方，因为您的组织决定是否、如何以及为什么 {% data variables.product.prodname_insights %} 会处理任何个人的个人数据。 您的组织完全负责确保您在使用 {% data variables.product.prodname_insights %} 处理数据时遵守所有适用的法律。 +When using {% data variables.product.prodname_insights %}, your organization is the data controller because your organization determines whether, how, and why {% data variables.product.prodname_insights %} will process any individual’s personal data. Your organization is solely responsible for ensuring that you are complying with all applicable laws in processing data with {% data variables.product.prodname_insights %}. -### 数据隐私建议 +### Data privacy recommendations -在开始使用 {% data variables.product.prodname_insights %} 之前，您可以完全控制要包含哪些指标、报告、仓库和贡献者。 您通过 {% data variables.product.prodname_insights %} 处理的数据只能从您安装的 {% data variables.product.prodname_ghe_server %} 中拉取。 考虑平衡分析个人数据的风险与优点。 +You have full control over which metrics, reports, repositories, and contributors to include before beginning use of {% data variables.product.prodname_insights %}. The data you process with {% data variables.product.prodname_insights %} can only be pulled from your installation of {% data variables.product.prodname_ghe_server %}. Consider balancing the risks versus the benefits of analyzing personal data. -- **制定一个清晰的分析计划**：您必须清楚地了解您想要分析的内容和分析的原因，然后考虑 {% data variables.product.prodname_insights %} 如何帮助您找到这些答案。 +- **Develop a clear analysis plan**: You must understand clearly what you want to analyze and why, and then consider how {% data variables.product.prodname_insights %} may help you find those answers. -- **考虑数据保护影响评估**：如果您对 {% data variables.product.prodname_insights %} 的使用涉及处理个人数据，请考虑完成数据保护影响评估，或以其他方式完成对预期使用方式的正式法律分析。 +- **Consider a data protection impact assessment**: If your proposed use of {% data variables.product.prodname_insights %} involves processing personal data, consider completing a data protection impact assessment or otherwise completing formal legal analysis of your planned use. -### 决定要使用的数据 +### Decide what data to use -- **决定要包含的仓库**：在开始分析 {% data variables.product.prodname_insights %} 之前，请考虑要包含哪些仓库。 管理员可以在添加组织时包含仓库，并且可以随时启用和禁用仓库。 有关将组织添加到 {% data variables.product.prodname_insights %} 的更多信息，请参阅“[管理组织](/insights/installing-and-configuring-github-insights/managing-organizations)。 有关启用和禁用仓库的更多信息，请参阅“[管理仓库](/insights/installing-and-configuring-github-insights/managing-repositories)”。 +- **Decide which repositories to include**: Before you start an analysis in {% data variables.product.prodname_insights %}, consider which repositories to include. Administrators can include repositories when adding organizations and can enable and disable repositories at any time. For more information on adding organizations to {% data variables.product.prodname_insights %}, see "[Managing organizations](/insights/installing-and-configuring-github-insights/managing-organizations)." For more information on enabling and disabling repositories, see "[Managing repositories](/insights/installing-and-configuring-github-insights/managing-repositories)." -- **决定要包含的指标和报告**：管理员可以随时对所有用户启用和禁用指标和报告。 管理员控制用户可在您的 {% data variables.product.prodname_ghe_server %} 安装中访问的 {% data variables.product.prodname_insights %} 数据。 更多信息请参阅“[管理可用的指标和报告](/insights/installing-and-configuring-github-insights/managing-available-metrics-and-reports)”。 +- **Decide which metrics and reports to include**: Administrators can enable and disable metrics and reports available for all users at any time. Administrators control the {% data variables.product.prodname_insights %} data that users have access to in your installation of {% data variables.product.prodname_ghe_server %}. For more information, see "[Managing available metrics and reports](/insights/installing-and-configuring-github-insights/managing-available-metrics-and-reports)." -- **决定要包含的贡献者**：管理员可以禁止在指标和报告中处理特定贡献者的数据。 有关管理贡献者数据的更多信息，请参阅“[管理贡献者和团队](/insights/installing-and-configuring-github-insights/managing-contributors-and-teams)”。 +- **Decide which contributors to include**: Administrators can disable a specific contributor’s data from being processed in the metrics and reports. For more information on managing contributor data, see "[Managing contributors and teams](/insights/installing-and-configuring-github-insights/managing-contributors-and-teams)." -### 用户权限 +### User rights -根据各种数据保护条例，例如通用数据保护条例 (GDPR)， 用户可能有权要求被排除在处理、访问和更正之外，或要求删除其个人数据。 作为数据控制方，您的组织应该评估特定用户请求是否有效，并在适当时采取行动满足该请求。 +Under various data protection regulations, such as the General Data Protection Regulation (GDPR), users may have the right to request exclusion from processing, access, and correction, or to request deletion of their personal data. As the data controller, your organization should evaluate whether a particular user request is valid and, if appropriate, take action to fulfill the request. -- **排除处理**：用户可能有权将其个人数据排除在处理之外。 管理员可以删除贡献者的数据而不在 {% data variables.product.prodname_insights %} 中处理，由此产生的报告和指标也会相应地排除该贡献者的数据。 更多信息请参阅“[管理贡献者和团队](/insights/installing-and-configuring-github-insights/managing-contributors-and-teams)”。 +- **Exclusion of processing**: Users may have the right to have their personal data excluded from being processed. Administrators have the ability to remove a contributor’s data from being processed in {% data variables.product.prodname_insights %}, and the resulting reports and metrics will exclude the contributor’s data accordingly. For more information, see "[Managing contributors and teams](/insights/installing-and-configuring-github-insights/managing-contributors-and-teams)." -- **访问**：用户可能有权要求查看处理的个人数据。 每个指标和报告都详细说明了所处理的个人数据。 更多信息请参阅“[可用于 {% data variables.product.prodname_insights %} 的指标](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights)”。 原始数据通过 {% data variables.product.prodname_enterprise %} API 提供。 您的组织负责作出处理个人数据的任何决定以及执行此类任何请求。 +- **Access**: Users may have the right to demand to see what personal data is being processed. Each metric and report has a detailed description of what personal data is being processed. For more information, see "[Metrics available with {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights)." Raw data is available through the {% data variables.product.prodname_enterprise %} API. Your organization is responsible for any decisions to process personal data and for fulfilling any such requests. -- **更正和删除**：用户可能有权更正或删除他们的个人数据。 {% data variables.product.prodname_insights %} 中使用的数据来自您在 {% data variables.product.prodname_ghe_server %} 安装中添加或生成的现有数据。 在更正和删除时，应遵循您的组织的现有流程更正和删除来自 {% data variables.product.prodname_ghe_server %} 的数据。 +- **Correction and deletion**: Users may have the right to rectify or delete their personal data. The data used in {% data variables.product.prodname_insights %} is derived from the existing data you add to or generate from your {% data variables.product.prodname_ghe_server %} installation. Correction and deletion should follow your organization's existing process to correct and delete data from {% data variables.product.prodname_ghe_server %}. -- **处理的透明度**：每个指标和报告都详细描述了所处理的个人数据。 更多信息请参阅“[可用于 {% data variables.product.prodname_insights %} 的指标](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights)”。 +- **Transparency regarding processing**: Each metric and report has a detailed description of what personal data is being processed. For more information, see "[Metrics available with {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights)." diff --git a/translations/zh-CN/content/github/site-policy/github-marketplace-developer-agreement.md b/translations/zh-CN/content/github/site-policy/github-marketplace-developer-agreement.md index 95687167e8b8..4659faf96b38 100644 --- a/translations/zh-CN/content/github/site-policy/github-marketplace-developer-agreement.md +++ b/translations/zh-CN/content/github/site-policy/github-marketplace-developer-agreement.md @@ -8,7 +8,7 @@ versions: **参与 GITHUB 的 MARKETPLACE 计划必须遵守这些条款和条件（以下简称“协议”）。 注册参与 MARKETPLACE 计划或单击下面的“I ACCEPT（我接受）”，即表示您确认自己理解本协议，并接受其所有条款和条件。 如果您代表公司或其他法律实体签订本协议，则表示您拥有让该实体受本协议约束的法律权限，在这种情况下，“您”即表示您所代表的实体。** -Effective Date: July 21, 2020 +生效日期：2020 年 7 月 21 日。 ### 1. 定义 @@ -193,7 +193,7 @@ GitHub 可能：阻止该产品推介在 Marketplace 上展示；从 Marketplace ### 15. 通知 -本协议下 GitHub 提供给开发者的所有通知均以书面形式递送 (i) 由国家认可的隔夜递送服务（“快递公司”）递送，或通过美国邮件寄到开发者提供给 GitHub 的联系人邮寄地址；或 (ii) 通过电子邮件发送到开发者提供的电子邮件地址。 mail to the contact mailing address provided by Developer to GitHub; or (ii) electronic mail to the electronic mail address provided by Developer. 开发者必须以书面形式通知 GitHub，通知可通过快递公司或美国邮件递送到以下地址：GitHub, Inc., Attn: Legal Department, 88 Colin P. Kelly Jr. Street, San Francisco, CA 94107 USA。 Mail to the following address: GitHub, Inc., Attn: Legal Department, 88 Colin P. Kelly Jr. Street, San Francisco, CA 94107 USA. 所有通知若是通过电子邮件发送，则视为在邮件发出后立即送达；若是以其他方式递送，则视为在签收时送达，如果更早，则视为在邮件投递或上面允许的快递公司揽收二 (2) 个工作日后送达。 +本协议下 GitHub 提供给开发者的所有通知均以书面形式递送 (i) 由国家认可的隔夜递送服务（“快递公司”）递送，或通过美国邮件寄到开发者提供给 GitHub 的联系人邮寄地址；或 (ii) 通过电子邮件发送到开发者提供的电子邮件地址。 邮件寄到开发者提供给 GitHub 的联系人邮寄地址；或 (ii) 通过电子邮件发送到开发者提供的电子邮件地址。 开发者必须以书面形式通知 GitHub，通知可通过快递公司或美国邮件递送到以下地址：GitHub, Inc., Attn: Legal Department, 88 Colin P. Kelly Jr. Street, San Francisco, CA 94107 USA。 邮件递送到以下地址：GitHub, Inc., Attn: Legal Department, 88 Colin P. Kelly Jr. Street, San Francisco, CA 94107 USA。 所有通知若是通过电子邮件发送，则视为在邮件发出后立即送达；若是以其他方式递送，则视为在签收时送达，如果更早，则视为在邮件投递或上面允许的快递公司揽收二 (2) 个工作日后送达。 ### 16. 管辖法律 @@ -214,18 +214,18 @@ GitHub 可能：阻止该产品推介在 Marketplace 上展示；从 Marketplace **A1-2. 定义** -- a. “Applicable Data Protection Laws” means any laws, regulations, regulatory frameworks, or other legislations relating to the processing and use of Personal Information, as applicable to the Agreement, including: - - The EU General Data Protection Regulation 2016/679 (“GDPR”), along with any implementing or corresponding equivalent national laws or regulations; - - 《2018 年加州消费者隐私法案》，加利福尼亚州 民事 法典第 1798.100 及其后各段 ("CCPA"); and +- a. “适用数据保护法律”是指与处理及使用个人信息相关、适用于协议的法律、法规、监管框架或其他立法，包括： + - 《欧盟通用数据保护条例 2016/679》("GDPR")，以及任何实施中或相应的等效国家法律或法规； + - 《2018 年加州消费者隐私法案》，加利福尼亚州 民事 法典第 1798.100 及其后各段 ("CCPA")；以及 - 《 2018 年英国数据保护法》及其中包含的 GDPR 实施条例。 -- b. “Personal Information” means any information which relates to an individual GitHub End User, customer or employee which could, alone or together with other information, personally identify him or her, whether supplied by GitHub for processing by the Developer or whether generated by the Developer in the course of performing its obligations under this Agreement. +- b. “个人信息”是指与单个 GitHub 最终用户、客户或员工有关的任何信息，这些信息可以单独或结合其他信息来识别其身份，可能是 GitHub 提供给开发者进行处理的信息，也可能是开发者在履行其本协议义务的过程中生成的信息。 - c. “处理”是指以手动或自动方式对 GitHub 保护数据执行的任何操作或一组操作，包括收集、记录、组织、存储、改编、更改、检索、查阅、使用、通过传输、传播或其他方式披露、阻止、删除或销毁。 - d. “受保护数据”是指 GitHub 转移给开发者的有关 GitHub 最终用户的任何机密信息，包括个人信息、元数据、使用数据或与 GitHub 最终用户相关的其他数据或信息。 -**A1-3. Compliance with Data Transfer Laws** +**A1-3. 遵守数据传输法** -- a. GitHub 合规声明。 GitHub complies with Applicable Data Protection Laws. GitHub relies on Standard Contractual Clauses ("SCCs") for all transfers out of the European Union, European Economic Area, United Kingdom, and Switzerland to provide its services. 此外，GitHub 还通过了欧盟-美国 和瑞士-美国认证。 Privacy Shield Frameworks and the commitments they entail, although GitHub does not rely on the EU-U.S. Privacy Shield Framework as a legal basis for transfers of Personal Information in light of the judgment of the Court of Justice of the EU in Case C-311/18. GitHub 只出于数据收集时指定的有限目的向开发者转移个人信息。 -- b. 开发者合规声明。 Developer represents and warrants that it will (i) comply with Applicable Data Protection Laws; and (ii) abide by the requirements of European Economic Area and Swiss data protection law regarding the collection, use, transfer, retention, and other processing of Personal Information from the European Economic Area, United Kingdom, and Switzerland. All transfers of Personal Information to a third country or an international organization will be subject to appropriate safeguards as described in Article 46 of the GDPR and such transfers and safeguards will be documented according to Article 30(2) of the GDPR. +- a. GitHub 合规声明。 GitHub 遵守适用的数据保护法。 GitHub 根据标准合同条款 ("SCCs") 为从欧盟、欧洲经济区、英国和瑞士的所有数据传出提供服务。 此外，GitHub 还通过了欧盟-美国 和瑞士-美国认证。 隐私盾框架及其包含的承诺，尽管 GitHub 并不依赖欧盟-美国 隐私盾框架作为个人信息转移的法律依据（根据欧盟法院在 C-311/18 案中的判决）。 GitHub 只出于数据收集时指定的有限目的向开发者转移个人信息。 +- b. 开发者合规声明。 开发者声明并保证，他们将 (i) 遵守适用的数据保护法；以及 (ii) 遵守欧洲经济区和瑞士数据保护法有关收集、使用、传输、保留和其他方式处理来自欧洲经济区、英国和瑞士的个人信息的要求。 所有向第三国或国际组织传输个人信息的行为都将受到 GDPR 第 46 条所述的适当保护措施的约束，并且此类传输和保护措施将根据 GDPR 第 30(2) 条的规定进行记录。 **A1-4. 数据保护** @@ -236,7 +236,7 @@ GitHub 可能：阻止该产品推介在 Marketplace 上展示；从 Marketplace - c. 数据质量和相称性。 开发者必须保持受保护数据的准确性和最新性。 - d. 安全. 开发者必须采取所有合理的安全措施，防范在处理受保护数据时面临的风险，例如意外或非法破坏、意外丢失、篡改、未经授权的披露或访问等风险。 - e. 数据保留和删除。 除非法律禁止，否则开发者必须应 GitHub 的合理要求，退回或销毁存储在所有位置的不再需要用于收集时指定的有限目的的所有个人信息和相关数据。 开发者必须具备或制定信息销毁流程，以满足 GitHub 在协议第 3.8 节中提出的安全要求。 -- f. 再处理和向外传输。 开发者向子处理商传输受保护的数据时，应自行负责。 In the event that Developer must transfer the Protected Data to a third party, or Developer installs, uses, or enables third party services to process the Protected Data on Developer’s behalf, Developer must ensure that the third party will provide at least the same level of privacy protection as is required herein. +- f. 再处理和向外传输。 开发者向子处理商传输受保护的数据时，应自行负责。 如果开发者必须将受保护的数据传输给第三方，或者开发者自行安装、使用或启用第三方服务来处理受保护的数据，则开发者必须确保该第三方采用至少满足本文要求的隐私保护级别。 **A1-5. 受保护数据的使用** diff --git a/translations/zh-CN/content/github/site-policy/github-marketplace-terms-of-service.md b/translations/zh-CN/content/github/site-policy/github-marketplace-terms-of-service.md index 763d53dd6b6e..93847efbee7f 100644 --- a/translations/zh-CN/content/github/site-policy/github-marketplace-terms-of-service.md +++ b/translations/zh-CN/content/github/site-policy/github-marketplace-terms-of-service.md @@ -78,7 +78,7 @@ GitHub.com 会不时检查远程服务器（由 GitHub 或第三方托管）上 ### I. 免责声明；责任限制；免赔与保障赔偿 -**免责声明。** 您使用 Marketplace 和通过 Marketplace 获取的任何开发者产品均应自担风险。 Other than as expressly stated, GitHub provides Marketplace and Developer Products “AS IS” and “AS AVAILABLE.” 对于 Marketplace 和开发者产品，GitHub 不作任何明示或暗示的保证或承诺，包括但不限于通过 Marketplace 和开发者产品获取的特定功能、其可靠性、可用性或满足您需求的能力。 +**免责声明。** 您使用 Marketplace 和通过 Marketplace 获取的任何开发者产品均应自担风险。 除明确声明外，GitHub 将“按原样”和“视情况”提供 Marketplace 和开发者产品。 对于 Marketplace 和开发者产品，GitHub 不作任何明示或暗示的保证或承诺，包括但不限于通过 Marketplace 和开发者产品获取的特定功能、其可靠性、可用性或满足您需求的能力。 我们保留随时和不时修改或停用（临时或永久）Marketplace 或其任何部分的权利，可能通知，也可能不通知。 diff --git a/translations/zh-CN/content/github/site-policy/github-pre-release-program.md b/translations/zh-CN/content/github/site-policy/github-pre-release-program.md index ad5112dadfa9..24541ebdae60 100644 --- a/translations/zh-CN/content/github/site-policy/github-pre-release-program.md +++ b/translations/zh-CN/content/github/site-policy/github-pre-release-program.md @@ -48,7 +48,7 @@ versions: ### 7. 出口管制 - 您不得出口或再出口我们的任何机密信息，除非美国法律和获取机密信息所在司法管辖区的法律明确授权。 In particular, you aren’t allowed to export or re-export our Confidential Information into any U.S. embargoed countries, to anyone on the U.S. Treasury Department's list of Specially Designated Nationals, or to anyone on the U.S. Department of Commerce Denied Person's List or Entity List. 参与预发布计划或接收我们的任何机密信息，即表示您声明并保证您不在任何此类国家/地区或任何此类名单中。 + 您不得出口或再出口我们的任何机密信息，除非美国法律和获取机密信息所在司法管辖区的法律明确授权。 特别要注意，您不得将我们的机密信息出口或再出口到任何美国 禁运国家/地区、美国 财政部特别指定国民名单上的任何人或美国 商务部拒绝人员名单或实体名单上的任何人。 参与预发布计划或接收我们的任何机密信息，即表示您声明并保证您不在任何此类国家/地区或任何此类名单中。 ### 8. 专有权利 @@ -56,7 +56,7 @@ versions: ### 9. 政府用户 - 如果您是政府实体，本节将适用于您。 我们的某些机密信息可能被视为“商业项目”，该术语的定义见 48 C.F.R. §2.101，由“商用计算机软件”和“商用计算机软件文档”组成，这些术语的定义见 48 C.F.R. §12.212 或 48 C.F.R. §227.7202（如适用）。 §2.101, consisting of “Commercial Computer Software” and “Commercial Computer Software Documentation”, as such terms are used in 48 C.F.R. §12.212 or 48 C.F.R. §227.7202, as applicable. Consistent with 48 C.F.R. §12.212 or 48 C.F.R. 根据 48 C.F.R. §12.212 或 48 C.F.R. §227.7202-1 至 227.7202-4（如适用），商用计算机软件和商用计算机软件文档许可给美国政府最终用户 (a) 仅作为商业项目，以及 (b) 仅具有根据本文的条款和条件授予所有其他最终用户的那些权利。 Government end users (a) only as Commercial Items and (b) with only those rights as are granted to all other end users pursuant to the terms and conditions herein. GitHub, Inc. 88 Colin P. Kelly Street, San Francisco, CA 94107。 + 如果您是政府实体，本节将适用于您。 我们的某些机密信息可能被视为“商业项目”，该术语的定义见 48 C.F.R. §2.101，由“商用计算机软件”和“商用计算机软件文档”组成，这些术语的定义见 48 C.F.R. §12.212 或 48 C.F.R. §227.7202（如适用）。 §2.101，由“商用计算机软件”和“商用计算机软件文档”组成，这些术语的定义见 48 C.F.R. §12.212 或 48 C.F.R. §227.7202（如适用）。 根据 48 C.F.R. §12.212 或 48 C.F.R. 根据 48 C.F.R. §12.212 或 48 C.F.R. §227.7202-1 至 227.7202-4（如适用），商用计算机软件和商用计算机软件文档许可给美国政府最终用户 (a) 仅作为商业项目，以及 (b) 仅具有根据本文的条款和条件授予所有其他最终用户的那些权利。 政府最终用户 (a) 仅作为商业项目，以及 (b) 仅具有根据本文的条款和条件授予所有其他最终用户的那些权利。 GitHub, Inc. 88 Colin P. Kelly Street, San Francisco, CA 94107。 ### 10. 自主发展 diff --git a/translations/zh-CN/content/github/site-policy/github-privacy-statement.md b/translations/zh-CN/content/github/site-policy/github-privacy-statement.md index 5177633ad705..8ea0de82a7d0 100644 --- a/translations/zh-CN/content/github/site-policy/github-privacy-statement.md +++ b/translations/zh-CN/content/github/site-policy/github-privacy-statement.md @@ -20,30 +20,30 @@ Effective date: July 22, 2020 ### 精简版 -We use your personal information as this Privacy Statement describes. No matter where you are, where you live, or what your citizenship is, we provide the same high standard of privacy protection to all our users around the world, regardless of their country of origin or location. +我们按照本隐私声明所述来使用您的个人信息。 无论您身在何方、居于何处、是何国籍，我们为世界各地的所有用户提供同样的高标准隐私保护，不论其原籍国或所在地。 当然，下面的精简版和摘要无法面面俱到，因此请继续往下阅读以了解详情。 ### 摘要 -| 节 | 说明 | -| ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| [GitHub 收集哪些信息](#what-information-github-collects) | GitHub 直接从您的注册、付款、交易和用户个人资料中收集信息。 我们还自动从您的使用信息、cookie 和类似技术以及设备信息中收集，但在必要时会征得您的同意。 GitHub 可能还会从第三方收集用户个人信息。 我们只收集极少量的必要个人信息，除非您自己选择提供更多信息。 | -| [GitHub_不_收集哪些信息](#what-information-github-does-not-collect) | 我们不会有意收集 13 岁以下儿童的信息，也不会收集[敏感个人信息](https://gdpr-info.eu/art-9-gdpr/)。 | -| [GitHub 如何使用您的信息](#how-github-uses-your-information) | In this section, we describe the ways in which we use your information, including to provide you the Service, to communicate with you, for security and compliance purposes, and to improve our Service. 我们还介绍了在法律要求的情况下处理个人信息的法律依据。 | -| [我们如何分享所收集的信息](#how-we-share-the-information-we-collect) | 在以下情况下，我们可能会与第三方分享您的信息：经您同意、与我们的服务提供商分享、出于安全目的、为履行我们的法律义务，或者公司实体或业务单位的控制权发生变更或出售。 我们不会出售您的个人信息，也不会在 GitHub 上发布广告。 您可以查看可访问您信息的服务提供商列表。 | -| [其他重要信息](#other-important-information) | 我们针对 GitHub 上的仓库内容、公共信息和组织而提供的附加说明。 | -| [其他服务](#additional-services) | 我们提供有关其他服务产品的信息，包括第三方应用程序、GitHub Pages 和 GitHub 应用程序。 | -| [您如何访问和控制我们收集的信息](#how-you-can-access-and-control-the-information-we-collect) | 我们为您提供访问、更改或删除个人信息的途径。 | -| [我们使用 cookie 和跟踪技术](#our-use-of-cookies-and-tracking) | 我们使用 cookie 支持网站的整体功能，并在网站的某些部分使用少量的跟踪和分析服务。 我们提供了一个非常透明地说明此技术的网页。 请参阅本节了解更多信息。 | -| [GitHub 如何保护您的信息](#how-github-secures-your-information) | 我们采取所有合理必要的措施，保护 GitHub 上个人信息的机密性、完整性和可用性，并保护我们服务器的弹性。 | -| [GitHub 的全球隐私实践](#githubs-global-privacy-practices) | We provide the same high standard of privacy protection to all our users around the world. | -| [我们如何与您交流](#how-we-communicate-with-you) | 我们通过电子邮件与您通信。 您可以在帐户设置中或通过联系我们来控制我们与您联系的方式。 | -| [解决投诉](#resolving-complaints) | In the unlikely event that we are unable to resolve a privacy concern quickly and thoroughly, we provide a path of dispute resolution. | -| [隐私声明的变更](#changes-to-our-privacy-statement) | 如果本隐私声明发生重大变更，我们会在任何此类变更生效之前 30 天通知您。 您也可以在我们的站点政策仓库中跟踪变更。 | -| [许可](#license) | 本隐私声明的许可采用[知识共享零许可](https://creativecommons.org/publicdomain/zero/1.0/)原则。 | -| [联系 GitHub](#contacting-github) | 如果您对我们的隐私声明有疑问，请随时联系我们。 | -| [翻译](#translations) | 我们提供本隐私声明的一些翻译版本的链接。 | +| 节 | 说明 | +| ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | +| [GitHub 收集哪些信息](#what-information-github-collects) | GitHub 直接从您的注册、付款、交易和用户个人资料中收集信息。 我们还自动从您的使用信息、cookie 和类似技术以及设备信息中收集，但在必要时会征得您的同意。 GitHub 可能还会从第三方收集用户个人信息。 我们只收集极少量的必要个人信息，除非您自己选择提供更多信息。 | +| [GitHub_不_收集哪些信息](#what-information-github-does-not-collect) | 我们不会有意收集 13 岁以下儿童的信息，也不会收集[敏感个人信息](https://gdpr-info.eu/art-9-gdpr/)。 | +| [GitHub 如何使用您的信息](#how-github-uses-your-information) | 本节介绍我们使用个人信息的方式，包括为您提供服务、与您沟通、出于安全和合规目的以及改善我们的服务。 我们还介绍了在法律要求的情况下处理个人信息的法律依据。 | +| [我们如何分享所收集的信息](#how-we-share-the-information-we-collect) | 在以下情况下，我们可能会与第三方分享您的信息：经您同意、与我们的服务提供商分享、出于安全目的、为履行我们的法律义务，或者公司实体或业务单位的控制权发生变更或出售。 我们不会出售您的个人信息，也不会在 GitHub 上发布广告。 您可以查看可访问您信息的服务提供商列表。 | +| [其他重要信息](#other-important-information) | 我们针对 GitHub 上的仓库内容、公共信息和组织而提供的附加说明。 | +| [其他服务](#additional-services) | 我们提供有关其他服务产品的信息，包括第三方应用程序、GitHub Pages 和 GitHub 应用程序。 | +| [您如何访问和控制我们收集的信息](#how-you-can-access-and-control-the-information-we-collect) | 我们为您提供访问、更改或删除个人信息的途径。 | +| [我们使用 cookie 和跟踪技术](#our-use-of-cookies-and-tracking) | 我们使用 cookie 支持网站的整体功能，并在网站的某些部分使用少量的跟踪和分析服务。 我们提供了一个非常透明地说明此技术的网页。 请参阅本节了解更多信息。 | +| [GitHub 如何保护您的信息](#how-github-secures-your-information) | 我们采取所有合理必要的措施，保护 GitHub 上个人信息的机密性、完整性和可用性，并保护我们服务器的弹性。 | +| [GitHub 的全球隐私实践](#githubs-global-privacy-practices) | 我们为世界各地的所有用户提供同样的高标准隐私保护。 | +| [我们如何与您交流](#how-we-communicate-with-you) | 我们通过电子邮件与您通信。 您可以在帐户设置中或通过联系我们来控制我们与您联系的方式。 | +| [解决投诉](#resolving-complaints) | 万一我们无法快速彻底地解决隐私问题，我们提供一条解决争议的途径。 | +| [隐私声明的变更](#changes-to-our-privacy-statement) | 如果本隐私声明发生重大变更，我们会在任何此类变更生效之前 30 天通知您。 您也可以在我们的站点政策仓库中跟踪变更。 | +| [许可](#license) | 本隐私声明的许可采用[知识共享零许可](https://creativecommons.org/publicdomain/zero/1.0/)原则。 | +| [联系 GitHub](#contacting-github) | 如果您对我们的隐私声明有疑问，请随时联系我们。 | +| [翻译](#translations) | 我们提供本隐私声明的一些翻译版本的链接。 | ## GitHub 隐私声明 @@ -55,29 +55,29 @@ We use your personal information as this Privacy Statement describes. No matter #### 用户直接向 GitHub 提供的信息 -##### Registration information +##### 注册信息 创建帐户时，我们需要您提供一些基本信息。 创建用户名和密码时，我们会要求您提供有效的电子邮件地址。 -##### Payment information +##### 支付信息 如果您注册我们的付费帐户、通过 GitHub 赞助计划汇款或在 GitHub Marketplace 上购买应用程序，我们将收集您的全名、地址和信用卡信息或 PayPal 信息。 请注意，GitHub 不会处理或存储您的信用卡信息或 PayPal 信息，但我们的第三方付款处理商会这样做。 -如果您在 [GitHub Marketplace](https://github.com/marketplace) 上列出并销售应用程序，我们需要您的银行信息。 If you raise funds through the [GitHub Sponsors Program](https://github.com/sponsors), we require some [additional information](/github/supporting-the-open-source-community-with-github-sponsors/becoming-a-sponsored-developer#submitting-your-bank-information) through the registration process for you to participate in and receive funds through those services and for compliance purposes. +如果您在 [GitHub Marketplace](https://github.com/marketplace) 上列出并销售应用程序，我们需要您的银行信息。 如果您通过 [GitHub 赞助计划](https://github.com/sponsors)筹集资金，我们需要您在注册过程中提供一些[其他信息](/github/supporting-the-open-source-community-with-github-sponsors/becoming-a-sponsored-developer#submitting-your-bank-information)，以便您参与这些服务并通过这些服务获取资金以及满足合规要求。 -##### Profile information +##### 个人资料信息 您可以选择在帐户个人资料中向我们提供更多信息，例如您的全名、头像等，可包括照片、简历、地理位置、公司和第三方网站的 URL。 此类信息可能包括用户个人信息。 请注意，您的个人资料信息可能对我们服务的其他用户显示。 #### GitHub 在您使用服务时自动收集的信息 -##### Transactional information +##### 交易信息 如果您拥有我们的付费帐户、在 [GitHub Marketplace](https://github.com/marketplace) 上出售上架的应用程序或通过 [GitHub 赞助计划](https://github.com/sponsors)筹集资金，我们会自动收集有关您在服务中的交易的某些信息，例如日期、时间和收取金额。 -##### Usage information +##### 使用信息 如果您访问我们的服务或网站，我们将与大多数服务商一样自动收集一些基本信息，但在必要时会征得您的同意。 这包括有关您如何使用服务的信息，例如您查看的页面、推荐站点、您的 IP 地址和会话信息，以及每个请求的日期和时间。 这是我们针对网站的每个访客收集的信息，无论他们是否有帐户。 此类信息可能包括用户个人信息。 -##### Cookies and similar technologies information +##### Cookie 和类似技术的信息 如下所述，在必要时会征得您的同意，我们通过 cookie 和类似技术自动收集信息（例如 cookie ID 和设置）以保持您的登录状态、记住您的首选项以及识别您和您的设备 。 -##### Device information +##### 设备信息 我们可能会收集有关您设备的某些信息，例如其 IP 地址、浏览器或客户端应用程序信息、语言首选项、操作系统和应用程序版本、设备类型和 ID 以及设备型号和制造商。 此类信息可能包括用户个人信息。 #### 从第三方收集信息 @@ -133,7 +133,7 @@ GitHub 可能会从第三方收集用户个人信息。 例如，如果您报名 我们会与有限数量的服务提供商分享用户个人信息，他们替我们处理这些信息以提供或改善我们的服务，并且通过签署数据保护协议或作出类似承诺，同意遵守与我们隐私声明类似的隐私限制。 我们的服务提供商履行付款处理、客户支持事件单、网络数据传输、安全及其他类似服务。 虽然 GitHub 在美国处理所有用户个人信息，但我们的服务提供商可能在美国或欧盟外部处理数据。 如果您想知道我们的服务提供商有哪些，请参阅我们关于[子处理商](/github/site-policy/github-subprocessors-and-cookies)的页面。 #### 出于安全目的 -If you are a member of an Organization, GitHub may share your username, [Usage Information](#usage-information), and [Device Information](#device-information) associated with that Organization with an owner and/or administrator of the Organization, to the extent that such information is provided only to investigate or respond to a security incident that affects or compromises the security of that particular Organization. +如果您是组织的成员，GitHub 可能会将您与该组织相关联的用户名、[使用信息](#usage-information)和[设备信息](#device-information)分享给组织的所有者和/或管理员，但提供此类信息的目的仅限于调查或响应可能影响或损害该特定组织安全性的安全事件。 #### 法律要求披露 为遵守法律程序和履行法律义务，GitHub 力求提高透明度。 如果法律强制或要求披露用户的信息，我们会尽合理努力通知该用户，除非法律或法院命令不允许我们通知，或者在极少数紧急情况下来不及通知。 GitHub 可能会根据有效传票、法院命令、搜查令或类似的政府命令，向执法机构披露我们收集的用户个人信息或其他信息，或者我们出于善意，认为这种披露是履行我们法律义务的必要行动，有助于保护我们、第三方或公众的财产或权利时，我们也会这样做。 @@ -148,13 +148,13 @@ If you are a member of an Organization, GitHub may share your username, [Usage I 我们**不会**出于金钱或其他报酬而出售您的用户个人信息。 -请注意：《2018 年加州消费者隐私法案》(“CCPA”) 要求企业在其隐私政策中声明，他们是否会披露个人信息以换取金钱或其他有价值的报酬。 While CCPA only covers California residents, we voluntarily extend its core rights for people to control their data to _all_ of our users, not just those who live in California. 您可以在[此处](/github/site-policy/githubs-notice-about-the-california-consumer-privacy-act)了解有关 CCPA 以及我们如何遵守它的更多信息。 +请注意：《2018 年加州消费者隐私法案》(“CCPA”) 要求企业在其隐私政策中声明，他们是否会披露个人信息以换取金钱或其他有价值的报酬。 虽然 CCPA 只涵盖加州居民，但我们自愿将人们控制自己的数据之核心权利扩展到我们的_所有_用户，而不仅仅是居住在加州的用户。 您可以在[此处](/github/site-policy/githubs-notice-about-the-california-consumer-privacy-act)了解有关 CCPA 以及我们如何遵守它的更多信息。 ### 其他重要信息 #### 仓库内容 -GitHub 人员[不会访问私有仓库，除非](/github/site-policy/github-terms-of-service#e-private-repositories)出于安全原因，或者为了协助仓库所有者解决支持问题、保持服务的完整性或履行我们的法律义务而需要这样做。 However, while we do not generally search for content in your repositories, we may scan our servers and content to detect certain tokens or security signatures, known active malware, or other content known to violate our Terms, such as violent extremist or terrorist content or child exploitation imagery based on algorithmic fingerprinting techniques. 我们的服务条款提供了[更多详细信息](/github/site-policy/github-terms-of-service#e-private-repositories)。 +GitHub 人员[不会访问私有仓库，除非](/github/site-policy/github-terms-of-service#e-private-repositories)出于安全原因，或者为了协助仓库所有者解决支持问题、保持服务的完整性或履行我们的法律义务而需要这样做。 不过，虽然我们一般不搜索您的仓库中的内容，但可能扫描我们的服务器和内容，以根据算法指纹技术检测某些令牌或安全签名、已知活动的恶意软件或其他已知违反我们条款的内容，例如暴力极端主义或恐怖主义内容或儿童剥削图片。 我们的服务条款提供了[更多详细信息](/github/site-policy/github-terms-of-service#e-private-repositories)。 如果您的仓库是公共仓库，则任何人都可以查看其内容。 如果您的公共仓库中含有私人、机密或[敏感个人信息](https://gdpr-info.eu/art-9-gdpr/)，例如电子邮件地址或密码，则该信息可能会被搜索引擎索引或被第三方使用。 @@ -175,7 +175,7 @@ GitHub 的许多服务和功能都是面向公众的。 如果您的内容是面 您可以通过在 GitHub 上的操作来表明您愿意分享自己的用户个人信息。 如果您与组织协作或成为组织成员，则其帐户所有者可能会收到您的用户个人信息。 当您接受组织邀请时，您将被告知所有者可以看到的信息类型（更多信息请参阅[关于组织成员](/github/setting-up-and-managing-your-github-user-account/about-organization-membership)）。 如果您接受含有[验证域](/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain)的组织的邀请，则该组织的所有者将能够在该组织的验证域中查看您的完整电子邮件地址。 -Please note, GitHub may share your username, [Usage Information](#usage-information), and [Device Information](#device-information) with the owner(s) of the Organization you are a member of, to the extent that your User Personal Information is provided only to investigate or respond to a security incident that affects or compromises the security of that particular Organization. +请注意，GitHub 可能会将您的用户名、[使用信息](#usage-information)和[设备信息](#device-information)分享给您所属组织的所有者，但提供这些用户个人信息的目的仅限于调查或响应可能影响或损害该特定组织安全性的安全事件。 如果您与已同意[公司服务条款](/github/site-policy/github-corporate-terms-of-service)、数据保护附录 (DPA) 和本隐私声明的帐户进行协作或成为其成员，则对于您在该帐户中的活动，当本隐私声明与 DPA 之间发生任何冲突时，以 DPA 为准。 @@ -193,7 +193,7 @@ Please note, GitHub may share your username, [Usage Information](#usage-informat #### GitHub 应用程序 -You can also add applications from GitHub, such as our Desktop app, our Atom application, or other application and account features, to your Account. 这些应用程序都有其各自的条款，并且可能收集不同类型的用户个人信息；但是，所有 GitHub 应用程序均受本隐私声明的约束，我们只收集必要的用户个人信息，并且仅用于您许可的目的。 +您还可以在自己的帐户中添加 GitHub 的应用程序，例如我们的 Desktop 应用程序、Atom 应用程序或其他应用程序和帐户功能。 这些应用程序都有其各自的条款，并且可能收集不同类型的用户个人信息；但是，所有 GitHub 应用程序均受本隐私声明的约束，我们只收集必要的用户个人信息，并且仅用于您许可的目的。 ### 您如何访问和控制我们收集的信息 @@ -227,7 +227,7 @@ GitHub 使用 cookie 让服务交互变得简单而有意义。 Cookie 是网站 我们使用许多第三方分析和服务提供商来帮助我们评估用户对 GitHub的使用； 汇编有关活动的统计报告；以及改善我们的内容和网站性能。 我们仅在网站的某些区域使用这些第三方分析提供商，他们全部与我们签署了数据保护协议，这些协议限制了他们可以收集的用户个人信息类型以及他们处理信息的目的。 此外，我们使用自己的内部分析软件来提供功能并改善我们的内容和性能。 -有些浏览器纳入了“别跟踪”(DNT) 功能，可向您访问的网站发送信号，表明您不希望被跟踪。 GitHub 响应浏览器的 DNT 信号，并遵循[关于响应 DNT 信号的 W3C 标准](https://www.w3.org/TR/tracking-dnt/)。 如果您没有在支持 DNT 的浏览器上启用 DNT，则我们网站某些部分的 cookie 会长期跟踪您在其他在线服务上的在线浏览活动，不过，我们不允许我们分析和服务提供商以外的第三方长期跟踪 GitHub 用户在 GitHub 上的活动。 +有些浏览器纳入了“别跟踪”(DNT) 功能，可向您访问的网站发送信号，表明您不希望被跟踪。 GitHub 响应浏览器的 DNT 信号，并遵循[关于响应 DNT 信号的 W3C 标准](https://www.w3.org/TR/tracking-dnt/)。 如果您没有在支持 DNT 的浏览器上启用 DNT，则我们网站某些部分的 cookie 会长期跟踪您在其他在线服务上的在线浏览活动，不过，我们不允许我们分析和服务提供商以外的第三方长期跟踪 GitHub 用户在 GitHub 上的活动。 You can read more about DNT in our [Tracking on GitHub](/github/site-policy/github-subprocessors-and-cookies#tracking-on-github) section of our [GitHub Subprocessors and Cookies](/github/site-policy/github-subprocessors-and-cookies) page. ### GitHub 如何保护您的信息 @@ -248,16 +248,16 @@ GitHub 上的数据传输使用 SSH、HTTPS (TLS) 进行加密，git 仓库的 ### GitHub 的全球隐私实践 -GitHub, Inc. and, for those in the European Economic Area, the United Kingdom, and Switzerland, GitHub B.V. are the controllers responsible for the processing of your personal information in connection with the Service, except (a) with respect to personal information that was added to a repository by its contributors, in which case the owner of that repository is the controller and GitHub is the processor (or, if the owner acts as a processor, GitHub will be the subprocessor); or (b) when you and GitHub have entered into a separate agreement that covers data privacy (such as a Data Processing Agreement). +GitHub, Inc. 和 GitHub B.V.（适用于欧洲经济区、英国和瑞士）是负责处理与服务相关个人信息的控制方 ，但以下情况除外：(a) 参与者添加到仓库的个人信息，在这种情况下，该仓库的所有者是控制方，GitHub 是处理方（或者，如果所有者充当处理方，则 GitHub 将为再处理方）；或 (b) 您与 GitHub 签订了涵盖数据隐私保护的单独协议（例如数据处理协议）。 -Our addresses are: +我们的地址是： -- GitHub, Inc., 88 Colin P. Kelly Jr. Street, San Francisco, CA 94107. -- GitHub B.V., Vijzelstraat 68-72, 1017 HL Amsterdam, The Netherlands. +- GitHub, Inc., 88 Colin P. Kelly Jr. Street, San Francisco, CA 94107。 +- GitHub B.V., Vijzelstraat 68-72, 1017 HL Amsterdam, The Netherlands。 -We store and process the information that we collect in the United States in accordance with this Privacy Statement, though our service providers may store and process data outside the United States. 但是我们理解，不同国家和地区的用户对隐私保护有不同的预期，即使美国没有与其他国家/地区相同的隐私框架，我们也会努力满足这些需求。 +我们按照本隐私声明在美国存储和处理我们收集的信息，但我们的服务提供商可能在美国境外存储和处理数据。 但是我们理解，不同国家和地区的用户对隐私保护有不同的预期，即使美国没有与其他国家/地区相同的隐私框架，我们也会努力满足这些需求。 -We provide the same high standard of privacy protection—as described in this Privacy Statement—to all our users around the world, regardless of their country of origin or location, and we are proud of the levels of notice, choice, accountability, security, data integrity, access, and recourse we provide. 无论我们在哪里开展业务，都会与我们的数据保护官合作，努力遵守适用的数据隐私法律，我们的数据保护官作为跨职能团队的一部分，负责监督我们的隐私合规工作。 此外，如果我们的供应商或附属公司有权访问用户个人信息，则他们必须签署协议，遵守我们的隐私政策和适用的数据隐私法律。 +如本隐私声明所述，我们为世界各地的所有用户提供同样的高标准隐私保护，不论其原籍国或所在地，我们为我们提供的通知、选择、问责、安全、数据完整性、访问和追索水准而感到自豪。 无论我们在哪里开展业务，都会与我们的数据保护官合作，努力遵守适用的数据隐私法律，我们的数据保护官作为跨职能团队的一部分，负责监督我们的隐私合规工作。 此外，如果我们的供应商或附属公司有权访问用户个人信息，则他们必须签署协议，遵守我们的隐私政策和适用的数据隐私法律。 特点： @@ -268,13 +268,13 @@ We provide the same high standard of privacy protection—as described in this P #### 跨境数据传输 -GitHub processes personal information both inside and outside of the United States and relies on Standard Contractual Clauses as the legally provided mechanism to lawfully transfer data from the European Economic Area, the United Kingdom, and Switzerland to the United States. In addition, GitHub is certified to the EU-US and Swiss-US Privacy Shield Frameworks. To learn more about our cross-border data transfers, see our [Global Privacy Practices](/github/site-policy/global-privacy-practices). +GitHub 处理美国境内外的个人信息，并依靠标准合同条款作为法律规定的机制，将数据从欧洲经济区、英国和瑞士合法转移到美国。 此外，GitHub 还通过了欧盟-美国和瑞士-美国隐私盾框架的认证。 要了解有关我们跨境数据传输的更多信息，请参阅我们的[全球隐私实践](/github/site-policy/global-privacy-practices)。 ### 我们如何与您交流 我们使用您的电子邮件地址与您通信，但需要征得您的同意，**并且以您的同意为前提**。 例如，如果您向我们的支持团队提出请求，我们将通过电子邮件答复您。 对于在 GitHub 上如何使用和分享您的电子邮件地址，您有很多控制权。 您可以在[用户个人资料](https://github.com/settings/emails)中管理您的通信首选项。 -根据设计，Git 版本控制系统将许多操作与用户的电子邮件地址相关联，例如提交消息。 我们在很多方面无法更改 Git 系统。 如果您希望自己的电子邮件地址保持私密，即使在公共仓库中发表评论时也不可见，[您可以在用户个人资料中创建私密电子邮件地址](https://github.com/settings/emails)。 You should also [update your local Git configuration to use your private email address](/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address). 这不会改变我们与您联系的方式，但会影响其他人查看您的情况。 在当前版本中，用户的电子邮件地址默认设置为私密，但旧版 GitHub 的用户可能需要更新其设置。 Please see more about email addresses in commit messages [here](/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address). +根据设计，Git 版本控制系统将许多操作与用户的电子邮件地址相关联，例如提交消息。 我们在很多方面无法更改 Git 系统。 如果您希望自己的电子邮件地址保持私密，即使在公共仓库中发表评论时也不可见，[您可以在用户个人资料中创建私密电子邮件地址](https://github.com/settings/emails)。 您还应[更新本地 Git 配置以使用您的私密电子邮件地址](/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address)。 这不会改变我们与您联系的方式，但会影响其他人查看您的情况。 在当前版本中，用户的电子邮件地址默认设置为私密，但旧版 GitHub 的用户可能需要更新其设置。 有关提交消息中电子邮件地址的更多信息，请参阅[此处](/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address)。 根据您的[电子邮件设置](https://github.com/settings/emails)，GitHub 有时可能会发送有关新动态的通知电子邮件，例如您关注的仓库中有变动、出现新功能、有反馈请求、有重要政策变动或需要提供客户支持。 根据您的选择和适用的法律法规，我们还可能会发送营销电子邮件。 在我们发送的每封营销电子邮件的底部，都有一个“退订”链接。 请注意，您不能选择不接收我们的重要通讯，例如来自我们支持团队的电子邮件或系统电子邮件，但是您可以在个人资料中配置通知设置以选择不接收其他通讯。 @@ -296,7 +296,7 @@ GitHub processes personal information both inside and outside of the United Stat #### 争议解决流程 -万一您和 GitHub 之间就我们处理用户个人信息的问题出现争议，我们将尽最大努力予以解决。 Additionally, if you are a resident of an EU member state, you have the right to file a complaint with your local supervisory authority, and you might have more [options](/github/site-policy/global-privacy-practices#dispute-resolution-process). +万一您和 GitHub 之间就我们处理用户个人信息的问题出现争议，我们将尽最大努力予以解决。 此外，如果您是欧盟成员国的居民，您有权向当地监管机构投诉，并且您可能拥有更多[选项](/github/site-policy/global-privacy-practices#dispute-resolution-process)。 ### 隐私声明的变更 @@ -318,4 +318,4 @@ Cliquez ici pour obtenir la version française: [Déclaration de confidentialit #### 其他翻译版本： -For translations of this statement into other languages, please visit [https://docs.github.com/](/) and select a language from the drop-down menu under “English.” +有关本声明翻译成其他语言的版本，请访问 [https://docs.github.com/](/)，然后从“English（英文）”下的下拉菜单中选择语言。 diff --git a/translations/zh-CN/content/github/site-policy/github-registered-developer-agreement.md b/translations/zh-CN/content/github/site-policy/github-registered-developer-agreement.md index e8f86ec4fef8..15c1a461f9f2 100644 --- a/translations/zh-CN/content/github/site-policy/github-registered-developer-agreement.md +++ b/translations/zh-CN/content/github/site-policy/github-registered-developer-agreement.md @@ -56,7 +56,7 @@ GitHub 很荣幸看到众多开发者融入我们的平台。 我们受宠若惊 7. **费用和付款** - 参与计划可能涉及费用。 我们将在计划条款中告诉您需要哪些费用，我们会不时更新这些条款（“计划费用”）。 如果您之前向我们提供了付款信息，则表示您同意我们可根据本协议向您提供的信用卡或 PayPal 帐户收费。 否则，您需要向我们提供有效的付款帐户以及其他支持信息。 除第 8 条另有明确规定之外，您向我们的计划支付的任何款项概不退还。 您允许我们在第一次付款日期的周年纪念日自动从您的付款帐户扣款，用以支付下一年的所有计划费用，除非您先根据第 8 条终止本协议。 All fees are due in U.S. 所有费用应以美元支付，不包括税务机关征收的所有税款、税费或关税（您自行负责所有这些税收，基于我们收入的税收除外）。 + 参与计划可能涉及费用。 我们将在计划条款中告诉您需要哪些费用，我们会不时更新这些条款（“计划费用”）。 如果您之前向我们提供了付款信息，则表示您同意我们可根据本协议向您提供的信用卡或 PayPal 帐户收费。 否则，您需要向我们提供有效的付款帐户以及其他支持信息。 除第 8 条另有明确规定之外，您向我们的计划支付的任何款项概不退还。 您允许我们在第一次付款日期的周年纪念日自动从您的付款帐户扣款，用以支付下一年的所有计划费用，除非您先根据第 8 条终止本协议。 所有费用应以美元支付 所有费用应以美元支付，不包括税务机关征收的所有税款、税费或关税（您自行负责所有这些税收，基于我们收入的税收除外）。 8. **期限与终止** @@ -82,7 +82,7 @@ GitHub 很荣幸看到众多开发者融入我们的平台。 我们受宠若惊 12. **出口管制** - 您不得出口或再出口我们的任何机密信息，除非美国法律和获取机密信息所在司法管辖区的法律明确授权。 In particular, you aren’t allowed to export or re-export our Confidential Information into any U.S. embargoed countries, to anyone on the U.S. Treasury Department's list of Specially Designated Nationals, or to anyone on the U.S. Department of Commerce Denied Person's List or Entity List. 加入计划或接收我们的任何机密信息，即表示您声明并保证您不在任何此类国家/地区或任何此类名单中。 + 您不得出口或再出口我们的任何机密信息，除非美国法律和获取机密信息所在司法管辖区的法律明确授权。 特别要注意，您不得将我们的机密信息出口或再出口到任何美国 禁运国家/地区、美国 财政部特别指定国民名单上的任何人或美国 商务部拒绝人员名单或实体名单上的任何人。 加入计划或接收我们的任何机密信息，即表示您声明并保证您不在任何此类国家/地区或任何此类名单中。 13. **专有权利** @@ -90,7 +90,7 @@ GitHub 很荣幸看到众多开发者融入我们的平台。 我们受宠若惊 14. **政府用户** - 如果您是政府实体，本节将适用于您。 我们的某些机密信息可能被视为“商业项目”，该术语的定义见 48 C.F.R. §2.101，由“商用计算机软件”和“商用计算机软件文档”组成，这些术语的定义见 48 C.F.R. §12.212 或 48 C.F.R. §227.7202（如适用）。 §2.101, consisting of “Commercial Computer Software” and “Commercial Computer Software Documentation”, as such terms are used in 48 C.F.R. §12.212 or 48 C.F.R. §227.7202, as applicable. Consistent with 48 C.F.R. §12.212 or 48 C.F.R. 根据 48 C.F.R. §12.212 或 48 C.F.R. §227.7202-1 至 227.7202-4（如适用），商用计算机软件和商用计算机软件文档许可给美国政府最终用户 (a) 仅作为商业项目，以及 (b) 仅具有根据本文的条款和条件授予所有其他最终用户的那些权利。 Government end users (a) only as Commercial Items and (b) with only those rights as are granted to all other end users pursuant to the terms and conditions herein. GitHub, Inc. 88 Colin P. Kelly Street, San Francisco, CA 94107。 + 如果您是政府实体，本节将适用于您。 我们的某些机密信息可能被视为“商业项目”，该术语的定义见 48 C.F.R. §2.101，由“商用计算机软件”和“商用计算机软件文档”组成，这些术语的定义见 48 C.F.R. §12.212 或 48 C.F.R. §227.7202（如适用）。 §2.101，由“商用计算机软件”和“商用计算机软件文档”组成，这些术语的定义见 48 C.F.R. §12.212 或 48 C.F.R. §227.7202（如适用）。 根据 48 C.F.R. §12.212 或 48 C.F.R. 根据 48 C.F.R. §12.212 或 48 C.F.R. §227.7202-1 至 227.7202-4（如适用），商用计算机软件和商用计算机软件文档许可给美国政府最终用户 (a) 仅作为商业项目，以及 (b) 仅具有根据本文的条款和条件授予所有其他最终用户的那些权利。 政府最终用户 (a) 仅作为商业项目，以及 (b) 仅具有根据本文的条款和条件授予所有其他最终用户的那些权利。 GitHub, Inc. 88 Colin P. Kelly Street, San Francisco, CA 94107。 15. **自主发展** diff --git a/translations/zh-CN/content/github/site-policy/github-research-program-terms.md b/translations/zh-CN/content/github/site-policy/github-research-program-terms.md index 677e1272f96c..c1afa83ac48f 100644 --- a/translations/zh-CN/content/github/site-policy/github-research-program-terms.md +++ b/translations/zh-CN/content/github/site-policy/github-research-program-terms.md @@ -32,7 +32,7 @@ GitHub 可能会允许您访问在世界上其他地方无法获取的特殊信 参与本计划，即表示您同意我们将您的个人信息用于研究目的，但不得用于任何其他用途。 作为计划的一部分，我们可能会使用您的个人信息与您联系，或者保留您的信息以便今后联系您。 个人信息不包括汇总的非个人识别信息。 我们可能会使用通过计划收集的汇总信息或其他非个人识别信息来运营、分析和改善我们的产品和服务。 -您可以随时撤回您的同意，并请求访问或删除我们持有的有关您的个人信息。 For more information about how you can access, update, alter, or delete the personal information GitHub collects through the Program, please see the [GitHub Privacy Statement](/articles/github-privacy-statement/) or contact us through our {% data variables.contact.contact_privacy %}. +您可以随时撤回您的同意，并请求访问或删除我们持有的有关您的个人信息。 要详细了解如何访问、更新、更改或删除 GitHub 通过计划收集的个人信息，请参阅 [GitHub 隐私声明](/articles/github-privacy-statement/)或通过 {% data variables.contact.contact_privacy %} 联系我们。 ### E. GitHub 服务和软件条款 @@ -54,7 +54,7 @@ GitHub 可能会允许您访问在世界上其他地方无法获取的特殊信 除非适用法律另有规定，否则，您与 GitHub 之间的本协议以及对网站或服务的任何访问或使用，均受美国联邦法律和加利福尼亚州法律的管辖，不考虑冲突法原则。 您和 GitHub 均同意，位于加利福尼亚州旧金山县的法院具有专属管辖权和审判权。 #### 2. 不可转让 -GitHub may assign or delegate this Agreement, in whole or in part, to any person or entity at any time with or without your consent, including the license grant in Section A. You may not assign or delegate any rights or obligations under this Agreement without our prior written consent, and any unauthorized assignment and delegation by you is void. +GitHub 可随时将本协议的全部或部分转让或委托给任何个人或实体，可以征求或不征求您的同意，包括 A 部分的许可授予。未经我们事先书面同意，您不得转让或委托本协议下的任何权利或义务，任何未经授权的转让和授权都是无效的。 #### 3. 可分割性、非弃权和继续有效 如果本协议的任何部分被认为无效或不可执行，则该部分将被解释为反映缔约方的初衷。 其余部分仍具有完全效力。 GitHub 方面未执行本协议的任何规定，并不构成我们放弃执行该规定的权利。 我们在本协议下的权利在本协议终止后仍然有效。 diff --git a/translations/zh-CN/content/github/site-policy/github-sensitive-data-removal-policy.md b/translations/zh-CN/content/github/site-policy/github-sensitive-data-removal-policy.md index c2befd73f3c3..882b6a244a3f 100644 --- a/translations/zh-CN/content/github/site-policy/github-sensitive-data-removal-policy.md +++ b/translations/zh-CN/content/github/site-policy/github-sensitive-data-removal-policy.md @@ -58,7 +58,7 @@ versions: #### 复刻呢？ （或如何处理复刻？） GitHub 的最佳功能之一是用户能够“复刻”彼此的仓库。 这意味着什么？ 从本质上讲，这意味着用户可以将 GitHub 上的项目复制到自己的仓库中。 在许可或法律允许的情况下，用户可以对复刻进行更改，然后将其推送到主项目或只保留为自己的项目变体。 每个此类副本都是原仓库的[复刻](/articles/github-glossary/#fork)，或者说原仓库也可以称为复刻的“父仓库”。 -GitHub will not automatically disable forks when disabling a parent repository. 这是因为复刻属于不同的用户，并且可能进行了重大更改。 GitHub 不会对复刻进行任何独立调查。 我们希望敏感数据删除请求发送者进行这种调查，如果他们认为复刻也包含敏感数据，则应在其请求中明确包括这些复刻。 +GitHub 在禁用父仓库时不会自动禁用复刻。 这是因为复刻属于不同的用户，并且可能进行了重大更改。 GitHub 不会对复刻进行任何独立调查。 我们希望敏感数据删除请求发送者进行这种调查，如果他们认为复刻也包含敏感数据，则应在其请求中明确包括这些复刻。 ### 发送敏感数据删除请求 diff --git a/translations/zh-CN/content/github/site-policy/github-sponsors-additional-terms.md b/translations/zh-CN/content/github/site-policy/github-sponsors-additional-terms.md index 25540bc0fa59..8d2b2f14ec39 100644 --- a/translations/zh-CN/content/github/site-policy/github-sponsors-additional-terms.md +++ b/translations/zh-CN/content/github/site-policy/github-sponsors-additional-terms.md @@ -24,13 +24,13 @@ versions: “**被赞助开发者付款**”是指 GitHub 的被赞助开发者帐户每月收到的百分之百 (100%) 净额，计算为被赞助开发者帐户每月从赞助和订阅收到的总付款，加上任何适用的匹配基金，加上被赞助开发者选择使用的货币化选项的其他收益（如适用），减去 GitHub 未收取或退款的任何帐户、税收、费用、金额，减去归于被赞助开发者帐户相关计划的第三方的金额，再减去第 4 条所述的其他排除项。 -"**USD**" means United States Dollar. +"**USD**" 是指美元。 ### 2. 可接受使用。 #### 2.1. 2.1. GitHub 赞助者计划 -In order to participate in the Program, you must comply with your country's minimum age laws (for example, you must be at least 13 years of age if you live in the United States), have a valid GitHub account, and have agreed to the [Acceptable Use section](/github/site-policy/github-terms-of-service#c-acceptable-use) in the Agreement and applicable GitHub Policies, and these GitHub Sponsors Additional Terms. +要参加该计划，您必须遵守您所在国家/地区的最低年龄法律（例如，如果您居住在美国，则必须年满 13 岁），拥有有效的 GitHub 帐户，并同意本协议中的[“可接受使用”部分](/github/site-policy/github-terms-of-service#c-acceptable-use)和适用的 GitHub 政策，以及这些 GitHub 赞助者附加条款。 如果您已满 13 岁但未满 18 岁，您可以捐赠和获取赞助者资金，前提是我们的付款处理商 Stripe 可以向您的法定监护人收集验证信息。 @@ -48,7 +48,7 @@ In order to participate in the Program, you must comply with your country's mini * 彩票、抽奖、赌博、金字塔计划、假公济私、“快速致富计划”、欺骗性营销计划、“为捐赠而捐赠”计划，或任何尝试非法利用 GitHub 或第三方系统或服务的行为；以及 -* activities with, in, or involving countries, regions, governments, persons, or entities that are not permitted under U.S. and other economic sanctions under applicable law. +* 违反适用法律，从事与美国和其他经济制裁规定不允许的国家、地区、政府、个人或实体 相关的活动。 #### 2.2. GitHub 赞助者匹配基金 GitHub 赞助者匹配基金旨在鼓励参与开源软件 (OSS) 生态系统的社区向具有被赞助开发者帐户的合格个人捐赠可持续发展资金。 所有在 2020 年 1 月 1 日之前申请该计划的个人都将获得匹配基金的资格，但并非所有符合条件的个人被赞助开发者帐户都将获得匹配。 组织不能参与 GitHub 赞助者匹配基金，并且不会匹配组织与合格的被赞助开发者帐户之间的赞助关系。 有关其他规则，请参阅下文。 @@ -58,13 +58,13 @@ GitHub 赞助者匹配基金旨在鼓励参与开源软件 (OSS) 生态系统的 * 您必须拥有 GitHub 帐户，作为个人被接受加入该计划，并积极为 OSS 做出贡献。 请注意，GitHub 不允许操作多个免费的用户帐户。 因此，匹配单独提供，而不会被批准跨多个帐户。 -* Your use of GitHub and your Sponsored Developer Account must be, based on our determination, in our sole discretion, in accordance with the GitHub Sponsors mission to expand the opportunities to contribute to open source that upholds the [GitHub Community Guidelines](/github/site-policy/github-community-guidelines). +* 您对 GitHub 和被赞助开发者帐户的使用必须由我们根据 GitHub 赞助者的使命单方面决定，用以扩大参与恪守 [GitHub 社区指导方针](/github/site-policy/github-community-guidelines)的开源项目的机会。 * 您无法匹配源自发布了 GitHub 赞助者配置文件的用户或组织帐户的任何赞助。 * GitHub 保留基于任何理由扣留或撤销匹配基金资金，以及阻止任何用户参加 GitHub 赞助者匹配基金的权利，包括但不限于发布 GitHub 认为有冒犯性或令人反感的内容或项目。 -##### 2.2.2. 匹配期。 Matching Period. +##### 2.2.2. 匹配期。 匹配期。 匹配期始于 GitHub 接受个人被赞助开发者帐户加入 GitHub 赞助者并发布该帐户的赞助资料。 对于符合 GitHub 赞助者匹配基金资格的每个被赞助开发者帐户，GitHub 在被赞助开发者帐户参与计划的前 12 个月内可以匹配总金额达 5,000 美元的社区赞助。 匹配期不能因任何原因而延长。 在匹配期间，GitHub 不收取任何费用，因此赞助 100% 会转给被赞助的开发者。 以后我们可能会收取名义上的手续费。 * 如果赞助或赞助订阅因任何原因停止，关联的匹配也将停止。 在被赞助开发者付款日期之前退回赞助者的资金不符合匹配资格。 @@ -78,42 +78,42 @@ GitHub 赞助者匹配基金旨在鼓励参与开源软件 (OSS) 生态系统的 ### 3. 被赞助开发者的义务。 -#### 3.1. 一般。 General. +#### 3.1. 一般。 一般。 您将：(A) 创建被赞助开发者帐户；(B) 通过计划和服务提供可用的被赞助开发者内容；以及 (C) 遵守所有 GitHub 政策。 您将自行负责您的被赞助开发者帐户和被赞助开发者内容的支持、开发和维护，以及与之相关的任何投诉。 -#### 3.2. Registration. -如果您选择申请参与本计划，则需要完成注册流程并由 GitHub 接受您的申请后才能加入本计划。 此外，您可能需要注册 GitHub 选择的支付服务提供商（例如 Stripe），才能访问和使用本计划的某些特定功能。 您必须使用您的真实身份进行注册，并同意按照本计划注册表单的要求提供并维护关于自己的真实、准确、最新和完整信息。 Registration data and certain other information about you are governed by our [Privacy Statement](/github/site-policy/github-privacy-statement), as well as any privacy statement provided by our payment processor. GitHub 保留拒绝接受加入本计划的权利。 +#### 3.2. 注册。 +如果您选择申请参与本计划，则需要完成注册流程并由 GitHub 接受您的申请后才能加入本计划。 此外，您可能需要注册 GitHub 选择的支付服务提供商（例如 Stripe），才能访问和使用本计划的某些特定功能。 您必须使用您的真实身份进行注册，并同意按照本计划注册表单的要求提供并维护关于自己的真实、准确、最新和完整信息。 注册数据和关于您的某些其他信息，受我们的[隐私声明](/github/site-policy/github-privacy-statement)和支付处理商提供的任何隐私声明的管制。 GitHub 保留拒绝接受加入本计划的权利。 -#### 3.3. Content Monetization. +#### 3.3. 内容商品化。 通过本计划和服务，GitHub 可为您提供各种商品化被赞助开发者内容的选项。 有些选项可能需要您更新被赞助开发者帐户中的某些设置。 此外，本计划支持每种商品化选项的方式可能有所不同。 果您通过更改适当设置使用其中一个（或多个）选项，则表示您同意适用于该选项的条款。 有些商品化选项可能需要您向 GitHub 或其服务提供商提供其他信息，或接受其他 GitHub 条款或第三方条款。 -##### 3.3.1. Subscriptions. +##### 3.3.1. 订阅。 计划可让您提供订阅。 如果您选择提供内容订阅，则 GitHub 将按照第 4 节的规定向您支付订阅赞助。 您有责任确定所提供订阅内容的性质、内容和功能，但须遵守这些附加条款和适用的 GitHub 政策。 -##### 3.3.2. Other Sponsorships. +##### 3.3.2. 其他赞助。 通过本计划或服务，您可以在没有提供订阅内容的情况下，接受其他用户的捐赠或其他类型的直接赞助。 但是，由于 GitHub 不支付这些类型的赞助，您必须通过第三方支付服务提供商（例如 Stripe）创建一个商家帐户，并遵守该服务提供商的商家帐户条款、条件和隐私政策。 捐赠给您的任何款项或其他赞助将直接支付到您的商家帐户，不包含在任何被赞助开发者报酬中。 您同意不会就捐赠事宜向 GitHub 提出任何索赔或补偿，与捐赠有关的任何争议仅限于您与第三方支付服务提供商之间。 您有责任遵守任何第三方支付服务提供商的协议、政策和可能适用的法律或法规。 为您的方便起见，GitHub 可能会选择向您提供有关捐赠金额的信息或报告。 -##### 3.3.3. 广告。 Advertising. -虽然我们理解，您可能希望在帐户中发布赞助者的名称或徽标以宣传他们，但请注意，您的被赞助开发者内容的主要焦点不应该是广告或促销。 In addition, you may not enter into any advertising agreement to promote any product or brand if doing so would be prohibited by the [Agreement](/github/site-policy/github-terms-of-service) or GitHub's Community Guidelines. If you decide to host any advertising or promotional materials in your Sponsored Developer Content, you are solely responsible for complying with all applicable laws and regulations, including the U.S. Federal Trade Commission's Guidelines on Endorsements and Testimonials. +##### 3.3.3. 广告。 广告。 +虽然我们理解，您可能希望在帐户中发布赞助者的名称或徽标以宣传他们，但请注意，您的被赞助开发者内容的主要焦点不应该是广告或促销。 此外，如果[协议](/github/site-policy/github-terms-of-service)或 GitHub 社区指导方针不允许，您不得签订旨在宣传任何产品或品牌的任何广告协议。 如果您决定在被赞助开发者内容中嵌入任何广告或宣传材料，您将自行负责遵守所有适用的法律和法规，包括美国 联邦贸易委员会的背书和推荐准则。 ### 4. 财务条款。 -#### 4.1. 付款。 Payment. -GitHub will pay you the Sponsored Developer Payment in accordance with this Section 4, so long as you meet the Sponsored Developer Obligations in Section 3 and are not in violation of these Additional Terms. 如果您在任何特定月份未履行这些义务，我们可能会自行决定扣留该月的被赞助开发者报酬。 如果您在期限内有两 (2) 个月或更多月份（连续或不连续）未履行或坚持被赞助开发者义务，GitHub 可能会根据第 6 节的规定终止这些附加条款。 +#### 4.1. 付款。 付款。 +只要您履行第 4 节中的被赞助开发者义务且未违反这些附加条款，GitHub 将按照第 3 节（本节）的规定向您支付被赞助开发者报酬。 如果您在任何特定月份未履行这些义务，我们可能会自行决定扣留该月的被赞助开发者报酬。 如果您在期限内有两 (2) 个月或更多月份（连续或不连续）未履行或坚持被赞助开发者义务，GitHub 可能会根据第 6 节的规定终止这些附加条款。 -#### 4.2. Sponsored Developer Payment Exclusions. +#### 4.2. 被赞助开发者报酬排除项。 以下款项不包含在被赞助开发者报酬中，或者可能被 GitHub 扣留（如适用）。 -##### 4.2.1. Sponsored Developer Expenses. +##### 4.2.1. 被赞助开发者费用。 您将承担这些附加条款下的性能相关的所有费用。 我们不会向您补偿或预付任何费用。 -##### 4.2.2. 税金。 Taxes. +##### 4.2.2. 税金。 税金。 GitHub 承诺遵守根据合理判断认为适用于这些付款的所有适用税务信息报告和代扣税金法律。 如果 GitHub 向您支付的任何款项中需要代扣税金，或者根据适用法律需要报告税务信息，GitHub 将从应付款项中扣除这些税金并将其支付给相应的税务机关，并将根据适用法律的要求，妥善保管并向您递送任何此类代扣税金的正式收据。 GitHub 将尽合理努力，在适用法律允许的范围内尽量减少此类税金， 并鼓励各方合理合作，根据适用的所得税法律或条例实现最低税率或避免此类税金。 这需要您向 GitHub 提供适用法律要求的充分信息，例如 IRS 表 W-8、W-9 或其他信息，才能达成免扣税金的条件。 您还有责任遵守任何第三方支付处理商关于代扣税金和报告税务信息的条款和条件（如适用）。 此外，GitHub 保留暂停向您的帐户付款的权利，直到您向 GitHub 提供适用法律要求的充分文档或信息，以便 GitHub 确定适用于这些附加条款或协议下的付款的任何代扣税金或报告义务。 -##### 4.2.3. Withholding of Sponsored Developer Payment for Breach. +##### 4.2.3. 因违规扣留被赞助开发者报酬。 如果被赞助开发者违反或涉嫌违反这些附加条款或协议，GitHub 将根据这些附加条款或其他政策，保留扣留被赞助开发者应得付款的权利，等待 GitHub 对该事件进行合理调查。 如果 GitHub 根据自行判断确定，被赞助开发者确实违反了这些附加条款或协议，则 GitHub 可能会永久扣留被赞助开发者的任何应得款项。 -#### 4.3. Payment Timing. +#### 4.3. 付款时限。 在此期间，GitHub 将在指定月份结束后 30 天内将该月内收到的所有被赞助开发者付款汇给您，但受限于以下变化。 付款通过 Stripe Connect、ACH 转账或电汇转到您在申请 GitHub 赞助者时提供的银行账号。 对于因您或银行提供的信息不正确或不完整，或者银行未对您的帐户进行贷记，而造成的任何被赞助开发者报酬延误或误发，我们概不负责。 - 对于新创建的被赞助开发者帐户，GitHub 将在被赞助开发者帐户创建后的 90 天内将指定月份收到的所有被赞助开发者付款汇给您，但受限于以下变化。 根据本条规定，此后的付款将在该月结束后 30 天内汇给您。 @@ -124,13 +124,13 @@ GitHub 承诺遵守根据合理判断认为适用于这些付款的所有适用 - 在协议终止后，我们将在终止协议的日历月结束后大约 90 天内，向您支付已收到但未支付的所有被赞助开发者付款。 -#### 4.4. 付款方式。 Payment Method. +#### 4.4. 付款方式。 付款方式。 我们将通过 ACH/SEPA 汇款被赞助开发者报酬，或者电汇到您指定的帐户，具体取决于我们当时的付款政策（我们可能会不时更新）中规定的阈值、方法和时限。 付款方式和阈值可能会因您提供的国家/地区和帐户信息而异。 我们可能（根据自行决定）将被赞助开发者报酬与您可能应得的任何其他款项组合在一起支付。 -#### 4.5. 货币。 Currency. +#### 4.5. 货币。 货币。 所有货币以美元为基准。 如果您位于美国境外，我们可能会使用我们当时的汇率将美元兑换成您所在地址的当地货币进行付款。 -#### 4.6. Refund Requirements. +#### 4.6. 退款要求。 您将负责规定关于向您的赞助者退款的条款和条件（如果有）。 在任何情况下，GitHub 都不负责为退款提供任何支持，GitHub 也没有义务支付任何退款。 #### 4.7. 4.7. 付款信息要求。 @@ -138,7 +138,7 @@ GitHub 承诺遵守根据合理判断认为适用于这些付款的所有适用 ### 5. 声明与保证；责任限制；保障赔偿。 -#### 5.1. By Sponsored Developer. +#### 5.1. 被赞助开发者声明。 被赞助的开发者声明并保证： * 您有权签订并完全履行这些附加条款； @@ -158,7 +158,7 @@ GitHub 承诺遵守根据合理判断认为适用于这些付款的所有适用 这些附加条款自生效日期开始生效，在您参与本计划期间保持有效。 #### 6.2. 暂停。 暂停。 -如果您以任何方式违反这些附加条款或协议、被列入受限制贸易清单或者常住于美国外国资产管制办公室 (OFAC) 实施全面制裁的国家或地区，GitHub 可能会立即暂停您的被赞助开发者帐户。 Office of Foreign Assets Control (OFAC). 未能纠正或解决暂停原因可能导致您的被赞助开发者帐户被终止。 +如果您以任何方式违反这些附加条款或协议、被列入受限制贸易清单或者常住于美国外国资产管制办公室 (OFAC) 实施全面制裁的国家或地区，GitHub 可能会立即暂停您的被赞助开发者帐户。 外国资产管制办公室 (OFAC)。 未能纠正或解决暂停原因可能导致您的被赞助开发者帐户被终止。 #### 6.3. 终止。 终止。 任何一方都可以随时终止这些附加条款和您的被赞助开发者帐户，可以出于任何理由或无理由，可以通知或不通知。 如果您违反了这些附加条款或协议，我们可能会（但没有义务）为您提供一段时间来解决违规问题。 @@ -171,10 +171,10 @@ GitHub 承诺遵守根据合理判断认为适用于这些付款的所有适用 #### 7.1. 完整协议。 完整协议。 这些附加条款，以及协议、GitHub 政策、GitHub 隐私声明和适用于不同商品化选项的任何附加条款，构成了您与 GitHub 之间的完整协议。 -#### 7.2. Changes to the Terms. +#### 7.2. 条款的变更。 我们保留随时自行修改这些附加条款的权利。如果这些附加条款发生重大变更，例如价格变动，我们将在变更生效之前至少 30 天在我们的网站上发布通知，以便您知晓。 您继续参与本计划即表示您同意我们对这些附加条款的修订。 在我们的[站点政策](https://github.com/github/site-policy)仓库中可查看这些条款的所有变更。 -#### 7.3. 第三方受益人。 Third Party Beneficiaries. +#### 7.3. 第三方受益人。 第三方受益人。 除非明确说明，否则除当事方之外的任何人、公司、团体或企业，均不得因这些附加条款中包含的任何内容而被视为已获得任何权利。 #### 7.4. 独立缔约方。 独立缔约方. diff --git a/translations/zh-CN/content/github/site-policy/github-statement-against-modern-slavery-and-child-labor.md b/translations/zh-CN/content/github/site-policy/github-statement-against-modern-slavery-and-child-labor.md index 775129693d4c..6a41c279bc4c 100644 --- a/translations/zh-CN/content/github/site-policy/github-statement-against-modern-slavery-and-child-labor.md +++ b/translations/zh-CN/content/github/site-policy/github-statement-against-modern-slavery-and-child-labor.md @@ -42,7 +42,7 @@ GitHub 的供应链包括用于我们产品和运营的商品和服务，包括 **GitHub 的行为标准**禁止不安全和非法的行为，包括故意使用、参与、支持或容忍现代奴隶制（奴役、强迫或强制劳动、贩运、压榨以及监禁或以契约束缚劳动者）或童工。 -GitHub 遵守其运营所在辖区中禁止贩运劳工和使用童工的法律，包括[关于打击人口贩运的美国联邦采购法规 22.17](https://www.govinfo.gov/content/pkg/CFR-2009-title48-vol1/pdf/CFR-2009-title48-vol1-part22-subpart22-17.pdf)。 Federal Acquisition Regulation 22.17 on combatting human trafficking. +GitHub 遵守其运营所在辖区中禁止贩运劳工和使用童工的法律，包括[关于打击人口贩运的美国联邦采购法规 22.17](https://www.govinfo.gov/content/pkg/CFR-2009-title48-vol1/pdf/CFR-2009-title48-vol1-part22-subpart22-17.pdf)。 关于打击人口贩运的联邦采购法规 22.17。 此外，GitHub 与 FairHotel 计划建立了合作伙伴关系，这意味着 GitHub 鼓励其员工选择 FairHotel 认可的酒店，因为这种酒店的工人工资合理、福利充足且在工作中有发言权。 成为 FairHotel 合作伙伴，也意味着 GitHub 作为公平雇主为酒店提供业务。 diff --git a/translations/zh-CN/content/github/site-policy/github-subprocessors-and-cookies.md b/translations/zh-CN/content/github/site-policy/github-subprocessors-and-cookies.md index c05a5afdb7f1..18e7b2797426 100644 --- a/translations/zh-CN/content/github/site-policy/github-subprocessors-and-cookies.md +++ b/translations/zh-CN/content/github/site-policy/github-subprocessors-and-cookies.md @@ -18,61 +18,75 @@ GitHub 在如何使用您的数据、如何收集您的数据以及与谁分享 我们与第三方子处理商（例如我们的供应商和服务提供商）分享您的信息时，我们仍对您的信息负责。 我们在引入新供应商时，会竭尽所能保持您的信任，并且要求所有供应商与我们签订数据保护协议，以约束他们对用户个人信息（定义见[隐私声明](/articles/github-privacy-statement/)）的处理。 -| 子处理商名称 | 处理说明 | 处理地点 | Corporate Location | -| ------------------ | ------------------------------- | ---- | ------------------ | -| Automattic | 博客服务 | 美国 | 美国 | -| AWS Amazon | 数据托管 | 美国 | 美国 | -| Braintree (PayPal) | 订阅费用信用卡支付处理商 | 美国 | 美国 | -| Clearbit | 营销数据充实服务 | 美国 | 美国 | -| Discourse | 社区论坛软件提供商 | 美国 | 美国 | -| DiscoverOrg | 营销数据充实服务 | 美国 | 美国 | -| Eloqua | 营销活动自动化 | 美国 | 美国 | -| Google Apps | 公司内部基础设施 | 美国 | 美国 | -| Google Analytics | 网站分析和性能 | 美国 | 美国 | -| LinkedIn Navigator | 营销数据充实服务 | 美国 | 美国 | -| Magic Robot | 活动报告（Salesforce 加载项） | 美国 | 美国 | -| MailChimp | 客户事件单邮件服务提供商 | 美国 | 美国 | -| Mailgun | 交易邮件服务提供商 | 美国 | 美国 | -| Microsoft | Microsoft Services | 美国 | 美国 | -| Monday.com | 团队协作和项目管理平台 | 美国 | 以色列 | -| Nexmo | 短信通知提供商 | 美国 | 美国 | -| Oracle | 公司财务系统 | 美国 | 美国 | -| Salesforce.com | 客户关系管理 | 美国 | 美国 | -| Sendgrid | 交易邮件服务提供商 | 美国 | 美国 | -| Sentry.io | Application monitoring provider | 美国 | 美国 | -| Stripe | 支付服务提供商 | 美国 | 美国 | -| Twilio | 短信通知提供商 | 美国 | 美国 | -| Zendesk | 客户支持事件单系统 | 美国 | 美国 | -| Zuora | 公司计费系统 | 美国 | 美国 | +| 子处理商名称 | 处理说明 | 处理地点 | 公司地点 | +|:------------------ |:-------------------- |:---- |:---- | +| Automattic | 博客服务 | 美国 | 美国 | +| AWS Amazon | 数据托管 | 美国 | 美国 | +| Braintree (PayPal) | 订阅费用信用卡支付处理商 | 美国 | 美国 | +| Clearbit | 营销数据充实服务 | 美国 | 美国 | +| Discourse | 社区论坛软件提供商 | 美国 | 美国 | +| DiscoverOrg | 营销数据充实服务 | 美国 | 美国 | +| Eloqua | 营销活动自动化 | 美国 | 美国 | +| Google Apps | 公司内部基础设施 | 美国 | 美国 | +| Google Analytics | 网站分析和性能 | 美国 | 美国 | +| LinkedIn Navigator | 营销数据充实服务 | 美国 | 美国 | +| Magic Robot | 活动报告（Salesforce 加载项） | 美国 | 美国 | +| MailChimp | 客户事件单邮件服务提供商 | 美国 | 美国 | +| Mailgun | 交易邮件服务提供商 | 美国 | 美国 | +| Microsoft | Microsoft 服务 | 美国 | 美国 | +| Monday.com | 团队协作和项目管理平台 | 美国 | 以色列 | +| Nexmo | 短信通知提供商 | 美国 | 美国 | +| Oracle | 公司财务系统 | 美国 | 美国 | +| Salesforce.com | 客户关系管理 | 美国 | 美国 | +| Sendgrid | 交易邮件服务提供商 | 美国 | 美国 | +| Sentry.io | 应用程序监控提供商 | 美国 | 美国 | +| Stripe | 支付服务提供商 | 美国 | 美国 | +| Twilio | 短信通知提供商 | 美国 | 美国 | +| Zendesk | 客户支持事件单系统 | 美国 | 美国 | +| Zuora | 公司计费系统 | 美国 | 美国 | 在我们引入新的子处理商来处理用户个人信息、删除子处理商或更改使用子处理商的方式时，我们将更新本页面。 如果您对新的子处理商有疑问或疑虑，我们乐意提供帮助。 请通过 {% data variables.contact.contact_privacy %} 联系我们。 ### GitHub 上的 Cookie -GitHub 使用 cookie 让服务交互变得简单而有意义。 我们使用 cookie（以及类似技术，例如 HTML5 localStorage）保持您的登录状态、记住您的首选项、为 GitHub 的未来开发提供信息，并在第三方网站上向您宣传 GitHub 的产品和服务。 - -Cookie 是我们 web 服务器存储在您的计算机或移动设备上的一小段文本，当您返回我们的站点时，您的浏览器会将其发送给我们。 如果您只是访问 GitHub，cookie 不一定能识别您的身份。但是，cookie 可以为每个登录用户存储唯一的标识符。 我们使用 cookie 保持您的登录状态、记住您的首选项，并为 GitHub 的未来开发提供信息。 出于安全原因，我们使用 cookie 来识别设备。 使用我们的网站，即表示您同意我们将这些类型的 cookie 放在您的计算机或设备上。 如果您禁止浏览器或设备接受这些 cookie，则将无法登录或使用 GitHub 的服务。 在网站的某些区域，我们还可能使用 Cookie 来识别您和/或您的设备，以便在第三方网站上向您宣传 GitHub 产品和服务。 - -GitHub 出于以下原因在用户设备上放置以下 cookie： - -| Cookie 名称 | 原因 | -| ------------------------------------ | ------------------------------------------------------- | -| `user_session` | 此 cookie 用于您的登录。 | -| `logged_in` | 此 cookie 用于向我们表明用户已登录。 | -| `dotcom_user` | 此 cookie 用于向我们表明用户已登录。 | -| `_gh_sess` | 此 cookie 用于表明页面之间的临时应用程序和框架状态，例如用户在多步骤表单中处于哪一步。 | -| `tz` | 此 cookie 允许您的浏览器告诉我们您所在的时区。 | -| `gist_user_session` | 此 cookie 由 Gist 在单独主机上运行时使用。 | -| `saml_csrf_token` | 此 cookie 由 SAML 身份验证路径方法设置，以将令牌与客户端相关联。 | -| `saml_return_to` | 此 cookie 由 SAML 身份验证路径方法设置，以在 SAML 身份验证循环期间维持状态。 | -| `gist_oauth_csrf` | 此 cookie 由 Gist 设置，以确保启动 oauth 流的用户与完成它的用户是同一个用户。 | -| `__Host-user_session_same_site` | 此 cookie 设置为确保支持 SameSite cookie 的浏览器可以检查请求是否来自 GitHub。 | -| `__Host-gist_user_session_same_site` | 此 cookie 设置为确保支持 SameSite cookie 的浏览器可以检查请求是否来自 GitHub。 | -| `_ga` | 此 cookie 用于 Google Analytics。 | -| `_gat` | 此 cookie 用于 Google Analytics。 | -| `_gid` | 此 cookie 用于 Google Analytics。 | -| `_octo` | 此 cookie 被我们的内部分析服务 Octolytics 用来区分独特的用户和客户端。 | -| `tracker` | 此 cookie 跟踪注册分析的引用源。 | +GitHub 在如何使用您的数据、如何收集您的数据以及与谁分享您的数据方面提供很大的透明度。 为此，我们制作了本页面，详细介绍[我们的子处理商](#github-subprocessors)、我们如何使用 [cookie](#cookies-on-github)、在何处进行跟踪以及如何[在 GitHub 上执行跟踪](#tracking-on-github)。 + +Since the number and names of cookies may change,the table below may be updated from time to time. + +| Cookie 名称 | 原因 | 描述 | Expiration* | +|:----------------------------- |:------------------------------------ |:------------------------------------------------------------------------------------------------------------------------------------------ |:------------------------------------------------------------- | +| GitHub | `app_manifest_token` | 此 cookie 用于表明页面之间的临时应用程序和框架状态，例如用户在多步骤表单中处于哪一步。 | five minutes | +| GitHub | `cookie-preferences` | 此 cookie 用于向我们表明用户已登录。 | one year | +| GitHub | `_device_id` | 此 cookie 用于向我们表明用户已登录。 | one year | +| GitHub | `dotcom_user` | 此 cookie 用于向我们表明用户已登录。 | one year | +| GitHub | `_gh_ent` | This cookie is used for temporary application and framework state between pages like what step the customer is on in a multiple step form. | two weeks | +| GitHub | `_gh_sess` | 此 cookie 用于表明页面之间的临时应用程序和框架状态，例如用户在多步骤表单中处于哪一步。 | 会话 | +| GitHub | `gist_oauth_csrf` | 此 cookie 由 Gist 设置，以确保启动 oauth 流的用户与完成它的用户是同一个用户。 | deleted when oauth state is validated | +| GitHub | `gist_user_session` | 此 cookie 由 Gist 在单独主机上运行时使用。 | two weeks | +| GitHub | `has_recent_activity` | This cookie is used to prevent showing the security interstitial to users that have visited the app recently. | one hour | +| GitHub | `__Host-gist_user_session_same_site` | 此 cookie 设置为确保支持 SameSite cookie 的浏览器可以检查请求是否来自 GitHub。 | two weeks | +| GitHub | `__Host-user_session_same_site` | 此 cookie 设置为确保支持 SameSite cookie 的浏览器可以检查请求是否来自 GitHub。 | two weeks | +| GitHub | `logged_in` | 此 cookie 用于向我们表明用户已登录。 | one year | +| GitHub | `marketplace_repository_ids` | 此 cookie 用于您的登录。 | one hour | +| GitHub | `marketplace_suggested_target_id` | 此 cookie 用于您的登录。 | one hour | +| GitHub | `_octo` | 此 cookie 被我们的内部分析服务 Octolytics 用来区分独特的用户和客户端。 | one year | +| GitHub | `org_transform_notice` | This cookie is used to provide notice during organization transforms. | one hour | +| GitHub | `github.com/personal` | 此 cookie 用于 Google Analytics。 | two weeks | +| GitHub | `saml_csrf_token` | 此 cookie 由 SAML 身份验证路径方法设置，以将令牌与客户端相关联。 | until user closes browser or completes authentication request | +| GitHub | `saml_csrf_token_legacy` | 此 cookie 由 SAML 身份验证路径方法设置，以将令牌与客户端相关联。 | until user closes browser or completes authentication request | +| GitHub | `saml_return_to` | 此 cookie 由 SAML 身份验证路径方法设置，以在 SAML 身份验证循环期间维持状态。 | until user closes browser or completes authentication request | +| GitHub | `saml_return_to_legacy` | 此 cookie 由 SAML 身份验证路径方法设置，以在 SAML 身份验证循环期间维持状态。 | until user closes browser or completes authentication request | +| GitHub | `tz` | 此 cookie 允许您的浏览器告诉我们您所在的时区。 | 会话 | +| GitHub | `user_session` | 此 cookie 用于您的登录。 | two weeks | +| 此 cookie 用于 Google Analytics。 | `_ga` | 此 cookie 用于 Google Analytics。 | two years | +| 此 cookie 用于 Google Analytics。 | `_gat` | 此 cookie 用于 Google Analytics。 | one minute | +| 此 cookie 用于 Google Analytics。 | `_gid` | 此 cookie 用于 Google Analytics。 | one day | + +_*_ GitHub 出于以下原因在用户设备上放置以下 cookie： + +_我们使用 Google Analytics 收集有关我们网站性能以及用户在总体上如何浏览和使用 GitHub 的信息。 这有助于我们评估用户对 GitHub 的使用情况；汇编关于活动的统计报告；以及改善我们的内容和网站性能。 + +You can control your Google Analytics cookie preferences through our cookie preference link located at the footer of our website. Google 提供有关其隐私实践的更多信息，并且[提供一个浏览器加载项，以供选择退出 Google Analytics 跟踪](https://tools.google.com/dlpage/gaoptout)。 我们网站上的某些页面可能会放置其他第三方的 cookie。 例如，我们可能会嵌入来自其他网站的内容（例如视频），而该网站可能放置 cookie。 虽然我们尽可能减少这些第三方 cookie，但我们无法始终控制这些第三方内容放置哪些 cookie。 @@ -80,32 +94,4 @@ GitHub 出于以下原因在用户设备上放置以下 cookie： “[别跟踪](https://www.eff.org/issues/do-not-track)”(DNT) 是有一种隐私首选项，如果您不希望在线服务（特别是广告网络）通过第三方跟踪服务收集和分享有关您在线活动的某类信息，您可以在浏览器中设置该选项。 GitHub 响应浏览器的 DNT 信号，并遵循[关于响应 DNT 信号的 W3C 标准](https://www.w3.org/TR/tracking-dnt/)。 如果您要设置浏览器以传达不希望被跟踪的信号，请查看浏览器的文档以了解如何启用该信号。 还有一些很适合阻止在线跟踪的应用程序，例如 [Privacy Badger](https://www.eff.org/privacybadger)。 -如果您没有在支持 DNT 的浏览器上启用 DNT，则我们网站某些部分的 cookie 会长期跟踪您在其他在线服务上的在线浏览活动，不过，我们不允许我们分析和服务提供商以外的第三方长期跟踪 GitHub 用户在 GitHub 上的活动。 我们使用这些 cookie 以便我们在第三方网站和服务上向您宣传 GitHub 产品和服务。 我们还与某些供应商签订了协议，例如分析供应商，他们帮助我们在网站的某些页面上跟踪访客的活动。 只有代表我们收集个人信息的供应商，才能在我们的页面上收集数据，并且我们与每个此类供应商都签订了数据保护协议。 我们利用从这些供应商处获得的数据，更好地了解访客的兴趣、网站的性能并改善我们的内容。 任何分析供应商都将列入上文的子处理商列表中，您还可以在下文查看收集此类数据的所有页面列表。 - -#### Google Analytics - -我们使用 Google Analytics 作为第三方分析服务，并跟踪我们在第三方网站和服务上的广告宣传活动。 我们使用 Google Analytics 收集有关我们网站性能以及用户在总体上如何浏览和使用 GitHub 的信息。 这有助于我们评估用户对 GitHub 的使用情况；汇编关于活动的统计报告；以及改善我们的内容和网站性能。 Google 提供有关其隐私实践的更多信息，并且[提供一个浏览器加载项，以供选择退出 Google Analytics 跟踪](https://tools.google.com/dlpage/gaoptout)。 - -#### GitHub 上可能启用分析的页面 - -在我们网站上，包含以下任何域和路径（包括任何子域或子路径）的 URL，其页面可能启用分析或其他跟踪代码。 如果要阻止我们收集有关您在 GitHub 上浏览活动的信息，您可以使用跟踪阻止程序，例如 [Privacy Badger](https://www.eff.org/privacybadger)，也可以选择退出 Google Analytics 跟踪。 - -- github.com/home （如果您已注销帐户或没有帐户，则访问 github.com 时会看到此页面） -- github.com/about -- github.blog -- github.com/enterprise -- github.com/collections -- github.com/developer-stories -- github.com/events -- github.com/explore -- github.com/features -- github.com/logos -- github.com/nonprofit -- github.com/open-source -- github.com/personal -- github.com/pricing -- github.com/ten -- github.com/trending -- resources.github.com -- de.github.com -- fr.github.com +如果您没有在支持 DNT 的浏览器上启用 DNT，则我们网站某些部分的 cookie 会长期跟踪您在其他在线服务上的在线浏览活动，不过，我们不允许我们分析和服务提供商以外的第三方长期跟踪 GitHub 用户在 GitHub 上的活动。 我们还与某些供应商签订了协议，例如分析供应商，他们帮助我们在网站的某些页面上跟踪访客的活动。 只有代表我们收集个人信息的供应商，才能在我们的页面上收集数据，并且我们与每个此类供应商都签订了数据保护协议。 我们利用从这些供应商处获得的数据，更好地了解访客的兴趣、网站的性能并改善我们的内容。 任何分析供应商都将列入上文的子处理商列表中，您还可以在下文查看收集此类数据的所有页面列表。 diff --git a/translations/zh-CN/content/github/site-policy/github-supplemental-terms-for-microsoft-volume-licensing.md b/translations/zh-CN/content/github/site-policy/github-supplemental-terms-for-microsoft-volume-licensing.md index 701c8851634c..2f20e2acfe99 100644 --- a/translations/zh-CN/content/github/site-policy/github-supplemental-terms-for-microsoft-volume-licensing.md +++ b/translations/zh-CN/content/github/site-policy/github-supplemental-terms-for-microsoft-volume-licensing.md @@ -7,7 +7,7 @@ versions: free-pro-team: '*' --- -Version Effective Date: July 20, 2020 +版本生效日期：2020 年 7 月 20 日 以下 GitHub 补充条款（包括任何适用的订单）用于补充客户的 Microsoft 批量许可协议（“**Microsoft 客户协议**”），并与 Microsoft 客户协议一起管辖客户对产品（定义见下文）的使用。 Microsoft 客户协议通过此引用并入本协议。 这些补充条款中使用但未定义的大写术语采用 Microsoft 客户协议中赋予的含义。 @@ -25,9 +25,9 @@ Version Effective Date: July 20, 2020 * 第 2 部分：GitHub Enterprise Cloud 服务条款； -* SECTION 3: General Provisions; and +* 第 3 部分：一般规定；以及 -* EXHIBIT A: Definitions. +* 附件 A：定义。 @@ -43,11 +43,11 @@ GitHub 授予客户非独占、不可转让、全球、免版税、有限期的 除了法律或适用的第三方许可明确允许之外，客户及其附属公司不得也不得允许任何第三方：(i) 再许可、销售、租赁、出租、转让、让渡或再分发软件；(ii) 出于第三方利益而托管软件；(iii) 披露或允许任何第三方访问软件，本第 1 部分明确许可的除外；(iv) 入侵或修改许可密钥，或者避开或更改任何许可注册过程；(v) 修改软件或创建派生作品，或者将软件与其他软件合并，客户修改除外；(vi) 反汇编、反编译、绕过任何代码混淆，或者对软件全部或部分进行逆向工程或尝试推导其任何源代码；(vii) 修改、遮盖或删除软件或文档中包含的任何所有权通告；或 (viii) 以这些 GitHub 补充条款未明确允许的其他方式使用或复制软件或文档。 -### 1.3 Delivery. +### 1.3 交付。 -GitHub 将在安全、有密码保护的网站提供许可密钥给客户下载。 All deliveries under this Section 1 will be electronic. 为避免疑问，客户负责安装任何软件，并承认 GitHub 在提供许可密钥后对软件没有进一步的交付义务。 当有更新时，GitHub 将放在同一网站上供下载。 客户必须在商业合理的基础上更新软件，但每年不少于一 (1) 次。 客户负责对其用户名和密码保密。 +GitHub 将在安全、有密码保护的网站提供许可密钥给客户下载。 本第 1 部分的所有交付都是电子形式。 为避免疑问，客户负责安装任何软件，并承认 GitHub 在提供许可密钥后对软件没有进一步的交付义务。 当有更新时，GitHub 将放在同一网站上供下载。 客户必须在商业合理的基础上更新软件，但每年不少于一 (1) 次。 客户负责对其用户名和密码保密。 -### 1.4 Verification. +### 1.4 验证。 在 GitHub 请求时，客户应及时向 GitHub 提供软件生成的报告，以便我们验证客户是否按照这些 GitHub 补充条款使用软件。 对于超出这些 GitHub 补充条款的任何其他使用，GitHub 将向客户开发票，从其首次使用之日起生效。 @@ -55,13 +55,13 @@ GitHub 将在安全、有密码保护的网站提供许可密钥给客户下载 GitHub 将根据 Microsoft 客户协议所述为软件提供技术支持。 GitHub 可能根据[支持条款](/enterprise/admin/enterprise-support/about-github-premium-support-for-github-enterprise)， 按照订单或 SOW 中指定的支持级别、费用和订阅期为软件和服务提供增强的支持服务（包括 Premium、Premium Plus 和工程直接支持服务）。 即使 Microsoft 客户协议中有任何相反的规定，(i) GitHub 也将尽合理努力更正客户反馈的软件中任何重大、可重现的错误，但在以下情况下不负责提供支持：(a) 有人（除 GitHub 之外）修改软件；(b) 客户以对软件或其性能不利的方式改变其操作系统或环境；(c) 客户以 Microsoft 客户协议、本第 1 条或文档中未授权的方式使用软件；或 (d) 客户意外事件或疏忽，或滥用软件；(ii) GitHub 仅在原始发布日期后一 (1) 年内或最后更新后六 (6) 个月内（以较晚者为准）支持特定发行版。 -### 1.6 Updates; Releases. +### 1.6 更新；发行版。 -#### 1.6.1 Generally. +#### 1.6.1 一般。 GitHub 将在客户下载软件和许可密钥的安全网站上提供软件的更新和发行版。 -#### 1.6.2 Supported Releases. +#### 1.6.2 支持的发行版。 对软件发行版，GitHub 只提供从原始发行日期起一 (1) 年的支持，或提供从发行版最近更新日期起六 (6) 个月的支持（取较长者）。 如果客户需要软件早期发行版的支持，必须根据共同商定的订单或 SOW 支付支持费用。 @@ -77,19 +77,19 @@ GitHub 将在客户下载软件和许可密钥的安全网站上提供软件的 GitHub 保证，自首次下载之日起九十 (90) 天内，未经修改的软件实质上符合其文档所述。 GitHub 不保证客户对软件的使用不会中断或者软件的运行没有错误。 如果客户以本第 1 部分和文档未明确允许的任何方式修改或使用软件，则此保证将不适用。 GitHub 因违反此有限保证而产生的唯一责任以及客户获得的唯一补偿将按照 Microsoft 客户协议中的规定。 -## SECTION 2: GITHUB ENTERPRISE CLOUD TERMS OF SERVICE +## 第 2 部分：GITHUB ENTERPRISE CLOUD 服务条款 -Upon creation of a Corporate Account and/or an Organization on the Service by Customer or by GitHub on Customer’s behalf, this Section 2 details terms applicable to Customer’s use of the Service. +当客户或 GitHub 代表客户在服务上创建公司帐户和/或组织时，本第 2 部分详述适用于客户使用服务的条款。 -### 2.1 Account Terms. +### 2.1 帐户条款。 -#### 2.1.1 Account Controls. +#### 2.1.1 帐户控制。 **(i) 用户。**客户承认，用户对其个人帐户及其中的内容保留最终的管理控制权。 [GitHub 的标准服务条款](/github/site-policy/github-terms-of-service)管辖用户对服务的使用，但本第 2 部分下所述的用户活动除外。 - **(ii) 组织。**根据本第 2 部分，客户对代表客户创建的任何组织以及发布到其组织内仓库的用户生成内容具有最终管理控制权。 This Section 2 will govern the use of Customer’s Organization(s). + **(ii) 组织。**根据本第 2 部分，客户对代表客户创建的任何组织以及发布到其组织内仓库的用户生成内容具有最终管理控制权。 本第 2 部分将管辖客户组织的使用。 -#### 2.1.2 Account Requirements. +#### 2.1.2 帐户要求。 要创建帐户，客户必须符合以下条件： @@ -97,91 +97,91 @@ Upon creation of a Corporate Account and/or an Organization on the Service by Cu **(ii)** 用户登录名不能多人共享。 -**(iii)** Customer must not use the Service (a) in violation of export control or sanctions laws of the United States or any other applicable jurisdiction, (b) if it is located in or ordinarily resident in a country or territory subject to comprehensive sanctions administered by the U.S. Office of Foreign Assets Control (OFAC), or (c) if Customer is or is working on behalf of a [Specially Designated National (SDN)](https://www.treasury.gov/resource-center/sanctions/SDN-List/Pages/default.aspx) or a person subject to similar blocking or denied party prohibitions. For more information, please see [GitHub’s Trade Controls policy](/github/site-policy/github-and-trade-controls). +**(iii)** 客户在以下情况下不得使用服务 (a) 违反美国或任何其他司法管辖区的出口管制或制裁法律；(b) 如果位于或普通居住于遭受美国 “外国资产管制办公室”(OFAC) 全面制裁的国家或地区；或 (c) 如果客户是[特别指定的国民 (SDN)](https://www.treasury.gov/resource-center/sanctions/SDN-List/Pages/default.aspx) 或代表其工作，或者是遭受类似封锁或被拒绝方禁令的个人。 更多信息请参阅 [GitHub 的贸易管制政策](/github/site-policy/github-and-trade-controls)。 -#### 2.1.3 Account Security. +#### 2.1.3 帐户安全。 -客户负责：(i) 在其公司帐户下发布的所有内容和发生的活动；(ii) 保持其帐户登录凭据的安全；以及 (iii) 在获悉通过其帐户对服务的任何未授权使用或访问时及时[通知 GitHub](https://support.github.com/contact)。 GitHub will not be liable for any loss or damage from Customer’s failure to comply with this Section 2.1.3. +客户负责：(i) 在其公司帐户下发布的所有内容和发生的活动；(ii) 保持其帐户登录凭据的安全；以及 (iii) 在获悉通过其帐户对服务的任何未授权使用或访问时及时[通知 GitHub](https://support.github.com/contact)。 GitHub 对客户不遵守本第 2.1.3 所造成的任何损失或损害概不负责。 -#### 2.1.4 Additional Terms. +#### 2.1.4 其他条款。 在某些情况下，第三方的条款可能适用于客户对服务的使用。 例如，客户可能是本身具有条款或许可协议的组织的成员；客户可能下载与服务相集成的应用程序；或者，客户可能使用服务向另一项服务验证。 尽管 Microsoft 客户协议（包括这些 GitHub 补充条款）是 GitHub 与客户的完整协议，但其他方的条款将控制他们与客户的关系。 #### 2.1.5 U.S. 联邦政府条款。 5. 美国联邦政府条款. -If Customer is a U.S. 如果客户是美国联邦政府机构或者在政府部门访问或使用服务的任何部分，则[美国联邦政府修正](https://help.github.com/github/site-policy/amendment-to-github-terms-of-service-applicable-to-us-federal-government-users)适用，并且客户同意其条款。 Federal Government Amendment applies, and Customer agrees to its provisions. +如果客户是美国 如果客户是美国联邦政府机构或者在政府部门访问或使用服务的任何部分，则[美国联邦政府修正](https://help.github.com/github/site-policy/amendment-to-github-terms-of-service-applicable-to-us-federal-government-users)适用，并且客户同意其条款。 联邦政府修正适用，并且客户同意其条款。 -### 2.2 Compliance with Laws; Acceptable Use; Privacy. +### 2.2 遵守法律；可接受的使用；隐私。 -#### 2.2.1 Compliance with Laws and Regulations. +#### 2.2.1 遵守法律法规。 客户对服务的使用不得违反任何相关法律，包括版权法或商标法、出口管制法律或其司法管辖区的法规。 -#### 2.2.2 Acceptable Use. +#### 2.2.2 可接受的使用。 -Customer’s use of the Service must comply with [GitHub's Acceptable Use Policies](/github/site-policy/github-acceptable-use-policies) and [GitHub’s Community Guidelines](/github/site-policy/github-community-guidelines). 客户不得在任何司法管辖区将服务用于非法、淫秽、冒犯性或欺诈性内容或活动，例如鼓吹或造成伤害；干扰或违反网络或系统的完整性或安全性；避开过滤器；发送主动、辱骂或欺诈性消息、病毒或有害代码；或者违反第三方权利。 +客户对服务的使用必须遵守 [GitHub 可接受的使用政策](/github/site-policy/github-acceptable-use-policies)和 [GitHub 社区指导方针](/github/site-policy/github-community-guidelines)。 客户不得在任何司法管辖区将服务用于非法、淫秽、冒犯性或欺诈性内容或活动，例如鼓吹或造成伤害；干扰或违反网络或系统的完整性或安全性；避开过滤器；发送主动、辱骂或欺诈性消息、病毒或有害代码；或者违反第三方权利。 -#### 2.2.3 Privacy. -[The GitHub Privacy Statement](/github/site-policy/github-privacy-statement) and the [GitHub Data Protection Addendum](/github/site-policy/github-data-protection-addendum) provide detailed notice of GitHub's privacy and data use practices as well as GitHub's processing and security obligations with respect to Customer Personal Data. Any person, entity, or service collecting data from the Service must comply with the [GitHub Privacy Statement](/github/site-policy/github-privacy-statement), particularly in regards to the collection of Users' Personal Information (as defined in the GitHub Privacy Statement). 如果客户从 GitHub 收集任何用户个人信息，则客户仅将其用于外部用户已授权的目的。 客户将合理保护任何此类个人信息，并且客户会及时响应 GitHub 或外部用户的投诉、删除请求以及“不要联系”请求。 +#### 2.2.3 隐私。 +[GitHub 隐私声明](/github/site-policy/github-privacy-statement)和 [GitHub 数据保护附录](/github/site-policy/github-data-protection-addendum)详细介绍了 GitHub 的隐私保护和数据使用实践，以及 GitHub 在处理和保护客户个人数据方面的义务。 任何个人、实体或服务从服务收集数据都必须遵守 [GitHub 隐私声明](/github/site-policy/github-privacy-statement)，特别是收集用户个人信息（如“GitHub 隐私声明”中的定义）时。 如果客户从 GitHub 收集任何用户个人信息，则客户仅将其用于外部用户已授权的目的。 客户将合理保护任何此类个人信息，并且客户会及时响应 GitHub 或外部用户的投诉、删除请求以及“不要联系”请求。 -### 2.3 Content Responsibility; Ownership; License Rights. +### 2.3 内容责任；所有权；许可权利。 #### 2.3.1 关于用户生成内容的责任。 客户在使用服务时可能创建或上传用户生成的内容。 客户对其通过服务发布、上传、链接或以其他方式提供的用户生成内容独自负责，无论用户生成的内容是何种形式。 GitHub 对用户生成内容的任何公开显示或滥用概不负责。 -#### 2.3.2 Ownership of Content, Right to Post, and License Grants. +#### 2.3.2 内容所有权、发布权利和许可授予。 **(i)** 客户保留客户创建或拥有的客户内容的所有权。 客户承认：(a) 对客户内容负责，(b) 只会提供客户有权利发布的客户内容（包括第三方或用户生成的内容），以及 (c) 客户将完全遵守与客户发布的客户内容相关的任何第三方许可。 -**(ii)** Customer grants the rights set forth in Sections 2.3.3 through 2.3.6, free of charge and for the purposes identified in those sections until such time as Customer removes Customer Content from GitHub servers, except for Content Customer has posted publicly and that External Users have Forked, in which case the license is perpetual until such time as all Forks of Customer Content have been removed from GitHub servers. 如果客户上传的客户内容具有已经向 GitHub 授予运行服务所需的许可，则无需其他许可。 +**(ii)** 客户免费授予第 2.3.3 至 2.3.6 条所述的权利，用于这两条所述的目的，直到客户从 GitHub 服务器中删除客户内容，但公开发布以及外部用户已经复刻的内容除外，这些内容的有效期直到所有客户内容复刻从 GitHub 服务器中删除。 如果客户上传的客户内容具有已经向 GitHub 授予运行服务所需的许可，则无需其他许可。 -#### 2.3.3 License Grant to GitHub. +#### 2.3.3 向 GitHub 授予的许可。 客户向 GitHub 授予存储、剖析和显示客户内容的权利，并仅在提供服务需要时才创建偶尔的副本。 这些权利包括将客户内容复制到 GitHub 数据库和制作备份；向客户以及客户选择要向其显示内容的人员显示客户内容；将客户内容剖析为搜索索引或在 GitHub 的服务器上分析；与客户选择要共享的外部用户共享客户内容；以及执行客户内容，有点像音乐或视频一样。 这些权利适用于公共和私有仓库。 此许可并未向 GitHub 授予销售客户内容或者在服务外部分发或使用内容的权利。 客户向 GitHub 授予以无归属方式使用客户内容所需的权利，以及根据提供服务的需要对客户内容进行合理改编的权利。 -#### 2.3.4 License Grant to External Users. +#### 2.3.4 向外部用户授予的许可。 **(i)** 客户快速发布的任何内容，包括议题、评论以及对外部用户仓库的贡献，都可供其他人查看。 只要将其仓库设置为公开显示，即表示客户同意允许外部用户查看客户的仓库以及对其复刻。 -**(ii)** 如果客户将其页面和仓库设为公开显示，客户向外部用户授予非独占、全球许可，允许他们通过服务使用、显示和执行客户内容，以及通过 GitHub 提供的功能（例如通过复刻）只在服务上重制允许的客户内容。 Customer may grant further rights to Customer Content if Customer [adopts a license](/github/building-a-strong-community/adding-a-license-to-a-repository#including-an-open-source-license-in-your-repository). 如果客户上传其未创建或拥有的客户内容，则客户负责确保其上传的客户内容根据向外部用户授予这些许可的条款进行许可。 +**(ii)** 如果客户将其页面和仓库设为公开显示，客户向外部用户授予非独占、全球许可，允许他们通过服务使用、显示和执行客户内容，以及通过 GitHub 提供的功能（例如通过复刻）只在服务上重制允许的客户内容。 如果客户[采用许可](/github/building-a-strong-community/adding-a-license-to-a-repository#including-an-open-source-license-in-your-repository)，则可以授予对客户内容的更多权利。 如果客户上传其未创建或拥有的客户内容，则客户负责确保其上传的客户内容根据向外部用户授予这些许可的条款进行许可。 -#### 2.3.5 Contributions Under Repository License. +#### 2.3.5 仓库许可下的参与。 只要客户参与包含许可通告的仓库，则表示客户在相同的条款下许可该等参与，并且同意其有权利在这些条款下许可该等参与。 如果客户使用单独的协议在不同的条款下许可其参与，如参与者许可协议，则该协议优先。 -#### 2.3.6 Moral Rights. -客户对其上传、发布或提交到服务任何部分的客户内容保留所有精神权利，包括完整性和归属的权利。 However, Customer waives these rights and agrees not to assert them against GitHub, solely to enable GitHub to reasonably exercise the rights granted in Section 2.3, but not otherwise. +#### 2.3.6 精神权利。 +客户对其上传、发布或提交到服务任何部分的客户内容保留所有精神权利，包括完整性和归属的权利。 但客户对 GitHub 放弃这些权利并且同意不宣称这些权利，唯一目的是让 GitHub 合理行使第 2.3 条中宣称的权利，而没有任何其他目的。 ### 2.4 私有仓库。 -#### 2.4.1 Control. +#### 2.4.1 控制。 客户负责管理对其私有仓库的访问，包括邀请、组织和团队的管理控制以及访问的终止。 -#### 2.4.2 Confidentiality. +#### 2.4.2 保密。 GitHub 将客户私有仓库中的客户内容视为客户的机密信息。 GitHub 将根据 Microsoft 客户协议中适用的保密条款 ，对私有仓库的客户内容进行严格的保护和保密。 -#### 2.4.3 Access. +#### 2.4.3 访问。 GitHub 只能在以下情况下访问客户的私有仓库 (i) 经客户同意并确认，出于支持原因，或者 (ii) 出于安全原因而需要访问时。 客户可选择对其私有仓库启用其他访问权限。 例如，客户可向不同的 GitHub 服务或功能授予对私有仓库中客户内容的额外访问权限。 这些权利可能根据服务或功能而不同，但 GitHub 仍会将客户私有仓库中的客户内容视为客户的机密信息。 如果这些服务或功能除了提供服务所需的权限之前，还需要其他权限，GitHub 将会说明这些权限。 -#### 2.4.4 Exclusions. +#### 2.4.4 除外条款。 如果 GitHub 有理由认为私有仓库的内容违反法律或这些 GitHub 补充条款，则 GitHub 有权访问、审查和删除该内容。 此外，法律可能要求 GitHub 披露客户私有仓库中的内容。 除非法律要求另有约束或者是回应安全威胁或其他安全风险，否则 GitHub 对此类操作需发出通知。 -### 2.5. Intellectual Property Notices. +### 2.5. 知识产权通告。 -#### 2.5.1 GitHub's Rights to Content. +#### 2.5.1 GitHub 对内容的权利。 服务外观的版权归 © GitHub, Inc. 所有。 未经 GitHub 明确的书面许可，客户不得重复、复制或重复使用 HTML/CSS、Javascript 或者可视设计元素或概念的任何部分。 -#### 2.5.2 Copyright Infringement and DMCA Policy. +#### 2.5.2 版权侵权和 DMCA 政策。 如果客户是版权所有者，并且认为服务上的内容侵犯了其版权，则客户可根据 GitHub 的[数字千禧年版权法政策](https://github.com/contact/dmca)联系 GitHub - 通过其 [DMCA 表](https://github.com/contact/dmca-notice)联系 GitHub 或发电子邮件到 copyright@github.com。 -#### 2.5.3 GitHub Trademarks and Logos. +#### 2.5.3 GitHub 商标和徽标。 如果客户要使用 GitHub 的商标，客户必须遵守 GitHub 的所有商标指导方针，包括 [GitHub 徽标和使用页面](https://github.com/logos)中的政策。 -### 2.6 Suspension. +### 2.6 暂停。 在客户违反了 Microsoft 客户协议（包括这些 GitHub 补充条款）的情况下，或者 GitHub 出于保护服务的完整性、可操作性和安全性的目的，GitHub 有权随时暂停对服务的全部或任何部分的访问，暂停立即生效，可能通知，也可能不通知。 除非法律或法律程序禁止，或为了防止对服务或任何第三方迫在眉睫的伤害，否则 GitHub 通常会在此类暂停时或之前以横幅或电子邮件的形式提供通知。 GitHub 将根据需要自由裁量善意定制任何暂停，以保持服务的完整性、操作性和安全性。 @@ -189,13 +189,13 @@ GitHub 只能在以下情况下访问客户的私有仓库 (i) 经客户同意 出于合同目的，客户 (1) 同意通过其提交的电子邮件地址或通过服务接收电子形式的通信；和 (2) 同意 GitHub 以电子形式提供的所有服务条款、协议、通知、披露和其他通信可满足任何法律要求（如果以书面形式提供的这些通信可满足法律要求）。 本部分不影响客户不可放弃的权利。 -### 2.8 Service Level Agreement. +### 2.8 服务等级协议。 -GitHub’s quarterly uptime commitment for the Service is provided in the [Enterprise Service Level Agreement](/github/site-policy/github-enterprise-service-level-agreement). Customer will be entitled to a service credit if GitHub does not meet its service level. +GitHub 在[企业服务等级协议](/github/site-policy/github-enterprise-service-level-agreement)中提供了对服务的季度正常运行时间承诺。 如果 GitHub 不符合其服务等级，客户将有权获得服务积分。 -### 2.9 Service Changes. +### 2.9 服务更改。 -GitHub 通过更新和添加新功能来更改服务。 Subject to Section 2.8, GitHub reserves the right at any time to modify or discontinue, temporarily or permanently, the Service (or any part of it) with or without notice. +GitHub 通过更新和添加新功能来更改服务。 根据第 2.8 条，GitHub 保留随时临时或永久修改或中止服务（或其任何部分）的权利，可能通知或不通知。 ### 2.10 附加服务功能。 @@ -203,17 +203,17 @@ GitHub 通过更新和添加新功能来更改服务。 Subject to Section 2.8, ## 第 3 部分：一般规定。 -This Section 3 sets forth the terms and conditions applicable to Customer’s purchase and use of any of the Products. +第 3 部分规定适用于客户购买和使用任何产品的条款和条件。 ### 3.1 期限；终止；终止的影响。 -#### 3.1.1 Term. +#### 3.1.1 期限。 这些 GitHub 补充条款的有效期持续至一方根据本第 3.1 部分终止它们。 #### 3.1.2 为便利而终止；帐户注销。 任一方都可终止订单或这些 GitHub 补充条款，不需要理由，但必须在当前订阅期结束前至少三十 (30) 天发出书面通知。 如果客户选择终止订单或这些 GitHub 补充条款，则客户有责任在屏幕顶部全局导航栏的 Settings（设置）中正确注销其 GitHub 帐户。 GitHub 无法通过回复电子邮件或电话申请来注销帐户。 -#### 3.1.3 Termination for Material Breach. +#### 3.1.3 因实质违规而终止。 如果一方违反这些 GitHub 补充条款下的实质性义务并且在收到通知后三十 (30) 天内未弥补违规的影响，则另一方可在通知后立即终止这些 GitHub 补充条款。 如果客户的帐户被暂停超过 90天，GitHub 可能会终止这些 GitHub 补充条款。 #### 3.1.4 终止的影响。 @@ -228,7 +228,7 @@ This Section 3 sets forth the terms and conditions applicable to Customer’s pu ### 3.4 优先级 如果补充条款与订单之间发生冲突，则订单事项以订单为准。 如果补充条款（包括任何订单）与 Microsoft 客户协议之间发生冲突，则补充条款只管辖其主题事项。 -## EXHIBIT A: DEFINITIONS +## 附件 A：定义 **“活跃用户”**是指在断电时尝试访问服务的用户。 diff --git a/translations/zh-CN/content/github/site-policy/github-terms-of-service.md b/translations/zh-CN/content/github/site-policy/github-terms-of-service.md index c68f8e875e4d..62152dc82b45 100644 --- a/translations/zh-CN/content/github/site-policy/github-terms-of-service.md +++ b/translations/zh-CN/content/github/site-policy/github-terms-of-service.md @@ -69,7 +69,7 @@ versions: - 一个人或一个法律实体最多可以拥有一个免费帐户（如果您选择还控制一个机器帐户，没问题，但是它只能用于运行机器）。 - 用户必须年满 13 岁。 虽然我们很高兴看到优秀的年轻编码者热衷于学习编程，但我们必须遵守美国法律。 GitHub 并未针对 13 岁以下的儿童定制服务，因此我们不允许任何 13 岁以下的用户使用我们的服务。 如果我们发现任何用户未满 13 岁，我们将[立即终止该用户的帐户](#l-cancellation-and-termination)。 如果您是美国以外的国家/地区的居民，您所在国家/地区规定的最低年龄可能会更大；在这种情况下，您有责任遵守您所在国家/地区的法律。 - 您的登录名只能由一个人使用，即不允许多人共享一个登录名。 付费组织只能在订阅允许的范围内向多个用户帐户提供访问权限。 -- 不得违反美国或任何其他适用司法管辖区的出口管制或制裁法律使用 GitHub。 如果您是[特别指定国民 (SDN)](https://www.treasury.gov/resource-center/sanctions/SDN-List/Pages/default.aspx)或被美国政府机构实施的类似封锁或被拒方禁令所限制的个人，或者代表他们工作，则您不得使用 GitHub。 government agency. GitHub 可能会根据美国政府的授权，允许某些受制裁国家或地区的人访问某些 GitHub 服务。 government authorizations. 更多信息请参阅我们的[出口管制政策](/articles/github-and-export-controls)。 +- 不得违反美国或任何其他适用司法管辖区的出口管制或制裁法律使用 GitHub。 如果您是[特别指定国民 (SDN)](https://www.treasury.gov/resource-center/sanctions/SDN-List/Pages/default.aspx)或被美国政府机构实施的类似封锁或被拒方禁令所限制的个人，或者代表他们工作，则您不得使用 GitHub。 政府机构。 GitHub 可能会根据美国政府的授权，允许某些受制裁国家或地区的人访问某些 GitHub 服务。 政府授权。 更多信息请参阅我们的[出口管制政策](/articles/github-and-export-controls)。 #### 4. 用户帐户安全 在使用我们的服务时，您负责维护您的帐户安全。 我们提供双重身份验证等工具，帮助您维护帐户的安全性，但您的帐户内容及其安全性取决于您。 @@ -98,7 +98,7 @@ versions: 您在使用服务时可能创建或上传用户生成的内容。 对于您发布、上传、链接或通过服务提供的任何用户生成内容，无论内容的形式如何，您对其内容以及由此造成的任何伤害负有全部责任。 我们对用户生成内容的任何公开显示或滥用概不负责。 #### 2. GitHub 可删除内容 -We do not pre-screen User-Generated Content, but we have the right (though not the obligation) to refuse or remove any User-Generated Content that, in our sole discretion, violates any [GitHub terms or policies](/github/site-policy). +我们不预先筛选用户生成的内容，但我们有权利（但没有义务）拒绝或删除单方面认为违反了任何 [GitHub 条款或政策](/github/site-policy)的任何用户生成内容。 #### 3. 内容所有权、发布权利和许可授予 您对您的内容保有所有权和责任。 如果您发布不是您自己创建或者您没有所有权的内容，则您同意对您发布的任何内容负责；您只会提交您有权发布的内容；并且您将完全遵守与您发布的内容有关的任何第三方许可。 diff --git a/translations/zh-CN/content/github/site-policy/githubs-notice-about-the-california-consumer-privacy-act.md b/translations/zh-CN/content/github/site-policy/githubs-notice-about-the-california-consumer-privacy-act.md index 755892d70f59..7fed60b717be 100644 --- a/translations/zh-CN/content/github/site-policy/githubs-notice-about-the-california-consumer-privacy-act.md +++ b/translations/zh-CN/content/github/site-policy/githubs-notice-about-the-california-consumer-privacy-act.md @@ -54,7 +54,7 @@ CCPA 禁止企业对行使 CCPA 下任何权利的加州居民进行歧视，包 ## 我们对个人信息的处理 -While the table below contains information about the categories of personal information we collect process and share, please see the [GitHub Privacy Statement](/github/site-policy/github-privacy-statement) for full details. +虽然下表包含有关我们收集、处理和分享的个人信息类别的信息，但要了解更详细的信息还请参阅 [GitHub 隐私声明](/github/site-policy/github-privacy-statement)。 | **过去 12 个月内收集的个人信息类别** | **个人信息收集来源的类别** | **收集个人信息的业务或商业目的** | **与之分享个人信息的第三方类别** | **出于业务或商业目的而披露的个人信息类别** | | ----------------------------------------------------------------------------------------------------------- | ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -62,7 +62,7 @@ While the table below contains information about the categories of personal info | 加州 民事 法典 §1798.80 第 (e) 小节所述的任何类别的个人信息（将“个人信息”定义为“识别、关联、描述或能够关联特定个人的任何信息”- 示例包括姓名、地址、信用卡或借记卡号码 - 但不包括公开的信息） | 消费者直接提供的信息 | 指控应对恶意、欺骗、欺诈或非法活动负责的人。

    代表业务或服务提供商执行服务 | 服务提供商、执法部门 | 出于业务或商业目的而披露了此类个人信息 | | 加州或联邦法律下受保护的分类特征（例如性别、年龄） | 消费者可选择直接提供的信息 | 执行服务（用户个人资料） | 服务提供商 | 出于业务或商业目的而披露了此类个人信息 | | 商业信息（例如有关购买、获取或考虑的产品或服务的信息，或其他购买或消费历史记录或趋势的信息） | 消费者直接提供的信息，或者在与我们服务交互的过程中自动提供的信息 | 进行调试以识别和修复有损现有预期功能的错误

    代表业务或服务提供商执行服务 | 服务提供商 | 出于业务或商业目的而披露了此类个人信息 | | Internet 或其他电子网络活动信息（例如浏览历史记录、搜索历史记录以及有关消费者与 Internet 网站或应用程序交互的信息） | 消费者在与我们服务交互的过程中自动提供的信息 | 检测安全事件，防范恶意、欺骗、欺诈或非法活动，并指控应对此类活动负责的人

    进行调试以识别和修复有损现有预期功能的错误

    代表业务或服务提供商执行服务

    进行内部研究以支持技术开发和演示

    开展活动以验证或维护服务的质量或安全性，以及改善、升级或增强服务 | 服务提供商、适用的客户、执法部门 | 出于业务或商业目的而披露了此类个人信息 | - 地理位置数据（如 IP 地址）| 消费者通过与我们服务的互动自动提供的信息 | 检测安全事件，防范恶意、欺骗性、欺诈性或非法活动，以及起诉对该活动负责的人员

    调试以识别和修复损害现有预期功能的错误

    代表企业或服务提供商提供服务

    进行技术开发和演示的内部研究

    开展活动，以验证或维护服务质量或安全，以及改进、升级或增强服务 | 服务提供商、适用的客户、执法部门 | 出于业务或商业目的而披露了此类个人信息 | 音频、电子、视觉或类似信息 | 消费者可选择直接提供的信息 | 执行服务（用户配置文件）| 服务提供商 | 出于业务或商业目的而披露了此类个人信息 | 专业或就业相关信息 | 消费者可选择直接提供的信息 | 执行服务（用户配置文件）| 服务提供商 | 出于业务或商业目的而披露了此类个人信息 | 非公开的个人身份教育信息 | 此类个人信息已披露用于业务或商业目的 | 《家庭教育权利和隐私法》(20 U.S.C. Sec. 1232g; 34 C.F.R. Part 99) 中定义的信息 | 消费者可选择直接提供的信息 | 执行服务（用户个人资料） | 服务提供商 | 出于业务或商业目的而披露了此类个人信息 | 从此表中标识的任何信息中得出推论，以创建反映消费者偏好的消费者个人资料 | 消费者直接提供的信息，或者在与我们服务交互的过程中自动提供的信息 | 代表业务或服务提供商执行服务 | 服务提供商 | 出于业务或商业目的而披露了此类个人信息 | Sec. 1232g; 34 C.F.R. Part 99) | Information consumer may choose to provide directly | Performing services (user profile) | Service providers | This category of personal information has been disclosed for a business or commercial purpose | Inferences drawn from any of the information identified in this table to create a profile about a consumer reflecting the consumer’s preferences | Information consumer provides directly or automatically through their interaction with our Services | Performing services on behalf of the business or service provider | Service providers | This category of personal information has been disclosed for a business or commercial purpose | + 地理位置数据（如 IP 地址）| 消费者通过与我们服务的互动自动提供的信息 | 检测安全事件，防范恶意、欺骗性、欺诈性或非法活动，以及起诉对该活动负责的人员

    调试以识别和修复损害现有预期功能的错误

    代表企业或服务提供商提供服务

    进行技术开发和演示的内部研究

    开展活动，以验证或维护服务质量或安全，以及改进、升级或增强服务 | 服务提供商、适用的客户、执法部门 | 出于业务或商业目的而披露了此类个人信息 | 音频、电子、视觉或类似信息 | 消费者可选择直接提供的信息 | 执行服务（用户配置文件）| 服务提供商 | 出于业务或商业目的而披露了此类个人信息 | 专业或就业相关信息 | 消费者可选择直接提供的信息 | 执行服务（用户配置文件）| 服务提供商 | 出于业务或商业目的而披露了此类个人信息 | 非公开的个人身份教育信息 | 此类个人信息已披露用于业务或商业目的 | 《家庭教育权利和隐私法》(20 U.S.C. Sec. 1232g; 34 C.F.R. Part 99) 中定义的信息 | 消费者可选择直接提供的信息 | 执行服务（用户个人资料） | 服务提供商 | 出于业务或商业目的而披露了此类个人信息 | 从此表中标识的任何信息中得出推论，以创建反映消费者偏好的消费者个人资料 | 消费者直接提供的信息，或者在与我们服务交互的过程中自动提供的信息 | 代表业务或服务提供商执行服务 | 服务提供商 | 出于业务或商业目的而披露了此类个人信息 | Sec. 1232g; 34 C.F.R. Part 99) 中定义的信息 | 消费者可选择直接提供的信息 | 执行服务（用户个人资料） | 服务提供商 | 出于业务或商业目的而披露了此类个人信息 | 从此表中标识的任何信息中得出推论，以创建反映消费者偏好的消费者个人资料 | 消费者直接提供的信息，或者在与我们服务交互的过程中自动提供的信息 | 代表业务或服务提供商执行服务 | 服务提供商 | 出于业务或商业目的而披露了此类个人信息 | ## CCPA 下的豁免 diff --git a/translations/zh-CN/content/github/site-policy/global-privacy-practices.md b/translations/zh-CN/content/github/site-policy/global-privacy-practices.md index ad967d61cda6..a90ae9e03ba7 100644 --- a/translations/zh-CN/content/github/site-policy/global-privacy-practices.md +++ b/translations/zh-CN/content/github/site-policy/global-privacy-practices.md @@ -7,27 +7,27 @@ versions: free-pro-team: '*' --- -Effective date: July 22, 2020 +生效日期：2020 年 7 月 22 日。 -GitHub provides the same high standard of privacy protection—as described in GitHub’s [Privacy Statement](/github/site-policy/github-privacy-statement#githubs-global-privacy-practices)—to all our users and customers around the world, regardless of their country of origin or location, and GitHub is proud of the level of notice, choice, accountability, security, data integrity, access, and recourse we provide. +如 GitHub 的[隐私声明](/github/site-policy/github-privacy-statement#githubs-global-privacy-practices)所述，GitHub 为世界各地的所有用户和客户提供同样的高标准隐私保护，不论其原籍国或所在地，GitHub 为我们提供的通知、选择、问责、安全、数据完整性、访问和追索水准而感到自豪。 -GitHub also complies with certain legal frameworks relating to the transfer of data from the European Economic Area, the United Kingdom, and Switzerland (collectively, “EU”) to the United States. When GitHub engages in such transfers, GitHub relies on Standard Contractual Clauses as the legal mechanism to help ensure your rights and protections travel with your personal information. In addition, GitHub is certified to the EU-US and Swiss-US Privacy Shield Frameworks. To learn more about the European Commission’s decisions on international data transfer, see this article on the [European Commission website](https://ec.europa.eu/info/law/law-topic/data-protection/international-dimension-data-protection_en). +GitHub 还遵守有关从欧洲经济区、英国和瑞士（统称为"欧盟"）向美国传输数据的某些法律框架。 进行此类传输时，GitHub 依赖标准合同条款作为法律机制，以帮助确保您的权利和保护与您的个人信息同行。 此外，GitHub 还通过了欧盟-美国和瑞士-美国隐私盾框架的认证。 要了解有关欧洲委员会关于国际数据传输之决定的更多信息，请参阅[欧洲委员会网站](https://ec.europa.eu/info/law/law-topic/data-protection/international-dimension-data-protection_en)上的这篇文章。 -### Standard Contractual Clauses +### 标准合同条款 -GitHub relies on the European Commission-approved Standard Contractual Clauses (“SCCs”) as a legal mechanism for data transfers from the EU. SCCs are contractual commitments between companies transferring personal data, binding them to protect the privacy and security of such data. GitHub adopted SCCs so that the necessary data flows can be protected when transferred outside the EU to countries which have not been deemed by the European Commission to adequately protect personal data, including protecting data transfers to the United States. +GitHub 依靠欧洲委员会批准的标准合同条款 (“SCCs”) 作为从欧盟转移数据的法律机制。 SCCs 是公司之间转移个人数据的合同承诺，约束他们保护这些数据的隐私和安全。 GitHub 采用了 SCCs，以便将数据从欧盟转移到被欧洲委员会视为无法充分保护个人数据（包括保护向美国的数据转移）的国家/地区时，可以保护必要的数据流。 -To learn more about SCCs, see this article on the [European Commission website](https://ec.europa.eu/info/law/law-topic/data-protection/international-dimension-data-protection/standard-contractual-clauses-scc_en). +要了解有关 SCCs 的更多信息，请参阅[欧洲委员会网站](https://ec.europa.eu/info/law/law-topic/data-protection/international-dimension-data-protection/standard-contractual-clauses-scc_en)上的这篇文章。 ### 隐私盾框架 -GitHub is certified to the EU-US and Swiss-US Privacy Shield Frameworks and the commitments they entail, although GitHub does not rely on the EU-US Privacy Shield Framework as a legal basis for transfers of personal information in light of the judgment of the Court of Justice of the EU in Case C-311/18. +GitHub 已通过了欧盟-美国和瑞士-美国隐私盾框架及其所含承诺的认证，尽管 GitHub 并不依赖欧盟-美国隐私盾框架作为个人信息转移的法律依据（根据欧盟法院在 C-311/18 案中的判决）。 -The EU-US and Swiss-US Privacy Shield Frameworks are set forth by the US Department of Commerce regarding the collection, use, and retention of User Personal Information transferred from the European Union, the UK, and Switzerland to the United States. GitHub 已通过美国商务部遵守隐私盾原则的认证。 If our vendors or affiliates process User Personal Information on our behalf in a manner inconsistent with the principles of either Privacy Shield Framework, GitHub remains liable unless we prove we are not responsible for the event giving rise to the damage. +欧盟-美国和瑞士-美国隐私盾框架是美国商务部针对从欧盟、英国和瑞士转移到美国的用户个人信息之收集、使用和保留而制定的框架。 GitHub 已通过美国商务部遵守隐私盾原则的认证。 如果我们的供应商或关联公司处理用户个人信息的方式与任一隐私盾框架的原则不一致，则除非我们证明我们对造成损害的事件没有责任，否则 GitHub 仍会负责。 -For purposes of our certifications under the Privacy Shield Frameworks, if there is any conflict between the terms in these Global Privacy Practices and the Privacy Shield Principles, the Privacy Shield Principles shall govern. 要详细了解隐私盾原则和查看我们的认证，请访问[隐私盾网站](https://www.privacyshield.gov/)。 +为尊重我们在隐私盾框架下的认证，如果这些全球隐私实践中的条款与隐私盾原则之间存在任何冲突，以隐私盾原则为准。 要详细了解隐私盾原则和查看我们的认证，请访问[隐私盾网站](https://www.privacyshield.gov/)。 -The Privacy Shield Frameworks are based on seven principles, and GitHub adheres to them in the following ways: +隐私盾框架基于七项原则，GitHub 通过以下方式遵循这些原则： - **通知** - 我们在收集您的个人信息时会通知您。 @@ -59,7 +59,7 @@ The Privacy Shield Frameworks are based on seven principles, and GitHub adheres #### 争议解决流程 -As further explained in the [Resolving Complaints](/github/site-policy/github-privacy-statement#resolving-complaints) section of our [Privacy Statement](/github/site-policy/github-privacy-statement), we encourage you to contact us should you have a Privacy Shield-related (or general privacy-related) complaint. For any complaints that cannot be resolved with GitHub directly, we have selected to cooperate with the relevant EU Data Protection Authority, or a panel established by the European data protection authorities, for resolving disputes with EU individuals, and with the Swiss Federal Data Protection and Information Commissioner (FDPIC) for resolving disputes with Swiss individuals. 如果您需要适用的数据保护当局联系人的信息，请联系我们。 +如我们的[隐私声明](/github/site-policy/github-privacy-statement)中[解决投诉](/github/site-policy/github-privacy-statement#resolving-complaints)部分所述，如果您有与隐私盾相关（或与一般隐私保护相关）的投诉，建议您联系我们。 对于 GitHub 无法直接解决的任何投诉，我们会选择与相关的欧盟数据保护当局或他们成立的小组合作，解决与欧盟人士的争议；与瑞士联邦数据保护和信息专员 (FDPIC) 合作，解决与瑞士人士的争议。 如果您需要适用的数据保护当局联系人的信息，请联系我们。 此外，如果您是欧盟成员国的居民，您有权向当地监管机构提出投诉。 @@ -67,6 +67,6 @@ As further explained in the [Resolving Complaints](/github/site-policy/github-pr 在某些有限的情况下，如果所有其他形式的争议解决均未成功，作为最后手段，欧盟、欧洲经济区 (EEA)、瑞士和英国人士可以诉诸具有约束力的隐私盾仲裁。 要详细了解这种解决方法及其适用性，请认真阅读[隐私盾](https://www.privacyshield.gov/article?id=ANNEX-I-introduction)。 仲裁不是强制性的；它是您可以选择使用的工具。 -We are subject to the jurisdiction of the US Federal Trade Commission (FTC). +我们受美国联邦贸易委员会 (FTC) 的管辖。 更多信息请参阅我们的[隐私声明](/articles/github-privacy-statement/)。 diff --git a/translations/zh-CN/content/github/site-policy/guide-to-submitting-a-dmca-counter-notice.md b/translations/zh-CN/content/github/site-policy/guide-to-submitting-a-dmca-counter-notice.md index 4694955470c5..f69282737299 100644 --- a/translations/zh-CN/content/github/site-policy/guide-to-submitting-a-dmca-counter-notice.md +++ b/translations/zh-CN/content/github/site-policy/guide-to-submitting-a-dmca-counter-notice.md @@ -10,17 +10,17 @@ versions: 本指南介绍 GitHub 处理 DMCA 删除请求反通知所需的信息。 如果您对 DMCA 的概念或 GitHub 处理 DMCA 删除请求的方式有更多一般性疑问，请参阅我们的 [DMCA 删除政策](/articles/dmca-takedown-policy)。 -如果您认为 DMCA 删除请求误禁了您在 GitHub 上的内容，您有权通过提交反通知来反对删除。 如果您这样做，我们将等待 10-14 天，然后重新启用您的内容，除非版权所有者在此之前对您提起法律诉讼。 下述反通知形式与 DMCA 法规建议的形式一致，您可以登录美国版权局官方网站： 查看该法规。 Copyright Office's official website: . +如果您认为 DMCA 删除请求误禁了您在 GitHub 上的内容，您有权通过提交反通知来反对删除。 如果您这样做，我们将等待 10-14 天，然后重新启用您的内容，除非版权所有者在此之前对您提起法律诉讼。 下述反通知形式与 DMCA 法规建议的形式一致，您可以登录美国版权局官方网站： 查看该法规。 版权局官方网站：。 与所有法律事务一样，就您的具体问题或情况咨询专业人员始终是最好的方式。 我们强烈建议您在采取任何可能影响您权利的行动之前这样做。 本指南不是法律意见，也不应作为法律意见。 ### 开始前 -***说实话。***DMCA 要求您对自己的反通知宣誓，如有不实会*受到伪证处罚*。 在宣誓声明中故意说谎是一种联邦罪行 。 (*See* [U.S. Code, Title 18, Section 1621](https://www.gpo.gov/fdsys/pkg/USCODE-2011-title18/html/USCODE-2011-title18-partI-chap79-sec1621.htm).) （*请参阅* [美国法典，第 18 章，第 1621 条](https://www.gpo.gov/fdsys/pkg/USCODE-2011-title18/html/USCODE-2011-title18-partI-chap79-sec1621.htm)。） 提交虚假信息还可能导致民事责任，也就是说，可能被诉经济赔偿。 +***说实话。***DMCA 要求您对自己的反通知宣誓，如有不实会*受到伪证处罚*。 在宣誓声明中故意说谎是一种联邦罪行 。 （*请参阅* [美国 法典，第 18 章，第 1621 条](https://www.gpo.gov/fdsys/pkg/USCODE-2011-title18/html/USCODE-2011-title18-partI-chap79-sec1621.htm)。） （*请参阅* [美国法典，第 18 章，第 1621 条](https://www.gpo.gov/fdsys/pkg/USCODE-2011-title18/html/USCODE-2011-title18-partI-chap79-sec1621.htm)。） 提交虚假信息还可能导致民事责任，也就是说，可能被诉经济赔偿。 ***调查。***提交 DMCA 反通知可能会产生现实的法律后果。 如果投诉方不同意其删除通知有误，他们可自行决定对您提起诉讼以求继续禁用内容。 在提交反通知之前，您应该对删除通知中的指控进行彻底的调查，并在必要时咨询律师。 -***You Must Have a Good Reason to Submit a Counter Notice.*** In order to file a counter notice, you must have "a good faith belief that the material was removed or disabled as a result of mistake or misidentification of the material to be removed or disabled." ([U.S. Code, Title 17, Section 512(g)](https://www.copyright.gov/title17/92chap5.html#512).) Whether you decide to explain why you believe there was a mistake is up to you and your lawyer, but you *do* need to identify a mistake before you submit a counter notice. 我们在过去收到的反通知中，列举了一些删除通知中的错误，例如：投诉方没有版权；我有许可；该代码已在允许我使用的开源许可下发布；或投诉方没有考虑这一事实：我的使用受到合理使用原则的保护。 当然，删除通知中可能还有其他缺陷。 +***必须有充分的理由提交反通知。*** 要提交反通知，您必须“真正认为您的材料被删除或禁用是因为投诉有误或材料标识错误。” （[美国 法典，第 17 章，第 512(g) 条](https://www.copyright.gov/title17/92chap5.html#512)。） 是否要解释您认为存在错误的原因，取决于您和您的律师，但是在提交反通知之前，您*必须*找出错误。 我们在过去收到的反通知中，列举了一些删除通知中的错误，例如：投诉方没有版权；我有许可；该代码已在允许我使用的开源许可下发布；或投诉方没有考虑这一事实：我的使用受到合理使用原则的保护。 当然，删除通知中可能还有其他缺陷。 ***版权法很复杂。***有时，删除通知可能以比较奇怪或间接的方式指控侵权。 版权法很复杂，可能会导致一些意想不到的结果。 在某些情况下，删除通知可能基于您的源代码在进行编译和运行后能够执行的操作，而指控它侵权。 例如： - 通知可能声称您的软件用于[规避版权作品的访问控制](https://www.copyright.gov/title17/92chap12.html)。 diff --git a/translations/zh-CN/content/github/site-policy/guide-to-submitting-a-dmca-takedown-notice.md b/translations/zh-CN/content/github/site-policy/guide-to-submitting-a-dmca-takedown-notice.md index 63f60f31b005..e01e10ae39d9 100644 --- a/translations/zh-CN/content/github/site-policy/guide-to-submitting-a-dmca-takedown-notice.md +++ b/translations/zh-CN/content/github/site-policy/guide-to-submitting-a-dmca-takedown-notice.md @@ -10,13 +10,13 @@ versions: 本指南介绍 GitHub 处理 DMCA 删除请求所需的信息。 如果您对 DMCA 的概念或 GitHub 处理 DMCA 删除请求的方式有更多一般性疑问，请参阅我们的 [DMCA 删除政策](/articles/dmca-takedown-policy)。 -鉴于 GitHub 托管内容的类型（主要是软件代码）以及管理内容的方式（使用 Git），我们需要投诉内容尽可能具体。 这些指南旨在尽可能简单明了地处理指控侵权的通告。 下述通告形式与 DMCA 法规建议的形式一致，您可以登录美国版权局官方网站： 查看该法规。 Copyright Office's official website: . +鉴于 GitHub 托管内容的类型（主要是软件代码）以及管理内容的方式（使用 Git），我们需要投诉内容尽可能具体。 这些指南旨在尽可能简单明了地处理指控侵权的通告。 下述通告形式与 DMCA 法规建议的形式一致，您可以登录美国版权局官方网站： 查看该法规。 版权局官方网站：。 与所有法律事务一样，就您的具体问题或情况咨询专业人员始终是最好的方式。 我们强烈建议您在采取任何可能影响您权利的行动之前这样做。 本指南不是法律意见，也不应作为法律意见。 ### 开始前 -***说实话。***DMCA 要求您对版权投诉中陈述的事实宣誓，捏造事实会*受到伪证处罚*。 在宣誓声明中故意说谎是一种联邦罪行 。 (*See* [U.S. Code, Title 18, Section 1621](https://www.gpo.gov/fdsys/pkg/USCODE-2011-title18/html/USCODE-2011-title18-partI-chap79-sec1621.htm).) （*请参阅* [美国法典，第 18 章，第 1621 条](https://www.gpo.gov/fdsys/pkg/USCODE-2011-title18/html/USCODE-2011-title18-partI-chap79-sec1621.htm)。） 提交虚假信息还可能导致民事责任，也就是说，可能被诉经济赔偿。 DMCA 本身就针对任何故意捏造材料或活动侵权事实的人[规定了赔偿条款](https://en.wikipedia.org/wiki/Online_Copyright_Infringement_Liability_Limitation_Act#%C2%A7_512(f)_Misrepresentations)。 +***说实话。***DMCA 要求您对版权投诉中陈述的事实宣誓，捏造事实会*受到伪证处罚*。 在宣誓声明中故意说谎是一种联邦罪行 。 （*请参阅* [美国 法典，第 18 章，第 1621 条](https://www.gpo.gov/fdsys/pkg/USCODE-2011-title18/html/USCODE-2011-title18-partI-chap79-sec1621.htm)。） （*请参阅* [美国法典，第 18 章，第 1621 条](https://www.gpo.gov/fdsys/pkg/USCODE-2011-title18/html/USCODE-2011-title18-partI-chap79-sec1621.htm)。） 提交虚假信息还可能导致民事责任，也就是说，可能被诉经济赔偿。 DMCA 本身就针对任何故意捏造材料或活动侵权事实的人[规定了赔偿条款](https://en.wikipedia.org/wiki/Online_Copyright_Infringement_Liability_Limitation_Act#%C2%A7_512(f)_Misrepresentations)。 ***调查。***数以百万计的用户为自己在 GitHub 上创建和参与的项目倾注了心血。 针对此类项目提出 DMCA 投诉是一种严重的法律指控，会对项目背后真实的人造成真正的后果。 因此，我们要求您在提交删除通知之前进行彻底的调查并咨询律师，以确保您投诉的确实是不允许的使用。 diff --git a/translations/zh-CN/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md b/translations/zh-CN/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md index 6d307beda3b4..5a3769ddfc61 100644 --- a/translations/zh-CN/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md +++ b/translations/zh-CN/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md @@ -125,7 +125,7 @@ versions: 请注意，可用的信息因个案而异。 用户可选择提供一些信息。 在另一些情况下，我们可能没有收集或保留信息。 - -**有法院命令*或*搜查令** — 我们不会披露帐户访问日志，除非收到以下指令的要求： (i) 根据 18 U.S.C. 第 2703(d) 条签发的法院命令，有具体而明确的事实表明，有合理的理由相信所要求的信息与正在进行的刑事调查有关； 或 (ii) 根据《联邦刑事诉讼规定》(Federal Rules of Criminal Procedure) 或同等国家搜查程序签发的搜查令，上面显示可能的原因。 Section 2703(d), upon a showing of specific and articulable facts showing that there are reasonable grounds to believe that the information sought is relevant and material to an ongoing criminal investigation; or (ii) a search warrant issued under the procedures described in the Federal Rules of Criminal Procedure or equivalent state warrant procedures, upon a showing of probable cause. 除了上述非公开用户帐户信息之外，我们根据法院命令或搜查令提供的帐户访问日志信息可能包括： +**有法院命令*或*搜查令** — 我们不会披露帐户访问日志，除非收到以下指令的要求： (i) 根据 18 U.S.C. 第 2703(d) 条签发的法院命令，有具体而明确的事实表明，有合理的理由相信所要求的信息与正在进行的刑事调查有关； 或 (ii) 根据《联邦刑事诉讼规定》(Federal Rules of Criminal Procedure) 或同等国家搜查程序签发的搜查令，上面显示可能的原因。 第 2703(d) 条签发的法院命令，有具体而明确的事实表明，有合理的理由相信所要求的信息与正在进行的刑事调查有关； 或 (ii) 根据《联邦刑事诉讼规定》(Federal Rules of Criminal Procedure) 或同等国家搜查程序签发的搜查令，上面显示可能的原因。 除了上述非公开用户帐户信息之外，我们根据法院命令或搜查令提供的帐户访问日志信息可能包括： - 显示用户在一段时间内移动的任何日志 - 帐户或私有版本库设置(例如，哪些用户拥有特定权限等） @@ -149,7 +149,7 @@ versions: ### 数据保存 -We will take steps to preserve account records for up to 90 days upon formal request from U.S. law enforcement in connection with official criminal investigations, and pending the issuance of a court order or other process. +在美国执法部门发出与官方刑事调查相关的正式要求后， 以及签发法院命令或其他程序之前，我们将采取步骤保存长达 90 天的帐户记录。 ### 提交请求 @@ -177,7 +177,7 @@ Sacramento, CA 95833-3505 ### 外国执法部门的请求 -作为一家设在加利福尼亚的美国公司，GitHub 不必根据外国当局签发的法律程序向外国政府提供数据。 希望向 GitHub 索取信息的外国执法官员应与美国司法部刑事司国际事务办公室联系。 GitHub 将迅速答复美国法院通过司法互助条约（“MLAT）或委托调查书发出的请求。 court by way of a mutual legal assistance treaty (“MLAT”) or letter rogatory. +作为一家设在加利福尼亚的美国公司，GitHub 不必根据外国当局签发的法律程序向外国政府提供数据。 希望向 GitHub 索取信息的外国执法官员应与美国司法部刑事司国际事务办公室联系。 GitHub 将迅速答复美国法院通过司法互助条约（“MLAT）或委托调查书发出的请求。 法院通过司法互助条约（“MLAT）或委托调查书发出的请求。 ### 问题 diff --git a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors-for-open-source-contributors.md b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors-for-open-source-contributors.md index 6c6ff18835f7..756a62b095f4 100644 --- a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors-for-open-source-contributors.md +++ b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors-for-open-source-contributors.md @@ -1,6 +1,6 @@ --- title: 关于开源贡献者的 GitHub Sponsors -intro: 如果您为开源项目提供价值，可以成为被赞助的贡献者，您的工作将获得付款。 +intro: '如果您为开源项目提供价值，可以成为被赞助的贡献者，您的工作将获得付款。' redirect_from: - /articles/about-github-sponsors-for-sponsored-developers - /github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors-for-sponsored-developers @@ -10,11 +10,11 @@ versions: ### 加入 {% data variables.product.prodname_sponsors %} -{% data reusables.sponsors.you-can-be-a-sponsored-developer %} For more information, see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)." +{% data reusables.sponsors.you-can-be-a-sponsored-developer %} 更多信息请参阅“[为用户帐户设置 {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)”。 -{% data reusables.sponsors.you-can-be-a-sponsored-organization %} For more information, see "[Setting up {% data variables.product.prodname_sponsors %} for your organization](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization)." +{% data reusables.sponsors.you-can-be-a-sponsored-organization %} 更多信息请参阅“[为组织设置 {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization)”。 -After you join {% data variables.product.prodname_sponsors %}, you can add a sponsor button to the open source repository you contribute to, to increase the visibility of your {% data variables.product.prodname_sponsors %} profile and other funding platforms. 更多信息请参阅“[在仓库中显示赞助按钮](/articles/displaying-a-sponsor-button-in-your-repository)”。 +加入 {% data variables.product.prodname_sponsors %} 之后，您可以为您参与的开源项目添加赞助按钮，以提高您的 {% data variables.product.prodname_sponsors %} 个人资料及其他资助平台的可见性。 更多信息请参阅“[在仓库中显示赞助按钮](/articles/displaying-a-sponsor-button-in-your-repository)”。 您可以为赞助设定目标。 更多信息请参阅“[管理您的赞助目标](/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship-goal)”。 @@ -22,7 +22,7 @@ After you join {% data variables.product.prodname_sponsors %}, you can add a spo ### 赞助级别 -{% data reusables.sponsors.tier-details %} For more information, see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)," "[Setting up {% data variables.product.prodname_sponsors %} for your organization](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization), and "[Changing your sponsorship tiers](/articles/changing-your-sponsorship-tiers)." +{% data reusables.sponsors.tier-details %} 更多信息请参阅“[为用户帐户设置 {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)”、“[为组织设置 {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization)”和“[更改赞助级别](/articles/changing-your-sponsorship-tiers)”。 ### 赞助付款 diff --git a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors.md b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors.md index da3cdcf471ab..4638b7ce3445 100644 --- a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors.md +++ b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors.md @@ -13,7 +13,7 @@ versions: {% data reusables.sponsors.you-can-be-a-sponsored-developer %} 更多信息请参阅“[关于开源贡献者的 {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors-for-open-source-contributors)”和“[为用户帐户设置 {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)”。 -{% data reusables.sponsors.you-can-be-a-sponsored-organization %} For more information, see "[Setting up {% data variables.product.prodname_sponsors %} for your organization](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization)." +{% data reusables.sponsors.you-can-be-a-sponsored-organization %} 更多信息请参阅“[为组织设置 {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization)”。 当您成为受赞助的开发者或组织时，{% data variables.product.prodname_sponsors %} 的附加条款适用。 更多信息请参阅“[GitHub Sponsors 附加条款](/github/site-policy/github-sponsors-additional-terms)”。 @@ -21,11 +21,11 @@ versions: {% note %} -**注意：** {% data reusables.sponsors.matching-fund-eligible %} +**注：**{% data reusables.sponsors.matching-fund-eligible %} {% endnote %} -{% data variables.product.prodname_matching_fund %} 旨在使 {% data variables.product.prodname_dotcom %} 社区开发开源软件的成员获益，宣传 [{% data variables.product.prodname_dotcom %} 社区指导方针](/github/site-policy/github-community-guidelines)。 Sponsored organizations are not eligible for {% data variables.product.prodname_matching_fund %}. +{% data variables.product.prodname_matching_fund %} 旨在使 {% data variables.product.prodname_dotcom %} 社区开发开源软件的成员获益，宣传 [{% data variables.product.prodname_dotcom %} 社区指导方针](/github/site-policy/github-community-guidelines)。 被赞助组织没有资格获得 {% data variables.product.prodname_matching_fund %}。 若要符合 {% data variables.product.prodname_matching_fund %} 的资格，您必须创建吸引社区长期维持您发展的个人资料。 有关创建有吸引力的个人资料的更多信息，请参阅“[编辑 {% data variables.product.prodname_sponsors %} 的个人资料详细信息](/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors)”。 @@ -33,11 +33,11 @@ versions: ### 共享关于 {% data variables.product.prodname_sponsors %} 的反馈 -This is just the beginning — we'd love your input to make sure {% data variables.product.prodname_sponsors %} serves your needs into the future. Please send us your feedback or suggestions by contacting [{% data variables.contact.github_support %}](https://support.github.com/contact?form%5Bsubject%5D=GitHub+Sponsors). +这只是开始 - 我们欢迎大家提供意见，确保 {% data variables.product.prodname_sponsors %} 满足您未来的需求。 请联系 [{% data variables.contact.github_support %}](https://support.github.com/contact?form%5Bsubject%5D=GitHub+Sponsors)，向我们发送您的反馈或建议。 -Currently, only individual users can sponsor developers and organizations. If your organization is interested in sponsoring developers, please let us know by contacting [{% data variables.contact.github_support %}](https://support.github.com/contact?form%5Bsubject%5D=GitHub+Sponsors). +目前只有个人用户可以赞助开发者和组织。 如果您的组织有兴趣赞助开发者，请联系 [{% data variables.contact.github_support %}](https://support.github.com/contact?form%5Bsubject%5D=GitHub+Sponsors)。 ### 延伸阅读 - "[赞助开源贡献者](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-open-source-contributors)" -- "[Receiving sponsorships through {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/receiving-sponsorships-through-github-sponsors)" +- "[通过 {% data variables.product.prodname_sponsors %} 接受赞助](/github/supporting-the-open-source-community-with-github-sponsors/receiving-sponsorships-through-github-sponsors)" - {% data variables.product.prodname_blog %} 上的“[{% data variables.product.prodname_sponsors %} 团队常见问题](https://github.blog/2019-06-12-faq-with-the-github-sponsors-team/)” diff --git a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/changing-your-sponsorship-tiers.md b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/changing-your-sponsorship-tiers.md index f4cdb196be46..bbe04958b630 100644 --- a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/changing-your-sponsorship-tiers.md +++ b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/changing-your-sponsorship-tiers.md @@ -1,6 +1,6 @@ --- title: 更改赞助等级 -intro: 您可以添加新的赞助等级，也可以编辑或撤销现有等级。 +intro: '您可以添加新的赞助等级，也可以编辑或撤销现有等级。' redirect_from: - /articles/changing-your-sponsorship-tiers versions: diff --git a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/configuring-webhooks-for-events-in-your-sponsored-account.md b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/configuring-webhooks-for-events-in-your-sponsored-account.md index a36a8c22a6da..d949f4b43853 100644 --- a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/configuring-webhooks-for-events-in-your-sponsored-account.md +++ b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/configuring-webhooks-for-events-in-your-sponsored-account.md @@ -5,7 +5,7 @@ versions: free-pro-team: '*' --- -To monitor changes to your sponsorships, such as cancellations at the end of a pay period, you can create webhooks for your sponsored user or organization account. When you set up a webhook for your sponsored user or organization account, you'll receive updates when sponsorships are created, edited, or deleted. 更多信息请参阅 [`sponsorship` web 挂钩事件](/webhooks/event-payloads/#sponsorship)。 +要监视赞助变更，例如在付款期结束时取消，您可以为被赞助的用户或组织帐户创建 web 挂钩。 为被赞助的用户或组织帐户创建 web 挂钩后，在创建、编辑或删除赞助时您将会收到更新消息。 更多信息请参阅 [`sponsorship` web 挂钩事件](/webhooks/event-payloads/#sponsorship)。 ### 管理被赞助用户帐户的 web 挂钩 @@ -21,7 +21,7 @@ To monitor changes to your sponsorships, such as cancellations at the end of a p ### 管理被赞助组织的 web 挂钩 -Organization owners can configure webhooks for a sponsored organization. +组织所有者可以为被赞助组织配置 web 挂钩。 {% data reusables.sponsors.navigate-to-org-sponsors-dashboard %} {% data reusables.sponsors.navigate-to-webhooks-tab %} diff --git a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/contacting-your-sponsors.md b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/contacting-your-sponsors.md index 791c524d179f..9d3c641d557e 100644 --- a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/contacting-your-sponsors.md +++ b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/contacting-your-sponsors.md @@ -9,7 +9,7 @@ versions: 您的赞助者可选择是否接收有关您工作更新的电子邮件。 更多信息请参阅“[管理您的赞助](/articles/managing-your-sponsorship)”。 -The update will come from your user account's primary email address or organization account's `noreply@github.com` email address. If you've enabled email address privacy on your user account, the update will come from `noreply@github.com` instead. 更多信息请参阅“[设置提交电子邮件地址](/articles/setting-your-commit-email-address)”。 +更新邮件将从用户帐户的主电子邮件地址或组织帐户的 `noreply@github.com` 电子邮件地址发出。 如果您对用户帐户启用了电子邮件地址保密，则更新邮件将从 `noreply@github.com` 发出。 更多信息请参阅“[设置提交电子邮件地址](/articles/setting-your-commit-email-address)”。 ### 联系您的用户帐户的赞助者 diff --git a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors.md b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors.md index 5f82d03f2c3e..d49a907552d1 100644 --- a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors.md +++ b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors.md @@ -27,7 +27,7 @@ versions: {% data reusables.sponsors.opt-in-to-being-featured %} {% data reusables.sponsors.save-profile %} -### Editing your sponsored organization profile +### 编辑被赞助组织资料 {% data reusables.sponsors.navigate-to-org-sponsors-dashboard %} {% data reusables.sponsors.navigate-to-profile-tab %} diff --git a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/index.md b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/index.md index e071fc202870..10838749ac37 100644 --- a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/index.md +++ b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/index.md @@ -1,7 +1,7 @@ --- title: 通过 GitHub 赞助者支持开源社区 shortTitle: GitHub 赞助者 -intro: 'You can support the people and organizations who design, build, and maintain the open source projects you depend on by compensating them via {% data variables.product.prodname_dotcom %}.' +intro: '您可以通过 {% data variables.product.prodname_dotcom %} 提供赞助，以支持设计、构建和维护开源项目的个人和组织。' redirect_from: - /categories/supporting-the-open-source-community-with-github-sponsors versions: diff --git a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship.md b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship.md index 79e71d27a2ae..6343cb48b3b8 100644 --- a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship.md +++ b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship.md @@ -34,7 +34,7 @@ versions: ### 管理被赞助组织的电子邮件更新 -You can choose whether a sponsored organization can send you email updates about their work. The sponsored organization will not have access to your email address. +您可以选择被赞助组织能否以电子邮件向您发送其工作的更新。 被赞助组织无法访问您的电子邮件地址。 {% data reusables.sponsors.navigate-to-sponsored-org %} {% data reusables.sponsors.manage-org-sponsorship %} diff --git a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/receiving-sponsorships-through-github-sponsors.md b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/receiving-sponsorships-through-github-sponsors.md index b46dc2c624a8..0ade1c1d65bd 100644 --- a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/receiving-sponsorships-through-github-sponsors.md +++ b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/receiving-sponsorships-through-github-sponsors.md @@ -1,7 +1,7 @@ --- title: 通过 GitHub Sponsors 接受赞助 shortTitle: 接受赞助 -intro: 'You or your organization can become a sponsored open source contributor to receive payments for your work, update your sponsorship details, and view and contact your sponsors.' +intro: '您或您的组织可以成为被赞助的开源贡献者，从而接受对您工作的付款、更新您的赞助详细信息以及查看和联系您的赞助者。' mapTopic: true redirect_from: - /articles/receiving-sponsorships-as-a-sponsored-developer diff --git a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md index f076747e33c1..e1cfbcec8381 100644 --- a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md +++ b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization.md @@ -15,7 +15,7 @@ versions: 收到邀请您的组织加入 {% data variables.product.prodname_sponsors %} 的邀请后，您可以完成以下步骤以成为被赞助的组织。 -To join {% data variables.product.prodname_sponsors %} as an individual contributor outside an organization, see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)." +要作为组织外部的个人贡献者加入 {% data variables.product.prodname_sponsors %}，请参阅“[为用户帐户设置 {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)”。 {% data reusables.sponsors.navigate-to-github-sponsors %} {% data reusables.sponsors.view-eligible-accounts %} @@ -50,7 +50,7 @@ To join {% data variables.product.prodname_sponsors %} as an individual contribu ### 提交您的银行信息 -作为被赞助组织，您必须在受支持的区域接收支付到组织专用银行帐户的赞助款。 您可以通过如 [Open Collective](https://opencollective.com/) 和 [Stripe Atlas](https://stripe.com/atlas) 之类的服务获得企业银行帐户。 {% data reusables.sponsors.stripe-supported-regions %} +作为被赞助组织，您必须在受支持的区域接收支付到组织专用银行帐户的赞助款。 您可以通过如 [Open Collective](https://opencollective.com/) 和 [Stripe Atlas](https://stripe.com/atlas) 之类的服务获得企业银行帐户。 您的组织合法经营的区域与您银行帐户所在的区域必须匹配。 为组织设置 {% data variables.product.prodname_sponsors %} 的人员也必须居住在同一受支持的区域。 {% data reusables.sponsors.stripe-supported-regions %} {% data reusables.sponsors.double-check-stripe-info %} @@ -71,7 +71,7 @@ To join {% data variables.product.prodname_sponsors %} as an individual contribu ### 在您的 {% data variables.product.prodname_dotcom %} 帐户上启用双重身份验证 (2FA)。 -Before your organization can become a sponsored organization, you must enable 2FA on your {% data variables.product.product_name %} account. 更多信息请参阅“[配置双重身份验证](/articles/configuring-two-factor-authentication)”。 +在您的组织成为被赞助的组织之前，您必须在 {% data variables.product.product_name %} 帐户上启用 2FA。 更多信息请参阅“[配置双重身份验证](/articles/configuring-two-factor-authentication)”。 ### 向 {% data variables.product.prodname_dotcom %} 提交申请以请求批准 @@ -82,4 +82,4 @@ Before your organization can become a sponsored organization, you must enable 2F ### 延伸阅读 - "[关于 {% data variables.product.prodname_sponsors %}](/articles/about-github-sponsors)" -- "[Receiving sponsorships through {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/receiving-sponsorships-through-github-sponsors)" +- "[通过 {% data variables.product.prodname_sponsors %} 接受赞助](/github/supporting-the-open-source-community-with-github-sponsors/receiving-sponsorships-through-github-sponsors)" diff --git a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md index 0f1df6609246..00145331b0f7 100644 --- a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md +++ b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account.md @@ -12,7 +12,7 @@ versions: {% data reusables.sponsors.you-can-be-a-sponsored-developer %} {% data reusables.sponsors.stripe-supported-regions %} -To join {% data variables.product.prodname_sponsors %} as an organization, see "[Setting up {% data variables.product.prodname_sponsors %} for your organization](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization)." +要作为组织加入 {% data variables.product.prodname_sponsors %}，请参阅“[为组织设置 {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization)”。 {% data reusables.sponsors.navigate-to-github-sponsors %} 2. 如果您是组织所有者，则有多个符合条件的帐户。 单击 **View your eligible accounts（查看符合条件的帐户）**，然后在帐户列表中找到您的用户帐户。 @@ -50,7 +50,7 @@ To join {% data variables.product.prodname_sponsors %} as an organization, see " ### 提交您的银行信息 -如果您居住在受支持的区域，可以按照这些说明创建 Stripe Connect 帐户来提交银行信息。 {% data reusables.sponsors.stripe-supported-regions %} +如果您居住在受支持的区域，可以按照这些说明创建 Stripe Connect 帐户来提交银行信息。 您居住的区域与您的银行帐户所在区域必须匹配。 {% data reusables.sponsors.stripe-supported-regions %} {% data reusables.sponsors.double-check-stripe-info %} diff --git a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor.md b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor.md index 1465d6381572..16552a350fe7 100644 --- a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor.md +++ b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-an-open-source-contributor.md @@ -1,6 +1,6 @@ --- title: 赞助开源贡献者 -intro: 您可以向设计、创建或维护您所依赖的开源项目的开发者或组织每月定期付款。 +intro: '您可以向设计、创建或维护您所依赖的开源项目的开发者或组织每月定期付款。' redirect_from: - /articles/sponsoring-a-developer - /articles/sponsoring-an-open-source-contributor @@ -13,23 +13,23 @@ versions: {% data reusables.sponsors.sponsorship-details %} {% data reusables.sponsors.no-fees %} 更多信息请参阅“[关于 {% data variables.product.prodname_sponsors %} 的计费](/articles/about-billing-for-github-sponsors)”。 -When you sponsor an open source contributor, the change will become effective immediately. {% data reusables.sponsors.prorated-sponsorship %} +当您赞助开源贡献者后，更改将立即生效。 {% data reusables.sponsors.prorated-sponsorship %} -If the sponsored open source contributor retires your tier, the tier will remain in place for you until you choose a different tier or cancel your subscription. 更多信息请参阅“[升级赞助](/articles/upgrading-a-sponsorship)”和“[降级赞助](/articles/downgrading-a-sponsorship)”。 +如果您赞助的开源贡献者退出您的等级，则您仍保留在该等级，直到您选择其他等级或取消订阅。 更多信息请参阅“[升级赞助](/articles/upgrading-a-sponsorship)”和“[降级赞助](/articles/downgrading-a-sponsorship)”。 -If the open source contributor you want to sponsor does not have a sponsored developer or organization profile, you can encourage the contributor to create a sponsored developer or organization profile. For more information, see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)" and "[Setting up {% data variables.product.prodname_sponsors %} for your organization](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization)." {% data variables.product.prodname_dotcom %} will send you the appropriate forms, notify you when they are due, and give you a reasonable amount of time to complete and send in the forms. +如果您想要赞助的开源贡献者没有被赞助开发者或组织资料，您可以鼓励该贡献者创建被赞助开发者或组织资料。 For more information, see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account)" and "[Setting up {% data variables.product.prodname_sponsors %} for your organization](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization)." {% data variables.product.prodname_dotcom %} will send you the appropriate forms, notify you when they are due, and give you a reasonable amount of time to complete and send in the forms. {% data reusables.sponsors.sponsorships-not-tax-deductible %} {% note %} -**Note:** {% data variables.product.prodname_dotcom %} is not responsible for how developers represent themselves nor does {% data variables.product.prodname_dotcom %} endorse any sponsored open source projects. The claims are solely the responsibility of the developer receiving the funds. Make sure you trust a person before offering a sponsorship. For more information, see the [{% data variables.product.prodname_sponsors %} Additional Terms](/github/site-policy/github-sponsors-additional-terms). +**注：**{% data variables.product.prodname_dotcom %} 对开发者如何介绍自己概不负责，{% data variables.product.prodname_dotcom %} 也不为任何被赞助的开源项目背书。 索赔由接受资助的开发者自行负责。 请确保在建立信任之后提供赞助。 更多信息请参阅 [{% data variables.product.prodname_sponsors %} 附加条款](/github/site-policy/github-sponsors-additional-terms)。 {% endnote %} ### 赞助开发者 -Before you can sponsor a developer, you must have a verified email address. 更多信息请参阅“[验证电子邮件地址](/github/getting-started-with-github/verifying-your-email-address)”。 +在赞助开发者之前，您必须拥有经过验证的电子邮件地址。 更多信息请参阅“[验证电子邮件地址](/github/getting-started-with-github/verifying-your-email-address)”。 1. 在 {% data variables.product.product_name %} 上，导航到您要赞助的人员的个人资料。 2. 在开发者的姓名下方，单击 **Sponsor（赞助）**。 ![赞助按钮](/assets/images/help/profile/sponsor-button.png) @@ -43,7 +43,7 @@ Before you can sponsor a developer, you must have a verified email address. 更 ### 赞助组织 -Before you can sponsor an organization, you must have a verified email address. 更多信息请参阅“[验证电子邮件地址](/github/getting-started-with-github/verifying-your-email-address)”。 +在赞助组织之前，您必须拥有经过验证的电子邮件地址。 更多信息请参阅“[验证电子邮件地址](/github/getting-started-with-github/verifying-your-email-address)”。 1. 在 {% data variables.product.product_name %} 上，导航到您要赞助的组织的页面。 2. 在组织名称旁边，单击 **Sponsor（赞助）**。 ![赞助按钮](/assets/images/help/sponsors/sponsor-org-button.png) diff --git a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/tax-information-for-github-sponsors.md b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/tax-information-for-github-sponsors.md index ae48bc0d199b..2e37eb46d7d7 100644 --- a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/tax-information-for-github-sponsors.md +++ b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/tax-information-for-github-sponsors.md @@ -8,7 +8,7 @@ versions: free-pro-team: '*' --- -如果您是美国的纳税人，则必须提交 W-9，然后才能收到付款。 如果您是美国以外任何其他地区的纳税人，则必须提交 W-8BEN，然后才能收到付款。 For more information, see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account#submitting-your-tax-information)" and "[Setting up {% data variables.product.prodname_sponsors %} for your organization](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization#submitting-your-tax-information)." {% data variables.product.prodname_dotcom %} will send you the appropriate forms, notify you when they are due, and give you a reasonable amount of time to complete and send in the forms. {% data variables.product.prodname_dotcom %} will send you the appropriate forms, notify you when they are due, and give you a reasonable amount of time to complete and send in the forms. +如果您是美国的纳税人，则必须提交 W-9，然后才能收到付款。 如果您是美国以外任何其他地区的纳税人，则必须提交 W-8BEN，然后才能收到付款。 For more information, see "[Setting up {% data variables.product.prodname_sponsors %} for your user account](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-user-account#submitting-your-tax-information)" and "[Setting up {% data variables.product.prodname_sponsors %} for your organization](/github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization#submitting-your-tax-information)." {% data variables.product.prodname_dotcom %} will send you the appropriate forms, notify you when they are due, and give you a reasonable amount of time to complete and send in the forms. {% data variables.product.prodname_dotcom %} 将向您发送适当的表格，在到期时通知您，并给您合理的时间填写和发送表格。 如果您是美国的纳税人并且在一个纳税年度内的收入超过 600 美元，{% data variables.product.prodname_dotcom %} 将在下一个日历年的 1 月 31 日之前向您发送 1099。 我们不为国际纳税人提供税表。 diff --git a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/viewing-your-sponsors-and-sponsorships.md b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/viewing-your-sponsors-and-sponsorships.md index 755768d535b4..96b4cfa5e1ad 100644 --- a/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/viewing-your-sponsors-and-sponsorships.md +++ b/translations/zh-CN/content/github/supporting-the-open-source-community-with-github-sponsors/viewing-your-sponsors-and-sponsorships.md @@ -7,13 +7,13 @@ versions: free-pro-team: '*' --- -You can view analytics on your current and past sponsorships, the payments you've received from sponsors, and events, such as cancellations and sponsor tier changes for your sponsorships. You can also view activity such as new sponsorships, changes to sponsorships, and canceled sponsorships. You can filter the list of activities by date. 您还可以导出帐户的赞助数据以 CSV 或 JSON 格式查看。 +您可以查看有关您当前和过去的赞助、从赞助者收到的付款以及事件（例如赞助取消和赞助等级变更）的分析。 您还可以查看新的赞助、赞助变更和赞助取消等活动。 您可以按日期过滤活动列表。 您还可以导出帐户的赞助数据以 CSV 或 JSON 格式查看。 您可以从赞助者仪表板获取所有这些信息。 ### 查看赞助者仪表板 -1. 在任何页面的右上角，单击您的个人资料照片，然后再单击 **{% data variables.product.prodname_sponsors %}**。 ![{% data variables.product.prodname_sponsors %} 按钮](/assets/images/help/sponsors/access-github-sponsors-dashboard.png) +1. 在任何页面的右上角，单击您的个人资料照片，然后单击 **{% data variables.product.prodname_sponsors %}**。 ![{% data variables.product.prodname_sponsors %} 按钮](/assets/images/help/sponsors/access-github-sponsors-dashboard.png) 2. 在显示的列表中，在要查看其赞助者的帐户或组织的右侧，单击 **Dashboard（仪表板）**。 ![开发者赞助者仪表板按钮](/assets/images/help/sponsors/dev-sponsors-dashboard-button.png) ### 查看您的赞助者和赞助 diff --git a/translations/zh-CN/content/github/teaching-and-learning-with-github-education/applying-for-an-educator-or-researcher-discount.md b/translations/zh-CN/content/github/teaching-and-learning-with-github-education/applying-for-an-educator-or-researcher-discount.md index 11cddc7fcb0b..5f9c8d62792b 100644 --- a/translations/zh-CN/content/github/teaching-and-learning-with-github-education/applying-for-an-educator-or-researcher-discount.md +++ b/translations/zh-CN/content/github/teaching-and-learning-with-github-education/applying-for-an-educator-or-researcher-discount.md @@ -17,8 +17,8 @@ versions: 要申请教育者或研究人员折扣，您必须： - 是教育者、教师或研究人员 -- Have a verifiable school-issued email address -- Upload documents that prove your school affiliation +- 具有学校分发的可验证电子邮件地址 +- 上传证明您的学校隶属关系文件 - 拥有 [{% data variables.product.prodname_dotcom %} 用户帐户](/articles/signing-up-for-a-new-github-account) ### 申请教育者或研究人员折扣 @@ -44,7 +44,7 @@ versions: {% data reusables.education.upgrade-page %} 1. 单击 {% octicon "plus" aria-label="The plus symbol" %} **Create an organization（创建组织）**。 ![创建组织按钮](/assets/images/help/education/create-org-button.png) -3. 阅读信息，然后单击 **Create organization（创建组织）**。 ![Create organization button](/assets/images/help/education/create-organization-button.png) +3. 阅读信息，然后单击 **Create organization（创建组织）**。 ![创建组织按钮](/assets/images/help/education/create-organization-button.png) 4. 在“Choose a plan（选择计划）”下，单击 **选择 {% data variables.product.prodname_free_team %}**。 5. 按照提示创建组织。 {% data reusables.education.upgrade-page %} diff --git a/translations/zh-CN/content/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository.md b/translations/zh-CN/content/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository.md index c82b713805cb..4d66c0d0ab76 100644 --- a/translations/zh-CN/content/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository.md +++ b/translations/zh-CN/content/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository.md @@ -10,7 +10,7 @@ versions: ### 关于私有仓库的数据使用 -When you enable data use for your private repository, you'll be able to access the dependency graph, where you can track your repository's dependencies and receive {% data variables.product.prodname_dependabot_short %} alerts when {% data variables.product.product_name %} detects vulnerable dependencies. 更多信息请参阅“[关于易受攻击的依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies#github-dependabot-alerts-for-vulnerable-dependencies)”。 +启用私有仓库的数据使用后，您可以访问依赖项图，从中可以跟踪仓库的依赖项，在 {% data variables.product.product_name %} 检测到漏洞依赖项时接收 {% data variables.product.prodname_dependabot_short %} 警报。 更多信息请参阅“[关于易受攻击的依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies#github-dependabot-alerts-for-vulnerable-dependencies)”。 ### 启用或禁用数据使用功能 @@ -27,4 +27,4 @@ When you enable data use for your private repository, you'll be able to access t - "[关于 {% data variables.product.prodname_dotcom %} 对数据的使用](/articles/about-github-s-use-of-your-data)" - "[查看和更新仓库中的漏洞依赖项](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)" -- "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)" +- "[管理仓库的安全和分析设置](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)" diff --git a/translations/zh-CN/content/github/using-git/about-git-subtree-merges.md b/translations/zh-CN/content/github/using-git/about-git-subtree-merges.md index 1639739ff6d1..3f5f21e89daf 100644 --- a/translations/zh-CN/content/github/using-git/about-git-subtree-merges.md +++ b/translations/zh-CN/content/github/using-git/about-git-subtree-merges.md @@ -4,7 +4,7 @@ redirect_from: - /articles/working-with-subtree-merge/ - /subtree-merge/ - /articles/about-git-subtree-merges -intro: 如果需要管理单一仓库中的多个项目，可以使用*子树合并*来处理所有引用。 +intro: '如果需要管理单一仓库中的多个项目，可以使用*子树合并*来处理所有引用。' versions: free-pro-team: '*' enterprise-server: '*' @@ -37,7 +37,7 @@ versions: $ touch .gitignore $ git add .gitignore $ git commit -m "initial commit" - > [master (root-commit) 3146c2a] initial commit + > [main (root-commit) 3146c2a] initial commit > 0 files changed, 0 insertions(+), 0 deletions(-) > create mode 100644 .gitignore ``` @@ -55,29 +55,29 @@ versions: > Receiving objects: 100% (1732/1732), 528.19 KiB | 621 KiB/s, done. > Resolving deltas: 100% (1086/1086), done. > From git://github.com/octocat/Spoon-Knife - > * [new branch] master -> Spoon-Knife/master + > * [new branch] main -> Spoon-Knife/main ``` 2. 将 `Spon-Knife` 项目合并到当地 Git 项目。 这不会在本地更改任何文件，但会为下一步准备 Git。 如果您使用的是 Git 2.9 或更高版本： ```shell - $ git merge -s ours --no-commit --allow-unrelated-histories spoon-knife/master + $ git merge -s ours --no-commit --allow-unrelated-histories spoon-knife/main > Automatic merge went well; stopped before committing as requested ``` 如果您使用的是 Git 2.8 或更低版本： ```shell - $ git merge -s ours --no-commit spoon-knife/master + $ git merge -s ours --no-commit spoon-knife/main > Automatic merge went well; stopped before committing as requested ``` 3. 创建新目录 **spoon-knife** 并将 `Spoon-Knife` 项目的 Git 历史记录复制到其中。 ```shell - $ git read-tree --prefix=spoon-knife/ -u spoon-knife/master + $ git read-tree --prefix=spoon-knife/ -u spoon-knife/main ``` 4. 提交更改以确保其安全。 ```shell $ git commit -m "Subtree merged in spoon-knife" - > [master fe0ca25] Subtree merged in spoon-knife + > [main fe0ca25] Subtree merged in spoon-knife ``` 虽然我们只添加了一个子项目，但是可在 Git 仓库中加入任意数量的子项目。 @@ -99,7 +99,7 @@ $ git pull -s subtree remotename branchname 对于上述示例，将是： ```shell -$ git pull -s subtree spoon-knife master +$ git pull -s subtree spoon-knife main ``` ### 延伸阅读 diff --git a/translations/zh-CN/content/github/using-git/about-remote-repositories.md b/translations/zh-CN/content/github/using-git/about-remote-repositories.md index b9020c25f405..94a31d8260fb 100644 --- a/translations/zh-CN/content/github/using-git/about-remote-repositories.md +++ b/translations/zh-CN/content/github/using-git/about-remote-repositories.md @@ -4,7 +4,7 @@ redirect_from: - /articles/working-when-github-goes-down/ - /articles/sharing-repositories-without-github/ - /articles/about-remote-repositories -intro: GitHub 的协作开发方法取决于从您的本地仓库发布提交，以供其他人查看、提取和更新。 +intro: 'GitHub 的协作开发方法取决于从您的本地仓库发布提交，以供其他人查看、提取和更新。' versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/zh-CN/content/github/using-git/adding-a-remote.md b/translations/zh-CN/content/github/using-git/adding-a-remote.md index d618d5deb6c5..fc406c8cef2f 100644 --- a/translations/zh-CN/content/github/using-git/adding-a-remote.md +++ b/translations/zh-CN/content/github/using-git/adding-a-remote.md @@ -1,6 +1,6 @@ --- title: 添加远程 -intro: 要新增远程，请在终端上存储仓库的目录中使用 `git remote add` 命令。 +intro: '要新增远程，请在终端上存储仓库的目录中使用 `git remote add` 命令。' redirect_from: - /articles/adding-a-remote versions: diff --git a/translations/zh-CN/content/github/using-git/changing-a-remotes-url.md b/translations/zh-CN/content/github/using-git/changing-a-remotes-url.md index 1df987df3f68..07297e1dae59 100644 --- a/translations/zh-CN/content/github/using-git/changing-a-remotes-url.md +++ b/translations/zh-CN/content/github/using-git/changing-a-remotes-url.md @@ -55,7 +55,7 @@ git@{% data variables.command_line.codeblock %}:USERNAME/REPOSITORY - 如果您启用了[双重身份验证](/articles/securing-your-account-with-two-factor-authentication-2fa)，则必须[创建个人访问令牌](/github/authenticating-to-github/creating-a-personal-access-token)来代替 GitHub 密码。 - 您可以[使用凭据小助手](/github/using-git/caching-your-github-credentials-in-git)让 Git 在每次与 GitHub 会话时记住您的 GitHub 用户名和密码。 -### Switching remote URLs from HTTPS to SSH +### 将远程 URL 从 HTTPS 切换到 SSH {% data reusables.command_line.open_the_multi_os_terminal %} 2. 将当前工作目录更改为您的本地仓库。 diff --git a/translations/zh-CN/content/github/using-git/configuring-git-to-handle-line-endings.md b/translations/zh-CN/content/github/using-git/configuring-git-to-handle-line-endings.md index 89c7eeebda2e..1807f84532d7 100644 --- a/translations/zh-CN/content/github/using-git/configuring-git-to-handle-line-endings.md +++ b/translations/zh-CN/content/github/using-git/configuring-git-to-handle-line-endings.md @@ -1,6 +1,6 @@ --- title: 配置 Git 处理行结束符 -intro: 为避免差异中出现问题，可配置 Git 正常处理行标题。 +intro: '为避免差异中出现问题，可配置 Git 正常处理行标题。' redirect_from: - /dealing-with-lineendings/ - /line-endings/ diff --git a/translations/zh-CN/content/github/using-git/dealing-with-non-fast-forward-errors.md b/translations/zh-CN/content/github/using-git/dealing-with-non-fast-forward-errors.md index 3eb121e2aa9c..ae96ae4bd721 100644 --- a/translations/zh-CN/content/github/using-git/dealing-with-non-fast-forward-errors.md +++ b/translations/zh-CN/content/github/using-git/dealing-with-non-fast-forward-errors.md @@ -1,6 +1,6 @@ --- title: 处理非快进错误 -intro: 有时，Git 无法在不丢失提交的情况下对远程仓库进行更改。 发生此情况时，推送会被拒绝。 +intro: '有时，Git 无法在不丢失提交的情况下对远程仓库进行更改。 发生此情况时，推送会被拒绝。' redirect_from: - /articles/dealing-with-non-fast-forward-errors versions: @@ -16,7 +16,10 @@ $ git push origin master > ! [rejected] master -> master（非快进） > 错误：无法推送某些 ref 至 'https://{% data variables.command_line.codeblock %}/USERNAME/REPOSITORY.git' > 为防止丢失历史记录，非快进更新已被拒绝 -> 再次推送前合并远程更改（例如： ‘git pull’）。 请参阅 +> 再次推送前合并远程更改（例如： ‘git pull’）。 [rejected] main -> main (non-fast-forward) +> error: failed to push some refs to 'https://{% data variables.command_line.codeblock %}/USERNAME/REPOSITORY.git' +> To prevent you from losing history, non-fast-forward updates were rejected +> Merge the remote changes (e.g. 'git pull') before pushing again. 请参阅 > “git 推送帮助”部分的“快进说明”以了解详细信息。 ``` diff --git a/translations/zh-CN/content/github/using-git/getting-changes-from-a-remote-repository.md b/translations/zh-CN/content/github/using-git/getting-changes-from-a-remote-repository.md index abf69ff4fc27..3d04ef8c7bb6 100644 --- a/translations/zh-CN/content/github/using-git/getting-changes-from-a-remote-repository.md +++ b/translations/zh-CN/content/github/using-git/getting-changes-from-a-remote-repository.md @@ -29,7 +29,7 @@ $ git clone https://{% data variables.command_line.codeblock %}/USERNAMEremotename branchname ### 延伸阅读 -- _Pro Git_ 手册中的[“使用远程仓库”](https://git-scm.com/book/en/Git-Basics-Working-with-Remotes){% if currentVersion == "free-pro-team@latest" %} +- ["Working with Remotes" from the _Pro Git_ book](https://git-scm.com/book/en/Git-Basics-Working-with-Remotes)"{% if currentVersion == "free-pro-team@latest" %} - “[连接问题故障排除](/articles/troubleshooting-connectivity-problems)”{% endif %} diff --git a/translations/zh-CN/content/github/using-git/pushing-commits-to-a-remote-repository.md b/translations/zh-CN/content/github/using-git/pushing-commits-to-a-remote-repository.md index b58ac31fdd3b..51399b9ea954 100644 --- a/translations/zh-CN/content/github/using-git/pushing-commits-to-a-remote-repository.md +++ b/translations/zh-CN/content/github/using-git/pushing-commits-to-a-remote-repository.md @@ -12,7 +12,7 @@ versions: `git push` 命令使用两个参数： * 远程命令，如 `origin` -* 分支名称，如 `master` +* A branch name, for example, `main` 例如： @@ -20,7 +20,7 @@ versions: git push <REMOTENAME> <BRANCHNAME> ``` -例如，您通常运行 `git push origin master` 来推送本地更改到在线仓库。 +As an example, you usually run `git push origin main` to push your local changes to your online repository. ### 重命名分支 @@ -84,7 +84,7 @@ git fetch upstream > remote: Total 62 (delta 27), reused 44 (delta 9) > Unpacking objects: 100% (62/62), done. > From https://{% data variables.command_line.codeblock %}/octocat/repo -> * [new branch] master -> upstream/master +> * [new branch] main -> upstream/main ``` 在完成本地更改后，可以推送本地分支到 GitHub 并[发起拉取请求](/articles/about-pull-requests)。 diff --git a/translations/zh-CN/content/github/using-git/removing-a-remote.md b/translations/zh-CN/content/github/using-git/removing-a-remote.md index ccc85a0ff165..7652bfdf9ad0 100644 --- a/translations/zh-CN/content/github/using-git/removing-a-remote.md +++ b/translations/zh-CN/content/github/using-git/removing-a-remote.md @@ -14,7 +14,7 @@ versions: ### 示例 -These examples assume you're [cloning using HTTPS](/articles/which-remote-url-should-i-use/#cloning-with-https-urls), which is recommended. +以下示例假设您[使用 HTTPS 克隆](/articles/which-remote-url-should-i-use/#cloning-with-https-urls)，即推荐使用的方法。 ```shell $ git remote -v diff --git a/translations/zh-CN/content/github/using-git/renaming-a-remote.md b/translations/zh-CN/content/github/using-git/renaming-a-remote.md index eb487e9476f9..4771a42ab3fe 100644 --- a/translations/zh-CN/content/github/using-git/renaming-a-remote.md +++ b/translations/zh-CN/content/github/using-git/renaming-a-remote.md @@ -15,7 +15,7 @@ versions: ### 示例 -These examples assume you're [cloning using HTTPS](/articles/which-remote-url-should-i-use/#cloning-with-https-urls), which is recommended. +以下示例假设您[使用 HTTPS 克隆](/articles/which-remote-url-should-i-use/#cloning-with-https-urls)，即推荐使用的方法。 ```shell $ git remote -v diff --git a/translations/zh-CN/content/github/using-git/resolving-merge-conflicts-after-a-git-rebase.md b/translations/zh-CN/content/github/using-git/resolving-merge-conflicts-after-a-git-rebase.md index e96af302e95d..877ab24eef2a 100644 --- a/translations/zh-CN/content/github/using-git/resolving-merge-conflicts-after-a-git-rebase.md +++ b/translations/zh-CN/content/github/using-git/resolving-merge-conflicts-after-a-git-rebase.md @@ -1,6 +1,6 @@ --- title: 解决 Git 变基后的合并冲突 -intro: 当您执行 `git rebase` 操作时，通常会移动提交。 因此，您可能会遇到引入合并冲突的情况。 这意味着您的两个提交修改了同一个文件中的同一行，而 Git 不知道要应用哪个更改。 +intro: '当您执行 `git rebase` 操作时，通常会移动提交。 因此，您可能会遇到引入合并冲突的情况。 这意味着您的两个提交修改了同一个文件中的同一行，而 Git 不知道要应用哪个更改。' redirect_from: - /articles/resolving-merge-conflicts-after-a-git-rebase versions: diff --git a/translations/zh-CN/content/github/using-git/splitting-a-subfolder-out-into-a-new-repository.md b/translations/zh-CN/content/github/using-git/splitting-a-subfolder-out-into-a-new-repository.md index 4f163643ac24..0dde7a1d08b3 100644 --- a/translations/zh-CN/content/github/using-git/splitting-a-subfolder-out-into-a-new-repository.md +++ b/translations/zh-CN/content/github/using-git/splitting-a-subfolder-out-into-a-new-repository.md @@ -33,7 +33,7 @@ versions: {% endtip %} {% endwindows %} - - `BRANCH-NAME`：当前项目的默认分支，例如 `master` 或 `gh-pages`。 + - `BRANCH-NAME`: The default branch for your current project, for example, `main` or `gh-pages`. ```shell $ git filter-branch --prune-empty --subdirectory-filter FOLDER-NAME BRANCH-NAME # Filter the specified branch in your directory and remove empty commits diff --git a/translations/zh-CN/content/github/using-git/updating-credentials-from-the-macos-keychain.md b/translations/zh-CN/content/github/using-git/updating-credentials-from-the-macos-keychain.md index ff3ca46c8b1e..b9c0aa2d86d8 100644 --- a/translations/zh-CN/content/github/using-git/updating-credentials-from-the-macos-keychain.md +++ b/translations/zh-CN/content/github/using-git/updating-credentials-from-the-macos-keychain.md @@ -13,7 +13,7 @@ versions: ### 通过 Keychain Access 更新凭据 -1. Click on the Spotlight icon (magnifying glass) on the right side of the menu bar. Type `Keychain access` then press the Enter key to launch the app. ![Spotlight 搜索栏](/assets/images/help/setup/keychain-access.png) +1. 单击菜单栏右侧的 Spotlight 图标（放大镜）。 键入 `Keychain access`，然后按 Enter 键启动应用程序。 ![Spotlight 搜索栏](/assets/images/help/setup/keychain-access.png) 2. 在 Keychain Access 中，搜索 **{% data variables.command_line.backticks %}**。 3. 查找 `{% data variables.command_line.backticks %}` 的“互联网密码”条目。 ![密钥链中的 GitHub 密码条目](/assets/images/help/setup/keychain-entry.png) 4. 相应地编辑或删除该条目。 diff --git a/translations/zh-CN/content/github/using-git/which-remote-url-should-i-use.md b/translations/zh-CN/content/github/using-git/which-remote-url-should-i-use.md index 45f8cb23b920..2c6b1ba0e5b2 100644 --- a/translations/zh-CN/content/github/using-git/which-remote-url-should-i-use.md +++ b/translations/zh-CN/content/github/using-git/which-remote-url-should-i-use.md @@ -13,7 +13,7 @@ versions: 有关设置或更改远程 URL 的信息，请参阅“[更改远程仓库的 URL](/articles/changing-a-remote-s-url)”。 -### Cloning with HTTPS URLs +### 使用 HTTPS URL 克隆 `https://` 克隆 URL 在所有仓库（公共和私有）中提供。 即使您在防火墙或代理后面，这些 URL 也有效。 @@ -23,7 +23,7 @@ versions: {% tip %} -**Tips**: +**提示**： - 您可以使用凭据小助手，让 Git 在每次与 {% data variables.product.prodname_dotcom %} 通信时记住您的 {% data variables.product.prodname_dotcom %} 凭据。 更多信息请参阅“[在 Git 中缓存 {% data variables.product.prodname_dotcom %} 凭据](/github/using-git/caching-your-github-credentials-in-git)”。 @@ -31,7 +31,7 @@ versions: {% endtip %} - {% if currentVersion == "free-pro-team@latest" %}如果您希望使用 SSH，但不能通过端口 22 进行连接，则可通过 HTTPS 端口使用 SSH。 更多信息请参阅“[通过 HTTPS 端口使用 SSH](/github/authenticating-to-github/using-ssh-over-the-https-port)”。{% endif %} + {% if currentVersion == "free-pro-team@latest" %}If you'd rather use SSH but cannot connect over port 22, you might be able to use SSH over the HTTPS port. 更多信息请参阅“[通过 HTTPS 端口使用 SSH](/github/authenticating-to-github/using-ssh-over-the-https-port)”。{% endif %} ### 使用 SSH URL 克隆 @@ -39,7 +39,7 @@ SSH URL 通过 SSH（一种安全协议）提供 Git 仓库的访问权限。 使用 SSH URL 对远程仓库执行 `git clone`、`git fetch`、`git pull` 或 `git push` 命令时，系统将提示您输入密码，并且必须提供您的 SSH 密钥密码。 更多信息请参阅“[使用 SSH 密钥密码](/github/authenticating-to-github/working-with-ssh-key-passphrases)”。 -{% if currentVersion == "free-pro-team@latest" %}如果要访问使用 SAML 单点登录 (SSO) 的组织，您在进行身份验证之前必须授权 SSH 密钥以访问组织。 更多信息请参阅“[关于使用 SAML 单点登录进行身份验证](/github/authenticating-to-github/about-authentication-with-saml-single-sign-on)”和“[授权 SSH 密码以用于 SAML 单点登录](/github/authenticating-to-github/authorizing-an-ssh-key-for-use-with-saml-single-sign-on)”。{% endif %} +{% if currentVersion == "free-pro-team@latest" %}If you are accessing an organization that uses SAML single sign-on (SSO), you must authorize your SSH key to access the organization before you authenticate. 更多信息请参阅“[关于使用 SAML 单点登录进行身份验证](/github/authenticating-to-github/about-authentication-with-saml-single-sign-on)”和“[授权 SSH 密码以用于 SAML 单点登录](/github/authenticating-to-github/authorizing-an-ssh-key-for-use-with-saml-single-sign-on)”。{% endif %} {% tip %} @@ -49,9 +49,9 @@ SSH URL 通过 SSH（一种安全协议）提供 Git 仓库的访问权限。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -### Cloning with {% data variables.product.prodname_cli %} +### 使用 {% data variables.product.prodname_cli %} 克隆 -You can also install {% data variables.product.prodname_cli %} to use {% data variables.product.product_name %} workflows in your terminal. For more information, the [{% data variables.product.prodname_cli %}](https://cli.github.com/manual/) documentation. +您还可以安装 {% data variables.product.prodname_cli %} 以在终端中使用 {% data variables.product.product_name %} 工作流程。 更多信息请参阅 [{% data variables.product.prodname_cli %}](https://cli.github.com/manual/) 文档。 {% endif %} diff --git a/translations/zh-CN/content/github/using-git/why-is-git-always-asking-for-my-password.md b/translations/zh-CN/content/github/using-git/why-is-git-always-asking-for-my-password.md index ad142d383b9e..e2e33987e7c4 100644 --- a/translations/zh-CN/content/github/using-git/why-is-git-always-asking-for-my-password.md +++ b/translations/zh-CN/content/github/using-git/why-is-git-always-asking-for-my-password.md @@ -1,6 +1,6 @@ --- title: 为什么 Git 总是询问我的密码？ -intro: 如果 Git 在您每次尝试与 GitHub 交互时均提示输入用户名和密码，则您可能为仓库使用的是 HTTPS 克隆 URL。 +intro: '如果 Git 在您每次尝试与 GitHub 交互时均提示输入用户名和密码，则您可能为仓库使用的是 HTTPS 克隆 URL。' redirect_from: - /articles/why-is-git-always-asking-for-my-password versions: diff --git a/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/about-repository-graphs.md b/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/about-repository-graphs.md index 90182d2f1e5d..5bb61dc6d4bc 100644 --- a/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/about-repository-graphs.md +++ b/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/about-repository-graphs.md @@ -9,7 +9,7 @@ versions: enterprise-server: '*' --- -仓库图提供有关 {% if currentVersion == "free-pro-team@latest" %} 流量、依赖于仓库的项目、{% endif %}仓库贡献者和提交以及仓库复刻和网络的信息。 如果是您维护仓库，您可以使用此数据更好地了解谁在使用您的仓库，以及为什么使用。 +A repository's graphs give you information on {% if currentVersion == "free-pro-team@latest" %} traffic, projects that depend on the repository,{% endif %} contributors and commits to the repository, and a repository's forks and network. 如果是您维护仓库，您可以使用此数据更好地了解谁在使用您的仓库，以及为什么使用。 {% if currentVersion == "free-pro-team@latest" %} diff --git a/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md b/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md index 3ebfd0eae0c5..069c3b38eda2 100644 --- a/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md +++ b/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/about-the-dependency-graph.md @@ -47,7 +47,6 @@ You can use the dependency graph to: {% if currentVersion == "free-pro-team@latest" %}To generate a dependency graph, {% data variables.product.product_name %} needs read-only access to the dependency manifest and lock files for a repository. The dependency graph is automatically generated for all public repositories and you can choose to enable it for private repositories. For information about enabling or disabling it for private repositories, see "[Exploring the dependencies of a repository](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository)."{% endif %} - {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %}If the dependency graph is not available in your system, your site administrator can enable the dependency graph and {% data variables.product.prodname_dependabot_short %} alerts. For more information, see "[Enabling alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server)."{% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %} If the dependency graph is not available in your system, your site administrator can enable the dependency graph and security alerts. For more information, see "[Enabling alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server)." @@ -62,7 +61,7 @@ The recommended formats explicitly define which versions are used for all direct | Package manager | Languages | Recommended formats | All supported formats | | --- | --- | --- | ---| -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}| Composer | PHP | `composer.lock` | `composer.json`, `composer.lock` |{% endif %} +| Composer | PHP | `composer.lock` | `composer.json`, `composer.lock` | | `dotnet` CLI | .NET languages (C#, C++, F#, VB) | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj` | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj`, `packages.config` | | Maven | Java, Scala | `pom.xml` | `pom.xml` | | npm | JavaScript | `package-lock.json` | `package-lock.json`, `package.json`| diff --git a/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/accessing-basic-repository-data.md b/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/accessing-basic-repository-data.md index c0939120387f..f1c3ea70f7ef 100644 --- a/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/accessing-basic-repository-data.md +++ b/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/accessing-basic-repository-data.md @@ -1,6 +1,6 @@ --- title: 访问基本仓库数据 -intro: '您可以查看仓库的基本信息，如仓库的活动{% if currentVersion == "free-pro-team@latest" %}、流量{% endif %}和贡献活动。' +intro: 'You can view basic information about a repository, such as the repository''s activity{% if currentVersion == "free-pro-team@latest" %}, traffic,{% endif %} and contribution activity.' mapTopic: true redirect_from: - /articles/accessing-basic-repository-data diff --git a/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/analyzing-changes-to-a-repositorys-content.md b/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/analyzing-changes-to-a-repositorys-content.md index 3e2c6addc4dc..b76683e1b5a0 100644 --- a/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/analyzing-changes-to-a-repositorys-content.md +++ b/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/analyzing-changes-to-a-repositorys-content.md @@ -1,6 +1,6 @@ --- title: 分析仓库内容的更改 -intro: 您可以分析仓库的提交、提交频率以及内容的增补和删除，以了解仓库内容的更改。 +intro: '您可以分析仓库的提交、提交频率以及内容的增补和删除，以了解仓库内容的更改。' redirect_from: - /articles/viewing-commit-frequency-in-a-repository/ - /articles/analyzing-changes-to-a-repository-s-content diff --git a/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md b/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md index 481c12941e13..1781bd264b8c 100644 --- a/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md +++ b/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository.md @@ -1,5 +1,5 @@ --- -title: Exploring the dependencies of a repository +title: 探索仓库的依赖项 intro: 'Using the dependency graph, you can see the packages your project depends on{% if currentVersion == "free-pro-team@latest" %} and the repositories that depend on it{% endif %}. 此外，您还可以看到在其依赖项中检测到的任何漏洞。' redirect_from: - /articles/listing-the-packages-that-a-repository-depends-on @@ -16,7 +16,7 @@ versions: {% data reusables.repositories.enable-security-alerts %} -The dependency graph shows the dependencies{% if currentVersion == "free-pro-team@latest" %} and dependents{% endif %} of your repository. For information about the detection of dependencies and which ecosystems are supported, see "[About the dependency graph](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)." +The dependency graph shows the dependencies{% if currentVersion == "free-pro-team@latest" %} and dependents{% endif %} of your repository. 有关依赖项检测以及支持哪些生态系统的信息，请参阅“[关于依赖关系图”](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.accessing-repository-graphs %} @@ -26,20 +26,22 @@ The dependency graph shows the dependencies{% if currentVersion == "free-pro-tea #### 依赖项视图 {% if currentVersion == "free-pro-team@latest" %} -依赖项按生态系统分组。 您可以展开依赖项以查看其依赖项。 For dependencies on public repositories hosted on {% data variables.product.product_name %}, you can also click a dependency to view the repository. Dependencies on private repositories, private packages, or unrecognized files are shown in plain text. +依赖项按生态系统分组。 您可以展开依赖项以查看其依赖项。 For dependencies on public repositories hosted on +{% data variables.product.product_name %}, you can also click a dependency to view the repository. 私有仓库、私有包或无法识别文件上的依赖项以纯文本显示。 -If vulnerabilities have been detected in the repository, these are shown at the top of the view for users with access to {% data variables.product.prodname_dependabot_alerts %}. +如果在仓库中检测到漏洞，这些漏洞将显示在视图顶部，供有权访问 {% data variables.product.prodname_dependabot_alerts %} 的用户查看。 ![依赖关系图](/assets/images/help/graphs/dependencies_graph.png) {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %} -Any direct and indirect dependencies that are specified in the repository's manifest or lock files are listed, grouped by ecosystem. If vulnerabilities have been detected in the repository, these are shown at the top of the view for users with access to {% data variables.product.prodname_dependabot_short %} alerts. +在仓库的清单或锁定文件中指定的任何直接或间接依赖项按生态系统分组列出。 If vulnerabilities have been detected in the repository, these are shown at the top of the view for users with access to +{% data variables.product.prodname_dependabot_short %} 警报. {% note %} -**Note:** {% data variables.product.prodname_ghe_server %} does not populate the **Dependents** view. +**注：**{% data variables.product.prodname_ghe_server %} 不会填充 **Dependents（依赖项）**视图。 {% endnote %} @@ -47,18 +49,18 @@ Any direct and indirect dependencies that are specified in the repository's mani {% note %} -**Note:** {% data variables.product.prodname_ghe_server %} does not populate the **Dependents** view. +**注：**{% data variables.product.prodname_ghe_server %} 不会填充 **Dependents（依赖项）**视图。 {% endnote %} {% endif %} {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %} -Any direct and indirect dependencies that are specified in the repository's manifest or lock files are listed, grouped by ecosystem. If vulnerabilities have been detected in the repository, these are shown at the top of the view for users with access to security alerts. +在仓库的清单或锁定文件中指定的任何直接或间接依赖项按生态系统分组列出。 如果在仓库中检测到漏洞，这些漏洞将显示在视图顶部，供有权访问安全警报的用户查看。 {% note %} -**Note:** {% data variables.product.prodname_ghe_server %} does not populate the **Dependents** view. +**注：**{% data variables.product.prodname_ghe_server %} 不会填充 **Dependents（依赖项）**视图。 {% endnote %} @@ -66,7 +68,7 @@ Any direct and indirect dependencies that are specified in the repository's mani {% note %} -**Note:** {% data variables.product.prodname_ghe_server %} does not populate the **Dependents** view. +**注：**{% data variables.product.prodname_ghe_server %} 不会填充 **Dependents（依赖项）**视图。 {% endnote %} @@ -83,7 +85,7 @@ Any direct and indirect dependencies that are specified in the repository's mani 仓库管理员可以启用或禁用私有仓库的依赖关系图。 -You can also enable or disable the dependency graph for all repositories owned by your user account or organization. For more information, see "[Managing security and analysis settings for your user account](/github/setting-up-and-managing-your-github-user-account/managing-security-and-analysis-settings-for-your-user-account)" or "[Managing security and analysis settings for your organization](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization)." +您也可以为用户帐户或组织拥有的所有仓库启用或禁用依赖项图。 更多信息请参阅“[管理用户帐户的安全和分析设置](/github/setting-up-and-managing-your-github-user-account/managing-security-and-analysis-settings-for-your-user-account)”或“[管理组织的安全和分析设置](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization)”。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} @@ -98,14 +100,15 @@ You can also enable or disable the dependency graph for all repositories owned b 如果依赖关系图为空，则包含依赖项的文件可能有问题。 检查该文件以确保其格式对文件类型是正确的。 {% if currentVersion == "free-pro-team@latest" %} -如果文件格式正确，请检查文件大小。 除非您是 {% data variables.product.prodname_enterprise %} 用户，否则依赖关系图将忽略超过 0.5 Mb 的单个清单和锁定文件。 默认情况下，每个仓库最多处理 20 个清单或锁定文件，因此您可以在仓库子目录中将依赖项拆分为较小的文件。{% endif %} +如果文件格式正确，请检查文件大小。 The dependency graph ignores individual manifest and lock files that are over 0.5 Mb, unless you are a +{% data variables.product.prodname_enterprise %} user. 默认情况下，每个仓库最多处理 20 个清单或锁定文件，因此您可以在仓库子目录中将依赖项拆分为较小的文件。{% endif %} 如果清单或锁定文件未获处理，其依赖项将从依赖关系图中省略，而不能接受有漏洞依赖项的检查。 ### 延伸阅读 -- "[关于依赖关系图](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)"{% if currentVersion == "free-pro-team@latest" %} -- "[Viewing insights for your organization](/github/setting-up-and-managing-organizations-and-teams/viewing-insights-for-your-organization)" +- "[About the dependency graph](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)"{% if currentVersion == "free-pro-team@latest" %} +- "[查看组织的洞察](/github/setting-up-and-managing-organizations-and-teams/viewing-insights-for-your-organization)" - "[查看和更新仓库中的漏洞依赖项](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)" - "[了解 {% data variables.product.product_name %} 如何使用和保护数据](/github/understanding-how-github-uses-and-protects-your-data)" {% endif %} diff --git a/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/understanding-connections-between-repositories.md b/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/understanding-connections-between-repositories.md index d50dbd291080..72a4258cb137 100644 --- a/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/understanding-connections-between-repositories.md +++ b/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/understanding-connections-between-repositories.md @@ -1,6 +1,6 @@ --- title: 了解仓库之间的连接 -intro: '通过查看仓库的网络{% if currentVersion == "free-pro-team@latest" %}、依赖该仓库的项目{% endif %} 及其复刻，您可以更好地了解仓库之间存在的连接。' +intro: 'You can better understand the connections that exist between repositories by viewing a repository''s network{% if currentVersion == "free-pro-team@latest" %}, projects that depend on the repository,{% endif %} and its forks.' mapTopic: true redirect_from: - /articles/understanding-connections-between-repositories diff --git a/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/viewing-a-projects-contributors.md b/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/viewing-a-projects-contributors.md index 08a14f8798d3..b2dd888e2bdd 100644 --- a/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/viewing-a-projects-contributors.md +++ b/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/viewing-a-projects-contributors.md @@ -1,6 +1,6 @@ --- title: 查看项目的贡献者 -intro: '您可以查看向仓库{% if currentVersion == "free-pro-team@latest" %}及其依赖项{% endif %}贡献提交的人员。' +intro: 'You can see who contributed commits to a repository{% if currentVersion == "free-pro-team@latest" %} and its dependencies{% endif %}.' redirect_from: - /articles/i-don-t-see-myself-in-the-contributions-graph/ - /articles/viewing-contribution-activity-in-a-repository/ @@ -13,10 +13,10 @@ versions: ### 关于贡献者 -您可以在贡献者图中查看仓库的前 100 名贡献者{% if currentVersion != "free-pro-team@latest" %}，包括提交合作作者{% endif %}。 合并提交和空提交不会计为此图的贡献。 +You can view the top 100 contributors to a repository{% if currentVersion != "free-pro-team@latest" %}, including commit co-authors,{% endif %} in the contributors graph. 合并提交和空提交不会计为此图的贡献。 {% if currentVersion == "free-pro-team@latest" %} -You can also see a list of people who have contributed to the project's Python dependencies. 要访问此社区贡献者列表，请访问 `https://github.com/REPO-OWNER/REPO-NAME/community_contributors`。 +您还可以看到为项目的 Python 依赖项做出贡献的人员列表。 要访问此社区贡献者列表，请访问 `https://github.com/REPO-OWNER/REPO-NAME/community_contributors`。 {% endif %} ### 访问贡献者图 diff --git a/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/viewing-a-repositorys-network.md b/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/viewing-a-repositorys-network.md index dea3c713b3a9..c3282279f99e 100644 --- a/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/viewing-a-repositorys-network.md +++ b/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/viewing-a-repositorys-network.md @@ -1,6 +1,6 @@ --- title: 查看仓库的网络 -intro: 网络图显示整个仓库网络的分支历史记录，包括根仓库的分支和包含网络独有提交的复刻的分支。 +intro: '网络图显示整个仓库网络的分支历史记录，包括根仓库的分支和包含网络独有提交的复刻的分支。' product: '{% data reusables.gated-features.repository-insights %}' redirect_from: - /articles/viewing-a-repository-s-network diff --git a/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/viewing-traffic-to-a-repository.md b/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/viewing-traffic-to-a-repository.md index 950f113a876f..5597ba968207 100644 --- a/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/viewing-traffic-to-a-repository.md +++ b/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/viewing-traffic-to-a-repository.md @@ -1,6 +1,6 @@ --- -title: 查看仓库的流量 -intro: 具有仓库推送权限的任何人都可以查看其流量，包括完整克隆（不是提取）、过去 14 天的访问者、推荐站点以及流量图中的热门内容。 +title: Viewing traffic to a repository +intro: 'Anyone with push access to a repository can view its traffic, including full clones (not fetches), visitors from the past 14 days, referring sites, and popular content in the traffic graph.' product: 'This repository insights graph is available in public repositories with {% data variables.product.prodname_free_user %} and {% data variables.product.prodname_free_team %} for organizations, and in public and private repositories with {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, and {% data variables.product.prodname_ghe_cloud %}.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[About repository graphs](/articles/about-repository-graphs)" and "[{% data variables.product.prodname_dotcom %}''s products](/articles/github-s-products)."{% endif %}' redirect_from: - /articles/viewing-traffic-to-a-repository @@ -8,9 +8,9 @@ versions: free-pro-team: '*' --- -您可以从推荐特定路径的链接导航到推荐站点，不包括搜索引擎和 {% data variables.product.product_name %} 本身。 热门内容会链接到生成流量的特定内容。 +You can navigate to referring sites, excluding search engines and {% data variables.product.product_name %} itself, from the links the specific paths were referred from. The popular content links to the specific content that generated traffic. -推荐站点和热门内容按视图和唯一的访问者排序。 完整克隆和访问者信息每小时更新一次，而推荐站点和热门内容部分每天更新。 无论您的位置如何，流量图中的所有数据均使用 UTC+0 时区。 +Referring sites and popular content are ordered by views and unique visitors. Full clones and visitor information update hourly, while referring sites and popular content sections update daily. All data in the traffic graph uses the UTC+0 timezone, regardless of your location. {% tip %} @@ -18,10 +18,11 @@ versions: {% endtip %} -![带工具提示的仓库流量图](/assets/images/help/graphs/repo_traffic_graphs_tooltip_dotcom.png) +![Repository traffic graphs with tooltip](/assets/images/help/graphs/repo_traffic_graphs_tooltip_dotcom.png) -### 访问流量图 +### Accessing the traffic graph {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.accessing-repository-graphs %} -3. In the left sidebar, click **Traffic**. ![流量选项卡](/assets/images/help/graphs/traffic_tab.png) +3. In the left sidebar, click **Traffic**. +![Traffic tab](/assets/images/help/graphs/traffic_tab.png) diff --git a/translations/zh-CN/content/github/working-with-github-pages/about-github-pages-and-jekyll.md b/translations/zh-CN/content/github/working-with-github-pages/about-github-pages-and-jekyll.md index 6cdbd6e2b0ba..11e43db8a567 100644 --- a/translations/zh-CN/content/github/working-with-github-pages/about-github-pages-and-jekyll.md +++ b/translations/zh-CN/content/github/working-with-github-pages/about-github-pages-and-jekyll.md @@ -69,9 +69,10 @@ kramdown: {% data reusables.pages.add-jekyll-theme %} 更多信息请参阅 Jekyll 文档中的“[主题](https://jekyllrb.com/docs/themes/)”。 {% if currentVersion == "free-pro-team@latest" %} -您可以在 {% data variables.product.prodname_dotcom %} 上添加支持的主题到站点。 更多信息请参阅 {% data variables.product.prodname_pages %} 站点上“[支持的主题](https://pages.github.com/themes/)"和"[使用主题选择器添加主题到 {% data variables.product.prodname_pages %} 站点](/articles/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser)”。 +You can add a supported theme to your site on +{% data variables.product.prodname_dotcom %}. 更多信息请参阅 {% data variables.product.prodname_pages %} 站点上“[支持的主题](https://pages.github.com/themes/)"和"[使用主题选择器添加主题到 {% data variables.product.prodname_pages %} 站点](/articles/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser)”。 -要使用 {% data variables.product.prodname_dotcom %} 上托管的任何其他开源 Jekyll 主题，您可以手动添加主题。{% else %} 您可以手动添加主题到站点。{% endif %} 更多信息请参阅{% if currentVersion == "free-pro-team@latest" %} [{% data variables.product.prodname_dotcom %}](https://github.com/topics/jekyll-theme) 上托管的主题和 {% else %}{% data variables.product.prodname_pages %} 站点上 "[支持的主题](https://pages.github.com/themes/)"和{% endif %}“[使用 Jekyll 添加主题到 {% data variables.product.prodname_pages %} 站点](/articles/adding-a-theme-to-your-github-pages-site-using-jekyll)”。 +To use any other open source Jekyll theme hosted on {% data variables.product.prodname_dotcom %}, you can add the theme manually.{% else %} You can add a theme to your site manually.{% endif %} For more information, see{% if currentVersion == "free-pro-team@latest" %} [themes hosted on {% data variables.product.prodname_dotcom %}](https://github.com/topics/jekyll-theme) and{% else %} "[Supported themes](https://pages.github.com/themes/)" on the {% data variables.product.prodname_pages %} site and{% endif %} "[Adding a theme to your {% data variables.product.prodname_pages %} site using Jekyll](/articles/adding-a-theme-to-your-github-pages-site-using-jekyll)." 您可以通过编辑主题文件来覆盖任何主题的默认值。 更多信息请参阅您的主题文档和 Jekyll 文档中的“[覆盖主题默认值](https://jekyllrb.com/docs/themes/#overriding-theme-defaults)“。 diff --git a/translations/zh-CN/content/github/working-with-github-pages/about-github-pages.md b/translations/zh-CN/content/github/working-with-github-pages/about-github-pages.md index 754c05a5f13f..d32685ad4dcb 100644 --- a/translations/zh-CN/content/github/working-with-github-pages/about-github-pages.md +++ b/translations/zh-CN/content/github/working-with-github-pages/about-github-pages.md @@ -20,31 +20,34 @@ versions: {% data variables.product.prodname_pages %} 是一项静态站点托管服务，它直接从 {% data variables.product.product_name %} 上的仓库获取 HTML、CSS 和 JavaScript 文件，（可选）通过构建过程运行文件，然后发布网站。 您可以在 [{% data variables.product.prodname_pages %} 示例集合](https://github.com/collections/github-pages-examples)中查看 {% data variables.product.prodname_pages %} 站点的示例。 {% if currentVersion == "free-pro-team@latest" %} -您可以在 {% data variables.product.prodname_dotcom %} 的 `github.io` 域或自己的自定义域上托管站点。 更多信息请参阅“[对 {% data variables.product.prodname_pages %} 使用自定义域](/articles/using-a-custom-domain-with-github-pages)”。 +You can host your site on +{% data variables.product.prodname_dotcom %}'s `github.io` domain or your own custom domain. 更多信息请参阅“[对 {% data variables.product.prodname_pages %} 使用自定义域](/articles/using-a-custom-domain-with-github-pages)”。 {% endif %} 要开始使用，请参阅“[创建 {% data variables.product.prodname_pages %} 站点](/articles/creating-a-github-pages-site)”。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -Organization owners can disable the publication of {% data variables.product.prodname_pages %} sites from the organization's repositories. For more information, see "[Disabling publication of {% data variables.product.prodname_pages %} sites for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)." +Organization owners can disable the publication of +{% data variables.product.prodname_pages %} sites from the organization's repositories. 更多信息请参阅“[为组织禁止发布 {% data variables.product.prodname_pages %} 站点](/github/setting-up-and-managing-organizations-and-teams/disabling-publication-of-github-pages-sites-for-your-organization)”。 {% endif %} ### {% data variables.product.prodname_pages %} 站点的类型 有三种类型的 {% data variables.product.prodname_pages %} 站点：项目、用户和组织。 项目站点连接到 {% data variables.product.product_name %} 上托管的特定项目，例如 JavaScript 库或配方集合。 用户和组织站点连接到特定的 {% data variables.product.product_name %} 帐户。 -要发布用户站点，必须创建名为 {% if currentVersion == "free-pro-team@latest" %}`.github.io`{% else %}`.`{% endif %} 的用户帐户所拥有的仓库。 要发布组织站点，必须创建名为 {% if currentVersion == "free-pro-team@latest" %}`.github.io`{% else %}`.`{% endif %} 的组织所拥有的仓库。 {% if currentVersion == "free-pro-team@latest" %}除非您使用自定义域，否则用户和组织站点位于 `http(s)://.github.io` 或 `http(s)://.github.io`。{% endif %} +To publish a user site, you must create a repository owned by your user account that's named {% if currentVersion == "free-pro-team@latest" %}`.github.io`{% else %}`.`{% endif %}. To publish an organization site, you must create a repository owned by an organization that's named {% if currentVersion == "free-pro-team@latest" %}`.github.io`{% else %}`.`{% endif %}. {% if currentVersion == "free-pro-team@latest" %}Unless you're using a custom domain, user and organization sites are available at `http(s)://.github.io` or `http(s)://.github.io`.{% endif %} -项目站点的源文件与其项目存储在同一个仓库中。 {% if currentVersion == "free-pro-team@latest" %}除非您使用自定义域，否则项目站点位于 `http(s)://.github.io/` 或 `http(s)://.github.io/`。{% endif %} +项目站点的源文件与其项目存储在同一个仓库中。 {% if currentVersion == "free-pro-team@latest" %}Unless you're using a custom domain, project sites are available at `http(s)://.github.io/` or `http(s)://.github.io/`.{% endif %} {% if currentVersion == "free-pro-team@latest" %} 有关自定义域如何影响站点 URL 的更多详细，请参阅“[关于自定义域和 {% data variables.product.prodname_pages %}](/articles/about-custom-domains-and-github-pages)”。 {% endif %} -您只能为每个 {% data variables.product.product_name %} 帐户创建一个用户或组织站点。 项目站点（无论是组织还是用户帐户拥有）没有限制。 +您只能为每个 {% data variables.product.product_name %} 账户创建一个用户或组织站点。 项目站点（无论是组织还是用户帐户拥有）没有限制。 {% if currentVersion != "free-pro-team@latest" %} -您的站点可用的 URL 取决于是否为 {% data variables.product.product_location %} 启用了子域隔离。 +The URL where your site is available depends on whether subdomain isolation is enabled for +{% data variables.product.product_location %}. | 站点类型 | 子域隔离已启用 | 子域隔离已禁用 | | ---- | ------- | ------- | @@ -66,15 +69,15 @@ Organization owners can disable the publication of {% data variables.product.pro ### {% data variables.product.prodname_pages %} 站点的发布来源 -The publishing source for your {% data variables.product.prodname_pages %} site is the branch and folder where the source files for your site are stored. +{% data variables.product.prodname_pages %} 站点的发布来源是存储站点源文件的分支和文件夹。 {% data reusables.pages.private_pages_are_public_warning %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -If the default publishing source exists in your repository, {% data variables.product.prodname_pages %} will automatically publish a site from that source. The default publishing source for user and organization sites is the root of the default branch for the repository. The default publishing source for project sites is the root of the `gh-pages` branch. +如果默认发布源在您的仓库中，{% data variables.product.prodname_pages %} 将自动从该源发布站点。 用户和组织站点的默认发布源是仓库默认分支的根目录。 项目站点的默认发布来源是 `gh-pages` 分支的根目录。 -If you want to keep the source files for your site in a different location, you can change the publishing source for your site. You can publish your site from any branch in the repository, either from the root of the repository on that branch, `/`, or from the `/docs` folder on that branch. 更多信息请参阅“[配置 {% data variables.product.prodname_pages %} 站点的发布来源](/articles/configuring-a-publishing-source-for-your-github-pages-site#choosing-a-publishing-source)”。 +如果要将站点的源文件保留在不同的位置，您可以更改站点的发布源。 您可以从仓库的任何分支发布站点 - 从该分支上仓库的根目录 `/` 或从该分支上的 `/docs` 文件夹发布。 更多信息请参阅“[配置 {% data variables.product.prodname_pages %} 站点的发布来源](/articles/configuring-a-publishing-source-for-your-github-pages-site#choosing-a-publishing-source)”。 If you choose the `/docs` folder of any branch as your publishing source, {% data variables.product.prodname_pages %} will read everything to publish your site{% if currentVersion == "free-pro-team@latest" %}, including the _CNAME_ file,{% endif %} from the `/docs` folder.{% if currentVersion == "free-pro-team@latest" %} For example, when you edit your custom domain through the {% data variables.product.prodname_pages %} settings, the custom domain will write to `/docs/CNAME`. 有关 _CNAME_ 文件的更多信息，请参阅“[管理 {% data variables.product.prodname_pages %} 站点的自定义域](/articles/managing-a-custom-domain-for-your-github-pages-site)”。{% endif %} @@ -86,7 +89,7 @@ If you choose the `/docs` folder of any branch as your publishing source, {% dat 项目站点也可以从 `master` 分支或 `master` 分支上的 `/docs` 文件夹发布。 要从这些来源之一发布站点，您必须配置不同的发布来源。 更多信息请参阅“[配置 {% data variables.product.prodname_pages %} 站点的发布来源](/articles/configuring-a-publishing-source-for-your-github-pages-site#choosing-a-publishing-source)”。 - 如果选择 `master` 分支的 `/docs` 文件夹作为您的发布来源，{% data variables.product.prodname_pages %} 将读取 `/docs` 文件夹中的所有内容以发布您的站点{% if currentVersion == "free-pro-team@latest" %}（包括 _CNAME_ 文件）{% endif %}。{% if currentVersion == "free-pro-team@latest" %}例如，当您通过 {% data variables.product.prodname_pages %} 设置编辑自定义域时，该自定义域将写入 `/docs/CNAME`。 有关 _CNAME_ 文件的更多信息，请参阅“[管理 {% data variables.product.prodname_pages %} 站点的自定义域](/articles/managing-a-custom-domain-for-your-github-pages-site)”。{% endif %} + If you choose the `/docs` folder of the `master` branch as your publishing source, {% data variables.product.prodname_pages %} will read everything to publish your site{% if currentVersion == "free-pro-team@latest" %}, including the _CNAME_ file,{% endif %} from the `/docs` folder.{% if currentVersion == "free-pro-team@latest" %} For example, when you edit your custom domain through the {% data variables.product.prodname_pages %} settings, the custom domain will write to `/docs/CNAME`. 有关 _CNAME_ 文件的更多信息，请参阅“[管理 {% data variables.product.prodname_pages %} 站点的自定义域](/articles/managing-a-custom-domain-for-your-github-pages-site)”。{% endif %} 您不能从任何其他分支发布项目站点，即使默认分支不是 `master` 或 `gh-pages`。 @@ -111,11 +114,11 @@ If you choose the `/docs` folder of any branch as your publishing source, {% dat {% endif %} {% data variables.product.prodname_pages %} 站点受到以下使用限制的约束： - - {% data variables.product.prodname_pages %} 源仓库建议的限制为 1GB。{% if currentVersion == "free-pro-team@latest" %}更多信息请参阅“[我的磁盘配额是多少？](/articles/what-is-my-disk-quota/#file-and-repository-size-limitations)”{% endif %} + - {% data variables.product.prodname_pages %} source repositories have a recommended limit of 1GB.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[What is my disk quota?"](/articles/what-is-my-disk-quota/#file-and-repository-size-limitations){% endif %} - 发布的 {% data variables.product.prodname_pages %} 站点不得超过 1 GB。 {% if currentVersion == "free-pro-team@latest" %} - - {% data variables.product.prodname_pages %} 站点的*软*带宽限制为每月 100GB。 - - {% data variables.product.prodname_pages %} 站点的*软*限制为每小时 10 次构建。 + - {% data variables.product.prodname_pages %} sites have a *soft* bandwidth limit of 100GB per month. + - {% data variables.product.prodname_pages %} sites have a *soft* limit of 10 builds per hour. 如果您的站点超出这些使用配额，我们可能无法为您的站点提供服务；或者您可能收到来自 {% data variables.contact.contact_support %} 的礼貌电子邮件，建议降低站点对服务器影响的策略，包括将第三方内容分发网络 (CDN) 置于您的站点前，利用其他 {% data variables.product.prodname_dotcom %} 功能（如发行版）或转用可能更符合您需求的其他托管服务。 @@ -132,8 +135,9 @@ If you choose the `/docs` folder of any branch as your publishing source, {% dat - 快速致富计划 - 性淫秽内容 - 歪曲您的身份或站点目的的内容 +If you have questions about whether your use or intended use falls into these categories, please contact -如果您对用途或预期用途是否归入这些类别有疑问，请联系 {% data variables.contact.contact_support %}。 +{% data variables.contact.contact_support %}. {% endif %} ### {% data variables.product.prodname_pages %} 上的 MIME 类型 diff --git a/translations/zh-CN/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md b/translations/zh-CN/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md index 36a5e0b6df3f..604c92383153 100644 --- a/translations/zh-CN/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md +++ b/translations/zh-CN/content/github/working-with-github-pages/about-jekyll-build-errors-for-github-pages-sites.md @@ -13,7 +13,7 @@ versions: ### 关于 Jekyll 构建错误 -有时，在您推送更改到站点的发布源之后，{% data variables.product.prodname_pages %} 不会尝试构建您的站点。{% if currentVersion == "free-pro-team@latest" %} +Sometimes, {% data variables.product.prodname_pages %} will not attempt to build your site after you push changes to your site's publishing source.{% if currentVersion == "free-pro-team@latest" %} - 推送更改的人尚未验证他们的电子邮件地址。 更多信息请参阅“[验证电子邮件地址](/articles/verifying-your-email-address)”。{% endif %} - 您使用部署密钥推送。 如果要自动推送到站点的仓库，您可以改为设置计算机用户。 更多信息请参阅“[管理部署密钥](/v3/guides/managing-deploy-keys/#machine-users)”。 - 您使用的是未配置为构建发布源的 CI 服务。 例如，Travis CI 不会构建 `gh-pages` 分支，除非您将该分支添加到安全列表。 更多信息请参阅 Travis CI 上的“[定制构建](https://docs.travis-ci.com/user/customizing-the-build/#safelisting-or-blocklisting-branches)”或者 CI 服务的文档。 @@ -34,9 +34,7 @@ versions: 我们建议在本地测试您的站点，这样您可以在命令行上看到构建错误消息，并在更改推送到 {% data variables.product.product_name %} 之前解决任何构建失败。 更多信息请参阅“[使用 Jekyll 在本地测试 {% data variables.product.prodname_pages %} 站点](/articles/testing-your-github-pages-site-locally-with-jekyll)”。 -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} 创建拉取请求以更新您在 {% data variables.product.product_name %} 上的发布源时，您可以在拉取请求的 **Checks（检查）**选项卡上看到构建错误消息。 更多信息请参阅“[关于状态检查](/articles/about-status-checks)”。 -{% endif %} 将更改推送到您在 {% data variables.product.product_name %} 上的发布源时，{% data variables.product.prodname_pages %} 将尝试构建您的站点。 如果构建失败，您将在您的主要电子邮件地址收到一封电子邮件。 您还将收到关于构建警告的电子邮件。 {% data reusables.pages.build-failure-email-server %} diff --git a/translations/zh-CN/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md b/translations/zh-CN/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md index f997bef9436a..cab98e002fec 100644 --- a/translations/zh-CN/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md +++ b/translations/zh-CN/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll.md @@ -21,9 +21,9 @@ versions: {% data reusables.pages.navigate-publishing-source %} 2. 导航到 *_config.yml*。 {% data reusables.repositories.edit-file %} -4. 为主题名称添加新行。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - - 要使用支持的主题，{% else %}键{% endif %}入 `theme: THEME-NAME`，将 _THEME-NAME_ 替换为主题仓库的 README 中显示的主题名称。 有关支持的主题列表，请参阅 {% data variables.product.prodname_pages %} 网站上的“[支持的主题](https://pages.github.com/themes/)”。 ![Supported theme in config file](/assets/images/help/pages/add-theme-to-config-file.png){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - - 要使用托管于 {% data variables.product.prodname_dotcom %} 的任何其他 Jekyll 主题，请键入 `remote_theme: THEME-NAME`，将 THEME-NAME 替换为主题仓库的 README 中显示的主题名称。 ![Unsupported theme in config file](/assets/images/help/pages/add-remote-theme-to-config-file.png){% endif %} +4. 为主题名称添加新行。 + - To use a supported theme, type `theme: THEME-NAME`, replacing _THEME-NAME_ with the name of the theme as shown in the README of the theme's repository. 有关支持的主题列表，请参阅 {% data variables.product.prodname_pages %} 网站上的“[支持的主题](https://pages.github.com/themes/)”。 ![Supported theme in config file](/assets/images/help/pages/add-theme-to-config-file.png) + - 要使用托管于 {% data variables.product.prodname_dotcom %} 的任何其他 Jekyll 主题，请键入 `remote_theme: THEME-NAME`，将 THEME-NAME 替换为主题仓库的 README 中显示的主题名称。 ![Unsupported theme in config file](/assets/images/help/pages/add-remote-theme-to-config-file.png) {% data reusables.files.write_commit_message %} {% data reusables.files.choose-commit-email %} {% data reusables.files.choose_commit_branch %} diff --git a/translations/zh-CN/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser.md b/translations/zh-CN/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser.md index 10a10f1b5569..8c654deedd2b 100644 --- a/translations/zh-CN/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser.md +++ b/translations/zh-CN/content/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser.md @@ -18,7 +18,7 @@ versions: 主题选择器如何工作取决于您的资源库是公共的还是私有的。 - 如果已为仓库启用 {% data variables.product.prodname_pages %}，主题选择器会将主题添加到当前发布源。 - - If your repository is public and {% data variables.product.prodname_pages %} is disabled for your repository, using the theme chooser will enable {% data variables.product.prodname_pages %} and configure the default branch as your publishing source. + - 如果您的仓库是公共的，并且已对仓库禁用 {% data variables.product.prodname_pages %}，则使用主题选择器将启用 {% data variables.product.prodname_pages %} 并将默认分支配置为发布源。 - 如果您的仓库是公共的，并且已对仓库禁用 {% data variables.product.prodname_pages %}，则必须先通过配置发布源来启用 {% data variables.product.prodname_pages %}，然后才可使用主题选择器。 有关发布源的更多信息，请参阅“[关于 {% data variables.product.prodname_pages %}](/articles/about-github-pages#publishing-sources-for-github-pages-sites)”。 diff --git a/translations/zh-CN/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md b/translations/zh-CN/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md index 3588019cbeff..c3629e8cfe36 100644 --- a/translations/zh-CN/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md +++ b/translations/zh-CN/content/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md @@ -1,11 +1,11 @@ --- title: 配置 GitHub Pages 站点的发布源 -intro: '如果您使用 {% data variables.product.prodname_pages %} 站点的默认发布源，您的站点将自动发布。 You can also choose to publish your{% if currentVersion ver_lt "enterprise-server@2.22" %} project{% endif %} site from a different branch or folder.' +intro: '如果您使用 {% data variables.product.prodname_pages %} 站点的默认发布源，您的站点将自动发布。 You can also choose to publish your{% if currentVersion ver_lt "enterprise-server@2.23" %} project{% endif %} site from a different branch or folder.' redirect_from: - /articles/configuring-a-publishing-source-for-github-pages/ - /articles/configuring-a-publishing-source-for-your-github-pages-site product: '{% data reusables.gated-features.pages %}' -permissions: 'People with admin or maintainer permissions for a repository can configure a publishing source for a {% data variables.product.prodname_pages %} site.' +permissions: '拥有仓库管理员或维护员权限的人可为 {% data variables.product.prodname_pages %} 站点配置发布源。' versions: free-pro-team: '*' enterprise-server: '*' @@ -15,20 +15,22 @@ versions: ### 选择发布源 -Before you configure a publishing source, make sure the branch{% if currentVersion ver_lt "enterprise-server@2.22" %} or folder{% endif %} you want to use as your publishing source already exists in your repository.{% if currentVersion ver_lt "enterprise-server@2.22" %} For example, before you can publish your project site from the `/docs` folder on the `master` branch of your repository, you or a collaborator must create a `/docs` folder on the default `master` branch of your repository.{% endif %} +Before you configure a publishing source, make sure the branch{% if currentVersion ver_lt "enterprise-server@2.23" %} or folder{% endif %} you want to use as your publishing source already exists in your repository.{% if currentVersion ver_lt "enterprise-server@2.23" %} For example, before you can publish your project site from the `/docs` folder on the `master` branch of your repository, you or a collaborator must create a `/docs` folder on the default `master` branch of your repository.{% endif %} {% data reusables.pages.navigate-site-repo %} {% data reusables.repositories.sidebar-settings %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -3. Under "{% data variables.product.prodname_pages %}", use the **None** or **Branch** drop-down menu and select a publishing source. ![Drop-down menu to select a publishing source](/assets/images/help/pages/publishing-source-drop-down.png) -4. Optionally, use the drop-down menu to select a folder for your publishing source. ![Drop-down menu to select a folder for publishing source](/assets/images/help/pages/publishing-source-folder-drop-down.png) -5. 单击 **Save（保存）**。 ![Button to save changes to publishing source settings](/assets/images/help/pages/publishing-source-save.png) +3. 在“{% data variables.product.prodname_pages %}”下，使用 **None（无）**或 **Branch（分支）**下拉菜单选择发布源。 ![用于选择发布源的下拉菜单](/assets/images/help/pages/publishing-source-drop-down.png) +4. （可选）使用下拉菜单选择发布源的文件夹。 ![用于选择发布源文件夹的下拉菜单](/assets/images/help/pages/publishing-source-folder-drop-down.png) +5. 单击 **Save（保存）**。 ![用于保存对发布源设置的更改的按钮](/assets/images/help/pages/publishing-source-save.png) {% else %} -3. 在“{% data variables.product.prodname_pages %}”下，使用 **Source（源）**下拉菜单选择发布源。 ![用于选择发布源的下拉菜单](/assets/images/help/pages/publishing-source-drop-down.png) +3. 在“ +{% data variables.product.prodname_pages %}", use the **Source** drop-down menu and select a publishing source. + ![用于选择发布源的下拉菜单](/assets/images/help/pages/publishing-source-drop-down.png) {% endif %} ### {% data variables.product.prodname_pages %} 站点发布问题疑难排解 {% data reusables.pages.admin-must-push %} -If you choose the `docs` folder on {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}any{% else %}the `master`{% endif %} branch as your publishing source, then later remove the `/docs` folder from that branch in your repository, your site won't build and you'll get a page build error message for a missing `/docs` folder. 更多信息请参阅“[关于 {% data variables.product.prodname_pages %} 站点的 Jekyll 构建错误疑难排解](/articles/troubleshooting-jekyll-build-errors-for-github-pages-sites#missing-docs-folder)”。 更多信息请参阅“[关于 {% data variables.product.prodname_pages %} 站点的 Jekyll 构建错误疑难排解](/articles/troubleshooting-jekyll-build-errors-for-github-pages-sites#missing-docs-folder)”。 +If you choose the `docs` folder on {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}any{% else %}the `master`{% endif %} branch as your publishing source, then later remove the `/docs` folder from that branch in your repository, your site won't build and you'll get a page build error message for a missing `/docs` folder. 更多信息请参阅“[关于 {% data variables.product.prodname_pages %} 站点的 Jekyll 构建错误疑难排解](/articles/troubleshooting-jekyll-build-errors-for-github-pages-sites#missing-docs-folder)”。 diff --git a/translations/zh-CN/content/github/working-with-github-pages/creating-a-github-pages-site-with-jekyll.md b/translations/zh-CN/content/github/working-with-github-pages/creating-a-github-pages-site-with-jekyll.md index 3189c6ffef76..86907ab801db 100644 --- a/translations/zh-CN/content/github/working-with-github-pages/creating-a-github-pages-site-with-jekyll.md +++ b/translations/zh-CN/content/github/working-with-github-pages/creating-a-github-pages-site-with-jekyll.md @@ -1,24 +1,24 @@ --- -title: 使用 Jekyll 创建 GitHub Pages 站点 -intro: '您可以使用 Jekyll 在新仓库或现有仓库中创建 {% data variables.product.prodname_pages %} 站点。' +title: Creating a GitHub Pages site with Jekyll +intro: 'You can use Jekyll to create a {% data variables.product.prodname_pages %} site in a new or existing repository.' product: '{% data reusables.gated-features.pages %}' redirect_from: - /articles/creating-a-github-pages-site-with-jekyll -permissions: '拥有仓库管理员权限的人员可以使用 Jekyll 创建 {% data variables.product.prodname_pages %} 站点。' +permissions: 'People with admin permissions for a repository can create a {% data variables.product.prodname_pages %} site with Jekyll.' versions: free-pro-team: '*' enterprise-server: '*' --- -### 基本要求 +### Prerequisites -必须安装 Jekyll 和 Git 后才可使用 Jekyll 创建 {% data variables.product.prodname_pages %} 站点。 更多信息请参阅 Jekyll 文档中的[安装](https://jekyllrb.com/docs/installation/)和“[设置 Git](/articles/set-up-git)”。 +Before you can use Jekyll to create a {% data variables.product.prodname_pages %} site, you must install Jekyll and Git. For more information, see [Installation](https://jekyllrb.com/docs/installation/) in the Jekyll documentation and "[Set up Git](/articles/set-up-git)." {% data reusables.pages.recommend-bundler %} {% data reusables.pages.jekyll-install-troubleshooting %} -### 为站点创建仓库 +### Creating a repository for your site {% data reusables.pages.new-or-existing-repo %} @@ -29,21 +29,21 @@ versions: {% data reusables.pages.create-repo-name %} {% data reusables.repositories.choose-repo-visibility %} -### 创建站点 +### Creating your site {% data reusables.pages.must-have-repo-first %} {% data reusables.command_line.open_the_multi_os_terminal %} -2. 如果您还没有本地版仓库，请导航到您想要存储站点源文件的位置，将 _PARENT-FOLDER_ 替换为要包含仓库文件夹的文件夹。 +2. If you don't already have a local copy of your repository, navigate to the location where you want to store your site's source files, replacing _PARENT-FOLDER_ with the folder you want to contain the folder for your repository. ```shell $ cd PARENT-FOLDER ``` -3. 如果尚未初始化本地 Git 仓库，请将 _REPOSITORY-NAME_ 替换为仓库名称。 +3. If you haven't already, initialize a local Git repository, replacing _REPOSITORY-NAME_ with the name of your repository. ```shell $ git init REPOSITORY-NAME > Initialized empty Git repository in /Users/octocat/my-site/.git/ # Creates a new folder on your computer, initialized as a Git repository - ``` + ``` 4. Change directories to the repository. ```shell $ cd REPOSITORY-NAME @@ -57,30 +57,31 @@ versions: # Creates a new folder called docs $ cd docs ``` - 如果选择从 `gh-pages` 分支发布站点，则创建并检出 `gh-pages` 分支。 + If you chose to publish your site from the `gh-pages` branch, create and checkout the `gh-pages` branch. ```shell $ git checkout --orphan gh-pages # Creates a new branch, with no history or contents, called gh-pages and switches to the gh-pages branch ``` - 7. 要创建新的 Jekyll 站点，请使用 `jekyll new` 命令，将 _VERSION_ 替换为当前的 Jekyll 依赖项版本。 更多信息请参阅 {% data variables.product.prodname_pages %} 网站上的“[依赖项版本](https://pages.github.com/versions/)”。 - - 如已安装 Bundler： + 7. To create a new Jekyll site, use the `jekyll new` command, replacing _VERSION_ with the current dependency version for Jekyll. For more information, see "[Dependency versions](https://pages.github.com/versions/)" on the {% data variables.product.prodname_pages %} site. + - If you installed Bundler: ```shell $ bundle exec jekyll VERSION new . # Creates a Jekyll site in the current directory ``` - - 如果尚未安装 Bundler： + - If you don't have Bundler installed: ```shell $ jekyll VERSION new . # Creates a Jekyll site in the current directory ``` -8. 打开已创建的 Gemfile，并按照 Gemfile 注释中的说明使用 {% data variables.product.prodname_pages %}。 ![更新 Gemfile 的说明](/assets/images/help/pages/gemfile-instructions.png) -9. 更新 `gem "github-pages"` 行，使该行类似如下，将 _VERSION_ 替换为 `github-pages` 的当前依赖项版本。 更多信息请参阅 {% data variables.product.prodname_pages %} 网站上的“[依赖项版本](https://pages.github.com/versions/)”。 +8. Open the Gemfile that was created and follow the instructions in the Gemfile's comments to use {% data variables.product.prodname_pages %}. + ![Instructions for updating Gemfile](/assets/images/help/pages/gemfile-instructions.png) +9. Update the `gem "github-pages"` line so that the line looks like this, replacing _VERSION_ with the current dependency version for `github-pages`. For more information, see "[Dependency versions](https://pages.github.com/versions/)" on the {% data variables.product.prodname_pages %} site. ```shell gem "github-pages", "~> VERSION", group: :jekyll_plugins ``` -10. 保存并关闭 Gemfile。 -11. （可选）在本地测试您的站点。 更多信息请参阅“[使用 Jekyll 在本地测试 {% data variables.product.prodname_pages %} 站点](/articles/testing-your-github-pages-site-locally-with-jekyll)”。 -12. 将您的 {% data variables.product.product_name %} 仓库添加为远程，使用您的设备的主机名替换 {% if currentVersion != "free-pro-team@latest" %}_HOSTNAME_，{% endif %} _USER_ 替换为拥有该仓库的帐户{% if currentVersion != "free-pro-team@latest" %}，{% endif %}并且 _REPOSITORY_ 替换为仓库名称。 +10. Save and close the Gemfile. +11. Optionally, test your site locally. For more information, see "[Testing your {% data variables.product.prodname_pages %} site locally with Jekyll](/articles/testing-your-github-pages-site-locally-with-jekyll)." +12. Add your {% data variables.product.product_name %} repository as a remote, replacing {% if currentVersion != "free-pro-team@latest" %}_HOSTNAME_ with your appliance's hostname,{% endif %} _USER_ with the account that owns the repository{% if currentVersion != "free-pro-team@latest" %},{% endif %} and _REPOSITORY_ with the name of the repository. ```shell {% if currentVersion == "free-pro-team@latest" %} $ git remote add origin https://github.com/USER/REPOSITORY.git @@ -88,7 +89,7 @@ $ git remote add origin https://github.com/USER/REPOSITORY.git $ git remote add origin https://HOSTNAME/USER/REPOSITORY.git {% endif %} ``` -13. 将仓库推送到 {% data variables.product.product_name %}，_BRANCH_ 替换为您所操作的分支的名称。 +13. Push the repository to {% data variables.product.product_name %}, replacing _BRANCH_ with the name of the branch you're working on. ```shell $ git push -u origin BRANCH ``` @@ -99,8 +100,8 @@ $ git remote add origin https://HOSTNAME/USER/REPOSITORY.github.io//{% else %}`http(s):///pages///{% endif %}about/contact-us.md` 下。 +您可以通过创建更多新文件向网站添加更多页面。 每个文件都将在网站上与发布源相同的目录结构中。 For example, if the publishing source for your project site is the `gh-pages` branch, and you create a new file called `/about/contact-us.md` on the `gh-pages` branch, the file will be available at {% if currentVersion == "free-pro-team@latest" %}`https://.github.io//{% else %}`http(s):///pages///{% endif %}about/contact-us.md` 下。 -您还可以添加主题以自定义网站的外观。 更多信息请参阅{% if currentVersion == "free-pro-team@latest" %}“[使用主题选择器添加主题到 {% data variables.product.prodname_pages %} 站点](/articles/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser){% else %}”[使用 Jekyll 添加主题到 {% data variables.product.prodname_pages %} 站点](/articles/adding-a-theme-to-your-github-pages-site-using-jekyll){% endif %}”。 +您还可以添加主题以自定义网站的外观。 For more information, see {% if currentVersion == "free-pro-team@latest" %}"[Adding a theme to your {% data variables.product.prodname_pages %} site with the theme chooser](/articles/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser){% else %}"[Adding a theme to your {% data variables.product.prodname_pages %} site using Jekyll](/articles/adding-a-theme-to-your-github-pages-site-using-jekyll){% endif %}." 要更多地自定义您的站点，您可以使用 Jekyl - 内置 {% data variables.product.prodname_pages %} 支持的静态站点生成器。 更多信息请参阅“[关于 {% data variables.product.prodname_pages %} 和 Jekyll](/articles/about-github-pages-and-jekyll)”。 diff --git a/translations/zh-CN/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md b/translations/zh-CN/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md index e4a77fc53b1f..4ef6ecd2a1f1 100644 --- a/translations/zh-CN/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md +++ b/translations/zh-CN/content/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site.md @@ -40,7 +40,8 @@ versions: {% data reusables.pages.navigate-site-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.pages.save-custom-domain %} -5. 导航到您的 DNS 提供程序并创建 `CNAME` 记录，使子域指向您站点的默认域。 例如，如果要对您的用户站点使用子域 `www.example.com`，您可以创建 `CNAME` 记录，使 `www.example.com` 指向 `.github.io`。 If you want to use the subdomain `www.anotherexample.com` for your organization site, create a `CNAME` record that points `www.anotherexample.com` to `.github.io`. The `CNAME` file should always point to `.github.io` or `.github.io`, excluding the repository name. {% data reusables.pages.contact-dns-provider %}{% data reusables.pages.default-domain-information %} +5. 导航到您的 DNS 提供程序并创建 `CNAME` 记录，使子域指向您站点的默认域。 例如，如果要对您的用户站点使用子域 `www.example.com`，您可以创建 `CNAME` 记录，使 `www.example.com` 指向 `.github.io`。 如果要对您的组织站点使用子域 `www.anotherexample.com`，您可以创建 `CNAME` 记录，使 `www.anotherexample.com` 指向 `.github.io`。 `CNAME` 文件应该始终指向 `.github.io` 或 `.github.io`，不包括仓库名称。 +{% data reusables.pages.contact-dns-provider %}{% data reusables.pages.default-domain-information %} {% data reusables.command_line.open_the_multi_os_terminal %} 6. 要确认您的 DNS 记录配置正确，请使用 `dig` 命令，将 _WWW.EXAM.COM_ 替换为您的子域。 ```shell diff --git a/translations/zh-CN/content/github/working-with-github-pages/troubleshooting-jekyll-build-errors-for-github-pages-sites.md b/translations/zh-CN/content/github/working-with-github-pages/troubleshooting-jekyll-build-errors-for-github-pages-sites.md index cc86a633db51..1ed03b1e523d 100644 --- a/translations/zh-CN/content/github/working-with-github-pages/troubleshooting-jekyll-build-errors-for-github-pages-sites.md +++ b/translations/zh-CN/content/github/working-with-github-pages/troubleshooting-jekyll-build-errors-for-github-pages-sites.md @@ -1,6 +1,6 @@ --- -title: 排查 GitHub Pages 站点的 Jekyll 构建错误 -intro: '您可以使用 Jekyll 构建错误消息来排查 {% data variables.product.prodname_pages %} 站点的问题。' +title: Troubleshooting Jekyll build errors for GitHub Pages sites +intro: 'You can use Jekyll build error messages to troubleshoot problems with your {% data variables.product.prodname_pages %} site.' redirect_from: - /articles/page-build-failed-missing-docs-folder/ - /articles/page-build-failed-invalid-submodule/ @@ -30,158 +30,158 @@ versions: enterprise-server: '*' --- -### 排查构建错误 +### Troubleshooting build errors -如果在本地或 {% data variables.product.product_name %} 上构建 {% data variables.product.prodname_pages %} 站点时发生 Jekyll 错误，您可以使用错误消息排查故障。 有关构建错误以及如何查看它们的更多信息，请参阅“[关于 {% data variables.product.prodname_pages %} 站点的 Jekyll 构建错误](/articles/about-jekyll-build-errors-for-github-pages-sites)”。 +If Jekyll encounters an error building your {% data variables.product.prodname_pages %} site locally or on {% data variables.product.product_name %}, you can use error messages to troubleshoot. For more information about error messages and how to view them, see "[About Jekyll build errors for {% data variables.product.prodname_pages %} sites](/articles/about-jekyll-build-errors-for-github-pages-sites)." -如果您收到一般错误消息，请检查常见问题。 -- 您使用的插件不受支持。 更多信息请参阅“[关于 {% data variables.product.prodname_pages %} 和 Jekyll](/articles/about-github-pages-and-jekyll#plugins)”。{% if currentVersion == "free-pro-team@latest" %} -- 您的仓库已超过我们的仓库大小限制。 更多信息请参阅“[我的磁盘配额是多少？](/articles/what-is-my-disk-quota)”{% endif %} -- 您更改了 *_config.yml* 文件中的 `source` 设置。 {% data variables.product.prodname_pages %} 在构建过程中会覆盖此设置。 -- 发布源中的文件名包含不受支持的冒号 (`:`)。 +If you received a generic error message, check for common issues. +- You're using unsupported plugins. For more information, see "[About {% data variables.product.prodname_pages %} and Jekyll](/articles/about-github-pages-and-jekyll#plugins)."{% if currentVersion == "free-pro-team@latest" %} +- Your repository has exceeded our repository size limits. For more information, see "[What is my disk quota?](/articles/what-is-my-disk-quota)"{% endif %} +- You changed the `source` setting in your *_config.yml* file. {% data variables.product.prodname_pages %} overrides this setting during the build process. +- A filename in your publishing source contains a colon (`:`) which is not supported. -如果您收到特定的错误消息，请查看下面的错误消息疑难解答信息。 +If you received a specific error message, review the troubleshooting information for the error message below. -修复任何错误后，请将更改推送到站点的发布源，以触发 {% data variables.product.product_name %} 上的再次构建。 +After you've fixed any errors, push the changes to your site's publishing source to trigger another build on {% data variables.product.product_name %}. -### Config 文件错误 +### Config file error -此错误意味着 *_config.yml* 文件包含语法错误导致您的站点无法构建。 +This error means that your site failed to build because the *_config.yml* file contains syntax errors. -要排除故障，请确保 *_config.yml* 文件遵循以下规则： +To troubleshoot, make sure that your *_config.yml* file follows these rules: {% data reusables.pages.yaml-rules %} {% data reusables.pages.yaml-linter %} -### 日期不是有效的日期时间 +### Date is not a valid datetime -此错误意味着站点上的某个页面包含无效的日期时间。 +This error means that one of the pages on your site includes an invalid datetime. -要排除故障，请搜索错误消息中的文件和文件布局，以调用任何与日期相关的 Liquid 过滤器。 确保在所有情况下传递给日期相关 Liquid 过滤器的任何变量都有值，并且永远不会传递 `nil` 或 `""`。 更多信息请参阅 Liquid 文档中的“[Liquid 过滤器](https://help.shopify.com/en/themes/liquid/filters)”。 +To troubleshoot, search the file in the error message and the file's layouts for calls to any date-related Liquid filters. Make sure that any variables passed into date-related Liquid filters have values in all cases and never pass `nil` or `""`. For more information, see "[Liquid filters](https://help.shopify.com/en/themes/liquid/filters)" in the Liquid documentation. -### 文件在包含目录中不存在 +### File does not exist in includes directory -此错误意味着您的代码引用了 *_includes* 目录中不存在的文件。 +This error means that your code references a file that doesn't exist in your *_includes* directory. -{% data reusables.pages.search-for-includes %} 如果您引用的任何文件不在 *_includes* 目录中，请将这些文件复制或移动到 *_includes* 目录中。 +{% data reusables.pages.search-for-includes %} If any of the files you've referenced aren't in the *_includes* directory, copy or move the files into the *_includes* directory. -### 文件是符号链接 +### File is a symlink -此错误意味着您的代码引用了站点发布源中不存在的符号链接文件。 +This error means that your code references a symlinked file that does not exist in the publishing source for your site. -{% data reusables.pages.search-for-includes %} 如果您引用的任何文件是符号链接的文件，请将这些文件复制或移动到 *_includes* 目录中。 +{% data reusables.pages.search-for-includes %} If any of the files you've referenced are symlinked, copy or move the files into the *_includes* directory. -### 文件未采用正确的 UTF-8 编码 +### File is not properly UTF-8 encoded -此错误意味着您使用了非拉丁字符（如 `日本語`）但没有告诉计算机预期这些符号。 +This error means that you used non-Latin characters, like `日本語`, without telling the computer to expect these symbols. -要排除故障，请将以下行添加到 *_config.yml* 文件以实施 UTF-8 编码： +To troubleshoot, force UTF-8 encoding by adding the following line to your *_config.yml* file: ``` encoding: UTF-8 ``` -### 高亮插件语言无效 +### Invalid highlighter language -此错误意味着您在配置文件中指定了 [Rouge](https://github.com/jneen/rouge) 或 [Pygments](http://pygments.org/) 以外的任何语法高亮插件。 +This error means that you specified any syntax highlighter other than [Rouge](https://github.com/jneen/rouge) or [Pygments](http://pygments.org/) in your configuration file. -要排除故障，请更新 *_config.yml* 文件以指定 [Rouge](https://github.com/jneen/rouge) 或 [Pygments](http://pygments.org/)。 更多信息请参阅“[关于 {% data variables.product.product_name %} 和 Jekyll](/articles/about-github-pages-and-jekyll#syntax-highlighting)”。 +To troubleshoot, update your *_config.yml* file to specify [Rouge](https://github.com/jneen/rouge) or [Pygments](http://pygments.org/). For more information, see "[About {% data variables.product.product_name %} and Jekyll](/articles/about-github-pages-and-jekyll#syntax-highlighting)." -### 帖子日期无效 +### Invalid post date -此错误意味着站点上的帖子在文件名或 YAML 前页中包含无效的日期。 +This error means that a post on your site contains an invalid date in the filename or YAML front matter. -要排除故障，请确保所有日期的 UTC 格式均为 YYYY-MM-DD HH:MM:SS， 并且都是实际日历日期。 要指定与 UTC 偏移的时区，请使用格式 YYYY-MM-DD HH:MM:SS +/-TTTT，例如 `2014-04-18 11:30:00 +0800`。 +To troubleshoot, make sure all dates are formatted as YYYY-MM-DD HH:MM:SS for UTC and are actual calendar dates. To specify a time zone with an offset from UTC, use the format YYYY-MM-DD HH:MM:SS +/-TTTT, like `2014-04-18 11:30:00 +0800`. -如果您在 *_config.yml* 文件中指定日期格式，请确保格式正确。 +If you specify a date format in your *_config.yml* file, make sure the format is correct. -### Sass 或 SCSS 无效 +### Invalid Sass or SCSS -此错误意味着您的仓库包含内容无效的 Sass 或 SCSS 文件。 +This error means your repository contains a Sass or SCSS file with invalid content. -要排除故障，请查看指示 Sass 或 SCSS 无效的错误消息中包含的行号。 为防止以后出错，请在您的常用文本编辑器中安装 Sass 或 SCSS 语法检查插件。 +To troubleshoot, review the line number included in the error message for invalid Sass or SCSS. To help prevent future errors, install a Sass or SCSS linter for your favorite text editor. -### 子模块无效 +### Invalid submodule -此错误意味着您的仓库包含尚未正确初始化的子模块。 +This error means that your repository includes a submodule that hasn't been properly initialized. {% data reusables.pages.remove-submodule %} -如果要使用子模块，请确保在引用子模块时使用 `https://`（而不是 `http://`），并确保该子模块在公共仓库中。 +If do you want to use the submodule, make sure you use `https://` when referencing the submodule (not `http://`) and that the submodule is in a public repository. -### 数据文件中的 YAML 无效 +### Invalid YAML in data file -此错误意味着 *_data* 文件夹中的一个或多个文件包含无效的 YAML。 +This error means that one of more files in the *_data* folder contains invalid YAML. -要排除故障，请确保 *_data* 文件夹中的 YAML 文件遵循以下规则： +To troubleshoot, make sure the YAML files in your *_data* folder follow these rules: {% data reusables.pages.yaml-rules %} {% data reusables.pages.yaml-linter %} -有关 Jekyll 数据文件的更多信息，请参阅 Jekyll 文档中的“[数据文件](https://jekyllrb.com/docs/datafiles/)”。 +For more information about Jekyll data files, see "[Data Files](https://jekyllrb.com/docs/datafiles/)" in the Jekyll documentation. -### Markdown 错误 +### Markdown errors -此错误意味着您的仓库包含 Markdown 错误。 +This error means that your repository contains Markdown errors. -要排除故障，请确保使用受支持的 Markdown 处理器。 更多信息请参阅“[使用 Jekyll 为 {% data variables.product.prodname_pages %} 站点设置 Markdown 处理器](/articles/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll)”。 +To troubleshoot, make sure you are using a supported Markdown processor. For more information, see "[Setting a Markdown processor for your {% data variables.product.prodname_pages %} site using Jekyll](/articles/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll)." -然后，确认错误消息中的文件使用有效的 Markdown 语法。 更多信息请参阅 Daring Fireball 上的“[Markdown：语法](https://daringfireball.net/projects/markdown/syntax)”。 +Then, make sure the file in the error message uses valid Markdown syntax. For more information, see "[Markdown: Syntax](https://daringfireball.net/projects/markdown/syntax)" on Daring Fireball. -### 缺少 docs 文件夹 +### Missing docs folder This error means that you have chosen the `docs` folder on a branch as your publishing source, but there is no `docs` folder in the root of your repository on that branch. -To troubleshoot, if your `docs` folder was accidentally moved, try moving the `docs` folder back to the root of your repository on the branch you chose for your publishing source. 如果 `docs` 文件夹被意外删除，您执行以下任一操作： -- 使用 Git 还原或撤消删除。 更多信息请参阅 Git 文档中的“[git-revert](https://git-scm.com/docs/git-revert.html)”。 -- Create a new `docs` folder in the root of your repository on the branch you chose for your publishing source and add your site's source files to the folder. 更多信息请参阅“[创建新文件](/articles/creating-new-files)”。 -- 更改发布源。 更多信息请参阅“[配置 {% data variables.product.prodname_pages %} 的发布源](/articles/configuring-a-publishing-source-for-github-pages)”。 +To troubleshoot, if your `docs` folder was accidentally moved, try moving the `docs` folder back to the root of your repository on the branch you chose for your publishing source. If the `docs` folder was accidentally deleted, you can either: +- Use Git to revert or undo the deletion. For more information, see "[git-revert](https://git-scm.com/docs/git-revert.html)" in the Git documentation. +- Create a new `docs` folder in the root of your repository on the branch you chose for your publishing source and add your site's source files to the folder. For more information, see "[Creating new files](/articles/creating-new-files)." +- Change your publishing source. For more information, see "[Configuring a publishing source for {% data variables.product.prodname_pages %}](/articles/configuring-a-publishing-source-for-github-pages)." -### 缺少子模块 +### Missing submodule -此错误意味着您的仓库包含不存在或尚未正确初始化的子模块。 +This error means that your repository includes a submodule that doesn't exist or hasn't been properly initialized. {% data reusables.pages.remove-submodule %} -如果要使用子模块，请初始化子模块。 更多信息请参阅 _Pro Git_ 手册中的“[Git 工具 - 子模块](https://git-scm.com/book/en/v2/Git-Tools-Submodules)”。 +If you do want to use a submodule, initialize the submodule. For more information, see "[Git Tools - Submodules](https://git-scm.com/book/en/v2/Git-Tools-Submodules)" in the _Pro Git_ book. -### 配置了相对永久链接 +### Relative permalinks configured -此错误意味着您的 *_config.yml* 文件中存在 {% data variables.product.prodname_pages %} 不支持的相对永久链接。 +This errors means that you have relative permalinks, which are not supported by {% data variables.product.prodname_pages %}, in your *_config.yml* file. -永久链接是引用站点上特定页面的永久 URL。 绝对永久链接以站点的根目录开头，而相对永久链接以包含引用页面的文件夹开头。 {% data variables.product.prodname_pages %} 和 Jekyll 不再支持相对永久链接。 有关永久链接的更多信息，请参阅 Jekyll 文档中的“[永久链接](https://jekyllrb.com/docs/permalinks/)”。 +Permalinks are permanent URLs that reference a particular page on your site. Absolute permalinks begin with the root of the site, while relative permalinks begin with the folder containing the referenced page. {% data variables.product.prodname_pages %} and Jekyll no longer support relative permalinks. For more information about permalinks, see "[Permalinks](https://jekyllrb.com/docs/permalinks/)" in the Jekyll documentation. -要排除故障，请从 *_config.yml* 文件中删除 `relative_permalinks` 行，并将站点中的任何相对永久链接重新格式化为绝对永久链接。 更多信息请参阅“[编辑仓库中的文件](/articles/editing-files-in-your-repository)”。 +To troubleshoot, remove the `relative_permalinks` line from your *_config.yml* file and reformat any relative permalinks in your site with absolute permalinks. For more information, see "[Editing files in your repository](/articles/editing-files-in-your-repository)." -### 符号链接不存在于站点的仓库中 +### Symlink does not exist within your site's repository -此错误意味着您的站点包含站点发布源中不存在的符号链接。 有关符号链接的更多信息，请参阅维基百科上的“[符号链接](https://en.wikipedia.org/wiki/Symbolic_link)”。 +This error means that your site includes a symbolic link (symlink) that does not exist in the publishing source for your site. For more information about symlinks, see "[Symbolic link](https://en.wikipedia.org/wiki/Symbolic_link)" on Wikipedia. -要排除故障，请确定错误消息中的文件是否用于构建站点。 如果否，或者您不希望文件成为符号链接，请删除该文件。 如果符号链接文件是构建站点的必需项，请确保符号链接引用的文件或目录存在于站点的发布源中。 要包括外部资产，请考虑使用 {% if currentVersion == "free-pro-team@latest" %}`git submodule` 或{% endif %}第三方包管理器，例如 [Bower](https://bower.io/)。{% if currentVersion == "free-pro-team@latest" %} 更多信息请参阅“[将子模块用于 {% data variables.product.prodname_pages %}](/articles/using-submodules-with-github-pages)。”{% endif %} +To troubleshoot, determine if the file in the error message is used to build your site. If not, or if you don't want the file to be a symlink, delete the file. If the symlinked file is necessary to build your site, make sure the file or directory the symlink references is in the publishing source for your site. To include external assets, consider using {% if currentVersion == "free-pro-team@latest" %}`git submodule` or {% endif %}a third-party package manager such as [Bower](https://bower.io/).{% if currentVersion == "free-pro-team@latest" %} For more information, see "[Using submodules with {% data variables.product.prodname_pages %}](/articles/using-submodules-with-github-pages)."{% endif %} -### 'for' 循环中的语法错误 +### Syntax error in 'for' loop -此错误意味着您的代码在 Liquid `for` 循环声明中包含无效语法。 +This error means that your code includes invalid syntax in a Liquid `for` loop declaration. -要排除故障，请确保错误消息所指文件中的所有 `for` 循环都具有正确的语法。 有关 `for` 循环之正确语法的更多信息，请参阅 Liquid 文档中的“[迭代标记](https://help.shopify.com/en/themes/liquid/tags/iteration-tags#for)”。 +To troubleshoot, make sure all `for` loops in the file in the error message have proper syntax. For more information about proper syntax for `for` loops, see "[Iteration tags](https://help.shopify.com/en/themes/liquid/tags/iteration-tags#for)" in the Liquid documentation. -### 标记未正确关闭 +### Tag not properly closed -此错误消息意味着您的代码包含未正确关闭的逻辑标记。 例如，{% raw %}`{% capture example_variable %}` 必须用 `{% endcapture %}`{% endraw %} 关闭。 +This error message means that your code includes a logic tag that is not properly closed. For example, {% raw %}`{% capture example_variable %}` must be closed by `{% endcapture %}`{% endraw %}. -要排除故障，请确保错误消息所指文件中的所有逻辑标记都正确关闭。 更多信息请参阅 Liquid 文档中的“[Liquid 标记](https://help.shopify.com/en/themes/liquid/tags)”。 +To troubleshoot, make sure all logic tags in the file in the error message are properly closed. For more information, see "[Liquid tags](https://help.shopify.com/en/themes/liquid/tags)" in the Liquid documentation. -### 标记未正确终止 +### Tag not properly terminated -此错误意味着您的代码包含未正确终止的输出标记。 例如，用 {% raw %}`{{ page.title }` 代替 `{{ page.title }}`{% endraw %}。 +This error means that your code includes an output tag that is not properly terminated. For example, {% raw %}`{{ page.title }` instead of `{{ page.title }}`{% endraw %}. -要排除故障，请确保错误消息所指文件中的所有输出标记都用 `}}` 终止。 更多信息请参阅 Liquid 文档中的“[Liquid 对象](https://help.shopify.com/en/themes/liquid/objects)”。 +To troubleshoot, make sure all output tags in the file in the error message are terminated with `}}`. For more information, see "[Liquid objects](https://help.shopify.com/en/themes/liquid/objects)" in the Liquid documentation. -### 未知标记错误 +### Unknown tag error -此错误意味着您的代码包含无法识别的 Liquid 标记。 +This error means that your code contains an unrecognized Liquid tag. -要排除故障，请确保错误消息所指文件中的所有 Liquid 标记都与 Jekyll 的默认变量相匹配，并且标记名称没有拼写错误。 有关默认变量列表，请参阅 Jekyll 文档中的“[变量](https://jekyllrb.com/docs/variables/)”。 +To troubleshoot, make sure all Liquid tags in the file in the error message match Jekyll's default variables and there are no typos in the tag names. For a list of default varibles, see "[Variables](https://jekyllrb.com/docs/variables/)" in the Jekyll documentation. -不受支持的插件是无法识别标记的常见来源。 如果您通过在本地生成站点并将静态文件推送到 {% data variables.product.product_name %} 的方法在站点中使用不受支持的插件，请确保该插件未引入 Jekyll 默认变量中没有的标记。 有关受支持插件的列表，请参阅“[关于 {% data variables.product.prodname_pages %} 和 Jekyll](/articles/about-github-pages-and-jekyll#plugins)”。 +Unsupported plugins are a common source of unrecognized tags. If you use an unsupported plugin in your site by generating your site locally and pushing your static files to {% data variables.product.product_name %}, make sure the plugin is not introducing tags that are not in Jekyll's default variables. For a list of supported plugins, see "[About {% data variables.product.prodname_pages %} and Jekyll](/articles/about-github-pages-and-jekyll#plugins)." diff --git a/translations/zh-CN/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md b/translations/zh-CN/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md index 0e45bed7b3ae..c003866274c8 100644 --- a/translations/zh-CN/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md +++ b/translations/zh-CN/content/github/working-with-github-pages/unpublishing-a-github-pages-site.md @@ -1,6 +1,6 @@ --- title: 取消发布 GitHub Pages 站点 -intro: '您可以取消发布 {% data variables.product.prodname_pages %} 站点，使该站点不再对{% if currentVersion == "free-pro-team@latest" %}公众{% else %}所有 {% data variables.product.product_location %} 用户{% endif %}开放。' +intro: 'You can unpublish your {% data variables.product.prodname_pages %} site so that the site is no longer available to {% if currentVersion == "free-pro-team@latest" %}the public{% else %}everyone using {% data variables.product.product_location %}{% endif %}.' redirect_from: - /articles/how-do-i-unpublish-a-project-page/ - /articles/unpublishing-a-project-page/ @@ -8,7 +8,7 @@ redirect_from: - /articles/unpublishing-a-user-pages-site/ - /articles/unpublishing-a-github-pages-site product: '{% data reusables.gated-features.pages %}' -permissions: 'People with admin or maintainer permissions for a repository can unpublish a {% data variables.product.prodname_pages %} site.' +permissions: '拥有仓库管理员或维护员权限的人可取消发布 {% data variables.product.prodname_pages %} 站点。' versions: free-pro-team: '*' enterprise-server: '*' @@ -19,13 +19,15 @@ versions: {% data reusables.repositories.navigate-to-repo %} 2. 如果仓库中存在 `gh-pages` 分支，请删除 `gh-pages` 分支。 更多信息请参阅“[创建和删除仓库中的分支](/articles/creating-and-deleting-branches-within-your-repository#deleting-a-branch)”。 3. 如果 `gh-pages` 分支是您的发布源， -{% if currentVersion == "free-pro-team@latest" %}跳到步骤 6{% else %}您的站点现已取消发布，您可以跳过其余步骤{% endif %}。 +{% if currentVersion == "free-pro-team@latest" %}skip to step 6{% else %}your site is now unpublished and you can skip the remaining steps{% endif %}. {% data reusables.repositories.sidebar-settings %} -5. 在“{% data variables.product.prodname_pages %}”下，使用 **Source（源）**下拉菜单并选择 **None（无）**。 ![用于选择发布源的下拉菜单](/assets/images/help/pages/publishing-source-drop-down.png) +5. 在“ +{% data variables.product.prodname_pages %}", use the **Source** drop-down menu and select **None.** + ![用于选择发布源的下拉菜单](/assets/images/help/pages/publishing-source-drop-down.png) {% data reusables.pages.update_your_dns_settings %} ### 取消发布用户或组织站点 {% data reusables.repositories.navigate-to-repo %} -2. Delete the branch that you're using as a publishing source, or delete the entire repository. 更多信息请参阅“[在仓库中创建和删除分支](/articles/creating-and-deleting-branches-within-your-repository#deleting-a-branch)”和“[删除仓库](/articles/deleting-a-repository)”。 +2. 删除用作发布源的分支，或删除整个仓库。 更多信息请参阅“[在仓库中创建和删除分支](/articles/creating-and-deleting-branches-within-your-repository#deleting-a-branch)”和“[删除仓库](/articles/deleting-a-repository)”。 {% data reusables.pages.update_your_dns_settings %} diff --git a/translations/zh-CN/content/github/working-with-github-support/about-github-premium-support-for-github-enterprise-cloud.md b/translations/zh-CN/content/github/working-with-github-support/about-github-premium-support-for-github-enterprise-cloud.md index 912d3f34b848..8b3643721319 100644 --- a/translations/zh-CN/content/github/working-with-github-support/about-github-premium-support-for-github-enterprise-cloud.md +++ b/translations/zh-CN/content/github/working-with-github-support/about-github-premium-support-for-github-enterprise-cloud.md @@ -54,7 +54,7 @@ versions: ### 解决和关闭支持事件单 -{% data variables.contact.premium_support %} may consider a ticket solved after providing an explanation, recommendation, usage instructions, or workaround instructions, +{% data variables.contact.premium_support %} 在提供解释、建议、使用说明或变通方法后，可能认为事件单已解决。 如果您使用自定义或不支持的插件、模块或自定义代码，{% data variables.contact.premium_support %} 可能要求您在尝试解决问题时删除不支持的插件、模块或代码。 如果在不受支持的插件、模块或自定义代码删除后问题得以解决，{% data variables.contact.premium_support %} 可能认为事件单已解决。 diff --git a/translations/zh-CN/content/github/working-with-github-support/about-github-support.md b/translations/zh-CN/content/github/working-with-github-support/about-github-support.md index 11d1fc565603..fb8aa36f9033 100644 --- a/translations/zh-CN/content/github/working-with-github-support/about-github-support.md +++ b/translations/zh-CN/content/github/working-with-github-support/about-github-support.md @@ -11,13 +11,13 @@ versions: 支持选项因您的 {% data variables.product.prodname_dotcom_the_website %} 产品而异。 如果您有任何付费产品，您可以用英语联系 {% data variables.contact.github_support %}。 您的帐户可能还包括 {% data variables.contact.premium_support %}。 -| | {% data variables.product.prodname_gcf %} | 标准支持 | 高级支持 | -| ------------------------------------------------------ | ---------------------------------------------- | ---- | ---- | -| {% data variables.product.prodname_free_user %} | X | | | -| {% data variables.product.prodname_pro %} | X | X | | -| {% data variables.product.prodname_team %} | X | X | | -| {% data variables.product.prodname_ghe_cloud %} | X | X | X | -| {% data variables.product.prodname_ghe_server %} | X | X | X | +| | {% data variables.product.prodname_gcf %} | 标准支持 | 高级支持 | +| -------------------------------------------------- | ----------------------------------------- | ---- | ---- | +| {% data variables.product.prodname_free_user %} | X | | | +| {% data variables.product.prodname_pro %} | X | X | | +| {% data variables.product.prodname_team %} | X | X | | +| {% data variables.product.prodname_ghe_cloud %} | X | X | X | +| {% data variables.product.prodname_ghe_server %} | X | X | X | 要查看 {% data variables.product.prodname_dotcom %} 目前是否有任何影响服务的事件，或者要订阅和接收未来状态更新通知，请访问 {% data variables.product.prodname_dotcom %} 的[状态页面](https://www.githubstatus.com/)。 diff --git a/translations/zh-CN/content/github/writing-on-github/autolinked-references-and-urls.md b/translations/zh-CN/content/github/writing-on-github/autolinked-references-and-urls.md index 6753d6fce3e9..8aa158562b90 100644 --- a/translations/zh-CN/content/github/writing-on-github/autolinked-references-and-urls.md +++ b/translations/zh-CN/content/github/writing-on-github/autolinked-references-and-urls.md @@ -1,6 +1,6 @@ --- title: 自动链接的引用和 URL -intro: 对 URL、议题、拉取请求和提交的引用会自动缩短并转换为链接。 +intro: '对 URL、议题、拉取请求和提交的引用会自动缩短并转换为链接。' redirect_from: - /articles/autolinked-references-and-urls versions: @@ -45,15 +45,12 @@ versions: | 提交 URL | https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | | SHA | a5c3785ed8d6a35868bc169f07e40e889087fd2e | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | | User@SHA | jlord@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -| Username/Repository@SHA | User/Repository@SHA: jlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord/sheetsee.js@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | +| Username/Repository@SHA | jlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord/sheetsee.js@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} ### 自定义外部资源的自动链接 {% data reusables.repositories.autolink-references %} -{% endif %} - ### 延伸阅读 - "[基本撰写和格式语法](/articles/basic-writing-and-formatting-syntax)" diff --git a/translations/zh-CN/content/github/writing-on-github/basic-writing-and-formatting-syntax.md b/translations/zh-CN/content/github/writing-on-github/basic-writing-and-formatting-syntax.md index da68e466b68c..691b1350ab6a 100644 --- a/translations/zh-CN/content/github/writing-on-github/basic-writing-and-formatting-syntax.md +++ b/translations/zh-CN/content/github/writing-on-github/basic-writing-and-formatting-syntax.md @@ -170,7 +170,7 @@ git commit ### 提及人员和团队 -您可以在 {% data variables.product.product_name %} 上提及人员或[团队](/articles/setting-up-teams/)，方法是键入 `@` 加上其用户名或团队名称。 This will trigger a notification and bring their attention to the conversation. 如果您在编辑的评论中提及某人的用户名或团队名称，该用户也会收到通知。 有关通知的更多信息，请参阅{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[关于通知](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}“[关于通知](/github/receiving-notifications-about-activity-on-github/about-notifications){% endif %}”。 +您可以在 {% data variables.product.product_name %} 上提及人员或[团队](/articles/setting-up-teams/)，方法是键入 `@` 加上其用户名或团队名称。 这将触发通知并提请他们注意对话。 如果您在编辑的评论中提及某人的用户名或团队名称，该用户也会收到通知。 For more information about notifications, 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 %}." `@github/support 您如何看待这些更新？` @@ -188,20 +188,17 @@ git commit 更多信息请参阅“[自动链接的引用和 URL](/articles/autolinked-references-and-urls)”。 -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} ### 引用外部资源 {% data reusables.repositories.autolink-references %} -{% endif %} - ### 内容附件 有些 {% data variables.product.prodname_github_app %} 在 {% data variables.product.product_name %} 中提供链接到其注册域名的 URL 信息。 {% data variables.product.product_name %} 可渲染应用程序在正文或者议题或拉取请求的评论中的 URL 下提供的信息。 ![内容附件](/assets/images/help/writing/content-attachment.png) -要查看内容附件，您必须拥有使用仓库中安装的内容附件 API 的 {% data variables.product.prodname_github_app %}。{% if currentVersion == "free-pro-team@latest" %} 更多信息请参阅“[在个人帐户中安装应用程序](/articles/installing-an-app-in-your-personal-account)”和“[在组织中安装应用程序](/articles/installing-an-app-in-your-organization)”。{% endif %} +To see content attachments, you must have a {% data variables.product.prodname_github_app %} that uses the Content Attachments API installed on the repository.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[Installing an app in your personal account](/articles/installing-an-app-in-your-personal-account)" and "[Installing an app in your organization](/articles/installing-an-app-in-your-organization)."{% endif %} 内容附件不会显示在属于 markdown 链接的 URL 中。 diff --git a/translations/zh-CN/content/github/writing-on-github/creating-a-saved-reply.md b/translations/zh-CN/content/github/writing-on-github/creating-a-saved-reply.md index df3e415f2ffa..497f836e74a2 100644 --- a/translations/zh-CN/content/github/writing-on-github/creating-a-saved-reply.md +++ b/translations/zh-CN/content/github/writing-on-github/creating-a-saved-reply.md @@ -1,6 +1,6 @@ --- title: 创建已保存回复 -intro: 如果您经常反复添加相同的评论，您可以创建已保存回复。 +intro: '如果您经常反复添加相同的评论，您可以创建已保存回复。' redirect_from: - /articles/creating-a-saved-reply versions: diff --git a/translations/zh-CN/content/github/writing-on-github/creating-gists.md b/translations/zh-CN/content/github/writing-on-github/creating-gists.md index 96b852f31b51..af4f599b6b1e 100644 --- a/translations/zh-CN/content/github/writing-on-github/creating-gists.md +++ b/translations/zh-CN/content/github/writing-on-github/creating-gists.md @@ -1,6 +1,6 @@ --- title: 创建 Gist -intro: 您可以创建两种 Gist：公开和机密 Gist。 如果您准备与世界分享您的想法，请创建公开 Gist，否则请创建机密 Gist。 +intro: '您可以创建两种 Gist：公开和机密 Gist。 如果您准备与世界分享您的想法，请创建公开 Gist，否则请创建机密 Gist。' redirect_from: - /articles/about-gists/ - /articles/cannot-delete-an-anonymous-gist/ @@ -17,7 +17,7 @@ versions: Gist 可为公共或秘密。 公共 gists 显示在 {% data variables.gists.discover_url %} 中，人们可在其中浏览新建的 gists。 它们也可供搜索，因此，如果您希望其他人查找和查看您的工作，便可使用公共 gists。 {% data reusables.gist.cannot-convert-public-gists-to-secret %} -秘密 gists 不会显示在 {% data variables.gists.discover_url %}{% if currentVersion != "free-pro-team@latest" %},{% endif %} 中，也不可搜索。 {% data reusables.gist.cannot-convert-public-gists-to-secret %} 秘密 gists 不是私人的。 如果将秘密 gist 的 URL 发送给朋友，他们可以查看。 但是，如果您不认识的人发现该 URL，也能看到您的 gist。 如果需要让您的代码不被偷窥，可能要改为[创建私有仓库](/articles/creating-a-new-repository)。 +Secret gists don't show up in {% data variables.gists.discover_url %}{% if currentVersion != "free-pro-team@latest" %},{% endif %} and are not searchable. {% data reusables.gist.cannot-convert-public-gists-to-secret %} 秘密 gists 不是私人的。 如果将秘密 gist 的 URL 发送给朋友，他们可以查看。 但是，如果您不认识的人发现该 URL，也能看到您的 gist。 如果需要让您的代码不被偷窥，可能要改为[创建私有仓库](/articles/creating-a-new-repository)。 {% if currentVersion != "free-pro-team@latest" %} @@ -27,15 +27,12 @@ Gist 可为公共或秘密。 公共 gists 显示在 {% data variables.gists.dis {% endif %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} - 您在以下情况下会收到通知： - 您是新 gist 的作者。 - 有人在 gist 中提及您。 - 您单击任何 gist 顶部的 **Subscribe（订阅）**订阅了 gist。 -{% endif %} -You can pin gists to your profile so other people can see them easily. 更多信息请参阅“[将项目嵌入到个人资料](/articles/pinning-items-to-your-profile)”。 +您可以在个人资料中置顶 Gist，使其他人更容易看到它们。 更多信息请参阅“[将项目嵌入到个人资料](/articles/pinning-items-to-your-profile)”。 您可以到 {% data variables.gists.gist_homepage %} 单击 **All Gists（所有 Gists）**发现其他人创建的 gists。 将会显示所有 gists 存储的页面，gist 按创建或更新时间显示。 您也可以通过 {% data variables.gists.gist_search_url %} 按语言搜索 gist。 Gist 搜索使用的搜索语法与[代码搜索](/articles/searching-code)相同。 @@ -56,7 +53,7 @@ Gist 支持地图 GeoJSON 文件。 这些地图显示在嵌入的 Gist 中， {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} {% note %} -You can also create a gist using the {% data variables.product.prodname_cli %}. For more information, see "[`gh gist create`](https://cli.github.com/manual/gh_gist_create)" in the {% data variables.product.prodname_cli %} documentation. +您也可以使用 {% data variables.product.prodname_cli %} 创建 Gist。 更多信息请参阅 {% data variables.product.prodname_cli %} 文档中的“[`gh Gist 创建`](https://cli.github.com/manual/gh_gist_create)”。 {% endnote %} {% endif %} diff --git a/translations/zh-CN/content/github/writing-on-github/deleting-a-saved-reply.md b/translations/zh-CN/content/github/writing-on-github/deleting-a-saved-reply.md index 9f0e5f784f42..37e4a58429e0 100644 --- a/translations/zh-CN/content/github/writing-on-github/deleting-a-saved-reply.md +++ b/translations/zh-CN/content/github/writing-on-github/deleting-a-saved-reply.md @@ -1,6 +1,6 @@ --- title: 删除已保存回复 -intro: 如果发现不再使用某个已保存回复，可将其删除。 +intro: '如果发现不再使用某个已保存回复，可将其删除。' redirect_from: - /articles/deleting-a-saved-reply versions: diff --git a/translations/zh-CN/content/github/writing-on-github/forking-and-cloning-gists.md b/translations/zh-CN/content/github/writing-on-github/forking-and-cloning-gists.md index b01ba908083d..5a05adaa6f68 100644 --- a/translations/zh-CN/content/github/writing-on-github/forking-and-cloning-gists.md +++ b/translations/zh-CN/content/github/writing-on-github/forking-and-cloning-gists.md @@ -1,6 +1,6 @@ --- title: 复刻和克隆 Gist -intro: Gist 实际上是 Git 仓库，这意味着即使您不是原作者，也可以复刻或克隆任何 Gist。 还可以查看 Gist 的完整提交历史记录，包括差异。 +intro: 'Gist 实际上是 Git 仓库，这意味着即使您不是原作者，也可以复刻或克隆任何 Gist。 还可以查看 Gist 的完整提交历史记录，包括差异。' redirect_from: - /articles/forking-and-cloning-gists versions: diff --git a/translations/zh-CN/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github.md b/translations/zh-CN/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github.md index 9ea86497b60b..ee67a3d12c22 100644 --- a/translations/zh-CN/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github.md +++ b/translations/zh-CN/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github.md @@ -4,7 +4,7 @@ redirect_from: - /articles/markdown-basics/ - /articles/things-you-can-do-in-a-text-area-on-github/ - /articles/getting-started-with-writing-and-formatting-on-github -intro: 您可以在 GitHub 上使用简单的功能格式化您的评论，与他人交流议题、拉取请求和 wiki。 +intro: '您可以在 GitHub 上使用简单的功能格式化您的评论，与他人交流议题、拉取请求和 wiki。' mapTopic: true versions: free-pro-team: '*' diff --git a/translations/zh-CN/content/github/writing-on-github/organizing-information-with-tables.md b/translations/zh-CN/content/github/writing-on-github/organizing-information-with-tables.md index 29f59337854b..7691ba203bda 100644 --- a/translations/zh-CN/content/github/writing-on-github/organizing-information-with-tables.md +++ b/translations/zh-CN/content/github/writing-on-github/organizing-information-with-tables.md @@ -1,6 +1,6 @@ --- title: 使用表格组织信息 -intro: 您可以创建表格来组织评论、议题、拉取请求和 wiki 中的信息。 +intro: '您可以创建表格来组织评论、议题、拉取请求和 wiki 中的信息。' redirect_from: - /articles/organizing-information-with-tables versions: diff --git a/translations/zh-CN/content/github/writing-on-github/using-saved-replies.md b/translations/zh-CN/content/github/writing-on-github/using-saved-replies.md index d360a7389e4b..f40a8d9474b1 100644 --- a/translations/zh-CN/content/github/writing-on-github/using-saved-replies.md +++ b/translations/zh-CN/content/github/writing-on-github/using-saved-replies.md @@ -1,6 +1,6 @@ --- title: 使用已保存回复 -intro: 对议题或拉取请求进行评论时，可添加您已设置的已保存回复。 已保存回复可以是整个评论；或者如果您想要自定义，可以添加或删除内容。 +intro: '对议题或拉取请求进行评论时，可添加您已设置的已保存回复。 已保存回复可以是整个评论；或者如果您想要自定义，可以添加或删除内容。' redirect_from: - /articles/using-saved-replies versions: diff --git a/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting.md b/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting.md index 2fc870cbdb2a..aae1c742adf7 100644 --- a/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting.md +++ b/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting.md @@ -1,6 +1,6 @@ --- title: 使用高级格式 -intro: 表格、语法突出显示和自动链接等格式设置可让您在拉取请求、议题和评论中清楚地布置复杂的信息。 +intro: '表格、语法突出显示和自动链接等格式设置可让您在拉取请求、议题和评论中清楚地布置复杂的信息。' mapTopic: true redirect_from: - /articles/working-with-advanced-formatting diff --git a/translations/zh-CN/content/github/writing-on-github/working-with-saved-replies.md b/translations/zh-CN/content/github/writing-on-github/working-with-saved-replies.md index 9d8ef677287e..254db271faec 100644 --- a/translations/zh-CN/content/github/writing-on-github/working-with-saved-replies.md +++ b/translations/zh-CN/content/github/writing-on-github/working-with-saved-replies.md @@ -1,6 +1,6 @@ --- title: 使用已保存回复 -intro: 为节省时间并确保提供一致的消息，您可将已保存回复添加到议题和拉取请求评论。 +intro: '为节省时间并确保提供一致的消息，您可将已保存回复添加到议题和拉取请求评论。' mapTopic: true redirect_from: - /articles/working-with-saved-replies diff --git a/translations/zh-CN/content/graphql/guides/forming-calls-with-graphql.md b/translations/zh-CN/content/graphql/guides/forming-calls-with-graphql.md index 4b5240c879bd..1f559ca358d5 100644 --- a/translations/zh-CN/content/graphql/guides/forming-calls-with-graphql.md +++ b/translations/zh-CN/content/graphql/guides/forming-calls-with-graphql.md @@ -1,6 +1,6 @@ --- title: 使用 GraphQL 建立调用 -intro: 了解如何向 GraphQL API 验证身份，以及如何创建并运行查询和突变。 +intro: '了解如何向 GraphQL API 验证身份，以及如何创建并运行查询和突变。' redirect_from: - /v4/guides/forming-calls - /graphql/guides/forming-calls diff --git a/translations/zh-CN/content/graphql/guides/index.md b/translations/zh-CN/content/graphql/guides/index.md index 9010a7e1421e..a66a5485f390 100644 --- a/translations/zh-CN/content/graphql/guides/index.md +++ b/translations/zh-CN/content/graphql/guides/index.md @@ -1,6 +1,6 @@ --- title: 指南 -intro: 了解如何开始使用 GraphQL、从 REST 迁移到 GraphQL 以及如何利用 GitHub GraphQL API 执行各种任务。 +intro: '了解如何开始使用 GraphQL、从 REST 迁移到 GraphQL 以及如何利用 GitHub GraphQL API 执行各种任务。' redirect_from: - /v4/guides versions: diff --git a/translations/zh-CN/content/graphql/guides/managing-enterprise-accounts.md b/translations/zh-CN/content/graphql/guides/managing-enterprise-accounts.md index bfbe9062cf41..173e67d10f3b 100644 --- a/translations/zh-CN/content/graphql/guides/managing-enterprise-accounts.md +++ b/translations/zh-CN/content/graphql/guides/managing-enterprise-accounts.md @@ -5,7 +5,7 @@ redirect_from: - /v4/guides/managing-enterprise-accounts versions: free-pro-team: '*' - enterprise-server: '>=2.19' + enterprise-server: '*' --- ### 关于使用 GraphQL 管理企业帐户 @@ -23,7 +23,7 @@ GraphQL 可用于仅请求和返回您指定的数据。 例如，您可以创 - 将用户提升为管理员。 - 更改 GitHub 应用程序的权限。 -审核日志 API 可帮助您保存审核日志数据的副本。 对于使用审核日志 API 执行的查询，GraphQL 响应最多可包含 90 至 120 天的数据。 有关通过审核日志 API 获得的字段列表，请参阅“[AuditEntry 接口](/v4/interface/auditentry/)。” +审核日志 API 可帮助您保存审核日志数据的副本。 对于使用审核日志 API 执行的查询，GraphQL 响应最多可包含 90 至 120 天的数据。 有关通过审核日志 API 获得的字段列表，请参阅“[AuditEntry 接口](/graphql/reference/interfaces#auditentry/)。” 通过企业帐户 API，可以： - 列出并审查属于企业帐户的所有组织和仓库。 diff --git a/translations/zh-CN/content/graphql/overview/changelog.md b/translations/zh-CN/content/graphql/overview/changelog.md index 26a324476eb0..d98891ab0202 100644 --- a/translations/zh-CN/content/graphql/overview/changelog.md +++ b/translations/zh-CN/content/graphql/overview/changelog.md @@ -1,6 +1,6 @@ --- title: 变更日志 -intro: GraphQL 架构变更日志是指最近和即将发生的 GraphQL API 架构变更列表。 其中包括向后兼容变更、架构预览和即将发生的重大变更。 +intro: 'GraphQL 架构变更日志是指最近和即将发生的 GraphQL API 架构变更列表。 其中包括向后兼容变更、架构预览和即将发生的重大变更。' redirect_from: - /v4/changelog versions: diff --git a/translations/zh-CN/content/index.md b/translations/zh-CN/content/index.md index 97430bef7189..237fd3250be2 100644 --- a/translations/zh-CN/content/index.md +++ b/translations/zh-CN/content/index.md @@ -11,8 +11,6 @@ popularLinks: - /github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line - /github/using-git/managing-remote-repositories - /github/working-with-github-pages -versions: - free-pro-team: '*' - enterprise-server: '*' +versions: '*' --- diff --git a/translations/zh-CN/content/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights.md b/translations/zh-CN/content/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights.md index 36731a435635..f80231f0e49b 100644 --- a/translations/zh-CN/content/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights.md +++ b/translations/zh-CN/content/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights.md @@ -4,7 +4,7 @@ intro: '' product: '{% data reusables.gated-features.github-insights %}' permissions: '对 {% data variables.product.prodname_insights %} 具有访问权限的任何人都可以在 {% data variables.product.prodname_enterprise %} 与 {% data variables.product.prodname_insights %} 之间导航。' versions: - enterprise-server: '>=2.19' + enterprise-server: '*' --- 网站管理员必须先启用 {% data variables.product.prodname_insights %} 和 {% data variables.product.prodname_enterprise %} 之间的链接，然后您才可以在 {% data variables.product.prodname_enterprise %} 与 {% data variables.product.prodname_insights %} 之间导航。 更多信息请参阅“[启用 {% data variables.product.prodname_insights %} 与 {% data variables.product.prodname_enterprise %} 之间的链接](/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise)”。 diff --git a/translations/zh-CN/content/insights/installing-and-configuring-github-insights/about-github-insights.md b/translations/zh-CN/content/insights/installing-and-configuring-github-insights/about-github-insights.md index 6605cd00ebd5..d81df195e9cf 100644 --- a/translations/zh-CN/content/insights/installing-and-configuring-github-insights/about-github-insights.md +++ b/translations/zh-CN/content/insights/installing-and-configuring-github-insights/about-github-insights.md @@ -20,7 +20,7 @@ versions: ### 联系支持 -您可以从 {% data variables.product.prodname_insights %} 获得对 {% data variables.contact.github_support %} 的支持。 更多信息请参阅 {% if currentVersion == "free-pro-team@latest" %}“[提交事件单](/github/working-with-github-support/submitting-a-ticket)”。{% else %}“[连接 {% data variables.contact.github_support %}](/enterprise/{{ currentVersion }}/admin/enterprise-support/reaching-github-support)”。{% endif %} +您可以从 {% data variables.product.prodname_insights %} 获得对 {% data variables.contact.github_support %} 的支持。 更多信息请参阅{% if currentVersion == "free-pro-team@latest" %}“[提交事件单](/github/working-with-github-support/submitting-a-ticket)”。{% else %}“[连接 {% data variables.contact.github_support %}](/enterprise/{{ currentVersion }}/admin/enterprise-support/reaching-github-support)”。{% endif %} ### 延伸阅读 diff --git a/translations/zh-CN/content/insights/installing-and-configuring-github-insights/configuring-the-connection-between-github-insights-and-github-enterprise.md b/translations/zh-CN/content/insights/installing-and-configuring-github-insights/configuring-the-connection-between-github-insights-and-github-enterprise.md index 250bdc0d7456..e6c036240378 100644 --- a/translations/zh-CN/content/insights/installing-and-configuring-github-insights/configuring-the-connection-between-github-insights-and-github-enterprise.md +++ b/translations/zh-CN/content/insights/installing-and-configuring-github-insights/configuring-the-connection-between-github-insights-and-github-enterprise.md @@ -8,8 +8,8 @@ versions: --- {% data reusables.github-insights.settings-tab %} -2. Under -{% octicon "gear" aria-label="The gear icon" %} Settings, click **Enterprise**. +2. 在 +{% octicon "gear" aria-label="The gear icon" %} Settings（设置）下，单击 **Enterprise（企业）**。 ![Enterprise（企业）选项卡](/assets/images/help/insights/enterprise-tab.png) {% data reusables.github-insights.enterprise-api-url %} {% data reusables.github-insights.app-id %} diff --git a/translations/zh-CN/content/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise.md b/translations/zh-CN/content/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise.md index 079e1ad0e7ea..349d0ebe7cbf 100644 --- a/translations/zh-CN/content/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise.md +++ b/translations/zh-CN/content/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise.md @@ -7,7 +7,7 @@ redirect_from: - /github/installing-and-configuring-github-insights/navigating-between-github-insights-and-github-enterprise - /github/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise versions: - enterprise-server: '>=2.19' + enterprise-server: '*' --- 在您启用该链接后，每个用户都可以直接从 {% data variables.product.prodname_ghe_server %} 导航到 {% data variables.product.prodname_insights %}。 更多信息请参阅“[在 {% data variables.product.prodname_enterprise %} 与 {% data variables.product.prodname_insights %} 之间导航](/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights)”。 @@ -17,12 +17,13 @@ versions: ``` ghe-config 'app.github.insights-available' 'true' && ghe-config-apply ``` -3. 返回到 {% data variables.product.prodname_ghe_server %}。 +3. 返回到 +{% data variables.product.prodname_ghe_server %}. {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.business %} {% data reusables.enterprise-accounts.settings-tab %} -7. Under -{% octicon "gear" aria-label="The Settings gear" %} **Settings**, click **{% data variables.product.prodname_insights %}**. +7. 在 +{% octicon "gear" aria-label="The Settings gear" %} **Settings（设置）**下，单击 **{% data variables.product.prodname_insights %}**。 {% note %} **注：**运行配置命令后，此选项需要几分钟才会出现在 {% data variables.product.prodname_enterprise %} 中。 如果您没有看到 **{% data variables.product.prodname_insights %}**，请稍候，或者重新启动 {% data variables.product.prodname_enterprise %}。 diff --git a/translations/zh-CN/content/insights/installing-and-configuring-github-insights/installing-github-insights.md b/translations/zh-CN/content/insights/installing-and-configuring-github-insights/installing-github-insights.md index f125420be865..6b274c261fd5 100644 --- a/translations/zh-CN/content/insights/installing-and-configuring-github-insights/installing-github-insights.md +++ b/translations/zh-CN/content/insights/installing-and-configuring-github-insights/installing-github-insights.md @@ -28,7 +28,8 @@ versions: 要将 {% data variables.product.prodname_insights %} 连接到 {% data variables.product.prodname_enterprise %}，您必须在 {% data variables.product.prodname_enterprise %} 上的组织中创建 {% data variables.product.prodname_github_app %}。 当您的集成执行操作时，应用程序名称的缓存版本将显示在 {% data variables.product.prodname_enterprise %} 上。 {% data reusables.enterprise_site_admin_settings.sign-in %} -2. 导航至要连接到 {% data variables.product.prodname_insights %} 的组织。 +2. 导航到要连接到的组织 +{% data variables.product.prodname_insights %}. {% data reusables.organizations.org_settings %} {% data reusables.organizations.github-apps-settings-sidebar %} 5. 单击**新建 {% data variables.product.prodname_github_app %}**。 ![新建 GitHub 应用程序按钮](/assets/images/help/apps/github_apps_new.png) diff --git a/translations/zh-CN/content/insights/installing-and-configuring-github-insights/managing-organizations.md b/translations/zh-CN/content/insights/installing-and-configuring-github-insights/managing-organizations.md index 765b3ed7c101..a6c5b86d4e73 100644 --- a/translations/zh-CN/content/insights/installing-and-configuring-github-insights/managing-organizations.md +++ b/translations/zh-CN/content/insights/installing-and-configuring-github-insights/managing-organizations.md @@ -36,4 +36,4 @@ versions: {% data reusables.github-insights.add-organizations %} 4. 单击要从 {% data variables.product.prodname_insights %} 删除的组织。 4. 在“卸载 {% data variables.product.prodname_insights %}”下，单击 **Uninstall（卸载）**。 ![卸载按钮](/assets/images/help/insights/uninstall-button.png) -5. Click **OK**. +5. 单击 **OK（确定）**。 diff --git a/translations/zh-CN/content/insights/installing-and-configuring-github-insights/managing-permissions-in-github-insights.md b/translations/zh-CN/content/insights/installing-and-configuring-github-insights/managing-permissions-in-github-insights.md index 94609913a22d..5e9ca29a0fae 100644 --- a/translations/zh-CN/content/insights/installing-and-configuring-github-insights/managing-permissions-in-github-insights.md +++ b/translations/zh-CN/content/insights/installing-and-configuring-github-insights/managing-permissions-in-github-insights.md @@ -9,6 +9,6 @@ versions: {% data reusables.github-insights.permissions-levels %} -如果要向 {% data variables.product.prodname_enterprise %} 中不是站点管理员的人授予管理员权限，请联系 {% data variables.contact.github_support %}。 更多信息请参阅 {% if currentVersion == "free-pro-team@latest" %}“[提交事件单](/github/working-with-github-support/submitting-a-ticket)”。{% else %}“[连接 {% data variables.contact.github_support %}](/enterprise/{{ currentVersion }}/admin/enterprise-support/reaching-github-support)”。{% endif %} +如果要向 {% data variables.product.prodname_enterprise %} 中不是站点管理员的人授予管理员权限，请联系 {% data variables.contact.github_support %}。 更多信息请参阅{% if currentVersion == "free-pro-team@latest" %}“[提交事件单](/github/working-with-github-support/submitting-a-ticket)”。{% else %}“[连接 {% data variables.contact.github_support %}](/enterprise/{{ currentVersion }}/admin/enterprise-support/reaching-github-support)”。{% endif %} 要从 {% data variables.product.prodname_insights %} 删除用户的访问权限，您必须从 {% data variables.product.prodname_enterprise %} 删除该用户。 diff --git a/translations/zh-CN/content/packages/getting-started-with-github-container-registry/about-github-container-registry.md b/translations/zh-CN/content/packages/getting-started-with-github-container-registry/about-github-container-registry.md index eea8f0a38ff3..92d4b3326d4b 100644 --- a/translations/zh-CN/content/packages/getting-started-with-github-container-registry/about-github-container-registry.md +++ b/translations/zh-CN/content/packages/getting-started-with-github-container-registry/about-github-container-registry.md @@ -1,6 +1,6 @@ --- -title: About GitHub Container Registry -intro: 'The {% data variables.product.prodname_github_container_registry %} allows you to seamlessly host and manage Docker container images in your organization or personal user account on {% data variables.product.prodname_dotcom %}. {% data variables.product.prodname_github_container_registry %} allows you to configure who can manage and access packages using fine-grained permissions.' +title: 关于 GitHub Container Registration +intro: '{% data variables.product.prodname_github_container_registry %} 允许您在 {% data variables.product.prodname_dotcom %} 上的组织或个人用户帐户中无缝托管和管理 Docker 容器映像。 {% data variables.product.prodname_github_container_registry %} 允许您配置谁可以使用细粒度权限管理和访问包。' product: '{% data reusables.gated-features.packages %}' versions: free-pro-team: '*' @@ -8,35 +8,35 @@ versions: {% note %} -**Note:** {% data variables.product.prodname_github_container_registry %} is currently in public beta and subject to change. Currently, {% data variables.product.prodname_github_container_registry %} only supports Docker image formats. During the beta, storage and bandwidth is free. +**注：**{% data variables.product.prodname_github_container_registry %} 目前处于公测阶段，可能会更改。 目前，{% data variables.product.prodname_github_container_registry %} 只支持 Docker 映像格式。 在测试阶段，存储和带宽是免费的。 {% endnote %} {% data reusables.package_registry.container-registry-feature-highlights %} -To share context about your package's use, you can link a repository to your container image on {% data variables.product.prodname_dotcom %}. For more information, see "[Connecting a repository to a container image](/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image)." +要共享有关包使用的上下文，可以将仓库链接到 {% data variables.product.prodname_dotcom %} 上的容器映像。 更多信息请参阅“[将仓库连接到容器映像](/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image)”。 ### 支持的格式 -The {% data variables.product.prodname_container_registry %} currently only supports Docker images. +{% data variables.product.prodname_container_registry %} 目前只支持 Docker 映像。 -### Visibility and access permissions for container images +### 容器映像的可见性和访问权限 -If you have admin permissions to a container image, you can set the container image to private or public. Public images allow anonymous access and can be pulled without authentication or signing in via the CLI. +如果您对容器映像具有管理员权限，可以将容器映像设置为私有或公有。 公有映像允许匿名访问，无需身份验证或通过 CLI 登录即可进行拉取。 -As an admin, you can also grant access permissions for a container image that are separate from the permissions you've set at the organization and repository levels. +作为管理员，您还可以授予容器映像的访问权限，该权限与在组织和仓库级别设置的权限不同。 -For container images published and owned by a user account, you can give any person an access role. For container images published and owned by an organization, you can give any person or team in the organization an access role. +对于由用户帐户发布和拥有的容器映像，您可以向任何人授予访问角色。 对于组织发布和拥有的容器映像，您可以为组织中的任何人或团队授予访问角色。 -| Permission role | Access description | -| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | -| 读取 | Can download package.
    Can read package metadata. | -| 写入 | Can upload and download this package.
    Can read and write package metadata. | -| 管理员 | Can upload, download, delete, and manage this package.
    Can read and write package metadata.
    Can grant package permissions. | +| 权限角色 | 访问描述 | +| ---- | ------------------------------------------------------------ | +| 读取 | 可以下载包。
    可以读取包元数据。 | +| 写入 | 可以上传和下载此包。
    可以读取和写入包元数据。 | +| 管理员 | 可以上传、下载、删除和管理此包。
    可以读取和写入包元数据。
    可以授予包权限。 | -For more information, see "[Configuring access control and visibility for container images](/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images)." +更多信息请参阅“[配置容器映像的访问控制和可见性](/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images)”。 ### 关于 {% data variables.product.prodname_github_container_registry %} 的计费 @@ -44,10 +44,10 @@ For more information, see "[Configuring access control and visibility for contai ### 联系支持 -If you have feedback or feature requests for {% data variables.product.prodname_github_container_registry %}, use the [feedback form](https://support.github.com/contact/feedback?contact%5Bcategory%5D=packages). +如果您对 {% data variables.product.prodname_github_container_registry %} 有反馈或功能请求，请使用[反馈表](https://support.github.com/contact/feedback?contact%5Bcategory%5D=packages)。 如果在 {% data variables.product.prodname_github_container_registry %} 方面遇到以下问题，请使用[我们的联系表](https://support.github.com/contact?form%5Bsubject%5D=Re:%20GitHub%20Packages)联系 {% data variables.contact.github_support %}： * 遇到任何与文档相矛盾的事情. * 遇到模糊或不清楚的错误. -* Your published package contains sensitive data, such as GDPR violations, API Keys, or personally-identifying information. +* 发布的包中含有敏感数据，例如违反 GDPR、API 密钥或个人身份信息. diff --git a/translations/zh-CN/content/packages/getting-started-with-github-container-registry/core-concepts-for-github-container-registry.md b/translations/zh-CN/content/packages/getting-started-with-github-container-registry/core-concepts-for-github-container-registry.md index e5f3f51a6cad..ccadc7099201 100644 --- a/translations/zh-CN/content/packages/getting-started-with-github-container-registry/core-concepts-for-github-container-registry.md +++ b/translations/zh-CN/content/packages/getting-started-with-github-container-registry/core-concepts-for-github-container-registry.md @@ -1,6 +1,6 @@ --- -title: Core concepts for GitHub Container Registry -intro: 'Below is a list of common {% data variables.product.prodname_github_container_registry %} terms we use across our sites and documentation.' +title: GitHub 容器注册表的核心概念 +intro: '以下是我们在网站和文档中使用的 {% data variables.product.prodname_github_container_registry %} 常见术语列表。' product: '{% data reusables.gated-features.packages %}' versions: free-pro-team: '*' @@ -10,20 +10,20 @@ versions: ### {% data variables.product.prodname_github_container_registry %} -The {% data variables.product.prodname_github_container_registry %} is a registry for containers with support for Docker images. 更多信息请参阅“[关于 {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry)”。 +{% data variables.product.prodname_github_container_registry %} 是支持 Docker 映像的容器的注册表。 更多信息请参阅“[关于 {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry)”。 ### 包 -A package is a self-contained and reusable piece of software that includes code and metadata that a developer bundles together in a common place for others to use. A package's metadata may include the version number, name, and the code's dependencies. Packages simplify using and distributing solutions to common problems such as needing frameworks for developing or testing a project, linters to improve code quality, or industry-standard machine learning tools to power your application. Packages exist in many ecosystems. For example, you can package Node.js and Java code or container images. +包是一个自包含且可重用的软件，它包括代码和元数据，开发人员可将它们捆绑在一个位置供他人使用。 包的元数据可能包括版本号、名称和代码的依赖项。 包简化了针对常见问题的使用和分发解决方案，例如需要使用框架来开发或测试项目、进行语法检查以提高代码质量，或引入行业标准的机器学习工具来强化您的应用程序。 包存在于许多生态系统中。 例如，您可以打包 Node.js 和 Java 代码或容器映像。 -### Container +### 容器 -A container is a unit of software designed to reliably deploy software in a standardized way on any platform. A container operates as an isolated virtual environment or instance that can run various software packages and components on the same host kernel as your operating system. Containers use fewer resources than virtual machines because they don't need to include their own virtual hardware to run. Containers are created using a container image file, such as a Dockerfile, and a container client or runtime program. +容器是一个软件单元，设计为在任何平台上以标准化的方式可靠地部署软件。 容器作为独立的虚拟环境或实例运行，可在与操作系统相同的主机内核上运行各种软件包和组件。 容器使用的资源比虚拟机少，因为它们不需要自带虚拟硬件即可运行。 容器是使用容器映像文件（如 Dockerfile）和容器客户端或运行时程序创建的。 -### Container image +### 容器映像 -A container image is a type of package archive that specifies the software requirements to run an app from a container. A container image typically includes the app's code, libraries, and runtime instructions. To ensure that the same image details are used wherever an image is deployed and run, a container image is automatically versioned and cannot be changed once a container image is built in a container. +容器映像是一种包存档类型，用于指定从容器运行应用程序的软件要求。 容器映像通常包括应用程序的代码、库和运行时指令。 为确保在部署和运行映像的所有地方使用相同的映像详细信息，容器映像将自动进行版本管理，并且在容器中生成容器映像后无法更改。 ### Docker 容器 -A Docker container is a type of open source container built on the Docker platform. Docker's original image format has become the OCI (Open Container Initiative) Image Specification. For more information, see the "[Docker documentation](https://docs.docker.com/get-started/overview/)." +Docker 容器是一种在 Docker 平台上构建的开源容器类型。 Docker 的原始映像格式已成为 OCI（开放容器计划）映像规范。 更多信息请参阅 [Docker 文档](https://docs.docker.com/get-started/overview/)。 diff --git a/translations/zh-CN/content/packages/getting-started-with-github-container-registry/enabling-github-container-registry-for-your-organization.md b/translations/zh-CN/content/packages/getting-started-with-github-container-registry/enabling-github-container-registry-for-your-organization.md index 7a3471c31b9f..351682611b8e 100644 --- a/translations/zh-CN/content/packages/getting-started-with-github-container-registry/enabling-github-container-registry-for-your-organization.md +++ b/translations/zh-CN/content/packages/getting-started-with-github-container-registry/enabling-github-container-registry-for-your-organization.md @@ -1,6 +1,6 @@ --- -title: Enabling GitHub Container Registry for your organization -intro: 'In an organization, organization admins can allow organization members to publish public or private container images to {% data variables.product.prodname_github_container_registry %}.' +title: 为组织启用 GitHub Container Registry +intro: '在组织中，组织管理员可以允许组织成员将公共或私有容器映像发布到 {% data variables.product.prodname_github_container_registry %}。' product: '{% data reusables.gated-features.packages %}' versions: free-pro-team: '*' @@ -8,14 +8,14 @@ versions: {% data reusables.package_registry.container-registry-beta %} -Before organization members can publish container images to {% data variables.product.prodname_github_container_registry %}, an organization admin must enable package creation. +在组织成员将容器映像发布到 {% data variables.product.prodname_github_container_registry %} 之前，组织管理员必须启用包创建。 {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.member-privileges %} -5. Under "Package creation", choose whether you want to enable the creation of public or private container images. - - To enable organization members to create a public container image, click **Public**. - - To enable organization members to create a private container image that is only visible to other organization members, click **Private**. You can further customize the visibility of a private container image. For more information, see "[Configuring access control and visibility for container images](/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images)." +5. 在“Package creation（包创建）”下，选择是要启用公共容器映像还是私有容器映像。 + - 要让组织成员创建公共容器映像，请单击 **Public（公共）**。 + - 要让组织成员创建只对其他组织成员可见的私有容器映像，请单击 **Private（私有）**。 您可以进一步自定义私有容器映像的可见性。 更多信息请参阅“[配置容器映像的访问控制和可见性](/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images)”。 - ![Options to enable public or private packages ](/assets/images/help/package-registry/package-creation-org-settings.png) + ![用于启用公共或私有包的选项 ](/assets/images/help/package-registry/package-creation-org-settings.png) diff --git a/translations/zh-CN/content/packages/getting-started-with-github-container-registry/index.md b/translations/zh-CN/content/packages/getting-started-with-github-container-registry/index.md index 46849f39a609..6cf2b59cd6f4 100644 --- a/translations/zh-CN/content/packages/getting-started-with-github-container-registry/index.md +++ b/translations/zh-CN/content/packages/getting-started-with-github-container-registry/index.md @@ -1,6 +1,6 @@ --- -title: Getting started with GitHub Container Registry -intro: 'Learn about {% data variables.product.prodname_container_registry %} concepts and how to migrate your Docker images from {% data variables.product.prodname_registry %}.' +title: 开始使用 GitHub Container Registry +intro: '了解 {% data variables.product.prodname_container_registry %} 概念以及如何从 {% data variables.product.prodname_registry %} 迁移 Docker 映像。' versions: free-pro-team: '*' --- @@ -12,4 +12,4 @@ versions: {% link_in_list /migrating-to-github-container-registry-for-docker-images %} {% link_in_list /enabling-github-container-registry-for-your-organization %} -For more information about configuring, deleting, pushing, or pulling container images, see "[Managing container images with {% data variables.product.prodname_github_container_registry %}](/packages/managing-container-images-with-github-container-registry)." +有关配置、删除、推送或拉取容器映像的信息，请参阅“[使用 {% data variables.product.prodname_github_container_registry %} 管理容器映像](/packages/managing-container-images-with-github-container-registry)”。 diff --git a/translations/zh-CN/content/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images.md b/translations/zh-CN/content/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images.md index 13b8c0a73faa..13e923ddbcae 100644 --- a/translations/zh-CN/content/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images.md +++ b/translations/zh-CN/content/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images.md @@ -1,86 +1,90 @@ --- -title: Migrating to GitHub Container Registry for Docker images -intro: 'If you''ve used the GitHub Packages Docker registry to store Docker images, you can migrate to the new {% data variables.product.prodname_container_registry %}.' +title: 迁移到 Docker 映像的 GitHub Container Registry +intro: '如果您已经使用 GitHub Packages Docker 注册表来存储 Docker 映像，可以迁移到新的 {% data variables.product.prodname_container_registry %}。' product: '{% data reusables.gated-features.packages %}' versions: free-pro-team: '*' --- -### Key differences between {% data variables.product.prodname_github_container_registry %} and the Docker package registry +### {% data variables.product.prodname_github_container_registry %} 与 Docker 软件包注册表之间的主要差异 {% data reusables.package_registry.container-registry-beta %} -The {% data variables.product.prodname_github_container_registry %} supersedes the existing Packages Docker registry and is optimized to support some of the unique needs of containers. +{% data variables.product.prodname_github_container_registry %} 取代原有的Packages Docker 注册表，并且做了优化，可支持容器的一些独特需求。 {% data reusables.package_registry.container-registry-feature-highlights %} 更多信息请参阅“[关于 {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry)”。 -### Billing changes +### 计费更改 {% data reusables.package_registry.billing-for-container-registry %} -### Domain changes +### 域更改 -The domain for the {% data variables.product.prodname_container_registry %} is `ghcr.io`. +{% data variables.product.prodname_container_registry %} 的域是 `ghcr.io`。 -| Registry | Example URL | -| ---------------------------------------------------------------------- | --------------------------------------------------- | -| {% data variables.product.prodname_registry %} Docker registry | `docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME` | +| 注册表 | Example URL | +| ----------------------------------------------------------------- | --------------------------------------------------- | +| {% data variables.product.prodname_registry %} Docker 注册表 | `docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME` | | {% data variables.product.prodname_github_container_registry %} | `ghcr.io/OWNER/IMAGE_NAME` | -### Authenticating with the container registry +### 使用容器注册表进行身份验证 -You will need to authenticate to the {% data variables.product.prodname_container_registry %} with the base URL `ghcr.io`. We recommend creating a new access token for using the {% data variables.product.prodname_container_registry %}. +您需要使用基本 URL `ghcr.io` 向 {% data variables.product.prodname_container_registry %} 验证。 我们建议创建新的访问令牌以使用 {% data variables.product.prodname_container_registry %}。 -{% data reusables.package_registry.authenticate-to-container-registry %} +{% data reusables.package_registry.authenticate_with_pat_for_container_registry %} -### Migrating a Docker image using the Docker CLI +{% data reusables.package_registry.authenticate-to-container-registry-steps %} -To move Docker images that you host on {% data variables.product.prodname_registry %} Docker registry, you must republish the images to {% data variables.product.prodname_container_registry %}. We recommend republishing your existing Docker images using the command line on your local machine. +### 使用 Docker CLI 迁移 Docker 映像 -1. Sign in to the Docker registry using a temporary PAT with at least the `read:packages` scope. This PAT will only be used to sign in to the Docker registry to pull down images and can be deleted afterward. +要移动您在 {% data variables.product.prodname_registry %} Docker 注册表上托管的 Docker 映像，您必须将映像重新发布到 {% data variables.product.prodname_container_registry %}。 我们建议在本地计算机上使用命令行重新发布现有的 Docker 映像。 + +1. 使用作用域至少为 `read:packages` 的临时 PAT 登录到 Docker 注册表。 此 PAT 将仅用于登录到 Docker 注册表以下拉映像，然后可以删除。 {% raw %} ```shell $ echo $READ_PACKAGES_TOKEN | docker login docker.pkg.github.com -u USERNAME --password-stdin ``` {% endraw %} -2. Pull down the image you'd like to migrate, replacing OWNER with the name of the user or organization account that owns the repository, REPOSITORY with the name of the repository containing your project, IMAGE_NAME with name of the package or image, VERSION with tag for the image you want to install. For example, `docker pull docker.pkg.github.com/octo-org/octoshift/octoshift:latest` pulls the latest tag of the `octoshift/octoshift` image in the octo-org organization. +2. 下拉要迁移的映像，将 OWNER 替换为拥有仓库的用户或组织帐户的名称，将 REPOSITORY 替换为包含项目的仓库，将 IMAGE_NAME 替换为包或映像的名称，将 VERSION 替换为要安装的映像的标记。 例如，`docker ull docker.pkg.github.com/octo-org/octoshift/octoshift:latest` 拉取 octo-org 组织中 `octoshift/octoshift` 映像的最新标记。 ```shell $ docker pull docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME:VERSION ``` -3. Re-tag the image with the new domain and a new image name. 更多信息请参阅 Docker 文档中的“[Docker 标记](https://docs.docker.com/engine/reference/commandline/tag/)”。 Use the same URL that you used in the previous step for the SOURCE URL. Replace the TARGET_OWNER with the user or organization that you are migrating the container image to and replace the TARGET_IMAGE_NAME with the new {% data variables.product.prodname_container_registry %} image name. +3. 使用新域和新映像名称重新标记映像。 更多信息请参阅 Docker 文档中的“[Docker 标记](https://docs.docker.com/engine/reference/commandline/tag/)”。 使用在上一步中用于 SOURCE URL 同一个URL。 将 TARGET_OWNER 替换为要将容器映像迁移到其中的用户或组织，将 TARGET_IMAGE_NAME 替换为新 {% data variables.product.prodname_container_registry %} 映像名称。 ```shell $ docker tag docker.pkg.github.com/SOURCE_OWNER/SOURCE_REPOSITORY/SOURCE_IMAGE_NAME:VERSION ghcr.io/TARGET_OWNER/TARGET_IMAGE_NAME:VERSION ``` -4. Sign in to the new {% data variables.product.prodname_container_registry %}. We recommend creating a new PAT limited to the `read:packages` and `write:packages` scopes since you no longer need the `repo` scope and your previous PAT may not have the `write:packages` scope. +4. 登录到新的 + +{% data variables.product.prodname_container_registry %}. 我们建议创建限于 `read:packages` 和 `write:packages` 范围的新 PAT，因为您不再需要 `repo` 范围，并且您之前的 PAT 不能具有 `write:packages` 范围。 {% raw %} ```shell $ echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin ``` {% endraw %} -5. Push your re-tagged image to the {% data variables.product.prodname_container_registry %}. +5. 将重新标记的映像推送到 {% data variables.product.prodname_container_registry %}。 ```shell $ docker push ghcr.io/OWNER/IMAGE_NAME:VERSION ``` -### Updating your {% data variables.product.prodname_actions %} workflow +### 更新 {% data variables.product.prodname_actions %} 工作流程 -If you have a {% data variables.product.prodname_actions %} workflow that uses a Docker image from the {% data variables.product.prodname_registry %} Docker registry, you may want to update your workflow to the {% data variables.product.prodname_container_registry %} to allow for anonymous access for public container images, finer-grain access permissions, and better storage and bandwidth compatibility for containers. +如果您有 {% data variables.product.prodname_actions %} 工作流程使用来自 {% data variables.product.prodname_registry %} Docker 注册表的 Docker 映像，则可能需要将工作流程更新到 {% data variables.product.prodname_container_registry %}，以允许匿名访问公共容器映像、更细致的访问权限以及更好的容器存储和带宽兼容性。 -1. Migrate your Docker images to the new {% data variables.product.prodname_container_registry %} at `ghcr.io`. For an example, see "[Migrating a Docker image using the Docker CLI](#migrating-a-docker-image-using-the-docker-cli)." +1. 将 Docker 映像迁移到 `ghcr.io` 上的新 {% data variables.product.prodname_container_registry %}。 例如，请参阅“[使用 Docker CLI 迁移 Docker 映像](#migrating-a-docker-image-using-the-docker-cli)”。 -2. In your {% data variables.product.prodname_actions %} workflow file, update the package url from `https://docker.pkg.github.com` to `ghcr.io`. +2. 在 {% data variables.product.prodname_actions %} 工作流程文件中，将包 url 从 `https://docker.pkg.github.com` 更新到 `ghcr.io`。 -3. Add your new {% data variables.product.prodname_container_registry %} authentication personal access token (PAT) as a GitHub ACtions secret. {% data variables.product.prodname_github_container_registry %} does not support using `GITHUB_TOKEN` for your PAT so you must use a different custom variable, such as `CR_PAT`. 更多信息请参阅“[创建和存储加密密码](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)”。 +3. 将新的 {% data variables.product.prodname_container_registry %} 身份验证个人访问令牌 (PAT) 添加为 GitHub ACtions 密码。 {% data variables.product.prodname_github_container_registry %} 不支持对 PAT 使用 `GITHUB_TOKEN`，因此您必须使用不同的自定义变量，例如 `CR_PAT`。 更多信息请参阅“[创建和存储加密密码](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)”。 -4. In your {% data variables.product.prodname_actions %} workflow file, update the authentication PAT by replacing your Docker registry PAT ({% raw %}`${{ secrets.GITHUB_TOKEN }}`{% endraw %}) with a new variable for your {% data variables.product.prodname_container_registry %} PAT, such as {% raw %}`${{ secrets.CR_PAT }}`{% endraw %}. +4. 在 {% data variables.product.prodname_actions %} 工作流程文件中更新身份验证 PAT，将 Docker 注册表 PAT ({% raw %}`${{ secrets.GITHUB_TOKEN }}`{% endraw %}) 替换为 {% data variables.product.prodname_container_registry %} PAT 的新变量，例如 {% raw %}`${{ secrets.CR_PAT }}`{% endraw %}。 -#### Example of updated workflow +#### 更新的工作流程示例 -If part of your workflow accessed a Docker image hosted by the Docker registry like this: +如果工作流程的一部分访问由 Docker 注册表托管的 Docker 映像，如： {% raw %} ```yaml @@ -91,7 +95,7 @@ docker push docker.pkg.github.com/github/octoshift/octoshift:$GITHUB_SHA ``` {% endraw %} -Then you'll need to update your workflow with the new {% data variables.product.prodname_container_registry %} URL and PAT like this: +然后，您需要使用新的 URL 和 PAT {% data variables.product.prodname_container_registry %} 更新工作流程，如： {% raw %} ```yaml diff --git a/translations/zh-CN/content/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images.md b/translations/zh-CN/content/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images.md index 05fc53b92d0a..4ffede1b3d86 100644 --- a/translations/zh-CN/content/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images.md +++ b/translations/zh-CN/content/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images.md @@ -1,6 +1,6 @@ --- -title: Configuring access control and visibility for container images -intro: 'Choose who has read, write, or admin access to your container image and the visibility of your container images on {% data variables.product.prodname_dotcom %}.' +title: 配置容器映像的访问控制和可见性 +intro: '选择谁对容器映像具有读取、写入或管理员访问权限，以及容器映像在 {% data variables.product.prodname_dotcom %} 上的可见性。' product: '{% data reusables.gated-features.packages %}' versions: free-pro-team: '*' @@ -8,60 +8,60 @@ versions: {% data reusables.package_registry.container-registry-beta %} -### Configuring access to container images for your personal account +### 为个人帐户配置对容器映像的访问 -If you have admin permissions to a user-account owned container image, you can assign read, write, or admin roles to other users. For more information about these permission roles, see "[Visibility and access permissions for container images](/packages/getting-started-with-github-container-registry/about-github-container-registry#visibility-and-access-permissions-for-container-images)." +如果您对用户帐户拥有的容器映像具有管理员权限，您可以向其他用户分配读取、写入或管理员角色。 有关这些权限角色的更多信息，请参阅“[容器映像的可见性和访问权限](/packages/getting-started-with-github-container-registry/about-github-container-registry#visibility-and-access-permissions-for-container-images)”。 {% data reusables.package_registry.package-settings-from-user-level %} -1. On the package settings page, click **Invite teams or people** and enter the name, username, or email of the person you want to give access. Teams cannot be given access to a container image owned by a user account. ![Container access invite button](/assets/images/help/package-registry/container-access-invite.png) -1. Next to the username or team name, use the "Role" drop-down menu to select a desired permission level. ![Container access options](/assets/images/help/package-registry/container-access-control-options.png) +1. 在软件包设置页面上，单击 **Invite teams or people（邀请团队或人员）**，然后输入名称、用户名或您想要授予访问权限的人员的电子邮件地址。 不能授予团队访问用户帐户拥有的容器映像。 ![容器访问邀请按钮](/assets/images/help/package-registry/container-access-invite.png) +1. 在用户名或团队名称旁边，使用“Role（角色）”下拉菜单选择所需的权限级别。 ![容器访问选项](/assets/images/help/package-registry/container-access-control-options.png) -The selected users will automatically be given access and don't need to accept an invitation first. +所选用户将自动被授予访问权限，不需要先接受邀请。 -### Configuring access to container images for an organization +### 为企业配置对容器映像的访问 -If you have admin permissions to an organization-owned container image, you can assign read, write, or admin roles to other users and teams. For more information about these permission roles, see "[Visibility and access permissions for container images](/packages/getting-started-with-github-container-registry/about-github-container-registry#visibility-and-access-permissions-for-container-images)." +如果您对组织拥有的容器映像具有管理员权限，您可以向其他用户和团队分配读取、写入或管理员角色。 有关这些权限角色的更多信息，请参阅“[容器映像的可见性和访问权限](/packages/getting-started-with-github-container-registry/about-github-container-registry#visibility-and-access-permissions-for-container-images)”。 -If your package is owned by an organization and private, then you can only give access to other organization members or teams. +如果您的软件包由组织和私人拥有，则您只能向其他组织成员或团队授予访问。 -For organization image containers, organizations admins must enable packages before you can set the visibility to public. For more information, see "[Enabling GitHub Container Registry for your organization](/packages/getting-started-with-github-container-registry/enabling-github-container-registry-for-your-organization)." +对于组织映像容器，组织管理员必须先启用包，然后才能将可见性设置为公共。 更多信息请参阅“[为组织启用 GitHub Container Registry](/packages/getting-started-with-github-container-registry/enabling-github-container-registry-for-your-organization)”。 {% data reusables.package_registry.package-settings-from-org-level %} -1. On the package settings page, click **Invite teams or people** and enter the name, username, or email of the person you want to give access. You can also enter a team name from the organization to give all team members access. ![Container access invite button](/assets/images/help/package-registry/container-access-invite.png) -1. Next to the username or team name, use the "Role" drop-down menu to select a desired permission level. ![Container access options](/assets/images/help/package-registry/container-access-control-options.png) +1. 在软件包设置页面上，单击 **Invite teams or people（邀请团队或人员）**，然后输入名称、用户名或您想要授予访问权限的人员的电子邮件地址。 您还可以从组织输入团队名称，以允许所有团队成员访问。 ![容器访问邀请按钮](/assets/images/help/package-registry/container-access-invite.png) +1. 在用户名或团队名称旁边，使用“Role（角色）”下拉菜单选择所需的权限级别。 ![容器访问选项](/assets/images/help/package-registry/container-access-control-options.png) -The selected users or teams will automatically be given access and don't need to accept an invitation first. +所选用户或团队将自动被授予访问权限，不需要先接受邀请。 -### Configuring visibility of container images for your personal account +### 为个人帐户配置容器映像的可见性 -When you first publish a package, the default visibility is private and only you can see the package. You can modify a private or public container image's access by changing the access settings. +首次发布包时，默认可见性是私有的，只有您才能看到包。 您可以通过更改访问设置来修改私有或公共容器映像的访问权限。 -A public package can be accessed anonymously without authentication. Once you make your package public, you cannot make your package private again. +公共包可以匿名访问，无需身份验证。 包一旦被设为公共，便无法再次将其设为私有。 {% data reusables.package_registry.package-settings-from-user-level %} -5. Under "Danger Zone", choose a visibility setting: - - To make the container image visible to anyone, click **Make public**. +5. 在“Danger Zone（危险区域）”下，选择可见性设置： + - 要使容器映像对任何人都可见，请单击“**Make public（设为公共）**”。 {% warning %} - **Warning:** Once you make a package public, you cannot make it private again. + **警告：**包一旦被设为公共，便无法再次将其设为私有。 {% endwarning %} - - To make the container image visible to a custom selection of people, click **Make private**. ![Container visibility options](/assets/images/help/package-registry/container-visibility-option.png) + - 要使容器映像只对选择的人员可见，请单击“**Make private（设为私有）**”。 ![容器可见性选项](/assets/images/help/package-registry/container-visibility-option.png) -### Configuring visibility of container images for an organization +### 为组织配置容器映像的可见性 -When you first publish a package, the default visibility is private and only you can see the package. You can grant users or teams different access roles for your container image through the access settings. +首次发布包时，默认可见性是私有的，只有您才能看到包。 您可以通过访问设置授予用户或团队对容器映像的不同访问角色。 -A public package can be accessed anonymously without authentication. Once you make your package public, you cannot make your package private again. +公共包可以匿名访问，无需身份验证。 包一旦被设为公共，便无法再次将其设为私有。 -For organization image containers, organizations admins must enable public packages before you can set the visibility to public. For more information, see "[Enabling GitHub Container Registry for your organization](/packages/getting-started-with-github-container-registry/enabling-github-container-registry-for-your-organization)." +对于组织映像容器，组织管理员必须先启用公共包，然后才能将可见性设置为公共。 更多信息请参阅“[为组织启用 GitHub Container Registry](/packages/getting-started-with-github-container-registry/enabling-github-container-registry-for-your-organization)”。 {% data reusables.package_registry.package-settings-from-org-level %} -5. Under "Danger Zone", choose a visibility setting: - - To make the container image visible to anyone, click **Make public**. +5. 在“Danger Zone（危险区域）”下，选择可见性设置： + - 要使容器映像对任何人都可见，请单击“**Make public（设为公共）**”。 {% warning %} - **Warning:** Once you make a package public, you cannot make it private again. + **警告：**包一旦被设为公共，便无法再次将其设为私有。 {% endwarning %} - - To make the container image visible to a custom selection of people, click **Make private**. ![Container visibility options](/assets/images/help/package-registry/container-visibility-option.png) + - 要使容器映像只对选择的人员可见，请单击“**Make private（设为私有）**”。 ![容器可见性选项](/assets/images/help/package-registry/container-visibility-option.png) diff --git a/translations/zh-CN/content/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image.md b/translations/zh-CN/content/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image.md index f42f96fd4762..86bb12cc4096 100644 --- a/translations/zh-CN/content/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image.md +++ b/translations/zh-CN/content/packages/managing-container-images-with-github-container-registry/connecting-a-repository-to-a-container-image.md @@ -1,50 +1,50 @@ --- -title: Connecting a repository to a container image -intro: 'You can link a repository with a container image locally and on {% data variables.product.prodname_dotcom %}.' +title: 将仓库连接到容器映像 +intro: '您可以在本地以及 {% data variables.product.prodname_dotcom %} 上链接仓库与容器映像。' product: '{% data reusables.gated-features.packages %}' versions: free-pro-team: '*' --- -When you link a container image with a repository, the package landing page will show information and links from the repository, such as the README. +在链接容器映像与仓库时，软件包登录页面将显示来自仓库的信息和链接，例如 README。 -To connect a repository and a container image on {% data variables.product.prodname_dotcom %}, they must share the same owner on {% data variables.product.prodname_dotcom %}. For example, both `my_repo` and `hello_docker` are owned by the user `monalisa`: +要在 {% data variables.product.prodname_dotcom %} 上连接仓库和容器映像，它们必须在 {% data variables.product.prodname_dotcom %} 上共用同一个所有者。 例如，`my_repo` 和 `hello_docker` 都归用户 `monalisa` 所有： ```shell https://github.com/monalisa/my_repo https://github.com/monalisa/hello_docker ``` -### Connecting a repository to a user-owned container image on {% data variables.product.prodname_dotcom %} +### 将仓库连接到 {% data variables.product.prodname_dotcom %} 上用户拥有的容器映像 {% data reusables.package_registry.package-settings-from-user-level %} {% data reusables.package_registry.repository_connection_steps %} -### Connecting a repository to an organization-owned container image on {% data variables.product.prodname_dotcom %} +### 将仓库连接到 {% data variables.product.prodname_dotcom %} 上组织拥有的容器映像 {% data reusables.package_registry.package-settings-from-org-level %} {% data reusables.package_registry.repository_connection_steps %} -### Connecting a repository to a container image on the command line +### 将仓库连接到命令行上的容器映像 -1. In your Dockerfile, add this line, replacing `OWNER` and `REPO` with your details: +1. 在 Dockerfile 中添加此行，将 `OWNER` 和 `REPO` 替换为您的详细信息： ```shell LABEL org.opencontainers.image.source https://github.com/OWNER/REPO ``` - For example, if you're the user `monalisa` and own `my-repo`, you would add this line to your Dockerfile: + 例如，如果您是用户 `monalisa` 并且拥有 `my-repo`，您会将此行添加到 Dockerfile： ```shell LABEL org.opencontainers.image.source https://github.com/monalisa/my-repo ``` - For more information, see "[LABEL](https://docs.docker.com/engine/reference/builder/#label)" in the official Docker documentation and "[Pre-defined Annotation Keys](https://github.com/opencontainers/image-spec/blob/master/annotations.md#pre-defined-annotation-keys)" in the `opencontainers/image-spec` repository. + 更多信息请参阅官方 Docker 文档中的“[LABEL](https://docs.docker.com/engine/reference/builder/#label)”，以及 `opencontainers/image-spec` 仓库中的“[预定义的标注键](https://github.com/opencontainers/image-spec/blob/master/annotations.md#pre-defined-annotation-keys)”。 -2. Build your container image. This example builds an image from the Dockerfile in the current directory and assigns the image name `hello_docker`. +2. 构建容器映像。 此示例从当前目录的 Dockerfile 构建映像，并分配映像名称 `hello_docker`。 ```shell $ docker build -t hello_docker . ``` -3. Optionally, review details for the Docker image you want to tag. +3. （可选）查看您想要标记的 Docker 映像的详细信息。 ```shell $ docker images > REPOSITORY TAG IMAGE ID CREATED SIZE @@ -53,7 +53,7 @@ https://github.com/monalisa/hello_docker > hello-world latest fce289e99eb9 16 months ago 1.84kB ``` -4. Tag your Docker image with your desired image name and hosting destination. +4. 使用所需的映像名称和托管目标标记 Docker 映像。 ```shell $ docker tag IMAGE_NAME ghcr.io/OWNER/NEW_IMAGE_NAME:TAG ``` @@ -62,14 +62,16 @@ https://github.com/monalisa/hello_docker $ docker tag 38f737a91f39 ghcr.io/monalisa/hello_docker:latest ``` -5. If you haven't already, authenticate to {% data variables.product.prodname_github_container_registry %}. For more information, see "[Authenticating to GitHub Container Registry](/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images#authenticating-to-github-container-registry)." +5. 如果尚未进行身份验证，请 + +{% data variables.product.prodname_github_container_registry %}. 更多信息请参阅“[向 GitHub Container Registry 验证](/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images#authenticating-to-github-container-registry)”。 {% raw %} ```shell $ echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin > Login Succeeded ``` {% endraw %} -6. Push your container image to {% data variables.product.prodname_github_container_registry %}. +6. 推送容器映像到 {% data variables.product.prodname_github_container_registry %}。 ```shell $ docker push ghcr.io/OWNER/IMAGE-NAME:TAG ``` diff --git a/translations/zh-CN/content/packages/managing-container-images-with-github-container-registry/deleting-a-container-image.md b/translations/zh-CN/content/packages/managing-container-images-with-github-container-registry/deleting-a-container-image.md index 07378043962b..de84b26f7792 100644 --- a/translations/zh-CN/content/packages/managing-container-images-with-github-container-registry/deleting-a-container-image.md +++ b/translations/zh-CN/content/packages/managing-container-images-with-github-container-registry/deleting-a-container-image.md @@ -1,6 +1,6 @@ --- -title: Deleting a container image -intro: 'You can delete a version of a private container image using GraphQL or on {% data variables.product.prodname_dotcom %}.' +title: 删除容器映像 +intro: '您可以使用 GraphQL 或在 {% data variables.product.prodname_dotcom %} 上删除私有容器映像的版本。' product: '{% data reusables.gated-features.packages %}' versions: free-pro-team: '*' @@ -8,13 +8,13 @@ versions: {% data reusables.package_registry.container-registry-beta %} -### About package deletion +### 关于包删除 -You can remove an entire container image or a specific version on {% data variables.product.prodname_dotcom %}. To delete a container image, you must use the UI. Using GraphQL to delete a container image is not supported at this time. +您可以在 {% data variables.product.prodname_dotcom %} 上删除整个容器映像或特定版本。 要删除容器映像，必须使用 UI。 目前不支持使用 GraphQL 来删除容器映像。 -To delete a container image, you must have admin permissions to the container image. +要删除容器映像，您必须具有容器映像的管理员权限。 -When deleting public packages, be aware that you may break projects that depend on your package. +删除公共包时，请注意，您可能会破坏依赖于包的项目。 @@ -22,16 +22,16 @@ When deleting public packages, be aware that you may break projects that depend {% data reusables.package_registry.package-immutability %} -### Deleting a version of a user-owned container image on {% data variables.product.prodname_dotcom %} +### 删除 {% data variables.product.prodname_dotcom %} 上用户拥有的容器映像版本 {% data reusables.package_registry.package-settings-from-user-level %} -5. On the left, click **Manage versions**. +5. 在左侧单击 **Manage versions（管理版本）**。 5. 在要删除的版本的右侧，单击 **Delete（删除）**。 ![删除包按钮](/assets/images/help/package-registry/delete-package-button.png) 6. 要确认删除，请输入包名称，然后单击 **I understand the consequences, delete this version（我明白后果，删除此版本）**。 ![确认包删除按钮](/assets/images/help/package-registry/confirm-package-deletion.png) -### Deleting a version of an organization-owned container image on {% data variables.product.prodname_dotcom %} +### 删除 {% data variables.product.prodname_dotcom %} 上组织拥有的容器映像版本 {% data reusables.package_registry.package-settings-from-org-level %} -5. On the left, click **Manage versions**. +5. 在左侧单击 **Manage versions（管理版本）**。 5. 在要删除的版本的右侧，单击 **Delete（删除）**。 ![删除包按钮](/assets/images/help/package-registry/delete-package-button.png) 6. 要确认删除，请输入包名称，然后单击 **I understand the consequences, delete this version（我明白后果，删除此版本）**。 ![确认包删除按钮](/assets/images/help/package-registry/confirm-package-deletion.png) diff --git a/translations/zh-CN/content/packages/managing-container-images-with-github-container-registry/index.md b/translations/zh-CN/content/packages/managing-container-images-with-github-container-registry/index.md index c556ba7b516c..513c06f6fd08 100644 --- a/translations/zh-CN/content/packages/managing-container-images-with-github-container-registry/index.md +++ b/translations/zh-CN/content/packages/managing-container-images-with-github-container-registry/index.md @@ -1,6 +1,6 @@ --- -title: Managing container images with GitHub Container Registry -intro: 'Learn how to manage container images using a supported CLI or on {% data variables.product.prodname_dotcom %}.' +title: 使用 GitHub Container Registry 管理容器映像 +intro: '了解如何使用受支持的 CLI 管理容器映像或在 {% data variables.product.prodname_dotcom %} 上管理。' versions: free-pro-team: '*' --- diff --git a/translations/zh-CN/content/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images.md b/translations/zh-CN/content/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images.md index 21eaf4e3493d..228c5437b0a9 100644 --- a/translations/zh-CN/content/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images.md +++ b/translations/zh-CN/content/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images.md @@ -1,6 +1,6 @@ --- -title: Pushing and pulling Docker images -intro: 'You can store and manage Docker images in {% data variables.product.prodname_github_container_registry %}.' +title: 推送和拉取 Docker 映像 +intro: '您可以在 {% data variables.product.prodname_github_container_registry %} 中存储和管理 Docker 映像。' product: '{% data reusables.gated-features.packages %}' versions: free-pro-team: '*' @@ -8,55 +8,57 @@ versions: {% data reusables.package_registry.container-registry-beta %} -To push and pull container images owned by an organization, an organization admin must enable {% data variables.product.prodname_github_container_registry %} for the organization. For more information, see "[Enabling GitHub Container Registry for your organization](/packages/getting-started-with-github-container-registry/enabling-github-container-registry-for-your-organization)." +要推送和拉取组织拥有的容器映像，组织管理员必须为组织启用 {% data variables.product.prodname_github_container_registry %}。 更多信息请参阅“[为组织启用 GitHub Container Registry](/packages/getting-started-with-github-container-registry/enabling-github-container-registry-for-your-organization)”。 ### 向 {% data variables.product.prodname_github_container_registry %} 验证 -{% data reusables.package_registry.authenticate-to-container-registry %} +{% data reusables.package_registry.authenticate_with_pat_for_container_registry %} -### Pushing container images +{% data reusables.package_registry.authenticate-to-container-registry-steps %} -This example pushes the latest version of `IMAGE-NAME`. +### 推送容器映像 + +此示例推送最新版本的 `IMAGE-NAME`。 ```shell - $ docker push ghcr.io/OWNER/IMAGE_NAME.latest + $ docker push ghcr.io/OWNER/IMAGE_NAME:latest ``` -This example pushes the `2.5` version of the image. +此示例推送 `2.5` 版的映像。 ```shell $ docker push ghcr.io/OWNER/IMAGE-NAME:2.5 ``` -When you first publish a package, the default visibility is private. To change the visibility or set access permissions, see "[Configuring access control and visibility for container images](/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images)." +首次发布包时，默认可见性是私有的。 要更改可见性或设置访问权限，请参阅“[配置容器映像的访问控制和可见性](/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images)”。 -### Pulling container images +### 拉取容器映像 -#### Pull by digest +#### 通过摘要拉取 -To ensure you're always using the same image, you can specify the exact container image version you want to pull by the `digest` SHA value. +为了确保始终使用相同的映像，您可以通过 `digest` SHA 值指定要拉取的准确容器映像版本。 -1. To find the digest SHA value, use `docker inspect` or `docker pull` and copy the SHA value after `Digest:` +1. 要查找摘要 SHA 值，请使用 `docker inspect` 或 `docker pull`，并复制 `Digest:` 后的 SHA 值 ```shell $ docker inspect ghcr.io/OWNER/IMAGE_NAME ``` -2. Remove image locally as needed. +2. 按需要在本地删除映像。 ```shell - $ docker rmi ghcr.io/OWNER/IMAGE_NAME.latest + $ docker rmi ghcr.io/OWNER/IMAGE_NAME:latest ``` -3. Pull the container image with `@YOUR_SHA_VALUE` after the image name. +3. 拉取图像名称后有 `@YOUR_SHA_VALUE` 的容器映像。 ```shell $ docker pull ghcr.io/OWNER/IMAGE_NAME@sha256:82jf9a84u29hiasldj289498uhois8498hjs29hkuhs ``` -#### Pull by name +#### 按名称拉取 ```shell $ docker pull ghcr.io/OWNER/IMAGE_NAME ``` -#### Pull by name and version +#### 按名称和版本拉取 -Docker CLI example showing an image pulled by its name and the `1.14.1` version tag: +显示按名称和 `1.14.1` 版本标记拉取映像的 Docker CLI 示例： ```shell $ docker pull ghcr.io/OWNER/IMAGE_NAME:1.14.1 > 5e35bd43cf78: Pull complete @@ -68,7 +70,7 @@ Docker CLI example showing an image pulled by its name and the `1.14.1` version > ghcr.io/orgname/image-name/release:1.14.1 ``` -#### Pull by name and latest version +#### 按名称和最新版本拉取 ```shell $ docker pull ghcr.io/OWNER/IMAGE_NAME:latest @@ -78,16 +80,16 @@ Docker CLI example showing an image pulled by its name and the `1.14.1` version > ghcr.io/user/image-name:latest ``` -### Building container images +### 构建容器映像 -This example builds the `hello_docker` image: +此示例构建 `hello_docker` 映像： ```shell $ docker build -t hello_docker . ``` -### Tagging container images +### 标记容器映像 -1. Find the ID for the Docker image you want to tag. +1. 找到要标记的 Docker 映像的 ID。 ```shell $ docker images > REPOSITORY TAG IMAGE ID CREATED SIZE @@ -96,7 +98,7 @@ This example builds the `hello_docker` image: > hello-world latest fce289e99eb9 16 months ago 1.84kB ``` -2. Tag your Docker image using the image ID and your desired image name and hosting destination. +2. 使用映像 ID 以及所需的映像名称和托管目标标记 Docker 映像。 ```shell $ docker tag 38f737a91f39 ghcr.io/OWNER/NEW_IMAGE_NAME:latest ``` diff --git a/translations/zh-CN/content/packages/publishing-and-managing-packages/about-github-packages.md b/translations/zh-CN/content/packages/publishing-and-managing-packages/about-github-packages.md index cb25ef7626c6..1dceead5fc37 100644 --- a/translations/zh-CN/content/packages/publishing-and-managing-packages/about-github-packages.md +++ b/translations/zh-CN/content/packages/publishing-and-managing-packages/about-github-packages.md @@ -30,28 +30,28 @@ versions: #### 查看包 -You can review the package's README, some metadata like licensing, download statistics, version history, and more on {% data variables.product.product_name %}. 更多信息请参阅“[查看包](/packages/publishing-and-managing-packages/viewing-packages)”。 +您可以在 {% data variables.product.product_name %} 上查看软件包的 README、一些元数据（如许可）、下载统计、版本历史记录等。 更多信息请参阅“[查看包](/packages/publishing-and-managing-packages/viewing-packages)”。 -#### About package permissions and visibility +#### 关于包权限和可见性 {% if currentVersion == "free-pro-team@latest" %} -| | Package registries | {% data variables.product.prodname_github_container_registry %} | -| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Hosting locations | You can host multiple packages in one repository. | You can host multiple container images in one organization or user account. | -| Permissions | {% data reusables.package_registry.public-or-private-packages %} 您可以使用 {% data variables.product.prodname_dotcom %} 角色和团队来限制谁可以安装或发布每个包，因为包会继承仓库的权限。 对仓库有读取权限的任何人都可以将包安装为项目中的依赖项，有写入权限的任何人都可以发布新的包版本。 | For each container image, you can choose the access level that others have. The permissions for container image access are separate from your organization and repository permissions. | - Visibility | {% data reusables.package_registry.public-or-private-packages %} | You can set the visibility of each of your container images. A private container image is only visible to people and teams who are given access within your organization. A public container image is visible to anyone. | Anonymous access | N/A | You can access public container images anonymously. +| | 包注册表 | {% data variables.product.prodname_github_container_registry %} +| ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | +| 托管位置 | 您可以在一个仓库中托管多个包。 | 您可以在一个组织或用户帐户中托管多个容器映像。 | +| 权限 | {{ site.data.reusables.package_registry.public-or-private-packages }} 您可以使用 {{ site.data.variables.product.prodname_dotcom }} 角色和团队来限制谁可以安装或发布每个包，因为包会继承仓库的权限。 对仓库有读取权限的任何人都可以将包安装为项目中的依赖项，有写入权限的任何人都可以发布新的包版本。 | 对于每个容器映像，您可以选择其他人具有的访问权限级别。 容器映像访问的权限与组织和仓库权限不同。 | + 可见性 | {% data reusables.package_registry.public-or-private-packages %} | 您可以设置每个容器映像的可见性。 私有容器映像仅对组织内被授予访问权限的人员或团队可见。 公共容器映像对任何人都可见。 | 匿名访问 | N/A| 您可以匿名访问公共容器映像。 {% else %} -| | Package registries | -| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Hosting locations | You can host multiple packages in one repository. | -| Permissions | {% data reusables.package_registry.public-or-private-packages %} 您可以使用 {% data variables.product.prodname_dotcom %} 角色和团队来限制谁可以安装或发布每个包，因为包会继承仓库的权限。 对仓库有读取权限的任何人都可以将包安装为项目中的依赖项，有写入权限的任何人都可以发布新的包版本。 | -| Visibility | {% data reusables.package_registry.public-or-private-packages %} | +| | 包注册表 | +| ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 托管位置 | 您可以在一个仓库中托管多个包。 | +| 权限 | {{ site.data.reusables.package_registry.public-or-private-packages }} 您可以使用 {{ site.data.variables.product.prodname_dotcom }} 角色和团队来限制谁可以安装或发布每个包，因为包会继承仓库的权限。 对仓库有读取权限的任何人都可以将包安装为项目中的依赖项，有写入权限的任何人都可以发布新的包版本。 | +| 可见性 | {% data reusables.package_registry.public-or-private-packages %} {% endif %} {% if currentVersion == "free-pro-team@latest" %} -For more information about permissions and visibility for {% data variables.product.prodname_github_container_registry %}, see "[Configuring access control and visibility for containers](/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images)." +有关 {% data variables.product.prodname_github_container_registry %} 权限和可见性的更多信息，请参阅“[配置容器的访问控制和可见性](/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images)”。 {% endif %} @@ -60,8 +60,7 @@ For more information about permissions and visibility for {% data variables.prod {% data reusables.package_registry.packages-billing %} 更多信息请参阅“[关于 {% data variables.product.prodname_registry %} 的计费](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)”。 - -{{ site.data.reusables/package_registry/container-registry-beta-billing-note }} +{% data reusables.package_registry.container-registry-beta-billing-note %} {% endif %} ### 支持的客户端和格式 @@ -69,32 +68,33 @@ For more information about permissions and visibility for {% data variables.prod {% data variables.product.prodname_registry %} 使用您已经熟悉的原生包工具命令来发布和安装包版本。 {% if currentVersion == "free-pro-team@latest" %} -#### Support for {% data variables.product.prodname_github_container_registry %} +#### 对 {% data variables.product.prodname_github_container_registry %} 的支持 -The {% data variables.product.prodname_github_container_registry %} hosts containers at `ghcr.io/OWNER/IMAGE-NAME`. +{% data variables.product.prodname_github_container_registry %} 在 `ghcr.io/OWNER/IMAGE-NAME` 托管容器。 | 包客户端 | 语言 | 包格式 | 描述 | | ------ | --- | ------------ | ------ | | docker | 不适用 | `Dockerfile` | 节点包管理器 | +有关 -For more information about the container support offered by {% data variables.product.prodname_github_container_registry %}, see "[About {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry)." +{% data variables.product.prodname_github_container_registry %} 提供的容器支持的更多信息，请参阅“[关于 {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry)”。 {% endif %} -#### Support for package registries +#### 对包注册表的支持 {% if currentVersion == "free-pro-team@latest" %} -Package registries use `PACKAGE-TYPE.pkg.github.com/OWNER/REPOSITORY/IMAGE-NAME` as the package host URL, replacing `PACKAGE-TYPE` with the Package namespace. For example, your Gemfile will be hosted at `rubygem.pkg.github.com/OWNER/REPOSITORY/IMAGE-NAME`. +包注册表使用 `PACKAGE-TYPE.pkg.github.com/OWNER/REPOSITORY/IMAGE-NAME` 作为包主机 URL，用包命名空间替换 `PACKAGE-TYPE`。 例如，Gemfile 将托管在 `rubygem.pkg.github.com/OWNER/REPOSITORY/IMAGE-NAME` 上。 {% else %} -The package types supported on {% data variables.product.product_location_enterprise %} may vary since your site administrator can enable or disable support for different package types. For more information, see "[Managing GitHub Packages for your enterprise](/enterprise/admin/packages)." +{% data variables.product.product_location_enterprise %} 支持的软件包类型可能有所不同，因为您的网站管理员可能启用或禁用对不同软件包的支持。 更多信息请参阅“[为企业管理 GitHub Packages](/enterprise/admin/packages)”。 -If {% data variables.product.product_location_enterprise %} has subdomain isolation enabled, then package registries will use `PACKAGE-TYPE.HOSTNAME/OWNER/REPOSITORY/IMAGE-NAME` as the package host URL, replacing `PACKAGE-TYPE` with the Package namespace. For example, your Dockerfile will be hosted at `docker.HOSTNAME/OWNER/REPOSITORY/IMAGE-NAME`. +如果 {% data variables.product.product_location_enterprise %} 已启用子域隔离，则软件包注册表将使用 `PACKAGE-TYPE.HOSTNAME/OWNER/REPOSITORY/IMAGE-NAME` 作为软件包主机 URL，用软件包命名空间替换 `PACKAGE-TYPE`。 例如，Dockerfile 将托管在 `docker.HOSTNAME/OWNER/REPOSITORY/IMAGE-NAME` 上。 -If {% data variables.product.product_location_enterprise %} has subdomain isolation disabled, then package registries will use `HOSTNAME/_registry/PACKAGE-TYPE/OWNER/REPOSITORY/IMAGE-NAME` as the package host URL. For example, your Gemfile will be hosted at `HOSTNAME/_registry/rubygems/OWNER/REPOSITORY/IMAGE-NAME`, replacing *HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance. |{% endif %} +如果 {% data variables.product.product_location_enterprise %} 已禁用子域隔离，则软件包注册表将使用 `HOSTNAME/_registry/PACKAGE-TYPE/OWNER/REPOSITORY/IMAGE-NAME` 作为软件包主机 URL。 例如，Gemfile 将托管在 `HOSTNAME/_registry/rubygems/OWNER/REPOSITORY/IMAGE-NAME` 上，用 {% data variables.product.prodname_ghe_server %} 实例的主机名称替换 *HOSTNAME*。 |{% endif %} {% if currentVersion == "free-pro-team@latest" %} -| 语言 | 描述 | 包格式 | 包客户端 | Package namespace | +| 语言 | 描述 | 包格式 | 包客户端 | 包命名空间 | | ---------- | ---------------------- | ----------------------------------- | ------------ | ----------------------------------------------------- | | JavaScript | 节点包管理器 | `package.json` | `npm` | `npm.pkg.github.com/OWNER/REPOSITORY/IMAGE-NAME` | | Ruby | RubyGems 包管理器 | `Gemfile` | `gem` | `rubygems.pkg.github.com/OWNER/REPOSITORY/IMAGE-NAME` | @@ -104,9 +104,9 @@ If {% data variables.product.product_location_enterprise %} has subdomain isolat {% else %} -With subdomain isolation enabled on {% data variables.product.product_location_enterprise %}: +在 {% data variables.product.product_location_enterprise %} 上启用了子域隔离： -| 语言 | 描述 | 包格式 | 包客户端 | Package namespace | +| 语言 | 描述 | 包格式 | 包客户端 | 包命名空间 | | ---------- | ---------------------- | ----------------------------------- | ------------ | ----------------------------------------------- | | JavaScript | 节点包管理器 | `package.json` | `npm` | `npm.HOSTNAME/OWNER/REPOSITORY/IMAGE-NAME` | | Ruby | RubyGems 包管理器 | `Gemfile` | `gem` | `rubygems.HOSTNAME/OWNER/REPOSITORY/IMAGE-NAME` | @@ -115,9 +115,9 @@ With subdomain isolation enabled on {% data variables.product.product_location_e | .NET | .NET 的 NuGet 包管理 | `nupkg` | `dotnet` CLI | `nuget.HOSTNAME/OWNER/REPOSITORY/IMAGE-NAME` | | 不适用 | Docker 容器管理平台 | `Dockerfile` | `Docker` | `docker.HOSTNAME/OWNER/REPOSITORY/IMAGE-NAME` | -With subdomain isolation disabled on {% data variables.product.product_location_enterprise %}: +在 {% data variables.product.product_location_enterprise %} 上禁用了子域隔离： -| 语言 | 描述 | 包格式 | 包客户端 | Package namespace | +| 语言 | 描述 | 包格式 | 包客户端 | 包命名空间 | | ---------- | ---------------------- | ----------------------------------- | ------------ | --------------------------------------------------------- | | JavaScript | 节点包管理器 | `package.json` | `npm` | `HOSTNAME/_registry/npm/OWNER/REPOSITORY/IMAGE-NAME` | | Ruby | RubyGems 包管理器 | `Gemfile` | `gem` | `HOSTNAME/_registry/rubygems/OWNER/REPOSITORY/IMAGE-NAME` | @@ -127,11 +127,11 @@ With subdomain isolation disabled on {% data variables.product.product_location_ {% note %} -**Note:** Docker is not supported when subdomain isolation is disabled. +**注：**禁用子域隔离时，不支持 Docker。 {% endnote %} -For more information about subdomain isolation, see "[Enabling subdomain isolation](/enterprise/admin/configuration/enabling-subdomain-isolation)." +有关子域隔离的更多信息，请参阅“[启用子域隔离](/enterprise/admin/configuration/enabling-subdomain-isolation)”。 {% endif %} @@ -144,13 +144,13 @@ For more information about subdomain isolation, see "[Enabling subdomain isolati {% if currentVersion == "free-pro-team@latest" %} ### 关于令牌 -| 作用域 | 描述 | -| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `read:packages` | Download and install container images from {% data variables.product.prodname_github_container_registry %} | -| `write:packages` | Upload and publish container images to {% data variables.product.prodname_github_container_registry %} | -| `delete:packages` | Delete specified versions of private or public container images from {% data variables.product.prodname_github_container_registry %}. For more information, see "[Deleting a container image](/packages/managing-container-images-with-github-container-registry/deleting-a-container-image)." | +| 作用域 | 描述 | +| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `read:packages` | 从 {% data variables.product.prodname_github_container_registry %} 下载和安装容器映像 | +| `write:packages` | 上传和发布容器映像到 {% data variables.product.prodname_github_container_registry %} +| `delete:packages` | 从 {% data variables.product.prodname_github_container_registry %} 删除私有或公共容器映像的特定版本。 更多信息请参阅“[删除容器映像](/packages/managing-container-images-with-github-container-registry/deleting-a-container-image)”。 | -To learn about available scopes and permissions for container images, see "[About {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry)" or "[Configuring access control and visibility for container images](/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images)." +要了解容器映像的可用范围和权限，请参阅“[关于 {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry)”或“[配置容器的访问控制和可见性](/packages/managing-container-images-with-github-container-registry/configuring-access-control-and-visibility-for-container-images)”。 更多信息请参阅“[创建个人访问令牌](/github/authenticating-to-github/creating-a-personal-access-token/)”和“[可用作用域](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)”。 @@ -166,9 +166,9 @@ To learn about available scopes and permissions for container images, see "[Abou | 作用域 | 描述 | 仓库权限 | | ----------------- | -------------------------------------------------------------------------- | --------- | -| `read:packages` | 从 {% data variables.product.prodname_registry %} 下载和安装包 | 读取 | -| `write:packages` | 将包上传和发布到 {% data variables.product.prodname_registry %} | 写入 | -| `delete:packages` | 从 {% data variables.product.prodname_registry %} 删除私有包的特定版本 | 管理员 | +| `read:packages` | 从 {% data variables.product.prodname_registry %} 下载和安装包 | 读取 | +| `write:packages` | 将包上传和发布到 {% data variables.product.prodname_registry %} | 写入 | +| `delete:packages` | 从 {% data variables.product.prodname_registry %} 删除私有包的特定版本 | 管理员 | | `repo` | 安装、上传和删除私有仓库中的某些包（对应 `read:packages`、`write:packages` 或 `delete:packages`） | 读取、写入或管理员 | 创建 {% data variables.product.prodname_actions %} 工作流程时，您可以使用 `GITHUB_TOKEN` 发布和安装 {% data variables.product.prodname_registry %} 中的包，无需存储和管理个人访问令牌。 @@ -180,14 +180,15 @@ To learn about available scopes and permissions for container images, see "[Abou ### 管理包 -您可以在 {% data variables.product.product_name %} 上或使用 GraphQL API 删除私有包的版本。 使用 GraphQL API 查询和删除私有包时，必须使用与向 {% data variables.product.prodname_registry %} 验证时相同的令牌。 更多信息请参阅“[删除包](/packages/publishing-and-managing-packages/deleting-a-package)”和“[使用 GraphQL 进行调用](/v4/guides/forming-calls/)”。 +You can delete a version of a private package on {% data variables.product.product_name %} or using the GraphQL API. 使用 GraphQL API 查询和删除私有包时，必须使用与向 {% data variables.product.prodname_registry %} 验证时相同的令牌。 更多信息请参阅“[删除包](/packages/publishing-and-managing-packages/deleting-a-package)”和“[使用 GraphQL 进行调用](/v4/guides/forming-calls/)”。 您可以配置 web 挂钩来订阅与包相关的事件，例如包的发布或更新等事件。 更多信息请参阅“[`package` web 挂钩事件](/webhooks/event-payloads/#package)”。 ### 联系支持 {% if currentVersion == "free-pro-team@latest" %} -如果您对 {% data variables.product.prodname_registry %} 有反馈或功能请求，请使用 [{% data variables.product.prodname_registry %} 反馈表](https://support.github.com/contact/feedback?contact%5Bcategory%5D=github-packages)。 +如果您对 +{% data variables.product.prodname_registry %} 有反馈或功能请求，请使用 [{% data variables.product.prodname_registry %} 反馈表](https://support.github.com/contact/feedback?contact%5Bcategory%5D=github-packages)。 如果在 {% data variables.product.prodname_registry %} 方面遇到以下问题，请使用[我们的联系表](https://support.github.com/contact?form%5Bsubject%5D=Re:%20GitHub%20Packages)联系 {% data variables.contact.github_support %}： @@ -196,6 +197,7 @@ To learn about available scopes and permissions for container images, see "[Abou * 发布的包中含有敏感数据，例如违反 GDPR、API 密钥或个人身份信息 {% else %} -If you need support for {% data variables.product.prodname_registry %}, please contact your site administrators. +如果您需要对 +{% data variables.product.prodname_registry %} 的支持，请联系网站管理员。 {% endif %} diff --git a/translations/zh-CN/content/packages/publishing-and-managing-packages/deleting-a-package.md b/translations/zh-CN/content/packages/publishing-and-managing-packages/deleting-a-package.md index e7c206057724..e231cdd942e4 100644 --- a/translations/zh-CN/content/packages/publishing-and-managing-packages/deleting-a-package.md +++ b/translations/zh-CN/content/packages/publishing-and-managing-packages/deleting-a-package.md @@ -11,7 +11,6 @@ versions: {% data reusables.package_registry.packages-ghes-release-stage %} - {% if currentVersion == "free-pro-team@latest" %} ### 关于私有包删除 @@ -82,4 +81,4 @@ HOSTNAME/graphql 有关 `deletePackageVersion` 突变的更多信息，请参阅“[`deletePackageVersion`](/graphql/reference/mutations#deletepackageversion)”。 -You cannot delete an entire package, but if you delete every version of a package, the package will no longer show on {% data variables.product.product_name %} +您不能删除整个包，但如果您删除包的每个版本，该包将不再显示在 {% data variables.product.product_name %} 上。 diff --git a/translations/zh-CN/content/packages/publishing-and-managing-packages/installing-a-package.md b/translations/zh-CN/content/packages/publishing-and-managing-packages/installing-a-package.md index 7e78de5df4e7..238d159ae691 100644 --- a/translations/zh-CN/content/packages/publishing-and-managing-packages/installing-a-package.md +++ b/translations/zh-CN/content/packages/publishing-and-managing-packages/installing-a-package.md @@ -20,7 +20,7 @@ versions: ### 安装包 -您可以按照一般准则，使用任何支持的包客户端从 {% data variables.product.prodname_registry %} 安装包。 +您可以按照一般准则，使用任何{% if currentVersion == "free-pro-team@latest" %}支持的包客户端{% else %}为您的实例启用的包类型{% endif %}从 {% data variables.product.prodname_registry %} 安装包。 1. 按照包客户端的说明，向 {% data variables.product.prodname_registry %} 验证。 更多信息请参阅“[关于令牌](/packages/publishing-and-managing-packages/about-github-packages#authenticating-to-github-packages)”。 2. 按照包客户端的说明安装包。 diff --git a/translations/zh-CN/content/packages/publishing-and-managing-packages/publishing-a-package.md b/translations/zh-CN/content/packages/publishing-and-managing-packages/publishing-a-package.md index d607258e37fb..74e7635f8353 100644 --- a/translations/zh-CN/content/packages/publishing-and-managing-packages/publishing-a-package.md +++ b/translations/zh-CN/content/packages/publishing-and-managing-packages/publishing-a-package.md @@ -14,19 +14,20 @@ versions: ### 关于发布的包 -您可以在包页面上提供说明和其他详细信息，例如安装和使用说明，以帮助他人了解和使用您的包。 {% data variables.product.product_name %} provides metadata for each version, such as the publication date, download activity, and recent versions. 要查看示例包页面，请参阅 [@Codertocat/hello-world-npm](https://github.com/Codertocat/hello-world-npm/packages/10696?version=1.0.1)。 +您可以在包页面上提供说明和其他详细信息，例如安装和使用说明，以帮助他人了解和使用您的包。 {% data variables.product.product_name %} 提供每个版本的元数据，例如发布日期、下载活动和最新版本。 要查看示例包页面，请参阅 [@Codertocat/hello-world-npm](https://github.com/Codertocat/hello-world-npm/packages/10696?version=1.0.1)。 {% data reusables.package_registry.public-or-private-packages %} 一个仓库可包含多个包。 为避免混淆，请确保使用自述文件和说明清楚地阐明每个包的相关信息。 {% data reusables.package_registry.package-immutability %} {% if currentVersion == "free-pro-team@latest" %} -If a new version of a package fixes a security vulnerability, you should publish a security advisory in your repository. {% data variables.product.prodname_dotcom %} reviews each published security advisory and may use it to send {% data variables.product.prodname_dependabot_short %} alerts to affected repositories. For more information, see "[About GitHub Security Advisories](/github/managing-security-vulnerabilities/about-github-security-advisories)." +如果软件包的新版本修复了安全漏洞，您应该在仓库中发布安全通告。 +{% data variables.product.prodname_dotcom %} 审查每个发布的安全通告，并且可能使用它向受影响的仓库发送 {% data variables.product.prodname_dependabot_short %} 警报。 更多信息请参阅“[关于 GitHub 安全通告](/github/managing-security-vulnerabilities/about-github-security-advisories)”。 {% endif %} ### 发布包 -您可以按照一般准则，使用任何支持的包客户端将包发布到 {% data variables.product.prodname_registry %}。 +您可以按照一般准则，使用任何{% if currentVersion == "free-pro-team@latest" %}支持的包客户端{% else %}为您的实例启用的包类型{% endif %}将包发布到 {% data variables.product.prodname_registry %}。 1. 针对要完成的任务，创建具有适当作用域的访问令牌或使用现有的此类令牌。 更多信息请参阅“[关于 {% data variables.product.prodname_registry %}](/packages/publishing-and-managing-packages/about-github-packages#authenticating-to-github-packages)”。 2. 按照包客户端的说明，使用访问令牌向 {% data variables.product.prodname_registry %} 验证。 diff --git a/translations/zh-CN/content/packages/publishing-and-managing-packages/viewing-packages.md b/translations/zh-CN/content/packages/publishing-and-managing-packages/viewing-packages.md index 809c1e2ea550..8e54ea9650e2 100644 --- a/translations/zh-CN/content/packages/publishing-and-managing-packages/viewing-packages.md +++ b/translations/zh-CN/content/packages/publishing-and-managing-packages/viewing-packages.md @@ -1,6 +1,6 @@ --- title: 查看包 -intro: 您可以查看已发布到仓库的包的详细信息，也可以按组织或用户缩小结果范围。 +intro: '您可以查看已发布到仓库的包的详细信息，也可以按组织或用户缩小结果范围。' product: '{% data reusables.gated-features.packages %}' redirect_from: - /articles/viewing-a-repositorys-packages @@ -32,8 +32,8 @@ versions: {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} -3. Under your organization name, click -{% octicon "package" aria-label="The package icon" %} **Packages**. +3. 在组织名称下，单击 +{% octicon "package" aria-label="The package icon" %} **包**. {% data reusables.package_registry.navigate-to-packages %} ### 查看您的包 diff --git a/translations/zh-CN/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-apache-maven-for-use-with-github-packages.md b/translations/zh-CN/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-apache-maven-for-use-with-github-packages.md index 0ddf23ee9f2b..13b5a865bcc4 100644 --- a/translations/zh-CN/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-apache-maven-for-use-with-github-packages.md +++ b/translations/zh-CN/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-apache-maven-for-use-with-github-packages.md @@ -1,6 +1,6 @@ --- -title: 配置 Apache Maven 用于 GitHub 包 -intro: '您可以配置 Apache Maven 以将包发布到 {% data variables.product.prodname_registry %} 并将存储在 {% data variables.product.prodname_registry %} 上的包用作 Java 项目中的依赖项。' +title: Configuring Apache Maven for use with GitHub Packages +intro: 'You can configure Apache Maven to publish packages to {% data variables.product.prodname_registry %} and to use packages stored on {% data variables.product.prodname_registry %} as dependencies in a Java project.' product: '{% data reusables.gated-features.packages %}' redirect_from: - /articles/configuring-apache-maven-for-use-with-github-package-registry @@ -13,28 +13,28 @@ versions: {% data reusables.package_registry.packages-ghes-release-stage %} -**注：**安装或发布 Docker 映像时，{% data variables.product.prodname_registry %} 当前不支持外部图层，如 Windows 映像。 +{% data reusables.package_registry.admins-can-configure-package-types %} -### 向 {% data variables.product.prodname_registry %} 验证 +### Authenticating to {% data variables.product.prodname_registry %} {% data reusables.package_registry.authenticate-packages %} -#### 使用个人访问令牌进行身份验证 +#### Authenticating with a personal access token {% data reusables.package_registry.required-scopes %} -通过编辑 *~/.m2/settings.xml* 文件以包含个人访问令牌，您可以使用 Apache Maven 向 {% data variables.product.prodname_registry %} 验证。 如果 *~/.m2/settings.xml* 文件不存在，请新建该文件。 +You can authenticate to {% data variables.product.prodname_registry %} with Apache Maven by editing your *~/.m2/settings.xml* file to include your personal access token. Create a new *~/.m2/settings.xml* file if one doesn't exist. -在 `servers` 标记中，添加带 `id` 的子 `server` 标记，将 *USERNAME* 替换为您的 {% data variables.product.prodname_dotcom %} 用户名，将 *TOKEN* 替换为您的个人访问令牌。 +In the `servers` tag, add a child `server` tag with an `id`, replacing *USERNAME* with your {% data variables.product.prodname_dotcom %} username, and *TOKEN* with your personal access token. -在 `repositories` 标记中，通过将仓库的 `id` 映射到您在包含凭据的 `server` 标记中添加的 `id` 来配置仓库。 在 `repositories` 标记中，通过将仓库的 `id` 映射到您在包含凭据的 `server` 标记中添加的 `id` 来配置仓库。 {% data reusables.package_registry.lowercase-name-field %} +In the `repositories` tag, configure a repository by mapping the `id` of the repository to the `id` you added in the `server` tag containing your credentials. Replace {% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance, {% endif %}*REPOSITORY* with the name of the repository you'd like to publish a package to or install a package from, and *OWNER* with the name of the user or organization account that owns the repository. {% data reusables.package_registry.lowercase-name-field %} -如果要与多个仓库交互，您可以将每个仓库添加到 `repository` 标记中独立的子 `repositories`，将每个仓库的 `id` 映射到 `servers` 标记中的凭据。 +If you want to interact with multiple repositories, you can add each repository to separate `repository` children in the `repositories` tag, mapping the `id` of each to the credentials in the `servers` tag. {% data reusables.package_registry.apache-maven-snapshot-versions-supported %} {% if currentVersion != "free-pro-team@latest" %} -有关创建包的更多信息，请参阅 [maven.apache.org 文档](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html)。 +If your instance has subdomain isolation enabled: {% endif %} ``` @@ -60,7 +60,7 @@ versions: github GitHub OWNER Apache Maven Packages - https://maven.pkg.github.com/OWNER/REPOSITORY + https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}maven.HOSTNAME{% endif %}/OWNER/REPOSITORY @@ -77,7 +77,7 @@ versions: ``` {% if currentVersion != "free-pro-team@latest" %} -例如，*OctodogApp* 和 *OctocatApp* 项目将发布到同一个仓库： +If your instance has subdomain isolation disabled: ``` ` 元素中包含该仓库的 URL。 {% data variables.product.prodname_dotcom %} will match the repository based on that field. 由于仓库名称也是 `distributionManagement` 元素的一部分，因此将多个包发布到同一个仓库无需额外步骤、 +If you would like to publish multiple packages to the same repository, you can include the URL of the repository in the `` element of the *pom.xml* file. {% data variables.product.prodname_dotcom %} will match the repository based on that field. Since the repository name is also part of the `distributionManagement` element, there are no additional steps to publish multiple packages to the same repository. -有关创建包的更多信息，请参阅 [maven.apache.org 文档](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html)。 +For more information on creating a package, see the [maven.apache.org documentation](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html). -1. 编辑包目录中 *pom.xml* 文件的 `distributionManagement` 元素，将 `OWNER` 替换为拥有该仓库的用户或组织帐户的名称，将 `REPOSITORY` 替换为包含项目的仓库的名称。 - -在 `servers` 标记中，添加带 `id` 的子 `server` 标记，将 *USERNAME* 替换为您的 {% data variables.product.prodname_dotcom %} 用户名，将 *TOKEN* 替换为您的个人访问令牌。 +1. Edit the `distributionManagement` element of the *pom.xml* file located in your package directory, replacing {% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance, {% endif %}`OWNER` with the name of the user or organization account that owns the repository and `REPOSITORY` with the name of the repository containing your project. {% if currentVersion != "free-pro-team@latest" %} - 有关创建包的更多信息，请参阅 [maven.apache.org 文档](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html)。 + If your instance has subdomain isolation enabled: {% endif %} ``` github GitHub OWNER Apache Maven Packages - https://maven.pkg.github.com/OWNER/REPOSITORY + https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}maven.HOSTNAME{% endif %}/OWNER/REPOSITORY ``` {% if currentVersion != "free-pro-team@latest" %} - 例如，*OctodogApp* 和 *OctocatApp* 项目将发布到同一个仓库： + If your instance has subdomain isolation disabled: ``` @@ -158,7 +156,7 @@ versions: ``` {% endif %} -2. 发布包。 +2. Publish the package. ```shell $ mvn deploy @@ -166,12 +164,12 @@ versions: {% data reusables.package_registry.viewing-packages %} -### 安装包 +### Installing a package -要从 {% data variables.product.prodname_registry %} 安装 Apache Maven 包，请编辑 *pom.xml* 文件以包含该包作为依赖项。 如果要从多个仓库安装包，请为每个仓库添加 `repository` 标记。 有关在项目中使用 *pom.xml* 文件的更多信息，请参阅 Apache Maven 文档中的“[POM 简介](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html)”。 +To install an Apache Maven package from {% data variables.product.prodname_registry %}, edit the *pom.xml* file to include the package as a dependency. If you want to install packages from more than one repository, add a `repository` tag for each. For more information on using a *pom.xml* file in your project, see "[Introduction to the POM](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html)" in the Apache Maven documentation. {% data reusables.package_registry.authenticate-step %} -2. 将包依赖项添加到项目 *pom.xml* 文件的 `dependencies` 元素，将 `com.example:test` 替换为您的包。 +2. Add the package dependencies to the `dependencies` element of your project *pom.xml* file, replacing `com.example:test` with your package. ``` @@ -182,13 +180,13 @@ versions: ``` -3. 安装包。 +3. Install the package. ```shell $ mvn install ``` -### 延伸阅读 +### Further reading -- "[配置 Gradle 用于 {% data variables.product.prodname_registry %}](/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages)" -- “[删除包](/packages/publishing-and-managing-packages/deleting-a-package/)” +- "[Configuring Gradle for use with {% data variables.product.prodname_registry %}](/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages)" +- "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package/)" diff --git a/translations/zh-CN/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md b/translations/zh-CN/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md index 6187f11792d5..59c0d2c8b81b 100644 --- a/translations/zh-CN/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md +++ b/translations/zh-CN/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages.md @@ -1,6 +1,6 @@ --- -title: 配置 Docker 用于 GitHub 包 -intro: '您可以配置 Docker 客户端以使用 {% data variables.product.prodname_registry %} 发布和检索 docker 镜像。' +title: Configuring Docker for use with GitHub Packages +intro: 'You can configure the Docker client to use {% data variables.product.prodname_registry %} to publish and retrieve docker images.' product: '{% data reusables.gated-features.packages %}' redirect_from: - /articles/configuring-docker-for-use-with-github-package-registry @@ -13,17 +13,13 @@ versions: {% data reusables.package_registry.packages-ghes-release-stage %} -**注：**安装或发布 Docker 映像时，{% data variables.product.prodname_registry %} 当前不支持外部图层，如 Windows 映像。 +{% data reusables.package_registry.admins-can-configure-package-types %} -### 向 {% data variables.product.prodname_registry %} 验证 +### About Docker and {% data variables.product.prodname_registry %} -{% warning %} +{% data reusables.package_registry.docker_registry_deprecation_status %} -# Build the image with docker.pkg.github.com/<em>OWNER/REPOSITORY/IMAGE_NAME:VERSION</em> # Assumes Dockerfile resides in the current working directory (.) $ docker build -t docker.pkg.github.com/octocat/octo-app/monalisa:1.0 . # Push the image to {% data variables.product.prodname_registry %} $ docker push docker.pkg.github.com/octocat/octo-app/monalisa:1.0 - -{% endwarning %} - -您可以使用 `docker` 登录命令，通过 Docker 向 {% data variables.product.prodname_registry %} 验证。 +When installing or publishing a docker image, {% data variables.product.prodname_registry %} does not currently support foreign layers, such as Windows images. {% if currentVersion != "free-pro-team@latest" %} @@ -31,17 +27,19 @@ Before you can use the Docker registry on {% data variables.product.prodname_reg {% endif %} -### 向 {% data variables.product.prodname_registry %} 验证 +### Authenticating to {% data variables.product.prodname_registry %} + +{% data reusables.package_registry.docker_registry_deprecation_status %} {% data reusables.package_registry.authenticate-packages %} -#### 使用个人访问令牌进行身份验证 +#### Authenticating with a personal access token {% data reusables.package_registry.required-scopes %} -您可以使用 `docker` 登录命令，通过 Docker 向 {% data variables.product.prodname_registry %} 验证。 +You can authenticate to {% data variables.product.prodname_registry %} with Docker using the `docker` login command. -为确保凭据安全，我们建议您将个人访问令牌保存在您计算机上的本地文件中，然后使用 Docker 的 `--password-stdin` 标志从本地文件读取您的令牌。 +To keep your credentials secure, we recommend you save your personal access token in a local file on your computer and use Docker's `--password-stdin` flag, which reads your token from a local file. {% if currentVersion == "free-pro-team@latest" %} {% raw %} @@ -59,42 +57,42 @@ Before you can use the Docker registry on {% data variables.product.prodname_reg {% endraw %} {% endif %} -要使用此示例登录命令，请将 `USERNAME` 替换为您的 {% data variables.product.prodname_dotcom %} 用户名，将 `~/TOKEN.txt` 替换为您用于 {% data variables.product.prodname_dotcom %} 的个人访问令牌的文件路径。 +To use this example login command, replace `USERNAME` with your {% data variables.product.product_name %} username{% if currentVersion != "free-pro-team@latest" %}, `HOSTNAME` with the URL for {% data variables.product.product_location_enterprise %},{% endif %} and `~/TOKEN.txt` with the file path to your personal access token for {% data variables.product.product_name %}. -更多信息请参阅“[Docker 登录](https://docs.docker.com/engine/reference/commandline/login/#provide-a-password-using-stdin)”。 +For more information, see "[Docker login](https://docs.docker.com/engine/reference/commandline/login/#provide-a-password-using-stdin)." -#### 使用 `GITHUB_TOKEN` 进行身份验证 +#### Authenticating with the `GITHUB_TOKEN` {% data reusables.package_registry.package-registry-with-github-tokens %} -### 发布包 +### Publishing a package -{% data variables.product.prodname_registry %} 支持每个仓库的多个顶层 Docker 镜像。 仓库可以拥有任意数量的映像标记。 在发布或安装大于 10GB 的 Docker 映像（每个图层上限为 5GB）时，可能会遇到服务降级的情况。 更多信息请参阅 Docker 文档中的“[Docker 标记](https://docs.docker.com/engine/reference/commandline/tag/)”。 +{% data reusables.package_registry.docker_registry_deprecation_status %} + +{% data variables.product.prodname_registry %} supports multiple top-level Docker images per repository. A repository can have any number of image tags. You may experience degraded service publishing or installing Docker images larger than 10GB, layers are capped at 5GB each. For more information, see "[Docker tag](https://docs.docker.com/engine/reference/commandline/tag/)" in the Docker documentation. {% data reusables.package_registry.lowercase-name-field %} {% data reusables.package_registry.viewing-packages %} -1. 使用 `docker images` 确定 docker 映像的名称和 ID。 +1. Determine the image name and ID for your docker image using `docker images`. ```shell $ docker images > < > > REPOSITORY TAG IMAGE ID CREATED SIZE > IMAGE_NAME VERSION IMAGE_ID 4 weeks ago 1.11MB ``` -2. 使用 Docker 映像 ID 标记 docker 映像，将 *OWNER* 替换为拥有仓库的用户或组织帐户的名称，将 *REPOSITORY* 替换为包含项目的仓库的名称，将 *IMAGE_NAME* 替换为包或映像的名称，将 *VERSION* 替换为构建时的包版本。 -{% if currentVersion != "free-pro-team@latest" %} *HOSTNAME* with the hostname of {% data variables.product.product_location_enterprise %},{% endif %} and *VERSION* with package version at build time. +2. Using the Docker image ID, tag the docker image, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image,{% if currentVersion != "free-pro-team@latest" %} *HOSTNAME* with the hostname of {% data variables.product.product_location_enterprise %},{% endif %} and *VERSION* with package version at build time. {% if currentVersion == "free-pro-team@latest" %} ```shell $ docker tag IMAGE_ID docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME:VERSION ``` {% else %} ```shell - 如果尚未为包构建 docker 映像，请构建映像，将 OWNER 替换为拥有仓库的用户或组织帐户的名称，将 REPOSITORY 替换为包含项目的仓库的名称，将 IMAGE_NAME 替换为包或映像的名称，将 VERSION 替换为构建时的包版本，将 PATH 替换为映像路径（如果映像未在当前工作目录中）。 + $ docker tag IMAGE_ID docker.HOSTNAME/OWNER/REPOSITORY/IMAGE_NAME:VERSION ``` {% endif %} -3. 您可能首次发布新的 Docker 映像并将其命名为 `monalisa`。 -{% if currentVersion != "free-pro-team@latest" %} *HOSTNAME* with the hostname of {% data variables.product.product_location_enterprise %},{% endif %} and *PATH* to the image if it isn't in the current working directory.s +3. If you haven't already built a docker image for the package, build the image, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image, *VERSION* with package version at build time,{% if currentVersion != "free-pro-team@latest" %} *HOSTNAME* with the hostname of {% data variables.product.product_location_enterprise %},{% endif %} and *PATH* to the image if it isn't in the current working directory.s {% if currentVersion == "free-pro-team@latest" %} ```shell $ docker build -t docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME:VERSION PATH @@ -104,7 +102,7 @@ Before you can use the Docker registry on {% data variables.product.prodname_reg $ docker build -t docker.HOSTNAME/OWNER/REPOSITORY/IMAGE_NAME:VERSION PATH ``` {% endif %} -4. 将映像发布到 {% data variables.product.prodname_registry %}。 +4. Publish the image to {% data variables.product.prodname_registry %}. {% if currentVersion == "free-pro-team@latest" %} ```shell $ docker push docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME:VERSION @@ -116,13 +114,15 @@ Before you can use the Docker registry on {% data variables.product.prodname_reg {% endif %} {% note %} - **注：**必须使用 `IMAGE_NAME:VERSION` 推送映像，而不能使用 `IMAGE_NAME:SHA`。 + **Note:** You must push your image using `IMAGE_NAME:VERSION` and not using `IMAGE_NAME:SHA`. {% endnote %} -#### 发布 Docker 映像的示例 +#### Example publishing a Docker image + +{% data reusables.package_registry.docker_registry_deprecation_status %} -您可以使用映像 ID 将 `monalisa` 映像的 1.0 版本发布到 `octocat/octo-app` 仓库。 +You can publish version 1.0 of the `monalisa` image to the `octocat/octo-app` repository using an image ID. {% if currentVersion == "free-pro-team@latest" %} ```shell @@ -155,7 +155,7 @@ $ docker push docker.HOSTNAME/octocat/octo-app/monalisa:1.0 {% endif %} -您可能首次发布新的 Docker 映像并将其命名为 `monalisa`。 +You can publish a new Docker image for the first time and name it `monalisa`. {% if currentVersion == "free-pro-team@latest" %} ```shell @@ -178,10 +178,11 @@ $ docker push docker.HOSTNAME/octocat/octo-app/monalisa:1.0 ``` {% endif %} -### 安装包 +### Installing a package -您可以使用 `docker pull` 命令从 {% data variables.product.prodname_registry %} 安装 Docker 映像，将 *OWNER* 替换为拥有仓库的用户或组织帐户的名称，将 *REPOSITORY* 替换为包含项目的仓库的名称，将 *IMAGE_NAME* 替换为包或映像的名称，将 *TAG_NAME* 替换为要安装的映像的标记。 {% data reusables.package_registry.lowercase-name-field %} +{% data reusables.package_registry.docker_registry_deprecation_status %} +You can use the `docker pull` command to install a docker image from {% data variables.product.prodname_registry %}, replacing *OWNER* with the name of the user or organization account that owns the repository, *REPOSITORY* with the name of the repository containing your project, *IMAGE_NAME* with name of the package or image,{% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance, {% endif %} and *TAG_NAME* with tag for the image you want to install. {% data reusables.package_registry.lowercase-name-field %} {% if currentVersion == "free-pro-team@latest" %} ```shell @@ -195,11 +196,10 @@ $ docker pull docker.HOSTNAME/OWNER/REPOSITORY/IMAGE_NAME:TAG_NAME {% note %} -**注：**必须使用 `IMAGE_NAME:VERSION` 推送映像，而不能使用 `IMAGE_NAME:SHA`。 +**Note:** You must pull the image using `IMAGE_NAME:VERSION` and not using `IMAGE_NAME:SHA`. {% endnote %} +### Further reading -### 延伸阅读 - -- “[删除包](/packages/publishing-and-managing-packages/deleting-a-package/)” +- "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package/)" diff --git a/translations/zh-CN/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-dotnet-cli-for-use-with-github-packages.md b/translations/zh-CN/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-dotnet-cli-for-use-with-github-packages.md index 8589ea0ca0e6..1738b9e9ecc4 100644 --- a/translations/zh-CN/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-dotnet-cli-for-use-with-github-packages.md +++ b/translations/zh-CN/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-dotnet-cli-for-use-with-github-packages.md @@ -1,6 +1,6 @@ --- -title: Configuring `dotnet` CLI for use with GitHub Packages -intro: 'You can configure the `dotnet` command-line interface (CLI) to publish NuGet packages to {% data variables.product.prodname_registry %} and to use packages stored on {% data variables.product.prodname_registry %} as dependencies in a .NET project.' +title: 配置 `dotnet` CLI 用于 GitHub 包 +intro: '您可以配置 `dotnet` 命令行接口 (CLI) 以将 NuGet 包发布到 {% data variables.product.prodname_registry %} 并将存储在 {% data variables.product.prodname_registry %} 上的包用作 .NET 项目中的依赖项。' product: '{% data reusables.gated-features.packages %}' redirect_from: - /articles/configuring-nuget-for-use-with-github-package-registry @@ -14,25 +14,25 @@ versions: {% data reusables.package_registry.packages-ghes-release-stage %} -{% data reusables.package_registry.admins-can-configure-package-types %} +**注：**安装或发布 Docker 映像时，{% data variables.product.prodname_registry %} 当前不支持外部图层，如 Windows 映像。 -### Authenticating to {% data variables.product.prodname_registry %} +### 向 {% data variables.product.prodname_registry %} 验证 {% data reusables.package_registry.authenticate-packages %} -#### Authenticating with a personal access token +#### 使用个人访问令牌进行身份验证 {% data reusables.package_registry.required-scopes %} -To authenticate to {% data variables.product.prodname_registry %} with the `dotnet` command-line interface (CLI), create a *nuget.config* file in your project directory specifying {% data variables.product.prodname_registry %} as a source under `packageSources` for the `dotnet` CLI client. +要使用 `dotnet` 命令行接口 (CLI) 向 {% data variables.product.prodname_registry %} 验证，请在项目目录中创建一个 *nuget.config* 文件，将 {% data variables.product.prodname_registry %} 指定为 `dotnet` CLI 客户端的 `packageSources` 下的源。 -You must replace: -- `USERNAME` with the name of your user account on {% data variables.product.prodname_dotcom %}. -- `TOKEN` with your personal access token. -- `OWNER` with the name of the user or organization account that owns the repository containing your project.{% if currentVersion != "free-pro-team@latest" %} -- `HOSTNAME` with the host name for your {% data variables.product.prodname_ghe_server %} instance. +必须： +- 将 `USERNAME` 替换为您在 {% data variables.product.prodname_dotcom %} 上的用户帐户的名称。 +- 将 `TOKEN` 替换为您的个人访问令牌。 +- 将 `OWNER` 替换为拥有项目所在仓库的用户或组织帐户的名称。{% if currentVersion != "free-pro-team@latest" %} +- 拥有 {% data variables.product.prodname_ghe_server %} 实例主机名称的 `HOSTNAME`。 -If your instance has subdomain isolation enabled: +有关创建包的更多信息，请参阅 [maven.apache.org 文档](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html)。 {% endif %} ```xml @@ -52,45 +52,46 @@ If your instance has subdomain isolation enabled: ``` {% if currentVersion != "free-pro-team@latest" %} -If your instance has subdomain isolation disabled: +例如，*OctodogApp* 和 *OctocatApp* 项目将发布到同一个仓库： ```xml - - - - - - - - - - - - - + + + + Exe + netcoreapp3.0 + OctodogApp + 1.0.0 + Octodog + GitHub + This package adds an Octodog! + https://github.com/octo-org/octo-cats-and-dogs + + + ``` {% endif %} -#### Authenticating with the `GITHUB_TOKEN` +#### 使用 `GITHUB_TOKEN` 进行身份验证 {% data reusables.package_registry.package-registry-with-github-tokens %} -### Publishing a package +### 发布包 -You can publish a package to {% data variables.product.prodname_registry %} by authenticating with a *nuget.config* file. When publishing, you need to use the same value for `OWNER` in your *csproj* file that you use in your *nuget.config* authentication file. Specify or increment the version number in your *.csproj* file, then use the `dotnet pack` command to create a *.nuspec* file for that version. For more information on creating your package, see "[Create and publish a package](https://docs.microsoft.com/en-us/nuget/quickstart/create-and-publish-a-package-using-the-dotnet-cli)" in the Microsoft documentation. +您可以使用 *nuget.config* 文件进行身份验证，将包发布到 {% data variables.product.prodname_registry %}。 发布时，您需要将 *csproj* 文件中的 `OWNER` 值用于您的 *nuget.config* 身份验证文件。 在 *.csproj* 文件中指定或增加版本号，然后使用 `dotnet pack` 命令创建该版本的 *.nuspec* 文件。 有关创建包的更多信息，请参阅 Microsoft 文档中的“[创建和发布包](https://docs.microsoft.com/en-us/nuget/quickstart/create-and-publish-a-package-using-the-dotnet-cli)”。 {% data reusables.package_registry.viewing-packages %} {% data reusables.package_registry.authenticate-step %} -2. Create a new project. +2. 创建一个新项目。 ```shell dotnet new console --name OctocatApp ``` -3. Add your project's specific information to your project's file, which ends in *.csproj*. You must replace: - - `OWNER` with the name of the user or organization account that owns the repository containing your project. - - `REPOSITORY` with the name of the repository containing the package you want to publish. - - `1.0.0` with the version number of the package.{% if currentVersion != "free-pro-team@latest" %} - - `HOSTNAME` with the host name for your {% data variables.product.prodname_ghe_server %} instance.{% endif %} +3. 将项目的特定信息添加到以 *.csproj* 结尾的项目文件中。 必须： + - 将 `OWNER` 替换为拥有项目所在仓库的用户或组织帐户的名称。 + - 将 `REPOSITORY` 替换为要发布的包所在仓库的名称。 + - 将 `1.0.0` 替换为包的版本号。{% if currentVersion != "free-pro-team@latest" %} + - 拥有 {% data variables.product.prodname_ghe_server %} 实例主机名称的 `HOSTNAME`。{% endif %} ``` xml @@ -107,21 +108,21 @@ You can publish a package to {% data variables.product.prodname_registry %} by a ``` -4. Package the project. +4. 打包项目。 ```shell dotnet pack --configuration Release ``` -5. Publish the package using the `key` you specified in the *nuget.config* file. +5. 使用您在 *nuget.config* 文件中指定的 `key` 发布包。 ```shell dotnet nuget push "bin/Release/OctocatApp.1.0.0.nupkg" --source "github" ``` -### Publishing multiple packages to the same repository +### 将多个包发布到同一个仓库 -To publish multiple packages to the same repository, you can include the same {% data variables.product.prodname_dotcom %} repository URL in the `RepositoryURL` fields in all *.csproj* project files. {% data variables.product.prodname_dotcom %} matches the repository based on that field. +要将多个包发布到同一个仓库，您可以在所有 *.csproj* 项目文件的 `RepositoryURL` 字段中包含相同的 {% data variables.product.prodname_dotcom %} 仓库 URL。 {% data variables.product.prodname_dotcom %} 根据该字段匹配仓库。 -For example, the *OctodogApp* and *OctocatApp* projects will publish to the same repository: +例如，*OctodogApp* 和 *OctocatApp* 项目将发布到同一个仓库： ``` xml @@ -157,14 +158,13 @@ For example, the *OctodogApp* and *OctocatApp* projects will publish to the same ``` +### 安装包 -### Installing a package - -Using packages from {% data variables.product.prodname_dotcom %} in your project is similar to using packages from *nuget.org*. Add your package dependencies to your *.csproj* file, specifying the package name and version. For more information on using a *.csproj* file in your project, see "[Working with NuGet packages](https://docs.microsoft.com/en-us/nuget/consume-packages/overview-and-workflow)" in the Microsoft documentation. +在项目中使用来自 {% data variables.product.prodname_dotcom %} 的包类似于使用来自 *nuget.org* 的包。 将包依赖项添加到 *.csproj* 文件以指定包名称和版本。 有关在项目中使用 *.csproj* 文件的更多信息，请参阅 Microsoft 文档中的“[使用 NuGet 包](https://docs.microsoft.com/en-us/nuget/consume-packages/overview-and-workflow)”。 {% data reusables.package_registry.authenticate-step %} -2. To use a package, add `ItemGroup` and configure the `PackageReference` field in the *.csproj* project file, replacing the `OctokittenApp` package with your package dependency and `1.0.0` with the version you want to use: +2. 要使用包，请添加 `ItemGroup` 并配置 *.csproj* 项目文件中的 `PackageReference` 字段，将 `OctokittenApp` 包替换为您的包依赖项，将 `1.0.0` 替换为您要使用的版本： ``` xml @@ -186,11 +186,11 @@ Using packages from {% data variables.product.prodname_dotcom %} in your project ``` -3. Install the packages with the `restore` command. +3. 使用 `restore` 命令安装包。 ```shell dotnet restore ``` -### Further reading +### 延伸阅读 -- "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package/)" +- “[删除包](/packages/publishing-and-managing-packages/deleting-a-package/)” diff --git a/translations/zh-CN/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages.md b/translations/zh-CN/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages.md index 2adc18c36530..e8042a94bce4 100644 --- a/translations/zh-CN/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages.md +++ b/translations/zh-CN/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-gradle-for-use-with-github-packages.md @@ -26,7 +26,8 @@ versions: 您可以使用 Gradle Groovy 或 Kotlin DSL，通过 Gradle 向 {% data variables.product.prodname_registry %} 验证，方法是编辑 *build.gradle* 文件 (Gradle Groovy) 或 *build.gradle.kts* 文件 (Kotlin DSL) 以包含您的个人访问令牌。 您还可以配置 Gradle Groovy 和 Kotlin DSL 以识别仓库中的一个或多个包。 {% if currentVersion != "free-pro-team@latest" %} -Replace *REGISTRY-URL* with the URL for your instance's Maven registry. If your instance has subdomain isolation enabled, use `maven.HOSTNAME`. If your instance has subdomain isolation disabled, use `HOSTNAME/_registry/maven`. In either case, replace *HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance. +将 *REGISTRY-URL* 替换为您实例的 Maven 注册表的 URL。 如果您的实例启用了子域隔离，请使用 `maven.HOSTNAME`。 如果您的实例禁用了子域隔离，请使用 `HOSTNAME/_registry/maven`。 无论是哪种情况，都要将 *HOSTNAME* 替换为 +{% data variables.product.prodname_ghe_server %} 实例的主机名。 {% endif %} 将 *USERNAME* 替换为您的 {% data variables.product.prodname_dotcom %} 用户名，将 *TOKEN* 替换为您的个人访问令牌，将 *REPOSITORY* 替换为要发布的包所在仓库的名称，将 *OWNER* 替换为 {% data variables.product.prodname_dotcom %} 上拥有该仓库的用户或组织帐户的名称。 {% data reusables.package_registry.lowercase-name-field %} @@ -48,7 +49,7 @@ publishing { repositories { maven { name = "GitHubPackages" - url = uri("https://maven.pkg.github.com/OWNER/REPOSITORY") + url = uri("https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}REGISTRY-URL{% endif %}/OWNER/REPOSITORY") credentials { username = project.findProperty("gpr.user") ?: System.getenv("USERNAME") password = project.findProperty("gpr.key") ?: System.getenv("TOKEN") @@ -76,7 +77,7 @@ subprojects { repositories { maven { name = "GitHubPackages" - url = uri("https://maven.pkg.github.com/OWNER/REPOSITORY") + url = uri("https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}REGISTRY-URL{% endif %}/OWNER/REPOSITORY") credentials { username = project.findProperty("gpr.user") ?: System.getenv("USERNAME") password = project.findProperty("gpr.key") ?: System.getenv("TOKEN") @@ -103,7 +104,7 @@ publishing { repositories { maven { name = "GitHubPackages" - url = uri("https://maven.pkg.github.com/OWNER/REPOSITORY") + url = uri("https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}REGISTRY-URL{% endif %}/OWNER/REPOSITORY") credentials { username = project.findProperty("gpr.user") as String? ?: System.getenv("USERNAME") password = project.findProperty("gpr.key") as String? ?: System.getenv("TOKEN") @@ -115,58 +116,37 @@ publishing { from(components["java"]) } } -} ?: System.getenv("USERNAME") - password = project.findProperty("gpr.key") as String? ?: System.getenv("TOKEN") - } - } - } - publications { - register("gpr") { - from(components["java"]) - } - } } ``` ##### 将 Kotlin DSL 用于同一个仓库中多个包的示例 - ```shell - plugins { - `maven-publish` apply false - } +```shell +plugins { + `maven-publish` apply false +} - subprojects { - apply(plugin = "maven-publish") - configure { - repositories { - maven { - name = "GitHubPackages" - url = uri("https://maven.pkg.github.com/OWNER/REPOSITORY") - credentials { - username = project.findProperty("gpr.user") as String? ?: System.getenv("USERNAME") - password = project.findProperty("gpr.key") as String? ?: System.getenv("TOKEN") - } - } - } - publications { - register("gpr") { - from(components["java"]) - } - } - } - } ?: System.getenv("USERNAME") - password = project.findProperty("gpr.key") as String? ?: System.getenv("TOKEN") - } - } - } - publications { - register("gpr") { - from(components["java"]) - } - } - } - } - ``` +subprojects { + apply(plugin = "maven-publish") + configure { + repositories { + maven { + name = "GitHubPackages" + url = uri("https://{% if currentVersion == "free-pro-team@latest" %}maven.pkg.github.com{% else %}REGISTRY-URL{% endif %}/OWNER/REPOSITORY") + credentials { + username = project.findProperty("gpr.user") as String? ?: System.getenv("USERNAME") + password = project.findProperty("gpr.key") as String? ?: System.getenv("TOKEN") + } + } + } + publications { + register("gpr") { + from(components["java"]) + } + } + } +} +``` #### 使用 `GITHUB_TOKEN` 进行身份验证 @@ -194,31 +174,31 @@ publishing { {% data reusables.package_registry.authenticate-step %} 2. 将包依赖项添加到您的 *build.gradle* 文件 (Gradle Groovy) 或 *build.gradle.kts* 文件 (Kotlin DSL)。 - 使用 Grady Groovy 的示例： + Example using Gradle Groovy: ```shell dependencies { - implementation 'com.example:package' + implementation 'com.example:package' } ``` 使用 Kotlin DSL 的示例： ```shell dependencies { - implementation("com.example:package") + implementation("com.example:package") } ``` 3. 将 maven 插件添加到您的 *build.gradle* 文件 (Gradle Groovy) 或 *build.gradle.kts* 文件 (Kotlin DSL)。 - 使用 Grady Groovy 的示例： + Example using Gradle Groovy: ```shell plugins { - id 'maven' + id 'maven' } ``` 使用 Kotlin DSL 的示例： ```shell plugins { - `maven` + `maven` } ``` diff --git a/translations/zh-CN/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md b/translations/zh-CN/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md index 5a9a5e048d74..efc0e2d45072 100644 --- a/translations/zh-CN/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md +++ b/translations/zh-CN/content/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages.md @@ -1,6 +1,6 @@ --- -title: 配置 npm 用于 GitHub 包 -intro: '您可以配置 npm 以将包发布到 {% data variables.product.prodname_registry %} 并将存储在 {% data variables.product.prodname_registry %} 上的包用作 npm 项目中的依赖项。' +title: Configuring npm for use with GitHub Packages +intro: 'You can configure npm to publish packages to {% data variables.product.prodname_registry %} and to use packages stored on {% data variables.product.prodname_registry %} as dependencies in an npm project.' product: '{% data reusables.gated-features.packages %}' redirect_from: - /articles/configuring-npm-for-use-with-github-package-registry @@ -13,119 +13,116 @@ versions: {% data reusables.package_registry.packages-ghes-release-stage %} -**注：**安装或发布 Docker 映像时，{% data variables.product.prodname_registry %} 当前不支持外部图层，如 Windows 映像。 +{% data reusables.package_registry.admins-can-configure-package-types %} -### 向 {% data variables.product.prodname_registry %} 验证 +### Authenticating to {% data variables.product.prodname_registry %} {% data reusables.package_registry.authenticate-packages %} -#### 使用个人访问令牌进行身份验证 +#### Authenticating with a personal access token {% data reusables.package_registry.required-scopes %} -通过编辑您的每用户 *~/.npmrc* 文件以包含个人访问令牌，或者在命令行上使用用户名和个人访问令牌登录 npm，您可以使用 npm 向 {% data variables.product.prodname_registry %} 验证。 +You can authenticate to {% data variables.product.prodname_registry %} with npm by either editing your per-user *~/.npmrc* file to include your personal access token or by logging in to npm on the command line using your username and personal access token. -要通过将个人访问令牌添加到 *~/.npmrc* 文件进行身份验证，请编辑项目的 *~/.npmrc* 文件以包含以下行，将 *TOKEN* 替换为您的个人访问令牌。 如果 *~/.npmrc* 文件不存在，请新建该文件。 +To authenticate by adding your personal access token to your *~/.npmrc* file, edit the *~/.npmrc* file for your project to include the following line, replacing {% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance and {% endif %}*TOKEN* with your personal access token. Create a new *~/.npmrc* file if one doesn't exist. {% if currentVersion != "free-pro-team@latest" %} -有关创建包的更多信息，请参阅 [maven.apache.org 文档](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html)。 +If your instance has subdomain isolation enabled: {% endif %} ```shell -//npm.pkg.github.com/:_authToken=TOKEN +//{% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %}/:_authToken=TOKEN ``` {% if currentVersion != "free-pro-team@latest" %} -例如，*OctodogApp* 和 *OctocatApp* 项目将发布到同一个仓库： +If your instance has subdomain isolation disabled: ```shell -$ npm login --registry=https://npm.pkg.github.com -> Username: USERNAME -> Password: TOKEN -> Email: PUBLIC-EMAIL-ADDRESS +//HOSTNAME/_registry/npm/:_authToken=TOKEN ``` {% endif %} -要通过登录到 npm 进行身份验证，请使用 `npm login` 命令，将 *USERNAME* 替换为您的 {% data variables.product.prodname_dotcom %} 用户名，将 *TOKEN* 替换为您的个人访问令牌，将 *PUBLIC-EMAIL-ADDRESS* 替换为您的电子邮件地址。 +To authenticate by logging in to npm, use the `npm login` command, replacing *USERNAME* with your {% data variables.product.prodname_dotcom %} username, *TOKEN* with your personal access token, and *PUBLIC-EMAIL-ADDRESS* with your email address. {% if currentVersion != "free-pro-team@latest" %} -有关创建包的更多信息，请参阅 [maven.apache.org 文档](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html)。 +If your instance has subdomain isolation enabled: {% endif %} ```shell -"repository" : { - "type" : "git", - "url": "ssh://git@github.com/OWNER/REPOSITORY.git", - "directory": "packages/name" - }, +$ npm login --registry=https://{% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %} +> Username: USERNAME +> Password: TOKEN +> Email: PUBLIC-EMAIL-ADDRESS ``` {% if currentVersion != "free-pro-team@latest" %} -例如，*OctodogApp* 和 *OctocatApp* 项目将发布到同一个仓库： +If your instance has subdomain isolation disabled: ```shell -registry=https://npm.pkg.github.com/OWNER -@OWNER:registry=https://npm.pkg.github.com -@OWNER:registry=https://npm.pkg.github.com +$ npm login --registry=https://HOSTNAME/_registry/npm/ +> Username: USERNAME +> Password: TOKEN +> Email: PUBLIC-EMAIL-ADDRESS ``` {% endif %} -#### 使用 `GITHUB_TOKEN` 进行身份验证 +#### Authenticating with the `GITHUB_TOKEN` {% data reusables.package_registry.package-registry-with-github-tokens %} -### 发布包 +### Publishing a package -默认情况下，{% data variables.product.prodname_registry %} 将包发布到您在 *package.json* 文件的名称字段中指定的 {% data variables.product.prodname_dotcom %} 仓库。 例如，您要发布一个名为 `@my-org/test` 的包到 `my-org/test` {% data variables.product.prodname_dotcom %} 仓库。 通过在包目录中包含 *README.md* 文件，您可以添加包列表页面的摘要。 更多信息请参阅 npm 文档中的“[使用 package.json](https://docs.npmjs.com/getting-started/using-a-package.json)”和“[如何创建 Node.js 模块](https://docs.npmjs.com/getting-started/creating-node-modules)”。 +By default, {% data variables.product.prodname_registry %} publishes a package in the {% data variables.product.prodname_dotcom %} repository you specify in the name field of the *package.json* file. For example, you would publish a package named `@my-org/test` to the `my-org/test` {% data variables.product.prodname_dotcom %} repository. You can add a summary for the package listing page by including a *README.md* file in your package directory. For more information, see "[Working with package.json](https://docs.npmjs.com/getting-started/using-a-package.json)" and "[How to create Node.js Modules](https://docs.npmjs.com/getting-started/creating-node-modules)" in the npm documentation. -通过在 *package.json* 文件中包含 `URL` 字段，您可以将多个包发布到同一个 {% data variables.product.prodname_dotcom %} 仓库。 更多信息请参阅“[将多个包发布到同一个仓库](#publishing-multiple-packages-to-the-same-repository)”。 +You can publish multiple packages to the same {% data variables.product.prodname_dotcom %} repository by including a `URL` field in the *package.json* file. For more information, see "[Publishing multiple packages to the same repository](#publishing-multiple-packages-to-the-same-repository)." -您可以使用项目中的本地 *.npmrc* 文件或使用 *package.json* 中的 `publishConfig` 选项来设置项目的作用域映射。 {% data variables.product.prodname_registry %} 只支持作用域内的 npm 包。 作用域内的包具有名称格式 `@owner/name`。 作用域内的包总是以 `@` 符号开头。 您可能需要更新 *package.json* 中的名称以使用作用域内的名称。 例如，`"name": "@codertocat/hello-world-npm"`。 +You can set up the scope mapping for your project using either a local *.npmrc* file in the project or using the `publishConfig` option in the *package.json*. {% data variables.product.prodname_registry %} only supports scoped npm packages. Scoped packages have names with the format of `@owner/name`. Scoped packages always begin with an `@` symbol. You may need to update the name in your *package.json* to use the scoped name. For example, `"name": "@codertocat/hello-world-npm"`. {% data reusables.package_registry.viewing-packages %} -#### 使用本地 *.npmrc* 文件发布包 +#### Publishing a package using a local *.npmrc* file -您可以使用 *.npmrc* 文件来配置项目的作用域映射。 在 *.npmrc* 文件中，使用 {% data variables.product.prodname_registry %} URL 和帐户所有者，使 account owner so {% data variables.product.prodname_registry %} 知道将包请求路由到何处。 使用 *.npmrc* 文件防止其他开发者意外地将包发布到 npmjs.org 而不是 {% data variables.product.prodname_registry %}。 {% data reusables.package_registry.lowercase-name-field %} +You can use an *.npmrc* file to configure the scope mapping for your project. In the *.npmrc* file, use the {% data variables.product.prodname_registry %} URL and account owner so {% data variables.product.prodname_registry %} knows where to route package requests. Using an *.npmrc* file prevents other developers from accidentally publishing the package to npmjs.org instead of {% data variables.product.prodname_registry %}. {% data reusables.package_registry.lowercase-name-field %} {% data reusables.package_registry.authenticate-step %} {% data reusables.package_registry.create-npmrc-owner-step %} {% data reusables.package_registry.add-npmrc-to-repo-step %} -4. 验证项目的 *package.json* 中包的名称。 `name` 字段必须包含包的作用域和名称。 例如，如果您的包名为 "test"，并且要发布到 "My-org" {% data variables.product.prodname_dotcom %} 组织，则 *package.json* 中的 `name` 字段应为 `@my-org/test`。 +4. Verify the name of your package in your project's *package.json*. The `name` field must contain the scope and the name of the package. For example, if your package is called "test", and you are publishing to the "My-org" {% data variables.product.prodname_dotcom %} organization, the `name` field in your *package.json* should be `@my-org/test`. {% data reusables.package_registry.verify_repository_field %} {% data reusables.package_registry.publish_package %} -#### 使用 *package.json* 文件中的 `publishConfig` 发布包 +#### Publishing a package using `publishConfig` in the *package.json* file -您可以使用 *package.json* 文件中的 `publishConfig` 元素来指定要发布包的注册表。 更多信息请参阅 npm 文档中的“[publishConfig](https://docs.npmjs.com/files/package.json#publishconfig)”。 +You can use `publishConfig` element in the *package.json* file to specify the registry where you want the package published. For more information, see "[publishConfig](https://docs.npmjs.com/files/package.json#publishconfig)" in the npm documentation. -1. 编辑包的 *package.json* 文件并包含 `publishConfig` 条目。 +1. Edit the *package.json* file for your package and include a `publishConfig` entry. {% if currentVersion != "free-pro-team@latest" %} - 有关创建包的更多信息，请参阅 [maven.apache.org 文档](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html)。 + If your instance has subdomain isolation enabled: {% endif %} ```shell - "publishConfig": { - "registry":"https://npm.pkg.github.com/" - }, + "publishConfig": { + "registry":"https://{% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %}" + }, ``` {% if currentVersion != "free-pro-team@latest" %} - 例如，*OctodogApp* 和 *OctocatApp* 项目将发布到同一个仓库： + If your instance has subdomain isolation disabled: ```shell - "publishConfig": { - "registry":"https://HOSTNAME/_registry/npm/" - }, + "publishConfig": { + "registry":"https://HOSTNAME/_registry/npm/" + }, ``` {% endif %} {% data reusables.package_registry.verify_repository_field %} {% data reusables.package_registry.publish_package %} -### 将多个包发布到同一个仓库 +### Publishing multiple packages to the same repository -要将多个包发布到同一个仓库，您可以在每个包的 *package.json* 文件的 `repository` 字段中包含 {% data variables.product.prodname_dotcom %} 仓库的 URL。 +To publish multiple packages to the same repository, you can include the URL of the {% data variables.product.prodname_dotcom %} repository in the `repository` field of the *package.json* file for each package. -为确保仓库的 URL 正确，请将 REPOSITORY 替换为要发布的包所在仓库的名称，将 OWNER 替换为拥有该仓库的 {% data variables.product.prodname_dotcom %} 用户或组织帐户的名称。 +To ensure the repository's URL is correct, replace REPOSITORY with the name of the repository containing the package you want to publish, and OWNER with the name of the user or organization account on {% data variables.product.prodname_dotcom %} that owns the repository. -{% data variables.product.prodname_registry %} 将根据该 URL 匹配仓库，而不是根据包名称。 如果您在仓库根目录的外部存储 *package.json* 文件，您可以使用 `directory` 字段指定 {% data variables.product.prodname_registry %} 可找到 *package.json* 文件的位置。 +{% data variables.product.prodname_registry %} will match the repository based on the URL, instead of based on the package name. If you store the *package.json* file outside the root directory of your repository, you can use the `directory` field to specify the location where {% data variables.product.prodname_registry %} can find the *package.json* files. ```shell "repository" : { @@ -135,18 +132,18 @@ registry=https://npm.pkg.github.com/OWNER }, ``` -### 安装包 +### Installing a package -通过在项目的 *package.json* 文件中将包添加为依赖项，您可以从 {% data variables.product.prodname_registry %} 安装包。 有关在项目中使用 *package.json* 的更多信息，请参阅 npm 文档中的“[使用 package.json](https://docs.npmjs.com/getting-started/using-a-package.json)”。 +You can install packages from {% data variables.product.prodname_registry %} by adding the packages as dependencies in the *package.json* file for your project. For more information on using a *package.json* in your project, see "[Working with package.json](https://docs.npmjs.com/getting-started/using-a-package.json)" in the npm documentation. -默认情况下，您可以从一个组织添加包。 更多信息请参阅[从其他组织安装包](#installing-packages-from-other-organizations)。 +By default, you can add packages from one organization. For more information, see "[Installing packages from other organizations](#installing-packages-from-other-organizations)." -还需要将 *.npmrc* 文件添加到项目，使所有安装包的请求都会通过 {% data variables.product.prodname_registry %}。 通过 {% data variables.product.prodname_registry %} 路由所有包请求时，您可以使用 *npmjs.com* 作用域内和作用域外的包。 更多信息请参阅 npm 文档中的“[npm 作用域](https://docs.npmjs.com/misc/scope)”。 +You also need to add the *.npmrc* file to your project so all requests to install packages will go through {% data variables.product.prodname_registry %}. When you route all package requests through {% data variables.product.prodname_registry %}, you can use both scoped and unscoped packages from *npmjs.com*. For more information, see "[npm-scope](https://docs.npmjs.com/misc/scope)" in the npm documentation. {% data reusables.package_registry.authenticate-step %} {% data reusables.package_registry.create-npmrc-owner-step %} {% data reusables.package_registry.add-npmrc-to-repo-step %} -4. 配置项目中的 *package.json* 使用要安装的包。 要将包依赖项添加到 {% data variables.product.prodname_registry %} 的 *package.json* 文件，请指定完整的作用域内包名称，例如 `@my-org/server`。 对于来自 *npmjs.com* 的包，请指定全名，例如 `@babel/core` 或 `@lodash`。 例如，以下 *package.json* 将 `@octo-org/octo-app` 包用作依赖项。 +4. Configure *package.json* in your project to use the package you are installing. To add your package dependencies to the *package.json* file for {% data variables.product.prodname_registry %}, specify the full-scoped package name, such as `@my-org/server`. For packages from *npmjs.com*, specify the full name, such as `@babel/core` or `@lodash`. For example, this following *package.json* uses the `@octo-org/octo-app` package as a dependency. ``` { @@ -161,28 +158,28 @@ registry=https://npm.pkg.github.com/OWNER } } ``` -5. 安装包。 +5. Install the package. ```shell $ npm install ``` -#### 从其他组织安装包 +#### Installing packages from other organizations -默认情况下，您只能使用来自一个组织的 {% data variables.product.prodname_registry %} 包。 默认情况下，您只能使用来自一个组织的 {% data variables.product.prodname_registry %} 包。 {% data reusables.package_registry.lowercase-name-field %} +By default, you can only use {% data variables.product.prodname_registry %} packages from one organization. If you'd like to route package requests to multiple organizations and users, you can add additional lines to your *.npmrc* file, replacing {% if currentVersion != "free-pro-team@latest" %}*HOSTNAME* with the host name of your {% data variables.product.prodname_ghe_server %} instance and {% endif %}*OWNER* with the name of the user or organization account that owns the repository containing your project. {% data reusables.package_registry.lowercase-name-field %} {% if currentVersion != "free-pro-team@latest" %} -有关创建包的更多信息，请参阅 [maven.apache.org 文档](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html)。 +If your instance has subdomain isolation enabled: {% endif %} ```shell -registry=https://{% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %}OWNER +registry=https://{% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME{% endif %}/OWNER @OWNER:registry={% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %} @OWNER:registry={% if currentVersion == "free-pro-team@latest" %}npm.pkg.github.com{% else %}npm.HOSTNAME/{% endif %} ``` {% if currentVersion != "free-pro-team@latest" %} -例如，*OctodogApp* 和 *OctocatApp* 项目将发布到同一个仓库： +If your instance has subdomain isolation disabled: ```shell registry=https://HOSTNAME/_registry/npm/OWNER @@ -191,7 +188,6 @@ registry=https://HOSTNAME/_registry/npm/OWNER ``` {% endif %} +### Further reading -### 延伸阅读 - -- “[删除包](/packages/publishing-and-managing-packages/deleting-a-package/)” +- "[Deleting a package](/packages/publishing-and-managing-packages/deleting-a-package/)" diff --git a/translations/zh-CN/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md b/translations/zh-CN/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md index 8c10a2f729e2..8875879a16f7 100644 --- a/translations/zh-CN/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md +++ b/translations/zh-CN/content/packages/using-github-packages-with-your-projects-ecosystem/using-github-packages-with-github-actions.md @@ -1,6 +1,6 @@ --- -title: 将 GitHub 包用于 GitHub 操作 -intro: '您可以配置 {% data variables.product.prodname_actions %} 中的工作流程以自动发布或安装 {% data variables.product.prodname_registry %} 的包。' +title: Using GitHub Packages with GitHub Actions +intro: 'You can configure a workflow in {% data variables.product.prodname_actions %} to automatically publish or install a package from {% data variables.product.prodname_registry %}.' product: '{% data reusables.gated-features.packages %}' redirect_from: - /github/managing-packages-with-github-packages/using-github-packages-with-github-actions @@ -11,41 +11,43 @@ versions: {% data reusables.package_registry.packages-ghes-release-stage %} -### 关于 {% data variables.product.prodname_registry %} 与 {% data variables.product.prodname_actions %} +### About {% data variables.product.prodname_registry %} with {% data variables.product.prodname_actions %} -{% data reusables.repositories.about-github-actions %} {% data reusables.repositories.actions-ci-cd %} 更多信息请参阅“[关于 {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/about-github-actions)”。 +{% data reusables.repositories.about-github-actions %} {% data reusables.repositories.actions-ci-cd %} For more information, see "[About {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/about-github-actions)." -您可以通过在工作流程中发布或安装包来扩展仓库的 CI 和 CD 功能。 +You can extend the CI and CD capabilities of your repository by publishing or installing packages as part of your workflow. {% if currentVersion == "free-pro-team@latest" %} -#### 向 {% data variables.product.prodname_github_container_registry %} 验证 +#### Authenticating to {% data variables.product.prodname_github_container_registry %} {% data reusables.package_registry.container-registry-beta %} -不使用个人访问令牌向 {% data variables.product.prodname_registry %} 验证，而使用在您启用 {% data variables.product.prodname_actions %} 时 {% data variables.product.prodname_dotcom %} 自动为您的仓库创建的 `GITHUB_TOKEN`。 For an authentication example, see "[Authenticating with the {% data variables.product.prodname_container_registry %}](/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images#authenticating-with-the-container-registry)." +{% data reusables.package_registry.authenticate_with_pat_for_container_registry %} + +For an authentication example, see "[Authenticating with the {% data variables.product.prodname_container_registry %}](/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images#authenticating-with-the-container-registry)." {% endif %} #### Authenticating to package registries on {% data variables.product.prodname_dotcom %} -{% if currentVersion == "free-pro-team@latest" %}If you want your workflow to authenticate to {% data variables.product.prodname_registry %} to access a package registry other than the {% data variables.product.prodname_container_registry %} on {% data variables.product.product_name %}, then{% else %}To authenticate to package registries on {% data variables.product.product_name %},{% endif %} we recommend using the `GITHUB_TOKEN` that {% data variables.product.product_name %} automatically creates for your repository when you enable {% data variables.product.prodname_actions %} instead of a personal access token for authentication. `GITHUB_TOKEN` 具有对仓前仓库的 `read:packages` 和 `write:packages` 作用域。 对于复刻，该令牌还具有对父仓库的 `read:packages` 作用域。 +{% if currentVersion == "free-pro-team@latest" %}If you want your workflow to authenticate to {% data variables.product.prodname_registry %} to access a package registry other than the {% data variables.product.prodname_container_registry %} on {% data variables.product.product_name %}, then{% else %}To authenticate to package registries on {% data variables.product.product_name %},{% endif %} we recommend using the `GITHUB_TOKEN` that {% data variables.product.product_name %} automatically creates for your repository when you enable {% data variables.product.prodname_actions %} instead of a personal access token for authentication. The `GITHUB_TOKEN` has `read:packages` and `write:packages` scopes to the current repository. For forks, the token also has the `read:packages` scope for the parent repository. -您还可以使用 {% raw %}`{{secrets.GITHUB_TOKEN}}`{% endraw %} 上下文在工作流程文件中引用 `GITHUB_TOKEN`。 更多信息请参阅“[使用 GITHUB_TOKEN 验证身份](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)”。 +You can reference the `GITHUB_TOKEN` in your workflow file using the {% raw %}`{{secrets.GITHUB_TOKEN}}`{% endraw %} context. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)." -### 使用操作发布包 +### Publishing a package using an action -您可以使用 {% data variables.product.prodname_actions %} 将发布包作为持续集成 (CI) 流程的一部分。 For example, you could configure a workflow so that anytime a developer pushes code to the default branch, the workflow runs CI tests. 如果这些测试通过，该工作流程就会将新的包版本发布到 {% data variables.product.prodname_registry %}。 仅当代码符合您的质量标准时，该工作流程才会自动创建新的包版本。 +You can publish packages as part of your continuous integration (CI) flow using {% data variables.product.prodname_actions %}. For example, you could configure a workflow so that anytime a developer pushes code to the default branch, the workflow runs CI tests. If those tests pass, the workflow publishes a new package version to {% data variables.product.prodname_registry %}. This workflow automates the creation of new package versions only if the code meets your quality standards. {% data reusables.package_registry.actions-configuration %} -### 使用操作安装包 +### Installing a package using an action -您可以使用 {% data variables.product.prodname_actions %} 将安装包作为 CI 流程的一部分。 例如，您可以配置一个工作流程：每当开发者向拉取请求推送代码时，该工作流程就会通过下载并安装 {% data variables.product.prodname_registry %} 托管的包来解析依赖项。 然后，该工作流程就可以运行需要这些依赖项的 CI 测试。 +You can install packages as part of your CI flow using {% data variables.product.prodname_actions %}. For example, you could configure a workflow so that anytime a developer pushes code to a pull request, the workflow resolves dependencies by downloading and installing packages hosted by {% data variables.product.prodname_registry %}. Then, the workflow can run CI tests that require the dependencies. -使用 `GITHUB_TOKEN`，可通过 {% data variables.product.prodname_actions %} 安装 {% data variables.product.prodname_registry %} 托管的包，只需极少的配置或额外身份验证。 使用操作安装包时，数据传输也是免费的。 更多信息请参阅“[关于 {% data variables.product.prodname_registry %} 的计费](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)”。 +Installing packages hosted by {% data variables.product.prodname_registry %} through {% data variables.product.prodname_actions %} requires minimal configuration or additional authentication when you use `GITHUB_TOKEN`.{% if currentVersion == "free-pro-team@latest" %} Data transfer is also free when an action installs a package. For more information, see "[About billing for {% data variables.product.prodname_registry %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)."{% endif %} {% if currentVersion == "free-pro-team@latest" %} -`GITHUB_TOKEN` 无法从操作运行所在仓库之外的任何私有仓库安装包。 You cannot currently use `GITHUB_TOKEN` to authenticate to {% data variables.product.prodname_github_container_registry %}. +`GITHUB_TOKEN` cannot install packages from any private repository besides the repository where the action runs. You cannot currently use `GITHUB_TOKEN` to authenticate to {% data variables.product.prodname_github_container_registry %}. {% endif %} {% data reusables.package_registry.actions-configuration %} diff --git a/translations/zh-CN/content/rest/guides/basics-of-authentication.md b/translations/zh-CN/content/rest/guides/basics-of-authentication.md index aee14ac2d9e6..7ddee525e53e 100644 --- a/translations/zh-CN/content/rest/guides/basics-of-authentication.md +++ b/translations/zh-CN/content/rest/guides/basics-of-authentication.md @@ -11,7 +11,6 @@ versions: --- - 在本节中，我们将重点介绍身份验证的基础知识。 具体来说，我们将创建一个 Ruby 服务器（使用 [Sinatra][Sinatra])， 以几种不同的方式实现应用程序的 [web 流][webflow]。 {% tip %} @@ -47,8 +46,9 @@ get '/' do end ``` -客户端 ID 和客户端密钥[来自应用程序的配置页面][app settings]。 因此，**绝对、 _永远_**不要将这些值存储在 -{% data variables.product.product_name %} 中或任何其他公共位置。 我们建议将它们存储为[环境变量][about env vars]，这正是我们在这里采用的做法。 +客户端 ID 和客户端密钥[来自应用程序的配置页面][app settings]。 您应该**永_不_**将这些值存储在 +{% data variables.product.product_name %}--或任何其他公共位置，因为它们很重要。 我们建议将它们存储为 +[环境变量][about env vars]--我们正是这样做的。 接下来，在 _views/index.erb_ 中粘贴此内容： @@ -106,7 +106,7 @@ end #### 检查授予的作用域 -今后，用户将能够[编辑您请求的作用域][edit scopes post]，但您的应用程序被授予的访问权限可能低于您最初要求的权限。 因此，在使用令牌发出任何请求之前，您应该检查用户为令牌授予的作用域。 +Users can edit the scopes you requested by directly changing the URL. This can grant your application less access than you originally asked for. 因此，在使用令牌发出任何请求之前，您应该检查用户为令牌授予的作用域。 For more information about requested and granted scopes, see "[Scopes for OAuth Apps](/developers/apps/scopes-for-oauth-apps#requested-scopes-and-granted-scopes)." 授予的作用域在交换令牌的响应中返回。 @@ -128,7 +128,7 @@ end 仅在发出请求之前检查作用域是不够的，因为用户可能会在检查与实际请求之间的时间段更改作用域。 如果发生这种情况，您期望成功的 API 调用可能会以 `404` 或 `401` 状态失败，或者返回不同的信息子集。 -为了帮助您妥善处理这些情况，使用有效令牌发出请求的所有 API 响应还包含一个 [`X-OAuth-Scopes` 标头][oauth scopes]。 此标头包含用于发出请求的令牌的作用域列表。 除此之外，OAuth 应用程序 API 还提供 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} \[检查令牌有效性\]\[/v3/apps/oauth_applications/#check-a-token\]{% else %}\[检查令牌有效性\]\[/v3/apps/oauth_applications/#check-an-authorization\]{% endif %}的端点。 使用此信息来检测令牌作用域中的更改，并将可用应用程序功能的更改告知用户。 +为了帮助您妥善处理这些情况，使用有效令牌发出请求的所有 API 响应还包含一个 [`X-OAuth-Scopes` 标头][oauth scopes]。 此标头包含用于发出请求的令牌的作用域列表。 除此之外，OAuth 应用程序 API 还提供 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} \[检查令牌的有效性\]\[/v3/apps/oauth_applications/#check-a-token\]{% else %}\[检查令牌的有效性\]\[/v3/apps/oauth_applications/#check-an-authorization\]{% endif %} 的端点。 使用此信息来检测令牌作用域中的更改，并将可用应用程序功能的更改告知用户。 #### 发出经过身份验证的请求 @@ -172,8 +172,9 @@ erb :basic, :locals => auth_result 如果我们要求用户每次访问网页时都必须登录应用程序，这将是一个非常糟糕的模式。 例如，尝试直接导航到 `http://localhost:4567/basic`。 您会收到一个错误。 -如果我们能够绕过整个“单击此处”的过程，并且_记住_，只要用户登录到 -{% data variables.product.product_name %}，他们应该就能够访问此应用程序，应该怎么办呢？ 不必担心，因为_这正是我们要做的_。 +如果我们能够绕过整个 “点击这里”过程会怎么样：只需_记住_，只要用户登录到 +{% data variables.product.product_name %}，他们就应该能够访问此应用程序？ 不用担心， +因为_这正是我们要做的_。 我们的上述小服务器相当简单。 为了加入一些智能身份验证功能，我们将切换到使用会话来存储令牌。 这将使身份验证对用户透明化。 @@ -302,6 +303,5 @@ end [libraries]: /libraries/ [oauth scopes]: /apps/building-oauth-apps/understanding-scopes-for-oauth-apps/ [oauth scopes]: /apps/building-oauth-apps/understanding-scopes-for-oauth-apps/ -[edit scopes post]: https://developer.github.com/changes/2013-10-04-oauth-changes-coming/ [new oauth app]: https://github.com/settings/applications/new [app settings]: https://github.com/settings/developers diff --git a/translations/zh-CN/content/rest/guides/best-practices-for-integrators.md b/translations/zh-CN/content/rest/guides/best-practices-for-integrators.md index 5589caecd376..23184b3c78ee 100644 --- a/translations/zh-CN/content/rest/guides/best-practices-for-integrators.md +++ b/translations/zh-CN/content/rest/guides/best-practices-for-integrators.md @@ -12,7 +12,6 @@ versions: 有兴趣与 GitHub 平台集成吗？ [与您志趣相投的大有人在](https://github.com/integrations)。 本指南将帮助您构建能够为用户提供最佳体验*并*确保与 API 进行可靠交互的应用程序。 - ### 确保安全接收从 GitHub 交付的有效负载 确保安全接收[从 GitHub 发送的有效负载][event-types]非常重要。 虽然有效负载中不会传输个人信息，但泄露*任何*信息总是不好的。 有些信息可能比较敏感，包括提交者电子邮件地址或私有仓库的名称。 diff --git a/translations/zh-CN/content/rest/guides/delivering-deployments.md b/translations/zh-CN/content/rest/guides/delivering-deployments.md index 7b617c882ef0..9c591711836c 100644 --- a/translations/zh-CN/content/rest/guides/delivering-deployments.md +++ b/translations/zh-CN/content/rest/guides/delivering-deployments.md @@ -1,6 +1,6 @@ --- title: 交付部署 -intro: 使用部署 REST API，您可以构建与您的服务器和第三方应用程序交互的自定义工具。 +intro: '使用部署 REST API，您可以构建与您的服务器和第三方应用程序交互的自定义工具。' redirect_from: - /guides/delivering-deployments/ - /guides/automating-deployments-to-integrators/ diff --git a/translations/zh-CN/content/rest/guides/getting-started-with-the-checks-api.md b/translations/zh-CN/content/rest/guides/getting-started-with-the-checks-api.md index f99b59a7d23f..f5cfd4fe3116 100644 --- a/translations/zh-CN/content/rest/guides/getting-started-with-the-checks-api.md +++ b/translations/zh-CN/content/rest/guides/getting-started-with-the-checks-api.md @@ -1,6 +1,6 @@ --- title: 检查 API 入门指南 -intro: 检查运行 API 使您能够构建 GitHub 应用程序，以针对仓库中的代码更改运行强大的检查。 您可以创建应用程序以执行持续集成 、代码分析或代码扫描服务，并提供有关提交的详细反馈。 +intro: '检查运行 API 使您能够构建 GitHub 应用程序，以针对仓库中的代码更改运行强大的检查。 您可以创建应用程序以执行持续集成 、代码分析或代码扫描服务，并提供有关提交的详细反馈。' versions: free-pro-team: '*' enterprise-server: '*' @@ -37,8 +37,8 @@ GitHub 应用程序可以报告丰富的状态信息、提供详细的代码行 ![检查运行工作流程](/assets/images/check_runs.png) {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -如果检查运行处于未完成状态超过 14 天，则检查运行的 `conclusion` 将变成 `stale`，并且通过 在 {% data variables.product.prodname_dotcom %} 上显示为 stale（过时） -{% octicon "issue-reopened" aria-label="The issue-reopened icon" %}. 只有 {% data variables.product.prodname_dotcom %} 可以将检查运行标记为 `stale`。 有关检查运行之可能结论的更多信息，请参阅 [`conclusion` 参数](/rest/reference/checks#create-a-check-run--parameters)。 +如果检查运行处于未完成状态超过 14 天，则检查运行的 `conclusion` 将变成 `stale`，并且通过 +{% octicon "issue-reopened" aria-label="The issue-reopened icon" %} 在 {% data variables.product.prodname_dotcom %} 上显示为 stale（过时）。 只有 {% data variables.product.prodname_dotcom %} 可以将检查运行标记为 `stale`。 有关检查运行之可能结论的更多信息，请参阅 [`conclusion` 参数](/rest/reference/checks#create-a-check-run--parameters)。 {% endif %} 一旦收到 [`check_suite`](/webhooks/event-payloads/#check_suite) web 挂钩，您即可创建检查运行，即使检查尚未完成。 您可以在检查运行完成时使用值 `queued`、`in_progress` 或 `completed` 来更新其 `status`， 并且可以在更多详细信息可用时更新 `output`。 检查运行可以包含时间戳、指向外部站点上更多详细信息的链接、特定代码行的详细注释以及有关所执行分析的信息。 diff --git a/translations/zh-CN/content/rest/guides/getting-started-with-the-git-database-api.md b/translations/zh-CN/content/rest/guides/getting-started-with-the-git-database-api.md index de3b4fe82fdc..389e84519781 100644 --- a/translations/zh-CN/content/rest/guides/getting-started-with-the-git-database-api.md +++ b/translations/zh-CN/content/rest/guides/getting-started-with-the-git-database-api.md @@ -32,14 +32,14 @@ versions: {% warning %} -**警告！**请勿直接使用 Git 或 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}[`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference){% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}[`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference){% endif %} 进行更新以 `merge` Git 引用，因为此内容会过时而不发出警告。 +**警告！**请不要依赖直接使用 Git 或 [`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference) 更新 `merge` Git 引用，因为此内容会在不发出警告的情况下过期。 {% endwarning %} 消费 API 需要明确请求拉取请求来创建一个_测试_合并提交。 当您在 UI 中查看拉取请求并且“ Merge（合并）”按钮显示时，或者当您使用 REST API 来[获取](/v3/pulls/#get-a-pull-request)、[创建](/v3/pulls/#create-a-pull-request)或[编辑](/v3/pulls/#update-a-pull-request)拉取请求时，将创建一个_测试_合并提交。 如果没有此请求，`merge` Git 引用将过时，直到下次有人查看拉取请求。 -如果您当前正在使用会生成过时 `merge` Git 引用的轮询方法，GitHub 建议您使用以下步骤从基本分支（通常是 `master`）获取最新更改： +If you are currently using polling methods that produce outdated `merge` Git refs, then GitHub recommends using the following steps to get the latest changes from the default branch: 1. 接收拉取请求 web 挂钩。 2. 调用 [`GET /repos/{owner}/{repo}/pulls/{pull_number}`](/v3/pulls/#get-a-pull-request) 以启动创建合并提交候选项的后台作业。 -3. 使用 [`GET /repos/{owner}/{repo}/pulls/{pull_number}`](/v3/pulls/#get-a-pull-request) 轮询仓库，以查看 `mergeable` 属性是 `true` 还是 `false`。 您可以直接使用 Git 或 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}[`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference){% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}[`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference){% endif %} 进行更新以 `merge` Git 引用，前提是您已执行上述步骤。 +3. 使用 [`GET /repos/{owner}/{repo}/pulls/{pull_number}`](/v3/pulls/#get-a-pull-request) 轮询仓库，以查看 `mergeable` 属性是 `true` 还是 `false`。 您仅在执行上述步骤后才可直接使用 Git 或 [`GET /repos/{owner}/{repo}/git/refs/{ref}`](/v3/git/refs/#get-a-reference) 更新 `merge` Git 引用。 diff --git a/translations/zh-CN/content/rest/guides/getting-started-with-the-rest-api.md b/translations/zh-CN/content/rest/guides/getting-started-with-the-rest-api.md index 4922c6559fff..52878701faa1 100644 --- a/translations/zh-CN/content/rest/guides/getting-started-with-the-rest-api.md +++ b/translations/zh-CN/content/rest/guides/getting-started-with-the-rest-api.md @@ -1,6 +1,6 @@ --- title: REST API 入门指南 -intro: 从身份验证和一些端点示例开始，了解使用 REST API 的基础。 +intro: '从身份验证和一些端点示例开始，了解使用 REST API 的基础。' redirect_from: - /guides/getting-started/ - /v3/guides/getting-started @@ -10,14 +10,13 @@ versions: --- - 让我们逐步了解在处理一些日常用例时涉及的核心 API 概念。 ### 概览 大多数应用程序将使用您选择的语言 中现有的 [wrapper 库][wrappers]，但您必须先熟悉基础 API HTTP 方法。 -没有比使用 [cURL][curl] 更容易的入手方式了。{% if currentVersion == "free-pro-team@latest" %} 如果您使用其他客户的，请注意，您需要在请求中发送有效的 [用户代理标头](/rest/overview/resources-in-the-rest-api#user-agent-required)。{% endif %} +没有比使用 [cURL][curl] 更容易的入手方式了。{% if currentVersion == "free-pro-team@latest" %} 如果您使用其他客户端，请注意，您需要在请求中发送有效的 [用户代理标头](/rest/overview/resources-in-the-rest-api#user-agent-required)。{% endif %} #### Hello World @@ -55,7 +54,6 @@ $ curl -i {% data variables.product.api_url_pre %}/users/defunkt > Server: GitHub.com > Date: Sun, 11 Nov 2012 18:43:28 GMT > Content-Type: application/json; charset=utf-8 -> Connection: keep-alive > Status: 200 OK > ETag: "bfd85cbf23ac0b0c8a29bee02e7117c6" > X-RateLimit-Limit: 60 @@ -195,7 +193,8 @@ $ curl -i "{% data variables.product.api_url_pre %}/users/octocat/repos?type=own #### 创建仓库 获取现有仓库的信息是一种常见的用例，但 -{% data variables.product.product_name %} API 也支持创建新的仓库。 要[创建仓库][create repo]，我们需要 `POST` 一些包含详细信息和配置选项的 JSON。 +{% data variables.product.product_name %} API 也支持创建新仓库。 要[创建仓库][create repo]， +我们需要 `POST` 一些包含详细信息和配置选项的JSON。 ```shell $ curl -i -H "Authorization: token 5199831f4dd3b79e7c5b7e0ebe75d67aa66e79d4" \ diff --git a/translations/zh-CN/content/rest/guides/index.md b/translations/zh-CN/content/rest/guides/index.md index 11f2a1d43fd0..106c70f96d4b 100644 --- a/translations/zh-CN/content/rest/guides/index.md +++ b/translations/zh-CN/content/rest/guides/index.md @@ -1,6 +1,6 @@ --- title: 指南 -intro: 了解如何开始使用 REST API、身份验证以及如何使用 REST API 完成各种任务。 +intro: '了解如何开始使用 REST API、身份验证以及如何使用 REST API 完成各种任务。' redirect_from: - /guides/ - /v3/guides diff --git a/translations/zh-CN/content/rest/guides/working-with-comments.md b/translations/zh-CN/content/rest/guides/working-with-comments.md index 628aff6a8d1a..8bfb6195b95c 100644 --- a/translations/zh-CN/content/rest/guides/working-with-comments.md +++ b/translations/zh-CN/content/rest/guides/working-with-comments.md @@ -1,6 +1,6 @@ --- title: 处理注释 -intro: 使用 REST API，您可以访问和管理拉取请求、议题或提交中的注释。 +intro: '使用 REST API，您可以访问和管理拉取请求、议题或提交中的注释。' redirect_from: - /guides/working-with-comments/ - /v3/guides/working-with-comments diff --git a/translations/zh-CN/content/rest/overview/api-previews.md b/translations/zh-CN/content/rest/overview/api-previews.md index 50067c70cd5d..37c5d5493d84 100644 --- a/translations/zh-CN/content/rest/overview/api-previews.md +++ b/translations/zh-CN/content/rest/overview/api-previews.md @@ -10,7 +10,6 @@ versions: --- - API 预览允许您试用新的 API 以及对现有 API 方法的更改（在它们被纳入正式的 GitHub API 之前）。 在预览期间，我们可以根据开发者的反馈更改某些功能。 如果我们要执行变更，将在[开发者博客](https://developer.github.com/changes/)上宣布消息，不会事先通知。 @@ -27,7 +26,7 @@ API 预览允许您试用新的 API 以及对现有 API 方法的更改（在它 ### 增强型部署 -使用更多信息和更精细的方式更好地控制[部署](/v3/repos/deployments/)。 +使用更多信息和更精细的方式更好地控制[部署](/rest/reference/repos#deployments)。 **自定义媒体类型：** `ant-man-preview` **公布日期：** [2016-04-06](https://developer.github.com/changes/2016-04-06-deployment-and-deployment-status-enhancements/) @@ -43,14 +42,6 @@ API 预览允许您试用新的 API 以及对现有 API 方法的更改（在它 **自定义媒体类型：** `mockingbird-preview` **公布日期：** [2016-05-23](https://developer.github.com/changes/2016-05-23-timeline-preview-api/) -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -### 页面 - -获取有关 [GitHub Pages](/v3/repos/pages/) 站点的更多信息。 - -**自定义媒体类型：** `mister-fantastic-preview` **公布日期：** [2016-07-06](https://developer.github.com/changes/2016-07-06-github-pages-preview-api/) -{% endif %} - {% if currentVersion != "free-pro-team@latest" %} ### 预接收环境 @@ -120,9 +111,9 @@ API 预览允许您试用新的 API 以及对现有 API 方法的更改（在它 ### 全局 web 挂钩 -为[组织](/webhooks/event-payloads/#organization)和[用户](/webhooks/event-payloads/#user)事件类型启用[全局 web 挂钩](/v3/enterprise-admin/global_webhooks/)。 此 API 预览仅适用于 {% data variables.product.prodname_ghe_server %}。 +为[组织](/webhooks/event-payloads/#organization)和[用户](/webhooks/event-payloads/#user)事件类型启用[全局 web 挂钩](/rest/reference/enterprise-admin#global-webhooks/)。 此 API 预览仅适用于 {% data variables.product.prodname_ghe_server %}。 -**自定义媒体类型：** `superpro-preview` **公布日期：** [2017-12-12](/v3/enterprise-admin/global_webhooks) +**自定义媒体类型：** `superpro-preview` **公布日期：** [2017-12-12](/rest/reference/enterprise-admin#global-webhooks) {% endif %} @@ -142,15 +133,6 @@ API 预览允许您试用新的 API 以及对现有 API 方法的更改（在它 **自定义媒体类型：** `sailor-v-preview` **公布日期：** [2018-01-10](https://developer.github.com/changes/2018-01-10-lock-reason-api-preview) {% endif %} -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -### 团队讨论 - -现在，您可以使用 API 来管理[团队讨论](/v3/teams/discussions)和[团队讨论注释](/v3/teams/discussion_comments)。 - -**自定义媒体类型：** `echo-preview` **公布日期：** [2018-02-07](https://developer.github.com/changes/2018-02-07-team-discussions-api) - -{% endif %} - ### 要求签名提交 现在，您可以使用 API 来管理[要求在受保护的分支上进行签名提交](/v3/repos/branches)的设置。 @@ -172,11 +154,13 @@ API 预览允许您试用新的 API 以及对现有 API 方法的更改（在它 {% endif %} +{% if currentVersion ver_lt "enterprise-server@2.23" %} ### 检查运行和检查套件 API 允许 GitHub 应用程序对仓库的代码运行外部检查。 更多信息请参阅[检查运行](/v3/checks/runs/)和[检查套件](/v3/checks/suites/) API。 **自定义媒体类型：** `antiope-preview` **公布日期：** [2018-05-07](https://developer.github.com/changes/2018-05-07-new-checks-api-public-beta/) +{% endif %} {% if currentVersion != "free-pro-team@latest" %} @@ -206,7 +190,7 @@ GitHub 应用程序清单允许用户创建预配置的 GitHub 应用程序。 ### 部署状态 -现在，您可以更新[部署状态](/v3/repos/deployments/#create-a-deployment-status)的 `environment` 并使用 `in_progress` 和 `queued` 状态。 创建部署状态时，现在可以使用 `auto_inactive` 参数将旧的 `production` 部署标记为 `inactive`。 +现在，您可以更新[部署状态](/rest/reference/repos#create-a-deployment-status)的 `environment` 并使用 `in_progress` 和 `queued` 状态。 创建部署状态时，现在可以使用 `auto_inactive` 参数将旧的 `production` 部署标记为 `inactive`。 **自定义媒体类型：** `flash-preview` **公布日期：** [2018-10-16](https://developer.github.com/changes/2018-10-16-deployments-environments-states-and-auto-inactive-updates/) @@ -243,7 +227,7 @@ GitHub 应用程序清单允许用户创建预配置的 GitHub 应用程序。 ### 启用和禁用页面 -您可以使用[页面 API](/v3/repos/pages/) 中的新端点来启用或禁用页面。 要了解有关页面的更多信息，请参阅“[GitHub Pages 基础知识](/categories/github-pages-basics)”。 +您可以使用[页面 API](/rest/reference/repos#pages) 中的新端点来启用或禁用页面。 要了解有关页面的更多信息，请参阅“[GitHub Pages 基础知识](/categories/github-pages-basics)”。 **自定义媒体类型：** `switcheroo-preview` **公布日期：** [2019-03-14](https://developer.github.com/changes/2019-03-14-enabling-disabling-pages/) diff --git a/translations/zh-CN/content/rest/overview/endpoints-available-for-github-apps.md b/translations/zh-CN/content/rest/overview/endpoints-available-for-github-apps.md index c45904aa39df..4651422007ca 100644 --- a/translations/zh-CN/content/rest/overview/endpoints-available-for-github-apps.md +++ b/translations/zh-CN/content/rest/overview/endpoints-available-for-github-apps.md @@ -11,7 +11,7 @@ versions: 您必须使用安装访问令牌通过 {% data variables.product.prodname_github_app %} 访问端点。 更多信息请参阅“[向 {% data variables.product.prodname_github_apps %} 验证](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)”。 -{% for thing in rest.operationsEnabledForApps[currentVersion] %} +{% for thing in rest.operationsEnabledForGitHubApps[currentVersion] %} {% assign category = thing[0] %} {% assign operations = thing[1] %} {% if operations.size > 0 %} diff --git a/translations/zh-CN/content/rest/overview/other-authentication-methods.md b/translations/zh-CN/content/rest/overview/other-authentication-methods.md index 1b9336b90267..df636278d50a 100644 --- a/translations/zh-CN/content/rest/overview/other-authentication-methods.md +++ b/translations/zh-CN/content/rest/overview/other-authentication-methods.md @@ -9,8 +9,9 @@ versions: --- - -虽然 API 提供多种身份验证方法，但我们强烈建议对生产应用程序使用 [OAuth](/apps/building-integrations/setting-up-and-registering-oauth-apps/)。 提供的其他方法旨在用于脚本或测试（即没有必要使用完整 OAuth 方法的情况）。 依赖 {% data variables.product.product_name %} 进行身份验证的第三方应用程序不应要求或收集 {% data variables.product.product_name %} 凭据。 它们应该使用 [OAuth web 工作流程](/apps/building-oauth-apps/authorizing-oauth-apps/)。 +虽然 API 提供多种身份验证方法，但我们强烈建议对生产应用程序使用 [OAuth](/apps/building-integrations/setting-up-and-registering-oauth-apps/)。 提供的其他方法旨在用于脚本或测试（即没有必要使用完整 OAuth 方法的情况）。 依赖 +{% data variables.product.product_name %} 进行身份验证的第三方应用程序不应要求或收集 {% data variables.product.product_name %} 凭据。 +它们应该使用 [OAuth web 工作流程](/apps/building-oauth-apps/authorizing-oauth-apps/)。 ### 基本身份验证 @@ -77,7 +78,7 @@ $ curl -v -H "Authorization: token TOKEN" {% data variables.product.api 启用双重身份验证后，REST API 中_大多数_端点的[基本身份验证](#basic-authentication)均要求您使用个人访问令牌或 OAuth 令牌，而不是用户名和密码。 -您可以{% if currentVersion == "free-pro-team@latest" %}使用[{% data variables.product.product_name %} 开发者设置](https://github.com/settings/tokens/new){% endif %}来生成新的个人访问令牌，或者使用 OAuth 授权 API 中的“[创建新授权][create-access]”端点来生成新的 OAuth 令牌。 更多信息请参阅“[创建用于命令行的个人访问令牌](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)”。 然后，您将使用这些令牌向 GitHub API 验证，更多信息请参阅“[使用 OAuth 令牌进行身份验证][oauth-auth]”。 唯一需要使用用户名和密码进行身份验证的时候是创建 OAuth 令牌或使用 OAuth 授权 API 时。 +您可以 {% if currentVersion == "free-pro-team@latest" %}使用 [{% data variables.product.product_name %}开发者设置](https://github.com/settings/tokens/new){% endif %}来生成新的个人访问令牌，或者使用 OAuth 授权 API 中的“[创建新授权][create-access]”端点来生成新的 OAuth 令牌。 更多信息请参阅“[创建用于命令行的个人访问令牌](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)”。 然后，您将使用这些令牌向 GitHub API 验证，更多信息请参阅“[使用 OAuth 令牌进行身份验证][oauth-auth]”。 唯一需要使用用户名和密码进行身份验证的时候是创建 OAuth 令牌或使用 OAuth 授权 API 时。 #### 结合使用 OAuth 授权 API 与双重身份验证 diff --git a/translations/zh-CN/content/rest/overview/resources-in-the-rest-api.md b/translations/zh-CN/content/rest/overview/resources-in-the-rest-api.md index 8253769aade2..b4f29ab80be5 100644 --- a/translations/zh-CN/content/rest/overview/resources-in-the-rest-api.md +++ b/translations/zh-CN/content/rest/overview/resources-in-the-rest-api.md @@ -11,7 +11,6 @@ versions: 本文介绍构成官方 {% data variables.product.product_name %} REST API 的资源。 如果您有任何问题或要求，请联系 {% data variables.contact.contact_support %}。 - ### 当前版本 默认情况下，对 `{% data variables.product.api_url_code %}` 的所有请求都会收到 REST API 的 **v3** [版本](/v3/versions)。 我们建议您[通过 `Accept` 标头明确请求此版本](/v3/media/#request-specific-version)。 @@ -26,7 +25,7 @@ versions: ### 架构 -{% if currentVersion == "free-pro-team@latest" %}所有 API 访问都通过 HTTPS 进行，{% else %}API {% endif %}可以从 `{% data variables.product.api_url_code %}` 访问。 所有数据都 +{% if currentVersion == "free-pro-team@latest" %}所有 API 访问都通过 HTTPS 进行，{% else %}API{% endif %} 从 `{% data variables.product.api_url_code %}` 访问。 所有数据都 作为 JSON 发送和接收。 ```shell @@ -36,7 +35,6 @@ $ curl -i {% data variables.product.api_url_pre %}/users/octocat/orgs > Server: nginx > Date: Fri, 12 Oct 2012 23:33:14 GMT > Content-Type: application/json; charset=utf-8 -> Connection: keep-alive > Status: 200 OK > ETag: "a00049ba79152d03380c34652f2cb612" > X-GitHub-Media-Type: github.v3 diff --git a/translations/zh-CN/content/rest/reference/actions.md b/translations/zh-CN/content/rest/reference/actions.md index de0da2321f27..7e093c8f3f08 100644 --- a/translations/zh-CN/content/rest/reference/actions.md +++ b/translations/zh-CN/content/rest/reference/actions.md @@ -24,6 +24,16 @@ versions: {% if operation.subcategory == 'artifacts' %}{% include rest_operation %}{% endif %} {% endfor %} +## 权限 + +The Permissions API allows you to set permissions for what organizations and repositories are allowed to run {% data variables.product.prodname_actions %}, and what actions are allowed to run. For more information, see "[Usage limits, billing, and administration](/actions/reference/usage-limits-billing-and-administration#disabling-or-limiting-github-actions-for-your-repository-or-organization)." + +You can also set permissions for an enterprise. 更多信息请参阅“[{% data variables.product.prodname_dotcom %} Enterprise 管理](/rest/reference/enterprise-admin#github-actions)”REST API。 + +{% for operation in currentRestOperations %} + {% if operation.subcategory == 'permissions' %}{% include rest_operation %}{% endif %} +{% endfor %} + ## 密码 密码 API 允许您创建、更新、删除和检索有关加密密码的信息。 {% data reusables.actions.about-secrets %}更多信息请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 @@ -40,7 +50,7 @@ versions: {% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_app %} 必须对仓库具有`管理`权限，或者对组织具有 `organization_self_hosted_runners` 权限。 经过身份验证的用户必须对仓库或组织具有管理员权限才可使用此 API。 -您可以管理企业的自托管运行器。 更多信息请参阅“[{% data variables.product.prodname_dotcom %} Enterprise 管理](/rest/reference/enterprise-admin#actions)”REST API。 +您可以管理企业的自托管运行器。 更多信息请参阅“[{% data variables.product.prodname_dotcom %} Enterprise 管理](/rest/reference/enterprise-admin#github-actions)”REST API。 {% for operation in currentRestOperations %} {% if operation.subcategory == 'self-hosted-runners' %}{% include rest_operation %}{% endif %} @@ -52,7 +62,7 @@ versions: {% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_app %} 必须对仓库具有`管理`权限，或者对组织具有 `organization_self_hosted_runners` 权限。 经过身份验证的用户必须对仓库或组织具有管理员权限才可使用此 API。 -您可以管理企业的自托管运行器组。 更多信息请参阅“[{% data variables.product.prodname_dotcom %} Enterprise 管理](/rest/reference/enterprise-admin#actions)”REST API。 +您可以管理企业的自托管运行器组。 更多信息请参阅“[{% data variables.product.prodname_dotcom %} Enterprise 管理](/rest/reference/enterprise-admin##github-actions)”REST API。 {% for operation in currentRestOperations %} {% if operation.subcategory == 'self-hosted-runner-groups' %}{% include rest_operation %}{% endif %} diff --git a/translations/zh-CN/content/rest/reference/activity.md b/translations/zh-CN/content/rest/reference/activity.md index 753f79b5dc5a..dfb1afb6ef45 100644 --- a/translations/zh-CN/content/rest/reference/activity.md +++ b/translations/zh-CN/content/rest/reference/activity.md @@ -15,7 +15,7 @@ versions: 事件 API 是 {% data variables.product.prodname_dotcom %} 事件的只读 API。 这些事件推动站点上的各种活动流。 -事件 API 可以返回 {% data variables.product.product_name %} 上的活动触发的不同类型事件。 事件 API 可以返回 {% data variables.product.product_name %} 上的活动触发的不同类型事件。 有关可以从事件 API 接收的特定事件的更多信息，请参阅“[{% data variables.product.prodname_dotcom %} 事件类型](/developers/webhooks-and-events/github-event-types)”。 更多信息请参阅“[议题事件 API](/rest/reference/issues#events)”。 +事件 API 可以返回 {% data variables.product.product_name %} 上的活动触发的不同类型事件。 事件 API 可以返回 {% data variables.product.product_name %} 上的活动触发的不同类型事件。 有关可以从事件 API 接收的特定事件的更多信息，请参阅“[{{ site.data.variables.product.prodname_dotcom }} 事件类型](/developers/webhooks-and-events/github-event-types)”。 更多信息请参阅“[议题事件 API](/rest/reference/issues#events)”。 事件针对使用 "ETag" 标头的轮询进行了优化。 如果未触发任何新事件，您将会看到一个 "304 Not Modified" 响应，并且您的当前速率限制不受影响。 还有一个 "X-Poll-Interval" 标头，用于指定允许您轮询的间隔时间（以秒为单位）。 在服务器负载较高时，该时间可能会增加。 请遵循标头指示。 @@ -138,19 +138,19 @@ $ -H "If-Modified-Since: Thu, 25 Oct 2012 15:16:27 GMT" 以下是收到通知的可能 `reason` 列表： -| 原因名称 | 描述 | -| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `assign` | 您被分配到议题。 | -| `作者` | 您创建了帖子。 | -| `注释，评论` | 您评论了帖子。 | -| `邀请` | 您接受了参与仓库的邀请。 | -| `manual` | 您订阅了帖子（通过议题或拉取请求） | -| `提及` | 您在内容中被特别 **@提及**。 | +| 原因名称 | 描述 | +| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `assign` | 您被分配到议题。 | +| `作者` | 您创建了帖子。 | +| `注释，评论` | 您评论了帖子。 | +| `邀请` | 您接受了参与仓库的邀请。 | +| `manual` | 您订阅了帖子（通过议题或拉取请求） | +| `提及` | 您在内容中被特别 **@提及**。 | | `review_requested` | 您或您所属的团队被请求审查拉取请求。{% if currentVersion == "free-pro-team@latest" %} | `security_alert` | {% data variables.product.prodname_dotcom %} 在您的仓库中发现了[安全漏洞](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)。{% endif %} -| `state_change` | 您更改了帖子主题（例如关闭议题或合并拉取请求）。 | -| `subscribed` | 您在关注仓库。 | -| `team_mention` | 您所属的团队被提及。 | +| `state_change` | 您更改了帖子主题（例如关闭议题或合并拉取请求）。 | +| `subscribed` | 您在关注仓库。 | +| `team_mention` | 您所属的团队被提及。 | 请注意，`reason` 根据每个帖子而修改，如果在以后的通知中，`reason` 不同，其值可能会变更。 diff --git a/translations/zh-CN/content/rest/reference/apps.md b/translations/zh-CN/content/rest/reference/apps.md index bd5d98e273ef..542721363cd0 100644 --- a/translations/zh-CN/content/rest/reference/apps.md +++ b/translations/zh-CN/content/rest/reference/apps.md @@ -35,9 +35,7 @@ GitHub 应用程序 API 使您能够获取有关 GitHub 应用程序的高层次 安装设施 API 使您能够获取有关 GitHub 应用程序安装设施的信息并在这些安装设施中执行操作。 _安装设施_是指已安装该应用程序的任何用户或组织帐户。 有关如何验证为安装设施和限制访问特定仓库的信息，请参阅“[验证为安装设施](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)”。 -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} 要列出组织的所有 GitHub 应用程序安装设施，请参阅“[列出组织的应用程序安装设施](/v3/orgs/#list-app-installations-for-an-organization)”。 -{% endif %} {% for operation in currentRestOperations %} {% if operation.subcategory == 'installations' %}{% include rest_operation %}{% endif %} diff --git a/translations/zh-CN/content/rest/reference/code-scanning.md b/translations/zh-CN/content/rest/reference/code-scanning.md new file mode 100644 index 000000000000..9307eb41f65f --- /dev/null +++ b/translations/zh-CN/content/rest/reference/code-scanning.md @@ -0,0 +1,14 @@ +--- +title: 代码扫描 +redirect_from: + - /v3/code-scanning +versions: + free-pro-team: '*' + enterprise-server: '>=2.22' +--- + +{% data reusables.code-scanning.beta %} + +{% data variables.product.prodname_code_scanning %} API 可让您从仓库检索和更新代码扫描警告。 您可以使用端点为组织中的代码扫描警报创建自动化报告，或者使用离线代码扫描工具生成上传分析结果。 更多信息请参阅“[查找代码中的安全漏洞和错误](/github/finding-security-vulnerabilities-and-errors-in-your-code)”。 + +{% include rest_operations_at_current_path %} diff --git a/translations/zh-CN/content/rest/reference/enterprise-admin.md b/translations/zh-CN/content/rest/reference/enterprise-admin.md index 1cbc3471cec1..226906944be2 100644 --- a/translations/zh-CN/content/rest/reference/enterprise-admin.md +++ b/translations/zh-CN/content/rest/reference/enterprise-admin.md @@ -9,7 +9,7 @@ versions: enterprise-server: '*' --- -You can use these {% data variables.product.prodname_ghe_cloud %} endpoints to administer your enterprise account. +You can use these {{ site.data.variables.product.prodname_ghe_cloud }} endpoints to administer your enterprise account. {% if currentVersion == "free-pro-team@latest" %} @@ -124,11 +124,10 @@ GET /scim/v2/enterprises/{enterprise}/Users/{scim_user_id} ### 支持的 SCIM 组属性 -| 名称 | 类型 | 描述 | -| ------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------- | +| 名称 | 类型 | 描述 | +| ------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------- | | `displayName` | `字符串` | SCIM 组的名称，必须与相应 {% data variables.product.product_name %} 组织的名称完全匹配。 例如，如果组织的 URL 为`https://github.com/octo-org`，则组名必须为 `octo-org`。 | -| `members` | `数组` | 属于组成员的 SCIM 用户 ID 列表。 | - +| `members` | `数组` | 属于组成员的 SCIM 用户 ID 列表。 | {% for operation in currentRestOperations %} {% if operation.subcategory == 'scim' %}{% include rest_operation %}{% endif %} @@ -245,13 +244,13 @@ $ curl -L 'https://api_key:your-amazing-password@hostname: #### 预接收环境 -| 名称 | 类型 | 描述 | -| --------------------- | ----- | --------------------------------------------------------------------- | -| `name` | `字符串` | UI 中显示的环境名称。 | -| `image_url` | `字符串` | 将要下载并解压缩的 tarball 的 URL。 | +| 名称 | 类型 | 描述 | +| --------------------- | ----- | ---------------------------------------------------------------- | +| `name` | `字符串` | UI 中显示的环境名称。 | +| `image_url` | `字符串` | 将要下载并解压缩的 tarball 的 URL。 | | `default_environment` | `布尔值` | 这是否是 {% data variables.product.prodname_ghe_server %} 附带的默认环境。 | -| `download` | `对象` | 此环境的下载状态。 | -| `hooks_count` | `整数` | 使用此环境的预接收挂钩数量。 | +| `download` | `对象` | 此环境的下载状态。 | +| `hooks_count` | `整数` | 使用此环境的预接收挂钩数量。 | #### 预接收环境下载 diff --git a/translations/zh-CN/content/rest/reference/interactions.md b/translations/zh-CN/content/rest/reference/interactions.md index e9ae08c8a7b8..c57b33799d9c 100644 --- a/translations/zh-CN/content/rest/reference/interactions.md +++ b/translations/zh-CN/content/rest/reference/interactions.md @@ -28,9 +28,9 @@ versions: 仓库交互 API 允许具有所有者或管理员权限的用户临时限制哪些用户可以在公共存储库中发表评论、开设议题或创建拉取请求。 {% data reusables.interactions.interactions-detail %} 以下是有关 {% data variables.product.product_name %} 用户组的更多信息： -* 仓库中的 {% data reusables.interactions.existing-user-limit-definition %}。 -* 仓库中的 {% data reusables.interactions.contributor-user-limit-definition %}。 -* 仓库中的 {% data reusables.interactions.collaborator-user-limit-definition %}。 +* {% data reusables.interactions.existing-user-limit-definition %} in the repository. +* {% data reusables.interactions.contributor-user-limit-definition %} in the repository. +* {% data reusables.interactions.collaborator-user-limit-definition %} in the repository. {% for operation in currentRestOperations %} {% if operation.subcategory == 'repos' %}{% include rest_operation %}{% endif %} diff --git a/translations/zh-CN/content/rest/reference/licenses.md b/translations/zh-CN/content/rest/reference/licenses.md index 15b51cb2714d..f21ea3693555 100644 --- a/translations/zh-CN/content/rest/reference/licenses.md +++ b/translations/zh-CN/content/rest/reference/licenses.md @@ -18,8 +18,8 @@ versions: - [获取仓库](/v3/repos/#get-a-repository) - [列出用户的仓库](/v3/repos/#list-repositories-for-a-user) - [列出组织仓库](/v3/repos/#list-organization-repositories) -- [列出复刻](/v3/repos/forks/#list-forks) -- [列出用户关注的仓库](/v3/activity/watching/#list-repositories-watched-by-a-user) +- [列出复刻](/rest/reference/repos#list-forks) +- [列出用户关注的仓库](/rest/reference/activity#list-repositories-watched-by-a-user) - [列出团队仓库](/v3/teams/#list-team-repositories) {% warning %} diff --git a/translations/zh-CN/content/rest/reference/permissions-required-for-github-apps.md b/translations/zh-CN/content/rest/reference/permissions-required-for-github-apps.md index df348cca42a1..34fd07f8f03a 100644 --- a/translations/zh-CN/content/rest/reference/permissions-required-for-github-apps.md +++ b/translations/zh-CN/content/rest/reference/permissions-required-for-github-apps.md @@ -2,7 +2,7 @@ title: GitHub 应用程序所需的权限 intro: '您可以找到每个 {% data variables.product.prodname_github_app %} 兼容端点所需的权限。' redirect_from: - - /v3/apps/permissions --- + - /v3/apps/permissions versions: free-pro-team: '*' enterprise-server: '*' @@ -18,12 +18,11 @@ GitHub 应用程序默认具有 `Read-only` 元数据权限。 元数据权限 {% data reusables.apps.metadata-permissions %} - - [`GET /`](/v3/#root-endpoint) - [`GET /codes_of_conduct`](/v3/codes_of_conduct/#get-all-codes-of-conduct) - [`GET /codes_of_conduct/:key`](/v3/codes_of_conduct/#get-a-code-of-conduct) - [`GET /emojis`](/v3/emojis/#emojis) -- [`GET /feeds`](/v3/activity/feeds/#get-feeds) +- [`GET /feeds`](/rest/reference/activity#get-feeds) - [`GET /licenses`](/v3/licenses/#get-all-commonly-used-licenses) - [`GET /licenses/:key`](/v3/licenses/#get-a-license) - [`POST /markdown`](/v3/markdown/#render-a-markdown-document) @@ -39,22 +38,22 @@ GitHub 应用程序默认具有 `Read-only` 元数据权限。 元数据权限 - [`GET /repos/:owner/:repo/community/profile`](/v3/repos/community/#get-community-profile-metrics) {% endif %} - [`GET /repos/:owner/:repo/contributors`](/v3/repos/#list-repository-contributors) -- [`GET /repos/:owner/:repo/forks`](/v3/repos/forks/#list-forks) +- [`GET /repos/:owner/:repo/forks`](/rest/reference/repos#list-forks) - [`GET /repos/:owner/:repo/languages`](/v3/repos/#list-repository-languages) - [`GET /repos/:owner/:repo/license`](/v3/licenses/#get-the-license-for-a-repository) -- [`GET /repos/:owner/:repo/stargazers`](/v3/activity/starring/#list-stargazers) +- [`GET /repos/:owner/:repo/stargazers`](/rest/reference/activity#list-stargazers) - [`GET /repos/:owner/:repo/stats/code_frequency`](/v3/repos/statistics/#get-the-weekly-commit-activity) - [`GET /repos/:owner/:repo/stats/commit_activity`](/v3/repos/statistics/#get-the-last-year-of-commit-activity) - [`GET /repos/:owner/:repo/stats/contributors`](/v3/repos/statistics/#get-all-contributor-commit-activity) - [`GET /repos/:owner/:repo/stats/participation`](/v3/repos/statistics/#get-the-weekly-commit-count) - [`GET /repos/:owner/:repo/stats/punch_card`](/v3/repos/statistics/#get-the-hourly-commit-count-for-each-day) -- [`GET /repos/:owner/:repo/subscribers`](/v3/activity/watching/#list-watchers) +- [`GET /repos/:owner/:repo/subscribers`](/rest/reference/activity#list-watchers) - [`GET /repos/:owner/:repo/tags`](/v3/repos/#list-repository-tags) - [`GET /repos/:owner/:repo/topics`](/v3/repos#get-all-repository-topics) - [`GET /repositories`](/v3/repos/#list-public-repositories) - [`GET /user/repos`](/v3/repos/#list-repositories-for-the-authenticated-user) -- [`GET /user/starred`](/v3/activity/starring/#list-repositories-starred-by-a-user) -- [`GET /user/subscriptions`](/v3/activity/watching/#list-repositories-watched-by-a-user) +- [`GET /user/starred`](/rest/reference/activity#list-repositories-starred-by-a-user) +- [`GET /user/subscriptions`](/rest/reference/activity#list-repositories-watched-by-a-user) - [`GET /users`](/v3/users/#list-users) - [`GET /users/:username`](/v3/users/#get-a-user) - [`GET /users/:username/followers`](/v3/users/followers/#list-followers-of-a-user) @@ -62,10 +61,10 @@ GitHub 应用程序默认具有 `Read-only` 元数据权限。 元数据权限 - [`GET /users/:username/following/:target_user`](/v3/users/followers/#check-if-a-user-follows-another-user) - [`GET /users/:username/gpg_keys`](/v3/users/gpg_keys/#list-gpg-keys-for-a-user) - [`GET /users/:username/orgs`](/v3/orgs/#list-organizations-for-a-user) -- [`GET /users/:username/received_events`](/v3/activity/events/#list-events-received-by-the-authenticated-user) -- [`GET /users/:username/received_events/public`](/v3/activity/events/#list-public-events-received-by-a-user) +- [`GET /users/:username/received_events`](/rest/reference/activity#list-events-received-by-the-authenticated-user) +- [`GET /users/:username/received_events/public`](/rest/reference/activity#list-public-events-received-by-a-user) - [`GET /users/:username/repos`](/v3/repos/#list-repositories-for-a-user) -- [`GET /users/:username/subscriptions`](/v3/activity/watching/#list-repositories-watched-by-a-user) +- [`GET /users/:username/subscriptions`](/rest/reference/activity#list-repositories-watched-by-a-user) _协作者_ - [`GET /repos/:owner/:repo/collaborators`](/v3/repos/collaborators/#list-repository-collaborators) @@ -78,12 +77,12 @@ _提交注释_ - [`GET /repos/:owner/:repo/commits/:sha/comments`](/v3/repos/comments/#list-commit-comments) _事件_ -- [`GET /events`](/v3/activity/events/#list-public-events) -- [`GET /networks/:owner/:repo/events`](/v3/activity/events/#list-public-events-for-a-network-of-repositories) -- [`GET /orgs/:org/events`](/v3/activity/events/#list-public-organization-events) -- [`GET /repos/:owner/:repo/events`](/v3/activity/events/#list-repository-events) -- [`GET /users/:username/events`](/v3/activity/events/#list-events-for-the-authenticated-user) -- [`GET /users/:username/events/public`](/v3/activity/events/#list-public-events-for-a-user) +- [`GET /events`](/rest/reference/activity#list-public-events) +- [`GET /networks/:owner/:repo/events`](/rest/reference/activity#list-public-events-for-a-network-of-repositories) +- [`GET /orgs/:org/events`](/rest/reference/activity#list-public-organization-events) +- [`GET /repos/:owner/:repo/events`](/rest/reference/activity#list-repository-events) +- [`GET /users/:username/events`](/rest/reference/activity#list-events-for-the-authenticated-user) +- [`GET /users/:username/events/public`](/rest/reference/activity#list-public-events-for-a-user) _Git_ - [`GET /gitignore/templates`](/v3/gitignore/#get-all-gitignore-templates) @@ -169,7 +168,6 @@ _搜索_ {% if currentVersion == "free-pro-team@latest" %} - [`DELETE /repos/:owner/:repo/vulnerability-alerts`](/v3/repos/#disable-vulnerability-alerts) (:write) {% endif %} -- [`POST /user/repos`](/v3/repos/#create-a-repository-for-the-authenticated-user) (:write) - [`PATCH /user/repository_invitations/:invitation_id`](/v3/repos/invitations/#accept-a-repository-invitation) (:write) - [`DELETE /user/repository_invitations/:invitation_id`](/v3/repos/invitations/#decline-a-repository-invitation) (:write) @@ -344,12 +342,10 @@ _流量_ _分支_ - [`GET /repos/:owner/:repo/branches`](/v3/repos/branches/#list-branches) (:read) - [`GET /repos/:owner/:repo/branches/:branch`](/v3/repos/branches/#get-a-branch) (:read) -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} - [`GET /repos/:owner/:repo/branches/:branch/protection/restrictions/apps`](/v3/repos/branches/#list-apps-with-access-to-the-protected-branch) (:write) - [`POST /repos/:owner/:repo/branches/:branch/protection/restrictions/apps`](/v3/repos/branches/#add-app-access-restrictions) (:write) - [`PUT /repos/:owner/:repo/branches/:branch/protection/restrictions/apps`](/v3/repos/branches/#set-app-access-restrictions) (:write) - [`DELETE /repos/:owner/:repo/branches/:branch/protection/restrictions/apps`](/v3/repos/branches/#remove-user-access-restrictions) (:write) -{% endif %} _提交注释_ - [`PATCH /repos/:owner/:repo/comments/:comment_id`](/v3/repos/comments/#update-a-commit-comment) (:write) @@ -363,13 +359,8 @@ _Git_ - [`POST /repos/:owner/:repo/git/commits`](/v3/git/commits/#create-a-commit) (:write) - [`GET /repos/:owner/:repo/git/commits/:commit_id`](/v3/git/commits/#get-a-commit) (:read) - [`POST /repos/:owner/:repo/git/refs`](/v3/git/refs/#create-a-reference) (:write) -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -- [`GET /repos/:owner/:repo/git/refs/:ref`](/v3/git/refs/#get-a-reference) (:read) -- [`GET /repos/:owner/:repo/git/refs`](/v3/git/refs/#list-references) (:read) -{% else %} - [`GET /repos/:owner/:repo/git/ref/:ref`](/v3/git/refs/#get-a-reference) (:read) - [`GET /repos/:owner/:repo/git/matching-refs/:ref`](/v3/git/refs/#list-matching-references) (:read) -{% endif %} - [`PATCH /repos/:owner/:repo/git/refs/:ref`](/v3/git/refs/#update-a-reference) (:write) - [`DELETE /repos/:owner/:repo/git/refs/:ref`](/v3/git/refs/#delete-a-reference) (:write) - [`POST /repos/:owner/:repo/git/tags`](/v3/git/tags/#create-a-tag-object) (:write) @@ -401,27 +392,27 @@ _反应_ - [`DELETE /orgs/:org/teams/:team_slug/discussions/:discussion_number/comments/:comment_number/reactions/:reaction_id`](/v3/reactions/#delete-team-discussion-comment-reaction) (:write){% endif %} _版本发布_ -- [`GET /repos/:owner/:repo/releases`](/v3/repos/releases/#list-releases) (:read) -- [`POST /repos/:owner/:repo/releases`](/v3/repos/releases/#create-a-release) (:write) -- [`GET /repos/:owner/:repo/releases/:release_id`](/v3/repos/releases/#get-a-release) (:read) -- [`PATCH /repos/:owner/:repo/releases/:release_id`](/v3/repos/releases/#update-a-release) (:write) -- [`DELETE /repos/:owner/:repo/releases/:release_id`](/v3/repos/releases/#delete-a-release) (:write) -- [`GET /repos/:owner/:repo/releases/:release_id/assets`](/v3/repos/releases/#list-release-assets) (:read) -- [`GET /repos/:owner/:repo/releases/assets/:asset_id`](/v3/repos/releases/#get-a-release-asset) (:read) -- [`PATCH /repos/:owner/:repo/releases/assets/:asset_id`](/v3/repos/releases/#update-a-release-asset) (:write) -- [`DELETE /repos/:owner/:repo/releases/assets/:asset_id`](/v3/repos/releases/#delete-a-release-asset) (:write) -- [`GET /repos/:owner/:repo/releases/latest`](/v3/repos/releases/#get-the-latest-release) (:read) -- [`GET /repos/:owner/:repo/releases/tags/:tag`](/v3/repos/releases/#get-a-release-by-tag-name) (:read) +- [`GET /repos/:owner/:repo/releases`](/rest/reference/repos/#list-releases) (:read) +- [`POST /repos/:owner/:repo/releases`](/rest/reference/repos/#create-a-release) (:write) +- [`GET /repos/:owner/:repo/releases/:release_id`](/rest/reference/repos/#get-a-release) (:read) +- [`PATCH /repos/:owner/:repo/releases/:release_id`](/rest/reference/repos/#update-a-release) (:write) +- [`DELETE /repos/:owner/:repo/releases/:release_id`](/rest/reference/repos/#delete-a-release) (:write) +- [`GET /repos/:owner/:repo/releases/:release_id/assets`](/rest/reference/repos/#list-release-assets) (:read) +- [`GET /repos/:owner/:repo/releases/assets/:asset_id`](/rest/reference/repos/#get-a-release-asset) (:read) +- [`PATCH /repos/:owner/:repo/releases/assets/:asset_id`](/rest/reference/repos/#update-a-release-asset) (:write) +- [`DELETE /repos/:owner/:repo/releases/assets/:asset_id`](/rest/reference/repos/#delete-a-release-asset) (:write) +- [`GET /repos/:owner/:repo/releases/latest`](/rest/reference/repos/#get-the-latest-release) (:read) +- [`GET /repos/:owner/:repo/releases/tags/:tag`](/rest/reference/repos/#get-a-release-by-tag-name) (:read) ### 有关“部署”的权限 -- [`GET /repos/:owner/:repo/deployments`](/v3/repos/deployments/#list-deployments) (:read) -- [`POST /repos/:owner/:repo/deployments`](/v3/repos/deployments/#create-a-deployment) (:write) -- [`GET /repos/:owner/:repo/deployments/:deployment_id`](/v3/repos/deployments/#get-a-deployment) (:read){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -- [`DELETE /repos/:owner/:repo/deployments/:deployment_id`](/v3/repos/deployments/#delete-a-deployment) (:write){% endif %} -- [`GET /repos/:owner/:repo/deployments/:deployment_id/statuses`](/v3/repos/deployments/#list-deployment-statuses) (:read) -- [`POST /repos/:owner/:repo/deployments/:deployment_id/statuses`](/v3/repos/deployments/#create-a-deployment-status) (:write) -- [`GET /repos/:owner/:repo/deployments/:deployment_id/statuses/:status_id`](/v3/repos/deployments/#get-a-deployment-status) (:read) +- [`GET /repos/:owner/:repo/deployments`](/rest/reference/repos#list-deployments) (:read) +- [`POST /repos/:owner/:repo/deployments`](/rest/reference/repos#create-a-deployment) (:write) +- [`GET /repos/:owner/:repo/deployments/:deployment_id`](/rest/reference/repos#get-a-deployment) (:read){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} +- [`DELETE /repos/:owner/:repo/deployments/:deployment_id`](/rest/reference/repos#delete-a-deployment) (:write){% endif %} +- [`GET /repos/:owner/:repo/deployments/:deployment_id/statuses`](/rest/reference/repos#list-deployment-statuses) (:read) +- [`POST /repos/:owner/:repo/deployments/:deployment_id/statuses`](/rest/reference/repos#create-a-deployment-status) (:write) +- [`GET /repos/:owner/:repo/deployments/:deployment_id/statuses/:status_id`](/rest/reference/repos#get-a-deployment-status) (:read) ### 有关“电子邮件”的权限 @@ -618,12 +609,12 @@ _团队_ ### 有关“组织挂钩”的权限 -- [`GET /orgs/:org/hooks`](/v3/orgs/hooks/#list-organization-webhooks) (:read) -- [`POST /orgs/:org/hooks`](/v3/orgs/hooks/#create-an-organization-webhook) (:write) -- [`GET /orgs/:org/hooks/:hook_id`](/v3/orgs/hooks/#get-an-organization-webhook) (:read) -- [`PATCH /orgs/:org/hooks/:hook_id`](/v3/orgs/hooks/#update-an-organization-webhook) (:write) -- [`DELETE /orgs/:org/hooks/:hook_id`](/v3/orgs/hooks/#delete-an-organization-webhook) (:write) -- [`POST /orgs/:org/hooks/:hook_id/pings`](/v3/orgs/hooks/#ping-an-organization-webhook) (:write) +- [`GET /orgs/:org/hooks`](/rest/reference/orgs#webhooks/#list-organization-webhooks) (:read) +- [`POST /orgs/:org/hooks`](/rest/reference/orgs#webhooks/#create-an-organization-webhook) (:write) +- [`GET /orgs/:org/hooks/:hook_id`](/rest/reference/orgs#webhooks/#get-an-organization-webhook) (:read) +- [`PATCH /orgs/:org/hooks/:hook_id`](/rest/reference/orgs#webhooks/#update-an-organization-webhook) (:write) +- [`DELETE /orgs/:org/hooks/:hook_id`](/rest/reference/orgs#webhooks/#delete-an-organization-webhook) (:write) +- [`POST /orgs/:org/hooks/:hook_id/pings`](/rest/reference/orgs#webhooks/#ping-an-organization-webhook) (:write) _团队_ - [`DELETE /teams/:team_id/projects/:project_id`](/v3/teams/#remove-a-project-from-a-team) (:read) @@ -668,14 +659,14 @@ _团队_ ### 有关“页面”的权限 -- [`GET /repos/:owner/:repo/pages`](/v3/repos/pages/#get-a-github-pages-site) (:read) -- [`POST /repos/:owner/:repo/pages`](/v3/repos/pages/#create-a-github-pages-site) (:write) -- [`PUT /repos/:owner/:repo/pages`](/v3/repos/pages/#update-information-about-a-github-pages-site) (:write) -- [`DELETE /repos/:owner/:repo/pages`](/v3/repos/pages/#delete-a-github-pages-site) (:write) -- [`GET /repos/:owner/:repo/pages/builds`](/v3/repos/pages/#list-github-pages-builds) (:read) -- [`POST /repos/:owner/:repo/pages/builds`](/v3/repos/pages/#request-a-github-pages-build) (:write) -- [`GET /repos/:owner/:repo/pages/builds/:build_id`](/v3/repos/pages/#get-github-pages-build) (:read) -- [`GET /repos/:owner/:repo/pages/builds/latest`](/v3/repos/pages/#get-latest-pages-build) (:read) +- [`GET /repos/:owner/:repo/pages`](/rest/reference/repos#get-a-github-pages-site) (:read) +- [`POST /repos/:owner/:repo/pages`](/rest/reference/repos#create-a-github-pages-site) (:write) +- [`PUT /repos/:owner/:repo/pages`](/rest/reference/repos#update-information-about-a-github-pages-site) (:write) +- [`DELETE /repos/:owner/:repo/pages`](/rest/reference/repos#delete-a-github-pages-site) (:write) +- [`GET /repos/:owner/:repo/pages/builds`](/rest/reference/repos#list-github-pages-builds) (:read) +- [`POST /repos/:owner/:repo/pages/builds`](/rest/reference/repos#request-a-github-pages-build) (:write) +- [`GET /repos/:owner/:repo/pages/builds/:build_id`](/rest/reference/repos#get-github-pages-build) (:read) +- [`GET /repos/:owner/:repo/pages/builds/latest`](/rest/reference/repos#get-latest-pages-build) (:read) ### 有关“拉取请求”的权限 @@ -853,9 +844,9 @@ _团队_ ### 有关“星标”的权限 -- [`GET /user/starred/:owner/:repo`](/v3/activity/starring/#check-if-a-repository-is-starred-by-the-authenticated-user) (:read) -- [`PUT /user/starred/:owner/:repo`](/v3/activity/starring/#star-a-repository-for-the-authenticated-user) (:write) -- [`DELETE /user/starred/:owner/:repo`](/v3/activity/starring/#unstar-a-repository-for-the-authenticated-user) (:write) +- [`GET /user/starred/:owner/:repo`](/rest/reference/activity#check-if-a-repository-is-starred-by-the-authenticated-user) (:read) +- [`PUT /user/starred/:owner/:repo`](/rest/reference/activity#star-a-repository-for-the-authenticated-user) (:write) +- [`DELETE /user/starred/:owner/:repo`](/rest/reference/activity#unstar-a-repository-for-the-authenticated-user) (:write) ### 有关“状态”的权限 diff --git a/translations/zh-CN/content/rest/reference/repos.md b/translations/zh-CN/content/rest/reference/repos.md index d166d77aafb1..5345c36af2fc 100644 --- a/translations/zh-CN/content/rest/reference/repos.md +++ b/translations/zh-CN/content/rest/reference/repos.md @@ -186,10 +186,10 @@ versions: * `built`：站点已构建。 * `errored`：表示构建过程中发生错误。 -在{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %}支持 `mister-fantastic-preview` 并{% endif %}返回 GitHub Pages 站点信息的 {% data variables.product.prodname_pages %} API 端点中，JSON 响应包括以下字段： +在返回 GitHub Pages 站点信息的 {% data variables.product.prodname_pages %} API 端点中，JSON 响应包括以下字段： * `html_url`：所渲染的 Pages 站点的绝对 URL（包括模式）。 例如，`https://username.github.io`。 * `source`：包含所渲染 Pages 站点的源分支和目录的对象。 这包括： - - `branch`：用于发布[站点源文件](/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)的仓库分支。 例如，_master_ 或 _gh-pages_。 + - `branch`：用于发布[站点源文件](/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)的仓库分支。 For example, _main_ or _gh-pages_. - `path`：提供站点发布内容的仓库目录。 可能是 `/` 或 `/docs`。 {% for operation in currentRestOperations %} @@ -216,7 +216,7 @@ versions: 计算仓库统计信息是一项昂贵的操作，所以我们尽可能返回缓存的数据。 如果您查询仓库的统计信息时，数据尚未缓存，您将会收到 `202` 响应；同时触发后台作业以开始编译这些统计信息。 稍等片刻，待作业完成，然后再次提交请求。 如果作业已完成，该请求将返回 `200` 响应，响应正文中包含统计信息。 -仓库统计信息由仓库默认分支（一般是 master）的 SHA 缓存；推送到默认分支将重置统计信息缓存。 +Repository statistics are cached by the SHA of the repository's default branch; pushing to the default branch resets the statistics cache. ### 统计排除某些类型的提交 @@ -292,7 +292,7 @@ GitHub 还可以作为所有仓库的 [PubSubHubbabub](https://github.com/pubsub #### 回调 URL 回调 URL 可以使用 `http://` 协议。 -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.20" %}您还可以 `github://` 回调以指定 GitHub 服务。 +{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.20" %}您还可以 `github://` 回叫以指定 GitHub 服务。 {% data reusables.apps.deprecating_github_services_ghe %} {% endif %} diff --git a/translations/zh-CN/data/glossaries/external.yml b/translations/zh-CN/data/glossaries/external.yml index 81c55675a209..4fa2651fa901 100644 --- a/translations/zh-CN/data/glossaries/external.yml +++ b/translations/zh-CN/data/glossaries/external.yml @@ -24,14 +24,14 @@ - term: 验证码 description: >- - A code you'll supply, in addition to your GitHub password, when signing in with 2FA via the browser. This code is either generated by an application or delivered to your phone via text message. Also called a "2FA authentication code." + 在使用 2FA 通过浏览器登录时，除了 GitHub 密码之外您还要提供的一种代码。此代码由应用程序生成，或通过短信发送到手机，也称为“2FA 验证码”。 - term: 基础分支 description: 在合并拉取请求时将变更并入其中的分支。创建拉取请求时，如果需要，可以将基础分支从仓库的默认分支更改为另一个分支。 - term: 基本验证 description: >- - A method of authentication where the credentials are sent as unencrypted text. + 凭据以未加密文本形式发送的身份验证方法。 - term: 个人简历 description: >- @@ -180,7 +180,7 @@ - term: 默认分支 description: >- - 仓库中的基本分支，除非您指定不同的分支，否则会自动对它完成所有拉取请求和代码提交。此分支通常称为 `master`。 + The base branch for new pull requests and code commits in a repository. Each repository has at least one branch, which Git creates when you initialize the repository. The first branch is usually called `main`, and is often the default branch. - term: 从属者图 description: >- diff --git a/translations/zh-CN/data/glossaries/internal.yml b/translations/zh-CN/data/glossaries/internal.yml index 10c3515c7f10..f951d1f08cc9 100644 --- a/translations/zh-CN/data/glossaries/internal.yml +++ b/translations/zh-CN/data/glossaries/internal.yml @@ -726,7 +726,7 @@ description: >- 提供云计算和平台虚拟化软件与服务的戴尔产品。 - - term: allowlisted + term: 白名单 description: >- 被授予特别权限、服务、移动性、访问或认可的实体列表或注册表。列表中的实体将被接受、批准和/或认可。 - diff --git a/translations/zh-CN/data/graphql/2.22/graphql_upcoming_changes.public-enterprise.yml b/translations/zh-CN/data/graphql/2.22/graphql_upcoming_changes.public-enterprise.yml index d29b0ce901d8..4acc318c988b 100644 --- a/translations/zh-CN/data/graphql/2.22/graphql_upcoming_changes.public-enterprise.yml +++ b/translations/zh-CN/data/graphql/2.22/graphql_upcoming_changes.public-enterprise.yml @@ -44,8 +44,8 @@ upcoming_changes: owner: antn - location: EnterprisePendingMemberInvitationEdge.isUnlicensed - description: "`isUnlicensed` will be removed." - reason: All pending members consume a license + description: "`isUnlicensed` 将被删除。" + reason: 所有挂起的成员都会使用许可证 date: '2020-07-01T00:00:00+00:00' criticality: 重大 owner: BrentWheeldon @@ -107,22 +107,22 @@ upcoming_changes: owner: oneill38 - location: EnterpriseMemberEdge.isUnlicensed - description: "`isUnlicensed` will be removed." - reason: All members consume a license + description: "`isUnlicensed` 将被删除。" + reason: 所有成员都会使用许可证 date: '2021-01-01T00:00:00+00:00' criticality: 重大 owner: BrentWheeldon - location: EnterpriseOutsideCollaboratorEdge.isUnlicensed - description: "`isUnlicensed` will be removed." - reason: All outside collaborators consume a license + description: "`isUnlicensed` 将被删除。" + reason: 所有外部协作者使用许可证 date: '2021-01-01T00:00:00+00:00' criticality: 重大 owner: BrentWheeldon - location: EnterprisePendingCollaboratorEdge.isUnlicensed - description: "`isUnlicensed` will be removed." - reason: All pending collaborators consume a license + description: "`isUnlicensed` 将被删除。" + reason: 所有挂起的协作者使用许可证 date: '2021-01-01T00:00:00+00:00' criticality: 重大 owner: BrentWheeldon diff --git a/translations/zh-CN/data/graphql/graphql_previews.yml b/translations/zh-CN/data/graphql/graphql_previews.yml index f49bab1ab351..18e16574dc08 100644 --- a/translations/zh-CN/data/graphql/graphql_previews.yml +++ b/translations/zh-CN/data/graphql/graphql_previews.yml @@ -27,57 +27,6 @@ - CreateDeploymentPayload owning_teams: - '@github/ecosystem-api' -- - title: 检查 - description: 此预览支持由 GitHub 应用程序创建的读取检查。 - toggled_by: ':antiope-preview' - announcement: null - updates: null - toggled_on: - - CheckAnnotationRange - - CheckAnnotationPosition - - CheckAnnotationSpan - - CheckAnnotation - - CheckAnnotationConnection.nodes - - CheckAnnotationData - - CheckAnnotationEdge.node - - CheckAnnotationLevel - - CheckConclusionState - - CheckStatusState - - CheckSuiteAutoTriggerPreference - - CheckRun - - CheckRunConnection.nodes - - CheckRunEdge.node - - CheckRunAction - - CheckRunFilter - - CheckRunOutput - - CheckRunOutputImage - - CheckRunType - - CheckSuite - - CheckSuiteConnection.nodes - - CheckSuiteEdge.node - - CheckSuiteFilter - - CreateCheckRunInput - - CreateCheckRunPayload - - CreateCheckSuiteInput - - CreateCheckSuitePayload - - Commit.checkSuites - - Mutation.createCheckRun - - Mutation.createCheckSuite - - Mutation.rerequestCheckSuite - - Mutation.updateCheckRun - - Mutation.updateCheckSuitePreferences - - 推送 - - RequestableCheckStatusState - - RerequestCheckSuiteInput - - RerequestCheckSuitePayload - - UpdateCheckRunInput - - UpdateCheckRunPayload - - UpdateCheckSuitePayload.checkSuite - - UpdateCheckSuitePreferencesInput - - UpdateCheckSuitePreferencesPayload - owning_teams: - - '@github/ce-extensibility' - title: >- MergeInfoPreview - 有关拉取请求合并状态的更多详细信息。 diff --git a/translations/zh-CN/data/graphql/graphql_upcoming_changes.public.yml b/translations/zh-CN/data/graphql/graphql_upcoming_changes.public.yml index 3f0ffd49e3e7..ca58d2dbdf8b 100644 --- a/translations/zh-CN/data/graphql/graphql_upcoming_changes.public.yml +++ b/translations/zh-CN/data/graphql/graphql_upcoming_changes.public.yml @@ -51,8 +51,8 @@ upcoming_changes: owner: antn - location: EnterprisePendingMemberInvitationEdge.isUnlicensed - description: "`isUnlicensed` will be removed." - reason: All pending members consume a license + description: "`isUnlicensed` 将被删除。" + reason: 所有挂起的成员都会使用许可证 date: '2020-07-01T00:00:00+00:00' criticality: 重大 owner: BrentWheeldon @@ -114,29 +114,29 @@ upcoming_changes: owner: oneill38 - location: EnterpriseMemberEdge.isUnlicensed - description: "`isUnlicensed` will be removed." - reason: All members consume a license + description: "`isUnlicensed` 将被删除。" + reason: 所有成员都会使用许可证 date: '2021-01-01T00:00:00+00:00' criticality: 重大 owner: BrentWheeldon - location: EnterpriseOutsideCollaboratorEdge.isUnlicensed - description: "`isUnlicensed` will be removed." - reason: All outside collaborators consume a license + description: "`isUnlicensed` 将被删除。" + reason: 所有外部协作者使用许可证 date: '2021-01-01T00:00:00+00:00' criticality: 重大 owner: BrentWheeldon - location: EnterprisePendingCollaboratorEdge.isUnlicensed - description: "`isUnlicensed` will be removed." - reason: All pending collaborators consume a license + description: "`isUnlicensed` 将被删除。" + reason: 所有挂起的协作者使用许可证 date: '2021-01-01T00:00:00+00:00' criticality: 重大 owner: BrentWheeldon - location: MergeStateStatus.DRAFT - description: "`DRAFT` will be removed. Use PullRequest.isDraft instead." - reason: DRAFT state will be removed from this enum and `isDraft` should be used instead + description: "`DRAFT` 将被删除。改为使用 PullRequest.isDraft。" + reason: DRAFT 状态将从这个枚举中删除，应改用 `isDraft` date: '2021-01-01T00:00:00+00:00' criticality: 重大 owner: nplasterer diff --git a/translations/zh-CN/data/products.yml b/translations/zh-CN/data/products.yml index abb51fa8c446..d076566a914b 100644 --- a/translations/zh-CN/data/products.yml +++ b/translations/zh-CN/data/products.yml @@ -4,7 +4,7 @@ #note this file should not be translated productsInOrder: - github - - enterpriseServer + - 管理员 - 操作 - 包 - developers @@ -12,12 +12,3 @@ productsInOrder: - graphql - insights - desktop -#TODO this can be removed when the new versioning handling is in place -hasEnterpriseUserVersions: - - github - - 操作 - - developers - - rest - - graphql - - insights - - 包 diff --git a/translations/zh-CN/data/reusables/actions/about-artifact-log-retention.md b/translations/zh-CN/data/reusables/actions/about-artifact-log-retention.md new file mode 100644 index 000000000000..aa8a5300359d --- /dev/null +++ b/translations/zh-CN/data/reusables/actions/about-artifact-log-retention.md @@ -0,0 +1,6 @@ +By default, the artifacts and log files generated by workflows are retained for 90 days before they are automatically deleted. You can adjust the retention period, depending on the type of repository: + +- For public repositories: you can change this retention period to anywhere between 1 day or 90 days. +- For private, internal, and {% data variables.product.prodname_enterprise %} repositories: you can change this retention period to anywhere between 1 day or 400 days. + +When you customize the retention period, it only applies to new artifacts and log files, and does not retroactively apply to existing objects. For managed repositories and organizations, the maximum retention period cannot exceed the limit set by the managing organization or enterprise. diff --git a/translations/zh-CN/data/reusables/actions/about-artifacts.md b/translations/zh-CN/data/reusables/actions/about-artifacts.md index 99b604753e4b..0a9d2333f4fc 100644 --- a/translations/zh-CN/data/reusables/actions/about-artifacts.md +++ b/translations/zh-CN/data/reusables/actions/about-artifacts.md @@ -1 +1 @@ -Artifacts enable you to share data between jobs in a workflow and store data once that workflow has completed. \ No newline at end of file +构件允许您在工作流程完成后，分享工作流程中作业之间的数据并存储数据。 diff --git a/translations/zh-CN/data/reusables/actions/about-secrets.md b/translations/zh-CN/data/reusables/actions/about-secrets.md index 94b36e1c5846..37d6d64b4257 100644 --- a/translations/zh-CN/data/reusables/actions/about-secrets.md +++ b/translations/zh-CN/data/reusables/actions/about-secrets.md @@ -1 +1 @@ -Encrypted secrets allow you to store sensitive information, such as access tokens, in your repository or organization. \ No newline at end of file +加密的密码允许您在仓库或组织中存储敏感信息，如访问令牌。 diff --git a/translations/zh-CN/data/reusables/actions/about-self-hosted-runners.md b/translations/zh-CN/data/reusables/actions/about-self-hosted-runners.md index 0e2edd274acf..ddc8ee18dd58 100644 --- a/translations/zh-CN/data/reusables/actions/about-self-hosted-runners.md +++ b/translations/zh-CN/data/reusables/actions/about-self-hosted-runners.md @@ -1 +1 @@ -Self-hosted runners allow you to host your own runners and customize the environment used to run jobs in your {% data variables.product.prodname_actions %} workflows. \ No newline at end of file +自托管运行器允许您托管自己的运行器，并自定义用于在 {% data variables.product.prodname_actions %} 工作流程中运行作业的环境。 diff --git a/translations/zh-CN/data/reusables/actions/about-workflow-jobs.md b/translations/zh-CN/data/reusables/actions/about-workflow-jobs.md index ba8ef85e4da8..56092864687e 100644 --- a/translations/zh-CN/data/reusables/actions/about-workflow-jobs.md +++ b/translations/zh-CN/data/reusables/actions/about-workflow-jobs.md @@ -1 +1 @@ -A workflow job is a set of steps that execute on the same runner. \ No newline at end of file +工作流程作业是在同一运行服务器上执行的一组步骤。 diff --git a/translations/zh-CN/data/reusables/actions/about-workflow-runs.md b/translations/zh-CN/data/reusables/actions/about-workflow-runs.md index fc10b8a30547..7a69d7177439 100644 --- a/translations/zh-CN/data/reusables/actions/about-workflow-runs.md +++ b/translations/zh-CN/data/reusables/actions/about-workflow-runs.md @@ -1 +1 @@ -A workflow run is an instance of your workflow that runs when the pre-configured event occurs. \ No newline at end of file +工作流程运行是当预配置的事件发生时运行的工作流程实例。 diff --git a/translations/zh-CN/data/reusables/actions/about-workflows.md b/translations/zh-CN/data/reusables/actions/about-workflows.md index 6ff1dd709ae1..eb20577bd1fe 100644 --- a/translations/zh-CN/data/reusables/actions/about-workflows.md +++ b/translations/zh-CN/data/reusables/actions/about-workflows.md @@ -1 +1 @@ -Workflows automate your software development life cycle with a wide range of tools and services. \ No newline at end of file +工作流程通过广泛的各种工具和服务自动化软件开发生命周期。 diff --git a/translations/zh-CN/data/reusables/actions/actions-app-actions-permissions-api.md b/translations/zh-CN/data/reusables/actions/actions-app-actions-permissions-api.md index 251474c83b40..19f7486bb25b 100644 --- a/translations/zh-CN/data/reusables/actions/actions-app-actions-permissions-api.md +++ b/translations/zh-CN/data/reusables/actions/actions-app-actions-permissions-api.md @@ -1 +1 @@ -{% data variables.product.prodname_github_app %}s must have the `actions` permission to use this API. \ No newline at end of file +{% data variables.product.prodname_github_app %} 必须具有 `actions` 权限才可使用此 API。 diff --git a/translations/zh-CN/data/reusables/actions/actions-authentication.md b/translations/zh-CN/data/reusables/actions/actions-authentication.md index 266246660c6e..52dac9dceddb 100644 --- a/translations/zh-CN/data/reusables/actions/actions-authentication.md +++ b/translations/zh-CN/data/reusables/actions/actions-authentication.md @@ -1 +1 @@ -This API is available for authenticated users, {% data variables.product.prodname_oauth_app %}s, and {% data variables.product.prodname_github_app %}s. Access tokens require [`repo` scope](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes) for private repos and [`public_repo` scope](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes) for public repos. \ No newline at end of file +此 API 适用于经过身份验证的用户、{% data variables.product.prodname_oauth_app %} 和 {% data variables.product.prodname_github_app %}。 访问令牌需要 [`repo` 作用域](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)（对于私有仓库）和 [`public_repo` 作用域](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)（对于公共仓库）。 diff --git a/translations/zh-CN/data/reusables/actions/actions-not-verified.md b/translations/zh-CN/data/reusables/actions/actions-not-verified.md index b2a9577daa60..dcfd5cdeef8f 100644 --- a/translations/zh-CN/data/reusables/actions/actions-not-verified.md +++ b/translations/zh-CN/data/reusables/actions/actions-not-verified.md @@ -1 +1 @@ -Anyone can publish an action in {% data variables.product.prodname_marketplace %} as long as they meet the terms of service. Unlike apps, {% data variables.product.prodname_actions %} listed in {% data variables.product.prodname_marketplace %} are not verified by {% data variables.product.prodname_dotcom %}. \ No newline at end of file +只要符合服务条款，任何人都可以在 {% data variables.product.prodname_marketplace %} 中发布操作。 与应用程序不同， 在 {% data variables.product.prodname_marketplace %} 中列出的 {% data variables.product.prodname_actions %} 不会经过 {% data variables.product.prodname_dotcom %} 验证。 diff --git a/translations/zh-CN/data/reusables/actions/actions-use-policy-settings.md b/translations/zh-CN/data/reusables/actions/actions-use-policy-settings.md new file mode 100644 index 000000000000..b25cd5eb26be --- /dev/null +++ b/translations/zh-CN/data/reusables/actions/actions-use-policy-settings.md @@ -0,0 +1,3 @@ +If you choose the option to **Allow specific actions**, there are additional options that you can configure. For more information, see "[Allowing specific actions to run](#allowing-specific-actions-to-run)." + +When you allow local actions only, the policy blocks all access to actions authored by {% data variables.product.prodname_dotcom %}. For example, the [`actions/checkout`](https://github.com/actions/checkout) would not be accessible. \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/actions/allow-specific-actions-intro.md b/translations/zh-CN/data/reusables/actions/allow-specific-actions-intro.md new file mode 100644 index 000000000000..248668d773ef --- /dev/null +++ b/translations/zh-CN/data/reusables/actions/allow-specific-actions-intro.md @@ -0,0 +1,19 @@ +When you select the **Allow select actions**, there are additional options that you need to choose to configure the allowed actions: + +- **Allow actions created by {% data variables.product.prodname_dotcom %}:** You can allow all actions created by {% data variables.product.prodname_dotcom %} to be used by workflows. Actions created by {% data variables.product.prodname_dotcom %} are located in the `actions` and `github` organization. For more information, see the [`actions`](https://github.com/actions) and [`github`](https://github.com/github) organizations. +- **Allow Marketplace actions by verified creators:** You can allow all {% data variables.product.prodname_marketplace %} actions created by verified creators to be used by workflows. When GitHub has verified the creator of the action as a partner organization, the {% octicon "verified" aria-label="The verified badge" %} badge is displayed next to the action in {% data variables.product.prodname_marketplace %}. +- **Allow specified actions:** You can restrict workflows to use actions in specific organizations and repositories. + + To restrict access to specific tags or commit SHAs of an action, use the same `/@` syntax used in the workflow to select the action. For example, `actions/javascript-action@v1.0.1` to select a tag or `actions/javascript-action@172239021f7ba04fe7327647b213799853a9eb89` to select a SHA. For more information, see "[Finding and customizing actions](/actions/learn-github-actions/finding-and-customizing-actions#using-release-management-for-your-custom-actions)." + + You can use the `*` wildcard character to match patterns. For example, to allow all actions in organizations that start with `space-org`, you can specify `space-org*/*`. To add all actions in repositories that start with octocat, you can use `*/octocat*@*`. For more information about using the `*` wildcard, see "[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#filter-pattern-cheat-sheet)." + + {% if currentVersion == "free-pro-team@latest" %} + {% note %} + + **Note:** The **Allow specified actions** option is only available in public repositories with the {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} for organizations, or {% data variables.product.prodname_team %} plan. + + {% endnote %} + {% endif %} + +This procedure demonstrates how to add specific actions to the allow list. diff --git a/translations/zh-CN/data/reusables/actions/enterprise-actions-permissions.md b/translations/zh-CN/data/reusables/actions/enterprise-actions-permissions.md index e4ef91fbd8b4..ccaff3565825 100644 --- a/translations/zh-CN/data/reusables/actions/enterprise-actions-permissions.md +++ b/translations/zh-CN/data/reusables/actions/enterprise-actions-permissions.md @@ -1 +1 @@ -1. 在“Policies（策略）”下，选择一个选项。 ![启用、禁用或限制此企业帐户的操作](/assets/images/help/settings/actions-enable-enterprise-account.png) \ No newline at end of file +1. 在“Policies（策略）”下，选择一个选项。 ![启用、禁用或限制此企业帐户的操作](/assets/images/help/organizations/enterprise-actions-policy.png) diff --git a/translations/zh-CN/data/reusables/actions/enterprise-beta.md b/translations/zh-CN/data/reusables/actions/enterprise-beta.md index 876f328cd5c0..5f4014ad6153 100644 --- a/translations/zh-CN/data/reusables/actions/enterprise-beta.md +++ b/translations/zh-CN/data/reusables/actions/enterprise-beta.md @@ -1,7 +1,7 @@ {% if currentVersion != "free-pro-team@latest" and currentVersion == "enterprise-server@2.22" %} {% note %} -**Note:** {% data variables.product.prodname_actions %} support on {% data variables.product.prodname_ghe_server %} 2.22 is a limited public beta. To review the external storage requirements and request access to the beta, see "[Enabling {% data variables.product.prodname_actions %} and configuring storage](/enterprise/admin/github-actions/enabling-github-actions-and-configuring-storage)." +**注：**{% data variables.product.prodname_ghe_server %} 2.22 上的 {% data variables.product.prodname_actions %} 支持是有限的公测版。 要查看外部存储要求并请求访问测试版，请参阅“[启用 {% data variables.product.prodname_actions %} 和配置存储](/enterprise/admin/github-actions/enabling-github-actions-and-configuring-storage)”。 {% endnote %} -{% endif %} \ No newline at end of file +{% endif %} diff --git a/translations/zh-CN/data/reusables/actions/enterprise-github-hosted-runners.md b/translations/zh-CN/data/reusables/actions/enterprise-github-hosted-runners.md index 1ef3c4ce19a6..6b261671df86 100644 --- a/translations/zh-CN/data/reusables/actions/enterprise-github-hosted-runners.md +++ b/translations/zh-CN/data/reusables/actions/enterprise-github-hosted-runners.md @@ -1,7 +1,7 @@ {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %} {% note %} -**Note:** {% data variables.product.prodname_dotcom %}-hosted runners are not currently supported on {% data variables.product.prodname_ghe_server %}. You can see more information about planned future support on the [{% data variables.product.prodname_roadmap %}](https://github.com/github/roadmap/issues/72). +**注：** {% data variables.product.prodname_dotcom %} 托管的运行器目前在 {% data variables.product.prodname_ghe_server %} 上不受支持。 您可以在 [{% data variables.product.prodname_roadmap %}](https://github.com/github/roadmap/issues/72) 上查看有关未来支持计划的更多信息。 {% endnote %} -{% endif %} \ No newline at end of file +{% endif %} diff --git a/translations/zh-CN/data/reusables/actions/enterprise-marketplace-actions.md b/translations/zh-CN/data/reusables/actions/enterprise-marketplace-actions.md index 626997f72422..2b069953f0a9 100644 --- a/translations/zh-CN/data/reusables/actions/enterprise-marketplace-actions.md +++ b/translations/zh-CN/data/reusables/actions/enterprise-marketplace-actions.md @@ -2,7 +2,7 @@ {% note %} -**Note:** {% data variables.product.prodname_actions %} on {% data variables.product.product_location %} may have limited access to actions on {% data variables.product.prodname_dotcom_the_website %} or {% data variables.product.prodname_marketplace %}. 更多信息请参阅“[自托管运行器与 {% data variables.product.prodname_dotcom %} 之间的通信](#communication-between-self-hosted-runners-and-github)”。 +**注：{% data variables.product.product_location %} 上的 **{% data variables.product.prodname_actions %} 对 {% data variables.product.prodname_dotcom_the_website %} 或 {% data variables.product.prodname_marketplace %} 上的操作具有有限的访问权限。 更多信息请参阅“[自托管运行器与 {% data variables.product.prodname_dotcom %} 之间的通信](#communication-between-self-hosted-runners-and-github)”。 {% endnote %} diff --git a/translations/zh-CN/data/reusables/actions/enterprise-no-internet-actions.md b/translations/zh-CN/data/reusables/actions/enterprise-no-internet-actions.md index 9f2287cfee01..b589b76048cf 100644 --- a/translations/zh-CN/data/reusables/actions/enterprise-no-internet-actions.md +++ b/translations/zh-CN/data/reusables/actions/enterprise-no-internet-actions.md @@ -1 +1 @@ -{% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} is designed to work in environments without internet access. By default, workflows cannot use actions from {% data variables.product.prodname_dotcom_the_website %} and [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=actions). +{% data variables.product.prodname_ghe_server %} 上的 {% data variables.product.prodname_actions %} 设计为在没有互联网连接的环境中工作。 默认情况下，工作流程不能使用直接来自 {% data variables.product.prodname_dotcom_the_website %} 和 [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=actions) 的操作。 diff --git a/translations/zh-CN/data/reusables/actions/enterprise-setup-prereq.md b/translations/zh-CN/data/reusables/actions/enterprise-setup-prereq.md index 3ead3e20f902..c977eab7ced1 100644 --- a/translations/zh-CN/data/reusables/actions/enterprise-setup-prereq.md +++ b/translations/zh-CN/data/reusables/actions/enterprise-setup-prereq.md @@ -1,7 +1,7 @@ {% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %} -#### Using self-hosted runners on {% data variables.product.prodname_ghe_server %} +#### 在 {% data variables.product.prodname_ghe_server %} 上使用自托管的运行器 -When using setup actions (such as `actions/setup-LANGUAGE`) on {% data variables.product.prodname_ghe_server %} with self-hosted runners, you might need to set up the tools cache on runners that do not have internet access. For more information, see "[Setting up the tool cache on self-hosted runners without internet access](/enterprise/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access)." +在包含自托管运行器的 {% data variables.product.prodname_ghe_server %} 上使用设置操作（例如 `actions/setup-LANGUAGE`）时，您可能需要在没有连接互联网的运行器上设置工具缓存。 更多信息请参阅“[在没有互联网连接的自托管运行器上设置工具缓存](/enterprise/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access)”。 {% endif %} diff --git a/translations/zh-CN/data/reusables/actions/registry-credentials.md b/translations/zh-CN/data/reusables/actions/registry-credentials.md new file mode 100644 index 000000000000..829539de7800 --- /dev/null +++ b/translations/zh-CN/data/reusables/actions/registry-credentials.md @@ -0,0 +1 @@ +If the image's container registry requires authentication to pull the image, you can use `credentials` to set a `map` of the `username` and `password`. The credentials are the same values that you would provide to the [`docker login`](https://docs.docker.com/engine/reference/commandline/login/) command. diff --git a/translations/zh-CN/data/reusables/actions/scheduled-workflows-disabled.md b/translations/zh-CN/data/reusables/actions/scheduled-workflows-disabled.md new file mode 100644 index 000000000000..bdec7e515b23 --- /dev/null +++ b/translations/zh-CN/data/reusables/actions/scheduled-workflows-disabled.md @@ -0,0 +1 @@ +To prevent unnecessary workflow runs, scheduled workflows may be disabled automatically. When a public repository is forked, scheduled workflows are disabled by default. In a public repository, scheduled workflows are automatically disabled when no repository activity has occurred in 60 days. diff --git a/translations/zh-CN/data/reusables/apps/accept_new_permissions_steps.md b/translations/zh-CN/data/reusables/apps/accept_new_permissions_steps.md index 7fd674922865..cd66bf33ad75 100644 --- a/translations/zh-CN/data/reusables/apps/accept_new_permissions_steps.md +++ b/translations/zh-CN/data/reusables/apps/accept_new_permissions_steps.md @@ -1,2 +1,2 @@ -1. Click **Save changes** at the bottom of the page. -1. If you've installed the app on your account, check your email and follow the link to accept the new permissions. Any time you change your app's permissions or webhooks, users who have installed the app (including yourself) will need to accept the new permissions before the changes take effect. You can also accept the new permissions by navigating to your [installations page](https://github.com/settings/installations) and clicking on "Configure" next to your app. You'll see a banner at the top of the page letting you know that the app is requesting different permissions. Click "Details" and click "Accept new permissions." +1. 单击页面底部的 **Save changes（保存更改）**。 +1. 如果您已经在您的帐户上安装了应用程序，请检查您的电子邮件并按照链接接受新的权限。 每次更改应用程序的权限或 web 挂钩时，安装应用程序的用户（包括您自己）都需要在更改生效之前接受新权限。 您也可以通过导航到[安装页面](https://github.com/settings/installations)并单击应用程序旁边的“Configure（配置）”来接受新的权限。 您将在页面顶部看到一个横幅，让您知道应用程序正在请求不同的权限。 单击“Details（详细信息）”，然后单击“Accept new permissions（接受新权限）”。 diff --git a/translations/zh-CN/data/reusables/apps/api-rate-limits-non-ghec.md b/translations/zh-CN/data/reusables/apps/api-rate-limits-non-ghec.md index 947f82aea73b..48fbf0af8292 100644 --- a/translations/zh-CN/data/reusables/apps/api-rate-limits-non-ghec.md +++ b/translations/zh-CN/data/reusables/apps/api-rate-limits-non-ghec.md @@ -1 +1 @@ -{% data variables.product.prodname_github_app %}s making server-to-server requests use the installation's minimum rate limit of 5,000 requests per hour. Organization installations with more than 20 users receive another 50 requests per hour for each user. Installations that have more than 20 repositories receive another 50 requests per hour for each repository. The maximum rate limit for an installation is 12,500 requests per hour. +发出服务器-服务器请求的 {% data variables.product.prodname_github_app %} 使用安装的最低速率限制为每小时 5,000 个请求。 具有 20 个以上用户的组织安装每小时每个用户将再收到 50 个请求。 具有 20 个以上仓库的安装每小时会为每个仓库再接收 50 个请求。 安装的最大速率限制为每小时 12,500 个请求。 diff --git a/translations/zh-CN/data/reusables/apps/app-ruby-guides.md b/translations/zh-CN/data/reusables/apps/app-ruby-guides.md index fe649b0de5e2..2d06b6ac9896 100644 --- a/translations/zh-CN/data/reusables/apps/app-ruby-guides.md +++ b/translations/zh-CN/data/reusables/apps/app-ruby-guides.md @@ -1,5 +1,5 @@ {% note %} -**Note:** This guide demonstrates the app development process using the Ruby programming language. However, there are many [flavors of Octokit](/v3/libraries/). If you prefer JavaScript, you can use [Probot](https://probot.github.io/) and [Node.js](https://octokit.github.io/rest.js/) to develop GitHub Apps. +**注：**本指南演示了使用 Ruby 编程语言的应用程序开发过程。 但有很多[Octokit 风格](/v3/libraries/)。 如果您喜欢 JavaScript，可以使用 [Probot](https://probot.github.io/) 和 [Node.js](https://octokit.github.io/rest.js/) 开发 GitHub 应用程序。 {% endnote %} diff --git a/translations/zh-CN/data/reusables/apps/app_manager_role.md b/translations/zh-CN/data/reusables/apps/app_manager_role.md index a0f9d5c0c5de..ec8bcdbdf9ae 100644 --- a/translations/zh-CN/data/reusables/apps/app_manager_role.md +++ b/translations/zh-CN/data/reusables/apps/app_manager_role.md @@ -1 +1 @@ -By default, only organization owners can manage the settings of GitHub Apps in an organization. To allow additional users to manage GitHub Apps in an organization, an owner can grant them GitHub App manager permissions. See "[GitHub App Managers](/articles/permission-levels-for-an-organization/#github-app-managers)" to learn how to add and remove GitHub App managers in your organization. +默认情况下，只有组织所有者才可管理组织中 GitHub 的设置。 要允许其他用户管理组织中的 GitHub 应用程序，所有者可以向他们授予 GitHub 应用程序管理员权限。 请参阅“[GitHub 应用程序](/articles/permission-levels-for-an-organization/#github-app-managers)”，了解如何在组织中添加和删除 GitHub 应用程序管理员。 diff --git a/translations/zh-CN/data/reusables/apps/beta_feature_activation.md b/translations/zh-CN/data/reusables/apps/beta_feature_activation.md index 0dda3037dbcd..d8d97b47f606 100644 --- a/translations/zh-CN/data/reusables/apps/beta_feature_activation.md +++ b/translations/zh-CN/data/reusables/apps/beta_feature_activation.md @@ -1,2 +1,2 @@ -4. In the left sidebar, click **Beta Features**. ![GitHub Apps or OAuth Apps section](/assets/images/github-apps/beta-features-option.png) -5. Next to the beta feature you want to enable for your app, click **Opt-in**. ![Opt-in button to enable a beta feature](/assets/images/github-apps/enable-beta-features.png) +4. In the left sidebar, click **Beta Features**. ![GitHub 应用程序或 OAuth 应用程序部分](/assets/images/github-apps/beta-features-option.png) +5. 在您要为应用程序启用的测试版功能旁边，单击“**Opt-in（加入）**。。 ![用于启用测试版功能的选择加入按钮](/assets/images/github-apps/enable-beta-features.png) diff --git a/translations/zh-CN/data/reusables/apps/checks-availability.md b/translations/zh-CN/data/reusables/apps/checks-availability.md index 7360c3112d6a..a95e1c9e59b9 100644 --- a/translations/zh-CN/data/reusables/apps/checks-availability.md +++ b/translations/zh-CN/data/reusables/apps/checks-availability.md @@ -1 +1 @@ -Write permission for the Checks API is only available to GitHub Apps. OAuth Apps and authenticated users can view check runs and check suites, but they are not able to create them. If you aren't building a GitHub App, you might be interested in the [Statuses API](/v3/repos/statuses/). +检查 API 的写入权限仅适用于 GitHub 应用程序。 OAuth 应用程序和经过身份验证的用户可以查看检查运行和检查套件，但无法创建它们。 如果您没有构建 GitHub 应用程序，您可能对[状态 API](/v3/repos/statuses/) 感兴趣。 diff --git a/translations/zh-CN/data/reusables/apps/deletes_ssh_keys.md b/translations/zh-CN/data/reusables/apps/deletes_ssh_keys.md index 6b5e91b011d1..5f1c1cd7231c 100644 --- a/translations/zh-CN/data/reusables/apps/deletes_ssh_keys.md +++ b/translations/zh-CN/data/reusables/apps/deletes_ssh_keys.md @@ -1,5 +1,5 @@ {% warning %} -**Warning**: Revoking all permission from an {% data variables.product.prodname_oauth_app %} deletes any SSH keys the application generated on behalf of the user, including [deploy keys](/v3/guides/managing-deploy-keys/#deploy-keys). +**警告**: 从 {% data variables.product.prodname_oauth_app %} 撤销所有权限将会删除应用程序代表用户生成的 SSH 密钥，包括[部署密钥](/v3/guides/managing-deploy-keys/#deploy-keys)。 {% endwarning %} diff --git a/translations/zh-CN/data/reusables/apps/deprecating_auth_with_query_parameters.md b/translations/zh-CN/data/reusables/apps/deprecating_auth_with_query_parameters.md index c7642634c7eb..ae6581b669a2 100644 --- a/translations/zh-CN/data/reusables/apps/deprecating_auth_with_query_parameters.md +++ b/translations/zh-CN/data/reusables/apps/deprecating_auth_with_query_parameters.md @@ -1,9 +1,9 @@ {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} {% warning %} -**Deprecation Notice:** {% data variables.product.prodname_dotcom %} will discontinue authentication to the API using query parameters. Authenticating to the API should be done with [HTTP basic authentication](/v3/auth/#via-oauth-and-personal-access-tokens).{% if currentVersion == "free-pro-team@latest" %} Using query parameters to authenticate to the API will no longer work on May 5, 2021. {% endif %} For more information, including scheduled brownouts, see the [blog post](https://developer.github.com/changes/2020-02-10-deprecating-auth-through-query-param/). +**弃用通知：** {% data variables.product.prodname_dotcom %} 将停止使用查询参数向 API 验证。 Authenticating to the API should be done with [HTTP basic authentication](/v3/auth/#via-oauth-and-personal-access-tokens).{% if currentVersion == "free-pro-team@latest" %} Using query parameters to authenticate to the API will no longer work on May 5, 2021. {% endif %}有关详细信息，包括预定的限电，请参阅[博客文章](https://developer.github.com/changes/2020-02-10-deprecating-auth-through-query-param/)。 -{% if currentVersion != "free-pro-team@latest" %} Authentication to the API using query parameters while available is no longer supported due to security concerns. Instead we recommend integrators move their access token, `client_id`, or `client_secret` in the header. {% data variables.product.prodname_dotcom %} will announce the removal of authentication by query parameters with advanced notice. {% endif %} +{% if currentVersion != "free-pro-team@latest" %} Authentication to the API using query parameters while available is no longer supported due to security concerns. 相反，我们建议集成商在标头中移动其访问令牌 `client_id` 或 `client_secret`。 {% data variables.product.prodname_dotcom %} 将宣布删除通过查询参数进行身份验证，并且会提前通知。 {% endif %} {% endwarning %} {% endif %} diff --git a/translations/zh-CN/data/reusables/apps/deprecating_password_auth.md b/translations/zh-CN/data/reusables/apps/deprecating_password_auth.md index d10ba259e186..dddce4a71482 100644 --- a/translations/zh-CN/data/reusables/apps/deprecating_password_auth.md +++ b/translations/zh-CN/data/reusables/apps/deprecating_password_auth.md @@ -1,9 +1,9 @@ {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} {% warning %} -**Deprecation Notice:** {% data variables.product.prodname_dotcom %} will discontinue password authentication to the API. You must now authenticate to the {% data variables.product.prodname_dotcom %} API with an API token, such as an OAuth access token, GitHub App installation access token, or personal access token, depending on what you need to do with the token.{% if currentVersion == "free-pro-team@latest" %} Password authentication to the API will be removed on November 13, 2020.{% endif %} For more information,{% if currentVersion == "free-pro-team@latest" %} including scheduled brownouts,{% endif %} see the [blog post](https://developer.github.com/changes/2020-02-14-deprecating-password-auth/). +**弃用通知：** {% data variables.product.prodname_dotcom %} 将停止使用密码向 API 验证。 You must now authenticate to the {% data variables.product.prodname_dotcom %} API with an API token, such as an OAuth access token, GitHub App installation access token, or personal access token, depending on what you need to do with the token.{% if currentVersion == "free-pro-team@latest" %} Password authentication to the API will be removed on November 13, 2020.{% endif %} For more information,{% if currentVersion == "free-pro-team@latest" %} including scheduled brownouts,{% endif %} see the [blog post](https://developer.github.com/changes/2020-02-14-deprecating-password-auth/). -{% if currentVersion != "free-pro-team@latest" %} Authenticating to the API using a password is currently available and not yet deprecated in {% data variables.product.prodname_ghe_server %}. {% data variables.product.prodname_dotcom %} will announce the deprecation and provide advanced notice before removing support for this feature.{% endif %} +{% if currentVersion != "free-pro-team@latest" %} Authenticating to the API using a password is currently available and not yet deprecated in {% data variables.product.prodname_ghe_server %}. {% data variables.product.prodname_dotcom %} 将宣布弃用，并在删除对此功能的支持之前提前通知。{% endif %} {% endwarning %} {% endif %} diff --git a/translations/zh-CN/data/reusables/apps/deprecating_token_oauth_authorizations.md b/translations/zh-CN/data/reusables/apps/deprecating_token_oauth_authorizations.md index 7bd0d4951679..73b13e7f425f 100644 --- a/translations/zh-CN/data/reusables/apps/deprecating_token_oauth_authorizations.md +++ b/translations/zh-CN/data/reusables/apps/deprecating_token_oauth_authorizations.md @@ -1,16 +1,16 @@ {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.20" %} {% warning %} -**Deprecation Notice:** The `token` attribute is deprecated in some OAuth Authorizations API responses: -* List your authorizations -* Get a single authorization -* Get-or-create an authorization for a specific app - `token` is still returned for "create" -* Get-or-create an authorization for a specific app and fingerprint - `token` is still returned for "create" -* Update an existing authorization +**弃用通知：**`token` 属性在某些 OAuth 授权 API 响应中弃用： +* 列出您的授权 +* 获取单一授权 +* 获取或创建特定应用程序的授权 - 对“创建”仍会返回 `token` +* 获取或创建特定应用程序和指纹的授权 - 对“创建”仍会返回 `token` +* 更新现有授权 -To reduce the impact of removing the `token` value, the OAuth Authorizations API now includes a new request attribute (`fingerprint`), three new response attributes (`token_last_eight`, `hashed_token`, and `fingerprint`), and the [Get or create an authorization for a specific app and fingerprint](/rest/reference/oauth-authorizations#get-or-create-an-authorization-for-a-specific-app-and-fingerprint) endpoint. +为减小删除 `token` 值的影响，OAuth 授权 API 现在包含一个新的请求属性 (`fingerprint`)、三个新的响应属性（`token_last_eight`、`hashed_token` 和 `fingerprint`）以及[特定应用程序和指纹的获取或创建授权](/rest/reference/oauth-authorizations#get-or-create-an-authorization-for-a-specific-app-and-fingerprint)端点。 -This functionality became the default for all requests on April 20, 2015. Please see [the blog post](https://developer.github.com/changes/2015-04-20-authorizations-api-response-changes-are-now-in-effect/) for full details. +此功能在 2015 年 4 月 20 日成为所有请求的默认值。 有关完整详情，请参阅[博客文章](https://developer.github.com/changes/2015-04-20-authorizations-api-response-changes-are-now-in-effect/)。 {% endwarning %} {% endif %} diff --git a/translations/zh-CN/data/reusables/apps/expiring_user_authorization_tokens.md b/translations/zh-CN/data/reusables/apps/expiring_user_authorization_tokens.md index 48f37e42e067..7194cff91211 100644 --- a/translations/zh-CN/data/reusables/apps/expiring_user_authorization_tokens.md +++ b/translations/zh-CN/data/reusables/apps/expiring_user_authorization_tokens.md @@ -1,3 +1,3 @@ {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -To keep user-to-server access tokens more secure, you can use access tokens that will expire after 8 hours, and a refresh token that can be exchanged for a new access token. For more information, see "[Refreshing user-to-server access tokens](/apps/building-github-apps/refreshing-user-to-server-access-tokens/)." +为使用户到服务器的访问令牌更安全，您可以使用将在 8 小时后过期的访问令牌，以及可交换新访问令牌的刷新令牌。 For more information, see "[Refreshing user-to-server access tokens](/apps/building-github-apps/refreshing-user-to-server-access-tokens/)." {% endif %} diff --git a/translations/zh-CN/data/reusables/apps/general-apps-restrictions.md b/translations/zh-CN/data/reusables/apps/general-apps-restrictions.md index 20e20ff5ecf4..7f65d7afb2a4 100644 --- a/translations/zh-CN/data/reusables/apps/general-apps-restrictions.md +++ b/translations/zh-CN/data/reusables/apps/general-apps-restrictions.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}If you are using your app with GitHub Actions and want to modify workflow files, you must authenticate on behalf of the user with an OAuth token that includes the `workflow` scope. The user must have admin or write permission to the repository that contains the workflow file. For more information, see "[Understanding scopes for OAuth apps](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)."{% endif %} \ No newline at end of file +{% if currentVersion == "free-pro-team@latest" %}If you are using your app with GitHub Actions and want to modify workflow files, you must authenticate on behalf of the user with an OAuth token that includes the `workflow` scope. 用户必须具有包含工作流程文件的仓库的管理员或写入权限。 更多信息请参阅“[了解 OAuth 应用程序的作用域](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)”。{% endif %} diff --git a/translations/zh-CN/data/reusables/apps/marketplace_revenue_share.md b/translations/zh-CN/data/reusables/apps/marketplace_revenue_share.md index 31b9cd8696e5..5503ead5a267 100644 --- a/translations/zh-CN/data/reusables/apps/marketplace_revenue_share.md +++ b/translations/zh-CN/data/reusables/apps/marketplace_revenue_share.md @@ -1,5 +1,5 @@ {% note %} -**Note:** As part of the [Marketplace Developer Agreement](/articles/github-marketplace-developer-agreement/), {% data variables.product.prodname_dotcom %} receives a 25% revenue share from {% data variables.product.prodname_marketplace %} listings. +**注：** 作为[市场开发者协议](/articles/github-marketplace-developer-agreement/)的一部分，{% data variables.product.prodname_dotcom %} 从 {% data variables.product.prodname_marketplace %} 商品获得 25% 的收入份额。 {% endnote %} diff --git a/translations/zh-CN/data/reusables/apps/maximum-github-apps-allowed.md b/translations/zh-CN/data/reusables/apps/maximum-github-apps-allowed.md index 93e063db4cb6..e1b7a44e3c28 100644 --- a/translations/zh-CN/data/reusables/apps/maximum-github-apps-allowed.md +++ b/translations/zh-CN/data/reusables/apps/maximum-github-apps-allowed.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}A user or organization can own up to 100 GitHub Apps.{% endif %} \ No newline at end of file +{% if currentVersion == "free-pro-team@latest" %}A user or organization can own up to 100 GitHub Apps.{% endif %} diff --git a/translations/zh-CN/data/reusables/apps/maximum-oauth-apps-allowed.md b/translations/zh-CN/data/reusables/apps/maximum-oauth-apps-allowed.md index b46e9b82c9dc..9e65b80fe2a6 100644 --- a/translations/zh-CN/data/reusables/apps/maximum-oauth-apps-allowed.md +++ b/translations/zh-CN/data/reusables/apps/maximum-oauth-apps-allowed.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}A user or organization can own up to 100 OAuth apps.{% endif %} \ No newline at end of file +{% if currentVersion == "free-pro-team@latest" %}A user or organization can own up to 100 OAuth apps.{% endif %} diff --git a/translations/zh-CN/data/reusables/apps/metadata-permissions.md b/translations/zh-CN/data/reusables/apps/metadata-permissions.md index 61bc044a800f..ede07474159b 100644 --- a/translations/zh-CN/data/reusables/apps/metadata-permissions.md +++ b/translations/zh-CN/data/reusables/apps/metadata-permissions.md @@ -1 +1 @@ -If you set the metadata permission to `No access` and select a permission that requires repository access, GitHub will override your selection and set the metadata permission back to `Read-only`. To set the metadata permission to `No access`, you must set all permissions that require repository access to `No access` first. \ No newline at end of file +如果将元数据权限设置为 `No access` 并选择需要访问仓库的权限，GitHub 将覆盖您的选择并将元数据权限设回 `Read-only`。 要将元数据权限设置为 `No access`，必须先将需要访问仓库的所有权限设置为 `No access`。 diff --git a/translations/zh-CN/data/reusables/apps/oauth-apps-restrictions.md b/translations/zh-CN/data/reusables/apps/oauth-apps-restrictions.md index 2ae56010bacc..0d55a87c29ed 100644 --- a/translations/zh-CN/data/reusables/apps/oauth-apps-restrictions.md +++ b/translations/zh-CN/data/reusables/apps/oauth-apps-restrictions.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}If you are using your OAuth App with GitHub Actions and want to modify workflow files, your OAuth token must have the `workflow` scope and the user must have owner or write permission to the repository that contains the workflow file. For more information, see "[Understanding scopes for OAuth apps](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)."{% endif %} \ No newline at end of file +{% if currentVersion == "free-pro-team@latest" %}If you are using your OAuth App with GitHub Actions and want to modify workflow files, your OAuth token must have the `workflow` scope and the user must have owner or write permission to the repository that contains the workflow file. 更多信息请参阅“[了解 OAuth 应用程序的作用域](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)”。{% endif %} diff --git a/translations/zh-CN/data/reusables/apps/sinatra_restart_instructions.md b/translations/zh-CN/data/reusables/apps/sinatra_restart_instructions.md index 837d16d08ff0..fc9c81b9ac1b 100644 --- a/translations/zh-CN/data/reusables/apps/sinatra_restart_instructions.md +++ b/translations/zh-CN/data/reusables/apps/sinatra_restart_instructions.md @@ -1,5 +1,5 @@ {% note %} -**Note:** You'll need to restart the Sinatra server before you can test changes. Enter `Ctrl-C` to stop the server, and then run `ruby template_server.rb` again. If you don't want to do this every time you change your app code, you can look into [reloading](http://sinatrarb.com/faq.html#reloading). +**注：**您必须重新启动 Sinatra 服务器才可测试更改。 输入 `Ctrl-C` 停止服务器，然后再次运行 `ruby template_server.rb`。 如果您不想每次更改应用代码时都执行此操作，您可以查看[重新加载](http://sinatrarb.com/faq.html#reloading)。 {% endnote %} diff --git a/translations/zh-CN/data/reusables/apps/state_description.md b/translations/zh-CN/data/reusables/apps/state_description.md index fd754d2939f2..f1f25a1254a1 100644 --- a/translations/zh-CN/data/reusables/apps/state_description.md +++ b/translations/zh-CN/data/reusables/apps/state_description.md @@ -1 +1 @@ -An unguessable random string. It is used to protect against cross-site request forgery attacks. \ No newline at end of file +不可猜测的随机字符串。 它用于防止跨站请求伪造攻击。 diff --git a/translations/zh-CN/data/reusables/audit_log/audit-log-search.md b/translations/zh-CN/data/reusables/audit_log/audit-log-search.md index 1a3d22833716..76dda00b656f 100644 --- a/translations/zh-CN/data/reusables/audit_log/audit-log-search.md +++ b/translations/zh-CN/data/reusables/audit_log/audit-log-search.md @@ -8,7 +8,6 @@ 请注意，无法使用文本搜索条目。 但是，您可以使用各种过滤器构建搜索查询。 查询日志时使用的许多运算符，如 `-`、`>` 或 `<`，与在 {% data variables.product.product_name %} 上搜索时的格式相同。 更多信息请参阅“[在 {% data variables.product.prodname_dotcom %} 上搜索](/github/searching-for-information-on-github/about-searching-on-github)”。 -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} #### 基于操作搜索 使用`操作`限定符将操作限于特定类型的操作。 例如： @@ -20,7 +19,6 @@ * `operation:remove` 查找在其中删除的现有资源的所有事件。 * `operation:restore` 查找在其中恢复了现有资源的所有事件。 * `operation:transfer` 查找在其中转移了现有资源的所有事件。 -{% endif %} #### 基于仓库搜索 diff --git a/translations/zh-CN/data/reusables/branches/change-default-branch.md b/translations/zh-CN/data/reusables/branches/change-default-branch.md new file mode 100644 index 000000000000..2a44e1845aa7 --- /dev/null +++ b/translations/zh-CN/data/reusables/branches/change-default-branch.md @@ -0,0 +1 @@ +You can change the default branch for an existing repository. For more information, see "[Changing the default branch](/github/administering-a-repository/changing-the-default-branch)." diff --git a/translations/zh-CN/data/reusables/branches/default-branch-automatically-base-branch.md b/translations/zh-CN/data/reusables/branches/default-branch-automatically-base-branch.md index 9350f601c269..b7e77330c423 100644 --- a/translations/zh-CN/data/reusables/branches/default-branch-automatically-base-branch.md +++ b/translations/zh-CN/data/reusables/branches/default-branch-automatically-base-branch.md @@ -1 +1,2 @@ -The default branch is the base branch in your repository, against which all pull requests and code commits are automatically made, unless you specify a different branch. \ No newline at end of file +Unless you specify a different branch, the default branch in a repository is the base branch for new pull requests and code commits. + diff --git a/translations/zh-CN/data/reusables/branches/new-repo-default-branch.md b/translations/zh-CN/data/reusables/branches/new-repo-default-branch.md index 99628077f836..d85e1174ba7f 100644 --- a/translations/zh-CN/data/reusables/branches/new-repo-default-branch.md +++ b/translations/zh-CN/data/reusables/branches/new-repo-default-branch.md @@ -1 +1,2 @@ -When you create a repository on {% data variables.product.prodname_dotcom %} with content, the repository is initialized with a single branch, called the default branch. \ No newline at end of file +When you create a repository with content on {% data variables.product.product_location %}, {% data variables.product.product_name %} creates the repository with a single branch. This first branch in the repository is the default branch. + diff --git a/translations/zh-CN/data/reusables/branches/set-default-branch.md b/translations/zh-CN/data/reusables/branches/set-default-branch.md index a36fcc41b762..f5ff905d85ca 100644 --- a/translations/zh-CN/data/reusables/branches/set-default-branch.md +++ b/translations/zh-CN/data/reusables/branches/set-default-branch.md @@ -1 +1 @@ -If you have admin permissions to a repository, you can change the default branch to another existing branch. For more information, see "[Setting the default branch](/github/administering-a-repository/setting-the-default-branch)." +You can set the name of the default branch for new repositories. For more information, see "[Managing the default branch for your repositories](/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories)," "[Managing the default branch name for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization)," or "[Enforcing a policy on the default branch name](/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account#enforcing-a-policy-on-the-default-branch-name)." diff --git a/translations/zh-CN/data/reusables/code-scanning/analyze-go.md b/translations/zh-CN/data/reusables/code-scanning/analyze-go.md new file mode 100644 index 000000000000..56f04cb3de4a --- /dev/null +++ b/translations/zh-CN/data/reusables/code-scanning/analyze-go.md @@ -0,0 +1 @@ +{% data variables.product.prodname_codeql %} also runs a build for Go projects to set up the project. However, in contrast to the other compiled languages, all Go files in the repository are extracted, not just those that are built. Custom build commands are not supported for Go. \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/code-scanning/autobuild-add-build-steps.md b/translations/zh-CN/data/reusables/code-scanning/autobuild-add-build-steps.md index 61f06aaba9d0..32f182b9ffce 100644 --- a/translations/zh-CN/data/reusables/code-scanning/autobuild-add-build-steps.md +++ b/translations/zh-CN/data/reusables/code-scanning/autobuild-add-build-steps.md @@ -1 +1 @@ -If the C/C++, C#, or Java code in your repository has a non-standard build process or if it's written in more than one compiled language, `autobuild` may fail. You will need to remove the `autobuild` step from the workflow, and manually add build steps. +如果仓库中的 C/C++、C# 或 Java 代码含有非标准的构建过程，`autobuild` 可能会失败。 您需要从工作流程中删除 `autobuild` 步骤，然后手动添加构建步骤。 diff --git a/translations/zh-CN/data/reusables/code-scanning/autobuild-compiled-languages.md b/translations/zh-CN/data/reusables/code-scanning/autobuild-compiled-languages.md index 4d69b1773b60..cbe9e79663b4 100644 --- a/translations/zh-CN/data/reusables/code-scanning/autobuild-compiled-languages.md +++ b/translations/zh-CN/data/reusables/code-scanning/autobuild-compiled-languages.md @@ -1,5 +1 @@ -For compiled languages like C/C++, C#, and Java, the `autobuild` step in the default workflow attempts to build code before the action performs {% data variables.product.prodname_codeql %} analysis. 与其他编译语言不同，{% data variables.product.prodname_codeql %} 在分析 Go 时不会构建代码。 与其他编译语言不同，{% data variables.product.prodname_codeql %} 在分析 Go 时不会构建代码。 - -The `autobuild` process only ever attempts to build _one_ compiled language for a repository. The language automatically selected for analysis is the language with most files. - - +对于受支持的编译语言，您可以使用 {% data variables.product.prodname_codeql_workflow %} 中的 `autobuild` 操作来构建代码。 这样您无需为 C/C++、C# 和 Java 指定显式构建命令。 diff --git a/translations/zh-CN/data/reusables/code-scanning/beta-codeql-runner.md b/translations/zh-CN/data/reusables/code-scanning/beta-codeql-runner.md new file mode 100644 index 000000000000..f83682fcfaca --- /dev/null +++ b/translations/zh-CN/data/reusables/code-scanning/beta-codeql-runner.md @@ -0,0 +1,9 @@ +{% if currentVersion == "free-pro-team@latest" %} + +{% note %} + +**Note:** The {% data variables.product.prodname_codeql_runner %} is currently in beta and subject to change. + +{% endnote %} + +{% endif %} diff --git a/translations/zh-CN/data/reusables/code-scanning/beta.md b/translations/zh-CN/data/reusables/code-scanning/beta.md index ed0a52a3941b..f8ac69d855e4 100644 --- a/translations/zh-CN/data/reusables/code-scanning/beta.md +++ b/translations/zh-CN/data/reusables/code-scanning/beta.md @@ -1,5 +1,9 @@ +{% if currentVersion == "enterprise-server@2.22" %} + {% note %} -**注意：**{% data variables.product.prodname_code_scanning_capc %} 目前处于测试阶段，可能会更改。 {% if currentVersion == "free-pro-team@latest" %}To request access to the beta, [join the waitlist](https://github.com/features/security/advanced-security/signup).{% else %}If your organization has an {% data variables.product.prodname_advanced_security %} license, you can [join the beta program](https://resources.github.com/beta-signup/).{% endif %} +**注意：**{% data variables.product.prodname_code_scanning_capc %} 目前处于测试阶段，可能会更改。 For more information about taking part in the beta, [sign up here](https://resources.github.com/beta-signup/). {% endnote %} + +{% endif %} diff --git a/translations/zh-CN/data/reusables/code-scanning/click-alert-in-list.md b/translations/zh-CN/data/reusables/code-scanning/click-alert-in-list.md index d87589d4da0e..18185ec32f46 100644 --- a/translations/zh-CN/data/reusables/code-scanning/click-alert-in-list.md +++ b/translations/zh-CN/data/reusables/code-scanning/click-alert-in-list.md @@ -1 +1 @@ -1. 在“Code Scanning（代码扫描）”下，单击要查看的警报。 ![来自 {% data variables.product.prodname_code_scanning %} 的警报列表](/assets/images/help/repository/code-scanning-click-alert.png) +1. Under "Code scanning," click the alert you'd like to explore. ![来自 {% data variables.product.prodname_code_scanning %} 的警报列表](/assets/images/help/repository/code-scanning-click-alert.png) diff --git a/translations/zh-CN/data/reusables/code-scanning/close-alert-examples.md b/translations/zh-CN/data/reusables/code-scanning/close-alert-examples.md new file mode 100644 index 000000000000..394120901f5f --- /dev/null +++ b/translations/zh-CN/data/reusables/code-scanning/close-alert-examples.md @@ -0,0 +1 @@ +For example, an error in code that's used only for testing, or when the effort of fixing the error is greater than the potential benefit of improving the code. diff --git a/translations/zh-CN/data/reusables/code-scanning/codeql-query-suites.md b/translations/zh-CN/data/reusables/code-scanning/codeql-query-suites.md index 718ee15518c6..f9b919f834e7 100644 --- a/translations/zh-CN/data/reusables/code-scanning/codeql-query-suites.md +++ b/translations/zh-CN/data/reusables/code-scanning/codeql-query-suites.md @@ -1,8 +1,8 @@ -The following query suites are built into {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} and are available for use. +以下查询套件内置于 {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %}，可供使用。 | 查询套件 | 描述 | |:---------------------- |:--------------------------------------- | | `security-extended` | 严重性和精度低于默认查询的查询 | | `security-and-quality` | 来自 `security-extended` 的查询，加上可维护性和可靠性查询 | -When you specify a query suite, the {% data variables.product.prodname_codeql %} analysis engine will run the queries contained within the suite for you, in addition to the default set of queries. +在指定查询套件时，{% data variables.product.prodname_codeql %} 分析引擎将运行套件中包含的查询，以及默认查询集。 diff --git a/translations/zh-CN/data/reusables/code-scanning/codeql-runner-license.md b/translations/zh-CN/data/reusables/code-scanning/codeql-runner-license.md index 17283fb710b2..da31bb97dcac 100644 --- a/translations/zh-CN/data/reusables/code-scanning/codeql-runner-license.md +++ b/translations/zh-CN/data/reusables/code-scanning/codeql-runner-license.md @@ -1,10 +1,12 @@ {% note %} {% if currentVersion == "free-pro-team@latest" %} -**Note:** The {% data variables.product.prodname_codeql_runner %} uses the {% data variables.product.prodname_codeql %} CLI to analyze code and therefore has the same license conditions. It's free to use on public repositories that are maintained on {% data variables.product.prodname_dotcom_the_website %}, and available to use on private repositories that are owned by customers with an {% data variables.product.prodname_advanced_security %} license. For information, see "[{% data variables.product.product_name %} {% data variables.product.prodname_codeql %} Terms and Conditions](https://securitylab.github.com/tools/codeql/license)" and "[{% data variables.product.prodname_codeql %} CLI](https://help.semmle.com/codeql/codeql-cli.html)." +**Note:** The +{% data variables.product.prodname_codeql_runner %} uses the {% data variables.product.prodname_codeql %} CLI to analyze code and therefore has the same license conditions. 它可自由用于 {% data variables.product.prodname_dotcom_the_website %} 上维护的公共仓库，并且可用于具有 {% data variables.product.prodname_advanced_security %} 许可证的客户所拥有的私有仓库。 有关信息请参阅“[{% data variables.product.product_name %} {% data variables.product.prodname_codeql %} 条款和条件](https://securitylab.github.com/tools/codeql/license)”和“[{% data variables.product.prodname_codeql %} CLI](https://help.semmle.com/codeql/codeql-cli.html)”。 {% else %} -**Note:** The {% data variables.product.prodname_codeql_runner %} is available to customers with an {% data variables.product.prodname_advanced_security %} license. +**Note:** The +{% data variables.product.prodname_codeql_runner %} is available to customers with an {% data variables.product.prodname_advanced_security %} license. {% endif %} -{% endnote %} \ No newline at end of file +{% endnote %} diff --git a/translations/zh-CN/data/reusables/code-scanning/edit-workflow.md b/translations/zh-CN/data/reusables/code-scanning/edit-workflow.md index 3b9725ab33ef..1cf26f905c47 100644 --- a/translations/zh-CN/data/reusables/code-scanning/edit-workflow.md +++ b/translations/zh-CN/data/reusables/code-scanning/edit-workflow.md @@ -1 +1 @@ -一般情况下无需编辑 {% data variables.product.prodname_code_scanning %} 的默认工作流程。 However, if required, you can edit the workflow to customize some of the settings. For example, you can edit {% data variables.product.prodname_dotcom %}'s {% data variables.product.prodname_codeql_workflow %} to specify the frequency of scans, the languages or directories to scan, and what {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} looks for in your code. You might also need to edit the {% data variables.product.prodname_codeql_workflow %} if you use a specific set of commands to compile your code or if there is more than one compiled language in your repository. +一般情况下无需编辑 {% data variables.product.prodname_code_scanning %} 的默认工作流程。 但是，如果需要，您可以编辑工作流程以自定义某些设置。 例如，您可以编辑 {% data variables.product.prodname_dotcom %} 的 {% data variables.product.prodname_codeql_workflow %} 来指定扫描频率、要扫描的语言或目录，以及 {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} 在代码中的查找内容。 如果您使用一组特定的命令来编译代码，您可能还需要编辑 {% data variables.product.prodname_codeql_workflow %}。 diff --git a/translations/zh-CN/data/reusables/code-scanning/enabling-options.md b/translations/zh-CN/data/reusables/code-scanning/enabling-options.md index 6b1c8b1a10b9..92f3fc578d1d 100644 --- a/translations/zh-CN/data/reusables/code-scanning/enabling-options.md +++ b/translations/zh-CN/data/reusables/code-scanning/enabling-options.md @@ -1,11 +1,11 @@ @@ -15,17 +15,17 @@ -
    - Type of analysis + 分析类型 - Options for generating alerts + 用于生成警报的选项
    - Using {% data variables.product.prodname_actions %} (see "Enabling {% data variables.product.prodname_code_scanning %} using actions") or using the {% data variables.product.prodname_codeql_runner %} in a third-party continuous integration (CI) system (see "Running code scanning in your CI system"). + 使用 {% data variables.product.prodname_actions %}（请参阅“使用操作启用 {% data variables.product.prodname_code_scanning %}”）或在第三方持续集成 (CI) 系统中使用 {% data variables.product.prodname_codeql_runner %}（请参阅“在 CI 系统中运行代码扫描”）。
    - Third‑party + 第三方 - Using {% data variables.product.prodname_actions %} (see "Enabling {% data variables.product.prodname_code_scanning %} using actions") or generated externally and uploaded to {% data variables.product.product_name %} (see "Uploading a SARIF file to {% data variables.product.prodname_dotcom %}"). + 使用 {% data variables.product.prodname_actions %}（请参阅“使用操作启用 {% data variables.product.prodname_code_scanning %}”）或者外部生成并上传到 {% data variables.product.product_name %}（请参阅“上传 SARIF 文件到 {% data variables.product.prodname_dotcom %}”）。
    \ No newline at end of file + diff --git a/translations/zh-CN/data/reusables/code-scanning/enterprise-enable-code-scanning-actions.md b/translations/zh-CN/data/reusables/code-scanning/enterprise-enable-code-scanning-actions.md index 5612481d72c8..170941819961 100644 --- a/translations/zh-CN/data/reusables/code-scanning/enterprise-enable-code-scanning-actions.md +++ b/translations/zh-CN/data/reusables/code-scanning/enterprise-enable-code-scanning-actions.md @@ -2,7 +2,7 @@ {% note %} -**Note:** Your site administrator must enable {% data variables.product.prodname_code_scanning %} for {% data variables.product.product_location_enterprise %} before you can use this feature. If you want to use {% data variables.product.prodname_actions %} to scan your code, the site administrator must also enable {% data variables.product.prodname_actions %} and set up the infrastructure required. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %} for your appliance](/enterprise/admin/configuration/configuring-code-scanning-for-your-appliance)." +**注：**站点管理员必须为 {% data variables.product.product_location_enterprise %} 启用 {% data variables.product.prodname_code_scanning %}，然后您才可使用此功能。 如果要使用 {% data variables.product.prodname_actions %} 扫描代码，站点管理员还必须启用 {% data variables.product.prodname_actions %} 并设置所需的基础结构。 更多信息请参阅“[为设备配置 {% data variables.product.prodname_code_scanning %}](/enterprise/admin/configuration/configuring-code-scanning-for-your-appliance)”。 {% endnote %} diff --git a/translations/zh-CN/data/reusables/code-scanning/enterprise-enable-code-scanning.md b/translations/zh-CN/data/reusables/code-scanning/enterprise-enable-code-scanning.md index c23014293889..d9fec7cfcc50 100644 --- a/translations/zh-CN/data/reusables/code-scanning/enterprise-enable-code-scanning.md +++ b/translations/zh-CN/data/reusables/code-scanning/enterprise-enable-code-scanning.md @@ -2,7 +2,7 @@ {% note %} -**Note:** Your site administrator must enable {% data variables.product.prodname_code_scanning %} for {% data variables.product.product_location_enterprise %} before you can use this feature. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %} for your appliance](/enterprise/admin/configuration/configuring-code-scanning-for-your-appliance)." +**注：**站点管理员必须为 {% data variables.product.product_location_enterprise %} 启用 {% data variables.product.prodname_code_scanning %}，然后您才可使用此功能。 更多信息请参阅“[为设备配置 {% data variables.product.prodname_code_scanning %}](/enterprise/admin/configuration/configuring-code-scanning-for-your-appliance)”。 {% endnote %} diff --git a/translations/zh-CN/data/reusables/code-scanning/example-configuration-files.md b/translations/zh-CN/data/reusables/code-scanning/example-configuration-files.md index 500fed99e6ce..2b6831112ff7 100644 --- a/translations/zh-CN/data/reusables/code-scanning/example-configuration-files.md +++ b/translations/zh-CN/data/reusables/code-scanning/example-configuration-files.md @@ -7,7 +7,7 @@ queries: - uses: security-and-quality ``` -The following configuration file disables the default queries and specifies a set of custom queries to run instead. It also configures {% data variables.product.prodname_codeql %} to scan files in the _src_ directory (relative to the root), and to exclude the _node_modules_ directory (also relative to the root), as well as any file whose name ends in _.test.js_. +以下配置文件禁用默认查询，并指定一组要运行的自定义查询。 它还配置 {% data variables.product.prodname_codeql %} 以扫描 _src_ 目录中的文件（相对于根目录），并且排除 _node_modules_ 目录（也相对于根目录）以及名称以 _est.js_ 结尾的任何文件。 ``` yaml name: "My {% data variables.product.prodname_codeql %} config" diff --git a/translations/zh-CN/data/reusables/code-scanning/false-positive-fix-codeql.md b/translations/zh-CN/data/reusables/code-scanning/false-positive-fix-codeql.md new file mode 100644 index 000000000000..db3da9c9d538 --- /dev/null +++ b/translations/zh-CN/data/reusables/code-scanning/false-positive-fix-codeql.md @@ -0,0 +1 @@ +If you close a {% data variables.product.prodname_codeql %} alert as a false positive result, for example because the code uses a sanitization library that isn't supported, consider contributing to the {% data variables.product.prodname_codeql %} repository and improving the analysis. For more information about {% data variables.product.prodname_codeql %}, see "[Contributing to {% data variables.product.prodname_codeql %}](https://github.com/github/codeql/blob/main/CONTRIBUTING.md)." diff --git a/translations/zh-CN/data/reusables/code-scanning/interoperable-with-tools-that-output-sarif.md b/translations/zh-CN/data/reusables/code-scanning/interoperable-with-tools-that-output-sarif.md index 4f83909dd53d..5d8be853cd1b 100644 --- a/translations/zh-CN/data/reusables/code-scanning/interoperable-with-tools-that-output-sarif.md +++ b/translations/zh-CN/data/reusables/code-scanning/interoperable-with-tools-that-output-sarif.md @@ -1 +1 @@ -{% data variables.product.prodname_code_scanning_capc %} 可与输出静态分析结果交换格式 (SARIF) 数据的第三方代码扫描工具互操作。 SARIF 是一个开放的标准。 更多信息请参阅“[{% data variables.product.prodname_code_scanning %} 的 SARIF 输出](/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning)。” \ No newline at end of file +{% data variables.product.prodname_code_scanning_capc %} 可与输出静态分析结果交换格式 (SARIF) 数据的第三方代码扫描工具互操作。 SARIF 是一个开放的标准。 更多信息请参阅“[{% data variables.product.prodname_code_scanning %} 的 SARIF 输出](/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning)。” diff --git a/translations/zh-CN/data/reusables/code-scanning/run-additional-queries.md b/translations/zh-CN/data/reusables/code-scanning/run-additional-queries.md index 3fa310c87fee..6ee78f7c8618 100644 --- a/translations/zh-CN/data/reusables/code-scanning/run-additional-queries.md +++ b/translations/zh-CN/data/reusables/code-scanning/run-additional-queries.md @@ -1,9 +1,9 @@ -When you use {% data variables.product.prodname_codeql %} to scan code, the {% data variables.product.prodname_codeql %} analysis engine generates a database from the code and runs queries on it. 更多信息请参阅“[关于 {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning#about-codeql)”。 +使用 {% data variables.product.prodname_codeql %} 扫描代码时，{% data variables.product.prodname_codeql %} 分析引擎将从代码生成数据库并对其运行查询。 For more information, see "[About {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning#about-codeql)." -{% data variables.product.prodname_codeql %} analysis uses a default set of queries, but you can specify more queries to run, in addition to the default queries. 要运行的查询必须属于 {% data variables.product.prodname_ql %} 包，可以位于您拥有的仓库或任何公共仓库中。 更多信息请参阅“[关于 {% data variables.product.prodname_ql %} 包](https://help.semmle.com/codeql/codeql-cli/reference/qlpack-overview.html)”。 +{% data variables.product.prodname_codeql %} 分析使用默认的查询集，但除了默认查询外，您还可以指定更多的查询来运行。 要运行的查询必须属于 {% data variables.product.prodname_ql %} 包，可以位于您拥有的仓库或任何公共仓库中。 更多信息请参阅“[关于 {% data variables.product.prodname_ql %} 包](https://help.semmle.com/codeql/codeql-cli/reference/qlpack-overview.html)”。 -查询只能依赖于标准库（即查询中的 `import LANGUAGE` 语句引用的库）或与查询相同的 {% data variables.product.prodname_ql %} 包中的库。 标准库位于 [github/codeql](https://github.com/github/codeql) 仓库中。 For more information, see "[About CodeQL queries](https://help.semmle.com/QL/learn-ql/writing-queries/introduction-to-queries.html)." +查询只能依赖于标准库（即查询中的 `import LANGUAGE` 语句引用的库）或与查询相同的 {% data variables.product.prodname_ql %} 包中的库。 标准库位于 [github/codeql](https://github.com/github/codeql) 仓库中。 更多信息请参阅“[关于 CodeQL 查询](https://help.semmle.com/QL/learn-ql/writing-queries/introduction-to-queries.html)。” -您可以指定一个 _.ql_ 文件（一个目录中包含多个 _.ql_ 文件）、一个 _.qls_ 查询套件定义文件或任意组合。 For more information about query suite definitions, see "[Creating {% data variables.product.prodname_codeql %} query suites](https://help.semmle.com/codeql/codeql-cli/procedures/query-suites.html)." +您可以指定一个 _.ql_ 文件（一个目录中包含多个 _.ql_ 文件）、一个 _.qls_ 查询套件定义文件或任意组合。 有关查询套件定义的更多信息，请参阅“[创建 {% data variables.product.prodname_codeql %} 查询套件](https://help.semmle.com/codeql/codeql-cli/procedures/query-suites.html)”。 -{% if currentVersion == "free-pro-team@latest" %}We don't recommend referencing query suites directly from the `github/codeql` repository, like `github/codeql/cpp/ql/src@main`. Such queries may not be compiled with the same version of {% data variables.product.prodname_codeql %} as used for your other queries, which could lead to errors during analysis.{% endif %} +{% if currentVersion == "free-pro-team@latest" %}We don't recommend referencing query suites directly from the `github/codeql` repository, like `github/codeql/cpp/ql/src@main`. 此类查询不可使用与其他查询所用版本相同的 {% data variables.product.prodname_codeql %} 版本编译，否则可能导致分析过程中出错。{% endif %} diff --git a/translations/zh-CN/data/reusables/code-scanning/specify-language-to-analyze.md b/translations/zh-CN/data/reusables/code-scanning/specify-language-to-analyze.md index 7babe87b387f..4eb5c0ff8532 100644 --- a/translations/zh-CN/data/reusables/code-scanning/specify-language-to-analyze.md +++ b/translations/zh-CN/data/reusables/code-scanning/specify-language-to-analyze.md @@ -1 +1 @@ -如果仓库中包含多种语言的代码，您可以指定要分析的语言。 在有些情况下您可能需要阻止分析某种语言。 例如，项目中可能存在与代码主体语言不同的依赖项，并且您可能不希望看到关于这些依赖项的警报。 +如果仓库中包含多种支持的语言的代码，您可以选择要分析的语言。 在有些情况下您可能需要阻止分析某种语言。 例如，项目中可能存在与代码主体语言不同的依赖项，并且您可能不希望看到关于这些依赖项的警报。 diff --git a/translations/zh-CN/data/reusables/codespaces/about-billing-for-codespaces.md b/translations/zh-CN/data/reusables/codespaces/about-billing-for-codespaces.md new file mode 100644 index 000000000000..8a1128db5e3c --- /dev/null +++ b/translations/zh-CN/data/reusables/codespaces/about-billing-for-codespaces.md @@ -0,0 +1 @@ +{% data variables.product.prodname_codespaces %} is free to use during the beta. When {% data variables.product.prodname_codespaces %} becomes generally available, you will be billed for storage and compute usage. diff --git a/translations/zh-CN/data/reusables/codespaces/about-configuration.md b/translations/zh-CN/data/reusables/codespaces/about-configuration.md index 0691798c4638..2ce753615361 100644 --- a/translations/zh-CN/data/reusables/codespaces/about-configuration.md +++ b/translations/zh-CN/data/reusables/codespaces/about-configuration.md @@ -1 +1 @@ -您可以为仓库创建默认代码空间配置，以确定任何人员为该仓库创建的每个新代码空间的环境。 The configuration defines a development container that can include frameworks, tools, extensions, and port forwarding. +您可以为仓库创建默认代码空间配置，以确定任何人员为该仓库创建的每个新代码空间的环境。 配置定义一个可以包含框架、工具、扩展和端口转发的开发容器。 diff --git a/translations/zh-CN/data/reusables/codespaces/click-remote-explorer-icon-vscode.md b/translations/zh-CN/data/reusables/codespaces/click-remote-explorer-icon-vscode.md index c9ee5e8bfeea..157489ba84ac 100644 --- a/translations/zh-CN/data/reusables/codespaces/click-remote-explorer-icon-vscode.md +++ b/translations/zh-CN/data/reusables/codespaces/click-remote-explorer-icon-vscode.md @@ -1 +1 @@ -1. 在 {% data variables.product.prodname_vscode %} 中，从左侧边栏单击 Remote Explorer 图标。 ![{% data variables.product.prodname_vscode %} 中的 Remote Explorer 图标](/assets/images/help/codespaces/click-remote-explorer-icon-vscode.png) \ No newline at end of file +1. 在 {% data variables.product.prodname_vscode %} 中，从左侧边栏单击 Remote Explorer 图标。 ![{% data variables.product.prodname_vscode %} 中的 Remote Explorer 图标](/assets/images/help/codespaces/click-remote-explorer-icon-vscode.png) diff --git a/translations/zh-CN/data/reusables/codespaces/codespaces-are-per-branch.md b/translations/zh-CN/data/reusables/codespaces/codespaces-are-per-branch.md index 7763a8f4cbe5..b25e402c60b1 100644 --- a/translations/zh-CN/data/reusables/codespaces/codespaces-are-per-branch.md +++ b/translations/zh-CN/data/reusables/codespaces/codespaces-are-per-branch.md @@ -1 +1 @@ -每个代码空间与仓库的一个特定分支关联。 \ No newline at end of file +每个代码空间与仓库的一个特定分支关联。 diff --git a/translations/zh-CN/data/reusables/codespaces/codespaces-are-personal.md b/translations/zh-CN/data/reusables/codespaces/codespaces-are-personal.md index f0d56eb513bd..3c061e19f006 100644 --- a/translations/zh-CN/data/reusables/codespaces/codespaces-are-personal.md +++ b/translations/zh-CN/data/reusables/codespaces/codespaces-are-personal.md @@ -1 +1 @@ -您创建的每个代码空间只有您才可以使用。 其他任何人都不能在您的代码空间中工作。 \ No newline at end of file +您创建的每个代码空间只有您才可以使用。 其他任何人都不能在您的代码空间中工作。 diff --git a/translations/zh-CN/data/reusables/codespaces/concurrent-codespace-limit.md b/translations/zh-CN/data/reusables/codespaces/concurrent-codespace-limit.md index 9a6dd934c6c5..2cf2c0ee9283 100644 --- a/translations/zh-CN/data/reusables/codespaces/concurrent-codespace-limit.md +++ b/translations/zh-CN/data/reusables/codespaces/concurrent-codespace-limit.md @@ -1 +1 @@ -每个仓库甚至每个分支可创建多个代码空间。 However, each user account has a two-codespace limit during limited public beta. 如果您已达到上限，想要创建一个新的代码空间，必须先删除一个旧代码空间。 +每个仓库甚至每个分支可创建多个代码空间。 但是，在有限的公测期间，每个用户帐户限于两个代码空间。 如果您已达到上限，想要创建一个新的代码空间，必须先删除一个旧代码空间。 diff --git a/translations/zh-CN/data/reusables/codespaces/connect-to-codespace-from-vscode.md b/translations/zh-CN/data/reusables/codespaces/connect-to-codespace-from-vscode.md index a4e13b26de84..795ded63dde1 100644 --- a/translations/zh-CN/data/reusables/codespaces/connect-to-codespace-from-vscode.md +++ b/translations/zh-CN/data/reusables/codespaces/connect-to-codespace-from-vscode.md @@ -1 +1 @@ -您可以直接从 {% data variables.product.prodname_vscode %} 连接至您的代码空间。 更多信息请参阅“[从 {% data variables.product.prodname_vscode %}](/github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code) 连接至您的代码空间”。 \ No newline at end of file +您可以直接从 {% data variables.product.prodname_vscode %} 连接至您的代码空间。 更多信息请参阅“[在 {% data variables.product.prodname_vscode %} 中使用代码空间](/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code)”。 diff --git a/translations/zh-CN/data/reusables/codespaces/devcontainer-location.md b/translations/zh-CN/data/reusables/codespaces/devcontainer-location.md new file mode 100644 index 000000000000..196fc006be1a --- /dev/null +++ b/translations/zh-CN/data/reusables/codespaces/devcontainer-location.md @@ -0,0 +1 @@ +This file can be located in the root of the repository or in a folder called `.devcontainer`. If the file is located in the root of the repository, the filename must begin with a period: `.devcontainer.json`. diff --git a/translations/zh-CN/data/reusables/codespaces/navigate-to-codespaces.md b/translations/zh-CN/data/reusables/codespaces/navigate-to-codespaces.md index e1600c4bc2d3..a8b97bfd4059 100644 --- a/translations/zh-CN/data/reusables/codespaces/navigate-to-codespaces.md +++ b/translations/zh-CN/data/reusables/codespaces/navigate-to-codespaces.md @@ -1 +1 @@ -1. 在任何页面顶部，单击 **Codespaces（代码空间）**。 ![标头中的 {% data variables.product.prodname_codespaces %} 链接](/assets/images/help/codespaces/header-link.png) \ No newline at end of file +1. 在任何页面顶部，单击 **Codespaces（代码空间）**。 ![标头中的 {% data variables.product.prodname_codespaces %} 链接](/assets/images/help/codespaces/header-link.png) diff --git a/translations/zh-CN/data/reusables/codespaces/release-stage.md b/translations/zh-CN/data/reusables/codespaces/release-stage.md index 0abd40815579..19663149e664 100644 --- a/translations/zh-CN/data/reusables/codespaces/release-stage.md +++ b/translations/zh-CN/data/reusables/codespaces/release-stage.md @@ -2,4 +2,4 @@ **注：**{% data variables.product.prodname_codespaces %} 目前是有限公测版，可能会有变动。 在公测期间，{% data variables.product.prodname_dotcom %} 不对 {% data variables.product.prodname_codespaces %} 的可用性做任何保证。 有关加入公测的更多信息，请参阅“[关于 {% data variables.product.prodname_codespaces %}](/github/developing-online-with-codespaces/about-codespaces#joining-the-beta)”。 -{% endnote %} \ No newline at end of file +{% endnote %} diff --git a/translations/zh-CN/data/reusables/codespaces/unsupported-repos.md b/translations/zh-CN/data/reusables/codespaces/unsupported-repos.md index ab8bdfc3280b..498f1508301b 100644 --- a/translations/zh-CN/data/reusables/codespaces/unsupported-repos.md +++ b/translations/zh-CN/data/reusables/codespaces/unsupported-repos.md @@ -1 +1 @@ -在测试阶段，不支持组织拥有的私有仓库或者组织拥有的需要 SAML 单点登录的任何仓库。 \ No newline at end of file +在测试阶段，不支持组织拥有的私有仓库或者组织拥有的需要 SAML 单点登录的任何仓库。 diff --git a/translations/zh-CN/data/reusables/codespaces/use-visual-studio-features.md b/translations/zh-CN/data/reusables/codespaces/use-visual-studio-features.md index 7a39a939fac7..fb57f1f26fc4 100644 --- a/translations/zh-CN/data/reusables/codespaces/use-visual-studio-features.md +++ b/translations/zh-CN/data/reusables/codespaces/use-visual-studio-features.md @@ -1 +1 @@ -打开代码空间后，您可以使用 {% data variables.product.prodname_vscode %} 的功能（如文本编辑、调试和 Git 命令）进行开发。 更多信息请参阅 [{% data variables.product.prodname_vscode %} 文档](https://code.visualstudio.com/docs)。 +You can edit code, debug, and use Git commands while developing in a codespace with {% data variables.product.prodname_vscode %}. 更多信息请参阅 [{% data variables.product.prodname_vscode %} 文档](https://code.visualstudio.com/docs)。 diff --git a/translations/zh-CN/data/reusables/codespaces/you-can-see-all-your-codespaces.md b/translations/zh-CN/data/reusables/codespaces/you-can-see-all-your-codespaces.md index 11366753f5ea..89ca2ae45c52 100644 --- a/translations/zh-CN/data/reusables/codespaces/you-can-see-all-your-codespaces.md +++ b/translations/zh-CN/data/reusables/codespaces/you-can-see-all-your-codespaces.md @@ -1 +1 @@ -在 [github.com/codespaces](https://github.com/codespaces)上可以查看您的用户帐户拥有的每个代码空间。 \ No newline at end of file +在 [github.com/codespaces](https://github.com/codespaces)上可以查看您的用户帐户拥有的每个代码空间。 diff --git a/translations/zh-CN/data/reusables/command_line/git-clone-url.md b/translations/zh-CN/data/reusables/command_line/git-clone-url.md index b91cea01f913..339055254a50 100644 --- a/translations/zh-CN/data/reusables/command_line/git-clone-url.md +++ b/translations/zh-CN/data/reusables/command_line/git-clone-url.md @@ -1,4 +1,4 @@ 5. 键入 `git clone`，然后粘贴先前复制的 URL。 ```shell $ git clone https://{% data variables.command_line.codeblock %}/YOUR-USERNAME/YOUR-REPOSITORY - ``` \ No newline at end of file + ``` diff --git a/translations/zh-CN/data/reusables/command_line/provide-an-access-token.md b/translations/zh-CN/data/reusables/command_line/provide-an-access-token.md index e269d10989aa..30dc0b8626e4 100644 --- a/translations/zh-CN/data/reusables/command_line/provide-an-access-token.md +++ b/translations/zh-CN/data/reusables/command_line/provide-an-access-token.md @@ -1 +1 @@ -{% if currentVersion == "free-pro-team@latest" %}如果要访问使用 SAML SSO 的组织，您在进行身份验证之前还必须授权个人访问令牌访问组织。 更多信息请参阅“[关于使用 SAML 单点登录进行身份验证](/github/authenticating-to-github/about-authentication-with-saml-single-sign-on)”和“[授权个人访问令牌用于 SAML 单点登录](/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on)”。{% endif %} +{% if currentVersion == "free-pro-team@latest" %}If you are accessing an organization that uses SAML SSO, you must also authorize your personal access token to access the organization before you authenticate. 更多信息请参阅“[关于使用 SAML 单点登录进行身份验证](/github/authenticating-to-github/about-authentication-with-saml-single-sign-on)”和“[授权个人访问令牌用于 SAML 单点登录](/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on)”。{% endif %} diff --git a/translations/zh-CN/data/reusables/commits/about-commits.md b/translations/zh-CN/data/reusables/commits/about-commits.md index 6f96b5b88b5e..d0090a86759e 100644 --- a/translations/zh-CN/data/reusables/commits/about-commits.md +++ b/translations/zh-CN/data/reusables/commits/about-commits.md @@ -1,4 +1,4 @@ -Similar to saving a file that's been edited, a commit records changes to one or more files in your branch. Git assigns each commit a unique ID, called a SHA or hash, that identifies: +类似于保存已经编辑的文件，提交会记录对分支中一个或多个文件的更改。 Git 将为每个提交分配唯一的 ID，称为 SHA 或哈希，用于识别： - 具体的更改 - 进行更改的时间 diff --git a/translations/zh-CN/data/reusables/dependabot/check-in-dependabot-yml.md b/translations/zh-CN/data/reusables/dependabot/check-in-dependabot-yml.md index 1bfa965fb024..95bc4016d510 100644 --- a/translations/zh-CN/data/reusables/dependabot/check-in-dependabot-yml.md +++ b/translations/zh-CN/data/reusables/dependabot/check-in-dependabot-yml.md @@ -1 +1 @@ -1. 将 *dependabot.yml* 配置文件签入仓库的 `.github` 目录。 \ No newline at end of file +1. 将 *dependabot.yml* 配置文件签入仓库的 `.github` 目录。 diff --git a/translations/zh-CN/data/reusables/dependabot/click-dependabot-tab.md b/translations/zh-CN/data/reusables/dependabot/click-dependabot-tab.md index 2708240be3ba..cbc744bac632 100644 --- a/translations/zh-CN/data/reusables/dependabot/click-dependabot-tab.md +++ b/translations/zh-CN/data/reusables/dependabot/click-dependabot-tab.md @@ -1 +1 @@ -4. Under "Dependency graph", click **{% data variables.product.prodname_dependabot_short %}**. ![Dependency graph, {% data variables.product.prodname_dependabot_short %} tab](/assets/images/help/dependabot/dependabot-tab-beta.png) +4. 在“Dependency graph（依赖关系图）”下，单击 **{% data variables.product.prodname_dependabot_short %}**。 ![依赖关系图，{% data variables.product.prodname_dependabot_short %} 选项卡](/assets/images/help/dependabot/dependabot-tab-beta.png) diff --git a/translations/zh-CN/data/reusables/dependabot/create-dependabot-yml.md b/translations/zh-CN/data/reusables/dependabot/create-dependabot-yml.md index 5fe05f0b1308..d8979241f367 100644 --- a/translations/zh-CN/data/reusables/dependabot/create-dependabot-yml.md +++ b/translations/zh-CN/data/reusables/dependabot/create-dependabot-yml.md @@ -1 +1 @@ -1. 创建 *dependabot.yml* 配置文件。 \ No newline at end of file +1. 创建 *dependabot.yml* 配置文件。 diff --git a/translations/zh-CN/data/reusables/dependabot/default-dependencies-allow-ignore.md b/translations/zh-CN/data/reusables/dependabot/default-dependencies-allow-ignore.md index 20252d66b2da..30d2b49e10eb 100644 --- a/translations/zh-CN/data/reusables/dependabot/default-dependencies-allow-ignore.md +++ b/translations/zh-CN/data/reusables/dependabot/default-dependencies-allow-ignore.md @@ -1 +1 @@ -默认情况下，清单或锁定文件中明确定义的所有依赖项都将保持最新。 您可以使用 `allow` 和 `ignore` 自定义版本更新时要保留哪些依赖项。 {% data variables.product.prodname_dependabot %} 可检查所有被允许的依赖项，然后过滤到任何被忽略的依赖项或版本。 因此，同时与 `allow` 和 `ignore` 匹配的依赖项将被忽略。 \ No newline at end of file +默认情况下，清单或锁定文件中明确定义的所有依赖项都将保持最新。 您可以使用 `allow` 和 `ignore` 自定义版本更新时要保留哪些依赖项。 {% data variables.product.prodname_dependabot %} 可检查所有被允许的依赖项，然后过滤到任何被忽略的依赖项或版本。 因此，同时与 `allow` 和 `ignore` 匹配的依赖项将被忽略。 diff --git a/translations/zh-CN/data/reusables/dependabot/default-labels.md b/translations/zh-CN/data/reusables/dependabot/default-labels.md index 4050752ab68e..a51c8b92334b 100644 --- a/translations/zh-CN/data/reusables/dependabot/default-labels.md +++ b/translations/zh-CN/data/reusables/dependabot/default-labels.md @@ -1 +1 @@ -默认情况下，{% data variables.product.prodname_dependabot %} 会提出带 `dependencies` 标签的所有拉取请求。 If more than one package manager is defined, {% data variables.product.prodname_dependabot_short %} includes an additional label on each pull request. 这表明拉取请求将更新哪种语言或生态系统，例如：Gradle 更新的 `java` 和 Git 子模块更新的 `submodules`。 {% data variables.product.prodname_dependabot %} 将根据需要自动在您的仓库中创建这些默认标签。 +默认情况下，{% data variables.product.prodname_dependabot %} 会提出带 `dependencies` 标签的所有拉取请求。 如果定义了多个软件包管理器， {% data variables.product.prodname_dependabot_short %} 在每个拉取请求上包含一个附加标签。 这表明拉取请求将更新哪种语言或生态系统，例如：Gradle 更新的 `java` 和 Git 子模块更新的 `submodules`。 {% data variables.product.prodname_dependabot %} 将根据需要自动在您的仓库中创建这些默认标签。 diff --git a/translations/zh-CN/data/reusables/dependabot/dependabot-tos.md b/translations/zh-CN/data/reusables/dependabot/dependabot-tos.md index d52b0b03405b..aee1d4eb7471 100644 --- a/translations/zh-CN/data/reusables/dependabot/dependabot-tos.md +++ b/translations/zh-CN/data/reusables/dependabot/dependabot-tos.md @@ -1 +1 @@ -{% data variables.product.prodname_dependabot %} and all related features are covered by [{% data variables.product.prodname_dotcom %}'s Terms of Service](/github/site-policy/github-terms-of-service). \ No newline at end of file +{% data variables.product.prodname_dependabot %} 和所有相关功能受 [{% data variables.product.prodname_dotcom %} 服务条款](/github/site-policy/github-terms-of-service)管辖。 diff --git a/translations/zh-CN/data/reusables/dependabot/initial-updates.md b/translations/zh-CN/data/reusables/dependabot/initial-updates.md index 4ddb03880475..b9a6e53a39c5 100644 --- a/translations/zh-CN/data/reusables/dependabot/initial-updates.md +++ b/translations/zh-CN/data/reusables/dependabot/initial-updates.md @@ -1,3 +1,3 @@ -首次启用版本更新时，您可能有很多过时的依赖项，其中一些可能为许多落后于最新版本的版本。 {% data variables.product.prodname_dependabot %} checks for outdated dependencies as soon as it's enabled. 根据您配置更新的清单文件的数量，您可能会在添加配置文件后几分钟内看到新的版本更新拉取请求。 +首次启用版本更新时，您可能有很多过时的依赖项，其中一些可能为许多落后于最新版本的版本。 {% data variables.product.prodname_dependabot %} 将在其启用后立即检查过时的依赖项。 根据您配置更新的清单文件的数量，您可能会在添加配置文件后几分钟内看到新的版本更新拉取请求。 -To keep pull requests manageable and easy to review, {% data variables.product.prodname_dependabot_short %} raises a maximum of five pull requests to start bringing dependencies up to the latest version. 如果您在下次预定更新之前合并第一批拉取请求中的一些请求，则接下来的拉取请求最多可以打开五个（您可以更改此限制）。 +为使拉取请求保持可管理和易于审查，{% data variables.product.prodname_dependabot_short %} 最多将提出五个拉取请求，以便开始将依赖项更新至最新版本。 如果您在下次预定更新之前合并第一批拉取请求中的一些请求，则接下来的拉取请求最多可以打开五个（您可以更改此限制）。 diff --git a/translations/zh-CN/data/reusables/dependabot/option-affects-security-updates.md b/translations/zh-CN/data/reusables/dependabot/option-affects-security-updates.md index 142af6c0d6a8..28df69872234 100644 --- a/translations/zh-CN/data/reusables/dependabot/option-affects-security-updates.md +++ b/translations/zh-CN/data/reusables/dependabot/option-affects-security-updates.md @@ -1 +1 @@ -设置此选项还会影响此包的清单文件安全更新拉取请求，除非您使用 `target-branch` 检查非默认分支上的版本更新。 \ No newline at end of file +设置此选项还会影响此包的清单文件安全更新拉取请求，除非您使用 `target-branch` 检查非默认分支上的版本更新。 diff --git a/translations/zh-CN/data/reusables/dependabot/private-dependencies.md b/translations/zh-CN/data/reusables/dependabot/private-dependencies.md index 1ba08ff8f048..ef36a92c5d0f 100644 --- a/translations/zh-CN/data/reusables/dependabot/private-dependencies.md +++ b/translations/zh-CN/data/reusables/dependabot/private-dependencies.md @@ -1 +1 @@ -Currently, {% data variables.product.prodname_dependabot_version_updates %} doesn't support manifest or lock files that contain any private git dependencies or private git registries. This is because, when running version updates, {% data variables.product.prodname_dependabot_short %} must be able to resolve all dependencies from their source to verify that version updates have been successful. \ No newline at end of file +目前，{% data variables.product.prodname_dependabot_version_updates %} 不支持包含任何私有 git 依赖项或私有 git 注册表的清单或锁定文件。 这是因为，在运行版本更新时，{% data variables.product.prodname_dependabot_short %} 必须能够解决来自其来源的所有依赖项，以验证版本更新是否成功。 diff --git a/translations/zh-CN/data/reusables/dependabot/supported-package-managers.md b/translations/zh-CN/data/reusables/dependabot/supported-package-managers.md index 28aee0594a71..59453a364890 100644 --- a/translations/zh-CN/data/reusables/dependabot/supported-package-managers.md +++ b/translations/zh-CN/data/reusables/dependabot/supported-package-managers.md @@ -1,15 +1,29 @@ -- Bundler: `bundler` -- Cargo: `cargo` -- Composer: `composer` -- Docker: `docker` -- Elm: `elm` -- Git 子模块：`gitsubmodule` -- GitHub 操作：`github-actions` -- Go 模块：`gomod` -- Gradle: `gradle` -- Maven: `maven` -- Mix: `mix` -- npm: `npm` -- NuGet: `nuget` -- pip: `pip` -- Terraform: `terraform` +| 包管理器 | Supports vendoring | +| -------------------------- |:------------------:| +| Bundler: `bundler` | **X** | +| Cargo: `cargo` | | +| Composer: `composer` | | +| Docker: `docker` | | +| Elm: `elm` | | +| Git 子模块：`gitsubmodule` | | +| GitHub 操作：`github-actions` | | +| Go 模块：`gomod` | | +| Gradle: `gradle` | | +| Maven: `maven` | | +| Mix: `mix` | | +| npm: `npm` | | +| NuGet: `nuget` | | +| pip: `pip` | | +| Terraform: `terraform` | | + +{% note %} + +**Note**: {% data variables.product.prodname_dependabot_short %} also supports the following package managers: + +-`yarn` (v1 only) (specify `npm`) + +-`pipenv`, `pip-compile`, and `poetry` (specify `pip`) + +For example, if you use `poetry` to manage your Python dependencies and want {% data variables.product.prodname_dependabot_short %} to monitor your dependency manifest file for new versions, use `package-ecosystem: "pip"` in your *dependabot.yml* file. + +{% endnote %} diff --git a/translations/zh-CN/data/reusables/dependabot/upgrade-dependency-to-minimum-secure-version.md b/translations/zh-CN/data/reusables/dependabot/upgrade-dependency-to-minimum-secure-version.md index e84196c1822a..7006a20b7b48 100644 --- a/translations/zh-CN/data/reusables/dependabot/upgrade-dependency-to-minimum-secure-version.md +++ b/translations/zh-CN/data/reusables/dependabot/upgrade-dependency-to-minimum-secure-version.md @@ -1,7 +1,7 @@ -The pull request will upgrade the dependency to the minimum possible secure version needed to avoid the vulnerability. +拉取请求会将依赖项升级到避免漏洞所需的最低安全版本。 {% note %} -**Note:** It's good practice to have automated tests and acceptance processes in place so that checks are carried out before the pull request is merged. This is particularly important if the suggested version to upgrade to contains additional functionality, or a change that breaks your project's code. For more information about continuous integration, see "[About continuous integration](/actions/building-and-testing-code-with-continuous-integration/about-continuous-integration)." +**注：**自动化测试和验收过程是一项好做法，这样可在合并拉取请求之前进行检查。 如果建议的升级版本包含额外的功能，或者更改会中断您的项目代码，这种做法尤其重要。 有关持续集成的更多信息，请参阅“[关于持续集成](/actions/building-and-testing-code-with-continuous-integration/about-continuous-integration)”。 {% endnote %} diff --git a/translations/zh-CN/data/reusables/dependabot/version-updates-for-actions.md b/translations/zh-CN/data/reusables/dependabot/version-updates-for-actions.md index 3b63e3586d5f..1ad50035a003 100644 --- a/translations/zh-CN/data/reusables/dependabot/version-updates-for-actions.md +++ b/translations/zh-CN/data/reusables/dependabot/version-updates-for-actions.md @@ -1 +1 @@ -You can also enable {% data variables.product.prodname_dependabot_version_updates %} for the actions that you add to your workflow. For more information, see "[Keeping your actions up to date with {% data variables.product.prodname_dependabot %}](/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot)." +您也可以为添加到工作流程的操作启用 {% data variables.product.prodname_dependabot_version_updates %}。 更多信息请参阅“[使用 {% data variables.product.prodname_dependabot %} 保持操作的更新](/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot)”。 diff --git a/translations/zh-CN/data/reusables/desktop/2fa-in-browser.md b/translations/zh-CN/data/reusables/desktop/2fa-in-browser.md index adfc554b5b22..fea05aa9dfa9 100644 --- a/translations/zh-CN/data/reusables/desktop/2fa-in-browser.md +++ b/translations/zh-CN/data/reusables/desktop/2fa-in-browser.md @@ -1,5 +1,5 @@ -1. If you have configured two-factor authentication (2FA) for {% data variables.product.prodname_dotcom %}, do one of the following: +1. 如果已为 {% data variables.product.prodname_dotcom %} 配置双重身份验证 (2FA)，请执行以下操作之一： - 如果通过 SMS 设置 2FA，则从 SMS 消息检索 2FA 代码 。 - 如果使用 TOTP 应用程序设置 2FA，则生成 2FA 代码。 - Then enter your 2FA code in the prompt on {% data variables.product.prodname_dotcom %} and click **Verify**. ![2FA 验证码字段](/assets/images/help/desktop/2fa-code-field.png) + 然后在 {% data variables.product.prodname_dotcom %} 上出现提示时输入 2FA 码，再单击 **Verify（验证）**。 ![2FA 验证码字段](/assets/images/help/desktop/2fa-code-field.png) diff --git a/translations/zh-CN/data/reusables/desktop/authenticate-in-browser.md b/translations/zh-CN/data/reusables/desktop/authenticate-in-browser.md index 978a424adc08..dc7256d9c748 100644 --- a/translations/zh-CN/data/reusables/desktop/authenticate-in-browser.md +++ b/translations/zh-CN/data/reusables/desktop/authenticate-in-browser.md @@ -1,3 +1,3 @@ 1. 要验证 {% data variables.product.prodname_dotcom %}，请输入您的 {% data variables.product.prodname_dotcom %}.com 凭据，然后单击 **Sign in（登录）**。 ![浏览器中 {% data variables.product.prodname_dotcom %} 的登录按钮](/assets/images/help/desktop/sign-in-button-browser.png) - Alternatively, if you were already signed in to {% data variables.product.prodname_dotcom %}, follow the prompts to return to {% data variables.product.prodname_desktop %} to finish authenticating. + 或者，如果您已登录 {% data variables.product.prodname_dotcom %}，请按照提示返回 {% data variables.product.prodname_desktop %} 完成身份验证。 diff --git a/translations/zh-CN/data/reusables/desktop/choose-a-theme.md b/translations/zh-CN/data/reusables/desktop/choose-a-theme.md index 110726317e35..b69c9c0691a1 100644 --- a/translations/zh-CN/data/reusables/desktop/choose-a-theme.md +++ b/translations/zh-CN/data/reusables/desktop/choose-a-theme.md @@ -1,2 +1,2 @@ 3. 单击 **Appearance（外观）**。 -4. 单击想要使用的主题。 （可选）如果您希望 {% data variables.product.prodname_desktop %} 始终匹配计算机上的主题，您可以选择**自动切换主题以匹配系统**。 \ No newline at end of file +4. 单击想要使用的主题。 （可选）如果您希望 {% data variables.product.prodname_desktop %} 始终匹配计算机上的主题，您可以选择**自动切换主题以匹配系统**。 diff --git a/translations/zh-CN/data/reusables/desktop/choose-product-authenticate.md b/translations/zh-CN/data/reusables/desktop/choose-product-authenticate.md index 9b5969df1c79..0cef0661eee0 100644 --- a/translations/zh-CN/data/reusables/desktop/choose-product-authenticate.md +++ b/translations/zh-CN/data/reusables/desktop/choose-product-authenticate.md @@ -1 +1 @@ -1. To the right of "{% data variables.product.prodname_enterprise %} Server," click **Sign In**. ![The Sign in button for GitHub Enterprise Server](/assets/images/help/desktop/sign-in-ghes.png) +1. 在“{% data variables.product.prodname_enterprise %} Server”右边单击 **Sign In（登录）**。 ![GitHub Enterprise Server 的 Sign in（登录）按钮](/assets/images/help/desktop/sign-in-ghes.png) diff --git a/translations/zh-CN/data/reusables/desktop/click-base-branch-in-drop-down.md b/translations/zh-CN/data/reusables/desktop/click-base-branch-in-drop-down.md index a5baa888d6f9..cb99d36ffd95 100644 --- a/translations/zh-CN/data/reusables/desktop/click-base-branch-in-drop-down.md +++ b/translations/zh-CN/data/reusables/desktop/click-base-branch-in-drop-down.md @@ -1 +1 @@ -1. At the top of the app, click {% octicon "git-branch" aria-label="The branch icon" %} **Current Branch** and then in the list of branches, click the branch that you want to base your new branch on. +1. 在应用程序顶部，单击 {% octicon "git-branch" aria-label="The branch icon" %} **Current Branch（当前分支）**，然后在分支列表中单击要将新分支作为基础的分支。 diff --git a/translations/zh-CN/data/reusables/desktop/confirm-tag.md b/translations/zh-CN/data/reusables/desktop/confirm-tag.md index 3520da7430b6..b925f75116f5 100644 --- a/translations/zh-CN/data/reusables/desktop/confirm-tag.md +++ b/translations/zh-CN/data/reusables/desktop/confirm-tag.md @@ -1 +1 @@ -1. 单击 **Create Tag（创建标记）**。 \ No newline at end of file +1. 单击 **Create Tag（创建标记）**。 diff --git a/translations/zh-CN/data/reusables/desktop/create-tag.md b/translations/zh-CN/data/reusables/desktop/create-tag.md index f90350559940..4c9abeb5e0c1 100644 --- a/translations/zh-CN/data/reusables/desktop/create-tag.md +++ b/translations/zh-CN/data/reusables/desktop/create-tag.md @@ -1 +1 @@ -1. 右键单击提交，然后单击 **Create Tag...（创建标记...）**。 ![选择创建标记菜单项](/assets/images/help/desktop/select-create-tag.png) \ No newline at end of file +1. 右键单击提交，然后单击 **Create Tag...（创建标记...）**。 ![选择创建标记菜单项](/assets/images/help/desktop/select-create-tag.png) diff --git a/translations/zh-CN/data/reusables/desktop/current-branch-menu.md b/translations/zh-CN/data/reusables/desktop/current-branch-menu.md index c32ef485e95b..adfda1422db7 100644 --- a/translations/zh-CN/data/reusables/desktop/current-branch-menu.md +++ b/translations/zh-CN/data/reusables/desktop/current-branch-menu.md @@ -1 +1 @@ -1. In {% data variables.product.prodname_desktop %}, click {% octicon "git-branch" aria-label="The branch icon" %} **Current Branch**. ![当前分支下拉菜单](/assets/images/help/desktop/current-branch-menu.png) +1. 在 {% data variables.product.prodname_desktop %} 中，单击 {% octicon "git-branch" aria-label="The branch icon" %} **Current Branch（当前分支）**。 ![当前分支下拉菜单](/assets/images/help/desktop/current-branch-menu.png) diff --git a/translations/zh-CN/data/reusables/desktop/delete-branch-mac.md b/translations/zh-CN/data/reusables/desktop/delete-branch-mac.md index 38a7891d3801..1d86793a5fee 100644 --- a/translations/zh-CN/data/reusables/desktop/delete-branch-mac.md +++ b/translations/zh-CN/data/reusables/desktop/delete-branch-mac.md @@ -1 +1 @@ -1. In your menu bar, click **Branch**, then click **Delete...**. You can also press shift⌘ commandD. +1. 在菜单栏中，单击 **Branch（分支）**，然后单击 **Delete...（删除...）**。 您也可以按 shift⌘ commandD。 diff --git a/translations/zh-CN/data/reusables/desktop/delete-branch-win.md b/translations/zh-CN/data/reusables/desktop/delete-branch-win.md index 90b7d377193d..4854c2e60a28 100644 --- a/translations/zh-CN/data/reusables/desktop/delete-branch-win.md +++ b/translations/zh-CN/data/reusables/desktop/delete-branch-win.md @@ -1 +1 @@ -1. In your menu bar, click **Branch**, then click **Delete...**. You can also press CtrlShiftD. +1. 在菜单栏中，单击 **Branch（分支）**，然后单击 **Delete...（删除...）**。 您也可以按 CtrlShiftD。 diff --git a/translations/zh-CN/data/reusables/desktop/download-desktop-page.md b/translations/zh-CN/data/reusables/desktop/download-desktop-page.md index 56c6160cdc7e..6665cd7d751b 100644 --- a/translations/zh-CN/data/reusables/desktop/download-desktop-page.md +++ b/translations/zh-CN/data/reusables/desktop/download-desktop-page.md @@ -1 +1 @@ -1. Visit the [download page for {% data variables.product.prodname_desktop %}](https://desktop.github.com/). +1. 访问 [{% data variables.product.prodname_desktop %} 的下载页面](https://desktop.github.com/)。 diff --git a/translations/zh-CN/data/reusables/desktop/launch-desktop-from-command-line.md b/translations/zh-CN/data/reusables/desktop/launch-desktop-from-command-line.md index ab48fc156d17..eeedad88a152 100644 --- a/translations/zh-CN/data/reusables/desktop/launch-desktop-from-command-line.md +++ b/translations/zh-CN/data/reusables/desktop/launch-desktop-from-command-line.md @@ -1 +1 @@ -要对最近打开的仓库启动 {% data variables.product.prodname_desktop %}，请键入 `github`。 To launch {% data variables.product.prodname_desktop %} for a particular repository, type `github` followed by the path to the repository. +要对最近打开的仓库启动 {% data variables.product.prodname_desktop %}，请键入 `github`。 要对特定仓库启动 {% data variables.product.prodname_desktop %}，请使用 `github` 命令，然后输入仓库路径。 diff --git a/translations/zh-CN/data/reusables/desktop/mac-select-desktop-menu.md b/translations/zh-CN/data/reusables/desktop/mac-select-desktop-menu.md index 2b1c75d1a9e6..7cd30184284a 100644 --- a/translations/zh-CN/data/reusables/desktop/mac-select-desktop-menu.md +++ b/translations/zh-CN/data/reusables/desktop/mac-select-desktop-menu.md @@ -1 +1 @@ -1. In the menu bar, use the **{% data variables.product.prodname_desktop %}** drop-down menu, then click **Preferences**. ![{% data variables.product.prodname_desktop %} 下拉菜单中的首选项值](/assets/images/help/desktop/mac-choose-preferences.png) +1. 在菜单栏中，使用 **{% data variables.product.prodname_desktop %}** 下拉菜单，然后单击 **Preferences（首选项）**。 ![{% data variables.product.prodname_desktop %} 下拉菜单中的首选项值](/assets/images/help/desktop/mac-choose-preferences.png) diff --git a/translations/zh-CN/data/reusables/desktop/protected-branches.md b/translations/zh-CN/data/reusables/desktop/protected-branches.md index 6931fd805809..f16df573819f 100644 --- a/translations/zh-CN/data/reusables/desktop/protected-branches.md +++ b/translations/zh-CN/data/reusables/desktop/protected-branches.md @@ -1 +1 @@ -仓库管理员可对分支启用保护。 如果您处理的是受保护分支，将无法删除或强制推送到该分支。 Repository administrators can enable other protected branch settings to enforce specific workflows before a branch can be merged. 更多信息请参阅“[关于受保护分支](/articles/about-protected-branches)”。 +仓库管理员可对分支启用保护。 如果您处理的是受保护分支，将无法删除或强制推送到该分支。 在分支可以合并之前，仓库管理员可以另外启用其他受保护分支设置来实施特定的工作流程。 更多信息请参阅“[关于受保护分支](/articles/about-protected-branches)”。 diff --git a/translations/zh-CN/data/reusables/desktop/push-origin.md b/translations/zh-CN/data/reusables/desktop/push-origin.md index af97dffe03c9..70cd2c9e5696 100644 --- a/translations/zh-CN/data/reusables/desktop/push-origin.md +++ b/translations/zh-CN/data/reusables/desktop/push-origin.md @@ -1 +1 @@ -1. Click **Push origin** to push your local changes to the remote repository. ![推送按钮](/assets/images/help/desktop/push-origin-button.png) +1. 单击 **Push origin（推送来源）**将您的本地更改推送到远程仓库。 ![推送按钮](/assets/images/help/desktop/push-origin-button.png) diff --git a/translations/zh-CN/data/reusables/desktop/resolve-merge-conflicts.md b/translations/zh-CN/data/reusables/desktop/resolve-merge-conflicts.md index 3ec6174b8442..e9629abe0f1c 100644 --- a/translations/zh-CN/data/reusables/desktop/resolve-merge-conflicts.md +++ b/translations/zh-CN/data/reusables/desktop/resolve-merge-conflicts.md @@ -1 +1 @@ -1. 使用文本编辑器、命令行或其他工具（根据您的偏好）解决任何合并冲突。 For more information, see "[Addressing merge conflicts](/github/collaborating-with-issues-and-pull-requests/addressing-merge-conflicts)." +1. 使用文本编辑器、命令行或其他工具（根据您的偏好）解决任何合并冲突。 更多信息请参阅“[解决合并冲突](/github/collaborating-with-issues-and-pull-requests/addressing-merge-conflicts)”。 diff --git a/translations/zh-CN/data/reusables/desktop/retrieve-2fa.md b/translations/zh-CN/data/reusables/desktop/retrieve-2fa.md index 21661af9e505..d7131fc14205 100644 --- a/translations/zh-CN/data/reusables/desktop/retrieve-2fa.md +++ b/translations/zh-CN/data/reusables/desktop/retrieve-2fa.md @@ -2,4 +2,4 @@ - 如果通过 SMS 设置 2FA，则从 SMS 消息检索 2FA 代码 。 - 如果使用 TOTP 应用程序设置 2FA，则生成 2FA 代码。 - Then enter your 2FA code in the prompt on {% data variables.product.prodname_desktop %} and click **Sign In**. ![2FA 验证码字段](/assets/images/help/desktop/mac-2fa-code-prompt.png) + 然后在 {% data variables.product.prodname_desktop %} 上出现提示时输入 2FA 码，再单击 **Sign In（登录）**。 ![2FA 验证码字段](/assets/images/help/desktop/mac-2fa-code-prompt.png) diff --git a/translations/zh-CN/data/reusables/desktop/revert-commit.md b/translations/zh-CN/data/reusables/desktop/revert-commit.md index aa280a08ed01..6553914c6542 100644 --- a/translations/zh-CN/data/reusables/desktop/revert-commit.md +++ b/translations/zh-CN/data/reusables/desktop/revert-commit.md @@ -1 +1 @@ -1. 右键单击要还原的提交，然后单击 **Revert This Commit（还原此提交）**。 \ No newline at end of file +1. 右键单击要还原的提交，然后单击 **Revert This Commit（还原此提交）**。 diff --git a/translations/zh-CN/data/reusables/desktop/select-base-branch.md b/translations/zh-CN/data/reusables/desktop/select-base-branch.md index 3a30f32a8688..de87a5d1d567 100644 --- a/translations/zh-CN/data/reusables/desktop/select-base-branch.md +++ b/translations/zh-CN/data/reusables/desktop/select-base-branch.md @@ -1 +1 @@ -1. 选择要作为新分支基础的当前分支或默认分支（通常为 master）。 +1. Use the drop-down to choose a base branch for your new branch. diff --git a/translations/zh-CN/data/reusables/desktop/select-branch-to-delete.md b/translations/zh-CN/data/reusables/desktop/select-branch-to-delete.md index c7e39e90d80b..41cdef7583cd 100644 --- a/translations/zh-CN/data/reusables/desktop/select-branch-to-delete.md +++ b/translations/zh-CN/data/reusables/desktop/select-branch-to-delete.md @@ -1 +1 @@ -1. At the top of the app, click {% octicon "git-branch" aria-label="The branch icon" %} **Current Branch**, then click the branch that you want to delete. +1. 在应用程序顶部，单击 {% octicon "git-branch" aria-label="The branch icon" %} **Current Branch（当前分支）**，然后单击要删除的分支。 diff --git a/translations/zh-CN/data/reusables/desktop/update-email-address.md b/translations/zh-CN/data/reusables/desktop/update-email-address.md index 0c148fc4d92a..63fd01352522 100644 --- a/translations/zh-CN/data/reusables/desktop/update-email-address.md +++ b/translations/zh-CN/data/reusables/desktop/update-email-address.md @@ -1 +1 @@ -If the commits you make in {% data variables.product.prodname_desktop %} are associated with the wrong account on {% data variables.product.product_name %}, update the email address in your Git configuration using {% data variables.product.prodname_desktop %}. +如果您在 {% data variables.product.prodname_desktop %} 中所做的提交与 {% data variables.product.product_name %} 上的错误帐户相关联，请使用 {% data variables.product.prodname_desktop %} 在 Git 配置中更新电子邮件地址。 diff --git a/translations/zh-CN/data/reusables/desktop/windows-choose-options.md b/translations/zh-CN/data/reusables/desktop/windows-choose-options.md index 6e50eae07459..7cf8cef38af3 100644 --- a/translations/zh-CN/data/reusables/desktop/windows-choose-options.md +++ b/translations/zh-CN/data/reusables/desktop/windows-choose-options.md @@ -1 +1 @@ -1. Use the **File** menu, then click **Options**. ![Settings（设置）下拉菜单中的 Options（选项）值](/assets/images/help/desktop/windows-choose-options.png) +1. 使用 **File（文件）**菜单，然后单击 **Options（选项）**。 ![Settings（设置）下拉菜单中的 Options（选项）值](/assets/images/help/desktop/windows-choose-options.png) diff --git a/translations/zh-CN/data/reusables/dotcom_billing/add-seats.md b/translations/zh-CN/data/reusables/dotcom_billing/add-seats.md index 0ae861e62a4a..01741fe4bf82 100644 --- a/translations/zh-CN/data/reusables/dotcom_billing/add-seats.md +++ b/translations/zh-CN/data/reusables/dotcom_billing/add-seats.md @@ -1 +1 @@ -1. 使用 **Edit（编辑）**下拉菜单并单击 **Add seats（添加席位）**。 ![编辑下拉菜单](/assets/images/help/billing/add-seats-dropdown.png) \ No newline at end of file +1. 使用 **Edit（编辑）**下拉菜单并单击 **Add seats（添加席位）**。 ![编辑下拉菜单](/assets/images/help/billing/add-seats-dropdown.png) diff --git a/translations/zh-CN/data/reusables/dotcom_billing/confirm-add-seats.md b/translations/zh-CN/data/reusables/dotcom_billing/confirm-add-seats.md index c19908aa85c6..e256a3c40ee7 100644 --- a/translations/zh-CN/data/reusables/dotcom_billing/confirm-add-seats.md +++ b/translations/zh-CN/data/reusables/dotcom_billing/confirm-add-seats.md @@ -1 +1 @@ -1. 单击 **Add seats（添加席位）**。 ![Add seats button](/assets/images/help/billing/add-seats-button.png) \ No newline at end of file +1. 单击 **Add seats（添加席位）**。 ![添加席位按钮](/assets/images/help/billing/add-seats-button.png) diff --git a/translations/zh-CN/data/reusables/dotcom_billing/number-of-seats.md b/translations/zh-CN/data/reusables/dotcom_billing/number-of-seats.md index b003ad3ed1e6..c9092476c023 100644 --- a/translations/zh-CN/data/reusables/dotcom_billing/number-of-seats.md +++ b/translations/zh-CN/data/reusables/dotcom_billing/number-of-seats.md @@ -1 +1 @@ -1. 在“Add seats”（添加席位）下，输入要添加的席位数。 ![Add seats input](/assets/images/help/billing/add-seats-amount.png) \ No newline at end of file +1. 在“Add seats”（添加席位）下，输入要添加的席位数。 ![添加席位输入框](/assets/images/help/billing/add-seats-amount.png) diff --git a/translations/zh-CN/data/reusables/dotcom_billing/upgrade_org.md b/translations/zh-CN/data/reusables/dotcom_billing/upgrade_org.md index f4f59b79b008..2d5e2486dcb2 100644 --- a/translations/zh-CN/data/reusables/dotcom_billing/upgrade_org.md +++ b/translations/zh-CN/data/reusables/dotcom_billing/upgrade_org.md @@ -1 +1 @@ -1. 如果您要从 {% data variables.product.prodname_free_team %} 升级，请单击 **Upgrade options（升级选项）**。 如果您要从 {% data variables.product.prodname_team %} 升级，请使用 **Edit（编辑）**下拉菜单，然后单击 **Upgrade（升级）**。 ![升级选项按钮](/assets/images/help/billing/choose-monthly-or-yearly-billing.png) \ No newline at end of file +1. 如果您要从 {% data variables.product.prodname_free_team %} 升级，请单击 **Upgrade options（升级选项）**。 如果您要从 {% data variables.product.prodname_team %} 升级，请使用 **Edit（编辑）**下拉菜单，然后单击 **Upgrade（升级）**。 ![升级选项按钮](/assets/images/help/billing/choose-monthly-or-yearly-billing.png) diff --git a/translations/zh-CN/data/reusables/enterprise-accounts/access-enterprise.md b/translations/zh-CN/data/reusables/enterprise-accounts/access-enterprise.md index f650668eb24b..2a7bee222c99 100644 --- a/translations/zh-CN/data/reusables/enterprise-accounts/access-enterprise.md +++ b/translations/zh-CN/data/reusables/enterprise-accounts/access-enterprise.md @@ -1 +1,3 @@ -1. 通过访问 `https://github.com/enterprises/ENTERPRISE-NAME`（将 `ENTERPRISE-NAME` 替换为您的企业帐户名称）导航至您的企业帐户。 +1. In the top-right corner of {% data variables.product.product_name %}, click your profile photo, then click **Your enterprises**. !["Your enterprises" in drop-down menu for profile photo on GitHub](/assets/images/help/enterprises/your-enterprises.png) + +1. In the list of enterprises, click the enterprise you want to view. ![Name of an enterprise in list of your enterprises](/assets/images/help/enterprises/your-enterprises-list.png) diff --git a/translations/zh-CN/data/reusables/enterprise-accounts/actions-tab.md b/translations/zh-CN/data/reusables/enterprise-accounts/actions-tab.md index 5a2db1674515..f735e7e91f8f 100644 --- a/translations/zh-CN/data/reusables/enterprise-accounts/actions-tab.md +++ b/translations/zh-CN/data/reusables/enterprise-accounts/actions-tab.md @@ -1 +1 @@ -1. Under "{% octicon "law" aria-label="The law icon" %} Policies", click **Actions**. +1. 在“{% octicon "law" aria-label="The law icon" %} Policies（政策）”下，单击 **Actions（操作）**。 diff --git a/translations/zh-CN/data/reusables/enterprise-accounts/user-provisioning-release-stage.md b/translations/zh-CN/data/reusables/enterprise-accounts/user-provisioning-release-stage.md index f57ed274394c..bb7cef7cd7e2 100644 --- a/translations/zh-CN/data/reusables/enterprise-accounts/user-provisioning-release-stage.md +++ b/translations/zh-CN/data/reusables/enterprise-accounts/user-provisioning-release-stage.md @@ -1,5 +1,5 @@ {% note %} -**Note:** User provisioning for enterprise accounts is currently in private beta and subject to change. To request access to the beta, [contact our account management team](https://enterprise.github.com/contact). +**注：**企业帐户的用户预配目前处于私测阶段，可能会发生变化。 要申请使用测试版，[请联系我们的客户管理团队](https://enterprise.github.com/contact)。 {% endnote %} diff --git a/translations/zh-CN/data/reusables/enterprise/rate_limit.md b/translations/zh-CN/data/reusables/enterprise/rate_limit.md index dd52413e463c..3467807ceab8 100644 --- a/translations/zh-CN/data/reusables/enterprise/rate_limit.md +++ b/translations/zh-CN/data/reusables/enterprise/rate_limit.md @@ -1,3 +1,4 @@ {% if currentVersion != "free-pro-team@latest" %} -Note that the limits mentioned above are the default rate limits for a {% data variables.product.prodname_ghe_server %} instance. Contact your site administrator to confirm if rate limits are enabled and how they are configured. +Note that the limits mentioned above are the default rate limits for a +{% data variables.product.prodname_ghe_server %} 实例的主机名。 请与站点管理员联系，确认是否启用了速率限制以及如何配置它们。 {% endif %} diff --git a/translations/zh-CN/data/reusables/enterprise/use-a-multiplexer.md b/translations/zh-CN/data/reusables/enterprise/use-a-multiplexer.md index fd66b6bb25a5..2d6a3ccf55da 100644 --- a/translations/zh-CN/data/reusables/enterprise/use-a-multiplexer.md +++ b/translations/zh-CN/data/reusables/enterprise/use-a-multiplexer.md @@ -1 +1 @@ -This command can take some time to finish, so we recommend running the command in a terminal multiplexer like `screen` or `tmux`. +此命令可能需要一些时间才能完成，因此我们建议在终端多路复用器（例如 `screen` 或 `tmux`）中运行该命令。 diff --git a/translations/zh-CN/data/reusables/enterprise_clustering/apply-configuration.md b/translations/zh-CN/data/reusables/enterprise_clustering/apply-configuration.md index 9bded333a478..fa15d2ac18d6 100644 --- a/translations/zh-CN/data/reusables/enterprise_clustering/apply-configuration.md +++ b/translations/zh-CN/data/reusables/enterprise_clustering/apply-configuration.md @@ -1,3 +1,3 @@ -1. Apply the new configuration. {% data reusables.enterprise.use-a-multiplexer %} +1. 应用新配置。 {% data reusables.enterprise.use-a-multiplexer %} ghe-cluster-config-apply diff --git a/translations/zh-CN/data/reusables/enterprise_clustering/configuration-file-heading.md b/translations/zh-CN/data/reusables/enterprise_clustering/configuration-file-heading.md index 06b1491d9115..92153e8dd165 100644 --- a/translations/zh-CN/data/reusables/enterprise_clustering/configuration-file-heading.md +++ b/translations/zh-CN/data/reusables/enterprise_clustering/configuration-file-heading.md @@ -1 +1 @@ -The cluster configuration file lists each node under a [cluster "HOSTNAME"] heading. \ No newline at end of file +集群配置文件在 [cluster "HOSTNAME"] 标题下列出每个节点。 diff --git a/translations/zh-CN/data/reusables/enterprise_clustering/configuration-finished.md b/translations/zh-CN/data/reusables/enterprise_clustering/configuration-finished.md index d20c300d4f8e..7b6b77084a45 100644 --- a/translations/zh-CN/data/reusables/enterprise_clustering/configuration-finished.md +++ b/translations/zh-CN/data/reusables/enterprise_clustering/configuration-finished.md @@ -1,5 +1,5 @@ -1. After the configuration run finishes, {% data variables.product.prodname_ghe_server %} displays the following message. +1. 配置运行完成后，{% data variables.product.prodname_ghe_server %} 将显示以下消息。 ```shell - Finished cluster configuration + 已完成集群配置 ``` diff --git a/translations/zh-CN/data/reusables/enterprise_clustering/key-value-pair-order-irrelevant.md b/translations/zh-CN/data/reusables/enterprise_clustering/key-value-pair-order-irrelevant.md index fb58841728ed..3d6ea97c78e4 100644 --- a/translations/zh-CN/data/reusables/enterprise_clustering/key-value-pair-order-irrelevant.md +++ b/translations/zh-CN/data/reusables/enterprise_clustering/key-value-pair-order-irrelevant.md @@ -1 +1 @@ -The order of the key-value pairs doesn't matter. +键值对的顺序无关紧要。 diff --git a/translations/zh-CN/data/reusables/enterprise_clustering/open-configuration-file.md b/translations/zh-CN/data/reusables/enterprise_clustering/open-configuration-file.md index 03cd337e49cc..85e90f6fa4a7 100644 --- a/translations/zh-CN/data/reusables/enterprise_clustering/open-configuration-file.md +++ b/translations/zh-CN/data/reusables/enterprise_clustering/open-configuration-file.md @@ -1,3 +1,3 @@ -1. Open the cluster configuration file at _/data/user/common/cluster.conf_ in a text editor. For example, you can use Vim. +1. 在文本编辑器中打开 _/data/user/common/cluster.conf_ 上的配置文件。 例如，您可以使用 Vim。 sudo vim /data/user/common/cluster.conf diff --git a/translations/zh-CN/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md b/translations/zh-CN/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md index b0af058d7236..906c2b24edfe 100644 --- a/translations/zh-CN/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md +++ b/translations/zh-CN/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md @@ -1,6 +1,6 @@ -1. 如果要替换 MySQL 主节点或 Redis 主节点，请在 `cluster.conf` 中使用替换节点名称修改 `mysql-master` 或 `redis-master` 值。 +1. If you're replacing the primary MySQL or Redis node, in `cluster.conf`, modify the `mysql-master` or `redis-master` value with the replacement node name. - 例如，以下修改的 `cluster.conf` 文件指定新供应的集群节点 `ghe-replacement-data-node-1` 为 MySQL 和 Redis 主节点： 
    +  For example, this modified `cluster.conf` file specifies a newly provisioned cluster node, `ghe-replacement-data-node-1` as the primary MySQL and Redis node: 
       mysql-master = ghe-replacement-data-node-1
   redis-master = ghe-replacement-data-node-1
   
    
diff --git a/translations/zh-CN/data/reusables/enterprise_clustering/ssh-to-a-node.md b/translations/zh-CN/data/reusables/enterprise_clustering/ssh-to-a-node.md
index 3d23c8888526..4cb41a4896ea 100644
--- a/translations/zh-CN/data/reusables/enterprise_clustering/ssh-to-a-node.md
+++ b/translations/zh-CN/data/reusables/enterprise_clustering/ssh-to-a-node.md
@@ -1 +1 @@
-1. SSH into any node in your cluster. 更多信息请参阅“[访问管理 shell (SSH)](/enterprise/admin/configuration/accessing-the-administrative-shell-ssh)。”
+1. SSH 到集群中的任何节点。 更多信息请参阅“[访问管理 shell (SSH)](/enterprise/admin/configuration/accessing-the-administrative-shell-ssh)。”
diff --git a/translations/zh-CN/data/reusables/enterprise_enterprise_support/submit-support-ticket-first-section.md b/translations/zh-CN/data/reusables/enterprise_enterprise_support/submit-support-ticket-first-section.md
index 876598e506fb..b48d23012d0a 100644
--- a/translations/zh-CN/data/reusables/enterprise_enterprise_support/submit-support-ticket-first-section.md
+++ b/translations/zh-CN/data/reusables/enterprise_enterprise_support/submit-support-ticket-first-section.md
@@ -4,13 +4,15 @@
     - 重现问题的步骤
     - 与发现问题相关的任何特殊情况（例如，首次发生或特定活动后发生、发生频率、问题的业务影响以及建议的紧迫程度）
     - 错误消息的准确表述
-1. 从 {% data variables.product.prodname_enterprise %} 产品下拉菜单，选择 {% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_ghe_cloud %}{% else %}{% data variables.product.prodname_ghe_server %}{% endif %}。 ![优先级下拉菜单](/assets/images/enterprise/support/support-ticket-ghe-product.png)
-1. 从“Priority（优先级）”下拉菜单，选择适当的紧迫程度。 更多信息请参阅“[分配支持事件单的优先级]{% if currentVersion == "free-pro-team@latest" %}(/articles/about-github-premium-support-for-github-enterprise-cloud#assigning-a-priority-to-a-support-ticket){% else %}(/enterprise/admin/guides/enterprise-support/about-github-enterprise-support#assigning-a-priority-to-a-support-ticket){% endif %}”。 ![优先级下拉菜单](/assets/images/enterprise/support/support-ticket-priority.png)
-    - 选择 **{% data variables.product.support_ticket_priority_urgent %}** 以报告{% if currentVersion == "free-pro-team@latest" %}关键系统故障{% else %}致命系统故障、影响关键系统运行的中断、安全事件和许可证过期{% endif %}。
-    - 选择 **{% data variables.product.support_ticket_priority_high %}** 以报告影响业务运营的问题，包括 {% if currentVersion == "free-pro-team@latest" %}从您自己的帐户和组织还原中删除敏感数据（提交、议题、拉取请求、上传的附件）{% else %}系统性能问题{% endif %}，或报告严重漏洞。
-    - 选择 **{% data variables.product.support_ticket_priority_normal %}** 以{% if currentVersion == "free-pro-team@latest" %}请求帐户恢复或垃圾邮件取消标识、报告用户登录问题{% else %}发出技术请求，如配置更改和第三方集成{% endif %}，以及报告非关键漏洞。
-    - 选择 **{% data variables.product.support_ticket_priority_low %}**，提出一般问题并提交关于新功能、购买、培训或状态检查的请求。{% if currentVersion != "free-pro-team@latest" %}
-1. 从“{% data variables.product.prodname_enterprise %} Series（系列）”下拉菜单，选择您使用的 {% data variables.product.prodname_ghe_server %} 的版本。 ![{% data variables.product.prodname_enterprise %} 系列下拉菜单](/assets/images/enterprise/support/support-ticket-ghes-series.png)
+1. From the {% data variables.product.prodname_enterprise %} Product drop-down menu, select {% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_ghe_cloud %}{% else %}{% data variables.product.prodname_ghe_server %}{% endif %}. ![优先级下拉菜单](/assets/images/enterprise/support/support-ticket-ghe-product.png)
+1. 从“Priority（优先级）”下拉菜单，选择适当的紧迫程度。 For more information, see "[Assigning a priority to a support ticket]{% if currentVersion == "free-pro-team@latest" %}(/articles/about-github-premium-support-for-github-enterprise-cloud#assigning-a-priority-to-a-support-ticket){% else %}(/enterprise/admin/guides/enterprise-support/about-github-enterprise-support#assigning-a-priority-to-a-support-ticket){% endif %}." ![优先级下拉菜单](/assets/images/enterprise/support/support-ticket-priority.png)
+    - Choose **{% data variables.product.support_ticket_priority_urgent %}** to report {% if currentVersion == "free-pro-team@latest" %}critical system failure{% else %}fatal system failures, outages impacting critical system operations, security incidents, and expired licenses{% endif %}.
+    - Choose **{% data variables.product.support_ticket_priority_high %}** to report issues impacting business operations, including {% if currentVersion == "free-pro-team@latest" %}removing sensitive data (commits, issues, pull requests, uploaded attachments) from your own accounts and organization restorations{% else %}system performance issues{% endif %}, or to report critical bugs.
+    - Choose **{% data variables.product.support_ticket_priority_normal %}** to {% if currentVersion == "free-pro-team@latest" %}request account recovery or spam unflagging, report user login issues{% else %}make technical requests like configuration changes and third-party integrations{% endif %}, and to report non-critical bugs.
+    - Choose **{% data variables.product.support_ticket_priority_low %}** to ask general questions and submit requests for new features, purchases, training, or health checks.{% if currentVersion != "free-pro-team@latest" %}
+1. From the "
+{% data variables.product.prodname_enterprise %} Series" drop-down menu, select the version of {% data variables.product.prodname_ghe_server %} you're using.
+  ![{% data variables.product.prodname_enterprise %} 系列下拉菜单](/assets/images/enterprise/support/support-ticket-ghes-series.png)
 {% endif %}
 1. 从“Global Region（全球区域）”下拉菜单，选择 APAC（亚太地区）、EMEA（欧洲、中东和非洲）或美洲作为您的区域。 ![全球区域下拉菜单](/assets/images/enterprise/support/support-ticket-global-region.png)
 1. 单击 **Add file（添加文件）**，然后附上您下载的诊断文件，以囊括关于支持事件单的诊断信息。 ![添加文件按钮](/assets/images/enterprise/support/support-ticket-add-file.png)
diff --git a/translations/zh-CN/data/reusables/enterprise_enterprise_support/submit-support-ticket-second-section.md b/translations/zh-CN/data/reusables/enterprise_enterprise_support/submit-support-ticket-second-section.md
index 1a035f83c233..fc3af06a0fc8 100644
--- a/translations/zh-CN/data/reusables/enterprise_enterprise_support/submit-support-ticket-second-section.md
+++ b/translations/zh-CN/data/reusables/enterprise_enterprise_support/submit-support-ticket-second-section.md
@@ -1,4 +1,5 @@
 1. 单击 **Submit（提交）**。
 
 {% if currentVersion != "free-pro-team@latest" %}
-如果选择不在支持单中随附诊断，可在提交支持请求后与 {% data variables.product.prodname_enterprise %} Support 共享诊断信息。 更多信息请参阅“[向 {% data variables.product.prodname_dotcom %} Support 提供数据](/enterprise/admin/guides/enterprise-support/providing-data-to-github-support)”。{% endif %}
+If you chose not to include diagnostics with your support ticket, you can share diagnostic information with
+{% data variables.product.prodname_enterprise %} Support after submitting your support request. 更多信息请参阅“[向 {% data variables.product.prodname_dotcom %} Support 提供数据](/enterprise/admin/guides/enterprise-support/providing-data-to-github-support)”。{% endif %}
diff --git a/translations/zh-CN/data/reusables/enterprise_installation/aws-supported-instance-types.md b/translations/zh-CN/data/reusables/enterprise_installation/aws-supported-instance-types.md
index 5caba8c1726c..20743d939fb5 100644
--- a/translations/zh-CN/data/reusables/enterprise_installation/aws-supported-instance-types.md
+++ b/translations/zh-CN/data/reusables/enterprise_installation/aws-supported-instance-types.md
@@ -28,10 +28,9 @@
 | -------- | --------------------------------------------------------------- |
 | R4       | r4.large、r4.xlarge、r4.2xlarge、r4.4xlarge、r4.8xlarge、r4.16xlarge |
 
-| EC2 实例类型 | 模型                                                               |
-| -------- | ---------------------------------------------------------------- |
-| R5       | r5.large、r5.xlarge、r5.2xlarge、r5.4xlarge、r5.12xlarge、r5.24xlarge |
-
+| EC2 实例类型 | 模型                                                                                                                                                                                                                                                                                                                                             |
+| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| R5       | r5.large, r5.xlarge, r5.2xlarge, r5.4xlarge, r5.12xlarge, r5.24xlarge{% if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.19" %}, r5n.large, r5n.xlarge, r5n.2xlarge, r5n.4xlarge, r5n.12xlarge, r5n.24xlarge, r5a.large, r5a.xlarge, r5a.2xlarge, r5a.4xlarge, r5a.12xlarge, r5a.24xlarge{% endif %}
 
 | EC2 实例类型 | 模型                      |
 | -------- | ----------------------- |
diff --git a/translations/zh-CN/data/reusables/enterprise_installation/command-line-utilities-ghe-upgrade-rollback.md b/translations/zh-CN/data/reusables/enterprise_installation/command-line-utilities-ghe-upgrade-rollback.md
index c4052c3ba0e9..ca01140b54c9 100644
--- a/translations/zh-CN/data/reusables/enterprise_installation/command-line-utilities-ghe-upgrade-rollback.md
+++ b/translations/zh-CN/data/reusables/enterprise_installation/command-line-utilities-ghe-upgrade-rollback.md
@@ -4,4 +4,4 @@
 ghe-upgrade --allow-patch-rollback EARLIER-RELEASE-UPGRADE-PACKAGE.pkg
 ```
 
-A reboot is required after running the command. 回滚不会影响数据分区，因为迁移不是在补丁版本上运行的。
+运行命令后需要重启。 回滚不会影响数据分区，因为迁移不是在补丁版本上运行的。
diff --git a/translations/zh-CN/data/reusables/enterprise_installation/hardware-considerations-all-platforms.md b/translations/zh-CN/data/reusables/enterprise_installation/hardware-considerations-all-platforms.md
index ffe2b69a5e94..4bd7fa60ad4c 100644
--- a/translations/zh-CN/data/reusables/enterprise_installation/hardware-considerations-all-platforms.md
+++ b/translations/zh-CN/data/reusables/enterprise_installation/hardware-considerations-all-platforms.md
@@ -1,55 +1,55 @@
-- [Minimum requirements](#minimum-requirements)
+- [最低要求](#minimum-requirements)
 - [存储器](#storage)
-- [CPU and memory](#cpu-and-memory)
+- [CPU 和内存](#cpu-and-memory)
 
-#### Minimum requirements
+#### 最低要求
 
-We recommend different hardware configurations depending on the number of user licenses for {% data variables.product.product_location_enterprise %}. If you provision more resources than the minimum requirements, your instance will perform and scale better.
+建议根据 {% data variables.product.product_location_enterprise %} 的用户许可数选择不同的硬件配置。 如果预配的资源超过最低要求，您的实例将表现出更好的性能和扩展。
 
-{% data reusables.enterprise_installation.hardware-rec-table %} For more information about adjusting resources for an existing instance, see "[Increasing storage capacity](/enterprise/admin/installation/increasing-storage-capacity)" and "[Increasing CPU or memory resources](/enterprise/admin/installation/increasing-cpu-or-memory-resources)."
+{% data reusables.enterprise_installation.hardware-rec-table %} 有关为现有实例调整资源的更多信息，请参阅“[增加存储容量](/enterprise/admin/installation/increasing-storage-capacity)”和“[增加 CPU 或内存资源](/enterprise/admin/installation/increasing-cpu-or-memory-resources)”。
 
 {% if currentVersion == "enterprise-server@2.22" %}
 
-If you enable the beta for {% data variables.product.prodname_actions %} on your instance, we recommend planning for additional capacity.
+如果您为实例上的 {% data variables.product.prodname_actions %} 启用测试版，建议您规划额外的容量。
 
-- You must configure at least one runner for {% data variables.product.prodname_actions %} workflows. 更多信息请参阅“[关于自托管运行器](/actions/hosting-your-own-runners/about-self-hosted-runners)”。
-- You must configure external blob storage. For more information, see "[Enabling {% data variables.product.prodname_actions %} and configuring storage](/enterprise/admin/github-actions/enabling-github-actions-and-configuring-storage)."
+- 您必须为 {% data variables.product.prodname_actions %} 工作流程配置至少一个运行器。 更多信息请参阅“[关于自托管运行器](/actions/hosting-your-own-runners/about-self-hosted-runners)”。
+- 您必须配置外部 Blob 存储。 更多信息请参阅“[启用 {% data variables.product.prodname_actions %} 和配置存储](/enterprise/admin/github-actions/enabling-github-actions-and-configuring-storage)”。
 
-The additional CPU and memory resources you need to provision for your instance depend on the number of workflows your users run concurrently, and the overall levels of activity for users, automations, and integrations.
+需要为实例预配的额外 CPU 和内存资源取决于用户同时运行的工作流程数量，以及用户活动、自动化和集成的总体水平。
 
-| Maximum jobs per minute | vCPU |      内存 |
-|:----------------------- | ----:| -------:|
-| Light testing           |    4 | 30.5 GB |
-| 25                      |    8 |   61 GB |
-| 35                      |   16 |  122 GB |
-| 100                     |   32 |  244 GB |
+| 每分钟最大作业数 | vCPU |      内存 |
+|:-------- | ----:| -------:|
+| 轻型测试     |    4 | 30.5 GB |
+| 25       |    8 |   61 GB |
+| 35       |   16 |  122 GB |
+| 100      |   32 |  244 GB |
 
 {% endif %}
 
 #### 存储器
 
-We recommend a high-performance SSD with high input/output operations per second (IOPS) and low latency for {% data variables.product.prodname_ghe_server %}. Workloads are I/O intensive. If you use a bare metal hypervisor, we recommend directly attaching the disk or using a disk from a storage area network (SAN).
+我们建议为 {% data variables.product.prodname_ghe_server %} 配置具有高每秒输入/输出操作数 (IOPS) 和低延迟的高性能 SSD。 工作负载是 I/O 密集型的。 如果使用裸机管理程序，建议直接连接磁盘或使用存储区域网络 (SAN) 中的磁盘。
 
-Your instance requires a persistent data disk separate from the root disk. 更多信息请参阅“[系统概述](/enterprise/admin/guides/installation/system-overview)”。
+您的实例需要一个独立于根磁盘的持久数据磁盘。 更多信息请参阅“[系统概述](/enterprise/admin/guides/installation/system-overview)”。
 
 {% if currentVersion ver_gt "enterprise-server@2.21" %}
 
-If you enable the beta of {% data variables.product.prodname_actions %} in {% data variables.product.prodname_ghe_server %} 2.22, you'll need to configure external blob storage. For more information, see "[Enabling {% data variables.product.prodname_actions %} and configuring storage](/enterprise/admin/github-actions/enabling-github-actions-and-configuring-storage)."
+如果您在 {% data variables.product.prodname_ghe_server %} 2.22 中启用 {% data variables.product.prodname_actions %} 的测试版，则需要配置外部 blob 存储。 更多信息请参阅“[启用 {% data variables.product.prodname_actions %} 和配置存储](/enterprise/admin/github-actions/enabling-github-actions-and-configuring-storage)”。
 
 {% endif %}
 
-You can resize your instance's root disk by building a new instance or using an existing instance. 更多信息请参阅“[增加存储容量](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity)”。
+您可以通过构建一个新实例或使用现有实例来调整实例的根磁盘大小。 更多信息请参阅“[增加存储容量](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity)”。
 
-#### CPU and memory
+#### CPU 和内存
 
-{% data variables.product.prodname_ghe_server %} requires more CPU and memory resources depending on levels of activity for users, automations, and integrations.
+{% data variables.product.prodname_ghe_server %} 需要更多的 CPU 和内存资源，取决于用户活动、自动化和集成的水平。
 
 {% data reusables.enterprise_installation.increasing-cpus-req %}
 
 {% warning %}
 
-**Warning:** We recommend that users configure webhook events to notify external systems of activity on {% data variables.product.prodname_ghe_server %}. Automated checks for changes, or _polling_, will negatively impact the performance and scalability of your instance. For more information, see "[About webhooks](/github/extending-github/about-webhooks)."
+**警告：** 我们建议用户配置 web 挂钩事件来通知外部系统有关 {% data variables.product.prodname_ghe_server %} 上的活动。 自动检查更改或 _轮询_将对实例的性能和可扩展性产生不利影响。 更多信息请参阅“[关于 web 挂钩](/github/extending-github/about-webhooks)”。
 
 {% endwarning %}
 
-You can increase your instance's CPU or memory resources. For more information, see "[Increasing CPU or memory resources](/enterprise/admin/installation/increasing-cpu-or-memory-resources).
+您可以增加实例的 CPU 或内存资源。 更多信息请参阅“[增加 CPU 或内存资源](/enterprise/admin/installation/increasing-cpu-or-memory-resources)”。
diff --git a/translations/zh-CN/data/reusables/enterprise_installation/hardware-rec-table.md b/translations/zh-CN/data/reusables/enterprise_installation/hardware-rec-table.md
index 380663748b96..5a1c1be8520b 100644
--- a/translations/zh-CN/data/reusables/enterprise_installation/hardware-rec-table.md
+++ b/translations/zh-CN/data/reusables/enterprise_installation/hardware-rec-table.md
@@ -1,16 +1,16 @@
 {% if currentVersion == "enterprise-server@2.22" %}
 
-Minimum requirements for an instance with beta features enabled are **bold** in the following table. For more information, see "[Beta features in {% data variables.product.prodname_ghe_server %} 2.22](#beta-features-in-github-enterprise-server-222)." |{% endif %}
-| 用户许可              |                                                                                                               vCPU |                                                                                                                         内存 |                                                                                                                    附加的存储容量 |  根存储容量 |
-|:----------------- | ------------------------------------------------------------------------------------------------------------------:| --------------------------------------------------------------------------------------------------------------------------:| --------------------------------------------------------------------------------------------------------------------------:| ------:|
+启用测试功能的实例的最低要求在下表中用**粗体**表示。 更多信息请参阅“[{% data variables.product.prodname_ghe_server %} 2.22 中的测试功能](#beta-features-in-github-enterprise-server-222)”。 |{% endif %}
+| 用户许可              |                                                                                                                                   vCPU |                                                                                                                                             内存 |                                                                                                                                        附加的存储容量 |  根存储容量 |
+|:----------------- | --------------------------------------------------------------------------------------------------------------------------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------:| ------:|
 | 试用版、演示版或 10 个轻度用户 |   2{% if currentVersion == "enterprise-server@2.22" %}
    or [**4**](#beta-features-in-github-enterprise-server-222){% endif %} |   16 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**32 GB**](#beta-features-in-github-enterprise-server-222){% endif %} | 100 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**150 GB**](#beta-features-in-github-enterprise-server-222){% endif %} | 200 GB |
 | 10-3000           |   4{% if currentVersion == "enterprise-server@2.22" %}
    or [**8**](#beta-features-in-github-enterprise-server-222){% endif %} |   32 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**48 GB**](#beta-features-in-github-enterprise-server-222){% endif %} | 250 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**300 GB**](#beta-features-in-github-enterprise-server-222){% endif %} | 200 GB |
-| 3000-5000         |  8{% if currentVersion == "enterprise-server@2.22" %}
    or [**12**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                      64 GB |                                                                                                                     500 GB | 200 GB |
-| 5000-8000         | 12{% if currentVersion == "enterprise-server@2.22" %}
    or [**16**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                      96 GB |                                                                                                                     750 GB | 200 GB |
-| 8000-10000+       | 16{% if currentVersion == "enterprise-server@2.22" %}
    or [**20**](#beta-features-in-github-enterprise-server-222){% endif %} | 128 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**160 GB**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                    1000 GB | 200 GB |
+| 3000-5000         |  8{% if currentVersion == "enterprise-server@2.22" %}
    or [**12**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                                          64 GB |                                                                                                                                         500 GB | 200 GB |
+| 5000-8000         | 12{% if currentVersion == "enterprise-server@2.22" %}
    or [**16**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                                          96 GB |                                                                                                                                         750 GB | 200 GB |
+| 8000-10000+       | 16{% if currentVersion == "enterprise-server@2.22" %}
    or [**20**](#beta-features-in-github-enterprise-server-222){% endif %} | 128 GB{% if currentVersion == "enterprise-server@2.22" %}
    or [**160 GB**](#beta-features-in-github-enterprise-server-222){% endif %} |                                                                                                                                        1000 GB | 200 GB |
 
 {% if currentVersion == "enterprise-server@2.22" %}
 
-#### Beta features in {% data variables.product.prodname_ghe_server %} 2.22
+#### {% data variables.product.prodname_ghe_server %} 2.22 中的测试功能
 
-If you enable beta features in {% data variables.product.prodname_ghe_server %} 2.22, your instance requires additional hardware resources. For more information about the beta features, see the [release notes for the 2.22 series](https://enterprise.github.com/releases/series/2.22) on the {% data variables.product.prodname_enterprise %} website.{% endif %}
+如果您在 {% data variables.product.prodname_ghe_server %} 2.22 中启用测试功能，则您的实例需要额外的硬件资源。 有关测试功能的更多信息，请参阅 {% data variables.product.prodname_enterprise %} 网站上的 [2.22 系列发行说明](https://enterprise.github.com/releases/series/2.22)。{% endif %}
diff --git a/translations/zh-CN/data/reusables/enterprise_installation/increasing-cpus-req.md b/translations/zh-CN/data/reusables/enterprise_installation/increasing-cpus-req.md
index 92562eddd24c..c3cb2fa4b454 100644
--- a/translations/zh-CN/data/reusables/enterprise_installation/increasing-cpus-req.md
+++ b/translations/zh-CN/data/reusables/enterprise_installation/increasing-cpus-req.md
@@ -1 +1 @@
-When you increase CPU resources, we recommend adding at least 6.5 GB of memory for each vCPU (up to 16 vCPUs) that you provision for the instance. When you use more than 16 vCPUs, you don't need to add 6.5 GB of memory for each vCPU, but you should monitor your instance to ensure it has enough memory.
+增加 CPU 资源时，我们建议为实例预配的每个 vCPU（最多 16 个 vCPU）增加至少 6.5 GB 的内存。 如果您使用的 vCPU 超过 16 个，则无需为每个 vCPU 添加 6.5 GB 内存，但应监控您的实例以确保其有足够的内存。
diff --git a/translations/zh-CN/data/reusables/enterprise_installation/necessary_ports.md b/translations/zh-CN/data/reusables/enterprise_installation/necessary_ports.md
index 28771e71ddf9..735c2a20a530 100644
--- a/translations/zh-CN/data/reusables/enterprise_installation/necessary_ports.md
+++ b/translations/zh-CN/data/reusables/enterprise_installation/necessary_ports.md
@@ -1,12 +1,12 @@
-| 端口       | 服务    | 描述                                                                                       |
-| -------- | ----- | ---------------------------------------------------------------------------------------- |
-| 22       | SSH   | Git over SSH 访问。 支持克隆、获取和推送操作到公共/私有仓库。                                                   |
-| 25       | SMTP  | 支持加密 (STARTTLS) 的 SMTP。                                                                  |
-| 80       | HTTP  | Web 应用程序访问。 *当 SSL 启用时，所有请求都会重定向到 HTTPS 端口。*                                             |
-| 122      | SSH   | 实例 shell 访问。 *默认 SSH 端口 (22) 专用于应用程序 git+ssh 网络流量。*                                      |
-| 161/UDP  | SNMP  | 为网络监视协议操作所需。                                                                             |
-| 443      | HTTPS | Web 应用程序和 Git over HTTPS 访问。                                                             |
-| 1194/UDP | VPN   | 采用高可用性配置的安全复制网络隧道。                                                                       |
-| 8080     | HTTP  | 基于纯文本 Web 的 {% data variables.enterprise.management_console %}。 *除非手动禁用 SSL，否则不需要。* |
-| 8443     | HTTPS | 基于安全 Web 的 {% data variables.enterprise.management_console %}。 *进行基本安装和配置时需要。*      |
-| 9418     | Git   | 简单的 Git 协议端口。 仅克隆和获取操作到公共仓库。 *未加密的网络通信。*                                                 |
+| 端口       | 服务    | 描述                                                                                                                                 |
+| -------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------- |
+| 22       | SSH   | Git over SSH 访问。 支持克隆、获取和推送操作到公共/私有仓库。                                                                                             |
+| 25       | SMTP  | 支持加密 (STARTTLS) 的 SMTP。                                                                                                            |
+| 80       | HTTP  | Web 应用程序访问。 *当 SSL 启用时，所有请求都会重定向到 HTTPS 端口。*                                                                                       |
+| 122      | SSH   | 实例 shell 访问。 *默认 SSH 端口 (22) 专用于应用程序 git+ssh 网络流量。*                                                                                |
+| 161/UDP  | SNMP  | 为网络监视协议操作所需。                                                                                                                       |
+| 443      | HTTPS | Web 应用程序和 Git over HTTPS 访问。                                                                                                       |
+| 1194/UDP | VPN   | 采用高可用性配置的安全复制网络隧道。                                                                                                                 |
+| 8080     | HTTP  | 基于纯文本 Web 的 {% data variables.enterprise.management_console %}。 *除非手动禁用 SSL，否则不需要。*                                                |
+| 8443     | HTTPS | 基于安全 Web 的 {% data variables.enterprise.management_console %}。 *进行基本安装和配置时需要。*                                                     |
+| 9418     | Git   | 简单的 Git 协议端口。 仅克隆和获取操作到公共仓库。 *Unencrypted network communication.* {% data reusables.enterprise_installation.when-9418-necessary %}
diff --git a/translations/zh-CN/data/reusables/enterprise_installation/when-9418-necessary.md b/translations/zh-CN/data/reusables/enterprise_installation/when-9418-necessary.md
new file mode 100644
index 000000000000..7eed264bd24e
--- /dev/null
+++ b/translations/zh-CN/data/reusables/enterprise_installation/when-9418-necessary.md
@@ -0,0 +1 @@
+If you have enabled private mode on your instance, then opening this port is only required if you also enabled anonymous Git read access. For more information, see "[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#configuring-anonymous-git-read-access)."
\ No newline at end of file
diff --git a/translations/zh-CN/data/reusables/enterprise_management_console/advanced-security-tab.md b/translations/zh-CN/data/reusables/enterprise_management_console/advanced-security-tab.md
index 9527586cf98e..4352518b0222 100644
--- a/translations/zh-CN/data/reusables/enterprise_management_console/advanced-security-tab.md
+++ b/translations/zh-CN/data/reusables/enterprise_management_console/advanced-security-tab.md
@@ -1 +1 @@
-1. 在左侧边栏中，单击 **{% data variables.product.prodname_advanced_security %}**。 ![Advanced Security sidebar](/assets/images/enterprise/management-console/sidebar-advanced-security.png)
+1. 在左侧边栏中，单击 **{% data variables.product.prodname_advanced_security %}**。 ![高级安全侧边栏](/assets/images/enterprise/management-console/sidebar-advanced-security.png)
diff --git a/translations/zh-CN/data/reusables/enterprise_management_console/badge_indicator.md b/translations/zh-CN/data/reusables/enterprise_management_console/badge_indicator.md
index 531987c216a2..53b45a136717 100644
--- a/translations/zh-CN/data/reusables/enterprise_management_console/badge_indicator.md
+++ b/translations/zh-CN/data/reusables/enterprise_management_console/badge_indicator.md
@@ -1 +1 @@
-[同步到 LDAP 组](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)的团队用特殊的 LDAP 徽章表示。 LDAP 同步团队的成员列表只能从它映射的 LDAP 组进行管理。
+[同步到 LDAP 组](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap#enabling-ldap-sync)的团队用特殊的 LDAP 徽章表示。 LDAP 同步团队的成员列表只能从它映射的 LDAP 组进行管理。
diff --git a/translations/zh-CN/data/reusables/enterprise_management_console/enable-disable-code-scanning.md b/translations/zh-CN/data/reusables/enterprise_management_console/enable-disable-code-scanning.md
index a6adf2088eba..60264e2618f0 100644
--- a/translations/zh-CN/data/reusables/enterprise_management_console/enable-disable-code-scanning.md
+++ b/translations/zh-CN/data/reusables/enterprise_management_console/enable-disable-code-scanning.md
@@ -1,5 +1,5 @@
 {% warning %}
 
-**Warning**: Changing this setting will cause {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_ghe_server %}{% else %}{% data variables.product.prodname_dotcom %}{% endif %} to restart. You should time this change carefully, to minimize downtime.
+**Warning**: Changing this setting will cause {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_ghe_server %}{% else %}{% data variables.product.prodname_dotcom %}{% endif %} to restart. 您应谨慎安排更改时间，以尽量减少停机时间。
 
 {% endwarning %}
diff --git a/translations/zh-CN/data/reusables/enterprise_site_admin_settings/admin-top-tab.md b/translations/zh-CN/data/reusables/enterprise_site_admin_settings/admin-top-tab.md
index 9e629512ce52..f44e72baa40d 100644
--- a/translations/zh-CN/data/reusables/enterprise_site_admin_settings/admin-top-tab.md
+++ b/translations/zh-CN/data/reusables/enterprise_site_admin_settings/admin-top-tab.md
@@ -1 +1 @@
-1. In the upper-right corner of the page, click {% octicon "gear" %} **Admin**. ![管理员工具](/assets/images/enterprise/site-admin-settings/user/user-admin-tab-top.png)
+1. 在页面的右上角，单击 {% octicon "gear" %} **Admin（管理员）**。 ![管理员工具](/assets/images/enterprise/site-admin-settings/user/user-admin-tab-top.png)
diff --git a/translations/zh-CN/data/reusables/enterprise_site_admin_settings/business.md b/translations/zh-CN/data/reusables/enterprise_site_admin_settings/business.md
index c8768263ff42..bcda507fbea0 100644
--- a/translations/zh-CN/data/reusables/enterprise_site_admin_settings/business.md
+++ b/translations/zh-CN/data/reusables/enterprise_site_admin_settings/business.md
@@ -1 +1 @@
-1. 在左侧边栏中，单击 **Enterprise（企业）**。 ![站点管理设置中的 Enterprise（企业）选项卡](/assets/images/enterprise/site-admin-settings/enterprise-tab.png)
+1. In the left sidebar, click **Enterprise{% if currentVersion ver_gt "enterprise-server@2.21" %} overview{% endif %}**. ![Enterprise{% if currentVersion ver_gt "enterprise-server@2.21" %} overview{% endif %} tab in the Site admin settings](/assets/images/enterprise/site-admin-settings/enterprise-tab.png)
diff --git a/translations/zh-CN/data/reusables/enterprise_site_admin_settings/packages-tab.md b/translations/zh-CN/data/reusables/enterprise_site_admin_settings/packages-tab.md
index 7552439d3d6c..d6c847c21178 100644
--- a/translations/zh-CN/data/reusables/enterprise_site_admin_settings/packages-tab.md
+++ b/translations/zh-CN/data/reusables/enterprise_site_admin_settings/packages-tab.md
@@ -1 +1 @@
-1. In the left sidebar, click **Packages**. ![Packages tab in management console sidebar](/assets/images/enterprise/site-admin-settings/management-console-packages-tab.png)
\ No newline at end of file
+1. 在左边栏中，单击 **Packages（包）**。 ![管理控制台边栏中的包选项卡](/assets/images/enterprise/site-admin-settings/management-console-packages-tab.png)
diff --git a/translations/zh-CN/data/reusables/enterprise_site_admin_settings/repository-search.md b/translations/zh-CN/data/reusables/enterprise_site_admin_settings/repository-search.md
index 61161e5e4717..01095b51f0e7 100644
--- a/translations/zh-CN/data/reusables/enterprise_site_admin_settings/repository-search.md
+++ b/translations/zh-CN/data/reusables/enterprise_site_admin_settings/repository-search.md
@@ -1 +1 @@
-1. 在搜索字段中，输入仓库的名称，然后单击 **Search（搜索）**。 ![Site admin settings search field](/assets/images/enterprise/site-admin-settings/search-for-things.png)
+1. 在搜索字段中，输入仓库的名称，然后单击 **Search（搜索）**。 ![站点管理员设置搜索字段](/assets/images/enterprise/site-admin-settings/search-for-things.png)
diff --git a/translations/zh-CN/data/reusables/enterprise_site_admin_settings/search-user-or-org.md b/translations/zh-CN/data/reusables/enterprise_site_admin_settings/search-user-or-org.md
index 5128e6f07753..ced13cbabee0 100644
--- a/translations/zh-CN/data/reusables/enterprise_site_admin_settings/search-user-or-org.md
+++ b/translations/zh-CN/data/reusables/enterprise_site_admin_settings/search-user-or-org.md
@@ -1 +1 @@
-1. 在搜索字段中，输入用户或组织的名称，然后单击 **Search（搜索）**。 ![Site admin settings search field](/assets/images/enterprise/site-admin-settings/search-for-things.png)
+1. 在搜索字段中，输入用户或组织的名称，然后单击 **Search（搜索）**。 ![站点管理员设置搜索字段](/assets/images/enterprise/site-admin-settings/search-for-things.png)
diff --git a/translations/zh-CN/data/reusables/enterprise_site_admin_settings/search-user.md b/translations/zh-CN/data/reusables/enterprise_site_admin_settings/search-user.md
index 55fd55589311..8286fc000864 100644
--- a/translations/zh-CN/data/reusables/enterprise_site_admin_settings/search-user.md
+++ b/translations/zh-CN/data/reusables/enterprise_site_admin_settings/search-user.md
@@ -1 +1 @@
-1. 在搜索字段中，输入用户的名称，然后单击 **Search（搜索）**。 ![Site admin settings search field](/assets/images/enterprise/site-admin-settings/search-for-things.png)
+1. 在搜索字段中，输入用户的名称，然后单击 **Search（搜索）**。 ![站点管理员设置搜索字段](/assets/images/enterprise/site-admin-settings/search-for-things.png)
diff --git a/translations/zh-CN/data/reusables/enterprise_user_management/manage-global-webhooks-api.md b/translations/zh-CN/data/reusables/enterprise_user_management/manage-global-webhooks-api.md
index 381e71a71562..f9109181ef76 100644
--- a/translations/zh-CN/data/reusables/enterprise_user_management/manage-global-webhooks-api.md
+++ b/translations/zh-CN/data/reusables/enterprise_user_management/manage-global-webhooks-api.md
@@ -1 +1 @@
-您也可以使用 {% data variables.product.prodname_enterprise_api %} 来管理全局 web 挂钩。 For a complete list of actions, see "[Global webhooks](/v3/enterprise-admin/global_webhooks)."
+您也可以使用 {% data variables.product.prodname_enterprise_api %} 来管理全局 web 挂钩。 有关操作的完整列表，请参阅“[全局 web 挂钩](/rest/reference/enterprise-admin#global-webhooks)”。
diff --git a/translations/zh-CN/data/reusables/files/add-file.md b/translations/zh-CN/data/reusables/files/add-file.md
index daf8d37dba61..2c5a070b2ec0 100644
--- a/translations/zh-CN/data/reusables/files/add-file.md
+++ b/translations/zh-CN/data/reusables/files/add-file.md
@@ -1,5 +1,5 @@
 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %}
-1. Above the list of files, click **Create new file**. !["Create new file" button](/assets/images/help/repository/create_new_file.png)
+1. 在文件列表上方，单击 **Create new file（创建新文件）**。 !["创建新文件"按钮](/assets/images/help/repository/create_new_file.png)
 {% else %}
-1. Above the list of files, using the **Add file** drop-down, click **Create new file**. !["Create new file" in the "Add file" dropdown](/assets/images/help/repository/create_new_file.png)
+1. 在文件列表上方，使用 **Add file（添加文件）**下拉菜单，单击 **Create new file（创建新文件）**。 !["添加文件"下拉菜单中的"创建新文件"按钮](/assets/images/help/repository/create_new_file.png)
 {% endif %}
diff --git a/translations/zh-CN/data/reusables/files/choose_commit_branch.md b/translations/zh-CN/data/reusables/files/choose_commit_branch.md
index a08313cc46a2..3136d3984856 100644
--- a/translations/zh-CN/data/reusables/files/choose_commit_branch.md
+++ b/translations/zh-CN/data/reusables/files/choose_commit_branch.md
@@ -1 +1 @@
-1. 在提交消息字段下面，确定是要将提交添加到当前分支还是新分支。 If your current branch is the default branch, you should choose to create a new branch for your commit and then create a pull request. 更多信息请参阅“[创建新的拉取请求](/articles/creating-a-pull-request)”。 ![提交分支选项](/assets/images/help/repository/choose-commit-branch.png)
+1. 在提交消息字段下面，确定是要将提交添加到当前分支还是新分支。 如果当前分支是默认分支，则应选择为提交创建新分支，然后创建拉取请求。 更多信息请参阅“[创建新的拉取请求](/articles/creating-a-pull-request)”。 ![提交分支选项](/assets/images/help/repository/choose-commit-branch.png)
diff --git a/translations/zh-CN/data/reusables/files/commit-author-email-options.md b/translations/zh-CN/data/reusables/files/commit-author-email-options.md
index d2ed8f5a6721..e680c3540565 100644
--- a/translations/zh-CN/data/reusables/files/commit-author-email-options.md
+++ b/translations/zh-CN/data/reusables/files/commit-author-email-options.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-如果您尚未启用电子邮件地址隐私保护，则在 {% data variables.product.product_name %} 上编辑、删除或创建文件或者合并拉取请求时，可以选择将作者更改提交到哪个经验证的电子邮件地址。 如果您启用了电子邮件地址隐私，则不能更改提交作者电子邮件地址，默认情况下是 `@users.norreply.github.com`。
+If you haven't enabled email address privacy, you can choose which verified email address to author changes with when you edit, delete, or create files or merge a pull request on
+{% data variables.product.product_name %} 上的企业设置来设置公告横幅。 如果您启用了电子邮件地址隐私，则不能更改提交作者电子邮件地址，默认情况下是 `@users.norreply.github.com`。
 {% endif %}
diff --git a/translations/zh-CN/data/reusables/gated-features/actions.md b/translations/zh-CN/data/reusables/gated-features/actions.md
index 8f5d01dd87e6..1bceb3c7bd53 100644
--- a/translations/zh-CN/data/reusables/gated-features/actions.md
+++ b/translations/zh-CN/data/reusables/gated-features/actions.md
@@ -1 +1 @@
-{% data variables.product.prodname_actions %} 可用于 {% data variables.product.prodname_free_user %}、{% data variables.product.prodname_pro %}、组织的 {% data variables.product.prodname_free_team %}、{% data variables.product.prodname_team %}、{% data variables.product.prodname_ghe_cloud %} 和 {% data variables.product.prodname_ghe_one %}。 {% data variables.product.prodname_actions %} is not available for private repositories owned by accounts using legacy per-repository plans. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %}
+{{ site.data.variables.product.prodname_actions }} 可用于 {{ site.data.variables.product.prodname_free_user }}、{{ site.data.variables.product.prodname_pro }}、组织的 {{ site.data.variables.product.prodname_free_team }}、{{ site.data.variables.product.prodname_team }}、{{ site.data.variables.product.prodname_ghe_cloud }} 和 {{ site.data.variables.product.prodname_ghe_one }}。 {% data variables.product.prodname_actions %} 不适用于使用旧版按仓库计划的帐户所拥有的私有仓库。 {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %}
diff --git a/translations/zh-CN/data/reusables/gated-features/code-review-assignment.md b/translations/zh-CN/data/reusables/gated-features/code-review-assignment.md
index b553fac0b382..84112f1950c1 100644
--- a/translations/zh-CN/data/reusables/gated-features/code-review-assignment.md
+++ b/translations/zh-CN/data/reusables/gated-features/code-review-assignment.md
@@ -1 +1 @@
-代码审查任务可用于 {% data variables.product.prodname_team %}{% if currentVersion ver_gt "enterprise-server@2.19" %}、{% data variables.product.prodname_ghe_server %} 2.20+、{% endif %} 和 {% data variables.product.prodname_ghe_cloud %}。 更多信息请参阅“[GitHub's products](/articles/githubs-products)”。
+Code review assignment is available with {% data variables.product.prodname_team %}{% if currentVersion ver_gt "enterprise-server@2.19" %}, {% data variables.product.prodname_ghe_server %} 2.20+,{% endif %} and {% data variables.product.prodname_ghe_cloud %}. 更多信息请参阅“[GitHub's products](/articles/githubs-products)”。
diff --git a/translations/zh-CN/data/reusables/gated-features/code-scanning.md b/translations/zh-CN/data/reusables/gated-features/code-scanning.md
new file mode 100644
index 000000000000..a1aca3e675eb
--- /dev/null
+++ b/translations/zh-CN/data/reusables/gated-features/code-scanning.md
@@ -0,0 +1 @@
+{% data variables.product.prodname_code_scanning_capc %} is available in public repositories, and in public and private repositories owned by organizations with a license for {% data variables.product.prodname_advanced_security %}. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %}
diff --git a/translations/zh-CN/data/reusables/gated-features/enterprise-accounts.md b/translations/zh-CN/data/reusables/gated-features/enterprise-accounts.md
index 3788fd49a159..e50222945dda 100644
--- a/translations/zh-CN/data/reusables/gated-features/enterprise-accounts.md
+++ b/translations/zh-CN/data/reusables/gated-features/enterprise-accounts.md
@@ -1 +1 @@
-企业帐户可用于 {% data variables.product.prodname_ghe_cloud %} 和 {% data variables.product.prodname_ghe_server %}。 {% if currentVersion == "free-pro-team@latest" %}更多信息请参阅“[关于企业帐户](/articles/about-enterprise-accounts)”。{% endif %}
+企业帐户可用于 {% data variables.product.prodname_ghe_cloud %} 和 {% data variables.product.prodname_ghe_server %}。 {% if currentVersion == "free-pro-team@latest" %}For more information, see "[About enterprise accounts](/articles/about-enterprise-accounts)."{% endif %}
diff --git a/translations/zh-CN/data/reusables/gated-features/enterprise_account_webhooks.md b/translations/zh-CN/data/reusables/gated-features/enterprise_account_webhooks.md
index add5e44665a8..556f538ff531 100644
--- a/translations/zh-CN/data/reusables/gated-features/enterprise_account_webhooks.md
+++ b/translations/zh-CN/data/reusables/gated-features/enterprise_account_webhooks.md
@@ -1,4 +1,4 @@
 
 {% data reusables.gated-features.enterprise-accounts %}
 
-Webhooks configured on enterprise accounts or organizations that are part of an enterprise account will include an `enterprise` account object.
+在企业帐户或企业帐户中的组织上配置的 web 挂钩将包括 `enterprise` 帐户对象。
diff --git a/translations/zh-CN/data/reusables/gated-features/more-info-org-products.md b/translations/zh-CN/data/reusables/gated-features/more-info-org-products.md
index 4cd90e2170dc..323025b41e40 100644
--- a/translations/zh-CN/data/reusables/gated-features/more-info-org-products.md
+++ b/translations/zh-CN/data/reusables/gated-features/more-info-org-products.md
@@ -1 +1 @@
-{% if currentVersion == "free-pro-team@latest" %}更多信息请参阅“[{% data variables.product.prodname_dotcom %} 的产品](/articles/github-s-products)”。{% endif %}
+{% if currentVersion == "free-pro-team@latest" %}For more information, see "[{% data variables.product.prodname_dotcom %}'s products](/articles/github-s-products)."{% endif %}
diff --git a/translations/zh-CN/data/reusables/gated-features/more-info.md b/translations/zh-CN/data/reusables/gated-features/more-info.md
index 4cd90e2170dc..323025b41e40 100644
--- a/translations/zh-CN/data/reusables/gated-features/more-info.md
+++ b/translations/zh-CN/data/reusables/gated-features/more-info.md
@@ -1 +1 @@
-{% if currentVersion == "free-pro-team@latest" %}更多信息请参阅“[{% data variables.product.prodname_dotcom %} 的产品](/articles/github-s-products)”。{% endif %}
+{% if currentVersion == "free-pro-team@latest" %}For more information, see "[{% data variables.product.prodname_dotcom %}'s products](/articles/github-s-products)."{% endif %}
diff --git a/translations/zh-CN/data/reusables/gated-features/packages.md b/translations/zh-CN/data/reusables/gated-features/packages.md
index db95f995996c..8b9a1e9fc00a 100644
--- a/translations/zh-CN/data/reusables/gated-features/packages.md
+++ b/translations/zh-CN/data/reusables/gated-features/packages.md
@@ -1,4 +1,5 @@
-{% data variables.product.prodname_registry %} is available with {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} for organizations, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, {% data variables.product.prodname_ghe_server %} 2.22, and {% data variables.product.prodname_ghe_one %}.
+{% data variables.product.prodname_registry %} 可用于 {% data variables.product.prodname_free_user %}、{% data variables.product.prodname_pro %}、组织的 {% data variables.product.prodname_free_team %}、{% data variables.product.prodname_team %}、{% data variables.product.prodname_ghe_cloud %}、{% data variables.product.prodname_ghe_server %} 2.22 和 {% data variables.product.prodname_ghe_one %}。
 {% if currentVersion == "free-pro-team@latest" %}
-
    {% data variables.product.prodname_registry %} 不适用于使用旧版按仓库计划的帐户所拥有的私有仓库。 {% data variables.product.prodname_registry %} 可用于 {% data variables.product.prodname_free_user %}、{% data variables.product.prodname_pro %}、组织的 {% data variables.product.prodname_free_team %}、{% data variables.product.prodname_team %}、{% data variables.product.prodname_ghe_cloud %} 和 {% data variables.product.prodname_ghe_one %}。 {% data reusables.gated-features.more-info %}
+
    
+{% data variables.product.prodname_registry %} 不适用于使用旧版按仓库计划的帐户所拥有的私有仓库。 {% data variables.product.prodname_registry %} 可用于 {% data variables.product.prodname_free_user %}、{% data variables.product.prodname_pro %}、组织的 {% data variables.product.prodname_free_team %}、{% data variables.product.prodname_team %}、{% data variables.product.prodname_ghe_cloud %} 和 {% data variables.product.prodname_ghe_one %}。 {% data reusables.gated-features.more-info %}
 {% endif %}
diff --git a/translations/zh-CN/data/reusables/gated-features/repository-insights.md b/translations/zh-CN/data/reusables/gated-features/repository-insights.md
index d92b1a8773bd..c400b5bf830d 100644
--- a/translations/zh-CN/data/reusables/gated-features/repository-insights.md
+++ b/translations/zh-CN/data/reusables/gated-features/repository-insights.md
@@ -1 +1 @@
-此仓库洞察图可用于具有 {% data variables.product.prodname_free_user %} 和组织的 {% data variables.product.prodname_free_team %} 的公共仓库，以及具有 {% data variables.product.prodname_pro %}、{% data variables.product.prodname_team %}、{% data variables.product.prodname_ghe_cloud %} 和 {% data variables.product.prodname_ghe_server %} 的公共和私有仓库。{% if currentVersion == "free-pro-team@latest" %} 更多信息请参阅“[关于仓库图](/articles/about-repository-graphs)”和“[{% data variables.product.prodname_dotcom %} 的产品](/articles/github-s-products)”。{% endif %}
+This repository insights graph is available in public repositories with {% data variables.product.prodname_free_user %} and {% data variables.product.prodname_free_team %} for organizations, and in public and private repositories with {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, and {% data variables.product.prodname_ghe_server %}.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[About repository graphs](/articles/about-repository-graphs)" and "[{% data variables.product.prodname_dotcom %}'s products](/articles/github-s-products)."{% endif %}
diff --git a/translations/zh-CN/data/reusables/github-actions/actions-billing.md b/translations/zh-CN/data/reusables/github-actions/actions-billing.md
index 9e5049e2f148..bd4183e5fd36 100644
--- a/translations/zh-CN/data/reusables/github-actions/actions-billing.md
+++ b/translations/zh-CN/data/reusables/github-actions/actions-billing.md
@@ -1 +1 @@
-公共仓库免费使用 {% data variables.product.prodname_actions %}。 对于私有仓库，每个 {% data variables.product.prodname_dotcom %} 帐户可获得一定数量的免费记录和存储，具体取决于帐户所使用的产品。
+{% data variables.product.prodname_actions %} usage is free for public repositories and self-hosted runners. 对于私有仓库，每个 {% data variables.product.prodname_dotcom %} 帐户可获得一定数量的免费记录和存储，具体取决于帐户所使用的产品。
diff --git a/translations/zh-CN/data/reusables/github-actions/actions-on-examples.md b/translations/zh-CN/data/reusables/github-actions/actions-on-examples.md
index 0eae70aab0cf..21cfadcdcd91 100644
--- a/translations/zh-CN/data/reusables/github-actions/actions-on-examples.md
+++ b/translations/zh-CN/data/reusables/github-actions/actions-on-examples.md
@@ -1,14 +1,14 @@
 ##### **使用单一事件的示例**
 
 ```yaml
-# Trigger on push
+# Triggered when code is pushed to any branch in a repository
 on: push
 ```
 
 ##### **使用事件列表的示例**
 
 ```yaml
-# Trigger the workflow on push or pull request
+# Triggers the workflow on push or pull request events
 on: [push, pull_request]
 ```
 
@@ -18,13 +18,13 @@ on: [push, pull_request]
 
 
    on:
   # Trigger the workflow on push or pull request,
-  # but only for the master branch
+  # but only for the main branch
   push:
     branches:
-      - master
+      - main
   pull_request:
     branches:
-      - master
+      - main
   # Also trigger on page_build, as well as release created events
   page_build:
   release:
diff --git a/translations/zh-CN/data/reusables/github-actions/actions-unused-labels.md b/translations/zh-CN/data/reusables/github-actions/actions-unused-labels.md
index a6ca6bef1499..cd9a17a1f25a 100644
--- a/translations/zh-CN/data/reusables/github-actions/actions-unused-labels.md
+++ b/translations/zh-CN/data/reusables/github-actions/actions-unused-labels.md
@@ -1 +1 @@
- 未分配给运行器的任何未使用标签将在 24 小时内被自动删除。
\ No newline at end of file
+ 未分配给运行器的任何未使用标签将在 24 小时内被自动删除。
diff --git a/translations/zh-CN/data/reusables/github-actions/artifact-log-retention-statement.md b/translations/zh-CN/data/reusables/github-actions/artifact-log-retention-statement.md
new file mode 100644
index 000000000000..1109967df33c
--- /dev/null
+++ b/translations/zh-CN/data/reusables/github-actions/artifact-log-retention-statement.md
@@ -0,0 +1,2 @@
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} By default, {% data variables.product.product_name %} stores build logs and artifacts for 90 days, and this retention period can be customized. For more information, see "[Usage limits, billing, and administration](/actions/reference/usage-limits-billing-and-administration#artifact-and-log-retention-policy)".{% endif %}
+{% if currentVersion == "enterprise-server@2.22" %} {% data variables.product.product_name %} stores full build logs and artifacts for 90 days.{% endif %}
diff --git a/translations/zh-CN/data/reusables/github-actions/branch-requirement.md b/translations/zh-CN/data/reusables/github-actions/branch-requirement.md
index b708883ceb3d..b8be9a7d5365 100644
--- a/translations/zh-CN/data/reusables/github-actions/branch-requirement.md
+++ b/translations/zh-CN/data/reusables/github-actions/branch-requirement.md
@@ -1,5 +1,5 @@
 {% note %}
 
-**注：**仅当工作流程文件在 `master` 或默认分支上时，此事件才会触发工作流程运行。
+**Note:** This event will only trigger a workflow run if the workflow file is on the default branch.
 
 {% endnote %}
diff --git a/translations/zh-CN/data/reusables/github-actions/change-retention-period-for-artifacts-logs.md b/translations/zh-CN/data/reusables/github-actions/change-retention-period-for-artifacts-logs.md
new file mode 100644
index 000000000000..19398bca6ab8
--- /dev/null
+++ b/translations/zh-CN/data/reusables/github-actions/change-retention-period-for-artifacts-logs.md
@@ -0,0 +1,2 @@
+1. Under **Artifact and log retention duration**, enter a new value.
+1. Click **Save** to apply the change.
\ No newline at end of file
diff --git a/translations/zh-CN/data/reusables/github-actions/disabled-actions-description.md b/translations/zh-CN/data/reusables/github-actions/disabled-actions-description.md
index d5f6632eb1ad..30628c628411 100644
--- a/translations/zh-CN/data/reusables/github-actions/disabled-actions-description.md
+++ b/translations/zh-CN/data/reusables/github-actions/disabled-actions-description.md
@@ -1 +1 @@
-禁用 {% data variables.product.prodname_actions %} 时，仓库中不会运行任何工作流程。
\ No newline at end of file
+禁用 {% data variables.product.prodname_actions %} 时，仓库中不会运行任何工作流程。
diff --git a/translations/zh-CN/data/reusables/github-actions/disabling-github-actions.md b/translations/zh-CN/data/reusables/github-actions/disabling-github-actions.md
index 9344146d57e7..3958c5889f8a 100644
--- a/translations/zh-CN/data/reusables/github-actions/disabling-github-actions.md
+++ b/translations/zh-CN/data/reusables/github-actions/disabling-github-actions.md
@@ -1 +1 @@
-By default, {% if currentVersion ver_gt "enterprise-server@2.21" %}after {% data variables.product.prodname_actions %} is enabled on {% data variables.product.product_location %}, it{% else if if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_actions %}{% endif %} is enabled on all repositories and organizations. You can choose to disable {% data variables.product.prodname_actions %} or limit them to private actions only, which means that people can only use actions that exist in your repository.
+By default, {% if currentVersion ver_gt "enterprise-server@2.21" %}after {% data variables.product.prodname_actions %} is enabled on {% data variables.product.product_location %}, it{% else if if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_actions %}{% endif %} is enabled on all repositories and organizations. 您可以选择禁用 {% data variables.product.prodname_actions %} 或将其限制为私有操作，这意味着人们只能使用仓库中存在的操作。
diff --git a/translations/zh-CN/data/reusables/github-actions/docker-container-os-support.md b/translations/zh-CN/data/reusables/github-actions/docker-container-os-support.md
index 947967e31c94..dcbb35548c44 100644
--- a/translations/zh-CN/data/reusables/github-actions/docker-container-os-support.md
+++ b/translations/zh-CN/data/reusables/github-actions/docker-container-os-support.md
@@ -2,7 +2,7 @@
 
 **注：**如果您的工作流程使用 Docker 容器操作或服务容器，则必须使用 Linux 运行器：
 
-* 如果您要使用 {% data variables.product.prodname_dotcom %} 托管的运行器，则必须使用 `ubuntu-latest` 运行器。
+* If you are using {% data variables.product.prodname_dotcom %}-hosted runners, you must use an Ubuntu runner.
 * 如果您要使用自托管运行器，则必须使用 Linux 机器作为运行器，并且必须安装 Docker。
 
 {% endnote %}
diff --git a/translations/zh-CN/data/reusables/github-actions/dockerfile-guidelines.md b/translations/zh-CN/data/reusables/github-actions/dockerfile-guidelines.md
index b9c2abaae13d..af8653a3bdf4 100644
--- a/translations/zh-CN/data/reusables/github-actions/dockerfile-guidelines.md
+++ b/translations/zh-CN/data/reusables/github-actions/dockerfile-guidelines.md
@@ -1,3 +1,3 @@
 1. 在操作的自述文件中记录必要的参数，并在 `CMD` 指令的中忽略它们。
 1. 使用默认值，允许不指定任何 `args` 即可使用操作。
-1. 如果操作显示 `--help` 标记或类似项，请使用它让您的操作能够自行记录。
\ No newline at end of file
+1. 如果操作显示 `--help` 标记或类似项，请使用它让您的操作能够自行记录。
diff --git a/translations/zh-CN/data/reusables/github-actions/enabled-actions-description.md b/translations/zh-CN/data/reusables/github-actions/enabled-actions-description.md
index 61e71905762b..d0243d646c68 100644
--- a/translations/zh-CN/data/reusables/github-actions/enabled-actions-description.md
+++ b/translations/zh-CN/data/reusables/github-actions/enabled-actions-description.md
@@ -1 +1 @@
-当您启用 {% data variables.product.prodname_actions %} 时，工作流程能够运行位于您的仓库和任何其他公共仓库中的操作。
\ No newline at end of file
+当您启用 {% data variables.product.prodname_actions %} 时，工作流程能够运行位于您的仓库和任何其他公共仓库中的操作。
diff --git a/translations/zh-CN/data/reusables/github-actions/enabled-local-github-actions.md b/translations/zh-CN/data/reusables/github-actions/enabled-local-github-actions.md
index 54824540259d..e63043fb1e35 100644
--- a/translations/zh-CN/data/reusables/github-actions/enabled-local-github-actions.md
+++ b/translations/zh-CN/data/reusables/github-actions/enabled-local-github-actions.md
@@ -1 +1 @@
-当您仅启用本地操作时，工作流程只能运行位于您的仓库或组织中的操作。
\ No newline at end of file
+当您仅启用本地操作时，工作流程只能运行位于您的仓库或组织中的操作。
diff --git a/translations/zh-CN/data/reusables/github-actions/expression-syntax-if.md b/translations/zh-CN/data/reusables/github-actions/expression-syntax-if.md
index f0ee82593065..4087ee1b4417 100644
--- a/translations/zh-CN/data/reusables/github-actions/expression-syntax-if.md
+++ b/translations/zh-CN/data/reusables/github-actions/expression-syntax-if.md
@@ -1 +1 @@
-在 `if` 条件下使用表达式时，可以省略表达式语法 ({% raw %}`${{ }}`{% endraw %})，因为 {% data variables.product.prodname_dotcom %} 会自动将 `if` 条件作为表达式求值。
\ No newline at end of file
+在 `if` 条件下使用表达式时，可以省略表达式语法 ({% raw %}`${{ }}`{% endraw %})，因为 {% data variables.product.prodname_dotcom %} 会自动将 `if` 条件作为表达式求值。
diff --git a/translations/zh-CN/data/reusables/github-actions/gradle-workflow-steps.md b/translations/zh-CN/data/reusables/github-actions/gradle-workflow-steps.md
index 06258501989d..eed8c32df5f0 100644
--- a/translations/zh-CN/data/reusables/github-actions/gradle-workflow-steps.md
+++ b/translations/zh-CN/data/reusables/github-actions/gradle-workflow-steps.md
@@ -1,4 +1,4 @@
 此工作流程执行以下步骤：
 
 1. 检出项目仓库的副本。
-1. 设置 Java JDK。
\ No newline at end of file
+1. 设置 Java JDK。
diff --git a/translations/zh-CN/data/reusables/github-actions/permissions-statement-secrets-api.md b/translations/zh-CN/data/reusables/github-actions/permissions-statement-secrets-api.md
index ac9a392f2e6d..4257da89260f 100644
--- a/translations/zh-CN/data/reusables/github-actions/permissions-statement-secrets-api.md
+++ b/translations/zh-CN/data/reusables/github-actions/permissions-statement-secrets-api.md
@@ -1 +1 @@
-要使用 REST API 创建密码，必须对仓库具有写入权限。 For more information, see "[{% data variables.product.prodname_actions %} secrets API](/v3/actions/secrets/)."
+To create secrets using the REST API, you must have write access to the repository or admin access to the organization. 更多信息请参阅“[{% data variables.product.prodname_actions %} 密码 API](/v3/actions/secrets/)”。
diff --git a/translations/zh-CN/data/reusables/github-actions/permissions-statement-secrets-organization.md b/translations/zh-CN/data/reusables/github-actions/permissions-statement-secrets-organization.md
index fef27444157f..81aee8c9b013 100644
--- a/translations/zh-CN/data/reusables/github-actions/permissions-statement-secrets-organization.md
+++ b/translations/zh-CN/data/reusables/github-actions/permissions-statement-secrets-organization.md
@@ -1 +1 @@
-要在组织级别创建密码，必须具有`管理员`访问权限。 
\ No newline at end of file
+要在组织级别创建密码，必须具有`管理员`访问权限。 
diff --git a/translations/zh-CN/data/reusables/github-actions/permissions-statement-secrets-repository.md b/translations/zh-CN/data/reusables/github-actions/permissions-statement-secrets-repository.md
index b16b6aabeffc..95e8a4423caf 100644
--- a/translations/zh-CN/data/reusables/github-actions/permissions-statement-secrets-repository.md
+++ b/translations/zh-CN/data/reusables/github-actions/permissions-statement-secrets-repository.md
@@ -1 +1 @@
-要为用户帐户仓库创建密码，您必须是仓库所有者。 要为组织仓库创建密码，您必须具有`管理员`访问权限。
\ No newline at end of file
+要为用户帐户仓库创建密码，您必须是仓库所有者。 要为组织仓库创建密码，您必须具有`管理员`访问权限。
diff --git a/translations/zh-CN/data/reusables/github-actions/private-repository-forks-configure.md b/translations/zh-CN/data/reusables/github-actions/private-repository-forks-configure.md
index 3847d36a536b..8a7e736ca21a 100644
--- a/translations/zh-CN/data/reusables/github-actions/private-repository-forks-configure.md
+++ b/translations/zh-CN/data/reusables/github-actions/private-repository-forks-configure.md
@@ -1,2 +1,2 @@
-1. Under **Fork pull request workflows**, select your options. 例如： ![启用、禁用或限制此仓库的操作](/assets/images/help/settings/actions-fork-pull-request-workflows.png)
-1. Click **Save** to apply the settings.
+1. 在 **Fork pull request workflows（复刻拉取请求工作流程）**下，选择您的选项。 例如： ![启用、禁用或限制此仓库的操作](/assets/images/help/settings/actions-fork-pull-request-workflows.png)
+1. 单击 **Save（保存）**以应用设置。
diff --git a/translations/zh-CN/data/reusables/github-actions/private-repository-forks-overview.md b/translations/zh-CN/data/reusables/github-actions/private-repository-forks-overview.md
index d976a281d09a..2372a7392c0d 100644
--- a/translations/zh-CN/data/reusables/github-actions/private-repository-forks-overview.md
+++ b/translations/zh-CN/data/reusables/github-actions/private-repository-forks-overview.md
@@ -1,5 +1,5 @@
-If you rely on using forks of your private repositories, you can configure policies that control how users can run workflows on `pull_request` events. Available to private repositories only, you can configure these policy settings for enterprises, organizations, or repositories. For enterprises, the policies are applied to all repositories in all organizations.
+如果您依赖于使用私有仓库的复刻，您可以配置策略来控制用户如何在 `pull_request` 事件上运行工作流程。 （仅适用于私有仓库）您可以为企业、组织或仓库配置这些策略设置。 对于企业，该策略将应用到所有组织中的所有仓库。
 
-- **Run workflows from fork pull requests** - Allows users to run workflows from fork pull requests, using a `GITHUB_TOKEN` with read-only permission, and with no access to secrets.
-- **Send write tokens to workflows from pull requests** - Allows pull requests from forks to use a `GITHUB_TOKEN` with write permission.
-- **Send secrets to workflows from pull requests** - Makes all secrets available to the pull request.
\ No newline at end of file
+- **Run workflows from fork pull requests（从复刻拉取请求运行工作流程）** - 允许用户使用具有只读权限、没有密码访问权限的 `GITHUB_TOKEN`从复刻拉取请求运行工作流程。
+- **Send write tokens to workflows from pull requests（从拉取请求向工作流程发送写入令牌）** - 允许从复刻拉取请求以使用具有写入权限的 `GITHUB_TOKEN`。
+- **Send secrets to workflows from pull requests（从拉取请求向工作流程发送密码）** - 使所有密码可用于拉取请求。
diff --git a/translations/zh-CN/data/reusables/github-actions/publish-to-maven-workflow-step.md b/translations/zh-CN/data/reusables/github-actions/publish-to-maven-workflow-step.md
index ff0d39533672..265f72171235 100644
--- a/translations/zh-CN/data/reusables/github-actions/publish-to-maven-workflow-step.md
+++ b/translations/zh-CN/data/reusables/github-actions/publish-to-maven-workflow-step.md
@@ -1 +1 @@
-运行 `mvn -B deploy` 命令以发布到 `ossrh` 仓库。 `MAVEN_USERNAME` 环境变量将使用 `OSSRH_USERNAME` 密码的内容设置，而 `MAVEN_PASSWORD` 环境变量将使用 `OSSRH_TOKEN` 密码的内容设置。
\ No newline at end of file
+运行 `mvn -B deploy` 命令以发布到 `ossrh` 仓库。 `MAVEN_USERNAME` 环境变量将使用 `OSSRH_USERNAME` 密码的内容设置，而 `MAVEN_PASSWORD` 环境变量将使用 `OSSRH_TOKEN` 密码的内容设置。
diff --git a/translations/zh-CN/data/reusables/github-actions/publish-to-packages-workflow-step.md b/translations/zh-CN/data/reusables/github-actions/publish-to-packages-workflow-step.md
index 0a8a4e17a2eb..cce03eee8dd7 100644
--- a/translations/zh-CN/data/reusables/github-actions/publish-to-packages-workflow-step.md
+++ b/translations/zh-CN/data/reusables/github-actions/publish-to-packages-workflow-step.md
@@ -1 +1 @@
-运行 `mvn -B deploy` 命令以发布到 {% data variables.product.prodname_registry %}。 `GITHUB_TOKEN` 环境变量将使用 `GITHUB_TOKEN` 密码的内容设置。
\ No newline at end of file
+运行 `mvn -B deploy` 命令以发布到 {% data variables.product.prodname_registry %}。 `GITHUB_TOKEN` 环境变量将使用 `GITHUB_TOKEN` 密码的内容设置。
diff --git a/translations/zh-CN/data/reusables/github-actions/publishing-java-packages-intro.md b/translations/zh-CN/data/reusables/github-actions/publishing-java-packages-intro.md
index 0216673994e2..8ef86d6cc98c 100644
--- a/translations/zh-CN/data/reusables/github-actions/publishing-java-packages-intro.md
+++ b/translations/zh-CN/data/reusables/github-actions/publishing-java-packages-intro.md
@@ -1 +1 @@
-本指南介绍如何创建将 Java 包发布到 {% data variables.product.prodname_registry %} 和 Maven Central 仓库的工作流程。 通过单个工作流程，您可以将包发布到一个或多个仓库。
\ No newline at end of file
+本指南介绍如何创建将 Java 包发布到 {% data variables.product.prodname_registry %} 和 Maven Central 仓库的工作流程。 通过单个工作流程，您可以将包发布到一个或多个仓库。
diff --git a/translations/zh-CN/data/reusables/github-actions/run_id_description.md b/translations/zh-CN/data/reusables/github-actions/run_id_description.md
index 66e72f16802c..b3d437776b9a 100644
--- a/translations/zh-CN/data/reusables/github-actions/run_id_description.md
+++ b/translations/zh-CN/data/reusables/github-actions/run_id_description.md
@@ -1 +1 @@
-仓库中每个运行的唯一编号。 如果您重新执行工作流程运行，此编号不变。
\ No newline at end of file
+仓库中每个运行的唯一编号。 如果您重新执行工作流程运行，此编号不变。
diff --git a/translations/zh-CN/data/reusables/github-actions/run_number_description.md b/translations/zh-CN/data/reusables/github-actions/run_number_description.md
index b31cec19867d..007f3a0ab28f 100644
--- a/translations/zh-CN/data/reusables/github-actions/run_number_description.md
+++ b/translations/zh-CN/data/reusables/github-actions/run_number_description.md
@@ -1 +1 @@
-仓库中特定工作流程每个运行的唯一编号。 此编号从 1（对应于工作流程的第一个运行）开始，然后随着每个新的运行而递增。 如果您重新执行工作流程运行，此编号不变。
\ No newline at end of file
+仓库中特定工作流程每个运行的唯一编号。 此编号从 1（对应于工作流程的第一个运行）开始，然后随着每个新的运行而递增。 如果您重新执行工作流程运行，此编号不变。
diff --git a/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md b/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md
index 41b7dc6a2ef3..39aecaf8b4dd 100644
--- a/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md
+++ b/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md
@@ -1,2 +1,2 @@
-1. In the **Self-hosted runners** section of the settings page, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} next to the runner group you'd like to configure, then click **Edit name and [organization|repository] access**. ![管理仓库权限](/assets/images/help/settings/actions-runner-manage-permissions.png)
-1. Select a new policy from the dropdown list, or modify the runner group name.
\ No newline at end of file
+1. 在设置页面的 **Self-hosted runners（自托管运行器）**部分，单击要配置的运行器组旁边的 {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}，然后单击 **Edit name and [organization|repository] access（编辑名称和[组织|仓库]权限）**。 ![管理仓库权限](/assets/images/help/settings/actions-runner-manage-permissions.png)
+1. 从下拉列表中选择一个新策略，或修改运行器组名称。
diff --git a/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-labels-view-assigned-labels.md b/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-labels-view-assigned-labels.md
index 93a3db256108..e4707b7bc77b 100644
--- a/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-labels-view-assigned-labels.md
+++ b/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-labels-view-assigned-labels.md
@@ -1 +1 @@
-1. Locate the runner you want to update, and click {% octicon "triangle-down" aria-label="The downward triangle" %} to view the label selection menu. 此菜单显示您的自托管运行器可用的所有自定义标签。 已分配给自托管运行器的标签旁边有 {% octicon "check" aria-label="Check mark" %}。 ![更改运行器标签](/assets/images/help/settings/actions-runner-list-label.png)
+1. 找到要更新的运行器，然后单击 {% octicon "triangle-down" aria-label="The downward triangle" %} 以查看标签选择菜单。 此菜单显示您的自托管运行器可用的所有自定义标签。 已分配给自托管运行器的标签旁边有 {% octicon "check" aria-label="Check mark" %}。 ![更改运行器标签](/assets/images/help/settings/actions-runner-list-label.png)
diff --git a/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-list-group.md b/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-list-group.md
index b86a8be047bc..5702e4df6d35 100644
--- a/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-list-group.md
+++ b/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-list-group.md
@@ -1 +1 @@
-1. If your runner is in a group, locate the runner group and click {% octicon "chevron-down" aria-label="The downward chevron" %} to view the list of runners. ![List runner group](/assets/images/help/settings/actions-org-enterprise-list-group-runners.png)
\ No newline at end of file
+1. 如果您的运行器在一个组中，请找到该运行器组，然后单击 {% octicon "chevron-down" aria-label="The downward chevron" %} 以查看运行器列表。 ![列出运行器组](/assets/images/help/settings/actions-org-enterprise-list-group-runners.png)
diff --git a/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-list.md b/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-list.md
index 315f976b7614..ea46d87c9c86 100644
--- a/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-list.md
+++ b/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-list.md
@@ -1 +1 @@
- 1. Locate the list of runners under "Self-hosted runners".
\ No newline at end of file
+ 1. 在“Self-hosted runners（自托管运行器）”下找到运行器列表。
diff --git a/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-management-permissions-required.md b/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-management-permissions-required.md
index de63039df8cd..156689486479 100644
--- a/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-management-permissions-required.md
+++ b/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-management-permissions-required.md
@@ -1,9 +1,9 @@
-自托管运行器可位于 {% data variables.product.prodname_dotcom %} 的组织或仓库设置中。 要管理自托管运行器，您必须拥有以下权限，具体取决于添加自托管运行器的位置：
-- **User repository**: You must be the repository owner.
-- **Organization**: You must be an organization owner.
-- **Organization repository**: You must be an organization owner, or have admin access to the repository.
+A self-hosted runner can be located in either your repository, organization, or {% if currentVersion == "free-pro-team@latest" %}enterprise account settings on {% data variables.product.prodname_dotcom %}{% else if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %} enterprise settings on {% data variables.product.product_location %}{% endif %}. 要管理自托管运行器，您必须拥有以下权限，具体取决于添加自托管运行器的位置：
+- **用户仓库**：您必须是仓库所有者。
+- **组织**：您必须是组织所有者。
+- **组织仓库**：您必须是组织所有者或者拥有该仓库的管理员权限。
 {% if currentVersion == "free-pro-team@latest" %}
-- **Enterprise account**: You must be an enterprise owner.
+- **企业账户**：您必须是企业所有者。
 {% else if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %}
-- **Enterprise**: You must be a {% data variables.product.prodname_enterprise %} site administrator.
+- **企业**：您必须是 {% data variables.product.prodname_enterprise %} 站点管理员。
 {% endif %}
diff --git a/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-navigate-repo-and-org.md b/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-navigate-repo-and-org.md
index 08f73bd54236..4022a2b2ab27 100644
--- a/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-navigate-repo-and-org.md
+++ b/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-navigate-repo-and-org.md
@@ -1 +1 @@
-1. 在组织或仓库中，导航到主页并单击 {% octicon "gear" aria-label="The Settings gear" %} **Settings（设置）**。
\ No newline at end of file
+1. 在组织或仓库中，导航到主页并单击 {% octicon "gear" aria-label="The Settings gear" %} **Settings（设置）**。
diff --git a/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-navigate-to-repo-org-enterprise.md b/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-navigate-to-repo-org-enterprise.md
index 6da13787d6a8..c2a0770b29e4 100644
--- a/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-navigate-to-repo-org-enterprise.md
+++ b/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-navigate-to-repo-org-enterprise.md
@@ -1,12 +1,12 @@
-1. Navigate to where your self-hosted runner is registered:
-   * **In an organization or repository**: navigate to the main page and click {% octicon "gear" aria-label="The Settings gear" %} **Settings**.
+1. 导航到自托管运行器注册的位置：
+   * **在组织或仓库中**，导航到主页并单击 {% octicon "gear" aria-label="The Settings gear" %} **Settings（设置）**。
    * {% if currentVersion == "free-pro-team@latest" %}**If using an enterprise account**: navigate to your enterprise account by visiting `https://github.com/enterprises/ENTERPRISE-NAME`, replacing `ENTERPRISE-NAME` with your enterprise account's name.{% else if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %}**If using an enterprise-level runner**:
 
      1. 在任何页面的右上角，单击 {% octicon "rocket" aria-label="The rocket ship" %}。
-     1. In the left sidebar, click **Enterprise overview**.
-     1. {% endif %} In the enterprise sidebar, {% octicon "law" aria-label="The law icon" %} **Policies**.
-1. Navigate to the {% data variables.product.prodname_actions %} settings:
-   * **In an organization or repository**: click **Actions** in the left sidebar.
+     1. 在左边栏中，单击 **Enterprise overview（企业概览）**。
+     1. {% endif %} 在企业边栏中，单击 {% octicon "law" aria-label="The law icon" %} **Policies（政策）**。
+1. 导航到 {% data variables.product.prodname_actions %} 设置：
+   * **在组织或仓库中**：单击左边栏中的 **Actions（操作）**。
 
      ![操作设置](/assets/images/help/settings/settings-sidebar-actions.png)
    * {% if currentVersion == "free-pro-team@latest" %}**If using an enterprise account**{% else if currentVersion != "free-pro-team@latest" and currentVersion ver_gt "enterprise-server@2.21" %}**If using an enterprise-level runner**{% endif %}: click **Actions** under "{% octicon "law" aria-label="The law icon" %} Policies".
diff --git a/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-removal-impact.md b/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-removal-impact.md
index 0dc8b76ddd78..83d8805dab11 100644
--- a/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-removal-impact.md
+++ b/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-removal-impact.md
@@ -1 +1 @@
-此程序将永久删除自托管运行器。 如果您只想暂停运行器执行分配的作业，可以关闭机器或停止 `run` 应用程序。 运行器仍将保持“离线”状态，在您使用 `run` 应用程序重新启动运行器之前，将不会执行任何作业。
\ No newline at end of file
+此程序将永久删除自托管运行器。 如果您只想暂停运行器执行分配的作业，可以关闭机器或停止 `run` 应用程序。 运行器仍将保持“离线”状态，在您使用 `run` 应用程序重新启动运行器之前，将不会执行任何作业。
diff --git a/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-removing-a-runner.md b/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-removing-a-runner.md
index 39ee94127353..f070c7af110b 100644
--- a/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-removing-a-runner.md
+++ b/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-removing-a-runner.md
@@ -1,5 +1,5 @@
-1. Under **Self-hosted runners**, locate the runner in the list. If your runner is in a group, click {% octicon "chevron-down" aria-label="The downwards chevron" %} to expand the list.
-1. Click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} next to the runner you want to remove, then click **Remove**.
+1. 在 **Self-hosted runners（自托管运行器）**下，找到列表中的运行器。 如果您的运行器在一个组中，请单击 {% octicon "chevron-down" aria-label="The downwards chevron" %} 以展开列表。
+1. 单击要删除的运行器旁边的 {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}，然后单击 **Remove（删除）**。
 
     ![删除自托管运行器设置](/assets/images/help/settings/actions-runner-remove.png)
 1. 您将看到删除自托管运行器的说明。 完成以下任一步骤来删除运行器，具体取决于它是否仍然可以访问：
diff --git a/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-reusing.md b/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-reusing.md
index 0435ac7bb9ec..ee0dbfec9544 100644
--- a/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-reusing.md
+++ b/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-reusing.md
@@ -1 +1 @@
-Alternatively, if you don't have access to the repository, organization, or enterprise on {% data variables.product.product_name %} to remove a runner, but you would like to re-use the runner machine, then you can delete the `.runner` file inside the self-hosted runner application directory. This allows the runner to be registered without having to re-download the self-hosted runner application.
\ No newline at end of file
+或者，如果您无法访问 {% data variables.product.product_name %} 上的仓库、组织或企业来删除运行器，但您想重新使用该运行器机器，则可删除自托管运行器应用程序目录中的 `.runner` 文件。 这允许将运行器注册，而无需重新下载自托管的运行器应用程序。
diff --git a/translations/zh-CN/data/reusables/github-actions/sidebar-secret.md b/translations/zh-CN/data/reusables/github-actions/sidebar-secret.md
index a5e403addb62..011cc0a84b31 100644
--- a/translations/zh-CN/data/reusables/github-actions/sidebar-secret.md
+++ b/translations/zh-CN/data/reusables/github-actions/sidebar-secret.md
@@ -1 +1 @@
-1. 在左侧边栏中，单击 **Secrets（密码）**。
\ No newline at end of file
+1. 在左侧边栏中，单击 **Secrets（密码）**。
diff --git a/translations/zh-CN/data/reusables/github-actions/usage-api-requests.md b/translations/zh-CN/data/reusables/github-actions/usage-api-requests.md
new file mode 100644
index 000000000000..07a900270e8c
--- /dev/null
+++ b/translations/zh-CN/data/reusables/github-actions/usage-api-requests.md
@@ -0,0 +1 @@
+- **API 请求** - 在一个仓库的所有操作中，一个小时内最多可执行 1000 个 API 请求。 如果超出，额外的 API 调用将失败，这可能导致作业失败。
diff --git a/translations/zh-CN/data/reusables/github-actions/usage-matrix-limits.md b/translations/zh-CN/data/reusables/github-actions/usage-matrix-limits.md
new file mode 100644
index 000000000000..a0391421ced7
--- /dev/null
+++ b/translations/zh-CN/data/reusables/github-actions/usage-matrix-limits.md
@@ -0,0 +1 @@
+- **Job matrix** - A job matrix can generate a maximum of 256 jobs per workflow run. 此限制也适用于自托管运行器。
diff --git a/translations/zh-CN/data/reusables/github-actions/usage-workflow-run-time.md b/translations/zh-CN/data/reusables/github-actions/usage-workflow-run-time.md
new file mode 100644
index 000000000000..03687c327a9e
--- /dev/null
+++ b/translations/zh-CN/data/reusables/github-actions/usage-workflow-run-time.md
@@ -0,0 +1 @@
+- **工作流程运行时间** - 每个工作流程的运行时限为 72 小时。 如果工作流程运行时间达到此限制，其运行将被取消。
diff --git a/translations/zh-CN/data/reusables/github-insights/choose-key-metric.md b/translations/zh-CN/data/reusables/github-insights/choose-key-metric.md
index 98efd0c31ca0..bd1b92a69157 100644
--- a/translations/zh-CN/data/reusables/github-insights/choose-key-metric.md
+++ b/translations/zh-CN/data/reusables/github-insights/choose-key-metric.md
@@ -1 +1 @@
-2. 在 **{% octicon "graph" aria-label="The graph icon" %} Key metrics（关键指标）**下，单击您想要查看的指标名称。 ![关键指标列表](/assets/images/help/insights/key-metrics-list.png)
\ No newline at end of file
+2. 在 **{% octicon "graph" aria-label="The graph icon" %} Key metrics（关键指标）**下，单击您想要查看的指标名称。 ![关键指标列表](/assets/images/help/insights/key-metrics-list.png)
diff --git a/translations/zh-CN/data/reusables/github-insights/enterprise-api-url.md b/translations/zh-CN/data/reusables/github-insights/enterprise-api-url.md
index 58750a98d1e6..a74d33173cfc 100644
--- a/translations/zh-CN/data/reusables/github-insights/enterprise-api-url.md
+++ b/translations/zh-CN/data/reusables/github-insights/enterprise-api-url.md
@@ -1 +1 @@
-1. 在“{% data variables.product.prodname_dotcom %} API URL”下，输入 {% if currentVersion == "free-pro-team@latest" %}https://api.github.com {% else %}用来访问 {% data variables.product.prodname_enterprise %} 的 URL{% endif %}。 ![{% data variables.product.prodname_enterprise %} API URL 字段](/assets/images/help/insights/enterprise-api-url.png)
+1. Under "{% data variables.product.prodname_dotcom %} API URL", type {% if currentVersion == "free-pro-team@latest" %}https://api.github.com {% else %}the URL you use to access {% data variables.product.prodname_enterprise %}{% endif %}. ![{% data variables.product.prodname_enterprise %} API URL 字段](/assets/images/help/insights/enterprise-api-url.png)
diff --git a/translations/zh-CN/data/reusables/github-insights/navigate-to-key-metrics.md b/translations/zh-CN/data/reusables/github-insights/navigate-to-key-metrics.md
index 144f582293ab..f07e672b75bd 100644
--- a/translations/zh-CN/data/reusables/github-insights/navigate-to-key-metrics.md
+++ b/translations/zh-CN/data/reusables/github-insights/navigate-to-key-metrics.md
@@ -1 +1 @@
-1. 在 {% data variables.product.prodname_insights %} 中，单击 **{% octicon "graph" aria-label="The graph icon" %} Key metrics（关键指标）**。 ![Key metrics（关键指标）选项卡](/assets/images/help/insights/key-metrics-tab.png)
\ No newline at end of file
+1. 在 {% data variables.product.prodname_insights %} 中，单击 **{% octicon "graph" aria-label="The graph icon" %} Key metrics（关键指标）**。 ![Key metrics（关键指标）选项卡](/assets/images/help/insights/key-metrics-tab.png)
diff --git a/translations/zh-CN/data/reusables/gpg/private-email.md b/translations/zh-CN/data/reusables/gpg/private-email.md
index f9c064322942..15ea1833856c 100644
--- a/translations/zh-CN/data/reusables/gpg/private-email.md
+++ b/translations/zh-CN/data/reusables/gpg/private-email.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-要对电子邮件地址保密，请使用 {% data variables.product.product_name %} 提供的 `no-reply` 电子邮件地址。
+To keep your email address private, use your
+{% data variables.product.product_name %}-provided `no-reply` email address.
 {% endif %}
diff --git a/translations/zh-CN/data/reusables/identity-and-permissions/enable-team-sync-azure.md b/translations/zh-CN/data/reusables/identity-and-permissions/enable-team-sync-azure.md
index 65671684d5f3..f8bdd9fa5736 100644
--- a/translations/zh-CN/data/reusables/identity-and-permissions/enable-team-sync-azure.md
+++ b/translations/zh-CN/data/reusables/identity-and-permissions/enable-team-sync-azure.md
@@ -1 +1 @@
-1. 在“Team synchronization（团队同步）”下，单击 **Enable for Azure AD（为 Azure AD 启用）**。 ![安全设置页面上的启用团队同步按钮](/assets/images/help/teams/enable-team-synchronization.png)
\ No newline at end of file
+1. 在“Team synchronization（团队同步）”下，单击 **Enable for Azure AD（为 Azure AD 启用）**。 ![安全设置页面上的启用团队同步按钮](/assets/images/help/teams/enable-team-synchronization.png)
diff --git a/translations/zh-CN/data/reusables/identity-and-permissions/enable-team-sync-okta.md b/translations/zh-CN/data/reusables/identity-and-permissions/enable-team-sync-okta.md
index c45d9c759b57..03906e880808 100644
--- a/translations/zh-CN/data/reusables/identity-and-permissions/enable-team-sync-okta.md
+++ b/translations/zh-CN/data/reusables/identity-and-permissions/enable-team-sync-okta.md
@@ -1 +1 @@
-1. 在“Team synchronization（团队同步）”下，单击 **Enable for Okta（为 Okta 启用）**。 ![安全设置页面上的启用 Okta 团队同步按钮](/assets/images/help/teams/enable-team-synchronization-okta.png)
\ No newline at end of file
+1. 在“Team synchronization（团队同步）”下，单击 **Enable for Okta（为 Okta 启用）**。 ![安全设置页面上的启用 Okta 团队同步按钮](/assets/images/help/teams/enable-team-synchronization-okta.png)
diff --git a/translations/zh-CN/data/reusables/identity-and-permissions/supported-idps-team-sync.md b/translations/zh-CN/data/reusables/identity-and-permissions/supported-idps-team-sync.md
index 23962f0019b5..1d2a11ae5a06 100644
--- a/translations/zh-CN/data/reusables/identity-and-permissions/supported-idps-team-sync.md
+++ b/translations/zh-CN/data/reusables/identity-and-permissions/supported-idps-team-sync.md
@@ -1,3 +1,3 @@
 您可以将团队同步与受支持的 IdP 一起使用。
   - Azure AD
-  - Okta
\ No newline at end of file
+  - Okta
diff --git a/translations/zh-CN/data/reusables/identity-and-permissions/sync-team-with-idp-group.md b/translations/zh-CN/data/reusables/identity-and-permissions/sync-team-with-idp-group.md
index 2b8bfa30a1a0..564327527eeb 100644
--- a/translations/zh-CN/data/reusables/identity-and-permissions/sync-team-with-idp-group.md
+++ b/translations/zh-CN/data/reusables/identity-and-permissions/sync-team-with-idp-group.md
@@ -1 +1 @@
-启用团队同步后，团队维护员和组织所有者可在 {% data variables.product.prodname_dotcom %} 上或通过 API 将团队连接至 IdP 组。 For more information, see "[Synchronizing a team with an identity provider group](/github/setting-up-and-managing-organizations-and-teams/synchronizing-a-team-with-an-identity-provider-group)" and "[Team synchronization](/v3/teams/team_sync/)."
\ No newline at end of file
+启用团队同步后，团队维护员和组织所有者可在 {% data variables.product.prodname_dotcom %} 上或通过 API 将团队连接至 IdP 组。 更多信息请参阅“[同步团队与身份提供程序组](/github/setting-up-and-managing-organizations-and-teams/synchronizing-a-team-with-an-identity-provider-group)”和“[团队同步](/v3/teams/team_sync/)”。
diff --git a/translations/zh-CN/data/reusables/identity-and-permissions/team-sync-disable.md b/translations/zh-CN/data/reusables/identity-and-permissions/team-sync-disable.md
index d7c7645e4be3..e57e7efff371 100644
--- a/translations/zh-CN/data/reusables/identity-and-permissions/team-sync-disable.md
+++ b/translations/zh-CN/data/reusables/identity-and-permissions/team-sync-disable.md
@@ -2,4 +2,4 @@
 
 **警告：**禁用团队同步时，通过 IdP 组分配给 {% data variables.product.prodname_dotcom %} 团队的任何团队成员都将从该团队删除，并且可能失去仓库访问权限。
 
-{% endwarning %}
\ No newline at end of file
+{% endwarning %}
diff --git a/translations/zh-CN/data/reusables/identity-and-permissions/team-sync-okta-requirements.md b/translations/zh-CN/data/reusables/identity-and-permissions/team-sync-okta-requirements.md
index 93d10b3232dc..69b4e50a3adf 100644
--- a/translations/zh-CN/data/reusables/identity-and-permissions/team-sync-okta-requirements.md
+++ b/translations/zh-CN/data/reusables/identity-and-permissions/team-sync-okta-requirements.md
@@ -2,4 +2,4 @@
 
 - 使用 Okta 为组织启用 SAML SSO 和 SCIM。 更多信息请参阅“[使用 Okta 配置 SAML 单点登录和 SCIM](/github/setting-up-and-managing-organizations-and-teams/configuring-saml-single-sign-on-and-scim-using-okta)”。
 - 提供 Okta 实例的租户 URL。
-- 为安装为服务用户的 Okta 生成具有只读管理员权限的有效 SSWS 令牌。 更多信息请参阅 Okta 文档中的[创建令牌](https://developer.okta.com/docs/guides/create-an-api-token/create-the-token/)和[服务用户](https://help.okta.com/en/prod/Content/Topics/Adv_Server_Access/docs/service-users.htm)。
\ No newline at end of file
+- 为安装为服务用户的 Okta 生成具有只读管理员权限的有效 SSWS 令牌。 更多信息请参阅 Okta 文档中的[创建令牌](https://developer.okta.com/docs/guides/create-an-api-token/create-the-token/)和[服务用户](https://help.okta.com/en/prod/Content/Topics/Adv_Server_Access/docs/service-users.htm)。
diff --git a/translations/zh-CN/data/reusables/interactions/collaborator-user-limit-definition.md b/translations/zh-CN/data/reusables/interactions/collaborator-user-limit-definition.md
index 62f4c861d7f2..1b4c7e1a9928 100644
--- a/translations/zh-CN/data/reusables/interactions/collaborator-user-limit-definition.md
+++ b/translations/zh-CN/data/reusables/interactions/collaborator-user-limit-definition.md
@@ -1 +1 @@
-**Collaborators only:** When you limit interactions to `collaborators_only`, users who are not collaborators will be temporarily restricted
\ No newline at end of file
+**仅协作者：**当您将交互限制为 `collaborators_only` 时，非协作者用户将暂时受到限制。
diff --git a/translations/zh-CN/data/reusables/interactions/contributor-user-limit-definition.md b/translations/zh-CN/data/reusables/interactions/contributor-user-limit-definition.md
index 134e152c9ee9..36f7493e2dc9 100644
--- a/translations/zh-CN/data/reusables/interactions/contributor-user-limit-definition.md
+++ b/translations/zh-CN/data/reusables/interactions/contributor-user-limit-definition.md
@@ -1 +1 @@
-**Contributors only:** When you limit interactions to `contributors_only`,  users who have not previously contributed and are not collaborators will be temporarily restricted
\ No newline at end of file
+**仅参与者：**当您将交互限制为 `contributors_only`时，以前未参与并且不是协作者的用户将暂时受到限制。
diff --git a/translations/zh-CN/data/reusables/interactions/existing-user-limit-definition.md b/translations/zh-CN/data/reusables/interactions/existing-user-limit-definition.md
index 54c7d8b0b5f6..809ac69de4c0 100644
--- a/translations/zh-CN/data/reusables/interactions/existing-user-limit-definition.md
+++ b/translations/zh-CN/data/reusables/interactions/existing-user-limit-definition.md
@@ -1 +1 @@
-**Existing users:** When you limit interactions to `existing_users`, new users with accounts less than 24 hours old who have not previously contributed and are not collaborators will be temporarily restricted
\ No newline at end of file
+**现有用户：**当您将交互限制为 `existing_users`时，帐户年龄小于 24 小时、以前未参与并且不是协作者的新用户将暂时受到限制。
diff --git a/translations/zh-CN/data/reusables/interactions/interactions-detail.md b/translations/zh-CN/data/reusables/interactions/interactions-detail.md
index 95ef4c017e4f..299f62a79422 100644
--- a/translations/zh-CN/data/reusables/interactions/interactions-detail.md
+++ b/translations/zh-CN/data/reusables/interactions/interactions-detail.md
@@ -1 +1 @@
-When restrictions are enabled, only the specified group of {% data variables.product.product_name %} users will be able to participate in interactions. Restrictions expire 24 hours from the time they are set.
\ No newline at end of file
+启用限制后，只有指定的 {% data variables.product.product_name %} 用户组才能参与交互。 限制在设置后 24 小时到期。
diff --git a/translations/zh-CN/data/reusables/issue-events/assignee-properties.md b/translations/zh-CN/data/reusables/issue-events/assignee-properties.md
index e408d915e266..ef4b1a6066f9 100644
--- a/translations/zh-CN/data/reusables/issue-events/assignee-properties.md
+++ b/translations/zh-CN/data/reusables/issue-events/assignee-properties.md
@@ -1 +1 @@
-`assignee` | `object` | The person unassigned from this issue. `assigner` | `object` | The person who performed the unassignment for this issue.
\ No newline at end of file
+`assignee` | `object` | 从此议题取消分配的人。 `assigner` | `object` | 执行此议题取消分配的人。
diff --git a/translations/zh-CN/data/reusables/issue-events/issue-event-common-properties.md b/translations/zh-CN/data/reusables/issue-events/issue-event-common-properties.md
index 4e3c151bd9d9..22bf260d721e 100644
--- a/translations/zh-CN/data/reusables/issue-events/issue-event-common-properties.md
+++ b/translations/zh-CN/data/reusables/issue-events/issue-event-common-properties.md
@@ -2,9 +2,9 @@
 | ------------ | ----- | -------------------------------------------------------------------- |
 | `id`         | `整数`  | The unique identifier of the event.                                  |
 | `node_id`    | `字符串` | The [Global Node ID](/v4/guides/using-global-node-ids) of the event. |
-| `url`        | `字符串` | The REST API URL for fetching the event.                             |
+| `url`        | `字符串` | 用于提取事件的 REST API URL。                                                |
 | `actor`      | `对象`  | The person who generated the event.                                  |
-| `event`      | `字符串` | Identifies the actual type of event that occurred.                   |
-| `commit_id`  | `字符串` | The SHA of the commit that referenced this issue.                    |
-| `commit_url` | `字符串` | The GitHub REST API link to the commit that referenced this issue.   |
-| `created_at` | `字符串` | The timestamp indicating when the event occurred.                    |
\ No newline at end of file
+| `event`      | `字符串` | 识别所发生事件的实际类型。                                                        |
+| `commit_id`  | `字符串` | 引用此议题的提交的 SHA。                                                       |
+| `commit_url` | `字符串` | 指向引用此议题的提交的 GitHub REST API 链接。                                      |
+| `created_at` | `字符串` | 指示事件发生时间的时间戳。                                                        |
diff --git a/translations/zh-CN/data/reusables/issue-events/label-properties.md b/translations/zh-CN/data/reusables/issue-events/label-properties.md
index 1d616889b1a1..ae723bc1b66b 100644
--- a/translations/zh-CN/data/reusables/issue-events/label-properties.md
+++ b/translations/zh-CN/data/reusables/issue-events/label-properties.md
@@ -1 +1 @@
-`label` | `object` | The label removed from the issue `label[name]` | `string` | The name of the label. `label[color]` | `string` | The hex color code. 
\ No newline at end of file
+`label` | `object` | 从议题删除的标签 `label[name]` | `string` | 标签的名称。 `label[color]` | `string` | 十六进制颜色代码。 
diff --git a/translations/zh-CN/data/reusables/issue-events/project-card-properties.md b/translations/zh-CN/data/reusables/issue-events/project-card-properties.md
index 646b6a85b558..cb6c429a5877 100644
--- a/translations/zh-CN/data/reusables/issue-events/project-card-properties.md
+++ b/translations/zh-CN/data/reusables/issue-events/project-card-properties.md
@@ -1 +1 @@
-`project_card` | `object` | The project card object. `project_id` | `integer` | The unique identifier of the project card. `project_url` | `string` | The REST API URL to retrieve the project card. `column_name` | `string` | The name of the column the issue is in.
\ No newline at end of file
+`project_card` | `object` | 项目卡对象。 `project_id` | `integer` | 项目卡的唯一标识符。 `project_url` | `string` | 用于检索项目卡的 REST API URL。 `column_name` | `string` | 议题所在列的名称。
diff --git a/translations/zh-CN/data/reusables/issue-events/review-dismissed-properties.md b/translations/zh-CN/data/reusables/issue-events/review-dismissed-properties.md
index 9c6f67ec8671..f6914bda6fd6 100644
--- a/translations/zh-CN/data/reusables/issue-events/review-dismissed-properties.md
+++ b/translations/zh-CN/data/reusables/issue-events/review-dismissed-properties.md
@@ -1 +1 @@
-`dismissed_review` | `object` | The information for the dismissed review. `dismissed_review[state]` | `string` | The state the pull request was in when it was dismissed. Can be one of: `commented`, `approved`, or `changes_requested`. `dismissed_review[review_id]` | `string` | The unique identifier of the pull request's review. `dismissed_review[dismissal_message]` | `string` | The message the user included when dismissing the review. `dismissed_review[dismissal_commit_id]` | `string` | The unique identifier of the commit that dismissed the review if one exists.
\ No newline at end of file
+`dismissed_review` | `object` | 被驳回审查的信息。 `dismissed_review[state]` | `string` | 拉取请求被驳回时的状态。 可以是以下项之一：`commented`、`approved` 或 `changes_requested`。 `dismissed_review[review_id]` | `string` | 拉取请求审查的唯一标识符。 `dismissed_review[dismissal_message]` | `string` | 驳回审查时用户包含的消息。 `dismissed_review[dismissal_commit_id]` | `string` | 驳回审查的提交的唯一标识符（如果存在）。
diff --git a/translations/zh-CN/data/reusables/issue-events/review-request-properties.md b/translations/zh-CN/data/reusables/issue-events/review-request-properties.md
index 350f0d3ff9dd..11032a8311a1 100644
--- a/translations/zh-CN/data/reusables/issue-events/review-request-properties.md
+++ b/translations/zh-CN/data/reusables/issue-events/review-request-properties.md
@@ -1 +1 @@
-`requested_reviewer` | `object` | The person requested to review the pull request. `review_requester` | `object` | The person who requested a review.
\ No newline at end of file
+`requested_reviewer` | `object` | 请求审查拉取请求的人。 `review_requester` | `object` | 请求审查的人。
diff --git a/translations/zh-CN/data/reusables/issue-events/timeline_events_object_properties.md b/translations/zh-CN/data/reusables/issue-events/timeline_events_object_properties.md
index 43c03587e7df..fffa462a67d9 100644
--- a/translations/zh-CN/data/reusables/issue-events/timeline_events_object_properties.md
+++ b/translations/zh-CN/data/reusables/issue-events/timeline_events_object_properties.md
@@ -1 +1 @@
-This events properties do not use the same structure as the [issue event object common properties](#issue-event-object-common-properties). The following properties are returned for this event.
\ No newline at end of file
+此事件属性不使用与[议题事件对象通用属性](#issue-event-object-common-properties)相同的结构。 此事件返回以下属性。
diff --git a/translations/zh-CN/data/reusables/large_files/can-include-lfs-objects-archives.md b/translations/zh-CN/data/reusables/large_files/can-include-lfs-objects-archives.md
index f0f75e6ec5de..e5ea3094b6da 100644
--- a/translations/zh-CN/data/reusables/large_files/can-include-lfs-objects-archives.md
+++ b/translations/zh-CN/data/reusables/large_files/can-include-lfs-objects-archives.md
@@ -1,5 +1,5 @@
 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
 
-You can choose whether {% data variables.large_files.product_name_long %}({% data variables.large_files.product_name_short %}) objects are included in source code archives, such as ZIP files and tarballs, that {% data variables.product.product_name %} creates for your repository. For more information, see "[Managing {% data variables.large_files.product_name_short %} objects in archives of your repository](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)."
+您可以选择是否将 {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) 对象包含在源代码存档（例如 {% data variables.product.product_name %} 为仓库创建的 ZIP 文件和 tarball）中。 更多信息请参阅“[管理仓库存档中的 {% data variables.large_files.product_name_short %} 对象](/github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository)”。
 
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/translations/zh-CN/data/reusables/marketplace/cancellation-clarification.md b/translations/zh-CN/data/reusables/marketplace/cancellation-clarification.md
index f4463ad23d57..658a831d81ac 100644
--- a/translations/zh-CN/data/reusables/marketplace/cancellation-clarification.md
+++ b/translations/zh-CN/data/reusables/marketplace/cancellation-clarification.md
@@ -1 +1 @@
-When a customer cancels a {% data variables.product.prodname_marketplace %} subscription, GitHub does not automatically uninstall the app, so the customer can expect that free features will continue to function.
\ No newline at end of file
+当客户取消 {% data variables.product.prodname_marketplace %} 订阅时，GitHub 不会自动卸载应用程序，因此客户可以预期免费功能仍然有效。
diff --git a/translations/zh-CN/data/reusables/marketplace/free-apps-encouraged.md b/translations/zh-CN/data/reusables/marketplace/free-apps-encouraged.md
index 8f8d89fc42aa..65e9697669ec 100644
--- a/translations/zh-CN/data/reusables/marketplace/free-apps-encouraged.md
+++ b/translations/zh-CN/data/reusables/marketplace/free-apps-encouraged.md
@@ -1 +1 @@
-Free apps are encouraged in {% data variables.product.prodname_marketplace %} and are a great way to offer open source services. If you list a paid version of your app outside of {% data variables.product.prodname_marketplace %}, you must offer at least one paid plan when listing the app in {% data variables.product.prodname_marketplace %}.
+{% data variables.product.prodname_marketplace %} 鼓励使用免费应用程序，这是提供开源服务的好方法。 如果您在 {% data variables.product.prodname_marketplace %} 的外部上架了应用程序的付费版本，则您在 {% data variables.product.prodname_marketplace %} 中上架该应用程序时，必须提供至少一个付费计划。
diff --git a/translations/zh-CN/data/reusables/marketplace/github_apps_preferred.md b/translations/zh-CN/data/reusables/marketplace/github_apps_preferred.md
index 04c37a99c9c5..19423af47c9d 100644
--- a/translations/zh-CN/data/reusables/marketplace/github_apps_preferred.md
+++ b/translations/zh-CN/data/reusables/marketplace/github_apps_preferred.md
@@ -1 +1 @@
-GitHub Apps are the officially recommended way to integrate with GitHub because they offer much more granular permissions to access data
\ No newline at end of file
+GitHub 应用程序是官方推荐的与 GitHub 集成的方式，因为它们提供更精细的数据访问权限
diff --git a/translations/zh-CN/data/reusables/marketplace/launch-with-free.md b/translations/zh-CN/data/reusables/marketplace/launch-with-free.md
index b809c37a0e6a..a2e184b5d48d 100644
--- a/translations/zh-CN/data/reusables/marketplace/launch-with-free.md
+++ b/translations/zh-CN/data/reusables/marketplace/launch-with-free.md
@@ -1 +1 @@
-You can submit both an unverified and verified app. This will allow you to launch with a free version of your app. Once GitHub verifies your app, your listing will change from unverified to verified in {% data variables.product.prodname_marketplace %} and GitHub will publish your new pricing plans.
\ No newline at end of file
+您可以提交未经验证和经过验证的应用程序。 这将允许您使用免费版本的应用程序启动。 GitHub 验证您的应用程序后，该程序在 {% data variables.product.prodname_marketplace %} 中的上架状态将从未经验证变为经过验证，GitHub 将发布您的新定价计划。
diff --git a/translations/zh-CN/data/reusables/marketplace/marketplace-billing-ui-requirements.md b/translations/zh-CN/data/reusables/marketplace/marketplace-billing-ui-requirements.md
index 9c02badeae41..591ad2f4c805 100644
--- a/translations/zh-CN/data/reusables/marketplace/marketplace-billing-ui-requirements.md
+++ b/translations/zh-CN/data/reusables/marketplace/marketplace-billing-ui-requirements.md
@@ -1,9 +1,9 @@
-- Customers who cancel a paid plan purchased from {% data variables.product.prodname_marketplace %} must be automatically downgraded to the app's free plan if it exists. {% data reusables.marketplace.cancellation-clarification %} It's highly recommended to allow customers to re-enable their previous plan.
-- Customers must be able to upgrade from your app's UI if you provide an [upgrade URL](/marketplace/integrating-with-the-github-marketplace-api/upgrading-and-downgrading-plans/#about-upgrade-urls) in this format: `https://www.github.com/marketplace//upgrade//`
-- Customers must be able to modify which users have access to your app from your app's website if they purchased seats (per-unit pricing plan) or the plan offers unlimited collaborators.
-- Customers must be able to see the following changes to their account immediately in the billing, profile, or account settings section of the app's website:
-  - Current plan and price.
-  - New plans purchased.
-  - Upgrades, downgrades, cancellations, and the number of remaining days in a free trial.
-  - Changes to billing cycles (monthly or yearly).
-  - Usage and remaining resources for flat-rate and per-unit plans. For example, if the pricing plan is per-unit, your app's site should show units used and units available.
+- 取消从 {% data variables.product.prodname_marketplace %} 购买的付费计划的客户必须被自动降级到该应用程序的免费计划（如果有）。 {% data reusables.marketplace.cancellation-clarification %} 强烈建议允许客户重新启用他们以前的计划。
+- 如果您用以下格式提供[升级 URL](/marketplace/integrating-with-the-github-marketplace-api/upgrading-and-downgrading-plans/#about-upgrade-urls)，客户必须能够从应用程序的 UI 升级：`https://www.github.com/marketplace//upgrade//`
+- 如果客户购买了席位（单位定价计划）或支持无限协作者的计划，他们必须能够修改哪些用户可以从应用程序的网站访问应用程序。
+- 客户必须能够在应用程序网站的帐单、个人资料或帐户设置部分立即看到其帐户的以下变动：
+  - 当前计划和价格。
+  - 购买的新计划。
+  - 升级、降级、取消以及免费试用剩余天数。
+  - 结算周期的变化（每月或每年）。
+  - 固定费用和每单位计划的使用情况和剩余资源。 例如，如果定价计划是按单位计费，则应用程序的网站应显示已用单位和可用单位。
diff --git a/translations/zh-CN/data/reusables/marketplace/marketplace-double-purchases.md b/translations/zh-CN/data/reusables/marketplace/marketplace-double-purchases.md
index f434be5cba7f..5d6db3b69fc3 100644
--- a/translations/zh-CN/data/reusables/marketplace/marketplace-double-purchases.md
+++ b/translations/zh-CN/data/reusables/marketplace/marketplace-double-purchases.md
@@ -1,5 +1,5 @@
 {% warning %}
 
-**Note:** In the current version of {% data variables.product.prodname_marketplace %}, it's possible for a customer to purchase your app through {% data variables.product.prodname_marketplace %} when they already have an existing account purchased from your app's website. If you find that you already have an account set up for the customer who purchased your app, please report the “double” purchases to [GitHub Support](https://github.com/contact).
+**注：**在当前版本的 {% data variables.product.prodname_marketplace %} 中，如果客户已有一个从您的应用程序网站购买的现有帐户，他们可能还会通过 {% data variables.product.prodname_marketplace %} 购买您的应用程序。 如果您发现已经为购买您的应用程序的客户设置了帐户，请向 [GitHub 支持部门](https://github.com/contact)报告这种“双重”购买的情况。
 
 {% endwarning %}
diff --git a/translations/zh-CN/data/reusables/marketplace/marketplace-failed-purchase-event.md b/translations/zh-CN/data/reusables/marketplace/marketplace-failed-purchase-event.md
index b4ff8e580a29..c86f2da4ecf5 100644
--- a/translations/zh-CN/data/reusables/marketplace/marketplace-failed-purchase-event.md
+++ b/translations/zh-CN/data/reusables/marketplace/marketplace-failed-purchase-event.md
@@ -1 +1 @@
-In the case where a customer upgrades their plan and the payment fails, GitHub reverts their {% data variables.product.prodname_marketplace %} subscription to its previous state. GitHub also send an email to the customer to inform them of the failure and allow them to re-attempt their purchase. You will receive a webhook with the `changed` action requesting you to revert to the previous plan.
+如果客户升级其计划但付款失败，GitHub 会将其 {% data variables.product.prodname_marketplace %} 订阅还原到以前的状态。 GitHub 还会向客户发送一封电子邮件，通知他们失败的情况，并允许他们重新尝试购买。 您将会收到带有 `changed` 操作的 web 挂钩，要求您还原到以前的计划。
diff --git a/translations/zh-CN/data/reusables/marketplace/marketplace-malicious-behavior.md b/translations/zh-CN/data/reusables/marketplace/marketplace-malicious-behavior.md
index 3c0cf8992084..20d22fa971f1 100644
--- a/translations/zh-CN/data/reusables/marketplace/marketplace-malicious-behavior.md
+++ b/translations/zh-CN/data/reusables/marketplace/marketplace-malicious-behavior.md
@@ -1,5 +1,5 @@
 {% note %}
 
-**Note:** If you notice any spammy {% data variables.product.prodname_marketplace %} purchases or other malicious behavior, please complete the [report abuse](https://github.com/contact/report-abuse) form with more information on the user.
+**注：**如果您发现任何恶意 {% data variables.product.prodname_marketplace %} 购买或其他恶意行为，请填写[报告滥用](https://github.com/contact/report-abuse)表单，并提供有关用户的更多信息。
 
 {% endnote %}
diff --git a/translations/zh-CN/data/reusables/marketplace/marketplace-pricing-free-trials.md b/translations/zh-CN/data/reusables/marketplace/marketplace-pricing-free-trials.md
index 4a456fd48be8..599737aaef89 100644
--- a/translations/zh-CN/data/reusables/marketplace/marketplace-pricing-free-trials.md
+++ b/translations/zh-CN/data/reusables/marketplace/marketplace-pricing-free-trials.md
@@ -1 +1 @@
-You can offer your app for free for 14 days as a free trial. Free trials automatically convert to a paid subscription after 14 days, unless the customer cancels before the free trial expires. Select "Enable 14 day free trial for this plan" to offer a free trial.
+您可以为您的应用程序设置 14 天的免费试用期。 免费试用在 14 天后自动转换为付费订阅，除非客户在免费试用到期前取消。 选择“Enable 14 day free trial for this plan（为此计划启用 14 天免费试用）”以提供免费试用。
diff --git a/translations/zh-CN/data/reusables/marketplace/unverified-apps.md b/translations/zh-CN/data/reusables/marketplace/unverified-apps.md
index d390a5e5eaf0..e7c4a770c8fc 100644
--- a/translations/zh-CN/data/reusables/marketplace/unverified-apps.md
+++ b/translations/zh-CN/data/reusables/marketplace/unverified-apps.md
@@ -1 +1 @@
-Unverified apps are only offered with free plans. To list paid plans, you must submit a verified app.
\ No newline at end of file
+未经验证的应用程序只能提供免费计划。 要列出付费计划，必须提交经过验证的应用程序。
diff --git a/translations/zh-CN/data/reusables/notifications-v2/email-notification-caveats.md b/translations/zh-CN/data/reusables/notifications-v2/email-notification-caveats.md
index 3b81a8b99e76..8b7cdd0ecd56 100644
--- a/translations/zh-CN/data/reusables/notifications-v2/email-notification-caveats.md
+++ b/translations/zh-CN/data/reusables/notifications-v2/email-notification-caveats.md
@@ -2,4 +2,4 @@
 
 {% if currentVersion == "free-pro-team@latest" %}
 {% data reusables.user_settings.verify-org-approved-email-domain %}
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/translations/zh-CN/data/reusables/notifications-v2/manage-notifications.md b/translations/zh-CN/data/reusables/notifications-v2/manage-notifications.md
index cc08dd6f9ab5..22e4bdcd9f0f 100644
--- a/translations/zh-CN/data/reusables/notifications-v2/manage-notifications.md
+++ b/translations/zh-CN/data/reusables/notifications-v2/manage-notifications.md
@@ -1 +1 @@
-1. 在左侧边栏中的仓库列表下，使用“Manage notifications（管理通知）”下拉按钮单击 **Notification settings（通知设置）**。 ![管理通知下拉菜单选项](/assets/images/help/notifications-v2/manage-notifications-options.png)
\ No newline at end of file
+1. 在左侧边栏中的仓库列表下，使用“Manage notifications（管理通知）”下拉按钮单击 **Notification settings（通知设置）**。 ![管理通知下拉菜单选项](/assets/images/help/notifications-v2/manage-notifications-options.png)
diff --git a/translations/zh-CN/data/reusables/notifications/shared_state.md b/translations/zh-CN/data/reusables/notifications/shared_state.md
index 2e5e542dbb21..48317061501e 100644
--- a/translations/zh-CN/data/reusables/notifications/shared_state.md
+++ b/translations/zh-CN/data/reusables/notifications/shared_state.md
@@ -1,5 +1,5 @@
 {% tip %}
 
-**提示：**如果您同时接收 Web 和电子邮件通知，您可以自动同步通知的已读或未读状态，以便在您阅读相应的电子邮件通知后，Web 通知自动标记为已读。 要启用此同步，您的电子邮件客户端必须能够查看来自 {% if currentVersion == "free-pro-team@latest" %}'`notifications@github.com`'{% else %}'网站管理员配置的无需回复电子邮件地址'{% endif %}的图像。
+**提示：**如果您同时接收 Web 和电子邮件通知，您可以自动同步通知的已读或未读状态，以便在您阅读相应的电子邮件通知后，Web 通知自动标记为已读。 To enable this sync, your email client must be able to view images from {% if currentVersion == "free-pro-team@latest" %}'`notifications@github.com`'{% else %}'the no-reply email address configured by your site administrator'{% endif %}.
 
 {% endtip %}
diff --git a/translations/zh-CN/data/reusables/organizations/can-require-ssh-cert.md b/translations/zh-CN/data/reusables/organizations/can-require-ssh-cert.md
index fcb7cff1e7d3..6da37763232e 100644
--- a/translations/zh-CN/data/reusables/organizations/can-require-ssh-cert.md
+++ b/translations/zh-CN/data/reusables/organizations/can-require-ssh-cert.md
@@ -1 +1 @@
-您可以要求成员使用 SSH 证书访问组织资源，{% if currentVersion ver_gt "enterprise-server@2.17" %}除非 SSH 已在仓库中禁用{% endif %}。
+You can require that members use SSH certificates to access organization resources,, unless SSH is disabled in your repository.
diff --git a/translations/zh-CN/data/reusables/organizations/oauth_app_restrictions_default.md b/translations/zh-CN/data/reusables/organizations/oauth_app_restrictions_default.md
index 5fb3db71b3a3..b5c3d211045d 100644
--- a/translations/zh-CN/data/reusables/organizations/oauth_app_restrictions_default.md
+++ b/translations/zh-CN/data/reusables/organizations/oauth_app_restrictions_default.md
@@ -1 +1 @@
-{% if currentVersion == "free-pro-team@latest" %}创建新组织时，默认启用 {% data variables.product.prodname_oauth_app %} 访问限制。 组织所有者可随时[禁用 {% data variables.product.prodname_oauth_app %} 访问限制](/articles/disabling-oauth-app-access-restrictions-for-your-organization)。{% endif %}
+{% if currentVersion == "free-pro-team@latest" %}When you create a new organization, {% data variables.product.prodname_oauth_app %} access restrictions are enabled by default. 组织所有者可随时[禁用 {% data variables.product.prodname_oauth_app %} 访问限制](/articles/disabling-oauth-app-access-restrictions-for-your-organization)。{% endif %}
diff --git a/translations/zh-CN/data/reusables/organizations/organization-name.md b/translations/zh-CN/data/reusables/organizations/organization-name.md
index eb4a1c1e2931..47e667bc84cb 100644
--- a/translations/zh-CN/data/reusables/organizations/organization-name.md
+++ b/translations/zh-CN/data/reusables/organizations/organization-name.md
@@ -1 +1 @@
-1. 在“Organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} account{% endif %} name（组织帐户名称）”下，输入您的组织帐户的名称。 ![用于输入组织名称的字段](/assets/images/help/organizations/new-org-name.png)
+1. Under "Organization account name", type a name for your organization account. ![用于输入组织名称的字段](/assets/images/help/organizations/new-org-name.png)
diff --git a/translations/zh-CN/data/reusables/organizations/organizations_include.md b/translations/zh-CN/data/reusables/organizations/organizations_include.md
index 31867ba85573..3090e44408d3 100644
--- a/translations/zh-CN/data/reusables/organizations/organizations_include.md
+++ b/translations/zh-CN/data/reusables/organizations/organizations_include.md
@@ -1,5 +1,5 @@
 组织包括：
-{% if currentVersion == "free-pro-team@latest" %}- 免费选项，{% data variables.product.prodname_free_team %}，在具有完整功能的无限公共仓库和具有有限功能的无限私有仓库上支持无限协作者。
+{% if currentVersion == "free-pro-team@latest" %}- A free option, {% data variables.product.prodname_free_team %}, with unlimited collaborators on unlimited public repositories with full features and unlimited private repositories with limited features.
 - 用于升级到 {% data variables.product.prodname_team %} 或 {% data variables.product.prodname_ghe_cloud %} 以获取额外功能的选项，包括复杂的用户身份验证和管理，以及升级的支持选项。 {% data reusables.gated-features.more-info %}{% endif %}
 - 无限的成员资格，以各种不同的角色授予[对组织及其数据的不同访问权限](/articles/permission-levels-for-an-organization)
 - 能够向成员授予[对组织仓库的一系列访问权限](/articles/repository-permission-levels-for-an-organization)
diff --git a/translations/zh-CN/data/reusables/organizations/outside-collaborators-use-seats.md b/translations/zh-CN/data/reusables/organizations/outside-collaborators-use-seats.md
index 7088162bf76c..fca2ca75c2e7 100644
--- a/translations/zh-CN/data/reusables/organizations/outside-collaborators-use-seats.md
+++ b/translations/zh-CN/data/reusables/organizations/outside-collaborators-use-seats.md
@@ -1 +1 @@
-{% if currentVersion == "free-pro-team@latest" %}将一个外部协作者添加到私人仓库将会使用您组织的一个付费许可。 更多信息请参阅“[关于每用户定价](/articles/about-per-user-pricing/)”。{% endif %}
+{% if currentVersion == "free-pro-team@latest" %}Adding an outside collaborator to a private repository will use one of your organization's paid licenses. 更多信息请参阅“[关于每用户定价](/articles/about-per-user-pricing/)”。{% endif %}
diff --git a/translations/zh-CN/data/reusables/organizations/repository-defaults.md b/translations/zh-CN/data/reusables/organizations/repository-defaults.md
index 96484109fd9a..1482a43ed252 100644
--- a/translations/zh-CN/data/reusables/organizations/repository-defaults.md
+++ b/translations/zh-CN/data/reusables/organizations/repository-defaults.md
@@ -1 +1 @@
-1. In the left sidebar, click **Repository defaults**. ![Repository defaults tab](/assets/images/help/organizations/repo-defaults-tab.png)
+1. 在左边栏中，单击 **Repository defaults（仓库默认值）**。 ![仓库默认值选项卡](/assets/images/help/organizations/repo-defaults-tab.png)
diff --git a/translations/zh-CN/data/reusables/organizations/repository-labels.md b/translations/zh-CN/data/reusables/organizations/repository-labels.md
index 288921911498..0d9782e24b28 100644
--- a/translations/zh-CN/data/reusables/organizations/repository-labels.md
+++ b/translations/zh-CN/data/reusables/organizations/repository-labels.md
@@ -1 +1 @@
-1. 在左侧边栏中，单击 **Repository labels（仓库标签）**。 ![仓库标签选项卡](/assets/images/help/organizations/repo-labels-tab.png)
\ No newline at end of file
+1. 在左侧边栏中，单击 **Repository labels（仓库标签）**。 ![仓库标签选项卡](/assets/images/help/organizations/repo-labels-tab.png)
diff --git a/translations/zh-CN/data/reusables/organizations/security.md b/translations/zh-CN/data/reusables/organizations/security.md
index da10a5163251..8195f2add5bc 100644
--- a/translations/zh-CN/data/reusables/organizations/security.md
+++ b/translations/zh-CN/data/reusables/organizations/security.md
@@ -1,5 +1,5 @@
 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}
-1. In the left sidebar, click **Organization security**. ![Organization security settings](/assets/images/help/organizations/org-security-settings-tab.png)
+1. 在左边栏中，单击 **Organization security（组织安全）**。 ![组织安全设置](/assets/images/help/organizations/org-security-settings-tab.png)
 {% else %}
-1. 在左侧边栏中，单击 **Security（安全）**。 ![Organization security settings](/assets/images/help/organizations/org-settings-security-tab.png)
+1. 在左侧边栏中，单击 **Security（安全）**。 ![组织安全设置](/assets/images/help/organizations/org-settings-security-tab.png)
 {% endif %}
diff --git a/translations/zh-CN/data/reusables/organizations/send-invitation.md b/translations/zh-CN/data/reusables/organizations/send-invitation.md
index 5d6570ecc4ce..f1b7420e05a0 100644
--- a/translations/zh-CN/data/reusables/organizations/send-invitation.md
+++ b/translations/zh-CN/data/reusables/organizations/send-invitation.md
@@ -1 +1 @@
-1. 单击 {% if currentVersion == "free-pro-team@latest" %}**Send invitation（发送邀请）**{% else %}**Add member（添加成员）**{% endif %}。
+1. Click {% if currentVersion == "free-pro-team@latest" %}**Send invitation**{% else %}**Add member**{% endif %}.
diff --git a/translations/zh-CN/data/reusables/organizations/team_maintainers_can.md b/translations/zh-CN/data/reusables/organizations/team_maintainers_can.md
index 4dd4ee610a4f..d46279e190b9 100644
--- a/translations/zh-CN/data/reusables/organizations/team_maintainers_can.md
+++ b/translations/zh-CN/data/reusables/organizations/team_maintainers_can.md
@@ -10,6 +10,6 @@
 - [添加组织成员到团队](/articles/adding-organization-members-to-a-team)
 - [从团队中删除组织成员](/articles/removing-organization-members-from-a-team)
 - [将组织成员升级为团队维护员](/articles/giving-team-maintainer-permissions-to-an-organization-member)
-- 删除团队对仓库的访问权限{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}
-- [管理团队的代码审查任务](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team){% endif %}{% if currentVersion == "free-pro-team@latest" %}
+- Remove the team's access to repositories{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}
+- [Manage code review assignment for the team](/github/setting-up-and-managing-organizations-and-teams/managing-code-review-assignment-for-your-team){% endif %}{% if currentVersion == "free-pro-team@latest" %}
 - [管理拉取请求的预定提醒](/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests){% endif %}
diff --git a/translations/zh-CN/data/reusables/package_registry/admins-can-configure-package-types.md b/translations/zh-CN/data/reusables/package_registry/admins-can-configure-package-types.md
index 82369c5e4a37..122d4e93702c 100644
--- a/translations/zh-CN/data/reusables/package_registry/admins-can-configure-package-types.md
+++ b/translations/zh-CN/data/reusables/package_registry/admins-can-configure-package-types.md
@@ -1,7 +1,7 @@
 {% if currentVersion != "free-pro-team@latest" %}
 {% note %}
 
-**Note:** This package type may not be available for your instance, because site administrators can enable or disable each supported package type. For more information, see "[Configuring packages support for your enterprise](/enterprise/admin/packages/configuring-packages-support-for-your-enterprise)."
+**注：**这种包类型可能不适用于您的实例，因为站点管理员可以启用或禁用每种支持的包类型。 更多信息请参阅“[为企业配置软件包支持](/enterprise/admin/packages/configuring-packages-support-for-your-enterprise)”。
 
 {% endnote %}
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/translations/zh-CN/data/reusables/package_registry/authenticate-packages.md b/translations/zh-CN/data/reusables/package_registry/authenticate-packages.md
index 17154d479a1b..e084a3347d73 100644
--- a/translations/zh-CN/data/reusables/package_registry/authenticate-packages.md
+++ b/translations/zh-CN/data/reusables/package_registry/authenticate-packages.md
@@ -1,9 +1,11 @@
-您需要访问令牌才能发布、安装和删除 {% data variables.product.prodname_registry %} 中的包。 您可以使用个人访问令牌直接向 {% data variables.product.prodname_registry %} 或 {% data variables.product.prodname_dotcom %} API 验证您的用户名。 创建个人访问令牌时，可根据需要为令牌分配不同的作用域。
+您需要访问令牌才能发布、安装和删除 {{ site.data.variables.product.prodname_registry }} 中的包。 您可以使用个人访问令牌直接向 {% data variables.product.prodname_registry %} 或 {% data variables.product.prodname_dotcom %} API 验证您的用户名。 创建个人访问令牌时，可根据需要为令牌分配不同的作用域。
 
 {% if currentVersion == "free-pro-team@latest" %}
-To authenticate using a {% data variables.product.prodname_actions %} workflow:
-- For package registries (`PACKAGE-REGISTRY.pkg.github.com/OWNER/REPOSITORY/IMAGE-NAME`), you can use a `GITHUB_TOKEN`.
-- For the container registry (`ghcr.io/OWNER/IMAGE-NAME`), you must use a personal access token.
+To authenticate using a
+{% data variables.product.prodname_actions %} 工作流程:
+- 对于包注册表 (`PACKAGE-REGISTRY.pkg.github.com/OWNER/REPOSITORY/IMAGE-NAME`)，您可以使用 `GITHUB_TOKEN`。
+- 对于容器注册表 (`ghcr.io/OWNER/IMAGE-NAME`)，必须使用个人访问令牌。
 {% else %}
-To authenticate to {% data variables.product.prodname_registry %} using a {% data variables.product.prodname_actions %} workflow, you must use `GITHUB_TOKEN`.
+To authenticate to
+{% data variables.product.prodname_registry %} using a {% data variables.product.prodname_actions %} workflow, you must use `GITHUB_TOKEN`.
 {% endif %}
diff --git a/translations/zh-CN/data/reusables/package_registry/authenticate-to-container-registry-steps.md b/translations/zh-CN/data/reusables/package_registry/authenticate-to-container-registry-steps.md
new file mode 100644
index 000000000000..5645cb9ebcb1
--- /dev/null
+++ b/translations/zh-CN/data/reusables/package_registry/authenticate-to-container-registry-steps.md
@@ -0,0 +1,25 @@
+1. 针对要完成的任务，新创具有适当作用域的个人访问令牌 (PAT)。 如果您的组织需要 SSO，则必须为新令牌启用 SSO。
+  {% warning %}
+
+  **Note:** If you select the `write:packages` scope, deselect the `repo` scope when creating the PAT. Adding a PAT with the `repo` scope as a secret in your repository allows the credential to be accessible to all collaborators in the repository. This gives unnecessary additional access when a PAT with the `repo` scope is used within an action. For more information on security best practices for actions, see "[Security hardening for GitHub Actions](/actions/getting-started-with-github-actions/security-hardening-for-github-actions#considering-cross-repository-access)."
+
+  {% endwarning %}
+
+    - 选择 `read:packs` 作用域以下载容器映像并读取其元数据。
+    - 选择 `write:packages` 作用域以下载和上传容器映像并读取和写入其元数据。
+    - 选择 `delete:packages` 作用域以删除容器映像。
+
+  更多信息请参阅“[创建用于命令行的个人访问令牌](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)。”
+
+2. 保存您的 PAT。 我们建议将 PAT 保存为环境变量。
+  ```shell
+  $ export CR_PAT=YOUR_TOKEN
+  ```
+3. Using the CLI for your container type, sign in to the
+{% data variables.product.prodname_github_container_registry %} service at `ghcr.io`.
+  {% raw %}
+  ```shell
+  $ echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin
+  > Login Succeeded
+  ```
+  {% endraw %}
diff --git a/translations/zh-CN/data/reusables/package_registry/authenticate_with_pat_for_container_registry.md b/translations/zh-CN/data/reusables/package_registry/authenticate_with_pat_for_container_registry.md
new file mode 100644
index 000000000000..7a08298672be
--- /dev/null
+++ b/translations/zh-CN/data/reusables/package_registry/authenticate_with_pat_for_container_registry.md
@@ -0,0 +1,9 @@
+{% if currentVersion == "free-pro-team@latest" %}
+If you want to authenticate to
+{% data variables.product.prodname_github_container_registry %} in a {% data variables.product.prodname_actions %} workflow, then you must use a personal access token (PAT). The `GITHUB_TOKEN` does not currently have the required permissions. During the {% data variables.product.prodname_github_container_registry %} beta, the only supported form of authentication is the PAT.
+
+PATs can grant broad access to your account. We recommend selecting only the necessary read, write, or delete `package` scope when creating a PAT to authenticate to the {% data variables.product.prodname_container_registry %}. Avoid including the `repo` scope in a PAT used by a GitHub Actions workflow because it gives unnecessary additional access.
+
+If you'd like to use the {% data variables.product.prodname_container_registry %} in actions during the beta, follow our security best practices for PAT use at "[Security hardening for GitHub Actions](/actions/getting-started-with-github-actions/security-hardening-for-github-actions#considering-cross-repository-access)."
+
+{% endif %}
diff --git a/translations/zh-CN/data/reusables/package_registry/billing-for-container-registry.md b/translations/zh-CN/data/reusables/package_registry/billing-for-container-registry.md
index 7cf8e2459f34..b2d32c4c8451 100644
--- a/translations/zh-CN/data/reusables/package_registry/billing-for-container-registry.md
+++ b/translations/zh-CN/data/reusables/package_registry/billing-for-container-registry.md
@@ -1,3 +1,3 @@
-During the {% data variables.product.prodname_github_container_registry %} beta, both the new {% data variables.product.prodname_container_registry %} and existing {% data variables.product.prodname_registry %} Docker registry will be free. For more information about the {% data variables.product.prodname_registry %} Docker registry, see "[Configuring Docker for use with {% data variables.product.prodname_registry %}](/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)."
+在 {% data variables.product.prodname_github_container_registry %} 测试期间，新的 {% data variables.product.prodname_container_registry %} 和现有的 {% data variables.product.prodname_registry %} Docker 注册表都是免费的。 有关 {% data variables.product.prodname_registry %} Docker 注册表的更多信息，请参阅“[配置 Docker 与 {% data variables.product.prodname_registry %} 一起使用](/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)”。
 
-After the beta, the same billing and storage rates that other {% data variables.product.prodname_registry %} registries use will apply to the container registry. For more information, see "[About  billing for {% data variables.product.prodname_registry %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)."
+测试后，其他 {% data variables.product.prodname_registry %} 注册表使用的计费和存储率将适用于容器注册表。 更多信息请参阅“[关于 {% data variables.product.prodname_registry %} 的计费](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)”。
diff --git a/translations/zh-CN/data/reusables/package_registry/container-registry-beta-billing-note.md b/translations/zh-CN/data/reusables/package_registry/container-registry-beta-billing-note.md
index 62b3c0f6a53d..8403f7a36c0b 100644
--- a/translations/zh-CN/data/reusables/package_registry/container-registry-beta-billing-note.md
+++ b/translations/zh-CN/data/reusables/package_registry/container-registry-beta-billing-note.md
@@ -1,5 +1,5 @@
 {% note %}
 
-**Billing update for container image storage:** During the beta phase of {% data variables.product.prodname_github_container_registry %}, Docker image storage and bandwidth are free for the old `docker.pkg.github.com` and new `ghcr.io` hosting services. 更多信息请参阅“[关于 {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry)”。
+**容器映像存储的计费更新：** 在 {% data variables.product.prodname_github_container_registry %} 的测试版阶段，Docker 映像存储和带宽对旧 `docker.pkg.github.com` 和新 `ghcr.io` 服务是免费的。 更多信息请参阅“[关于 {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry)”。
 
 {% endnote %}
diff --git a/translations/zh-CN/data/reusables/package_registry/container-registry-beta.md b/translations/zh-CN/data/reusables/package_registry/container-registry-beta.md
index 6053cba4a0b0..925e7e44d245 100644
--- a/translations/zh-CN/data/reusables/package_registry/container-registry-beta.md
+++ b/translations/zh-CN/data/reusables/package_registry/container-registry-beta.md
@@ -1,5 +1,5 @@
 {% note %}
 
-**Note:** {% data variables.product.prodname_github_container_registry %} is currently in public beta and subject to change. Currently, {% data variables.product.prodname_github_container_registry %} only supports Docker image formats. During the beta, storage and bandwidth is free. 更多信息请参阅“[关于 {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry)”。
+**注：**{% data variables.product.prodname_github_container_registry %} 目前处于公测阶段，可能会更改。 目前，{% data variables.product.prodname_github_container_registry %} 只支持 Docker 映像格式。 在测试阶段，存储和带宽是免费的。 更多信息请参阅“[关于 {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry/about-github-container-registry)”。
 
 {% endnote %}
diff --git a/translations/zh-CN/data/reusables/package_registry/container-registry-feature-highlights.md b/translations/zh-CN/data/reusables/package_registry/container-registry-feature-highlights.md
index 935ba7b2bf38..712abcec43a1 100644
--- a/translations/zh-CN/data/reusables/package_registry/container-registry-feature-highlights.md
+++ b/translations/zh-CN/data/reusables/package_registry/container-registry-feature-highlights.md
@@ -1,4 +1,4 @@
-With the container registry you can:
-- Store container images within your organization and user account, rather than a repository.
-- Set fine-grained permissions and visibility independent of repository permissions and visibility.
-- Access public container images anonymously.
+使用容器注册表，您可以：
+- 将容器映像存储在组织和用户帐户中，而不是仓库中。
+- 设置独立于仓库权限和可见性的粒度权限和可见性。
+- 匿名访问公共容器映像。
diff --git a/translations/zh-CN/data/reusables/package_registry/create-npmrc-owner-step.md b/translations/zh-CN/data/reusables/package_registry/create-npmrc-owner-step.md
index fc3fe5318a06..1a6b52496806 100644
--- a/translations/zh-CN/data/reusables/package_registry/create-npmrc-owner-step.md
+++ b/translations/zh-CN/data/reusables/package_registry/create-npmrc-owner-step.md
@@ -5,11 +5,11 @@
 registry=https://npm.pkg.github.com/OWNER
   ```
 {% else %}
-  If subdomain isolation is enabled:
+  如果启用了子域隔离：
   ```shell
   registry=https://npm.HOSTNAME/OWNER
   ```
-  If subdomain isolation is disabled:
+  如果禁用了子域隔离：
   ```shell
   https://HOSTNAME/_registry/npm/OWNER
   ```
diff --git a/translations/zh-CN/data/reusables/package_registry/docker_registry_deprecation_status.md b/translations/zh-CN/data/reusables/package_registry/docker_registry_deprecation_status.md
new file mode 100644
index 000000000000..79e9650f348f
--- /dev/null
+++ b/translations/zh-CN/data/reusables/package_registry/docker_registry_deprecation_status.md
@@ -0,0 +1,5 @@
+{% warning %}
+
+**Note:** The {% data variables.product.prodname_registry %} Docker registry will be superseded by {% data variables.product.prodname_github_container_registry %}{% if currentVersion != "free-pro-team@latest" %} in a future {% data variables.product.product_name %} release{% endif %}.{% if currentVersion == "free-pro-team@latest" %} To learn how to migrate your existing Docker images and any workflows using them, see "[Migrating to {% data variables.product.prodname_github_container_registry %} for Docker images](/packages/getting-started-with-github-container-registry/migrating-to-github-container-registry-for-docker-images)" and "[Getting started with {% data variables.product.prodname_github_container_registry %}](/packages/getting-started-with-github-container-registry)."{% endif %}
+
+{% endwarning %}
diff --git a/translations/zh-CN/data/reusables/package_registry/package-immutability.md b/translations/zh-CN/data/reusables/package_registry/package-immutability.md
index 25bbfa64b592..6553cbb929a6 100644
--- a/translations/zh-CN/data/reusables/package_registry/package-immutability.md
+++ b/translations/zh-CN/data/reusables/package_registry/package-immutability.md
@@ -1,3 +1,5 @@
-为避免混淆和版本问题，{% data variables.product.prodname_dotcom %} 永久保留包的名称和版本号。 即使删除了整个包，也不能在同一帐户拥有的任何仓库中重复使用已删除包的名称。
+**Public packages:** To prevent confusion and build problems, {% data variables.product.prodname_dotcom %} permanently reserves a package's name and version number. 即使删除了整个包，也不能在同一帐户拥有的任何仓库中重复使用已删除包的名称。
+
+**Private packages:** If all versions of a private package are deleted, you can publish a package with a previously used name and version.
 
 要修改或替换包版本，我们建议您发布包的新版本。
diff --git a/translations/zh-CN/data/reusables/package_registry/package-settings-from-org-level.md b/translations/zh-CN/data/reusables/package_registry/package-settings-from-org-level.md
index 9507393f82bb..12bf416fe320 100644
--- a/translations/zh-CN/data/reusables/package_registry/package-settings-from-org-level.md
+++ b/translations/zh-CN/data/reusables/package_registry/package-settings-from-org-level.md
@@ -1,4 +1,4 @@
-1. On {% data variables.product.prodname_dotcom %}, navigate to the main page of your organization.
-2. Under your organization name, click **Packages**. ![Container access invite button](/assets/images/help/package-registry/org-tab-for-packages.png)
-3. Search for and select your package.
-4. In the top right of your container image's landing page, click **Package settings**. ![Package settings button](/assets/images/help/package-registry/packages-settings-from-package-landing-page.png)
+1. 在 {% data variables.product.prodname_dotcom %} 上，导航到组织的主页面。
+2. 在组织名称下，单击 **Packages（包）**。 ![容器访问邀请按钮](/assets/images/help/package-registry/org-tab-for-packages.png)
+3. 搜索并选择您的包。
+4. 在容器映像登录页的右上角，单击 **Package settings（包设置）**。 ![包设置按钮](/assets/images/help/package-registry/packages-settings-from-package-landing-page.png)
diff --git a/translations/zh-CN/data/reusables/package_registry/package-settings-from-user-level.md b/translations/zh-CN/data/reusables/package_registry/package-settings-from-user-level.md
index a9da4e615a5c..82802f161bd2 100644
--- a/translations/zh-CN/data/reusables/package_registry/package-settings-from-user-level.md
+++ b/translations/zh-CN/data/reusables/package_registry/package-settings-from-user-level.md
@@ -1,5 +1,5 @@
-1. On {% data variables.product.prodname_dotcom %}, navigate to the main page of your user account.
+1. 在 {% data variables.product.prodname_dotcom %} 上，导航到用户帐户的主页面。
 2. 在 {% data variables.product.product_name %} 的右上角，单击您的个人资料照片，然后单击 **Your profile（您的个人资料）**。 ![个人资料照片](/assets/images/help/profile/top_right_avatar.png)
-3. On your profile page, in the top right, click **Packages**. ![Packages option on profile page](/assets/images/help/package-registry/packages-from-user-profile.png)
-3. Search for and select your package.
-4. In the top right of your container image's landing page, click **Package settings**. ![Package settings button](/assets/images/help/package-registry/packages-settings-from-package-landing-page.png)
+3. 在个人资料页面的右上角，单击 **Packages（包）**。 ![个人资料页上的包选项](/assets/images/help/package-registry/packages-from-user-profile.png)
+3. 搜索并选择您的包。
+4. 在容器映像登录页的右上角，单击 **Package settings（包设置）**。 ![包设置按钮](/assets/images/help/package-registry/packages-settings-from-package-landing-page.png)
diff --git a/translations/zh-CN/data/reusables/package_registry/packages-from-code-tab.md b/translations/zh-CN/data/reusables/package_registry/packages-from-code-tab.md
index 6dc54ac100f2..6059161f10e9 100644
--- a/translations/zh-CN/data/reusables/package_registry/packages-from-code-tab.md
+++ b/translations/zh-CN/data/reusables/package_registry/packages-from-code-tab.md
@@ -1,4 +1,4 @@
-1. To the right of the list of files, click **Packages**.
+1. 在文件列表右侧，单击 **Packages（包）**。
   {% if currentVersion == "free-pro-team@latest" %}
   ![概述页面上的包链接](/assets/images/help/package-registry/packages-link.png)
   {% else %}
diff --git a/translations/zh-CN/data/reusables/package_registry/packages-ghes-release-stage.md b/translations/zh-CN/data/reusables/package_registry/packages-ghes-release-stage.md
index 66d73926c699..11431946a19d 100644
--- a/translations/zh-CN/data/reusables/package_registry/packages-ghes-release-stage.md
+++ b/translations/zh-CN/data/reusables/package_registry/packages-ghes-release-stage.md
@@ -1,7 +1,7 @@
 {% if currentVersion != "free-pro-team@latest" %}
 {% note %}
 
-**Note:** {% data variables.product.prodname_registry %} is currently in beta for {% data variables.product.prodname_ghe_server %} 2.22. To join the beta for your instance, use the [sign-up form](https://resources.github.com/beta-signup/).
+**注：** {% data variables.product.prodname_registry %} 目前正在测试用于 {% data variables.product.prodname_ghe_server %} 2.22。 要加入您的实例的测试版，请使用[注册表单](https://resources.github.com/beta-signup/)。
 
 {% endnote %}
 {% endif %}
diff --git a/translations/zh-CN/data/reusables/package_registry/public-or-private-packages.md b/translations/zh-CN/data/reusables/package_registry/public-or-private-packages.md
index 00f6df0d964e..96876d84f347 100644
--- a/translations/zh-CN/data/reusables/package_registry/public-or-private-packages.md
+++ b/translations/zh-CN/data/reusables/package_registry/public-or-private-packages.md
@@ -1 +1 @@
-您可以在公共仓库中发布包（公共包）以与所有 {% data variables.product.prodname_dotcom %} 共享，或者在私有仓库中发布包（私有包）以与协作者或组织分享。
+You can publish packages in a public repository (public packages) to share with {% if currentVersion == "free-pro-team@latest" %}all of {% data variables.product.prodname_dotcom %}{% else %}everyone on your instance{% endif %}, or in a private repository (private packages) to share with collaborators or an organization.
diff --git a/translations/zh-CN/data/reusables/package_registry/repository_connection_steps.md b/translations/zh-CN/data/reusables/package_registry/repository_connection_steps.md
index 222259c82239..16eaf12c7e99 100644
--- a/translations/zh-CN/data/reusables/package_registry/repository_connection_steps.md
+++ b/translations/zh-CN/data/reusables/package_registry/repository_connection_steps.md
@@ -1,3 +1,3 @@
-1. Under your package versions, click **Connect repository**. ![Connect a repository button on packages landing page](/assets/images/help/package-registry/connect-repository.png)
+1. 在包版本下，单击 **Connect repository（连接仓库）**。 ![包登录页上的连接仓库按钮](/assets/images/help/package-registry/connect-repository.png)
 
-1. Select a repository, then click **Connect repository**. ![Connect a repository button in repository selection pop-up window](/assets/images/help/package-registry/select_a_repo.png)
+1. 选择一个仓库，然后单击 **Connect repository（连接仓库）**。 ![仓库选择弹出窗口中的连接仓库按钮](/assets/images/help/package-registry/select_a_repo.png)
diff --git a/translations/zh-CN/data/reusables/pages/admin-must-push.md b/translations/zh-CN/data/reusables/pages/admin-must-push.md
index c5380c73fa61..50633bf3dca8 100644
--- a/translations/zh-CN/data/reusables/pages/admin-must-push.md
+++ b/translations/zh-CN/data/reusables/pages/admin-must-push.md
@@ -1,5 +1,5 @@
 {% tip %}
 
-**Note**: If your site{% if currentVersion ver_lt "enterprise-server@2.22" %}'s source files are located in the default publishing source—`master` for user and organization sites or `gh-pages` for project sites—but your site{% endif %} has not published automatically, make sure someone with admin permissions and a verified email address has pushed to the publishing source.
+**Note**: If your site{% if currentVersion ver_lt "enterprise-server@2.23" %}'s source files are located in the default publishing source—`master` for user and organization sites or `gh-pages` for project sites—but your site{% endif %} has not published automatically, make sure someone with admin permissions and a verified email address has pushed to the publishing source.
 
 {% endtip %}
diff --git a/translations/zh-CN/data/reusables/pages/best-with-supported-themes.md b/translations/zh-CN/data/reusables/pages/best-with-supported-themes.md
index f63506f9439a..c1fb9100c9fd 100644
--- a/translations/zh-CN/data/reusables/pages/best-with-supported-themes.md
+++ b/translations/zh-CN/data/reusables/pages/best-with-supported-themes.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-这些说明非常适用于 {% data variables.product.prodname_pages %} 官方支持的主题。 关于支持的主题完整列表，请参阅 {% data variables.product.prodname_pages %} 网站上的“[支持的主题](https://pages.github.com/themes/)”。
+These instructions work best with themes that are officially supported by
+{% data variables.product.prodname_pages %}. 关于支持的主题完整列表，请参阅 {% data variables.product.prodname_pages %} 网站上的“[支持的主题](https://pages.github.com/themes/)”。
 {% endif %}
diff --git a/translations/zh-CN/data/reusables/pages/configure-publishing-source.md b/translations/zh-CN/data/reusables/pages/configure-publishing-source.md
index f55f70da99fe..1e5612add441 100644
--- a/translations/zh-CN/data/reusables/pages/configure-publishing-source.md
+++ b/translations/zh-CN/data/reusables/pages/configure-publishing-source.md
@@ -1 +1 @@
-1. Configure your publishing source. 更多信息请参阅“[配置 {% data variables.product.prodname_pages %} 站点的发布来源](/articles/configuring-a-publishing-source-for-your-github-pages-site#choosing-a-publishing-source)”。
+1. 配置发布源。 更多信息请参阅“[配置 {% data variables.product.prodname_pages %} 站点的发布来源](/articles/configuring-a-publishing-source-for-your-github-pages-site#choosing-a-publishing-source)”。
diff --git a/translations/zh-CN/data/reusables/pages/decide-publishing-source.md b/translations/zh-CN/data/reusables/pages/decide-publishing-source.md
index fd986d420216..8e950fc86be7 100644
--- a/translations/zh-CN/data/reusables/pages/decide-publishing-source.md
+++ b/translations/zh-CN/data/reusables/pages/decide-publishing-source.md
@@ -1 +1 @@
-1. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}Decide{% else %}If you're creating a project site, decide{% endif %} which publishing source you want to use. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}Decide{% else %}If you're creating a project site, decide{% endif %} which publishing source you want to use. {% if currentVersion ver_lt "enterprise-server@2.22" %}If you're creating a user or organization site, you must store your site's source code on the `master` branch.{% endif %} For more information, see "[About {% data variables.product.prodname_pages %}](/articles/about-github-pages#publishing-sources-for-github-pages-sites)."
+1. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}Decide{% else %}If you're creating a project site, decide{% endif %} which publishing source you want to use. {% if currentVersion ver_lt "enterprise-server@2.23" %}If you're creating a user or organization site, you must store your site's source code on the `master` branch.{% endif %} For more information, see "[About {% data variables.product.prodname_pages %}](/articles/about-github-pages#publishing-sources-for-github-pages-sites)."
diff --git a/translations/zh-CN/data/reusables/pages/new-or-existing-repo.md b/translations/zh-CN/data/reusables/pages/new-or-existing-repo.md
index 626cdbf11011..60424cf84fb6 100644
--- a/translations/zh-CN/data/reusables/pages/new-or-existing-repo.md
+++ b/translations/zh-CN/data/reusables/pages/new-or-existing-repo.md
@@ -1,3 +1,3 @@
-如果站点是一个独立的项目，您可以创建新仓库来存储站点源代码。 如果站点是一个独立的项目，您可以创建新仓库来存储站点源代码。
+如果站点是一个独立的项目，您可以创建新仓库来存储站点源代码。 If your site is associated with an existing project, you can add the source code {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}to that project's repository, in a `/docs` folder on the default branch or on a different branch.{% else %}for your site to a `gh-pages` branch or a `docs` folder on the `master` branch in that project's repository.{% endif %} For example, if you're creating a site to publish documentation for a project that's already on {% data variables.product.product_name %}, you may want to store the source code for the site in the same repository as the project.
 
 如果要在现有仓库中创建站点，请跳至“[创建站点](#creating-your-site)”一节。
diff --git a/translations/zh-CN/data/reusables/pages/private_pages_are_public_warning.md b/translations/zh-CN/data/reusables/pages/private_pages_are_public_warning.md
index a10d32e84485..2579c5d10f51 100644
--- a/translations/zh-CN/data/reusables/pages/private_pages_are_public_warning.md
+++ b/translations/zh-CN/data/reusables/pages/private_pages_are_public_warning.md
@@ -1,5 +1,5 @@
   {% warning %}
 
-  **Warning**: {% if currentVersion != "free-pro-team@latest" %}If your site administrator has enabled Public Pages, {% endif %}{% data variables.product.prodname_pages %} sites are publicly available on the internet, even if the repository for the site is private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %}. 如果站点的仓库中有敏感数据，您可能想要在发布前删除它。 更多信息请参阅{% if currentVersion != "free-pro-team@latest" %} “[在设备上配置 {% data variables.product.prodname_pages %}](/enterprise/admin/installation/configuring-github-pages-on-your-appliance#making-github-pages-publicly-accessible)”和{% endif %}“[关于仓库可见性](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)”。
+  **Warning**: {% if currentVersion != "free-pro-team@latest" %}If your site administrator has enabled Public Pages, {% endif %}{% data variables.product.prodname_pages %} sites are publicly available on the internet, even if the repository for the site is private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %}. If you have sensitive data in your site's repository, you may want to remove it before publishing. For more information, see{% if currentVersion != "free-pro-team@latest" %} "[Configuring {% data variables.product.prodname_pages %} on your appliance](/enterprise/admin/installation/configuring-github-pages-on-your-appliance#making-github-pages-publicly-accessible)" and{% endif %} "[About repository visibility](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)."
 
   {% endwarning %}
diff --git a/translations/zh-CN/data/reusables/policies/abuse.md b/translations/zh-CN/data/reusables/policies/abuse.md
index 8ee328d16358..78c56e096b05 100644
--- a/translations/zh-CN/data/reusables/policies/abuse.md
+++ b/translations/zh-CN/data/reusables/policies/abuse.md
@@ -1 +1 @@
-{% data variables.product.prodname_dotcom %} 不允许滥用。{% if currentVersion == "free-pro-team@latest" %} 有关 {% data variables.product.prodname_dotcom %} 政策的更多信息，请参阅[服务条款](/articles/github-terms-of-service)和[社区准则](/articles/github-community-guidelines)。{% endif %}
+{% data variables.product.prodname_dotcom %} does not tolerate abuse.{% if currentVersion == "free-pro-team@latest" %} For more information on {% data variables.product.prodname_dotcom %}'s policies, see our [Terms of Service](/articles/github-terms-of-service) and [Community Guidelines](/articles/github-community-guidelines).{% endif %}
diff --git a/translations/zh-CN/data/reusables/pre-release-program/api-preview-warning.md b/translations/zh-CN/data/reusables/pre-release-program/api-preview-warning.md
index 480d2dc69c41..0646d14202cc 100644
--- a/translations/zh-CN/data/reusables/pre-release-program/api-preview-warning.md
+++ b/translations/zh-CN/data/reusables/pre-release-program/api-preview-warning.md
@@ -1,5 +1,5 @@
 {% warning %}
 
-**Warning:** The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact {% data variables.contact.contact_support %}.
+**警告：** 在预览期间，API 可能会更改，恕不另行通知。 预览功能不支持用于生产。 If you experience any issues, contact {% data variables.contact.contact_support %}.
 
 {% endwarning %}
diff --git a/translations/zh-CN/data/reusables/pre-release-program/content-attachments-public-beta.md b/translations/zh-CN/data/reusables/pre-release-program/content-attachments-public-beta.md
index 5ec22b70ca21..f3c6ee2bf1cd 100644
--- a/translations/zh-CN/data/reusables/pre-release-program/content-attachments-public-beta.md
+++ b/translations/zh-CN/data/reusables/pre-release-program/content-attachments-public-beta.md
@@ -1,5 +1,5 @@
 {% note %}
 
-**Note:** The {% data variables.product.prodname_unfurls %} API is currently in public beta and only available for use with GitHub Apps. Features and requirements may change at any time during this period.
+**Note:** The {% data variables.product.prodname_unfurls %} API is currently in public beta and only available for use with GitHub Apps. 在此期间，功能和要求可能会随时更改。
 
 {% endnote %}
diff --git a/translations/zh-CN/data/reusables/pre-release-program/expiring-user-access-tokens-beta.md b/translations/zh-CN/data/reusables/pre-release-program/expiring-user-access-tokens-beta.md
index 1594eb596a97..b19e554b9b7f 100644
--- a/translations/zh-CN/data/reusables/pre-release-program/expiring-user-access-tokens-beta.md
+++ b/translations/zh-CN/data/reusables/pre-release-program/expiring-user-access-tokens-beta.md
@@ -1,7 +1,7 @@
 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}
 {% note %}
 
-**Note:** Expiring user tokens are currently part of the user-to-server token expiration beta and subject to change. To opt-in to the user-to-server token expiration beta feature, see "[Activating beta features for apps](/developers/apps/activating-beta-features-for-apps)." For more information, see "[Expiring user-to-server access tokens for GitHub Apps](https://developer.github.com/changes/2020-04-30-expiring-user-to-server-access-tokens-for-github-apps)."
+**注：**过期用户令牌目前是用户到服务器令牌过期的一部分，可能会更改。 要选择加入用户到服务器令牌过期测试版功能，请参阅“[激活应用程序的测试版功能](/developers/apps/activating-beta-features-for-apps)”。 更多信息请参阅“[GitHub 应用程序过期用户到服务器访问令牌](https://developer.github.com/changes/2020-04-30-expiring-user-to-server-access-tokens-for-github-apps)”。
 
 {% endnote %}
 {% endif %}
diff --git a/translations/zh-CN/data/reusables/pre-release-program/fury-pre-release.md b/translations/zh-CN/data/reusables/pre-release-program/fury-pre-release.md
index 5e63be71606a..04ac15f9fe65 100644
--- a/translations/zh-CN/data/reusables/pre-release-program/fury-pre-release.md
+++ b/translations/zh-CN/data/reusables/pre-release-program/fury-pre-release.md
@@ -1,7 +1,7 @@
 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.21" %}
 {% note %}
 
-**Note:** {% data variables.product.prodname_github_app %} Manifests are currently available for developers to preview. To access this API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header:
+**Note:** {% data variables.product.prodname_github_app %} Manifests are currently available for developers to preview. 要在预览期间访问此 API，必须在 `Accept` 标头中提供自定义[媒体类型](/v3/media)：
 
 ```
 application/vnd.github.fury-preview+json
diff --git a/translations/zh-CN/data/reusables/pre-release-program/machine-man-preview.md b/translations/zh-CN/data/reusables/pre-release-program/machine-man-preview.md
index 8fb50254cd1f..daf65ebc7740 100644
--- a/translations/zh-CN/data/reusables/pre-release-program/machine-man-preview.md
+++ b/translations/zh-CN/data/reusables/pre-release-program/machine-man-preview.md
@@ -1,9 +1,9 @@
 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %}
 {% note %}
 
-**Note:** To access the API with your GitHub App, you must provide a custom [media type](/v3/media) in the `Accept` Header for your requests.
+**注：**要使用 GitHub 应用程序访问 API，您必须在请求的 `Accept` 标头中提供自定义[媒体类型](/v3/media)。
 
 `application/vnd.github.machine-man-preview+json`
 
 {% endnote %}
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/translations/zh-CN/data/reusables/pre-release-program/sailor-v-preview.md b/translations/zh-CN/data/reusables/pre-release-program/sailor-v-preview.md
index 271ed23002c8..71ec207423ec 100644
--- a/translations/zh-CN/data/reusables/pre-release-program/sailor-v-preview.md
+++ b/translations/zh-CN/data/reusables/pre-release-program/sailor-v-preview.md
@@ -1,7 +1,7 @@
 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %}
 {% note %}
 
-**Note:** You can now use the REST API to add a reason when you lock an issue, and you will see lock reasons in responses that include issues or pull requests. You will also see lock reasons in `locked` events. This feature is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2018-01-10-lock-reason-api-preview) for full details. To access this feature, you must provide a custom [media type](/v3/media) in the `Accept` header:
+**注：**您现在可以使用 REST API 在锁定议题时添加原因，并且在包含议题或拉取请求的响应中会看到锁定原因。 在 `locked` 事件中也会看到锁定原因。 此功能目前可供开发者预览。 有关完整详情，请参阅[博客文章](https://developer.github.com/changes/2018-01-10-lock-reason-api-preview)。 要访问此功能，必须在 `Accept` 标头中提供自定义[媒体类型](/v3/media)：
 
 ```
 application/vnd.github.sailor-v-preview+json
diff --git a/translations/zh-CN/data/reusables/pre-release-program/starfox-preview.md b/translations/zh-CN/data/reusables/pre-release-program/starfox-preview.md
index 5de305adb6e7..8e65a4b83c50 100644
--- a/translations/zh-CN/data/reusables/pre-release-program/starfox-preview.md
+++ b/translations/zh-CN/data/reusables/pre-release-program/starfox-preview.md
@@ -1,8 +1,8 @@
 {% note %}
 
-**Note:** Project card details are now shown in REST API responses for project-related issue and timeline events. This feature is now available for developers to preview. For details, see the [blog post](https://developer.github.com/changes/2018-09-05-project-card-events).
+**注：**项目卡详细信息现在显示在项目相关议题和时间线事件的 REST API 响应中。 此功能现在可供开发者预览。 有关详细信息，请参阅[博客文章](https://developer.github.com/changes/2018-09-05-project-card-events)。
 
-To receive the `project_card` attribute, project boards must be [enabled](/articles/disabling-project-boards-in-a-repository) for a repository, and you must provide a custom [media type](/v3/media) in the `Accept` header:
+要接收 `project_card` 属性，必须为仓库[启用](/articles/disabling-project-boards-in-a-repository)项目板，并且必须在 `Accept` 标头中提供自定义[媒体类型](/v3/media)：
 
 ```
 application/vnd.github.starfox-preview+json
diff --git a/translations/zh-CN/data/reusables/pre-release-program/suspend-installation-beta.md b/translations/zh-CN/data/reusables/pre-release-program/suspend-installation-beta.md
index 3d81271d74ca..7cc35f915f27 100644
--- a/translations/zh-CN/data/reusables/pre-release-program/suspend-installation-beta.md
+++ b/translations/zh-CN/data/reusables/pre-release-program/suspend-installation-beta.md
@@ -1,4 +1,5 @@
 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}
-Suspending a {% data variables.product.prodname_github_app %} installation is currently in beta and subject to change. Before you can suspend a {% data variables.product.prodname_github_app %}, the app owner must enable suspending installations for the app by opting-in to the beta. To opt-in to the suspending installations beta feature, see "[Activating beta features for apps](/developers/apps/activating-beta-features-for-apps)."
+Suspending a
+{% data variables.product.prodname_github_app %} installation is currently in beta and subject to change. Before you can suspend a {% data variables.product.prodname_github_app %}, the app owner must enable suspending installations for the app by opting-in to the beta. 要选择加入挂起安装测试版功能，请参阅“[激活应用程序的测试版功能](/developers/apps/activating-beta-features-for-apps)”。
 
 {% endif %}
diff --git a/translations/zh-CN/data/reusables/profile/profile-readme.md b/translations/zh-CN/data/reusables/profile/profile-readme.md
index 6c734861db2e..a00cff249858 100644
--- a/translations/zh-CN/data/reusables/profile/profile-readme.md
+++ b/translations/zh-CN/data/reusables/profile/profile-readme.md
@@ -1 +1 @@
-If you add a README file to the root of a public repository with the same name as your username, that README will automatically appear on your profile page. You can edit your profile README with GitHub Flavored Markdown to create a personalized section on your profile.
\ No newline at end of file
+如果将 README 文件添加到与用户名同名的公共仓库的根目录，则该 README 将自动显示在您的个人资料页面上。 您可以使用 GitHub Flavored Markdown 编辑您的个人资料以在您的个人资料 README，以在您的个人资料上创建个性化的区域。
diff --git a/translations/zh-CN/data/reusables/project-management/link-repos-to-project-board.md b/translations/zh-CN/data/reusables/project-management/link-repos-to-project-board.md
index 66e2c98e6c2a..dc846c443799 100644
--- a/translations/zh-CN/data/reusables/project-management/link-repos-to-project-board.md
+++ b/translations/zh-CN/data/reusables/project-management/link-repos-to-project-board.md
@@ -1 +1 @@
-最多可以将 25 个仓库链接到组织或用户拥有的项目板。 链接仓库后，添加问题和拉取请求更容易，可以使用**{% octicon "plus" aria-label="The Plus icon" %} 添加卡**{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}或者从议题或拉取请求侧边栏{% endif %} 添加。
+最多可以将 25 个仓库链接到组织或用户拥有的项目板。 链接仓库后，添加问题和拉取请求更容易，可以使用**{% octicon "plus" aria-label="The Plus icon" %} 添加卡**或者从议题或拉取请求侧边栏 添加。
diff --git a/translations/zh-CN/data/reusables/project-management/project-board-import-with-api.md b/translations/zh-CN/data/reusables/project-management/project-board-import-with-api.md
index a14ebf87f7d5..2af643bd70c0 100644
--- a/translations/zh-CN/data/reusables/project-management/project-board-import-with-api.md
+++ b/translations/zh-CN/data/reusables/project-management/project-board-import-with-api.md
@@ -1 +1 @@
-可以使用 {% data variables.product.prodname_dotcom %} 的 API 导入项目看板。 For more information, see "[importProject](/v4/mutation/importproject/)."
+可以使用 {% data variables.product.prodname_dotcom %} 的 API 导入项目看板。 更多信息请参阅“[importProject](/graphql/reference/mutations#importproject/)”。
diff --git a/translations/zh-CN/data/reusables/projects/disabled-projects.md b/translations/zh-CN/data/reusables/projects/disabled-projects.md
index 2b10747e7e27..d87339aaacba 100644
--- a/translations/zh-CN/data/reusables/projects/disabled-projects.md
+++ b/translations/zh-CN/data/reusables/projects/disabled-projects.md
@@ -1 +1 @@
-You only see this event in responses when project boards have been [enabled](/articles/disabling-project-boards-in-a-repository) in the repository.
\ No newline at end of file
+仅当在仓库[启用](/articles/disabling-project-boards-in-a-repository)了项目板时，您才会在响应中看到此事件。
diff --git a/translations/zh-CN/data/reusables/pull_requests/automatically-delete-branches.md b/translations/zh-CN/data/reusables/pull_requests/automatically-delete-branches.md
index c9b28029f5e4..82422207876d 100644
--- a/translations/zh-CN/data/reusables/pull_requests/automatically-delete-branches.md
+++ b/translations/zh-CN/data/reusables/pull_requests/automatically-delete-branches.md
@@ -1,3 +1 @@
-{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}
 您可让头部分支在仓库中的拉取请求合并后自动删除。 更多信息请参阅"[管理分支的自动删除](/articles/managing-the-automatic-deletion-of-branches)."。
-{% endif %}
diff --git a/translations/zh-CN/data/reusables/pull_requests/close-issues-using-keywords.md b/translations/zh-CN/data/reusables/pull_requests/close-issues-using-keywords.md
index 850b4a4fffc6..72f338228f76 100644
--- a/translations/zh-CN/data/reusables/pull_requests/close-issues-using-keywords.md
+++ b/translations/zh-CN/data/reusables/pull_requests/close-issues-using-keywords.md
@@ -1 +1 @@
-您可以将拉取请求链接到议题，以便{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}显示正在进行修复并{% endif %}在有人合并拉取请求时自动关闭议题。 更多信息请参阅“[将拉取请求链接到议题](/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue)”。
+You can link a pull request to an issue to{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} show that a fix is in progress and to{% endif %} automatically close the issue when someone merges the pull request. 更多信息请参阅“[将拉取请求链接到议题](/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue)”。
diff --git a/translations/zh-CN/data/reusables/pull_requests/collect-co-author-commit-git-config-info.md b/translations/zh-CN/data/reusables/pull_requests/collect-co-author-commit-git-config-info.md
index 0a986c64e2f3..b832ddb27e54 100644
--- a/translations/zh-CN/data/reusables/pull_requests/collect-co-author-commit-git-config-info.md
+++ b/translations/zh-CN/data/reusables/pull_requests/collect-co-author-commit-git-config-info.md
@@ -1 +1 @@
-1. 收集每位合作作者的姓名和电子邮件地址。{% if currentVersion == "free-pro-team@latest" %} 如果有人选择保密其电子邮件地址，则应使用其 {% data variables.product.product_name %}-提供的 `no-reply` 电子邮件地址以保护其隐私。{% endif %}
+1. Collect the name and email address for each co-author.{% if currentVersion == "free-pro-team@latest" %} If a person chooses to keep their email address private, you should use their {% data variables.product.product_name %}-provided `no-reply` email to protect their privacy.{% endif %}
diff --git a/translations/zh-CN/data/reusables/pull_requests/default-commit-message-squash-merge.md b/translations/zh-CN/data/reusables/pull_requests/default-commit-message-squash-merge.md
index 4d1056d48adb..22ee70c7ae9d 100644
--- a/translations/zh-CN/data/reusables/pull_requests/default-commit-message-squash-merge.md
+++ b/translations/zh-CN/data/reusables/pull_requests/default-commit-message-squash-merge.md
@@ -1 +1 @@
-For information about the default commit messages for squash merges, see "[About pull request merges](/github/collaborating-with-issues-and-pull-requests/about-pull-request-merges#merge-message-for-a-squash-merge)."
\ No newline at end of file
+有关压缩合并的默认提交消息的信息，请参阅“[关于拉取请求合并](/github/collaborating-with-issues-and-pull-requests/about-pull-request-merges#merge-message-for-a-squash-merge)”。
diff --git a/translations/zh-CN/data/reusables/pull_requests/mark-ready-review.md b/translations/zh-CN/data/reusables/pull_requests/mark-ready-review.md
index 84fb74c88b73..e6ba3d8d5bb5 100644
--- a/translations/zh-CN/data/reusables/pull_requests/mark-ready-review.md
+++ b/translations/zh-CN/data/reusables/pull_requests/mark-ready-review.md
@@ -1 +1 @@
-准备获取对拉取请求的反馈时，可将拉取请求草稿标记为可供审查。 将拉取请求标记为可供审查将要求任何代码所有者进行审查。
\ No newline at end of file
+准备获取对拉取请求的反馈时，可将拉取请求草稿标记为可供审查。 将拉取请求标记为可供审查将要求任何代码所有者进行审查。
diff --git a/translations/zh-CN/data/reusables/pull_requests/pull_request_merges_and_contributions.md b/translations/zh-CN/data/reusables/pull_requests/pull_request_merges_and_contributions.md
index 134451752d8a..0d187edc7b2c 100644
--- a/translations/zh-CN/data/reusables/pull_requests/pull_request_merges_and_contributions.md
+++ b/translations/zh-CN/data/reusables/pull_requests/pull_request_merges_and_contributions.md
@@ -1,6 +1,6 @@
 {% note %}
 
-**注：**{% if currentVersion != "free-pro-team@latest" %}
+**Notes:**{% if currentVersion != "free-pro-team@latest" %}
 - 要显示在您的个人资料贡献图中，合作提交必须符合与只有一个作者的提交相同的条件。{% endif %}
 - 在变基提交时，提交的原作者和提交的变基者（无论是在命令行还是 {% data variables.product.product_location %} 上）都会获得贡献积分。
 
diff --git a/translations/zh-CN/data/reusables/reminders/author-reviews.md b/translations/zh-CN/data/reusables/reminders/author-reviews.md
index 0089266d2906..acb6168412fb 100644
--- a/translations/zh-CN/data/reusables/reminders/author-reviews.md
+++ b/translations/zh-CN/data/reusables/reminders/author-reviews.md
@@ -1 +1 @@
-1. （可选）要在完成对拉取请求的评论后提醒请求的作者，请选择 **Remind authors after reviews（评论后提醒作者）**，并选择达到多少条评论后发送提醒。 ![评论后提醒作者复选框](/assets/images/help/settings/scheduled-reminders-remind-authors.png)
\ No newline at end of file
+1. （可选）要在完成对拉取请求的评论后提醒请求的作者，请选择 **Remind authors after reviews（评论后提醒作者）**，并选择达到多少条评论后发送提醒。 ![评论后提醒作者复选框](/assets/images/help/settings/scheduled-reminders-remind-authors.png)
diff --git a/translations/zh-CN/data/reusables/reminders/ignored-labels.md b/translations/zh-CN/data/reusables/reminders/ignored-labels.md
index a5c95a29d122..5cabf0b258b7 100644
--- a/translations/zh-CN/data/reusables/reminders/ignored-labels.md
+++ b/translations/zh-CN/data/reusables/reminders/ignored-labels.md
@@ -1 +1 @@
-1. 在“Ignored labels（忽略的标签）”下，键入以逗号分隔的标签列表。 预定提醒不包括具有其中一个或多个这些标签的任何拉取请求。 ![忽略的标签字段](/assets/images/help/settings/scheduled-reminders-ignored-labels-field.png)
\ No newline at end of file
+1. 在“Ignored labels（忽略的标签）”下，键入以逗号分隔的标签列表。 预定提醒不包括具有其中一个或多个这些标签的任何拉取请求。 ![忽略的标签字段](/assets/images/help/settings/scheduled-reminders-ignored-labels-field.png)
diff --git a/translations/zh-CN/data/reusables/reminders/ignored-terms.md b/translations/zh-CN/data/reusables/reminders/ignored-terms.md
index 729cf07d92f0..1c56115f8928 100644
--- a/translations/zh-CN/data/reusables/reminders/ignored-terms.md
+++ b/translations/zh-CN/data/reusables/reminders/ignored-terms.md
@@ -1 +1 @@
-1. 在“Ignored terms（忽略的术语）”下，键入可能出现在拉取请求标题中的逗号分隔的术语列表。 预定提醒不包括其标题中含有其中一个或多个术语的任何拉取请求。 ![忽略的术语字段](/assets/images/help/settings/scheduled-reminders-ignored-terms-field.png)
\ No newline at end of file
+1. 在“Ignored terms（忽略的术语）”下，键入可能出现在拉取请求标题中的逗号分隔的术语列表。 预定提醒不包括其标题中含有其中一个或多个术语的任何拉取请求。 ![忽略的术语字段](/assets/images/help/settings/scheduled-reminders-ignored-terms-field.png)
diff --git a/translations/zh-CN/data/reusables/reminders/min-age.md b/translations/zh-CN/data/reusables/reminders/min-age.md
index 32c69953155f..380306712eef 100644
--- a/translations/zh-CN/data/reusables/reminders/min-age.md
+++ b/translations/zh-CN/data/reusables/reminders/min-age.md
@@ -1 +1 @@
-1. 在“Minimum age（最小存在时间）”下，键入拉取请求存在的时长（小时）。 预定提醒不包括晚于此时间的拉取请求。 ![忽略的标签字段](/assets/images/help/settings/scheduled-reminders-min-age-field.png)
\ No newline at end of file
+1. 在“Minimum age（最小存在时间）”下，键入拉取请求存在的时长（小时）。 预定提醒不包括晚于此时间的拉取请求。 ![忽略的标签字段](/assets/images/help/settings/scheduled-reminders-min-age-field.png)
diff --git a/translations/zh-CN/data/reusables/reminders/min-staleness.md b/translations/zh-CN/data/reusables/reminders/min-staleness.md
index 5af315cb858a..b47930971557 100644
--- a/translations/zh-CN/data/reusables/reminders/min-staleness.md
+++ b/translations/zh-CN/data/reusables/reminders/min-staleness.md
@@ -1 +1 @@
-1. 在“Minimum staleness（最短过时）”下，键入自上次对拉取请求执行次活动以来的时间。 预定提醒不包括其最后一次活动时间比目前时间更晚的拉取请求。 ![最短过时字段](/assets/images/help/settings/scheduled-reminders-min-staleness-field.png)
\ No newline at end of file
+1. 在“Minimum staleness（最短过时）”下，键入自上次对拉取请求执行次活动以来的时间。 预定提醒不包括其最后一次活动时间比目前时间更晚的拉取请求。 ![最短过时字段](/assets/images/help/settings/scheduled-reminders-min-staleness-field.png)
diff --git a/translations/zh-CN/data/reusables/reminders/real-time-alerts.md b/translations/zh-CN/data/reusables/reminders/real-time-alerts.md
index bd4441049c04..bfd11f78b3cd 100644
--- a/translations/zh-CN/data/reusables/reminders/real-time-alerts.md
+++ b/translations/zh-CN/data/reusables/reminders/real-time-alerts.md
@@ -1 +1 @@
-1. （可选）要在特定事件发生后立即收到 Slack 消息，请选择 **Enable real-time alerts（启用实时警报）**并选择要接收其实时警报的事件。
\ No newline at end of file
+1. （可选）要在特定事件发生后立即收到 Slack 消息，请选择 **Enable real-time alerts（启用实时警报）**并选择要接收其实时警报的事件。
diff --git a/translations/zh-CN/data/reusables/reminders/required-labels.md b/translations/zh-CN/data/reusables/reminders/required-labels.md
index d9d28713fb6a..e71fc6eb2881 100644
--- a/translations/zh-CN/data/reusables/reminders/required-labels.md
+++ b/translations/zh-CN/data/reusables/reminders/required-labels.md
@@ -1 +1 @@
-1. 在“Required labels（必需的标签）”下，键入以逗号分隔的标签列表。 预定提醒仅包括尚未忽略的拉取请求（如果它们具有其中一个或多个标签）。 ![必需的标签字段](/assets/images/help/settings/scheduled-reminders-required-labels-field.png)
\ No newline at end of file
+1. 在“Required labels（必需的标签）”下，键入以逗号分隔的标签列表。 预定提醒仅包括尚未忽略的拉取请求（如果它们具有其中一个或多个标签）。 ![必需的标签字段](/assets/images/help/settings/scheduled-reminders-required-labels-field.png)
diff --git a/translations/zh-CN/data/reusables/repositories/a-vulnerability-is.md b/translations/zh-CN/data/reusables/repositories/a-vulnerability-is.md
index 78ddb6bfc40f..cda2bd873545 100644
--- a/translations/zh-CN/data/reusables/repositories/a-vulnerability-is.md
+++ b/translations/zh-CN/data/reusables/repositories/a-vulnerability-is.md
@@ -1 +1 @@
-漏洞是项目代码中的问题，可能被利用来损害机密性、完整性或者该项目或其他使用其代码的项目的可用性。 Vulnerabilities vary in type, severity, and method of attack.
+漏洞是项目代码中的问题，可能被利用来损害机密性、完整性或者该项目或其他使用其代码的项目的可用性。 漏洞的类型、严重性和攻击方法各不相同。
diff --git a/translations/zh-CN/data/reusables/repositories/about-github-archive-program.md b/translations/zh-CN/data/reusables/repositories/about-github-archive-program.md
index a82f075a32e6..b1351ab3ff74 100644
--- a/translations/zh-CN/data/reusables/repositories/about-github-archive-program.md
+++ b/translations/zh-CN/data/reusables/repositories/about-github-archive-program.md
@@ -1 +1 @@
-默认情况下，所有公共仓库均包含在 {% data variables.product.prodname_archive %} 中，即 {% data variables.product.prodname_dotcom %} 与 Software Heritage Foundation、Internet Archive 等组织之间的伙伴关系，以确保长期保存世界上的开源软件。
\ No newline at end of file
+默认情况下，所有公共仓库均包含在 {% data variables.product.prodname_archive %} 中，即 {% data variables.product.prodname_dotcom %} 与 Software Heritage Foundation、Internet Archive 等组织之间的伙伴关系，以确保长期保存世界上的开源软件。
diff --git a/translations/zh-CN/data/reusables/repositories/about-internal-repos.md b/translations/zh-CN/data/reusables/repositories/about-internal-repos.md
index 6177f09d901b..d921cfd13384 100644
--- a/translations/zh-CN/data/reusables/repositories/about-internal-repos.md
+++ b/translations/zh-CN/data/reusables/repositories/about-internal-repos.md
@@ -1 +1 @@
-您可以使用内部仓库充分利用{% if currentVersion == "free-pro-team@latest" %}企业帐户{% else %}实例{% endif %}中的“内部资源”。 {% if currentVersion == "free-pro-team@latest" %}企业帐户{% else %}实例上任何组织{% endif %}的成员可使用开源方法进行协作，而无需公开共享专有信息{% if currentVersion != "free-pro-team@latest" %}，即使禁用了私有模式{% endif %}。
+You can use internal repositories to practice "innersource" within your {% if currentVersion == "free-pro-team@latest" %}enterprise account{% else %}instance{% endif %}. Members of {% if currentVersion == "free-pro-team@latest" %}your enterprise account{% else %}any organization on your instance{% endif %} can collaborate using open source methodologies without sharing proprietary information publicly{% if currentVersion != "free-pro-team@latest" %}, even with private mode disabled{% endif %}.
diff --git a/translations/zh-CN/data/reusables/repositories/actions-scheduled-workflow-example.md b/translations/zh-CN/data/reusables/repositories/actions-scheduled-workflow-example.md
index 6a7b862a9ba2..808519c8b6e1 100644
--- a/translations/zh-CN/data/reusables/repositories/actions-scheduled-workflow-example.md
+++ b/translations/zh-CN/data/reusables/repositories/actions-scheduled-workflow-example.md
@@ -1,4 +1,4 @@
-您可以使用 [POSIX cron 语法](https://pubs.opengroup.org/onlinepubs/9699919799/utilities/crontab.html#tag_20_25_07)安排工作流程在特定的 UTC 时间运行。 预定的工作流程在默认或基础分支的最新提交上运行。 可以运行计划工作流的最短间隔是每 5 分钟一次。
+您可以使用 [POSIX cron 语法](https://pubs.opengroup.org/onlinepubs/9699919799/utilities/crontab.html#tag_20_25_07)安排工作流程在特定的 UTC 时间运行。 预定的工作流程在默认或基础分支的最新提交上运行。 您可以运行预定工作流程的最短间隔是每 5 分钟一次。
 
 此示例每隔 15 分钟触发工作流程：
 
diff --git a/translations/zh-CN/data/reusables/repositories/actions-workflow-status-badge-into.md b/translations/zh-CN/data/reusables/repositories/actions-workflow-status-badge-into.md
index 786d93a478b6..4bd93894b914 100644
--- a/translations/zh-CN/data/reusables/repositories/actions-workflow-status-badge-into.md
+++ b/translations/zh-CN/data/reusables/repositories/actions-workflow-status-badge-into.md
@@ -1,3 +1,3 @@
-状态徽章显示工作流程目前失败还是通过。 添加状态徽章的常见位置是仓库的 README.md 文件，但也可将其添加到您喜欢的任何网页。 By default, badges display the status of your default branch. 您也可以在 URL 中使用 `branch` 和 `event` 查询参数显示特定分支或事件运行的工作流程状态。
+A status badge shows whether a workflow is currently failing or passing. 添加状态徽章的常见位置是仓库的 README.md 文件，但也可将其添加到您喜欢的任何网页。 默认情况下，徽章显示默认分支的状态。 您也可以在 URL 中使用 `branch` 和 `event` 查询参数显示特定分支或事件运行的工作流程状态。
 
-![example status badge](/assets/images/help/repository/actions-workflow-status-badge.png)
+![示例状态徽章](/assets/images/help/repository/actions-workflow-status-badge.png)
diff --git a/translations/zh-CN/data/reusables/repositories/blocked-passwords.md b/translations/zh-CN/data/reusables/repositories/blocked-passwords.md
index 0831256bc863..d310d3bb508b 100644
--- a/translations/zh-CN/data/reusables/repositories/blocked-passwords.md
+++ b/translations/zh-CN/data/reusables/repositories/blocked-passwords.md
@@ -1,5 +1,6 @@
 {% if currentVersion == "free-pro-team@latest" %}
-在输入密码进行登录、创建帐户或更改密码时，{% data variables.product.product_name %} 将根据 HaveIBeenPwned 等资料集检查您输入的密码是否被视为弱密码。 即使是以前从未用过的密码，也可能被视为弱密码。
+When you type a password to sign in, create an account, or change your password,
+{% data variables.product.product_name %} will check if the password you entered is considered weak according to datasets like HaveIBeenPwned. 即使是以前从未用过的密码，也可能被视为弱密码。
 
 {% data variables.product.product_name %} 仅在您输入密码时检查密码，绝不会以纯文本存储您输入的密码。 更多信息请参阅 [HaveIBeenPwned](https://haveibeenpwned.com/)。
 {% endif %}
diff --git a/translations/zh-CN/data/reusables/repositories/choose-repo-visibility.md b/translations/zh-CN/data/reusables/repositories/choose-repo-visibility.md
index ff7034e93346..51929d753a82 100644
--- a/translations/zh-CN/data/reusables/repositories/choose-repo-visibility.md
+++ b/translations/zh-CN/data/reusables/repositories/choose-repo-visibility.md
@@ -1 +1 @@
-1. Choose a repository visibility. 更多信息请参阅“[关于仓库可见性](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)”。 ![选择仓库可见性的单选按钮](/assets/images/help/repository/create-repository-public-private.png)
+1. 选择仓库可见性。 更多信息请参阅“[关于仓库可见性](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)”。 ![选择仓库可见性的单选按钮](/assets/images/help/repository/create-repository-public-private.png)
diff --git a/translations/zh-CN/data/reusables/repositories/copy-clone-url.md b/translations/zh-CN/data/reusables/repositories/copy-clone-url.md
index 025fdc7e8307..c1c554f63bf2 100644
--- a/translations/zh-CN/data/reusables/repositories/copy-clone-url.md
+++ b/translations/zh-CN/data/reusables/repositories/copy-clone-url.md
@@ -1,15 +1,15 @@
 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %}
 1. 在仓库名称下，单击 **Clone or download（克隆或下载）**。 ![克隆或下载按钮](/assets/images/help/repository/clone-repo-clone-url-button.png)
-2. To clone the repository using HTTPS, under "Clone with HTTPS", click
+2. 要使用 HTTPS 克隆仓库，请在“Clone with HTTPS（使用 HTTPS 克隆）”下单击
+{% octicon "clippy" aria-label="The clipboard icon" %}.
+To clone the repository using an SSH key, including a certificate issued by your organization's SSH certificate authority, click **Use SSH**, then click
 {% octicon "clippy" aria-label="The clipboard icon" %}.
-To clone the repository using an SSH key
-{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, including a certificate issued by your organization's SSH certificate authority,{% endif %} click **Use SSH**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.
 ![克隆 URL 按钮](/assets/images/help/repository/https-url-clone.png)
 {% else %}
-1. Above the list of files, click {% octicon "download" aria-label="The download icon" %} **Code**. !["Code" button](/assets/images/help/repository/code-button.png)
-1. To clone the repository using HTTPS, under "Clone with HTTPS", click
-{% octicon "clippy" aria-label="The clipboard icon" %}. To clone the repository using an SSH key{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, including a certificate issued by your organization's SSH certificate authority,{% endif %} click **Use SSH**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} To clone a repository using {% data variables.product.prodname_cli %}, click **Use {% data variables.product.prodname_cli %}**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.{% endif %}
-  ![The clipboard icon for copying the URL to clone a repository](/assets/images/help/repository/https-url-clone.png)
+1. 在文件列表上方，单击 {% octicon "download" aria-label="The download icon" %} ****Code（代码）。 !["代码"按钮](/assets/images/help/repository/code-button.png)
+1. 要使用 HTTPS 克隆仓库，请在“Clone with HTTPS（使用 HTTPS 克隆）”下单击
+{% octicon "clippy" aria-label="The clipboard icon" %}. To clone the repository using an SSH key, including a certificate issued by your organization's SSH certificate authority, click **Use SSH**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} To clone a repository using {% data variables.product.prodname_cli %}, click **Use {% data variables.product.prodname_cli %}**, then click {% octicon "clippy" aria-label="The clipboard icon" %}.{% endif %}
+  ![用于复制 URL 以克隆仓库的剪贴板图标](/assets/images/help/repository/https-url-clone.png)
   {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}
-  ![The clipboard icon for copying the URL to clone a repository with GitHub CLI](/assets/images/help/repository/https-url-clone-cli.png){% endif %}
+  ![用于复制 URL 以使用 GitHub CLI 克隆仓库的剪贴板图标](/assets/images/help/repository/https-url-clone-cli.png){% endif %}
 {% endif %}
diff --git a/translations/zh-CN/data/reusables/repositories/default-issue-templates.md b/translations/zh-CN/data/reusables/repositories/default-issue-templates.md
index 667d585ed551..c9652131f9d1 100644
--- a/translations/zh-CN/data/reusables/repositories/default-issue-templates.md
+++ b/translations/zh-CN/data/reusables/repositories/default-issue-templates.md
@@ -1,2 +1,2 @@
-您可以创建默认的议题模板{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}和议题模板的默认配置文件{% endif %}，适用于您的组织{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}或用户帐户{% endif %}。 更多信息请参阅“[创建默认社区健康文件](/github/building-a-strong-community/creating-a-default-community-health-file)”。
+You can create default issue templates{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} and a default configuration file for issue templates{% endif %} for your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or user account{% endif %}. 更多信息请参阅“[创建默认社区健康文件](/github/building-a-strong-community/creating-a-default-community-health-file)”。
 
diff --git a/translations/zh-CN/data/reusables/repositories/deleted_forks_from_private_repositories_warning.md b/translations/zh-CN/data/reusables/repositories/deleted_forks_from_private_repositories_warning.md
index bdb183317a0e..bad215d4864f 100644
--- a/translations/zh-CN/data/reusables/repositories/deleted_forks_from_private_repositories_warning.md
+++ b/translations/zh-CN/data/reusables/repositories/deleted_forks_from_private_repositories_warning.md
@@ -2,10 +2,10 @@
 
 **警告：**
 
-- 如果您删除某人访问私有仓库的权限，则其对该私有仓库的任何复刻也会被删除。 将保留私人仓库的本地克隆。 如果撤销团队对私有仓库的访问权限，或者删除对私有仓库具有访问权限的团队，并且团队成员无法通过另一个团队访问仓库，则该仓库的私有复刻将被删除。{% if currentVersion != "free-pro-team@latest" %}
-- 当 [LDAP 同步启用](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap/#enabling-ldap-sync)后，如果从仓库删除某用户，此用户将失去访问权，但其复刻不会被删除。 如果此用户在三个月内被加入具有原组织仓库访问权限的团队，则其对复刻的访问权限将在下次同步时自动恢复。{% endif %}
+- 如果您删除某人访问私有仓库的权限，则其对该私有仓库的任何复刻也会被删除。 将保留私人仓库的本地克隆。 If a team's access to a private repository is revoked or a team with access to a private repository is deleted, and team members do not have access to the repository through another team, private forks of the repository will be deleted.{% if currentVersion != "free-pro-team@latest" %}
+- 当 [LDAP 同步启用](/enterprise/{{ page.version }}/admin/guides/user-management/using-ldap/#enabling-ldap-sync)后，如果从仓库删除某用户，此用户将失去访问权，但其复刻不会被删除。 如果此用户在三个月内被加入具有原组织仓库访问权限的团队，则其对复刻的访问权限将在下次同步时自动恢复。{% endif %}
 - 您负责确保无法访问仓库的人员删除任何机密信息或知识产权。
 
-- 对私有{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}或内部{% endif %}仓库拥有管理员权限的人可以禁止对该仓库进行复刻，组织所有者可以禁止对组织中的任何私有{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}或内部{% endif %}仓库进行复刻。 更多信息请参阅“[管理组织的复刻政策](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization)”和“[管理仓库的复刻政策](/github/administering-a-repository/managing-the-forking-policy-for-your-repository)”。
+- People with admin permissions to a private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %} repository can disallow forking of that repository, and organization owners can disallow forking of any private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} or internal{% endif %} repository in an organization. 更多信息请参阅“[管理组织的复刻政策](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization)”和“[管理仓库的复刻政策](/github/administering-a-repository/managing-the-forking-policy-for-your-repository)”。
 
 {% endwarning %}
diff --git a/translations/zh-CN/data/reusables/repositories/deploy-keys.md b/translations/zh-CN/data/reusables/repositories/deploy-keys.md
index ae039b459e33..b95edf7cd074 100644
--- a/translations/zh-CN/data/reusables/repositories/deploy-keys.md
+++ b/translations/zh-CN/data/reusables/repositories/deploy-keys.md
@@ -1 +1 @@
-You can launch projects from a {% data variables.product.product_name %} repository to your server by using a deploy key, which is an SSH key that grants access to a single repository. {% data variables.product.product_name %} attaches the public part of the key directly to your repository instead of a personal user account, and the private part of the key remains on your server. For more information, see "[Delivering deployments](/v3/guides/delivering-deployments/)."
+You can launch projects from a {% data variables.product.product_name %} repository to your server by using a deploy key, which is an SSH key that grants access to a single repository. {% data variables.product.product_name %} attaches the public part of the key directly to your repository instead of a personal user account, and the private part of the key remains on your server. 更多信息请参阅“[交付部署](/v3/guides/delivering-deployments/)”。
diff --git a/translations/zh-CN/data/reusables/repositories/enable-security-alerts.md b/translations/zh-CN/data/reusables/repositories/enable-security-alerts.md
index 292e4c32338e..b3b7d90a4f59 100644
--- a/translations/zh-CN/data/reusables/repositories/enable-security-alerts.md
+++ b/translations/zh-CN/data/reusables/repositories/enable-security-alerts.md
@@ -1,4 +1,4 @@
 {% if currentVersion != "free-pro-team@latest" %}
-Your site administrator must enable
-站点管理员必须先对 {% data variables.product.product_location_enterprise %} 易受攻击的依赖项启用安全警报，然后您才可使用此功能。 更多信息请参阅“[为 {% data variables.product.prodname_ghe_server %} 上易受攻击的依赖项启用安全警报](/enterprise/{{ currentVersion }}/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server)”。
+您的站点管理员必须启用
+{% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_short %}{% else %}security{% endif %} alerts for vulnerable dependencies for {% data variables.product.product_location_enterprise %} before you can use this feature. For more information, see "[Enabling alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server)."
 {% endif %}
diff --git a/translations/zh-CN/data/reusables/repositories/navigate-to-job-superlinter.md b/translations/zh-CN/data/reusables/repositories/navigate-to-job-superlinter.md
new file mode 100644
index 000000000000..32288f38878d
--- /dev/null
+++ b/translations/zh-CN/data/reusables/repositories/navigate-to-job-superlinter.md
@@ -0,0 +1,5 @@
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+1. 在左侧边栏中，单击您要查看的作业。 ![Lint 代码库作业](/assets/images/help/repository/superlinter-lint-code-base-job.png)
+{% else %}
+1. 在左侧边栏中，单击您要查看的作业。 ![Select a workflow job](/assets/images/help/repository/workflow-job.png)
+{% endif %}
\ No newline at end of file
diff --git a/translations/zh-CN/data/reusables/repositories/navigate-to-workflow-superlinter.md b/translations/zh-CN/data/reusables/repositories/navigate-to-workflow-superlinter.md
new file mode 100644
index 000000000000..b70f23194072
--- /dev/null
+++ b/translations/zh-CN/data/reusables/repositories/navigate-to-workflow-superlinter.md
@@ -0,0 +1 @@
+1. 在左侧边栏中，单击您想要查看的工作流程。 ![左侧边栏中的工作流程列表](/assets/images/help/repository/superlinter-workflow-sidebar.png)
\ No newline at end of file
diff --git a/translations/zh-CN/data/reusables/repositories/new-pull-request.md b/translations/zh-CN/data/reusables/repositories/new-pull-request.md
index 4633142053ae..4b809bd9441c 100644
--- a/translations/zh-CN/data/reusables/repositories/new-pull-request.md
+++ b/translations/zh-CN/data/reusables/repositories/new-pull-request.md
@@ -1,7 +1,7 @@
 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %}
-1. 对于 Branch（分支）菜单右侧，单击 **New pull request（新拉取请求）**。 !["Pull request" link above list of files](/assets/images/help/pull_requests/pull-request-start-review-button.png)
+1. 对于 Branch（分支）菜单右侧，单击 **New pull request（新拉取请求）**。 ![文件列表上方的"拉取请求"链接](/assets/images/help/pull_requests/pull-request-start-review-button.png)
 {% else %}
-1. Above the list of files, click
-{% octicon "git-pull-request" aria-label="The pull request icon" %} **Pull request**.
-  !["Pull request" link above list of files](/assets/images/help/pull_requests/pull-request-start-review-button.png)
+1. 在文件列表上方，单击
+{% octicon "git-pull-request" aria-label="The pull request icon" %} **拉取请求**。
+  ![文件列表上方的"拉取请求"链接](/assets/images/help/pull_requests/pull-request-start-review-button.png)
 {% endif %}
diff --git a/translations/zh-CN/data/reusables/repositories/open-with-github-desktop.md b/translations/zh-CN/data/reusables/repositories/open-with-github-desktop.md
index 59cfd17a0467..168cd1e82634 100644
--- a/translations/zh-CN/data/reusables/repositories/open-with-github-desktop.md
+++ b/translations/zh-CN/data/reusables/repositories/open-with-github-desktop.md
@@ -1,9 +1,11 @@
 {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.22" %}
 1. 在仓库名称下，单击 **Clone or download（克隆或下载）**。 ![克隆或下载按钮](/assets/images/help/repository/clone-repo-clone-url-button.png)
-1. 单击**Open in Desktop（在 Desktop 中打开）**以克隆仓库并在 {% data variables.product.prodname_desktop %} 中打开。 ![“在 Desktop 中打开”按钮](/assets/images/help/desktop/open-in-desktop-button.png)
+1. Click **Open in Desktop** to clone the repository and open it in
+{% data variables.product.prodname_desktop %}.
+![“在 Desktop 中打开”按钮](/assets/images/help/desktop/open-in-desktop-button.png)
 {% else %}
-1. Above the list of files, click {% octicon "download" aria-label="The download icon" %} **Code**. !["Code" button](/assets/images/help/repository/code-button.png)
-1. Click
+1. 在文件列表上方，单击 {% octicon "download" aria-label="The download icon" %} ****Code（代码）。 !["代码"按钮](/assets/images/help/repository/code-button.png)
+1. 单击
 {% octicon "desktop-download" aria-label="The GitHub Desktop download icon" %} **Open with {% data variables.product.prodname_desktop %}** to clone and open the repository with {% data variables.product.prodname_desktop %}.
   !["Open with {% data variables.product.prodname_desktop %}" button](/assets/images/help/repository/open-with-desktop.png)
 {% endif %}
diff --git a/translations/zh-CN/data/reusables/repositories/permissions-statement-read.md b/translations/zh-CN/data/reusables/repositories/permissions-statement-read.md
index 4bc945505125..241fdd2ba86a 100644
--- a/translations/zh-CN/data/reusables/repositories/permissions-statement-read.md
+++ b/translations/zh-CN/data/reusables/repositories/permissions-statement-read.md
@@ -1 +1 @@
-对仓库具有读取权限的用户可以执行这些步骤。
\ No newline at end of file
+Read access to the repository is required to perform these steps.
diff --git a/translations/zh-CN/data/reusables/repositories/permissions-statement-write.md b/translations/zh-CN/data/reusables/repositories/permissions-statement-write.md
index e25d6225aef6..457fe0472478 100644
--- a/translations/zh-CN/data/reusables/repositories/permissions-statement-write.md
+++ b/translations/zh-CN/data/reusables/repositories/permissions-statement-write.md
@@ -1 +1 @@
-对仓库具有写入级权限的用户可以执行这些步骤。
\ No newline at end of file
+Write access to the repository is required to perform these steps.
diff --git a/translations/zh-CN/data/reusables/repositories/releases.md b/translations/zh-CN/data/reusables/repositories/releases.md
index e03bb68b9c1a..9b8079113136 100644
--- a/translations/zh-CN/data/reusables/repositories/releases.md
+++ b/translations/zh-CN/data/reusables/repositories/releases.md
@@ -4,6 +4,6 @@
 
 {% else %}
 
-1. To the right of the list of files, click **Releases** or **Latest release**. ![Releases section in right-hand sidebar](/assets/images/help/releases/release-link.png)
+1. 对于文件列表的右侧，单击 **Releases（发行版）**或 **Latest release（最新发行版）**。 ![右侧边栏中的 Releases（发行版）部分](/assets/images/help/releases/release-link.png)
 
 {% endif %}
diff --git a/translations/zh-CN/data/reusables/repositories/request-changes-tips.md b/translations/zh-CN/data/reusables/repositories/request-changes-tips.md
index ad34055ebfed..c3b442cc099c 100644
--- a/translations/zh-CN/data/reusables/repositories/request-changes-tips.md
+++ b/translations/zh-CN/data/reusables/repositories/request-changes-tips.md
@@ -1,6 +1,6 @@
 {% tip %}
 
-**Tips**:
+**提示**：
 - 如果启用了必需的审查，并且对仓库具有_写入_、_管理员_或_所有者_访问权限的协作者提交请求更改的审查，则在同一协作者提交另一次要求批准拉取请求中更改的审查之前，拉请求不能合并。
 - 即使没有获得批准审查，或者请求更改的审查者离开了组织或者联系不上，仓库所有者和管理员也可合并拉取请求。
 - 如果同时启用了必需审查和过期审查，并且代码修改提交已推送到批准的拉取请求分支，则批准将予驳回。 拉取请求必须经过再次审查和批准才可合并。
diff --git a/translations/zh-CN/data/reusables/repositories/request-security-advisory-cve-id.md b/translations/zh-CN/data/reusables/repositories/request-security-advisory-cve-id.md
index af2abad6474c..0bdce7dad2c4 100644
--- a/translations/zh-CN/data/reusables/repositories/request-security-advisory-cve-id.md
+++ b/translations/zh-CN/data/reusables/repositories/request-security-advisory-cve-id.md
@@ -1 +1 @@
-如果项目中尚无表示安全漏洞的 CVE 识别码，您可以从 {% data variables.product.prodname_dotcom %} 请求一个 CVE 识别码。 {% data variables.product.prodname_dotcom %} usually reviews the request within 72 hours. Requesting a CVE identification number doesn't make your security advisory public. If your security advisory is eligible for a CVE,  {% data variables.product.prodname_dotcom %} will reserve a CVE identification number for your advisory. We'll then publish the CVE details after you publish the security advisory.
+如果项目中尚无表示安全漏洞的 CVE 识别码，您可以从 {% data variables.product.prodname_dotcom %} 请求一个 CVE 识别码。 {% data variables.product.prodname_dotcom %} usually reviews the request within 72 hours. 请求 CVE 识别码不会公开您的安全通告。 If your security advisory is eligible for a CVE,  {% data variables.product.prodname_dotcom %} will reserve a CVE identification number for your advisory. 然后，我们将在发布安全通告后发布 CVE 详细信息。
diff --git a/translations/zh-CN/data/reusables/repositories/security-alert-delivery-options.md b/translations/zh-CN/data/reusables/repositories/security-alert-delivery-options.md
index 52fa3577de73..941aba71648a 100644
--- a/translations/zh-CN/data/reusables/repositories/security-alert-delivery-options.md
+++ b/translations/zh-CN/data/reusables/repositories/security-alert-delivery-options.md
@@ -1 +1 @@
-如果您的仓库具有支持的依赖关系清单{% if currentVersion == "free-pro-team@latest" %}（并且对私有仓库设置了依赖图）{% endif %}，则只要 {% data variables.product.product_name %} 检测到仓库中易受攻击的依赖项，您就会收到每周摘要电子邮件。 您也可以在 {% data variables.product.product_name %} 界面中将安全警报配置为 web 通知、单个电子邮件通知、每日电子邮件摘要或警报。 更多信息请参阅“[关于易受攻击的依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)”。
+If your repository has a supported dependency manifest{% if currentVersion == "free-pro-team@latest" %} (and if you've set up the dependency graph if it's a private repository){% endif %}, whenever {% data variables.product.product_name %} detects a vulnerable dependency in your repository, you will receive a weekly digest email. 您也可以在 {% data variables.product.product_name %} 界面中将安全警报配置为 web 通知、单个电子邮件通知、每日电子邮件摘要或警报。 更多信息请参阅“[关于易受攻击的依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)”。
diff --git a/translations/zh-CN/data/reusables/repositories/security-alerts-x-github-severity.md b/translations/zh-CN/data/reusables/repositories/security-alerts-x-github-severity.md
index 939741a9ec35..7230ee99948a 100644
--- a/translations/zh-CN/data/reusables/repositories/security-alerts-x-github-severity.md
+++ b/translations/zh-CN/data/reusables/repositories/security-alerts-x-github-severity.md
@@ -1 +1 @@
-Email notifications for {% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} that affect one or more repositories include the `X-GitHub-Severity`  header field. You can use the value of the `X-GitHub-Severity` header field to filter email notifications for {% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %}. You can use the value of the `X-GitHub-Severity` header field to filter email notifications for {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %}.
\ No newline at end of file
+Email notifications for {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} that affect one or more repositories include the `X-GitHub-Severity`  header field. You can use the value of the `X-GitHub-Severity` header field to filter email notifications for {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %}.
diff --git a/translations/zh-CN/data/reusables/repositories/select-marketplace-apps.md b/translations/zh-CN/data/reusables/repositories/select-marketplace-apps.md
index 02bbbae69b40..60f3fa4095e4 100644
--- a/translations/zh-CN/data/reusables/repositories/select-marketplace-apps.md
+++ b/translations/zh-CN/data/reusables/repositories/select-marketplace-apps.md
@@ -1,3 +1,5 @@
 {% if currentVersion == "free-pro-team@latest" %}
-1. （可选）如果您创建的个人帐户或组织使用来自 {% data variables.product.prodname_marketplace %} 的任何 {% data variables.product.prodname_github_app %}，请选择要用于仓库中的任何应用程序。 ![帐户中来自 {% data variables.product.prodname_marketplace %} 的 {% data variables.product.prodname_github_app %} 列表和授予权限选项](/assets/images/help/repository/create-repository-choose-marketplace-apps.png)
+1. Optionally, if the personal account or organization in which you're creating uses any
+{% data variables.product.prodname_github_app %}s from {% data variables.product.prodname_marketplace %}, select any apps you'd like to use in the repository.
+  ![帐户中来自 {% data variables.product.prodname_marketplace %} 的 {% data variables.product.prodname_github_app %} 列表和授予权限选项](/assets/images/help/repository/create-repository-choose-marketplace-apps.png)
 {% endif %}
diff --git a/translations/zh-CN/data/reusables/repositories/sidebar-dependabot-alerts.md b/translations/zh-CN/data/reusables/repositories/sidebar-dependabot-alerts.md
index 74585315b209..b7eadd335c26 100644
--- a/translations/zh-CN/data/reusables/repositories/sidebar-dependabot-alerts.md
+++ b/translations/zh-CN/data/reusables/repositories/sidebar-dependabot-alerts.md
@@ -1 +1 @@
-1. In the security sidebar, click **{% data variables.product.prodname_dependabot_short %} alerts**. ![{% data variables.product.prodname_dependabot_short %} alerts tab](/assets/images/help/repository/dependabot-alerts-tab.png)
\ No newline at end of file
+1. In the security sidebar, click **{% data variables.product.prodname_dependabot_short %} alerts**. ![{% data variables.product.prodname_dependabot_short %} alerts tab](/assets/images/help/repository/dependabot-alerts-tab.png)
diff --git a/translations/zh-CN/data/reusables/repositories/squash-and-rebase-linear-commit-hisitory.md b/translations/zh-CN/data/reusables/repositories/squash-and-rebase-linear-commit-hisitory.md
index 38f6cb940a8d..915c5115b8cc 100644
--- a/translations/zh-CN/data/reusables/repositories/squash-and-rebase-linear-commit-hisitory.md
+++ b/translations/zh-CN/data/reusables/repositories/squash-and-rebase-linear-commit-hisitory.md
@@ -1 +1 @@
-{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}如果你的仓库中有需要线性提交历史记录的受保护分支规则，必须允许压缩合并和/或变基合并。 更多信息请参阅“[需要线性提交历史记录](/github/administering-a-repository/requiring-a-linear-commit-history)”。{% endif %}
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}If there is a protected branch rule in your repository that requires a linear commit history, you must allow squash merging, rebase merging, or both. 更多信息请参阅“[需要线性提交历史记录](/github/administering-a-repository/requiring-a-linear-commit-history)”。{% endif %}
diff --git a/translations/zh-CN/data/reusables/repositories/start-line-comment.md b/translations/zh-CN/data/reusables/repositories/start-line-comment.md
index 8cf143219faa..d83dba4b37fb 100644
--- a/translations/zh-CN/data/reusables/repositories/start-line-comment.md
+++ b/translations/zh-CN/data/reusables/repositories/start-line-comment.md
@@ -1 +1 @@
-1. 将鼠标悬停在您要添加评论的代码行上，然后单击蓝色评论图标。{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} 要在多行上添加评论，请单击并拖动以选择行范围，然后单击蓝色评论图标。{% endif %} ![蓝色评论图标](/assets/images/help/commits/hover-comment-icon.gif)
+1. Hover over the line of code where you'd like to add a comment, and click the blue comment icon.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} To add a comment on multiple lines, click and drag to select the range of lines, then click the blue comment icon.{% endif %} ![蓝色评论图标](/assets/images/help/commits/hover-comment-icon.gif)
diff --git a/translations/zh-CN/data/reusables/repositories/suggest-changes.md b/translations/zh-CN/data/reusables/repositories/suggest-changes.md
index b168fff0e769..3745dc8a5402 100644
--- a/translations/zh-CN/data/reusables/repositories/suggest-changes.md
+++ b/translations/zh-CN/data/reusables/repositories/suggest-changes.md
@@ -1 +1 @@
-1. （可选）要建议对一行{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}或多行{% endif %}进行特定更改，请单击 {% octicon "diff" aria-label="The diff symbol" %}，然后在建议块内编辑文本。 ![建议块](/assets/images/help/pull_requests/suggestion-block.png)
+1. Optionally, to suggest a specific change to the line{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %} or lines{% endif %}, click {% octicon "diff" aria-label="The diff symbol" %}, then edit the text within the suggestion block. ![建议块](/assets/images/help/pull_requests/suggestion-block.png)
diff --git a/translations/zh-CN/data/reusables/repositories/tracks-vulnerabilities.md b/translations/zh-CN/data/reusables/repositories/tracks-vulnerabilities.md
index 11bc47c95a7d..cd5f7403245f 100644
--- a/translations/zh-CN/data/reusables/repositories/tracks-vulnerabilities.md
+++ b/translations/zh-CN/data/reusables/repositories/tracks-vulnerabilities.md
@@ -2,5 +2,5 @@ We add vulnerabilities to the {% data variables.product.prodname_advisory_databa
 - [国家漏洞数据库](https://nvd.nist.gov/)
 - 机器学习和人工审查结合检测 {% data variables.product.prodname_dotcom %} 上公共提交中的漏洞
 - Security advisories reported on {% data variables.product.prodname_dotcom %}
-- The [npm Security advisories](https://www.npmjs.com/advisories) database
+- [npm 安全通告](https://www.npmjs.com/advisories)数据库
 - [FriendsOfPHP](https://github.com/FriendsOfPHP/security-advisories)
diff --git a/translations/zh-CN/data/reusables/repositories/view-failed-job-results-superlinter.md b/translations/zh-CN/data/reusables/repositories/view-failed-job-results-superlinter.md
new file mode 100644
index 000000000000..6bddd21ff8fe
--- /dev/null
+++ b/translations/zh-CN/data/reusables/repositories/view-failed-job-results-superlinter.md
@@ -0,0 +1,5 @@
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+1. Any failed steps are automatically expanded to display the results. ![Super linter 工作流程结果](/assets/images/help/repository/super-linter-workflow-results-updated.png)
+{% else %}
+1. 展开**运行 Super-Linter** 步骤以查看结果。 ![Super linter 工作流程结果](/assets/images/help/repository/super-linter-workflow-results.png)
+{% endif %}
\ No newline at end of file
diff --git a/translations/zh-CN/data/reusables/repositories/view-run-superlinter.md b/translations/zh-CN/data/reusables/repositories/view-run-superlinter.md
new file mode 100644
index 000000000000..12eb1d6bcf03
--- /dev/null
+++ b/translations/zh-CN/data/reusables/repositories/view-run-superlinter.md
@@ -0,0 +1 @@
+1. 从工作流程运行列表中，单击要查看的运行的名称。 ![工作流程运行的名称](/assets/images/help/repository/superlinter-run-name.png)
\ No newline at end of file
diff --git a/translations/zh-CN/data/reusables/repositories/view-run.md b/translations/zh-CN/data/reusables/repositories/view-run.md
index 72d845b90ba0..6954ef887df8 100644
--- a/translations/zh-CN/data/reusables/repositories/view-run.md
+++ b/translations/zh-CN/data/reusables/repositories/view-run.md
@@ -1 +1 @@
-1. 在“Workflow runs（工作流程运行）”下，单击您想要查看的运行的名称。 ![工作流程运行的名称](/assets/images/help/repository/run-name.png)
+1. 从工作流程运行列表中，单击要查看的运行的名称。 ![工作流程运行的名称](/assets/images/help/repository/run-name.png)
diff --git a/translations/zh-CN/data/reusables/repositories/view-specific-line-superlinter.md b/translations/zh-CN/data/reusables/repositories/view-specific-line-superlinter.md
new file mode 100644
index 000000000000..fd1fca85db0f
--- /dev/null
+++ b/translations/zh-CN/data/reusables/repositories/view-specific-line-superlinter.md
@@ -0,0 +1,5 @@
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
+1. （可选）要获取指向日志中特定行的链接，请单击该步骤的行号。 You can then copy the link from the address bar of your web browser. ![复制链接的按钮](/assets/images/help/repository/copy-link-button-updated.png)
+{% else %}
+1. （可选）要获取指向日志中特定行的链接，请单击该步骤的行号。 You can then copy the link from the address bar of your web browser. ![复制链接的按钮](/assets/images/help/repository/copy-link-button.png)
+{% endif %}
\ No newline at end of file
diff --git a/translations/zh-CN/data/reusables/repositories/you-can-fork.md b/translations/zh-CN/data/reusables/repositories/you-can-fork.md
index 7f499431c3ac..2d290ce6cde4 100644
--- a/translations/zh-CN/data/reusables/repositories/you-can-fork.md
+++ b/translations/zh-CN/data/reusables/repositories/you-can-fork.md
@@ -1,3 +1,3 @@
-您可以将任何公共仓库复刻到您的用户帐户或任何您拥有仓库创建权限的组织。 更多信息请参阅“[组织的权限级别](/articles/permission-levels-for-an-organization)”。
+You can fork any public repository to your user account or any organization where you have repository creation permissions. For more information, see "[Permission levels for an organization](/articles/permission-levels-for-an-organization)."
 
-您可以将您具有访问权限的任何私有仓库复刻到您的用户帐户，以及 {% data variables.product.prodname_team %} 或 {% data variables.product.prodname_enterprise %} 上您拥有仓库创建权限的任何组织。 无法将私有仓库复刻到使用 {% data variables.product.prodname_free_team %} 的组织。{% if currentVersion == "free-pro-team@latest" %} 更多信息请参阅“[GitHub 的产品](/articles/githubs-products)”。{% endif %}
+You can fork any private repository you can access to your user account and any organization on {% data variables.product.prodname_team %} or {% data variables.product.prodname_enterprise %} where you have repository creation permissions. You cannot fork a private repository to an organization using {% data variables.product.prodname_free_team %}.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[GitHub's products](/articles/githubs-products)."{% endif %}
diff --git a/translations/zh-CN/data/reusables/saml/about-user-provisioning-enterprise-account.md b/translations/zh-CN/data/reusables/saml/about-user-provisioning-enterprise-account.md
index 918dab289fd9..8ef6699edb6e 100644
--- a/translations/zh-CN/data/reusables/saml/about-user-provisioning-enterprise-account.md
+++ b/translations/zh-CN/data/reusables/saml/about-user-provisioning-enterprise-account.md
@@ -1 +1 @@
-If you use Okta as your IdP, you can use SCIM to manage organization membership in your enterprise account. SCIM automatically invites people to or removes people from organizations in your enterprise account based on whether they are members of the group that corresponds to each organization in your IdP.
+如果您使用 Okta 作为您的 IdP，您可以使用 SCIM 管理企业帐户中的组织成员资格。 SCIM 会自动邀请人们访问企业帐户中的组织或从中删除人员，具体根据他们是否是对应于 IdP 中每个组织的组成员。
diff --git a/translations/zh-CN/data/reusables/saml/add-okta-application.md b/translations/zh-CN/data/reusables/saml/add-okta-application.md
index d7f0fa1b779f..ac80ba0bc910 100644
--- a/translations/zh-CN/data/reusables/saml/add-okta-application.md
+++ b/translations/zh-CN/data/reusables/saml/add-okta-application.md
@@ -1 +1 @@
-2. 单击 **Add application（添加应用程序）**。 ![Okta 仪表板的 Applications（应用程序）选项卡中的"Add application（添加应用程序）"按钮](/assets/images/help/saml/okta-add-application.png)
\ No newline at end of file
+2. 单击 **Add application（添加应用程序）**。 ![Okta 仪表板的 Applications（应用程序）选项卡中的"Add application（添加应用程序）"按钮](/assets/images/help/saml/okta-add-application.png)
diff --git a/translations/zh-CN/data/reusables/saml/assign-yourself-to-okta.md b/translations/zh-CN/data/reusables/saml/assign-yourself-to-okta.md
index 7b2fd7293434..991495fdc6ff 100644
--- a/translations/zh-CN/data/reusables/saml/assign-yourself-to-okta.md
+++ b/translations/zh-CN/data/reusables/saml/assign-yourself-to-okta.md
@@ -1 +1 @@
-1. Assign the application to your user in Okta. For more information, see [Assign applications to users](https://help.okta.com/en/prod/Content/Topics/users-groups-profiles/usgp-assign-apps.htm) in the Okta documentation.
\ No newline at end of file
+1. 将应用程序分配给您在 Okta 中的用户。 更多信息请参阅 Okta 文档中的[对用户分配应用程序](https://help.okta.com/en/prod/Content/Topics/users-groups-profiles/usgp-assign-apps.htm)。
diff --git a/translations/zh-CN/data/reusables/saml/click-enterprise-account-application.md b/translations/zh-CN/data/reusables/saml/click-enterprise-account-application.md
index e5d172dcb9e5..6ac24d542c36 100644
--- a/translations/zh-CN/data/reusables/saml/click-enterprise-account-application.md
+++ b/translations/zh-CN/data/reusables/saml/click-enterprise-account-application.md
@@ -1 +1 @@
-1. Click the label for the application you created for your enterprise account.
\ No newline at end of file
+1. 单击为企业帐户创建的应用程序的标签。
diff --git a/translations/zh-CN/data/reusables/saml/okta-admin-button.md b/translations/zh-CN/data/reusables/saml/okta-admin-button.md
index b1f3d74979cc..2da52806ca79 100644
--- a/translations/zh-CN/data/reusables/saml/okta-admin-button.md
+++ b/translations/zh-CN/data/reusables/saml/okta-admin-button.md
@@ -1 +1 @@
-1. In Okta, in the upper-right corner, click **Admin**. ![Admin button in Okta](/assets/images/help/saml/okta-admin-button.png)
\ No newline at end of file
+1. 在 Okta 中的右上角，单击 **Admin（管理员）**。 ![Okta 中的管理员按钮](/assets/images/help/saml/okta-admin-button.png)
diff --git a/translations/zh-CN/data/reusables/saml/okta-configure-api-integration.md b/translations/zh-CN/data/reusables/saml/okta-configure-api-integration.md
index bb0b3ade335f..eddb64016377 100644
--- a/translations/zh-CN/data/reusables/saml/okta-configure-api-integration.md
+++ b/translations/zh-CN/data/reusables/saml/okta-configure-api-integration.md
@@ -1 +1 @@
-1. 单击 **Configure API Integration（配置 API 集成）**。 ![Okta 应用程序的"Configure API Integration（配置 API 集成）"按钮](/assets/images/help/saml/okta-configure-api-integration.png)
\ No newline at end of file
+1. 单击 **Configure API Integration（配置 API 集成）**。 ![Okta 应用程序的"Configure API Integration（配置 API 集成）"按钮](/assets/images/help/saml/okta-configure-api-integration.png)
diff --git a/translations/zh-CN/data/reusables/saml/okta-edit-provisioning.md b/translations/zh-CN/data/reusables/saml/okta-edit-provisioning.md
index ab47038ae5c5..8d289bf1eef2 100644
--- a/translations/zh-CN/data/reusables/saml/okta-edit-provisioning.md
+++ b/translations/zh-CN/data/reusables/saml/okta-edit-provisioning.md
@@ -2,4 +2,4 @@
 11. 在“Create Users（创建用户）”的右侧，选择 **Enable（启用）**。 ![用于 Okta 应用程序"Create Users（创建用户）"选项的"Enable（启用）"复选框](/assets/images/help/saml/okta-provisioning-enable-create-users.png)
 12. 在“Update User Attributes（更新用户属性）”的右侧，选择 **Enable（启用）**。 ![用于 Okta 应用程序"Update User Attributes（更新用户属性）"选项的"Enable（启用）"复选框](/assets/images/help/saml/okta-provisioning-enable-update-user-attributes.png)
 13. 在“Deactivate Users（停用用户）”的右侧，选择 **Enable（启用）**。 ![用于 Okta 应用程序"Deactivate Users（停用用户）"选项的"Enable（启用）"复选框](/assets/images/help/saml/okta-provisioning-enable-deactivate-users.png)
-14. 单击 **Save（保存）**。 ![用于 Okta 应用程序配置的"Save（保存）"按钮](/assets/images/help/saml/okta-provisioning-save.png)
\ No newline at end of file
+14. 单击 **Save（保存）**。 ![用于 Okta 应用程序配置的"Save（保存）"按钮](/assets/images/help/saml/okta-provisioning-save.png)
diff --git a/translations/zh-CN/data/reusables/saml/okta-enable-api-integration.md b/translations/zh-CN/data/reusables/saml/okta-enable-api-integration.md
index af111b688e3d..9eebde8c8c7f 100644
--- a/translations/zh-CN/data/reusables/saml/okta-enable-api-integration.md
+++ b/translations/zh-CN/data/reusables/saml/okta-enable-api-integration.md
@@ -1 +1 @@
-1. 选择 **Enable API integration（启用 API 集成）**。 ![Okta 应用程序的"Enable API integration（启用 API 集成）"复选框](/assets/images/help/saml/okta-enable-api-integration.png)
\ No newline at end of file
+1. 选择 **Enable API integration（启用 API 集成）**。 ![Okta 应用程序的"Enable API integration（启用 API 集成）"复选框](/assets/images/help/saml/okta-enable-api-integration.png)
diff --git a/translations/zh-CN/data/reusables/saml/okta-provisioning-tab.md b/translations/zh-CN/data/reusables/saml/okta-provisioning-tab.md
index 119b9cbdd4aa..3eaef656e06e 100644
--- a/translations/zh-CN/data/reusables/saml/okta-provisioning-tab.md
+++ b/translations/zh-CN/data/reusables/saml/okta-provisioning-tab.md
@@ -1 +1 @@
-1. Under the name of the application, click **Provisioning**. ![Okta 应用程序的"Provisioning（配置）"选项卡](/assets/images/help/saml/okta-provisioning-tab.png)
\ No newline at end of file
+1. 在应用程序名称下，单击 **Provisioning（预配）**。 ![Okta 应用程序的"Provisioning（配置）"选项卡](/assets/images/help/saml/okta-provisioning-tab.png)
diff --git a/translations/zh-CN/data/reusables/saml/okta-save-provisioning.md b/translations/zh-CN/data/reusables/saml/okta-save-provisioning.md
index e5250102d741..38b0df163705 100644
--- a/translations/zh-CN/data/reusables/saml/okta-save-provisioning.md
+++ b/translations/zh-CN/data/reusables/saml/okta-save-provisioning.md
@@ -1 +1 @@
-1. 单击 **Save（保存）**。 ![用于 Okta 应用程序配置的"Save（保存）"按钮](/assets/images/help/saml/okta-provisioning-tab-save.png)
\ No newline at end of file
+1. 单击 **Save（保存）**。 ![用于 Okta 应用程序配置的"Save（保存）"按钮](/assets/images/help/saml/okta-provisioning-tab-save.png)
diff --git a/translations/zh-CN/data/reusables/saml/okta-sign-on-tab.md b/translations/zh-CN/data/reusables/saml/okta-sign-on-tab.md
index ace7c751566a..8fe6c174979b 100644
--- a/translations/zh-CN/data/reusables/saml/okta-sign-on-tab.md
+++ b/translations/zh-CN/data/reusables/saml/okta-sign-on-tab.md
@@ -1 +1 @@
-1. Under the name of the application, click **Sign on**. ![Okta 应用程序的"Sign on（登录）"选项卡](/assets/images/help/saml/okta-sign-on-tab.png)
\ No newline at end of file
+1. 在应用程序名称下，单击 **Sign on（登录）**。 ![Okta 应用程序的"Sign on（登录）"选项卡](/assets/images/help/saml/okta-sign-on-tab.png)
diff --git a/translations/zh-CN/data/reusables/saml/okta-view-setup-instructions.md b/translations/zh-CN/data/reusables/saml/okta-view-setup-instructions.md
index 8bf0190f8322..00afe2438d9b 100644
--- a/translations/zh-CN/data/reusables/saml/okta-view-setup-instructions.md
+++ b/translations/zh-CN/data/reusables/saml/okta-view-setup-instructions.md
@@ -1 +1 @@
-1. 在“SIGN ON METHODS（登录方式）”下，单击 **View Setup Instructions（查看设置说明）**。 ![Okta 应用程序的"Sign On（登录）"选项卡中的"View Setup Instructions（查看设置说明）"按钮](/assets/images/help/saml/okta-view-setup-instructions.png)
\ No newline at end of file
+1. 在“SIGN ON METHODS（登录方式）”下，单击 **View Setup Instructions（查看设置说明）**。 ![Okta 应用程序的"Sign On（登录）"选项卡中的"View Setup Instructions（查看设置说明）"按钮](/assets/images/help/saml/okta-view-setup-instructions.png)
diff --git a/translations/zh-CN/data/reusables/saml/search-ghec-okta.md b/translations/zh-CN/data/reusables/saml/search-ghec-okta.md
index 73ad7a444e17..09806ee6a991 100644
--- a/translations/zh-CN/data/reusables/saml/search-ghec-okta.md
+++ b/translations/zh-CN/data/reusables/saml/search-ghec-okta.md
@@ -1 +1 @@
-3. 在搜索字段中键入"GitHub Enterprise Cloud"。 ![Okta 的 "Search for an application（搜索应用程序）"字段](/assets/images/help/saml/okta-search-for-an-application.png)
\ No newline at end of file
+3. 在搜索字段中键入"GitHub Enterprise Cloud"。 ![Okta 的 "Search for an application（搜索应用程序）"字段](/assets/images/help/saml/okta-search-for-an-application.png)
diff --git a/translations/zh-CN/data/reusables/saml/use-classic-ui.md b/translations/zh-CN/data/reusables/saml/use-classic-ui.md
index 844b8400335b..0cb918ba73ec 100644
--- a/translations/zh-CN/data/reusables/saml/use-classic-ui.md
+++ b/translations/zh-CN/data/reusables/saml/use-classic-ui.md
@@ -1,3 +1,3 @@
-You must use the "Classic UI" in Okta. 更多信息请参阅 Okta 博客中的[有组织的导航](https://developer.okta.com/blog/2017/09/25/all-new-developer-console#new-look--feel)。
+必须使用 Okta 中的“Classic UI（经典 UI）”。 更多信息请参阅 Okta 博客中的[有组织的导航](https://developer.okta.com/blog/2017/09/25/all-new-developer-console#new-look--feel)。
 
-![从仪表板上方的 Okta UI 样式选择器中选择"Classic UI（经典 UI）"](/assets/images/help/saml/okta-classic-ui.png)
\ No newline at end of file
+![从仪表板上方的 Okta UI 样式选择器中选择"Classic UI（经典 UI）"](/assets/images/help/saml/okta-classic-ui.png)
diff --git a/translations/zh-CN/data/reusables/scim/enterprise-account-scim.md b/translations/zh-CN/data/reusables/scim/enterprise-account-scim.md
index 41d1a43470e4..ff6d928e3369 100644
--- a/translations/zh-CN/data/reusables/scim/enterprise-account-scim.md
+++ b/translations/zh-CN/data/reusables/scim/enterprise-account-scim.md
@@ -1 +1 @@
-If you're participating in the private beta for user provisioning for enterprise accounts, when you enable SAML for your enterprise account, SCIM provisioning and deprovisioning is enabled by default in {% data variables.product.product_name %}. You can use provisioning to manage organization membership by configuring SCIM in your IdP.
\ No newline at end of file
+If you're participating in the private beta for user provisioning for enterprise accounts, when you enable SAML for your enterprise account, SCIM provisioning and deprovisioning is enabled by default in {% data variables.product.product_name %}. 您可以使用预配在 IDP 中配置 SCIM 来管理组织成员身份。
diff --git a/translations/zh-CN/data/reusables/search/syntax_tips.md b/translations/zh-CN/data/reusables/search/syntax_tips.md
index 8024c50b0266..d3e0d51af981 100644
--- a/translations/zh-CN/data/reusables/search/syntax_tips.md
+++ b/translations/zh-CN/data/reusables/search/syntax_tips.md
@@ -1,6 +1,6 @@
 {% tip %}
 
-**提示：**{% if currentVersion != "free-pro-team@latest" %}
+**Tips:**{% if currentVersion != "free-pro-team@latest" %}
   - 本文章包含在 {% data variables.product.prodname_dotcom %}.com 网站上的示例搜索，但您可以在 {% data variables.product.product_location_enterprise %} 上使用相同的搜索过滤器。{% endif %}
   - 有关可以添加到任何搜索限定符以进一步改善结果的搜索语法列表，请参阅“[了解搜索语法](/articles/understanding-the-search-syntax)”。
   - 对多个字词的搜索词使用引号。 例如，如果要搜索具有标签 "In progress" 的议题，可搜索 `label:"in progress"`。 搜索不区分大小写。
diff --git a/translations/zh-CN/data/reusables/secret-scanning/beta.md b/translations/zh-CN/data/reusables/secret-scanning/beta.md
index 217d0872e74c..fded789f2b95 100644
--- a/translations/zh-CN/data/reusables/secret-scanning/beta.md
+++ b/translations/zh-CN/data/reusables/secret-scanning/beta.md
@@ -2,4 +2,4 @@
 
 **注：**私有仓库的 {% data variables.product.prodname_secret_scanning_caps %} 目前处于公测阶段，可能会有变动。 要申请访问测试版，[请加入等待列表](https://github.com/features/security/advanced-security/signup)。
 
-{% endnote %}
\ No newline at end of file
+{% endnote %}
diff --git a/translations/zh-CN/data/reusables/security-advisory/security-researcher-cannot-create-advisory.md b/translations/zh-CN/data/reusables/security-advisory/security-researcher-cannot-create-advisory.md
index cb1b6b59bfbc..f2088d5491ab 100644
--- a/translations/zh-CN/data/reusables/security-advisory/security-researcher-cannot-create-advisory.md
+++ b/translations/zh-CN/data/reusables/security-advisory/security-researcher-cannot-create-advisory.md
@@ -1,5 +1,5 @@
 {% note %}
 
-**Note:** If you are a security researcher, you should directly contact maintainers to ask them to create security advisories or issue CVEs on your behalf in repositories that you don't administer.
+**注：**如果您是安全研究人员，应直接联系维护人员，要求他们创建安全通告，或在您不管理的仓库中代表您发布 CVE。
 
 {% endnote %}
diff --git a/translations/zh-CN/data/reusables/security/security-and-analysis-features-enable-read-only.md b/translations/zh-CN/data/reusables/security/security-and-analysis-features-enable-read-only.md
index 24d02e071337..6ccefd256e5e 100644
--- a/translations/zh-CN/data/reusables/security/security-and-analysis-features-enable-read-only.md
+++ b/translations/zh-CN/data/reusables/security/security-and-analysis-features-enable-read-only.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-If you enable security and analysis features, {% data variables.product.company_short %} performs read-only analysis on your repository. 更多信息请参阅“[关于 {% data variables.product.company_short %} 对数据的使用](/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data)”。
-{% endif %}
\ No newline at end of file
+If you enable security and analysis features,
+{% data variables.product.company_short %} performs read-only analysis on your repository. 更多信息请参阅“[关于 {% data variables.product.company_short %} 对数据的使用](/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data)”。
+{% endif %}
diff --git a/translations/zh-CN/data/reusables/shortdesc/authenticating_github_app.md b/translations/zh-CN/data/reusables/shortdesc/authenticating_github_app.md
index 2bd7cd6418ac..051278bc99ce 100644
--- a/translations/zh-CN/data/reusables/shortdesc/authenticating_github_app.md
+++ b/translations/zh-CN/data/reusables/shortdesc/authenticating_github_app.md
@@ -1 +1 @@
-For information on how to authenticate as a GitHub App, see "[Authentication Options for GitHub Apps](/apps/building-github-apps/authentication-options-for-github-apps#authenticating-as-a-github-app)."
+有关如何验证为 GitHub 应用程序的信息，请参阅“[GitHub 应用程序的身份验证选项](/apps/building-github-apps/authentication-options-for-github-apps#authenticating-as-a-github-app)”。
diff --git a/translations/zh-CN/data/reusables/shortdesc/authorizing_oauth_apps.md b/translations/zh-CN/data/reusables/shortdesc/authorizing_oauth_apps.md
index 09e76d7eae1b..1cef06a4290b 100644
--- a/translations/zh-CN/data/reusables/shortdesc/authorizing_oauth_apps.md
+++ b/translations/zh-CN/data/reusables/shortdesc/authorizing_oauth_apps.md
@@ -1 +1 @@
-You can enable other users to authorize your OAuth App.
+您可以让其他用户授权您的 OAuth 应用程序。
diff --git a/translations/zh-CN/data/reusables/shortdesc/creating_custom_badges_github_apps.md b/translations/zh-CN/data/reusables/shortdesc/creating_custom_badges_github_apps.md
index b988f3ab5c76..209340487f0b 100644
--- a/translations/zh-CN/data/reusables/shortdesc/creating_custom_badges_github_apps.md
+++ b/translations/zh-CN/data/reusables/shortdesc/creating_custom_badges_github_apps.md
@@ -1 +1 @@
-You can replace the default badge on your GitHub App by uploading your own logo image and customizing the background.
+您可以通过上传自己的徽标图像并自定义背景来替换 GitHub 应用程序上的默认徽章。
diff --git a/translations/zh-CN/data/reusables/shortdesc/creating_custom_badges_oauth_apps.md b/translations/zh-CN/data/reusables/shortdesc/creating_custom_badges_oauth_apps.md
index f2c602b885b4..d25dc381fe43 100644
--- a/translations/zh-CN/data/reusables/shortdesc/creating_custom_badges_oauth_apps.md
+++ b/translations/zh-CN/data/reusables/shortdesc/creating_custom_badges_oauth_apps.md
@@ -1 +1 @@
-You can replace the default badge on your OAuth App by uploading your own logo image and customizing the background.
+您可以通过上传自己的徽标图像并自定义背景来替换 OAuth 应用程序上的默认徽章。
diff --git a/translations/zh-CN/data/reusables/shortdesc/creating_github_apps.md b/translations/zh-CN/data/reusables/shortdesc/creating_github_apps.md
index a9b51d1a039c..378fa303ce6b 100644
--- a/translations/zh-CN/data/reusables/shortdesc/creating_github_apps.md
+++ b/translations/zh-CN/data/reusables/shortdesc/creating_github_apps.md
@@ -1 +1 @@
-You can create and register a GitHub App under your personal account or under any organization you have administrative access to.
+您可以在您的个人帐户下或在您有管理权限的任何组织下创建和注册 GitHub 应用程序。
diff --git a/translations/zh-CN/data/reusables/shortdesc/creating_oauth_apps.md b/translations/zh-CN/data/reusables/shortdesc/creating_oauth_apps.md
index 16fc0410092d..688abe685e94 100644
--- a/translations/zh-CN/data/reusables/shortdesc/creating_oauth_apps.md
+++ b/translations/zh-CN/data/reusables/shortdesc/creating_oauth_apps.md
@@ -1 +1 @@
-You can create and register an OAuth App under your personal account or under any organization you have administrative access to. While creating your OAuth app, remember to protect your privacy by only using information you consider public.
+您可以在您的个人帐户下或在您有管理权限的任何组织下创建和注册 OAuth 应用程序。 创建 OAuth 应用程序时，请记住仅使用您认为公开的信息来保护您的隐私。
diff --git a/translations/zh-CN/data/reusables/shortdesc/deleting_github_apps.md b/translations/zh-CN/data/reusables/shortdesc/deleting_github_apps.md
index fcc568a45b3c..d054ea05691a 100644
--- a/translations/zh-CN/data/reusables/shortdesc/deleting_github_apps.md
+++ b/translations/zh-CN/data/reusables/shortdesc/deleting_github_apps.md
@@ -1 +1 @@
-You can delete GitHub Apps when you no longer use them.
+当您不再使用 GitHub 应用程序时，您可以删除它们。
diff --git a/translations/zh-CN/data/reusables/shortdesc/deleting_oauth_apps.md b/translations/zh-CN/data/reusables/shortdesc/deleting_oauth_apps.md
index 61efb0b05597..ce3e72078b96 100644
--- a/translations/zh-CN/data/reusables/shortdesc/deleting_oauth_apps.md
+++ b/translations/zh-CN/data/reusables/shortdesc/deleting_oauth_apps.md
@@ -1 +1 @@
-You can delete OAuth Apps when you no longer use them.
+当您不再使用 OAuth 应用程序时，您可以删除它们。
diff --git a/translations/zh-CN/data/reusables/shortdesc/editing_permissions_for_github_apps.md b/translations/zh-CN/data/reusables/shortdesc/editing_permissions_for_github_apps.md
index e8c900f1e485..7f23e59f5bf3 100644
--- a/translations/zh-CN/data/reusables/shortdesc/editing_permissions_for_github_apps.md
+++ b/translations/zh-CN/data/reusables/shortdesc/editing_permissions_for_github_apps.md
@@ -1 +1 @@
-After registering a GitHub App, you can modify your app's permissions.
+注册 GitHub 应用程序后，您可以修改其权限。
diff --git a/translations/zh-CN/data/reusables/shortdesc/identifying_and_authorizing_github_apps.md b/translations/zh-CN/data/reusables/shortdesc/identifying_and_authorizing_github_apps.md
index 8753f972a4aa..27dca52cc210 100644
--- a/translations/zh-CN/data/reusables/shortdesc/identifying_and_authorizing_github_apps.md
+++ b/translations/zh-CN/data/reusables/shortdesc/identifying_and_authorizing_github_apps.md
@@ -1 +1 @@
-Your GitHub App can perform actions on behalf of a user, like creating an issue, creating a deployment, and using other supported endpoints.
+GitHub 应用程序可以代表用户执行操作，例如创建议题、创建部署和使用其他受支持的端点。
diff --git a/translations/zh-CN/data/reusables/shortdesc/iso_8601.md b/translations/zh-CN/data/reusables/shortdesc/iso_8601.md
index 4d36d9fb6343..e93d5759fd09 100644
--- a/translations/zh-CN/data/reusables/shortdesc/iso_8601.md
+++ b/translations/zh-CN/data/reusables/shortdesc/iso_8601.md
@@ -1 +1 @@
-这是 [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) 格式的时间戳：`YYYY-MM-DDTHH:MM:SSZ`。
\ No newline at end of file
+这是 [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) 格式的时间戳：`YYYY-MM-DDTHH:MM:SSZ`。
diff --git a/translations/zh-CN/data/reusables/shortdesc/making-a-github-app-public-or-private.md b/translations/zh-CN/data/reusables/shortdesc/making-a-github-app-public-or-private.md
index b715bb3db7ee..54f5908e8cd7 100644
--- a/translations/zh-CN/data/reusables/shortdesc/making-a-github-app-public-or-private.md
+++ b/translations/zh-CN/data/reusables/shortdesc/making-a-github-app-public-or-private.md
@@ -1 +1 @@
-When setting up a GitHub App, you can make its installation public so any GitHub user or organization can install the app, or private so you can only install it on the account that created it.
+设置 GitHub 应用程序时，您可以将其安装设为公共，使任何 GitHub 用户或组织都可以安装该应用程序，也可以将其设为私有，限制为只能在创建它的帐户上安装它。
diff --git a/translations/zh-CN/data/reusables/shortdesc/modifying_github_apps.md b/translations/zh-CN/data/reusables/shortdesc/modifying_github_apps.md
index 9986f7af6194..1d4b7bf711ea 100644
--- a/translations/zh-CN/data/reusables/shortdesc/modifying_github_apps.md
+++ b/translations/zh-CN/data/reusables/shortdesc/modifying_github_apps.md
@@ -1 +1 @@
-After creating a GitHub App, you can make changes to it.
+创建 GitHub 应用程序后，您可以对其进行修改。
diff --git a/translations/zh-CN/data/reusables/shortdesc/modifying_oauth_apps.md b/translations/zh-CN/data/reusables/shortdesc/modifying_oauth_apps.md
index 85907ba04ee4..46e9297461d2 100644
--- a/translations/zh-CN/data/reusables/shortdesc/modifying_oauth_apps.md
+++ b/translations/zh-CN/data/reusables/shortdesc/modifying_oauth_apps.md
@@ -1 +1 @@
-After creating and registering an OAuth App, you can make changes to it.
+创建和注册 OAuth 应用程序后，您可以对其进行修改。
diff --git a/translations/zh-CN/data/reusables/shortdesc/permissions_github_apps.md b/translations/zh-CN/data/reusables/shortdesc/permissions_github_apps.md
index fe03198b1a95..f067da822d9d 100644
--- a/translations/zh-CN/data/reusables/shortdesc/permissions_github_apps.md
+++ b/translations/zh-CN/data/reusables/shortdesc/permissions_github_apps.md
@@ -1 +1 @@
-When you create a GitHub App, you set the permissions that define the resources the app can access via the REST API.
+创建 GitHub 应用程序时，您可以设置权限，以定义应用程序可通过 REST API 访问的资源。
diff --git a/translations/zh-CN/data/reusables/shortdesc/rate_limits_github_apps.md b/translations/zh-CN/data/reusables/shortdesc/rate_limits_github_apps.md
index bcba4f706af6..2f1bb51ef0fd 100644
--- a/translations/zh-CN/data/reusables/shortdesc/rate_limits_github_apps.md
+++ b/translations/zh-CN/data/reusables/shortdesc/rate_limits_github_apps.md
@@ -1 +1 @@
-Rate limits for GitHub Apps help control the rate of traffic.
+GitHub 应用程序的速率限制有助于控制流量。
diff --git a/translations/zh-CN/data/reusables/shortdesc/transferring_ownership_of_github_apps.md b/translations/zh-CN/data/reusables/shortdesc/transferring_ownership_of_github_apps.md
index b8693c927858..b28cf5ffce83 100644
--- a/translations/zh-CN/data/reusables/shortdesc/transferring_ownership_of_github_apps.md
+++ b/translations/zh-CN/data/reusables/shortdesc/transferring_ownership_of_github_apps.md
@@ -1 +1 @@
-You can transfer ownership of a GitHub App to another user or organization.
+您可以将 GitHub 应用程序的所有权转让给其他用户或组织。
diff --git a/translations/zh-CN/data/reusables/shortdesc/transferring_ownership_of_oauth_apps.md b/translations/zh-CN/data/reusables/shortdesc/transferring_ownership_of_oauth_apps.md
index 464804504756..c80f0a3708b8 100644
--- a/translations/zh-CN/data/reusables/shortdesc/transferring_ownership_of_oauth_apps.md
+++ b/translations/zh-CN/data/reusables/shortdesc/transferring_ownership_of_oauth_apps.md
@@ -1 +1 @@
-You can transfer ownership of an OAuth App to another user or organization.
+您可以将 OAuth 应用程序的所有权转让给其他用户或组织。
diff --git a/translations/zh-CN/data/reusables/shortdesc/troubleshooting_access_token_reques_errors_oauth_apps.md b/translations/zh-CN/data/reusables/shortdesc/troubleshooting_access_token_reques_errors_oauth_apps.md
index ab1aaac67eef..6e2fecd80737 100644
--- a/translations/zh-CN/data/reusables/shortdesc/troubleshooting_access_token_reques_errors_oauth_apps.md
+++ b/translations/zh-CN/data/reusables/shortdesc/troubleshooting_access_token_reques_errors_oauth_apps.md
@@ -1 +1 @@
-When exchanging a code for an access token, there are an additional set of errors that can occur. The format of these responses is determined by the accept header you pass.
+为访问令牌交换代码时，可能会发生另外一组错误。 这些响应的格式由您传递的接受标头确定。
diff --git a/translations/zh-CN/data/reusables/shortdesc/troubleshooting_authorization_request_errors_oauth_apps.md b/translations/zh-CN/data/reusables/shortdesc/troubleshooting_authorization_request_errors_oauth_apps.md
index fb7ef66aad29..c4301e24f8c0 100644
--- a/translations/zh-CN/data/reusables/shortdesc/troubleshooting_authorization_request_errors_oauth_apps.md
+++ b/translations/zh-CN/data/reusables/shortdesc/troubleshooting_authorization_request_errors_oauth_apps.md
@@ -1 +1 @@
-When obtaining an OAuth token for a user, some errors may occur during the initial authorization request phase.
+为用户获取 OAuth 令牌时，在初始授权请求阶段可能会出现一些错误。
diff --git a/translations/zh-CN/data/reusables/shortdesc/understanding_scopes_for_oauth_apps.md b/translations/zh-CN/data/reusables/shortdesc/understanding_scopes_for_oauth_apps.md
index 477fc8cb9ef3..f3be28a1b053 100644
--- a/translations/zh-CN/data/reusables/shortdesc/understanding_scopes_for_oauth_apps.md
+++ b/translations/zh-CN/data/reusables/shortdesc/understanding_scopes_for_oauth_apps.md
@@ -1 +1 @@
-Scopes let you specify exactly what type of access you need. Scopes _limit_ access for OAuth tokens. They do not grant any additional permission beyond that which the user already has.
+通过作用域，您可以准确指定所需的访问权限类型。 作用域_限制_ OAuth 令牌的访问权限。 它们不会授予超出用户权限范围的任何额外权限。
diff --git a/translations/zh-CN/data/reusables/sponsors/edit-featured-work.md b/translations/zh-CN/data/reusables/sponsors/edit-featured-work.md
index 10336b1ee6e0..f33af3f627cc 100644
--- a/translations/zh-CN/data/reusables/sponsors/edit-featured-work.md
+++ b/translations/zh-CN/data/reusables/sponsors/edit-featured-work.md
@@ -1,3 +1,3 @@
 1. （可选）选择在您的 {% data variables.product.prodname_sponsors %} 个人资料中显示的仓库。
     - 在“Featured work（特色作品）”的右侧，单击 **Edit（编辑）**。 ![特色作品编辑按钮](/assets/images/help/sponsors/featured-work-edit-button.png)
-    - 最多选择 6 个仓库，然后单击 **Save（保存）**。 ![选择仓库复选框](/assets/images/help/sponsors/featured-work-select.png)
\ No newline at end of file
+    - 最多选择 6 个仓库，然后单击 **Save（保存）**。 ![选择仓库复选框](/assets/images/help/sponsors/featured-work-select.png)
diff --git a/translations/zh-CN/data/reusables/sponsors/meet-the-team.md b/translations/zh-CN/data/reusables/sponsors/meet-the-team.md
index 8c419368c835..3d35fab88c30 100644
--- a/translations/zh-CN/data/reusables/sponsors/meet-the-team.md
+++ b/translations/zh-CN/data/reusables/sponsors/meet-the-team.md
@@ -2,4 +2,4 @@
     - 在“Meet the team（认识团队）”右侧，单击 **Edit（编辑）**。  
       ![编辑个人资料中组织成员按钮](/assets/images/help/sponsors/edit-org-members-profile-button.png)
     - 最多选择 6 个组织成员，然后单击 **Save（保存）**。 ![选择突出显示的组织成员](/assets/images/help/sponsors/select-highlighted-org-members.png)
-    - （可选）在每个突出显示的成员名称下，输入成员简介。  ![突出显示的组织成员简介](/assets/images/help/sponsors/description-highlighted-org-members.png)
\ No newline at end of file
+    - （可选）在每个突出显示的成员名称下，输入成员简介。  ![突出显示的组织成员简介](/assets/images/help/sponsors/description-highlighted-org-members.png)
diff --git a/translations/zh-CN/data/reusables/sponsors/navigate-to-dev-sponsors-dashboard.md b/translations/zh-CN/data/reusables/sponsors/navigate-to-dev-sponsors-dashboard.md
index ab4a1b6d690e..320c1ba01b6e 100644
--- a/translations/zh-CN/data/reusables/sponsors/navigate-to-dev-sponsors-dashboard.md
+++ b/translations/zh-CN/data/reusables/sponsors/navigate-to-dev-sponsors-dashboard.md
@@ -1,2 +1,2 @@
-1. 在任何页面的右上角，单击您的个人资料照片，然后再单击 **{% data variables.product.prodname_sponsors %}**。 ![{% data variables.product.prodname_sponsors %} 按钮](/assets/images/help/sponsors/access-github-sponsors-dashboard.png)
+1. 在任何页面的右上角，单击您的个人资料照片，然后单击 **{% data variables.product.prodname_sponsors %}**。 ![{% data variables.product.prodname_sponsors %} 按钮](/assets/images/help/sponsors/access-github-sponsors-dashboard.png)
 2. 如果您赞助的符合条件的帐户列表显示，可在帐户名称右侧单击 **Dashboard（仪表板）**。 ![开发者赞助者仪表板按钮](/assets/images/help/sponsors/dev-sponsors-dashboard-button.png)
diff --git a/translations/zh-CN/data/reusables/sponsors/navigate-to-org-sponsors-dashboard.md b/translations/zh-CN/data/reusables/sponsors/navigate-to-org-sponsors-dashboard.md
index 3920494a649d..29412ae344a0 100644
--- a/translations/zh-CN/data/reusables/sponsors/navigate-to-org-sponsors-dashboard.md
+++ b/translations/zh-CN/data/reusables/sponsors/navigate-to-org-sponsors-dashboard.md
@@ -1,2 +1,2 @@
-1. 在任何页面的右上角，单击您的个人资料照片，然后再单击 **{% data variables.product.prodname_sponsors %}**。 ![{% data variables.product.prodname_sponsors %} 按钮](/assets/images/help/sponsors/access-github-sponsors-dashboard.png)
+1. 在任何页面的右上角，单击您的个人资料照片，然后单击 **{% data variables.product.prodname_sponsors %}**。 ![{% data variables.product.prodname_sponsors %} 按钮](/assets/images/help/sponsors/access-github-sponsors-dashboard.png)
 2. 在您赞助的符合条件的帐户列表中，在组织右侧单击 **Dashboard（仪表板）**。 ![组织赞助者仪表板按钮](/assets/images/help/sponsors/org-sponsors-dashboard-button.png)
diff --git a/translations/zh-CN/data/reusables/sponsors/navigate-to-your-goals-tab.md b/translations/zh-CN/data/reusables/sponsors/navigate-to-your-goals-tab.md
index 9cda6b4a6d51..f25ea5ef7398 100644
--- a/translations/zh-CN/data/reusables/sponsors/navigate-to-your-goals-tab.md
+++ b/translations/zh-CN/data/reusables/sponsors/navigate-to-your-goals-tab.md
@@ -1 +1 @@
-1. 在左侧边栏中，单击 **Your goals（您的目标）**。 ![您的目标选项卡](/assets/images/help/sponsors/your-goals-tab.png)
\ No newline at end of file
+1. 在左侧边栏中，单击 **Your goals（您的目标）**。 ![您的目标选项卡](/assets/images/help/sponsors/your-goals-tab.png)
diff --git a/translations/zh-CN/data/reusables/sponsors/opt-in-to-being-featured.md b/translations/zh-CN/data/reusables/sponsors/opt-in-to-being-featured.md
index 8904eeba9bf5..ca26ff50ec37 100644
--- a/translations/zh-CN/data/reusables/sponsors/opt-in-to-being-featured.md
+++ b/translations/zh-CN/data/reusables/sponsors/opt-in-to-being-featured.md
@@ -1 +1 @@
-1. （可选）选中 **Opt-in to potentially being featured on github.com/sponsors（选择加入可能作为 github.com/sponsors 上的特色作品）**。 ![选择加入特色作品复选框](/assets/images/help/sponsors/opt-in-to-being-featured.png)
\ No newline at end of file
+1. （可选）选中 **Opt-in to potentially being featured on github.com/sponsors（选择加入可能作为 github.com/sponsors 上的特色作品）**。 ![选择加入特色作品复选框](/assets/images/help/sponsors/opt-in-to-being-featured.png)
diff --git a/translations/zh-CN/data/reusables/sponsors/publish-goal.md b/translations/zh-CN/data/reusables/sponsors/publish-goal.md
index c67e1de0d646..13e87984a487 100644
--- a/translations/zh-CN/data/reusables/sponsors/publish-goal.md
+++ b/translations/zh-CN/data/reusables/sponsors/publish-goal.md
@@ -1 +1 @@
-1. 单击 **Publish（发布）**。 ![发布按钮](/assets/images/help/sponsors/publish-goal-button.png)
\ No newline at end of file
+1. 单击 **Publish（发布）**。 ![发布按钮](/assets/images/help/sponsors/publish-goal-button.png)
diff --git a/translations/zh-CN/data/reusables/sponsors/retire-goal.md b/translations/zh-CN/data/reusables/sponsors/retire-goal.md
index b263ed800fba..e19e83e957c0 100644
--- a/translations/zh-CN/data/reusables/sponsors/retire-goal.md
+++ b/translations/zh-CN/data/reusables/sponsors/retire-goal.md
@@ -1,2 +1,2 @@
 1. 在页面底部，单击 **Retire（撤销）**。 ![撤销按钮](/assets/images/help/sponsors/retire-goal-button.png)
-2. 阅读警告，然后单击 **OK（确定）**。 ![关于撤销目标的警告](/assets/images/help/sponsors/confirm-retire-goal.png)
\ No newline at end of file
+2. 阅读警告，然后单击 **OK（确定）**。 ![关于撤销目标的警告](/assets/images/help/sponsors/confirm-retire-goal.png)
diff --git a/translations/zh-CN/data/reusables/sponsors/save-profile.md b/translations/zh-CN/data/reusables/sponsors/save-profile.md
index be0cff181d84..e856d6dd748f 100644
--- a/translations/zh-CN/data/reusables/sponsors/save-profile.md
+++ b/translations/zh-CN/data/reusables/sponsors/save-profile.md
@@ -1 +1 @@
-1. 单击 **Update profile（更新个人资料）**。
\ No newline at end of file
+1. 单击 **Update profile（更新个人资料）**。
diff --git a/translations/zh-CN/data/reusables/sponsors/set-a-goal.md b/translations/zh-CN/data/reusables/sponsors/set-a-goal.md
index 0cfae5622cc8..793eed525d96 100644
--- a/translations/zh-CN/data/reusables/sponsors/set-a-goal.md
+++ b/translations/zh-CN/data/reusables/sponsors/set-a-goal.md
@@ -1 +1 @@
-1. 在“Your goals（您的目标）”下，单击 **Set a goal（设定目标）**。 ![设定目标按钮 ](/assets/images/help/sponsors/set-a-goal-button.png)
\ No newline at end of file
+1. 在“Your goals（您的目标）”下，单击 **Set a goal（设定目标）**。 ![设定目标按钮 ](/assets/images/help/sponsors/set-a-goal-button.png)
diff --git a/translations/zh-CN/data/reusables/sponsors/short-bio.md b/translations/zh-CN/data/reusables/sponsors/short-bio.md
index 1414c239c133..9c5e01fbf2a6 100644
--- a/translations/zh-CN/data/reusables/sponsors/short-bio.md
+++ b/translations/zh-CN/data/reusables/sponsors/short-bio.md
@@ -1 +1 @@
-1. 在“Short bio（个人简历）”下，输入关于您个人和工作的简要说明。 ![个人简历字段](/assets/images/help/sponsors/short-bio.png)
\ No newline at end of file
+1. 在“Short bio（个人简历）”下，输入关于您个人和工作的简要说明。 ![个人简历字段](/assets/images/help/sponsors/short-bio.png)
diff --git a/translations/zh-CN/data/reusables/sponsors/stripe-supported-regions.md b/translations/zh-CN/data/reusables/sponsors/stripe-supported-regions.md
index c06d291639ec..9d464fd54f3d 100644
--- a/translations/zh-CN/data/reusables/sponsors/stripe-supported-regions.md
+++ b/translations/zh-CN/data/reusables/sponsors/stripe-supported-regions.md
@@ -1 +1 @@
-有关支持的地区列表，请参阅 [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors)。
+有关支持的地区列表，请参阅 [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors#countries)。
diff --git a/translations/zh-CN/data/reusables/sponsors/you-can-be-a-sponsored-developer.md b/translations/zh-CN/data/reusables/sponsors/you-can-be-a-sponsored-developer.md
index f8dca5b20fdc..fa41061ee4e9 100644
--- a/translations/zh-CN/data/reusables/sponsors/you-can-be-a-sponsored-developer.md
+++ b/translations/zh-CN/data/reusables/sponsors/you-can-be-a-sponsored-developer.md
@@ -1 +1 @@
-任何参与开源项目并在受支持的地区拥有银行帐户的人都有资格成为被赞助的开发者。 贡献包括但不仅限于错误报告、议题分类、代码、文档、领导、业务开发、项目管理、指导和设计。 如果您住在 {% data variables.product.prodname_sponsors %} 尚不支持的地区，可以注册加入等候名单以与 {% data variables.product.prodname_sponsors %} 测试。 要查看您所在的区域是否有 {% data variables.product.prodname_sponsors %}，请参阅[支持的区域列表](https://github.com/sponsors#regions)。
+任何参与开源项目并居住在受支持地区的人都有资格成为被赞助的开发者。 贡献包括但不仅限于错误报告、议题分类、代码、文档、领导、业务开发、项目管理、指导和设计。 如果您住在 {% data variables.product.prodname_sponsors %} 尚不支持的地区，可以注册加入等候名单以与 {% data variables.product.prodname_sponsors %} 测试。
diff --git a/translations/zh-CN/data/reusables/sponsors/you-can-be-a-sponsored-organization.md b/translations/zh-CN/data/reusables/sponsors/you-can-be-a-sponsored-organization.md
index a65bfc0f5f6f..44b469d69a6c 100644
--- a/translations/zh-CN/data/reusables/sponsors/you-can-be-a-sponsored-organization.md
+++ b/translations/zh-CN/data/reusables/sponsors/you-can-be-a-sponsored-organization.md
@@ -1 +1 @@
-在支持的地区参与开源项目并且有专用银行帐户的任何组织都有资格成为被赞助组织。 如果您所在的区域不受 {% data variables.product.prodname_sponsors %} 支持，请在 [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors) 加入等待列表。
+任何参与开源项目并在受支持的地区合法经营的组织都有资格成为被赞助的组织。 If your organization operates in a region that isn't already supported by {% data variables.product.prodname_sponsors %}, join the waitlist at [{% data variables.product.prodname_sponsors %}](https://github.com/sponsors).
diff --git a/translations/zh-CN/data/reusables/ssh/dsa-support.md b/translations/zh-CN/data/reusables/ssh/dsa-support.md
index 6155d2226c82..6e3c9255d927 100644
--- a/translations/zh-CN/data/reusables/ssh/dsa-support.md
+++ b/translations/zh-CN/data/reusables/ssh/dsa-support.md
@@ -1,5 +1,5 @@
 {% note %}
 
-**注意：**{% if currentVersion != "free-pro-team@latest" or currentVersion ver_lt "enterprise-server@2.19" %}DSA 密钥在 OpenSSH 7.0 中已废弃。 如果您的操作系统使用 OpenSSH ，您需要在设置 SSH 时使用另一种类型的密钥，如 RSA 密钥。 例如，如果您的操作系统是 macOS Sierra，您可以使用 RSA 密钥设置SSH。{% else %}DSA 密钥 (SSH-DSS) 不再受支持。 现有密钥将继续运行，但您不能将新的 DSA 密钥添加到您的 {% data variables.product.product_name %} 帐户。{% endif %}
+**Note:** DSA keys (SSH-DSS) are no longer supported. 现有密钥将继续运行，但您不能将新的 DSA 密钥添加到您的 {% data variables.product.product_name %} 帐户。
 
 {% endnote %}
diff --git a/translations/zh-CN/data/reusables/support/about-premium-plans.md b/translations/zh-CN/data/reusables/support/about-premium-plans.md
index be0655e37339..873ea7e24a24 100644
--- a/translations/zh-CN/data/reusables/support/about-premium-plans.md
+++ b/translations/zh-CN/data/reusables/support/about-premium-plans.md
@@ -3,16 +3,16 @@
 
 有两个 {% data variables.contact.premium_support %} 计划：Premium 和 Premium Plus / {% data variables.product.microsoft_premium_plus_support_plan %}。
 
-|        | {% data variables.product.premium_support_plan %} | {% data variables.product.premium_plus_support_plan %} |
-| ------ | -------------------------------------------------------- | ------------------------------------------------------------- |
-| 运行时间   | 24 x 7                                                   | 24 x 7                                                        |
-| 初始响应时间 | 
    • 30 分钟，{% data variables.product.support_ticket_priority_urgent %}
    • 4 小时，{% data variables.product.support_ticket_priority_high %}
                                    | 
    • 30 分钟，{% data variables.product.support_ticket_priority_urgent %}
    • 4 小时，{% data variables.product.support_ticket_priority_high %}
                                         |
-| 支持通道   | 
    • 在线事件单提交
    • 电话支持
                                    | 
    • 在线事件单提交
    • 电话支持
    • 针对重大问题的屏幕共享
                                         |
-| 培训     | 高级内容访问权限                                                 | 
    • 高级内容访问权限
    • 每年 1 次虚拟培训课程
                                         |
-| 授权的联系人 | 10                                                       | 25                                                            |
-| 资源     | 优先事件单处理                                                  | 
    • 优先事件单处理
    • 指定的技术支持客户经理
                                         |
-| 定期检查   | 两年一次的健康状态检查和报告                                           | 
    • 季度状态检查和报告
    • 季度帐户审查
                                         |
-| 管理     |                                                          | 每月 4 小时管理服务                                                   |
+|        | {% data variables.product.premium_support_plan %} | {% data variables.product.premium_plus_support_plan %}
+| ------ | --------------------------------------------------- | -------------------------------------------------------- |
+| 运行时间   | 24 x 7                                              | 24 x 7                                                   |
+| 初始响应时间 | 
    • 30 分钟，{% data variables.product.support_ticket_priority_urgent %}
    • 4 小时，{% data variables.product.support_ticket_priority_high %}
                               | 
    • 30 分钟，{% data variables.product.support_ticket_priority_urgent %}
    • 4 小时，{% data variables.product.support_ticket_priority_high %}
                                    |
+| 支持通道   | 
    • 在线事件单提交
    • 电话支持
                               | 
    • 在线事件单提交
    • 电话支持
    • 针对重大问题的屏幕共享
                                    |
+| 培训     | 高级内容访问权限                                            | 
    • 高级内容访问权限
    • 每年 1 次虚拟培训课程
                                    |
+| 授权的联系人 | 10                                                  | 25                                                       |
+| 资源     | 优先事件单处理                                             | 
    • 优先事件单处理
    • 指定的技术支持客户经理
                                    |
+| 定期检查   | 两年一次的健康状态检查和报告                                      | 
    • 季度状态检查和报告
    • 季度帐户审查
                                    |
+| 管理     |                                                     | 每月 4 小时管理服务                                              |
 
   {% note %}
 
diff --git a/translations/zh-CN/data/reusables/support/ghec-premium-priorities.md b/translations/zh-CN/data/reusables/support/ghec-premium-priorities.md
index cd2dfe6edccb..837c59dc0213 100644
--- a/translations/zh-CN/data/reusables/support/ghec-premium-priorities.md
+++ b/translations/zh-CN/data/reusables/support/ghec-premium-priorities.md
@@ -1,6 +1,6 @@
-|                                优先级                                 | 描述                                                                                                                                                                       | 示例                        |
-|:------------------------------------------------------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------- |
-| {% data variables.product.support_ticket_priority_urgent %} | 在 {% data variables.product.prodname_ghe_cloud %} 上的组织或企业的生产工作流程由于严重服务错误或中断而失败，并且该失败直接影响您的业务运营。                                                                   | 
    • {% data variables.product.prodname_dotcom_the_website %} 上的错误或中断影响您组织或企业所有成员的核心 Git 或 web 应用程序功能
     |
-|  {% data variables.product.support_ticket_priority_high %}  | 在 {% data variables.product.prodname_ghe_cloud %} 上的组织或企业的帐户或安全问题对您的业务产生了有限的影响。                                                                                   | 
    • 组织或企业所有者无意中删除了组织
    • 组织或企业成员在提交、议题、拉取请求或议题附件中上传了敏感数据
     |
+|                              优先级                              | 描述                                                                                                                                                             | 示例                        |
+|:-------------------------------------------------------------:| -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
+| {% data variables.product.support_ticket_priority_urgent %} | 在 {% data variables.product.prodname_ghe_cloud %} 上的组织或企业的生产工作流程由于严重服务错误或中断而失败，并且该失败直接影响您的业务运营。                                                              | 
    • {% data variables.product.prodname_dotcom_the_website %} 上的错误或中断影响您组织或企业所有成员的核心 Git 或 web 应用程序功能
     |
+|  {% data variables.product.support_ticket_priority_high %}  | 在 {% data variables.product.prodname_ghe_cloud %} 上的组织或企业的帐户或安全问题对您的业务产生了有限的影响。                                                                              | 
    • 组织或企业所有者无意中删除了组织
    • 组织或企业成员在提交、议题、拉取请求或议题附件中上传了敏感数据
     |
 | {% data variables.product.support_ticket_priority_normal %} | 在 {% data variables.product.prodname_ghe_cloud %} 上的组织或企业成员使用 {% data variables.product.prodname_dotcom_the_website %} 时遇到了有限或普通问题，或者您对于自己的组织或企业有一般性疑虑或问题。 | 
    • 有关为组织或企业使用 API 和功能的问题
    • 有关 {% data variables.product.company_short %} 提供的组织数据迁移工具的问题
    • 组织或企业的相关功能未按预期工作
    • 有关组织或企业的一般安全问题
     |
-|  {% data variables.product.support_ticket_priority_low %}   | 您对于 {% data variables.product.prodname_ghe_cloud %} 上的组织或企业有问题或建议，但并不紧迫，或者该问题不影响团队的生产力。                                                                           | 
    • 您的组织或企业过度使用资源
    • 请求状态检查
    • 您的组织或企业在使用 Gist、通知、wiki、{% data variables.product.prodname_pages %}、{% data variables.product.prodname_desktop %}、Atom 或其他外围服务或功能方面需要帮助
    • 功能请求
    • 产品反馈
     |
+|  {% data variables.product.support_ticket_priority_low %}   | 您对于 {% data variables.product.prodname_ghe_cloud %} 上的组织或企业有问题或建议，但并不紧迫，或者该问题不影响团队的生产力。                                                                      | 
    • 您的组织或企业过度使用资源
    • 请求状态检查
    • 您的组织或企业在使用 Gist、通知、wiki、{% data variables.product.prodname_pages %}、{% data variables.product.prodname_desktop %}、Atom 或其他外围服务或功能方面需要帮助
    • 功能请求
    • 产品反馈
     |
diff --git a/translations/zh-CN/data/reusables/support/ghes-priorities.md b/translations/zh-CN/data/reusables/support/ghes-priorities.md
index d2ae3a5f7873..7b0c61928c6e 100644
--- a/translations/zh-CN/data/reusables/support/ghes-priorities.md
+++ b/translations/zh-CN/data/reusables/support/ghes-priorities.md
@@ -1,6 +1,6 @@
-|                                优先级                                 | 描述                                                                                                                                                                          | 示例                        |
-|:------------------------------------------------------------------:| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
+|                              优先级                              | 描述                                                                                                                                                                | 示例                        |
+|:-------------------------------------------------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
 | {% data variables.product.support_ticket_priority_urgent %} | {% data variables.product.prodname_ghe_server %} 在生产环境中出现故障，并且该故障直接影响您的业务运营。

    _{% data reusables.support.priority-urgent-english-only %}_ | 
    • 影响所有用户的核心 Git 或 web 应用程序功能的错误或中断
    • 影响大多数用户的性能严重下降
    • 用完或快速占用存储空间
    • 无法安装续订的许可文件
    • 安全事件
    • 失去对实例的管理权限，并且没有已知的解决方法
    • 无法将备份还原到生产环境
     |
-|  {% data variables.product.support_ticket_priority_high %}  | {% data variables.product.prodname_ghe_server %} 在生产环境中出现故障，但对您的业务影响有限。                                                                                              | 
    • 性能下降，影响许多用户的工作效率
    • 因高可用性 (HA) 或集群节点故障而减少冗余
    • 无法备份实例
    • 无法将备份还原到测试或暂存环境，可能影响成功还原到生产环境
     |
-| {% data variables.product.support_ticket_priority_normal %} | 您在 {% data variables.product.prodname_ghe_server %} 方面遇到了有限或普通问题，或者对于实例运行有一般性疑虑或问题。                                                                                  | 
    • 测试或暂存环境中的问题
    • 在使用 {% data variables.product.prodname_dotcom %} API 和功能方面需要寻求建议，或者从实例配置第三方集成方面存在问题
    • 有关 {% data variables.product.company_short %} 提供的用户数据迁移工具的问题
    • 升级
    • 漏洞报告
    • 功能未按预期工作
    • 一般安全问题
     |
-|  {% data variables.product.support_ticket_priority_low %}   | 您对于 {% data variables.product.prodname_ghe_server %} 有问题或建议，但并不紧迫，或者该问题不影响团队的生产力。                                                                                    | 
    • 功能请求
    • 产品反馈
    • 状态检查请求（目前仅适用于 {% data variables.product.premium_support_plan %} 客户）
    • 通知 {% data variables.product.company_short %} 对实例进行计划内维护
     |
+|  {% data variables.product.support_ticket_priority_high %}  | {% data variables.product.prodname_ghe_server %} 在生产环境中出现故障，但对您的业务影响有限。                                                                                         | 
    • 性能下降，影响许多用户的工作效率
    • 因高可用性 (HA) 或集群节点故障而减少冗余
    • 无法备份实例
    • 无法将备份还原到测试或暂存环境，可能影响成功还原到生产环境
     |
+| {% data variables.product.support_ticket_priority_normal %} | 您在 {% data variables.product.prodname_ghe_server %} 方面遇到了有限或普通问题，或者对于实例运行有一般性疑虑或问题。                                                                             | 
    • 测试或暂存环境中的问题
    • 在使用 {% data variables.product.prodname_dotcom %} API 和功能方面需要寻求建议，或者从实例配置第三方集成方面存在问题
    • 有关 {% data variables.product.company_short %} 提供的用户数据迁移工具的问题
    • 升级
    • 漏洞报告
    • 功能未按预期工作
    • 一般安全问题
     |
+|  {% data variables.product.support_ticket_priority_low %}   | 您对于 {% data variables.product.prodname_ghe_server %} 有问题或建议，但并不紧迫，或者该问题不影响团队的生产力。                                                                               | 
    • 功能请求
    • 产品反馈
    • 状态检查请求（目前仅适用于 {% data variables.product.premium_support_plan %} 客户）
    • 通知 {% data variables.product.company_short %} 对实例进行计划内维护
     |
diff --git a/translations/zh-CN/data/reusables/support/priority-urgent-english-only.md b/translations/zh-CN/data/reusables/support/priority-urgent-english-only.md
index bb3641e83471..71f848aa1c3c 100644
--- a/translations/zh-CN/data/reusables/support/priority-urgent-english-only.md
+++ b/translations/zh-CN/data/reusables/support/priority-urgent-english-only.md
@@ -1 +1 @@
-对 {% data variables.product.support_ticket_priority_urgent %} 优先级事件单的支持服务只以英语提供。
\ No newline at end of file
+对 {% data variables.product.support_ticket_priority_urgent %} 优先级事件单的支持服务只以英语提供。
diff --git a/translations/zh-CN/data/reusables/support/receiving-credits.md b/translations/zh-CN/data/reusables/support/receiving-credits.md
index cdf11b87ec24..fbe9eb87d470 100644
--- a/translations/zh-CN/data/reusables/support/receiving-credits.md
+++ b/translations/zh-CN/data/reusables/support/receiving-credits.md
@@ -14,6 +14,6 @@
 - **日期**（日期必须基于 {% data variables.product.company_short %}财政年度的季度结束 [1 月 31 日、4 月 30 日、7 月 31 日或 10月 31 日] 后 30 天内。)
 - **客户联系**（您必须同时指定姓名和电子邮件地址。）
 - **客户地址**
-- **合格信用**（您必须提供每个合格信用的日期和关联的事件单编号。）{% if currentVersion == "free-pro-team@latest" %}
+- **Qualifying credits** (You must provide the date of each qualifying credit and the associated ticket number.){% if currentVersion == "free-pro-team@latest" %}
 - **{% data variables.product.prodname_ghe_cloud %} 组织的名称**{% endif %}
 - **事件单编号**
diff --git a/translations/zh-CN/data/reusables/support/service-level-agreement-response-times.md b/translations/zh-CN/data/reusables/support/service-level-agreement-response-times.md
index 68511c77b238..bb28206e7f44 100644
--- a/translations/zh-CN/data/reusables/support/service-level-agreement-response-times.md
+++ b/translations/zh-CN/data/reusables/support/service-level-agreement-response-times.md
@@ -2,7 +2,7 @@
 
 对于您提交的事件单，我们提供全天候支持。 SLA 保证的初始响应时间取决于事件单的优先级。 响应时间从 {% data variables.contact.premium_support %} 确定事件单的优先级开始计算。 响应并不意味着问题已经得到解决。
 
-| 事件单优先级                                                             | 初始响应时间 |
-| ------------------------------------------------------------------ | ------ |
+| 事件单优先级                                                        | 初始响应时间 |
+| ------------------------------------------------------------- | ------ |
 | {% data variables.product.support_ticket_priority_urgent %} | 30 分钟  |
 | {% data variables.product.support_ticket_priority_high %}   | 4 小时   |
diff --git a/translations/zh-CN/data/reusables/two_fa/about-2fa.md b/translations/zh-CN/data/reusables/two_fa/about-2fa.md
new file mode 100644
index 000000000000..704cb699cc2e
--- /dev/null
+++ b/translations/zh-CN/data/reusables/two_fa/about-2fa.md
@@ -0,0 +1 @@
+Two-factor authentication (2FA) is an extra layer of security used when logging into websites or apps.
diff --git a/translations/zh-CN/data/reusables/two_fa/after-2fa-add-security-key.md b/translations/zh-CN/data/reusables/two_fa/after-2fa-add-security-key.md
index e743c3e3e6f2..2bd327fd4a8c 100644
--- a/translations/zh-CN/data/reusables/two_fa/after-2fa-add-security-key.md
+++ b/translations/zh-CN/data/reusables/two_fa/after-2fa-add-security-key.md
@@ -1 +1 @@
-使用手机应用程序{% if currentVersion == "free-pro-team@latest" %}或通过短信{% endif %}配置 2FA 后，您可以添加一个安全密钥，如指纹识别器或 Windows Hello。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}使用安全密钥进行身份验证的技术，称为 WebAuth。 WebAuthn 是 U2F 的继承者，适用于所有现代浏览器。 更多信息请参阅 "[WebAuthn](https://webauthn.guide/)" 和“[我能用吗](https://caniuse.com/#search=webauthn)”。{% else %}FIDO U2F 身份验证目前可用于 Chrome、Firefox 和 Opera 浏览器。{% endif %}
+After you configure 2FA using a mobile app{% if currentVersion == "free-pro-team@latest" %} or via text message{% endif %}, you can add a security key, like a fingerprint reader or Windows Hello. The technology that enables authentication with a security key is called WebAuthn. WebAuthn 是 U2F 的继承者，适用于所有现代浏览器。 For more information, see "[WebAuthn](https://webauthn.guide/)" and "[Can I Use](https://caniuse.com/#search=webauthn)."
diff --git a/translations/zh-CN/data/reusables/two_fa/auth_methods_2fa.md b/translations/zh-CN/data/reusables/two_fa/auth_methods_2fa.md
index 4c5f4da55e34..eac14aac179e 100644
--- a/translations/zh-CN/data/reusables/two_fa/auth_methods_2fa.md
+++ b/translations/zh-CN/data/reusables/two_fa/auth_methods_2fa.md
@@ -1,10 +1,10 @@
 {% if currentVersion != "free-pro-team@latest" %}
 ### 支持 2FA 的身份验证方法
 
-| 身份验证方法         | 描述                                                                            | 双重身份验证支持                                                                                                                     |
-| -------------- | ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| 身份验证方法         | 描述                                                                       | 双重身份验证支持                                                                                                                                |
+| -------------- | ------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- |
 | 内置             | 根据存储在 {% data variables.product.prodname_ghe_server %} 设备上的用户帐户进行身份验证。 | 在 {% data variables.product.prodname_ghe_server %} 设备上支持和管理。 组织管理员可要求对组织的成员启用 2FA。 |{% if currentVersion != "free-pro-team@latest" %}
-| 内置向身份提供商进行身份验证 | 根据存储在身份提供程序中的用户帐户进行身份验证。                                                      | 依赖身份提供程序。{% endif %}
-| LDAP           | 允许与您的公司目录服务集成以进行身份验证。                                                         | 在 {% data variables.product.prodname_ghe_server %} 设备上支持和管理。 组织管理员可要求对组织的成员启用 2FA。                                    |
-| SAML           | 在外部身份提供商上进行身份验证。                                                              | {% data reusables.two_fa.2fa_not_supported_with_saml_and_cas %}                                                   |
-| CAS            | 单点登录服务由外部服务器提供。                                                               | {% data reusables.two_fa.2fa_not_supported_with_saml_and_cas %}{% endif %}
+| 内置向身份提供商进行身份验证 | 根据存储在身份提供程序中的用户帐户进行身份验证。                                                 | 依赖身份提供程序。{% endif %}
+| LDAP           | 允许与您的公司目录服务集成以进行身份验证。                                                    | 在 {% data variables.product.prodname_ghe_server %} 设备上支持和管理。 组织管理员可要求对组织的成员启用 2FA。                                                    |
+| SAML           | 在外部身份提供商上进行身份验证。                                                         | {% data reusables.two_fa.2fa_not_supported_with_saml_and_cas %}
+| CAS            | 单点登录服务由外部服务器提供。                                                          | {% data reusables.two_fa.2fa_not_supported_with_saml_and_cas %}{% endif %}
diff --git a/translations/zh-CN/data/reusables/user-settings/edit_marketplace_listing.md b/translations/zh-CN/data/reusables/user-settings/edit_marketplace_listing.md
index 7b7bf4115a29..c35b32dbea6f 100644
--- a/translations/zh-CN/data/reusables/user-settings/edit_marketplace_listing.md
+++ b/translations/zh-CN/data/reusables/user-settings/edit_marketplace_listing.md
@@ -1 +1 @@
-5. Scroll down to the Marketplace section and click **Edit Marketplace listing**. The Marketplace section is only visible if you allowed your app to be installed by any user or organization when registering the app.  For more information, see the list of [Marketplace requirements](/apps/marketplace/creating-and-submitting-your-app-for-approval/requirements-for-listing-an-app-on-github-marketplace/). ![link to edit your GitHub Marketplace listing](/assets/images/marketplace/marketplace_edit_listing_text.png)
+5. 向下滚动到 Marketplace 部分，然后单击 **Edit Marketplace listing（编辑 Marketplace 上架信息）**。 只有在注册您的应用程序时允许任何用户或组织安装该应用程序，Marketplace 部分才可见。  更多信息请参阅 [Marketplace 要求](/apps/marketplace/creating-and-submitting-your-app-for-approval/requirements-for-listing-an-app-on-github-marketplace/)列表。 ![编辑 GitHub Marketplace 上架信息的链接](/assets/images/marketplace/marketplace_edit_listing_text.png)
diff --git a/translations/zh-CN/data/reusables/user-settings/github_apps.md b/translations/zh-CN/data/reusables/user-settings/github_apps.md
index 34b0b56f24c9..5df32897190a 100644
--- a/translations/zh-CN/data/reusables/user-settings/github_apps.md
+++ b/translations/zh-CN/data/reusables/user-settings/github_apps.md
@@ -1 +1 @@
-1. In the left sidebar, click **GitHub Apps**. ![GitHub Apps 部分](/assets/images/settings/github_apps.png)
+1. 在左侧边栏中，单击 ** GitHub Apps（GitHub 应用程序）**。 ![GitHub Apps 部分](/assets/images/settings/github_apps.png)
diff --git a/translations/zh-CN/data/reusables/user-settings/github_apps_advanced.md b/translations/zh-CN/data/reusables/user-settings/github_apps_advanced.md
index 5378aa17dc14..ac1feb709d42 100644
--- a/translations/zh-CN/data/reusables/user-settings/github_apps_advanced.md
+++ b/translations/zh-CN/data/reusables/user-settings/github_apps_advanced.md
@@ -1 +1 @@
-1. In the left sidebar, click **Advanced**. ![Advanced tab](/assets/images/github-apps/github_apps_advanced.png)
+1. 在左侧边栏中，单击 **Advanced（高级）**。 ![Advanced（高级）选项卡](/assets/images/github-apps/github_apps_advanced.png)
diff --git a/translations/zh-CN/data/reusables/user-settings/marketplace_apps.md b/translations/zh-CN/data/reusables/user-settings/marketplace_apps.md
index ca67c90f8769..bd3ee003c9d4 100644
--- a/translations/zh-CN/data/reusables/user-settings/marketplace_apps.md
+++ b/translations/zh-CN/data/reusables/user-settings/marketplace_apps.md
@@ -1,4 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-1. In the left sidebar, click either **OAuth Apps** or **GitHub Apps** depending on the {% data variables.product.prodname_marketplace %} listing you'd like to manage. **Note:** You can also manage your listing by navigating to https://github.com/marketplace/manage. ![App type selection](/assets/images/settings/apps_choose_app.png)
+1. In the left sidebar, click either **OAuth Apps** or **GitHub Apps** depending on the {% data variables.product.prodname_marketplace %} listing you'd like to manage. **注：**您也可以通过导航到 https://github.com/marketplace/manage 来管理您的上架信息。 ![App type selection](/assets/images/settings/apps_choose_app.png)
 
 {% endif %}
diff --git a/translations/zh-CN/data/reusables/user-settings/modify_github_app.md b/translations/zh-CN/data/reusables/user-settings/modify_github_app.md
index 7144b8501f73..32521de0a846 100644
--- a/translations/zh-CN/data/reusables/user-settings/modify_github_app.md
+++ b/translations/zh-CN/data/reusables/user-settings/modify_github_app.md
@@ -1 +1 @@
-1. Select the GitHub App you want to modify. ![App selection](/assets/images/github-apps/github_apps_select-app.png)
+1. 选择您要修改的 GitHub 应用程序。 ![App selection](/assets/images/github-apps/github_apps_select-app.png)
diff --git a/translations/zh-CN/data/reusables/user-settings/oauth_apps.md b/translations/zh-CN/data/reusables/user-settings/oauth_apps.md
index 044bdb452a9f..1c2b753974e0 100644
--- a/translations/zh-CN/data/reusables/user-settings/oauth_apps.md
+++ b/translations/zh-CN/data/reusables/user-settings/oauth_apps.md
@@ -1 +1 @@
-1. In the left sidebar, click **OAuth Apps**. ![OAuth Apps section](/assets/images/settings/oauth_apps_post2dot12.png)
+1. 在左边栏中，单击 **OAuth Apps（OAuth 应用程序）**。 ![OAuth 应用程序部分](/assets/images/settings/oauth_apps_post2dot12.png)
diff --git a/translations/zh-CN/data/reusables/user-settings/update_oauth_app.md b/translations/zh-CN/data/reusables/user-settings/update_oauth_app.md
index 5d0f1ffa7fc2..f36d7059a699 100644
--- a/translations/zh-CN/data/reusables/user-settings/update_oauth_app.md
+++ b/translations/zh-CN/data/reusables/user-settings/update_oauth_app.md
@@ -1 +1 @@
-1. Click **Update application**. ![Button to update the application](/assets/images/oauth-apps/oauth_apps_update_application.png)
+1. 单击 **Update application（更新应用程序）**。 ![更新应用程序的按钮](/assets/images/oauth-apps/oauth_apps_update_application.png)
diff --git a/translations/zh-CN/data/reusables/user_settings/about-commit-email-addresses.md b/translations/zh-CN/data/reusables/user_settings/about-commit-email-addresses.md
index cbf20ff054b0..c1d07e76835b 100644
--- a/translations/zh-CN/data/reusables/user_settings/about-commit-email-addresses.md
+++ b/translations/zh-CN/data/reusables/user_settings/about-commit-email-addresses.md
@@ -1 +1 @@
-有关提交电子邮件地址的详细信息，{% if currentVersion == "free-pro-team@latest" %} 包括 {% data variables.product.product_name %}-提供的 `noreply` 电子邮件地址，{% endif %} 请参阅“[设置提交电子邮件地址](/articles/setting-your-commit-email-address)”。
+For more information on commit email addresses,{% if currentVersion == "free-pro-team@latest" %} including your {% data variables.product.product_name %}-provided `noreply` email address,{% endif %} see "[Setting your commit email address](/articles/setting-your-commit-email-address)."
diff --git a/translations/zh-CN/data/reusables/user_settings/export-data.md b/translations/zh-CN/data/reusables/user_settings/export-data.md
index a902340826d0..857cba63b9c9 100644
--- a/translations/zh-CN/data/reusables/user_settings/export-data.md
+++ b/translations/zh-CN/data/reusables/user_settings/export-data.md
@@ -1,3 +1,4 @@
 {% if currentVersion == "free-pro-team@latest" %}
-您可以导出并查看 {% data variables.product.product_name %} 存储的有关您个人帐户的元数据。
+You can export and review the metadata that
+{% data variables.product.product_name %} stores about your personal account.
 {% endif %}
diff --git a/translations/zh-CN/data/reusables/user_settings/password-authentication-deprecation-desktop.md b/translations/zh-CN/data/reusables/user_settings/password-authentication-deprecation-desktop.md
index cb23969e5b96..af1abcdf6e87 100644
--- a/translations/zh-CN/data/reusables/user_settings/password-authentication-deprecation-desktop.md
+++ b/translations/zh-CN/data/reusables/user_settings/password-authentication-deprecation-desktop.md
@@ -1,5 +1,5 @@
   {% warning %}
 
-  **Warning**: Authenticating to {% data variables.product.prodname_dotcom %} using your username and password is deprecated. We recommend authenticating using the browser instead.
+  **Warning**: Authenticating to {% data variables.product.prodname_dotcom %} using your username and password is deprecated. 我们建议使用浏览器进行身份验证。
 
   {% endwarning %}
diff --git a/translations/zh-CN/data/reusables/user_settings/password-authentication-deprecation.md b/translations/zh-CN/data/reusables/user_settings/password-authentication-deprecation.md
index fd45c3ab7d43..4e68c0ce2c99 100644
--- a/translations/zh-CN/data/reusables/user_settings/password-authentication-deprecation.md
+++ b/translations/zh-CN/data/reusables/user_settings/password-authentication-deprecation.md
@@ -1 +1 @@
-Password-based authentication for Git is deprecated, and we recommend using a personal access token (PAT) when prompted for a password instead, which is more secure. Treat your token just like a password. 更多信息请参阅“[创建个人访问令牌](/github/authenticating-to-github/creating-a-personal-access-token)”。
\ No newline at end of file
+不建议使用基于密码的 Git 身份验证，我们建议在提示输入密码时使用个人访问令牌，因为这样更安全。 像对待密码一样对待令牌。 更多信息请参阅“[创建个人访问令牌](/github/authenticating-to-github/creating-a-personal-access-token)”。
diff --git a/translations/zh-CN/data/reusables/user_settings/personal_dashboard.md b/translations/zh-CN/data/reusables/user_settings/personal_dashboard.md
index 6a33ff9fdf64..07083b821d07 100644
--- a/translations/zh-CN/data/reusables/user_settings/personal_dashboard.md
+++ b/translations/zh-CN/data/reusables/user_settings/personal_dashboard.md
@@ -1 +1 @@
-{% if currentVersion == "free-pro-team@latest" %}[个人仪表板](https://github.com/dashboard){% else %}个人仪表板(`https://[hostname]/dashboard`){% endif %}
+{% if currentVersion == "free-pro-team@latest" %}[personal dashboard](https://github.com/dashboard){% else %}personal dashboard (`https://[hostname]/dashboard`){% endif %}
diff --git a/translations/zh-CN/data/reusables/user_settings/review_oauth_tokens_tip.md b/translations/zh-CN/data/reusables/user_settings/review_oauth_tokens_tip.md
index 294c61c69c63..ddda1afadcd3 100644
--- a/translations/zh-CN/data/reusables/user_settings/review_oauth_tokens_tip.md
+++ b/translations/zh-CN/data/reusables/user_settings/review_oauth_tokens_tip.md
@@ -1 +1 @@
-We recommend that you regularly review your authorized integrations. 删除在一段时间内未使用的任何应用程序和令牌。 更多信息请参阅“[>审查授权的集成](/articles/reviewing-your-authorized-integrations)”。
+我们建议您定期审查您授权的集成。 删除在一段时间内未使用的任何应用程序和令牌。 更多信息请参阅“[>审查授权的集成](/articles/reviewing-your-authorized-integrations)”。
diff --git a/translations/zh-CN/data/reusables/user_settings/security-analysis.md b/translations/zh-CN/data/reusables/user_settings/security-analysis.md
index 277dda59f60d..754ff74f8782 100644
--- a/translations/zh-CN/data/reusables/user_settings/security-analysis.md
+++ b/translations/zh-CN/data/reusables/user_settings/security-analysis.md
@@ -1 +1 @@
-1. 在左侧边栏中，单击 **Security & analysis（安全和分析）**。 ![Security and analysis settings](/assets/images/help/settings/settings-sidebar-security-analysis.png)
+1. 在左侧边栏中，单击 **Security & analysis（安全和分析）**。 ![安全和分析设置](/assets/images/help/settings/settings-sidebar-security-analysis.png)
diff --git a/translations/zh-CN/data/reusables/user_settings/security.md b/translations/zh-CN/data/reusables/user_settings/security.md
index cdfa80d0c321..53557a3bedf4 100644
--- a/translations/zh-CN/data/reusables/user_settings/security.md
+++ b/translations/zh-CN/data/reusables/user_settings/security.md
@@ -1,4 +1,4 @@
-{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}1. In the left sidebar, click **Account security**.
-![User account security settings](/assets/images/help/settings/settings-sidebar-account-security.png)
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}1. 在左侧边栏中，单击 **Account security（帐户安全）**。
+![用户帐户安全设置](/assets/images/help/settings/settings-sidebar-account-security.png)
 {% else %}1. 在左侧边栏中，单击 **Security（安全）**。
-![User account security settings](/assets/images/help/settings/settings-sidebar-security.png){% endif %}
+![用户帐户安全设置](/assets/images/help/settings/settings-sidebar-security.png){% endif %}
diff --git a/translations/zh-CN/data/reusables/user_settings/set_your_email_address_in_git.md b/translations/zh-CN/data/reusables/user_settings/set_your_email_address_in_git.md
index 8325b1eeac80..f30e436e4ed9 100644
--- a/translations/zh-CN/data/reusables/user_settings/set_your_email_address_in_git.md
+++ b/translations/zh-CN/data/reusables/user_settings/set_your_email_address_in_git.md
@@ -1 +1 @@
-在 Git 中设置电子邮件地址。 您可以使用 {% if currentVersion == "free-pro-team@latest"%}[{% data variables.product.product_name %} 提供的 `no-reply` 电子邮件地址](/articles/setting-your-commit-email-address)或{% endif %}任何电子邮件地址。
+在 Git 中设置电子邮件地址。 You can use {% if currentVersion == "free-pro-team@latest"%}your [{% data variables.product.product_name %}-provided `no-reply` email address](/articles/setting-your-commit-email-address) or {% endif %}any email address.
diff --git a/translations/zh-CN/data/reusables/user_settings/subscriptions-tab.md b/translations/zh-CN/data/reusables/user_settings/subscriptions-tab.md
index 5675630a6d4a..8ac9df9540ad 100644
--- a/translations/zh-CN/data/reusables/user_settings/subscriptions-tab.md
+++ b/translations/zh-CN/data/reusables/user_settings/subscriptions-tab.md
@@ -1 +1 @@
-1. Click **Subscriptions**. ![订阅选项卡](/assets/images/help/settings/subscriptions-tab.png)
+1. 单击 **Subscriptions（订阅）**. ![订阅选项卡](/assets/images/help/settings/subscriptions-tab.png)
diff --git a/translations/zh-CN/data/reusables/user_settings/sudo-mode-popup.md b/translations/zh-CN/data/reusables/user_settings/sudo-mode-popup.md
index c5e1c5be2e00..306b67e97ebf 100644
--- a/translations/zh-CN/data/reusables/user_settings/sudo-mode-popup.md
+++ b/translations/zh-CN/data/reusables/user_settings/sudo-mode-popup.md
@@ -1 +1 @@
-1. 如有提示，请确认您的 {% data variables.product.product_name %} 密码。 ![Sudo 模式对话框](/assets/images/help/settings/sudo_mode_popup.png)
\ No newline at end of file
+1. 如有提示，请确认您的 {% data variables.product.product_name %} 密码。 ![Sudo 模式对话框](/assets/images/help/settings/sudo_mode_popup.png)
diff --git a/translations/zh-CN/data/reusables/webhooks/action_type_desc.md b/translations/zh-CN/data/reusables/webhooks/action_type_desc.md
index 3342e6e1c6ec..d5613198cfb1 100644
--- a/translations/zh-CN/data/reusables/webhooks/action_type_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/action_type_desc.md
@@ -1 +1 @@
-The type of activity is specified in the `action` property of the payload object.
\ No newline at end of file
+活动类型在有效负载对象的 `action` 属性中指定。
diff --git a/translations/zh-CN/data/reusables/webhooks/app_desc.md b/translations/zh-CN/data/reusables/webhooks/app_desc.md
index 9dbfd79e4d6f..e81bab2cf4dc 100644
--- a/translations/zh-CN/data/reusables/webhooks/app_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/app_desc.md
@@ -1 +1 @@
-`installation` | `object` | The {% data variables.product.prodname_github_app %} installation. Webhook payloads contain the `installation` property when the event is configured for and sent to a {% data variables.product.prodname_github_app %}.
\ No newline at end of file
+`installation` | `object` | The {% data variables.product.prodname_github_app %} installation. Webhook payloads contain the `installation` property when the event is configured for and sent to a {% data variables.product.prodname_github_app %}.
diff --git a/translations/zh-CN/data/reusables/webhooks/authorization_event.md b/translations/zh-CN/data/reusables/webhooks/authorization_event.md
index 4afc18c3f41b..5089212715ee 100644
--- a/translations/zh-CN/data/reusables/webhooks/authorization_event.md
+++ b/translations/zh-CN/data/reusables/webhooks/authorization_event.md
@@ -1 +1 @@
-Anyone can revoke their authorization of a GitHub App from their [GitHub account settings page](https://github.com/settings/apps/authorizations). Revoking the authorization of a GitHub App does not uninstall the GitHub App. You should program your GitHub App so that when it receives this webhook, it stops calling the API on behalf of the person who revoked the token. If your GitHub App continues to use a revoked access token, it will receive the `401 Bad Credentials` error.
+任何人都可以从 [GitHub 帐户设置页面](https://github.com/settings/apps/authorizations)撤销他们对 GitHub 应用程序的授权。 撤销对 GitHub 应用程序的授权不会卸载 GitHub 应用程序。 您应该编程 GitHub 应用程序，使其在收到此 web 挂钩后，不再代表已撤销令牌的人调用 API。 如果 GitHub 应用程序继续使用已撤销的访问令牌，它将收到 `401 Bad Credentials` 错误。
diff --git a/translations/zh-CN/data/reusables/webhooks/check_run_properties.md b/translations/zh-CN/data/reusables/webhooks/check_run_properties.md
index 0254d29806be..f68ca7b65125 100644
--- a/translations/zh-CN/data/reusables/webhooks/check_run_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/check_run_properties.md
@@ -1,10 +1,10 @@
-| 键                              | 类型    | 描述                                                                                                                                                                                                                                                                                                                    |
-| ------------------------------ | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `action`                       | `字符串` | 执行的操作。 可以是以下选项之一： 
    •  `created` - A new check run was created.
    •  `completed` - The `status` of the check run is `completed`.
    •  `rerequested` - Someone requested to re-run your check run from the pull request UI. See "[About status checks](/articles/about-status-checks#checks)" for more details about the GitHub UI. When you receive a `rerequested` action, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run). Only the {% data variables.product.prodname_github_app %} that someone requests to re-run the check will receive the `rerequested` payload.
    •  `requested_action` - Someone requested an action your app provides to be taken. Only the {% data variables.product.prodname_github_app %} someone requests to perform an action will receive the `requested_action` payload. To learn more about check runs and requested actions, see "[Check runs and requested actions](/v3/checks/runs/#check-runs-and-requested-actions)."
                                                                                                                                                                                                                                                                                |
-| `check_run`                    | `对象`  | The [check_run](/v3/checks/runs/#get-a-check-run).                                                                                                                                                                                                                                                                    |
-| `check_run[status]`            | `字符串` | The current status of the check run. Can be `queued`, `in_progress`, or `completed`.                                                                                                                                                                                                                                  |
-| `check_run[conclusion]`        | `字符串` | The result of the completed check run. Can be one of `success`, `failure`, `neutral`, `cancelled`, `timed_out`,  {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}`action_required` or `stale`{% else %}or `action_required`{% endif %}. This value will be `null` until the check run has `completed`. |
-| `check_run[name]`              | `字符串` | The name of the check run.                                                                                                                                                                                                                                                                                            |
-| `check_run[check_suite][id]`   | `整数`  | The id of the check suite that this check run is part of.                                                                                                                                                                                                                                                             |
-| `requested_action`             | `对象`  | The action requested by the user.                                                                                                                                                                                                                                                                                     |
-| `requested_action[identifier]` | `字符串` | The integrator reference of the action requested by the user.                                                                                                                                                                                                                                                         |
\ No newline at end of file
+| 键                              | 类型    | 描述                                                                                                                                                                                                                                                                                              |
+| ------------------------------ | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `action`                       | `字符串` | 执行的操作。 可以是以下选项之一： 
    •  `created` - 创建了新的检查运行。
    •  `completed` - 检查运行的“状态”为“已完成”。
    •  `rerequested` - 有人请求从拉取请求 UI 重新运行检查。 有关 GitHub UI 的更多信息，请参阅“关于状态检查](/articles/about-status-checks#checks)”。 收到 `rerequested` 操作时，您需要[创建新的检查运行](/v3/checks/runs/#create-a-check-run)。 Only the {% data variables.product.prodname_github_app %} that someone requests to re-run the check will receive the `rerequested` payload.
    •  `requested_action` - 有人请求执行应用程序提供的操作。 Only the {% data variables.product.prodname_github_app %} someone requests to perform an action will receive the `requested_action` payload. 有关检查运行和请求操作的更多信息，请参阅“[检查运行和请求操作](/v3/checks/runs/#check-runs-and-requested-actions)”。
                                                                                                                                                                                                                                                          |
+| `check_run`                    | `对象`  | [check_run](/v3/checks/runs/#get-a-check-run)。                                                                                                                                                                                                                                                  |
+| `check_run[status]`            | `字符串` | 检查运行的当前状态。 可以是 `queued`、`in_progress` 或 `completed`。                                                                                                                                                                                                                                            |
+| `check_run[conclusion]`        | `字符串` | 已完成检查运行的结果。 Can be one of `success`, `failure`, `neutral`, `cancelled`, `timed_out`,  {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}`action_required` or `stale`{% else %}or `action_required`{% endif %}. 此值将为 `null`，直到检查运行 `completed`。 |
+| `check_run[name]`              | `字符串` | 检查运行的名称。                                                                                                                                                                                                                                                                                        |
+| `check_run[check_suite][id]`   | `整数`  | 此检查运行所属检查套件的 ID。                                                                                                                                                                                                                                                                                |
+| `requested_action`             | `对象`  | 用户请求的操作。                                                                                                                                                                                                                                                                                        |
+| `requested_action[identifier]` | `字符串` | 用户请求的操作的集成器引用。                                                                                                                                                                                                                                                                                  |
diff --git a/translations/zh-CN/data/reusables/webhooks/check_run_short_desc.md b/translations/zh-CN/data/reusables/webhooks/check_run_short_desc.md
index 305bd1626e33..701b1de6fac1 100644
--- a/translations/zh-CN/data/reusables/webhooks/check_run_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/check_run_short_desc.md
@@ -1 +1 @@
-Check run activity has occurred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[check runs](/v3/checks/runs/)" REST API.
\ No newline at end of file
+检查运行活动已发生。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[check runs](/v3/checks/runs/)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/check_suite_properties.md b/translations/zh-CN/data/reusables/webhooks/check_suite_properties.md
index 77a1c7d703e0..861d0d4f4635 100644
--- a/translations/zh-CN/data/reusables/webhooks/check_suite_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/check_suite_properties.md
@@ -1,10 +1,10 @@
-| 键                            | 类型    | 描述                                                                                                                                                                                                                                                                                                                                                         |
-| ---------------------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `action`                     | `字符串` | 执行的操作。 Can be:
    • `completed` - All check runs in a check suite have completed.
    • `requested` - Occurs when new code is pushed to the app's repository. When you receive the `requested` action events, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run).
    • `rerequested` - Occurs when someone requests to re-run the entire check suite from the pull request UI. When you receive the `rerequested` action events, you'll need to [create a new check run](/v3/checks/runs/#create-a-check-run). See "[About status checks](/articles/about-status-checks#checks)" for more details about the GitHub UI.
                                                                                                                                                                                                                                                                                                                        |
-| `check_suite`                | `对象`  | The [check_suite](/v3/checks/suites/).                                                                                                                                                                                                                                                                                                                     |
-| `check_suite[head_branch]`   | `字符串` | The head branch name the changes are on.                                                                                                                                                                                                                                                                                                                   |
-| `check_suite[head_sha]`      | `字符串` | The SHA of the most recent commit for this check suite.                                                                                                                                                                                                                                                                                                    |
-| `check_suite[status]`        | `字符串` | The summary status for all check runs that are part of the check suite. Can be `requested`, `in_progress`, or `completed`.                                                                                                                                                                                                                                 |
-| `check_suite[conclusion]`    | `字符串` | The summary conclusion for all check runs that are part of the check suite. Can be one of `success`, `failure`, `neutral`, `cancelled`, `timed_out`,  {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}`action_required` or `stale`{% else %}or `action_required`{% endif %}. This value will be `null` until the check run has `completed`. |
-| `check_suite[url]`           | `字符串` | URL that points to the check suite API resource.                                                                                                                                                                                                                                                                                                           |
-| `check_suite[pull_requests]` | `数组`  | An array of pull requests that match this check suite. A pull request matches a check suite if they have the same `head_sha` and `head_branch`. When the check suite's `head_branch` is in a forked repository it will be `null` and the `pull_requests` array will be empty.                                                                              |
\ No newline at end of file
+| 键                            | 类型    | 描述                                                                                                                                                                                                                                                                                                    |
+| ---------------------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `action`                     | `字符串` | 执行的操作。 可以是：
    • `completed` - 检查套件中的所有检查运行已完成。
    • `requested` - 新代码被推送到应用程序的仓库时发生。 收到 `requested` 操作事件时，您需要[创建新的检查运行](/v3/checks/runs/#create-a-check-run)。
    • `rerequested` - 有人请求从拉取请求 UI 重新运行整个检查套件时发生。 收到 `rerequested` 操作事件时，您需要[创建新的检查运行](/v3/checks/runs/#create-a-check-run)。 有关 GitHub UI 的更多信息，请参阅“关于状态检查](/articles/about-status-checks#checks)”。
                                                                                                                                                                                                                                                                      |
+| `check_suite`                | `对象`  | [check_suite](/v3/checks/suites/)。                                                                                                                                                                                                                                                                    |
+| `check_suite[head_branch]`   | `字符串` | 更改所在的头部分支的名称。                                                                                                                                                                                                                                                                                         |
+| `check_suite[head_sha]`      | `字符串` | 此检查套件的最新提交的 SHA。                                                                                                                                                                                                                                                                                      |
+| `check_suite[status]`        | `字符串` | 检查套件中所有检查运行的摘要状态。 可以是 `requested`、`in_progress` 或 `completed`。                                                                                                                                                                                                                                        |
+| `check_suite[conclusion]`    | `字符串` | 检查套件中所有检查运行的摘要结论。 Can be one of `success`, `failure`, `neutral`, `cancelled`, `timed_out`,  {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}`action_required` or `stale`{% else %}or `action_required`{% endif %}. 此值将为 `null`，直到检查运行 `completed`。 |
+| `check_suite[url]`           | `字符串` | 指向检查套件 API 资源的 URL。                                                                                                                                                                                                                                                                                   |
+| `check_suite[pull_requests]` | `数组`  | 匹配此检查套件的拉取请求数组。 拉取请求与检查套件匹配的条件是它们有相同的 `head_sha` 和 `head_branch`。 检查套件的 `head_branch` 在复刻仓库中时，它将为 `null`，并且 `pull_requests` 数组将为空。                                                                                                                                                                    |
diff --git a/translations/zh-CN/data/reusables/webhooks/check_suite_short_desc.md b/translations/zh-CN/data/reusables/webhooks/check_suite_short_desc.md
index f7197fc59e48..fb80fa0563a7 100644
--- a/translations/zh-CN/data/reusables/webhooks/check_suite_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/check_suite_short_desc.md
@@ -1 +1 @@
-Check suite activity has occurred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[check suites](/v3/checks/suites/)" REST API.
\ No newline at end of file
+检查套件活动已发生。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[check suites](/v3/checks/suites/)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/code_scanning_alert_event_properties.md b/translations/zh-CN/data/reusables/webhooks/code_scanning_alert_event_properties.md
index 204496589104..d375c773a389 100644
--- a/translations/zh-CN/data/reusables/webhooks/code_scanning_alert_event_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/code_scanning_alert_event_properties.md
@@ -1,6 +1,6 @@
-| 键            | 类型    | 描述                                                                                                                                                                              |
-| ------------ | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `action`     | `字符串` | 执行的操作内容. This can be one of `created`, `reopened_by_user`, `closed_by_user`, `fixed`, `appeared_in_branch`, or `reopened`.                                                      |
-| `警报`         | `对象`  | The code scanning alert involved in the event.                                                                                                                                  |
-| `ref`        | `字符串` | The Git reference of the code scanning alert. When the action is `reopened_by_user` or `closed_by_user`,  the event was triggered by the `sender` and this value will be empty. |
-| `commit_oid` | `字符串` | The commit SHA of the code scanning alert. When the action is `reopened_by_user` or `closed_by_user`,  the event was triggered by the `sender` and this value will be empty.    |
+| 键            | 类型    | 描述                                                                                                         |
+| ------------ | ----- | ---------------------------------------------------------------------------------------------------------- |
+| `action`     | `字符串` | 执行的操作内容. 可以是以下项之一：`created`、`reopened_by_user`、`closed_by_user`、`fixed`、`appeared_in_branch` 或 `reopened`。 |
+| `警报`         | `对象`  | 事件中涉及的代码扫描警报。                                                                                              |
+| `ref`        | `字符串` | 代码扫描警报的 Git 引用。 当操作为 `reopened_by_user` 或 `closed_by_user` 时，事件由 `sender` 触发，此值将为空。                        |
+| `commit_oid` | `字符串` | 代码扫描警报的提交 SHA。 当操作为 `reopened_by_user` 或 `closed_by_user` 时，事件由 `sender` 触发，此值将为空。                         |
diff --git a/translations/zh-CN/data/reusables/webhooks/code_scanning_alert_event_short_desc.md b/translations/zh-CN/data/reusables/webhooks/code_scanning_alert_event_short_desc.md
index e246022ed42e..865b949c12b7 100644
--- a/translations/zh-CN/data/reusables/webhooks/code_scanning_alert_event_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/code_scanning_alert_event_short_desc.md
@@ -1 +1 @@
-Activity related to code scanning alerts in a repository. The type of activity is specified in the action property of the payload object. For more information, see “[About code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning).”
\ No newline at end of file
+与仓库中的代码扫描警报相关的活动。 活动类型在有效负载对象的操作属性中指定。 更多信息请参阅“[关于代码扫描](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)”。
diff --git a/translations/zh-CN/data/reusables/webhooks/commit_comment_properties.md b/translations/zh-CN/data/reusables/webhooks/commit_comment_properties.md
index 2e29d25a3a01..e002e6bb8cee 100644
--- a/translations/zh-CN/data/reusables/webhooks/commit_comment_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/commit_comment_properties.md
@@ -1,4 +1,4 @@
-| 键        | 类型    | 描述                                                                       |
-| -------- | ----- | ------------------------------------------------------------------------ |
-| `action` | `字符串` | 执行的操作。 可以是 `created`。                                                    |
-| `注释，评论`  | `对象`  | The [commit comment](/v3/repos/comments/#get-a-commit-comment) resource. |
\ No newline at end of file
+| 键        | 类型    | 描述                                                  |
+| -------- | ----- | --------------------------------------------------- |
+| `action` | `字符串` | 执行的操作。 可以是 `created`。                               |
+| `注释，评论`  | `对象`  | [提交评论](/v3/repos/comments/#get-a-commit-comment)资源。 |
diff --git a/translations/zh-CN/data/reusables/webhooks/commit_comment_short_desc.md b/translations/zh-CN/data/reusables/webhooks/commit_comment_short_desc.md
index 918e0279b925..06f2be83736b 100644
--- a/translations/zh-CN/data/reusables/webhooks/commit_comment_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/commit_comment_short_desc.md
@@ -1 +1 @@
-A commit comment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[commit comment](/v3/repos/comments/)" REST API.
\ No newline at end of file
+提交评论已创建。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[commit comment](/v3/repos/comments/)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/content_reference_short_desc.md b/translations/zh-CN/data/reusables/webhooks/content_reference_short_desc.md
index b7880d039d3a..ce452bfe714c 100644
--- a/translations/zh-CN/data/reusables/webhooks/content_reference_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/content_reference_short_desc.md
@@ -1 +1 @@
-A new content reference is `created`. A new content reference is created when the body or comment of an issue or pull request includes a URL that matches a configured content reference domain. For more information, see "[Using content attachments](/apps/using-content-attachments/)" to learn more about content references and attachments.
\ No newline at end of file
+新的内容引用为 `created`。 当议题或拉取请求的正文或注释包含与配置的内容引用域匹配的 URL 时，将创建新的内容引用。 有关内容引用和附件的更多信息，请参阅“[使用内容附件](/apps/using-content-attachments/)”。
diff --git a/translations/zh-CN/data/reusables/webhooks/content_type.md b/translations/zh-CN/data/reusables/webhooks/content_type.md
index 23245b2dfc3f..f00adc7512fb 100644
--- a/translations/zh-CN/data/reusables/webhooks/content_type.md
+++ b/translations/zh-CN/data/reusables/webhooks/content_type.md
@@ -1,6 +1,6 @@
-Webhooks can be delivered using different content types:
+Web 挂钩可通过不同的内容类型传递：
 
-- The `application/json` content type will deliver the JSON payload directly as the body of the `POST` request.
-- The `application/x-www-form-urlencoded` content type will send the JSON payload as a form parameter called `payload`.
+- `application/json` 内容类型将直接传递 JSON 有效负载，作为 `POST` 请求的正文。
+- `application/x-www-form-urlencoded` 内容类型将发送 JSON 有效负载，作为名为 `payload` 的表单参数。
 
-Choose the one that best fits your needs.
+选择最适合您需求的项。
diff --git a/translations/zh-CN/data/reusables/webhooks/create_properties.md b/translations/zh-CN/data/reusables/webhooks/create_properties.md
index cc9ecfb61951..065de065a968 100644
--- a/translations/zh-CN/data/reusables/webhooks/create_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/create_properties.md
@@ -1,6 +1,6 @@
-| 键               | 类型    | 描述                                                                                                                                                                                                   |
-| --------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `ref`           | `字符串` | {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}The [`git ref`](/v3/git/refs/#get-a-reference) resource.{% else %}The [`git ref`](/v3/git/refs/#get-a-reference) resource.{% endif %}
-| `ref_type`      | `字符串` | The type of Git ref object created in the repository. Can be either `branch` or `tag`.                                                                                                               |
-| `master_branch` | `字符串` | The name of the repository's default branch (usually `master`).                                                                                                                                      |
-| `说明`            | `字符串` | The repository's current description.                                                                                                                                                                |
\ No newline at end of file
+| 键               | 类型    | 描述                                                                                                                                                                                            |
+| --------------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `ref`           | `字符串` | The [`git ref`](/v3/git/refs/#get-a-reference) resource.                                                                                                                                      |
+| `ref_type`      | `字符串` | 在仓库中创建的 Git ref 对象的类型。 可以是 `branch` 或 `tag`。                                                                                                                                                  |
+| `master_branch` | `字符串` | The name of the repository's default branch (usually {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.23" %}`main`{% else %}`master`{% endif %}). |
+| `说明`            | `字符串` | 仓库的当前描述。                                                                                                                                                                                      |
diff --git a/translations/zh-CN/data/reusables/webhooks/create_short_desc.md b/translations/zh-CN/data/reusables/webhooks/create_short_desc.md
index 0140bfadf5c2..7f4e070b373f 100644
--- a/translations/zh-CN/data/reusables/webhooks/create_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/create_short_desc.md
@@ -1 +1 @@
-A Git branch or tag is created. For more information, see the "[Git data](/v3/git/)" REST API.
\ No newline at end of file
+Git 分支或标签已创建。 更多信息请参阅“[Git 数据](/v3/git/)”REST API。
diff --git a/translations/zh-CN/data/reusables/webhooks/delete_properties.md b/translations/zh-CN/data/reusables/webhooks/delete_properties.md
index aae591936130..7c107b493b90 100644
--- a/translations/zh-CN/data/reusables/webhooks/delete_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/delete_properties.md
@@ -1,4 +1,4 @@
-| 键          | 类型    | 描述                                                                                                                                                                                                   |
-| ---------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `ref`      | `字符串` | {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}The [`git ref`](/v3/git/refs/#get-a-reference) resource.{% else %}The [`git ref`](/v3/git/refs/#get-a-reference) resource.{% endif %}
-| `ref_type` | `字符串` | The type of Git ref oject deleted in the repository. Can be `branch` or `tag`.                                                                                                                       |
\ No newline at end of file
+| 键          | 类型    | 描述                                                       |
+| ---------- | ----- | -------------------------------------------------------- |
+| `ref`      | `字符串` | The [`git ref`](/v3/git/refs/#get-a-reference) resource. |
+| `ref_type` | `字符串` | 在仓库中删除的 Git ref 对象的类型。 可以是 `branch` 或 `tag`。             |
diff --git a/translations/zh-CN/data/reusables/webhooks/delete_short_desc.md b/translations/zh-CN/data/reusables/webhooks/delete_short_desc.md
index 60568e8b0958..9b8896f5567f 100644
--- a/translations/zh-CN/data/reusables/webhooks/delete_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/delete_short_desc.md
@@ -1 +1 @@
-A Git branch or tag is deleted. For more information, see the "[Git data](/v3/git/)" REST API.
\ No newline at end of file
+Git 分支或标签已删除。 更多信息请参阅“[Git 数据](/v3/git/)”REST API。
diff --git a/translations/zh-CN/data/reusables/webhooks/deploy_key_properties.md b/translations/zh-CN/data/reusables/webhooks/deploy_key_properties.md
index 9f07a1207742..a1782e632a1f 100644
--- a/translations/zh-CN/data/reusables/webhooks/deploy_key_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/deploy_key_properties.md
@@ -1,4 +1,4 @@
-| 键        | 类型    | 描述                                                             |
-| -------- | ----- | -------------------------------------------------------------- |
-| `action` | `字符串` | 执行的操作。 Can be either `created` or `deleted`.                   |
-| `键`      | `对象`  | The [`deploy key`](/v3/repos/keys/#get-a-deploy-key) resource. |
\ No newline at end of file
+| 键        | 类型    | 描述                                            |
+| -------- | ----- | --------------------------------------------- |
+| `action` | `字符串` | 执行的操作。 可以是 `created` 或 `deleted`。             |
+| `键`      | `对象`  | [`部署密钥`](/v3/repos/keys/#get-a-deploy-key)资源。 |
diff --git a/translations/zh-CN/data/reusables/webhooks/deploy_key_short_desc.md b/translations/zh-CN/data/reusables/webhooks/deploy_key_short_desc.md
index 551eef44c5cc..4f5643aad8d8 100644
--- a/translations/zh-CN/data/reusables/webhooks/deploy_key_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/deploy_key_short_desc.md
@@ -1 +1 @@
-A deploy key is added or removed from a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[Deploy keys](/v3/repos/keys/)" REST API.
\ No newline at end of file
+在仓库中添加或删除部署密钥。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[Deploy keys](/v3/repos/keys/)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/deployment_short_desc.md b/translations/zh-CN/data/reusables/webhooks/deployment_short_desc.md
index 75683350b9df..d4750f18f28c 100644
--- a/translations/zh-CN/data/reusables/webhooks/deployment_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/deployment_short_desc.md
@@ -1 +1 @@
-A deployment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[deployment](/v3/repos/deployments/#list-deployments)" REST API.
\ No newline at end of file
+已创建部署。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[deployment](/rest/reference/repos#list-deployments)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/deployment_status_short_desc.md b/translations/zh-CN/data/reusables/webhooks/deployment_status_short_desc.md
index 11953ea072e4..7d9050fa4f1c 100644
--- a/translations/zh-CN/data/reusables/webhooks/deployment_status_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/deployment_status_short_desc.md
@@ -1 +1 @@
-A deployment is created. {% data reusables.webhooks.action_type_desc %} For more information, see the "[deployment statuses](/v3/repos/deployments/#list-deployment-statuses)" REST API.
\ No newline at end of file
+已创建部署。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[deployment statuses](/rest/reference/repos#list-deployment-statuses)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/enterprise_short_desc.md b/translations/zh-CN/data/reusables/webhooks/enterprise_short_desc.md
index 999949bcbb50..83621ed89157 100644
--- a/translations/zh-CN/data/reusables/webhooks/enterprise_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/enterprise_short_desc.md
@@ -1 +1 @@
-A site or repository administrator enables or disables anonymous Git read access. See "[Allowing admins to enable anonymous Git read access to public repositories](/enterprise/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories)" for more details. This event is not available in the Events API.
\ No newline at end of file
+站点或仓库管理员启用或禁用匿名 Git 读取权限。 更多信息请参阅“[允许管理员启用对公共仓库的匿名 Git 读取权限](/enterprise/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories)”。 此事件在事件 API 中不可用。
diff --git a/translations/zh-CN/data/reusables/webhooks/events_api_payload.md b/translations/zh-CN/data/reusables/webhooks/events_api_payload.md
index b40c9904faf8..c77bcc1e22de 100644
--- a/translations/zh-CN/data/reusables/webhooks/events_api_payload.md
+++ b/translations/zh-CN/data/reusables/webhooks/events_api_payload.md
@@ -1 +1 @@
-The [event object](#event-object-common-properties) includes properties that are common for all events. Each event object includes a `payload` property and the value is unique to each event type. The `payload` object for this event is described below.
\ No newline at end of file
+[事件对象](#event-object-common-properties) 包含所有事件的通用属性。 每个事件对象都包含 `payload` 属性，并且该值对于每个事件类型而言都是唯一的。 此事件的 `payload` 对象如下所述。
diff --git a/translations/zh-CN/data/reusables/webhooks/fork_properties.md b/translations/zh-CN/data/reusables/webhooks/fork_properties.md
index 12651e46c77a..241e51cba6ff 100644
--- a/translations/zh-CN/data/reusables/webhooks/fork_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/fork_properties.md
@@ -1,3 +1,3 @@
-| 键        | 类型   | 描述                                                                |
-| -------- | ---- | ----------------------------------------------------------------- |
-| `forkee` | `对象` | The created [`repository`](/v3/repos/#get-a-repository) resource. |
\ No newline at end of file
+| 键        | 类型   | 描述                                                  |
+| -------- | ---- | --------------------------------------------------- |
+| `forkee` | `对象` | 创建的 [`repository`](/v3/repos/#get-a-repository) 资源。 |
diff --git a/translations/zh-CN/data/reusables/webhooks/fork_short_desc.md b/translations/zh-CN/data/reusables/webhooks/fork_short_desc.md
index a294851f9c96..821bc1028cda 100644
--- a/translations/zh-CN/data/reusables/webhooks/fork_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/fork_short_desc.md
@@ -1 +1 @@
-A user forks a repository. For more information, see the "[forks](/v3/repos/forks/)" REST API.
\ No newline at end of file
+用户复刻仓库。 更多信息请参阅“[复刻](/v3/repos/forks/)”REST API。
diff --git a/translations/zh-CN/data/reusables/webhooks/gollum_properties.md b/translations/zh-CN/data/reusables/webhooks/gollum_properties.md
index 303eec327eb4..53446f2ffddc 100644
--- a/translations/zh-CN/data/reusables/webhooks/gollum_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/gollum_properties.md
@@ -1,8 +1,8 @@
-| 键                    | 类型    | 描述                                                                       |
-| -------------------- | ----- | ------------------------------------------------------------------------ |
-| `页面`                 | `数组`  | The pages that were updated.                                             |
-| `pages[][page_name]` | `字符串` | The name of the page.                                                    |
-| `pages[][title]`     | `字符串` | The current page title.                                                  |
-| `pages[][action]`    | `字符串` | The action that was performed on the page. Can be `created` or `edited`. |
-| `pages[][sha]`       | `字符串` | The latest commit SHA of the page.                                       |
-| `pages[][html_url]`  | `字符串` | Points to the HTML wiki page.                                            |
\ No newline at end of file
+| 键                    | 类型    | 描述                                   |
+| -------------------- | ----- | ------------------------------------ |
+| `页面`                 | `数组`  | 已更新的页面。                              |
+| `pages[][page_name]` | `字符串` | 页面的名称。                               |
+| `pages[][title]`     | `字符串` | 当前页面标题。                              |
+| `pages[][action]`    | `字符串` | 在页面上执行的操作。 可以是 `created` 或 `edited`。 |
+| `pages[][sha]`       | `字符串` | 页面的最新提交 SHA。                         |
+| `pages[][html_url]`  | `字符串` | 指向 HTML wiki 页面。                     |
diff --git a/translations/zh-CN/data/reusables/webhooks/gollum_short_desc.md b/translations/zh-CN/data/reusables/webhooks/gollum_short_desc.md
index 88d8dacb57e5..7e901d73459f 100644
--- a/translations/zh-CN/data/reusables/webhooks/gollum_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/gollum_short_desc.md
@@ -1 +1 @@
-A wiki page is created or updated. For more information, see the "[About wikis](/github/building-a-strong-community/about-wikis)".
\ No newline at end of file
+创建或更新 wiki 页面。 更多信息请参阅“[关于 wikis](/github/building-a-strong-community/about-wikis)”。
diff --git a/translations/zh-CN/data/reusables/webhooks/installation_properties.md b/translations/zh-CN/data/reusables/webhooks/installation_properties.md
index 83e1b6184fc8..6e42ae0d296e 100644
--- a/translations/zh-CN/data/reusables/webhooks/installation_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/installation_properties.md
@@ -1,4 +1,4 @@
-| 键        | 类型    | 描述                                                               |
-| -------- | ----- | ---------------------------------------------------------------- |
-| `action` | `字符串` | 执行的操作内容. 可以是以下选项之一：
    • `created` - Someone installs a {% data variables.product.prodname_github_app %}.
    • `deleted` - Someone uninstalls a {% data variables.product.prodname_github_app %}
      • {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}
    • `suspend` - Someone suspends a {% data variables.product.prodname_github_app %} installation.
    • `unsuspend` - Someone unsuspends a {% data variables.product.prodname_github_app %} installation.
      • {% endif %}
    • `new_permissions_accepted` - Someone accepts new permissions for a {% data variables.product.prodname_github_app %} installation. When a {% data variables.product.prodname_github_app %} owner requests new permissions, the person who installed the {% data variables.product.prodname_github_app %} must accept the new permissions request. 
                         |
-| `仓库`     | `数组`  | An array of repository objects that the insatllation can access. |
\ No newline at end of file
+| 键        | 类型    | 描述                                           |
+| -------- | ----- | -------------------------------------------- |
+| `action` | `字符串` | 执行的操作内容. 可以是以下选项之一：
    • `created` - Someone installs a {% data variables.product.prodname_github_app %}.
    • `deleted` - Someone uninstalls a {% data variables.product.prodname_github_app %}
      • {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}
    • `suspend` - Someone suspends a {% data variables.product.prodname_github_app %} installation.
    • `unsuspend` - Someone unsuspends a {% data variables.product.prodname_github_app %} installation.
      • {% endif %}
    • `new_permissions_accepted` - Someone accepts new permissions for a {% data variables.product.prodname_github_app %} installation. When a {% data variables.product.prodname_github_app %} owner requests new permissions, the person who installed the {% data variables.product.prodname_github_app %} must accept the new permissions request. 
     |
+| `仓库`     | `数组`  | 安装设施可访问的仓库对象数组。                              |
diff --git a/translations/zh-CN/data/reusables/webhooks/installation_repositories_properties.md b/translations/zh-CN/data/reusables/webhooks/installation_repositories_properties.md
index ad7862c6fbe0..b35a06ed9144 100644
--- a/translations/zh-CN/data/reusables/webhooks/installation_repositories_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/installation_repositories_properties.md
@@ -1,6 +1,6 @@
-| 键                      | 类型    | 描述                                                                                    |
-| ---------------------- | ----- | ------------------------------------------------------------------------------------- |
-| `action`               | `字符串` | 执行的操作内容. Can be either `added` or `removed`.                                          |
-| `repository_selection` | `字符串` | The choice of repositories the installation is on. Can be either `selected` or `all`. |
-| `repositories_added`   | `数组`  | An array of repository objects, which were added to the installation.                 |
-| `repositories_removed` | `数组`  | An array of repository objects, which were removed from the installation.             |
\ No newline at end of file
+| 键                      | 类型    | 描述                                 |
+| ---------------------- | ----- | ---------------------------------- |
+| `action`               | `字符串` | 执行的操作内容. 可以是 `added` 或 `removed`。  |
+| `repository_selection` | `字符串` | 安装所在仓库的选择。 可以是 `selected` 或 `all`。 |
+| `repositories_added`   | `数组`  | 已添加到安装中的仓库对象数组。                    |
+| `repositories_removed` | `数组`  | 已从安装中删除的仓库对象数组。                    |
diff --git a/translations/zh-CN/data/reusables/webhooks/installation_repositories_short_desc.md b/translations/zh-CN/data/reusables/webhooks/installation_repositories_short_desc.md
index b01eeca22efe..344b5912a8e5 100644
--- a/translations/zh-CN/data/reusables/webhooks/installation_repositories_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/installation_repositories_short_desc.md
@@ -1 +1 @@
-Activity related to repositories being added to a GitHub App installation. {% data reusables.webhooks.action_type_desc %} For more information, see the "[GitHub App installation](/v3/apps/)" REST API.
\ No newline at end of file
+与要添加到 GitHub 应用程序安装中的仓库相关的活动。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[GitHub App installation](/v3/apps/)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/installation_short_desc.md b/translations/zh-CN/data/reusables/webhooks/installation_short_desc.md
index 0a19aef9b5d0..7756cf9ad534 100644
--- a/translations/zh-CN/data/reusables/webhooks/installation_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/installation_short_desc.md
@@ -1 +1 @@
-Activity related to a GitHub App installation. {% data reusables.webhooks.action_type_desc %} For more information, see the "[GitHub App installation](/v3/apps/)" REST API.
\ No newline at end of file
+与 GitHub 应用程序安装相关的活动。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[GitHub App installation](/v3/apps/)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/issue_comment_properties.md b/translations/zh-CN/data/reusables/webhooks/issue_comment_properties.md
index 1cc3962f11bf..7e2bdb5a6e63 100644
--- a/translations/zh-CN/data/reusables/webhooks/issue_comment_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/issue_comment_properties.md
@@ -1 +1 @@
-`changes`|`object` | The changes to the comment if the action was `edited`. `changes[body][from]` |`string` | The previous version of the body if the action was `edited`. `issue`|`object` | The [issue](/v3/issues/) the comment belongs to. `comment`|`object` | The [comment](/v3/issues/comments/) itself.
\ No newline at end of file
+`changes`|`object` | 对评论的更改，如果操作为 `edited`。 `changes[body][from]` |`string` | 正文的前版本，如果操作为 `edited`。 `issue`|`object` | 评论所属的[议题](/v3/issues/)。 `comment`|`object` | [评论](/v3/issues/comments/)本身。
diff --git a/translations/zh-CN/data/reusables/webhooks/issue_comment_short_desc.md b/translations/zh-CN/data/reusables/webhooks/issue_comment_short_desc.md
index 0c12ec707b62..d63778fcea8b 100644
--- a/translations/zh-CN/data/reusables/webhooks/issue_comment_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/issue_comment_short_desc.md
@@ -1 +1 @@
-Activity related to an issue comment. {% data reusables.webhooks.action_type_desc %} For more information, see the "[issue comments](/v3/issues/comments/)" REST API.
\ No newline at end of file
+与议题评论相关的活动。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[issue comments](/v3/issues/comments/)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/issue_comment_webhook_properties.md b/translations/zh-CN/data/reusables/webhooks/issue_comment_webhook_properties.md
index c5fdc0b80575..53ec3dac0032 100644
--- a/translations/zh-CN/data/reusables/webhooks/issue_comment_webhook_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/issue_comment_webhook_properties.md
@@ -1,3 +1,3 @@
-| 键        | 类型    | 描述                                                                                             |
-| -------- | ----- | ---------------------------------------------------------------------------------------------- |
-| `action` | `字符串` | The action that was performed on the comment. Can be one of `created`, `edited`, or `deleted`. |
\ No newline at end of file
+| 键        | 类型    | 描述                                                 |
+| -------- | ----- | -------------------------------------------------- |
+| `action` | `字符串` | 在评论上执行的操作。 可以以下项之一：`created`、`edited` 或 `deleted`。 |
diff --git a/translations/zh-CN/data/reusables/webhooks/issue_event_api_properties.md b/translations/zh-CN/data/reusables/webhooks/issue_event_api_properties.md
index 39220afd30de..c7a7e25e407e 100644
--- a/translations/zh-CN/data/reusables/webhooks/issue_event_api_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/issue_event_api_properties.md
@@ -1,3 +1,3 @@
-| 键        | 类型    | 描述                                                                                                          |
-| -------- | ----- | ----------------------------------------------------------------------------------------------------------- |
-| `action` | `字符串` | 执行的操作内容. Can be one of `opened`, `closed`, `reopened`, `assigned`, `unassigned`, `labeled`, or `unlabeled`. |
\ No newline at end of file
+| 键        | 类型    | 描述                                                                                              |
+| -------- | ----- | ----------------------------------------------------------------------------------------------- |
+| `action` | `字符串` | 执行的操作内容. 可以是以下项之一：`opened`、`closed`、`reopened`、`assigned`、`unassigned`、`labeled` 或 `unlabeled`。 |
diff --git a/translations/zh-CN/data/reusables/webhooks/issue_properties.md b/translations/zh-CN/data/reusables/webhooks/issue_properties.md
index 84db05eb2bfe..482264aeb841 100644
--- a/translations/zh-CN/data/reusables/webhooks/issue_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/issue_properties.md
@@ -1 +1 @@
-`issue`|`object` | The [issue](/v3/issues) itself. `changes`|`object`| The changes to the issue if the action was `edited`. `changes[title][from]`|`string` | The previous version of the title if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `assignee`|`object` | The optional user who was assigned or unassigned from the issue. `label`|`object` | The optional label that was added or removed from the issue.
\ No newline at end of file
+`issue`|`object` | [议题](/v3/issues)本身。 `changes`|`object` | 对议题的更改，如果操作为 `edited`。 `changes[title][from]` |`string` | 标题的前版本，如果操作为 `edited`。 `changes[body][from]`|`string` | 正文的前版本，如果操作为 `edited`。 `assignee`|`object` | 为此议题分配或取消分配的可选用户。 `label`|`object` | 为此议题添加或删除的可选标签。
diff --git a/translations/zh-CN/data/reusables/webhooks/issue_webhook_properties.md b/translations/zh-CN/data/reusables/webhooks/issue_webhook_properties.md
index df95dbe422ae..ce4c62c94a96 100644
--- a/translations/zh-CN/data/reusables/webhooks/issue_webhook_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/issue_webhook_properties.md
@@ -1,3 +1,3 @@
-| 键        | 类型    | 描述                                                                                                                                                                                                                         |
-| -------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `action` | `字符串` | 执行的操作内容. Can be one of `opened`, `edited`, `deleted`, `pinned`, `unpinned`, `closed`, `reopened`, `assigned`, `unassigned`, `labeled`, `unlabeled`, `locked`, `unlocked`,  `transferred`, `milestoned`, or `demilestoned`. |
\ No newline at end of file
+| 键        | 类型    | 描述                                                                                                                                                                                                   |
+| -------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `action` | `字符串` | 执行的操作内容. 可以是以下项之一：`opened`、`edited`、`deleted`、`pinned`、`unpinned`、`closed`、`reopened`、`assigned`、`unassigned`、`labeled`、`unlabeled`、`locked`、`unlocked`、`transferred`、`milestoned` 或 `demilestoned`。 |
diff --git a/translations/zh-CN/data/reusables/webhooks/issues_short_desc.md b/translations/zh-CN/data/reusables/webhooks/issues_short_desc.md
index fea9fc0cfcd8..125c51c8f2b0 100644
--- a/translations/zh-CN/data/reusables/webhooks/issues_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/issues_short_desc.md
@@ -1 +1 @@
-Activity related to an issue. {% data reusables.webhooks.action_type_desc %} For more information, see the "[issues](/v3/issues/comments/)" REST API.
\ No newline at end of file
+与议题相关的活动。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[issues](/v3/issues/comments/)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/label_short_desc.md b/translations/zh-CN/data/reusables/webhooks/label_short_desc.md
index ca095139a6d2..1e8c03f2961a 100644
--- a/translations/zh-CN/data/reusables/webhooks/label_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/label_short_desc.md
@@ -1 +1 @@
-Activity related to an issue. {% data reusables.webhooks.action_type_desc %} For more information, see the "[labels](/v3/issues/labels/)" REST API.
\ No newline at end of file
+与议题相关的活动。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[labels](/v3/issues/labels/)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/member_event_api_properties.md b/translations/zh-CN/data/reusables/webhooks/member_event_api_properties.md
index ba65b9dfcdcd..c1b1d3392ed8 100644
--- a/translations/zh-CN/data/reusables/webhooks/member_event_api_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/member_event_api_properties.md
@@ -1,3 +1,3 @@
-| 键        | 类型    | 描述                                                                                 |
-| -------- | ----- | ---------------------------------------------------------------------------------- |
-| `action` | `字符串` | 执行的操作内容. Can be `added` to indicate a user accepted an invitation to a repository. |
\ No newline at end of file
+| 键        | 类型    | 描述                                    |
+| -------- | ----- | ------------------------------------- |
+| `action` | `字符串` | 执行的操作内容. 可以是 `added` 以指示用户接受了加入仓库的邀请。 |
diff --git a/translations/zh-CN/data/reusables/webhooks/member_properties.md b/translations/zh-CN/data/reusables/webhooks/member_properties.md
index 7fde9d65f4b7..bfd42110f5a9 100644
--- a/translations/zh-CN/data/reusables/webhooks/member_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/member_properties.md
@@ -1 +1 @@
-`member`|`object` | The [user](/v3/users/) that was added. `changes`|`object`| The changes to the collaborator permissions if the action was `edited`. `changes[old_permission][from]`|`string` | The previous permissions of the collaborator if the action was `edited`.
\ No newline at end of file
+`member`|`object` | 已添加的[用户](/v3/users/)。 `changes`|`object`| 对协作者权限的更改，如果操作为 `edited`。 `changes[old_permission][from]`|`string` | 协作者以前的权限，如果操作为 `edited`。
diff --git a/translations/zh-CN/data/reusables/webhooks/member_short_desc.md b/translations/zh-CN/data/reusables/webhooks/member_short_desc.md
index 9447f245ed0a..18c9f1497650 100644
--- a/translations/zh-CN/data/reusables/webhooks/member_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/member_short_desc.md
@@ -1 +1 @@
-Activity related to repository collaborators. {% data reusables.webhooks.action_type_desc %} For more information, see the "[collaborators](/v3/repos/collaborators/)" REST API.
\ No newline at end of file
+与仓库协作者相关的活动。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[collaborators](/v3/repos/collaborators/)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/member_webhook_properties.md b/translations/zh-CN/data/reusables/webhooks/member_webhook_properties.md
index 222382531966..b62bed51736e 100644
--- a/translations/zh-CN/data/reusables/webhooks/member_webhook_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/member_webhook_properties.md
@@ -1,3 +1,3 @@
 | 键        | 类型    | 描述                                           |
 | -------- | ----- | -------------------------------------------- |
-| `action` | `字符串` | 执行的操作内容. 可以是以下选项之一：
    •  `added` - A user accepts an invitation to a repository.
    • `removed` - A user is removed as a collaborator in a repository.
    • `edited` - A user's collaborator permissios have changed. 
     |
\ No newline at end of file
+| `action` | `字符串` | 执行的操作内容. 可以是以下选项之一：
    •  `added` - 用户接受加入仓库的邀请。
    • `removed` - 用户被删除仓库协作者角色。
    • `edited` - 用户的协作者权限已更改。 
     |
diff --git a/translations/zh-CN/data/reusables/webhooks/membership_properties.md b/translations/zh-CN/data/reusables/webhooks/membership_properties.md
index d80e953a3913..7e8543da2d71 100644
--- a/translations/zh-CN/data/reusables/webhooks/membership_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/membership_properties.md
@@ -1,6 +1,6 @@
-| 键        | 类型    | 描述                                                          |
-| -------- | ----- | ----------------------------------------------------------- |
-| `action` | `字符串` | 执行的操作内容. Can be `added` or `removed`.                       |
-| `作用域`    | `字符串` | The scope of the membership. Currently, can only be `team`. |
-| `成员`     | `对象`  | The [user](/v3/users/) that was added or removed.           |
-| `团队`     | `对象`  | The [team](/v3/teams/) for the membership.                  |
\ No newline at end of file
+| 键        | 类型    | 描述                                |
+| -------- | ----- | --------------------------------- |
+| `action` | `字符串` | 执行的操作内容. 可以是 `added` 或 `removed`。 |
+| `作用域`    | `字符串` | 成员的作用域。 目前只能是 `team`。             |
+| `成员`     | `对象`  | 已添加或删除的[用户](/v3/users/)。          |
+| `团队`     | `对象`  | 成员的[团队](/v3/teams/)。              |
diff --git a/translations/zh-CN/data/reusables/webhooks/membership_short_desc.md b/translations/zh-CN/data/reusables/webhooks/membership_short_desc.md
index 4ffa7e0d72c0..8a5040f79976 100644
--- a/translations/zh-CN/data/reusables/webhooks/membership_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/membership_short_desc.md
@@ -1 +1 @@
-Activity related to team membership. {% data reusables.webhooks.action_type_desc %} For more information, see the "[team members](/v3/teams/members/)" REST API.
\ No newline at end of file
+与团队成员相关的活动。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[team members](/v3/teams/members/)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/milestone_properties.md b/translations/zh-CN/data/reusables/webhooks/milestone_properties.md
index c5a0c6cb5c8e..867b38230462 100644
--- a/translations/zh-CN/data/reusables/webhooks/milestone_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/milestone_properties.md
@@ -1,8 +1,8 @@
-| 键                            | 类型    | 描述                                                                            |
-| ---------------------------- | ----- | ----------------------------------------------------------------------------- |
-| `action`                     | `字符串` | 执行的操作内容. Can be one of `created`, `closed`, `opened`, `edited`, or `deleted`. |
-| `里程碑`                        | `对象`  | The milestone itself.                                                         |
-| `changes`                    | `对象`  | The changes to the milestone if the action was `edited`.                      |
-| `changes[description][from]` | `字符串` | 说明的先前版本（如果操作为 `edited`）。                                                      |
-| `changes[due_on][from]`      | `字符串` | The previous version of the due date if the action was `edited`.              |
-| `changes[title][from]`       | `字符串` | The previous version of the title if the action was `edited`.                 |
\ No newline at end of file
+| 键                            | 类型    | 描述                                                                  |
+| ---------------------------- | ----- | ------------------------------------------------------------------- |
+| `action`                     | `字符串` | 执行的操作内容. 可以是以下项之一：`created`、`closed`、`opened`、`edited` 或 `deleted`。 |
+| `里程碑`                        | `对象`  | 里程碑本身。                                                              |
+| `changes`                    | `对象`  | 对里程碑的更改，如果操作为 `edited`。                                             |
+| `changes[description][from]` | `字符串` | 说明的先前版本（如果操作为 `edited`）。                                            |
+| `changes[due_on][from]`      | `字符串` | 到期日期的先前版本，如果操作为 `edited`。                                           |
+| `changes[title][from]`       | `字符串` | 标题的先前版本，如果操作为 `edited`。                                             |
diff --git a/translations/zh-CN/data/reusables/webhooks/milestone_short_desc.md b/translations/zh-CN/data/reusables/webhooks/milestone_short_desc.md
index 0e6f857a512a..98ae81054420 100644
--- a/translations/zh-CN/data/reusables/webhooks/milestone_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/milestone_short_desc.md
@@ -1 +1 @@
-Activity related to milestones. {% data reusables.webhooks.action_type_desc %} For more information, see the "[milestones](/v3/issues/milestones/)" REST API.
\ No newline at end of file
+与里程碑相关的活动。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[milestones](/v3/issues/milestones/)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/org_block_short_desc.md b/translations/zh-CN/data/reusables/webhooks/org_block_short_desc.md
index 94e63acfee08..c7a86e57c415 100644
--- a/translations/zh-CN/data/reusables/webhooks/org_block_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/org_block_short_desc.md
@@ -1 +1 @@
-Activity related to people being blocked in an organization. {% data reusables.webhooks.action_type_desc %} 更多信息请参阅“[阻止组织用户](/v3/orgs/blocking/)”REST API。
\ No newline at end of file
+与组织中被阻止人员相关的活动。 {% data reusables.webhooks.action_type_desc %} 更多信息请参阅“[阻止组织用户](/v3/orgs/blocking/)”REST API。
diff --git a/translations/zh-CN/data/reusables/webhooks/org_desc.md b/translations/zh-CN/data/reusables/webhooks/org_desc.md
index e763e6d6b614..67dae9765699 100644
--- a/translations/zh-CN/data/reusables/webhooks/org_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/org_desc.md
@@ -1 +1 @@
-`organization` | `object` | Webhook payloads contain the [`organization`](/v3/orgs/#get-an-organization) object when the webhook is configured for an organization or the event occurs from activity in a repository owned by an organization.
\ No newline at end of file
+`organization` | `object` | 当为组织配置了 web 挂钩或事件是由于组织所拥有仓库中的活动而发生时，web 挂钩有效负载包含 [`organization`](/v3/orgs/#get-an-organization) 对象。
diff --git a/translations/zh-CN/data/reusables/webhooks/organization_short_desc.md b/translations/zh-CN/data/reusables/webhooks/organization_short_desc.md
index 131d20fc3de8..e72a98c181bd 100644
--- a/translations/zh-CN/data/reusables/webhooks/organization_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/organization_short_desc.md
@@ -1 +1 @@
-Activity related to an organization and its members. {% data reusables.webhooks.action_type_desc %} For more information, see the "[organizations](/v3/orgs/)" REST API.
\ No newline at end of file
+与组织及其成员相关的活动。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[organizations](/v3/orgs/)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/package_properties.md b/translations/zh-CN/data/reusables/webhooks/package_properties.md
index db62fb68a9c6..4d508da0df39 100644
--- a/translations/zh-CN/data/reusables/webhooks/package_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/package_properties.md
@@ -1,4 +1,4 @@
-| 键         | 类型    | 描述                                        |
-| --------- | ----- | ----------------------------------------- |
-| `action`  | `字符串` | 执行的操作内容. Can be `published` or `updated`. |
-| `package` | `对象`  | Information about the package.            |
\ No newline at end of file
+| 键         | 类型    | 描述                                    |
+| --------- | ----- | ------------------------------------- |
+| `action`  | `字符串` | 执行的操作内容. 可以是 `published` 或 `updated`。 |
+| `package` | `对象`  | 关于包的信息。                               |
diff --git a/translations/zh-CN/data/reusables/webhooks/page_build_short_desc.md b/translations/zh-CN/data/reusables/webhooks/page_build_short_desc.md
index 7c5be712c388..dda5755d8870 100644
--- a/translations/zh-CN/data/reusables/webhooks/page_build_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/page_build_short_desc.md
@@ -1 +1 @@
-Represents an attempted build of a GitHub Pages site, whether successful or not. A push to a GitHub Pages enabled branch (`gh-pages` for project pages, `master` for user and organization pages) triggers this event.
\ No newline at end of file
+Represents an attempted build of a {% data variables.product.prodname_pages %} site, whether successful or not. A push to a {% data variables.product.prodname_pages %} enabled branch (`gh-pages` for project pages, the default branch for user and organization pages) triggers this event.
diff --git a/translations/zh-CN/data/reusables/webhooks/payload_url.md b/translations/zh-CN/data/reusables/webhooks/payload_url.md
index 3a3fde655ce3..15f30fb0121d 100644
--- a/translations/zh-CN/data/reusables/webhooks/payload_url.md
+++ b/translations/zh-CN/data/reusables/webhooks/payload_url.md
@@ -1 +1 @@
-The payload URL is the URL of the server that will receive the webhook `POST` requests.
\ No newline at end of file
+有效负载 URL 是接收 web 挂钩 `POST` 请求的服务器的 URL。
diff --git a/translations/zh-CN/data/reusables/webhooks/ping_short_desc.md b/translations/zh-CN/data/reusables/webhooks/ping_short_desc.md
index 8cdd735b78c5..fd0035ed1615 100644
--- a/translations/zh-CN/data/reusables/webhooks/ping_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/ping_short_desc.md
@@ -1 +1 @@
-When you create a new webhook, we'll send you a simple `ping` event to let you know you've set up the webhook correctly. This event isnt stored so it isn't retrievable via the [Events API](/v3/activity/events/). You can trigger a `ping` again by calling the [Ping a repository webhook](/v3/repos/hooks/#ping-a-repository-webhook) endpoint.
+当您创建新的 web 挂钩时，我们将向您发送一个简单的 `ping` 事件，让您知道您已正确设置 web 挂钩。 This event isnt stored so it isn't retrievable via the [Events API](/rest/reference/activity#ping-a-repository-webhook) endpoint.
diff --git a/translations/zh-CN/data/reusables/webhooks/project_card_properties.md b/translations/zh-CN/data/reusables/webhooks/project_card_properties.md
index 857fb23143cd..e06df58160d4 100644
--- a/translations/zh-CN/data/reusables/webhooks/project_card_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/project_card_properties.md
@@ -1,7 +1,7 @@
-| 键                     | 类型    | 描述                                                                                                                           |
-| --------------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------- |
-| `action`              | `字符串` | The action performed on the project card. Can be `created`, `edited`, `moved`, `converted`, or `deleted`.                    |
-| `changes`             | `对象`  | The changes to the project card if the action was `edited` or `converted`.                                                   |
-| `changes[note][from]` | `字符串` | The previous version of the note if the action was `edited` or `converted`.                                                  |
-| `after_id`            | `整数`  | The id of the card that this card now follows if the action was "moved". Will be `null` if it is the first card in a column. |
-| `project_card`        | `对象`  | The [project card](/v3/projects/cards) itself.                                                                               |
\ No newline at end of file
+| 键                     | 类型    | 描述                                                                  |
+| --------------------- | ----- | ------------------------------------------------------------------- |
+| `action`              | `字符串` | 在项目卡上执行的操作。 可以是 `created`、`edited`、`moved`、`converted` 或 `deleted`。 |
+| `changes`             | `对象`  | 对项目卡的更改，如果操作为 `edited` 或 `converted`。                               |
+| `changes[note][from]` | `字符串` | 备注的先前版本，如果操作为 `edited` 或 `converted`。                               |
+| `after_id`            | `整数`  | 此卡现在所遵循的卡的 ID，如果操作为 "moved"。 将为 `null`，如果它是列中的第一张卡。                 |
+| `project_card`        | `对象`  | [项目卡](/v3/projects/cards)本身。                                        |
diff --git a/translations/zh-CN/data/reusables/webhooks/project_card_short_desc.md b/translations/zh-CN/data/reusables/webhooks/project_card_short_desc.md
index 3a474c89ecee..3756b20446ba 100644
--- a/translations/zh-CN/data/reusables/webhooks/project_card_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/project_card_short_desc.md
@@ -1 +1 @@
-Activity related to project cards. {% data reusables.webhooks.action_type_desc %} For more information, see the "[project cards](/v3/projects/cards)" REST API.
\ No newline at end of file
+与项目卡有关的活动。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[project cards](/v3/projects/cards)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/project_column_properties.md b/translations/zh-CN/data/reusables/webhooks/project_column_properties.md
index d29dd2ca77d1..dc28a204995b 100644
--- a/translations/zh-CN/data/reusables/webhooks/project_column_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/project_column_properties.md
@@ -1,7 +1,7 @@
-| 键                     | 类型    | 描述                                                                                                                                  |
-| --------------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------- |
-| `action`              | `字符串` | The action that was performed on the project column. Can be one of `created`, `edited`, `moved` or `deleted`.                       |
-| `changes`             | `对象`  | The changes to the project column if the action was `edited`.                                                                       |
-| `changes[name][from]` | `字符串` | 名称的先前版本（如果操作为 `edited`）。                                                                                                            |
-| `after_id`            | `整数`  | The id of the column that this column now follows if the action was "moved". Will be `null` if it is the first column in a project. |
-| `project_column`      | `对象`  | The [project column](/v3/projects/columns) itself.                                                                                  |
\ No newline at end of file
+| 键                     | 类型    | 描述                                                          |
+| --------------------- | ----- | ----------------------------------------------------------- |
+| `action`              | `字符串` | 在项目列上执行的操作。 可以以下项之一：`created`、`edited`、`moved` 或 `deleted`。 |
+| `changes`             | `对象`  | 对项目列的更改，如果操作为 `edited`。                                     |
+| `changes[name][from]` | `字符串` | 名称的先前版本（如果操作为 `edited`）。                                    |
+| `after_id`            | `整数`  | 此列现在所遵循的列的 ID，如果操作为 "moved"。 将为 `null`，如果它是项目中的第一列。         |
+| `project_column`      | `对象`  | [项目列](/v3/projects/columns)本身。                              |
diff --git a/translations/zh-CN/data/reusables/webhooks/project_column_short_desc.md b/translations/zh-CN/data/reusables/webhooks/project_column_short_desc.md
index 31cc257267b0..1cd8eb4a8c76 100644
--- a/translations/zh-CN/data/reusables/webhooks/project_column_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/project_column_short_desc.md
@@ -1 +1 @@
-Activity related to columns in a project board. {% data reusables.webhooks.action_type_desc %} For more information, see the "[project columns](/v3/projects/columns)" REST API.
\ No newline at end of file
+与项目板中的列相关的活动。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[project columns](/v3/projects/columns)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/project_properties.md b/translations/zh-CN/data/reusables/webhooks/project_properties.md
index dde32170996c..f9356360e813 100644
--- a/translations/zh-CN/data/reusables/webhooks/project_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/project_properties.md
@@ -1,7 +1,7 @@
-| 键                     | 类型    | 描述                                                                                                                   |
-| --------------------- | ----- | -------------------------------------------------------------------------------------------------------------------- |
-| `action`              | `字符串` | The action that was performed on the project. Can be one of `created`, `edited`, `closed`, `reopened`, or `deleted`. |
-| `changes`             | `对象`  | The changes to the project if the action was `edited`.                                                               |
-| `changes[name][from]` | `字符串` | 名称的先前版本（如果操作为 `edited`）。                                                                                             |
-| `changes[body][from]` | `字符串` | The previous version of the body if the action was `edited`.                                                         |
-| `project`             | `对象`  | The [project](/v3/projects/) itself.                                                                                 |
\ No newline at end of file
+| 键                     | 类型    | 描述                                                                      |
+| --------------------- | ----- | ----------------------------------------------------------------------- |
+| `action`              | `字符串` | 在项目上执行的操作。 可以是以下项之一：`created`、`edited`、`closed`、`reopened` 或 `deleted`。 |
+| `changes`             | `对象`  | 对项目的更改，如果操作为 `edited`。                                                  |
+| `changes[name][from]` | `字符串` | 名称的先前版本（如果操作为 `edited`）。                                                |
+| `changes[body][from]` | `字符串` | 正文的先前版本，如果操作为 `edited`。                                                 |
+| `project`             | `对象`  | [项目](/v3/projects/)本身。                                                  |
diff --git a/translations/zh-CN/data/reusables/webhooks/project_short_desc.md b/translations/zh-CN/data/reusables/webhooks/project_short_desc.md
index c5f8a804a47c..ed8c42efbd1c 100644
--- a/translations/zh-CN/data/reusables/webhooks/project_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/project_short_desc.md
@@ -1 +1 @@
-Activity related to project boards. {% data reusables.webhooks.action_type_desc %} For more information, see the "[projects](/v3/projects)" REST API.
\ No newline at end of file
+与项目板有关的活动。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[projects](/v3/projects)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/public_short_desc.md b/translations/zh-CN/data/reusables/webhooks/public_short_desc.md
index 925a4bfeddc5..b0cd43db69da 100644
--- a/translations/zh-CN/data/reusables/webhooks/public_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/public_short_desc.md
@@ -1 +1 @@
-When a private repository is made public.  Without a doubt: the best {% data variables.product.product_name %} event. 
\ No newline at end of file
+当私有仓库公开时。  Without a doubt: the best {% data variables.product.product_name %} event. 
diff --git a/translations/zh-CN/data/reusables/webhooks/pull_request_event_api_properties.md b/translations/zh-CN/data/reusables/webhooks/pull_request_event_api_properties.md
index 7d7f86909af2..f3f40036fc5f 100644
--- a/translations/zh-CN/data/reusables/webhooks/pull_request_event_api_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/pull_request_event_api_properties.md
@@ -1,3 +1,3 @@
-| 键        | 类型    | 描述                                                                                                                                                                        |
-| -------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `action` | `字符串` | 执行的操作内容. Can be one of `opened`, `closed`, `reopened`, `assigned`, `unassigned`, `review_requested`, `review_request_removed`, `labeled`, `unlabeled`, and `synchronize`. |
\ No newline at end of file
+| 键        | 类型    | 描述                                                                                                                                                        |
+| -------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `action` | `字符串` | 执行的操作内容. 可以是以下项之一：`opened`、`closed`、`reopened`、`assigned`、`unassigned`、`review_requested`、`review_request_removed`、`labeled`、`unlabeled` 和 `synchronize`。 |
diff --git a/translations/zh-CN/data/reusables/webhooks/pull_request_properties.md b/translations/zh-CN/data/reusables/webhooks/pull_request_properties.md
index b2619258bb68..d54fdab1610c 100644
--- a/translations/zh-CN/data/reusables/webhooks/pull_request_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/pull_request_properties.md
@@ -1 +1 @@
-`number`|`integer` | The pull request number. `changes`|`object`| The changes to the comment if the action was `edited`. `changes[title][from]`|`string` | The previous version of the title if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `pull_request`|`object` | The [pull request](/v3/pulls) itself.
\ No newline at end of file
+`number`|`integer` | 拉取请求编号。 `changes`|`object`| 对评论的更改，如果操作为 `edited`。 `changes[title][from]` |`string` | 标题的前版本，如果操作为 `edited`。 `changes[body][from]`|`string` | 正文的前版本，如果操作为 `edited`。 `pull_request`|`object` | [拉取请求](/v3/pulls)本身。
diff --git a/translations/zh-CN/data/reusables/webhooks/pull_request_review_comment_event_api_properties.md b/translations/zh-CN/data/reusables/webhooks/pull_request_review_comment_event_api_properties.md
index df325cbbf12b..6920005eb2e7 100644
--- a/translations/zh-CN/data/reusables/webhooks/pull_request_review_comment_event_api_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/pull_request_review_comment_event_api_properties.md
@@ -1,3 +1,3 @@
-| 键        | 类型    | 描述                                                           |
-| -------- | ----- | ------------------------------------------------------------ |
-| `action` | `字符串` | The action that was performed on the comment. 可以是 `created`。 |
\ No newline at end of file
+| 键        | 类型    | 描述                        |
+| -------- | ----- | ------------------------- |
+| `action` | `字符串` | 在评论上执行的操作。 可以是 `created`。 |
diff --git a/translations/zh-CN/data/reusables/webhooks/pull_request_review_comment_properties.md b/translations/zh-CN/data/reusables/webhooks/pull_request_review_comment_properties.md
index 85341dd38525..e0323d5dd2bc 100644
--- a/translations/zh-CN/data/reusables/webhooks/pull_request_review_comment_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/pull_request_review_comment_properties.md
@@ -1 +1 @@
-`changes`|`object`| The changes to the comment if the action was `edited`. `changes[body][from]`|`string` | The previous version of the body if the action was `edited`. `pull_request`|`object` | The [pull request](/v3/pulls/) the comment belongs to. `comment`|`object` | The [comment](/v3/pulls/comments) itself.
\ No newline at end of file
+`changes`|`object`| 对评论的更改，如果操作为 `edited`。 `changes[body][from]`|`string` | 正文的前版本，如果操作为 `edited`。 `pull_request`|`object` | 评论所属的[拉取请求](/v3/pulls/)。 `comment`|`object` | [评论](/v3/pulls/comments)本身。
diff --git a/translations/zh-CN/data/reusables/webhooks/pull_request_review_comment_short_desc.md b/translations/zh-CN/data/reusables/webhooks/pull_request_review_comment_short_desc.md
index 0dbf1f6974da..61efba973710 100644
--- a/translations/zh-CN/data/reusables/webhooks/pull_request_review_comment_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/pull_request_review_comment_short_desc.md
@@ -1 +1 @@
-Activity related to pull request review comments in the pull request's unified diff. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull request review comments](/v3/pulls/comments/)" REST API.
\ No newline at end of file
+与拉取请求统一差异中的拉取请求审查评论相关的活动。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull request review comments](/v3/pulls/comments/)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/pull_request_review_comment_webhook_properties.md b/translations/zh-CN/data/reusables/webhooks/pull_request_review_comment_webhook_properties.md
index c5fdc0b80575..53ec3dac0032 100644
--- a/translations/zh-CN/data/reusables/webhooks/pull_request_review_comment_webhook_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/pull_request_review_comment_webhook_properties.md
@@ -1,3 +1,3 @@
-| 键        | 类型    | 描述                                                                                             |
-| -------- | ----- | ---------------------------------------------------------------------------------------------- |
-| `action` | `字符串` | The action that was performed on the comment. Can be one of `created`, `edited`, or `deleted`. |
\ No newline at end of file
+| 键        | 类型    | 描述                                                 |
+| -------- | ----- | -------------------------------------------------- |
+| `action` | `字符串` | 在评论上执行的操作。 可以以下项之一：`created`、`edited` 或 `deleted`。 |
diff --git a/translations/zh-CN/data/reusables/webhooks/pull_request_review_properties.md b/translations/zh-CN/data/reusables/webhooks/pull_request_review_properties.md
index 12efe50a3776..827a057767ca 100644
--- a/translations/zh-CN/data/reusables/webhooks/pull_request_review_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/pull_request_review_properties.md
@@ -1,6 +1,6 @@
-| 键                     | 类型    | 描述                                                           |
-| --------------------- | ----- | ------------------------------------------------------------ |
-| `action`              | `字符串` | 执行的操作内容. 可以是以下选项之一：
    • `submitted` - A pull request review is submitted into a non-pending state.
    • `edited` - The body of a review has been edited.
    • `dismissed` - A review has been dismissed.
                     |
-| `pull_request`        | `对象`  | The [pull request](/v3/pulls/) the review pertains to.       |
-| `审查`                  | `对象`  | The review that was affected.                                |
-| `changes[body][from]` | `字符串` | The previous version of the body if the action was `edited`. |
\ No newline at end of file
+| 键                     | 类型    | 描述                                           |
+| --------------------- | ----- | -------------------------------------------- |
+| `action`              | `字符串` | 执行的操作内容. 可以是以下选项之一：
    • `submitted` - 拉取请求审查被提交为非挂起状态。
    • `edited` - 审查的正文被编辑。
    • `dismissed` - 审查被驳回。
     |
+| `pull_request`        | `对象`  | 与审查相关的[拉取请求](/v3/pulls/)。                    |
+| `审查`                  | `对象`  | 受影响的审查。                                      |
+| `changes[body][from]` | `字符串` | 正文的先前版本，如果操作为 `edited`。                      |
diff --git a/translations/zh-CN/data/reusables/webhooks/pull_request_review_short_desc.md b/translations/zh-CN/data/reusables/webhooks/pull_request_review_short_desc.md
index a92f0dd3bb24..0005fe12d00c 100644
--- a/translations/zh-CN/data/reusables/webhooks/pull_request_review_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/pull_request_review_short_desc.md
@@ -1 +1 @@
-Activity related to pull request reviews. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull request reviews](/v3/pulls/reviews/)" REST API.
\ No newline at end of file
+与拉取请求审查相关的活动。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull request reviews](/v3/pulls/reviews/)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/pull_request_short_desc.md b/translations/zh-CN/data/reusables/webhooks/pull_request_short_desc.md
index c88a5120c8f4..3fc964ab8a40 100644
--- a/translations/zh-CN/data/reusables/webhooks/pull_request_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/pull_request_short_desc.md
@@ -1 +1 @@
-Activity related to pull requests. {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull requests](/v3/pulls/)" REST API.
\ No newline at end of file
+与拉取请求相关的活动。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[pull requests](/v3/pulls/)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/pull_request_webhook_properties.md b/translations/zh-CN/data/reusables/webhooks/pull_request_webhook_properties.md
index f7ecaa7fe4b1..93d25e699aea 100644
--- a/translations/zh-CN/data/reusables/webhooks/pull_request_webhook_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/pull_request_webhook_properties.md
@@ -1,3 +1,3 @@
-| 键        | 类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                 |
-| -------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `action` | `字符串` | 执行的操作内容. Can be one of  `opened`, `edited`, `closed`, `assigned`, `unassigned`, `review_requested`, `review_request_removed`, `ready_for_review`, `labeled`, `unlabeled`, `synchronize`, `locked`, `unlocked`, or `reopened`. If the action is `closed` and the `merged` key is `false`, the pull request was closed with unmerged commits. If the action is `closed` and the `merged` key is `true`, the pull request was merged. |
\ No newline at end of file
+| 键        | 类型    | 描述                                                                                                                                                                                                                                                                                                              |
+| -------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `action` | `字符串` | 执行的操作内容. 可以是以下项之一：`opened`、`edited`、`closed`、`assigned`、`unassigned`、`review_requested`、`review_request_removed`、`ready_for_review`、`labeled`、`unlabeled`、`synchronize`、`locked`、`unlocked` 或 `reopened`。 如果操作为 `closed`，并且 `merged` 键为 `false`，则拉取请求随未合并的提交而关闭。 如果操作为 `closed`，并且 `merged` 键为 `true`，则拉取请求被合并。 |
diff --git a/translations/zh-CN/data/reusables/webhooks/push_short_desc.md b/translations/zh-CN/data/reusables/webhooks/push_short_desc.md
index 53583a273873..ab11a4357a10 100644
--- a/translations/zh-CN/data/reusables/webhooks/push_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/push_short_desc.md
@@ -1 +1 @@
-One or more commits are pushed to a repository branch or tag.
\ No newline at end of file
+一个或多个提交被推送到仓库分支或标记。
diff --git a/translations/zh-CN/data/reusables/webhooks/release_event_api_properties.md b/translations/zh-CN/data/reusables/webhooks/release_event_api_properties.md
index fe768d34304a..e533464aac0e 100644
--- a/translations/zh-CN/data/reusables/webhooks/release_event_api_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/release_event_api_properties.md
@@ -1,3 +1,3 @@
-| 键        | 类型    | 描述                           |
-| -------- | ----- | ---------------------------- |
-| `action` | `字符串` | 执行的操作内容. Can be `published`. |
\ No newline at end of file
+| 键        | 类型    | 描述                        |
+| -------- | ----- | ------------------------- |
+| `action` | `字符串` | 执行的操作内容. 可以是 `published`。 |
diff --git a/translations/zh-CN/data/reusables/webhooks/release_properties.md b/translations/zh-CN/data/reusables/webhooks/release_properties.md
index f9fa6700c8ba..08ee1f6e79a2 100644
--- a/translations/zh-CN/data/reusables/webhooks/release_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/release_properties.md
@@ -1 +1 @@
-`changes[body][from]` |`string` | The previous version of the body if the action was `edited`. `changes[name][from]` |`string` | The previous version of the name if the action was `edited`. `release`|`object` | The [release](/v3/repos/releases/#get-a-release) object.
\ No newline at end of file
+`changes[body][from]` |`string` | 正文的前版本，如果操作为 `edited`。 `changes[name][from]` |`string` | 名称的前版本，如果操作为 `edited`。 `release`|`object` | [发行版](/rest/reference/repos/#get-a-release)对象。
diff --git a/translations/zh-CN/data/reusables/webhooks/release_short_desc.md b/translations/zh-CN/data/reusables/webhooks/release_short_desc.md
index b3250fbf11ec..91adac016919 100644
--- a/translations/zh-CN/data/reusables/webhooks/release_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/release_short_desc.md
@@ -1 +1 @@
-Activity related to a release. {% data reusables.webhooks.action_type_desc %} For more information, see the "[releases](/v3/repos/releases/)" REST API.
\ No newline at end of file
+与发行版相关的活动。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[releases](/v3/repos/releases/)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/release_webhook_properties.md b/translations/zh-CN/data/reusables/webhooks/release_webhook_properties.md
index 8a3490a64af3..e058c038af6f 100644
--- a/translations/zh-CN/data/reusables/webhooks/release_webhook_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/release_webhook_properties.md
@@ -1,3 +1,3 @@
-| 键        | 类型    | 描述                                                                                                                                                                                                                                                                                                    |
-| -------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `action` | `字符串` | 执行的操作内容. 可以是以下选项之一：
    • `published`: a release, pre-release, or draft of a release is published
      • {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}
    • `unpublished`: a release or pre-release is deleted
    • `created`: a draft is saved, or a release or pre-release is published without previously being saved as a draft
    • `edited`: a release, pre-release, or draft release is edited
    • `deleted`: a release, pre-release, or draft release is deleted
    • `prereleased`: a pre-release is created
    • `released`: a release or draft of a release is published, or a pre-release is changed to a release
      • {% endif %} |
\ No newline at end of file
+| 键        | 类型    | 描述                                                                                                                                                                                                                          |
+| -------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `action` | `字符串` | 执行的操作内容. 可以是以下选项之一：
      • `published`：发行版、预发行版或发行版草稿已发布
      • `unpublished`：发行版或预发行版已删除
      • `created`：草稿已保存，或者此前未保存为草稿的发行版或预发行版已发布
      • `edited`：发行版、预发行版或发行版草稿被编辑
      • `deleted`：发行版、预发行版或发行版草稿被删除
      • `prereleased`：预发行版已创建
      • `released`：发行版或发行版草稿已发布，或者预发行版被更改为发行版
        •  |
diff --git a/translations/zh-CN/data/reusables/webhooks/repo_desc.md b/translations/zh-CN/data/reusables/webhooks/repo_desc.md
index a61104a4ba83..4d9c67b2fddb 100644
--- a/translations/zh-CN/data/reusables/webhooks/repo_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/repo_desc.md
@@ -1 +1 @@
-`repository` | `object` | The [`repository`](/v3/repos/#get-a-repository) where the event occured.
\ No newline at end of file
+`repository` | `object` | 事件发生所在的 [`repository`](/v3/repos/#get-a-repository)。
diff --git a/translations/zh-CN/data/reusables/webhooks/repository_import_properties.md b/translations/zh-CN/data/reusables/webhooks/repository_import_properties.md
index 131804d57c90..90c5581ec6a8 100644
--- a/translations/zh-CN/data/reusables/webhooks/repository_import_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/repository_import_properties.md
@@ -1,3 +1,3 @@
-| 键    | 类型    | 描述                                                                                      |
-| ---- | ----- | --------------------------------------------------------------------------------------- |
-| `状态` | `字符串` | The final state of the import. This can be one of `success`, `cancelled`, or `failure`. |
\ No newline at end of file
+| 键    | 类型    | 描述                                                   |
+| ---- | ----- | ---------------------------------------------------- |
+| `状态` | `字符串` | 导入的最终状态。 可以是以下项之一：`success`、`cancelled` 或 `failure`。 |
diff --git a/translations/zh-CN/data/reusables/webhooks/repository_import_short_desc.md b/translations/zh-CN/data/reusables/webhooks/repository_import_short_desc.md
index 2d30661c839a..45562b92c684 100644
--- a/translations/zh-CN/data/reusables/webhooks/repository_import_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/repository_import_short_desc.md
@@ -1 +1 @@
-Activity related to a repository being imported to GitHub. {% data reusables.webhooks.action_type_desc %} For more information, see the "[source imports](/v3/migrations/source_imports/)" REST API.
\ No newline at end of file
+与导入到 GitHub 的仓库相关的活动。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[source imports](/v3/migrations/source_imports/)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/repository_short_desc.md b/translations/zh-CN/data/reusables/webhooks/repository_short_desc.md
index b7c3f660a8a0..c1a4f5d1b744 100644
--- a/translations/zh-CN/data/reusables/webhooks/repository_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/repository_short_desc.md
@@ -1 +1 @@
-Activity related to a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[repositories](/v3/repos/)" REST API.
\ No newline at end of file
+与仓库相关的活动。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[repositories](/v3/repos/)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/repository_vulnerability_alert_properties.md b/translations/zh-CN/data/reusables/webhooks/repository_vulnerability_alert_properties.md
index 4fc61cb46972..b5a53fae7271 100644
--- a/translations/zh-CN/data/reusables/webhooks/repository_vulnerability_alert_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/repository_vulnerability_alert_properties.md
@@ -1,4 +1,4 @@
-| 键        | 类型    | 描述                                                             |
-| -------- | ----- | -------------------------------------------------------------- |
-| `action` | `字符串` | 执行的操作内容. This can be one of `create`, `dismiss`, or `resolve`. |
-| `警报`     | `对象`  | The security alert of the vulnerable dependency.               |
\ No newline at end of file
+| 键        | 类型    | 描述                                                |
+| -------- | ----- | ------------------------------------------------- |
+| `action` | `字符串` | 执行的操作内容. 可以是以下项之一：`create`、`dismiss` 或 `resolve`。 |
+| `警报`     | `对象`  | 漏洞依赖项的安全警报。                                       |
diff --git a/translations/zh-CN/data/reusables/webhooks/repository_vulnerability_alert_short_desc.md b/translations/zh-CN/data/reusables/webhooks/repository_vulnerability_alert_short_desc.md
index 9eab73f38a49..adfb8487f50b 100644
--- a/translations/zh-CN/data/reusables/webhooks/repository_vulnerability_alert_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/repository_vulnerability_alert_short_desc.md
@@ -1 +1 @@
-Activity related to security vulnerability alerts in a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[About security alerts for vulerable dependencies](/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies)".
\ No newline at end of file
+与仓库中的安全漏洞警报相关的活动。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[About security alerts for vulerable dependencies](/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies)".
diff --git a/translations/zh-CN/data/reusables/webhooks/secret.md b/translations/zh-CN/data/reusables/webhooks/secret.md
index 119e13a93770..d4d128984aec 100644
--- a/translations/zh-CN/data/reusables/webhooks/secret.md
+++ b/translations/zh-CN/data/reusables/webhooks/secret.md
@@ -1 +1 @@
-Setting a webhook secret allows you to ensure that `POST` requests sent to the payload URL are from GitHub. When you set a secret, you'll receive the `X-Hub-Signature` header in the webhook `POST` request. For more details on how to use the secret and the `X-Hub-Signature` header to secure your webhook payloads, see "[Securing your webhooks](/webhooks/securing/)."
\ No newline at end of file
+Setting a webhook secret allows you to ensure that `POST` requests sent to the payload URL are from {% data variables.product.product_name %}. When you set a secret, you'll receive the {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}`X-Hub-Signature` and `X-Hub-Signature-256` headers{% else if currentVersion ver_lt "enterprise-server@2.23" %}`X-Hub-Signature` header{% else if currentVersion == "private-instances@latest" %}`X-Hub-Signature-256` header{% endif %} in the webhook `POST` request. For more information on how to use a secret with a signature header to secure your webhook payloads, see "[Securing your webhooks](/webhooks/securing/)."
diff --git a/translations/zh-CN/data/reusables/webhooks/sender_desc.md b/translations/zh-CN/data/reusables/webhooks/sender_desc.md
index d3c9f888bc19..022d2f787b87 100644
--- a/translations/zh-CN/data/reusables/webhooks/sender_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/sender_desc.md
@@ -1 +1 @@
-`sender` | `object` | The user that triggered the event.
\ No newline at end of file
+`sender` | `object` | 触发事件的用户。
diff --git a/translations/zh-CN/data/reusables/webhooks/sponsorship_event_api_properties.md b/translations/zh-CN/data/reusables/webhooks/sponsorship_event_api_properties.md
index 7adeb21ffbe8..679950d0d309 100644
--- a/translations/zh-CN/data/reusables/webhooks/sponsorship_event_api_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/sponsorship_event_api_properties.md
@@ -1,3 +1,3 @@
-| 键        | 类型    | 描述                              |
-| -------- | ----- | ------------------------------- |
-| `action` | `字符串` | 执行的操作内容. This can be `created`. |
\ No newline at end of file
+| 键        | 类型    | 描述                      |
+| -------- | ----- | ----------------------- |
+| `action` | `字符串` | 执行的操作内容. 可以是 `created`。 |
diff --git a/translations/zh-CN/data/reusables/webhooks/sponsorship_properties.md b/translations/zh-CN/data/reusables/webhooks/sponsorship_properties.md
index 6506db181710..6fe985ed4291 100644
--- a/translations/zh-CN/data/reusables/webhooks/sponsorship_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/sponsorship_properties.md
@@ -1 +1 @@
-`effective_date` | `string` | The `pending_cancellation` and `pending_tier_change` event types will include the date the cancellation or tier change will take effect. `changes[tier][from]` | `object` | The `tier_changed` and `pending_tier_change` will include the original tier before the change or pending change. For more information, see the [pending tier change payload](/webhooks/event-payloads#webhook-payload-example-when-someone-downgrades-a-sponsorship). `changes[privacy_level][from]` | `string` | The `edited` event types include the details about the change when someone edits a sponsorship to change the privacy.
\ No newline at end of file
+`effective_date` | `string` | `pending_cancellation` 和 `pending_tier_change` 事件类型将包括取消或等级更改生效的日期。 `changes[tier][from]` | `object` | `tier_changed` 和 `pending_tier_change` 将包括更改或待处理更改之前的初始等级。 更多信息请参阅“[待处理等级更改有效负载](/webhooks/event-payloads#webhook-payload-example-when-someone-downgrades-a-sponsorship)”。 `changes[privacy_level][from]` | `string` | `edited` 事件类型包括当有人编辑赞助以更改隐私时有关更改的详细信息。
diff --git a/translations/zh-CN/data/reusables/webhooks/sponsorship_short_desc.md b/translations/zh-CN/data/reusables/webhooks/sponsorship_short_desc.md
index cb6cdccf21dc..5752a137850d 100644
--- a/translations/zh-CN/data/reusables/webhooks/sponsorship_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/sponsorship_short_desc.md
@@ -1 +1 @@
-Activity related to a sponsorship listing. {% data reusables.webhooks.action_type_desc %} For more information, see "[About GitHub Sponsors](/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors)".
\ No newline at end of file
+与赞助列表相关的活动。 {% data reusables.webhooks.action_type_desc %} For more information, see "[About GitHub Sponsors](/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors)".
diff --git a/translations/zh-CN/data/reusables/webhooks/sponsorship_webhook_properties.md b/translations/zh-CN/data/reusables/webhooks/sponsorship_webhook_properties.md
index d27ad5148533..21d4eb617511 100644
--- a/translations/zh-CN/data/reusables/webhooks/sponsorship_webhook_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/sponsorship_webhook_properties.md
@@ -1,3 +1,3 @@
-| 键        | 类型    | 描述                                                                                                                              |
-| -------- | ----- | ------------------------------------------------------------------------------------------------------------------------------- |
-| `action` | `字符串` | 执行的操作内容. This can be one of `created`, `cancelled`, `edited`, `tier_changed`, `pending_cancellation`, or `pending_tier_change`. |
\ No newline at end of file
+| 键        | 类型    | 描述                                                                                                              |
+| -------- | ----- | --------------------------------------------------------------------------------------------------------------- |
+| `action` | `字符串` | 执行的操作内容. 可以是以下项之一：`created`、`cancelled`、`edited`、`tier_changed`、`pending_cancellation` 或 `pending_tier_change`。 |
diff --git a/translations/zh-CN/data/reusables/webhooks/star_properties.md b/translations/zh-CN/data/reusables/webhooks/star_properties.md
index 1e5c0d695351..a6c8ce0b3c78 100644
--- a/translations/zh-CN/data/reusables/webhooks/star_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/star_properties.md
@@ -1,4 +1,4 @@
-| 键            | 类型    | 描述                                                                                                                   |
-| ------------ | ----- | -------------------------------------------------------------------------------------------------------------------- |
-| `action`     | `字符串` | 执行的操作。 Can be `created` or `deleted`.                                                                                |
-| `starred_at` | `字符串` | The time the star was created. {% data reusables.shortdesc.iso_8601 %} Will be `null` for the `deleted` action. |
\ No newline at end of file
+| 键            | 类型    | 描述                                                                                        |
+| ------------ | ----- | ----------------------------------------------------------------------------------------- |
+| `action`     | `字符串` | 执行的操作。 可以是 `created` 或 `deleted`。                                                         |
+| `starred_at` | `字符串` | 星标创建的时间。 {% data reusables.shortdesc.iso_8601 %} Will be `null` for the `deleted` action. |
diff --git a/translations/zh-CN/data/reusables/webhooks/star_short_desc.md b/translations/zh-CN/data/reusables/webhooks/star_short_desc.md
index eac484160fed..aee45ecba6c5 100644
--- a/translations/zh-CN/data/reusables/webhooks/star_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/star_short_desc.md
@@ -1 +1 @@
-Activity related to a repository being starred. {% data reusables.webhooks.action_type_desc %} For more information, see the "[starring](/v3/activity/starring/)" REST API.
\ No newline at end of file
+与标星仓库相关的活动。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[starring](/v3/activity/starring/)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/status_short_desc.md b/translations/zh-CN/data/reusables/webhooks/status_short_desc.md
index 8d28713099d2..61a3a1affcff 100644
--- a/translations/zh-CN/data/reusables/webhooks/status_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/status_short_desc.md
@@ -1 +1 @@
-When the status of a Git commit changes. {% data reusables.webhooks.action_type_desc %} For more information, see the "[statuses](/v3/repos/statuses/)" REST API.
\ No newline at end of file
+当 Git 提交的状态发生更改时。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[statuses](/v3/repos/statuses/)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/team_add_short_desc.md b/translations/zh-CN/data/reusables/webhooks/team_add_short_desc.md
index 5ef912458fe4..cd1a909fb42e 100644
--- a/translations/zh-CN/data/reusables/webhooks/team_add_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/team_add_short_desc.md
@@ -1 +1 @@
-When a [repository is added to a team](/v3/teams/#add-or-update-team-repository-permissions).
\ No newline at end of file
+当[仓库被添加到团队](/v3/teams/#add-or-update-team-repository-permissions)时。
diff --git a/translations/zh-CN/data/reusables/webhooks/team_short_desc.md b/translations/zh-CN/data/reusables/webhooks/team_short_desc.md
index 8faf762fe915..2aff194ce1e5 100644
--- a/translations/zh-CN/data/reusables/webhooks/team_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/team_short_desc.md
@@ -1 +1 @@
-Activity related to an organization's team. {% data reusables.webhooks.action_type_desc %} For more information, see the "[teams](/v3/teams/)" REST API.
\ No newline at end of file
+与组织的团队相关的活动。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[teams](/v3/teams/)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/watch_properties.md b/translations/zh-CN/data/reusables/webhooks/watch_properties.md
index c79d6f77dc73..afa87504e580 100644
--- a/translations/zh-CN/data/reusables/webhooks/watch_properties.md
+++ b/translations/zh-CN/data/reusables/webhooks/watch_properties.md
@@ -1,3 +1,3 @@
-| 键        | 类型    | 描述                                         |
-| -------- | ----- | ------------------------------------------ |
-| `action` | `字符串` | 执行的操作内容. Currently, can only be `started`. |
\ No newline at end of file
+| 键        | 类型    | 描述                        |
+| -------- | ----- | ------------------------- |
+| `action` | `字符串` | 执行的操作内容. 目前只能是 `started`。 |
diff --git a/translations/zh-CN/data/reusables/webhooks/watch_short_desc.md b/translations/zh-CN/data/reusables/webhooks/watch_short_desc.md
index a40fc1893db2..2c4035c4adc4 100644
--- a/translations/zh-CN/data/reusables/webhooks/watch_short_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/watch_short_desc.md
@@ -1 +1 @@
-When someone stars a repository. {% data reusables.webhooks.action_type_desc %} For more information, see the "[starring](/v3/activity/starring/)" REST API.
\ No newline at end of file
+当有人标星仓库时。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[starring](/v3/activity/starring/)" REST API.
diff --git a/translations/zh-CN/data/reusables/webhooks/webhooks_intro.md b/translations/zh-CN/data/reusables/webhooks/webhooks_intro.md
index eb7b4353766e..e036590911ec 100644
--- a/translations/zh-CN/data/reusables/webhooks/webhooks_intro.md
+++ b/translations/zh-CN/data/reusables/webhooks/webhooks_intro.md
@@ -1 +1 @@
-When configuring a webhook, you can use the UI or API to choose which events will send you payloads. Only subscribing to the specific events you plan on handling limits the number of HTTP requests to your server. You can also subscribe to all current and future events. By default, webhooks are only subscribed to the push event. You can change the list of subscribed events anytime.
+配置 web 挂钩时，您可以使用 UI 或 API 选择哪些事件将向您发送有效负载。 仅订阅您计划处理的特定事件可限制对服务器的 HTTP 请求数。 您也可以订阅所有当前和未来的事件。 默认情况下，web 挂钩只订阅推送事件。 您可以随时更改订阅事件的列表。
diff --git a/translations/zh-CN/data/reusables/webhooks/webhooks_ssl.md b/translations/zh-CN/data/reusables/webhooks/webhooks_ssl.md
index 987a85576227..699e6481bdae 100644
--- a/translations/zh-CN/data/reusables/webhooks/webhooks_ssl.md
+++ b/translations/zh-CN/data/reusables/webhooks/webhooks_ssl.md
@@ -1 +1 @@
-If your "Payload URL" is a secure site (HTTPS), you will have the option to configure the SSL verification settings. If your "Payload URL" is not secure (HTTP), GitHub will not display this option. By default, GitHub verifies the SSL certificate of your website when delivering webhook payloads. SSL verification helps ensure that hook payloads are delivered to your URL endpoint securely. You have the option to disable SSL, but we recommend keeping **Enable SSL verification** selected.
\ No newline at end of file
+如果您的“有效负载 URL”是一个安全站点 (HTTPS)，您可以选择配置 SSL 验证设置。 如果您的“有效负载 URL”不安全 (HTTP)，GitHub 不会显示此选项。 默认情况下，GitHub 在传递 web 挂钩有效负载时验证网站的 SSL 证书。 SSL 验证有助于确保将挂钩有效负载安全地传递到 URL 端点。 您可以选择禁用 SSL，但我们建议保留**Enable SSL verification（启用 SSL 验证）**的选中状态。
diff --git a/translations/zh-CN/data/reusables/webhooks/workflow_run_desc.md b/translations/zh-CN/data/reusables/webhooks/workflow_run_desc.md
index 25d67bab0223..89608e4dcd29 100644
--- a/translations/zh-CN/data/reusables/webhooks/workflow_run_desc.md
+++ b/translations/zh-CN/data/reusables/webhooks/workflow_run_desc.md
@@ -1,4 +1,4 @@
 
-This event occurs when a workflow run is requested or completed, and allows you to execute a workflow based on the finished result of another workflow. For example, if your `pull_request` workflow generates build artifacts, you can create a new workflow that uses `workflow_run` to analyze the results and add a comment to the original pull request.
+当请求或完成工作流程运行时，将发生此事件，并允许您基于另一个工作流程的完成结果执行工作流程。 例如，如果 `pull_request` 工作流程生成构件，您可以创建一个使用 `workflow_run` 来分析结果的新工作流程，并向原始拉取请求添加注释。
 
-The workflow started by the `workflow_run` event is able to access the secrets and write tokens used by the original workflow.
\ No newline at end of file
+由 `workflow_run` 事件启动的工作流程能够访问原始工作流程所使用的密钥和写入令牌。
diff --git a/translations/zh-CN/data/ui.yml b/translations/zh-CN/data/ui.yml
index b046472e1997..d457e6ea88e6 100644
--- a/translations/zh-CN/data/ui.yml
+++ b/translations/zh-CN/data/ui.yml
@@ -3,7 +3,7 @@ header:
   github_docs: GitHub Docs
   contact: 联系我们
   notices:
-    ghe_release_candidate: GitHub Enterprise Server 2.22 is currently under limited release as a release candidate.
+    ghe_release_candidate: GitHub Enterprise Server 2.22目前作为版本候选仅有限发布。
     localization_complete: 我们经常发布文档更新，此页面的翻译可能仍在进行中。有关最新信息，请访问英文文档。如果此页面上的翻译有问题，请告诉我们。
     localization_in_progress: 你好，探索者！ 此页面正在积极开发或仍在翻译中。有关最新和最准确的信息，请访问我们的英文文档。
     product_in_progress: '👋你好，探索者！ 此页面正在积极开发中。有关最新和最准确的信息，请访问我们的开发者文档。'
@@ -26,34 +26,34 @@ errors:
   we_track_errors: 我们会自动跟踪这些错误，但如果问题仍然存在，请随时联系我们。
   page_doesnt_exist: 看来此页面不存在。
 support:
-  still_need_help: Still need help?
+  still_need_help: 还需要帮助？
   contact_support: 联系支持
-  ask_community: Ask the GitHub community
+  ask_community: 询问 GitHub 社区
 helpfulness:
-  able_to_find: Did this doc help you?
+  able_to_find: 此文档对您有帮助吗？
   yes: true
   no: false
-  yes_feedback: Want to learn about new docs features and updates? Sign up for updates!
+  yes_feedback: 想了解新的文档功能和更新？注册更新！
   email_placeholder: email@example.com
-  no_feedback: We're continually improving our docs. We'd love to hear how we can do better.
-  category_label: What problem did you have?
-  category_default: Choose an option
-  category_unclear: Information was unclear
-  category_confusing: The content was confusing
-  category_unhelpful: The article didn't answer my question
-  category_other: Other
-  comment_label: Let us know what we can do better
+  no_feedback: 我们在不断改进文档，希望听到您的改进建议。
+  category_label: 您遇到了什么问题？
+  category_default: 选择一个选项
+  category_unclear: 信息不清楚
+  category_confusing: 内容令人困惑
+  category_unhelpful: 这篇文章没有回答我的问题
+  category_other: 其他
+  comment_label: 告诉我们如何改进
   optional: 可选
   required: 必选
-  email_label: Can we contact you if we have more questions?
+  email_label: 如果有更多问题，我们能联系您吗？
   send: 发送​​
   feedback: 谢谢！您的反馈已提交。
 contribution_cta:
-  title: Help us make these docs great!
-  body: All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.
-  button: Make a contribution
+  title: 帮助我们创建出色的文档！
+  body: 所有 GitHub 文档都是开源的。看到错误或不清楚的内容了吗？提交拉取请求。
+  button: 做出贡献
   or: 或,
-  to_guidelines: learn how to contribute.
+  to_guidelines: 了解如何参与。
 products:
   graphql:
     reference:
diff --git a/translations/zh-CN/data/variables/command_line.yml b/translations/zh-CN/data/variables/command_line.yml
index e11bca1f6fba..805c67903e68 100644
--- a/translations/zh-CN/data/variables/command_line.yml
+++ b/translations/zh-CN/data/variables/command_line.yml
@@ -1,10 +1,10 @@
 ---
-#Use this variable wherever backticks are necessary: http://git.io/AArkqA
+#Use this variable wherever backticks are necessary: https://github.com/github/docs-internal/pull/1176#discussion-diff-19853931
 backticks: >-
   {% if currentVersion == "free-pro-team@latest" %}github.com{% else %}[hostname]{% endif %}
 #Use this variable within codeblocks (because it includes HTML! Which only renders in shell codeblocks!)
 codeblock: >-
-  {% if currentVersion == "free-pro-team@latest" %}github.com{% else %}主机名{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}github.com{% else %}hostname{% endif %}
 #GitHub URL example
 git_url_example: >-
   https://{% if currentVersion == "free-pro-team@latest" %}github.com{% else %}github.example.com{% endif %}
diff --git a/translations/zh-CN/data/variables/contact.yml b/translations/zh-CN/data/variables/contact.yml
index 7ae65a9be9f6..9e3e33914994 100644
--- a/translations/zh-CN/data/variables/contact.yml
+++ b/translations/zh-CN/data/variables/contact.yml
@@ -1,18 +1,17 @@
 ---
 contact_ent_support: '[GitHub Enterprise 支持](https://enterprise.githubsupport.com/hc/en-us) 或 [GitHub 高级支持](https://premium.githubsupport.com)'
 contact_support: >-
-  {% if currentVersion == "free-pro-team@latest" %}[GitHub 支持](https://support.github.com/contact) 或 [GitHub 高级支持](https://premium.githubsupport.com){% else %}您的 GitHub Enterprise 站点管理员{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[GitHub Support](https://support.github.com/contact) or [GitHub Premium Support](https://premium.githubsupport.com){% else %}your GitHub Enterprise site administrator{% endif %}
 report_abuse: >-
-  {% if currentVersion == "free-pro-team@latest" %}[报告滥用](https://github.com/contact/report-abuse){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Report abuse](https://github.com/contact/report-abuse){% endif %}
 report_content: >-
-  {% if currentVersion == "free-pro-team@latest" %}[报告内容](https://github.com/contact/report-content){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Report content](https://github.com/contact/report-content){% endif %}
 contact_dmca: >-
-  {% if currentVersion == "free-pro-team@latest" %}[版权声明表](https://github.com/contact/dmca){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Copyright claims form](https://github.com/contact/dmca){% endif %}
 contact_privacy: >-
-  {% if currentVersion == "free-pro-team@latest" %}[隐私联系表](https://github.com/contact/privacy){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Privacy contact form](https://github.com/contact/privacy){% endif %}
 contact_enterprise_sales: '[GitHub'' 销售团队](https://enterprise.github.com/contact)'
 contact_feedback_actions: '[GitHub 操作的反馈表](https://support.github.com/contact/feedback?contact[category]=actions)'
-contact_partner_engineering: '[partnerengineering@github.com](mailto:partnerengineering@github.com)'
 #The team that provides Standard Support
 enterprise_support: 'GitHub Enterprise 支持'
 #The larger team that includes Enterprise Support and Premium Support
diff --git a/translations/zh-CN/data/variables/desktop.yml b/translations/zh-CN/data/variables/desktop.yml
index 4a0c78d0afa1..2b8d0ca77209 100644
--- a/translations/zh-CN/data/variables/desktop.yml
+++ b/translations/zh-CN/data/variables/desktop.yml
@@ -1,4 +1,4 @@
 ---
 #Supported platforms
 mac-osx-versions: macOS 10.10 或更高版本
-windows-versions: Windows 7 64-bit or later
+windows-versions: Windows 7 64 位或更高版本
diff --git a/translations/zh-CN/data/variables/explore.yml b/translations/zh-CN/data/variables/explore.yml
index fdcc9f789ea5..e9d43c423085 100644
--- a/translations/zh-CN/data/variables/explore.yml
+++ b/translations/zh-CN/data/variables/explore.yml
@@ -1,7 +1,7 @@
 ---
 explore_github: >-
-  {% if currentVersion == "free-pro-team@latest" %}[探索 GitHub](https://github.com/explore){% else %}探索 GitHub (`https://[hostname]/explore`){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Explore GitHub](https://github.com/explore){% else %}Explore GitHub (`https://[hostname]/explore`){% endif %}
 your_stars_page: >-
-  {% if currentVersion == "free-pro-team@latest" %}[星级页面](https://github.com/stars){% else %}星级页面 (`https://[hostname]/stars`){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[stars page](https://github.com/stars){% else %}stars page (`https://[hostname]/stars`){% endif %}
 trending_page: >-
-  {% if currentVersion == "free-pro-team@latest" %}[趋势页面](https://github.com/trending){% else %}趋势页面 (`https://[hostname]/trending`){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Trending page](https://github.com/trending){% else %}Trending page (`https://[hostname]/trending`){% endif %}
diff --git a/translations/zh-CN/data/variables/gists.yml b/translations/zh-CN/data/variables/gists.yml
index 01b778f1012f..9d1fea10acf4 100644
--- a/translations/zh-CN/data/variables/gists.yml
+++ b/translations/zh-CN/data/variables/gists.yml
@@ -1,7 +1,7 @@
 ---
 gist_homepage: >-
-  {% if currentVersion == "free-pro-team@latest" %}[gist 主页](https://gist.github.com/){% else %}gist 主页，`http(s)://[hostname]/gist` 或 `http(s)://gist.[hostname]`，如果启用了子域 {% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[gist home page](https://gist.github.com/){% else %}gist home page, `http(s)://[hostname]/gist` or `http(s)://gist.[hostname]` if subdomains are enabled {% endif %}
 gist_search_url: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Gist 搜索](https://gist.github.com/search){% else %}Gist 搜索，`http(s)://[hostname]/gist/search` 或 `http(s)://gist.[hostname]/search`，如果启用了子域{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Gist Search](https://gist.github.com/search){% else %}Gist Search, `http(s)://[hostname]/gist/search` or `http(s)://gist.[hostname]/search` if subdomains are enabled{% endif %}
 discover_url: >-
-  {% if currentVersion == "free-pro-team@latest" %}[Discover](https://gist.github.com/discover){% else %}发现，`http(s)://[hostname]/gist/discover` 或 `http(s)://gist.[hostname]/discover`，如果启用了子域{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Discover](https://gist.github.com/discover){% else %}Discover, `http(s)://[hostname]/gist/discover` or `http(s)://gist.[hostname]/discover` if subdomains are enabled{% endif %}
diff --git a/translations/zh-CN/data/variables/migrations.yml b/translations/zh-CN/data/variables/migrations.yml
index 15201e4a035e..f8ec258fd15a 100644
--- a/translations/zh-CN/data/variables/migrations.yml
+++ b/translations/zh-CN/data/variables/migrations.yml
@@ -1,7 +1,7 @@
 ---
 user_migrations_intro: >-
-  You can use this API to review, backup, or migrate your user data stored on {% data variables.product.product_name %}.com.
+  您可以使用此 API 审查、备份或迁移您在 {% data variables.product.product_name %}.com 上存储的用户数据。
 organization_migrations_intro: >-
-  The organization migrations API lets you move a repository from GitHub to {% data variables.product.prodname_ghe_server %}.
+  组织迁移 API 可让您将仓库从 GitHub 移动到 {% data variables.product.prodname_ghe_server %}。
 source_imports_intro: >-
-  The Source Import API lets you start an import from a Git, Subversion, Mercurial, or Team Foundation Server source repository. This is the same functionality as the {% data variables.product.prodname_dotcom %} Importer. For more information, see "[Importing a repository with {% data variables.product.prodname_dotcom %} Importer](/github/importing-your-projects-to-github/importing-a-repository-with-github-importer)."
+  源导入 API 可让您从 Git、Subversion、Mercurial 或 Team Foundation Server 源仓库开始导入。这是与 {% data variables.product.prodname_dotcom %} Importer 相同的功能。更多信息请参阅“[使用 {% data variables.product.prodname_dotcom %} Importer 导入仓库](/github/importing-your-projects-to-github/importing-a-repository-with-github-importer)”。
diff --git a/translations/zh-CN/data/variables/notifications.yml b/translations/zh-CN/data/variables/notifications.yml
index e9bdee7b13a6..441bdba328c2 100644
--- a/translations/zh-CN/data/variables/notifications.yml
+++ b/translations/zh-CN/data/variables/notifications.yml
@@ -1,5 +1,5 @@
 ---
 no_reply_address: >-
-  {% if currentVersion == "free-pro-team@latest" %}`noreply@github.com`{% else %}或由站点管理员配置的无需回复电子邮件地址{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}`noreply@github.com`{% else %}the no-reply email address configured by your site administrator{% endif %}
 cc_address: >-
-  {% if currentVersion == "free-pro-team@latest" %}`@noreply.github.com`{% else %}基于站点管理员配置的无需回复电子邮件地址{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}`@noreply.github.com`{% else %}based on the no-reply email address configured by your site administrator{% endif %}
diff --git a/translations/zh-CN/data/variables/product.yml b/translations/zh-CN/data/variables/product.yml
index 4216fb5ad9e8..76baba31fcf4 100644
--- a/translations/zh-CN/data/variables/product.yml
+++ b/translations/zh-CN/data/variables/product.yml
@@ -19,7 +19,7 @@ prodname_ghe_cloud: 'GitHub Enterprise Cloud'
 prodname_ghe_one: 'GitHub One'
 ## Use these variables when referring specifically to a location within a product
 product_location: >-
-  {% if currentVersion == "free-pro-team@latest" %}GitHub{% else %}您的 GitHub Enterprise Server 实例{% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}GitHub{% else %}your GitHub Enterprise Server instance{% endif %}
 product_location_enterprise: '您的 GitHub Enterprise Server 实例'
 prodname_free_user: 'GitHub Free'
 prodname_pro: 'GitHub Pro'
@@ -56,12 +56,9 @@ prodname_github_app: 'GitHub 应用程序'
 prodname_github_apps: 'GitHub 应用程序'
 prodname_oauth_app: 'OAuth 应用程序'
 #API and developer docs
-prodname_dev_docs: 'GitHub 开发者文档'
 prodname_enterprise_api: 'GitHub Enterprise Server API'
-prodname_support_forum: 'GitHub API 开发和支持论坛'
 prodname_support_forum_with_url: '[GitHub API 开发和支持论坛](https://github.community/c/github-api-development-and-support/37)'
 prodname_unfurls: '内容附件'
-prodname_component_kit: 'GitHub Component Kit'
 #GitHub Actions
 ## Use this variable only when referring to GitHub Actions the product. When referring to the thing that someone creates using the product, call it an action (small a). See the terminology page of the Brand Guide for more.
 prodname_actions: 'GitHub Actions'
@@ -80,16 +77,15 @@ prodname_matching_fund: 'GitHub 赞助者匹配基金'
 prodname_advanced_security: 'Advanced Security'
 #Codespaces
 prodname_codespaces: 'Codespaces'
-prodname_vscode: 'Visual Studio Code'
 prodname_vs_codespaces: 'Visual Studio 代码空间'
-prodname_vs: 'Visual Studio'
+prodname_github_codespaces: 'GitHub Codespaces'
 #GitHub resources: blog, jobs, Learning Lab
 prodname_gcf: 'GitHub Community Support'
 prodname_blog: 'GitHub 博客'
 prodname_jobs: 'GitHub Jobs'
 prodname_learning: 'GitHub Learning Lab'
 prodname_learning_link: 'https://lab.github.com/'
-prodname_roadmap: 'GitHub public roadmap'
+prodname_roadmap: 'GitHub 公共路线图'
 prodname_roadmap_link: 'https://github.com/github/roadmap#github-public-roadmap'
 #GitHub support
 premium_support_plan: 'Premium 计划'
@@ -110,26 +106,29 @@ prodname_code_scanning: '代码扫描'
 prodname_code_scanning_capc: '代码扫描'
 prodname_codeql_runner: 'CodeQL runner'
 prodname_advisory_database: 'GitHub Advisory Database'
-prodname_codeql_workflow: 'CodeQL Analysis workflow'
+prodname_codeql_workflow: 'CodeQL 分析工作流程'
+#Visual Studio
+prodname_vs: 'Visual Studio'
+prodname_vscode: 'Visual Studio Code'
+prodname_vss_ghe: 'Visual Studio subscription with GitHub Enterprise'
+prodname_vss_admin_portal_with_url: 'the [administrator portal for Visual Studio subscriptions](https://visualstudio.microsoft.com/subscriptions-administration/)'
 #GitHub Dependabot
 prodname_dependabot: 'GitHub Dependabot'
 prodname_dependabot_short: 'Dependabot'
 prodname_dependabot_alerts: 'GitHub Dependabot 警报'
 prodname_dependabot_security_updates: 'GitHub Dependabot 安全更新'
 prodname_dependabot_version_updates: 'GitHub Dependabot 版本更新'
-#GitHub Policies
-prodname_policies: 'GitHub Policies'
 #GitHub Archive Program
 prodname_archive: 'GitHub 存档计划'
-prodname_arctic_vault: 'Arctic Code Vault'
+prodname_arctic_vault: 'Arctic 代码库'
 #Links
 product_url: >-
   {% if currentVersion == "free-pro-team@latest" %}github.com{% else %}[hostname]{% endif %}
 pricing_url: 'https://github.com/pricing'
 signin_link: >-
-  {% if currentVersion == "free-pro-team@latest" %}[登录](https://github.com/login){% else %}登录 (`https://[hostname]/login`){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Sign in](https://github.com/login){% else %}Sign in (`https://[hostname]/login`){% endif %}
 signout_link: >-
-  {% if currentVersion == "free-pro-team@latest" %}[注销](https://github.com/logout){% else %}注销 (`https://[hostname]/logout`){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[Sign out](https://github.com/logout){% else %}Sign out (`https://[hostname]/logout`){% endif %}
 raw_github_com: >-
   {% if currentVersion == "free-pro-team@latest" %}raw.githubusercontent.com{% else %}[hostname]/user/repo/raw{% endif %}
 #GitHub Enterprise Server past versions
diff --git a/translations/zh-CN/data/variables/search.yml b/translations/zh-CN/data/variables/search.yml
index fcdf4ecac306..f22c85c91625 100644
--- a/translations/zh-CN/data/variables/search.yml
+++ b/translations/zh-CN/data/variables/search.yml
@@ -1,11 +1,5 @@
 ---
 advanced_url: >-
-  {% if currentVersion == "free-pro-team@latest" %}[高级搜索](https://github.com/search/advanced) 页面{% else %}高级搜索页面(`https://[hostname]/search/advanced`){% endif %}
+  {% if currentVersion == "free-pro-team@latest" %}[advanced search](https://github.com/search/advanced) page{% else %}advanced search page (`https://[hostname]/search/advanced`){% endif %}
 search_page_url: >-
-  {% if currentVersion == "free-pro-team@latest" %}[搜索](https://github.com/search) 页面{% else %}搜索页面 (`https://[hostname]/search`){% endif %}
-search_highlighting_link: >-
-  有关如何接收突出显示的搜索结果的更多详情，请参阅[文本匹配元数据](#text-match-metadata)。
-search_query_description: >-
-  查询包含一个或多个搜索关键词和限定词。限定词可将搜索限定于 GitHub 的特定区域。REST API 支持与 GitHub.com 相同的限定词。要了解更多关于查询格式的信息，请参阅[构建搜索查询](#constructing-a-search-query)。
-order_description: >-
-  确定返回的第一个搜索结果是否匹配次数最多 (`desc`) 或最少 (`asc`)。除非提供 `sort`，否则此参数将被忽略。默认值：`desc`
+  {% if currentVersion == "free-pro-team@latest" %}[search](https://github.com/search) page{% else %}search page (`https://[hostname]/search`){% endif %}